From dca28296b19e8cb4744dc12c5aadcc5bf77778b4 Mon Sep 17 00:00:00 2001 From: Sinem Akinci <99284450+sinemakinci1@users.noreply.github.com> Date: Fri, 14 Jul 2023 15:32:55 -0700 Subject: [PATCH 0001/1799] Learn Editor: Update cmake-projects-in-visual-studio.md --- docs/build/cmake-projects-in-visual-studio.md | 6 ++++++ .../screenshot-2023-07-14-153155.png | Bin 0 -> 58875 bytes 2 files changed, 6 insertions(+) create mode 100644 docs/build/media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index 5caf892144e..166fa5ed085 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -5,6 +5,7 @@ ms.date: 02/14/2022 helpviewer_keywords: ["CMake in Visual C++"] ms.assetid: 444d50df-215e-4d31-933a-b41841f186f8 --- + # CMake projects in Visual Studio [CMake](https://cmake.org) is a cross-platform, open-source tool for defining build processes that run on multiple platforms. This article assumes you're familiar with CMake. For more information about CMake, see the [CMake documentation](https://cmake.org/cmake/help/latest/index.html#). The [CMake tutorial](https://cmake.org/cmake/help/latest/guide/tutorial/index.html#guide:CMake%20Tutorial) is a good starting point to learn more. @@ -45,6 +46,10 @@ Once CMake cache generation has succeeded, you can also view your projects organ :::image type="content" source="media/cmake-targets-view2.png" alt-text="Screenshot of the Solution Explorer Views window with the C Make Targets View highlighted."::: +Additionally, you can simply switch views by right-clicking on any file or folder in your Solution Explorer and selecting **Switch to CMake Targets View**. + +![Context Menu item to Switch to CMake Targets View.](media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png) + Choose the **Show All Files** button at the top of **Solution Explorer** to see all the CMake-generated output in the *`out/build/`* folders. Use the *`CMakeLists.txt`* file in each project folder just as you would in any CMake project. You can specify source files, find libraries, set compiler and linker options, and specify other build system-related information. For more information on CMake language services provided by Visual Studio, see [Editing CMakeLists.txt files](#editing-cmakeliststxt-files). @@ -400,3 +405,4 @@ In Visual Studio 2015, Visual Studio users can use a [CMake generator](https://c [Configure CMake debugging sessions](configure-cmake-debugging-sessions.md)\ [Deploy, run, and debug your Linux project](../linux/deploy-run-and-debug-your-linux-project.md)\ [CMake predefined configuration reference](cmake-predefined-configuration-reference.md) + diff --git a/docs/build/media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png b/docs/build/media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png new file mode 100644 index 0000000000000000000000000000000000000000..781528af193dde831cddd6a35542f447c9bc7bcb GIT binary patch literal 58875 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 Date: Fri, 14 Jul 2023 15:33:10 -0700 Subject: [PATCH 0002/1799] Learn Editor: Update cmake-projects-in-visual-studio.md From ddc20c94d640ecc7a6e5a9316807f00751d8a13c Mon Sep 17 00:00:00 2001 From: Sinem Akinci <99284450+sinemakinci1@users.noreply.github.com> Date: Mon, 17 Jul 2023 09:05:00 -0700 Subject: [PATCH 0003/1799] Update cmake-projects-in-visual-studio.md Improved alt text and improved wording --- docs/build/cmake-projects-in-visual-studio.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index 166fa5ed085..d2237ab4c26 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -46,9 +46,9 @@ Once CMake cache generation has succeeded, you can also view your projects organ :::image type="content" source="media/cmake-targets-view2.png" alt-text="Screenshot of the Solution Explorer Views window with the C Make Targets View highlighted."::: -Additionally, you can simply switch views by right-clicking on any file or folder in your Solution Explorer and selecting **Switch to CMake Targets View**. +You can also switch views by right-clicking on any file or folder in your Solution Explorer and selecting **Switch to CMake Targets View**. -![Context Menu item to Switch to CMake Targets View.](media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png) +![This is a picture of the right-clicking on any file or folder in the Solution Explorer and seeing the Context Menu item to Switch to CMake Targets View.](media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png) Choose the **Show All Files** button at the top of **Solution Explorer** to see all the CMake-generated output in the *`out/build/`* folders. From 899b1186e2722425d395c8b5fb15c352bacb9f04 Mon Sep 17 00:00:00 2001 From: Sinem Akinci <99284450+sinemakinci1@users.noreply.github.com> Date: Mon, 17 Jul 2023 10:52:17 -0700 Subject: [PATCH 0004/1799] Update cmake-projects-in-visual-studio.md Improving wordiness --- docs/build/cmake-projects-in-visual-studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index d2237ab4c26..4cc7cae49bf 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -48,7 +48,7 @@ Once CMake cache generation has succeeded, you can also view your projects organ You can also switch views by right-clicking on any file or folder in your Solution Explorer and selecting **Switch to CMake Targets View**. -![This is a picture of the right-clicking on any file or folder in the Solution Explorer and seeing the Context Menu item to Switch to CMake Targets View.](media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png) +![A screenshot of the right-clicking on any file or folder in the Solution Explorer and seeing the Context Menu item to Switch to CMake Targets View.](media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png) Choose the **Show All Files** button at the top of **Solution Explorer** to see all the CMake-generated output in the *`out/build/`* folders. From 500ba40c4ba7ba43da9a1f035a83c01427f38bda Mon Sep 17 00:00:00 2001 From: Sinem Akinci <99284450+sinemakinci1@users.noreply.github.com> Date: Mon, 17 Jul 2023 17:03:11 -0700 Subject: [PATCH 0005/1799] Update cmake-projects-in-visual-studio.md --- docs/build/cmake-projects-in-visual-studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index 4cc7cae49bf..7d6d7e88dae 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -48,7 +48,7 @@ Once CMake cache generation has succeeded, you can also view your projects organ You can also switch views by right-clicking on any file or folder in your Solution Explorer and selecting **Switch to CMake Targets View**. -![A screenshot of the right-clicking on any file or folder in the Solution Explorer and seeing the Context Menu item to Switch to CMake Targets View.](media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png) +![A screenshot of right-clicking a file or folder in the Solution explorer. The context menu item to Switch to CMake Targets View is visible](media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png) Choose the **Show All Files** button at the top of **Solution Explorer** to see all the CMake-generated output in the *`out/build/`* folders. From de572a27fd782d1ca5b6e886ab30c5fdb4062041 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Tue, 27 May 2025 11:41:24 +0900 Subject: [PATCH 0006/1799] Fix typo: programatically -> programmatically --- docs/build/reference/sarif-output.md | 2 +- docs/mfc/reference/codesnippet/CPP/cbutton-class_10.h | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/build/reference/sarif-output.md b/docs/build/reference/sarif-output.md index 3cbd7524764..29e608baa88 100644 --- a/docs/build/reference/sarif-output.md +++ b/docs/build/reference/sarif-output.md @@ -15,7 +15,7 @@ The MSVC compiler can be made to output diagnostics as [SARIF](https://sarifweb. There are two ways to make the MSVC compiler produce SARIF diagnostics: - Pass the `/experimental:log` switch on the command line. See the [documentation for `/experimental:log`](experimental-log.md) for details. -- Launch `cl.exe` programatically and set the `SARIF_OUTPUT_PIPE` environment variable to retrieve SARIF blocks through a pipe. +- Launch `cl.exe` programmatically and set the `SARIF_OUTPUT_PIPE` environment variable to retrieve SARIF blocks through a pipe. ## Retrieving SARIF through a pipe diff --git a/docs/mfc/reference/codesnippet/CPP/cbutton-class_10.h b/docs/mfc/reference/codesnippet/CPP/cbutton-class_10.h index e34c0f5e239..c428acdc935 100644 --- a/docs/mfc/reference/codesnippet/CPP/cbutton-class_10.h +++ b/docs/mfc/reference/codesnippet/CPP/cbutton-class_10.h @@ -1,5 +1,5 @@ public: -// Variable to access programatically defined command link control. +// Variable to access programmatically defined command link control. CButton m_cmdLink; -// Variable to access programatically defined split button control. +// Variable to access programmatically defined split button control. CButton m_splitButton; \ No newline at end of file From 63fbcf0fbc9753e5e776135f9b82aaa4faf28a8c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 3 Jun 2025 15:58:30 +0800 Subject: [PATCH 0007/1799] Resolve misplaced leading backtick in link text --- docs/build/reference/linker-property-pages.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2653.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/build/reference/linker-property-pages.md b/docs/build/reference/linker-property-pages.md index 84c379aa0b3..edc4d728eea 100644 --- a/docs/build/reference/linker-property-pages.md +++ b/docs/build/reference/linker-property-pages.md @@ -252,7 +252,7 @@ Specifies total heap allocation size in virtual memory. Default is 1 MB. ([`/ ### Heap Commit Size -Specifies total heap allocation size in physical memory. Default is 4 KB. (`[/HEAP:reserve,commit`](heap-set-heap-size.md)) +Specifies total heap allocation size in physical memory. Default is 4 KB. ([`/HEAP:reserve,commit`](heap-set-heap-size.md)) ### Stack Reserve Size @@ -373,7 +373,7 @@ Partially sign the Windows Metadata. Use [`/WINMDDELAYSIGN`](winmddelaysign-part ### Entry Point -The `[/ENTRY`](entry-entry-point-symbol.md) option specifies an entry point function as the starting address for an *`.exe`* file or DLL. +The [`/ENTRY`](entry-entry-point-symbol.md) option specifies an entry point function as the starting address for an *`.exe`* file or DLL. ### No Entry Point diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md index b1cbd557784..1727502cd20 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md @@ -14,7 +14,7 @@ The language syntax requires a class, structure, union, or namespace name here. This error can occur when you use a name that has not been declared as a class, structure, union, or namespace in front of a scope operator. To fix this issue, declare the name or include the header that declares the name before it is used. -C2653 is also possible if you try to define a *compound namespace*, a namespace that contains one or more scope-nested namespace names. Compound namespace definitions are not allowed in C++ prior to C++17. Compound namespaces are supported starting in Visual Studio 2015 Update 3 when you specify the [`/std:c++latest`](../../build/reference/std-specify-language-standard-version.md) compiler option. Starting in Visual Studio 2017 version 15.5, the compiler supports compound namespace definitions when the `[/std:c++17`](../../build/reference/std-specify-language-standard-version.md) or later option is specified. +C2653 is also possible if you try to define a *compound namespace*, a namespace that contains one or more scope-nested namespace names. Compound namespace definitions are not allowed in C++ prior to C++17. Compound namespaces are supported starting in Visual Studio 2015 Update 3 when you specify the [`/std:c++latest`](../../build/reference/std-specify-language-standard-version.md) compiler option. Starting in Visual Studio 2017 version 15.5, the compiler supports compound namespace definitions when the [`/std:c++17`](../../build/reference/std-specify-language-standard-version.md) or later option is specified. ## Examples From 149a431c3b8d14fe08ac6fe7b2acd1147267099f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 3 Jun 2025 15:59:58 +0800 Subject: [PATCH 0008/1799] Update metadata in 2 topics --- docs/build/reference/linker-property-pages.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2653.md | 5 ++--- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/build/reference/linker-property-pages.md b/docs/build/reference/linker-property-pages.md index edc4d728eea..27a8a52d11c 100644 --- a/docs/build/reference/linker-property-pages.md +++ b/docs/build/reference/linker-property-pages.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Property Pages" title: "Linker Property Pages" +description: "Learn more about: Linker Property Pages" ms.date: 09/07/2022 ms.topic: "article" f1_keywords: ["VC.Project.VCLinkerTool.IgnoreImportLibrary", "VC.Project.VCLinkerTool.RegisterOutput", "VC.Project.VCLinkerTool.PerUserRedirection", "VC.Project.VCLinkerTool.LinkLibraryDependencies", "VC.Project.VCLinkerTool.UseLibraryDependencyInputs"] -ms.assetid: 7e7671e5-a35a-4e67-9bdb-661d75c4d11e --- # Linker Property Pages diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md index 1727502cd20..dba63492f1a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2653" title: "Compiler Error C2653" -ms.date: "11/30/2017" +description: "Learn more about: Compiler Error C2653" +ms.date: 11/30/2017 f1_keywords: ["C2653"] helpviewer_keywords: ["C2653"] -ms.assetid: 3f49e731-affd-43a0-a8d0-181db7650bc3 --- # Compiler Error C2653 From 82976003e8b6662e88ecc97fc385f0cd81553148 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 16:38:04 +0800 Subject: [PATCH 0009/1799] Remove empty lines at start and end of code block --- docs/code-quality/c6393.md | 1 - docs/cpp/functions-cpp.md | 1 - docs/porting/visual-cpp-what-s-new-2003-through-2015.md | 1 - 3 files changed, 3 deletions(-) diff --git a/docs/code-quality/c6393.md b/docs/code-quality/c6393.md index 07f0c540f0c..9ee04372b63 100644 --- a/docs/code-quality/c6393.md +++ b/docs/code-quality/c6393.md @@ -26,7 +26,6 @@ Code analysis name: `LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP` The following code creates a lookup table for the day of the year, assuming 365 days per year. However, this doesn't work if the year is a leap year: ```cpp - #include void foo(int year) diff --git a/docs/cpp/functions-cpp.md b/docs/cpp/functions-cpp.md index 92c4ee51583..4c30f1844e0 100644 --- a/docs/cpp/functions-cpp.md +++ b/docs/cpp/functions-cpp.md @@ -77,7 +77,6 @@ Optional parts of a function declaration are: ```cpp //Declare printf with C linkage. extern "C" int printf( const char *fmt, ... ); - ``` For more information, see [Translation units and linkage](../cpp/program-and-linkage-cpp.md). diff --git a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md index 827474f7a85..e2a8e80cb99 100644 --- a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md +++ b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md @@ -226,7 +226,6 @@ Although these differences can affect your source code or other build artifacts, ```cpp error C3688: invalid literal suffix '_x'; literal operator or literal operator template 'operator ""_x' not found note: Did you forget a space between the string literal and the prefix of the following string literal? - ``` To fix this problem, add a space between the string literal and the macro. From f165e31b9b28db92fd317f5d94a4912e3e470790 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 16:38:53 +0800 Subject: [PATCH 0010/1799] Update metadata for 2 topics --- docs/code-quality/c6393.md | 2 +- docs/cpp/functions-cpp.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/code-quality/c6393.md b/docs/code-quality/c6393.md index 9ee04372b63..c35c7134b50 100644 --- a/docs/code-quality/c6393.md +++ b/docs/code-quality/c6393.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Warning C6393" title: Warning C6393 +description: "Learn more about: Warning C6393" ms.date: 11/29/2023 f1_keywords: ["C6393", "LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP", "__WARNING_LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP"] helpviewer_keywords: ["C6393"] diff --git a/docs/cpp/functions-cpp.md b/docs/cpp/functions-cpp.md index 4c30f1844e0..58670206a16 100644 --- a/docs/cpp/functions-cpp.md +++ b/docs/cpp/functions-cpp.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Functions (C++)" title: "Functions (C++)" -ms.date: "11/19/2018" +description: "Learn more about: Functions (C++)" +ms.date: 11/19/2018 helpviewer_keywords: ["defaults, arguments", "function definitions", "function definitions, about function definitions", "default arguments", "declarators, functions"] --- # Functions (C++) From d954c467281597ea0cc7762986c91d8c8b1d9805 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 16:41:06 +0800 Subject: [PATCH 0011/1799] Adjust spacing in C6393 warning examples --- docs/code-quality/c6393.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/code-quality/c6393.md b/docs/code-quality/c6393.md index c35c7134b50..a905c012a25 100644 --- a/docs/code-quality/c6393.md +++ b/docs/code-quality/c6393.md @@ -26,25 +26,25 @@ Code analysis name: `LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP` The following code creates a lookup table for the day of the year, assuming 365 days per year. However, this doesn't work if the year is a leap year: ```cpp -#include - -void foo(int year) -{ - const std::vector items(365); // C6393 - // Initialize items and use it... +#include + +void foo(int year) +{ + const std::vector items(365); // C6393 + // Initialize items and use it... } ``` To fix the problem, adjust the size of the lookup table as the table is created according to the result of appropriate leap year check: ```cpp -#include - -void foo(int year) -{ - bool isLeapYear = year % 4 == 0 && (year % 100 != 0 || year % 400 == 0); - const std::vector items(isLeapYear ? 366 : 365); - // Initialize items and use it... +#include + +void foo(int year) +{ + bool isLeapYear = year % 4 == 0 && (year % 100 != 0 || year % 400 == 0); + const std::vector items(isLeapYear ? 366 : 365); + // Initialize items and use it... } ``` From 3c305c3473b821467bf8d6df5d0f17f5be544117 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 17:01:39 +0800 Subject: [PATCH 0012/1799] Add blockquotes and tweak C2583 error message --- docs/error-messages/compiler-errors-2/compiler-error-c2583.md | 2 +- .../compiler-errors-2/compiler-errors-c2500-through-c2599.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md index be529b59a76..dc8ea8a808b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md @@ -8,7 +8,7 @@ ms.assetid: b1c952dc-872c-47e4-9fc8-4dd72bcee6f9 --- # Compiler Error C2583 -'identifier' : 'const/volatile' 'this' pointer is illegal for constructors/destructors +> '*identifier*': '*const/volatile*' 'this' pointer is illegal for constructors/destructors A constructor or destructor is declared **`const`** or **`volatile`**. This is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md index 0c7a82cf38a..62ed444ca78 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md @@ -98,7 +98,7 @@ The articles in this section of the documentation explain a subset of the error |Compiler error C2580|'*identifier*': multiple versions of a defaulted special member functions are not allowed| |[Compiler error C2581](compiler-error-C2581.md)|'*type*': static 'operator =' function is illegal| |[Compiler error C2582](compiler-error-C2582.md)|'operator *operator*' function is unavailable in '*type*'| -|[Compiler error C2583](compiler-error-C2583.md)|'*identifier*': 'const/volatile' 'this' pointer is illegal for constructors/destructors| +|[Compiler error C2583](compiler-error-C2583.md)|'*identifier*': '*const/volatile*' 'this' pointer is illegal for constructors/destructors| |[Compiler error C2584](compiler-error-C2584.md)|'*class*': direct base '*base_class2*' is inaccessible; already a base of '*base_class1*'| |[Compiler error C2585](compiler-error-C2585.md)|explicit conversion to '*type*' is ambiguous| |[Compiler error C2586](compiler-error-C2586.md)|incorrect user-defined conversion syntax: illegal indirections| From c48adf17b9d2f30303ccc9782f86bff665b4d61c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 17:03:03 +0800 Subject: [PATCH 0013/1799] Add "Remarks" and "Example" headings in C2583 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c2583.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md index dc8ea8a808b..36afa6914c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md @@ -10,8 +10,12 @@ ms.assetid: b1c952dc-872c-47e4-9fc8-4dd72bcee6f9 > '*identifier*': '*const/volatile*' 'this' pointer is illegal for constructors/destructors +## Remarks + A constructor or destructor is declared **`const`** or **`volatile`**. This is not allowed. +## Example + The following sample generates C2583: ```cpp From 11d1ad06889272df7be1197892a4cd88b84c41f0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 17:07:56 +0800 Subject: [PATCH 0014/1799] Reword remarks in C2583 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c2583.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md index 36afa6914c3..ea0333e6874 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md @@ -12,7 +12,7 @@ ms.assetid: b1c952dc-872c-47e4-9fc8-4dd72bcee6f9 ## Remarks -A constructor or destructor is declared **`const`** or **`volatile`**. This is not allowed. +A constructor or destructor can't be declared **`const`** or **`volatile`**. ## Example From 5822cbcdac78796fb89163a721ac6e406ef61c67 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 17:11:13 +0800 Subject: [PATCH 0015/1799] Add links for "constructor" and "destructor" in C2583 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c2583.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md index ea0333e6874..eb53d3f3f91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md @@ -12,7 +12,7 @@ ms.assetid: b1c952dc-872c-47e4-9fc8-4dd72bcee6f9 ## Remarks -A constructor or destructor can't be declared **`const`** or **`volatile`**. +A [constructor](../../cpp/constructors-cpp.md) or [destructor](../../cpp/destructors-cpp.md) can't be declared **`const`** or **`volatile`**. ## Example From bfe2cd8075de57392c8c7fa594b1aab502605715 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 17:13:43 +0800 Subject: [PATCH 0016/1799] Improve example in C2583 error reference --- .../compiler-errors-2/compiler-error-c2583.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md index eb53d3f3f91..94806ad8cd3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md @@ -16,17 +16,16 @@ A [constructor](../../cpp/constructors-cpp.md) or [destructor](../../cpp/destruc ## Example -The following sample generates C2583: +The following example generates C2583: ```cpp // C2583.cpp // compile with: /c -class A { -public: - int i; - A() const; // C2583 +struct S +{ + S() const {} // C2583 - // try the following line instead - // A(); + // Try the following line instead: + // S() {} }; ``` From d6685b18d047df0b474510838bc5ce8e94bf0285 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 17:16:12 +0800 Subject: [PATCH 0017/1799] Update metadata in C2583 error reference --- .../error-messages/compiler-errors-2/compiler-error-c2583.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md index 94806ad8cd3..e6a0d840758 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2583" title: "Compiler Error C2583" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2583" +ms.date: 06/06/2025 f1_keywords: ["C2583"] helpviewer_keywords: ["C2583"] -ms.assetid: b1c952dc-872c-47e4-9fc8-4dd72bcee6f9 --- # Compiler Error C2583 From 44be4372acf25eb609d6398d4d88da96ee06047a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 6 Jun 2025 18:42:13 +0800 Subject: [PATCH 0018/1799] Elide line tabulation (U+000B) in "Microsoft C/C++ change history 2003 - 2015" --- docs/porting/visual-cpp-change-history-2003-2015.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/porting/visual-cpp-change-history-2003-2015.md b/docs/porting/visual-cpp-change-history-2003-2015.md index 3d90b199552..cb872ffdf6a 100644 --- a/docs/porting/visual-cpp-change-history-2003-2015.md +++ b/docs/porting/visual-cpp-change-history-2003-2015.md @@ -1650,10 +1650,10 @@ Although these differences can affect your source code or other build artifacts, //b.cpp // compile with cl.exe /nologo /LD /EHsc /Osx b.cpp - #pragma comment(lib, "A") + #pragma comment(lib, "A") class __declspec(dllimport) A { - public: A(); + public: A(); A(const A&); virtual ~A(); private: @@ -1667,7 +1667,7 @@ Although these differences can affect your source code or other build artifacts, //c.cpp #pragma comment(lib, "A") - #pragma comment(lib, "B") + #pragma comment(lib, "B") class __declspec(dllimport) A { public: From 48a41f3d9f883d81db62594ac7d6e3eaf9bf1360 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 8 Jun 2025 18:30:13 +0800 Subject: [PATCH 0019/1799] Add anchor for "Heterogeneous Lookup in Associative Containers" section --- docs/standard-library/stl-containers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/stl-containers.md b/docs/standard-library/stl-containers.md index ffdac90c0ce..7e97db0a5e5 100644 --- a/docs/standard-library/stl-containers.md +++ b/docs/standard-library/stl-containers.md @@ -39,7 +39,7 @@ Both `map` and `set` only allow one instance of a key or element to be inserted Ordered maps and sets support bi-directional iterators, and their unordered counterparts support forward iterators. For more information, see [Iterators](../standard-library/iterators.md). -### Heterogeneous Lookup in Associative Containers (C++14) +### Heterogeneous Lookup in Associative Containers (C++14) The ordered associative containers (map, multimap, set, and multiset) now support heterogeneous lookup, which means that you're no longer required to pass the exact same object type as the key or element in member functions such as `find()` and `lower_bound()`. Instead, you can pass any type for which an overloaded `operator<` is defined that enables comparison to the key type. From 5391bbea2dd24258379b9dfd36642939ae151e88 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 8 Jun 2025 18:40:20 +0800 Subject: [PATCH 0020/1799] Fix wrong links to "Heterogeneous Lookup in Associative Containers" --- docs/standard-library/map-class.md | 6 +++--- docs/standard-library/multimap-class.md | 6 +++--- docs/standard-library/multiset-class.md | 6 +++--- docs/standard-library/set-class.md | 6 +++--- 4 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/standard-library/map-class.md b/docs/standard-library/map-class.md index d1dfc976a87..59ae7cb4d32 100644 --- a/docs/standard-library/map-class.md +++ b/docs/standard-library/map-class.md @@ -32,7 +32,7 @@ The element data type to be stored in the `map`. *`Traits`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the `map`. This argument is optional and the binary predicate `less` is the default value. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the map's allocation and deallocation of memory. This argument is optional and the default value is `allocator >`. @@ -64,7 +64,7 @@ The map orders the elements it controls by calling a stored function object of t > [!NOTE] > The comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate f(x,y) is a function object that has two argument objects x and y, and a return value of **`true`** or **`false`**. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive, and if equivalence is transitive, where two objects x and y are defined to be equivalent when both f(x,y) and f(y,x) are **`false`**. If the stronger condition of equality between keys replaces that of equivalence, the ordering becomes total (in the sense that all the elements are ordered with regard to one other), and the keys matched will be indiscernible from one other. > -> In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +> In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ## Members @@ -552,7 +552,7 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example diff --git a/docs/standard-library/multimap-class.md b/docs/standard-library/multimap-class.md index 5266e0c7029..8b0d25f1a4f 100644 --- a/docs/standard-library/multimap-class.md +++ b/docs/standard-library/multimap-class.md @@ -30,7 +30,7 @@ The element data type to be stored in the multimap. *`Traits`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the multimap. The binary predicate `less` is the default value. -In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. For more information, see [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) +In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. For more information, see [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the map's allocation and deallocation of memory. This argument is optional and the default value is `allocator >`. @@ -59,7 +59,7 @@ The `multimap` should be the associative container of choice when the conditions The `multimap` orders the sequence it controls by calling a stored function object of type [`key_compare`](#key_compare). This stored object is a comparison function that may be accessed by calling the member function [`key_comp`](#key_comp). In general, the elements need be merely less than comparable to establish this order: so that, given any two elements, it may be determined either that they are equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate `f(x,y)` is a function object that has two argument objects `x` and `y` and a return value of `true` or `false`. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects `x` and `y` are defined to be equivalent when both `f(x,y)` and `f(y,x)` are `false`. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. -In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ## Members @@ -430,7 +430,7 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example diff --git a/docs/standard-library/multiset-class.md b/docs/standard-library/multiset-class.md index 92ffe74b358..ab9f733400a 100644 --- a/docs/standard-library/multiset-class.md +++ b/docs/standard-library/multiset-class.md @@ -24,7 +24,7 @@ The element data type to be stored in the `multiset`. *`Compare`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the `multiset`. The binary predicate **less**\ is the default value. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the `multiset`'s allocation and deallocation of memory. The default value is `allocator`. @@ -53,7 +53,7 @@ The `multiset` should be the associative container of choice when the conditions The `multiset` orders the sequence it controls by calling a stored function object of type *`Compare`*. This stored object is a comparison function that may be accessed by calling the member function [`key_comp`](#key_comp). In general, the elements need be merely less than comparable to establish this order: so that, given any two elements, it may be determined either that they're equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate *f*(*x*, *y*) is a function object that has two argument objects *x* and *y* and a return value of **`true`** or **`false`**. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects x and y are defined to be equivalent when both *f*(*x,y*) and *f*(*y,x*) are false. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Constructors @@ -399,7 +399,7 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [/std:c++20](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example diff --git a/docs/standard-library/set-class.md b/docs/standard-library/set-class.md index 53465da3dbe..7239b214e39 100644 --- a/docs/standard-library/set-class.md +++ b/docs/standard-library/set-class.md @@ -26,7 +26,7 @@ The element data type to be stored in the set. *`Traits`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the set. This argument is optional, and the binary predicate `less ` is the default value. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the set's allocation and deallocation of memory. This argument is optional, and the default value is `allocator`. @@ -51,7 +51,7 @@ The set should be the associative container of choice when the conditions associ The set orders the sequence it controls by calling a stored function object of type [`key_compare`](#key_compare). This stored object is a comparison function that may be accessed by calling the member function [`key_comp`](#key_comp). In general, the elements need to be merely less than comparable to establish this order so that, given any two elements, it may be determined either that they're equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate *f*(*x,y*) is a function object that has two argument objects *x* and *y* and a return value of **`true`** or **`false`**. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects *x* and *y* are defined to be equivalent when both *f* *x,y*) and *f*(*y,x*) are false. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. The iterator provided by the set class is a bidirectional iterator, but the class member functions [`insert`](#insert) and [`set`](#set) have versions that take as template parameters a weaker input iterator, whose functionality requirements are more minimal than those guaranteed by the class of bidirectional iterators. The different iterator concepts form a family related by refinements in their functionality. Each iterator concept has its own set of requirements, and the algorithms that work with them must limit their assumptions to the requirements provided by that type of iterator. It may be assumed that an input iterator may be dereferenced to refer to some object and that it may be incremented to the next iterator in the sequence. This is a minimal set of functionality, but it's enough to be able to talk meaningfully about a range of iterators [ `First`, `Last`) in the context of the class's member functions. @@ -399,7 +399,7 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example From c36d657e0e1954fe7a7f7d87c24266a5d5094251 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 8 Jun 2025 18:46:55 +0800 Subject: [PATCH 0021/1799] Trim redundant links to "Heterogeneous Lookup in Associative Containers" --- docs/standard-library/map-class.md | 6 +++--- docs/standard-library/multimap-class.md | 6 +++--- docs/standard-library/multiset-class.md | 6 +++--- docs/standard-library/set-class.md | 6 +++--- 4 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/standard-library/map-class.md b/docs/standard-library/map-class.md index 59ae7cb4d32..c630e1c4152 100644 --- a/docs/standard-library/map-class.md +++ b/docs/standard-library/map-class.md @@ -32,7 +32,7 @@ The element data type to be stored in the `map`. *`Traits`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the `map`. This argument is optional and the binary predicate `less` is the default value. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the map's allocation and deallocation of memory. This argument is optional and the default value is `allocator >`. @@ -64,7 +64,7 @@ The map orders the elements it controls by calling a stored function object of t > [!NOTE] > The comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate f(x,y) is a function object that has two argument objects x and y, and a return value of **`true`** or **`false`**. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive, and if equivalence is transitive, where two objects x and y are defined to be equivalent when both f(x,y) and f(y,x) are **`false`**. If the stronger condition of equality between keys replaces that of equivalence, the ordering becomes total (in the sense that all the elements are ordered with regard to one other), and the keys matched will be indiscernible from one other. > -> In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +> In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ## Members @@ -552,7 +552,7 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example diff --git a/docs/standard-library/multimap-class.md b/docs/standard-library/multimap-class.md index 8b0d25f1a4f..fd24a711eb1 100644 --- a/docs/standard-library/multimap-class.md +++ b/docs/standard-library/multimap-class.md @@ -30,7 +30,7 @@ The element data type to be stored in the multimap. *`Traits`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the multimap. The binary predicate `less` is the default value. -In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. For more information, see [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) +In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. For more information, see [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the map's allocation and deallocation of memory. This argument is optional and the default value is `allocator >`. @@ -59,7 +59,7 @@ The `multimap` should be the associative container of choice when the conditions The `multimap` orders the sequence it controls by calling a stored function object of type [`key_compare`](#key_compare). This stored object is a comparison function that may be accessed by calling the member function [`key_comp`](#key_comp). In general, the elements need be merely less than comparable to establish this order: so that, given any two elements, it may be determined either that they are equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate `f(x,y)` is a function object that has two argument objects `x` and `y` and a return value of `true` or `false`. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects `x` and `y` are defined to be equivalent when both `f(x,y)` and `f(y,x)` are `false`. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. -In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ## Members @@ -430,7 +430,7 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example diff --git a/docs/standard-library/multiset-class.md b/docs/standard-library/multiset-class.md index ab9f733400a..0fbaa078508 100644 --- a/docs/standard-library/multiset-class.md +++ b/docs/standard-library/multiset-class.md @@ -24,7 +24,7 @@ The element data type to be stored in the `multiset`. *`Compare`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the `multiset`. The binary predicate **less**\ is the default value. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the `multiset`'s allocation and deallocation of memory. The default value is `allocator`. @@ -53,7 +53,7 @@ The `multiset` should be the associative container of choice when the conditions The `multiset` orders the sequence it controls by calling a stored function object of type *`Compare`*. This stored object is a comparison function that may be accessed by calling the member function [`key_comp`](#key_comp). In general, the elements need be merely less than comparable to establish this order: so that, given any two elements, it may be determined either that they're equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate *f*(*x*, *y*) is a function object that has two argument objects *x* and *y* and a return value of **`true`** or **`false`**. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects x and y are defined to be equivalent when both *f*(*x,y*) and *f*(*y,x*) are false. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Constructors @@ -399,7 +399,7 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [/std:c++20](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example diff --git a/docs/standard-library/set-class.md b/docs/standard-library/set-class.md index 7239b214e39..17de564011d 100644 --- a/docs/standard-library/set-class.md +++ b/docs/standard-library/set-class.md @@ -26,7 +26,7 @@ The element data type to be stored in the set. *`Traits`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the set. This argument is optional, and the binary predicate `less ` is the default value. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the set's allocation and deallocation of memory. This argument is optional, and the default value is `allocator`. @@ -51,7 +51,7 @@ The set should be the associative container of choice when the conditions associ The set orders the sequence it controls by calling a stored function object of type [`key_compare`](#key_compare). This stored object is a comparison function that may be accessed by calling the member function [`key_comp`](#key_comp). In general, the elements need to be merely less than comparable to establish this order so that, given any two elements, it may be determined either that they're equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate *f*(*x,y*) is a function object that has two argument objects *x* and *y* and a return value of **`true`** or **`false`**. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects *x* and *y* are defined to be equivalent when both *f* *x,y*) and *f*(*y,x*) are false. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. The iterator provided by the set class is a bidirectional iterator, but the class member functions [`insert`](#insert) and [`set`](#set) have versions that take as template parameters a weaker input iterator, whose functionality requirements are more minimal than those guaranteed by the class of bidirectional iterators. The different iterator concepts form a family related by refinements in their functionality. Each iterator concept has its own set of requirements, and the algorithms that work with them must limit their assumptions to the requirements provided by that type of iterator. It may be assumed that an input iterator may be dereferenced to refer to some object and that it may be incremented to the next iterator in the sequence. This is a minimal set of functionality, but it's enough to be able to talk meaningfully about a range of iterators [ `First`, `Last`) in the context of the class's member functions. @@ -399,7 +399,7 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example From fd729a929e4d2532d93cafce2ca393f877eddcd2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 8 Jun 2025 18:48:37 +0800 Subject: [PATCH 0022/1799] Update metadata for "C++ Standard Library Containers" topic --- docs/standard-library/stl-containers.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/stl-containers.md b/docs/standard-library/stl-containers.md index 7e97db0a5e5..0b8ce549317 100644 --- a/docs/standard-library/stl-containers.md +++ b/docs/standard-library/stl-containers.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: C++ Standard Library Containers" title: "C++ Standard Library Containers" -ms.date: "11/04/2016" +description: "Learn more about: C++ Standard Library Containers" +ms.date: 11/04/2016 helpviewer_keywords: ["C++ Standard Library, class template containers", "containers, C++ Standard Library"] -ms.assetid: 8e915ca1-19ba-4f0d-93c8-e2c3bfd638eb --- # C++ Standard Library Containers From c5af7d7bc91631bcdeae1068d0d7dcc244fc8b93 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 10 Jun 2025 00:06:07 +0800 Subject: [PATCH 0023/1799] Remove extraneous "class" in link text after "class template" --- .../basic-cstring-operations.md | 2 +- docs/standard-library/array-operators.md | 4 +-- .../char-traits-char-struct.md | 2 +- docs/standard-library/cvt-wbuffer.md | 2 +- docs/standard-library/cvt-wstring.md | 2 +- docs/standard-library/regex-traits-class.md | 2 +- docs/standard-library/regex-typedefs.md | 36 +++++++++---------- docs/standard-library/regex.md | 4 +-- docs/standard-library/string-operators.md | 2 +- docs/standard-library/unordered-map-class.md | 2 +- .../unordered-multimap-class.md | 2 +- .../unordered-multiset-class.md | 2 +- docs/standard-library/unordered-set-class.md | 2 +- 13 files changed, 32 insertions(+), 32 deletions(-) diff --git a/docs/atl-mfc-shared/basic-cstring-operations.md b/docs/atl-mfc-shared/basic-cstring-operations.md index 41926fe05be..d882ab73b08 100644 --- a/docs/atl-mfc-shared/basic-cstring-operations.md +++ b/docs/atl-mfc-shared/basic-cstring-operations.md @@ -19,7 +19,7 @@ This topic explains the following basic [CString](../atl-mfc-shared/reference/cs - [Converting CString objects](#_core_converting_cstring_objects) -`Class CString` is based on class template [CStringT Class](../atl-mfc-shared/reference/cstringt-class.md). `CString` is a **`typedef`** of `CStringT`. More exactly, `CString` is a **`typedef`** of an *explicit specialization* of `CStringT`, which is a common way to use a class template to define a class. Similarly defined classes are `CStringA` and `CStringW`. +`Class CString` is based on class template [CStringT](../atl-mfc-shared/reference/cstringt-class.md). `CString` is a **`typedef`** of `CStringT`. More exactly, `CString` is a **`typedef`** of an *explicit specialization* of `CStringT`, which is a common way to use a class template to define a class. Similarly defined classes are `CStringA` and `CStringW`. `CString`, `CStringA`, and `CStringW` are defined in atlstr.h. `CStringT` is defined in cstringt.h. diff --git a/docs/standard-library/array-operators.md b/docs/standard-library/array-operators.md index 866d09f22ef..14a1d0d37fb 100644 --- a/docs/standard-library/array-operators.md +++ b/docs/standard-library/array-operators.md @@ -116,7 +116,7 @@ Right container to compare. ### Remarks -The template function overloads `operator<` to compare two objects of class template [array Class](../standard-library/array-class-stl.md). The function returns `lexicographical_compare(left.begin(), left.end(), right.begin())`. +The template function overloads `operator<` to compare two objects of class template [array](../standard-library/array-class-stl.md). The function returns `lexicographical_compare(left.begin(), left.end(), right.begin())`. ### Example @@ -262,7 +262,7 @@ Right container to compare. ### Remarks -The template function overloads `operator==` to compare two objects of class template [array Class](../standard-library/array-class-stl.md). The function returns `equal(left.begin(), left.end(), right.begin())`. +The template function overloads `operator==` to compare two objects of class template [array](../standard-library/array-class-stl.md). The function returns `equal(left.begin(), left.end(), right.begin())`. ### Example diff --git a/docs/standard-library/char-traits-char-struct.md b/docs/standard-library/char-traits-char-struct.md index 22aa1ee35da..abe82ed2f28 100644 --- a/docs/standard-library/char-traits-char-struct.md +++ b/docs/standard-library/char-traits-char-struct.md @@ -23,4 +23,4 @@ Specialization allows the struct to take advantage of library functions that man ## Example -See the typedefs and member functions of the class template [char_traits Class](../standard-library/char-traits-struct.md) +See the typedefs and member functions of the class template [char_traits](../standard-library/char-traits-struct.md) diff --git a/docs/standard-library/cvt-wbuffer.md b/docs/standard-library/cvt-wbuffer.md index 58d5cc7cc31..40126fd1880 100644 --- a/docs/standard-library/cvt-wbuffer.md +++ b/docs/standard-library/cvt-wbuffer.md @@ -8,7 +8,7 @@ ms.assetid: 6e6eb44c-1bc4-4d8c-a4bd-b39c753ce725 --- # `` -The header `` in previous versions of Visual Studio defined the class template [wbuffer_convert Class](../standard-library/wbuffer-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace +The header `` in previous versions of Visual Studio defined the class template [wbuffer_convert](../standard-library/wbuffer-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace ## Syntax diff --git a/docs/standard-library/cvt-wstring.md b/docs/standard-library/cvt-wstring.md index 3ce22b8c32e..03f150d51f1 100644 --- a/docs/standard-library/cvt-wstring.md +++ b/docs/standard-library/cvt-wstring.md @@ -8,7 +8,7 @@ ms.assetid: d78b04bb-9ac0-4adb-8ffe-3aefb9b14c2d --- # `` -The header `` in previous versions of Visual Studio defined the class template [wstring_convert Class](../standard-library/wstring-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace +The header `` in previous versions of Visual Studio defined the class template [wstring_convert](../standard-library/wstring-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace ## Syntax diff --git a/docs/standard-library/regex-traits-class.md b/docs/standard-library/regex-traits-class.md index 512a4b7093c..590adb650b4 100644 --- a/docs/standard-library/regex-traits-class.md +++ b/docs/standard-library/regex-traits-class.md @@ -24,7 +24,7 @@ The character element type to describe. ## Remarks -The class template describes various regular expression traits for type *Elem*. The class template [basic_regex Class](../standard-library/basic-regex-class.md) uses this information to manipulate elements of type *Elem*. +The class template describes various regular expression traits for type *Elem*. The class template [basic_regex](../standard-library/basic-regex-class.md) uses this information to manipulate elements of type *Elem*. Each `regex_traits` object holds an object of type `regex_traits::locale` which is used by some of its member functions. The default locale is a copy of `regex_traits::locale()`. The member function `imbue` replaces the locale object, and the member function `getloc` returns a copy of the locale object. diff --git a/docs/standard-library/regex-typedefs.md b/docs/standard-library/regex-typedefs.md index a2c8a0adc88..a5bfeafdb8f 100644 --- a/docs/standard-library/regex-typedefs.md +++ b/docs/standard-library/regex-typedefs.md @@ -18,7 +18,7 @@ typedef match_results cmatch; ### Remarks -The type describes a specialization of class template [match_results Class](../standard-library/match-results-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [match_results](../standard-library/match-results-class.md) for iterators of type `const char*`. ## cregex_iterator Typedef @@ -30,7 +30,7 @@ typedef regex_iterator cregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator Class](../standard-library/regex-iterator-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [regex_iterator](../standard-library/regex-iterator-class.md) for iterators of type `const char*`. ## cregex_token_iterator Typedef @@ -42,7 +42,7 @@ typedef regex_token_iterator cregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator Class](../standard-library/regex-token-iterator-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [regex_token_iterator](../standard-library/regex-token-iterator-class.md) for iterators of type `const char*`. ## csub_match Typedef @@ -54,7 +54,7 @@ typedef sub_match csub_match; ### Remarks -The type describes a specialization of class template [sub_match Class](../standard-library/sub-match-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [sub_match](../standard-library/sub-match-class.md) for iterators of type `const char*`. ## regex Typedef @@ -66,7 +66,7 @@ typedef basic_regex regex; ### Remarks -The type describes a specialization of class template [basic_regex Class](../standard-library/basic-regex-class.md) for elements of type **`char`**. +The type describes a specialization of class template [basic_regex](../standard-library/basic-regex-class.md) for elements of type **`char`**. > [!NOTE] > High-bit characters will have unpredictable results with `regex`. Values outside the range of 0 to 127 may result in undefined behavior. @@ -81,7 +81,7 @@ typedef match_results smatch; ### Remarks -The type describes a specialization of class template [match_results Class](../standard-library/match-results-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [match_results](../standard-library/match-results-class.md) for iterators of type `string::const_iterator`. ## sregex_iterator Typedef @@ -93,7 +93,7 @@ typedef regex_iterator sregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator Class](../standard-library/regex-iterator-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [regex_iterator](../standard-library/regex-iterator-class.md) for iterators of type `string::const_iterator`. ## sregex_token_iterator Typedef @@ -105,7 +105,7 @@ typedef regex_token_iterator sregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator Class](../standard-library/regex-token-iterator-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [regex_token_iterator](../standard-library/regex-token-iterator-class.md) for iterators of type `string::const_iterator`. ## ssub_match Typedef @@ -117,7 +117,7 @@ typedef sub_match ssub_match; ### Remarks -The type describes a specialization of class template [sub_match Class](../standard-library/sub-match-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [sub_match](../standard-library/sub-match-class.md) for iterators of type `string::const_iterator`. ## wcmatch Typedef @@ -129,7 +129,7 @@ typedef match_results wcmatch; ### Remarks -The type describes a specialization of class template [match_results Class](../standard-library/match-results-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [match_results](../standard-library/match-results-class.md) for iterators of type `const wchar_t*`. ## wcregex_iterator Typedef @@ -141,7 +141,7 @@ typedef regex_iterator wcregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator Class](../standard-library/regex-iterator-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [regex_iterator](../standard-library/regex-iterator-class.md) for iterators of type `const wchar_t*`. ## wcregex_token_iterator Typedef @@ -153,7 +153,7 @@ typedef regex_token_iterator wcregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator Class](../standard-library/regex-token-iterator-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [regex_token_iterator](../standard-library/regex-token-iterator-class.md) for iterators of type `const wchar_t*`. ## wcsub_match Typedef @@ -165,7 +165,7 @@ typedef sub_match wcsub_match; ### Remarks -The type describes a specialization of class template [sub_match Class](../standard-library/sub-match-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [sub_match](../standard-library/sub-match-class.md) for iterators of type `const wchar_t*`. ## wregex Typedef @@ -177,7 +177,7 @@ typedef basic_regex wregex; ### Remarks -The type describes a specialization of class template [basic_regex Class](../standard-library/basic-regex-class.md) for elements of type **`wchar_t`**. +The type describes a specialization of class template [basic_regex](../standard-library/basic-regex-class.md) for elements of type **`wchar_t`**. ## wsmatch Typedef @@ -189,7 +189,7 @@ typedef match_results wsmatch; ### Remarks -The type describes a specialization of class template [match_results Class](../standard-library/match-results-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [match_results](../standard-library/match-results-class.md) for iterators of type `wstring::const_iterator`. ## wsregex_iterator Typedef @@ -201,7 +201,7 @@ typedef regex_iterator wsregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator Class](../standard-library/regex-iterator-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [regex_iterator](../standard-library/regex-iterator-class.md) for iterators of type `wstring::const_iterator`. ## wsregex_token_iterator Typedef @@ -213,7 +213,7 @@ typedef regex_token_iterator wsregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator Class](../standard-library/regex-token-iterator-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [regex_token_iterator](../standard-library/regex-token-iterator-class.md) for iterators of type `wstring::const_iterator`. ## wssub_match Typedef @@ -225,7 +225,7 @@ typedef sub_match wssub_match; ### Remarks -The type describes a specialization of class template [sub_match Class](../standard-library/sub-match-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [sub_match](../standard-library/sub-match-class.md) for iterators of type `wstring::const_iterator`. ## See also diff --git a/docs/standard-library/regex.md b/docs/standard-library/regex.md index 290bf331a60..a960dd6e94b 100644 --- a/docs/standard-library/regex.md +++ b/docs/standard-library/regex.md @@ -17,9 +17,9 @@ Defines a class template to parse [Regular Expressions (C++)](../standard-librar ## Remarks -To create a regular expression object, use the class template [`basic_regex` Class](../standard-library/basic-regex-class.md) or one of its specializations, [`regex`](../standard-library/regex-typedefs.md#regex) and [`wregex`](../standard-library/regex-typedefs.md#wregex), together with the syntax flags of type [`regex_constants::syntax_option_type`](../standard-library/regex-constants-class.md#syntax_option_type). +To create a regular expression object, use the class template [`basic_regex`](../standard-library/basic-regex-class.md) or one of its specializations, [`regex`](../standard-library/regex-typedefs.md#regex) and [`wregex`](../standard-library/regex-typedefs.md#wregex), together with the syntax flags of type [`regex_constants::syntax_option_type`](../standard-library/regex-constants-class.md#syntax_option_type). -To search text for matches to a regular expression object, use the template functions [`regex_match`](../standard-library/regex-functions.md#regex_match) and [`regex_search`](../standard-library/regex-functions.md#regex_search), together with the match flags of type [`regex_constants::match_flag_type`](../standard-library/regex-constants-class.md#match_flag_type). These functions return results by using the class template [`match_results` Class](../standard-library/match-results-class.md) and its specializations, [`cmatch`](../standard-library/regex-typedefs.md#cmatch), [`wcmatch`](../standard-library/regex-typedefs.md#wcmatch), [`smatch`](../standard-library/regex-typedefs.md#smatch), and [`wsmatch`](../standard-library/regex-typedefs.md#wsmatch), together with the class template [`sub_match` Class](../standard-library/sub-match-class.md) and its specializations, [`csub_match`](../standard-library/regex-typedefs.md#csub_match), [`wcsub_match`](../standard-library/regex-typedefs.md#wcsub_match), [`ssub_match`](../standard-library/regex-typedefs.md#ssub_match), and [`wssub_match`](../standard-library/regex-typedefs.md#wssub_match). +To search text for matches to a regular expression object, use the template functions [`regex_match`](../standard-library/regex-functions.md#regex_match) and [`regex_search`](../standard-library/regex-functions.md#regex_search), together with the match flags of type [`regex_constants::match_flag_type`](../standard-library/regex-constants-class.md#match_flag_type). These functions return results by using the class template [`match_results`](../standard-library/match-results-class.md) and its specializations, [`cmatch`](../standard-library/regex-typedefs.md#cmatch), [`wcmatch`](../standard-library/regex-typedefs.md#wcmatch), [`smatch`](../standard-library/regex-typedefs.md#smatch), and [`wsmatch`](../standard-library/regex-typedefs.md#wsmatch), together with the class template [`sub_match`](../standard-library/sub-match-class.md) and its specializations, [`csub_match`](../standard-library/regex-typedefs.md#csub_match), [`wcsub_match`](../standard-library/regex-typedefs.md#wcsub_match), [`ssub_match`](../standard-library/regex-typedefs.md#ssub_match), and [`wssub_match`](../standard-library/regex-typedefs.md#wssub_match). To replace text that matches a regular expression object, use the template function [`regex_replace`](../standard-library/regex-functions.md#regex_replace), together with the match flags of type [`regex_constants::match_flag_type`](../standard-library/regex-constants-class.md#match_flag_type). diff --git a/docs/standard-library/string-operators.md b/docs/standard-library/string-operators.md index f051116668f..54df3c74476 100644 --- a/docs/standard-library/string-operators.md +++ b/docs/standard-library/string-operators.md @@ -89,7 +89,7 @@ The string that is the concatenation of the input strings. ### Remarks -The functions each overload `operator+` to concatenate two objects of class template [basic_string Class](../standard-library/basic-string-class.md). All effectively return `basic_string< CharType, Traits, Allocator>(Left).append(right)`. For more information, see [append](../standard-library/basic-string-class.md#append). +The functions each overload `operator+` to concatenate two objects of class template [basic_string](../standard-library/basic-string-class.md). All effectively return `basic_string< CharType, Traits, Allocator>(Left).append(right)`. For more information, see [append](../standard-library/basic-string-class.md#append). ### Example diff --git a/docs/standard-library/unordered-map-class.md b/docs/standard-library/unordered-map-class.md index efdd7659ce7..6c477c968af 100644 --- a/docs/standard-library/unordered-map-class.md +++ b/docs/standard-library/unordered-map-class.md @@ -99,7 +99,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [`unordered_map::key_equal`](#key_equal) and a hash function object of type [`unordered_map::hasher`](#hasher). You access the first stored object by calling the member function [`unordered_map::key_eq`](#key_eq)`()`; and you access the second stored object by calling the member function [`unordered_map::hash_function`](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_multimap` Class](../standard-library/unordered-multimap-class.md), an object of type `unordered_map` ensures that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys are unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [`unordered_map::key_equal`](#key_equal) and a hash function object of type [`unordered_map::hasher`](#hasher). You access the first stored object by calling the member function [`unordered_map::key_eq`](#key_eq)`()`; and you access the second stored object by calling the member function [`unordered_map::hash_function`](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_multimap`](../standard-library/unordered-multimap-class.md), an object of type `unordered_map` ensures that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys are unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [`unordered_map::load_factor`](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. diff --git a/docs/standard-library/unordered-multimap-class.md b/docs/standard-library/unordered-multimap-class.md index 0f61a2cac00..a859f73d6b1 100644 --- a/docs/standard-library/unordered-multimap-class.md +++ b/docs/standard-library/unordered-multimap-class.md @@ -99,7 +99,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multimap::key_equal](#key_equal) and a hash function object of type [unordered_multimap::hasher](#hasher). You access the first stored object by calling the member function [unordered_multimap::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multimap::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [unordered_map Class](../standard-library/unordered-map-class.md), an object of type `unordered_multimap` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multimap::key_equal](#key_equal) and a hash function object of type [unordered_multimap::hasher](#hasher). You access the first stored object by calling the member function [unordered_multimap::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multimap::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [unordered_map](../standard-library/unordered-map-class.md), an object of type `unordered_multimap` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [unordered_multimap::load_factor](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. diff --git a/docs/standard-library/unordered-multiset-class.md b/docs/standard-library/unordered-multiset-class.md index 1a08ac38ecf..5b1291e3f04 100644 --- a/docs/standard-library/unordered-multiset-class.md +++ b/docs/standard-library/unordered-multiset-class.md @@ -91,7 +91,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multiset::key_equal](#key_equal) and a hash function object of type [unordered_multiset::hasher](#hasher). You access the first stored object by calling the member function [unordered_multiset::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multiset::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [unordered_set Class](../standard-library/unordered-set-class.md), an object of type `unordered_multiset` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multiset::key_equal](#key_equal) and a hash function object of type [unordered_multiset::hasher](#hasher). You access the first stored object by calling the member function [unordered_multiset::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multiset::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [unordered_set](../standard-library/unordered-set-class.md), an object of type `unordered_multiset` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [unordered_multiset::load_factor](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. diff --git a/docs/standard-library/unordered-set-class.md b/docs/standard-library/unordered-set-class.md index ab90d089afb..0380b0d4cc2 100644 --- a/docs/standard-library/unordered-set-class.md +++ b/docs/standard-library/unordered-set-class.md @@ -97,7 +97,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [`unordered_set::key_equal`](#key_equal) and a hash function object of type [`unordered_set::hasher`](#hasher). You access the first stored object by calling the member function [`unordered_set::key_eq`](#key_eq)`()`; and you access the second stored object by calling the member function [`unordered_set::hash_function`](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_multiset` Class](../standard-library/unordered-multiset-class.md), an object of type `unordered_set` ensures that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys are unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [`unordered_set::key_equal`](#key_equal) and a hash function object of type [`unordered_set::hasher`](#hasher). You access the first stored object by calling the member function [`unordered_set::key_eq`](#key_eq)`()`; and you access the second stored object by calling the member function [`unordered_set::hash_function`](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_multiset`](../standard-library/unordered-multiset-class.md), an object of type `unordered_set` ensures that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys are unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [`unordered_set::load_factor`](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. From 71afbd25de25c31bc07aafe0787b2ac9091f3cce Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 10 Jun 2025 00:11:02 +0800 Subject: [PATCH 0024/1799] Add backticks in link text after "class template" --- .../basic-cstring-operations.md | 2 +- docs/standard-library/array-operators.md | 4 +-- .../char-traits-char-struct.md | 2 +- docs/standard-library/cvt-wbuffer.md | 2 +- docs/standard-library/cvt-wstring.md | 2 +- docs/standard-library/regex-traits-class.md | 2 +- docs/standard-library/regex-typedefs.md | 36 +++++++++---------- docs/standard-library/string-operators.md | 2 +- .../unordered-multimap-class.md | 2 +- .../unordered-multiset-class.md | 2 +- 10 files changed, 28 insertions(+), 28 deletions(-) diff --git a/docs/atl-mfc-shared/basic-cstring-operations.md b/docs/atl-mfc-shared/basic-cstring-operations.md index d882ab73b08..09ef0943cb3 100644 --- a/docs/atl-mfc-shared/basic-cstring-operations.md +++ b/docs/atl-mfc-shared/basic-cstring-operations.md @@ -19,7 +19,7 @@ This topic explains the following basic [CString](../atl-mfc-shared/reference/cs - [Converting CString objects](#_core_converting_cstring_objects) -`Class CString` is based on class template [CStringT](../atl-mfc-shared/reference/cstringt-class.md). `CString` is a **`typedef`** of `CStringT`. More exactly, `CString` is a **`typedef`** of an *explicit specialization* of `CStringT`, which is a common way to use a class template to define a class. Similarly defined classes are `CStringA` and `CStringW`. +`Class CString` is based on class template [`CStringT`](../atl-mfc-shared/reference/cstringt-class.md). `CString` is a **`typedef`** of `CStringT`. More exactly, `CString` is a **`typedef`** of an *explicit specialization* of `CStringT`, which is a common way to use a class template to define a class. Similarly defined classes are `CStringA` and `CStringW`. `CString`, `CStringA`, and `CStringW` are defined in atlstr.h. `CStringT` is defined in cstringt.h. diff --git a/docs/standard-library/array-operators.md b/docs/standard-library/array-operators.md index 14a1d0d37fb..d80cd3fc35f 100644 --- a/docs/standard-library/array-operators.md +++ b/docs/standard-library/array-operators.md @@ -116,7 +116,7 @@ Right container to compare. ### Remarks -The template function overloads `operator<` to compare two objects of class template [array](../standard-library/array-class-stl.md). The function returns `lexicographical_compare(left.begin(), left.end(), right.begin())`. +The template function overloads `operator<` to compare two objects of class template [`array`](../standard-library/array-class-stl.md). The function returns `lexicographical_compare(left.begin(), left.end(), right.begin())`. ### Example @@ -262,7 +262,7 @@ Right container to compare. ### Remarks -The template function overloads `operator==` to compare two objects of class template [array](../standard-library/array-class-stl.md). The function returns `equal(left.begin(), left.end(), right.begin())`. +The template function overloads `operator==` to compare two objects of class template [`array`](../standard-library/array-class-stl.md). The function returns `equal(left.begin(), left.end(), right.begin())`. ### Example diff --git a/docs/standard-library/char-traits-char-struct.md b/docs/standard-library/char-traits-char-struct.md index abe82ed2f28..be3056c88a3 100644 --- a/docs/standard-library/char-traits-char-struct.md +++ b/docs/standard-library/char-traits-char-struct.md @@ -23,4 +23,4 @@ Specialization allows the struct to take advantage of library functions that man ## Example -See the typedefs and member functions of the class template [char_traits](../standard-library/char-traits-struct.md) +See the typedefs and member functions of the class template [`char_traits`](../standard-library/char-traits-struct.md) diff --git a/docs/standard-library/cvt-wbuffer.md b/docs/standard-library/cvt-wbuffer.md index 40126fd1880..1c69902836f 100644 --- a/docs/standard-library/cvt-wbuffer.md +++ b/docs/standard-library/cvt-wbuffer.md @@ -8,7 +8,7 @@ ms.assetid: 6e6eb44c-1bc4-4d8c-a4bd-b39c753ce725 --- # `` -The header `` in previous versions of Visual Studio defined the class template [wbuffer_convert](../standard-library/wbuffer-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace +The header `` in previous versions of Visual Studio defined the class template [`wbuffer_convert`](../standard-library/wbuffer-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace ## Syntax diff --git a/docs/standard-library/cvt-wstring.md b/docs/standard-library/cvt-wstring.md index 03f150d51f1..827402ca002 100644 --- a/docs/standard-library/cvt-wstring.md +++ b/docs/standard-library/cvt-wstring.md @@ -8,7 +8,7 @@ ms.assetid: d78b04bb-9ac0-4adb-8ffe-3aefb9b14c2d --- # `` -The header `` in previous versions of Visual Studio defined the class template [wstring_convert](../standard-library/wstring-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace +The header `` in previous versions of Visual Studio defined the class template [`wstring_convert`](../standard-library/wstring-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace ## Syntax diff --git a/docs/standard-library/regex-traits-class.md b/docs/standard-library/regex-traits-class.md index 590adb650b4..1f93d3b2e7c 100644 --- a/docs/standard-library/regex-traits-class.md +++ b/docs/standard-library/regex-traits-class.md @@ -24,7 +24,7 @@ The character element type to describe. ## Remarks -The class template describes various regular expression traits for type *Elem*. The class template [basic_regex](../standard-library/basic-regex-class.md) uses this information to manipulate elements of type *Elem*. +The class template describes various regular expression traits for type *Elem*. The class template [`basic_regex`](../standard-library/basic-regex-class.md) uses this information to manipulate elements of type *Elem*. Each `regex_traits` object holds an object of type `regex_traits::locale` which is used by some of its member functions. The default locale is a copy of `regex_traits::locale()`. The member function `imbue` replaces the locale object, and the member function `getloc` returns a copy of the locale object. diff --git a/docs/standard-library/regex-typedefs.md b/docs/standard-library/regex-typedefs.md index a5bfeafdb8f..4c7f083ccd4 100644 --- a/docs/standard-library/regex-typedefs.md +++ b/docs/standard-library/regex-typedefs.md @@ -18,7 +18,7 @@ typedef match_results cmatch; ### Remarks -The type describes a specialization of class template [match_results](../standard-library/match-results-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [`match_results`](../standard-library/match-results-class.md) for iterators of type `const char*`. ## cregex_iterator Typedef @@ -30,7 +30,7 @@ typedef regex_iterator cregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator](../standard-library/regex-iterator-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [`regex_iterator`](../standard-library/regex-iterator-class.md) for iterators of type `const char*`. ## cregex_token_iterator Typedef @@ -42,7 +42,7 @@ typedef regex_token_iterator cregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator](../standard-library/regex-token-iterator-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [`regex_token_iterator`](../standard-library/regex-token-iterator-class.md) for iterators of type `const char*`. ## csub_match Typedef @@ -54,7 +54,7 @@ typedef sub_match csub_match; ### Remarks -The type describes a specialization of class template [sub_match](../standard-library/sub-match-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [`sub_match`](../standard-library/sub-match-class.md) for iterators of type `const char*`. ## regex Typedef @@ -66,7 +66,7 @@ typedef basic_regex regex; ### Remarks -The type describes a specialization of class template [basic_regex](../standard-library/basic-regex-class.md) for elements of type **`char`**. +The type describes a specialization of class template [`basic_regex`](../standard-library/basic-regex-class.md) for elements of type **`char`**. > [!NOTE] > High-bit characters will have unpredictable results with `regex`. Values outside the range of 0 to 127 may result in undefined behavior. @@ -81,7 +81,7 @@ typedef match_results smatch; ### Remarks -The type describes a specialization of class template [match_results](../standard-library/match-results-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [`match_results`](../standard-library/match-results-class.md) for iterators of type `string::const_iterator`. ## sregex_iterator Typedef @@ -93,7 +93,7 @@ typedef regex_iterator sregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator](../standard-library/regex-iterator-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [`regex_iterator`](../standard-library/regex-iterator-class.md) for iterators of type `string::const_iterator`. ## sregex_token_iterator Typedef @@ -105,7 +105,7 @@ typedef regex_token_iterator sregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator](../standard-library/regex-token-iterator-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [`regex_token_iterator`](../standard-library/regex-token-iterator-class.md) for iterators of type `string::const_iterator`. ## ssub_match Typedef @@ -117,7 +117,7 @@ typedef sub_match ssub_match; ### Remarks -The type describes a specialization of class template [sub_match](../standard-library/sub-match-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [`sub_match`](../standard-library/sub-match-class.md) for iterators of type `string::const_iterator`. ## wcmatch Typedef @@ -129,7 +129,7 @@ typedef match_results wcmatch; ### Remarks -The type describes a specialization of class template [match_results](../standard-library/match-results-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [`match_results`](../standard-library/match-results-class.md) for iterators of type `const wchar_t*`. ## wcregex_iterator Typedef @@ -141,7 +141,7 @@ typedef regex_iterator wcregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator](../standard-library/regex-iterator-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [`regex_iterator`](../standard-library/regex-iterator-class.md) for iterators of type `const wchar_t*`. ## wcregex_token_iterator Typedef @@ -153,7 +153,7 @@ typedef regex_token_iterator wcregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator](../standard-library/regex-token-iterator-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [`regex_token_iterator`](../standard-library/regex-token-iterator-class.md) for iterators of type `const wchar_t*`. ## wcsub_match Typedef @@ -165,7 +165,7 @@ typedef sub_match wcsub_match; ### Remarks -The type describes a specialization of class template [sub_match](../standard-library/sub-match-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [`sub_match`](../standard-library/sub-match-class.md) for iterators of type `const wchar_t*`. ## wregex Typedef @@ -177,7 +177,7 @@ typedef basic_regex wregex; ### Remarks -The type describes a specialization of class template [basic_regex](../standard-library/basic-regex-class.md) for elements of type **`wchar_t`**. +The type describes a specialization of class template [`basic_regex`](../standard-library/basic-regex-class.md) for elements of type **`wchar_t`**. ## wsmatch Typedef @@ -189,7 +189,7 @@ typedef match_results wsmatch; ### Remarks -The type describes a specialization of class template [match_results](../standard-library/match-results-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [`match_results`](../standard-library/match-results-class.md) for iterators of type `wstring::const_iterator`. ## wsregex_iterator Typedef @@ -201,7 +201,7 @@ typedef regex_iterator wsregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator](../standard-library/regex-iterator-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [`regex_iterator`](../standard-library/regex-iterator-class.md) for iterators of type `wstring::const_iterator`. ## wsregex_token_iterator Typedef @@ -213,7 +213,7 @@ typedef regex_token_iterator wsregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator](../standard-library/regex-token-iterator-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [`regex_token_iterator`](../standard-library/regex-token-iterator-class.md) for iterators of type `wstring::const_iterator`. ## wssub_match Typedef @@ -225,7 +225,7 @@ typedef sub_match wssub_match; ### Remarks -The type describes a specialization of class template [sub_match](../standard-library/sub-match-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [`sub_match`](../standard-library/sub-match-class.md) for iterators of type `wstring::const_iterator`. ## See also diff --git a/docs/standard-library/string-operators.md b/docs/standard-library/string-operators.md index 54df3c74476..692a728f2da 100644 --- a/docs/standard-library/string-operators.md +++ b/docs/standard-library/string-operators.md @@ -89,7 +89,7 @@ The string that is the concatenation of the input strings. ### Remarks -The functions each overload `operator+` to concatenate two objects of class template [basic_string](../standard-library/basic-string-class.md). All effectively return `basic_string< CharType, Traits, Allocator>(Left).append(right)`. For more information, see [append](../standard-library/basic-string-class.md#append). +The functions each overload `operator+` to concatenate two objects of class template [`basic_string`](../standard-library/basic-string-class.md). All effectively return `basic_string< CharType, Traits, Allocator>(Left).append(right)`. For more information, see [append](../standard-library/basic-string-class.md#append). ### Example diff --git a/docs/standard-library/unordered-multimap-class.md b/docs/standard-library/unordered-multimap-class.md index a859f73d6b1..3aadde321fd 100644 --- a/docs/standard-library/unordered-multimap-class.md +++ b/docs/standard-library/unordered-multimap-class.md @@ -99,7 +99,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multimap::key_equal](#key_equal) and a hash function object of type [unordered_multimap::hasher](#hasher). You access the first stored object by calling the member function [unordered_multimap::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multimap::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [unordered_map](../standard-library/unordered-map-class.md), an object of type `unordered_multimap` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multimap::key_equal](#key_equal) and a hash function object of type [unordered_multimap::hasher](#hasher). You access the first stored object by calling the member function [unordered_multimap::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multimap::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_map`](../standard-library/unordered-map-class.md), an object of type `unordered_multimap` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [unordered_multimap::load_factor](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. diff --git a/docs/standard-library/unordered-multiset-class.md b/docs/standard-library/unordered-multiset-class.md index 5b1291e3f04..ea6d37a5c45 100644 --- a/docs/standard-library/unordered-multiset-class.md +++ b/docs/standard-library/unordered-multiset-class.md @@ -91,7 +91,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multiset::key_equal](#key_equal) and a hash function object of type [unordered_multiset::hasher](#hasher). You access the first stored object by calling the member function [unordered_multiset::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multiset::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [unordered_set](../standard-library/unordered-set-class.md), an object of type `unordered_multiset` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multiset::key_equal](#key_equal) and a hash function object of type [unordered_multiset::hasher](#hasher). You access the first stored object by calling the member function [unordered_multiset::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multiset::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_set`](../standard-library/unordered-set-class.md), an object of type `unordered_multiset` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [unordered_multiset::load_factor](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. From bcac7f6ff707dccbf7c1d481a8260b306d8be88a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 10 Jun 2025 00:13:07 +0800 Subject: [PATCH 0025/1799] Clean up metadata in a bunch of topics --- docs/atl-mfc-shared/basic-cstring-operations.md | 5 ++--- docs/standard-library/array-operators.md | 5 ++--- docs/standard-library/char-traits-char-struct.md | 5 ++--- docs/standard-library/cvt-wbuffer.md | 5 ++--- docs/standard-library/cvt-wstring.md | 5 ++--- docs/standard-library/regex-traits-class.md | 5 ++--- docs/standard-library/regex.md | 4 ++-- docs/standard-library/unordered-multimap-class.md | 3 +-- docs/standard-library/unordered-multiset-class.md | 3 +-- docs/standard-library/unordered-set-class.md | 2 +- 10 files changed, 17 insertions(+), 25 deletions(-) diff --git a/docs/atl-mfc-shared/basic-cstring-operations.md b/docs/atl-mfc-shared/basic-cstring-operations.md index 09ef0943cb3..047bd978b28 100644 --- a/docs/atl-mfc-shared/basic-cstring-operations.md +++ b/docs/atl-mfc-shared/basic-cstring-operations.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Basic CString Operations" title: "Basic CString Operations" -ms.date: "11/04/2016" +description: "Learn more about: Basic CString Operations" +ms.date: 11/04/2016 helpviewer_keywords: ["CString objects, basic operations", "string literals, CString operations", "literal strings, CString operations", "CString objects", "string comparison, CString operations", "characters, accessing in CStrings"] -ms.assetid: 41db66b2-9427-4bb3-845a-9b6869159a6c --- # Basic CString Operations diff --git a/docs/standard-library/array-operators.md b/docs/standard-library/array-operators.md index d80cd3fc35f..56925a09caa 100644 --- a/docs/standard-library/array-operators.md +++ b/docs/standard-library/array-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["array/std::array::operator!=", "array/std::array::operator<", "array/std::array::operator<=", "array/std::array::operator>", "array/std::array::operator>=", "array/std::array::operator=="] -ms.assetid: c8f46282-f179-4909-9a01-639cb8e18c27 --- # `` operators diff --git a/docs/standard-library/char-traits-char-struct.md b/docs/standard-library/char-traits-char-struct.md index be3056c88a3..fbdc3d0c807 100644 --- a/docs/standard-library/char-traits-char-struct.md +++ b/docs/standard-library/char-traits-char-struct.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: char_traits Struct" title: "char_traits Struct" -ms.date: "11/04/2016" +description: "Learn more about: char_traits Struct" +ms.date: 11/04/2016 f1_keywords: ["iosfwd/std::char_traits", "char_traits"] helpviewer_keywords: ["char_traits class"] -ms.assetid: abd9373a-77db-4031-bf4b-f8ac15087581 --- # `char_traits` Struct diff --git a/docs/standard-library/cvt-wbuffer.md b/docs/standard-library/cvt-wbuffer.md index 1c69902836f..09f8a4bcb6a 100644 --- a/docs/standard-library/cvt-wbuffer.md +++ b/docs/standard-library/cvt-wbuffer.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: ["stdext.cvt.", "stdext::cvt::", ""] helpviewer_keywords: ["cvt/wbuffer header"] -ms.assetid: 6e6eb44c-1bc4-4d8c-a4bd-b39c753ce725 --- # `` diff --git a/docs/standard-library/cvt-wstring.md b/docs/standard-library/cvt-wstring.md index 827402ca002..d8813833246 100644 --- a/docs/standard-library/cvt-wstring.md +++ b/docs/standard-library/cvt-wstring.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: ["stdext.cvt.", "", "stdext::cvt::"] helpviewer_keywords: ["cvt/wstring header"] -ms.assetid: d78b04bb-9ac0-4adb-8ffe-3aefb9b14c2d --- # `` diff --git a/docs/standard-library/regex-traits-class.md b/docs/standard-library/regex-traits-class.md index 1f93d3b2e7c..95fd141c40e 100644 --- a/docs/standard-library/regex-traits-class.md +++ b/docs/standard-library/regex-traits-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: regex_traits Class" title: "regex_traits Class" -ms.date: "09/10/2018" +description: "Learn more about: regex_traits Class" +ms.date: 09/10/2018 f1_keywords: ["regex/std::regex_traits", "regex/std::regex_traits::char_type", "regex/std::regex_traits::size_type", "regex/std::regex_traits::string_type", "regex/std::regex_traits::locale_type", "regex/std::regex_traits::char_class_type", "regex/std::regex_traits::length", "regex/std::regex_traits::translate", "regex/std::regex_traits::translate_nocase", "regex/std::regex_traits::transform", "regex/std::regex_traits::transform_primary", "regex/std::regex_traits::lookup_classname", "regex/std::regex_traits::lookup_collatename", "regex/std::regex_traits::isctype", "regex/std::regex_traits::value", "regex/std::regex_traits::imbue", "regex/std::regex_traits::getloc"] helpviewer_keywords: ["std::regex_traits [C++]", "std::regex_traits [C++], char_type", "std::regex_traits [C++], size_type", "std::regex_traits [C++], string_type", "std::regex_traits [C++], locale_type", "std::regex_traits [C++], char_class_type", "std::regex_traits [C++], length", "std::regex_traits [C++], translate", "std::regex_traits [C++], translate_nocase", "std::regex_traits [C++], transform", "std::regex_traits [C++], transform_primary", "std::regex_traits [C++], lookup_classname", "std::regex_traits [C++], lookup_collatename", "std::regex_traits [C++], isctype", "std::regex_traits [C++], value", "std::regex_traits [C++], imbue", "std::regex_traits [C++], getloc"] -ms.assetid: bc5a5eed-32fc-4eb7-913d-71c42e729e81 --- # regex_traits Class diff --git a/docs/standard-library/regex.md b/docs/standard-library/regex.md index a960dd6e94b..c3706ec5e02 100644 --- a/docs/standard-library/regex.md +++ b/docs/standard-library/regex.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["regex header"] --- diff --git a/docs/standard-library/unordered-multimap-class.md b/docs/standard-library/unordered-multimap-class.md index 3aadde321fd..aa702c0206b 100644 --- a/docs/standard-library/unordered-multimap-class.md +++ b/docs/standard-library/unordered-multimap-class.md @@ -1,13 +1,12 @@ --- title: "unordered_multimap Class" description: "API overview for the C++ Standard Library container class `unordered_multimap`." -ms.date: "9/9/2020" +ms.date: 9/9/2020 f1_keywords: ["unordered_map/std::unordered_multimap", "unordered_map/std::unordered_multimap::allocator_type", "unordered_map/std::unordered_multimap::const_iterator", "unordered_map/std::unordered_multimap::const_local_iterator", "unordered_map/std::unordered_multimap::const_pointer", "unordered_map/std::unordered_multimap::const_reference", "unordered_map/std::unordered_multimap::difference_type", "unordered_map/std::unordered_multimap::hasher", "unordered_map/std::unordered_multimap::iterator", "unordered_map/std::unordered_multimap::key_equal", "unordered_map/std::unordered_multimap::key_type", "unordered_map/std::unordered_multimap::local_iterator", "unordered_map/std::unordered_multimap::mapped_type", "unordered_map/std::unordered_multimap::pointer", "unordered_map/std::unordered_multimap::reference", "unordered_map/std::unordered_multimap::size_type", "unordered_map/std::unordered_multimap::value_type", "unordered_map/std::unordered_multimap::begin", "unordered_map/std::unordered_multimap::bucket", "unordered_map/std::unordered_multimap::bucket_count", "unordered_map/std::unordered_multimap::bucket_size", "unordered_map/std::unordered_multimap::cbegin", "unordered_map/std::unordered_multimap::cend", "unordered_map/std::unordered_multimap::clear", "unordered_map/std::unordered_multimap::contains", "unordered_map/std::unordered_multimap::count", "unordered_map/std::unordered_multimap::emplace", "unordered_map/std::unordered_multimap::emplace_hint", "unordered_map/std::unordered_multimap::empty", "unordered_map/std::unordered_multimap::end", "unordered_map/std::unordered_multimap::equal_range", "unordered_map/std::unordered_multimap::erase", "unordered_map/std::unordered_multimap::find", "unordered_map/std::unordered_multimap::get_allocator", "unordered_map/std::unordered_multimap::hash", "unordered_map/std::unordered_multimap::insert", "unordered_map/std::unordered_multimap::key_eq", "unordered_map/std::unordered_multimap::load_factor", "unordered_map/std::unordered_multimap::max_bucket_count", "unordered_map/std::unordered_multimap::max_load_factor", "unordered_map/std::unordered_multimap::max_size", "unordered_map/std::unordered_multimap::rehash", "unordered_map/std::unordered_multimap::size", "unordered_map/std::unordered_multimap::swap", "unordered_map/std::unordered_multimap::unordered_multimap", "unordered_map/std::unordered_multimap::operator=", "unordered_map/std::unordered_multimap::hash_function"] helpviewer_keywords: ["std::unordered_multimap", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", "std::unordered_multimap::contains", "std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap", "std::unordered_multimap::unordered_multimap", "std::unordered_multimap::operator=", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", "std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash_function", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap"] -ms.assetid: 4baead6c-5870-4b85-940f-a47d6b891c27 --- # unordered_multimap Class diff --git a/docs/standard-library/unordered-multiset-class.md b/docs/standard-library/unordered-multiset-class.md index ea6d37a5c45..711f79b9ed8 100644 --- a/docs/standard-library/unordered-multiset-class.md +++ b/docs/standard-library/unordered-multiset-class.md @@ -1,10 +1,9 @@ --- title: "unordered_multiset Class" description: "API reference for the C++ Standard Library container class `unordered_multiset`, which describes an object used for the storage and retrieval of data from a collection in which the values of the elements contained need not be unique and in which they serve as the key values. The data isn't automatically ordered." -ms.date: "9/10/2020" +ms.date: 9/10/2020 f1_keywords: ["unordered_set/std::unordered_multiset", "unordered_set/std::unordered_multiset::allocator_type", "unordered_set/std::unordered_multiset::const_iterator", "unordered_set/std::unordered_multiset::const_local_iterator", "unordered_set/std::unordered_multiset::const_pointer", "unordered_set/std::unordered_multiset::const_reference", "unordered_set/std::unordered_multiset::difference_type", "unordered_set/std::unordered_multiset::hasher", "unordered_set/std::unordered_multiset::iterator", "unordered_set/std::unordered_multiset::key_equal", "unordered_set/std::unordered_multiset::key_type", "unordered_set/std::unordered_multiset::local_iterator", "unordered_set/std::unordered_multiset::pointer", "unordered_set/std::unordered_multiset::reference", "unordered_set/std::unordered_multiset::size_type", "unordered_set/std::unordered_multiset::value_type", "unordered_set/std::unordered_multiset::begin", "unordered_set/std::unordered_multiset::bucket", "unordered_set/std::unordered_multiset::bucket_count", "unordered_set/std::unordered_multiset::bucket_size", "unordered_set/std::unordered_multiset::cbegin", "unordered_set/std::unordered_multiset::cend", "unordered_set/std::unordered_multiset::clear", "unordered_set/std::unordered_multiset::contains", "unordered_set/std::unordered_multiset::count", "unordered_set/std::unordered_multiset::emplace", "unordered_set/std::unordered_multiset::emplace_hint", "unordered_set/std::unordered_multiset::empty", "unordered_set/std::unordered_multiset::end", "unordered_set/std::unordered_multiset::equal_range", "unordered_set/std::unordered_multiset::erase", "unordered_set/std::unordered_multiset::find", "unordered_set/std::unordered_multiset::get_allocator", "unordered_set/std::unordered_multiset::hash", "unordered_set/std::unordered_multiset::insert", "unordered_set/std::unordered_multiset::key_eq", "unordered_set/std::unordered_multiset::load_factor", "unordered_set/std::unordered_multiset::max_bucket_count", "unordered_set/std::unordered_multiset::max_load_factor", "unordered_set/std::unordered_multiset::max_size", "unordered_set/std::unordered_multiset::rehash", "unordered_set/std::unordered_multiset::size", "unordered_set/std::unordered_multiset::swap", "unordered_set/std::unordered_multiset::unordered_multiset", "unordered_set/std::unordered_multiset::operator=", "unordered_set/std::unordered_multiset::hash_function"] helpviewer_keywords: ["std::unordered_multiset", "std::unordered_multiset::allocator_type", "std::unordered_multiset::const_iterator", "std::unordered_multiset::const_local_iterator", "std::unordered_multiset::const_pointer", "std::unordered_multiset::const_reference", "std::unordered_multiset::difference_type", "std::unordered_multiset::hasher", "std::unordered_multiset::iterator", "std::unordered_multiset::key_equal", "std::unordered_multiset::key_type", "std::unordered_multiset::local_iterator", "std::unordered_multiset::pointer", "std::unordered_multiset::reference", "std::unordered_multiset::size_type", "std::unordered_multiset::value_type", "std::unordered_multiset::begin", "std::unordered_multiset::bucket", "std::unordered_multiset::bucket_count", "std::unordered_multiset::bucket_size", "std::unordered_multiset::cbegin", "std::unordered_multiset::cend", "std::unordered_multiset::clear", "std::unordered_multiset::contains", "std::unordered_multiset::count", "std::unordered_multiset::emplace", "std::unordered_multiset::emplace_hint", "std::unordered_multiset::empty", "std::unordered_multiset::end", "std::unordered_multiset::equal_range", "std::unordered_multiset::erase", "std::unordered_multiset::find", "std::unordered_multiset::get_allocator", "std::unordered_multiset::hash", "std::unordered_multiset::insert", "std::unordered_multiset::key_eq", "std::unordered_multiset::load_factor", "std::unordered_multiset::max_bucket_count", "std::unordered_multiset::max_load_factor", "std::unordered_multiset::max_size", "std::unordered_multiset::rehash", "std::unordered_multiset::size", "std::unordered_multiset::swap", "std::unordered_multiset::unordered_multiset", "std::unordered_multiset::operator=", "std::unordered_multiset::allocator_type", "std::unordered_multiset::const_iterator", "std::unordered_multiset::const_local_iterator", "std::unordered_multiset::const_pointer", "std::unordered_multiset::const_reference", "std::unordered_multiset::difference_type", "std::unordered_multiset::hasher", "std::unordered_multiset::iterator", "std::unordered_multiset::key_equal", "std::unordered_multiset::key_type", "std::unordered_multiset::local_iterator", "std::unordered_multiset::pointer", "std::unordered_multiset::reference", "std::unordered_multiset::size_type", "std::unordered_multiset::value_type", "std::unordered_multiset::begin", "std::unordered_multiset::bucket", "std::unordered_multiset::bucket_count", "std::unordered_multiset::bucket_size", "std::unordered_multiset::cbegin", "std::unordered_multiset::cend", "std::unordered_multiset::clear", "std::unordered_multiset::count", "std::unordered_multiset::emplace", "std::unordered_multiset::emplace_hint", "std::unordered_multiset::empty", "std::unordered_multiset::end", "std::unordered_multiset::equal_range", "std::unordered_multiset::erase", "std::unordered_multiset::find", "std::unordered_multiset::get_allocator", "std::unordered_multiset::hash_function", "std::unordered_multiset::insert", "std::unordered_multiset::key_eq", "std::unordered_multiset::load_factor", "std::unordered_multiset::max_bucket_count", "std::unordered_multiset::max_load_factor", "std::unordered_multiset::max_size", "std::unordered_multiset::rehash", "std::unordered_multiset::size", "std::unordered_multiset::swap"] -ms.assetid: 70c8dfc5-492a-4af2-84f5-1aa9cb04b71c --- # unordered_multiset Class diff --git a/docs/standard-library/unordered-set-class.md b/docs/standard-library/unordered-set-class.md index 0380b0d4cc2..1085adc704c 100644 --- a/docs/standard-library/unordered-set-class.md +++ b/docs/standard-library/unordered-set-class.md @@ -1,7 +1,7 @@ --- title: "unordered_set Class" description: "API reference for the C++ Standard Library container class `unordered_set`, which is used to store and retrieve data from an unordered collection." -ms.date: "9/9/2020" +ms.date: 9/9/2020 f1_keywords: ["unordered_set/std::unordered_set", "unordered_set/std::unordered_set::allocator_type", "unordered_set/std::unordered_set::const_iterator", "unordered_set/std::unordered_set::const_local_iterator", "unordered_set/std::unordered_set::const_pointer", "unordered_set/std::unordered_set::const_reference", "unordered_set/std::unordered_set::difference_type", "unordered_set/std::unordered_set::hasher", "unordered_set/std::unordered_set::iterator", "unordered_set/std::unordered_set::key_equal", "unordered_set/std::unordered_set::key_type", "unordered_set/std::unordered_set::local_iterator", "unordered_set/std::unordered_set::pointer", "unordered_set/std::unordered_set::reference", "unordered_set/std::unordered_set::size_type", "unordered_set/std::unordered_set::value_type", "unordered_set/std::unordered_set::begin", "unordered_set/std::unordered_set::bucket", "unordered_set/std::unordered_set::bucket_count", "unordered_set/std::unordered_set::bucket_size", "unordered_set/std::unordered_set::cbegin", "unordered_set/std::unordered_set::cend", "unordered_set/std::unordered_set::clear", "unordered_set/std::unordered_set::count", "unordered_set/std::unordered_set::contains", "unordered_set/std::unordered_set::emplace", "unordered_set/std::unordered_set::emplace_hint", "unordered_set/std::unordered_set::empty", "unordered_set/std::unordered_set::end", "unordered_set/std::unordered_set::equal_range", "unordered_set/std::unordered_set::erase", "unordered_set/std::unordered_set::find", "unordered_set/std::unordered_set::get_allocator", "unordered_set/std::unordered_set::hash", "unordered_set/std::unordered_set::insert", "unordered_set/std::unordered_set::key_eq", "unordered_set/std::unordered_set::load_factor", "unordered_set/std::unordered_set::max_bucket_count", "unordered_set/std::unordered_set::max_load_factor", "unordered_set/std::unordered_set::max_size", "unordered_set/std::unordered_set::rehash", "unordered_set/std::unordered_set::size", "unordered_set/std::unordered_set::swap", "unordered_set/std::unordered_set::unordered_set", "unordered_set/std::unordered_set::operator=", "unordered_set/std::unordered_set::hash_function"] helpviewer_keywords: ["std::unordered_set", "std::unordered_set::allocator_type", "std::unordered_set::const_iterator", "std::unordered_set::const_local_iterator", "std::unordered_set::const_pointer", "std::unordered_set::const_reference", "std::unordered_set::difference_type", "std::unordered_set::hasher", "std::unordered_set::iterator", "std::unordered_set::key_equal", "std::unordered_set::key_type", "std::unordered_set::local_iterator", "std::unordered_set::pointer", "std::unordered_set::reference", "std::unordered_set::size_type", "std::unordered_set::value_type", "std::unordered_set::begin", "std::unordered_set::bucket", "std::unordered_set::bucket_count", "std::unordered_set::bucket_size", "std::unordered_set::cbegin", "std::unordered_set::cend", "std::unordered_set::clear", "std::unordered_set::contains", "std::unordered_set::count", "std::unordered_set::emplace", "std::unordered_set::emplace_hint", "std::unordered_set::empty", "std::unordered_set::end", "std::unordered_set::equal_range", "std::unordered_set::erase", "std::unordered_set::find", "std::unordered_set::get_allocator", "std::unordered_set::hash", "std::unordered_set::insert", "std::unordered_set::key_eq", "std::unordered_set::load_factor", "std::unordered_set::max_bucket_count", "std::unordered_set::max_load_factor", "std::unordered_set::max_size", "std::unordered_set::rehash", "std::unordered_set::size", "std::unordered_set::swap", "std::unordered_set::unordered_set", "std::unordered_set::operator=", "std::unordered_set::allocator_type", "std::unordered_set::const_iterator", "std::unordered_set::const_local_iterator", "std::unordered_set::const_pointer", "std::unordered_set::const_reference", "std::unordered_set::difference_type", "std::unordered_set::hasher", "std::unordered_set::iterator", "std::unordered_set::key_equal", "std::unordered_set::key_type", "std::unordered_set::local_iterator", "std::unordered_set::pointer", "std::unordered_set::reference", "std::unordered_set::size_type", "std::unordered_set::value_type", "std::unordered_set::begin", "std::unordered_set::bucket", "std::unordered_set::bucket_count", "std::unordered_set::bucket_size", "std::unordered_set::cbegin", "std::unordered_set::cend", "std::unordered_set::clear", "std::unordered_set::count", "std::unordered_set::emplace", "std::unordered_set::emplace_hint", "std::unordered_set::empty", "std::unordered_set::end", "std::unordered_set::equal_range", "std::unordered_set::erase", "std::unordered_set::find", "std::unordered_set::get_allocator", "std::unordered_set::hash_function", "std::unordered_set::insert", "std::unordered_set::key_eq", "std::unordered_set::load_factor", "std::unordered_set::max_bucket_count", "std::unordered_set::max_load_factor", "std::unordered_set::max_size", "std::unordered_set::rehash", "std::unordered_set::size", "std::unordered_set::swap"] --- From 935e53c808a8256e339b9470e36d42d6a4a459d8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 10 Jun 2025 00:21:33 +0800 Subject: [PATCH 0026/1799] Add missing `back` description in member functions table of `basic_string` --- docs/standard-library/basic-string-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index f47eee5d90e..554d5ba8d81 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -61,7 +61,7 @@ The type that represents the stored allocator object that encapsulates details a |[`append`](#append)|Adds characters to the end of a string.| |[`assign`](#assign)|Assigns new character values to the contents of a string.| |[`at`](#at)|Returns a reference to the element at a specified location in the string.| -|[`back`](#back)|| +|[`back`](#back)|Returns a reference to the last element in the string.| |[`begin`](#begin)|Returns an iterator addressing the first element in the string.| |[`c_str`](#c_str)|Converts the contents of a string as a C-style, null-terminated, string.| |[`capacity`](#capacity)|Returns the largest number of elements that could be stored in a string without increasing the memory allocation of the string.| From 10792989b6f0285c899e4019b7e8e511029f6531 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 10 Jun 2025 00:39:58 +0800 Subject: [PATCH 0027/1799] Replace absolute "It's only temporary" archive link with a relative one --- docs/c-runtime-library/reference/fopen-s-wfopen-s.md | 2 +- docs/c-runtime-library/reference/fopen-wfopen.md | 2 +- docs/c-runtime-library/reference/fsopen-wfsopen.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/c-runtime-library/reference/fopen-s-wfopen-s.md b/docs/c-runtime-library/reference/fopen-s-wfopen-s.md index 1dd8534816d..6964db2b65f 100644 --- a/docs/c-runtime-library/reference/fopen-s-wfopen-s.md +++ b/docs/c-runtime-library/reference/fopen-s-wfopen-s.md @@ -167,7 +167,7 @@ The **`c`**, **`n`**, **`R`**, **`S`**, **`t`**, **`T`**, and **`D`** *`mode`* o If you're using **`rb`** mode, memory mapped Win32 files might also be an option if you don't need to port your code, you expect to read much of the file, or you don't care about network performance. Regarding `T` and `D`: -- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](https://learn.microsoft.com/archive/blogs/larryosterman/its-only-temporary). +- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](/archive/blogs/larryosterman/its-only-temporary). - `D` specifies a regular file that is written to disk. The difference is that it's automatically deleted when it's closed. You can combine `TD` to get both semantics. diff --git a/docs/c-runtime-library/reference/fopen-wfopen.md b/docs/c-runtime-library/reference/fopen-wfopen.md index e90d1006b12..22d44f24215 100644 --- a/docs/c-runtime-library/reference/fopen-wfopen.md +++ b/docs/c-runtime-library/reference/fopen-wfopen.md @@ -158,7 +158,7 @@ Valid characters for the *`mode`* string that is used in **`fopen`** and **`_fdo If you're using **`rb`** mode, you don't have to port your code, and if you expect to read most of a large file or aren't concerned about network performance, you might also consider whether to use memory mapped Win32 files as an option. Regarding `T` and `D`: -- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](https://learn.microsoft.com/archive/blogs/larryosterman/its-only-temporary). +- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](/archive/blogs/larryosterman/its-only-temporary). - `D` specifies a regular file that is written to disk. The difference is that it's automatically deleted when it's closed. You can combine `TD` to get both semantics. diff --git a/docs/c-runtime-library/reference/fsopen-wfsopen.md b/docs/c-runtime-library/reference/fsopen-wfsopen.md index 8f558b4defe..5f2c003e22a 100644 --- a/docs/c-runtime-library/reference/fsopen-wfsopen.md +++ b/docs/c-runtime-library/reference/fsopen-wfsopen.md @@ -76,7 +76,7 @@ When a file is opened with the **"`a`"** or **"`a+`"** access type, all write op If **`t`** or **`b`** isn't given in *`mode`*, the translation mode is defined by the default-mode variable **`_fmode`**. If **`t`** or **`b`** is prefixed to the argument, the function fails and returns `NULL`. For a discussion of text and binary modes, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md). Regarding `T` and `D`: -- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](https://learn.microsoft.com/archive/blogs/larryosterman/its-only-temporary). +- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](/archive/blogs/larryosterman/its-only-temporary). - `D` specifies a regular file that is written to disk. The difference is that it's automatically deleted when it's closed. You can combine `TD` to get both semantics. From e27aa7eb9df996357363f66e702fde362b502883 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 10 Jun 2025 23:09:01 +0800 Subject: [PATCH 0028/1799] Remove backslash in backticked terms --- docs/mfc/reference/cwinapp-class.md | 4 ++-- docs/parallel/amp/graphics-cpp-amp.md | 2 +- docs/standard-library/basic-istream-class.md | 4 ++-- docs/standard-library/ctype-char-class.md | 2 +- docs/standard-library/hash-map-class.md | 2 +- docs/standard-library/regex.md | 2 +- docs/standard-library/scoped-allocator-adaptor-class.md | 4 ++-- docs/standard-library/string-view.md | 2 +- 8 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/mfc/reference/cwinapp-class.md b/docs/mfc/reference/cwinapp-class.md index a3ac6a19528..ac07d50b58a 100644 --- a/docs/mfc/reference/cwinapp-class.md +++ b/docs/mfc/reference/cwinapp-class.md @@ -961,7 +961,7 @@ HCURSOR LoadOEMCursor(UINT nIDCursor) const; ### Parameters *nIDCursor*
-An **OCR_** manifest constant identifier that specifies a predefined Windows cursor. You must have `#define OEMRESOURCE` before `#include \` to gain access to the **OCR_** constants in WINDOWS.H. +An **OCR_** manifest constant identifier that specifies a predefined Windows cursor. You must have `#define OEMRESOURCE` before `#include ` to gain access to the **OCR_** constants in WINDOWS.H. ### Return Value @@ -988,7 +988,7 @@ HICON LoadOEMIcon(UINT nIDIcon) const; ### Parameters *nIDIcon*
-An **OIC_** manifest constant identifier that specifies a predefined Windows icon. You must have `#define OEMRESOURCE` before `#include \` to access the **OIC_** constants in WINDOWS.H. +An **OIC_** manifest constant identifier that specifies a predefined Windows icon. You must have `#define OEMRESOURCE` before `#include ` to access the **OIC_** constants in WINDOWS.H. ### Return Value diff --git a/docs/parallel/amp/graphics-cpp-amp.md b/docs/parallel/amp/graphics-cpp-amp.md index 745744c100f..09902da2e3c 100644 --- a/docs/parallel/amp/graphics-cpp-amp.md +++ b/docs/parallel/amp/graphics-cpp-amp.md @@ -139,7 +139,7 @@ There are limits on the size of each dimension of the `texture` object, as shown ### Reading from Texture Objects -You can read from a `texture` object by using [texture::operator\[\]](reference/texture-class.md#operator_at), [texture::operator() Operator](reference/texture-class.md#operator_call), or [texture::get Method](reference/texture-class.md#get). The two operators return a value, not a reference. Therefore, you cannot write to a `texture` object by using `texture::operator\[\]`. +You can read from a `texture` object by using [texture::operator\[\]](reference/texture-class.md#operator_at), [texture::operator() Operator](reference/texture-class.md#operator_call), or [texture::get Method](reference/texture-class.md#get). The two operators return a value, not a reference. Therefore, you cannot write to a `texture` object by using `texture::operator[]`. ```cpp void readTexture() { diff --git a/docs/standard-library/basic-istream-class.md b/docs/standard-library/basic-istream-class.md index f67eaa3dbfa..0fc2faac05a 100644 --- a/docs/standard-library/basic-istream-class.md +++ b/docs/standard-library/basic-istream-class.md @@ -410,7 +410,7 @@ Type 'abcdef': abcdef def ``` -## `basic\_istream::operator>>` +## `basic_istream::operator>>` Calls a function on the input stream or reads formatted data from the input stream. @@ -451,7 +451,7 @@ The stream (`*this`). ### Remarks -The `` header also defines several global extraction operators. For more information, see [`operator>> (\)`](../standard-library/istream-operators.md#op_gt_gt). +The `` header also defines several global extraction operators. For more information, see [`operator>> ()`](../standard-library/istream-operators.md#op_gt_gt). The first member function ensures that an expression of the form `istr >> ws` calls `ws(istr)`, and then returns `*this`. For more information, see [`ws`](../standard-library/istream-functions.md#ws). diff --git a/docs/standard-library/ctype-char-class.md b/docs/standard-library/ctype-char-class.md index 32beff1c351..02c74afc880 100644 --- a/docs/standard-library/ctype-char-class.md +++ b/docs/standard-library/ctype-char-class.md @@ -8,7 +8,7 @@ ms.assetid: ee30acb4-a743-405e-b3d4-13602092da84 --- # `ctype` Class -The class is an explicit specialization of class template `ctype\` to type **`char`**, describing an object that can serve as a locale facet to characterize various properties of a character of type **`char`**. +The class is an explicit specialization of class template `ctype` to type **`char`**, describing an object that can serve as a locale facet to characterize various properties of a character of type **`char`**. ## Syntax diff --git a/docs/standard-library/hash-map-class.md b/docs/standard-library/hash-map-class.md index e7c5593ba01..6185f281559 100644 --- a/docs/standard-library/hash-map-class.md +++ b/docs/standard-library/hash-map-class.md @@ -1526,7 +1526,7 @@ The position just beyond the last element to be copied from a `hash_map`. The first `insert` member function returns a pair whose `bool` component returns `true` if an insertion was made and `false` if the `hash_map` already contained an element whose key had an equivalent value in the ordering, and whose iterator component returns the address where a new element was inserted or where the element was already located. -To access the iterator component of a pair `pr` returned by this member function, use `pr.first`, and to dereference it, use `(pr.first)`. To access the **`bool`** component of a pair `pr` returned by this member function, use `pr.second`, and to dereference it, use `\(pr.second)`. +To access the iterator component of a pair `pr` returned by this member function, use `pr.first`, and to dereference it, use `(pr.first)`. To access the **`bool`** component of a pair `pr` returned by this member function, use `pr.second`, and to dereference it, use `(pr.second)`. The second `insert` member function, the hint version, returns an iterator that points to the position where the new element was inserted into the `hash_map`. diff --git a/docs/standard-library/regex.md b/docs/standard-library/regex.md index 290bf331a60..d1c9e917744 100644 --- a/docs/standard-library/regex.md +++ b/docs/standard-library/regex.md @@ -81,7 +81,7 @@ To modify the details of the grammar of regular expressions, write a class that |[`operator==`](../standard-library/regex-operators.md#op_eq_eq)|Comparison of various objects, equal.| |[`operator!=`](../standard-library/regex-operators.md#op_neq)|Comparison of various objects, not equal.| |[`operator<`](../standard-library/regex-operators.md#op_lt)|Comparison of various objects, less than.| -|[`operator\<=`](../standard-library/regex-operators.md#op_gt_eq)|Comparison of various objects, less than or equal.| +|[`operator<=`](../standard-library/regex-operators.md#op_gt_eq)|Comparison of various objects, less than or equal.| |[`operator>`](../standard-library/regex-operators.md#op_gt)|Comparison of various objects, greater than.| |[`operator>=`](../standard-library/regex-operators.md#op_gt_eq)|Comparison of various objects, greater than or equal.| |[`operator<<`](../standard-library/regex-operators.md#op_lt_lt)|Inserts a `sub_match` in a stream.| diff --git a/docs/standard-library/scoped-allocator-adaptor-class.md b/docs/standard-library/scoped-allocator-adaptor-class.md index c937950a65f..b2b7ae1f198 100644 --- a/docs/standard-library/scoped-allocator-adaptor-class.md +++ b/docs/standard-library/scoped-allocator-adaptor-class.md @@ -67,7 +67,7 @@ Three types are defined for the sake of exposition: |Name|Description| |----------|-----------------| -|[scoped_allocator_adaptor::rebind Struct](#rebind_struct)|Defines the type `Outer::rebind\::other` as a synonym for `scoped_allocator_adaptor\`.| +|[scoped_allocator_adaptor::rebind Struct](#rebind_struct)|Defines the type `Outer::rebind::other` as a synonym for `scoped_allocator_adaptor`.| ### Methods @@ -277,7 +277,7 @@ A reference to the stored object of type `outer_allocator_type`. ## scoped_allocator_adaptor::rebind Struct -Defines the type `Outer::rebind\::other` as a synonym for `scoped_allocator_adaptor\`. +Defines the type `Outer::rebind::other` as a synonym for `scoped_allocator_adaptor`. struct rebind{ typedef Other_traits::rebind\ diff --git a/docs/standard-library/string-view.md b/docs/standard-library/string-view.md index 48ef23cc2a2..6684b07a192 100644 --- a/docs/standard-library/string-view.md +++ b/docs/standard-library/string-view.md @@ -37,7 +37,7 @@ The `` operators can compare `string_view` objects to objects of an |[`operator==`](../standard-library/string-view-operators.md#op_eq_eq)|Tests if the object on the left side of the operator is equal to the object on the right side.| |[`operator<`](../standard-library/string-view-operators.md#op_lt)|Tests if the object on the left side of the operator is less than to the object on the right side.| |[`operator<=`](../standard-library/string-view-operators.md#op_lt_eq)|Tests if the object on the left side of the operator is less than or equal to the object on the right side.| -|[`operator<\<`](../standard-library/string-view-operators.md#op_lt_lt)|A template function that inserts a `string_view` into an output stream.| +|[`operator<<`](../standard-library/string-view-operators.md#op_lt_lt)|A template function that inserts a `string_view` into an output stream.| |[`operator>`](../standard-library/string-view-operators.md#op_gt)|Tests if the object on the left side of the operator is greater than to the object on the right side.| |[`operator>=`](../standard-library/string-view-operators.md#op_gt_eq)|Tests if the object on the left side of the operator is greater than or equal to the object on the right side.| From 2f989da0eb8351632bcde2ad4fc4d7f42660f26e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 10 Jun 2025 23:12:22 +0800 Subject: [PATCH 0029/1799] Clean up metadata in a couple of topics --- docs/parallel/amp/graphics-cpp-amp.md | 4 ++-- docs/standard-library/basic-istream-class.md | 2 +- docs/standard-library/ctype-char-class.md | 5 ++--- docs/standard-library/string-view.md | 2 +- 4 files changed, 6 insertions(+), 7 deletions(-) diff --git a/docs/parallel/amp/graphics-cpp-amp.md b/docs/parallel/amp/graphics-cpp-amp.md index 09902da2e3c..2de8ab623c9 100644 --- a/docs/parallel/amp/graphics-cpp-amp.md +++ b/docs/parallel/amp/graphics-cpp-amp.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Graphics (C++ AMP)" title: "Graphics (C++ AMP)" -ms.date: "11/04/2016" +description: "Learn more about: Graphics (C++ AMP)" +ms.date: 11/04/2016 --- # Graphics (C++ AMP) diff --git a/docs/standard-library/basic-istream-class.md b/docs/standard-library/basic-istream-class.md index 0fc2faac05a..a5ebefeccee 100644 --- a/docs/standard-library/basic-istream-class.md +++ b/docs/standard-library/basic-istream-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: basic_istream Class" title: "basic_istream Class" +description: "Learn more about: basic_istream Class" ms.date: 06/10/2022 f1_keywords: ["istream/std::basic_istream", "istream/std::basic_istream::gcount", "istream/std::basic_istream::get", "istream/std::basic_istream::getline", "istream/std::basic_istream::", "istream/std::basic_istream::peek", "istream/std::basic_istream::putback", "istream/std::basic_istream::read", "istream/std::basic_istream::readsome", "istream/std::basic_istream::seekg", "istream/std::basic_istream::sentry", "istream/std::basic_istream::swap", "istream/std::basic_istream::sync", "istream/std::basic_istream::tellg", "istream/std::basic_istream::unget"] helpviewer_keywords: ["std::basic_istream [C++]", "std::basic_istream [C++], gcount", "std::basic_istream [C++], get", "std::basic_istream [C++], getline", "std::basic_istream [C++], OVERWRITE", "std::basic_istream [C++], peek", "std::basic_istream [C++], putback", "std::basic_istream [C++], read", "std::basic_istream [C++], readsome", "std::basic_istream [C++], seekg", "std::basic_istream [C++], sentry", "std::basic_istream [C++], swap", "std::basic_istream [C++], sync", "std::basic_istream [C++], tellg", "std::basic_istream [C++], unget"] diff --git a/docs/standard-library/ctype-char-class.md b/docs/standard-library/ctype-char-class.md index 02c74afc880..d56cfcc8119 100644 --- a/docs/standard-library/ctype-char-class.md +++ b/docs/standard-library/ctype-char-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ctype Class" title: "ctype Class" -ms.date: "11/04/2016" +description: "Learn more about: ctype Class" +ms.date: 11/04/2016 f1_keywords: ["ctype", "locale/std::ctype"] helpviewer_keywords: ["ctype class"] -ms.assetid: ee30acb4-a743-405e-b3d4-13602092da84 --- # `ctype` Class diff --git a/docs/standard-library/string-view.md b/docs/standard-library/string-view.md index 6684b07a192..7582ab417c5 100644 --- a/docs/standard-library/string-view.md +++ b/docs/standard-library/string-view.md @@ -1,7 +1,7 @@ --- title: "" description: "Overview of `basic_string_view`, which refers to a constant contiguous sequence of char-like objects." -ms.date: "9/4/2020" +ms.date: 9/4/2020 helpviewer_keywords: ["string_view header"] --- # `` From 4456ac0e4d30de3e463d5c5a1660b695dbad95b4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 10 Jun 2025 23:40:37 +0800 Subject: [PATCH 0030/1799] Remove empty lines in metadata --- docs/data/oledb/schema-rowset-classes-and-typedef-classes.md | 2 -- docs/standard-library/bitset-class.md | 1 - docs/standard-library/treat-as-floating-point-structure.md | 1 - 3 files changed, 4 deletions(-) diff --git a/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md b/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md index 574d95b2ac2..2739c1b09d8 100644 --- a/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md +++ b/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md @@ -3,8 +3,6 @@ description: "Learn more about: Schema Rowset Classes and Typedef Classes" title: "Schema Rowset Classes and Typedef Classes" ms.date: "11/04/2016" f1_keywords: ["CAssertionInfo", "CAssertions", "CCatalogInfo", "CCatalogs", "CCharacterSetInfo", "CCharacterSets", "CCheckConstraintInfo", "CCheckConstraints", "CCollationInfo", "CCollations", "CColumnDomainUsage", "CColumnDomainUsageInfo", "CColumnPrivilegeInfo", "CColumnPrivileges", "CColumns", "CColumnsInfo", "CConstraintColumnUsage", "CConstraintColumnUsageInfo", "CConstraintTableUsage", "CConstraintTableUsageInfo", "CForeignKeys", "CForeignKeysInfo", "CHARACTER_MAXIMUM_LENGTH", "CHARACTER_OCTET_LENGTH", "CHARACTER_SET_CATALOG", "CHARACTER_SET_NAME", "CHARACTER_SET_SCHEMA", "CHECK_CLAUSE", "CHECK_CONSTRAINTS", "CHECK_OPTION", "CIndexes", "CIndexInfo", "CKeyColumnInfo", "CKeyColumns", "CLUSTERED", "COLLATION", "COLLATION_CATALOG", "COLLATION_NAME", "COLLATION_SCHEMA", "COLLATIONS", "COLUMN_DEFAULT", "COLUMN_DOMAIN_USAGE", "COLUMN_FLAGS", "COLUMN_GUID", "COLUMN_HASDEFAULT", "COLUMN_PRIVILEGES", "COLUMN_PROPID", "COLUMN_SIZE", "CONSTRAINT_CATALOG", "CONSTRAINT_COLUMN_USAGE", "CONSTRAINT_NAME", "CONSTRAINT_SCHEMA", "CONSTRAINT_TABLE_USAGE", "CONSTRAINT_TYPE", "CPrimaryKeyInfo", "CPrimaryKeys", "CProcedureColumnInfo", "CProcedureColumns", "CProcedureInfo", "CProcedureParameters", "CProcedureParamInfo", "CProcedures", "CProviderInfo", "CProviderTypes", "CReferentialConstraintInfo", "CReferentialConstraints", "CSchemata", "CSchemataInfo", "CSQLLanguageInfo", "CSQLLanguages", "CStatisticInfo", "CStatistics", "CTableConstraintInfo", "CTableConstraints", "CTableInfo", "CTablePrivilegeInfo", "CTablePrivileges", "CTables", "CTranslationInfo", "CTranslations", "CUsagePrivilegeInfo", "CUsagePrivileges", "CViewColumnInfo", "CViewColumnUsage", "CViewInfo", "CViews", "CViewTableInfo", "CViewTableUsage", "DATA_TYPE", "DATETIME_PRECISION", "DEFAULT_CHARACTER_SET_CATALOG", "DEFAULT_CHARACTER_SET_NAME", "DEFAULT_CHARACTER_SET_SCHEMA", "DEFAULT_COLLATE_CATALOG", "DEFAULT_COLLATE_NAME", "DEFAULT_COLLATE_SCHEMA", "DELETE_RULE", "DOMAIN_CATALOG", "DOMAIN_NAME", "DOMAIN_SCHEMA", "FILL_FACTOR", "FILTER_CONDITION", "FIXED_PREC_SCALE", "FK_COLUMN_GUID", "FK_COLUMN_NAME", "FK_COLUMN_PROPID", "FK_TABLE_CATALOG", "FK_TABLE_NAME", "FK_TABLE_SCHEMA", "FORM_OF_USE", "GRANTEE", "GRANTOR", "INDEX_CATALOG", "INDEX_NAME", "INDEX_SCHEMA", "INITIAL_SIZE", "INITIALLY_DEFERRED", "IS_DEFERRABLE", "IS_GRANTABLE", "IS_LONG", "IS_NULLABLE", "IS_UPDATABLE", "LITERAL_SUFFIX", "LOCAL_TYPE_NAME", "m_bAutoUniqueValue", "m_bAutoUpdate", "m_bBestMatch", "m_bCaseSensitive", "m_bCheckOption", "m_bClustered", "m_bColumnHasDefault", "m_bFixedPrecScale", "m_bHasDefault", "m_bInitiallyDeferred", "m_bIsDeferrable", "m_bIsGrantable", "m_bIsLong", "m_bIsNullable", "m_bIsUpdatable", "m_bPrimaryKey", "m_bSortBookmarks", "m_bUnique", "m_bUnsignedAttribute", "m_guidColumn", "m_guidFKColumn", "m_guidPKColumn", "m_guidTable", "m_guidType", "m_nCardinality", "m_nCollation", "m_nColumnFlags", "m_nColumnPropID", "m_nColumnSize", "m_nDataType", "m_nDateTimePrecision", "m_nFillFactor", "m_nFKColumnPropID", "m_nInitialSize", "m_nMaxLength", "m_nMaxScale", "m_nNullCollation", "m_nNulls", "m_nNumCharacters", "m_nNumericPrecision", "m_nNumericScale", "m_nOctetLength", "m_nOrdinal", "m_nOrdinalPosition", "m_nPages", "m_nPKColumnPropID", "m_nPrecision", "m_nRowsetNumber", "m_nScale", "m_nSearchable", "m_szBindingStyle", "m_szCatalog", "m_szCharCatalog", "m_szCharName", "m_szCharSchema", "m_szCharSetCatalog", "m_szCharSetName", "m_szCharSetSchema", "m_szCheckClause", "m_szCollateCatalog", "m_szCollateName", "m_szCollateSchema", "m_szCollationCatalog", "m_szCollationName", "m_szCollationSchema", "m_szColumnDefault", "m_szColumnName", "m_szConformance", "m_szConstraintCatalog", "m_szConstraintName", "m_szConstraintSchema", "m_szCreateParams", "m_szDefault", "m_szDefinition", "m_szDeleteRule", "m_szDomainCatalog", "m_szDomainName", "m_szDomainSchema", "m_szFilterCondition", "m_szFKColumnName", "m_szFKTableCatalog", "m_szFKTableName", "m_szFKTableSchema", "m_szFormOfUse", "m_szGrantee", "m_szGrantor", "m_szImplementation", "m_szIndexCatalog", "m_szIndexName", "m_szIndexSchema", "m_szIntegrity", "m_szLiter alSuffix", "m_szLiteralPrefix", "m_szLocalTypeName", "m_szMatchOption", "m_szObjectCatalog", "m_szObjectName", "m_szObjectSchema", "m_szObjectType", "m_szOwner", "m_szPadAttribute", "m_szParameterName", "m_szPKColumnName", "m_szPKTableCatalog", "m_szPKTableName", "m_szPKTableSchema", "m_szPrivilegeType", "m_szProgrammingLanguage", "m_szSchema", "m_szSource", "m_szSourceCatalog", "m_szSourceName", "m_szSourceSchema", "m_szTableCatalog", "m_szTableName", "m_szTableSchema", "m_szTargetCatalog", "m_szTargetName", "m_szTargetSchema", "m_szType", "m_szTypeLib", "m_szTypeName", "m_szUniqueCatalog", "m_szUniqueName", "m_szUniqueSchema", "m_szUpdateRule", "m_szVersion", "m_szYear", "MATCH_OPTION", "MAXIMUM_SCALE", "MINIMUM_SCALE", "NULL_COLLATION", "NULLS", "NUMBER_OF_CHARACTERS", "NUMERIC_PRECISION", "NUMERIC_SCALE", "OBJECT_CATALOG", "OBJECT_NAME", "OBJECT_SCHEMA", "OBJECT_TYPE", "ORDINAL", "ORDINAL_POSITION", "TABLE_CATALOG", "TABLE_GUID", "TABLE_NAME", "TABLE_SCHEMA"] - - helpviewer_keywords: ["schema rowsets", "CAssertionInfo parameter class", "CAssertions typedef class", "CCatalogInfo parameter class", "CCatalogs typedef class", "CCharacterSetInfo parameter class", "CCharacterSets typedef class", "CCheckConstraintInfo parameter class", "CCheckConstraints typedef class", "CCollationInfo parameter class", "CCollations typedef class", "CColumnDomainUsage typedef class", "CColumnDomainUsageInfo parameter class", "CColumnPrivilegeInfo parameter class", "CColumnPrivileges typedef class", "CColumns typedef class", "CColumnsInfo parameter class", "CConstraintColumnUsage typedef class", "CConstraintColumnUsageInfo parameter class", "CConstraintTableUsage typedef class", "CConstraintTableUsageInfo parameter class", "CForeignKeys typedef class", "CForeignKeysInfo parameter class", "CHARACTER_MAXIMUM_LENGTH", "CHARACTER_OCTET_LENGTH", "CHARACTER_SET_CATALOG", "CHARACTER_SET_NAME", "CHARACTER_SET_SCHEMA", "CHECK_CLAUSE", "CHECK_CONSTRAINTS", "CHECK_OPTION", "CIndexes typedef class", "CIndexInfo parameter class", "CKeyColumnInfo parameter class", "CKeyColumns typedef class", "CLUSTERED", "COLLATION_CATALOG", "COLLATION_NAME", "COLLATION_SCHEMA", "COLLATIONS recordset", "COLUMN_DEFAULT", "COLUMN_DOMAIN_USAGE", "COLUMN_FLAGS", "COLUMN_GUID", "COLUMN_HASDEFAULT", "COLUMN_NAME", "COLUMN_PRIVILEGES", "COLUMN_PROPID", "CONSTRAINT_CATALOG", "CONSTRAINT_COLUMN_USAGE", "CONSTRAINT_NAME", "CONSTRAINT_SCHEMA", "CONSTRAINT_TABLE_USAGE", "CONSTRAINT_TYPE", "CPrimaryKeyInfo parameter class", "CPrimaryKeys typedef class", "CProcedureColumnInfo parameter class", "CProcedureColumns typedef class", "CProcedureInfo parameter class", "CProcedureParameters typedef class", "CProcedureParamInfo parameter class", "CProcedures typedef class", "CProviderInfo parameter class", "CProviderTypes typedef class", "CReferentialConstraintInfo parameter class", "CReferentialConstraints typedef class", "CSchemata typedef class", "CSchemataInfo parameter class", "CSQLLanguageInfo parameter class", "CSQLLanguages typedef class", "CStatisticInfo parameter class", "CStatistics typedef class", "CTableConstraintInfo parameter class", "CTableConstraints typedef class", "CTableInfo parameter class", "CTablePrivilegeInfo parameter class", "CTablePrivileges typedef class", "CTables typedef class", "CTranslationInfo parameter class", "CTranslations typedef class", "CUsagePrivilegeInfo parameter class", "CUsagePrivileges typedef class", "CViewColumnInfo parameter class", "CViewColumnUsage typedef class", "CViewInfo parameter class", "CViews typedef class", "CViewTableInfo parameter class", "CViewTableUsage typedef class", "DATA_TYPE", "DATETIME_PRECISION", "DEFAULT_CHARACTER_SET_CATALOG", "DEFAULT_CHARACTER_SET_NAME", "DEFAULT_CHARACTER_SET_SCHEMA", "DEFAULT_COLLATE_CATALOG", "DEFAULT_COLLATE_NAME", "DEFAULT_COLLATE_SCHEMA", "DELETE_RULE", "DESCRIPTION class data member", "DOMAIN_CATALOG", "DOMAIN_NAME", "DOMAIN_SCHEMA", "FILL_FACTOR", "FILTER_CONDITION", "FIXED_PREC_SCALE", "FK_COLUMN_GUID", "FK_COLUMN_NAME", "FK_COLUMN_PROPID", "FK_TABLE_CATALOG", "FK_TABLE_NAME", "FK_TABLE_SCHEMA", "FORM_OF_USE OLE DB column", "GRANTEE", "GRANTOR", "INDEX_CATALOG", "INDEX_NAME", "INDEX_SCHEMA", "INITIAL_SIZE", "INITIALLY_DEFERRED", "IS_DEFERRABLE", "IS_GRANTABLE", "IS_LONG", "IS_NULLABLE", "IS_UPDATABLE", "LITERAL_SUFFIX", "LOCAL_TYPE_NAME", "m_bAutoUniqueValue", "m_bAutoUpdate", "m_bBestMatch", "m_bCaseSensitive", "m_bCheckOption", "m_bClustered", "m_bColumnHasDefault", "m_bFixedPrecScale", "m_bHasDefault", "m_bInitiallyDeferred", "m_bIsDeferrable", "m_bIsGrantable", "m_bIsLong", "m_bIsNullable", "m_bIsUpdatable", "m_bPrimaryKey", "m_bSortBookmarks", "m_bUnique", "m_bUnsignedAttribute", "m_guidColumn", "m_guidFKColumn", "m_guidTable", "m_guidType", "m_nCardinality", "m_nCollation", "m_nColumnFlags", "m_nColumnPropID", "m_nColumnSize", "m_nDataType", "m_nDateTimePrecision", "m_nFillFactor", "m_nFKColumnPropID", "m_nInitialSize", "m_nMaxLength", "m_nMinScale", "m_nNullCollation", "m_nNulls", "m_nNumCharacters", "m_nNumericPrecision", "m_nNumericScale", "m_nOctetLength", "m_nOrdinal", "m_nOrdinalPosition", "m_nPages", "m_nPKColumnPropID", "m_nPrecision", "m_nRowsetNumber", "m_nScale", "m_nSearchable", "m_nType", "m_szBindingStyle", "m_szCatalog", "m_szCharCatalog", "m_szCharName", "m_szCharSchema", "m_szCharSetCatalog", "m_szCharSetName", "m_szCharSetSchema", "m_szCheckClause", "m_szCollateCatalog", "m_szCollateName", "m_szCollateSchema", "m_szCollationCatalog", "m_szCollationName", "m_szCollationSchema", "m_szColumnDefault", "m_szColumnName", "m_szConformance", "m_szConstraintCatalog", "m_szConstraintName", "m_szConstraintSchema", "m_szCreateParams", "m_szDefault", "m_szDefinition", "m_szDeleteRule", "m_szDescription", "m_szDomainCatalog", "m_szDomainName", "m_szDomainSchema", "m_szFilterCondition", "m_szFKColumnName", "m_szFKTableCatalog", "m_szFKTableName", "m_szFKTableSchema", "m_szFormOfUse", "m_szGrantee", "m_szGrantor", "m_szImplementation", "m_szIndexCatalog", "m_szIndexName", "m_szIndexSchema", "m_szIntegrity", "m_szLiteralPrefix", "m_szLocalTypeName", "m_szMatchOption", "m_szName", "m_szObjectCatalog", "m_szObjectName", "m_szObjectSchema", "m_szObjectType", "m_szOwner", "m_szPadAttribute", "m_szParameterName", "m_szPKColumnName", "m_szPKTableCatalog", "m_szPKTableName", "m_szPKTableSchema", "m_szPrivilegeType", "m_szPrivilegeType", "m_szProgrammingLanguage", "m_szSchema", "m_szSource", "m_szSourceCatalog", "m_szSourceName", "m_szSourceSchema", "m_szTableCatalog", "m_szTableName", "m_szTableSchema", "m_szTargetCatalog", "m_szTargetName", "m_szTargetSchema", "m_szType", "m_szTypeLib", "m_szTypeName", "m_szUniqueCatalog", "m_szUniqueName", "m_szUniqueSchema", "m_szUpdateRule", "m_szUpdateRule", "m_szVersion", "m_szYear", "MATCH_OPTION", "MAXIMUM_SCALE", "MINIMUM_SCALE", "NULL_COLLATION", "NULLS", "NUMBER_OF_CHARACTERS", "NUMERIC_PRECISION", "NUMERIC_SCALE", "OBJECT_CATALOG", "OBJECT_NAME", "OBJECT_SCHEMA", "OBJECT_TYPE", "ORDINAL data member", "ORDINAL_POSITION", "TABLE_CATALOG", "TABLE_GUID", "TABLE_NAME", "TABLE_SCHEMA"] ms.assetid: 4bd881b3-26ca-4bdb-9226-d67560864f29 --- diff --git a/docs/standard-library/bitset-class.md b/docs/standard-library/bitset-class.md index d5fbac7df4a..753734d7d5c 100644 --- a/docs/standard-library/bitset-class.md +++ b/docs/standard-library/bitset-class.md @@ -5,7 +5,6 @@ ms.date: 06/10/2022 f1_keywords: ["bitset/std::bitset", "bitset/std::bitset::element_type", "bitset/std::bitset::all", "bitset/std::bitset::any", "bitset/std::bitset::count", "bitset/std::bitset::flip", "bitset/std::bitset::none", "bitset/std::bitset::reset", "bitset/std::bitset::set", "bitset/std::bitset::size", "bitset/std::bitset::test", "bitset/std::bitset::to_string", "bitset/std::bitset::to_ullong", "bitset/std::bitset::to_ulong", "bitset/std::bitset::reference"] helpviewer_keywords: ["std::bitset [C++]", "std::bitset [C++], element_type", "std::bitset [C++], all", "std::bitset [C++], any", "std::bitset [C++], count", "std::bitset [C++], flip", "std::bitset [C++], none", "std::bitset [C++], reset", "std::bitset [C++], set", "std::bitset [C++], size", "std::bitset [C++], test", "std::bitset [C++], to_string", "std::bitset [C++], to_ullong", "std::bitset [C++], to_ulong", "std::bitset [C++], reference"] ms.custom: devdivchpfy22 - --- # `bitset` class diff --git a/docs/standard-library/treat-as-floating-point-structure.md b/docs/standard-library/treat-as-floating-point-structure.md index 7389b8620fe..e44f125d862 100644 --- a/docs/standard-library/treat-as-floating-point-structure.md +++ b/docs/standard-library/treat-as-floating-point-structure.md @@ -5,7 +5,6 @@ ms.date: 07/16/2021 f1_keywords: ["chrono/std::chrono::treat_as_floating_point"] helpviewer_keywords: ["std::chrono [C++], treat_as_floating_point"] dev_langs: ["C++"] - --- # `treat_as_floating_point` structure From 589bbe50d8167f9fdea44815e3986e1167abec6f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 10 Jun 2025 23:41:27 +0800 Subject: [PATCH 0031/1799] Clean up metadata in 3 topics --- docs/data/oledb/schema-rowset-classes-and-typedef-classes.md | 5 ++--- docs/standard-library/bitset-class.md | 2 +- docs/standard-library/treat-as-floating-point-structure.md | 2 +- 3 files changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md b/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md index 2739c1b09d8..f4782506663 100644 --- a/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md +++ b/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Schema Rowset Classes and Typedef Classes" title: "Schema Rowset Classes and Typedef Classes" -ms.date: "11/04/2016" +description: "Learn more about: Schema Rowset Classes and Typedef Classes" +ms.date: 11/04/2016 f1_keywords: ["CAssertionInfo", "CAssertions", "CCatalogInfo", "CCatalogs", "CCharacterSetInfo", "CCharacterSets", "CCheckConstraintInfo", "CCheckConstraints", "CCollationInfo", "CCollations", "CColumnDomainUsage", "CColumnDomainUsageInfo", "CColumnPrivilegeInfo", "CColumnPrivileges", "CColumns", "CColumnsInfo", "CConstraintColumnUsage", "CConstraintColumnUsageInfo", "CConstraintTableUsage", "CConstraintTableUsageInfo", "CForeignKeys", "CForeignKeysInfo", "CHARACTER_MAXIMUM_LENGTH", "CHARACTER_OCTET_LENGTH", "CHARACTER_SET_CATALOG", "CHARACTER_SET_NAME", "CHARACTER_SET_SCHEMA", "CHECK_CLAUSE", "CHECK_CONSTRAINTS", "CHECK_OPTION", "CIndexes", "CIndexInfo", "CKeyColumnInfo", "CKeyColumns", "CLUSTERED", "COLLATION", "COLLATION_CATALOG", "COLLATION_NAME", "COLLATION_SCHEMA", "COLLATIONS", "COLUMN_DEFAULT", "COLUMN_DOMAIN_USAGE", "COLUMN_FLAGS", "COLUMN_GUID", "COLUMN_HASDEFAULT", "COLUMN_PRIVILEGES", "COLUMN_PROPID", "COLUMN_SIZE", "CONSTRAINT_CATALOG", "CONSTRAINT_COLUMN_USAGE", "CONSTRAINT_NAME", "CONSTRAINT_SCHEMA", "CONSTRAINT_TABLE_USAGE", "CONSTRAINT_TYPE", "CPrimaryKeyInfo", "CPrimaryKeys", "CProcedureColumnInfo", "CProcedureColumns", "CProcedureInfo", "CProcedureParameters", "CProcedureParamInfo", "CProcedures", "CProviderInfo", "CProviderTypes", "CReferentialConstraintInfo", "CReferentialConstraints", "CSchemata", "CSchemataInfo", "CSQLLanguageInfo", "CSQLLanguages", "CStatisticInfo", "CStatistics", "CTableConstraintInfo", "CTableConstraints", "CTableInfo", "CTablePrivilegeInfo", "CTablePrivileges", "CTables", "CTranslationInfo", "CTranslations", "CUsagePrivilegeInfo", "CUsagePrivileges", "CViewColumnInfo", "CViewColumnUsage", "CViewInfo", "CViews", "CViewTableInfo", "CViewTableUsage", "DATA_TYPE", "DATETIME_PRECISION", "DEFAULT_CHARACTER_SET_CATALOG", "DEFAULT_CHARACTER_SET_NAME", "DEFAULT_CHARACTER_SET_SCHEMA", "DEFAULT_COLLATE_CATALOG", "DEFAULT_COLLATE_NAME", "DEFAULT_COLLATE_SCHEMA", "DELETE_RULE", "DOMAIN_CATALOG", "DOMAIN_NAME", "DOMAIN_SCHEMA", "FILL_FACTOR", "FILTER_CONDITION", "FIXED_PREC_SCALE", "FK_COLUMN_GUID", "FK_COLUMN_NAME", "FK_COLUMN_PROPID", "FK_TABLE_CATALOG", "FK_TABLE_NAME", "FK_TABLE_SCHEMA", "FORM_OF_USE", "GRANTEE", "GRANTOR", "INDEX_CATALOG", "INDEX_NAME", "INDEX_SCHEMA", "INITIAL_SIZE", "INITIALLY_DEFERRED", "IS_DEFERRABLE", "IS_GRANTABLE", "IS_LONG", "IS_NULLABLE", "IS_UPDATABLE", "LITERAL_SUFFIX", "LOCAL_TYPE_NAME", "m_bAutoUniqueValue", "m_bAutoUpdate", "m_bBestMatch", "m_bCaseSensitive", "m_bCheckOption", "m_bClustered", "m_bColumnHasDefault", "m_bFixedPrecScale", "m_bHasDefault", "m_bInitiallyDeferred", "m_bIsDeferrable", "m_bIsGrantable", "m_bIsLong", "m_bIsNullable", "m_bIsUpdatable", "m_bPrimaryKey", "m_bSortBookmarks", "m_bUnique", "m_bUnsignedAttribute", "m_guidColumn", "m_guidFKColumn", "m_guidPKColumn", "m_guidTable", "m_guidType", "m_nCardinality", "m_nCollation", "m_nColumnFlags", "m_nColumnPropID", "m_nColumnSize", "m_nDataType", "m_nDateTimePrecision", "m_nFillFactor", "m_nFKColumnPropID", "m_nInitialSize", "m_nMaxLength", "m_nMaxScale", "m_nNullCollation", "m_nNulls", "m_nNumCharacters", "m_nNumericPrecision", "m_nNumericScale", "m_nOctetLength", "m_nOrdinal", "m_nOrdinalPosition", "m_nPages", "m_nPKColumnPropID", "m_nPrecision", "m_nRowsetNumber", "m_nScale", "m_nSearchable", "m_szBindingStyle", "m_szCatalog", "m_szCharCatalog", "m_szCharName", "m_szCharSchema", "m_szCharSetCatalog", "m_szCharSetName", "m_szCharSetSchema", "m_szCheckClause", "m_szCollateCatalog", "m_szCollateName", "m_szCollateSchema", "m_szCollationCatalog", "m_szCollationName", "m_szCollationSchema", "m_szColumnDefault", "m_szColumnName", "m_szConformance", "m_szConstraintCatalog", "m_szConstraintName", "m_szConstraintSchema", "m_szCreateParams", "m_szDefault", "m_szDefinition", "m_szDeleteRule", "m_szDomainCatalog", "m_szDomainName", "m_szDomainSchema", "m_szFilterCondition", "m_szFKColumnName", "m_szFKTableCatalog", "m_szFKTableName", "m_szFKTableSchema", "m_szFormOfUse", "m_szGrantee", "m_szGrantor", "m_szImplementation", "m_szIndexCatalog", "m_szIndexName", "m_szIndexSchema", "m_szIntegrity", "m_szLiter alSuffix", "m_szLiteralPrefix", "m_szLocalTypeName", "m_szMatchOption", "m_szObjectCatalog", "m_szObjectName", "m_szObjectSchema", "m_szObjectType", "m_szOwner", "m_szPadAttribute", "m_szParameterName", "m_szPKColumnName", "m_szPKTableCatalog", "m_szPKTableName", "m_szPKTableSchema", "m_szPrivilegeType", "m_szProgrammingLanguage", "m_szSchema", "m_szSource", "m_szSourceCatalog", "m_szSourceName", "m_szSourceSchema", "m_szTableCatalog", "m_szTableName", "m_szTableSchema", "m_szTargetCatalog", "m_szTargetName", "m_szTargetSchema", "m_szType", "m_szTypeLib", "m_szTypeName", "m_szUniqueCatalog", "m_szUniqueName", "m_szUniqueSchema", "m_szUpdateRule", "m_szVersion", "m_szYear", "MATCH_OPTION", "MAXIMUM_SCALE", "MINIMUM_SCALE", "NULL_COLLATION", "NULLS", "NUMBER_OF_CHARACTERS", "NUMERIC_PRECISION", "NUMERIC_SCALE", "OBJECT_CATALOG", "OBJECT_NAME", "OBJECT_SCHEMA", "OBJECT_TYPE", "ORDINAL", "ORDINAL_POSITION", "TABLE_CATALOG", "TABLE_GUID", "TABLE_NAME", "TABLE_SCHEMA"] helpviewer_keywords: ["schema rowsets", "CAssertionInfo parameter class", "CAssertions typedef class", "CCatalogInfo parameter class", "CCatalogs typedef class", "CCharacterSetInfo parameter class", "CCharacterSets typedef class", "CCheckConstraintInfo parameter class", "CCheckConstraints typedef class", "CCollationInfo parameter class", "CCollations typedef class", "CColumnDomainUsage typedef class", "CColumnDomainUsageInfo parameter class", "CColumnPrivilegeInfo parameter class", "CColumnPrivileges typedef class", "CColumns typedef class", "CColumnsInfo parameter class", "CConstraintColumnUsage typedef class", "CConstraintColumnUsageInfo parameter class", "CConstraintTableUsage typedef class", "CConstraintTableUsageInfo parameter class", "CForeignKeys typedef class", "CForeignKeysInfo parameter class", "CHARACTER_MAXIMUM_LENGTH", "CHARACTER_OCTET_LENGTH", "CHARACTER_SET_CATALOG", "CHARACTER_SET_NAME", "CHARACTER_SET_SCHEMA", "CHECK_CLAUSE", "CHECK_CONSTRAINTS", "CHECK_OPTION", "CIndexes typedef class", "CIndexInfo parameter class", "CKeyColumnInfo parameter class", "CKeyColumns typedef class", "CLUSTERED", "COLLATION_CATALOG", "COLLATION_NAME", "COLLATION_SCHEMA", "COLLATIONS recordset", "COLUMN_DEFAULT", "COLUMN_DOMAIN_USAGE", "COLUMN_FLAGS", "COLUMN_GUID", "COLUMN_HASDEFAULT", "COLUMN_NAME", "COLUMN_PRIVILEGES", "COLUMN_PROPID", "CONSTRAINT_CATALOG", "CONSTRAINT_COLUMN_USAGE", "CONSTRAINT_NAME", "CONSTRAINT_SCHEMA", "CONSTRAINT_TABLE_USAGE", "CONSTRAINT_TYPE", "CPrimaryKeyInfo parameter class", "CPrimaryKeys typedef class", "CProcedureColumnInfo parameter class", "CProcedureColumns typedef class", "CProcedureInfo parameter class", "CProcedureParameters typedef class", "CProcedureParamInfo parameter class", "CProcedures typedef class", "CProviderInfo parameter class", "CProviderTypes typedef class", "CReferentialConstraintInfo parameter class", "CReferentialConstraints typedef class", "CSchemata typedef class", "CSchemataInfo parameter class", "CSQLLanguageInfo parameter class", "CSQLLanguages typedef class", "CStatisticInfo parameter class", "CStatistics typedef class", "CTableConstraintInfo parameter class", "CTableConstraints typedef class", "CTableInfo parameter class", "CTablePrivilegeInfo parameter class", "CTablePrivileges typedef class", "CTables typedef class", "CTranslationInfo parameter class", "CTranslations typedef class", "CUsagePrivilegeInfo parameter class", "CUsagePrivileges typedef class", "CViewColumnInfo parameter class", "CViewColumnUsage typedef class", "CViewInfo parameter class", "CViews typedef class", "CViewTableInfo parameter class", "CViewTableUsage typedef class", "DATA_TYPE", "DATETIME_PRECISION", "DEFAULT_CHARACTER_SET_CATALOG", "DEFAULT_CHARACTER_SET_NAME", "DEFAULT_CHARACTER_SET_SCHEMA", "DEFAULT_COLLATE_CATALOG", "DEFAULT_COLLATE_NAME", "DEFAULT_COLLATE_SCHEMA", "DELETE_RULE", "DESCRIPTION class data member", "DOMAIN_CATALOG", "DOMAIN_NAME", "DOMAIN_SCHEMA", "FILL_FACTOR", "FILTER_CONDITION", "FIXED_PREC_SCALE", "FK_COLUMN_GUID", "FK_COLUMN_NAME", "FK_COLUMN_PROPID", "FK_TABLE_CATALOG", "FK_TABLE_NAME", "FK_TABLE_SCHEMA", "FORM_OF_USE OLE DB column", "GRANTEE", "GRANTOR", "INDEX_CATALOG", "INDEX_NAME", "INDEX_SCHEMA", "INITIAL_SIZE", "INITIALLY_DEFERRED", "IS_DEFERRABLE", "IS_GRANTABLE", "IS_LONG", "IS_NULLABLE", "IS_UPDATABLE", "LITERAL_SUFFIX", "LOCAL_TYPE_NAME", "m_bAutoUniqueValue", "m_bAutoUpdate", "m_bBestMatch", "m_bCaseSensitive", "m_bCheckOption", "m_bClustered", "m_bColumnHasDefault", "m_bFixedPrecScale", "m_bHasDefault", "m_bInitiallyDeferred", "m_bIsDeferrable", "m_bIsGrantable", "m_bIsLong", "m_bIsNullable", "m_bIsUpdatable", "m_bPrimaryKey", "m_bSortBookmarks", "m_bUnique", "m_bUnsignedAttribute", "m_guidColumn", "m_guidFKColumn", "m_guidTable", "m_guidType", "m_nCardinality", "m_nCollation", "m_nColumnFlags", "m_nColumnPropID", "m_nColumnSize", "m_nDataType", "m_nDateTimePrecision", "m_nFillFactor", "m_nFKColumnPropID", "m_nInitialSize", "m_nMaxLength", "m_nMinScale", "m_nNullCollation", "m_nNulls", "m_nNumCharacters", "m_nNumericPrecision", "m_nNumericScale", "m_nOctetLength", "m_nOrdinal", "m_nOrdinalPosition", "m_nPages", "m_nPKColumnPropID", "m_nPrecision", "m_nRowsetNumber", "m_nScale", "m_nSearchable", "m_nType", "m_szBindingStyle", "m_szCatalog", "m_szCharCatalog", "m_szCharName", "m_szCharSchema", "m_szCharSetCatalog", "m_szCharSetName", "m_szCharSetSchema", "m_szCheckClause", "m_szCollateCatalog", "m_szCollateName", "m_szCollateSchema", "m_szCollationCatalog", "m_szCollationName", "m_szCollationSchema", "m_szColumnDefault", "m_szColumnName", "m_szConformance", "m_szConstraintCatalog", "m_szConstraintName", "m_szConstraintSchema", "m_szCreateParams", "m_szDefault", "m_szDefinition", "m_szDeleteRule", "m_szDescription", "m_szDomainCatalog", "m_szDomainName", "m_szDomainSchema", "m_szFilterCondition", "m_szFKColumnName", "m_szFKTableCatalog", "m_szFKTableName", "m_szFKTableSchema", "m_szFormOfUse", "m_szGrantee", "m_szGrantor", "m_szImplementation", "m_szIndexCatalog", "m_szIndexName", "m_szIndexSchema", "m_szIntegrity", "m_szLiteralPrefix", "m_szLocalTypeName", "m_szMatchOption", "m_szName", "m_szObjectCatalog", "m_szObjectName", "m_szObjectSchema", "m_szObjectType", "m_szOwner", "m_szPadAttribute", "m_szParameterName", "m_szPKColumnName", "m_szPKTableCatalog", "m_szPKTableName", "m_szPKTableSchema", "m_szPrivilegeType", "m_szPrivilegeType", "m_szProgrammingLanguage", "m_szSchema", "m_szSource", "m_szSourceCatalog", "m_szSourceName", "m_szSourceSchema", "m_szTableCatalog", "m_szTableName", "m_szTableSchema", "m_szTargetCatalog", "m_szTargetName", "m_szTargetSchema", "m_szType", "m_szTypeLib", "m_szTypeName", "m_szUniqueCatalog", "m_szUniqueName", "m_szUniqueSchema", "m_szUpdateRule", "m_szUpdateRule", "m_szVersion", "m_szYear", "MATCH_OPTION", "MAXIMUM_SCALE", "MINIMUM_SCALE", "NULL_COLLATION", "NULLS", "NUMBER_OF_CHARACTERS", "NUMERIC_PRECISION", "NUMERIC_SCALE", "OBJECT_CATALOG", "OBJECT_NAME", "OBJECT_SCHEMA", "OBJECT_TYPE", "ORDINAL data member", "ORDINAL_POSITION", "TABLE_CATALOG", "TABLE_GUID", "TABLE_NAME", "TABLE_SCHEMA"] -ms.assetid: 4bd881b3-26ca-4bdb-9226-d67560864f29 --- # Schema Rowset Classes and Typedef Classes diff --git a/docs/standard-library/bitset-class.md b/docs/standard-library/bitset-class.md index 753734d7d5c..a70a5b0f934 100644 --- a/docs/standard-library/bitset-class.md +++ b/docs/standard-library/bitset-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: bitset Class" title: "bitset Class" +description: "Learn more about: bitset Class" ms.date: 06/10/2022 f1_keywords: ["bitset/std::bitset", "bitset/std::bitset::element_type", "bitset/std::bitset::all", "bitset/std::bitset::any", "bitset/std::bitset::count", "bitset/std::bitset::flip", "bitset/std::bitset::none", "bitset/std::bitset::reset", "bitset/std::bitset::set", "bitset/std::bitset::size", "bitset/std::bitset::test", "bitset/std::bitset::to_string", "bitset/std::bitset::to_ullong", "bitset/std::bitset::to_ulong", "bitset/std::bitset::reference"] helpviewer_keywords: ["std::bitset [C++]", "std::bitset [C++], element_type", "std::bitset [C++], all", "std::bitset [C++], any", "std::bitset [C++], count", "std::bitset [C++], flip", "std::bitset [C++], none", "std::bitset [C++], reset", "std::bitset [C++], set", "std::bitset [C++], size", "std::bitset [C++], test", "std::bitset [C++], to_string", "std::bitset [C++], to_ullong", "std::bitset [C++], to_ulong", "std::bitset [C++], reference"] diff --git a/docs/standard-library/treat-as-floating-point-structure.md b/docs/standard-library/treat-as-floating-point-structure.md index e44f125d862..4dbd2818c38 100644 --- a/docs/standard-library/treat-as-floating-point-structure.md +++ b/docs/standard-library/treat-as-floating-point-structure.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: treat_as_floating_point structure" title: "treat_as_floating_point Structure" +description: "Learn more about: treat_as_floating_point structure" ms.date: 07/16/2021 f1_keywords: ["chrono/std::chrono::treat_as_floating_point"] helpviewer_keywords: ["std::chrono [C++], treat_as_floating_point"] From 67a353e63519cd24b5f5b077a7161ea677542695 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 16:14:08 +0800 Subject: [PATCH 0032/1799] Fix duplicate `operator[]` entry in `CSimpleStringT` reference --- .../reference/csimplestringt-class.md | 22 ------------------- 1 file changed, 22 deletions(-) diff --git a/docs/atl-mfc-shared/reference/csimplestringt-class.md b/docs/atl-mfc-shared/reference/csimplestringt-class.md index 66813334102..b62a850efa1 100644 --- a/docs/atl-mfc-shared/reference/csimplestringt-class.md +++ b/docs/atl-mfc-shared/reference/csimplestringt-class.md @@ -716,28 +716,6 @@ CSimpleString s(_T("abc"), pMgr); ASSERT(s[1] == _T('b')); ``` -## `CSimpleStringT::operator []` - -Call this function to access a single character of the character array. - -### Syntax - -```cpp -XCHAR operator[](int iChar) const; -``` - -### Parameters - -*`iChar`*
-Zero-based index of a character in the string. - -### Remarks - -The overloaded subscript (**`[]`**) operator returns a single character specified by the zero-based index in *`iChar`*. This operator is a convenient substitute for the [`GetAt`](#getat) member function. - -> [!NOTE] -> You can use the subscript (**`[]`**) operator to get the value of a character in a `CSimpleStringT`, but you cannot use it to change the value of a character in a `CSimpleStringT`. - ## `CSimpleStringT::operator +=` Joins a new string or character to the end of an existing string. From 9d5d0ae49671960c5427e6e86b57378e916a88c0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 16:51:46 +0800 Subject: [PATCH 0033/1799] Add missing escapes for superscript definitions --- docs/build/reference/compiler-options-listed-alphabetically.md | 2 +- docs/build/reference/compiler-options-listed-by-category.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/compiler-options-listed-alphabetically.md b/docs/build/reference/compiler-options-listed-alphabetically.md index 60768c2a337..686023b2143 100644 --- a/docs/build/reference/compiler-options-listed-alphabetically.md +++ b/docs/build/reference/compiler-options-listed-alphabetically.md @@ -261,7 +261,7 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/Zs`](zs-syntax-check-only.md) | Checks syntax only. | | [`/ZW`](zw-windows-runtime-compilation.md) | Produces an output file to run on the Windows Runtime. | -17.10 This option is available starting in Visual Studio 2022 version 17.10. +17.10 This option is available starting in Visual Studio 2022 version 17.10.\ 17.14 This option is available starting in Visual Studio 2022 version 17.14. ## See also diff --git a/docs/build/reference/compiler-options-listed-by-category.md b/docs/build/reference/compiler-options-listed-by-category.md index ecfe1399496..2fbfbc13572 100644 --- a/docs/build/reference/compiler-options-listed-by-category.md +++ b/docs/build/reference/compiler-options-listed-by-category.md @@ -329,7 +329,7 @@ Experimental options may only be supported by certain versions of the compiler. | [`/Ze`](za-ze-disable-language-extensions.md) | Deprecated. Enables language extensions. | | [`/Zg`](zg-generate-function-prototypes.md) | Removed in Visual Studio 2015. Generates function prototypes. | -17.10 This option is available starting in Visual Studio 2022 version 17.10. +17.10 This option is available starting in Visual Studio 2022 version 17.10.\ 17.14 This option is available starting in Visual Studio 2022 version 17.14. ## See also From e81832da99e8237512a9c3d11e4187f7b1034343 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 17:01:25 +0800 Subject: [PATCH 0034/1799] Add backticks for code analysis names --- docs/code-quality/c28112.md | 2 +- docs/code-quality/c28159.md | 2 +- docs/code-quality/c28160.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/code-quality/c28112.md b/docs/code-quality/c28112.md index d717ffd5961..0653b24bb82 100644 --- a/docs/code-quality/c28112.md +++ b/docs/code-quality/c28112.md @@ -16,7 +16,7 @@ A variable that is accessed by using the Interlocked executive support routines, `InterlockedXxx` functions are intended to provide atomic operations, but are only atomic with respect to other `InterlockedXxx` functions. Although certain ordinary assignments, accesses, and comparisons to variables that are used by the Interlocked\* routines can be safely accessed by using a different function, the risk is great enough to justify examining each instance. -Code analysis name: INTERLOCKED_ACCESS +Code analysis name: `INTERLOCKED_ACCESS` ## Example diff --git a/docs/code-quality/c28159.md b/docs/code-quality/c28159.md index 2ea1d2c85d5..05fbe31944d 100644 --- a/docs/code-quality/c28159.md +++ b/docs/code-quality/c28159.md @@ -15,7 +15,7 @@ This warning occurs when you use a function that is semantically equivalent to a C28159 is a general warning message; the annotation `__drv_preferredFunction` was used (possibly with a conditional `__drv_when`() annotation) to flag a bad coding practice. -Code analysis name: USE_OTHER_FUNCTION +Code analysis name: `USE_OTHER_FUNCTION` ## Example diff --git a/docs/code-quality/c28160.md b/docs/code-quality/c28160.md index 38ea9be0b14..5acfaec5bdf 100644 --- a/docs/code-quality/c28160.md +++ b/docs/code-quality/c28160.md @@ -16,4 +16,4 @@ This warning is reported when a `__drv_error` annotation has been encountered. This annotation is used to flag coding practices that should be fixed, and can be used with a `__drv_when` annotation to indicate specific combinations of parameters. -Code analysis name: ERROR +Code analysis name: `ERROR` From 270d15d13d29fa0e25e8d3e035dc37dd1e4ce290 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 17:02:49 +0800 Subject: [PATCH 0035/1799] Clean up metadata for 2 code analysis references --- docs/code-quality/c28112.md | 3 +-- docs/code-quality/c28160.md | 3 +-- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/code-quality/c28112.md b/docs/code-quality/c28112.md index 0653b24bb82..530ab51bc01 100644 --- a/docs/code-quality/c28112.md +++ b/docs/code-quality/c28112.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C28112" title: Warning C28112 +description: "Learn more about: Warning C28112" ms.date: 08/25/2022 f1_keywords: ["C28112", "INTERLOCKED_ACCESS", "__WARNING_INTERLOCKED_ACCESS"] helpviewer_keywords: ["C28112"] -ms.assetid: 2720a5dc-84e9-4f78-a8c7-a320c9f9216b --- # Warning C28112 diff --git a/docs/code-quality/c28160.md b/docs/code-quality/c28160.md index 5acfaec5bdf..eeee7046da1 100644 --- a/docs/code-quality/c28160.md +++ b/docs/code-quality/c28160.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C28160" title: Warning C28160 +description: "Learn more about: Warning C28160" ms.date: 09/08/2022 f1_keywords: ["C28160", "ERROR", "__WARNING_ERROR"] helpviewer_keywords: ["C28160"] -ms.assetid: cab15f6b-909c-4cc8-81a0-c24ac7c91c7c --- # Warning C28160 From aa742327fa2f2f20f5d83861bdee2d67fff87f33 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 17:37:51 +0800 Subject: [PATCH 0036/1799] Fix heading and anchor for `IDispEventImpl::_tihclass` typedef --- docs/atl/reference/idispeventimpl-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index 74fd3e72c26..7da5a019bc7 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -211,7 +211,7 @@ The constructor. Stores the values of the class template parameters *plibid*, *p IDispEventImpl(); ``` -## IDispEventImpl::tihclass +## IDispEventImpl::_tihclass This typedef is an instance of the class template parameter *tihclass*. From 418607e55a3d8f75e9848c90bb031dd3fecebd57 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 17:39:44 +0800 Subject: [PATCH 0037/1799] Correct `IDispEventImpl::_tihclass` link in public typedefs table --- docs/atl/reference/idispeventimpl-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index 7da5a019bc7..eef06b4604d 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -54,7 +54,7 @@ The class used to manage the type information for *T*. The default value is a cl |Name|Description| |----------|-----------------| -|[IDispEventImpl::_tihclass](../../atl/reference/idispeventimpl-class.md)|The class used to manage the type information. By default, `CComTypeInfoHolder`.| +|[IDispEventImpl::_tihclass](#_tihclass)|The class used to manage the type information. By default, `CComTypeInfoHolder`.| ### Public Constructors From 20029a282589b7fa8c1c2aa363cb6df91ce81e61 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 17:49:38 +0800 Subject: [PATCH 0038/1799] Add backticks for `IDispEventImpl` class reference --- docs/atl/reference/idispeventimpl-class.md | 104 ++++++++++----------- 1 file changed, 52 insertions(+), 52 deletions(-) diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index eef06b4604d..1c7a1370b83 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -6,7 +6,7 @@ f1_keywords: ["IDispEventImpl", "ATLCOM/ATL::IDispEventImpl", "ATLCOM/ATL::IDisp helpviewer_keywords: ["IDispEventImpl class"] ms.assetid: a64b5288-35cb-4638-aad6-2d15b1c7cf7b --- -# IDispEventImpl Class +# `IDispEventImpl` Class This class provides implementations of the `IDispatch` methods. @@ -27,26 +27,26 @@ class ATL_NO_VTABLE IDispEventImpl : public IDispEventSimpleImpl #### Parameters -*nID*
+*`nID`*
A unique identifier for the source object. When `IDispEventImpl` is the base class for a composite control, use the resource ID of the desired contained control for this parameter. In other cases, use an arbitrary positive integer. -*T*
+*`T`*
The user's class, which is derived from `IDispEventImpl`. -*pdiid*
-The pointer to the IID of the event dispinterface implemented by this class. This interface must be defined in the type library denoted by *plibid*, *wMajor*, and *wMinor*. +*`pdiid`*
+The pointer to the IID of the event dispinterface implemented by this class. This interface must be defined in the type library denoted by *`plibid`*, *`wMajor`*, and *`wMinor`*. -*plibid*
-A pointer to the type library that defines the dispatch interface pointed to by *pdiid*. If **&GUID_NULL**, the type library will be loaded from the object sourcing the events. +*`plibid`*
+A pointer to the type library that defines the dispatch interface pointed to by *`pdiid`*. If **`&GUID_NULL`**, the type library will be loaded from the object sourcing the events. -*wMajor*
+*`wMajor`*
The major version of the type library. The default value is 0. -*wMinor*
+*`wMinor`*
The minor version of the type library. The default value is 0. -*tihclass*
-The class used to manage the type information for *T*. The default value is a class of type `CComTypeInfoHolder`; however, you can override this template parameter by providing a class of a type other than `CComTypeInfoHolder`. +*`tihclass`*
+The class used to manage the type information for *`T`*. The default value is a class of type `CComTypeInfoHolder`; however, you can override this template parameter by providing a class of a type other than `CComTypeInfoHolder`. ## Members @@ -54,23 +54,23 @@ The class used to manage the type information for *T*. The default value is a cl |Name|Description| |----------|-----------------| -|[IDispEventImpl::_tihclass](#_tihclass)|The class used to manage the type information. By default, `CComTypeInfoHolder`.| +|[`IDispEventImpl::_tihclass`](#_tihclass)|The class used to manage the type information. By default, `CComTypeInfoHolder`.| ### Public Constructors |Name|Description| |----------|-----------------| -|[IDispEventImpl::IDispEventImpl](#idispeventimpl)|The constructor.| +|[`IDispEventImpl::IDispEventImpl`](#idispeventimpl)|The constructor.| ### Public Methods |Name|Description| |----------|-----------------| -|[IDispEventImpl::GetFuncInfoFromId](#getfuncinfofromid)|Locates the function index for the specified dispatch identifier.| -|[IDispEventImpl::GetIDsOfNames](#getidsofnames)|Maps a single member and an optional set of argument names to a corresponding set of integer DISPIDs.| -|[IDispEventImpl::GetTypeInfo](#gettypeinfo)|Retrieves the type information for an object.| -|[IDispEventImpl::GetTypeInfoCount](#gettypeinfocount)|Retrieves the number of type information interfaces.| -|[IDispEventImpl::GetUserDefinedType](#getuserdefinedtype)|Retrieves the basic type of a user-defined type.| +|[`IDispEventImpl::GetFuncInfoFromId`](#getfuncinfofromid)|Locates the function index for the specified dispatch identifier.| +|[`IDispEventImpl::GetIDsOfNames`](#getidsofnames)|Maps a single member and an optional set of argument names to a corresponding set of integer `DISPID`s.| +|[`IDispEventImpl::GetTypeInfo`](#gettypeinfo)|Retrieves the type information for an object.| +|[`IDispEventImpl::GetTypeInfoCount`](#gettypeinfocount)|Retrieves the number of type information interfaces.| +|[`IDispEventImpl::GetUserDefinedType`](#getuserdefinedtype)|Retrieves the basic type of a user-defined type.| ## Remarks @@ -78,18 +78,18 @@ The class used to manage the type information for *T*. The default value is a cl `IDispEventImpl` works in conjunction with the event sink map in your class to route events to the appropriate handler function. To use this class: -Add a [SINK_ENTRY](composite-control-macros.md#sink_entry) or [SINK_ENTRY_EX](composite-control-macros.md#sink_entry_ex) macro to the event sink map for each event on each object that you want to handle. When using `IDispEventImpl` as a base class of a composite control, you can call [AtlAdviseSinkMap](connection-point-global-functions.md#atladvisesinkmap) to establish and break the connection with the event sources for all entries in the event sink map. In other cases, or for greater control, call [DispEventAdvise](idispeventsimpleimpl-class.md#dispeventadvise) to establish the connection between the source object and the base class. Call [DispEventUnadvise](idispeventsimpleimpl-class.md#dispeventunadvise) to break the connection. +Add a [`SINK_ENTRY`](composite-control-macros.md#sink_entry) or [`SINK_ENTRY_EX`](composite-control-macros.md#sink_entry_ex) macro to the event sink map for each event on each object that you want to handle. When using `IDispEventImpl` as a base class of a composite control, you can call [`AtlAdviseSinkMap`](connection-point-global-functions.md#atladvisesinkmap) to establish and break the connection with the event sources for all entries in the event sink map. In other cases, or for greater control, call [`DispEventAdvise`](idispeventsimpleimpl-class.md#dispeventadvise) to establish the connection between the source object and the base class. Call [`DispEventUnadvise`](idispeventsimpleimpl-class.md#dispeventunadvise) to break the connection. -You must derive from `IDispEventImpl` (using a unique value for *nID*) for each object for which you need to handle events. You can reuse the base class by unadvising against one source object then advising against a different source object, but the maximum number of source objects that can be handled by a single object at one time is limited by the number of `IDispEventImpl` base classes. +You must derive from `IDispEventImpl` (using a unique value for *`nID`*) for each object for which you need to handle events. You can reuse the base class by unadvising against one source object then advising against a different source object, but the maximum number of source objects that can be handled by a single object at one time is limited by the number of `IDispEventImpl` base classes. -`IDispEventImpl` provides the same functionality as [IDispEventSimpleImpl](../../atl/reference/idispeventsimpleimpl-class.md), except it gets type information about the interface from a type library rather than having it supplied as a pointer to an [_ATL_FUNC_INFO](../../atl/reference/atl-func-info-structure.md) structure. Use `IDispEventSimpleImpl` when you do not have a type library describing the event interface or want to avoid the overhead associated with using the type library. +`IDispEventImpl` provides the same functionality as [`IDispEventSimpleImpl`](../../atl/reference/idispeventsimpleimpl-class.md), except it gets type information about the interface from a type library rather than having it supplied as a pointer to an [`_ATL_FUNC_INFO`](../../atl/reference/atl-func-info-structure.md) structure. Use `IDispEventSimpleImpl` when you do not have a type library describing the event interface or want to avoid the overhead associated with using the type library. > [!NOTE] > `IDispEventImpl` and `IDispEventSimpleImpl` provide their own implementation of `IUnknown::QueryInterface` enabling each `IDispEventImpl` and `IDispEventSimpleImpl` base class to act as a separate COM identity while still allowing direct access to class members in your main COM object. -CE ATL implementation of ActiveX event sinks only supports return values of type HRESULT or void from your event handler methods; any other return value is unsupported and its behavior is undefined. +CE ATL implementation of ActiveX event sinks only supports return values of type `HRESULT` or `void` from your event handler methods; any other return value is unsupported and its behavior is undefined. -For more information, see [Supporting IDispEventImpl](../../atl/supporting-idispeventimpl.md). +For more information, see [Supporting `IDispEventImpl`](../../atl/supporting-idispeventimpl.md). ## Inheritance Hierarchy @@ -97,15 +97,15 @@ For more information, see [Supporting IDispEventImpl](../../atl/supporting-idisp `_IDispEventLocator` -[IDispEventSimpleImpl](../../atl/reference/idispeventsimpleimpl-class.md) +[`IDispEventSimpleImpl`](../../atl/reference/idispeventsimpleimpl-class.md) `IDispEventImpl` ## Requirements -**Header:** atlcom.h +**Header:** `atlcom.h` -## IDispEventImpl::GetFuncInfoFromId +## `IDispEventImpl::GetFuncInfoFromId` Locates the function index for the specified dispatch identifier. @@ -119,25 +119,25 @@ HRESULT GetFuncInfoFromId( ### Parameters -*iid*
+*`iid`*
[in] A reference to the ID of the function. -*dispidMember*
+*`dispidMember`*
[in] The dispatch ID of the function. -*lcid*
+*`lcid`*
[in] The locale context of the function ID. -*info*
+*`info`*
[in] The structure indicating how the function is called. ### Return Value -A standard HRESULT value. +A standard `HRESULT` value. -## IDispEventImpl::GetIDsOfNames +## `IDispEventImpl::GetIDsOfNames` -Maps a single member and an optional set of argument names to a corresponding set of integer DISPIDs, which can be used on subsequent calls to [IDispatch::Invoke](/windows/win32/api/oaidl/nf-oaidl-idispatch-invoke). +Maps a single member and an optional set of argument names to a corresponding set of integer `DISPID`s, which can be used on subsequent calls to [`IDispatch::Invoke`](/windows/win32/api/oaidl/nf-oaidl-idispatch-invoke). ``` STDMETHOD(GetIDsOfNames)( @@ -150,9 +150,9 @@ STDMETHOD(GetIDsOfNames)( ### Remarks -See [IDispatch::GetIDsOfNames](/windows/win32/api/oaidl/nf-oaidl-idispatch-getidsofnames) in the Windows SDK. +See [`IDispatch::GetIDsOfNames`](/windows/win32/api/oaidl/nf-oaidl-idispatch-getidsofnames) in the Windows SDK. -## IDispEventImpl::GetTypeInfo +## `IDispEventImpl::GetTypeInfo` Retrieves the type information for an object, which can then be used to get the type information for an interface. @@ -165,7 +165,7 @@ STDMETHOD(GetTypeInfo)( ### Remarks -## IDispEventImpl::GetTypeInfoCount +## `IDispEventImpl::GetTypeInfoCount` Retrieves the number of type information interfaces that an object provides (either 0 or 1). @@ -175,9 +175,9 @@ STDMETHOD(GetTypeInfoCount)(UINT* pctinfo); ### Remarks -See [IDispatch::GetTypeInfoCount](/windows/win32/api/oaidl/nf-oaidl-idispatch-gettypeinfocount) in the Windows SDK. +See [`IDispatch::GetTypeInfoCount`](/windows/win32/api/oaidl/nf-oaidl-idispatch-gettypeinfocount) in the Windows SDK. -## IDispEventImpl::GetUserDefinedType +## `IDispEventImpl::GetUserDefinedType` Retrieves the basic type of a user-defined type. @@ -189,10 +189,10 @@ VARTYPE GetUserDefinedType( ### Parameters -*pTI*
-[in] A pointer to the [ITypeInfo](/windows/win32/api/oaidl/nn-oaidl-itypeinfo) interface containing the user-defined type. +*`pTI`*
+[in] A pointer to the [`ITypeInfo`](/windows/win32/api/oaidl/nn-oaidl-itypeinfo) interface containing the user-defined type. -*hrt*
+*`hrt`*
[in] A handle to the type description to be retrieved. ### Return Value @@ -201,19 +201,19 @@ The type of variant. ### Remarks -See [ITypeInfo::GetRefTypeInfo](/windows/win32/api/oaidl/nf-oaidl-itypeinfo-getreftypeinfo). +See [`ITypeInfo::GetRefTypeInfo`](/windows/win32/api/oaidl/nf-oaidl-itypeinfo-getreftypeinfo). -## IDispEventImpl::IDispEventImpl +## `IDispEventImpl::IDispEventImpl` -The constructor. Stores the values of the class template parameters *plibid*, *pdiid*, *wMajor*, and *wMinor*. +The constructor. Stores the values of the class template parameters *`plibid`*, *`pdiid`*, *`wMajor`*, and *`wMinor`*. ``` IDispEventImpl(); ``` -## IDispEventImpl::_tihclass +## `IDispEventImpl::_tihclass` -This typedef is an instance of the class template parameter *tihclass*. +This typedef is an instance of the class template parameter *`tihclass`*. ``` typedef tihclass _tihclass; @@ -225,10 +225,10 @@ By default, the class is `CComTypeInfoHolder`. `CComTypeInfoHolder` manages the ## See also -[_ATL_FUNC_INFO Structure](../../atl/reference/atl-func-info-structure.md)
-[IDispatchImpl Class](../../atl/reference/idispatchimpl-class.md)
-[IDispEventSimpleImpl Class](../../atl/reference/idispeventsimpleimpl-class.md)
-[SINK_ENTRY](composite-control-macros.md#sink_entry)
-[SINK_ENTRY_EX](composite-control-macros.md#sink_entry_ex)
-[SINK_ENTRY_INFO](composite-control-macros.md#sink_entry_info)
+[`_ATL_FUNC_INFO` Structure](../../atl/reference/atl-func-info-structure.md)
+[`IDispatchImpl` Class](../../atl/reference/idispatchimpl-class.md)
+[`IDispEventSimpleImpl` Class](../../atl/reference/idispeventsimpleimpl-class.md)
+[`SINK_ENTRY`](composite-control-macros.md#sink_entry)
+[`SINK_ENTRY_EX`](composite-control-macros.md#sink_entry_ex)
+[`SINK_ENTRY_INFO`](composite-control-macros.md#sink_entry_info)
[Class Overview](../../atl/atl-class-overview.md) From 2308730880cec1aeeb2d42602e97da18cc875d0a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 17:51:19 +0800 Subject: [PATCH 0039/1799] Remove empty "Remarks" heading for `IDispEventImpl::GetTypeInfo` entry --- docs/atl/reference/idispeventimpl-class.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index 1c7a1370b83..60739a378b8 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -163,8 +163,6 @@ STDMETHOD(GetTypeInfo)( ITypeInfo** pptinfo); ``` -### Remarks - ## `IDispEventImpl::GetTypeInfoCount` Retrieves the number of type information interfaces that an object provides (either 0 or 1). From 4f83555ce6f47a768c4830958a0ec33ecbfc1a1d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 17:52:57 +0800 Subject: [PATCH 0040/1799] Make all syntax code blocks in `IDispEventImpl` class reference `cpp` --- docs/atl/reference/idispeventimpl-class.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index 60739a378b8..32e8e4ea0a6 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -15,7 +15,7 @@ This class provides implementations of the `IDispatch` methods. ## Syntax -``` +```cpp template Date: Wed, 11 Jun 2025 17:54:45 +0800 Subject: [PATCH 0041/1799] Replace all `br` elements with escapes in `IDispEventImpl` class reference --- docs/atl/reference/idispeventimpl-class.md | 38 +++++++++++----------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index 32e8e4ea0a6..1695cf7b80c 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -27,25 +27,25 @@ class ATL_NO_VTABLE IDispEventImpl : public IDispEventSimpleImpl #### Parameters -*`nID`*
+*`nID`*\ A unique identifier for the source object. When `IDispEventImpl` is the base class for a composite control, use the resource ID of the desired contained control for this parameter. In other cases, use an arbitrary positive integer. -*`T`*
+*`T`*\ The user's class, which is derived from `IDispEventImpl`. -*`pdiid`*
+*`pdiid`*\ The pointer to the IID of the event dispinterface implemented by this class. This interface must be defined in the type library denoted by *`plibid`*, *`wMajor`*, and *`wMinor`*. -*`plibid`*
+*`plibid`*\ A pointer to the type library that defines the dispatch interface pointed to by *`pdiid`*. If **`&GUID_NULL`**, the type library will be loaded from the object sourcing the events. -*`wMajor`*
+*`wMajor`*\ The major version of the type library. The default value is 0. -*`wMinor`*
+*`wMinor`*\ The minor version of the type library. The default value is 0. -*`tihclass`*
+*`tihclass`*\ The class used to manage the type information for *`T`*. The default value is a class of type `CComTypeInfoHolder`; however, you can override this template parameter by providing a class of a type other than `CComTypeInfoHolder`. ## Members @@ -119,16 +119,16 @@ HRESULT GetFuncInfoFromId( ### Parameters -*`iid`*
+*`iid`*\ [in] A reference to the ID of the function. -*`dispidMember`*
+*`dispidMember`*\ [in] The dispatch ID of the function. -*`lcid`*
+*`lcid`*\ [in] The locale context of the function ID. -*`info`*
+*`info`*\ [in] The structure indicating how the function is called. ### Return Value @@ -187,10 +187,10 @@ VARTYPE GetUserDefinedType( ### Parameters -*`pTI`*
+*`pTI`*\ [in] A pointer to the [`ITypeInfo`](/windows/win32/api/oaidl/nn-oaidl-itypeinfo) interface containing the user-defined type. -*`hrt`*
+*`hrt`*\ [in] A handle to the type description to be retrieved. ### Return Value @@ -223,10 +223,10 @@ By default, the class is `CComTypeInfoHolder`. `CComTypeInfoHolder` manages the ## See also -[`_ATL_FUNC_INFO` Structure](../../atl/reference/atl-func-info-structure.md)
-[`IDispatchImpl` Class](../../atl/reference/idispatchimpl-class.md)
-[`IDispEventSimpleImpl` Class](../../atl/reference/idispeventsimpleimpl-class.md)
-[`SINK_ENTRY`](composite-control-macros.md#sink_entry)
-[`SINK_ENTRY_EX`](composite-control-macros.md#sink_entry_ex)
-[`SINK_ENTRY_INFO`](composite-control-macros.md#sink_entry_info)
+[`_ATL_FUNC_INFO` Structure](../../atl/reference/atl-func-info-structure.md)\ +[`IDispatchImpl` Class](../../atl/reference/idispatchimpl-class.md)\ +[`IDispEventSimpleImpl` Class](../../atl/reference/idispeventsimpleimpl-class.md)\ +[`SINK_ENTRY`](composite-control-macros.md#sink_entry)\ +[`SINK_ENTRY_EX`](composite-control-macros.md#sink_entry_ex)\ +[`SINK_ENTRY_INFO`](composite-control-macros.md#sink_entry_info)\ [Class Overview](../../atl/atl-class-overview.md) From 48670174a0316dc5af4578e6c6dbccd9e146639e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 17:57:27 +0800 Subject: [PATCH 0042/1799] Simplify all relative links in `IDispEventImpl` class reference --- docs/atl/reference/idispeventimpl-class.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index 1695cf7b80c..4ec29199cba 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -82,14 +82,14 @@ Add a [`SINK_ENTRY`](composite-control-macros.md#sink_entry) or [`SINK_ENTRY_EX` You must derive from `IDispEventImpl` (using a unique value for *`nID`*) for each object for which you need to handle events. You can reuse the base class by unadvising against one source object then advising against a different source object, but the maximum number of source objects that can be handled by a single object at one time is limited by the number of `IDispEventImpl` base classes. -`IDispEventImpl` provides the same functionality as [`IDispEventSimpleImpl`](../../atl/reference/idispeventsimpleimpl-class.md), except it gets type information about the interface from a type library rather than having it supplied as a pointer to an [`_ATL_FUNC_INFO`](../../atl/reference/atl-func-info-structure.md) structure. Use `IDispEventSimpleImpl` when you do not have a type library describing the event interface or want to avoid the overhead associated with using the type library. +`IDispEventImpl` provides the same functionality as [`IDispEventSimpleImpl`](idispeventsimpleimpl-class.md), except it gets type information about the interface from a type library rather than having it supplied as a pointer to an [`_ATL_FUNC_INFO`](atl-func-info-structure.md) structure. Use `IDispEventSimpleImpl` when you do not have a type library describing the event interface or want to avoid the overhead associated with using the type library. > [!NOTE] > `IDispEventImpl` and `IDispEventSimpleImpl` provide their own implementation of `IUnknown::QueryInterface` enabling each `IDispEventImpl` and `IDispEventSimpleImpl` base class to act as a separate COM identity while still allowing direct access to class members in your main COM object. CE ATL implementation of ActiveX event sinks only supports return values of type `HRESULT` or `void` from your event handler methods; any other return value is unsupported and its behavior is undefined. -For more information, see [Supporting `IDispEventImpl`](../../atl/supporting-idispeventimpl.md). +For more information, see [Supporting `IDispEventImpl`](../supporting-idispeventimpl.md). ## Inheritance Hierarchy @@ -97,7 +97,7 @@ For more information, see [Supporting `IDispEventImpl`](../../atl/supporting-idi `_IDispEventLocator` -[`IDispEventSimpleImpl`](../../atl/reference/idispeventsimpleimpl-class.md) +[`IDispEventSimpleImpl`](idispeventsimpleimpl-class.md) `IDispEventImpl` @@ -223,10 +223,10 @@ By default, the class is `CComTypeInfoHolder`. `CComTypeInfoHolder` manages the ## See also -[`_ATL_FUNC_INFO` Structure](../../atl/reference/atl-func-info-structure.md)\ -[`IDispatchImpl` Class](../../atl/reference/idispatchimpl-class.md)\ -[`IDispEventSimpleImpl` Class](../../atl/reference/idispeventsimpleimpl-class.md)\ +[`_ATL_FUNC_INFO` Structure](atl-func-info-structure.md)\ +[`IDispatchImpl` Class](idispatchimpl-class.md)\ +[`IDispEventSimpleImpl` Class](idispeventsimpleimpl-class.md)\ [`SINK_ENTRY`](composite-control-macros.md#sink_entry)\ [`SINK_ENTRY_EX`](composite-control-macros.md#sink_entry_ex)\ [`SINK_ENTRY_INFO`](composite-control-macros.md#sink_entry_info)\ -[Class Overview](../../atl/atl-class-overview.md) +[Class Overview](../atl-class-overview.md) From c1ee2b7d0dc638c0446528fecffa08a99c84aa8b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 17:58:22 +0800 Subject: [PATCH 0043/1799] Clean metadata for `IDispEventImpl` class reference --- docs/atl/reference/idispeventimpl-class.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index 4ec29199cba..ef54c3c7b5c 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: IDispEventImpl Class" title: "IDispEventImpl Class" -ms.date: "11/04/2016" +description: "Learn more about: IDispEventImpl Class" +ms.date: 11/04/2016 f1_keywords: ["IDispEventImpl", "ATLCOM/ATL::IDispEventImpl", "ATLCOM/ATL::IDispEventImpl::IDispEventImpl", "ATLCOM/ATL::IDispEventImpl::GetFuncInfoFromId", "ATLCOM/ATL::IDispEventImpl::GetIDsOfNames", "ATLCOM/ATL::IDispEventImpl::GetTypeInfo", "ATLCOM/ATL::IDispEventImpl::GetTypeInfoCount", "ATLCOM/ATL::IDispEventImpl::GetUserDefinedType"] helpviewer_keywords: ["IDispEventImpl class"] -ms.assetid: a64b5288-35cb-4638-aad6-2d15b1c7cf7b --- # `IDispEventImpl` Class From e48de078517099ad7adb15edf3103264606dfb19 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 18:50:56 +0800 Subject: [PATCH 0044/1799] Add links to "C++ standard library header files" topic --- .../standard-library/cpp-standard-library-header-files.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index 42ef673a990..ad813d52a9a 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -26,15 +26,15 @@ Header files for the C++ standard library and extensions, by category. | Container adaptors | [``](queue.md), [``](stack.md) | | Container views | [``](span.md)20 | | [Errors and exception handling](../cpp/errors-and-exception-handling-modern-cpp.md) | [``](cassert.md), [``](exception.md), [``](stdexcept.md), [``](system-error.md)11 | -| General utilities | ``17, [``](bit.md)20, [``](bitset.md), [``](cstdlib.md), ``17, [``](functional.md), [``](memory.md), ``17, ``17, [``](ratio.md)11, [``](scoped-allocator.md)11, [``](tuple.md)11, [``](type-traits.md)11, [``](typeindex.md)11, [``](utility.md), ``17 | +| General utilities | [``](any.md)17, [``](bit.md)20, [``](bitset.md), [``](cstdlib.md), [``](execution.md)17, [``](functional.md), [``](memory.md), [``](memory-resource.md)17, [``](optional.md)17, [``](ratio.md)11, [``](scoped-allocator.md)11, [``](tuple.md)11, [``](type-traits.md)11, [``](typeindex.md)11, [``](utility.md), [``](variant.md)17 | | [I/O and formatting](../text/string-and-i-o-formatting-modern-cpp.md) | [``](cinttypes.md)11, [``](cstdio.md), [``](filesystem.md)17, [``](fstream.md), [``](iomanip.md), [``](ios.md), [``](iosfwd.md), [``](iostream.md), [``](istream.md), [``](ostream.md), [``](sstream.md), [``](streambuf.md), [``](strstream.md)c, ``20 | | Iterators | [``](iterator.md) | | Language support | [``](cfloat.md), [``](climits.md), [``](codecvt.md)11 a, ``20, ``20, ``20, [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstddef.md), [``](cstdint.md)11, [``](cstdlib.md), [``](exception.md), [``](initializer-list.md)11, [``](limits.md), [``](new.md), [``](typeinfo.md), ``20 | | Localization | [``](clocale.md), [``](codecvt.md)11 a, [``](cvt-wbuffer.md), [``](cvt-wstring.md), [``](locale.md) | -| Math and numerics | ``20, [``](cfenv.md)11, [``](cmath.md), [``](complex.md), [``](cstdlib.md), [``](limits.md), [``](numeric.md), [``](random.md)11, [``](ratio.md)11, [``](valarray.md) | -| [Memory management](../cpp/smart-pointers-modern-cpp.md) | [``](allocators-header.md), [``](memory.md), ``17, [``](new.md), [``](scoped-allocator.md)11 | +| Math and numerics | [``](bit.md)20, [``](cfenv.md)11, [``](cmath.md), [``](complex.md), [``](cstdlib.md), [``](limits.md), [``](numeric.md), [``](random.md)11, [``](ratio.md)11, [``](valarray.md) | +| [Memory management](../cpp/smart-pointers-modern-cpp.md) | [``](allocators-header.md), [``](memory.md), [``](memory-resource.md)17, [``](new.md), [``](scoped-allocator.md)11 | | Multithreading | [``](atomic.md)11, [``](condition-variable.md)11, [``](future.md)11, [``](mutex.md)11, [``](shared-mutex.md)14, [``](thread.md)11 | -| Ranges | ``20 | +| Ranges | [``](ranges.md)20 | | Regular expressions | [``](regex.md)11 | | Strings and character data | [``](charconv.md)17, [``](cctype.md), [``](cstdlib.md), [``](cstring.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md), [``](regex.md)11, [``](string.md), [``](string-view.md)17 | | Time | [``](chrono.md)11, [``](ctime.md) | From 85ed24416bbc0c3bee6e66ad210e249a4bb37782 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 18:53:20 +0800 Subject: [PATCH 0045/1799] Elide redundant `./` link prefix in "C++ standard library header files" topic --- .../standard-library/cpp-standard-library-header-files.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index ad813d52a9a..396f5ea5d2f 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -15,11 +15,11 @@ Header files for the C++ standard library and extensions, by category. | Category | Headers | | - | - | -| [Algorithms](./algorithms.md) | [``](algorithm.md), [``](cstdlib.md), [``](numeric.md) | +| [Algorithms](algorithms.md) | [``](algorithm.md), [``](cstdlib.md), [``](numeric.md) | | Atomic operations | [``](atomic.md)11 | | C library wrappers | [``](cassert.md), [``](ccomplex.md)11 a b, [``](cctype.md), [``](cerrno.md), [``](cfenv.md)11, [``](cfloat.md), [``](cinttypes.md)11, [``](ciso646.md)b, [``](climits.md), [``](clocale.md), [``](cmath.md), [``](csetjmp.md), [``](csignal.md), [``](cstdalign.md)11 a b, [``](cstdarg.md), [``](cstdbool.md)11 a b, [``](cstddef.md), [``](cstdint.md)11, [``](cstdio.md), [``](cstdlib.md), [``](cstring.md), [``](ctgmath.md)11 a b, [``](ctime.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md) | | Concepts | ``20 | -| [Containers](./stl-containers.md) | | +| [Containers](stl-containers.md) | | | Sequence containers | [``](array.md)11, [``](deque.md), [``](forward-list.md)11, [``](list.md), [``](vector.md) | | Ordered associative containers| [``](map.md), [``](set.md) | | Unordered associative containers | [``](unordered-map.md)11, [``](unordered-set.md)11 | @@ -53,9 +53,9 @@ Header files for the C++ standard library and extensions, by category. |Category|Headers| |-|-| -|[Algorithms](./algorithms.md)|[``](algorithm.md)| +|[Algorithms](algorithms.md)|[``](algorithm.md)| |C library wrappers|[``](cassert.md), [``](cctype.md), [``](cerrno.md), [``](cfenv.md), [``](cfloat.md), [``](cinttypes.md), [``](ciso646.md), [``](climits.md), [``](clocale.md), [``](cmath.md), [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstdbool.md), [``](cstddef.md), [``](cstdint.md), [``](cstdio.md), [``](cstdlib.md), [``](cstring.md), [``](ctgmath.md), [``](ctime.md), [``](cwchar.md), [``](cwctype.md)| -|[Containers](./stl-containers.md)|| +|[Containers](stl-containers.md)|| |Sequence containers|[``](array.md), [``](deque.md), [``](forward-list.md), [``](list.md), [``](vector.md)| |Ordered associative containers| [``](map.md), [``](set.md)| |Unordered associative containers|[``](unordered-map.md), [``](unordered-set.md)| From 9bc72787bec3d86015e3368cdeb04b1589a83490 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 11 Jun 2025 18:54:53 +0800 Subject: [PATCH 0046/1799] Update metadata for "C++ standard library header files" topic --- docs/standard-library/cpp-standard-library-header-files.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index 396f5ea5d2f..a0eaf3e4630 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -1,9 +1,8 @@ --- title: "C++ standard library header files" description: "C++ standard library header files, categorized" -ms.date: "08/31/2020" +ms.date: 08/31/2020 helpviewer_keywords: ["header files, C++ Standard Library", "C++ Standard Library, header files"] -ms.assetid: e7bf497a-0f63-48d0-9b54-cb0eef4073c4 --- # C++ standard library header files From a3a7165441988f5d2a67cbe1f926b31941ec7eca Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 11 Jun 2025 14:46:54 -0700 Subject: [PATCH 0047/1799] Update cvt-wstring.md --- docs/standard-library/cvt-wstring.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/standard-library/cvt-wstring.md b/docs/standard-library/cvt-wstring.md index d8813833246..c2ca25ac7e7 100644 --- a/docs/standard-library/cvt-wstring.md +++ b/docs/standard-library/cvt-wstring.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["cvt/wstring header"] --- # `` -The header `` in previous versions of Visual Studio defined the class template [`wstring_convert`](../standard-library/wstring-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace +The header `` in previous versions of Visual Studio defined the class template [`wstring_convert`](wstring-convert-class.md) in the `stdext::cvt` namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [``](locale.md) in the `std` namespace. ## Syntax @@ -15,8 +15,6 @@ The header `` in previous versions of Visual Studio defined the cla #include ``` -## Requirements - ## See also [Header Files Reference](../standard-library/cpp-standard-library-header-files.md) From b4f13735dd3389ed4aa268edb5c1fbb917e3d348 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Thu, 12 Jun 2025 06:55:09 +0900 Subject: [PATCH 0048/1799] Fix typo: scaning -> scanning (#5398) I own this file. --- .../codesnippet/CPP/cmfctoolbarscustomizedialog-class_2.cpp | 2 +- .../codesnippet/CPP/cmfctoolbarscustomizedialog-class_3.cpp | 2 +- .../codesnippet/CPP/cmfctoolbarscustomizedialog-class_4.cpp | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_2.cpp b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_2.cpp index b6138fdf944..170c9fff5ed 100644 --- a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_2.cpp +++ b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_2.cpp @@ -1,5 +1,5 @@ CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this, - TRUE /* Automatic menus scaning */); + TRUE /* Automatic menus scanning */); CSliderButton btnSlider(ID_SLIDER); btnSlider.SetRange(0, 100); diff --git a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_3.cpp b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_3.cpp index bed3f475417..88446128e81 100644 --- a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_3.cpp +++ b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_3.cpp @@ -1,5 +1,5 @@ CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this, - TRUE /* Automatic menus scaning */, + TRUE /* Automatic menus scanning */, AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS | AFX_CUSTOMIZE_MENU_ANIMATIONS); diff --git a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_4.cpp b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_4.cpp index 78fa084d092..e01076e8ae9 100644 --- a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_4.cpp +++ b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_4.cpp @@ -1,5 +1,5 @@ CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this, - TRUE /* Automatic menus scaning */, + TRUE /* Automatic menus scanning */, AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS | AFX_CUSTOMIZE_MENU_ANIMATIONS, // default parameters &lstCustomPages); // pointer to the list of runtime classes of the custom property pages \ No newline at end of file From e254c9584d46aa1a6a1944f51be569ed35d07b4b Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Thu, 12 Jun 2025 18:58:19 +0900 Subject: [PATCH 0049/1799] Fix typo: multidimension -> multidimensional --- docs/dotnet/how-to-use-arrays-in-cpp-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dotnet/how-to-use-arrays-in-cpp-cli.md b/docs/dotnet/how-to-use-arrays-in-cpp-cli.md index 14f17299db7..6bdeba25b06 100644 --- a/docs/dotnet/how-to-use-arrays-in-cpp-cli.md +++ b/docs/dotnet/how-to-use-arrays-in-cpp-cli.md @@ -221,7 +221,7 @@ public: }; int main() { - // Aggregate initialize a multidimension managed array. + // Aggregate initialize a multidimensional managed array. array^ gc1 = gcnew array{ {"one", "two"}, {"three", "four"} }; array^ gc2 = { {"one", "two"}, {"three", "four"} }; From 580858eb3a28ce0f1844d6ca68f527da2db386ee Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 12 Jun 2025 23:40:16 +0800 Subject: [PATCH 0050/1799] Remove redundant semicolons after `if`, `for`, `while`, and `switch` constructs --- docs/atl-mfc-shared/codesnippet/CPP/cstringt-class_39.cpp | 2 +- docs/cpp/switch-statement-cpp.md | 2 +- docs/cpp/try-except-statement.md | 2 +- docs/cppcx/codesnippet/CPP/cppcx_strings/class1.cpp | 6 +++--- .../compiler-warnings/compiler-warning-level-4-c4220.md | 2 +- docs/mfc/codesnippet/CPP/cdialog-class_2.cpp | 2 +- docs/standard-library/ctype-class.md | 2 +- docs/standard-library/ios-base-class.md | 4 ++-- docs/standard-library/iterator-traits-struct.md | 2 +- .../other-one-argument-output-stream-manipulators.md | 2 +- ...put-stream-manipulators-with-one-argument-int-or-long.md | 2 +- docs/standard-library/raw-storage-iterator-class.md | 2 +- 12 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/atl-mfc-shared/codesnippet/CPP/cstringt-class_39.cpp b/docs/atl-mfc-shared/codesnippet/CPP/cstringt-class_39.cpp index d2b2eb6cf39..8886e69d9f7 100644 --- a/docs/atl-mfc-shared/codesnippet/CPP/cstringt-class_39.cpp +++ b/docs/atl-mfc-shared/codesnippet/CPP/cstringt-class_39.cpp @@ -8,4 +8,4 @@ { _tprintf_s(_T("Resulting token: %s\n"), resToken); resToken = str.Tokenize(_T("% #"), curPos); - }; \ No newline at end of file + } \ No newline at end of file diff --git a/docs/cpp/switch-statement-cpp.md b/docs/cpp/switch-statement-cpp.md index 21afd60347f..82b5803dc33 100644 --- a/docs/cpp/switch-statement-cpp.md +++ b/docs/cpp/switch-statement-cpp.md @@ -117,7 +117,7 @@ int main() break; case status::bad: throw BadGadget(); - }; + } ``` An inner block of a **`switch`** statement can contain definitions with initializers as long as they're *reachable*, that is, not bypassed by all possible execution paths. Names introduced using these declarations have local scope. For example: diff --git a/docs/cpp/try-except-statement.md b/docs/cpp/try-except-statement.md index cb344b682e9..c2661dbe213 100644 --- a/docs/cpp/try-except-statement.md +++ b/docs/cpp/try-except-statement.md @@ -115,7 +115,7 @@ int filter(unsigned int code, struct _EXCEPTION_POINTERS *ep) { puts("didn't catch AV, unexpected."); return EXCEPTION_CONTINUE_SEARCH; - }; + } } int main() diff --git a/docs/cppcx/codesnippet/CPP/cppcx_strings/class1.cpp b/docs/cppcx/codesnippet/CPP/cppcx_strings/class1.cpp index cdc05a2c214..654cf20fe9e 100644 --- a/docs/cppcx/codesnippet/CPP/cppcx_strings/class1.cpp +++ b/docs/cppcx/codesnippet/CPP/cppcx_strings/class1.cpp @@ -55,11 +55,11 @@ void Test1() if (str1 == str2) { /* ... */ } if (str1->Equals(str2)) { /* ... */ } if (str1 != str2) { /* ... */ } - if (str1 < str2 || str1 > str2) { /* ... */}; + if (str1 < str2 || str1 > str2) { /* ... */ } int result = String::CompareOrdinal(str1, str2); - if(str1 == nullptr) { /* ...*/}; - if(str1->IsEmpty()) { /* ...*/}; + if (str1 == nullptr) { /* ...*/ } + if (str1->IsEmpty()) { /* ...*/ } // Accessing individual characters in a String^ auto it = str1->Begin(); diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md index bf894af5583..57e0ce98835 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md @@ -23,7 +23,7 @@ int ( *pFunc2) ( int a, int b); int main() { - if ( pFunc1 != pFunc2 ) {}; // C4220 + if ( pFunc1 != pFunc2 ) {} // C4220 } ``` diff --git a/docs/mfc/codesnippet/CPP/cdialog-class_2.cpp b/docs/mfc/codesnippet/CPP/cdialog-class_2.cpp index 3c7a6357e16..e3100864ebd 100644 --- a/docs/mfc/codesnippet/CPP/cdialog-class_2.cpp +++ b/docs/mfc/codesnippet/CPP/cdialog-class_2.cpp @@ -26,5 +26,5 @@ void CMyDialog::OnMenuShowAboutDialog() default: // Do something break; - }; + } } \ No newline at end of file diff --git a/docs/standard-library/ctype-class.md b/docs/standard-library/ctype-class.md index 1836e4e654a..4d69b959369 100644 --- a/docs/standard-library/ctype-class.md +++ b/docs/standard-library/ctype-class.md @@ -466,7 +466,7 @@ int main() { << (maskarray[i] & ctype_base::alpha "alpha" : "not alpha") << endl; - }; + } } ``` diff --git a/docs/standard-library/ios-base-class.md b/docs/standard-library/ios-base-class.md index c8e5762d83e..f84b995bda4 100644 --- a/docs/standard-library/ios-base-class.md +++ b/docs/standard-library/ios-base-class.md @@ -665,7 +665,7 @@ void callback1( ios_base::event e, ios_base& stream, int arg ) case ios_base::copyfmt_event: cout << "an copyfmt event" << endl; break; - }; + } } void callback2( ios_base::event e, ios_base& stream, int arg ) @@ -682,7 +682,7 @@ void callback2( ios_base::event e, ios_base& stream, int arg ) case ios_base::copyfmt_event: cout << "an copyfmt event" << endl; break; - }; + } } int main( ) diff --git a/docs/standard-library/iterator-traits-struct.md b/docs/standard-library/iterator-traits-struct.md index 4ad621f7742..2d06a2a5475 100644 --- a/docs/standard-library/iterator-traits-struct.md +++ b/docs/standard-library/iterator-traits-struct.md @@ -88,7 +88,7 @@ function( it i1, it i2 ) x = *i1; cout << x << " "; i1++; - }; + } cout << endl; }; diff --git a/docs/standard-library/other-one-argument-output-stream-manipulators.md b/docs/standard-library/other-one-argument-output-stream-manipulators.md index 0807ff915eb..e99d6839365 100644 --- a/docs/standard-library/other-one-argument-output-stream-manipulators.md +++ b/docs/standard-library/other-one-argument-output-stream-manipulators.md @@ -51,7 +51,7 @@ void fb( ios_base& os, char * somename ) { for( int i=0; i < l; i++ ) (*pos) << ' '; - }; + } */ } diff --git a/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md b/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md index 1c3cb51e5e9..5a5eb8dfca4 100644 --- a/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md +++ b/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md @@ -25,7 +25,7 @@ void fb( ios_base& os, int l ) { for( int i=0; i < l; i++ ) (*pos) << ' '; - }; + } } _Smanip diff --git a/docs/standard-library/raw-storage-iterator-class.md b/docs/standard-library/raw-storage-iterator-class.md index 0e625fb1ed9..195b79a1f60 100644 --- a/docs/standard-library/raw-storage-iterator-class.md +++ b/docs/standard-library/raw-storage-iterator-class.md @@ -261,7 +261,7 @@ int main( void ) std::raw_storage_iterator it( pInt ); for ( int i = 0; i < 5; i++, it++ ) { *it = 2 * i; - }; + } for ( int i = 0; i < 5; i++ ) cout << "array " << i << " = " << pInt[i] << endl; From 1b5dc56bbc37c43ac22711c20b655490618f618f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 12 Jun 2025 23:41:53 +0800 Subject: [PATCH 0051/1799] Update metadata for a couple of articles --- docs/cpp/switch-statement-cpp.md | 3 +-- docs/cpp/try-except-statement.md | 1 - .../compiler-warnings/compiler-warning-level-4-c4220.md | 5 ++--- docs/standard-library/iterator-traits-struct.md | 2 +- .../other-one-argument-output-stream-manipulators.md | 5 ++--- ...tput-stream-manipulators-with-one-argument-int-or-long.md | 5 ++--- 6 files changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/cpp/switch-statement-cpp.md b/docs/cpp/switch-statement-cpp.md index 82b5803dc33..321b32fa4ca 100644 --- a/docs/cpp/switch-statement-cpp.md +++ b/docs/cpp/switch-statement-cpp.md @@ -1,11 +1,10 @@ --- title: "switch statement (C++)" description: "Reference to the Standard C++ switch statement in Microsoft Visual Studio C++." -ms.date: "04/25/2020" +ms.date: 04/25/2020 f1_keywords: ["default_cpp", "switch_cpp", "case_cpp"] helpviewer_keywords: ["switch keyword [C++]", "case keyword [C++], in switch statements", "default keyword [C++]"] no-loc: [switch, case, default, break, while, opt] -ms.assetid: 6c3f3ed3-5593-463c-8f4b-b33742b455c6 --- # `switch` statement (C++) diff --git a/docs/cpp/try-except-statement.md b/docs/cpp/try-except-statement.md index c2661dbe213..451aed3b2a8 100644 --- a/docs/cpp/try-except-statement.md +++ b/docs/cpp/try-except-statement.md @@ -4,7 +4,6 @@ description: "The Microsoft C++ reference to the __try and __except structured e ms.date: 08/25/2020 f1_keywords: ["_abnormal_termination_cpp", "_exception_code_cpp", "_exception_info", "__except", "_except", "_exception_code", "__except_cpp", "_exception_info_cpp"] helpviewer_keywords: ["__try keyword [C++]", "EXCEPTION_CONTINUE_EXECUTION macro", "EXCEPTION_CONTINUE_SEARCH macro", "EXCEPTION_EXECUTE_HANDLER macro", "GetExceptionCode function", "try-catch keyword [C++], try-except keyword [C++]", "_exception_code keyword [C++]", "try-except keyword [C++]", "_exception_info keyword [C++]", "_abnormal_termination keyword [C++]"] -ms.assetid: 30d60071-ea49-4bfb-a8e6-7a420de66381 --- # `try-except` statement diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md index 57e0ce98835..dd344270a6b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4220" title: "Compiler Warning (level 4) C4220" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4220" +ms.date: 11/04/2016 f1_keywords: ["C4220"] helpviewer_keywords: ["C4220"] -ms.assetid: aba18868-825f-4763-9af6-3296406a80e4 --- # Compiler Warning (level 4) C4220 diff --git a/docs/standard-library/iterator-traits-struct.md b/docs/standard-library/iterator-traits-struct.md index 2d06a2a5475..b47a2146074 100644 --- a/docs/standard-library/iterator-traits-struct.md +++ b/docs/standard-library/iterator-traits-struct.md @@ -1,7 +1,7 @@ --- title: "iterator_traits Struct" description: "Learn more about: iterator_traits Struct" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["xutility/std::iterator_traits"] helpviewer_keywords: ["iterator_traits struct", "iterator_traits class"] --- diff --git a/docs/standard-library/other-one-argument-output-stream-manipulators.md b/docs/standard-library/other-one-argument-output-stream-manipulators.md index e99d6839365..8495a513707 100644 --- a/docs/standard-library/other-one-argument-output-stream-manipulators.md +++ b/docs/standard-library/other-one-argument-output-stream-manipulators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Other One-Argument Output Stream Manipulators" title: "Other One-Argument Output Stream Manipulators" -ms.date: "11/04/2016" +description: "Learn more about: Other One-Argument Output Stream Manipulators" +ms.date: 11/04/2016 helpviewer_keywords: ["output streams, one-argument manipulators"] -ms.assetid: e381dee8-6b16-4cef-805a-4a6a1d2b696b --- # Other One-Argument Output Stream Manipulators diff --git a/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md b/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md index 5a5eb8dfca4..ee87da5f214 100644 --- a/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md +++ b/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Output Stream Manipulators with One Argument (int or long)" title: "Output Stream Manipulators with One Argument (int or long)" -ms.date: "11/04/2016" +description: "Learn more about: Output Stream Manipulators with One Argument (int or long)" +ms.date: 11/04/2016 helpviewer_keywords: ["output streams, int or long argument manipulators"] -ms.assetid: 338f3164-b5e2-4c5a-a605-7d9dc3629ca1 --- # Output Stream Manipulators with One Argument (int or long) From e82e3201ae35f85e936a4542325a223348b9c6f3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 13 Jun 2025 00:19:14 +0800 Subject: [PATCH 0052/1799] Resolve various errors in reference syntax --- docs/atl/reference/ccomcurrency-class.md | 2 +- docs/atl/reference/cthreadpool-class.md | 2 +- docs/c-runtime-library/lock.md | 2 +- docs/c-runtime-library/reference/crtreportblocktype.md | 2 +- docs/c-runtime-library/reference/fwide.md | 2 +- docs/cppcx/platform-collections-map-class.md | 2 +- docs/cppcx/wrl/module-class.md | 2 +- docs/mfc/reference/cmfcpropertygridproperty-class.md | 2 +- docs/standard-library/hash-map-class.md | 2 +- docs/standard-library/hash-multiset-class.md | 4 ++-- docs/standard-library/memory-operators.md | 4 ++-- docs/standard-library/string-functions.md | 3 +-- 12 files changed, 14 insertions(+), 15 deletions(-) diff --git a/docs/atl/reference/ccomcurrency-class.md b/docs/atl/reference/ccomcurrency-class.md index b51cb2e04a2..22b5f6e18cd 100644 --- a/docs/atl/reference/ccomcurrency-class.md +++ b/docs/atl/reference/ccomcurrency-class.md @@ -563,7 +563,7 @@ Returns a reference to a `CURRENCY` object. Call this method to round the currency to a specified number of decimal places. ```cpp -HRESULT Roundint nDecimals); +HRESULT Round(int nDecimals); ``` ### Parameters diff --git a/docs/atl/reference/cthreadpool-class.md b/docs/atl/reference/cthreadpool-class.md index e5834d8409c..63968ba10c3 100644 --- a/docs/atl/reference/cthreadpool-class.md +++ b/docs/atl/reference/cthreadpool-class.md @@ -265,7 +265,7 @@ This class does not implement lifetime control using reference counting. Call this method to set the number of threads in the pool. ``` -HRESULT STDMETHODCALLTYPE SetSizeint nNumThreads) throw(); +HRESULT STDMETHODCALLTYPE SetSize(int nNumThreads) throw(); ``` ### Parameters diff --git a/docs/c-runtime-library/lock.md b/docs/c-runtime-library/lock.md index e9f4e94fa0f..9250194ebc9 100644 --- a/docs/c-runtime-library/lock.md +++ b/docs/c-runtime-library/lock.md @@ -20,7 +20,7 @@ Acquires a multi-thread lock. ## Syntax ```cpp -void __cdecl _lock +void __cdecl _lock( int locknum ); ``` diff --git a/docs/c-runtime-library/reference/crtreportblocktype.md b/docs/c-runtime-library/reference/crtreportblocktype.md index 48220ad606b..5ce51cd4454 100644 --- a/docs/c-runtime-library/reference/crtreportblocktype.md +++ b/docs/c-runtime-library/reference/crtreportblocktype.md @@ -19,7 +19,7 @@ Returns the block type/subtype associated with a given debug heap block pointer. ```C int _CrtReportBlockType( const void * pBlock -}; +); ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fwide.md b/docs/c-runtime-library/reference/fwide.md index f21511e1069..9a1e72deb93 100644 --- a/docs/c-runtime-library/reference/fwide.md +++ b/docs/c-runtime-library/reference/fwide.md @@ -19,7 +19,7 @@ Unimplemented. ```C int fwide( FILE *stream, - int mode; + int mode ); ``` diff --git a/docs/cppcx/platform-collections-map-class.md b/docs/cppcx/platform-collections-map-class.md index 21b981e5f6e..2353048890c 100644 --- a/docs/cppcx/platform-collections-map-class.md +++ b/docs/cppcx/platform-collections-map-class.md @@ -206,7 +206,7 @@ Initializes a new instance of the Map class. ```cpp explicit Map(const C& comp = C()); explicit Map(const StdMap& m); -explicit Map(StdMap&& m ; +explicit Map(StdMap&& m); template Map( InItfirst, diff --git a/docs/cppcx/wrl/module-class.md b/docs/cppcx/wrl/module-class.md index e228f5e864c..cdaf2af9ebe 100644 --- a/docs/cppcx/wrl/module-class.md +++ b/docs/cppcx/wrl/module-class.md @@ -396,7 +396,7 @@ Unregisters one or more COM objects, which prevents other applications from conn virtual HRESULT UnregisterCOMObject( const wchar_t* serverName, DWORD* cookies, - unsigned int count + unsigned int count); ``` ### Parameters diff --git a/docs/mfc/reference/cmfcpropertygridproperty-class.md b/docs/mfc/reference/cmfcpropertygridproperty-class.md index 968b051e6db..56587dc6964 100644 --- a/docs/mfc/reference/cmfcpropertygridproperty-class.md +++ b/docs/mfc/reference/cmfcpropertygridproperty-class.md @@ -1259,7 +1259,7 @@ This method supports the following variant types: `VT_INT`, `VT_I2`, `VT_I4`, `V ## `CMFCPropertyGridProperty::OnSetSelection` ```cpp -virtual void OnSetSelection CMFCPropertyGridProperty*); +virtual void OnSetSelection(CMFCPropertyGridProperty*); ``` ### Parameters diff --git a/docs/standard-library/hash-map-class.md b/docs/standard-library/hash-map-class.md index 6185f281559..61f681bca07 100644 --- a/docs/standard-library/hash-map-class.md +++ b/docs/standard-library/hash-map-class.md @@ -516,7 +516,7 @@ The data value of the first element in the hash_map is 10. A type that provides a bidirectional iterator that can read any **`const`** element in the `hash_map`. ```cpp -typedef list::const_reverse)iterator const_reverse_iterator; +typedef list::const_reverse_iterator const_reverse_iterator; ``` ### Remarks diff --git a/docs/standard-library/hash-multiset-class.md b/docs/standard-library/hash-multiset-class.md index c99106c54a2..7b40ba26239 100644 --- a/docs/standard-library/hash-multiset-class.md +++ b/docs/standard-library/hash-multiset-class.md @@ -1294,11 +1294,11 @@ hash_multiset( hash_multiset( hash_multiset&& Right -}; +); hash_multiset (initializer_list IList); hash_multiset( - initializer_list IList, const Compare& Comp): + initializer_list IList, const Compare& Comp): hash_multiset( initializer_list IList, const Compare& Comp, const Allocator& Al); diff --git a/docs/standard-library/memory-operators.md b/docs/standard-library/memory-operators.md index 0ae10aa886c..b3f8e47d828 100644 --- a/docs/standard-library/memory-operators.md +++ b/docs/standard-library/memory-operators.md @@ -127,7 +127,7 @@ bool operator==( template bool operator==( - const shared_ptr& left;, + const shared_ptr& left, const shared_ptr& right); ``` @@ -330,7 +330,7 @@ Tests for one object being greater than a second object. template bool operator>( const unique_ptr& left, - const unique_ptr& right); template bool operator>( diff --git a/docs/standard-library/string-functions.md b/docs/standard-library/string-functions.md index 668653d6fa2..4639cb1764b 100644 --- a/docs/standard-library/string-functions.md +++ b/docs/standard-library/string-functions.md @@ -132,8 +132,7 @@ double stod( double stod( const wstring& str, - size_t* idx = 0 -; + size_t* idx = 0); ``` ### Parameters From 6f7fb421be53e7a818666615998e3652f23866d8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 13 Jun 2025 00:21:32 +0800 Subject: [PATCH 0053/1799] Clean up metadata in a bunch of topics --- docs/atl/reference/ccomcurrency-class.md | 5 ++--- docs/atl/reference/cthreadpool-class.md | 5 ++--- docs/c-runtime-library/lock.md | 5 ++--- docs/c-runtime-library/reference/crtreportblocktype.md | 5 ++--- docs/c-runtime-library/reference/fwide.md | 5 ++--- docs/cppcx/platform-collections-map-class.md | 5 ++--- docs/cppcx/wrl/module-class.md | 5 ++--- docs/mfc/reference/cmfcpropertygridproperty-class.md | 2 +- docs/standard-library/memory-operators.md | 5 ++--- 9 files changed, 17 insertions(+), 25 deletions(-) diff --git a/docs/atl/reference/ccomcurrency-class.md b/docs/atl/reference/ccomcurrency-class.md index 22b5f6e18cd..cee7bfd016c 100644 --- a/docs/atl/reference/ccomcurrency-class.md +++ b/docs/atl/reference/ccomcurrency-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CComCurrency Class" title: "CComCurrency Class" -ms.date: "11/04/2016" +description: "Learn more about: CComCurrency Class" +ms.date: 11/04/2016 f1_keywords: ["CComCurrency", "ATLCUR/ATL::CComCurrency", "ATLCUR/ATL::CComCurrency::CComCurrency", "ATLCUR/ATL::CComCurrency::GetCurrencyPtr", "ATLCUR/ATL::CComCurrency::GetFraction", "ATLCUR/ATL::CComCurrency::GetInteger", "ATLCUR/ATL::CComCurrency::Round", "ATLCUR/ATL::CComCurrency::SetFraction", "ATLCUR/ATL::CComCurrency::SetInteger", "ATLCUR/ATL::CComCurrency::m_currency"] helpviewer_keywords: ["CComCurrency class"] -ms.assetid: a1c3d10a-bba6-40cc-8bcf-aed9023c8a9e --- # `CComCurrency` Class diff --git a/docs/atl/reference/cthreadpool-class.md b/docs/atl/reference/cthreadpool-class.md index 63968ba10c3..0cca6b473fa 100644 --- a/docs/atl/reference/cthreadpool-class.md +++ b/docs/atl/reference/cthreadpool-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CThreadPool Class" title: "CThreadPool Class" -ms.date: "11/04/2016" +description: "Learn more about: CThreadPool Class" +ms.date: 11/04/2016 f1_keywords: ["CThreadPool", "ATLUTIL/ATL::CThreadPool", "ATLUTIL/ATL::CThreadPool::CThreadPool", "ATLUTIL/ATL::CThreadPool::AddRef", "ATLUTIL/ATL::CThreadPool::GetNumThreads", "ATLUTIL/ATL::CThreadPool::GetQueueHandle", "ATLUTIL/ATL::CThreadPool::GetSize", "ATLUTIL/ATL::CThreadPool::GetTimeout", "ATLUTIL/ATL::CThreadPool::Initialize", "ATLUTIL/ATL::CThreadPool::QueryInterface", "ATLUTIL/ATL::CThreadPool::QueueRequest", "ATLUTIL/ATL::CThreadPool::Release", "ATLUTIL/ATL::CThreadPool::SetSize", "ATLUTIL/ATL::CThreadPool::SetTimeout", "ATLUTIL/ATL::CThreadPool::Shutdown"] helpviewer_keywords: ["CThreadPool class"] -ms.assetid: 06683718-01b9-413c-9481-2dc1734ec70f --- # CThreadPool Class diff --git a/docs/c-runtime-library/lock.md b/docs/c-runtime-library/lock.md index 9250194ebc9..19562f13ef8 100644 --- a/docs/c-runtime-library/lock.md +++ b/docs/c-runtime-library/lock.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _lock" title: "_lock" -ms.date: "11/04/2016" +description: "Learn more about: _lock" +ms.date: 11/04/2016 api_name: ["_lock"] api_location: ["msvcr110_clr0400.dll", "msvcr120.dll", "msvcr100.dll", "msvcr90.dll", "msvcr80.dll", "msvcr110.dll", "msvcrt.dll", "msvcr120_clr0400.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_lock"] helpviewer_keywords: ["lock function", "_lock function"] -ms.assetid: 29f77c37-30de-4b3d-91b6-030216e645a6 --- # `_lock` diff --git a/docs/c-runtime-library/reference/crtreportblocktype.md b/docs/c-runtime-library/reference/crtreportblocktype.md index 5ce51cd4454..e9c58f7c24a 100644 --- a/docs/c-runtime-library/reference/crtreportblocktype.md +++ b/docs/c-runtime-library/reference/crtreportblocktype.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _CrtReportBlockType" title: "_CrtReportBlockType" -ms.date: "11/04/2016" +description: "Learn more about: _CrtReportBlockType" +ms.date: 11/04/2016 api_name: ["_CrtReportBlockType"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_CrtReportBlockType", "CrtReportBlockType"] helpviewer_keywords: ["CrtReportBlockType function", "BLOCK_SUBTYPE macro", "_CrtReportBlockType function", "_BLOCK_TYPE macro", "_BLOCK_SUBTYPE macro", "BLOCK_TYPE macro"] -ms.assetid: 0f4b9da7-bebb-4956-9541-b2581640ec6b --- # `_CrtReportBlockType` diff --git a/docs/c-runtime-library/reference/fwide.md b/docs/c-runtime-library/reference/fwide.md index 9a1e72deb93..71113cfe487 100644 --- a/docs/c-runtime-library/reference/fwide.md +++ b/docs/c-runtime-library/reference/fwide.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: fwide" title: "fwide" -ms.date: "11/04/2016" +description: "Learn more about: fwide" +ms.date: 11/04/2016 api_name: ["fwide"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["fwide"] helpviewer_keywords: ["fwide function"] -ms.assetid: a4641f5b-d74f-4946-95d5-53a64610d28d --- # `fwide` diff --git a/docs/cppcx/platform-collections-map-class.md b/docs/cppcx/platform-collections-map-class.md index 2353048890c..473101cef06 100644 --- a/docs/cppcx/platform-collections-map-class.md +++ b/docs/cppcx/platform-collections-map-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::Collections::Map Class" title: "Platform::Collections::Map Class" -ms.date: "10/01/2019" +description: "Learn more about: Platform::Collections::Map Class" +ms.date: 10/01/2019 ms.topic: "reference" f1_keywords: ["COLLECTION/Platform::Collections::Map::Map", "COLLECTION/Platform::Collections::Map::Clear", "COLLECTION/Platform::Collections::Map::First", "COLLECTION/Platform::Collections::Map::GetView", "COLLECTION/Platform::Collections::Map::HasKey", "COLLECTION/Platform::Collections::Map::Insert", "COLLECTION/Platform::Collections::Map::Lookup", "COLLECTION/Platform::Collections::Map::Remove", "COLLECTION/Platform::Collections::Map::Size"] helpviewer_keywords: ["Map Class (C++/Cx)"] -ms.assetid: 2b8cf968-1167-4898-a149-1195b32c1785 --- # Platform::Collections::Map Class diff --git a/docs/cppcx/wrl/module-class.md b/docs/cppcx/wrl/module-class.md index cdaf2af9ebe..3cefc4e6d76 100644 --- a/docs/cppcx/wrl/module-class.md +++ b/docs/cppcx/wrl/module-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Module Class" title: "Module Class" -ms.date: "10/18/2018" +description: "Learn more about: Module Class" +ms.date: 10/18/2018 ms.topic: "reference" f1_keywords: ["module/Microsoft::WRL::Module", "module/Microsoft::WRL::Module::Create", "module/Microsoft::WRL::Module::DecrementObjectCount", "module/Microsoft::WRL::Module::GetActivationFactory", "module/Microsoft::WRL::Module::GetClassObject", "module/Microsoft::WRL::Module::GetModule", "module/Microsoft::WRL::Module::GetObjectCount", "module/Microsoft::WRL::Module::IncrementObjectCount", "module/Microsoft::WRL::Module::Module", "module/Microsoft::WRL::Module::objectCount_Data", "module/Microsoft::WRL::Module::RegisterCOMObject", "module/Microsoft::WRL::Module::RegisterObjects", "module/Microsoft::WRL::Module::RegisterWinRTObject", "module/Microsoft::WRL::Module::releaseNotifier_", "module/Microsoft::WRL::Module::Terminate", "module/Microsoft::WRL::Module::~Module", "module/Microsoft::WRL::Module::UnregisterCOMObject", "module/Microsoft::WRL::Module::UnregisterObjects", "module/Microsoft::WRL::Module::UnregisterWinRTObject"] helpviewer_keywords: ["Microsoft::WRL::Module class", "Microsoft::WRL::Module::Create method", "Microsoft::WRL::Module::DecrementObjectCount method", "Microsoft::WRL::Module::GetActivationFactory method", "Microsoft::WRL::Module::GetClassObject method", "Microsoft::WRL::Module::GetModule method", "Microsoft::WRL::Module::GetObjectCount method", "Microsoft::WRL::Module::IncrementObjectCount method", "Microsoft::WRL::Module::Module, constructor", "Microsoft::WRL::Module::objectCount_ data member", "Microsoft::WRL::Module::RegisterCOMObject method", "Microsoft::WRL::Module::RegisterObjects method", "Microsoft::WRL::Module::RegisterWinRTObject method", "Microsoft::WRL::Module::releaseNotifier_ data member", "Microsoft::WRL::Module::Terminate method", "Microsoft::WRL::Module::~Module, destructor", "Microsoft::WRL::Module::UnregisterCOMObject method", "Microsoft::WRL::Module::UnregisterObjects method", "Microsoft::WRL::Module::UnregisterWinRTObject method"] -ms.assetid: dd67e3b8-c2e1-4f53-8c0f-565a140ba649 --- # Module Class diff --git a/docs/mfc/reference/cmfcpropertygridproperty-class.md b/docs/mfc/reference/cmfcpropertygridproperty-class.md index 56587dc6964..8bf3752df36 100644 --- a/docs/mfc/reference/cmfcpropertygridproperty-class.md +++ b/docs/mfc/reference/cmfcpropertygridproperty-class.md @@ -1,7 +1,7 @@ --- title: "CMFCPropertyGridProperty class" description: "Learn more about: CMFCPropertyGridProperty class" -ms.date: "10/12/2022" +ms.date: 10/12/2022 f1_keywords: ["CMFCPropertyGridProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::CMFCPropertyGridProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AddOption", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AddSubItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AdjustButtonRect", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AdjustInPlaceEditRect", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AllowEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::CreateInPlaceEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::CreateSpinControl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Enable", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::EnableSpinControl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Expand", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::FormatProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetData", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetDescription", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetExpandedSubItems", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetHierarchyLevel", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetNameTooltip", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetOption", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetOptionCount", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetOriginalValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetParent", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetRect", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetSubItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetSubItemsCount", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetValueTooltip", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::HitTest", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsAllowEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsEnabled", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsExpanded", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsGroup", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsInPlaceEditing", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsModified", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsParentExpanded", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsSelected", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsVisible", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnClickButton", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnClickName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnClickValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnCloseCombo", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDblClk", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawButton", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawDescription", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawExpandBox", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnEndEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnKillSelection", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnPosSizeChanged", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnRClickName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnRClickValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnSelectCombo", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnSetCursor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnSetSelection", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnUpdateValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::PushChar", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Redraw", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::RemoveAllOptions", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::RemoveSubItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::ResetOriginalValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetData", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetDescription", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetOriginalValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Show", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::CreateCombo", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::HasButton", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Init", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsSubItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsValueChanged", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnCtlColor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDestroyWindow", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnKillFocus", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::m_strFormatDouble", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::m_strFormatFloat", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::m_strFormatLong", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::m_strFormatShort"] helpviewer_keywords: ["CMFCPropertyGridProperty [MFC], CMFCPropertyGridProperty", "CMFCPropertyGridProperty [MFC], AddOption", "CMFCPropertyGridProperty [MFC], AddSubItem", "CMFCPropertyGridProperty [MFC], AdjustButtonRect", "CMFCPropertyGridProperty [MFC], AdjustInPlaceEditRect", "CMFCPropertyGridProperty [MFC], AllowEdit", "CMFCPropertyGridProperty [MFC], CreateInPlaceEdit", "CMFCPropertyGridProperty [MFC], CreateSpinControl", "CMFCPropertyGridProperty [MFC], Enable", "CMFCPropertyGridProperty [MFC], EnableSpinControl", "CMFCPropertyGridProperty [MFC], Expand", "CMFCPropertyGridProperty [MFC], FormatProperty", "CMFCPropertyGridProperty [MFC], GetData", "CMFCPropertyGridProperty [MFC], GetDescription", "CMFCPropertyGridProperty [MFC], GetExpandedSubItems", "CMFCPropertyGridProperty [MFC], GetHierarchyLevel", "CMFCPropertyGridProperty [MFC], GetName", "CMFCPropertyGridProperty [MFC], GetNameTooltip", "CMFCPropertyGridProperty [MFC], GetOption", "CMFCPropertyGridProperty [MFC], GetOptionCount", "CMFCPropertyGridProperty [MFC], GetOriginalValue", "CMFCPropertyGridProperty [MFC], GetParent", "CMFCPropertyGridProperty [MFC], GetRect", "CMFCPropertyGridProperty [MFC], GetSubItem", "CMFCPropertyGridProperty [MFC], GetSubItemsCount", "CMFCPropertyGridProperty [MFC], GetValue", "CMFCPropertyGridProperty [MFC], GetValueTooltip", "CMFCPropertyGridProperty [MFC], HitTest", "CMFCPropertyGridProperty [MFC], IsAllowEdit", "CMFCPropertyGridProperty [MFC], IsEnabled", "CMFCPropertyGridProperty [MFC], IsExpanded", "CMFCPropertyGridProperty [MFC], IsGroup", "CMFCPropertyGridProperty [MFC], IsInPlaceEditing", "CMFCPropertyGridProperty [MFC], IsModified", "CMFCPropertyGridProperty [MFC], IsParentExpanded", "CMFCPropertyGridProperty [MFC], IsSelected", "CMFCPropertyGridProperty [MFC], IsVisible", "CMFCPropertyGridProperty [MFC], OnClickButton", "CMFCPropertyGridProperty [MFC], OnClickName", "CMFCPropertyGridProperty [MFC], OnClickValue", "CMFCPropertyGridProperty [MFC], OnCloseCombo", "CMFCPropertyGridProperty [MFC], OnDblClk", "CMFCPropertyGridProperty [MFC], OnDrawButton", "CMFCPropertyGridProperty [MFC], OnDrawDescription", "CMFCPropertyGridProperty [MFC], OnDrawExpandBox", "CMFCPropertyGridProperty [MFC], OnDrawName", "CMFCPropertyGridProperty [MFC], OnDrawValue", "CMFCPropertyGridProperty [MFC], OnEdit", "CMFCPropertyGridProperty [MFC], OnEndEdit", "CMFCPropertyGridProperty [MFC], OnKillSelection", "CMFCPropertyGridProperty [MFC], OnPosSizeChanged", "CMFCPropertyGridProperty [MFC], OnRClickName", "CMFCPropertyGridProperty [MFC], OnRClickValue", "CMFCPropertyGridProperty [MFC], OnSelectCombo", "CMFCPropertyGridProperty [MFC], OnSetCursor", "CMFCPropertyGridProperty [MFC], OnSetSelection", "CMFCPropertyGridProperty [MFC], OnUpdateValue", "CMFCPropertyGridProperty [MFC], PushChar", "CMFCPropertyGridProperty [MFC], Redraw", "CMFCPropertyGridProperty [MFC], RemoveAllOptions", "CMFCPropertyGridProperty [MFC], RemoveSubItem", "CMFCPropertyGridProperty [MFC], ResetOriginalValue", "CMFCPropertyGridProperty [MFC], SetData", "CMFCPropertyGridProperty [MFC], SetDescription", "CMFCPropertyGridProperty [MFC], SetName", "CMFCPropertyGridProperty [MFC], SetOriginalValue", "CMFCPropertyGridProperty [MFC], SetValue", "CMFCPropertyGridProperty [MFC], Show", "CMFCPropertyGridProperty [MFC], CreateCombo", "CMFCPropertyGridProperty [MFC], HasButton", "CMFCPropertyGridProperty [MFC], Init", "CMFCPropertyGridProperty [MFC], IsSubItem", "CMFCPropertyGridProperty [MFC], IsValueChanged", "CMFCPropertyGridProperty [MFC], OnCtlColor", "CMFCPropertyGridProperty [MFC], OnDestroyWindow", "CMFCPropertyGridProperty [MFC], OnKillFocus", "CMFCPropertyGridProperty [MFC], m_strFormatDouble", "CMFCPropertyGridProperty [MFC], m_strFormatFloat", "CMFCPropertyGridProperty [MFC], m_strFormatLong", "CMFCPropertyGridProperty [MFC], m_strFormatShort"] --- diff --git a/docs/standard-library/memory-operators.md b/docs/standard-library/memory-operators.md index b3f8e47d828..6fb628d3e2a 100644 --- a/docs/standard-library/memory-operators.md +++ b/docs/standard-library/memory-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["memory/std::operator!=", "memory/std::operator>", "memory/std::operator>=", "memory/std::operator<", "memory/std::operator<=", "memory/std::operator<<", "memory/std::operator=="] -ms.assetid: 257e3ba9-c4c2-4ae8-9b11-b156ba9c28de --- # `` operators From 714400378be6a3c9a8c0320eeabb8f575d52d8cd Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Fri, 13 Jun 2025 17:12:06 +0900 Subject: [PATCH 0054/1799] Fix typo: lamba -> lambda --- .../concrt/reference/concurrency-namespace-functions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/parallel/concrt/reference/concurrency-namespace-functions.md b/docs/parallel/concrt/reference/concurrency-namespace-functions.md index c2bfa3cbfb6..10f4a1627f6 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-functions.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-functions.md @@ -174,7 +174,7 @@ The lambda may take either zero, one or two arguments. The valid arguments are ` If the body of the lambda or function object returns a result (and not a task\), the lamdba will be executed asynchronously within the process MTA in the context of a task the Runtime implicitly creates for it. The `IAsyncInfo::Cancel` method will cause cancellation of the implicit task. -If the body of the lambda returns a task, the lamba executes inline, and by declaring the lambda to take an argument of type `cancellation_token` you can trigger cancellation of any tasks you create within the lambda by passing that token in when you create them. You may also use the `register_callback` method on the token to cause the Runtime to invoke a callback when you call `IAsyncInfo::Cancel` on the async operation or action produced. +If the body of the lambda returns a task, the lambda executes inline, and by declaring the lambda to take an argument of type `cancellation_token` you can trigger cancellation of any tasks you create within the lambda by passing that token in when you create them. You may also use the `register_callback` method on the token to cause the Runtime to invoke a callback when you call `IAsyncInfo::Cancel` on the async operation or action produced. This function is only available to Windows Runtime apps. From 38b9eb1b0fec5552c2fbe21504d69a86a560e758 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Fri, 13 Jun 2025 17:22:57 +0900 Subject: [PATCH 0055/1799] Fix typo: homogenous -> homogeneous --- docs/parallel/amp/reference/texture-view-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/parallel/amp/reference/texture-view-class.md b/docs/parallel/amp/reference/texture-view-class.md index 610f6fedf52..2ab64c9f966 100644 --- a/docs/parallel/amp/reference/texture-view-class.md +++ b/docs/parallel/amp/reference/texture-view-class.md @@ -40,7 +40,7 @@ The rank of the `texture_view`. |----------|-----------------| |`value_type`|The type of the elements in the texture aggregates.| |`coordinates_type`|The type of the coordinate used to specify a texel in the `texture_view`—that is, a `short_vector` that has the same rank as the associated texture that has a value type of **`float`**.| -|`gather_return_type`|The return type used for gather operations—that is, a rank 4 `short_vector` that holds the four homogenous color components gathered from the four texel values sampled.| +|`gather_return_type`|The return type used for gather operations—that is, a rank 4 `short_vector` that holds the four homogeneous color components gathered from the four texel values sampled.| ### Public Constructors From 7b43e93fc8323ee4f95077f366560495b12c946a Mon Sep 17 00:00:00 2001 From: Khairunj <18732564+Khairunj@users.noreply.github.com> Date: Fri, 13 Jun 2025 23:45:05 +0000 Subject: [PATCH 0056/1799] Initialize Docs repository: https://github.com/MicrosoftDocs/cpp-docs-pr of branch live --- .openpublishing.publish.config.json | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json index 5d83ccf79d4..296bfe4f38b 100644 --- a/.openpublishing.publish.config.json +++ b/.openpublishing.publish.config.json @@ -25,14 +25,11 @@ } ], "notification_subscribers": [], - "sync_notification_subscribers": null, + "sync_notification_subscribers": [], "branches_to_filter": [], "git_repository_url_open_to_public_contributors": "https://github.com/MicrosoftDocs/cpp-docs", "git_repository_branch_open_to_public_contributors": "main", - "skip_source_output_uploading": false, "need_preview_pull_request": true, - "enable_incremental_build": true, - "contribution_branch_mappings": null, "dependent_repositories": [ { "path_to_root": "_themes", @@ -57,15 +54,16 @@ "Pdf" ] }, - "need_generate_pdf_url_template": true, "targets": { "Pdf": { "template_folder": "_themes.pdf" } }, + "docs_build_engine": {}, + "skip_source_output_uploading": false, + "enable_incremental_build": true, + "contribution_branch_mappings": null, + "need_generate_pdf_url_template": true, "need_generate_pdf": false, - "need_generate_intellisense": false, - "docs_build_engine": { - "name": "docfx_v3" - } -} + "need_generate_intellisense": false +} \ No newline at end of file From 92e4cbf928f24445e72ece44298de8d46e44b97c Mon Sep 17 00:00:00 2001 From: Khairunj <18732564+Khairunj@users.noreply.github.com> Date: Fri, 13 Jun 2025 23:45:10 +0000 Subject: [PATCH 0057/1799] Initialize Docs repository: https://github.com/MicrosoftDocs/cpp-docs-pr of branch main --- .openpublishing.publish.config.json | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json index 5d83ccf79d4..296bfe4f38b 100644 --- a/.openpublishing.publish.config.json +++ b/.openpublishing.publish.config.json @@ -25,14 +25,11 @@ } ], "notification_subscribers": [], - "sync_notification_subscribers": null, + "sync_notification_subscribers": [], "branches_to_filter": [], "git_repository_url_open_to_public_contributors": "https://github.com/MicrosoftDocs/cpp-docs", "git_repository_branch_open_to_public_contributors": "main", - "skip_source_output_uploading": false, "need_preview_pull_request": true, - "enable_incremental_build": true, - "contribution_branch_mappings": null, "dependent_repositories": [ { "path_to_root": "_themes", @@ -57,15 +54,16 @@ "Pdf" ] }, - "need_generate_pdf_url_template": true, "targets": { "Pdf": { "template_folder": "_themes.pdf" } }, + "docs_build_engine": {}, + "skip_source_output_uploading": false, + "enable_incremental_build": true, + "contribution_branch_mappings": null, + "need_generate_pdf_url_template": true, "need_generate_pdf": false, - "need_generate_intellisense": false, - "docs_build_engine": { - "name": "docfx_v3" - } -} + "need_generate_intellisense": false +} \ No newline at end of file From d235daa7a292c2c30f33e6c236b561fa5d37d107 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 14 Jun 2025 18:29:05 +0800 Subject: [PATCH 0058/1799] Elide more manual table of contents --- docs/standard-library/allocators-operators.md | 3 --- docs/standard-library/array-functions.md | 3 --- docs/standard-library/array-operators.md | 7 ------- docs/standard-library/ostream-functions.md | 5 ----- docs/standard-library/string-view-operators.md | 9 --------- 5 files changed, 27 deletions(-) diff --git a/docs/standard-library/allocators-operators.md b/docs/standard-library/allocators-operators.md index 90936ade68c..56eb3ff9934 100644 --- a/docs/standard-library/allocators-operators.md +++ b/docs/standard-library/allocators-operators.md @@ -9,9 +9,6 @@ ms.assetid: b55d67cb-3c69-46bf-ad40-e845fb096c4e These are the global template operator functions defined in ``. For class member operator functions, see the class documentation. -[operator!=](#op_neq)\ -[operator==](#op_eq_eq) - ## operator!= Tests for inequality between allocator objects of a specified class. diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index a670f42c5bf..f0355805215 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -10,9 +10,6 @@ helpviewer_keywords: ["std::array [C++], get", "std::get [C++]", "std::swap [C++ The \ header includes two non-member functions, `get` and `swap`, that operate on **array** objects. -[get](#get)\ -[swap](#swap) - ## get Returns a reference to the specified element of the array. diff --git a/docs/standard-library/array-operators.md b/docs/standard-library/array-operators.md index 56925a09caa..dc176efb03c 100644 --- a/docs/standard-library/array-operators.md +++ b/docs/standard-library/array-operators.md @@ -8,13 +8,6 @@ f1_keywords: ["array/std::array::operator!=", "array/std::array::operator<", "ar The \ header includes these **array** non-member comparison template functions. -[operator!=](#op_neq)\ -[`operator>`](#op_gt)\ -[`operator>=`](#op_gt_eq)\ -[`operator<`](#op_lt)\ -[`operator<=`](#op_lt_eq)\ -[operator==](#op_eq_eq) - ## operator!= Array comparison, not equal. diff --git a/docs/standard-library/ostream-functions.md b/docs/standard-library/ostream-functions.md index ce0710b50ca..df0151d0498 100644 --- a/docs/standard-library/ostream-functions.md +++ b/docs/standard-library/ostream-functions.md @@ -10,11 +10,6 @@ helpviewer_keywords: ["std::swap [C++]", "std::endl [C++]", "std::ends [C++]", " These are the global template functions defined in ``. For member functions, see the [basic_ostream Class](basic-ostream-class.md) documentation. -[endl](#endl)\ -[ends](#ends)\ -[flush](#flush)\ -[swap](#swap) - ## endl Terminates a line and flushes the buffer. diff --git a/docs/standard-library/string-view-operators.md b/docs/standard-library/string-view-operators.md index cc6f5a702b3..cbcb11b52ba 100644 --- a/docs/standard-library/string-view-operators.md +++ b/docs/standard-library/string-view-operators.md @@ -9,15 +9,6 @@ helpviewer_keywords: ["std::basic_string_view::operator!=", "std::basic_string_v Use these operators to compare two `string_view` objects, or a `string_view` and some other string object (for example [`std::string`](basic-string-class.md), or `char*`) for which an implicit conversion is provided. -[`operator!=`](#op_neq)\ -[`operator>`](#op_gt)\ -[`operator>=`](#op_gt_eq)\ -[`operator<`](#op_lt)\ -[`operator<<`](#op_lt_lt)\ -[`operator<=`](#op_lt_eq)\ -[`operator==`](#op_eq_eq)\ -[`operator""sv`](#op_sv) - ## `operator!=` Tests if the object on the left side of the operator is not equal to the object on the right side. From 333929c06c7e9ed8258f351989bb60a97b416c4b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 14 Jun 2025 18:36:23 +0800 Subject: [PATCH 0059/1799] Update metadata for some standard library topics --- docs/standard-library/allocators-operators.md | 5 ++--- docs/standard-library/array-functions.md | 5 ++--- docs/standard-library/ostream-functions.md | 5 ++--- docs/standard-library/string-view-operators.md | 2 +- 4 files changed, 7 insertions(+), 10 deletions(-) diff --git a/docs/standard-library/allocators-operators.md b/docs/standard-library/allocators-operators.md index 56eb3ff9934..f8e4ba63b3a 100644 --- a/docs/standard-library/allocators-operators.md +++ b/docs/standard-library/allocators-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["allocators/std::operator!=", "allocators/std::operator=="] -ms.assetid: b55d67cb-3c69-46bf-ad40-e845fb096c4e --- # `` operators diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index f0355805215..049827d21fb 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["array/std::array::get", "array/std::get", "array/std::swap"] -ms.assetid: e0700a33-a833-4655-8735-16e71175efc8 helpviewer_keywords: ["std::array [C++], get", "std::get [C++]", "std::swap [C++]"] --- # `` functions diff --git a/docs/standard-library/ostream-functions.md b/docs/standard-library/ostream-functions.md index df0151d0498..2675c8a3394 100644 --- a/docs/standard-library/ostream-functions.md +++ b/docs/standard-library/ostream-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["ostream/std::swap", "ostream/std::endl", "ostream/std::ends", "ostream/std::flush"] -ms.assetid: d6e56cc0-c8df-4dbe-be10-98e14c35ed3a helpviewer_keywords: ["std::swap [C++]", "std::endl [C++]", "std::ends [C++]", "std::flush [C++]"] --- # `` functions diff --git a/docs/standard-library/string-view-operators.md b/docs/standard-library/string-view-operators.md index cbcb11b52ba..b3ca601413a 100644 --- a/docs/standard-library/string-view-operators.md +++ b/docs/standard-library/string-view-operators.md @@ -1,7 +1,7 @@ --- title: " operators" description: "API reference for the `string_view` operators, which are used to compare two `string_view` objects, or a `string_view` and some other string object" -ms.date: "01/15/2021" +ms.date: 01/15/2021 f1_keywords: ["xstring/basic_string_view::operator!=", "xstring/basic_string_view::operator>", "xstring/basic_string_view::operator>=", "xstring/basic_string_view::operator<", "xstring/basic_string_view::operator<<", "xstring/basic_string_view::operator<=", "xstring/basic_string_view::operator+", "xstring/basic_string_view::operator==", 'xstring/std::literals::string_view_literals::operator "sv', 'std::literals::string_view_literals::operator sv', 'std::literals::string_view_literals', 'string_view_literals'] helpviewer_keywords: ["std::basic_string_view::operator!=", "std::basic_string_view::operator>", "std::basic_string_view::operator>=", "std::basic_string_view::operator<", "std::basic_string_view::operator<<", "std::basic_string_view::operator<=, std::basic_string_view::operator=="] --- From 36ee0db1e37a19f75ed2160d873c99e0e50e4baf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 14 Jun 2025 18:38:21 +0800 Subject: [PATCH 0060/1799] Add backticks in `` operators reference --- docs/standard-library/allocators-operators.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/standard-library/allocators-operators.md b/docs/standard-library/allocators-operators.md index f8e4ba63b3a..8deacf84301 100644 --- a/docs/standard-library/allocators-operators.md +++ b/docs/standard-library/allocators-operators.md @@ -8,7 +8,7 @@ f1_keywords: ["allocators/std::operator!=", "allocators/std::operator=="] These are the global template operator functions defined in ``. For class member operator functions, see the class documentation. -## operator!= +## `operator!=` Tests for inequality between allocator objects of a specified class. @@ -21,10 +21,10 @@ bool operator!=( ### Parameters -*left*\ +*`left`*\ One of the allocator objects to be tested for inequality. -*right*\ +*`right`*\ One of the allocator objects to be tested for inequality. ### Return Value @@ -35,7 +35,7 @@ One of the allocator objects to be tested for inequality. The template operator returns `!(left == right)`. -## operator== +## `operator==` Tests for equality between allocator objects of a specified class. @@ -48,10 +48,10 @@ bool operator==( ### Parameters -*left*\ +*`left`*\ One of the allocator objects to be tested for equality. -*right*\ +*`right`*\ One of the allocator objects to be tested for equality. ### Return Value @@ -64,4 +64,4 @@ This template operator returns `left.equals(right)`. ## See also -[\](allocators-header.md) +[``](allocators-header.md) From db47863625b19a474c0f77a043a957a39a160e91 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 14 Jun 2025 18:40:20 +0800 Subject: [PATCH 0061/1799] Add backticks in `` functions reference --- docs/standard-library/array-functions.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index 049827d21fb..60e9c8027c5 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -7,9 +7,9 @@ helpviewer_keywords: ["std::array [C++], get", "std::get [C++]", "std::swap [C++ --- # `` functions -The \ header includes two non-member functions, `get` and `swap`, that operate on **array** objects. +The `` header includes two non-member functions, `get` and `swap`, that operate on **array** objects. -## get +## `get` Returns a reference to the specified element of the array. @@ -26,16 +26,16 @@ constexpr T&& get(array&& arr) noexcept; ### Parameters -*Index*\ +*`Index`*\ The element offset. -*T*\ +*`T`*\ The type of an element. -*N*\ +*`N`*\ The number of elements in the array. -*arr*\ +*`arr`*\ The array to select from. ### Example @@ -70,7 +70,7 @@ int main() 1 3 ``` -## swap +## `swap` A non-member template specialization of `std::swap` that swaps two **array** objects. @@ -81,16 +81,16 @@ void swap(array& left, array& right); ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ The first array to swap. -*right*\ +*`right`*\ The second array to swap. ### Remarks @@ -145,4 +145,4 @@ int main() ## See also -[\](../standard-library/array.md) +[``](../standard-library/array.md) From c8355baa78133b424239edc895d6cbd661fa57f3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 14 Jun 2025 18:43:50 +0800 Subject: [PATCH 0062/1799] Add backticks in `` operators reference --- docs/standard-library/array-operators.md | 56 ++++++++++++------------ 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/docs/standard-library/array-operators.md b/docs/standard-library/array-operators.md index dc176efb03c..1e076cf5500 100644 --- a/docs/standard-library/array-operators.md +++ b/docs/standard-library/array-operators.md @@ -6,9 +6,9 @@ f1_keywords: ["array/std::array::operator!=", "array/std::array::operator<", "ar --- # `` operators -The \ header includes these **array** non-member comparison template functions. +The `` header includes these **array** non-member comparison template functions. -## operator!= +## `operator!=` Array comparison, not equal. @@ -21,16 +21,16 @@ bool operator!=( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -94,16 +94,16 @@ bool operator<( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -167,16 +167,16 @@ bool operator<=( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -227,7 +227,7 @@ true false ``` -## operator== +## `operator==` Array comparison, equal. @@ -240,16 +240,16 @@ bool operator==( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -313,16 +313,16 @@ bool operator>( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -386,16 +386,16 @@ bool operator>=( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -448,4 +448,4 @@ false ## See also -[\](../standard-library/array.md) +[``](../standard-library/array.md) From 9d63f571672fc377200fe86d365f79bcf0d65384 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 14 Jun 2025 18:47:56 +0800 Subject: [PATCH 0063/1799] Add backticks in `` functions reference --- docs/standard-library/ostream-functions.md | 48 +++++++++++----------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/standard-library/ostream-functions.md b/docs/standard-library/ostream-functions.md index 2675c8a3394..e306c7f49e0 100644 --- a/docs/standard-library/ostream-functions.md +++ b/docs/standard-library/ostream-functions.md @@ -7,9 +7,9 @@ helpviewer_keywords: ["std::swap [C++]", "std::endl [C++]", "std::ends [C++]", " --- # `` functions -These are the global template functions defined in ``. For member functions, see the [basic_ostream Class](basic-ostream-class.md) documentation. +These are the global template functions defined in ``. For member functions, see the [`basic_ostream` Class](basic-ostream-class.md) documentation. -## endl +## `endl` Terminates a line and flushes the buffer. @@ -21,22 +21,22 @@ basic_ostream& endl( ### Parameters -*Elem*\ +*`Elem`*\ The element type. -*Ostr*\ -An object of type **basic_ostream**. +*`Ostr`*\ +An object of type **`basic_ostream`**. -*Tr*\ +*`Tr`*\ Character traits. ### Return Value -An object of type **basic_ostream**. +An object of type **`basic_ostream`**. ### Remarks -The manipulator calls *Ostr*.[put](../standard-library/basic-ostream-class.md#put)(*Ostr*.[widen](../standard-library/basic-ios-class.md#widen)('\n')), and then calls *Ostr*.[flush](../standard-library/basic-ostream-class.md#flush). It returns *Ostr*. +The manipulator calls *`Ostr`*.[`put`](../standard-library/basic-ostream-class.md#put)(*`Ostr`*.[`widen`](../standard-library/basic-ios-class.md#widen)('\n')), and then calls *`Ostr`*.[`flush`](../standard-library/basic-ostream-class.md#flush). It returns *`Ostr`*. ### Example @@ -56,7 +56,7 @@ int main( ) testing ``` -## ends +## `ends` Terminates a string. @@ -68,13 +68,13 @@ basic_ostream& ends( ### Parameters -*Elem*\ +*`Elem`*\ The element type. -*Ostr*\ +*`Ostr`*\ An object of type `basic_ostream`. -*Tr*\ +*`Tr`*\ Character traits. ### Return Value @@ -83,7 +83,7 @@ An object of type `basic_ostream`. ### Remarks -The manipulator calls *Ostr*.[put](../standard-library/basic-ostream-class.md#put)(*Elem*('\0')). It returns *Ostr*. +The manipulator calls *`Ostr`*.[`put`](../standard-library/basic-ostream-class.md#put)(*`Elem`*('\0')). It returns *`Ostr`*. ### Example @@ -105,7 +105,7 @@ int main( ) ab c ``` -## flush +## `flush` Flushes the buffer. @@ -117,13 +117,13 @@ basic_ostream& flush( ### Parameters -*Elem*\ +*`Elem`*\ The element type. -*Ostr*\ +*`Ostr`*\ An object of type `basic_ostream`. -*Tr*\ +*`Tr`*\ Character traits. ### Return Value @@ -132,7 +132,7 @@ An object of type `basic_ostream`. ### Remarks -The manipulator calls *Ostr*.[flush](../standard-library/basic-ostream-class.md#flush). It returns *Ostr*. +The manipulator calls *`Ostr`*.[`flush`](../standard-library/basic-ostream-class.md#flush). It returns *`Ostr`*. ### Example @@ -152,7 +152,7 @@ int main( ) testing ``` -## swap +## `swap` Exchanges the values of two `basic_ostream` objects. @@ -165,16 +165,16 @@ void swap( ### Parameters -*Elem*\ +*`Elem`*\ The element type. -*Tr*\ +*`Tr`*\ Character traits. -*left*\ +*`left`*\ An lvalue reference to a `basic_ostream` object. -*right*\ +*`right`*\ An lvalue reference to a `basic_ostream` object. ### Remarks @@ -183,4 +183,4 @@ The template function `swap` executes `left.swap(right)`. ## See also -[\](../standard-library/ostream.md) +[``](../standard-library/ostream.md) From 30839fff0089c8e67a2c324ea97f6e509fdb5ed0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 14 Jun 2025 18:51:17 +0800 Subject: [PATCH 0064/1799] Add backticks in `` operators reference --- .../standard-library/string-view-operators.md | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/standard-library/string-view-operators.md b/docs/standard-library/string-view-operators.md index b3ca601413a..a79ca556d75 100644 --- a/docs/standard-library/string-view-operators.md +++ b/docs/standard-library/string-view-operators.md @@ -32,10 +32,10 @@ bool operator!=( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value @@ -71,10 +71,10 @@ bool operator==( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value @@ -110,10 +110,10 @@ bool operator<( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value @@ -122,7 +122,7 @@ Any convertible string type or an object of type `basic_string_view` to be compa ### Remarks -An implicit conversion must exist from *convertible_string_type* to the string_view on the other side. +An implicit conversion must exist from *convertible_string_type* to the `string_view` on the other side. The comparison is based on a pairwise lexicographical comparison of the character sequences. When the first unequal pair of characters is encountered, the result of that comparison is returned. If no unequal characters are found, but one sequence is shorter, the shorter sequence is less than the longer one. In other words, "cat" is less than "cats". @@ -171,10 +171,10 @@ bool operator<=( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value @@ -201,7 +201,7 @@ inline basic_ostream& operator<<( an output stream being written to. *`Str`*\ -The string_view to be entered into an output stream. +The `string_view` to be entered into an output stream. ### Return Value @@ -234,10 +234,10 @@ bool operator>( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value From a6920085993b1a041e0bc6e97dd364c133bc9751 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 17:46:18 +0800 Subject: [PATCH 0065/1799] Add backticks in `_SECURE_SCL` reference --- docs/standard-library/secure-scl.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/standard-library/secure-scl.md b/docs/standard-library/secure-scl.md index 011c9f2ca77..94eeaea0842 100644 --- a/docs/standard-library/secure-scl.md +++ b/docs/standard-library/secure-scl.md @@ -6,32 +6,32 @@ f1_keywords: ["_SECURE_SCL"] helpviewer_keywords: ["_SECURE_SCL"] ms.assetid: 4ffbc788-cc12-4c6a-8cd7-490081675086 --- -# _SECURE_SCL +# `_SECURE_SCL` -Superseded by [_ITERATOR_DEBUG_LEVEL](../standard-library/iterator-debug-level.md), this macro defines whether [Checked Iterators](../standard-library/checked-iterators.md) are enabled. By default, checked iterators are enabled in Debug builds, and disabled in Retail builds. +Superseded by [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md), this macro defines whether [Checked Iterators](../standard-library/checked-iterators.md) are enabled. By default, checked iterators are enabled in Debug builds, and disabled in Retail builds. > [!IMPORTANT] -> Direct use of the _SECURE_SCL macro is deprecated. Instead, use _ITERATOR_DEBUG_LEVEL to control checked iterator settings. For more information, see [_ITERATOR_DEBUG_LEVEL](../standard-library/iterator-debug-level.md). +> Direct use of the `_SECURE_SCL` macro is deprecated. Instead, use `_ITERATOR_DEBUG_LEVEL` to control checked iterator settings. For more information, see [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md). ## Remarks -When checked iterators are enabled, unsafe iterator use causes a runtime error and the program is terminated. To enable checked iterators, set _ITERATOR_DEBUG_LEVEL to 1 or 2. This is equivalent to a _SECURE_SCL setting of 1, or enabled: +When checked iterators are enabled, unsafe iterator use causes a runtime error and the program is terminated. To enable checked iterators, set `_ITERATOR_DEBUG_LEVEL` to 1 or 2. This is equivalent to a `_SECURE_SCL` setting of 1, or enabled: ```cpp #define _ITERATOR_DEBUG_LEVEL 1 ``` -To disable checked iterators, set _ITERATOR_DEBUG_LEVEL to 0. This is equivalent to a _SECURE_SCL setting of 0, or disabled: +To disable checked iterators, set `_ITERATOR_DEBUG_LEVEL` to 0. This is equivalent to a `_SECURE_SCL` setting of 0, or disabled: ```cpp #define _ITERATOR_DEBUG_LEVEL 0 ``` -For information on how to disable warnings about checked iterators, see [_SCL_SECURE_NO_WARNINGS](../standard-library/scl-secure-no-warnings.md). +For information on how to disable warnings about checked iterators, see [`_SCL_SECURE_NO_WARNINGS`](../standard-library/scl-secure-no-warnings.md). ## See also -[_ITERATOR_DEBUG_LEVEL](../standard-library/iterator-debug-level.md)\ +[`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md)\ [Checked Iterators](../standard-library/checked-iterators.md)\ [Debug Iterator Support](../standard-library/debug-iterator-support.md)\ [Safe Libraries: C++ Standard Library](../standard-library/safe-libraries-cpp-standard-library.md) From a95aecd3d52dfebad402f61380b366b527f0b91e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 17:48:33 +0800 Subject: [PATCH 0066/1799] Simplify superfluous relative links in `_SECURE_SCL` reference --- docs/standard-library/secure-scl.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/standard-library/secure-scl.md b/docs/standard-library/secure-scl.md index 94eeaea0842..c4019cfc17d 100644 --- a/docs/standard-library/secure-scl.md +++ b/docs/standard-library/secure-scl.md @@ -8,10 +8,10 @@ ms.assetid: 4ffbc788-cc12-4c6a-8cd7-490081675086 --- # `_SECURE_SCL` -Superseded by [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md), this macro defines whether [Checked Iterators](../standard-library/checked-iterators.md) are enabled. By default, checked iterators are enabled in Debug builds, and disabled in Retail builds. +Superseded by [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md), this macro defines whether [Checked Iterators](checked-iterators.md) are enabled. By default, checked iterators are enabled in Debug builds, and disabled in Retail builds. > [!IMPORTANT] -> Direct use of the `_SECURE_SCL` macro is deprecated. Instead, use `_ITERATOR_DEBUG_LEVEL` to control checked iterator settings. For more information, see [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md). +> Direct use of the `_SECURE_SCL` macro is deprecated. Instead, use `_ITERATOR_DEBUG_LEVEL` to control checked iterator settings. For more information, see [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md). ## Remarks @@ -27,11 +27,11 @@ To disable checked iterators, set `_ITERATOR_DEBUG_LEVEL` to 0. This is equivale #define _ITERATOR_DEBUG_LEVEL 0 ``` -For information on how to disable warnings about checked iterators, see [`_SCL_SECURE_NO_WARNINGS`](../standard-library/scl-secure-no-warnings.md). +For information on how to disable warnings about checked iterators, see [`_SCL_SECURE_NO_WARNINGS`](scl-secure-no-warnings.md). ## See also -[`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md)\ -[Checked Iterators](../standard-library/checked-iterators.md)\ -[Debug Iterator Support](../standard-library/debug-iterator-support.md)\ -[Safe Libraries: C++ Standard Library](../standard-library/safe-libraries-cpp-standard-library.md) +[`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md)\ +[Checked Iterators](checked-iterators.md)\ +[Debug Iterator Support](debug-iterator-support.md)\ +[Safe Libraries: C++ Standard Library](safe-libraries-cpp-standard-library.md) From e3d728082378742ee0cb4bb16c260d103009c795 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 17:49:41 +0800 Subject: [PATCH 0067/1799] Update metadata in `_SECURE_SCL` reference --- docs/standard-library/secure-scl.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/secure-scl.md b/docs/standard-library/secure-scl.md index c4019cfc17d..01a0b851630 100644 --- a/docs/standard-library/secure-scl.md +++ b/docs/standard-library/secure-scl.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: _SECURE_SCL" title: "_SECURE_SCL" -ms.date: "11/04/2016" +description: "Learn more about: _SECURE_SCL" +ms.date: 11/04/2016 f1_keywords: ["_SECURE_SCL"] helpviewer_keywords: ["_SECURE_SCL"] -ms.assetid: 4ffbc788-cc12-4c6a-8cd7-490081675086 --- # `_SECURE_SCL` From 7abbca17bd4ce8ee8d6ee41049b8df94e2be4fff Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 18:01:50 +0800 Subject: [PATCH 0068/1799] Add missing square brackets for `[[nodiscard]]` in C4834 reference --- docs/error-messages/compiler-warnings/c4834.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/c4834.md b/docs/error-messages/compiler-warnings/c4834.md index 7012f5c3c69..2fb07fd6515 100644 --- a/docs/error-messages/compiler-warnings/c4834.md +++ b/docs/error-messages/compiler-warnings/c4834.md @@ -43,7 +43,7 @@ int square_of(int i) { return i * i; } int main() { square_of(42); // warning C4834: discarding return value of function with 'nodiscard' attribute - // If ignoring the [[nodiscard] attribute is unintentional, make use of the return value as intended: + // If ignoring the [[nodiscard]] attribute is unintentional, make use of the return value as intended: // For example: std::cout << "square_of(42) = " << square_of(42) << "\n"; // Ok // Or: From 96ec68158d36b44173105bbbaef5f6005d4d785a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 18:02:56 +0800 Subject: [PATCH 0069/1799] Move `title` metadata above `description` in C4834 reference --- docs/error-messages/compiler-warnings/c4834.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/c4834.md b/docs/error-messages/compiler-warnings/c4834.md index 2fb07fd6515..62746b0fce4 100644 --- a/docs/error-messages/compiler-warnings/c4834.md +++ b/docs/error-messages/compiler-warnings/c4834.md @@ -1,6 +1,6 @@ --- -description: "Learn about the cause and fixes for Compiler warning (level 1) C4834." title: "Compiler warning (Level 1) C4834" +description: "Learn about the cause and fixes for Compiler warning (level 1) C4834." ms.date: 01/18/2024 f1_keywords: ["C4834"] helpviewer_keywords: ["C4834"] From 1ef5bd896a88fda9e81bb7efc06815029160aecd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 18:15:29 +0800 Subject: [PATCH 0070/1799] Resolve misplaced backtick for link in `_CrtSetDebugFillThreshold` reference --- docs/c-runtime-library/reference/crtsetdebugfillthreshold.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/crtsetdebugfillthreshold.md b/docs/c-runtime-library/reference/crtsetdebugfillthreshold.md index b7ce8b7bbb0..143cbd3f210 100644 --- a/docs/c-runtime-library/reference/crtsetdebugfillthreshold.md +++ b/docs/c-runtime-library/reference/crtsetdebugfillthreshold.md @@ -60,7 +60,7 @@ Here's a list of the affected functions: - [`_strset_s`, `_strset_s_l`, `_wcsset_s`, `_wcsset_s_l`, `_mbsset_s`, `_mbsset_s_l`](strset-s-strset-s-l-wcsset-s-wcsset-s-l-mbsset-s-mbsset-s-l.md) - [`_strtime_s`, `_wstrtime_s`](strtime-s-wstrtime-s.md) - [`_strupr_s`, `_strupr_s_l`, `_mbsupr_s`, `_mbsupr_s_l`, `_wcsupr_s`, `_wcsupr_s_l`](strupr-s-strupr-s-l-mbsupr-s-mbsupr-s-l-wcsupr-s-wcsupr-s-l.md) -- [`vsnprintf_s`, `_vsnprintf_s`, `_vsnprintf_s_l`, `_vsnwprintf_s`, _vsnwpr`intf_s_l](vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md) +- [`vsnprintf_s`, `_vsnprintf_s`, `_vsnprintf_s_l`, `_vsnwprintf_s`, `_vsnwprintf_s_l`](vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md) ## Requirements From 60deb01b3067d5323c0343b8240a7d0bc7506084 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 18:31:58 +0800 Subject: [PATCH 0071/1799] Fix backtick placement in "Adding Connection Points to an Object" --- docs/atl/adding-connection-points-to-an-object.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/atl/adding-connection-points-to-an-object.md b/docs/atl/adding-connection-points-to-an-object.md index 671460f394d..a275ac4ed11 100644 --- a/docs/atl/adding-connection-points-to-an-object.md +++ b/docs/atl/adding-connection-points-to-an-object.md @@ -25,7 +25,7 @@ In either case, the Implement Connection Point Wizard uses a type library to do Use either the uuidgen.exe or guidgen.exe utility to generate a GUID. -2. Add the dispinterface as the `[default,source]` interface in the coclass for the object in the project's .idl file. Again, if you enabled support for connection points when you created the control, the ATL Control Wizard will create the `[default,source`] entry. To manually add this entry, add the line in bold: +2. Add the dispinterface as the `[default,source]` interface in the coclass for the object in the project's .idl file. Again, if you enabled support for connection points when you created the control, the ATL Control Wizard will create the `[default,source]` entry. To manually add this entry, add the line in bold: [!code-cpp[NVC_ATL_Windowing#82](../atl/codesnippet/cpp/adding-connection-points-to-an-object_2.idl)] From 2e7556b772c110daf2eda229af369038522739f5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 18:34:19 +0800 Subject: [PATCH 0072/1799] Clean up redundant relative links in "Adding Connection Points to an Object" --- docs/atl/adding-connection-points-to-an-object.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/atl/adding-connection-points-to-an-object.md b/docs/atl/adding-connection-points-to-an-object.md index a275ac4ed11..b83a4ec931d 100644 --- a/docs/atl/adding-connection-points-to-an-object.md +++ b/docs/atl/adding-connection-points-to-an-object.md @@ -7,7 +7,7 @@ ms.assetid: 843531be-4a36-4db0-9d54-e029b1a72a8b --- # Adding Connection Points to an Object -The [ATL Tutorial](../atl/active-template-library-atl-tutorial.md) demonstrates how to create a control with support for connection points, how to add events, and then how to implement the connection point. ATL implements connection points with the [IConnectionPointImpl](../atl/reference/iconnectionpointimpl-class.md) class. +The [ATL Tutorial](active-template-library-atl-tutorial.md) demonstrates how to create a control with support for connection points, how to add events, and then how to implement the connection point. ATL implements connection points with the [IConnectionPointImpl](reference/iconnectionpointimpl-class.md) class. To implement a connection point, you have two choices: @@ -21,13 +21,13 @@ In either case, the Implement Connection Point Wizard uses a type library to do 1. Define a dispinterface in the library block of the .idl file. If you enabled support for connection points when you created the control with the ATL Control Wizard, the dispinterface will already be created. If you did not enable support for connection points when you created the control, you must manually add a dispinterface to the .idl file. The following is an example of a dispinterface. Outgoing interfaces are not required to be dispatch interfaces but many scripting languages such as VBScript and JScript require this, so this example uses two dispinterfaces: - [!code-cpp[NVC_ATL_Windowing#81](../atl/codesnippet/cpp/adding-connection-points-to-an-object_1.idl)] + [!code-cpp[NVC_ATL_Windowing#81](codesnippet/cpp/adding-connection-points-to-an-object_1.idl)] Use either the uuidgen.exe or guidgen.exe utility to generate a GUID. 2. Add the dispinterface as the `[default,source]` interface in the coclass for the object in the project's .idl file. Again, if you enabled support for connection points when you created the control, the ATL Control Wizard will create the `[default,source]` entry. To manually add this entry, add the line in bold: - [!code-cpp[NVC_ATL_Windowing#82](../atl/codesnippet/cpp/adding-connection-points-to-an-object_2.idl)] + [!code-cpp[NVC_ATL_Windowing#82](codesnippet/cpp/adding-connection-points-to-an-object_2.idl)] See the .idl file in the [Circ](../overview/visual-cpp-samples.md) ATL sample for an example. @@ -55,4 +55,4 @@ In either case, the Implement Connection Point Wizard uses a type library to do ## See also -[Connection Point](../atl/atl-connection-points.md) +[Connection Point](atl-connection-points.md) From b805aad4425784db4e9d571108153f90369f02e3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 18:35:04 +0800 Subject: [PATCH 0073/1799] Update metadata in "Adding Connection Points to an Object" --- docs/atl/adding-connection-points-to-an-object.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/atl/adding-connection-points-to-an-object.md b/docs/atl/adding-connection-points-to-an-object.md index b83a4ec931d..4703ee3cef0 100644 --- a/docs/atl/adding-connection-points-to-an-object.md +++ b/docs/atl/adding-connection-points-to-an-object.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Adding Connection Points to an Object" title: "Adding Connection Points to an Object" -ms.date: "11/04/2016" +description: "Learn more about: Adding Connection Points to an Object" +ms.date: 11/04/2016 helpviewer_keywords: ["connection points [C++], adding to ATL objects", "Implement Connection Point ATL wizard"] -ms.assetid: 843531be-4a36-4db0-9d54-e029b1a72a8b --- # Adding Connection Points to an Object From 8f5bf1e0354d7c5ef3e0d44b5ec4d5f112961953 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 18:54:12 +0800 Subject: [PATCH 0074/1799] Fix mismatched backtick in `legacy_stdio_float_rounding.obj` link texts --- .../reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md | 2 +- .../reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md | 2 +- .../reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md | 2 +- .../reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md | 2 +- docs/c-runtime-library/reference/get-printf-count-output.md | 2 +- .../scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md | 2 +- .../reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md | 2 +- .../snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md | 2 +- .../reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md | 2 +- .../reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md | 2 +- .../sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md | 2 +- .../reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md | 2 +- .../vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md | 2 +- .../vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md | 2 +- .../reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md | 2 +- .../reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md | 2 +- .../reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md | 2 +- .../reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md | 2 +- .../vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md | 2 +- ...f-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md | 2 +- .../vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md | 2 +- .../vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md | 2 +- .../vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md | 2 +- .../vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md | 2 +- 24 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md b/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md index cab723ba690..04327a288f6 100644 --- a/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md +++ b/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md @@ -65,7 +65,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). Like the non-secure versions (see [`_cprintf`, `_cprintf_l`, `_cwprintf`, `_cwprintf_l`](cprintf-cprintf-l-cwprintf-cwprintf-l.md)), these functions validate their parameters and invoke the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md), if *`format`* is a null pointer. These functions differ from the non-secure versions in that the format string itself is also validated. If there are any unknown or badly formed formatting specifiers, these functions invoke the invalid parameter handler. In all cases, If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. diff --git a/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md b/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md index 2d972d963a6..97f93e31bb4 100644 --- a/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md +++ b/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md @@ -73,7 +73,7 @@ The versions of these functions with the **`_l`** suffix are identical except th > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text function mappings diff --git a/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md b/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md index 8ed284f3438..c5b3f18335e 100644 --- a/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md +++ b/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md @@ -71,7 +71,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). Like the non-secure versions (see [`fprintf`, `_fprintf_l`, `fwprintf`, `_fwprintf_l`](fprintf-fprintf-l-fwprintf-fwprintf-l.md)), these functions validate their parameters and invoke the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md), if either *`stream`* or *`format`* is a null pointer or if there are any unknown or badly formed formatting specifiers. If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. diff --git a/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md b/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md index 225ec4abc77..e3bda3573f6 100644 --- a/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md +++ b/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md @@ -71,7 +71,7 @@ The versions of these functions with the **`_l`** suffix are identical except th > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). Like the non-secure versions (see [`fprintf`, `_fprintf_l`, `fwprintf`, `_fwprintf_l`](fprintf-fprintf-l-fwprintf-fwprintf-l.md)), these functions validate their parameters and invoke the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md), if either *`stream`* or *`format`* is a `NULL` pointer. The format string itself is also validated. If there are any unknown or badly formed formatting specifiers, these functions generate the invalid parameter exception. In all cases, If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. For more information about return codes, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md). diff --git a/docs/c-runtime-library/reference/get-printf-count-output.md b/docs/c-runtime-library/reference/get-printf-count-output.md index dfa9d742786..a1cfde65efa 100644 --- a/docs/c-runtime-library/reference/get-printf-count-output.md +++ b/docs/c-runtime-library/reference/get-printf-count-output.md @@ -28,7 +28,7 @@ Non-zero if **`%n`** is supported; 0 if **`%n`** isn't supported. If **`%n`** isn't supported (the default), any **`%n`** found in the format string of one of the `printf` functions invokes the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If **`%n`** support is enabled (see [`_set_printf_count_output`](set-printf-count-output.md)), then **`%n`** behaves as described in [Format specification syntax: `printf` and `wprintf` functions](../format-specification-syntax-printf-and-wprintf-functions.md). > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ## Requirements diff --git a/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md b/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md index 8456b644e99..0638e1bcd92 100644 --- a/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md +++ b/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md @@ -66,7 +66,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md b/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md index 49789f506dc..44e76a4d9f9 100644 --- a/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md +++ b/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md @@ -66,7 +66,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md b/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md index 548a9fccf6f..ab9131675a3 100644 --- a/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md +++ b/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md @@ -126,7 +126,7 @@ For information about these and other error codes, see [`_doserrno`, `errno`, `_ > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). **`_snwprintf_s`** is a wide-character version of **`_snprintf_s`**; the pointer arguments to **`_snwprintf_s`** are wide-character strings. Detection of encoding errors in **`_snwprintf_s`** might differ from that in **`_snprintf_s`**. **`_snwprintf_s`**, like **`swprintf_s`**, writes output to a string rather than to a destination of type **`FILE`**. diff --git a/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md b/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md index 030e72c577d..cb2fa215590 100644 --- a/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md +++ b/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md @@ -76,7 +76,7 @@ The **`_sprintf_p`** function formats and stores a series of characters and valu **`_sprintf_p`** returns the number of bytes stored in *`buffer`*, not counting the terminating null character. **`_swprintf_p`** returns the number of wide characters stored in *`buffer`*, not counting the terminating null wide character. If *`buffer`* or *`format`* is a null pointer, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, these functions return -1 and set `errno` to `EINVAL`. > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md b/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md index 5e3ff04ff2a..87b3cfd7c3f 100644 --- a/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md +++ b/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md @@ -96,7 +96,7 @@ In C++, use of these functions is simplified by template overloads. The overload There are versions of **`sprintf_s`** that offer more control over what happens if the buffer is too small. For more information, see [`_snprintf_s`, `_snprintf_s_l`, `_snwprintf_s`, `_snwprintf_s_l`](snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md). > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md b/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md index 960c47657c4..df177cff1f9 100644 --- a/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md +++ b/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md @@ -105,7 +105,7 @@ The **`sprintf`** function formats and stores a series of characters and values > [!IMPORTANT] > Using **`sprintf`**, there is no way to limit the number of characters written, which means that code using **`sprintf`** is susceptible to buffer overruns. Consider using the related function [`snprintf`](snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md), which specifies a maximum number of characters to write to *`buffer`*, or use [`_scprintf`](scprintf-scprintf-l-scwprintf-scwprintf-l.md) to determine how large a buffer is required. Also, ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). **`swprintf`** is a wide-character version of **`sprintf`**; the pointer arguments to **`swprintf`** are wide-character strings. Detection of encoding errors in **`swprintf`** may differ from **`sprintf`**. **`swprintf`** and **`fwprintf`** behave identically except **`swprintf`** writes output to a string rather than to a destination of type `FILE`, and **`swprintf`** requires the *`count`* parameter to specify the maximum number of characters to write. The versions of these functions with the **`_l`** suffix are identical except they use the locale parameter passed in instead of the current thread locale. diff --git a/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md b/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md index 48dc1f6a5fa..5f048b91b05 100644 --- a/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md +++ b/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md @@ -65,7 +65,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md b/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md index 0d8c50f0a33..ae72ac569f9 100644 --- a/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md @@ -70,7 +70,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). If either *`stream`* or *`format`* is a null pointer, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. diff --git a/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md b/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md index ffb2bfde120..0310a6a5fa3 100644 --- a/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md @@ -74,7 +74,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md b/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md index f4860772c9e..f15d6242269 100644 --- a/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md +++ b/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md @@ -72,7 +72,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md b/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md index e3ea98113ae..fe005331e41 100644 --- a/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md @@ -63,7 +63,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). If *`format`* is a null pointer, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. diff --git a/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md b/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md index 9b7f90e5ef2..f363f5a734d 100644 --- a/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md @@ -67,7 +67,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md b/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md index 4575ef26d7d..853325f181e 100644 --- a/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md +++ b/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md @@ -65,7 +65,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). Invalid format strings are detected and result in an error. -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md b/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md index 6f6910fcf6b..6a8b654d06c 100644 --- a/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md @@ -66,7 +66,7 @@ If *`format`* is a null pointer, the invalid parameter handler is invoked, as de > [!IMPORTANT] > Ensure that if *`format`* is a user-defined string, it is null terminated and has the correct number and type of parameters. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md b/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md index 096bc628824..7686c45c0ea 100644 --- a/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md @@ -144,7 +144,7 @@ For information about these and other error codes, see [`_doserrno`, `errno`, `_ > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). > [!NOTE] > To ensure that there is room for the terminating `NULL`, be sure that *`count`* is strictly less than the buffer length, or use `_TRUNCATE`. diff --git a/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md b/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md index 1f94c8f59a8..7a90fece022 100644 --- a/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md +++ b/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md @@ -129,7 +129,7 @@ Beginning with the UCRT in Visual Studio 2015 and Windows 10, **`vsnprintf`** is > [!IMPORTANT] > To prevent certain kinds of security risks, ensure that *`format`* isn't a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). > [!NOTE] > To ensure that there's room for the terminating null when calling **`_vsnprintf`**, **`_vsnprintf_l`**, **`_vsnwprintf`** and **`_vsnwprintf_l`**, be sure that *`count`* is strictly less than the buffer length and initialize the buffer to null prior to calling the function. diff --git a/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md b/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md index 75116027f65..6600535e0a0 100644 --- a/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md +++ b/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md @@ -81,7 +81,7 @@ The versions of these functions with the `_l` suffix are identical except that t If the *`buffer`* or *`format`* parameters are `NULL` pointers, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md b/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md index 991b132063b..b623469c2fb 100644 --- a/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md +++ b/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md @@ -94,7 +94,7 @@ The versions of these functions with the **`_l`** suffix are identical except th In C++, using these functions is simplified by template overloads. The overloads can infer buffer length automatically, eliminating the need to specify a size argument. And, they can automatically replace non-secure functions with their secure counterparts. For more information, see [Secure template overloads](../secure-template-overloads.md). > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text function mappings diff --git a/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md b/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md index b3296103ad4..04e340f2333 100644 --- a/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md +++ b/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md @@ -109,7 +109,7 @@ The versions of these functions with the **`_l`** suffix are identical except th > [!IMPORTANT] > Using **`vsprintf`**, there is no way to limit the number of characters written, which means that code using this function is susceptible to buffer overruns. Use [`_vsnprintf`](vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md) instead, or call [`_vscprintf`](vscprintf-vscprintf-l-vscwprintf-vscwprintf-l.md) to determine how large a buffer is needed. Also, ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). **`vswprintf`** conforms to the ISO C Standard, which requires the second parameter, *`count`*, of type **`size_t`**. To force the old nonstandard behavior, define `_CRT_NON_CONFORMING_SWPRINTFS`. The old behavior may not be in a future version, so code should be changed to use the new conformant behavior. From 419ec5913655eb5a355e7678c60dbd80d51e0d1f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 15 Jun 2025 19:00:27 +0800 Subject: [PATCH 0075/1799] Update metadata in loads of CRT references --- .../cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md | 4 ++-- .../reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md | 4 ++-- .../fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md | 4 ++-- .../fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md | 4 ++-- docs/c-runtime-library/reference/get-printf-count-output.md | 4 ++-- .../scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md | 4 ++-- .../reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md | 4 ++-- .../snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md | 2 +- .../sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md | 4 ++-- .../sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md | 4 ++-- .../sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md | 4 ++-- .../reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md | 4 ++-- .../vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md | 4 ++-- .../vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md | 4 ++-- .../reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md | 4 ++-- .../vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md | 4 ++-- .../vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md | 4 ++-- .../reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md | 4 ++-- .../vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md | 2 +- ...s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md | 2 +- .../vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md | 4 ++-- .../vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md | 4 ++-- .../vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md | 4 ++-- 23 files changed, 43 insertions(+), 43 deletions(-) diff --git a/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md b/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md index 04327a288f6..0c80a6f0680 100644 --- a/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md +++ b/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l" title: "_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l" +ms.date: 3/9/2021 api_name: ["_cwprintf_s_l", "_cprintf_s_l", "_cprintf_s", "_cwprintf_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md b/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md index 97f93e31bb4..19afc35f938 100644 --- a/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md +++ b/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: fprintf, _fprintf_l, fwprintf, _ftprintf, _ftprintf_l" title: "fprintf, _fprintf_l, fwprintf, _fwprintf_l, _ftprintf, _ftprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: fprintf, _fprintf_l, fwprintf, _ftprintf, _ftprintf_l" +ms.date: 3/9/2021 api_name: ["fwprintf", "fprintf", "_fprintf_l", "_fwprintf_l", "_ftprintf", "_ftprintf_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md b/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md index c5b3f18335e..67e942623e3 100644 --- a/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md +++ b/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _fprintf_p, _fprintf_p_l, _ftprintf_p, _ftprintf_p_l, _fwprintf_p, _fwprintf_p_l" title: "_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _fprintf_p, _fprintf_p_l, _ftprintf_p, _ftprintf_p_l, _fwprintf_p, _fwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_fwprintf_p", "_fprintf_p_l", "_fwprintf_p_l", "_fprintf_p"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md b/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md index e3bda3573f6..4d8fe4b93ee 100644 --- a/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md +++ b/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l, _ftprintf_s, _ftprintf_s_l" title: "fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l, _ftprintf_s, _ftprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l, _ftprintf_s, _ftprintf_s_l" +ms.date: 3/9/2021 api_name: ["_fprintf_s_l", "fwprintf_s", "fprintf_s", "_fwprintf_s_l", "_ftprintf_s", "_ftprintf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/get-printf-count-output.md b/docs/c-runtime-library/reference/get-printf-count-output.md index a1cfde65efa..14046943faf 100644 --- a/docs/c-runtime-library/reference/get-printf-count-output.md +++ b/docs/c-runtime-library/reference/get-printf-count-output.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _get_printf_count_output" title: "_get_printf_count_output" -ms.date: "3/9/2021" +description: "Learn more about: _get_printf_count_output" +ms.date: 3/9/2021 api_name: ["_get_printf_count_output"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md b/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md index 0638e1bcd92..8067e1ed052 100644 --- a/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md +++ b/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l" title: "_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_scwprintf_p", "_scprintf_p_l", "_scwprintf_p_l", "_scprintf_p"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md b/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md index 44e76a4d9f9..0d2d23af0d5 100644 --- a/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md +++ b/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _scprintf, _scprintf_l, _scwprintf, _scwprintf_l" title: "_scprintf, _scprintf_l, _scwprintf, _scwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: _scprintf, _scprintf_l, _scwprintf, _scwprintf_l" +ms.date: 3/9/2021 api_name: ["_scprintf_l", "_scwprintf", "_scwprintf_l", "_scprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md b/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md index ab9131675a3..9b0fce0a47d 100644 --- a/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md +++ b/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l" title: "_snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l" +description: "Learn more about: _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l" ms.date: 06/27/2023 api_name: ["_snprintf_s", "_snprintf_s_l", "_snwprintf_s", "_snwprintf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntoskrnl.exe"] diff --git a/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md b/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md index cb2fa215590..2d9abe99449 100644 --- a/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md +++ b/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l" title: "_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l" +ms.date: 3/9/2021 api_name: ["_sprintf_p", "_swprintf_p_l", "_swprintf_p", "_sprintf_p_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md b/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md index 87b3cfd7c3f..f78c0ea9df5 100644 --- a/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md +++ b/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l" title: "sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l" +ms.date: 3/9/2021 api_name: ["_swprintf_s_l", "_sprintf_s_l", "swprintf_s", "sprintf_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md b/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md index df177cff1f9..f386fc7dfd5 100644 --- a/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md +++ b/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: sprintf, _sprintf_l, swprintf, _swprintf, _swprintf_l, __swprintf_l" title: "sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: sprintf, _sprintf_l, swprintf, _swprintf, _swprintf_l, __swprintf_l" +ms.date: 3/9/2021 api_name: ["__swprintf_l", "sprintf", "_sprintf_l", "_swprintf_l", "swprintf", "_swprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ntdll.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md b/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md index 5f048b91b05..236d8685bef 100644 --- a/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md +++ b/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l" title: "_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l" +ms.date: 3/9/2021 api_name: ["_vcwprintf", "_vcprintf_l", "_vcwprintf_l", "_vcprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md b/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md index ae72ac569f9..1da2fe9b48e 100644 --- a/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l" title: "_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_vfprintf_p", "_vfwprintf_p", "_vfprintf_p_l", "_vfwprintf_p_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md b/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md index 0310a6a5fa3..5b805440d0e 100644 --- a/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l" title: "vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l" +ms.date: 3/9/2021 api_name: ["vfwprintf_s", "_vfprintf_s_l", "vfprintf_s", "_vfwprintf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md b/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md index f15d6242269..3c06a9bf539 100644 --- a/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md +++ b/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l" title: "vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l" +ms.date: 3/9/2021 api_name: ["_vfprintf_l", "vfprintf", "vfwprintf", "_vfwprintf_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md b/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md index fe005331e41..239ea8e1b57 100644 --- a/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l" title: "_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_vwprintf_p", "_vprintf_p", "_vprintf_p_l", "_vwprintf_p_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md b/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md index f363f5a734d..b1a404e8fc5 100644 --- a/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l" title: "vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l" +ms.date: 3/9/2021 api_name: ["_vwprintf_s_l", "vwprintf_s", "_vprintf_s_l", "vprintf_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md b/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md index 853325f181e..e91e6092aeb 100644 --- a/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md +++ b/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vprintf, _vprintf_l, vwprintf, _vwprintf_l" title: "vprintf, _vprintf_l, vwprintf, _vwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: vprintf, _vprintf_l, vwprintf, _vwprintf_l" +ms.date: 3/9/2021 api_name: ["vprintf", "_vwprintf_l", "_vprintf_l", "vwprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md b/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md index 6a8b654d06c..388f6f46a27 100644 --- a/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md @@ -1,7 +1,7 @@ --- title: "_vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_l" description: "Learn more about: _vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_l" -ms.date: "10/21/2021" +ms.date: 10/21/2021 api_name: ["_vscprintf_p_l", "_vscprintf_p", "_vscwprintf_p_l", "_vscwprintf_p"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md b/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md index 7686c45c0ea..341e63eaa5e 100644 --- a/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l" title: "vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l" +description: "Learn more about: vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l" ms.date: 06/27/2023 api_name: ["_vsnwprintf_s", "_vsnwprintf_s_l", "_vsnprintf_s", "vsnprintf_s", "_vsnprintf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ntdll.dll", "ucrtbase.dll", "ntoskrnl.exe"] diff --git a/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md b/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md index 6600535e0a0..7b74d3eb27a 100644 --- a/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md +++ b/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l" title: "_vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l" +ms.date: 3/9/2021 api_name: ["_vsprintf_p", "_vswprintf_p", "_vsprintf_p_l", "_vswprintf_p_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md b/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md index b623469c2fb..94c4dc36323 100644 --- a/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md +++ b/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l" title: "vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l, _vstprintf_s, _vstprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l" +ms.date: 3/9/2021 api_name: ["_vswprintf_s_l", "vsprintf_s", "vswprintf_s", "_vsprintf_s_l", _vstprintf_s, _vstprintf_s_l] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md b/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md index 04e340f2333..e5eadb3323b 100644 --- a/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md +++ b/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l" title: "vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l" +ms.date: 3/9/2021 api_name: ["_vswprintf_l", "_vsprintf_l", "vsprintf", "vswprintf", "__vswprintf_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] From c7074537ed299ce0d5299b2bd1adcfc07dcaac8d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 17 Jun 2025 00:25:02 +0800 Subject: [PATCH 0076/1799] Elide single stray parenthesis and square bracket --- docs/standard-library/basic-istringstream-class.md | 2 +- docs/standard-library/ctype-char-class.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/basic-istringstream-class.md b/docs/standard-library/basic-istringstream-class.md index 18872277c26..ddae99f87f7 100644 --- a/docs/standard-library/basic-istringstream-class.md +++ b/docs/standard-library/basic-istringstream-class.md @@ -102,7 +102,7 @@ An rvalue reference of a `basic_istringstream` object. ### Remarks -The first constructor initializes the base class by calling `basic_istream]( sb )`, where `sb` is the stored object of class `basic_stringbuf< Elem, Tr, Alloc>`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc >( _Mode | ios_base::in )`. For more information, see [`basic_istream`](../standard-library/basic-istream-class.md) and [`basic_stringbuf`](../standard-library/basic-stringbuf-class.md). +The first constructor initializes the base class by calling `basic_istream( sb )`, where `sb` is the stored object of class `basic_stringbuf< Elem, Tr, Alloc>`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc >( _Mode | ios_base::in )`. For more information, see [`basic_istream`](../standard-library/basic-istream-class.md) and [`basic_stringbuf`](../standard-library/basic-stringbuf-class.md). The second constructor initializes the base class by calling `basic_istream( sb )`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc >( str, _Mode | ios_base::in )`. diff --git a/docs/standard-library/ctype-char-class.md b/docs/standard-library/ctype-char-class.md index d56cfcc8119..8a0c452ec94 100644 --- a/docs/standard-library/ctype-char-class.md +++ b/docs/standard-library/ctype-char-class.md @@ -107,7 +107,7 @@ The explicit specialization differs from the class template in several ways: - The static member object `table_size` specifies the minimum number of elements in a ctype mask table. -- The protected static member function `classic_table`( returns the ctype mask table appropriate to the "C" locale. +- The protected static member function `classic_table` returns the ctype mask table appropriate to the "C" locale. - There are no protected virtual member functions [do_is](../standard-library/ctype-class.md#do_is), [do_scan_is](../standard-library/ctype-class.md#do_scan_is), or [do_scan_not](../standard-library/ctype-class.md#do_scan_not). The corresponding public member functions perform the equivalent operations themselves. From 0591287e6c65e5e8ae9d5090d0e9d4f1645183aa Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 17 Jun 2025 00:42:30 +0800 Subject: [PATCH 0077/1799] Clean up unnecessary use of ` ` --- docs/dotnet/auto-gcroot-class.md | 4 ++-- docs/dotnet/com-ptr-class.md | 2 +- docs/dotnet/lock-class.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/dotnet/auto-gcroot-class.md b/docs/dotnet/auto-gcroot-class.md index 073b6c06ab5..2c1c4e2fb9b 100644 --- a/docs/dotnet/auto-gcroot-class.md +++ b/docs/dotnet/auto-gcroot-class.md @@ -47,8 +47,8 @@ The managed type to be embedded. |---------|-----------| |[`auto_gcroot::operator->`](#operator-arrow)|The member access operator.| |[auto_gcroot::operator=](#operator-assign)|Assignment operator.| -|[auto_gcroot::operator auto_gcroot](#operator-auto-gcroot)|Type-cast operator between `auto_gcroot` and compatible types.| -|[auto_gcroot::operator bool](#operator-bool)|Operator for using `auto_gcroot` in a conditional expression.| +|[auto_gcroot::operator auto_gcroot](#operator-auto-gcroot)|Type-cast operator between `auto_gcroot` and compatible types.| +|[auto_gcroot::operator bool](#operator-bool)|Operator for using `auto_gcroot` in a conditional expression.| |[auto_gcroot::operator!](#operator-logical-not)|Operator for using `auto_gcroot` in a conditional expression.| ## Requirements diff --git a/docs/dotnet/com-ptr-class.md b/docs/dotnet/com-ptr-class.md index 047e3491791..634711c835b 100644 --- a/docs/dotnet/com-ptr-class.md +++ b/docs/dotnet/com-ptr-class.md @@ -173,7 +173,7 @@ int main() { |---------|-----------| |[`ptr::operator->`](#operator-arrow)|Member access operator, used to call methods on the owned COM object.| |[ptr::operator=](#operator-assign)|Attaches a COM object to a `com::ptr`.| -|[ptr::operator bool](#operator-bool)|Operator for using `com::ptr` in a conditional expression.| +|[ptr::operator bool](#operator-bool)|Operator for using `com::ptr` in a conditional expression.| |[ptr::operator!](#operator-logical-not)|Operator to determine if the owned COM object is invalid.| ## Requirements diff --git a/docs/dotnet/lock-class.md b/docs/dotnet/lock-class.md index 62bfe76335f..a5efc6d7bb2 100644 --- a/docs/dotnet/lock-class.md +++ b/docs/dotnet/lock-class.md @@ -45,7 +45,7 @@ Internally, the lock class uses to synchronize a |Name|Description| |---------|-----------| -|[lock::operator bool](#operator-bool)|Operator for using `lock` in a conditional expression.| +|[lock::operator bool](#operator-bool)|Operator for using `lock` in a conditional expression.| |[lock::operator==](#operator-equality)|Equality operator.| |[lock::operator!=](#operator-inequality)|Inequality operator.| From 1b96cd8fe730dbc2a954488c2470223ae38a0181 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 17 Jun 2025 00:43:26 +0800 Subject: [PATCH 0078/1799] Update metadata in a couple of dotnet reference topics --- docs/dotnet/auto-gcroot-class.md | 2 +- docs/dotnet/com-ptr-class.md | 5 ++--- docs/dotnet/lock-class.md | 5 ++--- 3 files changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/dotnet/auto-gcroot-class.md b/docs/dotnet/auto-gcroot-class.md index 2c1c4e2fb9b..0998fb94764 100644 --- a/docs/dotnet/auto-gcroot-class.md +++ b/docs/dotnet/auto-gcroot-class.md @@ -1,7 +1,7 @@ --- title: "auto_gcroot Class" description: "Learn more about: auto_gcroot Class" -ms.date: "01/16/2019" +ms.date: 01/16/2019 ms.topic: "reference" f1_keywords: ["msclr::auto_gcroot::auto_gcroot", "msclr::auto_gcroot::attach", "msclr::auto_gcroot::get", "msclr::auto_gcroot::release", "msclr::auto_gcroot::reset", "msclr::auto_gcroot::swap", "msclr::auto_gcroot::operator=", "msclr::auto_gcroot::operator->", "msclr::auto_gcroot::operator!", "msclr::auto_gcroot::operator auto_gcroot"] helpviewer_keywords: ["msclr::auto_gcroot"] diff --git a/docs/dotnet/com-ptr-class.md b/docs/dotnet/com-ptr-class.md index 634711c835b..e72c3f8d9e0 100644 --- a/docs/dotnet/com-ptr-class.md +++ b/docs/dotnet/com-ptr-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: com::ptr Class" title: "com::ptr Class" -ms.date: "01/16/2019" +description: "Learn more about: com::ptr Class" +ms.date: 01/16/2019 ms.topic: "reference" f1_keywords: ["msclr::com::ptr::ptr", "msclr::com::ptr::Attach", "msclr::com::ptr::CreateInstance", "msclr::com::ptr::Detach", "msclr::com::ptr::GetInterface", "msclr::com::ptr::QueryInterface", "msclr::com::ptr::Release", "msclr::com::ptr::operator=", "msclr::com::ptr::operator->", "msclr::com::ptr::operator!"] helpviewer_keywords: ["msclr::ptr class"] -ms.assetid: 0144d0e4-919c-45f9-a3f8-fbc9edba32bf --- # com::ptr Class diff --git a/docs/dotnet/lock-class.md b/docs/dotnet/lock-class.md index a5efc6d7bb2..98e44d2673f 100644 --- a/docs/dotnet/lock-class.md +++ b/docs/dotnet/lock-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: lock Class" title: "lock Class" -ms.date: "01/16/2019" +description: "Learn more about: lock Class" +ms.date: 01/16/2019 ms.topic: "reference" f1_keywords: ["msclr::lock::lock", "msclr::lock::is_locked", "msclr::lock.is_locked", "msclr::lock::acquire", "msclr::lock::try_acquire", "msclr::lock::release", "msclr::lock::operator==", "msclr::lock::operator!="] helpviewer_keywords: ["msclr::lock class"] -ms.assetid: 5123edd9-6aed-497d-9a0b-f4b6d6c0d666 --- # lock Class From 7026c3993013f77b7d03c5b5a31046d08720ec5f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 17 Jun 2025 01:12:17 +0800 Subject: [PATCH 0079/1799] Fix incomplete link for backticked terms --- .../reference/strtol-wcstol-strtol-l-wcstol-l.md | 2 +- docs/standard-library/year-month-weekday-class.md | 2 +- docs/standard-library/zoned-time-class.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md b/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md index 4ae62a70e13..e67a1099070 100644 --- a/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md +++ b/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md @@ -65,7 +65,7 @@ Locale to use. The **`strtol`**, **`wcstol`**, **`_strtol_l`**, and **`_wcstol_l`** functions convert *`string`* to a **`long`**. They stop reading *`string`* at the first character not recognized as part of a number. It may be the terminating-null character, or the first alphanumeric character greater than or equal to *`base`*. -**`wcstol`** and **`_wcstol_l`** are wide-character versions of **`strtol`** and **`_strtol_l`**. Their *`string`* argument is a wide-character string. These functions behave identically to **`strtol`** and **`_strtol_l`** otherwise. The locale's `LC_NUMERIC` category setting determines recognition of the radix character (the fractional marker or decimal point) in *`string`*. The functions **`strtol`** and **`wcstol`** use the current locale. **`_strtol_l`** and **`_wcstol_l`** use the locale passed in instead. For more information, see [`setlocale`] and [Locale](../locale.md). +**`wcstol`** and **`_wcstol_l`** are wide-character versions of **`strtol`** and **`_strtol_l`**. Their *`string`* argument is a wide-character string. These functions behave identically to **`strtol`** and **`_strtol_l`** otherwise. The locale's `LC_NUMERIC` category setting determines recognition of the radix character (the fractional marker or decimal point) in *`string`*. The functions **`strtol`** and **`wcstol`** use the current locale. **`_strtol_l`** and **`_wcstol_l`** use the locale passed in instead. For more information, see [`setlocale`](setlocale-wsetlocale.md) and [Locale](../locale.md). When *`end_ptr`* is `NULL`, it's ignored. Otherwise, a pointer to the character that stopped the scan is stored at the location pointed to by *`end_ptr`*. No conversion is possible if no valid digits are found, or an invalid base is specified. The value of *`string`* is then stored at the location pointed to by *`end_ptr`*. diff --git a/docs/standard-library/year-month-weekday-class.md b/docs/standard-library/year-month-weekday-class.md index 58e77234861..24e400121bd 100644 --- a/docs/standard-library/year-month-weekday-class.md +++ b/docs/standard-library/year-month-weekday-class.md @@ -36,7 +36,7 @@ class year_month_weekday; // C++20 | [`operator local_days`](#local_days) | Get the count of days from the `system_clock` epoch to this `year_month_weekday` as [`local_days`](chrono.md#typedefs). | | [`operator sys_days`](#sys_days) | Get the count of days from the `system_clock` epoch to this `year_month_weekday` as [`sys_days`](chrono.md#typedefs). | | [`weekday`](#weekday) | Get the weekday. | -| [`weekday_indexed`](#weekday_indexed) | Get the [`weekday_indexed`] stored in this `year_month_weekday`. | +| [`weekday_indexed`](#weekday_indexed) | Get the [`weekday_indexed`](weekdayindexed-class.md) stored in this `year_month_weekday`. | | [`year`](#year) | Get the year. | ## Non-members diff --git a/docs/standard-library/zoned-time-class.md b/docs/standard-library/zoned-time-class.md index 3817f02d552..3fbc4f7dcc1 100644 --- a/docs/standard-library/zoned-time-class.md +++ b/docs/standard-library/zoned-time-class.md @@ -345,7 +345,7 @@ int main() 1\) The default copy assignment operator. Copies (doesn't move) the stored [`time_point`](time-point-class.md) and [time_zone](time-zone-class.md) pointer from the other `zoned_time` into this `zoned_time`. 2\) Assigns `st` to the [`time_point`](time-point-class.md) in this `zoned_time`. After the assignment, `*this->get_sys_time() == st;` -3\) Converts `lt` (a `local_time`) to a `sys_time`. It does this essentially as `timeZone->to_sys(lt)`, and assigns the result to the [`time_point`] in this `zoned_time`. After the assignment, `*this->get_local_time() == lt;` +3\) Converts `lt` (a `local_time`) to a `sys_time`. It does this essentially as `timeZone->to_sys(lt)`, and assigns the result to the [`time_point`](time-point-class.md) in this `zoned_time`. After the assignment, `*this->get_local_time() == lt;` ## `operator local_time` From 80f9405ecde7805f5e7dc041e0bebcd5e2acf900 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 17 Jun 2025 01:12:56 +0800 Subject: [PATCH 0080/1799] Update metadata for 2 topics --- .../reference/strtol-wcstol-strtol-l-wcstol-l.md | 4 ++-- docs/standard-library/year-month-weekday-class.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md b/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md index e67a1099070..1b097545911 100644 --- a/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md +++ b/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: strtol, wcstol, _strtol_l, _wcstol_l" title: "strtol, wcstol, _strtol_l, _wcstol_l" -ms.date: "4/2/2020" +description: "Learn more about: strtol, wcstol, _strtol_l, _wcstol_l" +ms.date: 4/2/2020 api_name: ["strtol", "wcstol", "_strtol_l", "_wcstol_l", "_o__strtol_l", "_o__wcstol_l", "_o_strtol", "_o_wcstol"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/standard-library/year-month-weekday-class.md b/docs/standard-library/year-month-weekday-class.md index 24e400121bd..58ac63bf908 100644 --- a/docs/standard-library/year-month-weekday-class.md +++ b/docs/standard-library/year-month-weekday-class.md @@ -1,7 +1,7 @@ --- title: "year_month_weekday class" description: "Learn more about: year_month_weekday class" -ms.date: "06/30/2021" +ms.date: 06/30/2021 f1_keywords: ["chrono/std::chrono::year_month_weekday", "chrono/std::chrono::year_month_weekday::weekday", "chrono/std::chrono::year_month_weekday::month", "chrono/std::chrono::year_month_weekday::index", "chrono/std::chrono::year_month_weekday::year", "chrono/std::chrono::year_month_weekday::weekday", "chrono/std::chrono::year_month_weekday::weekday_indexed", "chrono/std::chrono::year_month_weekday::sys_days", "chrono/std::chrono::year_month_weekday::local_days", "chrono/std::chrono::year_month_weekday::ok", "chrono/std::chrono::year_month_weekday::operator+=", "chrono/std::chrono::year_month_weekday::operator-=", "chrono/std::chrono::year_month_weekday::operator local_days", "chrono/std::chrono::year_month_weekday::operator sys_days"] helpviewer_keywords: ["std::chrono [C++], year_month_weekday"] dev_langs: ["C++"] From 298b991edd2f988905048523475cc67cbe017a5f Mon Sep 17 00:00:00 2001 From: Nathalie Laroche <635965+nathlaroche@users.noreply.github.com> Date: Tue, 17 Jun 2025 11:02:29 -0400 Subject: [PATCH 0081/1799] ms.topic update phase 1: update conceptual values and docfx.json --- docs/atl-mfc-shared/atl-mfc-shared-classes.md | 2 +- docs/c-runtime-library/ansi-c-compliance.md | 2 +- docs/c-runtime-library/backward-compatibility.md | 2 +- docs/c-runtime-library/byte-and-wide-streams.md | 2 +- docs/c-runtime-library/code-pages.md | 2 +- docs/c-runtime-library/compatibility.md | 2 +- docs/c-runtime-library/controlling-streams.md | 2 +- docs/c-runtime-library/crt-initialization.md | 2 +- docs/c-runtime-library/direction-flag.md | 2 +- docs/c-runtime-library/files-and-streams.md | 2 +- docs/c-runtime-library/global-state.md | 2 +- docs/c-runtime-library/internationalization.md | 2 +- .../locale-names-languages-and-country-region-strings.md | 2 +- .../c-runtime-library/multithreaded-libraries-performance.md | 2 +- docs/c-runtime-library/parameter-validation.md | 2 +- ...ntial-errors-passing-crt-objects-across-dll-boundaries.md | 2 +- ...ommendations-for-choosing-between-functions-and-macros.md | 2 +- docs/c-runtime-library/required-and-optional-header-files.md | 2 +- docs/c-runtime-library/sal-annotations.md | 2 +- docs/c-runtime-library/sbcs-and-mbcs-data-types.md | 2 +- docs/c-runtime-library/secure-template-overloads.md | 2 +- docs/c-runtime-library/security-features-in-the-crt.md | 2 +- .../single-byte-and-multibyte-character-sets.md | 2 +- docs/c-runtime-library/text-and-binary-streams.md | 2 +- docs/c-runtime-library/tgmath.md | 2 +- .../unicode-stream-i-o-in-text-and-binary-modes.md | 2 +- docs/c-runtime-library/unicode-the-wide-character-set.md | 2 +- docs/c-runtime-library/unix.md | 2 +- docs/c-runtime-library/using-generic-text-mappings.md | 2 +- docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md | 2 +- docs/code-quality/annotating-function-behavior.md | 2 +- .../annotating-function-parameters-and-return-values.md | 2 +- docs/code-quality/annotating-locking-behavior.md | 2 +- docs/code-quality/annotating-structs-and-classes.md | 2 +- docs/code-quality/best-practices-and-examples-sal.md | 2 +- docs/code-quality/build-reliable-secure-programs.md | 2 +- docs/code-quality/c26132.md | 2 +- docs/code-quality/c26133.md | 2 +- docs/code-quality/clang-tidy.md | 2 +- docs/code-quality/code-analysis-for-c-cpp-overview.md | 2 +- ...how-to-set-code-analysis-properties-for-c-cpp-projects.md | 1 - ...y-additional-code-information-by-using-analysis-assume.md | 1 - docs/code-quality/intrinsic-functions.md | 2 +- docs/code-quality/quick-start-code-analysis-for-c-cpp.md | 2 +- .../specifying-when-and-where-an-annotation-applies.md | 2 +- docs/code-quality/understanding-sal.md | 2 +- .../using-rule-sets-to-specify-the-cpp-rules-to-run.md | 2 +- .../using-sal-annotations-to-reduce-c-cpp-code-defects.md | 2 +- docs/code-quality/using-the-cpp-core-guidelines-checkers.md | 2 +- .../walkthrough-analyzing-c-cpp-code-for-defects.md | 2 +- docs/cpp/cpp-type-system-modern-cpp.md | 2 +- docs/cpp/errors-and-exception-handling-modern-cpp.md | 2 +- .../how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md | 1 - docs/cpp/how-to-create-and-use-shared-ptr-instances.md | 1 - docs/cpp/how-to-create-and-use-unique-ptr-instances.md | 1 - docs/cpp/how-to-create-and-use-weak-ptr-instances.md | 1 - docs/cpp/how-to-design-for-exception-safety.md | 1 - ...interface-between-exceptional-and-non-exceptional-code.md | 1 - .../object-lifetime-and-resource-management-modern-cpp.md | 2 +- docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md | 2 +- docs/cpp/portability-at-abi-boundaries-modern-cpp.md | 2 +- docs/cpp/smart-pointers-modern-cpp.md | 2 +- docs/cpp/type-conversions-and-type-safety-modern-cpp.md | 2 +- docs/cpp/value-types-modern-cpp.md | 2 +- docs/cpp/welcome-back-to-cpp-modern-cpp.md | 2 +- docs/docfx.json | 5 ++++- docs/porting/ide-tools-for-upgrading-code.md | 2 +- docs/text/string-and-i-o-formatting-modern-cpp.md | 2 +- docs/windows/attributes/attributes-alphabetical-reference.md | 2 +- docs/windows/attributes/attributes-by-group.md | 2 +- docs/windows/attributes/attributes-by-usage.md | 2 +- docs/windows/attributes/cpp-attributes-com-net.md | 2 +- 72 files changed, 67 insertions(+), 72 deletions(-) diff --git a/docs/atl-mfc-shared/atl-mfc-shared-classes.md b/docs/atl-mfc-shared/atl-mfc-shared-classes.md index 4a0a3edbac8..564d03df38f 100644 --- a/docs/atl-mfc-shared/atl-mfc-shared-classes.md +++ b/docs/atl-mfc-shared/atl-mfc-shared-classes.md @@ -3,7 +3,7 @@ description: "Learn more about: ATL/MFC Shared Classes" title: "ATL-MFC Shared Classes" ms.custom: "index-page" ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["vc.classes.shared"] helpviewer_keywords: ["CPoint class, shared class", "CFileTimeSpan class, shared class", "COleDateTime class, shared class", "CFixedStringT class, shared class", "CStrBufT class, shared class", "CFileTime class, shared class", "CRect class, shared class", "CSimpleStringT class, shared class", "CStringT class, shared class", "CSize class, shared class", "CStringData class, shared class", "IAtlStringMgr class, shared class", "shared classes, MFC and ATL", "COleDateTimeSpan class, shared class", "CString objects, shared class", "shared classes"] ms.assetid: e13aaac3-21ec-4f4d-8834-432b40fde544 diff --git a/docs/c-runtime-library/ansi-c-compliance.md b/docs/c-runtime-library/ansi-c-compliance.md index e9aad2a0856..67c65fbd7c2 100644 --- a/docs/c-runtime-library/ansi-c-compliance.md +++ b/docs/c-runtime-library/ansi-c-compliance.md @@ -2,7 +2,7 @@ title: "ANSI C Conformance" description: "An overview of Microsoft C runtime naming conventions for ANSI C conformance." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["underscores, leading", "compatibility [C++], ANSI C", "conformance with ANSI C", "conventions [C++], Microsoft extensions", "underscores", "naming conventions [C++], Microsoft library", "ANSI [C++], C standard", "Microsoft extensions naming conventions"] ms.assetid: 6be271bf-eecf-491a-a928-0ee2dd60e3b9 --- diff --git a/docs/c-runtime-library/backward-compatibility.md b/docs/c-runtime-library/backward-compatibility.md index 16e0a796c7a..c96ccb67787 100644 --- a/docs/c-runtime-library/backward-compatibility.md +++ b/docs/c-runtime-library/backward-compatibility.md @@ -2,7 +2,7 @@ title: "Backward Compatibility" description: "How to use the Microsoft OLDNAMES.LIB library to map function names for backwards compatibility." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["CRT, compatibility", "backward compatibility, C run-time libraries", "compatibility, C run-time libraries", "backward compatibility"] ms.assetid: cc3175cf-97fd-492f-b329-5791aea63090 --- diff --git a/docs/c-runtime-library/byte-and-wide-streams.md b/docs/c-runtime-library/byte-and-wide-streams.md index 8ef801bf6ce..bc5ab7e6fbe 100644 --- a/docs/c-runtime-library/byte-and-wide-streams.md +++ b/docs/c-runtime-library/byte-and-wide-streams.md @@ -2,7 +2,7 @@ title: "Byte and Wide Streams" description: "An overview of byte streams in the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["byte streams", "wide streams"] --- # Byte and wide streams diff --git a/docs/c-runtime-library/code-pages.md b/docs/c-runtime-library/code-pages.md index e61fe0e5ee8..f8700a2718f 100644 --- a/docs/c-runtime-library/code-pages.md +++ b/docs/c-runtime-library/code-pages.md @@ -1,7 +1,7 @@ --- title: "Code Pages" description: "A description of code page support in the Microsoft C runtime." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "11/04/2016" helpviewer_keywords: ["character sets [C++], code pages", "ANSI [C++], code pages", "system-default code page", "multibyte code pages [C++]", "localization [C++], code pages", "code pages [C++], types of", "locale code pages [C++]"] ms.assetid: 4a26fc42-185a-4add-98bf-a7b314ae6186 diff --git a/docs/c-runtime-library/compatibility.md b/docs/c-runtime-library/compatibility.md index 45f753bf021..0b56d4e3d82 100644 --- a/docs/c-runtime-library/compatibility.md +++ b/docs/c-runtime-library/compatibility.md @@ -2,7 +2,7 @@ title: "Compatibility" description: "Describes the compatibility of the Microsoft Universal C runtime library (UCRT) with the Standard C library, POSIX, the Safe CRT, and Store apps." ms.date: 1/19/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["CRT, compatibility", "compatibility, C runtime libraries", "compatibility"] ms.assetid: 346709cb-edda-4909-9a19-3d253eddb6b7 --- diff --git a/docs/c-runtime-library/controlling-streams.md b/docs/c-runtime-library/controlling-streams.md index 7bdf6321eb2..43c00a11a4c 100644 --- a/docs/c-runtime-library/controlling-streams.md +++ b/docs/c-runtime-library/controlling-streams.md @@ -2,7 +2,7 @@ title: "Controlling Streams" description: "An overview of working with streams in the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["streams, controlling", "controlling streams", "streams"] ms.assetid: 267e9013-9afc-45f6-91e3-ca093230d9d9 --- diff --git a/docs/c-runtime-library/crt-initialization.md b/docs/c-runtime-library/crt-initialization.md index b2971c1be1e..be30e01238f 100644 --- a/docs/c-runtime-library/crt-initialization.md +++ b/docs/c-runtime-library/crt-initialization.md @@ -1,7 +1,7 @@ --- title: "CRT Initialization" description: "Describes how the CRT initializes global state in native code." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: 08/02/2021 helpviewer_keywords: ["CRT initialization [C++]"] --- diff --git a/docs/c-runtime-library/direction-flag.md b/docs/c-runtime-library/direction-flag.md index 1acd9cfb5f3..f3e62b0e4a9 100644 --- a/docs/c-runtime-library/direction-flag.md +++ b/docs/c-runtime-library/direction-flag.md @@ -2,7 +2,7 @@ title: "Direction Flag" description: "Describes the effect of the CPU direction flag on Microsoft C runtime functions." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["direction flag"] ms.assetid: 0836b4af-dbbb-4ab8-a4b2-156f2e2099e2 --- diff --git a/docs/c-runtime-library/files-and-streams.md b/docs/c-runtime-library/files-and-streams.md index 16b6697be76..99c256fc55a 100644 --- a/docs/c-runtime-library/files-and-streams.md +++ b/docs/c-runtime-library/files-and-streams.md @@ -2,7 +2,7 @@ title: "Files and Streams" description: "An overview of files and streams in the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["files [C++]", "streams"] ms.assetid: f61e712b-eac9-4c28-bb18-97c3786ef387 --- diff --git a/docs/c-runtime-library/global-state.md b/docs/c-runtime-library/global-state.md index b1d216c39c7..9a8a36b10de 100644 --- a/docs/c-runtime-library/global-state.md +++ b/docs/c-runtime-library/global-state.md @@ -1,7 +1,7 @@ --- title: "Global state in the CRT" description: "Describes how shared global state is handled in the Microsoft Universal C Runtime." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "10/02/2020" helpviewer_keywords: ["CRT global state"] --- diff --git a/docs/c-runtime-library/internationalization.md b/docs/c-runtime-library/internationalization.md index e66a9a923f6..93d47d0e917 100644 --- a/docs/c-runtime-library/internationalization.md +++ b/docs/c-runtime-library/internationalization.md @@ -2,7 +2,7 @@ title: "Internationalization" ms.date: "09/29/2020" description: "A description of Microsoft runtime library support for writing apps for international markets." -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["localization, routines for", "locale-dependent routines", "internationalization routines", "international applications, run-time routines for"] ms.assetid: ee536a04-3558-4729-8e10-6dabcde055fd --- diff --git a/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md b/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md index dd2fae03a49..ae687afb430 100644 --- a/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md +++ b/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md @@ -1,7 +1,7 @@ --- title: "Locale Names, Languages, and Country-Region Strings" description: "An overview of using Microsoft Universal CRT locale, language, and country and region strings." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "12/10/2018" helpviewer_keywords: ["country/region strings", "localization, locale", "locales", "setlocale function", "language strings"] ms.assetid: a0e5a0c5-5602-4da0-b65f-de3d6c8530a2 diff --git a/docs/c-runtime-library/multithreaded-libraries-performance.md b/docs/c-runtime-library/multithreaded-libraries-performance.md index 12d78d352fe..d1f3cc03464 100644 --- a/docs/c-runtime-library/multithreaded-libraries-performance.md +++ b/docs/c-runtime-library/multithreaded-libraries-performance.md @@ -2,7 +2,7 @@ title: "Multithreaded Libraries Performance" description: "An overview of how to get the most performance from the Microsoft C runtime multithreaded libraries." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["threading [C++], performance", "libraries, multithreaded", "performance, multithreading", "multithreaded libraries"] ms.assetid: faa5d808-087c-463d-8f0d-8c478d137296 --- diff --git a/docs/c-runtime-library/parameter-validation.md b/docs/c-runtime-library/parameter-validation.md index a2d188ec7ed..f63a50cc02c 100644 --- a/docs/c-runtime-library/parameter-validation.md +++ b/docs/c-runtime-library/parameter-validation.md @@ -2,7 +2,7 @@ title: "Parameter Validation" description: "A description of parameter validation in the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["parameters, validation"] ms.assetid: 019dd5f0-dc61-4d2e-b4e9-b66409ddf1f2 --- diff --git a/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md b/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md index 9aac11ab8d6..6dc1fb53c42 100644 --- a/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md +++ b/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md @@ -2,7 +2,7 @@ title: "Potential Errors Passing CRT Objects Across DLL Boundaries" description: "An overview of potential problems you may come across when passing Microsoft C runtime objects across a dynamic link library (DLL) boundary." ms.date: 06/29/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["DLL conflicts [C++]"] ms.assetid: c217ffd2-5d9a-4678-a1df-62a637a96460 --- diff --git a/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md b/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md index 1971598d3b1..57ed7d86d04 100644 --- a/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md +++ b/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md @@ -2,7 +2,7 @@ title: "Recommendations for Choosing Between Functions and Macros" description: "Explains the differences between using macros vs functions in the Microsoft C runtime library (CRT)" ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["c.functions"] helpviewer_keywords: ["functions [CRT], vs. macros", "macros, vs. functions"] ms.assetid: 18a633d6-cf1c-470c-a649-fa7677473e2b diff --git a/docs/c-runtime-library/required-and-optional-header-files.md b/docs/c-runtime-library/required-and-optional-header-files.md index 679afb54500..13fb797a279 100644 --- a/docs/c-runtime-library/required-and-optional-header-files.md +++ b/docs/c-runtime-library/required-and-optional-header-files.md @@ -2,7 +2,7 @@ title: "Required and Optional Header Files" description: "When to use required versus optional header files from the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["c.headers"] helpviewer_keywords: ["include files, required in run time", "header files, required in run time"] ms.assetid: f64d0bf5-e2c3-4b42-97d0-443b3d901d9f diff --git a/docs/c-runtime-library/sal-annotations.md b/docs/c-runtime-library/sal-annotations.md index 1307e5f0a24..3b7f7b24999 100644 --- a/docs/c-runtime-library/sal-annotations.md +++ b/docs/c-runtime-library/sal-annotations.md @@ -2,7 +2,7 @@ title: "SAL Annotations" description: "A brief description of the Microsoft source-code annotation language (SAL)." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["__z annotation", "ref annotation", "_opt annotation", "__checkreturn annotatioin", "__deref_opt annotation", "deref_opt annotation", "__deref annotation", "__in annotation", "annotations [C++]", "z annotation", "_inout annotation", "__ref annotation", "full annotation", "_in annotation", "_ref annotation", "__out annotation", "_ecount annotation", "SAL annotations", "__opt annotation", "inout annotation", "in annotation", "_CA_SHOULD_CHECK_RETURN", "__bcount annotation", "_full annotation", "_bcount annotation", "deref annotation", "part annotation", "_out annotation", "__nz annotation", "__part annotation", "opt annotation", "__full annotation", "_nz annotation", "_z annotation", "out annotation", "__ecount annotation", "__inout annotation", "SAL annotations, _CA_SHOULD_CHECK_RETURN", "_deref_opt annotation", "_deref annotation", "nz annotation", "_part annotation", "ecount annotation", "bcount annotation"] ms.assetid: 81893638-010c-41a0-9cb3-666fe360f3e0 --- diff --git a/docs/c-runtime-library/sbcs-and-mbcs-data-types.md b/docs/c-runtime-library/sbcs-and-mbcs-data-types.md index 71473d9c2b6..c2111a54b41 100644 --- a/docs/c-runtime-library/sbcs-and-mbcs-data-types.md +++ b/docs/c-runtime-library/sbcs-and-mbcs-data-types.md @@ -1,7 +1,7 @@ --- title: "SBCS and MBCS Data Types" description: "How to represent single and multibyte characters in the Microsoft C runtime." -ms.topic: "conceptual" +ms.topic: "how-to" ms.date: "04/11/2018" f1_keywords: ["_MBCS", "MBCS", "SBCS"] helpviewer_keywords: ["SBCS and MBCS data types", "data types [C], MBCS and SBCS"] diff --git a/docs/c-runtime-library/secure-template-overloads.md b/docs/c-runtime-library/secure-template-overloads.md index 865c43c2abf..99f5ab2d923 100644 --- a/docs/c-runtime-library/secure-template-overloads.md +++ b/docs/c-runtime-library/secure-template-overloads.md @@ -2,7 +2,7 @@ title: "Secure Template Overloads" description: "A description of Microsoft C runtime template overloads that provide security-enhanced functions." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES", "_CRT_SECURE_CPP_OVERLOAD_SECURE_NAMES", "_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES_COUNT"] helpviewer_keywords: ["_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES", "_CRT_SECURE_CPP_OVERLOAD_SECURE_NAMES", "_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES_COUNT", "secure template overloads"] ms.assetid: 562741d0-39c0-485e-8529-73d740f29f8f diff --git a/docs/c-runtime-library/security-features-in-the-crt.md b/docs/c-runtime-library/security-features-in-the-crt.md index 06117a37fda..624d6d1b9eb 100644 --- a/docs/c-runtime-library/security-features-in-the-crt.md +++ b/docs/c-runtime-library/security-features-in-the-crt.md @@ -2,7 +2,7 @@ title: "Security Features in the CRT" description: "An overview of secure CRT functions in the Microsoft C runtime." ms.date: "09/29/2020" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["_CRT_SECURE_NO_DEPRECATE", "_CRT_NONSTDC_NO_DEPRECATE", "_CRT_NONSTDC_NO_WARNINGS", "_CRT_SECURE_NO_WARNINGS"] helpviewer_keywords: ["security deprecation warnings [C++]", "CRT_NONSTDC_NO_DEPRECATE", "buffers [C++], buffer overruns", "deprecation warnings (security-related), disabling", "_CRT_NONSTDC_NO_WARNINGS", "security [CRT]", "_CRT_SECURE_NO_WARNINGS", "_CRT_NONSTDC_NO_DEPRECATE", "_CRT_SECURE_NO_DEPRECATE", "security-enhanced CRT", "CRT_SECURE_NO_WARNINGS", "CRT_SECURE_NO_DEPRECATE", "deprecation warnings (security-related)", "buffer overruns", "CRT_NONSTDC_NO_WARNINGS", "CRT, security enhancements", "parameters [C++], validation"] --- diff --git a/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md b/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md index 7828ab3cc97..7d409c365c4 100644 --- a/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md +++ b/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md @@ -1,7 +1,7 @@ --- title: "Single-Byte and Multibyte Character Sets" description: "An introduction to single and multi-byte character sets in the Microsoft runtime library." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "11/04/2016" helpviewer_keywords: ["SBCS (single byte character set)", "MBCS [C++], about MBCS", "character sets [C++], multibyte", "character sets [C++], single byte"] ms.assetid: 2cbc78ea-33c0-4cfb-b0df-7ce2458431ce diff --git a/docs/c-runtime-library/text-and-binary-streams.md b/docs/c-runtime-library/text-and-binary-streams.md index 5150344ec6a..6faf1178a3e 100644 --- a/docs/c-runtime-library/text-and-binary-streams.md +++ b/docs/c-runtime-library/text-and-binary-streams.md @@ -2,7 +2,7 @@ title: "Text and Binary Streams" description: "A description of text and binary streams in the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["binary streams", "text streams"] ms.assetid: 57035e4a-955d-4e04-a560-fcf67ce68b4e --- diff --git a/docs/c-runtime-library/tgmath.md b/docs/c-runtime-library/tgmath.md index dff2a61f166..87240aaa4d0 100644 --- a/docs/c-runtime-library/tgmath.md +++ b/docs/c-runtime-library/tgmath.md @@ -1,7 +1,7 @@ --- title: "Type-generic math" description: "Describes macros in that make it easier to write C code that calls the correct math function, based on argument type." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "6/28/2021" helpviewer_keywords: ["CRT tgmath.h"] --- diff --git a/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md b/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md index c6c1034d8e8..2a38a3ec735 100644 --- a/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md +++ b/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md @@ -1,7 +1,7 @@ --- title: "Unicode Stream I/O in Text and Binary Modes" description: "A description of character conversions with Unicode stream I/O." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "11/04/2016" helpviewer_keywords: ["stream I/O routines", "I/O [CRT], unicode stream", "Unicode, stream I/O routines", "Unicode stream I/O"] ms.assetid: 68be0c3e-a9e6-4fd5-b34a-1b5207f0e7d6 diff --git a/docs/c-runtime-library/unicode-the-wide-character-set.md b/docs/c-runtime-library/unicode-the-wide-character-set.md index 9fbde6648ea..b78b180c2a1 100644 --- a/docs/c-runtime-library/unicode-the-wide-character-set.md +++ b/docs/c-runtime-library/unicode-the-wide-character-set.md @@ -1,7 +1,7 @@ --- title: "Unicode: The Wide-Character Set" description: "An introduction to the Unicode wide character set in the Microsoft C runtime." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "11/04/2016" helpviewer_keywords: ["Unicode [C++], wide character set", "wide characters [C++], Unicode"] ms.assetid: b6a05a21-59a5-4d30-8c85-2dbe185f7a74 diff --git a/docs/c-runtime-library/unix.md b/docs/c-runtime-library/unix.md index 5d63b80fd2b..e8aec366940 100644 --- a/docs/c-runtime-library/unix.md +++ b/docs/c-runtime-library/unix.md @@ -2,7 +2,7 @@ title: "UNIX" description: "Guidelines for porting your program to Unix." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["unix"] helpviewer_keywords: ["UNIX", "POSIX compatibility", "POSIX file names", "UNIX, compatibility"] ms.assetid: 40792414-7a5b-415d-bfa8-2bfb1ebb3731 diff --git a/docs/c-runtime-library/using-generic-text-mappings.md b/docs/c-runtime-library/using-generic-text-mappings.md index 357e8f4a54d..388ffd33974 100644 --- a/docs/c-runtime-library/using-generic-text-mappings.md +++ b/docs/c-runtime-library/using-generic-text-mappings.md @@ -1,7 +1,7 @@ --- title: "Using Generic-Text Mappings" description: "An introduction to Microsoft-specific mappings for data types, routines, and other objects in the C runtime." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "11/04/2016" f1_keywords: ["_UNICODE"] helpviewer_keywords: ["_TXCHAR type", "TINT type", "_TCHAR type", "TSCHAR type", "TEXT type", "TCHAR type", "TCHAR.H data types, mappings defined in", "generic-text data types", "_TINT type", "TUCHAR type", "_UNICODE constant", "TXCHAR type", "generic-text mappings", "_TSCHAR type", "T type", "mappings, generic-text", "_TUCHAR type", "MBCS data type", "_MBCS data type", "_TEXT type", "UNICODE constant", "_T type"] diff --git a/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md b/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md index 2a18a516783..9a6ab1ceff2 100644 --- a/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md +++ b/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md @@ -1,7 +1,7 @@ --- title: "Using TCHAR.H Data Types with _MBCS" description: "An overview of how Microsoft C runtime text routines are mapped when you use TCHAR.H data types with the multibyte constant _MBCS." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "11/04/2016" helpviewer_keywords: ["TCHAR.H data types", "MBCS data type", "_MBCS data type"] ms.assetid: 48f471e7-9d2b-4a39-b841-16a0e15c0a18 diff --git a/docs/code-quality/annotating-function-behavior.md b/docs/code-quality/annotating-function-behavior.md index 4458f342c2d..98a9bf99f68 100644 --- a/docs/code-quality/annotating-function-behavior.md +++ b/docs/code-quality/annotating-function-behavior.md @@ -2,7 +2,7 @@ description: "Learn more about: Annotating function behavior" title: Annotating function behavior ms.date: 11/04/2016 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_On_failure_" - "_Return_type_success_" diff --git a/docs/code-quality/annotating-function-parameters-and-return-values.md b/docs/code-quality/annotating-function-parameters-and-return-values.md index bd9ffdd4534..5c0a0531f02 100644 --- a/docs/code-quality/annotating-function-parameters-and-return-values.md +++ b/docs/code-quality/annotating-function-parameters-and-return-values.md @@ -2,7 +2,7 @@ title: Annotating function parameters and return values description: "Reference guide to function parameter and return value annotations." ms.date: 10/15/2019 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_Outptr_opt_result_bytebuffer_to_" - "_Inout_updates_all_opt_" diff --git a/docs/code-quality/annotating-locking-behavior.md b/docs/code-quality/annotating-locking-behavior.md index a362074bad1..99bb3bf25e9 100644 --- a/docs/code-quality/annotating-locking-behavior.md +++ b/docs/code-quality/annotating-locking-behavior.md @@ -2,7 +2,7 @@ description: "Learn more about: Annotating Locking Behavior" title: Annotating Locking Behavior ms.date: 08/24/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_Releases_nonreentrant_lock_" - "_Lock_kind_mutex_" diff --git a/docs/code-quality/annotating-structs-and-classes.md b/docs/code-quality/annotating-structs-and-classes.md index 1c19f33cdd2..fdc83bc210b 100644 --- a/docs/code-quality/annotating-structs-and-classes.md +++ b/docs/code-quality/annotating-structs-and-classes.md @@ -2,7 +2,7 @@ title: Annotating Structs and Classes description: "Learn more about: Annotating Structs and Classes" ms.date: 06/28/2019 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_Field_size_bytes_part_" - "_Field_size_bytes_full_opt_" diff --git a/docs/code-quality/best-practices-and-examples-sal.md b/docs/code-quality/best-practices-and-examples-sal.md index 320b8100d3c..aa2b6e986b0 100644 --- a/docs/code-quality/best-practices-and-examples-sal.md +++ b/docs/code-quality/best-practices-and-examples-sal.md @@ -2,7 +2,7 @@ description: "Learn more about: Best practices and examples (SAL)" title: Best practices and examples (SAL) ms.date: 03/30/2023 -ms.topic: "conceptual" +ms.topic: "best-practice" --- # Best practices and examples (SAL) diff --git a/docs/code-quality/build-reliable-secure-programs.md b/docs/code-quality/build-reliable-secure-programs.md index 83f1605db11..94181eb5c90 100644 --- a/docs/code-quality/build-reliable-secure-programs.md +++ b/docs/code-quality/build-reliable-secure-programs.md @@ -2,7 +2,7 @@ title: Build reliable and secure C++ programs description: "Learn more about: Building reliable and secure C++ programs by applying NISTIR 8397 guidelines." ms.date: 04/25/2025 -ms.topic: "conceptual" +ms.topic: "concept-article" --- # Build reliable and secure C++ programs diff --git a/docs/code-quality/c26132.md b/docs/code-quality/c26132.md index 390903a6059..487cad505f3 100644 --- a/docs/code-quality/c26132.md +++ b/docs/code-quality/c26132.md @@ -4,7 +4,7 @@ description: Documentation on static analysis warning C26132 author: Rastaban ms.author: philc ms.service: visual-cpp -ms.topic: article +ms.topic: concept-article ms.date: 02/11/2025 --- # Warning C26132 diff --git a/docs/code-quality/c26133.md b/docs/code-quality/c26133.md index 0074674044e..e1067f9c3a8 100644 --- a/docs/code-quality/c26133.md +++ b/docs/code-quality/c26133.md @@ -4,7 +4,7 @@ description: Documentation on static analysis warning C26133 author: Rastaban ms.author: philc ms.service: visual-cpp -ms.topic: article +ms.topic: concept-article ms.date: 02/19/2025 --- # Warning C26133 diff --git a/docs/code-quality/clang-tidy.md b/docs/code-quality/clang-tidy.md index 7427e96a45c..40184d901f5 100644 --- a/docs/code-quality/clang-tidy.md +++ b/docs/code-quality/clang-tidy.md @@ -2,7 +2,7 @@ title: Using Clang-Tidy in Visual Studio description: "How to use Clang-Tidy in Visual Studio for Microsoft C++ code analysis." ms.date: 03/1/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["vs.codeanalysis.clangtidy","vs.codeanalysis.propertypages.ClangTidyToolPath"] --- # Using Clang-Tidy in Visual Studio diff --git a/docs/code-quality/code-analysis-for-c-cpp-overview.md b/docs/code-quality/code-analysis-for-c-cpp-overview.md index e9ef85e6775..2bde55b76a3 100644 --- a/docs/code-quality/code-analysis-for-c-cpp-overview.md +++ b/docs/code-quality/code-analysis-for-c-cpp-overview.md @@ -2,7 +2,7 @@ description: "Learn more about: Code analysis for C/C++ overview" title: Code analysis for C/C++ overview ms.date: 04/28/2018 -ms.topic: conceptual +ms.topic: concept-article helpviewer_keywords: - "annotations, code analysis" - "build integration, code analysis" diff --git a/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md b/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md index cd25a57d26d..d4b1e95e891 100644 --- a/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md +++ b/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md @@ -2,7 +2,6 @@ description: "Learn more about: How to: Set Code Analysis Properties for C/C++ Projects" title: "How to: Set Code Analysis Properties for C/C++ Projects" ms.date: 11/04/2016 -ms.topic: "conceptual" f1_keywords: - "vs.codeanalysis.propertypages.native" - "VC.Project.VCCLCompilerTool.EnablePrefast" diff --git a/docs/code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md b/docs/code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md index cf2bac2dc35..16272c8e974 100644 --- a/docs/code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md +++ b/docs/code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md @@ -2,7 +2,6 @@ description: "Learn more about how to specify additional code information by using _Analysis_assume_." title: "Use _Analysis_assume_ for code analysis hints" ms.date: 12/16/2020 -ms.topic: "conceptual" f1_keywords: - "_Analysis_assume_" helpviewer_keywords: diff --git a/docs/code-quality/intrinsic-functions.md b/docs/code-quality/intrinsic-functions.md index 7b9d3a334cb..7a86f4a05c3 100644 --- a/docs/code-quality/intrinsic-functions.md +++ b/docs/code-quality/intrinsic-functions.md @@ -2,7 +2,7 @@ description: "Learn more about: Intrinsic Functions" title: Intrinsic Functions ms.date: 11/04/2016 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_String_length_" - "_Param_" diff --git a/docs/code-quality/quick-start-code-analysis-for-c-cpp.md b/docs/code-quality/quick-start-code-analysis-for-c-cpp.md index 499af5c14ab..39c416ac326 100644 --- a/docs/code-quality/quick-start-code-analysis-for-c-cpp.md +++ b/docs/code-quality/quick-start-code-analysis-for-c-cpp.md @@ -2,7 +2,7 @@ title: "Quickstart: Code analysis for C/C++" description: "Run static analysis on C++ code in Visual Studio to detect common coding problems and defects." ms.date: 04/08/2020 -ms.topic: "conceptual" +ms.topic: "quickstart" helpviewer_keywords: - "C/C++ code analysis" - "code analysis, C/C++" diff --git a/docs/code-quality/specifying-when-and-where-an-annotation-applies.md b/docs/code-quality/specifying-when-and-where-an-annotation-applies.md index d0849fc192a..f01e08d9919 100644 --- a/docs/code-quality/specifying-when-and-where-an-annotation-applies.md +++ b/docs/code-quality/specifying-when-and-where-an-annotation-applies.md @@ -2,7 +2,7 @@ description: "Learn more about: Specifying When and Where an Annotation Applies" title: Specifying When and Where an Annotation Applies ms.date: 11/04/2016 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_Group_" - "_At_" diff --git a/docs/code-quality/understanding-sal.md b/docs/code-quality/understanding-sal.md index 7e3c30bfd46..fea482553a1 100644 --- a/docs/code-quality/understanding-sal.md +++ b/docs/code-quality/understanding-sal.md @@ -2,7 +2,7 @@ title: Understanding SAL description: "Learn more about: Understanding SAL" ms.date: 11/04/2016 -ms.topic: "conceptual" +ms.topic: "concept-article" --- # Understanding SAL diff --git a/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md b/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md index 545b52d1840..363cce16f68 100644 --- a/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md +++ b/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md @@ -2,7 +2,7 @@ description: "Learn more about: Use Rule Sets to Specify the C++ Rules to Run" title: Using Rule Sets to Specify the C++ Rules to Run ms.date: 07/27/2020 -ms.topic: "conceptual" +ms.topic: "how-to" f1_keywords: - "vs.codeanalysis.rulesets.native" --- diff --git a/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md b/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md index 80f88e1c27f..381e526ebcc 100644 --- a/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md +++ b/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md @@ -2,7 +2,7 @@ description: "Learn more about: Using SAL Annotations to Reduce C/C++ Code Defects" title: Using SAL Annotations to Reduce C/C++ Code Defects ms.date: 11/04/2016 -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: - "annotations" - "SAL annotations" diff --git a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md index 8ffa7df200b..5b242bc21fa 100644 --- a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md +++ b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md @@ -2,7 +2,7 @@ title: Using the C++ Core Guidelines checkers description: "How to set up and use the Microsoft C++ Code Analysis rules for C++ Core Guidelines." ms.date: 06/21/2023 -ms.topic: "conceptual" +ms.topic: "how-to" dev_langs: - CPP --- diff --git a/docs/code-quality/walkthrough-analyzing-c-cpp-code-for-defects.md b/docs/code-quality/walkthrough-analyzing-c-cpp-code-for-defects.md index 0332306aa55..384584b365a 100644 --- a/docs/code-quality/walkthrough-analyzing-c-cpp-code-for-defects.md +++ b/docs/code-quality/walkthrough-analyzing-c-cpp-code-for-defects.md @@ -2,7 +2,7 @@ title: "Walkthrough: Analyzing C/C++ code for defects" description: "Demonstrates how to use code analysis with Microsoft C++ in Visual Studio." ms.date: 04/14/2020 -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["C/C++, code analysis", "code analysis, walkthroughs", "code, analyzing C/C++", "code analysis tool, walkthroughs"] --- # Walkthrough: Analyzing C/C++ code for defects diff --git a/docs/cpp/cpp-type-system-modern-cpp.md b/docs/cpp/cpp-type-system-modern-cpp.md index ad5f425f45c..a6245411472 100644 --- a/docs/cpp/cpp-type-system-modern-cpp.md +++ b/docs/cpp/cpp-type-system-modern-cpp.md @@ -2,7 +2,7 @@ description: "Learn more about: C++ type system" title: "C++ type system" ms.date: 11/04/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: 553c0ed6-77c4-43e9-87b1-c903eec53e80 --- # C++ type system diff --git a/docs/cpp/errors-and-exception-handling-modern-cpp.md b/docs/cpp/errors-and-exception-handling-modern-cpp.md index 486a271ba82..3140848fae8 100644 --- a/docs/cpp/errors-and-exception-handling-modern-cpp.md +++ b/docs/cpp/errors-and-exception-handling-modern-cpp.md @@ -2,7 +2,7 @@ title: "Modern C++ best practices for exceptions and error handling" description: "How Modern C++ supports exceptional programming styles over error codes." ms.date: 03/22/2024 -ms.topic: "conceptual" +ms.topic: "best-practice" --- # Modern C++ best practices for exceptions and error handling diff --git a/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md b/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md index c25e220009e..37f9edb3800 100644 --- a/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md +++ b/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Create and use CComPtr and CComQIPtr ins title: "How to: Create and use CComPtr and CComQIPtr instances" ms.custom: "how-to" ms.date: "11/19/2019" -ms.topic: "conceptual" ms.assetid: b0356cfb-12cc-4ee8-b988-8311ed1ab5e0 --- # How to: Create and use CComPtr and CComQIPtr instances diff --git a/docs/cpp/how-to-create-and-use-shared-ptr-instances.md b/docs/cpp/how-to-create-and-use-shared-ptr-instances.md index 28e2e78d4a1..cc993258bd9 100644 --- a/docs/cpp/how-to-create-and-use-shared-ptr-instances.md +++ b/docs/cpp/how-to-create-and-use-shared-ptr-instances.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Create and Use shared_ptr instances" title: "How to: Create and use shared_ptr instances" ms.custom: "how-to" ms.date: "12/4/2024" -ms.topic: "conceptual" --- # How to: Create and Use shared_ptr instances diff --git a/docs/cpp/how-to-create-and-use-unique-ptr-instances.md b/docs/cpp/how-to-create-and-use-unique-ptr-instances.md index 4621600bd18..b679190aeee 100644 --- a/docs/cpp/how-to-create-and-use-unique-ptr-instances.md +++ b/docs/cpp/how-to-create-and-use-unique-ptr-instances.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Create and use unique_ptr instances" title: "How to: Create and use unique_ptr instances" ms.custom: "how-to" ms.date: "11/19/2018" -ms.topic: "conceptual" ms.assetid: 9a373030-e587-452f-b9a5-c5f9d58b7673 --- # How to: Create and use unique_ptr instances diff --git a/docs/cpp/how-to-create-and-use-weak-ptr-instances.md b/docs/cpp/how-to-create-and-use-weak-ptr-instances.md index 0f5cf8724c2..0947a8d9be9 100644 --- a/docs/cpp/how-to-create-and-use-weak-ptr-instances.md +++ b/docs/cpp/how-to-create-and-use-weak-ptr-instances.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Create and use weak_ptr instances" title: "How to: Create and use weak_ptr instances" ms.custom: "how-to" ms.date: "11/19/2019" -ms.topic: "conceptual" ms.assetid: 8dd6909b-b070-4afa-9696-f2fc94579c65 --- # How to: Create and use weak_ptr instances diff --git a/docs/cpp/how-to-design-for-exception-safety.md b/docs/cpp/how-to-design-for-exception-safety.md index 8d6a8c270d3..588c564ebd8 100644 --- a/docs/cpp/how-to-design-for-exception-safety.md +++ b/docs/cpp/how-to-design-for-exception-safety.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Design for exception safety" title: "How to: Design for exception safety" ms.custom: "how-to" ms.date: "11/19/2019" -ms.topic: "conceptual" ms.assetid: 19ecc5d4-297d-4c4e-b4f3-4fccab890b3d --- # How to: Design for exception safety diff --git a/docs/cpp/how-to-interface-between-exceptional-and-non-exceptional-code.md b/docs/cpp/how-to-interface-between-exceptional-and-non-exceptional-code.md index 75d4de49348..2c4f1b4b128 100644 --- a/docs/cpp/how-to-interface-between-exceptional-and-non-exceptional-code.md +++ b/docs/cpp/how-to-interface-between-exceptional-and-non-exceptional-code.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Interface between exceptional and non-ex title: "How to: Interface between exceptional and non-exceptional code" ms.custom: "how-to" ms.date: 03/02/2022 -ms.topic: "conceptual" --- # How to: Interface between exceptional and non-exceptional code diff --git a/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md b/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md index b13d412b966..e9a876b68d9 100644 --- a/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md +++ b/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md @@ -2,7 +2,7 @@ title: "Object lifetime and resource management (RAII)" description: "Follow the principle of RAII in modern C++ to avoid resource leaks." ms.date: 06/02/2022 -ms.topic: "conceptual" +ms.topic: "how-to" ms.assetid: 8aa0e1a1-e04d-46b1-acca-1d548490700f --- # Object lifetime and resource management (RAII) diff --git a/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md b/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md index 5aede48b9b8..3865266d997 100644 --- a/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md +++ b/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md @@ -2,7 +2,7 @@ description: "Learn more about: Pimpl For Compile-Time Encapsulation (Modern C++)" title: "Pimpl For Compile-Time Encapsulation (Modern C++)" ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: c3e8a90a-b328-4990-82bb-e1b147f76e07 --- # Pimpl For Compile-Time Encapsulation (Modern C++) diff --git a/docs/cpp/portability-at-abi-boundaries-modern-cpp.md b/docs/cpp/portability-at-abi-boundaries-modern-cpp.md index 28caf182d05..50e5a1243c2 100644 --- a/docs/cpp/portability-at-abi-boundaries-modern-cpp.md +++ b/docs/cpp/portability-at-abi-boundaries-modern-cpp.md @@ -2,7 +2,7 @@ title: "Portability at ABI boundaries" description: "Flatten C++ interfaces to C calling conventions at binary interface boundaries." ms.date: "11/19/2019" -ms.topic: "conceptual" +ms.topic: "how-to" ms.assetid: abbd405e-3038-427c-8c24-e00598f0936a --- # Portability at ABI boundaries diff --git a/docs/cpp/smart-pointers-modern-cpp.md b/docs/cpp/smart-pointers-modern-cpp.md index 40af79d21d5..8dbc6c3f00a 100644 --- a/docs/cpp/smart-pointers-modern-cpp.md +++ b/docs/cpp/smart-pointers-modern-cpp.md @@ -2,7 +2,7 @@ description: "Learn more about: Smart pointers (Modern C++)" title: "Smart pointers (Modern C++)" ms.date: "11/19/2019" -ms.topic: "conceptual" +ms.topic: "how-to" ms.assetid: 909ef870-904c-49b6-b8cd-e9d0b7dc9435 --- # Smart pointers (Modern C++) diff --git a/docs/cpp/type-conversions-and-type-safety-modern-cpp.md b/docs/cpp/type-conversions-and-type-safety-modern-cpp.md index dfa856f93ba..b56978b7cd7 100644 --- a/docs/cpp/type-conversions-and-type-safety-modern-cpp.md +++ b/docs/cpp/type-conversions-and-type-safety-modern-cpp.md @@ -2,7 +2,7 @@ title: "Type conversions and type safety" description: "Learn more about: Type conversions and type safety" ms.date: "11/19/2019" -ms.topic: "conceptual" +ms.topic: "how-to" --- # Type conversions and type safety diff --git a/docs/cpp/value-types-modern-cpp.md b/docs/cpp/value-types-modern-cpp.md index a3bed668f6a..8178c483c4a 100644 --- a/docs/cpp/value-types-modern-cpp.md +++ b/docs/cpp/value-types-modern-cpp.md @@ -2,7 +2,7 @@ description: "Learn more about: C++ classes as value types" title: "C++ classes as value types" ms.date: 06/09/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: f63bb62c-60da-40d5-ac14-4366608fe260 --- # C++ classes as value types diff --git a/docs/cpp/welcome-back-to-cpp-modern-cpp.md b/docs/cpp/welcome-back-to-cpp-modern-cpp.md index dd8346fd6d2..40942dc4b5c 100644 --- a/docs/cpp/welcome-back-to-cpp-modern-cpp.md +++ b/docs/cpp/welcome-back-to-cpp-modern-cpp.md @@ -2,7 +2,7 @@ title: "Welcome back to C++ - Modern C++" description: "Describes the new programming idioms in Modern C++ and their rationale." ms.date: 06/02/2022 -ms.topic: "conceptual" +ms.topic: "how-to" --- # Welcome back to C++ - Modern C++ diff --git a/docs/docfx.json b/docs/docfx.json index 389b95cc45e..6dbea061875 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -42,7 +42,7 @@ "ROBOTS": "INDEX,FOLLOW", "manager": "coxford", "ms.date": "11/16/2016", - "ms.topic": "conceptual", + "ms.topic": "article", "audience": "developer", "ms.service": "visual-cpp", "ms.tgt_pltfrm": "Windows", @@ -96,12 +96,14 @@ ] }, "ms.topic": { + "**/how-to*.md": "how-to", "assembler/arm/**.md": "reference", "assembler/masm/**.md": "reference", "attributes/**.md": "reference", "atl/reference/**.md": "reference", "atl-mfc-shared/**.md": "reference", "build/reference/**.md": "reference", + "build-insights/reference/sdk/c-event-data-types/**.md": "reference", "c-language/**.md": "language-reference", "c-runtime-library/**.md": "reference", "c-runtime-library/reference/**.md": "reference", @@ -110,6 +112,7 @@ "cppcx/**.md": "language-reference", "data/oledb/**.md": "reference", "error-messages/**.md": "error-reference", + "ide/refactoring/**.md": "how-to", "extensions/**.md": "reference", "intrinsics/**.md": "reference", "mfc/reference/**.md": "reference", diff --git a/docs/porting/ide-tools-for-upgrading-code.md b/docs/porting/ide-tools-for-upgrading-code.md index 1ce1e805274..13f9f48a5f4 100644 --- a/docs/porting/ide-tools-for-upgrading-code.md +++ b/docs/porting/ide-tools-for-upgrading-code.md @@ -2,7 +2,7 @@ title: "Visual Studio IDE tools for upgrading C++ code" description: "The C++ code editor and code analysis tools in Visual Studio help you to modernize your C++ code base." ms.date: "11/13/2019" -ms.topic: "conceptual" +ms.topic: "concept-article" --- # Visual Studio IDE tools for upgrading C++ code diff --git a/docs/text/string-and-i-o-formatting-modern-cpp.md b/docs/text/string-and-i-o-formatting-modern-cpp.md index 1b44ad8e4c8..a122fef058f 100644 --- a/docs/text/string-and-i-o-formatting-modern-cpp.md +++ b/docs/text/string-and-i-o-formatting-modern-cpp.md @@ -2,7 +2,7 @@ title: "String and I/O Formatting (Modern C++)" description: "Choices for formatted string I/O available in modern C++." ms.date: "05/30/2019" -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: 3954e8de-a59b-4175-89c9-4ee842ab89ed --- # String and I/O Formatting (Modern C++) diff --git a/docs/windows/attributes/attributes-alphabetical-reference.md b/docs/windows/attributes/attributes-alphabetical-reference.md index 2e6948ed8f4..375d6a5736d 100644 --- a/docs/windows/attributes/attributes-alphabetical-reference.md +++ b/docs/windows/attributes/attributes-alphabetical-reference.md @@ -3,7 +3,7 @@ description: "Learn more about: Attributes Alphabetical Reference" title: "Attributes Alphabetical Reference" ms.custom: "index-page" ms.date: "10/02/2018" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["vc.attributes"] helpviewer_keywords: ["attributes [C++/CLI]"] ms.assetid: fb2216ef-9fbd-44f4-afed-732aa99450e2 diff --git a/docs/windows/attributes/attributes-by-group.md b/docs/windows/attributes/attributes-by-group.md index e344d58f67a..42a1cd2787f 100644 --- a/docs/windows/attributes/attributes-by-group.md +++ b/docs/windows/attributes/attributes-by-group.md @@ -3,7 +3,7 @@ description: "Learn more about: Attributes by Group" title: "Attributes by Group" ms.custom: "index-page" ms.date: "10/02/2018" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["attributes [C++/CLI]"] ms.assetid: 9f4dd43f-9909-43d6-91d2-05734643876e --- diff --git a/docs/windows/attributes/attributes-by-usage.md b/docs/windows/attributes/attributes-by-usage.md index ea43dfd652a..628c0a616ba 100644 --- a/docs/windows/attributes/attributes-by-usage.md +++ b/docs/windows/attributes/attributes-by-usage.md @@ -3,7 +3,7 @@ description: "Learn more about: Attributes by Usage" title: "Attributes by Usage" ms.custom: "index-page" ms.date: "10/02/2018" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["attributes [C++/CLI]"] ms.assetid: 8be2de10-b1ff-4ca4-a114-75318408593c --- diff --git a/docs/windows/attributes/cpp-attributes-com-net.md b/docs/windows/attributes/cpp-attributes-com-net.md index 830c975df11..20de95ef00e 100644 --- a/docs/windows/attributes/cpp-attributes-com-net.md +++ b/docs/windows/attributes/cpp-attributes-com-net.md @@ -3,7 +3,7 @@ description: "Learn more about: C++ Attributes for COM and .NET" title: "C++ Attributes for COM and .NET" ms.custom: "index-page" ms.date: "11/19/2018" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["attributes [C++/CLI], reference topics"] ms.assetid: 613a3611-b3eb-4347-aa38-99b654600e1c --- From 996c694cdaf9eadeefce70f656a971f5a778b4e7 Mon Sep 17 00:00:00 2001 From: Nathalie Laroche <635965+nathlaroche@users.noreply.github.com> Date: Tue, 17 Jun 2025 11:18:54 -0400 Subject: [PATCH 0082/1799] update order for precedence --- docs/docfx.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/docfx.json b/docs/docfx.json index 6dbea061875..1621b18044d 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -96,7 +96,6 @@ ] }, "ms.topic": { - "**/how-to*.md": "how-to", "assembler/arm/**.md": "reference", "assembler/masm/**.md": "reference", "attributes/**.md": "reference", @@ -124,7 +123,8 @@ "safeint/**.md": "reference", "sanitizers/**.md": "reference", "standard-library/**.md": "reference", - "windows/attributes/**.md": "reference" + "windows/attributes/**.md": "reference", + "**/how-to*.md": "how-to" }, "ms.subservice": { "assembler/**.md": "masm", From 7b8f3c1aa882ef973432b228e30e71e24e8e58fb Mon Sep 17 00:00:00 2001 From: "Omotola Akeredolu (from Dev Box)" Date: Tue, 17 Jun 2025 14:06:22 -0700 Subject: [PATCH 0083/1799] Added documentation for new clang-tidy settings --- docs/code-quality/clang-tidy.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/code-quality/clang-tidy.md b/docs/code-quality/clang-tidy.md index 7427e96a45c..474b8a52113 100644 --- a/docs/code-quality/clang-tidy.md +++ b/docs/code-quality/clang-tidy.md @@ -3,7 +3,7 @@ title: Using Clang-Tidy in Visual Studio description: "How to use Clang-Tidy in Visual Studio for Microsoft C++ code analysis." ms.date: 03/1/2022 ms.topic: "conceptual" -f1_keywords: ["vs.codeanalysis.clangtidy","vs.codeanalysis.propertypages.ClangTidyToolPath"] +f1_keywords: ["vs.codeanalysis.clangtidy","vs.codeanalysis.propertypages.ClangTidyToolPath","vs.codeanalysis.propertypages.AdditionalOptions","vs.codeanalysis.propertypages.MaxProcesses"] --- # Using Clang-Tidy in Visual Studio @@ -94,6 +94,18 @@ By default, Clang-Tidy does not set any checks when enabled. To see the list of If you'd like to have custom rules built into your clang-tidy executable and run it in Microsoft Visual Studio, you can change the path to the executable that Visual Studio runs. In the project Property Pages dialog, open the **Configuration Properties** > **Code Analysis** > **Clang-Tidy** page. Manually type in the path or **Browse** and select the path under the **Clang-Tidy Tool Directory** property. The new executable is used once the change is saved, and the app is recompiled. +## Clang-Tidy Additional Options + +The **Clang-Tidy Additional Options** property lets you specify additional compiler arguments that are passed to Clang-Tidy using the `--extra-args` command-line option. These arguments can be used to control how Clang-Tidy parses your code, such as defining macros, include paths, or language standards. Enter arguments as a semi-colon separated list. For example: `-std=c++20;-DMY_DEFINE=1;-Ipath\to\include`. + +## Clang-Tidy Prepend Additional Options + +The **Clang-Tidy Prepend Additional Options** property lets you specify compiler arguments that are passed to Clang-Tidy using the `--extra-args-before` command-line option. These arguments are inserted before the default compiler arguments when Clang-Tidy parses your code. Enter arguments as a semi-colon separated list. For example: `-std=c++20;-DMY_DEFINE=1;`. + +## Max Number of Processes + +The **Max Number of Processes** property lets you specify how many processes Clang-Tidy can use to run analysis in parallel. By default, Clang-Tidy uses a single processor. Set this property to a specific number to limit the number of parallel processes, or set it to `0` to use all available logical processors on your system. Increasing the number of processes can improve analysis speed on multi-core machines. + ## See also [Clang/LLVM support for MSBuild projects](https://devblogs.microsoft.com/cppblog/clang-llvm-support-for-msbuild-projects/)\ From c608ff3713fec9fc01ad79428381afc4febf008a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 16:36:53 +0800 Subject: [PATCH 0084/1799] Remove underscore for `noreturn` in metadata of "Attributes in C++" article --- docs/cpp/attributes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index b34a559f805..ab1a3272b86 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -1,8 +1,8 @@ --- description: "Learn more about: Attributes in C++" title: "Attributes in C++" -f1_keywords: ["deprecated", "no_return", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::intrinsic", "msvc::no_tls_guard"] -helpviewer_keywords: ["deprecated", "no_return", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::intrinsic", "msvc::no_tls_guard"] +f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::intrinsic", "msvc::no_tls_guard"] +helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::intrinsic", "msvc::no_tls_guard"] ms.date: 4/13/2023 --- From 6843c372f477474021489f986f189f1e441724c4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 16:42:51 +0800 Subject: [PATCH 0085/1799] Add to `f1_keywords` and `helpviewer_keywords` in "Attributes in C++" article --- docs/cpp/attributes.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index ab1a3272b86..91b62f8c515 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -1,8 +1,8 @@ --- description: "Learn more about: Attributes in C++" title: "Attributes in C++" -f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::intrinsic", "msvc::no_tls_guard"] -helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::intrinsic", "msvc::no_tls_guard"] +f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard"] +helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard"] ms.date: 4/13/2023 --- From 769123cbbf3ec4c01e80fe25ce3aeac6e3673841 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 16:43:33 +0800 Subject: [PATCH 0086/1799] Move `title` metadata above `description` in "Attributes in C++" article --- docs/cpp/attributes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 91b62f8c515..8ed976529a0 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Attributes in C++" title: "Attributes in C++" +description: "Learn more about: Attributes in C++" f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard"] helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard"] ms.date: 4/13/2023 From 20b594459085598e31a8b3ac02b5c4ec8de6085a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 17:01:41 +0800 Subject: [PATCH 0087/1799] Fix misplaced parenthesis in "Walkthrough: Putting Controls On Toolbars" --- docs/mfc/walkthrough-putting-controls-on-toolbars.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/walkthrough-putting-controls-on-toolbars.md b/docs/mfc/walkthrough-putting-controls-on-toolbars.md index ca7b06348c4..665f0a0d385 100644 --- a/docs/mfc/walkthrough-putting-controls-on-toolbars.md +++ b/docs/mfc/walkthrough-putting-controls-on-toolbars.md @@ -82,7 +82,7 @@ To add the combo box button to the toolbar, follow these steps: > [!NOTE] > The framework sends this message to the main frame window when a toolbar is initialized during application startup, or when a toolbar is reset during customization. In either case, you must replace the standard toolbar button with the custom **Find** combo box button. -1. In the `AFX_WM_RESETTOOLBAR` handler, examine the toolbar ID, that is, the *WPARAM* of the AFX_WM_RESETTOOLBAR message. If the toolbar ID is equal to that of the toolbar that contains the **Find** combo box button, call [CMFCToolBar::ReplaceButton](../mfc/reference/cmfctoolbar-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND)` with a `CFindComboButton` object. +1. In the `AFX_WM_RESETTOOLBAR` handler, examine the toolbar ID, that is, the *WPARAM* of the AFX_WM_RESETTOOLBAR message. If the toolbar ID is equal to that of the toolbar that contains the **Find** combo box button, call [CMFCToolBar::ReplaceButton](../mfc/reference/cmfctoolbar-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. > [!NOTE] > You can construct a `CFindComboBox` object on the stack, because `ReplaceButton` copies the button object and maintains the copy. From 525f86acd9b05e1fc67806556edfca17dc820b3f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 17:07:22 +0800 Subject: [PATCH 0088/1799] Add backticks in "Walkthrough: Putting Controls On Toolbars" --- ...alkthrough-putting-controls-on-toolbars.md | 36 +++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/mfc/walkthrough-putting-controls-on-toolbars.md b/docs/mfc/walkthrough-putting-controls-on-toolbars.md index 665f0a0d385..7114db74370 100644 --- a/docs/mfc/walkthrough-putting-controls-on-toolbars.md +++ b/docs/mfc/walkthrough-putting-controls-on-toolbars.md @@ -7,7 +7,7 @@ ms.assetid: 8fc94bdf-0da7-45d9-8bc4-52b7b1edf205 --- # Walkthrough: Putting Controls On Toolbars -This article describes how to add a toolbar button that contains a Windows control to a toolbar. In MFC, a toolbar button must be a [CMFCToolBarButton Class](../mfc/reference/cmfctoolbarbutton-class.md)-derived class, for example [CMFCToolBarComboBoxButton Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md), [CMFCToolBarEditBoxButton Class](../mfc/reference/cmfctoolbareditboxbutton-class.md), [CMFCDropDownToolbarButton Class](../mfc/reference/cmfcdropdowntoolbarbutton-class.md), or [CMFCToolBarMenuButton Class](../mfc/reference/cmfctoolbarmenubutton-class.md). +This article describes how to add a toolbar button that contains a Windows control to a toolbar. In MFC, a toolbar button must be a [`CMFCToolBarButton` Class](../mfc/reference/cmfctoolbarbutton-class.md)-derived class, for example [`CMFCToolBarComboBoxButton` Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md), [`CMFCToolBarEditBoxButton` Class](../mfc/reference/cmfctoolbareditboxbutton-class.md), [`CMFCDropDownToolbarButton` Class](../mfc/reference/cmfcdropdowntoolbarbutton-class.md), or [`CMFCToolBarMenuButton` Class](../mfc/reference/cmfctoolbarmenubutton-class.md). ## Adding Controls to Toolbars @@ -21,7 +21,7 @@ To add a control to a toolbar, follow these steps: 1. Construct the button control by using a `CMFCToolbarButton`-derived class. - 1. Replace the dummy button with the new control by using [CMFCToolBar::ReplaceButton](../mfc/reference/cmfctoolbar-class.md#replacebutton). You can construct the button object on the stack, because `ReplaceButton` copies the button object and maintains the copy. + 1. Replace the dummy button with the new control by using [`CMFCToolBar::ReplaceButton`](../mfc/reference/cmfctoolbar-class.md#replacebutton). You can construct the button object on the stack, because `ReplaceButton` copies the button object and maintains the copy. > [!NOTE] > If you enabled customization in your application, you may have to reset the toolbar by using the **Reset** button on the **Toolbars** tab of the **Customize** dialog box to see the updated control in your application after recompiling. The toolbar state is saved in the Windows registry, and the registry information is loaded and applied after the `ReplaceButton` method is executed during application startup. @@ -30,11 +30,11 @@ To add a control to a toolbar, follow these steps: The **Commands** tab of the **Customize** dialog box contains a list of commands that are available in the application. By default, the **Customize** dialog box processes the application menus and builds a list of standard toolbar buttons in each menu category. To keep the extended functionality that the toolbar controls provide, you must replace the standard toolbar button with the custom control in the **Customize** dialog box. -When you enable customization, you create the **Customize** dialog box in the customization handler `OnViewCustomize` by using the [CMFCToolBarsCustomizeDialog Class](../mfc/reference/cmfctoolbarscustomizedialog-class.md) class. Before you display the **Customize** dialog box by calling [CMFCToolBarsCustomizeDialog::Create](../mfc/reference/cmfctoolbarscustomizedialog-class.md#create), call [CMFCToolBarsCustomizeDialog::ReplaceButton](../mfc/reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the standard button with the new control. +When you enable customization, you create the **Customize** dialog box in the customization handler `OnViewCustomize` by using the [`CMFCToolBarsCustomizeDialog` Class](../mfc/reference/cmfctoolbarscustomizedialog-class.md) class. Before you display the **Customize** dialog box by calling [`CMFCToolBarsCustomizeDialog::Create`](../mfc/reference/cmfctoolbarscustomizedialog-class.md#create), call [`CMFCToolBarsCustomizeDialog::ReplaceButton`](../mfc/reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the standard button with the new control. ## Example: Creating a Find Combo Box -This section describes how to create a **Find** combo box control that appears on a toolbar and contains recent-used search strings. The user can type a string in the control and then press the enter key to search a document, or press the escape key to return the focus to the main frame. This example assumes that the document is displayed in a [CEditView Class](../mfc/reference/ceditview-class.md)-derived view. +This section describes how to create a **Find** combo box control that appears on a toolbar and contains recent-used search strings. The user can type a string in the control and then press the enter key to search a document, or press the escape key to return the focus to the main frame. This example assumes that the document is displayed in a [`CEditView` Class](../mfc/reference/ceditview-class.md)-derived view. ### Creating the Find Control @@ -46,32 +46,32 @@ First, create the **Find** combo box control: 1. Create a new menu item with the `ID_EDIT_FIND` command ID. - 1. Add a new string "Find the text\nFind" to the string table and assign it an `ID_EDIT_FIND_COMBO` command ID. This ID will be used as the command ID of the **Find** combo box button. + 1. Add a new string `"Find the text\nFind"` to the string table and assign it an `ID_EDIT_FIND_COMBO` command ID. This ID will be used as the command ID of the **Find** combo box button. > [!NOTE] > Because `ID_EDIT_FIND` is a standard command that is processed by `CEditView`, you are not required to implement a special handler for this command. However, you must implement a handler for the new command `ID_EDIT_FIND_COMBO`. -1. Create a new class, `CFindComboBox`, derived from [CComboBox Class](../mfc/reference/ccombobox-class.md). +1. Create a new class, `CFindComboBox`, derived from [`CComboBox` Class](../mfc/reference/ccombobox-class.md). -1. In the `CFindComboBox` class, override the `PreTranslateMessage` virtual method. This method will enable the combo box to process the [WM_KEYDOWN](/windows/win32/inputdev/wm-keydown) message. If the user hits the escape key (`VK_ESCAPE`), return the focus to the main frame window. If the user hits the Enter key (`VK_ENTER`), post to the main frame window a `WM_COMMAND` message that contains the `ID_EDIT_FIND_COMBO` command ID. +1. In the `CFindComboBox` class, override the `PreTranslateMessage` virtual method. This method will enable the combo box to process the [`WM_KEYDOWN`](/windows/win32/inputdev/wm-keydown) message. If the user hits the escape key (`VK_ESCAPE`), return the focus to the main frame window. If the user hits the Enter key (`VK_ENTER`), post to the main frame window a `WM_COMMAND` message that contains the `ID_EDIT_FIND_COMBO` command ID. -1. Create a class for the **Find** combo box button, derived from [CMFCToolBarComboBoxButton Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md). In this example, it's named `CFindComboButton`. +1. Create a class for the **Find** combo box button, derived from [`CMFCToolBarComboBoxButton` Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md). In this example, it's named `CFindComboButton`. 1. The constructor of `CMFCToolbarComboBoxButton` takes three parameters: the command ID of the button, the button image index, and the style of the combo box. Set these parameters as follows: 1. Pass the `ID_EDIT_FIND_COMBO` as the command ID. - 1. Use [CCommandManager::GetCmdImage](reference/internal-classes.md) with `ID_EDIT_FIND` to get the image index. + 1. Use [`CCommandManager::GetCmdImage`](reference/internal-classes.md) with `ID_EDIT_FIND` to get the image index. 1. For a list of available combo box styles, see [Combo-Box Styles](../mfc/reference/styles-used-by-mfc.md#combo-box-styles). 1. In the `CFindComboButton` class, override the `CMFCToolbarComboBoxButton::CreateCombo` method. Here you should create the `CFindComboButton` object and return a pointer to it. -1. Use the [IMPLEMENT_SERIAL](../mfc/reference/run-time-object-model-services.md#implement_serial) macro to make the combo button persistent. The workspace manager automatically loads and saves the button's state in the Windows registry. +1. Use the [`IMPLEMENT_SERIAL`](../mfc/reference/run-time-object-model-services.md#implement_serial) macro to make the combo button persistent. The workspace manager automatically loads and saves the button's state in the Windows registry. -1. Implement the `ID_EDIT_FIND_COMBO` handler in your document view. Use [CMFCToolBar::GetCommandButtons](../mfc/reference/cmfctoolbar-class.md#getcommandbuttons) with `ID_EDIT_FIND_COMBO` to retrieve all **Find** combo box buttons. There can be several copies of a button with the same command ID because of customization. +1. Implement the `ID_EDIT_FIND_COMBO` handler in your document view. Use [`CMFCToolBar::GetCommandButtons`](../mfc/reference/cmfctoolbar-class.md#getcommandbuttons) with `ID_EDIT_FIND_COMBO` to retrieve all **Find** combo box buttons. There can be several copies of a button with the same command ID because of customization. -1. In the `ID_EDIT_FIND` message handler `OnFind`, use [CMFCToolBar::IsLastCommandFromButton](../mfc/reference/cmfctoolbar-class.md#islastcommandfrombutton) to determine whether the find command was sent from the **Find** combo box button. If so, find the text and add the search string to the combo box. +1. In the `ID_EDIT_FIND` message handler `OnFind`, use [`CMFCToolBar::IsLastCommandFromButton`](../mfc/reference/cmfctoolbar-class.md#islastcommandfrombutton) to determine whether the find command was sent from the **Find** combo box button. If so, find the text and add the search string to the combo box. ### Adding the Find Control to the Main Toolbar @@ -82,20 +82,20 @@ To add the combo box button to the toolbar, follow these steps: > [!NOTE] > The framework sends this message to the main frame window when a toolbar is initialized during application startup, or when a toolbar is reset during customization. In either case, you must replace the standard toolbar button with the custom **Find** combo box button. -1. In the `AFX_WM_RESETTOOLBAR` handler, examine the toolbar ID, that is, the *WPARAM* of the AFX_WM_RESETTOOLBAR message. If the toolbar ID is equal to that of the toolbar that contains the **Find** combo box button, call [CMFCToolBar::ReplaceButton](../mfc/reference/cmfctoolbar-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. +1. In the `AFX_WM_RESETTOOLBAR` handler, examine the toolbar ID, that is, the *`WPARAM`* of the `AFX_WM_RESETTOOLBAR` message. If the toolbar ID is equal to that of the toolbar that contains the **Find** combo box button, call [`CMFCToolBar::ReplaceButton`](../mfc/reference/cmfctoolbar-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. > [!NOTE] > You can construct a `CFindComboBox` object on the stack, because `ReplaceButton` copies the button object and maintains the copy. ### Adding the Find Control to the Customize Dialog Box -In the customization handler `OnViewCustomize`, call [CMFCToolBarsCustomizeDialog::ReplaceButton](../mfc/reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. +In the customization handler `OnViewCustomize`, call [`CMFCToolBarsCustomizeDialog::ReplaceButton`](../mfc/reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. ## See also [Hierarchy Chart](../mfc/hierarchy-chart.md)
[Classes](../mfc/reference/mfc-classes.md)
-[CMFCToolBar Class](../mfc/reference/cmfctoolbar-class.md)
-[CMFCToolBarButton Class](../mfc/reference/cmfctoolbarbutton-class.md)
-[CMFCToolBarComboBoxButton Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md)
-[CMFCToolBarsCustomizeDialog Class](../mfc/reference/cmfctoolbarscustomizedialog-class.md) +[`CMFCToolBar` Class](../mfc/reference/cmfctoolbar-class.md)
+[`CMFCToolBarButton` Class](../mfc/reference/cmfctoolbarbutton-class.md)
+[`CMFCToolBarComboBoxButton` Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md)
+[`CMFCToolBarsCustomizeDialog` Class](../mfc/reference/cmfctoolbarscustomizedialog-class.md) From 6eba918524bb9617b7433205ba548a1b78f95538 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 17:08:23 +0800 Subject: [PATCH 0089/1799] Replace `
` with `\` in "Walkthrough: Putting Controls On Toolbars" --- docs/mfc/walkthrough-putting-controls-on-toolbars.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/mfc/walkthrough-putting-controls-on-toolbars.md b/docs/mfc/walkthrough-putting-controls-on-toolbars.md index 7114db74370..90048a49c2f 100644 --- a/docs/mfc/walkthrough-putting-controls-on-toolbars.md +++ b/docs/mfc/walkthrough-putting-controls-on-toolbars.md @@ -93,9 +93,9 @@ In the customization handler `OnViewCustomize`, call [`CMFCToolBarsCustomizeDial ## See also -[Hierarchy Chart](../mfc/hierarchy-chart.md)
-[Classes](../mfc/reference/mfc-classes.md)
-[`CMFCToolBar` Class](../mfc/reference/cmfctoolbar-class.md)
-[`CMFCToolBarButton` Class](../mfc/reference/cmfctoolbarbutton-class.md)
-[`CMFCToolBarComboBoxButton` Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md)
+[Hierarchy Chart](../mfc/hierarchy-chart.md)\ +[Classes](../mfc/reference/mfc-classes.md)\ +[`CMFCToolBar` Class](../mfc/reference/cmfctoolbar-class.md)\ +[`CMFCToolBarButton` Class](../mfc/reference/cmfctoolbarbutton-class.md)\ +[`CMFCToolBarComboBoxButton` Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md)\ [`CMFCToolBarsCustomizeDialog` Class](../mfc/reference/cmfctoolbarscustomizedialog-class.md) From a5d8881945b2016933d5c8bec5405809df693984 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 17:09:59 +0800 Subject: [PATCH 0090/1799] Clean up unnecessary double space in "Walkthrough: Putting Controls On Toolbars" --- docs/mfc/walkthrough-putting-controls-on-toolbars.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/walkthrough-putting-controls-on-toolbars.md b/docs/mfc/walkthrough-putting-controls-on-toolbars.md index 90048a49c2f..ab45108d75c 100644 --- a/docs/mfc/walkthrough-putting-controls-on-toolbars.md +++ b/docs/mfc/walkthrough-putting-controls-on-toolbars.md @@ -49,7 +49,7 @@ First, create the **Find** combo box control: 1. Add a new string `"Find the text\nFind"` to the string table and assign it an `ID_EDIT_FIND_COMBO` command ID. This ID will be used as the command ID of the **Find** combo box button. > [!NOTE] - > Because `ID_EDIT_FIND` is a standard command that is processed by `CEditView`, you are not required to implement a special handler for this command. However, you must implement a handler for the new command `ID_EDIT_FIND_COMBO`. + > Because `ID_EDIT_FIND` is a standard command that is processed by `CEditView`, you are not required to implement a special handler for this command. However, you must implement a handler for the new command `ID_EDIT_FIND_COMBO`. 1. Create a new class, `CFindComboBox`, derived from [`CComboBox` Class](../mfc/reference/ccombobox-class.md). From 577b4d0df63f43a922e09db99e835a256204203a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 17:13:37 +0800 Subject: [PATCH 0091/1799] Clean up redundant relative links in "Walkthrough: Putting Controls On Toolbars" --- ...alkthrough-putting-controls-on-toolbars.md | 36 +++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/mfc/walkthrough-putting-controls-on-toolbars.md b/docs/mfc/walkthrough-putting-controls-on-toolbars.md index ab45108d75c..37ae9a2ebf7 100644 --- a/docs/mfc/walkthrough-putting-controls-on-toolbars.md +++ b/docs/mfc/walkthrough-putting-controls-on-toolbars.md @@ -7,7 +7,7 @@ ms.assetid: 8fc94bdf-0da7-45d9-8bc4-52b7b1edf205 --- # Walkthrough: Putting Controls On Toolbars -This article describes how to add a toolbar button that contains a Windows control to a toolbar. In MFC, a toolbar button must be a [`CMFCToolBarButton` Class](../mfc/reference/cmfctoolbarbutton-class.md)-derived class, for example [`CMFCToolBarComboBoxButton` Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md), [`CMFCToolBarEditBoxButton` Class](../mfc/reference/cmfctoolbareditboxbutton-class.md), [`CMFCDropDownToolbarButton` Class](../mfc/reference/cmfcdropdowntoolbarbutton-class.md), or [`CMFCToolBarMenuButton` Class](../mfc/reference/cmfctoolbarmenubutton-class.md). +This article describes how to add a toolbar button that contains a Windows control to a toolbar. In MFC, a toolbar button must be a [`CMFCToolBarButton` Class](reference/cmfctoolbarbutton-class.md)-derived class, for example [`CMFCToolBarComboBoxButton` Class](reference/cmfctoolbarcomboboxbutton-class.md), [`CMFCToolBarEditBoxButton` Class](reference/cmfctoolbareditboxbutton-class.md), [`CMFCDropDownToolbarButton` Class](reference/cmfcdropdowntoolbarbutton-class.md), or [`CMFCToolBarMenuButton` Class](reference/cmfctoolbarmenubutton-class.md). ## Adding Controls to Toolbars @@ -21,7 +21,7 @@ To add a control to a toolbar, follow these steps: 1. Construct the button control by using a `CMFCToolbarButton`-derived class. - 1. Replace the dummy button with the new control by using [`CMFCToolBar::ReplaceButton`](../mfc/reference/cmfctoolbar-class.md#replacebutton). You can construct the button object on the stack, because `ReplaceButton` copies the button object and maintains the copy. + 1. Replace the dummy button with the new control by using [`CMFCToolBar::ReplaceButton`](reference/cmfctoolbar-class.md#replacebutton). You can construct the button object on the stack, because `ReplaceButton` copies the button object and maintains the copy. > [!NOTE] > If you enabled customization in your application, you may have to reset the toolbar by using the **Reset** button on the **Toolbars** tab of the **Customize** dialog box to see the updated control in your application after recompiling. The toolbar state is saved in the Windows registry, and the registry information is loaded and applied after the `ReplaceButton` method is executed during application startup. @@ -30,11 +30,11 @@ To add a control to a toolbar, follow these steps: The **Commands** tab of the **Customize** dialog box contains a list of commands that are available in the application. By default, the **Customize** dialog box processes the application menus and builds a list of standard toolbar buttons in each menu category. To keep the extended functionality that the toolbar controls provide, you must replace the standard toolbar button with the custom control in the **Customize** dialog box. -When you enable customization, you create the **Customize** dialog box in the customization handler `OnViewCustomize` by using the [`CMFCToolBarsCustomizeDialog` Class](../mfc/reference/cmfctoolbarscustomizedialog-class.md) class. Before you display the **Customize** dialog box by calling [`CMFCToolBarsCustomizeDialog::Create`](../mfc/reference/cmfctoolbarscustomizedialog-class.md#create), call [`CMFCToolBarsCustomizeDialog::ReplaceButton`](../mfc/reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the standard button with the new control. +When you enable customization, you create the **Customize** dialog box in the customization handler `OnViewCustomize` by using the [`CMFCToolBarsCustomizeDialog` Class](reference/cmfctoolbarscustomizedialog-class.md) class. Before you display the **Customize** dialog box by calling [`CMFCToolBarsCustomizeDialog::Create`](reference/cmfctoolbarscustomizedialog-class.md#create), call [`CMFCToolBarsCustomizeDialog::ReplaceButton`](reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the standard button with the new control. ## Example: Creating a Find Combo Box -This section describes how to create a **Find** combo box control that appears on a toolbar and contains recent-used search strings. The user can type a string in the control and then press the enter key to search a document, or press the escape key to return the focus to the main frame. This example assumes that the document is displayed in a [`CEditView` Class](../mfc/reference/ceditview-class.md)-derived view. +This section describes how to create a **Find** combo box control that appears on a toolbar and contains recent-used search strings. The user can type a string in the control and then press the enter key to search a document, or press the escape key to return the focus to the main frame. This example assumes that the document is displayed in a [`CEditView` Class](reference/ceditview-class.md)-derived view. ### Creating the Find Control @@ -51,11 +51,11 @@ First, create the **Find** combo box control: > [!NOTE] > Because `ID_EDIT_FIND` is a standard command that is processed by `CEditView`, you are not required to implement a special handler for this command. However, you must implement a handler for the new command `ID_EDIT_FIND_COMBO`. -1. Create a new class, `CFindComboBox`, derived from [`CComboBox` Class](../mfc/reference/ccombobox-class.md). +1. Create a new class, `CFindComboBox`, derived from [`CComboBox` Class](reference/ccombobox-class.md). 1. In the `CFindComboBox` class, override the `PreTranslateMessage` virtual method. This method will enable the combo box to process the [`WM_KEYDOWN`](/windows/win32/inputdev/wm-keydown) message. If the user hits the escape key (`VK_ESCAPE`), return the focus to the main frame window. If the user hits the Enter key (`VK_ENTER`), post to the main frame window a `WM_COMMAND` message that contains the `ID_EDIT_FIND_COMBO` command ID. -1. Create a class for the **Find** combo box button, derived from [`CMFCToolBarComboBoxButton` Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md). In this example, it's named `CFindComboButton`. +1. Create a class for the **Find** combo box button, derived from [`CMFCToolBarComboBoxButton` Class](reference/cmfctoolbarcomboboxbutton-class.md). In this example, it's named `CFindComboButton`. 1. The constructor of `CMFCToolbarComboBoxButton` takes three parameters: the command ID of the button, the button image index, and the style of the combo box. Set these parameters as follows: @@ -63,15 +63,15 @@ First, create the **Find** combo box control: 1. Use [`CCommandManager::GetCmdImage`](reference/internal-classes.md) with `ID_EDIT_FIND` to get the image index. - 1. For a list of available combo box styles, see [Combo-Box Styles](../mfc/reference/styles-used-by-mfc.md#combo-box-styles). + 1. For a list of available combo box styles, see [Combo-Box Styles](reference/styles-used-by-mfc.md#combo-box-styles). 1. In the `CFindComboButton` class, override the `CMFCToolbarComboBoxButton::CreateCombo` method. Here you should create the `CFindComboButton` object and return a pointer to it. -1. Use the [`IMPLEMENT_SERIAL`](../mfc/reference/run-time-object-model-services.md#implement_serial) macro to make the combo button persistent. The workspace manager automatically loads and saves the button's state in the Windows registry. +1. Use the [`IMPLEMENT_SERIAL`](reference/run-time-object-model-services.md#implement_serial) macro to make the combo button persistent. The workspace manager automatically loads and saves the button's state in the Windows registry. -1. Implement the `ID_EDIT_FIND_COMBO` handler in your document view. Use [`CMFCToolBar::GetCommandButtons`](../mfc/reference/cmfctoolbar-class.md#getcommandbuttons) with `ID_EDIT_FIND_COMBO` to retrieve all **Find** combo box buttons. There can be several copies of a button with the same command ID because of customization. +1. Implement the `ID_EDIT_FIND_COMBO` handler in your document view. Use [`CMFCToolBar::GetCommandButtons`](reference/cmfctoolbar-class.md#getcommandbuttons) with `ID_EDIT_FIND_COMBO` to retrieve all **Find** combo box buttons. There can be several copies of a button with the same command ID because of customization. -1. In the `ID_EDIT_FIND` message handler `OnFind`, use [`CMFCToolBar::IsLastCommandFromButton`](../mfc/reference/cmfctoolbar-class.md#islastcommandfrombutton) to determine whether the find command was sent from the **Find** combo box button. If so, find the text and add the search string to the combo box. +1. In the `ID_EDIT_FIND` message handler `OnFind`, use [`CMFCToolBar::IsLastCommandFromButton`](reference/cmfctoolbar-class.md#islastcommandfrombutton) to determine whether the find command was sent from the **Find** combo box button. If so, find the text and add the search string to the combo box. ### Adding the Find Control to the Main Toolbar @@ -82,20 +82,20 @@ To add the combo box button to the toolbar, follow these steps: > [!NOTE] > The framework sends this message to the main frame window when a toolbar is initialized during application startup, or when a toolbar is reset during customization. In either case, you must replace the standard toolbar button with the custom **Find** combo box button. -1. In the `AFX_WM_RESETTOOLBAR` handler, examine the toolbar ID, that is, the *`WPARAM`* of the `AFX_WM_RESETTOOLBAR` message. If the toolbar ID is equal to that of the toolbar that contains the **Find** combo box button, call [`CMFCToolBar::ReplaceButton`](../mfc/reference/cmfctoolbar-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. +1. In the `AFX_WM_RESETTOOLBAR` handler, examine the toolbar ID, that is, the *`WPARAM`* of the `AFX_WM_RESETTOOLBAR` message. If the toolbar ID is equal to that of the toolbar that contains the **Find** combo box button, call [`CMFCToolBar::ReplaceButton`](reference/cmfctoolbar-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. > [!NOTE] > You can construct a `CFindComboBox` object on the stack, because `ReplaceButton` copies the button object and maintains the copy. ### Adding the Find Control to the Customize Dialog Box -In the customization handler `OnViewCustomize`, call [`CMFCToolBarsCustomizeDialog::ReplaceButton`](../mfc/reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. +In the customization handler `OnViewCustomize`, call [`CMFCToolBarsCustomizeDialog::ReplaceButton`](reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. ## See also -[Hierarchy Chart](../mfc/hierarchy-chart.md)\ -[Classes](../mfc/reference/mfc-classes.md)\ -[`CMFCToolBar` Class](../mfc/reference/cmfctoolbar-class.md)\ -[`CMFCToolBarButton` Class](../mfc/reference/cmfctoolbarbutton-class.md)\ -[`CMFCToolBarComboBoxButton` Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md)\ -[`CMFCToolBarsCustomizeDialog` Class](../mfc/reference/cmfctoolbarscustomizedialog-class.md) +[Hierarchy Chart](hierarchy-chart.md)\ +[Classes](reference/mfc-classes.md)\ +[`CMFCToolBar` Class](reference/cmfctoolbar-class.md)\ +[`CMFCToolBarButton` Class](reference/cmfctoolbarbutton-class.md)\ +[`CMFCToolBarComboBoxButton` Class](reference/cmfctoolbarcomboboxbutton-class.md)\ +[`CMFCToolBarsCustomizeDialog` Class](reference/cmfctoolbarscustomizedialog-class.md) From 1c761e22e149631a5e93153d4d7973cd756badca Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 17:14:08 +0800 Subject: [PATCH 0092/1799] Update metadata in "Walkthrough: Putting Controls On Toolbars" --- docs/mfc/walkthrough-putting-controls-on-toolbars.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/mfc/walkthrough-putting-controls-on-toolbars.md b/docs/mfc/walkthrough-putting-controls-on-toolbars.md index 37ae9a2ebf7..2d3962ab8c2 100644 --- a/docs/mfc/walkthrough-putting-controls-on-toolbars.md +++ b/docs/mfc/walkthrough-putting-controls-on-toolbars.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Walkthrough: Putting Controls On Toolbars" title: "Walkthrough: Putting Controls On Toolbars" -ms.date: "04/25/2019" +description: "Learn more about: Walkthrough: Putting Controls On Toolbars" +ms.date: 04/25/2019 helpviewer_keywords: ["Customize dialog box, adding controls", "toolbars [MFC], adding controls"] -ms.assetid: 8fc94bdf-0da7-45d9-8bc4-52b7b1edf205 --- # Walkthrough: Putting Controls On Toolbars From 6c24e298d84bebe95421b1b7c4fdd85060dba00d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 17:55:01 +0800 Subject: [PATCH 0093/1799] Add space between anchor element close and backtick --- docs/mfc/reference/cdc-class.md | 2 +- docs/mfc/reference/ctabctrl-class.md | 2 +- docs/standard-library/bit-functions.md | 24 +++++++++---------- docs/standard-library/range-functions.md | 4 ++-- docs/standard-library/span-functions.md | 4 ++-- .../system-clock-structure.md | 4 ++-- 6 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/mfc/reference/cdc-class.md b/docs/mfc/reference/cdc-class.md index f40795d15ee..4db37ed8cbf 100644 --- a/docs/mfc/reference/cdc-class.md +++ b/docs/mfc/reference/cdc-class.md @@ -2999,7 +2999,7 @@ The function stores the values in the buffer pointed to by *`lpBuffer`*. This bu If a character in the consecutive group of characters doesn't exist in a particular font, it will be assigned the width value of the default character. -## `CDC::GetOutputTabbedTextExtent` +## `CDC::GetOutputTabbedTextExtent` Call this member function to compute the width and height of a character string using [`m_hDC`](#m_hdc), the output device context. diff --git a/docs/mfc/reference/ctabctrl-class.md b/docs/mfc/reference/ctabctrl-class.md index dc43226fbde..1a2461f10b1 100644 --- a/docs/mfc/reference/ctabctrl-class.md +++ b/docs/mfc/reference/ctabctrl-class.md @@ -80,7 +80,7 @@ For more information about `CTabCtrl`, see [Controls](../../mfc/controls-mfc.md) **Header:** `afxcmn.h` -## `CTabCtrl::AdjustRect` +## `CTabCtrl::AdjustRect` Calculates a tab control's display area given a window rectangle, or calculates the window rectangle that would correspond to a given display area. diff --git a/docs/standard-library/bit-functions.md b/docs/standard-library/bit-functions.md index 9563428d96e..10a4bfbb1d2 100644 --- a/docs/standard-library/bit-functions.md +++ b/docs/standard-library/bit-functions.md @@ -24,7 +24,7 @@ The `` header includes the following non-member template functions: |[`rotl`](#rotl) | Compute the result of a bitwise left rotation. | |[`rotr`](#rotr) | Compute the result of a bitwise right rotation. | -## `bit_cast` +## `bit_cast` Copy a bit pattern from an object of type `From` to a new object of type `To`. @@ -92,7 +92,7 @@ This function template is `constexpr` if and only if `To`, `From`, and the types - Not volatile-qualified - Have no non-static data member that is a reference type -## `bit_ceil` +## `bit_ceil` Find the smallest power of two greater than or equal to a value. For example, given `3`, returns `4`. @@ -142,7 +142,7 @@ bit_ceil(0b0101) = 0b1000 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `bit_floor` +## `bit_floor` Find the largest power of two not greater than a value. For example, given `5`, returns `4`. @@ -193,7 +193,7 @@ bit_floor(0b0101) = 0b0100 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `bit_width` +## `bit_width` Find the smallest number of bits needed to represent a value. @@ -247,7 +247,7 @@ bit_width(8) = 4 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `countl_zero` +## `countl_zero` Count the number of consecutive bits set to zero, starting from the most significant bit. @@ -300,7 +300,7 @@ countl_zero(0b10000000) = 0 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `countl_one` +## `countl_one` Count the number of consecutive bits set to one, starting from the most significant bit. @@ -353,7 +353,7 @@ countl_one(0b11111111) = 8 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `countr_zero` +## `countr_zero` Count the number of consecutive bits set to zero, starting from the least significant bit. @@ -407,7 +407,7 @@ countr_zero(0b10000000) = 7 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `countr_one` +## `countr_one` Count the number of consecutive bits set to one, starting from the least significant bit. @@ -460,7 +460,7 @@ countr_one(0b11111111) = 8 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `has_single_bit` +## `has_single_bit` Check if a value has only one bit set.This is the same as testing whether a value is a power of two. @@ -514,7 +514,7 @@ has_single_bit(0b1001) = false This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `popcount` +## `popcount` Count the number of bits set to one in an unsigned integer value. @@ -573,7 +573,7 @@ popcount(0b1111) = 4 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `rotl` +## `rotl` Rotates the bits of an unsigned integer value left the specified number of times. Bits that "fall out" of the leftmost bit are rotated into the rightmost bit. @@ -635,7 +635,7 @@ rotl(0b00000001,-1) = 0b10000000 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `rotr` +## `rotr` Rotates the bits of `value` right the specified number of times. Bits that 'fall out' of the rightmost bit are rotated back into the leftmost bit. diff --git a/docs/standard-library/range-functions.md b/docs/standard-library/range-functions.md index 359201dcd0f..52c5fffab5f 100644 --- a/docs/standard-library/range-functions.md +++ b/docs/standard-library/range-functions.md @@ -482,7 +482,7 @@ int main() } ``` -## `rend` +## `rend` Get a reverse iterator to the sentinel at the end of a reversed view of the range. A reverse iterator returns the elements of the range in reverse order. @@ -571,7 +571,7 @@ int main() } ``` -## `ssize` +## `ssize` Get the size of the range as a signed value. diff --git a/docs/standard-library/span-functions.md b/docs/standard-library/span-functions.md index 4c92144c44f..91c7b2c3762 100644 --- a/docs/standard-library/span-functions.md +++ b/docs/standard-library/span-functions.md @@ -15,7 +15,7 @@ The `` header includes the following non-member functions that operate on |[`as_bytes`](#as_bytes) | Get a read-only view of the object representation of the elements in the span. | |[`as_writable_bytes`](#as_writable_bytes) | Get a read/write view of the object representation of the elements in the span. | -## `as_bytes` +## `as_bytes` Get a read-only view of the object representation of the elements in the span. @@ -55,7 +55,7 @@ int main() } ``` -## `as_writable_bytes` +## `as_writable_bytes` If `T` isn't **`const`**, gets a read/write view of the raw byte representation of the elements in the span. diff --git a/docs/standard-library/system-clock-structure.md b/docs/standard-library/system-clock-structure.md index d8bff11b411..af04f3adec8 100644 --- a/docs/standard-library/system-clock-structure.md +++ b/docs/standard-library/system-clock-structure.md @@ -66,7 +66,7 @@ A clock is *steady* if it is *monotonic* and if the time between clock ticks is **Namespace:** `std::chrono` -## `from_time_t` +## `from_time_t` Static method that returns a [time_point](../standard-library/time-point-class.md) that most closely approximates the time that is represented by *Tm*. @@ -79,7 +79,7 @@ static time_point from_time_t(time_t Tm) noexcept; *`Tm`*\ A [time_t](../c-runtime-library/standard-types.md) object. -## `is_steady` +## `is_steady` A static value that specifies whether the clock type is *steady*. Because the `system_clock` isn't steady, you can't use this clock to take the time before an event, the time after an event, and reliably subtract them to get the duration of the event because the clock may be adjusted during the timing interval. From 1a78be8a290a04429847441c23540acfe8fd269a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 17:56:47 +0800 Subject: [PATCH 0094/1799] Update metadata in some reference topics --- docs/mfc/reference/cdc-class.md | 2 +- docs/standard-library/bit-functions.md | 2 +- docs/standard-library/span-functions.md | 2 +- docs/standard-library/system-clock-structure.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/mfc/reference/cdc-class.md b/docs/mfc/reference/cdc-class.md index 4db37ed8cbf..04f399f5b24 100644 --- a/docs/mfc/reference/cdc-class.md +++ b/docs/mfc/reference/cdc-class.md @@ -1,7 +1,7 @@ --- title: "CDC Class" description: "Learn more about: CDC Class" -ms.date: "11/19/2018" +ms.date: 11/19/2018 f1_keywords: ["CDC", "AFXWIN/CDC", "AFXWIN/CDC::CDC", "AFXWIN/CDC::AbortDoc", "AFXWIN/CDC::AbortPath", "AFXWIN/CDC::AddMetaFileComment", "AFXWIN/CDC::AlphaBlend", "AFXWIN/CDC::AngleArc", "AFXWIN/CDC::Arc", "AFXWIN/CDC::ArcTo", "AFXWIN/CDC::Attach", "AFXWIN/CDC::BeginPath", "AFXWIN/CDC::BitBlt", "AFXWIN/CDC::Chord", "AFXWIN/CDC::CloseFigure", "AFXWIN/CDC::CreateCompatibleDC", "AFXWIN/CDC::CreateDC", "AFXWIN/CDC::CreateIC", "AFXWIN/CDC::DeleteDC", "AFXWIN/CDC::DeleteTempMap", "AFXWIN/CDC::Detach", "AFXWIN/CDC::DPtoHIMETRIC", "AFXWIN/CDC::DPtoLP", "AFXWIN/CDC::Draw3dRect", "AFXWIN/CDC::DrawDragRect", "AFXWIN/CDC::DrawEdge", "AFXWIN/CDC::DrawEscape", "AFXWIN/CDC::DrawFocusRect", "AFXWIN/CDC::DrawFrameControl", "AFXWIN/CDC::DrawIcon", "AFXWIN/CDC::DrawState", "AFXWIN/CDC::DrawText", "AFXWIN/CDC::DrawTextEx", "AFXWIN/CDC::Ellipse", "AFXWIN/CDC::EndDoc", "AFXWIN/CDC::EndPage", "AFXWIN/CDC::EndPath", "AFXWIN/CDC::EnumObjects", "AFXWIN/CDC::Escape", "AFXWIN/CDC::ExcludeClipRect", "AFXWIN/CDC::ExcludeUpdateRgn", "AFXWIN/CDC::ExtFloodFill", "AFXWIN/CDC::ExtTextOut", "AFXWIN/CDC::FillPath", "AFXWIN/CDC::FillRect", "AFXWIN/CDC::FillRgn", "AFXWIN/CDC::FillSolidRect", "AFXWIN/CDC::FlattenPath", "AFXWIN/CDC::FloodFill", "AFXWIN/CDC::FrameRect", "AFXWIN/CDC::FrameRgn", "AFXWIN/CDC::FromHandle", "AFXWIN/CDC::GetArcDirection", "AFXWIN/CDC::GetAspectRatioFilter", "AFXWIN/CDC::GetBkColor", "AFXWIN/CDC::GetBkMode", "AFXWIN/CDC::GetBoundsRect", "AFXWIN/CDC::GetBrushOrg", "AFXWIN/CDC::GetCharABCWidths", "AFXWIN/CDC::GetCharABCWidthsI", "AFXWIN/CDC::GetCharacterPlacement", "AFXWIN/CDC::GetCharWidth", "AFXWIN/CDC::GetCharWidthI", "AFXWIN/CDC::GetClipBox", "AFXWIN/CDC::GetColorAdjustment", "AFXWIN/CDC::GetCurrentBitmap", "AFXWIN/CDC::GetCurrentBrush", "AFXWIN/CDC::GetCurrentFont", "AFXWIN/CDC::GetCurrentPalette", "AFXWIN/CDC::GetCurrentPen", "AFXWIN/CDC::GetCurrentPosition", "AFXWIN/CDC::GetDCBrushColor", "AFXWIN/CDC::GetDCPenColor", "AFXWIN/CDC::GetDeviceCaps", "AFXWIN/CDC::GetFontData", "AFXWIN/CDC::GetFontLanguageInfo", "AFXWIN/CDC::GetGlyphOutline", "AFXWIN/CDC::GetGraphicsMode", "AFXWIN/CDC::GetHalftoneBrush", "AFXWIN/CDC::GetKerningPairs", "AFXWIN/CDC::GetLayout", "AFXWIN/CDC::GetMapMode", "AFXWIN/CDC::GetMiterLimit", "AFXWIN/CDC::GetNearestColor", "AFXWIN/CDC::GetOutlineTextMetrics", "AFXWIN/CDC::GetOutputCharWidth", "AFXWIN/CDC::GetOutputTabbedTextExtent", "AFXWIN/CDC::GetOutputTextExtent", "AFXWIN/CDC::GetOutputTextMetrics", "AFXWIN/CDC::GetPath", "AFXWIN/CDC::GetPixel", "AFXWIN/CDC::GetPolyFillMode", "AFXWIN/CDC::GetROP2", "AFXWIN/CDC::GetSafeHdc", "AFXWIN/CDC::GetStretchBltMode", "AFXWIN/CDC::GetTabbedTextExtent", "AFXWIN/CDC::GetTextAlign", "AFXWIN/CDC::GetTextCharacterExtra", "AFXWIN/CDC::GetTextColor", "AFXWIN/CDC::GetTextExtent", "AFXWIN/CDC::GetTextExtentExPointI", "AFXWIN/CDC::GetTextExtentPointI", "AFXWIN/CDC::GetTextFace", "AFXWIN/CDC::GetTextMetrics", "AFXWIN/CDC::GetViewportExt", "AFXWIN/CDC::GetViewportOrg", "AFXWIN/CDC::GetWindow", "AFXWIN/CDC::GetWindowExt", "AFXWIN/CDC::GetWindowOrg", "AFXWIN/CDC::GetWorldTransform", "AFXWIN/CDC::GradientFill", "AFXWIN/CDC::GrayString", "AFXWIN/CDC::HIMETRICtoDP", "AFXWIN/CDC::HIMETRICtoLP", "AFXWIN/CDC::IntersectClipRect", "AFXWIN/CDC::InvertRect", "AFXWIN/CDC::InvertRgn", "AFXWIN/CDC::IsPrinting", "AFXWIN/CDC::LineTo", "AFXWIN/CDC::LPtoDP", "AFXWIN/CDC::LPtoHIMETRIC", "AFXWIN/CDC::MaskBlt", "AFXWIN/CDC::ModifyWorldTransform", "AFXWIN/CDC::MoveTo", "AFXWIN/CDC::OffsetClipRgn", "AFXWIN/CDC::OffsetViewportOrg", "AFXWIN/CDC::OffsetWindowOrg", "AFXWIN/CDC::PaintRgn", "AFXWIN/CDC::PatBlt", "AFXWIN/CDC::Pie", "AFXWIN/CDC::PlayMetaFile", "AFXWIN/CDC::PlgBlt", "AFXWIN/CDC::PolyBezier", "AFXWIN/CDC::PolyBezierTo", "AFXWIN/CDC::PolyDraw", "AFXWIN/CDC::Polygon", "AFXWIN/CDC::Polyline", "AFXWIN/CDC::PolylineTo", "AFXWIN/CDC::PolyPolygon", "AFXWIN/CDC::PolyPolyline", "AFXWIN/CDC::PtVisible", "AFXWIN/CDC::RealizePalette", "AFXWIN/CDC::Rectangle", "AFXWIN/CDC::RectVisible", "AFXWIN/CDC::ReleaseAttribDC", "AFXWIN/CDC::ReleaseOutputDC", "AFXWIN/CDC::ResetDC", "AFXWIN/CDC::RestoreDC", "AFXWIN/CDC::RoundRect", "AFXWIN/CDC::SaveDC", "AFXWIN/CDC::ScaleViewportExt", "AFXWIN/CDC::ScaleWindowExt", "AFXWIN/CDC::ScrollDC", "AFXWIN/CDC::SelectClipPath", "AFXWIN/CDC::SelectClipRgn", "AFXWIN/CDC::SelectObject", "AFXWIN/CDC::SelectPalette", "AFXWIN/CDC::SelectStockObject", "AFXWIN/CDC::SetAbortProc", "AFXWIN/CDC::SetArcDirection", "AFXWIN/CDC::SetAttribDC", "AFXWIN/CDC::SetBkColor", "AFXWIN/CDC::SetBkMode", "AFXWIN/CDC::SetBoundsRect", "AFXWIN/CDC::SetBrushOrg", "AFXWIN/CDC::SetColorAdjustment", "AFXWIN/CDC::SetDCBrushColor", "AFXWIN/CDC::SetDCPenColor", "AFXWIN/CDC::SetGraphicsMode", "AFXWIN/CDC::SetLayout", "AFXWIN/CDC::SetMapMode", "AFXWIN/CDC::SetMapperFlags", "AFXWIN/CDC::SetMiterLimit", "AFXWIN/CDC::SetOutputDC", "AFXWIN/CDC::SetPixel", "AFXWIN/CDC::SetPixelV", "AFXWIN/CDC::SetPolyFillMode", "AFXWIN/CDC::SetROP2", "AFXWIN/CDC::SetStretchBltMode", "AFXWIN/CDC::SetTextAlign", "AFXWIN/CDC::SetTextCharacterExtra", "AFXWIN/CDC::SetTextColor", "AFXWIN/CDC::SetTextJustification", "AFXWIN/CDC::SetViewportExt", "AFXWIN/CDC::SetViewportOrg", "AFXWIN/CDC::SetWindowExt", "AFXWIN/CDC::SetWindowOrg", "AFXWIN/CDC::SetWorldTransform", "AFXWIN/CDC::StartDoc", "AFXWIN/CDC::StartPage", "AFXWIN/CDC::StretchBlt", "AFXWIN/CDC::StrokeAndFillPath", "AFXWIN/CDC::StrokePath", "AFXWIN/CDC::TabbedTextOut", "AFXWIN/CDC::TextOut", "AFXWIN/CDC::TransparentBlt", "AFXWIN/CDC::UpdateColors", "AFXWIN/CDC::WidenPath", "AFXWIN/CDC::m_hAttribDC", "AFXWIN/CDC::m_hDC"] helpviewer_keywords: ["CDC [MFC], CDC", "CDC [MFC], AbortDoc", "CDC [MFC], AbortPath", "CDC [MFC], AddMetaFileComment", "CDC [MFC], AlphaBlend", "CDC [MFC], AngleArc", "CDC [MFC], Arc", "CDC [MFC], ArcTo", "CDC [MFC], Attach", "CDC [MFC], BeginPath", "CDC [MFC], BitBlt", "CDC [MFC], Chord", "CDC [MFC], CloseFigure", "CDC [MFC], CreateCompatibleDC", "CDC [MFC], CreateDC", "CDC [MFC], CreateIC", "CDC [MFC], DeleteDC", "CDC [MFC], DeleteTempMap", "CDC [MFC], Detach", "CDC [MFC], DPtoHIMETRIC", "CDC [MFC], DPtoLP", "CDC [MFC], Draw3dRect", "CDC [MFC], DrawDragRect", "CDC [MFC], DrawEdge", "CDC [MFC], DrawEscape", "CDC [MFC], DrawFocusRect", "CDC [MFC], DrawFrameControl", "CDC [MFC], DrawIcon", "CDC [MFC], DrawState", "CDC [MFC], DrawText", "CDC [MFC], DrawTextEx", "CDC [MFC], Ellipse", "CDC [MFC], EndDoc", "CDC [MFC], EndPage", "CDC [MFC], EndPath", "CDC [MFC], EnumObjects", "CDC [MFC], Escape", "CDC [MFC], ExcludeClipRect", "CDC [MFC], ExcludeUpdateRgn", "CDC [MFC], ExtFloodFill", "CDC [MFC], ExtTextOut", "CDC [MFC], FillPath", "CDC [MFC], FillRect", "CDC [MFC], FillRgn", "CDC [MFC], FillSolidRect", "CDC [MFC], FlattenPath", "CDC [MFC], FloodFill", "CDC [MFC], FrameRect", "CDC [MFC], FrameRgn", "CDC [MFC], FromHandle", "CDC [MFC], GetArcDirection", "CDC [MFC], GetAspectRatioFilter", "CDC [MFC], GetBkColor", "CDC [MFC], GetBkMode", "CDC [MFC], GetBoundsRect", "CDC [MFC], GetBrushOrg", "CDC [MFC], GetCharABCWidths", "CDC [MFC], GetCharABCWidthsI", "CDC [MFC], GetCharacterPlacement", "CDC [MFC], GetCharWidth", "CDC [MFC], GetCharWidthI", "CDC [MFC], GetClipBox", "CDC [MFC], GetColorAdjustment", "CDC [MFC], GetCurrentBitmap", "CDC [MFC], GetCurrentBrush", "CDC [MFC], GetCurrentFont", "CDC [MFC], GetCurrentPalette", "CDC [MFC], GetCurrentPen", "CDC [MFC], GetCurrentPosition", "CDC [MFC], GetDCBrushColor", "CDC [MFC], GetDCPenColor", "CDC [MFC], GetDeviceCaps", "CDC [MFC], GetFontData", "CDC [MFC], GetFontLanguageInfo", "CDC [MFC], GetGlyphOutline", "CDC [MFC], GetGraphicsMode", "CDC [MFC], GetHalftoneBrush", "CDC [MFC], GetKerningPairs", "CDC [MFC], GetLayout", "CDC [MFC], GetMapMode", "CDC [MFC], GetMiterLimit", "CDC [MFC], GetNearestColor", "CDC [MFC], GetOutlineTextMetrics", "CDC [MFC], GetOutputCharWidth", "CDC [MFC], GetOutputTabbedTextExtent", "CDC [MFC], GetOutputTextExtent", "CDC [MFC], GetOutputTextMetrics", "CDC [MFC], GetPath", "CDC [MFC], GetPixel", "CDC [MFC], GetPolyFillMode", "CDC [MFC], GetROP2", "CDC [MFC], GetSafeHdc", "CDC [MFC], GetStretchBltMode", "CDC [MFC], GetTabbedTextExtent", "CDC [MFC], GetTextAlign", "CDC [MFC], GetTextCharacterExtra", "CDC [MFC], GetTextColor", "CDC [MFC], GetTextExtent", "CDC [MFC], GetTextExtentExPointI", "CDC [MFC], GetTextExtentPointI", "CDC [MFC], GetTextFace", "CDC [MFC], GetTextMetrics", "CDC [MFC], GetViewportExt", "CDC [MFC], GetViewportOrg", "CDC [MFC], GetWindow", "CDC [MFC], GetWindowExt", "CDC [MFC], GetWindowOrg", "CDC [MFC], GetWorldTransform", "CDC [MFC], GradientFill", "CDC [MFC], GrayString", "CDC [MFC], HIMETRICtoDP", "CDC [MFC], HIMETRICtoLP", "CDC [MFC], IntersectClipRect", "CDC [MFC], InvertRect", "CDC [MFC], InvertRgn", "CDC [MFC], IsPrinting", "CDC [MFC], LineTo", "CDC [MFC], LPtoDP", "CDC [MFC], LPtoHIMETRIC", "CDC [MFC], MaskBlt", "CDC [MFC], ModifyWorldTransform", "CDC [MFC], MoveTo", "CDC [MFC], OffsetClipRgn", "CDC [MFC], OffsetViewportOrg", "CDC [MFC], OffsetWindowOrg", "CDC [MFC], PaintRgn", "CDC [MFC], PatBlt", "CDC [MFC], Pie", "CDC [MFC], PlayMetaFile", "CDC [MFC], PlgBlt", "CDC [MFC], PolyBezier", "CDC [MFC], PolyBezierTo", "CDC [MFC], PolyDraw", "CDC [MFC], Polygon", "CDC [MFC], Polyline", "CDC [MFC], PolylineTo", "CDC [MFC], PolyPolygon", "CDC [MFC], PolyPolyline", "CDC [MFC], PtVisible", "CDC [MFC], RealizePalette", "CDC [MFC], Rectangle", "CDC [MFC], RectVisible", "CDC [MFC], ReleaseAttribDC", "CDC [MFC], ReleaseOutputDC", "CDC [MFC], ResetDC", "CDC [MFC], RestoreDC", "CDC [MFC], RoundRect", "CDC [MFC], SaveDC", "CDC [MFC], ScaleViewportExt", "CDC [MFC], ScaleWindowExt", "CDC [MFC], ScrollDC", "CDC [MFC], SelectClipPath", "CDC [MFC], SelectClipRgn", "CDC [MFC], SelectObject", "CDC [MFC], SelectPalette", "CDC [MFC], SelectStockObject", "CDC [MFC], SetAbortProc", "CDC [MFC], SetArcDirection", "CDC [MFC], SetAttribDC", "CDC [MFC], SetBkColor", "CDC [MFC], SetBkMode", "CDC [MFC], SetBoundsRect", "CDC [MFC], SetBrushOrg", "CDC [MFC], SetColorAdjustment", "CDC [MFC], SetDCBrushColor", "CDC [MFC], SetDCPenColor", "CDC [MFC], SetGraphicsMode", "CDC [MFC], SetLayout", "CDC [MFC], SetMapMode", "CDC [MFC], SetMapperFlags", "CDC [MFC], SetMiterLimit", "CDC [MFC], SetOutputDC", "CDC [MFC], SetPixel", "CDC [MFC], SetPixelV", "CDC [MFC], SetPolyFillMode", "CDC [MFC], SetROP2", "CDC [MFC], SetStretchBltMode", "CDC [MFC], SetTextAlign", "CDC [MFC], SetTextCharacterExtra", "CDC [MFC], SetTextColor", "CDC [MFC], SetTextJustification", "CDC [MFC], SetViewportExt", "CDC [MFC], SetViewportOrg", "CDC [MFC], SetWindowExt", "CDC [MFC], SetWindowOrg", "CDC [MFC], SetWorldTransform", "CDC [MFC], StartDoc", "CDC [MFC], StartPage", "CDC [MFC], StretchBlt", "CDC [MFC], StrokeAndFillPath", "CDC [MFC], StrokePath", "CDC [MFC], TabbedTextOut", "CDC [MFC], TextOut", "CDC [MFC], TransparentBlt", "CDC [MFC], UpdateColors", "CDC [MFC], WidenPath", "CDC [MFC], m_hAttribDC", "CDC [MFC], m_hDC"] --- diff --git a/docs/standard-library/bit-functions.md b/docs/standard-library/bit-functions.md index 10a4bfbb1d2..a989e550d7d 100644 --- a/docs/standard-library/bit-functions.md +++ b/docs/standard-library/bit-functions.md @@ -1,7 +1,7 @@ --- title: " functions" description: "Functions to access, manipulate, and process individual bits and sequences of bits" -ms.date: "08/28/2020" +ms.date: 08/28/2020 f1_keywords: ["bit/std::bit_cast", "bit/std::has_single_bit", "bit/std::bit_ceil", "bit/std::bit_floor", "bit/std::bit_width", "bit/std::rotl", "bit/std::rotr", "bit/std::countl_zero", "bit/std::countl_one","bit/std::countr_zero","bit/std::countr_one","bit/std::popcount"] helpviewer_keywords: ["std::bit [C++], bit_cast", "std::bit [C++], has_single_bit", "std::bit [C++], bit_ceil", "std::bit [C++], bit_floor", "std::bit [C++], bit_width", "std::bit [C++], rotl", "std::bit [C++], rotr", "std::bit [C++], countl_zero", "std::bit [C++], countl_one", "std::bit [C++], countr_zero", "std::bit [C++], countr_one", "std::bit [C++], popcount"] --- diff --git a/docs/standard-library/span-functions.md b/docs/standard-library/span-functions.md index 91c7b2c3762..581e347c753 100644 --- a/docs/standard-library/span-functions.md +++ b/docs/standard-library/span-functions.md @@ -1,7 +1,7 @@ --- title: " functions" description: "Learn more about: functions" -ms.date: "05/28/2020" +ms.date: 05/28/2020 f1_keywords: ["span/std::span::as_bytes", "span/std::as_writable_bytes"] helpviewer_keywords: ["std::span [C++], as_writable_bytes", "std::as_bytes [C++]"] dev_langs: ["C++"] diff --git a/docs/standard-library/system-clock-structure.md b/docs/standard-library/system-clock-structure.md index af04f3adec8..e4f4f308681 100644 --- a/docs/standard-library/system-clock-structure.md +++ b/docs/standard-library/system-clock-structure.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: system_clock Structure" title: "system_clock Structure" +description: "Learn more about: system_clock Structure" ms.date: 07/26/2021 f1_keywords: ["chrono/std::chrono::system_clock", "chrono/std::chrono::system_clock::from_time_t", "chrono/std::chrono::system_clock::now", "chrono/std::chrono::system_clock::to_time_t", "chrono/std::chrono::system_clock::is_steady constant"] helpviewer_keywords: ["std::chrono [C++], system_clock"] From c82da1d7461a3c748bf27ef433ac77911e7a7e7e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 18:15:38 +0800 Subject: [PATCH 0095/1799] Resolve malformed `CDockablePane::LoadState` heading --- docs/mfc/reference/cdockablepane-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/reference/cdockablepane-class.md b/docs/mfc/reference/cdockablepane-class.md index 7b65d85589f..029dbf80670 100644 --- a/docs/mfc/reference/cdockablepane-class.md +++ b/docs/mfc/reference/cdockablepane-class.md @@ -1142,7 +1142,7 @@ If the dockable pane is in autohide mode and `IsHideInAutoHideMode` returns `TRU If the dockable pane isn't in autohide mode, the visibility state is determined by the [`CBasePane::IsVisible`](../../mfc/reference/cbasepane-class.md#isvisible) method. -## ## `CDockablePane::LoadState` +## `CDockablePane::LoadState` For internal use only. For more detail, see the source code located in the `mfc` folder of your Visual Studio installation. For example, `%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc`. From 5e4b00103cd47c72e48d740365eeeb3d4c90ec1f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 18:16:35 +0800 Subject: [PATCH 0096/1799] Remove double quotes for `ms.date` in `CDockablePane` class reference --- docs/mfc/reference/cdockablepane-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/reference/cdockablepane-class.md b/docs/mfc/reference/cdockablepane-class.md index 029dbf80670..cd6f7131161 100644 --- a/docs/mfc/reference/cdockablepane-class.md +++ b/docs/mfc/reference/cdockablepane-class.md @@ -1,7 +1,7 @@ --- title: "CDockablePane Class" description: "Learn more about: CDockablePane Class" -ms.date: "07/02/2019" +ms.date: 07/02/2019 f1_keywords: ["CDockablePane", "AFXDOCKABLEPANE/CDockablePane", "AFXDOCKABLEPANE/CDockablePane::CDockablePane", "AFXDOCKABLEPANE/CDockablePane::AttachToTabWnd", "AFXDOCKABLEPANE/CDockablePane::CalcFixedLayout", "AFXDOCKABLEPANE/CDockablePane::CanAcceptMiniFrame", "AFXDOCKABLEPANE/CDockablePane::CanAcceptPane", "AFXDOCKABLEPANE/CDockablePane::CanAutoHide", "AFXDOCKABLEPANE/CDockablePane::CanBeAttached", "AFXDOCKABLEPANE/CDockablePane::ConvertToTabbedDocument", "AFXDOCKABLEPANE/CDockablePane::CopyState", "AFXDOCKABLEPANE/CDockablePane::Create", "AFXDOCKABLEPANE/CDockablePane::CreateDefaultPaneDivider", "AFXDOCKABLEPANE/CDockablePane::CreateEx", "AFXDOCKABLEPANE/CDockablePane::CreateTabbedPane", "AFXDOCKABLEPANE/CDockablePane::DockPaneContainer", "AFXDOCKABLEPANE/CDockablePane::DockPaneStandard", "AFXDOCKABLEPANE/CDockablePane::DockToRecentPos", "AFXDOCKABLEPANE/CDockablePane::DockToWindow", "AFXDOCKABLEPANE/CDockablePane::EnableAutohideAll", "AFXDOCKABLEPANE/CDockablePane::EnableGripper", "AFXDOCKABLEPANE/CDockablePane::GetAHRestoredRect", "AFXDOCKABLEPANE/CDockablePane::GetAHSlideMode", "AFXDOCKABLEPANE/CDockablePane::GetCaptionHeight", "AFXDOCKABLEPANE/CDockablePane::GetDefaultPaneDivider", "AFXDOCKABLEPANE/CDockablePane::GetDockingStatus", "AFXDOCKABLEPANE/CDockablePane::GetDragSensitivity", "AFXDOCKABLEPANE/CDockablePane::GetLastPercentInPaneContainer", "AFXDOCKABLEPANE/CDockablePane::GetTabArea", "AFXDOCKABLEPANE/CDockablePane::GetTabbedPaneRTC", "AFXDOCKABLEPANE/CDockablePane::HasAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::HitTest", "AFXDOCKABLEPANE/CDockablePane::IsAutohideAllEnabled", "AFXDOCKABLEPANE/CDockablePane::IsAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::IsDocked", "AFXDOCKABLEPANE/CDockablePane::IsHideInAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::IsInFloatingMultiPaneFrameWnd", "AFXDOCKABLEPANE/CDockablePane::IsResizable", "AFXDOCKABLEPANE/CDockablePane::IsTabLocationBottom", "AFXDOCKABLEPANE/CDockablePane::IsTracked", "AFXDOCKABLEPANE/CDockablePane::IsVisible", "AFXDOCKABLEPANE/CDockablePane::OnAfterChangeParent", "AFXDOCKABLEPANE/CDockablePane::OnAfterDockFromMiniFrame", "AFXDOCKABLEPANE/CDockablePane::OnBeforeChangeParent", "AFXDOCKABLEPANE/CDockablePane::OnBeforeFloat", "AFXDOCKABLEPANE/CDockablePane::RemoveFromDefaultPaneDividier", "AFXDOCKABLEPANE/CDockablePane::ReplacePane", "AFXDOCKABLEPANE/CDockablePane::RestoreDefaultPaneDivider", "AFXDOCKABLEPANE/CDockablePane::SetAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::SetAutoHideParents", "AFXDOCKABLEPANE/CDockablePane::SetLastPercentInPaneContainer", "AFXDOCKABLEPANE/CDockablePane::SetRestoredDefaultPaneDivider", "AFXDOCKABLEPANE/CDockablePane::SetTabbedPaneRTC", "AFXDOCKABLEPANE/CDockablePane::ShowPane", "AFXDOCKABLEPANE/CDockablePane::Slide", "AFXDOCKABLEPANE/CDockablePane::ToggleAutoHide", "AFXDOCKABLEPANE/CDockablePane::UndockPane", "AFXDOCKABLEPANE/CDockablePane::CheckAutoHideCondition", "AFXDOCKABLEPANE/CDockablePane::CheckStopSlideCondition", "AFXDOCKABLEPANE/CDockablePane::DrawCaption", "AFXDOCKABLEPANE/CDockablePane::OnPressButtons", "AFXDOCKABLEPANE/CDockablePane::OnSlide", "AFXDOCKABLEPANE/CDockablePane::m_bDisableAnimation", "AFXDOCKABLEPANE/CDockablePane::m_bHideInAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::m_nSlideSteps"] helpviewer_keywords: ["CDockablePane [MFC], CDockablePane", "CDockablePane [MFC], AttachToTabWnd", "CDockablePane [MFC], CalcFixedLayout", "CDockablePane [MFC], CanAcceptMiniFrame", "CDockablePane [MFC], CanAcceptPane", "CDockablePane [MFC], CanAutoHide", "CDockablePane [MFC], CanBeAttached", "CDockablePane [MFC], ConvertToTabbedDocument", "CDockablePane [MFC], CopyState", "CDockablePane [MFC], Create", "CDockablePane [MFC], CreateDefaultPaneDivider", "CDockablePane [MFC], CreateEx", "CDockablePane [MFC], CreateTabbedPane", "CDockablePane [MFC], DockPaneContainer", "CDockablePane [MFC], DockPaneStandard", "CDockablePane [MFC], DockToRecentPos", "CDockablePane [MFC], DockToWindow", "CDockablePane [MFC], EnableAutohideAll", "CDockablePane [MFC], EnableGripper", "CDockablePane [MFC], GetAHRestoredRect", "CDockablePane [MFC], GetAHSlideMode", "CDockablePane [MFC], GetCaptionHeight", "CDockablePane [MFC], GetDefaultPaneDivider", "CDockablePane [MFC], GetDockingStatus", "CDockablePane [MFC], GetDragSensitivity", "CDockablePane [MFC], GetLastPercentInPaneContainer", "CDockablePane [MFC], GetTabArea", "CDockablePane [MFC], GetTabbedPaneRTC", "CDockablePane [MFC], HasAutoHideMode", "CDockablePane [MFC], HitTest", "CDockablePane [MFC], IsAutohideAllEnabled", "CDockablePane [MFC], IsAutoHideMode", "CDockablePane [MFC], IsDocked", "CDockablePane [MFC], IsHideInAutoHideMode", "CDockablePane [MFC], IsInFloatingMultiPaneFrameWnd", "CDockablePane [MFC], IsResizable", "CDockablePane [MFC], IsTabLocationBottom", "CDockablePane [MFC], IsTracked", "CDockablePane [MFC], IsVisible", "CDockablePane [MFC], OnAfterChangeParent", "CDockablePane [MFC], OnAfterDockFromMiniFrame", "CDockablePane [MFC], OnBeforeChangeParent", "CDockablePane [MFC], OnBeforeFloat", "CDockablePane [MFC], RemoveFromDefaultPaneDividier", "CDockablePane [MFC], ReplacePane", "CDockablePane [MFC], RestoreDefaultPaneDivider", "CDockablePane [MFC], SetAutoHideMode", "CDockablePane [MFC], SetAutoHideParents", "CDockablePane [MFC], SetLastPercentInPaneContainer", "CDockablePane [MFC], SetRestoredDefaultPaneDivider", "CDockablePane [MFC], SetTabbedPaneRTC", "CDockablePane [MFC], ShowPane", "CDockablePane [MFC], Slide", "CDockablePane [MFC], ToggleAutoHide", "CDockablePane [MFC], UndockPane", "CDockablePane [MFC], CheckAutoHideCondition", "CDockablePane [MFC], CheckStopSlideCondition", "CDockablePane [MFC], DrawCaption", "CDockablePane [MFC], OnPressButtons", "CDockablePane [MFC], OnSlide", "CDockablePane [MFC], m_bDisableAnimation", "CDockablePane [MFC], m_bHideInAutoHideMode", "CDockablePane [MFC], m_nSlideSteps"] --- From cf9a5fb4fd6b16579ed44d4ca76cacc80b850f76 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 18:35:08 +0800 Subject: [PATCH 0097/1799] Fill in empty table headers --- docs/atl/atl-utilities-reference.md | 8 ++++---- docs/standard-library/any-functions.md | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/atl/atl-utilities-reference.md b/docs/atl/atl-utilities-reference.md index b332716189e..5e942728834 100644 --- a/docs/atl/atl-utilities-reference.md +++ b/docs/atl/atl-utilities-reference.md @@ -9,7 +9,7 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl ## Classes -|   |   | +| Name | Description | |--|--| | [CPathT class](../atl/reference/cpatht-class.md) | This class represents a path. | | [CDebugReportHook class](../atl/reference/cdebugreporthook-class.md) | Use this class to send debug reports to a named pipe. | @@ -21,7 +21,7 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl ## Typedefs -|   |   | +| Name | Description | |--|--| | [CPath](../atl/reference/atl-typedefs.md#cpath) | A specialization of [CPathT](../atl/reference/cpatht-class.md) using `CString`. | | [CPathA](../atl/reference/atl-typedefs.md#cpatha) | A specialization of [CPathT](../atl/reference/cpatht-class.md) using `CStringA`. | @@ -30,13 +30,13 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl ## Enums -|   |   | +| Name | Description | |--|--| | [ATL_URL_SCHEME](../atl/reference/atl-url-scheme-enum.md) | The members of this enumeration provide constants for the schemes understood by [CUrl](../atl/reference/curl-class.md). | ## Functions -|   |   | +| Name | Description | |--|--| | [AtlCanonicalizeUrl](../atl/reference/atl-http-utility-functions.md#atlcanonicalizeurl) | Call this function to canonicalize a URL, which includes converting unsafe characters and spaces into escape sequences. | | [AtlCombineUrl](../atl/reference/atl-http-utility-functions.md#atlcombineurl) | Call this function to combine a base URL and a relative URL into a single, canonical URL. | diff --git a/docs/standard-library/any-functions.md b/docs/standard-library/any-functions.md index 27ebce791b9..dcbb63ff79c 100644 --- a/docs/standard-library/any-functions.md +++ b/docs/standard-library/any-functions.md @@ -11,7 +11,7 @@ The [``](any.md) header declares several free functions for working with th ## Functions -|   |   | +| Name | Description | |--|--| | [`any_cast`](#any_cast) | Makes an object into an `any`. | | [`make_any`](#make_any) | Takes values and creates an `any` object. | From 0650e0bdb8ae7710ea7ff0795b3ffb1b4c260c34 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 18 Jun 2025 18:36:02 +0800 Subject: [PATCH 0098/1799] Update metadata for 2 topics --- docs/atl/atl-utilities-reference.md | 2 +- docs/standard-library/any-functions.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/atl/atl-utilities-reference.md b/docs/atl/atl-utilities-reference.md index 5e942728834..d903e4dbab6 100644 --- a/docs/atl/atl-utilities-reference.md +++ b/docs/atl/atl-utilities-reference.md @@ -1,7 +1,7 @@ --- title: "ATL utilities reference" description: "Learn more about: ATL utilities reference" -ms.date: "11/04/2016" +ms.date: 11/04/2016 --- # ATL utilities reference diff --git a/docs/standard-library/any-functions.md b/docs/standard-library/any-functions.md index dcbb63ff79c..aa9ef35d532 100644 --- a/docs/standard-library/any-functions.md +++ b/docs/standard-library/any-functions.md @@ -1,6 +1,6 @@ --- -description: "Learn more about the free functions for use with the std::any class in the C++ Standard Library." title: " functions" +description: "Learn more about the free functions for use with the std::any class in the C++ Standard Library." ms.date: 09/20/2021 f1_keywords: ["any/std::any_cast", "any/std::make_any", "any/std::swap"] no-loc: ["any", "std", "class"] From b35450bcac6bcde7af221d7acf54fc23868b370b Mon Sep 17 00:00:00 2001 From: Nathalie Laroche <635965+nathlaroche@users.noreply.github.com> Date: Wed, 18 Jun 2025 10:08:50 -0400 Subject: [PATCH 0099/1799] add Tyler's feedback --- docs/cpp/object-lifetime-and-resource-management-modern-cpp.md | 2 +- docs/cpp/portability-at-abi-boundaries-modern-cpp.md | 2 +- docs/cpp/smart-pointers-modern-cpp.md | 2 +- docs/cpp/type-conversions-and-type-safety-modern-cpp.md | 2 +- docs/cpp/welcome-back-to-cpp-modern-cpp.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md b/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md index e9a876b68d9..a4aa439b894 100644 --- a/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md +++ b/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md @@ -2,7 +2,7 @@ title: "Object lifetime and resource management (RAII)" description: "Follow the principle of RAII in modern C++ to avoid resource leaks." ms.date: 06/02/2022 -ms.topic: "how-to" +ms.topic: "concept-article" ms.assetid: 8aa0e1a1-e04d-46b1-acca-1d548490700f --- # Object lifetime and resource management (RAII) diff --git a/docs/cpp/portability-at-abi-boundaries-modern-cpp.md b/docs/cpp/portability-at-abi-boundaries-modern-cpp.md index 50e5a1243c2..09249b99cd1 100644 --- a/docs/cpp/portability-at-abi-boundaries-modern-cpp.md +++ b/docs/cpp/portability-at-abi-boundaries-modern-cpp.md @@ -2,7 +2,7 @@ title: "Portability at ABI boundaries" description: "Flatten C++ interfaces to C calling conventions at binary interface boundaries." ms.date: "11/19/2019" -ms.topic: "how-to" +ms.topic: "concept-article" ms.assetid: abbd405e-3038-427c-8c24-e00598f0936a --- # Portability at ABI boundaries diff --git a/docs/cpp/smart-pointers-modern-cpp.md b/docs/cpp/smart-pointers-modern-cpp.md index 8dbc6c3f00a..2551bba44a0 100644 --- a/docs/cpp/smart-pointers-modern-cpp.md +++ b/docs/cpp/smart-pointers-modern-cpp.md @@ -2,7 +2,7 @@ description: "Learn more about: Smart pointers (Modern C++)" title: "Smart pointers (Modern C++)" ms.date: "11/19/2019" -ms.topic: "how-to" +ms.topic: "concept-article" ms.assetid: 909ef870-904c-49b6-b8cd-e9d0b7dc9435 --- # Smart pointers (Modern C++) diff --git a/docs/cpp/type-conversions-and-type-safety-modern-cpp.md b/docs/cpp/type-conversions-and-type-safety-modern-cpp.md index b56978b7cd7..08ae5ed19c0 100644 --- a/docs/cpp/type-conversions-and-type-safety-modern-cpp.md +++ b/docs/cpp/type-conversions-and-type-safety-modern-cpp.md @@ -2,7 +2,7 @@ title: "Type conversions and type safety" description: "Learn more about: Type conversions and type safety" ms.date: "11/19/2019" -ms.topic: "how-to" +ms.topic: "concept-article" --- # Type conversions and type safety diff --git a/docs/cpp/welcome-back-to-cpp-modern-cpp.md b/docs/cpp/welcome-back-to-cpp-modern-cpp.md index 40942dc4b5c..dad330d014a 100644 --- a/docs/cpp/welcome-back-to-cpp-modern-cpp.md +++ b/docs/cpp/welcome-back-to-cpp-modern-cpp.md @@ -2,7 +2,7 @@ title: "Welcome back to C++ - Modern C++" description: "Describes the new programming idioms in Modern C++ and their rationale." ms.date: 06/02/2022 -ms.topic: "how-to" +ms.topic: "concept-article" --- # Welcome back to C++ - Modern C++ From 3101e63927ecffef14acb3ca1ca11c159184847b Mon Sep 17 00:00:00 2001 From: "Omotola Akeredolu (from Dev Box)" Date: Wed, 18 Jun 2025 19:39:19 -0700 Subject: [PATCH 0100/1799] Update the wording for clang-tidy max number of processes --- docs/code-quality/clang-tidy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/code-quality/clang-tidy.md b/docs/code-quality/clang-tidy.md index 474b8a52113..d9deb2c0c3e 100644 --- a/docs/code-quality/clang-tidy.md +++ b/docs/code-quality/clang-tidy.md @@ -104,7 +104,7 @@ The **Clang-Tidy Prepend Additional Options** property lets you specify compiler ## Max Number of Processes -The **Max Number of Processes** property lets you specify how many processes Clang-Tidy can use to run analysis in parallel. By default, Clang-Tidy uses a single processor. Set this property to a specific number to limit the number of parallel processes, or set it to `0` to use all available logical processors on your system. Increasing the number of processes can improve analysis speed on multi-core machines. +The **Max Number of Processes** property lets you specify how many processes Clang-Tidy can use to run analysis in parallel. By default, Clang-Tidy runs serially. Set this property to enable parallel execution and specify the number of parallel processes. Set it to `0` to use all available logical processors on your system. Increasing the number of processes can improve analysis speed on multi-core machines. ## See also From d1b3a199b98d5272e76436c59484fc1e6a91d02c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 18:27:24 +0800 Subject: [PATCH 0101/1799] Join code blocks that are split into lines --- docs/mfc/reference/crgn-class.md | 19 ++++++++----------- .../unordered-set-operators.md | 12 +++++------- 2 files changed, 13 insertions(+), 18 deletions(-) diff --git a/docs/mfc/reference/crgn-class.md b/docs/mfc/reference/crgn-class.md index d0cadf2e710..6568c4df1c5 100644 --- a/docs/mfc/reference/crgn-class.md +++ b/docs/mfc/reference/crgn-class.md @@ -609,17 +609,14 @@ int GetRgnBox(LPRECT lpRect) const; *lpRect*
Points to a `RECT` structure or `CRect` object to receive the coordinates of the bounding rectangle. The `RECT` structure has the following form: -`typedef struct tagRECT {` - -`int left;` - -`int top;` - -`int right;` - -`int bottom;` - -`} RECT;` +```cpp +typedef struct tagRECT { + int left; + int top; + int right; + int bottom; +} RECT; +``` ### Return Value diff --git a/docs/standard-library/unordered-set-operators.md b/docs/standard-library/unordered-set-operators.md index 1d57b37d00d..c6e2f414f8b 100644 --- a/docs/standard-library/unordered-set-operators.md +++ b/docs/standard-library/unordered-set-operators.md @@ -67,13 +67,11 @@ int main() } ``` -**Output:** - -`c1 != c2: true` - -`c1 != c3: false` - -`c2 != c3: true` +```Output +c1 != c2: true +c1 != c3: false +c2 != c3: true +``` ## operator== From cd2055ce7dd0802e2bc276eccd48e9a19a4b17de Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 18:32:48 +0800 Subject: [PATCH 0102/1799] Add backticks in `` operators reference --- .../unordered-set-operators.md | 48 +++++++++---------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/standard-library/unordered-set-operators.md b/docs/standard-library/unordered-set-operators.md index c6e2f414f8b..a8d9fd85cd5 100644 --- a/docs/standard-library/unordered-set-operators.md +++ b/docs/standard-library/unordered-set-operators.md @@ -7,9 +7,9 @@ ms.assetid: 8653eea6-12f2-4dd7-aa2f-db38a71599a0 --- # `` operators -## operator!= +## `operator!=` -Tests whether the [unordered_set](../standard-library/unordered-set-class.md) object on the left side of the operator is not equal to the unordered_set object on the right side. +Tests whether the [`unordered_set`](../standard-library/unordered-set-class.md) object on the left side of the operator is not equal to the `unordered_set` object on the right side. ```cpp bool operator!=(const unordered_set & left, const unordered_set & right); @@ -17,19 +17,19 @@ bool operator!=(const unordered_set & left, const un ### Parameters -*left*\ +*`left`*\ An object of type `unordered_set`. -*right*\ +*`right`*\ An object of type `unordered_set`. ### Return Value -**`true`** if the unordered_sets are not equal; **`false`** if they are equal. +**`true`** if the `unordered_set`s are not equal; **`false`** if they are equal. ### Remarks -The comparison between unordered_set objects is not affected by the arbitrary order in which they store their elements. Two unordered_sets are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. +The comparison between `unordered_set` objects is not affected by the arbitrary order in which they store their elements. Two `unordered_set`s are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. ### Example @@ -73,9 +73,9 @@ c1 != c3: false c2 != c3: true ``` -## operator== +## `operator==` -Tests whether the [unordered_set](../standard-library/unordered-set-class.md) object on the left side of the operator is equal to the unordered_set object on the right side. +Tests whether the [`unordered_set`](../standard-library/unordered-set-class.md) object on the left side of the operator is equal to the `unordered_set` object on the right side. ```cpp bool operator==(const unordered_set & left, const unordered_set & right); @@ -83,19 +83,19 @@ bool operator==(const unordered_set & left, const un ### Parameters -*left*\ +*`left`*\ An object of type `unordered_set`. -*right*\ +*`right`*\ An object of type `unordered_set`. ### Return Value -**`true`** if the unordered_sets are equal; **`false`** if they are not equal. +**`true`** if the `unordered_set`s are equal; **`false`** if they are not equal. ### Remarks -The comparison between unordered_set objects is not affected by the arbitrary order in which they store their elements. Two unordered_sets are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. +The comparison between `unordered_set` objects is not affected by the arbitrary order in which they store their elements. Two `unordered_set`s are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. ### Example @@ -139,9 +139,9 @@ c1 == c3: true c2 == c3: false ``` -## operator!= (multiset) +## `operator!=` (multiset) -Tests whether the [unordered_multiset](../standard-library/unordered-multiset-class.md) object on the left side of the operator is not equal to the unordered_multiset object on the right side. +Tests whether the [`unordered_multiset`](../standard-library/unordered-multiset-class.md) object on the left side of the operator is not equal to the `unordered_multiset` object on the right side. ```cpp bool operator!=(const unordered_multiset & left, const unordered_multiset & right); @@ -149,19 +149,19 @@ bool operator!=(const unordered_multiset & left, con ### Parameters -*left*\ +*`left`*\ An object of type `unordered_multiset`. -*right*\ +*`right`*\ An object of type `unordered_multiset`. ### Return Value -**`true`** if the unordered_multisets are not equal; **`false`** if they are equal. +**`true`** if the `unordered_multiset`s are not equal; **`false`** if they are equal. ### Remarks -The comparison between unordered_multiset objects is not affected by the arbitrary order in which they store their elements. Two unordered_multisets are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. +The comparison between `unordered_multiset` objects is not affected by the arbitrary order in which they store their elements. Two `unordered_multiset`s are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. ### Example @@ -208,9 +208,9 @@ c1 != c3: false c2 != c3: true ``` -## operator== (multiset) +## `operator==` (multiset) -Tests whether the [unordered_multiset](../standard-library/unordered-multiset-class.md) object on the left side of the operator is equal to the unordered_multiset object on the right side. +Tests whether the [`unordered_multiset`](../standard-library/unordered-multiset-class.md) object on the left side of the operator is equal to the `unordered_multiset` object on the right side. ```cpp bool operator==(const unordered_multiset & left, const unordered_multiset & right); @@ -218,19 +218,19 @@ bool operator==(const unordered_multiset & left, con ### Parameters -*left*\ +*`left`*\ An object of type `unordered_multiset`. -*right*\ +*`right`*\ An object of type `unordered_multiset`. ### Return Value -**`true`** if the unordered_multisets are equal; **`false`** if they are not equal. +**`true`** if the `unordered_multiset`s are equal; **`false`** if they are not equal. ### Remarks -The comparison between unordered_multiset objects is not affected by the arbitrary order in which they store their elements. Two unordered_multisets are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. +The comparison between `unordered_multiset` objects is not affected by the arbitrary order in which they store their elements. Two `unordered_multiset`s are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. ### Example From 86259f2931804b9db582b151475d6780a760d9bb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 18:35:26 +0800 Subject: [PATCH 0103/1799] Add leading sentence for `` operators reference --- docs/standard-library/unordered-set-operators.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/standard-library/unordered-set-operators.md b/docs/standard-library/unordered-set-operators.md index a8d9fd85cd5..d33d6bf103f 100644 --- a/docs/standard-library/unordered-set-operators.md +++ b/docs/standard-library/unordered-set-operators.md @@ -7,6 +7,8 @@ ms.assetid: 8653eea6-12f2-4dd7-aa2f-db38a71599a0 --- # `` operators +The `` header provides the following operators: + ## `operator!=` Tests whether the [`unordered_set`](../standard-library/unordered-set-class.md) object on the left side of the operator is not equal to the `unordered_set` object on the right side. From c4f32db81550fe3466d6951b891780a7b060e611 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 18:36:05 +0800 Subject: [PATCH 0104/1799] Update metadata in `` operators reference --- docs/standard-library/unordered-set-operators.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/unordered-set-operators.md b/docs/standard-library/unordered-set-operators.md index d33d6bf103f..6ebf61b57a3 100644 --- a/docs/standard-library/unordered-set-operators.md +++ b/docs/standard-library/unordered-set-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["unordered_set/std::operator!=", "unordered_set/std::operator=="] -ms.assetid: 8653eea6-12f2-4dd7-aa2f-db38a71599a0 --- # `` operators From d2e01813592100656fd20e0ab5463b8df3f6f71d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 18:59:08 +0800 Subject: [PATCH 0105/1799] Fix period character being wrongly added to prior backticked term --- docs/ide/visualize-macro-expansion.md | 2 +- docs/mfc/reference/cmdiframewndex-class.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ide/visualize-macro-expansion.md b/docs/ide/visualize-macro-expansion.md index 0a8071e0a94..fffabf0ef07 100644 --- a/docs/ide/visualize-macro-expansion.md +++ b/docs/ide/visualize-macro-expansion.md @@ -52,7 +52,7 @@ You can inspect a macro's expanded value, even when several preprocessor steps a :::image-end::: 1. Choose **Copy**. -1. Create a comment following the `POWER` line and choose paste (CTRL+V). The expansion of the macro, as a comment near your macro, looks like: `// (((10.0 * 20.0)* (5.0 * 2.0)) / 2.0).` The keyboard shortcut for this action is CTRL+M, CTRL+C. +1. Create a comment following the `POWER` line and choose paste (CTRL+V). The expansion of the macro, as a comment near your macro, looks like: `// (((10.0 * 20.0)* (5.0 * 2.0)) / 2.0)`. The keyboard shortcut for this action is CTRL+M, CTRL+C. ## Expand a macro inline diff --git a/docs/mfc/reference/cmdiframewndex-class.md b/docs/mfc/reference/cmdiframewndex-class.md index bae8259df3f..4cebc0fd4de 100644 --- a/docs/mfc/reference/cmdiframewndex-class.md +++ b/docs/mfc/reference/cmdiframewndex-class.md @@ -1045,7 +1045,7 @@ virtual BOOL LoadMDIState(LPCTSTR lpszProfileName); To load or save the state of MDI tabs and groups and the list of opened documents, do the following: - Call [`CMDIFrameWndEx::SaveMDIState`](#savemdistate) when the main frame is being closed -- Call [`CMDIFrameWndEx::LoadMDIState`](#loadmdistate) when the main frame is being created. The recommended place for this call is before the main frame is displayed for the first time. Add `CWinAppEx::EnableLoadWindowPlacement` `(FALSE);` before `pMainFrame->LoadFrame (IDR_MAINFRAME);.` Add `CWinAppEx::ReloadWindowPlacement` `(pMainFrame);` after the call to `LoadMDIState` to display the main frame at the position that was stored in the registry. +- Call [`CMDIFrameWndEx::LoadMDIState`](#loadmdistate) when the main frame is being created. The recommended place for this call is before the main frame is displayed for the first time. Add `CWinAppEx::EnableLoadWindowPlacement` `(FALSE);` before `pMainFrame->LoadFrame (IDR_MAINFRAME);`. Add `CWinAppEx::ReloadWindowPlacement` `(pMainFrame);` after the call to `LoadMDIState` to display the main frame at the position that was stored in the registry. - Override `GetDocumentName` in the `CMDIChildWndEx`- derived class if your application displays documents that aren't stored as files. The returned string will be saved in the registry as the document identifier. The base implementation of [`CMDIChildWndEx::GetDocumentName`](../../mfc/reference/cmdichildwndex-class.md#getdocumentname) returns a value obtained from [`CDocument::GetPathName`](../../mfc/reference/cdocument-class.md#getpathname). - Override [`CMDIFrameWndEx::CreateDocumentWindow`](#createdocumentwindow) to correctly create documents when they're being loaded from the registry. The first parameter is the string that `GetDocumentName` returned. From 1eb448402bf11b2bf59b5736d13782d75820b875 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 21:46:34 +0800 Subject: [PATCH 0106/1799] Clean up superfluous relative links in `` operators reference --- docs/standard-library/unordered-set-operators.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/unordered-set-operators.md b/docs/standard-library/unordered-set-operators.md index 6ebf61b57a3..ee5bc48f7d7 100644 --- a/docs/standard-library/unordered-set-operators.md +++ b/docs/standard-library/unordered-set-operators.md @@ -10,7 +10,7 @@ The `` header provides the following operators: ## `operator!=` -Tests whether the [`unordered_set`](../standard-library/unordered-set-class.md) object on the left side of the operator is not equal to the `unordered_set` object on the right side. +Tests whether the [`unordered_set`](unordered-set-class.md) object on the left side of the operator is not equal to the `unordered_set` object on the right side. ```cpp bool operator!=(const unordered_set & left, const unordered_set & right); @@ -76,7 +76,7 @@ c2 != c3: true ## `operator==` -Tests whether the [`unordered_set`](../standard-library/unordered-set-class.md) object on the left side of the operator is equal to the `unordered_set` object on the right side. +Tests whether the [`unordered_set`](unordered-set-class.md) object on the left side of the operator is equal to the `unordered_set` object on the right side. ```cpp bool operator==(const unordered_set & left, const unordered_set & right); @@ -142,7 +142,7 @@ c2 == c3: false ## `operator!=` (multiset) -Tests whether the [`unordered_multiset`](../standard-library/unordered-multiset-class.md) object on the left side of the operator is not equal to the `unordered_multiset` object on the right side. +Tests whether the [`unordered_multiset`](unordered-multiset-class.md) object on the left side of the operator is not equal to the `unordered_multiset` object on the right side. ```cpp bool operator!=(const unordered_multiset & left, const unordered_multiset & right); @@ -211,7 +211,7 @@ c2 != c3: true ## `operator==` (multiset) -Tests whether the [`unordered_multiset`](../standard-library/unordered-multiset-class.md) object on the left side of the operator is equal to the `unordered_multiset` object on the right side. +Tests whether the [`unordered_multiset`](unordered-multiset-class.md) object on the left side of the operator is equal to the `unordered_multiset` object on the right side. ```cpp bool operator==(const unordered_multiset & left, const unordered_multiset & right); From 037dd50277453eaf3338ad31b2f1fc7a014e696e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 22:30:57 +0800 Subject: [PATCH 0107/1799] Add backticks in `_SCL_SECURE_NO_WARNINGS` topic --- docs/standard-library/scl-secure-no-warnings.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/standard-library/scl-secure-no-warnings.md b/docs/standard-library/scl-secure-no-warnings.md index fd9ef309d15..3c44da50ca3 100644 --- a/docs/standard-library/scl-secure-no-warnings.md +++ b/docs/standard-library/scl-secure-no-warnings.md @@ -6,9 +6,9 @@ f1_keywords: ["_SCL_SECURE_NO_DEPRECATE", "_SCL_SECURE_NO_WARNINGS"] helpviewer_keywords: ["_SCL_SECURE_NO_DEPRECATE", "_SCL_SECURE_NO_WARNINGS"] ms.assetid: ef0ddea9-7c62-4b53-8b64-5f4fd369776f --- -# _SCL_SECURE_NO_WARNINGS +# `_SCL_SECURE_NO_WARNINGS` -Calling any of the potentially unsafe methods in the C++ Standard Library results in [Compiler Warning (level 3) C4996](../error-messages/compiler-warnings/compiler-warning-level-3-c4996.md). To disable this warning, define the macro _SCL_SECURE_NO_WARNINGS in your code: +Calling any of the potentially unsafe methods in the C++ Standard Library results in [Compiler Warning (level 3) C4996](../error-messages/compiler-warnings/compiler-warning-level-3-c4996.md). To disable this warning, define the macro `_SCL_SECURE_NO_WARNINGS` in your code: ```cpp #define _SCL_SECURE_NO_WARNINGS @@ -20,25 +20,25 @@ If you use precompiled headers, put this directive in your precompiled header fi Other ways to disable warning C4996 include: -- Using the [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md) compiler option: +- Using the [`/D` (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md) compiler option: > cl /D_SCL_SECURE_NO_WARNINGS [other compiler options] myfile.cpp -- Using the [/w](../build/reference/compiler-option-warning-level.md) compiler option: +- Using the [`/w`](../build/reference/compiler-option-warning-level.md) compiler option: > cl /wd4996 [other compiler options] myfile.cpp -- Using the [#pragma warning](../preprocessor/warning.md) directive: +- Using the [`#pragma warning`](../preprocessor/warning.md) directive: ```cpp #pragma warning(disable:4996) ``` -Also, you can manually change the level of warning C4996 with the **/w\\** compiler option. For example, to set warning C4996 to level 4: +Also, you can manually change the level of warning C4996 with the `/w` compiler option. For example, to set warning C4996 to level 4: > cl /w44996 [other compiler options] myfile.cpp -For more information, see [/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, see [`/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). ## See also From 12eb4b8e43e1c20b1fa6dcc60268d54db328b84c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 22:34:37 +0800 Subject: [PATCH 0108/1799] Replace CL invocation blockquotes with code blocks in `_SCL_SECURE_NO_WARNINGS` topic --- docs/standard-library/scl-secure-no-warnings.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/scl-secure-no-warnings.md b/docs/standard-library/scl-secure-no-warnings.md index 3c44da50ca3..c8fd257b5d0 100644 --- a/docs/standard-library/scl-secure-no-warnings.md +++ b/docs/standard-library/scl-secure-no-warnings.md @@ -22,11 +22,15 @@ Other ways to disable warning C4996 include: - Using the [`/D` (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md) compiler option: - > cl /D_SCL_SECURE_NO_WARNINGS [other compiler options] myfile.cpp + ```cmd + cl /D_SCL_SECURE_NO_WARNINGS [other compiler options] myfile.cpp + ``` - Using the [`/w`](../build/reference/compiler-option-warning-level.md) compiler option: - > cl /wd4996 [other compiler options] myfile.cpp + ```cmd + cl /wd4996 [other compiler options] myfile.cpp + ``` - Using the [`#pragma warning`](../preprocessor/warning.md) directive: @@ -36,7 +40,9 @@ Other ways to disable warning C4996 include: Also, you can manually change the level of warning C4996 with the `/w` compiler option. For example, to set warning C4996 to level 4: -> cl /w44996 [other compiler options] myfile.cpp +```cmd +cl /w44996 [other compiler options] myfile.cpp +``` For more information, see [`/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). From 3b7b7decd94196b2d41455add40e3e59eb977fd3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 22:35:46 +0800 Subject: [PATCH 0109/1799] Fix a single redundant relative link in `_SCL_SECURE_NO_WARNINGS` topic --- docs/standard-library/scl-secure-no-warnings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/scl-secure-no-warnings.md b/docs/standard-library/scl-secure-no-warnings.md index c8fd257b5d0..ac9d4431a6d 100644 --- a/docs/standard-library/scl-secure-no-warnings.md +++ b/docs/standard-library/scl-secure-no-warnings.md @@ -48,4 +48,4 @@ For more information, see [`/w`, `/W0`, `/W1`, `/W2`, `/W3`, `/W4`, `/w1`, `/w2` ## See also -[Safe Libraries: C++ Standard Library](../standard-library/safe-libraries-cpp-standard-library.md) +[Safe Libraries: C++ Standard Library](safe-libraries-cpp-standard-library.md) From d310d0875e8a053ba01c53092043ff53526ee4c1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 19 Jun 2025 22:36:18 +0800 Subject: [PATCH 0110/1799] Update metadata for `_SCL_SECURE_NO_WARNINGS` topic --- docs/standard-library/scl-secure-no-warnings.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/scl-secure-no-warnings.md b/docs/standard-library/scl-secure-no-warnings.md index ac9d4431a6d..10be87757e9 100644 --- a/docs/standard-library/scl-secure-no-warnings.md +++ b/docs/standard-library/scl-secure-no-warnings.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: _SCL_SECURE_NO_WARNINGS" title: "_SCL_SECURE_NO_WARNINGS" -ms.date: "11/04/2016" +description: "Learn more about: _SCL_SECURE_NO_WARNINGS" +ms.date: 11/04/2016 f1_keywords: ["_SCL_SECURE_NO_DEPRECATE", "_SCL_SECURE_NO_WARNINGS"] helpviewer_keywords: ["_SCL_SECURE_NO_DEPRECATE", "_SCL_SECURE_NO_WARNINGS"] -ms.assetid: ef0ddea9-7c62-4b53-8b64-5f4fd369776f --- # `_SCL_SECURE_NO_WARNINGS` From 747f3a857a7a4ccf5eb2fec667918dba150849d1 Mon Sep 17 00:00:00 2001 From: Saisang Cai Date: Fri, 20 Jun 2025 00:06:34 +0800 Subject: [PATCH 0111/1799] Bulk update ms.topic, folder: assembler,atl,build,build-insights,cross-platform,data,dotnet,embedded,ide --- docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md | 1 + docs/assembler/inline/asm.md | 1 + .../assembler/inline/calling-c-functions-in-inline-assembly.md | 1 + .../inline/calling-cpp-functions-in-inline-assembly.md | 1 + .../inline/debugging-and-listings-for-inline-assembly.md | 1 + docs/assembler/inline/defining-asm-blocks-as-c-macros.md | 1 + docs/assembler/inline/emit-pseudoinstruction.md | 1 + docs/assembler/inline/inline-assembler-overview.md | 1 + docs/assembler/inline/jumping-to-labels-in-inline-assembly.md | 1 + docs/assembler/inline/optimizing-inline-assembly.md | 1 + .../using-and-preserving-registers-in-inline-assembly.md | 1 + docs/assembler/inline/using-assembly-language-in-asm-blocks.md | 1 + docs/assembler/inline/using-c-or-cpp-in-asm-blocks.md | 1 + docs/assembler/inline/using-c-or-cpp-symbols-in-asm-blocks.md | 1 + docs/assembler/inline/using-operators-in-asm-blocks.md | 1 + .../assembler/inline/writing-functions-with-inline-assembly.md | 1 + docs/atl/active-template-library-atl-concepts.md | 1 + docs/atl/active-template-library-atl-tutorial.md | 1 + docs/atl/adding-a-control-atl-tutorial-part-2.md | 1 + docs/atl/adding-a-property-page-atl-tutorial-part-6.md | 1 + .../adding-a-property-to-the-control-atl-tutorial-part-3.md | 1 + docs/atl/adding-an-atl-message-handler.md | 1 + docs/atl/adding-an-event-atl-tutorial-part-5.md | 1 + docs/atl/adding-connection-points-to-an-object.md | 1 + docs/atl/adding-functionality-to-the-composite-control.md | 1 + docs/atl/atl-class-overview.md | 1 + docs/atl/atl-collection-classes.md | 1 + docs/atl/building-and-testing-the-atl-project.md | 1 + docs/atl/calling-cpp-code-from-dhtml.md | 1 + ...changing-the-default-class-factory-and-aggregation-model.md | 1 + docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md | 1 + docs/atl/creating-an-aggregated-object.md | 1 + docs/atl/creating-an-atl-dhtml-control.md | 1 + docs/atl/creating-registrar-scripts.md | 1 + docs/atl/creating-the-project-atl-tutorial-part-1.md | 1 + docs/atl/debugging-tips.md | 1 + ...sign-principles-for-collection-and-enumerator-interfaces.md | 1 + docs/atl/displaying-assertions.md | 1 + docs/atl/example-implementing-a-property-page.md | 1 + .../identifying-the-elements-of-the-dhtml-control-project.md | 1 + docs/atl/implementing-a-dialog-box.md | 1 + docs/atl/implementing-a-dual-interface.md | 1 + docs/atl/implementing-a-window-with-cwindowimpl.md | 1 + docs/atl/implementing-a-window.md | 1 + docs/atl/implementing-an-stl-based-collection.md | 1 + ...implementing-ccomobject-ccomaggobject-and-ccompolyobject.md | 1 + docs/atl/implementing-ccomobjectrootex.md | 1 + docs/atl/implementing-property-pages.md | 1 + docs/atl/implementing-the-event-handling-interface.md | 1 + docs/atl/inserting-a-composite-control.md | 1 + docs/atl/introduction-to-atl-window-classes.md | 1 + docs/atl/introduction-to-atl.md | 1 + docs/atl/introduction-to-com-and-atl.md | 1 + docs/atl/introduction-to-com.md | 1 + docs/atl/invoking-scripts.md | 1 + docs/atl/linking-to-the-crt-in-your-atl-project.md | 1 + docs/atl/marshaling.md | 1 + docs/atl/modifying-the-atl-dhtml-control.md | 1 + docs/atl/modifying-the-atl-project.md | 1 + docs/atl/programming-with-atl-and-c-run-time-code.md | 1 + docs/atl/programming-with-ccombstr-atl.md | 1 + .../putting-the-control-on-a-web-page-atl-tutorial-part-7.md | 1 + docs/atl/running-the-program-as-a-local-server.md | 1 + .../setting-up-a-static-link-to-the-registrar-code-cpp-only.md | 1 + docs/atl/specifying-property-pages.md | 1 + docs/atl/specifying-the-threading-model-for-a-project-atl.md | 1 + docs/atl/supporting-idispatch-and-ierrorinfo.md | 1 + docs/atl/supporting-idispeventimpl.md | 1 + docs/atl/testing-the-atl-dhtml-control.md | 1 + docs/atl/testing-the-modified-atl-dhtml-control.md | 1 + docs/atl/threading-models-and-critical-sections-classes.md | 1 + docs/atl/understanding-backus-naur-form-bnf-syntax.md | 1 + docs/atl/understanding-parse-trees.md | 1 + docs/atl/understanding-window-traits.md | 1 + docs/atl/using-a-template-library.md | 1 + docs/atl/using-a-window.md | 1 + docs/atl/using-contained-windows.md | 1 + docs/atl/using-idispeventimpl.md | 1 + docs/atl/using-idispeventsimpleimpl.md | 1 + ...sing-replaceable-parameters-the-registrar-s-preprocessor.md | 1 + docs/atl/using-task-manager.md | 1 + docs/build-insights/get-started-with-cpp-build-insights.md | 1 + .../reference/sdk/cpp-event-data-types/thread.md | 1 + .../reference/sdk/other-types/analysis-callbacks-struct.md | 1 + .../reference/sdk/other-types/analysis-descriptor-struct.md | 1 + .../reference/sdk/other-types/callback-code-enum.md | 1 + .../reference/sdk/other-types/relog-callbacks-struct.md | 1 + .../reference/sdk/other-types/relog-descriptor-struct.md | 1 + .../relog-retention-system-event-flags-constants.md | 1 + .../reference/sdk/other-types/result-code-enum.md | 1 + .../other-types/tracing-session-msvc-event-flags-constants.md | 1 + .../sdk/other-types/tracing-session-options-struct.md | 1 + .../sdk/other-types/tracing-session-statistics-struct.md | 1 + .../tracing-session-system-event-flags-constants.md | 1 + docs/build-insights/tutorials/build-insights-function-view.md | 1 + .../tutorials/build-insights-included-files-view.md | 3 ++- docs/build-insights/tutorials/vcperf-and-wpa.md | 1 + docs/build-insights/tutorials/wpa-basics.md | 1 + docs/build/adding-references-in-visual-cpp-projects.md | 1 + docs/build/arm-exception-handling.md | 1 + ...-c-cpp-isolated-applications-and-side-by-side-assemblies.md | 1 + docs/build/building-c-cpp-isolated-applications.md | 1 + docs/build/building-c-cpp-side-by-side-assemblies.md | 1 + docs/build/building-on-the-command-line.md | 1 + .../calling-dll-functions-from-visual-basic-applications.md | 1 + docs/build/checking-for-memory-overwrites.md | 1 + ...pts-of-isolated-applications-and-side-by-side-assemblies.md | 1 + docs/build/configure-cmake-debugging-sessions.md | 1 + docs/build/configuring-programs-for-windows-xp.md | 1 + docs/build/create-reusable-property-configurations.md | 1 + docs/build/creating-a-resource-only-dll.md | 1 + docs/build/customize-cmake-settings.md | 1 + docs/build/exporting-and-importing-using-afx-ext-class.md | 1 + ...ing-c-functions-for-use-in-c-or-cpp-language-executables.md | 1 + ...xporting-cpp-functions-for-use-in-c-language-executables.md | 1 + docs/build/exporting-from-a-dll-using-declspec-dllexport.md | 1 + docs/build/exporting-from-a-dll-using-def-files.md | 1 + docs/build/exporting-from-a-dll.md | 1 + ...ting-functions-from-a-dll-by-ordinal-rather-than-by-name.md | 1 + docs/build/extension-dlls-overview.md | 1 + docs/build/fixing-release-build-problems.md | 1 + ...matting-the-output-of-a-custom-build-step-or-build-event.md | 1 + docs/build/importing-and-exporting-inline-functions.md | 1 + docs/build/importing-and-exporting.md | 1 + docs/build/importing-data-using-declspec-dllimport.md | 1 + .../build/importing-function-calls-using-declspec-dllimport.md | 1 + .../importing-into-an-application-using-declspec-dllimport.md | 1 + docs/build/importing-into-an-application.md | 1 + docs/build/importing-using-def-files.md | 1 + docs/build/improving-compiler-throughput.md | 1 + .../modify-project-properties-without-changing-project-file.md | 1 + docs/build/non-mfc-dlls-overview.md | 1 + docs/build/open-folder-projects-cpp.md | 1 + docs/build/optimization-best-practices.md | 1 + docs/build/optimizing-your-code.md | 1 + docs/build/specifying-build-events.md | 1 + docs/build/specifying-custom-build-tools.md | 1 + docs/build/troubleshooting-build-customizations.md | 1 + ...-c-cpp-isolated-applications-and-side-by-side-assemblies.md | 1 + .../build/understanding-custom-build-steps-and-build-events.md | 1 + .../understanding-manifest-generation-for-c-cpp-programs.md | 1 + ...-database-ole-and-sockets-extension-dlls-in-regular-dlls.md | 1 + .../using-function-name-without-parens-produces-no-code.md | 1 + .../using-the-debug-build-to-check-for-memory-overwrite.md | 1 + docs/build/using-verify-instead-of-assert.md | 1 + .../walkthrough-compile-a-c-program-on-the-command-line.md | 1 + docs/build/x64-software-conventions.md | 1 + .../build-an-opengl-es-application-on-android-and-ios.md | 1 + docs/cross-platform/create-an-android-native-activity-app.md | 1 + docs/cross-platform/import-an-xcode-project.md | 1 + .../install-and-configure-tools-to-build-using-ios.md | 1 + ...install-visual-cpp-for-cross-platform-mobile-development.md | 1 + .../designing-and-creating-a-record-view-mfc-data-access.md | 1 + ...lling-a-list-box-from-a-second-recordset-mfc-data-access.md | 1 + docs/data/installing-database-support-mfc-atl.md | 1 + docs/data/odbc/connecting-to-a-data-source.md | 1 + docs/data/odbc/displaying-and-manipulating-data-in-a-form.md | 1 + docs/data/odbc/installing-and-getting-started-with-odbc.md | 1 + docs/data/odbc/record-field-exchange-how-rfx-works.md | 1 + .../odbc/record-field-exchange-working-with-the-wizard-code.md | 1 + .../odbc/redistributing-odbc-components-to-your-customers.md | 1 + docs/data/odbc/selecting-and-manipulating-records.md | 1 + docs/data/odbc/working-with-documents-and-views.md | 1 + .../supporting-navigation-in-a-record-view-mfc-data-access.md | 1 + docs/data/using-a-record-view-mfc-data-access.md | 1 + ...n-clr-shutdown-when-consuming-com-objects-built-with-clr.md | 1 + docs/dotnet/boxing-cpp-cli.md | 1 + docs/dotnet/calling-native-functions-from-managed-code.md | 1 + ...g-projects-from-mixed-mode-to-pure-intermediate-language.md | 1 + docs/dotnet/create-a-partially-trusted-application.md | 1 + docs/dotnet/debug-class-cpp-cli.md | 1 + docs/dotnet/double-thunking-cpp.md | 1 + docs/dotnet/file-handling-and-i-o-cpp-cli.md | 1 + ...hosting-a-windows-form-user-control-as-an-mfc-dialog-box.md | 1 + ...hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md | 1 + .../hosting-a-windows-forms-user-control-as-an-mfc-view.md | 1 + .../how-to-define-and-install-a-global-exception-handler.md | 1 + docs/dotnet/how-to-migrate-to-clr.md | 1 + docs/dotnet/using-a-windows-form-user-control-in-mfc.md | 1 + docs/dotnet/using-cpp-interop-implicit-pinvoke.md | 1 + .../using-explicit-pinvoke-in-cpp-dllimport-attribute.md | 1 + .../using-verifiable-assemblies-with-sql-server-cpp-cli.md | 1 + ...ling-a-cpp-program-that-targets-the-clr-in-visual-studio.md | 1 + docs/embedded/download-and-install-the-embedded-tooling.md | 1 + docs/ide/add-interface-definition-library-method-wizard.md | 1 + docs/ide/add-interface-definition-library-property-wizard.md | 1 + docs/ide/adding-a-class-from-an-activex-control-visual-cpp.md | 1 + docs/ide/adding-a-generic-cpp-class.md | 1 + docs/ide/adding-a-member-function-visual-cpp.md | 1 + docs/ide/adding-a-member-variable-visual-cpp.md | 1 + docs/ide/adding-a-method-visual-cpp.md | 3 ++- docs/ide/adding-a-property-visual-cpp.md | 3 ++- docs/ide/adding-an-event-handler-visual-cpp.md | 1 + docs/ide/adding-an-event-visual-cpp.md | 1 + docs/ide/adding-functionality-with-code-wizards-cpp.md | 1 + docs/ide/implementing-a-connection-point-visual-cpp.md | 1 + docs/ide/implementing-an-interface-visual-cpp.md | 1 + docs/ide/overriding-a-virtual-function-visual-cpp.md | 1 + docs/ide/read-and-understand-code-cpp.md | 1 + .../using-the-visual-studio-ide-for-cpp-desktop-development.md | 1 + 200 files changed, 203 insertions(+), 3 deletions(-) diff --git a/docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md b/docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md index c2018570a2a..8dab8e0883c 100644 --- a/docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md +++ b/docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Accessing C or C++ Data in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["data members [C++], in __asm blocks", "data access [C++], in __asm blocks", "__asm keyword [C++], data members", "structure types in __asm blocks"] ms.assetid: e99f5a28-0381-4090-8ece-6af8f2436a49 +ms.topic: concept-article --- # Accessing C or C++ Data in __asm Blocks diff --git a/docs/assembler/inline/asm.md b/docs/assembler/inline/asm.md index 0aa4253ef7e..0ad5df365a0 100644 --- a/docs/assembler/inline/asm.md +++ b/docs/assembler/inline/asm.md @@ -5,6 +5,7 @@ ms.date: "10/09/2018" f1_keywords: ["__asm", "_asm", "__asm_cpp"] helpviewer_keywords: ["__asm keyword [C++], vs. asm blocks", "__asm keyword [C++]"] ms.assetid: 77ff3bc9-a492-4b5e-85e1-fa4e414e79cd +ms.topic: reference --- # `__asm` diff --git a/docs/assembler/inline/calling-c-functions-in-inline-assembly.md b/docs/assembler/inline/calling-c-functions-in-inline-assembly.md index 151a29d5a53..74bf5c40de2 100644 --- a/docs/assembler/inline/calling-c-functions-in-inline-assembly.md +++ b/docs/assembler/inline/calling-c-functions-in-inline-assembly.md @@ -4,6 +4,7 @@ title: "Calling C Functions in Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["function calls, C functions", "function calls, in inline assembly", "functions [C], calling in inline assembly", "Visual C, functions", "inline assembly, calling functions", "__asm keyword [C++], calling functions"] ms.assetid: f8a8d568-d175-4e23-9b24-36ef60a4cab3 +ms.topic: concept-article --- # Calling C Functions in Inline Assembly diff --git a/docs/assembler/inline/calling-cpp-functions-in-inline-assembly.md b/docs/assembler/inline/calling-cpp-functions-in-inline-assembly.md index 4189da24ae8..11c2763e438 100644 --- a/docs/assembler/inline/calling-cpp-functions-in-inline-assembly.md +++ b/docs/assembler/inline/calling-cpp-functions-in-inline-assembly.md @@ -4,6 +4,7 @@ title: "Calling C++ Functions in Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["functions [C++], calling in inline assembly", "function calls, C++ functions", "function calls, in inline assembly", "Visual C++, functions", "inline assembly, calling functions", "__asm keyword [C++], calling functions"] ms.assetid: 1f0d1eb3-54cf-45d5-838d-958188616b38 +ms.topic: concept-article --- # Calling C++ Functions in Inline Assembly diff --git a/docs/assembler/inline/debugging-and-listings-for-inline-assembly.md b/docs/assembler/inline/debugging-and-listings-for-inline-assembly.md index 5ad6409390b..dbe6f30b37a 100644 --- a/docs/assembler/inline/debugging-and-listings-for-inline-assembly.md +++ b/docs/assembler/inline/debugging-and-listings-for-inline-assembly.md @@ -4,6 +4,7 @@ title: "Debugging and Listings for Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["source level debugger", "__asm keyword [C++], debugging", "inline assembly, listings", "bugs, __asm blocks", "debugging [C++], inline assembly code", "inline assembly, debugging"] ms.assetid: 69266930-6f9a-433d-b704-f4f44e7b2583 +ms.topic: concept-article --- # Debugging and Listings for Inline Assembly diff --git a/docs/assembler/inline/defining-asm-blocks-as-c-macros.md b/docs/assembler/inline/defining-asm-blocks-as-c-macros.md index 2e5305a93ce..ebea4aa8da3 100644 --- a/docs/assembler/inline/defining-asm-blocks-as-c-macros.md +++ b/docs/assembler/inline/defining-asm-blocks-as-c-macros.md @@ -3,6 +3,7 @@ title: "Defining __asm Blocks as C Macros" description: "Learn more about: Defining __asm Blocks as C Macros" ms.date: 08/30/2018 helpviewer_keywords: ["macros, __asm blocks", "Visual C, macros", "__asm keyword [C++], as C macros"] +ms.topic: concept-article --- # Defining __asm Blocks as C Macros diff --git a/docs/assembler/inline/emit-pseudoinstruction.md b/docs/assembler/inline/emit-pseudoinstruction.md index 201c775fd0e..b736701ca0b 100644 --- a/docs/assembler/inline/emit-pseudoinstruction.md +++ b/docs/assembler/inline/emit-pseudoinstruction.md @@ -5,6 +5,7 @@ ms.date: "08/30/2018" f1_keywords: ["_emit"] helpviewer_keywords: ["byte defining (inline assembly)", "_emit pseudoinstruction"] ms.assetid: 004c48f3-364c-4e82-9a51-e326f9cc7b2b +ms.topic: reference --- # _emit Pseudoinstruction diff --git a/docs/assembler/inline/inline-assembler-overview.md b/docs/assembler/inline/inline-assembler-overview.md index 25141761486..3b97cd70431 100644 --- a/docs/assembler/inline/inline-assembler-overview.md +++ b/docs/assembler/inline/inline-assembler-overview.md @@ -4,6 +4,7 @@ title: "Inline Assembler Overview" ms.date: "08/30/2018" helpviewer_keywords: ["inline assembler", "__asm keyword [C++], invoking inline assembler", "invoking inline assembler", "inline assembly, inline assembler"] ms.assetid: d990331a-0e33-4760-8d7a-b720b0288335 +ms.topic: concept-article --- # Inline Assembler Overview diff --git a/docs/assembler/inline/jumping-to-labels-in-inline-assembly.md b/docs/assembler/inline/jumping-to-labels-in-inline-assembly.md index 0146414b364..69529719664 100644 --- a/docs/assembler/inline/jumping-to-labels-in-inline-assembly.md +++ b/docs/assembler/inline/jumping-to-labels-in-inline-assembly.md @@ -4,6 +4,7 @@ title: "Jumping to Labels in Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["inline assembly, jumping to labels", "labels, in inline assembly", "__asm keyword [C++], labels", "case sensitivity, labels in inline assembly", "labels, in __asm blocks", "jumping to labels in inline assembly"] ms.assetid: 36c18b97-8981-4631-9dfd-af6c14a04297 +ms.topic: concept-article --- # Jumping to Labels in Inline Assembly diff --git a/docs/assembler/inline/optimizing-inline-assembly.md b/docs/assembler/inline/optimizing-inline-assembly.md index 726c242a525..7330cf7156e 100644 --- a/docs/assembler/inline/optimizing-inline-assembly.md +++ b/docs/assembler/inline/optimizing-inline-assembly.md @@ -4,6 +4,7 @@ title: "Optimizing Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["storage, optimizing in inline assembly", "optimization, inline assembly", "inline assembly, optimizing", "optimizing performance, inline assembly", "__asm keyword [C++], optimizing"] ms.assetid: 52a7ec83-9782-4d96-94c1-53bb2ac9e8c8 +ms.topic: concept-article --- # Optimizing Inline Assembly diff --git a/docs/assembler/inline/using-and-preserving-registers-in-inline-assembly.md b/docs/assembler/inline/using-and-preserving-registers-in-inline-assembly.md index 30dae26e22c..b488b9fc601 100644 --- a/docs/assembler/inline/using-and-preserving-registers-in-inline-assembly.md +++ b/docs/assembler/inline/using-and-preserving-registers-in-inline-assembly.md @@ -4,6 +4,7 @@ title: "Using and Preserving Registers in Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["__asm keyword [C++], register values", "inline assembly, registers", "registers, inline assembly", "preserving registers"] ms.assetid: dbcd7360-6f3e-4b22-9ee2-9f65ca6f2543 +ms.topic: concept-article --- # Using and Preserving Registers in Inline Assembly diff --git a/docs/assembler/inline/using-assembly-language-in-asm-blocks.md b/docs/assembler/inline/using-assembly-language-in-asm-blocks.md index 2e80f379517..c2a33f53b50 100644 --- a/docs/assembler/inline/using-assembly-language-in-asm-blocks.md +++ b/docs/assembler/inline/using-assembly-language-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Using Assembly Language in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["assembly language [C++], features", "assembly language [C++]", "__asm keyword [C++], assembly language in"] ms.assetid: ad699356-1d16-4984-871f-c5fd7797c1fb +ms.topic: concept-article --- # Using Assembly Language in __asm Blocks diff --git a/docs/assembler/inline/using-c-or-cpp-in-asm-blocks.md b/docs/assembler/inline/using-c-or-cpp-in-asm-blocks.md index 60fbff35486..0a56b28c8fc 100644 --- a/docs/assembler/inline/using-c-or-cpp-in-asm-blocks.md +++ b/docs/assembler/inline/using-c-or-cpp-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Using C or C++ in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["inline assembly, mixing instructions with C/C++ statements", "symbols, in __asm blocks", "macros, __asm blocks", "preprocessor directives, used in __asm blocks", "type names, used in __asm blocks", "preprocessor directives", "preprocessor, directives", "constants, in __asm blocks", "comments, in __asm blocks", "typedef names, used in __asm blocks", "__asm keyword [C++], C/C++ elements in"] ms.assetid: ae8b2b52-6b75-42e3-ac0c-ad02d922ed97 +ms.topic: concept-article --- # Using C or C++ in __asm Blocks diff --git a/docs/assembler/inline/using-c-or-cpp-symbols-in-asm-blocks.md b/docs/assembler/inline/using-c-or-cpp-symbols-in-asm-blocks.md index 7b4602352c2..8dc38e5868e 100644 --- a/docs/assembler/inline/using-c-or-cpp-symbols-in-asm-blocks.md +++ b/docs/assembler/inline/using-c-or-cpp-symbols-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Using C or C++ Symbols in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["__asm keyword [C++], syntax", "symbols, in __asm blocks", "Visual C, symbols in __asm blocks", "__asm keyword [C++], C/C++ elements in", "Visual C++, in __asm blocks"] ms.assetid: 0758ffdc-dfe9-41c8-a5e1-fd395bcac328 +ms.topic: concept-article --- # Using C or C++ Symbols in __asm Blocks diff --git a/docs/assembler/inline/using-operators-in-asm-blocks.md b/docs/assembler/inline/using-operators-in-asm-blocks.md index dbda9a8fd39..b629032f997 100644 --- a/docs/assembler/inline/using-operators-in-asm-blocks.md +++ b/docs/assembler/inline/using-operators-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Using Operators in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["brackets [ ]", "brackets [ ], __asm blocks", "__asm keyword [C++], operators", "square brackets [ ], __asm blocks", "operators [C++], using in __asm blocks", "square brackets [ ]"] ms.assetid: a26ccfd4-40ae-4a61-952f-c417982aa8dd +ms.topic: concept-article --- # Using Operators in __asm Blocks diff --git a/docs/assembler/inline/writing-functions-with-inline-assembly.md b/docs/assembler/inline/writing-functions-with-inline-assembly.md index 65e852819fc..d1082cff37d 100644 --- a/docs/assembler/inline/writing-functions-with-inline-assembly.md +++ b/docs/assembler/inline/writing-functions-with-inline-assembly.md @@ -4,6 +4,7 @@ title: "Writing functions with inline assembly" ms.date: 02/11/2022 helpviewer_keywords: ["functions [C++], inline assembly", "inline assembly [C++], writing functions", "assembler [C++], writing functions", "__asm keyword [C++], in functions"] ms.assetid: b5df8a04-fdc7-4622-8c9e-e4b618927497 +ms.topic: concept-article --- # Writing functions with inline assembly diff --git a/docs/atl/active-template-library-atl-concepts.md b/docs/atl/active-template-library-atl-concepts.md index bf9f677b9a1..cda405159a6 100644 --- a/docs/atl/active-template-library-atl-concepts.md +++ b/docs/atl/active-template-library-atl-concepts.md @@ -4,6 +4,7 @@ title: "Active Template Library (ATL) Concepts" ms.date: "05/06/2019" helpviewer_keywords: ["ATL, about ATL"] ms.assetid: a3960991-4d76-4da5-9568-3fa7fde53ff4 +ms.topic: concept-article --- # Active Template Library (ATL) Concepts diff --git a/docs/atl/active-template-library-atl-tutorial.md b/docs/atl/active-template-library-atl-tutorial.md index 52c536ff965..2a9841ea00c 100644 --- a/docs/atl/active-template-library-atl-tutorial.md +++ b/docs/atl/active-template-library-atl-tutorial.md @@ -5,6 +5,7 @@ ms.custom: "get-started-article" ms.date: "05/03/2019" helpviewer_keywords: ["ATL projects, tutorials", "controls [ATL], tutorials", "ATL tutorial", "tutorials [ATL]", "ATL, tutorials"] ms.assetid: f921a121-09c8-4812-9317-e15b2f1471fa +ms.topic: tutorial --- # Active Template Library (ATL) Tutorial diff --git a/docs/atl/adding-a-control-atl-tutorial-part-2.md b/docs/atl/adding-a-control-atl-tutorial-part-2.md index 64913399d10..668cb2039f1 100644 --- a/docs/atl/adding-a-control-atl-tutorial-part-2.md +++ b/docs/atl/adding-a-control-atl-tutorial-part-2.md @@ -4,6 +4,7 @@ title: "Adding a Control (ATL Tutorial, Part 2)" ms.custom: "get-started-article" ms.date: "08/19/2019" ms.assetid: c9575a75-1064-41f1-9697-7aada560c669 +ms.topic: tutorial --- # Adding a Control (ATL Tutorial, Part 2) diff --git a/docs/atl/adding-a-property-page-atl-tutorial-part-6.md b/docs/atl/adding-a-property-page-atl-tutorial-part-6.md index 77ab6f873a6..394d9aff8da 100644 --- a/docs/atl/adding-a-property-page-atl-tutorial-part-6.md +++ b/docs/atl/adding-a-property-page-atl-tutorial-part-6.md @@ -4,6 +4,7 @@ title: "Adding a Property Page (ATL Tutorial, Part 6)" ms.custom: "get-started-article" ms.date: "09/27/2018" ms.assetid: df80d255-e7ea-49d9-b940-3f012e90cf9b +ms.topic: tutorial --- # Adding a Property Page (ATL Tutorial, Part 6) diff --git a/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md b/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md index eae5f195dd7..839a2653ed1 100644 --- a/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md +++ b/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md @@ -4,6 +4,7 @@ title: "Adding a Property to the Control (ATL Tutorial, Part 3)" ms.custom: "get-started-article" ms.date: "09/26/2018" ms.assetid: f775fe34-103b-4f07-9999-400e987ee030 +ms.topic: tutorial --- # Adding a Property to the Control (ATL Tutorial, Part 3) diff --git a/docs/atl/adding-an-atl-message-handler.md b/docs/atl/adding-an-atl-message-handler.md index e7dd2532992..ee2243126a9 100644 --- a/docs/atl/adding-an-atl-message-handler.md +++ b/docs/atl/adding-an-atl-message-handler.md @@ -4,6 +4,7 @@ title: "Adding an ATL Message Handler" ms.date: "11/04/2016" helpviewer_keywords: ["message handlers [C++]", "ATL, windows", "message handling [C++], ATL message handler", "windows [C++], ATL", "ATL, message handlers"] ms.assetid: cdea38a1-0d9b-4f8d-bbd5-b4f063fb3eeb +ms.topic: concept-article --- # Adding an ATL Message Handler diff --git a/docs/atl/adding-an-event-atl-tutorial-part-5.md b/docs/atl/adding-an-event-atl-tutorial-part-5.md index 18306b8df03..48d9ef8f01d 100644 --- a/docs/atl/adding-an-event-atl-tutorial-part-5.md +++ b/docs/atl/adding-an-event-atl-tutorial-part-5.md @@ -4,6 +4,7 @@ title: "Adding an Event (ATL Tutorial, Part 5)" ms.custom: "get-started-article" ms.date: "09/27/2018" ms.assetid: 2de12022-3148-4ce3-8606-8a9d4274f0e9 +ms.topic: tutorial --- # Adding an Event (ATL Tutorial, Part 5) diff --git a/docs/atl/adding-connection-points-to-an-object.md b/docs/atl/adding-connection-points-to-an-object.md index 671460f394d..f5f66a1c0eb 100644 --- a/docs/atl/adding-connection-points-to-an-object.md +++ b/docs/atl/adding-connection-points-to-an-object.md @@ -4,6 +4,7 @@ title: "Adding Connection Points to an Object" ms.date: "11/04/2016" helpviewer_keywords: ["connection points [C++], adding to ATL objects", "Implement Connection Point ATL wizard"] ms.assetid: 843531be-4a36-4db0-9d54-e029b1a72a8b +ms.topic: how-to --- # Adding Connection Points to an Object diff --git a/docs/atl/adding-functionality-to-the-composite-control.md b/docs/atl/adding-functionality-to-the-composite-control.md index 77ef261e3b0..35766209450 100644 --- a/docs/atl/adding-functionality-to-the-composite-control.md +++ b/docs/atl/adding-functionality-to-the-composite-control.md @@ -4,6 +4,7 @@ title: "Adding Functionality to the Composite Control" ms.date: "11/04/2016" helpviewer_keywords: ["event handlers [C++], ActiveX controls", "composite controls, handling events", "ActiveX controls [C++], events"] ms.assetid: 98f85681-9564-480d-af38-03f9733fe58b +ms.topic: concept-article --- # Adding Functionality to the Composite Control diff --git a/docs/atl/atl-class-overview.md b/docs/atl/atl-class-overview.md index 5b028118055..98846a0de5f 100644 --- a/docs/atl/atl-class-overview.md +++ b/docs/atl/atl-class-overview.md @@ -4,6 +4,7 @@ title: "ATL class overview" ms.date: "11/04/2016" helpviewer_keywords: ["classes [C++], ATL", "ATL, class reference"] ms.assetid: c38ac93d-c3a2-4ce7-8153-f1d34c0f0fa6 +ms.topic: concept-article --- # ATL class overview diff --git a/docs/atl/atl-collection-classes.md b/docs/atl/atl-collection-classes.md index 7545e6d6906..db96014d6f0 100644 --- a/docs/atl/atl-collection-classes.md +++ b/docs/atl/atl-collection-classes.md @@ -4,6 +4,7 @@ title: "ATL collection class overview" ms.date: "11/19/2018" helpviewer_keywords: ["DestructElements function", "collection classes, choosing", "ConstructElements function", "SerializeElements function", "traits classes", "collection classes, about collection classes", "CTraits classes", "collection classes"] ms.assetid: 4d619d46-5b4e-41dd-b9fd-e86b1fbc00b5 +ms.topic: concept-article --- # ATL Collection Classes diff --git a/docs/atl/building-and-testing-the-atl-project.md b/docs/atl/building-and-testing-the-atl-project.md index 9a5c30dd382..d5920c6e591 100644 --- a/docs/atl/building-and-testing-the-atl-project.md +++ b/docs/atl/building-and-testing-the-atl-project.md @@ -4,6 +4,7 @@ title: "Building and Testing the ATL Project" ms.date: "11/04/2016" helpviewer_keywords: ["composite controls, building and testing the project", "composite controls, containers for"] ms.assetid: 5c1541f8-f6cb-4c22-bd22-c66bcfbaa077 +ms.topic: concept-article --- # Building and Testing the ATL Project diff --git a/docs/atl/calling-cpp-code-from-dhtml.md b/docs/atl/calling-cpp-code-from-dhtml.md index 64b57d32b47..a5d05fe09ee 100644 --- a/docs/atl/calling-cpp-code-from-dhtml.md +++ b/docs/atl/calling-cpp-code-from-dhtml.md @@ -4,6 +4,7 @@ title: "Calling C++ Code from DHTML" ms.date: "11/04/2016" helpviewer_keywords: ["DHTML, calling C++ code from"] ms.assetid: 37329acd-4c22-40ca-a85a-b7480748f75f +ms.topic: concept-article --- # Calling C++ Code from DHTML diff --git a/docs/atl/changing-the-default-class-factory-and-aggregation-model.md b/docs/atl/changing-the-default-class-factory-and-aggregation-model.md index 5cc79f13e54..78b9ca1c8a0 100644 --- a/docs/atl/changing-the-default-class-factory-and-aggregation-model.md +++ b/docs/atl/changing-the-default-class-factory-and-aggregation-model.md @@ -4,6 +4,7 @@ title: "Changing the Default Class Factory and Aggregation Model" ms.date: "11/04/2016" helpviewer_keywords: ["CComClassFactory class, making the default", "aggregation [C++], using ATL", "aggregation [C++], aggregation models", "defaults [C++], aggregation model in ATL", "default class factory", "class factories, changing default", "CComCoClass class, default class factory and aggregation model", "default class factory, ATL", "defaults [C++], class factory"] ms.assetid: 6e040e95-0f38-4839-8a8b-c9800dd47e8c +ms.topic: concept-article --- # Changing the Default Class Factory and Aggregation Model diff --git a/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md b/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md index ae8149664e8..2ed4a960e6b 100644 --- a/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md +++ b/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md @@ -5,6 +5,7 @@ ms.custom: "get-started-article" ms.date: "09/26/2018" helpviewer_keywords: ["_ATL_MIN_CRT macro"] ms.assetid: 08ff14e8-aa49-4139-a110-5d071939cf1e +ms.topic: tutorial --- # Changing the Drawing Code (ATL Tutorial, Part 4) diff --git a/docs/atl/creating-an-aggregated-object.md b/docs/atl/creating-an-aggregated-object.md index ea3e0cb8d69..f0bc8d88b24 100644 --- a/docs/atl/creating-an-aggregated-object.md +++ b/docs/atl/creating-an-aggregated-object.md @@ -4,6 +4,7 @@ title: "Creating an Aggregated Object" ms.date: "11/04/2016" helpviewer_keywords: ["aggregation [C++], creating aggregated objects", "aggregate objects [C++], creating"] ms.assetid: fc29d7aa-fd53-4276-9c2f-37379f71b179 +ms.topic: how-to --- # Creating an Aggregated Object diff --git a/docs/atl/creating-an-atl-dhtml-control.md b/docs/atl/creating-an-atl-dhtml-control.md index 8a6d94f04e1..1831d58d0b3 100644 --- a/docs/atl/creating-an-atl-dhtml-control.md +++ b/docs/atl/creating-an-atl-dhtml-control.md @@ -4,6 +4,7 @@ title: "Creating an ATL DHTML Control" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, creating", "DHTML controls", "DHTML controls, creating"] ms.assetid: 1d8f0ede-7d8b-4959-976e-b4d0e2a87f5a +ms.topic: how-to --- # Creating an ATL DHTML Control diff --git a/docs/atl/creating-registrar-scripts.md b/docs/atl/creating-registrar-scripts.md index e4a6c996184..d9d281b53ab 100644 --- a/docs/atl/creating-registrar-scripts.md +++ b/docs/atl/creating-registrar-scripts.md @@ -4,6 +4,7 @@ title: "Creating scripts for ATL Registrar" ms.date: "05/14/2014" helpviewer_keywords: ["scripting, registry scripting", "ATL, registry", "registrar scripts [ATL]", "scripts, Registrar scripts", "scripts, creating"] ms.assetid: cbd5024b-8061-4a71-be65-7fee90374a35 +ms.topic: concept-article --- # Creating Registrar scripts diff --git a/docs/atl/creating-the-project-atl-tutorial-part-1.md b/docs/atl/creating-the-project-atl-tutorial-part-1.md index 9326e91f39d..b8a01fd2255 100644 --- a/docs/atl/creating-the-project-atl-tutorial-part-1.md +++ b/docs/atl/creating-the-project-atl-tutorial-part-1.md @@ -4,6 +4,7 @@ title: "Creating the Project (ATL Tutorial, Part 1)" ms.custom: "get-started-article" ms.date: "08/19/2019" ms.assetid: f6b727d1-390a-4b27-b82f-daadcd9fc059 +ms.topic: tutorial --- # Creating the Project (ATL Tutorial, Part 1) diff --git a/docs/atl/debugging-tips.md b/docs/atl/debugging-tips.md index 986845b3192..5fcdee636d5 100644 --- a/docs/atl/debugging-tips.md +++ b/docs/atl/debugging-tips.md @@ -4,6 +4,7 @@ title: "Debugging Tips (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, debugging", "services, debugging"] ms.assetid: 48c60244-d0ce-4466-85fa-6fa65fcfe86c +ms.topic: concept-article --- # Debugging Tips diff --git a/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md b/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md index 84783f4e5a0..e75179b64e0 100644 --- a/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md +++ b/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md @@ -4,6 +4,7 @@ title: "Designing Collection and Enumerator Interfaces (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["enumerator interfaces", "collection interfaces"] ms.assetid: ea19a39e-6333-41a1-be62-5435c236640e +ms.topic: concept-article --- # Design Principles for Collection and Enumerator Interfaces diff --git a/docs/atl/displaying-assertions.md b/docs/atl/displaying-assertions.md index 8f1863b3718..8587c3eb40c 100644 --- a/docs/atl/displaying-assertions.md +++ b/docs/atl/displaying-assertions.md @@ -4,6 +4,7 @@ title: "Displaying Assertions" ms.date: "05/05/2019" helpviewer_keywords: ["debugging [ATL], displaying assertions", "assertions, displaying", "debugging assertions", "assertions, debugging"] ms.assetid: fa353fe8-4656-4384-a5d2-8866bc977f06 +ms.topic: concept-article --- # Displaying Assertions diff --git a/docs/atl/example-implementing-a-property-page.md b/docs/atl/example-implementing-a-property-page.md index c6e44f85f6f..803f88a8eed 100644 --- a/docs/atl/example-implementing-a-property-page.md +++ b/docs/atl/example-implementing-a-property-page.md @@ -4,6 +4,7 @@ title: "Implementing a Property Page (ATL)" ms.date: "05/09/2019" helpviewer_keywords: ["property pages, implementing"] ms.assetid: c30b67fe-ce08-4249-ae29-f3060fa8d61e +ms.topic: concept-article --- # Example: Implementing a Property Page diff --git a/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md b/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md index dcf9ebc388c..7ac825b8372 100644 --- a/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md +++ b/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md @@ -4,6 +4,7 @@ title: "Identifying the Elements of the DHTML Control Project" ms.date: "11/19/2018" helpviewer_keywords: ["HTML controls, ATL support", "DHTML controls, ATL support"] ms.assetid: b627547a-3768-4346-9900-4b7a21fb8e27 +ms.topic: concept-article --- # Identifying the Elements of the DHTML Control Project diff --git a/docs/atl/implementing-a-dialog-box.md b/docs/atl/implementing-a-dialog-box.md index b07f0570b52..43e12bf1c62 100644 --- a/docs/atl/implementing-a-dialog-box.md +++ b/docs/atl/implementing-a-dialog-box.md @@ -4,6 +4,7 @@ title: "Implementing a Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["CSimpleDialog class, implementing dialog boxes in ATL", "dialog boxes, ATL", "CAxDialogImpl class, implementing dialog boxes in ATL", "ATL, dialog boxes"] ms.assetid: 478525f2-aa6a-435a-b162-68fc8aa98a8e +ms.topic: concept-article --- # Implementing a Dialog Box diff --git a/docs/atl/implementing-a-dual-interface.md b/docs/atl/implementing-a-dual-interface.md index 0dd114236ca..6abd84d51b4 100644 --- a/docs/atl/implementing-a-dual-interface.md +++ b/docs/atl/implementing-a-dual-interface.md @@ -4,6 +4,7 @@ title: "Implementing a Dual Interface (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["IDispatchImpl class, implementing dual interfaces", "dual interfaces, implementing"] ms.assetid: d1da3633-b445-4dcd-8a0a-3efdafada3ea +ms.topic: concept-article --- # Implementing a Dual Interface diff --git a/docs/atl/implementing-a-window-with-cwindowimpl.md b/docs/atl/implementing-a-window-with-cwindowimpl.md index ec6725d6e06..e23a33cca2c 100644 --- a/docs/atl/implementing-a-window-with-cwindowimpl.md +++ b/docs/atl/implementing-a-window-with-cwindowimpl.md @@ -4,6 +4,7 @@ title: "Implementing a Window with CWindowImpl" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "windows [C++], subclassing", "windows [C++], superclassing", "windows [C++], ATL", "subclassing ATL window classes", "superclassing, ATL"] ms.assetid: 3fc40550-f1d6-4702-8b7c-4cf682b6a855 +ms.topic: concept-article --- # Implementing a Window with CWindowImpl diff --git a/docs/atl/implementing-a-window.md b/docs/atl/implementing-a-window.md index 6f4137ced3c..dbe42c3fbc5 100644 --- a/docs/atl/implementing-a-window.md +++ b/docs/atl/implementing-a-window.md @@ -4,6 +4,7 @@ title: "Implementing a Window (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "CWindowImpl class, using", "windows [C++], implementing in ATL"] ms.assetid: eb1ce8d6-72f9-4894-aae7-e60a61665628 +ms.topic: concept-article --- # Implementing a Window diff --git a/docs/atl/implementing-an-stl-based-collection.md b/docs/atl/implementing-an-stl-based-collection.md index a01de0c2ba4..761ef740d16 100644 --- a/docs/atl/implementing-an-stl-based-collection.md +++ b/docs/atl/implementing-an-stl-based-collection.md @@ -4,6 +4,7 @@ title: "Implementing a C++ Standard Library-Based Collection" ms.date: "11/04/2016" helpviewer_keywords: ["ICollectionOnSTLImpl interface"] ms.assetid: 6d49f819-1957-4813-b074-3f12c494d8ca +ms.topic: how-to --- # Implementing a C++ Standard Library-Based Collection diff --git a/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md b/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md index c3016ec9b81..e7a6428fbaa 100644 --- a/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md +++ b/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md @@ -4,6 +4,7 @@ title: "Implementing CComObject, CComAggObject, and CComPolyObject" ms.date: "11/04/2016" helpviewer_keywords: ["CComPolyObject class, implementing", "CreateInstance method", "CComAggObject class", "CComObject class, implementing"] ms.assetid: 5aabe938-104d-492e-9c41-9f7fb1c62098 +ms.topic: concept-article --- # Implementing CComObject, CComAggObject, and CComPolyObject diff --git a/docs/atl/implementing-ccomobjectrootex.md b/docs/atl/implementing-ccomobjectrootex.md index 1c4395557b7..5dc0fc19caf 100644 --- a/docs/atl/implementing-ccomobjectrootex.md +++ b/docs/atl/implementing-ccomobjectrootex.md @@ -4,6 +4,7 @@ title: "Implementing CComObjectRootEx" ms.date: "11/04/2016" helpviewer_keywords: ["CComObjectRoot class, implementing", "CComObjectRootEx class"] ms.assetid: 79630c44-f2df-4e9e-b730-400a0ebfbd2b +ms.topic: concept-article --- # Implementing CComObjectRootEx diff --git a/docs/atl/implementing-property-pages.md b/docs/atl/implementing-property-pages.md index 3dcdced9d07..61a2bbec06d 100644 --- a/docs/atl/implementing-property-pages.md +++ b/docs/atl/implementing-property-pages.md @@ -4,6 +4,7 @@ title: "Implementing Property Pages" ms.date: "11/04/2016" helpviewer_keywords: ["IPropertyPage2 class", "IPropertyPage class", "property pages, implementing"] ms.assetid: 62f29440-33a7-40eb-a1ef-3634c95f640c +ms.topic: concept-article --- # Implementing Property Pages diff --git a/docs/atl/implementing-the-event-handling-interface.md b/docs/atl/implementing-the-event-handling-interface.md index 2be79a7b89d..3442039a73e 100644 --- a/docs/atl/implementing-the-event-handling-interface.md +++ b/docs/atl/implementing-the-event-handling-interface.md @@ -4,6 +4,7 @@ title: "Implementing the Event Handling Interface" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, event handling", "event handling, ATL", "interfaces, event and event sink"] ms.assetid: eb2a5b33-88dc-4ce3-bee0-c5c38ea050d7 +ms.topic: concept-article --- # Implementing the Event Handling Interface diff --git a/docs/atl/inserting-a-composite-control.md b/docs/atl/inserting-a-composite-control.md index 2a3375c05a9..491a3379a1b 100644 --- a/docs/atl/inserting-a-composite-control.md +++ b/docs/atl/inserting-a-composite-control.md @@ -4,6 +4,7 @@ title: "Inserting a Composite Control" ms.date: "11/04/2016" helpviewer_keywords: ["composite controls, inserting with ATL Object Wizard", "composite controls", "ATL Control Wizard"] ms.assetid: f10b1927-9fc6-40a7-ac29-efdac70584fe +ms.topic: concept-article --- # Inserting a Composite Control diff --git a/docs/atl/introduction-to-atl-window-classes.md b/docs/atl/introduction-to-atl-window-classes.md index a4593ae915b..5ae3fc8c8a3 100644 --- a/docs/atl/introduction-to-atl-window-classes.md +++ b/docs/atl/introduction-to-atl-window-classes.md @@ -4,6 +4,7 @@ title: "Introduction to ATL Window Classes" ms.date: "11/04/2016" helpviewer_keywords: ["window classes"] ms.assetid: 503efc2c-a269-495d-97cf-3fb300d52f3d +ms.topic: concept-article --- # Introduction to ATL Window Classes diff --git a/docs/atl/introduction-to-atl.md b/docs/atl/introduction-to-atl.md index 104ef1d2749..cccfc973918 100644 --- a/docs/atl/introduction-to-atl.md +++ b/docs/atl/introduction-to-atl.md @@ -5,6 +5,7 @@ ms.custom: "index-page" ms.date: "11/04/2016" helpviewer_keywords: ["COM objects, creating in ATL", "ATL"] ms.assetid: 77f565e8-c4ec-4a80-af4b-7278fcfe5c98 +ms.topic: concept-article --- # Introduction to ATL diff --git a/docs/atl/introduction-to-com-and-atl.md b/docs/atl/introduction-to-com-and-atl.md index 8cb151d30af..57e25904bca 100644 --- a/docs/atl/introduction-to-com-and-atl.md +++ b/docs/atl/introduction-to-com-and-atl.md @@ -5,6 +5,7 @@ ms.custom: "index-page" ms.date: "11/04/2016" helpviewer_keywords: ["COM, and ATL", "ATL, COM", "COM objects, ATL"] ms.assetid: 35d6ae9c-abbb-42f0-9344-33f3c19ac3ce +ms.topic: concept-article --- # Introduction to COM and ATL diff --git a/docs/atl/introduction-to-com.md b/docs/atl/introduction-to-com.md index c90f0c03ce3..c44fc4f0652 100644 --- a/docs/atl/introduction-to-com.md +++ b/docs/atl/introduction-to-com.md @@ -5,6 +5,7 @@ ms.custom: "index-page" ms.date: "11/04/2016" helpviewer_keywords: ["COM"] ms.assetid: 120735d9-db71-4ad3-a730-ce576ea2354e +ms.topic: concept-article --- # Introduction to COM diff --git a/docs/atl/invoking-scripts.md b/docs/atl/invoking-scripts.md index 459197b82d0..2d339471811 100644 --- a/docs/atl/invoking-scripts.md +++ b/docs/atl/invoking-scripts.md @@ -4,6 +4,7 @@ title: "Invoking Scripts (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["StringRegister method", "scripts, invoking registry in ATL"] ms.assetid: eabd41ee-586b-4266-9e92-5aaad04b73a4 +ms.topic: concept-article --- # Invoking Scripts diff --git a/docs/atl/linking-to-the-crt-in-your-atl-project.md b/docs/atl/linking-to-the-crt-in-your-atl-project.md index d67da0b10b4..430134baa43 100644 --- a/docs/atl/linking-to-the-crt-in-your-atl-project.md +++ b/docs/atl/linking-to-the-crt-in-your-atl-project.md @@ -4,6 +4,7 @@ title: "Linking to the CRT in Your ATL Project" ms.date: "11/04/2016" helpviewer_keywords: ["CRT, linking with ATL", "WinMainCRTStartup method", "DllMainCRTStartup method", "wWinMainCRTStartup method", "ATL, C Run-Time library (CRT)"] ms.assetid: 650957ae-362c-4ecf-8b03-5d49138e8b5b +ms.topic: concept-article --- # Linking to the CRT in Your ATL Project diff --git a/docs/atl/marshaling.md b/docs/atl/marshaling.md index 03501d803f1..1f5c52b2be5 100644 --- a/docs/atl/marshaling.md +++ b/docs/atl/marshaling.md @@ -4,6 +4,7 @@ title: "Marshaling" ms.date: "11/04/2016" helpviewer_keywords: ["marshaling, COM interop", "marshaling", "COM interfaces, marshaling"] ms.assetid: 40644b0a-1106-4fc8-9dfb-9bee9915d825 +ms.topic: concept-article --- # Marshaling diff --git a/docs/atl/modifying-the-atl-dhtml-control.md b/docs/atl/modifying-the-atl-dhtml-control.md index 559c5470378..3e77a536a1f 100644 --- a/docs/atl/modifying-the-atl-dhtml-control.md +++ b/docs/atl/modifying-the-atl-dhtml-control.md @@ -4,6 +4,7 @@ title: "Modifying the ATL DHTML Control" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, modifying", "DHTML controls", "DHTML controls, modifying"] ms.assetid: c053f35f-8629-4600-9595-721f5956777a +ms.topic: how-to --- # Modifying the ATL DHTML Control diff --git a/docs/atl/modifying-the-atl-project.md b/docs/atl/modifying-the-atl-project.md index b2a4b44bc82..d9211d97764 100644 --- a/docs/atl/modifying-the-atl-project.md +++ b/docs/atl/modifying-the-atl-project.md @@ -4,6 +4,7 @@ title: "Modifying the ATL Project" ms.date: "11/04/2016" helpviewer_keywords: ["controls [ATL], adding to composite controls", "Dialog editor, working with composite controls", "composite controls, adding controls"] ms.assetid: 59984518-748f-4b8b-875f-3e97d22d0b0f +ms.topic: concept-article --- # Modifying the ATL Project diff --git a/docs/atl/programming-with-atl-and-c-run-time-code.md b/docs/atl/programming-with-atl-and-c-run-time-code.md index 697a3c67502..66c4ade4f21 100644 --- a/docs/atl/programming-with-atl-and-c-run-time-code.md +++ b/docs/atl/programming-with-atl-and-c-run-time-code.md @@ -4,6 +4,7 @@ title: "Programming with ATL and C Run-Time Code" ms.date: "11/04/2016" helpviewer_keywords: ["ATL_MIN_CRT macro", "CRT, using with ATL", "_ATL_MIN_CRT macro", "ATL, C Run-Time library (CRT)"] ms.assetid: 20f03b66-1eb7-4add-84a2-6047db0911eb +ms.topic: concept-article --- # Programming with ATL and C Run-Time Code diff --git a/docs/atl/programming-with-ccombstr-atl.md b/docs/atl/programming-with-ccombstr-atl.md index 74c5c544656..31f7ee2d370 100644 --- a/docs/atl/programming-with-ccombstr-atl.md +++ b/docs/atl/programming-with-ccombstr-atl.md @@ -4,6 +4,7 @@ title: "Programming with CComBSTR (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["CComBSTR class, programming with", "Unicode, using CComBSTR [ATL]"] ms.assetid: d3bd0851-d132-4be9-9c4c-6ccba17acb2b +ms.topic: concept-article --- # Programming with CComBSTR (ATL) diff --git a/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md b/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md index 14db4bbf4cc..faf66529f16 100644 --- a/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md +++ b/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md @@ -4,6 +4,7 @@ title: "Putting the Control on a Web Page (ATL Tutorial, Part 7)" ms.custom: "get-started-article" ms.date: "05/06/2019" ms.assetid: 50dc4c95-c95b-4006-b88a-9826f7bdb222 +ms.topic: tutorial --- # Putting the Control on a Web Page (ATL Tutorial, Part 7) diff --git a/docs/atl/running-the-program-as-a-local-server.md b/docs/atl/running-the-program-as-a-local-server.md index 5c063f70987..647555b4552 100644 --- a/docs/atl/running-the-program-as-a-local-server.md +++ b/docs/atl/running-the-program-as-a-local-server.md @@ -4,6 +4,7 @@ title: "Running the Program as a Local Server" ms.date: "11/04/2016" helpviewer_keywords: ["debugging [ATL], running services as local server", "ATL services, running as local servers"] ms.assetid: eb9701e6-e2a8-4666-897f-0c893aec8ac7 +ms.topic: concept-article --- # Running the Program as a Local Server diff --git a/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md b/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md index ef4dd01f189..e5797ef152c 100644 --- a/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md +++ b/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md @@ -4,6 +4,7 @@ description: "How to statically link C++ code to the ATL Registrar code." ms.date: 09/03/2020 helpviewer_keywords: ["statically linking to ATL Registrar code", "linking [C++], to ATL Registrar code"] ms.assetid: 835f5885-87a6-48fa-91e6-60988ee65538 +ms.topic: how-to --- # Setting up a static link to the Registrar code (C++ Only) diff --git a/docs/atl/specifying-property-pages.md b/docs/atl/specifying-property-pages.md index 25dd74d4e22..0213211d07c 100644 --- a/docs/atl/specifying-property-pages.md +++ b/docs/atl/specifying-property-pages.md @@ -4,6 +4,7 @@ title: "Specifying Property Pages (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ISpecifyPropertyPages method", "property pages, specifying"] ms.assetid: ee8678cf-c708-49ab-b0ad-fc2db31f1ac3 +ms.topic: how-to --- # Specifying Property Pages diff --git a/docs/atl/specifying-the-threading-model-for-a-project-atl.md b/docs/atl/specifying-the-threading-model-for-a-project-atl.md index 70c3d124dd4..f9d9ebeb3aa 100644 --- a/docs/atl/specifying-the-threading-model-for-a-project-atl.md +++ b/docs/atl/specifying-the-threading-model-for-a-project-atl.md @@ -4,6 +4,7 @@ title: "Specifying the Threading Model for a Project (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["_ATL_FREE_THREADED macro", "_ATL_APARTMENT_THREADED macro", "ATL, multithreading", "threading [ATL], models", "_ATL_SINGLE_THREADED macro"] ms.assetid: 6b571078-521c-4f3e-9f08-482aa235a822 +ms.topic: concept-article --- # Specifying the Threading Model for a Project (ATL) diff --git a/docs/atl/supporting-idispatch-and-ierrorinfo.md b/docs/atl/supporting-idispatch-and-ierrorinfo.md index 7d0c89d28e7..97c49084358 100644 --- a/docs/atl/supporting-idispatch-and-ierrorinfo.md +++ b/docs/atl/supporting-idispatch-and-ierrorinfo.md @@ -4,6 +4,7 @@ title: "Supporting IDispatch and IErrorInfo" ms.date: "11/04/2016" helpviewer_keywords: ["ISupportErrorInfoImpl method", "IErrorInfo class suppor in ATL", "IDispatchImpl class", "IDispatch class support in ATL"] ms.assetid: 7db2220f-319d-4ce9-9382-d340019f14f7 +ms.topic: concept-article --- # Supporting IDispatch and IErrorInfo diff --git a/docs/atl/supporting-idispeventimpl.md b/docs/atl/supporting-idispeventimpl.md index 008def002d0..261ffa445cd 100644 --- a/docs/atl/supporting-idispeventimpl.md +++ b/docs/atl/supporting-idispeventimpl.md @@ -4,6 +4,7 @@ title: "Supporting IDispEventImpl" ms.date: "11/04/2016" helpviewer_keywords: ["event sink maps, declaring", "IDispEventImpl class, advising and unadvising", "SINK_ENTRY macro", "type libraries, importing", "ATL, IDispEventImpl support in COM objects", "BEGIN_SINK_MAP macro", "IDispEventImpl class, declaring"] ms.assetid: b957f930-6a5b-4598-8e4d-8027759957e7 +ms.topic: concept-article --- # Supporting IDispEventImpl diff --git a/docs/atl/testing-the-atl-dhtml-control.md b/docs/atl/testing-the-atl-dhtml-control.md index f148c3fe6d0..1d223e24d1d 100644 --- a/docs/atl/testing-the-atl-dhtml-control.md +++ b/docs/atl/testing-the-atl-dhtml-control.md @@ -4,6 +4,7 @@ title: "Testing the ATL DHTML Control" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, testing", "testing controls", "DHTML controls", "DHTML controls, testing"] ms.assetid: 0e4b4358-80ce-4505-8b06-ef4f30b1d1f0 +ms.topic: how-to --- # Testing the ATL DHTML Control diff --git a/docs/atl/testing-the-modified-atl-dhtml-control.md b/docs/atl/testing-the-modified-atl-dhtml-control.md index 71a65367b2e..fe0809b88b7 100644 --- a/docs/atl/testing-the-modified-atl-dhtml-control.md +++ b/docs/atl/testing-the-modified-atl-dhtml-control.md @@ -4,6 +4,7 @@ title: "Testing the Modified ATL DHTML Control" ms.date: "11/06/2018" helpviewer_keywords: ["HTML controls, testing", "testing controls", "DHTML controls, testing"] ms.assetid: 42316118-9433-410f-9d8a-0efcc1eff824 +ms.topic: how-to --- # Testing the Modified ATL DHTML Control diff --git a/docs/atl/threading-models-and-critical-sections-classes.md b/docs/atl/threading-models-and-critical-sections-classes.md index cd8a516c145..1bc26034ca9 100644 --- a/docs/atl/threading-models-and-critical-sections-classes.md +++ b/docs/atl/threading-models-and-critical-sections-classes.md @@ -4,6 +4,7 @@ title: "Threading Models and Critical Sections Classes (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, critical sections", "ATL, multithreading", "threading [ATL], models", "critical sections"] ms.assetid: 759f05ef-6285-4be6-a2cc-78572dd75146 +ms.topic: concept-article --- # Threading Models and Critical Sections Classes diff --git a/docs/atl/understanding-backus-naur-form-bnf-syntax.md b/docs/atl/understanding-backus-naur-form-bnf-syntax.md index 1422e4379ce..7e5295bf9ec 100644 --- a/docs/atl/understanding-backus-naur-form-bnf-syntax.md +++ b/docs/atl/understanding-backus-naur-form-bnf-syntax.md @@ -4,6 +4,7 @@ title: "ATL Registrar and Backus-Naur form (BNF) syntax" ms.date: "05/14/2019" helpviewer_keywords: ["BNF notation", "Backus-Naur form (BNF) syntax"] ms.assetid: 994bbef0-9077-4aa8-bdfe-b7e830af9acc +ms.topic: concept-article --- # Understanding Backus-Naur form (BNF) syntax diff --git a/docs/atl/understanding-parse-trees.md b/docs/atl/understanding-parse-trees.md index 3f10cd3fbce..a0eea7d823a 100644 --- a/docs/atl/understanding-parse-trees.md +++ b/docs/atl/understanding-parse-trees.md @@ -3,6 +3,7 @@ description: "Learn more about: Understanding parse trees" title: "ATL Registrar and Parse Trees" ms.date: 04/15/2021 helpviewer_keywords: ["parse trees"] +ms.topic: concept-article --- # Understanding parse trees diff --git a/docs/atl/understanding-window-traits.md b/docs/atl/understanding-window-traits.md index 25564c04ec7..df7884f8624 100644 --- a/docs/atl/understanding-window-traits.md +++ b/docs/atl/understanding-window-traits.md @@ -4,6 +4,7 @@ title: "ATL Window Traits" ms.date: "11/04/2016" helpviewer_keywords: ["window traits"] ms.assetid: c90cf850-9e91-49da-9cf3-ad4efb30347d +ms.topic: concept-article --- # Understanding Window Traits diff --git a/docs/atl/using-a-template-library.md b/docs/atl/using-a-template-library.md index 36b56c57a1f..11bd456ff96 100644 --- a/docs/atl/using-a-template-library.md +++ b/docs/atl/using-a-template-library.md @@ -4,6 +4,7 @@ title: "Using a Template Library (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["template libraries"] ms.assetid: 5e80ec6e-a61c-41ce-b34b-9a6252c46265 +ms.topic: concept-article --- # Using a Template Library diff --git a/docs/atl/using-a-window.md b/docs/atl/using-a-window.md index f79ec47eb93..69488133ae5 100644 --- a/docs/atl/using-a-window.md +++ b/docs/atl/using-a-window.md @@ -4,6 +4,7 @@ title: "Using a Window (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "CWindow class, about CWindow class", "windows [C++], ATL"] ms.assetid: b3b9cc8e-4287-486b-b080-38852bc2943a +ms.topic: concept-article --- # Using a Window diff --git a/docs/atl/using-contained-windows.md b/docs/atl/using-contained-windows.md index 62451849278..82894f8eeae 100644 --- a/docs/atl/using-contained-windows.md +++ b/docs/atl/using-contained-windows.md @@ -4,6 +4,7 @@ title: "Using Contained Windows" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "windows [C++], ATL", "contained windows in ATL"] ms.assetid: 7b3d79e5-b569-413f-9b98-df4f14efbe2b +ms.topic: concept-article --- # Using Contained Windows diff --git a/docs/atl/using-idispeventimpl.md b/docs/atl/using-idispeventimpl.md index d15678d3b64..321781fd3f3 100644 --- a/docs/atl/using-idispeventimpl.md +++ b/docs/atl/using-idispeventimpl.md @@ -4,6 +4,7 @@ title: "Using IDispEventImpl (ATL)" ms.date: "08/19/2019" helpviewer_keywords: ["IDispEventImpl class, using"] ms.assetid: 82d53b61-9d0d-45c5-aff9-2fafa468a9ca +ms.topic: concept-article --- # Using IDispEventImpl diff --git a/docs/atl/using-idispeventsimpleimpl.md b/docs/atl/using-idispeventsimpleimpl.md index 2c0ee8349f1..3f50230f72c 100644 --- a/docs/atl/using-idispeventsimpleimpl.md +++ b/docs/atl/using-idispeventsimpleimpl.md @@ -4,6 +4,7 @@ title: "Using IDispEventSimpleImpl (ATL)" ms.date: "08/19/2019" helpviewer_keywords: ["IDispEventSimpleImpl class, using"] ms.assetid: 8640ad1a-4bd0-40a5-b5e4-7322685d7aab +ms.topic: concept-article --- # Using IDispEventSimpleImpl diff --git a/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md b/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md index 1b9ef3d2d45..5541235e127 100644 --- a/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md +++ b/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md @@ -4,6 +4,7 @@ title: "Using Replaceable Parameters (ATL Registrar)" ms.date: "11/04/2016" helpviewer_keywords: ["%MODULE%"] ms.assetid: 0b376994-84a6-4967-8d97-8c01dfc94efe +ms.topic: concept-article --- # Using Replaceable Parameters (The Registrar's Preprocessor) diff --git a/docs/atl/using-task-manager.md b/docs/atl/using-task-manager.md index 626e5525990..e52c3764c68 100644 --- a/docs/atl/using-task-manager.md +++ b/docs/atl/using-task-manager.md @@ -4,6 +4,7 @@ title: "Using Task Manager" ms.date: "11/04/2016" helpviewer_keywords: ["Task Manager", "breakpoints, Task Manager", "debugging [ATL], using Task Manager"] ms.assetid: 773fccd5-308d-42c2-a17f-60ae94989062 +ms.topic: concept-article --- # Using Task Manager diff --git a/docs/build-insights/get-started-with-cpp-build-insights.md b/docs/build-insights/get-started-with-cpp-build-insights.md index 0ee6e8c5833..cc5b0a8e1b8 100644 --- a/docs/build-insights/get-started-with-cpp-build-insights.md +++ b/docs/build-insights/get-started-with-cpp-build-insights.md @@ -4,6 +4,7 @@ description: "A high-level overview of C++ Build Insights." ms.date: "11/03/2019" helpviewer_keywords: ["C++ Build Insights", "throughput analysis", "build time analysis", "vcperf.exe"] ms.custom: intro-get-started +ms.topic: get-started --- # Get started with C++ Build Insights diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md b/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md index 290d7e82754..808cbe77a62 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md @@ -3,6 +3,7 @@ title: "Thread class" description: "The C++ Build Insights SDK Thread class reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "Thread", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: how-to --- # Thread class diff --git a/docs/build-insights/reference/sdk/other-types/analysis-callbacks-struct.md b/docs/build-insights/reference/sdk/other-types/analysis-callbacks-struct.md index 2957df07f10..348969f6fd6 100644 --- a/docs/build-insights/reference/sdk/other-types/analysis-callbacks-struct.md +++ b/docs/build-insights/reference/sdk/other-types/analysis-callbacks-struct.md @@ -3,6 +3,7 @@ title: "ANALYSIS_CALLBACKS structure" description: "The C++ Build Insights SDK ANALYSIS_CALLBACKS structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "ANALYSIS_CALLBACKS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # ANALYSIS_CALLBACKS structure diff --git a/docs/build-insights/reference/sdk/other-types/analysis-descriptor-struct.md b/docs/build-insights/reference/sdk/other-types/analysis-descriptor-struct.md index 73012b0d9ac..d18e384ca27 100644 --- a/docs/build-insights/reference/sdk/other-types/analysis-descriptor-struct.md +++ b/docs/build-insights/reference/sdk/other-types/analysis-descriptor-struct.md @@ -3,6 +3,7 @@ title: "ANALYSIS_DESCRIPTOR structure" description: "The C++ Build Insights SDK ANALYSIS_DESCRIPTOR structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "ANALYSIS_DESCRIPTOR", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # ANALYSIS_DESCRIPTOR structure diff --git a/docs/build-insights/reference/sdk/other-types/callback-code-enum.md b/docs/build-insights/reference/sdk/other-types/callback-code-enum.md index 157b5e45345..85cbc687ae1 100644 --- a/docs/build-insights/reference/sdk/other-types/callback-code-enum.md +++ b/docs/build-insights/reference/sdk/other-types/callback-code-enum.md @@ -3,6 +3,7 @@ title: "CALLBACK_CODE enum" description: "The C++ Build Insights SDK CALLBACK_CODE enum reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "CALLBACK_CODE", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # CALLBACK_CODE enum diff --git a/docs/build-insights/reference/sdk/other-types/relog-callbacks-struct.md b/docs/build-insights/reference/sdk/other-types/relog-callbacks-struct.md index 4232ac43f4a..d3173d03ac4 100644 --- a/docs/build-insights/reference/sdk/other-types/relog-callbacks-struct.md +++ b/docs/build-insights/reference/sdk/other-types/relog-callbacks-struct.md @@ -3,6 +3,7 @@ title: "RELOG_CALLBACKS structure" description: "The C++ Build Insights SDK RELOG_CALLBACKS structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RELOG_CALLBACKS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # RELOG_CALLBACKS structure diff --git a/docs/build-insights/reference/sdk/other-types/relog-descriptor-struct.md b/docs/build-insights/reference/sdk/other-types/relog-descriptor-struct.md index 756616dbbc5..36fa65c7679 100644 --- a/docs/build-insights/reference/sdk/other-types/relog-descriptor-struct.md +++ b/docs/build-insights/reference/sdk/other-types/relog-descriptor-struct.md @@ -3,6 +3,7 @@ title: "RELOG_DESCRIPTOR structure" description: "The C++ Build Insights SDK RELOG_DESCRIPTOR structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RELOG_DESCRIPTOR", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # RELOG_DESCRIPTOR structure diff --git a/docs/build-insights/reference/sdk/other-types/relog-retention-system-event-flags-constants.md b/docs/build-insights/reference/sdk/other-types/relog-retention-system-event-flags-constants.md index 103d7f456bc..c82f194f460 100644 --- a/docs/build-insights/reference/sdk/other-types/relog-retention-system-event-flags-constants.md +++ b/docs/build-insights/reference/sdk/other-types/relog-retention-system-event-flags-constants.md @@ -3,6 +3,7 @@ title: "RELOG_RETENTION_SYSTEM_EVENT_FLAGS constants" description: "The C++ Build Insights SDK RELOG_RETENTION_SYSTEM_EVENT_FLAGS constants reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RELOG_RETENTION_SYSTEM_EVENT_FLAGS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # RELOG_RETENTION_SYSTEM_EVENT_FLAGS constants diff --git a/docs/build-insights/reference/sdk/other-types/result-code-enum.md b/docs/build-insights/reference/sdk/other-types/result-code-enum.md index 6cc9ba32d44..d6ac44cca2b 100644 --- a/docs/build-insights/reference/sdk/other-types/result-code-enum.md +++ b/docs/build-insights/reference/sdk/other-types/result-code-enum.md @@ -3,6 +3,7 @@ title: "RESULT_CODE enum" description: "The C++ Build Insights SDK RESULT_CODE enum reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RESULT_CODE", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # RESULT_CODE enum diff --git a/docs/build-insights/reference/sdk/other-types/tracing-session-msvc-event-flags-constants.md b/docs/build-insights/reference/sdk/other-types/tracing-session-msvc-event-flags-constants.md index f54881ad7f1..5bc47f3b439 100644 --- a/docs/build-insights/reference/sdk/other-types/tracing-session-msvc-event-flags-constants.md +++ b/docs/build-insights/reference/sdk/other-types/tracing-session-msvc-event-flags-constants.md @@ -3,6 +3,7 @@ title: "TRACING_SESSION_MSVC_EVENT_FLAGS constants" description: "The C++ Build Insights SDK TRACING_SESSION_MSVC_EVENT_FLAGS constants reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_MSVC_EVENT_FLAGS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # TRACING_SESSION_MSVC_EVENT_FLAGS constants diff --git a/docs/build-insights/reference/sdk/other-types/tracing-session-options-struct.md b/docs/build-insights/reference/sdk/other-types/tracing-session-options-struct.md index 88116edfe19..f087e51bf38 100644 --- a/docs/build-insights/reference/sdk/other-types/tracing-session-options-struct.md +++ b/docs/build-insights/reference/sdk/other-types/tracing-session-options-struct.md @@ -3,6 +3,7 @@ title: "TRACING_SESSION_OPTIONS structure" description: "Learn about the C++ Build Insights SDK TRACING_SESSION_OPTIONS structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_OPTIONS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # TRACING_SESSION_OPTIONS structure diff --git a/docs/build-insights/reference/sdk/other-types/tracing-session-statistics-struct.md b/docs/build-insights/reference/sdk/other-types/tracing-session-statistics-struct.md index 67374d0acfe..80b32daa9d1 100644 --- a/docs/build-insights/reference/sdk/other-types/tracing-session-statistics-struct.md +++ b/docs/build-insights/reference/sdk/other-types/tracing-session-statistics-struct.md @@ -3,6 +3,7 @@ title: "TRACING_SESSION_STATISTICS structure" description: "Learn about the C++ Build Insights SDK TRACING_SESSION_STATISTICS structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_STATISTICS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # TRACING_SESSION_STATISTICS structure diff --git a/docs/build-insights/reference/sdk/other-types/tracing-session-system-event-flags-constants.md b/docs/build-insights/reference/sdk/other-types/tracing-session-system-event-flags-constants.md index 4e24aea5d9b..129d27038f3 100644 --- a/docs/build-insights/reference/sdk/other-types/tracing-session-system-event-flags-constants.md +++ b/docs/build-insights/reference/sdk/other-types/tracing-session-system-event-flags-constants.md @@ -3,6 +3,7 @@ title: "TRACING_SESSION_SYSTEM_EVENT_FLAGS constants" description: "The C++ Build Insights SDK TRACING_SESSION_SYSTEM_EVENT_FLAGS constants reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_SYSTEM_EVENT_FLAGS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # TRACING_SESSION_SYSTEM_EVENT_FLAGS constants diff --git a/docs/build-insights/tutorials/build-insights-function-view.md b/docs/build-insights/tutorials/build-insights-function-view.md index 598ea77cf21..6b78c38d12e 100644 --- a/docs/build-insights/tutorials/build-insights-function-view.md +++ b/docs/build-insights/tutorials/build-insights-function-view.md @@ -3,6 +3,7 @@ title: "Troubleshoot function inlining on build time" description: "Tutorial for how to use Build Insights function view to troubleshoot the impact of function inlining on build time in your C++ projects." ms.date: 5/30/2024 helpviewer_keywords: ["C++ Build Insights", "inline function analysis", "build time analysis", "__forceinline analysis", "inlines analysis"] +ms.topic: troubleshooting-general --- # Troubleshoot function inlining on build time diff --git a/docs/build-insights/tutorials/build-insights-included-files-view.md b/docs/build-insights/tutorials/build-insights-included-files-view.md index 3563f96d718..e6a4991c2dc 100644 --- a/docs/build-insights/tutorials/build-insights-included-files-view.md +++ b/docs/build-insights/tutorials/build-insights-included-files-view.md @@ -3,6 +3,7 @@ title: "Troubleshoot header file impact on build time" description: "Tutorial on how to use Build Insights Includes Files and Includes Tree views to troubleshoot the impact of #include files on build time." ms.date: 5/30/2024 helpviewer_keywords: ["C++ Build Insights", "header file build time", "included files view", "include tree view", "#include analysis", "build time analysis"] +ms.topic: troubleshooting-general --- # Troubleshoot header file impact on build time @@ -185,4 +186,4 @@ Or, you can right-click a file in the **Include Tree** view to jump to it in the [Build Insights in Visual Studio video - Pure Virtual C++ 2023](/events/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ [Faster C++ builds, simplified: a new metric for time](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time)\ [Troubleshoot function inlining on build time](build-insights-function-view.md)\ -[vcperf and Windows Performance Analyzer](vcperf-and-wpa.md) \ No newline at end of file +[vcperf and Windows Performance Analyzer](vcperf-and-wpa.md) diff --git a/docs/build-insights/tutorials/vcperf-and-wpa.md b/docs/build-insights/tutorials/vcperf-and-wpa.md index e4bf41a1e1e..0b8b278a8aa 100644 --- a/docs/build-insights/tutorials/vcperf-and-wpa.md +++ b/docs/build-insights/tutorials/vcperf-and-wpa.md @@ -3,6 +3,7 @@ title: "Tutorial: vcperf and Windows Performance Analyzer" description: "Tutorial on how to use vcperf and WPA for analyzing C++ build traces." ms.date: "11/03/2019" helpviewer_keywords: ["C++ Build Insights", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: tutorial --- # Tutorial: vcperf and Windows Performance Analyzer diff --git a/docs/build-insights/tutorials/wpa-basics.md b/docs/build-insights/tutorials/wpa-basics.md index 9ac76d830c9..35ad6fe727b 100644 --- a/docs/build-insights/tutorials/wpa-basics.md +++ b/docs/build-insights/tutorials/wpa-basics.md @@ -3,6 +3,7 @@ title: "Tutorial: Windows Performance Analyzer basics" description: "Tutorial on how to complete basic operations in Windows Performance Analyzer." ms.date: "11/03/2019" helpviewer_keywords: ["C++ Build Insights", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: tutorial --- # Tutorial: Windows Performance Analyzer basics diff --git a/docs/build/adding-references-in-visual-cpp-projects.md b/docs/build/adding-references-in-visual-cpp-projects.md index 17676d6d6b6..41de401156b 100644 --- a/docs/build/adding-references-in-visual-cpp-projects.md +++ b/docs/build/adding-references-in-visual-cpp-projects.md @@ -4,6 +4,7 @@ title: "Consuming libraries and components in C++ projects" ms.date: 12/18/2020 f1_keywords: ["VC.Project.References"] helpviewer_keywords: ["Add References Dialog Box (C++)", ".NET Framework (C++), Add References Dialog Box"] +ms.topic: how-to --- # Consuming libraries and components diff --git a/docs/build/arm-exception-handling.md b/docs/build/arm-exception-handling.md index f2f9b9a13e6..de257cc65fd 100644 --- a/docs/build/arm-exception-handling.md +++ b/docs/build/arm-exception-handling.md @@ -3,6 +3,7 @@ description: "Learn more about: ARM Exception Handling" title: "ARM Exception Handling" ms.date: 12/15/2021 ms.assetid: fe0e615f-c033-4ad5-97f4-ff96af45b201 +ms.topic: how-to --- # ARM Exception Handling diff --git a/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md b/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md index 6d15a9df762..01183ef9898 100644 --- a/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md +++ b/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md @@ -4,6 +4,7 @@ title: "Building C/C++ Isolated Applications and Side-by-side Assemblies" ms.date: "05/06/2019" helpviewer_keywords: ["isolated applications [C++]", "WinSxS [C++]", "native assembly cache [C++]", "builds [C++], isolated applications", "side-by-side applications [C++]", "builds [C++], side-by-side assemblies"] ms.assetid: 9465904e-76f7-48bd-bb3f-c55d8f1699b6 +ms.topic: concept-article --- # Building C/C++ Isolated Applications and Side-by-side Assemblies diff --git a/docs/build/building-c-cpp-isolated-applications.md b/docs/build/building-c-cpp-isolated-applications.md index 6494e2dd386..8724e842f8c 100644 --- a/docs/build/building-c-cpp-isolated-applications.md +++ b/docs/build/building-c-cpp-isolated-applications.md @@ -4,6 +4,7 @@ title: "Building C/C++ Isolated Applications" ms.date: "05/06/2019" helpviewer_keywords: ["isolated applications [C++]"] ms.assetid: 8a2fe4fa-0489-433e-bfc6-495844d8d73a +ms.topic: concept-article --- # Building C/C++ Isolated Applications diff --git a/docs/build/building-c-cpp-side-by-side-assemblies.md b/docs/build/building-c-cpp-side-by-side-assemblies.md index 615b2c1d3bb..29478d8b6ed 100644 --- a/docs/build/building-c-cpp-side-by-side-assemblies.md +++ b/docs/build/building-c-cpp-side-by-side-assemblies.md @@ -4,6 +4,7 @@ title: "Building C/C++ Side-by-side Assemblies" ms.date: "11/04/2016" helpviewer_keywords: ["side-by-side applications [C++]"] ms.assetid: 7fa20b16-3737-4f76-a0b5-1dacea19a1e8 +ms.topic: concept-article --- # Building C/C++ Side-by-side Assemblies diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index 06332dd5235..7b4a452f29b 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -5,6 +5,7 @@ ms.custom: "conceptual" ms.date: 04/07/2022 helpviewer_keywords: ["command-line builds [C++]", "compiling source code [C++], command line", "builds [C++], command-line", "command line [C++], building from", "command line [C++], compilers"] ms.assetid: 7ca9daed-a003-4162-842d-908f79058365 +ms.topic: how-to --- # Use the Microsoft C++ toolset from the command line diff --git a/docs/build/calling-dll-functions-from-visual-basic-applications.md b/docs/build/calling-dll-functions-from-visual-basic-applications.md index bf6850d0f5b..38bcce3a900 100644 --- a/docs/build/calling-dll-functions-from-visual-basic-applications.md +++ b/docs/build/calling-dll-functions-from-visual-basic-applications.md @@ -4,6 +4,7 @@ title: "Calling DLL Functions from Visual Basic Applications" ms.date: "11/04/2016" helpviewer_keywords: ["functions [C++], calling DLL functions from Visual Basic", "DLL functions [C++]", "function calls [C++], DLL functions", "DLLs [C++], calling", "calling DLL functions from VB applications [C++]", "__stdcall keyword [C++]", "DLL functions [C++], calling"] ms.assetid: 282f7fbf-a0f2-4b9f-b277-1982710be56c +ms.topic: concept-article --- # Calling DLL Functions from Visual Basic Applications diff --git a/docs/build/checking-for-memory-overwrites.md b/docs/build/checking-for-memory-overwrites.md index 786540319e2..5c8869aca10 100644 --- a/docs/build/checking-for-memory-overwrites.md +++ b/docs/build/checking-for-memory-overwrites.md @@ -4,6 +4,7 @@ title: "Checking for Memory Overwrites" ms.date: "11/04/2016" helpviewer_keywords: ["memory, overwrites"] ms.assetid: da7c5d77-a267-415f-a8ab-ee5ce5bfc286 +ms.topic: concept-article --- # Checking for Memory Overwrites diff --git a/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md b/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md index 7b3b78360bf..ef50625ae8d 100644 --- a/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md +++ b/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md @@ -4,6 +4,7 @@ title: "Concepts of Isolated Applications and Side-by-side Assemblies" ms.date: "05/06/2019" helpviewer_keywords: ["side-by-side assemblies [C++]", "isolated assemblies [C++]"] ms.assetid: 945a885f-cb3e-4c8a-a0b9-2c2e3e02cc50 +ms.topic: concept-article --- # Concepts of Isolated Applications and Side-by-side Assemblies diff --git a/docs/build/configure-cmake-debugging-sessions.md b/docs/build/configure-cmake-debugging-sessions.md index 896d5a3bf43..a16c9e0f9b8 100644 --- a/docs/build/configure-cmake-debugging-sessions.md +++ b/docs/build/configure-cmake-debugging-sessions.md @@ -3,6 +3,7 @@ title: "Configure CMake debugging sessions in Visual Studio" description: "Describes how to use Visual Studio to configure CMake debugger settings." ms.date: 10/26/2023 helpviewer_keywords: ["CMake debugging"] +ms.topic: how-to --- # Configure CMake debugging sessions diff --git a/docs/build/configuring-programs-for-windows-xp.md b/docs/build/configuring-programs-for-windows-xp.md index 3e96c4f48ed..629e6b7230e 100644 --- a/docs/build/configuring-programs-for-windows-xp.md +++ b/docs/build/configuring-programs-for-windows-xp.md @@ -3,6 +3,7 @@ title: "Configuring Programs for Windows XP" description: "How to install and use the C++ Windows XP toolsets in Visual Studio." ms.date: 09/17/2021 ms.assetid: 1e4487b3-d815-4123-878b-5718b22f0fd5 +ms.topic: how-to --- # Configuring Programs for Windows XP diff --git a/docs/build/create-reusable-property-configurations.md b/docs/build/create-reusable-property-configurations.md index d046426504a..52af28e0f40 100644 --- a/docs/build/create-reusable-property-configurations.md +++ b/docs/build/create-reusable-property-configurations.md @@ -3,6 +3,7 @@ description: "Learn more about: Share or reuse Visual Studio project settings" title: "Share or reuse Visual Studio project settings - C++" ms.date: 02/07/2022 helpviewer_keywords: ["project properties [C++], reusable"] +ms.topic: how-to --- # Share or reuse Visual Studio project settings diff --git a/docs/build/creating-a-resource-only-dll.md b/docs/build/creating-a-resource-only-dll.md index e054108b83b..664e45250de 100644 --- a/docs/build/creating-a-resource-only-dll.md +++ b/docs/build/creating-a-resource-only-dll.md @@ -5,6 +5,7 @@ ms.date: "01/27/2020" helpviewer_keywords: ["resource-only DLLs [C++], creating", "DLLs [C++], creating"] ms.assetid: e6b1d4da-7275-467f-a58c-a0a8a5835199 no-loc: [noentry] +ms.topic: how-to --- # Creating a resource-only DLL diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index 3ccdd13da63..6b56804360f 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -3,6 +3,7 @@ description: "Learn more about: Customize CMake build settings" title: "Customize CMake build settings in Visual Studio" ms.date: 12/15/2021 helpviewer_keywords: ["CMake build settings"] +ms.topic: how-to --- # Customize CMake build settings diff --git a/docs/build/exporting-and-importing-using-afx-ext-class.md b/docs/build/exporting-and-importing-using-afx-ext-class.md index 0d16f63d7b8..e47b06663e8 100644 --- a/docs/build/exporting-and-importing-using-afx-ext-class.md +++ b/docs/build/exporting-and-importing-using-afx-ext-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["afx_ext_class"] helpviewer_keywords: ["AFX_EXT_CLASS macro", "exporting classes [C++]", "importing DLLs [C++]", "extension DLLs [C++], exporting classes", "executable files [C++], importing classes", "exporting DLLs [C++], AFX_EXT_CLASS macro"] ms.assetid: 6b72cb2b-e92e-4ecd-bcab-c335e1d1cfde +ms.topic: concept-article --- # Exporting and Importing Using AFX_EXT_CLASS diff --git a/docs/build/exporting-c-functions-for-use-in-c-or-cpp-language-executables.md b/docs/build/exporting-c-functions-for-use-in-c-or-cpp-language-executables.md index 2386881514b..4096be3e6e2 100644 --- a/docs/build/exporting-c-functions-for-use-in-c-or-cpp-language-executables.md +++ b/docs/build/exporting-c-functions-for-use-in-c-or-cpp-language-executables.md @@ -4,6 +4,7 @@ title: "Export C functions for use in C or C++ language executables" ms.date: 05/24/2022 helpviewer_keywords: ["functions [C], exporting", "functions [C], C or C++ executables and", "__cplusplus macro", "exporting DLLs [C++], C functions in C++ executables", "exporting functions [C++], C functions in C++ executables"] ms.assetid: b51d6e5e-37cf-4c1c-b0bf-fcf188c82f00 +ms.topic: how-to --- # Export C functions for use in C or C++ language executables diff --git a/docs/build/exporting-cpp-functions-for-use-in-c-language-executables.md b/docs/build/exporting-cpp-functions-for-use-in-c-language-executables.md index decb3fd8916..d44fe579a36 100644 --- a/docs/build/exporting-cpp-functions-for-use-in-c-language-executables.md +++ b/docs/build/exporting-cpp-functions-for-use-in-c-language-executables.md @@ -4,6 +4,7 @@ title: "Exporting C++ Functions for Use in C-Language Executables" ms.date: "11/04/2016" helpviewer_keywords: ["functions [C++], C++ functions in C executables", "exporting DLLs [C++], C++ functions in C executables", "exporting functions [C++], C++ functions in C executables", "functions [C++], exporting"] ms.assetid: 80b9e982-f52d-4312-a891-f73cc69f3c2b +ms.topic: concept-article --- # Exporting C++ Functions for Use in C-Language Executables diff --git a/docs/build/exporting-from-a-dll-using-declspec-dllexport.md b/docs/build/exporting-from-a-dll-using-declspec-dllexport.md index 46f17afc299..e0245f46d08 100644 --- a/docs/build/exporting-from-a-dll-using-declspec-dllexport.md +++ b/docs/build/exporting-from-a-dll-using-declspec-dllexport.md @@ -5,6 +5,7 @@ ms.date: "05/06/2019" f1_keywords: ["dllexport"] helpviewer_keywords: ["__declspec(dllexport) keyword [C++]", "names [C++], DLL exports by", "export directives [C++]", "exporting DLLs [C++], __declspec(dllexport) keyword"] ms.assetid: a35e25e8-7263-4a04-bad4-00b284458679 +ms.topic: concept-article --- # Exporting from a DLL Using __declspec(dllexport) diff --git a/docs/build/exporting-from-a-dll-using-def-files.md b/docs/build/exporting-from-a-dll-using-def-files.md index c0cabdb87a1..ce1b224eede 100644 --- a/docs/build/exporting-from-a-dll-using-def-files.md +++ b/docs/build/exporting-from-a-dll-using-def-files.md @@ -4,6 +4,7 @@ title: "Exporting from a DLL Using DEF Files" ms.date: "05/06/2019" helpviewer_keywords: ["def files [C++], exporting from DLLs", ".def files [C++], exporting from DLLs", "exporting DLLs [C++], DEF files"] ms.assetid: 9d31eda2-184e-47de-a2ee-a93ebd603f8e +ms.topic: concept-article --- # Exporting from a DLL Using DEF Files diff --git a/docs/build/exporting-from-a-dll.md b/docs/build/exporting-from-a-dll.md index b05991ac322..d7513fc4776 100644 --- a/docs/build/exporting-from-a-dll.md +++ b/docs/build/exporting-from-a-dll.md @@ -4,6 +4,7 @@ title: "Exporting from a DLL" ms.date: "11/04/2016" helpviewer_keywords: ["exporting DLLs [C++], about exporting from DLLs", "exporting functions [C++], DLLs (exporting from)", "exporting DLLs [C++]", "DLLs [C++], exporting from", "DLL exports [C++]", "functions [C++], exporting", "exports table [C++]"] ms.assetid: a08f86c4-5996-460b-ae54-da2b764045f0 +ms.topic: concept-article --- # Exporting from a DLL diff --git a/docs/build/exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md b/docs/build/exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md index 1a3e10eeaeb..d5911954fb9 100644 --- a/docs/build/exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md +++ b/docs/build/exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md @@ -4,6 +4,7 @@ title: "Exporting Functions from a DLL by Ordinal Rather Than by Name" ms.date: "11/04/2016" helpviewer_keywords: ["exporting functions [C++], ordinal values", "ordinal exports [C++]", "exporting DLLs [C++], ordinal values", "NONAME attribute"] ms.assetid: 679719fd-d965-4df3-9f7a-7d86ad831702 +ms.topic: concept-article --- # Exporting Functions from a DLL by Ordinal Rather Than by Name diff --git a/docs/build/extension-dlls-overview.md b/docs/build/extension-dlls-overview.md index 9efaa880faa..b43f909510c 100644 --- a/docs/build/extension-dlls-overview.md +++ b/docs/build/extension-dlls-overview.md @@ -4,6 +4,7 @@ title: "Extension DLLs: Overview" ms.date: "05/06/2019" helpviewer_keywords: ["AFXDLL library", "MFC DLLs [C++], MFC extension DLLs", "DLLs [C++], extension", "shared DLL versions [C++]", "extension DLLs [C++], about MFC extension DLLs"] ms.assetid: eb5e10b7-d615-4bc7-908d-e3e99b7b1d5f +ms.topic: concept-article --- # MFC extension DLLs: Overview diff --git a/docs/build/fixing-release-build-problems.md b/docs/build/fixing-release-build-problems.md index b329363dc97..f10be40f3e4 100644 --- a/docs/build/fixing-release-build-problems.md +++ b/docs/build/fixing-release-build-problems.md @@ -4,6 +4,7 @@ title: "Fixing Release Build Problems" ms.date: "11/04/2016" helpviewer_keywords: ["release builds, troubleshooting", "debug builds, memory overwrites", "memory, overwrites", "troubleshooting Visual C++, release builds", "troubleshooting release builds"] ms.assetid: a0c0818e-4c47-4fe0-a611-50d61a41bd88 +ms.topic: concept-article --- # Fixing Release Build Problems diff --git a/docs/build/formatting-the-output-of-a-custom-build-step-or-build-event.md b/docs/build/formatting-the-output-of-a-custom-build-step-or-build-event.md index 938dc064259..b8c2ff6f181 100644 --- a/docs/build/formatting-the-output-of-a-custom-build-step-or-build-event.md +++ b/docs/build/formatting-the-output-of-a-custom-build-step-or-build-event.md @@ -4,6 +4,7 @@ title: "Formatting the output of a custom build step or build event" ms.date: 03/15/2022 helpviewer_keywords: ["builds [C++], build events", "custom build steps [C++], output format", "events [C++], build", "build events [C++], output format", "build steps [C++], output format", "builds [C++], custom build steps"] ms.assetid: 92ad3e38-24d7-4b89-90e6-5a16f5f998da +ms.topic: concept-article --- # Formatting the output of a custom build step or build event diff --git a/docs/build/importing-and-exporting-inline-functions.md b/docs/build/importing-and-exporting-inline-functions.md index ec71f01e74a..c34b0859a15 100644 --- a/docs/build/importing-and-exporting-inline-functions.md +++ b/docs/build/importing-and-exporting-inline-functions.md @@ -4,6 +4,7 @@ title: "Importing and exporting inline functions" ms.date: "11/04/2016" helpviewer_keywords: ["exporting functions [C++], inline functions", "inline functions [C++], importing", "DLLs [C++], importing", "importing functions [C++]", "DLLs [C++], exporting from", "importing inline functions [C++]", "inline functions [C++], exporting", "functions [C++], importing", "functions [C++], exporting"] ms.assetid: 89f488f8-b078-40fe-afd7-80bd7840057b +ms.topic: concept-article --- # Importing and exporting inline functions diff --git a/docs/build/importing-and-exporting.md b/docs/build/importing-and-exporting.md index 322232d23b8..87ecffe0203 100644 --- a/docs/build/importing-and-exporting.md +++ b/docs/build/importing-and-exporting.md @@ -4,6 +4,7 @@ title: "Importing and Exporting" ms.date: "05/06/2019" helpviewer_keywords: ["DLLs [C++], importing", "exporting DLLs [C++]", "importing DLLs [C++]", "DLLs [C++], exporting from", "__declspec(dllimport) keyword [C++]"] ms.assetid: 7c44c2aa-2117-4cec-9615-a65bfd3f8f7b +ms.topic: concept-article --- # Importing and Exporting diff --git a/docs/build/importing-data-using-declspec-dllimport.md b/docs/build/importing-data-using-declspec-dllimport.md index bfe281afe38..eeec7bf2ffe 100644 --- a/docs/build/importing-data-using-declspec-dllimport.md +++ b/docs/build/importing-data-using-declspec-dllimport.md @@ -4,6 +4,7 @@ description: "How to use __declspec(dllimport) to import DLL data." ms.date: 09/03/2020 helpviewer_keywords: ["importing data [C++]", "dllimport attribute [C++], data imports", "__declspec(dllimport) keyword [C++]", "importing DLLs [C++], __declspec(dllimport)"] ms.assetid: 0ae70b39-87c7-4181-8be9-e786e0db60b0 +ms.topic: concept-article --- # Importing data using `__declspec(dllimport)` diff --git a/docs/build/importing-function-calls-using-declspec-dllimport.md b/docs/build/importing-function-calls-using-declspec-dllimport.md index e275b0ec866..4d4472780a7 100644 --- a/docs/build/importing-function-calls-using-declspec-dllimport.md +++ b/docs/build/importing-function-calls-using-declspec-dllimport.md @@ -4,6 +4,7 @@ description: "How and why to use __declspec(dllimport) when calling DLL data and ms.date: "05/03/2020" helpviewer_keywords: ["importing function calls [C++]", "dllimport attribute [C++], function call imports", "__declspec(dllimport) keyword [C++]", "function calls [C++], importing"] ms.assetid: 6b53c616-0c6d-419a-8e2a-d2fff20510b3 +ms.topic: concept-article --- # Importing function calls using `__declspec(dllimport)` diff --git a/docs/build/importing-into-an-application-using-declspec-dllimport.md b/docs/build/importing-into-an-application-using-declspec-dllimport.md index 7b8247460ee..c50718d79d0 100644 --- a/docs/build/importing-into-an-application-using-declspec-dllimport.md +++ b/docs/build/importing-into-an-application-using-declspec-dllimport.md @@ -4,6 +4,7 @@ title: "Import into an application using __declspec(dllimport)" ms.date: "11/04/2016" helpviewer_keywords: ["__declspec(dllimport) keyword [C++]", "importing DLLs [C++], __declspec(dllimport)"] ms.assetid: edb4da4e-f83a-44cf-a668-9239d49dbe42 +ms.topic: how-to --- # Import into an application using __declspec(dllimport) diff --git a/docs/build/importing-into-an-application.md b/docs/build/importing-into-an-application.md index f2458e128f9..c944f53c123 100644 --- a/docs/build/importing-into-an-application.md +++ b/docs/build/importing-into-an-application.md @@ -4,6 +4,7 @@ title: "Importing into an Application" ms.date: "11/04/2016" helpviewer_keywords: ["DLLs [C++], importing", "importing DLLs [C++], applications", "applications [C++], importing into"] ms.assetid: 9d646466-e12e-4710-8ad9-c819c0375fcc +ms.topic: concept-article --- # Importing into an Application diff --git a/docs/build/importing-using-def-files.md b/docs/build/importing-using-def-files.md index e52767c7695..877708fe77e 100644 --- a/docs/build/importing-using-def-files.md +++ b/docs/build/importing-using-def-files.md @@ -4,6 +4,7 @@ title: "Importing Using DEF Files" ms.date: "11/04/2016" helpviewer_keywords: ["importing DLLs [C++], DEF files", "def files [C++], importing with", ".def files [C++], importing with", "dllimport attribute [C++], DEF files", "DLLs [C++], DEF files"] ms.assetid: aefdbf50-f603-488a-b0d7-ed737bae311d +ms.topic: concept-article --- # Importing Using DEF Files diff --git a/docs/build/improving-compiler-throughput.md b/docs/build/improving-compiler-throughput.md index c71675de078..3da2de62fc5 100644 --- a/docs/build/improving-compiler-throughput.md +++ b/docs/build/improving-compiler-throughput.md @@ -4,6 +4,7 @@ title: "Improving Compiler Throughput" ms.date: "11/04/2016" helpviewer_keywords: ["throughput, C++ compiler", "cl.exe compiler, performance", "performance, compiler", "cl.exe compiler, throughput"] ms.assetid: ba5f884e-9037-4a92-b10e-fc2a3836c5bf +ms.topic: concept-article --- # Improving Compiler Throughput diff --git a/docs/build/modify-project-properties-without-changing-project-file.md b/docs/build/modify-project-properties-without-changing-project-file.md index aebbc2c0f77..3cba0d0efad 100644 --- a/docs/build/modify-project-properties-without-changing-project-file.md +++ b/docs/build/modify-project-properties-without-changing-project-file.md @@ -3,6 +3,7 @@ description: "Learn more about: How to: Modify C++ project properties and target title: "How to: Modify C++ project properties and targets without changing the project file" ms.date: "7/28/2023" helpviewer_keywords: ["project properties [C++], modifying outside project file"] +ms.topic: how-to --- # How to: Modify C++ project properties and targets without changing the project file diff --git a/docs/build/non-mfc-dlls-overview.md b/docs/build/non-mfc-dlls-overview.md index f77fbcf3057..ff377f90b10 100644 --- a/docs/build/non-mfc-dlls-overview.md +++ b/docs/build/non-mfc-dlls-overview.md @@ -4,6 +4,7 @@ title: "Non-MFC DLLs: Overview" ms.date: "11/04/2016" helpviewer_keywords: ["non-MFC DLLs [C++]", "DLLs [C++], non-MFC"] ms.assetid: 1ed5d1ee-e20c-47d7-801d-87ea26a73842 +ms.topic: concept-article --- # Non-MFC DLLs: Overview diff --git a/docs/build/open-folder-projects-cpp.md b/docs/build/open-folder-projects-cpp.md index dff693a6320..37074ab63e8 100644 --- a/docs/build/open-folder-projects-cpp.md +++ b/docs/build/open-folder-projects-cpp.md @@ -4,6 +4,7 @@ title: "Open Folder support for C++ build systems in Visual Studio" ms.date: "12/02/2019" helpviewer_keywords: ["Open Folder Projects in Visual Studio"] ms.assetid: abd1985e-3717-4338-9e80-869db5435175 +ms.topic: how-to --- # Open Folder support for C++ build systems in Visual Studio diff --git a/docs/build/optimization-best-practices.md b/docs/build/optimization-best-practices.md index ce428f701b4..b0530ca07e9 100644 --- a/docs/build/optimization-best-practices.md +++ b/docs/build/optimization-best-practices.md @@ -4,6 +4,7 @@ title: "Optimization best practices" ms.date: "05/06/2019" helpviewer_keywords: ["C++, optimization", "optimization, best practices"] ms.assetid: f3433148-7255-4ca6-8a4f-7c31aac88508 +ms.topic: best-practice --- # Optimization best practices diff --git a/docs/build/optimizing-your-code.md b/docs/build/optimizing-your-code.md index a30267f3823..590f7b8faec 100644 --- a/docs/build/optimizing-your-code.md +++ b/docs/build/optimizing-your-code.md @@ -3,6 +3,7 @@ description: "Learn more about: Optimizing your code" title: "Optimizing Your Code" ms.date: "05/06/2019" helpviewer_keywords: ["performance, optimizing code", "optimization", "cl.exe compiler, performance", "optimization, C++ code", "code, optimizing", "performance, compiler"] +ms.topic: concept-article --- # Optimizing your code diff --git a/docs/build/specifying-build-events.md b/docs/build/specifying-build-events.md index 5490fb70902..25f79a10762 100644 --- a/docs/build/specifying-build-events.md +++ b/docs/build/specifying-build-events.md @@ -5,6 +5,7 @@ ms.date: "12/28/2017" f1_keywords: ["VC.Project.IVCEventTool.CommandLine", "VC.Project.IVCEventTool.ExcludedFromBuild", "VC.Project.IVCEventTool.Description"] helpviewer_keywords: ["Pre-Link event", "build events [C++], specifying", "custom build steps [C++], build events", "builds [C++], events", "events [C++], build", "builds [C++], customizing C++", "build events [C++]", "post-build events"] ms.assetid: 788a6c18-2dbe-4a49-8cd6-86c1ad7a95cc +ms.topic: how-to --- # Specifying build events diff --git a/docs/build/specifying-custom-build-tools.md b/docs/build/specifying-custom-build-tools.md index 197908e3e4a..251433fada8 100644 --- a/docs/build/specifying-custom-build-tools.md +++ b/docs/build/specifying-custom-build-tools.md @@ -4,6 +4,7 @@ title: "Specifying Custom Build Tools" ms.date: "06/05/2018" f1_keywords: ["VC.Project.VCCustomBuildTool.CustomBuildToolBeforeTargets", "VC.Project.VCCustomBuildTool.Outputs", "VC.Project.VCCustomBuildTool.Command", "VC.Project.VCCustomBuildTool.CommandLine", "VC.Project.VCCustomBuildTool.AdditionalDependencies", "VC.Project.VCCustomBuildTool.Message", "VC.Project.VCCustomBuildTool.CustomBuildToolAfterTargets", "VC.Project.VCCustomBuildTool.Description", "VC.Project.VCCustomBuildTool.AdditionalInputs"] helpviewer_keywords: ["build tools (C++), specifying", "custom build tools (C++), specifying", "builds (C++), custom build tools"] +ms.topic: how-to --- # Specify custom build tools diff --git a/docs/build/troubleshooting-build-customizations.md b/docs/build/troubleshooting-build-customizations.md index a7608815cf8..f97a61e9d37 100644 --- a/docs/build/troubleshooting-build-customizations.md +++ b/docs/build/troubleshooting-build-customizations.md @@ -4,6 +4,7 @@ title: "Troubleshooting Build Customizations" ms.date: "11/04/2016" helpviewer_keywords: ["build events [C++], troubleshooting", "builds [C++], build events", "troubleshooting [C++], builds", "build steps [C++], troubleshooting", "events [C++], build", "builds [C++], troubleshooting", "custom build steps [C++], troubleshooting"] ms.assetid: e4ceb177-fbee-4ed3-a7d7-80f0d78c1d07 +ms.topic: troubleshooting-general --- # Troubleshooting Build Customizations diff --git a/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md b/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md index cef9d627e62..e6b026bfbad 100644 --- a/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md +++ b/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md @@ -4,6 +4,7 @@ title: "Troubleshooting C/C++ Isolated Applications and Side-by-side Assemblies" ms.date: "11/04/2016" helpviewer_keywords: ["troubleshooting side-by-side assemblies", "troubleshooting isolated applications", "troubleshooting Visual C++"] ms.assetid: 3257257a-1f0b-4ede-8564-9277a7113a35 +ms.topic: troubleshooting-general --- # Troubleshooting C/C++ Isolated Applications and Side-by-side Assemblies diff --git a/docs/build/understanding-custom-build-steps-and-build-events.md b/docs/build/understanding-custom-build-steps-and-build-events.md index e468fb7224c..7827264c812 100644 --- a/docs/build/understanding-custom-build-steps-and-build-events.md +++ b/docs/build/understanding-custom-build-steps-and-build-events.md @@ -4,6 +4,7 @@ title: "Understanding Custom Build Steps and Build Events" ms.date: "08/29/2019" helpviewer_keywords: ["builds [C++], events", "custom build steps [C++], customizing builds", "events [C++], build", "custom build steps [C++]", "build steps [C++]", "build events [C++], order of events and build steps", "build steps [C++], build events", "builds [C++], custom build steps"] ms.assetid: beb2f017-3e9f-4b2c-9b57-2572fd2628e4 +ms.topic: how-to --- # Understanding Custom Build Steps and Build Events diff --git a/docs/build/understanding-manifest-generation-for-c-cpp-programs.md b/docs/build/understanding-manifest-generation-for-c-cpp-programs.md index 2735311ee36..c0bc39deb76 100644 --- a/docs/build/understanding-manifest-generation-for-c-cpp-programs.md +++ b/docs/build/understanding-manifest-generation-for-c-cpp-programs.md @@ -3,6 +3,7 @@ title: "Understanding manifest generation for C/C++ programs" description: "Learn more about: Understanding manifest generation for C/C++ programs" ms.date: 06/10/2022 helpviewer_keywords: ["manifests [C++]"] +ms.topic: how-to --- # Understanding manifest generation for C/C++ programs diff --git a/docs/build/using-database-ole-and-sockets-extension-dlls-in-regular-dlls.md b/docs/build/using-database-ole-and-sockets-extension-dlls-in-regular-dlls.md index 72f1bb24f21..08d3cbd88f5 100644 --- a/docs/build/using-database-ole-and-sockets-extension-dlls-in-regular-dlls.md +++ b/docs/build/using-database-ole-and-sockets-extension-dlls-in-regular-dlls.md @@ -3,6 +3,7 @@ title: "Using Database, OLE, and Sockets MFC extension DLLs in regular MFC DLLs" description: "Shows how to use the Database, OLE, and Sockets MFC extension DLLs in regular MFC DLLs." ms.date: 11/30/2020 helpviewer_keywords: ["DLLs [C++], initializing", "DLLs [C++], extension", "DLLs [C++], regular"] +ms.topic: concept-article --- # Using Database, OLE, and Sockets MFC extension DLLs in regular MFC DLLs diff --git a/docs/build/using-function-name-without-parens-produces-no-code.md b/docs/build/using-function-name-without-parens-produces-no-code.md index 29d218d3c2d..8b08e80798e 100644 --- a/docs/build/using-function-name-without-parens-produces-no-code.md +++ b/docs/build/using-function-name-without-parens-produces-no-code.md @@ -4,6 +4,7 @@ title: "Using Function Name Without () Produces No Code" ms.date: "11/04/2016" helpviewer_keywords: ["functions [C++], without parentheses"] ms.assetid: edf4a177-a160-44aa-8436-e077b5b27809 +ms.topic: concept-article --- # Using Function Name Without () Produces No Code diff --git a/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md b/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md index d7d94003455..5fb5fa5c707 100644 --- a/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md +++ b/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md @@ -4,6 +4,7 @@ title: "Using the Debug Build to Check for Memory Overwrite" ms.date: "11/04/2016" helpviewer_keywords: ["memory, overwrites"] ms.assetid: 1345eb4d-24ba-4595-b1cc-2da66986311e +ms.topic: concept-article --- # Using the Debug Build to Check for Memory Overwrite diff --git a/docs/build/using-verify-instead-of-assert.md b/docs/build/using-verify-instead-of-assert.md index 225a1f9d07f..f9e9350bc05 100644 --- a/docs/build/using-verify-instead-of-assert.md +++ b/docs/build/using-verify-instead-of-assert.md @@ -4,6 +4,7 @@ title: "Using VERIFY Instead of ASSERT" ms.date: "05/06/2019" helpviewer_keywords: ["ASSERT statements", "debugging [MFC], ASSERT statements", "VERIFY macro", "assertions, troubleshooting ASSERT statements", "debugging assertions", "assertions, debugging"] ms.assetid: 4c46397b-3fb1-49c1-a09b-41a72fae3797 +ms.topic: concept-article --- # Using VERIFY Instead of ASSERT diff --git a/docs/build/walkthrough-compile-a-c-program-on-the-command-line.md b/docs/build/walkthrough-compile-a-c-program-on-the-command-line.md index d8b15d2ed58..16e71d6fea8 100644 --- a/docs/build/walkthrough-compile-a-c-program-on-the-command-line.md +++ b/docs/build/walkthrough-compile-a-c-program-on-the-command-line.md @@ -5,6 +5,7 @@ ms.custom: tutorial ms.date: 03/17/2025 helpviewer_keywords: ["command-line applications [C++], C programs", "Visual C, compiling", "compiling programs [C++]", "C program compiling [C++]"] ms.assetid: 7e74cc2d-54b1-49de-b7ad-d3ae6b39ab8d +ms.topic: how-to --- # Walkthrough: Compile a C program on the command line diff --git a/docs/build/x64-software-conventions.md b/docs/build/x64-software-conventions.md index fe644a1aa5a..7f8229a5313 100644 --- a/docs/build/x64-software-conventions.md +++ b/docs/build/x64-software-conventions.md @@ -3,6 +3,7 @@ description: "Learn more about: x64 ABI conventions" title: "x64 ABI conventions" ms.date: 03/28/2025 helpviewer_keywords: ["x64 coding conventions", "x64 abi", "Visual C++, x64 calling conventions"] +ms.topic: concept-article --- # Overview of x64 ABI conventions diff --git a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md index bb6cc8a0cd8..57ef6e63903 100644 --- a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md +++ b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md @@ -2,6 +2,7 @@ description: "Learn more about: Build an OpenGL ES application on Android and iOS" title: "Build an OpenGL ES application on Android and iOS" ms.date: "06/09/2023" +ms.topic: how-to --- # Build an OpenGL ES application on Android and iOS diff --git a/docs/cross-platform/create-an-android-native-activity-app.md b/docs/cross-platform/create-an-android-native-activity-app.md index c8a88f33efc..d8741577f0b 100644 --- a/docs/cross-platform/create-an-android-native-activity-app.md +++ b/docs/cross-platform/create-an-android-native-activity-app.md @@ -3,6 +3,7 @@ description: "Learn more about: Create an Android Native Activity App" title: "Create an Android Native Activity App" ms.date: "10/17/2019" ms.assetid: 884014b1-5208-45ec-b0da-ad0070d2c24d +ms.topic: how-to --- # Create an Android Native Activity App diff --git a/docs/cross-platform/import-an-xcode-project.md b/docs/cross-platform/import-an-xcode-project.md index a536a9fc47d..b4bff9ac579 100644 --- a/docs/cross-platform/import-an-xcode-project.md +++ b/docs/cross-platform/import-an-xcode-project.md @@ -3,6 +3,7 @@ description: "Learn more about: Import an Xcode project" title: "Import an Xcode project" ms.date: "10/17/2019" ms.assetid: aa4b8161-d98f-4a1a-9db3-520133bfc82f +ms.topic: how-to --- # Import an Xcode project diff --git a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md index 84bc01c5895..65b0c66fcd0 100644 --- a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md +++ b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md @@ -4,6 +4,7 @@ title: "Install and configure tools to build using iOS" ms.date: 12/18/2022 ms.assetid: d0c311c9-9eb9-42c5-ba07-25604362cd28 ms.custom: intro-installation +ms.topic: install-set-up-deploy --- # Install and configure tools to build using iOS diff --git a/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md b/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md index 200c128cb34..08239a91208 100644 --- a/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md +++ b/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md @@ -3,6 +3,7 @@ description: "Learn more about: Install cross-platform mobile development with C title: "Install cross-platform mobile development with C++" ms.date: "10/17/2019" ms.custom: intro-installation +ms.topic: install-set-up-deploy --- # Install cross-platform mobile development with C++ diff --git a/docs/data/designing-and-creating-a-record-view-mfc-data-access.md b/docs/data/designing-and-creating-a-record-view-mfc-data-access.md index aa747752af9..535232a72f8 100644 --- a/docs/data/designing-and-creating-a-record-view-mfc-data-access.md +++ b/docs/data/designing-and-creating-a-record-view-mfc-data-access.md @@ -4,6 +4,7 @@ title: "Designing and Creating a Record View (MFC Data Access)" ms.date: "11/04/2016" helpviewer_keywords: ["designing forms", "record views, creating", "forms [C++], designing", "record views, designing", "application wizards [C++], creating record view classes", "designing record views"] ms.assetid: 1d6f5439-754f-4b8b-a19d-841a4657827b +ms.topic: how-to --- # Designing and Creating a Record View (MFC Data Access) diff --git a/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md b/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md index 78104b47fc8..0a6550067b6 100644 --- a/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md +++ b/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md @@ -4,6 +4,7 @@ title: "Filling a List Box from a Second Recordset (MFC Data Access)" ms.date: "11/04/2016" helpviewer_keywords: ["record views, filling list boxes", "list boxes, filling from second recordset", "recordsets [C++], filling list boxes or combo boxes", "CComboBox class, filling object from second rowset", "ODBC recordsets [C++], filling list boxes or combo boxes", "combo boxes [C++], filling from second recordset", "CListCtrl class, filling from second recordset"] ms.assetid: 360c0834-da6b-4dc0-bcea-80e9acd611f0 +ms.topic: how-to --- # Filling a List Box from a Second Recordset (MFC Data Access) diff --git a/docs/data/installing-database-support-mfc-atl.md b/docs/data/installing-database-support-mfc-atl.md index 047eee85fef..6a63eec21ef 100644 --- a/docs/data/installing-database-support-mfc-atl.md +++ b/docs/data/installing-database-support-mfc-atl.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["data access [C++], installing database support", "installing database support", "ATL [C++], database support", "databases [C++], installing database support"] ms.assetid: 3820ba96-4fb8-4405-83dd-bb3bc5998667 ms.custom: intro-installation +ms.topic: concept-article --- # Installing Database Support (MFC/ATL) diff --git a/docs/data/odbc/connecting-to-a-data-source.md b/docs/data/odbc/connecting-to-a-data-source.md index 18a727d5a83..52845dfa96b 100644 --- a/docs/data/odbc/connecting-to-a-data-source.md +++ b/docs/data/odbc/connecting-to-a-data-source.md @@ -4,6 +4,7 @@ title: "Connecting to a Data Source" ms.date: "11/04/2016" helpviewer_keywords: ["database connections [C++], ODBC", "ODBC connections [C++], using", "connections [C++], data source", "databases [C++], connecting to", "data sources [C++], connecting to", "ODBC data sources [C++], connections", "database connections [C++], MFC ODBC classes"] ms.assetid: ef6c8c98-5979-43a8-9fb5-5bb06fc59f36 +ms.topic: concept-article --- # Connecting to a Data Source diff --git a/docs/data/odbc/displaying-and-manipulating-data-in-a-form.md b/docs/data/odbc/displaying-and-manipulating-data-in-a-form.md index 46c6041841d..cf05784207f 100644 --- a/docs/data/odbc/displaying-and-manipulating-data-in-a-form.md +++ b/docs/data/odbc/displaying-and-manipulating-data-in-a-form.md @@ -4,6 +4,7 @@ title: "Displaying and Manipulating Data in a Form" ms.date: "11/04/2016" helpviewer_keywords: ["forms [C++], displaying data", "displaying data [C++], forms", "ODBC [C++], forms", "record views [C++], displaying data", "data [MFC]", "data [MFC], displaying in a form"] ms.assetid: c56185c4-12cb-40b1-b499-02b29ea83e3a +ms.topic: concept-article --- # Displaying and Manipulating Data in a Form diff --git a/docs/data/odbc/installing-and-getting-started-with-odbc.md b/docs/data/odbc/installing-and-getting-started-with-odbc.md index 6f358b59278..a62e8cab628 100644 --- a/docs/data/odbc/installing-and-getting-started-with-odbc.md +++ b/docs/data/odbc/installing-and-getting-started-with-odbc.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["installing ODBC", "ODBC, installing"] ms.assetid: 6b473481-1d68-468f-89f6-82b0fd7716fd ms.custom: intro-installation +ms.topic: get-started --- # Installing and Getting Started with ODBC diff --git a/docs/data/odbc/record-field-exchange-how-rfx-works.md b/docs/data/odbc/record-field-exchange-how-rfx-works.md index 1845d7f121e..67289c09033 100644 --- a/docs/data/odbc/record-field-exchange-how-rfx-works.md +++ b/docs/data/odbc/record-field-exchange-how-rfx-works.md @@ -4,6 +4,7 @@ title: "Record Field Exchange: How RFX Works" ms.date: "11/04/2016" helpviewer_keywords: ["record editing [C++], using RFX", "RFX (ODBC) [C++], updating data in recordsets", "scrolling [C++]", "ODBC [C++], RFX", "data binding [C++], DFX", "scrolling [C++], RFX", "RFX (ODBC) [C++], binding fields and parameters"] ms.assetid: e647cacd-62b0-4b80-9e20-b392deca5a88 +ms.topic: how-to --- # Record Field Exchange: How RFX Works diff --git a/docs/data/odbc/record-field-exchange-working-with-the-wizard-code.md b/docs/data/odbc/record-field-exchange-working-with-the-wizard-code.md index e4863b06c9f..40e4b98913b 100644 --- a/docs/data/odbc/record-field-exchange-working-with-the-wizard-code.md +++ b/docs/data/odbc/record-field-exchange-working-with-the-wizard-code.md @@ -4,6 +4,7 @@ title: "Record Field Exchange: Working with the Wizard Code" ms.date: "05/09/2019" helpviewer_keywords: ["DoFieldExchange method, overriding", "Unicode, with database classes", "field data members, declaring", "RFX (ODBC), wizard code", "RFX (ODBC), implementing", "field data members", "ODBC, RFX", "m_nParams data member, initializing", "m_nFields data member", "m_nParams data member", "overriding, DoFieldExchange", "m_nFields data member, initializing"] ms.assetid: f00d882a-ff1b-4a75-9717-98d8762bb237 +ms.topic: how-to --- # Record Field Exchange: Working with the Wizard Code diff --git a/docs/data/odbc/redistributing-odbc-components-to-your-customers.md b/docs/data/odbc/redistributing-odbc-components-to-your-customers.md index 96b7157adc5..35e7a61de99 100644 --- a/docs/data/odbc/redistributing-odbc-components-to-your-customers.md +++ b/docs/data/odbc/redistributing-odbc-components-to-your-customers.md @@ -4,6 +4,7 @@ title: "Redistributing ODBC Components to Your Customers" ms.date: "11/04/2016" helpviewer_keywords: ["ODBC components, redistributing", "ODBC, distributing components", "components [C++], distributing", "ODBC Administrator", "components [C++]", "components [C++], redistributing"] ms.assetid: 17b065b4-a307-4b89-99ac-d05831cfab87 +ms.topic: concept-article --- # Redistributing ODBC Components to Your Customers diff --git a/docs/data/odbc/selecting-and-manipulating-records.md b/docs/data/odbc/selecting-and-manipulating-records.md index c39755668cb..d8d3c06f787 100644 --- a/docs/data/odbc/selecting-and-manipulating-records.md +++ b/docs/data/odbc/selecting-and-manipulating-records.md @@ -4,6 +4,7 @@ title: "Selecting and Manipulating Records" ms.date: "05/09/2019" helpviewer_keywords: ["records, selecting", "record selection, MFC ODBC classes", "ODBC recordsets, selecting records"] ms.assetid: 7f0b3a4a-9941-4475-a612-9ec8d15b7691 +ms.topic: concept-article --- # Selecting and Manipulating Records diff --git a/docs/data/odbc/working-with-documents-and-views.md b/docs/data/odbc/working-with-documents-and-views.md index fd9339a4dff..d683432083b 100644 --- a/docs/data/odbc/working-with-documents-and-views.md +++ b/docs/data/odbc/working-with-documents-and-views.md @@ -4,6 +4,7 @@ title: "Working with Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["MFC [C++], documents", "MFC [C++], views", "views [C++], MFC", "documents [C++], MFC"] ms.assetid: 349b142d-1c5a-4b99-9de4-241e41d3d2f1 +ms.topic: concept-article --- # Working with Documents and Views diff --git a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md index df688530ed2..1a01df14c2c 100644 --- a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md +++ b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md @@ -4,6 +4,7 @@ title: "Supporting Navigation in a Record View (MFC Data Access)" ms.date: "11/04/2016" helpviewer_keywords: ["records [C++], navigating", "record views, navigation", "navigation [C++], in record view"] ms.assetid: 227f2a6d-87c9-4656-807a-8e246965bcce +ms.topic: concept-article --- # Supporting Navigation in a Record View (MFC Data Access) diff --git a/docs/data/using-a-record-view-mfc-data-access.md b/docs/data/using-a-record-view-mfc-data-access.md index 18724bc75b9..260f0f1ed98 100644 --- a/docs/data/using-a-record-view-mfc-data-access.md +++ b/docs/data/using-a-record-view-mfc-data-access.md @@ -4,6 +4,7 @@ title: "Using a Record View (MFC Data Access)" ms.date: "11/04/2016" helpviewer_keywords: ["record views, customizing default code"] ms.assetid: 91f2828f-0666-4273-ae28-e4703fd98521 +ms.topic: concept-article --- # Using a Record View (MFC Data Access) diff --git a/docs/dotnet/avoiding-exceptions-on-clr-shutdown-when-consuming-com-objects-built-with-clr.md b/docs/dotnet/avoiding-exceptions-on-clr-shutdown-when-consuming-com-objects-built-with-clr.md index 3959e713c67..bc10b85fb92 100644 --- a/docs/dotnet/avoiding-exceptions-on-clr-shutdown-when-consuming-com-objects-built-with-clr.md +++ b/docs/dotnet/avoiding-exceptions-on-clr-shutdown-when-consuming-com-objects-built-with-clr.md @@ -4,6 +4,7 @@ title: "Avoiding Exceptions thrown by COM Objects Built with -clr" ms.date: "11/04/2016" helpviewer_keywords: ["interop [C++], CLR shutdown exceptions", "/clr compiler option [C++], CLR shutdown exceptions", "mixed assemblies [C++], CLR shutdown exceptions", "/clr compiler option [C++], COM objects", "interoperability [C++], CLR shutdown exceptions", "CLR shutdown exceptions [C++]"] ms.assetid: 41249d83-4b51-4e46-866f-27f475f2498c +ms.topic: concept-article --- # Avoiding Exceptions on CLR Shutdown When Consuming COM Objects Built with /clr diff --git a/docs/dotnet/boxing-cpp-cli.md b/docs/dotnet/boxing-cpp-cli.md index e012f8806eb..f57d3ad8922 100644 --- a/docs/dotnet/boxing-cpp-cli.md +++ b/docs/dotnet/boxing-cpp-cli.md @@ -3,6 +3,7 @@ description: "Learn more about: Boxing (C++/CLI)" title: "Boxing (C++/CLI)" ms.date: "11/04/2016" ms.assetid: f4ee27a8-6a34-432d-b9ec-39285d513b23 +ms.topic: concept-article --- # Boxing (C++/CLI) diff --git a/docs/dotnet/calling-native-functions-from-managed-code.md b/docs/dotnet/calling-native-functions-from-managed-code.md index fd914a432a2..78930676f74 100644 --- a/docs/dotnet/calling-native-functions-from-managed-code.md +++ b/docs/dotnet/calling-native-functions-from-managed-code.md @@ -4,6 +4,7 @@ title: "Calling Native Functions from Managed Code" ms.date: "11/04/2016" helpviewer_keywords: ["native functions called from managed code [C++]", "managed code [C++], interoperability", "platform invoke [C++], interoperability", "interoperabiliy [C++], calling native functions from managed code", "calling native functions from managed code", "interop [C++], calling native functions from managed code"] ms.assetid: 982cef18-20d9-42b4-8242-a77fa65f2e36 +ms.topic: concept-article --- # Calling Native Functions from Managed Code diff --git a/docs/dotnet/converting-projects-from-mixed-mode-to-pure-intermediate-language.md b/docs/dotnet/converting-projects-from-mixed-mode-to-pure-intermediate-language.md index e035e617f92..4f62d8f01c8 100644 --- a/docs/dotnet/converting-projects-from-mixed-mode-to-pure-intermediate-language.md +++ b/docs/dotnet/converting-projects-from-mixed-mode-to-pure-intermediate-language.md @@ -3,6 +3,7 @@ description: "Learn more about: Converting projects from mixed mode to pure inte title: "Converting projects from mixed mode to pure intermediate language" ms.date: 04/15/2021 helpviewer_keywords: ["intermediate language, mixed-mode applications", "mixed-mode applications", "mixed-mode applications, intermediate language", "projects [C++], converting to intermediate language"] +ms.topic: how-to --- # Converting projects from mixed mode to pure intermediate language diff --git a/docs/dotnet/create-a-partially-trusted-application.md b/docs/dotnet/create-a-partially-trusted-application.md index 5e0a343494b..9d24f2ea685 100644 --- a/docs/dotnet/create-a-partially-trusted-application.md +++ b/docs/dotnet/create-a-partially-trusted-application.md @@ -5,6 +5,7 @@ ms.custom: "get-started-article" ms.date: "11/04/2016" helpviewer_keywords: ["partially trusted applications [C++]", "mixed assemblies [C++], partially trusted applications", "msvcm90[d].dll", "interoperability [C++], partially trusted applications", "interop [C++], partially trusted applications", "/clr compiler option [C++], partially trusted applications"] ms.assetid: 4760cd0c-4227-4f23-a7fb-d25b51bf246e +ms.topic: how-to --- # How to: Create a Partially Trusted Application by Removing Dependency on the CRT Library DLL diff --git a/docs/dotnet/debug-class-cpp-cli.md b/docs/dotnet/debug-class-cpp-cli.md index f4f8da1750b..5230757827e 100644 --- a/docs/dotnet/debug-class-cpp-cli.md +++ b/docs/dotnet/debug-class-cpp-cli.md @@ -4,6 +4,7 @@ title: "Debug Class (C++/CLI)" ms.date: "11/04/2016" helpviewer_keywords: ["Trace class, Visual C++", ".NET Framework [C++], Debug class", "Debug class"] ms.assetid: 076bd528-1b6f-4e8a-a372-eb5849cf969a +ms.topic: how-to --- # Debug Class (C++/CLI) diff --git a/docs/dotnet/double-thunking-cpp.md b/docs/dotnet/double-thunking-cpp.md index f8b13c40ff2..d634d7f17eb 100644 --- a/docs/dotnet/double-thunking-cpp.md +++ b/docs/dotnet/double-thunking-cpp.md @@ -4,6 +4,7 @@ title: "Double Thunking (C++)" ms.date: "11/04/2016" helpviewer_keywords: ["double thunks", "interop [C++], double thunking", "mixed assemblies [C++], double thunking", "/clr compiler option [C++], double thunking", "interoperability [C++], double thunking"] ms.assetid: a85090b2-dc3c-498a-b40c-340db229dd6f +ms.topic: how-to --- # Double Thunking (C++) diff --git a/docs/dotnet/file-handling-and-i-o-cpp-cli.md b/docs/dotnet/file-handling-and-i-o-cpp-cli.md index dba79da1ef8..b19777bddd1 100644 --- a/docs/dotnet/file-handling-and-i-o-cpp-cli.md +++ b/docs/dotnet/file-handling-and-i-o-cpp-cli.md @@ -4,6 +4,7 @@ title: "File Handling and I-O (C++/CLI)" ms.date: "11/04/2016" helpviewer_keywords: [".NET Framework [C++], file handling", "files [C++], .NET Framework and", "I/O [C++], .NET Framework applications", ".NET Framework [C++], I/O", "files [C++], listing files", "directories [C++], listing files", "monitoring file system events", "FileSystemWatcher class, examples", "examples [C++], monitoring file system changes", "events [C++], monitoring", "file system events [C++]", "files [C++], binary", "binary files, reading in C++", "reading text files", "text files, reading", "files [C++], retrieving information about", "FileInfo class", "binary files, writing in C++", "files [C++], binary", "files [C++], text", "text files, writing in C++"] ms.assetid: 3296fd59-a83a-40d4-bd4a-6096cc13101b +ms.topic: how-to --- # File Handling and I/O (C++/CLI) diff --git a/docs/dotnet/hosting-a-windows-form-user-control-as-an-mfc-dialog-box.md b/docs/dotnet/hosting-a-windows-form-user-control-as-an-mfc-dialog-box.md index de752c26f99..8c35fc41ed9 100644 --- a/docs/dotnet/hosting-a-windows-form-user-control-as-an-mfc-dialog-box.md +++ b/docs/dotnet/hosting-a-windows-form-user-control-as-an-mfc-dialog-box.md @@ -3,6 +3,7 @@ title: "Hosting a Windows Form User Control as an MFC Dialog Box" description: "Learn more about: Hosting a Windows Form User Control as an MFC Dialog Box" ms.date: 11/04/2016 helpviewer_keywords: ["MFC [C++], Windows Forms support", "Windows Forms [C++], hosting as MFC Dialog", "hosting Windows Forms control [C++]"] +ms.topic: how-to --- # Hosting a Windows Form User Control as an MFC Dialog Box diff --git a/docs/dotnet/hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md b/docs/dotnet/hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md index b7b889caf1a..9244b69d983 100644 --- a/docs/dotnet/hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md +++ b/docs/dotnet/hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md @@ -4,6 +4,7 @@ title: "Hosting a Windows Form User Control in an MFC Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["MFC [C++], Windows Forms support", "hosting Windows Forms control [C++]", "Windows Forms [C++], MFC support"] ms.assetid: 9f66ee52-b7cb-4ffd-8306-392a5da990d8 +ms.topic: concept-article --- # Hosting a Windows Form User Control in an MFC Dialog Box diff --git a/docs/dotnet/hosting-a-windows-forms-user-control-as-an-mfc-view.md b/docs/dotnet/hosting-a-windows-forms-user-control-as-an-mfc-view.md index e3968fb0fcd..7353bb36611 100644 --- a/docs/dotnet/hosting-a-windows-forms-user-control-as-an-mfc-view.md +++ b/docs/dotnet/hosting-a-windows-forms-user-control-as-an-mfc-view.md @@ -4,6 +4,7 @@ title: "Hosting a Windows Forms User Control as an MFC View" ms.date: "11/04/2016" helpviewer_keywords: ["MFC [C++], Windows Forms support", "Windows Forms controls [C++], hosting as an MFC view", "hosting Windows Forms control [C++]"] ms.assetid: 43c02ab4-1366-434c-a980-0b19326d6ea0 +ms.topic: concept-article --- # Hosting a Windows Forms User Control as an MFC View diff --git a/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md b/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md index bfed57f87c4..f85be0243ad 100644 --- a/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md +++ b/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md @@ -4,6 +4,7 @@ title: "How to: Define and Install a Global Exception Handler" ms.date: "11/04/2016" helpviewer_keywords: ["handlers, global"] ms.assetid: dd88a812-3bc7-4ce8-8283-4b674c246534 +ms.topic: install-set-up-deploy --- # How to: Define and Install a Global Exception Handler diff --git a/docs/dotnet/how-to-migrate-to-clr.md b/docs/dotnet/how-to-migrate-to-clr.md index b3e6d4c633d..f7b4922791c 100644 --- a/docs/dotnet/how-to-migrate-to-clr.md +++ b/docs/dotnet/how-to-migrate-to-clr.md @@ -5,6 +5,7 @@ ms.custom: "get-started-article" ms.date: "09/18/2018" helpviewer_keywords: ["upgrading Visual C++ applications, /clr compiler option", "compiling native code [C++]", "interoperability [C++], /clr compiler option", "interop [C++], /clr compiler option", "migration [C++], /clr compiler option", "/clr compiler option [C++], porting to"] ms.assetid: c9290b8b-436a-4510-8b56-eae51f4a9afc +ms.topic: upgrade-and-migration-article --- # How to: Migrate to `/clr` diff --git a/docs/dotnet/using-a-windows-form-user-control-in-mfc.md b/docs/dotnet/using-a-windows-form-user-control-in-mfc.md index d5c87478bdd..c5dc738dd4b 100644 --- a/docs/dotnet/using-a-windows-form-user-control-in-mfc.md +++ b/docs/dotnet/using-a-windows-form-user-control-in-mfc.md @@ -4,6 +4,7 @@ title: "Using a Windows Form User Control in MFC" ms.date: "01/08/2018" helpviewer_keywords: ["MFC [C++], Windows Forms support", "interoperability [C++], Windows Forms in MFC", "interoperability [C++], MFC", "interop [C++], Windows Forms in MFC", "interop [C++], MFC", "Windows Forms [C++], MFC support"] ms.assetid: 63fb099b-1dff-469c-9e34-dab52e122fcd +ms.topic: concept-article --- # Using a Windows Form User Control in MFC diff --git a/docs/dotnet/using-cpp-interop-implicit-pinvoke.md b/docs/dotnet/using-cpp-interop-implicit-pinvoke.md index b3fd4a5badb..2cb904144ed 100644 --- a/docs/dotnet/using-cpp-interop-implicit-pinvoke.md +++ b/docs/dotnet/using-cpp-interop-implicit-pinvoke.md @@ -4,6 +4,7 @@ title: "Using C++ Interop (Implicit PInvoke)" ms.date: "11/04/2016" helpviewer_keywords: ["blittable types [C++]", "platform invoke [C++], implicit", "interop [C++], features", "data marshaling [C++], C++ Interop features", "porting [C++], C++ native to .NET", "COM interfaces [C++]", "implicit platform invoke", "examples [C++], interoperability", "types [C++], blittable", "marshaling [C++], C++ Interop features", "platform invoke [C++], examples", "interoperability [C++]", "C++ Interop", "interoperability [C++], Implicit PInvoke", "C++, interop", "C++ COM Interop", ".NET [C++], porting C++ native to"] ms.assetid: 5f710bf1-88ae-4c4e-8326-b3f0b7c4c68a +ms.topic: concept-article --- # Using C++ Interop (Implicit PInvoke) diff --git a/docs/dotnet/using-explicit-pinvoke-in-cpp-dllimport-attribute.md b/docs/dotnet/using-explicit-pinvoke-in-cpp-dllimport-attribute.md index 61b35c6421e..df29926c353 100644 --- a/docs/dotnet/using-explicit-pinvoke-in-cpp-dllimport-attribute.md +++ b/docs/dotnet/using-explicit-pinvoke-in-cpp-dllimport-attribute.md @@ -4,6 +4,7 @@ title: "Using Explicit PInvoke in C++ (DllImport Attribute)" ms.date: "11/04/2016" helpviewer_keywords: ["marshaling [C++], platform invoke", "C++ Interop, platform invoke", "interop [C++], platform invoke", "platform invoke [C++], marshaling in C++", "data marshaling [C++], platform invoke"] ms.assetid: 18e5218c-6916-48a1-a127-f66e22ef15fc +ms.topic: concept-article --- # Using Explicit PInvoke in C++ (DllImport Attribute) diff --git a/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md b/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md index 93acc4fdd74..b2da43511d5 100644 --- a/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md +++ b/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md @@ -4,6 +4,7 @@ title: "Using Verifiable Assemblies with SQL Server (C++/CLI)" ms.date: "10/17/2018" helpviewer_keywords: ["verifiable assemblies [C++], with SQL Server"] ms.assetid: 5248a60d-aa88-4ff3-b30a-b791c3ea2de9 +ms.topic: concept-article --- # Using Verifiable Assemblies with SQL Server (C++/CLI) diff --git a/docs/dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md b/docs/dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md index 89be33ea732..8152460289f 100644 --- a/docs/dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md +++ b/docs/dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md @@ -4,6 +4,7 @@ description: "Use Microsoft C++ to create programs and libraries that can connec ms.date: 10/28/2021 helpviewer_keywords: ["command-line applications [C++], managed code", "compiling programs [C++]", "Visual C++, managed code", "managed code [C++]"] ms.assetid: 339f89df-a5d2-4040-831a-ddbe25b5dce4 +ms.topic: how-to --- # Walkthrough: Compile a C++/CLI program that targets the CLR in Visual Studio diff --git a/docs/embedded/download-and-install-the-embedded-tooling.md b/docs/embedded/download-and-install-the-embedded-tooling.md index a445146308e..1fe6ea96d53 100644 --- a/docs/embedded/download-and-install-the-embedded-tooling.md +++ b/docs/embedded/download-and-install-the-embedded-tooling.md @@ -6,6 +6,7 @@ ms.custom: intro-installation author: gcampbell-msft ms.author: gcampbell monikerRange: '>=msvc-170' +ms.topic: install-set-up-deploy --- # Download and install the Embedded tooling diff --git a/docs/ide/add-interface-definition-library-method-wizard.md b/docs/ide/add-interface-definition-library-method-wizard.md index 6f4430b635b..af92363f297 100644 --- a/docs/ide/add-interface-definition-library-method-wizard.md +++ b/docs/ide/add-interface-definition-library-method-wizard.md @@ -5,6 +5,7 @@ ms.date: "04/13/2022" f1_keywords: ["vc.codewiz.method.overview", "vc.codewiz.method.idlattrib"] helpviewer_keywords: ["add IDL method wizard [C++]", "IDL methods [C++], adding", "methods [C++], adding using wizards", "IDL attributes, add an IDL method wizard"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add an IDL method diff --git a/docs/ide/add-interface-definition-library-property-wizard.md b/docs/ide/add-interface-definition-library-property-wizard.md index c12abece36d..8391d750929 100644 --- a/docs/ide/add-interface-definition-library-property-wizard.md +++ b/docs/ide/add-interface-definition-library-property-wizard.md @@ -5,6 +5,7 @@ ms.date: 04/14/2022 f1_keywords: ["vc.codewiz.prop.overview", "vc.codewiz.prop.idlattributes"] helpviewer_keywords: ["interfaces, adding properties", "properties [C++], adding to interfaces", "names, add property wizard", "IDL attributes", "stock properties, about stock properties", "stock properties"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add an IDL property diff --git a/docs/ide/adding-a-class-from-an-activex-control-visual-cpp.md b/docs/ide/adding-a-class-from-an-activex-control-visual-cpp.md index 5fb6833df0d..7fceea68e7c 100644 --- a/docs/ide/adding-a-class-from-an-activex-control-visual-cpp.md +++ b/docs/ide/adding-a-class-from-an-activex-control-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: 04/28/2023 f1_keywords: ["vc.codewiz.class.axcontrol"] helpviewer_keywords: ["ActiveX controls [C++], adding classes", "classes [C++], creating", "ActiveX Control Wizard", "add class from ActiveX control wizard [C++]"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add a class from an ActiveX control diff --git a/docs/ide/adding-a-generic-cpp-class.md b/docs/ide/adding-a-generic-cpp-class.md index 9d7342c49c2..aa08041e151 100644 --- a/docs/ide/adding-a-generic-cpp-class.md +++ b/docs/ide/adding-a-generic-cpp-class.md @@ -5,6 +5,7 @@ ms.date: "11/09/2018" f1_keywords: ["vc.codewiz.classes.adding.generic", "vc.codewiz.class.generic"] helpviewer_keywords: ["Visual C++, classes", "generic classes, adding", "generic classes", "generic C++ class wizard [C++]"] ms.assetid: e95a5a14-dbed-4edc-8551-344fe48613cb +ms.topic: how-to --- # Add a generic C++ class diff --git a/docs/ide/adding-a-member-function-visual-cpp.md b/docs/ide/adding-a-member-function-visual-cpp.md index 4dd50a46717..0ae5d7ab880 100644 --- a/docs/ide/adding-a-member-function-visual-cpp.md +++ b/docs/ide/adding-a-member-function-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/09/2018" f1_keywords: ["vc.codewiz.classes.member.function", "vc.codewiz.function.overview"] helpviewer_keywords: ["member functions, adding to classes", "classes [C++], adding members", "add member function wizard [C++]"] ms.assetid: 55b25ddb-541d-44ed-957c-974ef91cfc85 +ms.topic: how-to --- # Add a member function diff --git a/docs/ide/adding-a-member-variable-visual-cpp.md b/docs/ide/adding-a-member-variable-visual-cpp.md index 853f4385133..76a6a69fd16 100644 --- a/docs/ide/adding-a-member-variable-visual-cpp.md +++ b/docs/ide/adding-a-member-variable-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/09/2018" f1_keywords: ["vc.codewiz.classes.member.variable", "vc.codewiz.variable.overview"] helpviewer_keywords: ["member variables, adding", "member variables", "add member variable wizard [C++]", "dialog box controls, member variables", "dialog box controls, variable types", "variables, dialog box control member variables"] ms.assetid: 437783bd-8eb4-4508-8b73-7380116e9d71 +ms.topic: how-to --- # Add a member variable diff --git a/docs/ide/adding-a-method-visual-cpp.md b/docs/ide/adding-a-method-visual-cpp.md index 6fdc77ce36e..c5e2c1e9944 100644 --- a/docs/ide/adding-a-method-visual-cpp.md +++ b/docs/ide/adding-a-method-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "03/31/2022" f1_keywords: ["vc.codewiz.method.overview", "vc.codewiz.method.idlattrib"] helpviewer_keywords: ["add method wizard [C++]", "methods [C++], adding", "methods [C++], adding using wizards", "IDL attributes, add method wizard"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add a method @@ -59,4 +60,4 @@ Add a method to an interface by using the add method wizard: [Add an IDL method wizard](add-interface-definition-library-method-wizard.md)\ [Add an IDL MFC method wizard](../mfc/reference/add-idl-mfc-method-wizard.md)\ -[Adding functionality with code wizards](adding-functionality-with-code-wizards-cpp.md) \ No newline at end of file +[Adding functionality with code wizards](adding-functionality-with-code-wizards-cpp.md) diff --git a/docs/ide/adding-a-property-visual-cpp.md b/docs/ide/adding-a-property-visual-cpp.md index f710a05befb..9feff5ef6ec 100644 --- a/docs/ide/adding-a-property-visual-cpp.md +++ b/docs/ide/adding-a-property-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: 04/12/2022 f1_keywords: ["vc.codewiz.prop.overview"] helpviewer_keywords: ["interfaces, adding properties", "properties [C++], adding to interfaces", "names, add property wizard", "add property wizard", "stock properties, about stock properties", "stock properties"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add a property @@ -56,4 +57,4 @@ The following section describes the UI that you'll use to add a property: [Add IDL Property](add-interface-definition-library-property-wizard.md) -[Add IDL MFC Property](../mfc/reference/add-interface-definition-library-mfc-property-wizard.md) \ No newline at end of file +[Add IDL MFC Property](../mfc/reference/add-interface-definition-library-mfc-property-wizard.md) diff --git a/docs/ide/adding-an-event-handler-visual-cpp.md b/docs/ide/adding-an-event-handler-visual-cpp.md index b5bb5ac8e0b..0990bfb6222 100644 --- a/docs/ide/adding-an-event-handler-visual-cpp.md +++ b/docs/ide/adding-an-event-handler-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/12/2018" f1_keywords: ["vc.codewiz.eventhandler.overview"] helpviewer_keywords: ["event handlers, adding", "properties [Visual Studio], MSBuild", "MSBuild, properties", "event handler wizard [C++]"] ms.assetid: 050bebf0-a9e0-474b-905c-796fe5ac8fc3 +ms.topic: how-to --- # Add an event handler diff --git a/docs/ide/adding-an-event-visual-cpp.md b/docs/ide/adding-an-event-visual-cpp.md index 68c78c71bde..7a28e7de1ad 100644 --- a/docs/ide/adding-an-event-visual-cpp.md +++ b/docs/ide/adding-an-event-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/12/2018" f1_keywords: ["vc.codewiz.event.overview"] helpviewer_keywords: ["ActiveX controls [C++], adding events to", "MFC ActiveX controls [C++], adding events", "events [C++], ActiveX controls", "add event wizard [C++]"] ms.assetid: fe34832a-edfc-4f86-aacb-8df77001873d +ms.topic: how-to --- # Add an event diff --git a/docs/ide/adding-functionality-with-code-wizards-cpp.md b/docs/ide/adding-functionality-with-code-wizards-cpp.md index a5088db657d..4921258492d 100644 --- a/docs/ide/adding-functionality-with-code-wizards-cpp.md +++ b/docs/ide/adding-functionality-with-code-wizards-cpp.md @@ -4,6 +4,7 @@ title: "Adding Functionality with Code Wizards (C++)" ms.date: "05/14/2019" helpviewer_keywords: ["code wizards [C++]"] ms.assetid: 6afb7ef9-7056-423d-b244-91bb4236d1d7 +ms.topic: concept-article --- # Adding Functionality with Code Wizards (C++) diff --git a/docs/ide/implementing-a-connection-point-visual-cpp.md b/docs/ide/implementing-a-connection-point-visual-cpp.md index 20e7d83b8aa..252f5ff9310 100644 --- a/docs/ide/implementing-a-connection-point-visual-cpp.md +++ b/docs/ide/implementing-a-connection-point-visual-cpp.md @@ -4,6 +4,7 @@ title: "Implement a connection point" ms.date: "05/14/2019" helpviewer_keywords: ["connection points [C++], implementing", "implement connection point wizard [C++]"] ms.assetid: 5b37e4f9-73c9-4bef-b26d-365bc0662260 +ms.topic: how-to --- # Implement a connection point diff --git a/docs/ide/implementing-an-interface-visual-cpp.md b/docs/ide/implementing-an-interface-visual-cpp.md index 7696bdfd9a2..fcb5cb92f34 100644 --- a/docs/ide/implementing-an-interface-visual-cpp.md +++ b/docs/ide/implementing-an-interface-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/12/2018" f1_keywords: ["vc.codewiz.impl.interface.overview"] helpviewer_keywords: ["interfaces, implementing", "implement interface wizard [C++]"] ms.assetid: 72f8731b-7e36-45db-8b10-7ef211a773cd +ms.topic: how-to --- # Implement an interface diff --git a/docs/ide/overriding-a-virtual-function-visual-cpp.md b/docs/ide/overriding-a-virtual-function-visual-cpp.md index 3f552708ee2..e681a20f791 100644 --- a/docs/ide/overriding-a-virtual-function-visual-cpp.md +++ b/docs/ide/overriding-a-virtual-function-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/12/2018" f1_keywords: ["vc.codewiz.virtualfunc.override"] helpviewer_keywords: ["virtual functions, overriding", "base classes, overriding virtual functions defined in", "Properties window, overriding virtual functions in"] ms.assetid: 2d8c76f2-7a6b-4c9c-8de5-4282ce7755b6 +ms.topic: how-to --- # Override a virtual function diff --git a/docs/ide/read-and-understand-code-cpp.md b/docs/ide/read-and-understand-code-cpp.md index e98759ba67c..119efc1076e 100644 --- a/docs/ide/read-and-understand-code-cpp.md +++ b/docs/ide/read-and-understand-code-cpp.md @@ -2,6 +2,7 @@ title: "Read and understand C++ code in Visual Studio" description: "Use the C++ code editor in Visual Studio to format, and understand your code." ms.date: 05/28/2019 +ms.topic: concept-article --- # Read and understand C++ code in Visual Studio diff --git a/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md b/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md index 330552cf38a..45a30a66416 100644 --- a/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md +++ b/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md @@ -4,6 +4,7 @@ title: "Using the Visual Studio IDE for C++ Desktop Development" ms.date: "04/25/2019" helpviewer_keywords: ["IDE [C++]", "Visual Studio IDE [C++]"] ms.assetid: d985c230-8e81-49d6-92be-2db9cac8d023 +ms.topic: concept-article --- # Using the Visual Studio IDE for C++ Desktop Development From 8bc75c4ff8898e6bceb0bde3942786ffcc067d90 Mon Sep 17 00:00:00 2001 From: Saisang Cai Date: Fri, 20 Jun 2025 00:06:59 +0800 Subject: [PATCH 0112/1799] Bulk update ms.topic, folder: linux,mfc --- docs/linux/cmake-linux-configure.md | 1 + docs/linux/cmake-linux-project.md | 1 + docs/linux/create-a-new-linux-project.md | 1 + docs/linux/linux-asan-configuration.md | 1 + .../set-up-fips-compliant-secure-remote-linux-development.md | 1 + docs/mfc/accessing-all-members-of-a-collection.md | 1 + docs/mfc/accessing-file-status.md | 1 + docs/mfc/accessing-run-time-class-information.md | 1 + docs/mfc/accessing-the-embedded-month-calendar-control.md | 1 + docs/mfc/adding-columns-to-the-control-report-view.md | 1 + docs/mfc/adding-controls-by-hand.md | 1 + docs/mfc/adding-controls-to-a-property-sheet.md | 1 + docs/mfc/adding-items-to-the-control.md | 1 + docs/mfc/adding-items-to-the-header-control.md | 1 + docs/mfc/adding-multiple-views-to-a-single-document.md | 1 + docs/mfc/adding-tabs-to-a-tab-control.md | 1 + docs/mfc/allocating-and-deallocating-window-memory.md | 1 + docs/mfc/allocating-gdi-resources.md | 1 + docs/mfc/build-requirements-for-windows-vista-common-controls.md | 1 + docs/mfc/building-on-the-framework.md | 1 + docs/mfc/bypassing-the-serialization-mechanism.md | 1 + docs/mfc/changing-list-control-styles.md | 1 + docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md | 1 + docs/mfc/class-library-overview.md | 1 + docs/mfc/cleaning-up-documents-and-views.md | 1 + docs/mfc/closing-files.md | 1 + docs/mfc/closing-the-dialog-box.md | 1 + docs/mfc/cobject-class-frequently-asked-questions.md | 1 + docs/mfc/command-routing-illustration.md | 1 + docs/mfc/command-routing.md | 1 + docs/mfc/communicating-with-a-tree-control.md | 1 + docs/mfc/creating-a-ctoolbarctrl-object.md | 1 + docs/mfc/creating-a-dialog-class-with-code-wizards.md | 1 + docs/mfc/creating-a-modeless-property-sheet.md | 1 + docs/mfc/creating-a-rebar-control.md | 1 + docs/mfc/creating-an-active-document-container-application.md | 1 + docs/mfc/creating-an-extended-combo-box-control.md | 1 + docs/mfc/creating-and-displaying-dialog-boxes.md | 1 + docs/mfc/creating-document-frame-windows.md | 1 + docs/mfc/creating-modal-dialog-boxes.md | 1 + docs/mfc/creating-modeless-dialog-boxes.md | 1 + docs/mfc/creating-new-documents-windows-and-views.md | 1 + docs/mfc/creating-stack-and-queue-collections.md | 1 + docs/mfc/creating-the-date-and-time-picker-control.md | 1 + docs/mfc/creating-the-dialog-resource.md | 1 + docs/mfc/creating-the-header-control.md | 1 + docs/mfc/creating-the-image-lists.md | 1 + docs/mfc/creating-the-list-control.md | 1 + docs/mfc/creating-the-month-calendar-control.md | 1 + docs/mfc/creating-the-tab-control.md | 1 + docs/mfc/creating-windows.md | 1 + docs/mfc/creating-your-dialog-class.md | 1 + docs/mfc/customizing-the-appearance-of-a-toolbar-control.md | 1 + docs/mfc/customizing-the-header-item-s-appearance.md | 1 + docs/mfc/debugging-and-exception-classes.md | 1 + docs/mfc/debugging-support-classes.md | 1 + docs/mfc/declaring-message-handler-functions.md | 1 + docs/mfc/deleting-all-objects-in-a-cobject-collection.md | 1 + docs/mfc/deriving-a-class-from-cobject.md | 1 + docs/mfc/deriving-a-document-class-from-cdocument.md | 1 + docs/mfc/deriving-controls-from-a-standard-control.md | 1 + docs/mfc/destroying-frame-windows.md | 1 + docs/mfc/destroying-the-dialog-box.md | 1 + docs/mfc/destroying-the-list-control.md | 1 + docs/mfc/destroying-window-objects.md | 1 + docs/mfc/detaching-a-cwnd-from-its-hwnd.md | 1 + docs/mfc/docking-and-floating-toolbars.md | 1 + docs/mfc/dragging-and-dropping-files-in-a-frame-window.md | 1 + docs/mfc/dragging-images-from-an-image-list.md | 1 + docs/mfc/drawing-and-printing-classes.md | 1 + docs/mfc/drawing-images-from-an-image-list.md | 1 + docs/mfc/drawing-in-a-view.md | 1 + docs/mfc/drawing-tool-classes.md | 1 + docs/mfc/enabling-tool-tips.md | 1 + docs/mfc/exchanging-data.md | 1 + docs/mfc/handling-commands-in-the-document.md | 1 + docs/mfc/handling-customization-notifications.md | 1 + docs/mfc/handling-reflected-messages.md | 1 + docs/mfc/handling-the-apply-button.md | 1 + docs/mfc/handling-tool-tip-notifications.md | 1 + docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md | 1 + docs/mfc/handling-windows-messages-in-your-dialog-box.md | 1 + docs/mfc/implementing-working-areas-in-list-controls.md | 1 + docs/mfc/initializing-and-cleaning-up-documents-and-views.md | 1 + docs/mfc/initializing-documents-and-views.md | 1 + docs/mfc/initializing-the-dialog-box.md | 1 + docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md | 1 + docs/mfc/inserting-a-form-into-a-project.md | 1 + docs/mfc/interpreting-user-input-through-a-view.md | 1 + docs/mfc/life-cycle-of-a-dialog-box.md | 1 + docs/mfc/making-and-using-controls.md | 1 + docs/mfc/making-owner-drawn-header-controls.md | 1 + docs/mfc/making-owner-drawn-tabs.md | 1 + docs/mfc/managing-data-with-document-data-variables.md | 1 + docs/mfc/managing-mdi-child-windows.md | 1 + docs/mfc/managing-menus-control-bars-and-accelerators.md | 1 + docs/mfc/managing-the-current-view.md | 1 + docs/mfc/managing-the-state-data-of-mfc-modules.md | 1 + docs/mfc/manipulating-image-lists.md | 1 + docs/mfc/manipulating-menus-during-program-execution.md | 1 + docs/mfc/manipulating-the-progress-control.md | 1 + docs/mfc/manipulating-the-tool-tip-control.md | 1 + docs/mfc/mapping-messages.md | 1 + docs/mfc/mapping-windows-messages-to-your-class.md | 1 + docs/mfc/message-categories.md | 1 + .../mfc-activex-controls-returning-error-codes-from-a-method.md | 1 + docs/mfc/mfc-concepts.md | 1 + docs/mfc/on-update-command-ui-macro.md | 1 + docs/mfc/opening-files.md | 1 + docs/mfc/optimizing-control-drawing.md | 1 + docs/mfc/optimizing-persistence-and-initialization.md | 1 + docs/mfc/orchestrating-other-window-actions.md | 1 + docs/mfc/ordering-items-in-the-header-control.md | 1 + docs/mfc/overriding-the-standard-command-routing.md | 1 + docs/mfc/overview-of-the-rich-edit-control.md | 1 + docs/mfc/printing-and-print-preview.md | 1 + docs/mfc/printing-in-rich-edit-controls.md | 1 + docs/mfc/printing.md | 1 + docs/mfc/processing-header-control-notifications.md | 1 + docs/mfc/processing-notification-messages-in-a-rebar-control.md | 1 + ...ing-notification-messages-in-date-and-time-picker-controls.md | 1 + ...ssing-notification-messages-in-extended-combo-box-controls.md | 1 + docs/mfc/processing-notification-messages-in-list-controls.md | 1 + ...rocessing-notification-messages-in-month-calendar-controls.md | 1 + docs/mfc/processing-tab-control-notification-messages.md | 1 + docs/mfc/providing-drag-and-drop-support-for-header-items.md | 1 + docs/mfc/providing-flicker-free-activation.md | 1 + docs/mfc/providing-mouse-interaction-while-inactive.md | 1 + docs/mfc/providing-windowless-activation.md | 1 + docs/mfc/reading-and-writing-files.md | 1 + docs/mfc/receiving-notification-from-common-controls.md | 1 + docs/mfc/registering-window-classes.md | 1 + docs/mfc/responding-to-dynamic-data-exchange-dde.md | 1 + docs/mfc/retrieving-data-from-the-dialog-object.md | 1 + docs/mfc/rubber-banding-and-trackers.md | 1 + docs/mfc/scrolling-and-scaling-views.md | 1 + docs/mfc/selecting-a-graphic-object-into-a-device-context.md | 1 + docs/mfc/serializing-data-to-and-from-files.md | 1 + docs/mfc/setting-a-hot-key.md | 1 + docs/mfc/setting-the-day-state-of-a-month-calendar-control.md | 1 + docs/mfc/setting-the-dialog-boxs-background-color.md | 1 + docs/mfc/setting-the-images-for-an-individual-item.md | 1 + docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md | 1 + docs/mfc/specifying-levels-of-functionality.md | 1 + ...steps-in-a-typical-ftp-client-application-to-delete-a-file.md | 1 + docs/mfc/steps-in-a-typical-ftp-client-application.md | 1 + docs/mfc/steps-in-a-typical-gopher-client-application.md | 1 + docs/mfc/steps-in-a-typical-http-client-application.md | 1 + docs/mfc/steps-in-a-typical-internet-client-application.md | 1 + docs/mfc/storing-and-loading-cobjects-via-an-archive.md | 1 + docs/mfc/testing-internet-applications.md | 1 + docs/mfc/testing-properties-and-events-with-test-container.md | 1 + docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md | 1 + docs/mfc/tn061-on-notify-and-wm-notify-messages.md | 1 + docs/mfc/tree-control-item-states-overview.md | 1 + docs/mfc/turning-off-the-activate-when-visible-option.md | 1 + docs/mfc/updating-the-text-of-a-status-bar-pane.md | 1 + docs/mfc/upgrading-an-existing-activex-control.md | 1 + docs/mfc/using-a-common-control-as-a-child-window.md | 1 + docs/mfc/using-a-dialog-bar-with-a-rebar-control.md | 1 + docs/mfc/using-a-dialog-template-in-memory.md | 1 + docs/mfc/using-a-hot-key-control.md | 1 + docs/mfc/using-an-animation-control.md | 1 + docs/mfc/using-an-image-list-with-a-rebar-control.md | 1 + docs/mfc/using-an-image-list.md | 1 + docs/mfc/using-an-unclipped-device-context.md | 1 + .../using-callback-fields-in-a-date-and-time-picker-control.md | 1 + docs/mfc/using-canimatectrl.md | 1 + docs/mfc/using-ccomboboxex.md | 1 + docs/mfc/using-cdatetimectrl.md | 1 + docs/mfc/using-cheaderctrl.md | 1 + docs/mfc/using-chotkeyctrl.md | 1 + docs/mfc/using-cimagelist.md | 1 + docs/mfc/using-clistctrl.md | 1 + docs/mfc/using-cmonthcalctrl.md | 1 + docs/mfc/using-cobject.md | 1 + docs/mfc/using-common-controls-in-a-dialog-box.md | 1 + docs/mfc/using-cprogressctrl.md | 1 + docs/mfc/using-crebarctrl.md | 1 + docs/mfc/using-cricheditctrl.md | 1 + docs/mfc/using-csliderctrl.md | 1 + docs/mfc/using-cspinbuttonctrl.md | 1 + .../using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md | 1 + docs/mfc/using-cstatusbarctrl.md | 1 + docs/mfc/using-ctabctrl.md | 1 + docs/mfc/using-ctoolbarctrl.md | 1 + ...tooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md | 1 + docs/mfc/using-ctooltipctrl.md | 1 + docs/mfc/using-ctreectrl.md | 1 + ...ng-custom-format-strings-in-a-date-and-time-picker-control.md | 1 + docs/mfc/using-documents.md | 1 + docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md | 1 + docs/mfc/using-frame-windows.md | 1 + docs/mfc/using-image-lists-in-a-toolbar-control.md | 1 + docs/mfc/using-image-lists-in-an-extended-combo-box-control.md | 1 + docs/mfc/using-image-lists-with-header-controls.md | 1 + docs/mfc/using-property-sheets-in-your-application.md | 1 + docs/mfc/using-slider-controls.md | 1 + docs/mfc/using-the-carchive-output-and-input-operators.md | 1 + docs/mfc/using-the-classes-to-write-applications-for-windows.md | 1 + 200 files changed, 200 insertions(+) diff --git a/docs/linux/cmake-linux-configure.md b/docs/linux/cmake-linux-configure.md index c25b94031e9..97b0d6ddc7a 100644 --- a/docs/linux/cmake-linux-configure.md +++ b/docs/linux/cmake-linux-configure.md @@ -2,6 +2,7 @@ title: "Configure a Linux CMake project in Visual Studio" description: "How to configure Linux CMake settings in Visual Studio" ms.date: 01/03/2022 +ms.topic: how-to --- # Configure a Linux CMake project in Visual Studio diff --git a/docs/linux/cmake-linux-project.md b/docs/linux/cmake-linux-project.md index 821cbc5e046..538d0fb2005 100644 --- a/docs/linux/cmake-linux-project.md +++ b/docs/linux/cmake-linux-project.md @@ -3,6 +3,7 @@ title: "Create a CMake Linux project in Visual Studio" description: "How to create a Linux CMake project in Visual Studio" ms.date: "08/06/2020" ms.assetid: f8707b32-f90d-494d-ae0b-1d44425fdc25 +ms.topic: how-to --- # Create a CMake Linux project in Visual Studio diff --git a/docs/linux/create-a-new-linux-project.md b/docs/linux/create-a-new-linux-project.md index 7002e23eefd..20a574b8603 100644 --- a/docs/linux/create-a-new-linux-project.md +++ b/docs/linux/create-a-new-linux-project.md @@ -2,6 +2,7 @@ title: "Create a Linux MSBuild C++ project in Visual Studio" ms.date: "10/15/2020" description: "Create a new MSBuild-based Linux project in Visual Studio." +ms.topic: how-to --- # Create a Linux MSBuild C++ project in Visual Studio diff --git a/docs/linux/linux-asan-configuration.md b/docs/linux/linux-asan-configuration.md index 115a3a94c12..11c959116f9 100644 --- a/docs/linux/linux-asan-configuration.md +++ b/docs/linux/linux-asan-configuration.md @@ -2,6 +2,7 @@ title: "Configure Linux projects to use Address Sanitizer" description: "Describes how to configure C++ Linux projects in Visual Studio to use Address Sanitizer." ms.date: "10/7/2020" +ms.topic: how-to --- # Configure Linux projects to use Address Sanitizer diff --git a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md index fbfacf7a4f0..f4689e5bce3 100644 --- a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md +++ b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md @@ -2,6 +2,7 @@ title: "Set up FIPS-compliant secure remote Linux development" description: "How to set up a FIPS-compliant cryptographic connection between Visual Studio and a Linux machine for remote development." ms.date: 07/06/2022 +ms.topic: how-to --- # Set up FIPS-compliant secure remote Linux development diff --git a/docs/mfc/accessing-all-members-of-a-collection.md b/docs/mfc/accessing-all-members-of-a-collection.md index df7b900c87a..0cd39499410 100644 --- a/docs/mfc/accessing-all-members-of-a-collection.md +++ b/docs/mfc/accessing-all-members-of-a-collection.md @@ -4,6 +4,7 @@ title: "Accessing All Members of a Collection" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, collections", "enumerations [MFC]", "enumerating collections [MFC]", "collections [MFC], accessing", "collection classes [MFC]", ", ", ", ", ", ", ", ", ", ", ", ", ", "] ms.assetid: 7bbae518-062e-4393-81f9-b22abd2e5f59 +ms.topic: how-to --- # Accessing All Members of a Collection diff --git a/docs/mfc/accessing-file-status.md b/docs/mfc/accessing-file-status.md index e6b649aa51d..f582a6558bc 100644 --- a/docs/mfc/accessing-file-status.md +++ b/docs/mfc/accessing-file-status.md @@ -4,6 +4,7 @@ title: "Accessing File Status" ms.date: "11/04/2016" helpviewer_keywords: ["files [MFC], status information", "examples [MFC], file status", "files [MFC], accessing", "file status [MFC]", "status of files [MFC]"] ms.assetid: 1b8891d6-eb0f-4037-a837-4928fe595222 +ms.topic: how-to --- # Accessing File Status diff --git a/docs/mfc/accessing-run-time-class-information.md b/docs/mfc/accessing-run-time-class-information.md index c8891bb05ce..e0981fe062a 100644 --- a/docs/mfc/accessing-run-time-class-information.md +++ b/docs/mfc/accessing-run-time-class-information.md @@ -4,6 +4,7 @@ title: "Accessing Run-Time Class Information" ms.date: "11/04/2016" helpviewer_keywords: ["CObject class [MFC], and RTTI", "CObject class [MFC], using IsKindOf method [MFC]", "run time [MFC], class information", "RUNTIME_CLASS macro [MFC]", "CObject class [MFC], using RUNTIME_CLASS macro [MFC]", "RTTI compiler option [MFC]", "CObject class [MFC], accessing run-time class information", "run time [MFC]", "IsKindOf method method [MFC]", "run-time class [MFC], accessing information", "classes [MFC], run-time class information", "run-time class [MFC]", "RUNTIME_CLASS macro, using"] ms.assetid: 3445a9af-0bd6-4496-95c3-aa59b964570b +ms.topic: how-to --- # Accessing Run-Time Class Information diff --git a/docs/mfc/accessing-the-embedded-month-calendar-control.md b/docs/mfc/accessing-the-embedded-month-calendar-control.md index 05c19058476..c8c09084768 100644 --- a/docs/mfc/accessing-the-embedded-month-calendar-control.md +++ b/docs/mfc/accessing-the-embedded-month-calendar-control.md @@ -4,6 +4,7 @@ title: "Accessing the Embedded Month Calendar Control" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC], accessing month calendar", "CDateTimeCtrl class [MFC], accessing embedded control", "month calendar controls [MFC], embedded in date/time picker", "CMonthCalCtrl class [MFC], changing the font", "month calendar controls [MFC], changing the font", "DateTimePicker control [MFC]"] ms.assetid: 355e97ed-cf81-4df3-a2f8-9ddbbde93227 +ms.topic: concept-article --- # Accessing the Embedded Month Calendar Control diff --git a/docs/mfc/adding-columns-to-the-control-report-view.md b/docs/mfc/adding-columns-to-the-control-report-view.md index a2bf092bca5..829a912284b 100644 --- a/docs/mfc/adding-columns-to-the-control-report-view.md +++ b/docs/mfc/adding-columns-to-the-control-report-view.md @@ -4,6 +4,7 @@ title: "Adding Columns to the Control (Report View)" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], adding columns", "report view in CListCtrl class [MFC]", "views [MFC], report", "columns [MFC], adding to CListCtrl", "CListCtrl class [MFC], report view"] ms.assetid: 7392c0d7-f8a5-4e7b-9ae7-b53dc9dd80ae +ms.topic: concept-article --- # Adding Columns to the Control (Report View) diff --git a/docs/mfc/adding-controls-by-hand.md b/docs/mfc/adding-controls-by-hand.md index 74ae5dee489..8945ca7e2a3 100644 --- a/docs/mfc/adding-controls-by-hand.md +++ b/docs/mfc/adding-controls-by-hand.md @@ -4,6 +4,7 @@ title: "Adding Controls By Hand" ms.date: "11/04/2016" helpviewer_keywords: ["Windows common controls [MFC], adding", "dialog box controls [MFC], adding to dialog boxes", "controlling input focus", "input focus control", "focus, controlling input [MFC]", "controls [MFC], adding to dialog boxes", "common controls [MFC], adding"] ms.assetid: bc843e59-0c51-4b5b-8bf2-343f716469d2 +ms.topic: concept-article --- # Adding Controls By Hand diff --git a/docs/mfc/adding-controls-to-a-property-sheet.md b/docs/mfc/adding-controls-to-a-property-sheet.md index b11b5c5177d..f9fd7130061 100644 --- a/docs/mfc/adding-controls-to-a-property-sheet.md +++ b/docs/mfc/adding-controls-to-a-property-sheet.md @@ -4,6 +4,7 @@ title: "Adding Controls to a Property Sheet" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], adding to property sheets", "property sheets, adding controls"] ms.assetid: 24ad4c0b-c1db-4850-b9f0-34aae8d74571 +ms.topic: concept-article --- # Adding Controls to a Property Sheet diff --git a/docs/mfc/adding-items-to-the-control.md b/docs/mfc/adding-items-to-the-control.md index 4f98db97a09..9019df5d8f5 100644 --- a/docs/mfc/adding-items-to-the-control.md +++ b/docs/mfc/adding-items-to-the-control.md @@ -4,6 +4,7 @@ title: "Adding Items to the Control" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], adding items"] ms.assetid: 715994bd-340d-4ad2-9882-411654137830 +ms.topic: concept-article --- # Adding Items to the Control diff --git a/docs/mfc/adding-items-to-the-header-control.md b/docs/mfc/adding-items-to-the-header-control.md index 6b7b7469978..ad9b3d20dc5 100644 --- a/docs/mfc/adding-items-to-the-header-control.md +++ b/docs/mfc/adding-items-to-the-header-control.md @@ -4,6 +4,7 @@ title: "Adding Items to the Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], header", "CHeaderCtrl class [MFC], adding items", "header controls [MFC], adding items to"] ms.assetid: 2e9a28b1-7302-4a93-8037-c5a4183e589a +ms.topic: how-to --- # Adding Items to the Header Control diff --git a/docs/mfc/adding-multiple-views-to-a-single-document.md b/docs/mfc/adding-multiple-views-to-a-single-document.md index 1f808c9a0e8..b8e7fd427b4 100644 --- a/docs/mfc/adding-multiple-views-to-a-single-document.md +++ b/docs/mfc/adding-multiple-views-to-a-single-document.md @@ -4,6 +4,7 @@ title: "Adding Multiple Views to a Single Document" ms.date: "11/04/2016" helpviewer_keywords: ["multiple views [MFC], SDI applications", "documents [MFC], multiple views", "single document interface (SDI), adding views", "views [MFC], SDI applications"] ms.assetid: 86d0c134-01d5-429c-b672-36cfb956dc01 +ms.topic: concept-article --- # Adding Multiple Views to a Single Document diff --git a/docs/mfc/adding-tabs-to-a-tab-control.md b/docs/mfc/adding-tabs-to-a-tab-control.md index c0d93509083..b4312763c36 100644 --- a/docs/mfc/adding-tabs-to-a-tab-control.md +++ b/docs/mfc/adding-tabs-to-a-tab-control.md @@ -4,6 +4,7 @@ title: "Adding Tabs to a Tab Control" ms.date: "11/04/2016" helpviewer_keywords: ["tab controls [MFC], adding tabs", "putting tabs on CTabCtrls [MFC]", "CTabCtrl class [MFC], adding tabs", "tabs [MFC], adding to CTabCtrl class [MFC]"] ms.assetid: 7f3d9340-e3c7-4c71-9912-be57534ecc78 +ms.topic: how-to --- # Adding Tabs to a Tab Control diff --git a/docs/mfc/allocating-and-deallocating-window-memory.md b/docs/mfc/allocating-and-deallocating-window-memory.md index f3992156864..5e5645446a9 100644 --- a/docs/mfc/allocating-and-deallocating-window-memory.md +++ b/docs/mfc/allocating-and-deallocating-window-memory.md @@ -4,6 +4,7 @@ title: "Allocating and Deallocating Window Memory" ms.date: "11/04/2016" helpviewer_keywords: ["memory allocation, window objects", "memory deallocation", "storage for window objects [MFC]", "memory deallocation, window memory", "window objects [MFC], deallocating memory for", "storage for window objects [MFC], allocating"] ms.assetid: 7c962539-8461-4846-b5ca-fe3b15c313dc +ms.topic: concept-article --- # Allocating and Deallocating Window Memory diff --git a/docs/mfc/allocating-gdi-resources.md b/docs/mfc/allocating-gdi-resources.md index 1a1e83e8231..d9b1a739458 100644 --- a/docs/mfc/allocating-gdi-resources.md +++ b/docs/mfc/allocating-gdi-resources.md @@ -4,6 +4,7 @@ title: "Allocating GDI Resources" ms.date: "06/03/2019" helpviewer_keywords: ["resources [MFC], printing", "GDI objects [MFC], allocating during printing", "printing [MFC], allocating GDI resources"] ms.assetid: cef7e94d-5a27-4aea-a9ee-8369fc895d3a +ms.topic: concept-article --- # Allocating GDI Resources diff --git a/docs/mfc/build-requirements-for-windows-vista-common-controls.md b/docs/mfc/build-requirements-for-windows-vista-common-controls.md index 57617f2e267..1120d633c74 100644 --- a/docs/mfc/build-requirements-for-windows-vista-common-controls.md +++ b/docs/mfc/build-requirements-for-windows-vista-common-controls.md @@ -4,6 +4,7 @@ title: "Build Requirements for Windows Common Controls" ms.date: "08/19/2019" helpviewer_keywords: ["Common Controls (MFC), build requirements", "Common Controls (MFC)"] ms.assetid: 025f7d55-55a2-4dcd-8f62-02424e3dcc04 +ms.topic: how-to --- # Build Requirements for Windows Common Controls diff --git a/docs/mfc/building-on-the-framework.md b/docs/mfc/building-on-the-framework.md index 1cd5cb09897..7b339c588e9 100644 --- a/docs/mfc/building-on-the-framework.md +++ b/docs/mfc/building-on-the-framework.md @@ -4,6 +4,7 @@ title: "Building on the Framework" ms.date: "11/04/2016" helpviewer_keywords: ["application-specific classes [MFC]", "application framework [MFC], building applications", "applications [MFC]", "MFC, application development"] ms.assetid: 883f0f19-866f-4221-8a3d-5607941dc8d0 +ms.topic: concept-article --- # Building on the Framework diff --git a/docs/mfc/bypassing-the-serialization-mechanism.md b/docs/mfc/bypassing-the-serialization-mechanism.md index ff376ebe45d..045392c70cc 100644 --- a/docs/mfc/bypassing-the-serialization-mechanism.md +++ b/docs/mfc/bypassing-the-serialization-mechanism.md @@ -4,6 +4,7 @@ title: "Bypassing the Serialization Mechanism" ms.date: "11/04/2016" helpviewer_keywords: ["archive objects [MFC]", "bypassing serialization", "archives [MFC], serialization", "serialization [MFC], bypassing", "archives [MFC]", "serialization [MFC], role of framework", "serialization [MFC], overriding"] ms.assetid: 48d4a279-b51c-4ba5-81cd-ed043312b582 +ms.topic: concept-article --- # Bypassing the Serialization Mechanism diff --git a/docs/mfc/changing-list-control-styles.md b/docs/mfc/changing-list-control-styles.md index 37be34f1043..3f64060811f 100644 --- a/docs/mfc/changing-list-control-styles.md +++ b/docs/mfc/changing-list-control-styles.md @@ -4,6 +4,7 @@ title: "Changing List Control Styles" ms.date: "11/04/2016" helpviewer_keywords: ["styles [MFC], CListCtrl", "CListCtrl class [MFC], styles", "CListCtrl class [MFC], changing styles"] ms.assetid: be74a005-0795-417c-9056-f6342aa74b26 +ms.topic: concept-article --- # Changing List Control Styles diff --git a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md index 772b7b1a296..eb6d87a53c4 100644 --- a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md +++ b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md @@ -4,6 +4,7 @@ title: "Changing the Styles of a Window Created by MFC" ms.date: "11/04/2016" helpviewer_keywords: ["window styles [MFC]", "WS_OVERLAPPEDWINDOW macro [MFC]", "single document interface (SDI), changing window attributes", "MDI [MFC], window styles", "windows [MFC], MFC", "child windows [MFC], styles", "MFC, windows", "CFrameWnd class [MFC], window styles", "CREATESTRUCT macro [MFC]", "CMDIChildWnd class [MFC], changing window styles", "multidocument interface style", "PreCreateWindow method [MFC], window styles", "single document interface (SDI), style", "default window style", "defaults [MFC], window style", "PreCreateWindow method [MFC], changing window styles", "CMainFrame class [MFC]", "styles [MFC], windows"] ms.assetid: 77fa4f03-96b4-4687-9ade-41e46f7e4b0a +ms.topic: concept-article --- # Changing the Styles of a Window Created by MFC diff --git a/docs/mfc/class-library-overview.md b/docs/mfc/class-library-overview.md index f30e76f9ec3..514443b1180 100644 --- a/docs/mfc/class-library-overview.md +++ b/docs/mfc/class-library-overview.md @@ -5,6 +5,7 @@ ms.date: "09/17/2019" f1_keywords: ["vc.classes.mfc"] helpviewer_keywords: ["grouping MFC classes", "MFC, class library", "classes [MFC], MFC", "class libraries, MFC", "class libraries"] ms.assetid: 9b0e3152-ac39-4f52-91b4-f20aa3a674aa +ms.topic: concept-article --- # Class Library Overview diff --git a/docs/mfc/cleaning-up-documents-and-views.md b/docs/mfc/cleaning-up-documents-and-views.md index 9903e1e53d8..ff3d94b0ca2 100644 --- a/docs/mfc/cleaning-up-documents-and-views.md +++ b/docs/mfc/cleaning-up-documents-and-views.md @@ -4,6 +4,7 @@ title: "Cleaning Up Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["views [MFC], cleaning up", "documents [MFC], cleaning up", "documents [MFC], closing"] ms.assetid: 0c454db2-3644-434d-9e53-8108a7aedfe1 +ms.topic: concept-article --- # Cleaning Up Documents and Views diff --git a/docs/mfc/closing-files.md b/docs/mfc/closing-files.md index 19a3e35aa51..2e72fde16a9 100644 --- a/docs/mfc/closing-files.md +++ b/docs/mfc/closing-files.md @@ -4,6 +4,7 @@ title: "Closing Files" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, file operations", "files [MFC], closing"] ms.assetid: 8415a3a8-3c75-45b0-ac2a-d5385f49bdb3 +ms.topic: how-to --- # Closing Files diff --git a/docs/mfc/closing-the-dialog-box.md b/docs/mfc/closing-the-dialog-box.md index aa6b937c30c..38ab0e8290a 100644 --- a/docs/mfc/closing-the-dialog-box.md +++ b/docs/mfc/closing-the-dialog-box.md @@ -4,6 +4,7 @@ title: "Closing the Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], closing", "dialog boxes [MFC], closing"] ms.assetid: 946f5675-c482-46a4-a5dd-34fe138ffae5 +ms.topic: concept-article --- # Closing the Dialog Box diff --git a/docs/mfc/cobject-class-frequently-asked-questions.md b/docs/mfc/cobject-class-frequently-asked-questions.md index 564c284e612..2689374466d 100644 --- a/docs/mfc/cobject-class-frequently-asked-questions.md +++ b/docs/mfc/cobject-class-frequently-asked-questions.md @@ -4,6 +4,7 @@ title: "CObject Class: Frequently Asked Questions" ms.date: "11/04/2016" helpviewer_keywords: ["CObject class [MFC], FAQ"] ms.assetid: 809a8b99-a2f8-4e16-8b4b-023c94f4125c +ms.topic: faq --- # CObject Class: Frequently Asked Questions diff --git a/docs/mfc/command-routing-illustration.md b/docs/mfc/command-routing-illustration.md index 53adb566465..29ae9a7f00a 100644 --- a/docs/mfc/command-routing-illustration.md +++ b/docs/mfc/command-routing-illustration.md @@ -4,6 +4,7 @@ title: "Command Routing Illustration" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, command routing", "command handling [MFC], routing commands", "command routing [MFC], OnCmdMsg handler"] ms.assetid: 4b7b4741-565f-4878-b076-fd85c670f87f +ms.topic: how-to --- # Command Routing Illustration diff --git a/docs/mfc/command-routing.md b/docs/mfc/command-routing.md index edb23094cdc..a3514eb4e28 100644 --- a/docs/mfc/command-routing.md +++ b/docs/mfc/command-routing.md @@ -4,6 +4,7 @@ title: "Command Routing" ms.date: "09/06/2019" helpviewer_keywords: ["MFC, command routing", "command handling [MFC], routing commands", "handlers [MFC]", "handlers, command [MFC]", "command routing"] ms.assetid: 9393a956-bdd4-47c5-9013-dbd680433f93 +ms.topic: how-to --- # Command Routing diff --git a/docs/mfc/communicating-with-a-tree-control.md b/docs/mfc/communicating-with-a-tree-control.md index 621df475e70..959c9f1fbd6 100644 --- a/docs/mfc/communicating-with-a-tree-control.md +++ b/docs/mfc/communicating-with-a-tree-control.md @@ -4,6 +4,7 @@ title: "Communicating with a Tree Control" ms.date: "11/04/2016" helpviewer_keywords: ["tree controls [MFC], communicating with", "CTreeCtrl class [MFC], calling member functions", "communications, tree controls", "tree controls"] ms.assetid: 680ad9ee-b11f-452d-93fa-501ca7d7e069 +ms.topic: concept-article --- # Communicating with a Tree Control diff --git a/docs/mfc/creating-a-ctoolbarctrl-object.md b/docs/mfc/creating-a-ctoolbarctrl-object.md index 8e8af2739ef..a474106b412 100644 --- a/docs/mfc/creating-a-ctoolbarctrl-object.md +++ b/docs/mfc/creating-a-ctoolbarctrl-object.md @@ -4,6 +4,7 @@ title: "Creating a CToolBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["toolbar controls [MFC], creating", "CToolBarCtrl class [MFC], creating toolbars"] ms.assetid: a4f6bf0c-0195-4dbf-a09e-aee503e19dc3 +ms.topic: how-to --- # Creating a CToolBarCtrl Object diff --git a/docs/mfc/creating-a-dialog-class-with-code-wizards.md b/docs/mfc/creating-a-dialog-class-with-code-wizards.md index 372dc65cd7b..b57a8a37d9f 100644 --- a/docs/mfc/creating-a-dialog-class-with-code-wizards.md +++ b/docs/mfc/creating-a-dialog-class-with-code-wizards.md @@ -4,6 +4,7 @@ title: "Creating a Dialog Class with Code Wizards" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], creating", "MFC dialog boxes, creating", "code wizards", "dialog classes [MFC], creating"] ms.assetid: a7157b9d-f1a8-4381-a4cf-180cd2c7f1b2 +ms.topic: concept-article --- # Creating a Dialog Class with Code Wizards diff --git a/docs/mfc/creating-a-modeless-property-sheet.md b/docs/mfc/creating-a-modeless-property-sheet.md index 83f9ef25951..923076c45a7 100644 --- a/docs/mfc/creating-a-modeless-property-sheet.md +++ b/docs/mfc/creating-a-modeless-property-sheet.md @@ -4,6 +4,7 @@ title: "Creating a Modeless Property Sheet" ms.date: "11/04/2016" helpviewer_keywords: ["modeless property sheets", "property sheets, modeless", "Create method [MFC], property sheets"] ms.assetid: eafd8a92-cc67-4a69-a5fb-742c920d1ae8 +ms.topic: concept-article --- # Creating a Modeless Property Sheet diff --git a/docs/mfc/creating-a-rebar-control.md b/docs/mfc/creating-a-rebar-control.md index 8aec855df37..ecbd59c97a3 100644 --- a/docs/mfc/creating-a-rebar-control.md +++ b/docs/mfc/creating-a-rebar-control.md @@ -4,6 +4,7 @@ title: "Creating a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["rebar controls [MFC], creating", "CReBarCtrl class [MFC], creating"] ms.assetid: 0a012e08-772b-4f6a-af86-7cb651d11d3e +ms.topic: how-to --- # Creating a Rebar Control diff --git a/docs/mfc/creating-an-active-document-container-application.md b/docs/mfc/creating-an-active-document-container-application.md index f0cd926a641..c1ef6e9ac2d 100644 --- a/docs/mfc/creating-an-active-document-container-application.md +++ b/docs/mfc/creating-an-active-document-container-application.md @@ -4,6 +4,7 @@ title: "Creating an Active Document Container Application" ms.date: "11/04/2016" helpviewer_keywords: ["active documents [MFC], containers", "containers [MFC], active document", "active document containers [MFC], creating", "MFC COM, active document containment", "applications [MFC], active document container"] ms.assetid: 14e2d022-a6c5-4249-8712-706b0f4433f7 +ms.topic: how-to --- # Creating an Active Document Container Application diff --git a/docs/mfc/creating-an-extended-combo-box-control.md b/docs/mfc/creating-an-extended-combo-box-control.md index 9f266d75164..c39f606ba2e 100644 --- a/docs/mfc/creating-an-extended-combo-box-control.md +++ b/docs/mfc/creating-an-extended-combo-box-control.md @@ -4,6 +4,7 @@ title: "Creating an Extended Combo Box Control" ms.date: "11/04/2016" helpviewer_keywords: ["extended combo boxes", "CComboBoxEx class [MFC], creating extended combo box controls", "extended combo boxes [MFC], creating"] ms.assetid: a964267e-97b6-4e77-9f89-55bb5c68913f +ms.topic: how-to --- # Creating an Extended Combo Box Control diff --git a/docs/mfc/creating-and-displaying-dialog-boxes.md b/docs/mfc/creating-and-displaying-dialog-boxes.md index 918e0c938bd..233faf62b31 100644 --- a/docs/mfc/creating-and-displaying-dialog-boxes.md +++ b/docs/mfc/creating-and-displaying-dialog-boxes.md @@ -4,6 +4,7 @@ title: "Creating and Displaying Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["modal dialog boxes [MFC], creating", "opening dialog boxes", "modeless dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating", "MFC dialog boxes [MFC], displaying"] ms.assetid: 1c5219ee-8b46-44bc-9708-83705d4f248b +ms.topic: concept-article --- # Creating and Displaying Dialog Boxes diff --git a/docs/mfc/creating-document-frame-windows.md b/docs/mfc/creating-document-frame-windows.md index b79b488838c..5c2f43a082b 100644 --- a/docs/mfc/creating-document-frame-windows.md +++ b/docs/mfc/creating-document-frame-windows.md @@ -4,6 +4,7 @@ title: "Creating Document Frame Windows" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], creating", "document templates [MFC], and document frame windows", "windows [MFC], creating", "runtime, class information", "run-time class [MFC], and document frame window creation", "document frame windows [MFC], creating", "MFC, frame windows"] ms.assetid: 8671e239-b76f-4dea-afa8-7024e6e58ff5 +ms.topic: concept-article --- # Creating Document Frame Windows diff --git a/docs/mfc/creating-modal-dialog-boxes.md b/docs/mfc/creating-modal-dialog-boxes.md index 269f02812d0..6275a7e461f 100644 --- a/docs/mfc/creating-modal-dialog-boxes.md +++ b/docs/mfc/creating-modal-dialog-boxes.md @@ -4,6 +4,7 @@ title: "Creating Modal Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["modal dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating", "MFC dialog boxes [MFC], modal"] ms.assetid: 26c7a68c-79f6-4862-a5a8-6024984644d2 +ms.topic: concept-article --- # Creating Modal Dialog Boxes diff --git a/docs/mfc/creating-modeless-dialog-boxes.md b/docs/mfc/creating-modeless-dialog-boxes.md index 44fdf5e7405..92236e26218 100644 --- a/docs/mfc/creating-modeless-dialog-boxes.md +++ b/docs/mfc/creating-modeless-dialog-boxes.md @@ -4,6 +4,7 @@ title: "Creating Modeless Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], modeless", "modeless dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating"] ms.assetid: 70d78c7f-3d40-477b-9f78-0f33c359f88b +ms.topic: concept-article --- # Creating Modeless Dialog Boxes diff --git a/docs/mfc/creating-new-documents-windows-and-views.md b/docs/mfc/creating-new-documents-windows-and-views.md index 2137a6f149a..c5a9792921f 100644 --- a/docs/mfc/creating-new-documents-windows-and-views.md +++ b/docs/mfc/creating-new-documents-windows-and-views.md @@ -4,6 +4,7 @@ title: "Creating New Documents, Windows, and Views" ms.date: "11/19/2018" helpviewer_keywords: ["MDI [MFC], creating windows", "window objects [MFC], creating", "objects [MFC], creating document objects", "MFC default objects", "frame windows [MFC], creating", "windows [MFC], MDI", "MFC, documents", "view objects [MFC], creating", "windows [MFC], creating", "overriding, default view behavior", "views [MFC], initializing", "customizing MFC default objects", "MFC, frame windows", "MFC, views", "MDI [MFC], frame windows", "child windows [MFC], creating MDI", "view objects [MFC]", "document objects [MFC], creating", "MFC default objects [MFC], customizing", "views [MFC], overriding default behavior", "initializing views [MFC]"] ms.assetid: 88aa1f5f-2078-4603-b16b-a2b4c7b4a2a3 +ms.topic: concept-article --- # Creating New Documents, Windows, and Views diff --git a/docs/mfc/creating-stack-and-queue-collections.md b/docs/mfc/creating-stack-and-queue-collections.md index 36c7c40c713..e0e1c818970 100644 --- a/docs/mfc/creating-stack-and-queue-collections.md +++ b/docs/mfc/creating-stack-and-queue-collections.md @@ -4,6 +4,7 @@ title: "Creating Stack and Queue Collections" ms.date: "11/04/2016" helpviewer_keywords: ["MFC collection classes [MFC], stack collections", "collections, stack", "stack", "collection classes [MFC], creating", "queue collections", "MFC collection classes [MFC], queue collections", "stack collections", "collections, queue"] ms.assetid: 3c7bc198-35f0-4fc3-aaed-6005a0f22638 +ms.topic: how-to --- # Creating Stack and Queue Collections diff --git a/docs/mfc/creating-the-date-and-time-picker-control.md b/docs/mfc/creating-the-date-and-time-picker-control.md index 7e9b2348967..1c30cd048b0 100644 --- a/docs/mfc/creating-the-date-and-time-picker-control.md +++ b/docs/mfc/creating-the-date-and-time-picker-control.md @@ -4,6 +4,7 @@ title: "Creating the Date and Time Picker Control" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC], creating", "CDateTimeCtrl class [MFC], creating"] ms.assetid: 764ec2fb-98cd-478b-a5f2-d63f0bb12279 +ms.topic: how-to --- # Creating the Date and Time Picker Control diff --git a/docs/mfc/creating-the-dialog-resource.md b/docs/mfc/creating-the-dialog-resource.md index 7ccf5adb5b8..7aa4d5179b2 100644 --- a/docs/mfc/creating-the-dialog-resource.md +++ b/docs/mfc/creating-the-dialog-resource.md @@ -4,6 +4,7 @@ title: "Creating the Dialog Resource" ms.date: "11/04/2016" helpviewer_keywords: ["dialog resources", "MFC dialog boxes [MFC], creating", "dialog templates [MFC], creating dialog resource", "templates [MFC], creating", "resources [MFC], creating dialog boxes", "MFC dialog boxes [MFC], dialog resource"] ms.assetid: 0b83bd33-14d3-4611-8129-fccdae18053e +ms.topic: concept-article --- # Creating the Dialog Resource diff --git a/docs/mfc/creating-the-header-control.md b/docs/mfc/creating-the-header-control.md index 2afab96c98b..e16b83e1204 100644 --- a/docs/mfc/creating-the-header-control.md +++ b/docs/mfc/creating-the-header-control.md @@ -4,6 +4,7 @@ title: "Creating the Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["CHeaderCtrl class [MFC], creating", "header controls [MFC], creating"] ms.assetid: 7864d9d2-4a2c-4622-b58b-7b110a1e28d2 +ms.topic: how-to --- # Creating the Header Control diff --git a/docs/mfc/creating-the-image-lists.md b/docs/mfc/creating-the-image-lists.md index 537f21582c2..da8197206e5 100644 --- a/docs/mfc/creating-the-image-lists.md +++ b/docs/mfc/creating-the-image-lists.md @@ -4,6 +4,7 @@ title: "Creating the Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], creating image lists for", "image lists [MFC], creating for CListCtrl", "lists [MFC], image"] ms.assetid: c2768515-deba-49e8-a6f3-5be6482afb19 +ms.topic: concept-article --- # Creating the Image Lists diff --git a/docs/mfc/creating-the-list-control.md b/docs/mfc/creating-the-list-control.md index 3d3ae78237d..cd17ed745c3 100644 --- a/docs/mfc/creating-the-list-control.md +++ b/docs/mfc/creating-the-list-control.md @@ -4,6 +4,7 @@ title: "Creating the List Control" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], creating control", "list controls [MFC]"] ms.assetid: a4cb1729-31b6-4d2b-a44b-367474848a39 +ms.topic: how-to --- # Creating the List Control diff --git a/docs/mfc/creating-the-month-calendar-control.md b/docs/mfc/creating-the-month-calendar-control.md index 623738f5816..21319b9e5bf 100644 --- a/docs/mfc/creating-the-month-calendar-control.md +++ b/docs/mfc/creating-the-month-calendar-control.md @@ -4,6 +4,7 @@ title: "Creating the Month Calendar Control" ms.date: "11/04/2016" helpviewer_keywords: ["CMonthCalCtrl class [MFC], creating", "month calendar controls [MFC], creating", "month calendar controls [MFC]"] ms.assetid: 185cc642-85e9-4365-8a4c-d90b75b010f7 +ms.topic: how-to --- # Creating the Month Calendar Control diff --git a/docs/mfc/creating-the-tab-control.md b/docs/mfc/creating-the-tab-control.md index 4cad7fbd53d..ec4d8a7626b 100644 --- a/docs/mfc/creating-the-tab-control.md +++ b/docs/mfc/creating-the-tab-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TCS_EX_REGISTERDROP", "TCS_EX_FLATSEPARATORS"] helpviewer_keywords: ["TCS_EX_REGISTERDROP extended style [MFC]", "tab controls [MFC], creating", "CTabCtrl class [MFC], creating", "TCS_EX_FLATSEPARATORS extended style"] ms.assetid: 3a9c2d64-f5f4-41ea-84ab-fceb73c3dbdc +ms.topic: how-to --- # Creating the Tab Control diff --git a/docs/mfc/creating-windows.md b/docs/mfc/creating-windows.md index 93dd62fceb4..ffa63d22eda 100644 --- a/docs/mfc/creating-windows.md +++ b/docs/mfc/creating-windows.md @@ -4,6 +4,7 @@ title: "Creating Windows" ms.date: "11/04/2016" helpviewer_keywords: ["object creation [MFC], windows", "windows [MFC], creating", "CWnd objects [MFC]", "CWnd objects [MFC], creating"] ms.assetid: f5ff91a6-4069-47d7-9177-1e6c80d3792c +ms.topic: concept-article --- # Creating Windows diff --git a/docs/mfc/creating-your-dialog-class.md b/docs/mfc/creating-your-dialog-class.md index 2c750d4504c..904e6f42875 100644 --- a/docs/mfc/creating-your-dialog-class.md +++ b/docs/mfc/creating-your-dialog-class.md @@ -4,6 +4,7 @@ title: "Creating Your Dialog Class" ms.date: "09/06/2019" helpviewer_keywords: ["dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating", "files [MFC], creating", "dialog classes [MFC], Add Class Wizard", "dialog classes [MFC], creating"] ms.assetid: d5321741-da41-47a8-bb1c-6a0e8b28c4c1 +ms.topic: concept-article --- # Creating Your Dialog Class diff --git a/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md b/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md index f69fbb571af..7a40c5a6116 100644 --- a/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md +++ b/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TBSTYLE_"] helpviewer_keywords: ["flat toolbars", "CToolBar class [MFC], styles", "transparent toolbars", "TBSTYLE_ styles [MFC]", "CToolBarCtrl class [MFC], object styles", "toolbar controls [MFC], style"] ms.assetid: fd0a73db-7ad1-4fe4-889b-02c3980f49e8 +ms.topic: concept-article --- # Customizing the Appearance of a Toolbar Control diff --git a/docs/mfc/customizing-the-header-item-s-appearance.md b/docs/mfc/customizing-the-header-item-s-appearance.md index 8a47aec3d32..7324136f93a 100644 --- a/docs/mfc/customizing-the-header-item-s-appearance.md +++ b/docs/mfc/customizing-the-header-item-s-appearance.md @@ -4,6 +4,7 @@ title: "Customizing the Header Item's Appearance" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], customization of items", "CHeaderCtrl class [MFC], customizing the items", "HDS_ styles"] ms.assetid: b1e1e326-ec7d-4dbd-a46f-96a3e2055618 +ms.topic: concept-article --- # Customizing the Header Item's Appearance diff --git a/docs/mfc/debugging-and-exception-classes.md b/docs/mfc/debugging-and-exception-classes.md index 74df8a9f60a..95670e20ee0 100644 --- a/docs/mfc/debugging-and-exception-classes.md +++ b/docs/mfc/debugging-and-exception-classes.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["vc.classes.debug"] helpviewer_keywords: ["debugging [MFC], exception classes", "debugging [MFC], classes for debugging"] ms.assetid: 0d158efd-2e62-452e-9d2a-d3c30dfee7f9 +ms.topic: concept-article --- # Debugging and Exception Classes diff --git a/docs/mfc/debugging-support-classes.md b/docs/mfc/debugging-support-classes.md index 558f225543e..e9b03065b8c 100644 --- a/docs/mfc/debugging-support-classes.md +++ b/docs/mfc/debugging-support-classes.md @@ -4,6 +4,7 @@ title: "Debugging Support Classes" ms.date: "11/04/2016" helpviewer_keywords: ["debugging memory leaks, MFC", "memory allocation, debugging dynamic", "debugging [MFC], classes for debugging", "memory allocation, debugging dynamic allocation", "dynamic memory allocation", "debugging [MFC], memory leaks", "memory leaks, MFC debug classes"] ms.assetid: d79e084a-8326-4251-8700-4efac07c511e +ms.topic: concept-article --- # Debugging Support Classes diff --git a/docs/mfc/declaring-message-handler-functions.md b/docs/mfc/declaring-message-handler-functions.md index 04adeb9627f..cc9258d87a0 100644 --- a/docs/mfc/declaring-message-handler-functions.md +++ b/docs/mfc/declaring-message-handler-functions.md @@ -4,6 +4,7 @@ title: "Declaring Message Handler Functions" ms.date: "11/04/2016" helpviewer_keywords: ["declaring functions, message handler functions [MFC]"] ms.assetid: f8d3dbc1-4500-4f1e-a18d-7371edf36386 +ms.topic: concept-article --- # Declaring Message Handler Functions diff --git a/docs/mfc/deleting-all-objects-in-a-cobject-collection.md b/docs/mfc/deleting-all-objects-in-a-cobject-collection.md index 116c8782044..d57fae1c586 100644 --- a/docs/mfc/deleting-all-objects-in-a-cobject-collection.md +++ b/docs/mfc/deleting-all-objects-in-a-cobject-collection.md @@ -4,6 +4,7 @@ title: "Deleting All Objects in a CObject Collection" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], deleting in collections", "objects in CObject collections, deleting", "CObject class [MFC], deleting in collection", "collection classes [MFC], deleting all objects", "CObject class collection", "objects in CObject collections", "collection classes [MFC], shared objects"] ms.assetid: 81d2c1d5-a0a5-46e1-8ab9-82b45cf7afd2 +ms.topic: how-to --- # Deleting All Objects in a CObject Collection diff --git a/docs/mfc/deriving-a-class-from-cobject.md b/docs/mfc/deriving-a-class-from-cobject.md index 3e290c2a4c5..bde7b72bbb9 100644 --- a/docs/mfc/deriving-a-class-from-cobject.md +++ b/docs/mfc/deriving-a-class-from-cobject.md @@ -4,6 +4,7 @@ title: "Deriving a Class from CObject" ms.date: "11/04/2016" helpviewer_keywords: ["DECLARE_DYNCREATE macro [MFC]", "DECLARE_SERIAL macro [MFC]", "macros [MFC], serialization", "serialization [MFC], macros", "DECLARE_DYNAMIC macro [MFC]", "derived classes [MFC], from CObject", "CObject class [MFC], deriving serializable classes", "CObject class [MFC], deriving from"] ms.assetid: 5ea4ea41-08b5-4bd8-b247-c5de8c152a27 +ms.topic: how-to --- # Deriving a Class from CObject diff --git a/docs/mfc/deriving-a-document-class-from-cdocument.md b/docs/mfc/deriving-a-document-class-from-cdocument.md index db461ebc77c..1184517b913 100644 --- a/docs/mfc/deriving-a-document-class-from-cdocument.md +++ b/docs/mfc/deriving-a-document-class-from-cdocument.md @@ -4,6 +4,7 @@ title: "Deriving a Document Class from CDocument" ms.date: "11/04/2016" helpviewer_keywords: ["CDocument class [MFC], deriving from", "classes [MFC], deriving from CDocument", "document objects [MFC], derived", "derived classes [MFC], functions often overridden", "document classes [MFC], functions often overridden"] ms.assetid: e6a198e0-9799-43c0-83c5-04174d8b532c +ms.topic: concept-article --- # Deriving a Document Class from CDocument diff --git a/docs/mfc/deriving-controls-from-a-standard-control.md b/docs/mfc/deriving-controls-from-a-standard-control.md index 87576b2f0fb..3489abe0ff7 100644 --- a/docs/mfc/deriving-controls-from-a-standard-control.md +++ b/docs/mfc/deriving-controls-from-a-standard-control.md @@ -4,6 +4,7 @@ title: "Deriving Controls from a Standard Control" ms.date: "11/04/2016" helpviewer_keywords: ["standard controls [MFC], deriving controls from", "common controls [MFC], deriving from", "derived controls", "controls [MFC], derived", "Windows common controls [MFC], deriving from", "standard controls"] ms.assetid: a6f84315-7007-4e0e-8576-78be81254802 +ms.topic: how-to --- # Deriving Controls from a Standard Control diff --git a/docs/mfc/destroying-frame-windows.md b/docs/mfc/destroying-frame-windows.md index a640fe5351f..4bd96d2b29f 100644 --- a/docs/mfc/destroying-frame-windows.md +++ b/docs/mfc/destroying-frame-windows.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["PostNcDestroy"] helpviewer_keywords: ["Default method [MFC]", "DestroyWindow method [MFC]", "frame windows [MFC], destroying", "OnNcDestroy method, and frame windows", "document frame windows [MFC], destroying", "destroying frame windows", "MFC, frame windows", "windows [MFC], destroying", "OnClose method [MFC]", "PostNcDestroy method [MFC]"] ms.assetid: 5affca77-1999-4507-a2b2-9aa226611b4b +ms.topic: concept-article --- # Destroying Frame Windows diff --git a/docs/mfc/destroying-the-dialog-box.md b/docs/mfc/destroying-the-dialog-box.md index 1c0da1b3a81..c8a2f0dbfbf 100644 --- a/docs/mfc/destroying-the-dialog-box.md +++ b/docs/mfc/destroying-the-dialog-box.md @@ -4,6 +4,7 @@ title: "Destroying the Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], deleting", "destruction, dialog box", "dialog boxes [MFC], destroying", "dialog boxes [MFC], removing", "modeless dialog boxes [MFC], destroying", "MFC dialog boxes [MFC], destroying", "modal dialog boxes [MFC], destroying"] ms.assetid: dabceee7-3639-4d85-bf34-73515441b3d0 +ms.topic: concept-article --- # Destroying the Dialog Box diff --git a/docs/mfc/destroying-the-list-control.md b/docs/mfc/destroying-the-list-control.md index ac0a7fbcdf0..760823ee5d8 100644 --- a/docs/mfc/destroying-the-list-control.md +++ b/docs/mfc/destroying-the-list-control.md @@ -4,6 +4,7 @@ title: "Destroying the List Control" ms.date: "11/04/2016" helpviewer_keywords: ["list controls [MFC], destroying", "CListCtrl class [MFC], destroying controls"] ms.assetid: 513ec820-3a02-49d2-b073-a6a7a3fc91b3 +ms.topic: concept-article --- # Destroying the List Control diff --git a/docs/mfc/destroying-window-objects.md b/docs/mfc/destroying-window-objects.md index 462e4a379f5..3a02e91f0bc 100644 --- a/docs/mfc/destroying-window-objects.md +++ b/docs/mfc/destroying-window-objects.md @@ -4,6 +4,7 @@ title: "Destroying Window Objects" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], destroying", "window objects [MFC], deleting", "window objects [MFC], destroying", "window objects [MFC], removing"] ms.assetid: 3241fea0-c614-4a25-957d-20f21bd5fd0c +ms.topic: concept-article --- # Destroying Window Objects diff --git a/docs/mfc/detaching-a-cwnd-from-its-hwnd.md b/docs/mfc/detaching-a-cwnd-from-its-hwnd.md index 213b8ed1995..abacdcd81f5 100644 --- a/docs/mfc/detaching-a-cwnd-from-its-hwnd.md +++ b/docs/mfc/detaching-a-cwnd-from-its-hwnd.md @@ -4,6 +4,7 @@ title: "Detaching a CWnd from Its HWND" ms.date: "11/04/2016" helpviewer_keywords: ["HWND, detaching CWnd from", "removing HWNDs from CWnds", "CWnd objects [MFC], detaching from HWND", "detaching CWnds from HWNDs", "Detach method (CWnd class)"] ms.assetid: 6efadf84-0517-4a3f-acfd-216e088f19c6 +ms.topic: concept-article --- # Detaching a CWnd from Its HWND diff --git a/docs/mfc/docking-and-floating-toolbars.md b/docs/mfc/docking-and-floating-toolbars.md index 06db3ca56cd..2dc9f54a2a7 100644 --- a/docs/mfc/docking-and-floating-toolbars.md +++ b/docs/mfc/docking-and-floating-toolbars.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["CBRS_SIZE_DYNAMIC", "CBRS_SIZE_FIXED"] helpviewer_keywords: ["size [MFC], toolbars", "size", "frame windows [MFC], toolbar docking", "CBRS_ALIGN_ANY constant [MFC]", "palettes, floating", "toolbars [MFC], docking", "CBRS_SIZE_DYNAMIC constant [MFC]", "floating toolbars", "toolbars [MFC], size", "toolbars [MFC], floating", "fixed-size toolbars", "CBRS_SIZE_FIXED constant [MFC]", "toolbar controls [MFC], wrapping", "toolbars [MFC], wrapping", "floating palettes"] ms.assetid: b7f9f9d4-f629-47d2-a3c4-2b33fa6b51e4 +ms.topic: concept-article --- # Docking and Floating Toolbars diff --git a/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md b/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md index 0371f4f3556..f3ecc1650ed 100644 --- a/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md +++ b/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md @@ -4,6 +4,7 @@ title: "Dragging and Dropping Files in a Frame Window" ms.date: "11/04/2016" helpviewer_keywords: ["drag and drop [MFC], files", "drag and drop [MFC], File Manager", "Windows Explorer [MFC]", "File Manager drag and drop support [MFC]", "files [MFC], drag and drop", "frame windows [MFC], dragging and dropping files in", "drag and drop [MFC], Windows Explorer"] ms.assetid: 85560fe9-121b-4105-bd7b-216b966e19fa +ms.topic: concept-article --- # Dragging and Dropping Files in a Frame Window diff --git a/docs/mfc/dragging-images-from-an-image-list.md b/docs/mfc/dragging-images-from-an-image-list.md index d1978d040d1..ecea5051da3 100644 --- a/docs/mfc/dragging-images-from-an-image-list.md +++ b/docs/mfc/dragging-images-from-an-image-list.md @@ -4,6 +4,7 @@ title: "Dragging Images from an Image List" ms.date: "11/04/2016" helpviewer_keywords: ["CImageList class [MFC], dragging images from", "dragging images from image lists [MFC]", "image lists [MFC], dragging images from", "images [MFC], dragging from image lists"] ms.assetid: af691db8-e4f0-4046-b7b9-9acc68d3713d +ms.topic: concept-article --- # Dragging Images from an Image List diff --git a/docs/mfc/drawing-and-printing-classes.md b/docs/mfc/drawing-and-printing-classes.md index 69a545ce583..d43f6e9affa 100644 --- a/docs/mfc/drawing-and-printing-classes.md +++ b/docs/mfc/drawing-and-printing-classes.md @@ -4,6 +4,7 @@ title: "Drawing and Printing Classes" ms.date: "11/04/2016" helpviewer_keywords: ["output [MFC], graphical classes", "drawing [MFC], classes", "printing classes [MFC]", "graphics [MFC], graphical output classes"] ms.assetid: 2781c599-a038-462a-98ca-634b07ee22b0 +ms.topic: concept-article --- # Drawing and Printing Classes diff --git a/docs/mfc/drawing-images-from-an-image-list.md b/docs/mfc/drawing-images-from-an-image-list.md index 12206237232..0f0e5cd6019 100644 --- a/docs/mfc/drawing-images-from-an-image-list.md +++ b/docs/mfc/drawing-images-from-an-image-list.md @@ -4,6 +4,7 @@ title: "Drawing Images from an Image List" ms.date: "11/04/2016" helpviewer_keywords: ["CImageList class [MFC], drawing images from", "drawing [MFC], images from image lists", "image lists [MFC], drawing images from", "images [MFC], drawing"] ms.assetid: 2f6063fb-1c28-45f8-a333-008c064db11c +ms.topic: concept-article --- # Drawing Images from an Image List diff --git a/docs/mfc/drawing-in-a-view.md b/docs/mfc/drawing-in-a-view.md index 88d9d6fd1b5..ecd59ea9512 100644 --- a/docs/mfc/drawing-in-a-view.md +++ b/docs/mfc/drawing-in-a-view.md @@ -4,6 +4,7 @@ title: "Drawing in a View" ms.date: "11/04/2016" helpviewer_keywords: ["drawing [MFC], in views", "views [MFC], printing", "views [MFC], updating", "printing [MFC], views", "views [MFC], rendering", "printing views [MFC]", "paint messages in view class [MFC]", "device contexts, screen drawings"] ms.assetid: e3761db6-0f19-4482-a4cd-ac38ef7c4d3a +ms.topic: how-to --- # Drawing in a View diff --git a/docs/mfc/drawing-tool-classes.md b/docs/mfc/drawing-tool-classes.md index 3e7fda79fab..0e33ab2346e 100644 --- a/docs/mfc/drawing-tool-classes.md +++ b/docs/mfc/drawing-tool-classes.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["vc.classes.drawing"] helpviewer_keywords: ["drawing [MFC], tool classes", "screen output classes [MFC]", "output classes [MFC]"] ms.assetid: e907bd89-38b5-47c9-b76a-95e0bf3bb41d +ms.topic: concept-article --- # Drawing Tool Classes diff --git a/docs/mfc/enabling-tool-tips.md b/docs/mfc/enabling-tool-tips.md index c101a6b1fb1..4f59728c5a1 100644 --- a/docs/mfc/enabling-tool-tips.md +++ b/docs/mfc/enabling-tool-tips.md @@ -4,6 +4,7 @@ title: "Enabling Tool Tips" ms.date: "11/04/2016" helpviewer_keywords: ["initializing tool tips [MFC]", "enabling tool tips [MFC]", "tool tips [MFC], initializing", "tool tips [MFC], enabling"] ms.assetid: 06b7c889-7722-4ce6-8b88-9efa50fe6369 +ms.topic: how-to --- # Enabling Tool Tips diff --git a/docs/mfc/exchanging-data.md b/docs/mfc/exchanging-data.md index ad56d4f5976..8ea303ddf53 100644 --- a/docs/mfc/exchanging-data.md +++ b/docs/mfc/exchanging-data.md @@ -4,6 +4,7 @@ title: "Exchanging Data" ms.date: "11/04/2016" helpviewer_keywords: ["property sheets [MFC], data exchange", "exchanging data with property sheets [MFC]", "DDX (dialog data exchange) [MFC], property sheets"] ms.assetid: 689f02d0-51a9-455b-8ffb-5b44f0aefa28 +ms.topic: concept-article --- # Exchanging Data diff --git a/docs/mfc/handling-commands-in-the-document.md b/docs/mfc/handling-commands-in-the-document.md index 9d43c35b0d5..f821152d3ec 100644 --- a/docs/mfc/handling-commands-in-the-document.md +++ b/docs/mfc/handling-commands-in-the-document.md @@ -4,6 +4,7 @@ title: "Handling Commands in the Document" ms.date: "11/04/2016" helpviewer_keywords: ["message maps [MFC], in document class", "command handling [MFC]", "documents [MFC], message maps", "message handling [MFC], WM_COMMAND messages", "command handling [MFC], commands in documents", "documents [MFC], handling messages in"] ms.assetid: c7375584-27af-4275-b2fd-afea476785d0 +ms.topic: concept-article --- # Handling Commands in the Document diff --git a/docs/mfc/handling-customization-notifications.md b/docs/mfc/handling-customization-notifications.md index 86936b07f95..1d2ffb237db 100644 --- a/docs/mfc/handling-customization-notifications.md +++ b/docs/mfc/handling-customization-notifications.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TBN_CUSTHELP", "TBN_QUERYINSERT", "TBNOTIFY", "NMHDR", "TBN_TOOLBARCHANGE", "TBN_ENDDRAG", "NM_SETFOCUS", "TBN_RESET", "NM_RETURN", "NM_ENDWAIT", "NM_STARTWAIT", "TBN_BEGINDRAG", "NM_OUTOFMEMORY", "TBN_QUERYDELETE", "NM_DBLCLK", "TBN_ENDADJUST", "NM_KILLFOCUS", "NM_RCLICK", "TBN_BEGINADJUST", "NM_CLICK"] helpviewer_keywords: ["TBN_ENDADJUST notification [MFC]", "TBNOTIFY notification [MFC]", "TBN_BEGINDRAG notification [MFC]", "TBN_TOOLBARCHANGE notification [MFC]", "NM_CLICK notification [MFC]", "NM_RETURN notification [MFC]", "NM_RCLICK notification [MFC]", "TBN_ENDDRAG notification [MFC]", "TBN_BEGINADJUST notification [MFC]", "NM_ENDWAIT notification [MFC]", "NM_KILLFOCUS notification [MFC]", "NM_SETFOCUS notification [MFC]", "NM_OUTOFMEMORY notification [MFC]", "TBN_QUERYINSERT notification [MFC]", "NMHDR [MFC]", "NM_STARTWAIT notification [MFC]", "CToolBarCtrl class [MFC], handling notifications", "TBN_CUSTHELP notification [MFC]", "TBN_RESET notification [MFC]", "NM_DBLCLK notification [MFC]", "TBN_QUERYDELETE notification [MFC]", "NM_RDBLCLK notification [MFC]", "TBN_GETBUTTONINFO notification [MFC]"] ms.assetid: 219ea08e-7515-4b98-85cb-47120f08c0a2 +ms.topic: concept-article --- # Handling Customization Notifications diff --git a/docs/mfc/handling-reflected-messages.md b/docs/mfc/handling-reflected-messages.md index 95b15f8a980..f7d74de5c86 100644 --- a/docs/mfc/handling-reflected-messages.md +++ b/docs/mfc/handling-reflected-messages.md @@ -4,6 +4,7 @@ title: "Handling Reflected Messages" ms.date: "11/04/2016" helpviewer_keywords: ["message handling [MFC], reflected messages", "reflected messages, handling"] ms.assetid: 147a4e0c-51cc-4447-a8e1-c28b4cece578 +ms.topic: concept-article --- # Handling Reflected Messages diff --git a/docs/mfc/handling-the-apply-button.md b/docs/mfc/handling-the-apply-button.md index 0c1e31e8d0d..3cfdef6bf9d 100644 --- a/docs/mfc/handling-the-apply-button.md +++ b/docs/mfc/handling-the-apply-button.md @@ -4,6 +4,7 @@ title: "Handling the Apply Button" ms.date: "11/04/2016" helpviewer_keywords: ["Apply button in property sheet", "property sheets, Apply button"] ms.assetid: 7e977015-59b8-406f-b545-aad0bfd8d55b +ms.topic: concept-article --- # Handling the Apply Button diff --git a/docs/mfc/handling-tool-tip-notifications.md b/docs/mfc/handling-tool-tip-notifications.md index d950042ea4e..8c1ed327ee5 100644 --- a/docs/mfc/handling-tool-tip-notifications.md +++ b/docs/mfc/handling-tool-tip-notifications.md @@ -4,6 +4,7 @@ title: "Handling Tool Tip Notifications" ms.date: "11/04/2016" helpviewer_keywords: ["TOOLTIPTEXT structure [MFC]", "CToolBarCtrl class [MFC], handling notifications", "notifications [MFC], tool tips", "tool tips [MFC], notifications"] ms.assetid: ddb93b5f-2e4f-4537-8053-3453c86e2bbb +ms.topic: concept-article --- # Handling Tool Tip Notifications diff --git a/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md b/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md index 982332e7103..12058fb2d4e 100644 --- a/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md +++ b/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TTN_NEEDTEXT"] helpviewer_keywords: ["TTN_NEEDTEXT message [MFC]", "notifications [MFC], tool tips", "tool tips [MFC], notifications"] ms.assetid: d0370a65-21ba-4676-bcc5-8cf851bbb15c +ms.topic: concept-article --- # Handling TTN_NEEDTEXT Notification for Tool Tips diff --git a/docs/mfc/handling-windows-messages-in-your-dialog-box.md b/docs/mfc/handling-windows-messages-in-your-dialog-box.md index 170b2d46512..66db7e66085 100644 --- a/docs/mfc/handling-windows-messages-in-your-dialog-box.md +++ b/docs/mfc/handling-windows-messages-in-your-dialog-box.md @@ -4,6 +4,7 @@ title: "Handling Windows Messages in Your Dialog Box" ms.date: "09/05/2019" helpviewer_keywords: ["MFC dialog boxes [MFC], Windows messages", "Windows messages [MFC], handling", "message handling [MFC], in dialog boxes"] ms.assetid: 4af0c9cb-09da-4b15-97df-a1cfb89def79 +ms.topic: concept-article --- # Handling Windows Messages in Your Dialog Box diff --git a/docs/mfc/implementing-working-areas-in-list-controls.md b/docs/mfc/implementing-working-areas-in-list-controls.md index 9649cfcd2b5..0ee8d8fcbfa 100644 --- a/docs/mfc/implementing-working-areas-in-list-controls.md +++ b/docs/mfc/implementing-working-areas-in-list-controls.md @@ -4,6 +4,7 @@ title: "Implementing Working Areas in List Controls" ms.date: "11/04/2016" helpviewer_keywords: ["list controls [MFC], working areas", "working areas in list control [MFC]"] ms.assetid: fbbb356b-3359-4348-8603-f1cb114cadde +ms.topic: concept-article --- # Implementing Working Areas in List Controls diff --git a/docs/mfc/initializing-and-cleaning-up-documents-and-views.md b/docs/mfc/initializing-and-cleaning-up-documents-and-views.md index 4462b237bf1..9245198be4d 100644 --- a/docs/mfc/initializing-and-cleaning-up-documents-and-views.md +++ b/docs/mfc/initializing-and-cleaning-up-documents-and-views.md @@ -4,6 +4,7 @@ title: "Initializing and Cleaning Up Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["initializing documents [MFC]", "views [MFC], cleaning up", "documents [MFC], initializing", "documents [MFC], cleaning up", "views [MFC], initializing", "initializing objects [MFC], document objects", "document objects [MFC], life cycle of", "initializing views [MFC]"] ms.assetid: 95d6f09b-a047-4079-856a-ae7d0548e9d2 +ms.topic: how-to --- # Initializing and Cleaning Up Documents and Views diff --git a/docs/mfc/initializing-documents-and-views.md b/docs/mfc/initializing-documents-and-views.md index 326411c8763..43ac07fab7a 100644 --- a/docs/mfc/initializing-documents-and-views.md +++ b/docs/mfc/initializing-documents-and-views.md @@ -4,6 +4,7 @@ title: "Initializing Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["initializing documents [MFC]", "documents [MFC], initializing", "views [MFC], initializing", "initializing objects [MFC], document objects", "initializing views [MFC]"] ms.assetid: 33cb8643-8a16-478c-bc26-eccc734e3661 +ms.topic: concept-article --- # Initializing Documents and Views diff --git a/docs/mfc/initializing-the-dialog-box.md b/docs/mfc/initializing-the-dialog-box.md index f3fa2fa7af0..ba9d129545f 100644 --- a/docs/mfc/initializing-the-dialog-box.md +++ b/docs/mfc/initializing-the-dialog-box.md @@ -4,6 +4,7 @@ title: "Initializing the Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["initializing dialog boxes [MFC]", "OnInitDialog method [MFC]", "modal dialog boxes [MFC], initializing", "modeless dialog boxes [MFC], initializing", "MFC dialog boxes [MFC], initializing"] ms.assetid: 968142f5-19f9-4b34-a1d4-8e6412d4379b +ms.topic: concept-article --- # Initializing the Dialog Box diff --git a/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md b/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md index c47acf19ddd..af5b7bc529b 100644 --- a/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md +++ b/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md @@ -4,6 +4,7 @@ title: "Initializing the Parts of a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["CStatusBarCtrl class [MFC], simple mode", "status bars [MFC], declaring parts of", "simple status bars [MFC]", "status bars [MFC], icons", "status bars [MFC], simple mode", "icons, using in status bars", "CStatusBarCtrl class [MFC], declaring parts of"] ms.assetid: 60e8f285-d2d8-424a-a6ea-2fc548370303 +ms.topic: concept-article --- # Initializing the Parts of a CStatusBarCtrl Object diff --git a/docs/mfc/inserting-a-form-into-a-project.md b/docs/mfc/inserting-a-form-into-a-project.md index 51e916c60c4..0166e9f5d36 100644 --- a/docs/mfc/inserting-a-form-into-a-project.md +++ b/docs/mfc/inserting-a-form-into-a-project.md @@ -4,6 +4,7 @@ title: "Inserting a Form into a Project" ms.date: "11/04/2016" helpviewer_keywords: ["inserting forms [MFC]", "Insert New dialog box [MFC]", "forms, adding to projects"] ms.assetid: f3bd2998-3ce2-496d-ac5c-57ca70eec7cb +ms.topic: how-to --- # Inserting a Form into a Project diff --git a/docs/mfc/interpreting-user-input-through-a-view.md b/docs/mfc/interpreting-user-input-through-a-view.md index 4a71432b222..6e1086bbe15 100644 --- a/docs/mfc/interpreting-user-input-through-a-view.md +++ b/docs/mfc/interpreting-user-input-through-a-view.md @@ -4,6 +4,7 @@ title: "Interpreting User Input Through a View" ms.date: "11/04/2016" helpviewer_keywords: ["interpreting user input through views [MFC]", "views [MFC], user interface and input", "input [MFC], view class [MFC]", "CView class [MFC], interpreting user input", "user input [MFC], interpreting through view class [MFC]"] ms.assetid: f0302a70-661f-4781-8fe7-78f082bef2a5 +ms.topic: concept-article --- # Interpreting User Input Through a View diff --git a/docs/mfc/life-cycle-of-a-dialog-box.md b/docs/mfc/life-cycle-of-a-dialog-box.md index 1375df3e61d..f178c1f0676 100644 --- a/docs/mfc/life-cycle-of-a-dialog-box.md +++ b/docs/mfc/life-cycle-of-a-dialog-box.md @@ -4,6 +4,7 @@ title: "Working with Dialog Boxes in MFC" ms.date: "09/27/2019" helpviewer_keywords: ["dialog boxes [MFC], life cycle", "modal dialog boxes [MFC], life cycle", "modeless dialog boxes [MFC], life cycle", "MFC dialog boxes [MFC], life cycle", "life cycle of dialog boxes [MFC]"] ms.assetid: e16fd78e-238d-4f31-8c9d-8564f3953bd9 +ms.topic: concept-article --- # Working with Dialog Boxes in MFC diff --git a/docs/mfc/making-and-using-controls.md b/docs/mfc/making-and-using-controls.md index 92fd5c28a69..6e88beb322b 100644 --- a/docs/mfc/making-and-using-controls.md +++ b/docs/mfc/making-and-using-controls.md @@ -4,6 +4,7 @@ title: "Making and Using Controls" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], creating for dialog boxes", "Windows common controls [MFC], about common controls", "common controls [MFC], about common controls"] ms.assetid: a252acad-3cc0-440e-bbc6-43eaaf8cb7bb +ms.topic: concept-article --- # Making and Using Controls diff --git a/docs/mfc/making-owner-drawn-header-controls.md b/docs/mfc/making-owner-drawn-header-controls.md index 121655e7e4e..68a3e251f9d 100644 --- a/docs/mfc/making-owner-drawn-header-controls.md +++ b/docs/mfc/making-owner-drawn-header-controls.md @@ -4,6 +4,7 @@ title: "Making Owner-Drawn Header Controls" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], owner-drawn", "drawing [MFC], header controls", "CHeaderCtrl class [MFC], making owner-drawn", "controls [MFC], header", "owner-drawn header controls [MFC]"] ms.assetid: 455c113b-e8d0-400c-8690-dbb92cba0d05 +ms.topic: concept-article --- # Making Owner-Drawn Header Controls diff --git a/docs/mfc/making-owner-drawn-tabs.md b/docs/mfc/making-owner-drawn-tabs.md index f27d45d88ba..f3421ab838c 100644 --- a/docs/mfc/making-owner-drawn-tabs.md +++ b/docs/mfc/making-owner-drawn-tabs.md @@ -4,6 +4,7 @@ title: "Making Owner-Drawn Tabs" ms.date: "11/04/2016" helpviewer_keywords: ["owner-drawn tabs [MFC]", "tabs [MFC], owner-drawn", "CTabCtrl class [MFC], owner-drawn tabs", "drawing [MFC], tabs"] ms.assetid: 11af2926-41d7-47e3-9eec-c595283f6371 +ms.topic: concept-article --- # Making Owner-Drawn Tabs diff --git a/docs/mfc/managing-data-with-document-data-variables.md b/docs/mfc/managing-data-with-document-data-variables.md index 1d6951c2b7a..be73faee851 100644 --- a/docs/mfc/managing-data-with-document-data-variables.md +++ b/docs/mfc/managing-data-with-document-data-variables.md @@ -4,6 +4,7 @@ title: "Managing Data with Document Data Variables" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], data storage", "friend classes [MFC]", "classes [MFC], friend", "data [MFC]", "data [MFC], documents", "collection classes [MFC], used by document object", "document data [MFC]", "member variables [MFC], document class [MFC]"] ms.assetid: e70b87f4-8c30-49e5-8986-521c2ff91704 +ms.topic: concept-article --- # Managing Data with Document Data Variables diff --git a/docs/mfc/managing-mdi-child-windows.md b/docs/mfc/managing-mdi-child-windows.md index 378345309ed..beca42fc238 100644 --- a/docs/mfc/managing-mdi-child-windows.md +++ b/docs/mfc/managing-mdi-child-windows.md @@ -5,6 +5,7 @@ ms.date: "11/19/2018" f1_keywords: ["MDICLIENT"] helpviewer_keywords: ["MDI [MFC], child windows", "child windows [MFC], and MDICLIENT window", "MDICLIENT window [MFC]", "windows [MFC], MDI", "frame windows [MFC], MDI child windows", "child windows [MFC]", "MDI [MFC], frame windows"] ms.assetid: 1828d96e-a561-48ae-a661-ba9701de6bee +ms.topic: concept-article --- # Managing MDI Child Windows diff --git a/docs/mfc/managing-menus-control-bars-and-accelerators.md b/docs/mfc/managing-menus-control-bars-and-accelerators.md index bdd164b2c96..329610e659a 100644 --- a/docs/mfc/managing-menus-control-bars-and-accelerators.md +++ b/docs/mfc/managing-menus-control-bars-and-accelerators.md @@ -4,6 +4,7 @@ title: "Managing Menus, Control Bars, and Accelerators" ms.date: "11/04/2016" helpviewer_keywords: ["MDI [MFC], frame windows", "control bars [MFC], updating in frame windows", "menus [MFC], updating as context changes", "user interface objects [MFC], updating", "accelerator tables [MFC]", "sharing menus [MFC]", "updating user-interface objects [MFC]", "frame windows [MFC], updating", "status bars [MFC], updating"] ms.assetid: 97ca1997-06df-4373-b023-4f7ecd81047b +ms.topic: concept-article --- # Managing Menus, Control Bars, and Accelerators diff --git a/docs/mfc/managing-the-current-view.md b/docs/mfc/managing-the-current-view.md index 9a14f7cccde..ecd15ad51ec 100644 --- a/docs/mfc/managing-the-current-view.md +++ b/docs/mfc/managing-the-current-view.md @@ -4,6 +4,7 @@ title: "Managing the Current View" ms.date: "11/04/2016" helpviewer_keywords: ["views [MFC], and OnActivateView method [MFC]", "views [MFC], deactivating", "views [MFC], activating", "frame windows [MFC], current view", "OnActivateView method [MFC]", "views [MFC], current", "deactivating views [MFC]", "current view in frame window [MFC]"] ms.assetid: 0a1cc22d-d646-4536-9ad2-3cb6d7092e4a +ms.topic: concept-article --- # Managing the Current View diff --git a/docs/mfc/managing-the-state-data-of-mfc-modules.md b/docs/mfc/managing-the-state-data-of-mfc-modules.md index f40ff4f6b76..37c7bead209 100644 --- a/docs/mfc/managing-the-state-data-of-mfc-modules.md +++ b/docs/mfc/managing-the-state-data-of-mfc-modules.md @@ -4,6 +4,7 @@ title: "Managing the State Data of MFC Modules" ms.date: "11/19/2018" helpviewer_keywords: ["global state [MFC]", "data management [MFC], MFC modules", "window procedure entry points [MFC]", "exported interfaces and global state [MFC]", "module states [MFC], saving and restoring", "data management [MFC]", "MFC, managing state data", "multiple modules [MFC]", "module state restored [MFC]"] ms.assetid: 81889c11-0101-4a66-ab3c-f81cf199e1bb +ms.topic: concept-article --- # Managing the State Data of MFC Modules diff --git a/docs/mfc/manipulating-image-lists.md b/docs/mfc/manipulating-image-lists.md index 7b782d16ed5..6d92caf6d4f 100644 --- a/docs/mfc/manipulating-image-lists.md +++ b/docs/mfc/manipulating-image-lists.md @@ -4,6 +4,7 @@ title: "Manipulating Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["image lists [MFC], manipulating", "lists [MFC], image", "CImageList class [MFC], manipulating"] ms.assetid: 043418f8-077e-4dce-b8bb-2b7b0d7b5156 +ms.topic: concept-article --- # Manipulating Image Lists diff --git a/docs/mfc/manipulating-menus-during-program-execution.md b/docs/mfc/manipulating-menus-during-program-execution.md index 27ce44d928d..830ad98dea8 100644 --- a/docs/mfc/manipulating-menus-during-program-execution.md +++ b/docs/mfc/manipulating-menus-during-program-execution.md @@ -4,6 +4,7 @@ title: "Manipulating Menus During Program Execution" ms.date: "11/04/2016" helpviewer_keywords: ["menus [MFC], editing during execution", "menus during execution [MFC], deleting", "CMenu class [MFC], manipulating menus during execution", "menus [MFC], manipulating during execution", "menus during execution"] ms.assetid: 722c7c00-4be2-4967-877d-f96aaa604396 +ms.topic: concept-article --- # Manipulating Menus During Program Execution diff --git a/docs/mfc/manipulating-the-progress-control.md b/docs/mfc/manipulating-the-progress-control.md index 69a85df1a21..364d495b2c7 100644 --- a/docs/mfc/manipulating-the-progress-control.md +++ b/docs/mfc/manipulating-the-progress-control.md @@ -4,6 +4,7 @@ title: "Manipulating the Progress Control" ms.date: "11/04/2016" helpviewer_keywords: ["CProgressCtrl class [MFC], working with", "progress controls [MFC], manipulating", "CProgressCtrl class [MFC], manipulating", "controlling progress controls [MFC]", "CProgressCtrl class [MFC], using"] ms.assetid: 9af561d1-980b-4003-a6da-ff79be15bf23 +ms.topic: how-to --- # Manipulating the Progress Control diff --git a/docs/mfc/manipulating-the-tool-tip-control.md b/docs/mfc/manipulating-the-tool-tip-control.md index 0663d49d969..a368c8f8955 100644 --- a/docs/mfc/manipulating-the-tool-tip-control.md +++ b/docs/mfc/manipulating-the-tool-tip-control.md @@ -4,6 +4,7 @@ title: "Manipulating the Tool Tip Control" ms.date: "11/04/2016" helpviewer_keywords: ["CToolTipCtrl class [MFC], manipulating tool tip attributes", "tool tips [MFC], attributes"] ms.assetid: 3600afe5-712a-4b56-8456-96e85fe879af +ms.topic: concept-article --- # Manipulating the Tool Tip Control diff --git a/docs/mfc/mapping-messages.md b/docs/mfc/mapping-messages.md index 58e53eb5f24..2f59ba6b40e 100644 --- a/docs/mfc/mapping-messages.md +++ b/docs/mfc/mapping-messages.md @@ -4,6 +4,7 @@ title: "Mapping Messages" ms.date: "11/04/2016" helpviewer_keywords: ["message maps [MFC], about message maps", "mappings [MFC], commands", "commands [MFC], mapping", "command mapping [MFC]", "message handling [MFC], connecting to handler functions", "commands [MFC], connecting to handler functions", "mappings [MFC], messages", "messages [MFC], mapping"] ms.assetid: 996f0652-0698-4b8c-b893-cdaa836d9d0f +ms.topic: concept-article --- # Mapping Messages diff --git a/docs/mfc/mapping-windows-messages-to-your-class.md b/docs/mfc/mapping-windows-messages-to-your-class.md index f8a7a8751e2..f34a3d5da29 100644 --- a/docs/mfc/mapping-windows-messages-to-your-class.md +++ b/docs/mfc/mapping-windows-messages-to-your-class.md @@ -4,6 +4,7 @@ title: "Mapping Windows Messages to Your Class" ms.date: "09/06/2019" helpviewer_keywords: ["MFC dialog boxes [MFC], Windows messages", "message maps [MFC], in dialog class", "Windows messages [MFC], mapping in dialog classes", "messages to dialog class [MFC]", "mappings [MFC], messages to dialog class [MFC]", "message maps [MFC], mapping Windows messages to classes", "messages to dialog class [MFC], mapping", "Class Wizard [MFC]"] ms.assetid: a4c6fd1f-1d33-47c9-baa0-001755746d6d +ms.topic: concept-article --- # Mapping Windows Messages to Your Class diff --git a/docs/mfc/message-categories.md b/docs/mfc/message-categories.md index 5bc141928a7..8f26f6242e0 100644 --- a/docs/mfc/message-categories.md +++ b/docs/mfc/message-categories.md @@ -4,6 +4,7 @@ title: "Message Categories" ms.date: "11/04/2016" helpviewer_keywords: ["messages [MFC], categories", "control-notification messages [MFC]", "Windows messages [MFC], categories", "controls [MFC], notifications", "command messages [MFC]", "messages [MFC], Windows", "message handling [MFC], message types"] ms.assetid: 68e1db75-9da6-4a4d-b2c2-dc4d59f8d87b +ms.topic: how-to --- # Message Categories diff --git a/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md b/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md index aff377276ae..e657b702672 100644 --- a/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md +++ b/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md @@ -4,6 +4,7 @@ title: "MFC ActiveX Controls: Returning Error Codes From a Method" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], error codes", "SetNotSupported method, using", "errors [MFC], ActiveX control error codes", "GetNotSupported method [MFC]", "FireError method [MFC]", "SCODE, MFC ActiveX controls", "ThrowError method [MFC]"] ms.assetid: 771fb9c9-2413-4dcc-b386-7bc4c4adeafd +ms.topic: troubleshooting-error-codes --- # MFC ActiveX Controls: Returning Error Codes From a Method diff --git a/docs/mfc/mfc-concepts.md b/docs/mfc/mfc-concepts.md index 3ff73e4812e..837ceb34f69 100644 --- a/docs/mfc/mfc-concepts.md +++ b/docs/mfc/mfc-concepts.md @@ -3,6 +3,7 @@ description: "Learn more about: MFC Concepts" title: "MFC Concepts" ms.date: "01/09/2018" f1_keywords: ["Concepts"] +ms.topic: concept-article --- # MFC Concepts diff --git a/docs/mfc/on-update-command-ui-macro.md b/docs/mfc/on-update-command-ui-macro.md index b5eb0ecd791..12493f28551 100644 --- a/docs/mfc/on-update-command-ui-macro.md +++ b/docs/mfc/on-update-command-ui-macro.md @@ -5,6 +5,7 @@ ms.date: "09/06/2019" f1_keywords: ["ON_UPDATE_COMMAND_UI"] helpviewer_keywords: ["ON_UPDATE_COMMAND_UI macro [MFC]", "update handlers [MFC]", "command-handler macros", "updating user-interface objects [MFC]"] ms.assetid: 3e72b50f-4119-4c82-81cf-6e09b132de05 +ms.topic: reference --- # ON_UPDATE_COMMAND_UI Macro diff --git a/docs/mfc/opening-files.md b/docs/mfc/opening-files.md index c758c1bb9c6..1901d6e2ee4 100644 --- a/docs/mfc/opening-files.md +++ b/docs/mfc/opening-files.md @@ -4,6 +4,7 @@ title: "Opening Files" ms.date: "11/04/2016" helpviewer_keywords: ["Open member functions [MFC]", "CFile class [MFC], variable", "opening files, in MFC", "Open calls [MFC]", "Open method, CFile class [MFC]", "examples [MFC], opening files", "opening files, handling exceptions", "exception handling [MFC], when opening files", "files [MFC], opening", "file objects [MFC]", "MFC, file operations", "opening files [MFC]", "exception handling [MFC], opening files"] ms.assetid: a991b8ec-b04a-4766-b47e-7485b5dd0b01 +ms.topic: how-to --- # Opening Files diff --git a/docs/mfc/optimizing-control-drawing.md b/docs/mfc/optimizing-control-drawing.md index 389d769e750..f66c88ff25b 100644 --- a/docs/mfc/optimizing-control-drawing.md +++ b/docs/mfc/optimizing-control-drawing.md @@ -4,6 +4,7 @@ title: "Optimizing Control Drawing" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], optimizing"] ms.assetid: 29ff985d-9bf5-4678-b62d-aad12def75fb +ms.topic: concept-article --- # Optimizing Control Drawing diff --git a/docs/mfc/optimizing-persistence-and-initialization.md b/docs/mfc/optimizing-persistence-and-initialization.md index 51e8befc886..6fa231bfd5b 100644 --- a/docs/mfc/optimizing-persistence-and-initialization.md +++ b/docs/mfc/optimizing-persistence-and-initialization.md @@ -4,6 +4,7 @@ title: "Optimizing Persistence and Initialization" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], optimizing", "performance, ActiveX controls", "optimization, ActiveX controls", "optimizing performance, ActiveX controls"] ms.assetid: e821e19e-b9eb-49ab-b719-0743420ba80b +ms.topic: concept-article --- # Optimizing Persistence and Initialization diff --git a/docs/mfc/orchestrating-other-window-actions.md b/docs/mfc/orchestrating-other-window-actions.md index 41b8115884e..d58e98acd28 100644 --- a/docs/mfc/orchestrating-other-window-actions.md +++ b/docs/mfc/orchestrating-other-window-actions.md @@ -4,6 +4,7 @@ title: "Orchestrating Other Window Actions" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], print preview", "context-sensitive Help [MFC], frame windows", "print preview [MFC], and frame windows", "frame windows [MFC], context-sensitive Help", "frame windows [MFC], semimodal states", "context-sensitive Help [MFC]"] ms.assetid: 5f34eea8-2bf8-4479-95c7-45e8f443db8f +ms.topic: concept-article --- # Orchestrating Other Window Actions diff --git a/docs/mfc/ordering-items-in-the-header-control.md b/docs/mfc/ordering-items-in-the-header-control.md index 5dfc66ea144..8fecf83fd9a 100644 --- a/docs/mfc/ordering-items-in-the-header-control.md +++ b/docs/mfc/ordering-items-in-the-header-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["DS_DRAGDROP"] helpviewer_keywords: ["sequence [MFC]", "sequence [MFC], header control items", "OrderToIndex method [MFC]", "DS_DRAGDROP notification [MFC]", "GetOrderArray method [MFC]", "SetOrderArray method [MFC]", "header controls [MFC], ordering items"] ms.assetid: 5aaef872-75b5-49c5-8fed-6f9a81fca812 +ms.topic: concept-article --- # Ordering Items in the Header Control diff --git a/docs/mfc/overriding-the-standard-command-routing.md b/docs/mfc/overriding-the-standard-command-routing.md index df1c2ddbd3c..ba18313793a 100644 --- a/docs/mfc/overriding-the-standard-command-routing.md +++ b/docs/mfc/overriding-the-standard-command-routing.md @@ -4,6 +4,7 @@ title: "Overriding the Standard Command Routing" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, command routing", "command routing [MFC], overriding", "command handling [MFC], routing commands", "overriding, standard command routing"] ms.assetid: 872b698a-7432-40c4-9008-68721e8effa5 +ms.topic: concept-article --- # Overriding the Standard Command Routing diff --git a/docs/mfc/overview-of-the-rich-edit-control.md b/docs/mfc/overview-of-the-rich-edit-control.md index e14a976fb89..ae897f634ab 100644 --- a/docs/mfc/overview-of-the-rich-edit-control.md +++ b/docs/mfc/overview-of-the-rich-edit-control.md @@ -4,6 +4,7 @@ title: "Overview of the Rich Edit Control" ms.date: "11/04/2016" helpviewer_keywords: ["rich edit controls [MFC]"] ms.assetid: ad589b9f-a3fd-4820-bf1f-6b1965997e68 +ms.topic: concept-article --- # Overview of the Rich Edit Control diff --git a/docs/mfc/printing-and-print-preview.md b/docs/mfc/printing-and-print-preview.md index 5ad4329b9a7..b2ca6172204 100644 --- a/docs/mfc/printing-and-print-preview.md +++ b/docs/mfc/printing-and-print-preview.md @@ -4,6 +4,7 @@ title: "Printing and Print Preview" ms.date: "11/04/2016" helpviewer_keywords: ["printing [MFC]", "previewing printing", "printing [MFC]", "print preview", "printing [MFC], print preview"] ms.assetid: d15059cd-32de-4450-95f7-e73aece238f6 +ms.topic: concept-article --- # Printing and Print Preview diff --git a/docs/mfc/printing-in-rich-edit-controls.md b/docs/mfc/printing-in-rich-edit-controls.md index 21c9af612a1..b984736a3ff 100644 --- a/docs/mfc/printing-in-rich-edit-controls.md +++ b/docs/mfc/printing-in-rich-edit-controls.md @@ -4,6 +4,7 @@ title: "Printing in Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["printing [MFC], CRichEditCtrl", "rich edit controls [MFC], printing", "CRichEditCtrl class [MFC], printing"] ms.assetid: dbda0e40-018f-424e-b5d8-7b489aaf27af +ms.topic: concept-article --- # Printing in Rich Edit Controls diff --git a/docs/mfc/printing.md b/docs/mfc/printing.md index 2e4c83c98ff..58d2fd9d619 100644 --- a/docs/mfc/printing.md +++ b/docs/mfc/printing.md @@ -4,6 +4,7 @@ title: "Printing" ms.date: "11/04/2016" helpviewer_keywords: ["view classes [MFC], print operations", "documents [MFC], printing", "printing [MFC], from framework", "printing [MFC]"] ms.assetid: be465e8d-b0c9-4fc5-9fa8-d10486064f76 +ms.topic: concept-article --- # Printing diff --git a/docs/mfc/processing-header-control-notifications.md b/docs/mfc/processing-header-control-notifications.md index 5e4ec0c1a28..0c3aa456c2d 100644 --- a/docs/mfc/processing-header-control-notifications.md +++ b/docs/mfc/processing-header-control-notifications.md @@ -4,6 +4,7 @@ title: "Processing Header-Control Notifications" ms.date: "11/04/2016" helpviewer_keywords: ["CHeaderCtrl class [MFC], processing notifications", "controls [MFC], header", "notifications [MFC], processing for CHeaderCtrl", "header controls [MFC], processing notifications", "header control notifications"] ms.assetid: e6c6af7c-d458-4d33-85aa-48014ccde5f6 +ms.topic: concept-article --- # Processing Header-Control Notifications diff --git a/docs/mfc/processing-notification-messages-in-a-rebar-control.md b/docs/mfc/processing-notification-messages-in-a-rebar-control.md index 4a606ad68ea..d4b1a732bd9 100644 --- a/docs/mfc/processing-notification-messages-in-a-rebar-control.md +++ b/docs/mfc/processing-notification-messages-in-a-rebar-control.md @@ -4,6 +4,7 @@ title: "Processing Notification Messages in a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["RBN_ notification messages, description of", "CReBarCtrl class [MFC], notification messages sent by", "RBN_ notification messages [MFC]", "notifications [MFC], CReBarCtrl"] ms.assetid: 40f43a60-0c18-4d8d-8fab-213a095624f9 +ms.topic: concept-article --- # Processing Notification Messages in a Rebar Control diff --git a/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md b/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md index 40487fce818..e8d46f354f6 100644 --- a/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md +++ b/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["DTN_CLOSEUP", "DTN_DATETIMECHANGE", "DTN_DROPDOWN"] helpviewer_keywords: ["DTN_DROPDOWN notification [MFC]", "DTN_DATETIMECHANGE notification [MFC]", "DTN_CLOSEUP notification [MFC]", "DateTimePicker control [MFC], handling notifications", "CDateTimeCtrl class [MFC], handling notifications", "DTN_FORMAT notification [MFC]", "DateTimePicker control [MFC]"] ms.assetid: ffbe29ab-ff80-4609-89f7-260b404439c4 +ms.topic: concept-article --- # Processing Notification Messages in Date and Time Picker Controls diff --git a/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md b/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md index f6f17343c9d..17f7c1247f2 100644 --- a/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md +++ b/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md @@ -4,6 +4,7 @@ title: "Processing Notification Messages in Extended Combo Box Controls" ms.date: "11/04/2016" helpviewer_keywords: ["extended combo boxes [MFC], notifications", "notifications [MFC], extended combo box controls"] ms.assetid: 4e442758-d054-4746-bb1a-6ff84accb127 +ms.topic: concept-article --- # Processing Notification Messages in Extended Combo Box Controls diff --git a/docs/mfc/processing-notification-messages-in-list-controls.md b/docs/mfc/processing-notification-messages-in-list-controls.md index 2f76695521d..9381aeaa0e5 100644 --- a/docs/mfc/processing-notification-messages-in-list-controls.md +++ b/docs/mfc/processing-notification-messages-in-list-controls.md @@ -4,6 +4,7 @@ title: "Processing Notification Messages in List Controls" ms.date: "11/04/2016" helpviewer_keywords: ["processing notifications [MFC]", "CListCtrl class [MFC], processing notifications"] ms.assetid: 1f0e296e-d2a3-48fc-ae38-51d7fb096f51 +ms.topic: concept-article --- # Processing Notification Messages in List Controls diff --git a/docs/mfc/processing-notification-messages-in-month-calendar-controls.md b/docs/mfc/processing-notification-messages-in-month-calendar-controls.md index 2effdb45f93..7f2c355b6a3 100644 --- a/docs/mfc/processing-notification-messages-in-month-calendar-controls.md +++ b/docs/mfc/processing-notification-messages-in-month-calendar-controls.md @@ -4,6 +4,7 @@ title: "Processing Notification Messages in Month Calendar Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CMonthCalCtrl class [MFC], notifications", "CMonthCalCtrl class [MFC], day states", "month calendar controls [MFC], notification messages", "notifications [MFC], for CMonthCalCtrl", "notifications [MFC], month calendar control"] ms.assetid: 607c3e90-0756-493b-9503-ce835a50c7ab +ms.topic: concept-article --- # Processing Notification Messages in Month Calendar Controls diff --git a/docs/mfc/processing-tab-control-notification-messages.md b/docs/mfc/processing-tab-control-notification-messages.md index a0abab7d8aa..04bb96866dd 100644 --- a/docs/mfc/processing-tab-control-notification-messages.md +++ b/docs/mfc/processing-tab-control-notification-messages.md @@ -4,6 +4,7 @@ title: "Processing Tab Control Notification Messages" ms.date: "11/04/2016" helpviewer_keywords: ["notifications [MFC], tab controls", "CTabCtrl class [MFC], processing notifications", "notifications [MFC], processing in CTabCtrl", "processing notifications [MFC]", "tab controls [MFC], processing notifications"] ms.assetid: 758ccb7a-9e73-48f8-9073-23f7cb09918c +ms.topic: concept-article --- # Processing Tab Control Notification Messages diff --git a/docs/mfc/providing-drag-and-drop-support-for-header-items.md b/docs/mfc/providing-drag-and-drop-support-for-header-items.md index e3c3b78cab3..0d8f5e116fa 100644 --- a/docs/mfc/providing-drag-and-drop-support-for-header-items.md +++ b/docs/mfc/providing-drag-and-drop-support-for-header-items.md @@ -4,6 +4,7 @@ title: "Providing Drag-and-Drop Support for Header Items" ms.date: "11/04/2016" helpviewer_keywords: ["HDS_DRAGDROP style", "header items in header controls", "CHeaderCtrl class [MFC], drag and drop support", "HDN_ notifications [MFC]"] ms.assetid: 93a152ec-804f-488f-b260-b3a438d0dc0f +ms.topic: concept-article --- # Providing Drag-and-Drop Support for Header Items diff --git a/docs/mfc/providing-flicker-free-activation.md b/docs/mfc/providing-flicker-free-activation.md index e4f3a54191d..177d650be4e 100644 --- a/docs/mfc/providing-flicker-free-activation.md +++ b/docs/mfc/providing-flicker-free-activation.md @@ -4,6 +4,7 @@ title: "Providing Flicker-Free Activation" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], flicker-free", "flicker, MFC ActiveX controls", "activation [MFC], flicker-free"] ms.assetid: bcb24b77-31d8-44a0-8c58-2ea6213b4c43 +ms.topic: concept-article --- # Providing Flicker-Free Activation diff --git a/docs/mfc/providing-mouse-interaction-while-inactive.md b/docs/mfc/providing-mouse-interaction-while-inactive.md index 0cc692d9e05..21a2b685851 100644 --- a/docs/mfc/providing-mouse-interaction-while-inactive.md +++ b/docs/mfc/providing-mouse-interaction-while-inactive.md @@ -4,6 +4,7 @@ title: "Providing Mouse Interaction While Inactive" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], mouse interaction"] ms.assetid: b09106bf-44c7-4b9b-a6d9-0d624f16f5b3 +ms.topic: concept-article --- # Providing Mouse Interaction While Inactive diff --git a/docs/mfc/providing-windowless-activation.md b/docs/mfc/providing-windowless-activation.md index b78c0e19c41..cf11fd11d9b 100644 --- a/docs/mfc/providing-windowless-activation.md +++ b/docs/mfc/providing-windowless-activation.md @@ -4,6 +4,7 @@ title: "Providing Windowless Activation" ms.date: "11/04/2016" helpviewer_keywords: ["windowless activation of MFC ActiveX controls", "activation [MFC], MFC ActiveX controls", "MFC ActiveX controls [MFC], activate options", "activation [MFC], windowless"] ms.assetid: 094903b5-c344-42fa-96ff-ce01e16891c5 +ms.topic: concept-article --- # Providing Windowless Activation diff --git a/docs/mfc/reading-and-writing-files.md b/docs/mfc/reading-and-writing-files.md index 0ef0ecd046b..22afa9e55f8 100644 --- a/docs/mfc/reading-and-writing-files.md +++ b/docs/mfc/reading-and-writing-files.md @@ -4,6 +4,7 @@ title: "Reading and Writing Files" ms.date: "11/04/2016" helpviewer_keywords: ["CFile class [MFC], objects", "examples [MFC], reading files", "files [MFC], writing to", "examples [MFC], writing to files", "files [MFC], reading", "MFC, file operations", "CFile class [MFC], reading and writing CFile objects", "reading files", "writing to files [MFC]"] ms.assetid: cac0c826-ba56-495f-99b3-ce6336f65763 +ms.topic: how-to --- # Reading and Writing Files diff --git a/docs/mfc/receiving-notification-from-common-controls.md b/docs/mfc/receiving-notification-from-common-controls.md index ee2aadff48d..8e783462914 100644 --- a/docs/mfc/receiving-notification-from-common-controls.md +++ b/docs/mfc/receiving-notification-from-common-controls.md @@ -4,6 +4,7 @@ title: "Receiving Notification from Common Controls" ms.date: "11/04/2016" helpviewer_keywords: ["OnNotify method [MFC]", "common controls [MFC], notifications", "ON_NOTIFY macro [MFC]", "controls [MFC], notifications", "receiving notifications from common controls", "notifications [MFC], common controls", "Windows common controls [MFC], notifications", "WM_NOTIFY message"] ms.assetid: 50194592-d60d-44d0-8ab3-338a2a2c63e7 +ms.topic: concept-article --- # Receiving Notification from Common Controls diff --git a/docs/mfc/registering-window-classes.md b/docs/mfc/registering-window-classes.md index 2d37bda3fb5..20bf96df284 100644 --- a/docs/mfc/registering-window-classes.md +++ b/docs/mfc/registering-window-classes.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["WndProc"] helpviewer_keywords: ["window classes [MFC], registering", "registry [MFC], registering classes", "AfxRegisterWndClass method [MFC]", "MFC, windows", "WinMain method [MFC], and registering window classes", "WndProc method [MFC]", "classes [MFC], registering window classes", "WinMain method [MFC]", "registering window classes [MFC]"] ms.assetid: 30994bc4-a362-43da-bcc5-1bf67a3fc929 +ms.topic: concept-article --- # Registering Window Classes diff --git a/docs/mfc/responding-to-dynamic-data-exchange-dde.md b/docs/mfc/responding-to-dynamic-data-exchange-dde.md index 9ec13c9df44..cfcc4ddc454 100644 --- a/docs/mfc/responding-to-dynamic-data-exchange-dde.md +++ b/docs/mfc/responding-to-dynamic-data-exchange-dde.md @@ -4,6 +4,7 @@ title: "Responding to Dynamic Data Exchange (DDE)" ms.date: "11/04/2016" helpviewer_keywords: ["registry [MFC], most recently used files", "frame windows [MFC], dynamic data exchange (DDE)", "DDE (Dynamic Data Exchange), frame windows", "registration [MFC], shell", "Shell [MFC], registering file types", "windows [MFC], and dynamic data exchange", "responding to dynamic data exchange (DDE)", "frame windows [MFC], shell registration"] ms.assetid: 4db838d5-62cf-4123-915a-66e514155c0c +ms.topic: concept-article --- # Responding to Dynamic Data Exchange (DDE) diff --git a/docs/mfc/retrieving-data-from-the-dialog-object.md b/docs/mfc/retrieving-data-from-the-dialog-object.md index 7c870f78077..0177ee9d4a8 100644 --- a/docs/mfc/retrieving-data-from-the-dialog-object.md +++ b/docs/mfc/retrieving-data-from-the-dialog-object.md @@ -4,6 +4,7 @@ title: "Retrieving Data from the Dialog Object" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], retrieving user data", "dialog box data [MFC]", "data [MFC], retrieving", "GetDlgItemText method [MFC]", "SetDlgItemText method [MFC]", "SetWindowText method [MFC]", "dialog box data [MFC], retrieving", "retrieving data [MFC]", "user input [MFC], retrieving from MFC dialog boxes", "capturing user input [MFC]", "dialog box controls [MFC], initializing values", "DDX (dialog data exchange) [MFC]", "MFC dialog boxes [MFC], retrieving user input", "data retrieval [MFC], dialog boxes", "data [MFC], dialog boxes", "DDX (dialog data exchange) [MFC], about DDX", "DDX (dialog data exchange) [MFC], retrieving data from Dialog object", "GetWindowText method [MFC]"] ms.assetid: bdca2b61-6b53-4c2e-b426-8712c7a38ec0 +ms.topic: concept-article --- # Retrieving Data from the Dialog Object diff --git a/docs/mfc/rubber-banding-and-trackers.md b/docs/mfc/rubber-banding-and-trackers.md index 4fb1ae81c9b..78313d57451 100644 --- a/docs/mfc/rubber-banding-and-trackers.md +++ b/docs/mfc/rubber-banding-and-trackers.md @@ -4,6 +4,7 @@ title: "Rubber-Banding and Trackers" ms.date: "11/04/2016" helpviewer_keywords: ["trackers [MFC]", "CRectTracker class [MFC], implementing trackers", "OLE objects [MFC], selecting", "rubber banding [MFC]", "WM_LBUTTONDOWN [MFC]"] ms.assetid: 0d0fa64c-6418-4baf-ab7f-2d16ca039230 +ms.topic: concept-article --- # Rubber-Banding and Trackers diff --git a/docs/mfc/scrolling-and-scaling-views.md b/docs/mfc/scrolling-and-scaling-views.md index 997ef315f89..ae3f1dd968d 100644 --- a/docs/mfc/scrolling-and-scaling-views.md +++ b/docs/mfc/scrolling-and-scaling-views.md @@ -4,6 +4,7 @@ title: "Scrolling and Scaling Views" ms.date: "11/04/2016" helpviewer_keywords: ["message handlers [MFC]", "scaling views [MFC]", "message handling [MFC], scroll bars in view class [MFC]", "scroll bars [MFC], messages", "scrolling views [MFC]"] ms.assetid: f98a3421-c336-407e-97ee-dbb2ffd76fbd +ms.topic: concept-article --- # Scrolling and Scaling Views diff --git a/docs/mfc/selecting-a-graphic-object-into-a-device-context.md b/docs/mfc/selecting-a-graphic-object-into-a-device-context.md index 711b5ca8758..722c6609e74 100644 --- a/docs/mfc/selecting-a-graphic-object-into-a-device-context.md +++ b/docs/mfc/selecting-a-graphic-object-into-a-device-context.md @@ -4,6 +4,7 @@ title: "Selecting a Graphic Object into a Device Context" ms.date: "11/04/2016" helpviewer_keywords: ["graphic objects [MFC], selecting into device context", "SelectObject method [MFC]", "GDI objects [MFC], device contexts", "lifetime, graphic objects [MFC]", "device contexts, selecting graphic objects into", "device contexts, graphic objects [MFC]"] ms.assetid: cf54a330-63ef-421f-83eb-90ec7bd82eef +ms.topic: concept-article --- # Selecting a Graphic Object into a Device Context diff --git a/docs/mfc/serializing-data-to-and-from-files.md b/docs/mfc/serializing-data-to-and-from-files.md index 9fac8aba10d..4131496be72 100644 --- a/docs/mfc/serializing-data-to-and-from-files.md +++ b/docs/mfc/serializing-data-to-and-from-files.md @@ -4,6 +4,7 @@ title: "Serializing Data to and from Files" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], serialization", "documents [MFC], saving", "saving documents", "deserialization [MFC]", "serialization [MFC], role of document", "serialization [MFC], role of data", "data [MFC]", "data [MFC], serializing", "document data [MFC]"] ms.assetid: b42a0c68-4bc4-4012-9938-5433a26d2c24 +ms.topic: concept-article --- # Serializing Data to and from Files diff --git a/docs/mfc/setting-a-hot-key.md b/docs/mfc/setting-a-hot-key.md index 75e08246041..fbe03ecfbdd 100644 --- a/docs/mfc/setting-a-hot-key.md +++ b/docs/mfc/setting-a-hot-key.md @@ -4,6 +4,7 @@ title: "Setting a Hot Key" ms.date: "11/04/2016" helpviewer_keywords: ["keyboard shortcuts [MFC], hot keys", "access keys [MFC], hot keys", "CHotKeyCtrl class [MFC], setting hot key"] ms.assetid: 6f3bc141-e346-4dce-9ca7-3e6b2c453f3f +ms.topic: concept-article --- # Setting a Hot Key diff --git a/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md b/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md index 1ab946d3d7d..f563ff6a993 100644 --- a/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md +++ b/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["MCN_GETDAYSTATE"] helpviewer_keywords: ["CMonthCalCtrl class [MFC], setting day state info", "MCN_GETDAYSTATE notification [MFC]", "month calendar controls [MFC], day state info"] ms.assetid: 435d1b11-ec0e-4121-9e25-aaa6af812a3c +ms.topic: how-to --- # Setting the Day State of a Month Calendar Control diff --git a/docs/mfc/setting-the-dialog-boxs-background-color.md b/docs/mfc/setting-the-dialog-boxs-background-color.md index 79353401604..f9636fc6710 100644 --- a/docs/mfc/setting-the-dialog-boxs-background-color.md +++ b/docs/mfc/setting-the-dialog-boxs-background-color.md @@ -3,6 +3,7 @@ description: "Learn more about: Setting the Dialog Box's Background Color" title: "Setting the Dialog Box's Background Color" ms.date: 11/17/2023 helpviewer_keywords: ["CSS, background attributes in styles [MFC]", "HTML element formatting, background attributes", "colors, dialog box", "dialog boxes [MFC], colors", "background colors, dialog boxes", "MFC dialog boxes [MFC], colors"] +ms.topic: concept-article --- # Setting the Dialog Box's Background Color diff --git a/docs/mfc/setting-the-images-for-an-individual-item.md b/docs/mfc/setting-the-images-for-an-individual-item.md index 88a9906b6d2..d8b1d62da58 100644 --- a/docs/mfc/setting-the-images-for-an-individual-item.md +++ b/docs/mfc/setting-the-images-for-an-individual-item.md @@ -4,6 +4,7 @@ title: "Setting the Images for an Individual Item" ms.date: "11/04/2016" helpviewer_keywords: ["extended combo boxes [MFC], images", "images [MFC], combo box items"] ms.assetid: bde83db8-23a7-4e35-837a-c86447d2c0af +ms.topic: how-to --- # Setting the Images for an Individual Item diff --git a/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md b/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md index bdfd84d65d0..2b6710e45a3 100644 --- a/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md +++ b/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md @@ -4,6 +4,7 @@ title: "Setting the Mode of a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["simple mode and status bar controls", "IsSimple method, using", "SetSimple method [MFC]", "status bar controls [MFC], simple and nonsimple modes", "non-simple mode and status bar controls", "CStatusBarCtrl class [MFC], simple and nonsimple modes"] ms.assetid: ca6076e5-1501-4e33-8d35-9308941e46c0 +ms.topic: concept-article --- # Setting the Mode of a CStatusBarCtrl Object diff --git a/docs/mfc/specifying-levels-of-functionality.md b/docs/mfc/specifying-levels-of-functionality.md index 66ae19f7f99..cfaa99c8a47 100644 --- a/docs/mfc/specifying-levels-of-functionality.md +++ b/docs/mfc/specifying-levels-of-functionality.md @@ -4,6 +4,7 @@ title: "Specifying Levels of Functionality" ms.date: "11/06/2018" helpviewer_keywords: ["CObject class [MFC], adding functionality to derived classes", "runtime [MFC], class information", "serialization [MFC], Cobject", "dynamic creation support", "levels [MFC], functionality in CObject", "run-time class [MFC], information support", "levels [MFC]"] ms.assetid: 562669ba-c858-4f66-b5f1-b3beeea4f486 +ms.topic: how-to --- # Specifying Levels of Functionality diff --git a/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md b/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md index 258b8a4d22f..fe0603edff7 100644 --- a/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md +++ b/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md @@ -4,6 +4,7 @@ title: "Steps in a Typical FTP Client Application to Delete a File" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], FTP delete", "WinInet classes [MFC], FTP", "FTP (File Transfer Protocol) [MFC], client applications", "Internet applications [MFC], FTP client applications"] ms.assetid: 2c347a96-c0a4-4827-98fe-668406e552bc +ms.topic: how-to --- # Steps in a Typical FTP Client Application to Delete a File diff --git a/docs/mfc/steps-in-a-typical-ftp-client-application.md b/docs/mfc/steps-in-a-typical-ftp-client-application.md index d84e6990dc8..c1d16114ffe 100644 --- a/docs/mfc/steps-in-a-typical-ftp-client-application.md +++ b/docs/mfc/steps-in-a-typical-ftp-client-application.md @@ -4,6 +4,7 @@ title: "Steps in a Typical FTP Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], FTP table", "FTP (File Transfer Protocol)", "WinInet classes [MFC], FTP", "FTP (File Transfer Protocol) [MFC], client applications", "Internet applications [MFC], FTP client applications"] ms.assetid: 70bed7b5-6040-40d1-bc77-702e63a698f2 +ms.topic: how-to --- # Steps in a Typical FTP Client Application diff --git a/docs/mfc/steps-in-a-typical-gopher-client-application.md b/docs/mfc/steps-in-a-typical-gopher-client-application.md index 6b00efb5591..4468557ab4d 100644 --- a/docs/mfc/steps-in-a-typical-gopher-client-application.md +++ b/docs/mfc/steps-in-a-typical-gopher-client-application.md @@ -4,6 +4,7 @@ title: "Steps in a Typical Gopher Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["WinInet classes [MFC], gopher", "Internet applications [MFC], gopher client applications", "Gopher client applications [MFC]", "Internet client applications [MFC], gopher table"] ms.assetid: 3e4e1869-5da0-453d-8ba9-b648c894bb90 +ms.topic: how-to --- # Steps in a Typical Gopher Client Application diff --git a/docs/mfc/steps-in-a-typical-http-client-application.md b/docs/mfc/steps-in-a-typical-http-client-application.md index 96b6b19fee6..fa830ffcdb9 100644 --- a/docs/mfc/steps-in-a-typical-http-client-application.md +++ b/docs/mfc/steps-in-a-typical-http-client-application.md @@ -4,6 +4,7 @@ title: "Steps in a Typical HTTP Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["HTTP client applications [MFC]", "client applications [MFC], HTTP", "Internet applications [MFC], HTTP client applications", "applications [MFC], HTTP client", "Internet client applications [MFC], HTTP table", "WinInet classes [MFC], HTTP"] ms.assetid: f86552e8-8acd-4b23-bdc5-0c3a247ebd74 +ms.topic: how-to --- # Steps in a Typical HTTP Client Application diff --git a/docs/mfc/steps-in-a-typical-internet-client-application.md b/docs/mfc/steps-in-a-typical-internet-client-application.md index 927d514d1e1..24f95bcbc51 100644 --- a/docs/mfc/steps-in-a-typical-internet-client-application.md +++ b/docs/mfc/steps-in-a-typical-internet-client-application.md @@ -4,6 +4,7 @@ title: "Steps in a Typical Internet Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], general table", "WinInet classes [MFC], programming", "Internet applications [MFC], client applications"] ms.assetid: 7aba135c-7c15-4e2f-8c34-bbaf792c89a6 +ms.topic: how-to --- # Steps in a Typical Internet Client Application diff --git a/docs/mfc/storing-and-loading-cobjects-via-an-archive.md b/docs/mfc/storing-and-loading-cobjects-via-an-archive.md index ccbafa9bdb8..f08ce386eab 100644 --- a/docs/mfc/storing-and-loading-cobjects-via-an-archive.md +++ b/docs/mfc/storing-and-loading-cobjects-via-an-archive.md @@ -4,6 +4,7 @@ title: "Storing and Loading CObjects via an Archive" ms.date: "11/04/2016" helpviewer_keywords: ["CObjects [MFC], loading through archives", "CArchive class [MFC], storing and loading objects", "Serialize method, vs. CArchive operators", "CObject class [MFC], CArchive objects", "CObjects [MFC]"] ms.assetid: a829b6dd-bc31-47e0-8108-fbb946722db9 +ms.topic: concept-article --- # Storing and Loading CObjects via an Archive diff --git a/docs/mfc/testing-internet-applications.md b/docs/mfc/testing-internet-applications.md index 17cd363f1b3..40e53d914f6 100644 --- a/docs/mfc/testing-internet-applications.md +++ b/docs/mfc/testing-internet-applications.md @@ -4,6 +4,7 @@ title: "Testing Internet Applications" ms.date: "11/04/2016" helpviewer_keywords: ["Web applications [MFC], testing", "debugging Web applications [MFC], testing applications", "testing [MFC], Internet applications", "debugging [MFC], Web applications", "Internet debugging and testing"] ms.assetid: ac4c74e3-d4ad-4e19-8f6c-e270de067f01 +ms.topic: concept-article --- # Testing Internet Applications diff --git a/docs/mfc/testing-properties-and-events-with-test-container.md b/docs/mfc/testing-properties-and-events-with-test-container.md index fd24b36eca9..57ef165ae9f 100644 --- a/docs/mfc/testing-properties-and-events-with-test-container.md +++ b/docs/mfc/testing-properties-and-events-with-test-container.md @@ -4,6 +4,7 @@ title: "Testing Properties and Events with Test Container" ms.date: "11/04/2016" helpviewer_keywords: ["testing, test containers", "tstcon32.exe", "debugging ActiveX controls", "test container", "ActiveX Control Test Container", "ActiveX controls [MFC], testing", "properties [MFC], testing"] ms.assetid: 626867cf-fe53-4c30-8973-55bb93ef3917 +ms.topic: how-to --- # Testing Properties and Events with Test Container diff --git a/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md b/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md index 5c3c307246d..40acefd321e 100644 --- a/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md +++ b/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md @@ -4,6 +4,7 @@ title: "TN048: Writing ODBC Setup and Administration Programs for MFC Database A ms.date: "11/04/2016" helpviewer_keywords: ["installing ODBC", "ODBC, installing", "setup, ODBC setup programs", "TN048", "ODBC, and MFC", "MFC, database applications"] ms.assetid: d456cdd4-0513-4a51-80c0-9132b66115ce +ms.topic: install-set-up-deploy --- # TN048: Writing ODBC Setup and Administration Programs for MFC Database Applications diff --git a/docs/mfc/tn061-on-notify-and-wm-notify-messages.md b/docs/mfc/tn061-on-notify-and-wm-notify-messages.md index b035d0e6d44..41abe932b83 100644 --- a/docs/mfc/tn061-on-notify-and-wm-notify-messages.md +++ b/docs/mfc/tn061-on-notify-and-wm-notify-messages.md @@ -4,6 +4,7 @@ title: "TN061: ON_NOTIFY and WM_NOTIFY Messages" ms.date: "06/28/2018" helpviewer_keywords: ["ON_NOTIFY_EX message [MFC]", "TN061", "ON_NOTIFY message [MFC]", "ON_NOTIFY_EX_RANGE message [MFC]", "ON_NOTIFY_RANGE message [MFC]", "notification messages", "WM_NOTIFY message"] ms.assetid: 04a96dde-7049-41df-9954-ad7bb5587caf +ms.topic: reference --- # TN061: ON_NOTIFY and WM_NOTIFY Messages diff --git a/docs/mfc/tree-control-item-states-overview.md b/docs/mfc/tree-control-item-states-overview.md index 73e7e0f6327..ca07cec4fa6 100644 --- a/docs/mfc/tree-control-item-states-overview.md +++ b/docs/mfc/tree-control-item-states-overview.md @@ -4,6 +4,7 @@ title: "Tree Control Item States Overview" ms.date: "11/04/2016" helpviewer_keywords: ["states, CTreeCtrl items", "tree controls [MFC], item states overview", "CTreeCtrl class [MFC], item states"] ms.assetid: 2db11ae0-0d87-499d-8c1f-5e0dbe9e94c8 +ms.topic: concept-article --- # Tree Control Item States Overview diff --git a/docs/mfc/turning-off-the-activate-when-visible-option.md b/docs/mfc/turning-off-the-activate-when-visible-option.md index 837eb26f2f8..a72e1bf165f 100644 --- a/docs/mfc/turning-off-the-activate-when-visible-option.md +++ b/docs/mfc/turning-off-the-activate-when-visible-option.md @@ -4,6 +4,7 @@ title: "Turning off the Activate When Visible Option" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], activate options", "Activate When Visible option [MFC]"] ms.assetid: 8f7ddc5a-a7a6-4da8-bcb9-1b569f0ecb48 +ms.topic: concept-article --- # Turning off the Activate When Visible Option diff --git a/docs/mfc/updating-the-text-of-a-status-bar-pane.md b/docs/mfc/updating-the-text-of-a-status-bar-pane.md index 389cc228367..1954167790e 100644 --- a/docs/mfc/updating-the-text-of-a-status-bar-pane.md +++ b/docs/mfc/updating-the-text-of-a-status-bar-pane.md @@ -4,6 +4,7 @@ title: "Updating the Text of a Status-Bar Pane" ms.date: "11/04/2016" helpviewer_keywords: ["updating user interface objects [MFC]", "ON_UPDATE_COMMAND_UI macro [MFC]", "user interface objects [MFC], updating", "text, status bar", "CStatusBar class [MFC], updating", "SetText method [MFC]", "panes, status bar", "status bars [MFC], updating"] ms.assetid: 4984a3f4-9905-4d8c-a927-dca19781053b +ms.topic: how-to --- # Updating the Text of a Status-Bar Pane diff --git a/docs/mfc/upgrading-an-existing-activex-control.md b/docs/mfc/upgrading-an-existing-activex-control.md index e2b88e3db99..47524f29315 100644 --- a/docs/mfc/upgrading-an-existing-activex-control.md +++ b/docs/mfc/upgrading-an-existing-activex-control.md @@ -4,6 +4,7 @@ title: "Upgrading an Existing ActiveX Control" ms.date: 11/03/2021 helpviewer_keywords: ["ActiveX controls [MFC], Internet", "LPK files for Internet controls", "safe for scripting and initialization (controls)", "OLE controls [MFC], upgrading to ActiveX", "CAB files, for ActiveX controls", "Internet applications [MFC], ActiveX controls", "Internet applications [MFC], packaging code for download", "upgrading ActiveX controls", "licensing ActiveX controls"] ms.assetid: 4d12ddfa-b491-4f9f-a0b7-b51458e05651 +ms.topic: how-to --- # Upgrading an Existing ActiveX Control diff --git a/docs/mfc/using-a-common-control-as-a-child-window.md b/docs/mfc/using-a-common-control-as-a-child-window.md index b51b02f859c..a6bb23d0b33 100644 --- a/docs/mfc/using-a-common-control-as-a-child-window.md +++ b/docs/mfc/using-a-common-control-as-a-child-window.md @@ -4,6 +4,7 @@ title: "Using a Common Control as a Child Window" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], using as child windows", "windows [MFC], common controls as", "child windows [MFC], common controls as", "common controls [MFC], child windows", "Windows common controls [MFC], child windows"] ms.assetid: 608f7d47-7854-4fce-bde9-856c51e76753 +ms.topic: how-to --- # Using a Common Control as a Child Window diff --git a/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md b/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md index ca097e6d626..896a649cbc1 100644 --- a/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md +++ b/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md @@ -4,6 +4,7 @@ title: "Using a Dialog Bar with a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["WS_EX_TRANSPARENT style", "rebar controls [MFC], dialog bars", "dialog bars [MFC], using with rebar bands"] ms.assetid: e528cea0-6b81-4bdf-9643-7c03b6176590 +ms.topic: how-to --- # Using a Dialog Bar with a Rebar Control diff --git a/docs/mfc/using-a-dialog-template-in-memory.md b/docs/mfc/using-a-dialog-template-in-memory.md index 944130b91b0..2ebc1096f2c 100644 --- a/docs/mfc/using-a-dialog-template-in-memory.md +++ b/docs/mfc/using-a-dialog-template-in-memory.md @@ -4,6 +4,7 @@ title: "Using a Dialog Template in Memory" ms.date: "11/04/2016" helpviewer_keywords: ["templates [MFC], for dialog boxes", "dialog templates [MFC]", "dialog templates [MFC], in memory", "MFC dialog boxes [MFC], dialog templates"] ms.assetid: edb443bb-e614-4f77-8a3b-74d93871e9bd +ms.topic: concept-article --- # Using a Dialog Template in Memory diff --git a/docs/mfc/using-a-hot-key-control.md b/docs/mfc/using-a-hot-key-control.md index 64a2fe30c91..ca29fb0d076 100644 --- a/docs/mfc/using-a-hot-key-control.md +++ b/docs/mfc/using-a-hot-key-control.md @@ -4,6 +4,7 @@ title: "Using a Hot Key Control" ms.date: "11/04/2016" helpviewer_keywords: ["CHotKeyCtrl class [MFC], using", "hot key controls"] ms.assetid: cdd6524b-cc43-447f-b151-164273559685 +ms.topic: concept-article --- # Using a Hot Key Control diff --git a/docs/mfc/using-an-animation-control.md b/docs/mfc/using-an-animation-control.md index cbf09f8efee..ceff13db018 100644 --- a/docs/mfc/using-an-animation-control.md +++ b/docs/mfc/using-an-animation-control.md @@ -4,6 +4,7 @@ title: "Using an Animation Control" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], animation", "CAnimateCtrl class [MFC], animation controls", "animation controls [MFC]"] ms.assetid: a009a464-e12d-4112-bf52-04a09b28dd88 +ms.topic: concept-article --- # Using an Animation Control diff --git a/docs/mfc/using-an-image-list-with-a-rebar-control.md b/docs/mfc/using-an-image-list-with-a-rebar-control.md index 2c8d693dc63..4384b1557b7 100644 --- a/docs/mfc/using-an-image-list-with-a-rebar-control.md +++ b/docs/mfc/using-an-image-list-with-a-rebar-control.md @@ -4,6 +4,7 @@ title: "Using an Image List with a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["image lists [MFC], rebar controls", "rebar controls [MFC], image lists"] ms.assetid: 1a5836ac-019a-46aa-8741-b35c3376b839 +ms.topic: how-to --- # Using an Image List with a Rebar Control diff --git a/docs/mfc/using-an-image-list.md b/docs/mfc/using-an-image-list.md index 4796e5b6fbb..7016e9dd277 100644 --- a/docs/mfc/using-an-image-list.md +++ b/docs/mfc/using-an-image-list.md @@ -4,6 +4,7 @@ title: "Using an Image List" ms.date: "11/04/2016" helpviewer_keywords: ["lists [MFC], image", "CImageList class [MFC], using", "image lists [MFC]"] ms.assetid: e0aed188-a1e6-400e-9f51-033d61c5541f +ms.topic: concept-article --- # Using an Image List diff --git a/docs/mfc/using-an-unclipped-device-context.md b/docs/mfc/using-an-unclipped-device-context.md index 9b81ba4268a..35bd4e6fa10 100644 --- a/docs/mfc/using-an-unclipped-device-context.md +++ b/docs/mfc/using-an-unclipped-device-context.md @@ -4,6 +4,7 @@ title: "Using an Unclipped Device Context" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], unclipped device context"] ms.assetid: 9c020063-73da-4803-bf7b-2e1fd950c9ed +ms.topic: concept-article --- # Using an Unclipped Device Context diff --git a/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md b/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md index 1b2bf9f7f1d..34e4486769c 100644 --- a/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md +++ b/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["DTN_FORMATQUERY", "DTN_FORMAT"] helpviewer_keywords: ["DateTimePicker control [MFC], callback fields", "callback fields in CDateTimeCtrl class [MFC]", "CDateTimeCtrl class [MFC], callback fields", "CDateTimeCtrl class [MFC], handling DTN_FORMAT and DTN_FORMATQ", "DTN_FORMATQUERY notification [MFC]", "DTN_FORMAT notification [MFC]", "DateTimePicker control [MFC]"] ms.assetid: 404f4ba9-cba7-4718-9faa-bc6b274a723f +ms.topic: concept-article --- # Using Callback Fields in a Date and Time Picker Control diff --git a/docs/mfc/using-canimatectrl.md b/docs/mfc/using-canimatectrl.md index 7c02d4b52bf..76302558736 100644 --- a/docs/mfc/using-canimatectrl.md +++ b/docs/mfc/using-canimatectrl.md @@ -4,6 +4,7 @@ title: "Using CAnimateCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["animation controls [MFC], CAnimateCtrl class", "controls [MFC], animation", "CAnimateCtrl class [MFC], about CAnimateCtrl class [MFC]"] ms.assetid: 696c0805-bef0-4e2e-a9e7-b37b9215b7f0 +ms.topic: concept-article --- # Using CAnimateCtrl diff --git a/docs/mfc/using-ccomboboxex.md b/docs/mfc/using-ccomboboxex.md index a0ccb2ebc22..a9c9fca4d11 100644 --- a/docs/mfc/using-ccomboboxex.md +++ b/docs/mfc/using-ccomboboxex.md @@ -4,6 +4,7 @@ title: "Using CComboBoxEx" ms.date: "11/04/2016" helpviewer_keywords: ["combo boxes [MFC], extended", "extended combo boxes [MFC], about extended combo boxes", "combo boxes [MFC], CComboBoxEx class", "CComboBox class [MFC], extended"] ms.assetid: c23cbfe8-75d2-4f98-a753-c942416eda52 +ms.topic: concept-article --- # Using CComboBoxEx diff --git a/docs/mfc/using-cdatetimectrl.md b/docs/mfc/using-cdatetimectrl.md index 1dc32ef93b9..2a67477916f 100644 --- a/docs/mfc/using-cdatetimectrl.md +++ b/docs/mfc/using-cdatetimectrl.md @@ -4,6 +4,7 @@ title: "Using CDateTimeCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC], CDateTimeCtrl class"] ms.assetid: cb2a8720-43f1-4c33-a3a4-def9a1622e00 +ms.topic: concept-article --- # Using CDateTimeCtrl diff --git a/docs/mfc/using-cheaderctrl.md b/docs/mfc/using-cheaderctrl.md index f5d2df5c64a..acc495d5aa1 100644 --- a/docs/mfc/using-cheaderctrl.md +++ b/docs/mfc/using-cheaderctrl.md @@ -4,6 +4,7 @@ title: "Using CHeaderCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], using", "CHeaderCtrl class [MFC]"] ms.assetid: fb3e512b-9539-43c4-a7e7-3fafd6d0706e +ms.topic: concept-article --- # Using CHeaderCtrl diff --git a/docs/mfc/using-chotkeyctrl.md b/docs/mfc/using-chotkeyctrl.md index 051b6ffdb9d..2d7022a2830 100644 --- a/docs/mfc/using-chotkeyctrl.md +++ b/docs/mfc/using-chotkeyctrl.md @@ -4,6 +4,7 @@ title: "Using CHotKeyCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["keys, hot and CHotKeyCtrl", "CHotKeyCtrl class [MFC], using", "hot key controls"] ms.assetid: 9b207117-d848-4224-8888-c3d197bb0c95 +ms.topic: concept-article --- # Using CHotKeyCtrl diff --git a/docs/mfc/using-cimagelist.md b/docs/mfc/using-cimagelist.md index 45fcf927268..64daaad06c3 100644 --- a/docs/mfc/using-cimagelist.md +++ b/docs/mfc/using-cimagelist.md @@ -4,6 +4,7 @@ title: "Using CImageList" ms.date: "11/04/2016" helpviewer_keywords: ["image list control", "CImageList class [MFC], using"] ms.assetid: 3d2a909e-d641-46b7-aada-81cab1a29b41 +ms.topic: concept-article --- # Using CImageList diff --git a/docs/mfc/using-clistctrl.md b/docs/mfc/using-clistctrl.md index ea7188aea4f..9381c761991 100644 --- a/docs/mfc/using-clistctrl.md +++ b/docs/mfc/using-clistctrl.md @@ -4,6 +4,7 @@ title: "Using CListCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], using"] ms.assetid: 20d6a5d6-8f07-4ddf-975f-ea2dfebcc835 +ms.topic: concept-article --- # Using CListCtrl diff --git a/docs/mfc/using-cmonthcalctrl.md b/docs/mfc/using-cmonthcalctrl.md index 77869ba574a..270c33595c5 100644 --- a/docs/mfc/using-cmonthcalctrl.md +++ b/docs/mfc/using-cmonthcalctrl.md @@ -4,6 +4,7 @@ title: "Using CMonthCalCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CMonthCalCtrl class [MFC], about CMonthCalCtrl class"] ms.assetid: 2be0e8c2-ed03-4853-aea1-4461eba18611 +ms.topic: concept-article --- # Using CMonthCalCtrl diff --git a/docs/mfc/using-cobject.md b/docs/mfc/using-cobject.md index af6529ea21d..a528b36ec18 100644 --- a/docs/mfc/using-cobject.md +++ b/docs/mfc/using-cobject.md @@ -4,6 +4,7 @@ title: "Using CObject" ms.date: "11/04/2016" helpviewer_keywords: ["examples [MFC], CObject", "root base class for MFC", "derived classes [MFC], from CObject", "MFC, base class", "CObject class [MFC]"] ms.assetid: d0cd19bb-2856-4b41-abbc-620fd64cb223 +ms.topic: concept-article --- # Using CObject diff --git a/docs/mfc/using-common-controls-in-a-dialog-box.md b/docs/mfc/using-common-controls-in-a-dialog-box.md index 6caadbbe11b..d28c82e7536 100644 --- a/docs/mfc/using-common-controls-in-a-dialog-box.md +++ b/docs/mfc/using-common-controls-in-a-dialog-box.md @@ -4,6 +4,7 @@ title: "Using Common Controls in a Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["common controls [MFC], in dialog boxes", "dialog box controls [MFC], common controls", "Windows common controls [MFC], in dialog boxes"] ms.assetid: 17713caf-09f8-484a-bf54-5f48bf09cce9 +ms.topic: how-to --- # Using Common Controls in a Dialog Box diff --git a/docs/mfc/using-cprogressctrl.md b/docs/mfc/using-cprogressctrl.md index 884b121ca0a..07121a9f076 100644 --- a/docs/mfc/using-cprogressctrl.md +++ b/docs/mfc/using-cprogressctrl.md @@ -4,6 +4,7 @@ title: "Using CProgressCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["progress controls [MFC]", "CProgressCtrl class [MFC], using", "progress controls [MFC], CProgressCtrl", "progress controls [MFC], using"] ms.assetid: 61473270-196b-41ab-bf2b-467f46673539 +ms.topic: concept-article --- # Using CProgressCtrl diff --git a/docs/mfc/using-crebarctrl.md b/docs/mfc/using-crebarctrl.md index c77177533ab..ce1e299588f 100644 --- a/docs/mfc/using-crebarctrl.md +++ b/docs/mfc/using-crebarctrl.md @@ -4,6 +4,7 @@ title: "Using CReBarCtrl" ms.date: "11/19/2018" helpviewer_keywords: ["child windows [MFC], rebar controls", "combo boxes [MFC], in rebar controls", "rebar controls"] ms.assetid: 2c0aeec2-ffc3-44b8-97b5-0f56e116a338 +ms.topic: concept-article --- # Using CReBarCtrl diff --git a/docs/mfc/using-cricheditctrl.md b/docs/mfc/using-cricheditctrl.md index 5d14b8c84bb..1d96ea63105 100644 --- a/docs/mfc/using-cricheditctrl.md +++ b/docs/mfc/using-cricheditctrl.md @@ -4,6 +4,7 @@ title: "Using CRichEditCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["rich edit controls [MFC], using", "CRichEditCtrl class [MFC], using"] ms.assetid: e400c6ed-563e-4d4c-ab3b-a3f0aa20273b +ms.topic: concept-article --- # Using CRichEditCtrl diff --git a/docs/mfc/using-csliderctrl.md b/docs/mfc/using-csliderctrl.md index 0b1b04c8216..f4b91032146 100644 --- a/docs/mfc/using-csliderctrl.md +++ b/docs/mfc/using-csliderctrl.md @@ -4,6 +4,7 @@ title: "Using CSliderCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CSliderCtrl class [MFC], using", "slider controls [MFC], using"] ms.assetid: 242c7bcd-126e-4b9b-8f76-8082ad06fe73 +ms.topic: concept-article --- # Using CSliderCtrl diff --git a/docs/mfc/using-cspinbuttonctrl.md b/docs/mfc/using-cspinbuttonctrl.md index 7e1f5c444c9..9a28599d04b 100644 --- a/docs/mfc/using-cspinbuttonctrl.md +++ b/docs/mfc/using-cspinbuttonctrl.md @@ -4,6 +4,7 @@ title: "Using CSpinButtonCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["up-down controls [MFC], spin button control", "up-down controls", "spin button control", "CSpinButtonCtrl class [MFC], using"] ms.assetid: a91db36b-e11e-42ef-8e89-51915cc486d2 +ms.topic: concept-article --- # Using CSpinButtonCtrl diff --git a/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md b/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md index c332a42a3e1..daf703d6076 100644 --- a/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md +++ b/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md @@ -4,6 +4,7 @@ title: "Using CStatusBarCtrl to Create a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["status bar controls [MFC], creating", "CStatusBarCtrl class [MFC], creating"] ms.assetid: 365c2b65-12de-49e6-9a2e-416c6ee10d60 +ms.topic: how-to --- # Using CStatusBarCtrl to Create a CStatusBarCtrl Object diff --git a/docs/mfc/using-cstatusbarctrl.md b/docs/mfc/using-cstatusbarctrl.md index b7805b4eb79..9cb57d6094d 100644 --- a/docs/mfc/using-cstatusbarctrl.md +++ b/docs/mfc/using-cstatusbarctrl.md @@ -4,6 +4,7 @@ title: "Using CStatusBarCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CStatusBarCtrl class [MFC], using", "status bar controls [MFC], about status bar controls"] ms.assetid: 08b39f83-580d-439a-b93e-7ef9e2a5702a +ms.topic: concept-article --- # Using CStatusBarCtrl diff --git a/docs/mfc/using-ctabctrl.md b/docs/mfc/using-ctabctrl.md index 75006f68eb2..6d93b0163f0 100644 --- a/docs/mfc/using-ctabctrl.md +++ b/docs/mfc/using-ctabctrl.md @@ -4,6 +4,7 @@ title: "Using CTabCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CTabCtrl class [MFC], using", "tab controls [MFC], using"] ms.assetid: 6bda6798-0085-4c09-a5ea-fe0e97af5c95 +ms.topic: concept-article --- # Using CTabCtrl diff --git a/docs/mfc/using-ctoolbarctrl.md b/docs/mfc/using-ctoolbarctrl.md index 13abfe7b9e4..51e7fb244bb 100644 --- a/docs/mfc/using-ctoolbarctrl.md +++ b/docs/mfc/using-ctoolbarctrl.md @@ -4,6 +4,7 @@ title: "Using CToolBarCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CToolBarCtrl class [MFC]", "toolbar controls [MFC], creating"] ms.assetid: 13cf3753-135b-4a3e-a850-ed30177fcf9d +ms.topic: concept-article --- # Using CToolBarCtrl diff --git a/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md b/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md index 14c85737f80..8bb04ae8078 100644 --- a/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md +++ b/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md @@ -4,6 +4,7 @@ title: "Using CToolTipCtrl to Create and Manipulate a CToolTipCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["tool tips [MFC], creating", "CToolTipCtrl class [MFC], using"] ms.assetid: 0a34583f-f66d-46a1-a239-31b80ea395ad +ms.topic: how-to --- # Using CToolTipCtrl to Create and Manipulate a CToolTipCtrl Object diff --git a/docs/mfc/using-ctooltipctrl.md b/docs/mfc/using-ctooltipctrl.md index edcd85851ea..88c9dd0e09b 100644 --- a/docs/mfc/using-ctooltipctrl.md +++ b/docs/mfc/using-ctooltipctrl.md @@ -4,6 +4,7 @@ title: "Using CToolTipCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CToolTipCtrl class [MFC], creating tool tips", "CToolTipCtrl class"] ms.assetid: 8fc58a04-4792-4223-a092-d349d11344da +ms.topic: concept-article --- # Using CToolTipCtrl diff --git a/docs/mfc/using-ctreectrl.md b/docs/mfc/using-ctreectrl.md index f7412fec528..18651d78c16 100644 --- a/docs/mfc/using-ctreectrl.md +++ b/docs/mfc/using-ctreectrl.md @@ -4,6 +4,7 @@ title: "Using CTreeCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CTreeCtrl class [MFC], about CTreeCtrl", "tree controls [MFC], using"] ms.assetid: 6a262f2c-3540-43e5-b03f-e4b6f9cb0325 +ms.topic: concept-article --- # Using CTreeCtrl diff --git a/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md b/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md index eae626975e7..0137fffce30 100644 --- a/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md +++ b/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md @@ -4,6 +4,7 @@ title: "Using Custom Format Strings in a Date and Time Picker Control" ms.date: "11/04/2016" helpviewer_keywords: ["CDateTimeCtrl class [MFC], display styles", "DateTimePicker control [MFC], display styles", "DateTimePicker control [MFC]"] ms.assetid: 7d577f03-6ca0-4597-9093-50b78f304719 +ms.topic: concept-article --- # Using Custom Format Strings in a Date and Time Picker Control diff --git a/docs/mfc/using-documents.md b/docs/mfc/using-documents.md index aec24f4d756..73f97283a24 100644 --- a/docs/mfc/using-documents.md +++ b/docs/mfc/using-documents.md @@ -4,6 +4,7 @@ title: "Using Documents" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], C++ applications", "data [MFC], reading", "documents [MFC]", "files [MFC], writing to", "data [MFC], documents", "files [MFC]", "views [MFC], C++ applications", "document/view architecture [MFC], documents", "reading data [MFC], documents and views", "printing [MFC], documents", "writing to files [MFC]"] ms.assetid: f390d6d8-d0e1-4497-9b6a-435f7ce0776c +ms.topic: concept-article --- # Using Documents diff --git a/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md b/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md index 818fa7efcfe..86403dd5c23 100644 --- a/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md +++ b/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TBN_DROPDOWN", "TBSTYLE_EX_DRAWDDARROWS"] helpviewer_keywords: ["CToolBarCtrl class [MFC], drop-down buttons", "toolbars [MFC], drop-down buttons", "drop-down buttons in toolbars", "TBSTYLE_EX_DRAWDDARROWS", "TBN_DROPDOWN notification [MFC]"] ms.assetid: b859f758-d2f6-40d9-9c26-0ff61993b9b2 +ms.topic: how-to --- # Using Drop-Down Buttons in a Toolbar Control diff --git a/docs/mfc/using-frame-windows.md b/docs/mfc/using-frame-windows.md index e6d18fe0760..39440816e66 100644 --- a/docs/mfc/using-frame-windows.md +++ b/docs/mfc/using-frame-windows.md @@ -4,6 +4,7 @@ title: "Using Frame Windows" ms.date: "11/04/2016" helpviewer_keywords: ["windows [MFC], frame windows", "frame windows [MFC], using", "MFC, frame windows"] ms.assetid: 4d773238-11f6-4ccf-8114-57310c5aaa2d +ms.topic: concept-article --- # Using Frame Windows diff --git a/docs/mfc/using-image-lists-in-a-toolbar-control.md b/docs/mfc/using-image-lists-in-a-toolbar-control.md index efa816d9951..5b280fa57e3 100644 --- a/docs/mfc/using-image-lists-in-a-toolbar-control.md +++ b/docs/mfc/using-image-lists-in-a-toolbar-control.md @@ -4,6 +4,7 @@ title: "Using Image Lists in a Toolbar Control" ms.date: "11/04/2016" helpviewer_keywords: ["toolbar controls [MFC], image", "image lists [MFC], toolbar controls", "CToolBarCtrl class [MFC], image lists"] ms.assetid: ccbe8df4-4ed9-4b54-bb93-9a1dcb3b97eb +ms.topic: concept-article --- # Using Image Lists in a Toolbar Control diff --git a/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md b/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md index 60f03d8ba45..4060970825c 100644 --- a/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md +++ b/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md @@ -4,6 +4,7 @@ title: "Using Image Lists in an Extended Combo Box Control" ms.date: "11/04/2016" helpviewer_keywords: ["image lists [MFC], combo boxes", "extended combo boxes [MFC], images", "images [MFC], combo box items"] ms.assetid: dfff25fe-af70-47a2-8032-3901d1e6842d +ms.topic: how-to --- # Using Image Lists in an Extended Combo Box Control diff --git a/docs/mfc/using-image-lists-with-header-controls.md b/docs/mfc/using-image-lists-with-header-controls.md index 346cef44bd1..830297f5a5f 100644 --- a/docs/mfc/using-image-lists-with-header-controls.md +++ b/docs/mfc/using-image-lists-with-header-controls.md @@ -4,6 +4,7 @@ title: "Using Image Lists with Header Controls" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], image lists", "CHeaderCtrl class [MFC], image lists", "image lists [MFC], header controls"] ms.assetid: d5e9b310-6278-406c-909c-eefa09549a47 +ms.topic: how-to --- # Using Image Lists with Header Controls diff --git a/docs/mfc/using-property-sheets-in-your-application.md b/docs/mfc/using-property-sheets-in-your-application.md index 618786b7ce7..e3dc0d6e6b8 100644 --- a/docs/mfc/using-property-sheets-in-your-application.md +++ b/docs/mfc/using-property-sheets-in-your-application.md @@ -4,6 +4,7 @@ title: "Using Property Sheets in Your Application" ms.date: "11/04/2016" helpviewer_keywords: ["dialog templates [MFC], property sheets", "dialog resources", "property pages [MFC], property sheets", "DoModal method property sheets", "AddPage method [MFC]", "property sheets, about property sheets", "Create method [MFC], property sheets", "CPropertyPage class [MFC], styles"] ms.assetid: 240654d4-152b-4e3f-af7b-44234339206e +ms.topic: how-to --- # Using Property Sheets in Your Application diff --git a/docs/mfc/using-slider-controls.md b/docs/mfc/using-slider-controls.md index ce6fe778aae..2c970e4c5b0 100644 --- a/docs/mfc/using-slider-controls.md +++ b/docs/mfc/using-slider-controls.md @@ -4,6 +4,7 @@ title: "Using Slider Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CSliderCtrl class [MFC], using", "slider controls", "slider controls [MFC], using"] ms.assetid: 2b1a8ac8-2b17-41e1-aa24-83c1fd737049 +ms.topic: concept-article --- # Using Slider Controls diff --git a/docs/mfc/using-the-carchive-output-and-input-operators.md b/docs/mfc/using-the-carchive-output-and-input-operators.md index 3562deb0f97..533547cef5d 100644 --- a/docs/mfc/using-the-carchive-output-and-input-operators.md +++ b/docs/mfc/using-the-carchive-output-and-input-operators.md @@ -4,6 +4,7 @@ title: "Using the CArchive << and >> Operators" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], loading from previously stored values", "CArchive class [MFC], storing and loading objects", "CArchive class [MFC], operators"] ms.assetid: 56aef326-02dc-4992-8282-f0a4b78a064e +ms.topic: how-to --- # Using the CArchive `<<` and `>>` Operators diff --git a/docs/mfc/using-the-classes-to-write-applications-for-windows.md b/docs/mfc/using-the-classes-to-write-applications-for-windows.md index 6b89b84fc1d..bba61db9ffc 100644 --- a/docs/mfc/using-the-classes-to-write-applications-for-windows.md +++ b/docs/mfc/using-the-classes-to-write-applications-for-windows.md @@ -4,6 +4,7 @@ title: "Using the Classes to Write Applications for Windows" ms.date: "11/04/2016" helpviewer_keywords: ["Windows applications [MFC], MFC application framework", "MFC, application development", "applications [OLE], MFC application framework", "MFC ActiveX controls [MFC], creating", "OLE applications [MFC], MFC application framework", "database applications [MFC], creating"] ms.assetid: 73f63470-857d-43dd-9a54-b38b7be0f1b7 +ms.topic: concept-article --- # Using the Classes to Write Applications for Windows From e33d444ff26e002c3ad71817bc4e5bf32f7772e7 Mon Sep 17 00:00:00 2001 From: Saisang Cai Date: Fri, 20 Jun 2025 00:07:12 +0800 Subject: [PATCH 0113/1799] Bulk update ms.topic, folder: mfc,parallel,porting,security,text,windows --- docs/mfc/using-the-dialog-editor-to-add-controls.md | 1 + docs/mfc/using-the-mfc-source-files.md | 1 + docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md | 1 + docs/mfc/using-tree-controls.md | 1 + docs/mfc/using-views.md | 1 + docs/mfc/using-your-old-toolbars.md | 1 + docs/mfc/what-is-a-carchive-object.md | 1 + docs/mfc/working-with-a-header-control.md | 1 + docs/mfc/working-with-a-tab-control.md | 1 + docs/mfc/working-with-the-toolbar-control.md | 1 + docs/mfc/working-with-window-objects.md | 1 + ...g-an-internet-client-application-using-mfc-wininet-classes.md | 1 + docs/mfc/writing-mfc-applications.md | 1 + docs/parallel/amp/cpp-amp-overview.md | 1 + .../amp/using-accelerator-and-accelerator-view-objects.md | 1 + docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md | 1 + .../using-lambdas-function-objects-and-restricted-functions.md | 1 + docs/parallel/amp/using-tiles.md | 1 + .../concrt/best-practices-in-the-asynchronous-agents-library.md | 1 + .../concrt/best-practices-in-the-parallel-patterns-library.md | 1 + ...mparing-synchronization-data-structures-to-the-windows-api.md | 1 + ...paring-the-concurrency-runtime-to-other-concurrency-models.md | 1 + docs/parallel/concrt/concurrency-runtime-best-practices.md | 1 + .../convert-an-openmp-loop-that-uses-a-reduction-variable.md | 1 + .../concrt/convert-an-openmp-loop-that-uses-cancellation.md | 1 + .../convert-an-openmp-loop-that-uses-exception-handling.md | 1 + ...ting-asynchronous-operations-in-cpp-for-windows-store-apps.md | 1 + .../concrt/general-best-practices-in-the-concurrency-runtime.md | 1 + .../concrt/migrating-from-openmp-to-the-concurrency-runtime.md | 1 + docs/parallel/concrt/overview-of-the-concurrency-runtime.md | 1 + docs/parallel/concrt/parallel-algorithms.md | 1 + docs/parallel/concrt/task-parallelism-concurrency-runtime.md | 1 + docs/parallel/multithreading-and-locales.md | 1 + docs/parallel/multithreading-creating-user-interface-threads.md | 1 + docs/parallel/multithreading-creating-worker-threads.md | 1 + .../multithreading-how-to-use-the-synchronization-classes.md | 1 + docs/parallel/multithreading-programming-tips.md | 1 + .../parallel/multithreading-support-for-older-code-visual-cpp.md | 1 + docs/parallel/multithreading-terminating-threads.md | 1 + .../multithreading-when-to-use-the-synchronization-classes.md | 1 + docs/parallel/multithreading-with-c-and-win32.md | 1 + docs/parallel/multithreading-with-cpp-and-mfc.md | 1 + docs/parallel/openmp/1-introduction.md | 1 + docs/parallel/sample-multithread-c-program.md | 1 + docs/parallel/thread-local-storage-tls.md | 1 + docs/porting/introduction-to-visual-cpp-for-unix-users.md | 1 + docs/porting/modifying-winver-and-win32-winnt.md | 1 + docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md | 1 + docs/porting/porting-and-upgrading-examples-and-case-studies.md | 1 + docs/porting/porting-from-unix-to-win32.md | 1 + docs/porting/porting-guide-com-spy.md | 1 + docs/porting/porting-guide-mfc-scribble.md | 1 + docs/porting/porting-guide-spy-increment.md | 1 + docs/porting/porting-third-party-libraries.md | 1 + docs/porting/porting-to-the-universal-windows-platform-cpp.md | 1 + docs/porting/upgrade-your-code-to-the-universal-crt.md | 1 + .../upgrading-projects-from-earlier-versions-of-visual-cpp.md | 1 + docs/porting/visual-cpp-what-s-new-2003-through-2015.md | 1 + docs/security/running-as-a-member-of-the-users-group.md | 1 + docs/security/security-best-practices-for-cpp.md | 1 + docs/text/buffer-overflow.md | 1 + docs/text/character-assignment.md | 1 + docs/text/character-comparison.md | 1 + docs/text/incrementing-and-decrementing-pointers.md | 1 + docs/text/last-character-in-a-string.md | 1 + docs/text/using-tchar-h-data-types-with-mbcs-code.md | 1 + docs/windows/adding-editing-or-deleting-controls.md | 1 + docs/windows/arrangement-of-controls-on-dialog-boxes.md | 1 + docs/windows/changing-a-symbol-or-symbol-name-id.md | 1 + docs/windows/creating-a-new-dialog-box.md | 1 + docs/windows/creating-new-symbols.md | 1 + docs/windows/defining-mnemonics-access-keys.md | 1 + docs/windows/deployment-concepts.md | 1 + docs/windows/image-editor-for-icons.md | 1 + docs/windows/redist-version-auditing.md | 1 + docs/windows/redistributing-an-atl-application.md | 1 + docs/windows/redistributing-components-by-using-merge-modules.md | 1 + docs/windows/redistributing-the-mfc-library.md | 1 + docs/windows/redistributing-visual-cpp-activex-controls.md | 1 + docs/windows/redistributing-visual-cpp-files.md | 1 + docs/windows/redistributing-web-client-applications.md | 1 + ...unning-a-cpp-clr-application-on-a-previous-runtime-version.md | 1 + .../selecting-an-area-of-an-image-image-editor-for-icons.md | 1 + docs/windows/string-editor.md | 1 + ...understanding-the-dependencies-of-a-visual-cpp-application.md | 1 + docs/windows/using-a-drawing-tool-image-editor-for-icons.md | 1 + ...eploying-a-visual-cpp-application-by-using-a-setup-project.md | 1 + ...ng-a-visual-cpp-application-to-an-application-local-folder.md | 1 + docs/windows/working-with-color-image-editor-for-icons.md | 1 + docs/windows/working-with-resource-files.md | 1 + 90 files changed, 90 insertions(+) diff --git a/docs/mfc/using-the-dialog-editor-to-add-controls.md b/docs/mfc/using-the-dialog-editor-to-add-controls.md index fa78c746bd5..c5912c87f60 100644 --- a/docs/mfc/using-the-dialog-editor-to-add-controls.md +++ b/docs/mfc/using-the-dialog-editor-to-add-controls.md @@ -4,6 +4,7 @@ title: "Using the Dialog Editor to Add Controls" ms.date: "11/04/2016" helpviewer_keywords: ["Windows common controls [MFC], adding", "dialog box controls [MFC], adding to dialog boxes", "controls [MFC], adding to dialog boxes", "Dialog editor, creating controls", "common controls [MFC], adding"] ms.assetid: d3f9f994-7e54-4656-a545-42c204557c36 +ms.topic: concept-article --- # Using the Dialog Editor to Add Controls diff --git a/docs/mfc/using-the-mfc-source-files.md b/docs/mfc/using-the-mfc-source-files.md index 77141ce95cd..10c7f2d0fcc 100644 --- a/docs/mfc/using-the-mfc-source-files.md +++ b/docs/mfc/using-the-mfc-source-files.md @@ -4,6 +4,7 @@ title: "Using the MFC source files" ms.date: "08/19/2019" helpviewer_keywords: ["public members", "source files", "MFC, source files", "MFC source files", "comments, MFC", "private member access", "protected member access", "source files, MFC"] ms.assetid: 3230e8fb-3b69-4ddf-9538-365ac7ea5e72 +ms.topic: concept-article --- # Using the MFC source files diff --git a/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md b/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md index f98699e4cdb..24f212130c9 100644 --- a/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md +++ b/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md @@ -4,6 +4,7 @@ title: "Using Tooltips in a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["tool tips [MFC], using in status bars", "status bars [MFC], tool tips", "CStatusBarCtrl class [MFC], tool tips"] ms.assetid: a77597a7-43ef-4b8f-87bc-a8ea1dc63dc3 +ms.topic: concept-article --- # Using Tooltips in a CStatusBarCtrl Object diff --git a/docs/mfc/using-tree-controls.md b/docs/mfc/using-tree-controls.md index a0b87f8f551..9130eb9f032 100644 --- a/docs/mfc/using-tree-controls.md +++ b/docs/mfc/using-tree-controls.md @@ -4,6 +4,7 @@ title: "Using Tree Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CTreeCtrl class [MFC], using", "tree controls [MFC], about tree controls"] ms.assetid: 4e92941a-e477-4fb1-b1ce-4abeafbef1c1 +ms.topic: concept-article --- # Using Tree Controls diff --git a/docs/mfc/using-views.md b/docs/mfc/using-views.md index be0abb6f982..2a3ce75afca 100644 --- a/docs/mfc/using-views.md +++ b/docs/mfc/using-views.md @@ -4,6 +4,7 @@ title: "Using Views" ms.date: "11/04/2016" helpviewer_keywords: ["interacting with users and role of view class [MFC]", "drawing [MFC], data", "rendering data", "view classes [MFC], role in managing user interaction", "CView class [MFC], view architecture", "MFC, views", "views [MFC], using", "painting data", "user input [MFC], interpreting through view class [MFC]", "view classes [MFC], role in displaying application data"] ms.assetid: dc3de6ad-5c64-4317-8f10-8bdcc38cdbd5 +ms.topic: concept-article --- # Using Views diff --git a/docs/mfc/using-your-old-toolbars.md b/docs/mfc/using-your-old-toolbars.md index 737b5f6d214..d1fe0d061b2 100644 --- a/docs/mfc/using-your-old-toolbars.md +++ b/docs/mfc/using-your-old-toolbars.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["COldToolBar"] helpviewer_keywords: ["toolbars [MFC], backward compatibility", "COldToolBar class [MFC]"] ms.assetid: 3543257c-8547-43f0-a66a-ee641dc1cf89 +ms.topic: concept-article --- # Using Your Old Toolbars diff --git a/docs/mfc/what-is-a-carchive-object.md b/docs/mfc/what-is-a-carchive-object.md index 299602c9df4..69b0bdb75a6 100644 --- a/docs/mfc/what-is-a-carchive-object.md +++ b/docs/mfc/what-is-a-carchive-object.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["archive objects [MFC]", "archives [MFC], for serialization", "buffers, serializable objects", "CArchive class [MFC], about CArchive class [MFC]", "buffering, serializable objects"] ms.assetid: 843f1825-288d-4d89-a1fa-70e1f92d9b8b ms.custom: intro-overview +ms.topic: concept-article --- # What Is a CArchive Object diff --git a/docs/mfc/working-with-a-header-control.md b/docs/mfc/working-with-a-header-control.md index 920a1c5ff09..1cd98c32b13 100644 --- a/docs/mfc/working-with-a-header-control.md +++ b/docs/mfc/working-with-a-header-control.md @@ -4,6 +4,7 @@ title: "Working with a Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], working with", "header controls"] ms.assetid: af3afb5c-bf97-451b-8fee-3adcb8257210 +ms.topic: concept-article --- # Working with a Header Control diff --git a/docs/mfc/working-with-a-tab-control.md b/docs/mfc/working-with-a-tab-control.md index 6894322f677..e730f954acd 100644 --- a/docs/mfc/working-with-a-tab-control.md +++ b/docs/mfc/working-with-a-tab-control.md @@ -4,6 +4,7 @@ title: "Working with a Tab Control" ms.date: "11/04/2016" helpviewer_keywords: ["CTabCtrl class [MFC], using", "tab controls [MFC], working with", "tab controls [MFC], using"] ms.assetid: 819488e3-4944-44b7-9483-195edb8e0aed +ms.topic: concept-article --- # Working with a Tab Control diff --git a/docs/mfc/working-with-the-toolbar-control.md b/docs/mfc/working-with-the-toolbar-control.md index f0660e38d6d..486ff79f32e 100644 --- a/docs/mfc/working-with-the-toolbar-control.md +++ b/docs/mfc/working-with-the-toolbar-control.md @@ -4,6 +4,7 @@ title: "Working with the Toolbar Control" ms.date: "11/04/2016" helpviewer_keywords: ["GetToolBarCtrl method [MFC]", "toolbars [MFC], accessing common control", "CToolBarCtrl class [MFC], accessing toolbar", "toolbar controls [MFC], accessing"] ms.assetid: b19409d5-3831-42c7-80ae-195c49dc9085 +ms.topic: how-to --- # Working with the Toolbar Control diff --git a/docs/mfc/working-with-window-objects.md b/docs/mfc/working-with-window-objects.md index 3624187334e..55547aac560 100644 --- a/docs/mfc/working-with-window-objects.md +++ b/docs/mfc/working-with-window-objects.md @@ -4,6 +4,7 @@ title: "Working with Window Objects" ms.date: "11/04/2016" helpviewer_keywords: ["child windows [MFC], working with", "window objects [MFC], working with"] ms.assetid: f73aa254-90e3-46a9-8e9b-d78b7054a331 +ms.topic: concept-article --- # Working with Window Objects diff --git a/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md b/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md index ce28434c991..89176ac68ec 100644 --- a/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md +++ b/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md @@ -4,6 +4,7 @@ title: "Writing an Internet Client Application Using MFC WinInet Classes" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC]", "WinInet classes [MFC], programming", "Internet client applications [MFC], writing", "Internet applications [MFC], WinInet", "Internet applications [MFC], client applications", "MFC, Internet applications"] ms.assetid: a2c4a40c-a94e-4b3e-9dbf-f8a8dc8e5428 +ms.topic: concept-article --- # Writing an Internet Client Application Using MFC WinInet Classes diff --git a/docs/mfc/writing-mfc-applications.md b/docs/mfc/writing-mfc-applications.md index 8858085fae1..abb166fc975 100644 --- a/docs/mfc/writing-mfc-applications.md +++ b/docs/mfc/writing-mfc-applications.md @@ -4,6 +4,7 @@ title: "Writing MFC Applications" ms.date: "09/12/2018" helpviewer_keywords: ["Internet applications [MFC], MFC", "MFC, Internet applications", "application wizards [MFC], Internet applications", "MFC, application development"] ms.assetid: 6a8d8a03-abfa-4976-86c2-c5773a4b7179 +ms.topic: concept-article --- # Writing MFC Applications diff --git a/docs/parallel/amp/cpp-amp-overview.md b/docs/parallel/amp/cpp-amp-overview.md index c6d4d0fb204..3fdac7ec564 100644 --- a/docs/parallel/amp/cpp-amp-overview.md +++ b/docs/parallel/amp/cpp-amp-overview.md @@ -3,6 +3,7 @@ description: "Learn more about: C++ AMP Overview" title: "C++ AMP Overview" ms.date: "11/19/2018" helpviewer_keywords: ["C++ Accelerated Massive Parallelism, requirements", "C++ Accelerated Massive Parallelism, architecture", "C++ AMP", "C++ Accelerated Massive Parallelism, overview", "C++ Accelerated Massive Parallelism"] +ms.topic: concept-article --- # C++ AMP Overview diff --git a/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md b/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md index fb4f51eb4ce..5546f803840 100644 --- a/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md +++ b/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md @@ -2,6 +2,7 @@ title: "Using accelerator and accelerator_view Objects" description: "Learn more about: Using accelerator and accelerator_view Objects" ms.date: "11/04/2016" +ms.topic: how-to --- # Using accelerator and accelerator_view Objects diff --git a/docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md b/docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md index 7068a8bd01d..48032eb464a 100644 --- a/docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md +++ b/docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md @@ -2,6 +2,7 @@ description: "Learn more about: Using C++ AMP in UWP Apps" title: "Using C++ AMP in UWP Apps" ms.date: "11/04/2016" +ms.topic: concept-article --- # Using C++ AMP in UWP Apps diff --git a/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md b/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md index 8daf3188924..dfe089c6702 100644 --- a/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md +++ b/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md @@ -2,6 +2,7 @@ description: "Learn more about: Using Lambdas, Function Objects, and Restricted Functions" title: "Using Lambdas, Function Objects, and Restricted Functions" ms.date: "11/04/2016" +ms.topic: concept-article --- # Using Lambdas, Function Objects, and Restricted Functions diff --git a/docs/parallel/amp/using-tiles.md b/docs/parallel/amp/using-tiles.md index a68f6a66b8f..e8b2840cdca 100644 --- a/docs/parallel/amp/using-tiles.md +++ b/docs/parallel/amp/using-tiles.md @@ -2,6 +2,7 @@ description: "Learn more about: Using Tiles" title: "Using Tiles" ms.date: "11/19/2018" +ms.topic: how-to --- # Using Tiles diff --git a/docs/parallel/concrt/best-practices-in-the-asynchronous-agents-library.md b/docs/parallel/concrt/best-practices-in-the-asynchronous-agents-library.md index 88a23f3247a..f41406f07f4 100644 --- a/docs/parallel/concrt/best-practices-in-the-asynchronous-agents-library.md +++ b/docs/parallel/concrt/best-practices-in-the-asynchronous-agents-library.md @@ -4,6 +4,7 @@ title: "Best Practices in the Asynchronous Agents Library" ms.date: 08/25/2021 helpviewer_keywords: ["best practices, Asynchronous Agents Library", "Asynchronous Agents Library, best practices", "Asynchronous Agents Library, practices to avoid", "practices to avoid, Asynchronous Agents Library"] ms.assetid: 85f52354-41eb-4b0d-98c5-f7344ee8a8cf +ms.topic: best-practice --- # Best Practices in the Asynchronous Agents Library diff --git a/docs/parallel/concrt/best-practices-in-the-parallel-patterns-library.md b/docs/parallel/concrt/best-practices-in-the-parallel-patterns-library.md index 6a1a2286785..34ef2be1166 100644 --- a/docs/parallel/concrt/best-practices-in-the-parallel-patterns-library.md +++ b/docs/parallel/concrt/best-practices-in-the-parallel-patterns-library.md @@ -4,6 +4,7 @@ title: "Best Practices in the Parallel Patterns Library" ms.date: "11/04/2016" helpviewer_keywords: ["Parallel Patterns Library, practices to avoid", "practices to avoid, Parallel Patterns Library", "best practices, Parallel Patterns Library", "Parallel Patterns Library, best practices"] ms.assetid: e43e0304-4d54-4bd8-a3b3-b8673559a9d7 +ms.topic: best-practice --- # Best Practices in the Parallel Patterns Library diff --git a/docs/parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md b/docs/parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md index db3fe945cdf..bd772a4ef62 100644 --- a/docs/parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md +++ b/docs/parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md @@ -4,6 +4,7 @@ title: "Comparing Synchronization Data Structures to the Windows API" ms.date: "11/04/2016" helpviewer_keywords: ["synchronization data structures, compared to Windows API", "event class, example"] ms.assetid: 8b0b1a3a-ef80-408c-91fa-93e6af920b4e +ms.topic: concept-article --- # Comparing Synchronization Data Structures to the Windows API diff --git a/docs/parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md b/docs/parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md index 6ed662fcd00..6b4db8e930f 100644 --- a/docs/parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md +++ b/docs/parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md @@ -4,6 +4,7 @@ title: "Comparing the Concurrency Runtime to Other Concurrency Models" ms.date: "11/04/2016" helpviewer_keywords: ["Concurrency Runtime, compared to other models"] ms.assetid: d8b9a1f4-f15f-43c3-a5b4-c0991edf9c86 +ms.topic: concept-article --- # Comparing the Concurrency Runtime to Other Concurrency Models diff --git a/docs/parallel/concrt/concurrency-runtime-best-practices.md b/docs/parallel/concrt/concurrency-runtime-best-practices.md index a3406772d9e..17e5f8d963c 100644 --- a/docs/parallel/concrt/concurrency-runtime-best-practices.md +++ b/docs/parallel/concrt/concurrency-runtime-best-practices.md @@ -4,6 +4,7 @@ title: "Concurrency Runtime Best Practices" ms.date: "11/04/2016" helpviewer_keywords: ["best practices [Concurrency Runtime]", "Concurrency Runtime, practices to avoid", "practices to avoid [Concurrency Runtime]", "Concurrency Runtime, best practices"] ms.assetid: 7231d4be-d1e3-401d-8b66-94fd51b587c9 +ms.topic: best-practice --- # Concurrency Runtime Best Practices diff --git a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md index 456c664ae94..610f700e892 100644 --- a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md +++ b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md @@ -4,6 +4,7 @@ title: "How to: Convert an OpenMP Loop that Uses a Reduction Variable to Use the ms.date: "11/04/2016" helpviewer_keywords: ["converting from OpenMP to the Concurrency Runtime, reduction variables", "reduction variables, converting from OpenMP to the Concurrency Runtime"] ms.assetid: 96623f36-5e57-4d3f-8c13-669e6cd535b1 +ms.topic: how-to --- # How to: Convert an OpenMP Loop that Uses a Reduction Variable to Use the Concurrency Runtime diff --git a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md index 2bb78350f39..0afc5284349 100644 --- a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md +++ b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md @@ -4,6 +4,7 @@ title: "How to: Convert an OpenMP Loop that Uses Cancellation to Use the Concurr ms.date: "11/04/2016" helpviewer_keywords: ["converting from OpenMP to the Concurrency Runtime, cancellation", "cancellation, converting from OpenMP to the Concurrency Runtime"] ms.assetid: 4b0b3c33-bfa9-4e96-ae08-aef245a39cbb +ms.topic: how-to --- # How to: Convert an OpenMP Loop that Uses Cancellation to Use the Concurrency Runtime diff --git a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md index 7ccc8056816..2b4ed57d1bd 100644 --- a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md +++ b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md @@ -4,6 +4,7 @@ title: "How to: Convert an OpenMP Loop that Uses Exception Handling to Use the C ms.date: "11/04/2016" helpviewer_keywords: ["exception handling, converting from OpenMP to the Concurrency Runtime", "converting from OpenMP to the Concurrency Runtime, exception handling"] ms.assetid: 03c28196-21ba-439e-8641-afab1c283e1a +ms.topic: how-to --- # How to: Convert an OpenMP Loop that Uses Exception Handling to Use the Concurrency Runtime diff --git a/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md b/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md index 99750f5ce7c..ab148345553 100644 --- a/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md +++ b/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md @@ -4,6 +4,7 @@ title: "Creating Asynchronous Operations in C++ for UWP Apps" ms.date: "11/19/2018" helpviewer_keywords: ["Windows 8.x apps, creating C++ async operations", "Creating C++ async operations"] ms.assetid: a57cecf4-394a-4391-a957-1d52ed2e5494 +ms.topic: concept-article --- # Creating Asynchronous Operations in C++ for UWP Apps diff --git a/docs/parallel/concrt/general-best-practices-in-the-concurrency-runtime.md b/docs/parallel/concrt/general-best-practices-in-the-concurrency-runtime.md index cd72bb5c728..8e933fe5010 100644 --- a/docs/parallel/concrt/general-best-practices-in-the-concurrency-runtime.md +++ b/docs/parallel/concrt/general-best-practices-in-the-concurrency-runtime.md @@ -4,6 +4,7 @@ title: "General Best Practices in the Concurrency Runtime" ms.date: "11/04/2016" helpviewer_keywords: ["Concurrency Runtime, general best practices"] ms.assetid: ce5c784c-051e-44a6-be84-8b3e1139c18b +ms.topic: best-practice --- # General Best Practices in the Concurrency Runtime diff --git a/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md b/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md index 15d2ff642bd..a7bd32a04ce 100644 --- a/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md +++ b/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["Concurrency Runtime, migrating from OpenMP", "OpenMP, migrating to the Concurrency Runtime"] ms.assetid: 9bab7bb1-e45d-44b2-8509-3b226be2c93b ms.custom: intro-migration +ms.topic: concept-article --- # Migrating from OpenMP to the Concurrency Runtime diff --git a/docs/parallel/concrt/overview-of-the-concurrency-runtime.md b/docs/parallel/concrt/overview-of-the-concurrency-runtime.md index e36669177c0..5c241631492 100644 --- a/docs/parallel/concrt/overview-of-the-concurrency-runtime.md +++ b/docs/parallel/concrt/overview-of-the-concurrency-runtime.md @@ -4,6 +4,7 @@ title: "Overview of the Concurrency Runtime" ms.date: "11/19/2018" helpviewer_keywords: ["Concurrency Runtime, requirements", "Concurrency Runtime, architecture", "Concurrency Runtime, overview", "Concurrency Runtime, lambda expressions"] ms.assetid: 56237d96-10b0-494a-9cb4-f5c5090436c5 +ms.topic: concept-article --- # Overview of the Concurrency Runtime diff --git a/docs/parallel/concrt/parallel-algorithms.md b/docs/parallel/concrt/parallel-algorithms.md index b9f60473e1a..bf70d79533a 100644 --- a/docs/parallel/concrt/parallel-algorithms.md +++ b/docs/parallel/concrt/parallel-algorithms.md @@ -4,6 +4,7 @@ title: "Parallel Algorithms" ms.date: "11/19/2018" helpviewer_keywords: ["parallel algorithms [Concurrency Runtime]"] ms.assetid: 045dca7b-4d73-4558-a44c-383b88a28473 +ms.topic: how-to --- # Parallel Algorithms diff --git a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md index 06706486753..0f71bc66b1a 100644 --- a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md +++ b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md @@ -4,6 +4,7 @@ title: "Task Parallelism (Concurrency Runtime)" ms.date: "11/04/2016" helpviewer_keywords: ["structured task groups [Concurrency Runtime]", "structured tasks [Concurrency Runtime]", "task groups [Concurrency Runtime]", "task parallelism", "tasks [Concurrency Runtime]"] ms.assetid: 42f05ac3-2098-494a-ba84-737fcdcad077 +ms.topic: how-to --- # Task Parallelism (Concurrency Runtime) diff --git a/docs/parallel/multithreading-and-locales.md b/docs/parallel/multithreading-and-locales.md index 8df3ba928ec..2cdb9b4db2f 100644 --- a/docs/parallel/multithreading-and-locales.md +++ b/docs/parallel/multithreading-and-locales.md @@ -4,6 +4,7 @@ title: "Multithreading and Locales" ms.date: "11/04/2016" helpviewer_keywords: ["locales [C++], multithreading", "multithreading [C++], locales", "threading [C++], locales", "per-thread locale"] ms.assetid: d6fb159a-eaca-4130-a51a-f95d62f71485 +ms.topic: concept-article --- # Multithreading and Locales diff --git a/docs/parallel/multithreading-creating-user-interface-threads.md b/docs/parallel/multithreading-creating-user-interface-threads.md index fa1abe4c069..c99ab0ba96d 100644 --- a/docs/parallel/multithreading-creating-user-interface-threads.md +++ b/docs/parallel/multithreading-creating-user-interface-threads.md @@ -5,6 +5,7 @@ ms.date: "08/27/2018" f1_keywords: ["CREATE_SUSPENDED", "SECURITY_ATTRIBUTES"] helpviewer_keywords: ["multithreading [C++], user interface threads", "threading [C++], creating threads", "threading [C++], user interface threads", "user interface threads [C++]", "threading [MFC], user interface threads"] ms.assetid: 446925c1-db59-46ea-ae5b-d5ae5d5b91d8 +ms.topic: concept-article --- # Multithreading: Creating MFC User-Interface Threads diff --git a/docs/parallel/multithreading-creating-worker-threads.md b/docs/parallel/multithreading-creating-worker-threads.md index c967eda95e8..2c390f142ec 100644 --- a/docs/parallel/multithreading-creating-worker-threads.md +++ b/docs/parallel/multithreading-creating-worker-threads.md @@ -4,6 +4,7 @@ title: "Multithreading: Creating Worker Threads in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["multithreading [C++], worker threads", "background tasks [C++]", "threading [C++], worker threads", "worker threads [C++]", "threading [C++], creating threads", "threading [MFC], worker threads", "threading [C++], user input not required"] ms.assetid: 670adbfe-041c-4450-a3ed-be14aab15234 +ms.topic: concept-article --- # Multithreading: Creating Worker Threads in MFC diff --git a/docs/parallel/multithreading-how-to-use-the-synchronization-classes.md b/docs/parallel/multithreading-how-to-use-the-synchronization-classes.md index af8f3e3a13e..ffbc5183f2a 100644 --- a/docs/parallel/multithreading-how-to-use-the-synchronization-classes.md +++ b/docs/parallel/multithreading-how-to-use-the-synchronization-classes.md @@ -4,6 +4,7 @@ title: "Multithreading: How to Use the MFC Synchronization Classes" ms.date: "08/27/2018" helpviewer_keywords: ["MFC [C++], multithreading", "threading [MFC], synchronization classes", "resources [C++], multithreading", "thread-safe classes [C++]", "synchronization classes [C++]", "synchronization [C++], multithreading", "threading [MFC], thread-safe class design", "threading [C++], synchronization", "multithreading [C++], synchronization classes", "threading [C++], thread-safe class design"] ms.assetid: f266d4c6-0454-4bda-9758-26157ef74cc5 +ms.topic: how-to --- # Multithreading: How to Use the MFC Synchronization Classes diff --git a/docs/parallel/multithreading-programming-tips.md b/docs/parallel/multithreading-programming-tips.md index 1017d68873a..8048068fc7c 100644 --- a/docs/parallel/multithreading-programming-tips.md +++ b/docs/parallel/multithreading-programming-tips.md @@ -4,6 +4,7 @@ title: "Multithreading: MFC Programming Tips" ms.date: "08/27/2018" helpviewer_keywords: ["multithreading [C++], programming tips", "handle maps [C++]", "access control [C++], multithreading", "objects [C++], multiple threads and", "non-MFC threads [C++]", "threading [MFC], programming tips", "critical sections [C++]", "synchronization [C++], multithreading", "programming [C++], multithreaded", "communications [C++], between threads", "threading [C++], best practices", "troubleshooting [C++], multithreading", "Windows handle maps [C++]"] ms.assetid: ad14cc70-c91c-4c24-942f-13a75e58bf8a +ms.topic: concept-article --- # Multithreading: MFC Programming Tips diff --git a/docs/parallel/multithreading-support-for-older-code-visual-cpp.md b/docs/parallel/multithreading-support-for-older-code-visual-cpp.md index 43071cb689d..b2c9fea8356 100644 --- a/docs/parallel/multithreading-support-for-older-code-visual-cpp.md +++ b/docs/parallel/multithreading-support-for-older-code-visual-cpp.md @@ -4,6 +4,7 @@ title: "Multithreading Support for Older Code (Visual C++)" ms.date: "08/27/2018" helpviewer_keywords: ["threading [C++]", "multiple threads", "concurrent programming [C++]", "programming [C++], multithreaded", "multithreading [C++], about multithreading", "multiple concurrent threads", "multithreading [C++]"] ms.assetid: 24425b1f-5031-4c6b-aac7-017115a40e7c +ms.topic: concept-article --- # Multithreading Support for Older Code (Visual C++) diff --git a/docs/parallel/multithreading-terminating-threads.md b/docs/parallel/multithreading-terminating-threads.md index 5f530d673ad..8ca9648b308 100644 --- a/docs/parallel/multithreading-terminating-threads.md +++ b/docs/parallel/multithreading-terminating-threads.md @@ -4,6 +4,7 @@ title: "Multithreading: Terminating Threads in MFC" ms.date: "08/27/2018" helpviewer_keywords: ["premature thread termination", "starting threads", "threading [MFC], terminating threads", "multithreading [C++], terminating threads", "threading [C++], stopping threads", "terminating threads", "stopping threads", "AfxEndThread method"] ms.assetid: 4c0a8c6d-c02f-456d-bd02-0a8c8d006ecb +ms.topic: concept-article --- # Multithreading: Terminating Threads in MFC diff --git a/docs/parallel/multithreading-when-to-use-the-synchronization-classes.md b/docs/parallel/multithreading-when-to-use-the-synchronization-classes.md index 7fad93900e2..0a7c3a15d87 100644 --- a/docs/parallel/multithreading-when-to-use-the-synchronization-classes.md +++ b/docs/parallel/multithreading-when-to-use-the-synchronization-classes.md @@ -4,6 +4,7 @@ title: "Multithreading: When to Use the MFC Synchronization Classes" ms.date: "08/27/2018" helpviewer_keywords: ["threading [MFC], synchronization classes", "resources [C++], multithreading", "synchronization classes [C++]", "synchronization [C++], multithreading", "controlled resource access [C++]", "synchronization access classes [C++]", "threading [C++], synchronization", "multithreading [C++], synchronization classes"] ms.assetid: 4914f54e-68ac-438f-93c9-c013455a657e +ms.topic: how-to --- # Multithreading: When to Use the MFC Synchronization Classes diff --git a/docs/parallel/multithreading-with-c-and-win32.md b/docs/parallel/multithreading-with-c-and-win32.md index 6381e9ba552..e3f2f9335b2 100644 --- a/docs/parallel/multithreading-with-c-and-win32.md +++ b/docs/parallel/multithreading-with-c-and-win32.md @@ -4,6 +4,7 @@ title: "Multithreading with C and Win32" ms.date: "08/09/2019" helpviewer_keywords: ["Windows API [C++], multithreading", "multithreading [C++], C and Win32", "Visual C, multithreading", "Win32 applications [C++], multithreading", "threading [C++], C and Win32", "Win32 [C++], multithreading", "threading [C]"] ms.assetid: 67cdc99e-1ad9-452b-a042-ed246b70040e +ms.topic: concept-article --- # Multithreading with C and Win32 diff --git a/docs/parallel/multithreading-with-cpp-and-mfc.md b/docs/parallel/multithreading-with-cpp-and-mfc.md index 9421b44d6b2..7fc4d93386e 100644 --- a/docs/parallel/multithreading-with-cpp-and-mfc.md +++ b/docs/parallel/multithreading-with-cpp-and-mfc.md @@ -4,6 +4,7 @@ title: "Multithreading with C++ and MFC" ms.date: "08/27/2018" helpviewer_keywords: ["MFC [C++], multithreading", "threading [C++], MFC", "worker threads [C++]", "synchronization classes [C++]", "synchronization [C++], multithreading", "threading [MFC], about threading", "CWinThread class, purpose of", "multithreading [C++], MFC", "threading [MFC]", "user interface threads [C++]"] ms.assetid: 979605f8-3988-44b5-ac9c-b8cce7fcce14 +ms.topic: concept-article --- # Multithreading with C++ and MFC diff --git a/docs/parallel/openmp/1-introduction.md b/docs/parallel/openmp/1-introduction.md index 577e1556d99..3e819472bde 100644 --- a/docs/parallel/openmp/1-introduction.md +++ b/docs/parallel/openmp/1-introduction.md @@ -3,6 +3,7 @@ description: "Learn more about: 1. Introduction" title: "1. Introduction" ms.date: "01/16/2019" ms.assetid: c42e72bc-0e31-4b1c-b670-cd82673c0c5a +ms.topic: concept-article --- # 1. Introduction diff --git a/docs/parallel/sample-multithread-c-program.md b/docs/parallel/sample-multithread-c-program.md index f76e104bd1d..7be0bc3381a 100644 --- a/docs/parallel/sample-multithread-c-program.md +++ b/docs/parallel/sample-multithread-c-program.md @@ -2,6 +2,7 @@ description: "Learn more about: Sample Multithread C Program" title: "Sample Multithread C Program" ms.date: 04/07/2022 +ms.topic: how-to --- # Sample Multithread C Program diff --git a/docs/parallel/thread-local-storage-tls.md b/docs/parallel/thread-local-storage-tls.md index 42ccaa72774..fbcd5b93e33 100644 --- a/docs/parallel/thread-local-storage-tls.md +++ b/docs/parallel/thread-local-storage-tls.md @@ -4,6 +4,7 @@ title: "Thread Local Storage (TLS)" ms.date: "08/09/2019" helpviewer_keywords: ["multithreading [C++], Thread Local Storage", "TLS [C++]", "threading [C++], Thread Local Storage", "storing thread-specific data", "thread attribute", "Thread Local Storage [C++]"] ms.assetid: 80801907-d792-45ca-b776-df0cf2e9f197 +ms.topic: how-to --- # Thread Local Storage (TLS) diff --git a/docs/porting/introduction-to-visual-cpp-for-unix-users.md b/docs/porting/introduction-to-visual-cpp-for-unix-users.md index 87dc4245886..4aa29e40e1a 100644 --- a/docs/porting/introduction-to-visual-cpp-for-unix-users.md +++ b/docs/porting/introduction-to-visual-cpp-for-unix-users.md @@ -4,6 +4,7 @@ title: "Introduction to Microsoft C++ for UNIX Users" ms.date: 06/22/2021 helpviewer_keywords: ["UNIX [C++]"] ms.assetid: 36108b31-e7fa-49a8-a1f7-7077fcbec873 +ms.topic: concept-article --- # Introduction to Microsoft C++ for UNIX Users diff --git a/docs/porting/modifying-winver-and-win32-winnt.md b/docs/porting/modifying-winver-and-win32-winnt.md index 6c6e1fe1556..69ac9a1e52e 100644 --- a/docs/porting/modifying-winver-and-win32-winnt.md +++ b/docs/porting/modifying-winver-and-win32-winnt.md @@ -4,6 +4,7 @@ description: "When and how to update WINVER and _WIN32_WINNT macros in upgraded ms.date: "06/19/2020" helpviewer_keywords: ["WINVER in an upgraded Visual Studio C++ project", "_WIN32_WINNT in an upgraded Visual Studio C++ project"] ms.assetid: 6a1f1d66-ae0e-48a7-81c3-524d8e8f3447 +ms.topic: how-to --- # Update WINVER and _WIN32_WINNT diff --git a/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md b/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md index d6167c1c635..fbae3e758a8 100644 --- a/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md +++ b/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md @@ -3,6 +3,7 @@ description: "Learn more about: Overview of potential upgrade issues (Visual C++ title: "Overview of potential upgrade issues (Visual C++)" ms.date: 10/22/2021 ms.assetid: 2c99a8cb-098f-4a9d-bf2c-b80fd06ace43 +ms.topic: upgrade-and-migration-article --- # Overview of potential upgrade issues (Visual C++) diff --git a/docs/porting/porting-and-upgrading-examples-and-case-studies.md b/docs/porting/porting-and-upgrading-examples-and-case-studies.md index 84abafd2e48..d4e1d1b4855 100644 --- a/docs/porting/porting-and-upgrading-examples-and-case-studies.md +++ b/docs/porting/porting-and-upgrading-examples-and-case-studies.md @@ -3,6 +3,7 @@ description: "Learn more about: Porting and Upgrading: Examples and Case Studies title: "Porting and Upgrading: Examples and Case Studies" ms.date: "11/04/2016" ms.assetid: d48bbff9-1ea7-467f-8c8b-758601f01573 +ms.topic: concept-article --- # Porting and Upgrading: Examples and Case Studies diff --git a/docs/porting/porting-from-unix-to-win32.md b/docs/porting/porting-from-unix-to-win32.md index db38c1d6212..379d9fc43da 100644 --- a/docs/porting/porting-from-unix-to-win32.md +++ b/docs/porting/porting-from-unix-to-win32.md @@ -4,6 +4,7 @@ title: "Running Linux programs on Windows" ms.date: "07/31/2019" helpviewer_keywords: ["Linux [C++], porting to Win32"] ms.assetid: 3837e4fe-3f96-4f24-b2a1-7be94718a881 +ms.topic: concept-article --- # Running Linux programs on Windows diff --git a/docs/porting/porting-guide-com-spy.md b/docs/porting/porting-guide-com-spy.md index 787bf8c9a80..3df4ffa9163 100644 --- a/docs/porting/porting-guide-com-spy.md +++ b/docs/porting/porting-guide-com-spy.md @@ -3,6 +3,7 @@ description: "Learn more about: Porting Guide: COM Spy" title: "Porting Guide: COM Spy" ms.date: "11/04/2016" ms.assetid: 24aa0d52-4014-4acb-8052-f4e2e4bbc3bb +ms.topic: concept-article --- # Porting Guide: COM Spy diff --git a/docs/porting/porting-guide-mfc-scribble.md b/docs/porting/porting-guide-mfc-scribble.md index a2b0182ad99..8545e8fa71c 100644 --- a/docs/porting/porting-guide-mfc-scribble.md +++ b/docs/porting/porting-guide-mfc-scribble.md @@ -3,6 +3,7 @@ description: "Learn more about: Porting Guide: MFC Scribble" title: "Porting Guide: MFC Scribble" ms.date: "10/23/2019" ms.assetid: 8ddb517d-89ba-41a1-ab0d-4d2c6d9047e8 +ms.topic: concept-article --- # Porting Guide: MFC Scribble diff --git a/docs/porting/porting-guide-spy-increment.md b/docs/porting/porting-guide-spy-increment.md index 208342a0315..2f471d3e3e4 100644 --- a/docs/porting/porting-guide-spy-increment.md +++ b/docs/porting/porting-guide-spy-increment.md @@ -3,6 +3,7 @@ description: "Learn more about: Porting Guide: Spy++" title: "Porting Guide: Spy++" ms.date: "10/23/2019" ms.assetid: e558f759-3017-48a7-95a9-b5b779d5e51d +ms.topic: concept-article --- # Porting Guide: Spy++ diff --git a/docs/porting/porting-third-party-libraries.md b/docs/porting/porting-third-party-libraries.md index db6afa9358c..6a569a06924 100644 --- a/docs/porting/porting-third-party-libraries.md +++ b/docs/porting/porting-third-party-libraries.md @@ -4,6 +4,7 @@ title: "Porting Third-Party Libraries" ms.date: 10/22/2021 helpviewer_keywords: ["3rd-party libraries", "vspkg"] ms.assetid: b055ed20-8a9e-45b2-ac2a-e3d94271c009 +ms.topic: concept-article --- # Porting third-party libraries diff --git a/docs/porting/porting-to-the-universal-windows-platform-cpp.md b/docs/porting/porting-to-the-universal-windows-platform-cpp.md index d6ac9d6883d..742390cf472 100644 --- a/docs/porting/porting-to-the-universal-windows-platform-cpp.md +++ b/docs/porting/porting-to-the-universal-windows-platform-cpp.md @@ -3,6 +3,7 @@ description: "Learn more about: Porting to the Universal Windows Platform (C++)" title: "Porting to the Universal Windows Platform (C++)" ms.date: "10/23/2019" ms.assetid: f662d2e4-8940-418d-8109-cb76cb8f8569 +ms.topic: how-to --- # Porting to the Universal Windows Platform (C++) diff --git a/docs/porting/upgrade-your-code-to-the-universal-crt.md b/docs/porting/upgrade-your-code-to-the-universal-crt.md index 03e27d4e2a3..5c3ba784e29 100644 --- a/docs/porting/upgrade-your-code-to-the-universal-crt.md +++ b/docs/porting/upgrade-your-code-to-the-universal-crt.md @@ -3,6 +3,7 @@ description: "Learn more about: Upgrade your code to the Universal CRT" title: "Upgrade your code to the Universal CRT" ms.date: 06/28/2022 ms.assetid: eaf34c1b-da98-4058-a059-a10db693a5ce +ms.topic: upgrade-and-migration-article --- # Upgrade your code to the Universal CRT diff --git a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md index 53b9ef1a069..76f6dce84d9 100644 --- a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md +++ b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md @@ -4,6 +4,7 @@ description: "How to upgrade Microsoft C++ projects from older versions of Visua ms.date: 04/07/2022 helpviewer_keywords: ["32-bit code porting", "upgrading Visual C++ applications, 32-bit code"] ms.assetid: 18cdacaa-4742-43db-9e4c-2d9e73d8cc84 +ms.topic: upgrade-and-migration-article --- # Upgrade C++ projects from earlier versions of Visual Studio diff --git a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md index e2a8e80cb99..9c2897d77ad 100644 --- a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md +++ b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md @@ -2,6 +2,7 @@ title: "Visual C++ What's New 2003 through 2015" description: "Learn more about: Visual C++ What's New 2003 through 2015" ms.date: 07/02/2019 +ms.topic: whats-new --- # Visual C++ What's New 2003 through 2015 diff --git a/docs/security/running-as-a-member-of-the-users-group.md b/docs/security/running-as-a-member-of-the-users-group.md index 833678cb72d..0fec514075e 100644 --- a/docs/security/running-as-a-member-of-the-users-group.md +++ b/docs/security/running-as-a-member-of-the-users-group.md @@ -4,6 +4,7 @@ title: "Running as a Member of the Users Group" ms.date: "11/04/2016" helpviewer_keywords: ["Users Group [C++]", "security [C++], Users Group", "Windows accounts [C++]", "non administrator users [C++]", "user accounts [C++]", "administrator (not running as) [C++]"] ms.assetid: e48a03ec-d345-49f6-809a-1a291eecbc81 +ms.topic: concept-article --- # Running as a Member of the Users Group diff --git a/docs/security/security-best-practices-for-cpp.md b/docs/security/security-best-practices-for-cpp.md index c895388f5fb..6cc6c47315c 100644 --- a/docs/security/security-best-practices-for-cpp.md +++ b/docs/security/security-best-practices-for-cpp.md @@ -4,6 +4,7 @@ description: "Learn more about: Security Best Practices for C++" ms.date: 05/08/2018 f1_keywords: ["securitybestpracticesVC"] helpviewer_keywords: ["Visual C++, security", "security [C++]", "security [C++], best practices"] +ms.topic: best-practice --- # Security Best Practices for C++ diff --git a/docs/text/buffer-overflow.md b/docs/text/buffer-overflow.md index 6d7dad95dc2..3107fc90eac 100644 --- a/docs/text/buffer-overflow.md +++ b/docs/text/buffer-overflow.md @@ -4,6 +4,7 @@ title: "Buffer Overflow" ms.date: "11/04/2016" helpviewer_keywords: ["buffers [C++], character sizes", "buffer overflows [C++]", "MBCS [C++], buffer overflow"] ms.assetid: f2b7e40a-f02b-46d8-a449-51d26fc0c663 +ms.topic: how-to --- # Buffer Overflow diff --git a/docs/text/character-assignment.md b/docs/text/character-assignment.md index 0f4e4e7a831..81eaad306a9 100644 --- a/docs/text/character-assignment.md +++ b/docs/text/character-assignment.md @@ -4,6 +4,7 @@ title: "Character Assignment" ms.date: "11/04/2016" helpviewer_keywords: ["characters [C++], assignments", "MBCS [C++], character assignments"] ms.assetid: dcc329cd-92df-4e20-817d-364be62ff28f +ms.topic: how-to --- # Character Assignment diff --git a/docs/text/character-comparison.md b/docs/text/character-comparison.md index e7b4890efaf..b03f26e4cc6 100644 --- a/docs/text/character-comparison.md +++ b/docs/text/character-comparison.md @@ -4,6 +4,7 @@ title: "Character Comparison" ms.date: "11/04/2016" helpviewer_keywords: ["comparing characters", "MBCS [C++], character comparison", "characters [C++], comparing"] ms.assetid: 18846e44-3e6e-40c4-9b42-3153fb15db20 +ms.topic: how-to --- # Character Comparison diff --git a/docs/text/incrementing-and-decrementing-pointers.md b/docs/text/incrementing-and-decrementing-pointers.md index 932ef317088..9958d4e81ab 100644 --- a/docs/text/incrementing-and-decrementing-pointers.md +++ b/docs/text/incrementing-and-decrementing-pointers.md @@ -4,6 +4,7 @@ title: "Incrementing and Decrementing Pointers" ms.date: "11/04/2016" helpviewer_keywords: ["incrementing pointers", "MBCS [C++], pointers", "pointers [C++], multibyte characters", "decrementing pointers"] ms.assetid: 0872b4a0-e2bd-4004-8319-070efb76f2fd +ms.topic: concept-article --- # Incrementing and Decrementing Pointers diff --git a/docs/text/last-character-in-a-string.md b/docs/text/last-character-in-a-string.md index bb58c45d55b..f0cb71ec368 100644 --- a/docs/text/last-character-in-a-string.md +++ b/docs/text/last-character-in-a-string.md @@ -4,6 +4,7 @@ title: "Last Character in a String" ms.date: "11/04/2016" helpviewer_keywords: ["last character in string", "MBCS [C++], last character in string"] ms.assetid: 0a180376-4e55-41e8-9c64-539c7b6d8047 +ms.topic: how-to --- # Last Character in a String diff --git a/docs/text/using-tchar-h-data-types-with-mbcs-code.md b/docs/text/using-tchar-h-data-types-with-mbcs-code.md index d9d216041f9..c800f793487 100644 --- a/docs/text/using-tchar-h-data-types-with-mbcs-code.md +++ b/docs/text/using-tchar-h-data-types-with-mbcs-code.md @@ -4,6 +4,7 @@ title: "Using TCHAR.H Data Types with _MBCS Code" ms.date: "11/04/2016" helpviewer_keywords: ["mapping generic-text", "generic-text data types [C++]", "generic-text mappings [C++]", "MBCS [C++], generic-text mappings", "TCHAR.H data types, mapping", "mappings [C++], TCHAR.H"] ms.assetid: 298583c5-22c3-40f6-920e-9ec96d42abd8 +ms.topic: concept-article --- # Using TCHAR.H Data Types with _MBCS Code diff --git a/docs/windows/adding-editing-or-deleting-controls.md b/docs/windows/adding-editing-or-deleting-controls.md index 92993bd1f9e..11e5400f7d9 100644 --- a/docs/windows/adding-editing-or-deleting-controls.md +++ b/docs/windows/adding-editing-or-deleting-controls.md @@ -4,6 +4,7 @@ description: "Learn more about: How To: Add, Edit, or Delete Controls (C++)" ms.date: "02/15/2019" f1_keywords: ["vc.controls.activex", "vc.editors.dialog.insertActiveXControls"] helpviewer_keywords: ["Dialog Editor [C++], creating controls", "dialog boxes [C++], adding controls to", "Toolbox [C++], Dialog Editor tab", "controls [C++], types", "syslink controls in dialog boxes", "custom controls [C++], dialog boxes", "controls [C++], standard", "Dialog Editor [C++], creating controls", "controls [C++], adding to dialog boxes", "controls [C++], adding multiple", "dialog box controls [C++], size", "controls [C++], sizing", "dialog boxes [C++], adding ActiveX controls", "ActiveX controls [C++], adding to dialog boxes", "Insert ActiveX Control dialog box [C++]", "controls [C++], editing properties", "ActiveX controls [C++], properties", "controls [C++], undoing changes", "controls [C++], editing properties", "dialog box controls [C++], editing properties", "dialog box controls [C++], deleting", "controls [C++], deleting", "Dialog Editor [C++], default control events", "controls [C++], default control events", "events [C++], controls", "dialog box controls [C++], events", "member variables, defining for controls", "variables, dialog box control member variables", "controls [C++], member variables", "Dialog Editor [C++], defining member variables for controls", "controls [C++], troubleshooting", "Dialog Editor [C++], troubleshooting", "dialog boxes [C++], troubleshooting", "InitCommonControls", "RichEdit 1.0 control", "rich edit controls [C++], RichEdit 1.0"] +ms.topic: how-to --- # How To: Add, Edit, or Delete Controls (C++) diff --git a/docs/windows/arrangement-of-controls-on-dialog-boxes.md b/docs/windows/arrangement-of-controls-on-dialog-boxes.md index 7dbf3020fed..1c2b92daa72 100644 --- a/docs/windows/arrangement-of-controls-on-dialog-boxes.md +++ b/docs/windows/arrangement-of-controls-on-dialog-boxes.md @@ -5,6 +5,7 @@ ms.date: "02/15/2019" f1_keywords: ["vc.editors.dialog.grouping", "vc.editors.dialog.combo"] helpviewer_keywords: ["controls [C++], positioning", "dialog box controls [C++], placement", "Dialog Editor [C++], arranging controls", "Dialog Editor [C++], guides and margins", "guides, clearing", "guides", "dialog box controls [C++], placement", "controls [C++], guides and margins", "guides, creating", "guides, moving", "margins, moving", "DLUs (dialog units)", "controls [C++], aligning", "Dialog Editor [C++], snap to guides", "guides, tick mark interval", "dialog box controls [C++], placement", "guides, aligning controls", "dialog units (DLUs)", "snap to guides (Dialog editor)", "controls [C++], sizing", "tick mark interval in Dialog editor", "controls [C++], snap to guides/grid", "guides, disabling snapping", "controls [C++], snap to guides/grid", "controls [C++], layout grid", "snap to layout grid", "grids, turning on or off", "layout grid in Dialog Editor", "grids, changing size", "grid spacing", "guides, settings", "layout grid in Dialog Editor", "controls [C++], snap to guides/grid", "Guide Settings dialog box (Dialog editor)", "controls [C++], aligning", "controls [C++], positioning", "Space Evenly command", "dialog box controls [C++], placement", "Center in Dialog command", "Arrange Buttons command", "buttons, arranging push buttons in dialog boxes", "push buttons", "member variables, adding to radio button groups", "variables, dialog box control member variables", "dialog box controls [C++], grouping radio buttons", "grouping controls", "radio buttons [C++], grouping on dialog boxes", "controls [C++], tab order", "focus, tab order", "tab controls [C++], tab order", "Tabstop property for controls", "controls [C++], focus", "dialog box controls [C++], tab order", "Dialog Editor [C++], selecting controls", "dominant controls", "dialog box controls [C++], selecting in editor", "controls [C++], selecting", "size, controls", "controls [C++], dominant", "controls [C++], removing from groups", "Dialog Editor [C++], dominant control", "Size to Content command", "size, controls", "text, autosizing controls to fit text", "controls [C++], sizing", "Make Same Size command", "combo boxes, sizing", "list controls [C++], scroll bar width", "CListBox::SetHorizontalExtent", "controls [C++], scroll bar", "scroll bars [C++], displaying in controls", "horizontal scroll bar width", "CListBox class, scroll bar width", "scroll bars [C++], width"] ms.assetid: 832491cf-98af-42e5-a854-2cb135fd45c6 +ms.topic: how-to --- # How To: Layout Controls (C++) diff --git a/docs/windows/changing-a-symbol-or-symbol-name-id.md b/docs/windows/changing-a-symbol-or-symbol-name-id.md index 03e9c25ca31..82376571371 100644 --- a/docs/windows/changing-a-symbol-or-symbol-name-id.md +++ b/docs/windows/changing-a-symbol-or-symbol-name-id.md @@ -5,6 +5,7 @@ ms.date: "02/14/2019" f1_keywords: ["vc.editors.symbol.changing", "vc.editors.symbol.restrictions.name", "vc.editors.symbol.changing.value", "vc.editors.symbol.restrictions.value", "vc.editors.symbol.changing.header", "vc.editors.symbol.changing.unassigned", "vc.editors.symbol.shared.calculated"] helpviewer_keywords: ["symbol names", "symbols [C++], names", "restrictions, symbol names", "numeric values", "symbols [C++], numeric values", "numeric values, changing symbols", "symbols [C++], value restrictions", "restrictions, symbol values", "resource files [C++], multiple", "Resource Includes dialog box [C++]", "symbol header files [C++], changing names", "symbols [C++], symbol header files", "Resource.h", "symbols [C++], unassigned", "Change Symbol dialog box [C++]", "unassigned symbols", "symbols [C++], deleting", "symbols [C++], read-only", "symbols [C++], shared", "symbols [C++], calculated", "read-only symbols", "symbol directives", "calculated symbols", "shared symbols"] ms.assetid: 26541832-8dba-4177-b642-e08f94502ea7 +ms.topic: how-to --- # How to: Manage Symbols diff --git a/docs/windows/creating-a-new-dialog-box.md b/docs/windows/creating-a-new-dialog-box.md index 50d344c9a50..9552cf35923 100644 --- a/docs/windows/creating-a-new-dialog-box.md +++ b/docs/windows/creating-a-new-dialog-box.md @@ -4,6 +4,7 @@ title: "How To: Create a Dialog Box (C++)" ms.date: "02/15/2019" helpviewer_keywords: ["dialog boxes [C++], creating", "Dialog Editor [C++], creating dialog boxes", "modal dialog boxes [C++], logon screens", "logon screens", "Test Dialog command", "testing, dialog boxes", "dialog boxes [C++], testing", "dialog boxes [C++], size", "dialog boxes [C++], positioning"] ms.assetid: 303de801-c4f8-42e1-b622-353f6423f688 +ms.topic: how-to --- # How to: Create a Dialog Box (C++) diff --git a/docs/windows/creating-new-symbols.md b/docs/windows/creating-new-symbols.md index 4efb0239b42..d2dbf84f17a 100644 --- a/docs/windows/creating-new-symbols.md +++ b/docs/windows/creating-new-symbols.md @@ -5,6 +5,7 @@ ms.date: "02/14/2019" f1_keywords: ["vc.editors.symbol.creating", "vc.editors.symbol.managing", "vc.editors.resourcesymbols", "vc.editors.symbol.resource"] helpviewer_keywords: ["New Symbol dialog box [C++]", "symbols [C++], creating", "resources [C++], viewing", "resource symbols", "symbols [C++], viewing", "New Symbol dialog box [C++]", "Resource Symbols dialog box [C++]", "Change Symbol dialog box [C++]", "resource symbols", "View Use button", "resource editors [C++], resource symbols"] ms.assetid: 35168d31-3af6-4ecd-9362-3707d47b53f3 +ms.topic: how-to --- # How to: Create Symbols (C++) diff --git a/docs/windows/defining-mnemonics-access-keys.md b/docs/windows/defining-mnemonics-access-keys.md index 91d85be4e50..10caf4b2797 100644 --- a/docs/windows/defining-mnemonics-access-keys.md +++ b/docs/windows/defining-mnemonics-access-keys.md @@ -4,6 +4,7 @@ title: "How to: Define Control Access and Values (C++)" ms.date: "02/15/2019" helpviewer_keywords: ["access keys [C++], adding", "keyboard shortcuts [C++], controls", "dialog box controls [C++], mnemonics", "access keys [C++], checking", "mnemonics [C++], checking for duplicate", "mnemonics", "mnemonics [C++], dialog box controls", "keyboard shortcuts [C++], uniqueness checking", "Check Mnemonics command", "controls [C++], access keys", "access keys [C++]", "combo boxes [C++], Data property", "controls [C++], testing values in combo boxes", "combo boxes [C++], adding values", "combo boxes [C++], previewing values", "Data property", "combo boxes [C++], testing values"] ms.assetid: 60a85435-aa30-4c5c-98b6-42fb045b9eb2 +ms.topic: how-to --- # How to: Define Control Access and Values (C++) diff --git a/docs/windows/deployment-concepts.md b/docs/windows/deployment-concepts.md index 659ed272bda..762b7034ca3 100644 --- a/docs/windows/deployment-concepts.md +++ b/docs/windows/deployment-concepts.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["Windows Installer [C++]", "dependencies [C++], application deployment and", "application deployment [C++], about application deployment", "deploying applications [C++], about deploying applications", "libraries [C++], application deployment issues"] ms.assetid: ebd7f246-ab54-40e8-87fa-dac02c0047b3 ms.custom: intro-deployment +ms.topic: concept-article --- # Deployment Concepts diff --git a/docs/windows/image-editor-for-icons.md b/docs/windows/image-editor-for-icons.md index bfae511890f..c292e20a11e 100644 --- a/docs/windows/image-editor-for-icons.md +++ b/docs/windows/image-editor-for-icons.md @@ -5,6 +5,7 @@ ms.date: "02/15/2019" f1_keywords: ["vc.editors.cursor.F1", "vc.editors.icon.F1", "vc.editors.cursor", "vc.editors.bitmap.F1", "vc.editors.bitmap", "vc.editors.dialog.GridSettings", "vc.editors.gridsettings", "vc.editors.icon", "vc.editors.texttool"] helpviewer_keywords: ["editors, images", "resource editors [C++], graphics", "Image editor [C++]", "resource editors [C++], Image editor", "Image menu", "Grid Settings dialog box [C++]", "Graphics toolbar", "Image editor [C++], toolbar", "Image editor [C++], Option selector", "Properties window", "Option selector, Image editor", "toolbars [C++], showing", "toolbars [C++], hiding", "text, adding to an image", "Text Tool dialog box [C++]", "Text Tool Font dialog box [C++]", "fonts, changing on an image", "text, on images", "graphics editor [C++]", "Image editor [C++], panes", "Image editor [C++], magnification", "grids, pixel", "pixel grid, Image editor", "Image editor [C++], pixel grid", "Image editor [C++], grid settings", "grid settings, Image editor"] ms.assetid: 586d2b8b-0348-4883-a85d-1ff0ddbf14dd +ms.topic: how-to --- # Image Editor for Icons (C++) diff --git a/docs/windows/redist-version-auditing.md b/docs/windows/redist-version-auditing.md index 12b325c5ac7..a457bcc5f5e 100644 --- a/docs/windows/redist-version-auditing.md +++ b/docs/windows/redist-version-auditing.md @@ -9,6 +9,7 @@ helpviewer_keywords: ] author: MahmoudGSaleh ms.author: msaleh +ms.topic: how-to --- # How to audit Visual C++ Runtime version usage diff --git a/docs/windows/redistributing-an-atl-application.md b/docs/windows/redistributing-an-atl-application.md index 05c6e985536..84bb01ef68b 100644 --- a/docs/windows/redistributing-an-atl-application.md +++ b/docs/windows/redistributing-an-atl-application.md @@ -4,6 +4,7 @@ title: "Redistributing an ATL application" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, redistributing", "redistributing ATL", "redistributing OLE DB templates", "OLE DB templates, redistributing"] ms.assetid: 9a696b22-2345-43ec-826b-be7cb8cfd676 +ms.topic: concept-article --- # Redistributing an ATL application diff --git a/docs/windows/redistributing-components-by-using-merge-modules.md b/docs/windows/redistributing-components-by-using-merge-modules.md index dc72490002f..ac04fbfd8d6 100644 --- a/docs/windows/redistributing-components-by-using-merge-modules.md +++ b/docs/windows/redistributing-components-by-using-merge-modules.md @@ -4,6 +4,7 @@ title: "Redistributing Components By Using Merge Modules" ms.date: 06/08/2022 helpviewer_keywords: ["merge modules, using", "redistributing applications, using merge modules"] ms.assetid: 93b84211-bf9b-4a78-9f22-474ac2ef7840 +ms.topic: concept-article --- # Redistributing components by using merge modules diff --git a/docs/windows/redistributing-the-mfc-library.md b/docs/windows/redistributing-the-mfc-library.md index fb9373c1daf..c01f4c38d38 100644 --- a/docs/windows/redistributing-the-mfc-library.md +++ b/docs/windows/redistributing-the-mfc-library.md @@ -4,6 +4,7 @@ title: "Redistributing the MFC Library" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, redistributing", "redistributing MFC library"] ms.assetid: 72714ce1-385e-4c1c-afa5-96b03e873866 +ms.topic: concept-article --- # Redistributing the MFC Library diff --git a/docs/windows/redistributing-visual-cpp-activex-controls.md b/docs/windows/redistributing-visual-cpp-activex-controls.md index 0ffe433d618..f28244442a2 100644 --- a/docs/windows/redistributing-visual-cpp-activex-controls.md +++ b/docs/windows/redistributing-visual-cpp-activex-controls.md @@ -4,6 +4,7 @@ title: "Redistributing Visual C++ ActiveX Controls" ms.date: "11/04/2016" helpviewer_keywords: ["controls [C++], redistributing", "controls [C++], distributing"] ms.assetid: eefbb7e4-d28c-4c35-98bf-d9540cfaae83 +ms.topic: concept-article --- # Redistributing Visual C++ ActiveX Controls diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 36e7350dce3..97ba8cbcdd9 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -3,6 +3,7 @@ title: "Redistributing Visual C++ Files" description: "Visual Studio includes Redistributable libraries and components you can deploy with your app." ms.date: 01/15/2025 helpviewer_keywords: ["application deployment [C++], file redistributing", "redistributing applications [C++]", "deploying applications [C++], file redistributing", "file redistribution [C++]", "redistributing applications [C++], about redistributing applications"] +ms.topic: concept-article --- # Redistributing Visual C++ Files diff --git a/docs/windows/redistributing-web-client-applications.md b/docs/windows/redistributing-web-client-applications.md index 88a621931a3..51ff831c9d2 100644 --- a/docs/windows/redistributing-web-client-applications.md +++ b/docs/windows/redistributing-web-client-applications.md @@ -4,6 +4,7 @@ title: "Redistributing Web Client Applications" ms.date: "11/04/2016" helpviewer_keywords: ["Web applications [C++], redistributing", "deploying applications [C++], Web applications", "Internet applications [C++], redistributing", "application deployment [C++], Web applications"] ms.assetid: fe05988b-dee8-4a46-b381-016b5103a6bf +ms.topic: concept-article --- # Redistributing Web Client Applications diff --git a/docs/windows/running-a-cpp-clr-application-on-a-previous-runtime-version.md b/docs/windows/running-a-cpp-clr-application-on-a-previous-runtime-version.md index 0a0bc61b0a7..16191ace681 100644 --- a/docs/windows/running-a-cpp-clr-application-on-a-previous-runtime-version.md +++ b/docs/windows/running-a-cpp-clr-application-on-a-previous-runtime-version.md @@ -4,6 +4,7 @@ title: "Running a C++ -clr Application on a Previous Runtime Version" ms.date: "11/04/2016" helpviewer_keywords: ["applications [C++], runtime version specified", "versions [C++]", "app.config files, runtime version specified", "compatibility [C++], runtime version specified", "backward compatibility [C++], runtime version specified", "application deployment [C++], runtime version specified", "common language runtime [C++], version specified", "deploying applications [C++], runtime version specified"] ms.assetid: 940171b7-6937-4b14-8e87-c199e23f4f2e +ms.topic: concept-article --- # Running a C++ /clr Application on a Previous Runtime Version diff --git a/docs/windows/selecting-an-area-of-an-image-image-editor-for-icons.md b/docs/windows/selecting-an-area-of-an-image-image-editor-for-icons.md index 74755f65290..5096ea44e89 100644 --- a/docs/windows/selecting-an-area-of-an-image-image-editor-for-icons.md +++ b/docs/windows/selecting-an-area-of-an-image-image-editor-for-icons.md @@ -5,6 +5,7 @@ ms.date: "02/15/2019" f1_keywords: ["vc.editors.image.editing"] helpviewer_keywords: ["Image editor [C++], image selection", "Image editor [C++], selecting images", "images [C++], selecting", "cursors [C++], selecting areas of", "Image editor [C++], editing images", "Clipboard [C++], pasting", "images [C++], editing", "images [C++], deleting selected parts", "images [C++], copying selected parts", "images [C++], moving selected parts", "images [C++], dragging and replicating selected parts", "images [C++], pasting into", "graphics [C++], editing", "Image editor [C++], flipping and rotating images", "images [C++], flipping", "images [C++], rotating", "Image editor [C++], resizing images", "graphics [C++], resizing", "images [C++], resizing", "resizing images", "size [C++], images", "images [C++], cropping", "images [C++], extending", "Image editor [C++], cropping or extending images", "Image editor [C++], shrinking and stretching images", "images [C++], stretching", "images [C++], shrinking", "bitmaps [C++], shrinking", "bitmaps [C++], stretching", "Image editor [C++], editing images", "images [C++], editing", "images [C++], properties", "Image editor [C++], Properties window", "Properties window, image editor"] ms.assetid: 8b6ce4ad-eba1-4ece-86ba-cea92c3edff2 +ms.topic: how-to --- # How to: Edit an Image diff --git a/docs/windows/string-editor.md b/docs/windows/string-editor.md index dc8745b0fad..9aef4330fc6 100644 --- a/docs/windows/string-editor.md +++ b/docs/windows/string-editor.md @@ -4,6 +4,7 @@ description: "Learn more about: String Editor (C++)" ms.date: "02/14/2019" f1_keywords: ["vc.editors.string.F1", "vc.editors.string"] helpviewer_keywords: ["String editor", "string tables", "string tables [C++], String editor", "string editing", "string editing, string tables", "resource editors [C++], String editor", "strings [C++], editing", "strings [C++], searching", "strings [C++]", "strings [C++], adding to string tables", "string tables [C++], deleting strings", "strings [C++], deleting in string tables", "string tables [C++], adding strings", "strings [C++], moving between files", "resource script files [C++], moving strings", "string editing, moving strings between resources", "String editor [C++], moving strings between files", "resource identifiers, string properties", "string tables [C++], changing strings", "strings [C++], properties", "String editor [C++], changing properties of multiple strings", "string tables [C++], changing caption of multiple strings", "special characters, adding to strings", "ASCII characters, adding to strings", "strings [C++], formatting", "strings [C++], special characters"] +ms.topic: how-to --- # String Editor (C++) diff --git a/docs/windows/understanding-the-dependencies-of-a-visual-cpp-application.md b/docs/windows/understanding-the-dependencies-of-a-visual-cpp-application.md index 223a06f1b4f..935808c0d43 100644 --- a/docs/windows/understanding-the-dependencies-of-a-visual-cpp-application.md +++ b/docs/windows/understanding-the-dependencies-of-a-visual-cpp-application.md @@ -4,6 +4,7 @@ title: "Understanding the Dependencies of a Visual C++ Application" ms.date: "11/04/2016" helpviewer_keywords: ["application deployment [C++], dependencies", "Dependency Walker", "dependencies [C++], application deployment and", "deploying applications [C++], dependencies", "DUMPBIN utility", "DLLs [C++], dependencies", "depends.exe", "libraries [C++], application deployment issues"] ms.assetid: 62a44c95-c389-4c5f-82fd-07d7ef09dbf9 +ms.topic: concept-article --- # Understanding the Dependencies of a Visual C++ Application diff --git a/docs/windows/using-a-drawing-tool-image-editor-for-icons.md b/docs/windows/using-a-drawing-tool-image-editor-for-icons.md index da9f38a7199..d4dd74f019a 100644 --- a/docs/windows/using-a-drawing-tool-image-editor-for-icons.md +++ b/docs/windows/using-a-drawing-tool-image-editor-for-icons.md @@ -5,6 +5,7 @@ ms.date: "02/15/2019" f1_keywords: ["vc.editors.image.drawing"] helpviewer_keywords: ["Image editor [C++], selecting drawing tools", "Image editor [C++], toolbar", "drawing tools", "Image editor [C++], drawing lines", "shapes, drawing", "colors [C++], brush", "brushes, colors", "brushes, creating custom", "images [C++], creating custom brushes", "graphics [C++], custom brushes", "custom brushes"] ms.assetid: 1f8c6eef-7760-45a9-a5cb-9e15c6f91245 +ms.topic: how-to --- # How to: Use a Drawing Tool diff --git a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md index 31686592dd7..5878dda4372 100644 --- a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md +++ b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md @@ -5,6 +5,7 @@ ms.date: 06/28/2022 helpviewer_keywords: ["deployment for Visual C++"] ms.assetid: 66735cda-8fe3-4211-a19a-2cf717a12a3f ms.custom: intro-deployment +ms.topic: install-set-up-deploy --- # Walkthrough: Deploy a Visual C++ application by using a setup project diff --git a/docs/windows/walkthrough-deploying-a-visual-cpp-application-to-an-application-local-folder.md b/docs/windows/walkthrough-deploying-a-visual-cpp-application-to-an-application-local-folder.md index 731fcf86370..3a419091272 100644 --- a/docs/windows/walkthrough-deploying-a-visual-cpp-application-to-an-application-local-folder.md +++ b/docs/windows/walkthrough-deploying-a-visual-cpp-application-to-an-application-local-folder.md @@ -5,6 +5,7 @@ ms.date: "04/23/2019" helpviewer_keywords: ["deploying Visual C++ applications"] ms.assetid: 47a81c47-9dbe-47c6-96cc-fbb2fda5e6ad ms.custom: intro-deployment +ms.topic: install-set-up-deploy --- # Walkthrough: Deploying a Visual C++ Application to an Application-local Folder diff --git a/docs/windows/working-with-color-image-editor-for-icons.md b/docs/windows/working-with-color-image-editor-for-icons.md index 4b3830b690b..61e61b55c10 100644 --- a/docs/windows/working-with-color-image-editor-for-icons.md +++ b/docs/windows/working-with-color-image-editor-for-icons.md @@ -5,6 +5,7 @@ ms.date: "02/15/2019" f1_keywords: ["vc.editors.image.color", "vc.editors.customcolorselector", "vc.editors.loadcolorpalette", "vc.editors.colorswindow"] helpviewer_keywords: ["images [C++], background colors", "Image editor [C++], Colors Palette", "colors [C++], image", "Colors Palette, Image editor", "palettes, Image editor colors", "foreground colors [C++], Image editor", "colors [C++]", "Image editor [C++], colors", "colors [C++], Image editor", "colors [C++], image", "images [C++], colors", "Image editor [C++], colors", "Fill tool", "colors [C++], image", "images [C++], colors", "colors [C++], selection tools", "Image editor [C++], colors", "Select Color tool", "dithered color, Image editor", "Custom Color Selector dialog box [C++]", "Image editor [C++], Colors Palette", "colors [C++], image", "bitmaps [C++], colors", "images [C++], colors", "HSL values", "Colors Palette, Image editor", "RGB color values", "Adjust Colors command [C++]", "Image editor [C++], dithered color", "Image editor [C++], Colors Palette", "Colors Palette, Image editor", "colors [C++], inverting", "colors [C++]", "Color Indicator", "colors [C++], Colors window", "Colors window, hiding colors", "Show Colors Window command", "Colors window, displaying colors", "color palettes [C++]", "palettes", "palettes, Image editor", "colors [C++], Image editor", "Image editor [C++], palettes", "color palettes", "Load Palette Colors dialog box [C++]", "opaque backgrounds [C++]", "colors [C++], image", "Image editor [C++], transparent or opague backgrounds", "images [C++], transparency", "images [C++], opaque background", "colors [C++], image", "Image editor [C++], color inversion", "images [C++], colors", "colors [C++], inverting"] ms.assetid: d34ff96f-241d-494f-abdd-13811ada8cd3 +ms.topic: how-to --- # How to: Work with Color diff --git a/docs/windows/working-with-resource-files.md b/docs/windows/working-with-resource-files.md index 6e2944a42cf..13fbb17f8cb 100644 --- a/docs/windows/working-with-resource-files.md +++ b/docs/windows/working-with-resource-files.md @@ -3,6 +3,7 @@ description: "Learn more about: Working with Resource Files" title: "Working with Resource Files (C++)" ms.date: "02/14/2019" helpviewer_keywords: ["resources [C++], about resources", "resources [C++], about resource files", "resource files [C++], about resource files"] +ms.topic: concept-article --- # Working with Resource Files From 0c67ffbf85660385a182d6224b9fab7645583f7b Mon Sep 17 00:00:00 2001 From: Kevin Puetz Date: Thu, 19 Jun 2025 17:46:45 -0500 Subject: [PATCH 0114/1799] Fix documentation of __STDC__ (#5431) * Fix documentation of __STDC__ getting `__STDC__=1` requires setting `/Za` or `/Zc:__STDC__`. It doesn't seem to matter whether/what `/std` is set to. * Update predefined-macros.md update date since content fixed --------- Co-authored-by: Tyler Whitney --- docs/preprocessor/predefined-macros.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index 40cceea5151..1694c9d5af8 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -2,7 +2,7 @@ title: "Predefined macros" description: "Lists and describes the Microsoft C++ compiler predefined preprocessor macros." ms.custom: "update_every_version" -ms.date: 06/11/2024 +ms.date: 06/18/2025 f1_keywords: ["__ARM_ARCH", "_ATL_VER", "__ATOM__", "__AVX__", "__AVX2__", "__AVX512BW__", "__AVX512CD__", "__AVX512DQ__", "__AVX512F__", "__AVX512VL__", "_CHAR_UNSIGNED", "__CLR_VER", "_CONTROL_FLOW_GUARD", "__COUNTER__", "__cplusplus", "__cplusplus_cli", "__cplusplus_winrt", "_CPPRTTI", "_CPPUNWIND", "__DATE__", "_DEBUG", "_DLL", "__FILE__", "__FUNCDNAME__", "__FUNCSIG__", "__FUNCTION__", "_INTEGRAL_MAX_BITS", "_ISO_VOLATILE", "_KERNEL_MODE", "__LINE__", "_M_AMD64", "_M_ARM", "_M_ARM_ARMV7VE", "_M_ARM_FP", "_M_ARM64", "_M_CEE", "_M_CEE_PURE", "_M_CEE_SAFE", "_M_FP_EXCEPT", "_M_FP_FAST", "_M_FP_PRECISE", "_M_FP_STRICT", "_M_IX86", "_M_IX86_FP", "_M_X64", "_MANAGED", "_MFC_VER", "_MSC_BUILD", "_MSC_EXTENSIONS", "_MSC_FULL_VER", "_MSC_VER", "_MSVC_LANG", "__MSVC_RUNTIME_CHECKS", "_MT", "_NATIVE_WCHAR_T_DEFINED", "_NO_SIZED_DEALLOCATION", "_OPENMP", "_PREFAST_", "_RESUMABLE_FUNCTIONS_SUPPORTED", "_RTC_CONVERSION_CHECKS_ENABLED", "__SANITIZE_ADDRESS__", "__STDC__", "__STDC_HOSTED__", "__STDC_NO_ATOMICS__", "__STDC_NO_COMPLEX__", "__STDC_NO_THREADS__", "__STDC_NO_VLA__", "__STDC_VERSION__", "__STDCPP_DEFAULT_NEW_ALIGNMENT__", "__STDCPP_THREADS__", "__TIME__", "__TIMESTAMP__", "__VA_ARGS__", "_VC_NODEFAULTLIB", "_WCHAR_T_DEFINED", "_WIN32", "_WIN64", "_WINRT_DLL"] helpviewer_keywords: ["__ARM_ARCH macro", "timestamps, preprocessor macro", "cl.exe compiler, version number", "version numbers, C/C++ compiler (cl.exe)", "macros, predefined C++", "preprocessor, macros", "predefined macros", "_ATL_VER macro", "__ATOM__ macro", "__AVX__ macro", "__AVX2__ macro", "__AVX512BW__ macro", "__AVX512CD__ macro", "__AVX512DQ__ macro", "__AVX512F__ macro", "__AVX512VL__ macro", "_CHAR_UNSIGNED macro", "__CLR_VER macro", "_CONTROL_FLOW_GUARD macro", "__COUNTER__ macro", "__cplusplus macro", "__cplusplus_cli macro", "__cplusplus_winrt macro", "_CPPRTTI macro", "_CPPUNWIND macro", "__DATE__ macro", "_DEBUG macro", "_DLL macro", "__FILE__ macro", "__FUNCDNAME__ macro", "__FUNCSIG__ macro", "__FUNCTION__ macro", "_INTEGRAL_MAX_BITS macro", "_ISO_VOLATILE macro", "_KERNEL_MODE macro", "__LINE__ macro", "_M_AMD64 macro", "_M_ARM macro", "_M_ARM_ARMV7VE macro", "_M_ARM_FP macro", "_M_ARM64 macro", "_M_ARM64EC macro", "_M_CEE macro", "_M_CEE_PURE macro", "_M_CEE_SAFE macro", "_M_FP_EXCEPT macro", "_M_FP_FAST macro", "_M_FP_PRECISE macro", "_M_FP_STRICT macro", "_M_IX86 macro", "_M_IX86_FP macro", "_M_X64 macro", "_MANAGED macro", "_MFC_VER macro", "_MSC_BUILD macro", "_MSC_EXTENSIONS macro", "_MSC_FULL_VER macro", "_MSC_VER macro", "_MSVC_LANG macro", "__MSVC_RUNTIME_CHECKS macro", "_MT macro", "_NATIVE_WCHAR_T_DEFINED macro", "_NO_SIZED_DEALLOCATION macro", "_OPENMP macro", "_PREFAST_ macro", "_RESUMABLE_FUNCTIONS_SUPPORTED macro", "_RTC_CONVERSION_CHECKS_ENABLED macro", "__SANITIZE_ADDRESS__ macro", "__STDC__ macro", "__STDC_HOSTED__ macro", "__STDC_NO_ATOMICS__ macro", "__STDC_NO_COMPLEX__ macro", "__STDC_NO_THREADS__ macro", "__STDC_NO_VLA__ macro", "__STDC_VERSION__ macro", "__STDCPP_DEFAULT_NEW_ALIGNMENT__", "__STDCPP_THREADS__ macro", "__TIME__ macro", "__TIMESTAMP__ macro", "__VA_ARGS__ macro", "_VC_NODEFAULTLIB macro", "_WCHAR_T_DEFINED macro", "_WIN32 macro", "_WIN64 macro", "_WINRT_DLL macro", "__func__ identifier"] ms.assetid: 1cc5f70a-a225-469c-aed0-fe766238e23f @@ -41,7 +41,7 @@ The compiler supports these predefined macros specified by the ISO C99, C11, C17 - `__LINE__` Defined as the integer line number in the current source file. The value of this macro can be changed by using a `#line` directive. The integral type of the value of `__LINE__` can vary depending on context. This macro is always defined. -- `__STDC__` Defined as 1 when compiled as C and if the [`/Za`](../build/reference/za-ze-disable-language-extensions.md) compiler option is specified. Starting in Visual Studio 2022 version 17.2, it's defined as 1 when compiled as C and if the [`/std:c11`](../build/reference/std-specify-language-standard-version.md) or [`/std:c17`](../build/reference/std-specify-language-standard-version.md) compiler option is specified. Otherwise, undefined. +- `__STDC__` Defined as 1 when compiled as C and if the [`/Za`](../build/reference/za-ze-disable-language-extensions.md) compiler option is specified. Starting in Visual Studio 2022 version 17.2, it's defined as 1 when compiled as C and if the [`/Zc:__STDC__`](../build/reference/zc-stdc.md) compiler option is specified. Otherwise, undefined. - `__STDC_HOSTED__` Defined as 1 if the implementation is a *hosted implementation*, one that supports the entire required standard library. Otherwise, defined as 0. From 7b9249946ca2dcfd2d40d1f2b0829f33686ce906 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 16:08:34 +0800 Subject: [PATCH 0115/1799] Add backticks in reference for `Relog` and variants --- .../reference/sdk/functions/relog-a.md | 12 ++++---- .../reference/sdk/functions/relog-w.md | 12 ++++---- .../reference/sdk/functions/relog.md | 30 +++++++++---------- 3 files changed, 27 insertions(+), 27 deletions(-) diff --git a/docs/build-insights/reference/sdk/functions/relog-a.md b/docs/build-insights/reference/sdk/functions/relog-a.md index ca57d0fdb68..d2cf476c9d0 100644 --- a/docs/build-insights/reference/sdk/functions/relog-a.md +++ b/docs/build-insights/reference/sdk/functions/relog-a.md @@ -4,7 +4,7 @@ description: "The C++ Build Insights SDK RelogA function reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RelogA", "throughput analysis", "build time analysis", "vcperf.exe"] --- -# RelogA +# `RelogA` ::: moniker range="<=msvc-140" @@ -26,17 +26,17 @@ enum RESULT_CODE RelogA( ### Parameters -*inputLogFile*\ +*`inputLogFile`*\ The input ETW trace that you wish to read events from. -*outputLogFile*\ +*`outputLogFile`*\ The file in which to write the new events. -*relogDescriptor*\ -Pointer to a [RELOG_DESCRIPTOR](../other-types/relog-descriptor-struct.md) object. Use this object to configure the relogging session. +*`relogDescriptor`*\ +Pointer to a [`RELOG_DESCRIPTOR`](../other-types/relog-descriptor-struct.md) object. Use this object to configure the relogging session. ### Return Value -A result code from the [RESULT_CODE](../other-types/result-code-enum.md) enum. +A result code from the [`RESULT_CODE`](../other-types/result-code-enum.md) enum. ::: moniker-end diff --git a/docs/build-insights/reference/sdk/functions/relog-w.md b/docs/build-insights/reference/sdk/functions/relog-w.md index c4ed0ad3d9b..6b3430a793c 100644 --- a/docs/build-insights/reference/sdk/functions/relog-w.md +++ b/docs/build-insights/reference/sdk/functions/relog-w.md @@ -4,7 +4,7 @@ description: "The C++ Build Insights SDK RelogW function reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RelogW", "throughput analysis", "build time analysis", "vcperf.exe"] --- -# RelogW +# `RelogW` ::: moniker range="<=msvc-140" @@ -26,17 +26,17 @@ enum RESULT_CODE RelogW( ### Parameters -*inputLogFile*\ +*`inputLogFile`*\ The input ETW trace that you wish to read events from. -*outputLogFile*\ +*`outputLogFile`*\ The file in which to write the new events. -*relogDescriptor*\ -Pointer to a [RELOG_DESCRIPTOR](../other-types/relog-descriptor-struct.md) object. Use this object to configure the relogging session. +*`relogDescriptor`*\ +Pointer to a [`RELOG_DESCRIPTOR`](../other-types/relog-descriptor-struct.md) object. Use this object to configure the relogging session. ### Return Value -A result code from the [RESULT_CODE](../other-types/result-code-enum.md) enum. +A result code from the [`RESULT_CODE`](../other-types/result-code-enum.md) enum. ::: moniker-end diff --git a/docs/build-insights/reference/sdk/functions/relog.md b/docs/build-insights/reference/sdk/functions/relog.md index 13259b2978b..3340f8cd93d 100644 --- a/docs/build-insights/reference/sdk/functions/relog.md +++ b/docs/build-insights/reference/sdk/functions/relog.md @@ -4,7 +4,7 @@ description: "The C++ Build Insights SDK Relog function reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "Relog", "throughput analysis", "build time analysis", "vcperf.exe"] --- -# Relog +# `Relog` ::: moniker range="<=msvc-140" @@ -43,39 +43,39 @@ RESULT_CODE Relog( ### Parameters -*TAnalyzerGroupMembers*\ +*`TAnalyzerGroupMembers`*\ This parameter is always deduced. -*TReloggerGroupMembers*\ +*`TReloggerGroupMembers`*\ This parameter is always deduced. -*inputLogFile*\ +*`inputLogFile`*\ The input ETW trace that you wish to read events from. -*outputLogFile*\ +*`outputLogFile`*\ The file in which to write the new events. -*numberOfAnalysisPasses*\ +*`numberOfAnalysisPasses`*\ The number of analysis passes to run on the input trace. The trace gets passed through the provided analyzer group once per analysis pass. -*systemEventsRetentionFlags*\ -A bitmask that specifies which system ETW events to keep in the relogged trace. For more information, see [RELOG_RETENTION_SYSTEM_EVENT_FLAGS](../other-types/relog-retention-system-event-flags-constants.md). +*`systemEventsRetentionFlags`*\ +A bitmask that specifies which system ETW events to keep in the relogged trace. For more information, see [`RELOG_RETENTION_SYSTEM_EVENT_FLAGS`](../other-types/relog-retention-system-event-flags-constants.md). -*analyzerGroup*\ -The analyzer group used for the analysis phase of the relogging session. Call [MakeStaticAnalyzerGroup](make-static-analyzer-group.md) to create an analyzer group. To use a dynamic analyzer group obtained from [MakeDynamicAnalyzerGroup](make-dynamic-analyzer-group.md), first encapsulate it inside a static analyzer group by passing its address to `MakeStaticAnalyzerGroup`. +*`analyzerGroup`*\ +The analyzer group used for the analysis phase of the relogging session. Call [`MakeStaticAnalyzerGroup`](make-static-analyzer-group.md) to create an analyzer group. To use a dynamic analyzer group obtained from [`MakeDynamicAnalyzerGroup`](make-dynamic-analyzer-group.md), first encapsulate it inside a static analyzer group by passing its address to `MakeStaticAnalyzerGroup`. -*reloggerGroup*\ -The relogger group that relogs events into the trace file specified in *outputLogFile*. Call [MakeStaticReloggerGroup](make-static-relogger-group.md) to create a relogger group. To use a dynamic relogger group obtained from [MakeDynamicReloggerGroup](make-dynamic-relogger-group.md), first encapsulate it inside a static relogger group by passing its address to `MakeStaticReloggerGroup`. +*`reloggerGroup`*\ +The relogger group that relogs events into the trace file specified in *`outputLogFile`*. Call [`MakeStaticReloggerGroup`](make-static-relogger-group.md) to create a relogger group. To use a dynamic relogger group obtained from [`MakeDynamicReloggerGroup`](make-dynamic-relogger-group.md), first encapsulate it inside a static relogger group by passing its address to `MakeStaticReloggerGroup`. ### Return Value -A result code from the [RESULT_CODE](../other-types/result-code-enum.md) enum. +A result code from the [`RESULT_CODE`](../other-types/result-code-enum.md) enum. ### Remark -The input trace is passed through the analyzer group *numberOfAnalysisPasses* times. There's no similar option for relogging passes. The trace is passed trough the relogger group only once, after all analysis passes are complete. +The input trace is passed through the analyzer group *`numberOfAnalysisPasses`* times. There's no similar option for relogging passes. The trace is passed trough the relogger group only once, after all analysis passes are complete. -The relogging of system events like CPU samples from within a relogger class isn't supported. Use the *systemEventsRetentionFlags* parameter to decide which system events to keep in the output trace. +The relogging of system events like CPU samples from within a relogger class isn't supported. Use the *`systemEventsRetentionFlags`* parameter to decide which system events to keep in the output trace. The `relog` function depends on the COM API. You must call `CoInitialize` before you call `relog`. Call `CoUninitialize` once `relog` has finished. If you call `relog` without a call to `CoInitialize` first, you'll get error code 9 (`RESULT_CODE_FAILURE_START_RELOGGER`). From 7d0999b32e53f14a466f8b4282d0b78eccf40c4e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 16:10:58 +0800 Subject: [PATCH 0116/1799] Add "s" to "Remark" heading in `Relog` reference --- docs/build-insights/reference/sdk/functions/relog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/reference/sdk/functions/relog.md b/docs/build-insights/reference/sdk/functions/relog.md index 3340f8cd93d..a198e3bf6ea 100644 --- a/docs/build-insights/reference/sdk/functions/relog.md +++ b/docs/build-insights/reference/sdk/functions/relog.md @@ -71,7 +71,7 @@ The relogger group that relogs events into the trace file specified in *`outputL A result code from the [`RESULT_CODE`](../other-types/result-code-enum.md) enum. -### Remark +### Remarks The input trace is passed through the analyzer group *`numberOfAnalysisPasses`* times. There's no similar option for relogging passes. The trace is passed trough the relogger group only once, after all analysis passes are complete. From 6a2daff4a87ee802703893269100149c72ae1236 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 16:18:01 +0800 Subject: [PATCH 0117/1799] Create new "Template parameters" section in `Relog` reference --- docs/build-insights/reference/sdk/functions/relog.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/build-insights/reference/sdk/functions/relog.md b/docs/build-insights/reference/sdk/functions/relog.md index a198e3bf6ea..cdb862ad348 100644 --- a/docs/build-insights/reference/sdk/functions/relog.md +++ b/docs/build-insights/reference/sdk/functions/relog.md @@ -41,7 +41,7 @@ RESULT_CODE Relog( StaticReloggerGroup reloggerGroup); ``` -### Parameters +### Template parameters *`TAnalyzerGroupMembers`*\ This parameter is always deduced. @@ -49,6 +49,8 @@ This parameter is always deduced. *`TReloggerGroupMembers`*\ This parameter is always deduced. +### Parameters + *`inputLogFile`*\ The input ETW trace that you wish to read events from. From 3a7d6baf70325c1d9129dc74f19f4c86b2fbe5b3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 16:20:33 +0800 Subject: [PATCH 0118/1799] Tighten wording for `TAnalyzerGroupMembers` and `TReloggerGroupMembers` in `Relog` reference --- docs/build-insights/reference/sdk/functions/relog.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build-insights/reference/sdk/functions/relog.md b/docs/build-insights/reference/sdk/functions/relog.md index cdb862ad348..c48ea76960f 100644 --- a/docs/build-insights/reference/sdk/functions/relog.md +++ b/docs/build-insights/reference/sdk/functions/relog.md @@ -44,10 +44,10 @@ RESULT_CODE Relog( ### Template parameters *`TAnalyzerGroupMembers`*\ -This parameter is always deduced. +This template parameter pack is always deduced. *`TReloggerGroupMembers`*\ -This parameter is always deduced. +This template parameter pack is always deduced. ### Parameters From 6a2827aadf1332134cde7f3d8d23070278f0dba1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 16:25:26 +0800 Subject: [PATCH 0119/1799] Add links for `CoInitialize` and `CoUninitialize` in `Relog` reference --- docs/build-insights/reference/sdk/functions/relog.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/reference/sdk/functions/relog.md b/docs/build-insights/reference/sdk/functions/relog.md index c48ea76960f..c125343a7e9 100644 --- a/docs/build-insights/reference/sdk/functions/relog.md +++ b/docs/build-insights/reference/sdk/functions/relog.md @@ -79,6 +79,6 @@ The input trace is passed through the analyzer group *`numberOfAnalysisPasses`* The relogging of system events like CPU samples from within a relogger class isn't supported. Use the *`systemEventsRetentionFlags`* parameter to decide which system events to keep in the output trace. -The `relog` function depends on the COM API. You must call `CoInitialize` before you call `relog`. Call `CoUninitialize` once `relog` has finished. If you call `relog` without a call to `CoInitialize` first, you'll get error code 9 (`RESULT_CODE_FAILURE_START_RELOGGER`). +The `relog` function depends on the COM API. You must call [`CoInitialize`](/windows/win32/api/objbase/nf-objbase-coinitialize) before you call `relog`. Call [`CoUninitialize`](/windows/win32/api/combaseapi/nf-combaseapi-couninitialize) once `relog` has finished. If you call `relog` without a call to `CoInitialize` first, you'll get error code 9 (`RESULT_CODE_FAILURE_START_RELOGGER`). ::: moniker-end From 97dcde0471e12476d63c69d89374f0ca0744d7b7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 16:27:49 +0800 Subject: [PATCH 0120/1799] Remove double quotes for `ms.date` in reference for `Relog` and variants --- docs/build-insights/reference/sdk/functions/relog-a.md | 2 +- docs/build-insights/reference/sdk/functions/relog-w.md | 2 +- docs/build-insights/reference/sdk/functions/relog.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/build-insights/reference/sdk/functions/relog-a.md b/docs/build-insights/reference/sdk/functions/relog-a.md index d2cf476c9d0..36ec0048ec6 100644 --- a/docs/build-insights/reference/sdk/functions/relog-a.md +++ b/docs/build-insights/reference/sdk/functions/relog-a.md @@ -1,7 +1,7 @@ --- title: "RelogA" description: "The C++ Build Insights SDK RelogA function reference." -ms.date: "02/12/2020" +ms.date: 02/12/2020 helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RelogA", "throughput analysis", "build time analysis", "vcperf.exe"] --- # `RelogA` diff --git a/docs/build-insights/reference/sdk/functions/relog-w.md b/docs/build-insights/reference/sdk/functions/relog-w.md index 6b3430a793c..d042d6ce853 100644 --- a/docs/build-insights/reference/sdk/functions/relog-w.md +++ b/docs/build-insights/reference/sdk/functions/relog-w.md @@ -1,7 +1,7 @@ --- title: "RelogW" description: "The C++ Build Insights SDK RelogW function reference." -ms.date: "02/12/2020" +ms.date: 02/12/2020 helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RelogW", "throughput analysis", "build time analysis", "vcperf.exe"] --- # `RelogW` diff --git a/docs/build-insights/reference/sdk/functions/relog.md b/docs/build-insights/reference/sdk/functions/relog.md index c125343a7e9..4bf0bb1dcee 100644 --- a/docs/build-insights/reference/sdk/functions/relog.md +++ b/docs/build-insights/reference/sdk/functions/relog.md @@ -1,7 +1,7 @@ --- title: "Relog" description: "The C++ Build Insights SDK Relog function reference." -ms.date: "02/12/2020" +ms.date: 02/12/2020 helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "Relog", "throughput analysis", "build time analysis", "vcperf.exe"] --- # `Relog` From dd35bfac49fe658b7da40db6fcc90f941683bc34 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 16:43:30 +0800 Subject: [PATCH 0121/1799] Resolve wrong `stl::less` in "Collections (C++/CX)" --- docs/cppcx/collections-c-cx.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cppcx/collections-c-cx.md b/docs/cppcx/collections-c-cx.md index 3d3caad9936..6ccdc33c3d6 100644 --- a/docs/cppcx/collections-c-cx.md +++ b/docs/cppcx/collections-c-cx.md @@ -86,7 +86,7 @@ In general, for internal map functionality, prefer the `std::map` type for perfo ## Value types in Map -Elements in a [Platform::Collections::Map](../cppcx/platform-collections-map-class.md) are ordered. Any element to be stored in a `Map` must support less-than comparison with strict weak ordering, either implicitly or by using a custom [stl::less](../standard-library/less-struct.md) comparator that you provide. Scalar types support the comparison implicitly. For non-scalar value types such as `Windows::Foundation::DateTime`, or for custom comparisons—for example, `objA->UniqueID < objB->UniqueID`—you must provide a custom comparator. +Elements in a [Platform::Collections::Map](../cppcx/platform-collections-map-class.md) are ordered. Any element to be stored in a `Map` must support less-than comparison with strict weak ordering, either implicitly or by using a custom [std::less](../standard-library/less-struct.md) comparator that you provide. Scalar types support the comparison implicitly. For non-scalar value types such as `Windows::Foundation::DateTime`, or for custom comparisons—for example, `objA->UniqueID < objB->UniqueID`—you must provide a custom comparator. ## Collection types From 5e1171bffd6307fb9887e1ee3f0d09e81c9f24b4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 17:00:43 +0800 Subject: [PATCH 0122/1799] Add backticks in "Collections (C++/CX)" --- docs/cppcx/collections-c-cx.md | 60 +++++++++++++++++----------------- 1 file changed, 30 insertions(+), 30 deletions(-) diff --git a/docs/cppcx/collections-c-cx.md b/docs/cppcx/collections-c-cx.md index 6ccdc33c3d6..83dc53bece7 100644 --- a/docs/cppcx/collections-c-cx.md +++ b/docs/cppcx/collections-c-cx.md @@ -11,31 +11,31 @@ The Windows Runtime defines the interfaces for collections and related types, an ![Diagram of C plus plus C X inheritance tree for collection types.](../cppcx/media/cppcxcollectionsinheritancetree.png) -- The [Platform::Collections::Vector class](../cppcx/platform-collections-vector-class.md) resembles the [std::vector class](../standard-library/vector-class.md). +- The [`Platform::Collections::Vector` class](../cppcx/platform-collections-vector-class.md) resembles the [`std::vector` class](../standard-library/vector-class.md). -- The [Platform::Collections::Map class](../cppcx/platform-collections-map-class.md) resembles the [std::map class](../standard-library/map-class.md). +- The [`Platform::Collections::Map` class](../cppcx/platform-collections-map-class.md) resembles the [`std::map` class](../standard-library/map-class.md). -- [Platform::Collections::VectorView class](../cppcx/platform-collections-vectorview-class.md) and [Platform::Collections::MapView class](../cppcx/platform-collections-mapview-class.md) are read-only versions of `Vector` and `Map`. +- [`Platform::Collections::VectorView` class](../cppcx/platform-collections-vectorview-class.md) and [`Platform::Collections::MapView` class](../cppcx/platform-collections-mapview-class.md) are read-only versions of `Vector` and `Map`. -- Iterators are defined in the [Platform::Collections Namespace](../cppcx/platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [std::find](../standard-library/algorithm-functions.md#find), [std::count_if](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [Windows::Foundation::Collections](/uwp/api/windows.foundation.collections) interface type or [Platform::Collections](../cppcx/platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. +- Iterators are defined in the [`Platform::Collections` Namespace](../cppcx/platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [`std::find`](../standard-library/algorithm-functions.md#find), [`std::count_if`](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [`Windows::Foundation::Collections`](/uwp/api/windows.foundation.collections) interface type or [`Platform::Collections`](../cppcx/platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. > [!IMPORTANT] > Proxy iterators `VectorIterator` and `VectorViewIterator` utilize proxy objects `VectoryProxy` and `ArrowProxy` to enable usage with STL containers. For more information, see "VectorProxy elements" later in this article. - The C++/CX collection types support the same thread safety guarantees that STL containers support. -- [Windows::Foundation::Collections::IObservableVector](/uwp/api/windows.foundation.collections.iobservablevector-1) and [Windows::Foundation::Collections::IObservableMap](/uwp/api/windows.foundation.collections.iobservablemap-2) define events that are fired when the collection changes in various ways. By implementing these interfaces, [Platform::Collections::Map](../cppcx/platform-collections-map-class.md) and [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) support databinding with XAML collections. For example, if you have a `Vector` that is data-bound to a `Grid`, when you add an item to a collection, the change is reflected in the Grid UI. +- [`Windows::Foundation::Collections::IObservableVector`](/uwp/api/windows.foundation.collections.iobservablevector-1) and [`Windows::Foundation::Collections::IObservableMap`](/uwp/api/windows.foundation.collections.iobservablemap-2) define events that are fired when the collection changes in various ways. By implementing these interfaces, [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md) and [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) support databinding with XAML collections. For example, if you have a `Vector` that is data-bound to a `Grid`, when you add an item to a collection, the change is reflected in the Grid UI. ## Vector usage -When your class has to pass a sequence container to another Windows Runtime component, use [Windows::Foundation::Collections:: IVector\](/uwp/api/windows.foundation.collections.ivector-1) as the parameter or return type, and [Platform::Collections::Vector\](../cppcx/platform-collections-vector-class.md) as the concrete implementation. If you attempt to use a `Vector` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Vector` to an `IVector`. +When your class has to pass a sequence container to another Windows Runtime component, use [`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1) as the parameter or return type, and [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) as the concrete implementation. If you attempt to use a `Vector` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Vector` to an `IVector`. > [!IMPORTANT] > If you are passing a sequence within your own program, then use either `Vector` or `std::vector` because they are more efficient than `IVector`. Use `IVector` only when you pass the container across the ABI. > > The Windows Runtime type system does not support the concept of jagged arrays and therefore you cannot pass an `IVector>` as a return value or method parameter. To pass a jagged array or a sequence of sequences across the ABI, use `IVector^>`. -`Vector` provides the methods that are required for adding, removing, and accessing items in the collection, and it is implicitly convertible to `IVector`. You can also use STL algorithms on instances of `Vector`. The following example demonstrates some basic usage. The [begin function](../cppcx/begin-function.md) and [end function](../cppcx/end-function.md) here are from the `Platform::Collections` namespace, not the `std` namespace. +`Vector` provides the methods that are required for adding, removing, and accessing items in the collection, and it is implicitly convertible to `IVector`. You can also use STL algorithms on instances of `Vector`. The following example demonstrates some basic usage. The [`begin` function](../cppcx/begin-function.md) and [`end` function](../cppcx/end-function.md) here are from the `Platform::Collections` namespace, not the `std` namespace. [!code-cpp[cx_collections#01](../cppcx/codesnippet/CPP/collections/class1.cpp#01)] @@ -47,11 +47,11 @@ If you have a vector of strings that you must pass across the ABI at some future ## Value types in Vector -Any element to be stored in a [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) must support equality comparison, either implicitly or by using a custom [std::equal_to](../standard-library/equal-to-struct.md) comparator that you provide. All reference types and all scalar types implicitly support equality comparisons. For non-scalar value types such as [Windows::Foundation::DateTime](/uwp/api/windows.foundation.datetime), or for custom comparisons—for example, `objA->UniqueID == objB->UniqueID`—you must provide a custom function object. +Any element to be stored in a [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) must support equality comparison, either implicitly or by using a custom [`std::equal_to`](../standard-library/equal-to-struct.md) comparator that you provide. All reference types and all scalar types implicitly support equality comparisons. For non-scalar value types such as [`Windows::Foundation::DateTime`](/uwp/api/windows.foundation.datetime), or for custom comparisons—for example, `objA->UniqueID == objB->UniqueID`—you must provide a custom function object. ## VectorProxy elements -[Platform::Collections::VectorIterator](../cppcx/platform-collections-vectoriterator-class.md) and [Platform::Collections::VectorViewIterator](../cppcx/platform-collections-vectorviewiterator-class.md) enable the use of `range for` loops and algorithms like [std::sort](../standard-library/algorithm-functions.md#sort) with an [IVector\](/uwp/api/windows.foundation.collections.ivector-1) container. But `IVector` elements cannot be accessed through C++ pointer dereference; they can be accessed only through [GetAt](/uwp/api/windows.foundation.collections.ivector-1.getat) and [SetAt](/uwp/api/windows.foundation.collections.ivector-1.setat) methods. Therefore, these iterators use the proxy classes `Platform::Details::VectorProxy` and `Platform::Details::ArrowProxy` to provide access to the individual elements through __\*__, __->__, and __\[]__ operators, as required by the Standard Library. Strictly speaking, given an `IVector vec`, the type of `*begin(vec)` is `VectorProxy`. However, the proxy object is almost always transparent to your code. These proxy objects are not documented because they are only for internal use by the iterators, but it is useful to know how the mechanism works. +[`Platform::Collections::VectorIterator`](../cppcx/platform-collections-vectoriterator-class.md) and [`Platform::Collections::VectorViewIterator`](../cppcx/platform-collections-vectorviewiterator-class.md) enable the use of `range for` loops and algorithms like [`std::sort`](../standard-library/algorithm-functions.md#sort) with an [`IVector`](/uwp/api/windows.foundation.collections.ivector-1) container. But `IVector` elements cannot be accessed through C++ pointer dereference; they can be accessed only through [`GetAt`](/uwp/api/windows.foundation.collections.ivector-1.getat) and [`SetAt`](/uwp/api/windows.foundation.collections.ivector-1.setat) methods. Therefore, these iterators use the proxy classes `Platform::Details::VectorProxy` and `Platform::Details::ArrowProxy` to provide access to the individual elements through **`*`**, **`->`**, and **`[]`** operators, as required by the Standard Library. Strictly speaking, given an `IVector vec`, the type of `*begin(vec)` is `VectorProxy`. However, the proxy object is almost always transparent to your code. These proxy objects are not documented because they are only for internal use by the iterators, but it is useful to know how the mechanism works. When you use a range-based **`for`** loop over `IVector` containers, use `auto&&` to enable the iterator variable to bind correctly to the `VectorProxy` elements. If you use `auto&`, compiler warning [C4239](../error-messages/compiler-warnings/compiler-warning-level-4-c4239.md) is raised and `VectoryProxy` is mentioned in the warning text. @@ -59,7 +59,7 @@ The following illustration shows a `range for` loop over an `IVector`. ![Screenshot of debugging VectorProxy in a range based for loop.](../cppcx/media/vectorproxy-1.png) -One scenario in which you have to code around the proxy object is when you have to perform a **`dynamic_cast`** on the elements—for example, when you are looking for XAML objects of a particular type in a `UIElement` element collection. In this case, you must first cast the element to [Platform::Object](../cppcx/platform-object-class.md)^ and then perform the dynamic cast: +One scenario in which you have to code around the proxy object is when you have to perform a **`dynamic_cast`** on the elements—for example, when you are looking for XAML objects of a particular type in a `UIElement` element collection. In this case, you must first cast the element to [`Platform::Object`](../cppcx/platform-object-class.md)^ and then perform the dynamic cast: ```cpp void FindButton(UIElementCollection^ col) @@ -78,64 +78,64 @@ void FindButton(UIElementCollection^ col) ## Map usage -This example shows how to insert items and look them up in a [Platform::Collections::Map](../cppcx/platform-collections-map-class.md), and then return the `Map` as a read-only [Windows::Foundation::Collections::IMapView](/uwp/api/windows.foundation.collections.imapview-2) type. +This example shows how to insert items and look them up in a [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md), and then return the `Map` as a read-only [`Windows::Foundation::Collections::IMapView`](/uwp/api/windows.foundation.collections.imapview-2) type. [!code-cpp[cx_collections#04](../cppcx/codesnippet/CPP/collections/class1.cpp#04)] -In general, for internal map functionality, prefer the `std::map` type for performance reasons. If you have to pass the container across the ABI, construct a [Platform::Collections::Map](../cppcx/platform-collections-map-class.md) from the [std::map](../standard-library/map-class.md) and return the `Map` as an [Windows::Foundation::Collections::IMap](/uwp/api/windows.foundation.collections.imap-2). If you attempt to use a `Map` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Map` to an `IMap`. In some cases—for example, if you are not making a large number of lookups or insertions, and you are passing the collection across the ABI frequently—it might be less expensive to use `Platform::Collections::Map` from the beginning and avoid the cost of converting the `std::map`. In any case, avoid lookup and insert operations on an `IMap` because these are the least performant of the three types. Convert to `IMap` only at the point that you pass the container across the ABI. +In general, for internal map functionality, prefer the `std::map` type for performance reasons. If you have to pass the container across the ABI, construct a [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md) from the [`std::map`](../standard-library/map-class.md) and return the `Map` as an [`Windows::Foundation::Collections::IMap`](/uwp/api/windows.foundation.collections.imap-2). If you attempt to use a `Map` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Map` to an `IMap`. In some cases—for example, if you are not making a large number of lookups or insertions, and you are passing the collection across the ABI frequently—it might be less expensive to use `Platform::Collections::Map` from the beginning and avoid the cost of converting the `std::map`. In any case, avoid lookup and insert operations on an `IMap` because these are the least performant of the three types. Convert to `IMap` only at the point that you pass the container across the ABI. ## Value types in Map -Elements in a [Platform::Collections::Map](../cppcx/platform-collections-map-class.md) are ordered. Any element to be stored in a `Map` must support less-than comparison with strict weak ordering, either implicitly or by using a custom [std::less](../standard-library/less-struct.md) comparator that you provide. Scalar types support the comparison implicitly. For non-scalar value types such as `Windows::Foundation::DateTime`, or for custom comparisons—for example, `objA->UniqueID < objB->UniqueID`—you must provide a custom comparator. +Elements in a [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md) are ordered. Any element to be stored in a `Map` must support less-than comparison with strict weak ordering, either implicitly or by using a custom [`std::less`](../standard-library/less-struct.md) comparator that you provide. Scalar types support the comparison implicitly. For non-scalar value types such as `Windows::Foundation::DateTime`, or for custom comparisons—for example, `objA->UniqueID < objB->UniqueID`—you must provide a custom comparator. ## Collection types Collections fall into four categories: modifiable versions and read-only versions of sequence collections and associative collections. In addition, C++/CX enhances collections by providing three iterator classes that simplify the accessing of collections. -Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) or[Platform::Collections::VectorView](../cppcx/platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [Vector::GetAt](../cppcx/platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [Map::Lookup](../cppcx/platform-collections-map-class.md#lookup) and a key. +Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) or[`Platform::Collections::VectorView`](../cppcx/platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [`Vector::GetAt`](../cppcx/platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [`Map::Lookup`](../cppcx/platform-collections-map-class.md#lookup) and a key. -[Platform::Collections::Map class](../cppcx/platform-collections-map-class.md)\ +[`Platform::Collections::Map` class](../cppcx/platform-collections-map-class.md)\ A modifiable, associative collection. Map elements are key-value pairs. Looking up a key to retrieve its associated value, and iterating through all key-value pairs, are both supported. -`Map` and `MapView` are templated on `>`; therefore, you can customize the comparator. Additionally, `Vector` and `VectorView` are templated on `>` so that you can customize the behavior of `IndexOf()`. This is important mostly for `Vector` and `VectorView` of value structs. For example, to create a Vector\, you must provide a custom comparator because DateTime does not overload the == operator. +`Map` and `MapView` are templated on `>`; therefore, you can customize the comparator. Additionally, `Vector` and `VectorView` are templated on `>` so that you can customize the behavior of `IndexOf()`. This is important mostly for `Vector` and `VectorView` of value structs. For example, to create a `Vector`, you must provide a custom comparator because DateTime does not overload the `==` operator. -[Platform::Collections::MapView class](../cppcx/platform-collections-mapview-class.md)\ +[`Platform::Collections::MapView` class](../cppcx/platform-collections-mapview-class.md)\ A read-only version of a `Map`. -[Platform::Collections::Vector class](../cppcx/platform-collections-vector-class.md)\ -A modifiable sequence collection. `Vector` supports constant-time random access and amortized-constant-time [Append](../cppcx/platform-collections-vector-class.md#append) operations. +[`Platform::Collections::Vector` class](../cppcx/platform-collections-vector-class.md)\ +A modifiable sequence collection. `Vector` supports constant-time random access and amortized-constant-time [`Append`](../cppcx/platform-collections-vector-class.md#append) operations. -[Platform::Collections::VectorView class](../cppcx/platform-collections-vectorview-class.md)\ +[`Platform::Collections::VectorView` class](../cppcx/platform-collections-vectorview-class.md)\ A read-only version of a `Vector`. -[Platform::Collections::InputIterator class](../cppcx/platform-collections-inputiterator-class.md)\ +[`Platform::Collections::InputIterator` class](../cppcx/platform-collections-inputiterator-class.md)\ An STL iterator that satisfies the requirements of an STL input iterator. -[Platform::Collections::VectorIterator class](../cppcx/platform-collections-vectoriterator-class.md)\ +[`Platform::Collections::VectorIterator` class](../cppcx/platform-collections-vectoriterator-class.md)\ An STL iterator that satisfies the requirements of an STL mutable random-access iterator. -[Platform::Collections::VectorViewIterator class](../cppcx/platform-collections-vectorviewiterator-class.md)\ +[`Platform::Collections::VectorViewIterator` class](../cppcx/platform-collections-vectorviewiterator-class.md)\ An STL iterator that satisfies the requirements of an STL **`const`** random-access iterator. ### begin() and end() functions -To simplify the use of the STL to process `Vector`, `VectorView`, `Map`, `MapView`, and arbitrary `Windows::Foundation::Collections` objects, C++/CX supports overloads of the [begin Function](../cppcx/begin-function.md) and [end Function](../cppcx/end-function.md) non-member functions. +To simplify the use of the STL to process `Vector`, `VectorView`, `Map`, `MapView`, and arbitrary `Windows::Foundation::Collections` objects, C++/CX supports overloads of the [`begin` Function](../cppcx/begin-function.md) and [`end` Function](../cppcx/end-function.md) non-member functions. The following table lists the available iterators and functions. |Iterators|Functions| |---------------|---------------| -|[Platform::Collections::VectorIterator\](../cppcx/platform-collections-vectoriterator-class.md)

(Internally stores [Windows::Foundation::Collections:: IVector\](/uwp/api/windows.foundation.collections.ivector-1) and int.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md)([Windows::Foundation::Collections:: IVector\](/uwp/api/windows.foundation.collections.ivector-1))| -|[Platform::Collections::VectorViewIterator\](../cppcx/platform-collections-vectorviewiterator-class.md)

(Internally stores [IVectorView\](/uwp/api/windows.foundation.collections.ivectorview-1)^ and int.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md) ([IVectorView\](/uwp/api/windows.foundation.collections.ivectorview-1)^)| -|[Platform::Collections::InputIterator\](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [IIterator\](/uwp/api/windows.foundation.collections.iiterator-1)^ and T.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md) ([IIterable\](/uwp/api/windows.foundation.collections.iiterable-1))| -|[Platform::Collections::InputIterator^>](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [IIterator\](/uwp/api/windows.foundation.collections.iiterator-1)^ and T.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md) ([IMap\](/uwp/api/windows.foundation.collections.imap-2).| -|[Platform::Collections::InputIterator^>](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [IIterator\](/uwp/api/windows.foundation.collections.iiterator-1)^ and T.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md) ([Windows::Foundation::Collections::IMapView](/uwp/api/windows.foundation.collections.imapview-2))| +|[`Platform::Collections::VectorIterator`](../cppcx/platform-collections-vectoriterator-class.md)

(Internally stores [`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1) and `int`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md)([`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1))| +|[`Platform::Collections::VectorViewIterator`](../cppcx/platform-collections-vectorviewiterator-class.md)

(Internally stores [`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^ and `int`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md) ([`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^)| +|[`Platform::Collections::InputIterator`](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md) ([`IIterable`](/uwp/api/windows.foundation.collections.iiterable-1))| +|[`Platform::Collections::InputIterator^>`](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md) ([`IMap`](/uwp/api/windows.foundation.collections.imap-2).| +|[`Platform::Collections::InputIterator^>`](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md) ([`Windows::Foundation::Collections::IMapView`](/uwp/api/windows.foundation.collections.imapview-2))| ### Collection change events `Vector` and `Map` support databinding in XAML collections by implementing events that occur when a collection object is changed or reset, or when any element of a collection is inserted, removed, or changed. You can write your own types that support databinding, although you cannot inherit from `Map` or `Vector` because those types are sealed. -The [Windows::Foundation::Collections::VectorChangedEventHandler](/uwp/api/windows.foundation.collections.vectorchangedeventhandler-1) and [Windows::Foundation::Collections::MapChangedEventHandler](/uwp/api/windows.foundation.collections.mapchangedeventhandler-2) delegates specify the signatures for event handlers for collection change events. The [Windows::Foundation::Collections::CollectionChange](/uwp/api/windows.foundation.collections.collectionchange) public enum class, and `Platform::Collection::Details::MapChangedEventArgs` and `Platform::Collections::Details::VectorChangedEventArgs` ref classes, store the event arguments to determine what caused the event. The `*EventArgs` types are defined in the `Details` namespace because you don't have to construct or consume them explicitly when you use `Map` or `Vector`. +The [`Windows::Foundation::Collections::VectorChangedEventHandler`](/uwp/api/windows.foundation.collections.vectorchangedeventhandler-1) and [`Windows::Foundation::Collections::MapChangedEventHandler`](/uwp/api/windows.foundation.collections.mapchangedeventhandler-2) delegates specify the signatures for event handlers for collection change events. The [`Windows::Foundation::Collections::CollectionChange`](/uwp/api/windows.foundation.collections.collectionchange) public enum class, and `Platform::Collection::Details::MapChangedEventArgs` and `Platform::Collections::Details::VectorChangedEventArgs` ref classes, store the event arguments to determine what caused the event. The `*EventArgs` types are defined in the `Details` namespace because you don't have to construct or consume them explicitly when you use `Map` or `Vector`. ## See also From af4e31ebc6a1b5cdbb2c1225121bc2d7162e5466 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 17:02:36 +0800 Subject: [PATCH 0123/1799] Clean up superfluous double spaces in "Collections (C++/CX)" --- docs/cppcx/collections-c-cx.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/cppcx/collections-c-cx.md b/docs/cppcx/collections-c-cx.md index 83dc53bece7..2653ea14b80 100644 --- a/docs/cppcx/collections-c-cx.md +++ b/docs/cppcx/collections-c-cx.md @@ -17,14 +17,14 @@ The Windows Runtime defines the interfaces for collections and related types, an - [`Platform::Collections::VectorView` class](../cppcx/platform-collections-vectorview-class.md) and [`Platform::Collections::MapView` class](../cppcx/platform-collections-mapview-class.md) are read-only versions of `Vector` and `Map`. -- Iterators are defined in the [`Platform::Collections` Namespace](../cppcx/platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [`std::find`](../standard-library/algorithm-functions.md#find), [`std::count_if`](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [`Windows::Foundation::Collections`](/uwp/api/windows.foundation.collections) interface type or [`Platform::Collections`](../cppcx/platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. +- Iterators are defined in the [`Platform::Collections` Namespace](../cppcx/platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [`std::find`](../standard-library/algorithm-functions.md#find), [`std::count_if`](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [`Windows::Foundation::Collections`](/uwp/api/windows.foundation.collections) interface type or [`Platform::Collections`](../cppcx/platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. > [!IMPORTANT] > Proxy iterators `VectorIterator` and `VectorViewIterator` utilize proxy objects `VectoryProxy` and `ArrowProxy` to enable usage with STL containers. For more information, see "VectorProxy elements" later in this article. - The C++/CX collection types support the same thread safety guarantees that STL containers support. -- [`Windows::Foundation::Collections::IObservableVector`](/uwp/api/windows.foundation.collections.iobservablevector-1) and [`Windows::Foundation::Collections::IObservableMap`](/uwp/api/windows.foundation.collections.iobservablemap-2) define events that are fired when the collection changes in various ways. By implementing these interfaces, [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md) and [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) support databinding with XAML collections. For example, if you have a `Vector` that is data-bound to a `Grid`, when you add an item to a collection, the change is reflected in the Grid UI. +- [`Windows::Foundation::Collections::IObservableVector`](/uwp/api/windows.foundation.collections.iobservablevector-1) and [`Windows::Foundation::Collections::IObservableMap`](/uwp/api/windows.foundation.collections.iobservablemap-2) define events that are fired when the collection changes in various ways. By implementing these interfaces, [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md) and [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) support databinding with XAML collections. For example, if you have a `Vector` that is data-bound to a `Grid`, when you add an item to a collection, the change is reflected in the Grid UI. ## Vector usage @@ -97,7 +97,7 @@ Elements of a modifiable collection can be changed, but elements of a read-only [`Platform::Collections::Map` class](../cppcx/platform-collections-map-class.md)\ A modifiable, associative collection. Map elements are key-value pairs. Looking up a key to retrieve its associated value, and iterating through all key-value pairs, are both supported. -`Map` and `MapView` are templated on `>`; therefore, you can customize the comparator. Additionally, `Vector` and `VectorView` are templated on `>` so that you can customize the behavior of `IndexOf()`. This is important mostly for `Vector` and `VectorView` of value structs. For example, to create a `Vector`, you must provide a custom comparator because DateTime does not overload the `==` operator. +`Map` and `MapView` are templated on `>`; therefore, you can customize the comparator. Additionally, `Vector` and `VectorView` are templated on `>` so that you can customize the behavior of `IndexOf()`. This is important mostly for `Vector` and `VectorView` of value structs. For example, to create a `Vector`, you must provide a custom comparator because DateTime does not overload the `==` operator. [`Platform::Collections::MapView` class](../cppcx/platform-collections-mapview-class.md)\ A read-only version of a `Map`. @@ -115,7 +115,7 @@ An STL iterator that satisfies the requirements of an STL input iterator. An STL iterator that satisfies the requirements of an STL mutable random-access iterator. [`Platform::Collections::VectorViewIterator` class](../cppcx/platform-collections-vectorviewiterator-class.md)\ -An STL iterator that satisfies the requirements of an STL **`const`** random-access iterator. +An STL iterator that satisfies the requirements of an STL **`const`** random-access iterator. ### begin() and end() functions From a53a2b32ed08aec2a1c3cfab4b5022dbfb485d9a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 17:06:17 +0800 Subject: [PATCH 0124/1799] Clean up redundant relative links in "Collections (C++/CX)" --- docs/cppcx/collections-c-cx.md | 72 +++++++++++++++++----------------- 1 file changed, 36 insertions(+), 36 deletions(-) diff --git a/docs/cppcx/collections-c-cx.md b/docs/cppcx/collections-c-cx.md index 2653ea14b80..5277ddbea0c 100644 --- a/docs/cppcx/collections-c-cx.md +++ b/docs/cppcx/collections-c-cx.md @@ -9,57 +9,57 @@ In a C++/CX program, you can make free use of Standard Template Library (STL) co The Windows Runtime defines the interfaces for collections and related types, and C++/CX provides the concrete C++ implementations in the collection.h header file. This illustration shows the relationships between the collection types: -![Diagram of C plus plus C X inheritance tree for collection types.](../cppcx/media/cppcxcollectionsinheritancetree.png) +![Diagram of C plus plus C X inheritance tree for collection types.](media/cppcxcollectionsinheritancetree.png) -- The [`Platform::Collections::Vector` class](../cppcx/platform-collections-vector-class.md) resembles the [`std::vector` class](../standard-library/vector-class.md). +- The [`Platform::Collections::Vector` class](platform-collections-vector-class.md) resembles the [`std::vector` class](../standard-library/vector-class.md). -- The [`Platform::Collections::Map` class](../cppcx/platform-collections-map-class.md) resembles the [`std::map` class](../standard-library/map-class.md). +- The [`Platform::Collections::Map` class](platform-collections-map-class.md) resembles the [`std::map` class](../standard-library/map-class.md). -- [`Platform::Collections::VectorView` class](../cppcx/platform-collections-vectorview-class.md) and [`Platform::Collections::MapView` class](../cppcx/platform-collections-mapview-class.md) are read-only versions of `Vector` and `Map`. +- [`Platform::Collections::VectorView` class](platform-collections-vectorview-class.md) and [`Platform::Collections::MapView` class](platform-collections-mapview-class.md) are read-only versions of `Vector` and `Map`. -- Iterators are defined in the [`Platform::Collections` Namespace](../cppcx/platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [`std::find`](../standard-library/algorithm-functions.md#find), [`std::count_if`](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [`Windows::Foundation::Collections`](/uwp/api/windows.foundation.collections) interface type or [`Platform::Collections`](../cppcx/platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. +- Iterators are defined in the [`Platform::Collections` Namespace](platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [`std::find`](../standard-library/algorithm-functions.md#find), [`std::count_if`](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [`Windows::Foundation::Collections`](/uwp/api/windows.foundation.collections) interface type or [`Platform::Collections`](platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. > [!IMPORTANT] > Proxy iterators `VectorIterator` and `VectorViewIterator` utilize proxy objects `VectoryProxy` and `ArrowProxy` to enable usage with STL containers. For more information, see "VectorProxy elements" later in this article. - The C++/CX collection types support the same thread safety guarantees that STL containers support. -- [`Windows::Foundation::Collections::IObservableVector`](/uwp/api/windows.foundation.collections.iobservablevector-1) and [`Windows::Foundation::Collections::IObservableMap`](/uwp/api/windows.foundation.collections.iobservablemap-2) define events that are fired when the collection changes in various ways. By implementing these interfaces, [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md) and [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) support databinding with XAML collections. For example, if you have a `Vector` that is data-bound to a `Grid`, when you add an item to a collection, the change is reflected in the Grid UI. +- [`Windows::Foundation::Collections::IObservableVector`](/uwp/api/windows.foundation.collections.iobservablevector-1) and [`Windows::Foundation::Collections::IObservableMap`](/uwp/api/windows.foundation.collections.iobservablemap-2) define events that are fired when the collection changes in various ways. By implementing these interfaces, [`Platform::Collections::Map`](platform-collections-map-class.md) and [`Platform::Collections::Vector`](platform-collections-vector-class.md) support databinding with XAML collections. For example, if you have a `Vector` that is data-bound to a `Grid`, when you add an item to a collection, the change is reflected in the Grid UI. ## Vector usage -When your class has to pass a sequence container to another Windows Runtime component, use [`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1) as the parameter or return type, and [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) as the concrete implementation. If you attempt to use a `Vector` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Vector` to an `IVector`. +When your class has to pass a sequence container to another Windows Runtime component, use [`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1) as the parameter or return type, and [`Platform::Collections::Vector`](platform-collections-vector-class.md) as the concrete implementation. If you attempt to use a `Vector` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Vector` to an `IVector`. > [!IMPORTANT] > If you are passing a sequence within your own program, then use either `Vector` or `std::vector` because they are more efficient than `IVector`. Use `IVector` only when you pass the container across the ABI. > > The Windows Runtime type system does not support the concept of jagged arrays and therefore you cannot pass an `IVector>` as a return value or method parameter. To pass a jagged array or a sequence of sequences across the ABI, use `IVector^>`. -`Vector` provides the methods that are required for adding, removing, and accessing items in the collection, and it is implicitly convertible to `IVector`. You can also use STL algorithms on instances of `Vector`. The following example demonstrates some basic usage. The [`begin` function](../cppcx/begin-function.md) and [`end` function](../cppcx/end-function.md) here are from the `Platform::Collections` namespace, not the `std` namespace. +`Vector` provides the methods that are required for adding, removing, and accessing items in the collection, and it is implicitly convertible to `IVector`. You can also use STL algorithms on instances of `Vector`. The following example demonstrates some basic usage. The [`begin` function](begin-function.md) and [`end` function](end-function.md) here are from the `Platform::Collections` namespace, not the `std` namespace. -[!code-cpp[cx_collections#01](../cppcx/codesnippet/CPP/collections/class1.cpp#01)] +[!code-cpp[cx_collections#01](codesnippet/CPP/collections/class1.cpp#01)] If you have existing code that uses `std::vector` and you want to reuse it in a Windows Runtime component, just use one of the `Vector` constructors that takes a `std::vector` or a pair of iterators to construct a `Vector` at the point where you pass the collection across the ABI. The following example shows how to use the `Vector` move constructor for efficient initialization from a `std::vector`. After the move operation, the original `vec` variable is no longer valid. -[!code-cpp[cx_collections#02](../cppcx/codesnippet/CPP/collections/class1.cpp#02)] +[!code-cpp[cx_collections#02](codesnippet/CPP/collections/class1.cpp#02)] If you have a vector of strings that you must pass across the ABI at some future point, you must decide whether to create the strings initially as `std::wstring` types or as `Platform::String^` types. If you have to do a lot of processing on the strings, then use `wstring`. Otherwise, create the strings as `Platform::String^` types and avoid the cost of converting them later. You must also decide whether to put these strings into a `std::vector` or `Platform::Collections::Vector` internally. As a general practice, use `std::vector` and then create a `Platform::Vector` from it only when you pass the container across the ABI. ## Value types in Vector -Any element to be stored in a [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) must support equality comparison, either implicitly or by using a custom [`std::equal_to`](../standard-library/equal-to-struct.md) comparator that you provide. All reference types and all scalar types implicitly support equality comparisons. For non-scalar value types such as [`Windows::Foundation::DateTime`](/uwp/api/windows.foundation.datetime), or for custom comparisons—for example, `objA->UniqueID == objB->UniqueID`—you must provide a custom function object. +Any element to be stored in a [`Platform::Collections::Vector`](platform-collections-vector-class.md) must support equality comparison, either implicitly or by using a custom [`std::equal_to`](../standard-library/equal-to-struct.md) comparator that you provide. All reference types and all scalar types implicitly support equality comparisons. For non-scalar value types such as [`Windows::Foundation::DateTime`](/uwp/api/windows.foundation.datetime), or for custom comparisons—for example, `objA->UniqueID == objB->UniqueID`—you must provide a custom function object. ## VectorProxy elements -[`Platform::Collections::VectorIterator`](../cppcx/platform-collections-vectoriterator-class.md) and [`Platform::Collections::VectorViewIterator`](../cppcx/platform-collections-vectorviewiterator-class.md) enable the use of `range for` loops and algorithms like [`std::sort`](../standard-library/algorithm-functions.md#sort) with an [`IVector`](/uwp/api/windows.foundation.collections.ivector-1) container. But `IVector` elements cannot be accessed through C++ pointer dereference; they can be accessed only through [`GetAt`](/uwp/api/windows.foundation.collections.ivector-1.getat) and [`SetAt`](/uwp/api/windows.foundation.collections.ivector-1.setat) methods. Therefore, these iterators use the proxy classes `Platform::Details::VectorProxy` and `Platform::Details::ArrowProxy` to provide access to the individual elements through **`*`**, **`->`**, and **`[]`** operators, as required by the Standard Library. Strictly speaking, given an `IVector vec`, the type of `*begin(vec)` is `VectorProxy`. However, the proxy object is almost always transparent to your code. These proxy objects are not documented because they are only for internal use by the iterators, but it is useful to know how the mechanism works. +[`Platform::Collections::VectorIterator`](platform-collections-vectoriterator-class.md) and [`Platform::Collections::VectorViewIterator`](platform-collections-vectorviewiterator-class.md) enable the use of `range for` loops and algorithms like [`std::sort`](../standard-library/algorithm-functions.md#sort) with an [`IVector`](/uwp/api/windows.foundation.collections.ivector-1) container. But `IVector` elements cannot be accessed through C++ pointer dereference; they can be accessed only through [`GetAt`](/uwp/api/windows.foundation.collections.ivector-1.getat) and [`SetAt`](/uwp/api/windows.foundation.collections.ivector-1.setat) methods. Therefore, these iterators use the proxy classes `Platform::Details::VectorProxy` and `Platform::Details::ArrowProxy` to provide access to the individual elements through **`*`**, **`->`**, and **`[]`** operators, as required by the Standard Library. Strictly speaking, given an `IVector vec`, the type of `*begin(vec)` is `VectorProxy`. However, the proxy object is almost always transparent to your code. These proxy objects are not documented because they are only for internal use by the iterators, but it is useful to know how the mechanism works. When you use a range-based **`for`** loop over `IVector` containers, use `auto&&` to enable the iterator variable to bind correctly to the `VectorProxy` elements. If you use `auto&`, compiler warning [C4239](../error-messages/compiler-warnings/compiler-warning-level-4-c4239.md) is raised and `VectoryProxy` is mentioned in the warning text. The following illustration shows a `range for` loop over an `IVector`. Notice that execution is stopped on the breakpoint on line 64. The **QuickWatch** window shows that the iterator variable `p` is in fact a `VectorProxy` that has `m_v` and `m_i` member variables. However, when you call `GetType` on this variable, it returns the identical type to the `Person` instance `p2`. The takeaway is that although `VectorProxy` and `ArrowProxy` might appear in **QuickWatch**, the debugger certain compiler errors, or other places, you typically don't have to explicitly code for them. -![Screenshot of debugging VectorProxy in a range based for loop.](../cppcx/media/vectorproxy-1.png) +![Screenshot of debugging VectorProxy in a range based for loop.](media/vectorproxy-1.png) -One scenario in which you have to code around the proxy object is when you have to perform a **`dynamic_cast`** on the elements—for example, when you are looking for XAML objects of a particular type in a `UIElement` element collection. In this case, you must first cast the element to [`Platform::Object`](../cppcx/platform-object-class.md)^ and then perform the dynamic cast: +One scenario in which you have to code around the proxy object is when you have to perform a **`dynamic_cast`** on the elements—for example, when you are looking for XAML objects of a particular type in a `UIElement` element collection. In this case, you must first cast the element to [`Platform::Object`](platform-object-class.md)^ and then perform the dynamic cast: ```cpp void FindButton(UIElementCollection^ col) @@ -78,58 +78,58 @@ void FindButton(UIElementCollection^ col) ## Map usage -This example shows how to insert items and look them up in a [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md), and then return the `Map` as a read-only [`Windows::Foundation::Collections::IMapView`](/uwp/api/windows.foundation.collections.imapview-2) type. +This example shows how to insert items and look them up in a [`Platform::Collections::Map`](platform-collections-map-class.md), and then return the `Map` as a read-only [`Windows::Foundation::Collections::IMapView`](/uwp/api/windows.foundation.collections.imapview-2) type. -[!code-cpp[cx_collections#04](../cppcx/codesnippet/CPP/collections/class1.cpp#04)] +[!code-cpp[cx_collections#04](codesnippet/CPP/collections/class1.cpp#04)] -In general, for internal map functionality, prefer the `std::map` type for performance reasons. If you have to pass the container across the ABI, construct a [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md) from the [`std::map`](../standard-library/map-class.md) and return the `Map` as an [`Windows::Foundation::Collections::IMap`](/uwp/api/windows.foundation.collections.imap-2). If you attempt to use a `Map` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Map` to an `IMap`. In some cases—for example, if you are not making a large number of lookups or insertions, and you are passing the collection across the ABI frequently—it might be less expensive to use `Platform::Collections::Map` from the beginning and avoid the cost of converting the `std::map`. In any case, avoid lookup and insert operations on an `IMap` because these are the least performant of the three types. Convert to `IMap` only at the point that you pass the container across the ABI. +In general, for internal map functionality, prefer the `std::map` type for performance reasons. If you have to pass the container across the ABI, construct a [`Platform::Collections::Map`](platform-collections-map-class.md) from the [`std::map`](../standard-library/map-class.md) and return the `Map` as an [`Windows::Foundation::Collections::IMap`](/uwp/api/windows.foundation.collections.imap-2). If you attempt to use a `Map` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Map` to an `IMap`. In some cases—for example, if you are not making a large number of lookups or insertions, and you are passing the collection across the ABI frequently—it might be less expensive to use `Platform::Collections::Map` from the beginning and avoid the cost of converting the `std::map`. In any case, avoid lookup and insert operations on an `IMap` because these are the least performant of the three types. Convert to `IMap` only at the point that you pass the container across the ABI. ## Value types in Map -Elements in a [`Platform::Collections::Map`](../cppcx/platform-collections-map-class.md) are ordered. Any element to be stored in a `Map` must support less-than comparison with strict weak ordering, either implicitly or by using a custom [`std::less`](../standard-library/less-struct.md) comparator that you provide. Scalar types support the comparison implicitly. For non-scalar value types such as `Windows::Foundation::DateTime`, or for custom comparisons—for example, `objA->UniqueID < objB->UniqueID`—you must provide a custom comparator. +Elements in a [`Platform::Collections::Map`](platform-collections-map-class.md) are ordered. Any element to be stored in a `Map` must support less-than comparison with strict weak ordering, either implicitly or by using a custom [`std::less`](../standard-library/less-struct.md) comparator that you provide. Scalar types support the comparison implicitly. For non-scalar value types such as `Windows::Foundation::DateTime`, or for custom comparisons—for example, `objA->UniqueID < objB->UniqueID`—you must provide a custom comparator. ## Collection types Collections fall into four categories: modifiable versions and read-only versions of sequence collections and associative collections. In addition, C++/CX enhances collections by providing three iterator classes that simplify the accessing of collections. -Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [`Platform::Collections::Vector`](../cppcx/platform-collections-vector-class.md) or[`Platform::Collections::VectorView`](../cppcx/platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [`Vector::GetAt`](../cppcx/platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [`Map::Lookup`](../cppcx/platform-collections-map-class.md#lookup) and a key. +Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [`Platform::Collections::Vector`](platform-collections-vector-class.md) or[`Platform::Collections::VectorView`](platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [`Vector::GetAt`](platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [`Map::Lookup`](platform-collections-map-class.md#lookup) and a key. -[`Platform::Collections::Map` class](../cppcx/platform-collections-map-class.md)\ +[`Platform::Collections::Map` class](platform-collections-map-class.md)\ A modifiable, associative collection. Map elements are key-value pairs. Looking up a key to retrieve its associated value, and iterating through all key-value pairs, are both supported. `Map` and `MapView` are templated on `>`; therefore, you can customize the comparator. Additionally, `Vector` and `VectorView` are templated on `>` so that you can customize the behavior of `IndexOf()`. This is important mostly for `Vector` and `VectorView` of value structs. For example, to create a `Vector`, you must provide a custom comparator because DateTime does not overload the `==` operator. -[`Platform::Collections::MapView` class](../cppcx/platform-collections-mapview-class.md)\ +[`Platform::Collections::MapView` class](platform-collections-mapview-class.md)\ A read-only version of a `Map`. -[`Platform::Collections::Vector` class](../cppcx/platform-collections-vector-class.md)\ -A modifiable sequence collection. `Vector` supports constant-time random access and amortized-constant-time [`Append`](../cppcx/platform-collections-vector-class.md#append) operations. +[`Platform::Collections::Vector` class](platform-collections-vector-class.md)\ +A modifiable sequence collection. `Vector` supports constant-time random access and amortized-constant-time [`Append`](platform-collections-vector-class.md#append) operations. -[`Platform::Collections::VectorView` class](../cppcx/platform-collections-vectorview-class.md)\ +[`Platform::Collections::VectorView` class](platform-collections-vectorview-class.md)\ A read-only version of a `Vector`. -[`Platform::Collections::InputIterator` class](../cppcx/platform-collections-inputiterator-class.md)\ +[`Platform::Collections::InputIterator` class](platform-collections-inputiterator-class.md)\ An STL iterator that satisfies the requirements of an STL input iterator. -[`Platform::Collections::VectorIterator` class](../cppcx/platform-collections-vectoriterator-class.md)\ +[`Platform::Collections::VectorIterator` class](platform-collections-vectoriterator-class.md)\ An STL iterator that satisfies the requirements of an STL mutable random-access iterator. -[`Platform::Collections::VectorViewIterator` class](../cppcx/platform-collections-vectorviewiterator-class.md)\ +[`Platform::Collections::VectorViewIterator` class](platform-collections-vectorviewiterator-class.md)\ An STL iterator that satisfies the requirements of an STL **`const`** random-access iterator. ### begin() and end() functions -To simplify the use of the STL to process `Vector`, `VectorView`, `Map`, `MapView`, and arbitrary `Windows::Foundation::Collections` objects, C++/CX supports overloads of the [`begin` Function](../cppcx/begin-function.md) and [`end` Function](../cppcx/end-function.md) non-member functions. +To simplify the use of the STL to process `Vector`, `VectorView`, `Map`, `MapView`, and arbitrary `Windows::Foundation::Collections` objects, C++/CX supports overloads of the [`begin` Function](begin-function.md) and [`end` Function](end-function.md) non-member functions. The following table lists the available iterators and functions. |Iterators|Functions| |---------------|---------------| -|[`Platform::Collections::VectorIterator`](../cppcx/platform-collections-vectoriterator-class.md)

(Internally stores [`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1) and `int`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md)([`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1))| -|[`Platform::Collections::VectorViewIterator`](../cppcx/platform-collections-vectorviewiterator-class.md)

(Internally stores [`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^ and `int`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md) ([`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^)| -|[`Platform::Collections::InputIterator`](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md) ([`IIterable`](/uwp/api/windows.foundation.collections.iiterable-1))| -|[`Platform::Collections::InputIterator^>`](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md) ([`IMap`](/uwp/api/windows.foundation.collections.imap-2).| -|[`Platform::Collections::InputIterator^>`](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](../cppcx/begin-function.md)/ [`end`](../cppcx/end-function.md) ([`Windows::Foundation::Collections::IMapView`](/uwp/api/windows.foundation.collections.imapview-2))| +|[`Platform::Collections::VectorIterator`](platform-collections-vectoriterator-class.md)

(Internally stores [`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1) and `int`.)|[`begin`](begin-function.md)/ [`end`](end-function.md)([`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1))| +|[`Platform::Collections::VectorViewIterator`](platform-collections-vectorviewiterator-class.md)

(Internally stores [`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^ and `int`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^)| +|[`Platform::Collections::InputIterator`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IIterable`](/uwp/api/windows.foundation.collections.iiterable-1))| +|[`Platform::Collections::InputIterator^>`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IMap`](/uwp/api/windows.foundation.collections.imap-2).| +|[`Platform::Collections::InputIterator^>`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`Windows::Foundation::Collections::IMapView`](/uwp/api/windows.foundation.collections.imapview-2))| ### Collection change events @@ -139,6 +139,6 @@ The [`Windows::Foundation::Collections::VectorChangedEventHandler`](/uwp/api/win ## See also -[Type System](../cppcx/type-system-c-cx.md)\ -[C++/CX Language Reference](../cppcx/visual-c-language-reference-c-cx.md)\ -[Namespaces Reference](../cppcx/namespaces-reference-c-cx.md) +[Type System](type-system-c-cx.md)\ +[C++/CX Language Reference](visual-c-language-reference-c-cx.md)\ +[Namespaces Reference](namespaces-reference-c-cx.md) From c607b6f6f9884877b2858aae14f13f0855f94aa3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 17:09:02 +0800 Subject: [PATCH 0125/1799] Add link for "VectorProxy elements" in "Collections (C++/CX)" --- docs/cppcx/collections-c-cx.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cppcx/collections-c-cx.md b/docs/cppcx/collections-c-cx.md index 5277ddbea0c..57e5c2181a1 100644 --- a/docs/cppcx/collections-c-cx.md +++ b/docs/cppcx/collections-c-cx.md @@ -20,7 +20,7 @@ The Windows Runtime defines the interfaces for collections and related types, an - Iterators are defined in the [`Platform::Collections` Namespace](platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [`std::find`](../standard-library/algorithm-functions.md#find), [`std::count_if`](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [`Windows::Foundation::Collections`](/uwp/api/windows.foundation.collections) interface type or [`Platform::Collections`](platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. > [!IMPORTANT] - > Proxy iterators `VectorIterator` and `VectorViewIterator` utilize proxy objects `VectoryProxy` and `ArrowProxy` to enable usage with STL containers. For more information, see "VectorProxy elements" later in this article. + > Proxy iterators `VectorIterator` and `VectorViewIterator` utilize proxy objects `VectoryProxy` and `ArrowProxy` to enable usage with STL containers. For more information, see [VectorProxy elements](#vectorproxy-elements) later in this article. - The C++/CX collection types support the same thread safety guarantees that STL containers support. From 8965e98acfd10a584c9a67ba7ae6598a204778cf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 17:09:27 +0800 Subject: [PATCH 0126/1799] Remove double quotes for `ms.date` in "Collections (C++/CX)" --- docs/cppcx/collections-c-cx.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cppcx/collections-c-cx.md b/docs/cppcx/collections-c-cx.md index 57e5c2181a1..c4ce70f696c 100644 --- a/docs/cppcx/collections-c-cx.md +++ b/docs/cppcx/collections-c-cx.md @@ -1,7 +1,7 @@ --- title: "Collections (C++/CX)" description: "Learn more about: Collections (C++/CX)" -ms.date: "11/19/2018" +ms.date: 11/19/2018 --- # Collections (C++/CX) From 3572cc9e9f719e5837addeded1a602aef63d8b69 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 17:27:46 +0800 Subject: [PATCH 0127/1799] Fix more errors in "Collections (C++/CX)" --- docs/cppcx/collections-c-cx.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/cppcx/collections-c-cx.md b/docs/cppcx/collections-c-cx.md index c4ce70f696c..2471f4f3bb9 100644 --- a/docs/cppcx/collections-c-cx.md +++ b/docs/cppcx/collections-c-cx.md @@ -20,7 +20,7 @@ The Windows Runtime defines the interfaces for collections and related types, an - Iterators are defined in the [`Platform::Collections` Namespace](platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [`std::find`](../standard-library/algorithm-functions.md#find), [`std::count_if`](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [`Windows::Foundation::Collections`](/uwp/api/windows.foundation.collections) interface type or [`Platform::Collections`](platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. > [!IMPORTANT] - > Proxy iterators `VectorIterator` and `VectorViewIterator` utilize proxy objects `VectoryProxy` and `ArrowProxy` to enable usage with STL containers. For more information, see [VectorProxy elements](#vectorproxy-elements) later in this article. + > Proxy iterators `VectorIterator` and `VectorViewIterator` utilize proxy objects `VectorProxy` and `ArrowProxy` to enable usage with STL containers. For more information, see [VectorProxy elements](#vectorproxy-elements) later in this article. - The C++/CX collection types support the same thread safety guarantees that STL containers support. @@ -53,7 +53,7 @@ Any element to be stored in a [`Platform::Collections::Vector`](platform-collect [`Platform::Collections::VectorIterator`](platform-collections-vectoriterator-class.md) and [`Platform::Collections::VectorViewIterator`](platform-collections-vectorviewiterator-class.md) enable the use of `range for` loops and algorithms like [`std::sort`](../standard-library/algorithm-functions.md#sort) with an [`IVector`](/uwp/api/windows.foundation.collections.ivector-1) container. But `IVector` elements cannot be accessed through C++ pointer dereference; they can be accessed only through [`GetAt`](/uwp/api/windows.foundation.collections.ivector-1.getat) and [`SetAt`](/uwp/api/windows.foundation.collections.ivector-1.setat) methods. Therefore, these iterators use the proxy classes `Platform::Details::VectorProxy` and `Platform::Details::ArrowProxy` to provide access to the individual elements through **`*`**, **`->`**, and **`[]`** operators, as required by the Standard Library. Strictly speaking, given an `IVector vec`, the type of `*begin(vec)` is `VectorProxy`. However, the proxy object is almost always transparent to your code. These proxy objects are not documented because they are only for internal use by the iterators, but it is useful to know how the mechanism works. -When you use a range-based **`for`** loop over `IVector` containers, use `auto&&` to enable the iterator variable to bind correctly to the `VectorProxy` elements. If you use `auto&`, compiler warning [C4239](../error-messages/compiler-warnings/compiler-warning-level-4-c4239.md) is raised and `VectoryProxy` is mentioned in the warning text. +When you use a range-based **`for`** loop over `IVector` containers, use `auto&&` to enable the iterator variable to bind correctly to the `VectorProxy` elements. If you use `auto&`, compiler warning [C4239](../error-messages/compiler-warnings/compiler-warning-level-4-c4239.md) is raised and `VectorProxy` is mentioned in the warning text. The following illustration shows a `range for` loop over an `IVector`. Notice that execution is stopped on the breakpoint on line 64. The **QuickWatch** window shows that the iterator variable `p` is in fact a `VectorProxy` that has `m_v` and `m_i` member variables. However, when you call `GetType` on this variable, it returns the identical type to the `Person` instance `p2`. The takeaway is that although `VectorProxy` and `ArrowProxy` might appear in **QuickWatch**, the debugger certain compiler errors, or other places, you typically don't have to explicitly code for them. @@ -92,7 +92,7 @@ Elements in a [`Platform::Collections::Map`](platform-collections-map-class.md) Collections fall into four categories: modifiable versions and read-only versions of sequence collections and associative collections. In addition, C++/CX enhances collections by providing three iterator classes that simplify the accessing of collections. -Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [`Platform::Collections::Vector`](platform-collections-vector-class.md) or[`Platform::Collections::VectorView`](platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [`Vector::GetAt`](platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [`Map::Lookup`](platform-collections-map-class.md#lookup) and a key. +Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [`Platform::Collections::Vector`](platform-collections-vector-class.md) or [`Platform::Collections::VectorView`](platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [`Vector::GetAt`](platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [`Map::Lookup`](platform-collections-map-class.md#lookup) and a key. [`Platform::Collections::Map` class](platform-collections-map-class.md)\ A modifiable, associative collection. Map elements are key-value pairs. Looking up a key to retrieve its associated value, and iterating through all key-value pairs, are both supported. @@ -128,14 +128,14 @@ The following table lists the available iterators and functions. |[`Platform::Collections::VectorIterator`](platform-collections-vectoriterator-class.md)

(Internally stores [`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1) and `int`.)|[`begin`](begin-function.md)/ [`end`](end-function.md)([`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1))| |[`Platform::Collections::VectorViewIterator`](platform-collections-vectorviewiterator-class.md)

(Internally stores [`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^ and `int`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^)| |[`Platform::Collections::InputIterator`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IIterable`](/uwp/api/windows.foundation.collections.iiterable-1))| -|[`Platform::Collections::InputIterator^>`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IMap`](/uwp/api/windows.foundation.collections.imap-2).| +|[`Platform::Collections::InputIterator^>`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IMap`](/uwp/api/windows.foundation.collections.imap-2))| |[`Platform::Collections::InputIterator^>`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`Windows::Foundation::Collections::IMapView`](/uwp/api/windows.foundation.collections.imapview-2))| ### Collection change events `Vector` and `Map` support databinding in XAML collections by implementing events that occur when a collection object is changed or reset, or when any element of a collection is inserted, removed, or changed. You can write your own types that support databinding, although you cannot inherit from `Map` or `Vector` because those types are sealed. -The [`Windows::Foundation::Collections::VectorChangedEventHandler`](/uwp/api/windows.foundation.collections.vectorchangedeventhandler-1) and [`Windows::Foundation::Collections::MapChangedEventHandler`](/uwp/api/windows.foundation.collections.mapchangedeventhandler-2) delegates specify the signatures for event handlers for collection change events. The [`Windows::Foundation::Collections::CollectionChange`](/uwp/api/windows.foundation.collections.collectionchange) public enum class, and `Platform::Collection::Details::MapChangedEventArgs` and `Platform::Collections::Details::VectorChangedEventArgs` ref classes, store the event arguments to determine what caused the event. The `*EventArgs` types are defined in the `Details` namespace because you don't have to construct or consume them explicitly when you use `Map` or `Vector`. +The [`Windows::Foundation::Collections::VectorChangedEventHandler`](/uwp/api/windows.foundation.collections.vectorchangedeventhandler-1) and [`Windows::Foundation::Collections::MapChangedEventHandler`](/uwp/api/windows.foundation.collections.mapchangedeventhandler-2) delegates specify the signatures for event handlers for collection change events. The [`Windows::Foundation::Collections::CollectionChange`](/uwp/api/windows.foundation.collections.collectionchange) public enum class, and `Platform::Collections::Details::MapChangedEventArgs` and `Platform::Collections::Details::VectorChangedEventArgs` ref classes, store the event arguments to determine what caused the event. The `*EventArgs` types are defined in the `Details` namespace because you don't have to construct or consume them explicitly when you use `Map` or `Vector`. ## See also From 24bd1baa3abd4cdc8cb8192382fc2df7602f656d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 18:11:54 +0800 Subject: [PATCH 0128/1799] Add blockquotes for C4172 warning message --- .../compiler-warnings/compiler-warning-level-1-c4172.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md index 45e27ccfbd7..3131aa03a75 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md @@ -8,7 +8,7 @@ ms.assetid: a8d2bf65-d8b1-4fe3-8340-a223d7e7fde6 --- # Compiler Warning (level 1) C4172 -returning address of local variable or temporary +> returning address of local variable or temporary A function returns the address of a local variable or temporary object. Local variables and temporary objects are destroyed when a function returns, so the address returned is not valid. From 9bc3a15a52b729ecfe28aca5be2170820fc014f9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 18:13:14 +0800 Subject: [PATCH 0129/1799] Add "Remarks" and "Example" headings in C4172 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4172.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md index 3131aa03a75..82155536f03 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md @@ -10,10 +10,14 @@ ms.assetid: a8d2bf65-d8b1-4fe3-8340-a223d7e7fde6 > returning address of local variable or temporary +## Remarks + A function returns the address of a local variable or temporary object. Local variables and temporary objects are destroyed when a function returns, so the address returned is not valid. Redesign the function so that it does not return the address of a local object. +## Example + The following sample generates C4172: ```cpp From dadf77144a4a85ccf671a7b7dfd6db52d94aaa7e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 18:23:23 +0800 Subject: [PATCH 0130/1799] Tweak example in C4172 warning reference --- .../compiler-warning-level-1-c4172.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md index 82155536f03..11be7a98ed8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md @@ -18,16 +18,18 @@ Redesign the function so that it does not return the address of a local object. ## Example -The following sample generates C4172: +The following example generates C4172: ```cpp // C4172.cpp -// compile with: /W1 /LD -float f = 10; - -const double& bar() { -// try the following line instead -// const float& bar() { - return f; // C4172 +// compile with: /c /W1 +float f = 1.f; + +const double& func() +// Try one of the following lines instead: +// const float& func() +// const auto& func() +{ + return f; // C4172 } ``` From 10d9a37576ef8f22094047e67171fce990ac399a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 18:24:35 +0800 Subject: [PATCH 0131/1799] Update metadata in C4172 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4172.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md index 11be7a98ed8..e2e00b8b217 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4172" title: "Compiler Warning (level 1) C4172" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4172" +ms.date: 06/20/2025 f1_keywords: ["C4172"] helpviewer_keywords: ["C4172"] -ms.assetid: a8d2bf65-d8b1-4fe3-8340-a223d7e7fde6 --- # Compiler Warning (level 1) C4172 From aaceb8fcd2b9df131a3df5a0d2ee6ee76febab2f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 18:35:48 +0800 Subject: [PATCH 0132/1799] Remove rogue space within `AFX_MBV_DISPLAYONFOCUS` in `CFrameWnd` class reference --- docs/mfc/reference/cframewnd-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/reference/cframewnd-class.md b/docs/mfc/reference/cframewnd-class.md index c3d7b3aa2ba..670db48714c 100644 --- a/docs/mfc/reference/cframewnd-class.md +++ b/docs/mfc/reference/cframewnd-class.md @@ -511,7 +511,7 @@ This method returns one of the following values: - `AFX_MBV_DISPLAYONFOCUS` (0x02) - The menu is hidden by default. If the menu is hidden, press the ALT key to display the menu and give it the focus. If the menu is displayed, press the ALT or ESC key to hide it. -- `AFX_MBV_ DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10` (0x06) - The menu is hidden by default. If the menu is hidden, press the F10 key to display the menu and give it the focus. If the menu is displayed, press the F10 key to toggle the focus on or off the menu. The menu is displayed until you press the ALT or ESC key to hide it. +- `AFX_MBV_DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10` (0x06) - The menu is hidden by default. If the menu is hidden, press the F10 key to display the menu and give it the focus. If the menu is displayed, press the F10 key to toggle the focus on or off the menu. The menu is displayed until you press the ALT or ESC key to hide it. ### Remarks From 18833f2a085df19a9b92497b3812f6e6741b5f02 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 18:56:13 +0800 Subject: [PATCH 0133/1799] Remove some stray trailing backticks --- docs/build/open-folder-projects-cpp.md | 2 +- docs/mfc/reference/cmfcribboncategory-class.md | 2 +- docs/overview/cpp-conformance-improvements-2017.md | 6 +++--- docs/standard-library/iterator-functions.md | 4 ++-- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/build/open-folder-projects-cpp.md b/docs/build/open-folder-projects-cpp.md index dff693a6320..3613b081607 100644 --- a/docs/build/open-folder-projects-cpp.md +++ b/docs/build/open-folder-projects-cpp.md @@ -105,7 +105,7 @@ If you add the MinGW-W64 configuration, the JSON looks this: } ``` -Note the `environments` block. It defines properties that behave like environment variables and are available not only in the *CppProperties.json* file, but also in the other configuration files *task.vs.json* and *launch.vs.json*. The `Mingw64` configuration inherits the `mingw_w64` environment, and uses its `INCLUDE` property to specify the value for `includePath`. You can add other paths to this array property as needed.` +Note the `environments` block. It defines properties that behave like environment variables and are available not only in the *CppProperties.json* file, but also in the other configuration files *task.vs.json* and *launch.vs.json*. The `Mingw64` configuration inherits the `mingw_w64` environment, and uses its `INCLUDE` property to specify the value for `includePath`. You can add other paths to this array property as needed. The `intelliSenseMode` property is set to a value appropriate for GCC. For more information on all these properties, see [CppProperties schema reference](cppproperties-schema-reference.md). diff --git a/docs/mfc/reference/cmfcribboncategory-class.md b/docs/mfc/reference/cmfcribboncategory-class.md index 74d7ee56cb8..26b4f4e095f 100644 --- a/docs/mfc/reference/cmfcribboncategory-class.md +++ b/docs/mfc/reference/cmfcribboncategory-class.md @@ -99,7 +99,7 @@ The `CMFCRibbonTab` class draws ribbon categories. It is derived from [CMFCRibbo This following example demonstrates how to create a ribbon category and add a panel to it. ```cpp -// Create a new ribbon category and get a pointer to it` +// Create a new ribbon category and get a pointer to it CMFCRibbonCategory* pCategory = m_wndRibbonBar.AddCategory (_T("&Write"), // Category name IDB_WRITE, // Category small images (16 x 16) diff --git a/docs/overview/cpp-conformance-improvements-2017.md b/docs/overview/cpp-conformance-improvements-2017.md index 557e7983367..af33b89fb3f 100644 --- a/docs/overview/cpp-conformance-improvements-2017.md +++ b/docs/overview/cpp-conformance-improvements-2017.md @@ -465,7 +465,7 @@ int main() // understand C++ and uses BitBlt, which results in a double-free later. f(A()); // C4606 'A': passing argument by value across native and managed // boundary requires valid copy constructor. Otherwise, the runtime - // behavior is undefined.` + // behavior is undefined. } ``` @@ -1629,7 +1629,7 @@ The standard C++ attribute [`[[deprecated]]`](../cpp/attributes.md) may be used template using X = __declspec(deprecated("msg")) T; // C2760: syntax error: // unexpected token '__declspec', - // expected 'type specifier'` + // expected 'type specifier' ``` To fix the error, change to code to the following (with the attribute placed before the '=' of the alias definition): @@ -1678,7 +1678,7 @@ The following code now raises C4643: namespace std { template class vector; // C4643: Forward declaring 'vector' // in namespace std is not permitted - // by the C++ Standard` + // by the C++ Standard } ``` diff --git a/docs/standard-library/iterator-functions.md b/docs/standard-library/iterator-functions.md index 99b7df088fa..acfb82f5015 100644 --- a/docs/standard-library/iterator-functions.md +++ b/docs/standard-library/iterator-functions.md @@ -159,11 +159,11 @@ Retrieves an iterator to the first element in a specified container. ```cpp template -auto begin(Container& cont) ` +auto begin(Container& cont) -> decltype(cont.begin()); template -auto begin(const Container& cont) ` +auto begin(const Container& cont) -> decltype(cont.begin()); template From 31521da8ba7bf61e066c618f1eda31f29f63f642 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 20 Jun 2025 18:57:49 +0800 Subject: [PATCH 0134/1799] Update metadata in 3 topics --- docs/build/open-folder-projects-cpp.md | 5 ++--- docs/mfc/reference/cmfcribboncategory-class.md | 5 ++--- docs/standard-library/iterator-functions.md | 2 +- 3 files changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/build/open-folder-projects-cpp.md b/docs/build/open-folder-projects-cpp.md index 3613b081607..9d088cde29a 100644 --- a/docs/build/open-folder-projects-cpp.md +++ b/docs/build/open-folder-projects-cpp.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Open Folder support for C++ build systems in Visual Studio" title: "Open Folder support for C++ build systems in Visual Studio" -ms.date: "12/02/2019" +description: "Learn more about: Open Folder support for C++ build systems in Visual Studio" +ms.date: 12/02/2019 helpviewer_keywords: ["Open Folder Projects in Visual Studio"] -ms.assetid: abd1985e-3717-4338-9e80-869db5435175 --- # Open Folder support for C++ build systems in Visual Studio diff --git a/docs/mfc/reference/cmfcribboncategory-class.md b/docs/mfc/reference/cmfcribboncategory-class.md index 26b4f4e095f..c63b58d2c59 100644 --- a/docs/mfc/reference/cmfcribboncategory-class.md +++ b/docs/mfc/reference/cmfcribboncategory-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCRibbonCategory Class" title: "CMFCRibbonCategory Class" -ms.date: "11/19/2018" +description: "Learn more about: CMFCRibbonCategory Class" +ms.date: 11/19/2018 f1_keywords: ["CMFCRibbonCategory", "AFXRIBBONCATEGORY/CMFCRibbonCategory", "AFXRIBBONCATEGORY/CMFCRibbonCategory::CMFCRibbonCategory", "AFXRIBBONCATEGORY/CMFCRibbonCategory::AddHidden", "AFXRIBBONCATEGORY/CMFCRibbonCategory::AddPanel", "AFXRIBBONCATEGORY/CMFCRibbonCategory::CopyFrom", "AFXRIBBONCATEGORY/CMFCRibbonCategory::FindByData", "AFXRIBBONCATEGORY/CMFCRibbonCategory::FindByID", "AFXRIBBONCATEGORY/CMFCRibbonCategory::FindPanelWithElem", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetContextID", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetData", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetDroppedDown", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetElements", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetElementsByID", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetFirstVisibleElement", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetFocused", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetHighlighted", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetImageCount", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetImageSize", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetItemIDsList", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetLastVisibleElement", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetLargeImages", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetMaxHeight", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetName", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetPanel", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetPanelCount", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetPanelFromPoint", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetPanelIndex", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetParentButton", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetParentMenuBar", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetParentRibbonBar", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetRect", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetSmallImages", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetTabColor", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetTabRect", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetTextTopLine", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetVisibleElements", "AFXRIBBONCATEGORY/CMFCRibbonCategory::HighlightPanel", "AFXRIBBONCATEGORY/CMFCRibbonCategory::HitTest", "AFXRIBBONCATEGORY/CMFCRibbonCategory::HitTestEx", "AFXRIBBONCATEGORY/CMFCRibbonCategory::HitTestScrollButtons", "AFXRIBBONCATEGORY/CMFCRibbonCategory::IsActive", "AFXRIBBONCATEGORY/CMFCRibbonCategory::IsVisible", "AFXRIBBONCATEGORY/CMFCRibbonCategory::IsWindows7Look", "AFXRIBBONCATEGORY/CMFCRibbonCategory::NotifyControlCommand", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnCancelMode", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnDraw", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnDrawImage", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnDrawMenuBorder", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnKey", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnLButtonDown", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnLButtonUp", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnMouseMove", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnRTLChanged", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnScrollHorz", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnUpdateCmdUI", "AFXRIBBONCATEGORY/CMFCRibbonCategory::RecalcLayout", "AFXRIBBONCATEGORY/CMFCRibbonCategory::RemovePanel", "AFXRIBBONCATEGORY/CMFCRibbonCategory::ReposPanels", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetCollapseOrder", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetData", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetKeys", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetName", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetTabColor"] helpviewer_keywords: ["CMFCRibbonCategory [MFC], CMFCRibbonCategory", "CMFCRibbonCategory [MFC], AddHidden", "CMFCRibbonCategory [MFC], AddPanel", "CMFCRibbonCategory [MFC], CopyFrom", "CMFCRibbonCategory [MFC], FindByData", "CMFCRibbonCategory [MFC], FindByID", "CMFCRibbonCategory [MFC], FindPanelWithElem", "CMFCRibbonCategory [MFC], GetContextID", "CMFCRibbonCategory [MFC], GetData", "CMFCRibbonCategory [MFC], GetDroppedDown", "CMFCRibbonCategory [MFC], GetElements", "CMFCRibbonCategory [MFC], GetElementsByID", "CMFCRibbonCategory [MFC], GetFirstVisibleElement", "CMFCRibbonCategory [MFC], GetFocused", "CMFCRibbonCategory [MFC], GetHighlighted", "CMFCRibbonCategory [MFC], GetImageCount", "CMFCRibbonCategory [MFC], GetImageSize", "CMFCRibbonCategory [MFC], GetItemIDsList", "CMFCRibbonCategory [MFC], GetLastVisibleElement", "CMFCRibbonCategory [MFC], GetLargeImages", "CMFCRibbonCategory [MFC], GetMaxHeight", "CMFCRibbonCategory [MFC], GetName", "CMFCRibbonCategory [MFC], GetPanel", "CMFCRibbonCategory [MFC], GetPanelCount", "CMFCRibbonCategory [MFC], GetPanelFromPoint", "CMFCRibbonCategory [MFC], GetPanelIndex", "CMFCRibbonCategory [MFC], GetParentButton", "CMFCRibbonCategory [MFC], GetParentMenuBar", "CMFCRibbonCategory [MFC], GetParentRibbonBar", "CMFCRibbonCategory [MFC], GetRect", "CMFCRibbonCategory [MFC], GetSmallImages", "CMFCRibbonCategory [MFC], GetTabColor", "CMFCRibbonCategory [MFC], GetTabRect", "CMFCRibbonCategory [MFC], GetTextTopLine", "CMFCRibbonCategory [MFC], GetVisibleElements", "CMFCRibbonCategory [MFC], HighlightPanel", "CMFCRibbonCategory [MFC], HitTest", "CMFCRibbonCategory [MFC], HitTestEx", "CMFCRibbonCategory [MFC], HitTestScrollButtons", "CMFCRibbonCategory [MFC], IsActive", "CMFCRibbonCategory [MFC], IsVisible", "CMFCRibbonCategory [MFC], IsWindows7Look", "CMFCRibbonCategory [MFC], NotifyControlCommand", "CMFCRibbonCategory [MFC], OnCancelMode", "CMFCRibbonCategory [MFC], OnDraw", "CMFCRibbonCategory [MFC], OnDrawImage", "CMFCRibbonCategory [MFC], OnDrawMenuBorder", "CMFCRibbonCategory [MFC], OnKey", "CMFCRibbonCategory [MFC], OnLButtonDown", "CMFCRibbonCategory [MFC], OnLButtonUp", "CMFCRibbonCategory [MFC], OnMouseMove", "CMFCRibbonCategory [MFC], OnRTLChanged", "CMFCRibbonCategory [MFC], OnScrollHorz", "CMFCRibbonCategory [MFC], OnUpdateCmdUI", "CMFCRibbonCategory [MFC], RecalcLayout", "CMFCRibbonCategory [MFC], RemovePanel", "CMFCRibbonCategory [MFC], ReposPanels", "CMFCRibbonCategory [MFC], SetCollapseOrder", "CMFCRibbonCategory [MFC], SetData", "CMFCRibbonCategory [MFC], SetKeys", "CMFCRibbonCategory [MFC], SetName", "CMFCRibbonCategory [MFC], SetTabColor"] -ms.assetid: 99ba25b6-d060-4fdd-bfab-3c46c22981bb --- # CMFCRibbonCategory Class diff --git a/docs/standard-library/iterator-functions.md b/docs/standard-library/iterator-functions.md index acfb82f5015..e758db8a27e 100644 --- a/docs/standard-library/iterator-functions.md +++ b/docs/standard-library/iterator-functions.md @@ -1,7 +1,7 @@ --- title: " functions" description: "Learn more about: functions" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["xutility/std::advance", "xutility/std::back_inserter", "xutility/std::begin", "xutility/std::cbegin", "xutility/std::cend", "xutility/std::distance", "xutility/std::end", "xutility/std::front_inserter", "xutility/std::inserter", "xutility/std::make_checked_array_iterator", "xutility/std::make_move_iterator", "xutility/std::make_unchecked_array_iterator", "xutility/std::next", "xutility/std::prev"] helpviewer_keywords: ["std::advance [C++]", "std::back_inserter [C++]", "std::begin [C++]", "std::cbegin [C++]", "std::cend [C++]", "std::distance [C++]", "std::end [C++]", "std::front_inserter [C++]", "std::inserter [C++]", "std::make_checked_array_iterator [C++]", "std::make_move_iterator [C++]", "std::make_unchecked_array_iterator [C++]", "std::next [C++]", "std::prev [C++]"] --- From 929d024a7b7f5d0b8587c385a3bc95d203beed25 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 18:10:33 +0800 Subject: [PATCH 0135/1799] Add blockquotes for C2018 error message --- docs/error-messages/compiler-errors-1/compiler-error-c2018.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md index f81256fbfbf..6b8915a8ac2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md @@ -8,7 +8,7 @@ ms.assetid: 86b54573-dca0-4446-be1a-e3ac489c073b --- # Compiler Error C2018 -unknown character 'hexnumber' +> unknown character 'hexnumber' The source file contains an unexpected ASCII character, which is identified by its hex number. To resolve the error, remove the character. From a96e1620ff55a8fefe0a19c165375154ac90806f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 18:19:18 +0800 Subject: [PATCH 0136/1799] Add "Remarks" and "Example" headings in C2018 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2018.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md index 6b8915a8ac2..acf91f63543 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md @@ -10,8 +10,12 @@ ms.assetid: 86b54573-dca0-4446-be1a-e3ac489c073b > unknown character 'hexnumber' +## Remarks + The source file contains an unexpected ASCII character, which is identified by its hex number. To resolve the error, remove the character. +## Example + The following sample generates C2018: ```cpp From e7b3167b7a0c9f4b6b1eb88b6aeedf2806b490e3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 18:22:59 +0800 Subject: [PATCH 0137/1799] Tidy up example in C2018 error reference --- .../compiler-errors-1/compiler-error-c2018.md | 16 ++++------------ 1 file changed, 4 insertions(+), 12 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md index acf91f63543..fdc1ba78f09 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md @@ -16,20 +16,12 @@ The source file contains an unexpected ASCII character, which is identified by i ## Example -The following sample generates C2018: +The following example generates C2018: ```cpp // C2018.cpp -int main() { - @ // C2018 -} -``` - -Possible resolution: - -```cpp -// C2018b.cpp -int main() { - +int main() +{ + @ // C2018 } ``` From 0747a85af4163e078720a7dca249a2907894be48 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 18:24:04 +0800 Subject: [PATCH 0138/1799] Update metadata in C2018 error reference --- .../error-messages/compiler-errors-1/compiler-error-c2018.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md index fdc1ba78f09..16c19e66bfb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2018" title: "Compiler Error C2018" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2018" +ms.date: 06/21/2025 f1_keywords: ["C2018"] helpviewer_keywords: ["C2018"] -ms.assetid: 86b54573-dca0-4446-be1a-e3ac489c073b --- # Compiler Error C2018 From b240748a33a62eb511d69c1fd124cf0452f1ef7c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 19:01:19 +0800 Subject: [PATCH 0139/1799] Update `main` functions with omitted `int` return type --- docs/error-messages/compiler-errors-1/compiler-error-c2086.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4744.md | 2 +- docs/error-messages/tool-errors/math-error-m6111.md | 4 ++-- docs/intrinsics/debugbreak.md | 4 ++-- docs/parallel/openmp/a-examples.md | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md index 0041ca25136..794a6289d9f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md @@ -18,7 +18,7 @@ The following sample generates C2086: ```cpp // C2086.cpp -main() { +int main() { int a; int a; // C2086 not an error in ANSI C } diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md index 3c788f2d519..6b03b87956c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md @@ -37,7 +37,7 @@ The following sample generates C4744. extern unsigned global; -main() +int main() { printf_s("%d\n", global); } diff --git a/docs/error-messages/tool-errors/math-error-m6111.md b/docs/error-messages/tool-errors/math-error-m6111.md index 123e1601bee..f45115f71f0 100644 --- a/docs/error-messages/tool-errors/math-error-m6111.md +++ b/docs/error-messages/tool-errors/math-error-m6111.md @@ -14,9 +14,9 @@ A floating-point operation resulted in a stack underflow on the 8087/287/387 cop This error is often caused by a call to a **`long double`** function that does not return a value. For example, the following generates this error when compiled and run: -``` +```c long double ld() {}; -main () +int main () { ld(); } diff --git a/docs/intrinsics/debugbreak.md b/docs/intrinsics/debugbreak.md index 4b752926d38..0d54280e152 100644 --- a/docs/intrinsics/debugbreak.md +++ b/docs/intrinsics/debugbreak.md @@ -34,7 +34,7 @@ The `__debugbreak` compiler intrinsic, similar to [DebugBreak](/windows/win32/ap For example: ```C -main() { +int main() { __debugbreak(); } ``` @@ -42,7 +42,7 @@ main() { is similar to: ```C -main() { +int main() { __asm { int 3 } diff --git a/docs/parallel/openmp/a-examples.md b/docs/parallel/openmp/a-examples.md index dabdf0bc972..7bfdac26897 100644 --- a/docs/parallel/openmp/a-examples.md +++ b/docs/parallel/openmp/a-examples.md @@ -854,7 +854,7 @@ The following example demonstrates the [num_threads](2-directives.md#23-parallel ```cpp #include -main() +int main() { omp_set_dynamic(1); ... From 02f7e73a8f3551c912cfc56a0b6de92dfa32a66e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 19:02:33 +0800 Subject: [PATCH 0140/1799] Update metadata for 5 topics --- .../error-messages/compiler-errors-1/compiler-error-c2086.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4744.md | 5 ++--- docs/error-messages/tool-errors/math-error-m6111.md | 5 ++--- docs/intrinsics/debugbreak.md | 5 ++--- docs/parallel/openmp/a-examples.md | 5 ++--- 5 files changed, 10 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md index 794a6289d9f..25867e1a3e7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2086" title: "Compiler Error C2086" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2086" +ms.date: 11/04/2016 f1_keywords: ["C2086"] helpviewer_keywords: ["C2086"] -ms.assetid: 4329bf72-90c8-444c-8524-4ef75e6b2139 --- # Compiler Error C2086 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md index 6b03b87956c..d8c6e56aafc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4744" title: "Compiler Warning (Level 1) C4744" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4744" +ms.date: 11/04/2016 f1_keywords: ["C4744"] helpviewer_keywords: ["C4744"] -ms.assetid: f2a7d0b5-afd5-4926-abc3-cfbd367e3ff5 --- # Compiler Warning (Level 1) C4744 diff --git a/docs/error-messages/tool-errors/math-error-m6111.md b/docs/error-messages/tool-errors/math-error-m6111.md index f45115f71f0..c007fdb395c 100644 --- a/docs/error-messages/tool-errors/math-error-m6111.md +++ b/docs/error-messages/tool-errors/math-error-m6111.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6111" title: "Math Error M6111" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6111" +ms.date: 11/04/2016 f1_keywords: ["M6111"] helpviewer_keywords: ["M6111"] -ms.assetid: c0fc13f8-33c8-4e3f-a440-126cc623441b --- # Math Error M6111 diff --git a/docs/intrinsics/debugbreak.md b/docs/intrinsics/debugbreak.md index 0d54280e152..ed576d932d1 100644 --- a/docs/intrinsics/debugbreak.md +++ b/docs/intrinsics/debugbreak.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: __debugbreak" title: "__debugbreak" -ms.date: "09/02/2019" +description: "Learn more about: __debugbreak" +ms.date: 09/02/2019 f1_keywords: ["__debugbreak_cpp", "__debugbreak"] helpviewer_keywords: ["breakpoints, __debugbreak intrinsic", "__debugbreak intrinsic"] -ms.assetid: 1d1e1c0c-891a-4613-ae4b-d790094ba830 --- # __debugbreak diff --git a/docs/parallel/openmp/a-examples.md b/docs/parallel/openmp/a-examples.md index 7bfdac26897..43499f5d100 100644 --- a/docs/parallel/openmp/a-examples.md +++ b/docs/parallel/openmp/a-examples.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: A. Examples" title: "A. Examples" -ms.date: "01/18/2019" -ms.assetid: c0f6192f-a205-449b-b84c-cb30dbcc8b8f +description: "Learn more about: A. Examples" +ms.date: 01/18/2019 --- # A. Examples From 237718a9dbdf9c8be079ceb14698b97d457445f7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 22:29:59 +0800 Subject: [PATCH 0141/1799] Fix mistakes in `.openpublishing.redirection.json` --- .openpublishing.redirection.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index e6910b59221..dc663314250 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -21,7 +21,7 @@ "redirect_document_id": true }, { - "source_path": "docs/supported-platforms-visual-cpp.md.md", + "source_path": "docs/supported-platforms-visual-cpp.md", "redirect_url": "/cpp/overview/supported-platforms-visual-cpp", "redirect_document_id": true }, @@ -7436,7 +7436,7 @@ "redirect_document_id": false }, { - "source_path": "docs/dotnet/how-to-enumerate-data-types-in-assemblies-using-reflection-cpp-cli.md.md", + "source_path": "docs/dotnet/how-to-enumerate-data-types-in-assemblies-using-reflection-cpp-cli.md", "redirect_url": "/cpp/dotnet/reflection-cpp-cli#enumerate", "redirect_document_id": false }, @@ -13752,12 +13752,12 @@ }, { "source_path": "docs/c-runtime-library/operator-delete-crt.md", - "redirect_url": "docs/c-runtime-library/delete-operator-crt", + "redirect_url": "/cpp/c-runtime-library/delete-operator-crt", "redirect_document_id": false }, { "source_path": "docs/c-runtime-library/operator-new-crt.md", - "redirect_url": "docs/c-runtime-library/new-operator-crt", + "redirect_url": "/cpp/c-runtime-library/new-operator-crt", "redirect_document_id": false }, { From a3c0eafe85a506315ef40ead53b4fd49819c033f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 23:08:12 +0800 Subject: [PATCH 0142/1799] Trim excess leading space in headings --- docs/atl/reference/ccomdynamicunkarray-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/atl/reference/ccomdynamicunkarray-class.md b/docs/atl/reference/ccomdynamicunkarray-class.md index 0c0f142ee65..86b175f34c2 100644 --- a/docs/atl/reference/ccomdynamicunkarray-class.md +++ b/docs/atl/reference/ccomdynamicunkarray-class.md @@ -194,7 +194,7 @@ int GetSize() const; The number of elements the array can store. `GetSize() == end() - begin()`. -## CComDynamicUnkArray::GetUnknown +## CComDynamicUnkArray::GetUnknown Call this method to get the `IUnknown` pointer associated with a given cookie. From 204525fcba2965753864dbd054f1706ba24abfd9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 23:32:32 +0800 Subject: [PATCH 0143/1799] Trim excess middle space in headings --- docs/atl/reference/catltransactionmanager-class.md | 2 +- docs/build/cmake-presets-vs.md | 4 ++-- docs/c-runtime-library/reference/itoa-s-itow-s.md | 2 +- docs/code-quality/c26433.md | 2 +- docs/cpp/basic-concepts-cpp.md | 2 +- docs/cpp/functions-with-variable-argument-lists-cpp.md | 2 +- docs/cppcx/platform-stringreference-class.md | 2 +- docs/data/catalog-information-mfc-data-access.md | 2 +- ...u-might-make-to-the-default-code-mfc-data-access.md | 2 +- ...nd-handlers-for-record-scrolling-mfc-data-access.md | 2 +- .../data-exchange-for-record-views-mfc-data-access.md | 2 +- ...gning-and-creating-a-record-view-mfc-data-access.md | 2 +- .../features-of-record-view-classes-mfc-data-access.md | 2 +- ...list-box-from-a-second-recordset-mfc-data-access.md | 2 +- ...l-customizing-your-recordsets-sql-statement-odbc.md | 10 +++++----- ...de-created-by-application-wizard-mfc-data-access.md | 2 +- docs/data/record-views-mfc-data-access.md | 2 +- docs/data/schema-mfc-data-access.md | 2 +- ...ting-navigation-in-a-record-view-mfc-data-access.md | 2 +- docs/data/transactions-mfc-data-access.md | 2 +- ...erface-updating-for-record-views-mfc-data-access.md | 2 +- docs/data/using-a-record-view-mfc-data-access.md | 2 +- ...le-in-working-with-a-record-view-mfc-data-access.md | 2 +- docs/extensions/abstract-cpp-component-extensions.md | 2 +- ...tribute-parameter-types-cpp-component-extensions.md | 2 +- docs/extensions/boxing-cpp-component-extensions.md | 2 +- .../classes-and-structs-cpp-component-extensions.md | 2 +- ...text-sensitive-keywords-cpp-component-extensions.md | 2 +- docs/extensions/delegate-cpp-component-extensions.md | 2 +- docs/extensions/enum-class-cpp-component-extensions.md | 2 +- .../exception-handling-cpp-component-extensions.md | 2 +- .../explicit-overrides-cpp-component-extensions.md | 2 +- docs/extensions/generics-cpp-component-extensions.md | 2 +- ...-to-object-operator-hat-cpp-component-extensions.md | 2 +- .../interface-class-cpp-component-extensions.md | 2 +- .../new-new-slot-in-vtable-cpp-component-extensions.md | 2 +- docs/extensions/nullptr-cpp-component-extensions.md | 2 +- docs/extensions/override-cpp-component-extensions.md | 2 +- .../override-specifiers-cpp-component-extensions.md | 2 +- docs/extensions/partial-cpp-component-extensions.md | 2 +- ...ault-and-cli-namespaces-cpp-component-extensions.md | 2 +- .../ref-new-gcnew-cpp-component-extensions.md | 2 +- docs/extensions/sealed-cpp-component-extensions.md | 2 +- docs/extensions/string-cpp-component-extensions.md | 2 +- docs/extensions/typeid-cpp-component-extensions.md | 2 +- ...user-defined-attributes-cpp-component-extensions.md | 2 +- docs/parallel/amp/reference/runtime-exception-class.md | 2 +- ...exception-handling-to-break-from-a-parallel-loop.md | 2 +- docs/sanitizers/error-stack-buffer-underflow.md | 2 +- docs/standard-library/drop-view-class.md | 2 +- docs/standard-library/elements-view-class.md | 2 +- docs/standard-library/hash-map-operators.md | 2 +- docs/standard-library/keys-view-class.md | 2 +- docs/standard-library/recursive-mutex-class.md | 2 +- docs/standard-library/recursive-timed-mutex-class.md | 2 +- docs/standard-library/unique-lock-class.md | 2 +- docs/windows/latest-supported-vc-redist.md | 4 ++-- 57 files changed, 63 insertions(+), 63 deletions(-) diff --git a/docs/atl/reference/catltransactionmanager-class.md b/docs/atl/reference/catltransactionmanager-class.md index 3b7a42f2746..d83a689a72a 100644 --- a/docs/atl/reference/catltransactionmanager-class.md +++ b/docs/atl/reference/catltransactionmanager-class.md @@ -66,7 +66,7 @@ class CAtlTransactionManager; **Header:** atltransactionmanager.h -## ~CAtlTransactionManager +## ~CAtlTransactionManager CAtlTransactionManager destructor. diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index 8aface6d9bc..d2d2f03f8a6 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -19,7 +19,7 @@ This article contains information about *`CMakePresets.json`* integration with V We recommend *`CMakePresets.json`* as an alternative to *`CMakeSettings.json`*. Visual Studio never reads from both *`CMakePresets.json`* and *`CMakeSettings.json`* at the same time. To enable or disable *`CMakePresets.json`* integration in Visual Studio, see [Enable `CMakePresets.json` in Visual Studio 2019](#enable-cmakepresets-json-integration). -## Supported CMake and *`CMakePresets.json`* versions +## Supported CMake and *`CMakePresets.json`* versions The supported *`CMakePresets.json`* and *`CMakeUserPresets.json`* schema versions depend on your version of Visual Studio: - Visual Studio 2019 version 16.10 and later support schema versions 2 and 3. @@ -391,7 +391,7 @@ Instead, set the path to `vcpkg.cmake` by using the `VCPKG_ROOT` environment var If you're already using a CMake toolchain file and want to enable vcpkg integration, see [Using multiple toolchain files](/vcpkg/users/buildsystems/cmake-integration#using-multiple-toolchain-files). Follow those instructions to use an external toolchain file with a project by using vcpkg. -## Variable substitution in *`launch.vs.json`* and *`tasks.vs.json`* +## Variable substitution in *`launch.vs.json`* and *`tasks.vs.json`* *`CMakePresets.json`* supports variable substitution in *`launch.vs.json`* and *`tasks.vs.json`*. Here are some considerations: diff --git a/docs/c-runtime-library/reference/itoa-s-itow-s.md b/docs/c-runtime-library/reference/itoa-s-itow-s.md index bd52ce7408a..7fd482765bc 100644 --- a/docs/c-runtime-library/reference/itoa-s-itow-s.md +++ b/docs/c-runtime-library/reference/itoa-s-itow-s.md @@ -10,7 +10,7 @@ f1_keywords: ["_itoa_s", "_ltoa_s", "_ultoa_s", "_i64toa_s", "_ui64toa_s", "_ito helpviewer_keywords: ["_ui64toa_s function", "_itow_s function", "_i64tow_s function", "_itot_s function", "converting integers", "itow_s function", "i64toa_s function", "_ui64tow_s function", "integers, converting", "_i64tot_s function", "itoa_s function", "_itoa_s function", "ui64toa_s function", "i64tow_s function", "converting numbers, to strings", "_ui64tot_s function", "_i64toa_s function"] ms.assetid: eb746581-bff3-48b5-a973-bfc0a4478ecf --- -# `_itoa_s`, `_ltoa_s`, `_ultoa_s`, `_i64toa_s`, `_ui64toa_s`, `_itow_s`, `_ltow_s`, `_ultow_s`, `_i64tow_s`, `_ui64tow_s` +# `_itoa_s`, `_ltoa_s`, `_ultoa_s`, `_i64toa_s`, `_ui64toa_s`, `_itow_s`, `_ltow_s`, `_ultow_s`, `_i64tow_s`, `_ui64tow_s` Converts an integer to a string. These functions are versions of the [`_itoa`, `_itow` functions](itoa-itow.md) with security enhancements as described in [Security features in the CRT](../security-features-in-the-crt.md). diff --git a/docs/code-quality/c26433.md b/docs/code-quality/c26433.md index ed350b445d3..fe61915f6cd 100644 --- a/docs/code-quality/c26433.md +++ b/docs/code-quality/c26433.md @@ -25,7 +25,7 @@ Warnings show up on function definitions, not declarations. It may be confusing, Code analysis name: `OVERRIDE_EXPLICITLY` -## Example: Implicit overriding +## Example: Implicit overriding ```cpp class Shape { diff --git a/docs/cpp/basic-concepts-cpp.md b/docs/cpp/basic-concepts-cpp.md index 7102a6a9f74..1828bb2fd8e 100644 --- a/docs/cpp/basic-concepts-cpp.md +++ b/docs/cpp/basic-concepts-cpp.md @@ -6,7 +6,7 @@ ms.date: "12/11/2019" helpviewer_keywords: ["C++, basic language concepts"] ms.assetid: 961801e6-2ffd-4bf1-bb71-7f55e48d9c79 --- -# Basic Concepts (C++) +# Basic Concepts (C++) This section explains concepts that are critical to understanding C++. C programmers will be familiar with many of these concepts, but there are some subtle differences that can cause unexpected program results. The following topics are included: diff --git a/docs/cpp/functions-with-variable-argument-lists-cpp.md b/docs/cpp/functions-with-variable-argument-lists-cpp.md index 9ded375dbc1..fc382629e74 100644 --- a/docs/cpp/functions-with-variable-argument-lists-cpp.md +++ b/docs/cpp/functions-with-variable-argument-lists-cpp.md @@ -4,7 +4,7 @@ title: "Functions with Variable Argument Lists (C++)" ms.date: 05/01/2025 helpviewer_keywords: ["arguments [C++], variable number of", "variable argument lists", "declarators, functions", "argument lists [C++], variable number of", "declaring functions [C++], variables", "function calls, variable number of arguments"] --- -# Functions with Variable Argument Lists (C++) +# Functions with Variable Argument Lists (C++) Function declarations that have ellipsis (...) as the last argument take a variable number of arguments. C++ provides type checking only for the explicitly declared arguments. You can use variable argument lists when the number and types of arguments to the function can vary. The `printf` family of functions is an example of functions that have variable argument lists. diff --git a/docs/cppcx/platform-stringreference-class.md b/docs/cppcx/platform-stringreference-class.md index 6b6a0663076..b22b6cf0059 100644 --- a/docs/cppcx/platform-stringreference-class.md +++ b/docs/cppcx/platform-stringreference-class.md @@ -140,7 +140,7 @@ A reference to an object of type `StringReference`. Because `StringReference` is a standard C++ class and not a ref class, it does not appear in the **Object Browser**. -## StringReference::operator() Operator +## StringReference::operator() Operator Converts a `StringReference` object to a `Platform::String^` object. diff --git a/docs/data/catalog-information-mfc-data-access.md b/docs/data/catalog-information-mfc-data-access.md index 6935e8ae313..9ffa4c72ac0 100644 --- a/docs/data/catalog-information-mfc-data-access.md +++ b/docs/data/catalog-information-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["tables [C++], catalog information", "tables [C++]", "ODBC [C++], catalog information", "catalog information database [C++]", "databases [C++], catalog information database"] ms.assetid: c184e80f-ff17-409f-9df8-05275080bb8d --- -# Catalog Information (MFC Data Access) +# Catalog Information (MFC Data Access) Information about the tables in a data source can include the names of tables and the columns in them, table privileges, names of primary and foreign keys, information about predefined queries or stored procedures, information about indexes on tables, and statistics about tables. diff --git a/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md b/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md index d524c7ae40c..c8729444628 100644 --- a/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md +++ b/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md @@ -4,7 +4,7 @@ description: "Learn more about: Changes You Might Make to the Default Code (MFC ms.date: "11/04/2016" helpviewer_keywords: ["record views [C++], customizing default code"] --- -# Changes You Might Make to the Default Code (MFC Data Access) +# Changes You Might Make to the Default Code (MFC Data Access) The [MFC Application Wizard](../mfc/reference/database-support-mfc-application-wizard.md) writes a recordset class for you that selects all records in a single table. You will often want to modify that behavior in one or more of the following ways: diff --git a/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md b/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md index 62d9a45c139..56f7b94474d 100644 --- a/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md +++ b/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["record views [C++], scrolling", "record scrolling [C++]", "scrolling records"] ms.assetid: f8b13477-2a37-459e-a30c-806fb78165ac --- -# Command Handlers for Record Scrolling (MFC Data Access) +# Command Handlers for Record Scrolling (MFC Data Access) The [CRecordView](../mfc/reference/crecordview-class.md) class provides default command handling for the following standard commands: diff --git a/docs/data/data-exchange-for-record-views-mfc-data-access.md b/docs/data/data-exchange-for-record-views-mfc-data-access.md index 08307d190cf..b278bc389bf 100644 --- a/docs/data/data-exchange-for-record-views-mfc-data-access.md +++ b/docs/data/data-exchange-for-record-views-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/19/2018" helpviewer_keywords: ["RFX (record field exchange), data exchange mechanism", "RFX (record field exchange), record views", "record views, data exchange", "DDX (dialog data exchange), record views", "RFX (record field exchange)"] ms.assetid: abc52ca7-6997-47a7-98f3-f347f52b1f72 --- -# Data Exchange for Record Views (MFC Data Access) +# Data Exchange for Record Views (MFC Data Access) When you use [Add Class](../mfc/reference/adding-an-mfc-odbc-consumer.md) to map the controls in a record view's dialog template resource to the fields of a recordset, the framework manages data exchange in both directions — from recordset to controls and from controls to recordset. Using the DDX mechanism means that you do not have to write the code to transfer data back and forth yourself. diff --git a/docs/data/designing-and-creating-a-record-view-mfc-data-access.md b/docs/data/designing-and-creating-a-record-view-mfc-data-access.md index aa747752af9..67366770fab 100644 --- a/docs/data/designing-and-creating-a-record-view-mfc-data-access.md +++ b/docs/data/designing-and-creating-a-record-view-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["designing forms", "record views, creating", "forms [C++], designing", "record views, designing", "application wizards [C++], creating record view classes", "designing record views"] ms.assetid: 1d6f5439-754f-4b8b-a19d-841a4657827b --- -# Designing and Creating a Record View (MFC Data Access) +# Designing and Creating a Record View (MFC Data Access) You can create your record view class with the [MFC Application Wizard](../mfc/reference/database-support-mfc-application-wizard.md). If you use an application wizard, it creates the record view class and a dialog template resource for it (without controls). You must use the Visual C++ Dialog editor to add controls to the dialog template resource. On the other hand, if you use **Add Class**, you must first create the dialog template resource in the Dialog editor and then create the record view class. diff --git a/docs/data/features-of-record-view-classes-mfc-data-access.md b/docs/data/features-of-record-view-classes-mfc-data-access.md index 0f19f101bda..5ee9adfcccb 100644 --- a/docs/data/features-of-record-view-classes-mfc-data-access.md +++ b/docs/data/features-of-record-view-classes-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["record views, classes", "record view classes"] ms.assetid: e7b2820f-09c4-483f-83c0-317e8be42bdf --- -# Features of Record View Classes (MFC Data Access) +# Features of Record View Classes (MFC Data Access) You can do form-based data-access programming with class [CFormView](../mfc/reference/cformview-class.md), but [CRecordView](../mfc/reference/crecordview-class.md) is generally a better class to derive from. In addition to its `CFormView` features, `CRecordView`: diff --git a/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md b/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md index 78104b47fc8..3bc7f9fb76b 100644 --- a/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md +++ b/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["record views, filling list boxes", "list boxes, filling from second recordset", "recordsets [C++], filling list boxes or combo boxes", "CComboBox class, filling object from second rowset", "ODBC recordsets [C++], filling list boxes or combo boxes", "combo boxes [C++], filling from second recordset", "CListCtrl class, filling from second recordset"] ms.assetid: 360c0834-da6b-4dc0-bcea-80e9acd611f0 --- -# Filling a List Box from a Second Recordset (MFC Data Access) +# Filling a List Box from a Second Recordset (MFC Data Access) By default, a record view is associated with a single recordset object, whose fields are mapped to the record view's controls. Sometimes you might want to put a list box or combo box control in your record view and fill it with values from a second recordset object. The user can use the list box to select a new category of information to display in the record view. This topic explains how and when to do that. diff --git a/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md b/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md index c8f798aa6f0..95cd9063cfb 100644 --- a/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md +++ b/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md @@ -82,11 +82,11 @@ The following table shows the possibilities for the *lpszSQL* parameter to `Open \* `m_nFields` must be less than or equal to the number of columns specified in the **SELECT** statement. The data type of each column specified in the **SELECT** statement must be the same as the data type of the corresponding RFX output column. -### Case 1 lpszSQL = NULL +### Case 1 lpszSQL = NULL The recordset selection depends on what `GetDefaultSQL` returns when `CRecordset::Open` calls it. Cases 2 through 5 describe the possible strings. -### Case 2 lpszSQL = a Table Name +### Case 2 lpszSQL = a Table Name The recordset uses record field exchange (RFX) to build the column list from the column names provided in the RFX function calls in the recordset class's override of `DoFieldExchange`. If you used a wizard to declare your recordset class, this case has the same result as case 1 (provided that you pass the same table name you specified in the wizard). If you do not use a wizard to write your class, case 2 is the simplest way to construct the SQL statement. @@ -120,7 +120,7 @@ SELECT CourseID, InstructorID, RoomNo, Schedule, SectionNo FROM SECTION ``` -### Case 3 lpszSQL = a SELECT/FROM Statement +### Case 3 lpszSQL = a SELECT/FROM Statement You specify the column list by hand rather than relying on RFX to construct it automatically. You might want to do this when: @@ -138,11 +138,11 @@ You specify the column list by hand rather than relying on RFX to construct it a For information and an example, see [Recordset: Performing a Join (ODBC)](../../data/odbc/recordset-performing-a-join-odbc.md). -### Case 4 lpszSQL = SELECT/FROM Plus WHERE and/or ORDER BY +### Case 4 lpszSQL = SELECT/FROM Plus WHERE and/or ORDER BY You specify everything: the column list (based on the RFX calls in `DoFieldExchange`), the table list, and the contents of a **WHERE** and/or an **ORDER BY** clause. If you specify your **WHERE** and/or **ORDER BY** clauses this way, do not use `m_strFilter` and/or `m_strSort`. -### Case 5 lpszSQL = a Stored Procedure Call +### Case 5 lpszSQL = a Stored Procedure Call If you need to call a predefined query (such as a stored procedure in a Microsoft SQL Server database), you must write a **CALL** statement in the string you pass to *lpszSQL*. The wizards do not support declaring a recordset class for calling a predefined query. Not all predefined queries return records. diff --git a/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md b/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md index 73e90f63211..2229758c645 100644 --- a/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md +++ b/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["application wizards [C++], record view code", "record views, refreshing controls", "record views, application wizard code"] ms.assetid: 18fd4703-5939-491d-b759-985f767b951f --- -# Record View Code Created by Application Wizard (MFC Data Access) +# Record View Code Created by Application Wizard (MFC Data Access) The [MFC Application Wizard](../mfc/reference/database-support-mfc-application-wizard.md) overrides the view's `OnInitialUpdate` and `OnGetRecordset` member functions. After the framework creates the frame window, document, and view, it calls `OnInitialUpdate` to initialize the view. `OnInitialUpdate` obtains a pointer to the recordset from the document. A call to the base class [CView::OnInitialUpdate](../mfc/reference/cview-class.md#oninitialupdate) function opens the recordset. The following code shows this process for a `CRecordView`: diff --git a/docs/data/record-views-mfc-data-access.md b/docs/data/record-views-mfc-data-access.md index d6ad32f05e2..d73f2ef4598 100644 --- a/docs/data/record-views-mfc-data-access.md +++ b/docs/data/record-views-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["MFC [C++], record views", "ODBC recordsets [C++], record views", "databases [C++], record views", "record views [C++]", "forms [C++], data access tasks"] ms.assetid: 562122d9-01d8-4284-acf6-ea109ab0408d --- -# Record Views (MFC Data Access) +# Record Views (MFC Data Access) This section applies only to the MFC ODBC classes. For information about OLE DB record views, see [COleDBRecordView](../mfc/reference/coledbrecordview-class.md) and [Using OLE DB Record Views](../data/oledb/using-ole-db-record-views.md). diff --git a/docs/data/schema-mfc-data-access.md b/docs/data/schema-mfc-data-access.md index c45bdeb2bc5..84b98de5b3e 100644 --- a/docs/data/schema-mfc-data-access.md +++ b/docs/data/schema-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["structures [C++], database", "databases [C++], schema", "database schema [C++], about database schemas", "database schema [C++]", "schemas [C++], database", "structures [C++]"] ms.assetid: 7d17e35f-1ccf-4853-b915-5b8c7a45b9ee --- -# Schema (MFC Data Access) +# Schema (MFC Data Access) A database schema describes the current structure of the tables and database views in the database. In general, wizard-generated code assumes that the schema for the table or tables accessed by a recordset will not change, but the database classes can deal with some schema changes, such as adding, reordering, or deleting unbound columns. If a table changes, you must manually update the recordset for the table, then recompile your application. diff --git a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md index df688530ed2..b61b4e34801 100644 --- a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md +++ b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["records [C++], navigating", "record views, navigation", "navigation [C++], in record view"] ms.assetid: 227f2a6d-87c9-4656-807a-8e246965bcce --- -# Supporting Navigation in a Record View (MFC Data Access) +# Supporting Navigation in a Record View (MFC Data Access) This topic explains how to support movement from record to record in your [CRecordView](../mfc/reference/crecordview-class.md) class, including information about: diff --git a/docs/data/transactions-mfc-data-access.md b/docs/data/transactions-mfc-data-access.md index b9008f382a7..c0dcf6a133a 100644 --- a/docs/data/transactions-mfc-data-access.md +++ b/docs/data/transactions-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["transactions [C++], support for", "transactions [C++]", "databases [C++], transactions"] ms.assetid: f80afbfe-1517-4fec-8870-9ffc70a58b05 --- -# Transactions (MFC Data Access) +# Transactions (MFC Data Access) The concept of a transaction was developed to handle cases in which the resulting state of the database depends on the total success of a series of operations. This could come about because successive operations might modify the results of previous operations. In such cases, if any one operation fails, the resulting state could be indeterminate. diff --git a/docs/data/user-interface-updating-for-record-views-mfc-data-access.md b/docs/data/user-interface-updating-for-record-views-mfc-data-access.md index 5e489fd9018..48c65f5c929 100644 --- a/docs/data/user-interface-updating-for-record-views-mfc-data-access.md +++ b/docs/data/user-interface-updating-for-record-views-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["user interfaces, updating", "menus, updating as context changes", "record views, user interface"] ms.assetid: 2c7914b6-2dc3-40c3-b2f2-8371da2a4063 --- -# User-Interface Updating for Record Views (MFC Data Access) +# User-Interface Updating for Record Views (MFC Data Access) `CRecordView` provides default user-interface update handlers for the navigation commands. These handlers automate enabling and disabling the user-interface objects — menu items and toolbar buttons. The application wizard supplies standard menus and, if you choose the **Dockable Toolbar** option, a set of toolbar buttons for the commands. If you create a record view class using `CRecordView`, you might want to add similar user-interface objects to your application. diff --git a/docs/data/using-a-record-view-mfc-data-access.md b/docs/data/using-a-record-view-mfc-data-access.md index 18724bc75b9..85128e40ed1 100644 --- a/docs/data/using-a-record-view-mfc-data-access.md +++ b/docs/data/using-a-record-view-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["record views, customizing default code"] ms.assetid: 91f2828f-0666-4273-ae28-e4703fd98521 --- -# Using a Record View (MFC Data Access) +# Using a Record View (MFC Data Access) This topic explains how you might commonly customize the default code for record views that the wizard writes for you. Typically, you want to constrain the record selection with a [filter](../data/odbc/recordset-filtering-records-odbc.md) or [parameters](../data/odbc/recordset-parameterizing-a-recordset-odbc.md), perhaps [sort](../data/odbc/recordset-sorting-records-odbc.md) the records, customize the SQL statement. diff --git a/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md b/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md index be06ed8b285..990f6b94339 100644 --- a/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md +++ b/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["record views, customizing default code", "MFC, record views"] ms.assetid: 691e89a5-ff21-4ca3-9278-69d4678288bb --- -# Your Role in Working with a Record View (MFC Data Access) +# Your Role in Working with a Record View (MFC Data Access) The following table shows what you typically must do to work with a record view and what the framework does for you. diff --git a/docs/extensions/abstract-cpp-component-extensions.md b/docs/extensions/abstract-cpp-component-extensions.md index 54e681d6cf9..3f8be404e9e 100644 --- a/docs/extensions/abstract-cpp-component-extensions.md +++ b/docs/extensions/abstract-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["abstract", "abstract_cpp"] helpviewer_keywords: ["abstract keyword [C++]"] ms.assetid: cbae3408-0378-4ac8-b70d-c016b381a6d5 --- -# abstract (C++/CLI and C++/CX) +# abstract (C++/CLI and C++/CX) The **abstract** keyword declares either: diff --git a/docs/extensions/attribute-parameter-types-cpp-component-extensions.md b/docs/extensions/attribute-parameter-types-cpp-component-extensions.md index fd508895ddc..afefe6bff4f 100644 --- a/docs/extensions/attribute-parameter-types-cpp-component-extensions.md +++ b/docs/extensions/attribute-parameter-types-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["custom attributes, parameter types"] ms.assetid: d9f127a3-7f08-456f-acc6-256805632712 --- -# Attribute Parameter Types (C++/CLI and C++/CX) +# Attribute Parameter Types (C++/CLI and C++/CX) Values passed to attributes must be known to the compiler at compile time. Attribute parameters can be of the following types: diff --git a/docs/extensions/boxing-cpp-component-extensions.md b/docs/extensions/boxing-cpp-component-extensions.md index 6de754d4753..ae6c35f9660 100644 --- a/docs/extensions/boxing-cpp-component-extensions.md +++ b/docs/extensions/boxing-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["boxing, C++"] ms.assetid: b5fd2c98-c578-4f83-8257-6dd663478665 --- -# Boxing (C++/CLI and C++/CX) +# Boxing (C++/CLI and C++/CX) The conversion of value types to objects is called *boxing*, and the conversion of objects to value types is called *unboxing*. diff --git a/docs/extensions/classes-and-structs-cpp-component-extensions.md b/docs/extensions/classes-and-structs-cpp-component-extensions.md index 7f1310a5b73..14e42972b17 100644 --- a/docs/extensions/classes-and-structs-cpp-component-extensions.md +++ b/docs/extensions/classes-and-structs-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["ref class", "value class", "ref struct", "value struct",] helpviewer_keywords: ["ref class keyword [C++]", "value class keyword [C++]", "value struct keyword [C++]", "ref struct keyword [C++]"] ms.assetid: 5c360764-b229-49c6-9357-66213afbc372 --- -# ref class and ref struct (C++/CLI and C++/CX) +# ref class and ref struct (C++/CLI and C++/CX) The **ref class** or **ref struct** extensions declare a class or struct whose *object lifetime* is administered automatically. When the object is no longer accessible or goes out of scope, the memory is released. diff --git a/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md b/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md index 443571ea5e2..e4621bce19a 100644 --- a/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md +++ b/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["internal_CPP"] helpviewer_keywords: ["context-sensitive keywords"] ms.assetid: e33da089-f434-44e9-8cce-4668d05a8939 --- -# Context-Sensitive Keywords (C++/CLI and C++/CX) +# Context-Sensitive Keywords (C++/CLI and C++/CX) *Context-sensitive keywords* are language elements that are recognized only in specific contexts. Outside the specific context, a context-sensitive keyword can be a user-defined symbol. diff --git a/docs/extensions/delegate-cpp-component-extensions.md b/docs/extensions/delegate-cpp-component-extensions.md index 127af663e74..90496b3951b 100644 --- a/docs/extensions/delegate-cpp-component-extensions.md +++ b/docs/extensions/delegate-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["delegate_cpp", "delegate"] helpviewer_keywords: ["delegate keyword [C++]"] ms.assetid: 03caf23d-7873-4a23-9b34-becf42aaf429 --- -# delegate (C++/CLI and C++/CX) +# delegate (C++/CLI and C++/CX) Declares a type that represents a function pointer. diff --git a/docs/extensions/enum-class-cpp-component-extensions.md b/docs/extensions/enum-class-cpp-component-extensions.md index 38e1b9b11f0..1b3e30c4500 100644 --- a/docs/extensions/enum-class-cpp-component-extensions.md +++ b/docs/extensions/enum-class-cpp-component-extensions.md @@ -5,7 +5,7 @@ ms.date: "10/12/2018" ms.topic: "reference" ms.assetid: 8010fa8c-bad6-45b4-8214-b4db64d7ffe1 --- -# enum class (C++/CLI and C++/CX) +# enum class (C++/CLI and C++/CX) Declares an enumeration at namespace scope, which is a user-defined type consisting of a set of named constants called enumerators. diff --git a/docs/extensions/exception-handling-cpp-component-extensions.md b/docs/extensions/exception-handling-cpp-component-extensions.md index 3c16ee20c28..841ea42df15 100644 --- a/docs/extensions/exception-handling-cpp-component-extensions.md +++ b/docs/extensions/exception-handling-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["structured exception handling [C++], managed exceptions", "Exception class, managed applications", "exception handling", "C++ exception handling", "exception handling, types of", "System::Exception class in managed applications"] ms.assetid: ccb11fe8-6938-41ac-b477-a183e85865b9 --- -# Exception Handling (C++/CLI and C++/CX) +# Exception Handling (C++/CLI and C++/CX) Applications compiled with the `/ZW` compiler option or `/clr` compiler option both use *exceptions* to handle unexpected errors during program execution. The following topics discuss exception handling in either C++/CX or C++/CLI applications. diff --git a/docs/extensions/explicit-overrides-cpp-component-extensions.md b/docs/extensions/explicit-overrides-cpp-component-extensions.md index cb5e4288ab6..b03d7b1b1dc 100644 --- a/docs/extensions/explicit-overrides-cpp-component-extensions.md +++ b/docs/extensions/explicit-overrides-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["overriding, override [C++]"] ms.assetid: 4ec3eaf5-163b-4df8-8f16-7a2ec04c3d0f --- -# Explicit Overrides (C++/CLI and C++/CX) +# Explicit Overrides (C++/CLI and C++/CX) This topic discusses how to explicitly override a member of a base class or interface. A named (explicit) override should only be used to override a method with a derived method that has a different name. diff --git a/docs/extensions/generics-cpp-component-extensions.md b/docs/extensions/generics-cpp-component-extensions.md index 6d268126910..65304a6d6d6 100644 --- a/docs/extensions/generics-cpp-component-extensions.md +++ b/docs/extensions/generics-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["generic_cpp", "generic"] helpviewer_keywords: ["generics [C++]"] ms.assetid: c7ccc316-a411-4c00-b2e2-f0c0eadc6cfd --- -# Generics (C++/CLI and C++/CX) +# Generics (C++/CLI and C++/CX) Generics are parameterized types and methods. In this section, find out which generic features both the Windows Runtime and the common language runtime support, and which ones only the common language runtime supports. You'll also find out how to author your own generic methods and types in C++/CLI, and how to use generic types authored in a .NET Framework language in C++/CLI. Finally, this section provides a comparison of generics and C++ templates. diff --git a/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md b/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md index 089f64f26e2..e88997e5259 100644 --- a/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md +++ b/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["^ handle to object [C++]"] ms.assetid: 70c411e6-be57-4468-a944-6ea7be89f392 --- -# Handle to Object Operator (^) (C++/CLI and C++/CX) +# Handle to Object Operator (^) (C++/CLI and C++/CX) The *handle declarator* (`^`, pronounced "hat"), modifies the type [specifier](../cpp/declarations-and-definitions-cpp.md) to mean that the declared object should be automatically deleted when the system determines that the object is no longer accessible. diff --git a/docs/extensions/interface-class-cpp-component-extensions.md b/docs/extensions/interface-class-cpp-component-extensions.md index 9688279ef0a..1779d67e42d 100644 --- a/docs/extensions/interface-class-cpp-component-extensions.md +++ b/docs/extensions/interface-class-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["interface_CPP", "interface class", "interface class_CPP"] helpviewer_keywords: ["interface class keyword", "interface struct keyword"] ms.assetid: 3ccea701-f50b-4da7-ad6b-f0ee1203e2b9 --- -# `interface class` (C++/CLI and C++/CX) +# `interface class` (C++/CLI and C++/CX) Declares an interface. For information on native interfaces, see [`__interface`](../cpp/interface.md). diff --git a/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md b/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md index adba09017e4..76cb16a7034 100644 --- a/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md +++ b/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["new keyword [C++]"] ms.assetid: 1a9a5704-f02f-46ae-ad65-f0f2b6dbabc3 --- -# new (new slot in vtable) (C++/CLI and C++/CX) +# new (new slot in vtable) (C++/CLI and C++/CX) The **`new`** keyword indicates that a virtual member will get a new slot in the vtable. diff --git a/docs/extensions/nullptr-cpp-component-extensions.md b/docs/extensions/nullptr-cpp-component-extensions.md index e9972a7c692..59436902014 100644 --- a/docs/extensions/nullptr-cpp-component-extensions.md +++ b/docs/extensions/nullptr-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["__nullptr keyword (C++)", "nullptr keyword [C++]"] ms.assetid: 594cfbf7-06cb-4366-9ede-c0b703e1d095 --- -# nullptr (C++/CLI and C++/CX) +# nullptr (C++/CLI and C++/CX) The **`nullptr`** keyword represents a *null pointer value*. Use a null pointer value to indicate that an object handle, interior pointer, or native pointer type does not point to an object. diff --git a/docs/extensions/override-cpp-component-extensions.md b/docs/extensions/override-cpp-component-extensions.md index 5f6305c840c..cd1143048be 100644 --- a/docs/extensions/override-cpp-component-extensions.md +++ b/docs/extensions/override-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["overriding, override keyword [C++]", "override keyword [C++]"] ms.assetid: 34d19257-1686-4fcd-96f5-af07c70ba914 --- -# override (C++/CLI and C++/CX) +# override (C++/CLI and C++/CX) The **override** context-sensitive keyword indicates that a member of a type overrides a base class or a base interface member. diff --git a/docs/extensions/override-specifiers-cpp-component-extensions.md b/docs/extensions/override-specifiers-cpp-component-extensions.md index 0534d54ecb9..fce37f749cb 100644 --- a/docs/extensions/override-specifiers-cpp-component-extensions.md +++ b/docs/extensions/override-specifiers-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["override specifiers, C++", "override specifiers"] ms.assetid: 155bbf6f-4722-4654-afb1-9cb52af799fb --- -# Override Specifiers (C++/CLI and C++/CX) +# Override Specifiers (C++/CLI and C++/CX) *Override specifiers* modify how inherited types and members of inherited types behave in derived types. diff --git a/docs/extensions/partial-cpp-component-extensions.md b/docs/extensions/partial-cpp-component-extensions.md index 90084a64c30..7a8a1cd119a 100644 --- a/docs/extensions/partial-cpp-component-extensions.md +++ b/docs/extensions/partial-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["partial_CPP"] helpviewer_keywords: ["partial", "C++/CX, partial"] ms.assetid: 43adf1f5-10c5-44aa-a66f-7507e2bdabf8 --- -# partial (C++/CLI and C++/CX) +# partial (C++/CLI and C++/CX) The **partial** keyword enables different parts of the same ref class to be authored independently and in different files. diff --git a/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md b/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md index 7915908d659..ce3a77f3d84 100644 --- a/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md +++ b/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["lang", "cli"] helpviewer_keywords: ["lang namespace", "cli namespace"] ms.assetid: 9d38bd1e-dc78-47d1-a84b-9b4683e52c9c --- -# Platform, default, and cli Namespaces (C++/CLI and C++/CX) +# Platform, default, and cli Namespaces (C++/CLI and C++/CX) A namespace qualifies the names of language elements so the names do not conflict with otherwise identical names elsewhere in the source code. For example, a name collision might prevent the compiler from recognizing [Context-Sensitive Keywords](context-sensitive-keywords-cpp-component-extensions.md). Namespaces are used by the compiler but are not preserved in the compiled assembly. diff --git a/docs/extensions/ref-new-gcnew-cpp-component-extensions.md b/docs/extensions/ref-new-gcnew-cpp-component-extensions.md index c2a9a423422..a27aba3d623 100644 --- a/docs/extensions/ref-new-gcnew-cpp-component-extensions.md +++ b/docs/extensions/ref-new-gcnew-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["gcnew", "ref new", "gcnew_cpp"] helpviewer_keywords: ["ref new keyword (C++)", "gcnew keyword [C++]"] ms.assetid: 388a62da-c2df-4a94-a9a2-205b53e577da --- -# ref new, gcnew (C++/CLI and C++/CX) +# ref new, gcnew (C++/CLI and C++/CX) The **ref new** aggregate keyword allocates an instance of a type that is garbage collected when the object becomes inaccessible, and that returns a handle ([^](handle-to-object-operator-hat-cpp-component-extensions.md)) to the allocated object. diff --git a/docs/extensions/sealed-cpp-component-extensions.md b/docs/extensions/sealed-cpp-component-extensions.md index 1229c6747d0..484218b4cbe 100644 --- a/docs/extensions/sealed-cpp-component-extensions.md +++ b/docs/extensions/sealed-cpp-component-extensions.md @@ -7,7 +7,7 @@ f1_keywords: ["sealed_cpp", "sealed"] helpviewer_keywords: ["sealed keyword [C++]"] ms.assetid: 3d0d688a-41aa-45f5-a25a-65c44206521e --- -# sealed (C++/CLI and C++/CX) +# sealed (C++/CLI and C++/CX) **sealed** is a context-sensitive keyword for ref classes that indicates that a virtual member cannot be overridden, or that a type cannot be used as a base type. diff --git a/docs/extensions/string-cpp-component-extensions.md b/docs/extensions/string-cpp-component-extensions.md index 6af1f651705..2fd5a545377 100644 --- a/docs/extensions/string-cpp-component-extensions.md +++ b/docs/extensions/string-cpp-component-extensions.md @@ -5,7 +5,7 @@ ms.date: 10/08/2018 ms.topic: "reference" helpviewer_keywords: ["string support with /clr", "/clr compiler option [C++], string support"] --- -# String (C++/CLI and C++/CX) +# String (C++/CLI and C++/CX) The Windows Runtime and common language runtime represent strings as objects whose allocated memory is managed automatically. That is, you are not required to explicitly discard the memory for a string when the string variable goes out of scope or your application ends. To indicate that the lifetime of a string object is to be managed automatically, declare the string type with the [handle-to-object (^)](handle-to-object-operator-hat-cpp-component-extensions.md) modifier. diff --git a/docs/extensions/typeid-cpp-component-extensions.md b/docs/extensions/typeid-cpp-component-extensions.md index 3d8cb2389cd..a9ad3c8f639 100644 --- a/docs/extensions/typeid-cpp-component-extensions.md +++ b/docs/extensions/typeid-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["typeid keyword [C++]"] ms.assetid: e9706cae-e7c4-4d6d-b474-646d73df3e70 --- -# typeid (C++/CLI and C++/CX) +# typeid (C++/CLI and C++/CX) Gets a value that indicates the type of an object. diff --git a/docs/extensions/user-defined-attributes-cpp-component-extensions.md b/docs/extensions/user-defined-attributes-cpp-component-extensions.md index bf6add627c2..7684bb9cc51 100644 --- a/docs/extensions/user-defined-attributes-cpp-component-extensions.md +++ b/docs/extensions/user-defined-attributes-cpp-component-extensions.md @@ -6,7 +6,7 @@ ms.topic: "reference" helpviewer_keywords: ["metadata, extending", "custom attributes, extending metadata"] ms.assetid: 98b29048-a3ea-4698-8441-f149cdaec9fb --- -# User-Defined Attributes (C++/CLI and C++/CX) +# User-Defined Attributes (C++/CLI and C++/CX) C++/CLI and C++/CX enable you to create platform-specific attributes that extend the metadata of an interface, class or structure, method, parameter, or enumeration. These attributes are distinct from the [standard C++ attributes](../cpp/attributes.md). diff --git a/docs/parallel/amp/reference/runtime-exception-class.md b/docs/parallel/amp/reference/runtime-exception-class.md index 663c5148d04..93a200d00c1 100644 --- a/docs/parallel/amp/reference/runtime-exception-class.md +++ b/docs/parallel/amp/reference/runtime-exception-class.md @@ -82,7 +82,7 @@ The `runtime_exception` object to copy. The `runtime_exception` object. -## ~runtime_exception Destructor +## ~runtime_exception Destructor Destroys the object. diff --git a/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md b/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md index bf77fcfa780..1200771b770 100644 --- a/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md +++ b/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md @@ -23,7 +23,7 @@ The following example shows the `for_all` method. It uses the [concurrency::para [!code-cpp[concrt-task-tree-search#1](../../parallel/concrt/codesnippet/cpp/how-to-use-exception-handling-to-break-from-a-parallel-loop_2.cpp)] -## Example: Search the tree for a value +## Example: Search the tree for a value The following example shows the `search_for_value` function, which searches for a value in the provided `tree` object. This function passes to the `for_all` method a work function that throws when it finds a tree node that contains the provided value. diff --git a/docs/sanitizers/error-stack-buffer-underflow.md b/docs/sanitizers/error-stack-buffer-underflow.md index 03d148c2e73..a780be1f668 100644 --- a/docs/sanitizers/error-stack-buffer-underflow.md +++ b/docs/sanitizers/error-stack-buffer-underflow.md @@ -74,7 +74,7 @@ cl example2.cpp /fsanitize=address /Zi devenv /debugexe example2.exe ``` -### Resulting error - stack underflow on thread +### Resulting error - stack underflow on thread :::image type="content" source="media/stack-buffer-underflow-example-2.png" alt-text="Screenshot of debugger displaying stack-buffer-underflow error in example 2."::: diff --git a/docs/standard-library/drop-view-class.md b/docs/standard-library/drop-view-class.md index 84984d30b46..337a2b4cd44 100644 --- a/docs/standard-library/drop-view-class.md +++ b/docs/standard-library/drop-view-class.md @@ -85,7 +85,7 @@ If you specify more elements to drop than exist in the underlying range, then an The best way to create a `drop_view` is by using the [`views::drop`](range-adaptors.md#drop) range adaptor. Range adaptors are the intended way to create view classes. The view types are exposed in case you want to create your own custom view type. -### Example: `drop_view` +### Example: `drop_view` ```cpp // requires /std:c++20 or later diff --git a/docs/standard-library/elements-view-class.md b/docs/standard-library/elements-view-class.md index 4197bcf2155..86cbc8b57e8 100644 --- a/docs/standard-library/elements-view-class.md +++ b/docs/standard-library/elements-view-class.md @@ -95,7 +95,7 @@ The best way to create an `elements_view` is by using the [`elements`](range-ada 1\) Create an `elements_view` from the specified view.\ 2\) Default construct an `elements_view`. -### Example: `elements_view` +### Example: `elements_view` ```cpp // requires /std:c++20 or later diff --git a/docs/standard-library/hash-map-operators.md b/docs/standard-library/hash-map-operators.md index 1fc15813e1c..e3da8726961 100644 --- a/docs/standard-library/hash-map-operators.md +++ b/docs/standard-library/hash-map-operators.md @@ -211,7 +211,7 @@ The hash_multimaps hm1 and hm2 are not equal. The hash_multimaps hm1 and hm3 are equal. ``` -## operator== (hash_multimap) +## operator== (hash_multimap) > [!NOTE] > This API is obsolete. The alternative is [unordered_multimap Class](unordered-multimap-class.md). diff --git a/docs/standard-library/keys-view-class.md b/docs/standard-library/keys-view-class.md index 4b9d1e47bee..6108fac74f2 100644 --- a/docs/standard-library/keys-view-class.md +++ b/docs/standard-library/keys-view-class.md @@ -96,7 +96,7 @@ The best way to create an `keys_view` is by using the [`keys`](range-adaptors.md 1\) Create a `keys_view` from the specified view.\ 2\) The default constructor creates an empty `keys_view`. -### Example: `keys_view` +### Example: `keys_view` ```cpp // requires /std:c++20 or later diff --git a/docs/standard-library/recursive-mutex-class.md b/docs/standard-library/recursive-mutex-class.md index 451a7686a46..60935d02799 100644 --- a/docs/standard-library/recursive-mutex-class.md +++ b/docs/standard-library/recursive-mutex-class.md @@ -59,7 +59,7 @@ Constructs a `recursive_mutex` object that is not locked. recursive_mutex(); ``` -## ~recursive_mutex +## ~recursive_mutex Releases any resources that are used by the object. diff --git a/docs/standard-library/recursive-timed-mutex-class.md b/docs/standard-library/recursive-timed-mutex-class.md index 3728a0eb94d..4f2f2b5ef87 100644 --- a/docs/standard-library/recursive-timed-mutex-class.md +++ b/docs/standard-library/recursive-timed-mutex-class.md @@ -61,7 +61,7 @@ Constructs a `recursive_timed_mutex` object that is not locked. recursive_timed_mutex(); ``` -## ~recursive_timed_mutex Destructor +## ~recursive_timed_mutex Destructor Releases any resources that are used by the `recursive_timed_mutex` object. diff --git a/docs/standard-library/unique-lock-class.md b/docs/standard-library/unique-lock-class.md index 612058f1d80..536efb34dd5 100644 --- a/docs/standard-library/unique-lock-class.md +++ b/docs/standard-library/unique-lock-class.md @@ -298,7 +298,7 @@ The remaining constructors store & *Mtx* as the stored `mutex` pointer. Ownershi |`Rel_time`|Ownership is determined by calling `try_lock_for(Rel_time)`.| |`Abs_time`|Ownership is determined by calling `try_lock_until(Abs_time)`.| -## ~unique_lock Destructor +## ~unique_lock Destructor Releases any resources that are associated with the `unique_lock` object. diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index ab568aca234..78692323aef 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -55,7 +55,7 @@ Download other versions, including long term servicing release channel (LTSC) ve - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). -## Visual Studio 2013 (VC++ 12.0) (no longer supported) +## Visual Studio 2013 (VC++ 12.0) (no longer supported) These links download the latest available en-US Microsoft Visual C++ Redistributable packages for Visual Studio 2013. You can download other versions and languages from [Update for Visual C++ 2013 Redistributable Package](https://support.microsoft.com/topic/update-for-visual-c-2013-redistributable-package-d8ccd6a5-4e26-c290-517b-8da6cfdf4f10) or from [my.visualstudio.com](https://my.visualstudio.com/). @@ -70,7 +70,7 @@ You can download other versions and languages from [Update for Visual C++ 2013 R - [Multibyte MFC Library for Visual Studio 2013](https://my.visualstudio.com/Downloads?pid=1430). This MFC add-on for Visual Studio 2013 contains the multibyte character set (MBCS) version of the Microsoft Foundation Class (MFC) Library. - [Visual C++ 2013 Runtime for Sideloaded Windows 8.1 apps](https://download.microsoft.com/download/5/f/0/5f0f8404-9329-44a9-8176-ed6f7f746f25/vclibs_redist_packages.zip). For more information, see [C++ Runtime for Sideloaded Windows 8.1 apps](https://devblogs.microsoft.com/cppblog/c-runtime-for-sideloaded-windows-8-1-apps/) on the C++ Team Blog. -## Visual Studio 2012 (VC++ 11.0) Update 4 (no longer supported) +## Visual Studio 2012 (VC++ 11.0) Update 4 (no longer supported) > [!NOTE] > Visual Studio 2012 [reached end of extended support on Jan 10, 2023](/lifecycle/products/visual-studio-2012) From 3875a2ead29148e8d31cbd9084f5d8bbc28b7228 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 21 Jun 2025 23:39:47 +0800 Subject: [PATCH 0144/1799] Trim excess trailing space in headings --- docs/dotnet/auto-handle-class.md | 4 ++-- docs/linux/connect-to-your-remote-linux-computer.md | 2 +- .../set-up-fips-compliant-secure-remote-linux-development.md | 2 +- docs/standard-library/day-class.md | 2 +- docs/standard-library/month-class.md | 2 +- docs/standard-library/month-day-class.md | 2 +- docs/standard-library/month-day-last-class.md | 2 +- docs/standard-library/month-weekday-class.md | 2 +- docs/standard-library/month-weekday-last-class.md | 2 +- docs/standard-library/weekday-class.md | 2 +- docs/standard-library/weekdayindexed-class.md | 2 +- docs/standard-library/weekdaylast-class.md | 2 +- docs/standard-library/year-class.md | 2 +- docs/standard-library/year-month-class.md | 2 +- docs/standard-library/year-month-day-class.md | 2 +- docs/standard-library/year-month-day-last-class.md | 2 +- docs/standard-library/year-month-weekday-class.md | 2 +- docs/standard-library/year-month-weekday-last-class.md | 2 +- 18 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/dotnet/auto-handle-class.md b/docs/dotnet/auto-handle-class.md index cf238bd76d9..31b76efd833 100644 --- a/docs/dotnet/auto-handle-class.md +++ b/docs/dotnet/auto-handle-class.md @@ -25,14 +25,14 @@ The managed type to be embedded. ## Members -### Public constructors +### Public constructors |Name|Description| |---------|-----------| |[auto_handle::auto_handle](#auto-handle)|The `auto_handle` constructor.| |[auto_handle::~auto_handle](#tilde-auto-handle)|The `auto_handle` destructor.| -### Public methods +### Public methods |Name|Description| |---------|-----------| diff --git a/docs/linux/connect-to-your-remote-linux-computer.md b/docs/linux/connect-to-your-remote-linux-computer.md index 24030a4b847..5803f75c496 100644 --- a/docs/linux/connect-to-your-remote-linux-computer.md +++ b/docs/linux/connect-to-your-remote-linux-computer.md @@ -203,7 +203,7 @@ Logs include connections, all commands sent to the remote machine (their text, e You can configure the output to go to a file or to the **Cross Platform Logging** pane in the Output window. For MSBuild-based Linux projects, MSBuild commands sent to the remote machine aren't routed to the **Output Window** because they're emitted out-of-process. Instead, they're logged to a file, with a prefix of `msbuild_`. -## Command-line utility for the Connection Manager +## Command-line utility for the Connection Manager **Visual Studio 2019 version 16.5 or later**: *`ConnectionManager.exe`* is a command-line utility to manage remote development connections outside of Visual Studio. It's useful for tasks such as provisioning a new development machine. Or, you can use it to set up Visual Studio for continuous integration. For examples and a complete reference to the `ConnectionManager` command, see [ConnectionManager reference](connectionmanager-reference.md). diff --git a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md index fbfacf7a4f0..30dd4129e67 100644 --- a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md +++ b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md @@ -128,7 +128,7 @@ You've successfully set up `ssh`, created and deployed encryption keys, and test For more information on troubleshooting your connection, see [Connect to your remote Linux computer](connect-to-your-remote-linux-computer.md). -## Command-line utility for the Connection Manager +## Command-line utility for the Connection Manager **Visual Studio 2019 version 16.5 or later**: `ConnectionManager.exe` is a command-line utility to manage remote development connections outside of Visual Studio. It's useful for tasks such as provisioning a new development machine. Or, you can use it to set up Visual Studio for continuous integration. For examples and a complete reference to the ConnectionManager command, see [ConnectionManager reference](connectionmanager-reference.md). diff --git a/docs/standard-library/day-class.md b/docs/standard-library/day-class.md index 5501b49af90..e97739f9488 100644 --- a/docs/standard-library/day-class.md +++ b/docs/standard-library/day-class.md @@ -6,7 +6,7 @@ f1_keywords: ["chrono/std::chrono::day", "chrono/std::chrono::day::ok", "chrono/ helpviewer_keywords: ["std::chrono [C++], day"] dev_langs: ["C++"] --- -# `day` class +# `day` class Represents a day of the month. For example, the 25th day of the month. diff --git a/docs/standard-library/month-class.md b/docs/standard-library/month-class.md index 047db99cf28..d024a42fcf3 100644 --- a/docs/standard-library/month-class.md +++ b/docs/standard-library/month-class.md @@ -6,7 +6,7 @@ f1_keywords: ["chrono/std::chrono::month", "chrono/std::chrono::month::January", helpviewer_keywords: ["std::chrono [C++], month"] dev_langs: ["C++"] --- -# `month` class +# `month` class Represents a month of a year. For example, July. diff --git a/docs/standard-library/month-day-class.md b/docs/standard-library/month-day-class.md index a84c17ac088..d28a608bccd 100644 --- a/docs/standard-library/month-day-class.md +++ b/docs/standard-library/month-day-class.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["std::chrono [C++], month_day"] dev_langs: ["C++"] --- -# `month_day` class +# `month_day` class Represents a specific day of a specific month. The year isn't specified. diff --git a/docs/standard-library/month-day-last-class.md b/docs/standard-library/month-day-last-class.md index 7b7780dfbe2..b84b8247bc6 100644 --- a/docs/standard-library/month-day-last-class.md +++ b/docs/standard-library/month-day-last-class.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["std::chrono [C++], month_day_last"] dev_langs: ["C++"] --- -# `month_day_last` class +# `month_day_last` class Represents the last day of a month. diff --git a/docs/standard-library/month-weekday-class.md b/docs/standard-library/month-weekday-class.md index 0156b703869..2c4cbfea5ce 100644 --- a/docs/standard-library/month-weekday-class.md +++ b/docs/standard-library/month-weekday-class.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["std::chrono [C++], month_weekday"] dev_langs: ["C++"] --- -# `month_weekday` class +# `month_weekday` class Represents the nth weekday of a specific month. diff --git a/docs/standard-library/month-weekday-last-class.md b/docs/standard-library/month-weekday-last-class.md index 34770527f74..78e17b33533 100644 --- a/docs/standard-library/month-weekday-last-class.md +++ b/docs/standard-library/month-weekday-last-class.md @@ -6,7 +6,7 @@ f1_keywords: ["chrono/std::chrono::month_weekday_last", "chrono/std::chrono::mon helpviewer_keywords: ["std::chrono [C++], month_weekday_last"] dev_langs: ["C++"] --- -# `month_weekday_last` class +# `month_weekday_last` class Represents the last weekday of a month. diff --git a/docs/standard-library/weekday-class.md b/docs/standard-library/weekday-class.md index dc7d9182789..a71c8b495ea 100644 --- a/docs/standard-library/weekday-class.md +++ b/docs/standard-library/weekday-class.md @@ -5,7 +5,7 @@ ms.date: "6/25/2021" f1_keywords: ["chrono/std::chrono::weekday", "chrono/std::chrono::weekday::January", "chrono/std::chrono::weekday::February", "chrono/std::chrono::weekday::March","chrono/std::chrono::weekday::April","chrono/std::chrono::weekday::May","chrono/std::chrono::weekday::June","chrono/std::chrono::weekday::July","chrono/std::chrono::weekday::August","chrono/std::chrono::weekday::September","chrono/std::chrono::weekday::October","chrono/std::chrono::weekday::November","chrono/std::chrono::weekday::December","chrono/std::chrono::weekday::operator++", "chrono/std::chrono::weekday::operator--", "chrono/std::chrono::weekday::operator unsigned", "chrono/std::chrono::weekday::ok", "chrono/std::chrono::weekday::iso_encoding", "chrono/std::chrono::weekday::c_encoding"] helpviewer_keywords: ["std::chrono [C++], weekday"] --- -# `weekday` class +# `weekday` class Represents a day of the week in the [Gregorian calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar). For example, Tuesday. diff --git a/docs/standard-library/weekdayindexed-class.md b/docs/standard-library/weekdayindexed-class.md index 9a16b9c3f53..7f2121515e7 100644 --- a/docs/standard-library/weekdayindexed-class.md +++ b/docs/standard-library/weekdayindexed-class.md @@ -5,7 +5,7 @@ ms.date: "06/25/2021" f1_keywords: ["chrono/std::chrono::weekday_indexed", "chrono/std::chrono::weekday_indexed::ok", "std::chrono::weekday_indexed::weekday", "std::chrono::weekday_indexed::ok"] helpviewer_keywords: ["std::chrono [C++], weekday_indexed"] --- -# `weekday_indexed` class +# `weekday_indexed` class Combines a weekday, representing a day of the week in the Gregorian calendar, with an index in the range [1, 5] that represents the weekday of the month (1st, 2nd, 3rd, and so on). diff --git a/docs/standard-library/weekdaylast-class.md b/docs/standard-library/weekdaylast-class.md index 477069cd668..9f545c9935e 100644 --- a/docs/standard-library/weekdaylast-class.md +++ b/docs/standard-library/weekdaylast-class.md @@ -6,7 +6,7 @@ f1_keywords: ["chrono/std::chrono::weekday_last", "chrono/std::chrono::weekday_l helpviewer_keywords: ["std::chrono [C++], weekday_last"] --- -# `weekday_last` class +# `weekday_last` class Represents the last weekday of a month. diff --git a/docs/standard-library/year-class.md b/docs/standard-library/year-class.md index 7d3f7d181c9..85d0bb1d0fe 100644 --- a/docs/standard-library/year-class.md +++ b/docs/standard-library/year-class.md @@ -5,7 +5,7 @@ ms.date: "06/28/2021" f1_keywords: ["chrono/std::chrono::year", "chrono/std::chrono::year::operator++", "chrono/std::chrono::year::operator--", "chrono/std::chrono::year::operator+=", "chrono/std::chrono::year::operator-=", "chrono/std::chrono::year::operator int", "chrono/std::chrono::year::is_leap", "chrono/std::chrono::year::max", "chrono/std::chrono::min", "chrono/std::chrono::year::ok"] helpviewer_keywords: ["std::chrono [C++], year"] --- -# `year` class +# `year` class Represents a year in the [Gregorian calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar). diff --git a/docs/standard-library/year-month-class.md b/docs/standard-library/year-month-class.md index 88e5800a280..8bc06ee90b5 100644 --- a/docs/standard-library/year-month-class.md +++ b/docs/standard-library/year-month-class.md @@ -6,7 +6,7 @@ f1_keywords: ["chrono/std::chrono::year_month", "chrono/std::chrono::year_month: helpviewer_keywords: ["std::chrono [C++], year_month"] dev_langs: ["C++"] --- -# `year_month` class +# `year_month` class Represents a month and year. The day isn't specified. diff --git a/docs/standard-library/year-month-day-class.md b/docs/standard-library/year-month-day-class.md index e153349e082..7a1c6241270 100644 --- a/docs/standard-library/year-month-day-class.md +++ b/docs/standard-library/year-month-day-class.md @@ -6,7 +6,7 @@ f1_keywords: ["chrono/std::chrono::year_month_day", "chrono/std::chrono::year::o helpviewer_keywords: ["std::chrono [C++], year_month_day"] --- -# `year_month_day` class +# `year_month_day` class Represents a month, year, and day. diff --git a/docs/standard-library/year-month-day-last-class.md b/docs/standard-library/year-month-day-last-class.md index 2427f36c402..49925160412 100644 --- a/docs/standard-library/year-month-day-last-class.md +++ b/docs/standard-library/year-month-day-last-class.md @@ -6,7 +6,7 @@ f1_keywords: ["chrono/std::chrono::year_month_day_last", "chrono/std::chrono::ye helpviewer_keywords: ["std::chrono [C++], year_month_day_last"] dev_langs: ["C++"] --- -# `year_month_day_last` class +# `year_month_day_last` class Represents the last day of a specific year and month. diff --git a/docs/standard-library/year-month-weekday-class.md b/docs/standard-library/year-month-weekday-class.md index 58e77234861..c5c32b80afc 100644 --- a/docs/standard-library/year-month-weekday-class.md +++ b/docs/standard-library/year-month-weekday-class.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["std::chrono [C++], year_month_weekday"] dev_langs: ["C++"] --- -# `year_month_weekday` class +# `year_month_weekday` class Represents a specific year, month, and nth weekday of the month. diff --git a/docs/standard-library/year-month-weekday-last-class.md b/docs/standard-library/year-month-weekday-last-class.md index 8cac30f7d47..01d97cfd6cd 100644 --- a/docs/standard-library/year-month-weekday-last-class.md +++ b/docs/standard-library/year-month-weekday-last-class.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["std::chrono [C++], year_month_weekday_last"] dev_langs: ["C++"] --- -# `year_month_weekday_last` class +# `year_month_weekday_last` class A specific year, month, and last weekday of the month. From 0655295a8ac76926cb4be5131168a2ab59b65887 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 00:01:58 +0800 Subject: [PATCH 0145/1799] Update metadata for a couple dozen topics --- docs/atl/reference/catltransactionmanager-class.md | 5 ++--- docs/atl/reference/ccomdynamicunkarray-class.md | 5 ++--- docs/c-runtime-library/reference/itoa-s-itow-s.md | 5 ++--- docs/code-quality/c26433.md | 2 +- docs/cpp/basic-concepts-cpp.md | 7 +++---- docs/cpp/functions-with-variable-argument-lists-cpp.md | 4 ++-- docs/cppcx/platform-stringreference-class.md | 5 ++--- docs/data/catalog-information-mfc-data-access.md | 7 +++---- ...s-you-might-make-to-the-default-code-mfc-data-access.md | 6 +++--- ...ommand-handlers-for-record-scrolling-mfc-data-access.md | 7 +++---- .../data/data-exchange-for-record-views-mfc-data-access.md | 7 +++---- ...designing-and-creating-a-record-view-mfc-data-access.md | 7 +++---- .../features-of-record-view-classes-mfc-data-access.md | 7 +++---- ...g-a-list-box-from-a-second-recordset-mfc-data-access.md | 7 +++---- .../sql-customizing-your-recordsets-sql-statement-odbc.md | 5 ++--- ...w-code-created-by-application-wizard-mfc-data-access.md | 7 +++---- docs/data/record-views-mfc-data-access.md | 7 +++---- docs/data/schema-mfc-data-access.md | 7 +++---- ...pporting-navigation-in-a-record-view-mfc-data-access.md | 7 +++---- docs/data/transactions-mfc-data-access.md | 7 +++---- ...-interface-updating-for-record-views-mfc-data-access.md | 7 +++---- docs/data/using-a-record-view-mfc-data-access.md | 7 +++---- ...r-role-in-working-with-a-record-view-mfc-data-access.md | 7 +++---- docs/dotnet/auto-handle-class.md | 5 ++--- docs/extensions/abstract-cpp-component-extensions.md | 7 +++---- .../attribute-parameter-types-cpp-component-extensions.md | 7 +++---- docs/extensions/boxing-cpp-component-extensions.md | 7 +++---- .../classes-and-structs-cpp-component-extensions.md | 5 ++--- .../context-sensitive-keywords-cpp-component-extensions.md | 7 +++---- docs/extensions/delegate-cpp-component-extensions.md | 7 +++---- docs/extensions/enum-class-cpp-component-extensions.md | 7 +++---- .../exception-handling-cpp-component-extensions.md | 7 +++---- .../explicit-overrides-cpp-component-extensions.md | 7 +++---- docs/extensions/generics-cpp-component-extensions.md | 3 +-- ...ndle-to-object-operator-hat-cpp-component-extensions.md | 7 +++---- .../extensions/interface-class-cpp-component-extensions.md | 3 +-- .../new-new-slot-in-vtable-cpp-component-extensions.md | 7 +++---- docs/extensions/nullptr-cpp-component-extensions.md | 7 +++---- docs/extensions/override-cpp-component-extensions.md | 7 +++---- .../override-specifiers-cpp-component-extensions.md | 7 +++---- docs/extensions/partial-cpp-component-extensions.md | 7 +++---- ...-default-and-cli-namespaces-cpp-component-extensions.md | 7 +++---- docs/extensions/ref-new-gcnew-cpp-component-extensions.md | 7 +++---- docs/extensions/sealed-cpp-component-extensions.md | 7 +++---- docs/extensions/string-cpp-component-extensions.md | 4 ++-- docs/extensions/typeid-cpp-component-extensions.md | 7 +++---- .../user-defined-attributes-cpp-component-extensions.md | 7 +++---- docs/parallel/amp/reference/runtime-exception-class.md | 5 ++--- ...use-exception-handling-to-break-from-a-parallel-loop.md | 5 ++--- docs/standard-library/month-class.md | 4 ++-- docs/standard-library/month-day-class.md | 4 ++-- docs/standard-library/month-day-last-class.md | 2 +- docs/standard-library/month-weekday-class.md | 4 ++-- docs/standard-library/month-weekday-last-class.md | 2 +- docs/standard-library/recursive-mutex-class.md | 5 ++--- docs/standard-library/recursive-timed-mutex-class.md | 5 ++--- docs/standard-library/unique-lock-class.md | 3 +-- docs/standard-library/weekday-class.md | 4 ++-- docs/standard-library/weekdayindexed-class.md | 4 ++-- docs/standard-library/weekdaylast-class.md | 4 ++-- docs/standard-library/year-class.md | 4 ++-- docs/standard-library/year-month-class.md | 4 ++-- docs/standard-library/year-month-day-class.md | 2 +- docs/standard-library/year-month-day-last-class.md | 4 ++-- docs/standard-library/year-month-weekday-last-class.md | 4 ++-- 65 files changed, 158 insertions(+), 206 deletions(-) diff --git a/docs/atl/reference/catltransactionmanager-class.md b/docs/atl/reference/catltransactionmanager-class.md index d83a689a72a..4c4430bf45b 100644 --- a/docs/atl/reference/catltransactionmanager-class.md +++ b/docs/atl/reference/catltransactionmanager-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CAtlTransactionManager Class" title: "CAtlTransactionManager Class" -ms.date: "11/04/2016" +description: "Learn more about: CAtlTransactionManager Class" +ms.date: 11/04/2016 f1_keywords: ["CAtlTransactionManager", "ATLTRANSACTIONMANAGER/ATL::CAtlTransactionManager", "ATLTRANSACTIONMANAGER/ATL::Close", "ATLTRANSACTIONMANAGER/ATL::Commit", "ATLTRANSACTIONMANAGER/ATL::Create", "ATLTRANSACTIONMANAGER/ATL::CreateFile", "ATLTRANSACTIONMANAGER/ATL::DeleteFile", "ATLTRANSACTIONMANAGER/ATL::FindFirstFile", "ATLTRANSACTIONMANAGER/ATL::GetFileAttributes", "ATLTRANSACTIONMANAGER/ATL::GetFileAttributesEx", "ATLTRANSACTIONMANAGER/ATL::GetHandle", "ATLTRANSACTIONMANAGER/ATL::IsFallback", "ATLTRANSACTIONMANAGER/ATL::MoveFile", "ATLTRANSACTIONMANAGER/ATL::RegCreateKeyEx", "ATLTRANSACTIONMANAGER/ATL::RegDeleteKey", "ATLTRANSACTIONMANAGER/ATL::RegOpenKeyEx", "ATLTRANSACTIONMANAGER/ATL::Rollback", "ATLTRANSACTIONMANAGER/ATL::SetFileAttributes", "ATLTRANSACTIONMANAGER/ATL::m_bFallback", "ATLTRANSACTIONMANAGER/ATL::m_hTransaction"] helpviewer_keywords: ["CAtlTransactionManager class"] -ms.assetid: b01732dc-1d16-4b42-bfac-b137fca2b740 --- # CAtlTransactionManager Class diff --git a/docs/atl/reference/ccomdynamicunkarray-class.md b/docs/atl/reference/ccomdynamicunkarray-class.md index 86b175f34c2..682edba8166 100644 --- a/docs/atl/reference/ccomdynamicunkarray-class.md +++ b/docs/atl/reference/ccomdynamicunkarray-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CComDynamicUnkArray Class" title: "CComDynamicUnkArray Class" -ms.date: "11/04/2016" +description: "Learn more about: CComDynamicUnkArray Class" +ms.date: 11/04/2016 f1_keywords: ["CComDynamicUnkArray", "ATLCOM/ATL::CComDynamicUnkArray", "ATLCOM/ATL::CComDynamicUnkArray::CComDynamicUnkArray", "ATLCOM/ATL::CComDynamicUnkArray::Add", "ATLCOM/ATL::CComDynamicUnkArray::begin", "ATLCOM/ATL::CComDynamicUnkArray::clear", "ATLCOM/ATL::CComDynamicUnkArray::end", "ATLCOM/ATL::CComDynamicUnkArray::GetAt", "ATLCOM/ATL::CComDynamicUnkArray::GetCookie", "ATLCOM/ATL::CComDynamicUnkArray::GetSize", "ATLCOM/ATL::CComDynamicUnkArray::GetUnknown", "ATLCOM/ATL::CComDynamicUnkArray::Remove"] helpviewer_keywords: ["connection points [C++], managing", "CComDynamicUnkArray class"] -ms.assetid: 202470d7-9a1b-498f-b96d-659d681acd65 --- # CComDynamicUnkArray Class diff --git a/docs/c-runtime-library/reference/itoa-s-itow-s.md b/docs/c-runtime-library/reference/itoa-s-itow-s.md index 7fd482765bc..8625968ea08 100644 --- a/docs/c-runtime-library/reference/itoa-s-itow-s.md +++ b/docs/c-runtime-library/reference/itoa-s-itow-s.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _itoa_s, _ltoa_s, _ultoa_s, _i64toa_s, _ui64toa_s, _itow_s, _ltow_s, _ultow_s, _i64tow_s, _ui64tow_s" title: "_itoa_s, _itow_s functions" -ms.date: "4/2/2020" +description: "Learn more about: _itoa_s, _ltoa_s, _ultoa_s, _i64toa_s, _ui64toa_s, _itow_s, _ltow_s, _ultow_s, _i64tow_s, _ui64tow_s" +ms.date: 4/2/2020 api_name: ["_itoa_s", "_ltoa_s", "_ultoa_s", "_i64toa_s", "_ui64toa_s", "_itow_s", "_ltow_s", "_ultow_s", "_i64tow_s", "_ui64tow_s", "_o__i64toa_s", "_o__i64tow_s", "_o__itoa_s", "_o__itow_s", "_o__ltoa_s", "_o__ltow_s", "_o__ui64toa_s", "_o__ui64tow_s", "_o__ultoa_s", "_o__ultow_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_itoa_s", "_ltoa_s", "_ultoa_s", "_i64toa_s", "_ui64toa_s", "_itow_s", "_ltow_s", "_ultow_s", "_i64tow_s", "_ui64tow_s", "_itot_s", "_ltot_s", "_ultot_s", "_i64tot_s", "_ui64tot_s", "itoa_s", "ltoa_s", "ultoa_s", "i64toa_s", "ui64toa_s", "itow_s", "ltow_s", "ultow_s", "i64tow_s", "ui64tow_s", "itot_s", "ltot_s", "ultot_s", "i64tot_s", "ui64tot_s"] helpviewer_keywords: ["_ui64toa_s function", "_itow_s function", "_i64tow_s function", "_itot_s function", "converting integers", "itow_s function", "i64toa_s function", "_ui64tow_s function", "integers, converting", "_i64tot_s function", "itoa_s function", "_itoa_s function", "ui64toa_s function", "i64tow_s function", "converting numbers, to strings", "_ui64tot_s function", "_i64toa_s function"] -ms.assetid: eb746581-bff3-48b5-a973-bfc0a4478ecf --- # `_itoa_s`, `_ltoa_s`, `_ultoa_s`, `_i64toa_s`, `_ui64toa_s`, `_itow_s`, `_ltow_s`, `_ultow_s`, `_i64tow_s`, `_ui64tow_s` diff --git a/docs/code-quality/c26433.md b/docs/code-quality/c26433.md index fe61915f6cd..f78b894e0af 100644 --- a/docs/code-quality/c26433.md +++ b/docs/code-quality/c26433.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Warning C26433 OVERRIDE_EXPLICITLY" title: Warning C26433 +description: "Learn more about: Warning C26433 OVERRIDE_EXPLICITLY" ms.date: 01/18/2017 f1_keywords: ["C26433", "OVERRIDE_EXPLICITLY"] helpviewer_keywords: ["C26433"] diff --git a/docs/cpp/basic-concepts-cpp.md b/docs/cpp/basic-concepts-cpp.md index 1828bb2fd8e..a60b27fef42 100644 --- a/docs/cpp/basic-concepts-cpp.md +++ b/docs/cpp/basic-concepts-cpp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Basic Concepts (C++)" -title: "Basic Concepts (C++)" +title: "Basic Concepts (C++)" +description: "Learn more about: Basic Concepts (C++)" ms.custom: "index-page" -ms.date: "12/11/2019" +ms.date: 12/11/2019 helpviewer_keywords: ["C++, basic language concepts"] -ms.assetid: 961801e6-2ffd-4bf1-bb71-7f55e48d9c79 --- # Basic Concepts (C++) diff --git a/docs/cpp/functions-with-variable-argument-lists-cpp.md b/docs/cpp/functions-with-variable-argument-lists-cpp.md index fc382629e74..59316d69931 100644 --- a/docs/cpp/functions-with-variable-argument-lists-cpp.md +++ b/docs/cpp/functions-with-variable-argument-lists-cpp.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Functions with Variable Argument Lists (C++)" -title: "Functions with Variable Argument Lists (C++)" +title: "Functions with Variable Argument Lists (C++)" +description: "Learn more about: Functions with Variable Argument Lists (C++)" ms.date: 05/01/2025 helpviewer_keywords: ["arguments [C++], variable number of", "variable argument lists", "declarators, functions", "argument lists [C++], variable number of", "declaring functions [C++], variables", "function calls, variable number of arguments"] --- diff --git a/docs/cppcx/platform-stringreference-class.md b/docs/cppcx/platform-stringreference-class.md index b22b6cf0059..0ca0b227d9b 100644 --- a/docs/cppcx/platform-stringreference-class.md +++ b/docs/cppcx/platform-stringreference-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Platform::StringReference Class" title: "Platform::StringReference Class" -ms.date: "12/30/2016" +description: "Learn more about: Platform::StringReference Class" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::StringReference::StringReference", "VCCORLIB/Platform::StringReference::Data", "VCCORLIB/Platform::StringReference::Length", "VCCORLIB/Platform::StringReference::GetHSTRING", "VCCORLIB/Platform::StringReference::GetString"] -ms.assetid: 2d09c7ec-0f16-458e-83ed-7225a1b9221e --- # Platform::StringReference Class diff --git a/docs/data/catalog-information-mfc-data-access.md b/docs/data/catalog-information-mfc-data-access.md index 9ffa4c72ac0..39e786d3e45 100644 --- a/docs/data/catalog-information-mfc-data-access.md +++ b/docs/data/catalog-information-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Catalog Information (MFC Data Access)" -title: "Catalog Information (MFC Data Access)" -ms.date: "11/04/2016" +title: "Catalog Information (MFC Data Access)" +description: "Learn more about: Catalog Information (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["tables [C++], catalog information", "tables [C++]", "ODBC [C++], catalog information", "catalog information database [C++]", "databases [C++], catalog information database"] -ms.assetid: c184e80f-ff17-409f-9df8-05275080bb8d --- # Catalog Information (MFC Data Access) diff --git a/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md b/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md index c8729444628..36779b2c17c 100644 --- a/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md +++ b/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md @@ -1,7 +1,7 @@ --- -title: "Changes You Might Make to the Default Code (MFC Data Access)" -description: "Learn more about: Changes You Might Make to the Default Code (MFC Data Access)" -ms.date: "11/04/2016" +title: "Changes You Might Make to the Default Code (MFC Data Access)" +description: "Learn more about: Changes You Might Make to the Default Code (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views [C++], customizing default code"] --- # Changes You Might Make to the Default Code (MFC Data Access) diff --git a/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md b/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md index 56f7b94474d..5974a0a0173 100644 --- a/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md +++ b/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Command Handlers for Record Scrolling (MFC Data Access)" -title: "Command Handlers for Record Scrolling (MFC Data Access)" -ms.date: "11/04/2016" +title: "Command Handlers for Record Scrolling (MFC Data Access)" +description: "Learn more about: Command Handlers for Record Scrolling (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views [C++], scrolling", "record scrolling [C++]", "scrolling records"] -ms.assetid: f8b13477-2a37-459e-a30c-806fb78165ac --- # Command Handlers for Record Scrolling (MFC Data Access) diff --git a/docs/data/data-exchange-for-record-views-mfc-data-access.md b/docs/data/data-exchange-for-record-views-mfc-data-access.md index b278bc389bf..cf7e9e780d0 100644 --- a/docs/data/data-exchange-for-record-views-mfc-data-access.md +++ b/docs/data/data-exchange-for-record-views-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Data Exchange for Record Views (MFC Data Access)" -title: "Data Exchange for Record Views (MFC Data Access)" -ms.date: "11/19/2018" +title: "Data Exchange for Record Views (MFC Data Access)" +description: "Learn more about: Data Exchange for Record Views (MFC Data Access)" +ms.date: 11/19/2018 helpviewer_keywords: ["RFX (record field exchange), data exchange mechanism", "RFX (record field exchange), record views", "record views, data exchange", "DDX (dialog data exchange), record views", "RFX (record field exchange)"] -ms.assetid: abc52ca7-6997-47a7-98f3-f347f52b1f72 --- # Data Exchange for Record Views (MFC Data Access) diff --git a/docs/data/designing-and-creating-a-record-view-mfc-data-access.md b/docs/data/designing-and-creating-a-record-view-mfc-data-access.md index 67366770fab..65281a8136b 100644 --- a/docs/data/designing-and-creating-a-record-view-mfc-data-access.md +++ b/docs/data/designing-and-creating-a-record-view-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Designing and Creating a Record View (MFC Data Access)" -title: "Designing and Creating a Record View (MFC Data Access)" -ms.date: "11/04/2016" +title: "Designing and Creating a Record View (MFC Data Access)" +description: "Learn more about: Designing and Creating a Record View (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["designing forms", "record views, creating", "forms [C++], designing", "record views, designing", "application wizards [C++], creating record view classes", "designing record views"] -ms.assetid: 1d6f5439-754f-4b8b-a19d-841a4657827b --- # Designing and Creating a Record View (MFC Data Access) diff --git a/docs/data/features-of-record-view-classes-mfc-data-access.md b/docs/data/features-of-record-view-classes-mfc-data-access.md index 5ee9adfcccb..4b5aa7499ed 100644 --- a/docs/data/features-of-record-view-classes-mfc-data-access.md +++ b/docs/data/features-of-record-view-classes-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Features of Record View Classes (MFC Data Access)" -title: "Features of Record View Classes (MFC Data Access)" -ms.date: "11/04/2016" +title: "Features of Record View Classes (MFC Data Access)" +description: "Learn more about: Features of Record View Classes (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views, classes", "record view classes"] -ms.assetid: e7b2820f-09c4-483f-83c0-317e8be42bdf --- # Features of Record View Classes (MFC Data Access) diff --git a/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md b/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md index 3bc7f9fb76b..4ebf00d6035 100644 --- a/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md +++ b/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Filling a List Box from a Second Recordset (MFC Data Access)" -title: "Filling a List Box from a Second Recordset (MFC Data Access)" -ms.date: "11/04/2016" +title: "Filling a List Box from a Second Recordset (MFC Data Access)" +description: "Learn more about: Filling a List Box from a Second Recordset (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views, filling list boxes", "list boxes, filling from second recordset", "recordsets [C++], filling list boxes or combo boxes", "CComboBox class, filling object from second rowset", "ODBC recordsets [C++], filling list boxes or combo boxes", "combo boxes [C++], filling from second recordset", "CListCtrl class, filling from second recordset"] -ms.assetid: 360c0834-da6b-4dc0-bcea-80e9acd611f0 --- # Filling a List Box from a Second Recordset (MFC Data Access) diff --git a/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md b/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md index 95cd9063cfb..034a0b37d85 100644 --- a/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md +++ b/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: SQL: Customizing Your Recordset's SQL Statement (ODBC)" title: "SQL: Customizing Your Recordset's SQL Statement (ODBC)" -ms.date: "11/04/2016" +description: "Learn more about: SQL: Customizing Your Recordset's SQL Statement (ODBC)" +ms.date: 11/04/2016 helpviewer_keywords: ["recordsets, SQL statements", "ODBC recordsets, SQL statements", "SQL statements, customizing", "SQL statements, recordset", "customizing SQL statements", "overriding, SQL statements", "SQL, opening recordsets"] -ms.assetid: 72293a08-cef2-4be2-aa1c-30565fcfbaf9 --- # SQL: Customizing Your Recordset's SQL Statement (ODBC) diff --git a/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md b/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md index 2229758c645..25cbb8cdefb 100644 --- a/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md +++ b/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Record View Code Created by Application Wizard (MFC Data Access)" -title: "Record View Code Created by Application Wizard (MFC Data Access)" -ms.date: "11/04/2016" +title: "Record View Code Created by Application Wizard (MFC Data Access)" +description: "Learn more about: Record View Code Created by Application Wizard (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["application wizards [C++], record view code", "record views, refreshing controls", "record views, application wizard code"] -ms.assetid: 18fd4703-5939-491d-b759-985f767b951f --- # Record View Code Created by Application Wizard (MFC Data Access) diff --git a/docs/data/record-views-mfc-data-access.md b/docs/data/record-views-mfc-data-access.md index d73f2ef4598..2741f14ec1c 100644 --- a/docs/data/record-views-mfc-data-access.md +++ b/docs/data/record-views-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Record Views (MFC Data Access)" -title: "Record Views (MFC Data Access)" -ms.date: "11/04/2016" +title: "Record Views (MFC Data Access)" +description: "Learn more about: Record Views (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["MFC [C++], record views", "ODBC recordsets [C++], record views", "databases [C++], record views", "record views [C++]", "forms [C++], data access tasks"] -ms.assetid: 562122d9-01d8-4284-acf6-ea109ab0408d --- # Record Views (MFC Data Access) diff --git a/docs/data/schema-mfc-data-access.md b/docs/data/schema-mfc-data-access.md index 84b98de5b3e..6b5c9e1d0e4 100644 --- a/docs/data/schema-mfc-data-access.md +++ b/docs/data/schema-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Schema (MFC Data Access)" -title: "Schema (MFC Data Access)" -ms.date: "11/04/2016" +title: "Schema (MFC Data Access)" +description: "Learn more about: Schema (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["structures [C++], database", "databases [C++], schema", "database schema [C++], about database schemas", "database schema [C++]", "schemas [C++], database", "structures [C++]"] -ms.assetid: 7d17e35f-1ccf-4853-b915-5b8c7a45b9ee --- # Schema (MFC Data Access) diff --git a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md index b61b4e34801..b10af4149a7 100644 --- a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md +++ b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Supporting Navigation in a Record View (MFC Data Access)" -title: "Supporting Navigation in a Record View (MFC Data Access)" -ms.date: "11/04/2016" +title: "Supporting Navigation in a Record View (MFC Data Access)" +description: "Learn more about: Supporting Navigation in a Record View (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["records [C++], navigating", "record views, navigation", "navigation [C++], in record view"] -ms.assetid: 227f2a6d-87c9-4656-807a-8e246965bcce --- # Supporting Navigation in a Record View (MFC Data Access) diff --git a/docs/data/transactions-mfc-data-access.md b/docs/data/transactions-mfc-data-access.md index c0dcf6a133a..6d9bcec6ace 100644 --- a/docs/data/transactions-mfc-data-access.md +++ b/docs/data/transactions-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Transactions (MFC Data Access)" -title: "Transactions (MFC Data Access)" -ms.date: "11/04/2016" +title: "Transactions (MFC Data Access)" +description: "Learn more about: Transactions (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["transactions [C++], support for", "transactions [C++]", "databases [C++], transactions"] -ms.assetid: f80afbfe-1517-4fec-8870-9ffc70a58b05 --- # Transactions (MFC Data Access) diff --git a/docs/data/user-interface-updating-for-record-views-mfc-data-access.md b/docs/data/user-interface-updating-for-record-views-mfc-data-access.md index 48c65f5c929..e221fc09c0d 100644 --- a/docs/data/user-interface-updating-for-record-views-mfc-data-access.md +++ b/docs/data/user-interface-updating-for-record-views-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: User-Interface Updating for Record Views (MFC Data Access)" -title: "User-Interface Updating for Record Views (MFC Data Access)" -ms.date: "11/04/2016" +title: "User-Interface Updating for Record Views (MFC Data Access)" +description: "Learn more about: User-Interface Updating for Record Views (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["user interfaces, updating", "menus, updating as context changes", "record views, user interface"] -ms.assetid: 2c7914b6-2dc3-40c3-b2f2-8371da2a4063 --- # User-Interface Updating for Record Views (MFC Data Access) diff --git a/docs/data/using-a-record-view-mfc-data-access.md b/docs/data/using-a-record-view-mfc-data-access.md index 85128e40ed1..425c7ce49b9 100644 --- a/docs/data/using-a-record-view-mfc-data-access.md +++ b/docs/data/using-a-record-view-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Using a Record View (MFC Data Access)" -title: "Using a Record View (MFC Data Access)" -ms.date: "11/04/2016" +title: "Using a Record View (MFC Data Access)" +description: "Learn more about: Using a Record View (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views, customizing default code"] -ms.assetid: 91f2828f-0666-4273-ae28-e4703fd98521 --- # Using a Record View (MFC Data Access) diff --git a/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md b/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md index 990f6b94339..f88cfad605f 100644 --- a/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md +++ b/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Your Role in Working with a Record View (MFC Data Access)" -title: "Your Role in Working with a Record View (MFC Data Access)" -ms.date: "11/04/2016" +title: "Your Role in Working with a Record View (MFC Data Access)" +description: "Learn more about: Your Role in Working with a Record View (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views, customizing default code", "MFC, record views"] -ms.assetid: 691e89a5-ff21-4ca3-9278-69d4678288bb --- # Your Role in Working with a Record View (MFC Data Access) diff --git a/docs/dotnet/auto-handle-class.md b/docs/dotnet/auto-handle-class.md index 31b76efd833..8363250a9a4 100644 --- a/docs/dotnet/auto-handle-class.md +++ b/docs/dotnet/auto-handle-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: auto_handle Class" title: "auto_handle Class" -ms.date: "01/16/2019" +description: "Learn more about: auto_handle Class" +ms.date: 01/16/2019 ms.topic: "reference" f1_keywords: ["msclr::auto_handle::auto_handle", "msclr::auto_handle::get", "msclr::auto_handle::release", "msclr::auto_handle::reset", "msclr::auto_handle::swap", "msclr::auto_handle::operator->", "msclr::auto_handle::operator=", "msclr::auto_handle::operator auto_handle", "msclr::auto_handle::operator!"] helpviewer_keywords: ["msclr::auto_handle class"] -ms.assetid: a65604d1-ecbb-44fd-ae2f-696ddeeed9d6 --- # auto_handle Class diff --git a/docs/extensions/abstract-cpp-component-extensions.md b/docs/extensions/abstract-cpp-component-extensions.md index 3f8be404e9e..495eb80faf8 100644 --- a/docs/extensions/abstract-cpp-component-extensions.md +++ b/docs/extensions/abstract-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: abstract (C++/CLI and C++/CX)" -title: "abstract (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "abstract (C++/CLI and C++/CX)" +description: "Learn more about: abstract (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["abstract", "abstract_cpp"] helpviewer_keywords: ["abstract keyword [C++]"] -ms.assetid: cbae3408-0378-4ac8-b70d-c016b381a6d5 --- # abstract (C++/CLI and C++/CX) diff --git a/docs/extensions/attribute-parameter-types-cpp-component-extensions.md b/docs/extensions/attribute-parameter-types-cpp-component-extensions.md index afefe6bff4f..6b54f8b8807 100644 --- a/docs/extensions/attribute-parameter-types-cpp-component-extensions.md +++ b/docs/extensions/attribute-parameter-types-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Attribute Parameter Types (C++/CLI and C++/CX)" -title: "Attribute Parameter Types (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Attribute Parameter Types (C++/CLI and C++/CX)" +description: "Learn more about: Attribute Parameter Types (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["custom attributes, parameter types"] -ms.assetid: d9f127a3-7f08-456f-acc6-256805632712 --- # Attribute Parameter Types (C++/CLI and C++/CX) diff --git a/docs/extensions/boxing-cpp-component-extensions.md b/docs/extensions/boxing-cpp-component-extensions.md index ae6c35f9660..a25066d75d9 100644 --- a/docs/extensions/boxing-cpp-component-extensions.md +++ b/docs/extensions/boxing-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Boxing (C++/CLI and C++/CX)" -title: "Boxing (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Boxing (C++/CLI and C++/CX)" +description: "Learn more about: Boxing (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["boxing, C++"] -ms.assetid: b5fd2c98-c578-4f83-8257-6dd663478665 --- # Boxing (C++/CLI and C++/CX) diff --git a/docs/extensions/classes-and-structs-cpp-component-extensions.md b/docs/extensions/classes-and-structs-cpp-component-extensions.md index 14e42972b17..43ca041916a 100644 --- a/docs/extensions/classes-and-structs-cpp-component-extensions.md +++ b/docs/extensions/classes-and-structs-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: ref class and ref struct (C++/CLI and C++/CX)" title: "ref class and ref struct (C++/CLI and C++/CX)" -ms.date: "05/30/2019" +description: "Learn more about: ref class and ref struct (C++/CLI and C++/CX)" +ms.date: 05/30/2019 ms.topic: "reference" f1_keywords: ["ref class", "value class", "ref struct", "value struct",] helpviewer_keywords: ["ref class keyword [C++]", "value class keyword [C++]", "value struct keyword [C++]", "ref struct keyword [C++]"] -ms.assetid: 5c360764-b229-49c6-9357-66213afbc372 --- # ref class and ref struct (C++/CLI and C++/CX) diff --git a/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md b/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md index e4621bce19a..8205699fbb6 100644 --- a/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md +++ b/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Context-Sensitive Keywords (C++/CLI and C++/CX)" -title: "Context-Sensitive Keywords (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Context-Sensitive Keywords (C++/CLI and C++/CX)" +description: "Learn more about: Context-Sensitive Keywords (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["internal_CPP"] helpviewer_keywords: ["context-sensitive keywords"] -ms.assetid: e33da089-f434-44e9-8cce-4668d05a8939 --- # Context-Sensitive Keywords (C++/CLI and C++/CX) diff --git a/docs/extensions/delegate-cpp-component-extensions.md b/docs/extensions/delegate-cpp-component-extensions.md index 90496b3951b..917f4954096 100644 --- a/docs/extensions/delegate-cpp-component-extensions.md +++ b/docs/extensions/delegate-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: delegate (C++/CLI and C++/CX)" -title: "delegate (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "delegate (C++/CLI and C++/CX)" +description: "Learn more about: delegate (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["delegate_cpp", "delegate"] helpviewer_keywords: ["delegate keyword [C++]"] -ms.assetid: 03caf23d-7873-4a23-9b34-becf42aaf429 --- # delegate (C++/CLI and C++/CX) diff --git a/docs/extensions/enum-class-cpp-component-extensions.md b/docs/extensions/enum-class-cpp-component-extensions.md index 1b3e30c4500..9d90a533304 100644 --- a/docs/extensions/enum-class-cpp-component-extensions.md +++ b/docs/extensions/enum-class-cpp-component-extensions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: enum class (C++/CLI and C++/CX)" -title: "enum class (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "enum class (C++/CLI and C++/CX)" +description: "Learn more about: enum class (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" -ms.assetid: 8010fa8c-bad6-45b4-8214-b4db64d7ffe1 --- # enum class (C++/CLI and C++/CX) diff --git a/docs/extensions/exception-handling-cpp-component-extensions.md b/docs/extensions/exception-handling-cpp-component-extensions.md index 841ea42df15..56a65971ca7 100644 --- a/docs/extensions/exception-handling-cpp-component-extensions.md +++ b/docs/extensions/exception-handling-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Exception Handling (C++/CLI and C++/CX)" -title: "Exception Handling (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Exception Handling (C++/CLI and C++/CX)" +description: "Learn more about: Exception Handling (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["structured exception handling [C++], managed exceptions", "Exception class, managed applications", "exception handling", "C++ exception handling", "exception handling, types of", "System::Exception class in managed applications"] -ms.assetid: ccb11fe8-6938-41ac-b477-a183e85865b9 --- # Exception Handling (C++/CLI and C++/CX) diff --git a/docs/extensions/explicit-overrides-cpp-component-extensions.md b/docs/extensions/explicit-overrides-cpp-component-extensions.md index b03d7b1b1dc..7a5a8f8bb22 100644 --- a/docs/extensions/explicit-overrides-cpp-component-extensions.md +++ b/docs/extensions/explicit-overrides-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Explicit Overrides (C++/CLI and C++/CX)" -title: "Explicit Overrides (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Explicit Overrides (C++/CLI and C++/CX)" +description: "Learn more about: Explicit Overrides (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["overriding, override [C++]"] -ms.assetid: 4ec3eaf5-163b-4df8-8f16-7a2ec04c3d0f --- # Explicit Overrides (C++/CLI and C++/CX) diff --git a/docs/extensions/generics-cpp-component-extensions.md b/docs/extensions/generics-cpp-component-extensions.md index 65304a6d6d6..3826f8d3dbe 100644 --- a/docs/extensions/generics-cpp-component-extensions.md +++ b/docs/extensions/generics-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -title: "Generics (C++/CLI and C++/CX)" +title: "Generics (C++/CLI and C++/CX)" description: "Links to content about the C++/CLI and C++/CX generics features, types, and methods." ms.date: 09/25/2020 ms.topic: "reference" f1_keywords: ["generic_cpp", "generic"] helpviewer_keywords: ["generics [C++]"] -ms.assetid: c7ccc316-a411-4c00-b2e2-f0c0eadc6cfd --- # Generics (C++/CLI and C++/CX) diff --git a/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md b/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md index e88997e5259..8bed5655da4 100644 --- a/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md +++ b/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Handle to Object Operator (^) (C++/CLI and C++/CX)" -title: "Handle to Object Operator (^) (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Handle to Object Operator (^) (C++/CLI and C++/CX)" +description: "Learn more about: Handle to Object Operator (^) (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["^ handle to object [C++]"] -ms.assetid: 70c411e6-be57-4468-a944-6ea7be89f392 --- # Handle to Object Operator (^) (C++/CLI and C++/CX) diff --git a/docs/extensions/interface-class-cpp-component-extensions.md b/docs/extensions/interface-class-cpp-component-extensions.md index 1779d67e42d..d4e614dc8ac 100644 --- a/docs/extensions/interface-class-cpp-component-extensions.md +++ b/docs/extensions/interface-class-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- +title: "interface class (C++/CLI and C++/CX)" description: "Learn more about: interface class (C++/CLI and C++/CX)" -title: "interface class (C++/CLI and C++/CX)" ms.date: 04/15/2022 ms.topic: "reference" f1_keywords: ["interface_CPP", "interface class", "interface class_CPP"] helpviewer_keywords: ["interface class keyword", "interface struct keyword"] -ms.assetid: 3ccea701-f50b-4da7-ad6b-f0ee1203e2b9 --- # `interface class` (C++/CLI and C++/CX) diff --git a/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md b/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md index 76cb16a7034..4c1932c3068 100644 --- a/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md +++ b/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: new (new slot in vtable) (C++/CLI and C++/CX)" -title: "new (new slot in vtable) (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "new (new slot in vtable) (C++/CLI and C++/CX)" +description: "Learn more about: new (new slot in vtable) (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["new keyword [C++]"] -ms.assetid: 1a9a5704-f02f-46ae-ad65-f0f2b6dbabc3 --- # new (new slot in vtable) (C++/CLI and C++/CX) diff --git a/docs/extensions/nullptr-cpp-component-extensions.md b/docs/extensions/nullptr-cpp-component-extensions.md index 59436902014..e0784388095 100644 --- a/docs/extensions/nullptr-cpp-component-extensions.md +++ b/docs/extensions/nullptr-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: nullptr (C++/CLI and C++/CX)" -title: "nullptr (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "nullptr (C++/CLI and C++/CX)" +description: "Learn more about: nullptr (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["__nullptr keyword (C++)", "nullptr keyword [C++]"] -ms.assetid: 594cfbf7-06cb-4366-9ede-c0b703e1d095 --- # nullptr (C++/CLI and C++/CX) diff --git a/docs/extensions/override-cpp-component-extensions.md b/docs/extensions/override-cpp-component-extensions.md index cd1143048be..3dbe034d525 100644 --- a/docs/extensions/override-cpp-component-extensions.md +++ b/docs/extensions/override-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: override (C++/CLI and C++/CX)" -title: "override (C++/CLI and C++/CX)" -ms.date: "11/04/2016" +title: "override (C++/CLI and C++/CX)" +description: "Learn more about: override (C++/CLI and C++/CX)" +ms.date: 11/04/2016 ms.topic: "reference" helpviewer_keywords: ["overriding, override keyword [C++]", "override keyword [C++]"] -ms.assetid: 34d19257-1686-4fcd-96f5-af07c70ba914 --- # override (C++/CLI and C++/CX) diff --git a/docs/extensions/override-specifiers-cpp-component-extensions.md b/docs/extensions/override-specifiers-cpp-component-extensions.md index fce37f749cb..ea644986a34 100644 --- a/docs/extensions/override-specifiers-cpp-component-extensions.md +++ b/docs/extensions/override-specifiers-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Override Specifiers (C++/CLI and C++/CX)" -title: "Override Specifiers (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Override Specifiers (C++/CLI and C++/CX)" +description: "Learn more about: Override Specifiers (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["override specifiers, C++", "override specifiers"] -ms.assetid: 155bbf6f-4722-4654-afb1-9cb52af799fb --- # Override Specifiers (C++/CLI and C++/CX) diff --git a/docs/extensions/partial-cpp-component-extensions.md b/docs/extensions/partial-cpp-component-extensions.md index 7a8a1cd119a..495d65b25cd 100644 --- a/docs/extensions/partial-cpp-component-extensions.md +++ b/docs/extensions/partial-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: partial (C++/CLI and C++/CX)" -title: "partial (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "partial (C++/CLI and C++/CX)" +description: "Learn more about: partial (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["partial_CPP"] helpviewer_keywords: ["partial", "C++/CX, partial"] -ms.assetid: 43adf1f5-10c5-44aa-a66f-7507e2bdabf8 --- # partial (C++/CLI and C++/CX) diff --git a/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md b/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md index ce3a77f3d84..ee36ff73725 100644 --- a/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md +++ b/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform, default, and cli Namespaces (C++/CLI and C++/CX)" -title: "Platform, default, and cli Namespaces (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Platform, default, and cli Namespaces (C++/CLI and C++/CX)" +description: "Learn more about: Platform, default, and cli Namespaces (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["lang", "cli"] helpviewer_keywords: ["lang namespace", "cli namespace"] -ms.assetid: 9d38bd1e-dc78-47d1-a84b-9b4683e52c9c --- # Platform, default, and cli Namespaces (C++/CLI and C++/CX) diff --git a/docs/extensions/ref-new-gcnew-cpp-component-extensions.md b/docs/extensions/ref-new-gcnew-cpp-component-extensions.md index a27aba3d623..13c1a6812be 100644 --- a/docs/extensions/ref-new-gcnew-cpp-component-extensions.md +++ b/docs/extensions/ref-new-gcnew-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: ref new, gcnew (C++/CLI and C++/CX)" -title: "ref new, gcnew (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "ref new, gcnew (C++/CLI and C++/CX)" +description: "Learn more about: ref new, gcnew (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["gcnew", "ref new", "gcnew_cpp"] helpviewer_keywords: ["ref new keyword (C++)", "gcnew keyword [C++]"] -ms.assetid: 388a62da-c2df-4a94-a9a2-205b53e577da --- # ref new, gcnew (C++/CLI and C++/CX) diff --git a/docs/extensions/sealed-cpp-component-extensions.md b/docs/extensions/sealed-cpp-component-extensions.md index 484218b4cbe..e44afac2b7d 100644 --- a/docs/extensions/sealed-cpp-component-extensions.md +++ b/docs/extensions/sealed-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: sealed (C++/CLI and C++/CX)" -title: "sealed (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "sealed (C++/CLI and C++/CX)" +description: "Learn more about: sealed (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["sealed_cpp", "sealed"] helpviewer_keywords: ["sealed keyword [C++]"] -ms.assetid: 3d0d688a-41aa-45f5-a25a-65c44206521e --- # sealed (C++/CLI and C++/CX) diff --git a/docs/extensions/string-cpp-component-extensions.md b/docs/extensions/string-cpp-component-extensions.md index 2fd5a545377..de9ff62f36e 100644 --- a/docs/extensions/string-cpp-component-extensions.md +++ b/docs/extensions/string-cpp-component-extensions.md @@ -1,6 +1,6 @@ --- -title: "String (C++/CLI and C++/CX)" -description: "Learn more about: String (C++/CLI and C++/CX)" +title: "String (C++/CLI and C++/CX)" +description: "Learn more about: String (C++/CLI and C++/CX)" ms.date: 10/08/2018 ms.topic: "reference" helpviewer_keywords: ["string support with /clr", "/clr compiler option [C++], string support"] diff --git a/docs/extensions/typeid-cpp-component-extensions.md b/docs/extensions/typeid-cpp-component-extensions.md index a9ad3c8f639..33c7d5fe5d0 100644 --- a/docs/extensions/typeid-cpp-component-extensions.md +++ b/docs/extensions/typeid-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: typeid (C++/CLI and C++/CX)" -title: "typeid (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "typeid (C++/CLI and C++/CX)" +description: "Learn more about: typeid (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["typeid keyword [C++]"] -ms.assetid: e9706cae-e7c4-4d6d-b474-646d73df3e70 --- # typeid (C++/CLI and C++/CX) diff --git a/docs/extensions/user-defined-attributes-cpp-component-extensions.md b/docs/extensions/user-defined-attributes-cpp-component-extensions.md index 7684bb9cc51..f9f9b7c0346 100644 --- a/docs/extensions/user-defined-attributes-cpp-component-extensions.md +++ b/docs/extensions/user-defined-attributes-cpp-component-extensions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: User-Defined Attributes (C++/CLI and C++/CX)" -title: "User-Defined Attributes (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "User-Defined Attributes (C++/CLI and C++/CX)" +description: "Learn more about: User-Defined Attributes (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["metadata, extending", "custom attributes, extending metadata"] -ms.assetid: 98b29048-a3ea-4698-8441-f149cdaec9fb --- # User-Defined Attributes (C++/CLI and C++/CX) diff --git a/docs/parallel/amp/reference/runtime-exception-class.md b/docs/parallel/amp/reference/runtime-exception-class.md index 93a200d00c1..ae03941949e 100644 --- a/docs/parallel/amp/reference/runtime-exception-class.md +++ b/docs/parallel/amp/reference/runtime-exception-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: runtime_exception Class" title: "runtime_exception Class" -ms.date: "03/27/2019" +description: "Learn more about: runtime_exception Class" +ms.date: 03/27/2019 f1_keywords: ["runtime_exception", "AMPRT/runtime_exception", "AMPRT/Concurrency::runtime_exception", "AMPRT/Concurrency::runtime_exception::get_error_code"] helpviewer_keywords: ["runtime_exception class"] -ms.assetid: 8fe3ce2c-3d4c-4b9c-95e8-e592f37adefd --- # runtime_exception Class diff --git a/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md b/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md index 1200771b770..19797cae521 100644 --- a/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md +++ b/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: How to: Use Exception Handling to Break from a Parallel Loop" title: "How to: Use Exception Handling to Break from a Parallel Loop" -ms.date: "11/04/2016" +description: "Learn more about: How to: Use Exception Handling to Break from a Parallel Loop" +ms.date: 11/04/2016 helpviewer_keywords: ["search algorithm, writing [Concurrency Runtime]", "writing a search algorithm [Concurrency Runtime]"] -ms.assetid: 16d7278c-2d10-4014-9f58-f1899e719ff9 --- # How to: Use Exception Handling to Break from a Parallel Loop diff --git a/docs/standard-library/month-class.md b/docs/standard-library/month-class.md index d024a42fcf3..f43deea25ab 100644 --- a/docs/standard-library/month-class.md +++ b/docs/standard-library/month-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: month Class" title: "month class" -ms.date: "6/25/2021" +description: "Learn more about: month Class" +ms.date: 6/25/2021 f1_keywords: ["chrono/std::chrono::month", "chrono/std::chrono::month::January", "chrono/std::chrono::month::February", "chrono/std::chrono::month::March","chrono/std::chrono::month::April","chrono/std::chrono::month::May","chrono/std::chrono::month::June","chrono/std::chrono::month::July","chrono/std::chrono::month::August","chrono/std::chrono::month::September","chrono/std::chrono::month::October","chrono/std::chrono::month::November","chrono/std::chrono::month::December","chrono/std::chrono::month::operator++", "chrono/std::chrono::month::operator--", "chrono/std::chrono::month::operator unsigned", "chrono/std::chrono::month::ok"] helpviewer_keywords: ["std::chrono [C++], month"] dev_langs: ["C++"] diff --git a/docs/standard-library/month-day-class.md b/docs/standard-library/month-day-class.md index d28a608bccd..f8f80f65f9a 100644 --- a/docs/standard-library/month-day-class.md +++ b/docs/standard-library/month-day-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: month_day Class" title: "month_day class" -ms.date: "6/28/2021" +description: "Learn more about: month_day Class" +ms.date: 6/28/2021 f1_keywords: ["chrono/std::chrono::month_day", "chrono/std::chrono::month_day::day", "chrono/std::chrono::month_day::month", "chrono/std::chrono::month_day::ok"] helpviewer_keywords: ["std::chrono [C++], month_day"] dev_langs: ["C++"] diff --git a/docs/standard-library/month-day-last-class.md b/docs/standard-library/month-day-last-class.md index b84b8247bc6..bc2a97a90bc 100644 --- a/docs/standard-library/month-day-last-class.md +++ b/docs/standard-library/month-day-last-class.md @@ -1,7 +1,7 @@ --- title: "month_day_last class" description: "Learn more about: month_day_last Class" -ms.date: "06/28/2021" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::month_day_last", "chrono/std::chrono::month_day_last::month", "chrono/std::chrono::month_day_last::ok"] helpviewer_keywords: ["std::chrono [C++], month_day_last"] dev_langs: ["C++"] diff --git a/docs/standard-library/month-weekday-class.md b/docs/standard-library/month-weekday-class.md index 2c4cbfea5ce..a82659be430 100644 --- a/docs/standard-library/month-weekday-class.md +++ b/docs/standard-library/month-weekday-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: month_weekday Class" title: "month_weekday class" -ms.date: "06/28/2021" +description: "Learn more about: month_weekday Class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::month_weekday", "chrono/std::chrono::month_weekday::weekday", "chrono/std::chrono::month_weekday::month", "chrono/std::chrono::month_weekday::ok", "chrono/std::chrono::month_weekday::weekday_indexed"] helpviewer_keywords: ["std::chrono [C++], month_weekday"] dev_langs: ["C++"] diff --git a/docs/standard-library/month-weekday-last-class.md b/docs/standard-library/month-weekday-last-class.md index 78e17b33533..9af2b50a786 100644 --- a/docs/standard-library/month-weekday-last-class.md +++ b/docs/standard-library/month-weekday-last-class.md @@ -1,7 +1,7 @@ --- title: "month_weekday_last class" description: "Learn more about: month_weekday_last Class" -ms.date: "6/28/2021" +ms.date: 6/28/2021 f1_keywords: ["chrono/std::chrono::month_weekday_last", "chrono/std::chrono::month_weekday_last::ok", "std::chrono::month_weekday_last::month_weekday_last", "chrono/std::chrono::month_weekday_last::ok", "chrono/std::chrono::month_weekday_last::month"] helpviewer_keywords: ["std::chrono [C++], month_weekday_last"] dev_langs: ["C++"] diff --git a/docs/standard-library/recursive-mutex-class.md b/docs/standard-library/recursive-mutex-class.md index 60935d02799..68223c40baa 100644 --- a/docs/standard-library/recursive-mutex-class.md +++ b/docs/standard-library/recursive-mutex-class.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: recursive_mutex Class" title: "recursive_mutex Class" -ms.date: "11/04/2016" +description: "Learn more about: recursive_mutex Class" +ms.date: 11/04/2016 f1_keywords: ["mutex/std::recursive_mutex", "mutex/std::recursive_mutex::recursive_mutex", "mutex/std::recursive_mutex::lock", "mutex/std::recursive_mutex::try_lock", "mutex/std::recursive_mutex::unlock"] -ms.assetid: eb5ffd1b-7e78-4559-8391-bb220ead42fc helpviewer_keywords: ["std::recursive_mutex [C++]", "std::recursive_mutex [C++], recursive_mutex", "std::recursive_mutex [C++], lock", "std::recursive_mutex [C++], try_lock", "std::recursive_mutex [C++], unlock"] --- # recursive_mutex Class diff --git a/docs/standard-library/recursive-timed-mutex-class.md b/docs/standard-library/recursive-timed-mutex-class.md index 4f2f2b5ef87..d105a0a2646 100644 --- a/docs/standard-library/recursive-timed-mutex-class.md +++ b/docs/standard-library/recursive-timed-mutex-class.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: recursive_timed_mutex Class" title: "recursive_timed_mutex Class" -ms.date: "11/04/2016" +description: "Learn more about: recursive_timed_mutex Class" +ms.date: 11/04/2016 f1_keywords: ["mutex/std::recursive_timed_mutex", "mutex/std::recursive_timed_mutex::recursive_timed_mutex", "mutex/std::recursive_timed_mutex::lock", "mutex/std::recursive_timed_mutex::try_lock", "mutex/std::recursive_timed_mutex::try_lock_for", "mutex/std::recursive_timed_mutex::try_lock_until", "mutex/std::recursive_timed_mutex::unlock"] -ms.assetid: 59cc2d5c-ed80-45f3-a0a8-05652a8ead7e helpviewer_keywords: ["std::recursive_timed_mutex [C++]", "std::recursive_timed_mutex [C++], recursive_timed_mutex", "std::recursive_timed_mutex [C++], lock", "std::recursive_timed_mutex [C++], try_lock", "std::recursive_timed_mutex [C++], try_lock_for", "std::recursive_timed_mutex [C++], try_lock_until", "std::recursive_timed_mutex [C++], unlock"] --- # recursive_timed_mutex Class diff --git a/docs/standard-library/unique-lock-class.md b/docs/standard-library/unique-lock-class.md index 536efb34dd5..6332a02e08d 100644 --- a/docs/standard-library/unique-lock-class.md +++ b/docs/standard-library/unique-lock-class.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: unique_lock Class" title: "unique_lock Class" +description: "Learn more about: unique_lock Class" ms.date: 06/20/2022 f1_keywords: ["mutex/std::unique_lock"] -ms.assetid: f4ed8ba9-c8af-446f-8ef0-0b356bad14bd ms.custom: devdivchpfy22 --- diff --git a/docs/standard-library/weekday-class.md b/docs/standard-library/weekday-class.md index a71c8b495ea..5e4e5b34ee8 100644 --- a/docs/standard-library/weekday-class.md +++ b/docs/standard-library/weekday-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: weekday Class" title: "weekday class" -ms.date: "6/25/2021" +description: "Learn more about: weekday Class" +ms.date: 6/25/2021 f1_keywords: ["chrono/std::chrono::weekday", "chrono/std::chrono::weekday::January", "chrono/std::chrono::weekday::February", "chrono/std::chrono::weekday::March","chrono/std::chrono::weekday::April","chrono/std::chrono::weekday::May","chrono/std::chrono::weekday::June","chrono/std::chrono::weekday::July","chrono/std::chrono::weekday::August","chrono/std::chrono::weekday::September","chrono/std::chrono::weekday::October","chrono/std::chrono::weekday::November","chrono/std::chrono::weekday::December","chrono/std::chrono::weekday::operator++", "chrono/std::chrono::weekday::operator--", "chrono/std::chrono::weekday::operator unsigned", "chrono/std::chrono::weekday::ok", "chrono/std::chrono::weekday::iso_encoding", "chrono/std::chrono::weekday::c_encoding"] helpviewer_keywords: ["std::chrono [C++], weekday"] --- diff --git a/docs/standard-library/weekdayindexed-class.md b/docs/standard-library/weekdayindexed-class.md index 7f2121515e7..0bd80a89203 100644 --- a/docs/standard-library/weekdayindexed-class.md +++ b/docs/standard-library/weekdayindexed-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: weekday_indexed Class" title: "weekday_indexed class" -ms.date: "06/25/2021" +description: "Learn more about: weekday_indexed Class" +ms.date: 06/25/2021 f1_keywords: ["chrono/std::chrono::weekday_indexed", "chrono/std::chrono::weekday_indexed::ok", "std::chrono::weekday_indexed::weekday", "std::chrono::weekday_indexed::ok"] helpviewer_keywords: ["std::chrono [C++], weekday_indexed"] --- diff --git a/docs/standard-library/weekdaylast-class.md b/docs/standard-library/weekdaylast-class.md index 9f545c9935e..ab0b3dff1e4 100644 --- a/docs/standard-library/weekdaylast-class.md +++ b/docs/standard-library/weekdaylast-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: weekday_last Class" title: "weekday_last class" -ms.date: "06/28/2021" +description: "Learn more about: weekday_last Class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::weekday_last", "chrono/std::chrono::weekday_last::ok", "std::chrono::weekday_last::weekday", "chrono/std::chrono::weekday_last::ok", "chrono/std::chrono::weekday_last::weekday"] helpviewer_keywords: ["std::chrono [C++], weekday_last"] --- diff --git a/docs/standard-library/year-class.md b/docs/standard-library/year-class.md index 85d0bb1d0fe..4ada39cf99d 100644 --- a/docs/standard-library/year-class.md +++ b/docs/standard-library/year-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: year Class" title: "year class" -ms.date: "06/28/2021" +description: "Learn more about: year Class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::year", "chrono/std::chrono::year::operator++", "chrono/std::chrono::year::operator--", "chrono/std::chrono::year::operator+=", "chrono/std::chrono::year::operator-=", "chrono/std::chrono::year::operator int", "chrono/std::chrono::year::is_leap", "chrono/std::chrono::year::max", "chrono/std::chrono::min", "chrono/std::chrono::year::ok"] helpviewer_keywords: ["std::chrono [C++], year"] --- diff --git a/docs/standard-library/year-month-class.md b/docs/standard-library/year-month-class.md index 8bc06ee90b5..e76df35fa2c 100644 --- a/docs/standard-library/year-month-class.md +++ b/docs/standard-library/year-month-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: year_month class" title: "year_month class" -ms.date: "06/28/2021" +description: "Learn more about: year_month class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::year_month", "chrono/std::chrono::year_month::operator+=", "chrono/std::chrono::year_month::operator-=", "chrono/std::chrono::year_month::ok"] helpviewer_keywords: ["std::chrono [C++], year_month"] dev_langs: ["C++"] diff --git a/docs/standard-library/year-month-day-class.md b/docs/standard-library/year-month-day-class.md index 7a1c6241270..3f40644e579 100644 --- a/docs/standard-library/year-month-day-class.md +++ b/docs/standard-library/year-month-day-class.md @@ -1,7 +1,7 @@ --- title: "year_month_day class" description: "Learn more about: year_month_day class" -ms.date: "06/28/2021" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::year_month_day", "chrono/std::chrono::year::operator+=", "chrono/std::chrono::year::operator-=", "chrono/std::chrono::year::sysdays", "chrono/std::chrono::year::localdays", "chrono/std::chrono::year::ok"] helpviewer_keywords: ["std::chrono [C++], year_month_day"] --- diff --git a/docs/standard-library/year-month-day-last-class.md b/docs/standard-library/year-month-day-last-class.md index 49925160412..b3bfc146db2 100644 --- a/docs/standard-library/year-month-day-last-class.md +++ b/docs/standard-library/year-month-day-last-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: year_month_day_last class" title: "year_month_day_last class" -ms.date: "06/28/2021" +description: "Learn more about: year_month_day_last class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::year_month_day_last", "chrono/std::chrono::year_month_day_last::operator+=", "chrono/std::chrono::year_month_day_last::operator-=", "chrono/std::chrono::year_month_day_last::sysdays", "chrono/std::chrono::year_month_day_last::local_days", "chrono/std::chrono::year_month_day_last::day", "chrono/std::chrono::year_month_day_last::year", "chrono/std::chrono::year_month_day_last::ok"] helpviewer_keywords: ["std::chrono [C++], year_month_day_last"] dev_langs: ["C++"] diff --git a/docs/standard-library/year-month-weekday-last-class.md b/docs/standard-library/year-month-weekday-last-class.md index 01d97cfd6cd..d7a2a3aba2d 100644 --- a/docs/standard-library/year-month-weekday-last-class.md +++ b/docs/standard-library/year-month-weekday-last-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: year_month_weekday_last class" title: "year_month_weekday_last class" -ms.date: "06/30/2021" +description: "Learn more about: year_month_weekday_last class" +ms.date: 06/30/2021 f1_keywords: ["chrono/std::chrono::year_month_weekday_last", "chrono/std::chrono::year_month_weekday_last::month", "chrono/std::chrono::year_month_weekday_last::year", "chrono/std::chrono::year_month_weekday_last::weekday", "chrono/std::chrono::year_month_weekday_last::weekday_last", "chrono/std::chrono::year_month_weekday_last::sys_days", "chrono/std::chrono::year_month_weekday_last::local_days", "chrono/std::chrono::year_month_weekday_last::ok", "chrono/std::chrono::year_month_weekday_last::operator+=", "chrono/std::chrono::year_month_weekday_last::operator-=", "chrono/std::chrono::year_month_weekday_last::operator local_days", "chrono/std::chrono::year_month_weekday_last::operator sys_days"] helpviewer_keywords: ["std::chrono [C++], year_month_weekday_last"] dev_langs: ["C++"] From 08ebd7d6723623f48bd5285047207e4d3490f3d3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 18:23:06 +0800 Subject: [PATCH 0146/1799] Add backticks in "Function Objects in the C++ Standard Library" article --- docs/standard-library/function-objects-in-the-stl.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/function-objects-in-the-stl.md b/docs/standard-library/function-objects-in-the-stl.md index e1055bf6f6d..b69161ed48f 100644 --- a/docs/standard-library/function-objects-in-the-stl.md +++ b/docs/standard-library/function-objects-in-the-stl.md @@ -7,13 +7,13 @@ ms.assetid: 85f8a735-2c7b-4f10-9c4d-95c666ec4192 --- # Function Objects in the C++ Standard Library -A *function object*, or *functor*, is any type that implements operator(). This operator is referred to as the *call operator* or sometimes the *application operator*. The C++ Standard Library uses function objects primarily as sorting criteria for containers and in algorithms. +A *function object*, or *functor*, is any type that implements `operator()`. This operator is referred to as the *call operator* or sometimes the *application operator*. The C++ Standard Library uses function objects primarily as sorting criteria for containers and in algorithms. Function objects provide two main advantages over a straight function call. The first is that a function object can contain state. The second is that a function object is a type and therefore can be used as a template parameter. ## Creating a Function Object -To create a function object, create a type and implement operator(), such as: +To create a function object, create a type and implement `operator()`, such as: ```cpp class Functor @@ -34,7 +34,7 @@ int main() } ``` -The last line of the `main` function shows how you call the function object. This call looks like a call to a function, but it's actually calling operator() of the Functor type. This similarity between calling a function object and a function is how the term function object came about. +The last line of the `main` function shows how you call the function object. This call looks like a call to a function, but it's actually calling `operator()` of the `Functor` type. This similarity between calling a function object and a function is how the term function object came about. ## Function Objects and Containers From f9fb8ef6890ef3674d7f977dae12ae73977414bd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 18:50:17 +0800 Subject: [PATCH 0147/1799] Tighten wording in "Function Objects in the C++ Standard Library" article --- docs/standard-library/function-objects-in-the-stl.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/function-objects-in-the-stl.md b/docs/standard-library/function-objects-in-the-stl.md index b69161ed48f..d92c8e65566 100644 --- a/docs/standard-library/function-objects-in-the-stl.md +++ b/docs/standard-library/function-objects-in-the-stl.md @@ -9,7 +9,7 @@ ms.assetid: 85f8a735-2c7b-4f10-9c4d-95c666ec4192 A *function object*, or *functor*, is any type that implements `operator()`. This operator is referred to as the *call operator* or sometimes the *application operator*. The C++ Standard Library uses function objects primarily as sorting criteria for containers and in algorithms. -Function objects provide two main advantages over a straight function call. The first is that a function object can contain state. The second is that a function object is a type and therefore can be used as a template parameter. +Function objects provide two main advantages over a regular function call. The first is that a function object can contain state. The second is that a function object is a type and therefore can be used as a template parameter. ## Creating a Function Object @@ -51,7 +51,7 @@ The second template argument is the function object `less`. This function object ## Function Objects and Algorithms -Another use of functional objects is in algorithms. For example, the `remove_if` algorithm is declared as follows: +Another use of function objects is in algorithms. For example, the `remove_if` algorithm is declared as follows: ```cpp template @@ -61,7 +61,7 @@ ForwardIterator remove_if( Predicate pred); ``` -The last argument to `remove_if` is a function object that returns a boolean value (a *predicate*). If the result of the function object is **`true`**, then the element is removed from the container being accessed by the iterators `first` and `last`. You can use any of the function objects declared in the [``](../standard-library/functional.md) header for the argument `pred` or you can create your own. +The last argument to `remove_if` is a function object that returns a boolean value (a *predicate*). If the result of the function object is **`true`**, then the element is shifted such that it's beyond the new end returned by `remove_if`. You can use any of the function objects declared in the [``](../standard-library/functional.md) header for the argument `pred` or you can create your own. ## See also From ef934d9568129bc66b1b4d24c5c5e32b6523f544 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 18:53:23 +0800 Subject: [PATCH 0148/1799] Trim relative links in "Function Objects in the C++ Standard Library" article --- docs/standard-library/function-objects-in-the-stl.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/function-objects-in-the-stl.md b/docs/standard-library/function-objects-in-the-stl.md index d92c8e65566..7fa8c3ac9f2 100644 --- a/docs/standard-library/function-objects-in-the-stl.md +++ b/docs/standard-library/function-objects-in-the-stl.md @@ -38,7 +38,7 @@ The last line of the `main` function shows how you call the function object. Thi ## Function Objects and Containers -The C++ Standard Library contains several function objects in the [``](../standard-library/functional.md) header file. One use of these function objects is as a sorting criterion for containers. For example, the `set` container is declared as follows: +The C++ Standard Library contains several function objects in the [``](functional.md) header file. One use of these function objects is as a sorting criterion for containers. For example, the `set` container is declared as follows: ```cpp template `](../standard-library/functional.md) header for the argument `pred` or you can create your own. +The last argument to `remove_if` is a function object that returns a boolean value (a *predicate*). If the result of the function object is **`true`**, then the element is shifted such that it's beyond the new end returned by `remove_if`. You can use any of the function objects declared in the [``](functional.md) header for the argument `pred` or you can create your own. ## See also -[C++ Standard Library Reference](../standard-library/cpp-standard-library-reference.md) +[C++ Standard Library Reference](cpp-standard-library-reference.md) From ce4459dc19f9162a73e93cf5a01c86133187cc77 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 18:57:06 +0800 Subject: [PATCH 0149/1799] Add links in "Function Objects in the C++ Standard Library" article --- docs/standard-library/function-objects-in-the-stl.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/function-objects-in-the-stl.md b/docs/standard-library/function-objects-in-the-stl.md index 7fa8c3ac9f2..e03f0c28c81 100644 --- a/docs/standard-library/function-objects-in-the-stl.md +++ b/docs/standard-library/function-objects-in-the-stl.md @@ -38,7 +38,7 @@ The last line of the `main` function shows how you call the function object. Thi ## Function Objects and Containers -The C++ Standard Library contains several function objects in the [``](functional.md) header file. One use of these function objects is as a sorting criterion for containers. For example, the `set` container is declared as follows: +The C++ Standard Library contains several function objects in the [``](functional.md) header file. One use of these function objects is as a sorting criterion for containers. For example, the [`set`](set-class.md) container is declared as follows: ```cpp template From f8ed85fa8441070724203316849278b6c24fd8c5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 19:03:20 +0800 Subject: [PATCH 0150/1799] Improve example in "Function Objects in the C++ Standard Library" article --- docs/standard-library/function-objects-in-the-stl.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/standard-library/function-objects-in-the-stl.md b/docs/standard-library/function-objects-in-the-stl.md index e03f0c28c81..446cc5f233a 100644 --- a/docs/standard-library/function-objects-in-the-stl.md +++ b/docs/standard-library/function-objects-in-the-stl.md @@ -16,10 +16,10 @@ Function objects provide two main advantages over a regular function call. The f To create a function object, create a type and implement `operator()`, such as: ```cpp -class Functor +class LessThanFunctor { public: - int operator()(int a, int b) + bool operator()(int a, int b) { return a < b; } @@ -27,14 +27,14 @@ public: int main() { - Functor f; + LessThanFunctor less_than; int a = 5; int b = 7; - int ans = f(a, b); + bool ans = less_than(a, b); } ``` -The last line of the `main` function shows how you call the function object. This call looks like a call to a function, but it's actually calling `operator()` of the `Functor` type. This similarity between calling a function object and a function is how the term function object came about. +The last line of the `main` function shows how you call the function object. This call looks like a call to a function, but it's actually calling `operator()` of the `LessThanFunctor` type. This similarity between calling a function object and a function is how the term function object came about. ## Function Objects and Containers From 9e2c8ec8e44aea055ebc9581ee20589a36a316b9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 19:08:30 +0800 Subject: [PATCH 0151/1799] Update `set` and `remove_if` syntax in "Function Objects in the C++ Standard Library" article --- docs/standard-library/function-objects-in-the-stl.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/standard-library/function-objects-in-the-stl.md b/docs/standard-library/function-objects-in-the-stl.md index 446cc5f233a..325b48aae06 100644 --- a/docs/standard-library/function-objects-in-the-stl.md +++ b/docs/standard-library/function-objects-in-the-stl.md @@ -42,9 +42,9 @@ The C++ Standard Library contains several function objects in the [` ```cpp template , - class Allocator=allocator> -class set + class Compare = std::less, + class Allocator = std::allocator> +class set; ``` The second template argument is the function object [`less`](less-struct.md). This function object returns **`true`** if the first parameter is less than the second parameter. Since some containers sort their elements, the container needs a way of comparing two elements. The comparison is done by using the function object. You can define your own sorting criteria for containers by creating a function object and specifying it in the template list for the container. @@ -54,11 +54,11 @@ The second template argument is the function object [`less`](less-struct.md). Th Another use of function objects is in algorithms. For example, the [`remove_if`](algorithm-functions.md#remove_if) algorithm is declared as follows: ```cpp -template +template ForwardIterator remove_if( ForwardIterator first, ForwardIterator last, - Predicate pred); + UnaryPredicate pred); ``` The last argument to `remove_if` is a function object that returns a boolean value (a *predicate*). If the result of the function object is **`true`**, then the element is shifted such that it's beyond the new end returned by `remove_if`. You can use any of the function objects declared in the [``](functional.md) header for the argument `pred` or you can create your own. From d709f242e836a1bde6ada34f029522ae7e704ad8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 19:09:38 +0800 Subject: [PATCH 0152/1799] Update metadata in "Function Objects in the C++ Standard Library" article --- docs/standard-library/function-objects-in-the-stl.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/function-objects-in-the-stl.md b/docs/standard-library/function-objects-in-the-stl.md index 325b48aae06..4289ec032ea 100644 --- a/docs/standard-library/function-objects-in-the-stl.md +++ b/docs/standard-library/function-objects-in-the-stl.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Function Objects in the C++ Standard Library" title: "Function Objects in the C++ Standard Library" -ms.date: "03/15/2019" +description: "Learn more about: Function Objects in the C++ Standard Library" +ms.date: 06/22/2025 helpviewer_keywords: ["functors", "C++ Standard Library, functors", "C++ Standard Library, function objects", "function objects"] -ms.assetid: 85f8a735-2c7b-4f10-9c4d-95c666ec4192 --- # Function Objects in the C++ Standard Library From 8fd5bfd56567b51efa48e2eac26278bfacbf275a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 22:08:19 +0800 Subject: [PATCH 0153/1799] Fix inverted "Adaptor containers" in "C++ standard library header files" topic --- docs/standard-library/cpp-standard-library-header-files.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index a0eaf3e4630..0a715110332 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -58,7 +58,7 @@ Header files for the C++ standard library and extensions, by category. |Sequence containers|[``](array.md), [``](deque.md), [``](forward-list.md), [``](list.md), [``](vector.md)| |Ordered associative containers| [``](map.md), [``](set.md)| |Unordered associative containers|[``](unordered-map.md), [``](unordered-set.md)| -|Adaptor containers|[``](queue.md), [``](stack.md)| +|Container adaptors|[``](queue.md), [``](stack.md)| |[Errors and exception handling](../cpp/errors-and-exception-handling-modern-cpp.md)|[``](exception.md), [``](stdexcept.md), [``](system-error.md)| |[I/O and formatting](../text/string-and-i-o-formatting-modern-cpp.md)|[``](filesystem.md), [``](fstream.md), [``](iomanip.md), [``](ios.md), [``](iosfwd.md), [``](iostream.md), [``](istream.md), [``](ostream.md), [``](sstream.md), [``](streambuf.md), [``](strstream.md)| |Iterators|[``](iterator.md)| From 962e9ebd5624fa0a0361ec2af7c3657cb52c887c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 22:14:48 +0800 Subject: [PATCH 0154/1799] Update superscript entries in "C++ standard library header files" topic --- docs/standard-library/cpp-standard-library-header-files.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index 0a715110332..0472fb61227 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -41,9 +41,11 @@ Header files for the C++ standard library and extensions, by category. 11 Added in the C++11 standard.\ 14 Added in the C++14 standard.\ 17 Added in the C++17 standard.\ -20 Added in the draft C++20 standard.\ +20 Added in the C++20 standard.\ +23 Added in the C++23 standard.\ +26 Added in the draft C++26 standard.\ a Deprecated in the C++17 standard.\ -b Removed in the draft C++20 standard.\ +b Removed in the C++20 standard.\ c Deprecated in the C++98 standard. ::: moniker-end From 3c4f9b1abab29cc4b7c1baac1690a5ae8af98a35 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 22:15:46 +0800 Subject: [PATCH 0155/1799] Resolve incorrect `` header in "C++ standard library header files" topic --- docs/standard-library/cpp-standard-library-header-files.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index 0472fb61227..80d71c4feb2 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -28,7 +28,7 @@ Header files for the C++ standard library and extensions, by category. | General utilities | [``](any.md)17, [``](bit.md)20, [``](bitset.md), [``](cstdlib.md), [``](execution.md)17, [``](functional.md), [``](memory.md), [``](memory-resource.md)17, [``](optional.md)17, [``](ratio.md)11, [``](scoped-allocator.md)11, [``](tuple.md)11, [``](type-traits.md)11, [``](typeindex.md)11, [``](utility.md), [``](variant.md)17 | | [I/O and formatting](../text/string-and-i-o-formatting-modern-cpp.md) | [``](cinttypes.md)11, [``](cstdio.md), [``](filesystem.md)17, [``](fstream.md), [``](iomanip.md), [``](ios.md), [``](iosfwd.md), [``](iostream.md), [``](istream.md), [``](ostream.md), [``](sstream.md), [``](streambuf.md), [``](strstream.md)c, ``20 | | Iterators | [``](iterator.md) | -| Language support | [``](cfloat.md), [``](climits.md), [``](codecvt.md)11 a, ``20, ``20, ``20, [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstddef.md), [``](cstdint.md)11, [``](cstdlib.md), [``](exception.md), [``](initializer-list.md)11, [``](limits.md), [``](new.md), [``](typeinfo.md), ``20 | +| Language support | [``](cfloat.md), [``](climits.md), [``](codecvt.md)11 a, ``20, ``26, ``20, [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstddef.md), [``](cstdint.md)11, [``](cstdlib.md), [``](exception.md), [``](initializer-list.md)11, [``](limits.md), [``](new.md), [``](typeinfo.md), ``20 | | Localization | [``](clocale.md), [``](codecvt.md)11 a, [``](cvt-wbuffer.md), [``](cvt-wstring.md), [``](locale.md) | | Math and numerics | [``](bit.md)20, [``](cfenv.md)11, [``](cmath.md), [``](complex.md), [``](cstdlib.md), [``](limits.md), [``](numeric.md), [``](random.md)11, [``](ratio.md)11, [``](valarray.md) | | [Memory management](../cpp/smart-pointers-modern-cpp.md) | [``](allocators-header.md), [``](memory.md), [``](memory-resource.md)17, [``](new.md), [``](scoped-allocator.md)11 | From 5d16576bdcd39d097ea02ad73e2586857d38e6ee Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 23:09:02 +0800 Subject: [PATCH 0156/1799] Add bunch of new headers in "C++ standard library header files" topic --- .../cpp-standard-library-header-files.md | 25 ++++++++++--------- 1 file changed, 13 insertions(+), 12 deletions(-) diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index 80d71c4feb2..8244417e501 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -18,24 +18,25 @@ Header files for the C++ standard library and extensions, by category. | Atomic operations | [``](atomic.md)11 | | C library wrappers | [``](cassert.md), [``](ccomplex.md)11 a b, [``](cctype.md), [``](cerrno.md), [``](cfenv.md)11, [``](cfloat.md), [``](cinttypes.md)11, [``](ciso646.md)b, [``](climits.md), [``](clocale.md), [``](cmath.md), [``](csetjmp.md), [``](csignal.md), [``](cstdalign.md)11 a b, [``](cstdarg.md), [``](cstdbool.md)11 a b, [``](cstddef.md), [``](cstdint.md)11, [``](cstdio.md), [``](cstdlib.md), [``](cstring.md), [``](ctgmath.md)11 a b, [``](ctime.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md) | | Concepts | ``20 | -| [Containers](stl-containers.md) | | -| Sequence containers | [``](array.md)11, [``](deque.md), [``](forward-list.md)11, [``](list.md), [``](vector.md) | +| [Containers](stl-containers.md) | ``26 | +| Sequence containers | [``](array.md)11, [``](deque.md), [``](forward-list.md)11, ``26, [``](list.md), [``](vector.md) | | Ordered associative containers| [``](map.md), [``](set.md) | | Unordered associative containers | [``](unordered-map.md)11, [``](unordered-set.md)11 | -| Container adaptors | [``](queue.md), [``](stack.md) | -| Container views | [``](span.md)20 | +| Container adaptors | ``23, ``23, [``](queue.md), [``](stack.md) | +| Container views | ``23, [``](span.md)20 | +| Diagnostics | ``26, ``23 | | [Errors and exception handling](../cpp/errors-and-exception-handling-modern-cpp.md) | [``](cassert.md), [``](exception.md), [``](stdexcept.md), [``](system-error.md)11 | -| General utilities | [``](any.md)17, [``](bit.md)20, [``](bitset.md), [``](cstdlib.md), [``](execution.md)17, [``](functional.md), [``](memory.md), [``](memory-resource.md)17, [``](optional.md)17, [``](ratio.md)11, [``](scoped-allocator.md)11, [``](tuple.md)11, [``](type-traits.md)11, [``](typeindex.md)11, [``](utility.md), [``](variant.md)17 | -| [I/O and formatting](../text/string-and-i-o-formatting-modern-cpp.md) | [``](cinttypes.md)11, [``](cstdio.md), [``](filesystem.md)17, [``](fstream.md), [``](iomanip.md), [``](ios.md), [``](iosfwd.md), [``](iostream.md), [``](istream.md), [``](ostream.md), [``](sstream.md), [``](streambuf.md), [``](strstream.md)c, ``20 | +| General utilities | [``](any.md)17, [``](bit.md)20, [``](bitset.md), [``](cstdlib.md), [``](execution.md)17, ``23, [``](functional.md), [``](memory.md), [``](memory-resource.md)17, [``](optional.md)17, [``](ratio.md)11, [``](scoped-allocator.md)11, [``](tuple.md)11, [``](type-traits.md)11, [``](typeindex.md)11, [``](utility.md), [``](variant.md)17 | +| [I/O and formatting](../text/string-and-i-o-formatting-modern-cpp.md) | [``](cinttypes.md)11, [``](cstdio.md), [``](filesystem.md)17, ``20, [``](fstream.md), [``](iomanip.md), [``](ios.md), [``](iosfwd.md), [``](iostream.md), [``](istream.md), [``](ostream.md), ``23, ``23, [``](sstream.md), [``](streambuf.md), [``](strstream.md)c, ``20 | | Iterators | [``](iterator.md) | -| Language support | [``](cfloat.md), [``](climits.md), [``](codecvt.md)11 a, ``20, ``26, ``20, [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstddef.md), [``](cstdint.md)11, [``](cstdlib.md), [``](exception.md), [``](initializer-list.md)11, [``](limits.md), [``](new.md), [``](typeinfo.md), ``20 | +| Language support | [``](cfloat.md), [``](climits.md), [``](codecvt.md)11 a, ``20, ``26, ``20, [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstddef.md), [``](cstdint.md)11, [``](cstdlib.md), [``](exception.md), [``](initializer-list.md)11, [``](limits.md), [``](new.md), ``20, ``23, [``](typeinfo.md), ``20 | | Localization | [``](clocale.md), [``](codecvt.md)11 a, [``](cvt-wbuffer.md), [``](cvt-wstring.md), [``](locale.md) | -| Math and numerics | [``](bit.md)20, [``](cfenv.md)11, [``](cmath.md), [``](complex.md), [``](cstdlib.md), [``](limits.md), [``](numeric.md), [``](random.md)11, [``](ratio.md)11, [``](valarray.md) | -| [Memory management](../cpp/smart-pointers-modern-cpp.md) | [``](allocators-header.md), [``](memory.md), [``](memory-resource.md)17, [``](new.md), [``](scoped-allocator.md)11 | -| Multithreading | [``](atomic.md)11, [``](condition-variable.md)11, [``](future.md)11, [``](mutex.md)11, [``](shared-mutex.md)14, [``](thread.md)11 | -| Ranges | [``](ranges.md)20 | +| Math and numerics | [``](bit.md)20, [``](cfenv.md)11, [``](cmath.md), [``](complex.md), [``](cstdlib.md), [``](limits.md), ``26, ``20, [``](numeric.md), [``](random.md)11, [``](ratio.md)11, ``26, [``](valarray.md) | +| [Memory management](../cpp/smart-pointers-modern-cpp.md) | [``](allocators-header.md), ``26, [``](memory.md), [``](memory-resource.md)17, [``](new.md), [``](scoped-allocator.md)11 | +| Multithreading | [``](atomic.md)11, ``20, [``](condition-variable.md)11, [``](future.md)11, ``20, [``](mutex.md)11, ``26, ``20, [``](shared-mutex.md)14, ``20, [``](thread.md)11 | +| Ranges | ``23, [``](ranges.md)20 | | Regular expressions | [``](regex.md)11 | -| Strings and character data | [``](charconv.md)17, [``](cctype.md), [``](cstdlib.md), [``](cstring.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md), [``](regex.md)11, [``](string.md), [``](string-view.md)17 | +| Strings and character data | [``](charconv.md)17, [``](cctype.md), [``](cstdlib.md), [``](cstring.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md), [``](regex.md)11, [``](string.md), [``](string-view.md)17, ``26 | | Time | [``](chrono.md)11, [``](ctime.md) | 11 Added in the C++11 standard.\ From 7c5ae5735b24cd307ea226318376436ddb58f160 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 23:09:34 +0800 Subject: [PATCH 0157/1799] Update `ms.date` for "C++ standard library header files" topic --- docs/standard-library/cpp-standard-library-header-files.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index 8244417e501..0f56590a4ea 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -1,7 +1,7 @@ --- title: "C++ standard library header files" description: "C++ standard library header files, categorized" -ms.date: 08/31/2020 +ms.date: 06/22/2025 helpviewer_keywords: ["header files, C++ Standard Library", "C++ Standard Library, header files"] --- # C++ standard library header files From 1a9abd4309adcc4f200a90896dd0e89714099f3e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 22 Jun 2025 23:58:36 +0800 Subject: [PATCH 0158/1799] Fix mismatched backtick in `` header reference --- docs/standard-library/random.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/random.md b/docs/standard-library/random.md index 11b4b91e2be..b8ab45db591 100644 --- a/docs/standard-library/random.md +++ b/docs/standard-library/random.md @@ -17,7 +17,7 @@ Defines facilities for random number generation, allowing creation of uniformly **Namespace:** std > [!NOTE] -> The `` library uses the `#include ' statement. +> The `` library uses the `#include ` statement. ## Summary From 93c769497ed5c926b4ec6041c131ce6282d57557 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 23 Jun 2025 00:03:22 +0800 Subject: [PATCH 0159/1799] Update metadata in `` header reference --- docs/standard-library/random.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/random.md b/docs/standard-library/random.md index b8ab45db591..6ba907baac2 100644 --- a/docs/standard-library/random.md +++ b/docs/standard-library/random.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "08/24/2017" +description: "Learn more about: " +ms.date: 08/24/2017 f1_keywords: [""] helpviewer_keywords: ["random header"] -ms.assetid: 60afc25c-b162-4811-97c1-1b65398d4c57 --- # `` From a4286a6042a5ffb42a650a842f967a297cf89bf7 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Mon, 23 Jun 2025 08:42:21 +0900 Subject: [PATCH 0160/1799] Fix typo: ocupy -> occupy --- docs/mfc/reference/codesnippet/CPP/cmfcrebar-class_2.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/reference/codesnippet/CPP/cmfcrebar-class_2.cpp b/docs/mfc/reference/codesnippet/CPP/cmfcrebar-class_2.cpp index bd1a7ee4322..8827522e7ca 100644 --- a/docs/mfc/reference/codesnippet/CPP/cmfcrebar-class_2.cpp +++ b/docs/mfc/reference/codesnippet/CPP/cmfcrebar-class_2.cpp @@ -1,4 +1,4 @@ -// Each rebar pane will ocupy its own row: +// Each rebar pane will occupy its own row: DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP | RBBS_BREAK; // CMFCMenuBar m_wndMenuBar // CMFCToolBar m_wndToolBar From 54b5d32a862b8a85154c322d8b67fc371a7da8ba Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 23 Jun 2025 23:47:58 +0800 Subject: [PATCH 0161/1799] Remove superfluous or rogue parentheses in intrinsics list reference --- docs/intrinsics/x64-amd64-intrinsics-list.md | 8 ++++---- docs/intrinsics/x86-intrinsics-list.md | 8 ++++---- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/intrinsics/x64-amd64-intrinsics-list.md b/docs/intrinsics/x64-amd64-intrinsics-list.md index 967215bfa08..948b93ee9d9 100644 --- a/docs/intrinsics/x64-amd64-intrinsics-list.md +++ b/docs/intrinsics/x64-amd64-intrinsics-list.md @@ -102,7 +102,7 @@ The following table lists the intrinsics available on x64 processors. The Techno | [`_fxrstor64`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxrstor64) | FXSR | immintrin.h | `void _fxrstor64(void const*);` | | [`_fxsave`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxsave) | FXSR | immintrin.h | `void _fxsave(void*);` | | [`_fxsave64`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxsave64) | FXSR | immintrin.h | `void _fxsave64(void*);` | -| [`__getcallerseflags`](getcallerseflags.md) | | intrin.h | `(unsigned int __getcallerseflags());` | +| [`__getcallerseflags`](getcallerseflags.md) | | intrin.h | `unsigned int __getcallerseflags();` | | [`__halt`](halt.md) | | intrin.h | `void __halt(void);` | | [`__inbyte`](inbyte.md) | | intrin.h | `unsigned char __inbyte(unsigned short);` | | [`__inbytestring`](inbytestring.md) | | intrin.h | `void __inbytestring(unsigned short, unsigned char *, unsigned long);` | @@ -1033,7 +1033,7 @@ The following table lists the intrinsics available on x64 processors. The Techno | [`_mm256_round_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_round_ps) | AVX | immintrin.h | `__m256 _mm256_round_ps(__m256, int);` | | [`_mm256_rsqrt_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_rsqrt_ps) | AVX | immintrin.h | `__m256 _mm256_rsqrt_ps(__m256);` | | [`_mm256_sad_epu8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_sad_epu8) | AVX2 | immintrin.h | `__m256i _mm256_sad_epu8(__m256i, __m256i);` | -| [`_mm256_set_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi16) | AVX | immintrin.h | `(__m256i _mm256_set_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | +| [`_mm256_set_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi16) | AVX | immintrin.h | `__m256i _mm256_set_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | | [`_mm256_set_epi32`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi32) | AVX | immintrin.h | `__m256i _mm256_set_epi32(int, int, int, int, int, int, int, int);` | | [`_mm256_set_epi64x`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi64x) | AVX | immintrin.h | `__m256i _mm256_set_epi64x(long long, long long, long long, long long);` | | [`_mm256_set_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi8) | AVX | immintrin.h | `__m256i _mm256_set_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | @@ -1045,10 +1045,10 @@ The following table lists the intrinsics available on x64 processors. The Techno | [`_mm256_set1_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_epi8) | AVX | immintrin.h | `__m256i _mm256_set1_epi8(char);` | | [`_mm256_set1_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_pd) | AVX | immintrin.h | `__m256d _mm256_set1_pd(double);` | | [`_mm256_set1_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_ps) | AVX | immintrin.h | `__m256 _mm256_set1_ps(float);` | -| [`_mm256_setr_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi16) | AVX | immintrin.h | `(__m256i _mm256_setr_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | +| [`_mm256_setr_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi16) | AVX | immintrin.h | `__m256i _mm256_setr_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | | [`_mm256_setr_epi32`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi32) | AVX | immintrin.h | `__m256i _mm256_setr_epi32(int, int, int, int, int, int, int, int);` | | [`_mm256_setr_epi64x`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi64x) | AVX | immintrin.h | `__m256i _mm256_setr_epi64x(long long, long long, long long, long long);` | -| [`_mm256_setr_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi8) | AVX | immintrin.h | `(__m256i _mm256_setr_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | +| [`_mm256_setr_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi8) | AVX | immintrin.h | `__m256i _mm256_setr_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | | [`_mm256_setr_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_pd) | AVX | immintrin.h | `__m256d _mm256_setr_pd(double, double, double, double);` | | [`_mm256_setr_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_ps) | AVX | immintrin.h | `__m256 _mm256_setr_ps(float, float, float, float, float, float, float, float);` | | [`_mm256_setzero_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setzero_pd) | AVX | immintrin.h | `__m256d _mm256_setzero_pd(void);` | diff --git a/docs/intrinsics/x86-intrinsics-list.md b/docs/intrinsics/x86-intrinsics-list.md index 502e7552b82..0cc8c485387 100644 --- a/docs/intrinsics/x86-intrinsics-list.md +++ b/docs/intrinsics/x86-intrinsics-list.md @@ -75,7 +75,7 @@ The following table lists the intrinsics available on x86 processors. The Techno | [`__fastfail`](fastfail.md) | | intrin.h | `void __fastfail(unsigned int);` | | [`_fxrstor`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxrstor) | FXSR | immintrin.h | `void _fxrstor(void const*);` | | [`_fxsave`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxsave) | FXSR | immintrin.h | `void _fxsave(void*);` | -| [`__getcallerseflags`](getcallerseflags.md) | | intrin.h | `(unsigned int __getcallerseflags());` | +| [`__getcallerseflags`](getcallerseflags.md) | | intrin.h | `unsigned int __getcallerseflags();` | | [`__halt`](halt.md) | | intrin.h | `void __halt(void);` | | [`__inbyte`](inbyte.md) | | intrin.h | `unsigned char __inbyte(unsigned short);` | | [`__inbytestring`](inbytestring.md) | | intrin.h | `void __inbytestring(unsigned short, unsigned char *, unsigned long);` | @@ -1127,7 +1127,7 @@ The following table lists the intrinsics available on x86 processors. The Techno | [`_mm256_round_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_round_ps) | AVX | immintrin.h | `__m256 _mm256_round_ps(__m256, int);` | | [`_mm256_rsqrt_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_rsqrt_ps) | AVX | immintrin.h | `__m256 _mm256_rsqrt_ps(__m256);` | | [`_mm256_sad_epu8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_sad_epu8) | AVX2 | immintrin.h | `__m256i _mm256_sad_epu8(__m256i, __m256i);` | -| [`_mm256_set_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi16) | AVX | immintrin.h | `(__m256i _mm256_set_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | +| [`_mm256_set_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi16) | AVX | immintrin.h | `__m256i _mm256_set_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | | [`_mm256_set_epi32`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi32) | AVX | immintrin.h | `__m256i _mm256_set_epi32(int, int, int, int, int, int, int, int);` | | [`_mm256_set_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi8) | AVX | immintrin.h | `__m256i _mm256_set_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | | [`_mm256_set_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_pd) | AVX | immintrin.h | `__m256d _mm256_set_pd(double, double, double, double);` | @@ -1137,9 +1137,9 @@ The following table lists the intrinsics available on x86 processors. The Techno | [`_mm256_set1_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_epi8) | AVX | immintrin.h | `__m256i _mm256_set1_epi8(char);` | | [`_mm256_set1_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_pd) | AVX | immintrin.h | `__m256d _mm256_set1_pd(double);` | | [`_mm256_set1_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_ps) | AVX | immintrin.h | `__m256 _mm256_set1_ps(float);` | -| [`_mm256_setr_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi16) | AVX | immintrin.h | `(__m256i _mm256_setr_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | +| [`_mm256_setr_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi16) | AVX | immintrin.h | `__m256i _mm256_setr_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | | [`_mm256_setr_epi32`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi32) | AVX | immintrin.h | `__m256i _mm256_setr_epi32(int, int, int, int, int, int, int, int);` | -| [`_mm256_setr_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi8) | AVX | immintrin.h | `(__m256i _mm256_setr_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | +| [`_mm256_setr_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi8) | AVX | immintrin.h | `__m256i _mm256_setr_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | | [`_mm256_setr_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_pd) | AVX | immintrin.h | `__m256d _mm256_setr_pd(double, double, double, double);` | | [`_mm256_setr_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_ps) | AVX | immintrin.h | `__m256 _mm256_setr_ps(float, float, float, float, float, float, float, float);` | | [`_mm256_setzero_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setzero_pd) | AVX | immintrin.h | `__m256d _mm256_setzero_pd(void);` | From 22fe5c8fa0e3309161a65feb0c6402a74fcdeba3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 24 Jun 2025 00:28:16 +0800 Subject: [PATCH 0162/1799] Add backticks in `_rot{l,r}{8,16}` intrinsics reference --- docs/intrinsics/rotl8-rotl16.md | 10 +++++----- docs/intrinsics/rotr8-rotr16.md | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/intrinsics/rotl8-rotl16.md b/docs/intrinsics/rotl8-rotl16.md index 7c12f13c465..ae86008be09 100644 --- a/docs/intrinsics/rotl8-rotl16.md +++ b/docs/intrinsics/rotl8-rotl16.md @@ -6,7 +6,7 @@ f1_keywords: ["_rotl8", "_rotl16"] helpviewer_keywords: ["_rotl8 intrinsic", "_rotl16 intrinsic"] ms.assetid: 8c519ab6-aef9-4f07-a387-daee8408368f --- -# _rotl8, _rotl16 +# `_rotl8`, `_rotl16` **Microsoft Specific** @@ -27,10 +27,10 @@ unsigned short _rotl16( ### Parameters -*value*\ +*`value`*\ [in] The value to rotate. -*shift*\ +*`shift`*\ [in] The number of bits to rotate. ## Return value @@ -44,7 +44,7 @@ The rotated value. |`_rotl8`|x86, ARM, x64, ARM64| |`_rotl16`|x86, ARM, x64, ARM64| -**Header file** \ +**Header file**: `` ## Remarks @@ -93,5 +93,5 @@ Rotating unsigned short 0x12 left by 10 bits gives 0x4800 ## See also -[_rotr8, _rotr16](../intrinsics/rotr8-rotr16.md)\ +[`_rotr8`, `_rotr16`](../intrinsics/rotr8-rotr16.md)\ [Compiler intrinsics](../intrinsics/compiler-intrinsics.md) diff --git a/docs/intrinsics/rotr8-rotr16.md b/docs/intrinsics/rotr8-rotr16.md index fcc9a07e5aa..5257274ff56 100644 --- a/docs/intrinsics/rotr8-rotr16.md +++ b/docs/intrinsics/rotr8-rotr16.md @@ -6,7 +6,7 @@ f1_keywords: ["_rotr16", "_rotr8"] helpviewer_keywords: ["_rotr8 intrinsic", "_rotr16 intrinsic"] ms.assetid: dfbd2c82-82b4-427a-ad52-51609027ebff --- -# _rotr8, _rotr16 +# `_rotr8`, `_rotr16` **Microsoft Specific** @@ -27,10 +27,10 @@ unsigned short _rotr16( ### Parameters -*value*\ +*`value`*\ [in] The value to rotate. -*shift*\ +*`shift`*\ [in] The number of bits to rotate. ## Return value @@ -44,7 +44,7 @@ The rotated value. |`_rotr8`|x86, ARM, x64, ARM64| |`_rotr16`|x86, ARM, x64, ARM64| -**Header file** \ +**Header file**: `` ## Remarks @@ -94,5 +94,5 @@ Rotating unsigned short 0x12 right by 10 bits gives 0x480 ## See also -[_rotl8, _rotl16](../intrinsics/rotl8-rotl16.md)\ +[`_rotl8`, `_rotl16`](../intrinsics/rotl8-rotl16.md)\ [Compiler intrinsics](../intrinsics/compiler-intrinsics.md) From f8865ad73b405e48aeac45b6986f86a37c24be0f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 24 Jun 2025 00:29:36 +0800 Subject: [PATCH 0163/1799] Tidy up redundant link prefix in `_rot{l,r}{8,16}` intrinsics reference --- docs/intrinsics/rotl8-rotl16.md | 4 ++-- docs/intrinsics/rotr8-rotr16.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/intrinsics/rotl8-rotl16.md b/docs/intrinsics/rotl8-rotl16.md index ae86008be09..1e42dc2c5ad 100644 --- a/docs/intrinsics/rotl8-rotl16.md +++ b/docs/intrinsics/rotl8-rotl16.md @@ -93,5 +93,5 @@ Rotating unsigned short 0x12 left by 10 bits gives 0x4800 ## See also -[`_rotr8`, `_rotr16`](../intrinsics/rotr8-rotr16.md)\ -[Compiler intrinsics](../intrinsics/compiler-intrinsics.md) +[`_rotr8`, `_rotr16`](rotr8-rotr16.md)\ +[Compiler intrinsics](compiler-intrinsics.md) diff --git a/docs/intrinsics/rotr8-rotr16.md b/docs/intrinsics/rotr8-rotr16.md index 5257274ff56..fe86f805618 100644 --- a/docs/intrinsics/rotr8-rotr16.md +++ b/docs/intrinsics/rotr8-rotr16.md @@ -94,5 +94,5 @@ Rotating unsigned short 0x12 right by 10 bits gives 0x480 ## See also -[`_rotl8`, `_rotl16`](../intrinsics/rotl8-rotl16.md)\ -[Compiler intrinsics](../intrinsics/compiler-intrinsics.md) +[`_rotl8`, `_rotl16`](rotl8-rotl16.md)\ +[Compiler intrinsics](compiler-intrinsics.md) From e5f4df4ef37fe437803fd30acb63f4313831ecac Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 24 Jun 2025 00:33:07 +0800 Subject: [PATCH 0164/1799] Remove `c1` and `c2` unreferenced local variable in `_rot{l,r}{8,16}` intrinsics reference --- docs/intrinsics/rotl8-rotl16.md | 2 +- docs/intrinsics/rotr8-rotr16.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/intrinsics/rotl8-rotl16.md b/docs/intrinsics/rotl8-rotl16.md index 1e42dc2c5ad..e70b10bb777 100644 --- a/docs/intrinsics/rotl8-rotl16.md +++ b/docs/intrinsics/rotl8-rotl16.md @@ -61,7 +61,7 @@ Unlike a left-shift operation, when executing a left rotation, the high-order bi int main() { - unsigned char c = 'A', c1, c2; + unsigned char c = 'A'; for (int i = 0; i < 8; i++) { diff --git a/docs/intrinsics/rotr8-rotr16.md b/docs/intrinsics/rotr8-rotr16.md index fe86f805618..0d2c1959863 100644 --- a/docs/intrinsics/rotr8-rotr16.md +++ b/docs/intrinsics/rotr8-rotr16.md @@ -61,7 +61,7 @@ Unlike a right-shift operation, when executing a right rotation, the low-order b int main() { - unsigned char c = 'A', c1, c2; + unsigned char c = 'A'; for (int i = 0; i < 8; i++) { From 13bc8ad1dfbe5391c9b4a2a3cb01d72d38491e49 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 24 Jun 2025 00:35:34 +0800 Subject: [PATCH 0165/1799] Update metadata in `_rot{l,r}{8,16}` intrinsics reference --- docs/intrinsics/rotl8-rotl16.md | 5 ++--- docs/intrinsics/rotr8-rotr16.md | 5 ++--- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/intrinsics/rotl8-rotl16.md b/docs/intrinsics/rotl8-rotl16.md index e70b10bb777..e7316f19589 100644 --- a/docs/intrinsics/rotl8-rotl16.md +++ b/docs/intrinsics/rotl8-rotl16.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: _rotl8, _rotl16" title: "_rotl8, _rotl16" -ms.date: "09/02/2019" +description: "Learn more about: _rotl8, _rotl16" +ms.date: 09/02/2019 f1_keywords: ["_rotl8", "_rotl16"] helpviewer_keywords: ["_rotl8 intrinsic", "_rotl16 intrinsic"] -ms.assetid: 8c519ab6-aef9-4f07-a387-daee8408368f --- # `_rotl8`, `_rotl16` diff --git a/docs/intrinsics/rotr8-rotr16.md b/docs/intrinsics/rotr8-rotr16.md index 0d2c1959863..71a519a1793 100644 --- a/docs/intrinsics/rotr8-rotr16.md +++ b/docs/intrinsics/rotr8-rotr16.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: _rotr8, _rotr16" title: "_rotr8, _rotr16" -ms.date: "09/02/2019" +description: "Learn more about: _rotr8, _rotr16" +ms.date: 09/02/2019 f1_keywords: ["_rotr16", "_rotr8"] helpviewer_keywords: ["_rotr8 intrinsic", "_rotr16 intrinsic"] -ms.assetid: dfbd2c82-82b4-427a-ad52-51609027ebff --- # `_rotr8`, `_rotr16` From 09a2bad79cddf3f601447e5b92a7eaee0ec071d7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 24 Jun 2025 00:48:54 +0800 Subject: [PATCH 0166/1799] Resolve incomprehensible term "wiprlhext" in "Visual Studio C++ samples" topic --- docs/overview/visual-cpp-samples.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/visual-cpp-samples.md b/docs/overview/visual-cpp-samples.md index 3898b2ae6c5..e3371885a18 100644 --- a/docs/overview/visual-cpp-samples.md +++ b/docs/overview/visual-cpp-samples.md @@ -218,7 +218,7 @@ Previous versions of Visual Studio included C++ sample code. The sample code was |--|--| | [Button](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates use of an in-place active menu, a stock property page, and the About box control option. | | [Circ](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates ActiveX control basics. These include control painting, stock and custom properties, stock and custom events, use of colors and fonts, the stock font property page, the default property page, and versioning. | -| [CmnCtrl](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates some of the new controls available with MFC on wiprlhext: The command link button (`CButton`), the pager control (`CPagerCtrl`), the split button (`CSplitButton`), and the network address control (`CNetAddressCtrl`). | +| [CmnCtrl](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates some of the new controls available with MFC on Windows Vista: The command link button (`CButton`), the pager control (`CPagerCtrl`), the split button (`CSplitButton`), and the network address control (`CNetAddressCtrl`). | | [Contain](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates a Visual Editing Container Application. | | [Image](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates how to use MFC to build an ActiveX control that downloads data asynchronously. | | [Licensed](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | A control that enforces use of a design-time and run-time license. | From 743a32b05e756f6081c57bc9cf1ffacd1507a612 Mon Sep 17 00:00:00 2001 From: Nathalie Laroche <635965+nathlaroche@users.noreply.github.com> Date: Mon, 23 Jun 2025 15:18:42 -0400 Subject: [PATCH 0167/1799] adding Tyler's feedback --- docs/atl/example-implementing-a-property-page.md | 2 +- docs/atl/implementing-a-dialog-box.md | 2 +- docs/atl/implementing-a-window-with-cwindowimpl.md | 2 +- docs/atl/implementing-property-pages.md | 2 +- docs/atl/inserting-a-composite-control.md | 2 +- docs/atl/using-idispeventimpl.md | 2 +- docs/atl/using-task-manager.md | 2 +- .../build-insights/reference/sdk/cpp-event-data-types/thread.md | 2 +- .../tutorials/build-insights-included-files-view.md | 2 +- docs/build/arm-exception-handling.md | 2 +- docs/build/exporting-from-a-dll-using-declspec-dllexport.md | 2 +- .../using-the-debug-build-to-check-for-memory-overwrite.md | 2 +- docs/data/odbc/record-field-exchange-how-rfx-works.md | 2 +- .../supporting-navigation-in-a-record-view-mfc-data-access.md | 2 +- .../how-to-define-and-install-a-global-exception-handler.md | 2 +- docs/dotnet/using-a-windows-form-user-control-in-mfc.md | 2 +- .../using-verifiable-assemblies-with-sql-server-cpp-cli.md | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/atl/example-implementing-a-property-page.md b/docs/atl/example-implementing-a-property-page.md index 803f88a8eed..6e7ee66751a 100644 --- a/docs/atl/example-implementing-a-property-page.md +++ b/docs/atl/example-implementing-a-property-page.md @@ -4,7 +4,7 @@ title: "Implementing a Property Page (ATL)" ms.date: "05/09/2019" helpviewer_keywords: ["property pages, implementing"] ms.assetid: c30b67fe-ce08-4249-ae29-f3060fa8d61e -ms.topic: concept-article +ms.topic: how-to --- # Example: Implementing a Property Page diff --git a/docs/atl/implementing-a-dialog-box.md b/docs/atl/implementing-a-dialog-box.md index 43e12bf1c62..c84428bea54 100644 --- a/docs/atl/implementing-a-dialog-box.md +++ b/docs/atl/implementing-a-dialog-box.md @@ -4,7 +4,7 @@ title: "Implementing a Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["CSimpleDialog class, implementing dialog boxes in ATL", "dialog boxes, ATL", "CAxDialogImpl class, implementing dialog boxes in ATL", "ATL, dialog boxes"] ms.assetid: 478525f2-aa6a-435a-b162-68fc8aa98a8e -ms.topic: concept-article +ms.topic: how-to --- # Implementing a Dialog Box diff --git a/docs/atl/implementing-a-window-with-cwindowimpl.md b/docs/atl/implementing-a-window-with-cwindowimpl.md index e23a33cca2c..be0f590b83f 100644 --- a/docs/atl/implementing-a-window-with-cwindowimpl.md +++ b/docs/atl/implementing-a-window-with-cwindowimpl.md @@ -4,7 +4,7 @@ title: "Implementing a Window with CWindowImpl" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "windows [C++], subclassing", "windows [C++], superclassing", "windows [C++], ATL", "subclassing ATL window classes", "superclassing, ATL"] ms.assetid: 3fc40550-f1d6-4702-8b7c-4cf682b6a855 -ms.topic: concept-article +ms.topic: how-to --- # Implementing a Window with CWindowImpl diff --git a/docs/atl/implementing-property-pages.md b/docs/atl/implementing-property-pages.md index 61a2bbec06d..d9e3b0942c4 100644 --- a/docs/atl/implementing-property-pages.md +++ b/docs/atl/implementing-property-pages.md @@ -4,7 +4,7 @@ title: "Implementing Property Pages" ms.date: "11/04/2016" helpviewer_keywords: ["IPropertyPage2 class", "IPropertyPage class", "property pages, implementing"] ms.assetid: 62f29440-33a7-40eb-a1ef-3634c95f640c -ms.topic: concept-article +ms.topic: how-to --- # Implementing Property Pages diff --git a/docs/atl/inserting-a-composite-control.md b/docs/atl/inserting-a-composite-control.md index 491a3379a1b..ad1f4f6dc24 100644 --- a/docs/atl/inserting-a-composite-control.md +++ b/docs/atl/inserting-a-composite-control.md @@ -4,7 +4,7 @@ title: "Inserting a Composite Control" ms.date: "11/04/2016" helpviewer_keywords: ["composite controls, inserting with ATL Object Wizard", "composite controls", "ATL Control Wizard"] ms.assetid: f10b1927-9fc6-40a7-ac29-efdac70584fe -ms.topic: concept-article +ms.topic: how-to --- # Inserting a Composite Control diff --git a/docs/atl/using-idispeventimpl.md b/docs/atl/using-idispeventimpl.md index 321781fd3f3..9e9c1537f24 100644 --- a/docs/atl/using-idispeventimpl.md +++ b/docs/atl/using-idispeventimpl.md @@ -4,7 +4,7 @@ title: "Using IDispEventImpl (ATL)" ms.date: "08/19/2019" helpviewer_keywords: ["IDispEventImpl class, using"] ms.assetid: 82d53b61-9d0d-45c5-aff9-2fafa468a9ca -ms.topic: concept-article +ms.topic: how-to --- # Using IDispEventImpl diff --git a/docs/atl/using-task-manager.md b/docs/atl/using-task-manager.md index e52c3764c68..31747f62825 100644 --- a/docs/atl/using-task-manager.md +++ b/docs/atl/using-task-manager.md @@ -4,7 +4,7 @@ title: "Using Task Manager" ms.date: "11/04/2016" helpviewer_keywords: ["Task Manager", "breakpoints, Task Manager", "debugging [ATL], using Task Manager"] ms.assetid: 773fccd5-308d-42c2-a17f-60ae94989062 -ms.topic: concept-article +ms.topic: how-to --- # Using Task Manager diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md b/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md index 808cbe77a62..1e850cafb6f 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md @@ -3,7 +3,7 @@ title: "Thread class" description: "The C++ Build Insights SDK Thread class reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "Thread", "throughput analysis", "build time analysis", "vcperf.exe"] -ms.topic: how-to +ms.topic: reference --- # Thread class diff --git a/docs/build-insights/tutorials/build-insights-included-files-view.md b/docs/build-insights/tutorials/build-insights-included-files-view.md index e6a4991c2dc..0b686653516 100644 --- a/docs/build-insights/tutorials/build-insights-included-files-view.md +++ b/docs/build-insights/tutorials/build-insights-included-files-view.md @@ -3,7 +3,7 @@ title: "Troubleshoot header file impact on build time" description: "Tutorial on how to use Build Insights Includes Files and Includes Tree views to troubleshoot the impact of #include files on build time." ms.date: 5/30/2024 helpviewer_keywords: ["C++ Build Insights", "header file build time", "included files view", "include tree view", "#include analysis", "build time analysis"] -ms.topic: troubleshooting-general +ms.topic: how-to --- # Troubleshoot header file impact on build time diff --git a/docs/build/arm-exception-handling.md b/docs/build/arm-exception-handling.md index de257cc65fd..35435412eeb 100644 --- a/docs/build/arm-exception-handling.md +++ b/docs/build/arm-exception-handling.md @@ -3,7 +3,7 @@ description: "Learn more about: ARM Exception Handling" title: "ARM Exception Handling" ms.date: 12/15/2021 ms.assetid: fe0e615f-c033-4ad5-97f4-ff96af45b201 -ms.topic: how-to +ms.topic: concept-article --- # ARM Exception Handling diff --git a/docs/build/exporting-from-a-dll-using-declspec-dllexport.md b/docs/build/exporting-from-a-dll-using-declspec-dllexport.md index e0245f46d08..674c52fb8dd 100644 --- a/docs/build/exporting-from-a-dll-using-declspec-dllexport.md +++ b/docs/build/exporting-from-a-dll-using-declspec-dllexport.md @@ -5,7 +5,7 @@ ms.date: "05/06/2019" f1_keywords: ["dllexport"] helpviewer_keywords: ["__declspec(dllexport) keyword [C++]", "names [C++], DLL exports by", "export directives [C++]", "exporting DLLs [C++], __declspec(dllexport) keyword"] ms.assetid: a35e25e8-7263-4a04-bad4-00b284458679 -ms.topic: concept-article +ms.topic: how-to --- # Exporting from a DLL Using __declspec(dllexport) diff --git a/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md b/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md index 5fb5fa5c707..36aae3bdec7 100644 --- a/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md +++ b/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md @@ -4,7 +4,7 @@ title: "Using the Debug Build to Check for Memory Overwrite" ms.date: "11/04/2016" helpviewer_keywords: ["memory, overwrites"] ms.assetid: 1345eb4d-24ba-4595-b1cc-2da66986311e -ms.topic: concept-article +ms.topic: how-to --- # Using the Debug Build to Check for Memory Overwrite diff --git a/docs/data/odbc/record-field-exchange-how-rfx-works.md b/docs/data/odbc/record-field-exchange-how-rfx-works.md index 67289c09033..f2f300fd447 100644 --- a/docs/data/odbc/record-field-exchange-how-rfx-works.md +++ b/docs/data/odbc/record-field-exchange-how-rfx-works.md @@ -4,7 +4,7 @@ title: "Record Field Exchange: How RFX Works" ms.date: "11/04/2016" helpviewer_keywords: ["record editing [C++], using RFX", "RFX (ODBC) [C++], updating data in recordsets", "scrolling [C++]", "ODBC [C++], RFX", "data binding [C++], DFX", "scrolling [C++], RFX", "RFX (ODBC) [C++], binding fields and parameters"] ms.assetid: e647cacd-62b0-4b80-9e20-b392deca5a88 -ms.topic: how-to +ms.topic: concept-article --- # Record Field Exchange: How RFX Works diff --git a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md index 1a01df14c2c..039e1412806 100644 --- a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md +++ b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md @@ -4,7 +4,7 @@ title: "Supporting Navigation in a Record View (MFC Data Access)" ms.date: "11/04/2016" helpviewer_keywords: ["records [C++], navigating", "record views, navigation", "navigation [C++], in record view"] ms.assetid: 227f2a6d-87c9-4656-807a-8e246965bcce -ms.topic: concept-article +ms.topic: reference --- # Supporting Navigation in a Record View (MFC Data Access) diff --git a/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md b/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md index f85be0243ad..35af0b6fce2 100644 --- a/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md +++ b/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md @@ -4,7 +4,7 @@ title: "How to: Define and Install a Global Exception Handler" ms.date: "11/04/2016" helpviewer_keywords: ["handlers, global"] ms.assetid: dd88a812-3bc7-4ce8-8283-4b674c246534 -ms.topic: install-set-up-deploy +ms.topic: how-to --- # How to: Define and Install a Global Exception Handler diff --git a/docs/dotnet/using-a-windows-form-user-control-in-mfc.md b/docs/dotnet/using-a-windows-form-user-control-in-mfc.md index c5dc738dd4b..a4d8bac8ddc 100644 --- a/docs/dotnet/using-a-windows-form-user-control-in-mfc.md +++ b/docs/dotnet/using-a-windows-form-user-control-in-mfc.md @@ -4,7 +4,7 @@ title: "Using a Windows Form User Control in MFC" ms.date: "01/08/2018" helpviewer_keywords: ["MFC [C++], Windows Forms support", "interoperability [C++], Windows Forms in MFC", "interoperability [C++], MFC", "interop [C++], Windows Forms in MFC", "interop [C++], MFC", "Windows Forms [C++], MFC support"] ms.assetid: 63fb099b-1dff-469c-9e34-dab52e122fcd -ms.topic: concept-article +ms.topic: how-to --- # Using a Windows Form User Control in MFC diff --git a/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md b/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md index b2da43511d5..d6ce13de8ab 100644 --- a/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md +++ b/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md @@ -4,7 +4,7 @@ title: "Using Verifiable Assemblies with SQL Server (C++/CLI)" ms.date: "10/17/2018" helpviewer_keywords: ["verifiable assemblies [C++], with SQL Server"] ms.assetid: 5248a60d-aa88-4ff3-b30a-b791c3ea2de9 -ms.topic: concept-article +ms.topic: how-to --- # Using Verifiable Assemblies with SQL Server (C++/CLI) From 1a2bc7c69094cbe6204281a6ef5659e4f2100fb7 Mon Sep 17 00:00:00 2001 From: Nathalie Laroche <635965+nathlaroche@users.noreply.github.com> Date: Mon, 23 Jun 2025 15:25:37 -0400 Subject: [PATCH 0168/1799] adding Tyler's feedback --- docs/build-insights/get-started-with-cpp-build-insights.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/get-started-with-cpp-build-insights.md b/docs/build-insights/get-started-with-cpp-build-insights.md index cc5b0a8e1b8..fccaa5d7f91 100644 --- a/docs/build-insights/get-started-with-cpp-build-insights.md +++ b/docs/build-insights/get-started-with-cpp-build-insights.md @@ -4,7 +4,7 @@ description: "A high-level overview of C++ Build Insights." ms.date: "11/03/2019" helpviewer_keywords: ["C++ Build Insights", "throughput analysis", "build time analysis", "vcperf.exe"] ms.custom: intro-get-started -ms.topic: get-started +ms.topic: how-to --- # Get started with C++ Build Insights From 3788a644a9cf7e523f68f3d8588d901ff4000b2a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:16:02 +0800 Subject: [PATCH 0169/1799] Change only bold parameter to italic in `clock_time_conversion` reference --- docs/standard-library/clock-time-conversion-struct.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/clock-time-conversion-struct.md b/docs/standard-library/clock-time-conversion-struct.md index 865849283d3..188c50e8ea1 100644 --- a/docs/standard-library/clock-time-conversion-struct.md +++ b/docs/standard-library/clock-time-conversion-struct.md @@ -94,7 +94,7 @@ utc_time operator()(const sys_time& t) const; ### Parameters -**`t`** +*`t`*\ The `time_point` to convert. ### Return value From c2419bb8c42db4f6bd5567cd93642bdf8d4b7bd7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:55:23 +0800 Subject: [PATCH 0170/1799] Add some missing commas in reference syntax --- docs/c-runtime-library/reference/asctime-s-wasctime-s.md | 2 +- docs/parallel/amp/reference/array-class.md | 2 +- docs/standard-library/algorithm-functions.md | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/c-runtime-library/reference/asctime-s-wasctime-s.md b/docs/c-runtime-library/reference/asctime-s-wasctime-s.md index c7762a0c8f0..9e7f43c974d 100644 --- a/docs/c-runtime-library/reference/asctime-s-wasctime-s.md +++ b/docs/c-runtime-library/reference/asctime-s-wasctime-s.md @@ -24,7 +24,7 @@ errno_t asctime_s( ); errno_t _wasctime_s( wchar_t* buffer, - size_t numberOfElements + size_t numberOfElements, const struct tm *tmSource ); template diff --git a/docs/parallel/amp/reference/array-class.md b/docs/parallel/amp/reference/array-class.md index ce31e23b618..c17124a2a37 100644 --- a/docs/parallel/amp/reference/array-class.md +++ b/docs/parallel/amp/reference/array-class.md @@ -362,7 +362,7 @@ explicit array( array( const array_view& _Src, - accelerator_view _Av + accelerator_view _Av, access_type _Cpu_access_type = access_type_auto) restrict(cpu); array( diff --git a/docs/standard-library/algorithm-functions.md b/docs/standard-library/algorithm-functions.md index 2e049415f2f..79f675e2972 100644 --- a/docs/standard-library/algorithm-functions.md +++ b/docs/standard-library/algorithm-functions.md @@ -5583,7 +5583,7 @@ template void partial_sort( RandomAccessIterator first, RandomAccessIterator sortEnd, - RandomAccessIterator last + RandomAccessIterator last, Compare pred); template @@ -7783,7 +7783,7 @@ ForwardIterator1 search( ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2, - ForwardIterator2 last2 + ForwardIterator2 last2, BinaryPredicate pred); template From a2f9132d4c8acd1044d60debd2ada928da4fc90c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 24 Jun 2025 22:59:09 +0800 Subject: [PATCH 0171/1799] Update metadata for 3 topics --- docs/c-runtime-library/reference/asctime-s-wasctime-s.md | 5 ++--- docs/parallel/amp/reference/array-class.md | 5 ++--- docs/standard-library/algorithm-functions.md | 2 +- 3 files changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/c-runtime-library/reference/asctime-s-wasctime-s.md b/docs/c-runtime-library/reference/asctime-s-wasctime-s.md index 9e7f43c974d..99d3ffe89b3 100644 --- a/docs/c-runtime-library/reference/asctime-s-wasctime-s.md +++ b/docs/c-runtime-library/reference/asctime-s-wasctime-s.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: asctime_s, _wasctime_s" title: "asctime_s, _wasctime_s" -ms.date: "4/2/2020" +description: "Learn more about: asctime_s, _wasctime_s" +ms.date: 4/2/2020 api_name: ["_wasctime_s", "asctime_s", "_o__wasctime_s", "_o_asctime_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-time-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["asctime_s", "_wasctime_s", "_tasctime_s"] helpviewer_keywords: ["tasctime_s function", "_tasctime_s function", "time structure conversion", "wasctime_s function", "time, converting", "_wasctime_s function", "asctime_s function"] -ms.assetid: 17ad9b2b-a459-465d-976a-42822897688a --- # `asctime_s`, `_wasctime_s` diff --git a/docs/parallel/amp/reference/array-class.md b/docs/parallel/amp/reference/array-class.md index c17124a2a37..e7a9eea52c6 100644 --- a/docs/parallel/amp/reference/array-class.md +++ b/docs/parallel/amp/reference/array-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: array Class" title: "array Class" -ms.date: "11/04/2016" +description: "Learn more about: array Class" +ms.date: 11/04/2016 f1_keywords: ["array", "AMP/array", "AMP/Concurrency::array::array", "AMP/Concurrency::array::copy_to", "AMP/Concurrency::array::data", "AMP/Concurrency::array::get_accelerator_view", "AMP/Concurrency::array::get_associated_accelerator_view", "AMP/Concurrency::array::get_cpu_access_type", "AMP/Concurrency::array::get_extent", "AMP/Concurrency::array::reinterpret_as", "AMP/Concurrency::array::section", "AMP/Concurrency::array::view_as", "AMP/Concurrency::array::rank", "AMP/Concurrency::array::accelerator_view", "AMP/Concurrency::array::associated_accelerator_view", "AMP/Concurrency::array::cpu_access_type", "AMP/Concurrency::array::extent"] helpviewer_keywords: ["array class"] -ms.assetid: 0832b6c1-40f0-421d-9104-6b1baa0c63a7 --- # array Class diff --git a/docs/standard-library/algorithm-functions.md b/docs/standard-library/algorithm-functions.md index 79f675e2972..35ebfff174a 100644 --- a/docs/standard-library/algorithm-functions.md +++ b/docs/standard-library/algorithm-functions.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: functions" title: " functions" +description: "Learn more about: functions" ms.date: 06/07/2022 f1_keywords: ["algorithm/std::adjacent_find", "algorithm/std::all_of", "algorithm/std::any_of", "algorithm/std::binary_search", "algorithm/std::copy", "algorithm/std::copy_backward", "algorithm/std::copy_if", "algorithm/std::copy_n", "algorithm/std::equal", "algorithm/std::equal_range", "algorithm/std::fill", "algorithm/std::fill_n", "algorithm/std::find", "algorithm/std::find_end", "algorithm/std::find_first_of", "algorithm/std::find_if", "algorithm/std::find_if_not", "algorithm/std::for_each", "algorithm/std::generate", "algorithm/std::generate_n", "algorithm/std::includes", "algorithm/std::inplace_merge", "algorithm/std::is_heap", "algorithm/std::is_heap_until", "algorithm/std::is_partitioned", "algorithm/std::is_permutation", "algorithm/std::is_sorted", "algorithm/std::is_sorted_until", "algorithm/std::iter_swap", "algorithm/std::lexicographical_compare", "algorithm/std::lower_bound", "algorithm/std::make_heap", "algorithm/std::max", "algorithm/std::max_element", "algorithm/std::merge", "algorithm/std::min", "algorithm/std::minmax", "algorithm/std::minmax_element", "algorithm/std::min_element", "algorithm/std::mismatch", "algorithm/std::move", "algorithm/std::move_backward", "algorithm/std::next_permutation", "algorithm/std::none_of", "algorithm/std::nth_element", "algorithm/std::partial_sort", "algorithm/std::partial_sort_copy", "algorithm/std::partition", "algorithm/std::partition_point", "algorithm/std::pop_heap", "algorithm/std::prev_permutation", "algorithm/std::push_heap", "algorithm/std::random_shuffle", "algorithm/std::remove", "algorithm/std::remove_copy", "algorithm/std::remove_copy_if", "algorithm/std::remove_if", "algorithm/std::replace", "algorithm/std::replace_copy", "algorithm/std::replace_copy_if", "algorithm/std::replace_if", "algorithm/std::reverse", "algorithm/std::reverse_copy", "algorithm/std::rotate", "algorithm/std::rotate_copy", "algorithm/std::search", "algorithm/std::search_n", "algorithm/std::set_difference", "algorithm/std::set_intersection", "algorithm/std::set_symmetric_difference", "algorithm/std::set_union", "algorithm/std::shuffle", "algorithm/std::sort", "algorithm/std::sort_heap", "algorithm/std::stable_partition", "algorithm/std::stable_sort", "algorithm/std::swap_ranges", "algorithm/std::transform", "algorithm/std::unique", "algorithm/std::unique_copy", "algorithm/std::upper_bound", "xutility/std::copy", "xutility/std::copy_backward", "xutility/std::copy_n", "xutility/std::count", "xutility/std::equal", "xutility/std::fill", "xutility/std::fill_n", "xutility/std::find", "xutility/std::is_permutation", "xutility/std::lexicographical_compare", "xutility/std::move", "xutility/std::move_backward", "xutility/std::reverse", "xutility/std::rotate", "algorithm/std::count_if", "algorithm/std::partition_copy", "algorithm/std::swap"] helpviewer_keywords: ["std::adjacent_find [C++]", "std::all_of [C++]", "std::any_of [C++]", "std::binary_search [C++]", "std::copy [C++]", "std::copy_backward [C++]", "std::copy_if [C++]", "std::copy_n [C++]", "std::equal [C++]", "std::equal_range [C++]", "std::fill [C++]", "std::fill_n [C++]", "std::find [C++]", "std::find_end [C++]", "std::find_first_of [C++]", "std::find_if [C++]", "std::find_if_not [C++]", "std::for_each [C++]", "std::generate [C++]", "std::generate_n [C++]", "std::includes [C++]", "std::inplace_merge [C++]", "std::is_heap [C++]", "std::is_heap_until [C++]", "std::is_partitioned [C++]", "std::is_permutation [C++]", "std::is_sorted [C++]", "std::is_sorted_until [C++]", "std::iter_swap [C++]", "std::lexicographical_compare [C++]", "std::lower_bound [C++]", "std::make_heap [C++]", "std::max [C++]", "std::max_element [C++]", "std::merge [C++]", "std::min [C++]", "std::minmax [C++]", "std::minmax_element [C++]", "std::min_element [C++]", "std::mismatch [C++]", "std::move [C++]", "std::move_backward [C++]", "std::next_permutation [C++]", "std::none_of [C++]", "std::nth_element [C++]", "std::partial_sort [C++]", "std::partial_sort_copy [C++]", "std::partition [C++]", "std::partition_point [C++]", "std::pop_heap [C++]", "std::prev_permutation [C++]", "std::push_heap [C++]", "std::random_shuffle [C++]", "std::remove [C++]", "std::remove_copy [C++]", "std::remove_copy_if [C++]", "std::remove_if [C++]", "std::replace [C++]", "std::replace_copy [C++]", "std::replace_copy_if [C++]", "std::replace_if [C++]", "std::reverse [C++]", "std::reverse_copy [C++]", "std::rotate [C++]", "std::rotate_copy [C++]", "std::search [C++]", "std::search_n [C++]", "std::set_difference [C++]", "std::set_intersection [C++]", "std::set_symmetric_difference [C++]", "std::set_union [C++]", "std::shuffle [C++]", "std::sort [C++]", "std::sort_heap [C++]", "std::stable_partition [C++]", "std::stable_sort [C++]", "std::swap_ranges [C++]", "std::transform [C++]", "std::unique [C++]", "std::unique_copy [C++]", "std::upper_bound [C++]", "std::copy [C++]", "std::copy_backward [C++]", "std::copy_n [C++]", "std::count [C++]", "std::equal [C++]", "std::fill [C++]", "std::fill_n [C++]", "std::find [C++]", "std::is_permutation [C++]", "std::lexicographical_compare [C++]", "std::move [C++]", "std::move_backward [C++]", "std::reverse [C++]", "std::rotate [C++]", "std::count_if [C++]", "std::partition_copy [C++]", "std::swap [C++]"] From bd0555294ad82e77216bd98679deb56d9e906c65 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 24 Jun 2025 23:02:23 +0800 Subject: [PATCH 0172/1799] Add leading sentence in `` functions reference --- docs/standard-library/algorithm-functions.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/standard-library/algorithm-functions.md b/docs/standard-library/algorithm-functions.md index 35ebfff174a..b243d2c1ebb 100644 --- a/docs/standard-library/algorithm-functions.md +++ b/docs/standard-library/algorithm-functions.md @@ -8,6 +8,8 @@ ms.custom: devdivchpfy22 --- # `` functions +The `` header provides the following functions: + ## `adjacent_find` Searches for two adjacent elements that are either equal or satisfy a specified condition. From 2acb092226806f6b9495bc31feefaa878a58379b Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 24 Jun 2025 16:29:19 -0700 Subject: [PATCH 0173/1799] Update compiler-warning-level-1-c4172.md We demo an unusual case but not perhaps a more common case. Added it. --- .../compiler-warning-level-1-c4172.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md index e2e00b8b217..0223340e504 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md @@ -22,13 +22,22 @@ The following example generates C4172: ```cpp // C4172.cpp // compile with: /c /W1 + +const int* func1() +{ + int i = 42; + return &i; // C4172 +} + float f = 1.f; -const double& func() +const double& func2() // Try one of the following lines instead: -// const float& func() -// const auto& func() +// const float& func2() +// const auto& func2() { + // The problem is that a temporary is created to convert f to a double. + // C4172 in this case refers to returning the address of a temporary return f; // C4172 } ``` From 107128feb7d74f2f62398ee1379eca3de60b8bc9 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Wed, 25 Jun 2025 08:36:47 +0900 Subject: [PATCH 0174/1799] Fix typo: The followings steps -> The following steps --- docs/mfc/tn023-standard-mfc-resources.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/tn023-standard-mfc-resources.md b/docs/mfc/tn023-standard-mfc-resources.md index d7e50ae3190..eebace2edac 100644 --- a/docs/mfc/tn023-standard-mfc-resources.md +++ b/docs/mfc/tn023-standard-mfc-resources.md @@ -72,7 +72,7 @@ Standard framework resources are usually included in an application by using the The most common case of customizing standard framework resources is adding or removing additional includes for printing, OLE Client, and OLE Server support. -In some rare cases you might want to customize the contents of the standard framework resources for your particular application, not just add and remove the entire file. The followings steps show how you can limit the resources that are included: +In some rare cases you might want to customize the contents of the standard framework resources for your particular application, not just add and remove the entire file. The following steps show how you can limit the resources that are included: ##### To customize the contents of a standard resource file From bccada9af065178ef0b22bdb36dd6852d14f1587 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 24 Jun 2025 17:00:41 -0700 Subject: [PATCH 0175/1799] Update adding-connection-points-to-an-object.md Since the file is open, fixed some other things that bugged me. --- .../adding-connection-points-to-an-object.md | 33 +++++++++---------- 1 file changed, 15 insertions(+), 18 deletions(-) diff --git a/docs/atl/adding-connection-points-to-an-object.md b/docs/atl/adding-connection-points-to-an-object.md index 4703ee3cef0..07c4588cdf1 100644 --- a/docs/atl/adding-connection-points-to-an-object.md +++ b/docs/atl/adding-connection-points-to-an-object.md @@ -6,50 +6,47 @@ helpviewer_keywords: ["connection points [C++], adding to ATL objects", "Impleme --- # Adding Connection Points to an Object -The [ATL Tutorial](active-template-library-atl-tutorial.md) demonstrates how to create a control with support for connection points, how to add events, and then how to implement the connection point. ATL implements connection points with the [IConnectionPointImpl](reference/iconnectionpointimpl-class.md) class. +The [ATL Tutorial](active-template-library-atl-tutorial.md) demonstrates how to create a control with support for connection points, how to add events, and then how to implement the connection point. ATL implements connection points with the [`IConnectionPointImpl`](reference/iconnectionpointimpl-class.md) class. To implement a connection point, you have two choices: - Implement your own outgoing event source, by adding a connection point to the control or object. - - Reuse a connection point interface defined in another type library. -In either case, the Implement Connection Point Wizard uses a type library to do its work. +In either case, the **Implement Connection Point Wizard** uses a type library to do its work. -### To add a connection point to a control or object +### Add a connection point to a control or object -1. Define a dispinterface in the library block of the .idl file. If you enabled support for connection points when you created the control with the ATL Control Wizard, the dispinterface will already be created. If you did not enable support for connection points when you created the control, you must manually add a dispinterface to the .idl file. The following is an example of a dispinterface. Outgoing interfaces are not required to be dispatch interfaces but many scripting languages such as VBScript and JScript require this, so this example uses two dispinterfaces: +1. Define a dispinterface in the library block of the `.idl` file. If you enabled support for connection points when you created the control with the **ATL Control Wizard**, the dispinterface will already be created. If you did not enable support for connection points when you created the control, you must manually add a dispinterface to the `.idl` file. The following is an example of a dispinterface. Outgoing interfaces are not required to be dispatch interfaces but many scripting languages such as VBScript and JScript require this, so this example uses two dispinterfaces: [!code-cpp[NVC_ATL_Windowing#81](codesnippet/cpp/adding-connection-points-to-an-object_1.idl)] - Use either the uuidgen.exe or guidgen.exe utility to generate a GUID. + Use either the `uuidgen.exe` or `guidgen.exe` utility to generate a GUID. -2. Add the dispinterface as the `[default,source]` interface in the coclass for the object in the project's .idl file. Again, if you enabled support for connection points when you created the control, the ATL Control Wizard will create the `[default,source]` entry. To manually add this entry, add the line in bold: +2. Add the dispinterface as the `[default,source]` interface in the coclass for the object in the project's `.idl` file. Again, if you enabled support for connection points when you created the control, the ATL Control Wizard will create the `[default,source]` entry. To manually add this entry, add the line in bold: [!code-cpp[NVC_ATL_Windowing#82](codesnippet/cpp/adding-connection-points-to-an-object_2.idl)] - See the .idl file in the [Circ](../overview/visual-cpp-samples.md) ATL sample for an example. + See the `.idl` file in the [Circ](../overview/visual-cpp-samples.md) ATL sample for an example. -3. Use Class View to add methods and properties to the event interface. Right-click the class in Class View, point to **Add** on the shortcut menu, and click **Add Connection Point**. +3. Use **Class View** to add methods and properties to the event interface. Right-click the class in **Class View**, point to **Add** on the shortcut menu, and click **Add Connection Point**. -4. In the **Source Interfaces** list box of the Implement Connection Point Wizard, select **Project's interfaces**. If you choose an interface for your control and press **OK**, you will: +4. In the **Source Interfaces** list box of the **Implement Connection Point Wizard**, select **Project's interfaces**. If you choose an interface for your control and select **OK**, you: - Generate a header file with an event proxy class that implements the code that will make the outgoing calls for the event. - - Add an entry to the connection point map. - You will also see a list of all of the type libraries on your computer. You should only use one of these other type libraries to define your connection point if you want to implement the exact same outgoing interface found in another type library. - -### To reuse a connection point interface defined in another type library + You also see a list of all of the type libraries on your computer. Only use one of these other type libraries to define your connection point if you want to implement the exact same outgoing interface found in another type library. -1. In Class View, right-click a class that implements a **BEGIN_COM_MAP** macro, point to **Add** on the shortcut menu, and click **Add Connection Point**. +### Reuse a connection point interface defined in another type library -2. In the Implement Connection Point Wizard, select a type library and an interface in the type library and click **Add**. +1. In **Class View**, right-click a class that implements a `BEGIN_COM_MAP` macro, point at **Add** on the shortcut menu, and select **Add Connection Point**. -3. Edit the .idl file to either: +2. In the **Implement Connection Point Wizard**, select a type library and an interface in the type library and select **Add**. - - Copy the dispinterface from the .idl file for the object whose event-source is being used. +3. Edit the `.idl` file to either: + - Copy the dispinterface from the `.idl` file for the object whose event-source is being used. - Use the **importlib** instruction on that type library. ## See also From 57a1bc690d5c5f2a3cf89d296d9cd4909cfb2293 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 24 Jun 2025 17:02:00 -0700 Subject: [PATCH 0176/1799] Update adding-connection-points-to-an-object.md missed one --- docs/atl/adding-connection-points-to-an-object.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/atl/adding-connection-points-to-an-object.md b/docs/atl/adding-connection-points-to-an-object.md index 07c4588cdf1..94e397fcf36 100644 --- a/docs/atl/adding-connection-points-to-an-object.md +++ b/docs/atl/adding-connection-points-to-an-object.md @@ -29,7 +29,7 @@ In either case, the **Implement Connection Point Wizard** uses a type library to See the `.idl` file in the [Circ](../overview/visual-cpp-samples.md) ATL sample for an example. -3. Use **Class View** to add methods and properties to the event interface. Right-click the class in **Class View**, point to **Add** on the shortcut menu, and click **Add Connection Point**. +3. Use **Class View** to add methods and properties to the event interface. Right-click the class in **Class View**, point to **Add** on the shortcut menu, and select **Add Connection Point**. 4. In the **Source Interfaces** list box of the **Implement Connection Point Wizard**, select **Project's interfaces**. If you choose an interface for your control and select **OK**, you: From eceae836700c29d20c79596bb88f8b12601c0044 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 24 Jun 2025 17:13:25 -0700 Subject: [PATCH 0177/1799] Update scl-secure-no-warnings.md I didn't like the [other compiler options] that was in there originally because it doesn't add anything and can potentially make someone think the warning flag must come first. --- docs/standard-library/scl-secure-no-warnings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/scl-secure-no-warnings.md b/docs/standard-library/scl-secure-no-warnings.md index 10be87757e9..3b64ea9b133 100644 --- a/docs/standard-library/scl-secure-no-warnings.md +++ b/docs/standard-library/scl-secure-no-warnings.md @@ -40,7 +40,7 @@ Other ways to disable warning C4996 include: Also, you can manually change the level of warning C4996 with the `/w` compiler option. For example, to set warning C4996 to level 4: ```cmd -cl /w44996 [other compiler options] myfile.cpp +cl /w44996 myfile.cpp ``` For more information, see [`/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). From 4380ed1ca929884cff9b15e0db35a8de8b766617 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:04:00 +0800 Subject: [PATCH 0178/1799] Tweak example in C4172 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4172.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md index 0223340e504..d9238fbe95f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md @@ -26,7 +26,7 @@ The following example generates C4172: const int* func1() { int i = 42; - return &i; // C4172 + return &i; // C4172 } float f = 1.f; @@ -37,7 +37,7 @@ const double& func2() // const auto& func2() { // The problem is that a temporary is created to convert f to a double. - // C4172 in this case refers to returning the address of a temporary + // C4172 in this case refers to returning the address of a temporary. return f; // C4172 } ``` From 78e189054a5281330c7eb0ff5037e2421b66b081 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:08:33 +0800 Subject: [PATCH 0179/1799] Update C4172 warning message again --- .../compiler-warnings/compiler-warning-level-1-c4172.md | 4 ++-- .../compiler-warnings-c4000-through-c4199.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md index d9238fbe95f..393c35c0c60 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md @@ -1,13 +1,13 @@ --- title: "Compiler Warning (level 1) C4172" description: "Learn more about: Compiler Warning (level 1) C4172" -ms.date: 06/20/2025 +ms.date: 06/25/2025 f1_keywords: ["C4172"] helpviewer_keywords: ["C4172"] --- # Compiler Warning (level 1) C4172 -> returning address of local variable or temporary +> returning address of local variable or temporary : *optional_context* ## Remarks diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md index 675357263c1..83f1da2def0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md @@ -138,7 +138,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1) C4166](compiler-warning-level-1-c4166.md)|illegal calling convention for constructor/destructor| |[Compiler warning (level 1) C4167](compiler-warning-level-1-c4167.md)|'*function*': only available as an intrinsic function| |[Compiler warning (level 1) C4168](compiler-warning-level-1-c4168.md)|compiler limit: out of debugger types, delete program database '*database*' and rebuild| -|[Compiler warning (level 1) C4172](compiler-warning-level-1-c4172.md)|returning address of local variable or temporary *optional_context*| +|[Compiler warning (level 1) C4172](compiler-warning-level-1-c4172.md)|returning address of local variable or temporary : *optional_context*| |[Compiler warning (level 1) C4174](compiler-warning-level-1-c4174.md)|'*name*': not available as a `#pragma component`| |[Compiler warning (level 1) C4175](compiler-warning-level-1-c4175.md)|`#pragma component(browser, on)`: browser info must initially be specified on the command line| |[Compiler warning (level 1) C4176](compiler-warning-level-1-c4176.md)|'*subcomponent*': unknown subcomponent for `#pragma component` browser| From 536c01c3688689cff1c391adc278b360c0610ee8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:42:14 +0800 Subject: [PATCH 0180/1799] Add blockquotes for error messages in range [C1001, C1020] --- docs/error-messages/compiler-errors-1/fatal-error-c1002.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1003.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1004.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1005.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1007.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1008.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1009.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1012.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1013.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1014.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1016.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1017.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1018.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1019.md | 2 +- 14 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md index c001659abf6..a94bd3d71b6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md @@ -8,7 +8,7 @@ ms.assetid: bd6d274a-c7b4-43af-8bf2-23c5e442aa22 --- # Fatal Error C1002 -compiler is out of heap space in pass 2 +> compiler is out of heap space in pass 2 The compiler ran out of dynamic memory space during its second pass, probably due to a program with too many symbols or complex expressions. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md index 651a5259eac..71979536243 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md @@ -8,6 +8,6 @@ ms.assetid: 27d2d009-2e0f-41fb-8bfc-372752fbe920 --- # Fatal Error C1003 -error count exceeds number; stopping compilation +> error count exceeds number; stopping compilation Errors in the program are too numerous to allow recovery. The compiler must terminate. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md index 266090b83c3..87b433e0911 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md @@ -8,7 +8,7 @@ ms.assetid: dbe034b0-6eb0-41b4-a50c-2fccf9e78ad4 --- # Fatal Error C1004 -unexpected end of file found +> unexpected end of file found The compiler reached the end of a source file without resolving a construct. The code may be missing one of the following elements: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md index cbb2d4aa5b2..9040fac4b4c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md @@ -8,7 +8,7 @@ ms.assetid: 150daf8e-a38a-4669-9c1a-a05b5a1f65ef --- # Fatal Error C1005 -string too big for buffer +> string too big for buffer A string in a compiler intermediate file overflowed a buffer. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md index 23d81272a56..b286bc82bb7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md @@ -8,6 +8,6 @@ ms.assetid: 224f7e2c-4522-4e09-b455-8d293bdb799d --- # Fatal Error C1007 -unrecognized flag string in option +> unrecognized flag string in option The command-line option contains an invalid string. Check the **CL** command line and environment variable for errors. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md index df73ac1ebd3..8bbec4302f3 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md @@ -8,6 +8,6 @@ ms.assetid: 7de729e3-b2ca-4a68-95ab-8a1c920f3f2c --- # Fatal Error C1008 -no input file specified +> no input file specified The compiler was not given a C or C++ source file to compile. Check the **CL** command line and environment variable for filename specifications. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md index 358d670bec1..2eaba99ce22 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md @@ -8,6 +8,6 @@ ms.assetid: dcc8383c-3362-4c47-9c26-25d2451ebd53 --- # Fatal Error C1009 -compiler limit : macros nested too deeply +> compiler limit : macros nested too deeply The compiler tried to expand too many macros at the same time. The compiler has a limit of 256 levels of nested macros. Split nested macros into simpler macros. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md index 21849c9d15b..11814ea9a7f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C1012"] --- # Fatal Error C1012 -unmatched parenthesis: missing 'character' +> unmatched parenthesis: missing 'character' The parentheses in a preprocessor directive do not match. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md index c8950e24e8a..3c5d5926a4b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md @@ -8,7 +8,7 @@ ms.assetid: 5514a679-efe7-4055-bdd3-5693ca0c332f --- # Fatal Error C1013 -compiler limit : too many open parentheses +> compiler limit : too many open parentheses An expression contains too many levels of parentheses in a single expression. Simplify the expression or break it into multiple statements. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md index 084aa82fad9..a6062affcea 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md @@ -8,6 +8,6 @@ ms.assetid: 4c01ef70-e765-4d07-a3fe-a11c19fb610b --- # Fatal Error C1014 -too many include files : depth = level +> too many include files : depth = level The nesting of `#include` directives is too deep. Nested directives can include open files. The source file containing the directive counts as one file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md index c921566c37a..98ff599e32f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md @@ -8,7 +8,7 @@ ms.assetid: 33f45c3e-2d8f-43ad-a445-c412d1d54ce1 --- # Fatal Error C1016 -\#ifdef expected an identifier#ifndef expected an identifier +> #ifdef expected an identifier#ifndef expected an identifier The conditional compilation directive ([#ifdef](../../preprocessor/hash-ifdef-and-hash-ifndef-directives-c-cpp.md) or `#ifndef`) has no identifier to evaluate. To resolve the error, specify an identifier. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md index cd6fbcbc772..271591edcb1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md @@ -8,7 +8,7 @@ ms.assetid: 5542e604-599d-4e36-8f83-1d454c5753c9 --- # Fatal Error C1017 -invalid integer constant expression +> invalid integer constant expression The expression in an `#if` directive did not exist or did not evaluate to a constant. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md index 4283dedc9d1..096eb08d0be 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md @@ -8,7 +8,7 @@ ms.assetid: 2ceb8a99-30b2-4b80-bf42-e9f3305b3c52 --- # Fatal Error C1018 -unexpected #elif +> unexpected #elif The `#elif` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#elif` only within one of these constructs. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md index 5d51ab87de9..f2097428967 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md @@ -8,7 +8,7 @@ ms.assetid: c4f8968b-bc62-4200-b3ca-69d06c163236 --- # Fatal Error C1019 -unexpected #else +> unexpected #else The `#else` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#else` only within one of these constructs. From 7ce83a17a83be62e65c66e521a657de858272ccb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:48:41 +0800 Subject: [PATCH 0181/1799] Add "Remarks" and "Example" headings for error references in range [C1001, C1020] --- docs/error-messages/compiler-errors-1/fatal-error-c1001.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1002.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1003.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1004.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1005.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1007.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1008.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1009.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1012.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1013.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1014.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1015.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1016.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1017.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1018.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1019.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1020.md | 2 +- 17 files changed, 45 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md index d2dc62f249f..2bbbd56ed08 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md @@ -10,6 +10,8 @@ ms.assetid: 5736cdb3-22c8-4fad-aa85-d5e0d2b232f4 > INTERNAL COMPILER ERROR(compiler file *file*, line *number*) +## Remarks + The compiler cannot generate correct code for a construct, often due to the combination of a particular expression and an optimization option, or an issue in parsing. If the compiler file listed has a utc or C2 path segment, it is probably an optimization error. If the file has a cxxfe or c1xx path segment, or is msc1.cpp, it is probably a parser error. If the file named is cl.exe, there is no other information available. You can often fix an optimization problem by removing one or more optimization options. To determine which option is at fault, remove options one at a time and recompile until the error message goes away. The options most commonly responsible are [/Og (Global optimizations)](../../build/reference/og-global-optimizations.md) and [/Oi (Generate Intrinsic Functions)](../../build/reference/oi-generate-intrinsic-functions.md). Once you determine which optimization option is responsible, you can disable it around the function where the error occurs by using the [optimize](../../preprocessor/optimize.md) pragma, and continue to use the option for the rest of the module. For more information about optimization options, see [Optimization best practices](../../build/optimization-best-practices.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md index a94bd3d71b6..f522ddffad5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md @@ -10,6 +10,8 @@ ms.assetid: bd6d274a-c7b4-43af-8bf2-23c5e442aa22 > compiler is out of heap space in pass 2 +## Remarks + The compiler ran out of dynamic memory space during its second pass, probably due to a program with too many symbols or complex expressions. ### To fix by using the following possible solutions diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md index 71979536243..a4acb20be06 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md @@ -10,4 +10,6 @@ ms.assetid: 27d2d009-2e0f-41fb-8bfc-372752fbe920 > error count exceeds number; stopping compilation +## Remarks + Errors in the program are too numerous to allow recovery. The compiler must terminate. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md index 87b433e0911..2f1b2bb37e3 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md @@ -10,6 +10,8 @@ ms.assetid: dbe034b0-6eb0-41b4-a50c-2fccf9e78ad4 > unexpected end of file found +## Remarks + The compiler reached the end of a source file without resolving a construct. The code may be missing one of the following elements: - A closing brace @@ -28,6 +30,8 @@ To resolve this error, check for the following: - A source file does not end with a carriage return and line feed. +## Example + The following sample generates C1004: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md index 9040fac4b4c..41aa8016a74 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md @@ -10,6 +10,8 @@ ms.assetid: 150daf8e-a38a-4669-9c1a-a05b5a1f65ef > string too big for buffer +## Remarks + A string in a compiler intermediate file overflowed a buffer. You could get this error when the parameter that you pass to either the [/Fd](../../build/reference/fd-program-database-file-name.md) or [/Yl](../../build/reference/yl-inject-pch-reference-for-debug-library.md) compiler options is greater than 256 bytes. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md index b286bc82bb7..4f5d07421f8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md @@ -10,4 +10,6 @@ ms.assetid: 224f7e2c-4522-4e09-b455-8d293bdb799d > unrecognized flag string in option +## Remarks + The command-line option contains an invalid string. Check the **CL** command line and environment variable for errors. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md index 8bbec4302f3..e2a23dbb266 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md @@ -10,4 +10,6 @@ ms.assetid: 7de729e3-b2ca-4a68-95ab-8a1c920f3f2c > no input file specified +## Remarks + The compiler was not given a C or C++ source file to compile. Check the **CL** command line and environment variable for filename specifications. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md index 2eaba99ce22..749692f4b65 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md @@ -10,4 +10,6 @@ ms.assetid: dcc8383c-3362-4c47-9c26-25d2451ebd53 > compiler limit : macros nested too deeply +## Remarks + The compiler tried to expand too many macros at the same time. The compiler has a limit of 256 levels of nested macros. Split nested macros into simpler macros. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md index 11814ea9a7f..269fc28fef0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C1012"] > unmatched parenthesis: missing 'character' +## Remarks + The parentheses in a preprocessor directive do not match. +## Example + The following sample generates C1012: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md index 3c5d5926a4b..2587dcaf3fe 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md @@ -10,6 +10,8 @@ ms.assetid: 5514a679-efe7-4055-bdd3-5693ca0c332f > compiler limit : too many open parentheses +## Remarks + An expression contains too many levels of parentheses in a single expression. Simplify the expression or break it into multiple statements. Prior to Visual C++ 6.0 Service Pack 3, the limit on nested parenthesis in a single expression was 59. Currently, the limit on nested parenthesis is 256. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md index a6062affcea..b8ce439c787 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md @@ -10,4 +10,6 @@ ms.assetid: 4c01ef70-e765-4d07-a3fe-a11c19fb610b > too many include files : depth = level +## Remarks + The nesting of `#include` directives is too deep. Nested directives can include open files. The source file containing the directive counts as one file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1015.md b/docs/error-messages/compiler-errors-1/fatal-error-c1015.md index 71edb00f18f..7b161e0ef81 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1015.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1015.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1015"] > header-names '*header-name*' and '*header-name*' identify the same header and cannot be used as both `/headerUnit:quote` and `/headerUnit:angle` arguments; please provide this header-name only once +## Remarks + Don't include a header unit using both double-quotes and angle brackets. Use only one form, consistent with the **`/headerUnit:quote`** or **`/headerUnit:angle`** compiler option. For more information, see [`/headerUnit` (Use header unit IFC)](../../build/reference/headerunit.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md index 98ff599e32f..51c3533c6ae 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md @@ -10,8 +10,12 @@ ms.assetid: 33f45c3e-2d8f-43ad-a445-c412d1d54ce1 > #ifdef expected an identifier#ifndef expected an identifier +## Remarks + The conditional compilation directive ([#ifdef](../../preprocessor/hash-ifdef-and-hash-ifndef-directives-c-cpp.md) or `#ifndef`) has no identifier to evaluate. To resolve the error, specify an identifier. +## Example + The following sample generates C1016: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md index 271591edcb1..8acf1f28673 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md @@ -10,10 +10,14 @@ ms.assetid: 5542e604-599d-4e36-8f83-1d454c5753c9 > invalid integer constant expression +## Remarks + The expression in an `#if` directive did not exist or did not evaluate to a constant. Constants defined using `#define` must have values that evaluate to an integer constant if they are used in an `#if`, `#elif`, or `#else` directive. +## Example + The following sample generates C1017: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md index 096eb08d0be..0c9542ff9c7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md @@ -10,8 +10,12 @@ ms.assetid: 2ceb8a99-30b2-4b80-bf42-e9f3305b3c52 > unexpected #elif +## Remarks + The `#elif` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#elif` only within one of these constructs. +## Example + The following sample generates C1018: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md index f2097428967..04de2828c0b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md @@ -10,8 +10,12 @@ ms.assetid: c4f8968b-bc62-4200-b3ca-69d06c163236 > unexpected #else +## Remarks + The `#else` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#else` only within one of these constructs. +## Example + The following sample generates C1019: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md index 1fb7fcdb590..195e1ed8ba5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md @@ -16,7 +16,7 @@ The `#endif` directive has no matching `#if`, `#ifdef`, or `#ifndef` directive. This error can occur if you have conditional preprocessor directives before you include a precompiled header file. The compiler ignores everything in the file before the precompiled header, including any `#if`, `#ifdef`, or `#ifndef` directives. For more information, see [`/Yu` (Use precompiled header)](../../build/reference/yu-use-precompiled-header-file.md). -## Examples +## Example The following sample generates C1020: From e30c6109a9d6993a18ada97a6445f30e96c8d773 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:50:56 +0800 Subject: [PATCH 0182/1799] Replace term "sample" with "example" for error references in range [C1001, C1020] --- docs/error-messages/compiler-errors-1/fatal-error-c1004.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1012.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1016.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1017.md | 4 ++-- docs/error-messages/compiler-errors-1/fatal-error-c1018.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1019.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1020.md | 2 +- 7 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md index 2f1b2bb37e3..a759e67af03 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md @@ -32,7 +32,7 @@ To resolve this error, check for the following: ## Example -The following sample generates C1004: +The following example generates C1004: ```cpp // C1004.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md index 269fc28fef0..422565f1415 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md @@ -15,7 +15,7 @@ The parentheses in a preprocessor directive do not match. ## Example -The following sample generates C1012: +The following example generates C1012: ```cpp // C1012.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md index 51c3533c6ae..0f017949ec7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md @@ -16,7 +16,7 @@ The conditional compilation directive ([#ifdef](../../preprocessor/hash-ifdef-an ## Example -The following sample generates C1016: +The following example generates C1016: ```cpp // C1016.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md index 8acf1f28673..f67c8d1110e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md @@ -18,7 +18,7 @@ Constants defined using `#define` must have values that evaluate to an integer c ## Example -The following sample generates C1017: +The following example generates C1017: ```cpp // C1017.cpp @@ -39,7 +39,7 @@ Possible resolution: Because `CONSTANT_NAME` evaluates to a string and not an integer, the `#if` directive generates fatal error C1017. -In other cases, the preprocessor evaluates an undefined constant as zero. This can cause unintended results, as shown in the following sample. `YES` is undefined, so it evaluates to zero. The expression `#if` `CONSTANT_NAME` evaluates to false and the code to be used on `YES` is removed by the preprocessor. `NO` is also undefined (zero), so `#elif` `CONSTANT_NAME==NO` evaluates to true (`0 == 0`), causing the preprocessor to leave the code in the `#elif` portion of the statement — exactly the opposite of the intended behavior. +In other cases, the preprocessor evaluates an undefined constant as zero. This can cause unintended results, as shown in the following example. `YES` is undefined, so it evaluates to zero. The expression `#if` `CONSTANT_NAME` evaluates to false and the code to be used on `YES` is removed by the preprocessor. `NO` is also undefined (zero), so `#elif` `CONSTANT_NAME==NO` evaluates to true (`0 == 0`), causing the preprocessor to leave the code in the `#elif` portion of the statement — exactly the opposite of the intended behavior. ```cpp // C1017c.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md index 0c9542ff9c7..cdc38c2364b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md @@ -16,7 +16,7 @@ The `#elif` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct ## Example -The following sample generates C1018: +The following example generates C1018: ```cpp // C1018.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md index 04de2828c0b..2ce7ece3c9f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md @@ -16,7 +16,7 @@ The `#else` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct ## Example -The following sample generates C1019: +The following example generates C1019: ```cpp // C1019.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md index 195e1ed8ba5..e90b08144e5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md @@ -18,7 +18,7 @@ This error can occur if you have conditional preprocessor directives before you ## Example -The following sample generates C1020: +The following example generates C1020: ```cpp // C1020.cpp From f7309f1e2e2011da58eccd2d2caa58b6dcadc5bb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:55:32 +0800 Subject: [PATCH 0183/1799] Update metadata for error references in range [C1001, C1020] --- docs/error-messages/compiler-errors-1/fatal-error-c1001.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1002.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1003.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1004.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1005.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1007.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1008.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1009.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1010.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1011.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1012.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1013.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1014.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1016.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1017.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1018.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1019.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1020.md | 3 +-- 18 files changed, 33 insertions(+), 49 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md index 2bbbd56ed08..bcf89b5bd87 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1001" title: "Fatal Error C1001" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1001" +ms.date: 11/04/2016 f1_keywords: ["C1001"] helpviewer_keywords: ["C1001"] -ms.assetid: 5736cdb3-22c8-4fad-aa85-d5e0d2b232f4 --- # Fatal Error C1001 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md index f522ddffad5..d254d4e5ced 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1002" title: "Fatal Error C1002" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1002" +ms.date: 11/04/2016 f1_keywords: ["C1002"] helpviewer_keywords: ["C1002"] -ms.assetid: bd6d274a-c7b4-43af-8bf2-23c5e442aa22 --- # Fatal Error C1002 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md index a4acb20be06..453e163d0d4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1003" title: "Fatal Error C1003" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1003" +ms.date: 11/04/2016 f1_keywords: ["C1003"] helpviewer_keywords: ["C1003"] -ms.assetid: 27d2d009-2e0f-41fb-8bfc-372752fbe920 --- # Fatal Error C1003 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md index a759e67af03..e611dbbc9ed 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1004" title: "Fatal Error C1004" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1004" +ms.date: 11/04/2016 f1_keywords: ["C1004"] helpviewer_keywords: ["C1004"] -ms.assetid: dbe034b0-6eb0-41b4-a50c-2fccf9e78ad4 --- # Fatal Error C1004 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md index 41aa8016a74..2d2a87369b9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1005" title: "Fatal Error C1005" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1005" +ms.date: 11/04/2016 f1_keywords: ["C1005"] helpviewer_keywords: ["C1005"] -ms.assetid: 150daf8e-a38a-4669-9c1a-a05b5a1f65ef --- # Fatal Error C1005 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md index 4f5d07421f8..55a3c31b1da 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1007" title: "Fatal Error C1007" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1007" +ms.date: 11/04/2016 f1_keywords: ["C1007"] helpviewer_keywords: ["C1007"] -ms.assetid: 224f7e2c-4522-4e09-b455-8d293bdb799d --- # Fatal Error C1007 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md index e2a23dbb266..1ad6c868baf 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1008" title: "Fatal Error C1008" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1008" +ms.date: 11/04/2016 f1_keywords: ["C1008"] helpviewer_keywords: ["C1008"] -ms.assetid: 7de729e3-b2ca-4a68-95ab-8a1c920f3f2c --- # Fatal Error C1008 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md index 749692f4b65..5ba6678782b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1009" title: "Fatal Error C1009" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1009" +ms.date: 11/04/2016 f1_keywords: ["C1009"] helpviewer_keywords: ["C1009"] -ms.assetid: dcc8383c-3362-4c47-9c26-25d2451ebd53 --- # Fatal Error C1009 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1010.md b/docs/error-messages/compiler-errors-1/fatal-error-c1010.md index 775bed37190..eb64115ebd9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1010.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1010.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1010" title: "Fatal Error C1010" -ms.date: "09/03/2019" +description: "Learn more about: Fatal Error C1010" +ms.date: 09/03/2019 f1_keywords: ["C1010"] helpviewer_keywords: ["C1010"] -ms.assetid: dfd035f1-a7a2-40bc-bc92-dc4d7f456767 --- # Fatal Error C1010 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1011.md b/docs/error-messages/compiler-errors-1/fatal-error-c1011.md index b7517a9e35e..b50d6450ef6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1011.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1011.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1011" title: "Fatal Error C1011" +description: "Learn more about: Fatal Error C1011" ms.date: 08/17/2022 f1_keywords: ["C1011"] helpviewer_keywords: ["C1011"] diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md index 422565f1415..33245ef2b6c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md @@ -1,7 +1,7 @@ --- title: "Fatal Error C1012" description: "Learn more about: Fatal Error C1012" -ms.date: "02/20/2025" +ms.date: 02/20/2025 f1_keywords: ["C1012"] helpviewer_keywords: ["C1012"] --- diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md index 2587dcaf3fe..f0f85a0ee1a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1013" title: "Fatal Error C1013" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1013" +ms.date: 11/04/2016 f1_keywords: ["C1013"] helpviewer_keywords: ["C1013"] -ms.assetid: 5514a679-efe7-4055-bdd3-5693ca0c332f --- # Fatal Error C1013 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md index b8ce439c787..678465c1973 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1014" title: "Fatal Error C1014" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1014" +ms.date: 11/04/2016 f1_keywords: ["C1014"] helpviewer_keywords: ["C1014"] -ms.assetid: 4c01ef70-e765-4d07-a3fe-a11c19fb610b --- # Fatal Error C1014 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md index 0f017949ec7..5dc38afa6a8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1016" title: "Fatal Error C1016" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1016" +ms.date: 11/04/2016 f1_keywords: ["C1016"] helpviewer_keywords: ["C1016"] -ms.assetid: 33f45c3e-2d8f-43ad-a445-c412d1d54ce1 --- # Fatal Error C1016 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md index f67c8d1110e..7ae9f9c0d6a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1017" title: "Fatal Error C1017" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1017" +ms.date: 11/04/2016 f1_keywords: ["C1017"] helpviewer_keywords: ["C1017"] -ms.assetid: 5542e604-599d-4e36-8f83-1d454c5753c9 --- # Fatal Error C1017 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md index cdc38c2364b..6a4fd9b145c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1018" title: "Fatal Error C1018" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1018" +ms.date: 11/04/2016 f1_keywords: ["C1018"] helpviewer_keywords: ["C1018"] -ms.assetid: 2ceb8a99-30b2-4b80-bf42-e9f3305b3c52 --- # Fatal Error C1018 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md index 2ce7ece3c9f..b03103db4e3 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1019" title: "Fatal Error C1019" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1019" +ms.date: 11/04/2016 f1_keywords: ["C1019"] helpviewer_keywords: ["C1019"] -ms.assetid: c4f8968b-bc62-4200-b3ca-69d06c163236 --- # Fatal Error C1019 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md index e90b08144e5..877bba743f4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1020" title: "Fatal Error C1020" +description: "Learn more about: Fatal Error C1020" ms.date: 07/11/2022 f1_keywords: ["C1020"] helpviewer_keywords: ["C1020"] -ms.assetid: 42f429e2-5e3b-4086-a10d-b99e032e51c5 --- # Fatal Error C1020 From d5f670d991a2af2f558413d78ff35bc05521f9bc Mon Sep 17 00:00:00 2001 From: Ratin Gao Date: Fri, 27 Jun 2025 06:42:18 +0800 Subject: [PATCH 0184/1799] Update predefined-macros.md --- docs/preprocessor/predefined-macros.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index 1694c9d5af8..151d80c3eb2 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -312,9 +312,9 @@ MSVC supports other predefined macros: - `_WCHAR_T_DEFINED` Defined as 1 when the default [`/Zc:wchar_t`](../build/reference/zc-wchar-t-wchar-t-is-native-type.md) compiler option is set. The `_WCHAR_T_DEFINED` macro is defined but has no value if the **`/Zc:wchar_t-`** compiler option is set, and **`wchar_t`** is defined in a system header file included in your project. Otherwise, undefined. -- `_WIN32` Defined as 1 when the compilation target is 32-bit ARM, 64-bit ARM, x86, or x64. Otherwise, undefined. +- `_WIN32` Defined as 1 when the compilation target is 32-bit ARM, 64-bit ARM, x86, x64 or ARM64EC. Otherwise, undefined. -- `_WIN64` Defined as 1 when the compilation target is 64-bit ARM or x64. Otherwise, undefined. +- `_WIN64` Defined as 1 when the compilation target is 64-bit ARM, x64 or ARM64EC. Otherwise, undefined. - `_WINRT_DLL` Defined as 1 when compiled as C++ and both [**`/ZW`** (Windows Runtime Compilation)](../build/reference/zw-windows-runtime-compilation.md) and [**`/LD`** or **`/LDd`**](../build/reference/md-mt-ld-use-run-time-library.md) compiler options are set. Otherwise, undefined. From 4d2acb627849752dc8f8af895bfd64bcab78a0bb Mon Sep 17 00:00:00 2001 From: Ratin Gao Date: Fri, 27 Jun 2025 16:00:36 +0800 Subject: [PATCH 0185/1799] Update docs/preprocessor/predefined-macros.md Co-authored-by: Rageking8 <106309953+Rageking8@users.noreply.github.com> --- docs/preprocessor/predefined-macros.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index 151d80c3eb2..2cbcf27992b 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -312,7 +312,7 @@ MSVC supports other predefined macros: - `_WCHAR_T_DEFINED` Defined as 1 when the default [`/Zc:wchar_t`](../build/reference/zc-wchar-t-wchar-t-is-native-type.md) compiler option is set. The `_WCHAR_T_DEFINED` macro is defined but has no value if the **`/Zc:wchar_t-`** compiler option is set, and **`wchar_t`** is defined in a system header file included in your project. Otherwise, undefined. -- `_WIN32` Defined as 1 when the compilation target is 32-bit ARM, 64-bit ARM, x86, x64 or ARM64EC. Otherwise, undefined. +- `_WIN32` Defined as 1 when the compilation target is 32-bit ARM, 64-bit ARM, x86, x64, or ARM64EC. Otherwise, undefined. - `_WIN64` Defined as 1 when the compilation target is 64-bit ARM, x64 or ARM64EC. Otherwise, undefined. From f6fb962ca9e89a830db8e41da20982e963564e03 Mon Sep 17 00:00:00 2001 From: Ratin Gao Date: Fri, 27 Jun 2025 16:00:48 +0800 Subject: [PATCH 0186/1799] Update docs/preprocessor/predefined-macros.md Co-authored-by: Rageking8 <106309953+Rageking8@users.noreply.github.com> --- docs/preprocessor/predefined-macros.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index 2cbcf27992b..501dfdd2bed 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -314,7 +314,7 @@ MSVC supports other predefined macros: - `_WIN32` Defined as 1 when the compilation target is 32-bit ARM, 64-bit ARM, x86, x64, or ARM64EC. Otherwise, undefined. -- `_WIN64` Defined as 1 when the compilation target is 64-bit ARM, x64 or ARM64EC. Otherwise, undefined. +- `_WIN64` Defined as 1 when the compilation target is 64-bit ARM, x64, or ARM64EC. Otherwise, undefined. - `_WINRT_DLL` Defined as 1 when compiled as C++ and both [**`/ZW`** (Windows Runtime Compilation)](../build/reference/zw-windows-runtime-compilation.md) and [**`/LD`** or **`/LDd`**](../build/reference/md-mt-ld-use-run-time-library.md) compiler options are set. Otherwise, undefined. From a044430c558c2554a44771ce14862fac3ba8150a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 27 Jun 2025 16:15:05 +0800 Subject: [PATCH 0187/1799] Remove huge amounts of superfluous spaces in "Data Types (MFC)" topic --- docs/mfc/reference/data-types-mfc.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/mfc/reference/data-types-mfc.md b/docs/mfc/reference/data-types-mfc.md index d1790212f18..b612f04f397 100644 --- a/docs/mfc/reference/data-types-mfc.md +++ b/docs/mfc/reference/data-types-mfc.md @@ -10,13 +10,13 @@ ms.assetid: 8954848b-2c01-4a4f-abf5-ee55f6a05eeb This topic lists the data types most commonly used in the Microsoft Foundation Class Library. Most of the data types are the same as those in the Platform Software Development Kit (SDK), while others are unique to MFC. -For information about the data types used in both the Windows SDK and MFC, see [Windows Data Types](/windows/win32/WinProg/windows-data-types). +For information about the data types used in both the Windows SDK and MFC, see [Windows Data Types](/windows/win32/WinProg/windows-data-types). Data types unique to the Microsoft Foundation Class Library include the following: - POSITION A value used to denote the position of an element in a collection; used by MFC collection classes. -- LPCRECT A 32-bit pointer to a constant (nonmodifiable) `RECT` structure. +- LPCRECT A 32-bit pointer to a constant (nonmodifiable) `RECT` structure. ## See also From a2f072f8b67bcb5cac5d8bf2426f90063fe097da Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 27 Jun 2025 16:16:24 +0800 Subject: [PATCH 0188/1799] Tidy up "See also" section in "Data Types (MFC)" topic --- docs/mfc/reference/data-types-mfc.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/mfc/reference/data-types-mfc.md b/docs/mfc/reference/data-types-mfc.md index b612f04f397..30958b3a6dc 100644 --- a/docs/mfc/reference/data-types-mfc.md +++ b/docs/mfc/reference/data-types-mfc.md @@ -20,5 +20,5 @@ Data types unique to the Microsoft Foundation Class Library include the followin ## See also -[Class Overview](../../mfc/class-library-overview.md)
-[Macros and Globals](../../mfc/reference/mfc-macros-and-globals.md) +[Class Overview](../class-library-overview.md)\ +[Macros and Globals](mfc-macros-and-globals.md) From 09c808160a56a4ea27346dc0f6b2c2f2a2d3e463 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 27 Jun 2025 16:18:00 +0800 Subject: [PATCH 0189/1799] Add backticks in "Data Types (MFC)" topic --- docs/mfc/reference/data-types-mfc.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/mfc/reference/data-types-mfc.md b/docs/mfc/reference/data-types-mfc.md index 30958b3a6dc..7c6705cfb74 100644 --- a/docs/mfc/reference/data-types-mfc.md +++ b/docs/mfc/reference/data-types-mfc.md @@ -14,9 +14,9 @@ For information about the data types used in both the Windows SDK and MFC, see [ Data types unique to the Microsoft Foundation Class Library include the following: -- POSITION A value used to denote the position of an element in a collection; used by MFC collection classes. +- `POSITION` A value used to denote the position of an element in a collection; used by MFC collection classes. -- LPCRECT A 32-bit pointer to a constant (nonmodifiable) `RECT` structure. +- `LPCRECT` A 32-bit pointer to a constant (nonmodifiable) `RECT` structure. ## See also From bb1bda78d4fc14f57d75c314f9221446a396e1a4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 27 Jun 2025 16:20:02 +0800 Subject: [PATCH 0190/1799] Tweak "Data Types (MFC)" topic --- docs/mfc/reference/data-types-mfc.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/mfc/reference/data-types-mfc.md b/docs/mfc/reference/data-types-mfc.md index 7c6705cfb74..4119ead14fe 100644 --- a/docs/mfc/reference/data-types-mfc.md +++ b/docs/mfc/reference/data-types-mfc.md @@ -8,15 +8,14 @@ ms.assetid: 8954848b-2c01-4a4f-abf5-ee55f6a05eeb --- # Data Types (MFC) -This topic lists the data types most commonly used in the Microsoft Foundation Class Library. Most of the data types are the same as those in the Platform Software Development Kit (SDK), while others are unique to MFC. +This topic lists the data types most commonly used in the Microsoft Foundation Class (MFC) Library. Most of the data types are the same as those in the Platform Software Development Kit (SDK), while others are unique to MFC. For information about the data types used in both the Windows SDK and MFC, see [Windows Data Types](/windows/win32/WinProg/windows-data-types). -Data types unique to the Microsoft Foundation Class Library include the following: +Data types unique to MFC include the following: -- `POSITION` A value used to denote the position of an element in a collection; used by MFC collection classes. - -- `LPCRECT` A 32-bit pointer to a constant (nonmodifiable) `RECT` structure. +- `POSITION` - A value used to denote the position of an element in a collection; used by MFC collection classes. +- `LPCRECT` - A 32-bit pointer to a constant (nonmodifiable) `RECT` structure. ## See also From 049a3bcfc6b301278799cad95ea97a7c40b6b001 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 27 Jun 2025 16:23:49 +0800 Subject: [PATCH 0191/1799] Add link to `RECT` in "Data Types (MFC)" topic --- docs/mfc/reference/data-types-mfc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/reference/data-types-mfc.md b/docs/mfc/reference/data-types-mfc.md index 4119ead14fe..848e5e79f5d 100644 --- a/docs/mfc/reference/data-types-mfc.md +++ b/docs/mfc/reference/data-types-mfc.md @@ -15,7 +15,7 @@ For information about the data types used in both the Windows SDK and MFC, see [ Data types unique to MFC include the following: - `POSITION` - A value used to denote the position of an element in a collection; used by MFC collection classes. -- `LPCRECT` - A 32-bit pointer to a constant (nonmodifiable) `RECT` structure. +- `LPCRECT` - A 32-bit pointer to a constant (nonmodifiable) [`RECT`](/windows/win32/api/windef/ns-windef-rect) structure. ## See also From ab95a762323a4817c717dcd189053e444074a86c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 27 Jun 2025 16:24:23 +0800 Subject: [PATCH 0192/1799] Update metadata in "Data Types (MFC)" topic --- docs/mfc/reference/data-types-mfc.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/mfc/reference/data-types-mfc.md b/docs/mfc/reference/data-types-mfc.md index 848e5e79f5d..9893062dab9 100644 --- a/docs/mfc/reference/data-types-mfc.md +++ b/docs/mfc/reference/data-types-mfc.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Data Types (MFC)" title: "Data Types (MFC)" -ms.date: "11/04/2016" +description: "Learn more about: Data Types (MFC)" +ms.date: 11/04/2016 f1_keywords: ["LPCRECT", "POSITION"] helpviewer_keywords: ["LPCRECT data type [MFC]", "WPARAM data type [MFC]", "data types [MFC], MFC", "LRESULT [MFC]", "POSITION data type [MFC]", "UINT [MFC]", "LPVOID data type [MFC]", "COLORREF [MFC]", "LPCTSTR [MFC]", "LPSTR [MFC]", "DWORD operator [MFC]", "WORD data type [MFC]", "LPTSTR [MFC]", "BYTE data type (Windows)", "Long data type [MFC], Windows types", "Boolean data type [MFC], supported data types", "LPARAM data type [MFC]", "LPCSTR [MFC]"] -ms.assetid: 8954848b-2c01-4a4f-abf5-ee55f6a05eeb --- # Data Types (MFC) From c01a295e0864defb0253274d79839b58e3572da3 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Fri, 27 Jun 2025 22:10:50 +0900 Subject: [PATCH 0193/1799] Fix typo: exeception -> exception --- .../CPP/exception-handling-in-the-concurrency-runtime_6.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/parallel/concrt/codesnippet/CPP/exception-handling-in-the-concurrency-runtime_6.cpp b/docs/parallel/concrt/codesnippet/CPP/exception-handling-in-the-concurrency-runtime_6.cpp index ca2b028026c..516134985e6 100644 --- a/docs/parallel/concrt/codesnippet/CPP/exception-handling-in-the-concurrency-runtime_6.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/exception-handling-in-the-concurrency-runtime_6.cpp @@ -18,7 +18,7 @@ int wmain() { parallel_for(-5, 20, [min,max](int i) { - // Throw an exeception if the input value is less than the + // Throw an exception if the input value is less than the // minimum or greater than the maximum. // Otherwise, print the value to the console. From b84d30346cc3ea47b7822c69bac5bacd8ea53f30 Mon Sep 17 00:00:00 2001 From: "YUKI.N" <43741405+YUKI-SOS@users.noreply.github.com> Date: Sat, 28 Jun 2025 05:49:05 +0900 Subject: [PATCH 0194/1799] =?UTF-8?q?Clarify=20distinct=20=E2=80=9CEdit=20?= =?UTF-8?q?and=20Continue=E2=80=9D=20(/ZI)=20option=20and=20fix=20its=20hy?= =?UTF-8?q?perlink?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The existing “Edit and Continue” link mistakenly pointed to the Hot Reload documentation, even though the C++ /ZI Edit and Continue feature is a separate option. --- docs/sanitizers/asan.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan.md b/docs/sanitizers/asan.md index 28681863418..bd9fc7c88c5 100644 --- a/docs/sanitizers/asan.md +++ b/docs/sanitizers/asan.md @@ -137,7 +137,7 @@ AddressSanitizer is integrated with the Visual Studio IDE. To turn on AddressSan To build from the IDE, opt out of any [incompatible options](./asan-known-issues.md#incompatible-options). For an existing project compiled by using **`/Od`** (or Debug mode), you may need to turn off these options: -- Turn off [edit and continue](/visualstudio/debugger/how-to-enable-and-disable-edit-and-continue) +- Turn off [`/ZI` (Debug Information Format)](../build/reference/z7-zi-zi-debug-information-format.md) - Turn off [`/RTC1` (runtime checks)](../build/reference/rtc-run-time-error-checks.md) - Turn off [`/INCREMENTAL` (incremental linking)](../build/reference/incremental-link-incrementally.md) From 9cd1938c185cb7f742200725f4e03e45779b9da0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 17:42:14 +0800 Subject: [PATCH 0195/1799] Add blockquotes for C2166 error message --- docs/error-messages/compiler-errors-1/compiler-error-c2166.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md index a4df5a11666..60fb087ebe6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md @@ -8,7 +8,7 @@ ms.assetid: 12789c3a-cc76-48bb-ae2e-64283e0964ed --- # Compiler Error C2166 -l-value specifies const object +> l-value specifies const object Code attempts to modify an item declared **`const`**. From 378fccd6e27df7fccb83ead58caf5bcf1b944354 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 17:43:56 +0800 Subject: [PATCH 0196/1799] Add "Remarks" and "Example" headings in C2166 error reference --- .../compiler-errors-1/compiler-error-c2166.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md index 60fb087ebe6..083a3e36003 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md @@ -10,9 +10,13 @@ ms.assetid: 12789c3a-cc76-48bb-ae2e-64283e0964ed > l-value specifies const object +## Remarks + Code attempts to modify an item declared **`const`**. -The following sample generates C2166: +## Example + +The following example generates C2166: ```cpp // C2166.cpp From efc6ebe07b40b670772195d008406d79c432b704 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 17:49:24 +0800 Subject: [PATCH 0197/1799] Remove unused function `f` and format example in C2166 error reference --- .../compiler-errors-1/compiler-error-c2166.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md index 083a3e36003..14922dcc388 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md @@ -20,8 +20,8 @@ The following example generates C2166: ```cpp // C2166.cpp -int f(); -int main() { - ( (const int&) 1 ) = 5; // C2166 +int main() +{ + ((const int&)1) = 5; // C2166 } ``` From 8052c8512e1aeffff64c9a5d4b9711eccfad25e9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 17:50:32 +0800 Subject: [PATCH 0198/1799] Update metadata in C2166 error reference --- .../error-messages/compiler-errors-1/compiler-error-c2166.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md index 14922dcc388..82508f2bf90 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2166" title: "Compiler Error C2166" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2166" +ms.date: 06/29/2025 f1_keywords: ["C2166"] helpviewer_keywords: ["C2166"] -ms.assetid: 12789c3a-cc76-48bb-ae2e-64283e0964ed --- # Compiler Error C2166 From f9a84c394348aaca0cf0d6084a047280bb562b66 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 18:16:48 +0800 Subject: [PATCH 0199/1799] Update C2998 error message and add blockquotes --- docs/error-messages/compiler-errors-2/compiler-error-c2998.md | 2 +- .../compiler-errors-2/compiler-errors-c2900-through-c3499.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md index 78bb2293253..ae669282a1c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md @@ -8,7 +8,7 @@ ms.assetid: 8193d491-b5d9-4477-acb1-cf166889c070 --- # Compiler Error C2998 -'identifier' : cannot be a template definition +> '*identifier*': cannot be a template definition The compiler could not process the syntax used in the template definition. diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2900-through-c3499.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2900-through-c3499.md index 2b2fb659592..f426601753e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2900-through-c3499.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2900-through-c3499.md @@ -113,7 +113,7 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C2995](compiler-error-c2995.md) | '*declaration*': function template has already been defined | | [Compiler error C2996](compiler-error-c2996.md) | '*function*': recursive function template definition | | Compiler error C2997 | '*function*': array bound cannot be deduced from a default member initializer | -| [Compiler error C2998](compiler-error-c2998.md) | '*declarator*': cannot be a template definition | +| [Compiler error C2998](compiler-error-c2998.md) | '*identifier*': cannot be a template definition | ## See also From ac52ba180ba45d3ceeccfe3ffcdd50b3731b5705 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 18:18:20 +0800 Subject: [PATCH 0200/1799] Remove outdated example in C2998 error reference --- .../compiler-errors-2/compiler-error-c2998.md | 8 -------- 1 file changed, 8 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md index ae669282a1c..3b895e2acd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md @@ -11,11 +11,3 @@ ms.assetid: 8193d491-b5d9-4477-acb1-cf166889c070 > '*identifier*': cannot be a template definition The compiler could not process the syntax used in the template definition. - -The following sample generates C2998: - -```cpp -// C2998.cpp -// compile with: /c -template int x = 1018; // C2998 -``` From e1aea5c41ca58ccddb126248e5da645dad122454 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 18:19:49 +0800 Subject: [PATCH 0201/1799] Update metadata in C2998 error reference --- .../error-messages/compiler-errors-2/compiler-error-c2998.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md index 3b895e2acd4..0a9e796a05e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2998" title: "Compiler Error C2998" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2998" +ms.date: 06/29/2025 f1_keywords: ["C2998"] helpviewer_keywords: ["C2998"] -ms.assetid: 8193d491-b5d9-4477-acb1-cf166889c070 --- # Compiler Error C2998 From 21a1b6ebb9638a7a4badf7313a3d60366f395271 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 18:21:10 +0800 Subject: [PATCH 0202/1799] Add "Remarks" heading in C2998 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c2998.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md index 0a9e796a05e..f1401071122 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C2998"] > '*identifier*': cannot be a template definition +## Remarks + The compiler could not process the syntax used in the template definition. From 26f2473e152f9698cf00a5e9554f493b73685fbe Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 18:49:10 +0800 Subject: [PATCH 0203/1799] Update C2556 error message and add blockquotes --- docs/error-messages/compiler-errors-2/compiler-error-c2556.md | 2 +- .../compiler-errors-2/compiler-errors-c2500-through-c2599.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md index c53302f927a..6c1bf3e2e09 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md @@ -8,7 +8,7 @@ ms.assetid: fc4399ad-45b3-49fd-be1f-0b13956a595a --- # Compiler Error C2556 -'identifier' : overloaded functions only differ by return type +> '*function1*': overloaded function differs only by return type from '*function2*' The overloaded functions have different return types but the same parameter list. Each overloaded function must have a distinct formal parameter list. diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md index 62ed444ca78..d6a27711af8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md @@ -71,7 +71,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2553](compiler-error-C2553.md)|'*type* *derived_class*::*function*': overriding virtual function return type differs from '*type* *base_class*::*function*'| |Compiler error C2554|'*variable*': 'constinit' only allowed on a variable declaration with static or thread storage duration| |[Compiler error C2555](compiler-error-C2555.md)|'*derived_class*::*function*': overriding virtual function return type differs and is not covariant from '*base_class*::*function*'| -|[Compiler error C2556](compiler-error-C2556.md)|'*type1* *class*::*function*': overloaded function differs only by return type from '*type2* *class*::*function*'| +|[Compiler error C2556](compiler-error-C2556.md)|'*function1*': overloaded function differs only by return type from '*function2*'| |[Compiler error C2557](compiler-error-C2557.md)|'*identifier*': private and protected members cannot be initialized without a constructor| |[Compiler error C2558](compiler-error-C2558.md)|class '*class*': no copy constructor available or copy constructor is declared 'explicit'| |Compiler error C2559|'*identifier*': cannot overload a member function without ref-qualifier with a member function with ref-qualifier| From 473f8b14f1522a8c45984a2407bbb9f8fd2dbb93 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 18:52:24 +0800 Subject: [PATCH 0204/1799] Add "Remarks" and "Example" headings in C2556 error reference --- .../compiler-errors-2/compiler-error-c2556.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md index 6c1bf3e2e09..1d380977878 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md @@ -10,9 +10,13 @@ ms.assetid: fc4399ad-45b3-49fd-be1f-0b13956a595a > '*function1*': overloaded function differs only by return type from '*function2*' +## Remarks + The overloaded functions have different return types but the same parameter list. Each overloaded function must have a distinct formal parameter list. -The following sample generates C2556: +## Example + +The following example generates C2556: ```cpp // C2556.cpp From 6f2b481d34b9477a85156fee9e5eec745f5f1e44 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 18:57:12 +0800 Subject: [PATCH 0205/1799] Simplify and tweak example in C2556 error reference --- .../compiler-errors-2/compiler-error-c2556.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md index 1d380977878..08baf37f6f4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md @@ -21,9 +21,7 @@ The following example generates C2556: ```cpp // C2556.cpp // compile with: /c -class C { - int func(); - double func(); // C2556 - int func(int i); // ok parameter lists differ -}; +int func(); +double func(); // C2556 +int func(int i); // OK parameter lists differ ``` From c79bf08fd4638bee171abcaf95f7683929756c55 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 18:58:45 +0800 Subject: [PATCH 0206/1799] Update metadata in C2556 error reference --- .../error-messages/compiler-errors-2/compiler-error-c2556.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md index 08baf37f6f4..25a188c34cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2556" title: "Compiler Error C2556" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2556" +ms.date: 06/29/2025 f1_keywords: ["C2556"] helpviewer_keywords: ["C2556"] -ms.assetid: fc4399ad-45b3-49fd-be1f-0b13956a595a --- # Compiler Error C2556 From 93b9c8afabaeeae999023f6afeecaa2d5d1c04fb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 22:45:51 +0800 Subject: [PATCH 0207/1799] Fix dangling "see ..." in `complex` class template specializations --- docs/standard-library/complex-double.md | 2 +- docs/standard-library/complex-float.md | 2 +- docs/standard-library/complex-long-double.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/complex-double.md b/docs/standard-library/complex-double.md index 386c66d380f..74a81ae18ed 100644 --- a/docs/standard-library/complex-double.md +++ b/docs/standard-library/complex-double.md @@ -46,7 +46,7 @@ A complex number of type **`double`**. The explicit specialization of the class template complex to a complex class of type **`double`** differs from the class template only in the constructors it defines. The conversion from **`float`** to **`double`** is allowed to be implicit, but the conversion from **`long double`** to **`double`** is required to be **`explicit`**. The use of **`explicit`** rules out the initiation with type conversion using assignment syntax. -For more information on the class template `complex`, see [complex Class](../standard-library/complex-class.md). For a list of members of the class template `complex`, see . +For more information on the class template `complex` and its members, see [`complex` Class](complex-class.md). ## Example diff --git a/docs/standard-library/complex-float.md b/docs/standard-library/complex-float.md index d6672b4dfbe..9228c23f729 100644 --- a/docs/standard-library/complex-float.md +++ b/docs/standard-library/complex-float.md @@ -51,7 +51,7 @@ A complex number of type **`float`**. The explicit specialization of the class template complex to a complex class of type **`float`** differs from the class template only in the constructors it defines. The conversion from **`float`** to **`double`** is allowed to be implicit, but the less safe conversion from **`float`** to **`long double`** is required to be **`explicit`**. The use of **`explicit`** rules out the initiation with type conversion using assignment syntax. -For more information on the class template `complex`, see [complex Class](../standard-library/complex-class.md). For a list of members of the class template `complex`, see . +For more information on the class template `complex` and its members, see [`complex` Class](complex-class.md). ## Example diff --git a/docs/standard-library/complex-long-double.md b/docs/standard-library/complex-long-double.md index b84606143bb..615d9c357b5 100644 --- a/docs/standard-library/complex-long-double.md +++ b/docs/standard-library/complex-long-double.md @@ -46,7 +46,7 @@ A complex number of type **`long double`**. The explicit specialization of the class template `complex` to a complex class of type **`long double`** differs from the class template only in the constructors it defines. The conversion from **`long double`** to **`float`** is allowed to be implicit, but the conversion from **`double`** to **`long double`** is required to be **`explicit`**. The use of **`explicit`** rules out the initiation with type conversion using assignment syntax. -For more information on the class template `complex` and its members, see [complex Class](../standard-library/complex-class.md). +For more information on the class template `complex` and its members, see [`complex` Class](complex-class.md). **Microsoft-specific**: The **`long double`** and **`double`** types have the same representation, but are distinct types. For more information, see [Built-in types](../cpp/fundamental-types-cpp.md). From 27c62e42c5e0c96ca640608e82a7186463106b2c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 22:49:03 +0800 Subject: [PATCH 0208/1799] Add backticks in `complex` class template specializations --- docs/standard-library/complex-double.md | 12 ++++++------ docs/standard-library/complex-float.md | 12 ++++++------ docs/standard-library/complex-long-double.md | 12 ++++++------ 3 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/standard-library/complex-double.md b/docs/standard-library/complex-double.md index 74a81ae18ed..f140bb17bc3 100644 --- a/docs/standard-library/complex-double.md +++ b/docs/standard-library/complex-double.md @@ -29,13 +29,13 @@ constexpr explicit complex(const complex& complexNum); ### Parameters -*RealVal*\ +*`RealVal`*\ The value of type **`double`** for the real part of the complex number being constructed. -*ImagVal*\ +*`ImagVal`*\ The value of type **`double`** for the imaginary part of the complex number being constructed. -*complexNum*\ +*`complexNum`*\ The complex number of type **`float`** or of type **`long double`** whose real and imaginary parts are used to initialize a complex number of type **`double`** being constructed. ## Return Value @@ -105,11 +105,11 @@ arg ( c3 ) = 0.896055 radians, which is 51.3402 degrees. ## Requirements -**Header**: \ +**Header**: `` -**Namespace:** std +**Namespace:** `std` ## See also -[complex Class](../standard-library/complex-class.md)\ +[`complex` Class](../standard-library/complex-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/complex-float.md b/docs/standard-library/complex-float.md index 9228c23f729..821fd786ad3 100644 --- a/docs/standard-library/complex-float.md +++ b/docs/standard-library/complex-float.md @@ -34,13 +34,13 @@ constexpr complex( ### Parameters -*_RealVal*\ +*`_RealVal`*\ The value of type **`float`** for the real part of the complex number being constructed. -*_ImagVal*\ +*`_ImagVal`*\ The value of type **`float`** for the imaginary part of the complex number being constructed. -*complexNum*\ +*`complexNum`*\ The complex number of type **`double`** or of type **`long double`** whose real and imaginary parts are used to initialize a complex number of type **`float`** being constructed. ## Return Value @@ -111,11 +111,11 @@ arg ( c3 ) = 0.927295 radians, which is 53.1301 degrees. ## Requirements -**Header**: \ +**Header**: `` -**Namespace:** std +**Namespace:** `std` ## See also -[complex Class](../standard-library/complex-class.md)\ +[`complex` Class](../standard-library/complex-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/complex-long-double.md b/docs/standard-library/complex-long-double.md index 615d9c357b5..9635fb392a2 100644 --- a/docs/standard-library/complex-long-double.md +++ b/docs/standard-library/complex-long-double.md @@ -29,13 +29,13 @@ complex( ### Parameters -*_RealVal*\ +*`_RealVal`*\ The value of type **`long double`** for the real part of the complex number being constructed. -*_ImagVal*\ +*`_ImagVal`*\ The value of type **`long double`** for the imaginary part of the complex number being constructed. -*complexNum*\ +*`complexNum`*\ The complex number of type **`double`** or of type **`float`** whose real and imaginary parts are used to initialize a complex number of type **`long double`** being constructed. ## Return Value @@ -108,11 +108,11 @@ arg( c3 ) = 0.927295 radians, which is 53.1301 degrees. ## Requirements -**Header**: \ +**Header**: `` -**Namespace:** std +**Namespace:** `std` ## See also -[complex Class](../standard-library/complex-class.md)\ +[`complex` Class](../standard-library/complex-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) From cbb964bc8371bdf084bea4e502374cdcb5b59d12 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 22:51:06 +0800 Subject: [PATCH 0209/1799] Simplify relative links in `complex` class template specializations --- docs/standard-library/complex-double.md | 4 ++-- docs/standard-library/complex-float.md | 4 ++-- docs/standard-library/complex-long-double.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/standard-library/complex-double.md b/docs/standard-library/complex-double.md index f140bb17bc3..83780fa1c68 100644 --- a/docs/standard-library/complex-double.md +++ b/docs/standard-library/complex-double.md @@ -111,5 +111,5 @@ arg ( c3 ) = 0.896055 radians, which is 51.3402 degrees. ## See also -[`complex` Class](../standard-library/complex-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`complex` Class](complex-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/complex-float.md b/docs/standard-library/complex-float.md index 821fd786ad3..4899b0edd1c 100644 --- a/docs/standard-library/complex-float.md +++ b/docs/standard-library/complex-float.md @@ -117,5 +117,5 @@ arg ( c3 ) = 0.927295 radians, which is 53.1301 degrees. ## See also -[`complex` Class](../standard-library/complex-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`complex` Class](complex-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/complex-long-double.md b/docs/standard-library/complex-long-double.md index 9635fb392a2..0242adadd58 100644 --- a/docs/standard-library/complex-long-double.md +++ b/docs/standard-library/complex-long-double.md @@ -114,5 +114,5 @@ arg( c3 ) = 0.927295 radians, which is 53.1301 degrees. ## See also -[`complex` Class](../standard-library/complex-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`complex` Class](complex-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) From 30ab0f97daa2414f108b9cbd5383190eaa2fcd09 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 29 Jun 2025 22:52:30 +0800 Subject: [PATCH 0210/1799] Update metadata in `complex` class template specializations --- docs/standard-library/complex-double.md | 5 ++--- docs/standard-library/complex-float.md | 5 ++--- docs/standard-library/complex-long-double.md | 5 ++--- 3 files changed, 6 insertions(+), 9 deletions(-) diff --git a/docs/standard-library/complex-double.md b/docs/standard-library/complex-double.md index 83780fa1c68..a2dd59629c7 100644 --- a/docs/standard-library/complex-double.md +++ b/docs/standard-library/complex-double.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: complex" title: "complex" -ms.date: "11/04/2016" +description: "Learn more about: complex" +ms.date: 11/04/2016 f1_keywords: ["complex/std::complex"] helpviewer_keywords: ["complex function"] -ms.assetid: 0d0b9d2a-9b9b-410b-82a0-86b6df127e47 --- # `complex` diff --git a/docs/standard-library/complex-float.md b/docs/standard-library/complex-float.md index 4899b0edd1c..3a2537bc63e 100644 --- a/docs/standard-library/complex-float.md +++ b/docs/standard-library/complex-float.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: complex" title: "complex" -ms.date: "11/04/2016" +description: "Learn more about: complex" +ms.date: 11/04/2016 f1_keywords: ["complex/std::complex"] helpviewer_keywords: ["complex function"] -ms.assetid: 1178eb1e-39bd-4017-89cd-aea95f813939 --- # `complex` diff --git a/docs/standard-library/complex-long-double.md b/docs/standard-library/complex-long-double.md index 0242adadd58..1ef66888470 100644 --- a/docs/standard-library/complex-long-double.md +++ b/docs/standard-library/complex-long-double.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: complex" title: "complex" -ms.date: "11/04/2016" +description: "Learn more about: complex" +ms.date: 11/04/2016 f1_keywords: ["std::complex", "complex", "std.complex"] helpviewer_keywords: ["complex function"] -ms.assetid: 37591991-b385-46e9-b727-d534dbc10432 --- # `complex` From e1bba661f578962b3d3fa8559545ee40c9dd57e3 Mon Sep 17 00:00:00 2001 From: Nathalie Laroche <635965+nathlaroche@users.noreply.github.com> Date: Mon, 30 Jun 2025 09:11:22 -0400 Subject: [PATCH 0211/1799] include Tyler's changes --- docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md | 2 +- .../concrt/migrating-from-openmp-to-the-concurrency-runtime.md | 2 +- docs/parallel/multithreading-creating-user-interface-threads.md | 2 +- docs/parallel/multithreading-creating-worker-threads.md | 2 +- docs/parallel/multithreading-terminating-threads.md | 2 +- ...nning-a-cpp-clr-application-on-a-previous-runtime-version.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md b/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md index 24f212130c9..2573a72f55c 100644 --- a/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md +++ b/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md @@ -4,7 +4,7 @@ title: "Using Tooltips in a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["tool tips [MFC], using in status bars", "status bars [MFC], tool tips", "CStatusBarCtrl class [MFC], tool tips"] ms.assetid: a77597a7-43ef-4b8f-87bc-a8ea1dc63dc3 -ms.topic: concept-article +ms.topic: how-to --- # Using Tooltips in a CStatusBarCtrl Object diff --git a/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md b/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md index a7bd32a04ce..8cce219c996 100644 --- a/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md +++ b/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md @@ -5,7 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["Concurrency Runtime, migrating from OpenMP", "OpenMP, migrating to the Concurrency Runtime"] ms.assetid: 9bab7bb1-e45d-44b2-8509-3b226be2c93b ms.custom: intro-migration -ms.topic: concept-article +ms.topic: upgrade-and-migration-article --- # Migrating from OpenMP to the Concurrency Runtime diff --git a/docs/parallel/multithreading-creating-user-interface-threads.md b/docs/parallel/multithreading-creating-user-interface-threads.md index c99ab0ba96d..093e592a9ab 100644 --- a/docs/parallel/multithreading-creating-user-interface-threads.md +++ b/docs/parallel/multithreading-creating-user-interface-threads.md @@ -5,7 +5,7 @@ ms.date: "08/27/2018" f1_keywords: ["CREATE_SUSPENDED", "SECURITY_ATTRIBUTES"] helpviewer_keywords: ["multithreading [C++], user interface threads", "threading [C++], creating threads", "threading [C++], user interface threads", "user interface threads [C++]", "threading [MFC], user interface threads"] ms.assetid: 446925c1-db59-46ea-ae5b-d5ae5d5b91d8 -ms.topic: concept-article +ms.topic: how-to --- # Multithreading: Creating MFC User-Interface Threads diff --git a/docs/parallel/multithreading-creating-worker-threads.md b/docs/parallel/multithreading-creating-worker-threads.md index 2c390f142ec..00d5e3f3426 100644 --- a/docs/parallel/multithreading-creating-worker-threads.md +++ b/docs/parallel/multithreading-creating-worker-threads.md @@ -4,7 +4,7 @@ title: "Multithreading: Creating Worker Threads in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["multithreading [C++], worker threads", "background tasks [C++]", "threading [C++], worker threads", "worker threads [C++]", "threading [C++], creating threads", "threading [MFC], worker threads", "threading [C++], user input not required"] ms.assetid: 670adbfe-041c-4450-a3ed-be14aab15234 -ms.topic: concept-article +ms.topic: how-to --- # Multithreading: Creating Worker Threads in MFC diff --git a/docs/parallel/multithreading-terminating-threads.md b/docs/parallel/multithreading-terminating-threads.md index 8ca9648b308..64fb21623d0 100644 --- a/docs/parallel/multithreading-terminating-threads.md +++ b/docs/parallel/multithreading-terminating-threads.md @@ -4,7 +4,7 @@ title: "Multithreading: Terminating Threads in MFC" ms.date: "08/27/2018" helpviewer_keywords: ["premature thread termination", "starting threads", "threading [MFC], terminating threads", "multithreading [C++], terminating threads", "threading [C++], stopping threads", "terminating threads", "stopping threads", "AfxEndThread method"] ms.assetid: 4c0a8c6d-c02f-456d-bd02-0a8c8d006ecb -ms.topic: concept-article +ms.topic: how-to --- # Multithreading: Terminating Threads in MFC diff --git a/docs/windows/running-a-cpp-clr-application-on-a-previous-runtime-version.md b/docs/windows/running-a-cpp-clr-application-on-a-previous-runtime-version.md index 16191ace681..466682e8f9e 100644 --- a/docs/windows/running-a-cpp-clr-application-on-a-previous-runtime-version.md +++ b/docs/windows/running-a-cpp-clr-application-on-a-previous-runtime-version.md @@ -4,7 +4,7 @@ title: "Running a C++ -clr Application on a Previous Runtime Version" ms.date: "11/04/2016" helpviewer_keywords: ["applications [C++], runtime version specified", "versions [C++]", "app.config files, runtime version specified", "compatibility [C++], runtime version specified", "backward compatibility [C++], runtime version specified", "application deployment [C++], runtime version specified", "common language runtime [C++], version specified", "deploying applications [C++], runtime version specified"] ms.assetid: 940171b7-6937-4b14-8e87-c199e23f4f2e -ms.topic: concept-article +ms.topic: how-to --- # Running a C++ /clr Application on a Previous Runtime Version From 2ba56adefa9c0b001830f4d5f8c56aa6ef393790 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 30 Jun 2025 23:42:36 +0800 Subject: [PATCH 0212/1799] Trim front and back spaces in link destinations --- docs/cpp/results-of-calling-example.md | 2 +- docs/linux/cmake-linux-configure.md | 2 +- docs/overview/overview-of-cpp-development.md | 4 ++-- docs/porting/fix-your-dependencies-on-library-internals.md | 4 ++-- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/cpp/results-of-calling-example.md b/docs/cpp/results-of-calling-example.md index d4b2e023575..7daec61bc58 100644 --- a/docs/cpp/results-of-calling-example.md +++ b/docs/cpp/results-of-calling-example.md @@ -20,7 +20,7 @@ The **`__cdecl`** calling convention The C decorated name (**`__stdcall`**) is `_MyFunc@20`. The C++ decorated name is implementation-specific. -![Diagram showing the stack and registers for the S T D call and this call calling conventions.](../cpp/media/vc37i02.gif )
+![Diagram showing the stack and registers for the S T D call and this call calling conventions.](../cpp/media/vc37i02.gif)
The __stdcall and thiscall calling conventions ## `__fastcall` diff --git a/docs/linux/cmake-linux-configure.md b/docs/linux/cmake-linux-configure.md index 97b0d6ddc7a..195a0cbd832 100644 --- a/docs/linux/cmake-linux-configure.md +++ b/docs/linux/cmake-linux-configure.md @@ -130,7 +130,7 @@ To target WSL, select **Manage Configurations** in the configuration dropdown in The **CMakeSettings.json** window appears. -![CMake settings dialog with the plus button highlighted which adds the selected configuration, which is Linux-GCC-debug.](media/cmake-linux-configurations.png ) +![CMake settings dialog with the plus button highlighted which adds the selected configuration, which is Linux-GCC-debug.](media/cmake-linux-configurations.png) Press **Add Configuration** (the green '+' button) and then choose **Linux-GCC-Debug** or **Linux-GCC-Release** if using GCC. Use the Clang variants if you're using the Clang/LLVM toolset. Press **Select** and then **Ctrl+S** to save the configuration. diff --git a/docs/overview/overview-of-cpp-development.md b/docs/overview/overview-of-cpp-development.md index 8032f92a349..f20f7a918b1 100644 --- a/docs/overview/overview-of-cpp-development.md +++ b/docs/overview/overview-of-cpp-development.md @@ -44,13 +44,13 @@ Source control enables you to coordinate work among multiple developers, isolate ::: moniker range=">=msvc-160" -![Screenshot of the Team Explorer window in Visual Studio 2019.](media/vs2019-team-explorer.png ) +![Screenshot of the Team Explorer window in Visual Studio 2019.](media/vs2019-team-explorer.png) ::: moniker-end ::: moniker range="<=msvc-150" -![Screenshot of the Team Explorer window in Visual Studio 2017.](media/vs2017-team-explorer.png ) +![Screenshot of the Team Explorer window in Visual Studio 2017.](media/vs2017-team-explorer.png) ::: moniker-end diff --git a/docs/porting/fix-your-dependencies-on-library-internals.md b/docs/porting/fix-your-dependencies-on-library-internals.md index da55c80f3cb..195d86ab089 100644 --- a/docs/porting/fix-your-dependencies-on-library-internals.md +++ b/docs/porting/fix-your-dependencies-on-library-internals.md @@ -13,13 +13,13 @@ In most cases, the What's New or Breaking Changes document for each release of V ## _Hash_seq -The internal hash function `std::_Hash_seq(const unsigned char *, size_t)`, used to implement `std::hash` on some string types, was visible in recent versions of the Standard Library. This function implemented an [FNV-1a hash]( https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function) on a character sequence. +The internal hash function `std::_Hash_seq(const unsigned char *, size_t)`, used to implement `std::hash` on some string types, was visible in recent versions of the Standard Library. This function implemented an [FNV-1a hash](https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function) on a character sequence. To remove this dependency, you have a couple of options. - If your intent is to put a `const char *` sequence into an unordered container by using the same hash code machinery as `basic_string`, you can do that by using the `std::hash` template overload that takes a `std::string_view`, which returns that hash code in a portable way. The string library code may or may not rely on use of an FNV-1a hash in the future, so this is the best way to avoid a dependency on a particular hash algorithm. -- If your intent is to generate an FNV-1a hash over arbitrary memory, we've made that code available on GitHub in the [VCSamples]( https://github.com/Microsoft/vcsamples) repository in a stand-alone header file, [fnv1a.hpp](https://github.com/Microsoft/VCSamples/tree/master/VC2015Samples/_Hash_seq), under an [MIT license](https://github.com/Microsoft/VCSamples/blob/master/license.txt). We've also included a copy here for your convenience. You can copy this code into a header file, add the header to any affected code, and then find and replace `_Hash_seq` by `fnv1a_hash_bytes`. You'll get identical behavior to the internal implementation in `_Hash_seq`. +- If your intent is to generate an FNV-1a hash over arbitrary memory, we've made that code available on GitHub in the [VCSamples](https://github.com/Microsoft/vcsamples) repository in a stand-alone header file, [fnv1a.hpp](https://github.com/Microsoft/VCSamples/tree/master/VC2015Samples/_Hash_seq), under an [MIT license](https://github.com/Microsoft/VCSamples/blob/master/license.txt). We've also included a copy here for your convenience. You can copy this code into a header file, add the header to any affected code, and then find and replace `_Hash_seq` by `fnv1a_hash_bytes`. You'll get identical behavior to the internal implementation in `_Hash_seq`. ```cpp /* From 2f25b546ea67ebf1feb12f251563dda8c466c1cf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 30 Jun 2025 23:43:42 +0800 Subject: [PATCH 0213/1799] Clean up metadata for 3 topics --- docs/cpp/results-of-calling-example.md | 5 ++--- docs/overview/overview-of-cpp-development.md | 2 +- docs/porting/fix-your-dependencies-on-library-internals.md | 5 ++--- 3 files changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/cpp/results-of-calling-example.md b/docs/cpp/results-of-calling-example.md index 7daec61bc58..7684793aa79 100644 --- a/docs/cpp/results-of-calling-example.md +++ b/docs/cpp/results-of-calling-example.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Results of Calling Example" title: "Results of Calling Example" -ms.date: "11/19/2018" +description: "Learn more about: Results of Calling Example" +ms.date: 11/19/2018 helpviewer_keywords: ["examples [C++], results of calling", "results, thiscall call", "results, __fastcall keyword call", "results, __cdecl call", "results, __stdcall call"] -ms.assetid: aa70a7cb-ba1d-4aa6-bd0a-ba783da2e642 --- # Results of Calling Example diff --git a/docs/overview/overview-of-cpp-development.md b/docs/overview/overview-of-cpp-development.md index f20f7a918b1..3c29ebebb85 100644 --- a/docs/overview/overview-of-cpp-development.md +++ b/docs/overview/overview-of-cpp-development.md @@ -1,7 +1,7 @@ --- title: "Overview of C++ development in Visual Studio" description: "The Visual Studio IDE supports C++ development on Windows, Linux, Android and iOS with a code editor, debugger, test frameworks, static analyzers, and other programming tools." -ms.date: "12/02/2019" +ms.date: 12/02/2019 helpviewer_keywords: ["Visual C++, development tools"] author: "tylermsft" ms.author: "twhitney" diff --git a/docs/porting/fix-your-dependencies-on-library-internals.md b/docs/porting/fix-your-dependencies-on-library-internals.md index 195d86ab089..432dff02a01 100644 --- a/docs/porting/fix-your-dependencies-on-library-internals.md +++ b/docs/porting/fix-your-dependencies-on-library-internals.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Fix your dependencies on C++ library internals" title: "Fix your dependencies on C++ library internals" -ms.date: "05/24/2017" +description: "Learn more about: Fix your dependencies on C++ library internals" +ms.date: 05/24/2017 helpviewer_keywords: ["library internals in an upgraded Visual Studio C++ project", "_Hash_seq in an upgraded Visual Studio C++ project"] -ms.assetid: 493e0452-6ecb-4edc-ae20-b6fce2d7d3c5 --- # Fix your dependencies on C++ library internals From d6d4276aa8e412cca0a329ca26a3fcb70c2cf290 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 1 Jul 2025 00:01:47 +0800 Subject: [PATCH 0214/1799] Convert CVTRES errors and warnings list into a table --- .../cvtres-errors-cvt1100-through-cvt4001.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md b/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md index 633159c3ad0..cd0a091b82a 100644 --- a/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md +++ b/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md @@ -13,13 +13,17 @@ This section is a reference to the errors and warnings generated by the CVTRES b ## Fatal error messages -[CVTRES fatal error CVT1100](cvtres-fatal-error-cvt1100.md) \ -[CVTRES fatal error CVT1103](cvtres-fatal-error-cvt1103.md) \ -[CVTRES fatal error CVT1105](cvtres-fatal-error-cvt1105.md) +| Error | Message | +|--|--| +| [CVTRES fatal error CVT1100](cvtres-fatal-error-cvt1100.md) | duplicate resource — type:type, name:name, language:language, flags:flags, size:size | +| [CVTRES fatal error CVT1103](cvtres-fatal-error-cvt1103.md) | cannot read filename | +| [CVTRES fatal error CVT1105](cvtres-fatal-error-cvt1105.md) | cannot seek in file | ## Warning messages -[CVTRES warning CVT4001](cvtres-warning-cvt4001.md) +| Warning | Message | +|--|--| +| [CVTRES warning CVT4001](cvtres-warning-cvt4001.md) | machine type not specified; assumed *type* | ## See also From 74642be1cb183a714fc8c472c7c186a8aa9efbf6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 1 Jul 2025 00:02:47 +0800 Subject: [PATCH 0215/1799] Update metadata in "CVTRES errors and warnings (CVTxxxx)" topic --- .../tool-errors/cvtres-errors-cvt1100-through-cvt4001.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md b/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md index cd0a091b82a..0b2040cb66b 100644 --- a/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md +++ b/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: CVTRES errors and warnings (CVTxxxx)" title: "CVTRES errors and warnings" -ms.date: "04/16/2019" +description: "Learn more about: CVTRES errors and warnings (CVTxxxx)" +ms.date: 04/16/2019 f1_keywords: ["CVT1101", "CVT1102", "CVT1104", "CVT1106", "CVT1107", "CVT1108", "CVT1109", "CVT1110"] -ms.assetid: ac94d0fb-0da3-4327-b3d9-ceaeb3fc2e4d --- # CVTRES errors and warnings (CVTxxxx) From e0fd00d51a3e810a674613eb888ce7b8eba3e3de Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 10:06:22 -0700 Subject: [PATCH 0216/1799] Document incompatibility with non-sanitized PCHs --- docs/sanitizers/asan-known-issues.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 6bcd8df0ea1..0e75f0859b9 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -23,6 +23,7 @@ The following options and functionality are incompatible with [`/fsanitize=addre - [C++ AMP](../parallel/amp/cpp-amp-overview.md) is unsupported, and should be disabled. - [Universal Windows Platform](../cppcx/universal-windows-apps-cpp.md) (UWP) applications are unsupported. - [Special case list](https://clang.llvm.org/docs/SanitizerSpecialCaseList.html) files are unsupported. +- [Precompiled headers build without `/fsanitize`address`](../build/creating-precompiled-header-files.md#consistency-rules-for-yc-and-yu) are unsupported. ## Standard library support From e909c7b8dee611042b426fb4f7a1dcee7c6b6e33 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 10:12:36 -0700 Subject: [PATCH 0217/1799] typo: build -> built --- docs/sanitizers/asan-known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 0e75f0859b9..f47d2277e7f 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -23,7 +23,7 @@ The following options and functionality are incompatible with [`/fsanitize=addre - [C++ AMP](../parallel/amp/cpp-amp-overview.md) is unsupported, and should be disabled. - [Universal Windows Platform](../cppcx/universal-windows-apps-cpp.md) (UWP) applications are unsupported. - [Special case list](https://clang.llvm.org/docs/SanitizerSpecialCaseList.html) files are unsupported. -- [Precompiled headers build without `/fsanitize`address`](../build/creating-precompiled-header-files.md#consistency-rules-for-yc-and-yu) are unsupported. +- [Precompiled headers built without `/fsanitize`address`](../build/creating-precompiled-header-files.md#consistency-rules-for-yc-and-yu) are unsupported. ## Standard library support From b757ebbbb3fdb56977ae564984e1178e4482c4fc Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 11:51:59 -0700 Subject: [PATCH 0218/1799] Document how to opt in to ASan runtime options --- docs/sanitizers/asan-runtime.md | 42 ++++++++++++++++++++++++++++++++- 1 file changed, 41 insertions(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 88d62f6be7f..e81dab434e8 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -98,7 +98,47 @@ For an illustration of the alignment requirement and potential issues, see the p ## Run-time options -Microsoft C/C++ (MSVC) uses a runtime based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most runtime options are shared between the two versions. [A complete list of the public Clang runtime options is available here](https://github.com/google/sanitizers/wiki/SanitizerCommonFlags). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). +The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most of clang's ASan runtime options available in MSVC as well. [A complete list of the public Clang runtime options is available here](https://github.com/google/sanitizers/wiki/SanitizerCommonFlags). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). + +### Configuring runtime options + +ASan runtime options can be set in one of two ways: through the `ASAN_OPTIONS` environment variable, or the `__asan_default_options` user function. If the environment variable and the user function select conflicting options, the selection in the `ASAN_OPTIONS` environment variable takes precedence. + +For example, to select the [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mismatch.md) flag, you may use: + +```cmd +set ASAN_OPTIONS=alloc_dealloc_mismatch=1 +``` + +or alternatively use the user-function + +```C++ +extern "C" const char* __asan_default_options() { + return "alloc_dealloc_mismatch=1"; +} + +// ... your code below, such as your `main` function +``` + +Multiple options can be specified by separating them with a colon (i.e `:`). For example, to additionally set `symbolize=0`, one may use: + + +```cmd +set ASAN_OPTIONS=alloc_dealloc_mismatch=1:symbolize=0 +``` + +or alternatively, through the the user-function + +```C++ +extern "C" const char* __asan_default_options() { + return "alloc_dealloc_mismatch=1:symbolize=0; +} + +// ... your code below, such as your `main` function +``` + +> [!NOTE] +> The `ASAN_OPTIONS` environment variable is recommended method for selecting runtime options because it makes the configuration available to the process from the beginning, which helps with correctness. Meanwhile, the user function can only be parsed after the ASan runtime has already been initialized, which means it's options are applied retroactively. ### Unsupported AddressSanitizer options From 825b299a1fcabe079aa862d5f9f1244231f36652 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 12:32:52 -0700 Subject: [PATCH 0219/1799] Document `__asan_handle_no_return` workaround for long jumps --- docs/sanitizers/asan-known-issues.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 6bcd8df0ea1..a66a4ffd33c 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -79,6 +79,12 @@ As a workaround, create a *`Directory.Build.props`* file in the root of your pro Thread local variables (global variables declared with `__declspec(thread)` or `thread_local`) aren't protected by AddressSanitizer. This limitation isn't specific to Windows or Microsoft Visual C++, but is a general limitation. +## Custom code skipping normal function return sequences + +Using custom code / assembly to leave the current stack frame without the usual return mechanisms, such as a long jump or equivalent, is not supported and risks inducing false positives. + +A mitigation for this is to invoke [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) prior to invoking your custom long jump-like procedure. This function clears all shadow bytes associated with the current thread's stack, which mrsnd losing some coverage (i.e risk false negatives) but will allow your program to safely unwind the stack without running into false positives from stale stack shadow bytes. + ## Issues with partially sanitized executables If all of the code in a process isn't compiled with `/fsanitize=address`, ASan may not be able to diagnose all memory safety errors. The most common example is when a DLL is compiled with ASan but is loaded into a process that contains code that wasn't compiled with ASan. In this case, ASan attempts to categorize allocations that took place prior to ASan initialization. Once those allocations are reallocated, ASan tries to own and monitor the lifetime of the memory. From a4e418d632d15c7c77cb1d73421a5c171c57e554 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 12:35:56 -0700 Subject: [PATCH 0220/1799] typo: mrsnd -> means --- docs/sanitizers/asan-known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index a66a4ffd33c..611b8bb7031 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -83,7 +83,7 @@ Thread local variables (global variables declared with `__declspec(thread)` or ` Using custom code / assembly to leave the current stack frame without the usual return mechanisms, such as a long jump or equivalent, is not supported and risks inducing false positives. -A mitigation for this is to invoke [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) prior to invoking your custom long jump-like procedure. This function clears all shadow bytes associated with the current thread's stack, which mrsnd losing some coverage (i.e risk false negatives) but will allow your program to safely unwind the stack without running into false positives from stale stack shadow bytes. +A mitigation for this is to invoke [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) prior to invoking your custom long jump-like procedure. This function clears all shadow bytes associated with the current thread's stack, which means losing some coverage (i.e risk false negatives) but will allow your program to safely unwind the stack without running into false positives from stale stack shadow bytes. ## Issues with partially sanitized executables From 64a299516bf9f27208af8c1a18e74aedea845a2f Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 12:36:15 -0700 Subject: [PATCH 0221/1799] typo: i.e -> i.e. --- docs/sanitizers/asan-known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 611b8bb7031..19bb64f87b7 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -83,7 +83,7 @@ Thread local variables (global variables declared with `__declspec(thread)` or ` Using custom code / assembly to leave the current stack frame without the usual return mechanisms, such as a long jump or equivalent, is not supported and risks inducing false positives. -A mitigation for this is to invoke [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) prior to invoking your custom long jump-like procedure. This function clears all shadow bytes associated with the current thread's stack, which means losing some coverage (i.e risk false negatives) but will allow your program to safely unwind the stack without running into false positives from stale stack shadow bytes. +A mitigation for this is to invoke [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) prior to invoking your custom long jump-like procedure. This function clears all shadow bytes associated with the current thread's stack, which means losing some coverage (i.e. risk false negatives) but will allow your program to safely unwind the stack without running into false positives from stale stack shadow bytes. ## Issues with partially sanitized executables From 219efecb5226cb5bc2d99f7042090b39e6d3ba78 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 14:42:34 -0700 Subject: [PATCH 0222/1799] remove NOTE --- docs/sanitizers/asan-runtime.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index e81dab434e8..e226879a9ba 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -137,9 +137,6 @@ extern "C" const char* __asan_default_options() { // ... your code below, such as your `main` function ``` -> [!NOTE] -> The `ASAN_OPTIONS` environment variable is recommended method for selecting runtime options because it makes the configuration available to the process from the beginning, which helps with correctness. Meanwhile, the user function can only be parsed after the ASan runtime has already been initialized, which means it's options are applied retroactively. - ### Unsupported AddressSanitizer options - detect_container_overflow From c39c1d5fd091d80b849afc8394d5796cf552d085 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 30 Jun 2025 15:09:13 -0700 Subject: [PATCH 0223/1799] Update asan-known-issues.md wording update --- docs/sanitizers/asan-known-issues.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 19bb64f87b7..b69de0efe63 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -79,11 +79,11 @@ As a workaround, create a *`Directory.Build.props`* file in the root of your pro Thread local variables (global variables declared with `__declspec(thread)` or `thread_local`) aren't protected by AddressSanitizer. This limitation isn't specific to Windows or Microsoft Visual C++, but is a general limitation. -## Custom code skipping normal function return sequences +## Custom code skips normal function return sequence -Using custom code / assembly to leave the current stack frame without the usual return mechanisms, such as a long jump or equivalent, is not supported and risks inducing false positives. +Using custom code or assembly language to leave the current stack frame without honoring the usual return mechanisms isn't supported. For example, leaving the current stack frame via a long jump may generate false positives. -A mitigation for this is to invoke [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) prior to invoking your custom long jump-like procedure. This function clears all shadow bytes associated with the current thread's stack, which means losing some coverage (i.e. risk false negatives) but will allow your program to safely unwind the stack without running into false positives from stale stack shadow bytes. +Instead, before invoking custom long jump-like code, call [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) . This function clears all of the shadow bytes associated with the current thread's stack. This results in losing some coverage and introduces a risk of false negatives, but your program can then safely unwind the stack without running into false positives due to stale stack shadow bytes. ## Issues with partially sanitized executables From 4c93686ebcf412038919093600f1be8d96321612 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 30 Jun 2025 15:19:16 -0700 Subject: [PATCH 0224/1799] Update asan-known-issues.md Getting the ASAN score high enough to publish --- docs/sanitizers/asan-known-issues.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index b69de0efe63..b05c4cbe59d 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -28,7 +28,7 @@ The following options and functionality are incompatible with [`/fsanitize=addre The MSVC standard library (STL) makes partial use of the AddressSanitizer and provides other code safety checks. For more information, see [container-overflow error](./error-container-overflow.md). -When annotations are disabled, or in versions of the Standard Library that don't support them, AddressSanitizer exceptions raised in STL code still identify real bugs. However, they are more precise if annotations are enabled and you use a version of the Standard Library that supports them. +When annotations are disabled, or in versions of the Standard Library that don't support them, AddressSanitizer exceptions raised in STL code still identify real bugs. However, they're more precise if annotations are enabled and you use a version of the Standard Library that supports them. This example demonstrates the lack of precision and the benefits of enabling annotations: @@ -63,7 +63,7 @@ AddressSanitizer (ASAN) uses a custom version of `operator new` and `operator de ## Memory usage -The AddressSanitizer runtime doesn't release memory back to the OS during execution. From the OS's point of view, it may look like there's a memory leak. This is intentional so that the memory isn't all allocated up front. +The AddressSanitizer runtime doesn't release memory back to the OS during execution so that the memory isn't all allocated up front. From the OS's point of view, it may look like there's a memory leak. ## AddressSanitizer runtime DLL locations @@ -71,7 +71,7 @@ The *`clang_rt.asan*.dll`* runtime files are installed next to the compilers in ## Custom property sheet support -The Visual Studio Property Manager window allows you to add custom *`.props`* files to your projects. Even though the **Enable Address Sanitizer** property (``) is shown, the build doesn't honor it. That's because the custom *`.props`* files are included after *`Microsoft.cpp.props`*, which uses the `` value to set other properties. +The Visual Studio Property Manager window allows you to add custom *`.props`* files to your projects. Even though the **Enable Address Sanitizer** property (``) is shown, the build doesn't honor it. The build doesn't honor it because the custom *`.props`* files are included after *`Microsoft.cpp.props`*, which uses the `` value to set other properties. As a workaround, create a *`Directory.Build.props`* file in the root of your project to define the `` property. For more information, see [Customize C++ builds](/visualstudio/msbuild/customize-your-build#customize-c-builds). @@ -83,13 +83,13 @@ Thread local variables (global variables declared with `__declspec(thread)` or ` Using custom code or assembly language to leave the current stack frame without honoring the usual return mechanisms isn't supported. For example, leaving the current stack frame via a long jump may generate false positives. -Instead, before invoking custom long jump-like code, call [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) . This function clears all of the shadow bytes associated with the current thread's stack. This results in losing some coverage and introduces a risk of false negatives, but your program can then safely unwind the stack without running into false positives due to stale stack shadow bytes. +Instead, before invoking custom long jump-like code, call [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) . This function clears all of the shadow bytes associated with the current thread's stack, which results in some lost coverage and introduces the risk of false negatives. But your program can then safely unwind the stack without running into false positives due to stale stack shadow bytes. ## Issues with partially sanitized executables -If all of the code in a process isn't compiled with `/fsanitize=address`, ASan may not be able to diagnose all memory safety errors. The most common example is when a DLL is compiled with ASan but is loaded into a process that contains code that wasn't compiled with ASan. In this case, ASan attempts to categorize allocations that took place prior to ASan initialization. Once those allocations are reallocated, ASan tries to own and monitor the lifetime of the memory. +If all of the code in a process isn't compiled with `/fsanitize=address`, ASan may not be able to diagnose all memory safety errors. The most common example is when a DLL compiled with ASan is loaded into a process that contains code not compiled with ASan. In this case, ASan attempts to categorize allocations that took place before ASan initialization. Once those allocations are reallocated, ASan tries to own and monitor the lifetime of the memory. -If all of the DLLs that were compiled with ASan are unloaded from the process before the process ends, there may be crashes due to dangling references to intercepted functions such as `memcmp`, `memcpy`, `memmove`, and so on. For the best results, compile all modules under test with `/fsanitize=address`, or do not unload modules compiled with ASan after they enter the process. +If all of the DLLs compiled with ASan are unloaded from the process before the process ends, there may be crashes due to dangling references to intercepted functions such as `memcmp`, `memcpy`, `memmove`, and so on. For the best results, compile all modules under test with `/fsanitize=address`, or don't unload modules compiled with ASan after they enter the process. Please report any bugs to our [Developer Community](https://aka.ms/feedback/report?space=62). From 0cc453676e0823558441007aeeb57843f9e2953e Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 15:27:51 -0700 Subject: [PATCH 0225/1799] typo: Run-time options -> Runtime options --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index e226879a9ba..d1424c7dde1 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -96,7 +96,7 @@ Any manual poisoning of shadow bytes must consider the alignment requirements. T For an illustration of the alignment requirement and potential issues, see the provided [ASan alignment examples](https://github.com/mcgov/asan_alignment_example). One is a small program to show what can go wrong with manual shadow memory poisoning. The second is an example implementation of manual poisoning using the `std::allocator` interface. -## Run-time options +## Runtime options The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most of clang's ASan runtime options available in MSVC as well. [A complete list of the public Clang runtime options is available here](https://github.com/google/sanitizers/wiki/SanitizerCommonFlags). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). From 5f6205e6689f7ef758ec4789e3cecf06dedada34 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 15:28:15 -0700 Subject: [PATCH 0226/1799] typo: Configuring -> Configure --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index d1424c7dde1..64f00ce0cdc 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -100,7 +100,7 @@ For an illustration of the alignment requirement and potential issues, see the p The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most of clang's ASan runtime options available in MSVC as well. [A complete list of the public Clang runtime options is available here](https://github.com/google/sanitizers/wiki/SanitizerCommonFlags). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). -### Configuring runtime options +### Configure runtime options ASan runtime options can be set in one of two ways: through the `ASAN_OPTIONS` environment variable, or the `__asan_default_options` user function. If the environment variable and the user function select conflicting options, the selection in the `ASAN_OPTIONS` environment variable takes precedence. From 9e3bd662db358e7a47c7cc2a310390ef6288902c Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 15:28:35 -0700 Subject: [PATCH 0227/1799] acrolynx: can be set -> are set --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 64f00ce0cdc..7e45f6c530e 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -102,7 +102,7 @@ The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from t ### Configure runtime options -ASan runtime options can be set in one of two ways: through the `ASAN_OPTIONS` environment variable, or the `__asan_default_options` user function. If the environment variable and the user function select conflicting options, the selection in the `ASAN_OPTIONS` environment variable takes precedence. +ASan runtime options are set in one of two ways: through the `ASAN_OPTIONS` environment variable, or the `__asan_default_options` user function. If the environment variable and the user function select conflicting options, the selection in the `ASAN_OPTIONS` environment variable takes precedence. For example, to select the [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mismatch.md) flag, you may use: From 7a9766bf82074c5ad1f5ee02dc2f0aa68126e2f3 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 15:29:14 -0700 Subject: [PATCH 0228/1799] phrasing: remove "the selection in" --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 7e45f6c530e..6373dc5a7cf 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -102,7 +102,7 @@ The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from t ### Configure runtime options -ASan runtime options are set in one of two ways: through the `ASAN_OPTIONS` environment variable, or the `__asan_default_options` user function. If the environment variable and the user function select conflicting options, the selection in the `ASAN_OPTIONS` environment variable takes precedence. +ASan runtime options are set in one of two ways: through the `ASAN_OPTIONS` environment variable, or the `__asan_default_options` user function. If the environment variable and the user function select conflicting options, the `ASAN_OPTIONS` environment variable takes precedence. For example, to select the [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mismatch.md) flag, you may use: From e23f2427e3ee257eb3a26614d8f6e5dc63f319a3 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 15:29:40 -0700 Subject: [PATCH 0229/1799] grammar: start sentence with "Or" not "or" --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 6373dc5a7cf..c2c5c90da9f 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -110,7 +110,7 @@ For example, to select the [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mism set ASAN_OPTIONS=alloc_dealloc_mismatch=1 ``` -or alternatively use the user-function +Or alternatively use the user-function ```C++ extern "C" const char* __asan_default_options() { From 44f9ace09c526c553be56dd9cde0a54de4ac5a41 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 15:49:11 -0700 Subject: [PATCH 0230/1799] incorporate feedback --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index c2c5c90da9f..00a22b6fb52 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -120,7 +120,7 @@ extern "C" const char* __asan_default_options() { // ... your code below, such as your `main` function ``` -Multiple options can be specified by separating them with a colon (i.e `:`). For example, to additionally set `symbolize=0`, one may use: +Multiple options can be specified by separating them with a colon (`:`). For example, to additionally set `symbolize=0`, one may use: ```cmd From d1a63cf107ec22e23d517da5e2c1a9d40d5832cd Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 15:55:00 -0700 Subject: [PATCH 0231/1799] remove 'one may use' --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 00a22b6fb52..ca171e6987b 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -120,7 +120,7 @@ extern "C" const char* __asan_default_options() { // ... your code below, such as your `main` function ``` -Multiple options can be specified by separating them with a colon (`:`). For example, to additionally set `symbolize=0`, one may use: +Multiple options can be specified by separating them with a colon (`:`). For example, to additionally set `symbolize=0`: ```cmd From 0df95c9e685160418ee88df3fc5661bede58dc65 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 15:56:27 -0700 Subject: [PATCH 0232/1799] disambiguate "the user functon" --- docs/sanitizers/asan-runtime.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index ca171e6987b..28fc557bff2 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -110,7 +110,7 @@ For example, to select the [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mism set ASAN_OPTIONS=alloc_dealloc_mismatch=1 ``` -Or alternatively use the user-function +Alternatively by implementing `__asan_defalt_options()` in your code: ```C++ extern "C" const char* __asan_default_options() { @@ -127,7 +127,7 @@ Multiple options can be specified by separating them with a colon (`:`). For exa set ASAN_OPTIONS=alloc_dealloc_mismatch=1:symbolize=0 ``` -or alternatively, through the the user-function +or alternatively, through `__asan_defalt_options()`: ```C++ extern "C" const char* __asan_default_options() { From 903db807d64b8686933fc52ccd51f8eda800d314 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 30 Jun 2025 15:57:08 -0700 Subject: [PATCH 0233/1799] uppercase "or" --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 28fc557bff2..8e43b5b702c 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -127,7 +127,7 @@ Multiple options can be specified by separating them with a colon (`:`). For exa set ASAN_OPTIONS=alloc_dealloc_mismatch=1:symbolize=0 ``` -or alternatively, through `__asan_defalt_options()`: +Or alternatively, through `__asan_defalt_options()`: ```C++ extern "C" const char* __asan_default_options() { From 1c25a7a07d7dd27e71442da8e3269ef1602e1bc1 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 30 Jun 2025 16:23:26 -0700 Subject: [PATCH 0234/1799] Update asan-runtime.md streamlined --- docs/sanitizers/asan-runtime.md | 30 +++++++++--------------------- 1 file changed, 9 insertions(+), 21 deletions(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 8e43b5b702c..5c3d2c656de 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -102,39 +102,27 @@ The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from t ### Configure runtime options -ASan runtime options are set in one of two ways: through the `ASAN_OPTIONS` environment variable, or the `__asan_default_options` user function. If the environment variable and the user function select conflicting options, the `ASAN_OPTIONS` environment variable takes precedence. +ASan runtime options are set in one of two ways: +- The `ASAN_OPTIONS` environment variable +- The `__asan_default_options` user function -For example, to select the [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mismatch.md) flag, you may use: +If the environment variable and the user function specify conflicting options, the options in the `ASAN_OPTIONS` environment variable take precedence. -```cmd -set ASAN_OPTIONS=alloc_dealloc_mismatch=1 -``` - -Alternatively by implementing `__asan_defalt_options()` in your code: - -```C++ -extern "C" const char* __asan_default_options() { - return "alloc_dealloc_mismatch=1"; -} - -// ... your code below, such as your `main` function -``` - -Multiple options can be specified by separating them with a colon (`:`). For example, to additionally set `symbolize=0`: +Multiple options are specified by separating them with a colon (`:`). +The following example sets [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mismatch.md) and `symbolize`: ```cmd set ASAN_OPTIONS=alloc_dealloc_mismatch=1:symbolize=0 ``` -Or alternatively, through `__asan_defalt_options()`: +Or add the following function to your code: ```C++ -extern "C" const char* __asan_default_options() { +extern "C" const char* __asan_default_options() +{ return "alloc_dealloc_mismatch=1:symbolize=0; } - -// ... your code below, such as your `main` function ``` ### Unsupported AddressSanitizer options From 2ba9246d8cae30f1f870c25005935fe35d49ecec Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 30 Jun 2025 16:26:50 -0700 Subject: [PATCH 0235/1799] Update asan-runtime.md fix typo --- docs/sanitizers/asan-runtime.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 5c3d2c656de..363d7402bc3 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -110,7 +110,7 @@ If the environment variable and the user function specify conflicting options, t Multiple options are specified by separating them with a colon (`:`). -The following example sets [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mismatch.md) and `symbolize`: +The following example sets [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mismatch.md) to one and `symbolize` to zero: ```cmd set ASAN_OPTIONS=alloc_dealloc_mismatch=1:symbolize=0 @@ -121,7 +121,7 @@ Or add the following function to your code: ```C++ extern "C" const char* __asan_default_options() { - return "alloc_dealloc_mismatch=1:symbolize=0; + return "alloc_dealloc_mismatch=1:symbolize=0"; } ``` From 02991654eb53ec3961cc924dca1292652e53a57a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 1 Jul 2025 11:22:22 +0800 Subject: [PATCH 0236/1799] Fix heading merged with description in `CRect` class reference (#5468) * Fix heading merged with description in `CRect` class reference * Update metadata in `CRect` class reference --- docs/atl-mfc-shared/reference/crect-class.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/atl-mfc-shared/reference/crect-class.md b/docs/atl-mfc-shared/reference/crect-class.md index d05e09be56c..a213a9fcb66 100644 --- a/docs/atl-mfc-shared/reference/crect-class.md +++ b/docs/atl-mfc-shared/reference/crect-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CRect Class" title: "CRect Class" -ms.date: "11/06/2018" +description: "Learn more about: CRect Class" +ms.date: 11/06/2018 f1_keywords: ["CRect", "ATLTYPES/ATL::CRect", "ATLTYPES/ATL::CRect::CRect", "ATLTYPES/ATL::CRect::BottomRight", "ATLTYPES/ATL::CRect::CenterPoint", "ATLTYPES/ATL::CRect::CopyRect", "ATLTYPES/ATL::CRect::DeflateRect", "ATLTYPES/ATL::CRect::EqualRect", "ATLTYPES/ATL::CRect::Height", "ATLTYPES/ATL::CRect::InflateRect", "ATLTYPES/ATL::CRect::IntersectRect", "ATLTYPES/ATL::CRect::IsRectEmpty", "ATLTYPES/ATL::CRect::IsRectNull", "ATLTYPES/ATL::CRect::MoveToX", "ATLTYPES/ATL::CRect::MoveToXY", "ATLTYPES/ATL::CRect::MoveToY", "ATLTYPES/ATL::CRect::NormalizeRect", "ATLTYPES/ATL::CRect::OffsetRect", "ATLTYPES/ATL::CRect::PtInRect", "ATLTYPES/ATL::CRect::SetRect", "ATLTYPES/ATL::CRect::SetRectEmpty", "ATLTYPES/ATL::CRect::Size", "ATLTYPES/ATL::CRect::SubtractRect", "ATLTYPES/ATL::CRect::TopLeft", "ATLTYPES/ATL::CRect::UnionRect", "ATLTYPES/ATL::CRect::Width"] helpviewer_keywords: ["LPCRECT data type", "CRect class", "LPRECT operator", "RECT structure"] -ms.assetid: dee4e752-15d6-4db4-b68f-1ad65b2ed6ca --- # `CRect` Class @@ -745,7 +744,9 @@ rect.OffsetRect(230, 230); ASSERT(rect == CRect(230, 230, 265, 265)); ``` -## `CRect::operator LPCRECT` Converts a `CRect` to an [`LPCRECT`](../../mfc/reference/data-types-mfc.md). +## `CRect::operator LPCRECT` + +Converts a `CRect` to an [`LPCRECT`](../../mfc/reference/data-types-mfc.md). ```cpp operator LPCRECT() const throw(); From 3d8ca513bea824280ee02a02c21483dd9d460d76 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Wed, 2 Jul 2025 07:23:42 +0900 Subject: [PATCH 0237/1799] Fix typo: propert pages -> property pages (#5477) --- docs/mfc/property-sheets-and-property-pages-mfc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/property-sheets-and-property-pages-mfc.md b/docs/mfc/property-sheets-and-property-pages-mfc.md index 66e1363c041..bf595657827 100644 --- a/docs/mfc/property-sheets-and-property-pages-mfc.md +++ b/docs/mfc/property-sheets-and-property-pages-mfc.md @@ -2,7 +2,7 @@ description: "Learn more about: Property Sheets and Property Pages (MFC)" title: "Property Sheets and Property Pages (MFC)" ms.date: "11/04/2016" -helpviewer_keywords: ["MFC dialog boxes [MFC], tabs", "property pages [MFC], property sheets", "CPropertyPage class [MFC], property sheets and pages", "CPropertySheet class [MFC], property sheets and pages", "property sheets, propert pages"] +helpviewer_keywords: ["MFC dialog boxes [MFC], tabs", "property pages [MFC], property sheets", "CPropertyPage class [MFC], property sheets and pages", "CPropertySheet class [MFC], property sheets and pages", "property sheets, property pages"] ms.assetid: de8fea12-6c35-4cef-8625-b8073a379446 --- # Property Sheets and Property Pages (MFC) From d2159e13f7a0b179897e318ac7ddd1fee2589720 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Wed, 2 Jul 2025 07:24:00 +0900 Subject: [PATCH 0238/1799] Fix typo: attribue -> attribute (#5478) --- ...ing-a-windows-store-app-using-wrl-and-media-foundation_4.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp b/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp index d5b8967bfde..052da90de52 100644 --- a/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp +++ b/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp @@ -252,7 +252,7 @@ MFT_GRAYSCALE_SATURATION (type = double) MFT_GRAYSCALE_CHROMA_ROTATION (type = double) - Rotates the chroma values of each pixel. The attribue value is the angle of + Rotates the chroma values of each pixel. The attribute value is the angle of rotation in degrees. The result is a shift in hue. The effect is implemented by treating the chroma value of each pixel as a vector [u,v], From 99ba4b73945f464d118cb55bf97e66ef77347193 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Wed, 2 Jul 2025 07:24:28 +0900 Subject: [PATCH 0239/1799] Fix typo: rectange -> rectangle (#5479) --- docs/mfc/reference/cmfcpropertygridctrl-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/reference/cmfcpropertygridctrl-class.md b/docs/mfc/reference/cmfcpropertygridctrl-class.md index 585e3e775f2..08bc061cf36 100644 --- a/docs/mfc/reference/cmfcpropertygridctrl-class.md +++ b/docs/mfc/reference/cmfcpropertygridctrl-class.md @@ -780,7 +780,7 @@ CRect GetListRect() const; ### Return Value -The bounding rectangle of the property grid control. This rectange doesn't include the description area and header. +The bounding rectangle of the property grid control. This rectangle doesn't include the description area and header. ### Remarks From c34f67012df79124e53c6e0f36f0de75d799eae2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 16:09:55 +0800 Subject: [PATCH 0240/1799] Add blockquotes for error messages in range [C1021, C1050] --- docs/error-messages/compiler-errors-1/fatal-error-c1021.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1022.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1023.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1026.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1033.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1035.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1037.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1045.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1046.md | 2 +- 9 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md index 352339095ed..2cfe47033ec 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md @@ -8,7 +8,7 @@ ms.assetid: e23171f4-ca6b-40c0-a913-a2edc6fa3766 --- # Fatal Error C1021 -invalid preprocessor command 'string' +> invalid preprocessor command 'string' `string` is not a valid [preprocessor directive](../../preprocessor/preprocessor-directives.md). To resolve the error, use a valid preprocessor name for `string`. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md index 043664fee8b..addf46e2b52 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md @@ -8,7 +8,7 @@ ms.assetid: edada720-dc73-49bc-bd93-a7945a316312 --- # Fatal Error C1022 -expected #endif +> expected #endif An `#if`, `#ifdef`, or `#ifndef` directive has no matching `#endif` directive. Be sure each `#if`, `#ifdef`, or `#ifndef` has a matching `#endif`. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1023.md b/docs/error-messages/compiler-errors-1/fatal-error-c1023.md index ccfc54d80c6..3460ad6c6dd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1023.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1023.md @@ -8,7 +8,7 @@ ms.assetid: 727b4070-7474-420b-ab11-6530f96c794f --- # Fatal Error C1023 -'file' : unexpected error with pch, try rebuilding the pch +> 'file' : unexpected error with pch, try rebuilding the pch C1023 could be caused by one of several problems, the solution to which is a rebuild of the precompiled header file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1026.md b/docs/error-messages/compiler-errors-1/fatal-error-c1026.md index b210727debf..186b70e04ec 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1026.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1026.md @@ -8,7 +8,7 @@ ms.assetid: 89bb9d40-673a-44aa-a9f4-b42c07b49d44 --- # Fatal Error C1026 -parser stack overflow, program too complex +> parser stack overflow, program too complex The space required to parse the program caused a compiler stack overflow. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1033.md b/docs/error-messages/compiler-errors-1/fatal-error-c1033.md index 74b6260d6d9..c2d7d4c664b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1033.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1033.md @@ -8,6 +8,6 @@ ms.assetid: 09976c03-8450-4cf7-8b43-1b91c2c2b9f9 --- # Fatal Error C1033 -cannot open program database pdb +> cannot open program database pdb This error can be caused by a disk error, a temporary lock created by an anti-virus program, a previous debugger instance that has not fully shut down, or parallel build mspdbsrv.exe processes that attempt to access the same file, among other possible causes. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1035.md b/docs/error-messages/compiler-errors-1/fatal-error-c1035.md index b41d21a1702..17b9944a0f7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1035.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1035.md @@ -8,6 +8,6 @@ ms.assetid: 28cdccee-4377-4823-a4d8-89ca7229a83e --- # Fatal Error C1035 -expression too complex; simplify expression +> expression too complex; simplify expression The compiler could not generate code for a complex expression. Split the expression into simpler expressions and recompile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1037.md b/docs/error-messages/compiler-errors-1/fatal-error-c1037.md index 80eecc85dfe..de97a340841 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1037.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1037.md @@ -8,7 +8,7 @@ ms.assetid: 79103bca-ccfb-42e7-aef9-9b90c15b162f --- # Fatal Error C1037 -cannot open object file filename +> cannot open object file filename The object file specified by [/Fo](../../build/reference/fo-object-file-name.md) cannot be opened. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1045.md b/docs/error-messages/compiler-errors-1/fatal-error-c1045.md index ec28119696b..9de1fd0aece 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1045.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1045.md @@ -8,6 +8,6 @@ ms.assetid: 766c2f89-4ecd-4281-adaa-14b270cc0829 --- # Fatal Error C1045 -compiler limit : linkage specifications nested too deeply +> compiler limit : linkage specifications nested too deeply Nested externals exceed the compiler limit. Nested externals are allowed with the external linkage type, such as **`extern`** "C++". Reduce the number of nested externals to resolve the error. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1046.md b/docs/error-messages/compiler-errors-1/fatal-error-c1046.md index 94f902b2fda..d5aaf7928d0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1046.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1046.md @@ -8,6 +8,6 @@ ms.assetid: 822ec5f5-b0b0-4711-99e1-fc237b619af6 --- # Fatal Error C1046 -compiler limit : structure nested too deeply +> compiler limit : structure nested too deeply The structure, union, or class exceeded the nesting limit, which is 15 levels. Rewrite the definition to reduce the nesting level. Split the structure, union, or class into two or more parts by using **`typedef`** to define one or more of the nested structures. From 7464a25fb8b11e627dba40a9e90f0ad15d658ae5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 16:13:44 +0800 Subject: [PATCH 0241/1799] Add "Remarks" and "Example" headings for error references in range [C1021, C1050] --- docs/error-messages/compiler-errors-1/fatal-error-c1021.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1022.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1023.md | 2 ++ .../compiler-errors-1/fatal-error-c1025-c1115.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1026.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1033.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1035.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1037.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1038.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1045.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1046.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1049.md | 2 ++ 12 files changed, 28 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md index 2cfe47033ec..c0c91beaa62 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md @@ -10,8 +10,12 @@ ms.assetid: e23171f4-ca6b-40c0-a913-a2edc6fa3766 > invalid preprocessor command 'string' +## Remarks + `string` is not a valid [preprocessor directive](../../preprocessor/preprocessor-directives.md). To resolve the error, use a valid preprocessor name for `string`. +## Example + The following sample generates C1021: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md index addf46e2b52..40373d5b7fc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md @@ -10,8 +10,12 @@ ms.assetid: edada720-dc73-49bc-bd93-a7945a316312 > expected #endif +## Remarks + An `#if`, `#ifdef`, or `#ifndef` directive has no matching `#endif` directive. Be sure each `#if`, `#ifdef`, or `#ifndef` has a matching `#endif`. +## Example + The following sample generates C1022: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1023.md b/docs/error-messages/compiler-errors-1/fatal-error-c1023.md index 3460ad6c6dd..b4371fddfd7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1023.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1023.md @@ -10,6 +10,8 @@ ms.assetid: 727b4070-7474-420b-ab11-6530f96c794f > 'file' : unexpected error with pch, try rebuilding the pch +## Remarks + C1023 could be caused by one of several problems, the solution to which is a rebuild of the precompiled header file. C1023 may be caused if you attempt to use a precompiled header file on a machine other than the one on which it was built. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md b/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md index caf838ff182..ad0f67d21bf 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1025", "C1115"] > too many nested lambdas +## Remarks + The compiler detected more than an internal limit for nested lambdas in the same scope. The limit is 65,535 in recent versions of Visual Studio. To resolve this issue, reduce the number of nested lambdas in the current scope. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1026.md b/docs/error-messages/compiler-errors-1/fatal-error-c1026.md index 186b70e04ec..d529a96dce0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1026.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1026.md @@ -10,6 +10,8 @@ ms.assetid: 89bb9d40-673a-44aa-a9f4-b42c07b49d44 > parser stack overflow, program too complex +## Remarks + The space required to parse the program caused a compiler stack overflow. Decrease the complexity of expressions by: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1033.md b/docs/error-messages/compiler-errors-1/fatal-error-c1033.md index c2d7d4c664b..a7d2829abb7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1033.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1033.md @@ -10,4 +10,6 @@ ms.assetid: 09976c03-8450-4cf7-8b43-1b91c2c2b9f9 > cannot open program database pdb +## Remarks + This error can be caused by a disk error, a temporary lock created by an anti-virus program, a previous debugger instance that has not fully shut down, or parallel build mspdbsrv.exe processes that attempt to access the same file, among other possible causes. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1035.md b/docs/error-messages/compiler-errors-1/fatal-error-c1035.md index 17b9944a0f7..46b0bf29bcc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1035.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1035.md @@ -10,4 +10,6 @@ ms.assetid: 28cdccee-4377-4823-a4d8-89ca7229a83e > expression too complex; simplify expression +## Remarks + The compiler could not generate code for a complex expression. Split the expression into simpler expressions and recompile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1037.md b/docs/error-messages/compiler-errors-1/fatal-error-c1037.md index de97a340841..25a6100c1a7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1037.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1037.md @@ -10,6 +10,8 @@ ms.assetid: 79103bca-ccfb-42e7-aef9-9b90c15b162f > cannot open object file filename +## Remarks + The object file specified by [/Fo](../../build/reference/fo-object-file-name.md) cannot be opened. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1038.md b/docs/error-messages/compiler-errors-1/fatal-error-c1038.md index fd563949b88..4b50be63916 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1038.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1038.md @@ -10,6 +10,8 @@ ms.assetid: 560dccb8-5b45-46f0-9412-caa4a6172aef > compiler limit : function : control flow state too complex; simplify function +## Remarks + The function has more control-flow states than the compiler can handle. Simplify control flow or split the function into smaller functions. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1045.md b/docs/error-messages/compiler-errors-1/fatal-error-c1045.md index 9de1fd0aece..0cbb808d1ff 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1045.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1045.md @@ -10,4 +10,6 @@ ms.assetid: 766c2f89-4ecd-4281-adaa-14b270cc0829 > compiler limit : linkage specifications nested too deeply +## Remarks + Nested externals exceed the compiler limit. Nested externals are allowed with the external linkage type, such as **`extern`** "C++". Reduce the number of nested externals to resolve the error. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1046.md b/docs/error-messages/compiler-errors-1/fatal-error-c1046.md index d5aaf7928d0..886002a9c7d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1046.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1046.md @@ -10,4 +10,6 @@ ms.assetid: 822ec5f5-b0b0-4711-99e1-fc237b619af6 > compiler limit : structure nested too deeply +## Remarks + The structure, union, or class exceeded the nesting limit, which is 15 levels. Rewrite the definition to reduce the nesting level. Split the structure, union, or class into two or more parts by using **`typedef`** to define one or more of the nested structures. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1049.md b/docs/error-messages/compiler-errors-1/fatal-error-c1049.md index 658e780882f..f5db568f8f9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1049.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1049.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C1049"] > invalid numerical argument '*value*' +## Remarks + The CL.EXE command-line parser found *value* where it was expecting a numerical argument. A C1049 error may occur when the compiler can't find a numerical argument for one of these compiler options: From 83a7f12ac1903bede70be8bbc4cba819c461cf5f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 16:14:55 +0800 Subject: [PATCH 0242/1799] Replace term "sample" with "example" for error references in range [C1021, C1050] --- docs/error-messages/compiler-errors-1/fatal-error-c1021.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1022.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md index c0c91beaa62..8848552bef2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md @@ -16,7 +16,7 @@ ms.assetid: e23171f4-ca6b-40c0-a913-a2edc6fa3766 ## Example -The following sample generates C1021: +The following example generates C1021: ```cpp // C1021.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md index 40373d5b7fc..4a783f32291 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md @@ -16,7 +16,7 @@ An `#if`, `#ifdef`, or `#ifndef` directive has no matching `#endif` directive. B ## Example -The following sample generates C1022: +The following example generates C1022: ```cpp // C1022.cpp From 200bd7b3408be8d69c590be23fe724273751d421 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 16:17:54 +0800 Subject: [PATCH 0243/1799] Update metadata for error references in range [C1021, C1050] --- docs/error-messages/compiler-errors-1/fatal-error-c1021.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1022.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1023.md | 5 ++--- .../compiler-errors-1/fatal-error-c1025-c1115.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1026.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1033.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1035.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1037.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1038.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1045.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1046.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1047.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1049.md | 2 +- 13 files changed, 22 insertions(+), 32 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md index 8848552bef2..4e45879b395 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1021" title: "Fatal Error C1021" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1021" +ms.date: 11/04/2016 f1_keywords: ["C1021"] helpviewer_keywords: ["C1021"] -ms.assetid: e23171f4-ca6b-40c0-a913-a2edc6fa3766 --- # Fatal Error C1021 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md index 4a783f32291..365d7c9b8f5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1022" title: "Fatal Error C1022" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1022" +ms.date: 11/04/2016 f1_keywords: ["C1022"] helpviewer_keywords: ["C1022"] -ms.assetid: edada720-dc73-49bc-bd93-a7945a316312 --- # Fatal Error C1022 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1023.md b/docs/error-messages/compiler-errors-1/fatal-error-c1023.md index b4371fddfd7..48c1c71a23d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1023.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1023.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1023" title: "Fatal Error C1023" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1023" +ms.date: 11/04/2016 f1_keywords: ["C1023"] helpviewer_keywords: ["C1023"] -ms.assetid: 727b4070-7474-420b-ab11-6530f96c794f --- # Fatal Error C1023 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md b/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md index ad0f67d21bf..cd5353d6cfa 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1025, C1115" title: "Fatal Error C1025, C1115" +description: "Learn more about: Fatal Error C1025, C1115" ms.date: 08/17/2022 f1_keywords: ["C1025", "C1115"] helpviewer_keywords: ["C1025", "C1115"] diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1026.md b/docs/error-messages/compiler-errors-1/fatal-error-c1026.md index d529a96dce0..adc8b235f2b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1026.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1026.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1026" title: "Fatal Error C1026" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1026" +ms.date: 11/04/2016 f1_keywords: ["C1026"] helpviewer_keywords: ["C1026"] -ms.assetid: 89bb9d40-673a-44aa-a9f4-b42c07b49d44 --- # Fatal Error C1026 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1033.md b/docs/error-messages/compiler-errors-1/fatal-error-c1033.md index a7d2829abb7..5e5ab6734b9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1033.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1033.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1033" title: "Fatal Error C1033" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1033" +ms.date: 11/04/2016 f1_keywords: ["C1033"] helpviewer_keywords: ["C1033"] -ms.assetid: 09976c03-8450-4cf7-8b43-1b91c2c2b9f9 --- # Fatal Error C1033 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1035.md b/docs/error-messages/compiler-errors-1/fatal-error-c1035.md index 46b0bf29bcc..ddeb60ad0fc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1035.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1035.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1035" title: "Fatal Error C1035" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1035" +ms.date: 11/04/2016 f1_keywords: ["C1035"] helpviewer_keywords: ["C1035"] -ms.assetid: 28cdccee-4377-4823-a4d8-89ca7229a83e --- # Fatal Error C1035 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1037.md b/docs/error-messages/compiler-errors-1/fatal-error-c1037.md index 25a6100c1a7..ccc83f0680e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1037.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1037.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1037" title: "Fatal Error C1037" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1037" +ms.date: 11/04/2016 f1_keywords: ["C1037"] helpviewer_keywords: ["C1037"] -ms.assetid: 79103bca-ccfb-42e7-aef9-9b90c15b162f --- # Fatal Error C1037 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1038.md b/docs/error-messages/compiler-errors-1/fatal-error-c1038.md index 4b50be63916..ac3e9b80f8d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1038.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1038.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1038" title: "Fatal Error C1038" +description: "Learn more about: Fatal Error C1038" ms.date: 08/17/2022 f1_keywords: ["C1038"] helpviewer_keywords: ["C1038"] -ms.assetid: 560dccb8-5b45-46f0-9412-caa4a6172aef --- # Fatal Error C1038 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1045.md b/docs/error-messages/compiler-errors-1/fatal-error-c1045.md index 0cbb808d1ff..5251ca128ef 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1045.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1045.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1045" title: "Fatal Error C1045" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1045" +ms.date: 11/04/2016 f1_keywords: ["C1045"] helpviewer_keywords: ["C1045"] -ms.assetid: 766c2f89-4ecd-4281-adaa-14b270cc0829 --- # Fatal Error C1045 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1046.md b/docs/error-messages/compiler-errors-1/fatal-error-c1046.md index 886002a9c7d..66d20348517 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1046.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1046.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1046" title: "Fatal Error C1046" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1046" +ms.date: 11/04/2016 f1_keywords: ["C1046"] helpviewer_keywords: ["C1046"] -ms.assetid: 822ec5f5-b0b0-4711-99e1-fc237b619af6 --- # Fatal Error C1046 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1047.md b/docs/error-messages/compiler-errors-1/fatal-error-c1047.md index c868dfe4150..caf2bd6d441 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1047.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1047.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1047" title: "Fatal Error C1047" +description: "Learn more about: Fatal Error C1047" ms.date: 10/22/2021 f1_keywords: ["C1047"] helpviewer_keywords: ["C1047"] diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1049.md b/docs/error-messages/compiler-errors-1/fatal-error-c1049.md index f5db568f8f9..81455150da0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1049.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1049.md @@ -1,7 +1,7 @@ --- title: "Fatal Error C1049" description: "Describes compiler fatal error C1049, invalid numerical argument, and explains how to resolve it." -ms.date: "11/04/2019" +ms.date: 11/04/2019 f1_keywords: ["C1049"] helpviewer_keywords: ["C1049"] --- From 4d5de387039622ceb495486d3aaac170a3e1cefe Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 16:53:56 +0800 Subject: [PATCH 0244/1799] Remove some stray backticks --- docs/mfc/reference/mfc-classes.md | 2 +- docs/preprocessor/compiler-warnings-that-are-off-by-default.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/mfc/reference/mfc-classes.md b/docs/mfc/reference/mfc-classes.md index 83c30958f5b..8389dcd7e55 100644 --- a/docs/mfc/reference/mfc-classes.md +++ b/docs/mfc/reference/mfc-classes.md @@ -71,7 +71,7 @@ Lets you save a complex network of objects in a permanent binary form (usually d Represents a serialization exception condition. [`CArray` Class](carray-class.md)\ -Supports arrays that resemble` C arrays, but can dynamically reduce and grow as necessary. +Supports arrays that resemble C arrays, but can dynamically reduce and grow as necessary. [`CAsyncMonikerFile` Class](casyncmonikerfile-class.md)\ Provides functionality for the use of asynchronous monikers in ActiveX controls (formerly OLE controls). diff --git a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md index da2758a0ba1..ee373f2e0d5 100644 --- a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md +++ b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md @@ -158,7 +158,7 @@ The following warnings are turned off by default in Visual Studio 2019 and later | Warning | Message | |--|--| -| C5052 (level 3) | Keyword '*keyword-name*' was introduced in C++ *version* and requires use of the '*option*' command-line option` 16.1 | +| C5052 (level 3) | Keyword '*keyword-name*' was introduced in C++ *version* and requires use of the '*option*' command-line option 16.1 | | C5204 (level 3) | A class with virtual functions has non-virtual trivial destructor. 16.5 | | C5214 (level 4) | applying '*keyword*' to an operand with a volatile qualified type is deprecated in C++20 16.7 | | C5215 (level 4) | '*function-parameter*' a function parameter with a volatile qualified type is deprecated in C++20 16.7 | From 044e561ca913a34c9d3870b50774ab718bbe4687 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 16:54:28 +0800 Subject: [PATCH 0245/1799] Move `title` above `description` in "Compiler warnings that are off by default" article --- docs/preprocessor/compiler-warnings-that-are-off-by-default.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md index ee373f2e0d5..96a31c29833 100644 --- a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md +++ b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler warnings that are off by default" title: "Compiler warnings that are off by default" +description: "Learn more about: Compiler warnings that are off by default" ms.date: 01/18/2024 helpviewer_keywords: ["warnings, compiler", "cl.exe compiler, setting options"] --- From bdd170a5480f37de1b916d5859c370af939d5cf0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 17:10:01 +0800 Subject: [PATCH 0246/1799] Elide unneeded trailing period or semicolon in headings --- docs/data/oledb/creating-an-updatable-provider.md | 2 +- docs/mfc/reference/cmditabinfo-class.md | 2 +- docs/mfc/testing-properties-and-events-with-test-container.md | 2 +- docs/porting/porting-guide-spy-increment.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/data/oledb/creating-an-updatable-provider.md b/docs/data/oledb/creating-an-updatable-provider.md index dd01af2f426..a01c173031f 100644 --- a/docs/data/oledb/creating-an-updatable-provider.md +++ b/docs/data/oledb/creating-an-updatable-provider.md @@ -174,7 +174,7 @@ Making sure that the data store can handle changes. Handling NULL values. -### Handling default values. +### Handling default values To implement your own `FlushData` method, you need to: diff --git a/docs/mfc/reference/cmditabinfo-class.md b/docs/mfc/reference/cmditabinfo-class.md index 1f9cfbb1760..d68111858cc 100644 --- a/docs/mfc/reference/cmditabinfo-class.md +++ b/docs/mfc/reference/cmditabinfo-class.md @@ -64,7 +64,7 @@ The following example demonstrates how to set the values of the various member v **Header:** afxmdiclientareawnd.h -## CMDITabInfo::m_bActiveTabCloseButton; +## CMDITabInfo::m_bActiveTabCloseButton Specifies whether a **Close** button is displayed on the label of the active tab. diff --git a/docs/mfc/testing-properties-and-events-with-test-container.md b/docs/mfc/testing-properties-and-events-with-test-container.md index 57ef165ae9f..373aa4f0f2f 100644 --- a/docs/mfc/testing-properties-and-events-with-test-container.md +++ b/docs/mfc/testing-properties-and-events-with-test-container.md @@ -37,7 +37,7 @@ At this point you can test your control's properties or events. The property now contains the new value. -#### To test events and specify the destination of event information. +#### To test events and specify the destination of event information 1. On the **Options** menu, click **Logging**. diff --git a/docs/porting/porting-guide-spy-increment.md b/docs/porting/porting-guide-spy-increment.md index 2f471d3e3e4..48a77c5f6c4 100644 --- a/docs/porting/porting-guide-spy-increment.md +++ b/docs/porting/porting-guide-spy-increment.md @@ -15,7 +15,7 @@ Spy++ is a widely used GUI diagnostic tool for the Windows desktop that provides We considered this case to be typical for porting Windows desktop applications that use MFC and the Win32 API, especially for old projects that have not been updated with each release of Visual C++ since Visual C++ 6.0. -## Step 1. Converting the project file. +## Step 1. Converting the project file The project file, two old .dsw files from Visual C++ 6.0, converted easily with no issues that require further attention. One project is the Spy++ application. The other is SpyHk, written in C, a supporting DLL. More complex projects might not upgrade as easily, as discussed [here](../porting/visual-cpp-porting-and-upgrading-guide.md). From 9a93927071bc4d65c1df1e7cf32f373ff48e7f48 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 17:10:54 +0800 Subject: [PATCH 0247/1799] Update metadata in 4 topics --- docs/data/oledb/creating-an-updatable-provider.md | 5 ++--- docs/mfc/reference/cmditabinfo-class.md | 5 ++--- .../mfc/testing-properties-and-events-with-test-container.md | 5 ++--- docs/porting/porting-guide-spy-increment.md | 5 ++--- 4 files changed, 8 insertions(+), 12 deletions(-) diff --git a/docs/data/oledb/creating-an-updatable-provider.md b/docs/data/oledb/creating-an-updatable-provider.md index a01c173031f..cb579e95ae6 100644 --- a/docs/data/oledb/creating-an-updatable-provider.md +++ b/docs/data/oledb/creating-an-updatable-provider.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Creating an Updatable Provider" title: "Creating an Updatable Provider" -ms.date: "08/16/2018" +description: "Learn more about: Creating an Updatable Provider" +ms.date: 08/16/2018 helpviewer_keywords: ["OLE DB providers, updatable", "notifications, support in providers", "OLE DB providers, creating"] -ms.assetid: bdfd5c9f-1c6f-4098-822c-dd650e70ab82 --- # Creating an Updatable Provider diff --git a/docs/mfc/reference/cmditabinfo-class.md b/docs/mfc/reference/cmditabinfo-class.md index d68111858cc..f2c9ffc9a02 100644 --- a/docs/mfc/reference/cmditabinfo-class.md +++ b/docs/mfc/reference/cmditabinfo-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMDITabInfo Class" title: "CMDITabInfo Class" -ms.date: "11/04/2016" +description: "Learn more about: CMDITabInfo Class" +ms.date: 11/04/2016 f1_keywords: ["CMDITabInfo", "AFXMDICLIENTAREAWND/CMDITabInfo", "AFXMDICLIENTAREAWND/CMDITabInfo::Serialize", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bAutoColor", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bDocumentMenu", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bEnableTabSwap", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bFlatFrame", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bTabCloseButton", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bTabCustomTooltips", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bTabIcons", "AFXMDICLIENTAREAWND/CMDITabInfo::m_nTabBorderSize", "AFXMDICLIENTAREAWND/CMDITabInfo::m_style", "AFXMDICLIENTAREAWND/CMDITabInfo::m_tabLocation"] helpviewer_keywords: ["CMDITabInfo [MFC], Serialize", "CMDITabInfo [MFC], m_bAutoColor", "CMDITabInfo [MFC], m_bDocumentMenu", "CMDITabInfo [MFC], m_bEnableTabSwap", "CMDITabInfo [MFC], m_bFlatFrame", "CMDITabInfo [MFC], m_bTabCloseButton", "CMDITabInfo [MFC], m_bTabCustomTooltips", "CMDITabInfo [MFC], m_bTabIcons", "CMDITabInfo [MFC], m_nTabBorderSize", "CMDITabInfo [MFC], m_style", "CMDITabInfo [MFC], m_tabLocation"] -ms.assetid: 988ae1b7-4f7f-4239-b88f-7e28b3291c5e --- # CMDITabInfo Class diff --git a/docs/mfc/testing-properties-and-events-with-test-container.md b/docs/mfc/testing-properties-and-events-with-test-container.md index 373aa4f0f2f..d7258a77d5c 100644 --- a/docs/mfc/testing-properties-and-events-with-test-container.md +++ b/docs/mfc/testing-properties-and-events-with-test-container.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Testing Properties and Events with Test Container" title: "Testing Properties and Events with Test Container" -ms.date: "11/04/2016" +description: "Learn more about: Testing Properties and Events with Test Container" +ms.date: 11/04/2016 helpviewer_keywords: ["testing, test containers", "tstcon32.exe", "debugging ActiveX controls", "test container", "ActiveX Control Test Container", "ActiveX controls [MFC], testing", "properties [MFC], testing"] -ms.assetid: 626867cf-fe53-4c30-8973-55bb93ef3917 ms.topic: how-to --- # Testing Properties and Events with Test Container diff --git a/docs/porting/porting-guide-spy-increment.md b/docs/porting/porting-guide-spy-increment.md index 48a77c5f6c4..d216108360d 100644 --- a/docs/porting/porting-guide-spy-increment.md +++ b/docs/porting/porting-guide-spy-increment.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: Porting Guide: Spy++" title: "Porting Guide: Spy++" -ms.date: "10/23/2019" -ms.assetid: e558f759-3017-48a7-95a9-b5b779d5e51d +description: "Learn more about: Porting Guide: Spy++" +ms.date: 10/23/2019 ms.topic: concept-article --- # Porting Guide: Spy++ From 2e376136e04abfa3037814ab37cdba253faef89e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 17:29:18 +0800 Subject: [PATCH 0248/1799] Add `cpp` language for code blocks in error or warning references --- .../compiler-errors-2/compiler-error-c2797.md | 8 ++++---- .../compiler-errors-2/compiler-error-c2891.md | 4 ++-- .../compiler-errors-2/compiler-error-c3457.md | 2 +- .../compiler-errors-2/compiler-error-c3554.md | 2 +- .../compiler-errors-2/compiler-error-c3733.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4626.md | 2 +- 6 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md index 7dc731a466a..c56e53966f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md @@ -14,7 +14,7 @@ This warning is obsolete in Visual Studio 2015. In Visual Studio 2013 and earlie This example generates C2797: -``` +```cpp #include struct S { S() : v1{1} {} // C2797, VS2013 RTM incorrectly calls 'vector(size_type)' @@ -26,7 +26,7 @@ struct S { This example also generates C2797: -``` +```cpp struct S1 { int i; }; @@ -40,7 +40,7 @@ struct S2 { To fix this issue, you can use explicit construction of inner lists. For example: -``` +```cpp #include typedef std::vector Vector; struct S { @@ -53,7 +53,7 @@ struct S { If you do not require list initialization: -``` +```cpp struct S { S() : s1("") {} diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md index e092c0a18bf..b474fcd64af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md @@ -12,13 +12,13 @@ ms.assetid: e12cfb2d-df45-4b0d-b155-c51d17e812fa You can't take the address of a template parameter unless it is an lvalue. Type parameters are not lvalues because they have no address. Non-type values in template parameter lists that are not lvalues also do not have an address. This is an example of code that causes Compiler Error C2891, because the value passed as the template parameter is a compiler-generated copy of the template argument. -``` +```cpp template int* f() { return &i; } ``` Template parameters that are lvalues, such as reference types, can have their address taken. -``` +```cpp template int* f() { return &r; } ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md index 151c01319fe..2c5e4f6ea97 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md @@ -16,7 +16,7 @@ Source annotation attributes, unlike CLR custom attribute or compiler attributes The following sample generates C3457. -``` +```cpp #include "SourceAnnotations.h" [vc_attributes::Post( 1 )] int f(); // C3457 [vc_attributes::Post( Valid=vc_attributes::Yes )] int f2(); // OK diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md index bb36c2a954d..1adbd63bb8d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md @@ -12,7 +12,7 @@ ms.assetid: aede18d5-fefc-4da9-9b69-adfe90bfa742 You cannot qualify the `decltype()` keyword with any type specifier. For example, the following code fragment yields error C3554. -``` +```cpp int x; unsigned decltype(x); // C3554 ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md index 7a889e735f7..91c1bbf3d48 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md @@ -14,7 +14,7 @@ The wrong syntax was used for a COM event. To fix this error, change the event t The following sample generates C3733: -``` +```cpp #define _ATL_ATTRIBUTES 1 #include "atlbase.h" #include "atlcom.h" diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md index 289950c660d..d5705238be5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md @@ -16,7 +16,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( The following sample generates C4626 and shows how to fix it: -``` +```cpp // C4626 // compile with: /W4 #pragma warning(default : 4626) From 546fefb927873091579d0ee86eb1c9dc51eab690 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 17:30:31 +0800 Subject: [PATCH 0249/1799] Update metadata in error or warning references --- .../error-messages/compiler-errors-2/compiler-error-c2797.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2891.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3457.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3554.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3733.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4626.md | 5 ++--- 6 files changed, 12 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md index c56e53966f8..9b3f1a04db2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2797" title: "Compiler Error C2797" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2797" +ms.date: 11/04/2016 f1_keywords: ["C2797"] helpviewer_keywords: ["C2797"] -ms.assetid: 9fb26d35-eb5c-46fc-9ff5-756fba5bdaff --- # Compiler Error C2797 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md index b474fcd64af..f9b41d60076 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2891" title: "Compiler Error C2891" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2891" +ms.date: 11/04/2016 f1_keywords: ["C2891"] helpviewer_keywords: ["C2891"] -ms.assetid: e12cfb2d-df45-4b0d-b155-c51d17e812fa --- # Compiler Error C2891 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md index 2c5e4f6ea97..4b97bea6db5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3457" title: "Compiler Error C3457" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3457" +ms.date: 11/04/2016 f1_keywords: ["C3457"] helpviewer_keywords: ["C3457"] -ms.assetid: 5c1e366a-fa75-4cca-b9a3-86d4ebe4090e --- # Compiler Error C3457 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md index 1adbd63bb8d..72f066bf8ed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3554" title: "Compiler Error C3554" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3554" +ms.date: 11/04/2016 f1_keywords: ["C3554"] helpviewer_keywords: ["C3554"] -ms.assetid: aede18d5-fefc-4da9-9b69-adfe90bfa742 --- # Compiler Error C3554 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md index 91c1bbf3d48..b1d20b40c50 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3733" title: "Compiler Error C3733" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3733" +ms.date: 11/04/2016 f1_keywords: ["C3733"] helpviewer_keywords: ["C3733"] -ms.assetid: 0cc1a9fe-1400-4be3-b35a-16435cba7a5a --- # Compiler Error C3733 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md index d5705238be5..277e3e6f834 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4626" title: "Compiler Warning (level 4) C4626" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4626" +ms.date: 11/04/2016 f1_keywords: ["C4626"] helpviewer_keywords: ["C4626"] -ms.assetid: 7f822ff4-a4a3-4f17-b45b-e8b7b4659a14 --- # Compiler Warning (level 4) C4626 From a50f6a66a3d8d613ca969c802a7f653689466310 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 17:49:47 +0800 Subject: [PATCH 0250/1799] Remove extraneous spaces after hyphen character --- docs/build/arm-exception-handling.md | 2 +- .../compiler-errors-2/compiler-error-c2548.md | 4 ++-- docs/sanitizers/asan-shadow-bytes.md | 2 +- docs/standard-library/string-functions.md | 14 +++++++------- docs/standard-library/valarray-class.md | 4 ++-- 5 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/build/arm-exception-handling.md b/docs/build/arm-exception-handling.md index 35435412eeb..fd79f6d7c8e 100644 --- a/docs/build/arm-exception-handling.md +++ b/docs/build/arm-exception-handling.md @@ -167,7 +167,7 @@ When the packed unwind format is insufficient to describe the unwinding of a fun |0|20|*X* is a 1-bit field that indicates the presence (1) or absence (0) of exception data.| |0|21|*`E`* is a 1-bit field that indicates that information that describes a single epilogue is packed into the header (1) rather than requiring additional scope words later (0).| |0|22|*F* is a 1-bit field that indicates that this record describes a function fragment (1) or a full function (0). A fragment implies that there's no prologue and that all prologue processing should be ignored.| - |0|23-27|*Epilogue Count* is a 5-bit field that has two meanings, depending on the state of the *`E`* bit:

- If *`E`* is 0, this field is a count of the total number of epilogue scopes described in section 2. If more than 31 scopes exist in the function, then this field and the *Code Words* field must both be set to 0 to indicate that an extension word is required.
- If *`E`* is 1, this field specifies the index of the first unwind code that describes the only epilogue.| + |0|23-27|*Epilogue Count* is a 5-bit field that has two meanings, depending on the state of the *`E`* bit:

- If *`E`* is 0, this field is a count of the total number of epilogue scopes described in section 2. If more than 31 scopes exist in the function, then this field and the *Code Words* field must both be set to 0 to indicate that an extension word is required.
- If *`E`* is 1, this field specifies the index of the first unwind code that describes the only epilogue.| |0|28-31|*Code Words* is a 4-bit field that specifies the number of 32-bit words required to contain all of the unwind codes in section 4. If more than 15 words are required for more than 63 unwind code bytes, this field and the *Epilogue Count* field must both be set to 0 to indicate that an extension word is required.| |1|0-15|*Extended Epilogue Count* is a 16-bit field that provides more space for encoding an unusually large number of epilogues. The extension word that contains this field is only present if the *Epilogue Count* and *Code Words* fields in the first header word are both set to 0.| |1|16-23|*Extended Code Words* is an 8-bit field that provides more space for encoding an unusually large number of unwind code words. The extension word that contains this field is only present if the *Epilogue Count* and *Code Words* fields in the first header word are both set to 0.| diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md index 6b59cfc2b60..cadccf13e97 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md @@ -21,8 +21,8 @@ The following sample generates C2548 for: The following sample doesn't generate C2548 for: - `func2` because all the required default arguments are supplied. -- The second `func4` declaration because the default argument `c` is supplied in the preceding declaration and is in the same scope. -- The third `func4` declaration because both default arguments `b` and `c` are provided previously. +- The second `func4` declaration because the default argument `c` is supplied in the preceding declaration and is in the same scope. +- The third `func4` declaration because both default arguments `b` and `c` are provided previously. ```cpp // C2548.cpp diff --git a/docs/sanitizers/asan-shadow-bytes.md b/docs/sanitizers/asan-shadow-bytes.md index 9b6b747e249..a4d57f7c9f0 100644 --- a/docs/sanitizers/asan-shadow-bytes.md +++ b/docs/sanitizers/asan-shadow-bytes.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["Shadow bytes", "AddressSanitizer shadow bytes","Address S # AddressSanitizer shadow bytes -We briefly summarize the concept of shadow bytes and how they can be used by the runtime implementation of [`/fsanitize=address`](../build/reference/fsanitize.md). For further details, we refer you to the initial research [AddressSanitizer - Serebryany, et al](https://www.usenix.org/system/files/conference/atc12/atc12-final39.pdf) and the [current AddressSanitizer algorithm documentation](https://github.com/google/sanitizers/wiki/AddressSanitizerAlgorithm). +We briefly summarize the concept of shadow bytes and how they can be used by the runtime implementation of [`/fsanitize=address`](../build/reference/fsanitize.md). For further details, we refer you to the initial research [AddressSanitizer - Serebryany, et al](https://www.usenix.org/system/files/conference/atc12/atc12-final39.pdf) and the [current AddressSanitizer algorithm documentation](https://github.com/google/sanitizers/wiki/AddressSanitizerAlgorithm). ## Core concept diff --git a/docs/standard-library/string-functions.md b/docs/standard-library/string-functions.md index 4639cb1764b..e1f57695e84 100644 --- a/docs/standard-library/string-functions.md +++ b/docs/standard-library/string-functions.md @@ -149,7 +149,7 @@ The **`double`** value. ### Remarks -The function converts the sequence of elements in *`str`* to a value of type **`double`** as if by calling `strtod( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *`str`* to a value of type **`double`** as if by calling `strtod( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stof` @@ -179,7 +179,7 @@ The **`float`** value. ### Remarks -The function converts the sequence of elements in *`str`* to a value of type **`float`** as if by calling `strtof( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *`str`* to a value of type **`float`** as if by calling `strtof( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stoi` @@ -253,7 +253,7 @@ The long-integer value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`long`** as if by calling `strtol( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`long`** as if by calling `strtol( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stold` @@ -283,7 +283,7 @@ The **`long double`** value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`long double`** as if by calling `strtold( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`long double`** as if by calling `strtold( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stoll` @@ -318,7 +318,7 @@ The **`long long`** value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`long long`** as if by calling `strtoll( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *idx* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`long long`** as if by calling `strtoll( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *idx* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stoul` @@ -353,7 +353,7 @@ The unsigned long-integer value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`unsigned long`** as if by calling `strtoul( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *idx* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`unsigned long`** as if by calling `strtoul( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *idx* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stoull` @@ -388,7 +388,7 @@ The **`unsigned long long`** value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`unsigned long long`** as if by calling `strtoull( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`unsigned long long`** as if by calling `strtoull( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `swap` diff --git a/docs/standard-library/valarray-class.md b/docs/standard-library/valarray-class.md index 1cc5c5087a9..da53121f16a 100644 --- a/docs/standard-library/valarray-class.md +++ b/docs/standard-library/valarray-class.md @@ -1143,7 +1143,7 @@ int main( ) for ( i = 0 ; i < 10 ; i += 1 ) va [ i ] = i; for ( i = 0 ; i < 10 ; i+=1 ) - vaR [ i ] = 10 - i; + vaR [ i ] = 10 - i; cout << "The operand valarray va is:"; for ( i = 0 ; i < 10 ; i++ ) @@ -1609,7 +1609,7 @@ int main( ) for ( i = 0 ; i < 10 ; i += 1 ) va1 [ i ] = i; for ( i = 0 ; i < 10 ; i += 1 ) - va2 [ i ] = 10 - i; + va2 [ i ] = 10 - i; cout << "The operand valarray va1(10) is: ( "; for ( i = 0 ; i < 10 ; i++ ) From 127ca8da8361a9a61e78596eee608c2cb82e4bb3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 17:50:44 +0800 Subject: [PATCH 0251/1799] Update metadata in 3 topics --- docs/build/arm-exception-handling.md | 3 +-- docs/error-messages/compiler-errors-2/compiler-error-c2548.md | 4 ++-- docs/standard-library/valarray-class.md | 3 +-- 3 files changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/build/arm-exception-handling.md b/docs/build/arm-exception-handling.md index fd79f6d7c8e..b7cc353313d 100644 --- a/docs/build/arm-exception-handling.md +++ b/docs/build/arm-exception-handling.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: ARM Exception Handling" title: "ARM Exception Handling" +description: "Learn more about: ARM Exception Handling" ms.date: 12/15/2021 -ms.assetid: fe0e615f-c033-4ad5-97f4-ff96af45b201 ms.topic: concept-article --- # ARM Exception Handling diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md index cadccf13e97..975747ca343 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2548" title: "Compiler error C2548" -ms.date: "03/01/2024" +description: "Learn more about: Compiler Error C2548" +ms.date: 03/01/2024 f1_keywords: ["C2548"] helpviewer_keywords: ["C2548"] --- diff --git a/docs/standard-library/valarray-class.md b/docs/standard-library/valarray-class.md index da53121f16a..e51df410949 100644 --- a/docs/standard-library/valarray-class.md +++ b/docs/standard-library/valarray-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: valarray Class" title: "valarray class" +description: "Learn more about: valarray Class" ms.date: 06/20/2022 f1_keywords: ["valarray/std::valarray", "valarray/std::valarray::value_type", "valarray/std::valarray::apply", "valarray/std::valarray::cshift", "valarray/std::valarray::free", "valarray/std::valarray::max", "valarray/std::valarray::min", "valarray/std::valarray::resize", "valarray/std::valarray::shift", "valarray/std::valarray::size", "valarray/std::valarray::sum", "valarray/std::valarray::swap"] helpviewer_keywords: ["std::valarray [C++]", "std::valarray [C++], value_type", "std::valarray [C++], apply", "std::valarray [C++], cshift", "std::valarray [C++], free", "std::valarray [C++], max", "std::valarray [C++], min", "std::valarray [C++], resize", "std::valarray [C++], shift", "std::valarray [C++], size", "std::valarray [C++], sum", "std::valarray [C++], swap"] -ms.assetid: 19b862f9-5d09-4003-8844-6ddd02c1a3a7 ms.custom: devdivchpfy22 --- From 07b21dd0bf843eb82a1e0dbee7f7d78a59922319 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 18:40:30 +0800 Subject: [PATCH 0252/1799] Add missing empty line between reference parameters --- .../reference/application-information-and-management.md | 1 + docs/mfc/reference/delegate-and-interface-maps.md | 2 ++ docs/mfc/reference/icommandsource-interface.md | 8 ++++++++ .../concurrency-precise-math-namespace-functions.md | 6 ++++++ docs/parallel/amp/reference/extent-class.md | 2 ++ 5 files changed, 19 insertions(+) diff --git a/docs/mfc/reference/application-information-and-management.md b/docs/mfc/reference/application-information-and-management.md index cffc7c4c52f..def289f23d2 100644 --- a/docs/mfc/reference/application-information-and-management.md +++ b/docs/mfc/reference/application-information-and-management.md @@ -173,6 +173,7 @@ HINSTANCE AFXAPI AfxFindResourceHandle( LPCTSTR lpszName, LPCTSTR lpszType ); *`lpszName`*\ A pointer to a string containing the resource ID. + *`lpszType`*\ A pointer to the type of resource. For a list of resource types, see [`FindResource`](/windows/win32/api/winbase/nf-winbase-findresourcea) in the Windows SDK. diff --git a/docs/mfc/reference/delegate-and-interface-maps.md b/docs/mfc/reference/delegate-and-interface-maps.md index f190e37f4ee..657b4b63774 100644 --- a/docs/mfc/reference/delegate-and-interface-maps.md +++ b/docs/mfc/reference/delegate-and-interface-maps.md @@ -215,8 +215,10 @@ INTERFACE_PART( theClass, iid, localClass) *theClass*
The name of the class that contains the interface map. + *iid*
The IID that is to be mapped to the embedded class. + *localClass*
The name of the local class. diff --git a/docs/mfc/reference/icommandsource-interface.md b/docs/mfc/reference/icommandsource-interface.md index b75c703c395..ea608f2fbf7 100644 --- a/docs/mfc/reference/icommandsource-interface.md +++ b/docs/mfc/reference/icommandsource-interface.md @@ -59,6 +59,7 @@ void AddCommandHandler( *cmdID*
The command ID. + *cmdHandler*
A handle to the command handler method. @@ -82,8 +83,10 @@ void AddCommandRangeHandler( *cmdIDMin*
The beginning index of the command ID range. + *cmdIDMax*
The ending index of the command ID range. + *cmdHandler*
A handle to the message handler method to which the commands are mapped. @@ -106,8 +109,10 @@ void AddCommandRangeUIHandler( *cmdIDMin*
The beginning index of the command ID range. + *cmdIDMax*
The ending index of the command ID range. + *cmdHandler*
A handle to the message handler method to which the commands are mapped. @@ -129,6 +134,7 @@ void AddCommandUIHandler( *cmdID*
The command ID. + *cmdUIHandler*
A handle to the user interface command message handler method. @@ -184,6 +190,7 @@ void RemoveCommandRangeUIHandler( *cmdIDMin*
The beginning index of the command ID range. + *cmdIDMax*
The ending index of the command ID range. @@ -205,6 +212,7 @@ void RemoveCommandRangeUIHandler( *cmdIDMin*
The beginning index of the command ID range. + *cmdIDMax*
The ending index of the command ID range. diff --git a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md index a7908a8b415..e8c1462c2ca 100644 --- a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md @@ -983,6 +983,7 @@ inline double fdim( *_X*
Floating-point value + *_Y*
Floating-point value @@ -1005,6 +1006,7 @@ inline float fdimf( *_X*
Floating-point value + *_Y*
Floating-point value @@ -1070,8 +1072,10 @@ inline double fma( *_X*
The first floating-point argument. + *_Y*
The second floating-point argument. + *_Z*
The third floating-point argument. @@ -1095,8 +1099,10 @@ inline float fmaf( *_X*
The first floating-point argument. + *_Y*
The second floating-point argument. + *_Z*
The third floating-point argument. diff --git a/docs/parallel/amp/reference/extent-class.md b/docs/parallel/amp/reference/extent-class.md index d14304486f9..01236c68f26 100644 --- a/docs/parallel/amp/reference/extent-class.md +++ b/docs/parallel/amp/reference/extent-class.md @@ -375,8 +375,10 @@ tiled_extent<_Dim0, _Dim1, _Dim2> tile() const ; *_Dim0*
The most significant component of the tiled extent. + *_Dim1*
The next-to-most-significant component of the tiled extent. + *_Dim2*
The least significant component of the tiled extent. From 27a55cb8502bf9733e409e7a50f703d733a607de Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 2 Jul 2025 18:41:53 +0800 Subject: [PATCH 0253/1799] Update metadata in 5 topics --- docs/mfc/reference/application-information-and-management.md | 3 +-- docs/mfc/reference/delegate-and-interface-maps.md | 5 ++--- docs/mfc/reference/icommandsource-interface.md | 5 ++--- .../concurrency-precise-math-namespace-functions.md | 2 +- docs/parallel/amp/reference/extent-class.md | 5 ++--- 5 files changed, 8 insertions(+), 12 deletions(-) diff --git a/docs/mfc/reference/application-information-and-management.md b/docs/mfc/reference/application-information-and-management.md index def289f23d2..444361085bc 100644 --- a/docs/mfc/reference/application-information-and-management.md +++ b/docs/mfc/reference/application-information-and-management.md @@ -1,9 +1,8 @@ --- title: "Application Information and Management" description: "Reference to the Microsoft Foundation Class library (MFC) application information and management functions." -ms.date: "01/27/2020" +ms.date: 01/27/2020 helpviewer_keywords: ["applications [MFC], managing"] -ms.assetid: b72f4154-24db-4e75-bca3-6873e2459c15 --- # Application Information and Management diff --git a/docs/mfc/reference/delegate-and-interface-maps.md b/docs/mfc/reference/delegate-and-interface-maps.md index 657b4b63774..518e659915c 100644 --- a/docs/mfc/reference/delegate-and-interface-maps.md +++ b/docs/mfc/reference/delegate-and-interface-maps.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Delegate and interface map macros" title: "Delegate and Interface Map Macros (MFC)" -ms.date: "03/30/2017" +description: "Learn more about: Delegate and interface map macros" +ms.date: 03/30/2017 helpviewer_keywords: ["delegate map macros [MFC]", "event map macros [MFC]", "interface map macros [MFC]"] -ms.assetid: 3840e642-ff7d-4bdc-998b-c7d8fc50890e --- # Delegate and interface map macros diff --git a/docs/mfc/reference/icommandsource-interface.md b/docs/mfc/reference/icommandsource-interface.md index ea608f2fbf7..80fd3391887 100644 --- a/docs/mfc/reference/icommandsource-interface.md +++ b/docs/mfc/reference/icommandsource-interface.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ICommandSource Interface" title: "ICommandSource Interface" -ms.date: "03/27/2019" +description: "Learn more about: ICommandSource Interface" +ms.date: 03/27/2019 f1_keywords: ["ICommandSource", "AFXWINFORMS/ICommandSource", "AFXWINFORMS/ICommandSource::AddCommandHandler", "AFXWINFORMS/ICommandSource::AddCommandRangeHandler", "AFXWINFORMS/ICommandSource::AddCommandRangeUIHandler", "AFXWINFORMS/ICommandSource::AddCommandUIHandler", "AFXWINFORMS/ICommandSource::PostCommand", "AFXWINFORMS/ICommandSource::RemoveCommandHandler", "AFXWINFORMS/ICommandSource::RemoveCommandRangeHandler", "AFXWINFORMS/ICommandSource::RemoveCommandRangeUIHandler", "AFXWINFORMS/ICommandSource::RemoveCommandUIHandler", "AFXWINFORMS/ICommandSource::SendCommand"] helpviewer_keywords: ["ICommandSource interface [MFC]"] -ms.assetid: a4b1f698-c09f-4ba8-9b13-0e74a0a4967e --- # ICommandSource Interface diff --git a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md index e8c1462c2ca..fba9b56557b 100644 --- a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md @@ -1,7 +1,7 @@ --- title: "Concurrency::precise_math namespace functions" description: "Learn more about: Concurrency::precise_math namespace functions" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["amp_math/Concurrency::precise_math::acos", "amp_math/Concurrency::precise_math::acosh", "amp_math/Concurrency::precise_math::acoshf", "amp_math/Concurrency::precise_math::asinf", "amp_math/Concurrency::precise_math::asinh", "amp_math/Concurrency::precise_math::atan", "amp_math/Concurrency::precise_math::atan2", "amp_math/Concurrency::precise_math::atanf", "amp_math/Concurrency::precise_math::atanh", "amp_math/Concurrency::precise_math::cbrt", "amp_math/Concurrency::precise_math::cbrtf", "amp_math/Concurrency::precise_math::ceilf", "amp_math/Concurrency::precise_math::copysign", "amp_math/Concurrency::precise_math::cos", "amp_math/Concurrency::precise_math::cosf", "amp_math/Concurrency::precise_math::coshf", "amp_math/Concurrency::precise_math::cospi", "amp_math/Concurrency::precise_math::erf", "amp_math/Concurrency::precise_math::erfc", "amp_math/Concurrency::precise_math::erfcinv", "amp_math/Concurrency::precise_math::erfcinvf", "amp_math/Concurrency::precise_math::erfinv", "amp_math/Concurrency::precise_math::erfinvf", "amp_math/Concurrency::precise_math::exp10", "amp_math/Concurrency::precise_math::exp10f", "amp_math/Concurrency::precise_math::exp2f", "amp_math/Concurrency::precise_math::expf", "amp_math/Concurrency::precise_math::expm1f", "amp_math/Concurrency::precise_math::fabs", "amp_math/Concurrency::precise_math::floor", "amp_math/Concurrency::precise_math::fdim", "amp_math/Concurrency::precise_math::floorf", "amp_math/Concurrency::precise_math::fmaf", "amp_math/Concurrency::precise_math::fmaxf", "amp_math/Concurrency::precise_math::fmin", "amp_math/Concurrency::precise_math::fmod", "amp_math/Concurrency::precise_math::fmodf", "amp_math/Concurrency::precise_math::frexp", "amp_math/Concurrency::precise_math::frexpf", "amp_math/Concurrency::precise_math::hypotf", "amp_math/Concurrency::precise_math::ilogb", "amp_math/Concurrency::precise_math::isfinite", "amp_math/Concurrency::precise_math::isinf", "amp_math/Concurrency::precise_math::isnormal", "amp_math/Concurrency::precise_math::ldexp", "amp_math/Concurrency::precise_math::lgamma", "amp_math/Concurrency::precise_math::lgammaf", "amp_math/Concurrency::precise_math::log10", "amp_math/Concurrency::precise_math::log10f", "amp_math/Concurrency::precise_math::log1pf", "amp_math/Concurrency::precise_math::log2", "amp_math/Concurrency::precise_math::logb", "amp_math/Concurrency::precise_math::logbf", "amp_math/Concurrency::precise_math::modf", "amp_math/Concurrency::precise_math::modff", "amp_math/Concurrency::precise_math::nanf", "amp_math/Concurrency::precise_math::nearbyint", "amp_math/Concurrency::precise_math::nextafter", "amp_math/Concurrency::precise_math::nextafterf", "amp_math/Concurrency::precise_math::phif", "amp_math/Concurrency::precise_math::pow", "amp_math/Concurrency::precise_math::probit", "amp_math/Concurrency::precise_math::probitf", "amp_math/Concurrency::precise_math::rcbrtf", "amp_math/Concurrency::precise_math::remainder", "amp_math/Concurrency::precise_math::remquo", "amp_math/Concurrency::precise_math::remquof", "amp_math/Concurrency::precise_math::roundf", "amp_math/Concurrency::precise_math::rsqrt", "amp_math/Concurrency::precise_math::scalb", "amp_math/Concurrency::precise_math::scalbf", "amp_math/Concurrency::precise_math::scalbnf", "amp_math/Concurrency::precise_math::signbit", "amp_math/Concurrency::precise_math::sin", "amp_math/Concurrency::precise_math::sincos", "amp_math/Concurrency::precise_math::sinf", "amp_math/Concurrency::precise_math::sinh", "amp_math/Concurrency::precise_math::sinpi", "amp_math/Concurrency::precise_math::sinpif", "amp_math/Concurrency::precise_math::sqrtf", "amp_math/Concurrency::precise_math::tan", "amp_math/Concurrency::precise_math::tanh", "amp_math/Concurrency::precise_math::tanhf", "amp_math/Concurrency::precise_math::tanpif", "amp_math/Concurrency::precise_math::tgamma", "amp_math/Concurrency::precise_math::trunc", "amp_math/Concurrency::precise_math::truncf"] --- # Concurrency::precise_math namespace functions diff --git a/docs/parallel/amp/reference/extent-class.md b/docs/parallel/amp/reference/extent-class.md index 01236c68f26..f547bd38c0f 100644 --- a/docs/parallel/amp/reference/extent-class.md +++ b/docs/parallel/amp/reference/extent-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: extent Class (C++ AMP)" title: "extent Class (C++ AMP)" -ms.date: "03/27/2019" +description: "Learn more about: extent Class (C++ AMP)" +ms.date: 03/27/2019 f1_keywords: ["extent", "AMP/extent", "AMP/Concurrency::extent::extent", "AMP/Concurrency::extent::contains", "AMP/Concurrency::extent::size", "AMP/Concurrency::extent::tile", "AMP/Concurrency::extent::rank Constant"] helpviewer_keywords: ["extent structure"] -ms.assetid: edb5de3d-3935-4dbb-8365-4cc6c4fb0269 --- # extent Class (C++ AMP) From df4f3d69aaf5ac4cff3526a78ef755aa535a5b47 Mon Sep 17 00:00:00 2001 From: David Justo Date: Wed, 2 Jul 2025 10:42:12 -0700 Subject: [PATCH 0254/1799] fix easy acrolynx issues --- docs/sanitizers/asan-known-issues.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index f47d2277e7f..d2ee8c74fd6 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -29,7 +29,7 @@ The following options and functionality are incompatible with [`/fsanitize=addre The MSVC standard library (STL) makes partial use of the AddressSanitizer and provides other code safety checks. For more information, see [container-overflow error](./error-container-overflow.md). -When annotations are disabled, or in versions of the Standard Library that don't support them, AddressSanitizer exceptions raised in STL code still identify real bugs. However, they are more precise if annotations are enabled and you use a version of the Standard Library that supports them. +When annotations are disabled, or in versions of the Standard Library that don't support them, AddressSanitizer exceptions raised in STL code still identify real bugs. However, they're more precise if annotations are enabled and you use a version of the Standard Library that supports them. This example demonstrates the lack of precision and the benefits of enabling annotations: @@ -57,7 +57,7 @@ int main() { ## Overriding operator new and delete -AddressSanitizer (ASAN) uses a custom version of `operator new` and `operator delete` to find allocation errors like [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md). Running the linker with [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) ensures that ASAN's `new`/`delete` override has low precedence, so that the linker chooses any `operator new` or `operator delete` overrides in other libraries over ASAN's custom versions. When this happens, ASAN may not be able to catch some errors that rely on its custom `operator new` and `operator delete`. +AddressSanitizer (ASan) uses a custom version of `operator new` and `operator delete` to find allocation errors like [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md). Running the linker with [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) ensures that ASan's `new`/`delete` override has low precedence, so that the linker chooses any `operator new` or `operator delete` overrides in other libraries over ASan's custom versions. When this happens, ASan may not be able to catch some errors that rely on its custom `operator new` and `operator delete`. [MFC](../mfc/mfc-concepts.md) includes custom overrides for `operator new` and `operator delete` and might miss errors like [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md). @@ -82,9 +82,9 @@ Thread local variables (global variables declared with `__declspec(thread)` or ` ## Issues with partially sanitized executables -If all of the code in a process isn't compiled with `/fsanitize=address`, ASan may not be able to diagnose all memory safety errors. The most common example is when a DLL is compiled with ASan but is loaded into a process that contains code that wasn't compiled with ASan. In this case, ASan attempts to categorize allocations that took place prior to ASan initialization. Once those allocations are reallocated, ASan tries to own and monitor the lifetime of the memory. +If all of the code in a process isn't compiled with `/fsanitize=address`, ASan may not be able to diagnose all memory safety errors. The most common example is when a DLL compiles with ASan but is loaded into a process that contains code that wasn't compiled with ASan. In this case, ASan attempts to categorize allocations that took place before ASan initialization. Once those allocations are reallocated, ASan tries to own and monitor the lifetime of the memory. -If all of the DLLs that were compiled with ASan are unloaded from the process before the process ends, there may be crashes due to dangling references to intercepted functions such as `memcmp`, `memcpy`, `memmove`, and so on. For the best results, compile all modules under test with `/fsanitize=address`, or do not unload modules compiled with ASan after they enter the process. +If all of the DLLs compiled with ASan are unloaded from the process before the process ends, there may be crashes due to dangling references to intercepted functions such as `memcmp`, `memcpy`, `memmove`, and so on. For the best results, compile all modules under test with `/fsanitize=address`, or don't unload modules compiled with ASan after they enter the process. Please report any bugs to our [Developer Community](https://aka.ms/feedback/report?space=62). From ed2d4ed450d950641f36712dea1c24b797ba7fc4 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 2 Jul 2025 15:40:51 -0700 Subject: [PATCH 0255/1799] new article --- .../compiler-errors-2/compiler-error-c7742.md | 42 +++++++++++++++++++ .../compiler-errors-c7500-through-c7999.md | 5 ++- docs/error-messages/toc.yml | 2 + 3 files changed, 47 insertions(+), 2 deletions(-) create mode 100644 docs/error-messages/compiler-errors-2/compiler-error-c7742.md diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7742.md b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md new file mode 100644 index 00000000000..cc532a82113 --- /dev/null +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md @@ -0,0 +1,42 @@ +--- +description: "Learn more about: Compiler Error C7742" +title: "Compiler Error C7742" +ms.date: "07/02/2025" +f1_keywords: ["C7742"] +helpviewer_keywords: ["C7742"] +--- +# Compiler Error C7742 + +*identifier*': a forward declaration of an enum can only use a simple identifier + +The C++ Standard doesn't allow declaring an opaque enumeration using a qualified-id. An opaque enum declaration specifies the name and the underlying type, but doesn't list the enumerators or their values. + +The following example generates C7742: + +```cpp +// C7742.cpp +class MyClass +{ +public: + enum MyEnum + { + e1, + e2 + }; +}; + +enum MyClass::MyEnum; // C7742 +``` + +To fix this, remove the opaque enumeration declaration because it doesn't add anything to the program. + +However, you can define an enumeration with a qualified-id. For example: + +```cpp +struct S +{ + enum E : int; +}; + +enum S::E : int { e1, e2, e3 }; +``` diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md index 0ed99e5e5ff..79c0bcce841 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md @@ -2,8 +2,8 @@ description: "Learn more about: Compiler errors C7500 through C7999" title: "Compiler errors C7500 through C7999" ms.date: 10/13/2023 -f1_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704"] -helpviewer_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704"] +f1_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704", "C7742"] +helpviewer_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704", "C7742"] --- # Compiler errors C7500 through C7999 @@ -240,6 +240,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C7739 | cannot jump from this `goto` statement to its label | | Compiler error C7740 | cannot jump to case label | | Compiler error C7741 | ABI inconsistency: '*function*' was originally assumed to use '`C`' return semantics but now it requires '`C++`' return semantics | +| [Compiler error C7742](compiler-error-c7742.md) | '*identifier*': a forward declaration of an enum can only use a simple identifier | | Compiler error C7800 | duplicate explicit instantiation definition of '*name*' | | Compiler error C7801 | '*function*': if one declaration of '*identifier*' has the '`[[msvc::disptach]]`' attribute then all functions must have the attribute | | Compiler error C7802 | '*identifier*': a capability must resolve to an enumerator | diff --git a/docs/error-messages/toc.yml b/docs/error-messages/toc.yml index 8109e4d3134..ed8722eb608 100644 --- a/docs/error-messages/toc.yml +++ b/docs/error-messages/toc.yml @@ -3169,6 +3169,8 @@ items: href: compiler-warnings/c5208.md - name: Compiler error C7688 href: compiler-errors-2/compiler-error-c7688.md + - name: Compiler error C7742 + href: compiler-errors-2/compiler-error-c7742.md - name: Compiler warnings C4000 through C5999 expanded: false items: From 804e4e0f3e504957b670ec41b65394370636abae Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 2 Jul 2025 16:16:14 -0700 Subject: [PATCH 0256/1799] fix keywords --- .../compiler-errors-2/compiler-errors-c7500-through-c7999.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md index 79c0bcce841..984ce5a3d8f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md @@ -2,8 +2,8 @@ description: "Learn more about: Compiler errors C7500 through C7999" title: "Compiler errors C7500 through C7999" ms.date: 10/13/2023 -f1_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704", "C7742"] -helpviewer_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704", "C7742"] +f1_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704"] +helpviewer_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704"] --- # Compiler errors C7500 through C7999 From fc7b294b01f1f97d2052e9ddc304f97804261eb7 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 2 Jul 2025 16:28:44 -0700 Subject: [PATCH 0257/1799] formatting --- .../compiler-errors-1/compiler-error-c2462.md | 6 +++--- .../compiler-errors-2/compiler-error-c7742.md | 5 +++-- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md index b374ec31368..9a8d3f18674 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md @@ -4,11 +4,10 @@ title: "Compiler Error C2462" ms.date: "11/04/2016" f1_keywords: ["C2462"] helpviewer_keywords: ["C2462"] -ms.assetid: a8601bf8-f5ce-41de-9117-e2632bd4996b --- # Compiler Error C2462 -'identifier' : cannot define a type in a 'new-expression' +> 'identifier' : cannot define a type in a 'new-expression' You cannot define a type in the operand field of the **`new`** operator. Put the type definition in a separate statement. @@ -16,7 +15,8 @@ The following sample generates C2462: ```cpp // C2462.cpp -int main() { +int main() +{ new struct S { int i; }; // C2462 } ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7742.md b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md index cc532a82113..32847771dd2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7742.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md @@ -2,12 +2,13 @@ description: "Learn more about: Compiler Error C7742" title: "Compiler Error C7742" ms.date: "07/02/2025" +ai-usage: ai-assisted f1_keywords: ["C7742"] helpviewer_keywords: ["C7742"] --- # Compiler Error C7742 -*identifier*': a forward declaration of an enum can only use a simple identifier +> *Identifier*: a forward declaration of an enum can only use a simple identifier The C++ Standard doesn't allow declaring an opaque enumeration using a qualified-id. An opaque enum declaration specifies the name and the underlying type, but doesn't list the enumerators or their values. @@ -28,7 +29,7 @@ public: enum MyClass::MyEnum; // C7742 ``` -To fix this, remove the opaque enumeration declaration because it doesn't add anything to the program. +To fix this error, remove the opaque enumeration declaration because it doesn't add anything to the program. However, you can define an enumeration with a qualified-id. For example: From c6bb6a28050f41d548bf8dbcafb651464a40bfdb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 3 Jul 2025 18:43:16 +0800 Subject: [PATCH 0258/1799] Clean up empty "Remarks" headings in standard library --- docs/standard-library/allocators-functions.md | 6 ----- docs/standard-library/basic-string-class.md | 6 ----- .../standard-library/basic-stringbuf-class.md | 4 ---- .../standard-library/cache-chunklist-class.md | 6 ----- docs/standard-library/cache-freelist-class.md | 6 ----- docs/standard-library/cache-suballoc-class.md | 6 ----- docs/standard-library/error-category-class.md | 4 ---- docs/standard-library/error-code-class.md | 2 -- .../standard-library/error-condition-class.md | 4 ---- docs/standard-library/forward-list-class.md | 12 ---------- docs/standard-library/freelist-class.md | 2 -- docs/standard-library/hash-map-class.md | 20 ----------------- docs/standard-library/hash-multimap-class.md | 20 ----------------- docs/standard-library/hash-multiset-class.md | 20 ----------------- docs/standard-library/hash-set-class.md | 22 ------------------- docs/standard-library/hash-set.md | 2 -- docs/standard-library/iterator-concepts.md | 2 -- docs/standard-library/memory-functions.md | 2 -- docs/standard-library/sync-none-class.md | 2 -- .../sync-per-container-class.md | 2 -- .../standard-library/sync-per-thread-class.md | 2 -- docs/standard-library/sync-shared-class.md | 2 -- docs/standard-library/system-error-enums.md | 2 -- .../standard-library/wstring-convert-class.md | 2 -- 24 files changed, 158 deletions(-) diff --git a/docs/standard-library/allocators-functions.md b/docs/standard-library/allocators-functions.md index adcaabbd4e9..66a22b8865a 100644 --- a/docs/standard-library/allocators-functions.md +++ b/docs/standard-library/allocators-functions.md @@ -72,8 +72,6 @@ Yields `stdext::allocators::cache_chunklist`. #define CACHE_CHUNKLIST ``` -### Remarks - ## CACHE_FREELIST Yields `stdext::allocators::cache_freelist`. @@ -82,8 +80,6 @@ Yields `stdext::allocators::cache_freelist`. #define CACHE_FREELIST(max) ``` -### Remarks - ## CACHE_SUBALLOC Yields `stdext::allocators::cache_suballoc`. @@ -92,8 +88,6 @@ Yields `stdext::allocators::cache_suballoc`. #define CACHE_SUBALLOC ``` -### Remarks - ## SYNC_DEFAULT Yields a synchronization filter. diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 554d5ba8d81..bb7dcf00f54 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -569,8 +569,6 @@ reference back(); A reference to the last element of the string, which must be non-empty. -### Remarks - ## `basic_string::basic_string` Constructs a string that is empty, initialized by specific characters, or is a copy of all or part of another string object or C style (null-terminated) string. @@ -1473,8 +1471,6 @@ const_reverse_iterator crend() const; A `const` reverse iterator that addresses the location succeeding the last element in a reversed string (the location that had preceded the first element in the unreversed string). -### Remarks - ## `basic_string::_Copy_s` Copies at most a specified number of characters from an indexed position in a source string to a target character array. @@ -2885,8 +2881,6 @@ reference front(); A reference to the first element of the string, which must be non-empty. -### Remarks - ## `basic_string::get_allocator` Returns a copy of the allocator object used to construct the string. diff --git a/docs/standard-library/basic-stringbuf-class.md b/docs/standard-library/basic-stringbuf-class.md index 465e997c4f4..af80720aa38 100644 --- a/docs/standard-library/basic-stringbuf-class.md +++ b/docs/standard-library/basic-stringbuf-class.md @@ -365,8 +365,6 @@ void basic_stringbuf::swap(basic_stringbuf& other) *other*\ The basic_stringbuf whose contents will be swapped with this basic_stringbuf. -### Remarks - ## basic_stringbuf::operator= Assigns the contents of the basic_stringbuf on the right side of the operator to the basic_stringbuf on the left side. @@ -380,8 +378,6 @@ basic_stringbuf& basic_stringbuf:: operator=(const basic_stringbuf& other) *other*\ A basic_stringbuf whose contents, including locale traits, will be assigned to the stringbuf on the left side of the operator. -### Remarks - ## See also [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)\ diff --git a/docs/standard-library/cache-chunklist-class.md b/docs/standard-library/cache-chunklist-class.md index 914921951d3..75cd8a859f4 100644 --- a/docs/standard-library/cache-chunklist-class.md +++ b/docs/standard-library/cache-chunklist-class.md @@ -64,8 +64,6 @@ The number of elements in the array to be allocated. A pointer to the allocated object. -### Remarks - ## cache_chunklist::cache_chunklist Constructs an object of type `cache_chunklist`. @@ -74,8 +72,6 @@ Constructs an object of type `cache_chunklist`. cache_chunklist(); ``` -### Remarks - ## cache_chunklist::deallocate Frees a specified number of objects from storage beginning at a specified position. @@ -92,8 +88,6 @@ A pointer to the first object to be deallocated from storage. *count*\ The number of objects to be deallocated from storage. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/cache-freelist-class.md b/docs/standard-library/cache-freelist-class.md index 1df5612d0d3..b529fb52a9d 100644 --- a/docs/standard-library/cache-freelist-class.md +++ b/docs/standard-library/cache-freelist-class.md @@ -67,8 +67,6 @@ The number of elements in the array to be allocated. A pointer to the allocated object. -### Remarks - ## cache_freelist::cache_freelist Constructs an object of type `cache_freelist`. @@ -77,8 +75,6 @@ Constructs an object of type `cache_freelist`. cache_freelist(); ``` -### Remarks - ## cache_freelist::deallocate Frees a specified number of objects from storage beginning at a specified position. @@ -95,8 +91,6 @@ A pointer to the first object to be deallocated from storage. *count*\ The number of objects to be deallocated from storage. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/cache-suballoc-class.md b/docs/standard-library/cache-suballoc-class.md index 26c070fcad5..3735f4a9e07 100644 --- a/docs/standard-library/cache-suballoc-class.md +++ b/docs/standard-library/cache-suballoc-class.md @@ -64,8 +64,6 @@ The number of elements in the array to be allocated. A pointer to the allocated object. -### Remarks - ## cache_suballoc::cache_suballoc Constructs an object of type `cache_suballoc`. @@ -74,8 +72,6 @@ Constructs an object of type `cache_suballoc`. cache_suballoc(); ``` -### Remarks - ## cache_suballoc::deallocate Frees a specified number of objects from storage beginning at a specified position. @@ -92,8 +88,6 @@ A pointer to the first object to be deallocated from storage. *count*\ The number of objects to be deallocated from storage. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/error-category-class.md b/docs/standard-library/error-category-class.md index 953f7753f93..0d393be6435 100644 --- a/docs/standard-library/error-category-class.md +++ b/docs/standard-library/error-category-class.md @@ -71,8 +71,6 @@ The error code value to store in the [error_condition](../standard-library/error Returns `error_condition(_Errval, *this)`. -### Remarks - ### equivalent Returns a value that specifies whether error objects are equivalent. @@ -129,8 +127,6 @@ The error code value to describe. Returns a descriptive name of the error code *val* for the category. If the error code is unrecognized, returns `"unknown error"`. -#### Remarks - ### name Returns the name of the category. diff --git a/docs/standard-library/error-code-class.md b/docs/standard-library/error-code-class.md index 9026b35dca2..f6029aef13f 100644 --- a/docs/standard-library/error-code-class.md +++ b/docs/standard-library/error-code-class.md @@ -82,8 +82,6 @@ Returns the error category. const error_category& category() const; ``` -#### Remarks - ### clear Clears the error code value and category. diff --git a/docs/standard-library/error-condition-class.md b/docs/standard-library/error-condition-class.md index 41b06861bb5..ffa0030a441 100644 --- a/docs/standard-library/error-condition-class.md +++ b/docs/standard-library/error-condition-class.md @@ -84,8 +84,6 @@ const error_category& category() const; A reference to the stored error category -#### Remarks - ### clear Clears the error code value and category. @@ -264,8 +262,6 @@ value_type value() const; The stored error code value of type [value_type](#value_type). -#### Remarks - ### value_type A type that represents the stored error code value. diff --git a/docs/standard-library/forward-list-class.md b/docs/standard-library/forward-list-class.md index 5e8e0a35bd5..65e5db60422 100644 --- a/docs/standard-library/forward-list-class.md +++ b/docs/standard-library/forward-list-class.md @@ -168,8 +168,6 @@ iterator before_begin(); A forward iterator that points just before the first element of the sequence (or just before the end of an empty sequence). -### Remarks - ## `begin` Returns an iterator addressing the first element in a forward list. @@ -183,8 +181,6 @@ iterator begin(); A forward iterator that points at the first element of the sequence (or just beyond the end of an empty sequence). -### Remarks - ## `cbefore_begin` Returns a const iterator addressing the position before the first element in a forward list. @@ -197,8 +193,6 @@ const_iterator cbefore_begin() const; A forward iterator that points just before the first element of the sequence (or just before the end of an empty sequence). -### Remarks - ## `cbegin` Returns a **`const`** iterator that addresses the first element in the range. @@ -285,8 +279,6 @@ typedef typename Allocator::const_pointer const_pointer; ``` -### Remarks - ## `const_reference` A type that provides a constant reference to an element in the forward list. @@ -295,8 +287,6 @@ A type that provides a constant reference to an element in the forward list. typedef typename Allocator::const_reference const_reference; ``` -### Remarks - ## `difference_type` A signed integer type that can be used to represent the number of elements of a forward list in a range between elements pointed to by iterators. @@ -577,8 +567,6 @@ size_type max_size() const; The length of the longest sequence that the object can control. -### Remarks - ## `merge` Combines two sorted sequences into a single sorted sequence in linear time. Removes the elements from the argument list, and inserts them into this `forward_list`. The two lists should be sorted by the same compare function object before the call to `merge`. The combined list will be sorted by that compare function object. diff --git a/docs/standard-library/freelist-class.md b/docs/standard-library/freelist-class.md index 743dececd8a..93fe79b0b5b 100644 --- a/docs/standard-library/freelist-class.md +++ b/docs/standard-library/freelist-class.md @@ -56,8 +56,6 @@ Constructs an object of type `freelist`. freelist(); ``` -### Remarks - ## freelist::pop Removes the first memory block from the free list. diff --git a/docs/standard-library/hash-map-class.md b/docs/standard-library/hash-map-class.md index 61f681bca07..e7f121e5543 100644 --- a/docs/standard-library/hash-map-class.md +++ b/docs/standard-library/hash-map-class.md @@ -371,8 +371,6 @@ Erases all the elements of a `hash_map`. void clear(); ``` -### Remarks - ### Example The following example demonstrates the use of the `hash_map::clear` member function. @@ -463,8 +461,6 @@ A type that provides a reference to a **`const`** element stored in a `hash_map` typedef list::const_reference const_reference; ``` -### Remarks - ### Example ```cpp @@ -917,8 +913,6 @@ bool empty() const; **`true`** if the `hash_map` is empty; **`false`** if the `hash_map` is nonempty. -### Remarks - ### Example ```cpp @@ -1048,8 +1042,6 @@ A pair of iterators such that the first is the [`lower_bound`](#lower_bound) of To access the first iterator of a pair `pr` returned by the member function, use `pr.first` and to dereference the lower bound iterator, use `*(pr.first)`. To access the second iterator of a pair `pr` returned by the member function, use `pr.second` and to dereference the upper bound iterator, use `*(pr.second)`. -### Remarks - ### Example ```cpp @@ -1815,8 +1807,6 @@ An [`iterator`](#iterator) or [`const_iterator`](#const_iterator) that addresses If the return value of `lower_bound` is assigned to a `const_iterator`, the `hash_map` object can't be modified. If the return value of `lower_bound` is assigned to a `iterator`, the `hash_map` object can be modified. -### Remarks - ### Example ```cpp @@ -1904,8 +1894,6 @@ size_type max_size() const; The maximum possible length of the `hash_map`. -### Remarks - ### Example ```cpp @@ -2196,8 +2184,6 @@ A type that provides a reference to an element stored in a `hash_map`. typedef list::reference reference; ``` -### Remarks - ### Example ```cpp @@ -2378,8 +2364,6 @@ size_type size() const; The current length of the `hash_map`. -### Remarks - ### Example The following example demonstrates the use of the `hash_map::size` member function. @@ -2424,8 +2408,6 @@ An unsigned integer type that can represent the number of elements in a `hash_ma typedef list::size_type size_type; ``` -### Remarks - ### Example See example for [`size`](#size) for an example of how to declare and use `size_type` @@ -2528,8 +2510,6 @@ An [`iterator`](#iterator) or [`const_iterator`](#const_iterator) that addresses If the return value is assigned to a `const_iterator`, the `hash_map` object can't be modified. If the return value is assigned to an `iterator`, the `hash_map` object can be modified. -### Remarks - ### Example ```cpp diff --git a/docs/standard-library/hash-multimap-class.md b/docs/standard-library/hash-multimap-class.md index 3884eb36cfb..eaa3fad497d 100644 --- a/docs/standard-library/hash-multimap-class.md +++ b/docs/standard-library/hash-multimap-class.md @@ -326,8 +326,6 @@ Erases all the elements of a hash_multimap. void clear(); ``` -### Remarks - ### Example The following example demonstrates the use of the hash_multimap::clear member function. @@ -418,8 +416,6 @@ A type that provides a reference to a **`const`** element stored in a hash_multi typedef list::const_reference const_reference; ``` -### Remarks - ### Example ```cpp @@ -875,8 +871,6 @@ bool empty() const; **`true`** if the hash_multimap is empty; **`false`** if the hash_multimap is nonempty. -### Remarks - ### Example ```cpp @@ -1006,8 +1000,6 @@ A pair of iterators such that the first is the [lower_bound](#lower_bound) of th To access the first iterator of a pair `pr` returned by the member function, use `pr`. **first** and to dereference the lower bound iterator, use \*(`pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second** and to dereference the upper bound iterator, use \*(`pr`. **second**). -### Remarks - ### Example ```cpp @@ -1685,8 +1677,6 @@ An [iterator](#iterator) or [const_iterator](#const_iterator) that addresses the If the return value of `lower_bound` is assigned to a `const_iterator`, the hash_multimap object cannot be modified. If the return value of `lower_bound` is assigned to an `iterator`, the hash_multimap object can be modified. -### Remarks - ### Example ```cpp @@ -1792,8 +1782,6 @@ size_type max_size() const; The maximum possible length of the hash_multimap. -### Remarks - ### Example ```cpp @@ -1988,8 +1976,6 @@ A type that provides a reference to an element stored in a hash_multimap. typedef list::reference reference; ``` -### Remarks - ### Example ```cpp @@ -2164,8 +2150,6 @@ size_type size() const; The current length of the hash_multimap. -### Remarks - ### Example The following example demonstrates the use of the hash_multimap::size member function. @@ -2210,8 +2194,6 @@ An unsigned integer type that counts the number of elements in a hash_multimap. typedef list::size_type size_type; ``` -### Remarks - ### Example See the example for [size](#size) for an example of how to declare and use `size_type` @@ -2312,8 +2294,6 @@ An [iterator](#iterator) or [const_iterator](#const_iterator) that addresses the If the return value of `upper_bound` is assigned to a `const_iterator`, the hash_multimap object cannot be modified. If the return value of `upper_bound` is assigned to a `iterator`, the hash_multimap object can be modified. -### Remarks - ### Example ```cpp diff --git a/docs/standard-library/hash-multiset-class.md b/docs/standard-library/hash-multiset-class.md index 7b40ba26239..8be4252e168 100644 --- a/docs/standard-library/hash-multiset-class.md +++ b/docs/standard-library/hash-multiset-class.md @@ -308,8 +308,6 @@ Erases all the elements of a hash_multiset. void clear(); ``` -### Remarks - ### Example ```cpp @@ -388,8 +386,6 @@ A type that provides a reference to a **`const`** element stored in a hash_multi typedef list::const_reference const_reference; ``` -### Remarks - ### Example ```cpp @@ -712,8 +708,6 @@ The value of an element to be inserted into the [hash_multiset](../standard-libr The `emplace` member function returns an iterator that points to the position where the new element was inserted. -### Remarks - ### Example ```cpp @@ -811,8 +805,6 @@ bool empty() const; **`true`** if the hash_multiset is empty; **`false`** if the hash_multiset is nonempty. -### Remarks - ### Example ```cpp @@ -1591,8 +1583,6 @@ The argument key to be compared with the sort key of an element from the hash_mu An [iterator](#iterator) or [const_iterator](#const_iterator) that addresses the location of the first element in a hash_multiset with a key that is equal to or greater than the argument key, or that addresses the location succeeding the last element in the hash_multiset if no match is found for the key. -### Remarks - ### Example ```cpp @@ -1651,8 +1641,6 @@ size_type max_size() const; The maximum possible length of the hash_multiset. -### Remarks - ### Example ```cpp @@ -1845,8 +1833,6 @@ A type that provides a reference to an element stored in a hash_multiset. typedef list::reference reference; ``` -### Remarks - ### Example ```cpp @@ -2004,8 +1990,6 @@ size_type size() const; The current length of the hash_multiset. -### Remarks - ### Example ```cpp @@ -2047,8 +2031,6 @@ An unsigned integer type that can represent the number of elements in a hash_mul typedef list::size_type size_type; ``` -### Remarks - ### Example See example for [size](#size) for an example of how to declare and use `size_type` @@ -2149,8 +2131,6 @@ The argument key to be compared with the sort key of an element from the hash_mu An [iterator](#iterator) or [const_iterator](#const_iterator) that addresses the location of the first element in a hash_multiset with a key greater than the argument key, or that addresses the location succeeding the last element in the hash_multiset if no match is found for the key. -### Remarks - ### Example ```cpp diff --git a/docs/standard-library/hash-set-class.md b/docs/standard-library/hash-set-class.md index 89d2607646a..642b9a71996 100644 --- a/docs/standard-library/hash-set-class.md +++ b/docs/standard-library/hash-set-class.md @@ -316,8 +316,6 @@ Erases all the elements of a hash_set. void clear(); ``` -### Remarks - ### Example ```cpp @@ -396,8 +394,6 @@ A type that provides a reference to a **`const`** element stored in a hash_set f typedef list::const_reference const_reference; ``` -### Remarks - ### Example ```cpp @@ -720,8 +716,6 @@ The value of an element to be inserted into the [hash_set](../standard-library/h The `emplace` member function returns a pair whose **`bool`** component returns **`true`** if an insertion was make and **`false`** if the `hash_set` already contained an element whose key had an equivalent value in the ordering, and whose iterator component returns the address where a new element was inserted or where the element was already located. -### Remarks - ### Example ```cpp @@ -819,8 +813,6 @@ bool empty() const; **`true`** if the hash_set is empty; **`false`** if the hash_set is nonempty. -### Remarks - ### Example ```cpp @@ -940,8 +932,6 @@ A pair of iterators where the first is the [lower_bound](../standard-library/set To access the first iterator of a pair pr returned by the member function, use `pr`. **first**, and to dereference the lower bound iterator, use \*(`pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second**, and to dereference the upper bound iterator, use \*(`pr`. **second**). -### Remarks - ### Example ```cpp @@ -1583,8 +1573,6 @@ The argument key to be compared with the sort key of an element from the hash_se An `iterator` or `const_iterator` that addresses the location of an element in a hash_set that with a key that is equal to or greater than the argument key or that addresses the location succeeding the last element in the hash_set if no match is found for the key. -### Remarks - ### Example ```cpp @@ -1650,8 +1638,6 @@ size_type max_size() const; The maximum possible length of the hash_set. -### Remarks - ### Example ```cpp @@ -1844,8 +1830,6 @@ A type that provides a reference to an element stored in a hash_set. typedef list::reference reference; ``` -### Remarks - ### Example ```cpp @@ -2003,8 +1987,6 @@ size_type size() const; The current length of the hash_set. -### Remarks - ### Example ```cpp @@ -2046,8 +2028,6 @@ An unsigned integer type that can represent the number of elements in a hash_set typedef list::size_type size_type; ``` -### Remarks - ### Example See the example for [size](#size) for an example of how to declare and use `size_type` @@ -2148,8 +2128,6 @@ The argument key to be compared with the sort key of an element from the hash_se An `iterator` or `const_iterator` that addresses the location of an element in a hash_set that with a key that is equal to or greater than the argument key, or that addresses the location succeeding the last element in the hash_set if no match is found for the key. -### Remarks - ### Example ```cpp diff --git a/docs/standard-library/hash-set.md b/docs/standard-library/hash-set.md index 9f11c054220..5708edd6b42 100644 --- a/docs/standard-library/hash-set.md +++ b/docs/standard-library/hash-set.md @@ -19,8 +19,6 @@ Defines the container class templates hash_set and hash_multiset and their suppo #include ``` -## Remarks - ### Operators |Hash_set version|Hash_multiset version|Description| diff --git a/docs/standard-library/iterator-concepts.md b/docs/standard-library/iterator-concepts.md index 027dd4b6309..a5e205079fb 100644 --- a/docs/standard-library/iterator-concepts.md +++ b/docs/standard-library/iterator-concepts.md @@ -455,8 +455,6 @@ The iterator type. *`S`*\ The sentinel type to test. -### Remarks - ### Example: `sized_sentinel_for` The following example uses the `sized_sentinel_for` concept to verify that the sentinel for a `vector` can be subtracted from the vectors iterator in constant time: diff --git a/docs/standard-library/memory-functions.md b/docs/standard-library/memory-functions.md index 5163c789b07..5de848e295b 100644 --- a/docs/standard-library/memory-functions.md +++ b/docs/standard-library/memory-functions.md @@ -36,8 +36,6 @@ The object or function for which to obtain the true address. The actual address of the object or function referenced by *`value`*, even if an overloaded `operator&()` exists. -### Remarks - ## `align` Fits storage of the given size, aligned by the given alignment specification, into the first possible address of the given storage. diff --git a/docs/standard-library/sync-none-class.md b/docs/standard-library/sync-none-class.md index 1966997f4a5..029d89e81bb 100644 --- a/docs/standard-library/sync-none-class.md +++ b/docs/standard-library/sync-none-class.md @@ -93,8 +93,6 @@ The cache object to compare for equality. The member function always returns **`true`**. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/sync-per-container-class.md b/docs/standard-library/sync-per-container-class.md index 796756f4288..3bef68a28bf 100644 --- a/docs/standard-library/sync-per-container-class.md +++ b/docs/standard-library/sync-per-container-class.md @@ -55,8 +55,6 @@ The cache object to compare for equality. The member function always returns **`false`**. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/sync-per-thread-class.md b/docs/standard-library/sync-per-thread-class.md index 6a4b0047247..9ec2b9e588f 100644 --- a/docs/standard-library/sync-per-thread-class.md +++ b/docs/standard-library/sync-per-thread-class.md @@ -97,8 +97,6 @@ The cache object to compare for equality. **`false`** if no cache object has been allocated for this object or for *Other* in the current thread. Otherwise it returns the result of applying `operator==` to the two cache objects. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/sync-shared-class.md b/docs/standard-library/sync-shared-class.md index 67ae7354c9e..1e31e50fb11 100644 --- a/docs/standard-library/sync-shared-class.md +++ b/docs/standard-library/sync-shared-class.md @@ -97,8 +97,6 @@ The cache to compare for equality. **`true`** if the result of `cache.equals(Other.cache)`, where `cache` represents the cache object, is **`true`**; otherwise, **`false`**. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/system-error-enums.md b/docs/standard-library/system-error-enums.md index 2551b9345a5..a5603ef2470 100644 --- a/docs/standard-library/system-error-enums.md +++ b/docs/standard-library/system-error-enums.md @@ -94,8 +94,6 @@ class errc { }; ``` -### Remarks - ## io_errc Provides symbolic names for the error conditions in \. Can be used to create [error_condition](../standard-library/error-condition-class.md) objects to be compared with the value that's returned by the [ios_base::failure](../standard-library/ios-base-class.md#failure)`code()` function. diff --git a/docs/standard-library/wstring-convert-class.md b/docs/standard-library/wstring-convert-class.md index 8b6789b1284..0bb4206b907 100644 --- a/docs/standard-library/wstring-convert-class.md +++ b/docs/standard-library/wstring-convert-class.md @@ -161,8 +161,6 @@ state_type state() const; The [conversion state](../standard-library/wstring-convert-class.md) object that represents the state of the conversion. -### Remarks - ## wstring_convert::state_type A type that represents the conversion state. From 886e88377148edeb34c5ecc16df51447841d3c20 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 3 Jul 2025 18:47:49 +0800 Subject: [PATCH 0259/1799] Update metadata in over a dozen standard library references --- docs/standard-library/allocators-functions.md | 5 ++--- docs/standard-library/basic-stringbuf-class.md | 3 +-- docs/standard-library/cache-chunklist-class.md | 5 ++--- docs/standard-library/cache-freelist-class.md | 5 ++--- docs/standard-library/cache-suballoc-class.md | 5 ++--- docs/standard-library/error-category-class.md | 3 +-- docs/standard-library/error-code-class.md | 5 ++--- docs/standard-library/freelist-class.md | 5 ++--- docs/standard-library/hash-set.md | 5 ++--- docs/standard-library/sync-none-class.md | 5 ++--- docs/standard-library/sync-per-container-class.md | 5 ++--- docs/standard-library/sync-per-thread-class.md | 5 ++--- docs/standard-library/sync-shared-class.md | 5 ++--- docs/standard-library/system-error-enums.md | 5 ++--- docs/standard-library/wstring-convert-class.md | 5 ++--- 15 files changed, 28 insertions(+), 43 deletions(-) diff --git a/docs/standard-library/allocators-functions.md b/docs/standard-library/allocators-functions.md index 66a22b8865a..fafefa60342 100644 --- a/docs/standard-library/allocators-functions.md +++ b/docs/standard-library/allocators-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: macros" title: " macros" -ms.date: "11/04/2016" +description: "Learn more about: macros" +ms.date: 11/04/2016 f1_keywords: ["allocators/std::ALLOCATOR_DECL", "allocators/std::CACHE_CHUNKLIST", "allocators/std::CACHE_FREELIST", "allocators/std::CACHE_SUBALLOC", "allocators/std::SYNC_DEFAULT"] -ms.assetid: 9cb5ee07-1ff9-4594-ae32-3c8c6efb511a helpviewer_keywords: ["std::ALLOCATOR_DECL [C++]", "std::CACHE_CHUNKLIST [C++]", "std::CACHE_FREELIST [C++]", "std::CACHE_SUBALLOC [C++]", "std::SYNC_DEFAULT [C++]"] --- # `` macros diff --git a/docs/standard-library/basic-stringbuf-class.md b/docs/standard-library/basic-stringbuf-class.md index af80720aa38..7fde918659b 100644 --- a/docs/standard-library/basic-stringbuf-class.md +++ b/docs/standard-library/basic-stringbuf-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: basic_stringbuf Class" title: "basic_stringbuf Class" +description: "Learn more about: basic_stringbuf Class" ms.date: 06/10/2022 f1_keywords: ["sstream/std::basic_stringbuf", "sstream/std::basic_stringbuf::allocator_type", "sstream/std::basic_stringbuf::char_type", "sstream/std::basic_stringbuf::int_type", "sstream/std::basic_stringbuf::off_type", "sstream/std::basic_stringbuf::pos_type", "sstream/std::basic_stringbuf::traits_type", "sstream/std::basic_stringbuf::overflow", "sstream/std::basic_stringbuf::pbackfail", "sstream/std::basic_stringbuf::seekoff", "sstream/std::basic_stringbuf::seekpos", "sstream/std::basic_stringbuf::str", "sstream/std::basic_stringbuf::underflow"] helpviewer_keywords: ["std::basic_stringbuf [C++]", "std::basic_stringbuf [C++], allocator_type", "std::basic_stringbuf [C++], char_type", "std::basic_stringbuf [C++], int_type", "std::basic_stringbuf [C++], off_type", "std::basic_stringbuf [C++], pos_type", "std::basic_stringbuf [C++], traits_type", "std::basic_stringbuf [C++], overflow", "std::basic_stringbuf [C++], pbackfail", "std::basic_stringbuf [C++], seekoff", "std::basic_stringbuf [C++], seekpos", "std::basic_stringbuf [C++], str", "std::basic_stringbuf [C++], underflow"] -ms.assetid: 40c85f9e-42a5-4a65-af5c-23c8e3bf8113 ms.custom: devdivchpfy22 --- diff --git a/docs/standard-library/cache-chunklist-class.md b/docs/standard-library/cache-chunklist-class.md index 75cd8a859f4..e2de788bc76 100644 --- a/docs/standard-library/cache-chunklist-class.md +++ b/docs/standard-library/cache-chunklist-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: cache_chunklist Class" title: "cache_chunklist Class" -ms.date: "11/04/2016" +description: "Learn more about: cache_chunklist Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::cache_chunklist", "allocators/stdext::cache_chunklist::allocate", "allocators/stdext::cache_chunklist::deallocate"] helpviewer_keywords: ["stdext::cache_chunklist", "stdext::cache_chunklist [C++], allocate", "stdext::cache_chunklist [C++], deallocate"] -ms.assetid: af19eccc-4ae7-4a34-bbb2-81e397424cb9 --- # cache_chunklist Class diff --git a/docs/standard-library/cache-freelist-class.md b/docs/standard-library/cache-freelist-class.md index b529fb52a9d..71faf8ebc05 100644 --- a/docs/standard-library/cache-freelist-class.md +++ b/docs/standard-library/cache-freelist-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: cache_freelist Class" title: "cache_freelist Class" -ms.date: "11/04/2016" +description: "Learn more about: cache_freelist Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::cache_freelist", "allocators/stdext::cache_freelist::allocate", "allocators/stdext::cache_freelist::deallocate"] helpviewer_keywords: ["stdext::cache_freelist", "stdext::cache_freelist [C++], allocate", "stdext::cache_freelist [C++], deallocate"] -ms.assetid: 840694de-36ba-470f-8dae-2b723d5a8cd9 --- # cache_freelist Class diff --git a/docs/standard-library/cache-suballoc-class.md b/docs/standard-library/cache-suballoc-class.md index 3735f4a9e07..12f111137d7 100644 --- a/docs/standard-library/cache-suballoc-class.md +++ b/docs/standard-library/cache-suballoc-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: cache_suballoc Class" title: "cache_suballoc Class" -ms.date: "11/04/2016" +description: "Learn more about: cache_suballoc Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::cache_suballoc", "allocators/stdext::cache_suballoc::allocate", "allocators/stdext::cache_suballoc::deallocate"] helpviewer_keywords: ["stdext::cache_suballoc", "stdext::cache_suballoc [C++], allocate", "stdext::cache_suballoc [C++], deallocate"] -ms.assetid: 9ea9c5e9-1dcc-45d0-b3a7-a56a93d88898 --- # cache_suballoc Class diff --git a/docs/standard-library/error-category-class.md b/docs/standard-library/error-category-class.md index 0d393be6435..0eabf941a98 100644 --- a/docs/standard-library/error-category-class.md +++ b/docs/standard-library/error-category-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: error_category Class" title: "error_category Class" +description: "Learn more about: error_category Class" ms.date: 06/15/2022 f1_keywords: ["system_error/std::error_category", "system_error/std::error_category::value_type", "system_error/std::error_category::default_error_condition", "system_error/std::error_category::equivalent", "system_error/std::error_category::message", "system_error/std::error_category::name"] helpviewer_keywords: ["std::error_category", "std::error_category::value_type", "std::error_category::default_error_condition", "std::error_category::equivalent", "std::error_category::message", "std::error_category::name"] -ms.assetid: e0a71e14-852d-4905-acd6-5f8ed426706d ms.custom: devdivchpfy22 --- diff --git a/docs/standard-library/error-code-class.md b/docs/standard-library/error-code-class.md index f6029aef13f..f7cc93b6fb3 100644 --- a/docs/standard-library/error-code-class.md +++ b/docs/standard-library/error-code-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: error_code Class" title: "error_code Class" -ms.date: "11/04/2016" +description: "Learn more about: error_code Class" +ms.date: 11/04/2016 f1_keywords: ["system_error/std::error_code", "system_error/std::error_code::value_type", "system_error/std::error_code::assign", "system_error/std::error_code::category", "system_error/std::error_code::clear", "system_error/std::error_code::default_error_condition", "system_error/std::error_code::message", "system_error/std::error_code::operator bool"] helpviewer_keywords: ["std::error_code", "std::error_code::value_type", "std::error_code::assign", "std::error_code::category", "std::error_code::clear", "std::error_code::default_error_condition", "std::error_code::message"] -ms.assetid: c09b4a96-cb14-4281-a319-63543f9b2b4a --- # error_code Class diff --git a/docs/standard-library/freelist-class.md b/docs/standard-library/freelist-class.md index 93fe79b0b5b..2d3d4286e5e 100644 --- a/docs/standard-library/freelist-class.md +++ b/docs/standard-library/freelist-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: freelist Class" title: "freelist Class" -ms.date: "11/04/2016" +description: "Learn more about: freelist Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::freelist", "allocators/stdext::freelist::pop", "allocators/stdext::freelist::push"] helpviewer_keywords: ["stdext::freelist", "stdext::freelist [C++], pop", "stdext::freelist [C++], push"] -ms.assetid: 8ad7e35c-4c80-4479-8ede-1a2497b06d71 --- # freelist Class diff --git a/docs/standard-library/hash-set.md b/docs/standard-library/hash-set.md index 5708edd6b42..e0581915841 100644 --- a/docs/standard-library/hash-set.md +++ b/docs/standard-library/hash-set.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["hash_set header"] -ms.assetid: 6b556967-c808-4869-9b4d-f9e030864435 --- # `` diff --git a/docs/standard-library/sync-none-class.md b/docs/standard-library/sync-none-class.md index 029d89e81bb..df55c41667b 100644 --- a/docs/standard-library/sync-none-class.md +++ b/docs/standard-library/sync-none-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: sync_none Class" title: "sync_none Class" -ms.date: "11/04/2016" +description: "Learn more about: sync_none Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::sync_none", "allocators/stdext::sync_none::allocate", "allocators/stdext::sync_none::deallocate", "allocators/stdext::sync_none::equals"] helpviewer_keywords: ["stdext::sync_none", "stdext::sync_none [C++], allocate", "stdext::sync_none [C++], deallocate", "stdext::sync_none [C++], equals"] -ms.assetid: f7473cee-14f3-4fe1-88bc-68cd085e59e1 --- # sync_none Class diff --git a/docs/standard-library/sync-per-container-class.md b/docs/standard-library/sync-per-container-class.md index 3bef68a28bf..2a164a0a0b1 100644 --- a/docs/standard-library/sync-per-container-class.md +++ b/docs/standard-library/sync-per-container-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: sync_per_container Class" title: "sync_per_container Class" -ms.date: "11/04/2016" +description: "Learn more about: sync_per_container Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::sync_per_container", "allocators/stdext::sync_per_container::equals"] helpviewer_keywords: ["sync_per_container class"] -ms.assetid: 0b4b2904-b668-4d94-a422-d4f919cbffab --- # sync_per_container Class diff --git a/docs/standard-library/sync-per-thread-class.md b/docs/standard-library/sync-per-thread-class.md index 9ec2b9e588f..aa715f4c698 100644 --- a/docs/standard-library/sync-per-thread-class.md +++ b/docs/standard-library/sync-per-thread-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: sync_per_thread Class" title: "sync_per_thread Class" -ms.date: "11/04/2016" +description: "Learn more about: sync_per_thread Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::sync_per_thread", "allocators/stdext::sync_per_thread::allocate", "allocators/stdext::sync_per_thread::deallocate", "allocators/stdext::sync_per_thread::equals"] helpviewer_keywords: ["stdext::sync_per_thread", "stdext::sync_per_thread [C++], allocate", "stdext::sync_per_thread [C++], deallocate", "stdext::sync_per_thread [C++], equals"] -ms.assetid: 47bf75f8-5b02-4760-b1d3-3099d08fe14c --- # sync_per_thread Class diff --git a/docs/standard-library/sync-shared-class.md b/docs/standard-library/sync-shared-class.md index 1e31e50fb11..bd722d3a534 100644 --- a/docs/standard-library/sync-shared-class.md +++ b/docs/standard-library/sync-shared-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: sync_shared Class" title: "sync_shared Class" -ms.date: "11/04/2016" +description: "Learn more about: sync_shared Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::sync_shared", "allocators/stdext::sync_shared::allocate", "allocators/stdext::sync_shared::deallocate", "allocators/stdext::sync_shared::equals"] helpviewer_keywords: ["stdext::sync_shared", "stdext::sync_shared [C++], allocate", "stdext::sync_shared [C++], deallocate", "stdext::sync_shared [C++], equals"] -ms.assetid: cab3af9e-3d1a-4f2c-8580-0f89e5687d8e --- # sync_shared Class diff --git a/docs/standard-library/system-error-enums.md b/docs/standard-library/system-error-enums.md index a5603ef2470..9ad2a056960 100644 --- a/docs/standard-library/system-error-enums.md +++ b/docs/standard-library/system-error-enums.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: enums" title: " enums" -ms.date: "11/04/2016" +description: "Learn more about: enums" +ms.date: 11/04/2016 f1_keywords: ["system_error/std::errc", "system_error/std::io_errc"] -ms.assetid: b21321b7-404a-40de-8777-a85b77c6fa58 --- # `` enums diff --git a/docs/standard-library/wstring-convert-class.md b/docs/standard-library/wstring-convert-class.md index 0bb4206b907..41c72fa8559 100644 --- a/docs/standard-library/wstring-convert-class.md +++ b/docs/standard-library/wstring-convert-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: wstring_convert Class" title: "wstring_convert Class" -ms.date: "11/04/2016" +description: "Learn more about: wstring_convert Class" +ms.date: 11/04/2016 f1_keywords: ["wstring/stdext::cvt::wstring_convert", "locale/std::wstring_convert::byte_string", "locale/std::wstring_convert::wide_string", "locale/std::wstring_convert::state_type", "locale/std::wstring_convert::int_type", "locale/std::wstring_convert::from_bytes", "locale/std::wstring_convert::to_bytes", "locale/std::wstring_convert::converted", "locale/std::wstring_convert::state"] helpviewer_keywords: ["stdext::cvt [C++], wstring_convert", "std::wstring_convert [C++], byte_string", "std::wstring_convert [C++], wide_string", "std::wstring_convert [C++], state_type", "std::wstring_convert [C++], int_type", "std::wstring_convert [C++], from_bytes", "std::wstring_convert [C++], to_bytes", "std::wstring_convert [C++], converted", "std::wstring_convert [C++], state"] -ms.assetid: e34f5b65-d572-4bdc-ac69-20778712e376 --- # wstring_convert Class From 30a8d4b59912967a37d1823322088f3480f30b30 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 3 Jul 2025 19:01:49 +0800 Subject: [PATCH 0260/1799] Add blockquotes for error messages in range [C1051, C1080] --- docs/error-messages/compiler-errors-1/fatal-error-c1051.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1053.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1054.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1055.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1057.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1060.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1061.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1064.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1065.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1067.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1068.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1070.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1071.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1074.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1075.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1077.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1080.md | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1051.md b/docs/error-messages/compiler-errors-1/fatal-error-c1051.md index da1b46802d4..ef8aede1ed8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1051.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1051.md @@ -8,6 +8,6 @@ ms.assetid: 87dcbd3b-0952-499a-bd42-64f9e8de2605 --- # Fatal Error C1051 -program database file, 'pdbfile', has an obsolete format, delete it and recompile +> program database file, 'pdbfile', has an obsolete format, delete it and recompile The compiler cannot update the program database file, which has an older version number. Delete the file and recompile your program with **/Zi** or **/ZI**. For more information, see [/Z7, /Zi, /ZI (Debug Information Format)](../../build/reference/z7-zi-zi-debug-information-format.md) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md index b97c1b622f9..44068522e86 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md @@ -8,7 +8,7 @@ ms.assetid: f50c1c6a-d9cc-42fa-984e-4e2e6e9cd1b1 --- # Fatal Error C1053 -'\' : function too large +> '' : function too large The function is too large to compile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1054.md b/docs/error-messages/compiler-errors-1/fatal-error-c1054.md index ff4963cff7c..0956bfb0541 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1054.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1054.md @@ -8,7 +8,7 @@ ms.assetid: 9cfb7307-b22a-4418-b7c0-2621b0ab5b1b --- # Fatal Error C1054 -compiler limit : initializers nested too deeply +> compiler limit : initializers nested too deeply The code exceeds the nesting limit on initializers (10-15 levels, depending on the combination of types being initialized). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1055.md b/docs/error-messages/compiler-errors-1/fatal-error-c1055.md index b60f41acd71..63de0454de1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1055.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1055.md @@ -8,7 +8,7 @@ ms.assetid: a9fb9190-d7eb-4d5f-b1a2-a41e584a28c1 --- # Fatal Error C1055 -compiler limit : out of keys +> compiler limit : out of keys The source file contains too many symbols. The compiler ran out of hash keys for the symbol table. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1057.md b/docs/error-messages/compiler-errors-1/fatal-error-c1057.md index 238df928a73..58e87a2f12c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1057.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1057.md @@ -8,6 +8,6 @@ ms.assetid: 1e67e727-963d-42c5-8c32-c0e370d32735 --- # Fatal Error C1057 -unexpected end of file in macro expansion +> unexpected end of file in macro expansion The compiler reached the end of the source file while gathering macro-invocation arguments, probably due to a missing right parenthesis in the macro invocation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1060.md b/docs/error-messages/compiler-errors-1/fatal-error-c1060.md index 60e1f7a1e32..1cafe67d42a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1060.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1060.md @@ -8,7 +8,7 @@ ms.assetid: feaf305c-c84c-4160-b974-50e283412849 --- # Fatal Error C1060 -compiler is out of heap space +> compiler is out of heap space The operating system or run-time library cannot fill a request for memory. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1061.md b/docs/error-messages/compiler-errors-1/fatal-error-c1061.md index 9e17fd39f86..93dff6cc6c2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1061.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1061.md @@ -8,7 +8,7 @@ ms.assetid: 9366c0bc-96e0-4967-aa7d-4ebf098de806 --- # Fatal Error C1061 -compiler limit : blocks nested too deeply +> compiler limit : blocks nested too deeply Nesting of code blocks exceeds the limit of 128 nesting levels. This is a hard limit in the compiler for both C and C++, in both the 32-bit and 64-bit tool set. The count of nesting levels can be increased by anything that creates a scope or block. For example, namespaces, using directives, preprocessor expansions, template expansion, exception handling, loop constructs, and else-if clauses can all increase the nesting level seen by the compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1064.md b/docs/error-messages/compiler-errors-1/fatal-error-c1064.md index e3f16ff5dca..b28f1beaf74 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1064.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1064.md @@ -8,6 +8,6 @@ ms.assetid: d4598a28-b8f6-4e78-a0c6-db324f5bdfc3 --- # Fatal Error C1064 -compiler limit : token overflowed internal buffer +> compiler limit : token overflowed internal buffer An identifier exceeds the length of the internal buffer used for identifiers. Shorten the name. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1065.md b/docs/error-messages/compiler-errors-1/fatal-error-c1065.md index 2db2bf5c213..7260b58f5e4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1065.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1065.md @@ -8,7 +8,7 @@ ms.assetid: 80a27e13-696d-4199-a284-0d6b07446ff3 --- # Fatal Error C1065 -compiler limit : out of tags +> compiler limit : out of tags The source file contains more than 65,523 classes, structs, unions, namespaces, or enums. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1067.md b/docs/error-messages/compiler-errors-1/fatal-error-c1067.md index b9d556d5a6d..b46c5e20523 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1067.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1067.md @@ -8,7 +8,7 @@ ms.assetid: e2c94be6-4573-4571-aac9-73d657fe9f96 --- # Fatal Error C1067 -compiler limit : 64K limit on size of a type record has been exceeded +> compiler limit : 64K limit on size of a type record has been exceeded This error could occur if a symbol has a decorated name exceeding 247 characters. To resolve, shorten the symbol name. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1068.md b/docs/error-messages/compiler-errors-1/fatal-error-c1068.md index ff9d25709d3..f93f806672e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1068.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1068.md @@ -8,6 +8,6 @@ ms.assetid: 3b4abd16-4552-4900-84be-54f6ebb6c785 --- # Fatal Error C1068 -cannot open file 'file' +> cannot open file 'file' Ensure that `file` is not in use by another program. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md index a1cc8f0a774..27d1d31b4e2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md @@ -8,7 +8,7 @@ ms.assetid: 1058269a-5db6-4c23-a97f-b5269eb9188b --- # Fatal Error C1070 -mismatched #if/#endif pair in file 'filename' +> mismatched #if/#endif pair in file 'filename' An `#if`, `#ifdef`, or `#ifndef` directive has no corresponding `#endif`. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md index 82f1926458f..88e1c3119f5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md @@ -8,7 +8,7 @@ ms.assetid: 489f1786-370e-4ecd-af67-538fe6e5bd4e --- # Fatal Error C1071 -unexpected end of file found in comment +> unexpected end of file found in comment The compiler reached the end of the file while scanning a comment. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1074.md b/docs/error-messages/compiler-errors-1/fatal-error-c1074.md index 4058a24309d..c96332127bb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1074.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1074.md @@ -8,6 +8,6 @@ ms.assetid: 979d4ab2-0f1a-472a-85f8-71f48297274f --- # Fatal Error C1074 -'IDB' is illegal extension for PDB file: filename +> 'IDB' is illegal extension for PDB file: filename The compiler expects program databases to have the .pdb extension. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1075.md b/docs/error-messages/compiler-errors-1/fatal-error-c1075.md index e63540537d6..207fbf5bc68 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1075.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1075.md @@ -8,7 +8,7 @@ ms.assetid: 69a74e3d-b53f-4526-a440-2c94e6403355 --- # Fatal Error C1075 -the left token was unmatched at the end of the file +> the left token was unmatched at the end of the file The compiler expected matching *token* before it reached the end of file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1077.md b/docs/error-messages/compiler-errors-1/fatal-error-c1077.md index a759bcabfab..332de763079 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1077.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1077.md @@ -8,7 +8,7 @@ ms.assetid: 514d66f4-b512-479a-b793-ebf45c91e15b --- # Fatal Error C1077 -compiler limit : cannot have more than number command line options +> compiler limit : cannot have more than number command line options The number of command-line options exceeds the internal limit. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1080.md b/docs/error-messages/compiler-errors-1/fatal-error-c1080.md index c5d058e6e8a..910b7d550fd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1080.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1080.md @@ -8,6 +8,6 @@ ms.assetid: 01e9e7c0-6a20-4539-b9d2-d27e7afcc8e6 --- # Fatal Error C1080 -compiler limit : command line option exceeded limit of number characters +> compiler limit : command line option exceeded limit of number characters An argument passed to the compiler exceeds 256 characters. From 48f00ee8c931d26c3b54c951468dd9aff430c001 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 3 Jul 2025 19:07:33 +0800 Subject: [PATCH 0261/1799] Add "Remarks" and "Example" headings for error references in range [C1051, C1080] --- docs/error-messages/compiler-errors-1/fatal-error-c1051.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1052.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1053.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1054.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1055.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1057.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1060.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1061.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1064.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1065.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1067.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1068.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1070.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1071.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1073.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1074.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1075.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1076.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1077.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1079.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1080.md | 2 ++ 21 files changed, 46 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1051.md b/docs/error-messages/compiler-errors-1/fatal-error-c1051.md index ef8aede1ed8..c601c86c8fd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1051.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1051.md @@ -10,4 +10,6 @@ ms.assetid: 87dcbd3b-0952-499a-bd42-64f9e8de2605 > program database file, 'pdbfile', has an obsolete format, delete it and recompile +## Remarks + The compiler cannot update the program database file, which has an older version number. Delete the file and recompile your program with **/Zi** or **/ZI**. For more information, see [/Z7, /Zi, /ZI (Debug Information Format)](../../build/reference/z7-zi-zi-debug-information-format.md) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1052.md b/docs/error-messages/compiler-errors-1/fatal-error-c1052.md index 7a564c3f29f..fefb64877de 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1052.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1052.md @@ -10,6 +10,8 @@ ms.assetid: f2c09a2f-d3c1-4420-9501-ffcb65caf87b > program database file, '*filename*', was generated by the linker with /DEBUG:fastlink; compiler cannot update such PDB files; please delete it or use /Fd to specify a different PDB filename +## Remarks + The compiler cannot update the same program database (PDB) files which are generated by the linker when the [/DEBUG:fastlink](../../build/reference/debug-generate-debug-info.md) option is specified. Normally the compiler-generated PDB files and the linker-generated PDB files have different names. However, if they are set to use the same names, this error can result. To fix this issue, you can explicitly delete the PDB files before you compile again, or you can create different names for the compiler-generated and linker-generated PDB files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md index 44068522e86..b7aa656bbda 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md @@ -10,6 +10,8 @@ ms.assetid: f50c1c6a-d9cc-42fa-984e-4e2e6e9cd1b1 > '' : function too large +## Remarks + The function is too large to compile. ### To fix by using the following possible solutions diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1054.md b/docs/error-messages/compiler-errors-1/fatal-error-c1054.md index 0956bfb0541..25390700d0e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1054.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1054.md @@ -10,6 +10,8 @@ ms.assetid: 9cfb7307-b22a-4418-b7c0-2621b0ab5b1b > compiler limit : initializers nested too deeply +## Remarks + The code exceeds the nesting limit on initializers (10-15 levels, depending on the combination of types being initialized). ### To fix by using the following possible solutions diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1055.md b/docs/error-messages/compiler-errors-1/fatal-error-c1055.md index 63de0454de1..cc53da81d1e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1055.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1055.md @@ -10,6 +10,8 @@ ms.assetid: a9fb9190-d7eb-4d5f-b1a2-a41e584a28c1 > compiler limit : out of keys +## Remarks + The source file contains too many symbols. The compiler ran out of hash keys for the symbol table. ### To fix by using the following possible solutions diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1057.md b/docs/error-messages/compiler-errors-1/fatal-error-c1057.md index 58e87a2f12c..5fc0c6c6723 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1057.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1057.md @@ -10,4 +10,6 @@ ms.assetid: 1e67e727-963d-42c5-8c32-c0e370d32735 > unexpected end of file in macro expansion +## Remarks + The compiler reached the end of the source file while gathering macro-invocation arguments, probably due to a missing right parenthesis in the macro invocation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1060.md b/docs/error-messages/compiler-errors-1/fatal-error-c1060.md index 1cafe67d42a..99954ba30b9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1060.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1060.md @@ -10,6 +10,8 @@ ms.assetid: feaf305c-c84c-4160-b974-50e283412849 > compiler is out of heap space +## Remarks + The operating system or run-time library cannot fill a request for memory. ### To fix this error try the following possible solutions diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1061.md b/docs/error-messages/compiler-errors-1/fatal-error-c1061.md index 93dff6cc6c2..32b24266d9b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1061.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1061.md @@ -10,6 +10,8 @@ ms.assetid: 9366c0bc-96e0-4967-aa7d-4ebf098de806 > compiler limit : blocks nested too deeply +## Remarks + Nesting of code blocks exceeds the limit of 128 nesting levels. This is a hard limit in the compiler for both C and C++, in both the 32-bit and 64-bit tool set. The count of nesting levels can be increased by anything that creates a scope or block. For example, namespaces, using directives, preprocessor expansions, template expansion, exception handling, loop constructs, and else-if clauses can all increase the nesting level seen by the compiler. To fix this error you must refactor your code. In any case, deeply nested code is difficult to understand and reason about. Refactoring your code to have fewer nesting levels may improve code quality and simplify maintenance. Break deeply nested code into functions that are called from the original context. Limit the number of loops or chained else-if clauses within a block. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1064.md b/docs/error-messages/compiler-errors-1/fatal-error-c1064.md index b28f1beaf74..228d06d7539 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1064.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1064.md @@ -10,4 +10,6 @@ ms.assetid: d4598a28-b8f6-4e78-a0c6-db324f5bdfc3 > compiler limit : token overflowed internal buffer +## Remarks + An identifier exceeds the length of the internal buffer used for identifiers. Shorten the name. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1065.md b/docs/error-messages/compiler-errors-1/fatal-error-c1065.md index 7260b58f5e4..8e6f440956a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1065.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1065.md @@ -10,6 +10,8 @@ ms.assetid: 80a27e13-696d-4199-a284-0d6b07446ff3 > compiler limit : out of tags +## Remarks + The source file contains more than 65,523 classes, structs, unions, namespaces, or enums. Split the file into smaller files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1067.md b/docs/error-messages/compiler-errors-1/fatal-error-c1067.md index b46c5e20523..28d2b77f0ed 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1067.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1067.md @@ -10,6 +10,8 @@ ms.assetid: e2c94be6-4573-4571-aac9-73d657fe9f96 > compiler limit : 64K limit on size of a type record has been exceeded +## Remarks + This error could occur if a symbol has a decorated name exceeding 247 characters. To resolve, shorten the symbol name. When the compiler generates debug information, it emits type records to define types encountered in source code. For example, type records include simple structures and argument lists of functions. Some of these type records can be large lists. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1068.md b/docs/error-messages/compiler-errors-1/fatal-error-c1068.md index f93f806672e..177866058c7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1068.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1068.md @@ -10,4 +10,6 @@ ms.assetid: 3b4abd16-4552-4900-84be-54f6ebb6c785 > cannot open file 'file' +## Remarks + Ensure that `file` is not in use by another program. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md index 27d1d31b4e2..4bebb9ef285 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md @@ -10,8 +10,12 @@ ms.assetid: 1058269a-5db6-4c23-a97f-b5269eb9188b > mismatched #if/#endif pair in file 'filename' +## Remarks + An `#if`, `#ifdef`, or `#ifndef` directive has no corresponding `#endif`. +## Example + The following sample generates C1070: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md index 88e1c3119f5..c6b68e0a03f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md @@ -10,6 +10,8 @@ ms.assetid: 489f1786-370e-4ecd-af67-538fe6e5bd4e > unexpected end of file found in comment +## Remarks + The compiler reached the end of the file while scanning a comment. ### To fix by checking the following possible causes @@ -18,6 +20,8 @@ The compiler reached the end of the file while scanning a comment. 1. Missing newline character after a comment on the last line of a source file. +## Example + The following sample generates C1071: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1073.md b/docs/error-messages/compiler-errors-1/fatal-error-c1073.md index 5bdfc8ee77d..556f71fbdd8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1073.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1073.md @@ -10,6 +10,8 @@ ms.assetid: a946fcf1-674e-4a7a-a28c-b1effacbabe1 > Internal error involving incremental compilation (compiler file '*filename*', line *number*) +## Remarks + Recompile the file without using incremental compilation. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1074.md b/docs/error-messages/compiler-errors-1/fatal-error-c1074.md index c96332127bb..d6961eb6fa8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1074.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1074.md @@ -10,4 +10,6 @@ ms.assetid: 979d4ab2-0f1a-472a-85f8-71f48297274f > 'IDB' is illegal extension for PDB file: filename +## Remarks + The compiler expects program databases to have the .pdb extension. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1075.md b/docs/error-messages/compiler-errors-1/fatal-error-c1075.md index 207fbf5bc68..ac37b2d8128 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1075.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1075.md @@ -10,6 +10,8 @@ ms.assetid: 69a74e3d-b53f-4526-a440-2c94e6403355 > the left token was unmatched at the end of the file +## Remarks + The compiler expected matching *token* before it reached the end of file. This error can be caused by an unmatched bracket, brace, or other paired character. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1076.md b/docs/error-messages/compiler-errors-1/fatal-error-c1076.md index 42d68e82109..dcc47c2cd4b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1076.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1076.md @@ -10,6 +10,8 @@ ms.assetid: 84ac1180-3e8a-48e8-9f77-7f18a778b964 > compiler limit : internal heap limit reached; use /Zm to specify a higher limit +## Remarks + This error can be caused by too many symbols, or too many template instantiations. Starting in Visual Studio 2015, this message may result from Windows virtual memory pressure caused by too many parallel build processes. In this case, the recommendation to use the **/Zm** option should be ignored unless you are using a `#pragma hdrstop` directive. To resolve this error: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1077.md b/docs/error-messages/compiler-errors-1/fatal-error-c1077.md index 332de763079..b125a9b7a62 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1077.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1077.md @@ -10,6 +10,8 @@ ms.assetid: 514d66f4-b512-479a-b793-ebf45c91e15b > compiler limit : cannot have more than number command line options +## Remarks + The number of command-line options exceeds the internal limit. There may be too many symbols defined with [/D](../../build/reference/d-preprocessor-definitions.md). (Place the definitions in a header file instead.) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1079.md b/docs/error-messages/compiler-errors-1/fatal-error-c1079.md index d66d45a5955..f6294cf9bc8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1079.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1079.md @@ -10,6 +10,8 @@ ms.assetid: cf06a65a-f9a5-4bd8-8128-201a6cbe2113 > compiler limit : PCH file size limit exceeded +## Remarks + The PCH file exceeds the 4 GB size limit. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1080.md b/docs/error-messages/compiler-errors-1/fatal-error-c1080.md index 910b7d550fd..182f2e1c7b3 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1080.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1080.md @@ -10,4 +10,6 @@ ms.assetid: 01e9e7c0-6a20-4539-b9d2-d27e7afcc8e6 > compiler limit : command line option exceeded limit of number characters +## Remarks + An argument passed to the compiler exceeds 256 characters. From 55afa26720b6d785fbf3496f9df0f29cd580ae5a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 3 Jul 2025 19:10:25 +0800 Subject: [PATCH 0262/1799] Replace term "sample" with "example" for error references in range [C1051, C1080] --- docs/error-messages/compiler-errors-1/fatal-error-c1070.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1071.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md index 4bebb9ef285..66078b88089 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md @@ -16,7 +16,7 @@ An `#if`, `#ifdef`, or `#ifndef` directive has no corresponding `#endif`. ## Example -The following sample generates C1070: +The following example generates C1070: ```cpp // C1070.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md index c6b68e0a03f..e7fabc343c6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md @@ -22,7 +22,7 @@ The compiler reached the end of the file while scanning a comment. ## Example -The following sample generates C1071: +The following example generates C1071: ```cpp // C1071.cpp From 8117f37715062ff5a1a3c0ab6aeb690ceb50d964 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 3 Jul 2025 19:13:50 +0800 Subject: [PATCH 0263/1799] Update metadata for error references in range [C1051, C1080] --- docs/error-messages/compiler-errors-1/fatal-error-c1051.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1052.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1053.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1054.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1055.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1057.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1060.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1061.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1064.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1065.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1067.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1068.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1070.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1071.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1073.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1074.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1075.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1076.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1077.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1079.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1080.md | 5 ++--- 21 files changed, 40 insertions(+), 61 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1051.md b/docs/error-messages/compiler-errors-1/fatal-error-c1051.md index c601c86c8fd..d2aab16d092 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1051.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1051.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1051" title: "Fatal Error C1051" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1051" +ms.date: 11/04/2016 f1_keywords: ["C1051"] helpviewer_keywords: ["C1051"] -ms.assetid: 87dcbd3b-0952-499a-bd42-64f9e8de2605 --- # Fatal Error C1051 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1052.md b/docs/error-messages/compiler-errors-1/fatal-error-c1052.md index fefb64877de..37f4cfe70cf 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1052.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1052.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1052" title: "Fatal Error C1052" -ms.date: "05/08/2017" +description: "Learn more about: Fatal Error C1052" +ms.date: 05/08/2017 f1_keywords: ["C1052"] helpviewer_keywords: ["C1052"] -ms.assetid: f2c09a2f-d3c1-4420-9501-ffcb65caf87b --- # Fatal Error C1052 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md index b7aa656bbda..e4cd8d75eed 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1053" title: "Fatal Error C1053" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1053" +ms.date: 11/04/2016 f1_keywords: ["C1053"] helpviewer_keywords: ["C1053"] -ms.assetid: f50c1c6a-d9cc-42fa-984e-4e2e6e9cd1b1 --- # Fatal Error C1053 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1054.md b/docs/error-messages/compiler-errors-1/fatal-error-c1054.md index 25390700d0e..826abb49061 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1054.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1054.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1054" title: "Fatal Error C1054" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1054" +ms.date: 11/04/2016 f1_keywords: ["C1054"] helpviewer_keywords: ["C1054"] -ms.assetid: 9cfb7307-b22a-4418-b7c0-2621b0ab5b1b --- # Fatal Error C1054 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1055.md b/docs/error-messages/compiler-errors-1/fatal-error-c1055.md index cc53da81d1e..d3106aef984 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1055.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1055.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1055" title: "Fatal Error C1055" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1055" +ms.date: 11/04/2016 f1_keywords: ["C1055"] helpviewer_keywords: ["C1055"] -ms.assetid: a9fb9190-d7eb-4d5f-b1a2-a41e584a28c1 --- # Fatal Error C1055 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1057.md b/docs/error-messages/compiler-errors-1/fatal-error-c1057.md index 5fc0c6c6723..646398bb393 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1057.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1057.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1057" title: "Fatal Error C1057" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1057" +ms.date: 11/04/2016 f1_keywords: ["C1057"] helpviewer_keywords: ["C1057"] -ms.assetid: 1e67e727-963d-42c5-8c32-c0e370d32735 --- # Fatal Error C1057 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1060.md b/docs/error-messages/compiler-errors-1/fatal-error-c1060.md index 99954ba30b9..d3d409b2d1a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1060.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1060.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1060" title: "Fatal Error C1060" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1060" +ms.date: 11/04/2016 f1_keywords: ["C1060"] helpviewer_keywords: ["C1060"] -ms.assetid: feaf305c-c84c-4160-b974-50e283412849 --- # Fatal Error C1060 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1061.md b/docs/error-messages/compiler-errors-1/fatal-error-c1061.md index 32b24266d9b..96b7691a600 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1061.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1061.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1061" title: "Fatal Error C1061" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1061" +ms.date: 11/04/2016 f1_keywords: ["C1061"] helpviewer_keywords: ["C1061"] -ms.assetid: 9366c0bc-96e0-4967-aa7d-4ebf098de806 --- # Fatal Error C1061 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1064.md b/docs/error-messages/compiler-errors-1/fatal-error-c1064.md index 228d06d7539..c1469fc91e9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1064.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1064.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1064" title: "Fatal Error C1064" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1064" +ms.date: 11/04/2016 f1_keywords: ["C1064"] helpviewer_keywords: ["C1064"] -ms.assetid: d4598a28-b8f6-4e78-a0c6-db324f5bdfc3 --- # Fatal Error C1064 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1065.md b/docs/error-messages/compiler-errors-1/fatal-error-c1065.md index 8e6f440956a..b0650fec32c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1065.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1065.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1065" title: "Fatal Error C1065" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1065" +ms.date: 11/04/2016 f1_keywords: ["C1065"] helpviewer_keywords: ["C1065"] -ms.assetid: 80a27e13-696d-4199-a284-0d6b07446ff3 --- # Fatal Error C1065 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1067.md b/docs/error-messages/compiler-errors-1/fatal-error-c1067.md index 28d2b77f0ed..f9a3bfd24eb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1067.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1067.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1067" title: "Fatal Error C1067" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1067" +ms.date: 11/04/2016 f1_keywords: ["C1067"] helpviewer_keywords: ["C1067"] -ms.assetid: e2c94be6-4573-4571-aac9-73d657fe9f96 --- # Fatal Error C1067 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1068.md b/docs/error-messages/compiler-errors-1/fatal-error-c1068.md index 177866058c7..86414b26597 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1068.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1068.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1068" title: "Fatal Error C1068" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1068" +ms.date: 11/04/2016 f1_keywords: ["C1068"] helpviewer_keywords: ["C1068"] -ms.assetid: 3b4abd16-4552-4900-84be-54f6ebb6c785 --- # Fatal Error C1068 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md index 66078b88089..df482bb1aad 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1070" title: "Fatal Error C1070" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1070" +ms.date: 11/04/2016 f1_keywords: ["C1070"] helpviewer_keywords: ["C1070"] -ms.assetid: 1058269a-5db6-4c23-a97f-b5269eb9188b --- # Fatal Error C1070 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md index e7fabc343c6..bb3ba4b6f51 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1071" title: "Fatal Error C1071" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1071" +ms.date: 11/04/2016 f1_keywords: ["C1071"] helpviewer_keywords: ["C1071"] -ms.assetid: 489f1786-370e-4ecd-af67-538fe6e5bd4e --- # Fatal Error C1071 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1073.md b/docs/error-messages/compiler-errors-1/fatal-error-c1073.md index 556f71fbdd8..8a58d0814ab 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1073.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1073.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1073" title: "Fatal Error C1073" +description: "Learn more about: Fatal Error C1073" ms.date: 08/17/2022 f1_keywords: ["C1073"] helpviewer_keywords: ["C1073"] -ms.assetid: a946fcf1-674e-4a7a-a28c-b1effacbabe1 --- # Fatal Error C1073 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1074.md b/docs/error-messages/compiler-errors-1/fatal-error-c1074.md index d6961eb6fa8..0966a7fdc7c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1074.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1074.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1074" title: "Fatal Error C1074" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1074" +ms.date: 11/04/2016 f1_keywords: ["C1074"] helpviewer_keywords: ["C1074"] -ms.assetid: 979d4ab2-0f1a-472a-85f8-71f48297274f --- # Fatal Error C1074 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1075.md b/docs/error-messages/compiler-errors-1/fatal-error-c1075.md index ac37b2d8128..8ecce1735e7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1075.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1075.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1075" title: "Fatal Error C1075" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1075" +ms.date: 11/04/2016 f1_keywords: ["C1075"] helpviewer_keywords: ["C1075"] -ms.assetid: 69a74e3d-b53f-4526-a440-2c94e6403355 --- # Fatal Error C1075 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1076.md b/docs/error-messages/compiler-errors-1/fatal-error-c1076.md index dcc47c2cd4b..e0851683ca6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1076.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1076.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1076" title: "Fatal Error C1076" -ms.date: "03/08/2019" +description: "Learn more about: Fatal Error C1076" +ms.date: 03/08/2019 f1_keywords: ["C1076"] helpviewer_keywords: ["C1076"] -ms.assetid: 84ac1180-3e8a-48e8-9f77-7f18a778b964 --- # Fatal Error C1076 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1077.md b/docs/error-messages/compiler-errors-1/fatal-error-c1077.md index b125a9b7a62..fb66328c987 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1077.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1077.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1077" title: "Fatal Error C1077" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1077" +ms.date: 11/04/2016 f1_keywords: ["C1077"] helpviewer_keywords: ["C1077"] -ms.assetid: 514d66f4-b512-479a-b793-ebf45c91e15b --- # Fatal Error C1077 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1079.md b/docs/error-messages/compiler-errors-1/fatal-error-c1079.md index f6294cf9bc8..0b3c3710186 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1079.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1079.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1079" title: "Fatal Error C1079" +description: "Learn more about: Fatal Error C1079" ms.date: 08/17/2022 f1_keywords: ["C1079"] helpviewer_keywords: ["C1079"] -ms.assetid: cf06a65a-f9a5-4bd8-8128-201a6cbe2113 --- # Fatal Error C1079 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1080.md b/docs/error-messages/compiler-errors-1/fatal-error-c1080.md index 182f2e1c7b3..3868560b97a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1080.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1080.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1080" title: "Fatal Error C1080" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1080" +ms.date: 11/04/2016 f1_keywords: ["C1080"] helpviewer_keywords: ["C1080"] -ms.assetid: 01e9e7c0-6a20-4539-b9d2-d27e7afcc8e6 --- # Fatal Error C1080 From f88d3202cc65e47facf00bca9da89c830e75f8ce Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 3 Jul 2025 19:21:34 +0800 Subject: [PATCH 0264/1799] Add back needed escape in C1053 error message --- docs/error-messages/compiler-errors-1/fatal-error-c1053.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md index e4cd8d75eed..111e9c5fcb5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C1053"] --- # Fatal Error C1053 -> '' : function too large +> '\' : function too large ## Remarks From 34ddcf31bc3dffccd13d9f5c263afe5522e75066 Mon Sep 17 00:00:00 2001 From: HO-COOH Date: Thu, 3 Jul 2025 21:38:34 +0800 Subject: [PATCH 0265/1799] Update document-template-creation.md --- docs/mfc/document-template-creation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/document-template-creation.md b/docs/mfc/document-template-creation.md index e4506f1132f..5efdb1673b1 100644 --- a/docs/mfc/document-template-creation.md +++ b/docs/mfc/document-template-creation.md @@ -13,7 +13,7 @@ The document-template constructor specifies what types of documents, windows, an [!code-cpp[NVC_MFCDocView#7](codesnippet/cpp/document-template-creation_1.cpp)] -The pointer to a new `CMultiDocTemplate` object is used as an argument to [AddDocTemplate](reference/cwinapp-class.md#adddoctemplate). Arguments to the `CMultiDocTemplate` constructor include the resource ID associated with the document type's menus and accelerators, and three uses of the [RUNTIME_CLASS](reference/run-time-object-model-services.md#runtime_class) macro. `RUNTIME_CLASS` returns the [CRuntimeClass](reference/cruntimeclass-structure.md) object for the C++ class named as its argument. The three `CRuntimeClass` objects passed to the document-template constructor supply the information needed to create new objects of the specified classes during the document creation process. The example shows creation of a document template that creates `CScribDoc` objects with `CScribView` objects attached. The views are framed by standard MDI child frame windows. +The pointer to a new `CMultiDocTemplate` object is used as an argument to [AddDocTemplate](reference/cwinapp-class.md#adddoctemplate). Arguments to the `CMultiDocTemplate` constructor include the resource ID associated with the document type's menus and accelerators, and three uses of the [RUNTIME_CLASS](reference/run-time-object-model-services.md#runtime_class) macro. `RUNTIME_CLASS` returns the [CRuntimeClass](reference/cruntimeclass-structure.md) object for the C++ class named as its argument. The three `CRuntimeClass` objects passed to the document-template constructor supply the information needed to create new objects of the specified classes during the document creation process. The example shows creation of a document template that creates `CMyDoc` objects with `CMyView` objects attached. The views are framed by custom MDI child frame windows `CChildFrame`. ## See also From 9b9911f72b239e6336c1dfc96110db8d49e7391e Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Fri, 4 Jul 2025 01:56:16 +0900 Subject: [PATCH 0266/1799] Fix typo: Transfomation -> Transformation (#5490) --- ...ing-a-windows-store-app-using-wrl-and-media-foundation_4.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp b/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp index 052da90de52..9bdeebfd49e 100644 --- a/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp +++ b/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp @@ -351,7 +351,7 @@ void TransformChroma(const D2D1::Matrix3x2F& mat, BYTE *pu, BYTE *pv) // // The image conversion functions take the following parameters: // -// mat Transfomation matrix for chroma values. +// mat Transformation matrix for chroma values. // rcDest Destination rectangle. // pDest Pointer to the destination buffer. // lDestStride Stride of the destination buffer, in bytes. From 7f2b123cc90950f8c7603e8492f4376af89a7c35 Mon Sep 17 00:00:00 2001 From: David Justo Date: Thu, 3 Jul 2025 12:43:51 -0700 Subject: [PATCH 0267/1799] [ASan] Document that manually posioned memory must be eventually manually unpoisoned --- docs/sanitizers/asan-runtime.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 363d7402bc3..984d716f93b 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -90,6 +90,9 @@ For convenience, the [AddressSanitizer interface header file](https://github.com #define ASAN_UNPOISON_MEMORY_REGION(addr, size) ``` +> [!NOTE] +> Manually poisoned memory must be eventually unpoisoned by the end-user. Otherwise, ASan may report false positives. + ## Alignment requirements for AddressSanitizer poisoning Any manual poisoning of shadow bytes must consider the alignment requirements. The user must add padding if necessary so the shadow bytes end on a byte boundary in the shadow memory. Each bit in the AddressSanitizer shadow memory encodes the state of a single byte in the application's memory. This encoding means the total size of each allocation, including any padding, must align to an 8-byte boundary. If the alignment requirement isn't satisfied, it can lead to incorrect bug reporting. The incorrect reporting could manifest as missing reports (false negatives) or reports on non-errors (false-positives). From 98b38e62d96ff41712b0260f3e79b13f202583aa Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 3 Jul 2025 12:58:08 -0700 Subject: [PATCH 0268/1799] Update asan-runtime.md Removed end-user because it doesn't add meaning and one reading is that the user of the software (not the developer) unpoisons the memory. That's a weird reading but why even create the possibility. So, I elided it. --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 984d716f93b..5ddd31a9490 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -91,7 +91,7 @@ For convenience, the [AddressSanitizer interface header file](https://github.com ``` > [!NOTE] -> Manually poisoned memory must be eventually unpoisoned by the end-user. Otherwise, ASan may report false positives. +> Manually poisoned memory must be eventually unpoisoned. Otherwise, ASan may report false positives. ## Alignment requirements for AddressSanitizer poisoning From ccb7ec6c44aeb92288f6a6b275e43e2db9aa03bc Mon Sep 17 00:00:00 2001 From: David Justo Date: Thu, 3 Jul 2025 13:22:45 -0700 Subject: [PATCH 0269/1799] improve wording --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 5ddd31a9490..b8d4fc04b73 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -91,7 +91,7 @@ For convenience, the [AddressSanitizer interface header file](https://github.com ``` > [!NOTE] -> Manually poisoned memory must be eventually unpoisoned. Otherwise, ASan may report false positives. +> If you manually poison memory, you must unpoison it before reuse. This is especially important for stack addresses (e.g. a stack local variable), which are frequently reused during program execution. You risk introducing `use-after-poison` false positives in manually poisoned stack addresses if you fail to unpoison them before their stack frame is removed. ## Alignment requirements for AddressSanitizer poisoning From 19c578849dd981f27e11595ed7151925c1496603 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 3 Jul 2025 15:30:06 -0700 Subject: [PATCH 0270/1799] edit --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index b8d4fc04b73..b4894a00b60 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -91,7 +91,7 @@ For convenience, the [AddressSanitizer interface header file](https://github.com ``` > [!NOTE] -> If you manually poison memory, you must unpoison it before reuse. This is especially important for stack addresses (e.g. a stack local variable), which are frequently reused during program execution. You risk introducing `use-after-poison` false positives in manually poisoned stack addresses if you fail to unpoison them before their stack frame is removed. +> If you manually poison memory, you must unpoison it before reuse. This is especially important for stack addresses, such as for a local variable, which are frequently reused during program execution. You risk introducing `use-after-poison` false positives in manually poisoned stack addresses if you don't unpoison them before their stack frame is removed. ## Alignment requirements for AddressSanitizer poisoning From 3a8c76da4d07c1879fc3bc2db06cf49340c82a18 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 17:13:45 +0800 Subject: [PATCH 0271/1799] Replace backslash with forward slash in `f1_keywords` metadata --- docs/c-runtime-library/reference/fabs-fabsf-fabsl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md b/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md index 99d52e6c877..f1ba89c0944 100644 --- a/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md +++ b/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md @@ -6,7 +6,7 @@ api_name: ["fabsf", "fabs", "fabsl", "_o_fabs", "_o_fabsf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] -f1_keywords: ["fabs", "fabsf", "fabsl", "math\fabs", "math\fabsf", "math\fabsl"] +f1_keywords: ["fabs", "fabsf", "fabsl", "math/fabs", "math/fabsf", "math/fabsl"] helpviewer_keywords: ["absolute values", "fabsf function", "calculating absolute values", "fabs function", "fabsl function"] --- # `fabs`, `fabsf`, `fabsl` From fe9379ef6511537952d0cb5bcca81876389d7783 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 17:14:49 +0800 Subject: [PATCH 0272/1799] Remove double quotes for `ms.date` in `fabs` reference --- docs/c-runtime-library/reference/fabs-fabsf-fabsl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md b/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md index f1ba89c0944..b496b318cc4 100644 --- a/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md +++ b/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md @@ -1,7 +1,7 @@ --- title: "fabs, fabsf, fabsl" description: "API reference for fabs, fabsf, and fabsl; which calculate the absolute value of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["fabsf", "fabs", "fabsl", "_o_fabs", "_o_fabsf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] From 6823a575d55ae5cdf1a551b352622b0a5844c59c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 17:24:49 +0800 Subject: [PATCH 0273/1799] Fix mismatched double quotes in `f1_keywords` metadata --- docs/mfc/reference/cmemfile-class.md | 2 +- docs/standard-library/high-resolution-clock-struct.md | 2 +- docs/standard-library/local_t.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/mfc/reference/cmemfile-class.md b/docs/mfc/reference/cmemfile-class.md index 27a0b75dbf5..d6b8ff19954 100644 --- a/docs/mfc/reference/cmemfile-class.md +++ b/docs/mfc/reference/cmemfile-class.md @@ -2,7 +2,7 @@ title: "CMemFile Class" description: "Describes the functions available in the CMemFile class which allows you to work with memory files." ms.date: 07/23/2020 -f1_keywords: ["CMemFile", "AFX/CMemFile", "AFX/CMemFile::CMemFile", "AFX/CMemFile::Attach", "AFX/CMemFile::Detach", "AFX/CMemFile::Alloc", "AFX/CMemFile::Free", "AFX/CmemFile::GetBufferPtr", AFX/CMemFile::GrowFile", "AFX/CMemFile::Memcpy", "AFX/CMemFile::Realloc"] +f1_keywords: ["CMemFile", "AFX/CMemFile", "AFX/CMemFile::CMemFile", "AFX/CMemFile::Attach", "AFX/CMemFile::Detach", "AFX/CMemFile::Alloc", "AFX/CMemFile::Free", "AFX/CmemFile::GetBufferPtr", "AFX/CMemFile::GrowFile", "AFX/CMemFile::Memcpy", "AFX/CMemFile::Realloc"] helpviewer_keywords: ["CMemFile [MFC], CMemFile", "CMemFile [MFC], Attach", "CMemFile [MFC], Detach", "CMemFile [MFC], Alloc", "CMemFile [MFC], Free", "CMemFile [MFC], GetBufferPtr", "CMemFile [MFC], GrowFile", "CMemFile [MFC], Memcpy", "CMemFile [MFC], Realloc"] --- # CMemFile Class diff --git a/docs/standard-library/high-resolution-clock-struct.md b/docs/standard-library/high-resolution-clock-struct.md index 702f8d536f8..5d88340aeba 100644 --- a/docs/standard-library/high-resolution-clock-struct.md +++ b/docs/standard-library/high-resolution-clock-struct.md @@ -4,7 +4,7 @@ title: high_resolution_clock struct ms.custom: "" ms.date: 08/19/2021 ms.topic: "reference" -f1_keywords: ["chrono/std::chrono::high_resolution_clock", chrono/std::chrono::high_resolution_clock::now", "chrono/std::chrono::high_resolution_clock::is_steady constant"] +f1_keywords: ["chrono/std::chrono::high_resolution_clock", "chrono/std::chrono::high_resolution_clock::now", "chrono/std::chrono::high_resolution_clock::is_steady constant"] helpviewer_keywords: ["std::chrono [C++], high_resolution_clock"] dev_langs: ["C++"] author: "tylermsft" diff --git a/docs/standard-library/local_t.md b/docs/standard-library/local_t.md index b4d78f004be..f90b3ac8b44 100644 --- a/docs/standard-library/local_t.md +++ b/docs/standard-library/local_t.md @@ -2,7 +2,7 @@ title: "local_t struct" description: "Learn more about: local_t struct" ms.date: 09/02/2021 -f1_keywords: ["chrono/std::chrono::local_t", chrono/std::chrono::local_time", "chrono/std::chrono::local_days", "chrono/std::chrono::local_seconds"] +f1_keywords: ["chrono/std::chrono::local_t", "chrono/std::chrono::local_time", "chrono/std::chrono::local_days", "chrono/std::chrono::local_seconds"] helpviewer_keywords: ["std::chrono [C++], local_t"] dev_langs: ["C++"] --- From 100aeda5414f815a60bf278bd4f4d41cb9964d7a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 17:25:47 +0800 Subject: [PATCH 0274/1799] Move `title` metadata above `description` in `high_resolution_clock` struct reference --- docs/standard-library/high-resolution-clock-struct.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/high-resolution-clock-struct.md b/docs/standard-library/high-resolution-clock-struct.md index 5d88340aeba..070d29c7327 100644 --- a/docs/standard-library/high-resolution-clock-struct.md +++ b/docs/standard-library/high-resolution-clock-struct.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: high_resolution_clock struct" title: high_resolution_clock struct +description: "Learn more about: high_resolution_clock struct" ms.custom: "" ms.date: 08/19/2021 ms.topic: "reference" From 31d1d562d5eaa38e57882c33707b6951bd0ce033 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 17:45:02 +0800 Subject: [PATCH 0275/1799] Add backticks in "Checked Iterators" topic --- docs/standard-library/checked-iterators.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/standard-library/checked-iterators.md b/docs/standard-library/checked-iterators.md index 719992a7af8..bc172529a6e 100644 --- a/docs/standard-library/checked-iterators.md +++ b/docs/standard-library/checked-iterators.md @@ -12,18 +12,18 @@ Checked iterators ensure that the bounds of your container are not overwritten. ## Remarks -For information about how to disable warnings that are generated by checked iterators, see [_SCL_SECURE_NO_WARNINGS](../standard-library/scl-secure-no-warnings.md). +For information about how to disable warnings that are generated by checked iterators, see [`_SCL_SECURE_NO_WARNINGS`](../standard-library/scl-secure-no-warnings.md). -You can use the [\_ITERATOR\_DEBUG\_LEVEL](../standard-library/iterator-debug-level.md) preprocessor macro to enable or disable the checked iterators feature. If _ITERATOR_DEBUG_LEVEL is defined as 1 or 2, unsafe use of iterators causes a runtime error and the program is terminated. If defined as 0, checked iterators are disabled. By default, the value for _ITERATOR_DEBUG_LEVEL is 0 for release builds and 2 for debug builds. +You can use the [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md) preprocessor macro to enable or disable the checked iterators feature. If `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, unsafe use of iterators causes a runtime error and the program is terminated. If defined as 0, checked iterators are disabled. By default, the value for `_ITERATOR_DEBUG_LEVEL` is 0 for release builds and 2 for debug builds. > [!IMPORTANT] -> Older documentation and source code may refer to the [_SECURE_SCL](../standard-library/secure-scl.md) macro. Use _ITERATOR_DEBUG_LEVEL to control _SECURE_SCL. For more information, see [_ITERATOR_DEBUG_LEVEL](../standard-library/iterator-debug-level.md). +> Older documentation and source code may refer to the [`_SECURE_SCL`](../standard-library/secure-scl.md) macro. Use `_ITERATOR_DEBUG_LEVEL` to control `_SECURE_SCL`. For more information, see [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md). -When _ITERATOR_DEBUG_LEVEL is defined as 1 or 2, these iterator checks are performed: +When `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, these iterator checks are performed: -- All standard iterators (for example, [vector::iterator](../standard-library/vector-class.md#iterator)) are checked. +- All standard iterators (for example, [`vector::iterator`](../standard-library/vector-class.md#iterator)) are checked. -- If an output iterator is a checked iterator, calls to standard library functions such as [std::copy](../standard-library/algorithm-functions.md#copy) get checked behavior. +- If an output iterator is a checked iterator, calls to standard library functions such as [`std::copy`](../standard-library/algorithm-functions.md#copy) get checked behavior. - If an output iterator is an unchecked iterator, calls to standard library functions cause compiler warnings. @@ -50,7 +50,7 @@ When _ITERATOR_DEBUG_LEVEL is defined as 1 or 2, these iterator checks are perfo :::column-end::: :::row-end::: -When _ITERATOR_DEBUG_LEVEL is defined as 0: +When `_ITERATOR_DEBUG_LEVEL` is defined as 0: - All standard iterators are unchecked. Iterators can move beyond the container boundaries, which leads to undefined behavior. @@ -60,11 +60,11 @@ When _ITERATOR_DEBUG_LEVEL is defined as 0: A checked iterator refers to an iterator that calls `invalid_parameter_handler` if you attempt to move past the boundaries of the container. For more information about `invalid_parameter_handler`, see [Parameter Validation](../c-runtime-library/parameter-validation.md). -The iterator adaptors that support checked iterators are [checked_array_iterator Class](../standard-library/checked-array-iterator-class.md) and [unchecked_array_iterator Class](../standard-library/unchecked-array-iterator-class.md). +The iterator adaptors that support checked iterators are [`checked_array_iterator` Class](../standard-library/checked-array-iterator-class.md) and [`unchecked_array_iterator` Class](../standard-library/unchecked-array-iterator-class.md). ## Examples -When you compile by using _ITERATOR_DEBUG_LEVEL set to 1 or 2, a runtime error will occur if you attempt to access an element that is outside the bounds of the container by using the indexing operator of certain classes. +When you compile by using `_ITERATOR_DEBUG_LEVEL` set to 1 or 2, a runtime error will occur if you attempt to access an element that is outside the bounds of the container by using the indexing operator of certain classes. ```cpp // checked_iterators_1.cpp @@ -91,7 +91,7 @@ int main() This program prints "67" then pops up an assertion failure dialog box with additional information about the failure. -Similarly, when you compile by using _ITERATOR_DEBUG_LEVEL set to 1 or 2, a runtime error will occur if you attempt to access an element by using `front` or `back` in container classes when the container is empty. +Similarly, when you compile by using `_ITERATOR_DEBUG_LEVEL` set to 1 or 2, a runtime error will occur if you attempt to access an element by using `front` or `back` in container classes when the container is empty. ```cpp // checked_iterators_2.cpp @@ -113,7 +113,7 @@ int main() This program pops up an assertion failure dialog box with additional information about the failure. -The following code demonstrates various iterator use-case scenarios with comments about each. By default, _ITERATOR_DEBUG_LEVEL is set to 2 in Debug builds, and to 0 in Retail builds. +The following code demonstrates various iterator use-case scenarios with comments about each. By default, `_ITERATOR_DEBUG_LEVEL` is set to 2 in Debug builds, and to 0 in Retail builds. ```cpp // checked_iterators_3.cpp From 1754b6730154850d33f261115ee17387c4292ada Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 17:48:11 +0800 Subject: [PATCH 0276/1799] Simplify redundant relative links in "Checked Iterators" topic --- docs/standard-library/checked-iterators.md | 42 +++++++++++----------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/standard-library/checked-iterators.md b/docs/standard-library/checked-iterators.md index bc172529a6e..720a31e9c48 100644 --- a/docs/standard-library/checked-iterators.md +++ b/docs/standard-library/checked-iterators.md @@ -8,22 +8,22 @@ ms.assetid: cfc87df8-e3d9-403b-ab78-e9483247d940 --- # Checked Iterators -Checked iterators ensure that the bounds of your container are not overwritten. Checked iterators apply to both release builds and debug builds. For more information about how to use debug iterators when you compile in debug mode, see [Debug Iterator Support](../standard-library/debug-iterator-support.md). +Checked iterators ensure that the bounds of your container are not overwritten. Checked iterators apply to both release builds and debug builds. For more information about how to use debug iterators when you compile in debug mode, see [Debug Iterator Support](debug-iterator-support.md). ## Remarks -For information about how to disable warnings that are generated by checked iterators, see [`_SCL_SECURE_NO_WARNINGS`](../standard-library/scl-secure-no-warnings.md). +For information about how to disable warnings that are generated by checked iterators, see [`_SCL_SECURE_NO_WARNINGS`](scl-secure-no-warnings.md). -You can use the [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md) preprocessor macro to enable or disable the checked iterators feature. If `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, unsafe use of iterators causes a runtime error and the program is terminated. If defined as 0, checked iterators are disabled. By default, the value for `_ITERATOR_DEBUG_LEVEL` is 0 for release builds and 2 for debug builds. +You can use the [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md) preprocessor macro to enable or disable the checked iterators feature. If `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, unsafe use of iterators causes a runtime error and the program is terminated. If defined as 0, checked iterators are disabled. By default, the value for `_ITERATOR_DEBUG_LEVEL` is 0 for release builds and 2 for debug builds. > [!IMPORTANT] -> Older documentation and source code may refer to the [`_SECURE_SCL`](../standard-library/secure-scl.md) macro. Use `_ITERATOR_DEBUG_LEVEL` to control `_SECURE_SCL`. For more information, see [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md). +> Older documentation and source code may refer to the [`_SECURE_SCL`](secure-scl.md) macro. Use `_ITERATOR_DEBUG_LEVEL` to control `_SECURE_SCL`. For more information, see [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md). When `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, these iterator checks are performed: -- All standard iterators (for example, [`vector::iterator`](../standard-library/vector-class.md#iterator)) are checked. +- All standard iterators (for example, [`vector::iterator`](vector-class.md#iterator)) are checked. -- If an output iterator is a checked iterator, calls to standard library functions such as [`std::copy`](../standard-library/algorithm-functions.md#copy) get checked behavior. +- If an output iterator is a checked iterator, calls to standard library functions such as [`std::copy`](algorithm-functions.md#copy) get checked behavior. - If an output iterator is an unchecked iterator, calls to standard library functions cause compiler warnings. @@ -31,22 +31,22 @@ When `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, these iterator checks are per :::row::: :::column span=""::: -   [`basic_string::operator[]`](../standard-library/basic-string-class.md#op_at)\ -   [`bitset::operator[]`](../standard-library/bitset-class.md#op_at)\ -   [`deque::back`](../standard-library/deque-class.md#back)\ -   [`deque::front`](../standard-library/deque-class.md#front) +   [`basic_string::operator[]`](basic-string-class.md#op_at)\ +   [`bitset::operator[]`](bitset-class.md#op_at)\ +   [`deque::back`](deque-class.md#back)\ +   [`deque::front`](deque-class.md#front) :::column-end::: :::column span=""::: - [`deque::operator[]`](../standard-library/deque-class.md#op_at)\ - [`list::back`](../standard-library/list-class.md#back)\ - [`list::front`](../standard-library/list-class.md#front)\ - [`queue::back`](../standard-library/queue-class.md#back) + [`deque::operator[]`](deque-class.md#op_at)\ + [`list::back`](list-class.md#back)\ + [`list::front`](list-class.md#front)\ + [`queue::back`](queue-class.md#back) :::column-end::: :::column span=""::: - [`queue::front`](../standard-library/queue-class.md#front)\ - [`vector::back`](../standard-library/vector-class.md#back)\ - [`vector::front`](../standard-library/vector-class.md#front)\ - [`vector::operator[]`](../standard-library/vector-class.md#op_at) + [`queue::front`](queue-class.md#front)\ + [`vector::back`](vector-class.md#back)\ + [`vector::front`](vector-class.md#front)\ + [`vector::operator[]`](vector-class.md#op_at) :::column-end::: :::row-end::: @@ -60,7 +60,7 @@ When `_ITERATOR_DEBUG_LEVEL` is defined as 0: A checked iterator refers to an iterator that calls `invalid_parameter_handler` if you attempt to move past the boundaries of the container. For more information about `invalid_parameter_handler`, see [Parameter Validation](../c-runtime-library/parameter-validation.md). -The iterator adaptors that support checked iterators are [`checked_array_iterator` Class](../standard-library/checked-array-iterator-class.md) and [`unchecked_array_iterator` Class](../standard-library/unchecked-array-iterator-class.md). +The iterator adaptors that support checked iterators are [`checked_array_iterator` Class](checked-array-iterator-class.md) and [`unchecked_array_iterator` Class](unchecked-array-iterator-class.md). ## Examples @@ -219,5 +219,5 @@ a8: 0 8 16 24 32 40 48 56 64 72 80 88 96 104 112 120 ## See also -[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)\ -[Debug Iterator Support](../standard-library/debug-iterator-support.md) +[C++ Standard Library Overview](cpp-standard-library-overview.md)\ +[Debug Iterator Support](debug-iterator-support.md) From 0e14e7846e6f2d5088f231ea3f0c9e9f818ddae1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 17:49:42 +0800 Subject: [PATCH 0277/1799] Remove ` `s that cause misalignment in "Checked Iterators" topic --- docs/standard-library/checked-iterators.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/checked-iterators.md b/docs/standard-library/checked-iterators.md index 720a31e9c48..7d9424f97df 100644 --- a/docs/standard-library/checked-iterators.md +++ b/docs/standard-library/checked-iterators.md @@ -31,10 +31,10 @@ When `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, these iterator checks are per :::row::: :::column span=""::: -   [`basic_string::operator[]`](basic-string-class.md#op_at)\ -   [`bitset::operator[]`](bitset-class.md#op_at)\ -   [`deque::back`](deque-class.md#back)\ -   [`deque::front`](deque-class.md#front) + [`basic_string::operator[]`](basic-string-class.md#op_at)\ + [`bitset::operator[]`](bitset-class.md#op_at)\ + [`deque::back`](deque-class.md#back)\ + [`deque::front`](deque-class.md#front) :::column-end::: :::column span=""::: [`deque::operator[]`](deque-class.md#op_at)\ From 318cfcde91b0cf7575692604920fef953702d3d5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 17:52:59 +0800 Subject: [PATCH 0278/1799] Format code examples in "Checked Iterators" topic --- docs/standard-library/checked-iterators.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/standard-library/checked-iterators.md b/docs/standard-library/checked-iterators.md index 7d9424f97df..87e84b77ada 100644 --- a/docs/standard-library/checked-iterators.md +++ b/docs/standard-library/checked-iterators.md @@ -79,13 +79,13 @@ using namespace std; int main() { - vector v; - v.push_back(67); + vector v; + v.push_back(67); - int i = v[0]; - cout << i << endl; + int i = v[0]; + cout << i << endl; - i = v[1]; //triggers invalid parameter handler + i = v[1]; //triggers invalid parameter handler } ``` @@ -105,9 +105,9 @@ using namespace std; int main() { - vector v; + vector v; - int& i = v.front(); // triggers invalid parameter handler + int& i = v.front(); // triggers invalid parameter handler } ``` @@ -134,7 +134,8 @@ void print(const string& s, const C& c) { cout << s; - for (const auto& e : c) { + for (const auto& e : c) + { cout << e << " "; } From e019788a9e5ab1f1caa10e16fd0029a028e6fc7d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 17:53:21 +0800 Subject: [PATCH 0279/1799] Update metadata in "Checked Iterators" topic --- docs/standard-library/checked-iterators.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/checked-iterators.md b/docs/standard-library/checked-iterators.md index 87e84b77ada..3022398c426 100644 --- a/docs/standard-library/checked-iterators.md +++ b/docs/standard-library/checked-iterators.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Checked Iterators" title: "Checked Iterators" -ms.date: "11/04/2016" +description: "Learn more about: Checked Iterators" +ms.date: 11/04/2016 f1_keywords: ["_SECURE_SCL_THROWS"] helpviewer_keywords: ["Safe Libraries", "Safe Libraries, C++ Standard Library", "Safe C++ Standard Library", "iterators, checked", "checked iterators"] -ms.assetid: cfc87df8-e3d9-403b-ab78-e9483247d940 --- # Checked Iterators From e45c117a33063aafc6ed47391478f249cf8b4d1b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 18:26:12 +0800 Subject: [PATCH 0280/1799] Address more mistakes with italic inline code --- docs/atl-mfc-shared/reference/cimage-class.md | 2 +- docs/build/cmake-projects-in-visual-studio.md | 2 +- docs/mfc/reference/ccombobox-class.md | 2 +- docs/mfc/reference/cdc-class.md | 2 +- docs/mfc/reference/cwnd-class.md | 6 +++--- docs/standard-library/weekday-class.md | 4 ++-- 6 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/atl-mfc-shared/reference/cimage-class.md b/docs/atl-mfc-shared/reference/cimage-class.md index 0dd78992509..e19b105c7f8 100644 --- a/docs/atl-mfc-shared/reference/cimage-class.md +++ b/docs/atl-mfc-shared/reference/cimage-class.md @@ -745,7 +745,7 @@ static HRESULT GetImporterFilterString( A reference to a `CSimpleString` object. See **Remarks** for more information. *`aguidFileTypes`*
-An array of GUIDs, with each element corresponding to one of the file types in the string. In the example in *`pszAllFilesDescription`* below, *`aguidFileTypes[0]*` is `GUID_NULL` with the remaining array values are the image file formats supported by the current operating system. +An array of GUIDs, with each element corresponding to one of the file types in the string. In the example in *`pszAllFilesDescription`* below, *`aguidFileTypes[0]`* is `GUID_NULL` with the remaining array values are the image file formats supported by the current operating system. > [!NOTE] > For a complete list of constants, see **Image File Format Constants** in the Windows SDK. diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index a164d943fe8..69b1bc18eeb 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -330,7 +330,7 @@ Not everything in the cache is imported. Properties such as the generator and th :::image type="content" source="media/cmake-import-wizard.png" alt-text="Screenshot of the Import C Make Project from Cache wizard. The directory path of the C Make project to import goes in the folder textbox."::: - When the wizard completes, you can see the new *`CMakeCache.txt`* file in **Solution Explorer** next to the root *`CMakeLists.txt*` file in your project. + When the wizard completes, you can see the new *`CMakeCache.txt`* file in **Solution Explorer** next to the root *`CMakeLists.txt`* file in your project. ## Building CMake projects diff --git a/docs/mfc/reference/ccombobox-class.md b/docs/mfc/reference/ccombobox-class.md index 02046d4a906..308777835f2 100644 --- a/docs/mfc/reference/ccombobox-class.md +++ b/docs/mfc/reference/ccombobox-class.md @@ -515,7 +515,7 @@ BOOL GetComboBoxInfo(PCOMBOBOXINFO pcbi) const; ### Parameters -*`pcbi*
+*`pcbi`*
A pointer to the [`COMBOBOXINFO`](/windows/win32/api/winuser/ns-winuser-comboboxinfo) structure. ### Return Value diff --git a/docs/mfc/reference/cdc-class.md b/docs/mfc/reference/cdc-class.md index 04f399f5b24..1c72d7d3974 100644 --- a/docs/mfc/reference/cdc-class.md +++ b/docs/mfc/reference/cdc-class.md @@ -590,7 +590,7 @@ Nonzero if the function is successful; otherwise 0. ### Remarks -This function is similar to `CDC::Arc`, except that the current position is updated. The points ( *`x1`*, *`y1`*) and ( *`x2`*, *`y2`*) specify the bounding rectangle. An ellipse formed by the given bounding rectangle defines the curve of the arc. The arc extends counterclockwise (the default arc direction) from the point where it intersects the radial line from the center of the bounding rectangle to ( *`x3*`, *`y3`*). The arc ends where it intersects the radial line from the center of the bounding rectangle to ( *`x4`*, *`y4`*). If the starting point and ending point are the same, a complete ellipse is drawn. +This function is similar to `CDC::Arc`, except that the current position is updated. The points ( *`x1`*, *`y1`*) and ( *`x2`*, *`y2`*) specify the bounding rectangle. An ellipse formed by the given bounding rectangle defines the curve of the arc. The arc extends counterclockwise (the default arc direction) from the point where it intersects the radial line from the center of the bounding rectangle to ( *`x3`*, *`y3`*). The arc ends where it intersects the radial line from the center of the bounding rectangle to ( *`x4`*, *`y4`*). If the starting point and ending point are the same, a complete ellipse is drawn. A line is drawn from the current position to the starting point of the arc. If no error occurs, the current position is set to the ending point of the arc. The arc is drawn using the current pen; it isn't filled. diff --git a/docs/mfc/reference/cwnd-class.md b/docs/mfc/reference/cwnd-class.md index 7465c5223ed..0500d32c28b 100644 --- a/docs/mfc/reference/cwnd-class.md +++ b/docs/mfc/reference/cwnd-class.md @@ -1245,7 +1245,7 @@ Points to a [`POINT` structure](/windows/win32/api/windef/ns-windef-point) or `C *`pSize`*
Points to a [`SIZE`](/windows/win32/api/windef/ns-windef-size) structure or `CSize` object that contains the control's size -*`pParentWnd*`
+*`pParentWnd`*
Specifies the control's parent window. It must not be `NULL`. *`nID`*
@@ -2319,7 +2319,7 @@ BOOL FlashWindowEx( ### Parameters -*`dwFlags*`
+*`dwFlags`*
Specifies the flash status. For a complete list of values, see the [`FLASHWINFO`](/windows/win32/api/winuser/ns-winuser-flashwinfo) structure. *`uCount`*
@@ -4107,7 +4107,7 @@ CWnd* GetWindow(UINT nCmd) const; ### Parameters -*`nCmd*`
+*`nCmd`*
Specifies the relationship between `CWnd` and the returned window. It can take one of the following values: - `GW_CHILD` Identifies the `CWnd` first child window. diff --git a/docs/standard-library/weekday-class.md b/docs/standard-library/weekday-class.md index 5e4e5b34ee8..8088e3b8b66 100644 --- a/docs/standard-library/weekday-class.md +++ b/docs/standard-library/weekday-class.md @@ -238,7 +238,7 @@ constexpr weekday& operator+=(const days& d) noexcept; ### Parameters -`*d*`\ +*`d`*\ The number of days to add. ### Return value @@ -255,7 +255,7 @@ constexpr weekday& operator-=(const days& d) noexcept; ### Parameters -`*d*`\ +*`d`*\ The number of days to subtract. ### Return value From 632d2468bebd5c89b4078e492de9b1d71973be5e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 18:27:52 +0800 Subject: [PATCH 0281/1799] Update metadata in 3 topics --- docs/atl-mfc-shared/reference/cimage-class.md | 5 ++--- docs/mfc/reference/ccombobox-class.md | 3 +-- docs/mfc/reference/cwnd-class.md | 4 ++-- 3 files changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/atl-mfc-shared/reference/cimage-class.md b/docs/atl-mfc-shared/reference/cimage-class.md index e19b105c7f8..d355d0f27a4 100644 --- a/docs/atl-mfc-shared/reference/cimage-class.md +++ b/docs/atl-mfc-shared/reference/cimage-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CImage Class" title: "CImage Class" -ms.date: "08/19/2019" +description: "Learn more about: CImage Class" +ms.date: 08/19/2019 f1_keywords: ["CImage", "ATLIMAGE/ATL::CImage", "ATLIMAGE/ATL::CImage::CImage", "ATLIMAGE/ATL::CImage::AlphaBlend", "ATLIMAGE/ATL::CImage::Attach", "ATLIMAGE/ATL::CImage::BitBlt", "ATLIMAGE/ATL::CImage::Create", "ATLIMAGE/ATL::CImage::CreateEx", "ATLIMAGE/ATL::CImage::Destroy", "ATLIMAGE/ATL::CImage::Detach", "ATLIMAGE/ATL::CImage::Draw", "ATLIMAGE/ATL::CImage::GetBits", "ATLIMAGE/ATL::CImage::GetBPP", "ATLIMAGE/ATL::CImage::GetColorTable", "ATLIMAGE/ATL::CImage::GetDC", "ATLIMAGE/ATL::CImage::GetExporterFilterString", "ATLIMAGE/ATL::CImage::GetHeight", "ATLIMAGE/ATL::CImage::GetImporterFilterString", "ATLIMAGE/ATL::CImage::GetMaxColorTableEntries", "ATLIMAGE/ATL::CImage::GetPitch", "ATLIMAGE/ATL::CImage::GetPixel", "ATLIMAGE/ATL::CImage::GetPixelAddress", "ATLIMAGE/ATL::CImage::GetTransparentColor", "ATLIMAGE/ATL::CImage::GetWidth", "ATLIMAGE/ATL::CImage::IsDIBSection", "ATLIMAGE/ATL::CImage::IsIndexed", "ATLIMAGE/ATL::CImage::IsNull", "ATLIMAGE/ATL::CImage::IsTransparencySupported", "ATLIMAGE/ATL::CImage::Load", "ATLIMAGE/ATL::CImage::LoadFromResource", "ATLIMAGE/ATL::CImage::MaskBlt", "ATLIMAGE/ATL::CImage::PlgBlt", "ATLIMAGE/ATL::CImage::ReleaseDC", "ATLIMAGE/ATL::CImage::ReleaseGDIPlus", "ATLIMAGE/ATL::CImage::Save", "ATLIMAGE/ATL::CImage::SetColorTable", "ATLIMAGE/ATL::CImage::SetPixel", "ATLIMAGE/ATL::CImage::SetPixelIndexed", "ATLIMAGE/ATL::CImage::SetPixelRGB", "ATLIMAGE/ATL::CImage::SetTransparentColor", "ATLIMAGE/ATL::CImage::StretchBlt", "ATLIMAGE/ATL::CImage::TransparentBlt"] helpviewer_keywords: ["jpeg files", "bitmaps [C++], ATL and MFC support for", "images [C++], ATL and MFC support for", "gif files, ATL and MFC support", ".gif files, ATL and MFC support", "PNG files, ATL and MFC support", "CImage class", "transparent color"] -ms.assetid: 52861e3d-bf7e-481f-a240-90e88f76c490 --- # `CImage` Class diff --git a/docs/mfc/reference/ccombobox-class.md b/docs/mfc/reference/ccombobox-class.md index 308777835f2..ca740d929f8 100644 --- a/docs/mfc/reference/ccombobox-class.md +++ b/docs/mfc/reference/ccombobox-class.md @@ -1,10 +1,9 @@ --- title: "CComboBox Class" description: "API reference for the MFC Windows combo box class CComboBox" -ms.date: "08/27/2020" +ms.date: 08/27/2020 f1_keywords: ["CComboBox", "AFXWIN/CComboBox", "AFXWIN/CComboBox::CComboBox", "AFXWIN/CComboBox::AddString", "AFXWIN/CComboBox::Clear", "AFXWIN/CComboBox::CompareItem", "AFXWIN/CComboBox::Copy", "AFXWIN/CComboBox::Create", "AFXWIN/CComboBox::Cut", "AFXWIN/CComboBox::DeleteItem", "AFXWIN/CComboBox::DeleteString", "AFXWIN/CComboBox::Dir", "AFXWIN/CComboBox::DrawItem", "AFXWIN/CComboBox::FindString", "AFXWIN/CComboBox::FindStringExact", "AFXWIN/CComboBox::GetComboBoxInfo", "AFXWIN/CComboBox::GetCount", "AFXWIN/CComboBox::GetCueBanner", "AFXWIN/CComboBox::GetCurSel", "AFXWIN/CComboBox::GetDroppedControlRect", "AFXWIN/CComboBox::GetDroppedState", "AFXWIN/CComboBox::GetDroppedWidth", "AFXWIN/CComboBox::GetEditSel", "AFXWIN/CComboBox::GetExtendedUI", "AFXWIN/CComboBox::GetHorizontalExtent", "AFXWIN/CComboBox::GetItemData", "AFXWIN/CComboBox::GetItemDataPtr", "AFXWIN/CComboBox::GetItemHeight", "AFXWIN/CComboBox::GetLBText", "AFXWIN/CComboBox::GetLBTextLen", "AFXWIN/CComboBox::GetLocale", "AFXWIN/CComboBox::GetMinVisible", "AFXWIN/CComboBox::GetTopIndex", "AFXWIN/CComboBox::InitStorage", "AFXWIN/CComboBox::InsertString", "AFXWIN/CComboBox::LimitText", "AFXWIN/CComboBox::MeasureItem", "AFXWIN/CComboBox::Paste", "AFXWIN/CComboBox::ResetContent", "AFXWIN/CComboBox::SelectString", "AFXWIN/CComboBox::SetCueBanner", "AFXWIN/CComboBox::SetCurSel", "AFXWIN/CComboBox::SetDroppedWidth", "AFXWIN/CComboBox::SetEditSel", "AFXWIN/CComboBox::SetExtendedUI", "AFXWIN/CComboBox::SetHorizontalExtent", "AFXWIN/CComboBox::SetItemData", "AFXWIN/CComboBox::SetItemDataPtr", "AFXWIN/CComboBox::SetItemHeight", "AFXWIN/CComboBox::SetLocale", "AFXWIN/CComboBox::SetMinVisibleItems", "AFXWIN/CComboBox::SetTopIndex", "AFXWIN/CComboBox::ShowDropDown"] helpviewer_keywords: ["CComboBox [MFC], CComboBox", "CComboBox [MFC], AddString", "CComboBox [MFC], Clear", "CComboBox [MFC], CompareItem", "CComboBox [MFC], Copy", "CComboBox [MFC], Create", "CComboBox [MFC], Cut", "CComboBox [MFC], DeleteItem", "CComboBox [MFC], DeleteString", "CComboBox [MFC], Dir", "CComboBox [MFC], DrawItem", "CComboBox [MFC], FindString", "CComboBox [MFC], FindStringExact", "CComboBox [MFC], GetComboBoxInfo", "CComboBox [MFC], GetCount", "CComboBox [MFC], GetCueBanner", "CComboBox [MFC], GetCurSel", "CComboBox [MFC], GetDroppedControlRect", "CComboBox [MFC], GetDroppedState", "CComboBox [MFC], GetDroppedWidth", "CComboBox [MFC], GetEditSel", "CComboBox [MFC], GetExtendedUI", "CComboBox [MFC], GetHorizontalExtent", "CComboBox [MFC], GetItemData", "CComboBox [MFC], GetItemDataPtr", "CComboBox [MFC], GetItemHeight", "CComboBox [MFC], GetLBText", "CComboBox [MFC], GetLBTextLen", "CComboBox [MFC], GetLocale", "CComboBox [MFC], GetMinVisible", "CComboBox [MFC], GetTopIndex", "CComboBox [MFC], InitStorage", "CComboBox [MFC], InsertString", "CComboBox [MFC], LimitText", "CComboBox [MFC], MeasureItem", "CComboBox [MFC], Paste", "CComboBox [MFC], ResetContent", "CComboBox [MFC], SelectString", "CComboBox [MFC], SetCueBanner", "CComboBox [MFC], SetCurSel", "CComboBox [MFC], SetDroppedWidth", "CComboBox [MFC], SetEditSel", "CComboBox [MFC], SetExtendedUI", "CComboBox [MFC], SetHorizontalExtent", "CComboBox [MFC], SetItemData", "CComboBox [MFC], SetItemDataPtr", "CComboBox [MFC], SetItemHeight", "CComboBox [MFC], SetLocale", "CComboBox [MFC], SetMinVisibleItems", "CComboBox [MFC], SetTopIndex", "CComboBox [MFC], ShowDropDown"] -ms.assetid: 4e73b5df-0d2e-4658-9706-38133fb10513 --- # `CComboBox` Class diff --git a/docs/mfc/reference/cwnd-class.md b/docs/mfc/reference/cwnd-class.md index 0500d32c28b..215c54a398a 100644 --- a/docs/mfc/reference/cwnd-class.md +++ b/docs/mfc/reference/cwnd-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CWnd Class" title: "CWnd Class" -ms.date: "8/25/2021" +description: "Learn more about: CWnd Class" +ms.date: 8/25/2021 f1_keywords: ["CWnd", "AFXWIN/CWnd", "AFXWIN/CWnd::CWnd", "AFXWIN/CWnd::accDoDefaultAction", "AFXWIN/CWnd::accHitTest", "AFXWIN/CWnd::accLocation", "AFXWIN/CWnd::accNavigate", "AFXWIN/CWnd::accSelect", "AFXWIN/CWnd::AnimateWindow", "AFXWIN/CWnd::ArrangeIconicWindows", "AFXWIN/CWnd::Attach", "AFXWIN/CWnd::BeginModalState", "AFXWIN/CWnd::BeginPaint", "AFXWIN/CWnd::BindDefaultProperty", "AFXWIN/CWnd::BindProperty", "AFXWIN/CWnd::BringWindowToTop", "AFXWIN/CWnd::CalcWindowRect", "AFXWIN/CWnd::CancelToolTips", "AFXWIN/CWnd::CenterWindow", "AFXWIN/CWnd::ChangeClipboardChain", "AFXWIN/CWnd::CheckDlgButton", "AFXWIN/CWnd::CheckRadioButton", "AFXWIN/CWnd::ChildWindowFromPoint", "AFXWIN/CWnd::ClientToScreen", "AFXWIN/CWnd::CloseWindow", "AFXWIN/CWnd::ContinueModal", "AFXWIN/CWnd::Create", "AFXWIN/CWnd::CreateAccessibleProxy", "AFXWIN/CWnd::CreateCaret", "AFXWIN/CWnd::CreateControl", "AFXWIN/CWnd::CreateEx", "AFXWIN/CWnd::CreateGrayCaret", "AFXWIN/CWnd::CreateSolidCaret", "AFXWIN/CWnd::DeleteTempMap", "AFXWIN/CWnd::DestroyWindow", "AFXWIN/CWnd::Detach", "AFXWIN/CWnd::DlgDirList", "AFXWIN/CWnd::DlgDirListComboBox", "AFXWIN/CWnd::DlgDirSelect", "AFXWIN/CWnd::DlgDirSelectComboBox", "AFXWIN/CWnd::DragAcceptFiles", "AFXWIN/CWnd::DragDetect", "AFXWIN/CWnd::DrawAnimatedRects", "AFXWIN/CWnd::DrawCaption", "AFXWIN/CWnd::DrawMenuBar", "AFXWIN/CWnd::EnableActiveAccessibility", "AFXWIN/CWnd::EnableDynamicLayout", "AFXWIN/CWnd::EnableD2DSupport", "AFXWIN/CWnd::EnableScrollBar", "AFXWIN/CWnd::EnableScrollBarCtrl", "AFXWIN/CWnd::EnableToolTips", "AFXWIN/CWnd::EnableTrackingToolTips", "AFXWIN/CWnd::EnableWindow", "AFXWIN/CWnd::EndModalLoop", "AFXWIN/CWnd::EndModalState", "AFXWIN/CWnd::EndPaint", "AFXWIN/CWnd::ExecuteDlgInit", "AFXWIN/CWnd::FilterToolTipMessage", "AFXWIN/CWnd::FindWindow", "AFXWIN/CWnd::FindWindowEx", "AFXWIN/CWnd::FlashWindow", "AFXWIN/CWnd::FlashWindowEx", "AFXWIN/CWnd::FromHandle", "AFXWIN/CWnd::FromHandlePermanent", "AFXWIN/CWnd::get_accChild", "AFXWIN/CWnd::get_accChildCount", "AFXWIN/CWnd::get_accDefaultAction", "AFXWIN/CWnd::get_accDescription", "AFXWIN/CWnd::get_accFocus", "AFXWIN/CWnd::get_accHelp", "AFXWIN/CWnd::get_accHelpTopic", "AFXWIN/CWnd::get_accKeyboardShortcut", "AFXWIN/CWnd::get_accName", "AFXWIN/CWnd::get_accParent", "AFXWIN/CWnd::get_accRole", "AFXWIN/CWnd::get_accSelection", "AFXWIN/CWnd::get_accState", "AFXWIN/CWnd::get_accValue", "AFXWIN/CWnd::GetActiveWindow", "AFXWIN/CWnd::GetAncestor", "AFXWIN/CWnd::GetCapture", "AFXWIN/CWnd::GetCaretPos", "AFXWIN/CWnd::GetCheckedRadioButton", "AFXWIN/CWnd::GetClientRect", "AFXWIN/CWnd::GetClipboardOwner", "AFXWIN/CWnd::GetClipboardViewer", "AFXWIN/CWnd::GetControlUnknown", "AFXWIN/CWnd::GetDC", "AFXWIN/CWnd::GetDCEx", "AFXWIN/CWnd::GetDCRenderTarget", "AFXWIN/CWnd::GetDescendantWindow", "AFXWIN/CWnd::GetDesktopWindow", "AFXWIN/CWnd::GetDlgCtrlID", "AFXWIN/CWnd::GetDlgItem", "AFXWIN/CWnd::GetDlgItemInt", "AFXWIN/CWnd::GetDlgItemText", "AFXWIN/CWnd::GetDSCCursor", "AFXWIN/CWnd::GetDynamicLayout", "AFXWIN/CWnd::GetExStyle", "AFXWIN/CWnd::GetFocus", "AFXWIN/CWnd::GetFont", "AFXWIN/CWnd::GetForegroundWindow", "AFXWIN/CWnd::GetIcon", "AFXWIN/CWnd::GetLastActivePopup", "AFXWIN/CWnd::GetLayeredWindowAttributes", "AFXWIN/CWnd::GetMenu", "AFXWIN/CWnd::GetNextDlgGroupItem", "AFXWIN/CWnd::GetNextDlgTabItem", "AFXWIN/CWnd::GetNextWindow", "AFXWIN/CWnd::GetOleControlSite", "AFXWIN/CWnd::GetOpenClipboardWindow", "AFXWIN/CWnd::GetOwner", "AFXWIN/CWnd::GetParent", "AFXWIN/CWnd::GetParentFrame", "AFXWIN/CWnd::GetParentOwner", "AFXWIN/CWnd::GetProperty", "AFXWIN/CWnd::GetRenderTarget", "AFXWIN/CWnd::GetSafeHwnd", "AFXWIN/CWnd::GetSafeOwner", "AFXWIN/CWnd::GetScrollBarCtrl", "AFXWIN/CWnd::GetScrollBarInfo", "AFXWIN/CWnd::GetScrollInfo", "AFXWIN/CWnd::GetScrollLimit", "AFXWIN/CWnd::GetScrollPos", "AFXWIN/CWnd::GetScrollRange", "AFXWIN/CWnd::GetStyle", "AFXWIN/CWnd::GetSystemMenu", "AFXWIN/CWnd::GetTitleBarInfo", "AFXWIN/CWnd::GetTopLevelFrame", "AFXWIN/CWnd::GetTopLevelOwner", "AFXWIN/CWnd::GetTopLevelParent", "AFXWIN/CWnd::GetTopWindow", "AFXWIN/CWnd::GetUpdateRect", "AFXWIN/CWnd::GetUpdateRgn", "AFXWIN/CWnd::GetWindow", "AFXWIN/CWnd::GetWindowContextHelpId", "AFXWIN/CWnd::GetWindowDC", "AFXWIN/CWnd::GetWindowedChildCount", "AFXWIN/CWnd::GetWindowInfo", "AFXWIN/CWnd::GetWindowlessChildCount", "AFXWIN/CWnd::GetWindowPlacement", "AFXWIN/CWnd::GetWindowRect", "AFXWIN/CWnd::GetWindowRgn", "AFXWIN/CWnd::GetWindowText", "AFXWIN/CWnd::GetWindowTextLength", "AFXWIN/CWnd::HideCaret", "AFXWIN/CWnd::HiliteMenuItem", "AFXWIN/CWnd::HtmlHelp", "AFXWIN/CWnd::Invalidate", "AFXWIN/CWnd::InvalidateRect", "AFXWIN/CWnd::InvalidateRgn", "AFXWIN/CWnd::InvokeHelper", "AFXWIN/CWnd::IsChild", "AFXWIN/CWnd::IsD2DSupportEnabled", "AFXWIN/CWnd::IsDialogMessage", "AFXWIN/CWnd::IsDlgButtonChecked", "AFXWIN/CWnd::IsDynamicLayoutEnabled", "AFXWIN/CWnd::IsIconic", "AFXWIN/CWnd::IsTouchWindow", "AFXWIN/CWnd::IsWindowEnabled", "AFXWIN/CWnd::IsWindowVisible", "AFXWIN/CWnd::IsZoomed", "AFXWIN/CWnd::KillTimer", "AFXWIN/CWnd::LockWindowUpdate", "AFXWIN/CWnd::MapWindowPoints", "AFXWIN/CWnd::MessageBox", "AFXWIN/CWnd::ModifyStyle", "AFXWIN/CWnd::ModifyStyleEx", "AFXWIN/CWnd::MoveWindow", "AFXWIN/CWnd::NotifyWinEvent", "AFXWIN/CWnd::OnAmbientProperty", "AFXWIN/CWnd::OnDrawIconicThumbnailOrLivePreview", "AFXWIN/CWnd::OnHelp", "AFXWIN/CWnd::OnHelpFinder", "AFXWIN/CWnd::OnHelpIndex", "AFXWIN/CWnd::OnHelpUsing", "AFXWIN/CWnd::OnToolHitTest", "AFXWIN/CWnd::OpenClipboard", "AFXWIN/CWnd::PaintWindowlessControls", "AFXWIN/CWnd::PostMessage", "AFXWIN/CWnd::PreCreateWindow", "AFXWIN/CWnd::PreSubclassWindow", "AFXWIN/CWnd::PreTranslateMessage", "AFXWIN/CWnd::Print", "AFXWIN/CWnd::PrintClient", "AFXWIN/CWnd::PrintWindow", "AFXWIN/CWnd::RedrawWindow", "AFXWIN/CWnd::RegisterTouchWindow", "AFXWIN/CWnd::ReleaseDC", "AFXWIN/CWnd::RepositionBars", "AFXWIN/CWnd::RunModalLoop", "AFXWIN/CWnd::ScreenToClient", "AFXWIN/CWnd::ScrollWindow", "AFXWIN/CWnd::ScrollWindowEx", "AFXWIN/CWnd::SendChildNotifyLastMsg", "AFXWIN/CWnd::SendDlgItemMessage", "AFXWIN/CWnd::SendMessage", "AFXWIN/CWnd::SendMessageToDescendants", "AFXWIN/CWnd::SendNotifyMessage", "AFXWIN/CWnd::SetActiveWindow", "AFXWIN/CWnd::SetCapture", "AFXWIN/CWnd::SetCaretPos", "AFXWIN/CWnd::SetClipboardViewer", "AFXWIN/CWnd::SetDlgCtrlID", "AFXWIN/CWnd::SetDlgItemInt", "AFXWIN/CWnd::SetDlgItemText", "AFXWIN/CWnd::SetFocus", "AFXWIN/CWnd::SetFont", "AFXWIN/CWnd::SetForegroundWindow", "AFXWIN/CWnd::SetIcon", "AFXWIN/CWnd::SetLayeredWindowAttributes", "AFXWIN/CWnd::SetMenu", "AFXWIN/CWnd::SetOwner", "AFXWIN/CWnd::SetParent", "AFXWIN/CWnd::SetProperty", "AFXWIN/CWnd::SetRedraw", "AFXWIN/CWnd::SetScrollInfo", "AFXWIN/CWnd::SetScrollPos", "AFXWIN/CWnd::SetScrollRange", "AFXWIN/CWnd::SetTimer", "AFXWIN/CWnd::SetWindowContextHelpId", "AFXWIN/CWnd::SetWindowPlacement", "AFXWIN/CWnd::SetWindowPos", "AFXWIN/CWnd::SetWindowRgn", "AFXWIN/CWnd::SetWindowText", "AFXWIN/CWnd::ShowCaret", "AFXWIN/CWnd::ShowOwnedPopups", "AFXWIN/CWnd::ShowScrollBar", "AFXWIN/CWnd::ShowWindow", "AFXWIN/CWnd::SubclassDlgItem", "AFXWIN/CWnd::SubclassWindow", "AFXWIN/CWnd::UnlockWindowUpdate", "AFXWIN/CWnd::UnsubclassWindow", "AFXWIN/CWnd::UpdateData", "AFXWIN/CWnd::UpdateDialogControls", "AFXWIN/CWnd::UpdateLayeredWindow", "AFXWIN/CWnd::UpdateWindow", "AFXWIN/CWnd::ValidateRect", "AFXWIN/CWnd::ValidateRgn", "AFXWIN/CWnd::WindowFromPoint", "AFXWIN/CWnd::WinHelp", "AFXWIN/CWnd::Default", "AFXWIN/CWnd::DefWindowProc", "AFXWIN/CWnd::DoDataExchange", "AFXWIN/CWnd::GetCurrentMessage", "AFXWIN/CWnd::InitDynamicLayout", "AFXWIN/CWnd::LoadDynamicLayoutResource", "AFXWIN/CWnd::OnActivate", "AFXWIN/CWnd::OnActivateApp", "AFXWIN/CWnd::OnAppCommand", "AFXWIN/CWnd::OnAskCbFormatName", "AFXWIN/CWnd::OnCancelMode", "AFXWIN/CWnd::OnCaptureChanged", "AFXWIN/CWnd::OnChangeCbChain", "AFXWIN/CWnd::OnChangeUIState", "AFXWIN/CWnd::OnChar", "AFXWIN/CWnd::OnCharToItem", "AFXWIN/CWnd::OnChildActivate", "AFXWIN/CWnd::OnChildNotify", "AFXWIN/CWnd::OnClipboardUpdate", "AFXWIN/CWnd::OnClose", "AFXWIN/CWnd::OnColorizationColorChanged", "AFXWIN/CWnd::OnCommand", "AFXWIN/CWnd::OnCompacting", "AFXWIN/CWnd::OnCompareItem", "AFXWIN/CWnd::OnCompositionChanged", "AFXWIN/CWnd::OnContextMenu", "AFXWIN/CWnd::OnCopyData", "AFXWIN/CWnd::OnCreate", "AFXWIN/CWnd::OnCtlColor", "AFXWIN/CWnd::OnDeadChar", "AFXWIN/CWnd::OnDeleteItem", "AFXWIN/CWnd::OnDestroy", "AFXWIN/CWnd::OnDestroyClipboard", "AFXWIN/CWnd::OnDeviceChange", "AFXWIN/CWnd::OnDevModeChange", "AFXWIN/CWnd::OnDrawClipboard", "AFXWIN/CWnd::OnDrawItem", "AFXWIN/CWnd::OnDropFiles", "AFXWIN/CWnd::OnEnable", "AFXWIN/CWnd::OnEndSession", "AFXWIN/CWnd::OnEnterIdle", "AFXWIN/CWnd::OnEnterMenuLoop", "AFXWIN/CWnd::OnEnterSizeMove", "AFXWIN/CWnd::OnEraseBkgnd", "AFXWIN/CWnd::OnExitMenuLoop", "AFXWIN/CWnd::OnExitSizeMove", "AFXWIN/CWnd::OnFontChange", "AFXWIN/CWnd::OnGetDlgCode", "AFXWIN/CWnd::OnGetMinMaxInfo", "AFXWIN/CWnd::OnHelpInfo", "AFXWIN/CWnd::OnHotKey", "AFXWIN/CWnd::OnHScroll", "AFXWIN/CWnd::OnHScrollClipboard", "AFXWIN/CWnd::OnIconEraseBkgnd", "AFXWIN/CWnd::OnInitMenu", "AFXWIN/CWnd::OnInitMenuPopup", "AFXWIN/CWnd::OnInputDeviceChange", "AFXWIN/CWnd::OnInputLangChange", "AFXWIN/CWnd::OnInputLangChangeRequest", "AFXWIN/CWnd::OnKeyDown", "AFXWIN/CWnd::OnKeyUp", "AFXWIN/CWnd::OnKillFocus", "AFXWIN/CWnd::OnLButtonDblClk", "AFXWIN/CWnd::OnLButtonDown", "AFXWIN/CWnd::OnLButtonUp", "AFXWIN/CWnd::OnMButtonDblClk", "AFXWIN/CWnd::OnMButtonDown", "AFXWIN/CWnd::OnMButtonUp", "AFXWIN/CWnd::OnMDIActivate", "AFXWIN/CWnd::OnMeasureItem", "AFXWIN/CWnd::OnMenuChar", "AFXWIN/CWnd::OnMenuDrag", "AFXWIN/CWnd::OnMenuGetObject", "AFXWIN/CWnd::OnMenuRButtonUp", "AFXWIN/CWnd::OnMenuSelect", "AFXWIN/CWnd::OnMouseActivate", "AFXWIN/CWnd::OnMouseHover", "AFXWIN/CWnd::OnMouseHWheel", "AFXWIN/CWnd::OnMouseLeave", "AFXWIN/CWnd::OnMouseMove", "AFXWIN/CWnd::OnMouseWheel", "AFXWIN/CWnd::OnMove", "AFXWIN/CWnd::OnMoving", "AFXWIN/CWnd::OnNcActivate", "AFXWIN/CWnd::OnNcCalcSize", "AFXWIN/CWnd::OnNcCreate", "AFXWIN/CWnd::OnNcDestroy", "AFXWIN/CWnd::OnNcHitTest", "AFXWIN/CWnd::OnNcLButtonDblClk", "AFXWIN/CWnd::OnNcLButtonDown", "AFXWIN/CWnd::OnNcLButtonUp", "AFXWIN/CWnd::OnNcMButtonDblClk", "AFXWIN/CWnd::OnNcMButtonDown", "AFXWIN/CWnd::OnNcMButtonUp", "AFXWIN/CWnd::OnNcMouseHover", "AFXWIN/CWnd::OnNcMouseLeave", "AFXWIN/CWnd::OnNcMouseMove", "AFXWIN/CWnd::OnNcPaint", "AFXWIN/CWnd::OnNcRButtonDblClk", "AFXWIN/CWnd::OnNcRButtonDown", "AFXWIN/CWnd::OnNcRButtonUp", "AFXWIN/CWnd::OnNcRenderingChanged", "AFXWIN/CWnd::OnNcXButtonDblClk", "AFXWIN/CWnd::OnNcXButtonDown", "AFXWIN/CWnd::OnNcXButtonUp", "AFXWIN/CWnd::OnNextMenu", "AFXWIN/CWnd::OnNotify", "AFXWIN/CWnd::OnNotifyFormat", "AFXWIN/CWnd::OnPaint", "AFXWIN/CWnd::OnPaintClipboard", "AFXWIN/CWnd::OnPaletteChanged", "AFXWIN/CWnd::OnPaletteIsChanging", "AFXWIN/CWnd::OnParentNotify", "AFXWIN/CWnd::OnPowerBroadcast", "AFXWIN/CWnd::OnQueryDragIcon", "AFXWIN/CWnd::OnQueryEndSession", "AFXWIN/CWnd::OnQueryNewPalette", "AFXWIN/CWnd::OnQueryOpen", "AFXWIN/CWnd::OnQueryUIState", "AFXWIN/CWnd::OnRawInput", "AFXWIN/CWnd::OnRButtonDblClk", "AFXWIN/CWnd::OnRButtonDown", "AFXWIN/CWnd::OnRButtonUp", "AFXWIN/CWnd::OnRenderAllFormats", "AFXWIN/CWnd::OnRenderFormat", "AFXWIN/CWnd::OnSessionChange", "AFXWIN/CWnd::OnSetCursor", "AFXWIN/CWnd::OnSetFocus", "AFXWIN/CWnd::OnSettingChange", "AFXWIN/CWnd::OnShowWindow", "AFXWIN/CWnd::OnSize", "AFXWIN/CWnd::OnSizeClipboard", "AFXWIN/CWnd::OnSizing", "AFXWIN/CWnd::OnSpoolerStatus", "AFXWIN/CWnd::OnStyleChanged", "AFXWIN/CWnd::OnStyleChanging", "AFXWIN/CWnd::OnSysChar", "AFXWIN/CWnd::OnSysColorChange", "AFXWIN/CWnd::OnSysCommand", "AFXWIN/CWnd::OnSysDeadChar", "AFXWIN/CWnd::OnSysKeyDown", "AFXWIN/CWnd::OnSysKeyUp", "AFXWIN/CWnd::OnTCard", "AFXWIN/CWnd::OnTimeChange", "AFXWIN/CWnd::OnTimer", "AFXWIN/CWnd::OnTouchInput", "AFXWIN/CWnd::OnTouchInputs", "AFXWIN/CWnd::OnUniChar", "AFXWIN/CWnd::OnUnInitMenuPopup", "AFXWIN/CWnd::OnUpdateUIState", "AFXWIN/CWnd::OnUserChanged", "AFXWIN/CWnd::OnVKeyToItem", "AFXWIN/CWnd::OnVScroll", "AFXWIN/CWnd::OnVScrollClipboard", "AFXWIN/CWnd::OnWindowPosChanged", "AFXWIN/CWnd::OnWindowPosChanging", "AFXWIN/CWnd::OnWinIniChange", "AFXWIN/CWnd::OnWndMsg", "AFXWIN/CWnd::OnXButtonDblClk", "AFXWIN/CWnd::OnXButtonDown", "AFXWIN/CWnd::OnXButtonUp", "AFXWIN/CWnd::PostNcDestroy", "AFXWIN/CWnd::ReflectChildNotify", "AFXWIN/CWnd::ReflectLastMsg", "AFXWIN/CWnd::ResizeDynamicLayout", "AFXWIN/CWnd::WindowProc", "AFXWIN/CWnd::m_hWnd"] helpviewer_keywords: ["CWnd [MFC], CWnd", "CWnd [MFC], accDoDefaultAction", "CWnd [MFC], accHitTest", "CWnd [MFC], accLocation", "CWnd [MFC], accNavigate", "CWnd [MFC], accSelect", "CWnd [MFC], AnimateWindow", "CWnd [MFC], ArrangeIconicWindows", "CWnd [MFC], Attach", "CWnd [MFC], BeginModalState", "CWnd [MFC], BeginPaint", "CWnd [MFC], BindDefaultProperty", "CWnd [MFC], BindProperty", "CWnd [MFC], BringWindowToTop", "CWnd [MFC], CalcWindowRect", "CWnd [MFC], CancelToolTips", "CWnd [MFC], CenterWindow", "CWnd [MFC], ChangeClipboardChain", "CWnd [MFC], CheckDlgButton", "CWnd [MFC], CheckRadioButton", "CWnd [MFC], ChildWindowFromPoint", "CWnd [MFC], ClientToScreen", "CWnd [MFC], CloseWindow", "CWnd [MFC], ContinueModal", "CWnd [MFC], Create", "CWnd [MFC], CreateAccessibleProxy", "CWnd [MFC], CreateCaret", "CWnd [MFC], CreateControl", "CWnd [MFC], CreateEx", "CWnd [MFC], CreateGrayCaret", "CWnd [MFC], CreateSolidCaret", "CWnd [MFC], DeleteTempMap", "CWnd [MFC], DestroyWindow", "CWnd [MFC], Detach", "CWnd [MFC], DlgDirList", "CWnd [MFC], DlgDirListComboBox", "CWnd [MFC], DlgDirSelect", "CWnd [MFC], DlgDirSelectComboBox", "CWnd [MFC], DragAcceptFiles", "CWnd [MFC], DragDetect", "CWnd [MFC], DrawAnimatedRects", "CWnd [MFC], DrawCaption", "CWnd [MFC], DrawMenuBar", "CWnd [MFC], EnableActiveAccessibility", "CWnd [MFC], EnableDynamicLayout", "CWnd [MFC], EnableD2DSupport", "CWnd [MFC], EnableScrollBar", "CWnd [MFC], EnableScrollBarCtrl", "CWnd [MFC], EnableToolTips", "CWnd [MFC], EnableTrackingToolTips", "CWnd [MFC], EnableWindow", "CWnd [MFC], EndModalLoop", "CWnd [MFC], EndModalState", "CWnd [MFC], EndPaint", "CWnd [MFC], ExecuteDlgInit", "CWnd [MFC], FilterToolTipMessage", "CWnd [MFC], FindWindow", "CWnd [MFC], FindWindowEx", "CWnd [MFC], FlashWindow", "CWnd [MFC], FlashWindowEx", "CWnd [MFC], FromHandle", "CWnd [MFC], FromHandlePermanent", "CWnd [MFC], get_accChild", "CWnd [MFC], get_accChildCount", "CWnd [MFC], get_accDefaultAction", "CWnd [MFC], get_accDescription", "CWnd [MFC], get_accFocus", "CWnd [MFC], get_accHelp", "CWnd [MFC], get_accHelpTopic", "CWnd [MFC], get_accKeyboardShortcut", "CWnd [MFC], get_accName", "CWnd [MFC], get_accParent", "CWnd [MFC], get_accRole", "CWnd [MFC], get_accSelection", "CWnd [MFC], get_accState", "CWnd [MFC], get_accValue", "CWnd [MFC], GetActiveWindow", "CWnd [MFC], GetAncestor", "CWnd [MFC], GetCapture", "CWnd [MFC], GetCaretPos", "CWnd [MFC], GetCheckedRadioButton", "CWnd [MFC], GetClientRect", "CWnd [MFC], GetClipboardOwner", "CWnd [MFC], GetClipboardViewer", "CWnd [MFC], GetControlUnknown", "CWnd [MFC], GetDC", "CWnd [MFC], GetDCEx", "CWnd [MFC], GetDCRenderTarget", "CWnd [MFC], GetDescendantWindow", "CWnd [MFC], GetDesktopWindow", "CWnd [MFC], GetDlgCtrlID", "CWnd [MFC], GetDlgItem", "CWnd [MFC], GetDlgItemInt", "CWnd [MFC], GetDlgItemText", "CWnd [MFC], GetDSCCursor", "CWnd [MFC], GetDynamicLayout", "CWnd [MFC], GetExStyle", "CWnd [MFC], GetFocus", "CWnd [MFC], GetFont", "CWnd [MFC], GetForegroundWindow", "CWnd [MFC], GetIcon", "CWnd [MFC], GetLastActivePopup", "CWnd [MFC], GetLayeredWindowAttributes", "CWnd [MFC], GetMenu", "CWnd [MFC], GetNextDlgGroupItem", "CWnd [MFC], GetNextDlgTabItem", "CWnd [MFC], GetNextWindow", "CWnd [MFC], GetOleControlSite", "CWnd [MFC], GetOpenClipboardWindow", "CWnd [MFC], GetOwner", "CWnd [MFC], GetParent", "CWnd [MFC], GetParentFrame", "CWnd [MFC], GetParentOwner", "CWnd [MFC], GetProperty", "CWnd [MFC], GetRenderTarget", "CWnd [MFC], GetSafeHwnd", "CWnd [MFC], GetSafeOwner", "CWnd [MFC], GetScrollBarCtrl", "CWnd [MFC], GetScrollBarInfo", "CWnd [MFC], GetScrollInfo", "CWnd [MFC], GetScrollLimit", "CWnd [MFC], GetScrollPos", "CWnd [MFC], GetScrollRange", "CWnd [MFC], GetStyle", "CWnd [MFC], GetSystemMenu", "CWnd [MFC], GetTitleBarInfo", "CWnd [MFC], GetTopLevelFrame", "CWnd [MFC], GetTopLevelOwner", "CWnd [MFC], GetTopLevelParent", "CWnd [MFC], GetTopWindow", "CWnd [MFC], GetUpdateRect", "CWnd [MFC], GetUpdateRgn", "CWnd [MFC], GetWindow", "CWnd [MFC], GetWindowContextHelpId", "CWnd [MFC], GetWindowDC", "CWnd [MFC], GetWindowedChildCount", "CWnd [MFC], GetWindowInfo", "CWnd [MFC], GetWindowlessChildCount", "CWnd [MFC], GetWindowPlacement", "CWnd [MFC], GetWindowRect", "CWnd [MFC], GetWindowRgn", "CWnd [MFC], GetWindowText", "CWnd [MFC], GetWindowTextLength", "CWnd [MFC], HideCaret", "CWnd [MFC], HiliteMenuItem", "CWnd [MFC], HtmlHelp", "CWnd [MFC], Invalidate", "CWnd [MFC], InvalidateRect", "CWnd [MFC], InvalidateRgn", "CWnd [MFC], InvokeHelper", "CWnd [MFC], IsChild", "CWnd [MFC], IsD2DSupportEnabled", "CWnd [MFC], IsDialogMessage", "CWnd [MFC], IsDlgButtonChecked", "CWnd [MFC], IsDynamicLayoutEnabled", "CWnd [MFC], IsIconic", "CWnd [MFC], IsTouchWindow", "CWnd [MFC], IsWindowEnabled", "CWnd [MFC], IsWindowVisible", "CWnd [MFC], IsZoomed", "CWnd [MFC], KillTimer", "CWnd [MFC], LockWindowUpdate", "CWnd [MFC], MapWindowPoints", "CWnd [MFC], MessageBox", "CWnd [MFC], ModifyStyle", "CWnd [MFC], ModifyStyleEx", "CWnd [MFC], MoveWindow", "CWnd [MFC], NotifyWinEvent", "CWnd [MFC], OnAmbientProperty", "CWnd [MFC], OnDrawIconicThumbnailOrLivePreview", "CWnd [MFC], OnHelp", "CWnd [MFC], OnHelpFinder", "CWnd [MFC], OnHelpIndex", "CWnd [MFC], OnHelpUsing", "CWnd [MFC], OnToolHitTest", "CWnd [MFC], OpenClipboard", "CWnd [MFC], PaintWindowlessControls", "CWnd [MFC], PostMessage", "CWnd [MFC], PreCreateWindow", "CWnd [MFC], PreSubclassWindow", "CWnd [MFC], PreTranslateMessage", "CWnd [MFC], Print", "CWnd [MFC], PrintClient", "CWnd [MFC], PrintWindow", "CWnd [MFC], RedrawWindow", "CWnd [MFC], RegisterTouchWindow", "CWnd [MFC], ReleaseDC", "CWnd [MFC], RepositionBars", "CWnd [MFC], RunModalLoop", "CWnd [MFC], ScreenToClient", "CWnd [MFC], ScrollWindow", "CWnd [MFC], ScrollWindowEx", "CWnd [MFC], SendChildNotifyLastMsg", "CWnd [MFC], SendDlgItemMessage", "CWnd [MFC], SendMessage", "CWnd [MFC], SendMessageToDescendants", "CWnd [MFC], SendNotifyMessage", "CWnd [MFC], SetActiveWindow", "CWnd [MFC], SetCapture", "CWnd [MFC], SetCaretPos", "CWnd [MFC], SetClipboardViewer", "CWnd [MFC], SetDlgCtrlID", "CWnd [MFC], SetDlgItemInt", "CWnd [MFC], SetDlgItemText", "CWnd [MFC], SetFocus", "CWnd [MFC], SetFont", "CWnd [MFC], SetForegroundWindow", "CWnd [MFC], SetIcon", "CWnd [MFC], SetLayeredWindowAttributes", "CWnd [MFC], SetMenu", "CWnd [MFC], SetOwner", "CWnd [MFC], SetParent", "CWnd [MFC], SetProperty", "CWnd [MFC], SetRedraw", "CWnd [MFC], SetScrollInfo", "CWnd [MFC], SetScrollPos", "CWnd [MFC], SetScrollRange", "CWnd [MFC], SetTimer", "CWnd [MFC], SetWindowContextHelpId", "CWnd [MFC], SetWindowPlacement", "CWnd [MFC], SetWindowPos", "CWnd [MFC], SetWindowRgn", "CWnd [MFC], SetWindowText", "CWnd [MFC], ShowCaret", "CWnd [MFC], ShowOwnedPopups", "CWnd [MFC], ShowScrollBar", "CWnd [MFC], ShowWindow", "CWnd [MFC], SubclassDlgItem", "CWnd [MFC], SubclassWindow", "CWnd [MFC], UnlockWindowUpdate", "CWnd [MFC], UnsubclassWindow", "CWnd [MFC], UpdateData", "CWnd [MFC], UpdateDialogControls", "CWnd [MFC], UpdateLayeredWindow", "CWnd [MFC], UpdateWindow", "CWnd [MFC], ValidateRect", "CWnd [MFC], ValidateRgn", "CWnd [MFC], WindowFromPoint", "CWnd [MFC], WinHelp", "CWnd [MFC], Default", "CWnd [MFC], DefWindowProc", "CWnd [MFC], DoDataExchange", "CWnd [MFC], GetCurrentMessage", "CWnd [MFC], InitDynamicLayout", "CWnd [MFC], LoadDynamicLayoutResource", "CWnd [MFC], OnActivate", "CWnd [MFC], OnActivateApp", "CWnd [MFC], OnAppCommand", "CWnd [MFC], OnAskCbFormatName", "CWnd [MFC], OnCancelMode", "CWnd [MFC], OnCaptureChanged", "CWnd [MFC], OnChangeCbChain", "CWnd [MFC], OnChangeUIState", "CWnd [MFC], OnChar", "CWnd [MFC], OnCharToItem", "CWnd [MFC], OnChildActivate", "CWnd [MFC], OnChildNotify", "CWnd [MFC], OnClipboardUpdate", "CWnd [MFC], OnClose", "CWnd [MFC], OnColorizationColorChanged", "CWnd [MFC], OnCommand", "CWnd [MFC], OnCompacting", "CWnd [MFC], OnCompareItem", "CWnd [MFC], OnCompositionChanged", "CWnd [MFC], OnContextMenu", "CWnd [MFC], OnCopyData", "CWnd [MFC], OnCreate", "CWnd [MFC], OnCtlColor", "CWnd [MFC], OnDeadChar", "CWnd [MFC], OnDeleteItem", "CWnd [MFC], OnDestroy", "CWnd [MFC], OnDestroyClipboard", "CWnd [MFC], OnDeviceChange", "CWnd [MFC], OnDevModeChange", "CWnd [MFC], OnDrawClipboard", "CWnd [MFC], OnDrawItem", "CWnd [MFC], OnDropFiles", "CWnd [MFC], OnEnable", "CWnd [MFC], OnEndSession", "CWnd [MFC], OnEnterIdle", "CWnd [MFC], OnEnterMenuLoop", "CWnd [MFC], OnEnterSizeMove", "CWnd [MFC], OnEraseBkgnd", "CWnd [MFC], OnExitMenuLoop", "CWnd [MFC], OnExitSizeMove", "CWnd [MFC], OnFontChange", "CWnd [MFC], OnGetDlgCode", "CWnd [MFC], OnGetMinMaxInfo", "CWnd [MFC], OnHelpInfo", "CWnd [MFC], OnHotKey", "CWnd [MFC], OnHScroll", "CWnd [MFC], OnHScrollClipboard", "CWnd [MFC], OnIconEraseBkgnd", "CWnd [MFC], OnInitMenu", "CWnd [MFC], OnInitMenuPopup", "CWnd [MFC], OnInputDeviceChange", "CWnd [MFC], OnInputLangChange", "CWnd [MFC], OnInputLangChangeRequest", "CWnd [MFC], OnKeyDown", "CWnd [MFC], OnKeyUp", "CWnd [MFC], OnKillFocus", "CWnd [MFC], OnLButtonDblClk", "CWnd [MFC], OnLButtonDown", "CWnd [MFC], OnLButtonUp", "CWnd [MFC], OnMButtonDblClk", "CWnd [MFC], OnMButtonDown", "CWnd [MFC], OnMButtonUp", "CWnd [MFC], OnMDIActivate", "CWnd [MFC], OnMeasureItem", "CWnd [MFC], OnMenuChar", "CWnd [MFC], OnMenuDrag", "CWnd [MFC], OnMenuGetObject", "CWnd [MFC], OnMenuRButtonUp", "CWnd [MFC], OnMenuSelect", "CWnd [MFC], OnMouseActivate", "CWnd [MFC], OnMouseHover", "CWnd [MFC], OnMouseHWheel", "CWnd [MFC], OnMouseLeave", "CWnd [MFC], OnMouseMove", "CWnd [MFC], OnMouseWheel", "CWnd [MFC], OnMove", "CWnd [MFC], OnMoving", "CWnd [MFC], OnNcActivate", "CWnd [MFC], OnNcCalcSize", "CWnd [MFC], OnNcCreate", "CWnd [MFC], OnNcDestroy", "CWnd [MFC], OnNcHitTest", "CWnd [MFC], OnNcLButtonDblClk", "CWnd [MFC], OnNcLButtonDown", "CWnd [MFC], OnNcLButtonUp", "CWnd [MFC], OnNcMButtonDblClk", "CWnd [MFC], OnNcMButtonDown", "CWnd [MFC], OnNcMButtonUp", "CWnd [MFC], OnNcMouseHover", "CWnd [MFC], OnNcMouseLeave", "CWnd [MFC], OnNcMouseMove", "CWnd [MFC], OnNcPaint", "CWnd [MFC], OnNcRButtonDblClk", "CWnd [MFC], OnNcRButtonDown", "CWnd [MFC], OnNcRButtonUp", "CWnd [MFC], OnNcRenderingChanged", "CWnd [MFC], OnNcXButtonDblClk", "CWnd [MFC], OnNcXButtonDown", "CWnd [MFC], OnNcXButtonUp", "CWnd [MFC], OnNextMenu", "CWnd [MFC], OnNotify", "CWnd [MFC], OnNotifyFormat", "CWnd [MFC], OnPaint", "CWnd [MFC], OnPaintClipboard", "CWnd [MFC], OnPaletteChanged", "CWnd [MFC], OnPaletteIsChanging", "CWnd [MFC], OnParentNotify", "CWnd [MFC], OnPowerBroadcast", "CWnd [MFC], OnQueryDragIcon", "CWnd [MFC], OnQueryEndSession", "CWnd [MFC], OnQueryNewPalette", "CWnd [MFC], OnQueryOpen", "CWnd [MFC], OnQueryUIState", "CWnd [MFC], OnRawInput", "CWnd [MFC], OnRButtonDblClk", "CWnd [MFC], OnRButtonDown", "CWnd [MFC], OnRButtonUp", "CWnd [MFC], OnRenderAllFormats", "CWnd [MFC], OnRenderFormat", "CWnd [MFC], OnSessionChange", "CWnd [MFC], OnSetCursor", "CWnd [MFC], OnSetFocus", "CWnd [MFC], OnSettingChange", "CWnd [MFC], OnShowWindow", "CWnd [MFC], OnSize", "CWnd [MFC], OnSizeClipboard", "CWnd [MFC], OnSizing", "CWnd [MFC], OnSpoolerStatus", "CWnd [MFC], OnStyleChanged", "CWnd [MFC], OnStyleChanging", "CWnd [MFC], OnSysChar", "CWnd [MFC], OnSysColorChange", "CWnd [MFC], OnSysCommand", "CWnd [MFC], OnSysDeadChar", "CWnd [MFC], OnSysKeyDown", "CWnd [MFC], OnSysKeyUp", "CWnd [MFC], OnTCard", "CWnd [MFC], OnTimeChange", "CWnd [MFC], OnTimer", "CWnd [MFC], OnTouchInput", "CWnd [MFC], OnTouchInputs", "CWnd [MFC], OnUniChar", "CWnd [MFC], OnUnInitMenuPopup", "CWnd [MFC], OnUpdateUIState", "CWnd [MFC], OnUserChanged", "CWnd [MFC], OnVKeyToItem", "CWnd [MFC], OnVScroll", "CWnd [MFC], OnVScrollClipboard", "CWnd [MFC], OnWindowPosChanged", "CWnd [MFC], OnWindowPosChanging", "CWnd [MFC], OnWinIniChange", "CWnd [MFC], OnWndMsg", "CWnd [MFC], OnXButtonDblClk", "CWnd [MFC], OnXButtonDown", "CWnd [MFC], OnXButtonUp", "CWnd [MFC], PostNcDestroy", "CWnd [MFC], ReflectChildNotify", "CWnd [MFC], ReflectLastMsg", "CWnd [MFC], ResizeDynamicLayout", "CWnd [MFC], WindowProc", "CWnd [MFC], m_hWnd"] --- From e14ed062a72b6ef8c5dfbcf2962bb11cf44821ae Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 18:37:57 +0800 Subject: [PATCH 0282/1799] Add blockquotes for error messages in range [C1081, C1110] --- docs/error-messages/compiler-errors-1/fatal-error-c1081.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1082.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1084.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1085.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1086.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1087.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1088.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1089.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1091.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1092.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1098.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1099.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1100.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1103.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1104.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1109.md | 2 +- 16 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1081.md b/docs/error-messages/compiler-errors-1/fatal-error-c1081.md index dabb2798dc7..decf5bc9c12 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1081.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1081.md @@ -8,7 +8,7 @@ ms.assetid: e58adf17-cbe1-4955-a5c7-80622bbba249 --- # Fatal Error C1081 -'symbol': file name too long +> 'symbol': file name too long The length of a file pathname exceeds `_MAX_PATH` (defined by STDLIB.h as 260 characters). Shorten the name of the file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1082.md b/docs/error-messages/compiler-errors-1/fatal-error-c1082.md index ff154134ce9..4845d55deb5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1082.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1082.md @@ -8,6 +8,6 @@ ms.assetid: 173179f1-1e14-4a91-9451-122f8a53c0b8 --- # Fatal Error C1082 -Cannot close filetype file: 'file': message +> Cannot close filetype file: 'file': message If the message says "bad file number", the file may have been closing in the foreground while compiling in the background. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1084.md b/docs/error-messages/compiler-errors-1/fatal-error-c1084.md index f4fc81eada9..3cad8bf4407 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1084.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1084.md @@ -8,7 +8,7 @@ ms.assetid: b2f273ef-3a14-4d5f-8ce0-7a11a0388fe6 --- # Fatal Error C1084 -Cannot read filetype file: 'file': message +> Cannot read filetype file: 'file': message This error is generally the result of a failed internal system API call made by the compiler. The message shown when this error is encountered is often generated by either [_wcserror_s](../../c-runtime-library/reference/strerror-s-strerror-s-wcserror-s-wcserror-s.md) or [FormatMessage](/windows/win32/api/winbase/nf-winbase-formatmessage). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1085.md b/docs/error-messages/compiler-errors-1/fatal-error-c1085.md index dd3fff0adf3..192a6beefa4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1085.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1085.md @@ -8,7 +8,7 @@ ms.assetid: f2766365-d09b-4299-8a98-12e5aca98568 --- # Fatal Error C1085 -Cannot write filetype file: 'file': message +> Cannot write filetype file: 'file': message ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1086.md b/docs/error-messages/compiler-errors-1/fatal-error-c1086.md index f5686a8a742..12303544ebb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1086.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1086.md @@ -8,6 +8,6 @@ ms.assetid: 8e3c32c9-cafe-48bf-87bf-f70a1f0367f0 --- # Fatal Error C1086 -Cannot seek filetype file: 'file': message +> Cannot seek filetype file: 'file': message The compiler cannot complete an I/O operation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1087.md b/docs/error-messages/compiler-errors-1/fatal-error-c1087.md index 80fd48be9c6..5604f3e1210 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1087.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1087.md @@ -8,6 +8,6 @@ ms.assetid: 2fb4c14e-c6ea-45e4-8ce5-a51d15811a01 --- # Fatal Error C1087 -Cannot tell filetype file: 'file': message +> Cannot tell filetype file: 'file': message The compiler cannot complete an I/O operation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1088.md b/docs/error-messages/compiler-errors-1/fatal-error-c1088.md index f037f7af44f..e29ea7489b2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1088.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1088.md @@ -8,6 +8,6 @@ ms.assetid: e61ebbb4-ab50-4a66-b2f6-3cc4400d8511 --- # Fatal Error C1088 -Cannot flush filetype file: 'file': message +> Cannot flush filetype file: 'file': message The compiler cannot complete an I/O operation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1089.md b/docs/error-messages/compiler-errors-1/fatal-error-c1089.md index 753f67e2f74..8fb0798e62b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1089.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1089.md @@ -8,6 +8,6 @@ ms.assetid: c4f1e8e5-62c5-464a-9112-99b0790a0fb7 --- # Fatal Error C1089 -Cannot truncate filetype file: 'file': message +> Cannot truncate filetype file: 'file': message The compiler cannot shrink a file to zero length. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1091.md b/docs/error-messages/compiler-errors-1/fatal-error-c1091.md index dfdc32778cd..ea30cf26ffa 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1091.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1091.md @@ -8,7 +8,7 @@ ms.assetid: 812d4201-9154-48b0-b9af-5959c082ca33 --- # Fatal Error C1091 -compiler limit: string exceeds 'length' bytes in length +> compiler limit: string exceeds 'length' bytes in length A string constant exceeded the current limit on the length of strings. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1092.md b/docs/error-messages/compiler-errors-1/fatal-error-c1092.md index 396f6b007a6..9858ba0aead 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1092.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1092.md @@ -8,7 +8,7 @@ ms.assetid: bcaa87f0-fbfc-4a33-844b-3b9f5d67f279 --- # Fatal Error C1092 -Edit and Continue does not support changes to data types; build required +> Edit and Continue does not support changes to data types; build required You changed or added a data type since the last successful build. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1098.md b/docs/error-messages/compiler-errors-1/fatal-error-c1098.md index d28a67c5100..cbd5da2eee2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1098.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1098.md @@ -8,6 +8,6 @@ ms.assetid: 09a1a14b-95bd-49db-b644-192efbaf9f45 --- # Fatal Error C1098 -Version mismatch with Edit and Continue engine +> Version mismatch with Edit and Continue engine The debugger version you are using does not match the compiler used to create the executable. If recompiling does not fix the problem, you may need to reinstall Visual C++ to make sure you have the proper versions of the debugger and compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1099.md b/docs/error-messages/compiler-errors-1/fatal-error-c1099.md index 5cf10883dcb..8cab0282375 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1099.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1099.md @@ -8,6 +8,6 @@ ms.assetid: c050b074-a06a-4026-9e10-569029cc0739 --- # Fatal Error C1099 -Edit and Continue engine terminating compile +> Edit and Continue engine terminating compile Edit and Continue loaded a precompiled header file in preparation for compiling code changes, but subsequent actions (such as code changes prior to the precompiled header `#include` statement or stopping the debugger) prevented Edit and Continue from finishing the compile with that process. You do not need to take any action to fix this error. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1100.md b/docs/error-messages/compiler-errors-1/fatal-error-c1100.md index 77c7b876b76..08c5f40a376 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1100.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1100.md @@ -8,6 +8,6 @@ ms.assetid: d4d877ea-acd6-4ec7-961e-55e460d98820 --- # Fatal Error C1100 -unable to initialize OLE : system error message +> unable to initialize OLE : system error message The compiler cannot initialize the Component Object Model (COM) library. See [CoInitialize](/windows/win32/api/objbase/nf-objbase-coinitialize). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md index 7b102186fe7..f5cba97cc81 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md @@ -8,7 +8,7 @@ ms.assetid: 9d276939-9c47-4235-9d20-76b8434f9731 --- # Fatal Error C1103 -fatal error importing progid: 'message' +> fatal error importing progid: 'message' The compiler detected a problem importing a type library. For example, you cannot specify a type library with progid and also specify `no_registry`. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md index d942c0c4c7c..341e25a05bd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md @@ -8,7 +8,7 @@ ms.assetid: 45bd85c4-77d3-4d3c-b167-49c563aefb4d --- # Fatal Error C1104 -fatal error importing libid: 'message' +> fatal error importing libid: 'message' The compiler detected a problem importing a type library. For example, you cannot specify a type library with libid and also specify `no_registry`. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1109.md b/docs/error-messages/compiler-errors-1/fatal-error-c1109.md index 01bc560c948..2e9c3ff8241 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1109.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1109.md @@ -8,6 +8,6 @@ ms.assetid: df385e46-e54d-412c-88f8-42582b59909c --- # Fatal Error C1109 -unable to find 'entry point' in DLL 'dll' +> unable to find 'entry point' in DLL 'dll' An entry point in a [delay-loaded DLL](../../build/reference/linker-support-for-delay-loaded-dlls.md) required by the compiler could not be found. From 3fc5f3d311d2daef9472bc84b12836bddcf77307 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 18:42:49 +0800 Subject: [PATCH 0283/1799] Add "Remarks" and "Example" headings for error references in range [C1081, C1110] --- docs/error-messages/compiler-errors-1/fatal-error-c1081.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1082.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1083.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1084.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1086.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1087.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1088.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1089.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1090.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1091.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1092.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1093.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1098.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1099.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1100.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1103.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1104.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1107.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1108.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1109.md | 2 ++ 20 files changed, 44 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1081.md b/docs/error-messages/compiler-errors-1/fatal-error-c1081.md index decf5bc9c12..ffca58a47da 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1081.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1081.md @@ -10,6 +10,8 @@ ms.assetid: e58adf17-cbe1-4955-a5c7-80622bbba249 > 'symbol': file name too long +## Remarks + The length of a file pathname exceeds `_MAX_PATH` (defined by STDLIB.h as 260 characters). Shorten the name of the file. If you call CL.exe with a short filename, the compiler may need to generate a full pathname. For example, `cl -c myfile.cpp` may cause the compiler to generate: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1082.md b/docs/error-messages/compiler-errors-1/fatal-error-c1082.md index 4845d55deb5..6cf1e7d6121 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1082.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1082.md @@ -10,4 +10,6 @@ ms.assetid: 173179f1-1e14-4a91-9451-122f8a53c0b8 > Cannot close filetype file: 'file': message +## Remarks + If the message says "bad file number", the file may have been closing in the foreground while compiling in the background. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1083.md b/docs/error-messages/compiler-errors-1/fatal-error-c1083.md index 740cef07032..dfe0a49cdf1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1083.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1083.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C1083"] > Cannot open *filetype* file: '*file*': *message* +## Remarks + The compiler generates a C1083 error when it can't find a file. There are many possible causes for this error. An incorrect include search path or missing or misnamed header files are the most common causes, but other file types and issues can also cause C1083. Here are some of the common reasons why the compiler generates this error. ## The specified file name is wrong diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1084.md b/docs/error-messages/compiler-errors-1/fatal-error-c1084.md index 3cad8bf4407..7b836b9a69e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1084.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1084.md @@ -10,6 +10,8 @@ ms.assetid: b2f273ef-3a14-4d5f-8ce0-7a11a0388fe6 > Cannot read filetype file: 'file': message +## Remarks + This error is generally the result of a failed internal system API call made by the compiler. The message shown when this error is encountered is often generated by either [_wcserror_s](../../c-runtime-library/reference/strerror-s-strerror-s-wcserror-s-wcserror-s.md) or [FormatMessage](/windows/win32/api/winbase/nf-winbase-formatmessage). Performing the following steps may help resolve C1084: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1086.md b/docs/error-messages/compiler-errors-1/fatal-error-c1086.md index 12303544ebb..9a3af04f3d4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1086.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1086.md @@ -10,4 +10,6 @@ ms.assetid: 8e3c32c9-cafe-48bf-87bf-f70a1f0367f0 > Cannot seek filetype file: 'file': message +## Remarks + The compiler cannot complete an I/O operation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1087.md b/docs/error-messages/compiler-errors-1/fatal-error-c1087.md index 5604f3e1210..e6503af1fe0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1087.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1087.md @@ -10,4 +10,6 @@ ms.assetid: 2fb4c14e-c6ea-45e4-8ce5-a51d15811a01 > Cannot tell filetype file: 'file': message +## Remarks + The compiler cannot complete an I/O operation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1088.md b/docs/error-messages/compiler-errors-1/fatal-error-c1088.md index e29ea7489b2..167f93684a0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1088.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1088.md @@ -10,4 +10,6 @@ ms.assetid: e61ebbb4-ab50-4a66-b2f6-3cc4400d8511 > Cannot flush filetype file: 'file': message +## Remarks + The compiler cannot complete an I/O operation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1089.md b/docs/error-messages/compiler-errors-1/fatal-error-c1089.md index 8fb0798e62b..a18e5a69fa5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1089.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1089.md @@ -10,4 +10,6 @@ ms.assetid: c4f1e8e5-62c5-464a-9112-99b0790a0fb7 > Cannot truncate filetype file: 'file': message +## Remarks + The compiler cannot shrink a file to zero length. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1090.md b/docs/error-messages/compiler-errors-1/fatal-error-c1090.md index 3764f4cd32c..2f28236bdfc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1090.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1090.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C1090"] > PDB API call failed, error code '*error-number*': *message* +## Remarks + An error occurred in processing a PDB file. Error C1090 is a catch-all for uncommon compiler PDB file errors that aren't reported separately. We only have generic advice for resolving this issue: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1091.md b/docs/error-messages/compiler-errors-1/fatal-error-c1091.md index ea30cf26ffa..5d67a0cff1e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1091.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1091.md @@ -10,6 +10,8 @@ ms.assetid: 812d4201-9154-48b0-b9af-5959c082ca33 > compiler limit: string exceeds 'length' bytes in length +## Remarks + A string constant exceeded the current limit on the length of strings. You might want to split the static string into two (or more) variables and use [strcpy_s](../../c-runtime-library/reference/strcpy-s-wcscpy-s-mbscpy-s.md) to join the result as part of the declaration or during run time. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1092.md b/docs/error-messages/compiler-errors-1/fatal-error-c1092.md index 9858ba0aead..221d9284bfd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1092.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1092.md @@ -10,6 +10,8 @@ ms.assetid: bcaa87f0-fbfc-4a33-844b-3b9f5d67f279 > Edit and Continue does not support changes to data types; build required +## Remarks + You changed or added a data type since the last successful build. - Edit and Continue does not support changes to existing data types, including class, struct, or enum definitions. You must stop debugging and build the application. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1093.md b/docs/error-messages/compiler-errors-1/fatal-error-c1093.md index 4d6e7437f7c..1ca000b2e81 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1093.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1093.md @@ -10,6 +10,8 @@ ms.assetid: 61b120e2-44cc-4824-981a-7eb72aa57745 > API call '*function name*' failed '*location of call*' : '*text from run-time*' +## Remarks + A call to a .NET function failed. The *text from run-time* string may or may not be supplied by the COM runtime. For more information about system error messages, see the winerror.h system file, and [FormatMessage](/windows/win32/api/winbase/nf-winbase-formatmessage). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1098.md b/docs/error-messages/compiler-errors-1/fatal-error-c1098.md index cbd5da2eee2..56e086fbbd2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1098.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1098.md @@ -10,4 +10,6 @@ ms.assetid: 09a1a14b-95bd-49db-b644-192efbaf9f45 > Version mismatch with Edit and Continue engine +## Remarks + The debugger version you are using does not match the compiler used to create the executable. If recompiling does not fix the problem, you may need to reinstall Visual C++ to make sure you have the proper versions of the debugger and compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1099.md b/docs/error-messages/compiler-errors-1/fatal-error-c1099.md index 8cab0282375..0fc960d1b66 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1099.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1099.md @@ -10,4 +10,6 @@ ms.assetid: c050b074-a06a-4026-9e10-569029cc0739 > Edit and Continue engine terminating compile +## Remarks + Edit and Continue loaded a precompiled header file in preparation for compiling code changes, but subsequent actions (such as code changes prior to the precompiled header `#include` statement or stopping the debugger) prevented Edit and Continue from finishing the compile with that process. You do not need to take any action to fix this error. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1100.md b/docs/error-messages/compiler-errors-1/fatal-error-c1100.md index 08c5f40a376..cc876e421e1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1100.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1100.md @@ -10,4 +10,6 @@ ms.assetid: d4d877ea-acd6-4ec7-961e-55e460d98820 > unable to initialize OLE : system error message +## Remarks + The compiler cannot initialize the Component Object Model (COM) library. See [CoInitialize](/windows/win32/api/objbase/nf-objbase-coinitialize). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md index f5cba97cc81..56bed5f861a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md @@ -10,10 +10,14 @@ ms.assetid: 9d276939-9c47-4235-9d20-76b8434f9731 > fatal error importing progid: 'message' +## Remarks + The compiler detected a problem importing a type library. For example, you cannot specify a type library with progid and also specify `no_registry`. For more information, see [#import Directive](../../preprocessor/hash-import-directive-cpp.md). +## Example + The following sample will generate C1103: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md index 341e25a05bd..2a74faffdd1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md @@ -10,10 +10,14 @@ ms.assetid: 45bd85c4-77d3-4d3c-b167-49c563aefb4d > fatal error importing libid: 'message' +## Remarks + The compiler detected a problem importing a type library. For example, you cannot specify a type library with libid and also specify `no_registry`. For more information, see [#import Directive](../../preprocessor/hash-import-directive-cpp.md). +## Example + The following sample will generate C1104: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1107.md b/docs/error-messages/compiler-errors-1/fatal-error-c1107.md index 7ec4ba1fb4c..2fd3a3eacfb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1107.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1107.md @@ -10,6 +10,8 @@ ms.assetid: 541a4d9f-10bc-4dd8-b68e-15e548f3dc0a > could not find assembly '*file*': please specify the assembly search path using `/AI` or by setting the `LIBPATH` environment variable +## Remarks + A metadata file was passed to a [`#using`](../../preprocessor/hash-using-directive-cpp.md) directive that the compiler was unable to locate. LIBPATH, which is described in the article for `#using`, and the [`/AI`](../../build/reference/ai-specify-metadata-directories.md) compiler option allow you to specify directories in which the compiler will look for referenced metadata files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1108.md b/docs/error-messages/compiler-errors-1/fatal-error-c1108.md index 98678a609eb..ed31313c73b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1108.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1108.md @@ -10,6 +10,8 @@ ms.assetid: 3cadf07b-b7a7-41c7-ad5c-06ceb8af8c3b > unable to find DLL: '*dll name*' +## Remarks + The specified DLL (*dll name*) could not be found in the path. To resolve this error, reinstall Visual C++ or copy the appropriate .dll file from the installation to your computer. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1109.md b/docs/error-messages/compiler-errors-1/fatal-error-c1109.md index 2e9c3ff8241..e4a813d6d1f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1109.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1109.md @@ -10,4 +10,6 @@ ms.assetid: df385e46-e54d-412c-88f8-42582b59909c > unable to find 'entry point' in DLL 'dll' +## Remarks + An entry point in a [delay-loaded DLL](../../build/reference/linker-support-for-delay-loaded-dlls.md) required by the compiler could not be found. From 31b701f2996dec044bc26537daae580ca326deb6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 18:45:50 +0800 Subject: [PATCH 0284/1799] Replace term "sample" with "example" for error references in range [C1081, C1110] --- docs/error-messages/compiler-errors-1/fatal-error-c1094.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1103.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1104.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1094.md b/docs/error-messages/compiler-errors-1/fatal-error-c1094.md index bc80c63eeb3..49ee626c597 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1094.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1094.md @@ -16,7 +16,7 @@ The value that is passed to [`/Yc`](../../build/reference/yc-create-precompiled- ## Example -The following sample generates C1094: +The following example generates C1094: ``` // C1094.h diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md index 56bed5f861a..9b71d13f8f8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md @@ -18,7 +18,7 @@ For more information, see [#import Directive](../../preprocessor/hash-import-dir ## Example -The following sample will generate C1103: +The following example will generate C1103: ```cpp // C1103.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md index 2a74faffdd1..687082243bf 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md @@ -18,7 +18,7 @@ For more information, see [#import Directive](../../preprocessor/hash-import-dir ## Example -The following sample will generate C1104: +The following example will generate C1104: ```cpp // C1104.cpp From 1b05a484b400fe9cc7564f7a861ae027c72ab830 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 4 Jul 2025 18:50:20 +0800 Subject: [PATCH 0285/1799] Update metadata for error references in range [C1081, C1110] --- docs/error-messages/compiler-errors-1/fatal-error-c1081.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1082.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1083.md | 4 ++-- docs/error-messages/compiler-errors-1/fatal-error-c1084.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1085.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1086.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1087.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1088.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1089.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1090.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1091.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1092.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1093.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1094.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1098.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1099.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1100.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1103.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1104.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1107.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1108.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1109.md | 5 ++--- 22 files changed, 41 insertions(+), 61 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1081.md b/docs/error-messages/compiler-errors-1/fatal-error-c1081.md index ffca58a47da..8922f2cb05e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1081.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1081.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1081" title: "Fatal Error C1081" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1081" +ms.date: 11/04/2016 f1_keywords: ["C1081"] helpviewer_keywords: ["C1081"] -ms.assetid: e58adf17-cbe1-4955-a5c7-80622bbba249 --- # Fatal Error C1081 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1082.md b/docs/error-messages/compiler-errors-1/fatal-error-c1082.md index 6cf1e7d6121..c0052079a27 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1082.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1082.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1082" title: "Fatal Error C1082" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1082" +ms.date: 11/04/2016 f1_keywords: ["C1082"] helpviewer_keywords: ["C1082"] -ms.assetid: 173179f1-1e14-4a91-9451-122f8a53c0b8 --- # Fatal Error C1082 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1083.md b/docs/error-messages/compiler-errors-1/fatal-error-c1083.md index dfe0a49cdf1..06c6ff63ab1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1083.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1083.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Fatal Error C1083" title: "Fatal Error C1083" -ms.date: "09/01/2017" +description: "Learn more about: Fatal Error C1083" +ms.date: 09/01/2017 f1_keywords: ["C1083"] helpviewer_keywords: ["C1083"] --- diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1084.md b/docs/error-messages/compiler-errors-1/fatal-error-c1084.md index 7b836b9a69e..d5cfb9d0bcd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1084.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1084.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1084" title: "Fatal Error C1084" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1084" +ms.date: 11/04/2016 f1_keywords: ["C1084"] helpviewer_keywords: ["C1084"] -ms.assetid: b2f273ef-3a14-4d5f-8ce0-7a11a0388fe6 --- # Fatal Error C1084 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1085.md b/docs/error-messages/compiler-errors-1/fatal-error-c1085.md index 192a6beefa4..b7a9acd4f40 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1085.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1085.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1085" title: "Fatal Error C1085" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1085" +ms.date: 11/04/2016 f1_keywords: ["C1085"] helpviewer_keywords: ["C1085"] -ms.assetid: f2766365-d09b-4299-8a98-12e5aca98568 --- # Fatal Error C1085 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1086.md b/docs/error-messages/compiler-errors-1/fatal-error-c1086.md index 9a3af04f3d4..d89d6f0efb4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1086.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1086.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1086" title: "Fatal Error C1086" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1086" +ms.date: 11/04/2016 f1_keywords: ["C1086"] helpviewer_keywords: ["C1086"] -ms.assetid: 8e3c32c9-cafe-48bf-87bf-f70a1f0367f0 --- # Fatal Error C1086 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1087.md b/docs/error-messages/compiler-errors-1/fatal-error-c1087.md index e6503af1fe0..84d1dd3314f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1087.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1087.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1087" title: "Fatal Error C1087" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1087" +ms.date: 11/04/2016 f1_keywords: ["C1087"] helpviewer_keywords: ["C1087"] -ms.assetid: 2fb4c14e-c6ea-45e4-8ce5-a51d15811a01 --- # Fatal Error C1087 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1088.md b/docs/error-messages/compiler-errors-1/fatal-error-c1088.md index 167f93684a0..8359676108d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1088.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1088.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1088" title: "Fatal Error C1088" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1088" +ms.date: 11/04/2016 f1_keywords: ["C1088"] helpviewer_keywords: ["C1088"] -ms.assetid: e61ebbb4-ab50-4a66-b2f6-3cc4400d8511 --- # Fatal Error C1088 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1089.md b/docs/error-messages/compiler-errors-1/fatal-error-c1089.md index a18e5a69fa5..0b1c98a1e84 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1089.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1089.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1089" title: "Fatal Error C1089" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1089" +ms.date: 11/04/2016 f1_keywords: ["C1089"] helpviewer_keywords: ["C1089"] -ms.assetid: c4f1e8e5-62c5-464a-9112-99b0790a0fb7 --- # Fatal Error C1089 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1090.md b/docs/error-messages/compiler-errors-1/fatal-error-c1090.md index 2f28236bdfc..7602b777254 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1090.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1090.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1090 PDB API call failed" title: "Fatal Error C1090" +description: "Learn more about: Fatal Error C1090 PDB API call failed" ms.date: 04/01/2021 f1_keywords: ["C1090"] helpviewer_keywords: ["C1090"] diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1091.md b/docs/error-messages/compiler-errors-1/fatal-error-c1091.md index 5d67a0cff1e..fb5e7195d9b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1091.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1091.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1091" title: "Fatal Error C1091" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1091" +ms.date: 11/04/2016 f1_keywords: ["C1091"] helpviewer_keywords: ["C1091"] -ms.assetid: 812d4201-9154-48b0-b9af-5959c082ca33 --- # Fatal Error C1091 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1092.md b/docs/error-messages/compiler-errors-1/fatal-error-c1092.md index 221d9284bfd..a34f58ab352 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1092.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1092.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1092" title: "Fatal Error C1092" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1092" +ms.date: 11/04/2016 f1_keywords: ["C1092"] helpviewer_keywords: ["C1092"] -ms.assetid: bcaa87f0-fbfc-4a33-844b-3b9f5d67f279 --- # Fatal Error C1092 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1093.md b/docs/error-messages/compiler-errors-1/fatal-error-c1093.md index 1ca000b2e81..b975a6552d6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1093.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1093.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1093" title: "Fatal Error C1093" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1093" +ms.date: 11/04/2016 f1_keywords: ["C1093"] helpviewer_keywords: ["C1093"] -ms.assetid: 61b120e2-44cc-4824-981a-7eb72aa57745 --- # Fatal Error C1093 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1094.md b/docs/error-messages/compiler-errors-1/fatal-error-c1094.md index 49ee626c597..7bc3d767268 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1094.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1094.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1094" title: "Fatal Error C1094" +description: "Learn more about: Fatal Error C1094" ms.date: 08/17/2022 f1_keywords: ["C1094"] helpviewer_keywords: ["C1094"] -ms.assetid: 9e1193b2-cb95-44f9-bf6f-019e0d41dd97 --- # Fatal Error C1094 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1098.md b/docs/error-messages/compiler-errors-1/fatal-error-c1098.md index 56e086fbbd2..4a2b422fb33 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1098.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1098.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1098" title: "Fatal Error C1098" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1098" +ms.date: 11/04/2016 f1_keywords: ["C1098"] helpviewer_keywords: ["C1098"] -ms.assetid: 09a1a14b-95bd-49db-b644-192efbaf9f45 --- # Fatal Error C1098 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1099.md b/docs/error-messages/compiler-errors-1/fatal-error-c1099.md index 0fc960d1b66..0b55641fd09 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1099.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1099.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1099" title: "Fatal Error C1099" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1099" +ms.date: 11/04/2016 f1_keywords: ["C1099"] helpviewer_keywords: ["C1099"] -ms.assetid: c050b074-a06a-4026-9e10-569029cc0739 --- # Fatal Error C1099 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1100.md b/docs/error-messages/compiler-errors-1/fatal-error-c1100.md index cc876e421e1..71ab285e1b9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1100.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1100.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1100" title: "Fatal Error C1100" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1100" +ms.date: 11/04/2016 f1_keywords: ["C1100"] helpviewer_keywords: ["C1100"] -ms.assetid: d4d877ea-acd6-4ec7-961e-55e460d98820 --- # Fatal Error C1100 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md index 9b71d13f8f8..8d252ac10e1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1103" title: "Fatal Error C1103" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1103" +ms.date: 11/04/2016 f1_keywords: ["C1103"] helpviewer_keywords: ["C1103"] -ms.assetid: 9d276939-9c47-4235-9d20-76b8434f9731 --- # Fatal Error C1103 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md index 687082243bf..4e5f7e9d27c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1104" title: "Fatal Error C1104" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1104" +ms.date: 11/04/2016 f1_keywords: ["C1104"] helpviewer_keywords: ["C1104"] -ms.assetid: 45bd85c4-77d3-4d3c-b167-49c563aefb4d --- # Fatal Error C1104 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1107.md b/docs/error-messages/compiler-errors-1/fatal-error-c1107.md index 2fd3a3eacfb..0033caaaace 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1107.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1107.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1107" title: "Fatal Error C1107" +description: "Learn more about: Fatal Error C1107" ms.date: 11/22/2021 f1_keywords: ["C1107"] helpviewer_keywords: ["C1107"] -ms.assetid: 541a4d9f-10bc-4dd8-b68e-15e548f3dc0a --- # Fatal Error C1107 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1108.md b/docs/error-messages/compiler-errors-1/fatal-error-c1108.md index ed31313c73b..4e44ae651ed 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1108.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1108.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1108" title: "Fatal Error C1108" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1108" +ms.date: 11/04/2016 f1_keywords: ["C1108"] helpviewer_keywords: ["C1108"] -ms.assetid: 3cadf07b-b7a7-41c7-ad5c-06ceb8af8c3b --- # Fatal Error C1108 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1109.md b/docs/error-messages/compiler-errors-1/fatal-error-c1109.md index e4a813d6d1f..98e571d5285 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1109.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1109.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1109" title: "Fatal Error C1109" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1109" +ms.date: 11/04/2016 f1_keywords: ["C1109"] helpviewer_keywords: ["C1109"] -ms.assetid: df385e46-e54d-412c-88f8-42582b59909c --- # Fatal Error C1109 From 02d79a0d9b77919077d1e564e962a37751a9f229 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 5 Jul 2025 18:47:03 +0800 Subject: [PATCH 0286/1799] Fix syntax error in "Postfix Increment and Decrement Operators" --- ...crement-and-decrement-operators-increment-and-decrement.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md index beb76735fa8..96374b57425 100644 --- a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md +++ b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md @@ -53,9 +53,9 @@ int main() { Postincrement and postdecrement operations on enumerated types are not supported: ```cpp -enum Compass { North, South, East, West ); +enum Compass { North, South, East, West }; Compass myCompass; -for( myCompass = North; myCompass != West; myCompass++ ) // Error +for( myCompass = North; myCompass != West; myCompass++ ); // Error ``` ## See also From 88231e99b697ca61dc660d376c58f52575997240 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 5 Jul 2025 18:48:47 +0800 Subject: [PATCH 0287/1799] Format code in "Postfix Increment and Decrement Operators" --- ...and-decrement-operators-increment-and-decrement.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md index 96374b57425..5398175e664 100644 --- a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md +++ b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md @@ -43,10 +43,11 @@ The following code illustrates the postfix increment operator: #include using namespace std; -int main() { - int i = 10; - cout << i++ << endl; - cout << i << endl; +int main() +{ + int i = 10; + cout << i++ << endl; + cout << i << endl; } ``` @@ -55,7 +56,7 @@ Postincrement and postdecrement operations on enumerated types are not supported ```cpp enum Compass { North, South, East, West }; Compass myCompass; -for( myCompass = North; myCompass != West; myCompass++ ); // Error +for (myCompass = North; myCompass != West; myCompass++); // Error ``` ## See also From a79cd027b668d9c70574eae17c9ca39cf9833d48 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 5 Jul 2025 18:52:08 +0800 Subject: [PATCH 0288/1799] Add output for example in "Postfix Increment and Decrement Operators" --- ...rement-and-decrement-operators-increment-and-decrement.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md index 5398175e664..0b55a699397 100644 --- a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md +++ b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md @@ -51,6 +51,11 @@ int main() } ``` +```Output +10 +11 +``` + Postincrement and postdecrement operations on enumerated types are not supported: ```cpp From 3833dac6f28eed5ba5a73a683e71ea73124e4677 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 5 Jul 2025 18:52:50 +0800 Subject: [PATCH 0289/1799] Update metadata in "Postfix Increment and Decrement Operators" --- ...rement-and-decrement-operators-increment-and-decrement.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md index 0b55a699397..4d06719b107 100644 --- a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md +++ b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Postfix Increment and Decrement Operators: ++ and --" title: "Postfix Increment and Decrement Operators: ++ and --" -ms.date: "11/04/2016" +description: "Learn more about: Postfix Increment and Decrement Operators: ++ and --" +ms.date: 11/04/2016 f1_keywords: ["--", "++"] helpviewer_keywords: ["increment operators [C++], syntax", "member-selection operators [C++]", "-- operator [C++], postfix decrement operators", "postfix operators [C++]", "++ operator [C++], postfix increment operators", "decrement operators [C++], syntax", "operators [C++], postfix", "decrement operators [C++]"] -ms.assetid: 0204d5c8-51b0-4108-b8a1-074c5754d89c --- # Postfix Increment and Decrement Operators: `++` and `--` From 4804f2d8fca841ebf38ee6023d1dc0029c51ca06 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 5 Jul 2025 19:04:43 +0800 Subject: [PATCH 0290/1799] Add blockquotes for error messages in range [C1111, C1210] --- docs/error-messages/compiler-errors-1/fatal-error-c1113.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1120.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1121.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1126.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1128.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1190.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1191.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1192.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1196.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1197.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1201.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1202.md | 2 +- 12 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1113.md b/docs/error-messages/compiler-errors-1/fatal-error-c1113.md index c23e479a0e7..e08ffe63f41 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1113.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1113.md @@ -8,6 +8,6 @@ ms.assetid: 1c7c3ce7-2827-4822-9c63-0abc8615ea39 --- # Fatal Error C1113 -\#using failed on 'file' +> #using failed on 'file' Only a file in the Microsoft Intermediate Language (MSIL) format can be passed to a [#using](../../preprocessor/hash-using-directive-cpp.md) directive. The [/clr](../../build/reference/clr-common-language-runtime-compilation.md) compiler option lets you create an MSIL output file. Other Visual Studio languages also produce MSIL files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1120.md b/docs/error-messages/compiler-errors-1/fatal-error-c1120.md index f828f4e0129..af59426f712 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1120.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1120.md @@ -8,6 +8,6 @@ ms.assetid: 34212b64-f4e5-4c55-9acc-6f6b2ab5f1c0 --- # Fatal Error C1120 -call to GetProcAddress failed for 'function' +> call to GetProcAddress failed for 'function' This error indicates Visual C++ needs to be reinstalled. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1121.md b/docs/error-messages/compiler-errors-1/fatal-error-c1121.md index 32816f5b502..551834256e6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1121.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1121.md @@ -8,6 +8,6 @@ ms.assetid: d16e51c5-4c50-4303-a028-ca60f7a3273c --- # Fatal Error C1121 -call to CryptoAPI failed +> call to CryptoAPI failed The compiler made a call to the CryptoAPI and the call failed. Reinstall Visual Studio and possibly reinstall the operating system. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1126.md b/docs/error-messages/compiler-errors-1/fatal-error-c1126.md index 444c7d01110..c9c64bba1bf 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1126.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1126.md @@ -8,7 +8,7 @@ ms.assetid: f22b26a6-8ad7-47cf-a237-196c8ea60aca --- # Fatal Error C1126 -'identifier' : automatic allocation exceeds size +> 'identifier' : automatic allocation exceeds size Space allocated for local variables of a function (plus a limited amount of space used by the compiler, such as an extra 20 bytes for swappable functions) exceeds the limit. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1128.md b/docs/error-messages/compiler-errors-1/fatal-error-c1128.md index 083737e4b44..d42b638fc54 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1128.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1128.md @@ -8,7 +8,7 @@ ms.assetid: 6f9580fd-ecef-48be-9780-dcf666704279 --- # Fatal Error C1128 -number of sections exceeded object file format limit : compile with /bigobj +> number of sections exceeded object file format limit : compile with /bigobj An .obj file exceeded the number of allowable sections, a COFF object file format limitation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md index da144884d90..c3302dbbdef 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md @@ -8,7 +8,7 @@ ms.assetid: dee2266d-6c40-4f6e-91db-f01e65f8d2bc --- # Fatal Error C1190 -managed targeted code requires a '/clr' option +> managed targeted code requires a '/clr' option You are using CLR constructs but you did not specify **/clr**. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md index 523f3574ff0..6112b05fef2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md @@ -8,7 +8,7 @@ ms.assetid: 2888c6c4-b4e6-449e-8ee0-7917f31086df --- # Fatal Error C1191 -'dll' can only be imported at global scope +> 'dll' can only be imported at global scope The instruction to import mscorlib.dll into a program that uses /clr programming cannot appear in a namespace or function, but must appear at global scope. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1192.md b/docs/error-messages/compiler-errors-1/fatal-error-c1192.md index 93ece1e127c..2e7eb91487e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1192.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1192.md @@ -7,6 +7,6 @@ helpviewer_keywords: ["C1192"] --- # Fatal Error C1192 -\#using failed on 'file' +> #using failed on 'file' Only a file in the Microsoft Intermediate Language (MSIL) format can be passed to a [#using](../../preprocessor/hash-using-directive-cpp.md) directive. The [/clr](../../build/reference/clr-common-language-runtime-compilation.md) compiler option lets you create an MSIL output file. Other Visual Studio languages also produce MSIL files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1196.md b/docs/error-messages/compiler-errors-1/fatal-error-c1196.md index ff1a7716283..3ef1d9f65cd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1196.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1196.md @@ -8,6 +8,6 @@ ms.assetid: 10a79b3f-3423-4ee3-98fa-e9e59cddabb1 --- # Fatal Error C1196 -'identifier' : identifier found in type library 'typelib' is not a valid C++ identifier +> 'identifier' : identifier found in type library 'typelib' is not a valid C++ identifier One of the identifiers in your type library is not a valid C++ identifier. The type library is not available for use with [#import](../../preprocessor/hash-import-directive-cpp.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md index f08b1d92a2f..885011b6ed6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md @@ -8,7 +8,7 @@ ms.assetid: 22b801b7-e792-41f6-a461-973c03c69f25 --- # Fatal Error C1197 -cannot reference 'mscorlib.dll_1' as the program has already referenced 'mscorlib.dll_2' +> cannot reference 'mscorlib.dll_1' as the program has already referenced 'mscorlib.dll_2' The compiler is matched to a version of the common language runtime. However, an attempt was made to reference a version of a common language runtime file from a previous version. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1201.md b/docs/error-messages/compiler-errors-1/fatal-error-c1201.md index a318e4523e8..2d3d3ade714 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1201.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1201.md @@ -8,7 +8,7 @@ ms.assetid: e58b9b9a-2c6f-454d-8719-9773aca765d1 --- # Fatal Error C1201 -unable to continue after syntax error in class template definition +> unable to continue after syntax error in class template definition An unexpected error occurred while parsing a class template definition. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md index 54eb8261043..c4bf2d73e77 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md @@ -8,7 +8,7 @@ ms.assetid: c859adb8-17a7-4fa1-a1f3-5820b7bf3849 --- # Fatal Error C1202 -recursive type or function dependency context too complex +> recursive type or function dependency context too complex A template definition was recursive or exceeded complexity limits. From 55ddc9a017908c96b97bab87cdba53fd6652cb73 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 5 Jul 2025 19:09:22 +0800 Subject: [PATCH 0291/1799] Add "Remarks" and "Example" headings for error references in range [C1111, C1210] --- docs/error-messages/compiler-errors-1/fatal-error-c1113.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1116.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1117.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1120.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1121.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1126.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1128.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1190.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1191.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1192.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1196.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1197.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1201.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1202.md | 4 +++- docs/error-messages/compiler-errors-1/fatal-error-c1205.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1206.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1207.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1208.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1209.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1210.md | 2 ++ 20 files changed, 45 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1113.md b/docs/error-messages/compiler-errors-1/fatal-error-c1113.md index e08ffe63f41..8c66f0aca36 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1113.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1113.md @@ -10,4 +10,6 @@ ms.assetid: 1c7c3ce7-2827-4822-9c63-0abc8615ea39 > #using failed on 'file' +## Remarks + Only a file in the Microsoft Intermediate Language (MSIL) format can be passed to a [#using](../../preprocessor/hash-using-directive-cpp.md) directive. The [/clr](../../build/reference/clr-common-language-runtime-compilation.md) compiler option lets you create an MSIL output file. Other Visual Studio languages also produce MSIL files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1116.md b/docs/error-messages/compiler-errors-1/fatal-error-c1116.md index 7a5fba81b0f..e5a205e37fc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1116.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1116.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1116"] > unrecoverable error importing module/headerunit '*name*'. Specialization of '*primary-template*' with arguments '*argument-list*' +## Remarks + Error C1116 can happen when the creation of the specialization requires the compiler to parse a token-stream and it encounters an identifier without a matching symbol. To resolve the issue, verify that all template specification arguments are defined and spelled correctly. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1117.md b/docs/error-messages/compiler-errors-1/fatal-error-c1117.md index af3886d74f6..f722b86d4b1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1117.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1117.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1117"] > unrecoverable error importing module/headerunit '*name*': symbol '*symbol-name*' has already been defined +## Remarks + The compiler found a redefinition of an existing type. To resolve the issue, verify that the symbol has only one definition across modules and translation units. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1120.md b/docs/error-messages/compiler-errors-1/fatal-error-c1120.md index af59426f712..bb0860298d3 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1120.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1120.md @@ -10,4 +10,6 @@ ms.assetid: 34212b64-f4e5-4c55-9acc-6f6b2ab5f1c0 > call to GetProcAddress failed for 'function' +## Remarks + This error indicates Visual C++ needs to be reinstalled. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1121.md b/docs/error-messages/compiler-errors-1/fatal-error-c1121.md index 551834256e6..16beba5ec47 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1121.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1121.md @@ -10,4 +10,6 @@ ms.assetid: d16e51c5-4c50-4303-a028-ca60f7a3273c > call to CryptoAPI failed +## Remarks + The compiler made a call to the CryptoAPI and the call failed. Reinstall Visual Studio and possibly reinstall the operating system. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1126.md b/docs/error-messages/compiler-errors-1/fatal-error-c1126.md index c9c64bba1bf..10ce6a89642 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1126.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1126.md @@ -10,6 +10,8 @@ ms.assetid: f22b26a6-8ad7-47cf-a237-196c8ea60aca > 'identifier' : automatic allocation exceeds size +## Remarks + Space allocated for local variables of a function (plus a limited amount of space used by the compiler, such as an extra 20 bytes for swappable functions) exceeds the limit. To correct this error, use `malloc` or **`new`** to allocate large amounts of data. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1128.md b/docs/error-messages/compiler-errors-1/fatal-error-c1128.md index d42b638fc54..b3fe067e940 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1128.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1128.md @@ -10,6 +10,8 @@ ms.assetid: 6f9580fd-ecef-48be-9780-dcf666704279 > number of sections exceeded object file format limit : compile with /bigobj +## Remarks + An .obj file exceeded the number of allowable sections, a COFF object file format limitation. Reaching this section limitation can be the result of using [/Gy](../../build/reference/gy-enable-function-level-linking.md) and a debug build; **/Gy** causes functions to go into their own COMDAT sections. In a debug build, there is a debug info section for each COMDAT function. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md index c3302dbbdef..e84937c85cb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md @@ -10,10 +10,14 @@ ms.assetid: dee2266d-6c40-4f6e-91db-f01e65f8d2bc > managed targeted code requires a '/clr' option +## Remarks + You are using CLR constructs but you did not specify **/clr**. For more information, see [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md). +## Example + The following sample generates C1190: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md index 6112b05fef2..076ed759b57 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md @@ -10,8 +10,12 @@ ms.assetid: 2888c6c4-b4e6-449e-8ee0-7917f31086df > 'dll' can only be imported at global scope +## Remarks + The instruction to import mscorlib.dll into a program that uses /clr programming cannot appear in a namespace or function, but must appear at global scope. +## Example + The following sample generates C1191: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1192.md b/docs/error-messages/compiler-errors-1/fatal-error-c1192.md index 2e7eb91487e..e7ab9659ee3 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1192.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1192.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1192"] > #using failed on 'file' +## Remarks + Only a file in the Microsoft Intermediate Language (MSIL) format can be passed to a [#using](../../preprocessor/hash-using-directive-cpp.md) directive. The [/clr](../../build/reference/clr-common-language-runtime-compilation.md) compiler option lets you create an MSIL output file. Other Visual Studio languages also produce MSIL files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1196.md b/docs/error-messages/compiler-errors-1/fatal-error-c1196.md index 3ef1d9f65cd..8ab541f82dc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1196.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1196.md @@ -10,4 +10,6 @@ ms.assetid: 10a79b3f-3423-4ee3-98fa-e9e59cddabb1 > 'identifier' : identifier found in type library 'typelib' is not a valid C++ identifier +## Remarks + One of the identifiers in your type library is not a valid C++ identifier. The type library is not available for use with [#import](../../preprocessor/hash-import-directive-cpp.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md index 885011b6ed6..f0af57f7bd6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md @@ -10,6 +10,8 @@ ms.assetid: 22b801b7-e792-41f6-a461-973c03c69f25 > cannot reference 'mscorlib.dll_1' as the program has already referenced 'mscorlib.dll_2' +## Remarks + The compiler is matched to a version of the common language runtime. However, an attempt was made to reference a version of a common language runtime file from a previous version. To resolve this error, only reference files from the version of the common language runtime that shipped with the version of Visual C++ you are compiling with. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1201.md b/docs/error-messages/compiler-errors-1/fatal-error-c1201.md index 2d3d3ade714..416a1923c5e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1201.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1201.md @@ -10,6 +10,8 @@ ms.assetid: e58b9b9a-2c6f-454d-8719-9773aca765d1 > unable to continue after syntax error in class template definition +## Remarks + An unexpected error occurred while parsing a class template definition. Fix any other errors and recompile. If that fails, note the circumstances of the error, try to isolate the problem and create a reproducible test case, then contact [Microsoft Product Support Services](/visualstudio/ide/talk-to-us). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md index c4bf2d73e77..88aa9108fbe 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md @@ -10,9 +10,11 @@ ms.assetid: c859adb8-17a7-4fa1-a1f3-5820b7bf3849 > recursive type or function dependency context too complex +## Remarks + A template definition was recursive or exceeded complexity limits. -## Examples +## Example The following sample generates C1202. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1205.md b/docs/error-messages/compiler-errors-1/fatal-error-c1205.md index 37af5602e90..839ecac01ac 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1205.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1205.md @@ -10,6 +10,8 @@ ms.assetid: f855c145-8cf7-4dd1-bb19-257ee38b8382 > Generics are not supported by the version of the runtime installed +## Remarks + The version of the common language runtime that the compiler is using isn't a version of the runtime supported by the current compiler. For example, the generics feature requires a runtime that is matched to the compiler. Your path specification may need to be modified. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1206.md b/docs/error-messages/compiler-errors-1/fatal-error-c1206.md index 0859695a799..2107b48cce0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1206.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1206.md @@ -10,6 +10,8 @@ ms.assetid: 2211428f-ad86-4f7b-82eb-f1ba89b0510e > Per-appdomain data is not supported by the version of the runtime installed +## Remarks + Some features, such as per application domain data, are only supported by the common language runtime that supports the feature. C1206 indicates that the latest version of the runtime isn't installed on your computer. Install the common language runtime version that is intended for use with your compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1207.md b/docs/error-messages/compiler-errors-1/fatal-error-c1207.md index 5302f9c823c..4213b050373 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1207.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1207.md @@ -10,6 +10,8 @@ ms.assetid: cd31b410-9523-47db-883c-e69a9351ffa2 > Managed templates not supported by the version of the runtime installed +## Remarks + C1207 occurs when you have a compiler for the current release, but a common language runtime from a previous release. Some functionality of the compiler may not work on a previous version of the run time. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1208.md b/docs/error-messages/compiler-errors-1/fatal-error-c1208.md index 304879dfc5b..3fbf0d14472 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1208.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1208.md @@ -10,6 +10,8 @@ ms.assetid: 4eefd8f0-5c2e-4a11-9e63-293e1139db65 > Allocating reference classes on the stack is not supported by the version of the runtime installed +## Remarks + C1208 occurs when you have a compiler for the current release, but a common language runtime from a previous release. Some functionality of the compiler may not work on a previous version of the run time. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1209.md b/docs/error-messages/compiler-errors-1/fatal-error-c1209.md index 1029773c300..520c3a0fdb8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1209.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1209.md @@ -10,6 +10,8 @@ ms.assetid: aa9ee10f-abe3-4683-9792-adca4cbbabb5 > Friend assemblies not supported by the version of the runtime installed +## Remarks + C1208 occurs when you have a compiler for the current release, but a common language runtime from a previous release. Some functionality of the compiler may not work on a previous version of the run time. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1210.md b/docs/error-messages/compiler-errors-1/fatal-error-c1210.md index 09aac9e2bd0..be06bbfd0a9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1210.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1210.md @@ -10,6 +10,8 @@ ms.assetid: e2208309-c284-425c-a7e8-48e96e66f35b > `/clr:pure` and `/clr:safe` are not supported by the version of the runtime installed +## Remarks + The **`/clr:pure`** and **`/clr:safe`** compiler options are deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017. C1210 occurs when you have a compiler for the current release, but a common language runtime from a previous release. From c49819748376dc9be26d555fa9558ec06b1c9c68 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 5 Jul 2025 19:12:00 +0800 Subject: [PATCH 0292/1799] Replace term "sample" with "example" for error references in range [C1111, C1210] --- docs/error-messages/compiler-errors-1/fatal-error-c1189.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1190.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1191.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1197.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1202.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1189.md b/docs/error-messages/compiler-errors-1/fatal-error-c1189.md index 91233b42997..a7809713d9f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1189.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1189.md @@ -16,7 +16,7 @@ C1189 is generated by the `#error` directive. The developer who codes the direct ## Example -The following sample generates C1189. In the sample, the developer issues a custom error message because the `_WIN32` identifier is not defined: +The following example generates C1189. In the example, the developer issues a custom error message because the `_WIN32` identifier is not defined: ```cpp // C1189.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md index e84937c85cb..591cba617c2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md @@ -18,7 +18,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates C1190: +The following example generates C1190: ```cpp // C1190.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md index 076ed759b57..fdedbf5db36 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md @@ -16,7 +16,7 @@ The instruction to import mscorlib.dll into a program that uses /clr programming ## Example -The following sample generates C1191: +The following example generates C1191: ```cpp // C1191.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md index f0af57f7bd6..c078f56cc10 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md @@ -18,7 +18,7 @@ To resolve this error, only reference files from the version of the common langu ## Example -The following sample generates C1197: +The following example generates C1197: ```cpp // C1197.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md index 88aa9108fbe..9023668b862 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md @@ -16,7 +16,7 @@ A template definition was recursive or exceeded complexity limits. ## Example -The following sample generates C1202. +The following example generates C1202. ```cpp // C1202.cpp From b20799b9f1b5b86c3abf1ce07b2c22448e65e84d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 5 Jul 2025 19:15:40 +0800 Subject: [PATCH 0293/1799] Update metadata for error references in range [C1111, C1210] --- docs/error-messages/compiler-errors-1/fatal-error-c1113.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1116.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1117.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1120.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1121.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1126.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1128.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1189.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1190.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1191.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1192.md | 4 ++-- docs/error-messages/compiler-errors-1/fatal-error-c1196.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1197.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1201.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1202.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1205.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1206.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1207.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1208.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1209.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1210.md | 3 +-- 21 files changed, 34 insertions(+), 52 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1113.md b/docs/error-messages/compiler-errors-1/fatal-error-c1113.md index 8c66f0aca36..dbc382ae0b6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1113.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1113.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1113" title: "Fatal Error C1113" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1113" +ms.date: 11/04/2016 f1_keywords: ["C1113"] helpviewer_keywords: ["C1113"] -ms.assetid: 1c7c3ce7-2827-4822-9c63-0abc8615ea39 --- # Fatal Error C1113 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1116.md b/docs/error-messages/compiler-errors-1/fatal-error-c1116.md index e5a205e37fc..79274cc6b14 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1116.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1116.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1116" title: "Fatal Error C1116" +description: "Learn more about: Fatal Error C1116" ms.date: 08/17/2022 f1_keywords: ["C1116"] helpviewer_keywords: ["C1116"] diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1117.md b/docs/error-messages/compiler-errors-1/fatal-error-c1117.md index f722b86d4b1..1c1856a0520 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1117.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1117.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1117" title: "Fatal Error C1117" +description: "Learn more about: Fatal Error C1117" ms.date: 08/17/2022 f1_keywords: ["C1117"] helpviewer_keywords: ["C1117"] diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1120.md b/docs/error-messages/compiler-errors-1/fatal-error-c1120.md index bb0860298d3..4152492f557 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1120.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1120.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1120" title: "Fatal Error C1120" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1120" +ms.date: 11/04/2016 f1_keywords: ["C1120"] helpviewer_keywords: ["C1120"] -ms.assetid: 34212b64-f4e5-4c55-9acc-6f6b2ab5f1c0 --- # Fatal Error C1120 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1121.md b/docs/error-messages/compiler-errors-1/fatal-error-c1121.md index 16beba5ec47..ed1e1c77aa2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1121.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1121.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1121" title: "Fatal Error C1121" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1121" +ms.date: 11/04/2016 f1_keywords: ["C1121"] helpviewer_keywords: ["C1121"] -ms.assetid: d16e51c5-4c50-4303-a028-ca60f7a3273c --- # Fatal Error C1121 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1126.md b/docs/error-messages/compiler-errors-1/fatal-error-c1126.md index 10ce6a89642..cc63a251925 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1126.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1126.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1126" title: "Fatal Error C1126" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1126" +ms.date: 11/04/2016 f1_keywords: ["C1126"] helpviewer_keywords: ["C1126"] -ms.assetid: f22b26a6-8ad7-47cf-a237-196c8ea60aca --- # Fatal Error C1126 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1128.md b/docs/error-messages/compiler-errors-1/fatal-error-c1128.md index b3fe067e940..3df616a6771 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1128.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1128.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1128" title: "Fatal Error C1128" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1128" +ms.date: 11/04/2016 f1_keywords: ["C1128"] helpviewer_keywords: ["C1128"] -ms.assetid: 6f9580fd-ecef-48be-9780-dcf666704279 --- # Fatal Error C1128 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1189.md b/docs/error-messages/compiler-errors-1/fatal-error-c1189.md index a7809713d9f..791eb9e2253 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1189.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1189.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1189" title: "Fatal Error C1189" -ms.date: "04/27/2018" +description: "Learn more about: Fatal Error C1189" +ms.date: 04/27/2018 f1_keywords: ["C1189"] helpviewer_keywords: ["C1189"] -ms.assetid: 2e5c8a78-edd4-411c-b619-558a96be148a --- # Fatal Error C1189 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md index 591cba617c2..b02620a88fd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1190" title: "Fatal Error C1190" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1190" +ms.date: 11/04/2016 f1_keywords: ["C1190"] helpviewer_keywords: ["C1190"] -ms.assetid: dee2266d-6c40-4f6e-91db-f01e65f8d2bc --- # Fatal Error C1190 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md index fdedbf5db36..d6bf50086a0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1191" title: "Fatal Error C1191" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1191" +ms.date: 11/04/2016 f1_keywords: ["C1191"] helpviewer_keywords: ["C1191"] -ms.assetid: 2888c6c4-b4e6-449e-8ee0-7917f31086df --- # Fatal Error C1191 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1192.md b/docs/error-messages/compiler-errors-1/fatal-error-c1192.md index e7ab9659ee3..2c374cd29f7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1192.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1192.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Fatal Error C1192" title: "Fatal Error C1192" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1192" +ms.date: 11/04/2016 f1_keywords: ["C1192"] helpviewer_keywords: ["C1192"] --- diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1196.md b/docs/error-messages/compiler-errors-1/fatal-error-c1196.md index 8ab541f82dc..8ae577e8b49 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1196.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1196.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1196" title: "Fatal Error C1196" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1196" +ms.date: 11/04/2016 f1_keywords: ["C1196"] helpviewer_keywords: ["C1196"] -ms.assetid: 10a79b3f-3423-4ee3-98fa-e9e59cddabb1 --- # Fatal Error C1196 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md index c078f56cc10..3a63aaa8362 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1197" title: "Fatal Error C1197" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1197" +ms.date: 11/04/2016 f1_keywords: ["C1197"] helpviewer_keywords: ["C1197"] -ms.assetid: 22b801b7-e792-41f6-a461-973c03c69f25 --- # Fatal Error C1197 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1201.md b/docs/error-messages/compiler-errors-1/fatal-error-c1201.md index 416a1923c5e..f726151d895 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1201.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1201.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1201" title: "Fatal Error C1201" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1201" +ms.date: 11/04/2016 f1_keywords: ["C1201"] helpviewer_keywords: ["C1201"] -ms.assetid: e58b9b9a-2c6f-454d-8719-9773aca765d1 --- # Fatal Error C1201 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md index 9023668b862..4e2c9efccfc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1202" title: "Fatal Error C1202" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1202" +ms.date: 11/04/2016 f1_keywords: ["C1202"] helpviewer_keywords: ["C1202"] -ms.assetid: c859adb8-17a7-4fa1-a1f3-5820b7bf3849 --- # Fatal Error C1202 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1205.md b/docs/error-messages/compiler-errors-1/fatal-error-c1205.md index 839ecac01ac..d66fd0f7793 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1205.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1205.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1205" title: "Fatal Error C1205" +description: "Learn more about: Fatal Error C1205" ms.date: 08/17/2022 f1_keywords: ["C1205"] helpviewer_keywords: ["C1205"] -ms.assetid: f855c145-8cf7-4dd1-bb19-257ee38b8382 --- # Fatal Error C1205 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1206.md b/docs/error-messages/compiler-errors-1/fatal-error-c1206.md index 2107b48cce0..c519b7e27cb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1206.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1206.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1206" title: "Fatal Error C1206" +description: "Learn more about: Fatal Error C1206" ms.date: 08/17/2022 f1_keywords: ["C1206"] helpviewer_keywords: ["C1206"] -ms.assetid: 2211428f-ad86-4f7b-82eb-f1ba89b0510e --- # Fatal Error C1206 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1207.md b/docs/error-messages/compiler-errors-1/fatal-error-c1207.md index 4213b050373..abcb64a7f3b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1207.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1207.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1207" title: "Fatal Error C1207" +description: "Learn more about: Fatal Error C1207" ms.date: 08/17/2022 f1_keywords: ["C1207"] helpviewer_keywords: ["C1207"] -ms.assetid: cd31b410-9523-47db-883c-e69a9351ffa2 --- # Fatal Error C1207 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1208.md b/docs/error-messages/compiler-errors-1/fatal-error-c1208.md index 3fbf0d14472..57732dfda0e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1208.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1208.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1208" title: "Fatal Error C1208" +description: "Learn more about: Fatal Error C1208" ms.date: 08/17/2022 f1_keywords: ["C1208"] helpviewer_keywords: ["C1208"] -ms.assetid: 4eefd8f0-5c2e-4a11-9e63-293e1139db65 --- # Fatal Error C1208 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1209.md b/docs/error-messages/compiler-errors-1/fatal-error-c1209.md index 520c3a0fdb8..3967da97ec8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1209.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1209.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1209" title: "Fatal Error C1209" +description: "Learn more about: Fatal Error C1209" ms.date: 08/17/2022 f1_keywords: ["C1209"] helpviewer_keywords: ["C1209"] -ms.assetid: aa9ee10f-abe3-4683-9792-adca4cbbabb5 --- # Fatal Error C1209 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1210.md b/docs/error-messages/compiler-errors-1/fatal-error-c1210.md index be06bbfd0a9..70c37bc8c76 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1210.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1210.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1210" title: "Fatal Error C1210" +description: "Learn more about: Fatal Error C1210" ms.date: 08/17/2022 f1_keywords: ["C1210"] helpviewer_keywords: ["C1210"] -ms.assetid: e2208309-c284-425c-a7e8-48e96e66f35b --- # Fatal Error C1210 From ea8ee22544ee5445a32abb57cb5f7dd3d8b892bf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 6 Jul 2025 21:18:17 +0800 Subject: [PATCH 0294/1799] Remove backtick for terms "MFC" and "ATL" --- docs/build/reference/hint-files.md | 2 +- docs/mfc/reference/cobarray-class.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/hint-files.md b/docs/build/reference/hint-files.md index 374b605e6f9..b0e03199ec9 100644 --- a/docs/build/reference/hint-files.md +++ b/docs/build/reference/hint-files.md @@ -133,7 +133,7 @@ For a depiction of how hints are gathered, see the [Example](#example) section. You create and delete hints by using the same syntax as the preprocessor directives to create and delete macros. In fact, the parsing system uses the C/C++ preprocessor to evaluate the hints. For more information about the preprocessor directives, see [#define Directive (C/C++)](../../preprocessor/hash-define-directive-c-cpp.md) and [#undef Directive (C/C++)](../../preprocessor/hash-undef-directive-c-cpp.md). -The only unusual syntax elements are the `@<`, `@=`, and `@>` replacement strings. These hint-file specific replacement strings are only used in *map* macros. A map is a set of macros that relate data, functions, or events to other data, functions, or event handlers. For example, `MFC` uses maps to create [message maps](../../mfc/reference/message-maps-mfc.md), and `ATL` uses maps to create [object maps](../../atl/reference/object-map-macros.md). The hint-file specific replacement strings mark the starting, intermediate, and ending elements of a map. Only the name of a map macro is significant. Therefore, each replacement string intentionally hides the implementation of the macro. +The only unusual syntax elements are the `@<`, `@=`, and `@>` replacement strings. These hint-file specific replacement strings are only used in *map* macros. A map is a set of macros that relate data, functions, or events to other data, functions, or event handlers. For example, MFC uses maps to create [message maps](../../mfc/reference/message-maps-mfc.md), and ATL uses maps to create [object maps](../../atl/reference/object-map-macros.md). The hint-file specific replacement strings mark the starting, intermediate, and ending elements of a map. Only the name of a map macro is significant. Therefore, each replacement string intentionally hides the implementation of the macro. Hints use this syntax: diff --git a/docs/mfc/reference/cobarray-class.md b/docs/mfc/reference/cobarray-class.md index 40abda7c8d1..5e750ec9966 100644 --- a/docs/mfc/reference/cobarray-class.md +++ b/docs/mfc/reference/cobarray-class.md @@ -1,6 +1,6 @@ --- title: "CObArray Class" -description: "API reference for the `CObArray` `MFC` class which stores `CObject` pointers in an array." +description: "API reference for the `CObArray` MFC class which stores `CObject` pointers in an array." ms.date: "08/27/2020" f1_keywords: ["CObArray", "AFXCOLL/CObArray", "AFXCOLL/CObArray::CObArray", "AFXCOLL/CObArray::Add", "AFXCOLL/CObArray::Append", "AFXCOLL/CObArray::Copy", "AFXCOLL/CObArray::ElementAt", "AFXCOLL/CObArray::FreeExtra", "AFXCOLL/CObArray::GetAt", "AFXCOLL/CObArray::GetCount", "AFXCOLL/CObArray::GetData", "AFXCOLL/CObArray::GetSize", "AFXCOLL/CObArray::GetUpperBound", "AFXCOLL/CObArray::InsertAt", "AFXCOLL/CObArray::IsEmpty", "AFXCOLL/CObArray::RemoveAll", "AFXCOLL/CObArray::RemoveAt", "AFXCOLL/CObArray::SetAt", "AFXCOLL/CObArray::SetAtGrow", "AFXCOLL/CObArray::SetSize"] helpviewer_keywords: ["CObArray [MFC], CObArray", "CObArray [MFC], Add", "CObArray [MFC], Append", "CObArray [MFC], Copy", "CObArray [MFC], ElementAt", "CObArray [MFC], FreeExtra", "CObArray [MFC], GetAt", "CObArray [MFC], GetCount", "CObArray [MFC], GetData", "CObArray [MFC], GetSize", "CObArray [MFC], GetUpperBound", "CObArray [MFC], InsertAt", "CObArray [MFC], IsEmpty", "CObArray [MFC], RemoveAll", "CObArray [MFC], RemoveAt", "CObArray [MFC], SetAt", "CObArray [MFC], SetAtGrow", "CObArray [MFC], SetSize"] From ad167fea3dcea2f64f6126031161dc88508a0c2c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 6 Jul 2025 21:19:02 +0800 Subject: [PATCH 0295/1799] Update metadata in 2 topics --- docs/build/reference/hint-files.md | 5 ++--- docs/mfc/reference/cobarray-class.md | 2 +- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/build/reference/hint-files.md b/docs/build/reference/hint-files.md index b0e03199ec9..b292dfffa36 100644 --- a/docs/build/reference/hint-files.md +++ b/docs/build/reference/hint-files.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Hint Files" title: "Hint Files" -ms.date: "02/26/2019" +description: "Learn more about: Hint Files" +ms.date: 02/26/2019 f1_keywords: ["cpp.hint", "vc.hint.file"] helpviewer_keywords: ["stop file", "cpp.hint", "hint file", "cpp.stop", "Class View, hint file"] -ms.assetid: 17194f66-cf62-4523-abec-77db0675ab65 --- # Hint Files diff --git a/docs/mfc/reference/cobarray-class.md b/docs/mfc/reference/cobarray-class.md index 5e750ec9966..8dd735c1f0e 100644 --- a/docs/mfc/reference/cobarray-class.md +++ b/docs/mfc/reference/cobarray-class.md @@ -1,7 +1,7 @@ --- title: "CObArray Class" description: "API reference for the `CObArray` MFC class which stores `CObject` pointers in an array." -ms.date: "08/27/2020" +ms.date: 08/27/2020 f1_keywords: ["CObArray", "AFXCOLL/CObArray", "AFXCOLL/CObArray::CObArray", "AFXCOLL/CObArray::Add", "AFXCOLL/CObArray::Append", "AFXCOLL/CObArray::Copy", "AFXCOLL/CObArray::ElementAt", "AFXCOLL/CObArray::FreeExtra", "AFXCOLL/CObArray::GetAt", "AFXCOLL/CObArray::GetCount", "AFXCOLL/CObArray::GetData", "AFXCOLL/CObArray::GetSize", "AFXCOLL/CObArray::GetUpperBound", "AFXCOLL/CObArray::InsertAt", "AFXCOLL/CObArray::IsEmpty", "AFXCOLL/CObArray::RemoveAll", "AFXCOLL/CObArray::RemoveAt", "AFXCOLL/CObArray::SetAt", "AFXCOLL/CObArray::SetAtGrow", "AFXCOLL/CObArray::SetSize"] helpviewer_keywords: ["CObArray [MFC], CObArray", "CObArray [MFC], Add", "CObArray [MFC], Append", "CObArray [MFC], Copy", "CObArray [MFC], ElementAt", "CObArray [MFC], FreeExtra", "CObArray [MFC], GetAt", "CObArray [MFC], GetCount", "CObArray [MFC], GetData", "CObArray [MFC], GetSize", "CObArray [MFC], GetUpperBound", "CObArray [MFC], InsertAt", "CObArray [MFC], IsEmpty", "CObArray [MFC], RemoveAll", "CObArray [MFC], RemoveAt", "CObArray [MFC], SetAt", "CObArray [MFC], SetAtGrow", "CObArray [MFC], SetSize"] --- From dbfbcebbe92272663c3e47aef505eb5f42f56548 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 6 Jul 2025 21:28:44 +0800 Subject: [PATCH 0296/1799] Fix minor "by" typo in "Compiler options listed by category" topic --- docs/build/reference/compiler-options-listed-by-category.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/compiler-options-listed-by-category.md b/docs/build/reference/compiler-options-listed-by-category.md index 2fbfbc13572..1139da622f3 100644 --- a/docs/build/reference/compiler-options-listed-by-category.md +++ b/docs/build/reference/compiler-options-listed-by-category.md @@ -183,7 +183,7 @@ This article contains a categorical list of compiler options. For an alphabetica | [`/Zc:alignedNew[-]`](zc-alignednew.md) | Enable C++17 over-aligned dynamic allocation (on by default in C++17). | | [`/Zc:auto[-]`](zc-auto-deduce-variable-type.md) | Enforce the new Standard C++ meaning for **`auto`** (on by default). | | [`/Zc:char8_t[-]`](zc-char8-t.md) | Enable or disable C++20 native `u8` literal support as `const char8_t` (off by default, except under **`/std:c++20`**). | -| [`/Zc:enumTypes[-]`](zc-enumtypes.md) | Enable Standard C++ rules for inferred `enum` base types (Off b y default, not implied by **`/permissive-`**). | +| [`/Zc:enumTypes[-]`](zc-enumtypes.md) | Enable Standard C++ rules for inferred `enum` base types (Off by default, not implied by **`/permissive-`**). | | [`/Zc:externC[-]`](zc-externc.md) | Enforce Standard C++ rules for `extern "C"` functions (implied by **`/permissive-`**). | | [`/Zc:externConstexpr[-]`](zc-externconstexpr.md) | Enable external linkage for **`constexpr`** variables (off by default). | | [`/Zc:forScope[-]`](zc-forscope-force-conformance-in-for-loop-scope.md) | Enforce Standard C++ **`for`** scoping rules (on by default). | From 17b6369587fc853c4f20e70d47ce6048c891fcdb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 6 Jul 2025 21:36:38 +0800 Subject: [PATCH 0297/1799] Add missing period characters in Compiler Options Lists --- .../reference/compiler-options-listed-alphabetically.md | 4 ++-- docs/build/reference/compiler-options-listed-by-category.md | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/build/reference/compiler-options-listed-alphabetically.md b/docs/build/reference/compiler-options-listed-alphabetically.md index 686023b2143..193a21544b1 100644 --- a/docs/build/reference/compiler-options-listed-alphabetically.md +++ b/docs/build/reference/compiler-options-listed-alphabetically.md @@ -35,7 +35,7 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/clr:safe`](clr-common-language-runtime-compilation.md) | Produce an IL-only verifiable output file. | | [`/constexpr:backtrace`](constexpr-control-constexpr-evaluation.md) | Show N `constexpr` evaluations in diagnostics (default: 10). | | [`/constexpr:depth`](constexpr-control-constexpr-evaluation.md) | Recursion depth limit for `constexpr` evaluation (default: 512). | -| [`/constexpr:steps`](constexpr-control-constexpr-evaluation.md) | Terminate `constexpr` evaluation after N steps (default: 100000) | +| [`/constexpr:steps`](constexpr-control-constexpr-evaluation.md) | Terminate `constexpr` evaluation after N steps (default: 100000). | | [`/D{=|#}`](d-preprocessor-definitions.md) | Defines constants and macros. | | [`/dynamicdeopt`](dynamic-deopt.md) | Enable [C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging) and step in anywhere with on-demand function deoptimization. | | [`/diagnostics`](diagnostics-compiler-diagnostic-options.md) | Diagnostics format: prints column information. | @@ -229,7 +229,7 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/Zc:externConstexpr[-]`](zc-externconstexpr.md) | Enable external linkage for **`constexpr`** variables (off by default). | | [`/Zc:forScope[-]`](zc-forscope-force-conformance-in-for-loop-scope.md) | Enforce Standard C++ **`for`** scoping rules (on by default). | | [`/Zc:gotoScope`](zc-gotoscope.md) | Enforce Standard C++ **`goto`** rules around local variable initialization (implied by **`/permissive-`**). | -| [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules (implied by **`/permissive-`**) | +| [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules (implied by **`/permissive-`**). | | [`/Zc:implicitNoexcept[-]`](zc-implicitnoexcept-implicit-exception-specifiers.md) | Enable implicit **`noexcept`** on required functions (on by default). | | [`/Zc:inline[-]`](zc-inline-remove-unreferenced-comdat.md) | Remove unreferenced functions or data if they're COMDAT or have internal linkage only (off by default). | | [`/Zc:lambda[-]`](zc-lambda.md) | Enable new lambda processor for conformance-mode syntactic checks in generic lambdas. | diff --git a/docs/build/reference/compiler-options-listed-by-category.md b/docs/build/reference/compiler-options-listed-by-category.md index 1139da622f3..5b2a78c030d 100644 --- a/docs/build/reference/compiler-options-listed-by-category.md +++ b/docs/build/reference/compiler-options-listed-by-category.md @@ -158,7 +158,7 @@ This article contains a categorical list of compiler options. For an alphabetica | [`/await:strict`](await-enable-coroutine-support.md) | Enable standard C++20 coroutine support with earlier language versions. | | [`/constexpr:backtrace`](constexpr-control-constexpr-evaluation.md) | Show N `constexpr` evaluations in diagnostics (default: 10). | | [`/constexpr:depth`](constexpr-control-constexpr-evaluation.md) | Recursion depth limit for `constexpr` evaluation (default: 512). | -| [`/constexpr:steps`](constexpr-control-constexpr-evaluation.md) | Terminate `constexpr` evaluation after N steps (default: 100000) | +| [`/constexpr:steps`](constexpr-control-constexpr-evaluation.md) | Terminate `constexpr` evaluation after N steps (default: 100000). | | [`/openmp`](openmp-enable-openmp-2-0-support.md) | Enables [`#pragma omp`](../../preprocessor/omp.md) in source code. | | [`/openmp:experimental`](openmp-enable-openmp-2-0-support.md) | Enable OpenMP 2.0 language extensions plus select OpenMP 3.0+ language extensions. | | [`/openmp:llvm`](openmp-enable-openmp-2-0-support.md) | OpenMP language extensions using LLVM runtime. | @@ -188,7 +188,7 @@ This article contains a categorical list of compiler options. For an alphabetica | [`/Zc:externConstexpr[-]`](zc-externconstexpr.md) | Enable external linkage for **`constexpr`** variables (off by default). | | [`/Zc:forScope[-]`](zc-forscope-force-conformance-in-for-loop-scope.md) | Enforce Standard C++ **`for`** scoping rules (on by default). | | [`/Zc:gotoScope`](zc-gotoscope.md) | Enforce Standard C++ **`goto`** rules around local variable initialization (implied by **`/permissive-`**). | -| [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules (implied by **`/permissive-`**) | +| [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules (implied by **`/permissive-`**). | | [`/Zc:implicitNoexcept[-]`](zc-implicitnoexcept-implicit-exception-specifiers.md) | Enable implicit **`noexcept`** on required functions (on by default). | | [`/Zc:inline[-]`](zc-inline-remove-unreferenced-comdat.md) | Remove unreferenced functions or data if they're COMDAT or have internal linkage only (off by default). | | [`/Zc:lambda[-]`](zc-lambda.md) | Enable new lambda processor for conformance-mode syntactic checks in generic lambdas. | @@ -313,7 +313,7 @@ Experimental options may only be supported by certain versions of the compiler. |--|--| | [`/clr:noAssembly`](clr-common-language-runtime-compilation.md) | Deprecated. Use [`/LN` (Create MSIL Module)](ln-create-msil-module.md) instead. | | [`/errorReport`](errorreport-report-internal-compiler-errors.md) | Deprecated. Error reporting is controlled by [Windows Error Reporting (WER)](/windows/win32/wer/windows-error-reporting) settings. | -| [`/experimental:preprocessor`](experimental-preprocessor.md) | Deprecated. Enables experimental conforming preprocessor support. Use [`/Zc:preprocessor`](zc-preprocessor.md) | +| [`/experimental:preprocessor`](experimental-preprocessor.md) | Deprecated. Enables experimental conforming preprocessor support. Use [`/Zc:preprocessor`](zc-preprocessor.md) instead. | | [`/Fr`](fr-fr-create-dot-sbr-file.md) | Deprecated. Creates a browse information file without local variables. | | [`/Ge`](ge-enable-stack-probes.md) | Deprecated. Activates stack probes. On by default. | | [`/Gm`](gm-enable-minimal-rebuild.md) | Deprecated. Enables minimal rebuild. | From c340b6de9bafdf4880df77e6ad8bb56c0cd5cf24 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 6 Jul 2025 21:46:20 +0800 Subject: [PATCH 0298/1799] Add blockquotes for error messages in range [C1211, C1800] --- docs/error-messages/compiler-errors-1/fatal-error-c1305.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1307.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1308.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1309.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1310.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1311.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1312.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1313.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1350.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1352.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1353.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1382.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1383.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1506.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1508.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1509.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1510.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1601.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1602.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1603.md | 2 +- 20 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1305.md b/docs/error-messages/compiler-errors-1/fatal-error-c1305.md index 35a90daf3c2..7cc5cb3a388 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1305.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1305.md @@ -8,7 +8,7 @@ ms.assetid: 1629c850-e2db-4678-83d8-9bfc85323bc5 --- # Fatal Error C1305 -profile database 'pgd_file' is for a different architecture +> profile database 'pgd_file' is for a different architecture A .pgd file that was generated from the /LTCG:PGINSTRUMENT operation for another platform was passed to [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md) . [Profile-guided optimizations](../../build/profile-guided-optimizations.md) are available for x86 and x64 platforms. However, a .pgd file generated with a /LTCG:PGINSTRUMENT operation for one platform is not valid as input to a /LTCG:PGOPTIMIZE for a different platform. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1307.md b/docs/error-messages/compiler-errors-1/fatal-error-c1307.md index d358e2bbd8b..70d62e92619 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1307.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1307.md @@ -8,7 +8,7 @@ ms.assetid: 6f77d3d4-ba8a-476c-b540-aff19eb4efc4 --- # Fatal Error C1307 -program has been edited since profile data was collected +> program has been edited since profile data was collected When using [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md), the linker detected an input module that was recompiled after /LTCG:PGINSTRUMENT and that the module was changed to the point where existing profile data is no longer relevant. For example, if the call graph changed in the recompiled module, the compiler will generate C1307. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md index 045cd2f5e42..000a5cc1efe 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md @@ -8,7 +8,7 @@ ms.assetid: 46177997-069e-433a-8e20-93c846d78ffd --- # Fatal Error C1308 -linking assemblies is not supported +> linking assemblies is not supported A .netmodule is allowed as input to the linker, but an assembly is not. This error can be generated when an attempt is made to link an assembly compiled with `/clr:safe`. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1309.md b/docs/error-messages/compiler-errors-1/fatal-error-c1309.md index f70ecf7bd42..7eef7be3e06 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1309.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1309.md @@ -8,6 +8,6 @@ ms.assetid: a95363d6-a4f3-45fb-9690-aa7e552093b7 --- # Fatal Error C1309 -Mismatched versions of C2.DLL and PGODB\.DLL +> Mismatched versions of C2.DLL and PGODB\.DLL The toolset you are using to build and use [Profile-Guided Optimizations](../../build/profile-guided-optimizations.md) contains mismatched components. If you cannot manually resolve this error, reinstall Visual C++. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md index 233ae5c7e4d..1d260404cfa 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md @@ -8,7 +8,7 @@ ms.assetid: ac48aa51-8023-42fe-b844-3f8bf228fbef --- # Fatal Error C1310 -profile guided optimizations are not available with OpenMP +> profile guided optimizations are not available with OpenMP You will not be able to link with [/LTCG:PGI](../../build/reference/ltcg-link-time-code-generation.md) any module that was compiled with [/GL](../../build/reference/gl-whole-program-optimization.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1311.md b/docs/error-messages/compiler-errors-1/fatal-error-c1311.md index 93d5084e290..28b3a5e7c60 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1311.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1311.md @@ -8,7 +8,7 @@ ms.assetid: 6590a06c-ce9d-4f17-8f62-c809343143b8 --- # Fatal Error C1311 -COFF format cannot statically initialize 'var' with number byte(s) of an address +> COFF format cannot statically initialize 'var' with number byte(s) of an address An address whose value is not known at compile time cannot be statically assigned to a variable whose type has storage of less than four bytes. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1312.md b/docs/error-messages/compiler-errors-1/fatal-error-c1312.md index 03699b2824c..d6e9dcdf603 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1312.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1312.md @@ -8,6 +8,6 @@ ms.assetid: 1aa7cd0e-d45f-4ae7-a85d-015ebb962eaf --- # Fatal Error C1312 -Too many conditional branches in function. Simplify or refactor source code. +> Too many conditional branches in function. Simplify or refactor source code. The code is too complex for the compiler to process without running out of stack memory. Simplify your code. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1313.md b/docs/error-messages/compiler-errors-1/fatal-error-c1313.md index 629767d0279..9929b7e5409 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1313.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1313.md @@ -8,6 +8,6 @@ ms.assetid: 6c7631c8-6fd7-476a-9303-564717fda0f9 --- # Fatal Error C1313 -compiler limit : type blocks may not be nested deeper than number levels +> compiler limit : type blocks may not be nested deeper than number levels Exception handling (or structured exception handling) blocks were nested too deeply. Simplify your code. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1350.md b/docs/error-messages/compiler-errors-1/fatal-error-c1350.md index 96c160733c6..4bf50f04fc2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1350.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1350.md @@ -8,7 +8,7 @@ ms.assetid: 8bb47c23-ac9c-4a33-9ede-4d63ed9d4ba8 --- # Fatal Error C1350 -error loading dll 'dll': dll not found +> error loading dll 'dll': dll not found The DLL that supports the attempted operation was not found. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1352.md b/docs/error-messages/compiler-errors-1/fatal-error-c1352.md index 3becb52d1f7..c392c6b330c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1352.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1352.md @@ -8,7 +8,7 @@ ms.assetid: d044e8b0-b6ef-4d57-8eb5-6254071be707 --- # Fatal Error C1352 -Invalid or corrupt MSIL in function 'function' from module 'file' +> Invalid or corrupt MSIL in function 'function' from module 'file' A .netmodule was passed to the compiler, but the compiler detected corruption in the file. Ask the person who produced the .netmodule to investigate. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1353.md b/docs/error-messages/compiler-errors-1/fatal-error-c1353.md index d36fe258647..3a8ea4fade9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1353.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1353.md @@ -8,6 +8,6 @@ ms.assetid: 37f55b1d-9e7a-4932-a41e-d593190895d3 --- # Fatal Error C1353 -metadata operation failed: runtime not installed or version mismatch +> metadata operation failed: runtime not installed or version mismatch Reinstall your CLR or Visual Studio. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1382.md b/docs/error-messages/compiler-errors-1/fatal-error-c1382.md index f90ab23a6c1..d29f300c665 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1382.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1382.md @@ -8,7 +8,7 @@ ms.assetid: 7a100f8c-3179-4927-a2f1-98de4c753850 --- # Fatal Error C1382 -the PCH file 'file' has been rebuilt since 'obj' was generated. Please rebuild this object +> the PCH file 'file' has been rebuilt since 'obj' was generated. Please rebuild this object When using [/LTCG](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected a .pch file that is newer than a CIL .obj that points to it. The information in the CIL .obj file is out of date. Rebuild the object. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1383.md b/docs/error-messages/compiler-errors-1/fatal-error-c1383.md index 787baf5bbae..eff2404873a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1383.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1383.md @@ -8,7 +8,7 @@ ms.assetid: ca224d14-d687-4fd6-80c2-8b82f28924ea --- # Fatal Error C1383 -compiler option /GL is incompatible with the installed version of common language runtime +> compiler option /GL is incompatible with the installed version of common language runtime C1383 occurs when you are using a previous version of the common language runtime with a newer compiler, and when you compile with **/clr** and **/GL.** diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1506.md b/docs/error-messages/compiler-errors-1/fatal-error-c1506.md index e439909d468..b94006655ed 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1506.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1506.md @@ -8,7 +8,7 @@ ms.assetid: c73d5702-c898-4a32-b0fa-a118601a1e14 --- # Fatal Error C1506 -unrecoverable block scoping error +> unrecoverable block scoping error The block was too large to compile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1508.md b/docs/error-messages/compiler-errors-1/fatal-error-c1508.md index 1954f3cf0b1..65a90a66977 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1508.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1508.md @@ -8,6 +8,6 @@ ms.assetid: 1112c17d-d60f-470d-b886-fd1a9556c0ea --- # Fatal Error C1508 -compiler limit : 'function' : more than 65535 argument bytes +> compiler limit : 'function' : more than 65535 argument bytes The formal parameters to the function exceed the limit of 65535 bytes. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1509.md b/docs/error-messages/compiler-errors-1/fatal-error-c1509.md index b716a1d9a16..5f5309cbbe3 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1509.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1509.md @@ -8,7 +8,7 @@ ms.assetid: 40dd100d-c6ba-451c-bd26-2c99ec1c36d6 --- # Fatal Error C1509 -compiler limit : too many exception handler states in function 'function'. simplify function +> compiler limit : too many exception handler states in function 'function'. simplify function The code exceeds an internal limit on exception handler states (32,768 states). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1510.md b/docs/error-messages/compiler-errors-1/fatal-error-c1510.md index 382b7e07cbf..106b5719f0d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1510.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1510.md @@ -8,7 +8,7 @@ ms.assetid: 150c827f-9514-41a9-8d7e-82f820749bcb --- # Fatal Error C1510 -Cannot open language resource clui.dll +> Cannot open language resource clui.dll The compiler can't load the language resource DLL. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1601.md b/docs/error-messages/compiler-errors-1/fatal-error-c1601.md index b0ccf6cebf2..955976c93c5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1601.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1601.md @@ -8,6 +8,6 @@ ms.assetid: 25797c39-f085-4d75-9eab-159ecd36ef49 --- # Fatal Error C1601 -unsupported inline assembly opcode +> unsupported inline assembly opcode This error indicates a mismatch in your compiler .exe files, which may have occurred because of an incomplete installation. For example, you may have installed a service pack but not the Processor Pack. Install all required products. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1602.md b/docs/error-messages/compiler-errors-1/fatal-error-c1602.md index 5565ea2d137..93730795a77 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1602.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1602.md @@ -8,6 +8,6 @@ ms.assetid: a9365c58-fe66-49c4-a702-9bb75429cc1a --- # Fatal Error C1602 -unsupported intrinsic +> unsupported intrinsic This error indicates a mismatch in your compiler .exe files, which may have occurred because of an incomplete installation. For example, you may have installed a service pack but not the Processor Pack. Install all required products. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1603.md b/docs/error-messages/compiler-errors-1/fatal-error-c1603.md index 4f6744a59e1..ffe596a2a10 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1603.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1603.md @@ -8,6 +8,6 @@ ms.assetid: e5a06925-f916-4637-8240-6d2d280e6124 --- # Fatal Error C1603 -inline assembly branch target out of range by 'number' bytes +> inline assembly branch target out of range by 'number' bytes The computed distance between a JCXZ or JECXZ instruction and its specified target label was greater than 128 bytes. Update your code so that the label is closer to the instruction. From cd10305295cf876d71f49707631564ef080519a0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 6 Jul 2025 21:50:15 +0800 Subject: [PATCH 0299/1799] Add "Remarks" and "Example" headings for error references in range [C1211, C1800] --- docs/error-messages/compiler-errors-1/fatal-error-c1211.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1305.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1307.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1308.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1309.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1310.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1311.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1312.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1313.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1350.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1351.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1352.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1353.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1382.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1383.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1506.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1508.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1509.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1510.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1601.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1602.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1603.md | 2 ++ 22 files changed, 50 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1211.md b/docs/error-messages/compiler-errors-1/fatal-error-c1211.md index 174c78ea004..35c28f55882 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1211.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1211.md @@ -10,6 +10,8 @@ ms.assetid: df0ca70d-ec6e-4400-926a-b877e2599978 > The TypeForwardedTo Custom Attribute is not supported by the version of the runtime installed +## Remarks + C1211 occurs when you have a compiler for the current release, but a common language runtime from a previous release. Some functionality of the compiler may not work on a previous version of the run time. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1305.md b/docs/error-messages/compiler-errors-1/fatal-error-c1305.md index 7cc5cb3a388..e7bb64c8048 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1305.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1305.md @@ -10,6 +10,8 @@ ms.assetid: 1629c850-e2db-4678-83d8-9bfc85323bc5 > profile database 'pgd_file' is for a different architecture +## Remarks + A .pgd file that was generated from the /LTCG:PGINSTRUMENT operation for another platform was passed to [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md) . [Profile-guided optimizations](../../build/profile-guided-optimizations.md) are available for x86 and x64 platforms. However, a .pgd file generated with a /LTCG:PGINSTRUMENT operation for one platform is not valid as input to a /LTCG:PGOPTIMIZE for a different platform. To resolve this error, only pass a .pgd file that is created with /LTCG:PGINSTRUMENT to /LTCG:PGOPTIMIZE on the same platform. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1307.md b/docs/error-messages/compiler-errors-1/fatal-error-c1307.md index 70d62e92619..fecf0bbd30e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1307.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1307.md @@ -10,6 +10,8 @@ ms.assetid: 6f77d3d4-ba8a-476c-b540-aff19eb4efc4 > program has been edited since profile data was collected +## Remarks + When using [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md), the linker detected an input module that was recompiled after /LTCG:PGINSTRUMENT and that the module was changed to the point where existing profile data is no longer relevant. For example, if the call graph changed in the recompiled module, the compiler will generate C1307. To resolve this error, run /LTCG:PGINSTRUMENT, redo all test runs, and run /LTCG:PGOPTIMIZE. If you cannot run /LTCG:PGINSTRUMENT and redo all test runs, use /LTCG:PGUPDATE instead of /LTCG:PGOPTIMIZE to create the optimized image. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md index 000a5cc1efe..d4d3327d491 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md @@ -10,10 +10,14 @@ ms.assetid: 46177997-069e-433a-8e20-93c846d78ffd > linking assemblies is not supported +## Remarks + A .netmodule is allowed as input to the linker, but an assembly is not. This error can be generated when an attempt is made to link an assembly compiled with `/clr:safe`. For more information, see [.netmodule Files as Linker Input](../../build/reference/netmodule-files-as-linker-input.md). +## Example + The following sample generates C1308: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1309.md b/docs/error-messages/compiler-errors-1/fatal-error-c1309.md index 7eef7be3e06..46cef0bc40d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1309.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1309.md @@ -10,4 +10,6 @@ ms.assetid: a95363d6-a4f3-45fb-9690-aa7e552093b7 > Mismatched versions of C2.DLL and PGODB\.DLL +## Remarks + The toolset you are using to build and use [Profile-Guided Optimizations](../../build/profile-guided-optimizations.md) contains mismatched components. If you cannot manually resolve this error, reinstall Visual C++. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md index 1d260404cfa..4d191d2b79b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md @@ -10,8 +10,12 @@ ms.assetid: ac48aa51-8023-42fe-b844-3f8bf228fbef > profile guided optimizations are not available with OpenMP +## Remarks + You will not be able to link with [/LTCG:PGI](../../build/reference/ltcg-link-time-code-generation.md) any module that was compiled with [/GL](../../build/reference/gl-whole-program-optimization.md). +## Example + The following sample generates C1310: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1311.md b/docs/error-messages/compiler-errors-1/fatal-error-c1311.md index 28b3a5e7c60..b26876092e9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1311.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1311.md @@ -10,10 +10,14 @@ ms.assetid: 6590a06c-ce9d-4f17-8f62-c809343143b8 > COFF format cannot statically initialize 'var' with number byte(s) of an address +## Remarks + An address whose value is not known at compile time cannot be statically assigned to a variable whose type has storage of less than four bytes. This error can occur on code that is otherwise valid C++. +## Example + The following example shows one condition that might cause C1311. ``` diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1312.md b/docs/error-messages/compiler-errors-1/fatal-error-c1312.md index d6e9dcdf603..a96329cd5f2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1312.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1312.md @@ -10,4 +10,6 @@ ms.assetid: 1aa7cd0e-d45f-4ae7-a85d-015ebb962eaf > Too many conditional branches in function. Simplify or refactor source code. +## Remarks + The code is too complex for the compiler to process without running out of stack memory. Simplify your code. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1313.md b/docs/error-messages/compiler-errors-1/fatal-error-c1313.md index 9929b7e5409..6e7fbb67b1e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1313.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1313.md @@ -10,4 +10,6 @@ ms.assetid: 6c7631c8-6fd7-476a-9303-564717fda0f9 > compiler limit : type blocks may not be nested deeper than number levels +## Remarks + Exception handling (or structured exception handling) blocks were nested too deeply. Simplify your code. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1350.md b/docs/error-messages/compiler-errors-1/fatal-error-c1350.md index 4bf50f04fc2..ec6d0ce0d2d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1350.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1350.md @@ -10,6 +10,8 @@ ms.assetid: 8bb47c23-ac9c-4a33-9ede-4d63ed9d4ba8 > error loading dll 'dll': dll not found +## Remarks + The DLL that supports the attempted operation was not found. This indicates a problem with your installation and you should reinstall the DLL from your product CD. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1351.md b/docs/error-messages/compiler-errors-1/fatal-error-c1351.md index 9e772faf2c1..66b5cfc6f84 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1351.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1351.md @@ -10,6 +10,8 @@ ms.assetid: 1f8502e4-1049-49c7-bbe3-fa101c79021e > error loading dll '*dll*': incompatible version +## Remarks + The wrong version of a DLL was found. This indicates a problem with your installation, and you should reinstall Visual Studio. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1352.md b/docs/error-messages/compiler-errors-1/fatal-error-c1352.md index c392c6b330c..22c40491576 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1352.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1352.md @@ -10,6 +10,8 @@ ms.assetid: d044e8b0-b6ef-4d57-8eb5-6254071be707 > Invalid or corrupt MSIL in function 'function' from module 'file' +## Remarks + A .netmodule was passed to the compiler, but the compiler detected corruption in the file. Ask the person who produced the .netmodule to investigate. The compiler does not check .netmodule files for all types of corruption. It does, however, check that all control paths in a function contain a return statement. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1353.md b/docs/error-messages/compiler-errors-1/fatal-error-c1353.md index 3a8ea4fade9..866e174f894 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1353.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1353.md @@ -10,4 +10,6 @@ ms.assetid: 37f55b1d-9e7a-4932-a41e-d593190895d3 > metadata operation failed: runtime not installed or version mismatch +## Remarks + Reinstall your CLR or Visual Studio. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1382.md b/docs/error-messages/compiler-errors-1/fatal-error-c1382.md index d29f300c665..0d8a23afaad 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1382.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1382.md @@ -10,6 +10,8 @@ ms.assetid: 7a100f8c-3179-4927-a2f1-98de4c753850 > the PCH file 'file' has been rebuilt since 'obj' was generated. Please rebuild this object +## Remarks + When using [/LTCG](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected a .pch file that is newer than a CIL .obj that points to it. The information in the CIL .obj file is out of date. Rebuild the object. C1382 can also occur if you compile with **/Yc**, but also pass multiple source code files to the compiler. To resolve, do not use **/Yc** when passing multiple source code files to the compiler. For more information, see [/Yc (Create Precompiled Header File)](../../build/reference/yc-create-precompiled-header-file.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1383.md b/docs/error-messages/compiler-errors-1/fatal-error-c1383.md index eff2404873a..f1b2794e7c3 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1383.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1383.md @@ -10,6 +10,8 @@ ms.assetid: ca224d14-d687-4fd6-80c2-8b82f28924ea > compiler option /GL is incompatible with the installed version of common language runtime +## Remarks + C1383 occurs when you are using a previous version of the common language runtime with a newer compiler, and when you compile with **/clr** and **/GL.** To resolve, either do not use **/GL** with **/clr** or install the version of the common language runtime that shipped with your compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1506.md b/docs/error-messages/compiler-errors-1/fatal-error-c1506.md index b94006655ed..aebd947d498 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1506.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1506.md @@ -10,6 +10,8 @@ ms.assetid: c73d5702-c898-4a32-b0fa-a118601a1e14 > unrecoverable block scoping error +## Remarks + The block was too large to compile. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1508.md b/docs/error-messages/compiler-errors-1/fatal-error-c1508.md index 65a90a66977..96f07791390 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1508.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1508.md @@ -10,4 +10,6 @@ ms.assetid: 1112c17d-d60f-470d-b886-fd1a9556c0ea > compiler limit : 'function' : more than 65535 argument bytes +## Remarks + The formal parameters to the function exceed the limit of 65535 bytes. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1509.md b/docs/error-messages/compiler-errors-1/fatal-error-c1509.md index 5f5309cbbe3..55a726da7e6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1509.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1509.md @@ -10,6 +10,8 @@ ms.assetid: 40dd100d-c6ba-451c-bd26-2c99ec1c36d6 > compiler limit : too many exception handler states in function 'function'. simplify function +## Remarks + The code exceeds an internal limit on exception handler states (32,768 states). The most common cause is that the function contains a complex expression of user-defined class variables and arithmetic operators. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1510.md b/docs/error-messages/compiler-errors-1/fatal-error-c1510.md index 106b5719f0d..4da72a3854c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1510.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1510.md @@ -10,6 +10,8 @@ ms.assetid: 150c827f-9514-41a9-8d7e-82f820749bcb > Cannot open language resource clui.dll +## Remarks + The compiler can't load the language resource DLL. There are two common causes for this issue. When using the 32-bit compiler and tools, you may see this error for large projects that use more than 2GB of memory during a link. A possible solution on 64-bit Windows systems is to use the 64-bit native or cross compiler and tools to generate your code. This takes advantage of the larger memory space available to 64-bit apps. If you must use a 32-bit compiler because you are running on a 32-bit system, in some cases you can increase the amount of memory available to the linker to 3GB. For more information, see [4-Gigabyte Tuning: BCDEdit and Boot.ini](/windows/win32/memory/4-gigabyte-tuning) and the [BCDEdit /set increaseuserva](/windows-hardware/drivers/devtest/bcdedit--set) command. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1601.md b/docs/error-messages/compiler-errors-1/fatal-error-c1601.md index 955976c93c5..7267012122f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1601.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1601.md @@ -10,4 +10,6 @@ ms.assetid: 25797c39-f085-4d75-9eab-159ecd36ef49 > unsupported inline assembly opcode +## Remarks + This error indicates a mismatch in your compiler .exe files, which may have occurred because of an incomplete installation. For example, you may have installed a service pack but not the Processor Pack. Install all required products. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1602.md b/docs/error-messages/compiler-errors-1/fatal-error-c1602.md index 93730795a77..6fdc19d7719 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1602.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1602.md @@ -10,4 +10,6 @@ ms.assetid: a9365c58-fe66-49c4-a702-9bb75429cc1a > unsupported intrinsic +## Remarks + This error indicates a mismatch in your compiler .exe files, which may have occurred because of an incomplete installation. For example, you may have installed a service pack but not the Processor Pack. Install all required products. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1603.md b/docs/error-messages/compiler-errors-1/fatal-error-c1603.md index ffe596a2a10..d2c2014b1aa 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1603.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1603.md @@ -10,4 +10,6 @@ ms.assetid: e5a06925-f916-4637-8240-6d2d280e6124 > inline assembly branch target out of range by 'number' bytes +## Remarks + The computed distance between a JCXZ or JECXZ instruction and its specified target label was greater than 128 bytes. Update your code so that the label is closer to the instruction. From 23624444478fe704299f3a38373b00ffc21a94f9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 6 Jul 2025 21:52:07 +0800 Subject: [PATCH 0300/1799] Replace term "sample" with "example" for error references in range [C1211, C1800] --- docs/error-messages/compiler-errors-1/fatal-error-c1308.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1310.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md index d4d3327d491..6f7ce7973a4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md @@ -18,7 +18,7 @@ For more information, see [.netmodule Files as Linker Input](../../build/referen ## Example -The following sample generates C1308: +The following example generates C1308: ```cpp // C1308.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md index 4d191d2b79b..d69080beb67 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md @@ -16,7 +16,7 @@ You will not be able to link with [/LTCG:PGI](../../build/reference/ltcg-link-ti ## Example -The following sample generates C1310: +The following example generates C1310: ```cpp // C1310.cpp From 3b8565ef1e04ce28b561e6dbfb371d071603086b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 6 Jul 2025 21:57:17 +0800 Subject: [PATCH 0301/1799] Update metadata for error references in range [C1211, C1800] --- docs/error-messages/compiler-errors-1/fatal-error-c1211.md | 3 +-- docs/error-messages/compiler-errors-1/fatal-error-c1305.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1307.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1308.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1309.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1310.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1311.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1312.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1313.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1350.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1351.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1352.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1353.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1382.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1383.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1506.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1508.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1509.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1510.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1601.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1602.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1603.md | 5 ++--- 22 files changed, 43 insertions(+), 65 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1211.md b/docs/error-messages/compiler-errors-1/fatal-error-c1211.md index 35c28f55882..24359b9c00c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1211.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1211.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1211" title: "Fatal Error C1211" +description: "Learn more about: Fatal Error C1211" ms.date: 08/17/2022 f1_keywords: ["C1211"] helpviewer_keywords: ["C1211"] -ms.assetid: df0ca70d-ec6e-4400-926a-b877e2599978 --- # Fatal Error C1211 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1305.md b/docs/error-messages/compiler-errors-1/fatal-error-c1305.md index e7bb64c8048..398c483eb5f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1305.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1305.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1305" title: "Fatal Error C1305" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1305" +ms.date: 11/04/2016 f1_keywords: ["C1305"] helpviewer_keywords: ["C1305"] -ms.assetid: 1629c850-e2db-4678-83d8-9bfc85323bc5 --- # Fatal Error C1305 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1307.md b/docs/error-messages/compiler-errors-1/fatal-error-c1307.md index fecf0bbd30e..27c1ed010ea 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1307.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1307.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1307" title: "Fatal Error C1307" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1307" +ms.date: 11/04/2016 f1_keywords: ["C1307"] helpviewer_keywords: ["C1307"] -ms.assetid: 6f77d3d4-ba8a-476c-b540-aff19eb4efc4 --- # Fatal Error C1307 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md index 6f7ce7973a4..81335e1a835 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1308" title: "Fatal Error C1308" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1308" +ms.date: 11/04/2016 f1_keywords: ["C1308"] helpviewer_keywords: ["C1308"] -ms.assetid: 46177997-069e-433a-8e20-93c846d78ffd --- # Fatal Error C1308 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1309.md b/docs/error-messages/compiler-errors-1/fatal-error-c1309.md index 46cef0bc40d..0bd33544bfd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1309.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1309.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1309" title: "Fatal Error C1309" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1309" +ms.date: 11/04/2016 f1_keywords: ["C1309"] helpviewer_keywords: ["C1309"] -ms.assetid: a95363d6-a4f3-45fb-9690-aa7e552093b7 --- # Fatal Error C1309 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md index d69080beb67..5fef1f9c37b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1310" title: "Fatal Error C1310" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1310" +ms.date: 11/04/2016 f1_keywords: ["C1310"] helpviewer_keywords: ["C1310"] -ms.assetid: ac48aa51-8023-42fe-b844-3f8bf228fbef --- # Fatal Error C1310 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1311.md b/docs/error-messages/compiler-errors-1/fatal-error-c1311.md index b26876092e9..fdb102ebbda 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1311.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1311.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1311" title: "Fatal Error C1311" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1311" +ms.date: 11/04/2016 f1_keywords: ["C1311"] helpviewer_keywords: ["C1311"] -ms.assetid: 6590a06c-ce9d-4f17-8f62-c809343143b8 --- # Fatal Error C1311 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1312.md b/docs/error-messages/compiler-errors-1/fatal-error-c1312.md index a96329cd5f2..3173bfba076 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1312.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1312.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1312" title: "Fatal Error C1312" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1312" +ms.date: 11/04/2016 f1_keywords: ["C1312"] helpviewer_keywords: ["C1312"] -ms.assetid: 1aa7cd0e-d45f-4ae7-a85d-015ebb962eaf --- # Fatal Error C1312 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1313.md b/docs/error-messages/compiler-errors-1/fatal-error-c1313.md index 6e7fbb67b1e..90814b3406e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1313.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1313.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1313" title: "Fatal Error C1313" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1313" +ms.date: 11/04/2016 f1_keywords: ["C1313"] helpviewer_keywords: ["C1313"] -ms.assetid: 6c7631c8-6fd7-476a-9303-564717fda0f9 --- # Fatal Error C1313 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1350.md b/docs/error-messages/compiler-errors-1/fatal-error-c1350.md index ec6d0ce0d2d..dcb1474a08b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1350.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1350.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1350" title: "Fatal Error C1350" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1350" +ms.date: 11/04/2016 f1_keywords: ["C1350"] helpviewer_keywords: ["C1350"] -ms.assetid: 8bb47c23-ac9c-4a33-9ede-4d63ed9d4ba8 --- # Fatal Error C1350 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1351.md b/docs/error-messages/compiler-errors-1/fatal-error-c1351.md index 66b5cfc6f84..2019a263242 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1351.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1351.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1351" title: "Fatal Error C1351" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1351" +ms.date: 11/04/2016 f1_keywords: ["C1351"] helpviewer_keywords: ["C1351"] -ms.assetid: 1f8502e4-1049-49c7-bbe3-fa101c79021e --- # Fatal Error C1351 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1352.md b/docs/error-messages/compiler-errors-1/fatal-error-c1352.md index 22c40491576..581c2864959 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1352.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1352.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1352" title: "Fatal Error C1352" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1352" +ms.date: 11/04/2016 f1_keywords: ["C1352"] helpviewer_keywords: ["C1352"] -ms.assetid: d044e8b0-b6ef-4d57-8eb5-6254071be707 --- # Fatal Error C1352 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1353.md b/docs/error-messages/compiler-errors-1/fatal-error-c1353.md index 866e174f894..48b39279dd2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1353.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1353.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1353" title: "Fatal Error C1353" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1353" +ms.date: 11/04/2016 f1_keywords: ["C1353"] helpviewer_keywords: ["C1353"] -ms.assetid: 37f55b1d-9e7a-4932-a41e-d593190895d3 --- # Fatal Error C1353 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1382.md b/docs/error-messages/compiler-errors-1/fatal-error-c1382.md index 0d8a23afaad..f61a7a1fa02 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1382.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1382.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1382" title: "Fatal Error C1382" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1382" +ms.date: 11/04/2016 f1_keywords: ["C1382"] helpviewer_keywords: ["C1382"] -ms.assetid: 7a100f8c-3179-4927-a2f1-98de4c753850 --- # Fatal Error C1382 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1383.md b/docs/error-messages/compiler-errors-1/fatal-error-c1383.md index f1b2794e7c3..f826a4c3a1c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1383.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1383.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1383" title: "Fatal Error C1383" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1383" +ms.date: 11/04/2016 f1_keywords: ["C1383"] helpviewer_keywords: ["C1383"] -ms.assetid: ca224d14-d687-4fd6-80c2-8b82f28924ea --- # Fatal Error C1383 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1506.md b/docs/error-messages/compiler-errors-1/fatal-error-c1506.md index aebd947d498..2509bc5f2b6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1506.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1506.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1506" title: "Fatal Error C1506" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1506" +ms.date: 11/04/2016 f1_keywords: ["C1506"] helpviewer_keywords: ["C1506"] -ms.assetid: c73d5702-c898-4a32-b0fa-a118601a1e14 --- # Fatal Error C1506 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1508.md b/docs/error-messages/compiler-errors-1/fatal-error-c1508.md index 96f07791390..394368d4291 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1508.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1508.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1508" title: "Fatal Error C1508" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1508" +ms.date: 11/04/2016 f1_keywords: ["C1508"] helpviewer_keywords: ["C1508"] -ms.assetid: 1112c17d-d60f-470d-b886-fd1a9556c0ea --- # Fatal Error C1508 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1509.md b/docs/error-messages/compiler-errors-1/fatal-error-c1509.md index 55a726da7e6..1a17d1c7f5b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1509.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1509.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1509" title: "Fatal Error C1509" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1509" +ms.date: 11/04/2016 f1_keywords: ["C1509"] helpviewer_keywords: ["C1509"] -ms.assetid: 40dd100d-c6ba-451c-bd26-2c99ec1c36d6 --- # Fatal Error C1509 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1510.md b/docs/error-messages/compiler-errors-1/fatal-error-c1510.md index 4da72a3854c..640a564c8fd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1510.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1510.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1510" title: "Fatal Error C1510" -ms.date: "04/11/2017" +description: "Learn more about: Fatal Error C1510" +ms.date: 04/11/2017 f1_keywords: ["C1510"] helpviewer_keywords: ["C1510"] -ms.assetid: 150c827f-9514-41a9-8d7e-82f820749bcb --- # Fatal Error C1510 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1601.md b/docs/error-messages/compiler-errors-1/fatal-error-c1601.md index 7267012122f..f36aca8a88d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1601.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1601.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1601" title: "Fatal Error C1601" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1601" +ms.date: 11/04/2016 f1_keywords: ["C1601"] helpviewer_keywords: ["C1601"] -ms.assetid: 25797c39-f085-4d75-9eab-159ecd36ef49 --- # Fatal Error C1601 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1602.md b/docs/error-messages/compiler-errors-1/fatal-error-c1602.md index 6fdc19d7719..5f29077c41f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1602.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1602.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1602" title: "Fatal Error C1602" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1602" +ms.date: 11/04/2016 f1_keywords: ["C1602"] helpviewer_keywords: ["C1602"] -ms.assetid: a9365c58-fe66-49c4-a702-9bb75429cc1a --- # Fatal Error C1602 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1603.md b/docs/error-messages/compiler-errors-1/fatal-error-c1603.md index d2c2014b1aa..8e8fe6f3782 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1603.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1603.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1603" title: "Fatal Error C1603" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1603" +ms.date: 11/04/2016 f1_keywords: ["C1603"] helpviewer_keywords: ["C1603"] -ms.assetid: e5a06925-f916-4637-8240-6d2d280e6124 --- # Fatal Error C1603 From 02ace856c8bea046e38588823af968921619aad9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 7 Jul 2025 23:12:47 +0800 Subject: [PATCH 0302/1799] Include namespace prefix in links --- docs/parallel/amp/reference/array-class.md | 2 +- docs/parallel/concrt/asynchronous-message-blocks.md | 4 ++-- docs/parallel/concrt/contexts.md | 4 ++-- .../concrt/how-to-send-a-message-at-a-regular-interval.md | 2 +- docs/parallel/concrt/parallel-algorithms.md | 6 +++--- docs/parallel/concrt/schedule-groups.md | 2 +- .../parallel/concrt/task-parallelism-concurrency-runtime.md | 4 ++-- .../concrt/walkthrough-creating-a-custom-message-block.md | 4 ++-- docs/parallel/concrt/walkthrough-implementing-futures.md | 2 +- 9 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/parallel/amp/reference/array-class.md b/docs/parallel/amp/reference/array-class.md index e7a9eea52c6..5fd455d1f15 100644 --- a/docs/parallel/amp/reference/array-class.md +++ b/docs/parallel/amp/reference/array-class.md @@ -51,7 +51,7 @@ The rank of the array. |Name|Description| |----------|-----------------| -|[`operator std::vector`](#operator_vec)|Uses `copy(*this, vector)` to implicitly convert the array to a std::[vector](../../../standard-library/vector-class.md) object.| +|[`operator std::vector`](#operator_vec)|Uses `copy(*this, vector)` to implicitly convert the array to a [std::vector](../../../standard-library/vector-class.md) object.| |[operator()](#operator_call)|Returns the element value that is specified by the parameters.| |[operator\[\]](#operator_at)|Returns the element that is at the specified index.| |[operator=](#operator_eq)|Copies the contents of the specified `array` object into this one.| diff --git a/docs/parallel/concrt/asynchronous-message-blocks.md b/docs/parallel/concrt/asynchronous-message-blocks.md index 54f4c8092f9..14f3a67370a 100644 --- a/docs/parallel/concrt/asynchronous-message-blocks.md +++ b/docs/parallel/concrt/asynchronous-message-blocks.md @@ -257,7 +257,7 @@ The [concurrency::join](../../parallel/concrt/reference/join-class.md) and [conc Reading from a `join` or `multitype_join` object resembles calling the Windows API function `WaitForMultipleObjects` when it has the `bWaitAll` parameter set to `TRUE`. However, just like a `choice` object, `join` and `multitype_join` objects use an event mechanism that binds data to the event itself instead of to an external synchronization object. -Reading from a `join` object produces a std::[vector](../../standard-library/vector-class.md) object. Reading from a `multitype_join` object produces a std::[tuple](../../standard-library/tuple-class.md) object. Elements appear in these objects in the same order as their corresponding source buffers are linked to the `join` or `multitype_join` object. Because the order in which you link source buffers to a `join` or `multitype_join` object is associated with the order of elements in the resulting `vector` or `tuple` object, we recommend that you do not unlink an existing source buffer from a join. Doing so can result in unspecified behavior. +Reading from a `join` object produces a [std::vector](../../standard-library/vector-class.md) object. Reading from a `multitype_join` object produces a [std::tuple](../../standard-library/tuple-class.md) object. Elements appear in these objects in the same order as their corresponding source buffers are linked to the `join` or `multitype_join` object. Because the order in which you link source buffers to a `join` or `multitype_join` object is associated with the order of elements in the resulting `vector` or `tuple` object, we recommend that you do not unlink an existing source buffer from a join. Doing so can result in unspecified behavior. ### Greedy Versus Non-Greedy Joins @@ -285,7 +285,7 @@ For complete examples that show how to use the `join` class, see [How to: Select ## timer Class -The concurrency::[timer class](../../parallel/concrt/reference/timer-class.md) acts as a message source. A `timer` object sends a message to a target after a specified period of time has elapsed. The `timer` class is useful when you must delay sending a message or you want to send a message at a regular interval. +The [concurrency::timer class](../../parallel/concrt/reference/timer-class.md) acts as a message source. A `timer` object sends a message to a target after a specified period of time has elapsed. The `timer` class is useful when you must delay sending a message or you want to send a message at a regular interval. The `timer` class sends its message to just one target. If you set the `_PTarget` parameter in the constructor to `NULL`, you can later specify the target by calling the [concurrency::ISource::link_target](reference/source-block-class.md#link_target) method. diff --git a/docs/parallel/concrt/contexts.md b/docs/parallel/concrt/contexts.md index 47042ab9efe..01840e36c4f 100644 --- a/docs/parallel/concrt/contexts.md +++ b/docs/parallel/concrt/contexts.md @@ -7,7 +7,7 @@ ms.assetid: 10c1d861-8fbb-4ba0-b2ec-61876b11176e --- # Contexts -This document describes the role of contexts in the Concurrency Runtime. A thread that is attached to a scheduler is known as an *execution context*, or just *context*. The [concurrency::wait](reference/concurrency-namespace-functions.md#wait) function and the concurrency::[Context class](../../parallel/concrt/reference/context-class.md) enable you to control the behavior of contexts. Use the `wait` function to suspend the current context for a specified time. Use the `Context` class when you need more control over when contexts block, unblock, and yield, or when you want to oversubscribe the current context. +This document describes the role of contexts in the Concurrency Runtime. A thread that is attached to a scheduler is known as an *execution context*, or just *context*. The [concurrency::wait](reference/concurrency-namespace-functions.md#wait) function and the [concurrency::Context class](../../parallel/concrt/reference/context-class.md) enable you to control the behavior of contexts. Use the `wait` function to suspend the current context for a specified time. Use the `Context` class when you need more control over when contexts block, unblock, and yield, or when you want to oversubscribe the current context. > [!TIP] > The Concurrency Runtime provides a default scheduler, and therefore you are not required to create one in your application. Because the Task Scheduler helps you fine-tune the performance of your applications, we recommend that you start with the [Parallel Patterns Library (PPL)](../../parallel/concrt/parallel-patterns-library-ppl.md) or the [Asynchronous Agents Library](../../parallel/concrt/asynchronous-agents-library.md) if you are new to the Concurrency Runtime. @@ -24,7 +24,7 @@ For an example that uses the `wait` function to yield the current context, and t ## The Context Class -The concurrency::[Context class](../../parallel/concrt/reference/context-class.md) provides a programming abstraction for an execution context and offers two important features: the ability to cooperatively block, unblock, and yield the current context, and the ability to oversubscribe the current context. +The [concurrency::Context class](../../parallel/concrt/reference/context-class.md) provides a programming abstraction for an execution context and offers two important features: the ability to cooperatively block, unblock, and yield the current context, and the ability to oversubscribe the current context. ### Cooperative Blocking diff --git a/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md b/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md index 296c70f1280..911ec3fb3b2 100644 --- a/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md +++ b/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md @@ -7,7 +7,7 @@ ms.assetid: 4b60ea6c-97c8-4d69-9f7b-ad79f3548026 --- # How to: Send a Message at a Regular Interval -This example shows how to use the concurrency::[timer class](../../parallel/concrt/reference/timer-class.md) to send a message at a regular interval. +This example shows how to use the [concurrency::timer class](../../parallel/concrt/reference/timer-class.md) to send a message at a regular interval. ## Example diff --git a/docs/parallel/concrt/parallel-algorithms.md b/docs/parallel/concrt/parallel-algorithms.md index bf70d79533a..26dfffe97fb 100644 --- a/docs/parallel/concrt/parallel-algorithms.md +++ b/docs/parallel/concrt/parallel-algorithms.md @@ -144,7 +144,7 @@ You can use the `parallel transform` algorithm to perform many data parallelizat - Perform 3-D ray tracing, where each iteration refers to one pixel that must be rendered. -The following example shows the basic structure that is used to call the `parallel_transform` algorithm. This example negates each element of a std::[vector](../../standard-library/vector-class.md) object in two ways. The first way uses a lambda expression. The second way uses [std::negate](../../standard-library/negate-struct.md), which derives from [std::unary_function](../../standard-library/unary-function-struct.md). +The following example shows the basic structure that is used to call the `parallel_transform` algorithm. This example negates each element of a [std::vector](../../standard-library/vector-class.md) object in two ways. The first way uses a lambda expression. The second way uses [std::negate](../../standard-library/negate-struct.md), which derives from [std::unary_function](../../standard-library/unary-function-struct.md). [!code-cpp[concrt-basic-parallel-transform#1](../../parallel/concrt/codesnippet/cpp/parallel-algorithms_4.cpp)] @@ -207,7 +207,7 @@ Divides work into ranges such that each range has at least the number of iterati Divides work into a fixed number of ranges (typically the number of worker threads that are available to work on the loop). This partitioner type can improve performance because it does not use work-stealing and therefore has less overhead. Use this partitioner type when each iteration of a parallel loop performs a fixed and uniform amount of work and you do not require support for cancellation or forward cooperative blocking. > [!WARNING] -> The `parallel_for_each` and `parallel_transform` algorithms support only containers that use random access iterators (such as std::[vector](../../standard-library/vector-class.md)) for the static, simple, and affinity partitioners. The use of containers that use bidirectional and forward iterators produces a compile-time error. The default partitioner, `auto_partitioner`, supports all three of these iterator types. +> The `parallel_for_each` and `parallel_transform` algorithms support only containers that use random access iterators (such as [std::vector](../../standard-library/vector-class.md)) for the static, simple, and affinity partitioners. The use of containers that use bidirectional and forward iterators produces a compile-time error. The default partitioner, `auto_partitioner`, supports all three of these iterator types. Typically, these partitioners are used in the same way, except for `affinity_partitioner`. Most partitioner types do not maintain state and are not modified by the runtime. Therefore you can create these partitioner objects at the call site, as shown in the following example. @@ -263,7 +263,7 @@ This example shows how to provide a hash function to the `parallel_radixsort` al For illustration, this example uses a relatively small data set. You can increase the initial size of the vector to experiment with performance improvements over larger sets of data. -This example uses a lambda expression as the hash function. You can also use one of the built-in implementations of the std::[hash class](../../standard-library/hash-class.md) or define your own specialization. You can also use a custom hash function object, as shown in this example: +This example uses a lambda expression as the hash function. You can also use one of the built-in implementations of the [std::hash class](../../standard-library/hash-class.md) or define your own specialization. You can also use a custom hash function object, as shown in this example: [!code-cpp[concrt-parallel-sort-points#2](../../parallel/concrt/codesnippet/cpp/parallel-algorithms_13.cpp)]   diff --git a/docs/parallel/concrt/schedule-groups.md b/docs/parallel/concrt/schedule-groups.md index 72566cc7114..210c4fd5c96 100644 --- a/docs/parallel/concrt/schedule-groups.md +++ b/docs/parallel/concrt/schedule-groups.md @@ -18,7 +18,7 @@ The `SchedulingProtocol` scheduler policy influences the order in which the sche The runtime uses the [concurrency::ScheduleGroup](../../parallel/concrt/reference/schedulegroup-class.md) class to represent schedule groups. To create a `ScheduleGroup` object, call the [concurrency::CurrentScheduler::CreateScheduleGroup](reference/currentscheduler-class.md#createschedulegroup) or [concurrency::Scheduler::CreateScheduleGroup](reference/scheduler-class.md#createschedulegroup) method. The runtime uses a reference-counting mechanism to control the lifetime of `ScheduleGroup` objects, just as it does with `Scheduler` objects. When you create a `ScheduleGroup` object, the runtime sets the reference counter to one. The [concurrency::ScheduleGroup::Reference](reference/schedulegroup-class.md#reference) method increments the reference counter by one. The [concurrency::ScheduleGroup::Release](reference/schedulegroup-class.md#release) method decrements the reference counter by one. -Many types in the Concurrency Runtime let you associate an object together with a schedule group. For example, the [concurrency::agent](../../parallel/concrt/reference/agent-class.md) class and message block classes such as [concurrency::unbounded_buffer](reference/unbounded-buffer-class.md), [concurrency::join](../../parallel/concrt/reference/join-class.md), and concurrency::[timer](reference/timer-class.md), provide overloaded versions of the constructor that take a `ScheduleGroup` object. The runtime uses the `Scheduler` object that is associated with this `ScheduleGroup` object to schedule the task. +Many types in the Concurrency Runtime let you associate an object together with a schedule group. For example, the [concurrency::agent](../../parallel/concrt/reference/agent-class.md) class and message block classes such as [concurrency::unbounded_buffer](reference/unbounded-buffer-class.md), [concurrency::join](../../parallel/concrt/reference/join-class.md), and [concurrency::timer](reference/timer-class.md), provide overloaded versions of the constructor that take a `ScheduleGroup` object. The runtime uses the `Scheduler` object that is associated with this `ScheduleGroup` object to schedule the task. You can also use the [concurrency::ScheduleGroup::ScheduleTask](reference/schedulegroup-class.md#scheduletask) method to schedule a lightweight task. For more information about lightweight tasks, see [Lightweight Tasks](../../parallel/concrt/lightweight-tasks.md). diff --git a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md index 0f71bc66b1a..fabf7eccbba 100644 --- a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md +++ b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md @@ -151,7 +151,7 @@ This section describes the [concurrency::when_all](reference/concurrency-namespa ### The when_all Function -The `when_all` function produces a task that completes after a set of tasks complete. This function returns a std::[vector](../../standard-library/vector-class.md) object that contains the result of each task in the set. The following basic example uses `when_all` to create a task that represents the completion of three other tasks. +The `when_all` function produces a task that completes after a set of tasks complete. This function returns a [std::vector](../../standard-library/vector-class.md) object that contains the result of each task in the set. The following basic example uses `when_all` to create a task that represents the completion of three other tasks. [!code-cpp[concrt-join-tasks#1](../../parallel/concrt/codesnippet/cpp/task-parallelism-concurrency-runtime_8.cpp)] @@ -270,7 +270,7 @@ Unstructured task groups and structured task groups work with task handles in di [!code-cpp[concrt-make-task-structure#1](../../parallel/concrt/codesnippet/cpp/task-parallelism-concurrency-runtime_16.cpp)] -To manage task handles for cases where you have a variable number of tasks, use a stack-allocation routine such as [_malloca](../../c-runtime-library/reference/malloca.md) or a container class, such as std::[vector](../../standard-library/vector-class.md). +To manage task handles for cases where you have a variable number of tasks, use a stack-allocation routine such as [_malloca](../../c-runtime-library/reference/malloca.md) or a container class, such as [std::vector](../../standard-library/vector-class.md). Both `task_group` and `structured_task_group` support cancellation. For more information about cancellation, see [Cancellation in the PPL](cancellation-in-the-ppl.md). diff --git a/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md b/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md index debf678980b..9c9eed901c7 100644 --- a/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md +++ b/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md @@ -57,7 +57,7 @@ The runtime calls the `propagate_message` method to asynchronously transfer a me The `priority_buffer` class is a custom message block type that orders incoming messages first by priority, and then by the order in which messages are received. The `priority_buffer` class resembles the [concurrency::unbounded_buffer](reference/unbounded-buffer-class.md) class because it holds a queue of messages, and also because it acts as both a source and a target message block and can have both multiple sources and multiple targets. However, `unbounded_buffer` bases message propagation only on the order in which it receives messages from its sources. -The `priority_buffer` class receives messages of type std::[tuple](../../standard-library/tuple-class.md) that contain `PriorityType` and `Type` elements. `PriorityType` refers to the type that holds the priority of each message; `Type` refers to the data portion of the message. The `priority_buffer` class sends messages of type `Type`. The `priority_buffer` class also manages two message queues: a [std::priority_queue](../../standard-library/priority-queue-class.md) object for incoming messages and a std::[queue](../../standard-library/queue-class.md) object for outgoing messages. Ordering messages by priority is useful when a `priority_buffer` object receives multiple messages simultaneously or when it receives multiple messages before any messages are read by consumers. +The `priority_buffer` class receives messages of type [std::tuple](../../standard-library/tuple-class.md) that contain `PriorityType` and `Type` elements. `PriorityType` refers to the type that holds the priority of each message; `Type` refers to the data portion of the message. The `priority_buffer` class sends messages of type `Type`. The `priority_buffer` class also manages two message queues: a [std::priority_queue](../../standard-library/priority-queue-class.md) object for incoming messages and a [std::queue](../../standard-library/queue-class.md) object for outgoing messages. Ordering messages by priority is useful when a `priority_buffer` object receives multiple messages simultaneously or when it receives multiple messages before any messages are read by consumers. In addition to the seven methods that a class that derives from `propagator_block` must implement, the `priority_buffer` class also overrides the `link_target_notification` and `send_message` methods. The `priority_buffer` class also defines two public helper methods, `enqueue` and `dequeue`, and a private helper method, `propagate_priority_order`. @@ -71,7 +71,7 @@ The following procedure describes how to implement the `priority_buffer` class. [!code-cpp[concrt-priority-buffer#1](../../parallel/concrt/codesnippet/cpp/walkthrough-creating-a-custom-message-block_2.h)] -1. In the `std` namespace, define specializations of [std::less](../../standard-library/less-struct.md) and [std::greater](../../standard-library/greater-struct.md) that act on concurrency::[message](../../parallel/concrt/reference/message-class.md) objects. +1. In the `std` namespace, define specializations of [std::less](../../standard-library/less-struct.md) and [std::greater](../../standard-library/greater-struct.md) that act on [concurrency::message](../../parallel/concrt/reference/message-class.md) objects. [!code-cpp[concrt-priority-buffer#2](../../parallel/concrt/codesnippet/cpp/walkthrough-creating-a-custom-message-block_3.h)] diff --git a/docs/parallel/concrt/walkthrough-implementing-futures.md b/docs/parallel/concrt/walkthrough-implementing-futures.md index 0eeeb8f2e62..07658394f81 100644 --- a/docs/parallel/concrt/walkthrough-implementing-futures.md +++ b/docs/parallel/concrt/walkthrough-implementing-futures.md @@ -42,7 +42,7 @@ To implement futures, this topic defines the `async_future` class. The `async_fu ### Description -The following example shows the complete `async_future` class and an example of its usage. The `wmain` function creates a std::[vector](../../standard-library/vector-class.md) object that contains 10,000 random integer values. It then uses `async_future` objects to find the smallest and largest values that are contained in the `vector` object. +The following example shows the complete `async_future` class and an example of its usage. The `wmain` function creates a [std::vector](../../standard-library/vector-class.md) object that contains 10,000 random integer values. It then uses `async_future` objects to find the smallest and largest values that are contained in the `vector` object. ### Code From e58598439f3d28017b03e929bbff04d7684efecf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 7 Jul 2025 23:15:58 +0800 Subject: [PATCH 0303/1799] Update metadata for some ConcRT topics --- docs/parallel/concrt/asynchronous-message-blocks.md | 5 ++--- docs/parallel/concrt/contexts.md | 5 ++--- .../concrt/how-to-send-a-message-at-a-regular-interval.md | 5 ++--- docs/parallel/concrt/parallel-algorithms.md | 5 ++--- docs/parallel/concrt/schedule-groups.md | 5 ++--- docs/parallel/concrt/task-parallelism-concurrency-runtime.md | 5 ++--- .../concrt/walkthrough-creating-a-custom-message-block.md | 5 ++--- docs/parallel/concrt/walkthrough-implementing-futures.md | 5 ++--- 8 files changed, 16 insertions(+), 24 deletions(-) diff --git a/docs/parallel/concrt/asynchronous-message-blocks.md b/docs/parallel/concrt/asynchronous-message-blocks.md index 14f3a67370a..dbbe11f411c 100644 --- a/docs/parallel/concrt/asynchronous-message-blocks.md +++ b/docs/parallel/concrt/asynchronous-message-blocks.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Asynchronous Message Blocks" title: "Asynchronous Message Blocks" -ms.date: "11/04/2016" +description: "Learn more about: Asynchronous Message Blocks" +ms.date: 11/04/2016 helpviewer_keywords: ["non-greedy join [Concurrency Runtime]", "asynchronous message blocks", "greedy join [Concurrency Runtime]"] -ms.assetid: 79c456c0-1692-480c-bb67-98f2434c1252 --- # Asynchronous Message Blocks diff --git a/docs/parallel/concrt/contexts.md b/docs/parallel/concrt/contexts.md index 01840e36c4f..371b1142c8d 100644 --- a/docs/parallel/concrt/contexts.md +++ b/docs/parallel/concrt/contexts.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Contexts" title: "Contexts" -ms.date: "11/04/2016" +description: "Learn more about: Contexts" +ms.date: 11/04/2016 helpviewer_keywords: ["contexts [Concurrency Runtime]"] -ms.assetid: 10c1d861-8fbb-4ba0-b2ec-61876b11176e --- # Contexts diff --git a/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md b/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md index 911ec3fb3b2..b1eca2fb42f 100644 --- a/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md +++ b/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: How to: Send a Message at a Regular Interval" title: "How to: Send a Message at a Regular Interval" -ms.date: "11/04/2016" +description: "Learn more about: How to: Send a Message at a Regular Interval" +ms.date: 11/04/2016 helpviewer_keywords: ["timer class, example", "sending messages at regular intervals [Concurrency Runtime]"] -ms.assetid: 4b60ea6c-97c8-4d69-9f7b-ad79f3548026 --- # How to: Send a Message at a Regular Interval diff --git a/docs/parallel/concrt/parallel-algorithms.md b/docs/parallel/concrt/parallel-algorithms.md index 26dfffe97fb..8fb96cb02df 100644 --- a/docs/parallel/concrt/parallel-algorithms.md +++ b/docs/parallel/concrt/parallel-algorithms.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Parallel Algorithms" title: "Parallel Algorithms" -ms.date: "11/19/2018" +description: "Learn more about: Parallel Algorithms" +ms.date: 11/19/2018 helpviewer_keywords: ["parallel algorithms [Concurrency Runtime]"] -ms.assetid: 045dca7b-4d73-4558-a44c-383b88a28473 ms.topic: how-to --- # Parallel Algorithms diff --git a/docs/parallel/concrt/schedule-groups.md b/docs/parallel/concrt/schedule-groups.md index 210c4fd5c96..b50caaa5999 100644 --- a/docs/parallel/concrt/schedule-groups.md +++ b/docs/parallel/concrt/schedule-groups.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Schedule Groups" title: "Schedule Groups" -ms.date: "11/04/2016" +description: "Learn more about: Schedule Groups" +ms.date: 11/04/2016 helpviewer_keywords: ["schedule groups"] -ms.assetid: 03523572-5891-4d17-89ce-fa795605f28b --- # Schedule Groups diff --git a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md index fabf7eccbba..23e2ad45736 100644 --- a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md +++ b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Task Parallelism (Concurrency Runtime)" title: "Task Parallelism (Concurrency Runtime)" -ms.date: "11/04/2016" +description: "Learn more about: Task Parallelism (Concurrency Runtime)" +ms.date: 11/04/2016 helpviewer_keywords: ["structured task groups [Concurrency Runtime]", "structured tasks [Concurrency Runtime]", "task groups [Concurrency Runtime]", "task parallelism", "tasks [Concurrency Runtime]"] -ms.assetid: 42f05ac3-2098-494a-ba84-737fcdcad077 ms.topic: how-to --- # Task Parallelism (Concurrency Runtime) diff --git a/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md b/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md index 9c9eed901c7..c34f0946a6c 100644 --- a/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md +++ b/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Walkthrough: Creating a Custom Message Block" title: "Walkthrough: Creating a Custom Message Block" -ms.date: "04/25/2019" +description: "Learn more about: Walkthrough: Creating a Custom Message Block" +ms.date: 04/25/2019 helpviewer_keywords: ["creating custom message blocks Concurrency Runtime]", "custom message blocks, creating [Concurrency Runtime]"] -ms.assetid: 4c6477ad-613c-4cac-8e94-2c9e63cd43a1 --- # Walkthrough: Creating a Custom Message Block diff --git a/docs/parallel/concrt/walkthrough-implementing-futures.md b/docs/parallel/concrt/walkthrough-implementing-futures.md index 07658394f81..0634c431d40 100644 --- a/docs/parallel/concrt/walkthrough-implementing-futures.md +++ b/docs/parallel/concrt/walkthrough-implementing-futures.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Walkthrough: Implementing Futures" title: "Walkthrough: Implementing Futures" -ms.date: "04/25/2019" +description: "Learn more about: Walkthrough: Implementing Futures" +ms.date: 04/25/2019 helpviewer_keywords: ["implementing futures [Concurrency Runtime]", "futures, implementing [Concurrency Runtime]"] -ms.assetid: 82ea75cc-aaec-4452-b10d-8abce0a87e5b --- # Walkthrough: Implementing Futures From e851f586025b233c5cd07de6b9ebb791902388a1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 7 Jul 2025 23:35:49 +0800 Subject: [PATCH 0304/1799] Add "Remarks" heading for error references in range [C1250, C1260] --- docs/code-quality/c1250.md | 2 ++ docs/code-quality/c1251.md | 2 ++ docs/code-quality/c1252.md | 2 ++ docs/code-quality/c1253.md | 2 ++ docs/code-quality/c1254.md | 2 ++ docs/code-quality/c1255.md | 2 ++ docs/code-quality/c1256.md | 2 ++ docs/code-quality/c1257.md | 2 ++ docs/code-quality/c1258.md | 2 ++ docs/code-quality/c1259.md | 2 ++ docs/code-quality/c1260.md | 2 ++ 11 files changed, 22 insertions(+) diff --git a/docs/code-quality/c1250.md b/docs/code-quality/c1250.md index 26582cfe00d..7b9de9fdfd6 100644 --- a/docs/code-quality/c1250.md +++ b/docs/code-quality/c1250.md @@ -10,4 +10,6 @@ ms.assetid: 3f2385d7-e0d6-4574-8cea-342e82d0aea4 > Unable to load plug-in '*plugin-name*'. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. diff --git a/docs/code-quality/c1251.md b/docs/code-quality/c1251.md index ca58d7858b7..c8273525e40 100644 --- a/docs/code-quality/c1251.md +++ b/docs/code-quality/c1251.md @@ -10,4 +10,6 @@ ms.assetid: 0b46e0a5-c290-48d8-ba4e-f526ae68993b > Unable to load models. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the model file, not in the code being analyzed. diff --git a/docs/code-quality/c1252.md b/docs/code-quality/c1252.md index 4cdf0a16128..a7cee6c377d 100644 --- a/docs/code-quality/c1252.md +++ b/docs/code-quality/c1252.md @@ -10,6 +10,8 @@ ms.assetid: e88bf199-890d-4582-bb5c-c1238797145b > Circular or missing dependency between plugins: '*plugin-name*' requires GUID '*globally-unique-identifier*' +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin dependencies. It's not caused by an issue in the code being analyzed. In some cases, it's possible to work around this issue by disabling the **Enable Code Analysis on Build** property. To disable this build property, open the Property pages dialog for your project. In the **Solution Explorer** window, right-click on the project (not the solution) and select **Properties** in the shortcut menu. Set the **Configuration** to **All Configurations** and the **Platform** to **All Platforms**. Open the **Configuration Properties** > **Code Analysis** > **General** property page. Modify the **Enable Code Analysis on Build** property to **No**. Choose **OK** to save your changes, and then save your project files. Rebuild your project to verify that the issue no longer occurs. diff --git a/docs/code-quality/c1253.md b/docs/code-quality/c1253.md index 32765463140..771f812af7e 100644 --- a/docs/code-quality/c1253.md +++ b/docs/code-quality/c1253.md @@ -10,4 +10,6 @@ ms.assetid: 21a4062f-fde8-40e5-8dbd-6f892926d3d2 > Unable to load model file. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the model file, not in the code being analyzed. diff --git a/docs/code-quality/c1254.md b/docs/code-quality/c1254.md index e584d07eee4..da34273c59e 100644 --- a/docs/code-quality/c1254.md +++ b/docs/code-quality/c1254.md @@ -10,4 +10,6 @@ ms.assetid: cb1377cf-869e-432d-941f-71f77134f97a > Plugin version mismatch: '*module*' version '*version-number*' doesn't match the version '*version-number*' of the PREfast driver +## Remarks + The Code Analysis tool reports this error when there's an internal error with the plugin version, not in the code being analyzed. diff --git a/docs/code-quality/c1255.md b/docs/code-quality/c1255.md index 9480c693e19..6f5f67402d7 100644 --- a/docs/code-quality/c1255.md +++ b/docs/code-quality/c1255.md @@ -10,4 +10,6 @@ ms.assetid: a97da6bd-06dc-42bf-9158-0de1ebb90d4a > PCH data for plugin '*plugin-name*' has incorrect length. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the tool, not in the code being analyzed. diff --git a/docs/code-quality/c1256.md b/docs/code-quality/c1256.md index 54a456fa9e4..1ca7c0e06f5 100644 --- a/docs/code-quality/c1256.md +++ b/docs/code-quality/c1256.md @@ -10,4 +10,6 @@ ms.assetid: 4d65e495-f9d9-435c-ba51-1cf5b4cc2309 > '*plugin-name*': PCH must be both written and read. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the tool, not in the code being analyzed. diff --git a/docs/code-quality/c1257.md b/docs/code-quality/c1257.md index c104af70b72..f44c5425c98 100644 --- a/docs/code-quality/c1257.md +++ b/docs/code-quality/c1257.md @@ -10,4 +10,6 @@ ms.assetid: 38d3ec05-01ba-42b3-aac6-077e92bf2ded > '*Plugin-name*': Initialization Failure. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. diff --git a/docs/code-quality/c1258.md b/docs/code-quality/c1258.md index accca5c1d84..53b0dd5e7f6 100644 --- a/docs/code-quality/c1258.md +++ b/docs/code-quality/c1258.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1258"] > Failed to save XML Log file '*filename*'. *Message*. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. diff --git a/docs/code-quality/c1259.md b/docs/code-quality/c1259.md index 0d22874e871..3772980b6c3 100644 --- a/docs/code-quality/c1259.md +++ b/docs/code-quality/c1259.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1259"] > A fatal error was issued by a plugin. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. diff --git a/docs/code-quality/c1260.md b/docs/code-quality/c1260.md index 6cf3642c1d2..1b069d2c984 100644 --- a/docs/code-quality/c1260.md +++ b/docs/code-quality/c1260.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1260"] > The plugins '*plugin-1*' and '*plugin-2*' share the same id. It is not supported to load the same plugin twice. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. From aa0c28ab2ba0ea09cca730352dc43e839ca183e0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 7 Jul 2025 23:39:33 +0800 Subject: [PATCH 0305/1799] Update metadata for error references in range [C1250, C1260] --- docs/code-quality/c1250.md | 3 +-- docs/code-quality/c1251.md | 3 +-- docs/code-quality/c1252.md | 3 +-- docs/code-quality/c1253.md | 3 +-- docs/code-quality/c1254.md | 3 +-- docs/code-quality/c1255.md | 3 +-- docs/code-quality/c1256.md | 3 +-- docs/code-quality/c1257.md | 3 +-- docs/code-quality/c1258.md | 2 +- docs/code-quality/c1259.md | 2 +- docs/code-quality/c1260.md | 2 +- 11 files changed, 11 insertions(+), 19 deletions(-) diff --git a/docs/code-quality/c1250.md b/docs/code-quality/c1250.md index 7b9de9fdfd6..593bf2fe4df 100644 --- a/docs/code-quality/c1250.md +++ b/docs/code-quality/c1250.md @@ -1,10 +1,9 @@ --- +title: "Fatal error C1250" description: "Learn more about: Fatal error C1250" -title: Fatal error C1250 ms.date: 10/04/2022 f1_keywords: ["C1250", "FATALERROR_UnableToLoadPlugin"] helpviewer_keywords: ["C1250"] -ms.assetid: 3f2385d7-e0d6-4574-8cea-342e82d0aea4 --- # Fatal error C1250 diff --git a/docs/code-quality/c1251.md b/docs/code-quality/c1251.md index c8273525e40..369f49e98ea 100644 --- a/docs/code-quality/c1251.md +++ b/docs/code-quality/c1251.md @@ -1,10 +1,9 @@ --- +title: "Fatal error C1251" description: "Learn more about: Fatal error C1251" -title: Fatal error C1251 ms.date: 10/04/2022 f1_keywords: ["C1251", "FATALERROR_UnableToLoadModel"] helpviewer_keywords: ["C1251"] -ms.assetid: 0b46e0a5-c290-48d8-ba4e-f526ae68993b --- # Fatal error C1251 diff --git a/docs/code-quality/c1252.md b/docs/code-quality/c1252.md index a7cee6c377d..3e679ec2d38 100644 --- a/docs/code-quality/c1252.md +++ b/docs/code-quality/c1252.md @@ -1,10 +1,9 @@ --- +title: "Fatal error C1252" description: "Learn more about: Fatal error C1252" -title: Fatal error C1252 ms.date: 10/04/2022 f1_keywords: ["C1252", "FATALERROR_CircularDependency"] helpviewer_keywords: ["C1252"] -ms.assetid: e88bf199-890d-4582-bb5c-c1238797145b --- # Fatal error C1252 diff --git a/docs/code-quality/c1253.md b/docs/code-quality/c1253.md index 771f812af7e..568be82155e 100644 --- a/docs/code-quality/c1253.md +++ b/docs/code-quality/c1253.md @@ -1,10 +1,9 @@ --- +title: "Fatal error C1253" description: "Learn more about: Fatal error C1253" -title: Fatal error C1253 ms.date: 10/04/2022 f1_keywords: ["C1253", "FATALERROR_UnableToLoadModelFile"] helpviewer_keywords: ["C1253"] -ms.assetid: 21a4062f-fde8-40e5-8dbd-6f892926d3d2 --- # Fatal error C1253 diff --git a/docs/code-quality/c1254.md b/docs/code-quality/c1254.md index da34273c59e..b77f3f40da4 100644 --- a/docs/code-quality/c1254.md +++ b/docs/code-quality/c1254.md @@ -1,10 +1,9 @@ --- +title: "Fatal error C1254" description: "Learn more about: Fatal error C1254" -title: Fatal error C1254 ms.date: 10/04/2022 f1_keywords: ["C1254", "FATALERROR_PluginVersionMismatch"] helpviewer_keywords: ["C1254"] -ms.assetid: cb1377cf-869e-432d-941f-71f77134f97a --- # Fatal error C1254 diff --git a/docs/code-quality/c1255.md b/docs/code-quality/c1255.md index 6f5f67402d7..1f3b9d92e50 100644 --- a/docs/code-quality/c1255.md +++ b/docs/code-quality/c1255.md @@ -1,10 +1,9 @@ --- +title: "Fatal error C1255" description: "Learn more about: Fatal error C1255" -title: Fatal error C1255 ms.date: 10/04/2022 f1_keywords: ["C1255", "FATALERROR_PCHSyncLost"] helpviewer_keywords: ["C1255"] -ms.assetid: a97da6bd-06dc-42bf-9158-0de1ebb90d4a --- # Fatal error C1255 diff --git a/docs/code-quality/c1256.md b/docs/code-quality/c1256.md index 1ca7c0e06f5..bdf7af0eff0 100644 --- a/docs/code-quality/c1256.md +++ b/docs/code-quality/c1256.md @@ -1,10 +1,9 @@ --- +title: "Fatal error C1256" description: "Learn more about: Fatal error C1256" -title: Fatal error C1256 ms.date: 10/04/2022 f1_keywords: ["C1256", "FATALERROR_PCHInconsistent"] helpviewer_keywords: ["C1256"] -ms.assetid: 4d65e495-f9d9-435c-ba51-1cf5b4cc2309 --- # Fatal error C1256 diff --git a/docs/code-quality/c1257.md b/docs/code-quality/c1257.md index f44c5425c98..b4e698c29b9 100644 --- a/docs/code-quality/c1257.md +++ b/docs/code-quality/c1257.md @@ -1,10 +1,9 @@ --- +title: "Fatal error C1257" description: "Learn more about: Fatal error C1257" -title: Fatal error C1257 ms.date: 10/04/2022 f1_keywords: ["C1257", "FATALERROR_InitFailure"] helpviewer_keywords: ["C1257"] -ms.assetid: 38d3ec05-01ba-42b3-aac6-077e92bf2ded --- # Fatal error C1257 diff --git a/docs/code-quality/c1258.md b/docs/code-quality/c1258.md index 53b0dd5e7f6..46de1a74a71 100644 --- a/docs/code-quality/c1258.md +++ b/docs/code-quality/c1258.md @@ -1,6 +1,6 @@ --- +title: "Fatal error C1258" description: "Learn more about: Fatal error C1258" -title: Fatal error C1258 ms.date: 10/04/2022 f1_keywords: ["C1258", "FATALERROR_SaveToXmlFailed"] helpviewer_keywords: ["C1258"] diff --git a/docs/code-quality/c1259.md b/docs/code-quality/c1259.md index 3772980b6c3..0dd892f8aee 100644 --- a/docs/code-quality/c1259.md +++ b/docs/code-quality/c1259.md @@ -1,6 +1,6 @@ --- +title: "Fatal error C1259" description: "Learn more about: Fatal error C1259" -title: Fatal error C1259 ms.date: 10/04/2022 f1_keywords: ["C1259", "FATALERROR_FatalError"] helpviewer_keywords: ["C1259"] diff --git a/docs/code-quality/c1260.md b/docs/code-quality/c1260.md index 1b069d2c984..8142771589a 100644 --- a/docs/code-quality/c1260.md +++ b/docs/code-quality/c1260.md @@ -1,6 +1,6 @@ --- +title: "Fatal error C1260" description: "Learn more about: Fatal error C1260" -title: Fatal error C1260 ms.date: 10/04/2022 f1_keywords: ["C1260", "FATALERROR_DuplicateId"] helpviewer_keywords: ["C1260"] From fd9c602aa900d97448b18632338b3a3d1ff21dc2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 8 Jul 2025 22:06:35 +0800 Subject: [PATCH 0306/1799] Replace "higher" with "later" in requires standard version comments --- docs/c-language/static-assert-c.md | 2 +- docs/c-runtime-library/reference/acos-acosf-acosl.md | 2 +- docs/c-runtime-library/reference/acosh-acoshf-acoshl.md | 2 +- docs/c-runtime-library/reference/asin-asinf-asinl.md | 2 +- docs/c-runtime-library/reference/asinh-asinhf-asinhl.md | 2 +- .../reference/atan-atanf-atanl-atan2-atan2f-atan2l.md | 4 ++-- docs/c-runtime-library/reference/atanh-atanhf-atanhl.md | 2 +- docs/c-runtime-library/reference/carg-cargf-cargl.md | 2 +- docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md | 2 +- docs/c-runtime-library/reference/ceil-ceilf-ceill.md | 2 +- docs/c-runtime-library/reference/cimag-cimagf-cimagl.md | 2 +- docs/c-runtime-library/reference/conj-conjf-conjl.md | 2 +- ...sign-copysignf-copysignl-copysign-copysignf-copysignl.md | 2 +- docs/c-runtime-library/reference/cos-cosf-cosl.md | 2 +- docs/c-runtime-library/reference/cosh-coshf-coshl.md | 2 +- docs/c-runtime-library/reference/cproj-cprojf-cprojl.md | 2 +- docs/c-runtime-library/reference/creal-crealf-creall.md | 2 +- .../reference/erf-erff-erfl-erfc-erfcf-erfcl.md | 4 ++-- docs/c-runtime-library/reference/exp-expf.md | 2 +- docs/c-runtime-library/reference/exp2-exp2f-exp2l.md | 2 +- docs/c-runtime-library/reference/expm1-expm1f-expm1l.md | 2 +- docs/c-runtime-library/reference/fabs-fabsf-fabsl.md | 2 +- docs/c-runtime-library/reference/fdim-fdimf-fdiml.md | 2 +- docs/c-runtime-library/reference/floor-floorf-floorl.md | 2 +- docs/c-runtime-library/reference/fma-fmaf-fmal.md | 2 +- docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md | 2 +- docs/c-runtime-library/reference/fmin-fminf-fminl.md | 2 +- docs/c-runtime-library/reference/fmod-fmodf.md | 2 +- docs/c-runtime-library/reference/frexp.md | 2 +- .../reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md | 2 +- docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md | 2 +- docs/c-runtime-library/reference/ldexp.md | 2 +- docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md | 2 +- docs/c-runtime-library/reference/log-logf-log10-log10f.md | 4 ++-- docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md | 2 +- docs/c-runtime-library/reference/log2-log2f-log2l.md | 2 +- .../reference/logb-logbf-logbl-logb-logbf.md | 2 +- .../reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md | 2 +- .../lround-lroundf-lroundl-llround-llroundf-llroundl.md | 2 +- .../reference/nearbyint-nearbyintf-nearbyintl1.md | 2 +- docs/c-runtime-library/reference/nextafter-functions.md | 4 ++-- docs/c-runtime-library/reference/pow-powf-powl.md | 2 +- .../reference/remainder-remainderf-remainderl.md | 2 +- docs/c-runtime-library/reference/remquo-remquof-remquol.md | 2 +- docs/c-runtime-library/reference/rint-rintf-rintl.md | 2 +- docs/c-runtime-library/reference/round-roundf-roundl.md | 2 +- .../scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md | 4 ++-- docs/c-runtime-library/reference/sin-sinf-sinl.md | 2 +- docs/c-runtime-library/reference/sinh-sinhf-sinhl.md | 2 +- docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md | 2 +- docs/c-runtime-library/reference/tan-tanf-tanl.md | 2 +- docs/c-runtime-library/reference/tanh-tanhf-tanhl.md | 2 +- docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md | 2 +- docs/c-runtime-library/reference/trunc-truncf-truncl.md | 2 +- docs/standard-library/empty-view-class.md | 4 ++-- docs/standard-library/range-adaptors.md | 6 +++--- docs/standard-library/single-view-class.md | 2 +- 57 files changed, 65 insertions(+), 65 deletions(-) diff --git a/docs/c-language/static-assert-c.md b/docs/c-language/static-assert-c.md index 0890f6594bc..99455cab88f 100644 --- a/docs/c-language/static-assert-c.md +++ b/docs/c-language/static-assert-c.md @@ -42,7 +42,7 @@ In C, when you don't include ``, the Microsoft compiler treats **`stat In the following example, **`static_assert`** and **`_Static_assert`** are used to verify how many elements are in an enum and that integers are 32 bits wide. ```C -// requires /std:c11 or higher +// requires /std:c11 or later #include enum Items diff --git a/docs/c-runtime-library/reference/acos-acosf-acosl.md b/docs/c-runtime-library/reference/acos-acosf-acosl.md index 5296418f6b5..3331c7dc527 100644 --- a/docs/c-runtime-library/reference/acos-acosf-acosl.md +++ b/docs/c-runtime-library/reference/acos-acosf-acosl.md @@ -19,7 +19,7 @@ Calculates the arccosine. double acos( double x ); float acosf( float x ); long double acosl( long double x ); -#define acos(X) // Requires C11 or higher +#define acos(X) // Requires C11 or later float acos( float x ); // C++ only long double acos( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md b/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md index eae18abea8c..f0e0a7ab9c0 100644 --- a/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md +++ b/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md @@ -20,7 +20,7 @@ Calculates the inverse hyperbolic cosine. double acosh( double x ); float acoshf( float x ); long double acoshl( long double x ); -#define acosh(X) // Requires C11 or higher +#define acosh(X) // Requires C11 or later float acosh( float x ); // C++ only long double acosh( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/asin-asinf-asinl.md b/docs/c-runtime-library/reference/asin-asinf-asinl.md index 9fbe4cda49c..78f55912eda 100644 --- a/docs/c-runtime-library/reference/asin-asinf-asinl.md +++ b/docs/c-runtime-library/reference/asin-asinf-asinl.md @@ -19,7 +19,7 @@ Calculates the arcsine. double asin( double x ); float asinf ( float x ); long double asinl( long double x ); -#define asin(X) // Requires C11 or higher +#define asin(X) // Requires C11 or later float asin( float x ); // C++ only long double asin( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md b/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md index 1c9480aac2d..0c8d3cf295c 100644 --- a/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md +++ b/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md @@ -20,7 +20,7 @@ Calculates the inverse hyperbolic sine. double asinh( double x ); float asinhf( float x ); long double asinhl( long double x ); -#define asinh(X) // Requires C11 or higher +#define asinh(X) // Requires C11 or later float asinh( float x ); // C++ only long double asinh( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md b/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md index 12dab5d0475..4728064b395 100644 --- a/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md +++ b/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md @@ -19,7 +19,7 @@ Calculates the arctangent of **`x`** (**`atan`**, **`atanf`**, and **`atanl`**) double atan( double x ); float atanf( float x ); long double atanl( long double x ); -#define atan(X) // Requires C11 or higher +#define atan(X) // Requires C11 or later float atan( float x ); // C++ only long double atan( long double x ); // C++ only @@ -27,7 +27,7 @@ long double atan( long double x ); // C++ only double atan2( double y, double x ); float atan2f( float y, float x ); long double atan2l( long double y, long double x ); -#define atan2(Y, X) // Requires C11 or higher +#define atan2(Y, X) // Requires C11 or later float atan2( float y, float x ); // C++ only long double atan2( long double y, long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/atanh-atanhf-atanhl.md b/docs/c-runtime-library/reference/atanh-atanhf-atanhl.md index b7ce5af41ba..02ebb06caf3 100644 --- a/docs/c-runtime-library/reference/atanh-atanhf-atanhl.md +++ b/docs/c-runtime-library/reference/atanh-atanhf-atanhl.md @@ -19,7 +19,7 @@ Calculates the inverse hyperbolic tangent. double atanh( double x ); float atanhf( float x ); long double atanhl( long double x ); -#define atanh(X) // Requires C11 or higher +#define atanh(X) // Requires C11 or later float atanh( float x ); // C++ only long double atanh( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/carg-cargf-cargl.md b/docs/c-runtime-library/reference/carg-cargf-cargl.md index 0635b71a2e0..6ed3fd4e4a4 100644 --- a/docs/c-runtime-library/reference/carg-cargf-cargl.md +++ b/docs/c-runtime-library/reference/carg-cargf-cargl.md @@ -32,7 +32,7 @@ float cargf( long double cargl( _Lcomplex z ); -#define carg(X) // Requires C11 or higher +#define carg(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md b/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md index 930c3fcaadb..ae888def20d 100644 --- a/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md +++ b/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md @@ -32,7 +32,7 @@ float cbrtf( long double cbrtl( long double x ); -#define cbrt(X) // Requires C11 or higher +#define cbrt(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/ceil-ceilf-ceill.md b/docs/c-runtime-library/reference/ceil-ceilf-ceill.md index 0b4598a2542..3fe4f9a5a44 100644 --- a/docs/c-runtime-library/reference/ceil-ceilf-ceill.md +++ b/docs/c-runtime-library/reference/ceil-ceilf-ceill.md @@ -32,7 +32,7 @@ float ceilf( long double ceill( long double x ); -#define ceil(X) // Requires C11 or higher +#define ceil(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md b/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md index dfcdd2f3819..38f9436dc51 100644 --- a/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md +++ b/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md @@ -20,7 +20,7 @@ Retrieves the imaginary part of a complex number. double cimag( _Dcomplex z ); float cimagf( _Fcomplex z ); long double cimagl( _Lcomplex z ); -#define cimag(X) // Requires C11 or higher +#define cimag(X) // Requires C11 or later float cimag( _Fcomplex z ); // C++ only long double cimag( _Lcomplex z ); // C++ only diff --git a/docs/c-runtime-library/reference/conj-conjf-conjl.md b/docs/c-runtime-library/reference/conj-conjf-conjl.md index 60b5e95ad99..bcff214657e 100644 --- a/docs/c-runtime-library/reference/conj-conjf-conjl.md +++ b/docs/c-runtime-library/reference/conj-conjf-conjl.md @@ -32,7 +32,7 @@ _Fcomplex conjf( _Lcomplex conjl( _Lcomplex z ); -#define conj(X) // Requires C11 or higher +#define conj(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md b/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md index 8d979ab1f3e..f5708458d32 100644 --- a/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md +++ b/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md @@ -45,7 +45,7 @@ long double _copysignl( long double x, long double y ); -#define copysign(X, Y) // Requires C11 or higher +#define copysign(X, Y) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/cos-cosf-cosl.md b/docs/c-runtime-library/reference/cos-cosf-cosl.md index 5e31e2aa7e1..6cf5dc380e7 100644 --- a/docs/c-runtime-library/reference/cos-cosf-cosl.md +++ b/docs/c-runtime-library/reference/cos-cosf-cosl.md @@ -20,7 +20,7 @@ Calculates the cosine. double cos( double x ); float cosf( float x ); long double cosl( long double x ); -#define cos(X) // Requires C11 or higher +#define cos(X) // Requires C11 or later float cos( float x ); // C++ only long double cos( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/cosh-coshf-coshl.md b/docs/c-runtime-library/reference/cosh-coshf-coshl.md index cddafd7d1b7..58d8ea27833 100644 --- a/docs/c-runtime-library/reference/cosh-coshf-coshl.md +++ b/docs/c-runtime-library/reference/cosh-coshf-coshl.md @@ -19,7 +19,7 @@ Calculates the hyperbolic cosine. double cosh( double x ); float coshf( float x ); long double coshl( long double x ); -#define cosh(X) // Requires C11 or higher +#define cosh(X) // Requires C11 or later float cosh( float x ); // C++ only long double cosh( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md b/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md index 39bd6ca7d8a..6c5f591a6b7 100644 --- a/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md +++ b/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md @@ -32,7 +32,7 @@ _Fcomplex cprojf( _Lcomplex cprojl( _Lcomplex z ); -#define cproj(X) // Requires C11 or higher +#define cproj(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/creal-crealf-creall.md b/docs/c-runtime-library/reference/creal-crealf-creall.md index 40a36d933e1..d278124752a 100644 --- a/docs/c-runtime-library/reference/creal-crealf-creall.md +++ b/docs/c-runtime-library/reference/creal-crealf-creall.md @@ -20,7 +20,7 @@ Retrieves the real part of a complex number. double creal( _Dcomplex z ); float crealf( _Fcomplex z ); long double creall( _Lcomplex z ); -#define creal(X) // Requires C11 or higher +#define creal(X) // Requires C11 or later float creal( _Fcomplex z ); // C++ only long double creal( _Lcomplex z ); // C++ only diff --git a/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md b/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md index ebc5633b223..82a5e66ef58 100644 --- a/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md +++ b/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md @@ -47,8 +47,8 @@ float erfcf( long double erfcl( long double x ); -#define erf(X) // Requires C11 or higher -#define erfc(X) // Requires C11 or higher +#define erf(X) // Requires C11 or later +#define erfc(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/exp-expf.md b/docs/c-runtime-library/reference/exp-expf.md index ca4498aea02..0561c68403a 100644 --- a/docs/c-runtime-library/reference/exp-expf.md +++ b/docs/c-runtime-library/reference/exp-expf.md @@ -31,7 +31,7 @@ float expf( long double expl( long double x ); -#define exp(z) // Requires C11 or higher +#define exp(z) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md b/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md index bf7a2e28937..2559908fdf0 100644 --- a/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md +++ b/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md @@ -35,7 +35,7 @@ float exp2f( long double exp2l( long double x ); -#define exp2(X) // Requires C11 or higher +#define exp2(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md b/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md index 838790997cb..78087e43f2b 100644 --- a/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md +++ b/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md @@ -32,7 +32,7 @@ float expm1f( long double expm1l( long double x ); -#define expm1(X) // Requires C11 or higher +#define expm1(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md b/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md index 99d52e6c877..a16501d0275 100644 --- a/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md +++ b/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md @@ -32,7 +32,7 @@ long double fabsl( long double x ); -#define fabs(X) // Requires C11 or higher +#define fabs(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md b/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md index 89145b12af3..0ee38420ea9 100644 --- a/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md +++ b/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md @@ -41,7 +41,7 @@ long double fdiml( long double y ); -#define fdim(X) // Requires C11 or higher +#define fdim(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/floor-floorf-floorl.md b/docs/c-runtime-library/reference/floor-floorf-floorl.md index fda68075056..fd681f6214b 100644 --- a/docs/c-runtime-library/reference/floor-floorf-floorl.md +++ b/docs/c-runtime-library/reference/floor-floorf-floorl.md @@ -32,7 +32,7 @@ float floorf( long double floorl( long double x ); -#define floor(X) // Requires C11 or higher +#define floor(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fma-fmaf-fmal.md b/docs/c-runtime-library/reference/fma-fmaf-fmal.md index 5c1d6f5f4b8..63c402f46aa 100644 --- a/docs/c-runtime-library/reference/fma-fmaf-fmal.md +++ b/docs/c-runtime-library/reference/fma-fmaf-fmal.md @@ -47,7 +47,7 @@ long double fmal( long double z ); -#define fma(X, Y, Z) // Requires C11 or higher +#define fma(X, Y, Z) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md b/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md index ccd942f6729..7d3e3912923 100644 --- a/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md +++ b/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md @@ -42,7 +42,7 @@ long double fmaxl( long double y ); -#define fmax(X, Y) // Requires C11 or higher +#define fmax(X, Y) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fmin-fminf-fminl.md b/docs/c-runtime-library/reference/fmin-fminf-fminl.md index e1b2093567d..d59a3b50203 100644 --- a/docs/c-runtime-library/reference/fmin-fminf-fminl.md +++ b/docs/c-runtime-library/reference/fmin-fminf-fminl.md @@ -42,7 +42,7 @@ long double fminl( long double y ); -#define fmin(x) // Requires C11 or higher +#define fmin(x) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fmod-fmodf.md b/docs/c-runtime-library/reference/fmod-fmodf.md index ecf39a5c283..3c2c7d6974b 100644 --- a/docs/c-runtime-library/reference/fmod-fmodf.md +++ b/docs/c-runtime-library/reference/fmod-fmodf.md @@ -37,7 +37,7 @@ long double fmodl( long double y ); -#define fmod(X, Y) // Requires C11 or higher +#define fmod(X, Y) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/frexp.md b/docs/c-runtime-library/reference/frexp.md index fa601e5e415..b938f9b68a9 100644 --- a/docs/c-runtime-library/reference/frexp.md +++ b/docs/c-runtime-library/reference/frexp.md @@ -29,7 +29,7 @@ long double frexpl( long double x, int * expptr ); -#define frexpl(X, INT_PTR) // Requires C11 or higher +#define frexpl(X, INT_PTR) // Requires C11 or later ``` ```cpp diff --git a/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md b/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md index d447ac7df15..f29481721c6 100644 --- a/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md +++ b/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md @@ -41,7 +41,7 @@ long double _hypotl( long double x, long double y ); -#define hypotf(X, Y) // Requires C11 or higher +#define hypotf(X, Y) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md b/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md index b75d22d40bb..64d4354215f 100644 --- a/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md +++ b/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md @@ -37,7 +37,7 @@ int ilogbl( long double x ); -#define ilogbl(X) // Requires C11 or higher +#define ilogbl(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/ldexp.md b/docs/c-runtime-library/reference/ldexp.md index 8cb4fae0462..d0b7948b075 100644 --- a/docs/c-runtime-library/reference/ldexp.md +++ b/docs/c-runtime-library/reference/ldexp.md @@ -29,7 +29,7 @@ long double ldexpl( long double x, int exp ); -#define ldexp(X, INT) // Requires C11 or higher +#define ldexp(X, INT) // Requires C11 or later float ldexp( float x, diff --git a/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md b/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md index e23d3050a2c..d094800e350 100644 --- a/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md +++ b/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md @@ -20,7 +20,7 @@ Determines the natural logarithm of the absolute value of the gamma function of double lgamma( double x ); float lgammaf( float x ); long double lgammal( long double x ); -#define lgammal(X) // Requires C11 or higher +#define lgammal(X) // Requires C11 or later float lgamma( float x ); //C++ only long double lgamma( long double x ); //C++ only diff --git a/docs/c-runtime-library/reference/log-logf-log10-log10f.md b/docs/c-runtime-library/reference/log-logf-log10-log10f.md index 4ff277f7b00..75a7a43bbb4 100644 --- a/docs/c-runtime-library/reference/log-logf-log10-log10f.md +++ b/docs/c-runtime-library/reference/log-logf-log10-log10f.md @@ -22,8 +22,8 @@ long double logl(double x); double log10(double x); float log10f (float x); long double log10l(double x); -#define log(X) // Requires C11 or higher -#define log10(X) // Requires C11 or higher +#define log(X) // Requires C11 or later +#define log10(X) // Requires C11 or later float log(float x); // C++ only long double log(long double x); // C++ only diff --git a/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md b/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md index 4b73bb4062e..75546e43ad3 100644 --- a/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md +++ b/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md @@ -20,7 +20,7 @@ double log1p(double x); float log1pf(float x); long double log1pl(long double x); -#define log1p(X) // Requires C11 or higher +#define log1p(X) // Requires C11 or later float log1p(float x); //C++ only long double log1p(long double x); //C++ only diff --git a/docs/c-runtime-library/reference/log2-log2f-log2l.md b/docs/c-runtime-library/reference/log2-log2f-log2l.md index 9a70db2e0cf..843588413e9 100644 --- a/docs/c-runtime-library/reference/log2-log2f-log2l.md +++ b/docs/c-runtime-library/reference/log2-log2f-log2l.md @@ -35,7 +35,7 @@ long double log2l( long double x ); -#define log2(X) // Requires C11 or higher +#define log2(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md b/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md index 30a4afeca7c..cecb23c40c4 100644 --- a/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md +++ b/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md @@ -37,7 +37,7 @@ double _logb( float _logbf( float x ); -#define logb(X) // Requires C11 or higher +#define logb(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md b/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md index 9c9b491590b..4e2cabfabef 100644 --- a/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md +++ b/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md @@ -57,7 +57,7 @@ long long int llrintl( long double x ); -#define lrint(X) // Requires C11 or higher +#define lrint(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md b/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md index 4233c51110d..64f11776c57 100644 --- a/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md +++ b/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md @@ -47,7 +47,7 @@ long long llroundf( long long llroundl( long double x ); -#define lround(X) // Requires C11 or higher +#define lround(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md b/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md index 17a159e822e..8690d2f7cf5 100644 --- a/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md +++ b/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md @@ -20,7 +20,7 @@ Rounds the specified floating-point value to an integer, and returns that value double nearbyint( double x ); float nearbyintf( float x ); long double nearbyintl( long double x ); -#define nearbyint( X ) // Requires C11 or higher +#define nearbyint( X ) // Requires C11 or later float nearbyint( float x ); //C++ only long double nearbyint( long double x ); //C++ only diff --git a/docs/c-runtime-library/reference/nextafter-functions.md b/docs/c-runtime-library/reference/nextafter-functions.md index f4945d818ea..811876c1c93 100644 --- a/docs/c-runtime-library/reference/nextafter-functions.md +++ b/docs/c-runtime-library/reference/nextafter-functions.md @@ -23,13 +23,13 @@ long double nextafterl( long double x, long double y ); double _nextafter( double x, double y ); float _nextafterf( float x, float y ); /* x64 only */ -#define nextafter(X, Y) // Requires C11 or higher +#define nextafter(X, Y) // Requires C11 or later double nexttoward( double x, long double y ); float nexttowardf( float x, long double y ); long double nexttowardl( long double x, long double y ); -#define nexttoward(X, Y) // Requires C11 or higher +#define nexttoward(X, Y) // Requires C11 or later float nextafter( float x, float y ); /* C++ only, requires */ long double nextafter( long double x, long double y ); /* C++ only, requires */ diff --git a/docs/c-runtime-library/reference/pow-powf-powl.md b/docs/c-runtime-library/reference/pow-powf-powl.md index bedf5a9dcf7..fd914f7fb59 100644 --- a/docs/c-runtime-library/reference/pow-powf-powl.md +++ b/docs/c-runtime-library/reference/pow-powf-powl.md @@ -20,7 +20,7 @@ Calculates *`x`* raised to the power of *`y`*. double pow( double x, double y ); float powf( float x, float y ); long double powl( long double x, long double y ); -define pow(X, Y) // Requires C11 or higher +define pow(X, Y) // Requires C11 or later double pow( double x, int y ); // C++ only float pow( float x, float y ); // C++ only diff --git a/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md b/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md index 2d6f85d7ed5..7371dfcdf71 100644 --- a/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md +++ b/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md @@ -20,7 +20,7 @@ Computes the remainder of the quotient of two floating-point values, rounded to double remainder( double x, double y ); float remainderf( float x, float y ); long double remainderl( long double x, long double y ); -#define remainder(X, Y) // Requires C11 or higher +#define remainder(X, Y) // Requires C11 or later float remainder( float x, float y ); /* C++ only */ long double remainder( long double x, long double y ); /* C++ only */ diff --git a/docs/c-runtime-library/reference/remquo-remquof-remquol.md b/docs/c-runtime-library/reference/remquo-remquof-remquol.md index f6236f96797..1509f00640e 100644 --- a/docs/c-runtime-library/reference/remquo-remquof-remquol.md +++ b/docs/c-runtime-library/reference/remquo-remquof-remquol.md @@ -19,7 +19,7 @@ Computes the remainder of two integer values, and stores an integer value with t double remquo( double numer, double denom, int* quo ); float remquof( float numer, float denom, int* quo ); long double remquol( long double numer, long double denom, int* quo ); -#define remquo(X, Y, INT_PTR) // Requires C11 or higher +#define remquo(X, Y, INT_PTR) // Requires C11 or later float remquo( float numer, float denom, int* quo ); /* C++ only */ long double remquo( long double numer, long double denom, int* quo ); /* C++ only */ diff --git a/docs/c-runtime-library/reference/rint-rintf-rintl.md b/docs/c-runtime-library/reference/rint-rintf-rintl.md index 9b129700c93..2890f61732d 100644 --- a/docs/c-runtime-library/reference/rint-rintf-rintl.md +++ b/docs/c-runtime-library/reference/rint-rintf-rintl.md @@ -20,7 +20,7 @@ Rounds a floating-point value to the nearest integer in floating-point format. double rint( double x ); float rintf( float x ); long double rintl( long double x ); -#define rint(X) // Requires C11 or higher +#define rint(X) // Requires C11 or later float rint( float x ); // C++ only long double rint( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/round-roundf-roundl.md b/docs/c-runtime-library/reference/round-roundf-roundl.md index a5a0f37b5f0..8f4c85b8035 100644 --- a/docs/c-runtime-library/reference/round-roundf-roundl.md +++ b/docs/c-runtime-library/reference/round-roundf-roundl.md @@ -32,7 +32,7 @@ float roundf( long double roundl( long double x ); -#define round(X) // Requires C11 or higher +#define round(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md b/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md index 53eccc387bb..71be511abd0 100644 --- a/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md +++ b/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md @@ -38,7 +38,7 @@ long double scalbnl( int exp ); -#define scalbn(X, INT) // Requires C11 or higher +#define scalbn(X, INT) // Requires C11 or later double scalbln( double x, @@ -54,7 +54,7 @@ long double scalblnl( long exp ); -#define scalbln(X, LONG) // Requires C11 or higher +#define scalbln(X, LONG) // Requires C11 or later float scalbln( float x, diff --git a/docs/c-runtime-library/reference/sin-sinf-sinl.md b/docs/c-runtime-library/reference/sin-sinf-sinl.md index 841be1e4a43..dcc855ecca6 100644 --- a/docs/c-runtime-library/reference/sin-sinf-sinl.md +++ b/docs/c-runtime-library/reference/sin-sinf-sinl.md @@ -19,7 +19,7 @@ Calculates the sine of a floating-point value. double sin(double x); float sinf(float x); long double sinl(long double x); -#define sin(x) // Requires C11 or higher +#define sin(x) // Requires C11 or later ``` ```cpp diff --git a/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md b/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md index 3a4456374e0..d4d370a4211 100644 --- a/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md +++ b/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md @@ -19,7 +19,7 @@ Calculates the hyperbolic sine. double sinh(double x); float sinhf(float x); long double sinhl(long double x); -#define sinh(x) // Requires C11 or higher +#define sinh(x) // Requires C11 or later float sinh(float x); // C++ only long double sinh(long double x); // C++ only diff --git a/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md b/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md index ef2221147ef..08dfd4bcfdd 100644 --- a/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md +++ b/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md @@ -31,7 +31,7 @@ float sqrtf( long double sqrtl( long double x ); -#define sqrt(x) // Requires C11 or higher +#define sqrt(x) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/tan-tanf-tanl.md b/docs/c-runtime-library/reference/tan-tanf-tanl.md index 815d0b95a95..8c4f53b0c98 100644 --- a/docs/c-runtime-library/reference/tan-tanf-tanl.md +++ b/docs/c-runtime-library/reference/tan-tanf-tanl.md @@ -20,7 +20,7 @@ Calculates the tangent. double tan( double x ); float tanf( float x ); long double tanl( long double x ); -#define tan(x) // Requires C11 or higher +#define tan(x) // Requires C11 or later ``` ```cpp diff --git a/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md b/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md index de71ee31781..dc74374a239 100644 --- a/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md +++ b/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md @@ -19,7 +19,7 @@ Calculates the hyperbolic tangent. double tanh( double x ); float tanhf( float x ); long double tanhl( long double x ); -#define tanh(x) // Requires C11 or higher +#define tanh(x) // Requires C11 or later ``` ```cpp diff --git a/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md b/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md index eb9595efd48..ee77d2be7f6 100644 --- a/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md +++ b/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md @@ -29,7 +29,7 @@ long double tgammal( long double x ); -#define tgamma(X) // Requires C11 or higher +#define tgamma(X) // Requires C11 or later float tgamma( float x diff --git a/docs/c-runtime-library/reference/trunc-truncf-truncl.md b/docs/c-runtime-library/reference/trunc-truncf-truncl.md index 19c7bc04148..f392bcd2971 100644 --- a/docs/c-runtime-library/reference/trunc-truncf-truncl.md +++ b/docs/c-runtime-library/reference/trunc-truncf-truncl.md @@ -19,7 +19,7 @@ Determines the nearest integer that is less than or equal to the specified float ```C double trunc( double x ); long double truncl( long double x ); -#define trunc(X) // Requires C11 or higher +#define trunc(X) // Requires C11 or later long double trunc( long double x ); //C++ only float trunc( float x ); //C++ only diff --git a/docs/standard-library/empty-view-class.md b/docs/standard-library/empty-view-class.md index 6d64eedb500..8811f1dd2fb 100644 --- a/docs/standard-library/empty-view-class.md +++ b/docs/standard-library/empty-view-class.md @@ -91,7 +91,7 @@ The best way to create a `empty_view` is by using the [`empty`](range-adaptors.m ### Example `empty_view` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include @@ -256,7 +256,7 @@ Returns `false`. ### Example `(bool)` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include diff --git a/docs/standard-library/range-adaptors.md b/docs/standard-library/range-adaptors.md index 7fca2c03e47..fd269cd19a8 100644 --- a/docs/standard-library/range-adaptors.md +++ b/docs/standard-library/range-adaptors.md @@ -217,7 +217,7 @@ When an API requires the begin iterator and end sentinel to have the same type, ### Example: `common` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include #include @@ -551,7 +551,7 @@ An `empty_view` can be useful when you're calling code that requires a view but ### Example: `empty` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include @@ -1062,7 +1062,7 @@ This view is useful for test purposes, for calling code that needs to be provide ### Example: `single` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/single-view-class.md b/docs/standard-library/single-view-class.md index 7a42d4dfcc4..67ed5341e15 100644 --- a/docs/standard-library/single-view-class.md +++ b/docs/standard-library/single-view-class.md @@ -100,7 +100,7 @@ The best way to create a `single_view` is by using the [`views::single`](range-a ### Example `single_view` ```cpp -/// requires /std:c++20 or higher +/// requires /std:c++20 or later #include #include #include From d2ea1c7a79b925a09b6b0be3bad2e50df7743c60 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 8 Jul 2025 22:14:22 +0800 Subject: [PATCH 0307/1799] Replace "or /std:c++latest" in requires standard version comments --- docs/standard-library/basic-string-class.md | 4 ++-- docs/standard-library/basic-string-view-class.md | 4 ++-- docs/standard-library/map-class.md | 2 +- docs/standard-library/multimap-class.md | 2 +- docs/standard-library/multiset-class.md | 2 +- docs/standard-library/set-class.md | 2 +- docs/standard-library/unordered-map-class.md | 2 +- docs/standard-library/unordered-multimap-class.md | 2 +- docs/standard-library/unordered-multiset-class.md | 2 +- docs/standard-library/unordered-set-class.md | 2 +- 10 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 554d5ba8d81..d2285f90806 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -1830,7 +1830,7 @@ See [`starts_with`](#starts_with) to check if a string starts with the specified ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include @@ -4652,7 +4652,7 @@ See [`ends_with`](#ends_with) to see if a string ends with the specified suffix. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/basic-string-view-class.md b/docs/standard-library/basic-string-view-class.md index fda26ef3f89..16073e5999a 100644 --- a/docs/standard-library/basic-string-view-class.md +++ b/docs/standard-library/basic-string-view-class.md @@ -610,7 +610,7 @@ See [`starts_with`](#starts_with) to check if a string view starts with the spec ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include @@ -1020,7 +1020,7 @@ See [`ends_with`](#ends_with) to see if a string ends with a suffix. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/map-class.md b/docs/standard-library/map-class.md index c630e1c4152..6cc7a34dabd 100644 --- a/docs/standard-library/map-class.md +++ b/docs/standard-library/map-class.md @@ -557,7 +557,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/multimap-class.md b/docs/standard-library/multimap-class.md index fd24a711eb1..1f4819770f6 100644 --- a/docs/standard-library/multimap-class.md +++ b/docs/standard-library/multimap-class.md @@ -435,7 +435,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/multiset-class.md b/docs/standard-library/multiset-class.md index 0fbaa078508..2ee9fe92c5b 100644 --- a/docs/standard-library/multiset-class.md +++ b/docs/standard-library/multiset-class.md @@ -404,7 +404,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/set-class.md b/docs/standard-library/set-class.md index 17de564011d..a311d618735 100644 --- a/docs/standard-library/set-class.md +++ b/docs/standard-library/set-class.md @@ -404,7 +404,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/unordered-map-class.md b/docs/standard-library/unordered-map-class.md index 6c477c968af..fb8bf60b413 100644 --- a/docs/standard-library/unordered-map-class.md +++ b/docs/standard-library/unordered-map-class.md @@ -795,7 +795,7 @@ The key value of the element to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/unordered-multimap-class.md b/docs/standard-library/unordered-multimap-class.md index aa702c0206b..516585e9dcb 100644 --- a/docs/standard-library/unordered-multimap-class.md +++ b/docs/standard-library/unordered-multimap-class.md @@ -749,7 +749,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/unordered-multiset-class.md b/docs/standard-library/unordered-multiset-class.md index 711f79b9ed8..1b6e8fd3651 100644 --- a/docs/standard-library/unordered-multiset-class.md +++ b/docs/standard-library/unordered-multiset-class.md @@ -740,7 +740,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/unordered-set-class.md b/docs/standard-library/unordered-set-class.md index 1085adc704c..a0d02bace63 100644 --- a/docs/standard-library/unordered-set-class.md +++ b/docs/standard-library/unordered-set-class.md @@ -744,7 +744,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include From 498e33aef326f987e6700bb8f7bd59bb449cd859 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 8 Jul 2025 22:17:19 +0800 Subject: [PATCH 0308/1799] Remove comma in requires standard version comments --- .../basic-istream-view-class.md | 2 +- docs/standard-library/iota-view-class.md | 2 +- docs/standard-library/join-view-class.md | 2 +- .../ranges-alias-templates.md | 22 +++++++++---------- docs/standard-library/view-classes.md | 2 +- 5 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/standard-library/basic-istream-view-class.md b/docs/standard-library/basic-istream-view-class.md index bac05a4dd9f..e1aa2cc2930 100644 --- a/docs/standard-library/basic-istream-view-class.md +++ b/docs/standard-library/basic-istream-view-class.md @@ -117,7 +117,7 @@ The best way to create a `basic_istream_view` is by using the [`views::istream`] ### Example: `basic_istream_view`, `istream_view`, and `wistream_view` ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/iota-view-class.md b/docs/standard-library/iota-view-class.md index ecc936307ca..f33113e8cb6 100644 --- a/docs/standard-library/iota-view-class.md +++ b/docs/standard-library/iota-view-class.md @@ -116,7 +116,7 @@ When you use one of the constructors that value-initializes the bound, the bound ## `iota_view` constructor example ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/join-view-class.md b/docs/standard-library/join-view-class.md index aef74d56cfa..0f94798f81d 100644 --- a/docs/standard-library/join-view-class.md +++ b/docs/standard-library/join-view-class.md @@ -90,7 +90,7 @@ For information about the template parameter type, see [Template parameters](#te ### Example: `join_view` ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/ranges-alias-templates.md b/docs/standard-library/ranges-alias-templates.md index 20149175337..507cd070035 100644 --- a/docs/standard-library/ranges-alias-templates.md +++ b/docs/standard-library/ranges-alias-templates.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["std::ranges [C++], ranges::borrowed_iterator_t", "std::ra An alias template is an alias for another type, which can make code more readable. For example, the following alias, `conditional_t`, is an alias for either `borrowed_range` or `dangling` range, depending on the kind of `range` that's passed in: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -94,7 +94,7 @@ If an algorithm function is passed a range whose iterators depend on its lifetim The following example shows how `borrowed_iterator_t` detects a dangling iterator. The function `ranges::max_element()` uses this template alias to determine the return type: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -165,7 +165,7 @@ If an algorithm function is passed a range whose iterators depend on its lifetim The following example shows how `borrowed_subrange_t` detects a dangling iterator because `equal_range()` and `max_element` use this template alias to determine the return type: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -228,7 +228,7 @@ A variable number of non-`void` types. They have no effect. The arguments are a The following example shows how `max_element` detects a dangling iterator. ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -272,7 +272,7 @@ The range type to get the iterator type for. The following example shows how `iterator_t` can be used to declare an iterator for a vector: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -314,7 +314,7 @@ The range whose iterator will provide the difference type. The following example shows how `range_difference_t` is used to hold the distance between elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -356,7 +356,7 @@ The range for which the reference type of its iterator type is returned. The following example shows `range_reference_t` referring to the type of the elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -399,7 +399,7 @@ The range to get the rvalue reference type to its iterator type. The following example shows `range_rvalue_reference_t` referring to a rvalue type of the elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -442,7 +442,7 @@ The range to get the type of its `size` function. The following example shows `range_size_t` referring to the number of elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -484,7 +484,7 @@ The range to get the value type of its iterator. The following example shows how `range_value_t` refers to the type of elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -526,7 +526,7 @@ The range to get the sentinel type for. The following example shows using `sentinel_t` to determine whether the iterator type and sentinel type are the same: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include diff --git a/docs/standard-library/view-classes.md b/docs/standard-library/view-classes.md index a7c6a10b817..9d03ecae519 100644 --- a/docs/standard-library/view-classes.md +++ b/docs/standard-library/view-classes.md @@ -51,7 +51,7 @@ Using a view after the range that it's based on is modified can lead to undefine Because views are cheap to create, you should generally re-create a view if you modify the underlying range. The following example demonstrates how to store a view pipeline in a variable so that you can reuse it. ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include #include From 1dbc6f1ac58467702e50abcd1914c87b23479fa0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 8 Jul 2025 22:25:53 +0800 Subject: [PATCH 0309/1799] Update metadata in over 50 topics --- docs/c-runtime-library/reference/acos-acosf-acosl.md | 2 +- docs/c-runtime-library/reference/acosh-acoshf-acoshl.md | 3 +-- docs/c-runtime-library/reference/asin-asinf-asinl.md | 2 +- docs/c-runtime-library/reference/asinh-asinhf-asinhl.md | 3 +-- .../reference/atan-atanf-atanl-atan2-atan2f-atan2l.md | 2 +- docs/c-runtime-library/reference/carg-cargf-cargl.md | 3 +-- docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md | 3 +-- docs/c-runtime-library/reference/ceil-ceilf-ceill.md | 3 +-- docs/c-runtime-library/reference/cimag-cimagf-cimagl.md | 3 +-- docs/c-runtime-library/reference/conj-conjf-conjl.md | 3 +-- ...opysign-copysignf-copysignl-copysign-copysignf-copysignl.md | 3 +-- docs/c-runtime-library/reference/cos-cosf-cosl.md | 3 +-- docs/c-runtime-library/reference/cosh-coshf-coshl.md | 2 +- docs/c-runtime-library/reference/cproj-cprojf-cprojl.md | 3 +-- docs/c-runtime-library/reference/creal-crealf-creall.md | 3 +-- .../reference/erf-erff-erfl-erfc-erfcf-erfcl.md | 3 +-- docs/c-runtime-library/reference/exp-expf.md | 2 +- docs/c-runtime-library/reference/exp2-exp2f-exp2l.md | 2 +- docs/c-runtime-library/reference/expm1-expm1f-expm1l.md | 3 +-- docs/c-runtime-library/reference/fdim-fdimf-fdiml.md | 2 +- docs/c-runtime-library/reference/floor-floorf-floorl.md | 3 +-- docs/c-runtime-library/reference/fma-fmaf-fmal.md | 3 +-- docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md | 3 +-- docs/c-runtime-library/reference/fmin-fminf-fminl.md | 3 +-- docs/c-runtime-library/reference/fmod-fmodf.md | 2 +- docs/c-runtime-library/reference/frexp.md | 3 +-- .../reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md | 3 +-- docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md | 3 +-- docs/c-runtime-library/reference/ldexp.md | 3 +-- docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md | 3 +-- docs/c-runtime-library/reference/log-logf-log10-log10f.md | 2 +- docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md | 2 +- docs/c-runtime-library/reference/log2-log2f-log2l.md | 3 +-- .../c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md | 2 +- .../reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md | 3 +-- .../lround-lroundf-lroundl-llround-llroundf-llroundl.md | 3 +-- .../reference/nearbyint-nearbyintf-nearbyintl1.md | 3 +-- docs/c-runtime-library/reference/nextafter-functions.md | 2 +- docs/c-runtime-library/reference/pow-powf-powl.md | 3 +-- .../reference/remainder-remainderf-remainderl.md | 3 +-- docs/c-runtime-library/reference/remquo-remquof-remquol.md | 2 +- docs/c-runtime-library/reference/rint-rintf-rintl.md | 3 +-- docs/c-runtime-library/reference/round-roundf-roundl.md | 3 +-- .../scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md | 3 +-- docs/c-runtime-library/reference/sin-sinf-sinl.md | 2 +- docs/c-runtime-library/reference/sinh-sinhf-sinhl.md | 2 +- docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md | 2 +- docs/c-runtime-library/reference/tan-tanf-tanl.md | 3 +-- docs/c-runtime-library/reference/tanh-tanhf-tanhl.md | 2 +- docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md | 3 +-- docs/c-runtime-library/reference/trunc-truncf-truncl.md | 3 +-- docs/standard-library/basic-string-view-class.md | 2 +- docs/standard-library/multimap-class.md | 2 +- docs/standard-library/ranges-alias-templates.md | 2 +- 54 files changed, 54 insertions(+), 88 deletions(-) diff --git a/docs/c-runtime-library/reference/acos-acosf-acosl.md b/docs/c-runtime-library/reference/acos-acosf-acosl.md index 3331c7dc527..b570c16c00b 100644 --- a/docs/c-runtime-library/reference/acos-acosf-acosl.md +++ b/docs/c-runtime-library/reference/acos-acosf-acosl.md @@ -1,7 +1,7 @@ --- title: "acos, acosf, acosl" description: "API reference for acos, acosf, and acosl; which calculate the arccosine of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["acosf", "acos", "acosl", "_o_acos", "_o_acosf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md b/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md index f0e0a7ab9c0..18d9c23aa14 100644 --- a/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md +++ b/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md @@ -1,14 +1,13 @@ --- title: "acosh, acoshf, acoshl" description: "API reference for acosh, acoshf, and acoshl; which calculate the inverse hyperbolic cosine of a floating-point value." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["acoshf", "acosh", "acoshl", "_o_acosh", "_o_acoshf", "_o_acoshl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["acosh", "acoshf", "acoshl", "math/acosh", "math/acoshf", "math/acoshl"] helpviewer_keywords: ["acoshf function", "acosh function", "acoshl function"] -ms.assetid: 6985c4d7-9e2a-44ce-9a9b-5a43015f15f7 --- # `acosh`, `acoshf`, `acoshl` diff --git a/docs/c-runtime-library/reference/asin-asinf-asinl.md b/docs/c-runtime-library/reference/asin-asinf-asinl.md index 78f55912eda..0e7495e47af 100644 --- a/docs/c-runtime-library/reference/asin-asinf-asinl.md +++ b/docs/c-runtime-library/reference/asin-asinf-asinl.md @@ -1,7 +1,7 @@ --- title: "asin, asinf, asinl" description: "API reference for asin, asinf, and asinl; which calculate the arcsine of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["asinf", "asinl", "asin", "_o_asin", "_o_asinf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md b/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md index 0c8d3cf295c..8501e27ac0f 100644 --- a/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md +++ b/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md @@ -1,14 +1,13 @@ --- title: "asinh, asinhf, asinhl" description: "API reference for asinh, asinhf, and asinhl; which calculate the inverse hyperbolic sine of a floating-point value." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["asinh", "asinhf", "asinhl", "_o_asinh", "_o_asinhf", "_o_asinhl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["asinhf", "asinhl", "asinh"] helpviewer_keywords: ["asinh function", "asinhl function", "asinhf function"] -ms.assetid: 4488babe-1a7e-44ca-8b7b-c2db0a70084f --- # `asinh`, `asinhf`, `asinhl` diff --git a/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md b/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md index 4728064b395..91fc052f9a7 100644 --- a/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md +++ b/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md @@ -1,7 +1,7 @@ --- title: "atan, atanf, atanl, atan2, atan2f, atan2l" description: "API reference for atan, atanf, atanl, atan2, atan2f, and atan2l; which calculate the arctangent of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["atan2f", "atan2l", "atan2", "atanf", "atan", "atanl", "_o_atan", "_o_atan2", "_o_atan2f", "_o_atanf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/carg-cargf-cargl.md b/docs/c-runtime-library/reference/carg-cargf-cargl.md index 6ed3fd4e4a4..867def0277a 100644 --- a/docs/c-runtime-library/reference/carg-cargf-cargl.md +++ b/docs/c-runtime-library/reference/carg-cargf-cargl.md @@ -1,14 +1,13 @@ --- title: "carg, cargf, cargl" description: "API reference for carg, cargf, and cargl; which retrieve the argument of a complex number, with a branch cut along the negative real axis." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["carg", "cargf", "cargl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["carg", "cargf", "cargl", "complex/carg", "complex/cargf", "complex/cargl"] helpviewer_keywords: ["carg function", "cargf function", "cargl function"] -ms.assetid: 610d6a93-b929-46ab-a966-b77db0b804be --- # `carg`, `cargf`, `cargl` diff --git a/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md b/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md index ae888def20d..0ec75d67622 100644 --- a/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md +++ b/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md @@ -1,14 +1,13 @@ --- title: "cbrt, cbrtf, cbrtl" description: "API reference for cbrt, cbrtf, and cbrtl; which calculate a cube root" -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["cbrt", "cbrtf", "cbrtl", "_o_cbrt", "_o_cbrtf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cbrtl", "cbrt", "cbrtf"] helpviewer_keywords: ["cbrtl function", "cbrtf function", "cbrt function"] -ms.assetid: ab51d916-3db2-4beb-b46a-28b4062cd33f --- # `cbrt`, `cbrtf`, `cbrtl` diff --git a/docs/c-runtime-library/reference/ceil-ceilf-ceill.md b/docs/c-runtime-library/reference/ceil-ceilf-ceill.md index 3fe4f9a5a44..c1e0fc6cfbe 100644 --- a/docs/c-runtime-library/reference/ceil-ceilf-ceill.md +++ b/docs/c-runtime-library/reference/ceil-ceilf-ceill.md @@ -1,14 +1,13 @@ --- title: "ceil, ceilf, ceill" description: "API ref for calculating the ceiling of a value with ceil()." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["ceilf", "ceil", "ceill", "_o_ceil", "_o_ceilf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntdll.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ceil", "ceilf", "ceill"] helpviewer_keywords: ["calculating value ceilings", "ceill function", "ceil function", "ceilf function"] -ms.assetid: f4e5acab-5c8f-4b10-9ae2-9561e6453718 --- # `ceil`, `ceilf`, `ceill` diff --git a/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md b/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md index 38f9436dc51..2f896bd5097 100644 --- a/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md +++ b/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md @@ -1,14 +1,13 @@ --- title: "cimag, cimagf, cimagl" description: "API reference for cimag, cimagf, and cimagl; which retrieve the imaginary part of a complex number." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["cimag", "cimagf", "cimagl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cimagf", "cimagl", "complex/cimag", "complex/cimagf", "complex/cimagl", "cimag"] helpviewer_keywords: ["cimag function", "cimagf function", "cimagl function"] -ms.assetid: 0d8836f5-d61d-44cd-8731-6f75cb776def --- # `cimag`, `cimagf`, `cimagl` diff --git a/docs/c-runtime-library/reference/conj-conjf-conjl.md b/docs/c-runtime-library/reference/conj-conjf-conjl.md index bcff214657e..fbf227b3e4e 100644 --- a/docs/c-runtime-library/reference/conj-conjf-conjl.md +++ b/docs/c-runtime-library/reference/conj-conjf-conjl.md @@ -1,14 +1,13 @@ --- title: "conj, conjf, conjl" description: "API reference for conj, conjf, and conjl; which retrieve the complex conjugate of a complex number." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["conj", "conjf", "conjl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["conj", "conjf", "conjl", "complex/conj", "complex/conjf", "complex/conjl"] helpviewer_keywords: ["conj function", "conjf function", "conjl function"] -ms.assetid: 792fccfa-19c6-4890-99f9-a3b89effccd6 --- # `conj`, `conjf`, `conjl` diff --git a/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md b/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md index f5708458d32..225fd4e100d 100644 --- a/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md +++ b/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md @@ -1,14 +1,13 @@ --- title: "copysign, copysignf, copysignl, _copysign, _copysignf, _copysignl" description: "API ref for returning a value that has the magnitude of one argument and the sign of another using copysign()" -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["copysignf", "copysignl", "_copysignl", "_copysign", "_copysignf", "copysign"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_copysignl", "copysign", "copysignf", "_copysign", "copysignl", "_copysignf"] helpviewer_keywords: ["copysignl function", "_copysignl function", "copysign function", "_copysignf function", "_copysign function", "copysignf function"] -ms.assetid: 009216d6-72a2-402d-aa6c-91d924b2c9e4 --- # `copysign`, `copysignf`, `copysignl`, `_copysign`, `_copysignf`, `_copysignl` diff --git a/docs/c-runtime-library/reference/cos-cosf-cosl.md b/docs/c-runtime-library/reference/cos-cosf-cosl.md index 6cf5dc380e7..ab58605fd61 100644 --- a/docs/c-runtime-library/reference/cos-cosf-cosl.md +++ b/docs/c-runtime-library/reference/cos-cosf-cosl.md @@ -1,14 +1,13 @@ --- title: "cos, cosf, cosl" description: "API reference for cos, cosf, and cosl; which calculate the cosine value of a floating-point number." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["cos", "cosf", "cosl", "_o_cos", "_o_cosf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cos", "cosf", "cosl"] helpviewer_keywords: ["cosines", "cosl function", "calculating cosine", "cosf function", "cos function", "trigonometric functions", "cosines, calculating"] -ms.assetid: ae90435e-6b68-4a47-a81f-be87d5c08f16 --- # `cos`, `cosf`, `cosl` diff --git a/docs/c-runtime-library/reference/cosh-coshf-coshl.md b/docs/c-runtime-library/reference/cosh-coshf-coshl.md index 58d8ea27833..f02e9ed491d 100644 --- a/docs/c-runtime-library/reference/cosh-coshf-coshl.md +++ b/docs/c-runtime-library/reference/cosh-coshf-coshl.md @@ -1,7 +1,7 @@ --- title: "cosh, coshf, coshl" description: "API reference for cosh, coshf, and coshl; which calculate the hyperbolic cosine of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["cosh", "coshf", "coshl", "_o_cosh", "_o_coshf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md b/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md index 6c5f591a6b7..99f512c15eb 100644 --- a/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md +++ b/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md @@ -1,14 +1,13 @@ --- title: "cproj, cprojf, cprojl" description: "API reference for cproj, cprojf, and cprojl; which retrieve the projection of a complex number on the Reimann sphere." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["cproj", "cprojf", "cprojl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cproj", "cprojf", "cprojl", "complex/cproj", "complex/cprojf", "complex/cprojl"] helpviewer_keywords: ["cproj function", "cprojf function", "cprojl function"] -ms.assetid: 32b49623-13bf-4cae-802e-7912d75030fe --- # `cproj`, `cprojf`, `cprojl` diff --git a/docs/c-runtime-library/reference/creal-crealf-creall.md b/docs/c-runtime-library/reference/creal-crealf-creall.md index d278124752a..82f3159c8da 100644 --- a/docs/c-runtime-library/reference/creal-crealf-creall.md +++ b/docs/c-runtime-library/reference/creal-crealf-creall.md @@ -1,14 +1,13 @@ --- title: "creal, crealf, creall" description: "API reference for creal, crealf, creall; which retrieve the real part of a complex number." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["creal", "crealf", "creall"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["creal", "crealf", "creall", "complex/creal", "complex/crealf", "complex/creall"] helpviewer_keywords: ["creal function", "crealf function", "creall function"] -ms.assetid: fa3ac62f-7aa3-4238-a71f-d6b00cd0c7c8 --- # `creal`, `crealf`, `creall` diff --git a/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md b/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md index 82a5e66ef58..84e447fee52 100644 --- a/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md +++ b/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md @@ -1,14 +1,13 @@ --- title: "erf, erff, erfl, erfc, erfcf, erfcl" description: "API reference for erf, erff, erfl, erfc, erfcf, and erfcl; which computes the error function or the complementary error function of a value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["erff", "erfl", "erf", "erfc", "erfcf", "erfcl", "_o_erf", "_o_erfc", "_o_erfcf", "_o_erfcl", "_o_erff", "_o_erfl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["erfl", "erf", "erff", "erfc", "erfcf", "erfcl"] helpviewer_keywords: ["erfl function", "erff function", "erf function", "erfcl function", "erfcf function", "erfc function"] -ms.assetid: 144d90d3-e437-41c2-a659-cd57596023b5 --- # `erf`, `erff`, `erfl`, `erfc`, `erfcf`, `erfcl` diff --git a/docs/c-runtime-library/reference/exp-expf.md b/docs/c-runtime-library/reference/exp-expf.md index 0561c68403a..b79dcacd4c9 100644 --- a/docs/c-runtime-library/reference/exp-expf.md +++ b/docs/c-runtime-library/reference/exp-expf.md @@ -1,7 +1,7 @@ --- title: "exp, expf, expl" description: "API reference for exp, expf, and expl; which calculate the exponential." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["expf", "expl", "exp", "_o_exp", "_o_expf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md b/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md index 2559908fdf0..472d0cd5ce2 100644 --- a/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md +++ b/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md @@ -1,7 +1,7 @@ --- title: "exp2, exp2f, exp2l" description: "API ref for exp2(), exp2f(), and exp2l() which compute 2 raised to the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["exp2", "exp2f", "exp2l", "_o_exp2", "_o_exp2f", "_o_exp2l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md b/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md index 78087e43f2b..7afd9844a3b 100644 --- a/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md +++ b/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md @@ -1,14 +1,13 @@ --- title: "expm1, expm1f, expm1l" description: "API reference for expm1, expm1f, and expm1; which compute the base-e exponential of a value, minus one." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["expm1l", "expm1", "expm1f"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["expm1l", "expm1", "expm1f"] helpviewer_keywords: ["expm1f function", "expm1l function", "expm1 function"] -ms.assetid: 2a4dd2d9-370c-42b0-9067-0625efa272e0 --- # `expm1`, `expm1f`, `expm1l` diff --git a/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md b/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md index 0ee38420ea9..7b408b24326 100644 --- a/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md +++ b/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md @@ -1,7 +1,7 @@ --- title: "fdim, fdimf, fdiml" description: "API reference for fdim, fdimf, and fdiml; which determines the positive difference between two values." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["fdim", "fdimf", "fdiml"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/floor-floorf-floorl.md b/docs/c-runtime-library/reference/floor-floorf-floorl.md index fd681f6214b..6c5ae98469f 100644 --- a/docs/c-runtime-library/reference/floor-floorf-floorl.md +++ b/docs/c-runtime-library/reference/floor-floorf-floorl.md @@ -1,14 +1,13 @@ --- title: "floor, floorf, floorl" description: "API reference for floor, floorf, and floorl; which calculates the floor of a value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["floorf", "floorl", "floor", "_o_floor", "_o_floorf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["floor", "floorl", "_floorl", "floorf"] helpviewer_keywords: ["floor function", "floorf function", "calculating floors of values", "floorl function"] -ms.assetid: e9955f70-d659-414f-8050-132e13c8ff36 --- # `floor`, `floorf`, `floorl` diff --git a/docs/c-runtime-library/reference/fma-fmaf-fmal.md b/docs/c-runtime-library/reference/fma-fmaf-fmal.md index 63c402f46aa..07f439ce48c 100644 --- a/docs/c-runtime-library/reference/fma-fmaf-fmal.md +++ b/docs/c-runtime-library/reference/fma-fmaf-fmal.md @@ -1,14 +1,13 @@ --- title: "fma, fmaf, fmal" description: "API reference for fma, fmaf, and fmal; which multiplies two values together, adds a third value, and then rounds the result, while only losing a small amount of precision due to intermediary rounding." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["fma", "fmaf", "fmal", "_o_fma", "_o_fmaf", "_o_fmal"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["fma", "fmaf", "fmal", "math/fma", "math/fmaf", "math/fmal"] helpviewer_keywords: ["fma function", "fmaf function", "fmal function"] -ms.assetid: 584a6037-da1e-4e86-9f0c-97aae86de0c0 --- # `fma`, `fmaf`, `fmal` diff --git a/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md b/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md index 7d3e3912923..eac6d8411b6 100644 --- a/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md +++ b/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md @@ -1,14 +1,13 @@ --- title: "fmax, fmaxf, fmaxl" description: "API reference for fmax, fmaxf, and fmaxl; which determines the larger of two numeric values." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["fmax", "fmaxf", "fmaxl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["fmax", "fmaxf", "fmaxl", "math/fmax", "math/fmaxf", "math/fmaxl"] helpviewer_keywords: ["fmax function", "fmaxf function", "fmaxl function"] -ms.assetid: a773ccf7-495e-4a9a-8c6d-dfb53e341e35 --- # `fmax`, `fmaxf`, `fmaxl` diff --git a/docs/c-runtime-library/reference/fmin-fminf-fminl.md b/docs/c-runtime-library/reference/fmin-fminf-fminl.md index d59a3b50203..d3cfee38cff 100644 --- a/docs/c-runtime-library/reference/fmin-fminf-fminl.md +++ b/docs/c-runtime-library/reference/fmin-fminf-fminl.md @@ -1,14 +1,13 @@ --- title: "fmin, fminf, fminl" description: "API reference for fmin, fminf, and fminl; which determines the smaller of two values." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["fmin", "fminf", "fminl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["fmin", "fminf", "fminl", "math/fmin", "math/fminf", "math/fminl"] helpviewer_keywords: ["fmin function", "fminf function", "fminl function"] -ms.assetid: 1916dfb5-99c1-4b0d-aefb-513525c3f2ac --- # `fmin`, `fminf`, `fminl` diff --git a/docs/c-runtime-library/reference/fmod-fmodf.md b/docs/c-runtime-library/reference/fmod-fmodf.md index 3c2c7d6974b..5bd8fd5c8a7 100644 --- a/docs/c-runtime-library/reference/fmod-fmodf.md +++ b/docs/c-runtime-library/reference/fmod-fmodf.md @@ -1,7 +1,7 @@ --- title: "fmod, fmodf, fmodl" description: "API reference for fmod, fmodf, and fmodl; which calculates the floating-point remainder." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["fmod", "fmodf", "fmodl", "_o_fmod", "_o_fmodf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/frexp.md b/docs/c-runtime-library/reference/frexp.md index b938f9b68a9..faf5d4404ba 100644 --- a/docs/c-runtime-library/reference/frexp.md +++ b/docs/c-runtime-library/reference/frexp.md @@ -1,14 +1,13 @@ --- title: "frexp, frexpf, frexpl" description: "API reference for frexp, frexpf, and frexpl; which gets the mantissa and exponent of a floating-point number." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["frexp", "_o_frexp"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["frexp", "_frexpl"] helpviewer_keywords: ["_frexpl function", "mantissas, floating-point variables", "frexpl function", "exponent, floating-point numbers", "frexp function", "floating-point functions, mantissa and exponent"] -ms.assetid: 9b020f2e-3967-45ec-a6a8-d467a071aa55 --- # `frexp`, `frexpf`, `frexpl` diff --git a/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md b/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md index f29481721c6..93c84bd8b8d 100644 --- a/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md +++ b/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md @@ -1,14 +1,13 @@ --- title: "hypot, hypotf, hypotl, _hypot, _hypotf, _hypotl" description: "API reference for hypot, hypotf, hypotl, _hypot, _hypotf, and _hypotl; which calculate the hypotenuse." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["_hypotf", "hypot", "hypotf", "_hypot", "_hypotl", "hypotl", "_o__hypot", "_o__hypotf", "_o_hypot"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["hypotf", "hypotl", "_hypotl", "hypot", "_hypot", "_hypotf"] helpviewer_keywords: ["hypotenuse calculation", "hypot function", "hypotf function", "triangles, calculating hypotenuse", "hypotl function", "calculating hypotenuses", "_hypot function"] -ms.assetid: 6a13887f-bd53-43fc-9d77-5b42d6e49925 --- # `hypot`, `hypotf`, `hypotl`, `_hypot`, `_hypotf`, `_hypotl` diff --git a/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md b/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md index 64d4354215f..c666ef5b99b 100644 --- a/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md +++ b/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md @@ -1,14 +1,13 @@ --- title: "ilogb, ilogbf, ilogbl2" description: "API reference for ilogb, ilogbf, and ilogbl2; which retrieve an integer that represents the unbiased base-2 exponent of the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["ilogb", "ilogbf", "ilogbl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ilogb", "ilogbf", "ilogbl", "math/ilogb", "math/ilogbf", "math/ilogbl"] helpviewer_keywords: ["ilogb function", "ilogbf function", "ilogbl function"] -ms.assetid: 9ef19d57-1caa-41d5-8233-2faad3562fcb --- # `ilogb`, `ilogbf`, `ilogbl` diff --git a/docs/c-runtime-library/reference/ldexp.md b/docs/c-runtime-library/reference/ldexp.md index d0b7948b075..b5b2b0ac175 100644 --- a/docs/c-runtime-library/reference/ldexp.md +++ b/docs/c-runtime-library/reference/ldexp.md @@ -1,14 +1,13 @@ --- title: "ldexp, ldexpf, ldexpl" description: "API reference for ldexp, ldexpf, and ldexpl; which multiplies a floating-point number by an integral power of two." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["ldexp", "ldexpf", "ldexpl", "_ldexpl", "_o_ldexp"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ldexp", "ldexpf", "ldexpl", "_ldexpl"] helpviewer_keywords: ["calculating real numbers", "computing real numbers", "mantissas, floating-point variables", "ldexp function", "ldexpf function", "ldexpl function", "exponent, floating-point numbers", "floating-point functions, mantissa and exponent"] -ms.assetid: aa7f5310-3879-4f63-ae74-86a39fbdedfa --- # `ldexp`, `ldexpf`, `ldexpl` diff --git a/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md b/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md index d094800e350..cd6eac91103 100644 --- a/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md +++ b/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md @@ -1,14 +1,13 @@ --- title: "lgamma, lgammaf, lgammal" description: "API reference for lgamma, lgammaf, and lgammal; which determines the natural logarithm of the absolute value of the gamma function of the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["lgamma", "lgammaf", "lgammal", "_o_lgamma", "_o_lgammaf", "_o_lgammal"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["lgamma", "lgammaf", "lgammal", "math/lgamma", "math/lgammaf", "math/lgammal"] helpviewer_keywords: ["lgamma function", "lgammal function", "lgammaf function"] -ms.assetid: 6e326c58-7077-481a-a329-c82ae56ae9e6 --- # `lgamma`, `lgammaf`, `lgammal` diff --git a/docs/c-runtime-library/reference/log-logf-log10-log10f.md b/docs/c-runtime-library/reference/log-logf-log10-log10f.md index 75a7a43bbb4..ba904c50ab6 100644 --- a/docs/c-runtime-library/reference/log-logf-log10-log10f.md +++ b/docs/c-runtime-library/reference/log-logf-log10-log10f.md @@ -1,7 +1,7 @@ --- title: "log, logf, logl, log10, log10f, log10l" description: "API reference for log, logf, logl, log10, log10f, and log10l; which calculate logarithms." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["log10f", "logf", "log10", "log", "log10l", "logl", "_o_log", "_o_log10", "_o_log10f", "_o_logf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md b/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md index 75546e43ad3..ae3103f60cc 100644 --- a/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md +++ b/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md @@ -1,7 +1,7 @@ --- title: "log1p, log1pf, log1pl2" description: "API reference for log1p, log1pf, log1pl2; which compute the natural logarithm of 1 plus the specified value." -ms.date: "2/1/2023" +ms.date: 2/1/2023 api_name: ["log1p", "log1pf", "log1pl", "_o_log1p", "_o_log1pf", "_o_log1pl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/log2-log2f-log2l.md b/docs/c-runtime-library/reference/log2-log2f-log2l.md index 843588413e9..329ca699d05 100644 --- a/docs/c-runtime-library/reference/log2-log2f-log2l.md +++ b/docs/c-runtime-library/reference/log2-log2f-log2l.md @@ -1,12 +1,11 @@ --- title: "log2, log2f, log2l" description: "API reference for log2, log2f, and log2l; which determine the binary (base-2) logarithm of the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["log2", "log2l", "log2f", "_o_log2", "_o_log2f", "_o_log2l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] -ms.assetid: 94d11b38-70b7-4d3a-94ac-523153c92b2e --- # `log2`, `log2f`, `log2l` diff --git a/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md b/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md index cecb23c40c4..cec043552fb 100644 --- a/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md +++ b/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md @@ -1,7 +1,7 @@ --- title: "logb, logbf, logbl, _logb, _logbf" description: "API reference for logb, logbf, logbl, _logb, and _logbf; which extract the exponent value of a floating-point argument." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["logb", "_logb", "_logbl", "logbf", "_logbf", "logbl", "_o__logb", "_o_logb", "_o_logbf", "_o_logbl", "_o__logbf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md b/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md index 4e2cabfabef..732c7abe857 100644 --- a/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md +++ b/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md @@ -1,14 +1,13 @@ --- title: "lrint, lrintf, lrintl, llrint, llrintf, llrintl" description: "API reference for lrint(), lrintf(), lrintl(), llrint(), llrintf(), and llrintl(); which rounds the specified floating-point value to the nearest integral value, by using the current rounding mode and direction." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["lrint", "lrintl", "lrintf", "llrint", "llrintf", "llrintl", "_o_llrint", "_o_llrintf", "_o_llrintl", "_o_lrint", "_o_lrintf", "_o_lrintl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["lrint", "lrintf", "lrintl", "llrint", "llrintf", "llrintl", "math/lrint", "math/lrintf", "math/lrintl", "math/llrint", "math/llrintf", "math/llrintl"] helpviewer_keywords: ["lrint function", "lrintf function", "lrintl function", "llrint function", "llrintf function", "llrintl function"] -ms.assetid: 28ccd5b3-5e6f-434f-997d-a21d51b8ce7f --- # `lrint`, `lrintf`, `lrintl`, `llrint`, `llrintf`, `llrintl` diff --git a/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md b/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md index 64f11776c57..d9ff713ffdd 100644 --- a/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md +++ b/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md @@ -1,14 +1,13 @@ --- title: "lround, lroundf, lroundl, llround, llroundf, llroundl" description: "API reference for lround, lroundf, lroundl, llround, llroundf, and llroundl; which rounds a floating-point value to the nearest integer." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["llround", "llroundf", "llroundl", "lroundf", "lround", "lroundl", "_o_llround", "_o_llroundf", "_o_llroundl", "_o_lround", "_o_lroundf", "_o_lroundl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["lround", "lroundl", "llroundl", "llround", "lroundf", "llroundf"] helpviewer_keywords: ["lround function", "llroundl function", "llround function", "lroundf function", "llroundf function", "lroundl function"] -ms.assetid: cfb88a35-54c6-469f-85af-f7d695dcfdd8 --- # `lround`, `lroundf`, `lroundl`, `llround`, `llroundf`, `llroundl` diff --git a/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md b/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md index 8690d2f7cf5..e94c9df0707 100644 --- a/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md +++ b/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md @@ -1,14 +1,13 @@ --- title: "nearbyint, nearbyintf, nearbyintl" description: "API reference for nearbyint, nearbyintf, and nearbyintl; which rounds the specified floating-point value to an integer, and returns that value in a floating-point format." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["nearbyint", "nearbyintf", "nearbyintl", "_o_nearbyint", "_o_nearbyintf", "_o_nearbyintl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["nearbyint", "nearbyintf", "nearbyintl", "math/nearbyint", "math/narbyintf", "math/narbyintl"] helpviewer_keywords: ["nearbyint function", "nearbyintf function", "nearbyintl function"] -ms.assetid: dd39cb68-96b0-434b-820f-6ff2ea65584f --- # `nearbyint`, `nearbyintf`, `nearbyintl` diff --git a/docs/c-runtime-library/reference/nextafter-functions.md b/docs/c-runtime-library/reference/nextafter-functions.md index 811876c1c93..e2b6758121d 100644 --- a/docs/c-runtime-library/reference/nextafter-functions.md +++ b/docs/c-runtime-library/reference/nextafter-functions.md @@ -1,7 +1,7 @@ --- title: "nextafter, nextafterf, nextafterl, _nextafter, _nextafterf, nexttoward, nexttowardf, nexttowardl" description: "API reference for nextafter, nextafterf, nextafterl, _nextafter, _nextafterf, nexttoward, nexttowardf, and nexttowardl; which return the next representable floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["nextafterf", "_nextafterf", "nextafter", "nextafterl", "_nextafter", "nexttoward", "nexttowardf", "nexttowardl", "_o__nextafter", "_o_nextafter", "_o_nextafterf", "_o_nextafterl", "_o_nexttoward", "_o_nexttowardf", "_o_nexttowardl", "_o__nextafterf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/pow-powf-powl.md b/docs/c-runtime-library/reference/pow-powf-powl.md index fd914f7fb59..dbc3247460f 100644 --- a/docs/c-runtime-library/reference/pow-powf-powl.md +++ b/docs/c-runtime-library/reference/pow-powf-powl.md @@ -1,14 +1,13 @@ --- title: "pow, powf, powl" description: "API reference for pow, powf, and powl; which calculate exponents." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["powl", "pow", "powf", "_o_pow", "_o_powf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["powl", "pow", "_powl", "powf"] helpviewer_keywords: ["exponential calculations", "powl function", "_powl function", "exponentiation", "powers, calculating", "calculating exponentials", "powf function", "pow function"] -ms.assetid: e75c33ed-2e59-48b1-be40-81da917324f1 --- # `pow`, `powf`, `powl` diff --git a/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md b/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md index 7371dfcdf71..807e001cd3c 100644 --- a/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md +++ b/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md @@ -1,14 +1,13 @@ --- title: "remainder, remainderf, remainderl" description: "API reference for remainder, remainderf, and remainderl; which compute the remainder of the quotient of two floating-point values, rounded to the nearest integral value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["remainderl", "remainder", "remainderf", "_o_remainder", "_o_remainderf", "_o_remainderl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["remainderf", "remainder", "remainderl"] helpviewer_keywords: ["remainderf", "remainderl", "remainder"] -ms.assetid: 5f721fb3-8b78-4597-9bc0-ca9bcd1f1d0e --- # `remainder`, `remainderf`, `remainderl` diff --git a/docs/c-runtime-library/reference/remquo-remquof-remquol.md b/docs/c-runtime-library/reference/remquo-remquof-remquol.md index 1509f00640e..d756c829f01 100644 --- a/docs/c-runtime-library/reference/remquo-remquof-remquol.md +++ b/docs/c-runtime-library/reference/remquo-remquof-remquol.md @@ -1,7 +1,7 @@ --- title: "remquo, remquof, remquol" description: "API reference for remquo, remquof, and remquol, which compute the remainder of two integer values, and store the sign and approximate magnitude of the quotient." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["remquof", "remquo", "remquol", "_o_remquo", "_o_remquof", "_o_remquol"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/rint-rintf-rintl.md b/docs/c-runtime-library/reference/rint-rintf-rintl.md index 2890f61732d..ac703cb135f 100644 --- a/docs/c-runtime-library/reference/rint-rintf-rintl.md +++ b/docs/c-runtime-library/reference/rint-rintf-rintl.md @@ -1,14 +1,13 @@ --- title: "rint, rintf, rintl" description: "API reference for rint, rintf, and rintl; which round a floating-point value to the nearest integer in floating-point format." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["rintf", "rintl", "rint", "_o_rint", "_o_rintf", "_o_rintl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["rintf", "rintl", "rint"] helpviewer_keywords: ["rintf function", "rint function", "rintl function"] -ms.assetid: 312ae3e6-278c-459a-9393-11b8f87d9184 --- # `rint`, `rintf`, `rintl` diff --git a/docs/c-runtime-library/reference/round-roundf-roundl.md b/docs/c-runtime-library/reference/round-roundf-roundl.md index 8f4c85b8035..df753b8e603 100644 --- a/docs/c-runtime-library/reference/round-roundf-roundl.md +++ b/docs/c-runtime-library/reference/round-roundf-roundl.md @@ -1,14 +1,13 @@ --- title: "round, roundf, roundl" description: "API reference for round, roundf, and roundl; which round a floating-point value to the nearest integer value." -ms.date: "09/25/2020" +ms.date: 09/25/2020 api_name: ["round", "roundl", "roundf", "_o_round", "_o_roundf", "_o_roundl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["roundf", "roundl", "round"] helpviewer_keywords: ["roundl function", "round function", "roundf function"] -ms.assetid: 6be90877-193c-4b80-a32b-c3eca33f9c6f --- # `round`, `roundf`, `roundl` diff --git a/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md b/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md index 71be511abd0..e8633ee0086 100644 --- a/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md +++ b/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md @@ -1,14 +1,13 @@ --- title: "scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl" description: "API reference for scalbn, scalbnf, scalbnl, scalbln, scalblnf, and scalblnl; which multiplies a floating-point number by an integral power of `FLT_RADIX`." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["scalblnl", "scalbnl", "scalbnf", "scalblnf", "scalbn", "scalbln", "_o_scalbln", "_o_scalblnf", "_o_scalblnl", "_o_scalbn", "_o_scalbnf", "_o_scalbnl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["scalblnf", "scalbnl", "scalblnl", "scalbln", "scalbn", "scalbnf"] helpviewer_keywords: ["scalbn function", "scalbln function", "scalblnl function", "scalbnl function", "scalbnf function", "scalblnf function"] -ms.assetid: df2f1543-8e39-4af4-a5cf-29307e64807d --- # `scalbn`, `scalbnf`, `scalbnl`, `scalbln`, `scalblnf`, `scalblnl` diff --git a/docs/c-runtime-library/reference/sin-sinf-sinl.md b/docs/c-runtime-library/reference/sin-sinf-sinl.md index dcc855ecca6..ae1f2d1e354 100644 --- a/docs/c-runtime-library/reference/sin-sinf-sinl.md +++ b/docs/c-runtime-library/reference/sin-sinf-sinl.md @@ -1,7 +1,7 @@ --- title: "sin, sinf, sinl" description: "API reference for sin, sinf, and sinl; which calculate the sine of a floating-point value." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["sinl", "sinf", "sin", "_o_sin", "_o_sinf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md b/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md index d4d370a4211..161a0998f1a 100644 --- a/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md +++ b/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md @@ -1,7 +1,7 @@ --- title: "sinh, sinhf, sinhl" description: "API reference for calculating the hyperbolic sine of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["sinh", "sinhl", "sinhf", "sinhl", "_o_sinh", "_o_sinhf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md b/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md index 08dfd4bcfdd..2e1c685b8e5 100644 --- a/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md +++ b/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md @@ -1,7 +1,7 @@ --- title: "sqrt, sqrtf, sqrtl" description: "API reference for sqrt, sqrtf, and sqrtl; which calculate a square root of a floating point number." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["sqrtl", "sqrtf", "sqrt", "_o_sqrt", "_o_sqrtf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/tan-tanf-tanl.md b/docs/c-runtime-library/reference/tan-tanf-tanl.md index 8c4f53b0c98..58e1563bf1a 100644 --- a/docs/c-runtime-library/reference/tan-tanf-tanl.md +++ b/docs/c-runtime-library/reference/tan-tanf-tanl.md @@ -1,14 +1,13 @@ --- title: "tan, tanf, tanl" description: "API reference for tan, tanf, and tanl; which calculate the tangent of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["tan", "tanf", "tanl", "_o_tan", "_o_tanf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_MATH/tan", "CORECRT_MATH/tanf", "CORECRT_MATH/tanl", "tan", "tanf", "tanl"] helpviewer_keywords: ["tanl function", "tan function", "calculating tangents", "tangent", "tanf function", "trigonometric functions"] -ms.assetid: 36cc0ce8-9c80-4653-b354-ddb3b378b6bd --- # `tan`, `tanf`, `tanl` diff --git a/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md b/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md index dc74374a239..069c1a809fe 100644 --- a/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md +++ b/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md @@ -1,7 +1,7 @@ --- title: "tanh, tanhf, tanhl" description: "API reference for tanh, tanhf, and tanhl; which calculate the hyperbolic tangent of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["tanh", "tanhf", "tanhl", "_o_tanh", "_o_tanhf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md b/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md index ee77d2be7f6..820761ba8b9 100644 --- a/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md +++ b/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md @@ -1,14 +1,13 @@ --- title: "tgamma, tgammaf, tgammal" description: "API reference for tgamma, tgammaf, and tgammal; which determine the gamma function of the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["tgamma", "tgammaf", "tgammal", "_o_tgamma", "_o_tgammaf", "_o_tgammal"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_MATH/tgamma", "CORECRT_MATH/tgammaf", "CORECRT_MATH/tgammal", "tgamma", "tgammaf", "tgammal"] helpviewer_keywords: ["tgamma function", "tgammaf function", "tgammal function"] -ms.assetid: f1bd2681-8af2-48a9-919d-5358fd068acd --- # `tgamma`, `tgammaf`, `tgammal` diff --git a/docs/c-runtime-library/reference/trunc-truncf-truncl.md b/docs/c-runtime-library/reference/trunc-truncf-truncl.md index f392bcd2971..19205505760 100644 --- a/docs/c-runtime-library/reference/trunc-truncf-truncl.md +++ b/docs/c-runtime-library/reference/trunc-truncf-truncl.md @@ -1,14 +1,13 @@ --- title: "trunc, truncf, truncl" description: "API reference for trunc, truncf, truncl; which determine the nearest integer that is less than or equal to the specified floating-point value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["trunc", "truncf", "truncl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_MATH/trunc", "CORECRT_MATH/truncf", "CORECRT_MATH/truncl", "math/trunc", "math/truncf", "math/truncl", "trunc", "truncf", "truncl"] helpviewer_keywords: ["trunc function", "truncf function", "truncl function"] -ms.assetid: de2038ac-ac0b-483e-870c-e8992dcd4fd0 --- # `trunc`, `truncf`, `truncl` diff --git a/docs/standard-library/basic-string-view-class.md b/docs/standard-library/basic-string-view-class.md index 16073e5999a..014c086606c 100644 --- a/docs/standard-library/basic-string-view-class.md +++ b/docs/standard-library/basic-string-view-class.md @@ -1,7 +1,7 @@ --- title: "basic_string_view Class" description: "API reference for `basic_string_view`, which refers to a constant contiguous sequence of char-like objects." -ms.date: "9/8/2020" +ms.date: 9/8/2020 f1_keywords: ["xstring/std::basic_string_view", "xstring/std::basic_string_view::allocator_type", "xstring/std::basic_string_view::const_iterator", "xstring/std::basic_string_view::const_pointer", "xstring/std::basic_string_view::const_reference", "xstring/std::basic_string_view::const_reverse_iterator", "xstring/std::basic_string_view::difference_type", "xstring/std::basic_string_view::ends_with", "xstring/std::basic_string_view::starts_with", "xstring/std::basic_string_view::iterator", "xstring/std::basic_string_view::npos", "xstring/std::basic_string_view::pointer", "xstring/std::basic_string_view::reference", "xstring/std::basic_string_view::reverse_iterator", "xstring/std::basic_string_view::size_type", "xstring/std::basic_string_view::traits_type", "xstring/std::basic_string_view::value_type", "xstring/std::basic_string_view::append", "xstring/std::basic_string_view::assign", "xstring/std::basic_string_view::at", "xstring/std::basic_string_view::back", "xstring/std::basic_string_view::begin", "xstring/std::basic_string_view::c_str", "xstring/std::basic_string_view::capacity", "xstring/std::basic_string_view::cbegin", "xstring/std::basic_string_view::cend", "xstring/std::basic_string_view::clear", "xstring/std::basic_string_view::compare", "xstring/std::basic_string_view::copy", "xstring/std::basic_string_view::_Copy_s", "xstring/std::basic_string_view::crbegin", "xstring/std::basic_string_view::crend", "xstring/std::basic_string_view::data", "xstring/std::basic_string_view::empty", "xstring/std::basic_string_view::end", "xstring/std::basic_string_view::erase", "xstring/std::basic_string_view::find", "xstring/std::basic_string_view::find_first_not_of", "xstring/std::basic_string_view::find_first_of", "xstring/std::basic_string_view::find_last_not_of", "xstring/std::basic_string_view::find_last_of", "xstring/std::basic_string_view::front", "xstring/std::basic_string_view::get_allocator", "xstring/std::basic_string_view::insert", "xstring/std::basic_string_view::length", "xstring/std::basic_string_view::max_size", "xstring/std::basic_string_view::pop_back", "xstring/std::basic_string_view::push_back", "xstring/std::basic_string_view::rbegin", "xstring/std::basic_string_view::rend", "xstring/std::basic_string_view::remove_prefix","xstring/std::basic_string_view::remove_suffix", "xstring/std::basic_string_view::replace", "xstring/std::basic_string_view::reserve", "xstring/std::basic_string_view::resize", "xstring/std::basic_string_view::rfind", "xstring/std::basic_string_view::shrink_to_fit", "xstring/std::basic_string_view::size", "xstring/std::basic_string_view::substr", "xstring/std::basic_string_view::swap"] helpviewer_keywords: ["std::basic_string_view", "std::basic_string_view, allocator_type", "std::basic_string_view, const_iterator", "std::basic_string_view, const_pointer", "std::basic_string_view, const_reference", "std::basic_string_view, const_reverse_iterator", "std::basic_string_view, difference_type", "std::basic_string_view, iterator", "std::basic_string_view, npos", "std::basic_string_view, pointer", "std::basic_string_view, reference", "std::basic_string_view, reverse_iterator", "std::basic_string_view, size_type", "std::basic_string_view, traits_type", "std::basic_string_view, value_type", "std::basic_string_view, append", "std::basic_string_view, assign", "std::basic_string_view, at", "std::basic_string_view, back", "std::basic_string_view, begin", "std::basic_string_view, c_str", "std::basic_string_view, capacity", "std::basic_string_view, cbegin", "std::basic_string_view, cend", "std::basic_string_view, clear", "std::basic_string_view, compare", "std::basic_string_view, copy", "std::basic_string_view, crbegin", "std::basic_string_view, crend", "std::basic_string_view, data", "std::basic_string_view, empty", "std::basic_string_view, end", "std::basic_string_view, ends_with", "std::basic_string_view, erase", "std::basic_string_view, find", "std::basic_string_view, find_first_not_of", "std::basic_string_view, find_first_of", "std::basic_string_view, find_last_not_of", "std::basic_string_view, find_last_of", "std::basic_string_view, front", "std::basic_string_view, get_allocator", "std::basic_string_view, insert", "std::basic_string_view, length", "std::basic_string_view, max_size", "std::basic_string_view, pop_back", "std::basic_string_view, push_back", "std::basic_string_view, rbegin", "std::basic_string_view, rend", "std::basic_string_view, remove_prefix","std::basic_string_view, remove_suffix","std::basic_string_view, replace", "std::basic_string_view, reserve", "std::basic_string_view, resize", "std::basic_string_view, rfind", "std::basic_string_view, shrink_to_fit", "std::basic_string_view, size", "std::basic_string_view, starts_with", "std::basic_string_view, substr", "std::basic_string_view, swap"] --- diff --git a/docs/standard-library/multimap-class.md b/docs/standard-library/multimap-class.md index 1f4819770f6..3db0788cc5f 100644 --- a/docs/standard-library/multimap-class.md +++ b/docs/standard-library/multimap-class.md @@ -1,7 +1,7 @@ --- title: "multimap Class" description: "API reference for the C++ Standard Template Library (STL) `multimap` class, which is used for the storage and retrieval of data from a collection in which each element is a pair that has both a data value and a sort key." -ms.date: "9/9/2020" +ms.date: 9/9/2020 f1_keywords: ["map/std::multimap", "map/std::multimap::allocator_type", "map/std::multimap::const_iterator", "map/std::multimap::const_pointer", "map/std::multimap::const_reference", "map/std::multimap::const_reverse_iterator", "map/std::multimap::difference_type", "map/std::multimap::iterator", "map/std::multimap::key_compare", "map/std::multimap::key_type", "map/std::multimap::mapped_type", "map/std::multimap::pointer", "map/std::multimap::reference", "map/std::multimap::reverse_iterator", "map/std::multimap::size_type", "map/std::multimap::value_type", "map/std::multimap::begin", "map/std::multimap::cbegin", "map/std::multimap::cend", "map/std::multimap::clear", "map/std::multimap::contains", "map/std::multimap::count", "map/std::multimap::crbegin", "map/std::multimap::crend", "map/std::multimap::emplace", "map/std::multimap::emplace_hint", "map/std::multimap::empty", "map/std::multimap::end", "map/std::multimap::equal_range", "map/std::multimap::erase", "map/std::multimap::find", "map/std::multimap::get_allocator", "map/std::multimap::insert", "map/std::multimap::key_comp", "map/std::multimap::lower_bound", "map/std::multimap::max_size", "map/std::multimap::rbegin", "map/std::multimap::rend", "map/std::multimap::size", "map/std::multimap::swap", "map/std::multimap::upper_bound", "map/std::multimap::value_comp"] helpviewer_keywords: ["std::multimap [C++]", "std::multimap [C++], allocator_type", "std::multimap [C++], const_iterator", "std::multimap [C++], const_pointer", "std::multimap [C++], const_reference", "std::multimap [C++], const_reverse_iterator", "std::multimap [C++], difference_type", "std::multimap [C++], iterator", "std::multimap [C++], key_compare", "std::multimap [C++], key_type", "std::multimap [C++], mapped_type", "std::multimap [C++], pointer", "std::multimap [C++], reference", "std::multimap [C++], reverse_iterator", "std::multimap [C++], size_type", "std::multimap [C++], value_type", "std::multimap [C++], begin", "std::multimap [C++], cbegin", "std::multimap [C++], cend", "std::multimap [C++], clear", "std::multimap [C++], contains", "std::multimap [C++], count", "std::multimap [C++], crbegin", "std::multimap [C++], crend", "std::multimap [C++], emplace", "std::multimap [C++], emplace_hint", "std::multimap [C++], empty", "std::multimap [C++], end", "std::multimap [C++], equal_range", "std::multimap [C++], erase", "std::multimap [C++], find", "std::multimap [C++], get_allocator", "std::multimap [C++], insert", "std::multimap [C++], key_comp", "std::multimap [C++], lower_bound", "std::multimap [C++], max_size", "std::multimap [C++], rbegin", "std::multimap [C++], rend", "std::multimap [C++], size", "std::multimap [C++], swap", "std::multimap [C++], upper_bound", "std::multimap [C++], value_comp"] --- diff --git a/docs/standard-library/ranges-alias-templates.md b/docs/standard-library/ranges-alias-templates.md index 507cd070035..8e709eff0ca 100644 --- a/docs/standard-library/ranges-alias-templates.md +++ b/docs/standard-library/ranges-alias-templates.md @@ -1,6 +1,6 @@ --- -description: "Learn more about ranges alias templates." title: " alias templates" +description: "Learn more about ranges alias templates." ms.date: 01/28/2023 f1_keywords: ["ranges/std::ranges::borrowed_iterator_t", "ranges/std::ranges::borrowed_subrange_t", "ranges/std::ranges::dangling", "ranges/std::ranges::iterator_t", "ranges/std::ranges::range_difference_t", "ranges/std::ranges::range_reference_t", "ranges/std::ranges::range_rvalue_reference_t", "ranges/std::ranges::range_size_t", "ranges/std::ranges::range_value_t", "ranges/std::ranges::sentinel_t"] helpviewer_keywords: ["std::ranges [C++], ranges::borrowed_iterator_t", "std::ranges [C++], ranges::borrowed_subrange_t", "std::ranges [C++], ranges::dangling", "std::ranges [C++], ranges::iterator_t", "std::ranges [C++], ranges::range_difference_t", "std::ranges [C++], ranges::range_reference_t", "std::ranges [C++], ranges::range_rvalue_reference_t", "std::ranges [C++], ranges::range_size_t", "std::ranges [C++], ranges::range_value_t", "std::ranges [C++], ranges::sentinel_t"] From b93555b9c592771c9e0a4a14c8388f7ab112d16f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 8 Jul 2025 22:45:06 +0800 Subject: [PATCH 0310/1799] Add blockquotes for error messages in range [C1801, C2000] --- docs/error-messages/compiler-errors-1/fatal-error-c1852.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1902.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1903.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1904.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1905.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1852.md b/docs/error-messages/compiler-errors-1/fatal-error-c1852.md index 9c42b79c0b2..6d3ec6c4976 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1852.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1852.md @@ -8,7 +8,7 @@ ms.assetid: fa011004-b8d6-46f1-ba80-4785e4ce137f --- # Fatal Error C1852 -'filename' is not a valid precompiled header file +> 'filename' is not a valid precompiled header file The file is not a precompiled header. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1902.md b/docs/error-messages/compiler-errors-1/fatal-error-c1902.md index 8bde156cbf2..4e11ad8af5b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1902.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1902.md @@ -8,7 +8,7 @@ ms.assetid: 2dc066cc-fcb1-4725-8bcb-9f44dd0905b7 --- # Fatal Error C1902 -program database manager mismatch; please check your installation +> program database manager mismatch; please check your installation A program database file (.pdb) was created using a newer version of mspdb*XXX*.dll than the one the compiler found on your system. This error usually indicates that mspdbsrv.exe or mspdbcore.dll are missing or have different versions than mspdb*XXX*.dll. (The *XXX* placeholder in the mspdb*XXX*.dll file name changes with each product release. For example, in Visual Studio 2015, the file name is mspdb140.dll.) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1903.md b/docs/error-messages/compiler-errors-1/fatal-error-c1903.md index 1f818efeaf3..a7b25245af1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1903.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1903.md @@ -8,6 +8,6 @@ ms.assetid: 4b4719d6-35d2-4ca5-81ce-903ecd28dfb9 --- # Fatal Error C1903 -unable to recover from previous error(s); stopping compilation +> unable to recover from previous error(s); stopping compilation The compiler found too many errors to continue. Fix the errors and recompile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1904.md b/docs/error-messages/compiler-errors-1/fatal-error-c1904.md index a3443127d98..fb19550eaf8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1904.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1904.md @@ -8,7 +8,7 @@ ms.assetid: 10f66015-146f-41a7-8011-327b29dedec8 --- # Fatal Error C1904 -bad provider interaction: 'file' +> bad provider interaction: 'file' This error indicates the failure of an attribute provider. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1905.md b/docs/error-messages/compiler-errors-1/fatal-error-c1905.md index 69b567fcd5f..48c786e8aad 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1905.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1905.md @@ -8,7 +8,7 @@ ms.assetid: fefc6769-477f-45a2-9878-6f0a5f42472c --- # Fatal Error C1905 -Front end and back end not compatible (must target same processor) +> Front end and back end not compatible (must target same processor) This error occurs when a .obj file is generated by a compiler front end (C1.dll) that targets one processor, such as x86, ARM, or x64, but is being read by a back end (C2.dll) that targets a different processor. From 14c280db24d3a205cfbaa6e5346facef1558894d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 8 Jul 2025 22:46:58 +0800 Subject: [PATCH 0311/1799] Add "Remarks" heading for error references in range [C1801, C2000] --- docs/error-messages/compiler-errors-1/fatal-error-c1852.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1853.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1854.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1900.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1902.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1903.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1904.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1905.md | 2 ++ 8 files changed, 16 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1852.md b/docs/error-messages/compiler-errors-1/fatal-error-c1852.md index 6d3ec6c4976..1b1530bcccc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1852.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1852.md @@ -10,6 +10,8 @@ ms.assetid: fa011004-b8d6-46f1-ba80-4785e4ce137f > 'filename' is not a valid precompiled header file +## Remarks + The file is not a precompiled header. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1853.md b/docs/error-messages/compiler-errors-1/fatal-error-c1853.md index 1b77c8c0bbb..f6088884f71 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1853.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1853.md @@ -10,6 +10,8 @@ ms.assetid: ceb9b4a5-92bf-4573-8a9f-3109cc7743ce > '*filename*' precompiled header file is from a previous version of the compiler, or the precompiled header is C++ and you are using it from C (or vice versa) +## Remarks + Possible causes: - The precompiled header was compiled with a previous compiler version. Try recompiling the header with the current compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1854.md b/docs/error-messages/compiler-errors-1/fatal-error-c1854.md index 6280c869d44..035143595d9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1854.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1854.md @@ -10,6 +10,8 @@ ms.assetid: 8c21a9cc-1737-475c-9e57-8725cd8937c1 > cannot overwrite information formed during creation of the precompiled header in object file: '*filename*' +## Remarks + You specified the [/Yu (Use Precompiled Header File)](../../build/reference/yu-use-precompiled-header-file.md) option after specifying the [/Yc (Create Precompiled Header File)](../../build/reference/yc-create-precompiled-header-file.md) option for the same file. To fix this issue, in general, set only one file in your project to be compiled by using the **/Yc** option, and set all other files to compile by using the **/Yu** option. For details on the use of the **/Yc** option, and how to set it in the Visual Studio IDE, see [/Yc (Create Precompiled Header File)](../../build/reference/yc-create-precompiled-header-file.md). For more information on using precompiled headers, see [Creating Precompiled Header Files](../../build/creating-precompiled-header-files.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1900.md b/docs/error-messages/compiler-errors-1/fatal-error-c1900.md index 5634a9b78bd..8f38bdcc940 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1900.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1900.md @@ -10,6 +10,8 @@ ms.assetid: 3aaa583b-4c1a-45de-aa34-527d806f2cb5 > Il mismatch between '*tool1*' version '*number1*' and '*tool2*' version '*number2*' +## Remarks + Tools run in various passes of the compiler do not match. *number1* and *number2* refer to the dates on the files. For example, in pass 1, the compiler front end runs (c1.dll) and in pass 2, the compiler back end runs (c2.dll). The dates on the files must match. To fix this issue, make sure that all updates have been applied to Visual Studio. If the problem persists, use **Programs and Features** in the Windows Control Panel to repair or reinstall Visual Studio. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1902.md b/docs/error-messages/compiler-errors-1/fatal-error-c1902.md index 4e11ad8af5b..3a9cb74a504 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1902.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1902.md @@ -10,6 +10,8 @@ ms.assetid: 2dc066cc-fcb1-4725-8bcb-9f44dd0905b7 > program database manager mismatch; please check your installation +## Remarks + A program database file (.pdb) was created using a newer version of mspdb*XXX*.dll than the one the compiler found on your system. This error usually indicates that mspdbsrv.exe or mspdbcore.dll are missing or have different versions than mspdb*XXX*.dll. (The *XXX* placeholder in the mspdb*XXX*.dll file name changes with each product release. For example, in Visual Studio 2015, the file name is mspdb140.dll.) Ensure matching versions of mspdbsrv.exe, mspdbcore.dll, and mspdb*XXX*.dll are installed on your system. Ensure that mismatched versions have not been copied to the directory that contains the compiler and link tools for your target platform. For example, you might have copied the files so you could invoke the compiler or link tool from the command prompt without setting the **PATH** environment variable accordingly. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1903.md b/docs/error-messages/compiler-errors-1/fatal-error-c1903.md index a7b25245af1..66e71101c0c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1903.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1903.md @@ -10,4 +10,6 @@ ms.assetid: 4b4719d6-35d2-4ca5-81ce-903ecd28dfb9 > unable to recover from previous error(s); stopping compilation +## Remarks + The compiler found too many errors to continue. Fix the errors and recompile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1904.md b/docs/error-messages/compiler-errors-1/fatal-error-c1904.md index fb19550eaf8..2a3b33c768b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1904.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1904.md @@ -10,6 +10,8 @@ ms.assetid: 10f66015-146f-41a7-8011-327b29dedec8 > bad provider interaction: 'file' +## Remarks + This error indicates the failure of an attribute provider. Note the circumstances of the error, try to isolate the problem and create a reproducible test case, then contact [Talk to Us](/visualstudio/ide/talk-to-us). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1905.md b/docs/error-messages/compiler-errors-1/fatal-error-c1905.md index 48c786e8aad..836076b1d3c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1905.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1905.md @@ -10,6 +10,8 @@ ms.assetid: fefc6769-477f-45a2-9878-6f0a5f42472c > Front end and back end not compatible (must target same processor) +## Remarks + This error occurs when a .obj file is generated by a compiler front end (C1.dll) that targets one processor, such as x86, ARM, or x64, but is being read by a back end (C2.dll) that targets a different processor. To fix this issue, ensure that you are using a matching front end and back end. This is the default for projects created in Visual Studio. This error may occur if you have edited the project file and used different paths to the compiler tools. If you have not specifically set the path for the compiler tools, then this error may occur if your Visual Studio installation is corrupt. For example, you may have copied the compiler .dll files from one location to another. Use **Programs and Features** in the Windows Control Panel to repair or reinstall Visual Studio. From 41910e142eb73732e4d7eeea09f35700046fa985 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 8 Jul 2025 22:48:59 +0800 Subject: [PATCH 0312/1799] Update metadata for error references in range [C1801, C2000] --- docs/error-messages/compiler-errors-1/fatal-error-c1852.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1853.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1854.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1900.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1902.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1903.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1904.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1905.md | 5 ++--- 8 files changed, 16 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1852.md b/docs/error-messages/compiler-errors-1/fatal-error-c1852.md index 1b1530bcccc..06b8fd90e3b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1852.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1852.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1852" title: "Fatal Error C1852" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1852" +ms.date: 11/04/2016 f1_keywords: ["C1852"] helpviewer_keywords: ["C1852"] -ms.assetid: fa011004-b8d6-46f1-ba80-4785e4ce137f --- # Fatal Error C1852 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1853.md b/docs/error-messages/compiler-errors-1/fatal-error-c1853.md index f6088884f71..6ff6d7e1dd8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1853.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1853.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1853" title: "Fatal Error C1853" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1853" +ms.date: 11/04/2016 f1_keywords: ["C1853"] helpviewer_keywords: ["C1853"] -ms.assetid: ceb9b4a5-92bf-4573-8a9f-3109cc7743ce --- # Fatal Error C1853 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1854.md b/docs/error-messages/compiler-errors-1/fatal-error-c1854.md index 035143595d9..460413ed4c8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1854.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1854.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1854" title: "Fatal Error C1854" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1854" +ms.date: 11/04/2016 f1_keywords: ["C1854"] helpviewer_keywords: ["C1854"] -ms.assetid: 8c21a9cc-1737-475c-9e57-8725cd8937c1 --- # Fatal Error C1854 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1900.md b/docs/error-messages/compiler-errors-1/fatal-error-c1900.md index 8f38bdcc940..8d67b8fd8d5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1900.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1900.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1900" title: "Fatal Error C1900" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1900" +ms.date: 11/04/2016 f1_keywords: ["C1900"] helpviewer_keywords: ["C1900"] -ms.assetid: 3aaa583b-4c1a-45de-aa34-527d806f2cb5 --- # Fatal Error C1900 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1902.md b/docs/error-messages/compiler-errors-1/fatal-error-c1902.md index 3a9cb74a504..2433f0dc9dc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1902.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1902.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1902" title: "Fatal Error C1902" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1902" +ms.date: 11/04/2016 f1_keywords: ["C1902"] helpviewer_keywords: ["C1902"] -ms.assetid: 2dc066cc-fcb1-4725-8bcb-9f44dd0905b7 --- # Fatal Error C1902 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1903.md b/docs/error-messages/compiler-errors-1/fatal-error-c1903.md index 66e71101c0c..d7d3f8cc18b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1903.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1903.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1903" title: "Fatal Error C1903" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1903" +ms.date: 11/04/2016 f1_keywords: ["C1903"] helpviewer_keywords: ["C1903"] -ms.assetid: 4b4719d6-35d2-4ca5-81ce-903ecd28dfb9 --- # Fatal Error C1903 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1904.md b/docs/error-messages/compiler-errors-1/fatal-error-c1904.md index 2a3b33c768b..2fd23f23976 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1904.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1904.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1904" title: "Fatal Error C1904" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1904" +ms.date: 11/04/2016 f1_keywords: ["C1904"] helpviewer_keywords: ["C1904"] -ms.assetid: 10f66015-146f-41a7-8011-327b29dedec8 --- # Fatal Error C1904 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1905.md b/docs/error-messages/compiler-errors-1/fatal-error-c1905.md index 836076b1d3c..89b8a800a51 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1905.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1905.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1905" title: "Fatal Error C1905" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1905" +ms.date: 11/04/2016 f1_keywords: ["C1905"] helpviewer_keywords: ["C1905"] -ms.assetid: fefc6769-477f-45a2-9878-6f0a5f42472c --- # Fatal Error C1905 From 3c7ec94f992bbdfa72781e7c3cfdceb8b1b1e19b Mon Sep 17 00:00:00 2001 From: Mahmoud Saleh <12202790+MahmoudGSaleh@users.noreply.github.com> Date: Tue, 8 Jul 2025 15:21:12 -0700 Subject: [PATCH 0313/1799] Update latest-supported-vc-redist.md (#6001) * Update latest-supported-vc-redist.md * Update latest-supported-vc-redist.md --- docs/windows/latest-supported-vc-redist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 78692323aef..fdcd8646049 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -31,7 +31,7 @@ Unlike older versions of Visual Studio, which have infrequent redist updates, th ## Latest Microsoft Visual C++ Redistributable version -The latest version is `v14.44.35208.0` +The latest version is `v14.44.35211.0` Use the following links to download this version for each supported architecture: From 410df106f5dc1549344fdeec22ebe47a820e5083 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 16:36:03 +0800 Subject: [PATCH 0314/1799] Update old mentions of Win32 or x86 in "Set compiler and build properties" --- docs/build/working-with-project-properties.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/working-with-project-properties.md b/docs/build/working-with-project-properties.md index 7f6b508708b..3540aad87db 100644 --- a/docs/build/working-with-project-properties.md +++ b/docs/build/working-with-project-properties.md @@ -21,10 +21,10 @@ When you create a project, the system assigns values for various properties. The Some properties, such as the application name, apply to all build variations and target platforms, whether it's a debug or release build. But most properties are configuration-dependent. To generate the correct code, the compiler has to know both the specific platform the program runs on and which specific compiler options to use. So when you set a property, it's important to pay attention to which configuration and platform the new value should apply to. Should it apply only to Debug Win32 builds, or should it also apply to Debug ARM64 and Debug x64? For example, the **Optimization** property, by default, is set to **Maximize Speed (/O2)** in a Release configuration, but is disabled in the Debug configuration. -You can always see and change the configuration and platform a property value should apply to. The following illustration shows the property pages with the configuration and platform information controls at the top. When the **Optimization** property is set here, it only applies to Debug Win32 builds, the currently active configuration, as shown by the red arrows. +You can always see and change the configuration and platform a property value should apply to. The following illustration shows the property pages with the configuration and platform information controls at the top. When the **Optimization** property is set here, it only applies to Debug x64 builds, the currently active configuration, as shown by the red arrows. :::image type="complex" source="media/visual-c---property-pages-showing-active-configuration.png" alt-text="Screenshot of the Visual Studio Property Pages dialog."::: -The page is open to C/C++, Optimization. The Optimization setting is set to Disabled (/Od), which is called out. An arrow calls out the relationship between the Configuration setting in the project property page, which is set to Active(Debug), and the setting in the Solution configuration dropdown on the toolbar, which is set to Debug. Another arrow calls out the relationship between the Platform setting in the project property page, which is set to Active(Win32), and the setting in the Solutions platform dropdown on the toolbar, which is set to x86. +The page is open to C/C++, Optimization. The Optimization setting is set to Disabled (/Od), which is called out. An arrow calls out the relationship between the Configuration setting in the project property page, which is set to Active(Debug), and the setting in the Solution configuration dropdown on the toolbar, which is set to Debug. Another arrow calls out the relationship between the Platform setting in the project property page, which is set to Active(x64), and the setting in the Solutions platform dropdown on the toolbar, which is set to x64. :::image-end::: The following illustration shows the same project property page, but the configuration has been changed to Release. Note the different value for the Optimization property. Also note that the active configuration is still Debug. You can set properties for any configuration here; it doesn't have to be the active one. From 1d8816e0ac25841382238d372ae61c55e532d0b0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 17:18:42 +0800 Subject: [PATCH 0315/1799] Convert PGO errors and warnings list into a table --- .../profile-guided-optimization-errors-and-warnings.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md index d3eae644ae7..d81e0066bdc 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md @@ -13,12 +13,16 @@ This section is a reference to the errors generated by the Profile-Guided Optimi ## PGO errors -[Profile-Guided Optimization Error PG0165](../../error-messages/tool-errors/profile-guided-optimization-error-pg0165.md) +| Error | Message | +|--|--| +| [Profile-Guided Optimization Error PG0165](../../error-messages/tool-errors/profile-guided-optimization-error-pg0165.md) | Reading '*filename.pgd*' : '*message*'. | ## PGO warnings -[Profile-Guided Optimization Warning PG1039](../../error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md) \ -[Profile-Guided Optimization Warning PG1087](../../error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md) +| Warning | Message | +|--|--| +| [Profile-Guided Optimization Warning PG1039](../../error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md) | Failed waiting for quiet time to sweep. | +| [Profile-Guided Optimization Warning PG1087](../../error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md) | The PGC file 'file' is not valid. | ## See also From ed047b6e9c699e959ca79f81162bd89aaaa87e53 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 17:21:56 +0800 Subject: [PATCH 0316/1799] Simplify superfluous relative links in "Profile-Guided Optimization errors and warnings (PGxxxx)" --- .../profile-guided-optimization-errors-and-warnings.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md index d81e0066bdc..c8a62a2589c 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md @@ -9,20 +9,20 @@ ms.assetid: f67b1011-fb64-4df3-9356-d52c9423ff3f This section is a reference to the errors generated by the Profile-Guided Optimization (PGO) tools. PGO errors and warnings have the form PG*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## PGO errors | Error | Message | |--|--| -| [Profile-Guided Optimization Error PG0165](../../error-messages/tool-errors/profile-guided-optimization-error-pg0165.md) | Reading '*filename.pgd*' : '*message*'. | +| [Profile-Guided Optimization Error PG0165](profile-guided-optimization-error-pg0165.md) | Reading '*filename.pgd*' : '*message*'. | ## PGO warnings | Warning | Message | |--|--| -| [Profile-Guided Optimization Warning PG1039](../../error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md) | Failed waiting for quiet time to sweep. | -| [Profile-Guided Optimization Warning PG1087](../../error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md) | The PGC file 'file' is not valid. | +| [Profile-Guided Optimization Warning PG1039](profile-guided-optimization-warning-pg1039.md) | Failed waiting for quiet time to sweep. | +| [Profile-Guided Optimization Warning PG1087](profile-guided-optimization-warning-pg1087.md) | The PGC file 'file' is not valid. | ## See also From 8106c4cac153a04f2ea7564a5b22b8ea4d9b6fd5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 17:23:03 +0800 Subject: [PATCH 0317/1799] Remove space before escape in "Profile-Guided Optimization errors and warnings (PGxxxx)" --- .../profile-guided-optimization-errors-and-warnings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md index c8a62a2589c..a014205741d 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md @@ -26,5 +26,5 @@ This section is a reference to the errors generated by the Profile-Guided Optimi ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [Profile-Guided Optimizations](../../build/profile-guided-optimizations.md) From 40dc62cff8a6f37c0fbc87184d54c92df34952d3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 17:23:41 +0800 Subject: [PATCH 0318/1799] Update metadata in "Profile-Guided Optimization errors and warnings (PGxxxx)" --- .../profile-guided-optimization-errors-and-warnings.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md index a014205741d..9afd0a1d993 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Profile-Guided Optimization errors and warnings (PGxxxx)" title: "Profile-Guided Optimization errors and warnings" -ms.date: "04/17/2019" +description: "Learn more about: Profile-Guided Optimization errors and warnings (PGxxxx)" +ms.date: 04/17/2019 f1_keywords: ["PG0001", "PG0002", "PG0003", "PG0061", "PG0062", "PG0063", "PG0065", "PG0066", "PG0067", "PG0068", "PG0069", "PG0070", "PG0071", "PG0081", "PG0087", "PG0090", "PG0091", "PG0092", "PG0094", "PG0096", "PG0168", "PG0169", "PG0181", "PG0188", "PG1000", "PG1001", "PG1032", "PG1033", "PG1035", "PG1036", "PG1038", "PG1051", "PG1052", "PG1053", "PG1056", "PG1058", "PG1060", "PG1061", "PG1065", "PG1066", "PG1067"] -ms.assetid: f67b1011-fb64-4df3-9356-d52c9423ff3f --- # Profile-Guided Optimization errors and warnings (PGxxxx) From 6314133de76f2298c7cb602e9d1bfdacf0f5be7d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 17:56:38 +0800 Subject: [PATCH 0319/1799] Fix missing `class` keyword for template parameters in `` operators reference --- docs/standard-library/array-operators.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/standard-library/array-operators.md b/docs/standard-library/array-operators.md index 1e076cf5500..64b0e538b99 100644 --- a/docs/standard-library/array-operators.md +++ b/docs/standard-library/array-operators.md @@ -13,7 +13,7 @@ The `` header includes these **array** non-member comparison template fun Array comparison, not equal. ```cpp -template +template bool operator!=( const array& left, const array& right); @@ -86,7 +86,7 @@ true Array comparison, less than. ```cpp -template +template bool operator<( const array& left, const array& right); @@ -159,7 +159,7 @@ true Array comparison, less than or equal. ```cpp -template +template bool operator<=( const array& left, const array& right); @@ -232,7 +232,7 @@ false Array comparison, equal. ```cpp -template +template bool operator==( const array& left, const array& right); @@ -305,7 +305,7 @@ false Array comparison, greater than. ```cpp -template +template bool operator>( const array& left, const array& right); @@ -378,7 +378,7 @@ true Array comparison, greater than or equal. ```cpp -template +template bool operator>=( const array& left, const array& right); From 55a4444bc5078da4c9e19372984f434b4412af8e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 18:56:11 +0800 Subject: [PATCH 0320/1799] Add properties and options in "C/C++ Property Pages" topic --- docs/build/reference/c-cpp-prop-page.md | 48 ++++++++++++++++++++++++- 1 file changed, 47 insertions(+), 1 deletion(-) diff --git a/docs/build/reference/c-cpp-prop-page.md b/docs/build/reference/c-cpp-prop-page.md index 4f92e38d17f..39752e27012 100644 --- a/docs/build/reference/c-cpp-prop-page.md +++ b/docs/build/reference/c-cpp-prop-page.md @@ -56,6 +56,10 @@ Specifies the type of debugging information generated by the compiler. This pro Adds supporting code for enabling [Just My Code](/visualstudio/debugger/just-my-code) debugging in this compilation unit. Sets [`/JMC`](jmc.md). +### Support C++ Dynamic Debugging + +(Preview) Sets compiler flag [`/dynamicdeopt`](dynamic-deopt.md) to turn on [C++ Dynamic Debugging](/visualstudio/debugger/cpp-dynamic-debugging). Place deoptimized breakpoints and step in anywhere with on-demand function deoptimization. Use this mode for debugging optimized code. + ### Common Language RunTime Support Use the .NET runtime service. This switch is incompatible with some other switches; see the documentation on the [`/clr`](clr-common-language-runtime-compilation.md) family of switches for details. @@ -118,6 +122,10 @@ Enable multi-processor compilation. Sets the [`/MP`](mp-build-with-multiple-proc Compiles and links the program with AddressSanitizer instrumentation. This property currently supports x86 and x64 target builds. Sets the [`/fsanitize`](fsanitize.md) compiler option. +### Enable Fuzzer Support (Experimental) + +Compiles programs with the Fuzzer. Enable AddressSanitizer for best results. Currently available for x86 and x64 builds. Sets [`/fsanitize=fuzzer`](fsanitize.md). + ## C/C++ Optimization Properties ### Optimization @@ -199,6 +207,10 @@ Preprocess without #line directives. Suppresses comment strip from source code; requires setting at least one of the **Preprocessing** options. Sets [`/C`](c-preserve-comments-during-preprocessing.md). +### Use Standard Conforming Preprocessor + +Use a standard conforming preprocessor ([`/Zc:preprocessor`](zc-preprocessor.md)). Currently implied by [`/std:c11`](std-specify-language-standard-version.md) and later versions. To use legacy preprocessor set this property to 'No'. + ## C/C++ Code Generation Properties ### Enable String Pooling @@ -298,6 +310,10 @@ Enable use of instructions found on processors that support enhanced instruction - **No Enhanced Instructions** - No Enhanced Instructions. Sets **`/arch:IA32`** - **Not Set** - Not Set. +### Enable Vector Length + +Enable choosing vector length for [`/arch:AVX512`](arch-x86.md) and [`/arch:AVX10.x`](arch-x86.md) flags. Allowed values are 256 and 512 bits (X86/X64). + ### Floating Point Model Sets the floating point model. Sets [`/fp:precise`, `/fp:strict`, `/fp:fast`](fp-specify-floating-point-behavior.md). @@ -325,6 +341,18 @@ Spectre mitigations for CVE 2017-5753. Sets [`/Qspectre`](qspectre.md). - **Enabled** - Enable Spectre mitigation feature for CVE 2017-5753 - **Disabled** - Not Set. +### Enable Intel JCC Erratum Mitigation + +Software mitigation for the performance impact caused by the Intel JCC erratum microcode update. Sets [`/QIntel-jcc-erratum`](qintel-jcc-erratum.md). + +### Enable EH Continuation Metadata + +Generates a sorted list of all the valid exception handling continuation targets for a binary, used during runtime for RIP validation. Currently available for x64 builds. Sets [`/guard:ehcont`](guard-enable-eh-continuation-metadata.md). + +### Enable Signed Returns + +Enables signed returns which help detect and prevent attempts to dispatch to illegal blocks from function returns. Currently available for ARM64 builds. Sets `/guard:signret`. + ## C/C++ Language Properties ### Disable Language Extensions @@ -365,7 +393,8 @@ Determines the C++ language standard that the compiler enables. The default valu - **ISO C++14 Standard (/std:c++14)** - **ISO C++17 Standard (/std:c++17)** - **ISO C++20 Standard (/std:c++20)** -- **Preview - Features from the Latest C++ Working Draft (/std:c++latest)** +- **Preview - ISO C++23 Standard (/std:c++23preview)** +- **Preview - Features from the Latest C++ Working Draft (/std:c++latest)** ### C Language Standard @@ -376,6 +405,7 @@ Determines the C language standard that the compiler enables. The default value - **Default (Legacy MSVC)** - **ISO C11 Standard (/std:c11)** - **ISO C17 (2018) Standard (/std:c17)** +- **Preview - Features from the Latest C Working Draft (/std:clatest)** ### Conformance mode @@ -435,6 +465,14 @@ Causes the output file to be created in UTF-8 format. Specifies relative path or name for ASM listing file; can be file or directory name. Sets [`/Fa`](fa-fa-listing-file.md). +### Module Output File Name + +Module or header unit output (BMI) file location; can be file or directory name. Sets [`/ifcOutput[name]`](ifc-output.md). + +### Module Dependencies File Name + +Specifies the path and/or name of the generated module dependencies file. Sets [`/scanDependencies[path]`](scandependencies.md). + ### Object File Name Specifies a name to override the default object file name; can be file or directory name. Sets [`/Fo`](fo-object-file-name.md). @@ -451,6 +489,14 @@ Specifies that the compiler should generate XML documentation comment files (.XD Specifies the name of the generated XML documentation files; can be file or directory name. Sets [`/doc:`\](doc-process-documentation-comments-c-cpp.md). +### Generate Source Dependencies File + +Generates a json file with the list of all files the compiler used for the compilation of the source. Sets [`/sourceDependencies`](sourcedependencies.md). + +### Source Dependencies File Name + +Specifies the path and/or name of the generated source dependencies file. Sets [`/sourceDependencies[path]`](sourcedependencies.md). + ## C/C++ Browse Information Properties ### Enable Browse Information From 134a4915a3c52dceb0ab95b16193844d39ffe53d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 18:59:46 +0800 Subject: [PATCH 0321/1799] Standardize level 2 headings in "C/C++ Property Pages" topic --- docs/build/reference/c-cpp-prop-page.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/c-cpp-prop-page.md b/docs/build/reference/c-cpp-prop-page.md index 39752e27012..fb40bf2a4aa 100644 --- a/docs/build/reference/c-cpp-prop-page.md +++ b/docs/build/reference/c-cpp-prop-page.md @@ -507,7 +507,7 @@ Specifies level of browse information in *`.bsc`* file. Sets [`/FR`](fr-fr-creat Specifies optional name for browser information file. Sets [`/FR`\](fr-fr-create-dot-sbr-file.md). -## External Includes +## C/C++ External Includes Properties ### Treat Files Included with Angle Brackets as External From 8e875c3e9839fc0cbb9e5c840cea02ee38cb9c7c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 19:08:03 +0800 Subject: [PATCH 0322/1799] Add "external-includes" anchor in "C/C++ Property Pages" topic --- docs/build/reference/c-cpp-prop-page.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/c-cpp-prop-page.md b/docs/build/reference/c-cpp-prop-page.md index fb40bf2a4aa..aaec4a7fab5 100644 --- a/docs/build/reference/c-cpp-prop-page.md +++ b/docs/build/reference/c-cpp-prop-page.md @@ -507,7 +507,7 @@ Specifies level of browse information in *`.bsc`* file. Sets [`/FR`](fr-fr-creat Specifies optional name for browser information file. Sets [`/FR`\](fr-fr-create-dot-sbr-file.md). -## C/C++ External Includes Properties +## C/C++ External Includes Properties ### Treat Files Included with Angle Brackets as External From 393bb587dad0e35c60290cd5456dd66c032ab6d3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 23:32:30 +0800 Subject: [PATCH 0323/1799] Add blockquotes for error messages in range [C2001, C2020] --- docs/error-messages/compiler-errors-1/compiler-error-c2001.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2002.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2003.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2004.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2005.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2006.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2007.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2008.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2009.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2010.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2011.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2012.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2013.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2014.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2015.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2017.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2019.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2020.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md index b72f3b033c9..74fa9812090 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md @@ -8,7 +8,7 @@ ms.assetid: 0c3a7821-d8e5-4398-ab5a-4116d46e8dda --- # Compiler Error C2001 -newline in constant +> newline in constant A string constant cannot be continued on a second line unless you do the following: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2002.md b/docs/error-messages/compiler-errors-1/compiler-error-c2002.md index 70d299ecd6b..9d5b4bab1e2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2002.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2002.md @@ -8,7 +8,7 @@ ms.assetid: 91982314-203a-4de1-b884-94e39a623f61 --- # Compiler Error C2002 -invalid wide-character constant +> invalid wide-character constant The multibyte-character constant is not valid. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2003.md b/docs/error-messages/compiler-errors-1/compiler-error-c2003.md index 61d4e32b6b6..bf66c41b685 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2003.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2003.md @@ -8,6 +8,6 @@ ms.assetid: 3161bc08-593d-4448-9fd3-4e3810be9e82 --- # Compiler Error C2003 -expected 'defined id' +> expected 'defined id' An identifier must follow the preprocessor keyword. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md index a17dba2cb45..bd325ed7443 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md @@ -8,7 +8,7 @@ ms.assetid: d81526dd-3a00-4593-87b0-d910d3d29bca --- # Compiler Error C2004 -expected 'defined(id)' +> expected 'defined(id)' An identifier must appear in the parentheses following the preprocessor keyword. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md index 01f56d8c3ff..6748153ffa4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md @@ -8,7 +8,7 @@ ms.assetid: 090530ed-e0ec-4358-833a-ca24260e7ffe --- # Compiler Error C2005 -\#line expected a line number, found 'token' +> #line expected a line number, found 'token' The `#line` directive must be followed by a line number. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md index 531f672d9b5..6255973d067 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2006"] --- # Compiler Error C2006 -'directive': expected "FILENAME" or \ +> 'directive': expected "FILENAME" or \ Directives such as [#include](../../preprocessor/hash-include-directive-c-cpp.md) or [#import](../../preprocessor/hash-import-directive-cpp.md) require a filename. To resolve the error, ensure the filename is valid and enclosed in either double quotes or angle brackets. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md index c34b64e7886..574454412f3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md @@ -8,7 +8,7 @@ ms.assetid: ecd09d99-5036-408b-9e46-bc15488f049e --- # Compiler Error C2007 -\#define syntax +> #define syntax No identifier appears after a `#define`. To resolve the error, use an identifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md index 3c0bc7b7c0d..c9a99310ae8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md @@ -8,7 +8,7 @@ ms.assetid: e748ccbe-ffd4-4008-aca7-e53c25225209 --- # Compiler Error C2008 -'character' : unexpected in macro definition +> 'character' : unexpected in macro definition The character appears immediately following the macro name. To resolve the error, there must be a space after the macro name. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md index fe06f1de781..17de5766f34 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md @@ -8,7 +8,7 @@ ms.assetid: fe9d94ed-20a5-4d83-b9c4-60ee69d2f30a --- # Compiler Error C2009 -reuse of macro formal 'identifier' +> reuse of macro formal 'identifier' The formal parameter list of a macro definition uses the identifier more than once. Identifiers in the macro's parameter list must be unique. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md index 0219901c98f..c63ab7acef9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md @@ -8,7 +8,7 @@ ms.assetid: 5795ed1d-e206-410b-b7b4-528d125c67b4 --- # Compiler Error C2010 -'character' : unexpected in macro formal parameter list +> 'character' : unexpected in macro formal parameter list The character is used incorrectly in the formal parameter list of a macro definition. Remove the character to resolve the error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md index f74c11a4a07..09e0b57c25d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md @@ -8,7 +8,7 @@ ms.assetid: 992c9d51-e850-4d53-b86b-02e73b38249c --- # Compiler Error C2011 -'identifier' : 'type' type redefinition +> 'identifier' : 'type' type redefinition The identifier was already defined as `type`. Check for redefinitions of the identifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md index e186eb5de56..cac7761409d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md @@ -8,7 +8,7 @@ ms.assetid: 9f0d8162-c0b3-4234-a41f-836fdb75c84e --- # Compiler Error C2012 -missing name following '<' +> missing name following '<' An `#include` directive lacks the required filename. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md index 88d193210e1..cc6d7b049ae 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md @@ -8,7 +8,7 @@ ms.assetid: 6b5c955c-53da-48ee-8533-64ef5b905173 --- # Compiler Error C2013 -missing '>' +> missing '>' An `#include` directive lacks a closing angle bracket. Add the closing bracket to resolve the error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md index b4369d49390..8fd3e652189 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md @@ -8,7 +8,7 @@ ms.assetid: 231d8e9c-48c0-4027-99a3-245d186275ec --- # Compiler Error C2014 -preprocessor command must start as first nonwhite space +> preprocessor command must start as first nonwhite space The `#` sign of a preprocessor directive must be the first character on a line that is not white space. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md index 7c3cb4ed8e3..6ee9936e9a3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md @@ -8,7 +8,7 @@ ms.assetid: 8f40af0a-3a5a-4d6a-8ed7-125966e6bfed --- # Compiler Error C2015 -too many characters in constant +> too many characters in constant A character constant contains more than two characters. The limit is one character for standard character constants and two characters for long character constants. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md index fc2705d40d0..10f3aa796a5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md @@ -8,7 +8,7 @@ ms.assetid: 1083eed9-9906-4a97-883c-54e52d7e82cd --- # Compiler Error C2017 -illegal escape sequence +> illegal escape sequence An escape sequence, such as \t, appears outside of a character or string constant. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md index 8353a05ae67..f19ae7e7a2a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md @@ -8,7 +8,7 @@ ms.assetid: 4f37b1e1-9eca-418f-a4c3-141e8512d7b6 --- # Compiler Error C2019 -expected preprocessor directive, found 'character' +> expected preprocessor directive, found 'character' The character followed a `#` sign but it is not the first letter of a preprocessor directive. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2020.md b/docs/error-messages/compiler-errors-1/compiler-error-c2020.md index 1d9ecbc4945..52d4296dbe6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2020.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2020.md @@ -8,6 +8,6 @@ ms.assetid: 486f98ed-6574-4d82-89e3-74b5a61ed419 --- # Compiler Error C2020 -'member' : 'class' member redefinition +> 'member' : 'class' member redefinition A member inherited from a base class or structure is redefined. Inherited members cannot be redefined unless declared as **`virtual`** in the base class. From 4d78744ba0a765cc3be72f7b5fc9a093ed03b21e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 23:39:45 +0800 Subject: [PATCH 0324/1799] Add "Remarks" and "Example" headings for error references in range [C2001, C2020] --- docs/error-messages/compiler-errors-1/compiler-error-c2001.md | 4 +++- docs/error-messages/compiler-errors-1/compiler-error-c2002.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2003.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2004.md | 4 +++- docs/error-messages/compiler-errors-1/compiler-error-c2005.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2006.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2007.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2008.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2009.md | 4 +++- docs/error-messages/compiler-errors-1/compiler-error-c2010.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2011.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2012.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2013.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2014.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2015.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2016.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2017.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2019.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2020.md | 2 ++ 19 files changed, 63 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md index 74fa9812090..acdb98b22cc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md @@ -10,6 +10,8 @@ ms.assetid: 0c3a7821-d8e5-4398-ab5a-4116d46e8dda > newline in constant +## Remarks + A string constant cannot be continued on a second line unless you do the following: - End the first line with a backslash. @@ -18,7 +20,7 @@ A string constant cannot be continued on a second line unless you do the followi Ending the first line with \n is not sufficient. -## Examples +## Example The following sample generates C2001: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2002.md b/docs/error-messages/compiler-errors-1/compiler-error-c2002.md index 9d5b4bab1e2..d58ae44f38e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2002.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2002.md @@ -10,6 +10,8 @@ ms.assetid: 91982314-203a-4de1-b884-94e39a623f61 > invalid wide-character constant +## Remarks + The multibyte-character constant is not valid. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2003.md b/docs/error-messages/compiler-errors-1/compiler-error-c2003.md index bf66c41b685..582b40a186b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2003.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2003.md @@ -10,4 +10,6 @@ ms.assetid: 3161bc08-593d-4448-9fd3-4e3810be9e82 > expected 'defined id' +## Remarks + An identifier must follow the preprocessor keyword. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md index bd325ed7443..da82e74afb5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md @@ -10,11 +10,13 @@ ms.assetid: d81526dd-3a00-4593-87b0-d910d3d29bca > expected 'defined(id)' +## Remarks + An identifier must appear in the parentheses following the preprocessor keyword. This error can also be generated as a result of compiler conformance work that was done for Visual Studio .NET 2003: missing parenthesis in preprocessor directive. If the closing parenthesis is missing from a preprocessor directive, the compiler will generate an error. -## Examples +## Example The following sample generates C2004: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md index 6748153ffa4..aa00df2be9f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md @@ -10,8 +10,12 @@ ms.assetid: 090530ed-e0ec-4358-833a-ca24260e7ffe > #line expected a line number, found 'token' +## Remarks + The `#line` directive must be followed by a line number. +## Example + The following sample generates C2005: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md index 6255973d067..c1c78ef3134 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2006"] > 'directive': expected "FILENAME" or \ +## Remarks + Directives such as [#include](../../preprocessor/hash-include-directive-c-cpp.md) or [#import](../../preprocessor/hash-import-directive-cpp.md) require a filename. To resolve the error, ensure the filename is valid and enclosed in either double quotes or angle brackets. +## Example + The following sample generates C2006: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md index 574454412f3..c20821cf1fd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md @@ -10,8 +10,12 @@ ms.assetid: ecd09d99-5036-408b-9e46-bc15488f049e > #define syntax +## Remarks + No identifier appears after a `#define`. To resolve the error, use an identifier. +## Example + The following sample generates C2007: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md index c9a99310ae8..5b7090ac75b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md @@ -10,8 +10,12 @@ ms.assetid: e748ccbe-ffd4-4008-aca7-e53c25225209 > 'character' : unexpected in macro definition +## Remarks + The character appears immediately following the macro name. To resolve the error, there must be a space after the macro name. +## Example + The following sample generates C2008: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md index 17de5766f34..97b4ab0c77b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md @@ -10,9 +10,11 @@ ms.assetid: fe9d94ed-20a5-4d83-b9c4-60ee69d2f30a > reuse of macro formal 'identifier' +## Remarks + The formal parameter list of a macro definition uses the identifier more than once. Identifiers in the macro's parameter list must be unique. -## Examples +## Example The following sample generates C2009: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md index c63ab7acef9..26ae659ff81 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md @@ -10,8 +10,12 @@ ms.assetid: 5795ed1d-e206-410b-b7b4-528d125c67b4 > 'character' : unexpected in macro formal parameter list +## Remarks + The character is used incorrectly in the formal parameter list of a macro definition. Remove the character to resolve the error. +## Example + The following sample generates C2010: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md index 09e0b57c25d..9e812f02fa9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md @@ -10,12 +10,16 @@ ms.assetid: 992c9d51-e850-4d53-b86b-02e73b38249c > 'identifier' : 'type' type redefinition +## Remarks + The identifier was already defined as `type`. Check for redefinitions of the identifier. You may also get C2011 if you import a header file or type library more than once into the same file. To prevent multiple inclusions of the types defined in a header file, use include guards or a `#pragma`[once](../../preprocessor/once.md) directive in the header file. If you need to find the initial declaration of the redefined type, you can use the [/P](../../build/reference/p-preprocess-to-a-file.md) compiler flag to generate the preprocessed output passed to the compiler. You can use text search tools to find instances of the redefined identifier in the output file. +## Example + The following sample generates C2011 and shows one way to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md index cac7761409d..2fb85e909af 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md @@ -10,8 +10,12 @@ ms.assetid: 9f0d8162-c0b3-4234-a41f-836fdb75c84e > missing name following '<' +## Remarks + An `#include` directive lacks the required filename. +## Example + The following sample generates C2012: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md index cc6d7b049ae..6974ab1ec84 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md @@ -10,8 +10,12 @@ ms.assetid: 6b5c955c-53da-48ee-8533-64ef5b905173 > missing '>' +## Remarks + An `#include` directive lacks a closing angle bracket. Add the closing bracket to resolve the error. +## Example + The following sample generates C2013: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md index 8fd3e652189..74ff045d77e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md @@ -10,8 +10,12 @@ ms.assetid: 231d8e9c-48c0-4027-99a3-245d186275ec > preprocessor command must start as first nonwhite space +## Remarks + The `#` sign of a preprocessor directive must be the first character on a line that is not white space. +## Example + The following sample generates C2014: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md index 6ee9936e9a3..6e565ab1ec5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md @@ -10,6 +10,8 @@ ms.assetid: 8f40af0a-3a5a-4d6a-8ed7-125966e6bfed > too many characters in constant +## Remarks + A character constant contains more than two characters. The limit is one character for standard character constants and two characters for long character constants. An escape sequence, such as \t, is converted to a single character. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2016.md b/docs/error-messages/compiler-errors-1/compiler-error-c2016.md index 8e6379635ae..c7f0ba98a8a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2016.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2016.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2016"] > C requires that a struct or union has at least one member +## Remarks + The compiler found a **`struct`** or **`union`** defined with no members, which isn't allowed in C. For more information, see [Structures](../../c-language/structure-declarations.md) and [Unions](../../c-language/union-declarations.md). To resolve this error, create at least one member in your **`struct`** or **`union`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md index 10f3aa796a5..75069dbc045 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md @@ -10,8 +10,12 @@ ms.assetid: 1083eed9-9906-4a97-883c-54e52d7e82cd > illegal escape sequence +## Remarks + An escape sequence, such as \t, appears outside of a character or string constant. +## Examples + The following sample generates C2017: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md index f19ae7e7a2a..6c4f7cf416b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md @@ -10,8 +10,12 @@ ms.assetid: 4f37b1e1-9eca-418f-a4c3-141e8512d7b6 > expected preprocessor directive, found 'character' +## Remarks + The character followed a `#` sign but it is not the first letter of a preprocessor directive. +## Example + The following sample generates C2019: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2020.md b/docs/error-messages/compiler-errors-1/compiler-error-c2020.md index 52d4296dbe6..c9173389b92 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2020.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2020.md @@ -10,4 +10,6 @@ ms.assetid: 486f98ed-6574-4d82-89e3-74b5a61ed419 > 'member' : 'class' member redefinition +## Remarks + A member inherited from a base class or structure is redefined. Inherited members cannot be redefined unless declared as **`virtual`** in the base class. From 329e1f9bff928eee39d720f5f1404a89451cc8cd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 23:42:40 +0800 Subject: [PATCH 0325/1799] Replace term "sample" with "example" for error references in range [C2001, C2020] --- docs/error-messages/compiler-errors-1/compiler-error-c2001.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2004.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2005.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2006.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2007.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2008.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2009.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2010.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2011.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2012.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2013.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2014.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2015.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2017.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2019.md | 2 +- 15 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md index acdb98b22cc..6b72ed1f568 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md @@ -22,7 +22,7 @@ Ending the first line with \n is not sufficient. ## Example -The following sample generates C2001: +The following example generates C2001: ```cpp // C2001.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md index da82e74afb5..6cc131ae272 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md @@ -18,7 +18,7 @@ This error can also be generated as a result of compiler conformance work that w ## Example -The following sample generates C2004: +The following example generates C2004: ```cpp // C2004.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md index aa00df2be9f..efa8ae031ba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md @@ -16,7 +16,7 @@ The `#line` directive must be followed by a line number. ## Example -The following sample generates C2005: +The following example generates C2005: ```cpp // C2005.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md index c1c78ef3134..0e85db670b5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md @@ -15,7 +15,7 @@ Directives such as [#include](../../preprocessor/hash-include-directive-c-cpp.md ## Example -The following sample generates C2006: +The following example generates C2006: ```cpp // C2006.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md index c20821cf1fd..29165b06f74 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md @@ -16,7 +16,7 @@ No identifier appears after a `#define`. To resolve the error, use an identifier ## Example -The following sample generates C2007: +The following example generates C2007: ```cpp // C2007.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md index 5b7090ac75b..bb1a41e1d22 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md @@ -16,7 +16,7 @@ The character appears immediately following the macro name. To resolve the error ## Example -The following sample generates C2008: +The following example generates C2008: ```cpp // C2008.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md index 97b4ab0c77b..397f76a5154 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md @@ -16,7 +16,7 @@ The formal parameter list of a macro definition uses the identifier more than on ## Example -The following sample generates C2009: +The following example generates C2009: ```cpp // C2009.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md index 26ae659ff81..a87b6c7c821 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md @@ -16,7 +16,7 @@ The character is used incorrectly in the formal parameter list of a macro defini ## Example -The following sample generates C2010: +The following example generates C2010: ```cpp // C2010.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md index 9e812f02fa9..acf80b007f9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md @@ -20,7 +20,7 @@ If you need to find the initial declaration of the redefined type, you can use t ## Example -The following sample generates C2011 and shows one way to fix it: +The following example generates C2011 and shows one way to fix it: ```cpp // C2011.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md index 2fb85e909af..99cac142bbb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md @@ -16,7 +16,7 @@ An `#include` directive lacks the required filename. ## Example -The following sample generates C2012: +The following example generates C2012: ```cpp // C2012.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md index 6974ab1ec84..2aef880122e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md @@ -16,7 +16,7 @@ An `#include` directive lacks a closing angle bracket. Add the closing bracket t ## Example -The following sample generates C2013: +The following example generates C2013: ```cpp // C2013.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md index 74ff045d77e..9c732c9a71b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md @@ -16,7 +16,7 @@ The `#` sign of a preprocessor directive must be the first character on a line t ## Example -The following sample generates C2014: +The following example generates C2014: ```cpp // C2014.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md index 6e565ab1ec5..d0d2b98769d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md @@ -18,7 +18,7 @@ An escape sequence, such as \t, is converted to a single character. ## Examples -The following sample generates C2015: +The following example generates C2015: ```cpp // C2015.cpp @@ -28,7 +28,7 @@ char test1 = 'error'; // C2015 char test2 = 'e'; // OK ``` -C2015 can also occur when using a Microsoft extension, character constants converted to integers. The following sample generates C2015: +C2015 can also occur when using a Microsoft extension, character constants converted to integers. The following example generates C2015: ```cpp // C2015b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md index 75069dbc045..053abcc1eb9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md @@ -16,7 +16,7 @@ An escape sequence, such as \t, appears outside of a character or string constan ## Examples -The following sample generates C2017: +The following example generates C2017: ```cpp // C2017.cpp @@ -28,7 +28,7 @@ int main() { C2017 can occur when the stringize operator is used with strings that include escape sequences. -The following sample generates C2017: +The following example generates C2017: ```cpp // C2017b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md index 6c4f7cf416b..b4007ee3732 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md @@ -16,7 +16,7 @@ The character followed a `#` sign but it is not the first letter of a preprocess ## Example -The following sample generates C2019: +The following example generates C2019: ```cpp // C2019.cpp From 272eae820363f82d09c355c5586e446cc8c89f38 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 9 Jul 2025 23:46:17 +0800 Subject: [PATCH 0326/1799] Update metadata for error references in range [C2001, C2020] --- .../error-messages/compiler-errors-1/compiler-error-c2001.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2002.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2003.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2004.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2005.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2006.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2007.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2008.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2009.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2010.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2011.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2012.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2013.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2014.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2015.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2016.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2017.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2019.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2020.md | 5 ++--- 19 files changed, 36 insertions(+), 53 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md index 6b72ed1f568..6f34a4fc3d2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2001" title: "Compiler Error C2001" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2001" +ms.date: 11/04/2016 f1_keywords: ["C2001"] helpviewer_keywords: ["C2001"] -ms.assetid: 0c3a7821-d8e5-4398-ab5a-4116d46e8dda --- # Compiler Error C2001 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2002.md b/docs/error-messages/compiler-errors-1/compiler-error-c2002.md index d58ae44f38e..418f0bc0552 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2002.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2002" title: "Compiler Error C2002" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2002" +ms.date: 11/04/2016 f1_keywords: ["C2002"] helpviewer_keywords: ["C2002"] -ms.assetid: 91982314-203a-4de1-b884-94e39a623f61 --- # Compiler Error C2002 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2003.md b/docs/error-messages/compiler-errors-1/compiler-error-c2003.md index 582b40a186b..2fbb8924306 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2003.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2003.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2003" title: "Compiler Error C2003" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2003" +ms.date: 11/04/2016 f1_keywords: ["C2003"] helpviewer_keywords: ["C2003"] -ms.assetid: 3161bc08-593d-4448-9fd3-4e3810be9e82 --- # Compiler Error C2003 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md index 6cc131ae272..18b687d027d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2004" title: "Compiler Error C2004" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2004" +ms.date: 11/04/2016 f1_keywords: ["C2004"] helpviewer_keywords: ["C2004"] -ms.assetid: d81526dd-3a00-4593-87b0-d910d3d29bca --- # Compiler Error C2004 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md index efa8ae031ba..d09db6738ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2005" title: "Compiler Error C2005" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2005" +ms.date: 11/04/2016 f1_keywords: ["C2005"] helpviewer_keywords: ["C2005"] -ms.assetid: 090530ed-e0ec-4358-833a-ca24260e7ffe --- # Compiler Error C2005 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md index 0e85db670b5..65c59918ffd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2006" description: "Learn more about: Compiler Error C2006" -ms.date: "01/28/2025" +ms.date: 01/28/2025 f1_keywords: ["C2006"] helpviewer_keywords: ["C2006"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md index 29165b06f74..e5831f153ad 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2007" title: "Compiler Error C2007" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2007" +ms.date: 11/04/2016 f1_keywords: ["C2007"] helpviewer_keywords: ["C2007"] -ms.assetid: ecd09d99-5036-408b-9e46-bc15488f049e --- # Compiler Error C2007 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md index bb1a41e1d22..56451a8c67f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2008" title: "Compiler Error C2008" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2008" +ms.date: 11/04/2016 f1_keywords: ["C2008"] helpviewer_keywords: ["C2008"] -ms.assetid: e748ccbe-ffd4-4008-aca7-e53c25225209 --- # Compiler Error C2008 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md index 397f76a5154..22d2909681a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2009" title: "Compiler Error C2009" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2009" +ms.date: 11/04/2016 f1_keywords: ["C2009"] helpviewer_keywords: ["C2009"] -ms.assetid: fe9d94ed-20a5-4d83-b9c4-60ee69d2f30a --- # Compiler Error C2009 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md index a87b6c7c821..2deeab992f0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2010" title: "Compiler Error C2010" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2010" +ms.date: 11/04/2016 f1_keywords: ["C2010"] helpviewer_keywords: ["C2010"] -ms.assetid: 5795ed1d-e206-410b-b7b4-528d125c67b4 --- # Compiler Error C2010 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md index acf80b007f9..57533da7f97 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2011" title: "Compiler Error C2011" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2011" +ms.date: 11/04/2016 f1_keywords: ["C2011"] helpviewer_keywords: ["C2011"] -ms.assetid: 992c9d51-e850-4d53-b86b-02e73b38249c --- # Compiler Error C2011 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md index 99cac142bbb..ef35628c054 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2012" title: "Compiler Error C2012" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2012" +ms.date: 11/04/2016 f1_keywords: ["C2012"] helpviewer_keywords: ["C2012"] -ms.assetid: 9f0d8162-c0b3-4234-a41f-836fdb75c84e --- # Compiler Error C2012 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md index 2aef880122e..eeca87ca533 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2013" title: "Compiler Error C2013" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2013" +ms.date: 11/04/2016 f1_keywords: ["C2013"] helpviewer_keywords: ["C2013"] -ms.assetid: 6b5c955c-53da-48ee-8533-64ef5b905173 --- # Compiler Error C2013 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md index 9c732c9a71b..32eb37bf33e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2014" title: "Compiler Error C2014" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2014" +ms.date: 11/04/2016 f1_keywords: ["C2014"] helpviewer_keywords: ["C2014"] -ms.assetid: 231d8e9c-48c0-4027-99a3-245d186275ec --- # Compiler Error C2014 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md index d0d2b98769d..060b5b60fbe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2015" title: "Compiler Error C2015" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2015" +ms.date: 11/04/2016 f1_keywords: ["C2015"] helpviewer_keywords: ["C2015"] -ms.assetid: 8f40af0a-3a5a-4d6a-8ed7-125966e6bfed --- # Compiler Error C2015 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2016.md b/docs/error-messages/compiler-errors-1/compiler-error-c2016.md index c7f0ba98a8a..563387c249a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2016.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2016.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2016" title: "Compiler Error C2016" +description: "Learn more about: Compiler Error C2016" ms.date: 08/18/2022 f1_keywords: ["C2016"] helpviewer_keywords: ["C2016"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md index 053abcc1eb9..d659ba2526b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2017" title: "Compiler Error C2017" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2017" +ms.date: 11/04/2016 f1_keywords: ["C2017"] helpviewer_keywords: ["C2017"] -ms.assetid: 1083eed9-9906-4a97-883c-54e52d7e82cd --- # Compiler Error C2017 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md index b4007ee3732..e835a042526 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2019" title: "Compiler Error C2019" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2019" +ms.date: 11/04/2016 f1_keywords: ["C2019"] helpviewer_keywords: ["C2019"] -ms.assetid: 4f37b1e1-9eca-418f-a4c3-141e8512d7b6 --- # Compiler Error C2019 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2020.md b/docs/error-messages/compiler-errors-1/compiler-error-c2020.md index c9173389b92..bc32e9e64ce 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2020.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2020.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2020" title: "Compiler Error C2020" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2020" +ms.date: 11/04/2016 f1_keywords: ["C2020"] helpviewer_keywords: ["C2020"] -ms.assetid: 486f98ed-6574-4d82-89e3-74b5a61ed419 --- # Compiler Error C2020 From b5f656e6aa5d46e82fbaea76f182049ad058e32a Mon Sep 17 00:00:00 2001 From: John Veness Date: Wed, 9 Jul 2025 22:41:43 +0100 Subject: [PATCH 0327/1799] Add missing bracket to modules-cpp.md It was accidentally removed in Commit 1b29af4. --- docs/cpp/modules-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/modules-cpp.md b/docs/cpp/modules-cpp.md index 309913a75b9..5e83b5eabd7 100644 --- a/docs/cpp/modules-cpp.md +++ b/docs/cpp/modules-cpp.md @@ -6,7 +6,7 @@ helpviewer_keywords: ["modules [C++]", "modules [C++], overview"] --- # Overview of modules in C++ -C++20 introduces *modules*. A *module* is a set of source code files that are compiled independently of the source files (or more precisely, the [translation units](https://wikipedia.org/wiki/Translation_unit_(programming)) that import them. +C++20 introduces *modules*. A *module* is a set of source code files that are compiled independently of the source files (or more precisely, the [translation units](https://wikipedia.org/wiki/Translation_unit_(programming)) that import them). Modules eliminate or reduce many of the problems associated with the use of header files. They often reduce compilation times, sometimes significantly. Macros, preprocessor directives, and nonexported names declared in a module aren't visible outside the module. They have no effect on the compilation of the translation unit that imports the module. You can import modules in any order without concern for macro redefinitions. Declarations in the importing translation unit don't participate in overload resolution or name lookup in the imported module. After a module is compiled once, the results are stored in a binary file that describes all the exported types, functions, and templates. The compiler can process that file much faster than a header file. And, the compiler can reuse it every place where the module is imported in a project. From e21eda34ace1ef2407f50ef447987b0ac5b4064c Mon Sep 17 00:00:00 2001 From: John Veness Date: Thu, 10 Jul 2025 10:04:30 +0100 Subject: [PATCH 0328/1799] Move bracket in modules-cpp.md This is the proper fix that I should have submitted in PR #5519 --- docs/cpp/modules-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/modules-cpp.md b/docs/cpp/modules-cpp.md index 5e83b5eabd7..333beca9b52 100644 --- a/docs/cpp/modules-cpp.md +++ b/docs/cpp/modules-cpp.md @@ -6,7 +6,7 @@ helpviewer_keywords: ["modules [C++]", "modules [C++], overview"] --- # Overview of modules in C++ -C++20 introduces *modules*. A *module* is a set of source code files that are compiled independently of the source files (or more precisely, the [translation units](https://wikipedia.org/wiki/Translation_unit_(programming)) that import them). +C++20 introduces *modules*. A *module* is a set of source code files that are compiled independently of the source files (or more precisely, the [translation units](https://wikipedia.org/wiki/Translation_unit_(programming))) that import them. Modules eliminate or reduce many of the problems associated with the use of header files. They often reduce compilation times, sometimes significantly. Macros, preprocessor directives, and nonexported names declared in a module aren't visible outside the module. They have no effect on the compilation of the translation unit that imports the module. You can import modules in any order without concern for macro redefinitions. Declarations in the importing translation unit don't participate in overload resolution or name lookup in the imported module. After a module is compiled once, the results are stored in a binary file that describes all the exported types, functions, and templates. The compiler can process that file much faster than a header file. And, the compiler can reuse it every place where the module is imported in a project. From bb46372061dbd7e1b1044ae1107bbc3d5cee0e3a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 10 Jul 2025 22:55:44 +0800 Subject: [PATCH 0329/1799] Remove more superfluous semicolons after function definition --- docs/atl/codesnippet/CPP/atl-collection-classes_1.cpp | 2 +- .../reference/get-purecall-handler-set-purecall-handler.md | 6 +++--- docs/code-quality/c28208.md | 4 ++-- docs/cpp/class-templates.md | 6 +++--- docs/cpp/decltype-cpp.md | 6 +++--- docs/cpp/explicit-specialization-of-function-templates.md | 2 +- docs/cpp/explicitly-defaulted-and-deleted-functions.md | 2 +- docs/cpp/initializers.md | 4 ++-- docs/cpp/safebuffers.md | 2 +- docs/cpp/selectany.md | 2 +- docs/cpp/single-inheritance.md | 2 +- docs/cppcx/platform-object-class.md | 2 +- docs/dotnet/double-thunking-cpp.md | 4 ++-- .../compiler-errors-1/compiler-error-c2246.md | 2 +- .../compiler-errors-1/compiler-error-c2249.md | 4 ++-- .../compiler-errors-1/compiler-error-c2254.md | 4 ++-- .../compiler-errors-2/compiler-error-c2614.md | 4 ++-- .../compiler-errors-2/compiler-error-c2664.md | 4 ++-- .../compiler-errors-2/compiler-error-c2724.md | 4 ++-- .../compiler-errors-2/compiler-error-c2758.md | 4 ++-- .../compiler-errors-2/compiler-error-c2765.md | 2 +- .../compiler-errors-2/compiler-error-c3068.md | 2 +- .../compiler-errors-2/compiler-error-c3771.md | 2 +- .../compiler-warnings/compiler-warning-c4355.md | 6 +++--- .../compiler-warnings/compiler-warning-level-1-c4183.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4353.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4722.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4747.md | 2 +- docs/error-messages/tool-errors/math-error-m6111.md | 2 +- docs/porting/visual-cpp-change-history-2003-2015.md | 2 +- docs/porting/visual-cpp-what-s-new-2003-through-2015.md | 2 +- 31 files changed, 48 insertions(+), 48 deletions(-) diff --git a/docs/atl/codesnippet/CPP/atl-collection-classes_1.cpp b/docs/atl/codesnippet/CPP/atl-collection-classes_1.cpp index 876ad2f58cf..baa1deb220f 100644 --- a/docs/atl/codesnippet/CPP/atl-collection-classes_1.cpp +++ b/docs/atl/codesnippet/CPP/atl-collection-classes_1.cpp @@ -29,7 +29,7 @@ class MyTraits : public CElementTraits< MyData > return true; else return false; - }; + } }; void DoAtlCustomTraitsList() diff --git a/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md b/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md index 4f491145310..1d4d0544be4 100644 --- a/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md +++ b/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md @@ -64,7 +64,7 @@ class CDerived; class CBase { public: - CBase(CDerived *derived): m_pDerived(derived) {}; + CBase(CDerived *derived): m_pDerived(derived) {} ~CBase(); virtual void function(void) = 0; @@ -74,8 +74,8 @@ public: class CDerived : public CBase { public: - CDerived() : CBase(this) {}; // C4355 - virtual void function(void) {}; + CDerived() : CBase(this) {} // C4355 + virtual void function(void) {} }; CBase::~CBase() diff --git a/docs/code-quality/c28208.md b/docs/code-quality/c28208.md index 1a9dc76e945..64ac68ee6b7 100644 --- a/docs/code-quality/c28208.md +++ b/docs/code-quality/c28208.md @@ -30,8 +30,8 @@ typedef void test_type(void*); #include "c28208_example.h" test_type my_test1; test_type my_test2; -void my_test1(int* x){}; // Generates C28208 -void my_test2(void* x){}; // Doesn't generate C28208 +void my_test1(int* x){} // Generates C28208 +void my_test2(void* x){} // Doesn't generate C28208 int main() { diff --git a/docs/cpp/class-templates.md b/docs/cpp/class-templates.md index 42bb8d25398..620e235ba26 100644 --- a/docs/cpp/class-templates.md +++ b/docs/cpp/class-templates.md @@ -28,15 +28,15 @@ public: template< class T, int i > MyStack< T, i >::MyStack( void ) { -}; +} template< class T, int i > void MyStack< T, i >::push( const T item ) { -}; +} template< class T, int i > T& MyStack< T, i >::pop( void ) { -}; +} int main() { diff --git a/docs/cpp/decltype-cpp.md b/docs/cpp/decltype-cpp.md index 2b387820ce7..994e99b8542 100644 --- a/docs/cpp/decltype-cpp.md +++ b/docs/cpp/decltype-cpp.md @@ -60,7 +60,7 @@ In C++11, you can use the **`decltype`** type specifier on a trailing return typ ```cpp template -UNKNOWN func(T&& t, U&& u){ return t + u; }; +UNKNOWN func(T&& t, U&& u){ return t + u; } ``` The introduction of the **`decltype`** type specifier enables a developer to obtain the type of the expression that the function template returns. Use the *alternative function declaration syntax* that is shown later, the **`auto`** keyword, and the **`decltype`** type specifier to declare a *late-specified* return type. The late-specified return type is determined when the declaration is compiled, instead of when it's coded. @@ -75,12 +75,12 @@ In the following code example, the late-specified return type of the `myFunc` fu //C++11 template auto myFunc(T&& t, U&& u) -> decltype (forward(t) + forward(u)) - { return forward(t) + forward(u); }; + { return forward(t) + forward(u); } //C++14 template decltype(auto) myFunc(T&& t, U&& u) - { return forward(t) + forward(u); }; + { return forward(t) + forward(u); } ``` ## `decltype` and forwarding functions (C++11) diff --git a/docs/cpp/explicit-specialization-of-function-templates.md b/docs/cpp/explicit-specialization-of-function-templates.md index 5842f4e767d..61ee0509129 100644 --- a/docs/cpp/explicit-specialization-of-function-templates.md +++ b/docs/cpp/explicit-specialization-of-function-templates.md @@ -21,7 +21,7 @@ This declaration enables you to define a different function for **`double`** var // explicit_specialization.cpp template void f(T t) { -}; +} // Explicit specialization of f with 'char' with the // template argument explicitly specified: diff --git a/docs/cpp/explicitly-defaulted-and-deleted-functions.md b/docs/cpp/explicitly-defaulted-and-deleted-functions.md index 13daddcfc36..1cd85d69229 100644 --- a/docs/cpp/explicitly-defaulted-and-deleted-functions.md +++ b/docs/cpp/explicitly-defaulted-and-deleted-functions.md @@ -44,7 +44,7 @@ These rules can complicate the implementation of what should be straight-forward ```cpp struct noncopyable { - noncopyable() {}; + noncopyable() {} private: noncopyable(const noncopyable&); diff --git a/docs/cpp/initializers.md b/docs/cpp/initializers.md index 48c7f624d1f..7ec241020c4 100644 --- a/docs/cpp/initializers.md +++ b/docs/cpp/initializers.md @@ -51,8 +51,8 @@ Initializers may take these forms: }; class PointConsumer{ public: - void set_point(Point p){}; - void set_points(initializer_list my_list){}; + void set_point(Point p){} + void set_points(initializer_list my_list){} }; int main() { PointConsumer pc{}; diff --git a/docs/cpp/safebuffers.md b/docs/cpp/safebuffers.md index 5d581c08ee5..1339225ab2d 100644 --- a/docs/cpp/safebuffers.md +++ b/docs/cpp/safebuffers.md @@ -50,7 +50,7 @@ static int checkBuffers() { BUFFER cb; // Use the buffer... return 0; -}; +} static __declspec(safebuffers) int noCheckBuffers() { BUFFER ncb; diff --git a/docs/cpp/selectany.md b/docs/cpp/selectany.md index 4369cd35eb0..b0099dda760 100644 --- a/docs/cpp/selectany.md +++ b/docs/cpp/selectany.md @@ -56,7 +56,7 @@ extern __declspec(selectany) int x5; // OK: dynamic initialization of global object class X { public: -X(int i){i++;}; +X(int i){i++;} int i; }; diff --git a/docs/cpp/single-inheritance.md b/docs/cpp/single-inheritance.md index 74c79169b4c..b7867e09fb3 100644 --- a/docs/cpp/single-inheritance.md +++ b/docs/cpp/single-inheritance.md @@ -74,7 +74,7 @@ Book::Book( char *name, long pagecount ) { Name = new char[ strlen( name ) + 1 ]; strcpy_s( Name, strlen(Name), name ); PageCount = pagecount; -}; +} ``` Note that the constructor for `Book`, (`Book::Book`), has access to the data member, `Name`. In a program, an object of type `Book` can be created and used as follows: diff --git a/docs/cppcx/platform-object-class.md b/docs/cppcx/platform-object-class.md index 3964399163d..fd7febf12ea 100644 --- a/docs/cppcx/platform-object-class.md +++ b/docs/cppcx/platform-object-class.md @@ -166,7 +166,7 @@ public: virtual Platform::String^ ToString() override { return "I'm a Tree"; - }; + } }; ``` diff --git a/docs/dotnet/double-thunking-cpp.md b/docs/dotnet/double-thunking-cpp.md index d634d7f17eb..d48853cab98 100644 --- a/docs/dotnet/double-thunking-cpp.md +++ b/docs/dotnet/double-thunking-cpp.md @@ -52,7 +52,7 @@ struct T { }; struct S { - virtual void /* __clrcall */ f(T t) {}; + virtual void /* __clrcall */ f(T t) {} } s; int main() { @@ -101,7 +101,7 @@ struct T { }; struct S { - virtual void /* __clrcall */ f(T t) {}; + virtual void /* __clrcall */ f(T t) {} } s; int main() { diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md index c2ebd50d80a..47401d0b082 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md @@ -20,5 +20,5 @@ The following sample generates C2246: void func( void ) { class A { static int i; }; // C2246 i is local to func static int j; // OK -}; +} ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md index 2b33cb4e285..0559f3adca3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md @@ -20,9 +20,9 @@ The following sample generates C2249. // C2249.cpp class A { private: - void privFunc( void ) {}; + void privFunc( void ) {} public: - void pubFunc( void ) {}; + void pubFunc( void ) {} }; class B : virtual public A {} b; diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md index 0f7436b72b5..0593537fedc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md @@ -24,6 +24,6 @@ public: friend void func3(); // OK, friend not virtual nor pure }; -void func1() {}; -void func3() {}; +void func1() {} +void func3() {} ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md index 7b3c6312ac8..ac2ecab7db7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md @@ -21,12 +21,12 @@ The following sample generates C2614. // compile with: /c struct A { int i; - A( int ia ) : B( i ) {}; // C2614 B is not a member of A + A( int ia ) : B( i ) {} // C2614 B is not a member of A }; struct A2 { int B; int i; - A2( int ia ) : B( i ) {}; // OK + A2( int ia ) : B( i ) {} // OK }; ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md index c7146ee907d..f43334ded45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md @@ -34,13 +34,13 @@ The following sample generates C2664 and shows how to fix it. // C2664.cpp // C2664 struct A { - void f(int i) {}; + void f(int i) {} }; struct B : public A { // To fix, uncomment the following line. // using A::f; - void f(A a) {}; + void f(A a) {} }; int main() { diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md index 534107c5007..8ef1d518ff6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md @@ -20,7 +20,7 @@ class C { static void func(); }; -static void C::func(){}; // C2724 +static void C::func(){} // C2724 // try the following line instead -// void C::func(){}; +// void C::func(){} ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md index ad5301bf1e3..06df930946c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md @@ -20,8 +20,8 @@ The following sample generates C2758: struct A { const int i; - A(int n) { }; // C2758 + A(int n) { } // C2758 // try the following line instead - // A(int n) : i{n} {}; + // A(int n) : i{n} {} }; ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md index e00d03d4855..c5207691bff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md @@ -16,7 +16,7 @@ The following sample generates C2765: ```cpp // C2765.cpp -template void f(T t) {}; +template void f(T t) {} template<> void f(char c = 'a') {} // C2765 // try the following line instead diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md index ef02c390227..78b36d90915 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md @@ -42,5 +42,5 @@ void b(A){} __declspec(naked) void c() { b(A()); // C3068 -}; +} ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md index 3daf52e4047..fadf4585ac8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md @@ -26,7 +26,7 @@ The following code example declares a class template and function in namespace ` namespace NA { template class A { - void aFunction(T t) {}; + void aFunction(T t) {} }; } // using namespace NA; diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md index f32d4d86f97..cb6d5b9eed1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md @@ -25,7 +25,7 @@ The following sample generates C4355: class CDerived; class CBase { public: - CBase(CDerived *derived): m_pDerived(derived) {}; + CBase(CDerived *derived): m_pDerived(derived) {} ~CBase(); virtual void function() = 0; @@ -34,8 +34,8 @@ public: class CDerived : public CBase { public: - CDerived() : CBase(this) {}; // C4355 "this" used in derived c'tor - virtual void function() {}; + CDerived() : CBase(this) {} // C4355 "this" used in derived c'tor + virtual void function() {} }; CBase::~CBase() { diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md index f6151e2d0f2..e1cb75e6757 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md @@ -20,6 +20,6 @@ The following sample generates C4183: #pragma warning(disable : 4430) class MyClass1; class MyClass2 { - MyClass1() {}; // C4183 + MyClass1() {} // C4183 }; ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md index afade9f92fb..9bb4c06fad4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md @@ -17,7 +17,7 @@ The following sample generates C4353: ```cpp // C4353.cpp // compile with: /W1 -void MyPrintf(void){}; +void MyPrintf(void){} #define X 0 #if X #define DBPRINT MyPrint diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md index 14ff9e25bdb..f8903f77b7b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md @@ -25,7 +25,7 @@ The following sample generates C4722: class C { public: C(); - ~C() { exit(1); }; // C4722 + ~C() { exit(1); } // C4722 }; extern void func (C*); diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md index 9b7dd217972..871c394eb00 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md @@ -35,5 +35,5 @@ The following sample generates C4747. BOOL WINAPI DllMain(HANDLE hInstance, ULONG Command, LPVOID Reserved) { return TRUE; -}; +} ``` diff --git a/docs/error-messages/tool-errors/math-error-m6111.md b/docs/error-messages/tool-errors/math-error-m6111.md index c007fdb395c..1c1196f7cdb 100644 --- a/docs/error-messages/tool-errors/math-error-m6111.md +++ b/docs/error-messages/tool-errors/math-error-m6111.md @@ -14,7 +14,7 @@ A floating-point operation resulted in a stack underflow on the 8087/287/387 cop This error is often caused by a call to a **`long double`** function that does not return a value. For example, the following generates this error when compiled and run: ```c -long double ld() {}; +long double ld() {} int main () { ld(); diff --git a/docs/porting/visual-cpp-change-history-2003-2015.md b/docs/porting/visual-cpp-change-history-2003-2015.md index cb872ffdf6a..456a327ecc7 100644 --- a/docs/porting/visual-cpp-change-history-2003-2015.md +++ b/docs/porting/visual-cpp-change-history-2003-2015.md @@ -1974,7 +1974,7 @@ Although these differences can affect your source code or other build artifacts, case settings::bit0 | settings::bit1: // warning C4063 break; } - }; + } ``` Example of C4063 (after) diff --git a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md index 9c2897d77ad..711377d790e 100644 --- a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md +++ b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md @@ -784,7 +784,7 @@ Although these differences can affect your source code or other build artifacts, case settings::bit0 | settings::bit1: // warning C4063 break; } - }; + } ``` Example of C4063 (after) From 4cea2824c35e4948841b37e4fb13a8bfacc8b39c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 10 Jul 2025 22:59:57 +0800 Subject: [PATCH 0330/1799] Update metadata for a bunch of topics --- .../reference/get-purecall-handler-set-purecall-handler.md | 5 ++--- docs/code-quality/c28208.md | 3 +-- docs/cpp/class-templates.md | 3 +-- docs/cpp/decltype-cpp.md | 2 +- docs/cpp/explicit-specialization-of-function-templates.md | 5 ++--- docs/cpp/explicitly-defaulted-and-deleted-functions.md | 4 ++-- docs/cpp/initializers.md | 2 +- docs/cpp/safebuffers.md | 5 ++--- docs/cpp/selectany.md | 5 ++--- docs/cpp/single-inheritance.md | 5 ++--- docs/cppcx/platform-object-class.md | 2 +- docs/dotnet/double-thunking-cpp.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2246.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2249.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2254.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2614.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2664.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2724.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2758.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2765.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3068.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3771.md | 5 ++--- .../compiler-warnings/compiler-warning-c4355.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4183.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4353.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4722.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4747.md | 5 ++--- 27 files changed, 49 insertions(+), 71 deletions(-) diff --git a/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md b/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md index 1d4d0544be4..22aa485c222 100644 --- a/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md +++ b/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _get_purecall_handler, _set_purecall_handler" title: "_get_purecall_handler, _set_purecall_handler" -ms.date: "1/14/2021" +description: "Learn more about: _get_purecall_handler, _set_purecall_handler" +ms.date: 1/14/2021 api_name: ["_set_purecall_handler", "_set_purecall_handler_m", "_get_purecall_handler"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_set_purecall_handler", "_set_purecall_handler_m", "set_purecall_handler_m", "set_purecall_handler", "stdlib/_set_purecall_handler", "stdlib/_get_purecall_handler", "_get_purecall_handler"] helpviewer_keywords: ["_set_purecall_handler function", "set_purecall_handler function", "purecall_handler", "set_purecall_handler_m function", "_purecall_handler", "_set_purecall_handler_m function", "_get_purecall_handler function"] -ms.assetid: 2759b878-8afa-4129-86e7-72afc2153d9c --- # `_get_purecall_handler`, `_set_purecall_handler` diff --git a/docs/code-quality/c28208.md b/docs/code-quality/c28208.md index 64ac68ee6b7..6d352f4247b 100644 --- a/docs/code-quality/c28208.md +++ b/docs/code-quality/c28208.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C28208" title: Warning C28208 +description: "Learn more about: Warning C28208" ms.date: 10/03/2022 f1_keywords: ["C28208", "FUNCTION_TYPE_REDECLARATION", "__WARNING_FUNCTION_TYPE_REDECLARATION"] helpviewer_keywords: ["C28208"] -ms.assetid: e9a8ce37-3b05-4202-b078-5570ae496d1d --- # Warning C28208 diff --git a/docs/cpp/class-templates.md b/docs/cpp/class-templates.md index 620e235ba26..4d0d7b7ce66 100644 --- a/docs/cpp/class-templates.md +++ b/docs/cpp/class-templates.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Class Templates" title: "Class Templates" +description: "Learn more about: Class Templates" ms.date: 06/30/2022 helpviewer_keywords: ["classes [C++], operating on type", "class templates", "templates, class templates"] -ms.assetid: 633a53c8-24ee-4c23-8c88-e7c3cb0b7ac3 --- # Class Templates diff --git a/docs/cpp/decltype-cpp.md b/docs/cpp/decltype-cpp.md index 994e99b8542..a223db3db59 100644 --- a/docs/cpp/decltype-cpp.md +++ b/docs/cpp/decltype-cpp.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: decltype (C++)" title: "decltype (C++)" +description: "Learn more about: decltype (C++)" ms.date: 09/14/2023 f1_keywords: ["decltype_cpp"] helpviewer_keywords: ["operators [C++], decltype", "decltype operator", "operators [C++], type of an expression", "operators [C++], deduce expression type"] diff --git a/docs/cpp/explicit-specialization-of-function-templates.md b/docs/cpp/explicit-specialization-of-function-templates.md index 61ee0509129..769315f1496 100644 --- a/docs/cpp/explicit-specialization-of-function-templates.md +++ b/docs/cpp/explicit-specialization-of-function-templates.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Explicit Specialization of Function Templates" title: "Explicit Specialization of Function Templates" -ms.date: "11/04/2016" +description: "Learn more about: Explicit Specialization of Function Templates" +ms.date: 11/04/2016 helpviewer_keywords: ["overriding, functions", "function templates, specialization", "explicit specialization of function templates", "declaring functions [C++], specialization of function template", "specialization of function templates"] -ms.assetid: eb0fcb73-eaed-42a1-9b83-14b055a34bf8 --- # Explicit Specialization of Function Templates diff --git a/docs/cpp/explicitly-defaulted-and-deleted-functions.md b/docs/cpp/explicitly-defaulted-and-deleted-functions.md index 1cd85d69229..78904c4e76c 100644 --- a/docs/cpp/explicitly-defaulted-and-deleted-functions.md +++ b/docs/cpp/explicitly-defaulted-and-deleted-functions.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Explicitly Defaulted and Deleted Functions" title: "Explicitly Defaulted and Deleted Functions" -ms.date: "11/04/2016" +description: "Learn more about: Explicitly Defaulted and Deleted Functions" +ms.date: 11/04/2016 --- # Explicitly Defaulted and Deleted Functions diff --git a/docs/cpp/initializers.md b/docs/cpp/initializers.md index 7ec241020c4..465e8537f7d 100644 --- a/docs/cpp/initializers.md +++ b/docs/cpp/initializers.md @@ -1,7 +1,7 @@ --- title: "Initializers" -ms.date: "07/29/2019" description: "How to initialize classes, structs, arrays and fundamental types in C++." +ms.date: 07/29/2019 helpviewer_keywords: ["arrays [C++], array-element initializers", "aggregate initializers [C++]"] --- # Initializers diff --git a/docs/cpp/safebuffers.md b/docs/cpp/safebuffers.md index 1339225ab2d..c813aa53e2b 100644 --- a/docs/cpp/safebuffers.md +++ b/docs/cpp/safebuffers.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: safebuffers" title: "safebuffers" -ms.date: "11/04/2016" +description: "Learn more about: safebuffers" +ms.date: 11/04/2016 f1_keywords: ["safebuffers_cpp"] helpviewer_keywords: ["__declspec keyword (C++), safebuffers", "safebuffers __declspec keyword"] -ms.assetid: 0b0dce14-4523-44d2-8070-5dd0fdabc618 --- # safebuffers diff --git a/docs/cpp/selectany.md b/docs/cpp/selectany.md index b0099dda760..73b773a2a0e 100644 --- a/docs/cpp/selectany.md +++ b/docs/cpp/selectany.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: `selectany`" title: "selectany" -ms.date: "11/04/2016" +description: "Learn more about: `selectany`" +ms.date: 11/04/2016 f1_keywords: ["selectany_cpp"] helpviewer_keywords: ["__declspec keyword [C++], selectany", "selectany __declspec keyword"] -ms.assetid: 9c353017-5a42-4f50-b741-bd13da1ce84d --- # `selectany` diff --git a/docs/cpp/single-inheritance.md b/docs/cpp/single-inheritance.md index b7867e09fb3..ccba5fd02c1 100644 --- a/docs/cpp/single-inheritance.md +++ b/docs/cpp/single-inheritance.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Single Inheritance" title: "Single Inheritance" -ms.date: "11/19/2018" +description: "Learn more about: Single Inheritance" +ms.date: 11/19/2018 helpviewer_keywords: ["single inheritance", "base classes [C++], indirect", "scope, scope resolution operator", "operators [C++], scope resolution", "scope resolution operator", "derived classes [C++], single base class", "inheritance, single"] -ms.assetid: 1cb946ed-8b1b-4cf1-bde0-d9cecbfdc622 --- # Single Inheritance diff --git a/docs/cppcx/platform-object-class.md b/docs/cppcx/platform-object-class.md index fd7febf12ea..a080235c9d0 100644 --- a/docs/cppcx/platform-object-class.md +++ b/docs/cppcx/platform-object-class.md @@ -1,7 +1,7 @@ --- title: "Platform::Object Class" description: "Learn more about: Platform::Object Class" -ms.date: "12/30/2016" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::Object::Object", "VCCORLIB/Platform::Object::Equals", "VCCORLIB/Platform::Object::GetHashCode", "VCCORLIB/Platform::Object::ReferenceEquals", "VCCORLIB/Platform::ToString", "VCCORLIB/Platform::GetType"] helpviewer_keywords: ["Object class"] diff --git a/docs/dotnet/double-thunking-cpp.md b/docs/dotnet/double-thunking-cpp.md index d48853cab98..345eb179e61 100644 --- a/docs/dotnet/double-thunking-cpp.md +++ b/docs/dotnet/double-thunking-cpp.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Double Thunking (C++)" title: "Double Thunking (C++)" -ms.date: "11/04/2016" +description: "Learn more about: Double Thunking (C++)" +ms.date: 11/04/2016 helpviewer_keywords: ["double thunks", "interop [C++], double thunking", "mixed assemblies [C++], double thunking", "/clr compiler option [C++], double thunking", "interoperability [C++], double thunking"] -ms.assetid: a85090b2-dc3c-498a-b40c-340db229dd6f ms.topic: how-to --- # Double Thunking (C++) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md index 47401d0b082..d709161bfce 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2246" title: "Compiler Error C2246" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2246" +ms.date: 11/04/2016 f1_keywords: ["C2246"] helpviewer_keywords: ["C2246"] -ms.assetid: 4f3e4f83-21f3-4256-af96-43e0bb060311 --- # Compiler Error C2246 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md index 0559f3adca3..a4034088e84 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2249" title: "Compiler Error C2249" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2249" +ms.date: 11/04/2016 f1_keywords: ["C2249"] helpviewer_keywords: ["C2249"] -ms.assetid: bdd6697c-e04b-49b9-8e40-d9eb6d74f2b6 --- # Compiler Error C2249 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md index 0593537fedc..537a84be711 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2254" title: "Compiler Error C2254" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2254" +ms.date: 11/04/2016 f1_keywords: ["C2254"] helpviewer_keywords: ["C2254"] -ms.assetid: 49bb3d7e-3bdf-4af6-937c-fa627be412a9 --- # Compiler Error C2254 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md index ac2ecab7db7..c8ef3814a7c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2614" title: "Compiler Error C2614" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2614" +ms.date: 11/04/2016 f1_keywords: ["C2614"] helpviewer_keywords: ["C2614"] -ms.assetid: a550c1d5-8718-4e17-a888-b2619e00fe11 --- # Compiler Error C2614 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md index f43334ded45..0c712df8206 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2664" title: "Compiler Error C2664" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2664" +ms.date: 11/04/2016 f1_keywords: ["C2664"] helpviewer_keywords: ["C2664"] -ms.assetid: 3595d66e-cf87-4fda-a896-c0cd81f95db4 --- # Compiler Error C2664 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md index 8ef1d518ff6..8860220e666 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2724" title: "Compiler Error C2724" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2724" +ms.date: 11/04/2016 f1_keywords: ["C2724"] helpviewer_keywords: ["C2724"] -ms.assetid: 4e4664bc-8c96-4156-b79f-03436f532ea8 --- # Compiler Error C2724 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md index 06df930946c..534c6219932 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2758" title: "Compiler Error C2758" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2758" +ms.date: 11/04/2016 f1_keywords: ["C2758"] helpviewer_keywords: ["C2758"] -ms.assetid: 1d273034-194c-4926-9869-142d1b219cbe --- # Compiler Error C2758 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md index c5207691bff..08850d76472 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2765" title: "Compiler Error C2765" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2765" +ms.date: 11/04/2016 f1_keywords: ["C2765"] helpviewer_keywords: ["C2765"] -ms.assetid: 47ad86f3-a7e0-47ad-85ff-0f5534458cb9 --- # Compiler Error C2765 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md index 78b36d90915..22e5e30c360 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3068" title: "Compiler Error C3068" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3068" +ms.date: 11/04/2016 f1_keywords: ["C3068"] helpviewer_keywords: ["C3068"] -ms.assetid: 613e3447-b4a8-4268-a661-297bed63ccdf --- # Compiler Error C3068 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md index fadf4585ac8..bdcf2c8966d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3771" title: "Compiler Error C3771" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3771" +ms.date: 11/04/2016 f1_keywords: ["C3771"] helpviewer_keywords: ["C3771"] -ms.assetid: 68c23b25-7f21-4eaa-8f7e-38fda1130a69 --- # Compiler Error C3771 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md index cb6d5b9eed1..57d328a58fe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4, off) C4355" title: "Compiler Warning (level 1 and level 4, off) C4355" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4, off) C4355" +ms.date: 11/04/2016 f1_keywords: ["C4355"] helpviewer_keywords: ["C4355"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md index e1cb75e6757..036ad1f925d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4183" title: "Compiler Warning (level 1) C4183" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4183" +ms.date: 11/04/2016 f1_keywords: ["C4183"] helpviewer_keywords: ["C4183"] -ms.assetid: dc48312c-4b34-44dd-80ff-eb5f11d5ca47 --- # Compiler Warning (level 1) C4183 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md index 9bb4c06fad4..3ca31ea006a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4353" title: "Compiler Warning (level 1) C4353" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4353" +ms.date: 11/04/2016 f1_keywords: ["C4353"] helpviewer_keywords: ["C4353"] -ms.assetid: 6e79f186-ed82-4c95-9923-0ad5bb9c4db1 --- # Compiler Warning (level 1) C4353 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md index f8903f77b7b..30659c1bb75 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4722" title: "Compiler Warning (level 1) C4722" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4722" +ms.date: 11/04/2016 f1_keywords: ["C4722"] helpviewer_keywords: ["C4722"] -ms.assetid: d8660710-f67b-4f59-a5fd-59259475529e --- # Compiler Warning (level 1) C4722 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md index 871c394eb00..4c6c42a9a48 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4747" title: "Compiler Warning (level 1) C4747" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4747" +ms.date: 11/04/2016 f1_keywords: ["C4747"] helpviewer_keywords: ["C4747"] -ms.assetid: af37befd-ba1f-4bdc-96e1-a953f7a2ad9c --- # Compiler Warning (level 1) C4747 From dce2a9e22c0b23f9538fcce1059423bc9503d915 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 10 Jul 2025 23:10:13 +0800 Subject: [PATCH 0331/1799] Add blockquotes for error messages in range [C2021, C2040] --- docs/error-messages/compiler-errors-1/compiler-error-c2021.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2022.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2027.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2028.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2030.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2032.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2033.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2034.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2036.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2039.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2040.md | 2 +- 11 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md index a32149660cb..8215ae68e02 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md @@ -8,7 +8,7 @@ ms.assetid: 064f32e2-3794-48d5-9767-991003dcb36a --- # Compiler Error C2021 -expected exponent value, not 'character' +> expected exponent value, not 'character' The character used as the exponent of a floating-point constant is not a valid number. Be sure to use an exponent that is in range. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2022.md b/docs/error-messages/compiler-errors-1/compiler-error-c2022.md index a072ce76c29..69978c853c5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2022.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2022.md @@ -8,6 +8,6 @@ ms.assetid: 1f5c477a-d909-42d8-8588-811586e8ba1e --- # Compiler Error C2022 -'number' : too big for character +> 'number' : too big for character The octal number following a backslash (\\) in a character or string constant is too big to represent a character. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md index d824942cd4c..ed2bac20196 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md @@ -8,7 +8,7 @@ ms.assetid: a39150c0-ec04-45ec-934c-a838bfe76627 --- # Compiler Error C2027 -use of undefined type 'type' +> use of undefined type 'type' A type cannot be used until it is defined. To resolve the error, be sure the type is fully defined before referencing it. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2028.md b/docs/error-messages/compiler-errors-1/compiler-error-c2028.md index dbf89a234a8..129f8162cb2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2028.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2028.md @@ -8,6 +8,6 @@ ms.assetid: 4e92e944-8fce-4443-9baf-4411ad9bde70 --- # Compiler Error C2028 -struct/union member must be inside a struct/union +> struct/union member must be inside a struct/union Structure or union members must be declared within the structure or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2030.md b/docs/error-messages/compiler-errors-1/compiler-error-c2030.md index 6f355444f85..6aeffc9323d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2030.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2030.md @@ -8,7 +8,7 @@ ms.assetid: 5806cead-64df-4eff-92de-52c9a3f5ee62 --- # Compiler Error C2030 -a destructor with 'protected private' accessibility cannot be a member of a class declared 'sealed' +> a destructor with 'protected private' accessibility cannot be a member of a class declared 'sealed' A Windows Runtime class declared as **`sealed`** cannot have a protected private destructor. Only public virtual and private non-virtual destructors are allowed on sealed types. For more information, see [Ref classes and structs](../../cppcx/ref-classes-and-structs-c-cx.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md index 973fedfa7ab..7e7a1a5bfd2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md @@ -8,7 +8,7 @@ ms.assetid: 625d7c83-70b6-42c2-a558-81fbc0026324 --- # Compiler Error C2032 -'identifier' : function cannot be member of struct/union 'structorunion' +> 'identifier' : function cannot be member of struct/union 'structorunion' The structure or union has a member function, which is allowed in C++ but not in C. To resolve the error, either compile as a C++ program or remove the member function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 767ad979198..0be5a8a8014 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -8,7 +8,7 @@ ms.assetid: fd5a1637-9db2-4c98-a7cc-b63b39737cd9 --- # Compiler Error C2033 -'identifier' : bit field cannot have indirection +> 'identifier' : bit field cannot have indirection The bit field was declared as a pointer, which is not allowed. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md index b512dc66b2b..d554fc72c4a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md @@ -8,7 +8,7 @@ ms.assetid: 953d70fa-bde9-4ce6-a55d-741e7bc63ff4 --- # Compiler Error C2034 -'identifier' : type of bit field too small for number of bits +> 'identifier' : type of bit field too small for number of bits The number of bits in the bit-field declaration exceeds the size of the base type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md index 92350e0b5b0..ef653dfdb8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md @@ -8,7 +8,7 @@ ms.assetid: 895821a9-65d1-44b5-bde1-dae827f3e486 --- # Compiler Error C2036 -'identifier' : unknown size +> 'identifier' : unknown size An operation on `identifier` requires the size of the data object, which cannot be determined. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md index 02647583595..92338f6e0fb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2039"] --- # Compiler Error C2039 -`'identifier1' : is not a member of 'identifier2'` +> 'identifier1' : is not a member of 'identifier2' The code incorrectly calls or refers to a member of a structure, class, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md index 76c71d13bbf..48964c6e74f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md @@ -8,7 +8,7 @@ ms.assetid: 74ca3592-1469-4965-ab34-a4815e2fbefe --- # Compiler Error C2040 -'operator' : 'identifier1' differs in levels of indirection from 'identifier2' +> 'operator' : 'identifier1' differs in levels of indirection from 'identifier2' An expression involving the specified operands has incompatible operand types or implicitly converted operand types. If both operands are arithmetic, or both are nonarithmetic (such as array or pointer), they are used without change. If one operand is arithmetic and the other is not, the arithmetic operand is converted to the type of the nonarithmetic operand. From e4a17e4b78a4c58eb9713b9917c56b528ee4b43c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 10 Jul 2025 23:18:29 +0800 Subject: [PATCH 0332/1799] Add "Remarks" and "Example" headings for error references in range [C2021, C2040] --- docs/error-messages/compiler-errors-1/compiler-error-c2021.md | 4 +++- docs/error-messages/compiler-errors-1/compiler-error-c2022.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2023.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2024.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2025.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2026.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2027.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2028.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2030.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2031.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2032.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2033.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2034.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2035.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2036.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2037.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2038.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2039.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2040.md | 4 ++++ 19 files changed, 51 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md index 8215ae68e02..3a66ddc86ae 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md @@ -10,9 +10,11 @@ ms.assetid: 064f32e2-3794-48d5-9767-991003dcb36a > expected exponent value, not 'character' +## Remarks + The character used as the exponent of a floating-point constant is not a valid number. Be sure to use an exponent that is in range. -## Examples +## Example The following sample generates C2021: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2022.md b/docs/error-messages/compiler-errors-1/compiler-error-c2022.md index 69978c853c5..010c37694d4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2022.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2022.md @@ -10,4 +10,6 @@ ms.assetid: 1f5c477a-d909-42d8-8588-811586e8ba1e > 'number' : too big for character +## Remarks + The octal number following a backslash (\\) in a character or string constant is too big to represent a character. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2023.md b/docs/error-messages/compiler-errors-1/compiler-error-c2023.md index ab9dba93d82..e6f92e9bf9d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2023.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2023.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C2023"] > '*identifier*': Alignment (*value-1*) different from prior declaration (*value-2*) +## Remarks + The compiler found an alignment specifier for a class type that's different from a previous declaration, or an **`enum`** alignment specifier that's different from the natural alignment of the base type. To resolve this error, make sure all declarations and definitions of the type use the same alignment value. +## Example + The following sample generates C2023: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2024.md b/docs/error-messages/compiler-errors-1/compiler-error-c2024.md index fe0b5e057f3..0216e0e8bbd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2024.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2024.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C2024"] > 'alignas' attribute applies to variables, data members and tag types only +## Remarks + The compiler found an **`alignas`** specifier applied to a function or other type that can't be aligned. To resolve this error, remove the **`alignas`** specifier. +## Example + The following sample generates C2024: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2025.md b/docs/error-messages/compiler-errors-1/compiler-error-c2025.md index 92c0e186ea0..58f76869348 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2025.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2025.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2025"] > invalid or corrupted binary module interface file: '*filename*' +## Remarks + The compiler could not read the specified IFC file. To resolve this error, rebuild the module interface file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2026.md b/docs/error-messages/compiler-errors-1/compiler-error-c2026.md index c04bbb7582e..f3b90cac609 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2026.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2026.md @@ -10,10 +10,10 @@ ms.assetid: 8e64b6e1-b967-479b-be97-d12dc4a8e389 > string too big, trailing characters truncated -The string was longer than the limit of 16380 single-byte characters. - ## Remarks +The string was longer than the limit of 16380 single-byte characters. + Before adjacent strings get concatenated, a string can't be longer than 16380 single-byte characters. A Unicode string of about one half this length would also generate this error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md index ed2bac20196..9ea1c390ba8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md @@ -10,6 +10,8 @@ ms.assetid: a39150c0-ec04-45ec-934c-a838bfe76627 > use of undefined type 'type' +## Remarks + A type cannot be used until it is defined. To resolve the error, be sure the type is fully defined before referencing it. ## Examples diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2028.md b/docs/error-messages/compiler-errors-1/compiler-error-c2028.md index 129f8162cb2..8e7648f4b55 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2028.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2028.md @@ -10,4 +10,6 @@ ms.assetid: 4e92e944-8fce-4443-9baf-4411ad9bde70 > struct/union member must be inside a struct/union +## Remarks + Structure or union members must be declared within the structure or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2030.md b/docs/error-messages/compiler-errors-1/compiler-error-c2030.md index 6aeffc9323d..ca2939fe3a2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2030.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2030.md @@ -10,6 +10,8 @@ ms.assetid: 5806cead-64df-4eff-92de-52c9a3f5ee62 > a destructor with 'protected private' accessibility cannot be a member of a class declared 'sealed' +## Remarks + A Windows Runtime class declared as **`sealed`** cannot have a protected private destructor. Only public virtual and private non-virtual destructors are allowed on sealed types. For more information, see [Ref classes and structs](../../cppcx/ref-classes-and-structs-c-cx.md). To fix this error, change the accessibility of the destructor. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2031.md b/docs/error-messages/compiler-errors-1/compiler-error-c2031.md index 737fec97896..67ff839282b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2031.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2031.md @@ -10,6 +10,8 @@ helpviewer_keywords: ["C2031"] > a virtual destructor with '*accessibility*' accessibility is not allowed for this type\ > a virtual destructor must have 'public' accessibility +## Remarks + A virtual Windows Runtime class has an access specifier or **`sealed`** specifier that's not allowed for a virtual destructor. For more information, see [Ref classes and structs](../../cppcx/ref-classes-and-structs-c-cx.md). To fix this error, change the accessibility of the destructor. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md index 7e7a1a5bfd2..071310c107a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md @@ -10,8 +10,12 @@ ms.assetid: 625d7c83-70b6-42c2-a558-81fbc0026324 > 'identifier' : function cannot be member of struct/union 'structorunion' +## Remarks + The structure or union has a member function, which is allowed in C++ but not in C. To resolve the error, either compile as a C++ program or remove the member function. +## Example + The following sample generates C2032: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 0be5a8a8014..714a3838e6c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -10,8 +10,12 @@ ms.assetid: fd5a1637-9db2-4c98-a7cc-b63b39737cd9 > 'identifier' : bit field cannot have indirection +## Remarks + The bit field was declared as a pointer, which is not allowed. +## Example + The following sample generates C2033: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md index d554fc72c4a..bacedaf3216 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md @@ -10,8 +10,12 @@ ms.assetid: 953d70fa-bde9-4ce6-a55d-741e7bc63ff4 > 'identifier' : type of bit field too small for number of bits +## Remarks + The number of bits in the bit-field declaration exceeds the size of the base type. +## Example + The following sample generates C2034: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2035.md b/docs/error-messages/compiler-errors-1/compiler-error-c2035.md index 3b2f4c6fa85..17fb87b0537 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2035.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2035.md @@ -10,6 +10,8 @@ helpviewer_keywords: ["C2035"] > a non-virtual destructor with '*accessibility*' accessibility is not allowed for this type\ > a non-virtual destructor must have 'protected private' or 'private' accessibility +## Remarks + A non-virtual Windows Runtime class has an access specifier or **`sealed`** specifier that's not allowed for a non-virtual destructor. For more information, see [Ref classes and structs](../../cppcx/ref-classes-and-structs-c-cx.md). To fix this error, change the accessibility of the destructor. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md index ef653dfdb8d..eded59bb205 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md @@ -10,6 +10,8 @@ ms.assetid: 895821a9-65d1-44b5-bde1-dae827f3e486 > 'identifier' : unknown size +## Remarks + An operation on `identifier` requires the size of the data object, which cannot be determined. ## Examples diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2037.md b/docs/error-messages/compiler-errors-1/compiler-error-c2037.md index ad11cf2dc6a..b7601400891 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2037.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2037.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2037"] > left of '*operator*' specifies undefined struct/union '*type*' +## Remarks + The operand to the left of the member-selection *operator* is not a fully defined class, structure, or union. This error can be caused by a left operand that is an undefined variable. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2038.md b/docs/error-messages/compiler-errors-1/compiler-error-c2038.md index 8e7ffa2aa0e..c961a73719d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2038.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2038.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2038"] > the std namespace cannot be inline +## Remarks + The C++ standard does not allow the `std` namespace to be declared `inline`. To resolve this issue, remove the `inline` specifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md index 92338f6e0fb..9e4fd29c229 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2039"] > 'identifier1' : is not a member of 'identifier2' +## Remarks + The code incorrectly calls or refers to a member of a structure, class, or union. ## Examples diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md index 48964c6e74f..1f89f9698bc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md @@ -10,8 +10,12 @@ ms.assetid: 74ca3592-1469-4965-ab34-a4815e2fbefe > 'operator' : 'identifier1' differs in levels of indirection from 'identifier2' +## Remarks + An expression involving the specified operands has incompatible operand types or implicitly converted operand types. If both operands are arithmetic, or both are nonarithmetic (such as array or pointer), they are used without change. If one operand is arithmetic and the other is not, the arithmetic operand is converted to the type of the nonarithmetic operand. +## Example + This sample generates C2040 and shows how to fix it. ```cpp From 1e0ae1e8b6c83d4b6a31fd0231fd7014742c1bbe Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 10 Jul 2025 23:20:10 +0800 Subject: [PATCH 0333/1799] Replace term "sample" with "example" for error references in range [C2021, C2040] --- .../compiler-errors-1/compiler-error-c2021.md | 2 +- .../compiler-errors-1/compiler-error-c2023.md | 2 +- .../compiler-errors-1/compiler-error-c2024.md | 2 +- .../compiler-errors-1/compiler-error-c2027.md | 4 ++-- .../compiler-errors-1/compiler-error-c2032.md | 2 +- .../compiler-errors-1/compiler-error-c2033.md | 2 +- .../compiler-errors-1/compiler-error-c2034.md | 2 +- .../compiler-errors-1/compiler-error-c2036.md | 4 ++-- .../compiler-errors-1/compiler-error-c2039.md | 12 ++++++------ .../compiler-errors-1/compiler-error-c2040.md | 2 +- 10 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md index 3a66ddc86ae..3f5635ee97d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md @@ -16,7 +16,7 @@ The character used as the exponent of a floating-point constant is not a valid n ## Example -The following sample generates C2021: +The following example generates C2021: ```cpp // C2021.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2023.md b/docs/error-messages/compiler-errors-1/compiler-error-c2023.md index e6f92e9bf9d..446fc82d006 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2023.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2023.md @@ -17,7 +17,7 @@ To resolve this error, make sure all declarations and definitions of the type us ## Example -The following sample generates C2023: +The following example generates C2023: ```cpp // C2023.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2024.md b/docs/error-messages/compiler-errors-1/compiler-error-c2024.md index 0216e0e8bbd..7507db60ab0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2024.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2024.md @@ -17,7 +17,7 @@ To resolve this error, remove the **`alignas`** specifier. ## Example -The following sample generates C2024: +The following example generates C2024: ```cpp // C2024.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md index 9ea1c390ba8..3887817842d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md @@ -16,7 +16,7 @@ A type cannot be used until it is defined. To resolve the error, be sure the typ ## Examples -The following sample generates C2027. +The following example generates C2027. ```cpp // C2027.cpp @@ -38,7 +38,7 @@ int main() { It is possible to declare a pointer to a declared but undefined type. But C++ does not allow a reference to an undefined type. -The following sample generates C2027. +The following example generates C2027. ```cpp // C2027_b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md index 071310c107a..0203e5d1e43 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md @@ -16,7 +16,7 @@ The structure or union has a member function, which is allowed in C++ but not in ## Example -The following sample generates C2032: +The following example generates C2032: ```c // C2032.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 714a3838e6c..1e1a62a545e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -16,7 +16,7 @@ The bit field was declared as a pointer, which is not allowed. ## Example -The following sample generates C2033: +The following example generates C2033: ```cpp // C2033.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md index bacedaf3216..1406034ad88 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md @@ -16,7 +16,7 @@ The number of bits in the bit-field declaration exceeds the size of the base typ ## Example -The following sample generates C2034: +The following example generates C2034: ```cpp // C2034.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md index eded59bb205..d6ee0ce4a0e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md @@ -16,7 +16,7 @@ An operation on `identifier` requires the size of the data object, which cannot ## Examples -The following sample generates C2036. +The following example generates C2036. ```c // C2036.c @@ -31,7 +31,7 @@ int main() { } ``` -The following sample generates C2036. +The following example generates C2036. ```cpp // C2036_2.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md index 9e4fd29c229..a92d1d46b2e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md @@ -15,7 +15,7 @@ The code incorrectly calls or refers to a member of a structure, class, or union ## Examples -The following sample generates C2039: +The following example generates C2039: ```cpp // C2039.cpp @@ -29,7 +29,7 @@ int main() { } ``` -The following sample generates C2039: +The following example generates C2039: ```cpp // C2039_b.cpp @@ -42,7 +42,7 @@ int main() { } ``` -The following sample generates C2039: +The following example generates C2039: ```cpp // C2039_c.cpp @@ -73,7 +73,7 @@ public class B { }; ``` -The following sample generates C2039 when it uses the previously defined C# component's default indexer incorrectly from C++/CLI: +The following example generates C2039 when it uses the previously defined C# component's default indexer incorrectly from C++/CLI: ```cpp // C2039_e.cpp @@ -90,7 +90,7 @@ int main() { } ``` -C2039 can also occur if you use generics. The following sample generates C2039: +C2039 can also occur if you use generics. The following example generates C2039: ```cpp // C2039_f.cpp @@ -115,7 +115,7 @@ int main() { C2039 can occur when you try to release managed or unmanaged resources. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). -The following sample generates C2039: +The following example generates C2039: ```cpp // C2039_g.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md index 1f89f9698bc..6b7082d4fde 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md @@ -16,7 +16,7 @@ An expression involving the specified operands has incompatible operand types or ## Example -This sample generates C2040 and shows how to fix it. +This example generates C2040 and shows how to fix it. ```cpp // C2040.cpp From 129b6d76490b5d834414e86d094505d2e79ff731 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 10 Jul 2025 23:23:10 +0800 Subject: [PATCH 0334/1799] Update metadata for error references in range [C2021, C2040] --- .../error-messages/compiler-errors-1/compiler-error-c2021.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2022.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2023.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2024.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2025.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2026.md | 1 - .../error-messages/compiler-errors-1/compiler-error-c2027.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2028.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2030.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2031.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2032.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2033.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2034.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2035.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2036.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2037.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2038.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2039.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2040.md | 5 ++--- 19 files changed, 29 insertions(+), 40 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md index 3f5635ee97d..e0a6ce1831a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2021" title: "Compiler Error C2021" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2021" +ms.date: 11/04/2016 f1_keywords: ["C2021"] helpviewer_keywords: ["C2021"] -ms.assetid: 064f32e2-3794-48d5-9767-991003dcb36a --- # Compiler Error C2021 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2022.md b/docs/error-messages/compiler-errors-1/compiler-error-c2022.md index 010c37694d4..619c126d667 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2022.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2022" title: "Compiler Error C2022" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2022" +ms.date: 11/04/2016 f1_keywords: ["C2022"] helpviewer_keywords: ["C2022"] -ms.assetid: 1f5c477a-d909-42d8-8588-811586e8ba1e --- # Compiler Error C2022 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2023.md b/docs/error-messages/compiler-errors-1/compiler-error-c2023.md index 446fc82d006..8ddc41ef919 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2023.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2023.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2023" title: "Compiler Error C2023" +description: "Learn more about: Compiler Error C2023" ms.date: 08/18/2022 f1_keywords: ["C2023"] helpviewer_keywords: ["C2023"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2024.md b/docs/error-messages/compiler-errors-1/compiler-error-c2024.md index 7507db60ab0..89965f73fe6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2024.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2024.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2024" title: "Compiler Error C2024" +description: "Learn more about: Compiler Error C2024" ms.date: 08/18/2022 f1_keywords: ["C2024"] helpviewer_keywords: ["C2024"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2025.md b/docs/error-messages/compiler-errors-1/compiler-error-c2025.md index 58f76869348..edd6d5218cd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2025.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2025.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2025" title: "Compiler Error C2025" +description: "Learn more about: Compiler Error C2025" ms.date: 08/18/2022 f1_keywords: ["C2025"] helpviewer_keywords: ["C2025"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2026.md b/docs/error-messages/compiler-errors-1/compiler-error-c2026.md index f3b90cac609..0ebf596eb09 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2026.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2026.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2026, its causes and how ms.date: 09/25/2020 f1_keywords: ["C2026"] helpviewer_keywords: ["C2026"] -ms.assetid: 8e64b6e1-b967-479b-be97-d12dc4a8e389 --- # Compiler Error C2026 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md index 3887817842d..b99589dda0a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2027" title: "Compiler Error C2027" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2027" +ms.date: 11/04/2016 f1_keywords: ["C2027"] helpviewer_keywords: ["C2027"] -ms.assetid: a39150c0-ec04-45ec-934c-a838bfe76627 --- # Compiler Error C2027 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2028.md b/docs/error-messages/compiler-errors-1/compiler-error-c2028.md index 8e7648f4b55..d7adba707ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2028.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2028.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2028" title: "Compiler Error C2028" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2028" +ms.date: 11/04/2016 f1_keywords: ["C2028"] helpviewer_keywords: ["C2028"] -ms.assetid: 4e92e944-8fce-4443-9baf-4411ad9bde70 --- # Compiler Error C2028 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2030.md b/docs/error-messages/compiler-errors-1/compiler-error-c2030.md index ca2939fe3a2..e13728eaddb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2030.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2030.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2030" title: "Compiler Error C2030" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2030" +ms.date: 11/04/2016 f1_keywords: ["C2030"] helpviewer_keywords: ["C2030"] -ms.assetid: 5806cead-64df-4eff-92de-52c9a3f5ee62 --- # Compiler Error C2030 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2031.md b/docs/error-messages/compiler-errors-1/compiler-error-c2031.md index 67ff839282b..f6ef1fa4815 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2031.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2031.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2031" title: "Compiler Error C2031" +description: "Learn more about: Compiler Error C2031" ms.date: 08/18/2022 f1_keywords: ["C2031"] helpviewer_keywords: ["C2031"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md index 0203e5d1e43..e2ed2b78c27 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2032" title: "Compiler Error C2032" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2032" +ms.date: 11/04/2016 f1_keywords: ["C2032"] helpviewer_keywords: ["C2032"] -ms.assetid: 625d7c83-70b6-42c2-a558-81fbc0026324 --- # Compiler Error C2032 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 1e1a62a545e..87aaa08b7b5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2033" title: "Compiler Error C2033" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2033" +ms.date: 11/04/2016 f1_keywords: ["C2033"] helpviewer_keywords: ["C2033"] -ms.assetid: fd5a1637-9db2-4c98-a7cc-b63b39737cd9 --- # Compiler Error C2033 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md index 1406034ad88..1f988de2b4c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2034" title: "Compiler Error C2034" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2034" +ms.date: 11/04/2016 f1_keywords: ["C2034"] helpviewer_keywords: ["C2034"] -ms.assetid: 953d70fa-bde9-4ce6-a55d-741e7bc63ff4 --- # Compiler Error C2034 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2035.md b/docs/error-messages/compiler-errors-1/compiler-error-c2035.md index 17fb87b0537..8b4e5fe38b5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2035.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2035.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2035" title: "Compiler Error C2035" +description: "Learn more about: Compiler Error C2035" ms.date: 08/18/2022 f1_keywords: ["C2035"] helpviewer_keywords: ["C2035"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md index d6ee0ce4a0e..10f675360e0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2036" title: "Compiler Error C2036" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2036" +ms.date: 11/04/2016 f1_keywords: ["C2036"] helpviewer_keywords: ["C2036"] -ms.assetid: 895821a9-65d1-44b5-bde1-dae827f3e486 --- # Compiler Error C2036 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2037.md b/docs/error-messages/compiler-errors-1/compiler-error-c2037.md index b7601400891..04fffc4ba7b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2037.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2037.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2037" title: "Compiler Error C2037" +description: "Learn more about: Compiler Error C2037" ms.date: 08/18/2022 f1_keywords: ["C2037"] helpviewer_keywords: ["C2037"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2038.md b/docs/error-messages/compiler-errors-1/compiler-error-c2038.md index c961a73719d..4de865e57cd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2038.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2038.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2038" title: "Compiler Error C2038" +description: "Learn more about: Compiler Error C2038" ms.date: 08/18/2022 f1_keywords: ["C2038"] helpviewer_keywords: ["C2038"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md index a92d1d46b2e..635d97226b9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2039" title: "Compiler Error C2039" -ms.date: "8/1/2023" +description: "Learn more about: Compiler Error C2039" +ms.date: 8/1/2023 f1_keywords: ["C2039"] helpviewer_keywords: ["C2039"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md index 6b7082d4fde..ba66506a83d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2040" title: "Compiler Error C2040" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2040" +ms.date: 11/04/2016 f1_keywords: ["C2040"] helpviewer_keywords: ["C2040"] -ms.assetid: 74ca3592-1469-4965-ab34-a4815e2fbefe --- # Compiler Error C2040 From 5fa546c94c78aa340127d29457d4593d57ff66bf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 16:51:18 +0800 Subject: [PATCH 0335/1799] Add properties in "Linker Property Pages" topic --- docs/build/reference/linker-property-pages.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/build/reference/linker-property-pages.md b/docs/build/reference/linker-property-pages.md index 27a8a52d11c..316eb3ed75d 100644 --- a/docs/build/reference/linker-property-pages.md +++ b/docs/build/reference/linker-property-pages.md @@ -37,6 +37,10 @@ The [`/VERSION`](version-version-information.md) option tells the linker to put Enables incremental linking. ([`/INCREMENTAL, /INCREMENTAL:NO`](incremental-link-incrementally.md)) +### Incremental Link Database File + +Specifies incremental link database file location. ([`/ILK:[name]`](ilk-name-incremental-database-file.md)) + ### Suppress Startup Banner The [`/NOLOGO`](nologo-suppress-startup-banner-linker.md) option prevents display of the copyright message and version number. @@ -223,6 +227,10 @@ The [`/MAPINFO`](mapinfo-include-information-in-mapfile.md) option tells the lin [`/ASSEMBLYDEBUG`](assemblydebug-add-debuggableattribute.md) emits the `DebuggableAttribute` attribute with debug information tracking and disables JIT optimizations. +### Support C++ Dynamic Debugging + +(Preview) Set linker flag [`/DYNAMICDEOPT`](dynamic-deopt-linker.md) to turn on [C++ Dynamic Debugging](/visualstudio/debugger/cpp-dynamic-debugging). Place deoptimized breakpoints and step in anywhere with on-demand function deoptimization. Use this mode for debugging optimized code. + ## System Property Page ### SubSystem @@ -319,6 +327,10 @@ Specifies link-time code generation. ([`/LTCG`](ltcg-link-time-code-generation.m - **Profile Guided Optimization - Optimization** - Specifies that the linker should use the profile data created after running the instrumented binary to create an optimized image. - **Profile Guided Optimization - Update** - Allows and tracks list of input files to be added or modified from what was specified in the `:PGINSTRUMENT` phase. +### Link Time Code Generation Object File + +Specifies *`.iobj`* file location. ([`/LTCGOUT:[name]`](ltcgout.md)) + ## Embedded IDL Property Page ### MIDL Commands @@ -504,6 +516,10 @@ The [`/ALIGN`](align-section-alignment.md) option specifies the alignment of eac - **Disabled** - Disable **`/CLRSupportLastError`**. - **System DLLs Only** - Enable **`/CLRSupportLastError`** for system DLLs only. +### CET Shadow Stack Compatible + +Specifies whether to mark an executable image as compatible with Control-flow Enforcement Technology (CET) Shadow Stack. ([`/CETCOMPAT`](cetcompat.md)) + ### Image Has Safe Exception Handlers When [`/SAFESEH`](safeseh-image-has-safe-exception-handlers.md) is specified, the linker will only produce an image if it can also produce a table of the image's safe exception handlers. This table specifies for the operating system which exception handlers are valid for the image. From c37eef7effef52a57ec77ec033a9e1aa26ca2725 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 17:25:20 +0800 Subject: [PATCH 0336/1799] Fix P1871R1 link in "Microsoft C/C++ language conformance by Visual Studio version" --- docs/overview/visual-cpp-language-conformance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index f24433753c9..b254d998948 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -401,7 +401,7 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P1023R0 constexpr For std::array Comparisons`](https://wg21.link/P1023R0) | VS 2019 16.7 [20](#note_20) | |  [`P1115R3 erase()/erase_if() Return size_type`](https://wg21.link/P1115R3) | VS 2019 16.7 [20](#note_20) | |  [`P1831R1 Deprecating volatile in the standard library`](https://wg21.link/P1831R1) | VS 2019 16.7 [20](#note_20) | -|  [`P1871R1 Concept traits should be named after concepts`](https://wg21.link/P1831R1) | VS 2019 16.7 [20](#note_20) | +|  [`P1871R1 Concept traits should be named after concepts`](https://wg21.link/P1871R1) | VS 2019 16.7 [20](#note_20) | |  [`P1956R1 has_single_bit(), bit_ceil(), bit_floor(), bit_width()`](https://wg21.link/P1956R1) | VS 2019 16.7 [20](#note_20) | |  [`P1964R2 Replacing boolean With boolean-testable`](https://wg21.link/P1964R2) | VS 2019 16.7 [20](#note_20) | |  [`P1976R2 Fixed-size span construction from dynamic range`](https://wg21.link/P1976R2) | VS 2019 16.7 [20](#note_20) | From 1ae2bc8432c31a1886153f4c0c69994181490eac Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 17:27:51 +0800 Subject: [PATCH 0337/1799] Remove duplicate P2493R0 entry in "Microsoft C/C++ language conformance by Visual Studio version" --- docs/overview/visual-cpp-language-conformance.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index b254d998948..53bce4c93f0 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -216,7 +216,6 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P2460R2 Relax requirements on wchar_t to match existing practices`](https://wg21.link/p2460r2) | no | |  [`P2468R2 The Equality Operator You Are Looking For`](https://wg21.link/p2468r2) | no | |  [`P2493R0 Missing feature test macros for C++20 core papers`](https://wg21.link/p2493r0) | no | -|  [`P2493R0 Missing feature test macros for C++20 core papers`](https://wg21.link/p2493r0) | no | |  [`P2513R4 char8_t Compatibility and Portability Fix`](https://wg21.link/p2513r4) | VS 2022 17.4 [DR](#note_DR) | |  [`P2579R0 Mitigation strategies for P2036 ”Changing scope for lambda trailing-return-type”`](https://wg21.link/p2579r0) | no | |  [`P2582R1 Wording for class template argument deduction from inherited constructors`](https://wg21.link/p2582r1) | no | From bc6b284be6efa5e9ffec0565f30275b2d58ce99a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 17:32:18 +0800 Subject: [PATCH 0338/1799] Add missing `` end tag for P2508R1 in "Microsoft C/C++ language conformance by Visual Studio version" --- docs/overview/visual-cpp-language-conformance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 53bce4c93f0..c774c7eaa98 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -497,7 +497,7 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P2465R3 Standard Library Modules std And std.compat​`](https://wg21.link/p2465r3) | no | |  [`P2494R2 Relaxing Range Adaptors To Allow Move-Only Types​`](https://wg21.link/p2494r2) | VS 2022 17.4 [23](#note_23) | |  [`P2499R0 string_view Range Constructor Should Be explicit​`](https://wg21.link/p2499r0) | VS 2022 17.4 [23](#note_23) | -|  [`P2508R1 basic_format_string, format_string, wformat_string​`](https://wg21.link/p2508r1) | VS 2022 17.5 [23](#note_23) | +|  [`P2508R1 basic_format_string, format_string, wformat_string​`](https://wg21.link/p2508r1) | VS 2022 17.5 [23](#note_23) | |  [`P2517R1 Conditional noexcept For apply()​`](https://wg21.link/p2517r1) | VS 2022 17.4 [23](#note_23) | |  [`P2520R0 move_iterator Should Be A Random-Access Iterator​​`](https://wg21.link/p2520r0) | VS 2022 17.4 [23](#note_23) | |  [`P2549R1 unexpected::error()`](https://wg21.link/p2549r1) | VS 2022 17.3 [23](#note_23) | From d4fed930291407f0f946e9d0097f6e41a82b529d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 17:34:55 +0800 Subject: [PATCH 0339/1799] Clean up double spaces in "Microsoft C/C++ language conformance by Visual Studio version" --- docs/overview/visual-cpp-language-conformance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index c774c7eaa98..294c7802c0e 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -536,7 +536,7 @@ A group of papers listed together indicates a Standard feature along with one or |  `gets_s()` | VS 2019 16.8 [C11](#note_C11) | |  Bounds-checking interfaces (`*_s` APIs) | Partial in VS 2015 [C11](#note_C11), [O](#note_O) | |  `fopen` `"x"` option | VS 2019 16.8 [C11](#note_C11) | -|  Static assertions | VS 2019 16.8 [C11](#note_C11), [2104](#note_2104) | +|  Static assertions | VS 2019 16.8 [C11](#note_C11), [2104](#note_2104) | |  `quick_exit` | VS 2019 16.8 [C11](#note_C11) | |  `` macros | VS 2019 16.8 [C11](#note_C11) | |  floating point characteristics `` | VS 2019 16.8 [C11](#note_C11) | From 5bd3f99fb01af0a644eeb288fbd6fdc33324f19f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 17:38:18 +0800 Subject: [PATCH 0340/1799] Fix wrong VS version for P0682R1 in "Microsoft C/C++ language conformance by Visual Studio version" --- docs/overview/visual-cpp-language-conformance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 294c7802c0e..88298e92b14 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -334,7 +334,7 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P0607R0 Inline Variables for the Standard Library`](https://wg21.link/p0607r0) | VS 2017 15.5 [17](#note_17) | |  [`P0618R0 Deprecating `](https://wg21.link/p0618r0) | VS 2017 15.5 [17](#note_17) | | **C++17 Standard library features (Defect reports)** | **Supported** | -|  [`P0682R1 Repairing Elementary String Conversions`](https://wg21.link/P0682R1) | VS 2015 15.7 [17](#note_17) | +|  [`P0682R1 Repairing Elementary String Conversions`](https://wg21.link/P0682R1) | VS 2017 15.7 [17](#note_17) | |  [`P1164R1 Making create_directory() Intuitive`](https://wg21.link/P1164R1) | VS 2019 16.0 [14](#note_14) | | **C++20 Standard library features** | **Supported** | |  [`P0809R0 Comparing Unordered Containers`](https://wg21.link/p0809r0) | VS 2010 [14](#note_14) | From 53e7c4633efc61ce874ad0d541f59f42d59f697c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 17:47:53 +0800 Subject: [PATCH 0341/1799] Remove all zero-width spaces (U+200B) in "Microsoft C/C++ language conformance by Visual Studio version" --- .../visual-cpp-language-conformance.md | 104 +++++++++--------- 1 file changed, 52 insertions(+), 52 deletions(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 88298e92b14..b276614c6a6 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -445,61 +445,61 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P2367R0 Remove misuses of list-initialization from clause 24 ranges`](https://wg21.link/P2367R0) | VS 2022 17.0 [20abi](#note_20abi) | |  [`P2259R1 Partial LWG issue resolution: repairing Input Range Adaptors and counted_iterator`](https://wg21.link/P2259R1) | VS 2022 17.0 [23](#note_23) | | **C++23 Standard library features** | **Supported** | -|  [`P0288R9 move_only_function​`](https://wg21.link/p0288r9) | VS 2022 17.2 [23](#note_23) | -|  [`P0323R12 ​​`](https://wg21.link/p0323r12) | VS 2022 17.3 [23](#note_23) | -|  [`P0401R6 Providing Size Feedback In The Allocator Interface​`](https://wg21.link/p0401r6) | VS 2022 17.0 [23](#note_23) | -|  [`P0448R4 ​`](https://wg21.link/p0448r4) | VS 2022 17.1 [23](#note_23) | -|  [`P0627R6 unreachable()​`](https://wg21.link/p0627r6) | VS 2022 17.2 [23](#note_23) | -|  [`P0798R8 Monadic Operations For optional​`](https://wg21.link/p0798r8) | VS 2022 17.2 [23](#note_23) | -|  [`P0849R8 auto(x): decay-copy In The Language​`](https://wg21.link/p0849r8) | VS 2022 17.4 [23](#note_23) | -|  [`P0881R7 ​`](https://wg21.link/p0881r7) | VS 2022 17.4 [23](#note_23) | -|  [`P0943R6 Supporting C Atomics In C++​`](https://wg21.link/p0943r6) | VS 2022 17.1 [23](#note_23) | -|  [`P1048R1 is_scoped_enum​`](https://wg21.link/p1048r1) | VS 2022 17.0 [23](#note_23) | -|  [`P1072R10 basic_string::resize_and_overwrite​`](https://wg21.link/p1072r10) | VS 2022 17.1 [23](#note_23) | -|  [`P1132R7 out_ptr(), inout_ptr()​`](https://wg21.link/p1132r7) | VS 2022 17.0 [23](#note_23) | -|  [`P1147R1 Printing volatile Pointers​`](https://wg21.link/p1147r1) | VS 2022 17.1 [23](#note_23) | -|  [`P1206R7 Conversions From Ranges To Containers​`](https://wg21.link/p1206r7) | VS 2022 17.4 [23](#note_23) | -|  [`P1272R4 byteswap()​`](https://wg21.link/p1272r4) | VS 2022 17.1 [23](#note_23) | -|  [`P1328R1 constexpr type_info::operator==()​`](https://wg21.link/p1328r1) | VS 2022 17.4 [23](#note_23) | -|  [`P1413R3 Deprecate aligned_storage And aligned_union​​`](https://wg21.link/p1413r3) | VS 2022 17.3 [23](#note_23) | -|  [`P1425R4 Iterator Pair Constructors For stack And queue​`](https://wg21.link/p1425r4) | VS 2022 17.1 [23](#note_23) | -|  [`P1518R2 Stop Overconstraining Allocators In Container Deduction Guides​`](https://wg21.link/p1518r2) | VS 2022 17.1 [23](#note_23) | -|  [`P1659R3 ranges::starts_with, ranges::ends_with​`](https://wg21.link/p1659r3) | VS 2022 17.1 [23](#note_23) | -|  [`P1679R3 contains() For basic_string/basic_string_view​`](https://wg21.link/p1679r3) | VS 2022 17.0 [23](#note_23) | -|  [`P1682R3 to_underlying() For Enumerations​`](https://wg21.link/p1682r3) | VS 2022 17.0 [23](#note_23) | -|  [`P1899R3 views::stride​`](https://wg21.link/p1899r3) | VS 2022 17.4 [23](#note_23) | -|  [`P1951R1 Default Template Arguments For pair's Forwarding Constructor​`](https://wg21.link/p1951r1) | VS 2022 17.0 [23](#note_23) | -|  [`P1989R2 Range Constructor For string_view​`](https://wg21.link/p1989r2) | VS 2022 17.0 [23](#note_23) | -|  [`P2077R3 Heterogeneous Erasure Overloads For Associative Containers​`](https://wg21.link/p2077r3) | VS 2022 17.2 [23](#note_23) | -|  [`P2136R3 invoke_r()​`](https://wg21.link/p2136r3) | VS 2022 17.1 [23](#note_23) | +|  [`P0288R9 move_only_function`](https://wg21.link/p0288r9) | VS 2022 17.2 [23](#note_23) | +|  [`P0323R12 `](https://wg21.link/p0323r12) | VS 2022 17.3 [23](#note_23) | +|  [`P0401R6 Providing Size Feedback In The Allocator Interface`](https://wg21.link/p0401r6) | VS 2022 17.0 [23](#note_23) | +|  [`P0448R4 `](https://wg21.link/p0448r4) | VS 2022 17.1 [23](#note_23) | +|  [`P0627R6 unreachable()`](https://wg21.link/p0627r6) | VS 2022 17.2 [23](#note_23) | +|  [`P0798R8 Monadic Operations For optional`](https://wg21.link/p0798r8) | VS 2022 17.2 [23](#note_23) | +|  [`P0849R8 auto(x): decay-copy In The Language`](https://wg21.link/p0849r8) | VS 2022 17.4 [23](#note_23) | +|  [`P0881R7 `](https://wg21.link/p0881r7) | VS 2022 17.4 [23](#note_23) | +|  [`P0943R6 Supporting C Atomics In C++`](https://wg21.link/p0943r6) | VS 2022 17.1 [23](#note_23) | +|  [`P1048R1 is_scoped_enum`](https://wg21.link/p1048r1) | VS 2022 17.0 [23](#note_23) | +|  [`P1072R10 basic_string::resize_and_overwrite`](https://wg21.link/p1072r10) | VS 2022 17.1 [23](#note_23) | +|  [`P1132R7 out_ptr(), inout_ptr()`](https://wg21.link/p1132r7) | VS 2022 17.0 [23](#note_23) | +|  [`P1147R1 Printing volatile Pointers`](https://wg21.link/p1147r1) | VS 2022 17.1 [23](#note_23) | +|  [`P1206R7 Conversions From Ranges To Containers`](https://wg21.link/p1206r7) | VS 2022 17.4 [23](#note_23) | +|  [`P1272R4 byteswap()`](https://wg21.link/p1272r4) | VS 2022 17.1 [23](#note_23) | +|  [`P1328R1 constexpr type_info::operator==()`](https://wg21.link/p1328r1) | VS 2022 17.4 [23](#note_23) | +|  [`P1413R3 Deprecate aligned_storage And aligned_union`](https://wg21.link/p1413r3) | VS 2022 17.3 [23](#note_23) | +|  [`P1425R4 Iterator Pair Constructors For stack And queue`](https://wg21.link/p1425r4) | VS 2022 17.1 [23](#note_23) | +|  [`P1518R2 Stop Overconstraining Allocators In Container Deduction Guides`](https://wg21.link/p1518r2) | VS 2022 17.1 [23](#note_23) | +|  [`P1659R3 ranges::starts_with, ranges::ends_with`](https://wg21.link/p1659r3) | VS 2022 17.1 [23](#note_23) | +|  [`P1679R3 contains() For basic_string/basic_string_view`](https://wg21.link/p1679r3) | VS 2022 17.0 [23](#note_23) | +|  [`P1682R3 to_underlying() For Enumerations`](https://wg21.link/p1682r3) | VS 2022 17.0 [23](#note_23) | +|  [`P1899R3 views::stride`](https://wg21.link/p1899r3) | VS 2022 17.4 [23](#note_23) | +|  [`P1951R1 Default Template Arguments For pair's Forwarding Constructor`](https://wg21.link/p1951r1) | VS 2022 17.0 [23](#note_23) | +|  [`P1989R2 Range Constructor For string_view`](https://wg21.link/p1989r2) | VS 2022 17.0 [23](#note_23) | +|  [`P2077R3 Heterogeneous Erasure Overloads For Associative Containers`](https://wg21.link/p2077r3) | VS 2022 17.2 [23](#note_23) | +|  [`P2136R3 invoke_r()`](https://wg21.link/p2136r3) | VS 2022 17.1 [23](#note_23) | |  [`P2162R2 Inheriting from std::variant`](https://wg21.link/P2162R2) | VS 2022 17.0 [17](#note_17) | |  [`P2166R1 Prohibit basic_string and basic_string_view from being constructed from nullptr`](https://wg21.link/P2166R1) | VS 2022 17.0 [23](#note_23), [R](#note_R) | |  [`P2186R2 Removed garbage collection support`](https://wg21.link/P2186R2) | VS 2022 17.0 [23](#note_23), [Q](#note_Q) | -|  [`P2251R1 Require span And basic_string_view To Be Trivially Copyable​`](https://wg21.link/p2251r1) | VS 2022 17.1 [23](#note_23) | -|  [`P2273R3 constexpr unique_ptr​​`](https://wg21.link/p2273r3) | VS 2022 17.3 [23](#note_23) | -|  [`P2291R3 constexpr Integral ​`](https://wg21.link/p2291r3) | VS 2022 17.4 [23](#note_23) | -|  [`P2302R4 ranges::contains, ranges::contains_subrange​`](https://wg21.link/p2302r4) | VS 2022 17.4 [23](#note_23) | -|  [`P2321R2 std::zip​`](https://wg21.link/p2321r2) | partial in VS 2022 17.5 [23](#note_23) | -|  [`P2322R6 ranges::fold_left, ranges::fold_right, etc.​`](https://wg21.link/p2322r6) | VS 2022 17.5 [23](#note_23) | -|  [`P2387R3 Pipe Support For User-Defined Range Adaptors​`](https://wg21.link/p2387r3) | VS 2022 17.4 [23](#note_23) | -|  [`P2393R1 Cleaning Up Integer-Class Types​`](https://wg21.link/p2393r1) | VS 2022 17.2 [23](#note_23) | -|  [`P2401R0 Conditional noexcept For exchange()​`](https://wg21.link/p2401r0) | VS 2022 17.1 [23](#note_23) | -|  [`P2408R5 Ranges Iterators As Inputs To Non-Ranges Algorithms​`](https://wg21.link/p2408r5) | VS 2022 17.4 [23](#note_23) | -|  [`P2417R2 More constexpr bitset​`](https://wg21.link/p2417r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2419R2 Clarify Handling Of Encodings In Localized Formatting Of chrono Types​`](https://wg21.link/p2419r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2438R2 string::substr() &&​`](https://wg21.link/p2438r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2440R1 ranges::iota, ranges::shift_left, ranges::shift_right​`](https://wg21.link/p2440r1) | VS 2022 17.4 [23](#note_23) | -|  [`P2441R2 views::join_with​`](https://wg21.link/p2441r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2442R1 Windowing Range Adaptors: views::chunk, views::slide​​`](https://wg21.link/p2442r1) | VS 2022 17.3 [23](#note_23) | -|  [`P2443R1 views::chunk_by​​`](https://wg21.link/p2443r1) | VS 2022 17.3 [23](#note_23) | -|  [`P2445R1 forward_like()​`](https://wg21.link/p2445r1) | VS 2022 17.4 [23](#note_23) | -|  [`P2446R2 views::as_rvalue​`](https://wg21.link/p2446r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2465R3 Standard Library Modules std And std.compat​`](https://wg21.link/p2465r3) | no | -|  [`P2494R2 Relaxing Range Adaptors To Allow Move-Only Types​`](https://wg21.link/p2494r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2499R0 string_view Range Constructor Should Be explicit​`](https://wg21.link/p2499r0) | VS 2022 17.4 [23](#note_23) | -|  [`P2508R1 basic_format_string, format_string, wformat_string​`](https://wg21.link/p2508r1) | VS 2022 17.5 [23](#note_23) | -|  [`P2517R1 Conditional noexcept For apply()​`](https://wg21.link/p2517r1) | VS 2022 17.4 [23](#note_23) | -|  [`P2520R0 move_iterator Should Be A Random-Access Iterator​​`](https://wg21.link/p2520r0) | VS 2022 17.4 [23](#note_23) | +|  [`P2251R1 Require span And basic_string_view To Be Trivially Copyable`](https://wg21.link/p2251r1) | VS 2022 17.1 [23](#note_23) | +|  [`P2273R3 constexpr unique_ptr`](https://wg21.link/p2273r3) | VS 2022 17.3 [23](#note_23) | +|  [`P2291R3 constexpr Integral `](https://wg21.link/p2291r3) | VS 2022 17.4 [23](#note_23) | +|  [`P2302R4 ranges::contains, ranges::contains_subrange`](https://wg21.link/p2302r4) | VS 2022 17.4 [23](#note_23) | +|  [`P2321R2 std::zip`](https://wg21.link/p2321r2) | partial in VS 2022 17.5 [23](#note_23) | +|  [`P2322R6 ranges::fold_left, ranges::fold_right, etc.`](https://wg21.link/p2322r6) | VS 2022 17.5 [23](#note_23) | +|  [`P2387R3 Pipe Support For User-Defined Range Adaptors`](https://wg21.link/p2387r3) | VS 2022 17.4 [23](#note_23) | +|  [`P2393R1 Cleaning Up Integer-Class Types`](https://wg21.link/p2393r1) | VS 2022 17.2 [23](#note_23) | +|  [`P2401R0 Conditional noexcept For exchange()`](https://wg21.link/p2401r0) | VS 2022 17.1 [23](#note_23) | +|  [`P2408R5 Ranges Iterators As Inputs To Non-Ranges Algorithms`](https://wg21.link/p2408r5) | VS 2022 17.4 [23](#note_23) | +|  [`P2417R2 More constexpr bitset`](https://wg21.link/p2417r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2419R2 Clarify Handling Of Encodings In Localized Formatting Of chrono Types`](https://wg21.link/p2419r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2438R2 string::substr() &&`](https://wg21.link/p2438r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2440R1 ranges::iota, ranges::shift_left, ranges::shift_right`](https://wg21.link/p2440r1) | VS 2022 17.4 [23](#note_23) | +|  [`P2441R2 views::join_with`](https://wg21.link/p2441r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2442R1 Windowing Range Adaptors: views::chunk, views::slide`](https://wg21.link/p2442r1) | VS 2022 17.3 [23](#note_23) | +|  [`P2443R1 views::chunk_by`](https://wg21.link/p2443r1) | VS 2022 17.3 [23](#note_23) | +|  [`P2445R1 forward_like()`](https://wg21.link/p2445r1) | VS 2022 17.4 [23](#note_23) | +|  [`P2446R2 views::as_rvalue`](https://wg21.link/p2446r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2465R3 Standard Library Modules std And std.compat`](https://wg21.link/p2465r3) | no | +|  [`P2494R2 Relaxing Range Adaptors To Allow Move-Only Types`](https://wg21.link/p2494r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2499R0 string_view Range Constructor Should Be explicit`](https://wg21.link/p2499r0) | VS 2022 17.4 [23](#note_23) | +|  [`P2508R1 basic_format_string, format_string, wformat_string`](https://wg21.link/p2508r1) | VS 2022 17.5 [23](#note_23) | +|  [`P2517R1 Conditional noexcept For apply()`](https://wg21.link/p2517r1) | VS 2022 17.4 [23](#note_23) | +|  [`P2520R0 move_iterator Should Be A Random-Access Iterator`](https://wg21.link/p2520r0) | VS 2022 17.4 [23](#note_23) | |  [`P2549R1 unexpected::error()`](https://wg21.link/p2549r1) | VS 2022 17.3 [23](#note_23) | A group of papers listed together indicates a Standard feature along with one or more approved improvements or expansions. These features are implemented together. From 6eb3e3da3e10cea87dee5a1df11a01fd1eeead9c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 18:11:10 +0800 Subject: [PATCH 0342/1799] Convert Math errors list into a table --- .../math-errors-m6101-through-m6205.md | 22 ++++++++++--------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md index 497e291e5fb..29a474e34c5 100644 --- a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md +++ b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md @@ -11,16 +11,18 @@ This section is a reference to the errors generated by the runtime floating-poin ## Math errors -[Math error M6101](math-error-m6101.md) \ -[Math error M6102](math-error-m6102.md) \ -[Math error M6107](math-error-m6107.md) \ -[Math error M6108](math-error-m6108.md) \ -[Math error M6110](math-error-m6110.md) \ -[Math error M6111](math-error-m6111.md) \ -[Math error M6201](math-error-m6201.md) \ -[Math error M6202](math-error-m6202.md) \ -[Math error M6203](math-error-m6203.md) \ -[Math error M6205](math-error-m6205.md) +| Error | Message | +|--|--| +| [Math error M6101](math-error-m6101.md) | invalid | +| [Math error M6102](math-error-m6102.md) | denormal | +| [Math error M6107](math-error-m6107.md) | unemulated | +| [Math error M6108](math-error-m6108.md) | square root | +| [Math error M6110](math-error-m6110.md) | stack overflow | +| [Math error M6111](math-error-m6111.md) | stack underflow | +| [Math error M6201](math-error-m6201.md) | 'function' : _DOMAIN error | +| [Math error M6202](math-error-m6202.md) | 'function' : _SING error | +| [Math error M6203](math-error-m6203.md) | 'function' : _OVERFLOW error | +| [Math error M6205](math-error-m6205.md) | 'function' : _TLOSS error | ## See also From 6ac64161d1528a0d1a9ae2432efa6c64e8038b84 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 18:12:44 +0800 Subject: [PATCH 0343/1799] Simplify superfluous relative links in "Math errors (M6101 through M6205)" --- .../tool-errors/math-errors-m6101-through-m6205.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md index 29a474e34c5..9aff7d1ef43 100644 --- a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md +++ b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md @@ -7,7 +7,7 @@ ms.date: "04/16/2019" This section is a reference to the errors generated by the runtime floating-point math library. Math runtime errors and warnings have the form M*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Math errors From 00da185587b8cb59eab5d0c191504da2fac6f255 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 18:13:10 +0800 Subject: [PATCH 0344/1799] Remove space before escape in "Math errors (M6101 through M6205)" --- .../tool-errors/math-errors-m6101-through-m6205.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md index 9aff7d1ef43..c6a2e6ade63 100644 --- a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md +++ b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md @@ -26,5 +26,5 @@ This section is a reference to the errors generated by the runtime floating-poin ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [Math and floating-point support](../../c-runtime-library/floating-point-support.md) From b6191830dffaa2903e99b1ca707827f20755db5e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 18:13:47 +0800 Subject: [PATCH 0345/1799] Update metadata in "Math errors (M6101 through M6205)" --- .../tool-errors/math-errors-m6101-through-m6205.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md index c6a2e6ade63..b8e002612ab 100644 --- a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md +++ b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Math errors (Mxxxx)" title: "Learn about math errors M6101 through M6205" -ms.date: "04/16/2019" +description: "Learn more about: Math errors (Mxxxx)" +ms.date: 04/16/2019 --- # Math errors (M6101 through M6205) From c0139248ea49118884fdc34d780d654cb9a1fe39 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 18:33:37 +0800 Subject: [PATCH 0346/1799] Add some missing spaces before backticked terms --- docs/c-runtime-library/crt-debugging-techniques.md | 10 +++++----- docs/standard-library/unordered-set-class.md | 4 ++-- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/c-runtime-library/crt-debugging-techniques.md b/docs/c-runtime-library/crt-debugging-techniques.md index 39d625f0e13..323c0d36b96 100644 --- a/docs/c-runtime-library/crt-debugging-techniques.md +++ b/docs/c-runtime-library/crt-debugging-techniques.md @@ -18,7 +18,7 @@ When you debug a program that uses the C run-time library, these debugging techn The C runtime (CRT) library provides extensive debugging support. To use one of the CRT debug libraries, you must link with [`/DEBUG`](/cpp/build/reference/debug-generate-debug-info) and compile with [`/MDd`, `/MTd`, or `/LDd`](../build/reference/md-mt-ld-use-run-time-library.md). -The main definitions and macros for CRT debugging can be found in the`` header file. +The main definitions and macros for CRT debugging can be found in the `` header file. The functions in the CRT debug libraries are compiled with debug information ([/Z7, /Zd, /Zi, /ZI (Debug Information Format)](../build/reference/z7-zi-zi-debug-information-format.md)) and without optimization. Some functions contain assertions to verify parameters that are passed to them, and source code is provided. With this source code, you can step into CRT functions to confirm that the functions are working as you expect and check for bad parameters or memory states. (Some CRT technology is proprietary and doesn't provide source code for exception handling, floating point, and a few other routines.) @@ -26,7 +26,7 @@ For more information on the various run-time libraries you can use, see [C Run-T ## Macros for reporting -For debugging, you can use the `_RPTn` and `_RPTFn` macros, defined in``, to replace the use of `printf` statements. You don't need to enclose them in `#ifdef` directives, because they automatically disappear in your release build when `_DEBUG` isn't defined. +For debugging, you can use the `_RPTn` and `_RPTFn` macros, defined in ``, to replace the use of `printf` statements. You don't need to enclose them in `#ifdef` directives, because they automatically disappear in your release build when `_DEBUG` isn't defined. | Macro | Description | |---|---| @@ -81,7 +81,7 @@ You can write several kinds of custom debug hook functions that allow you to ins ### Client block hook functions -If you want to validate or report the contents of the data stored in `_CLIENT_BLOCK` blocks, you can write a function specifically for this purpose. The function that you write must have a prototype similar to the following, as defined in``: +If you want to validate or report the contents of the data stored in `_CLIENT_BLOCK` blocks, you can write a function specifically for this purpose. The function that you write must have a prototype similar to the following, as defined in ``: ```cpp void YourClientDump(void *, size_t) @@ -91,7 +91,7 @@ In other words, your hook function should accept a `void` pointer to the beginni Once you've installed your hook function using [_CrtSetDumpClient](./reference/crtsetdumpclient.md), it will be called every time a `_CLIENT_BLOCK` block is dumped. You can then use [_CrtReportBlockType](./reference/crtreportblocktype.md) to get information on the type or subtype of dumped blocks. -The pointer to your function that you pass to `_CrtSetDumpClient` is of type `_CRT_DUMP_CLIENT`, as defined in``: +The pointer to your function that you pass to `_CrtSetDumpClient` is of type `_CRT_DUMP_CLIENT`, as defined in ``: ```cpp typedef void (__cdecl *_CRT_DUMP_CLIENT) @@ -113,7 +113,7 @@ int YourAllocHook(int nAllocType, void *pvData, const unsigned char * szFileName, int nLine ) ``` -The pointer that you pass to [`_CrtSetAllocHook`](./reference/crtsetallochook.md) is of type `_CRT_ALLOC_HOOK`, as defined in``: +The pointer that you pass to [`_CrtSetAllocHook`](./reference/crtsetallochook.md) is of type `_CRT_ALLOC_HOOK`, as defined in ``: ```cpp typedef int (__cdecl * _CRT_ALLOC_HOOK) diff --git a/docs/standard-library/unordered-set-class.md b/docs/standard-library/unordered-set-class.md index a0d02bace63..be1541f0425 100644 --- a/docs/standard-library/unordered-set-class.md +++ b/docs/standard-library/unordered-set-class.md @@ -1089,7 +1089,7 @@ Key value to search for. ### Remarks -The member function returns a pair of iterators `X` such that`[X.first, X.second)` delimits just those elements of the controlled sequence that have equivalent ordering with *`keyval`*. If no such elements exist, both iterators are `end()`. +The member function returns a pair of iterators `X` such that `[X.first, X.second)` delimits just those elements of the controlled sequence that have equivalent ordering with *`keyval`*. If no such elements exist, both iterators are `end()`. ### Example @@ -2376,7 +2376,7 @@ The `initializer_list` containing the elements to copy. ### Remarks -The first constructor specifies a copy of the sequence controlled by *`Right`*. The second constructor specifies an empty controlled sequence. The third constructor specifies a copy of the sequence by moving *`Right`* The fourth through eighth constructors use an `initializer_list` to specify the elements to copy. The ninth constructor inserts the sequence of element values`[first, last)`. +The first constructor specifies a copy of the sequence controlled by *`Right`*. The second constructor specifies an empty controlled sequence. The third constructor specifies a copy of the sequence by moving *`Right`* The fourth through eighth constructors use an `initializer_list` to specify the elements to copy. The ninth constructor inserts the sequence of element values `[first, last)`. All constructors also initialize several stored values. For the copy constructor, the values are obtained from *`Right`*. Otherwise: From 870ffa86ce20d376949450e9542d612cde49c5aa Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 18:40:06 +0800 Subject: [PATCH 0347/1799] Add blockquotes for error messages in range [C2041, C2060] --- docs/error-messages/compiler-errors-1/compiler-error-c2041.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2042.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2043.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2044.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2045.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2046.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2047.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2048.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2050.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2051.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2052.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2053.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2054.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2056.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2057.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2058.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2059.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2060.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md index e78711fd216..0571b35497b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md @@ -8,7 +8,7 @@ ms.assetid: c9a33bb1-f9cf-47d6-bd21-7d867a8c37d5 --- # Compiler Error C2041 -illegal digit 'character' for base 'number' +> illegal digit 'character' for base 'number' The specified character is not a valid digit for the base (such as octal or hex). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md index a29490360b5..8d67d79c076 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md @@ -8,7 +8,7 @@ ms.assetid: e111788f-41ce-405a-9824-a4c1c26059e6 --- # Compiler Error C2042 -signed/unsigned keywords mutually exclusive +> signed/unsigned keywords mutually exclusive The keywords **`signed`** and **`unsigned`** are used in a single declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2043.md b/docs/error-messages/compiler-errors-1/compiler-error-c2043.md index 0ef748d8218..560cf4646a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2043.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2043.md @@ -8,6 +8,6 @@ ms.assetid: 6cc829f3-c6ea-43ae-8a3f-303ecf6c7dc6 --- # Compiler Error C2043 -illegal break +> illegal break A [break](../../cpp/break-statement-cpp.md) is legal only within a **`do`**, **`for`**, **`while`**, or **`switch`** statement. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2044.md b/docs/error-messages/compiler-errors-1/compiler-error-c2044.md index 12ec3d94b6f..c22299f69f4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2044.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2044.md @@ -8,6 +8,6 @@ ms.assetid: adf4bedc-f915-4008-8b48-a06d626d8c38 --- # Compiler Error C2044 -illegal continue +> illegal continue A [continue](../../cpp/continue-statement-cpp.md) is legal only within a **`do`**, **`for`**, or **`while`** statement. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md index a694941e73a..318fb49f56d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md @@ -8,7 +8,7 @@ ms.assetid: 2fca668e-9b20-4933-987a-18c0fd0187df --- # Compiler Error C2045 -'identifier' : label redefined +> 'identifier' : label redefined The label appears before multiple statements in the same function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md index 1fc5235d5d4..4c22d433334 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md @@ -8,7 +8,7 @@ ms.assetid: f0c8f9dd-dbd7-4c4a-8838-fde54208ec71 --- # Compiler Error C2046 -illegal case +> illegal case The keyword `case` can appear only in a **`switch`** statement. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md index 57ec7a835df..1e55542e44b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md @@ -8,7 +8,7 @@ ms.assetid: 686a5a81-3857-4753-84a0-5c2e7149cbee --- # Compiler Error C2047 -illegal default +> illegal default The keyword **`default`** can appear only in a **`switch`** statement. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md index d424fe39c4b..d777178ebf8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md @@ -8,7 +8,7 @@ ms.assetid: 44704726-85fc-42f0-afb9-194df8c4ca7c --- # Compiler Error C2048 -more than one default +> more than one default A **`switch`** statement contains multiple **`default`** labels. Delete one of the **`default`** labels to resolve the error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md index a1815f9b37c..99b927fdb07 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md @@ -8,7 +8,7 @@ ms.assetid: 66aaed7d-00db-4ce1-a9d6-4447c1cf07ce --- # Compiler Error C2050 -switch expression not integral +> switch expression not integral The **`switch`** expression evaluates to a noninteger value. To resolve the error, use only integral values in switch statements. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md index b7a5383002d..80cc9108738 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md @@ -8,7 +8,7 @@ ms.assetid: 81c0469a-78e2-49fa-bd76-97cdb135e3ea --- # Compiler Error C2051 -case expression not constant +> case expression not constant Case expressions must be integer constants. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md index a32b58543ea..35210c94af8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md @@ -8,7 +8,7 @@ ms.assetid: 922ca43b-b64b-4ef7-9611-c7313be3fd79 --- # Compiler Error C2052 -'type' : illegal type for case expression +> 'type' : illegal type for case expression Case expressions must be integer constants. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md index bc6087a46ee..1b2d2065412 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md @@ -8,7 +8,7 @@ ms.assetid: 13324c85-13a8-4996-bd42-a31bfe7ff80f --- # Compiler Error C2053 -'identifier' : wide string mismatch +> 'identifier' : wide string mismatch The wide string is assigned to an incompatible type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md index d3cbf892c7c..ae87d810de7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md @@ -8,7 +8,7 @@ ms.assetid: 37f7c612-0d7d-4728-9e67-ac4160555f48 --- # Compiler Error C2054 -expected '(' to follow 'identifier' +> expected '(' to follow 'identifier' The function identifier is used in a context that requires trailing parentheses. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2056.md b/docs/error-messages/compiler-errors-1/compiler-error-c2056.md index f29b08129a9..f583baf25ee 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2056.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2056.md @@ -8,6 +8,6 @@ ms.assetid: 043a1f72-738a-487f-b7b3-055cc5ca0ae7 --- # Compiler Error C2056 -illegal expression +> illegal expression An expression was invalid because of a previous error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md index 41049e9a070..7d459fa09db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md @@ -8,7 +8,7 @@ ms.assetid: 038a99d6-1f5a-42fa-8449-03b4ff11ee0b --- # Compiler Error C2057 -expected constant expression +> expected constant expression The context requires a constant expression, an expression whose value is known at compile time. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md index 4910bb4b71e..c5e79d0646f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md @@ -8,7 +8,7 @@ ms.assetid: 81e08e6b-15f7-41b4-980a-53763e19990c --- # Compiler Error C2058 -constant expression is not integral +> constant expression is not integral The context requires an integer constant expression. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md index 61b19f215fd..7e0601977ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md @@ -8,7 +8,7 @@ ms.assetid: 2be4eb39-3f37-4b32-8e8d-75835e07c78a --- # Compiler Error C2059 -syntax error : 'token' +> syntax error : 'token' The token caused a syntax error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2060.md b/docs/error-messages/compiler-errors-1/compiler-error-c2060.md index a6cfa82a76c..1f1fea6da97 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2060.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2060.md @@ -8,6 +8,6 @@ ms.assetid: 2572deba-cc12-464e-9162-86252a3af061 --- # Compiler Error C2060 -syntax error : end of file found +> syntax error : end of file found At least one more token was expected. From bf148eb324dcdb7bd2b59b1b4718b412a88f92be Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 18:45:38 +0800 Subject: [PATCH 0348/1799] Add "Remarks" and "Example" headings for error references in range [C2041, C2060] --- docs/error-messages/compiler-errors-1/compiler-error-c2041.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2042.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2043.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2044.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2045.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2046.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2047.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2048.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2049.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2050.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2051.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2052.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2053.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2054.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2055.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2056.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2057.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2058.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2059.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2060.md | 2 ++ 20 files changed, 70 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md index 0571b35497b..0cc991f1dca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md @@ -10,8 +10,12 @@ ms.assetid: c9a33bb1-f9cf-47d6-bd21-7d867a8c37d5 > illegal digit 'character' for base 'number' +## Remarks + The specified character is not a valid digit for the base (such as octal or hex). +## Example + The following sample generates C2041: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md index 8d67d79c076..8770a77539e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md @@ -10,8 +10,12 @@ ms.assetid: e111788f-41ce-405a-9824-a4c1c26059e6 > signed/unsigned keywords mutually exclusive +## Remarks + The keywords **`signed`** and **`unsigned`** are used in a single declaration. +## Example + The following sample generates C2042: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2043.md b/docs/error-messages/compiler-errors-1/compiler-error-c2043.md index 560cf4646a6..4b4cfa24515 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2043.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2043.md @@ -10,4 +10,6 @@ ms.assetid: 6cc829f3-c6ea-43ae-8a3f-303ecf6c7dc6 > illegal break +## Remarks + A [break](../../cpp/break-statement-cpp.md) is legal only within a **`do`**, **`for`**, **`while`**, or **`switch`** statement. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2044.md b/docs/error-messages/compiler-errors-1/compiler-error-c2044.md index c22299f69f4..41e62c03285 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2044.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2044.md @@ -10,4 +10,6 @@ ms.assetid: adf4bedc-f915-4008-8b48-a06d626d8c38 > illegal continue +## Remarks + A [continue](../../cpp/continue-statement-cpp.md) is legal only within a **`do`**, **`for`**, or **`while`** statement. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md index 318fb49f56d..96b8eec16a0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md @@ -10,8 +10,12 @@ ms.assetid: 2fca668e-9b20-4933-987a-18c0fd0187df > 'identifier' : label redefined +## Remarks + The label appears before multiple statements in the same function. +## Example + The following sample generates C2045: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md index 4c22d433334..faa60c24841 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md @@ -10,8 +10,12 @@ ms.assetid: f0c8f9dd-dbd7-4c4a-8838-fde54208ec71 > illegal case +## Remarks + The keyword `case` can appear only in a **`switch`** statement. +## Example + The following sample generates C2046: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md index 1e55542e44b..3b7bdb6fa9b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md @@ -10,8 +10,12 @@ ms.assetid: 686a5a81-3857-4753-84a0-5c2e7149cbee > illegal default +## Remarks + The keyword **`default`** can appear only in a **`switch`** statement. +## Example + The following sample generates C2047: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md index d777178ebf8..bc295a7ab46 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md @@ -10,8 +10,12 @@ ms.assetid: 44704726-85fc-42f0-afb9-194df8c4ca7c > more than one default +## Remarks + A **`switch`** statement contains multiple **`default`** labels. Delete one of the **`default`** labels to resolve the error. +## Example + The following sample generates C2048: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2049.md b/docs/error-messages/compiler-errors-1/compiler-error-c2049.md index cc707acda14..358369040b9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2049.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2049.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C2049"] > '*namespace-name*': non-inline namespace cannot be reopened as inline +## Remarks + The **`inline`** keyword may be used on a namespace definition extension only if it was also used on the original namespace definition. To resolve this issue, make the use of the **`inline`** specifier consistent across all parts of the namespace. +## Example + The following sample generates C2049: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md index 99b927fdb07..be6bf92df47 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md @@ -10,8 +10,12 @@ ms.assetid: 66aaed7d-00db-4ce1-a9d6-4447c1cf07ce > switch expression not integral +## Remarks + The **`switch`** expression evaluates to a noninteger value. To resolve the error, use only integral values in switch statements. +## Example + The following sample generates C2050: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md index 80cc9108738..691b81ef672 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md @@ -10,8 +10,12 @@ ms.assetid: 81c0469a-78e2-49fa-bd76-97cdb135e3ea > case expression not constant +## Remarks + Case expressions must be integer constants. +## Example + The following sample generates C2051: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md index 35210c94af8..2a333aafa17 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md @@ -10,8 +10,12 @@ ms.assetid: 922ca43b-b64b-4ef7-9611-c7313be3fd79 > 'type' : illegal type for case expression +## Remarks + Case expressions must be integer constants. +## Example + The following sample generates C2052: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md index 1b2d2065412..e90370ac252 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md @@ -10,8 +10,12 @@ ms.assetid: 13324c85-13a8-4996-bd42-a31bfe7ff80f > 'identifier' : wide string mismatch +## Remarks + The wide string is assigned to an incompatible type. +## Example + The following sample generates C2053: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md index ae87d810de7..5dca4007079 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md @@ -10,10 +10,14 @@ ms.assetid: 37f7c612-0d7d-4728-9e67-ac4160555f48 > expected '(' to follow 'identifier' +## Remarks + The function identifier is used in a context that requires trailing parentheses. This error can be caused by omitting an equal sign (=) on a complex initialization. +## Example + The following sample generates C2054: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2055.md b/docs/error-messages/compiler-errors-1/compiler-error-c2055.md index 1654921d893..909a17527a3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2055.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2055.md @@ -9,11 +9,15 @@ helpviewer_keywords: ["C2055"] > expected formal parameter list, not a type list +## Remarks + A function definition contains a parameter type list instead of a formal parameter list. ANSI C requires formal parameters to be named unless they're `void` or an ellipsis (`...`). An example of a named formal parameter is the `int i` in `void func(int i)`.\ A parameter type list is a list of types, for example, `int, char`. +## Example + The following code generates error `C2055`: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2056.md b/docs/error-messages/compiler-errors-1/compiler-error-c2056.md index f583baf25ee..dc6cdb09614 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2056.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2056.md @@ -10,4 +10,6 @@ ms.assetid: 043a1f72-738a-487f-b7b3-055cc5ca0ae7 > illegal expression +## Remarks + An expression was invalid because of a previous error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md index 7d459fa09db..3ab4cec884d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md @@ -10,6 +10,8 @@ ms.assetid: 038a99d6-1f5a-42fa-8449-03b4ff11ee0b > expected constant expression +## Remarks + The context requires a constant expression, an expression whose value is known at compile time. The compiler must know the size of a type at compile time in order to allocate space for an instance of that type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md index c5e79d0646f..a682a382d56 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md @@ -10,8 +10,12 @@ ms.assetid: 81e08e6b-15f7-41b4-980a-53763e19990c > constant expression is not integral +## Remarks + The context requires an integer constant expression. +## Example + The following sample generates C2058: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md index 7e0601977ec..6bfdeb2a3a0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md @@ -10,8 +10,12 @@ ms.assetid: 2be4eb39-3f37-4b32-8e8d-75835e07c78a > syntax error : 'token' +## Remarks + The token caused a syntax error. +## Examples + The following example generates an error message for the line that declares `j`. ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2060.md b/docs/error-messages/compiler-errors-1/compiler-error-c2060.md index 1f1fea6da97..b0f7f370b7b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2060.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2060.md @@ -10,4 +10,6 @@ ms.assetid: 2572deba-cc12-464e-9162-86252a3af061 > syntax error : end of file found +## Remarks + At least one more token was expected. From 38d2fdec7755440f64bf1700a3f62e649232d206 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 18:47:28 +0800 Subject: [PATCH 0349/1799] Replace term "sample" with "example" for error references in range [C2041, C2060] --- docs/error-messages/compiler-errors-1/compiler-error-c2041.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2042.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2045.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2046.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2047.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2048.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2049.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2050.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2051.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2052.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2053.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2054.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2057.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2058.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2059.md | 4 ++-- 15 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md index 0cc991f1dca..f858c8887e3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md @@ -16,7 +16,7 @@ The specified character is not a valid digit for the base (such as octal or hex) ## Example -The following sample generates C2041: +The following example generates C2041: ```cpp // C2041.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md index 8770a77539e..bc3110f3eb2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md @@ -16,7 +16,7 @@ The keywords **`signed`** and **`unsigned`** are used in a single declaration. ## Example -The following sample generates C2042: +The following example generates C2042: ```cpp // C2042.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md index 96b8eec16a0..728bd4451c9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md @@ -16,7 +16,7 @@ The label appears before multiple statements in the same function. ## Example -The following sample generates C2045: +The following example generates C2045: ```cpp // C2045.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md index faa60c24841..1e96d2d20e4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md @@ -16,7 +16,7 @@ The keyword `case` can appear only in a **`switch`** statement. ## Example -The following sample generates C2046: +The following example generates C2046: ```cpp // C2046.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md index 3b7bdb6fa9b..ffbe6dc7fa5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md @@ -16,7 +16,7 @@ The keyword **`default`** can appear only in a **`switch`** statement. ## Example -The following sample generates C2047: +The following example generates C2047: ```cpp // C2047.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md index bc295a7ab46..f365e62c4a8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md @@ -16,7 +16,7 @@ A **`switch`** statement contains multiple **`default`** labels. Delete one of t ## Example -The following sample generates C2048: +The following example generates C2048: ```cpp // C2048.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2049.md b/docs/error-messages/compiler-errors-1/compiler-error-c2049.md index 358369040b9..e506d1ec1f4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2049.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2049.md @@ -17,7 +17,7 @@ To resolve this issue, make the use of the **`inline`** specifier consistent acr ## Example -The following sample generates C2049: +The following example generates C2049: ```cpp // C2049.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md index be6bf92df47..3e87a79cadf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md @@ -16,7 +16,7 @@ The **`switch`** expression evaluates to a noninteger value. To resolve the erro ## Example -The following sample generates C2050: +The following example generates C2050: ```cpp // C2050.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md index 691b81ef672..7801c0b6957 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md @@ -16,7 +16,7 @@ Case expressions must be integer constants. ## Example -The following sample generates C2051: +The following example generates C2051: ```cpp // C2051.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md index 2a333aafa17..342c49c944b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md @@ -16,7 +16,7 @@ Case expressions must be integer constants. ## Example -The following sample generates C2052: +The following example generates C2052: ```cpp // C2052.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md index e90370ac252..dd40579febf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md @@ -16,7 +16,7 @@ The wide string is assigned to an incompatible type. ## Example -The following sample generates C2053: +The following example generates C2053: ```c // C2053.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md index 5dca4007079..65f2f2fd6db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md @@ -18,7 +18,7 @@ This error can be caused by omitting an equal sign (=) on a complex initializati ## Example -The following sample generates C2054: +The following example generates C2054: ```c // C2054.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md index 3ab4cec884d..4a69afb18d8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md @@ -18,7 +18,7 @@ The compiler must know the size of a type at compile time in order to allocate s ## Examples -The following sample generates C2057 and shows how to fix it: +The following example generates C2057 and shows how to fix it: ```cpp // C2057.cpp @@ -30,7 +30,7 @@ int main() { } ``` -C has more restrictive rules for constant expressions. The following sample generates C2057 and shows how to fix it: +C has more restrictive rules for constant expressions. The following example generates C2057 and shows how to fix it: ```c // C2057b.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md index a682a382d56..039411581cc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md @@ -16,7 +16,7 @@ The context requires an integer constant expression. ## Example -The following sample generates C2058: +The following example generates C2058: ```cpp // C2058.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md index 6bfdeb2a3a0..dd7e3c00074 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md @@ -77,7 +77,7 @@ void func(ag_type arg = ag_type(5, 7.0)); // OK C2059 can occur for an ill-formed cast. -The following sample generates C2059: +The following example generates C2059: ```cpp // C2059c.cpp @@ -95,7 +95,7 @@ int main() { C2059 can also occur if you attempt to create a namespace name that contains a period. -The following sample generates C2059: +The following example generates C2059: ```cpp // C2059d.cpp From 2549dd39f87c94af9141348fd91d803d4c931732 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 11 Jul 2025 18:51:09 +0800 Subject: [PATCH 0350/1799] Update metadata for error references in range [C2041, C2060] --- .../error-messages/compiler-errors-1/compiler-error-c2041.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2042.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2043.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2044.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2045.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2046.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2047.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2048.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2049.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2050.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2051.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2052.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2053.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2054.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2055.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2056.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2057.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2058.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2059.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2060.md | 5 ++--- 20 files changed, 38 insertions(+), 56 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md index f858c8887e3..fd9ffaba7a9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2041" title: "Compiler Error C2041" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2041" +ms.date: 11/04/2016 f1_keywords: ["C2041"] helpviewer_keywords: ["C2041"] -ms.assetid: c9a33bb1-f9cf-47d6-bd21-7d867a8c37d5 --- # Compiler Error C2041 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md index bc3110f3eb2..514b99958e3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2042" title: "Compiler Error C2042" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2042" +ms.date: 11/04/2016 f1_keywords: ["C2042"] helpviewer_keywords: ["C2042"] -ms.assetid: e111788f-41ce-405a-9824-a4c1c26059e6 --- # Compiler Error C2042 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2043.md b/docs/error-messages/compiler-errors-1/compiler-error-c2043.md index 4b4cfa24515..5cc6bae8010 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2043.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2043.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2043" title: "Compiler Error C2043" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2043" +ms.date: 11/04/2016 f1_keywords: ["C2043"] helpviewer_keywords: ["C2043"] -ms.assetid: 6cc829f3-c6ea-43ae-8a3f-303ecf6c7dc6 --- # Compiler Error C2043 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2044.md b/docs/error-messages/compiler-errors-1/compiler-error-c2044.md index 41e62c03285..5bb88a790e1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2044.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2044.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2044" title: "Compiler Error C2044" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2044" +ms.date: 11/04/2016 f1_keywords: ["C2044"] helpviewer_keywords: ["C2044"] -ms.assetid: adf4bedc-f915-4008-8b48-a06d626d8c38 --- # Compiler Error C2044 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md index 728bd4451c9..dd805a57e02 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2045" title: "Compiler Error C2045" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2045" +ms.date: 11/04/2016 f1_keywords: ["C2045"] helpviewer_keywords: ["C2045"] -ms.assetid: 2fca668e-9b20-4933-987a-18c0fd0187df --- # Compiler Error C2045 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md index 1e96d2d20e4..7831da647a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2046" title: "Compiler Error C2046" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2046" +ms.date: 11/04/2016 f1_keywords: ["C2046"] helpviewer_keywords: ["C2046"] -ms.assetid: f0c8f9dd-dbd7-4c4a-8838-fde54208ec71 --- # Compiler Error C2046 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md index ffbe6dc7fa5..51b7b6470fc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2047" title: "Compiler Error C2047" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2047" +ms.date: 11/04/2016 f1_keywords: ["C2047"] helpviewer_keywords: ["C2047"] -ms.assetid: 686a5a81-3857-4753-84a0-5c2e7149cbee --- # Compiler Error C2047 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md index f365e62c4a8..11ef98ecba7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2048" title: "Compiler Error C2048" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2048" +ms.date: 11/04/2016 f1_keywords: ["C2048"] helpviewer_keywords: ["C2048"] -ms.assetid: 44704726-85fc-42f0-afb9-194df8c4ca7c --- # Compiler Error C2048 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2049.md b/docs/error-messages/compiler-errors-1/compiler-error-c2049.md index e506d1ec1f4..efcbb0ca4fd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2049.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2049.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2049" title: "Compiler Error C2049" +description: "Learn more about: Compiler Error C2049" ms.date: 08/18/2022 f1_keywords: ["C2049"] helpviewer_keywords: ["C2049"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md index 3e87a79cadf..962b523cf2c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2050" title: "Compiler Error C2050" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2050" +ms.date: 11/04/2016 f1_keywords: ["C2050"] helpviewer_keywords: ["C2050"] -ms.assetid: 66aaed7d-00db-4ce1-a9d6-4447c1cf07ce --- # Compiler Error C2050 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md index 7801c0b6957..1437749339b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2051" title: "Compiler Error C2051" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2051" +ms.date: 11/04/2016 f1_keywords: ["C2051"] helpviewer_keywords: ["C2051"] -ms.assetid: 81c0469a-78e2-49fa-bd76-97cdb135e3ea --- # Compiler Error C2051 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md index 342c49c944b..4a0693ce3e8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2052" title: "Compiler Error C2052" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2052" +ms.date: 11/04/2016 f1_keywords: ["C2052"] helpviewer_keywords: ["C2052"] -ms.assetid: 922ca43b-b64b-4ef7-9611-c7313be3fd79 --- # Compiler Error C2052 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md index dd40579febf..8a61e880a57 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2053" title: "Compiler Error C2053" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2053" +ms.date: 11/04/2016 f1_keywords: ["C2053"] helpviewer_keywords: ["C2053"] -ms.assetid: 13324c85-13a8-4996-bd42-a31bfe7ff80f --- # Compiler Error C2053 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md index 65f2f2fd6db..58ec5aff223 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2054" title: "Compiler Error C2054" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2054" +ms.date: 11/04/2016 f1_keywords: ["C2054"] helpviewer_keywords: ["C2054"] -ms.assetid: 37f7c612-0d7d-4728-9e67-ac4160555f48 --- # Compiler Error C2054 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2055.md b/docs/error-messages/compiler-errors-1/compiler-error-c2055.md index 909a17527a3..c382074bc57 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2055.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2055.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Microsoft Visual C++ compiler error C2055" title: "Compiler error C2055" +description: "Learn more about: Microsoft Visual C++ compiler error C2055" ms.date: 06/10/2024 f1_keywords: ["C2055"] helpviewer_keywords: ["C2055"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2056.md b/docs/error-messages/compiler-errors-1/compiler-error-c2056.md index dc6cdb09614..2aca685be38 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2056.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2056.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2056" title: "Compiler Error C2056" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2056" +ms.date: 11/04/2016 f1_keywords: ["C2056"] helpviewer_keywords: ["C2056"] -ms.assetid: 043a1f72-738a-487f-b7b3-055cc5ca0ae7 --- # Compiler Error C2056 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md index 4a69afb18d8..eefd54c1e9d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2057" title: "Compiler Error C2057" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2057" +ms.date: 11/04/2016 f1_keywords: ["C2057"] helpviewer_keywords: ["C2057"] -ms.assetid: 038a99d6-1f5a-42fa-8449-03b4ff11ee0b --- # Compiler Error C2057 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md index 039411581cc..04aa6b3c5ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2058" title: "Compiler Error C2058" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2058" +ms.date: 11/04/2016 f1_keywords: ["C2058"] helpviewer_keywords: ["C2058"] -ms.assetid: 81e08e6b-15f7-41b4-980a-53763e19990c --- # Compiler Error C2058 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md index dd7e3c00074..b575bf8b277 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2059" title: "Compiler Error C2059" -ms.date: "03/26/2019" +description: "Learn more about: Compiler Error C2059" +ms.date: 03/26/2019 f1_keywords: ["C2059"] helpviewer_keywords: ["C2059"] -ms.assetid: 2be4eb39-3f37-4b32-8e8d-75835e07c78a --- # Compiler Error C2059 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2060.md b/docs/error-messages/compiler-errors-1/compiler-error-c2060.md index b0f7f370b7b..19ef4398bbc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2060.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2060.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2060" title: "Compiler Error C2060" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2060" +ms.date: 11/04/2016 f1_keywords: ["C2060"] helpviewer_keywords: ["C2060"] -ms.assetid: 2572deba-cc12-464e-9162-86252a3af061 --- # Compiler Error C2060 From cbdce9b669f434b8c4a4c412332d48c01623c568 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 11 Jul 2025 11:03:29 -0700 Subject: [PATCH 0351/1799] draft --- docs/build-insights/toc.yml | 2 + .../tutorials/build-insights-template-view.md | 173 ++++++++++++++++++ .../media/installer-build-insights.png | Bin 0 -> 6264 bytes .../media/tools-options-build-insights.png | Bin 0 -> 19725 bytes 4 files changed, 175 insertions(+) create mode 100644 docs/build-insights/tutorials/build-insights-template-view.md create mode 100644 docs/build-insights/tutorials/media/installer-build-insights.png create mode 100644 docs/build-insights/tutorials/media/tools-options-build-insights.png diff --git a/docs/build-insights/toc.yml b/docs/build-insights/toc.yml index 99cea23e5b0..149a4a7f0fe 100644 --- a/docs/build-insights/toc.yml +++ b/docs/build-insights/toc.yml @@ -8,6 +8,8 @@ items: items: - name: "Troubleshoot function inlining on build time" href: ../build-insights/tutorials/build-insights-function-view.md + - name: "Analyze template instantiations to optimize build time" + href: ../build-insights/tutorials/build-insights-template-view.md - name: "Troubleshoot header file impact on build time" href: ../build-insights/tutorials/build-insights-included-files-view.md - name: "Build Insights tips and tricks" diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md new file mode 100644 index 00000000000..d8124a8578b --- /dev/null +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -0,0 +1,173 @@ +--- +title: "Troubleshoot template instantiation impact on build time" +description: "Tutorial for how to use Build Insights template view to analyze and optimize the impact of template instantiations on build time in your C++ projects." +ms.date: 7/9/2025 +helpviewer_keywords: ["C++ Build Insights", "template instantiation analysis", "build time analysis"] +ms.topic: troubleshooting-general +--- +# Troubleshoot template instantiation impact on build time + +Use Build Insights **Templates** view to analyze the impact of template instantiations on build time in your C++ projects. This feature is especially useful for projects that make heavy use of templates, such as those using template metaprogramming or large generic libraries. + +## Prerequisites + +- Visual Studio 2022 version 17.10 or later. +- The **C++ Build Insights** component must be installed. It's enabled by default if you install either the Desktop development with C++ workload or the Game development with C++ workload. You can ensure that it is installed by following these steps: + 1. Open the Visual Studio Installer. + 1. Modify your Visual Studio installation. + 1. Under the **Individual components** tab, search for and select **C++ Build Insights**. + :::image type="complex" source="./media/installer-build-insights.png" alt-text="Screenshot of the Visual Studio Installer":::The search box contains C++ build insights. The item C++ Build Insights is visible and selected.":::image-end::: + 1. Click **Modify** to install the component. + +## Overview + +Build Insights, integrated into Visual Studio, helps you optimize your build times--especially for large projects like AAA games. Build Insights provides analytics such as **Templates** view, which helps diagnose expensive template instantiations during build time. It displays the time it takes to instantiate each template and shows which template instantiations add the most to your build time. + +For optimized builds, the time spent on template instantiation contributes significantly to the total build time. In general, C++ template instantiation happens quickly. In exceptional cases, some template instantiations can become complex enough to noticeably slow down your builds. + +In this article, learn how to use the Build Insights **Templates** view to find template instantiation bottlenecks in your build. + +To try out Build Insights Templates view, follow along to create a project, set the build options, do a build, and analyze the results. + +## Create a test project + +1. Open Visual Studio and create a new **C++ Console App** project and name it `TemplateAnalysis`. +1. Create a header file called `Templates.h`. +1. Replace the contents of the `Templates.h` file with the following code: + + ```cpp + #pragma once + #include + #include + + template struct S1 {}; + template using type = std::vector>; + + template struct S2 {}; + + template struct S3 {}; + + template + struct S3> + { + using type = S2)...>; + }; + + inline size_t LargeValue() + { + return sizeof(S3>); + }; + + inline size_t SmallValue() + { + return sizeof(S1<5>); + } + ``` + +1. Create a source file called `LargeValue.cpp` +1. Replace the contents of the `LargeValue.cpp` file with the following code: + + ```cpp + #include "Templates.h" + + size_t GetLargeValue() + { + return LargeValue(); + } + ``` + +1. Replace the contents of the `TemplateAnalysis.cpp` file with the following code: + + ```cpp + #include "Templates.h" + + extern size_t GetLargeValue(); + + size_t GetSmallValue() + { + return SmallValue(); + } + + int main() + { + size_t largeValue = GetLargeValue(); + size_t smallValue = GetSmallValue(); + return 0; + } + ``` + +1. ## Enable template instantiation data collection + +Template instantiation time collection is off by default to minimize build overhead. To enable it: + +1. In Visual Studio, go to **Tools** > **Options**. +1. In the Options dialog, expand **Build Insights** in the left navigation. +1. Select **Collect Template Instantiation**. +1. You can also choose where to save the report by selecting **Store Build Insights reports in this directory:** and specifying a directory. By default, it's saved in the folder pointed to by the Windows `TEMP` environment variable. + +:::image type="content" source="./media/tools-options-build-insights.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Build Insights > Trace Collection. The Collect Template Instantion checkbox is selected."::: + +1. Select **OK**. + +> [!Note] +> Enabling Templates view may increase build time due to the extra data collected. Only enable it when you need to analyze template instantiations. + +## Build the project + +Run Build Insights by choosing from the main menu **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project and not for just the few files may be dirty right now. + +:::image type="content" source="./media/build-insights-rebuild-project.png" alt-text="Screenshot of the main menu with Run Build Insights on Selection > Rebuild selected."::: + +When the build finishes, an Event Trace Log (ETL) file opens.The generated name is based on the collection time. + +## Use Templates View to Optimize Build Time + +The Templates view lists all template instantiations that contributed significantly to build time. Columns include the template name, instantiation time, and the file where the instantiation occurred. + +- **Sort by Instantiation Time** to find the templates that take the longest to instantiate. +- **Expand a template** to see which code triggered the instantiation and how much time each instance took. +- **Filter templates** using the search box to focus on specific types or functions. + +If you see that a particular template instantiation dominates build time, consider: +- Refactoring code to reduce the number of instantiations. +- Moving expensive template code out of headers. +- Using explicit instantiation declarations where possible. + +> **Screenshot suggestion:** Insert a screenshot of the Templates view showing a template instantiation with high build time. **Alt-text:** "Screenshot of the Build Insights Templates view highlighting a template instantiation with high build time." + +## Interpreting Results + +- If the Templates view is empty, your build is likely not dominated by template instantiations. +- The view only shows templates that take a significant amount of time to instantiate, to avoid clutter and reduce data collection overhead. +- Collecting template instantiation data increases build time. Disable the feature when not actively analyzing templates. + +## Improving Build Times + +For more strategies on improving build times in template-heavy code, see: +- [Templates View for Build Insights in Visual Studio](https://devblogs.microsoft.com/cppblog/templates-view-for-build-insights-in-visual-studio-2/) +- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/) + +The first article provides an overview of the Templates view and how to use it. The second article dives deeper into template metaprogramming techniques that can reduce build time, with practical examples. + +## Troubleshooting + +- **Templates view does not appear:** Ensure you are using Visual Studio 2022 17.10 or later and that the C++ Build Insights component is installed. Also, make sure Templates view is enabled in the options. +- **No templates listed:** Your project may not have template instantiations that take significant build time, or you may need to build in Release mode with optimizations enabled. +- **Build is much slower with Templates view enabled:** This is expected due to the extra data collection. Disable Templates view when not needed. + +## See also + +- [Build Insights tips and tricks](build-insights-tips.md) +- [Troubleshoot function inlining on build time](build-insights-function-view.md) +- [Build Insights now available in Visual Studio 2022](build-insights-now-available-in-visual-studio-2022.md) +- [Functions View for Build Insights in Visual Studio 2022 17.8](functions-view-for-build-insights-in-visual-studio-2022-17-8.md) +- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/) + +--- + +**Summary of additional important points from the blog post:** +- The Templates view helps identify which template instantiations are most expensive, making it easier to target optimizations. +- The feature is especially useful for codebases that use heavy metaprogramming or generic libraries. +- The blog post provides more advanced examples, such as using SFINAE and type traits, which can be referenced for deeper dives but are not included in this basic walkthrough. +- The performance impact of enabling Templates view is non-trivial; only enable it when needed. +- The Templates view is designed to be familiar to users of the Functions view, with similar UI and workflow. diff --git a/docs/build-insights/tutorials/media/installer-build-insights.png b/docs/build-insights/tutorials/media/installer-build-insights.png new file mode 100644 index 0000000000000000000000000000000000000000..55e1ec52cf8170fe287a23517cb2516a3cef86c0 GIT binary patch literal 6264 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 U=H{aVSR%;E{NnklvzKrG7Xq{XIsgCw literal 0 HcmV?d00001 diff --git a/docs/build-insights/tutorials/media/tools-options-build-insights.png b/docs/build-insights/tutorials/media/tools-options-build-insights.png new file mode 100644 index 0000000000000000000000000000000000000000..b0317d247dab92e41760a0ac2b4f5e48552f9d75 GIT binary patch literal 19725 zcmb@uc{r4R`#(H`5<>COVr`Q|v|#K?pAtePTh@{#+ax=bD*(Z9#y^E&`MtUmh!ZD`dqb1i0t&9C4Vl7Z> z#dCV8Dvl?|hC_(zw0eg5%xo1=1G9pIwtaoF8)pw~kceR5Al_l*c!hsoUPhKT_QNgx_NsG^+~8W zRD)bnJ2zxNKHB25?%Jxc6IhziLed}^q^iS=tIMKK6{0fo5#cRax?x?btY!lZQGHg< z$|uptXc_t%ElLgq%CQMVdX~H>5?2Ta|TGIXJquIN42!HCW9JTllVk z6H=|;fobh+UrHIEN!-1AQuCA`v4dmy)JwHhKzWC&2V5a6; zt8)|noJnucpt5Wz=`O1xO$*zq6DTU*_{-N$0HQThfim#_x zHlpq6`GbsPRozY06^-q%saw;A=f7NDmnfN?mD=S~a5fRiT%P2lhL$ zclH4{IgYEstobrN%dLN?*fFHxd}&$6`*Rz3eZE;P(WY(5e}Asiz>Zpoyk*k>c{fPr6D^I^{JM@*TquHqVfd4QIZ6^NP|y zFP1g`@a>;Rt}o{2)c_C8F)+{8mWT~mnPF7kr|aI_zwYhK8369|jko?mNLa@q?BJ*V z!_8$Hj=Q1!-VHoZ{!kfgSqDPzq#33G!9pmvo*<=XekJJ@!WPa(_F$*> zVFPlF`j@+dg0q>ixY76mx?`KdHN&S7h0yq>1 z=2l4qb08^-6&rQi5LO4)w+nMF-d?_6Pk{cBjdqTFeJKPc)3>A#0u3GnuaBoX`|Zaf zYkLHRt1>KW8+vA6)GQ51wKaGw&0{HTv)2O7&WiU0Go1p?CQtjh>O|0lDFgPiHuFU_ z%UhMwhHs{*O^=bFt9Cutt>o2{xNEcTy-?I`waP#B|Hmb9g9G1yFAP~W)$0lNQ(3PVnR1g;^#j4o_=OL}A$ZM>so_XR13e4Lq+ zg-%X03M%$?R{y)Vu5Uv3!0fRfHcqFA{*~wY-}s!rSNk9&B7!}cpA0F63_X+c*26Xz zb|Wfn#UdFUGe7cUdFlljQvA5}3Y=!SNhq-@*dfLWZ~?Sf6!HNzMeV9b&|EH?dEj{J z2I}Vd|@^lK0E!u-Y*e-7cY<}ME z5v$q2CEL{A3wGz73ZCkvAN zoT$@`N9ak(IosQ}CRRw2@_Vp&X_6jPQ1`lS=k;j3b))<{In~5s6iu!w1_Z^s#fV9Q z`h2em(mzUkD*x+d*^iJZYm1Ib&IE)f_fD!>wfo(ZD#`PFT`m*lHWfX#=Gk>3<>NIJ zd_^E)sp$)X_#?$fi*U?n!64R$f$NOK1=jgkfk(p6lIq`jIr#`x6r)hhQ63+~HfGB3 zP0feuouk&4=H~~Y7(LpcU$m_+wkoS z9Ul>>dvns2j8KtzlRBt`L!xDcLGiImhORh^1cf{urZfoDTJ#l!^b2mNyq2qC{kZH> zri>^bg)~(rk{50;e2*GoO)3r;ui|Yt!O*l3rPD}igk_R10z`w0^jrHMYoKvB@4`Qi z`~3K%I>iLIMasIluh0wd%Chm9!xgM_ zE|`R{2L%5|(znQZCM5Op0bNX=x~5Q698>#O)vek{wV!))rv^br=Ji2)HN(M#TH3`u;C~)3A)@?|`zYlE67eWG;rf zQ2!ll4gU>bFOWeS1|=I}(THvXf+Opvf`OK}9>7!UhA)EG$G$!Rg?lOR!n$V%yiv#E zlLs|Dt*x19dJ$g=?1%$Lmv0Sk!e)}wsnS}sTcyd`3*2Y-jTZf~UA%@kiDA$dY;b1o%R86mE7KB$|EKG~G#ZTY_(7Xrc24wMFQ8YuW|v z0u?(+g*c_ffkpMjNP7xI1uSbT`|sC~PuJaG%4qw=?6eyB2%y&?Qgh+b*ZEgJZ%o;1RM`c@~vobM#^eE zc~V*fH@c?eE)Or^@0BllPj{?EsH;v^MSk;2^&byCK|%0NQyO17c%UL=sJN?QhBl%z zr<4|?;)Lw|wZ5%4^m|9_(|Q?WMa^iAE6oa+neHR+9>3VWT9T%ZIn?$xF`K|htGP4< z#cZug7n+~`NGuu-K7w@hN9dt5T7AP+?7qjdbxNu3dhJf#gDN-WHTvsC4mFRR==Oe# z!rdM8J5?C*MC;qCbKSGm2-Wt~NYpqZ^#jtu8@WO@a5_;qZ8tbgS$b`g-pWL!yG|Fn zqgEANwKkluGKkElfRAep--pK4lNd~s5A75LGlk$k<-pA7QR{=sq8n#Y zFyhc?;`| z<+xCHZ)EL92Pb0!qkF$yRZM$&B~%ZgvHKRLQRLHI|HY*rQ(^0wcgfzAI98Ano+v<{ zUnz87t9a!s+g1g;zTq;k{H|syPCX#2LuBS%4S%S>2-{Xqj1&?uF*1vn%lO@?NuK(m zL#SDZl7HWbU-WVct}hU4ZeqQd8T;ngjsfakQuq4zmfHLWO(6}d4tnNR_Ws!o{Xsvx zpkf-u1nU@oD2BB(lvz|8(f(eB#8~<672LC``>DE|rsFYy_A8^jGW7(a7`-!kfiQcp ze)@)lcXL~5#ZL=b=1x%dp))O=Y@?f#jYOIz>OGW5*`<4@@ z8%jiPLQb<=K)|PSD+PNcPx_4OWoatJz{z#@RoZN)+4!3;s0$r4f zBDdS{vy`LlQQ208uEeKPMK5)z7vABTy02^4WkdB1qK@~vdi<397&kZcWl9epu8gV* zV)$J-NK454fhW{GuK25930E;s3=^B1mGY2((<&IDv9VxQ6y*aSsR!7n(qe>7cK|s| zoOCz)4y|E1qs#-}Zh)O`?tZ^x`oYMVonG>9JbV}W1nbC0gch~2qE~lR-NRU_I{OzF z9gDpGtXwO%;Rhl7)X9Xb99dc7^46_&DZfWTi%0j`^AzD(TM&Z}u3Yr$%iE!?IriCG zLy3{LN3c_5?JRq+rVt@dzjwvo1>bJWx{nz_d0BG2VlcK=D9!vI4~NY)));*+o}P_1 zI_zYH*AHsy){o+2jU4Hj;_Wle-pXQ+IzHej(x00%6?jtQ=MnXiGjlaM1a*1Ja)995 zH~SloboP=wa+^N|S0lxpU-VBzI_}4+qGwKxZ}d4(6_t2CoYEGe;~ML>ZLx(9iGPcI z{`g_AONn69N0h0jp__7dlfbM3;kMV9DSQ#__t}rIyovS$oyO5n*^zT%;j z_X+sWVe%&P0GN$#hxjH_*|+)Y=Ar0)0KlKw`Lzz502$#U{T;)7qeFyW5TPXE`t}{L#_JO$hz) z_T4zmE~;(79trv5pF7`Z;xoE$s|h}sys6(FhG2Zg>n(<}5gsgcMgk4))a|UKwmF=O z!r(}KzzEp$fqstyO+5qC%$SU46F+X-Jm~X(k?{Nh?vAF)vZ~>V8oT!Xn8RL$CBI0#r!8|X%u+uw6JJ=%H;8ub|z?UqTy&S6BC?Tp5HYOf(P=UzI zLe+;Rt_-OYG9#Rxp--M?+AdcN8V0=kRD;OZ3+WoVRwxHjKFqTU3zQ_mIoFLf+iV_Y z_uP@t41$N&iXk4D7ox5ix7%dtQDaeLA@(ln`EE(DT~nZmYoK#tpzJ(@(KgH(G9~x= z6zZXA^@=D7$$mZXx=g^rH+2LlJBG@JA3EYp)Vvw8gXCQ(NVoC@ec0nJL|16*tWXb_ zsGV*LdOw)ZaD61SO#0>S&aN$+D{SJnZKpNlW;i>hec4GtzVPSB#~mKhcE?bApJi@k z`Q+)-DWCs&C=@eRVdz??h;9DF`DPq6B;KCCq&Q0eY%sdAO_l`JSTLpbRK`>HbT2UKAF+j>t7-n$b4d=%?1;G&M*5>d^hvE{>F?CgH9gfg z1bF8VqsBXq8b0RBs1zYe5FT-|pAiqenGI>JzEi)4A#P-zRz)-~35XAn;Z%U5=PJZV zrkp3fw|HO-y2|SH<9#n*`c&sBA<)*C`Ui(;Ht5Ndb&Be9kfngWCz4B_j-R}oEfLyZ z)s!79?j1HFjHuJwIC5toi~1g4sDo}WSgJ6zY!xRZ(<6cA)NbU4@W4LOnDa$%BRGBP zbf(~nGFX4Fs!~tbJOZEYeGj~zap-~vemvtK zrCIB)k>HUB0W9RRmsON&cl~@*8Rf2h+@0*fgf;C++S9O1E#@>ED*N&5_5u z-y6rwqEoweE7-)(D-GrsQ8CY32gp#wddX5r54YP9N04WJoV)@_Xf2ueccB%}N8 z*D?-IJ^FIbZc_fz^Pcshh66WaWvh0Qy2B1DO(VoIDtYSRGAqSkc{R{3>KiZ74_as=lbT2-Liw~;_> zC=&!FV578zX?89)$P45b^?mRl*76K6cOo1=>mE0?D~17-$S6V1&tA|D`VcR=`9E4DKr44p`^gE71oW(##z!WeA(%cVZ-O*y^JG8wdyJ=koTy9|z` zKySnwG!F~TCO_XBueTO#!q#Fu*UR_C`|Iq7=}=#Z0@w%!osQ5Jpr49i#jJ1b0fZF+ zT5+HGHe!3t1TPn_f5FwEXCiI4)fB7p3W@!h_YYi{-r-GCNPO+-nL@6XKfa>b%NpsD zSsMf+Zv{w8jGy@)a1jA@N)V4<3qWY7fFo~l*};S|K*N^)0uKro^iG9Hdk#O76`?bw z?%kYOkm6Hs(mcBS+}nCR*kwSP|JG@XsP1Q&y>uKAK`!?fptnBVBq@LAgGZ{IpEyG2 z?ABzB?B4b4x8@Hm#GOij7yHE2*$NZjx>W0OyqZx1(bGX$iray(=%|(PRH`h=Ly-3V zyJs5T`)1>5=Ax zN>2yIRm83a?R{+Dji~xMu9$ni!IE%xvFr{^iOISdzbJ#*&b4 zqRwmFXG&ZH2bb%*dkXLIGC;Dg9lsT%2H0=7AwX?C?H__R+I47YnAKK{nuY$#&3fm( zBnXfbNdY2MznB)BdRgV@a9)#AZ%8!(jEZftnn(kN^t7ZXxM|nnJE&Ek;z-> zOJ`R!^C}m^rTCXARGQWYKNTP2I;# zHlJInZ0qc*{~4a^4-YU$dPugnlFbYh6yGbZi-;CEUqIfElAWKv%H|yN`S*cXQp8#u zPF^kbIf)XDVtt;U;s6PxR5{dkI)`v{YFK`Uz0#t88j&h6o7;@aByiOdv8Ty&v}$A# z>V&Vn{jz}L!E~C5!)J_yTq-?{pAl*harXJc?joo(dO7oKe*nFtWUx6%t^$cSMnd^n z5@ktSXs`KkPU)HD-^usw_Tk%$ujy3{9&I`nzw?@7RpPXMt=T&KP44jfL{vsBBI>#h zV4EF38n=e7obOuAyzGjAO3E0GLXCwNo?0G&A2_8V!ylXgL{y!Lz-9 z2}M1#hT34G$n^E+iLfvAYs|rw`4*6K1rP03s+6e>B=Ay|tWIG^Zwq^V!B#+~9bRC~ zdeSp`2y4R!*Yl9*a?67Uoo)2cdP>8gs_=3Pya9J?vVx+QVU-cO=zn^}c@&N>epTujQ8&;qBSaVtbtSyeW8w@39c)8 zNpn8c{4wlno>F&{aE0SHB=tntdft_^OFL4VYag6Xoo2OnqfCF9!BqwD$a_+wCP-C+nJHj zo7CNyW6!AMOr;%%0Zq3YF#guy#fi@9o97!j&TBo+>BLnE#JtWY1?==r$|@UwH)J4b z;rUNpnSmv*a&@Q3057rnGIGDv{Z+<@2l{akQ!Jy0m$M)RA*ak0Im@;eOF@@qj`K6! zmO-|Vs&MFy;qwCVmLHRcwkyFGGB1+-i=`a1!>pd#OCF4{+=sWf9$pIlKD|?4L1?yi zrU~umNrZB({i+Ap$)M!*yZdsPM;znjjBc@lO?;AaviV0fUF!BXY{T0{TNsub=uSff znS%8Laz>MVlbLsCsRZ+r?wp*29pp7F=Pz1+v#{UPB#AGYQ`! z^Tg%XgShyoC{$}r!cC22vzIkL)IqYfM~ULt*t1oL5v!e~9+RljlQc|12+GRxk@_d)B9Y2VH0D&e+MQ{l6hG_kUXfUdLQ*$RJx$yTMtDD< z+Ty*6*#dI-IEgf}m*ZJgUew%&Red$P>H|7$nZ1S8G^+RVMa_1TGqwr+`?a+wFFW{n zsw-6Y6ET8LJ4s~_P#y!eR=^Z5gC~guzee+ix}PuofPgxH?0tv$lTGOW+rF6`;A#f|YI5lmXxsl57>;aV z)zQ#(Kfa%j<`3SwSwyhS?zZzc5E9OLuOV$_0{2iLCQLag0NSh_X3_pC8G5|}b6sMB zd+MVae%5T1c%cNs)HmpAwsVhlzVn1;2ec>HNoKHb?T2InV0Ms3YG!)X~>_|2{}P+^ZRwUpUe4(ZYe=2r~7b$#i+*iq5o6 zK4Idj10hV^riIC#HscCFSpbiw?ED|4=^1Ea?1^f-DwfxipF2tadnW&pivHiG`=65l zJqh-;>W%djOUi-_b(*Dz_f`DXuhxNbrwr3*|D^KO;`zk) z%;NcnuP@^?BAzbJA6ZCU<7)=J-AvknI_;tfiTT~v?fbw^6^XCal=Jg60I&beKmWXA z;``4b^As0AtvWNSQRVDJIhF83>Pg2QY~ZiQ3e(YR$7L#G_*jc+6&cya_X1Yx{r}pw z#za3&jafhJ`>ENi>CajXwHFf2mC~u$;VHx6in9`+o?Fp*ITg zg}QWdgN}bD_`kA(R|)_`TlfCVv|jS(*k5{*cGEW|ju^LRgj z7?-(`O{ll#mO!2U30|M+FY}MaOqbM|Wc!o>UL}^Lb|K!#eWK`5)m~C^O31Qsqiz`G z_5C-g)cU-)n>Tz$=weqLxUMG|-*#MdX<<1#;ox;5C-Y?nVTxNQ1+2{aHL6eCKKZESeHtUB4W8eQ7Cbx&W#_W%eLs`!w$203}LKm(v^ix$~WS zCRJTlV*Idqzs2pR_v{D8(w(J0l#v(mt=ex^g&{FG!HE@DEkdNsZ1dbyeMqFvuV8Ky zHT{~z4>Tkef3Ok6SvIC!D?Mh~6!N(uV%FuEtdaWXTp7|?*F%IBo2RCX56#LL{r*+A zbK#fjaI+qS_&TVvp{woH;g#EIFH8I6kL7t!QE%!+d5DyZ;Trq?zO?};oq47{MGm zIEUZAQg)10{e91_LTBl>jE_emzSdLJ8#pg#h>sPZ7a#{DTxp+=-{c~ zc2t-d4J|Jdu!+b}^H$lgTUif(;0%o)v=SsxMf?KP5fw_4aREn;$Qu4 z=fj6O)Zv`UpG&u?&)d2c>i`jw`7`T|B7PGj0r&GO7hv_s^u>Mm9%=!n`G_%b&rdfc zX2HiEYmpc)AH4*CL6-C{x8Zco-#J!uT|;NCe)NL@UN>$i%+5D2^WuG9t0++~1I>pt z;Cr}pd?x%QCd$fzRyP)PaB5`hUi=#8Qq=CS!SX1};a`wq98GBc0J?8|-|5t7? z;MiOp?J$-XetHv~{=4zu5CYZh(>ILiPyM4VGT2)%s+ycbS zL?vuHi#JhyROq%v-C^hn9Dd&E ztPtk>DB)n3(+I)O!J#{BWTfT|^=aJ6*FUr3=JRzu6t^5jQgz(p-EcTrC0&CxNhU9M zmFQwOrfe`7-T(%9`}4e)xSAa))^#;Uc}wq1sZ5g<5kQlWa~;ZCK6lkjNs9Fq*9HpY zf8WDg`OX^mjxEWh*sMsJMd$?%=CI=Lx9Kg`7Em({nhOHF^gIU3YigrVbD6SLI0MW& zw}^8;czuP61m=muESyN%(NBPQ?aH;iC=_m;d9C7@bx14Y1E-lFh?uTJOL#JJe3!a| z0LnV4|MEELiNXZi;G2DF7gc=qiKr`;UbJkUC zs_4U8>*`i;@qtU>_lRm?nj(lolw5%YN+hSWW4>#t!0DhKGLG;Xu-eqPfPw)-vR3mf z@vxfI6OglC>o?6!cwrZpfr!fWv3~o^OjP4;zdf5Xj7Yh7H3qBbCQW|cLsa2x%PvGc z-`d6!zcEuYux2=ZDA(KeE&9Bfb7DuNr%E?aH?jp$wgww>aq=j->E|b4mJK<+wwbiq zB!WcE`uxIodC?xl_XZ(4O@-~&v%!(daYuRFYSi91yh?g-7FxILfLHJOpuGm!g2+7H zKseHbU`l@Fd?LKAzW&1?q=J@hx}??JOu*Mv6J2ujca_~y_V)WK^P83udur`JtP~S)q^@kLc0V9xwgZR?0__)?tKeDn-WXrQwgv7v7r=$y zZS;u;BCmhl7?3NoJFfrrJ1?k+opw1PHwOvYMeNl&w_2PfK}1hIrFkclH#rl5XFi8|HFEz`h`jkcdF?2>L#-_^`Bce%vI1FSEU zgX5`}aL=}yx8s4GblMfYxukyx((jMO->-lCZ6FKsS8mvYlGFqp>Ga34HUYct;?^ez5 zf1yjOW)4SWM^3C0+wO1?q!cJ*`QEmu#awH`qzC_IVj+K9_b@E7`{h}X?%&y9R*k;_ zrU5#x>PsSCtmAfd2k8W4HS^Z)-?X0cFzVDS*Xf@Kh&G5EQ@iwi9rAjxL;AO?!m!4k z@P(Ggfrx(+%x%J8wBv7sOq1e){krW;94M+4xm%9v$w48*KKuwl%c>#QEvH}0Z!A8m zY4~AO*W;khdbF}A!=Bd|_W!m@sB9A4hpl?DIr(2ow$WpD@!q!dcacpiM32dG${T1s z*3p1YUbg@DIecKW`1h7N@e%KX*n=mIVTpm=X6|Z|DG5MC3KZ4J0rj52J;*Us4}5xxpm&5^aLUO7ezJ>&C| zDW6>lEt%e{l#9%lEo@%`lDB-UKl3>4YMz$TGjsdfv1QTpO$q(8Tu$NH5YM6qk#jw+ zD=6Ba=)vEE@&Ksn|5PGMzj7ccrA{;NkX4={nru>AK->5$M%Gla?c+d2)2thO5H~PWkP47n}>Fg2Dwms50qH*XYRgS1j~Aw z#9mh8M&!UR<`c)`D8J3IQ$Qf0PnNryDtKY%*YVE$LLkQPGk+@yk94_V2SCdi?K-B} zK0y58@e6>?L?hEWJJ^+-KoQOu*;QP4tNV_4J*tCRa%ac(t!GbVyciTb*;KBNy}|Wc zCze5~x%P5}z9&z9{)GM8b-C}zh(+V_?Fk{$t!kuXy8wLxNDTo67Mmi9Ay)toF%m-q zshEea9}j9IwC#)YdJw>)%ic5+(BE7Et}=8<@1!eSH#G*j(mki}$w0^H0mJ`h%IHrw zNU)q$QgX?9^O_PB9Qf;+OBFs6LrW#9!ZE@Pd8of>08tA>$Q12x=v;7Y(9vIboYx7lICnw+Slxswf z)0Wj$+-d6@$xC~`KpM5d@TpAxoCxl!-rEyEhrE{d(~-@nFbQ(&n0T1W#5UdVa+=d^%CM)z@@ zxT|4t(p4?~ul$FID!0BT)ZEona|)Ba4{QIfby=-E;nv*_8JLrmFVohq|1t-9?}Iqk z&I5OmmdNi9y|eDEQ@E}xns1H^?|KZAJT~#Sb2BtUi_C&`m(y(8cSTz)gH5;JRdW5&Esc zn`*%BqQ}1$mNFJ1M0+3T=0J#6KpGyrYn7VJ*K)0(vHC^k%{=Ygq`%=R6?Ahx1gv3M21dzxnE| z5*@AOm;d1HLYP&BovW7o88lHOC-K*4{Y%x;ZJv5vPo4kYl&DwyU^MIPk1j}QdkU=V zeb8`672;)k;j_rIULkmJD|derK-*R;0Y&>CC-H3rDFu0BasI4QC_#W;Yq9VU8>Vua zmun{`;PnKZxg$XzabhG7q51DEoc1kF&LBK9C^K>H_3~YJZjS(lK}q+ZNReg@yr0+* z51#664lv%A@G5uj&9yEG&WzdFo$JFVvwl|7Y{Ottppe0)=T=_g@vY;K%RgsCjl`$5 z*pwWkeRzX^r!%_+y2Zrx#=oR}Esd*-izF-z@9cE2dTb({(EUs=q07ZLo2FweiMb_U zrumbz%*zngty*Q@ItCw6!RIaDL|$_DgFP|_f_8&<6hWBmBfT{@H(il$lO|PVCbPh$ zMD*hxS$jtv;UC7B3^3XYT?-|{l@I=l&(SE}iZ^Sr)S&`BwkFIrp{R~I8a(P*?8v-Ig73ji|8 zdxKtkxXIM^5LSkQ^S{Uoe@DBD;8`P;WA1&M1u#T62q_Gtn!-koJYLDOUM@EI>)Xt1BIH%VBJikg{A{q z`tM-(Mb!eA{B0+b2JQH1KmNW&kpP)VG7 zzQIno$d6NqST~~9q*t|gM~`6Gkinj}t%SvtE#r)LUS-V-I3ZK+Rz#r4038{++p@7l z+;7$e)m}J=cN!K&B&PvE!uvRdo3WGLY&=w&1ZNy|l!E_~@VP;ukjy13t;a9oLtCAH zgr%$%S$XRy^WzmS*qXOnk*{{)->1deA5M;8-trAsj&NcROz8YUFv_Uoq0x$~O-WU| zA$}qcpFb|LTA11T{CvB-BnP#XSJ^)+99hkxOJ_~5B> zlfbc_)%Sqyh@X;Vvq6ks5L5<2$ywNx+zq)G=&x3aLp)YQf*xKhbq@9IsTDn16+ zO=!bfMu@fvag9X*+j>82vwSyAHMFj9Wc@ZOtm*ODu$xWR1~rrFh3`cx`(5)27YFMU zcfCvGTKg~404fh#pe`~->OAEhSq0CWdMJBMDOc9E^8Ct0JZk5GmC;pNu4^UtG*Hi= z1Lw;9VQwewJdwR`n@uPu*5dg-=>0)(U?UGbcAUaPwuKak1V((o72m}p22U6F@iMrw z6@XL!x54`VrYD9xtEy2eraZbICb+%}P{T+jE!2=sOJT`Xn~ z$-mgoAV=qqpQu_gD?&WePdIR@cg^IkJR!1?;b{iNh!uw(2@7ug51ZAoKeCEP#@U)xDJp4>WUd2B?Vm8xu zxRn3$)$p@B&KVCkxGc%&a0Lv2cst4Q{ti-sO%I@1Zkqr*-K^OGUe>U=--X+ce+s4l znUw!l1xvcL#iZ#TDcL z@fV<+7HyuI$2)E1pxyOn3q4j@X2zLNLqOSA+VzjKS@ZC-Z()FVV&G@t z(5>S#yYn>9?KO?B)a^J7J@Ror8L|t2QmxwDzDU=xN)DCwa;LD-!Rf5U)yprCHY%O- zI1BvXu_fb@VrmIqK<0D(A9^?4Y-!9YpBh$peO*i?o34GE*SlQ=d8^+<0=DiVBi<`iKs8XOw+$vCPdjQ zn*X@y=8|Olz6Iho;v!xhc+Ej#)22%Yviw{d2I>9#X2m~m1K4c&|Ga@o?!-(Dph}-wSxbM9f}e(B?ZsCYOr2A#C`$Mh*?mJi(ac zIGv!5gyUD|LNK4VJJqoeD_x2B^o`Z3#B_0wshCiKEQ5^|JkC_L;pRw0A|cXxVW0tc zN5H&y*xXP}*R(E|F)g-4agY|7s_PT=VYI4omj{$}=6Wg)IRqQ156)e^<}D@(yo;fy zYfoBy{mvw!yN|DLiqrJb&GGM0N`+7Dru0BmQyO=;GX}nzQldCBWC|=Ev;n-=ByDpK zt=d-ifXS}BPzl85%6pl?$1MIogE$AfTegf6 znp(qN5KULr4_0iLXO`E@x3uC$FxA8L5w}htns01nbyJ!Q!jLsS@?mDnFcQOkVJ?DF z1?>8`T~)(2aJYrm3?n#XFmPSmr!MYN!8VVs-KPj0&55Evv3nH4yXt7;?5F>tDy(S` zEVP?sLG)bz2~SPOutsz!T@hbPrD);!`qWvx#HK~&s6UY)$rm}h>qj=%%{5;`pgSGH zR+@1#^Kt$=Nyyc%6v{#(vGlkSE&Zz?9f-}Ep;e6$RIZT~+r0y+o>}{-{BF=!YzCzk zwOn0Pn-5+Win`8>q(7mQn%2_V?cagqQ0S`P2Hvk;!R#w{$R zjdoop!ExigW*<+gg4a)$*%*>%8KMu$Y^y=4s9Td}&+)^Qsb%>yoCc!F1bS!&$FnwU zleuwwrMc@g;=!^g{FBJyDPFd=DCFWztz)$*bBT@GlM3OX=RPb8R$Z2cH_SVb5y#rdNCm6IYQxs%Rm zl{_1R1!5VkIQ~5Ak($zK0Nv4#flW;y(5~UeEup#k{7zoOPb9+DwCLZBjGdUDRFyA2 zat6jKFwAsai{6WSC&zlXGO?lJX57sKtBeYRsT#5l_aag{Ho@++9AL<_nwahMy3HzY zkg^^RjI)id!zEZRWx;4TA1j-iA~H<`5%qaixlS%RZ#iOve1b8RnQC%oTUprbm^=e* z(IZ6Xu6m$|$zGDTtR`?$jC)IrC=oUQW20?$&9y#bPnn7$Pi;^Q^n9J_E=3ksC?G-` zv-Bb=f#u3*Q9`8w??eJhhk*q<_!^%L!7TSTw^5@4+q0sk8?GEN)I&MK@T;?Hs+k+B zz%P$aQE@M+6}|09136TqDg8x{tKQ+M=LGZrXZJX4f4x}z?9R^OrPnK^KxOX>SB??RmT3IlwJtADZQl)W2#38pCiVKD1%_9KGMbQpxANKO=a# z-&8ixX-XS5%T+#^XtCaVLO=7KDHs1d65rpEpHd6lx9O!0(wY&UarJJU&d-=v_f^+> z=iUE&r}+F)ewDNTzbv;m1=b4v-ps(cHlQ+%Ew}sse~tfddhTVAoiO{4=kx3B>L%36 z{bA;}Nsz1ikys2Y|1N<}{bDF_4!f6H82jlbup$zDUb=GL&CiFp^^fpx>YqHtZRPrj z{Znl!Kc&dL`dI?p>d%nyPo>;jZMux!)3^V><^LCZ{yFDs?5cF&F;e`SW=E=Su>bjF z^0SNX^1b1Y-UE}A#hL%7_y6&J^Wx&-;_VwZZp?lC`Zf2%ZMXBHrT+gp|9_9bzQ1qt znTx-!&9CL=cKa{OX!iHNu(j*||IhN48(;LhC|M|GwfbE1lQ-{co?AcLegALXoc*fp m-g47p^nThz*G_*m^S}JL_-VVC*8O+@@{FgepUXO@geCy&e>gn= literal 0 HcmV?d00001 From d379660708d70d370553938d5ac4403d68aff62f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 11 Jul 2025 17:11:45 -0700 Subject: [PATCH 0352/1799] draft work --- docs/build-insights/toc.yml | 2 +- .../tutorials/build-insights-template-view.md | 148 +++++++++++++----- .../media/build-insights-rebuild-project.png | Bin 22035 -> 10601 bytes .../media/templates-view-before-fix.png | Bin 0 -> 66563 bytes 4 files changed, 111 insertions(+), 39 deletions(-) create mode 100644 docs/build-insights/tutorials/media/templates-view-before-fix.png diff --git a/docs/build-insights/toc.yml b/docs/build-insights/toc.yml index 149a4a7f0fe..5641215a9c8 100644 --- a/docs/build-insights/toc.yml +++ b/docs/build-insights/toc.yml @@ -8,7 +8,7 @@ items: items: - name: "Troubleshoot function inlining on build time" href: ../build-insights/tutorials/build-insights-function-view.md - - name: "Analyze template instantiations to optimize build time" + - name: "Troubleshoot template instantiation impact on build time" href: ../build-insights/tutorials/build-insights-template-view.md - name: "Troubleshoot header file impact on build time" href: ../build-insights/tutorials/build-insights-included-files-view.md diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index d8124a8578b..1c46be7da1d 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -7,15 +7,17 @@ ms.topic: troubleshooting-general --- # Troubleshoot template instantiation impact on build time -Use Build Insights **Templates** view to analyze the impact of template instantiations on build time in your C++ projects. This feature is especially useful for projects that make heavy use of templates, such as those using template metaprogramming or large generic libraries. +Use Build Insights **Templates** view to analyze the impact of template instantiations on C++ build time. This feature is especially useful for projects that make heavy use of templates, such as those using template metaprogramming or large generic libraries. + +Templates view is designed to be familiar to users of the [Functions view](build-insights-function-view.md), with similar UI and workflow. ## Prerequisites - Visual Studio 2022 version 17.10 or later. -- The **C++ Build Insights** component must be installed. It's enabled by default if you install either the Desktop development with C++ workload or the Game development with C++ workload. You can ensure that it is installed by following these steps: +- The **C++ Build Insights** component must be installed. It's installed as part of either the Desktop development with C++ workload or the Game development with C++ workload. You can ensure that it is installed by following these steps: 1. Open the Visual Studio Installer. - 1. Modify your Visual Studio installation. - 1. Under the **Individual components** tab, search for and select **C++ Build Insights**. + 1. Choose to modify your Visual Studio installation. + 1. Under the **Individual components** tab, search for and then select **C++ Build Insights**. :::image type="complex" source="./media/installer-build-insights.png" alt-text="Screenshot of the Visual Studio Installer":::The search box contains C++ build insights. The item C++ Build Insights is visible and selected.":::image-end::: 1. Click **Modify** to install the component. @@ -23,17 +25,16 @@ Use Build Insights **Templates** view to analyze the impact of template instanti Build Insights, integrated into Visual Studio, helps you optimize your build times--especially for large projects like AAA games. Build Insights provides analytics such as **Templates** view, which helps diagnose expensive template instantiations during build time. It displays the time it takes to instantiate each template and shows which template instantiations add the most to your build time. -For optimized builds, the time spent on template instantiation contributes significantly to the total build time. In general, C++ template instantiation happens quickly. In exceptional cases, some template instantiations can become complex enough to noticeably slow down your builds. +For optimized builds, the time spent on template instantiation contributes significantly to the total build time. In general, C++ template instantiation happens quickly. In exceptional cases, some template instantiations can noticeably slow down your builds. In this article, learn how to use the Build Insights **Templates** view to find template instantiation bottlenecks in your build. -To try out Build Insights Templates view, follow along to create a project, set the build options, do a build, and analyze the results. +Follow along to create a project that demonstrates template instantiation, run Build Insights to gather template instantiation times, and analyze the results. -## Create a test project +## Create a template test project 1. Open Visual Studio and create a new **C++ Console App** project and name it `TemplateAnalysis`. -1. Create a header file called `Templates.h`. -1. Replace the contents of the `Templates.h` file with the following code: +1. Create a header file called `Templates.h` and replace its contents with the following code: ```cpp #pragma once @@ -64,8 +65,7 @@ To try out Build Insights Templates view, follow along to create a project, set } ``` -1. Create a source file called `LargeValue.cpp` -1. Replace the contents of the `LargeValue.cpp` file with the following code: +1. Create a source file called `LargeValue.cpp` and replace its contents with the following code: ```cpp #include "Templates.h" @@ -96,52 +96,127 @@ To try out Build Insights Templates view, follow along to create a project, set } ``` -1. ## Enable template instantiation data collection +## Enable build time data collection Template instantiation time collection is off by default to minimize build overhead. To enable it: 1. In Visual Studio, go to **Tools** > **Options**. -1. In the Options dialog, expand **Build Insights** in the left navigation. +1. In the **Options** dialog, expand **Build Insights** in the left navigation. 1. Select **Collect Template Instantiation**. -1. You can also choose where to save the report by selecting **Store Build Insights reports in this directory:** and specifying a directory. By default, it's saved in the folder pointed to by the Windows `TEMP` environment variable. +1. You can also choose where to save the report by selecting **Store Build Insights reports in this directory** and specifying a directory. By default, it's saved in the folder pointed to by the Windows `TEMP` environment variable. +1. Select **OK**. :::image type="content" source="./media/tools-options-build-insights.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Build Insights > Trace Collection. The Collect Template Instantion checkbox is selected."::: -1. Select **OK**. - > [!Note] -> Enabling Templates view may increase build time due to the extra data collected. Only enable it when you need to analyze template instantiations. +> Collecting template instantiation times may increase build time due to the extra data collected. Only enable it when you want to analyze template instantiation bottlenecks. -## Build the project +## Run Build Insights to get template instantiation times -Run Build Insights by choosing from the main menu **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project and not for just the few files may be dirty right now. +From the main menu, select **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project. :::image type="content" source="./media/build-insights-rebuild-project.png" alt-text="Screenshot of the main menu with Run Build Insights on Selection > Rebuild selected."::: When the build finishes, an Event Trace Log (ETL) file opens.The generated name is based on the collection time. -## Use Templates View to Optimize Build Time +## Use Templates view to optimize build time + +The **Templates** view lists the template instantiations that contributed significantly to build time. Columns provide information about: + +The **Time [sec, %]** column shows how long it took to instantiate each template in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among template instantiations based on their use of parallel compiler threads. + +The **Specialization Name** column shows the specific template instantiation, including the template arguments that were used. This helps you identify which template specializations are most expensive. + +The **Translation Unit** column shows which source file caused this template instantiation. Multiple files can cause the same template instantiation if they include the same header with the template definition. + +The **Instantiation File Path** column shows where in your source code the template instantiation happens. This helps you locate the exact line of code responsible for the expensive instantiation. + +The view only shows instantiations whose contribution exceeds a certain threshold. If you don't see anything in the **Templates** view, it means the build time isn't dominated by template instantiations. + +:::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations."::: +The Templates view shows two template instantiations of struct S3 taking most (79.4480%) of the build time. The Translation Unit column shows that both LargeValue.cpp and SmallValue.cpp are affected. +:::image-end::: + +- Sort by **Time** to find the templates that take the longest to instantiate. +- Expand a template to see its various instantiations and where they happened. +- Use the search box to focus on specific templates. + +## Improve build time by optimizing template instantiations + +In our example, we can see that two template instantiations of `S3` are taking 83% of the entire build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` are causing this template instantiation to be included in the build. + +Since the **Instantiation File Path** and the **Specialization Name** are the same for both entries, we can derive that there's one expensive template instantiation affecting both of our source files. This explains why the time of each of the two template instantiations are about equal. By including `Templates.h` in both source files, we are causing one template instantiation to add significant time to our build. + +From the **Specialization Name** column, we can see that the expensive instantiation is `S3>`, which corresponds to this code in `Templates.h`: + +```cpp +inline size_t LargeValue() +{ + + return sizeof(S3>); +}; +``` + +There are three main ways to decrease the cost of template instantiations: + +### Remove unused templates + +Review the template in question and determine if it's being used. If it's not being used, the easiest solution is to remove the function or template. In our example, `LargeValue()` is being used by `LargeValue.cpp`, so we cannot remove it. + +You can also consider removing include directives that bring in unnecessary template instantiations. It's easy to forget to remove header files when you're no longer using them, and unused includes can cause significant impact on build time. + +### Optimize the template implementation + +Look at the template instantiation and determine if there is a way to optimize the code. Some optimization techniques include: + +- Reducing the complexity of template metaprogramming +- Using simpler template patterns +- Avoiding recursive template instantiation patterns that lead to exponential growth +- Using `if constexpr` instead of SFINAE where possible + +For more advanced template optimization techniques, see [Build Throughput Series: More Efficient Template Metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/), which provides detailed examples of reducing template instantiation overhead. + +### Move template instantiations to source files -The Templates view lists all template instantiations that contributed significantly to build time. Columns include the template name, instantiation time, and the file where the instantiation occurred. +For our purposes, let's assume that we need the template instantiation as-is. We can rely on the third approach: moving the definition that causes the expensive template instantiation to a source file. -- **Sort by Instantiation Time** to find the templates that take the longest to instantiate. -- **Expand a template** to see which code triggered the instantiation and how much time each instance took. -- **Filter templates** using the search box to focus on specific types or functions. +Since `LargeValue.cpp` is the only source file that calls `LargeValue()`, we can move the definition to `LargeValue.cpp`. This prevents the template instantiation from happening in every translation unit that includes `Templates.h`. -If you see that a particular template instantiation dominates build time, consider: -- Refactoring code to reduce the number of instantiations. -- Moving expensive template code out of headers. -- Using explicit instantiation declarations where possible. +To do this, remove the current definition of `LargeValue()` from `Templates.h` and replace it with a declaration: -> **Screenshot suggestion:** Insert a screenshot of the Templates view showing a template instantiation with high build time. **Alt-text:** "Screenshot of the Build Insights Templates view highlighting a template instantiation with high build time." +```cpp +size_t LargeValue(); +``` -## Interpreting Results +Then, inside `LargeValue.cpp` add the definition: -- If the Templates view is empty, your build is likely not dominated by template instantiations. -- The view only shows templates that take a significant amount of time to instantiate, to avoid clutter and reduce data collection overhead. -- Collecting template instantiation data increases build time. Disable the feature when not actively analyzing templates. +```cpp +size_t LargeValue() +{ + return sizeof(S3>); +} +``` -## Improving Build Times +Now, when you rebuild the project and run Build Insights again, you should see that the expensive template instantiation is no longer listed in the **Templates** view. The build time should also decrease significantly. + +:::image type="complex" source="./media/templates-view-after-fix.png" alt-text="Screenshot of the Build Insights Templates view after optimization showing reduced template instantiation time."::: + +The Templates view now shows only one instantiation of S3 instead of two, and the total build time has been significantly reduced. + +:::image-end::: + +The build time has significantly decreased. While the template instantiation of `S3` is still contributing to the build time, we've been able to roughly halve the total time by only including necessary template instantiations. You can see the count of `S3` instantiations is now 1 instead of 2. + +This technique scales well to larger projects. If multiple files included `Templates.h`, each of those files would have added the instantiation time of `LargeValue()` to the total build time. By moving the definition of `LargeValue()` to a dedicated source file, we minimize our build time. + +## Understanding Templates view results + +When interpreting Templates view results, keep these points in mind: + +- **Empty view**: If nothing shows up in the Templates view, it means your build time is not dominated by template instantiations. This is actually good news - your templates are not a build bottleneck. +- **Duplicate instantiations**: The same template instantiation appearing multiple times with different translation units indicates that multiple source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. +- **Threshold filtering**: The view only shows instantiations whose contribution exceeds a certain threshold to avoid noise from trivial instantiations. +- **Time aggregation**: The time shown represents the total time spent on that specific template instantiation, including any nested instantiations it may trigger. For more strategies on improving build times in template-heavy code, see: - [Templates View for Build Insights in Visual Studio](https://devblogs.microsoft.com/cppblog/templates-view-for-build-insights-in-visual-studio-2/) @@ -166,8 +241,5 @@ The first article provides an overview of the Templates view and how to use it. --- **Summary of additional important points from the blog post:** -- The Templates view helps identify which template instantiations are most expensive, making it easier to target optimizations. -- The feature is especially useful for codebases that use heavy metaprogramming or generic libraries. - The blog post provides more advanced examples, such as using SFINAE and type traits, which can be referenced for deeper dives but are not included in this basic walkthrough. -- The performance impact of enabling Templates view is non-trivial; only enable it when needed. -- The Templates view is designed to be familiar to users of the Functions view, with similar UI and workflow. + diff --git a/docs/build-insights/tutorials/media/build-insights-rebuild-project.png b/docs/build-insights/tutorials/media/build-insights-rebuild-project.png index 63ceed7705e216cfb8e210fd762c7050fce28e2c..fcd96f050e79b8a1bdcf3bf251ef50f84ecd4243 100644 GIT binary patch literal 10601 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%0A=g^ABe%Nzze8% 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 SI`*{(>1S37 zSc7R{Ui2Fk1zFf5M7ljO^0AKJ_{GuyKI}F*Sk(P?qwpW6!!st=A}YG|gv)GAJ3B(g z>7~JMKE6KOeeFw=D3bJ#_V0?rGEq>|U%fhOCt7^G ztYXy;vF};{<_+X8V@f;X_Ri!%Xp6vnz5UoK*L=XnYcxm0D%cHkEwGEn=6ey+RH7BC z@xcM&P1LPLgl-K@)F|^uwPAr#ZD@OGHlA_Z$8MZ})I`Udb5oZ4*y$cyU6DZlQdH4T ztPkZlB)vWd*{nR@)$t{HK1L-xx+~gX0ft!|W0vb~p}v_@iLeo?mj(w z7(0@2r8%XW+R(hfp=9B@&=BeS;ghzzhmw2maprC?n!-yCArh?8?PaWk zuuj2n2@o#pc5bU_WP%a3hCdD#Lk&hAA|=R;_#9ELD@1NshHtwy+287a&(V5a)5(-(p<=iy}nrhdG9oFy>qP+xv8PS0;|JMaDiXG zU}~e#BZ{7hB=_^n_7HAXaRBgRLWOctdA^yDV09rviU3TkL5`zDZ zM|{}_^uS;^`=)nlgt=XL?Ae99mQ&utvj)Jqxb+jn&#o!dcw2wh97^ZS4BlDa5I>hp zyuLQnjeRoZlr0e+&aO=0cFypK`WOq)i1djE7jV>}rxcgh>^ESEs2n1OtTgbaL^#t- z!I|x+8_2HJ)zu<82Nwh4ipK-M0{#*T7zb0uAI{e1|5%kdxA_{)GyScJVEu|)+@K9i zAo&0|X1ew0C=bsu4(_(5U#_qI&jiw>i7DdHbru#C2S&dUbSG-qQNI7%^HMIF#c_w{ znOK0;PXSlYWdi;JA{jl?%%;Gnst9tLOddmY;uYTNg(=u~nd_{=6ADnHPnEg&se&Un zPR;sM`76;#T~I16t^gGFpE8qb6LdR&*A|xzn}wZnx*MD96U^|o}khaEkTv~og4CY8cyoDo#ZwMFaEzZ{??y*%ugaI!PAlJjK}h(s8~a*>=pyxYcNK(M8@AkG52j z=Xyi9LXX$Oh3a;y!xT&e>c+zE85jnxUbs9@TnA{S8anclqc~BOWAB6z_(n)D0Fd81 z;oxn#>#g$RXs?v@{Mw6;VTs>mK*6(UrG)x<+}HT&N%v!GldvbyOqfzJSy2-12m7hq zIx(0+!;gOhLU{1)75)98f+%4?hc`i93-+yFyV?9Fi18Qs{Z~fuXA2xSa|D>wjp%4k zM#&EI2M{knx$Z`uSiuLnW5>C(v9x7>lvA;aY*%_hJg`_-fD~i_nf_ac8o{C}e&fxZ z0f+4*(q*(&bO#h z9Xp=V*KfyCgs+J0YxwruQ zp=6IWn{S4DPhJD1x{|xiuJ`+la-`YEXJ1q*Wx*`@9)i9w%enlI834Oi$*b)t^@0}? zY~NnQ$hQ_WVGobX>t8dVn20IMrEjGtAY9S>N!nWCXFy5H)3*F{Vm-f+>ZB&ZPmCTD z;^^(ZE?cwd;r2ut!h0UJA7{TH1c|irxw)q)$#>yUciMNW*AN9lVpo_v`1oKi; zj#$MG+ou8{dZ@Iwu7j_ettM`&zm-!(Dv2m6`7otRRJS^%CR>tru=_ z`Yd)j{#8a;IZ*31OYkm={-FH$uzOLERXpP#lX#2wNCLVq-;({KDJmu4NLx|b3d81D z4@f4P_fMvpK;GenBmEF^{_|@DwE%Hwjh#7|+;%Ba824GUZusTl`B(wC3Ad8y$$-%L^&srf4Ih)E8fWo~1=ZSFMg zhBmw9dA}+#@8omDps zmUX8%Xh^D)z<0k*UCvOH@V>cczis~#9`$DM+)pCeoiCi8_DV$9fy+vr{wWZpmn?Me z&USq7>4d#ZT^+l%mnbr3!`jMPHC>=gojd=JVqrP|nNwEHnyl|D?~>zO`u@QjPghFZ zP|>O`{g`i-vs4R)r^vxA5=_#1+##X7JDhvP1bcfF#IhRWLN2L6iA4>tdSKD`*@^1c q*hMGif_6&q5fRp7$&j_(y-oE)SIO_>(?BEFJ-->6!AlGr!u|z2&IgMC diff --git a/docs/build-insights/tutorials/media/templates-view-before-fix.png b/docs/build-insights/tutorials/media/templates-view-before-fix.png new file mode 100644 index 0000000000000000000000000000000000000000..5c52be969024c2a7510a1846efa2157f038a8717 GIT binary patch literal 66563 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 Date: Sat, 12 Jul 2025 22:12:29 +0800 Subject: [PATCH 0353/1799] Fix typos in "What's new for C++ in Visual Studio 2022" topic --- ...what-s-new-for-visual-cpp-in-visual-studio.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index c603b8f9169..51b810c8aa6 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -91,7 +91,7 @@ A quick highlight of some new features: - **Standard Library enhancements** - - Standard library support for couroutines. In this example from [P2502R2](https://wg21.link/p2502r2), the `fib` function is a coroutine. When the `co_yield` statement is executed, `fib` is suspended and the value is returned to the caller. You can resume the `fib` coroutine later to produce more values without requiring any manual state handling: + - Standard library support for coroutines. In this example from [P2502R2](https://wg21.link/p2502r2), the `fib` function is a coroutine. When the `co_yield` statement is executed, `fib` is suspended and the value is returned to the caller. You can resume the `fib` coroutine later to produce more values without requiring any manual state handling: ```cpp std::generator fib() @@ -137,8 +137,8 @@ A quick highlight of some new features: :::image-end::: To use this feature, ensure the following are turned on: - - **Tools**>**Options**> **Preview Features** > **Pull Request Comments** - - **Tools** >**Options** > **GitHub** > **Copilot** > **Source Control Integration** > **Enable Git preview features**. + - **Tools** > **Options** > **Preview Features** > **Pull Request Comments** + - **Tools** > **Options** > **GitHub** > **Copilot** > **Source Control Integration** > **Enable Git preview features**. - GitHub Copilot Edits is a new feature that can make changes across multiple files in your project. To start a new Edits session, click **Create new edit session** at the top of the GitHub Copilot Chat window: @@ -283,7 +283,7 @@ A partial list of new features: :::image-end::: - **Breakpoint/Tracepoint Creation**: You can now create conditional breakpoints or tracepoints directly from expressions in the source code from the right-click menu. This works on property or field names and values from autos, locals, watch windows, or DataTips. - **Attach to Process Dialog**: The functionality provided by the Attach to Process dialog is more user-friendly. You can now easily switch between tree and list views, organize processes better with collapsible sections, and select code types with a simplified combobox. Also, the "Select/Track Window" feature is now easier to use, allowing two-way tracking: selecting a process highlights its window, and clicking on a window selects its process. -- **GitHub Copilot Integration**: GitHub Copilot and Copilot Chat extensions are now unified and now ship directly in Visual Studio. To install it, install the **GitHub Copilot** component in the **Visual Studio Installer**: +- **GitHub Copilot Integration**: GitHub Copilot and Copilot Chat extensions are now unified and ship directly in Visual Studio. To install it, install the **GitHub Copilot** component in the **Visual Studio Installer**: :::image type="complex" source="media/github-copilot-install-option.png" alt-text="Screenshot of the Visual Studio Installer GitHub Copilot installation option." lightbox="media/github-copilot-install-option-expanded.png"::: The Visual Studio installer is open to the Workloads tab. In the installation details pane, GitHub Copilot is shown as selected. :::image-end::: @@ -347,7 +347,7 @@ A partial list of new features: - More Unreal Engine support: - Unreal Engine Test Adapter lets you discover, run, manage, and debug your Unreal Engine tests without leaving the Visual Studio IDE. - With Unreal Engine Code Snippets, you can find common Unreal Engine constructs as snippets in your member list. - - Build Insights is now integrated with Visual Studio 2022 and works with MSBuild and CMake projects using MSVC. You can now see additional information about the compilation of a function such as how long it took to compile and the number of ForceInlines, and the impact of header files on build time. For more information, see [Tutorial: Troubleshoot function inlining on build time](../build-insights/tutorials/build-insights-function-view.md) and [Tutorial: Troubleshoot header file impact on build time](../build-insights/tutorials/build-insights-included-files-view.md). + - Build Insights is now integrated with Visual Studio 2022 and works with MSBuild and CMake projects using MSVC. You can now see additional information about the compilation of a function such as how long it took to compile, the number of ForceInlines, and the impact of header files on build time. For more information, see [Tutorial: Troubleshoot function inlining on build time](../build-insights/tutorials/build-insights-function-view.md) and [Tutorial: Troubleshoot header file impact on build time](../build-insights/tutorials/build-insights-included-files-view.md). - Remote Linux unit test support now lets you run your CTest and GTest tests on your remote Linux machines from Visual Studio's Test Explorer, just like your local tests. ## What's new for C++ in Visual Studio version 17.7 @@ -402,7 +402,7 @@ A partial list of new features includes: A partial list of new features includes: -- `std::move`, `std::forward`, `std::move_if_noexcept`, and `std::forward_like` now don't produce function calls in generated code, even in debug mode. This change avoids named casts causing unnecessary overhead in debug builds. `/permissive-` (or an option that implies it, such as `/std:c++20` or `std:c++latest`) is required. +- `std::move`, `std::forward`, `std::move_if_noexcept`, and `std::forward_like` now don't produce function calls in generated code, even in debug mode. This change avoids named casts causing unnecessary overhead in debug builds. `/permissive-` (or an option that implies it, such as `/std:c++20` or `/std:c++latest`) is required. - Added [`[[msvc::intrinsic]]`](../cpp/attributes.md#msvcintrinsic). You can apply this attribute to nonrecursive functions consisting of a single cast, which take only one parameter. - Added support for Linux Console in the Integrated Terminal, which allows for terminal I/O. - Added initial experimental support for C11 atomic primitives (``). You can enable this experimental feature with the `/experimental:c11atomics` option in `/std:c11` mode or later. @@ -468,7 +468,7 @@ A partial list of new features in 17.4: (The compiler part isn't implemented yet. The library part was implemented in C++20 mode when Ranges support was initially implemented.) - [P0881R7](https://wg21.link/p0881r7) `` - - [P2301R1](https://wg21.link/p2301r1) Add A `pmr` Alias For `std::stacktrace` + - [P2301R1](https://wg21.link/p2301r1) Add a `pmr` alias for `std::stacktrace` - [P1328R1](https://wg21.link/p1328r1) `constexpr type_info::operator==()` - [P2440R1](https://wg21.link/p2440r1) `ranges::iota`, `ranges::shift_left`, `ranges::shift_right` - [P2441R2](https://wg21.link/p2441r2) `views::join_with` @@ -527,7 +527,7 @@ A partial list of new features in 17.2: - When you double-click an RTOS object in the tool window, it adds a watch for the object. - When you select the start and end values for the stack pointer in the RTOS tool window, it opens in the memory window. - Added thread awareness for device targets to the call stack window. - - Users can now select a pin icon next to peripherals, registers, or fields to pin them the top of the Peripheral View. + - Users can now select a pin icon next to peripherals, registers, or fields to pin them to the top of the Peripheral View. - Added implementations of the remaining C++20 defect reports (also known as *backports*). All C++20 features are now available under the **`/std:c++20`** option. For more information about the implemented backports, see the [VS 2022 Changelog](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-172) in the Microsoft/STL GitHub repository and the [MSVC's STL Completes `/std:c++20`](https://devblogs.microsoft.com/cppblog/msvcs-stl-completes-stdc20/) blog post. - We added various C++23 Library features, available under the **`/std:c++latest`** option. For more information about the new features, see the [STL Repo changelog](https://github.com/microsoft/STL/wiki/Changelog). - Improved performance of the initial C++ indexing by up to 20%, depending on the depth of the include graph. From 613a5b6ac56cbb12001d9ff69c038f1344fbf90c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 12 Jul 2025 22:20:06 +0800 Subject: [PATCH 0354/1799] Fix undeclared identifier error in "What's new for C++ in Visual Studio 2022" topic --- docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index 51b810c8aa6..222147dd0b4 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -107,7 +107,7 @@ A quick highlight of some new features: int answer_to_the_universe() { auto rng = fib() | std::views::drop(6) | std::views::take(3); - return std::ranges::fold_left(std::move(range), 0, std::plus{}); + return std::ranges::fold_left(std::move(rng), 0, std::plus{}); } ``` From 154f2c11a642291a3b1a1c73985003e2c0b687d2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 12 Jul 2025 22:39:32 +0800 Subject: [PATCH 0355/1799] Update links for "For more information" tables in "What's new for C++ in Visual Studio 2022" topic --- ...what-s-new-for-visual-cpp-in-visual-studio.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index 222147dd0b4..8d0e875857f 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -62,7 +62,7 @@ A quick highlight of some of the new features: |---|---| | What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.13](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-13/) | | Standard Library (STL) C++26 and C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.13](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1713) | -| New features in the IDE |[Visual Studio 2022 version 17.13 Release Notes](/visualstudio/releases/2022/release-notes) | +| New features in the IDE |[Visual Studio 2022 version 17.13 Release Notes](/visualstudio/releases/2022/release-notes-v17.13) | | C++ language updates | [MSVC compiler updates in Visual Studio 2022 17.13](https://devblogs.microsoft.com/cppblog/msvc-compiler-updates-in-visual-studio-2022-version-17-13/) | | C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.13](cpp-conformance-improvements.md#improvements_1713) | @@ -163,7 +163,7 @@ A quick highlight of some new features: |---|---| | What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.12](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-12/) | | Standard Library (STL) merged C++26 and C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.12](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1712) | -| New features in the Visual Studio 17.12 IDE |[Visual Studio 2022 version 17.12 Release Notes](/visualstudio/releases/2022/release-notes) | +| New features in the Visual Studio 17.12 IDE |[Visual Studio 2022 version 17.12 Release Notes](/visualstudio/releases/2022/release-notes-v17.12) | | C++ language conformance improvements in Visual Studio 2022 17.12 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.12](cpp-conformance-improvements.md#improvements_1712) | A quick highlight of some of the new features: @@ -211,8 +211,8 @@ A quick highlight of some of the new features: | For more information about | See | |---|---| | What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.11](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-11/) | -| Standard Library (STL) merged C++26 and C++23 features, C++20 defect reports, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.11](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1711) | -| New features in the Visual Studio 17.11 IDE |[Visual Studio 2022 version 17.11 Release Notes](/visualstudio/releases/2022/release-notes) | +| Standard Library (STL) merged C++26 and C++23 features, C++20 defect reports, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.11](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-1711) | +| New features in the Visual Studio 17.11 IDE |[Visual Studio 2022 version 17.11 Release Notes](/visualstudio/releases/2022/release-notes-v17.11) | | C++ language conformance improvements in Visual Studio 2022 17.11 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.11](cpp-conformance-improvements.md#improvements_1711) | A partial list of new features: @@ -262,8 +262,8 @@ A partial list of new features: | For more information about | See | |---|---| | What's new for C++ developers | [What's new for C++ Developers in Visual Studio 2022 17.10](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-10/) | -| Standard Library (STL) merged C++26 and C++23 features, C++20 defect reports, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.10](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1710) | -| New features in the Visual Studio 17.10 IDE |[Visual Studio 2022 version 17.10 Release Notes](/visualstudio/releases/2022/release-notes) | +| Standard Library (STL) merged C++26 and C++23 features, C++20 defect reports, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.10](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-1710) | +| New features in the Visual Studio 17.10 IDE |[Visual Studio 2022 version 17.10 Release Notes](/visualstudio/releases/2022/release-notes-v17.10) | | C++ language conformance improvements in Visual Studio 2022 17.10 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.10](cpp-conformance-improvements.md#improvements_1710) | A partial list of new features: @@ -484,7 +484,7 @@ A partial list of new features in 17.4: | For more information about | See | |---|---| -| What's new for C++ developers | [C++ improvements in 17.3](https://devblogs.microsoft.com/visualstudio/visual-studio-2022-17-3-is-now-available/#c-improvements) | +| What's new for C++ developers | [C++ improvements in 17.3](https://devblogs.microsoft.com/visualstudio/visual-studio-2022-17-3-is-now-available/#c++-improvements) | | Standard Library (STL) merged C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.3](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-173) | | New features in the Visual Studio 17.3 IDE | [Visual Studio 2022 version 17.3 Release Notes](/visualstudio/releases/2022/release-notes-v17.3) | | C++ language conformance improvements in Visual Studio 2022 17.3 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](cpp-conformance-improvements.md#improvements_173) | @@ -559,7 +559,7 @@ A partial list of new features in 17.1: | For more information about | See | |---|---| | New features in the Visual Studio 17.0 IDE | [Visual Studio 2022 version 17.0 Release Notes](/visualstudio/releases/2022/release-notes-v17.0) | -| Standard Library (STL) merged C++23 and C++26 features, C++20 defect reports, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.0](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1710) | +| Standard Library (STL) merged C++23 and C++26 features, C++20 defect reports, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.0](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-170) | | C++ language conformance improvements in Visual Studio 2022 17.0 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.10](cpp-conformance-improvements.md#improvements_170) | An overview of some of the new features in Visual Studio 2022 version 17.0: From 36d9758a419c2da3f27da6fa8148d08d370a8875 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 12 Jul 2025 23:00:48 +0800 Subject: [PATCH 0356/1799] Convert C Runtime errors list into a table --- .../c-runtime-errors-r6002-through-r6035.md | 32 ++++++++++--------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md index 97bc308ef10..d9c118743eb 100644 --- a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md @@ -13,21 +13,23 @@ The C Runtime library (CRT) may report a runtime error when your app is loaded o ## C Runtime errors -[C Runtime Error R6002](../../error-messages/tool-errors/c-runtime-error-r6002.md) \ -[C Runtime Error R6008](../../error-messages/tool-errors/c-runtime-error-r6008.md) \ -[C Runtime Error R6009](../../error-messages/tool-errors/c-runtime-error-r6009.md) \ -[C Runtime Error R6016](../../error-messages/tool-errors/c-runtime-error-r6016.md) \ -[C Runtime Error R6017](../../error-messages/tool-errors/c-runtime-error-r6017.md) \ -[C Runtime Error R6018](../../error-messages/tool-errors/c-runtime-error-r6018.md) \ -[C Runtime Error R6019](../../error-messages/tool-errors/c-runtime-error-r6019.md) \ -[C Runtime Error R6024](../../error-messages/tool-errors/c-runtime-error-r6024.md) \ -[C Runtime Error R6025](../../error-messages/tool-errors/c-runtime-error-r6025.md) \ -[C Runtime Error R6028](../../error-messages/tool-errors/c-runtime-error-r6028.md) \ -[C Runtime Error R6030](../../error-messages/tool-errors/c-runtime-error-r6030.md) \ -[C Runtime Error R6031](../../error-messages/tool-errors/c-runtime-error-r6031.md) \ -[C Runtime Error R6032](../../error-messages/tool-errors/c-runtime-error-r6032.md) \ -[C Runtime Error R6033](../../error-messages/tool-errors/c-runtime-error-r6033.md) \ -[C Runtime Error R6035](../../error-messages/tool-errors/c-runtime-error-r6035.md) +| Error | Message | +|--|--| +| [C Runtime Error R6002](../../error-messages/tool-errors/c-runtime-error-r6002.md) | floating-point support not loaded | +| [C Runtime Error R6008](../../error-messages/tool-errors/c-runtime-error-r6008.md) | not enough space for arguments | +| [C Runtime Error R6009](../../error-messages/tool-errors/c-runtime-error-r6009.md) | not enough space for environment | +| [C Runtime Error R6016](../../error-messages/tool-errors/c-runtime-error-r6016.md) | not enough space for thread data | +| [C Runtime Error R6017](../../error-messages/tool-errors/c-runtime-error-r6017.md) | unexpected multithread lock error | +| [C Runtime Error R6018](../../error-messages/tool-errors/c-runtime-error-r6018.md) | unexpected heap error | +| [C Runtime Error R6019](../../error-messages/tool-errors/c-runtime-error-r6019.md) | unable to open console device | +| [C Runtime Error R6024](../../error-messages/tool-errors/c-runtime-error-r6024.md) | not enough space for _onexit/atexit table | +| [C Runtime Error R6025](../../error-messages/tool-errors/c-runtime-error-r6025.md) | pure virtual function call | +| [C Runtime Error R6028](../../error-messages/tool-errors/c-runtime-error-r6028.md) | unable to initialize heap | +| [C Runtime Error R6030](../../error-messages/tool-errors/c-runtime-error-r6030.md) | CRT not initialized | +| [C Runtime Error R6031](../../error-messages/tool-errors/c-runtime-error-r6031.md) | Attempt to initialize the CRT more than once. This indicates a bug in your application. | +| [C Runtime Error R6032](../../error-messages/tool-errors/c-runtime-error-r6032.md) | Not enough space for locale information | +| [C Runtime Error R6033](../../error-messages/tool-errors/c-runtime-error-r6033.md) | Attempt to use MSIL code from this assembly during native code initialization. This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. | +| [C Runtime Error R6035](../../error-messages/tool-errors/c-runtime-error-r6035.md) | A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. | ## See also From 48ade32f35fce006898badc9e1ce92d08cb7072c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 12 Jul 2025 23:02:19 +0800 Subject: [PATCH 0357/1799] Simplify superfluous relative links in "C Runtime errors (Rxxxx)" --- .../c-runtime-errors-r6002-through-r6035.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md index d9c118743eb..1199507c3bf 100644 --- a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md @@ -9,27 +9,27 @@ ms.assetid: 78019050-9a30-4b61-8250-a5702e0e2393 The C Runtime library (CRT) may report a runtime error when your app is loaded or running. Even though each message refers to the Microsoft Visual C++ runtime library, it doesn't mean there's a bug in the library. These errors indicate either a bug in your app's code, or a condition that the runtime library can't handle, such as low memory. End users of your app may see these errors unless your write your app to prevent them, or to capture the errors and present a friendly error message to your users instead. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## C Runtime errors | Error | Message | |--|--| -| [C Runtime Error R6002](../../error-messages/tool-errors/c-runtime-error-r6002.md) | floating-point support not loaded | -| [C Runtime Error R6008](../../error-messages/tool-errors/c-runtime-error-r6008.md) | not enough space for arguments | -| [C Runtime Error R6009](../../error-messages/tool-errors/c-runtime-error-r6009.md) | not enough space for environment | -| [C Runtime Error R6016](../../error-messages/tool-errors/c-runtime-error-r6016.md) | not enough space for thread data | -| [C Runtime Error R6017](../../error-messages/tool-errors/c-runtime-error-r6017.md) | unexpected multithread lock error | -| [C Runtime Error R6018](../../error-messages/tool-errors/c-runtime-error-r6018.md) | unexpected heap error | -| [C Runtime Error R6019](../../error-messages/tool-errors/c-runtime-error-r6019.md) | unable to open console device | -| [C Runtime Error R6024](../../error-messages/tool-errors/c-runtime-error-r6024.md) | not enough space for _onexit/atexit table | -| [C Runtime Error R6025](../../error-messages/tool-errors/c-runtime-error-r6025.md) | pure virtual function call | -| [C Runtime Error R6028](../../error-messages/tool-errors/c-runtime-error-r6028.md) | unable to initialize heap | -| [C Runtime Error R6030](../../error-messages/tool-errors/c-runtime-error-r6030.md) | CRT not initialized | -| [C Runtime Error R6031](../../error-messages/tool-errors/c-runtime-error-r6031.md) | Attempt to initialize the CRT more than once. This indicates a bug in your application. | -| [C Runtime Error R6032](../../error-messages/tool-errors/c-runtime-error-r6032.md) | Not enough space for locale information | -| [C Runtime Error R6033](../../error-messages/tool-errors/c-runtime-error-r6033.md) | Attempt to use MSIL code from this assembly during native code initialization. This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. | -| [C Runtime Error R6035](../../error-messages/tool-errors/c-runtime-error-r6035.md) | A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. | +| [C Runtime Error R6002](c-runtime-error-r6002.md) | floating-point support not loaded | +| [C Runtime Error R6008](c-runtime-error-r6008.md) | not enough space for arguments | +| [C Runtime Error R6009](c-runtime-error-r6009.md) | not enough space for environment | +| [C Runtime Error R6016](c-runtime-error-r6016.md) | not enough space for thread data | +| [C Runtime Error R6017](c-runtime-error-r6017.md) | unexpected multithread lock error | +| [C Runtime Error R6018](c-runtime-error-r6018.md) | unexpected heap error | +| [C Runtime Error R6019](c-runtime-error-r6019.md) | unable to open console device | +| [C Runtime Error R6024](c-runtime-error-r6024.md) | not enough space for _onexit/atexit table | +| [C Runtime Error R6025](c-runtime-error-r6025.md) | pure virtual function call | +| [C Runtime Error R6028](c-runtime-error-r6028.md) | unable to initialize heap | +| [C Runtime Error R6030](c-runtime-error-r6030.md) | CRT not initialized | +| [C Runtime Error R6031](c-runtime-error-r6031.md) | Attempt to initialize the CRT more than once. This indicates a bug in your application. | +| [C Runtime Error R6032](c-runtime-error-r6032.md) | Not enough space for locale information | +| [C Runtime Error R6033](c-runtime-error-r6033.md) | Attempt to use MSIL code from this assembly during native code initialization. This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. | +| [C Runtime Error R6035](c-runtime-error-r6035.md) | A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. | ## See also From 580bc08b839a30eea1fada8403128644c42e7b97 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 12 Jul 2025 23:02:52 +0800 Subject: [PATCH 0358/1799] Update metadata in "C Runtime errors (Rxxxx)" --- .../tool-errors/c-runtime-errors-r6002-through-r6035.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md index 1199507c3bf..cbac9569743 100644 --- a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: C Runtime errors (Rxxxx)" title: "C Runtime errors" -ms.date: "04/16/2019" +description: "Learn more about: C Runtime errors (Rxxxx)" +ms.date: 04/16/2019 f1_keywords: ["c.errors", "R6000", "R6003", "R6010", "R6022", "R6023", "R6034"] -ms.assetid: 78019050-9a30-4b61-8250-a5702e0e2393 --- # C Runtime errors (Rxxxx) From e6f7b5c2f8f9ccb24884ec9c2917aee8112be4b8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 12 Jul 2025 23:09:57 +0800 Subject: [PATCH 0359/1799] Add blockquotes for error messages in range [C2061, C2080] --- docs/error-messages/compiler-errors-1/compiler-error-c2061.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2062.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2063.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2064.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2066.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2067.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2069.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2070.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2071.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2072.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2074.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2075.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2077.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2078.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2079.md | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md index 2af16ddaeec..da3e1dc6838 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md @@ -8,7 +8,7 @@ ms.assetid: b0e61c0c-a205-4820-b9aa-301d6c6fe6eb --- # Compiler Error C2061 -syntax error : identifier 'identifier' +> syntax error : identifier 'identifier' The compiler found an identifier where it wasn't expected. Make sure that `identifier` is declared before you use it. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md index 331da15078f..4df2f57d7ba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md @@ -8,7 +8,7 @@ ms.assetid: 6cc98353-2ddf-43ab-88a2-9cc91cdd6033 --- # Compiler Error C2062 -type 'type' unexpected +> type 'type' unexpected The compiler did not expect a type name. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md index 6bb9d67d1c7..c265fc916cd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md @@ -8,7 +8,7 @@ ms.assetid: 0a90c18f-4029-416a-9128-e8713b53e6f1 --- # Compiler Error C2063 -'identifier' : not a function +> 'identifier' : not a function The identifier is used as a function but not declared as a function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md index 6d92b1ba307..e69a7d0431d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md @@ -8,7 +8,7 @@ ms.assetid: 6cda05da-f437-4f50-9813-ae69538713a3 --- # Compiler Error C2064 -term does not evaluate to a function taking N arguments +> term does not evaluate to a function taking N arguments A call is made to a function through an expression. The expression does not evaluate to a pointer to a function that takes the specified number of arguments. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2066.md b/docs/error-messages/compiler-errors-1/compiler-error-c2066.md index 8a0b42ca727..b9256caf49d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2066.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2066.md @@ -8,6 +8,6 @@ ms.assetid: f1efc63f-948a-410b-bf6e-ba250d52cd38 --- # Compiler Error C2066 -cast to function type is illegal +> cast to function type is illegal In ANSI C, it is not legal to cast between a function pointer and a data pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2067.md b/docs/error-messages/compiler-errors-1/compiler-error-c2067.md index e5e1e4ab588..29b4d9a264e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2067.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2067.md @@ -8,6 +8,6 @@ ms.assetid: 97cab473-a713-489f-8536-ca2cc5792b8c --- # Compiler Error C2067 -cast to array type is illegal +> cast to array type is illegal An object was cast to an array type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2069.md b/docs/error-messages/compiler-errors-1/compiler-error-c2069.md index f0170cb6ac3..51e78b2e09e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2069.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2069.md @@ -8,6 +8,6 @@ ms.assetid: 0c87445a-9eed-4917-a733-f08217f2d64d --- # Compiler Error C2069 -cast of 'void' term to non-'void' +> cast of 'void' term to non-'void' Type **`void`** cannot be cast to any other type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md index 76cac0d4b89..81c88a5552f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md @@ -8,7 +8,7 @@ ms.assetid: 4c8dea63-1227-4aba-be26-2462537f86fb --- # Compiler Error C2070 -'type': illegal sizeof operand +> 'type': illegal sizeof operand The [sizeof](../../cpp/sizeof-operator.md) operator requires an expression or type name. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md index 1bfd7926e5f..c1465d1e597 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md @@ -8,7 +8,7 @@ ms.assetid: f8c09255-a5c4-47e3-8089-3d875ae43cc5 --- # Compiler Error C2071 -'identifier' : illegal storage class +> 'identifier' : illegal storage class `identifier` was declared with an invalid [storage class](../../c-language/c-storage-classes.md). This error can be caused when more than one storage class is specified for an identifier, or when the definition is incompatible with the storage class declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2072.md b/docs/error-messages/compiler-errors-1/compiler-error-c2072.md index 027a73b4a2f..4aa64774708 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2072.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2072.md @@ -8,6 +8,6 @@ ms.assetid: 0b19a847-61dd-4bc3-b54d-108a637a4424 --- # Compiler Error C2072 -'identifier' : initialization of a function +> 'identifier' : initialization of a function A function initializer was specified incorrectly. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2074.md b/docs/error-messages/compiler-errors-1/compiler-error-c2074.md index 0e2f7f6326e..214adb052ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2074.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2074.md @@ -8,6 +8,6 @@ ms.assetid: 1abe5934-61db-4374-8c48-1fa7281317f4 --- # Compiler Error C2074 -'identifier' : 'class-key' initialization needs curly braces +> 'identifier' : 'class-key' initialization needs curly braces There were no curly braces around the specified class, structure, or union initializer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md index b83c31b4f74..9551f4a6492 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md @@ -8,7 +8,7 @@ ms.assetid: 8b1865d2-540b-4117-b982-e7a58a0b6cf7 --- # Compiler Error C2075 -'identifier' : array initialization needs curly braces +> 'identifier' : array initialization needs curly braces There were no curly braces around the specified array initializer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2077.md b/docs/error-messages/compiler-errors-1/compiler-error-c2077.md index 824efd91f1f..f7b4168667c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2077.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2077.md @@ -8,6 +8,6 @@ ms.assetid: f046f0e3-1987-477a-a0af-fe543a9f5fcb --- # Compiler Error C2077 -non-scalar field initializer 'identifier' +> non-scalar field initializer 'identifier' You tried to initialize a bit field with a nonscalar (struct, union, array, or class). Use an integer or floating-point value. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md index 6cc3e1e1fe2..5d8aa70cdb6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md @@ -8,7 +8,7 @@ ms.assetid: 9bead850-4123-46cf-a634-5c77ba974b2b --- # Compiler Error C2078 -too many initializers +> too many initializers The number of initializers exceeds the number of objects to be initialized. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md index c096d8ffb12..bf2561c7b0c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md @@ -8,7 +8,7 @@ ms.assetid: ca58d6d5-eccd-40b7-ba14-c003223c5bc7 --- # Compiler Error C2079 -'identifier' uses undefined class/struct/union 'name' +> 'identifier' uses undefined class/struct/union 'name' The specified identifier is an undefined class, structure, or union. From 4db7a0b0c5f940ad40a1eb0ee1969929bf84e466 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 12 Jul 2025 23:16:44 +0800 Subject: [PATCH 0360/1799] Add "Remarks" and "Example" headings for error references in range [C2061, C2080] --- docs/error-messages/compiler-errors-1/compiler-error-c2061.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2062.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2063.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2064.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2065.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2066.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2067.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2068.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2069.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2070.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2071.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2072.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2074.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2075.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2076.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2077.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2078.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2079.md | 4 ++++ 18 files changed, 54 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md index da3e1dc6838..8d3996f1a3e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md @@ -10,12 +10,16 @@ ms.assetid: b0e61c0c-a205-4820-b9aa-301d6c6fe6eb > syntax error : identifier 'identifier' +## Remarks + The compiler found an identifier where it wasn't expected. Make sure that `identifier` is declared before you use it. An initializer may be enclosed by parentheses. To avoid this problem, enclose the declarator in parentheses or make it a **`typedef`**. This error could also be caused when the compiler detects an expression as a class template argument; use [typename](../../cpp/typename.md) to tell the compiler it is a type, as shown in the following example: +## Examples + The following sample generates C2061: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md index 4df2f57d7ba..1d85906eeb9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md @@ -10,8 +10,12 @@ ms.assetid: 6cc98353-2ddf-43ab-88a2-9cc91cdd6033 > type 'type' unexpected +## Remarks + The compiler did not expect a type name. +## Example + The following sample generates C2062: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md index c265fc916cd..8c84de598a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md @@ -10,8 +10,12 @@ ms.assetid: 0a90c18f-4029-416a-9128-e8713b53e6f1 > 'identifier' : not a function +## Remarks + The identifier is used as a function but not declared as a function. +## Example + The following sample generates C2063: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md index e69a7d0431d..3b941557e75 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md @@ -10,8 +10,12 @@ ms.assetid: 6cda05da-f437-4f50-9813-ae69538713a3 > term does not evaluate to a function taking N arguments +## Remarks + A call is made to a function through an expression. The expression does not evaluate to a pointer to a function that takes the specified number of arguments. +## Examples + In this example, the code attempts to call non-functions as functions. The following sample generates C2064: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2065.md b/docs/error-messages/compiler-errors-1/compiler-error-c2065.md index e18d5004506..e510f2cd94c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2065.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2065.md @@ -10,6 +10,8 @@ ms.assetid: 78093376-acb7-45f5-9323-5ed7e0aab1dc > '*identifier*' : undeclared identifier +## Remarks + The compiler can't find the declaration for an identifier. There are many possible causes for this error. The most common causes of C2065 are that the identifier hasn't been declared, the identifier is misspelled, the header where the identifier is declared isn't included in the file, or the identifier is missing a scope qualifier, for example, `cout` instead of `std::cout`. For more information on declarations in C++, see [Declarations and Definitions (C++)](../../cpp/declarations-and-definitions-cpp.md). Here are some common issues and solutions in greater detail. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2066.md b/docs/error-messages/compiler-errors-1/compiler-error-c2066.md index b9256caf49d..46793964985 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2066.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2066.md @@ -10,4 +10,6 @@ ms.assetid: f1efc63f-948a-410b-bf6e-ba250d52cd38 > cast to function type is illegal +## Remarks + In ANSI C, it is not legal to cast between a function pointer and a data pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2067.md b/docs/error-messages/compiler-errors-1/compiler-error-c2067.md index 29b4d9a264e..77cadeb055b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2067.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2067.md @@ -10,4 +10,6 @@ ms.assetid: 97cab473-a713-489f-8536-ca2cc5792b8c > cast to array type is illegal +## Remarks + An object was cast to an array type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2068.md b/docs/error-messages/compiler-errors-1/compiler-error-c2068.md index 71ed5cd042d..f5d7793cbf9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2068.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2068.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2068"] > illegal use of overloaded function. Missing argument list? +## Remarks + The compiler detected the invalid use of an overloaded function with no arguments. +## Example + For example: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2069.md b/docs/error-messages/compiler-errors-1/compiler-error-c2069.md index 51e78b2e09e..2398c11a473 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2069.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2069.md @@ -10,4 +10,6 @@ ms.assetid: 0c87445a-9eed-4917-a733-f08217f2d64d > cast of 'void' term to non-'void' +## Remarks + Type **`void`** cannot be cast to any other type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md index 81c88a5552f..3f61df7ec5b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md @@ -10,8 +10,12 @@ ms.assetid: 4c8dea63-1227-4aba-be26-2462537f86fb > 'type': illegal sizeof operand +## Remarks + The [sizeof](../../cpp/sizeof-operator.md) operator requires an expression or type name. +## Example + The following sample generates C2070: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md index c1465d1e597..3186928324a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md @@ -10,6 +10,8 @@ ms.assetid: f8c09255-a5c4-47e3-8089-3d875ae43cc5 > 'identifier' : illegal storage class +## Remarks + `identifier` was declared with an invalid [storage class](../../c-language/c-storage-classes.md). This error can be caused when more than one storage class is specified for an identifier, or when the definition is incompatible with the storage class declaration. To fix this issue, understand the intended storage class of the identifier—for example, **`static`** or **`extern`**—and correct the declaration to match. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2072.md b/docs/error-messages/compiler-errors-1/compiler-error-c2072.md index 4aa64774708..a0da9ce18ab 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2072.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2072.md @@ -10,4 +10,6 @@ ms.assetid: 0b19a847-61dd-4bc3-b54d-108a637a4424 > 'identifier' : initialization of a function +## Remarks + A function initializer was specified incorrectly. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2074.md b/docs/error-messages/compiler-errors-1/compiler-error-c2074.md index 214adb052ac..145db7511d7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2074.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2074.md @@ -10,4 +10,6 @@ ms.assetid: 1abe5934-61db-4374-8c48-1fa7281317f4 > 'identifier' : 'class-key' initialization needs curly braces +## Remarks + There were no curly braces around the specified class, structure, or union initializer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md index 9551f4a6492..89725acb6ab 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md @@ -10,8 +10,12 @@ ms.assetid: 8b1865d2-540b-4117-b982-e7a58a0b6cf7 > 'identifier' : array initialization needs curly braces +## Remarks + There were no curly braces around the specified array initializer. +## Example + The following sample generates C2075: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2076.md b/docs/error-messages/compiler-errors-1/compiler-error-c2076.md index bd3b76f5c71..c785a44d745 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2076.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2076.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2076"] > a brace-enclosed initializer list cannot be used in a new-expression whose type contains 'auto/decltype(auto)' +## Remarks + If an **`auto`** type-specifier appears in the specifier sequence of a new type-identifier or the type-identifier of a **`new`** expression, the expression must contain an initializer of the form `( assignment-expression )`. The compiler deduces the type-identifier from the `assignment-expression` in the initializer. For example, ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2077.md b/docs/error-messages/compiler-errors-1/compiler-error-c2077.md index f7b4168667c..cda32c1a01d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2077.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2077.md @@ -10,4 +10,6 @@ ms.assetid: f046f0e3-1987-477a-a0af-fe543a9f5fcb > non-scalar field initializer 'identifier' +## Remarks + You tried to initialize a bit field with a nonscalar (struct, union, array, or class). Use an integer or floating-point value. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md index 5d8aa70cdb6..570f8b72b1e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md @@ -10,10 +10,14 @@ ms.assetid: 9bead850-4123-46cf-a634-5c77ba974b2b > too many initializers +## Remarks + The number of initializers exceeds the number of objects to be initialized. The compiler can deduce the correct assignment of initializers to objects and inner objects when inner braces are elided from the initializer list. Complete bracing also eliminates ambiguity and results in correct assignment. Partial bracing can cause C2078 because of ambiguity in the assignment of initializers to objects. +## Example + The following sample generates C2078 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md index bf2561c7b0c..d9b681d38c8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md @@ -10,10 +10,14 @@ ms.assetid: ca58d6d5-eccd-40b7-ba14-c003223c5bc7 > 'identifier' uses undefined class/struct/union 'name' +## Remarks + The specified identifier is an undefined class, structure, or union. This error can be caused by initializing an anonymous union. +## Examples + The following sample generates C2079: ```cpp From 30a737903a55bf2e55ea12fedc0ff349ff542102 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 12 Jul 2025 23:18:28 +0800 Subject: [PATCH 0361/1799] Replace term "sample" with "example" for error references in range [C2061, C2080] --- .../compiler-errors-1/compiler-error-c2061.md | 2 +- .../compiler-errors-1/compiler-error-c2062.md | 2 +- .../compiler-errors-1/compiler-error-c2063.md | 2 +- .../compiler-errors-1/compiler-error-c2064.md | 6 +++--- .../compiler-errors-1/compiler-error-c2070.md | 2 +- .../compiler-errors-1/compiler-error-c2071.md | 4 ++-- .../compiler-errors-1/compiler-error-c2073.md | 2 +- .../compiler-errors-1/compiler-error-c2075.md | 2 +- .../compiler-errors-1/compiler-error-c2078.md | 2 +- .../compiler-errors-1/compiler-error-c2079.md | 2 +- .../compiler-errors-1/compiler-error-c2080.md | 2 +- 11 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md index 8d3996f1a3e..5b3a75516d1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md @@ -20,7 +20,7 @@ This error could also be caused when the compiler detects an expression as a cla ## Examples -The following sample generates C2061: +The following example generates C2061: ```cpp // C2061.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md index 1d85906eeb9..513b160064c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md @@ -16,7 +16,7 @@ The compiler did not expect a type name. ## Example -The following sample generates C2062: +The following example generates C2062: ```cpp // C2062.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md index 8c84de598a6..bd327ccf21f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md @@ -16,7 +16,7 @@ The identifier is used as a function but not declared as a function. ## Example -The following sample generates C2063: +The following example generates C2063: ```c // C2063.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md index 3b941557e75..df6f3a3149f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md @@ -16,7 +16,7 @@ A call is made to a function through an expression. The expression does not eval ## Examples -In this example, the code attempts to call non-functions as functions. The following sample generates C2064: +In this example, the code attempts to call non-functions as functions. The following example generates C2064: ```cpp // C2064.cpp @@ -28,7 +28,7 @@ void func() { } ``` -You must call pointers to non-static member functions from the context of an object instance. The following sample generates C2064, and shows how to fix it: +You must call pointers to non-static member functions from the context of an object instance. The following example generates C2064, and shows how to fix it: ```cpp // C2064b.cpp @@ -47,7 +47,7 @@ int main() { } ``` -Within a class, member function pointers must also indicate the calling object context. The following sample generates C2064 and shows how to fix it: +Within a class, member function pointers must also indicate the calling object context. The following example generates C2064 and shows how to fix it: ```cpp // C2064d.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md index 3f61df7ec5b..c681538d43e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md @@ -16,7 +16,7 @@ The [sizeof](../../cpp/sizeof-operator.md) operator requires an expression or ty ## Example -The following sample generates C2070: +The following example generates C2070: ```cpp // C2070.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md index 3186928324a..d7cf7d7a45c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md @@ -18,7 +18,7 @@ To fix this issue, understand the intended storage class of the identifier—for ## Examples -The following sample generates C2071. +The following example generates C2071. ```cpp // C2071.cpp @@ -31,7 +31,7 @@ struct D { }; ``` -The following sample generates C2071. +The following example generates C2071. ```cpp // C2071_b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2073.md b/docs/error-messages/compiler-errors-1/compiler-error-c2073.md index c790ea0ffbe..2e9414742b5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2073.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2073.md @@ -18,7 +18,7 @@ This compiler error is obsolete in Visual Studio 2022. ## Example -The following sample generates C2073. Source file `C2073.cpp`: +The following example generates C2073. Source file `C2073.cpp`: ```cpp // C2073.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md index 89725acb6ab..c8bb463e1ff 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md @@ -16,7 +16,7 @@ There were no curly braces around the specified array initializer. ## Example -The following sample generates C2075: +The following example generates C2075: ```c // C2075.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md index 570f8b72b1e..70c56eb65bd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md @@ -18,7 +18,7 @@ The compiler can deduce the correct assignment of initializers to objects and in ## Example -The following sample generates C2078 and shows how to fix it: +The following example generates C2078 and shows how to fix it: ```cpp // C2078.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md index d9b681d38c8..b440694afd4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md @@ -18,7 +18,7 @@ This error can be caused by initializing an anonymous union. ## Examples -The following sample generates C2079: +The following example generates C2079: ```cpp // C2079.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2080.md b/docs/error-messages/compiler-errors-1/compiler-error-c2080.md index 26fa529539c..49d72787bdc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2080.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2080.md @@ -15,7 +15,7 @@ The compiler can only deduce the type for `auto` or `decltype(auto)` if the decl ## Example -The following sample shows some declarations that cause C2080: +The following example shows some declarations that cause C2080: ```cpp auto x1(1, 2); // C2080 From 53915d54bcd2010de2df5f2f634fb6f3c8ce01d1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 12 Jul 2025 23:22:41 +0800 Subject: [PATCH 0362/1799] Update metadata for error references in range [C2061, C2080] --- .../error-messages/compiler-errors-1/compiler-error-c2061.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2062.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2063.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2064.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2065.md | 3 +-- .../error-messages/compiler-errors-1/compiler-error-c2066.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2067.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2068.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2069.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2070.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2071.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2072.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2073.md | 3 +-- .../error-messages/compiler-errors-1/compiler-error-c2074.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2075.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2076.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2077.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2078.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2079.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2080.md | 2 +- 20 files changed, 35 insertions(+), 52 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md index 5b3a75516d1..83394157a63 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2061" title: "Compiler Error C2061" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2061" +ms.date: 11/04/2016 f1_keywords: ["C2061"] helpviewer_keywords: ["C2061"] -ms.assetid: b0e61c0c-a205-4820-b9aa-301d6c6fe6eb --- # Compiler Error C2061 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md index 513b160064c..b7cd52a817f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2062" title: "Compiler Error C2062" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2062" +ms.date: 11/04/2016 f1_keywords: ["C2062"] helpviewer_keywords: ["C2062"] -ms.assetid: 6cc98353-2ddf-43ab-88a2-9cc91cdd6033 --- # Compiler Error C2062 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md index bd327ccf21f..474aaa30fc7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2063" title: "Compiler Error C2063" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2063" +ms.date: 11/04/2016 f1_keywords: ["C2063"] helpviewer_keywords: ["C2063"] -ms.assetid: 0a90c18f-4029-416a-9128-e8713b53e6f1 --- # Compiler Error C2063 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md index df6f3a3149f..2714aee760d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2064" title: "Compiler Error C2064" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2064" +ms.date: 11/04/2016 f1_keywords: ["C2064"] helpviewer_keywords: ["C2064"] -ms.assetid: 6cda05da-f437-4f50-9813-ae69538713a3 --- # Compiler Error C2064 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2065.md b/docs/error-messages/compiler-errors-1/compiler-error-c2065.md index e510f2cd94c..9081a6fe978 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2065.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2065.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2065" title: "Compiler Error C2065" +description: "Learn more about: Compiler Error C2065" ms.date: 06/29/2022 f1_keywords: ["C2065"] helpviewer_keywords: ["C2065"] -ms.assetid: 78093376-acb7-45f5-9323-5ed7e0aab1dc --- # Compiler Error C2065 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2066.md b/docs/error-messages/compiler-errors-1/compiler-error-c2066.md index 46793964985..a55f64b22f2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2066.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2066.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2066" title: "Compiler Error C2066" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2066" +ms.date: 11/04/2016 f1_keywords: ["C2066"] helpviewer_keywords: ["C2066"] -ms.assetid: f1efc63f-948a-410b-bf6e-ba250d52cd38 --- # Compiler Error C2066 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2067.md b/docs/error-messages/compiler-errors-1/compiler-error-c2067.md index 77cadeb055b..892535c0560 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2067.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2067.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2067" title: "Compiler Error C2067" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2067" +ms.date: 11/04/2016 f1_keywords: ["C2067"] helpviewer_keywords: ["C2067"] -ms.assetid: 97cab473-a713-489f-8536-ca2cc5792b8c --- # Compiler Error C2067 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2068.md b/docs/error-messages/compiler-errors-1/compiler-error-c2068.md index f5d7793cbf9..9f31bb8a1d3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2068.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2068.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2068" title: "Compiler Error C2068" +description: "Learn more about: Compiler Error C2068" ms.date: 08/18/2022 f1_keywords: ["C2068"] helpviewer_keywords: ["C2068"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2069.md b/docs/error-messages/compiler-errors-1/compiler-error-c2069.md index 2398c11a473..ba2b9bea9a2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2069.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2069.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2069" title: "Compiler Error C2069" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2069" +ms.date: 11/04/2016 f1_keywords: ["C2069"] helpviewer_keywords: ["C2069"] -ms.assetid: 0c87445a-9eed-4917-a733-f08217f2d64d --- # Compiler Error C2069 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md index c681538d43e..2d2828762f2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2070" title: "Compiler Error C2070" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2070" +ms.date: 11/04/2016 f1_keywords: ["C2070"] helpviewer_keywords: ["C2070"] -ms.assetid: 4c8dea63-1227-4aba-be26-2462537f86fb --- # Compiler Error C2070 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md index d7cf7d7a45c..40faec7cb70 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2071" title: "Compiler Error C2071" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2071" +ms.date: 11/04/2016 f1_keywords: ["C2071"] helpviewer_keywords: ["C2071"] -ms.assetid: f8c09255-a5c4-47e3-8089-3d875ae43cc5 --- # Compiler Error C2071 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2072.md b/docs/error-messages/compiler-errors-1/compiler-error-c2072.md index a0da9ce18ab..479dfaf4317 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2072.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2072.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2072" title: "Compiler Error C2072" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2072" +ms.date: 11/04/2016 f1_keywords: ["C2072"] helpviewer_keywords: ["C2072"] -ms.assetid: 0b19a847-61dd-4bc3-b54d-108a637a4424 --- # Compiler Error C2072 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2073.md b/docs/error-messages/compiler-errors-1/compiler-error-c2073.md index 2e9414742b5..3db2c03db5e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2073.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2073.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2073" title: "Compiler Error C2073" +description: "Learn more about: Compiler Error C2073" ms.date: 06/29/2022 f1_keywords: ["C2073"] helpviewer_keywords: ["C2073"] -ms.assetid: 57908234-be7a-4ce9-b0a7-8b1ad621865e --- # Compiler Error C2073 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2074.md b/docs/error-messages/compiler-errors-1/compiler-error-c2074.md index 145db7511d7..8221fccd282 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2074.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2074.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2074" title: "Compiler Error C2074" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2074" +ms.date: 11/04/2016 f1_keywords: ["C2074"] helpviewer_keywords: ["C2074"] -ms.assetid: 1abe5934-61db-4374-8c48-1fa7281317f4 --- # Compiler Error C2074 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md index c8bb463e1ff..8e47b3cd00e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2075" title: "Compiler Error C2075" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2075" +ms.date: 11/04/2016 f1_keywords: ["C2075"] helpviewer_keywords: ["C2075"] -ms.assetid: 8b1865d2-540b-4117-b982-e7a58a0b6cf7 --- # Compiler Error C2075 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2076.md b/docs/error-messages/compiler-errors-1/compiler-error-c2076.md index c785a44d745..e20e53b4fa6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2076.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2076.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2076" title: "Compiler Error C2076" +description: "Learn more about: Compiler Error C2076" ms.date: 08/18/2022 f1_keywords: ["C2076"] helpviewer_keywords: ["C2076"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2077.md b/docs/error-messages/compiler-errors-1/compiler-error-c2077.md index cda32c1a01d..720cf2cbf39 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2077.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2077.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2077" title: "Compiler Error C2077" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2077" +ms.date: 11/04/2016 f1_keywords: ["C2077"] helpviewer_keywords: ["C2077"] -ms.assetid: f046f0e3-1987-477a-a0af-fe543a9f5fcb --- # Compiler Error C2077 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md index 70c56eb65bd..f2c6dfa626d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2078" title: "Compiler Error C2078" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2078" +ms.date: 11/04/2016 f1_keywords: ["C2078"] helpviewer_keywords: ["C2078"] -ms.assetid: 9bead850-4123-46cf-a634-5c77ba974b2b --- # Compiler Error C2078 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md index b440694afd4..b4b8022579d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2079" title: "Compiler Error C2079" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2079" +ms.date: 11/04/2016 f1_keywords: ["C2079"] helpviewer_keywords: ["C2079"] -ms.assetid: ca58d6d5-eccd-40b7-ba14-c003223c5bc7 --- # Compiler Error C2079 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2080.md b/docs/error-messages/compiler-errors-1/compiler-error-c2080.md index 49d72787bdc..43be41f7b5d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2080.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2080.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2080" title: "Compiler Error C2080" +description: "Learn more about: Compiler Error C2080" ms.date: 08/18/2022 f1_keywords: ["C2080"] helpviewer_keywords: ["C2080"] From b4163d3ba8b59cba190674dfb6130895fea59953 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 18:27:28 +0800 Subject: [PATCH 0363/1799] Standardize capitalization of "See also" sections --- docs/assembler/masm/mmword.md | 2 +- docs/assembler/masm/xmmword.md | 2 +- docs/build/reference/profile-performance-tools-profiler.md | 2 +- docs/code-quality/c28112.md | 2 +- docs/code-quality/c6504.md | 2 +- .../using-sal-annotations-to-reduce-c-cpp-code-defects.md | 2 +- docs/cpp/import-export-module.md | 2 +- docs/ide/adding-a-property-visual-cpp.md | 2 +- docs/ide/live-share-cpp.md | 2 +- docs/ide/read-and-understand-code-cpp.md | 2 +- docs/ide/writing-and-refactoring-code-cpp.md | 2 +- .../set-up-fips-compliant-secure-remote-linux-development.md | 2 +- .../add-interface-definition-library-mfc-property-wizard.md | 2 +- docs/windows/latest-supported-vc-redist.md | 2 +- 14 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/assembler/masm/mmword.md b/docs/assembler/masm/mmword.md index 563ae8e444f..a4ced88dbb6 100644 --- a/docs/assembler/masm/mmword.md +++ b/docs/assembler/masm/mmword.md @@ -32,6 +32,6 @@ While both instructions work on 64-bit operands, **QWORD** is the type for 64-bi movq mm0, mmword ptr [ebx] ``` -## See Also +## See also [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/xmmword.md b/docs/assembler/masm/xmmword.md index 3722fd23f48..11010769213 100644 --- a/docs/assembler/masm/xmmword.md +++ b/docs/assembler/masm/xmmword.md @@ -24,6 +24,6 @@ Used for 128-bit multimedia operands with MMX and SSE (XMM) instructions. movdqa xmm0, xmmword ptr [ebx] ``` -## See Also +## See also [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/build/reference/profile-performance-tools-profiler.md b/docs/build/reference/profile-performance-tools-profiler.md index d1273f084d1..a2b50606bc2 100644 --- a/docs/build/reference/profile-performance-tools-profiler.md +++ b/docs/build/reference/profile-performance-tools-profiler.md @@ -57,7 +57,7 @@ Because a **CMake** project doesn't have the usual **Property Pages** support, t 1. Rebuild your solution. -## See Also +## See also [MSVC linker reference](linking.md)\ [MSVC linker options](linker-options.md) diff --git a/docs/code-quality/c28112.md b/docs/code-quality/c28112.md index 530ab51bc01..61e0a5588ee 100644 --- a/docs/code-quality/c28112.md +++ b/docs/code-quality/c28112.md @@ -35,7 +35,7 @@ InterlockedDecrement(&inter_var); InterlockedIncrement(&inter_var); ``` -## See Also +## See also [InterlockedIncrement function (wdm.h)](/windows-hardware/drivers/ddi/wdm/nf-wdm-interlockedincrement)\ [InterlockedDecrement function (wdm.h)](/windows-hardware/drivers/ddi/wdm/nf-wdm-interlockeddecrement) diff --git a/docs/code-quality/c6504.md b/docs/code-quality/c6504.md index e77e99df282..1fc3a179ee8 100644 --- a/docs/code-quality/c6504.md +++ b/docs/code-quality/c6504.md @@ -60,6 +60,6 @@ void g(Point& pt) } ``` -## See Also +## See also [Annotation Properties](using-sal-annotations-to-reduce-c-cpp-code-defects.md) diff --git a/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md b/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md index 381e526ebcc..af73328a594 100644 --- a/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md +++ b/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md @@ -47,6 +47,6 @@ The articles in this section of the documentation discuss aspects of SAL, provid Provides examples that show how to use SAL annotations. Also explains common pitfalls. -## See Also +## See also [SAL 2.0 Annotations for Windows Drivers](/windows-hardware/drivers/devtest/sal-2-annotations-for-windows-drivers) diff --git a/docs/cpp/import-export-module.md b/docs/cpp/import-export-module.md index ae7d37a4fe7..498af52c780 100644 --- a/docs/cpp/import-export-module.md +++ b/docs/cpp/import-export-module.md @@ -109,7 +109,7 @@ import // Always an identifier, never a keyword **End Microsoft Specific** -## See Also +## See also [Overview of modules in C++](modules-cpp.md)\ [Import the C++ standard library using modules](tutorial-import-stl-named-module.md) \ No newline at end of file diff --git a/docs/ide/adding-a-property-visual-cpp.md b/docs/ide/adding-a-property-visual-cpp.md index 9feff5ef6ec..8fe7391a5cb 100644 --- a/docs/ide/adding-a-property-visual-cpp.md +++ b/docs/ide/adding-a-property-visual-cpp.md @@ -53,7 +53,7 @@ The following section describes the UI that you'll use to add a property: For ATL interfaces **Put function** makes the property writable; that is, it creates the `Put` method for setting, or "putting," this property of the object. Select **Get**, **Put**, or both. -## See Also +## See also [Add IDL Property](add-interface-definition-library-property-wizard.md) diff --git a/docs/ide/live-share-cpp.md b/docs/ide/live-share-cpp.md index 4a5fecdd502..9099be1d6cc 100644 --- a/docs/ide/live-share-cpp.md +++ b/docs/ide/live-share-cpp.md @@ -44,7 +44,7 @@ To end a session, select **End Collaboration Session** from the **Sharing** drop For more information about **Live Share** in Visual Studio, see [What is Visual Studio Live Share?](/visualstudio/liveshare/). For more information about Live Share in Visual Studio Code, see [ Live Share](https://marketplace.visualstudio.com/items?itemName=ms-vsliveshare.vsliveshare). -## See Also +## See also [Edit and refactor code (C++)](writing-and-refactoring-code-cpp.md)
[Navigate your C++ code base in Visual Studio](navigate-code-cpp.md)
diff --git a/docs/ide/read-and-understand-code-cpp.md b/docs/ide/read-and-understand-code-cpp.md index 119efc1076e..ff4d5bdb93a 100644 --- a/docs/ide/read-and-understand-code-cpp.md +++ b/docs/ide/read-and-understand-code-cpp.md @@ -106,7 +106,7 @@ Right click on any function call and view a recursive list of all the functions ![Screenshot of the Call Hierarchy window which shows calls to and from Floating_to_wstring(). For example, to_wstring() calls Floating_to_wstring().](../ide/media/vs2015_cpp_call_hierarchy.png) -## See Also +## See also [Edit and refactor code (C++)](writing-and-refactoring-code-cpp.md)
[Navigate your C++ code base in Visual Studio](navigate-code-cpp.md)
diff --git a/docs/ide/writing-and-refactoring-code-cpp.md b/docs/ide/writing-and-refactoring-code-cpp.md index 7c3edfb3dae..96428ae971c 100644 --- a/docs/ide/writing-and-refactoring-code-cpp.md +++ b/docs/ide/writing-and-refactoring-code-cpp.md @@ -178,7 +178,7 @@ Options for enabling and configuring C++-specific editing features are located u Experimental features, which may or may not be included in a future version of Visual Studio, are found in the [Text Editor C++ Experimental](/visualstudio/ide/reference/options-text-editor-c-cpp-experimental) dialog. In Visual Studio 2017 and later you can enable **Predictive IntelliSense** in this dialog. -## See Also +## See also [Read and understand C++ code](read-and-understand-code-cpp.md)
[Navigate your C++ code base in Visual Studio](navigate-code-cpp.md)
diff --git a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md index b3581863766..180ceb8cd63 100644 --- a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md +++ b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md @@ -160,7 +160,7 @@ Microsoft blog post on [Why We're Not Recommending "FIPS mode" Anymore](https:// [SSH Server Configuration](https://www.ssh.com/ssh/sshd_config) -## See Also +## See also [Configure a Linux project](configure-a-linux-project.md)\ [Configure a Linux CMake project](cmake-linux-project.md)\ diff --git a/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md b/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md index 5ac27990ea7..2c86901f626 100644 --- a/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md +++ b/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md @@ -167,7 +167,7 @@ If you're adding a property to an MFC dispinterface, you can choose one of the f |`ReadyState`|Returns or sets the control's `ReadyState` property.
A control can be uninitialized, initialized, loading, interactive, or complete.
For more information, see [READYSTATE](/previous-versions/aa768362\(v=vs.85\)) in the *Internet SDK*.| |`Text`|Returns or sets the text contained in a control.
Has no **Member variable** implementation type.| -## See Also +## See also [Add Property](../../ide/adding-a-property-visual-cpp.md) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index fdcd8646049..974db314854 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -117,7 +117,7 @@ Download Redistributable files for other languages and architectures from: - Redistributable files for X86, X64, and IA64 architectures are available from [Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26347). -## See Also +## See also - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) - [How to audit Visual C++ Runtime version usage](redist-version-auditing.md) From 3de4bf0a5d36388304dddcc49afe56378b84310f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 18:30:02 +0800 Subject: [PATCH 0364/1799] Update metadata in 10 topics --- docs/assembler/masm/mmword.md | 5 ++--- docs/assembler/masm/xmmword.md | 5 ++--- docs/build/reference/profile-performance-tools-profiler.md | 2 +- docs/code-quality/c6504.md | 3 +-- .../using-sal-annotations-to-reduce-c-cpp-code-defects.md | 3 +-- docs/cpp/import-export-module.md | 2 +- docs/ide/adding-a-property-visual-cpp.md | 2 +- docs/ide/live-share-cpp.md | 2 +- docs/ide/writing-and-refactoring-code-cpp.md | 2 +- .../add-interface-definition-library-mfc-property-wizard.md | 4 ++-- 10 files changed, 13 insertions(+), 17 deletions(-) diff --git a/docs/assembler/masm/mmword.md b/docs/assembler/masm/mmword.md index a4ced88dbb6..98ca8629498 100644 --- a/docs/assembler/masm/mmword.md +++ b/docs/assembler/masm/mmword.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: MMWORD" title: "MMWORD" -ms.date: "12/17/2019" +description: "Learn more about: MMWORD" +ms.date: 12/17/2019 f1_keywords: ["MMWORD"] helpviewer_keywords: ["MMWORD directive"] -ms.assetid: b4c5a104-9078-4fb4-afc3-d1e63abe562a --- # MMWORD diff --git a/docs/assembler/masm/xmmword.md b/docs/assembler/masm/xmmword.md index 11010769213..9e4ef7c064e 100644 --- a/docs/assembler/masm/xmmword.md +++ b/docs/assembler/masm/xmmword.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: XMMWORD" title: "XMMWORD" -ms.date: "12/17/2019" +description: "Learn more about: XMMWORD" +ms.date: 12/17/2019 f1_keywords: ["XMMWORD"] helpviewer_keywords: ["XMMWORD directive"] -ms.assetid: 18026d32-5cab-403e-ad7e-382fb41aa9b8 --- # XMMWORD diff --git a/docs/build/reference/profile-performance-tools-profiler.md b/docs/build/reference/profile-performance-tools-profiler.md index a2b50606bc2..bff93bcfd78 100644 --- a/docs/build/reference/profile-performance-tools-profiler.md +++ b/docs/build/reference/profile-performance-tools-profiler.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: /PROFILE (Performance Tools Profiler)" title: "/PROFILE (Performance Tools Profiler)" +description: "Learn more about: /PROFILE (Performance Tools Profiler)" ms.date: 10/13/2021 f1_keywords: ["VC.Project.VCLinkerTool.Profile"] helpviewer_keywords: ["-PROFILE linker option", "/PROFILE linker option"] diff --git a/docs/code-quality/c6504.md b/docs/code-quality/c6504.md index 1fc3a179ee8..d7683b709d0 100644 --- a/docs/code-quality/c6504.md +++ b/docs/code-quality/c6504.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C6504" title: Warning C6504 +description: "Learn more about: Warning C6504" ms.date: 10/03/2022 f1_keywords: ["C6504", "NULL_ON_NON_POINTER", "__WARNING_NULL_ON_NON_POINTER"] helpviewer_keywords: ["C6504"] -ms.assetid: 6baeed46-e73d-4974-af16-7487c55b3473 --- # Warning C6504 diff --git a/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md b/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md index af73328a594..3426d695a2a 100644 --- a/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md +++ b/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: Using SAL Annotations to Reduce C/C++ Code Defects" title: Using SAL Annotations to Reduce C/C++ Code Defects +description: "Learn more about: Using SAL Annotations to Reduce C/C++ Code Defects" ms.date: 11/04/2016 ms.topic: "concept-article" helpviewer_keywords: - "annotations" - "SAL annotations" - "code analysis, annotation" -ms.assetid: a16e47d0-6f3e-4ed6-8883-459b2874e9a4 --- # Using SAL Annotations to Reduce C/C++ Code Defects diff --git a/docs/cpp/import-export-module.md b/docs/cpp/import-export-module.md index 498af52c780..360717d20f8 100644 --- a/docs/cpp/import-export-module.md +++ b/docs/cpp/import-export-module.md @@ -1,9 +1,9 @@ --- title: "module, import, export" +description: Use import and export declarations to access and to publish types and functions defined in the specified module. ms.date: 02/13/2025 f1_keywords: ["module_cpp", "import_cpp", "export_cpp"] helpviewer_keywords: ["modules [C++]", "modules [C++], import", "modules [C++], export"] -description: Use import and export declarations to access and to publish types and functions defined in the specified module. --- # `module`, `import`, `export` diff --git a/docs/ide/adding-a-property-visual-cpp.md b/docs/ide/adding-a-property-visual-cpp.md index 8fe7391a5cb..4ec27fc8d6f 100644 --- a/docs/ide/adding-a-property-visual-cpp.md +++ b/docs/ide/adding-a-property-visual-cpp.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Add a property to an interface in a Microsoft Visual Studio C++ project" title: "Add a property" +description: "Learn more about: Add a property to an interface in a Microsoft Visual Studio C++ project" ms.date: 04/12/2022 f1_keywords: ["vc.codewiz.prop.overview"] helpviewer_keywords: ["interfaces, adding properties", "properties [C++], adding to interfaces", "names, add property wizard", "add property wizard", "stock properties, about stock properties", "stock properties"] diff --git a/docs/ide/live-share-cpp.md b/docs/ide/live-share-cpp.md index 9099be1d6cc..6825a02fc28 100644 --- a/docs/ide/live-share-cpp.md +++ b/docs/ide/live-share-cpp.md @@ -1,7 +1,7 @@ --- title: "Collaborate with Live Share for C++ in Visual Studio" description: "Use Live Share for C++ in Visual Studio to collaborate and share code in real time." -ms.date: "05/24/2019" +ms.date: 05/24/2019 --- # Collaborate using Live Share for C++ diff --git a/docs/ide/writing-and-refactoring-code-cpp.md b/docs/ide/writing-and-refactoring-code-cpp.md index 96428ae971c..72dc71d8b4f 100644 --- a/docs/ide/writing-and-refactoring-code-cpp.md +++ b/docs/ide/writing-and-refactoring-code-cpp.md @@ -1,7 +1,7 @@ --- title: "Edit and refactor C++ code in Visual Studio" description: "Use the C++ code editor in Visual Studio to format, navigate, understand and refactor your code." -ms.date: "09/20/2022" +ms.date: 09/20/2022 ms.topic: "overview" ms.custom: intro-overview --- diff --git a/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md b/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md index 2c86901f626..91fc8ecb27e 100644 --- a/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md +++ b/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Use the Microsoft Visual Studio Add IDL MFC property wizard to add a property to an IDL interface in your MFC or ATL project" title: "Add an IDL MFC property" -ms.date: "04/14/2022" +description: "Learn more about: Use the Microsoft Visual Studio Add IDL MFC property wizard to add a property to an IDL interface in your MFC or ATL project" +ms.date: 04/14/2022 f1_keywords: ["vc.codewiz.prop.overview"] helpviewer_keywords: ["interfaces, adding properties", "properties [C++], adding to interfaces", "names, add property wizard", "add property wizard", "stock properties, about stock properties", "stock properties"] ms.custom: devdivchpfy22 From 6879c9e3128a4e910af476b2f6687a61891bab81 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 19:07:22 +0800 Subject: [PATCH 0365/1799] Change "-" to "/" in title of "Output-File (/F) Options" topic --- docs/build/reference/output-file-f-options.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/output-file-f-options.md b/docs/build/reference/output-file-f-options.md index 601eba50f41..4b43905105c 100644 --- a/docs/build/reference/output-file-f-options.md +++ b/docs/build/reference/output-file-f-options.md @@ -1,6 +1,6 @@ --- description: "Learn more about: Output-File (/F) Options" -title: "Output-File (-F) Options" +title: "Output-File (/F) Options" ms.date: "11/04/2016" helpviewer_keywords: ["output files", "output files, compiler options [C++]", "cl.exe compiler, output files"] ms.assetid: f6367f30-2710-4178-b43a-639eed824acb From 3bd79cc59f2cadebd9cc76dd2263e4351446f040 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 19:08:41 +0800 Subject: [PATCH 0366/1799] Replace `br` element with escapes in "Output-File (/F) Options" topic --- docs/build/reference/output-file-f-options.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/output-file-f-options.md b/docs/build/reference/output-file-f-options.md index 4b43905105c..100c79acc5f 100644 --- a/docs/build/reference/output-file-f-options.md +++ b/docs/build/reference/output-file-f-options.md @@ -33,5 +33,5 @@ The output-file options create or rename output files. They affect all C or C++ ## See also -[MSVC Compiler Options](compiler-options.md)
+[MSVC Compiler Options](compiler-options.md)\ [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md) From eb4e1fa57f90a78cbf13bb362f05c4e0edcc8381 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 19:11:10 +0800 Subject: [PATCH 0367/1799] Add backticks in "Output-File (/F) Options" topic --- docs/build/reference/output-file-f-options.md | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/build/reference/output-file-f-options.md b/docs/build/reference/output-file-f-options.md index 100c79acc5f..013491a0374 100644 --- a/docs/build/reference/output-file-f-options.md +++ b/docs/build/reference/output-file-f-options.md @@ -5,31 +5,31 @@ ms.date: "11/04/2016" helpviewer_keywords: ["output files", "output files, compiler options [C++]", "cl.exe compiler, output files"] ms.assetid: f6367f30-2710-4178-b43a-639eed824acb --- -# Output-File (/F) Options +# Output-File (`/F`) Options The output-file options create or rename output files. They affect all C or C++ source files specified in the CL environment variable, on the command line, or in any command file. -- [/FA, /Fa (Listing File)](fa-fa-listing-file.md) +- [`/FA`, `/Fa` (Listing File)](fa-fa-listing-file.md) - [Specifying the Pathname](specifying-the-pathname.md) -- [/Fd (Name PDB File)](fd-program-database-file-name.md) +- [`/Fd` (Name PDB File)](fd-program-database-file-name.md) -- [/Fe (Name EXE File)](fe-name-exe-file.md) +- [`/Fe` (Name EXE File)](fe-name-exe-file.md) -- [/FI (Name Forced Include File)](fi-name-forced-include-file.md) +- [`/FI` (Name Forced Include File)](fi-name-forced-include-file.md) -- [/Fm (Name Mapfile)](fm-name-mapfile.md) +- [`/Fm` (Name Mapfile)](fm-name-mapfile.md) -- [/Fo (Name Object File)](fo-object-file-name.md) +- [`/Fo` (Name Object File)](fo-object-file-name.md) -- [/Fp (Name .pch File)](fp-name-dot-pch-file.md) +- [`/Fp` (Name .pch File)](fp-name-dot-pch-file.md) -- [/FR, /Fr (Create .sbr File)](fr-fr-create-dot-sbr-file.md) +- [`/FR`, `/Fr` (Create .sbr File)](fr-fr-create-dot-sbr-file.md) -- [/FU (Name Forced #using File)](fu-name-forced-hash-using-file.md) +- [`/FU` (Name Forced #using File)](fu-name-forced-hash-using-file.md) -- [/Fx (Merge Injected Code)](fx-merge-injected-code.md) +- [`/Fx` (Merge Injected Code)](fx-merge-injected-code.md) ## See also From 5fd83e4f0392af3cae940121c16a8fe969e8f77b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 19:18:59 +0800 Subject: [PATCH 0368/1799] Add 2 missing entries in "Output-File (/F) Options" topic --- docs/build/reference/output-file-f-options.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/build/reference/output-file-f-options.md b/docs/build/reference/output-file-f-options.md index 013491a0374..a39a8eacf86 100644 --- a/docs/build/reference/output-file-f-options.md +++ b/docs/build/reference/output-file-f-options.md @@ -13,10 +13,14 @@ The output-file options create or rename output files. They affect all C or C++ - [Specifying the Pathname](specifying-the-pathname.md) +- [`/FD` (IDE Minimal Rebuild)](fd-ide-minimal-rebuild.md) + - [`/Fd` (Name PDB File)](fd-program-database-file-name.md) - [`/Fe` (Name EXE File)](fe-name-exe-file.md) +- [`/Fi` (Preprocess output file name)](fi-preprocess-output-file-name.md) + - [`/FI` (Name Forced Include File)](fi-name-forced-include-file.md) - [`/Fm` (Name Mapfile)](fm-name-mapfile.md) From e748730f4d83bdbed68632b5d1f1891c67fd49a3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 19:20:38 +0800 Subject: [PATCH 0369/1799] Update metadata in "Output-File (/F) Options" topic --- docs/build/reference/output-file-f-options.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/build/reference/output-file-f-options.md b/docs/build/reference/output-file-f-options.md index a39a8eacf86..da20a94a487 100644 --- a/docs/build/reference/output-file-f-options.md +++ b/docs/build/reference/output-file-f-options.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Output-File (/F) Options" title: "Output-File (/F) Options" -ms.date: "11/04/2016" +description: "Learn more about: Output-File (/F) Options" +ms.date: 11/04/2016 helpviewer_keywords: ["output files", "output files, compiler options [C++]", "cl.exe compiler, output files"] -ms.assetid: f6367f30-2710-4178-b43a-639eed824acb --- # Output-File (`/F`) Options From 12da1a406604aa9a44b07ba80a6adfb7df7982e7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 22:16:34 +0800 Subject: [PATCH 0370/1799] Resolve cut off name for `/FU` in `toc.yml` --- docs/build/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/toc.yml b/docs/build/toc.yml index 444ec54501b..9fced4f681a 100644 --- a/docs/build/toc.yml +++ b/docs/build/toc.yml @@ -552,7 +552,7 @@ items: href: ../build/reference/fp-name-dot-pch-file.md - name: /FR, /Fr (Create .Sbr file) href: ../build/reference/fr-fr-create-dot-sbr-file.md - - name: /FU (Name forced + - name: "/FU (Name forced #using file)" href: ../build/reference/fu-name-forced-hash-using-file.md - name: /Fx (Merge injected code) href: ../build/reference/fx-merge-injected-code.md From c21763a259e42b1da474c1256d706750962e5632 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 22:28:37 +0800 Subject: [PATCH 0371/1799] Convert BSCMAKE errors and warnings list into a table --- .../bscmake-errors-bk1500-through-bk4505.md | 38 ++++++++++--------- 1 file changed, 21 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md index cf53a0fd929..567c9895c3e 100644 --- a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md +++ b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md @@ -12,26 +12,30 @@ This section is a reference to the errors and warnings generated by the BSCMAKE ## Error messages -[BSCMAKE error BK1503](bscmake-error-bk1503.md) \ -[BSCMAKE error BK1504](bscmake-error-bk1504.md) \ -[BSCMAKE error BK1505](bscmake-error-bk1505.md) \ -[BSCMAKE error BK1506](bscmake-error-bk1506.md) \ -[BSCMAKE error BK1507](bscmake-error-bk1507.md) \ -[BSCMAKE error BK1508](bscmake-error-bk1508.md) \ -[BSCMAKE error BK1509](bscmake-error-bk1509.md) \ -[BSCMAKE error BK1510](bscmake-error-bk1510.md) \ -[BSCMAKE error BK1512](bscmake-error-bk1512.md) \ -[BSCMAKE error BK1513](bscmake-error-bk1513.md) \ -[BSCMAKE error BK1514](bscmake-error-bk1514.md) \ -[BSCMAKE error BK1515](bscmake-error-bk1515.md) \ -[BSCMAKE error BK1516](bscmake-error-bk1516.md) \ -[BSCMAKE error BK1517](bscmake-error-bk1517.md) +| Error | Message | +|--|--| +| [BSCMAKE error BK1503](bscmake-error-bk1503.md) | cannot write to file 'filename' [: reason] | +| [BSCMAKE error BK1504](bscmake-error-bk1504.md) | cannot position in file 'filename' [: reason] | +| [BSCMAKE error BK1505](bscmake-error-bk1505.md) | cannot read from file 'filename' [: reason] | +| [BSCMAKE error BK1506](bscmake-error-bk1506.md) | cannot open file 'filename' [: reason] | +| [BSCMAKE error BK1507](bscmake-error-bk1507.md) | cannot open temporary file 'filename' [: reason] | +| [BSCMAKE error BK1508](bscmake-error-bk1508.md) | cannot delete temporary file 'filename' [: reason] | +| [BSCMAKE error BK1509](bscmake-error-bk1509.md) | out of heap space | +| [BSCMAKE error BK1510](bscmake-error-bk1510.md) | corrupt .SBR file filename | +| [BSCMAKE error BK1512](bscmake-error-bk1512.md) | filename: capacity exceeded | +| [BSCMAKE error BK1513](bscmake-error-bk1513.md) | nonincremental update requires all .SBR files | +| [BSCMAKE error BK1514](bscmake-error-bk1514.md) | all .SBR files truncated, none found in filename | +| [BSCMAKE error BK1515](bscmake-error-bk1515.md) | bscfile: incompatible version: cannot incrementally update | +| [BSCMAKE error BK1516](bscmake-error-bk1516.md) | bscfile corrupt; cannot incrementally update | +| [BSCMAKE error BK1517](bscmake-error-bk1517.md) | source file for sbrfile compiled with both /Yc and /Yu | ## Warning messages -[BSCMAKE warning BK4502](bscmake-warning-bk4502.md) \ -[BSCMAKE warning BK4503](bscmake-warning-bk4503.md) \ -[BSCMAKE warning BK4504](bscmake-warning-bk4504.md) +| Warning | Message | +|--|--| +| [BSCMAKE warning BK4502](bscmake-warning-bk4502.md) | truncated .SBR file 'filename' not in filename | +| [BSCMAKE warning BK4503](bscmake-warning-bk4503.md) | minor error in .SBR file filename ignored | +| [BSCMAKE warning BK4504](bscmake-warning-bk4504.md) | file contains too many references; ignoring further references from this source | ## See also From 11598355b4f9f61c784a07d5e0dc14f0864fde43 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 22:29:30 +0800 Subject: [PATCH 0372/1799] Simplify superfluous relative links in "BSCMAKE errors and warnings (BKxxxx)" --- .../tool-errors/bscmake-errors-bk1500-through-bk4505.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md index 567c9895c3e..68d2fef9447 100644 --- a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md +++ b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md @@ -8,7 +8,7 @@ ms.assetid: 3767baa6-e639-472e-99fd-7543fd945cd3 This section is a reference to the errors and warnings generated by the BSCMAKE build tool. BSCMAKE errors and warnings have the form BK*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Error messages From 2e76b3f360b57cde51f94e73a70f2296fd224f6c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 22:30:10 +0800 Subject: [PATCH 0373/1799] Remove space before escape in "BSCMAKE errors and warnings (BKxxxx)" --- .../tool-errors/bscmake-errors-bk1500-through-bk4505.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md index 68d2fef9447..022c3ee6cc6 100644 --- a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md +++ b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md @@ -39,5 +39,5 @@ This section is a reference to the errors and warnings generated by the BSCMAKE ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [BSCMake reference](../../build/reference/bscmake-reference.md) From b4dcc163b93d6f7df09e3c0793901cd7bda47d28 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 22:30:47 +0800 Subject: [PATCH 0374/1799] Update metadata in "BSCMAKE errors and warnings (BKxxxx)" --- .../tool-errors/bscmake-errors-bk1500-through-bk4505.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md index 022c3ee6cc6..59030414a39 100644 --- a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md +++ b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: BSCMAKE errors and warnings (BKxxxx)" title: "BSCMAKE errors and warnings" -ms.date: "04/16/2019" -ms.assetid: 3767baa6-e639-472e-99fd-7543fd945cd3 +description: "Learn more about: BSCMAKE errors and warnings (BKxxxx)" +ms.date: 04/16/2019 --- # BSCMAKE errors and warnings (BKxxxx) From 887af19916c94aa34dde5abe30cdc8d029bb62ee Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 22:38:36 +0800 Subject: [PATCH 0375/1799] Add blockquotes for error messages in range [C2081, C2100] --- docs/error-messages/compiler-errors-1/compiler-error-c2081.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2082.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2083.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2084.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2085.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2086.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2087.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2088.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2089.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2090.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2091.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2092.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2093.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2094.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2095.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2097.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2099.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2100.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md index 39c5c3f2863..3aa277b93e7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md @@ -8,7 +8,7 @@ ms.assetid: 7db9892d-364d-4178-a49d-f8398ece09a0 --- # Compiler Error C2081 -'identifier' : name in formal parameter list illegal +> 'identifier' : name in formal parameter list illegal The identifier caused a syntax error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md index e5a420137b4..a4eed106948 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md @@ -8,7 +8,7 @@ ms.assetid: 87a6d442-157c-46e8-9bff-8388f8338ae0 --- # Compiler Error C2082 -redefinition of formal parameter 'identifier' +> redefinition of formal parameter 'identifier' A formal parameter to a function is redeclared within the function body. To resolve the error, remove the redefinition. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2083.md b/docs/error-messages/compiler-errors-1/compiler-error-c2083.md index a3e24730c9d..07848867ad3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2083.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2083.md @@ -8,6 +8,6 @@ ms.assetid: 5fc4f931-eab6-4d8d-a3ee-3b8e11e64b18 --- # Compiler Error C2083 -struct/union comparison illegal +> struct/union comparison illegal A structure or union is compared directly with another user-defined type. This is not allowed unless a comparison operator has been defined or a conversion to a scalar type exists. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md index 19f1c11e732..0c24168b04a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md @@ -8,7 +8,7 @@ ms.assetid: 990b107f-3721-4851-ae8b-4b69a8c149ed --- # Compiler Error C2084 -function '*function*' already has a body +> function '*function*' already has a body The function has already been defined. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md index fcd890fb8ec..d83a22832b8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md @@ -8,7 +8,7 @@ ms.assetid: 0a86785c-8e6f-481b-8c7b-412220c1950d --- # Compiler Error C2085 -'identifier' : not in formal parameter list +> 'identifier' : not in formal parameter list The identifier was declared in a function definition but not in the formal parameter list. (ANSI C only) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md index 25867e1a3e7..f2961de2385 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2086"] --- # Compiler Error C2086 -'identifier' : redefinition +> 'identifier' : redefinition The identifier is defined more than once, or a subsequent declaration differs from a previous one. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md index 990afe20506..647a8f1e196 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md @@ -8,7 +8,7 @@ ms.assetid: 89761e83-415a-4468-a4c6-b6dedfd1dd6a --- # Compiler Error C2087 -'identifier' : missing subscript +> 'identifier' : missing subscript The definition of an array with multiple subscripts is missing a subscript value for a dimension higher than one. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md index d25127ed208..160c9004fb7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md @@ -8,7 +8,7 @@ ms.assetid: b93f7094-185b-423d-8bb9-507cd757dbf5 --- # Compiler Error C2088 -'operator' : illegal for 'class-key' +> 'operator' : illegal for 'class-key' The operator was not defined for the structure or union. This error is only valid for C code. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2089.md b/docs/error-messages/compiler-errors-1/compiler-error-c2089.md index 1bcf00bbc33..2726a2958f8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2089.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2089.md @@ -8,6 +8,6 @@ ms.assetid: 7c777775-5535-4eea-b6a2-340b71af9560 --- # Compiler Error C2089 -'identifier' : 'class-key' too large +> 'identifier' : 'class-key' too large The specified structure or union exceeds the 4GB limit. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md index 715aaff8d3c..71dd098f56a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md @@ -8,7 +8,7 @@ ms.assetid: e8176e55-382b-453d-aa27-6597f0274afd --- # Compiler Error C2090 -function returns array +> function returns array A function cannot return an array. Return a pointer to an array instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2091.md b/docs/error-messages/compiler-errors-1/compiler-error-c2091.md index 9b354713a20..20b6b06af2b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2091.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2091.md @@ -8,6 +8,6 @@ ms.assetid: 247c3b57-f123-4420-b68e-d65a364b63cb --- # Compiler Error C2091 -function returns function +> function returns function A function cannot return a function. Return a pointer to a function instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md index ed654b5ab5e..53809f0f36b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md @@ -8,7 +8,7 @@ ms.assetid: 037e44ae-16c8-489a-a512-dcdf7f7795a6 --- # Compiler Error C2092 -'array name' array element type cannot be function +> 'array name' array element type cannot be function Arrays of functions are not allowed. Use an array of pointers to functions. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md index 4cf2f9332a5..a46206ce7f5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md @@ -8,7 +8,7 @@ ms.assetid: 17529a70-9169-46b5-9fc6-57a5ce224e6a --- # Compiler Error C2093 -'variable1' : cannot be initialized using address of automatic variable 'variable2' +> 'variable1' : cannot be initialized using address of automatic variable 'variable2' When compiling with [/Za](../../build/reference/za-ze-disable-language-extensions.md), the program tried to use the address of an automatic variable as an initializer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md index 2fd470d2dd6..f65c55fa5e5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md @@ -8,7 +8,7 @@ ms.assetid: 9e4f8f88-f189-46e7-91c9-481bacc7af87 --- # Compiler Error C2094 -label 'identifier' was undefined +> label 'identifier' was undefined The label used by a [goto](../../cpp/goto-statement-cpp.md) statement does not exist in the function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2095.md b/docs/error-messages/compiler-errors-1/compiler-error-c2095.md index 0c20af59dd8..2e5f20a5293 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2095.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2095.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2095"] --- # Compiler Error C2095 -'function' : actual parameter has type 'void' : parameter 'number' +> 'function' : actual parameter has type 'void' : parameter 'number' The parameter passed to the function is type **`void`**, which is not allowed. Use a pointer to void (`void *`) instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2097.md b/docs/error-messages/compiler-errors-1/compiler-error-c2097.md index b17f2535fbd..27f83766934 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2097.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2097.md @@ -8,7 +8,7 @@ ms.assetid: 7e5b2fd4-f61c-4b8a-b265-93e987a04bd3 --- # Compiler Error C2097 -illegal initialization +> illegal initialization ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md index 05dd905b4a8..11a2d50b4fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md @@ -8,7 +8,7 @@ ms.assetid: 30e151ee-d458-4901-b0c0-d45054a913f5 --- # Compiler Error C2099 -initializer is not a constant +> initializer is not a constant This error is issued only by the C compiler and occurs only for non-automatic variables. The compiler initializes non-automatic variables at the start of the program and the values they are initialized with must be constant. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2100.md b/docs/error-messages/compiler-errors-1/compiler-error-c2100.md index c2ec8521884..93756d145e4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2100.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2100.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2100"] --- # Compiler Error C2100 -illegal indirection +> illegal indirection Indirection operator (`*`) is applied to a nonpointer value. From b93175aaea0112de8da317e3e85ff54db6f669af Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 22:42:45 +0800 Subject: [PATCH 0376/1799] Add "Remarks" and "Example" headings for error references in range [C2081, C2100] --- docs/error-messages/compiler-errors-1/compiler-error-c2081.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2082.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2083.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2084.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2085.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2086.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2087.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2088.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2089.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2090.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2091.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2092.md | 4 +++- docs/error-messages/compiler-errors-1/compiler-error-c2093.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2094.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2095.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2096.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2098.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2099.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2100.md | 4 ++++ 19 files changed, 57 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md index 3aa277b93e7..add9dcb7761 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md @@ -10,10 +10,14 @@ ms.assetid: 7db9892d-364d-4178-a49d-f8398ece09a0 > 'identifier' : name in formal parameter list illegal +## Remarks + The identifier caused a syntax error. This error can be caused by using the old style for the formal parameter list. You must specify the type of formal parameters in the formal parameter list. +## Example + The following sample generates C2081: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md index a4eed106948..2885a6a0fca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md @@ -10,8 +10,12 @@ ms.assetid: 87a6d442-157c-46e8-9bff-8388f8338ae0 > redefinition of formal parameter 'identifier' +## Remarks + A formal parameter to a function is redeclared within the function body. To resolve the error, remove the redefinition. +## Example + The following sample generates C2082: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2083.md b/docs/error-messages/compiler-errors-1/compiler-error-c2083.md index 07848867ad3..77f147de875 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2083.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2083.md @@ -10,4 +10,6 @@ ms.assetid: 5fc4f931-eab6-4d8d-a3ee-3b8e11e64b18 > struct/union comparison illegal +## Remarks + A structure or union is compared directly with another user-defined type. This is not allowed unless a comparison operator has been defined or a conversion to a scalar type exists. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md index 0c24168b04a..473f692d64c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md @@ -10,6 +10,8 @@ ms.assetid: 990b107f-3721-4851-ae8b-4b69a8c149ed > function '*function*' already has a body +## Remarks + The function has already been defined. Before Visual Studio 2002, diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md index d83a22832b8..1012b01ebc1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md @@ -10,8 +10,12 @@ ms.assetid: 0a86785c-8e6f-481b-8c7b-412220c1950d > 'identifier' : not in formal parameter list +## Remarks + The identifier was declared in a function definition but not in the formal parameter list. (ANSI C only) +## Example + The following sample generates C2085: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md index f2961de2385..668839b2e5b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C2086"] > 'identifier' : redefinition +## Remarks + The identifier is defined more than once, or a subsequent declaration differs from a previous one. C2086 can also be the result of incremental building for a referenced C# assembly. Rebuild the C# assembly to resolve this error. +## Example + The following sample generates C2086: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md index 647a8f1e196..9412f12a422 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md @@ -10,8 +10,12 @@ ms.assetid: 89761e83-415a-4468-a4c6-b6dedfd1dd6a > 'identifier' : missing subscript +## Remarks + The definition of an array with multiple subscripts is missing a subscript value for a dimension higher than one. +## Example + The following sample generates C2087: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md index 160c9004fb7..8b9187f5dda 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md @@ -10,8 +10,12 @@ ms.assetid: b93f7094-185b-423d-8bb9-507cd757dbf5 > 'operator' : illegal for 'class-key' +## Remarks + The operator was not defined for the structure or union. This error is only valid for C code. +## Example + The following sample generates C2088 three times: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2089.md b/docs/error-messages/compiler-errors-1/compiler-error-c2089.md index 2726a2958f8..afbce2d8e94 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2089.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2089.md @@ -10,4 +10,6 @@ ms.assetid: 7c777775-5535-4eea-b6a2-340b71af9560 > 'identifier' : 'class-key' too large +## Remarks + The specified structure or union exceeds the 4GB limit. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md index 71dd098f56a..7a11fd61544 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md @@ -10,8 +10,12 @@ ms.assetid: e8176e55-382b-453d-aa27-6597f0274afd > function returns array +## Remarks + A function cannot return an array. Return a pointer to an array instead. +## Example + The following sample generates C2090: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2091.md b/docs/error-messages/compiler-errors-1/compiler-error-c2091.md index 20b6b06af2b..f2b03ebf1ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2091.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2091.md @@ -10,4 +10,6 @@ ms.assetid: 247c3b57-f123-4420-b68e-d65a364b63cb > function returns function +## Remarks + A function cannot return a function. Return a pointer to a function instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md index 53809f0f36b..3a534d968ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md @@ -10,9 +10,11 @@ ms.assetid: 037e44ae-16c8-489a-a512-dcdf7f7795a6 > 'array name' array element type cannot be function +## Remarks + Arrays of functions are not allowed. Use an array of pointers to functions. -## Examples +## Example The following sample generates C2092: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md index a46206ce7f5..9f07719a2d2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md @@ -10,8 +10,12 @@ ms.assetid: 17529a70-9169-46b5-9fc6-57a5ce224e6a > 'variable1' : cannot be initialized using address of automatic variable 'variable2' +## Remarks + When compiling with [/Za](../../build/reference/za-ze-disable-language-extensions.md), the program tried to use the address of an automatic variable as an initializer. +## Example + The following sample generates C2093: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md index f65c55fa5e5..ab6848d084b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md @@ -10,6 +10,8 @@ ms.assetid: 9e4f8f88-f189-46e7-91c9-481bacc7af87 > label 'identifier' was undefined +## Remarks + The label used by a [goto](../../cpp/goto-statement-cpp.md) statement does not exist in the function. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2095.md b/docs/error-messages/compiler-errors-1/compiler-error-c2095.md index 2e5f20a5293..8a998415a2c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2095.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2095.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2095"] > 'function' : actual parameter has type 'void' : parameter 'number' +## Remarks + The parameter passed to the function is type **`void`**, which is not allowed. Use a pointer to void (`void *`) instead. The `number` indicates which parameter is **`void`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2096.md b/docs/error-messages/compiler-errors-1/compiler-error-c2096.md index 429150aba63..f5346648025 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2096.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2096.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C2096"] > '*identifier*': A data member cannot be initialized with a parenthesized initializer +## Remarks + The compiler expected a braced initializer or an equal expression initializer. To resolve the issue, replace the parenthesized initializer with a braced initializer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2098.md b/docs/error-messages/compiler-errors-1/compiler-error-c2098.md index b8c19fd652d..274e2d244da 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2098.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2098.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C2098"] > unexpected token after data member '*identifier*' +## Remarks + The compiler expected a semicolon, a braced initializer or an equal expression initializer. To resolve the issue, insert a semicolon or an initializer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md index 11a2d50b4fa..095134017eb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md @@ -10,6 +10,8 @@ ms.assetid: 30e151ee-d458-4901-b0c0-d45054a913f5 > initializer is not a constant +## Remarks + This error is issued only by the C compiler and occurs only for non-automatic variables. The compiler initializes non-automatic variables at the start of the program and the values they are initialized with must be constant. ## Examples diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2100.md b/docs/error-messages/compiler-errors-1/compiler-error-c2100.md index 93756d145e4..c50f0e06a45 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2100.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2100.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2100"] > illegal indirection +## Remarks + Indirection operator (`*`) is applied to a nonpointer value. +## Example + The following sample generates C2100: ```cpp From cc8b5f3a396e1f89611790406ce8456148331cf5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 22:44:00 +0800 Subject: [PATCH 0377/1799] Replace term "sample" with "example" for error references in range [C2081, C2100] --- docs/error-messages/compiler-errors-1/compiler-error-c2081.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2082.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2084.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2085.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2086.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2087.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2088.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2090.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2092.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2093.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2094.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2099.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2100.md | 2 +- 13 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md index add9dcb7761..846e5fe0261 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md @@ -18,7 +18,7 @@ This error can be caused by using the old style for the formal parameter list. Y ## Example -The following sample generates C2081: +The following example generates C2081: ```c // C2081.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md index 2885a6a0fca..8ddb86ec2db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md @@ -16,7 +16,7 @@ A formal parameter to a function is redeclared within the function body. To reso ## Example -The following sample generates C2082: +The following example generates C2082: ```cpp // C2082.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md index 473f692d64c..67555e8f275 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md @@ -22,7 +22,7 @@ Before Visual Studio 2002, ## Example -The following sample generates C2084: +The following example generates C2084: ```cpp // C2084.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md index 1012b01ebc1..7568fbf36b9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md @@ -16,7 +16,7 @@ The identifier was declared in a function definition but not in the formal param ## Example -The following sample generates C2085: +The following example generates C2085: ```c // C2085.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md index 668839b2e5b..a3cf0c60f0a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md @@ -17,7 +17,7 @@ C2086 can also be the result of incremental building for a referenced C# assembl ## Example -The following sample generates C2086: +The following example generates C2086: ```cpp // C2086.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md index 9412f12a422..fe75c63c446 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md @@ -16,7 +16,7 @@ The definition of an array with multiple subscripts is missing a subscript value ## Example -The following sample generates C2087: +The following example generates C2087: ```cpp // C2087.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md index 8b9187f5dda..04c4366cd29 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md @@ -16,7 +16,7 @@ The operator was not defined for the structure or union. This error is only vali ## Example -The following sample generates C2088 three times: +The following example generates C2088 three times: ```c // C2088.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md index 7a11fd61544..a0f79bc0a7b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md @@ -16,7 +16,7 @@ A function cannot return an array. Return a pointer to an array instead. ## Example -The following sample generates C2090: +The following example generates C2090: ```cpp // C2090.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md index 3a534d968ec..5ecdffac942 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md @@ -16,7 +16,7 @@ Arrays of functions are not allowed. Use an array of pointers to functions. ## Example -The following sample generates C2092: +The following example generates C2092: ```cpp // C2092.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md index 9f07719a2d2..b44c3257f09 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md @@ -16,7 +16,7 @@ When compiling with [/Za](../../build/reference/za-ze-disable-language-extension ## Example -The following sample generates C2093: +The following example generates C2093: ```c // C2093.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md index ab6848d084b..c25afc62131 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md @@ -16,7 +16,7 @@ The label used by a [goto](../../cpp/goto-statement-cpp.md) statement does not e ## Example -The following sample generates C2094: +The following example generates C2094: ```cpp // C2094.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md index 095134017eb..012ffe9ad36 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md @@ -16,7 +16,7 @@ This error is issued only by the C compiler and occurs only for non-automatic va ## Examples -The following sample generates C2099. +The following example generates C2099. ```c // C2099.c @@ -33,7 +33,7 @@ To resolve this error, compile the module as a .cpp file or simplify the express For more information, see [/fp (Specify Floating-Point Behavior)](../../build/reference/fp-specify-floating-point-behavior.md). -The following sample generates C2099. +The following example generates C2099. ```c // C2099_2.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2100.md b/docs/error-messages/compiler-errors-1/compiler-error-c2100.md index c50f0e06a45..e89c4bde438 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2100.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2100.md @@ -15,7 +15,7 @@ Indirection operator (`*`) is applied to a nonpointer value. ## Example -The following sample generates C2100: +The following example generates C2100: ```cpp // C2100.cpp From cd98b414fa1e2bdb6b44cc347179ac8c4a78de40 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 13 Jul 2025 22:48:15 +0800 Subject: [PATCH 0378/1799] Update metadata for error references in range [C2081, C2100] --- .../error-messages/compiler-errors-1/compiler-error-c2081.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2082.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2083.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2084.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2085.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2087.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2088.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2089.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2090.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2091.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2092.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2093.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2094.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2096.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2097.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2098.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2099.md | 5 ++--- 17 files changed, 32 insertions(+), 47 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md index 846e5fe0261..91f785dfd40 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2081" title: "Compiler Error C2081" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2081" +ms.date: 11/04/2016 f1_keywords: ["C2081"] helpviewer_keywords: ["C2081"] -ms.assetid: 7db9892d-364d-4178-a49d-f8398ece09a0 --- # Compiler Error C2081 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md index 8ddb86ec2db..205cdfdc0e3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2082" title: "Compiler Error C2082" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2082" +ms.date: 11/04/2016 f1_keywords: ["C2082"] helpviewer_keywords: ["C2082"] -ms.assetid: 87a6d442-157c-46e8-9bff-8388f8338ae0 --- # Compiler Error C2082 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2083.md b/docs/error-messages/compiler-errors-1/compiler-error-c2083.md index 77f147de875..c47d0828db9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2083.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2083.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2083" title: "Compiler Error C2083" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2083" +ms.date: 11/04/2016 f1_keywords: ["C2083"] helpviewer_keywords: ["C2083"] -ms.assetid: 5fc4f931-eab6-4d8d-a3ee-3b8e11e64b18 --- # Compiler Error C2083 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md index 67555e8f275..8133c53ace2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2084" title: "Compiler Error C2084" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2084" +ms.date: 11/04/2016 f1_keywords: ["C2084"] helpviewer_keywords: ["C2084"] -ms.assetid: 990b107f-3721-4851-ae8b-4b69a8c149ed --- # Compiler Error C2084 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md index 7568fbf36b9..ab918561c43 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2085" title: "Compiler Error C2085" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2085" +ms.date: 11/04/2016 f1_keywords: ["C2085"] helpviewer_keywords: ["C2085"] -ms.assetid: 0a86785c-8e6f-481b-8c7b-412220c1950d --- # Compiler Error C2085 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md index fe75c63c446..bbda0677224 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2087" title: "Compiler Error C2087" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2087" +ms.date: 11/04/2016 f1_keywords: ["C2087"] helpviewer_keywords: ["C2087"] -ms.assetid: 89761e83-415a-4468-a4c6-b6dedfd1dd6a --- # Compiler Error C2087 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md index 04c4366cd29..372c228b7e0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2088" title: "Compiler Error C2088" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2088" +ms.date: 11/04/2016 f1_keywords: ["C2088"] helpviewer_keywords: ["C2088"] -ms.assetid: b93f7094-185b-423d-8bb9-507cd757dbf5 --- # Compiler Error C2088 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2089.md b/docs/error-messages/compiler-errors-1/compiler-error-c2089.md index afbce2d8e94..caf451167e6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2089.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2089.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2089" title: "Compiler Error C2089" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2089" +ms.date: 11/04/2016 f1_keywords: ["C2089"] helpviewer_keywords: ["C2089"] -ms.assetid: 7c777775-5535-4eea-b6a2-340b71af9560 --- # Compiler Error C2089 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md index a0f79bc0a7b..384319cefd7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2090" title: "Compiler Error C2090" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2090" +ms.date: 11/04/2016 f1_keywords: ["C2090"] helpviewer_keywords: ["C2090"] -ms.assetid: e8176e55-382b-453d-aa27-6597f0274afd --- # Compiler Error C2090 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2091.md b/docs/error-messages/compiler-errors-1/compiler-error-c2091.md index f2b03ebf1ec..e873a8864ef 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2091.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2091.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2091" title: "Compiler Error C2091" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2091" +ms.date: 11/04/2016 f1_keywords: ["C2091"] helpviewer_keywords: ["C2091"] -ms.assetid: 247c3b57-f123-4420-b68e-d65a364b63cb --- # Compiler Error C2091 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md index 5ecdffac942..3b07baae29f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2092" title: "Compiler Error C2092" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2092" +ms.date: 11/04/2016 f1_keywords: ["C2092"] helpviewer_keywords: ["C2092"] -ms.assetid: 037e44ae-16c8-489a-a512-dcdf7f7795a6 --- # Compiler Error C2092 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md index b44c3257f09..ea575c36681 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2093" title: "Compiler Error C2093" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2093" +ms.date: 11/04/2016 f1_keywords: ["C2093"] helpviewer_keywords: ["C2093"] -ms.assetid: 17529a70-9169-46b5-9fc6-57a5ce224e6a --- # Compiler Error C2093 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md index c25afc62131..3c06cae2fe6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2094" title: "Compiler Error C2094" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2094" +ms.date: 11/04/2016 f1_keywords: ["C2094"] helpviewer_keywords: ["C2094"] -ms.assetid: 9e4f8f88-f189-46e7-91c9-481bacc7af87 --- # Compiler Error C2094 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2096.md b/docs/error-messages/compiler-errors-1/compiler-error-c2096.md index f5346648025..9121807028e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2096.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2096.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2096" title: "Compiler Error C2096" +description: "Learn more about: Compiler Error C2096" ms.date: 08/23/2022 f1_keywords: ["C2096"] helpviewer_keywords: ["C2096"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2097.md b/docs/error-messages/compiler-errors-1/compiler-error-c2097.md index 27f83766934..0c01d1f89aa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2097.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2097.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2097" title: "Compiler Error C2097" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2097" +ms.date: 11/04/2016 f1_keywords: ["C2097"] helpviewer_keywords: ["C2097"] -ms.assetid: 7e5b2fd4-f61c-4b8a-b265-93e987a04bd3 --- # Compiler Error C2097 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2098.md b/docs/error-messages/compiler-errors-1/compiler-error-c2098.md index 274e2d244da..886f3d8f80a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2098.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2098.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2098" title: "Compiler Error C2098" +description: "Learn more about: Compiler Error C2098" ms.date: 08/23/2022 f1_keywords: ["C2098"] helpviewer_keywords: ["C2098"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md index 012ffe9ad36..1547eff225b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2099" title: "Compiler Error C2099" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2099" +ms.date: 11/04/2016 f1_keywords: ["C2099"] helpviewer_keywords: ["C2099"] -ms.assetid: 30e151ee-d458-4901-b0c0-d45054a913f5 --- # Compiler Error C2099 From 221669395c9c88fed7349545d845c42912242d26 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 14 Jul 2025 22:37:34 +0800 Subject: [PATCH 0379/1799] Standardize paragraph about ASCII, SBCS, and MBCS --- .../single-byte-and-multibyte-character-sets.md | 2 +- docs/text/text-and-strings-in-visual-cpp.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md b/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md index 7d409c365c4..b045b2d565d 100644 --- a/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md +++ b/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md @@ -8,7 +8,7 @@ ms.assetid: 2cbc78ea-33c0-4cfb-b0df-7ce2458431ce --- # Single-byte and multibyte character sets -The ASCII character set defines characters in the range 0x00 - 0x7F. There are many other character sets, primarily European, that define the characters within the range 0x00 - 0x7F identically to the ASCII character set and also define an extended character set from 0x80 - 0xFF. An 8-bit, single-byte-character set (SBCS) is sufficient to represent the ASCII character set and the character sets for many European languages. However, some non-European character sets, such as Japanese Kanji, include many more characters than can be represented in a single-byte coding scheme, and so require multibyte-character set (MBCS) encoding. +The ASCII character set defines characters in the range 0x00 - 0x7F. There are other character sets, primarily European, that define the characters within the range 0x00 - 0x7F identically to the ASCII character set and also define an extended character set from 0x80 - 0xFF. Thus, an 8-bit, single-byte-character set (SBCS) is sufficient to represent the ASCII character set and the character sets for many European languages. However, some non-European character sets, such as Japanese Kanji, include many more characters than a single-byte coding scheme can represent, and therefore require multibyte-character set (MBCS) encoding. > [!NOTE] > Many Microsoft run-time library SBCS routines handle multibyte bytes, characters, and strings as appropriate. Many multibyte-character sets define the ASCII character set as a subset. In many multibyte character sets, each character in the range 0x00 - 0x7F is identical to the character that has the same value in the ASCII character set. For example, in both ASCII and MBCS character strings, the one-byte null character ('\0') has value 0x00 and indicates the terminating null character. diff --git a/docs/text/text-and-strings-in-visual-cpp.md b/docs/text/text-and-strings-in-visual-cpp.md index f7802b98794..feed7da2b4d 100644 --- a/docs/text/text-and-strings-in-visual-cpp.md +++ b/docs/text/text-and-strings-in-visual-cpp.md @@ -7,7 +7,7 @@ ms.assetid: a1bb27ac-abe5-4c6b-867d-f761d4b93205 --- # Text and Strings in Visual C++ -An important aspect of developing applications for international markets is the adequate representation of local character sets. The ASCII character set defines characters in the range 0x00 to 0x7F. There are other character sets, primarily European, that define the characters within the range 0x00 to 0x7F identically to the ASCII character set and also define an extended character set from 0x80 to 0xFF. Thus, an 8-bit, single-byte-character set (SBCS) is sufficient to represent the ASCII character set, as well as the character sets for many European languages. However, some non-European character sets, such as Japanese Kanji, include many more characters than a single-byte coding scheme can represent, and therefore require multibyte-character set (MBCS) encoding. +An important aspect of developing applications for international markets is the adequate representation of local character sets. The ASCII character set defines characters in the range 0x00 - 0x7F. There are other character sets, primarily European, that define the characters within the range 0x00 - 0x7F identically to the ASCII character set and also define an extended character set from 0x80 - 0xFF. Thus, an 8-bit, single-byte-character set (SBCS) is sufficient to represent the ASCII character set and the character sets for many European languages. However, some non-European character sets, such as Japanese Kanji, include many more characters than a single-byte coding scheme can represent, and therefore require multibyte-character set (MBCS) encoding. ## In This Section From df6a32bbc87052d41b93f233d9b56b1e55ad1748 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 14 Jul 2025 22:38:24 +0800 Subject: [PATCH 0380/1799] Update metadata in 2 topics --- .../single-byte-and-multibyte-character-sets.md | 3 +-- docs/text/text-and-strings-in-visual-cpp.md | 5 ++--- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md b/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md index b045b2d565d..cbebeccee27 100644 --- a/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md +++ b/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md @@ -1,10 +1,9 @@ --- title: "Single-Byte and Multibyte Character Sets" description: "An introduction to single and multi-byte character sets in the Microsoft runtime library." +ms.date: 11/04/2016 ms.topic: "concept-article" -ms.date: "11/04/2016" helpviewer_keywords: ["SBCS (single byte character set)", "MBCS [C++], about MBCS", "character sets [C++], multibyte", "character sets [C++], single byte"] -ms.assetid: 2cbc78ea-33c0-4cfb-b0df-7ce2458431ce --- # Single-byte and multibyte character sets diff --git a/docs/text/text-and-strings-in-visual-cpp.md b/docs/text/text-and-strings-in-visual-cpp.md index feed7da2b4d..2334f6557ec 100644 --- a/docs/text/text-and-strings-in-visual-cpp.md +++ b/docs/text/text-and-strings-in-visual-cpp.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Text and Strings in Visual C++" title: "Text and Strings in Visual C++" -ms.date: "11/04/2016" +description: "Learn more about: Text and Strings in Visual C++" +ms.date: 11/04/2016 helpviewer_keywords: ["globalization [C++], character sets", "programming [C++], international", "multiple language support [C++]", "Unicode [C++]", "international applications [C++], about international applications", "portability [C++]", "translation [C++], character sets", "non-European characters [C++]", "character sets [C++]", "globalization [C++]", "Japanese characters [C++]", "Kanji character support [C++]", "local character sets [C++]", "ASCII characters [C++]", "character sets [C++], about character sets", "localization [C++], character sets", "translating code [C++]", "localization [C++]", "character sets [C++], non-European", "portability [C++], character sets", "MBCS [C++], international programming"] -ms.assetid: a1bb27ac-abe5-4c6b-867d-f761d4b93205 --- # Text and Strings in Visual C++ From dcd44803548566b76d1f18ced6a0276db65147fe Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 14 Jul 2025 22:58:25 +0800 Subject: [PATCH 0381/1799] Add blockquotes for error messages in range [C2101, C2120] --- docs/error-messages/compiler-errors-1/compiler-error-c2101.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2102.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2103.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2104.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2105.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2106.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2107.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2109.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2110.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2111.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2112.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2113.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2114.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2115.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2117.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2118.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2120.md | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md index a01fe6598c8..1109b661fb5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2101"] --- # Compiler Error C2101 -'&' on constant +> '&' on constant The [address-of operator (**`&`**)](../../cpp/address-of-operator-amp.md) must have an l-value as operand. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md index 292bbccacca..cbacfcf1fe7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2102"] --- # Compiler Error C2102 -'&' requires l-value +> '&' requires l-value The [address-of operator (**`&`**)](../../cpp/address-of-operator-amp.md) must have an l-value as operand. Address of temporary values cannot be taken. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md index 3809ebf9833..3239ca1c655 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2103"] --- # Compiler Error C2103 -'&' on register variable +> '&' on register variable You cannot take the address of a register. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md index b2640fdd2d0..db3b70032a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md @@ -8,7 +8,7 @@ ms.assetid: 2ea78896-72a6-4901-a1fa-f33ea88ad61b --- # Compiler Error C2104 -'&' on bit field ignored +> '&' on bit field ignored You cannot take the address of a bit field. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md index 68cf1a2ad6c..581dc71d052 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md @@ -8,7 +8,7 @@ ms.assetid: 19b7f7bc-a9da-4d23-8193-005b6d09274f --- # Compiler Error C2105 -'operator' needs l-value +> 'operator' needs l-value The operator must have an l-value as operand. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md index 58fec648a53..9686f9988cb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md @@ -8,7 +8,7 @@ ms.assetid: d5c91a2e-04e4-4770-8478-788b98c52a53 --- # Compiler Error C2106 -'operator' : left operand must be l-value +> 'operator' : left operand must be l-value The operator must have an l-value as its left operand. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md index 1644f153374..6367dfbfe19 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md @@ -8,7 +8,7 @@ ms.assetid: 2866a121-884e-4bb5-8613-36de5817000e --- # Compiler Error C2107 -illegal index, indirection not allowed +> illegal index, indirection not allowed A subscript is applied to an expression that does not evaluate to a pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md index c6bff1af2df..07ba1eaf886 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md @@ -8,7 +8,7 @@ ms.assetid: 2d1ac79d-a985-4904-a38b-b270578d664d --- # Compiler Error C2109 -subscript requires array or pointer type +> subscript requires array or pointer type The subscript was used on a variable that was not an array. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2110.md b/docs/error-messages/compiler-errors-1/compiler-error-c2110.md index 42bfa8a9398..3c3a0482784 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2110.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2110.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2110"] --- # Compiler Error C2110 -'+' : cannot add two pointers +> '+' : cannot add two pointers An attempt was made to add two pointer values using the plus (`+`) operator. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2111.md b/docs/error-messages/compiler-errors-1/compiler-error-c2111.md index d0d6444cac7..7e91f345216 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2111.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2111.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2111"] --- # Compiler Error C2111 -'+' : pointer addition requires integral operand +> '+' : pointer addition requires integral operand An attempt was made to add a nonintegral value to a pointer using the plus (`+`) operator. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2112.md b/docs/error-messages/compiler-errors-1/compiler-error-c2112.md index 8c4236d97a3..9fac4a75292 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2112.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2112.md @@ -8,6 +8,6 @@ ms.assetid: 527a2fea-f585-4d00-bbb4-477aee17144b --- # Compiler Error C2112 -'-' : pointer subtraction requires integral or pointer operand +> '-' : pointer subtraction requires integral or pointer operand An attempt was made to subtract pointers that point to different types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2113.md b/docs/error-messages/compiler-errors-1/compiler-error-c2113.md index e22c5d9a149..cda3417c343 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2113.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2113.md @@ -8,6 +8,6 @@ ms.assetid: be85cb5e-b0ed-4fc9-b062-032bf7f59a4e --- # Compiler Error C2113 -'-' : pointer can only be subtracted from another pointer +> '-' : pointer can only be subtracted from another pointer The right operand in a subtraction operation was a pointer, but the left operand was not. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2114.md b/docs/error-messages/compiler-errors-1/compiler-error-c2114.md index ada80748121..0aebc899cd8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2114.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2114.md @@ -8,6 +8,6 @@ ms.assetid: c1b2445f-74eb-4dc8-8d5a-6c8627775ee8 --- # Compiler Error C2114 -'operator' : pointer on left; needs integral value on right +> 'operator' : pointer on left; needs integral value on right The left operand of `operator` was a pointer, so the right operand must be an integer value. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2115.md b/docs/error-messages/compiler-errors-1/compiler-error-c2115.md index 2125c5674c6..f6e011db5f3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2115.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2115.md @@ -8,6 +8,6 @@ ms.assetid: 95d76ab5-ddd7-4e29-8cac-24285dccc490 --- # Compiler Error C2115 -'identifier' : incompatible types +> 'identifier' : incompatible types An expression contained incompatible types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md index 1b5aeb3f185..636e562d5dd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md @@ -8,7 +8,7 @@ ms.assetid: b947379d-5861-42fc-ac26-170318579cbd --- # Compiler Error C2117 -'identifier' : array bounds overflow +> 'identifier' : array bounds overflow An array has too many initializers: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md index b10252e5e57..0960f36502c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md @@ -8,7 +8,7 @@ ms.assetid: bf4315d0-f085-4323-b813-96ee61a13bde --- # Compiler Error C2118 -negative subscript +> negative subscript The value defining the array size is larger than the maximum array size or smaller than zero. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md index fe8ca7df9c9..d0b39b784f2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md @@ -8,7 +8,7 @@ ms.assetid: b0f3f66c-6cd2-4f48-9ea3-c270b53c2b8c --- # Compiler Error C2120 -'void' illegal with all types +> 'void' illegal with all types The **`void`** type is used in a declaration with another type. From 2b194ace9dc9aaaf7592ae1b3ff8cb3badaeb1b2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 14 Jul 2025 23:02:44 +0800 Subject: [PATCH 0382/1799] Add "Remarks" and "Example" headings for error references in range [C2101, C2120] --- docs/error-messages/compiler-errors-1/compiler-error-c2101.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2102.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2103.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2104.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2105.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2106.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2107.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2109.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2110.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2111.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2112.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2113.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2114.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2115.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2116.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2117.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2118.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2120.md | 4 ++++ 18 files changed, 60 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md index 1109b661fb5..6a3e6cabd93 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2101"] > '&' on constant +## Remarks + The [address-of operator (**`&`**)](../../cpp/address-of-operator-amp.md) must have an l-value as operand. +## Example + The following sample generates C2101: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md index cbacfcf1fe7..76e9cd695db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2102"] > '&' requires l-value +## Remarks + The [address-of operator (**`&`**)](../../cpp/address-of-operator-amp.md) must have an l-value as operand. Address of temporary values cannot be taken. +## Example + The following sample generates C2102: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md index 3239ca1c655..035ccbed3f1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2103"] > '&' on register variable +## Remarks + You cannot take the address of a register. +## Example + The following sample generates C2103: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md index db3b70032a4..0a5de3eadad 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md @@ -10,8 +10,12 @@ ms.assetid: 2ea78896-72a6-4901-a1fa-f33ea88ad61b > '&' on bit field ignored +## Remarks + You cannot take the address of a bit field. +## Example + The following sample generates C2104: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md index 581dc71d052..9620990629d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md @@ -10,8 +10,12 @@ ms.assetid: 19b7f7bc-a9da-4d23-8193-005b6d09274f > 'operator' needs l-value +## Remarks + The operator must have an l-value as operand. +## Examples + The following sample generates C2105: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md index 9686f9988cb..feedd96d543 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md @@ -10,8 +10,12 @@ ms.assetid: d5c91a2e-04e4-4770-8478-788b98c52a53 > 'operator' : left operand must be l-value +## Remarks + The operator must have an l-value as its left operand. +## Example + The following sample generates C2106: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md index 6367dfbfe19..1a112e36046 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md @@ -10,6 +10,8 @@ ms.assetid: 2866a121-884e-4bb5-8613-36de5817000e > illegal index, indirection not allowed +## Remarks + A subscript is applied to an expression that does not evaluate to a pointer. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md index 07ba1eaf886..2baed1bfb76 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md @@ -10,8 +10,12 @@ ms.assetid: 2d1ac79d-a985-4904-a38b-b270578d664d > subscript requires array or pointer type +## Remarks + The subscript was used on a variable that was not an array. +## Example + The following sample generates C2109: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2110.md b/docs/error-messages/compiler-errors-1/compiler-error-c2110.md index 3c3a0482784..408ca974259 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2110.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2110.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2110"] > '+' : cannot add two pointers +## Remarks + An attempt was made to add two pointer values using the plus (`+`) operator. +## Example + The following sample generates C2110: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2111.md b/docs/error-messages/compiler-errors-1/compiler-error-c2111.md index 7e91f345216..e6aa6a5f1c9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2111.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2111.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2111"] > '+' : pointer addition requires integral operand +## Remarks + An attempt was made to add a nonintegral value to a pointer using the plus (`+`) operator. +## Example + The following sample generates C2111: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2112.md b/docs/error-messages/compiler-errors-1/compiler-error-c2112.md index 9fac4a75292..d871b857be6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2112.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2112.md @@ -10,4 +10,6 @@ ms.assetid: 527a2fea-f585-4d00-bbb4-477aee17144b > '-' : pointer subtraction requires integral or pointer operand +## Remarks + An attempt was made to subtract pointers that point to different types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2113.md b/docs/error-messages/compiler-errors-1/compiler-error-c2113.md index cda3417c343..24077d5da1b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2113.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2113.md @@ -10,4 +10,6 @@ ms.assetid: be85cb5e-b0ed-4fc9-b062-032bf7f59a4e > '-' : pointer can only be subtracted from another pointer +## Remarks + The right operand in a subtraction operation was a pointer, but the left operand was not. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2114.md b/docs/error-messages/compiler-errors-1/compiler-error-c2114.md index 0aebc899cd8..df955eab594 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2114.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2114.md @@ -10,4 +10,6 @@ ms.assetid: c1b2445f-74eb-4dc8-8d5a-6c8627775ee8 > 'operator' : pointer on left; needs integral value on right +## Remarks + The left operand of `operator` was a pointer, so the right operand must be an integer value. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2115.md b/docs/error-messages/compiler-errors-1/compiler-error-c2115.md index f6e011db5f3..885ddc3e28d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2115.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2115.md @@ -10,4 +10,6 @@ ms.assetid: 95d76ab5-ddd7-4e29-8cac-24285dccc490 > 'identifier' : incompatible types +## Remarks + An expression contained incompatible types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2116.md b/docs/error-messages/compiler-errors-1/compiler-error-c2116.md index 9dfd0d52b9c..6a9849eb033 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2116.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2116.md @@ -10,10 +10,10 @@ ms.assetid: 0089a23f-e6bd-4956-9b58-3bcca09ab5ad > function parameter lists do not match between declarations -The parameter list of a redeclared function doesn't match the parameter list used in an earlier declaration. - ## Remarks +The parameter list of a redeclared function doesn't match the parameter list used in an earlier declaration. + This error can occur if you use different types for the parameters when you redeclare an `extern "C"` function. This error may occur after an upgrade because of conformance changes in Visual Studio 2019. Starting in Visual Studio 2019 version 16.3, the [`/Zc:externC-`](../../build/reference/zc-externc.md) compiler option relaxes this check. The option must come after any [`/permissive-`](../../build/reference/permissive-standards-conformance.md) option on the command line. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md index 636e562d5dd..586d683a6b6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md @@ -10,12 +10,16 @@ ms.assetid: b947379d-5861-42fc-ac26-170318579cbd > 'identifier' : array bounds overflow +## Remarks + An array has too many initializers: - Array elements and initializers do not match in size and quantity. - No space for the null terminator in a string. +## Example + The following sample generates C2117: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md index 0960f36502c..0fc8d6d616a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md @@ -10,8 +10,12 @@ ms.assetid: bf4315d0-f085-4323-b813-96ee61a13bde > negative subscript +## Remarks + The value defining the array size is larger than the maximum array size or smaller than zero. +## Example + The following sample generates C2118: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md index d0b39b784f2..537aa366d1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md @@ -10,8 +10,12 @@ ms.assetid: b0f3f66c-6cd2-4f48-9ea3-c270b53c2b8c > 'void' illegal with all types +## Remarks + The **`void`** type is used in a declaration with another type. +## Example + The following sample generates C2120: ```cpp From 0f853979a167c8595d93c77f5f91e07d224cdc33 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 14 Jul 2025 23:04:48 +0800 Subject: [PATCH 0383/1799] Replace term "sample" with "example" for error references in range [C2101, C2120] --- docs/error-messages/compiler-errors-1/compiler-error-c2101.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2102.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2103.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2104.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2105.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2106.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2107.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2108.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2109.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2110.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2111.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2117.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2118.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2120.md | 2 +- 14 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md index 6a3e6cabd93..51325fe83ca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md @@ -15,7 +15,7 @@ The [address-of operator (**`&`**)](../../cpp/address-of-operator-amp.md) must h ## Example -The following sample generates C2101: +The following example generates C2101: ```cpp // C2101.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md index 76e9cd695db..3dad89e5d6f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md @@ -15,7 +15,7 @@ The [address-of operator (**`&`**)](../../cpp/address-of-operator-amp.md) must h ## Example -The following sample generates C2102: +The following example generates C2102: ```cpp // C2102.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md index 035ccbed3f1..2ffdba8f0a2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md @@ -15,7 +15,7 @@ You cannot take the address of a register. ## Example -The following sample generates C2103: +The following example generates C2103: ```c // C2103.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md index 0a5de3eadad..1ceadd9b377 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md @@ -16,7 +16,7 @@ You cannot take the address of a bit field. ## Example -The following sample generates C2104: +The following example generates C2104: ```cpp // C2104.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md index 9620990629d..ca4104402e6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md @@ -16,7 +16,7 @@ The operator must have an l-value as operand. ## Examples -The following sample generates C2105: +The following example generates C2105: ```cpp // C2105.cpp @@ -33,7 +33,7 @@ int main() { } ``` -The following sample generates C2105: +The following example generates C2105: ```cpp // C2105b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md index feedd96d543..04773102b58 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md @@ -16,7 +16,7 @@ The operator must have an l-value as its left operand. ## Example -The following sample generates C2106: +The following example generates C2106: ```cpp // C2106.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md index 1a112e36046..e1c59745f99 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md @@ -18,7 +18,7 @@ A subscript is applied to an expression that does not evaluate to a pointer. C2107 can occur if you incorrectly use the **`this`** pointer of a value type to access the type's default indexer. For more information, see [Semantics of the `this` pointer](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Semantics_of_the_this_pointer). -The following sample generates C2107. +The following example generates C2107. ```cpp // C2107.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2108.md b/docs/error-messages/compiler-errors-1/compiler-error-c2108.md index 4560690ae78..01b4a01fba0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2108.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2108.md @@ -18,7 +18,7 @@ The array subscript is a non-integer expression. C2108 can occur if you incorrectly use the **`this`** pointer of a value type to access the type's default indexer. For more information, see [Semantics of the `this` pointer](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Semantics_of_the_this_pointer). -The following sample generates C2108. +The following example generates C2108. ```cpp // C2108.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md index 2baed1bfb76..a2090f2a2e2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md @@ -16,7 +16,7 @@ The subscript was used on a variable that was not an array. ## Example -The following sample generates C2109: +The following example generates C2109: ```cpp // C2109.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2110.md b/docs/error-messages/compiler-errors-1/compiler-error-c2110.md index 408ca974259..480293e439d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2110.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2110.md @@ -15,7 +15,7 @@ An attempt was made to add two pointer values using the plus (`+`) operator. ## Example -The following sample generates C2110: +The following example generates C2110: ```cpp // C2110.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2111.md b/docs/error-messages/compiler-errors-1/compiler-error-c2111.md index e6aa6a5f1c9..f8a9305aa9b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2111.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2111.md @@ -15,7 +15,7 @@ An attempt was made to add a nonintegral value to a pointer using the plus (`+`) ## Example -The following sample generates C2111: +The following example generates C2111: ```cpp // C2111.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md index 586d683a6b6..67ce47c2b63 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md @@ -20,7 +20,7 @@ An array has too many initializers: ## Example -The following sample generates C2117: +The following example generates C2117: ```cpp // C2117.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md index 0fc8d6d616a..1225f230b1b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md @@ -16,7 +16,7 @@ The value defining the array size is larger than the maximum array size or small ## Example -The following sample generates C2118: +The following example generates C2118: ```cpp // C2118.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md index 537aa366d1a..ed345afb47f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md @@ -16,7 +16,7 @@ The **`void`** type is used in a declaration with another type. ## Example -The following sample generates C2120: +The following example generates C2120: ```cpp // C2120.cpp From 43e8603c7a20477f323fc269e7d09c3db0a03ecf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 14 Jul 2025 23:08:00 +0800 Subject: [PATCH 0384/1799] Update metadata for error references in range [C2101, C2120] --- .../error-messages/compiler-errors-1/compiler-error-c2101.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2102.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2103.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2104.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2105.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2106.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2107.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2108.md | 3 +-- .../error-messages/compiler-errors-1/compiler-error-c2109.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2112.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2113.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2114.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2115.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2116.md | 3 +-- .../error-messages/compiler-errors-1/compiler-error-c2117.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2118.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2120.md | 5 ++--- 17 files changed, 32 insertions(+), 46 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md index 51325fe83ca..e2703e5d860 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2101" title: "Compiler Error C2101" -ms.date: "03/04/2024" +description: "Learn more about: Compiler Error C2101" +ms.date: 03/04/2024 f1_keywords: ["C2101"] helpviewer_keywords: ["C2101"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md index 3dad89e5d6f..7db34d038f0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2102" title: "Compiler Error C2102" -ms.date: "03/03/2024" +description: "Learn more about: Compiler Error C2102" +ms.date: 03/03/2024 f1_keywords: ["C2102"] helpviewer_keywords: ["C2102"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md index 2ffdba8f0a2..af055b688c2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2103" title: "Compiler Error C2103" -ms.date: "03/04/2024" +description: "Learn more about: Compiler Error C2103" +ms.date: 03/04/2024 f1_keywords: ["C2103"] helpviewer_keywords: ["C2103"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md index 1ceadd9b377..957f09c7a3f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2104" title: "Compiler Error C2104" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2104" +ms.date: 11/04/2016 f1_keywords: ["C2104"] helpviewer_keywords: ["C2104"] -ms.assetid: 2ea78896-72a6-4901-a1fa-f33ea88ad61b --- # Compiler Error C2104 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md index ca4104402e6..55de44e8302 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2105" title: "Compiler Error C2105" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2105" +ms.date: 11/04/2016 f1_keywords: ["C2105"] helpviewer_keywords: ["C2105"] -ms.assetid: 19b7f7bc-a9da-4d23-8193-005b6d09274f --- # Compiler Error C2105 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md index 04773102b58..e22d82019d7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2106" title: "Compiler Error C2106" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2106" +ms.date: 11/04/2016 f1_keywords: ["C2106"] helpviewer_keywords: ["C2106"] -ms.assetid: d5c91a2e-04e4-4770-8478-788b98c52a53 --- # Compiler Error C2106 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md index e1c59745f99..51bcd37722f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2107" title: "Compiler Error C2107" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2107" +ms.date: 11/04/2016 f1_keywords: ["C2107"] helpviewer_keywords: ["C2107"] -ms.assetid: 2866a121-884e-4bb5-8613-36de5817000e --- # Compiler Error C2107 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2108.md b/docs/error-messages/compiler-errors-1/compiler-error-c2108.md index 01b4a01fba0..fa7b26db53e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2108.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2108.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2108" title: "Compiler Error C2108" +description: "Learn more about: Compiler Error C2108" ms.date: 06/03/2022 f1_keywords: ["C2108"] helpviewer_keywords: ["C2108"] -ms.assetid: c84f0b47-5e2c-47d2-8edb-427a40e17c36 --- # Compiler Error C2108 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md index a2090f2a2e2..8092ba90016 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2109" title: "Compiler Error C2109" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2109" +ms.date: 11/04/2016 f1_keywords: ["C2109"] helpviewer_keywords: ["C2109"] -ms.assetid: 2d1ac79d-a985-4904-a38b-b270578d664d --- # Compiler Error C2109 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2112.md b/docs/error-messages/compiler-errors-1/compiler-error-c2112.md index d871b857be6..1928506edc0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2112.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2112.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2112" title: "Compiler Error C2112" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2112" +ms.date: 11/04/2016 f1_keywords: ["C2112"] helpviewer_keywords: ["C2112"] -ms.assetid: 527a2fea-f585-4d00-bbb4-477aee17144b --- # Compiler Error C2112 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2113.md b/docs/error-messages/compiler-errors-1/compiler-error-c2113.md index 24077d5da1b..bfeb4b2390c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2113.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2113.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2113" title: "Compiler Error C2113" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2113" +ms.date: 11/04/2016 f1_keywords: ["C2113"] helpviewer_keywords: ["C2113"] -ms.assetid: be85cb5e-b0ed-4fc9-b062-032bf7f59a4e --- # Compiler Error C2113 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2114.md b/docs/error-messages/compiler-errors-1/compiler-error-c2114.md index df955eab594..75831e51f9d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2114.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2114.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2114" title: "Compiler Error C2114" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2114" +ms.date: 11/04/2016 f1_keywords: ["C2114"] helpviewer_keywords: ["C2114"] -ms.assetid: c1b2445f-74eb-4dc8-8d5a-6c8627775ee8 --- # Compiler Error C2114 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2115.md b/docs/error-messages/compiler-errors-1/compiler-error-c2115.md index 885ddc3e28d..52147bca167 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2115.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2115.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2115" title: "Compiler Error C2115" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2115" +ms.date: 11/04/2016 f1_keywords: ["C2115"] helpviewer_keywords: ["C2115"] -ms.assetid: 95d76ab5-ddd7-4e29-8cac-24285dccc490 --- # Compiler Error C2115 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2116.md b/docs/error-messages/compiler-errors-1/compiler-error-c2116.md index 6a9849eb033..f0b37397e6f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2116.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2116.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2116" title: "Compiler Error C2116" +description: "Learn more about: Compiler Error C2116" ms.date: 12/02/2021 f1_keywords: ["C2116"] helpviewer_keywords: ["C2116"] -ms.assetid: 0089a23f-e6bd-4956-9b58-3bcca09ab5ad --- # Compiler Error C2116 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md index 67ce47c2b63..9776f59ce2e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2117" title: "Compiler Error C2117" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2117" +ms.date: 11/04/2016 f1_keywords: ["C2117"] helpviewer_keywords: ["C2117"] -ms.assetid: b947379d-5861-42fc-ac26-170318579cbd --- # Compiler Error C2117 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md index 1225f230b1b..b033bb8ddc7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2118" title: "Compiler Error C2118" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2118" +ms.date: 11/04/2016 f1_keywords: ["C2118"] helpviewer_keywords: ["C2118"] -ms.assetid: bf4315d0-f085-4323-b813-96ee61a13bde --- # Compiler Error C2118 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md index ed345afb47f..b3f630d7c1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2120" title: "Compiler Error C2120" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2120" +ms.date: 11/04/2016 f1_keywords: ["C2120"] helpviewer_keywords: ["C2120"] -ms.assetid: b0f3f66c-6cd2-4f48-9ea3-c270b53c2b8c --- # Compiler Error C2120 From 021add5ae944feb1a5c8ff8f2a6394e2acb7a6ac Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 14 Jul 2025 12:45:56 -0700 Subject: [PATCH 0385/1799] List corresponding toolset versions for `_MSC_VER` --- docs/overview/compiler-versions.md | 90 +++++++++++++++--------------- 1 file changed, 45 insertions(+), 45 deletions(-) diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index 60666e3f291..e28beaf6d0f 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -79,51 +79,51 @@ When the major version changed between Visual Studio 2013 and Visual Studio 2015 An example of a minor change is from Visual Studio 2022 17.1 to Visual Studio 2022 17.2. In that case, `_MSC_VER` changed from 1931 to 1932. -The following table lists the Visual C++ compiler `_MSC_VER` for each Visual Studio release: - -| Visual Studio version | `_MSC_VER` | -|--|--| -| Visual Studio 6.0 | 1200 | -| Visual Studio .NET 2002 (7.0) | 1300 | -| Visual Studio .NET 2003 (7.1) | 1310 | -| Visual Studio 2005 (8.0) | 1400 | -| Visual Studio 2008 (9.0) | 1500 | -| Visual Studio 2010 (10.0) | 1600 | -| Visual Studio 2012 (11.0) | 1700 | -| Visual Studio 2013 (12.0) | 1800 | -| Visual Studio 2015 (14.0) | 1900 | -| Visual Studio 2017 RTW (15.0) | 1910 | -| Visual Studio 2017 version 15.3 | 1911 | -| Visual Studio 2017 version 15.5 | 1912 | -| Visual Studio 2017 version 15.6 | 1913 | -| Visual Studio 2017 version 15.7 | 1914 | -| Visual Studio 2017 version 15.8 | 1915 | -| Visual Studio 2017 version 15.9 | 1916 | -| Visual Studio 2019 RTW 16.0 | 1920 | -| Visual Studio 2019 version 16.1 | 1921 | -| Visual Studio 2019 version 16.2 | 1922 | -| Visual Studio 2019 version 16.3 | 1923 | -| Visual Studio 2019 version 16.4 | 1924 | -| Visual Studio 2019 version 16.5 | 1925 | -| Visual Studio 2019 version 16.6 | 1926 | -| Visual Studio 2019 version 16.7 | 1927 | -| Visual Studio 2019 version 16.8, 16.9 a | 1928 | -| Visual Studio 2019 version 16.10, 16.11 b | 1929 | -| Visual Studio 2022 RTW 17.0 | 1930 | -| Visual Studio 2022 version 17.1 | 1931 | -| Visual Studio 2022 version 17.2 | 1932 | -| Visual Studio 2022 version 17.3 | 1933 | -| Visual Studio 2022 version 17.4 | 1934 | -| Visual Studio 2022 version 17.5 | 1935 | -| Visual Studio 2022 version 17.6 | 1936 | -| Visual Studio 2022 version 17.7 | 1937 | -| Visual Studio 2022 version 17.8 | 1938 | -| Visual Studio 2022 version 17.9 | 1939 | -| Visual Studio 2022 version 17.10 | 1940 | -| Visual Studio 2022 version 17.11 | 1941 | -| Visual Studio 2022 version 17.12 | 1942 | -| Visual Studio 2022 version 17.13 | 1943 | -| Visual Studio 2022 version 17.14 | 1944 | +The following table lists the Visual C++ compiler `_MSC_VER` for each corresponding Visual Studio and toolset release: + +| Visual Studio version | `_MSC_VER` | toolset version | +|--|--|--| +| Visual Studio 6.0 | 1200 | 6.0 | +| Visual Studio .NET 2002 (7.0) | 1300 | 7.0 | +| Visual Studio .NET 2003 (7.1) | 1310 | 7.1 | +| Visual Studio 2005 (8.0) | 1400 | 8.00 | +| Visual Studio 2008 (9.0) | 1500 | 9.00 | +| Visual Studio 2010 (10.0) | 1600 | 10.00 | +| Visual Studio 2012 (11.0) | 1700 | 11.00 | +| Visual Studio 2013 (12.0) | 1800 | 12.00 | +| Visual Studio 2015 (14.0) | 1900 | 14.00 | +| Visual Studio 2017 RTW (15.0) | 1910 | 14.10 | +| Visual Studio 2017 version 15.3 | 1911 | 14.11 | +| Visual Studio 2017 version 15.5 | 1912 | 14.12 | +| Visual Studio 2017 version 15.6 | 1913 | 14.13 | +| Visual Studio 2017 version 15.7 | 1914 | 14.14 | +| Visual Studio 2017 version 15.8 | 1915 | 14.15 | +| Visual Studio 2017 version 15.9 | 1916 | 14. 16| +| Visual Studio 2019 RTW 16.0 | 1920 | 14.20 | +| Visual Studio 2019 version 16.1 | 1921 | 14.21 | +| Visual Studio 2019 version 16.2 | 1922 | 14.22 | +| Visual Studio 2019 version 16.3 | 1923 | 14.23 | +| Visual Studio 2019 version 16.4 | 1924 | 14.24 | +| Visual Studio 2019 version 16.5 | 1925 | 14.25 | +| Visual Studio 2019 version 16.6 | 1926 | 14.26 | +| Visual Studio 2019 version 16.7 | 1927 | 14.27 | +| Visual Studio 2019 version 16.8, 16.9 a | 1928 | 14.28 | +| Visual Studio 2019 version 16.10, 16.11 b | 1929 | 14.29 | +| Visual Studio 2022 RTW 17.0 | 1930 | 14.30 | +| Visual Studio 2022 version 17.1 | 1931 | 14.31 | +| Visual Studio 2022 version 17.2 | 1932 | 14.32 | +| Visual Studio 2022 version 17.3 | 1933 | 14.33 | +| Visual Studio 2022 version 17.4 | 1934 | 14.34 | +| Visual Studio 2022 version 17.5 | 1935 | 14.35 | +| Visual Studio 2022 version 17.6 | 1936 | 14.36 | +| Visual Studio 2022 version 17.7 | 1937 | 14.37 | +| Visual Studio 2022 version 17.8 | 1938 | 14.38 | +| Visual Studio 2022 version 17.9 | 1939 | 14.39 | +| Visual Studio 2022 version 17.10 | 1940 | 14.40 | +| Visual Studio 2022 version 17.11 | 1941 | 14.41 | +| Visual Studio 2022 version 17.12 | 1942 | 14.42 | +| Visual Studio 2022 version 17.13 | 1943 | 14.43 | +| Visual Studio 2022 version 17.14 | 1944 | 14.44 | a Visual Studio 2019 16.8 and 16.9 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.8 is 192829333. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.9 is 192829910. From 66a78d93cd1a96df9c5302ba4c6f721191af100c Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 14 Jul 2025 12:47:10 -0700 Subject: [PATCH 0386/1799] remove extra whitespace --- docs/overview/compiler-versions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index e28beaf6d0f..25311d76456 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -98,7 +98,7 @@ The following table lists the Visual C++ compiler `_MSC_VER` for each correspond | Visual Studio 2017 version 15.6 | 1913 | 14.13 | | Visual Studio 2017 version 15.7 | 1914 | 14.14 | | Visual Studio 2017 version 15.8 | 1915 | 14.15 | -| Visual Studio 2017 version 15.9 | 1916 | 14. 16| +| Visual Studio 2017 version 15.9 | 1916 | 14.16| | Visual Studio 2019 RTW 16.0 | 1920 | 14.20 | | Visual Studio 2019 version 16.1 | 1921 | 14.21 | | Visual Studio 2019 version 16.2 | 1922 | 14.22 | From f17075b5aca076e57947efcb729d572e4ce9fe00 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 14 Jul 2025 12:47:33 -0700 Subject: [PATCH 0387/1799] have common spacing --- docs/overview/compiler-versions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index 25311d76456..c2d54fb9683 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -98,7 +98,7 @@ The following table lists the Visual C++ compiler `_MSC_VER` for each correspond | Visual Studio 2017 version 15.6 | 1913 | 14.13 | | Visual Studio 2017 version 15.7 | 1914 | 14.14 | | Visual Studio 2017 version 15.8 | 1915 | 14.15 | -| Visual Studio 2017 version 15.9 | 1916 | 14.16| +| Visual Studio 2017 version 15.9 | 1916 | 14.16 | | Visual Studio 2019 RTW 16.0 | 1920 | 14.20 | | Visual Studio 2019 version 16.1 | 1921 | 14.21 | | Visual Studio 2019 version 16.2 | 1922 | 14.22 | From ac6f3fc99e365b3bcdd7ba9baf2403e798a0883d Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 14 Jul 2025 12:58:10 -0700 Subject: [PATCH 0388/1799] Document ASan's `continue_on_error` flag --- docs/sanitizers/asan-runtime.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index b4894a00b60..3d9c36279a1 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -160,6 +160,8 @@ Boolean (false by default), set to `true` to enable the process to terminate wit >[!NOTE] >When abort_on_error value is set to true, on Windows the program terminates with an exit(3). In order to not change current behavior we decided to introduce this new option instead. If both abort_on_error and windows_fast_fail_on_error are true, the program will exit with the __fastfail. +- [`continue_on_error`](./asan-continue-on-error) Boolean, set to `false` by default. When set to `true`, it allows the program to continue executing after a memory violation is reported, allowing you to collect multiple error reports. + ##
AddressSanitizer list of intercepted functions (Windows) The AddressSanitizer runtime hotpatches many functions to enable memory safety checks at runtime. Here's a non-exhaustive list of the functions that the AddressSanitizer runtime monitors. From a105ba5c3c42d201804e50118b5c76040e26d4c4 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 14 Jul 2025 12:59:14 -0700 Subject: [PATCH 0389/1799] capitalize toolset --- docs/overview/compiler-versions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index c2d54fb9683..818b7df8106 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -81,7 +81,7 @@ An example of a minor change is from Visual Studio 2022 17.1 to Visual Studio 20 The following table lists the Visual C++ compiler `_MSC_VER` for each corresponding Visual Studio and toolset release: -| Visual Studio version | `_MSC_VER` | toolset version | +| Visual Studio version | `_MSC_VER` | Toolset version | |--|--|--| | Visual Studio 6.0 | 1200 | 6.0 | | Visual Studio .NET 2002 (7.0) | 1300 | 7.0 | From 70b7bce1115ecab70a1e72f16716e3d31dcf05e3 Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 14 Jul 2025 13:27:11 -0700 Subject: [PATCH 0390/1799] clarify that toolset = MSVC toolset --- docs/overview/compiler-versions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index 818b7df8106..57c03deb47b 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -79,9 +79,9 @@ When the major version changed between Visual Studio 2013 and Visual Studio 2015 An example of a minor change is from Visual Studio 2022 17.1 to Visual Studio 2022 17.2. In that case, `_MSC_VER` changed from 1931 to 1932. -The following table lists the Visual C++ compiler `_MSC_VER` for each corresponding Visual Studio and toolset release: +The following table lists the Visual C++ compiler `_MSC_VER` for each corresponding Visual Studio and MSVC toolset release: -| Visual Studio version | `_MSC_VER` | Toolset version | +| Visual Studio version | `_MSC_VER` | MSVC toolset version | |--|--|--| | Visual Studio 6.0 | 1200 | 6.0 | | Visual Studio .NET 2002 (7.0) | 1300 | 7.0 | From 14a493b171f7d37a012c4a95a375ecea343b4c3f Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 14 Jul 2025 13:30:48 -0700 Subject: [PATCH 0391/1799] remove `./` from local href --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 3d9c36279a1..531262c750d 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -160,7 +160,7 @@ Boolean (false by default), set to `true` to enable the process to terminate wit >[!NOTE] >When abort_on_error value is set to true, on Windows the program terminates with an exit(3). In order to not change current behavior we decided to introduce this new option instead. If both abort_on_error and windows_fast_fail_on_error are true, the program will exit with the __fastfail. -- [`continue_on_error`](./asan-continue-on-error) Boolean, set to `false` by default. When set to `true`, it allows the program to continue executing after a memory violation is reported, allowing you to collect multiple error reports. +- [`continue_on_error`](asan-continue-on-error) Boolean, set to `false` by default. When set to `true`, it allows the program to continue executing after a memory violation is reported, allowing you to collect multiple error reports. ## AddressSanitizer list of intercepted functions (Windows) From ec732f1cef8601c2c2efe88d6d744c8606d81cae Mon Sep 17 00:00:00 2001 From: David Justo Date: Mon, 14 Jul 2025 14:05:50 -0700 Subject: [PATCH 0392/1799] add missing `.md` --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 531262c750d..eefff67b8e0 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -160,7 +160,7 @@ Boolean (false by default), set to `true` to enable the process to terminate wit >[!NOTE] >When abort_on_error value is set to true, on Windows the program terminates with an exit(3). In order to not change current behavior we decided to introduce this new option instead. If both abort_on_error and windows_fast_fail_on_error are true, the program will exit with the __fastfail. -- [`continue_on_error`](asan-continue-on-error) Boolean, set to `false` by default. When set to `true`, it allows the program to continue executing after a memory violation is reported, allowing you to collect multiple error reports. +- [`continue_on_error`](asan-continue-on-error.md) Boolean, set to `false` by default. When set to `true`, it allows the program to continue executing after a memory violation is reported, allowing you to collect multiple error reports. ## AddressSanitizer list of intercepted functions (Windows) From 14011eba1b2195ee04c0b1d4e9c9bcc75dedb7ee Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 14 Jul 2025 14:34:13 -0700 Subject: [PATCH 0393/1799] draft --- .../tutorials/build-insights-template-view.md | 101 +++++++++--------- 1 file changed, 48 insertions(+), 53 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index 1c46be7da1d..cdd12cc4eb2 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -9,7 +9,7 @@ ms.topic: troubleshooting-general Use Build Insights **Templates** view to analyze the impact of template instantiations on C++ build time. This feature is especially useful for projects that make heavy use of templates, such as those using template metaprogramming or large generic libraries. -Templates view is designed to be familiar to users of the [Functions view](build-insights-function-view.md), with similar UI and workflow. +Templates view will seem familiar to users of Build Insight's [Functions view](build-insights-function-view.md) due to similar UI and workflow. ## Prerequisites @@ -23,13 +23,11 @@ Templates view is designed to be familiar to users of the [Functions view](build ## Overview -Build Insights, integrated into Visual Studio, helps you optimize your build times--especially for large projects like AAA games. Build Insights provides analytics such as **Templates** view, which helps diagnose expensive template instantiations during build time. It displays the time it takes to instantiate each template and shows which template instantiations add the most to your build time. +Build Insights, integrated into Visual Studio, helps you optimize your build times--especially for large projects like AAA games. Build Insights provides analytics such as **Templates** view, which displays the time it takes to instantiate each template and shows which template instantiations add the most to your build time. -For optimized builds, the time spent on template instantiation contributes significantly to the total build time. In general, C++ template instantiation happens quickly. In exceptional cases, some template instantiations can noticeably slow down your builds. +In general, C++ template instantiation happens quickly. In exceptional cases, some template instantiations can noticeably slow down your builds. -In this article, learn how to use the Build Insights **Templates** view to find template instantiation bottlenecks in your build. - -Follow along to create a project that demonstrates template instantiation, run Build Insights to gather template instantiation times, and analyze the results. +In this article, follow along to create a project that demonstrates template instantiation impact on build time, run Build Insights to gather template instantiation times, and analyze the results. ## Create a template test project @@ -109,9 +107,9 @@ Template instantiation time collection is off by default to minimize build overh :::image type="content" source="./media/tools-options-build-insights.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Build Insights > Trace Collection. The Collect Template Instantion checkbox is selected."::: > [!Note] -> Collecting template instantiation times may increase build time due to the extra data collected. Only enable it when you want to analyze template instantiation bottlenecks. +> Collecting template instantiation times increases build time due to the extra data collected. Only enable it when you want to analyze template instantiation bottlenecks. -## Run Build Insights to get template instantiation times +## Run Build Insights to get template instantiation data From the main menu, select **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project. @@ -119,19 +117,23 @@ From the main menu, select **Build** > **Run Build Insights on Selection** > **R When the build finishes, an Event Trace Log (ETL) file opens.The generated name is based on the collection time. -## Use Templates view to optimize build time - -The **Templates** view lists the template instantiations that contributed significantly to build time. Columns provide information about: +## Understanding Templates view results -The **Time [sec, %]** column shows how long it took to instantiate each template in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among template instantiations based on their use of parallel compiler threads. +When interpreting Templates view results, keep these points in mind: -The **Specialization Name** column shows the specific template instantiation, including the template arguments that were used. This helps you identify which template specializations are most expensive. +- **Empty view**: If nothing shows up in the Templates view, it means your build time isn't dominated by template instantiations. This is good news because your templates are not a build bottleneck. +- **Duplicate instantiations**: The same template instantiation appearing multiple times with different translation units indicates that multiple source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. +- **Threshold filtering**: The view only shows instantiations whose contribution exceeds a certain threshold to avoid noise from trivial instantiations. +- **Time aggregation**: The time shown represents the total time spent on that specific template instantiation, including any nested instantiations it triggers. -The **Translation Unit** column shows which source file caused this template instantiation. Multiple files can cause the same template instantiation if they include the same header with the template definition. +## Use Templates view to optimize build time -The **Instantiation File Path** column shows where in your source code the template instantiation happens. This helps you locate the exact line of code responsible for the expensive instantiation. +The **Templates** view lists the template instantiations that contributed significantly to build time. Columns provide information about: -The view only shows instantiations whose contribution exceeds a certain threshold. If you don't see anything in the **Templates** view, it means the build time isn't dominated by template instantiations. +- **Time [sec, %]** shows how long it took to instantiate each template in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among template instantiations based on their use of parallel compiler threads. +- **Specialization Name** shows each template instantiation, including the template arguments that were used. This helps you identify which template specializations are most expensive. +- **Translation Unit** shows which source file each template instantiation happened in. Multiple files can cause the same template instantiation if they include the same header with the template definition. +- **Instantiation File Path** shows where in your source code the template instantiation happens. This helps you locate the exact line of code responsible for the expensive instantiation. :::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations."::: The Templates view shows two template instantiations of struct S3 taking most (79.4480%) of the build time. The Translation Unit column shows that both LargeValue.cpp and SmallValue.cpp are affected. @@ -143,16 +145,15 @@ The Templates view shows two template instantiations of struct S3 taking most (7 ## Improve build time by optimizing template instantiations -In our example, we can see that two template instantiations of `S3` are taking 83% of the entire build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` are causing this template instantiation to be included in the build. +In the example, we can see that two template instantiations of `S3` are taking 83% of the entire build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` are causing this template instantiation to be included in the build. -Since the **Instantiation File Path** and the **Specialization Name** are the same for both entries, we can derive that there's one expensive template instantiation affecting both of our source files. This explains why the time of each of the two template instantiations are about equal. By including `Templates.h` in both source files, we are causing one template instantiation to add significant time to our build. +Since the **Instantiation File Path** and the **Specialization Name** are the same for both entries, we can infer that there's one expensive template instantiation affecting both of our source files. This explains why the time of each of the two template instantiations are about equal. By including `Templates.h` in both source files, we are causing one template instantiation to add significant time to our build. From the **Specialization Name** column, we can see that the expensive instantiation is `S3>`, which corresponds to this code in `Templates.h`: ```cpp inline size_t LargeValue() { - return sizeof(S3>); }; ``` @@ -161,21 +162,10 @@ There are three main ways to decrease the cost of template instantiations: ### Remove unused templates -Review the template in question and determine if it's being used. If it's not being used, the easiest solution is to remove the function or template. In our example, `LargeValue()` is being used by `LargeValue.cpp`, so we cannot remove it. +Review the template in question and determine if it's being used. If it's not being used, the easiest solution is to remove the function or template. In the example, `LargeValue()` is being used by `LargeValue.cpp`, so we can't remove it. You can also consider removing include directives that bring in unnecessary template instantiations. It's easy to forget to remove header files when you're no longer using them, and unused includes can cause significant impact on build time. -### Optimize the template implementation - -Look at the template instantiation and determine if there is a way to optimize the code. Some optimization techniques include: - -- Reducing the complexity of template metaprogramming -- Using simpler template patterns -- Avoiding recursive template instantiation patterns that lead to exponential growth -- Using `if constexpr` instead of SFINAE where possible - -For more advanced template optimization techniques, see [Build Throughput Series: More Efficient Template Metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/), which provides detailed examples of reducing template instantiation overhead. - ### Move template instantiations to source files For our purposes, let's assume that we need the template instantiation as-is. We can rely on the third approach: moving the definition that causes the expensive template instantiation to a source file. @@ -209,37 +199,42 @@ The build time has significantly decreased. While the template instantiation of This technique scales well to larger projects. If multiple files included `Templates.h`, each of those files would have added the instantiation time of `LargeValue()` to the total build time. By moving the definition of `LargeValue()` to a dedicated source file, we minimize our build time. -## Understanding Templates view results +### Optimize the template implementation -When interpreting Templates view results, keep these points in mind: +Look at the template instantiation and determine if there's a way to optimize the code. Some optimization techniques include: -- **Empty view**: If nothing shows up in the Templates view, it means your build time is not dominated by template instantiations. This is actually good news - your templates are not a build bottleneck. -- **Duplicate instantiations**: The same template instantiation appearing multiple times with different translation units indicates that multiple source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. -- **Threshold filtering**: The view only shows instantiations whose contribution exceeds a certain threshold to avoid noise from trivial instantiations. -- **Time aggregation**: The time shown represents the total time spent on that specific template instantiation, including any nested instantiations it may trigger. +- Using simpler template patterns +- Reducing the complexity of template metaprogramming +- Avoiding recursive template instantiation patterns that lead to exponential growth +- Use `if constexpr` instead of SFINAE where possible + +For more advanced template optimization techniques, see [Build Throughput Series: More Efficient Template Metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/), which provides detailed examples of reducing template instantiation overhead. -For more strategies on improving build times in template-heavy code, see: -- [Templates View for Build Insights in Visual Studio](https://devblogs.microsoft.com/cppblog/templates-view-for-build-insights-in-visual-studio-2/) -- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/) +## Tips -The first article provides an overview of the Templates view and how to use it. The second article dives deeper into template metaprogramming techniques that can reduce build time, with practical examples. +- You can **File** > **Save As** the ETL file to a more permanent location to keep a record of the build time. You can then compare it to future builds to see if your changes are improving build time. +- If you inadvertently close the Build Insights window, reopen it by finding the `.etl` file in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. +- To dig into the Build Insights data with Windows Performance Analyzer (WPA), click the **Open in WPA** button in the bottom right of the ETL window. +- Drag columns to change the order of the columns. For instance, you may prefer moving the **Time** column to be the first column. You can hide columns by right-clicking on the column header and deselecting the columns you don't want to see. +- The **Templates** view provides a filter box to find a specific template instantiation. It does partial matches on the name you provide. +- If you forget how to interpret what the **Templates** view is trying to show you, hover over the tab to see a tooltip that describes the view. ## Troubleshooting -- **Templates view does not appear:** Ensure you are using Visual Studio 2022 17.10 or later and that the C++ Build Insights component is installed. Also, make sure Templates view is enabled in the options. -- **No templates listed:** Your project may not have template instantiations that take significant build time, or you may need to build in Release mode with optimizations enabled. -- **Build is much slower with Templates view enabled:** This is expected due to the extra data collection. Disable Templates view when not needed. +**Templates view is empty**: This could mean: + +- Template data collection is not enabled (check your options settings). +- Your build time is not dominated by template instantiations. +- Do a rebuild instead of a build. The Build Insights window doesn't appear if nothing builds, which may be the case if no files changed since the last build. +- Ensure you are using Visual Studio 2022 17.10 or later and that the C++ Build Insights component is installed. + +**Build is much slower with Templates view enabled:** This is expected due to the extra data collection. Disable **Templates** view when not needed. ## See also - [Build Insights tips and tricks](build-insights-tips.md) +- [#include cleanup in Visual Studio](https://devblogs.microsoft.com/cppblog/include-cleanup-in-visual-studio/) +- [Troubleshoot header file impact on build time](build-insights-included-files-view.md) - [Troubleshoot function inlining on build time](build-insights-function-view.md) -- [Build Insights now available in Visual Studio 2022](build-insights-now-available-in-visual-studio-2022.md) -- [Functions View for Build Insights in Visual Studio 2022 17.8](functions-view-for-build-insights-in-visual-studio-2022-17-8.md) -- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/) - ---- - -**Summary of additional important points from the blog post:** -- The blog post provides more advanced examples, such as using SFINAE and type traits, which can be referenced for deeper dives but are not included in this basic walkthrough. - +- [Build Insights now available in Visual Studio 2022](https://devblogs.microsoft.com/cppblog/build-insights-now-available-in-visual-studio-2022) +- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/) \ No newline at end of file From fa6e3fe2860158ec666e730e0f8bb18681f34e14 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 14 Jul 2025 15:11:10 -0700 Subject: [PATCH 0394/1799] draft --- .../tutorials/build-insights-template-view.md | 30 +++++++----------- .../media/templates-view-after-fix.png | Bin 0 -> 26143 bytes .../media/templates-view-before-fix.png | Bin 66563 -> 66831 bytes 3 files changed, 12 insertions(+), 18 deletions(-) create mode 100644 docs/build-insights/tutorials/media/templates-view-after-fix.png diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index cdd12cc4eb2..fdba6806a98 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -136,7 +136,7 @@ The **Templates** view lists the template instantiations that contributed signif - **Instantiation File Path** shows where in your source code the template instantiation happens. This helps you locate the exact line of code responsible for the expensive instantiation. :::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations."::: -The Templates view shows two template instantiations of struct S3 taking most (79.4480%) of the build time. The Translation Unit column shows that both LargeValue.cpp and SmallValue.cpp are affected. +The Templates view shows two template instantiations of struct S3 taking most (79.448%) of the build time. The Translation Unit column shows that both LargeValue.cpp and SmallValue.cpp are affected. The build time is 4.066 seconds. :::image-end::: - Sort by **Time** to find the templates that take the longest to instantiate. @@ -145,9 +145,9 @@ The Templates view shows two template instantiations of struct S3 taking most (7 ## Improve build time by optimizing template instantiations -In the example, we can see that two template instantiations of `S3` are taking 83% of the entire build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` are causing this template instantiation to be included in the build. +In the example, we can see that two template instantiations of `S3` are taking 79% of the build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` are causing this template instantiation to be included in the build. -Since the **Instantiation File Path** and the **Specialization Name** are the same for both entries, we can infer that there's one expensive template instantiation affecting both of our source files. This explains why the time of each of the two template instantiations are about equal. By including `Templates.h` in both source files, we are causing one template instantiation to add significant time to our build. +Since the **Instantiation File Path** and the **Specialization Name** are the same for both entries, we infer that there's one expensive template instantiation affecting both of our source files. This explains why the time of each of the two template instantiations are about equal. By including `Templates.h` in both source files, we are causing one template instantiation to add significant time to the build. From the **Specialization Name** column, we can see that the expensive instantiation is `S3>`, which corresponds to this code in `Templates.h`: @@ -170,15 +170,13 @@ You can also consider removing include directives that bring in unnecessary temp For our purposes, let's assume that we need the template instantiation as-is. We can rely on the third approach: moving the definition that causes the expensive template instantiation to a source file. -Since `LargeValue.cpp` is the only source file that calls `LargeValue()`, we can move the definition to `LargeValue.cpp`. This prevents the template instantiation from happening in every translation unit that includes `Templates.h`. - -To do this, remove the current definition of `LargeValue()` from `Templates.h` and replace it with a declaration: +Since `LargeValue.cpp` is the only source file that calls `LargeValue()`, we can move the definition to `LargeValue.cpp`. This prevents the template instantiation from happening in every translation unit that includes `Templates.h`. Remove the current definition of `LargeValue()` from `Templates.h` and replace it with a declaration: ```cpp size_t LargeValue(); ``` -Then, inside `LargeValue.cpp` add the definition: +Inside `LargeValue.cpp` add the definition: ```cpp size_t LargeValue() @@ -187,16 +185,14 @@ size_t LargeValue() } ``` -Now, when you rebuild the project and run Build Insights again, you should see that the expensive template instantiation is no longer listed in the **Templates** view. The build time should also decrease significantly. - -:::image type="complex" source="./media/templates-view-after-fix.png" alt-text="Screenshot of the Build Insights Templates view after optimization showing reduced template instantiation time."::: +Rebuild the project and run Build Insights again. From the main menu, select **Build** > **Run Build Insights on Selection** > **Rebuild**. -The Templates view now shows only one instantiation of S3 instead of two, and the total build time has been significantly reduced. +The build time has significantly decreased. While the template instantiation of `S3` is still contributing to the build time, we've been able to roughly halve the total time by only including necessary template instantiations. You can see the count of `S3` instantiations is now 1 instead of 2. +:::image type="complex" source="./media/templates-view-after-fix.png" alt-text="Screenshot of the Build Insights Templates view after optimization showing reduced template instantiation time."::: +The Templates view now shows only one instantiation of S3 instead of two, and the total build time is significantly less at 3.152 seconds. :::image-end::: -The build time has significantly decreased. While the template instantiation of `S3` is still contributing to the build time, we've been able to roughly halve the total time by only including necessary template instantiations. You can see the count of `S3` instantiations is now 1 instead of 2. - This technique scales well to larger projects. If multiple files included `Templates.h`, each of those files would have added the instantiation time of `LargeValue()` to the total build time. By moving the definition of `LargeValue()` to a dedicated source file, we minimize our build time. ### Optimize the template implementation @@ -212,12 +208,10 @@ For more advanced template optimization techniques, see [Build Throughput Series ## Tips -- You can **File** > **Save As** the ETL file to a more permanent location to keep a record of the build time. You can then compare it to future builds to see if your changes are improving build time. -- If you inadvertently close the Build Insights window, reopen it by finding the `.etl` file in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. -- To dig into the Build Insights data with Windows Performance Analyzer (WPA), click the **Open in WPA** button in the bottom right of the ETL window. -- Drag columns to change the order of the columns. For instance, you may prefer moving the **Time** column to be the first column. You can hide columns by right-clicking on the column header and deselecting the columns you don't want to see. +- You can use **File** > **Save As** to save the ETL file to a more permanent location to keep a record of the build time. You can then compare it to future builds to see if your changes are improving build time. +- If you inadvertently close the Build Insights window, reopen it by finding the `.etl` file either where you specified it should be saved, or in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. +- Drag columns to change the order of the columns. For instance, you may prefer moving the **Wall Time Responsibility** column to be the first column. You can add or hide columns by right-clicking on the column header and selecting or deselecting the columns you don't want to add or hide. - The **Templates** view provides a filter box to find a specific template instantiation. It does partial matches on the name you provide. -- If you forget how to interpret what the **Templates** view is trying to show you, hover over the tab to see a tooltip that describes the view. ## Troubleshooting diff --git a/docs/build-insights/tutorials/media/templates-view-after-fix.png b/docs/build-insights/tutorials/media/templates-view-after-fix.png new file mode 100644 index 0000000000000000000000000000000000000000..7acc1cf276c034591d4b1130bb4f0abe29ec9013 GIT binary patch literal 26143 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 y7XZHx9oCa%DCeNxuK@!+5EJGs=1o+DU literal 0 HcmV?d00001 diff --git a/docs/build-insights/tutorials/media/templates-view-before-fix.png b/docs/build-insights/tutorials/media/templates-view-before-fix.png index 5c52be969024c2a7510a1846efa2157f038a8717..22bd3ba5fd4e642d3ac87506d5ede96a7cd12214 100644 GIT binary patch literal 66831 zcmb5VXIN8R(=ZAuD1smY0@6h3y+{|3qI8hnL3#}cA@rhv0-~UX-aK!BWhKYG9K^PTHD=lXs?_9}bUteIIevu9>Sz0_2?bNj(t@mj&o(Mj3g(@xi4Q_sfV#YV!GT~_AK?WewyI0yhcFRO>X09QAl zq_6a&e*jD3o_}}qKazRsX=^X3qxj;_3|ve4k)xN_Ye{~7A0Hn+A7MUsPX~TM2?+^) z0U>@NAzs`JUZ9_wmz6KC8}RWT0E%`%8&9X#UQX_A4}Sx+vUUe~Nk0OCoNOiSt?Wgt zZEZz(t*wM@c?AV+t$3|$g#~$Sg@tX!L;EW{QFr_%hSmYhsEzDWdxu8GyY$FPx*f%^1l$1`A-jSuehgwDf635|5De^4M$QR z9PN1Gl8AAvyr-flr{`<2Gv{L#=g@eH9VSWGnchRE?ePbA8W6};{CXn|qUbDBrl10A zh`!K8c3sP6Yf1$~QL62vMAB$jTStv{yuZzonl$wmeL329O2IA6VJsUmnKa^{EJu;Lv9xG9mg8OvU9#tHJWKZ-Wo^X1-n5 z>yh|_aO4Xm92WKM<5Wov$E(!8p$#$xkNbT|x7GjiYDbG!sGj_+Ra%%H+VfQr-+5;I zjlYO5&9nao+xEca&0lO4mmmN4M$BzKJM#n8fm7Sf^=&Aj?kAxWtV8|VKwiuQbl74o zNj=Fcmb_Rk(^lm14gwC{`{eDDHrxWFA5LudYszzO@D@vLZ}GsaT$SF8m7bYf74#1( zJjxfF3cf;3377B#E%^RY(X7>lL}!lsTI7&`jc9S~Apd#jUbL&I``UBMb-?olF~GVr zZM)aH+Yvy**sW~t&N^jBlfv$&jF6`t>z4FuNBsBieTY(FV!}Ojxhf?PWO&%8O zd070*nDN3dH~(%P$B&NmUxYUbYh1w-KxfVtE~}Hsl&TU5J`unWtApmSnt||-`LaBF zu>ufVP=lE{X1w3;siYgGc<;1qlEGJII}au3Fcg_`>FiPrT@_O_?+&hA2jOT%aTUwYoBb(b7F>+Z1{tmcB%D}{_RLLhY;#<5Q-_#AeZ8!4CAgvZH-e?)3z zYVOTLs%Q971%yR;hW+ogKcB|%y`hkQq5QsuXL}GfgqgJC2g=_&u*~00RVIXpm-IjE zFgUCwNhskfbYOBY!ONDz4>LJOU`V5``pXVZoq_D>!|%B=zX2ZEAEh3b)|SpBSVk8& zc#9eWEii}qu#%BgMX3xm;EN~EDUR{0OwJoQ(b0oAmadQzI@I*e`z%r0;uIimPAbUdz=ul1wWSHvqK82FTImsU(sq|r_1ZaL?TH^$0N)# zSQ~c|-0roIuf7uk5Q@I&OP#nh5gtI@n~>nFn3LERlA%H3KU{URb$j`l>&-@DtrjBa zrqIVnJgm=D?$Z*qCwY~EPveX@Zbx=a*6c-tY4R-#$n?}t!$WoRKzqwSJS=h~uM^gu z!1H(y=7ZfzEPDuzOxO@lScmS(2sz8{%bXGL0()SPT%9)aIey#$Ka z9)omusWpr_*>TKK;dSAZe3yOC)T_56xAjxk%}hgCc|pO7M9~QS^5AeCb*F|><~gWL zj-N!y=dYe($(j-&Yd*2w>y=6cUw7?AzS&5=OEAv+R9KNq(tNqE1?fvVVReSa|9i&w z2nh<^60LZ~LMiR5n_Ls=1~o!p{8iJgY+p8tdo~($8zf*Z2BxO9yzVS+=a={7vJ=ve z&!{8LE@E5K#p+e_;_gfFkM-ToVO~6H54`GRS3kVztnvQC!vkQqAZ_3a@Wq+cRp0hg zKAbZ6qqN-oKljx!G2=tVbw?-OL-89);#!)VReuIv?(-|JFd)MMd$(9)wqK8Vn`6vk zXU@k?VfD!$H}F32?7|oB)-4BGM9<6=0nYB|c2~mlSv;XLxCEg_&~!Au1;L)O%)0{Tp0Yk} zK}5ewwGCgX_Fewb#7pz*cXOR54ujWEP6(DfM4V^IO>h*cW!${{p$i>?YNVGm7gLym=H{oSc;Zk-SK$ zMBD#`ek4K@XT1J3q)X7>XnP&62J1ZVcK__c^#_{I&EKH@omQ9rf2{l87EMGzS-q<&6qQwURjF$4y6wT z0NhfBqBdqi1<;Yq(X~g_Nu<&2Vh_KKgIgOV;BfXts%W(|>LShZW%S59)b`WX_G|fw zFsI*}JoBnqxbA*f4_&Jk^RM`3UUWHwtxc4JfBPdBw>(_TpMUPtE_SG^u=8Y&eh_Eu zS;w8VKYlkfU^*k}(rgN!q)V%+a+(8vBVFzIQ!=nyxa>R=pcvK!e4>8qtDJv~bwp$k#H z(dO6f3*eO-9Z%L4;(q-PLMLSs$^<`)&;oN2iz%K(IM!^d<{lf1o>#Rk237>ew2)}c z$=2DoDD-~SZOAI~8qO*g^Q_&0oW*6N48Ja=9Bdd@vs}vO^Ko6M4J>7EQ-BK3<$Y9L zhK~1{r|u>cE?1%p`OASc(FUUV+x;-Ug0-iTT(}*3=S$JMAcuCa;iOO=E*x_N!(;43 z*5Syjf@)hvVKBv*{t9+AHC+Vx+85jow=@2YR(x)O2D~gTsS9=E!xkqJj_$ zr6|Z%TJsnE>RC?AaN8zGeVC@Jetw8s&!O*jI&~YTaNe^`mB?3x+Xo3L%r^`+hU=On z8`C5%G<|lFhB#LRC%eZsWq_^z+e`uW3{*3R!rMxY@Rz3LrZ*cd&IA#`z^Mow-L1r< z2d&j7%N4PIcp2F=0U{`L9^0Dc6|sBU=vq8Hf6GQYB4w0Q2r9K>*yt2ho z;1&DFxX(2yU!SnKw0$x&;Mwg7G?kd4lg>Kf5Oqz_Oofh3A9h+@IS&Wxq#MhoZBBJ% z#!s*EOnmAGG1XLw*LI9>R(uhT=thN))4TVuI~T?`iO%tkNwvf*C)tXRNTJK zj7WCd=JvQHl?cB#Ua{S430Pl??({OEUt_~_$jRtWaTOH#Uc0g4HFqVF=Z1Qw#WPSB zk1zS{SJx+sBX-h7cEr)^;ynDvlL*vb=c1 z`V(US+dZ#6wcB7MUN%2#1V`+fc=z?CO!omYU>Bk9eYaggY0j5H@cbq_|2+HG9D`fE z^}U~~7ND1R*ASsxE%G$EcKtuM2MKSO`U|;LA=4VafZL*aDbiIj$MF8j@j=GOk71i` zY_>PGX1qA8wBu~p%r}XqXaW5-L^dOwrGsfC-dn1Z&QLgm@XxL3O_EUp+Xvpm-@3~h zX98ZxvQJorqQ}2#Pu?AZ*TEI@YbJu-q(9to3k`y_kZUfU4wkL@`K<$orR_JGufQ3dZ2|15lGHW0fnY}n7ry6* zenSUp5;lbv9M#mxSnJ6-c?cX~XNeJ`2E&>*uj~o2<1@#}&B};wu#7?==VX}``B)P6 zCO@Dx<74_t@ny-pX|xiotKdWK%YVPnmKsC#Af*{(NLQvSKpLB~W(`5MD#ue0)zM>- zNcQ2tSHy8oa=nTZ1Zx;O2~GEV0S%Cx?ggVAN{+(b!zzdMdY7@eDya^KfZI_Ur4UF@ zVhj{d)!Zc38m92D^t~i!z^!Bxm4pWmJks7^fxJ08IPn9R?dG|7HHK3R_3xCSGCYob zvCJkvPqrF(`-}TGK|C{M6~ZRme$|PUjS2U*s;R|JlcuNJ5)FJu^TRNdIR-Ke>C_D; zr*skHE~ir6RWeLs=nJ^r^V1rjl*{DASeX@o`CB(OFft^V{KwFOG{?WLrAKW2+QSJ4 zcQ1!?qHYrQilF)uq8mZbZiCT+p=~|k5q|bwa5yn$03KwTe4n0p(+~_A^{1qR zy(Xb=C>Z3`S9_H`QEfUd)F?f)4Lkz}GnwDbjn`6ArRFcKwe$frni4waQ;{w(CiZ{m z6eozC{RYzHk`6K*I^taY+At^KyN;7>qZ$(z^s(f9fFXOVEEv2kfYzO}+3B@xRkpbe zso1MYFt>BjEzsYy((H~&5M1_c87hGc4>2>Bfg84Kca_3hj>!NYHQ(kDE(piSAgaxY z^9#GJ$%fL09_3|>N}tex(5geDDLDTMsN*E35%93bqU)S3w#iH()$EGW+;R9#Ky!$I zRAM=NX2QJKf|+DSW&wtED5id}K&-r#=+4KZ+BUDldj%HsnX)ow9FS@lxN z@W9LWb2TvP`B>I&#@CY7!T3#~3a9Cq)8rzM?2pR$EBuuzPn9U$pGE8;XHVlf-8f2(#zz;iR{PX% zT9H$^CllKm&<)kn9a^2;8Lv9^a-8mG@g7fK@BLh#x2sd$D6Xz(p=4U1CZ5GjR_%1M zb3b4*@hZvmOV-e!zC+Ww%2K;Bk#_%V+Hh-7s8^zmVWO0~>{A;W)3o7KVy%p*)FGk( zV=F=i>+bcK2jnBwH(NqWVTnQc&J1uQe+>zQ0;k?;RJYN;a=tENiMuYk?XUr zC2<=^r3fMh8d1u{BHT#Pyf33j{i8=V)1}`Ktx0^vs>L7ne1OzpTdW|A^(p<>)})X zLA{8s6ecA2Zye*+h|%om!wH<*id>beO^o^XSHrI1UV(uqm>&Ve+Fh7SipbdLO9>_{}shjXn^###vl3r z4_eG_lK(fJ`2Tm1?7y9O`1gnUq9gf^RSXHnDlxZM8wRWv@BAv`*Dw~!sx5W-MmN%R zCyv48(Uab-W*R&f9mmq`vUeh!l)5Fzo>CU2B!Ogg#XZo>e$316px5d2!|g~zxb#ap zgdoQd_ur3_$R@q(VR~YQ-mcfLv&z^gi?QEZX})ltjTD`A+!qul`XCIx3Qas(qO)~c3Sl_z_j)0g!a9W`!)BuMMJUnZ!33kuwgWmt#N z$8e_1k(xHjCT@Ay!Aq)7TE!lWg?lN}y2#3+fWIo-u7!93%gn0Y&DOww3Ql9ZWTOftvAhgoqX1xg)RQI)mM7K z`}bY?2e_?5U4A~~7#irib<5noD@};7c7rp$GMRiUxL;nyGLx9gsYJyi$;R6WP$1l; z)H)e0I3}+$Ttbw9oWK1TBNeZQ{M2Q;-R){`xbmWl&G_I5-ENjmAc%4eN7?J3CTqre zhbw6lZ8+4}p7=g~EPT?vORo&f&nQo^`S6gxZKg_}>8vt-~I!O!uT=;CPp#9RM z(Zs!p0i%nV?y7!Qw#sr?&#ypPn+?u>J3YZZ@dakdT^Z%Egms*%(Ft?uZo#flvDpy`MiBgCNUTVYo@ttO!3M^ zU>!K|*~WE0>0)DizMO4i6;2dEV;L|fi22AY`pBI4mSj=ydEv55)yj1BCv`S(N~JBd z{)TvZgKWqyPRzWF)ip00-0NgSjBTKp%3TunbqrxB+rap)W&E}{*Z8ta;?Pvq3BzB7 zh5OokBA~pgRDi0zLHKOYOjXdvg2bkFlv&?VgYCogjwo;?#fg@OJef^wH5gA$(Gfp( z$Ic@ubWSS{=`d_IYBz97@`{CS+T5Obm{RWL!Yy@EADg+_ys>~3Kkzlh zFe`4W+SQ#U0ixC^_Wh2XqbeNM%}Zx?ouoyg zIo(qx4ed*8@OF#rC;%UFz`WPpjW;v~+&raWjbT=Q&qv4L#P^5s)WK}g3Y=gOCmxR> zTCv}nsC>N2b6h=6+;Y|V1WopWO%b3 z=Uw_-!e(_k+NSS2CPEuAmh8$j#l&fL)dFoA4Otn(crRwu27jU|S7YZcfSVH`ENcU{ z-tHpgi)&^LjdC_z^F3||KQ1*kKGyNP5VbD^vLU<|y3o{5oiW?U3(3XAd+Thk{21tW zogD5Tez@FOg-lA*nG0Q&sU{N$vt87{^}Ow0T)(Ci?DZ(7vT^%!3lHOi2kNy9md>{& zKE$tNWw9hqEENB>KOQ;110Hf7O_3toYRl>+H4cRv>`+GH{(D3}q6Il;0u`a4+Bi)D zf`~@VGz+rJ+~MnWFexXC_fhD5>3Rg_-&t8jN_&#tm)BQ#kDMdQG%>nQ6poiS74-;?`@VO0o&PO&&oZoc?hPh&=l;HHCYOt5zYuXEW@r6!)W0xS}p*{#ydsTQh zn{gosTYdBh=M;$bqSr$b$V9WXF}oMfSDydcXxifs4d316@*E7$xNxHu#f3X_XC##W zr2;NWhoYG2Ctv4NKY6_1;Labcio<+n@`rnXUpG% zg|@RckDxk7^K>7wfulB?%BISLhSK;3W^<$$nA8%7-X^J!^)@bDJ)M2Ix<@{pM}a@n zA`}Ft;&MNg=Gz#ZlV(vpLyDP@A~?Dt;+4@U=skfKI> z)lEuYy_W998wzI3!kZ}0b~*XX2Q@+8eBH(8nr@6=%ty@+w(>g&7bvl)JWu?lCu64> zYlOPO2xr5oQLX^!xdb{ibb-?DeO{IN9IWqfHiUz;kq0`jI4AYeMI6>-b!E z^2uXAM^u@AUD&Yia*-Qm&o%Y{!DphPdi9`vL% ztUHHkz!VD@*egSHpOzu5#h#H?Mqg8w_Ds8W#FfH_#d86PsGbF|a7Fu7Yf+q7Y%p|J zE^|jZ&g8;m>&s1_d$O3z#|W+dB0sEYm3?m**aPnyY%uh+-0mBYPGr61oq7omxuoWA zIo4@uD{#p0d!N8-IzN`I)==)l?v3W(kX^9k?H2VvoLnqz{+T7Au_X>b1=UPF8*XK? z-&O-SS->?73kS!a#L)A}_{be{9>U;Flz+%5Vz!h`=xJhh1sq5cxnBS~q#-w$% zf505GmMU0IKNLb@+Siujmo$j*%UdpY^#9ZyIH%dFH4g4gyFgP>eg}@Tk-|jYSc;)v z&mShZob0@S`MW&CuFH^#U&=g&sOO)Cl>b7l{)FD)Ngl$mhsZG%G=gV$7Lt8fqB#@d z^TqGahkt*2*XXc9QSq*Az^?Fn!5{`Pa?KAK9eg6>txuJN3c~Lic8lFz_;HV`reLx} z9{*D?N^Jh^~TH|MAw(H)DN%ND;=qG zw`>G$zaQDSvPp+Pm=+foeSK%I$VQijw3lSlpXYZrgMpoluP8os6q2f|2~=KO4mSjz z4fUjXu3gQQF!y~W0_hIfYTRah!ilh8qe-y^aRgN*jytgiO{-*;ZPVLQl&T%+_Q#j7 zD3P#~P05>85b2goHo-cIGCbQdi7J!W$93MXzAVxQmrne$0lMX6R7M7Iq725rx7NyR6>TaKJAs6UI<6cxl5xtvnF z-v5<|t_T);<3^Ie^OD7y>;$qDbvE@%jEhW9JS&C0`{R_$Ln5unfH19)>?w7F1P&pRW;ogi;{EvW5PkClDFGfaT_Mw6Y`N>~AG<>jRx)5u$ASz(l(HjFJ) z^DRE=@EJmu4`}a`4Ms6buFMg}5hplQMlBwn2)=rPhp``R0Ha{{GZd32--t|4LWsr& zTJ#LKR|a;~)h8{orJPn@&7igx4aF0vhGy0BysbUg#E}k`hHU}uk_dEiWz$!#=l#Kb zIw6F$JZ04e_o)xvIO9ziApPE3Isu!OsI;Mv3kE7%xqMz9jJ{t)KC|{R)~D)K*nH~3 zWVqG*2B-Qr6*GIodntc7o6=^L=?zoDQbtvgPvcsbss_RPL@*O z=Nr}wUC|neC10puGYdwRCvUz(6?`Fo@Pp!oO=-x~I&3n22s)a)KM`l99Xl=YSQTq_ zDG|Lfls*BZ0e7zUIsZQRr=^K1>ErQ33WmBm+kTC6fyrO|KQ>W_EM3_W?=G=2T^nD@nxd5O8?`V(p$HlKq2pFR?x!h72R?VFR+D4&HV z-q>vW_$dT(YszhR`&@K>aXjyGV2iPT-m>gv>B)2_igD8o(&HlzD*Q?xWUqhb|K4ZY z8k;T*=x(jmX*8=2B2JGC3mikQsj++onPD3aFQiZaXx3at&Vn3WYU z=tj0YsaR?uC()W|Z)$HEVg0Gt(+9rzDw2A$$*KFxS*u9*7wK-;EG3GRJ)|&*=g!F{ z6O-*^Q}M06nfRYnofiSau8cdA#&ixE60bTNIo`7)*X9=I#;e*Y^eJ6vUs7#nZ;a?; z7zAtz)EY9{{m1mYEt(Z4HqlWJ9>kvc(l1Ik3IH(Ad3s}5Lm^k2%#A*iyI(5w(<;zn zU&&RP{2Y9JFh-i=39EY4yb8|nB4vLs;ttyfKU9yfo_Qv`=x9~0wGgdR2V2`~1l`M# zz7@n{b=Z%H+ptU`b!icBD-zQ=c#gA^Ul_e6cM;6}(e=I!CZ;l}(zGMT8zZz}CoZXA z$<6>RS;e|%6!{hLl;+JP3~*YR3SO~fUy)_@E99sa!w{r3^LLHc+1AU-!}5?zwFcjV zY>d*3Z)d=$_sM!_o+{)@E&h?%_J{ju?dBE?hZ->-7d5||VOKx^d?!)V;sA;?tkBzB zMwT8Mo9T_^qkZj~no!7CWS=iWlsY;t?-Fn+{z;22q6Ki-?pM+X=`N5!uiInZ)0--E zKZzsB3AmqvkI{R}AMO`-Z6}t}rOeB3uaqTzWyKSLpx>@HxoVsi`jyYR&EpqGH;U z=^MR(Of1vBRI{Y6<6aKx;zopA83RnQN59|K><&6u^0o_YN6o83I^W>{@^c~BF&r}U z%kdu}A(PPUVw5FrlTxn=bsSx|0ilwbiO^MMGQZj0*sut##-KTS%>(^&UaptH=YCB> zBR-*DJr>#RFqD>d@>>L}1)+AT*tcp_M+EC=h&l!;yIofZ3P665(LP8|%Q8DHv=7QJ zEr(1%5T_q?NBJ*uFU%^;Hun%OHjljDdM*}3tB#Cbeb`&^TK%CVE42eWu>MjN_%g)K zDFfMn)XwE$S}CqM&<=t4qD@OE%}#q|NLzbp`(kIrKO~?G&-wXY@?FFgsvoCj+FqQ3 zFI$Wmav)3F!kQ|WgV4ijRP#diH5_1PrmbOT)8z7*$;%R3SkVH%Zt@CT%h+=#^icPl zr8cDCDDJEXA|!aCwEAN>xsOHGGH)>a34jg(lPy~BwQ7n|ZEOib49|#iVs-c~0<{~G zWK^7_Sk2Gi?;!Ef)LI<|FMsJ!cOSJA{f>&nvZ=ibK%TQ2YnsxDS5 zMEyioC|)Hjk&{4keHK=RRAjxh+!Acq4FLV7G^Z?f$9G7Jhv6HEQCj(hT1Z-BcT6FY zvQ?$9k4&}*JrrekJst`ki(?ADP?;92O&1bey}8;Aafa4PFW{O>aQl+4=k2k5TGT!q zV8n@G0=<5D#8GhF(c*5JS+lRaG5OPH#{TL}A$%Dx4Q`N)OSe+RQuKXbz8;^a6jIL` z6nt^e-S-CndK@eWGsDDfSfC)P@FO`Bw{~ zrQ$dl2sxt3Acn!}kZdns5skAe%b9>I)RbUpn2-|!-Pbxh3uaFsGa%%ZDNDm1IEW!h z^$-*1B~CUGLV4{htVm1w*$pk2>HyG`Vrb;zD%MzaVr>J0)mh) zEl%7EPGc7G1JUJ>xM+l>{zVuyclQu><50%K`s`Jnf+^F9&zris(SR%M)r;8VzTzuz zT+LqaOFpw%&xuyj^7LMl7u%RHF?MkB-K?au}@h~0#5yb9hd-OaVL$@lmEjoC{Lv>q}J3 zs{2bheRbynQoxjZ0wVen=u3iC>qRcsT$_Nr;pXDM2=dZMIOl@brcWk{JSIjDorRSJQ|jYx2a-zi&D{Fl{G#3q8Z}9K9=Elu zs)QtFyAo)6)LWwaJkRg157PU#RD3l8rltCodQo&)wpW_>8+EjFi9!&nNxzcp41r{C z;l!2U`MIAzQAN{^vOA*FRR$>ssyU3%uHi|ACjddwl`kH^ktHftGa=bsU-LKSZ{mW%OJ|cbc&((tr=88JpWE3*f$!=3WAWYBudP?-`C_1d;1V!reAPa;dR`p8<0~~7L}=+ zNd(@c(kZ?zuD^ES2E3F{=%BEDV!eNm_n3Jg5GL~Cv2X3>EgC#-)_0!;dlOooe6G74 zE#c-Nb{~zk1ZhT5*7}-Xlt|RNYoH<3I^`Zv(AK;N=HwAib6ltpL7v7#*d_%{WBxz} z!zx#Jo;!ils(VY4PVaA8(hbfK}Z~S6n*laQ0GR0+OXxTG``-80CR46_kv+$IV0H>v2 zI-9^^dKP<2GNzM<-i}QJ3%_n1f)u@xX2P2nLuw}8#(dR{gSHE-yw_c@JdL1AyTz91 z)vAQ&2Cx__)MY{Sx(=;Nj(j9P$0NRG?sWUz#Zirn@7ydbH^9BN{4Q>DjUw9G+CHFU z%l#j98*?R`FZ}O4FwxX*K+S^%-;ukhZY8HZO`M*aa4p1lPv+#Qm|Exaa;;Mb)RpDq zRXL2cxUj3|<6k^3|D1E5Ag@f#n!qUBwnmPs@=rFDv~1ncP))Aqx3sRfGwz!aL9yFZ6wH!52kC&#bP-1yn`ErG@` z?!I=qX!1>vjo`ZJgJX@j6QYb`p83HPXNWA9FP0PV^`z4Dbiszb@aK?Csv!;#GU$nj z|0w%FtS*(Mt~pZS86sUhz@PU%?^y3dK{M*5k7TMkiLWpu)W6$Y&S~V~{pOKWOwC#0 zQzZ>nU$`6WTS@M1$D=L8Q^c-eV`W-t!JtV^dLLr=%+pf$ap}3@l21`+Io-a+uEDm0 zZ$QzzcqYi&*Rd5nhe_F9g}G~j$riRpT1w)6jkiJdVaBJ4^A}q%wwlAuH-cW0!>1wz z$(2+9Ng6?ayf~fLeLpU&$eh3ntv&gWnAeA1wUaL{XBQUlSV0uc19CquKFGH%OBCUZ zd;7f7M7AliHfY1Eo!>rjIcaI9`q~68sy(LOp`n@27M`1MZ%w0G!=GWB#>geJm?^qm zjNnT>Pu#J3-Mc)^i^#$8IbnO@sGvJWA5;a-{3YE>z#3l9=+mL_z+SnQ5X(eXipES` zjn6dPy$UzKh>0u&FVs!QsLnZC@DFsviO19yRA84X*xm_#bIh0YsPLn%WGJ(;UF7EE z_}S_pt+nmq_~Mqw%`FN|Ws?Vc$ocTmtUEL$sD`5X{*vU_zDBmtU)h`V(iU%~o1={x zJ{dB6uJ;IxQh~E6!sip$P7K*ee9Ea0qBRCA<6X!OPY0(oEnvGryfA)^kEMRQ;HQU) zPpmxQLpPjPgT>N@fw}a<4*Foj&3TER7P~%2$JTwvkAyraHTR}JVpkjviris&G9L8( z{SHQxVO~f*-Q9JmAgS)7T9wE_`vIb$vo$Yrzzk-R_Sm!dLi%3(=0zJuI3b^e9jTnL zY`ZmtfIsrlOib~78WC|m_y%-kzDM`Q(qFOxelC|MIMtfev6Xeh&!zkfe8fTH`?dCRaf()ub32br3$_P(K%|U!`R!$lu3il z!b>t`1r4daR$oEYfb5e-!tLH_um(@c34UiHV6}p(Bt+<=4S!IVVfR3iPxFiKLD0;X z?Pr=Aixt5{rxN5MfxDY#Owb|()?APGC}cce}#;RVQFL3QWz5zv9Y4F zi{>nsj#EaQKs=OF>o4KxiObF#VyeZWS8))of^++ep|a=24h16~emry^t^g3l%Yk$D zsGgAI76?

wG&?(^bkE2%;xOSpDm}RSZHF?&je7z1(T?yZ3|oWQtbJ)4clrXN{_z zbkhKr9G>L*xR;O8*pi@>#`{O`ABuKO(?&b>^Z!XpW?>}qw?@Uj;9_1&(3$&2J=~}q z@MIon_=P!Mu~nHL&(eH_*bFnU&%}DNyt4{aCmq(ELaF4hctg&2(V^;Y-M~p1(QQ&@ z8~Kk2zkEE7>Q@Hpr+&p+)xyGCXF1}j8_a$kZeuqScvq+}qrHYf_H)%l#3FK!(9QeX zNo`Zc(~Ylmp3*LoA2-e{Sd)e-8$Eb-@#7PUHG$%O;APOnH{)qHQ7X8!5Owg|)4Z-q z6q~L3E#}=Dup3ZrTi}NukuVGAOu5uzXP_0`wZMsb{azws7_ye#E?~-R_6;^;fzsmC zn}^xz`Ot(N)k(6v`iP?aUTOC4+NCvqwkGJaNHj2arSxH7Q$o-U*M%=O!z?|<8E@`Q zQu8aAN`Cp?u`-5|{RlLenw-Ge?@HLybtk^B2Kw-Q=x3Uw%|+@8w?2$`epEy|iJ-8# zJ_G8mUbywayVL=VYOws*EBm_P>DItD~282R(OmC=yix(b`aNMyHr3$Qx#+Rd2hzHAEs&gV2& zvBDUHlaKvH<4xGKI%gDx-jghPRVBXyAZ3^%;}!(3?1g|IkB&PiK+71cl@U_xkPtJ`)dV9*ns3rCVWnB;aYw{{*o;L zGV)-yJ8r97(nAaDH!G|)ZYT0t;%C;>-`IoBZzT$*&38|Ncft+ym)12ojbAVN$ zIBV-7-H;oX3*Z+n1Shy)H$B8uyjuRrZPt?iliL(oh|DKSxl2rReFDI?ZdK)=<0ts= zYf97@hOLUbYrtqO1Tw4DvCHKs&qIlj*T&_)M`lElX-sV!&(({zX`<_I9;d4o5QxBo ze@%Yb8MPZdOFrB|zYjKlIm>4~C}Nk5A{xYj62^ftElfF5ypXYp{M1uXuEng_I{Dmt zM|?E?I0dDS%L@|-ip)H_xLd1k<*Ka|2uRkGxgIIh0as5eqoAwoz~Fv+VsuMl{a+41sx`~c z_od+vVuKG{WBKe=eaxNUyWD!U!7+g7>qg==#Rj2;nrRu*4je9OHAHap8OZmwih~&= zGj?6H^LLsPe^^604L08-Gv_Tnm&UMI>=y~1_^deq{K~GZdH;z8;|u@G$6-le-Oa4{ z!aGxxL(tZfd?$(=gLAQWyXn^jlcBHuUV_487>?^uaj?C{r(=4WfgxJ5LW%+`3aw6z z=&Xroyz3}bd6p=nC-PA5}6gOH_wn&HtW4(3R-?e@qnuhrLNiy0Q zl)9c0v1y*XI_P2aA{96|6m&P?G(-o#_?eok&TqA5Gw0Hk4bi)N?;A>_D{XW*uHZ!^ za4<^FZ(;zyBDhzSq9X&|WaYcMjD6~1d6d$Wb5gBN-2Z4z@Pyv2c?zsrqh2%_L}PC> z5E(HZHFiQ|q;&zJ8_BEoYmP9OKOK1{bD`^grNE7K`8*l&YWas|iT|2*?ZD{qy_=R7 zk*%bsWMy2*#URT^pVVm1UNcY>Y@eije-c}M_Ta?*bGK#63ow<|finD=`ZC$iB7Lgb zKtD%blY@bX=#83lr(lQFH}h6HC+D=k1E6?Ds>35gdv8tANHV+LaLxDeVuk82BTd`P zjz!q82}98?b{e_B5=Cy*%d+DVN`h~TPBlIrRuf!3S>29IGwHl$iVKEIK57@c2Xhj(nGxx1 z|J+~VMs(^v+W|zve%0=B-UvBhlY_Ks#`eY!U_AMPQn#;JtZviXhkdEgNTnIm#PYtO zDv3@}o|uiLoj{qu81`qLo{a0_;$C0KWKQ2;FNU#R7C}m{Lk1OX^z{N0P=F8@2(|VT z3-%AgBT(e^lN%5IQ=nN-v16)eeIjr^E@9^0Ss>q20bS!eFZEsBHAg zsL_j2sV|-|0fP6d7ibC<%rC{=pPgly&zWlEc+>f~vCudnKe2%xE0{AQNl@oM%o^0i zneQ?!!G^f8ZIN?otBn_}G4$p( zdi(gW>Emcg##Z+Fp;}B4>uaAm=Gli|-!5&fWq@(XxG|x^<7wTc#@SgHwq4P$Dy*(< zA#Cx(G^4D~SRc@qQ~&-Azq^#MeKP5B?|kkPK3C07_VNn#K!N*X(w9+)S0N9Q735FT zm4c3Df7gd-uUs1Zxku&N2PdDd6~WSI>jHZ1!(8Xr$De|E{t4Kgu&CZWMle5oJu|A##Ng!*>6t*knZvjb&P) z>wj*8T0mnT_>qgB?=4(BSdn7d`?qQYy?}N3NO=AI(KxCa0CHEr{-{!3@I-bQ1-K%d*O z`RIdf?4g$hYX?Jn!dG1J-O^eU-8@kEHtdCVTHzV-MKZE<7V$}K>0uc9MPt^X!`cBMGv z@R2ZNN6Sl3HoG9G!$*H&C>774H-=VupeI;S>BQ#pt!hzvnA^>TN2uPAmoN1{UE4pg zzXy4c38kBe-FObs)-T1odAeWtw!^WX0ilCQmZ)MH(axE6DXqGR9x8w-mjKdG&{=Wu z#Ho$gv&qJh$`I2KOFf;^w8v8RpC@Ah$v_1W+&smdkFlqdtF!dK+84-Hg66KC_d7eG zckI`sMV?9TI?*}LNQx&K0n)Zx>$6=P1egK~rRx~LYFJ#QlH&5~u~0omM#hUR!`2^; z&F6fFRSSgQJ#8N^#0Bj(H+l!;(AI-kng;9#?1k5yDw;^Xhb}w;B>S=EhgY&BO6>9c zu3+-mJD&vdcrYQ^Jaq5#*99bs6k0ajaQ%=Vqm+WSOu~#X-lNu9*=hFuP*nSh@>^Tp z9b>)ivCg5iUkHm3_T6P^7Pr1f9(~KcG}8;Tua+F`L8yQ!FVCCn70zbd3Du7rATEuSCrt5sU*UMYj& z5?gI~0&JNmxThz|E=Tz&SOMwKt2i_mTToG?>hsk9=F~wj?S$Ks!n&@ZhhhjL=@4u0 z;XOe*Z>idVH)I9*N57iYm&EK3JTW3A8qx~-C-^e6KVy=}yua2v@iC@CJz$LwhTPaR z&WN>6979L&o{C3PUl>$xe{QmIv;BQ4aTPLb6l}V;inT1VisaUFLqU%le{yE7F^z9M z4)>v(?GoXz?5-g1jWa7lUNwqRxkQYBrkr`;h+UDGa%-eO<51tyD3usL3GT!bmC1yT z;}M3v9V^fRo*mk)>z@=AHFq3b67LM3$ill#th@L<@hqSOLEQpfHy=i3!l3Wu6cvqn zs;4skxq~~4xnK&s5oRE{hBcCfRcE~L_@?o+zhQJToHT?oX9SN|=`LeUYhZO7MaR;ZE$%V|`rdsgYCGh%T? zG-}9{Y^jMlxj%{MhPQ21x2tq6X~%wY6Kd-(ae1x~IE; za$j}}MyeyCU8&Xje%cvN-vV9brrenb{mOmTQ-LpXyH-J`>3j`V3{b;xZ-5Tq>6dgC z251uR&BvfiP^>0p&E8MaGVZiaWsmu#!swNgBo(87E4svizhW`^l%V9Ggg}leaX>55}m+Z_tkzb=Q5Q z+g1~4YK02t<>xE`{%q3jp6@4=YKy`Nk@x)aHU{w@qe!ELs}UY17~ROIvAK4t-<=T) zgzJ%#?uX#m>+=%obYD3hr#u=_4 zM5hnJ&8q*1GH=@9yo*K?FSol>AD_uFLJY9@MPlC5>-)N>p?oD-Qv|2oy;iKdbV=Av zz2!3{TqbKzb1w&Yo?Xm1bGr>MTlxHp;st&Uhs4M*qE0`rB0tX+;1E1CKeKCl^AY^`sa)%6mUaLhm}!(JF5Djd-~&AQ+seGJ zW;DzB&t8Q%>I8hVl2C!iXyc7sb>}u!B1xB3zS4Iu2?-I1K%TB?om=6P_6F{3JTm_I z>^I+B5^dXK3_pk-=G|d#$b2H!$Zt}KLhDy+0qO_w-nph3NZGA{U0|5Hrj^fsH*GD> zvoeSP#2uHGs#?t%H;~7mCh3~v^gZmSDsF{I?_@c!VFx6Ce9Xm~U$h2wW?SAl?-8#x zjtK*pxeK`>JqN0$>AGWLqKguF4<7bAyp=?G_M30THH6pW;2UFPKS)klrO^rQBf=xP z=<2s%oAIsM5<13s1^^E?nr~rGV`^qC!SQGs`AeTuY_qj2D$ZgSoJ)`AEa1Q z_XolMjIu@uf7cYSWEra9V)zk^lu^DorzR}ziWc`D&_jk{_9PBuxBiSx6f^qlU$be&cLvpq=p7cy^aze={VXr`@!I|nB-Aj zugd<}Zh*G9tfZljBV`*uh&u^Ab9tl{%{GkSg@#m~!$^D>KKAPsyuIC=+(tnsvCp;X zwKo0o>)%WCT43by;#mAi{b~iw%B(NCyQ)=oTChjd`~k@!Dzo!5H2RWT({#AR{37ju zbWxn$tTlERhq3ExjRC1lmvHn}hiI~Ctn;E^=wCRs)rdxOSSWjmGkJc{W297XKwa{j z^&~}9dgQ=v=&cvq%>ZjX*#)1oCfI+RPWv=Oj$j1!l$!I3#^dbC@_EnNd3gGs6*Nzh zICgopty8T0T_=fQ_xBn#syn_HCSh~H$dZ*6bb56xFGKY9e9d8m{==Zw8B8I4sp9US zc5{0RllEX?;{Dl`$>b-BMMt_ih#%9QWkBkESu92}4x7s`dHq+mE6T^Ty>YiU2e=@T z*#;L4WJi_yGuydAiqgMNdk;8zzBD5v?+&J$_VT!LSl#GwCS zJ6+qHeh<{!S+ZQ_yYIoVyH(}Ks1>;uWRB+Ta>_6SX(CqCGyD^vg{y?(a!kLdqx6hb zKRC-}`fk#MI(YVY=zfVCG@NXEKe=MqUMA`88F1vT*SE<|k;!OXa>m_~T6buL-fOu! z&1FfepUhx>tny;e-#^Tw-kjdFz;)ghuR561DE!ezZfDrX2NBJ>_)Ryd;VD@paB||8 zN>lB20bRX#7?ZB~H{ zM`l%99%N~r_`kid*}Gh0Q?<9*)_r>y44sdNzYkurEi!F8)aYEfs=N@-q z`jET81A70@_N?#{D{O5c3Ht?C22)=Xh6g5n2lks}>UNh3pe7^Q^jz6LvVkdyr&iEY z`HpPMRI*mjL^BEn7~>WhEE1m9fwZOaX1dKKAS1s<>ew=y`VkE4@bx zG@n*tcG|JR*}8}BPPpc#JoGB#wk}Z&@b5p9MB`JXa}HHn!^FJ5bBLL>>YeGfd0SHR zu56KzY=3mp`W(QV%%<}=jpbmUJ|+{;*zFW6XDIkYIcFvB&JV$LH;s-&%n!I>pc)5* z?BUa|Cah62YZgfvWS0_pho92^P`FaF#$v1=)yCA-RTfvM)uC26YSlk728Y~FG2W0k zwpWNKWm^o>B~aUJhrHSuaA4PL&SfhrTs#wEL~XXvqR2B9WaMv5+_9ey+%c4`m!7V- zf0Fk>>L}n6Bq{>-pCTjiJm0u6YCX7|U_ldkN%G!>`A(lIv(3JQJz1{wNF9$IeJzx) zLa6$(33jx!rfa&66S_I{AuGwXKT#TCv88x$#+m0sNxh!L`ebR8x3e1ajluqP3z^SP zCi(o3@57$7H&`M|s1TgI^V8Gp#>SMJRllsbxH#*~k(0s;%B>v+2ff2z?e_P8chSFf zEv+(*WLO4}Ps0kKI9yj|kqq<==zbjP+56}DeQM=tF#MT>G!w&hgKh-9l|1`~{G6^Z z0sR@i-w(=XKA#Qj*8w}I)qNcn`TL0`$I;3-=|&wx-Yy_39n}#3S%?7NO~L;#goJ7ORFGVoBHlGX_S?$~}N(_SIVRRe05S#nX#JU_g*!r<|Pi|8Bw z)dQn2l3)L@p2Y2^7jOQsLelf!7Vd$C#=KQN5-h9~4`*YELhOu7Q!6`n(~#R=J5J6l z_^hXh0U1;(9jg}8RB@jGOCPs={?>R^n1O{8ZJ- zhu0W}urk}e?-U@}VW8(x5&>P?PJ31JM=Y|E*F>%@**xB3@v{RyRqan8{+4hnYmc>DIdzN5S( zfFb{6ztXz0He;UkC1>|yW-MYE*>j&{;o7|qaA!31Ceo`D>#+k5%r3KKU4Sch%{n=b z)PenPNsB&I3jUpZao?goQPWB6%^kHWG@bD0H!i*lf*V&Wyj>*nY!tpo`dzr_chiAi zxjlS|Pct6!*W%imAD!H;h>~<2Pn5ABVz`J!s(Zk^r z5aNcu5dpxkP0t25;{}V0By%;LF{&{pEVmIIQ!O4Uky~sn+H?W!w|s5mwg!Q1CkFm# zz0Ro}K|5)_V$;sH-lP01KZg(Puo^L6DDBZK2R)=Y>Cu)_pN-L!IhGg&sJENH&&bhWwbncTD2K{bR<=UvmL~y-%iU4v z6Z%ze(w}7%$d#}2_7D!Xc=45?wtn&^uvce>U4y)AOV>hQAReqQyygX`7j7AN|Ef}5 zNhL%_^X508p5JgC!W35cVCbCtO+KxBuMs1+Qm=L;CFl(BSSpeq0rKeF!WZu|FEg&* zQe*h6wc>vlIOtcr-1gk*eYFKSWBmTluD?Nc_~n5Q9X8RWAgU$9~bnP@o;FX(78`N9po8{2x{E^ zD4+_wyBRIp0yi4HG3iaG_R03cSii{mBjL3kcPe)m_B(W-3(eYka1C+k@hver>^amo zqMLty&P}2LAXaFf{L0s$w;QvuH#!q@gVw(j|I0!D1MC6NN+?k$WxPyfiOOihvB%aR z*ZzN?cEQ#bHqt;ARHJ-cCJ?aH5Z$^H-Y2gISFx483{rP4gn;kx3QIe_dz9eNQz-N0vcQ89qi|AqUHreIPx7;Qih$Yl zK2)l&go%|qEMT&F zuwMSWH0o&f1~cjF7~|bxBXjU?&4=RlS+8On#`PZ)hn4L~I+4U?@bH)hY=&&32Kp}b z#zYThnE3cd&BWRrFbgL$90{v&@sxxc-a`>1-ZerKN>8Dg*Y8$URr%~;(<%AP-UCzm zJCd20D+D^-lN(^K@USIBQ#4ue0s%>TTYX=!1Asw1pMp0U=%?!{aA6ZkeBk_RcBj8J zyF@KS%hXR_AnX1^HP~Tc(Q$K4$0%0_s(m2Q|7`o@qam}DO zOizCYRaCbwS>AtwMb`G80B5F2@_gjHO&>p+Ych<+DX4&vy|O2PC25OoCnKm)@c#q_ zgOd#b$J=%GepD<8Q8tR;o~AS@FM1NLMP-<-Gu@z)dZKWT>rs6if$Vx7e$6t+gd#v; zpvgfmuj!_OG$0)%lBg@{PM5l-ZQej@P?>vC?^jl2V8=4+%6 zdH^DfGUW9Bz^y44_%}V}7v(z|8-fc!X~dvscf(|@+~L~9DK48uG5Wwf@??P#7D4Uk zs>d&m-Z@ZfVn5)BnwiPd+0gbZztry~wUi*fk8=8dQ0^yl!TXXS)AVoAhiJWlUq}Fu zAo`;gUqz3cl|G|SKi1>VSgc`*Sm;ym!gyR*I*3fcP*s(&0}H)s^NFowxhG_-uwogE-hyxdNwM{1A#$j0`ywFbyDxMUyByD^7^6@Wh-rgZo@Z8yDL zIMSEDq@Cks?oWvM=zDy_Wxg#pgOI!RFAXGAQq;&&Gis1_?Z>NI%zd^0$15b??DwlU z=Ix5@HzG*3H%Yg|M-|5=@Wa8v*D?|bh+%29j(rP+yFI+VdzY6!LRNjLl?4FOsTzY7 z`rVQ?AMj3x$5$7!l6MNvu8Muo7pMFFxA3FG6DmAhp+Xk)e0zAT^!PL2MHUU+HGT-) z?@ht;pC3m|9(i@6x3n;unU%VpGe@=Dx(1t|#6EWyzd7^rpccW<6}JlE(89bnC! zc>X|5J;7|v-f(&o(8M}#NBkS2j&0Cipw;VjZs#jTiMP0QF%%&<4f9n19@II-d?ti0 ztU0}=>dGSONm%uyzxS9L&;RED>6i;YTU>z@OtRR?5Pj*Ls>dk6g8$p^mL6a5iCT!} zSa2@bffKUpnLK=J~IxLb*R0P?K3c%1jSBV2$fj!FJKd(o3OU=C5% zeCb^MmYFNGzPsf6$=(yC#r0{g{y{phuS-ON7QqQj9Stt^#| z6mg+^4=c@QMv^+Jpm%0M6;B-frbHnsd%D+Uue?Axfa*wy^Si_1^d@qs#wPD`8|&-2 z=PAPK;Hi9I9t(5B5AX-9@L*R_P2*zAJSy4Yp@kg7kI8g2_o%c-J5SO%T0%Kx)wae$ zv#-j@AZLrw!_8D9f@6PXtV7X5sTRRCHjIWa-~&w+vlIdP@4I;%f$*=n>+%cjA)lN& zHa+TY)Ni=2>5&iX6Z0+6_yoo?adsCnkCw{7^~D)P$Y>n$;u7#(XY~*j2nyJ#O@}A17>r3esYAcYa72SMGaDvh`fAq{fjFMCR z;mjl`(*sK<`d*oFNXuidpm!JJQ2Q9AZqRsEVS+V&mcmPL>J(=;pS6nM|QYkjc+ z8cou9dewU9)zz5q5DaC?Z(OTC`#^C_e77OXaqG+yK_T!k(P^=@cs`}2&zrxU?nXF$ z$ISk_w7#2d1_nK`y(^nkA~KkbPQGQu%baek8OhVuOzzqMUeKav?GoZJQ3FxRjNEEy z9@%-&uHRftSD10g7~PijN3yZp3Sp=A$gX!AZ8c%kn%cjVZdWBWQ&glvQo#7gYlW+- zBuf4i^Oc_Br-JhZf8?Xb-78sDaP+C>WrDM}bh4 z`yan^^6c&Fu3g{`$#Lf=A03|JI(bw>x|spqQ<;cz2*uVPH_<{7?xs;>D=UmStb zwZ z#dqCU5I%ACn@;D0!_I=iD(}*%cCTC{L>AVh?Jdw0!BiiZ4HOhcqG>2pv4Zd2_Y*9T z1ST<>*EFE2)*p2U!ox0FoOUn)MqMB6@E~O2i(fTI+a|IG>sNsa|Ad{4=wX?25q5U= zI<~%q9m{1iRLezk-bixu+4mcK3k$kodp>~W*ArRZ<=f*ct8Y<@top@9=`3KsKcm{S&7Ck z-vQ;X+SX3|vypZ37q|iFQDAi0p9PNon?3_YxUagS3$DqNPz`4$)!Q&sf7o836ZV-uvfRrM5kVdbQ+kO zhU*Ufo0p_=RuT+HkH+({`oCMB&1o3x-ga>O9BK6)f$EO%vc{%9U~}AZdJzw8aC`EY zPK34qOwlw{=Kg&Bi|@-%V4B;fxJ0Zu-&QxTzlnt-9#Uh^dKI439*rr0N>a4#Pl-l7+E7%=QSm0?6z2*>Q}j7vwK)=w5>KV%~-@s)=Jw5%y)s$i)PY7a;`^ zATMOp7?zt~8?mLPv|q%f_2wmxn6?oKCy!aZUv2+4&GAquGeC!uTv}EZflS_>9ol$W z;hfeKBAYl<=ONZjF-j0xw7D5dg& zVNOB!HKz;<*6f{zS=x?s#Hv?Eej;9$)hN;s3 zaYu~-s;D+nUw_b>Qk=67VS*8MLXkSO{{0;x5(!+E{$oVIA)G%#Es6Mv4onZddi-)oQ3aTX)M~50P+=7yS<*mNuCGN4 zqB=`wv3}_VIG|q`6>mzp5%xRS66eTb9YRD%ByDXMHE3Ds^Aze#5#|@B?wy?M=oG8W zYy&NJ4(!NJ@`7&3!PQZe<;|~To9+pi%su!EvGvWOPqxo<>IK^;=<%2PLSdNiF|Kl} z>R{jK^VW|Wc$=^lE+;J|{8T3v8My$zGGNw=vOD~F%sBen5a`3y=Xx0X(R@^TQfT|Sq^KnG>uvRUHWNph{Ea3 zi4L`hr0A~uEg4S_P6zMNjQ_8xr(e&t#{ch`r=u*olRu{O$bzLdon)M*EbPCt=B9JE zdT$Ev3M(fVRsN=nxqaoGf+RcT%fL8l)?~v4WU;In9!gv6qO&=b7N@HC@x{BMuMY?G zvsQ+FwC+VnuP77Ap|;<KKs*Mg~75>ZTCGG{Qv-U`WmeRz5+~tc5?|3MYF6qT$n(*xY63^3Yf+S{t4lN z^_SAYmGLwKPdSnkRx~%Kb#;kw+Aajn+t?X=N9Lf3`vw2KFHNU5r6Mz^HJ<9RH6xiz zM{x;RL`7x5fi!d+Urmf?F2VF+4H$K{Z&F6z<-zkNzq2~P?Y{k7o-p3jR%%4v(MaJ7 zzN;prv9N=A14W#Kg{zNa+hJtb!fRn@m3~ZV(j8uyAPsv$O-Qf$GXW{RuB^k*m;S*> zF`DV}b+OM=FLFigbEgr-CLEm0wr|B|N@3LILZfx%F$1xz5>f$Y=2*lJMK7x4d#N1{ zMwU5iJHa<^fVJ}IOSUM|a{al{<*YX{E>Y^7rhpJSmUyx@jSXICmVk)|&WEIU{cOJI zgq<_aq&RhN>W^~n>yU|MR-eINJu2xk_+^Qo+eNHg2sdH7rJ0IprO(eflpIBpmDJ2S zmzdtJ9*p|Fm&) zERHJ5#-jj*!+Zhr5eeH9>G~cTc+-O*W<1gzJiWYW&J~}eJDS6N1iGhU+&+lg9`V^H zJG^!0*^xH}KWUM!sqd&r+;3o*3{9>-tpkSVeH20B}VAA6e4ICXNIw@f$| zVzpeKpdC^2xx8{t8@zWRqhXys7C$OrYPg~>(|Ie$AGt;pTKSAZvoLBfcp>=diskza zjalH)2lj>`)2^q##ry)#tN1-ru

NNt1P$r?@4#%z_x8+ON&|tJ*L6JY2V$HFizj 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 literal 66563 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 Date: Mon, 14 Jul 2025 15:58:38 -0700 Subject: [PATCH 0395/1799] draft --- docs/build-insights/toc.yml | 2 +- .../tutorials/build-insights-function-view.md | 8 +- .../tutorials/build-insights-template-view.md | 93 +++++++++---------- 3 files changed, 51 insertions(+), 52 deletions(-) diff --git a/docs/build-insights/toc.yml b/docs/build-insights/toc.yml index 5641215a9c8..d5f07030b96 100644 --- a/docs/build-insights/toc.yml +++ b/docs/build-insights/toc.yml @@ -6,7 +6,7 @@ items: - name: "Tutorials" expanded: true items: - - name: "Troubleshoot function inlining on build time" + - name: "Troubleshoot function inlining impact on build time" href: ../build-insights/tutorials/build-insights-function-view.md - name: "Troubleshoot template instantiation impact on build time" href: ../build-insights/tutorials/build-insights-template-view.md diff --git a/docs/build-insights/tutorials/build-insights-function-view.md b/docs/build-insights/tutorials/build-insights-function-view.md index 6b78c38d12e..35c96d5d196 100644 --- a/docs/build-insights/tutorials/build-insights-function-view.md +++ b/docs/build-insights/tutorials/build-insights-function-view.md @@ -1,11 +1,11 @@ --- -title: "Troubleshoot function inlining on build time" +title: "Troubleshoot function inlining impact on build time" description: "Tutorial for how to use Build Insights function view to troubleshoot the impact of function inlining on build time in your C++ projects." ms.date: 5/30/2024 helpviewer_keywords: ["C++ Build Insights", "inline function analysis", "build time analysis", "__forceinline analysis", "inlines analysis"] ms.topic: troubleshooting-general --- -# Troubleshoot function inlining on build time +# Troubleshoot function inlining impact on build time Use Build Insights **Functions** view to troubleshoot the impact of function inlining on build time in your C++ projects. @@ -128,8 +128,8 @@ Double-click, right-click, or press **Enter** while on a file in the **Functions ## Tips -- You can **File** > **Save As** the ETL file to a more permanent location to keep a record of the build time. You can then compare it to future builds to see if your changes are improving build time. -- If you inadvertently close the Build Insights window, reopen it by finding the `.etl` file in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. +- Use **File** > **Save As** to save the ETL file to a more permanent location to keep a record of the build time information. You can then compare it to future builds to see how your changes are improving things. +- If you close the Build Insights window, reopen it by finding the `.etl` file in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. - To dig into the Build Insights data with Windows Performance Analyzer (WPA), click the **Open in WPA** button in the bottom right of the ETL window. - Drag columns to change the order of the columns. For instance, you may prefer moving the **Time** column to be the first column. You can hide columns by right-clicking on the column header and deselecting the columns you don't want to see. - The **Functions** view provides a filter box to find a function that you're interested in. It does partial matches on the name you provide. diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index fdba6806a98..3177e3af3df 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -1,35 +1,35 @@ --- title: "Troubleshoot template instantiation impact on build time" description: "Tutorial for how to use Build Insights template view to analyze and optimize the impact of template instantiations on build time in your C++ projects." -ms.date: 7/9/2025 +ms.date: 07/14/2025 helpviewer_keywords: ["C++ Build Insights", "template instantiation analysis", "build time analysis"] ms.topic: troubleshooting-general --- + # Troubleshoot template instantiation impact on build time -Use Build Insights **Templates** view to analyze the impact of template instantiations on C++ build time. This feature is especially useful for projects that make heavy use of templates, such as those using template metaprogramming or large generic libraries. +Use Build Insights **Templates** view to analyze the impact of template instantiation on C++ build time. This feature is especially useful for projects that make heavy use of templates, such as those using template metaprogramming or large generic libraries. -Templates view will seem familiar to users of Build Insight's [Functions view](build-insights-function-view.md) due to similar UI and workflow. +**Templates** view will seem familiar to users of Build Insight's [Functions view](build-insights-function-view.md) due to similar UI and workflow. ## Prerequisites - Visual Studio 2022 version 17.10 or later. -- The **C++ Build Insights** component must be installed. It's installed as part of either the Desktop development with C++ workload or the Game development with C++ workload. You can ensure that it is installed by following these steps: +- The **C++ Build Insights** component must be installed. It's installed as part of either the Desktop development with C++ workload or the Game development with C++ workload. You can ensure that it's installed by following these steps: 1. Open the Visual Studio Installer. 1. Choose to modify your Visual Studio installation. - 1. Under the **Individual components** tab, search for and then select **C++ Build Insights**. + 1. Under the **Individual components** tab, search for and then select **C++ Build Insights**, then select **Modify** to install the component. :::image type="complex" source="./media/installer-build-insights.png" alt-text="Screenshot of the Visual Studio Installer":::The search box contains C++ build insights. The item C++ Build Insights is visible and selected.":::image-end::: - 1. Click **Modify** to install the component. - + ## Overview Build Insights, integrated into Visual Studio, helps you optimize your build times--especially for large projects like AAA games. Build Insights provides analytics such as **Templates** view, which displays the time it takes to instantiate each template and shows which template instantiations add the most to your build time. In general, C++ template instantiation happens quickly. In exceptional cases, some template instantiations can noticeably slow down your builds. -In this article, follow along to create a project that demonstrates template instantiation impact on build time, run Build Insights to gather template instantiation times, and analyze the results. +In this article, follow along to create a project that demonstrates template instantiation impact on build time, run Build Insights to analyze that impact, and use those insights to make the build faster. -## Create a template test project +## Create a test project 1. Open Visual Studio and create a new **C++ Console App** project and name it `TemplateAnalysis`. 1. Create a header file called `Templates.h` and replace its contents with the following code: @@ -104,7 +104,7 @@ Template instantiation time collection is off by default to minimize build overh 1. You can also choose where to save the report by selecting **Store Build Insights reports in this directory** and specifying a directory. By default, it's saved in the folder pointed to by the Windows `TEMP` environment variable. 1. Select **OK**. -:::image type="content" source="./media/tools-options-build-insights.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Build Insights > Trace Collection. The Collect Template Instantion checkbox is selected."::: +:::image type="content" source="./media/tools-options-build-insights.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Build Insights > Trace Collection. The Collect Template Instantiation checkbox is selected."::: > [!Note] > Collecting template instantiation times increases build time due to the extra data collected. Only enable it when you want to analyze template instantiation bottlenecks. @@ -115,25 +115,16 @@ From the main menu, select **Build** > **Run Build Insights on Selection** > **R :::image type="content" source="./media/build-insights-rebuild-project.png" alt-text="Screenshot of the main menu with Run Build Insights on Selection > Rebuild selected."::: -When the build finishes, an Event Trace Log (ETL) file opens.The generated name is based on the collection time. - -## Understanding Templates view results - -When interpreting Templates view results, keep these points in mind: - -- **Empty view**: If nothing shows up in the Templates view, it means your build time isn't dominated by template instantiations. This is good news because your templates are not a build bottleneck. -- **Duplicate instantiations**: The same template instantiation appearing multiple times with different translation units indicates that multiple source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. -- **Threshold filtering**: The view only shows instantiations whose contribution exceeds a certain threshold to avoid noise from trivial instantiations. -- **Time aggregation**: The time shown represents the total time spent on that specific template instantiation, including any nested instantiations it triggers. +When the build finishes, an Event Trace Log (ETL) file opens. The filename is based on the collection time. ## Use Templates view to optimize build time -The **Templates** view lists the template instantiations that contributed significantly to build time. Columns provide information about: +The **Templates** view lists the template instantiations that contributed significantly to build time. The columns provide information about: - **Time [sec, %]** shows how long it took to instantiate each template in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among template instantiations based on their use of parallel compiler threads. -- **Specialization Name** shows each template instantiation, including the template arguments that were used. This helps you identify which template specializations are most expensive. -- **Translation Unit** shows which source file each template instantiation happened in. Multiple files can cause the same template instantiation if they include the same header with the template definition. -- **Instantiation File Path** shows where in your source code the template instantiation happens. This helps you locate the exact line of code responsible for the expensive instantiation. +- **Specialization Name** shows each template instantiation, including the template arguments used. This helps you identify which template specializations are most expensive. +- **Translation Unit** shows the source files where each template instantiation happens. Multiple files can cause the same template instantiation if they include the same header with the template definition. +- **Instantiation File Name** shows where the template is defined that is being instantiated. :::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations."::: The Templates view shows two template instantiations of struct S3 taking most (79.448%) of the build time. The Translation Unit column shows that both LargeValue.cpp and SmallValue.cpp are affected. The build time is 4.066 seconds. @@ -143,13 +134,22 @@ The Templates view shows two template instantiations of struct S3 taking most (7 - Expand a template to see its various instantiations and where they happened. - Use the search box to focus on specific templates. +### Understanding Templates view results + +When interpreting Templates view results, keep this in mind: + +- **Empty view**: If nothing shows up in the **Templates** view, it means template instantiations don't dominate your build time. This is good news because your templates aren't a build bottleneck. +- **Duplicate instantiations**: If the same template instantiation appears multiple times across different translation units, that indicates that multiple source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. +- **Threshold filtering**: The view only shows instantiations whose contribution exceeds a certain threshold to avoid noise from trivial instantiations. +- **Time aggregation**: The time shown represents the total time spent on that specific template instantiation, including any nested instantiations. + ## Improve build time by optimizing template instantiations -In the example, we can see that two template instantiations of `S3` are taking 79% of the build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` are causing this template instantiation to be included in the build. +In this example, we can see that two template instantiations of `S3` are taking 79% of the build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` are causing this template instantiation. -Since the **Instantiation File Path** and the **Specialization Name** are the same for both entries, we infer that there's one expensive template instantiation affecting both of our source files. This explains why the time of each of the two template instantiations are about equal. By including `Templates.h` in both source files, we are causing one template instantiation to add significant time to the build. +Since the **Instantiation File Name** and the **Specialization Name** are the same for both entries, we infer that there's one expensive template instantiation affecting both of our source files. This explains why the time for each of the two template instantiations are roughly equal. Including `Templates.h` in both source files causes one template instantiation to add significant time to the build. -From the **Specialization Name** column, we can see that the expensive instantiation is `S3>`, which corresponds to this code in `Templates.h`: +From the **Specialization Name** column, we can see that the expensive instantiation is `S3>`, which is instantiated in this code in `Templates.h`: ```cpp inline size_t LargeValue() @@ -158,17 +158,17 @@ inline size_t LargeValue() }; ``` -There are three main ways to decrease the cost of template instantiations: +There are three main ways to decrease the cost of template instantiations. ### Remove unused templates -Review the template in question and determine if it's being used. If it's not being used, the easiest solution is to remove the function or template. In the example, `LargeValue()` is being used by `LargeValue.cpp`, so we can't remove it. +See if the expensive template is being used. If it's not, the easiest solution is to remove the function or template. In the example, `LargeValue()` is being used in `LargeValue.cpp`, so we can't remove it. You can also consider removing include directives that bring in unnecessary template instantiations. It's easy to forget to remove header files when you're no longer using them, and unused includes can cause significant impact on build time. ### Move template instantiations to source files -For our purposes, let's assume that we need the template instantiation as-is. We can rely on the third approach: moving the definition that causes the expensive template instantiation to a source file. +In this example, we can rely on the third approach: move the definition that causes the expensive template instantiation to a source file. Since `LargeValue.cpp` is the only source file that calls `LargeValue()`, we can move the definition to `LargeValue.cpp`. This prevents the template instantiation from happening in every translation unit that includes `Templates.h`. Remove the current definition of `LargeValue()` from `Templates.h` and replace it with a declaration: @@ -185,9 +185,9 @@ size_t LargeValue() } ``` -Rebuild the project and run Build Insights again. From the main menu, select **Build** > **Run Build Insights on Selection** > **Rebuild**. +Rebuild the project and run Build Insights again from the main menu: select **Build** > **Run Build Insights on Selection** > **Rebuild**. -The build time has significantly decreased. While the template instantiation of `S3` is still contributing to the build time, we've been able to roughly halve the total time by only including necessary template instantiations. You can see the count of `S3` instantiations is now 1 instead of 2. +The build time has decreased. While the template instantiation of `S3` is still contributing to the build time, by only including necessary template instantiations the build time is nearly half what it was before. The count of `S3` instantiations is now 1 instead of 2. :::image type="complex" source="./media/templates-view-after-fix.png" alt-text="Screenshot of the Build Insights Templates view after optimization showing reduced template instantiation time."::: The Templates view now shows only one instantiation of S3 instead of two, and the total build time is significantly less at 3.152 seconds. @@ -197,38 +197,37 @@ This technique scales well to larger projects. If multiple files included `Templ ### Optimize the template implementation -Look at the template instantiation and determine if there's a way to optimize the code. Some optimization techniques include: +Some other optimization techniques include: -- Using simpler template patterns -- Reducing the complexity of template metaprogramming -- Avoiding recursive template instantiation patterns that lead to exponential growth -- Use `if constexpr` instead of SFINAE where possible +- Use simpler template patterns +- Use `if constexpr` instead of Substitution Failure Is Not An Error (SFINAE) where possible +- Avoid recursive template instantiation patterns that lead to exponential growth -For more advanced template optimization techniques, see [Build Throughput Series: More Efficient Template Metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/), which provides detailed examples of reducing template instantiation overhead. +For information about more advanced template optimization techniques, see [Build Throughput Series: More Efficient Template Metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/) which provides detailed examples of reducing template instantiation overhead. ## Tips -- You can use **File** > **Save As** to save the ETL file to a more permanent location to keep a record of the build time. You can then compare it to future builds to see if your changes are improving build time. -- If you inadvertently close the Build Insights window, reopen it by finding the `.etl` file either where you specified it should be saved, or in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. -- Drag columns to change the order of the columns. For instance, you may prefer moving the **Wall Time Responsibility** column to be the first column. You can add or hide columns by right-clicking on the column header and selecting or deselecting the columns you don't want to add or hide. +- Use **File** > **Save As** to save the ETL file to a more permanent location to keep a record of the build time information. You can then compare it to future builds to see how your changes are improving things. +- If you close the Build Insights window, reopen it by finding the `.etl` file either where you specified it should be saved, or in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. +- Drag columns to change the order of the columns. For instance, you may prefer moving the **Wall Time Responsibility** column to be the first column. You can add or hide columns by right-clicking on the column header and selecting or deselecting the columns you want. - The **Templates** view provides a filter box to find a specific template instantiation. It does partial matches on the name you provide. ## Troubleshooting **Templates view is empty**: This could mean: -- Template data collection is not enabled (check your options settings). -- Your build time is not dominated by template instantiations. +- Your build time isn't dominated by template instantiations. +- Template data collection isn't enabled. To turn it on, see [Enable build time data collection](#enable-build-time-data-collection). - Do a rebuild instead of a build. The Build Insights window doesn't appear if nothing builds, which may be the case if no files changed since the last build. -- Ensure you are using Visual Studio 2022 17.10 or later and that the C++ Build Insights component is installed. +- Ensure you're using Visual Studio 2022 17.10 or later and that the C++ Build Insights component is installed. -**Build is much slower with Templates view enabled:** This is expected due to the extra data collection. Disable **Templates** view when not needed. +**Build is much slower with Templates view enabled:** This is expected due to the extra data collection. Turn off template instantiation collection when not needed. For more information, see [Enable build time data collection](#enable-build-time-data-collection). ## See also - [Build Insights tips and tricks](build-insights-tips.md) -- [#include cleanup in Visual Studio](https://devblogs.microsoft.com/cppblog/include-cleanup-in-visual-studio/) +- [#include cleanup in Visual Studio](https://devblogs.microsoft.com/cppblog/include-cleanup-in-visual-studio) - [Troubleshoot header file impact on build time](build-insights-included-files-view.md) - [Troubleshoot function inlining on build time](build-insights-function-view.md) - [Build Insights now available in Visual Studio 2022](https://devblogs.microsoft.com/cppblog/build-insights-now-available-in-visual-studio-2022) -- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/) \ No newline at end of file +- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming) \ No newline at end of file From 48b34df669624cbc99afdac590374999822c824e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 15 Jul 2025 21:58:44 +0800 Subject: [PATCH 0396/1799] Adjust some semicolon placements --- ...me-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md | 4 ++-- ...ol-containers-using-controls-in-a-non-dialog-container_3.h | 3 +-- docs/standard-library/auto-ptr-class.md | 3 +-- 3 files changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index efbd48aaa0d..7a13c0f253d 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -30,8 +30,8 @@ errno_t _ctime32_s( errno_t _ctime64_s( char* buffer, size_t numberOfElements, - const __time64_t *sourceTime ) -; + const __time64_t *sourceTime +); errno_t _wctime_s( wchar_t* buffer, size_t numberOfElements, diff --git a/docs/mfc/codesnippet/CPP/activex-control-containers-using-controls-in-a-non-dialog-container_3.h b/docs/mfc/codesnippet/CPP/activex-control-containers-using-controls-in-a-non-dialog-container_3.h index b28bf3a66d0..bdd7ac78c82 100644 --- a/docs/mfc/codesnippet/CPP/activex-control-containers-using-controls-in-a-non-dialog-container_3.h +++ b/docs/mfc/codesnippet/CPP/activex-control-containers-using-controls-in-a-non-dialog-container_3.h @@ -3,5 +3,4 @@ CCirc m_myCtl; public: afx_msg void OnViewCircdlg(); -} -; \ No newline at end of file +}; diff --git a/docs/standard-library/auto-ptr-class.md b/docs/standard-library/auto-ptr-class.md index 69bdeb67bfb..3eda9ff3615 100644 --- a/docs/standard-library/auto-ptr-class.md +++ b/docs/standard-library/auto-ptr-class.md @@ -20,8 +20,7 @@ For more information about `throw()` and exception handling, see [Exception Spec class auto_ptr { typedef Type element_type; explicit auto_ptr(Type* ptr = 0) throw(); - auto_ptr(auto_ptr& right) throw() - ; + auto_ptr(auto_ptr& right) throw(); template operator auto_ptr() throw(); template From 11822859112493acc1af1f8c3860027d0cf4ee50 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 15 Jul 2025 22:00:10 +0800 Subject: [PATCH 0397/1799] Update metadata in `ctime_s` and variants reference --- ...e-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index 7a13c0f253d..fcf23eb2ceb 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s" title: "ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s" -ms.date: "4/2/2020" +description: "Learn more about: ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s" +ms.date: 4/2/2020 api_name: ["_ctime64_s", "_wctime32_s", "ctime_s", "_wctime64_s", "_ctime32_s", "_wctime_s", "_o__ctime32_s", "_o__ctime64_s", "_o__wctime32_s", "_o__wctime64_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-time-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ctime64_s", "_ctime32_s", "_tctime32_s", "_ctime64_s", "_wctime_s", "_tctime_s", "_tctime64_s", "ctime_s", "ctime32_s"] helpviewer_keywords: ["_wctime32_s function", "ctime64_s function", "_tctime64_s function", "_wctime_s function", "tctime_s function", "_wctime64_s function", "ctime_s function", "ctime32_s function", "_ctime64_s function", "tctime64_s function", "wctime64_s function", "wctime_s function", "_tctime_s function", "tctime32_s function", "wctime32_s function", "time, converting", "_ctime32_s function", "_tctime32_s function"] -ms.assetid: 36ac419a-8000-4389-9fd8-d78b747a009b --- # `ctime_s`, `_ctime32_s`, `_ctime64_s`, `_wctime_s`, `_wctime32_s`, `_wctime64_s` From 765705ef7da8b041a65527766eb5512abfd59168 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 15 Jul 2025 22:39:36 +0800 Subject: [PATCH 0398/1799] Convert Command-line errors and warnings list into a table --- ...command-line-errors-d8000-through-d9999.md | 42 ++++++++++--------- 1 file changed, 23 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md index 5eb48e048e6..ad2391255c6 100644 --- a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md +++ b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md @@ -12,28 +12,32 @@ The articles in this section provide a reference to the command-line errors and ## Command-line error messages -[Command-Line Error D8016](../../error-messages/tool-errors/command-line-error-d8016.md) \ -[Command-Line Error D8021](../../error-messages/tool-errors/command-line-error-d8021.md) \ -[Command-Line Error D8022](../../error-messages/tool-errors/command-line-error-d8022.md) \ -[Command-Line Error D8027](../../error-messages/tool-errors/command-line-error-d8027.md) \ -[Command-Line Error D8036](../../error-messages/tool-errors/command-line-error-d8036.md) \ -[Command-Line Error D8037](../../error-messages/tool-errors/command-line-error-d8037.md) \ -[Command-Line Error D8045](../../error-messages/tool-errors/command-line-error-d8045.md) \ -[Command-Line Error D8048](../../error-messages/tool-errors/command-line-error-d8048.md) \ -[Command-Line Error D8049](../../error-messages/tool-errors/command-line-error-d8049.md) +| Error | Message | +|--|--| +| [Command-Line Error D8016](../../error-messages/tool-errors/command-line-error-d8016.md) | 'option1' and 'option2' command-line options are incompatible | +| [Command-Line Error D8021](../../error-messages/tool-errors/command-line-error-d8021.md) | invalid numeric argument 'number' | +| [Command-Line Error D8022](../../error-messages/tool-errors/command-line-error-d8022.md) | cannot open 'messagefile' | +| [Command-Line Error D8027](../../error-messages/tool-errors/command-line-error-d8027.md) | cannot execute 'component' | +| [Command-Line Error D8036](../../error-messages/tool-errors/command-line-error-d8036.md) | '/option' not allowed with multiple source files | +| [Command-Line Error D8037](../../error-messages/tool-errors/command-line-error-d8037.md) | cannot create temporary il file; clean temp directory of old il files | +| [Command-Line Error D8045](../../error-messages/tool-errors/command-line-error-d8045.md) | cannot compile C file 'file' with the /clr option | +| [Command-Line Error D8048](../../error-messages/tool-errors/command-line-error-d8048.md) | cannot compile C file '*file-name*' with /ZW option | +| [Command-Line Error D8049](../../error-messages/tool-errors/command-line-error-d8049.md) | cannot execute '*compiler-component*': command line is too long to fit in debug record | ## Command-line warning messages -[Command-Line Warning D9024](../../error-messages/tool-errors/command-line-warning-d9024.md) \ -[Command-Line Warning D9025](../../error-messages/tool-errors/command-line-warning-d9025.md) \ -[Command-Line Warning D9026](../../error-messages/tool-errors/command-line-warning-d9026.md) \ -[Command-Line Warning D9027](../../error-messages/tool-errors/command-line-warning-d9027.md) \ -[Command-Line Warning D9028](../../error-messages/tool-errors/command-line-warning-d9028.md) \ -[Command-Line Warning D9035](../../error-messages/tool-errors/command-line-warning-d9035.md) \ -[Command-Line Warning D9036](../../error-messages/tool-errors/command-line-warning-d9036.md) \ -[Command-Line Warning D9040](../../error-messages/tool-errors/command-line-warning-d9040.md) \ -[Command-Line Warning D9041](../../error-messages/tool-errors/command-line-warning-d9041.md) \ -[Command-Line Warning D9043](../../error-messages/tool-errors/command-line-warning-d9043.md) +| Warning | Message | +|--|--| +| [Command-Line Warning D9024](../../error-messages/tool-errors/command-line-warning-d9024.md) | unrecognized source file type 'filename', object file assumed | +| [Command-Line Warning D9025](../../error-messages/tool-errors/command-line-warning-d9025.md) | overriding 'option1' with 'option2' | +| [Command-Line Warning D9026](../../error-messages/tool-errors/command-line-warning-d9026.md) | options apply to entire command line | +| [Command-Line Warning D9027](../../error-messages/tool-errors/command-line-warning-d9027.md) | source file '\' ignored | +| [Command-Line Warning D9028](../../error-messages/tool-errors/command-line-warning-d9028.md) | minimal rebuild failure, reverting to normal build | +| [Command-Line Warning D9035](../../error-messages/tool-errors/command-line-warning-d9035.md) | option '*option*' has been deprecated and will be removed in a future release | +| [Command-Line Warning D9036](../../error-messages/tool-errors/command-line-warning-d9036.md) | '*option\_2*' instead of '*option\_1*' | +| [Command-Line Warning D9040](../../error-messages/tool-errors/command-line-warning-d9040.md) | ignoring option '/analyze'; Code Analysis warnings are not available in this edition of the compiler | +| [Command-Line Warning D9041](../../error-messages/tool-errors/command-line-warning-d9041.md) | invalid value '*option-value*' for '/*option-name*'; assuming '*assumed-value*'; add '/analyze' to command-line options when specifying this warning | +| [Command-Line Warning D9043](../../error-messages/tool-errors/command-line-warning-d9043.md) | invalid value 'warning_level' for 'compiler_option'; assuming '4999'; Code Analysis warnings are not associated with warning levels | ## See also From 0652a0a47e6ca9079bbfb2ec0d1aef5d0edc3ec9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 15 Jul 2025 22:41:04 +0800 Subject: [PATCH 0399/1799] Simplify superfluous relative links in "Command-line errors and warnings" --- ...command-line-errors-d8000-through-d9999.md | 40 +++++++++---------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md index ad2391255c6..ff2098ed1c9 100644 --- a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md +++ b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md @@ -8,36 +8,36 @@ ms.assetid: d02ec7df-26a5-4198-ac92-87b29ec9d5c8 The articles in this section provide a reference to the command-line errors and warnings generated by the build tools. These messages have the form `Dxxxx`, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Command-line error messages | Error | Message | |--|--| -| [Command-Line Error D8016](../../error-messages/tool-errors/command-line-error-d8016.md) | 'option1' and 'option2' command-line options are incompatible | -| [Command-Line Error D8021](../../error-messages/tool-errors/command-line-error-d8021.md) | invalid numeric argument 'number' | -| [Command-Line Error D8022](../../error-messages/tool-errors/command-line-error-d8022.md) | cannot open 'messagefile' | -| [Command-Line Error D8027](../../error-messages/tool-errors/command-line-error-d8027.md) | cannot execute 'component' | -| [Command-Line Error D8036](../../error-messages/tool-errors/command-line-error-d8036.md) | '/option' not allowed with multiple source files | -| [Command-Line Error D8037](../../error-messages/tool-errors/command-line-error-d8037.md) | cannot create temporary il file; clean temp directory of old il files | -| [Command-Line Error D8045](../../error-messages/tool-errors/command-line-error-d8045.md) | cannot compile C file 'file' with the /clr option | -| [Command-Line Error D8048](../../error-messages/tool-errors/command-line-error-d8048.md) | cannot compile C file '*file-name*' with /ZW option | -| [Command-Line Error D8049](../../error-messages/tool-errors/command-line-error-d8049.md) | cannot execute '*compiler-component*': command line is too long to fit in debug record | +| [Command-Line Error D8016](command-line-error-d8016.md) | 'option1' and 'option2' command-line options are incompatible | +| [Command-Line Error D8021](command-line-error-d8021.md) | invalid numeric argument 'number' | +| [Command-Line Error D8022](command-line-error-d8022.md) | cannot open 'messagefile' | +| [Command-Line Error D8027](command-line-error-d8027.md) | cannot execute 'component' | +| [Command-Line Error D8036](command-line-error-d8036.md) | '/option' not allowed with multiple source files | +| [Command-Line Error D8037](command-line-error-d8037.md) | cannot create temporary il file; clean temp directory of old il files | +| [Command-Line Error D8045](command-line-error-d8045.md) | cannot compile C file 'file' with the /clr option | +| [Command-Line Error D8048](command-line-error-d8048.md) | cannot compile C file '*file-name*' with /ZW option | +| [Command-Line Error D8049](command-line-error-d8049.md) | cannot execute '*compiler-component*': command line is too long to fit in debug record | ## Command-line warning messages | Warning | Message | |--|--| -| [Command-Line Warning D9024](../../error-messages/tool-errors/command-line-warning-d9024.md) | unrecognized source file type 'filename', object file assumed | -| [Command-Line Warning D9025](../../error-messages/tool-errors/command-line-warning-d9025.md) | overriding 'option1' with 'option2' | -| [Command-Line Warning D9026](../../error-messages/tool-errors/command-line-warning-d9026.md) | options apply to entire command line | -| [Command-Line Warning D9027](../../error-messages/tool-errors/command-line-warning-d9027.md) | source file '\' ignored | -| [Command-Line Warning D9028](../../error-messages/tool-errors/command-line-warning-d9028.md) | minimal rebuild failure, reverting to normal build | -| [Command-Line Warning D9035](../../error-messages/tool-errors/command-line-warning-d9035.md) | option '*option*' has been deprecated and will be removed in a future release | -| [Command-Line Warning D9036](../../error-messages/tool-errors/command-line-warning-d9036.md) | '*option\_2*' instead of '*option\_1*' | -| [Command-Line Warning D9040](../../error-messages/tool-errors/command-line-warning-d9040.md) | ignoring option '/analyze'; Code Analysis warnings are not available in this edition of the compiler | -| [Command-Line Warning D9041](../../error-messages/tool-errors/command-line-warning-d9041.md) | invalid value '*option-value*' for '/*option-name*'; assuming '*assumed-value*'; add '/analyze' to command-line options when specifying this warning | -| [Command-Line Warning D9043](../../error-messages/tool-errors/command-line-warning-d9043.md) | invalid value 'warning_level' for 'compiler_option'; assuming '4999'; Code Analysis warnings are not associated with warning levels | +| [Command-Line Warning D9024](command-line-warning-d9024.md) | unrecognized source file type 'filename', object file assumed | +| [Command-Line Warning D9025](command-line-warning-d9025.md) | overriding 'option1' with 'option2' | +| [Command-Line Warning D9026](command-line-warning-d9026.md) | options apply to entire command line | +| [Command-Line Warning D9027](command-line-warning-d9027.md) | source file '\' ignored | +| [Command-Line Warning D9028](command-line-warning-d9028.md) | minimal rebuild failure, reverting to normal build | +| [Command-Line Warning D9035](command-line-warning-d9035.md) | option '*option*' has been deprecated and will be removed in a future release | +| [Command-Line Warning D9036](command-line-warning-d9036.md) | '*option\_2*' instead of '*option\_1*' | +| [Command-Line Warning D9040](command-line-warning-d9040.md) | ignoring option '/analyze'; Code Analysis warnings are not available in this edition of the compiler | +| [Command-Line Warning D9041](command-line-warning-d9041.md) | invalid value '*option-value*' for '/*option-name*'; assuming '*assumed-value*'; add '/analyze' to command-line options when specifying this warning | +| [Command-Line Warning D9043](command-line-warning-d9043.md) | invalid value 'warning_level' for 'compiler_option'; assuming '4999'; Code Analysis warnings are not associated with warning levels | ## See also From 043adf56028b2e4f9cef93c1a18341eb9e08a2ef Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 15 Jul 2025 22:41:56 +0800 Subject: [PATCH 0400/1799] Update metadata in "Command-line errors and warnings" --- .../tool-errors/command-line-errors-d8000-through-d9999.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md index ff2098ed1c9..af66c940222 100644 --- a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md +++ b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: Command-line errors and warnings" title: "Command-line errors and warnings" -ms.date: "04/17/2019" -ms.assetid: d02ec7df-26a5-4198-ac92-87b29ec9d5c8 +description: "Learn more about: Command-line errors and warnings" +ms.date: 04/17/2019 --- # Command-line errors and warnings From fb09af6a2f22c90c1a65f594b64ecf65631f297a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 15 Jul 2025 22:48:21 +0800 Subject: [PATCH 0401/1799] Add blockquotes for error messages in range [C2121, C2140] --- docs/error-messages/compiler-errors-1/compiler-error-c2121.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2122.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2124.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2128.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2129.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2130.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2132.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2133.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2134.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2135.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2137.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2138.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2140.md | 2 +- 13 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2121.md b/docs/error-messages/compiler-errors-1/compiler-error-c2121.md index bcd354b2fc1..75a1bf4ff4f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2121.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2121.md @@ -8,6 +8,6 @@ ms.assetid: e04f32da-3736-4df3-8a1c-d687afcecf5c --- # Compiler Error C2121 -'#' : invalid character : possibly the result of a macro expansion +> '#' : invalid character : possibly the result of a macro expansion An invalid # character may have been inserted by an incorrect macro that uses the token-pasting operator (##) instead of the stringizing operator (#). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2122.md b/docs/error-messages/compiler-errors-1/compiler-error-c2122.md index a71d88a415f..ed31a971b0e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2122.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2122.md @@ -8,6 +8,6 @@ ms.assetid: bc060002-cd38-481b-a144-65af035ce851 --- # Compiler Error C2122 -'identifier' : prototype parameter in name list illegal +> 'identifier' : prototype parameter in name list illegal The parameter is not a legal type. ANSI C does not support user-defined types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md index 66e5e748be4..3fc796a0713 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md @@ -8,7 +8,7 @@ ms.assetid: 93392aaa-5582-4d68-8cc5-bd9c62a0ae7e --- # Compiler Error C2124 -divide or mod by zero +> divide or mod by zero A constant expression has a zero denominator. To resolve the error, do not divide by zero. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md index 242935dcf88..df54aa05d30 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2128"] --- # Compiler Error C2128 -'function' : alloc_text/same_seg applicable only to functions with C linkage +> 'function' : alloc_text/same_seg applicable only to functions with C linkage `#pragma alloc_text` can only be used with functions declared to have C linkage. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md index bc65e651420..d8f050c22af 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md @@ -8,7 +8,7 @@ ms.assetid: 21a8223e-1d22-4baa-9ca1-922b7f751dd0 --- # Compiler Error C2129 -static function 'function' declared but not defined +> static function 'function' declared but not defined A forward reference is made to a **`static`** function that is never defined. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md index cf56b31a742..89d450172e0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md @@ -8,7 +8,7 @@ ms.assetid: c6fd5a7e-8f28-4f67-99d1-95a13b0dff90 --- # Compiler Error C2130 -\#line expected a string containing the filename, found 'token' +> #line expected a string containing the filename, found 'token' The optional file name token following [#line](../../preprocessor/hash-line-directive-c-cpp.md) `linenumber` must be a string. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2132.md b/docs/error-messages/compiler-errors-1/compiler-error-c2132.md index c4c21615336..e76e5f7de44 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2132.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2132.md @@ -8,6 +8,6 @@ ms.assetid: 32902472-49d1-4513-888f-b52d336839d5 --- # Compiler Error C2132 -syntax error : unexpected identifier +> syntax error : unexpected identifier An identifier appears in an unsupported context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md index bc9e05e319d..f5b4f95f43a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md @@ -8,7 +8,7 @@ ms.assetid: 8942f9e8-9818-468f-97db-09dbd124fcae --- # Compiler Error C2133 -'identifier' : unknown size +> 'identifier' : unknown size An unsized array is declared as a member of a class, structure, union, or enumeration. The /Za (ANSI C) option does not allow unsized member arrays. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2134.md b/docs/error-messages/compiler-errors-1/compiler-error-c2134.md index 0436d94a766..08e323bc308 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2134.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2134.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2134"] --- # Compiler Error C2134 -'function' : call does not result in a constant expression +> 'function' : call does not result in a constant expression A function declared as constexpr can only call other functions declared as constexpr. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index d830da92acb..1b4b9d23359 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -8,7 +8,7 @@ ms.assetid: aa360d22-4f79-4de1-b384-93cadd10975f --- # Compiler Error C2135 -'bit operator' : illegal bit field operation +> 'bit operator' : illegal bit field operation The address-of operator (`&`) cannot be applied to a bit field. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md index bb5b13eaa61..deaf8d1bef0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md @@ -8,7 +8,7 @@ ms.assetid: 984687ee-7766-4f6b-ae15-0c9a010e2366 --- # Compiler Error C2137 -empty character constant +> empty character constant The empty character constant ( ' ' ) is not permitted. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2138.md b/docs/error-messages/compiler-errors-1/compiler-error-c2138.md index 77a93bb632b..d2519e1c573 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2138.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2138.md @@ -8,6 +8,6 @@ ms.assetid: 59fd1a58-3605-45dd-b9c1-0981e8aab26d --- # Compiler Error C2138 -illegal to define an enumeration without any members +> illegal to define an enumeration without any members An enumeration must have at least one member when /Za (disable Microsoft extensions) is selected. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md index 59c8c1212ff..948aeead5fd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md @@ -8,7 +8,7 @@ ms.assetid: d44a0500-002c-4632-9e5e-c71c3a473ec4 --- # Compiler Error C2140 -'type' : a type that is dependent on a generic type parameter is not allowed as an argument to compiler intrinsic type trait 'trait' +> 'type' : a type that is dependent on a generic type parameter is not allowed as an argument to compiler intrinsic type trait 'trait' An invalid type specifier was passed to a type trait. From cf0fb9bd2693bdcbff0e1d8e00e3fe14ebf5143f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 15 Jul 2025 22:53:37 +0800 Subject: [PATCH 0402/1799] Add "Remarks" and "Example" headings for error references in range [C2121, C2140] --- docs/error-messages/compiler-errors-1/compiler-error-c2121.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2122.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2124.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2128.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2129.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2130.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2131.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2132.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2133.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2134.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2135.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2137.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2138.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2139.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2140.md | 2 ++ 15 files changed, 46 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2121.md b/docs/error-messages/compiler-errors-1/compiler-error-c2121.md index 75a1bf4ff4f..cd01d8c7187 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2121.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2121.md @@ -10,4 +10,6 @@ ms.assetid: e04f32da-3736-4df3-8a1c-d687afcecf5c > '#' : invalid character : possibly the result of a macro expansion +## Remarks + An invalid # character may have been inserted by an incorrect macro that uses the token-pasting operator (##) instead of the stringizing operator (#). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2122.md b/docs/error-messages/compiler-errors-1/compiler-error-c2122.md index ed31a971b0e..10bb751e345 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2122.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2122.md @@ -10,4 +10,6 @@ ms.assetid: bc060002-cd38-481b-a144-65af035ce851 > 'identifier' : prototype parameter in name list illegal +## Remarks + The parameter is not a legal type. ANSI C does not support user-defined types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md index 3fc796a0713..396e7e1b5af 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md @@ -10,8 +10,12 @@ ms.assetid: 93392aaa-5582-4d68-8cc5-bd9c62a0ae7e > divide or mod by zero +## Remarks + A constant expression has a zero denominator. To resolve the error, do not divide by zero. +## Example + The following sample generates C2124: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md index df54aa05d30..f751504c268 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2128"] > 'function' : alloc_text/same_seg applicable only to functions with C linkage +## Remarks + `#pragma alloc_text` can only be used with functions declared to have C linkage. +## Example + The following sample generates C2128: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md index d8f050c22af..67fa66a9007 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md @@ -10,10 +10,14 @@ ms.assetid: 21a8223e-1d22-4baa-9ca1-922b7f751dd0 > static function 'function' declared but not defined +## Remarks + A forward reference is made to a **`static`** function that is never defined. A **`static`** function must be defined within file scope. If the function is defined in another file, it must be declared **`extern`**. +## Example + The following sample generates C2129: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md index 89d450172e0..475e387324d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md @@ -10,8 +10,12 @@ ms.assetid: c6fd5a7e-8f28-4f67-99d1-95a13b0dff90 > #line expected a string containing the filename, found 'token' +## Remarks + The optional file name token following [#line](../../preprocessor/hash-line-directive-c-cpp.md) `linenumber` must be a string. +## Example + The following sample generates C2130: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2131.md b/docs/error-messages/compiler-errors-1/compiler-error-c2131.md index 90733559e1d..948814f5e2d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2131.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2131.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2131"] > expression did not evaluate to a constant +## Remarks + An expression declared as **`const`** or **`constexpr`** didn't evaluate to a constant at compile time. The compiler must be able to determine the value of the expression at the point it's used. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2132.md b/docs/error-messages/compiler-errors-1/compiler-error-c2132.md index e76e5f7de44..c06820f9c13 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2132.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2132.md @@ -10,4 +10,6 @@ ms.assetid: 32902472-49d1-4513-888f-b52d336839d5 > syntax error : unexpected identifier +## Remarks + An identifier appears in an unsupported context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md index f5b4f95f43a..b18736dbd1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md @@ -10,8 +10,12 @@ ms.assetid: 8942f9e8-9818-468f-97db-09dbd124fcae > 'identifier' : unknown size +## Remarks + An unsized array is declared as a member of a class, structure, union, or enumeration. The /Za (ANSI C) option does not allow unsized member arrays. +## Example + The following sample generates C2133: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2134.md b/docs/error-messages/compiler-errors-1/compiler-error-c2134.md index 08e323bc308..6ce299e1b1d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2134.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2134.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2134"] > 'function' : call does not result in a constant expression +## Remarks + A function declared as constexpr can only call other functions declared as constexpr. +## Example + The following sample generates C2134: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index 1b4b9d23359..00bf1ae4c8e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -10,8 +10,12 @@ ms.assetid: aa360d22-4f79-4de1-b384-93cadd10975f > 'bit operator' : illegal bit field operation +## Remarks + The address-of operator (`&`) cannot be applied to a bit field. +## Example + The following sample generates C2135: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md index deaf8d1bef0..5325f43e5a7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md @@ -10,8 +10,12 @@ ms.assetid: 984687ee-7766-4f6b-ae15-0c9a010e2366 > empty character constant +## Remarks + The empty character constant ( ' ' ) is not permitted. +## Example + The following sample generates C2137: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2138.md b/docs/error-messages/compiler-errors-1/compiler-error-c2138.md index d2519e1c573..71e8e331da1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2138.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2138.md @@ -10,4 +10,6 @@ ms.assetid: 59fd1a58-3605-45dd-b9c1-0981e8aab26d > illegal to define an enumeration without any members +## Remarks + An enumeration must have at least one member when /Za (disable Microsoft extensions) is selected. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2139.md b/docs/error-messages/compiler-errors-1/compiler-error-c2139.md index e14f1709bf4..77019c0ed30 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2139.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2139.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C2139"] > '*type*' : an undefined class is not allowed as an argument to compiler intrinsic type trait '*trait*' -An invalid argument was passed to a type trait. - ## Remarks +An invalid argument was passed to a type trait. + For more information, see [Compiler Support for Type Traits](../../extensions/compiler-support-for-type-traits-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md index 948aeead5fd..e32ff6b7727 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md @@ -10,6 +10,8 @@ ms.assetid: d44a0500-002c-4632-9e5e-c71c3a473ec4 > 'type' : a type that is dependent on a generic type parameter is not allowed as an argument to compiler intrinsic type trait 'trait' +## Remarks + An invalid type specifier was passed to a type trait. For more information, see [Compiler Support for Type Traits](../../extensions/compiler-support-for-type-traits-cpp-component-extensions.md). From 1fd9c96db680087bc7f919203a990eb44ced5e47 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 15 Jul 2025 22:54:39 +0800 Subject: [PATCH 0403/1799] Replace term "sample" with "example" for error references in range [C2121, C2140] --- docs/error-messages/compiler-errors-1/compiler-error-c2124.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2128.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2129.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2130.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2133.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2134.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2135.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2137.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2139.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2140.md | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md index 396e7e1b5af..a46e8a8c79d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md @@ -16,7 +16,7 @@ A constant expression has a zero denominator. To resolve the error, do not divid ## Example -The following sample generates C2124: +The following example generates C2124: ```cpp // C2124.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md index f751504c268..276d6f4de7f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md @@ -15,7 +15,7 @@ helpviewer_keywords: ["C2128"] ## Example -The following sample generates C2128: +The following example generates C2128: ```cpp // C2128.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md index 67fa66a9007..30689baf018 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md @@ -18,7 +18,7 @@ A **`static`** function must be defined within file scope. If the function is de ## Example -The following sample generates C2129: +The following example generates C2129: ```cpp // C2129.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md index 475e387324d..37e799f129f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md @@ -16,7 +16,7 @@ The optional file name token following [#line](../../preprocessor/hash-line-dire ## Example -The following sample generates C2130: +The following example generates C2130: ```cpp // C2130.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md index b18736dbd1a..65a62e03346 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md @@ -16,7 +16,7 @@ An unsized array is declared as a member of a class, structure, union, or enumer ## Example -The following sample generates C2133: +The following example generates C2133: ```cpp // C2133.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2134.md b/docs/error-messages/compiler-errors-1/compiler-error-c2134.md index 6ce299e1b1d..2e79ffe2bb8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2134.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2134.md @@ -15,7 +15,7 @@ A function declared as constexpr can only call other functions declared as const ## Example -The following sample generates C2134: +The following example generates C2134: ```cpp // C2134.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index 00bf1ae4c8e..eb6ff4869a7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -16,7 +16,7 @@ The address-of operator (`&`) cannot be applied to a bit field. ## Example -The following sample generates C2135: +The following example generates C2135: ```cpp // C2135.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md index 5325f43e5a7..22ce7ae5778 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md @@ -16,7 +16,7 @@ The empty character constant ( ' ' ) is not permitted. ## Example -The following sample generates C2137: +The following example generates C2137: ```cpp // C2137.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2139.md b/docs/error-messages/compiler-errors-1/compiler-error-c2139.md index 77019c0ed30..6df0479ed1e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2139.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2139.md @@ -17,7 +17,7 @@ For more information, see [Compiler Support for Type Traits](../../extensions/co ## Example -The following sample generates C2139. +The following example generates C2139. ```cpp // C2139.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md index e32ff6b7727..72316738fd5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md @@ -18,7 +18,7 @@ For more information, see [Compiler Support for Type Traits](../../extensions/co ## Example -The following sample generates C2140. +The following example generates C2140. ```cpp // C2140.cpp From 51f00f1bb67c243774fc21a95d90f3f09ebaa2ed Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 15 Jul 2025 22:57:14 +0800 Subject: [PATCH 0404/1799] Update metadata for error references in range [C2121, C2140] --- .../error-messages/compiler-errors-1/compiler-error-c2121.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2122.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2124.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2128.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2129.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2130.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2131.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2132.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2133.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2135.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2137.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2138.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2139.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2140.md | 5 ++--- 14 files changed, 27 insertions(+), 38 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2121.md b/docs/error-messages/compiler-errors-1/compiler-error-c2121.md index cd01d8c7187..3c2b4770564 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2121.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2121.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2121" title: "Compiler Error C2121" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2121" +ms.date: 11/04/2016 f1_keywords: ["C2121"] helpviewer_keywords: ["C2121"] -ms.assetid: e04f32da-3736-4df3-8a1c-d687afcecf5c --- # Compiler Error C2121 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2122.md b/docs/error-messages/compiler-errors-1/compiler-error-c2122.md index 10bb751e345..31ae2f699a5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2122.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2122.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2122" title: "Compiler Error C2122" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2122" +ms.date: 11/04/2016 f1_keywords: ["C2122"] helpviewer_keywords: ["C2122"] -ms.assetid: bc060002-cd38-481b-a144-65af035ce851 --- # Compiler Error C2122 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md index a46e8a8c79d..e20cba89e6a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2124" title: "Compiler Error C2124" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2124" +ms.date: 11/04/2016 f1_keywords: ["C2124"] helpviewer_keywords: ["C2124"] -ms.assetid: 93392aaa-5582-4d68-8cc5-bd9c62a0ae7e --- # Compiler Error C2124 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md index 276d6f4de7f..a2d21596f72 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2128" title: "Compiler Error C2128" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2128" +ms.date: 11/04/2016 f1_keywords: ["C2128"] helpviewer_keywords: ["C2128"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md index 30689baf018..161c15cfb96 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2129" title: "Compiler Error C2129" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2129" +ms.date: 11/04/2016 f1_keywords: ["C2129"] helpviewer_keywords: ["C2129"] -ms.assetid: 21a8223e-1d22-4baa-9ca1-922b7f751dd0 --- # Compiler Error C2129 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md index 37e799f129f..5f1fd271618 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2130" title: "Compiler Error C2130" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2130" +ms.date: 11/04/2016 f1_keywords: ["C2130"] helpviewer_keywords: ["C2130"] -ms.assetid: c6fd5a7e-8f28-4f67-99d1-95a13b0dff90 --- # Compiler Error C2130 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2131.md b/docs/error-messages/compiler-errors-1/compiler-error-c2131.md index 948814f5e2d..32855ce4313 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2131.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2131.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2131" title: "Compiler Error C2131" -ms.date: "02/28/2019" +description: "Learn more about: Compiler Error C2131" +ms.date: 02/28/2019 f1_keywords: ["C2131"] helpviewer_keywords: ["C2131"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2132.md b/docs/error-messages/compiler-errors-1/compiler-error-c2132.md index c06820f9c13..0bf9a330741 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2132.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2132.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2132" title: "Compiler Error C2132" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2132" +ms.date: 11/04/2016 f1_keywords: ["C2132"] helpviewer_keywords: ["C2132"] -ms.assetid: 32902472-49d1-4513-888f-b52d336839d5 --- # Compiler Error C2132 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md index 65a62e03346..fbeed35e5b4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2133" title: "Compiler Error C2133" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2133" +ms.date: 11/04/2016 f1_keywords: ["C2133"] helpviewer_keywords: ["C2133"] -ms.assetid: 8942f9e8-9818-468f-97db-09dbd124fcae --- # Compiler Error C2133 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index eb6ff4869a7..4af1d4f1b40 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2135" title: "Compiler Error C2135" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2135" +ms.date: 11/04/2016 f1_keywords: ["C2135"] helpviewer_keywords: ["C2135"] -ms.assetid: aa360d22-4f79-4de1-b384-93cadd10975f --- # Compiler Error C2135 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md index 22ce7ae5778..283c3c3777a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2137" title: "Compiler Error C2137" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2137" +ms.date: 11/04/2016 f1_keywords: ["C2137"] helpviewer_keywords: ["C2137"] -ms.assetid: 984687ee-7766-4f6b-ae15-0c9a010e2366 --- # Compiler Error C2137 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2138.md b/docs/error-messages/compiler-errors-1/compiler-error-c2138.md index 71e8e331da1..3b597d22ad4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2138.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2138.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2138" title: "Compiler Error C2138" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2138" +ms.date: 11/04/2016 f1_keywords: ["C2138"] helpviewer_keywords: ["C2138"] -ms.assetid: 59fd1a58-3605-45dd-b9c1-0981e8aab26d --- # Compiler Error C2138 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2139.md b/docs/error-messages/compiler-errors-1/compiler-error-c2139.md index 6df0479ed1e..3f09eaac25a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2139.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2139.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2139" title: "Compiler Error C2139" +description: "Learn more about: Compiler Error C2139" ms.date: 05/03/2021 f1_keywords: ["C2139"] helpviewer_keywords: ["C2139"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md index 72316738fd5..5d5a0648071 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2140" title: "Compiler Error C2140" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2140" +ms.date: 11/04/2016 f1_keywords: ["C2140"] helpviewer_keywords: ["C2140"] -ms.assetid: d44a0500-002c-4632-9e5e-c71c3a473ec4 --- # Compiler Error C2140 From a4dacbd473f7fa5d0b748f341276f7815e1a3473 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 15 Jul 2025 15:34:04 -0700 Subject: [PATCH 0405/1799] alphabetize list --- docs/sanitizers/asan-runtime.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index eefff67b8e0..52fac2efa2a 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -140,13 +140,9 @@ For more information, see the [Differences with Clang 12.0](asan.md#differences) ### MSVC-specific AddressSanitizer runtime options -- `windows_hook_legacy_allocators` - Boolean, set to `false` to disable interception of [`GlobalAlloc`](/windows/win32/api/winbase/nf-winbase-globalalloc) and [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-localalloc) allocators. +- [`continue_on_error`](asan-continue-on-error.md) Boolean, set to `false` by default. When set to `true`, it allows the program to continue executing after a memory violation is reported, allowing you to collect multiple error reports. + - > [!NOTE] - > The option `windows_hook_legacy_allocators` wasn't available in the public llvm-project runtime when this article was written. The option may eventually be contributed back to the public project; however, it's dependent on code review and community acceptance. - > - > The option `windows_hook_rtl_allocators`, previously an opt-in feature while AddressSanitizer was experimental, is now enabled by default. In versions before Visual Studio 2022 version 17.4.6, the default option value is `false`. In Visual Studio 2022 version 17.4.6 and later versions, the option `windows_hook_rtl_allocators` defaults to `true`. - `iat_overwrite` String, set to `"error"` by default. Other possible values are `"protect"` and `"ignore"`. Some modules may overwrite the [`import address table`](/windows/win32/debug/pe-format#import-address-table) of other modules to customize implementations of certain functions. For example, drivers commonly provide custom implementations for specific hardware. The `iat_overwrite` option manages the AddressSanitizer runtime's protection against overwrites for specific [`memoryapi.h`](/windows/win32/api/memoryapi/) functions. The runtime currently tracks the [`VirtualAlloc`](/windows/win32/api/memoryapi/nf-memoryapi-virtualalloc), [`VirtualProtect`](/windows/win32/api/memoryapi/nf-memoryapi-virtualprotect), and [`VirtualQuery`](/windows/win32/api/memoryapi/nf-memoryapi-virtualquery) functions for protection. This option is available in Visual Studio 2022 version 17.5 Preview 1 and later versions. The following `iat_overwrite` values control how the runtime reacts when protected functions are overwritten: @@ -160,7 +156,14 @@ Boolean (false by default), set to `true` to enable the process to terminate wit >[!NOTE] >When abort_on_error value is set to true, on Windows the program terminates with an exit(3). In order to not change current behavior we decided to introduce this new option instead. If both abort_on_error and windows_fast_fail_on_error are true, the program will exit with the __fastfail. -- [`continue_on_error`](asan-continue-on-error.md) Boolean, set to `false` by default. When set to `true`, it allows the program to continue executing after a memory violation is reported, allowing you to collect multiple error reports. +- `windows_hook_legacy_allocators` + Boolean, set to `false` to disable interception of [`GlobalAlloc`](/windows/win32/api/winbase/nf-winbase-globalalloc) and [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-localalloc) allocators. + + > [!NOTE] + > The option `windows_hook_legacy_allocators` wasn't available in the public llvm-project runtime when this article was written. The option may eventually be contributed back to the public project; however, it's dependent on code review and community acceptance. + > + > The option `windows_hook_rtl_allocators`, previously an opt-in feature while AddressSanitizer was experimental, is now enabled by default. In versions before Visual Studio 2022 version 17.4.6, the default option value is `false`. In Visual Studio 2022 version 17.4.6 and later versions, the option `windows_hook_rtl_allocators` defaults to `true`. + ## AddressSanitizer list of intercepted functions (Windows) From e1793134bbd30e3629a3033d3ac17ddb9e946cf4 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 15 Jul 2025 16:25:01 -0700 Subject: [PATCH 0406/1799] edit pass --- .../tutorials/build-insights-template-view.md | 94 +++++++++---------- 1 file changed, 47 insertions(+), 47 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index 3177e3af3df..f43f2eecf62 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -8,31 +8,31 @@ ms.topic: troubleshooting-general # Troubleshoot template instantiation impact on build time -Use Build Insights **Templates** view to analyze the impact of template instantiation on C++ build time. This feature is especially useful for projects that make heavy use of templates, such as those using template metaprogramming or large generic libraries. +Use the Build Insights **Templates** view to see how template instantiation affects C++ build time. It's especially helpful for projects that use lots of templates, like those with template metaprogramming or large generic libraries. -**Templates** view will seem familiar to users of Build Insight's [Functions view](build-insights-function-view.md) due to similar UI and workflow. +The **Templates** view works like the Build Insights [Functions view](build-insights-function-view.md). ## Prerequisites - Visual Studio 2022 version 17.10 or later. -- The **C++ Build Insights** component must be installed. It's installed as part of either the Desktop development with C++ workload or the Game development with C++ workload. You can ensure that it's installed by following these steps: +- The **C++ Build Insights** component must be installed. It's included in either the Desktop development with C++ workload or the Game development with C++ workload. To check if it's installed, follow these steps: 1. Open the Visual Studio Installer. - 1. Choose to modify your Visual Studio installation. - 1. Under the **Individual components** tab, search for and then select **C++ Build Insights**, then select **Modify** to install the component. - :::image type="complex" source="./media/installer-build-insights.png" alt-text="Screenshot of the Visual Studio Installer":::The search box contains C++ build insights. The item C++ Build Insights is visible and selected.":::image-end::: + 1. Select **Modify** to change your Visual Studio installation. + 1. On the **Individual components** tab, search for and select **C++ Build Insights**, then select **Close** to finish installing the component. + :::image type="content" source="./media/installer-build-insights.png" alt-text="Screenshot of the Visual Studio Installer. The search box contains C++ Build Insights. The item C++ Build Insights is visible and selected."::: ## Overview -Build Insights, integrated into Visual Studio, helps you optimize your build times--especially for large projects like AAA games. Build Insights provides analytics such as **Templates** view, which displays the time it takes to instantiate each template and shows which template instantiations add the most to your build time. +Build Insights, integrated into Visual Studio, helps you optimize your build times--especially for large projects like AAA games. Build Insights provides analytics such as the **Templates** view, which shows the time it takes to instantiate each template and which template instantiations add the most to your build time. -In general, C++ template instantiation happens quickly. In exceptional cases, some template instantiations can noticeably slow down your builds. +In general, C++ template instantiation happens quickly. In rare cases, some template instantiations can noticeably slow down your build. -In this article, follow along to create a project that demonstrates template instantiation impact on build time, run Build Insights to analyze that impact, and use those insights to make the build faster. +In this article, you create a project that shows how template instantiation affects build time, run Build Insights to analyze the impact, and use those insights to make the build faster. ## Create a test project -1. Open Visual Studio and create a new **C++ Console App** project and name it `TemplateAnalysis`. -1. Create a header file called `Templates.h` and replace its contents with the following code: +1. Open Visual Studio and create a new **C++ Console App** project. Name it `TemplateAnalysis`. +1. Create a header file named `Templates.h`, then replace its contents with the following code: ```cpp #pragma once @@ -63,7 +63,7 @@ In this article, follow along to create a project that demonstrates template ins } ``` -1. Create a source file called `LargeValue.cpp` and replace its contents with the following code: +1. Create a source file named `LargeValue.cpp`, then replace its contents with the following code: ```cpp #include "Templates.h" @@ -96,12 +96,12 @@ In this article, follow along to create a project that demonstrates template ins ## Enable build time data collection -Template instantiation time collection is off by default to minimize build overhead. To enable it: +Template instantiation time collection is off by default to minimize build overhead. To turn it on: 1. In Visual Studio, go to **Tools** > **Options**. 1. In the **Options** dialog, expand **Build Insights** in the left navigation. 1. Select **Collect Template Instantiation**. -1. You can also choose where to save the report by selecting **Store Build Insights reports in this directory** and specifying a directory. By default, it's saved in the folder pointed to by the Windows `TEMP` environment variable. +1. To choose where to save the report, select **Store Build Insights reports in this directory** and enter a directory. By default, it's saved in the folder pointed to by the Windows `TEMP` environment variable. 1. Select **OK**. :::image type="content" source="./media/tools-options-build-insights.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Build Insights > Trace Collection. The Collect Template Instantiation checkbox is selected."::: @@ -111,45 +111,45 @@ Template instantiation time collection is off by default to minimize build overh ## Run Build Insights to get template instantiation data -From the main menu, select **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project. +From the main menu, select **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in Solution Explorer and select **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project. :::image type="content" source="./media/build-insights-rebuild-project.png" alt-text="Screenshot of the main menu with Run Build Insights on Selection > Rebuild selected."::: -When the build finishes, an Event Trace Log (ETL) file opens. The filename is based on the collection time. +When the build finishes, an Event Trace Log (ETL) file opens. The file name is based on the collection time. ## Use Templates view to optimize build time The **Templates** view lists the template instantiations that contributed significantly to build time. The columns provide information about: -- **Time [sec, %]** shows how long it took to instantiate each template in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among template instantiations based on their use of parallel compiler threads. -- **Specialization Name** shows each template instantiation, including the template arguments used. This helps you identify which template specializations are most expensive. -- **Translation Unit** shows the source files where each template instantiation happens. Multiple files can cause the same template instantiation if they include the same header with the template definition. -- **Instantiation File Name** shows where the template is defined that is being instantiated. +- **Time [sec, %]** shows how long it takes to instantiate each template in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among template instantiations based on their use of parallel compiler threads. +- **Specialization Name** shows each template instantiation, including the template arguments used. This helps you find which template specializations are most expensive. +- **Translation Unit** shows the source files where each template instantiation happens. Different files can cause the same template instantiation if they include the same header with the template definition. +- **Instantiation File Name** shows where the template is defined. :::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations."::: -The Templates view shows two template instantiations of struct S3 taking most (79.448%) of the build time. The Translation Unit column shows that both LargeValue.cpp and SmallValue.cpp are affected. The build time is 4.066 seconds. +The Templates view shows two template instantiations of struct S3 taking most (79.448 percent) of the build time. The Translation Unit column shows that both LargeValue.cpp and SmallValue.cpp are affected. The build time is 4.066 seconds. :::image-end::: - Sort by **Time** to find the templates that take the longest to instantiate. -- Expand a template to see its various instantiations and where they happened. +- Expand a template to see its instantiations and where they happened. - Use the search box to focus on specific templates. ### Understanding Templates view results When interpreting Templates view results, keep this in mind: -- **Empty view**: If nothing shows up in the **Templates** view, it means template instantiations don't dominate your build time. This is good news because your templates aren't a build bottleneck. -- **Duplicate instantiations**: If the same template instantiation appears multiple times across different translation units, that indicates that multiple source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. -- **Threshold filtering**: The view only shows instantiations whose contribution exceeds a certain threshold to avoid noise from trivial instantiations. -- **Time aggregation**: The time shown represents the total time spent on that specific template instantiation, including any nested instantiations. +- **Empty view**: If nothing shows up in the **Templates** view, template instantiations don't dominate your build time. That's good news because your templates aren't a build bottleneck. +- **Duplicate instantiations**: If the same template instantiation appears multiple times across different translation units, different source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. +- **Threshold filtering**: The view only shows instantiations whose contribution exceeds a certain threshold, so you can focus on the most impactful ones and avoid noise from trivial instantiations. +- **Time aggregation**: The time shown is the total time spent on that specific template instantiation, including any nested instantiations. ## Improve build time by optimizing template instantiations -In this example, we can see that two template instantiations of `S3` are taking 79% of the build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` are causing this template instantiation. +In this example, two template instantiations of `S3` take 79 percent of the build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` cause this template instantiation. -Since the **Instantiation File Name** and the **Specialization Name** are the same for both entries, we infer that there's one expensive template instantiation affecting both of our source files. This explains why the time for each of the two template instantiations are roughly equal. Including `Templates.h` in both source files causes one template instantiation to add significant time to the build. +Because the **Instantiation File Name** and the **Specialization Name** are the same for both entries, there's one expensive template instantiation that affects both source files. That's why the time for each of the two template instantiations is roughly equal. Including `Templates.h` in both source files causes one template instantiation to add significant time to the build. -From the **Specialization Name** column, we can see that the expensive instantiation is `S3>`, which is instantiated in this code in `Templates.h`: +From the **Specialization Name** column, the expensive instantiation is `S3>`, which is instantiated in this code in `Templates.h`: ```cpp inline size_t LargeValue() @@ -158,19 +158,19 @@ inline size_t LargeValue() }; ``` -There are three main ways to decrease the cost of template instantiations. +Here are three main ways to decrease the cost of template instantiations. ### Remove unused templates -See if the expensive template is being used. If it's not, the easiest solution is to remove the function or template. In the example, `LargeValue()` is being used in `LargeValue.cpp`, so we can't remove it. +Check if the expensive template is used. If it isn't, the easiest solution is to remove the function or template. In the example, `LargeValue()` is used in `LargeValue.cpp`, so you can't remove it. -You can also consider removing include directives that bring in unnecessary template instantiations. It's easy to forget to remove header files when you're no longer using them, and unused includes can cause significant impact on build time. +Consider removing include directives that bring in unnecessary template instantiations. It's easy to forget to remove header files when you aren't using them, and unused includes can significantly affect build time. ### Move template instantiations to source files -In this example, we can rely on the third approach: move the definition that causes the expensive template instantiation to a source file. +In this example, rely on the third approach: move the definition that causes the expensive template instantiation to a source file. -Since `LargeValue.cpp` is the only source file that calls `LargeValue()`, we can move the definition to `LargeValue.cpp`. This prevents the template instantiation from happening in every translation unit that includes `Templates.h`. Remove the current definition of `LargeValue()` from `Templates.h` and replace it with a declaration: +Because `LargeValue.cpp` is the only source file that calls `LargeValue()`, move the definition to `LargeValue.cpp`. This change prevents the template instantiation from happening in every translation unit that includes `Templates.h`. Remove the current definition of `LargeValue()` from `Templates.h` and replace it with a declaration: ```cpp size_t LargeValue(); @@ -185,43 +185,43 @@ size_t LargeValue() } ``` -Rebuild the project and run Build Insights again from the main menu: select **Build** > **Run Build Insights on Selection** > **Rebuild**. +Rebuild the project and run Build Insights again from the main menu. Select **Build** > **Run Build Insights on Selection** > **Rebuild**. -The build time has decreased. While the template instantiation of `S3` is still contributing to the build time, by only including necessary template instantiations the build time is nearly half what it was before. The count of `S3` instantiations is now 1 instead of 2. +The build time decreases. While the template instantiation of `S3` still contributes to the build time, including only necessary template instantiations cuts the build time nearly in half. The count of `S3` instantiations is now one instead of two. -:::image type="complex" source="./media/templates-view-after-fix.png" alt-text="Screenshot of the Build Insights Templates view after optimization showing reduced template instantiation time."::: +:::image type="complex" source="./media/templates-view-after-fix.png" alt-text="Screenshot of the Build Insights Templates view after optimization. The view shows reduced template instantiation time."::: The Templates view now shows only one instantiation of S3 instead of two, and the total build time is significantly less at 3.152 seconds. :::image-end::: -This technique scales well to larger projects. If multiple files included `Templates.h`, each of those files would have added the instantiation time of `LargeValue()` to the total build time. By moving the definition of `LargeValue()` to a dedicated source file, we minimize our build time. +This technique works well for larger projects. If multiple files include `Templates.h`, each file adds the instantiation time of `LargeValue()` to the total build time. By moving the definition of `LargeValue()` to a dedicated source file, you minimize build time. ### Optimize the template implementation -Some other optimization techniques include: +Other optimization techniques include: - Use simpler template patterns -- Use `if constexpr` instead of Substitution Failure Is Not An Error (SFINAE) where possible +- Use `if constexpr` instead of Substitution Failure Is Not An Error (SFINAE) when possible - Avoid recursive template instantiation patterns that lead to exponential growth -For information about more advanced template optimization techniques, see [Build Throughput Series: More Efficient Template Metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/) which provides detailed examples of reducing template instantiation overhead. +For more advanced template optimization techniques, see [Build Throughput Series: More Efficient Template Metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/), which provides detailed examples of reducing template instantiation overhead. ## Tips - Use **File** > **Save As** to save the ETL file to a more permanent location to keep a record of the build time information. You can then compare it to future builds to see how your changes are improving things. - If you close the Build Insights window, reopen it by finding the `.etl` file either where you specified it should be saved, or in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. -- Drag columns to change the order of the columns. For instance, you may prefer moving the **Wall Time Responsibility** column to be the first column. You can add or hide columns by right-clicking on the column header and selecting or deselecting the columns you want. -- The **Templates** view provides a filter box to find a specific template instantiation. It does partial matches on the name you provide. +- Drag columns to change the order of the columns. For example, you might want to move the **Wall Time Responsibility** column to the first column. You can add or hide columns by right-clicking the column header and selecting or deselecting the columns you want. +- The **Templates** view has a filter box to help you find a specific template instantiation. It does partial matches on the name you provide. ## Troubleshooting -**Templates view is empty**: This could mean: +**Templates view is empty**: This can mean: - Your build time isn't dominated by template instantiations. - Template data collection isn't enabled. To turn it on, see [Enable build time data collection](#enable-build-time-data-collection). -- Do a rebuild instead of a build. The Build Insights window doesn't appear if nothing builds, which may be the case if no files changed since the last build. -- Ensure you're using Visual Studio 2022 17.10 or later and that the C++ Build Insights component is installed. +- Do a rebuild instead of a build. The Build Insights window doesn't appear if nothing builds, which can be the case if no files changed since the last build. +- Make sure you're using Visual Studio 2022 17.10 or later, and that the C++ Build Insights component is installed. -**Build is much slower with Templates view enabled:** This is expected due to the extra data collection. Turn off template instantiation collection when not needed. For more information, see [Enable build time data collection](#enable-build-time-data-collection). +**Build is much slower with Templates view enabled:** This is expected because of the extra data collection. Turn off template instantiation collection when you don't need it. For more information, see [Enable build time data collection](#enable-build-time-data-collection). ## See also From cc6cfb591e0741e9bdd8e6edad5a6ee4fa5f41ce Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 17:50:29 +0800 Subject: [PATCH 0407/1799] Add missing `#endif` in `_{a,t,w}cmdln` reference --- docs/c-runtime-library/acmdln-tcmdln-wcmdln.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md b/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md index 4d60eaa7afd..2e17d1fe582 100644 --- a/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md +++ b/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md @@ -24,6 +24,7 @@ wchar_t * _wcmdln; #define _tcmdln _wcmdln #else #define _tcmdln _acmdln +#endif ``` ## Remarks From 74724236dd81d0a00c491af1525bc4ca8f8fac92 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 17:51:10 +0800 Subject: [PATCH 0408/1799] Remove unneeded `./` link prefix in `_{a,t,w}cmdln` reference --- docs/c-runtime-library/acmdln-tcmdln-wcmdln.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md b/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md index 2e17d1fe582..1953dbdc2fa 100644 --- a/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md +++ b/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md @@ -33,4 +33,4 @@ These CRT internal variables store the complete command line. They're exposed in ## See also -[Global variables](./global-variables.md) +[Global variables](global-variables.md) From 9eb48176d422137fcec3ff230bfce494a085397a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 17:52:13 +0800 Subject: [PATCH 0409/1799] Update metadata in `_{a,t,w}cmdln` reference --- docs/c-runtime-library/acmdln-tcmdln-wcmdln.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md b/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md index 1953dbdc2fa..45d1630a097 100644 --- a/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md +++ b/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _acmdln, _tcmdln, _wcmdln" title: "_acmdln, _tcmdln, _wcmdln" -ms.date: "11/04/2016" +description: "Learn more about: _acmdln, _tcmdln, _wcmdln" +ms.date: 11/04/2016 api_name: ["_wcmdln", "_acmdln"] api_location: ["msvcrt.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_acmdln", "_wcmdln", "_tcmdln"] helpviewer_keywords: ["_wcmdln global variable", "wcmdln global variable", "_acmdln global variable", "_tcmdln global variable", "tcmdln global variable", "acmdln global variable"] -ms.assetid: 4fc0a6a0-3f93-420a-a19f-5276061ba539 --- # `_acmdln`, `_tcmdln`, `_wcmdln` From e67d86870fbf3e906b4a104597af398d0c810555 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 18:17:09 +0800 Subject: [PATCH 0410/1799] Elide duplicate rows in tables --- docs/c-runtime-library/is-isw-routines.md | 1 - docs/c-runtime-library/routine-mappings.md | 1 - docs/mfc/reference/cmfctoolbar-class.md | 1 - docs/mfc/reference/cpane-class.md | 1 - 4 files changed, 4 deletions(-) diff --git a/docs/c-runtime-library/is-isw-routines.md b/docs/c-runtime-library/is-isw-routines.md index 749a96439bf..84eb09729b9 100644 --- a/docs/c-runtime-library/is-isw-routines.md +++ b/docs/c-runtime-library/is-isw-routines.md @@ -126,7 +126,6 @@ Character has property specified by the `desc` argument. For each valid value of | `_LOWER` | `iswlower(c)` | | `_ALPHA | _BLANK | _DIGIT | _PUNCT` | `iswprint(c)` | | `_PUNCT` | `iswpunct(c)` | -| `_BLANK` | `iswblank(c)` | | `_SPACE` | `iswspace(c)` | | `_UPPER` | `iswupper(c)` | | `_HEX` | `iswxdigit(c)` | diff --git a/docs/c-runtime-library/routine-mappings.md b/docs/c-runtime-library/routine-mappings.md index 087515c0cde..a19cd5a3567 100644 --- a/docs/c-runtime-library/routine-mappings.md +++ b/docs/c-runtime-library/routine-mappings.md @@ -127,7 +127,6 @@ For related information, see [Generic-text mappings in tchar.h](../text/generic- | `_tcsnicmp` | `_strnicmp` | `_mbsnbicmp` | `_wcsnicmp` | | `_tcsnicoll` | `_strnicoll` | `_mbsnbicoll` | `_wcsnicoll` | | `_tcsninc` | `_strninc` | `_mbsninc` | `_wcsninc` | -| `_tcsnccnt` | `_strncnt` | `_mbsnccnt` | `_wcsncnt` | | `_tcsnset` | `_strnset` | `_mbsnbset` | `_wcsnset` | | `_tcspbrk` | `strpbrk` | `_mbspbrk` | `wcspbrk` | | `_tcsspnp` | `_strspnp` | `_mbsspnp` | `_wcsspnp` | diff --git a/docs/mfc/reference/cmfctoolbar-class.md b/docs/mfc/reference/cmfctoolbar-class.md index e71eb71307c..9e9384ef1d5 100644 --- a/docs/mfc/reference/cmfctoolbar-class.md +++ b/docs/mfc/reference/cmfctoolbar-class.md @@ -47,7 +47,6 @@ class CMFCToolBar : public CMFCBaseToolBar |[`CMFCToolBar::CanBeClosed`](#canbeclosed)|Specifies whether a user can close the toolbar. (Overrides [`CBasePane::CanBeClosed`](../../mfc/reference/cbasepane-class.md#canbeclosed).)| |[`CMFCToolBar::CanBeRestored`](#canberestored)|Determines whether the system can restore a toolbar to its original state after customization.| |[`CMFCToolBar::CanFocus`](#canfocus)|Specifies whether the pane can receive focus. (Overrides [`CBasePane::CanFocus`](../../mfc/reference/cbasepane-class.md#canfocus).)| -|[`CMFCToolBar::CanHandleSiblings`](#canhandlesiblings)|Determines whether the toolbar and its sibling are positioned on the same pane.| |[`CMFCToolBar::CommandToIndex`](#commandtoindex)|Returns the index of the button in the toolbar with a specified command ID.| |[`CMFCToolBar::Create`](#create)|Creates a `CMFCToolBar` object.| |[`CMFCToolBar::CreateEx`](#createex)|Creates a `CMFCToolBar` object that uses additional style options, such as large icons.| diff --git a/docs/mfc/reference/cpane-class.md b/docs/mfc/reference/cpane-class.md index 9611f4835af..6e1a4609bcf 100644 --- a/docs/mfc/reference/cpane-class.md +++ b/docs/mfc/reference/cpane-class.md @@ -75,7 +75,6 @@ class CPane : public CBasePane |[CPane::OnPressCloseButton](#onpressclosebutton)|Called by the framework when the user chooses the Close button on the caption for the pane.| |`CPane::OnProcessDblClk`|Used internally.| |[CPane::OnShowControlBarMenu](#onshowcontrolbarmenu)|Called by the framework when a special pane menu is about to be displayed.| -|[CPane::OnShowControlBarMenu](#onshowcontrolbarmenu)|Called by the framework when a special pane menu is about to be displayed.| |`CPane::PrepareToDock`|Used internally.| |[CPane::RecalcLayout](#recalclayout)|Recalculates layout information for the pane. (Overrides [CBasePane::RecalcLayout](../../mfc/reference/cbasepane-class.md#recalclayout).)| |[CPane::SaveState](#savestate)|Saves the state of the pane to the registry. (Overrides [CBasePane::SaveState](../../mfc/reference/cbasepane-class.md#savestate).)| From f4cab0c1a6e6f5029b6fdb6baecb2e54a47de31e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 18:18:53 +0800 Subject: [PATCH 0411/1799] Update metadata in 2 topics --- docs/c-runtime-library/routine-mappings.md | 4 ++-- docs/mfc/reference/cpane-class.md | 5 ++--- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/c-runtime-library/routine-mappings.md b/docs/c-runtime-library/routine-mappings.md index a19cd5a3567..8c75157b5c5 100644 --- a/docs/c-runtime-library/routine-mappings.md +++ b/docs/c-runtime-library/routine-mappings.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Microsoft specific generic-text functions and the CRT functions they map to." title: "Generic-text function mappings" -ms.date: "11/04/2016" +description: "Learn more about: Microsoft specific generic-text functions and the CRT functions they map to." +ms.date: 11/04/2016 ms.author: twhitney api_name: ["foo",] f1_keywords: ["_cgetts", "_cgetts_s", "_cputts", "_fgettc", "_fgettchar", "_fgetts", "_fputtc", "_fputtchar", "_fputts", "_ftscanf", "_ftscanf_s", "_gettc", "_gettch", "_gettchar", "_gettche", "_getts", "_getts_s", "_istalnum", "_istalpha", "_istascii", "_istcntrl", "_istdigit", "_istgraph", "_istlead", "_istleadbyte", "_istlegal", "_istlower", "_istprint", "_istpunct", "_istspace", "_istupper", "_istxdigit", "_itot", "_itot_s", "_ltot", "_ltot_s", "_puttc", "_puttch", "_puttchar", "_putts", "_sctprintf", "_sntprintf", "_sntprintf_s", "_sntscanf", "_sntscanf_s", "_stprintf", "_stprintf_s", "_stscanf", "_stscanf_s", "_taccess", "_tasctime", "_tasctime_s", "_tccmp", "_tccpy", "_tccpy_s", "_tchdir", "_tclen", "_tchmod", "_tcprintf", "_tcprintf_s", "_tcreat", "_tcscanf", "_tcscanf_s", "_tcscat", "_tcscat_s", "_tcschr", "_tcsclen", "_tcsclen_s", "_tcscmp", "_tcscoll", "_tcscpy", "_tcscpy_s", "_tcscspn", "_tcsdec", "_tcsdup", "_tcserror", "_tcserror_s", "_tcsftime", "_tcsicmp", "_tcsicoll", "_tcsinc", "_tcslen", "_tcslwr", "_tcslwr_s", "_tcsnbcnt", "_tcsncat", "_tcsncat_s", "_tcsnccat", "_tcsnccmp", "_tcsnccmp_s", "_tcsnccoll", "_tcsncmp", "_tcsnccnt", "_tcsnccpy", "_tcsncicmp", "_tcsncicoll", "_tcsncpy", "_tcsncset", "_tcsnextc", "_tcsnicmp", "_tcsnicoll", "_tcsninc", "_tcsnccnt", "_tcsnset", "_tcspbrk", "_tcsspnp", "_tcsrchr", "_tcsrev", "_tcsset", "_tcsspn", "_tcsstr", "_tcstod", "_tcstoi64", "_tcstok", "_tcstok_s", "_tcstol", "_tcstoui64", "_tcstoul", "_tcsupr", "_tcsupr_s", "_tcsxfrm", "_tctime", "_tctime_s", "_tctime32", "_tctime32_s", "_tctime64", "_tctime64_s", "_texecl", "_texecle", "_texeclp", "_texeclpe", "_texecv", "_texecve", "_texecvp", "_texecvpe", "_tfdopen", "_tfindfirst", "_tfindnext", "_tfindnext32", "_tfindnext64", "_tfindnexti64", "_tfindnexti6432", "_tfindnext32i64", "_tfopen", "_tfopen_s", "_tfreopen", "_tfreopen_s", "_tfsopen", "_tfullpath", "_tgetcwd", "_tgetdcwd", "_tgetenv", "_tgetenv_s", "_tmain", "_tmakepath", "_tmakepath_s", "_tmkdir", "_tmktemp", "_tmktemp_s", "_topen", "_topen_s", "_totlower", "_totupper", "_tperror", "_tpopen", "_tprintf", "_tprintf_s", "_tputenv", "_tremove", "_trename", "_trmdir", "_tsearchenv", "_tsearchenv_s", "_tscanf", "_tscanf_s", "_tsetlocale", "_tsopen", "_tsopen_s", "_tspawnl", "_tspawnle", "_tspawnlp", "_tspawnlpe", "_tspawnv", "_tspawnve", "_tspawnvp", "_tspawnvpe", "_tsplitpath", "_tstat", "_tstat32", "_tstati32", "_tstat64", "_tstati64", "_tstof", "_tstoi", "_tstoi64", "_tstol", "_tstrdate", "_tstrdate_s", "_tstrtime", "_tstrtime_s", "_tsystem", "_ttempnam", "_ttmpnam", "_ttmpnam_s", "_ttoi", "_ttoi64", "_ttol", "_tunlink", "_tutime", "_tutime32", "_tutime64", "_tWinMain", "_ui64tot", "_ui64tot_s", "_ultot", "_ultot_s", "_ungettc", "_ungettch", "_vftprintf", "_vftprintf_s", "_vsctprintf", "_vsctprintf_s", "_vsntprintf", "_vsntprintf_s", "_vstprintf", "_vtprintf", "_vtprintf_s"] diff --git a/docs/mfc/reference/cpane-class.md b/docs/mfc/reference/cpane-class.md index 6e1a4609bcf..72daa26442a 100644 --- a/docs/mfc/reference/cpane-class.md +++ b/docs/mfc/reference/cpane-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CPane Class" title: "CPane Class" -ms.date: "11/04/2016" +description: "Learn more about: CPane Class" +ms.date: 11/04/2016 f1_keywords: ["CPane", "AFXPANE/CPane", "AFXPANE/CPane::AdjustSizeImmediate", "AFXPANE/CPane::AllocElements", "AFXPANE/CPane::AllowShowOnPaneMenu", "AFXPANE/CPane::CalcAvailableSize", "AFXPANE/CPane::CalcInsideRect", "AFXPANE/CPane::CalcRecentDockedRect", "AFXPANE/CPane::CalcSize", "AFXPANE/CPane::CanBeDocked", "AFXPANE/CPane::CanBeTabbedDocument", "AFXPANE/CPane::ConvertToTabbedDocument", "AFXPANE/CPane::CopyState", "AFXPANE/CPane::Create", "AFXPANE/CPane::CreateDefaultMiniframe", "AFXPANE/CPane::CreateEx", "AFXPANE/CPane::DockByMouse", "AFXPANE/CPane::DockPane", "AFXPANE/CPane::DockPaneStandard", "AFXPANE/CPane::DockToFrameWindow", "AFXPANE/CPane::DoesAllowSiblingBars", "AFXPANE/CPane::FloatPane", "AFXPANE/CPane::GetAvailableExpandSize", "AFXPANE/CPane::GetAvailableStretchSize", "AFXPANE/CPane::GetBorders", "AFXPANE/CPane::GetClientHotSpot", "AFXPANE/CPane::GetDockSiteRow", "AFXPANE/CPane::GetExclusiveRowMode", "AFXPANE/CPane::GetHotSpot", "AFXPANE/CPane::GetMinSize", "AFXPANE/CPane::GetPaneName", "AFXPANE/CPane::GetVirtualRect", "AFXPANE/CPane::IsChangeState", "AFXPANE/CPane::IsDragMode", "AFXPANE/CPane::IsInFloatingMultiPaneFrameWnd", "AFXPANE/CPane::IsLeftOf", "AFXPANE/CPane::IsResizable", "AFXPANE/CPane::IsTabbed", "AFXPANE/CPane::LoadState", "AFXPANE/CPane::MoveByAlignment", "AFXPANE/CPane::MovePane", "AFXPANE/CPane::OnAfterChangeParent", "AFXPANE/CPane::OnBeforeChangeParent", "AFXPANE/CPane::OnPressCloseButton", "AFXPANE/CPane::OnShowControlBarMenu", "AFXPANE/CPane::RecalcLayout", "AFXPANE/CPane::SaveState", "AFXPANE/CPane::SetActiveInGroup", "AFXPANE/CPane::SetBorders", "AFXPANE/CPane::SetClientHotSpot", "AFXPANE/CPane::SetDockState", "AFXPANE/CPane::SetExclusiveRowMode", "AFXPANE/CPane::SetMiniFrameRTC", "AFXPANE/CPane::SetMinSize", "AFXPANE/CPane::SetVirtualRect", "AFXPANE/CPane::StretchPaneDeferWndPos", "AFXPANE/CPane::ToggleAutoHide", "AFXPANE/CPane::UndockPane", "AFXPANE/CPane::UpdateVirtualRect", "AFXPANE/CPane::OnAfterDock", "AFXPANE/CPane::OnAfterFloat", "AFXPANE/CPane::OnBeforeDock", "AFXPANE/CPane::OnBeforeFloat", "AFXPANE/CPane::m_bHandleMinSize", "AFXPANE/CPane::m_recentDockInfo"] helpviewer_keywords: ["CPane [MFC], AdjustSizeImmediate", "CPane [MFC], AllocElements", "CPane [MFC], AllowShowOnPaneMenu", "CPane [MFC], CalcAvailableSize", "CPane [MFC], CalcInsideRect", "CPane [MFC], CalcRecentDockedRect", "CPane [MFC], CalcSize", "CPane [MFC], CanBeDocked", "CPane [MFC], CanBeTabbedDocument", "CPane [MFC], ConvertToTabbedDocument", "CPane [MFC], CopyState", "CPane [MFC], Create", "CPane [MFC], CreateDefaultMiniframe", "CPane [MFC], CreateEx", "CPane [MFC], DockByMouse", "CPane [MFC], DockPane", "CPane [MFC], DockPaneStandard", "CPane [MFC], DockToFrameWindow", "CPane [MFC], DoesAllowSiblingBars", "CPane [MFC], FloatPane", "CPane [MFC], GetAvailableExpandSize", "CPane [MFC], GetAvailableStretchSize", "CPane [MFC], GetBorders", "CPane [MFC], GetClientHotSpot", "CPane [MFC], GetDockSiteRow", "CPane [MFC], GetExclusiveRowMode", "CPane [MFC], GetHotSpot", "CPane [MFC], GetMinSize", "CPane [MFC], GetPaneName", "CPane [MFC], GetVirtualRect", "CPane [MFC], IsChangeState", "CPane [MFC], IsDragMode", "CPane [MFC], IsInFloatingMultiPaneFrameWnd", "CPane [MFC], IsLeftOf", "CPane [MFC], IsResizable", "CPane [MFC], IsTabbed", "CPane [MFC], LoadState", "CPane [MFC], MoveByAlignment", "CPane [MFC], MovePane", "CPane [MFC], OnAfterChangeParent", "CPane [MFC], OnBeforeChangeParent", "CPane [MFC], OnPressCloseButton", "CPane [MFC], OnShowControlBarMenu", "CPane [MFC], OnShowControlBarMenu", "CPane [MFC], RecalcLayout", "CPane [MFC], SaveState", "CPane [MFC], SetActiveInGroup", "CPane [MFC], SetBorders", "CPane [MFC], SetClientHotSpot", "CPane [MFC], SetDockState", "CPane [MFC], SetExclusiveRowMode", "CPane [MFC], SetMiniFrameRTC", "CPane [MFC], SetMinSize", "CPane [MFC], SetVirtualRect", "CPane [MFC], StretchPaneDeferWndPos", "CPane [MFC], ToggleAutoHide", "CPane [MFC], UndockPane", "CPane [MFC], UpdateVirtualRect", "CPane [MFC], OnAfterDock", "CPane [MFC], OnAfterFloat", "CPane [MFC], OnBeforeDock", "CPane [MFC], OnBeforeFloat", "CPane [MFC], m_bHandleMinSize", "CPane [MFC], m_recentDockInfo"] -ms.assetid: 5c651a64-3c79-4d94-9676-45f6402a6bc5 --- # CPane Class From c7f5964231b944a325680f3d278f1c4f6acd206b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 18:45:50 +0800 Subject: [PATCH 0412/1799] Convert NMAKE errors and warnings list into a table --- .../nmake-errors-u1000-through-u4011.md | 78 ++++++++++--------- 1 file changed, 41 insertions(+), 37 deletions(-) diff --git a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md index 6b68d4ece1f..3ec366c0144 100644 --- a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md +++ b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md @@ -13,46 +13,50 @@ This section is a reference to the errors and warnings generated by the NMAKE bu ## NMAKE fatal errors -[NMAKE fatal error U1000](nmake-fatal-error-u1000.md) \ -[NMAKE fatal error U1001](nmake-fatal-error-u1001.md) \ -[NMAKE fatal error U1007](nmake-fatal-error-u1007.md) \ -[NMAKE fatal error U1023](nmake-fatal-error-u1023.md) \ -[NMAKE fatal error U1033](nmake-fatal-error-u1033.md) \ -[NMAKE fatal error U1034](nmake-fatal-error-u1034.md) \ -[NMAKE fatal error U1035](nmake-fatal-error-u1035.md) \ -[NMAKE fatal error U1036](nmake-fatal-error-u1036.md) \ -[NMAKE fatal error U1045](nmake-fatal-error-u1045.md) \ -[NMAKE fatal error U1050](nmake-fatal-error-u1050.md) \ -[NMAKE fatal error U1051](nmake-fatal-error-u1051.md) \ -[NMAKE fatal error U1052](nmake-fatal-error-u1052.md) \ -[NMAKE fatal error U1055](nmake-fatal-error-u1055.md) \ -[NMAKE fatal error U1056](nmake-fatal-error-u1056.md) \ -[NMAKE fatal error U1059](nmake-fatal-error-u1059.md) \ -[NMAKE fatal error U1064](nmake-fatal-error-u1064.md) \ -[NMAKE fatal error U1065](nmake-fatal-error-u1065.md) \ -[NMAKE fatal error U1070](nmake-fatal-error-u1070.md) \ -[NMAKE fatal error U1071](nmake-fatal-error-u1071.md) \ -[NMAKE fatal error U1073](nmake-fatal-error-u1073.md) \ -[NMAKE fatal error U1076](nmake-fatal-error-u1076.md) \ -[NMAKE fatal error U1077](nmake-fatal-error-u1077.md) \ -[NMAKE fatal error U1078](nmake-fatal-error-u1078.md) \ -[NMAKE fatal error U1083](nmake-fatal-error-u1083.md) \ -[NMAKE fatal error U1086](nmake-fatal-error-u1086.md) \ -[NMAKE fatal error U1087](nmake-fatal-error-u1087.md) \ -[NMAKE fatal error U1088](nmake-fatal-error-u1088.md) \ -[NMAKE fatal error U1095](nmake-fatal-error-u1095.md) \ -[NMAKE fatal error U1097](nmake-fatal-error-u1097.md) \ -[NMAKE fatal error U1099](nmake-fatal-error-u1099.md) \ -[NMAKE fatal error U1100](nmake-fatal-error-u1100.md) +| Error | Message | +|--|--| +| [NMAKE fatal error U1000](nmake-fatal-error-u1000.md) | syntax error : ')' missing in macro invocation | +| [NMAKE fatal error U1001](nmake-fatal-error-u1001.md) | syntax error : illegal character 'character' in macro | +| [NMAKE fatal error U1007](nmake-fatal-error-u1007.md) | double quotation mark not allowed in name | +| [NMAKE fatal error U1023](nmake-fatal-error-u1023.md) | syntax error in expression | +| [NMAKE fatal error U1033](nmake-fatal-error-u1033.md) | syntax error : 'string' unexpected | +| [NMAKE fatal error U1034](nmake-fatal-error-u1034.md) | syntax error : separator missing | +| [NMAKE fatal error U1035](nmake-fatal-error-u1035.md) | syntax error : expected ':' or '=' separator | +| [NMAKE fatal error U1036](nmake-fatal-error-u1036.md) | syntax error : too many names to left of '=' | +| [NMAKE fatal error U1045](nmake-fatal-error-u1045.md) | spawn failed : *message* | +| [NMAKE fatal error U1050](nmake-fatal-error-u1050.md) | *message* | +| [NMAKE fatal error U1051](nmake-fatal-error-u1051.md) | out of memory | +| [NMAKE fatal error U1052](nmake-fatal-error-u1052.md) | file '*filename*' not found | +| [NMAKE fatal error U1055](nmake-fatal-error-u1055.md) | out of environment space | +| [NMAKE fatal error U1056](nmake-fatal-error-u1056.md) | cannot find command processor | +| [NMAKE fatal error U1059](nmake-fatal-error-u1059.md) | syntax error : '}' missing in dependent | +| [NMAKE fatal error U1064](nmake-fatal-error-u1064.md) | MAKEFILE not found and no target specified | +| [NMAKE fatal error U1065](nmake-fatal-error-u1065.md) | invalid option 'option' | +| [NMAKE fatal error U1070](nmake-fatal-error-u1070.md) | cycle in macro definition 'macroname' | +| [NMAKE fatal error U1071](nmake-fatal-error-u1071.md) | cycle in dependency tree for target 'targetname' | +| [NMAKE fatal error U1073](nmake-fatal-error-u1073.md) | don't know how to make 'targetname' | +| [NMAKE fatal error U1076](nmake-fatal-error-u1076.md) | name too long | +| [NMAKE fatal error U1077](nmake-fatal-error-u1077.md) | 'program' : return code 'value' | +| [NMAKE fatal error U1078](nmake-fatal-error-u1078.md) | constant overflow at 'expression' | +| [NMAKE fatal error U1083](nmake-fatal-error-u1083.md) | target macro 'target' expands to nothing | +| [NMAKE fatal error U1086](nmake-fatal-error-u1086.md) | inference rule cannot have dependents | +| [NMAKE fatal error U1087](nmake-fatal-error-u1087.md) | cannot have : and :: dependents for same target | +| [NMAKE fatal error U1088](nmake-fatal-error-u1088.md) | invalid separator '::' on inference rule | +| [NMAKE fatal error U1095](nmake-fatal-error-u1095.md) | expanded command line 'commandline' too long | +| [NMAKE fatal error U1097](nmake-fatal-error-u1097.md) | filename-parts syntax requires dependent | +| [NMAKE fatal error U1099](nmake-fatal-error-u1099.md) | stack overflow | +| [NMAKE fatal error U1100](nmake-fatal-error-u1100.md) | macro '*macro-name*' is illegal in the context of batch rule '*rule-name*' | ## NMAKE warnings -[NMAKE warning U4001](nmake-warning-u4001.md) \ -[NMAKE warning U4004](nmake-warning-u4004.md) \ -[NMAKE warning U4006](nmake-warning-u4006.md) \ -[NMAKE warning U4007](nmake-warning-u4007.md) \ -[NMAKE warning U4010](nmake-warning-u4010.md) \ -[NMAKE warning U4011](nmake-warning-u4011.md) +| Warning | Message | +|--|--| +| [NMAKE warning U4001](nmake-warning-u4001.md) | command file can be invoked only from command line | +| [NMAKE warning U4004](nmake-warning-u4004.md) | too many rules for target 'targetname' | +| [NMAKE warning U4006](nmake-warning-u4006.md) | special macro undefined : 'macroname' | +| [NMAKE warning U4007](nmake-warning-u4007.md) | filename 'filename' too long; truncating to 8.3 | +| [NMAKE warning U4010](nmake-warning-u4010.md) | 'target' : build failed; /K specified, continuing ... | +| [NMAKE warning U4011](nmake-warning-u4011.md) | 'target' : not all dependents available; target not built | ## See also From d4e04cc9e4b91703564cb88f0eae700385f5f2af Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 18:47:34 +0800 Subject: [PATCH 0413/1799] Simplify superfluous relative links in "NMAKE errors and warnings (Uxxxx)" --- .../tool-errors/nmake-errors-u1000-through-u4011.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md index 3ec366c0144..2c65ef17c46 100644 --- a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md +++ b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md @@ -9,7 +9,7 @@ ms.assetid: 9dbe2e12-88ca-4df4-b935-17756112bb79 This section is a reference to the errors and warnings generated by the NMAKE build tool. NMAKE errors and warnings have the form U*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## NMAKE fatal errors From 8623b1f6d5b355f50240ad7040a5ae9948b24c5f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 18:48:02 +0800 Subject: [PATCH 0414/1799] Remove space before escape in "NMAKE errors and warnings (Uxxxx)" --- .../tool-errors/nmake-errors-u1000-through-u4011.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md index 2c65ef17c46..237546c7b6a 100644 --- a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md +++ b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md @@ -60,5 +60,5 @@ This section is a reference to the errors and warnings generated by the NMAKE bu ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [NMAKE reference](../../build/reference/nmake-reference.md) From 7c30d23b49d66084e29a654605a2046c360bc3e0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 18:48:42 +0800 Subject: [PATCH 0415/1799] Update metadata in "NMAKE errors and warnings (Uxxxx)" --- .../tool-errors/nmake-errors-u1000-through-u4011.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md index 237546c7b6a..f0d916c427b 100644 --- a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md +++ b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: NMAKE errors and warnings (Uxxxx)" title: "NMAKE errors and warnings" -ms.date: "04/16/2019" +description: "Learn more about: NMAKE errors and warnings (Uxxxx)" +ms.date: 04/16/2019 f1_keywords: ["nmake"] -ms.assetid: 9dbe2e12-88ca-4df4-b935-17756112bb79 --- # NMAKE errors and warnings (Uxxxx) From 3fe826fad144c9f1e268e66db3c8b13d97a0299e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 23:08:43 +0800 Subject: [PATCH 0416/1799] Add blockquotes for error messages in range [C2141, C2160] --- docs/error-messages/compiler-errors-1/compiler-error-c2141.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2142.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2143.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2145.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2146.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2147.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2148.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2149.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2151.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2152.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2153.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2154.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2155.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2156.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2157.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2158.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2159.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2160.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md index 056b2983499..721879f36a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md @@ -8,7 +8,7 @@ ms.assetid: 10cf770f-0500-4220-ac90-a863b7ea5fe6 --- # Compiler Error C2141 -array size overflow +> array size overflow An array exceeds the 2GB limit. Reduce the size of the array. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md index 1920a389631..b3430a69a20 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md @@ -8,7 +8,7 @@ ms.assetid: d0dbe10e-0952-49a4-8b33-e82fb7558b19 --- # Compiler Error C2142 -function declarations differ, variable parameters specified only in one of them +> function declarations differ, variable parameters specified only in one of them One declaration of the function contains a variable parameter list. Another declaration does not. ANSI C ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) only. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2143.md b/docs/error-messages/compiler-errors-1/compiler-error-c2143.md index 66f9011fb60..52cbbb59eab 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2143.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2143.md @@ -8,7 +8,7 @@ ms.assetid: 1d8d1456-e031-4965-9240-09a6e33ba81c --- # Compiler Error C2143 -syntax error : missing 'token1' before 'token2' +> syntax error : missing 'token1' before 'token2' The compiler expected a specific token (that is, a language element other than white space) and found another token instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2145.md b/docs/error-messages/compiler-errors-1/compiler-error-c2145.md index d38fac35d8b..87627cf85d6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2145.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2145.md @@ -8,7 +8,7 @@ ms.assetid: 158e5809-8adb-4195-8ca5-684501defbc8 --- # Compiler Error C2145 -syntax error : missing 'token' before identifier +> syntax error : missing 'token' before identifier The compiler expected `token` and found identifier instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md index 083cfd7db76..184ceb8e382 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md @@ -8,7 +8,7 @@ ms.assetid: 6bfb7de6-6723-4486-9350-c66ef88d7a64 --- # Compiler Error C2146 -syntax error : missing 'token' before identifier 'identifier' +> syntax error : missing 'token' before identifier 'identifier' The compiler expected `token` and found `identifier` instead. Possible causes: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md index 363bd1c2862..50cc42c1a1c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md @@ -8,7 +8,7 @@ ms.assetid: d1adb3bf-7ece-4815-922c-ad7492fb6670 --- # Compiler Error C2147 -syntax error : 'identifier' is a new keyword +> syntax error : 'identifier' is a new keyword An identifier was used that is now a reserved keyword in the language. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md index f2a12bc67bb..da2b94d3c16 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md @@ -8,7 +8,7 @@ ms.assetid: e510c2c9-7b57-4ce8-be03-ba363e2cc5d9 --- # Compiler Error C2148 -total size of array must not exceed 0x7fffffff bytes +> total size of array must not exceed 0x7fffffff bytes An array exceeds the limit. Reduce the size of the array. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md index 5eede2573b2..393f9959582 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md @@ -8,7 +8,7 @@ ms.assetid: 7a106dab-d79f-41b9-85be-f36e86e4d2ab --- # Compiler Error C2149 -'identifier' : named bit field cannot have zero width +> 'identifier' : named bit field cannot have zero width Bit fields can have zero width only if unnamed. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2151.md b/docs/error-messages/compiler-errors-1/compiler-error-c2151.md index 9fffa41bf1f..52005946ac0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2151.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2151.md @@ -8,6 +8,6 @@ ms.assetid: 7f8dd83a-1f41-46d8-8778-0d1f79ed36c9 --- # Compiler Error C2151 -more than one language attribute +> more than one language attribute A function has more than one keyword ( **`__cdecl`**, **`__stdcall`**, or **`__fastcall`**) specifying a calling convention. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2152.md b/docs/error-messages/compiler-errors-1/compiler-error-c2152.md index 40c3988ecfd..e6ac67fc6ca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2152.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2152.md @@ -8,6 +8,6 @@ ms.assetid: a9ea2b0c-d55d-41c7-ba9f-dd75592ffc8a --- # Compiler Error C2152 -'identifier' : pointers to functions with different attributes +> 'identifier' : pointers to functions with different attributes A pointer to a function with one calling convention (**`__cdecl`**, **`__stdcall`**, or **`__fastcall`**) is assigned to a pointer to a function with another calling convention. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md index 2090da157a4..561ea17239b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2153"] --- # Compiler Error C2153 -integer literals must have at least one digit +> integer literals must have at least one digit Hexadecimal and binary literals must contain at least one digit after the leading sequence (`0x`, `0X`, `0b`, or `0B`), otherwise the trailing character may be incorrectly interpreted as a suffix or literal operator. See [Integer literals](../../cpp/numeric-boolean-and-pointer-literals-cpp.md#integer-literals) for more information. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md index a60157128dc..add7ed02692 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md @@ -8,7 +8,7 @@ ms.assetid: 98d6b044-5a3a-43ad-95fa-9b916b22468a --- # Compiler Error C2154 -'type' : only enumeration type is allowed as an argument to compiler intrinsic type trait '__underlying_type' +> 'type' : only enumeration type is allowed as an argument to compiler intrinsic type trait '__underlying_type' You can only get the underlying type of an enumeration type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2155.md b/docs/error-messages/compiler-errors-1/compiler-error-c2155.md index d65e37535c5..6b55e3c87d0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2155.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2155.md @@ -8,6 +8,6 @@ ms.assetid: 54d408af-fc48-4121-9011-5e75c7072e01 --- # Compiler Error C2155 -'?' : invalid left operand, expected arithmetic or pointer type +> '?' : invalid left operand, expected arithmetic or pointer type An expression on the left hand side of `?` cannot be compared to zero. You must use an arithmetic or pointer expression that can be compared to zero. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md index 3f26c7e32e0..d2ddab0f0db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md @@ -8,7 +8,7 @@ ms.assetid: 136f9c67-2c27-4f61-b7e6-ccd202eca697 --- # Compiler Error C2156 -pragma must be outside function +> pragma must be outside function A pragma that must be specified at a global level (outside a function body) is within a function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md index 5128e4a1b95..3f3fab5b9ae 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md @@ -8,7 +8,7 @@ ms.assetid: babbca24-16dc-4b69-be14-a675029249c1 --- # Compiler Error C2157 -'function' : must be declared before use in pragma list +> 'function' : must be declared before use in pragma list The function name is not declared before being referenced in the list of functions for an [alloc_text](../../preprocessor/alloc-text.md) pragma. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md index 9701f65a703..f3d214f0f1d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md @@ -8,7 +8,7 @@ ms.assetid: 39028899-e95c-4809-8e65-6111118641ee --- # Compiler Error C2158 -'type' : #pragma make_public directive is currently supported for native non-template types only +> 'type' : #pragma make_public directive is currently supported for native non-template types only The [make_public](../../preprocessor/make-public.md) pragma can only be applied to a native, non-template type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md index 70073ebc69e..d3926b7dacc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md @@ -8,7 +8,7 @@ ms.assetid: 925a2cbd-43c9-45ee-a373-84004350b380 --- # Compiler Error C2159 -more than one storage class specified +> more than one storage class specified A declaration contains more than one storage class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md index 6353f84bba8..1fd6bab2d0f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md @@ -8,7 +8,7 @@ ms.assetid: a1f694a7-fb16-4437-b7f5-a1af6da94bc5 --- # Compiler Error C2160 -'##' cannot occur at the beginning of a macro definition +> '##' cannot occur at the beginning of a macro definition A macro definition began with a token-pasting operator (##). From 06a01ad09b5fbf124bf9d33811a0cd83f35f0ccf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 23:12:56 +0800 Subject: [PATCH 0417/1799] Add "Remarks" and "Example" headings for error references in range [C2141, C2160] --- docs/error-messages/compiler-errors-1/compiler-error-c2141.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2142.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2143.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2144.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2145.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2146.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2147.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2148.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2149.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2150.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2151.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2152.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2153.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2154.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2155.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2156.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2157.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2158.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2159.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2160.md | 4 ++++ 20 files changed, 58 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md index 721879f36a4..52e9dd2448e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md @@ -10,6 +10,8 @@ ms.assetid: 10cf770f-0500-4220-ac90-a863b7ea5fe6 > array size overflow +## Remarks + An array exceeds the 2GB limit. Reduce the size of the array. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md index b3430a69a20..3f6949e2281 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md @@ -10,8 +10,12 @@ ms.assetid: d0dbe10e-0952-49a4-8b33-e82fb7558b19 > function declarations differ, variable parameters specified only in one of them +## Remarks + One declaration of the function contains a variable parameter list. Another declaration does not. ANSI C ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) only. +## Example + The following sample generates C2142: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2143.md b/docs/error-messages/compiler-errors-1/compiler-error-c2143.md index 52cbbb59eab..750a7b07d8f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2143.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2143.md @@ -10,12 +10,16 @@ ms.assetid: 1d8d1456-e031-4965-9240-09a6e33ba81c > syntax error : missing 'token1' before 'token2' +## Remarks + The compiler expected a specific token (that is, a language element other than white space) and found another token instead. Check the [C++ Language Reference](../../cpp/cpp-language-reference.md) to determine where code is syntactically incorrect. Because the compiler may report this error after it encounters the line that causes the problem, check several lines of code that precede the error. C2143 can occur in different situations. +## Examples + It can occur when an operator that can qualify a name (`::`, `->`, and `.`) must be followed by the keyword **`template`**, as in this example: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2144.md b/docs/error-messages/compiler-errors-1/compiler-error-c2144.md index b421b7b1e78..78a2a5536c8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2144.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2144.md @@ -10,6 +10,8 @@ ms.assetid: 49f3959b-324f-4c06-9588-c0ecef5dc5b3 > syntax error : '*type*' should be preceded by '*token*' +## Remarks + The compiler expected *token* and found *type* instead. This error may be caused by a missing closing brace, right parenthesis, or semicolon. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2145.md b/docs/error-messages/compiler-errors-1/compiler-error-c2145.md index 87627cf85d6..bd21fc25326 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2145.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2145.md @@ -10,6 +10,8 @@ ms.assetid: 158e5809-8adb-4195-8ca5-684501defbc8 > syntax error : missing 'token' before identifier +## Remarks + The compiler expected `token` and found identifier instead. This error may be caused by a missing semicolon after the last declaration in a block. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md index 184ceb8e382..23161ba2e9e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md @@ -10,6 +10,8 @@ ms.assetid: 6bfb7de6-6723-4486-9350-c66ef88d7a64 > syntax error : missing 'token' before identifier 'identifier' +## Remarks + The compiler expected `token` and found `identifier` instead. Possible causes: 1. Spelling or capitalization error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md index 50cc42c1a1c..7a476e6d3ba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md @@ -10,8 +10,12 @@ ms.assetid: d1adb3bf-7ece-4815-922c-ad7492fb6670 > syntax error : 'identifier' is a new keyword +## Remarks + An identifier was used that is now a reserved keyword in the language. +## Example + The following sample generates C2147: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md index da2b94d3c16..16028fd4f54 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md @@ -10,6 +10,8 @@ ms.assetid: e510c2c9-7b57-4ce8-be03-ba363e2cc5d9 > total size of array must not exceed 0x7fffffff bytes +## Remarks + An array exceeds the limit. Reduce the size of the array. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md index 393f9959582..1a35e5fd1e4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md @@ -10,8 +10,12 @@ ms.assetid: 7a106dab-d79f-41b9-85be-f36e86e4d2ab > 'identifier' : named bit field cannot have zero width +## Remarks + Bit fields can have zero width only if unnamed. +## Example + The following sample generates C2149: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2150.md b/docs/error-messages/compiler-errors-1/compiler-error-c2150.md index 3fc67eca0f4..e2c64d9b239 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2150.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2150.md @@ -10,6 +10,8 @@ ms.assetid: 21e82a10-c1d4-4c0d-9dc6-c5d92ea42a31 > '*identifier*' : bit field must have type 'int', 'signed int', or 'unsigned int' +## Remarks + The base type for a bit-field is required to be **`int`**, **`signed int`**, or **`unsigned int`**. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2151.md b/docs/error-messages/compiler-errors-1/compiler-error-c2151.md index 52005946ac0..71ac6bdb308 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2151.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2151.md @@ -10,4 +10,6 @@ ms.assetid: 7f8dd83a-1f41-46d8-8778-0d1f79ed36c9 > more than one language attribute +## Remarks + A function has more than one keyword ( **`__cdecl`**, **`__stdcall`**, or **`__fastcall`**) specifying a calling convention. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2152.md b/docs/error-messages/compiler-errors-1/compiler-error-c2152.md index e6ac67fc6ca..527f9f69a07 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2152.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2152.md @@ -10,4 +10,6 @@ ms.assetid: a9ea2b0c-d55d-41c7-ba9f-dd75592ffc8a > 'identifier' : pointers to functions with different attributes +## Remarks + A pointer to a function with one calling convention (**`__cdecl`**, **`__stdcall`**, or **`__fastcall`**) is assigned to a pointer to a function with another calling convention. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md index 561ea17239b..12594a50a85 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2153"] > integer literals must have at least one digit +## Remarks + Hexadecimal and binary literals must contain at least one digit after the leading sequence (`0x`, `0X`, `0b`, or `0B`), otherwise the trailing character may be incorrectly interpreted as a suffix or literal operator. See [Integer literals](../../cpp/numeric-boolean-and-pointer-literals-cpp.md#integer-literals) for more information. +## Example + The following sample generates C2153: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md index add7ed02692..c42c3c4ec8f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md @@ -10,6 +10,8 @@ ms.assetid: 98d6b044-5a3a-43ad-95fa-9b916b22468a > 'type' : only enumeration type is allowed as an argument to compiler intrinsic type trait '__underlying_type' +## Remarks + You can only get the underlying type of an enumeration type. For more information, see [Compiler Support for Type Traits](../../extensions/compiler-support-for-type-traits-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2155.md b/docs/error-messages/compiler-errors-1/compiler-error-c2155.md index 6b55e3c87d0..9beb9cb8671 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2155.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2155.md @@ -10,4 +10,6 @@ ms.assetid: 54d408af-fc48-4121-9011-5e75c7072e01 > '?' : invalid left operand, expected arithmetic or pointer type +## Remarks + An expression on the left hand side of `?` cannot be compared to zero. You must use an arithmetic or pointer expression that can be compared to zero. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md index d2ddab0f0db..5cc7ebb4452 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md @@ -10,8 +10,12 @@ ms.assetid: 136f9c67-2c27-4f61-b7e6-ccd202eca697 > pragma must be outside function +## Remarks + A pragma that must be specified at a global level (outside a function body) is within a function. +## Example + The following sample generates C2156: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md index 3f3fab5b9ae..9cd18f3855c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md @@ -10,8 +10,12 @@ ms.assetid: babbca24-16dc-4b69-be14-a675029249c1 > 'function' : must be declared before use in pragma list +## Remarks + The function name is not declared before being referenced in the list of functions for an [alloc_text](../../preprocessor/alloc-text.md) pragma. +## Example + The following sample generates C2157: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md index f3d214f0f1d..705ee912777 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md @@ -10,6 +10,8 @@ ms.assetid: 39028899-e95c-4809-8e65-6111118641ee > 'type' : #pragma make_public directive is currently supported for native non-template types only +## Remarks + The [make_public](../../preprocessor/make-public.md) pragma can only be applied to a native, non-template type. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md index d3926b7dacc..656e22fc096 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md @@ -10,8 +10,12 @@ ms.assetid: 925a2cbd-43c9-45ee-a373-84004350b380 > more than one storage class specified +## Remarks + A declaration contains more than one storage class. +## Example + The following sample generates C2159: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md index 1fd6bab2d0f..b8360877ccc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md @@ -10,8 +10,12 @@ ms.assetid: a1f694a7-fb16-4437-b7f5-a1af6da94bc5 > '##' cannot occur at the beginning of a macro definition +## Remarks + A macro definition began with a token-pasting operator (##). +## Example + The following sample generates C2160: ```cpp From 837a8f998b53ff37fe8982d13a70bc1a0c1442c4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 23:14:35 +0800 Subject: [PATCH 0418/1799] Replace term "sample" with "example" for error references in range [C2141, C2160] --- .../compiler-errors-1/compiler-error-c2141.md | 2 +- .../compiler-errors-1/compiler-error-c2142.md | 2 +- .../compiler-errors-1/compiler-error-c2144.md | 4 ++-- .../compiler-errors-1/compiler-error-c2146.md | 6 +++--- .../compiler-errors-1/compiler-error-c2147.md | 2 +- .../compiler-errors-1/compiler-error-c2148.md | 2 +- .../compiler-errors-1/compiler-error-c2149.md | 2 +- .../compiler-errors-1/compiler-error-c2150.md | 2 +- .../compiler-errors-1/compiler-error-c2153.md | 2 +- .../compiler-errors-1/compiler-error-c2156.md | 2 +- .../compiler-errors-1/compiler-error-c2157.md | 2 +- .../compiler-errors-1/compiler-error-c2158.md | 2 +- .../compiler-errors-1/compiler-error-c2159.md | 2 +- .../compiler-errors-1/compiler-error-c2160.md | 2 +- 14 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md index 52e9dd2448e..91cf4c9fe2b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md @@ -16,7 +16,7 @@ An array exceeds the 2GB limit. Reduce the size of the array. ## Example -The following sample generates C2141. +The following example generates C2141. ```cpp // C2141.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md index 3f6949e2281..67f29e34c90 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md @@ -16,7 +16,7 @@ One declaration of the function contains a variable parameter list. Another decl ## Example -The following sample generates C2142: +The following example generates C2142: ```c // C2142.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2144.md b/docs/error-messages/compiler-errors-1/compiler-error-c2144.md index 78a2a5536c8..3f13bdf80a5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2144.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2144.md @@ -22,7 +22,7 @@ You may also see C2144 if you are trying to do type forwarding. See [Type Forwar ## Examples -The following sample generates C2144, and shows a way to fix it: +The following example generates C2144, and shows a way to fix it: ```cpp // C2144.cpp @@ -35,7 +35,7 @@ REF struct MyStruct0; // C2144 REF1 MyStruct1; ``` -The following sample generates C2144, and shows a way to fix it: +The following example generates C2144, and shows a way to fix it: ```cpp // C2144_2.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md index 23161ba2e9e..8f2cbec0389 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md @@ -22,7 +22,7 @@ This error may be caused by a typographical error. Error [C2065](../../error-mes ## Examples -The following sample generates C2146. +The following example generates C2146. ```cpp // C2146.cpp @@ -41,7 +41,7 @@ int main() { This error can also be generated as a result of compiler conformance work that was done for Visual Studio .NET 2003: missing **`typename`** keyword. -The following sample compiles in Visual Studio .NET 2002 but will fail in Visual Studio .NET 2003: +The following example compiles in Visual Studio .NET 2002 but will fail in Visual Studio .NET 2003: ```cpp // C2146b.cpp @@ -66,7 +66,7 @@ You will also see this error as a result of compiler conformance work that was d The use of `T` from the primary template is not allowed in the explicit specialization. For code to be valid in the Visual Studio .NET 2003 and Visual Studio .NET, replace all instances of the template parameter in the specialization with the explicitly specialized type. -The following sample compiles in Visual Studio .NET but will fail in Visual Studio .NET 2003: +The following example compiles in Visual Studio .NET but will fail in Visual Studio .NET 2003: ```cpp // C2146_c.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md index 7a476e6d3ba..c465bed9558 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md @@ -16,7 +16,7 @@ An identifier was used that is now a reserved keyword in the language. ## Example -The following sample generates C2147: +The following example generates C2147: ```cpp // C2147.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md index 16028fd4f54..362a27f79a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md @@ -16,7 +16,7 @@ An array exceeds the limit. Reduce the size of the array. ## Example -The following sample generates C2148: +The following example generates C2148: ```cpp // C2148.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md index 1a35e5fd1e4..a758a5a47e4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md @@ -16,7 +16,7 @@ Bit fields can have zero width only if unnamed. ## Example -The following sample generates C2149: +The following example generates C2149: ```cpp // C2149.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2150.md b/docs/error-messages/compiler-errors-1/compiler-error-c2150.md index e2c64d9b239..de57f08a439 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2150.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2150.md @@ -16,7 +16,7 @@ The base type for a bit-field is required to be **`int`**, **`signed int`**, or ## Example -This sample shows how you might encounter C2150, and how you can fix it: +This example shows how you might encounter C2150, and how you can fix it: ```cpp // C2150.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md index 12594a50a85..3507dbaccba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md @@ -15,7 +15,7 @@ Hexadecimal and binary literals must contain at least one digit after the leadin ## Example -The following sample generates C2153: +The following example generates C2153: ```cpp // C2153.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md index 5cc7ebb4452..98658c61ae0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md @@ -16,7 +16,7 @@ A pragma that must be specified at a global level (outside a function body) is w ## Example -The following sample generates C2156: +The following example generates C2156: ```cpp // C2156.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md index 9cd18f3855c..cf796efaef2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md @@ -16,7 +16,7 @@ The function name is not declared before being referenced in the list of functio ## Example -The following sample generates C2157: +The following example generates C2157: ```cpp // C2157.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md index 705ee912777..e3a8801679f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md @@ -16,7 +16,7 @@ The [make_public](../../preprocessor/make-public.md) pragma can only be applied ## Example -The following sample generates C2158. +The following example generates C2158. ```cpp // C2158.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md index 656e22fc096..af70354f9cb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md @@ -16,7 +16,7 @@ A declaration contains more than one storage class. ## Example -The following sample generates C2159: +The following example generates C2159: ```cpp // C2159.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md index b8360877ccc..924fd82c3c3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md @@ -16,7 +16,7 @@ A macro definition began with a token-pasting operator (##). ## Example -The following sample generates C2160: +The following example generates C2160: ```cpp // C2160.cpp From f63a22c9b4d9a73bbeb217c6f8475a93aca4a613 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 16 Jul 2025 23:17:39 +0800 Subject: [PATCH 0419/1799] Update metadata for error references in range [C2141, C2160] --- .../error-messages/compiler-errors-1/compiler-error-c2141.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2142.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2143.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2144.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2145.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2146.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2147.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2148.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2149.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2150.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2151.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2152.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2153.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2154.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2155.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2156.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2157.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2158.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2159.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2160.md | 5 ++--- 20 files changed, 39 insertions(+), 58 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md index 91cf4c9fe2b..18e160df28b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2141" title: "Compiler Error C2141" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2141" +ms.date: 11/04/2016 f1_keywords: ["C2141"] helpviewer_keywords: ["C2141"] -ms.assetid: 10cf770f-0500-4220-ac90-a863b7ea5fe6 --- # Compiler Error C2141 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md index 67f29e34c90..63c8eae9446 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2142" title: "Compiler Error C2142" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2142" +ms.date: 11/04/2016 f1_keywords: ["C2142"] helpviewer_keywords: ["C2142"] -ms.assetid: d0dbe10e-0952-49a4-8b33-e82fb7558b19 --- # Compiler Error C2142 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2143.md b/docs/error-messages/compiler-errors-1/compiler-error-c2143.md index 750a7b07d8f..244566a6131 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2143.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2143.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2143" title: "Compiler Error C2143" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2143" +ms.date: 11/04/2016 f1_keywords: ["C2143"] helpviewer_keywords: ["C2143"] -ms.assetid: 1d8d1456-e031-4965-9240-09a6e33ba81c --- # Compiler Error C2143 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2144.md b/docs/error-messages/compiler-errors-1/compiler-error-c2144.md index 3f13bdf80a5..c50ffbe8bfc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2144.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2144.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2144" title: "Compiler Error C2144" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2144" +ms.date: 11/04/2016 f1_keywords: ["C2144"] helpviewer_keywords: ["C2144"] -ms.assetid: 49f3959b-324f-4c06-9588-c0ecef5dc5b3 --- # Compiler Error C2144 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2145.md b/docs/error-messages/compiler-errors-1/compiler-error-c2145.md index bd21fc25326..3f0cb125a01 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2145.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2145.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2145" title: "Compiler Error C2145" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2145" +ms.date: 11/04/2016 f1_keywords: ["C2145"] helpviewer_keywords: ["C2145"] -ms.assetid: 158e5809-8adb-4195-8ca5-684501defbc8 --- # Compiler Error C2145 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md index 8f2cbec0389..075f911dfac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2146" title: "Compiler Error C2146" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2146" +ms.date: 11/04/2016 f1_keywords: ["C2146"] helpviewer_keywords: ["C2146"] -ms.assetid: 6bfb7de6-6723-4486-9350-c66ef88d7a64 --- # Compiler Error C2146 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md index c465bed9558..c282a1e2bdc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2147" title: "Compiler Error C2147" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2147" +ms.date: 11/04/2016 f1_keywords: ["C2147"] helpviewer_keywords: ["C2147"] -ms.assetid: d1adb3bf-7ece-4815-922c-ad7492fb6670 --- # Compiler Error C2147 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md index 362a27f79a4..6caab690512 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2148" title: "Compiler Error C2148" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2148" +ms.date: 11/04/2016 f1_keywords: ["C2148"] helpviewer_keywords: ["C2148"] -ms.assetid: e510c2c9-7b57-4ce8-be03-ba363e2cc5d9 --- # Compiler Error C2148 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md index a758a5a47e4..e6e64526d8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2149" title: "Compiler Error C2149" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2149" +ms.date: 11/04/2016 f1_keywords: ["C2149"] helpviewer_keywords: ["C2149"] -ms.assetid: 7a106dab-d79f-41b9-85be-f36e86e4d2ab --- # Compiler Error C2149 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2150.md b/docs/error-messages/compiler-errors-1/compiler-error-c2150.md index de57f08a439..c1595ba5141 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2150.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2150.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2150" title: "Compiler Error C2150" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2150" +ms.date: 11/04/2016 f1_keywords: ["C2150"] helpviewer_keywords: ["C2150"] -ms.assetid: 21e82a10-c1d4-4c0d-9dc6-c5d92ea42a31 --- # Compiler Error C2150 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2151.md b/docs/error-messages/compiler-errors-1/compiler-error-c2151.md index 71ac6bdb308..60f0f9ebea8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2151.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2151.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2151" title: "Compiler Error C2151" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2151" +ms.date: 11/04/2016 f1_keywords: ["C2151"] helpviewer_keywords: ["C2151"] -ms.assetid: 7f8dd83a-1f41-46d8-8778-0d1f79ed36c9 --- # Compiler Error C2151 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2152.md b/docs/error-messages/compiler-errors-1/compiler-error-c2152.md index 527f9f69a07..fa096f9730a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2152.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2152.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2152" title: "Compiler Error C2152" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2152" +ms.date: 11/04/2016 f1_keywords: ["C2152"] helpviewer_keywords: ["C2152"] -ms.assetid: a9ea2b0c-d55d-41c7-ba9f-dd75592ffc8a --- # Compiler Error C2152 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md index 3507dbaccba..8f34dce0ada 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2153" description: "Learn more about: Compiler Error C2153" -ms.date: "01/31/2025" +ms.date: 01/31/2025 f1_keywords: ["C2153"] helpviewer_keywords: ["C2153"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md index c42c3c4ec8f..021703b64ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2154" title: "Compiler Error C2154" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2154" +ms.date: 11/04/2016 f1_keywords: ["C2154"] helpviewer_keywords: ["C2154"] -ms.assetid: 98d6b044-5a3a-43ad-95fa-9b916b22468a --- # Compiler Error C2154 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2155.md b/docs/error-messages/compiler-errors-1/compiler-error-c2155.md index 9beb9cb8671..7dfb22df0d8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2155.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2155.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2155" title: "Compiler Error C2155" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2155" +ms.date: 11/04/2016 f1_keywords: ["C2155"] helpviewer_keywords: ["C2155"] -ms.assetid: 54d408af-fc48-4121-9011-5e75c7072e01 --- # Compiler Error C2155 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md index 98658c61ae0..8ba7b0a0ca2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2156" title: "Compiler Error C2156" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2156" +ms.date: 11/04/2016 f1_keywords: ["C2156"] helpviewer_keywords: ["C2156"] -ms.assetid: 136f9c67-2c27-4f61-b7e6-ccd202eca697 --- # Compiler Error C2156 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md index cf796efaef2..104d98276b1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2157" title: "Compiler Error C2157" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2157" +ms.date: 11/04/2016 f1_keywords: ["C2157"] helpviewer_keywords: ["C2157"] -ms.assetid: babbca24-16dc-4b69-be14-a675029249c1 --- # Compiler Error C2157 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md index e3a8801679f..4372aa71568 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2158" title: "Compiler Error C2158" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2158" +ms.date: 11/04/2016 f1_keywords: ["C2158"] helpviewer_keywords: ["C2158"] -ms.assetid: 39028899-e95c-4809-8e65-6111118641ee --- # Compiler Error C2158 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md index af70354f9cb..1463230715d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2159" title: "Compiler Error C2159" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2159" +ms.date: 11/04/2016 f1_keywords: ["C2159"] helpviewer_keywords: ["C2159"] -ms.assetid: 925a2cbd-43c9-45ee-a373-84004350b380 --- # Compiler Error C2159 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md index 924fd82c3c3..1b9174fbe60 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2160" title: "Compiler Error C2160" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2160" +ms.date: 11/04/2016 f1_keywords: ["C2160"] helpviewer_keywords: ["C2160"] -ms.assetid: a1f694a7-fb16-4437-b7f5-a1af6da94bc5 --- # Compiler Error C2160 From dfce1d47b4fa3010b2c63dab29eb81ce6e95cd87 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 17 Jul 2025 00:18:47 +0800 Subject: [PATCH 0420/1799] Remove "EnterRemarks" in `COleTemplateServer` class reference --- docs/mfc/reference/coletemplateserver-class.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/mfc/reference/coletemplateserver-class.md b/docs/mfc/reference/coletemplateserver-class.md index e497aa5a489..c7fdc19701c 100644 --- a/docs/mfc/reference/coletemplateserver-class.md +++ b/docs/mfc/reference/coletemplateserver-class.md @@ -104,10 +104,6 @@ BOOL Unregister(); TRUE if successful; otherwise FALSE. -### Remarks - -EnterRemarks - ## COleTemplateServer::UpdateRegistry Loads file-type information from the document-template string and places that information in the OLE system registry. From c3e0c753ad5adb74c21a8401b8d31fe26058a9fa Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 17 Jul 2025 00:19:21 +0800 Subject: [PATCH 0421/1799] Update metadata in `COleTemplateServer` class reference --- docs/mfc/reference/coletemplateserver-class.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/mfc/reference/coletemplateserver-class.md b/docs/mfc/reference/coletemplateserver-class.md index c7fdc19701c..79a0b6e661b 100644 --- a/docs/mfc/reference/coletemplateserver-class.md +++ b/docs/mfc/reference/coletemplateserver-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleTemplateServer Class" title: "COleTemplateServer Class" -ms.date: "11/04/2016" +description: "Learn more about: COleTemplateServer Class" +ms.date: 11/04/2016 f1_keywords: ["COleTemplateServer", "AFXDISP/COleTemplateServer", "AFXDISP/COleTemplateServer::COleTemplateServer", "AFXDISP/COleTemplateServer::ConnectTemplate", "AFXDISP/COleTemplateServer::Unregister", "AFXDISP/COleTemplateServer::UpdateRegistry"] helpviewer_keywords: ["COleTemplateServer [MFC], COleTemplateServer", "COleTemplateServer [MFC], ConnectTemplate", "COleTemplateServer [MFC], Unregister", "COleTemplateServer [MFC], UpdateRegistry"] -ms.assetid: 47a2887d-8162-4993-a842-a784177c7f5c --- # COleTemplateServer Class From f3b5367ec25169703c78bbcab82ce6d7b1858598 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 16 Jul 2025 17:02:47 -0700 Subject: [PATCH 0422/1799] acrolinx --- .../tutorials/build-insights-function-view.md | 8 ++++---- .../tutorials/build-insights-template-view.md | 4 ++-- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-function-view.md b/docs/build-insights/tutorials/build-insights-function-view.md index 35c96d5d196..bd0ccd9e319 100644 --- a/docs/build-insights/tutorials/build-insights-function-view.md +++ b/docs/build-insights/tutorials/build-insights-function-view.md @@ -12,7 +12,7 @@ Use Build Insights **Functions** view to troubleshoot the impact of function inl ## Prerequisites - Visual Studio 2022 17.8 or greater. -- C++ Build insights is enabled by default if you install either the Desktop development with C++ workload or the Game development with C++ workload. +- C++ Build Insights is enabled by default if you install either the Desktop development with C++ workload or the Game development with C++ workload. :::image type="complex" source="./media/installer-desktop-cpp-build-insights.png" alt-text="Screenshot of the Visual Studio Installer with the Desktop development with C++ workload selected."::: The list of installed components is shown. C++ Build Insights is highlighted and is selected which means it's installed. @@ -61,7 +61,7 @@ When the build finishes, an Event Trace Log (ETL) file opens. It's saved in the ## Function view -In the window for the ETL file, choose the **Functions** tab. It shows the functions that were compiled and the time it took to generate the code for each function. If the amount of code generated for a function is negligible, it won't appear in the list to avoid degrading build event collection performance. +In the window for the ETL file, choose the **Functions** tab. It shows the functions that were compiled and the time it took to generate the code for each function. If the amount of code generated for a function is negligible, it doesn't appear in the list to avoid degrading build event collection performance. :::image type="complex" source="./media/functions-view-before-fix.png" alt-text="Screenshot of the Build Insights Functions view file."::: In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon. @@ -83,7 +83,7 @@ In this example, the `performPhysicsCalculations` function is taking the most ti In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon. :::image-end::: -Investigating further, by selecting the chevron before that function, and then sorting the **Forceinline Size** column from highest to lowest, we see the biggest contributors to the problem. +By selecting the chevron before that function, and then sorting the **Forceinline Size** column from highest to lowest, we see the biggest contributors to the problem. :::image type="complex" source="./media/functions-view-expanded.png" alt-text="Screenshot of the Build Insights Functions view with an expanded function."::: performPhysicsCalculations() is expanded and shows a long list of functions that were inlined inside it. There are multiple instances of functions such as complexOperation(), recursiveHelper(), and sin() shown. The Forceinline Size column shows that complexOperation() is the largest inlined function at 315 instructions. recursiveHelper() has 119 instructions. Sin() has 75 instructions, but there are many more instances of it than the other functions. @@ -106,7 +106,7 @@ static __forceinline T factorial(int n) } ``` -Perhaps the overall cost of calling this function is insignificant compared to the cost of the function itself. Making a function inline is most beneficial when the time it takes to call the function (pushing arguments on the stack, jumping to the function, popping return arguments, and returning from the function) is roughly similar to the time it takes to execute the function, and when the function is called a lot. When that's not the case, there may be diminishing returns on making it inline. We can try removing the `__forceinline` directive from it to see if it helps the build time. The code for `power`, `sin()` and `cos()` is similar in that the code consists of a loop that will execute many times. We can try removing the `__forceinline` directive from those functions as well. +Perhaps the overall cost of calling this function is insignificant compared to the cost of the function itself. Making a function inline is most beneficial when the time it takes to call the function (pushing arguments on the stack, jumping to the function, popping return arguments, and returning from the function) is roughly similar to the time it takes to execute the function, and when the function is called a lot. When that's not the case, there may be diminishing returns on making it inline. We can try removing the `__forceinline` directive from it to see if it helps the build time. The code for `power`, `sin()`, and `cos()` is similar in that the code consists of a loop that executes many times. We can try removing the `__forceinline` directive from those functions as well. We rerun Build Insights from the main menu by choosing **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. We choose **Rebuild** instead of **Build** to measure the build time for the entire project, as before, and not for just the few files may be dirty right now. diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index f43f2eecf62..c9a57fe3234 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -15,7 +15,7 @@ The **Templates** view works like the Build Insights [Functions view](build-insi ## Prerequisites - Visual Studio 2022 version 17.10 or later. -- The **C++ Build Insights** component must be installed. It's included in either the Desktop development with C++ workload or the Game development with C++ workload. To check if it's installed, follow these steps: +- The **C++ Build Insights** component must be installed. Either the Desktop development with C++ workload or the Game development with C++ workload includes it. To check if it's installed, follow these steps: 1. Open the Visual Studio Installer. 1. Select **Modify** to change your Visual Studio installation. 1. On the **Individual components** tab, search for and select **C++ Build Insights**, then select **Close** to finish installing the component. @@ -136,7 +136,7 @@ The Templates view shows two template instantiations of struct S3 taking most (7 ### Understanding Templates view results -When interpreting Templates view results, keep this in mind: +When interpreting Templates view results, consider the following: - **Empty view**: If nothing shows up in the **Templates** view, template instantiations don't dominate your build time. That's good news because your templates aren't a build bottleneck. - **Duplicate instantiations**: If the same template instantiation appears multiple times across different translation units, different source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. From f3e8928a892a18720a1dd4df98cc5d5add113b63 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 17 Jul 2025 22:18:24 +0800 Subject: [PATCH 0423/1799] Add forward slash for `/std` compiler options --- docs/cpp/nothrow-cpp.md | 2 +- docs/standard-library/basic-string-view-class.md | 4 ++-- docs/standard-library/string-view.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/cpp/nothrow-cpp.md b/docs/cpp/nothrow-cpp.md index b0749a32f4c..c74b0ddc02b 100644 --- a/docs/cpp/nothrow-cpp.md +++ b/docs/cpp/nothrow-cpp.md @@ -20,7 +20,7 @@ A **`__declspec`** extended attribute which can be used in the declaration of fu We recommend that all new code use the [`noexcept`](noexcept-cpp.md) operator rather than `__declspec(nothrow)`. -This attribute tells the compiler that the declared function and the functions it calls never throw an exception. However, it does not enforce the directive. In other words, it never causes [`std::terminate`](../standard-library/exception-functions.md#terminate) to be invoked, unlike **`noexcept`**, or in **`std:c++17`** mode (Visual Studio 2017 version 15.5 and later), `throw()`. +This attribute tells the compiler that the declared function and the functions it calls never throw an exception. However, it does not enforce the directive. In other words, it never causes [`std::terminate`](../standard-library/exception-functions.md#terminate) to be invoked, unlike **`noexcept`**, or in **`/std:c++17`** mode (Visual Studio 2017 version 15.5 and later), `throw()`. With the synchronous exception handling model, now the default, the compiler can eliminate the mechanics of tracking the lifetime of certain unwindable objects in such a function, and significantly reduce the code size. Given the following preprocessor directive, the three function declarations below are equivalent in **`/std:c++14`** mode: diff --git a/docs/standard-library/basic-string-view-class.md b/docs/standard-library/basic-string-view-class.md index 014c086606c..d1b682c1a90 100644 --- a/docs/standard-library/basic-string-view-class.md +++ b/docs/standard-library/basic-string-view-class.md @@ -138,7 +138,7 @@ If a function is asked to generate a sequence longer than [`max_size`](#max_size ## Requirements -[`std:c++17`](../build/reference/std-specify-language-standard-version.md) or later. +[`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later. **Header:** `` @@ -1013,7 +1013,7 @@ Null-terminated character string containing the prefix to look for. ### Remarks -`starts_with()` is new in C++20. To use it, specify the [`std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. +`starts_with()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. See [`ends_with`](#ends_with) to see if a string ends with a suffix. diff --git a/docs/standard-library/string-view.md b/docs/standard-library/string-view.md index 7582ab417c5..846721c1956 100644 --- a/docs/standard-library/string-view.md +++ b/docs/standard-library/string-view.md @@ -6,7 +6,7 @@ helpviewer_keywords: ["string_view header"] --- # `` -Defines the class template `basic_string_view` and related types and operators. (Requires compiler option [`std:c++17`](../build/reference/std-specify-language-standard-version.md) or later.) +Defines the class template `basic_string_view` and related types and operators. (Requires compiler option [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later.) ## Syntax @@ -60,7 +60,7 @@ The `` operators can compare `string_view` objects to objects of an - **Namespace:** `std` -- **Compiler Option:** [`std:c++17`](../build/reference/std-specify-language-standard-version.md) or later. +- **Compiler Option:** [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later. ## See also From 4cf2343a8463864f990db0883212a41c0d18d102 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 17 Jul 2025 22:19:36 +0800 Subject: [PATCH 0424/1799] Update metadata in `nothrow` C++ reference --- docs/cpp/nothrow-cpp.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/cpp/nothrow-cpp.md b/docs/cpp/nothrow-cpp.md index c74b0ddc02b..fd5ebc478b4 100644 --- a/docs/cpp/nothrow-cpp.md +++ b/docs/cpp/nothrow-cpp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: nothrow (C++)" title: "nothrow (C++)" -ms.date: "01/03/2018" +description: "Learn more about: nothrow (C++)" +ms.date: 01/03/2018 f1_keywords: ["nothrow_cpp"] helpviewer_keywords: ["__declspec keyword [C++], nothrow", "nothrow __declspec keyword"] -ms.assetid: 0a475139-459c-4ec6-99e8-7ecd0d7f44a3 --- # `nothrow` (C++) From 787e2230987333baad360f913407877aa3fcd203 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 17 Jul 2025 22:27:43 +0800 Subject: [PATCH 0425/1799] Add blockquotes for error messages in range [C2161, C2180] --- docs/error-messages/compiler-errors-1/compiler-error-c2161.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2163.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2164.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2165.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2167.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2168.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2169.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2170.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2171.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2172.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2173.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2174.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2175.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2177.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2178.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2179.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2180.md | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md index e552b85448f..39de6b4ad2a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md @@ -8,7 +8,7 @@ ms.assetid: d6798821-13bb-4e60-924f-85f7bf955387 --- # Compiler Error C2161 -'##' cannot occur at the end of a macro definition +> '##' cannot occur at the end of a macro definition A macro definition ended with a token-pasting operator (##). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2163.md b/docs/error-messages/compiler-errors-1/compiler-error-c2163.md index 8cf898cc43c..5a13cfaf57a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2163.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2163.md @@ -8,6 +8,6 @@ ms.assetid: 6428d1e9-1ba1-46fc-bbf6-91d6fef2734c --- # Compiler Error C2163 -'function' : not available as an intrinsic function +> 'function' : not available as an intrinsic function An `intrinsic` or `function` pragma lists a function not available in intrinsic form. For example, certain intrinsics are not available when compiling a program that uses /clr programming. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md index 0938243a688..57571d4302b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md @@ -8,7 +8,7 @@ ms.assetid: 55df5024-68a8-45a8-ae6c-e6dba35318a2 --- # Compiler Error C2164 -'function' : intrinsic function not declared +> 'function' : intrinsic function not declared An `intrinsic` pragma uses an undeclared function (only occurs with **/Oi**). Or, one of the compiler intrinsics was used without including its header file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md index 6cc12f0dcc2..85fdf065e5e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md @@ -8,7 +8,7 @@ ms.assetid: b108313b-b8cb-4dce-b2ec-f2b31c9cdc87 --- # Compiler Error C2165 -'keyword' : cannot modify pointers to data +> 'keyword' : cannot modify pointers to data The **`__stdcall`**, **`__cdecl`**, or **`__fastcall`** keyword attempts to modify a pointer to data. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2167.md b/docs/error-messages/compiler-errors-1/compiler-error-c2167.md index 04cfdca5904..bbdb6497069 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2167.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2167.md @@ -8,6 +8,6 @@ ms.assetid: 3de3de96-12cd-47df-b24e-34cc9747ef83 --- # Compiler Error C2167 -'function' : too many actual parameters for intrinsic function +> 'function' : too many actual parameters for intrinsic function A reference to an `intrinsic` function has too many parameters. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2168.md b/docs/error-messages/compiler-errors-1/compiler-error-c2168.md index 26574e9a1be..07b70732f05 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2168.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2168.md @@ -8,6 +8,6 @@ ms.assetid: 625e7dc3-ca74-4980-8268-8d5c0245e376 --- # Compiler Error C2168 -'function' : too few actual parameters for intrinsic function +> 'function' : too few actual parameters for intrinsic function A reference to an `intrinsic` function has too few parameters. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2169.md b/docs/error-messages/compiler-errors-1/compiler-error-c2169.md index a4e58165941..08594947863 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2169.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2169.md @@ -8,6 +8,6 @@ ms.assetid: 97f700bd-1044-46f5-b276-3d7570ee7708 --- # Compiler Error C2169 -'function' : intrinsic function, cannot be defined +> 'function' : intrinsic function, cannot be defined A function definition appears for a function already declared `intrinsic`. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2170.md b/docs/error-messages/compiler-errors-1/compiler-error-c2170.md index 599a5750112..7a4456441f5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2170.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2170.md @@ -8,7 +8,7 @@ ms.assetid: d5c663f0-2459-4e11-a8bf-a52b62f3c71d --- # Compiler Error C2170 -'identifier' : not declared as a function, cannot be intrinsic +> 'identifier' : not declared as a function, cannot be intrinsic ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md index f32ebc62e2e..fc1bce5b04c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md @@ -8,7 +8,7 @@ ms.assetid: a80343b5-ab3f-4413-b6f1-3ce9d7e519e5 --- # Compiler Error C2171 -'operator' : illegal on operands of type 'type' +> 'operator' : illegal on operands of type 'type' A unary operator is used with an invalid operand type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2172.md b/docs/error-messages/compiler-errors-1/compiler-error-c2172.md index 8e2992bd811..a7aff4fb950 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2172.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2172.md @@ -8,6 +8,6 @@ ms.assetid: 31183ea7-858d-4273-932a-d865af7059b1 --- # Compiler Error C2172 -'function' : actual parameter is not a pointer : parameter number +> 'function' : actual parameter is not a pointer : parameter number Parameter `number` is not a pointer. The function expects a pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2173.md b/docs/error-messages/compiler-errors-1/compiler-error-c2173.md index 45dc2487855..5dfb990cd21 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2173.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2173.md @@ -8,6 +8,6 @@ ms.assetid: 4df592b8-609b-41a5-b4fc-966eb5bb2d1a --- # Compiler Error C2173 -'function' : actual parameter is not a pointer : parameter number1, parameter list number2 +> 'function' : actual parameter is not a pointer : parameter number1, parameter list number2 Parameter `number1` passed to parameter list `number2` is not a pointer. The function expects a pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2174.md b/docs/error-messages/compiler-errors-1/compiler-error-c2174.md index bc685baa294..8f780a82f60 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2174.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2174.md @@ -8,6 +8,6 @@ ms.assetid: 161d563c-76e9-47e9-9142-7812e9ea169e --- # Compiler Error C2174 -'function' : actual parameter has type 'void' : parameter number1, parameter list number2 +> 'function' : actual parameter has type 'void' : parameter number1, parameter list number2 Parameter `number1` passed to parameter list `number2` is a **`void`** parameter. Parameters cannot have type **`void`**. Use **`void*`** instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2175.md b/docs/error-messages/compiler-errors-1/compiler-error-c2175.md index 4f210813ce0..95bd5c9e20a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2175.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2175.md @@ -8,6 +8,6 @@ ms.assetid: 3a8fa90b-2b29-414a-bb55-cf27c2bf989a --- # Compiler Error C2175 -'locale' : invalid locale +> 'locale' : invalid locale The specified locale is not valid. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for supported locales. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md index a69d0bcd35b..dd462bae296 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md @@ -8,7 +8,7 @@ ms.assetid: 2a39a880-cddb-4d3e-a572-645a14c4c478 --- # Compiler Error C2177 -constant too big +> constant too big A constant value is too large for the variable type it is assigned. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index b9aecbda49c..377ea2b6be2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -8,7 +8,7 @@ ms.assetid: 79a14158-17f3-4221-bd06-9d675c49cef4 --- # Compiler Error C2178 -'*identifier*' cannot be declared with '*specifier*' specifier +> '*identifier*' cannot be declared with '*specifier*' specifier A **`mutable`** specifier was used in a declaration, but the specifier is not allowed in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md index d1c9b3dc115..ffc0ceaa8bd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md @@ -8,7 +8,7 @@ ms.assetid: f929bfc6-3964-4e54-87d6-7529b9b6c0b9 --- # Compiler Error C2179 -'type' : an attribute argument cannot use type parameters +> 'type' : an attribute argument cannot use type parameters A generic type parameter is resolved at runtime. However, an attribute parameter must be resolved at compile time. Therefore, you cannot use a generic type parameter as an argument to an attribute. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md index 30c5e6e220f..d6857d456a5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md @@ -8,7 +8,7 @@ ms.assetid: ea71b39e-b977-48a7-b7bd-af68ef5e263b --- # Compiler Error C2180 -controlling expression has type 'type' +> controlling expression has type 'type' The controlling expression in an **`if`**, **`while`**, **`for`**, or **`do`** statement is an expression cast to **`void`**. To fix this issue, change the controlling expression to one that produces a **`bool`** or a type that can be converted to **`bool`**. From ee4f1c16609d75f47480cbae1daa722e7491216b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 17 Jul 2025 22:31:04 +0800 Subject: [PATCH 0426/1799] Add "Remarks" and "Example" headings for error references in range [C2161, C2180] --- docs/error-messages/compiler-errors-1/compiler-error-c2161.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2162.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2163.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2164.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2165.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2167.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2168.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2169.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2171.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2172.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2173.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2174.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2175.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2177.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2178.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2179.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2180.md | 4 ++++ 17 files changed, 44 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md index 39de6b4ad2a..7bb6e958929 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md @@ -10,8 +10,12 @@ ms.assetid: d6798821-13bb-4e60-924f-85f7bf955387 > '##' cannot occur at the end of a macro definition +## Remarks + A macro definition ended with a token-pasting operator (##). +## Example + The following sample generates C2161: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2162.md b/docs/error-messages/compiler-errors-1/compiler-error-c2162.md index 2cd9768016e..b76cbb2783f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2162.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2162.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2162"] > expected macro formal parameter +## Remarks + The token following a [stringizing operator (#)](../../preprocessor/stringizing-operator-hash.md) or a [charizing operator (#@)](../../preprocessor/charizing-operator-hash-at.md) is not a formal parameter. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2163.md b/docs/error-messages/compiler-errors-1/compiler-error-c2163.md index 5a13cfaf57a..aea0a631902 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2163.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2163.md @@ -10,4 +10,6 @@ ms.assetid: 6428d1e9-1ba1-46fc-bbf6-91d6fef2734c > 'function' : not available as an intrinsic function +## Remarks + An `intrinsic` or `function` pragma lists a function not available in intrinsic form. For example, certain intrinsics are not available when compiling a program that uses /clr programming. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md index 57571d4302b..e8c7e910b22 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md @@ -10,8 +10,12 @@ ms.assetid: 55df5024-68a8-45a8-ae6c-e6dba35318a2 > 'function' : intrinsic function not declared +## Remarks + An `intrinsic` pragma uses an undeclared function (only occurs with **/Oi**). Or, one of the compiler intrinsics was used without including its header file. +## Example + The following sample generates C2164: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md index 85fdf065e5e..9355bdf3281 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md @@ -10,8 +10,12 @@ ms.assetid: b108313b-b8cb-4dce-b2ec-f2b31c9cdc87 > 'keyword' : cannot modify pointers to data +## Remarks + The **`__stdcall`**, **`__cdecl`**, or **`__fastcall`** keyword attempts to modify a pointer to data. +## Example + The following sample generates C2165: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2167.md b/docs/error-messages/compiler-errors-1/compiler-error-c2167.md index bbdb6497069..2c5bb406766 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2167.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2167.md @@ -10,4 +10,6 @@ ms.assetid: 3de3de96-12cd-47df-b24e-34cc9747ef83 > 'function' : too many actual parameters for intrinsic function +## Remarks + A reference to an `intrinsic` function has too many parameters. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2168.md b/docs/error-messages/compiler-errors-1/compiler-error-c2168.md index 07b70732f05..a9eae8322df 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2168.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2168.md @@ -10,4 +10,6 @@ ms.assetid: 625e7dc3-ca74-4980-8268-8d5c0245e376 > 'function' : too few actual parameters for intrinsic function +## Remarks + A reference to an `intrinsic` function has too few parameters. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2169.md b/docs/error-messages/compiler-errors-1/compiler-error-c2169.md index 08594947863..031d6a56e9d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2169.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2169.md @@ -10,4 +10,6 @@ ms.assetid: 97f700bd-1044-46f5-b276-3d7570ee7708 > 'function' : intrinsic function, cannot be defined +## Remarks + A function definition appears for a function already declared `intrinsic`. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md index fc1bce5b04c..bdbacd8b325 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md @@ -10,6 +10,8 @@ ms.assetid: a80343b5-ab3f-4413-b6f1-3ce9d7e519e5 > 'operator' : illegal on operands of type 'type' +## Remarks + A unary operator is used with an invalid operand type. ## Examples diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2172.md b/docs/error-messages/compiler-errors-1/compiler-error-c2172.md index a7aff4fb950..21830a8f6dd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2172.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2172.md @@ -10,4 +10,6 @@ ms.assetid: 31183ea7-858d-4273-932a-d865af7059b1 > 'function' : actual parameter is not a pointer : parameter number +## Remarks + Parameter `number` is not a pointer. The function expects a pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2173.md b/docs/error-messages/compiler-errors-1/compiler-error-c2173.md index 5dfb990cd21..cc8ed5f830b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2173.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2173.md @@ -10,4 +10,6 @@ ms.assetid: 4df592b8-609b-41a5-b4fc-966eb5bb2d1a > 'function' : actual parameter is not a pointer : parameter number1, parameter list number2 +## Remarks + Parameter `number1` passed to parameter list `number2` is not a pointer. The function expects a pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2174.md b/docs/error-messages/compiler-errors-1/compiler-error-c2174.md index 8f780a82f60..0954a45e3b4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2174.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2174.md @@ -10,4 +10,6 @@ ms.assetid: 161d563c-76e9-47e9-9142-7812e9ea169e > 'function' : actual parameter has type 'void' : parameter number1, parameter list number2 +## Remarks + Parameter `number1` passed to parameter list `number2` is a **`void`** parameter. Parameters cannot have type **`void`**. Use **`void*`** instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2175.md b/docs/error-messages/compiler-errors-1/compiler-error-c2175.md index 95bd5c9e20a..0dc3373cd96 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2175.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2175.md @@ -10,4 +10,6 @@ ms.assetid: 3a8fa90b-2b29-414a-bb55-cf27c2bf989a > 'locale' : invalid locale +## Remarks + The specified locale is not valid. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for supported locales. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md index dd462bae296..4e4de822295 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md @@ -10,8 +10,12 @@ ms.assetid: 2a39a880-cddb-4d3e-a572-645a14c4c478 > constant too big +## Remarks + A constant value is too large for the variable type it is assigned. +## Example + The following sample generates C2177: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index 377ea2b6be2..81d929a240e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -10,6 +10,8 @@ ms.assetid: 79a14158-17f3-4221-bd06-9d675c49cef4 > '*identifier*' cannot be declared with '*specifier*' specifier +## Remarks + A **`mutable`** specifier was used in a declaration, but the specifier is not allowed in this context. The **`mutable`** specifier can be applied only to names of class data members, and cannot be applied to names declared **`const`** or **`static`**, and cannot be applied to reference members. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md index ffc0ceaa8bd..0a149450f0f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md @@ -10,6 +10,8 @@ ms.assetid: f929bfc6-3964-4e54-87d6-7529b9b6c0b9 > 'type' : an attribute argument cannot use type parameters +## Remarks + A generic type parameter is resolved at runtime. However, an attribute parameter must be resolved at compile time. Therefore, you cannot use a generic type parameter as an argument to an attribute. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md index d6857d456a5..cd041d4c12e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md @@ -10,8 +10,12 @@ ms.assetid: ea71b39e-b977-48a7-b7bd-af68ef5e263b > controlling expression has type 'type' +## Remarks + The controlling expression in an **`if`**, **`while`**, **`for`**, or **`do`** statement is an expression cast to **`void`**. To fix this issue, change the controlling expression to one that produces a **`bool`** or a type that can be converted to **`bool`**. +## Example + The following sample generates C2180: ```c From 0c98748bb53cb498b06cb134f423ac73bbe1597b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 17 Jul 2025 22:32:16 +0800 Subject: [PATCH 0427/1799] Replace term "sample" with "example" for error references in range [C2161, C2180] --- docs/error-messages/compiler-errors-1/compiler-error-c2161.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2164.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2165.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2171.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2177.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2178.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2179.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2180.md | 2 +- 8 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md index 7bb6e958929..28d91233055 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md @@ -16,7 +16,7 @@ A macro definition ended with a token-pasting operator (##). ## Example -The following sample generates C2161: +The following example generates C2161: ```cpp // C2161.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md index e8c7e910b22..723618b412d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md @@ -16,7 +16,7 @@ An `intrinsic` pragma uses an undeclared function (only occurs with **/Oi**). Or ## Example -The following sample generates C2164: +The following example generates C2164: ```c // C2164.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md index 9355bdf3281..63c3aace6cf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md @@ -16,7 +16,7 @@ The **`__stdcall`**, **`__cdecl`**, or **`__fastcall`** keyword attempts to modi ## Example -The following sample generates C2165: +The following example generates C2165: ```cpp // C2165.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md index bdbacd8b325..621e0324a6a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md @@ -16,7 +16,7 @@ A unary operator is used with an invalid operand type. ## Examples -The following sample generates C2171. +The following example generates C2171. ```cpp // C2171.cpp @@ -30,7 +30,7 @@ int main() { } ``` -The following sample generates C2171. +The following example generates C2171. ```cpp // C2171_b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md index 4e4de822295..65da50f11d8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md @@ -16,7 +16,7 @@ A constant value is too large for the variable type it is assigned. ## Example -The following sample generates C2177: +The following example generates C2177: ```cpp // C2177.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index 81d929a240e..9d0be77943b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -18,7 +18,7 @@ The **`mutable`** specifier can be applied only to names of class data members, ## Example -The following sample shows how C2178 may occur, and how to fix it. +The following example shows how C2178 may occur, and how to fix it. ```cpp // C2178.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md index 0a149450f0f..1c10c0be99f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md @@ -16,7 +16,7 @@ A generic type parameter is resolved at runtime. However, an attribute parameter ## Example -The following sample generates C2179. +The following example generates C2179. ```cpp // C2179.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md index cd041d4c12e..5e5109b06be 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md @@ -16,7 +16,7 @@ The controlling expression in an **`if`**, **`while`**, **`for`**, or **`do`** s ## Example -The following sample generates C2180: +The following example generates C2180: ```c // C2180.c From dc59738ff5da2233f017d6b4bb263d6cdc7af46c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 17 Jul 2025 22:35:24 +0800 Subject: [PATCH 0428/1799] Update metadata for error references in range [C2161, C2180] --- .../error-messages/compiler-errors-1/compiler-error-c2161.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2162.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2163.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2164.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2165.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2167.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2168.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2169.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2170.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2171.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2172.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2173.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2174.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2175.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2177.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2178.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2179.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2180.md | 5 ++--- 18 files changed, 35 insertions(+), 52 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md index 28d91233055..cab1ce72319 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2161" title: "Compiler Error C2161" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2161" +ms.date: 11/04/2016 f1_keywords: ["C2161"] helpviewer_keywords: ["C2161"] -ms.assetid: d6798821-13bb-4e60-924f-85f7bf955387 --- # Compiler Error C2161 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2162.md b/docs/error-messages/compiler-errors-1/compiler-error-c2162.md index b76cbb2783f..eb2b08aa201 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2162.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2162.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2162" description: "Learn more about: Compiler Error C2162" -ms.date: "03/30/2025" +ms.date: 03/30/2025 f1_keywords: ["C2162"] helpviewer_keywords: ["C2162"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2163.md b/docs/error-messages/compiler-errors-1/compiler-error-c2163.md index aea0a631902..1fd73ce8bd0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2163.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2163.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2163" title: "Compiler Error C2163" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2163" +ms.date: 11/04/2016 f1_keywords: ["C2163"] helpviewer_keywords: ["C2163"] -ms.assetid: 6428d1e9-1ba1-46fc-bbf6-91d6fef2734c --- # Compiler Error C2163 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md index 723618b412d..5110e09126a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2164" title: "Compiler Error C2164" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2164" +ms.date: 11/04/2016 f1_keywords: ["C2164"] helpviewer_keywords: ["C2164"] -ms.assetid: 55df5024-68a8-45a8-ae6c-e6dba35318a2 --- # Compiler Error C2164 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md index 63c3aace6cf..c205d3531eb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2165" title: "Compiler Error C2165" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2165" +ms.date: 11/04/2016 f1_keywords: ["C2165"] helpviewer_keywords: ["C2165"] -ms.assetid: b108313b-b8cb-4dce-b2ec-f2b31c9cdc87 --- # Compiler Error C2165 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2167.md b/docs/error-messages/compiler-errors-1/compiler-error-c2167.md index 2c5bb406766..f893c4e0ff5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2167.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2167.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2167" title: "Compiler Error C2167" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2167" +ms.date: 11/04/2016 f1_keywords: ["C2167"] helpviewer_keywords: ["C2167"] -ms.assetid: 3de3de96-12cd-47df-b24e-34cc9747ef83 --- # Compiler Error C2167 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2168.md b/docs/error-messages/compiler-errors-1/compiler-error-c2168.md index a9eae8322df..e2fe0f0550c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2168.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2168.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2168" title: "Compiler Error C2168" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2168" +ms.date: 11/04/2016 f1_keywords: ["C2168"] helpviewer_keywords: ["C2168"] -ms.assetid: 625e7dc3-ca74-4980-8268-8d5c0245e376 --- # Compiler Error C2168 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2169.md b/docs/error-messages/compiler-errors-1/compiler-error-c2169.md index 031d6a56e9d..210ec567bc1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2169.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2169.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2169" title: "Compiler Error C2169" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2169" +ms.date: 11/04/2016 f1_keywords: ["C2169"] helpviewer_keywords: ["C2169"] -ms.assetid: 97f700bd-1044-46f5-b276-3d7570ee7708 --- # Compiler Error C2169 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2170.md b/docs/error-messages/compiler-errors-1/compiler-error-c2170.md index 7a4456441f5..a3e73e406fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2170.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2170.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2170" title: "Compiler Error C2170" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2170" +ms.date: 11/04/2016 f1_keywords: ["C2170"] helpviewer_keywords: ["C2170"] -ms.assetid: d5c663f0-2459-4e11-a8bf-a52b62f3c71d --- # Compiler Error C2170 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md index 621e0324a6a..fb4d42de908 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2171" title: "Compiler Error C2171" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2171" +ms.date: 11/04/2016 f1_keywords: ["C2171"] helpviewer_keywords: ["C2171"] -ms.assetid: a80343b5-ab3f-4413-b6f1-3ce9d7e519e5 --- # Compiler Error C2171 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2172.md b/docs/error-messages/compiler-errors-1/compiler-error-c2172.md index 21830a8f6dd..55e01b5bb3a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2172.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2172.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2172" title: "Compiler Error C2172" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2172" +ms.date: 11/04/2016 f1_keywords: ["C2172"] helpviewer_keywords: ["C2172"] -ms.assetid: 31183ea7-858d-4273-932a-d865af7059b1 --- # Compiler Error C2172 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2173.md b/docs/error-messages/compiler-errors-1/compiler-error-c2173.md index cc8ed5f830b..fb92234298a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2173.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2173.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2173" title: "Compiler Error C2173" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2173" +ms.date: 11/04/2016 f1_keywords: ["C2173"] helpviewer_keywords: ["C2173"] -ms.assetid: 4df592b8-609b-41a5-b4fc-966eb5bb2d1a --- # Compiler Error C2173 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2174.md b/docs/error-messages/compiler-errors-1/compiler-error-c2174.md index 0954a45e3b4..fe6702545fe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2174.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2174.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2174" title: "Compiler Error C2174" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2174" +ms.date: 11/04/2016 f1_keywords: ["C2174"] helpviewer_keywords: ["C2174"] -ms.assetid: 161d563c-76e9-47e9-9142-7812e9ea169e --- # Compiler Error C2174 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2175.md b/docs/error-messages/compiler-errors-1/compiler-error-c2175.md index 0dc3373cd96..32d47e23c22 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2175.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2175.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2175" title: "Compiler Error C2175" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2175" +ms.date: 11/04/2016 f1_keywords: ["C2175"] helpviewer_keywords: ["C2175"] -ms.assetid: 3a8fa90b-2b29-414a-bb55-cf27c2bf989a --- # Compiler Error C2175 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md index 65da50f11d8..e448186bf1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2177" title: "Compiler Error C2177" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2177" +ms.date: 11/04/2016 f1_keywords: ["C2177"] helpviewer_keywords: ["C2177"] -ms.assetid: 2a39a880-cddb-4d3e-a572-645a14c4c478 --- # Compiler Error C2177 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index 9d0be77943b..ce0dfb543fd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2178" title: "Compiler Error C2178" -ms.date: "05/08/2017" +description: "Learn more about: Compiler Error C2178" +ms.date: 05/08/2017 f1_keywords: ["C2178"] helpviewer_keywords: ["C2178"] -ms.assetid: 79a14158-17f3-4221-bd06-9d675c49cef4 --- # Compiler Error C2178 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md index 1c10c0be99f..2f9baef3385 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2179" title: "Compiler Error C2179" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2179" +ms.date: 11/04/2016 f1_keywords: ["C2179"] helpviewer_keywords: ["C2179"] -ms.assetid: f929bfc6-3964-4e54-87d6-7529b9b6c0b9 --- # Compiler Error C2179 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md index 5e5109b06be..d9f8803ca2b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2180" title: "Compiler Error C2180" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2180" +ms.date: 11/04/2016 f1_keywords: ["C2180"] helpviewer_keywords: ["C2180"] -ms.assetid: ea71b39e-b977-48a7-b7bd-af68ef5e263b --- # Compiler Error C2180 From eccf691d24eac56de752d27c4d701013fe87324d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 17 Jul 2025 13:27:26 -0700 Subject: [PATCH 0429/1799] small updates --- .../tutorials/build-insights-template-view.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index c9a57fe3234..659a9f8c91f 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -111,7 +111,7 @@ Template instantiation time collection is off by default to minimize build overh ## Run Build Insights to get template instantiation data -From the main menu, select **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in Solution Explorer and select **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project. +From the main menu, select **Build** > **Run Build Insights on Solution** > **Rebuild**. You can also right-click a project in Solution Explorer and select **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project. :::image type="content" source="./media/build-insights-rebuild-project.png" alt-text="Screenshot of the main menu with Run Build Insights on Selection > Rebuild selected."::: @@ -126,7 +126,7 @@ The **Templates** view lists the template instantiations that contributed signif - **Translation Unit** shows the source files where each template instantiation happens. Different files can cause the same template instantiation if they include the same header with the template definition. - **Instantiation File Name** shows where the template is defined. -:::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations."::: +:::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations." lightbox="./media/templates-view-before-fix.png"::: The Templates view shows two template instantiations of struct S3 taking most (79.448 percent) of the build time. The Translation Unit column shows that both LargeValue.cpp and SmallValue.cpp are affected. The build time is 4.066 seconds. :::image-end::: @@ -136,7 +136,7 @@ The Templates view shows two template instantiations of struct S3 taking most (7 ### Understanding Templates view results -When interpreting Templates view results, consider the following: +To interpret the **Templates** view results: - **Empty view**: If nothing shows up in the **Templates** view, template instantiations don't dominate your build time. That's good news because your templates aren't a build bottleneck. - **Duplicate instantiations**: If the same template instantiation appears multiple times across different translation units, different source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. @@ -145,9 +145,9 @@ When interpreting Templates view results, consider the following: ## Improve build time by optimizing template instantiations -In this example, two template instantiations of `S3` take 79 percent of the build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` cause this template instantiation. +In the example, two template instantiations of `S3` take 79 percent of the build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` cause this template instantiation. -Because the **Instantiation File Name** and the **Specialization Name** are the same for both entries, there's one expensive template instantiation that affects both source files. That's why the time for each of the two template instantiations is roughly equal. Including `Templates.h` in both source files causes one template instantiation to add significant time to the build. +The **Instantiation File Name** and the **Specialization Name** are the same for both entries, which means one expensive template instantiation that affects both source files. That's why the time for each of the two template instantiations is roughly equal. Including `Templates.h` in both source files causes one template instantiation to add significant time to the build. From the **Specialization Name** column, the expensive instantiation is `S3>`, which is instantiated in this code in `Templates.h`: @@ -158,7 +158,7 @@ inline size_t LargeValue() }; ``` -Here are three main ways to decrease the cost of template instantiations. +There are three main ways to decrease the cost of template instantiations. ### Remove unused templates @@ -170,7 +170,7 @@ Consider removing include directives that bring in unnecessary template instanti In this example, rely on the third approach: move the definition that causes the expensive template instantiation to a source file. -Because `LargeValue.cpp` is the only source file that calls `LargeValue()`, move the definition to `LargeValue.cpp`. This change prevents the template instantiation from happening in every translation unit that includes `Templates.h`. Remove the current definition of `LargeValue()` from `Templates.h` and replace it with a declaration: +Because `LargeValue.cpp` is the only source file that calls `LargeValue()`, move the definition to `LargeValue.cpp`. This change prevents the template instantiation from happening in every file that includes `Templates.h`. Remove the current definition of `LargeValue()` from `Templates.h` and replace it with a declaration: ```cpp size_t LargeValue(); @@ -189,7 +189,7 @@ Rebuild the project and run Build Insights again from the main menu. Select **Bu The build time decreases. While the template instantiation of `S3` still contributes to the build time, including only necessary template instantiations cuts the build time nearly in half. The count of `S3` instantiations is now one instead of two. -:::image type="complex" source="./media/templates-view-after-fix.png" alt-text="Screenshot of the Build Insights Templates view after optimization. The view shows reduced template instantiation time."::: +:::image type="complex" source="./media/templates-view-after-fix.png" alt-text="Screenshot of the Build Insights Templates view after optimization. The view shows reduced template instantiation time." lightbox="./media/templates-view-after-fix.png"::: The Templates view now shows only one instantiation of S3 instead of two, and the total build time is significantly less at 3.152 seconds. :::image-end::: @@ -208,7 +208,7 @@ For more advanced template optimization techniques, see [Build Throughput Series ## Tips - Use **File** > **Save As** to save the ETL file to a more permanent location to keep a record of the build time information. You can then compare it to future builds to see how your changes are improving things. -- If you close the Build Insights window, reopen it by finding the `.etl` file either where you specified it should be saved, or in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. +- If you close the Build Insights window, reopen it by finding the *dateandtime*.etl file either where you specified it should be saved, or in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. - Drag columns to change the order of the columns. For example, you might want to move the **Wall Time Responsibility** column to the first column. You can add or hide columns by right-clicking the column header and selecting or deselecting the columns you want. - The **Templates** view has a filter box to help you find a specific template instantiation. It does partial matches on the name you provide. From 462cb9338103e556a8827c090a27e2c6cc79947b Mon Sep 17 00:00:00 2001 From: Raymond Chen Date: Thu, 17 Jul 2025 14:43:37 -0700 Subject: [PATCH 0430/1799] Simplify Callback overloads by using template parameter packs (#5983) The event.h definition now uses template parameter packs, so update the documentation to match. --- docs/cppcx/wrl/callback-function-wrl.md | 184 +----------------------- 1 file changed, 4 insertions(+), 180 deletions(-) diff --git a/docs/cppcx/wrl/callback-function-wrl.md b/docs/cppcx/wrl/callback-function-wrl.md index 777ea551af4..dd804d4df02 100644 --- a/docs/cppcx/wrl/callback-function-wrl.md +++ b/docs/cppcx/wrl/callback-function-wrl.md @@ -20,166 +20,14 @@ template< ComPtr Callback( TCallback callback ); -template< - typename TDelegateInterface, - typename TCallbackObject -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)() -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5, - typename TArg6 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5, - TArg6) -); template< typename TDelegateInterface, typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5, - typename TArg6, - typename TArg7 + typename... TArgs > ComPtr Callback( _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5, - TArg6, - TArg7) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5, - typename TArg6, - typename TArg7, - typename TArg8 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5, - TArg6, - TArg7, - TArg8) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5, - typename TArg6, - typename TArg7, - typename TArg8, - typename TArg9 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5, - TArg6, - TArg7, - TArg8, - TArg9) + _In_ HRESULT (TCallbackObject::* method)(TArgs...) ); ``` @@ -194,32 +42,8 @@ A template parameter that specifies the type of an object that represents an obj *TCallbackObject*
A template parameter that specifies the object whose member function is the method to call when an event occurs. -*TArg1*
-A template parameter that specifies the type of the first callback method argument. - -*TArg2*
-A template parameter that specifies the type of the second callback method argument. - -*TArg3*
-A template parameter that specifies the type of the third callback method argument. - -*TArg4*
-A template parameter that specifies the type of the fourth callback method argument. - -*TArg5*
-A template parameter that specifies the type of the fifth callback method argument. - -*TArg6*
-A template parameter that specifies the type of the sixth callback method argument. - -*TArg7*
-A template parameter that specifies the type of the seventh callback method argument. - -*TArg8*
-A template parameter that specifies the type of the eighth callback method argument. - -*TArg9*
-A template parameter that specifies the type of the ninth callback method argument. +*TArgs*
+A template parameter pack that specifies the types of the callback method arguments. *callback*
An object that represents the callback object and its member function. From ac99b48ed08dc36fcb2bd0af5bc28630c6064d85 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 17 Jul 2025 17:46:12 -0700 Subject: [PATCH 0431/1799] add metadata --- docs/build-insights/tutorials/build-insights-template-view.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index c9a57fe3234..0a4e4850e5f 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -1,9 +1,10 @@ --- title: "Troubleshoot template instantiation impact on build time" description: "Tutorial for how to use Build Insights template view to analyze and optimize the impact of template instantiations on build time in your C++ projects." -ms.date: 07/14/2025 +ms.date: 07/17/2025 helpviewer_keywords: ["C++ Build Insights", "template instantiation analysis", "build time analysis"] ms.topic: troubleshooting-general +ai-usage: ai-assisted --- # Troubleshoot template instantiation impact on build time From 369242ac77590e7de27ff3aac1978e6a64c20db3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 16:09:49 +0800 Subject: [PATCH 0432/1799] Clean up links to removed "What's new for the Microsoft C++ docs" article --- docs/overview/what-s-new-for-cpp-2017.md | 2 +- docs/overview/what-s-new-for-cpp-2019.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overview/what-s-new-for-cpp-2017.md b/docs/overview/what-s-new-for-cpp-2017.md index ada04edf007..d30dc9febd5 100644 --- a/docs/overview/what-s-new-for-cpp-2017.md +++ b/docs/overview/what-s-new-for-cpp-2017.md @@ -10,7 +10,7 @@ ms.custom: intro-whats-new Visual Studio 2017 brings many updates and fixes to the C++ environment. We've fixed over 250 bugs and reported issues in the compiler and tools. Many were submitted by customers through the [Report a Problem and Provide a Suggestion](/visualstudio/ide/how-to-report-a-problem-with-visual-studio?view=vs-2017&preserve-view=true) options under **Send Feedback**. Thank you for reporting bugs! -For more information on what's new in all of Visual Studio, see [What's new in Visual Studio 2017](/visualstudio/ide/whats-new-visual-studio-2017?view=vs-2017&preserve-view=true). For information on what's new for C++ in Visual Studio 2019, see [What's new for C++ in Visual Studio 2019](what-s-new-for-visual-cpp-in-visual-studio.md?preserve-view=true&view=msvc-160). For information on what's new for C++ in Visual Studio 2015 and earlier versions, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). For information about what's new in the C++ docs, see [Microsoft C++ docs: What's new](whats-new-cpp-docs.md). +For more information on what's new in all of Visual Studio, see [What's new in Visual Studio 2017](/visualstudio/ide/whats-new-visual-studio-2017?view=vs-2017&preserve-view=true). For information on what's new for C++ in Visual Studio 2019, see [What's new for C++ in Visual Studio 2019](what-s-new-for-visual-cpp-in-visual-studio.md?preserve-view=true&view=msvc-160). For information on what's new for C++ in Visual Studio 2015 and earlier versions, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). ## Visual Studio 2017 C++ compiler diff --git a/docs/overview/what-s-new-for-cpp-2019.md b/docs/overview/what-s-new-for-cpp-2019.md index 78890488068..e79f0e6d590 100644 --- a/docs/overview/what-s-new-for-cpp-2019.md +++ b/docs/overview/what-s-new-for-cpp-2019.md @@ -10,7 +10,7 @@ ms.custom: intro-whats-new Visual Studio 2019 brings many updates and fixes to the Microsoft C++ environment. We've fixed many bugs and issues in the compiler and tools. Many of these issues were submitted by customers through the [Report a Problem](/visualstudio/ide/how-to-report-a-problem-with-visual-studio?view=vs-2019&preserve-view=true) and [Provide a Suggestion](https://aka.ms/feedback/suggest?space=62) options under **Send Feedback**. Thank you for reporting bugs! -For more information on what's new in all of Visual Studio, visit [What's new in Visual Studio 2019](/visualstudio/ide/whats-new-visual-studio-2019). For information on what's new for C++ in Visual Studio 2017, see [What's new for C++ in Visual Studio 2017](what-s-new-for-cpp-2017.md). For information on what's new for C++ in Visual Studio 2015 and earlier versions, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). For more information, see [Microsoft C++ docs: What's new](whats-new-cpp-docs.md). +For more information on what's new in all of Visual Studio, visit [What's new in Visual Studio 2019](/visualstudio/ide/whats-new-visual-studio-2019). For information on what's new for C++ in Visual Studio 2017, see [What's new for C++ in Visual Studio 2017](what-s-new-for-cpp-2017.md). For information on what's new for C++ in Visual Studio 2015 and earlier versions, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). ## What's new for C++ in Visual Studio version 16.11 From 55acdad9fc7495727448a9b9c1e1dba005487418 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 16:52:04 +0800 Subject: [PATCH 0433/1799] Trim all trailing spaces in "Troubleshoot template instantiation impact on build time" topic --- .../tutorials/build-insights-template-view.md | 64 +++++++++---------- 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index d4cd01924b6..d9eecb68a1b 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -21,7 +21,7 @@ The **Templates** view works like the Build Insights [Functions view](build-insi 1. Select **Modify** to change your Visual Studio installation. 1. On the **Individual components** tab, search for and select **C++ Build Insights**, then select **Close** to finish installing the component. :::image type="content" source="./media/installer-build-insights.png" alt-text="Screenshot of the Visual Studio Installer. The search box contains C++ Build Insights. The item C++ Build Insights is visible and selected."::: - + ## Overview Build Insights, integrated into Visual Studio, helps you optimize your build times--especially for large projects like AAA games. Build Insights provides analytics such as the **Templates** view, which shows the time it takes to instantiate each template and which template instantiations add the most to your build time. @@ -36,55 +36,55 @@ In this article, you create a project that shows how template instantiation affe 1. Create a header file named `Templates.h`, then replace its contents with the following code: ```cpp - #pragma once - #include - #include - - template struct S1 {}; - template using type = std::vector>; - - template struct S2 {}; - - template struct S3 {}; - - template + #pragma once + #include + #include + + template struct S1 {}; + template using type = std::vector>; + + template struct S2 {}; + + template struct S3 {}; + + template struct S3> - { - using type = S2)...>; - }; - + { + using type = S2)...>; + }; + inline size_t LargeValue() - { - return sizeof(S3>); - }; - + { + return sizeof(S3>); + }; + inline size_t SmallValue() - { - return sizeof(S1<5>); - } + { + return sizeof(S1<5>); + } ``` 1. Create a source file named `LargeValue.cpp`, then replace its contents with the following code: ```cpp - #include "Templates.h" + #include "Templates.h" size_t GetLargeValue() - { - return LargeValue(); - } + { + return LargeValue(); + } ``` 1. Replace the contents of the `TemplateAnalysis.cpp` file with the following code: ```cpp - #include "Templates.h" + #include "Templates.h" extern size_t GetLargeValue(); size_t GetSmallValue() - { - return SmallValue(); + { + return SmallValue(); } int main() @@ -107,7 +107,7 @@ Template instantiation time collection is off by default to minimize build overh :::image type="content" source="./media/tools-options-build-insights.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Build Insights > Trace Collection. The Collect Template Instantiation checkbox is selected."::: -> [!Note] +> [!Note] > Collecting template instantiation times increases build time due to the extra data collected. Only enable it when you want to analyze template instantiation bottlenecks. ## Run Build Insights to get template instantiation data From fdd565c6e39dfc418bac42848afe2464f8f69c3f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 16:56:05 +0800 Subject: [PATCH 0434/1799] Remove superfluous semicolons and format code snippets in "Troubleshoot template instantiation impact on build time" topic --- .../build-insights/tutorials/build-insights-template-view.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index d9eecb68a1b..c70f5afc50a 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -37,6 +37,7 @@ In this article, you create a project that shows how template instantiation affe ```cpp #pragma once + #include #include @@ -56,7 +57,7 @@ In this article, you create a project that shows how template instantiation affe inline size_t LargeValue() { return sizeof(S3>); - }; + } inline size_t SmallValue() { @@ -156,7 +157,7 @@ From the **Specialization Name** column, the expensive instantiation is `S3>); -}; +} ``` There are three main ways to decrease the cost of template instantiations. From e4f4427a0e5feb2e4aeeb72f7bb15862a59e8e3a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 17:03:49 +0800 Subject: [PATCH 0435/1799] Remove erroneous mentions of `SmallValue.cpp` in "Troubleshoot template instantiation impact on build time" topic --- docs/build-insights/tutorials/build-insights-template-view.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index c70f5afc50a..9eff60080bc 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -129,7 +129,7 @@ The **Templates** view lists the template instantiations that contributed signif - **Instantiation File Name** shows where the template is defined. :::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations." lightbox="./media/templates-view-before-fix.png"::: -The Templates view shows two template instantiations of struct S3 taking most (79.448 percent) of the build time. The Translation Unit column shows that both LargeValue.cpp and SmallValue.cpp are affected. The build time is 4.066 seconds. +The Templates view shows two template instantiations of struct S3 taking most (79.448 percent) of the build time. The Translation Unit column shows that both LargeValue.cpp and TemplateAnalysis.cpp are affected. The build time is 4.066 seconds. :::image-end::: - Sort by **Time** to find the templates that take the longest to instantiate. @@ -147,7 +147,7 @@ To interpret the **Templates** view results: ## Improve build time by optimizing template instantiations -In the example, two template instantiations of `S3` take 79 percent of the build time. The **Translation Unit** column shows that both `SmallValue.cpp` and `LargeValue.cpp` cause this template instantiation. +In the example, two template instantiations of `S3` take 79 percent of the build time. The **Translation Unit** column shows that both `LargeValue.cpp` and `TemplateAnalysis.cpp` cause this template instantiation. The **Instantiation File Name** and the **Specialization Name** are the same for both entries, which means one expensive template instantiation that affects both source files. That's why the time for each of the two template instantiations is roughly equal. Including `Templates.h` in both source files causes one template instantiation to add significant time to the build. From e22eb527be6983b45e43ae85884aed8b086f5870 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 17:06:33 +0800 Subject: [PATCH 0436/1799] Fix wrong build time value for image in "Troubleshoot template instantiation impact on build time" topic --- docs/build-insights/tutorials/build-insights-template-view.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index 9eff60080bc..e8c26762e61 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -129,7 +129,7 @@ The **Templates** view lists the template instantiations that contributed signif - **Instantiation File Name** shows where the template is defined. :::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations." lightbox="./media/templates-view-before-fix.png"::: -The Templates view shows two template instantiations of struct S3 taking most (79.448 percent) of the build time. The Translation Unit column shows that both LargeValue.cpp and TemplateAnalysis.cpp are affected. The build time is 4.066 seconds. +The Templates view shows two template instantiations of struct S3 taking most (79.448 percent) of the build time. The Translation Unit column shows that both LargeValue.cpp and TemplateAnalysis.cpp are affected. The build time is 4.966 seconds. :::image-end::: - Sort by **Time** to find the templates that take the longest to instantiate. From ecb27fed0029ca99ab32380d743b048c963e2b50 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 17:11:45 +0800 Subject: [PATCH 0437/1799] Nits for "Troubleshoot template instantiation impact on build time" topic --- docs/build-insights/tutorials/build-insights-template-view.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md index e8c26762e61..47382cff0bd 100644 --- a/docs/build-insights/tutorials/build-insights-template-view.md +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -108,7 +108,7 @@ Template instantiation time collection is off by default to minimize build overh :::image type="content" source="./media/tools-options-build-insights.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Build Insights > Trace Collection. The Collect Template Instantiation checkbox is selected."::: -> [!Note] +> [!NOTE] > Collecting template instantiation times increases build time due to the extra data collected. Only enable it when you want to analyze template instantiation bottlenecks. ## Run Build Insights to get template instantiation data @@ -232,4 +232,4 @@ For more advanced template optimization techniques, see [Build Throughput Series - [Troubleshoot header file impact on build time](build-insights-included-files-view.md) - [Troubleshoot function inlining on build time](build-insights-function-view.md) - [Build Insights now available in Visual Studio 2022](https://devblogs.microsoft.com/cppblog/build-insights-now-available-in-visual-studio-2022) -- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming) \ No newline at end of file +- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming) From 0d52b228b7cea0b234dd55d2fe9b0b074cfbed5f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 17:40:07 +0800 Subject: [PATCH 0438/1799] Fix invalid `std::` prefix for `public` keyword in `value_compare` class reference --- docs/standard-library/value-compare-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/value-compare-class.md b/docs/standard-library/value-compare-class.md index 9777faa45ae..b4cc44b5dbf 100644 --- a/docs/standard-library/value-compare-class.md +++ b/docs/standard-library/value-compare-class.md @@ -14,7 +14,7 @@ Provides a function object that can compare the elements of a hash_map by compar ```cpp class value_compare - : std::public binary_function + : public binary_function { public: bool operator()( From 0c929e06fb010132c9f2977f399d7ca8d1f782e9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 17:45:07 +0800 Subject: [PATCH 0439/1799] Add backticks in `value_compare` class reference --- docs/standard-library/value-compare-class.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/standard-library/value-compare-class.md b/docs/standard-library/value-compare-class.md index b4cc44b5dbf..c0878dac103 100644 --- a/docs/standard-library/value-compare-class.md +++ b/docs/standard-library/value-compare-class.md @@ -6,9 +6,9 @@ f1_keywords: ["hash_map/std::value_compare"] helpviewer_keywords: ["value_compare class"] ms.assetid: c306c5b9-3505-4357-aa6b-216451b951ed --- -# value_compare Class +# `value_compare` Class -Provides a function object that can compare the elements of a hash_map by comparing the values of their keys to determine their relative order in the hash_map. +Provides a function object that can compare the elements of a `hash_map` by comparing the values of their keys to determine their relative order in the `hash_map`. ## Syntax @@ -32,22 +32,22 @@ protected: ## Remarks -The comparison criteria provided by value_compare between `value_types` of whole elements contained by a hash_map is induced from a comparison between the keys of the respective elements by the auxiliary class construction. The member function operator uses the object `comp` of type `key_compare` stored in the function object provided by value_compare to compare the sort-key components of two elements. +The comparison criteria provided by `value_compare` between `value_types` of whole elements contained by a `hash_map` is induced from a comparison between the keys of the respective elements by the auxiliary class construction. The member function operator uses the object `comp` of type `key_compare` stored in the function object provided by `value_compare` to compare the sort-key components of two elements. -For hash_sets and hash_multisets, which are simple containers where the key values are identical to the element values, value_compare is equivalent to `key_compare`; for hash_maps and hash_multimaps they are not, because the value of the type `pair` elements is not identical to the value of the element's key. +For `hash_set`s and `hash_multiset`s, which are simple containers where the key values are identical to the element values, `value_compare` is equivalent to `key_compare`; for `hash_map`s and `hash_multimap`s they are not, because the value of the type `pair` elements is not identical to the value of the element's key. ## Example -See the example for [hash_map::value_comp](../standard-library/hash-map-class.md#value_comp) for an example of how to declare and use value_compare. +See the example for [`hash_map::value_comp`](../standard-library/hash-map-class.md#value_comp) for an example of how to declare and use `value_compare`. ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** stdext +**Namespace:** `stdext` ## See also -[binary_function Struct](../standard-library/binary-function-struct.md)\ +[`binary_function` Struct](../standard-library/binary-function-struct.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)\ [C++ Standard Library Reference](../standard-library/cpp-standard-library-reference.md) From 02037fbae27755372bc332bd89ef1da14a1f44b3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 17:47:23 +0800 Subject: [PATCH 0440/1799] Simplify redundant relative links in `value_compare` class reference --- docs/standard-library/value-compare-class.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/value-compare-class.md b/docs/standard-library/value-compare-class.md index c0878dac103..bf76bbbc0ba 100644 --- a/docs/standard-library/value-compare-class.md +++ b/docs/standard-library/value-compare-class.md @@ -38,7 +38,7 @@ For `hash_set`s and `hash_multiset`s, which are simple containers where the key ## Example -See the example for [`hash_map::value_comp`](../standard-library/hash-map-class.md#value_comp) for an example of how to declare and use `value_compare`. +See the example for [`hash_map::value_comp`](hash-map-class.md#value_comp) for an example of how to declare and use `value_compare`. ## Requirements @@ -48,6 +48,6 @@ See the example for [`hash_map::value_comp`](../standard-library/hash-map-class. ## See also -[`binary_function` Struct](../standard-library/binary-function-struct.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)\ -[C++ Standard Library Reference](../standard-library/cpp-standard-library-reference.md) +[`binary_function` Struct](binary-function-struct.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md)\ +[C++ Standard Library Reference](cpp-standard-library-reference.md) From 2a713d653de1655f523f468fd3963f5c672dde5b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 17:48:05 +0800 Subject: [PATCH 0441/1799] Update metadata in `value_compare` class reference --- docs/standard-library/value-compare-class.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/value-compare-class.md b/docs/standard-library/value-compare-class.md index bf76bbbc0ba..18f66856546 100644 --- a/docs/standard-library/value-compare-class.md +++ b/docs/standard-library/value-compare-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: value_compare Class" title: "value_compare Class" -ms.date: "11/04/2016" +description: "Learn more about: value_compare Class" +ms.date: 11/04/2016 f1_keywords: ["hash_map/std::value_compare"] helpviewer_keywords: ["value_compare class"] -ms.assetid: c306c5b9-3505-4357-aa6b-216451b951ed --- # `value_compare` Class From 08e76a74a43d04d8a0be03a857d27f9a31e48878 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 18:11:24 +0800 Subject: [PATCH 0442/1799] Convert Project build errors and warnings list into a table --- ...oject-build-errors-and-warnings-prjxxxx.md | 84 ++++++++++--------- 1 file changed, 44 insertions(+), 40 deletions(-) diff --git a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md index 8622e006449..5f2b64305df 100644 --- a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md +++ b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md @@ -12,49 +12,53 @@ This section is a reference to the errors generated by the Project build tools. ## Project build errors -[Project build error PRJ0002](project-build-error-prj0002.md) \ -[Project build error PRJ0003](project-build-error-prj0003.md) \ -[Project build error PRJ0004](project-build-error-prj0004.md) \ -[Project build error PRJ0005](project-build-error-prj0005.md) \ -[Project build error PRJ0006](project-build-error-prj0006.md) \ -[Project build error PRJ0007](project-build-error-prj0007.md) \ -[Project build error PRJ0008](project-build-error-prj0008.md) \ -[Project build error PRJ0009](project-build-error-prj0009.md) \ -[Project build error PRJ0013](project-build-error-prj0013.md) \ -[Project build error PRJ0014](project-build-error-prj0014.md) \ -[Project build error PRJ0015](project-build-error-prj0015.md) \ -[Project build error PRJ0016](project-build-error-prj0016.md) \ -[Project build error PRJ0017](project-build-error-prj0017.md) \ -[Project build error PRJ0019](project-build-error-prj0019.md) \ -[Project build error PRJ0020](project-build-error-prj0020.md) \ -[Project build error PRJ0021](project-build-error-prj0021.md) \ -[Project build error PRJ0022](project-build-error-prj0022.md) \ -[Project build error PRJ0023](project-build-error-prj0023.md) \ -[Project build error PRJ0024](project-build-error-prj0024.md) \ -[Project build error PRJ0025](project-build-error-prj0025.md) \ -[Project build error PRJ0026](project-build-error-prj0026.md) \ -[Project build error PRJ0027](project-build-error-prj0027.md) \ -[Project build error PRJ0028](project-build-error-prj0028.md) \ -[Project build error PRJ0030](project-build-error-prj0030.md) \ -[Project build error PRJ0031](project-build-error-prj0031.md) \ -[Project build error PRJ0032](project-build-error-prj0032.md) \ -[Project build error PRJ0033](project-build-error-prj0033.md) \ -[Project build error PRJ0034](project-build-error-prj0034.md) \ -[Project build error PRJ0035](project-build-error-prj0035.md) \ -[Project build error PRJ0036](project-build-error-prj0036.md) \ -[Project build error PRJ0040](project-build-error-prj0040.md) \ -[Project build error PRJ0044](project-build-error-prj0044.md) \ -[Project build error PRJ0046](project-build-error-prj0046.md) \ -[Project build error PRJ0047](project-build-error-prj0047.md) \ -[Project build error PRJ0050](project-build-error-prj0050.md) +| Error | Message | +|--|--| +| [Project build error PRJ0002](project-build-error-prj0002.md) | error result returned from '*command line*'. | +| [Project build error PRJ0003](project-build-error-prj0003.md) | Error spawning '*command line*'. | +| [Project build error PRJ0004](project-build-error-prj0004.md) | Could not generate command line for the '*tool*' tool. | +| [Project build error PRJ0005](project-build-error-prj0005.md) | Unable to create a temporary file in directory 'directory'. | +| [Project build error PRJ0006](project-build-error-prj0006.md) | Could not open the temporary file 'file'. Make sure the file exists and that the directory is not write-protected. | +| [Project build error PRJ0007](project-build-error-prj0007.md) | Could not create output directory 'directory'. | +| [Project build error PRJ0008](project-build-error-prj0008.md) | Could not delete file 'file'. | +| [Project build error PRJ0009](project-build-error-prj0009.md) | Build log could not be opened for writing. | +| [Project build error PRJ0013](project-build-error-prj0013.md) | System resource could be critically low. Unable to create a pipe required to launch a build. | +| [Project build error PRJ0014](project-build-error-prj0014.md) | The job object used to control the spawned processes has failed. The build cannot continue. | +| [Project build error PRJ0015](project-build-error-prj0015.md) | The NULL device is missing from your system. We are unable to launch a build. | +| [Project build error PRJ0016](project-build-error-prj0016.md) | The user's security settings prevent the process from being created. These settings are required for building. | +| [Project build error PRJ0017](project-build-error-prj0017.md) | The current working directory is invalid. | +| [Project build error PRJ0019](project-build-error-prj0019.md) | A tool returned an error code from | +| [Project build error PRJ0020](project-build-error-prj0020.md) | Tool '*tool*', Property '*property*' contains invalid file name '*file*'. | +| [Project build error PRJ0021](project-build-error-prj0021.md) | Tool '*tool*', Property '*property*' contains invalid file name. | +| [Project build error PRJ0022](project-build-error-prj0022.md) | Unknown Tool, Property '*property*' contains invalid file name '*file*'. | +| [Project build error PRJ0023](project-build-error-prj0023.md) | Tool '*tool*', Unknown Property contains invalid file name '*file*'. | +| [Project build error PRJ0024](project-build-error-prj0024.md) | Unicode path '*path*' could not be translated to user's ANSI code page. | +| [Project build error PRJ0025](project-build-error-prj0025.md) | Batch file '*file*' contains Unicode contents that could not be translated to user's ANSI code page. | +| [Project build error PRJ0026](project-build-error-prj0026.md) | Response file '*file*' contains Unicode contents that could not be translated to user's ANSI code page. | +| [Project build error PRJ0027](project-build-error-prj0027.md) | Unicode log message 'contents' contains content that could not be translated to the user's ANSI code page. | +| [Project build error PRJ0028](project-build-error-prj0028.md) | Temporary file 'file' contains Unicode contents that could not be translated to user's ANSI code page. | +| [Project build error PRJ0030](project-build-error-prj0030.md) | Macro expansion error. Evaluate recursion exceeded 32 levels for $(macro). | +| [Project build error PRJ0031](project-build-error-prj0031.md) | The 'Outputs' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. | +| [Project build error PRJ0032](project-build-error-prj0032.md) | The 'Outputs' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. | +| [Project build error PRJ0033](project-build-error-prj0033.md) | The 'Additional Dependencies' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. | +| [Project build error PRJ0034](project-build-error-prj0034.md) | The 'Additional Dependencies' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. | +| [Project build error PRJ0035](project-build-error-prj0035.md) | XML file '*file*' contains Unicode contents that could not be translated to user's ANSI code page. | +| [Project build error PRJ0036](project-build-error-prj0036.md) | The 'Additional Files' property for the Web Deployment Tool contained an invalid entry. | +| [Project build error PRJ0040](project-build-error-prj0040.md) | Internal error on build. Cannot continue. Please reload project and try again. | +| [Project build error PRJ0044](project-build-error-prj0044.md) | The 'Additional Dependencies' property for custom build rule 'rule' assigned to file 'file' is invalid. The property contained 'string' which evaluates to 'value'. | +| [Project build error PRJ0046](project-build-error-prj0046.md) | Could not spawn command line because the one specified was empty. | +| [Project build error PRJ0047](project-build-error-prj0047.md) | Could not resume the suspended process. The build has failed. | +| [Project build error PRJ0050](project-build-error-prj0050.md) | Failed to register output. Please ensure you have the appropriate permissions to modify the registry. | ## Project build warnings -[Project build warning PRJ0018](project-build-warning-prj0018.md) \ -[Project build warning PRJ0029](project-build-warning-prj0029.md) \ -[Project build warning PRJ0041](project-build-warning-prj0041.md) \ -[Project build warning PRJ0042](project-build-warning-prj0042.md) \ -[Project build warning PRJ0049](project-build-warning-prj0049.md) +| Warning | Message | +|--|--| +| [Project build warning PRJ0018](project-build-warning-prj0018.md) | The following environment variables were not found: | +| [Project build warning PRJ0029](project-build-warning-prj0029.md) | The 'Outputs' property for the project-level custom build step is not set. The custom build step will be skipped. | +| [Project build warning PRJ0041](project-build-warning-prj0041.md) | Cannot find missing dependency 'dependency' for file 'file'. Your project may still build, but may continue to appear out of date until this file is found. | +| [Project build warning PRJ0042](project-build-warning-prj0042.md) | The 'Outputs' property for the custom build step for file '*file*' is not set. The custom build step will be skipped. | +| [Project build warning PRJ0049](project-build-warning-prj0049.md) | Referenced target '\' requires .NET Framework \ and will fail to run on this project's target framework | ## See also From 847110c8aa367b0bd4005e9db942fba7f879e650 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 18:12:16 +0800 Subject: [PATCH 0443/1799] Simplify superfluous relative links in "Project build errors and warnings (PRJxxxx)" --- .../tool-errors/project-build-errors-and-warnings-prjxxxx.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md index 5f2b64305df..05831c0e46f 100644 --- a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md +++ b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md @@ -8,7 +8,7 @@ ms.assetid: 79d223ed-986a-4536-8299-aec8356b449c This section is a reference to the errors generated by the Project build tools. Project build errors and warnings have the form PRJ*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Project build errors From e7454fcc10b781f7ae74e5d76e827cd56d069939 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 18:12:42 +0800 Subject: [PATCH 0444/1799] Remove space before escape in "Project build errors and warnings (PRJxxxx)" --- .../tool-errors/project-build-errors-and-warnings-prjxxxx.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md index 05831c0e46f..7a4b89b0e8f 100644 --- a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md +++ b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md @@ -62,5 +62,5 @@ This section is a reference to the errors generated by the Project build tools. ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [Visual Studio projects | C++](../../build/creating-and-managing-visual-cpp-projects.md) From 730c53d95648dd84be8a8f8839901131b77e195e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 18:14:36 +0800 Subject: [PATCH 0445/1799] Update metadata in "Project build errors and warnings (PRJxxxx)" --- .../tool-errors/project-build-errors-and-warnings-prjxxxx.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md index 7a4b89b0e8f..e05ebacd66b 100644 --- a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md +++ b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: Project build errors and warnings (PRJxxxx)" title: "Project build errors and warnings" -ms.date: "04/16/2019" -ms.assetid: 79d223ed-986a-4536-8299-aec8356b449c +description: "Learn more about: Project build errors and warnings (PRJxxxx)" +ms.date: 04/16/2019 --- # Project build errors and warnings (PRJxxxx) From 3726539c99b3c1acf8eabda0a53d01a5a22f3a46 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 18:33:02 +0800 Subject: [PATCH 0446/1799] Wrap multiple function prototypes in a line --- docs/cppcx/platform-intptr-value-class.md | 8 ++++++-- docs/cppcx/platform-sizet-value-class.md | 3 ++- docs/mfc/reference/cmonthcalctrl-class.md | 6 ++++-- docs/mfc/reference/colesafearray-class.md | 9 ++++++--- docs/mfc/reference/cricheditctrl-class.md | 12 ++++++++---- docs/mfc/reference/cspinbuttonctrl-class.md | 3 ++- docs/mfc/reference/cstatusbar-class.md | 3 ++- docs/mfc/reference/cwinapp-class.md | 6 ++++-- docs/mfc/reference/cwnd-class.md | 6 ++++-- 9 files changed, 38 insertions(+), 18 deletions(-) diff --git a/docs/cppcx/platform-intptr-value-class.md b/docs/cppcx/platform-intptr-value-class.md index b08b50209b5..f3d7aecfde8 100644 --- a/docs/cppcx/platform-intptr-value-class.md +++ b/docs/cppcx/platform-intptr-value-class.md @@ -43,7 +43,9 @@ Initializes a new instance of an IntPtr with the specified value. ### Syntax ```cpp -IntPtr( __int64 handle-or-pointer ); IntPtr( void* value ); IntPtr( int 32-bit_value ); +IntPtr( __int64 handle-or-pointer ); +IntPtr( void* value ); +IntPtr( int 32-bit_value ); ``` ### Parameters @@ -58,7 +60,9 @@ Converts the specified parameter to an IntPtr or a pointer to an IntPtr value. ### Syntax ```cpp -static IntPtr::operator IntPtr( void* value1); static IntPtr::operator IntPtr( int value2); static IntPtr::operator void*( IntPtr value3 ); +static IntPtr::operator IntPtr( void* value1); +static IntPtr::operator IntPtr( int value2); +static IntPtr::operator void*( IntPtr value3 ); ``` ### Parameters diff --git a/docs/cppcx/platform-sizet-value-class.md b/docs/cppcx/platform-sizet-value-class.md index fe4da84ea6a..54743ab531c 100644 --- a/docs/cppcx/platform-sizet-value-class.md +++ b/docs/cppcx/platform-sizet-value-class.md @@ -40,7 +40,8 @@ Initializes a new instance of SizeT with the specified value. ### Syntax ```cpp -SizeT( uint32 value1 ); SizeT( void* value2 ); +SizeT( uint32 value1 ); +SizeT( void* value2 ); ``` ### Parameters diff --git a/docs/mfc/reference/cmonthcalctrl-class.md b/docs/mfc/reference/cmonthcalctrl-class.md index 8b9469c32a1..e9ce4d517d5 100644 --- a/docs/mfc/reference/cmonthcalctrl-class.md +++ b/docs/mfc/reference/cmonthcalctrl-class.md @@ -304,7 +304,8 @@ The next code example reports which view the month calendar control currently di Retrieves the system time as indicated by the currently-selected date. ``` -BOOL GetCurSel(COleDateTime& refDateTime) const; BOOL GetCurSel(CTime& refDateTime) const; +BOOL GetCurSel(COleDateTime& refDateTime) const; +BOOL GetCurSel(CTime& refDateTime) const; BOOL GetCurSel(LPSYSTEMTIME pDateTime) const; ``` @@ -595,7 +596,8 @@ In MFC's implementation of `GetSelRange`, you can specify `COleDateTime` usage, Retrieves the date information for the date specified as "today" for a month calendar control. ``` -BOOL GetToday(COleDateTime& refDateTime) const; BOOL GetToday(COleDateTime& refDateTime) const; +BOOL GetToday(COleDateTime& refDateTime) const; +BOOL GetToday(COleDateTime& refDateTime) const; BOOL GetToday(LPSYSTEMTIME pDateTime) const; ``` diff --git a/docs/mfc/reference/colesafearray-class.md b/docs/mfc/reference/colesafearray-class.md index 1efbd04b7f8..e2af72eeba5 100644 --- a/docs/mfc/reference/colesafearray-class.md +++ b/docs/mfc/reference/colesafearray-class.md @@ -554,11 +554,14 @@ A brief description of each operator follows: This operator compares two arrays (`SAFEARRAY`, `VARIANT`, `COleVariant`, or `COleSafeArray` arrays) and returns nonzero if they are equal; otherwise 0. ``` -BOOL operator==(const SAFEARRAY& saSrc) const; BOOL operator==(LPCSAFEARRAY pSrc) const; +BOOL operator==(const SAFEARRAY& saSrc) const; +BOOL operator==(LPCSAFEARRAY pSrc) const; -BOOL operator==(const COleSafeArray& saSrc) const; BOOL operator==(const VARIANT& varSrc) const; +BOOL operator==(const COleSafeArray& saSrc) const; +BOOL operator==(const VARIANT& varSrc) const; -BOOL operator==(LPCVARIANT pSrc) const; BOOL operator==(const COleVariant& varSrc) const; +BOOL operator==(LPCVARIANT pSrc) const; +BOOL operator==(const COleVariant& varSrc) const; ``` ### Remarks diff --git a/docs/mfc/reference/cricheditctrl-class.md b/docs/mfc/reference/cricheditctrl-class.md index 95466b4037c..b4c13c12615 100644 --- a/docs/mfc/reference/cricheditctrl-class.md +++ b/docs/mfc/reference/cricheditctrl-class.md @@ -553,7 +553,8 @@ For more information, see [`EM_POSFROMCHAR`](/windows/win32/Controls/em-posfromc Gets the default character formatting attributes of this `CRichEditCtrl` object. ``` -DWORD GetDefaultCharFormat(CHARFORMAT& cf) const; DWORD GetDefaultCharFormat(CHARFORMAT2& cf) const; +DWORD GetDefaultCharFormat(CHARFORMAT& cf) const; +DWORD GetDefaultCharFormat(CHARFORMAT2& cf) const; ``` ### Parameters @@ -759,7 +760,8 @@ A combination of the current option flag values. For a list of these values, see Gets the paragraph formatting attributes of the current selection. ``` -DWORD GetParaFormat(PARAFORMAT& pf) const; DWORD GetParaFormat(PARAFORMAT2& pf) const; +DWORD GetParaFormat(PARAFORMAT& pf) const; +DWORD GetParaFormat(PARAFORMAT2& pf) const; ``` ### Parameters @@ -892,7 +894,8 @@ For more information, see [`EM_EXGETSEL`](/windows/win32/Controls/em-exgetsel) m Gets the character formatting attributes of the current selection. ``` -DWORD GetSelectionCharFormat(CHARFORMAT& cf) const; DWORD GetSelectionCharFormat(CHARFORMAT2& cf) const; +DWORD GetSelectionCharFormat(CHARFORMAT& cf) const; +DWORD GetSelectionCharFormat(CHARFORMAT2& cf) const; ``` ### Parameters @@ -951,7 +954,8 @@ For more information, see [`EM_SELECTIONTYPE`](/windows/win32/Controls/em-select Retrieves the text from the current selection in this `CRichEditCtrl` object. ``` -long GetSelText(LPSTR lpBuf) const; CString GetSelText() const; +long GetSelText(LPSTR lpBuf) const; +CString GetSelText() const; ``` ### Parameters diff --git a/docs/mfc/reference/cspinbuttonctrl-class.md b/docs/mfc/reference/cspinbuttonctrl-class.md index ccd132b2396..9a67088c71a 100644 --- a/docs/mfc/reference/cspinbuttonctrl-class.md +++ b/docs/mfc/reference/cspinbuttonctrl-class.md @@ -201,7 +201,8 @@ A pointer to the current buddy window. Retrieves the current position of a spin button control. ``` -int GetPos() const; int GetPos32(LPBOOL lpbError = NULL) const; +int GetPos() const; +int GetPos32(LPBOOL lpbError = NULL) const; ``` ### Parameters diff --git a/docs/mfc/reference/cstatusbar-class.md b/docs/mfc/reference/cstatusbar-class.md index ff4116ac648..8cfdfc23d96 100644 --- a/docs/mfc/reference/cstatusbar-class.md +++ b/docs/mfc/reference/cstatusbar-class.md @@ -306,7 +306,8 @@ For a list of styles available for status bars, see [Create](#create). Call this member function to retrieve the text that appears in a status-bar pane. ``` -CString GetPaneText(int nIndex) const; void GetPaneText(int nIndex, CString& rString) const; +CString GetPaneText(int nIndex) const; +void GetPaneText(int nIndex, CString& rString) const; ``` ### Parameters diff --git a/docs/mfc/reference/cwinapp-class.md b/docs/mfc/reference/cwinapp-class.md index ac07d50b58a..7f45102a51a 100644 --- a/docs/mfc/reference/cwinapp-class.md +++ b/docs/mfc/reference/cwinapp-class.md @@ -896,7 +896,8 @@ Taskbar interaction means that MDI application displays the content of MDI child Loads the cursor resource named by *lpszResourceName* or specified by *nIDResource* from the current executable file. ``` -HCURSOR LoadCursor(LPCTSTR lpszResourceName) const; HCURSOR LoadCursor(UINT nIDResource) const; +HCURSOR LoadCursor(LPCTSTR lpszResourceName) const; +HCURSOR LoadCursor(UINT nIDResource) const; ``` ### Parameters @@ -926,7 +927,8 @@ Use the [LoadStandardCursor](#loadstandardcursor) or [LoadOEMCursor](#loadoemcur Loads the icon resource named by *lpszResourceName* or specified by *nIDResource* from the executable file. ``` -HICON LoadIcon(LPCTSTR lpszResourceName) const; HICON LoadIcon(UINT nIDResource) const; +HICON LoadIcon(LPCTSTR lpszResourceName) const; +HICON LoadIcon(UINT nIDResource) const; ``` ### Parameters diff --git a/docs/mfc/reference/cwnd-class.md b/docs/mfc/reference/cwnd-class.md index 7465c5223ed..7747d85ba89 100644 --- a/docs/mfc/reference/cwnd-class.md +++ b/docs/mfc/reference/cwnd-class.md @@ -1024,7 +1024,8 @@ The `CWnd`* that is returned may be temporary and shouldn't be stored for later Converts the client coordinates of a given point or rectangle on the display to screen coordinates. ```cpp -void ClientToScreen(LPPOINT lpPoint) const; void ClientToScreen(LPRECT lpRect) const; +void ClientToScreen(LPPOINT lpPoint) const; +void ClientToScreen(LPRECT lpRect) const; ``` ### Parameters @@ -10174,7 +10175,8 @@ By default, `ContinueModal` returns `FALSE` after `EndModalLoop` is called. Retu Converts the screen coordinates of a given point or rectangle on the display to client coordinates. ```cpp -void ScreenToClient(LPPOINT lpPoint) const; void ScreenToClient(LPRECT lpRect) const; +void ScreenToClient(LPPOINT lpPoint) const; +void ScreenToClient(LPRECT lpRect) const; ``` ### Parameters From 96d5bbab2d71537ed5debf856c615de10cde5c02 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 18:38:19 +0800 Subject: [PATCH 0447/1799] Update metadata in 6 topics --- docs/cppcx/platform-intptr-value-class.md | 2 +- docs/cppcx/platform-sizet-value-class.md | 5 ++--- docs/mfc/reference/colesafearray-class.md | 5 ++--- docs/mfc/reference/cricheditctrl-class.md | 5 ++--- docs/mfc/reference/cspinbuttonctrl-class.md | 2 +- docs/mfc/reference/cstatusbar-class.md | 5 ++--- 6 files changed, 10 insertions(+), 14 deletions(-) diff --git a/docs/cppcx/platform-intptr-value-class.md b/docs/cppcx/platform-intptr-value-class.md index f3d7aecfde8..8abd76f842b 100644 --- a/docs/cppcx/platform-intptr-value-class.md +++ b/docs/cppcx/platform-intptr-value-class.md @@ -1,7 +1,7 @@ --- title: "Platform::IntPtr value class" description: "Learn more about: Platform::IntPtr value class" -ms.date: "12/30/2016" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/PlatformIntPtr::IntPtr", "VCCORLIB/PlatformIntPtr::op_explicit Operator", "VCCORLIB/PlatformIntPtr::ToInt32"] helpviewer_keywords: ["Platform::IntPtr Struct"] diff --git a/docs/cppcx/platform-sizet-value-class.md b/docs/cppcx/platform-sizet-value-class.md index 54743ab531c..3bfbf58eb18 100644 --- a/docs/cppcx/platform-sizet-value-class.md +++ b/docs/cppcx/platform-sizet-value-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::SizeT value class" title: "Platform::SizeT value class" -ms.date: "12/30/2016" +description: "Learn more about: Platform::SizeT value class" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/PlatformSizeT::SizeT constructor"] helpviewer_keywords: ["Platform::SizeT Struct"] -ms.assetid: 0803612c-8ba1-430c-9b7b-1bebae88608d --- # Platform::SizeT value class diff --git a/docs/mfc/reference/colesafearray-class.md b/docs/mfc/reference/colesafearray-class.md index e2af72eeba5..f85c05baf87 100644 --- a/docs/mfc/reference/colesafearray-class.md +++ b/docs/mfc/reference/colesafearray-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleSafeArray Class" title: "COleSafeArray Class" -ms.date: "08/29/2019" +description: "Learn more about: COleSafeArray Class" +ms.date: 08/29/2019 f1_keywords: ["COleSafeArray", "AFXDISP/COleSafeArray", "AFXDISP/COleSafeArray::COleSafeArray", "AFXDISP/COleSafeArray::AccessData", "AFXDISP/COleSafeArray::AllocData", "AFXDISP/COleSafeArray::AllocDescriptor", "AFXDISP/COleSafeArray::Attach", "AFXDISP/COleSafeArray::Clear", "AFXDISP/COleSafeArray::Copy", "AFXDISP/COleSafeArray::Create", "AFXDISP/COleSafeArray::CreateOneDim", "AFXDISP/COleSafeArray::Destroy", "AFXDISP/COleSafeArray::DestroyData", "AFXDISP/COleSafeArray::DestroyDescriptor", "AFXDISP/COleSafeArray::Detach", "AFXDISP/COleSafeArray::GetByteArray", "AFXDISP/COleSafeArray::GetDim", "AFXDISP/COleSafeArray::GetElement", "AFXDISP/COleSafeArray::GetElemSize", "AFXDISP/COleSafeArray::GetLBound", "AFXDISP/COleSafeArray::GetOneDimSize", "AFXDISP/COleSafeArray::GetUBound", "AFXDISP/COleSafeArray::Lock", "AFXDISP/COleSafeArray::PtrOfIndex", "AFXDISP/COleSafeArray::PutElement", "AFXDISP/COleSafeArray::Redim", "AFXDISP/COleSafeArray::ResizeOneDim", "AFXDISP/COleSafeArray::UnaccessData", "AFXDISP/COleSafeArray::Unlock"] helpviewer_keywords: ["COleSafeArray [MFC], COleSafeArray", "COleSafeArray [MFC], AccessData", "COleSafeArray [MFC], AllocData", "COleSafeArray [MFC], AllocDescriptor", "COleSafeArray [MFC], Attach", "COleSafeArray [MFC], Clear", "COleSafeArray [MFC], Copy", "COleSafeArray [MFC], Create", "COleSafeArray [MFC], CreateOneDim", "COleSafeArray [MFC], Destroy", "COleSafeArray [MFC], DestroyData", "COleSafeArray [MFC], DestroyDescriptor", "COleSafeArray [MFC], Detach", "COleSafeArray [MFC], GetByteArray", "COleSafeArray [MFC], GetDim", "COleSafeArray [MFC], GetElement", "COleSafeArray [MFC], GetElemSize", "COleSafeArray [MFC], GetLBound", "COleSafeArray [MFC], GetOneDimSize", "COleSafeArray [MFC], GetUBound", "COleSafeArray [MFC], Lock", "COleSafeArray [MFC], PtrOfIndex", "COleSafeArray [MFC], PutElement", "COleSafeArray [MFC], Redim", "COleSafeArray [MFC], ResizeOneDim", "COleSafeArray [MFC], UnaccessData", "COleSafeArray [MFC], Unlock"] -ms.assetid: f45a5224-5f48-40ec-9ddd-287ef9740150 --- # COleSafeArray Class diff --git a/docs/mfc/reference/cricheditctrl-class.md b/docs/mfc/reference/cricheditctrl-class.md index b4c13c12615..146d92aecf4 100644 --- a/docs/mfc/reference/cricheditctrl-class.md +++ b/docs/mfc/reference/cricheditctrl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CRichEditCtrl Class" title: "CRichEditCtrl Class" -ms.date: "11/04/2016" +description: "Learn more about: CRichEditCtrl Class" +ms.date: 11/04/2016 f1_keywords: ["CRichEditCtrl", "AFXCMN/CRichEditCtrl", "AFXCMN/CRichEditCtrl::CRichEditCtrl", "AFXCMN/CRichEditCtrl::CanPaste", "AFXCMN/CRichEditCtrl::CanRedo", "AFXCMN/CRichEditCtrl::CanUndo", "AFXCMN/CRichEditCtrl::CharFromPos", "AFXCMN/CRichEditCtrl::Clear", "AFXCMN/CRichEditCtrl::Copy", "AFXCMN/CRichEditCtrl::Create", "AFXCMN/CRichEditCtrl::CreateEx", "AFXCMN/CRichEditCtrl::Cut", "AFXCMN/CRichEditCtrl::DisplayBand", "AFXCMN/CRichEditCtrl::EmptyUndoBuffer", "AFXCMN/CRichEditCtrl::FindText", "AFXCMN/CRichEditCtrl::FindWordBreak", "AFXCMN/CRichEditCtrl::FormatRange", "AFXCMN/CRichEditCtrl::GetCharPos", "AFXCMN/CRichEditCtrl::GetDefaultCharFormat", "AFXCMN/CRichEditCtrl::GetEventMask", "AFXCMN/CRichEditCtrl::GetFirstVisibleLine", "AFXCMN/CRichEditCtrl::GetIRichEditOle", "AFXCMN/CRichEditCtrl::GetLimitText", "AFXCMN/CRichEditCtrl::GetLine", "AFXCMN/CRichEditCtrl::GetLineCount", "AFXCMN/CRichEditCtrl::GetModify", "AFXCMN/CRichEditCtrl::GetOptions", "AFXCMN/CRichEditCtrl::GetParaFormat", "AFXCMN/CRichEditCtrl::GetPunctuation", "AFXCMN/CRichEditCtrl::GetRect", "AFXCMN/CRichEditCtrl::GetRedoName", "AFXCMN/CRichEditCtrl::GetSel", "AFXCMN/CRichEditCtrl::GetSelectionCharFormat", "AFXCMN/CRichEditCtrl::GetSelectionType", "AFXCMN/CRichEditCtrl::GetSelText", "AFXCMN/CRichEditCtrl::GetTextLength", "AFXCMN/CRichEditCtrl::GetTextLengthEx", "AFXCMN/CRichEditCtrl::GetTextMode", "AFXCMN/CRichEditCtrl::GetTextRange", "AFXCMN/CRichEditCtrl::GetUndoName", "AFXCMN/CRichEditCtrl::GetWordWrapMode", "AFXCMN/CRichEditCtrl::HideSelection", "AFXCMN/CRichEditCtrl::LimitText", "AFXCMN/CRichEditCtrl::LineFromChar", "AFXCMN/CRichEditCtrl::LineIndex", "AFXCMN/CRichEditCtrl::LineLength", "AFXCMN/CRichEditCtrl::LineScroll", "AFXCMN/CRichEditCtrl::Paste", "AFXCMN/CRichEditCtrl::PasteSpecial", "AFXCMN/CRichEditCtrl::PosFromChar", "AFXCMN/CRichEditCtrl::Redo", "AFXCMN/CRichEditCtrl::ReplaceSel", "AFXCMN/CRichEditCtrl::RequestResize", "AFXCMN/CRichEditCtrl::SetAutoURLDetect", "AFXCMN/CRichEditCtrl::SetBackgroundColor", "AFXCMN/CRichEditCtrl::SetDefaultCharFormat", "AFXCMN/CRichEditCtrl::SetEventMask", "AFXCMN/CRichEditCtrl::SetModify", "AFXCMN/CRichEditCtrl::SetOLECallback", "AFXCMN/CRichEditCtrl::SetOptions", "AFXCMN/CRichEditCtrl::SetParaFormat", "AFXCMN/CRichEditCtrl::SetPunctuation", "AFXCMN/CRichEditCtrl::SetReadOnly", "AFXCMN/CRichEditCtrl::SetRect", "AFXCMN/CRichEditCtrl::SetSel", "AFXCMN/CRichEditCtrl::SetSelectionCharFormat", "AFXCMN/CRichEditCtrl::SetTargetDevice", "AFXCMN/CRichEditCtrl::SetTextMode", "AFXCMN/CRichEditCtrl::SetUndoLimit", "AFXCMN/CRichEditCtrl::SetWordCharFormat", "AFXCMN/CRichEditCtrl::SetWordWrapMode", "AFXCMN/CRichEditCtrl::StopGroupTyping", "AFXCMN/CRichEditCtrl::StreamIn", "AFXCMN/CRichEditCtrl::StreamOut", "AFXCMN/CRichEditCtrl::Undo"] helpviewer_keywords: ["CRichEditCtrl [MFC], CRichEditCtrl", "CRichEditCtrl [MFC], CanPaste", "CRichEditCtrl [MFC], CanRedo", "CRichEditCtrl [MFC], CanUndo", "CRichEditCtrl [MFC], CharFromPos", "CRichEditCtrl [MFC], Clear", "CRichEditCtrl [MFC], Copy", "CRichEditCtrl [MFC], Create", "CRichEditCtrl [MFC], CreateEx", "CRichEditCtrl [MFC], Cut", "CRichEditCtrl [MFC], DisplayBand", "CRichEditCtrl [MFC], EmptyUndoBuffer", "CRichEditCtrl [MFC], FindText", "CRichEditCtrl [MFC], FindWordBreak", "CRichEditCtrl [MFC], FormatRange", "CRichEditCtrl [MFC], GetCharPos", "CRichEditCtrl [MFC], GetDefaultCharFormat", "CRichEditCtrl [MFC], GetEventMask", "CRichEditCtrl [MFC], GetFirstVisibleLine", "CRichEditCtrl [MFC], GetIRichEditOle", "CRichEditCtrl [MFC], GetLimitText", "CRichEditCtrl [MFC], GetLine", "CRichEditCtrl [MFC], GetLineCount", "CRichEditCtrl [MFC], GetModify", "CRichEditCtrl [MFC], GetOptions", "CRichEditCtrl [MFC], GetParaFormat", "CRichEditCtrl [MFC], GetPunctuation", "CRichEditCtrl [MFC], GetRect", "CRichEditCtrl [MFC], GetRedoName", "CRichEditCtrl [MFC], GetSel", "CRichEditCtrl [MFC], GetSelectionCharFormat", "CRichEditCtrl [MFC], GetSelectionType", "CRichEditCtrl [MFC], GetSelText", "CRichEditCtrl [MFC], GetTextLength", "CRichEditCtrl [MFC], GetTextLengthEx", "CRichEditCtrl [MFC], GetTextMode", "CRichEditCtrl [MFC], GetTextRange", "CRichEditCtrl [MFC], GetUndoName", "CRichEditCtrl [MFC], GetWordWrapMode", "CRichEditCtrl [MFC], HideSelection", "CRichEditCtrl [MFC], LimitText", "CRichEditCtrl [MFC], LineFromChar", "CRichEditCtrl [MFC], LineIndex", "CRichEditCtrl [MFC], LineLength", "CRichEditCtrl [MFC], LineScroll", "CRichEditCtrl [MFC], Paste", "CRichEditCtrl [MFC], PasteSpecial", "CRichEditCtrl [MFC], PosFromChar", "CRichEditCtrl [MFC], Redo", "CRichEditCtrl [MFC], ReplaceSel", "CRichEditCtrl [MFC], RequestResize", "CRichEditCtrl [MFC], SetAutoURLDetect", "CRichEditCtrl [MFC], SetBackgroundColor", "CRichEditCtrl [MFC], SetDefaultCharFormat", "CRichEditCtrl [MFC], SetEventMask", "CRichEditCtrl [MFC], SetModify", "CRichEditCtrl [MFC], SetOLECallback", "CRichEditCtrl [MFC], SetOptions", "CRichEditCtrl [MFC], SetParaFormat", "CRichEditCtrl [MFC], SetPunctuation", "CRichEditCtrl [MFC], SetReadOnly", "CRichEditCtrl [MFC], SetRect", "CRichEditCtrl [MFC], SetSel", "CRichEditCtrl [MFC], SetSelectionCharFormat", "CRichEditCtrl [MFC], SetTargetDevice", "CRichEditCtrl [MFC], SetTextMode", "CRichEditCtrl [MFC], SetUndoLimit", "CRichEditCtrl [MFC], SetWordCharFormat", "CRichEditCtrl [MFC], SetWordWrapMode", "CRichEditCtrl [MFC], StopGroupTyping", "CRichEditCtrl [MFC], StreamIn", "CRichEditCtrl [MFC], StreamOut", "CRichEditCtrl [MFC], Undo"] -ms.assetid: 2be52788-822c-4c27-aafd-2471231e74eb --- # `CRichEditCtrl` Class diff --git a/docs/mfc/reference/cspinbuttonctrl-class.md b/docs/mfc/reference/cspinbuttonctrl-class.md index 9a67088c71a..d5fc72a6e4e 100644 --- a/docs/mfc/reference/cspinbuttonctrl-class.md +++ b/docs/mfc/reference/cspinbuttonctrl-class.md @@ -1,7 +1,7 @@ --- title: "CSpinButtonCtrl Class" description: "Learn more about: CSpinButtonCtrl Class" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["CSpinButtonCtrl", "AFXCMN/CSpinButtonCtrl", "AFXCMN/CSpinButtonCtrl::CSpinButtonCtrl", "AFXCMN/CSpinButtonCtrl::Create", "AFXCMN/CSpinButtonCtrl::CreateEx", "AFXCMN/CSpinButtonCtrl::GetAccel", "AFXCMN/CSpinButtonCtrl::GetBase", "AFXCMN/CSpinButtonCtrl::GetBuddy", "AFXCMN/CSpinButtonCtrl::GetPos", "AFXCMN/CSpinButtonCtrl::GetRange", "AFXCMN/CSpinButtonCtrl::SetAccel", "AFXCMN/CSpinButtonCtrl::SetBase", "AFXCMN/CSpinButtonCtrl::SetBuddy", "AFXCMN/CSpinButtonCtrl::SetPos", "AFXCMN/CSpinButtonCtrl::SetRange"] helpviewer_keywords: ["CSpinButtonCtrl [MFC], CSpinButtonCtrl", "CSpinButtonCtrl [MFC], Create", "CSpinButtonCtrl [MFC], CreateEx", "CSpinButtonCtrl [MFC], GetAccel", "CSpinButtonCtrl [MFC], GetBase", "CSpinButtonCtrl [MFC], GetBuddy", "CSpinButtonCtrl [MFC], GetPos", "CSpinButtonCtrl [MFC], GetRange", "CSpinButtonCtrl [MFC], SetAccel", "CSpinButtonCtrl [MFC], SetBase", "CSpinButtonCtrl [MFC], SetBuddy", "CSpinButtonCtrl [MFC], SetPos", "CSpinButtonCtrl [MFC], SetRange"] --- diff --git a/docs/mfc/reference/cstatusbar-class.md b/docs/mfc/reference/cstatusbar-class.md index 8cfdfc23d96..ccbf9e66028 100644 --- a/docs/mfc/reference/cstatusbar-class.md +++ b/docs/mfc/reference/cstatusbar-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CStatusBar Class" title: "CStatusBar Class" -ms.date: "11/04/2016" +description: "Learn more about: CStatusBar Class" +ms.date: 11/04/2016 f1_keywords: ["CStatusBar", "AFXEXT/CStatusBar", "AFXEXT/CStatusBar::CStatusBar", "AFXEXT/CStatusBar::CommandToIndex", "AFXEXT/CStatusBar::Create", "AFXEXT/CStatusBar::CreateEx", "AFXEXT/CStatusBar::DrawItem", "AFXEXT/CStatusBar::GetItemID", "AFXEXT/CStatusBar::GetItemRect", "AFXEXT/CStatusBar::GetPaneInfo", "AFXEXT/CStatusBar::GetPaneStyle", "AFXEXT/CStatusBar::GetPaneText", "AFXEXT/CStatusBar::GetStatusBarCtrl", "AFXEXT/CStatusBar::SetIndicators", "AFXEXT/CStatusBar::SetPaneInfo", "AFXEXT/CStatusBar::SetPaneStyle", "AFXEXT/CStatusBar::SetPaneText"] helpviewer_keywords: ["CStatusBar [MFC], CStatusBar", "CStatusBar [MFC], CommandToIndex", "CStatusBar [MFC], Create", "CStatusBar [MFC], CreateEx", "CStatusBar [MFC], DrawItem", "CStatusBar [MFC], GetItemID", "CStatusBar [MFC], GetItemRect", "CStatusBar [MFC], GetPaneInfo", "CStatusBar [MFC], GetPaneStyle", "CStatusBar [MFC], GetPaneText", "CStatusBar [MFC], GetStatusBarCtrl", "CStatusBar [MFC], SetIndicators", "CStatusBar [MFC], SetPaneInfo", "CStatusBar [MFC], SetPaneStyle", "CStatusBar [MFC], SetPaneText"] -ms.assetid: a3bde3db-e71c-4881-a3ca-1d5481c345ba --- # CStatusBar Class From ea3a4b5aa934cf8d71fb0d61580e08b874d9aaf3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 18:55:29 +0800 Subject: [PATCH 0448/1799] Add blockquotes for error messages in range [C2181, C2200] --- docs/error-messages/compiler-errors-1/compiler-error-c2181.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2182.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2183.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2184.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2185.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2186.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2188.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2190.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2191.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2192.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2193.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2194.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2195.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2196.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2197.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2198.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2199.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2200.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md index e3ca226ad79..10d987bb555 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md @@ -8,7 +8,7 @@ ms.assetid: d52b2fe4-566a-40a9-b8e2-8dce1f287668 --- # Compiler Error C2181 -illegal else without matching if +> illegal else without matching if Each **`else`** must have a matching **`if`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md index 6aef2bbc657..1453b5a7f99 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md @@ -8,7 +8,7 @@ ms.assetid: dfd8d47d-9606-496e-bd96-4bf41ba1f857 --- # Compiler Error C2182 -'identifier' : illegal use of type 'void' +> 'identifier' : illegal use of type 'void' A variable is declared type **`void`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2183.md b/docs/error-messages/compiler-errors-1/compiler-error-c2183.md index 85d58a53721..a9c73bfc066 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2183.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2183.md @@ -8,6 +8,6 @@ ms.assetid: 03d2d010-a276-4ac3-820c-159abd8b1222 --- # Compiler Error C2183 -syntax error: translation unit is empty +> syntax error: translation unit is empty Preprocessing produced an empty source file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md index 3d038496347..ec791525869 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md @@ -8,7 +8,7 @@ ms.assetid: 80fc8bff-7d76-4bde-94d2-01d84bb6824a --- # Compiler Error C2184 -'type' : illegal type for __except expression, must be an integral +> 'type' : illegal type for __except expression, must be an integral A type was used in an [__except](../../c-language/try-except-statement-c.md) statement, but the type is not allowed. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2185.md b/docs/error-messages/compiler-errors-1/compiler-error-c2185.md index b6db0922903..42b513faa42 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2185.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2185.md @@ -8,6 +8,6 @@ ms.assetid: 74bc9f64-7b4c-4735-ba13-67c43f8c47db --- # Compiler Error C2185 -'identifier' : illegal based allocation +> 'identifier' : illegal based allocation A register variable or automatic (local) variable is declared **`__based`**. Only global variables can be declared **`__based`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md index 749be6dcbc4..8f4c13691eb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md @@ -8,7 +8,7 @@ ms.assetid: 284bfb7e-ab85-4fcb-9864-1ddf7f6c94ae --- # Compiler Error C2186 -'operator' : illegal operand of type 'void' +> 'operator' : illegal operand of type 'void' The operator has a **`void`** operand. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2188.md b/docs/error-messages/compiler-errors-1/compiler-error-c2188.md index 74433b09195..692c261ac2c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2188.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2188.md @@ -8,6 +8,6 @@ ms.assetid: 2223147f-e487-4090-acdf-75ba4e1114f6 --- # Compiler Error C2188 -'number' : too big for wide character +> 'number' : too big for wide character The number exceeds the size limit for the wide-character type. Choose a larger type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md index a1a2c41a07e..f93d5accb8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md @@ -8,7 +8,7 @@ ms.assetid: 34e15f85-d979-4948-80fc-46c414508a70 --- # Compiler Error C2190 -first parameter list longer than second +> first parameter list longer than second A C function was declared a second time with a shorter parameter list. C does not support overloaded functions. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md index d55e9b6fc77..ddb04d0e1d1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md @@ -8,7 +8,7 @@ ms.assetid: 051b8350-e5de-4f51-ab6e-96d32366bcef --- # Compiler Error C2191 -second parameter list longer than first +> second parameter list longer than first A C function was declared a second time with a longer parameter list. C does not support overloaded functions. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md index 3444f6a2d61..3ccc3fbc0f2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md @@ -8,7 +8,7 @@ ms.assetid: a147197e-e72d-4620-939b-f9e08d7c7c12 --- # Compiler Error C2192 -parameter 'number' declaration different +> parameter 'number' declaration different A C function was declared a second time with a different parameter list. C does not support overloaded functions. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md index 8175641f502..99b7ab7a3de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md @@ -8,7 +8,7 @@ ms.assetid: 9813e853-d581-4f51-bb75-4e242298a844 --- # Compiler Error C2193 -'identifier' : already in a segment +> 'identifier' : already in a segment A function was placed in two different segments using `alloc_text` and `code_seg` pragmas. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md index 97e108884eb..1321ac59fe2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md @@ -8,7 +8,7 @@ ms.assetid: df6e631c-0062-4844-9088-4cc7a0ff879f --- # Compiler Error C2194 -'identifier' : is a text segment +> 'identifier' : is a text segment The `data_seg` pragma uses a segment name used with `code_seg`. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md index 34f1655447b..98affe245bb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md @@ -8,7 +8,7 @@ ms.assetid: 9f9f035c-9c51-4173-a8ea-c6f907fc5c63 --- # Compiler Error C2195 -'identifier' : is a data segment +> 'identifier' : is a data segment The `code_seg` pragma uses a segment name used with the `data_seg` pragma. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md index e3e854bae89..a3f56f0e376 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md @@ -8,7 +8,7 @@ ms.assetid: fd2f6a58-48ce-4e58-96f8-e37720feb8e7 --- # Compiler Error C2196 -case value 'value' already used. +> case value 'value' already used. A switch statement uses the same case value more than once. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md index d59180593bc..adc216f4441 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md @@ -8,7 +8,7 @@ ms.assetid: 6dd5a6ec-bc80-41b9-a4ac-46f80eaca42d --- # Compiler Error C2197 -'function' : too many arguments for call +> 'function' : too many arguments for call The compiler detected too many parameters for a call to the function, or an incorrect function declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md index 56e12832c9b..bd7a75460bc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md @@ -8,7 +8,7 @@ ms.assetid: 638a845c-9d7f-4115-a9aa-d72455605668 --- # Compiler Error C2198 -'function' : too few arguments for call +> 'function' : too few arguments for call The compiler found too few parameters for a call to the function, or an incorrect function declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md index 74067b233cc..dffb6e88b29 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md @@ -8,7 +8,7 @@ ms.assetid: 6a92a1b7-7906-49e6-a31f-e8bffbc7706a --- # Compiler Error C2199 -syntax error : found 'identifier (' at global scope (was a declaration intended?) +> syntax error : found 'identifier (' at global scope (was a declaration intended?) The specified context caused a syntax error. There may be incorrect declaration syntax. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md index c01937be6cf..ce3e8f512df 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2200"] --- # Compiler Error C2200 -'function': function has already been defined +> 'function': function has already been defined An [`alloc_text`](../../preprocessor/alloc-text.md) pragma uses a function name already defined. Ensure the `alloc_text` pragma appears after the function declaration but before its definition. From cfb1f12b9b6c8481fd51975fb1de8021863ca821 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 19:00:05 +0800 Subject: [PATCH 0449/1799] Add "Remarks" and "Example" headings for error references in range [C2181, C2200] --- docs/error-messages/compiler-errors-1/compiler-error-c2181.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2182.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2183.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2184.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2185.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2186.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2188.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2190.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2191.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2192.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2193.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2194.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2195.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2196.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2197.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2198.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2199.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2200.md | 4 ++++ 18 files changed, 64 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md index 10d987bb555..fe505fa279b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md @@ -10,8 +10,12 @@ ms.assetid: d52b2fe4-566a-40a9-b8e2-8dce1f287668 > illegal else without matching if +## Remarks + Each **`else`** must have a matching **`if`**. +## Example + The following sample generates C2181: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md index 1453b5a7f99..15559ac946c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md @@ -10,8 +10,12 @@ ms.assetid: dfd8d47d-9606-496e-bd96-4bf41ba1f857 > 'identifier' : illegal use of type 'void' +## Remarks + A variable is declared type **`void`**. +## Example + The following sample generates C2182: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2183.md b/docs/error-messages/compiler-errors-1/compiler-error-c2183.md index a9c73bfc066..948095c359b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2183.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2183.md @@ -10,4 +10,6 @@ ms.assetid: 03d2d010-a276-4ac3-820c-159abd8b1222 > syntax error: translation unit is empty +## Remarks + Preprocessing produced an empty source file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md index ec791525869..4c606c8e6ce 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md @@ -10,8 +10,12 @@ ms.assetid: 80fc8bff-7d76-4bde-94d2-01d84bb6824a > 'type' : illegal type for __except expression, must be an integral +## Remarks + A type was used in an [__except](../../c-language/try-except-statement-c.md) statement, but the type is not allowed. +## Example + The following sample generates C2184: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2185.md b/docs/error-messages/compiler-errors-1/compiler-error-c2185.md index 42b513faa42..26f759d60ad 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2185.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2185.md @@ -10,4 +10,6 @@ ms.assetid: 74bc9f64-7b4c-4735-ba13-67c43f8c47db > 'identifier' : illegal based allocation +## Remarks + A register variable or automatic (local) variable is declared **`__based`**. Only global variables can be declared **`__based`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md index 8f4c13691eb..6507cbbe24e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md @@ -10,8 +10,12 @@ ms.assetid: 284bfb7e-ab85-4fcb-9864-1ddf7f6c94ae > 'operator' : illegal operand of type 'void' +## Remarks + The operator has a **`void`** operand. +## Example + The following sample generates C2186: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2188.md b/docs/error-messages/compiler-errors-1/compiler-error-c2188.md index 692c261ac2c..9d637884590 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2188.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2188.md @@ -10,4 +10,6 @@ ms.assetid: 2223147f-e487-4090-acdf-75ba4e1114f6 > 'number' : too big for wide character +## Remarks + The number exceeds the size limit for the wide-character type. Choose a larger type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md index f93d5accb8d..a1e46a787bc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md @@ -10,8 +10,12 @@ ms.assetid: 34e15f85-d979-4948-80fc-46c414508a70 > first parameter list longer than second +## Remarks + A C function was declared a second time with a shorter parameter list. C does not support overloaded functions. +## Example + The following sample generates C2190: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md index ddb04d0e1d1..f7f15be9a32 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md @@ -10,6 +10,8 @@ ms.assetid: 051b8350-e5de-4f51-ab6e-96d32366bcef > second parameter list longer than first +## Remarks + A C function was declared a second time with a longer parameter list. C does not support overloaded functions. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md index 3ccc3fbc0f2..53d8a43f0a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md @@ -10,8 +10,12 @@ ms.assetid: a147197e-e72d-4620-939b-f9e08d7c7c12 > parameter 'number' declaration different +## Remarks + A C function was declared a second time with a different parameter list. C does not support overloaded functions. +## Example + The following sample generates C2192: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md index 99b7ab7a3de..99234f37dc9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md @@ -10,8 +10,12 @@ ms.assetid: 9813e853-d581-4f51-bb75-4e242298a844 > 'identifier' : already in a segment +## Remarks + A function was placed in two different segments using `alloc_text` and `code_seg` pragmas. +## Example + The following sample generates C2193: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md index 1321ac59fe2..5e4dd8c40ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md @@ -10,8 +10,12 @@ ms.assetid: df6e631c-0062-4844-9088-4cc7a0ff879f > 'identifier' : is a text segment +## Remarks + The `data_seg` pragma uses a segment name used with `code_seg`. +## Example + The following sample generates C2194: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md index 98affe245bb..08b67f67bc7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md @@ -10,8 +10,12 @@ ms.assetid: 9f9f035c-9c51-4173-a8ea-c6f907fc5c63 > 'identifier' : is a data segment +## Remarks + The `code_seg` pragma uses a segment name used with the `data_seg` pragma. +## Example + The following sample generates C2195: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md index a3f56f0e376..d81489b1526 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md @@ -10,8 +10,12 @@ ms.assetid: fd2f6a58-48ce-4e58-96f8-e37720feb8e7 > case value 'value' already used. +## Remarks + A switch statement uses the same case value more than once. +## Example + The following sample generates C2196: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md index adc216f4441..f2fd57fb540 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md @@ -10,8 +10,12 @@ ms.assetid: 6dd5a6ec-bc80-41b9-a4ac-46f80eaca42d > 'function' : too many arguments for call +## Remarks + The compiler detected too many parameters for a call to the function, or an incorrect function declaration. +## Example + The following sample generates C2197: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md index bd7a75460bc..87c3106397b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md @@ -10,8 +10,12 @@ ms.assetid: 638a845c-9d7f-4115-a9aa-d72455605668 > 'function' : too few arguments for call +## Remarks + The compiler found too few parameters for a call to the function, or an incorrect function declaration. +## Example + The following sample generates C2198: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md index dffb6e88b29..1b2aff2d6ff 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md @@ -10,8 +10,12 @@ ms.assetid: 6a92a1b7-7906-49e6-a31f-e8bffbc7706a > syntax error : found 'identifier (' at global scope (was a declaration intended?) +## Remarks + The specified context caused a syntax error. There may be incorrect declaration syntax. +## Example + The following sample generates C2199: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md index ce3e8f512df..7c5b1dd5cd4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2200"] > 'function': function has already been defined +## Remarks + An [`alloc_text`](../../preprocessor/alloc-text.md) pragma uses a function name already defined. Ensure the `alloc_text` pragma appears after the function declaration but before its definition. +## Example + The following sample generates C2200: ```cpp From 8364bf9271f247a1cee38c0935ce98a46b4821df Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 19:02:07 +0800 Subject: [PATCH 0450/1799] Replace term "sample" with "example" for error references in range [C2181, C2200] --- docs/error-messages/compiler-errors-1/compiler-error-c2181.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2182.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2184.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2186.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2190.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2191.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2192.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2193.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2194.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2195.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2196.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2197.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2198.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2199.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2200.md | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md index fe505fa279b..83538768844 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md @@ -16,7 +16,7 @@ Each **`else`** must have a matching **`if`**. ## Example -The following sample generates C2181: +The following example generates C2181: ```cpp // C2181.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md index 15559ac946c..1510f62f67e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md @@ -16,7 +16,7 @@ A variable is declared type **`void`**. ## Example -The following sample generates C2182: +The following example generates C2182: ```cpp // C2182.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md index 4c606c8e6ce..31352df295c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md @@ -16,7 +16,7 @@ A type was used in an [__except](../../c-language/try-except-statement-c.md) sta ## Example -The following sample generates C2184: +The following example generates C2184: ```cpp // C2184.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md index 6507cbbe24e..f055231f040 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md @@ -16,7 +16,7 @@ The operator has a **`void`** operand. ## Example -The following sample generates C2186: +The following example generates C2186: ```cpp // C2186.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md index a1e46a787bc..6861e85bc8a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md @@ -16,7 +16,7 @@ A C function was declared a second time with a shorter parameter list. C does no ## Example -The following sample generates C2190: +The following example generates C2190: ```c // C2190.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md index f7f15be9a32..dd24446d6be 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md @@ -16,7 +16,7 @@ A C function was declared a second time with a longer parameter list. C does not ## Example -The following sample generates C2191: +The following example generates C2191: ```c // C2191.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md index 53d8a43f0a6..b0542a307c5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md @@ -16,7 +16,7 @@ A C function was declared a second time with a different parameter list. C does ## Example -The following sample generates C2192: +The following example generates C2192: ```c // C2192.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md index 99234f37dc9..9c95b5c6194 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md @@ -16,7 +16,7 @@ A function was placed in two different segments using `alloc_text` and `code_seg ## Example -The following sample generates C2193: +The following example generates C2193: ```cpp // C2193.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md index 5e4dd8c40ac..69c6990d735 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md @@ -16,7 +16,7 @@ The `data_seg` pragma uses a segment name used with `code_seg`. ## Example -The following sample generates C2194: +The following example generates C2194: ```cpp // C2194.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md index 08b67f67bc7..79cc2288251 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md @@ -16,7 +16,7 @@ The `code_seg` pragma uses a segment name used with the `data_seg` pragma. ## Example -The following sample generates C2195: +The following example generates C2195: ```cpp // C2195.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md index d81489b1526..c6b7500c462 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md @@ -16,7 +16,7 @@ A switch statement uses the same case value more than once. ## Example -The following sample generates C2196: +The following example generates C2196: ```cpp // C2196.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md index f2fd57fb540..595214a0fdf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md @@ -16,7 +16,7 @@ The compiler detected too many parameters for a call to the function, or an inco ## Example -The following sample generates C2197: +The following example generates C2197: ```c // C2197.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md index 87c3106397b..facb5ccee22 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md @@ -16,7 +16,7 @@ The compiler found too few parameters for a call to the function, or an incorrec ## Example -The following sample generates C2198: +The following example generates C2198: ```c // C2198.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md index 1b2aff2d6ff..dd26d25d21a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md @@ -16,7 +16,7 @@ The specified context caused a syntax error. There may be incorrect declaration ## Example -The following sample generates C2199: +The following example generates C2199: ```cpp // C2199.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md index 7c5b1dd5cd4..0ab3a3dc220 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md @@ -15,7 +15,7 @@ An [`alloc_text`](../../preprocessor/alloc-text.md) pragma uses a function name ## Example -The following sample generates C2200: +The following example generates C2200: ```cpp // C2200.cpp From 5917d342e5c88ba039af5841bcd33f59feabc3b0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 18 Jul 2025 19:05:13 +0800 Subject: [PATCH 0451/1799] Update metadata for error references in range [C2181, C2200] --- .../error-messages/compiler-errors-1/compiler-error-c2181.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2182.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2183.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2184.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2185.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2186.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2188.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2190.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2191.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2192.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2193.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2194.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2195.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2196.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2197.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2198.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2199.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2200.md | 2 +- 18 files changed, 35 insertions(+), 52 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md index 83538768844..be880ea0e88 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2181" title: "Compiler Error C2181" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2181" +ms.date: 11/04/2016 f1_keywords: ["C2181"] helpviewer_keywords: ["C2181"] -ms.assetid: d52b2fe4-566a-40a9-b8e2-8dce1f287668 --- # Compiler Error C2181 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md index 1510f62f67e..86a4d0259c6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2182" title: "Compiler Error C2182" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2182" +ms.date: 11/04/2016 f1_keywords: ["C2182"] helpviewer_keywords: ["C2182"] -ms.assetid: dfd8d47d-9606-496e-bd96-4bf41ba1f857 --- # Compiler Error C2182 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2183.md b/docs/error-messages/compiler-errors-1/compiler-error-c2183.md index 948095c359b..95d0ed0a559 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2183.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2183.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2183" title: "Compiler Error C2183" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2183" +ms.date: 11/04/2016 f1_keywords: ["C2183"] helpviewer_keywords: ["C2183"] -ms.assetid: 03d2d010-a276-4ac3-820c-159abd8b1222 --- # Compiler Error C2183 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md index 31352df295c..bee34695f9b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2184" title: "Compiler Error C2184" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2184" +ms.date: 11/04/2016 f1_keywords: ["C2184"] helpviewer_keywords: ["C2184"] -ms.assetid: 80fc8bff-7d76-4bde-94d2-01d84bb6824a --- # Compiler Error C2184 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2185.md b/docs/error-messages/compiler-errors-1/compiler-error-c2185.md index 26f759d60ad..0137134698f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2185.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2185.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2185" title: "Compiler Error C2185" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2185" +ms.date: 11/04/2016 f1_keywords: ["C2185"] helpviewer_keywords: ["C2185"] -ms.assetid: 74bc9f64-7b4c-4735-ba13-67c43f8c47db --- # Compiler Error C2185 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md index f055231f040..e2ad100f3de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2186" title: "Compiler Error C2186" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2186" +ms.date: 11/04/2016 f1_keywords: ["C2186"] helpviewer_keywords: ["C2186"] -ms.assetid: 284bfb7e-ab85-4fcb-9864-1ddf7f6c94ae --- # Compiler Error C2186 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2188.md b/docs/error-messages/compiler-errors-1/compiler-error-c2188.md index 9d637884590..e6bc3822cd9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2188.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2188.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2188" title: "Compiler Error C2188" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2188" +ms.date: 11/04/2016 f1_keywords: ["C2188"] helpviewer_keywords: ["C2188"] -ms.assetid: 2223147f-e487-4090-acdf-75ba4e1114f6 --- # Compiler Error C2188 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md index 6861e85bc8a..b1b5022b249 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2190" title: "Compiler Error C2190" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2190" +ms.date: 11/04/2016 f1_keywords: ["C2190"] helpviewer_keywords: ["C2190"] -ms.assetid: 34e15f85-d979-4948-80fc-46c414508a70 --- # Compiler Error C2190 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md index dd24446d6be..26511d59b3e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2191" title: "Compiler Error C2191" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2191" +ms.date: 11/04/2016 f1_keywords: ["C2191"] helpviewer_keywords: ["C2191"] -ms.assetid: 051b8350-e5de-4f51-ab6e-96d32366bcef --- # Compiler Error C2191 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md index b0542a307c5..99ad0f1f3cd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2192" title: "Compiler Error C2192" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2192" +ms.date: 11/04/2016 f1_keywords: ["C2192"] helpviewer_keywords: ["C2192"] -ms.assetid: a147197e-e72d-4620-939b-f9e08d7c7c12 --- # Compiler Error C2192 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md index 9c95b5c6194..3ccc804d025 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2193" title: "Compiler Error C2193" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2193" +ms.date: 11/04/2016 f1_keywords: ["C2193"] helpviewer_keywords: ["C2193"] -ms.assetid: 9813e853-d581-4f51-bb75-4e242298a844 --- # Compiler Error C2193 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md index 69c6990d735..371a93bf9f7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2194" title: "Compiler Error C2194" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2194" +ms.date: 11/04/2016 f1_keywords: ["C2194"] helpviewer_keywords: ["C2194"] -ms.assetid: df6e631c-0062-4844-9088-4cc7a0ff879f --- # Compiler Error C2194 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md index 79cc2288251..04352aa63fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2195" title: "Compiler Error C2195" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2195" +ms.date: 11/04/2016 f1_keywords: ["C2195"] helpviewer_keywords: ["C2195"] -ms.assetid: 9f9f035c-9c51-4173-a8ea-c6f907fc5c63 --- # Compiler Error C2195 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md index c6b7500c462..d36f92c67ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2196" title: "Compiler Error C2196" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2196" +ms.date: 11/04/2016 f1_keywords: ["C2196"] helpviewer_keywords: ["C2196"] -ms.assetid: fd2f6a58-48ce-4e58-96f8-e37720feb8e7 --- # Compiler Error C2196 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md index 595214a0fdf..ea6795bcdd4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2197" title: "Compiler Error C2197" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2197" +ms.date: 11/04/2016 f1_keywords: ["C2197"] helpviewer_keywords: ["C2197"] -ms.assetid: 6dd5a6ec-bc80-41b9-a4ac-46f80eaca42d --- # Compiler Error C2197 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md index facb5ccee22..e200cd44285 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2198" title: "Compiler Error C2198" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2198" +ms.date: 11/04/2016 f1_keywords: ["C2198"] helpviewer_keywords: ["C2198"] -ms.assetid: 638a845c-9d7f-4115-a9aa-d72455605668 --- # Compiler Error C2198 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md index dd26d25d21a..91384b33bda 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2199" title: "Compiler Error C2199" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2199" +ms.date: 11/04/2016 f1_keywords: ["C2199"] helpviewer_keywords: ["C2199"] -ms.assetid: 6a92a1b7-7906-49e6-a31f-e8bffbc7706a --- # Compiler Error C2199 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md index 0ab3a3dc220..5ef2473a21f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2200" description: "Learn more about: Compiler Error C2200" -ms.date: "02/15/2025" +ms.date: 02/15/2025 f1_keywords: ["C2200"] helpviewer_keywords: ["C2200"] --- From 91e5c224f62274274fcc29cb7a55041e1418d8c5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 21:59:22 +0800 Subject: [PATCH 0452/1799] Add backticks in "EVEN and ALIGN Directives" topic --- docs/assembler/inline/even-and-align-directives.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/assembler/inline/even-and-align-directives.md b/docs/assembler/inline/even-and-align-directives.md index 648f5367903..b2e9bfd7fb7 100644 --- a/docs/assembler/inline/even-and-align-directives.md +++ b/docs/assembler/inline/even-and-align-directives.md @@ -5,14 +5,14 @@ ms.date: "08/30/2018" helpviewer_keywords: ["EVEN directive", "directives, MASM", "MASM (Microsoft Macro Assembler), directives", "NOP (no operation instruction)", "ALIGN directive"] ms.assetid: 7357ab2d-4a5c-43ca-accb-a5f21cdfcde5 --- -# EVEN and ALIGN Directives +# `EVEN` and `ALIGN` Directives **Microsoft Specific** -Although the inline assembler doesn't support most MASM directives, it does support `EVEN` and **ALIGN**. These directives put **NOP** (no operation) instructions in the assembly code as needed to align labels to specific boundaries. This makes instruction-fetch operations more efficient for some processors. +Although the inline assembler doesn't support most MASM directives, it does support `EVEN` and `ALIGN`. These directives put `NOP` (no operation) instructions in the assembly code as needed to align labels to specific boundaries. This makes instruction-fetch operations more efficient for some processors. **END Microsoft Specific** ## See also -[Using Assembly Language in __asm Blocks](../../assembler/inline/using-assembly-language-in-asm-blocks.md)
+[Using Assembly Language in `__asm` Blocks](../../assembler/inline/using-assembly-language-in-asm-blocks.md)
From d15a34b258b8618cb2e3e216d70e0226152b95f1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 22:05:20 +0800 Subject: [PATCH 0453/1799] Simplify and add links in "EVEN and ALIGN Directives" topic --- docs/assembler/inline/even-and-align-directives.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/assembler/inline/even-and-align-directives.md b/docs/assembler/inline/even-and-align-directives.md index b2e9bfd7fb7..e68c0ad42a8 100644 --- a/docs/assembler/inline/even-and-align-directives.md +++ b/docs/assembler/inline/even-and-align-directives.md @@ -9,10 +9,10 @@ ms.assetid: 7357ab2d-4a5c-43ca-accb-a5f21cdfcde5 **Microsoft Specific** -Although the inline assembler doesn't support most MASM directives, it does support `EVEN` and `ALIGN`. These directives put `NOP` (no operation) instructions in the assembly code as needed to align labels to specific boundaries. This makes instruction-fetch operations more efficient for some processors. +Although the inline assembler doesn't support most MASM directives, it does support [`EVEN`](../masm/even.md) and [`ALIGN`](../masm/align-masm.md). These directives put `NOP` (no operation) instructions in the assembly code as needed to align labels to specific boundaries. This makes instruction-fetch operations more efficient for some processors. **END Microsoft Specific** ## See also -[Using Assembly Language in `__asm` Blocks](../../assembler/inline/using-assembly-language-in-asm-blocks.md)
+[Using Assembly Language in `__asm` Blocks](using-assembly-language-in-asm-blocks.md)
From 8377f62e9ffb22526ae717771689e7fd3e316646 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 22:08:05 +0800 Subject: [PATCH 0454/1799] Remove unneeded `br` element in "EVEN and ALIGN Directives" topic --- docs/assembler/inline/even-and-align-directives.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/assembler/inline/even-and-align-directives.md b/docs/assembler/inline/even-and-align-directives.md index e68c0ad42a8..b5d7172a9d0 100644 --- a/docs/assembler/inline/even-and-align-directives.md +++ b/docs/assembler/inline/even-and-align-directives.md @@ -15,4 +15,4 @@ Although the inline assembler doesn't support most MASM directives, it does supp ## See also -[Using Assembly Language in `__asm` Blocks](using-assembly-language-in-asm-blocks.md)
+[Using Assembly Language in `__asm` Blocks](using-assembly-language-in-asm-blocks.md) From 6ac88d6d452c50c7e0133922e5ed702911c9147a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 22:08:53 +0800 Subject: [PATCH 0455/1799] Update metadata in "EVEN and ALIGN Directives" topic --- docs/assembler/inline/even-and-align-directives.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/assembler/inline/even-and-align-directives.md b/docs/assembler/inline/even-and-align-directives.md index b5d7172a9d0..d98adc4b440 100644 --- a/docs/assembler/inline/even-and-align-directives.md +++ b/docs/assembler/inline/even-and-align-directives.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: EVEN and ALIGN Directives" title: "EVEN and ALIGN Directives" -ms.date: "08/30/2018" +description: "Learn more about: EVEN and ALIGN Directives" +ms.date: 08/30/2018 helpviewer_keywords: ["EVEN directive", "directives, MASM", "MASM (Microsoft Macro Assembler), directives", "NOP (no operation instruction)", "ALIGN directive"] -ms.assetid: 7357ab2d-4a5c-43ca-accb-a5f21cdfcde5 --- # `EVEN` and `ALIGN` Directives From a62287a31ee5bba300566c665c797e5f28da9e00 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 22:17:39 +0800 Subject: [PATCH 0456/1799] Add backticks for heading in `EVEN` MASM reference --- docs/assembler/masm/even.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/assembler/masm/even.md b/docs/assembler/masm/even.md index a8123b72031..93457f87c58 100644 --- a/docs/assembler/masm/even.md +++ b/docs/assembler/masm/even.md @@ -6,7 +6,7 @@ f1_keywords: ["EVEN"] helpviewer_keywords: ["EVEN directive"] ms.assetid: 68938ba4-8cb9-44d4-914e-9f9fee6bcbf4 --- -# EVEN +# `EVEN` Aligns the next variable or instruction on an even byte. From 14226923196a23e75002240cb1c00c90e1c9dd9f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 22:19:28 +0800 Subject: [PATCH 0457/1799] Add `ALIGN` to "See also" in `EVEN` MASM reference --- docs/assembler/masm/even.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/assembler/masm/even.md b/docs/assembler/masm/even.md index 93457f87c58..4b63d74a76a 100644 --- a/docs/assembler/masm/even.md +++ b/docs/assembler/masm/even.md @@ -16,5 +16,6 @@ Aligns the next variable or instruction on an even byte. ## See also +[`ALIGN`](align-masm.md)\ [Directives reference](directives-reference.md)\ [MASM BNF Grammar](masm-bnf-grammar.md) From b07d18297744e65c6ac525c386545776f822c217 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 22:20:23 +0800 Subject: [PATCH 0458/1799] Update metadata in `EVEN` MASM reference --- docs/assembler/masm/even.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/assembler/masm/even.md b/docs/assembler/masm/even.md index 4b63d74a76a..f7b6a209b92 100644 --- a/docs/assembler/masm/even.md +++ b/docs/assembler/masm/even.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: EVEN" title: "EVEN" -ms.date: "12/17/2019" +description: "Learn more about: EVEN" +ms.date: 12/17/2019 f1_keywords: ["EVEN"] helpviewer_keywords: ["EVEN directive"] -ms.assetid: 68938ba4-8cb9-44d4-914e-9f9fee6bcbf4 --- # `EVEN` From bac4ac1f49921c083246dc37d187feed5737a74a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 22:40:09 +0800 Subject: [PATCH 0459/1799] Merge duplicate sentences about `_asm` synonym in `__asm` reference --- docs/assembler/inline/asm.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/assembler/inline/asm.md b/docs/assembler/inline/asm.md index 0ad5df365a0..e421e86b5b0 100644 --- a/docs/assembler/inline/asm.md +++ b/docs/assembler/inline/asm.md @@ -28,7 +28,7 @@ The **`__asm`** keyword invokes the inline assembler and can appear wherever a C ## Remarks -If used without braces, the **`__asm`** keyword means that the rest of the line is an assembly-language statement. If used with braces, it means that each line between the braces is an assembly-language statement. For compatibility with previous versions, **`_asm`** is a synonym for **`__asm`**. +If used without braces, the **`__asm`** keyword means that the rest of the line is an assembly-language statement. If used with braces, it means that each line between the braces is an assembly-language statement. For compatibility with previous versions, **`_asm`** is a synonym for **`__asm`** unless compiler option [`/Za` (Disable language extensions)](../../build/reference/za-ze-disable-language-extensions.md) is specified. Since the **`__asm`** keyword is a statement separator, you can put assembly instructions on the same line. @@ -42,8 +42,6 @@ didn't cause native code to be generated when compiled with **/clr**; the compil `__asm int 3` now results in native code generation for the function. If you want a function to cause a break point in your code and if you want that function compiled to MSIL, use [__debugbreak](../../intrinsics/debugbreak.md). -For compatibility with previous versions, **`_asm`** is a synonym for **`__asm`** unless compiler option [/Za \(Disable language extensions)](../../build/reference/za-ze-disable-language-extensions.md) is specified. - ## Example The following code fragment is a simple **`__asm`** block enclosed in braces: From e661a57ec9626ffb47df49a79168c4c0072d8ba0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 22:41:19 +0800 Subject: [PATCH 0460/1799] Update metadata in `__asm` reference --- docs/assembler/inline/asm.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/assembler/inline/asm.md b/docs/assembler/inline/asm.md index e421e86b5b0..a14c0854693 100644 --- a/docs/assembler/inline/asm.md +++ b/docs/assembler/inline/asm.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: `__asm`" title: "__asm" -ms.date: "10/09/2018" +description: "Learn more about: `__asm`" +ms.date: 10/09/2018 +ms.topic: reference f1_keywords: ["__asm", "_asm", "__asm_cpp"] helpviewer_keywords: ["__asm keyword [C++], vs. asm blocks", "__asm keyword [C++]"] -ms.assetid: 77ff3bc9-a492-4b5e-85e1-fa4e414e79cd -ms.topic: reference --- # `__asm` From cbd976c8a737b5900b3696abe315a6df15cc39dc Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 23:01:48 +0800 Subject: [PATCH 0461/1799] Add blockquotes for error messages in range [C2201, C2230] --- docs/error-messages/compiler-errors-1/compiler-error-c2203.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2204.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2205.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2206.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2207.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2208.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2212.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2213.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2216.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2217.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2219.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2220.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2222.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2223.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2224.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2226.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2227.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2228.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2229.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md index 6171c53c18a..e1aa384e76d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md @@ -8,7 +8,7 @@ ms.assetid: 5497df43-86f6-43d5-b6cb-723c4c589b10 --- # Compiler Error C2203 -delete operator cannot specify bounds for an array +> delete operator cannot specify bounds for an array With the **/Za** (ANSI) option, the **`delete`** operator can delete an entire array but not parts or specific members of the array. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2204.md b/docs/error-messages/compiler-errors-1/compiler-error-c2204.md index 001aefd823c..742337669f1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2204.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2204.md @@ -8,6 +8,6 @@ ms.assetid: bbe506d4-7863-44af-8709-161881c4b4ba --- # Compiler Error C2204 -'type' : type definition found within parentheses +> 'type' : type definition found within parentheses The type is defined as an operand or in prototype scope. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2205.md b/docs/error-messages/compiler-errors-1/compiler-error-c2205.md index 933e5828067..c1097d75f0d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2205.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2205.md @@ -8,6 +8,6 @@ ms.assetid: bfc19840-4a48-4da5-8e69-7069989f1d2c --- # Compiler Error C2205 -'identifier' : cannot initialize extern variables with block scope +> 'identifier' : cannot initialize extern variables with block scope An **`extern`** variable cannot be initialized in a function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md index ecc111e042f..caffc468735 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md @@ -8,7 +8,7 @@ ms.assetid: d7fba68b-aa28-4885-a9a0-27107358f066 --- # Compiler Error C2206 -'function' : typedef cannot be used for function definition +> 'function' : typedef cannot be used for function definition A **`typedef`** is used to define a function type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2207.md b/docs/error-messages/compiler-errors-1/compiler-error-c2207.md index 1f1fffd0dd9..351818ac1a8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2207.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2207.md @@ -8,6 +8,6 @@ ms.assetid: d7d7b537-68f1-420a-9835-b5b6f2cb5cfd --- # Compiler Error C2207 -'member': a member of a class template cannot acquire a function type +> 'member': a member of a class template cannot acquire a function type The `member` of the class template was previously parsed as a non-static data member. It cannot be redefined as a member function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md index b191a057341..d60434b72db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md @@ -8,7 +8,7 @@ ms.assetid: 9ae704bc-bf70-45f1-8e47-0470f21edd4e --- # Compiler Error C2208 -'type' : no members defined using this type +> 'type' : no members defined using this type An identifier resolving to a type name is in an aggregate declaration, but the compiler cannot declare a member. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2212.md b/docs/error-messages/compiler-errors-1/compiler-error-c2212.md index db3551919f0..94d1c9e3533 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2212.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2212.md @@ -8,6 +8,6 @@ ms.assetid: 3fdab304-272c-4d07-bfd4-fad75170e536 --- # Compiler Error C2212 -'identifier' : __based not available for pointers to functions +> 'identifier' : __based not available for pointers to functions Pointers to functions cannot be declared **`__based`**. If you need code-based data, use the **`__declspec`** keyword or the `data_seg` pragma. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md index ef1d970869d..f14100ffb1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md @@ -8,7 +8,7 @@ ms.assetid: ff012278-7f3b-4d49-aaed-2349756f6225 --- # Compiler Error C2213 -'modifier' : illegal argument to __based +> 'modifier' : illegal argument to __based The argument modifying **`__based`** is invalid. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md index 51d2a53818b..e9f1f1a5e26 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md @@ -8,7 +8,7 @@ ms.assetid: 250f6bdc-a5e1-495f-a1e8-6e8e7021ad9d --- # Compiler Error C2216 -'keyword1' cannot be used with ' keyword2' +> 'keyword1' cannot be used with ' keyword2' Two keywords that are mutually exclusive were used together. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md index 009e512bf14..ff2a44a80a7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md @@ -8,7 +8,7 @@ ms.assetid: 1ce1e3f5-4171-4376-804d-967f7e612935 --- # Compiler Error C2217 -'attribute1' requires 'attribute2' +> 'attribute1' requires 'attribute2' The first function attribute requires the second attribute. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2219.md b/docs/error-messages/compiler-errors-1/compiler-error-c2219.md index eb2fc27f7dd..e6ab2c5f053 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2219.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2219.md @@ -8,6 +8,6 @@ ms.assetid: 2cfe9a75-6890-46a1-a127-79a7def78e94 --- # Compiler Error C2219 -syntax error : type qualifier must be after '*' +> syntax error : type qualifier must be after '*' Type qualifier (**`const`** or **`volatile`**) appears where it is not permitted. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2220.md b/docs/error-messages/compiler-errors-1/compiler-error-c2220.md index edfa71f27b2..d5713a4bb64 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2220.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2220.md @@ -8,7 +8,7 @@ ms.assetid: d610802c-64d7-40ad-a2a6-0ed0b6815a6c --- # Compiler Error C2220 -warning treated as error - no object file generated +> warning treated as error - no object file generated [/WX](../../build/reference/compiler-option-warning-level.md) tells the compiler to treat all warnings as errors. Because an error occurred, no object or executable file was generated. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2222.md b/docs/error-messages/compiler-errors-1/compiler-error-c2222.md index 7d2bc23ae53..2acc13ec3b5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2222.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2222.md @@ -8,6 +8,6 @@ ms.assetid: 1c902054-5c77-41e6-a1cc-018f802460cd --- # Compiler Error C2222 -unexpected type 'type': a base-class or member was expected +> unexpected type 'type': a base-class or member was expected The initializer list can only initialize base classes or members of a type. To fix this error, verify that only base classes or members of the type are initialized in the initializer list. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2223.md b/docs/error-messages/compiler-errors-1/compiler-error-c2223.md index cc9b7306391..ddb52547339 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2223.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2223.md @@ -8,7 +8,7 @@ ms.assetid: e4506f0f-0317-4a96-8a90-877a156d7939 --- # Compiler Error C2223 -left of '->identifier' must point to struct/union +> left of '->identifier' must point to struct/union The operand to the left of `->` is not a pointer to a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2224.md b/docs/error-messages/compiler-errors-1/compiler-error-c2224.md index 7bd87633ef8..973fa6b17e7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2224.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2224.md @@ -8,7 +8,7 @@ ms.assetid: 27b93bbf-4ce7-47a3-a9c4-f4fbed689bdf --- # Compiler Error C2224 -left of '.identifier' must have struct/union type +> left of '.identifier' must have struct/union type The operand to the left of the period (.) is not a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2226.md b/docs/error-messages/compiler-errors-1/compiler-error-c2226.md index 5ad3e477754..cb39ac2a2dd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2226.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2226.md @@ -8,6 +8,6 @@ ms.assetid: b3aaa2a5-254a-46a9-a508-de2371ecffeb --- # Compiler Error C2226 -syntax error : unexpected type 'type' +> syntax error : unexpected type 'type' A syntax error occurs before or in the type specifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md index 15613f96e17..770661a8a83 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md @@ -8,7 +8,7 @@ ms.assetid: d470e8b8-7e15-468b-84fa-37d1a0132271 --- # Compiler Error C2227 -left of '->member' must point to class/struct/union/generic type +> left of '->member' must point to class/struct/union/generic type The operand to the left of `->` is not a pointer to a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md index d8cc1b4db97..27e80984ce6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md @@ -8,7 +8,7 @@ ms.assetid: 901cadb1-ce90-4ae0-a360-547a9ba2ca18 --- # Compiler Error C2228 -left of '.identifier' must have class/struct/union +> left of '.identifier' must have class/struct/union The operand to the left of the period (.) is not a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md index 24ce025b2cd..fec73b43b76 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md @@ -8,7 +8,7 @@ ms.assetid: 933c7cf2-a463-4e74-b0b4-59dedad987fb --- # Compiler Error C2229 -type 'identifier' has an illegal zero-sized array +> type 'identifier' has an illegal zero-sized array A member of a structure or bit field contains a zero-sized array that is not the last member. From 55145200f705ab156f7a4911139aeabbe1304f54 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 23:05:36 +0800 Subject: [PATCH 0462/1799] Add "Remarks" and "Example" headings for error references in range [C2201, C2230] --- docs/error-messages/compiler-errors-1/compiler-error-c2201.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2203.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2204.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2205.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2206.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2207.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2208.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2212.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2213.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2216.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2217.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2218.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2219.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2220.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2222.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2223.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2224.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2226.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2227.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2228.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2229.md | 4 ++++ 21 files changed, 56 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md index aa9d5356317..fa16e96cf04 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2201"] > '*identifier*' : must have external linkage in order to be exported/imported +## Remarks + The exported identifier is **`static`**. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md index e1aa384e76d..074ece82aac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md @@ -10,8 +10,12 @@ ms.assetid: 5497df43-86f6-43d5-b6cb-723c4c589b10 > delete operator cannot specify bounds for an array +## Remarks + With the **/Za** (ANSI) option, the **`delete`** operator can delete an entire array but not parts or specific members of the array. +## Example + The following sample generates C2203: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2204.md b/docs/error-messages/compiler-errors-1/compiler-error-c2204.md index 742337669f1..ae3a56a6902 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2204.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2204.md @@ -10,4 +10,6 @@ ms.assetid: bbe506d4-7863-44af-8709-161881c4b4ba > 'type' : type definition found within parentheses +## Remarks + The type is defined as an operand or in prototype scope. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2205.md b/docs/error-messages/compiler-errors-1/compiler-error-c2205.md index c1097d75f0d..e1d21362a4b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2205.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2205.md @@ -10,4 +10,6 @@ ms.assetid: bfc19840-4a48-4da5-8e69-7069989f1d2c > 'identifier' : cannot initialize extern variables with block scope +## Remarks + An **`extern`** variable cannot be initialized in a function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md index caffc468735..657f17fd7a5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md @@ -10,8 +10,12 @@ ms.assetid: d7fba68b-aa28-4885-a9a0-27107358f066 > 'function' : typedef cannot be used for function definition +## Remarks + A **`typedef`** is used to define a function type. +## Example + The following sample generates C2206: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2207.md b/docs/error-messages/compiler-errors-1/compiler-error-c2207.md index 351818ac1a8..2f3797ebbda 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2207.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2207.md @@ -10,4 +10,6 @@ ms.assetid: d7d7b537-68f1-420a-9835-b5b6f2cb5cfd > 'member': a member of a class template cannot acquire a function type +## Remarks + The `member` of the class template was previously parsed as a non-static data member. It cannot be redefined as a member function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md index d60434b72db..3298a08661c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md @@ -10,8 +10,12 @@ ms.assetid: 9ae704bc-bf70-45f1-8e47-0470f21edd4e > 'type' : no members defined using this type +## Remarks + An identifier resolving to a type name is in an aggregate declaration, but the compiler cannot declare a member. +## Example + The following sample generates C2208: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2212.md b/docs/error-messages/compiler-errors-1/compiler-error-c2212.md index 94d1c9e3533..81cb9a15b56 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2212.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2212.md @@ -10,4 +10,6 @@ ms.assetid: 3fdab304-272c-4d07-bfd4-fad75170e536 > 'identifier' : __based not available for pointers to functions +## Remarks + Pointers to functions cannot be declared **`__based`**. If you need code-based data, use the **`__declspec`** keyword or the `data_seg` pragma. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md index f14100ffb1a..3b81efc8df1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md @@ -10,8 +10,12 @@ ms.assetid: ff012278-7f3b-4d49-aaed-2349756f6225 > 'modifier' : illegal argument to __based +## Remarks + The argument modifying **`__based`** is invalid. +## Example + The following sample generates C2213: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md index e9f1f1a5e26..de2d71f978b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md @@ -10,6 +10,8 @@ ms.assetid: 250f6bdc-a5e1-495f-a1e8-6e8e7021ad9d > 'keyword1' cannot be used with ' keyword2' +## Remarks + Two keywords that are mutually exclusive were used together. ## Examples diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md index ff2a44a80a7..3c77379f25c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md @@ -10,6 +10,8 @@ ms.assetid: 1ce1e3f5-4171-4376-804d-967f7e612935 > 'attribute1' requires 'attribute2' +## Remarks + The first function attribute requires the second attribute. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2218.md b/docs/error-messages/compiler-errors-1/compiler-error-c2218.md index a5f96212403..2015d2bb815 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2218.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2218.md @@ -10,6 +10,8 @@ ms.assetid: b0f55da4-8edb-4b45-b298-1a091981bd7b > '__vectorcall' cannot be used with '/arch:IA32' +## Remarks + The **`__vectorcall`** calling convention is only supported in native code on x86 and x64 processors that include Streaming SIMD Extensions 2 (SSE2) and above. For more information, see [`__vectorcall`](../../cpp/vectorcall.md). To fix this error, change the compiler options to target SSE2, AVX or AVX2 instruction sets. For more information, see [`/arch` (x86)](../../build/reference/arch-x86.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2219.md b/docs/error-messages/compiler-errors-1/compiler-error-c2219.md index e6ab2c5f053..5a12002bc6e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2219.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2219.md @@ -10,4 +10,6 @@ ms.assetid: 2cfe9a75-6890-46a1-a127-79a7def78e94 > syntax error : type qualifier must be after '*' +## Remarks + Type qualifier (**`const`** or **`volatile`**) appears where it is not permitted. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2220.md b/docs/error-messages/compiler-errors-1/compiler-error-c2220.md index d5713a4bb64..0b5c251ab25 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2220.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2220.md @@ -10,6 +10,8 @@ ms.assetid: d610802c-64d7-40ad-a2a6-0ed0b6815a6c > warning treated as error - no object file generated +## Remarks + [/WX](../../build/reference/compiler-option-warning-level.md) tells the compiler to treat all warnings as errors. Because an error occurred, no object or executable file was generated. This error only appears when the **/WX** flag is set and a warning occurs during compilation. To fix this error, you must eliminate every warning in your project. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2222.md b/docs/error-messages/compiler-errors-1/compiler-error-c2222.md index 2acc13ec3b5..aa3d1675bc0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2222.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2222.md @@ -10,4 +10,6 @@ ms.assetid: 1c902054-5c77-41e6-a1cc-018f802460cd > unexpected type 'type': a base-class or member was expected +## Remarks + The initializer list can only initialize base classes or members of a type. To fix this error, verify that only base classes or members of the type are initialized in the initializer list. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2223.md b/docs/error-messages/compiler-errors-1/compiler-error-c2223.md index ddb52547339..fba2999c336 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2223.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2223.md @@ -10,6 +10,8 @@ ms.assetid: e4506f0f-0317-4a96-8a90-877a156d7939 > left of '->identifier' must point to struct/union +## Remarks + The operand to the left of `->` is not a pointer to a class, structure, or union. This error can be caused by a left operand that is an undefined variable (therefore type **`int`**). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2224.md b/docs/error-messages/compiler-errors-1/compiler-error-c2224.md index 973fa6b17e7..e1f675d36f7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2224.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2224.md @@ -10,6 +10,8 @@ ms.assetid: 27b93bbf-4ce7-47a3-a9c4-f4fbed689bdf > left of '.identifier' must have struct/union type +## Remarks + The operand to the left of the period (.) is not a class, structure, or union. This error can be caused by a left operand that is an undefined variable (therefore type **`int`**). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2226.md b/docs/error-messages/compiler-errors-1/compiler-error-c2226.md index cb39ac2a2dd..06e332ed40b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2226.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2226.md @@ -10,4 +10,6 @@ ms.assetid: b3aaa2a5-254a-46a9-a508-de2371ecffeb > syntax error : unexpected type 'type' +## Remarks + A syntax error occurs before or in the type specifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md index 770661a8a83..39545305f52 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md @@ -10,8 +10,12 @@ ms.assetid: d470e8b8-7e15-468b-84fa-37d1a0132271 > left of '->member' must point to class/struct/union/generic type +## Remarks + The operand to the left of `->` is not a pointer to a class, structure, or union. +## Example + The following sample generates C2227: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md index 27e80984ce6..11a8a0cdabc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md @@ -10,8 +10,12 @@ ms.assetid: 901cadb1-ce90-4ae0-a360-547a9ba2ca18 > left of '.identifier' must have class/struct/union +## Remarks + The operand to the left of the period (.) is not a class, structure, or union. +## Example + The following sample generates C2228: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md index fec73b43b76..42073aac2b4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md @@ -10,12 +10,16 @@ ms.assetid: 933c7cf2-a463-4e74-b0b4-59dedad987fb > type 'identifier' has an illegal zero-sized array +## Remarks + A member of a structure or bit field contains a zero-sized array that is not the last member. Because you can have a zero sized array as the last member of the struct, you must specify its size when you allocate the struct. If the zero sized array is not the last member of the struct, the compiler can't calculate the offset for the remaining fields. +## Example + The following sample generates C2229: ```cpp From f1c6d3d73e755cebceb6c48555624a136b0c23ca Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 23:06:41 +0800 Subject: [PATCH 0463/1799] Replace term "sample" with "example" for error references in range [C2201, C2230] --- .../compiler-errors-1/compiler-error-c2201.md | 2 +- .../compiler-errors-1/compiler-error-c2203.md | 2 +- .../compiler-errors-1/compiler-error-c2206.md | 2 +- .../compiler-errors-1/compiler-error-c2208.md | 2 +- .../compiler-errors-1/compiler-error-c2213.md | 2 +- .../compiler-errors-1/compiler-error-c2216.md | 6 +++--- .../compiler-errors-1/compiler-error-c2217.md | 2 +- .../compiler-errors-1/compiler-error-c2227.md | 2 +- .../compiler-errors-1/compiler-error-c2228.md | 2 +- .../compiler-errors-1/compiler-error-c2229.md | 2 +- 10 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md index fa16e96cf04..13e76c2b4ce 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md @@ -15,7 +15,7 @@ The exported identifier is **`static`**. ## Example -The following sample generates C2286, and shows how to fix it: +The following example generates C2286, and shows how to fix it: ```cpp // C2201.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md index 074ece82aac..ac7914b2af4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md @@ -16,7 +16,7 @@ With the **/Za** (ANSI) option, the **`delete`** operator can delete an entire a ## Example -The following sample generates C2203: +The following example generates C2203: ```cpp // C2203.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md index 657f17fd7a5..bbfae4ddc0e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md @@ -16,7 +16,7 @@ A **`typedef`** is used to define a function type. ## Example -The following sample generates C2206: +The following example generates C2206: ```cpp // C2206.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md index 3298a08661c..d77aaa48c87 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md @@ -16,7 +16,7 @@ An identifier resolving to a type name is in an aggregate declaration, but the c ## Example -The following sample generates C2208: +The following example generates C2208: ```cpp // C2208.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md index 3b81efc8df1..054648b694b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md @@ -16,7 +16,7 @@ The argument modifying **`__based`** is invalid. ## Example -The following sample generates C2213: +The following example generates C2213: ```cpp // C2213.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md index de2d71f978b..762d80dc56e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md @@ -16,7 +16,7 @@ Two keywords that are mutually exclusive were used together. ## Examples -The following sample generates C2216. +The following example generates C2216. ```cpp // C2216.cpp @@ -27,7 +27,7 @@ ref struct Y1 { }; ``` -The following sample generates C2216. +The following example generates C2216. ```cpp // C2216b.cpp @@ -38,7 +38,7 @@ public ref class X { }; ``` -The following sample generates C2216. +The following example generates C2216. ```cpp // C2216c.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md index 3c77379f25c..109b769ac33 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md @@ -16,7 +16,7 @@ The first function attribute requires the second attribute. ## Example -C2217 can occur if you attempt to bind a delegate to a CLR function that takes a variable number of arguments. If the function also has a param array overload, use that instead. The following sample generates C2217. +C2217 can occur if you attempt to bind a delegate to a CLR function that takes a variable number of arguments. If the function also has a param array overload, use that instead. The following example generates C2217. ```cpp // C2217.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md index 39545305f52..8a72d937044 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md @@ -16,7 +16,7 @@ The operand to the left of `->` is not a pointer to a class, structure, or union ## Example -The following sample generates C2227: +The following example generates C2227: ```cpp // C2227.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md index 11a8a0cdabc..653d4a5b002 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md @@ -16,7 +16,7 @@ The operand to the left of the period (.) is not a class, structure, or union. ## Example -The following sample generates C2228: +The following example generates C2228: ```cpp // C2228.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md index 42073aac2b4..899f5f6d093 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md @@ -20,7 +20,7 @@ If the zero sized array is not the last member of the struct, the compiler can't ## Example -The following sample generates C2229: +The following example generates C2229: ```cpp // C2229.cpp From d8b767255e56f9182283b44257ca5a1db03f0b3d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 19 Jul 2025 23:10:11 +0800 Subject: [PATCH 0464/1799] Update metadata for error references in range [C2201, C2230] --- .../error-messages/compiler-errors-1/compiler-error-c2201.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2203.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2204.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2205.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2206.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2207.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2208.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2212.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2213.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2216.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2217.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2218.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2219.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2220.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2222.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2223.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2224.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2226.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2227.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2228.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2229.md | 5 ++--- 21 files changed, 41 insertions(+), 61 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md index 13e76c2b4ce..01983a4cf4a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2201" title: "Compiler Error C2201" +description: "Learn more about: Compiler Error C2201" ms.date: 05/03/2021 f1_keywords: ["C2201"] helpviewer_keywords: ["C2201"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md index ac7914b2af4..1850f52d271 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2203" title: "Compiler Error C2203" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2203" +ms.date: 11/04/2016 f1_keywords: ["C2203"] helpviewer_keywords: ["C2203"] -ms.assetid: 5497df43-86f6-43d5-b6cb-723c4c589b10 --- # Compiler Error C2203 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2204.md b/docs/error-messages/compiler-errors-1/compiler-error-c2204.md index ae3a56a6902..b09f6a116a9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2204.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2204.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2204" title: "Compiler Error C2204" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2204" +ms.date: 11/04/2016 f1_keywords: ["C2204"] helpviewer_keywords: ["C2204"] -ms.assetid: bbe506d4-7863-44af-8709-161881c4b4ba --- # Compiler Error C2204 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2205.md b/docs/error-messages/compiler-errors-1/compiler-error-c2205.md index e1d21362a4b..6b073e8cc7c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2205.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2205.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2205" title: "Compiler Error C2205" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2205" +ms.date: 11/04/2016 f1_keywords: ["C2205"] helpviewer_keywords: ["C2205"] -ms.assetid: bfc19840-4a48-4da5-8e69-7069989f1d2c --- # Compiler Error C2205 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md index bbfae4ddc0e..611865407d5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2206" title: "Compiler Error C2206" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2206" +ms.date: 11/04/2016 f1_keywords: ["C2206"] helpviewer_keywords: ["C2206"] -ms.assetid: d7fba68b-aa28-4885-a9a0-27107358f066 --- # Compiler Error C2206 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2207.md b/docs/error-messages/compiler-errors-1/compiler-error-c2207.md index 2f3797ebbda..fab75ec1e1e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2207.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2207.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2207" title: "Compiler Error C2207" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2207" +ms.date: 11/04/2016 f1_keywords: ["C2207"] helpviewer_keywords: ["C2207"] -ms.assetid: d7d7b537-68f1-420a-9835-b5b6f2cb5cfd --- # Compiler Error C2207 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md index d77aaa48c87..6c3ca308787 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2208" title: "Compiler Error C2208" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2208" +ms.date: 11/04/2016 f1_keywords: ["C2208"] helpviewer_keywords: ["C2208"] -ms.assetid: 9ae704bc-bf70-45f1-8e47-0470f21edd4e --- # Compiler Error C2208 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2212.md b/docs/error-messages/compiler-errors-1/compiler-error-c2212.md index 81cb9a15b56..16a9f9f198b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2212.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2212.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2212" title: "Compiler Error C2212" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2212" +ms.date: 11/04/2016 f1_keywords: ["C2212"] helpviewer_keywords: ["C2212"] -ms.assetid: 3fdab304-272c-4d07-bfd4-fad75170e536 --- # Compiler Error C2212 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md index 054648b694b..667f53b64db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2213" title: "Compiler Error C2213" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2213" +ms.date: 11/04/2016 f1_keywords: ["C2213"] helpviewer_keywords: ["C2213"] -ms.assetid: ff012278-7f3b-4d49-aaed-2349756f6225 --- # Compiler Error C2213 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md index 762d80dc56e..5d0d49c0e9e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2216" title: "Compiler Error C2216" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2216" +ms.date: 11/04/2016 f1_keywords: ["C2216"] helpviewer_keywords: ["C2216"] -ms.assetid: 250f6bdc-a5e1-495f-a1e8-6e8e7021ad9d --- # Compiler Error C2216 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md index 109b769ac33..b13e45b5eec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2217" title: "Compiler Error C2217" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2217" +ms.date: 11/04/2016 f1_keywords: ["C2217"] helpviewer_keywords: ["C2217"] -ms.assetid: 1ce1e3f5-4171-4376-804d-967f7e612935 --- # Compiler Error C2217 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2218.md b/docs/error-messages/compiler-errors-1/compiler-error-c2218.md index 2015d2bb815..07e17522d3b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2218.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2218.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2218" title: "Compiler Error C2218" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2218" +ms.date: 11/04/2016 f1_keywords: ["C2218"] helpviewer_keywords: ["C2218"] -ms.assetid: b0f55da4-8edb-4b45-b298-1a091981bd7b --- # Compiler Error C2218 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2219.md b/docs/error-messages/compiler-errors-1/compiler-error-c2219.md index 5a12002bc6e..499519f546c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2219.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2219.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2219" title: "Compiler Error C2219" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2219" +ms.date: 11/04/2016 f1_keywords: ["C2219"] helpviewer_keywords: ["C2219"] -ms.assetid: 2cfe9a75-6890-46a1-a127-79a7def78e94 --- # Compiler Error C2219 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2220.md b/docs/error-messages/compiler-errors-1/compiler-error-c2220.md index 0b5c251ab25..0660cff0df4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2220.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2220.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2220" title: "Compiler Error C2220" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2220" +ms.date: 11/04/2016 f1_keywords: ["C2220"] helpviewer_keywords: ["C2220"] -ms.assetid: d610802c-64d7-40ad-a2a6-0ed0b6815a6c --- # Compiler Error C2220 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2222.md b/docs/error-messages/compiler-errors-1/compiler-error-c2222.md index aa3d1675bc0..894171131f6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2222.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2222.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2222" title: "Compiler Error C2222" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2222" +ms.date: 11/04/2016 f1_keywords: ["C2222"] helpviewer_keywords: ["C2222"] -ms.assetid: 1c902054-5c77-41e6-a1cc-018f802460cd --- # Compiler Error C2222 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2223.md b/docs/error-messages/compiler-errors-1/compiler-error-c2223.md index fba2999c336..4607f1838a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2223.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2223.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2223" title: "Compiler Error C2223" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2223" +ms.date: 11/04/2016 f1_keywords: ["C2223"] helpviewer_keywords: ["C2223"] -ms.assetid: e4506f0f-0317-4a96-8a90-877a156d7939 --- # Compiler Error C2223 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2224.md b/docs/error-messages/compiler-errors-1/compiler-error-c2224.md index e1f675d36f7..7d13d46a0e9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2224.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2224.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2224" title: "Compiler Error C2224" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2224" +ms.date: 11/04/2016 f1_keywords: ["C2224"] helpviewer_keywords: ["C2224"] -ms.assetid: 27b93bbf-4ce7-47a3-a9c4-f4fbed689bdf --- # Compiler Error C2224 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2226.md b/docs/error-messages/compiler-errors-1/compiler-error-c2226.md index 06e332ed40b..7576eab5fea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2226.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2226.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2226" title: "Compiler Error C2226" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2226" +ms.date: 11/04/2016 f1_keywords: ["C2226"] helpviewer_keywords: ["C2226"] -ms.assetid: b3aaa2a5-254a-46a9-a508-de2371ecffeb --- # Compiler Error C2226 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md index 8a72d937044..4c84efc13a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2227" title: "Compiler Error C2227" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2227" +ms.date: 11/04/2016 f1_keywords: ["C2227"] helpviewer_keywords: ["C2227"] -ms.assetid: d470e8b8-7e15-468b-84fa-37d1a0132271 --- # Compiler Error C2227 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md index 653d4a5b002..f0605e69fc8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2228" title: "Compiler Error C2228" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2228" +ms.date: 11/04/2016 f1_keywords: ["C2228"] helpviewer_keywords: ["C2228"] -ms.assetid: 901cadb1-ce90-4ae0-a360-547a9ba2ca18 --- # Compiler Error C2228 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md index 899f5f6d093..a77432e3f15 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2229" title: "Compiler Error C2229" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2229" +ms.date: 11/04/2016 f1_keywords: ["C2229"] helpviewer_keywords: ["C2229"] -ms.assetid: 933c7cf2-a463-4e74-b0b4-59dedad987fb --- # Compiler Error C2229 From 6d2ec4ed7685e83b085b7ddda7f6996371a13b5d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 17:55:57 +0800 Subject: [PATCH 0465/1799] Fix title in C4335 warning reference --- docs/error-messages/compiler-warnings/compiler-warning-c4335.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md index e57e115b0be..cfb45113dd3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md @@ -1,6 +1,6 @@ --- description: "Learn more about: Compiler Warning (level 1) C4335" -title: "Compiler Warning(level 1) C4335" +title: "Compiler Warning (level 1) C4335" ms.date: "11/04/2016" f1_keywords: ["C4335"] helpviewer_keywords: ["C4335"] From 1244cc2c4945a13114301becc2d7ad9754d8e573 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 17:57:05 +0800 Subject: [PATCH 0466/1799] Add "Remarks" heading in C4335 warning reference --- docs/error-messages/compiler-warnings/compiler-warning-c4335.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md index cfb45113dd3..ba12a44d068 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4335"] > Mac file format detected: please convert the source file to either DOS or UNIX format +## Remarks + 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 only issued once per translation unit. Therefore, if there are multiple `#include` directives that specify files in Macintosh format, C4335 is emitted once. From 9b70f50193c8691fbd8f57f1c3bcd1f89c31e62e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 17:57:30 +0800 Subject: [PATCH 0467/1799] Tweak "Example" text in C4335 warning reference --- docs/error-messages/compiler-warnings/compiler-warning-c4335.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md index ba12a44d068..eee802a7b59 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md @@ -19,7 +19,7 @@ One way to generate files in Macintosh format is by using the **Advanced Save Op ## Example -The following sample generates C4335. +The following example generates C4335: ```cpp // C4335 expected From 31cd15c287fcc13bbf91cb8d98047d0097ff84b7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 17:58:07 +0800 Subject: [PATCH 0468/1799] Update metadata in C4335 warning reference --- .../compiler-warnings/compiler-warning-c4335.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md index eee802a7b59..2f17fe0d623 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4335" title: "Compiler Warning (level 1) C4335" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4335" +ms.date: 11/04/2016 f1_keywords: ["C4335"] helpviewer_keywords: ["C4335"] --- From ed7f32ddb701af4b62ed70a2834b68fd6f5ffdf4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 18:12:56 +0800 Subject: [PATCH 0469/1799] Update warning level flag for example in C4373 warning reference --- .../compiler-warnings/compiler-warning-level-3-c4373.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md index 4bcae673036..07495b2ee5a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md @@ -21,7 +21,7 @@ The following code example generates warning C4373. To resolve this issue, make ```cpp // c4373.cpp -// compile with: /c /W3 +// compile with: /c /W4 #include struct Base { From 4815abc9048f4cc8e660e21376dcd59b8b691b7d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 18:14:03 +0800 Subject: [PATCH 0470/1799] Update metadata in C4373 warning reference --- .../compiler-warnings/compiler-warning-level-3-c4373.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md index 07495b2ee5a..1394a4e481f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4373" title: "Compiler Warning (level 4) C4373" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4373" +ms.date: 11/04/2016 f1_keywords: ["C4373"] helpviewer_keywords: ["C4373"] --- From ffe23f283bce68d0b82cf4901951750fa20365d3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 18:33:26 +0800 Subject: [PATCH 0471/1799] Add missing commas after "For more information" --- docs/build/reference/files-created-for-clr-projects.md | 2 +- docs/build/reference/return-value-of-cl-exe.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2349.md | 2 +- docs/extensions/string-cpp-component-extensions.md | 2 +- docs/mfc/mfc-com.md | 2 +- docs/mfc/reference/ctabview-class.md | 2 +- docs/parallel/amp/graphics-cpp-amp.md | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/build/reference/files-created-for-clr-projects.md b/docs/build/reference/files-created-for-clr-projects.md index 8864195572c..2e3638129fd 100644 --- a/docs/build/reference/files-created-for-clr-projects.md +++ b/docs/build/reference/files-created-for-clr-projects.md @@ -11,7 +11,7 @@ When you use Visual C++ templates to create your projects, several files are cre |File name|File description| |---------------|----------------------| -|AssemblyInfo.cpp|The file that contains information (that is, attributes, files, resources, types, versioning information, signing information, and so on) for modifying the project's assembly metadata. For more information see [Assembly Concepts](/dotnet/framework/app-domains/assembly-contents).| +|AssemblyInfo.cpp|The file that contains information (that is, attributes, files, resources, types, versioning information, signing information, and so on) for modifying the project's assembly metadata. For more information, see [Assembly Concepts](/dotnet/framework/app-domains/assembly-contents).| |*projname*.asmx|A text file that references managed classes that encapsulate the functionality of the XML Web service.| |*projname*.cpp|The main source file and entry point into the application that Visual Studio created for you. Identifies the project .dll file and the project namespace. Provide your own code in this file.| |*projname*.vsdisco|An XML deployment file containing links to other resources that describe the XML Web service.| diff --git a/docs/build/reference/return-value-of-cl-exe.md b/docs/build/reference/return-value-of-cl-exe.md index ceb9ff7972d..2f118400249 100644 --- a/docs/build/reference/return-value-of-cl-exe.md +++ b/docs/build/reference/return-value-of-cl-exe.md @@ -13,7 +13,7 @@ The return value of cl.exe can be useful if you are compiling from a script, pow There are too many possible error exit codes for cl.exe to list them all. You can look up an error code in the winerror.h or ntstatus.h files included in the Windows Software Development Kit in the %ProgramFiles(x86)%\Windows Kits\\version\Include\shared\ directory. Error codes returned in decimal must be converted to hexadecimal for search. For example, an error code of -1073741620 converted to hexadecimal is 0xC00000CC. This error is found in ntstatus.h, where the corresponding message is "The specified share name cannot be found on the remote server." For a downloadable list of Windows error codes, see [`[MS-ERREF]` Windows Error Codes](/openspecs/windows_protocols/MS-ERREF). -You can also use the error lookup utility in Visual Studio to find out what a compiler error message means. In a Visual Studio command shell, enter **errlook.exe** to start the utility; or in the Visual Studio IDE, on the menu bar, choose **Tools**, **Error Lookup**. Enter the error value to find the descriptive text associated with the error. For more information see [ERRLOOK Reference](errlook-reference.md). +You can also use the error lookup utility in Visual Studio to find out what a compiler error message means. In a Visual Studio command shell, enter **errlook.exe** to start the utility; or in the Visual Studio IDE, on the menu bar, choose **Tools**, **Error Lookup**. Enter the error value to find the descriptive text associated with the error. For more information, see [ERRLOOK Reference](errlook-reference.md). ## Remarks diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md index 4b596fc273d..6190f18c57a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md @@ -10,4 +10,4 @@ ms.assetid: ce9f2e65-fda0-41b6-9c4a-538607136396 'function' cannot be compiled as managed: 'reason'; use #pragma unmanaged -For more information see [Compiler Warning (level 1 and 3) C4793](../../error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md). +For more information, see [Compiler Warning (level 1 and 3) C4793](../../error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md). diff --git a/docs/extensions/string-cpp-component-extensions.md b/docs/extensions/string-cpp-component-extensions.md index de9ff62f36e..972ab5c2329 100644 --- a/docs/extensions/string-cpp-component-extensions.md +++ b/docs/extensions/string-cpp-component-extensions.md @@ -49,7 +49,7 @@ When passed a , the compiler will box, if necessary, and the > [!NOTE] > The caret ("^") indicates that the declared variable is a handle to a C++/CLI managed object. -For more information see [String and Character Literals](../cpp/string-and-character-literals-cpp.md). +For more information, see [String and Character Literals](../cpp/string-and-character-literals-cpp.md). ### Requirements diff --git a/docs/mfc/mfc-com.md b/docs/mfc/mfc-com.md index eb5282b585c..0a46f3cb002 100644 --- a/docs/mfc/mfc-com.md +++ b/docs/mfc/mfc-com.md @@ -10,7 +10,7 @@ ms.assetid: 7646bdcb-3a06-4ed5-9386-9b00f3979dcb A subset of MFC is designed to support COM, while most of the Active Template Library (ATL) is designed for COM programming. This section of topics describes MFC's support for COM. -Active technologies (such as ActiveX controls, Active document containment, OLE, and so on) use the Component Object Model (COM) to enable software components to interact with one another in a networked environment, regardless of the language with which they were created. Active technologies can be used to create applications that run on the desktop or the Internet. For more information see [Introduction to COM](../atl/introduction-to-com.md) or [The Component Object Model](/windows/win32/com/the-component-object-model). +Active technologies (such as ActiveX controls, Active document containment, OLE, and so on) use the Component Object Model (COM) to enable software components to interact with one another in a networked environment, regardless of the language with which they were created. Active technologies can be used to create applications that run on the desktop or the Internet. For more information, see [Introduction to COM](../atl/introduction-to-com.md) or [The Component Object Model](/windows/win32/com/the-component-object-model). Active technologies include both client and server technologies, including the following: diff --git a/docs/mfc/reference/ctabview-class.md b/docs/mfc/reference/ctabview-class.md index b084e0afbd3..9ab3109c806 100644 --- a/docs/mfc/reference/ctabview-class.md +++ b/docs/mfc/reference/ctabview-class.md @@ -208,7 +208,7 @@ TRUE if the specified view was made active, FALSE if the view's index is invalid ### Remarks -For more information see [CMFCTabCtrl::SetActiveTab](../../mfc/reference/cmfctabctrl-class.md#setactivetab). +For more information, see [CMFCTabCtrl::SetActiveTab](../../mfc/reference/cmfctabctrl-class.md#setactivetab). ## See also diff --git a/docs/parallel/amp/graphics-cpp-amp.md b/docs/parallel/amp/graphics-cpp-amp.md index 2de8ab623c9..5368ba8b88e 100644 --- a/docs/parallel/amp/graphics-cpp-amp.md +++ b/docs/parallel/amp/graphics-cpp-amp.md @@ -377,7 +377,7 @@ void write2ComponentTexture() { Texture views whose elements are based on floating-point types—for example, float, float_2, or float_4—can also be read by using texture sampling to take advantage of hardware support for various filtering modes and addressing modes. C++ AMP supports the two filtering modes that are most common in compute scenarios—point-filtering (nearest-neighbor) and linear-filtering (weighted average)—and four addressing modes—wrapped, mirrored, clamped, and border. For more information about addressing modes, see [address_mode Enumeration](reference/concurrency-graphics-namespace-enums.md#address_mode). -In addition to modes that C++ AMP supports directly, you can access other filtering modes and addressing modes of the underlying platform by using the interop APIs to adopt a texture sampler that was created by using the platform APIs directly. For example, Direct3D supports other filtering modes such as anisotropic filtering, and can apply a different addressing mode to each dimension of a texture. You could create a texture sampler whose coordinates are wrapped vertically, mirrored horizontally, and sampled with anisotropic filtering by using the Direct3D APIs, and then leverage the sampler in your C++ AMP code by using the `make_sampler` interop API. For more information see [Texture Sampling in C++ AMP](/archive/blogs/nativeconcurrency/texture-sampling-in-c-amp) on the Parallel Programming in Native Code blog. +In addition to modes that C++ AMP supports directly, you can access other filtering modes and addressing modes of the underlying platform by using the interop APIs to adopt a texture sampler that was created by using the platform APIs directly. For example, Direct3D supports other filtering modes such as anisotropic filtering, and can apply a different addressing mode to each dimension of a texture. You could create a texture sampler whose coordinates are wrapped vertically, mirrored horizontally, and sampled with anisotropic filtering by using the Direct3D APIs, and then leverage the sampler in your C++ AMP code by using the `make_sampler` interop API. For more information, see [Texture Sampling in C++ AMP](/archive/blogs/nativeconcurrency/texture-sampling-in-c-amp) on the Parallel Programming in Native Code blog. Texture views also support the reading of mipmaps. Read-only texture views (those that have a const element type) offer the most flexibility because a range of mip-levels that is determined at instantiation can be dynamically sampled, and because elements that have 1, 2, or 4 components are supported. Read-write texture views that have elements that have one component also support mipmaps, but only of a level that's determined at instantiation. For more information, see [Texture with Mipmaps](/archive/blogs/nativeconcurrency/texture-with-mipmaps) on the Parallel Programming in Native Code blog. From a41a42b152e219eb56adf6e9be927d017ad2242d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 18:37:06 +0800 Subject: [PATCH 0472/1799] Update metadata in a couple of topics --- docs/build/reference/files-created-for-clr-projects.md | 5 ++--- docs/build/reference/return-value-of-cl-exe.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2349.md | 5 ++--- docs/mfc/mfc-com.md | 5 ++--- docs/mfc/reference/ctabview-class.md | 5 ++--- 5 files changed, 10 insertions(+), 15 deletions(-) diff --git a/docs/build/reference/files-created-for-clr-projects.md b/docs/build/reference/files-created-for-clr-projects.md index 2e3638129fd..1aa648278b1 100644 --- a/docs/build/reference/files-created-for-clr-projects.md +++ b/docs/build/reference/files-created-for-clr-projects.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Files Created for CLR Projects" title: "Files Created for CLR Projects" -ms.date: "11/04/2016" +description: "Learn more about: Files Created for CLR Projects" +ms.date: 11/04/2016 helpviewer_keywords: ["Visual Studio C++ projects, CLR programming", ".NET applications, C++"] -ms.assetid: 59ae9020-5f26-4ad0-bbdd-97c2e2023a20 --- # Files Created for CLR Projects diff --git a/docs/build/reference/return-value-of-cl-exe.md b/docs/build/reference/return-value-of-cl-exe.md index 2f118400249..26806b0ec0c 100644 --- a/docs/build/reference/return-value-of-cl-exe.md +++ b/docs/build/reference/return-value-of-cl-exe.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Return Value of cl.exe" title: "Return Value of cl.exe" -ms.date: "09/05/2018" +description: "Learn more about: Return Value of cl.exe" +ms.date: 09/05/2018 helpviewer_keywords: ["cl.exe compiler, return value"] -ms.assetid: 7c2d7f33-ee0d-4199-8ef4-75fe2b007670 --- # Return Value of cl.exe diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md index 6190f18c57a..3b2cf2a02a2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2349" title: "Compiler Error C2349" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2349" +ms.date: 11/04/2016 f1_keywords: ["C2349"] helpviewer_keywords: ["C2349"] -ms.assetid: ce9f2e65-fda0-41b6-9c4a-538607136396 --- # Compiler Error C2349 diff --git a/docs/mfc/mfc-com.md b/docs/mfc/mfc-com.md index 0a46f3cb002..9f5a4136d12 100644 --- a/docs/mfc/mfc-com.md +++ b/docs/mfc/mfc-com.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: MFC COM" title: "MFC COM" -ms.date: "09/12/2018" +description: "Learn more about: MFC COM" +ms.date: 09/12/2018 f1_keywords: ["MFC COM (MFC)"] helpviewer_keywords: ["MFC, COM support", "MFC ActiveX controls [MFC], COM support in MFC", "MFC COM [MFC]", "ActiveX controls [MFC], COM object model", "Active technology [MFC]", "COM [MFC], MFC support"] -ms.assetid: 7646bdcb-3a06-4ed5-9386-9b00f3979dcb --- # MFC COM diff --git a/docs/mfc/reference/ctabview-class.md b/docs/mfc/reference/ctabview-class.md index 9ab3109c806..82983a5e29a 100644 --- a/docs/mfc/reference/ctabview-class.md +++ b/docs/mfc/reference/ctabview-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CTabView Class" title: "CTabView Class" -ms.date: "11/04/2016" +description: "Learn more about: CTabView Class" +ms.date: 11/04/2016 f1_keywords: ["CTabView", "AFXTABVIEW/CTabView", "AFXTABVIEW/CTabView::AddView", "AFXTABVIEW/CTabView::FindTab", "AFXTABVIEW/CTabView::GetActiveView", "AFXTABVIEW/CTabView::GetTabControl", "AFXTABVIEW/CTabView::RemoveView", "AFXTABVIEW/CTabView::SetActiveView", "AFXTABVIEW/CTabView::IsScrollBar", "AFXTABVIEW/CTabView::OnActivateView"] helpviewer_keywords: ["CTabView [MFC], AddView", "CTabView [MFC], FindTab", "CTabView [MFC], GetActiveView", "CTabView [MFC], GetTabControl", "CTabView [MFC], RemoveView", "CTabView [MFC], SetActiveView", "CTabView [MFC], IsScrollBar", "CTabView [MFC], OnActivateView"] -ms.assetid: 8e6ecd9d-d28d-432b-8ec8-0446f0204d52 --- # CTabView Class From 245c698a5fd18ff26dd83c684346527134c18a9c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 19:04:40 +0800 Subject: [PATCH 0473/1799] Add blockquotes for error messages in range [C2231, C2260] --- docs/error-messages/compiler-errors-1/compiler-error-c2231.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2232.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2233.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2234.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2236.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2238.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2241.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2242.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2243.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2244.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2245.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2246.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2247.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2249.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2250.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2251.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2252.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2253.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2254.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2255.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2256.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2258.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md index 6f95cb15e9f..fef278a1636 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md @@ -8,7 +8,7 @@ ms.assetid: 677c5c66-d30f-4c3b-bbb9-760858d56477 --- # Compiler Error C2231 -'.' : left operand points to 'class-key', use '->' +> '.' : left operand points to 'class-key', use '->' The operand to the left of the member-selection operation (.) is a pointer instead of a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md index 46af61cbe1f..4a16fb3245d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md @@ -8,7 +8,7 @@ ms.assetid: 76f302b7-30a7-4a81-9a39-b4edde33b54c --- # Compiler Error C2232 -'->' : left operand has 'class-key' type, use '.' +> '->' : left operand has 'class-key' type, use '.' The operand to the left of the `->` operator is not a pointer. Use the period (.) operator for a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md index cb1b6646bc1..3278e951c64 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md @@ -8,7 +8,7 @@ ms.assetid: 236bdf0b-9607-4f26-a249-d8def0b1333c --- # Compiler Error C2233 -'identifier' : arrays of objects containing zero-size arrays are illegal +> 'identifier' : arrays of objects containing zero-size arrays are illegal Each object in an array must contain at least one element. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md index 2b08baaddf2..31a4eb764e0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md @@ -8,7 +8,7 @@ ms.assetid: cfa42458-c803-4717-a017-9eca1c0cbfb0 --- # Compiler Error C2234 -'name' : arrays of references are illegal +> 'name' : arrays of references are illegal Because pointers to references are not allowed, arrays of references are not possible. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md index fee5e16f054..b90dee51aea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md @@ -8,7 +8,7 @@ ms.assetid: 0b6771a7-a783-4729-9c3d-7a3339c432cc --- # Compiler Error C2236 -unexpected token 'identifier'. Did you forget a ';'? +> unexpected token 'identifier'. Did you forget a ';'? The identifier is already defined as a type and cannot be overridden by a user-defined type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md index 26743ab065b..38ae6b4c1ba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md @@ -8,7 +8,7 @@ ms.assetid: 3d53060c-d6b7-4603-b9cf-d7c65eb64cd2 --- # Compiler Error C2238 -unexpected token(s) preceding 'token' +> unexpected token(s) preceding 'token' An incorrect token was found. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2241.md b/docs/error-messages/compiler-errors-1/compiler-error-c2241.md index f1793fd8d9b..67b3ae02b22 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2241.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2241.md @@ -8,7 +8,7 @@ ms.assetid: 2f4e2c2c-b95c-4afe-bbe0-4214cd39d140 --- # Compiler Error C2241 -'identifier' : member access is restricted +> 'identifier' : member access is restricted Code attempts to access a private or protected member. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2242.md b/docs/error-messages/compiler-errors-1/compiler-error-c2242.md index ccf78a2612b..1436efd1842 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2242.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2242.md @@ -8,6 +8,6 @@ ms.assetid: e1b687ed-4460-4c26-9f7e-c43e65c6dd65 --- # Compiler Error C2242 -typedef name cannot follow class/struct/union +> typedef name cannot follow class/struct/union A **`typedef`** name appears at the end of a qualified name. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md index e12e7174e74..ec785d8598a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md @@ -8,7 +8,7 @@ ms.assetid: b90065bb-d251-4ba9-8b4c-280ee13fa9c0 --- # Compiler Error C2243 -'conversion type' conversion from 'type1' to 'type2' exists, but is inaccessible +> 'conversion type' conversion from 'type1' to 'type2' exists, but is inaccessible Access protection (**`protected`** or **`private`**) prevented conversion from a pointer to a derived class to a pointer to the base class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md index eed68eeec0e..2633ef17f56 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md @@ -8,7 +8,7 @@ ms.assetid: d9911c12-ceb5-4f93-ac47-b44a485215c2 --- # Compiler Error C2244 -'identifier' : unable to match function definition to an existing declaration +> 'identifier' : unable to match function definition to an existing declaration An unusual use of the unary + operator was used in front of a function call that did not have parenthesis. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md index cf96d1724c4..6314e86a1e1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md @@ -8,7 +8,7 @@ ms.assetid: 08aaeadf-10ec-485a-b2a6-6e775289082b --- # Compiler Error C2245 -non-existent member function 'function' specified as friend (member function signature does not match any overload) +> non-existent member function 'function' specified as friend (member function signature does not match any overload) A function specified as a friend was not found by the compiler. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md index c2ebd50d80a..47203f5c45c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md @@ -8,7 +8,7 @@ ms.assetid: 4f3e4f83-21f3-4256-af96-43e0bb060311 --- # Compiler Error C2246 -'identifier' : illegal static data member in locally defined class +> 'identifier' : illegal static data member in locally defined class A member of a class, structure, or union with local scope is declared **`static`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md index 6fb7fea7989..7c4394949bd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md @@ -8,7 +8,7 @@ ms.assetid: 72efa03e-615e-4ef9-aede-0a98654b20fd --- # Compiler Error C2247 -'identifier' not accessible because 'class' uses 'specifier' to inherit from 'class' +> 'identifier' not accessible because 'class' uses 'specifier' to inherit from 'class' `identifier` is inherited from a class declared with private or protected access. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md index 2b33cb4e285..b225f63e4c9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md @@ -8,7 +8,7 @@ ms.assetid: bdd6697c-e04b-49b9-8e40-d9eb6d74f2b6 --- # Compiler Error C2249 -'member' : no accessible path to access member declared in virtual base 'class' +> 'member' : no accessible path to access member declared in virtual base 'class' The `member` is inherited from a nonpublic **`virtual`** base class or structure. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md index c4ac513175e..71524c1f105 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md @@ -8,7 +8,7 @@ ms.assetid: f990986f-5c7d-4af4-a25c-b35540f1e217 --- # Compiler Error C2250 -'identifier' : ambiguous inheritance of 'class::member' +> 'identifier' : ambiguous inheritance of 'class::member' The derived class inherits more than one override of a virtual function of a virtual base class. These overrides are ambiguous in the derived class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md index 77ec80c5746..f6f6a324304 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md @@ -8,7 +8,7 @@ ms.assetid: fefe050c-f8d3-4316-b237-8007dbcdd3bf --- # Compiler Error C2251 -namespace 'namespace' does not have a member 'member' - Did you mean 'member'? +> namespace 'namespace' does not have a member 'member' - Did you mean 'member'? The compiler was not able to find an identifier in the specified namespace. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md index 7eaf55a4a0f..9fb28bcc524 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md @@ -8,7 +8,7 @@ ms.assetid: fee74ab9-1997-4615-82fe-e6d1fe3aacd9 --- # Compiler Error C2252 -cannot explicitly instantiate template in current scope +> cannot explicitly instantiate template in current scope The compiler detected a problem with an explicit instantiation of a template. For example, you cannot explicitly instantiate a template in a function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md index 95a67878c5b..555c85cba53 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md @@ -8,7 +8,7 @@ ms.assetid: bd6445ae-b2c1-4669-9657-a8f4acf80b16 --- # Compiler Error C2253 -'function' : pure specifier or abstract override specifier only allowed on virtual function +> 'function' : pure specifier or abstract override specifier only allowed on virtual function A nonvirtual function is specified as pure **`virtual`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md index 0f7436b72b5..30629f0d455 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md @@ -8,7 +8,7 @@ ms.assetid: 49bb3d7e-3bdf-4af6-937c-fa627be412a9 --- # Compiler Error C2254 -'function' : pure specifier or abstract override specifier not allowed on friend function +> 'function' : pure specifier or abstract override specifier not allowed on friend function A **`friend`** function is specified as pure **`virtual`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md index fa25eb214a5..63f0eae7a15 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md @@ -8,7 +8,7 @@ ms.assetid: 67dc4cb0-de6b-4405-bd64-d47736367a93 --- # Compiler Error C2255 -'element' : not allowed outside of a class definition +> 'element' : not allowed outside of a class definition For example, a nonmember function is declared a **`friend`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md index c0c1e5daac7..7ff7ca58371 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md @@ -8,7 +8,7 @@ ms.assetid: 171fa2bc-8c72-49cd-afe5-d723b7acd3c5 --- # Compiler Error C2256 -illegal use of friend specifier on 'function' +> illegal use of friend specifier on 'function' A destructor or constructor cannot be specified as a [friend](../../cpp/friend-cpp.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md index 1e31e3d7671..6f3adc52755 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md @@ -8,7 +8,7 @@ ms.assetid: 105eaa87-befb-4ecb-9a3f-e09e14d2f5bf --- # Compiler Error C2258 -illegal pure syntax, must be '= 0' +> illegal pure syntax, must be '= 0' A pure virtual function is declared with incorrect syntax. From 6756cd961b6aa9000983fe031c0c7c4fcb9d228e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 19:10:34 +0800 Subject: [PATCH 0474/1799] Add "Remarks" and "Example" headings for error references in range [C2231, C2260] --- docs/error-messages/compiler-errors-1/compiler-error-c2231.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2232.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2233.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2234.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2236.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2238.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2241.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2242.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2243.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2244.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2245.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2246.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2247.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2248.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2249.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2250.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2251.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2252.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2253.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2254.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2255.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2256.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2258.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2259.md | 4 ++++ 24 files changed, 87 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md index fef278a1636..3c7345b2937 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md @@ -10,8 +10,12 @@ ms.assetid: 677c5c66-d30f-4c3b-bbb9-760858d56477 > '.' : left operand points to 'class-key', use '->' +## Remarks + The operand to the left of the member-selection operation (.) is a pointer instead of a class, structure, or union. +## Example + The following sample generates C2231: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md index 4a16fb3245d..39c0057dbfa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md @@ -10,8 +10,12 @@ ms.assetid: 76f302b7-30a7-4a81-9a39-b4edde33b54c > '->' : left operand has 'class-key' type, use '.' +## Remarks + The operand to the left of the `->` operator is not a pointer. Use the period (.) operator for a class, structure, or union. +## Example + The following sample generates C2232: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md index 3278e951c64..8c581360ac1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md @@ -10,8 +10,12 @@ ms.assetid: 236bdf0b-9607-4f26-a249-d8def0b1333c > 'identifier' : arrays of objects containing zero-size arrays are illegal +## Remarks + Each object in an array must contain at least one element. +## Example + The following sample generates C2233: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md index 31a4eb764e0..9f686d1fd6a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md @@ -10,8 +10,12 @@ ms.assetid: cfa42458-c803-4717-a017-9eca1c0cbfb0 > 'name' : arrays of references are illegal +## Remarks + Because pointers to references are not allowed, arrays of references are not possible. +## Example + The following sample generates C2234: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md index b90dee51aea..306c49f7d94 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md @@ -10,8 +10,12 @@ ms.assetid: 0b6771a7-a783-4729-9c3d-7a3339c432cc > unexpected token 'identifier'. Did you forget a ';'? +## Remarks + The identifier is already defined as a type and cannot be overridden by a user-defined type. +## Example + The following sample generates C2236: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md index 38ae6b4c1ba..674669a1aca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md @@ -10,8 +10,12 @@ ms.assetid: 3d53060c-d6b7-4603-b9cf-d7c65eb64cd2 > unexpected token(s) preceding 'token' +## Remarks + An incorrect token was found. +## Example + The following sample generates C2238: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2241.md b/docs/error-messages/compiler-errors-1/compiler-error-c2241.md index 67b3ae02b22..7de089058fb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2241.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2241.md @@ -10,6 +10,8 @@ ms.assetid: 2f4e2c2c-b95c-4afe-bbe0-4214cd39d140 > 'identifier' : member access is restricted +## Remarks + Code attempts to access a private or protected member. ### To fix by using the following possible solutions diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2242.md b/docs/error-messages/compiler-errors-1/compiler-error-c2242.md index 1436efd1842..b7a50c92c2c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2242.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2242.md @@ -10,4 +10,6 @@ ms.assetid: e1b687ed-4460-4c26-9f7e-c43e65c6dd65 > typedef name cannot follow class/struct/union +## Remarks + A **`typedef`** name appears at the end of a qualified name. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md index ec785d8598a..f2a2c48e8d8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md @@ -10,8 +10,12 @@ ms.assetid: b90065bb-d251-4ba9-8b4c-280ee13fa9c0 > 'conversion type' conversion from 'type1' to 'type2' exists, but is inaccessible +## Remarks + Access protection (**`protected`** or **`private`**) prevented conversion from a pointer to a derived class to a pointer to the base class. +## Example + The following sample generates C2243: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md index 2633ef17f56..fce7ac39bb6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md @@ -10,10 +10,14 @@ ms.assetid: d9911c12-ceb5-4f93-ac47-b44a485215c2 > 'identifier' : unable to match function definition to an existing declaration +## Remarks + An unusual use of the unary + operator was used in front of a function call that did not have parenthesis. This error only occurs in C++ projects. +## Examples + The following sample generates C2244: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md index 6314e86a1e1..2fb00bc883c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md @@ -10,8 +10,12 @@ ms.assetid: 08aaeadf-10ec-485a-b2a6-6e775289082b > non-existent member function 'function' specified as friend (member function signature does not match any overload) +## Remarks + A function specified as a friend was not found by the compiler. +## Example + The following sample generates C2245: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md index 47203f5c45c..a85d17f3598 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md @@ -10,8 +10,12 @@ ms.assetid: 4f3e4f83-21f3-4256-af96-43e0bb060311 > 'identifier' : illegal static data member in locally defined class +## Remarks + A member of a class, structure, or union with local scope is declared **`static`**. +## Example + The following sample generates C2246: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md index 7c4394949bd..f2bb4a14847 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md @@ -10,8 +10,12 @@ ms.assetid: 72efa03e-615e-4ef9-aede-0a98654b20fd > 'identifier' not accessible because 'class' uses 'specifier' to inherit from 'class' +## Remarks + `identifier` is inherited from a class declared with private or protected access. +## Examples + The following sample generates C2247: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2248.md b/docs/error-messages/compiler-errors-1/compiler-error-c2248.md index 81f0232666f..cd7e67afa48 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2248.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2248.md @@ -14,7 +14,7 @@ ms.assetid: 7a3ba0e8-d3b9-4bb9-95db-81ef17e31d23 Members of a derived class can't access **`private`** members of a base class. You can't access **`private`** or **`protected`** members of class instances. -## Example +## Examples The following sample generates C2248 when `private` or `protected` members of a class are accessed from outside the class. To fix this issue, don't access these members directly outside the class. Use `public` member data and member functions to interact with the class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md index b225f63e4c9..8a31cd7ff79 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md @@ -10,6 +10,8 @@ ms.assetid: bdd6697c-e04b-49b9-8e40-d9eb6d74f2b6 > 'member' : no accessible path to access member declared in virtual base 'class' +## Remarks + The `member` is inherited from a nonpublic **`virtual`** base class or structure. ## Examples diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md index 71524c1f105..845fa9125c3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md @@ -10,8 +10,12 @@ ms.assetid: f990986f-5c7d-4af4-a25c-b35540f1e217 > 'identifier' : ambiguous inheritance of 'class::member' +## Remarks + The derived class inherits more than one override of a virtual function of a virtual base class. These overrides are ambiguous in the derived class. +## Example + The following sample generates C2286: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md index f6f6a324304..132a488f385 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md @@ -10,8 +10,12 @@ ms.assetid: fefe050c-f8d3-4316-b237-8007dbcdd3bf > namespace 'namespace' does not have a member 'member' - Did you mean 'member'? +## Remarks + The compiler was not able to find an identifier in the specified namespace. +## Example + The following sample generates C2251: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md index 9fb28bcc524..602d3a755f9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md @@ -10,8 +10,12 @@ ms.assetid: fee74ab9-1997-4615-82fe-e6d1fe3aacd9 > cannot explicitly instantiate template in current scope +## Remarks + The compiler detected a problem with an explicit instantiation of a template. For example, you cannot explicitly instantiate a template in a function. +## Example + The following sample generates C2252: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md index 555c85cba53..414abda3d3d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md @@ -10,8 +10,12 @@ ms.assetid: bd6445ae-b2c1-4669-9657-a8f4acf80b16 > 'function' : pure specifier or abstract override specifier only allowed on virtual function +## Remarks + A nonvirtual function is specified as pure **`virtual`**. +## Examples + The following sample generates C2253: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md index 30629f0d455..bc9676e95a3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md @@ -10,8 +10,12 @@ ms.assetid: 49bb3d7e-3bdf-4af6-937c-fa627be412a9 > 'function' : pure specifier or abstract override specifier not allowed on friend function +## Remarks + A **`friend`** function is specified as pure **`virtual`**. +## Example + The following sample generates C2254: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md index 63f0eae7a15..2d6ea4932db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md @@ -10,8 +10,12 @@ ms.assetid: 67dc4cb0-de6b-4405-bd64-d47736367a93 > 'element' : not allowed outside of a class definition +## Remarks + For example, a nonmember function is declared a **`friend`**. +## Example + The following sample generates C2255: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md index 7ff7ca58371..99a1f00550c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md @@ -10,8 +10,12 @@ ms.assetid: 171fa2bc-8c72-49cd-afe5-d723b7acd3c5 > illegal use of friend specifier on 'function' +## Remarks + A destructor or constructor cannot be specified as a [friend](../../cpp/friend-cpp.md). +## Example + The following sample generates C2256: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md index 6f3adc52755..3c070b3c210 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md @@ -10,8 +10,12 @@ ms.assetid: 105eaa87-befb-4ecb-9a3f-e09e14d2f5bf > illegal pure syntax, must be '= 0' +## Remarks + A pure virtual function is declared with incorrect syntax. +## Example + The following sample generates C2258: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2259.md b/docs/error-messages/compiler-errors-1/compiler-error-c2259.md index 11c96f2b724..74270c48a80 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2259.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2259.md @@ -10,12 +10,16 @@ ms.assetid: e458236f-bdea-4786-9aa6-a98d8bffa5f4 > '*class*' : cannot instantiate abstract class +## Remarks + Code declares an instance of an abstract class or structure. You can't instantiate a class or structure with one or more pure virtual functions. To instantiate objects of a derived class, the derived class must override each pure virtual function. For more information, see [Implicitly abstract classes](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Implicitly_abstract_classes). +## Examples + The following sample generates C2259: ```cpp From 901cb657cebd007f28d42c4a260b4d9a2778b08c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 19:16:04 +0800 Subject: [PATCH 0475/1799] Replace term "sample" with "example" for error references in range [C2231, C2260] --- .../compiler-errors-1/compiler-error-c2231.md | 2 +- .../compiler-errors-1/compiler-error-c2232.md | 2 +- .../compiler-errors-1/compiler-error-c2233.md | 2 +- .../compiler-errors-1/compiler-error-c2234.md | 2 +- .../compiler-errors-1/compiler-error-c2236.md | 2 +- .../compiler-errors-1/compiler-error-c2238.md | 2 +- .../compiler-errors-1/compiler-error-c2243.md | 2 +- .../compiler-errors-1/compiler-error-c2244.md | 2 +- .../compiler-errors-1/compiler-error-c2245.md | 2 +- .../compiler-errors-1/compiler-error-c2246.md | 2 +- .../compiler-errors-1/compiler-error-c2247.md | 2 +- .../compiler-errors-1/compiler-error-c2248.md | 2 +- .../compiler-errors-1/compiler-error-c2249.md | 4 ++-- .../compiler-errors-1/compiler-error-c2250.md | 2 +- .../compiler-errors-1/compiler-error-c2251.md | 2 +- .../compiler-errors-1/compiler-error-c2252.md | 2 +- .../compiler-errors-1/compiler-error-c2253.md | 4 ++-- .../compiler-errors-1/compiler-error-c2254.md | 2 +- .../compiler-errors-1/compiler-error-c2255.md | 2 +- .../compiler-errors-1/compiler-error-c2256.md | 2 +- .../compiler-errors-1/compiler-error-c2258.md | 2 +- .../compiler-errors-1/compiler-error-c2259.md | 6 +++--- 22 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md index 3c7345b2937..2893c93d89b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md @@ -16,7 +16,7 @@ The operand to the left of the member-selection operation (.) is a pointer inste ## Example -The following sample generates C2231: +The following example generates C2231: ```c // C2231.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md index 39c0057dbfa..0799d5ac346 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md @@ -16,7 +16,7 @@ The operand to the left of the `->` operator is not a pointer. Use the period (. ## Example -The following sample generates C2232: +The following example generates C2232: ```c // C2232.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md index 8c581360ac1..eae29aa23d5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md @@ -16,7 +16,7 @@ Each object in an array must contain at least one element. ## Example -The following sample generates C2233: +The following example generates C2233: ```cpp // C2233.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md index 9f686d1fd6a..e298f86f356 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md @@ -16,7 +16,7 @@ Because pointers to references are not allowed, arrays of references are not pos ## Example -The following sample generates C2234: +The following example generates C2234: ```cpp // C2234.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md index 306c49f7d94..521223e6416 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md @@ -16,7 +16,7 @@ The identifier is already defined as a type and cannot be overridden by a user-d ## Example -The following sample generates C2236: +The following example generates C2236: ```cpp // C2236.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md index 674669a1aca..94325929da9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md @@ -16,7 +16,7 @@ An incorrect token was found. ## Example -The following sample generates C2238: +The following example generates C2238: ```cpp // C2238.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md index f2a2c48e8d8..4a73edc6599 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md @@ -16,7 +16,7 @@ Access protection (**`protected`** or **`private`**) prevented conversion from a ## Example -The following sample generates C2243: +The following example generates C2243: ```cpp // C2243.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md index fce7ac39bb6..24cb988822b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md @@ -18,7 +18,7 @@ This error only occurs in C++ projects. ## Examples -The following sample generates C2244: +The following example generates C2244: ```cpp // C2244.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md index 2fb00bc883c..65d61426712 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md @@ -16,7 +16,7 @@ A function specified as a friend was not found by the compiler. ## Example -The following sample generates C2245: +The following example generates C2245: ```cpp // C2245.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md index a85d17f3598..cfc2d824135 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md @@ -16,7 +16,7 @@ A member of a class, structure, or union with local scope is declared **`static` ## Example -The following sample generates C2246: +The following example generates C2246: ```cpp // C2246.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md index f2bb4a14847..e9343220f11 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md @@ -16,7 +16,7 @@ ms.assetid: 72efa03e-615e-4ef9-aede-0a98654b20fd ## Examples -The following sample generates C2247: +The following example generates C2247: ```cpp // C2247.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2248.md b/docs/error-messages/compiler-errors-1/compiler-error-c2248.md index cd7e67afa48..a925b2c310e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2248.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2248.md @@ -16,7 +16,7 @@ Members of a derived class can't access **`private`** members of a base class. Y ## Examples -The following sample generates C2248 when `private` or `protected` members of a class are accessed from outside the class. To fix this issue, don't access these members directly outside the class. Use `public` member data and member functions to interact with the class. +The following example generates C2248 when `private` or `protected` members of a class are accessed from outside the class. To fix this issue, don't access these members directly outside the class. Use `public` member data and member functions to interact with the class. ```cpp // C2248_access.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md index 8a31cd7ff79..711bf675bdf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md @@ -16,7 +16,7 @@ The `member` is inherited from a nonpublic **`virtual`** base class or structure ## Examples -The following sample generates C2249. +The following example generates C2249. ```cpp // C2249.cpp @@ -35,7 +35,7 @@ int main() { } ``` -C2249 can also occur if you try to assign a stream from the C++ Standard Library to another stream. The following sample generates C2249. +C2249 can also occur if you try to assign a stream from the C++ Standard Library to another stream. The following example generates C2249. ```cpp // C2249_2.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md index 845fa9125c3..b1152ea8b59 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md @@ -16,7 +16,7 @@ The derived class inherits more than one override of a virtual function of a vir ## Example -The following sample generates C2286: +The following example generates C2286: ```cpp // C2250.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md index 132a488f385..382966e5edd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md @@ -16,7 +16,7 @@ The compiler was not able to find an identifier in the specified namespace. ## Example -The following sample generates C2251: +The following example generates C2251: ```cpp // C2251.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md index 602d3a755f9..75c4cdbe26e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md @@ -16,7 +16,7 @@ The compiler detected a problem with an explicit instantiation of a template. F ## Example -The following sample generates C2252: +The following example generates C2252: ```cpp // C2252.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md index 414abda3d3d..427ffaded09 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md @@ -16,7 +16,7 @@ A nonvirtual function is specified as pure **`virtual`**. ## Examples -The following sample generates C2253: +The following example generates C2253: ```cpp // C2253.cpp @@ -28,7 +28,7 @@ public: }; ``` -The following sample generates C2253: +The following example generates C2253: ```cpp // C2253_2.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md index bc9676e95a3..a0740739bca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md @@ -16,7 +16,7 @@ A **`friend`** function is specified as pure **`virtual`**. ## Example -The following sample generates C2254: +The following example generates C2254: ```cpp // C2254.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md index 2d6ea4932db..d4e19046865 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md @@ -16,7 +16,7 @@ For example, a nonmember function is declared a **`friend`**. ## Example -The following sample generates C2255: +The following example generates C2255: ```cpp // C2255.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md index 99a1f00550c..281491a512f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md @@ -16,7 +16,7 @@ A destructor or constructor cannot be specified as a [friend](../../cpp/friend-c ## Example -The following sample generates C2256: +The following example generates C2256: ```cpp // C2256.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md index 3c070b3c210..c6c5b8400d1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md @@ -16,7 +16,7 @@ A pure virtual function is declared with incorrect syntax. ## Example -The following sample generates C2258: +The following example generates C2258: ```cpp // C2258.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2259.md b/docs/error-messages/compiler-errors-1/compiler-error-c2259.md index 74270c48a80..974025e2370 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2259.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2259.md @@ -20,7 +20,7 @@ For more information, see [Implicitly abstract classes](../../dotnet/how-to-defi ## Examples -The following sample generates C2259: +The following example generates C2259: ```cpp // C2259.cpp @@ -45,7 +45,7 @@ To resolve this issue, don't use more restrictive access permissions for the imp C2259 can also occur because of conformance work that was done in Visual Studio 2005, **`/Zc:wchar_t`** is now on by default. In this situation, C2599 can be resolved either by compiling with **`/Zc:wchar_t-`**, to get the behavior from previous versions, or preferably, by updating your types so they're compatible. For more information, see [`/Zc:wchar_t` (wchar_t Is Native Type)](../../build/reference/zc-wchar-t-wchar-t-is-native-type.md). -The following sample generates C2259: +The following example generates C2259: ```cpp // C2259b.cpp @@ -83,7 +83,7 @@ public: MyClass4 y; ``` -The following sample generates C2259: +The following example generates C2259: ```cpp // C2259c.cpp From c17ce2329dd64b662391d761b6c24ee3e15fe115 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 20 Jul 2025 19:19:42 +0800 Subject: [PATCH 0476/1799] Update metadata for error references in range [C2231, C2260] --- .../error-messages/compiler-errors-1/compiler-error-c2231.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2232.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2233.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2234.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2236.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2238.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2241.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2242.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2243.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2244.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2245.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2246.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2247.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2248.md | 3 +-- .../error-messages/compiler-errors-1/compiler-error-c2249.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2250.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2251.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2252.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2253.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2254.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2255.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2256.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2258.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2259.md | 3 +-- 24 files changed, 46 insertions(+), 70 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md index 2893c93d89b..a3ab0edc007 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2231" title: "Compiler Error C2231" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2231" +ms.date: 11/04/2016 f1_keywords: ["C2231"] helpviewer_keywords: ["C2231"] -ms.assetid: 677c5c66-d30f-4c3b-bbb9-760858d56477 --- # Compiler Error C2231 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md index 0799d5ac346..58ab4d67d20 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2232" title: "Compiler Error C2232" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2232" +ms.date: 11/04/2016 f1_keywords: ["C2232"] helpviewer_keywords: ["C2232"] -ms.assetid: 76f302b7-30a7-4a81-9a39-b4edde33b54c --- # Compiler Error C2232 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md index eae29aa23d5..941d8ee870c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2233" title: "Compiler Error C2233" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2233" +ms.date: 11/04/2016 f1_keywords: ["C2233"] helpviewer_keywords: ["C2233"] -ms.assetid: 236bdf0b-9607-4f26-a249-d8def0b1333c --- # Compiler Error C2233 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md index e298f86f356..df26be2eea1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2234" title: "Compiler Error C2234" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2234" +ms.date: 11/04/2016 f1_keywords: ["C2234"] helpviewer_keywords: ["C2234"] -ms.assetid: cfa42458-c803-4717-a017-9eca1c0cbfb0 --- # Compiler Error C2234 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md index 521223e6416..4fc2c582fb4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2236" title: "Compiler Error C2236" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2236" +ms.date: 11/04/2016 f1_keywords: ["C2236"] helpviewer_keywords: ["C2236"] -ms.assetid: 0b6771a7-a783-4729-9c3d-7a3339c432cc --- # Compiler Error C2236 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md index 94325929da9..36610cb8a82 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2238" title: "Compiler Error C2238" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2238" +ms.date: 11/04/2016 f1_keywords: ["C2238"] helpviewer_keywords: ["C2238"] -ms.assetid: 3d53060c-d6b7-4603-b9cf-d7c65eb64cd2 --- # Compiler Error C2238 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2241.md b/docs/error-messages/compiler-errors-1/compiler-error-c2241.md index 7de089058fb..1b3217d46fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2241.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2241.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2241" title: "Compiler Error C2241" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2241" +ms.date: 11/04/2016 f1_keywords: ["C2241"] helpviewer_keywords: ["C2241"] -ms.assetid: 2f4e2c2c-b95c-4afe-bbe0-4214cd39d140 --- # Compiler Error C2241 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2242.md b/docs/error-messages/compiler-errors-1/compiler-error-c2242.md index b7a50c92c2c..d7401ce7584 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2242.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2242.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2242" title: "Compiler Error C2242" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2242" +ms.date: 11/04/2016 f1_keywords: ["C2242"] helpviewer_keywords: ["C2242"] -ms.assetid: e1b687ed-4460-4c26-9f7e-c43e65c6dd65 --- # Compiler Error C2242 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md index 4a73edc6599..036a1ae997d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2243" title: "Compiler Error C2243" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2243" +ms.date: 11/04/2016 f1_keywords: ["C2243"] helpviewer_keywords: ["C2243"] -ms.assetid: b90065bb-d251-4ba9-8b4c-280ee13fa9c0 --- # Compiler Error C2243 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md index 24cb988822b..d0ae19f3282 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2244" title: "Compiler Error C2244" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2244" +ms.date: 11/04/2016 f1_keywords: ["C2244"] helpviewer_keywords: ["C2244"] -ms.assetid: d9911c12-ceb5-4f93-ac47-b44a485215c2 --- # Compiler Error C2244 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md index 65d61426712..585fe22556b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2245" title: "Compiler Error C2245" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2245" +ms.date: 11/04/2016 f1_keywords: ["C2245"] helpviewer_keywords: ["C2245"] -ms.assetid: 08aaeadf-10ec-485a-b2a6-6e775289082b --- # Compiler Error C2245 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md index cfc2d824135..3c6e5d4c2e1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2246" title: "Compiler Error C2246" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2246" +ms.date: 11/04/2016 f1_keywords: ["C2246"] helpviewer_keywords: ["C2246"] -ms.assetid: 4f3e4f83-21f3-4256-af96-43e0bb060311 --- # Compiler Error C2246 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md index e9343220f11..e658316482a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2247" title: "Compiler Error C2247" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2247" +ms.date: 11/04/2016 f1_keywords: ["C2247"] helpviewer_keywords: ["C2247"] -ms.assetid: 72efa03e-615e-4ef9-aede-0a98654b20fd --- # Compiler Error C2247 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2248.md b/docs/error-messages/compiler-errors-1/compiler-error-c2248.md index a925b2c310e..6a240fa1ff8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2248.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2248.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2248" title: "Compiler Error C2248" +description: "Learn more about: Compiler Error C2248" ms.date: 09/27/2022 f1_keywords: ["C2248"] helpviewer_keywords: ["C2248"] -ms.assetid: 7a3ba0e8-d3b9-4bb9-95db-81ef17e31d23 --- # Compiler Error C2248 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md index 711bf675bdf..08b0242691e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2249" title: "Compiler Error C2249" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2249" +ms.date: 11/04/2016 f1_keywords: ["C2249"] helpviewer_keywords: ["C2249"] -ms.assetid: bdd6697c-e04b-49b9-8e40-d9eb6d74f2b6 --- # Compiler Error C2249 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md index b1152ea8b59..90762d9a529 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2250" title: "Compiler Error C2250" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2250" +ms.date: 11/04/2016 f1_keywords: ["C2250"] helpviewer_keywords: ["C2250"] -ms.assetid: f990986f-5c7d-4af4-a25c-b35540f1e217 --- # Compiler Error C2250 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md index 382966e5edd..f3be89655fb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2251" title: "Compiler Error C2251" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2251" +ms.date: 11/04/2016 f1_keywords: ["C2251"] helpviewer_keywords: ["C2251"] -ms.assetid: fefe050c-f8d3-4316-b237-8007dbcdd3bf --- # Compiler Error C2251 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md index 75c4cdbe26e..a26bb54ffd5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2252" title: "Compiler Error C2252" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2252" +ms.date: 11/04/2016 f1_keywords: ["C2252"] helpviewer_keywords: ["C2252"] -ms.assetid: fee74ab9-1997-4615-82fe-e6d1fe3aacd9 --- # Compiler Error C2252 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md index 427ffaded09..10af621f451 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2253" title: "Compiler Error C2253" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2253" +ms.date: 11/04/2016 f1_keywords: ["C2253"] helpviewer_keywords: ["C2253"] -ms.assetid: bd6445ae-b2c1-4669-9657-a8f4acf80b16 --- # Compiler Error C2253 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md index a0740739bca..675b084392c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2254" title: "Compiler Error C2254" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2254" +ms.date: 11/04/2016 f1_keywords: ["C2254"] helpviewer_keywords: ["C2254"] -ms.assetid: 49bb3d7e-3bdf-4af6-937c-fa627be412a9 --- # Compiler Error C2254 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md index d4e19046865..99711de628b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2255" title: "Compiler Error C2255" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2255" +ms.date: 11/04/2016 f1_keywords: ["C2255"] helpviewer_keywords: ["C2255"] -ms.assetid: 67dc4cb0-de6b-4405-bd64-d47736367a93 --- # Compiler Error C2255 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md index 281491a512f..2c40773e239 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2256" title: "Compiler Error C2256" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2256" +ms.date: 11/04/2016 f1_keywords: ["C2256"] helpviewer_keywords: ["C2256"] -ms.assetid: 171fa2bc-8c72-49cd-afe5-d723b7acd3c5 --- # Compiler Error C2256 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md index c6c5b8400d1..8b04f7d245e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2258" title: "Compiler Error C2258" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2258" +ms.date: 11/04/2016 f1_keywords: ["C2258"] helpviewer_keywords: ["C2258"] -ms.assetid: 105eaa87-befb-4ecb-9a3f-e09e14d2f5bf --- # Compiler Error C2258 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2259.md b/docs/error-messages/compiler-errors-1/compiler-error-c2259.md index 974025e2370..9bcb2e62f8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2259.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2259.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2259" title: "Compiler Error C2259" +description: "Learn more about: Compiler Error C2259" ms.date: 07/08/2021 f1_keywords: ["C2259"] helpviewer_keywords: ["C2259"] -ms.assetid: e458236f-bdea-4786-9aa6-a98d8bffa5f4 --- # Compiler Error C2259 From 67a7184c1bacf0288e6a807e5c4221c832fa1f88 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 21 Jul 2025 22:24:55 +0800 Subject: [PATCH 0477/1799] Add blockquotes for error messages in range [C2261, C2290] --- docs/error-messages/compiler-errors-1/compiler-error-c2261.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2262.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2264.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2266.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2267.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2268.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2270.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2271.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2272.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2273.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2274.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2275.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2277.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2279.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2280.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2285.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2286.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2287.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2289.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2290.md | 2 +- 20 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md index eb8bd54da28..bf0b5fdb84e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md @@ -8,7 +8,7 @@ ms.assetid: 60969482-9e83-49b5-9631-a04bc844da12 --- # Compiler Error C2261 -'string' : assembly reference is invalid and cannot be resolved +> 'string' : assembly reference is invalid and cannot be resolved A value was not valid. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md index 8aa445522b1..4e684dc6737 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md @@ -8,7 +8,7 @@ ms.assetid: 727d1c6e-53e8-40e5-b7b8-6a7ac2011727 --- # Compiler Error C2262 -'attribute_specifiers' : InternalsVisibleTo declarations cannot have a version, culture, or processor architecture specified +> 'attribute_specifiers' : InternalsVisibleTo declarations cannot have a version, culture, or processor architecture specified The attribute was not specified correctly. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md index e2e1dd617ec..b4156cb684f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md @@ -8,7 +8,7 @@ ms.assetid: 158b72cc-cee9-4a08-bd79-b7a5955345a8 --- # Compiler Error C2264 -'function' : error in function definition or declaration; function not called +> 'function' : error in function definition or declaration; function not called The function cannot be called due to an incorrect definition or declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2266.md b/docs/error-messages/compiler-errors-1/compiler-error-c2266.md index 9fc181b416e..6c01dee7215 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2266.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2266.md @@ -8,6 +8,6 @@ ms.assetid: 5c267a67-d5a1-4ad7-b6f7-a156510aee35 --- # Compiler Error C2266 -'identifier' : reference to a non-constant bounded array is illegal +> 'identifier' : reference to a non-constant bounded array is illegal A reference is declared for an array with a nonconstant bound. The array must have constant bounds. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md index 4018e13c8c5..f1e87ee5467 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md @@ -8,7 +8,7 @@ ms.assetid: ea63bebb-6208-4367-8440-39be07f9c360 --- # Compiler Error C2267 -'function' : static functions with block scope are illegal +> 'function' : static functions with block scope are illegal A local function is declared **`static`**. Static functions must have global scope. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md index 8be93111970..b9b75aac53e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md @@ -8,7 +8,7 @@ ms.assetid: 0ed055c9-3c6f-4df2-a5b6-85cf0e01a249 --- # Compiler Error C2268 -'function' is a compiler predefined library helper. Library helpers are not supported with /GL; compile object file 'file' without /GL. +> 'function' is a compiler predefined library helper. Library helpers are not supported with /GL; compile object file 'file' without /GL. A function defined in your source code has the same name as an internal compiler function. Compile the module containing the function without [/GL](../../build/reference/gl-whole-program-optimization.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md index b19c40b8b21..5be147eb530 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md @@ -8,7 +8,7 @@ ms.assetid: b52c068e-0b61-42e7-b775-4d57b3ddcba0 --- # Compiler Error C2270 -'function' : modifiers not allowed on nonmember functions +> 'function' : modifiers not allowed on nonmember functions A nonmember function is declared with [const](../../cpp/const-cpp.md), [volatile](../../cpp/volatile-cpp.md), or another memory-model modifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md index cb79055f4c2..e23a47bd36a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md @@ -8,7 +8,7 @@ ms.assetid: ea47bf57-f55d-4171-8e98-95a71d62820e --- # Compiler Error C2271 -'operator' : new/delete cannot have formal list modifiers +> 'operator' : new/delete cannot have formal list modifiers The operator (**`new`** or **`delete`**) is declared with a memory-model specifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md index a47e01e02a9..a6fe45a7549 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md @@ -8,7 +8,7 @@ ms.assetid: 1517706a-9c27-452e-9b10-3424b3d232bc --- # Compiler Error C2272 -'function' : modifiers not allowed on static member functions +> 'function' : modifiers not allowed on static member functions A **`static`** member function is declared with a memory-model specifier, such as [const](../../cpp/const-cpp.md) or [volatile](../../cpp/volatile-cpp.md), and such modifiers are not allowed on **`static`** member functions. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md index 2000e990c36..2c78a443879 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md @@ -8,7 +8,7 @@ ms.assetid: 3c682c66-97bf-4a23-a22c-d9a26a92bf95 --- # Compiler Error C2273 -'type' : illegal as right side of '->' operator +> 'type' : illegal as right side of '->' operator A type appears as the right operand of a `->` operator. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md index 52cd5d4fcaf..b670f403474 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md @@ -8,7 +8,7 @@ ms.assetid: 8e874903-f499-45ef-8291-f821eee4cc1c --- # Compiler Error C2274 -'type' : illegal as right side of '.' operator +> 'type' : illegal as right side of '.' operator A type appears as the right operand of a member-access (.) operator. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md index 5398ae9154c..0948c93d6a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md @@ -8,7 +8,7 @@ ms.assetid: c1eafa71-48de-46e0-82f3-b575538ef205 --- # Compiler Error C2275 -'identifier' : illegal use of this type as an expression +> 'identifier' : illegal use of this type as an expression An expression uses the `->` operator with a **`typedef`** identifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index f1aef2b07ff..7de82b48d48 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -8,7 +8,7 @@ ms.assetid: 15a83b07-8731-4524-810b-267f65a7844f --- # Compiler Error C2277 -'identifier' : cannot take address of this member function +> 'identifier' : cannot take address of this member function You cannot take the address of a member function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md index b7df615fbd6..a2593950f7e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md @@ -8,7 +8,7 @@ ms.assetid: 1b5c88ef-2336-49b8-9ddb-d61f97c73e14 --- # Compiler Error C2279 -exception specification cannot appear in a typedef declaration +> exception specification cannot appear in a typedef declaration Under **/Za**, [exception specifications](../../cpp/exception-specifications-throw-cpp.md) are not allowed in a typedef declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2280.md b/docs/error-messages/compiler-errors-1/compiler-error-c2280.md index c438dc7138a..0ffdaaac91e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2280.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2280.md @@ -8,7 +8,7 @@ ms.assetid: e6c5b1fb-2b9b-4554-8ff9-775eeb37161b --- # Compiler Error C2280 -'*declaration*': attempting to reference a deleted function +> '*declaration*': attempting to reference a deleted function The compiler detected an attempt to reference a `deleted` function. This error can be caused by a call to a member function that has been explicitly marked as `= deleted` in the source code. This error can also be caused by a call to an implicit special member function of a struct or class that is automatically declared and marked as `deleted` by the compiler. For more information about when the compiler automatically generates **`default`** or `deleted` special member functions, see [Special member functions](../../cpp/special-member-functions.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2285.md b/docs/error-messages/compiler-errors-1/compiler-error-c2285.md index cb7c1d60c9e..dad0f15a6c6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2285.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2285.md @@ -8,6 +8,6 @@ ms.assetid: 7b40a1b0-f477-49fa-b762-c3bccd88514e --- # Compiler Error C2285 -pointers to members representation has already been determined - pragma ignored +> pointers to members representation has already been determined - pragma ignored Two different representations exist for class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md index 8479291e545..da5d13bb9fb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md @@ -8,7 +8,7 @@ ms.assetid: 078e0201-35cc-42e2-8dbc-6f8cf557b098 --- # Compiler Error C2286 -pointers to members of 'identifier' representation is already set to 'inheritance' - declaration ignored +> pointers to members of 'identifier' representation is already set to 'inheritance' - declaration ignored Two different pointer-to-members representations exist for class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md index 178c7c0076b..6a4c765554f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md @@ -8,7 +8,7 @@ ms.assetid: 64556299-4e1f-4437-88b7-2464fc0b95bb --- # Compiler Error C2287 -'class': inheritance representation: 'representation1' is less general than the required 'representation2' +> 'class': inheritance representation: 'representation1' is less general than the required 'representation2' A class is declared with a simpler representation than required. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md index 485af601948..2141e920db9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md @@ -8,7 +8,7 @@ ms.assetid: cb41a29e-1b06-47dc-bfce-8d73bd63a0df --- # Compiler Error C2289 -same type qualifier used more than once +> same type qualifier used more than once A type declaration or definition uses a type qualifier (**`const`**, **`volatile`**, **`signed`**, or **`unsigned`**) more than once, causing an error under ANSI compatibility (**/Za**). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md index f69fdf273cf..5b125729998 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md @@ -8,6 +8,6 @@ ms.assetid: 78c0feec-ccde-401b-8335-5b6ea6be8a13 --- # Compiler Error C2290 -C++ asm syntax ignored. Use __asm. +> C++ asm syntax ignored. Use __asm. The **`asm`** syntax is reserved for future use. From 2720b85acdd7e2862077ace79b2b9f12fe9a4ee9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 21 Jul 2025 22:30:54 +0800 Subject: [PATCH 0478/1799] Add "Remarks" and "Example" headings for error references in range [C2261, C2290] --- docs/error-messages/compiler-errors-1/compiler-error-c2261.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2262.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2264.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2266.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2267.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2268.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2270.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2271.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2272.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2273.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2274.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2275.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2276.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2277.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2279.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2280.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2283.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2285.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2286.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2287.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2289.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2290.md | 2 ++ 22 files changed, 72 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md index bf0b5fdb84e..4de84ccc6e0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md @@ -10,6 +10,8 @@ ms.assetid: 60969482-9e83-49b5-9631-a04bc844da12 > 'string' : assembly reference is invalid and cannot be resolved +## Remarks + A value was not valid. is used to specify a friend assembly. For example, if a.dll wants to specify b.dll as a friend assembly, you would specify (in a.dll): InternalsVisibleTo("b"). The runtime then allows b.dll to access everything in a.dll (except private types). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md index 4e684dc6737..ea89e15d348 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md @@ -10,6 +10,8 @@ ms.assetid: 727d1c6e-53e8-40e5-b7b8-6a7ac2011727 > 'attribute_specifiers' : InternalsVisibleTo declarations cannot have a version, culture, or processor architecture specified +## Remarks + The attribute was not specified correctly. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md index b4156cb684f..03b2a6fc83b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md @@ -10,8 +10,12 @@ ms.assetid: 158b72cc-cee9-4a08-bd79-b7a5955345a8 > 'function' : error in function definition or declaration; function not called +## Remarks + The function cannot be called due to an incorrect definition or declaration. +## Example + The following sample generates C2264: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2266.md b/docs/error-messages/compiler-errors-1/compiler-error-c2266.md index 6c01dee7215..32e2c9840ba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2266.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2266.md @@ -10,4 +10,6 @@ ms.assetid: 5c267a67-d5a1-4ad7-b6f7-a156510aee35 > 'identifier' : reference to a non-constant bounded array is illegal +## Remarks + A reference is declared for an array with a nonconstant bound. The array must have constant bounds. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md index f1e87ee5467..b1616b6fba2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md @@ -10,8 +10,12 @@ ms.assetid: ea63bebb-6208-4367-8440-39be07f9c360 > 'function' : static functions with block scope are illegal +## Remarks + A local function is declared **`static`**. Static functions must have global scope. +## Example + The following sample generates C2267: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md index b9b75aac53e..378638e69e4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md @@ -10,8 +10,12 @@ ms.assetid: 0ed055c9-3c6f-4df2-a5b6-85cf0e01a249 > 'function' is a compiler predefined library helper. Library helpers are not supported with /GL; compile object file 'file' without /GL. +## Remarks + A function defined in your source code has the same name as an internal compiler function. Compile the module containing the function without [/GL](../../build/reference/gl-whole-program-optimization.md). +## Example + The following sample generates C2268: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md index 5be147eb530..b92e5ca8564 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md @@ -10,8 +10,12 @@ ms.assetid: b52c068e-0b61-42e7-b775-4d57b3ddcba0 > 'function' : modifiers not allowed on nonmember functions +## Remarks + A nonmember function is declared with [const](../../cpp/const-cpp.md), [volatile](../../cpp/volatile-cpp.md), or another memory-model modifier. +## Example + The following sample generates C2270: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md index e23a47bd36a..f4078a960cd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md @@ -10,8 +10,12 @@ ms.assetid: ea47bf57-f55d-4171-8e98-95a71d62820e > 'operator' : new/delete cannot have formal list modifiers +## Remarks + The operator (**`new`** or **`delete`**) is declared with a memory-model specifier. +## Example + The following sample generates C2271: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md index a6fe45a7549..a6d77a74cc6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md @@ -10,8 +10,12 @@ ms.assetid: 1517706a-9c27-452e-9b10-3424b3d232bc > 'function' : modifiers not allowed on static member functions +## Remarks + A **`static`** member function is declared with a memory-model specifier, such as [const](../../cpp/const-cpp.md) or [volatile](../../cpp/volatile-cpp.md), and such modifiers are not allowed on **`static`** member functions. +## Example + The following sample generates C2272: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md index 2c78a443879..6f7d7222113 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md @@ -10,10 +10,14 @@ ms.assetid: 3c682c66-97bf-4a23-a22c-d9a26a92bf95 > 'type' : illegal as right side of '->' operator +## Remarks + A type appears as the right operand of a `->` operator. This error can be caused by trying to access a user-defined type conversion. Use the keyword **`operator`** between -> and `type`. +## Example + The following sample generates C2273: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md index b670f403474..e3d3bbf5168 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md @@ -10,10 +10,14 @@ ms.assetid: 8e874903-f499-45ef-8291-f821eee4cc1c > 'type' : illegal as right side of '.' operator +## Remarks + A type appears as the right operand of a member-access (.) operator. This error can be caused by trying to access a user-defined type conversion. Use the keyword **`operator`** between the period and `type`. +## Example + The following sample generates C2286: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md index 0948c93d6a6..7a482e88734 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md @@ -10,8 +10,12 @@ ms.assetid: c1eafa71-48de-46e0-82f3-b575538ef205 > 'identifier' : illegal use of this type as an expression +## Remarks + An expression uses the `->` operator with a **`typedef`** identifier. +## Example + The following sample generates C2275: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2276.md b/docs/error-messages/compiler-errors-1/compiler-error-c2276.md index b6fe542bb7f..d564a814292 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2276.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2276.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C2276"] > '*operator*' : illegal operation on bound member function expression -The compiler found a problem with the syntax used to create a pointer-to-member. - ## Remarks +The compiler found a problem with the syntax used to create a pointer-to-member. + Error `C2276` is often caused when you attempt to create a pointer-to-member by using an instance variable to qualify the member, instead of a class type. You may also see this error if you're trying to call a member function by using the wrong syntax. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index 7de82b48d48..8f613cea955 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -10,8 +10,12 @@ ms.assetid: 15a83b07-8731-4524-810b-267f65a7844f > 'identifier' : cannot take address of this member function +## Remarks + You cannot take the address of a member function. +## Example + The following sample generates C2277: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md index a2593950f7e..46fd1de9e7c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md @@ -10,8 +10,12 @@ ms.assetid: 1b5c88ef-2336-49b8-9ddb-d61f97c73e14 > exception specification cannot appear in a typedef declaration +## Remarks + Under **/Za**, [exception specifications](../../cpp/exception-specifications-throw-cpp.md) are not allowed in a typedef declaration. +## Example + The following sample generates C2279: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2280.md b/docs/error-messages/compiler-errors-1/compiler-error-c2280.md index 0ffdaaac91e..f909de66443 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2280.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2280.md @@ -10,6 +10,8 @@ ms.assetid: e6c5b1fb-2b9b-4554-8ff9-775eeb37161b > '*declaration*': attempting to reference a deleted function +## Remarks + The compiler detected an attempt to reference a `deleted` function. This error can be caused by a call to a member function that has been explicitly marked as `= deleted` in the source code. This error can also be caused by a call to an implicit special member function of a struct or class that is automatically declared and marked as `deleted` by the compiler. For more information about when the compiler automatically generates **`default`** or `deleted` special member functions, see [Special member functions](../../cpp/special-member-functions.md). ## Example: Explicitly deleted functions diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2283.md b/docs/error-messages/compiler-errors-1/compiler-error-c2283.md index 52b1375800b..457c2ac5181 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2283.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2283.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2283"] > '*identifier*': pure specifier or abstract override specifier not allowed on unnamed struct +## Remarks + A member function of an unnamed class or structure is declared with a pure specifier, which is not permitted. +## Example + The following sample generates C2283: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2285.md b/docs/error-messages/compiler-errors-1/compiler-error-c2285.md index dad0f15a6c6..4b095d4fcae 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2285.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2285.md @@ -10,4 +10,6 @@ ms.assetid: 7b40a1b0-f477-49fa-b762-c3bccd88514e > pointers to members representation has already been determined - pragma ignored +## Remarks + Two different representations exist for class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md index da5d13bb9fb..38f2682e637 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md @@ -10,6 +10,8 @@ ms.assetid: 078e0201-35cc-42e2-8dbc-6f8cf557b098 > pointers to members of 'identifier' representation is already set to 'inheritance' - declaration ignored +## Remarks + Two different pointer-to-members representations exist for class. For more information, see [Inheritance Keywords](../../cpp/inheritance-keywords.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md index 6a4c765554f..90eba186ca7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md @@ -10,8 +10,12 @@ ms.assetid: 64556299-4e1f-4437-88b7-2464fc0b95bb > 'class': inheritance representation: 'representation1' is less general than the required 'representation2' +## Remarks + A class is declared with a simpler representation than required. +## Example + The following sample generates C2287: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md index 2141e920db9..85b9002aafd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md @@ -10,8 +10,12 @@ ms.assetid: cb41a29e-1b06-47dc-bfce-8d73bd63a0df > 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, causing an error under ANSI compatibility (**/Za**). +## Example + The following sample generates C2286: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md index 5b125729998..6d040d3b2a0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md @@ -10,4 +10,6 @@ ms.assetid: 78c0feec-ccde-401b-8335-5b6ea6be8a13 > C++ asm syntax ignored. Use __asm. +## Remarks + The **`asm`** syntax is reserved for future use. From 5a2e726a84e599f2dd64adac55120dbef1aae2a6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 21 Jul 2025 22:32:48 +0800 Subject: [PATCH 0479/1799] Replace term "sample" with "example" for error references in range [C2261, C2290] --- docs/error-messages/compiler-errors-1/compiler-error-c2261.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2262.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2264.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2267.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2268.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2270.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2271.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2272.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2273.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2274.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2275.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2276.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2277.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2279.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2283.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2286.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2287.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2289.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md index 4de84ccc6e0..4c31a135302 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md @@ -20,7 +20,7 @@ For more on the correct syntax when specifying friend assemblies, see [Friend As ## Example -The following sample generates C2261. +The following example generates C2261. ```cpp // C2261.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md index ea89e15d348..759b176be2b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md @@ -16,7 +16,7 @@ The attribute ## Example -The following sample generates C2262. +The following example generates C2262. ```cpp // C2262.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md index 03b2a6fc83b..a5afdee353c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md @@ -16,7 +16,7 @@ The function cannot be called due to an incorrect definition or declaration. ## Example -The following sample generates C2264: +The following example generates C2264: ```cpp // C2264.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md index b1616b6fba2..0bce7e93ff1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md @@ -16,7 +16,7 @@ A local function is declared **`static`**. Static functions must have global sco ## Example -The following sample generates C2267: +The following example generates C2267: ```cpp // C2267.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md index 378638e69e4..e7e8fa4de7a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md @@ -16,7 +16,7 @@ A function defined in your source code has the same name as an internal compiler ## Example -The following sample generates C2268: +The following example generates C2268: ```c // C2268.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md index b92e5ca8564..5370292d09b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md @@ -16,7 +16,7 @@ A nonmember function is declared with [const](../../cpp/const-cpp.md), [volatile ## Example -The following sample generates C2270: +The following example generates C2270: ```cpp // C2270.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md index f4078a960cd..b0d632d3f2a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md @@ -16,7 +16,7 @@ The operator (**`new`** or **`delete`**) is declared with a memory-model specifi ## Example -The following sample generates C2271: +The following example generates C2271: ```cpp // C2271.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md index a6d77a74cc6..8e8057c8106 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md @@ -16,7 +16,7 @@ A **`static`** member function is declared with a memory-model specifier, such a ## Example -The following sample generates C2272: +The following example generates C2272: ```cpp // C2272.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md index 6f7d7222113..a52ccb9bf4c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md @@ -18,7 +18,7 @@ This error can be caused by trying to access a user-defined type conversion. Use ## Example -The following sample generates C2273: +The following example generates C2273: ```cpp // C2273.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md index e3d3bbf5168..fc8d2e9f3de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md @@ -18,7 +18,7 @@ This error can be caused by trying to access a user-defined type conversion. Use ## Example -The following sample generates C2286: +The following example generates C2286: ```cpp // C2274.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md index 7a482e88734..57a53d295ae 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md @@ -16,7 +16,7 @@ An expression uses the `->` operator with a **`typedef`** identifier. ## Example -The following sample generates C2275: +The following example generates C2275: ```cpp // C2275.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2276.md b/docs/error-messages/compiler-errors-1/compiler-error-c2276.md index d564a814292..3c9410edcd3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2276.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2276.md @@ -17,7 +17,7 @@ Error `C2276` is often caused when you attempt to create a pointer-to-member by ## Example -This sample shows several ways C2276 may occur, and how to fix them: +This example shows several ways C2276 may occur, and how to fix them: ```cpp // C2276.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index 8f613cea955..e04c0ddce2b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -16,7 +16,7 @@ You cannot take the address of a member function. ## Example -The following sample generates C2277: +The following example generates C2277: ```cpp // C2277.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md index 46fd1de9e7c..7a4f33b9e58 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md @@ -16,7 +16,7 @@ Under **/Za**, [exception specifications](../../cpp/exception-specifications-thr ## Example -The following sample generates C2279: +The following example generates C2279: ```cpp // C2279.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2283.md b/docs/error-messages/compiler-errors-1/compiler-error-c2283.md index 457c2ac5181..f399bc8b8a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2283.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2283.md @@ -15,7 +15,7 @@ A member function of an unnamed class or structure is declared with a pure speci ## Example -The following sample generates C2283: +The following example generates C2283: ```cpp // C2283.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md index 38f2682e637..e8288d18f0a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md @@ -18,7 +18,7 @@ For more information, see [Inheritance Keywords](../../cpp/inheritance-keywords. ## Example -The following sample generates C2286: +The following example generates C2286: ```cpp // C2286.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md index 90eba186ca7..1fa625d5368 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md @@ -16,7 +16,7 @@ A class is declared with a simpler representation than required. ## Example -The following sample generates C2287: +The following example generates C2287: ```cpp // C2287.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md index 85b9002aafd..b2db59cb3fb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md @@ -16,7 +16,7 @@ A type declaration or definition uses a type qualifier (**`const`**, **`volatile ## Example -The following sample generates C2286: +The following example generates C2286: ```cpp // C2289.cpp From d79e4b198150e52721b5b11ba5257f90bbf8f29f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 21 Jul 2025 22:36:18 +0800 Subject: [PATCH 0480/1799] Update metadata for error references in range [C2261, C2290] --- .../error-messages/compiler-errors-1/compiler-error-c2261.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2262.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2264.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2266.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2267.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2268.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2270.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2271.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2272.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2273.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2274.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2275.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2276.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2277.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2279.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2280.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2283.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2285.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2286.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2287.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2289.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2290.md | 5 ++--- 22 files changed, 42 insertions(+), 62 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md index 4c31a135302..3c27593063d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2261" title: "Compiler Error C2261" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2261" +ms.date: 11/04/2016 f1_keywords: ["C2261"] helpviewer_keywords: ["C2261"] -ms.assetid: 60969482-9e83-49b5-9631-a04bc844da12 --- # Compiler Error C2261 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md index 759b176be2b..752d2409f8f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2262" title: "Compiler Error C2262" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2262" +ms.date: 11/04/2016 f1_keywords: ["C2262"] helpviewer_keywords: ["C2262"] -ms.assetid: 727d1c6e-53e8-40e5-b7b8-6a7ac2011727 --- # Compiler Error C2262 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md index a5afdee353c..915f27a906d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2264" title: "Compiler Error C2264" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2264" +ms.date: 11/04/2016 f1_keywords: ["C2264"] helpviewer_keywords: ["C2264"] -ms.assetid: 158b72cc-cee9-4a08-bd79-b7a5955345a8 --- # Compiler Error C2264 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2266.md b/docs/error-messages/compiler-errors-1/compiler-error-c2266.md index 32e2c9840ba..ecd97db4e0b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2266.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2266.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2266" title: "Compiler Error C2266" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2266" +ms.date: 11/04/2016 f1_keywords: ["C2266"] helpviewer_keywords: ["C2266"] -ms.assetid: 5c267a67-d5a1-4ad7-b6f7-a156510aee35 --- # Compiler Error C2266 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md index 0bce7e93ff1..2393a3ecdbc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2267" title: "Compiler Error C2267" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2267" +ms.date: 11/04/2016 f1_keywords: ["C2267"] helpviewer_keywords: ["C2267"] -ms.assetid: ea63bebb-6208-4367-8440-39be07f9c360 --- # Compiler Error C2267 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md index e7e8fa4de7a..6c77ca44b41 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2268" title: "Compiler Error C2268" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2268" +ms.date: 11/04/2016 f1_keywords: ["C2268"] helpviewer_keywords: ["C2268"] -ms.assetid: 0ed055c9-3c6f-4df2-a5b6-85cf0e01a249 --- # Compiler Error C2268 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md index 5370292d09b..d6400d66435 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2270" title: "Compiler Error C2270" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2270" +ms.date: 11/04/2016 f1_keywords: ["C2270"] helpviewer_keywords: ["C2270"] -ms.assetid: b52c068e-0b61-42e7-b775-4d57b3ddcba0 --- # Compiler Error C2270 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md index b0d632d3f2a..5cd706b2936 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2271" title: "Compiler Error C2271" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2271" +ms.date: 11/04/2016 f1_keywords: ["C2271"] helpviewer_keywords: ["C2271"] -ms.assetid: ea47bf57-f55d-4171-8e98-95a71d62820e --- # Compiler Error C2271 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md index 8e8057c8106..b8915aeab7b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2272" title: "Compiler Error C2272" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2272" +ms.date: 11/04/2016 f1_keywords: ["C2272"] helpviewer_keywords: ["C2272"] -ms.assetid: 1517706a-9c27-452e-9b10-3424b3d232bc --- # Compiler Error C2272 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md index a52ccb9bf4c..c1bc46a2c64 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2273" title: "Compiler Error C2273" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2273" +ms.date: 11/04/2016 f1_keywords: ["C2273"] helpviewer_keywords: ["C2273"] -ms.assetid: 3c682c66-97bf-4a23-a22c-d9a26a92bf95 --- # Compiler Error C2273 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md index fc8d2e9f3de..67e054c561d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2274" title: "Compiler Error C2274" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2274" +ms.date: 11/04/2016 f1_keywords: ["C2274"] helpviewer_keywords: ["C2274"] -ms.assetid: 8e874903-f499-45ef-8291-f821eee4cc1c --- # Compiler Error C2274 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md index 57a53d295ae..b4a3a21d317 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2275" title: "Compiler Error C2275" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2275" +ms.date: 11/04/2016 f1_keywords: ["C2275"] helpviewer_keywords: ["C2275"] -ms.assetid: c1eafa71-48de-46e0-82f3-b575538ef205 --- # Compiler Error C2275 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2276.md b/docs/error-messages/compiler-errors-1/compiler-error-c2276.md index 3c9410edcd3..e583d2541cc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2276.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2276.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2276" title: "Compiler Error C2276" +description: "Learn more about: Compiler Error C2276" ms.date: 03/25/2021 f1_keywords: ["C2276"] helpviewer_keywords: ["C2276"] diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index e04c0ddce2b..1f56b60b30e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2277" title: "Compiler Error C2277" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2277" +ms.date: 11/04/2016 f1_keywords: ["C2277"] helpviewer_keywords: ["C2277"] -ms.assetid: 15a83b07-8731-4524-810b-267f65a7844f --- # Compiler Error C2277 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md index 7a4f33b9e58..0591321c482 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2279" title: "Compiler Error C2279" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2279" +ms.date: 11/04/2016 f1_keywords: ["C2279"] helpviewer_keywords: ["C2279"] -ms.assetid: 1b5c88ef-2336-49b8-9ddb-d61f97c73e14 --- # Compiler Error C2279 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2280.md b/docs/error-messages/compiler-errors-1/compiler-error-c2280.md index f909de66443..c952f212b5e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2280.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2280.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2280" title: "Compiler Error C2280" -ms.date: "04/25/2017" +description: "Learn more about: Compiler Error C2280" +ms.date: 04/25/2017 f1_keywords: ["C2280"] helpviewer_keywords: ["C2280"] -ms.assetid: e6c5b1fb-2b9b-4554-8ff9-775eeb37161b --- # Compiler Error C2280 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2283.md b/docs/error-messages/compiler-errors-1/compiler-error-c2283.md index f399bc8b8a4..8f402a366e2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2283.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2283.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2283" description: "Learn more about: Compiler Error C2283" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C2283"] helpviewer_keywords: ["C2283"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2285.md b/docs/error-messages/compiler-errors-1/compiler-error-c2285.md index 4b095d4fcae..d11de7e744b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2285.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2285.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2285" title: "Compiler Error C2285" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2285" +ms.date: 11/04/2016 f1_keywords: ["C2285"] helpviewer_keywords: ["C2285"] -ms.assetid: 7b40a1b0-f477-49fa-b762-c3bccd88514e --- # Compiler Error C2285 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md index e8288d18f0a..81e52facd85 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2286" title: "Compiler Error C2286" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2286" +ms.date: 11/04/2016 f1_keywords: ["C2286"] helpviewer_keywords: ["C2286"] -ms.assetid: 078e0201-35cc-42e2-8dbc-6f8cf557b098 --- # Compiler Error C2286 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md index 1fa625d5368..5028b594ce8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2287" title: "Compiler Error C2287" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2287" +ms.date: 11/04/2016 f1_keywords: ["C2287"] helpviewer_keywords: ["C2287"] -ms.assetid: 64556299-4e1f-4437-88b7-2464fc0b95bb --- # Compiler Error C2287 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md index b2db59cb3fb..dd43552c14c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2289" title: "Compiler Error C2289" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2289" +ms.date: 11/04/2016 f1_keywords: ["C2289"] helpviewer_keywords: ["C2289"] -ms.assetid: cb41a29e-1b06-47dc-bfce-8d73bd63a0df --- # Compiler Error C2289 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md index 6d040d3b2a0..5742c5e234c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2290" title: "Compiler Error C2290" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2290" +ms.date: 11/04/2016 f1_keywords: ["C2290"] helpviewer_keywords: ["C2290"] -ms.assetid: 78c0feec-ccde-401b-8335-5b6ea6be8a13 --- # Compiler Error C2290 From 95ee0740fbfb76c7e33c7d13f95b20d5dba37bde Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 22 Jul 2025 22:03:12 +0800 Subject: [PATCH 0481/1799] Add "Remarks" and "Example" headings in C4324 warning reference --- .../compiler-warnings/compiler-warning-level-4-c4324.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md index f2f4076e29a..883f7ca1807 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C4324"] > '*structname*': structure was padded due to alignment specifier +## Remarks + Padding was added at the end of a structure because you specified an alignment specifier, such as [__declspec(align)](../../cpp/align-cpp.md). +## Example + For example, the following code generates C4324: ```cpp From 51f5892904b1f11563cb5043114be9359732d9d6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 22 Jul 2025 22:11:30 +0800 Subject: [PATCH 0482/1799] Update C4324 warning message --- .../compiler-warnings/compiler-warning-level-4-c4324.md | 2 +- .../compiler-warnings/compiler-warnings-c4200-through-c4399.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md index 883f7ca1807..3d6858e59f8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4324"] --- # Compiler Warning (level 4) C4324 -> '*structname*': structure was padded due to alignment specifier +> '*type*': structure was padded due to alignment specifier ## Remarks diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md index 08698aef3ad..e2115eba561 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md @@ -113,7 +113,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |Compiler warning (level 1) C4321|automatically generating an IID for interface '*interface*'| |Compiler warning (level 1) C4322|automatically generating a CLSID for class '*class*'| |Compiler warning (level 1) C4323|re-using registered CLSID for class '*class*'| -|[Compiler warning (level 4) C4324](compiler-warning-level-4-c4324.md)|'*structname*': structure was padded due to alignment specifier| +|[Compiler warning (level 4) C4324](compiler-warning-level-4-c4324.md)|'*type*': structure was padded due to alignment specifier| |[Compiler warning (level 1) C4325](compiler-warning-level-1-c4325.md)|attributes for standard section '*section*' ignored| |[Compiler warning (level 1) C4326](compiler-warning-level-1-c4326.md)|return type of '*function*' should be '*type1*' instead of '*type2*'| |Compiler warning C4327|'*assignment*': indirection alignment of LHS ('*alignment1*') is greater than RHS ('*alignment2*')| From f0aa1f53a5862e26692355fc13af9903abe2b13f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 22 Jul 2025 22:16:55 +0800 Subject: [PATCH 0483/1799] Add details to remarks in C4324 warning reference --- .../compiler-warnings/compiler-warning-level-4-c4324.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md index 3d6858e59f8..a7bb362f2e7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C4324"] ## Remarks -Padding was added at the end of a structure because you specified an alignment specifier, such as [__declspec(align)](../../cpp/align-cpp.md). +Padding was added at the end of a class/struct/union because you specified an alignment specifier, such as [`alignas`](../../cpp/alignas-specifier.md) or [`__declspec(align)`](../../cpp/align-cpp.md). ## Example From ebbeb2497c913f46ba5fee01725f235614d718a5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 22 Jul 2025 22:37:23 +0800 Subject: [PATCH 0484/1799] Improve example in C4324 warning reference --- .../compiler-warning-level-4-c4324.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md index a7bb362f2e7..effab81827e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md @@ -15,17 +15,21 @@ Padding was added at the end of a class/struct/union because you specified an al ## Example -For example, the following code generates C4324: +For example, `S1` and `S2` generates C4324 because padding is added when the specified alignment is greater than the default alignment of `1` and `4` respectively: ```cpp // C4324.cpp -// compile with: /W4 -struct __declspec(align(32)) A +// compile with: /W4 /c + +struct alignas(4) S1 {}; // C4324 + +struct alignas(8) S2 { - char a; + int i; }; // C4324 -int main() +struct alignas(4) S3 { -} + int i; +}; // OK ``` From 683a6350d2623b00fa8a88c08c58e37489632715 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 22 Jul 2025 22:38:21 +0800 Subject: [PATCH 0485/1799] Update metadata in C4324 warning reference --- .../compiler-warnings/compiler-warning-level-4-c4324.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md index effab81827e..5aed86571e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4324" title: "Compiler Warning (level 4) C4324" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4324" +ms.date: 07/22/2025 f1_keywords: ["C4324"] helpviewer_keywords: ["C4324"] --- From 972ac7e7f03cbbe29abfe1c67ebc23771e6d4638 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 22 Jul 2025 14:42:33 -0700 Subject: [PATCH 0486/1799] test uat tool --- docs/assembler/masm/dot-fpo.md | 27 +++++++++--------- ...ing-the-format-of-netmodule-input-files.md | 23 ++++++++------- docs/build/reference/ln-create-msil-module.md | 19 ++++++------- .../safe-cast-cpp-component-extensions.md | 28 +++++++++---------- 4 files changed, 46 insertions(+), 51 deletions(-) diff --git a/docs/assembler/masm/dot-fpo.md b/docs/assembler/masm/dot-fpo.md index 0e523fb9bf1..7c70aab623a 100644 --- a/docs/assembler/masm/dot-fpo.md +++ b/docs/assembler/masm/dot-fpo.md @@ -4,35 +4,34 @@ title: ".FPO" ms.date: "11/05/2019" f1_keywords: [".FPO"] helpviewer_keywords: [".FPO directive"] -ms.assetid: 35f4cd61-32f9-4262-b657-73f04f775d09 --- # .FPO (32-bit MASM) -The **.FPO** directive controls the emission of debug records to the .debug$F segment or section. (32-bit MASM only.) +The `.FPO` directive controls the emission of debug records to the `.debug$F` segment or section. Use this directive with 32-bit MASM only. ## Syntax -> **.FPO** (*cdwLocals*, *cdwParams*, *cbProlog*, *cbRegs*, *fUseBP*, *cbFrame*) +> `.FPO` (*`cdwLocals`*, *`cdwParams`*, *`cbProlog`*, *`cbRegs`*, *`fUseBP`*, *`cbFrame`*) ### Parameters -*cdwLocals*\ -Number of local variables, an unsigned 32 bit value. +*`cdwLocals`*\ +Number of local variables, an unsigned 32-bit value. -*cdwParams*\ -Size of the parameters in DWORDS, an unsigned 16 bit value. +*`cdwParams`*\ +Size of the parameters in DWORDS, an unsigned 16-bit value. -*cbProlog*\ -Number of bytes in the function prolog code, an unsigned 8 bit value. +*`cbProlog`*\ +Number of bytes in the function prolog code, an unsigned 8-bit value. -*cbRegs*\ +*`cbRegs`*\ Number registers saved. -*fUseBP*\ -Indicates whether the EBP register has been allocated. either 0 or 1. +*`fUseBP`*\ +Indicates whether the EBP register is allocated. Use either 0 or 1. -*cbFrame*\ -Indicates the frame type. See [FPO_DATA](/windows/win32/api/winnt/ns-winnt-fpo_data) for more information. +*`cbFrame`*\ +Indicates the frame type. For more information, see [`FPO_DATA`](/windows/win32/api/winnt/ns-winnt-fpo_data). ## See also diff --git a/docs/build/reference/choosing-the-format-of-netmodule-input-files.md b/docs/build/reference/choosing-the-format-of-netmodule-input-files.md index 708f741e6a0..5848e0a8ce2 100644 --- a/docs/build/reference/choosing-the-format-of-netmodule-input-files.md +++ b/docs/build/reference/choosing-the-format-of-netmodule-input-files.md @@ -2,32 +2,31 @@ description: "Learn more about: Choosing the Format of .netmodule Input Files" title: "Choosing the Format of .netmodule Input Files" ms.date: "11/04/2016" -ms.assetid: 4653d1bd-300f-4083-86f5-d1a06f44e61c --- -# Choosing the Format of .netmodule Input Files +# Choosing the format of .netmodule input files -An MSIL .obj file (compiled with [/clr](clr-common-language-runtime-compilation.md)) can also be used as a .netmodule file. .obj files contain metadata and native symbols. .netmodules only contain metadata. +You can use an MSIL `.obj` file (compiled with [`/clr`](clr-common-language-runtime-compilation.md)) as a `.netmodule` file. `.obj` files contain metadata and native symbols. `.netmodules` only contain metadata. -You can pass an MSIL .obj file to any other Visual Studio compiler via the /addmodule compiler option (but be aware that the .obj file becomes part of the resulting assembly and must be shipped with the assembly). For example, Visual C# and Visual Basic have the /addmodule compiler option. +Pass an MSIL `.obj` file to any other Visual Studio compiler with the `/addmodule` compiler option. Be aware that the `.obj` file becomes part of the resulting assembly and must be shipped with the assembly. For example, Visual C# and Visual Basic have the `/addmodule` compiler option. > [!NOTE] -> In most cases, you will need to pass to the linker the .obj file from the compilation that created the .net module. Passing a .dll or .netmodule MSIL module file to the linker may result in LNK1107. +> In most cases, you need to pass to the linker the `.obj` file from the compilation that created the .net module. Passing a `.dll` or `.netmodule` MSIL module file to the linker might result in LNK1107. -.obj files, along with their associated .h files, which you reference via #include in source, allow C++ applications to consume the native types in the module, whereas in a .netmodule file, only the managed types can be consumed by a C++ application. If you attempt to pass a .obj file to #using, information about native types will not be available; #include the .obj file's .h file instead. +`.obj` files, along with their associated `.h` files, which you reference via #include in source, allow C++ applications to consume the native types in the module. In a `.netmodule` file, only the managed types can be consumed by a C++ application. If you attempt to pass a `.obj` file to #using, information about native types isn't available. Instead, #include the `.obj` file's `.h` file. Other Visual Studio compilers can only consume managed types from a module. -Use the following to determine whether you need to use a .netmodule or a .obj file as module input to the MSVC linker: +Use the following guidance to determine whether you need to use a `.netmodule` or a `.obj` file as module input to the MSVC linker: -- If you are building with a Visual Studio compiler other than Visual C++, produce a .netmodule and use the .netmodule as input to the linker. +- If you're building with a Visual Studio compiler other than Visual C++, produce a `.netmodule` and use the `.netmodule` as input to the linker. -- If you are using the MSVC compiler to produce modules and if the module(s) will be used to build something other than a library, use the .obj files produced by the compiler as module input to the linker; do not use the .netmodule file as input. +- If you're using the MSVC compiler to produce modules and if the modules will be used to build something other than a library, use the `.obj` files produced by the compiler as module input to the linker. Don't use the `.netmodule` file as input. -- If your modules will be used to build a native (not a managed) library, use .obj files as module input to the linker and generate a .lib library file. +- If your modules will be used to build a native (not a managed) library, use `.obj` files as module input to the linker and generate a `.lib` library file. -- If your modules will be used to build a managed library, and if all module input to the linker will be verifiable (produced with /clr:safe), use .obj files as module input to the linker and generate a .dll (assembly) or .netmodule (module) library file. +- If your modules will be used to build a managed library, and if all module input to the linker is verifiable (produced with `/clr:safe`), use `.obj` files as module input to the linker and generate a `.dll` (assembly) or `.netmodule` (module) library file. -- If your modules will be used to build a managed library, and if one or more modules input to the linker will be produced with just /clr, use .obj files as module input to the linker and generate a .dll (assembly). If you want to expose managed types from the library and if you also want C++ applications to consume the native types in the library, your library will consist of the .obj files for the libraries component modules (you will also want to ship the .h files for each module, so they can be referenced with #include from source code). +- If your modules will be used to build a managed library, and if one or more modules input to the linker are produced with just `/clr`, use `.obj` files as module input to the linker and generate a `.dll` (assembly). If you want to expose managed types from the library and if you also want C++ applications to consume the native types in the library, your library consists of the `.obj` files for the libraries component modules. You also want to ship the `.h` files for each module, so they can be referenced with #include from source code. ## See also diff --git a/docs/build/reference/ln-create-msil-module.md b/docs/build/reference/ln-create-msil-module.md index c1a892c54b2..b281c6123ee 100644 --- a/docs/build/reference/ln-create-msil-module.md +++ b/docs/build/reference/ln-create-msil-module.md @@ -4,11 +4,10 @@ title: "/LN (Create MSIL Module)" ms.date: "11/04/2016" f1_keywords: ["/LN"] helpviewer_keywords: ["-LN compiler option [C++]", "/LN compiler option [C++]"] -ms.assetid: 4f38f4f4-3176-4caf-8200-5c7585dc1ed3 --- # /LN (Create MSIL Module) -Specifies that an assembly manifest should not be inserted into the output file. +Specifies that the compiler shouldn't insert an assembly manifest into the output file. ## Syntax @@ -18,19 +17,19 @@ Specifies that an assembly manifest should not be inserted into the output file. ## Remarks -By default, **/LN** is not in effect (an assembly manifest is inserted into the output file). +By default, `/LN` isn't in effect, and the compiler inserts an assembly manifest into the output file. -When **/LN** is used, one of the [/clr (Common Language Runtime Compilation)](clr-common-language-runtime-compilation.md) options must also be used. +When you use `/LN`, you must also use one of the [/clr (Common Language Runtime Compilation)](clr-common-language-runtime-compilation.md) options. -A managed program that does not have an assembly metadata in the manifest is called a module. If you compile with [/c (Compile Without Linking)](c-compile-without-linking.md) and **/LN**, specify [/NOASSEMBLY (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. +A managed program that doesn't have assembly metadata in the manifest is called a module. If you compile with [/c (Compile Without Linking)](c-compile-without-linking.md) and `/LN`, specify [/NOASSEMBLY (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. -You may want to create modules if you want to take a component-based approach to building assemblies. That is, you can author types and compile them into modules. Then, you can generate an assembly from one or more modules. For more information on creating assemblies from modules, see [.netmodule Files as Linker Input](netmodule-files-as-linker-input.md) or [Al.exe (Assembly Linker)](/dotnet/framework/tools/al-exe-assembly-linker). +Create modules if you want to take a component-based approach to building assemblies. You can author types and compile them into modules. Then, you can generate an assembly from one or more modules. For more information on creating assemblies from modules, see [.netmodule Files as Linker Input](netmodule-files-as-linker-input.md) or [Al.exe (Assembly Linker)](/dotnet/framework/tools/al-exe-assembly-linker). -The default file extension for a module is .netmodule. +The default file extension for a module is `.netmodule`. -In releases before Visual Studio 2005, a module was created with **/clr:noAssembly**. +In releases before Visual Studio 2005, you created a module with `/clr:noAssembly`. -The MSVC linker accepts .netmodule files as input and the output file produced by the linker will be an assembly or .netmodule with no run-time dependence on any of the .netmodules that were input to the linker. For more information, see [.netmodule Files as Linker Input](netmodule-files-as-linker-input.md). +The MSVC linker accepts `.netmodule` files as input. The output file produced by the linker is an assembly or `.netmodule` with no run-time dependence on any of the `.netmodule`s that you input to the linker. For more information, see [.netmodule Files as Linker Input](netmodule-files-as-linker-input.md). ### To set this compiler option in the Visual Studio development environment @@ -38,7 +37,7 @@ The MSVC linker accepts .netmodule files as input and the output file produced b ### To set this compiler option programmatically -- This compiler option cannot be changed programmatically. +- You can't change this compiler option programmatically. ## See also diff --git a/docs/extensions/safe-cast-cpp-component-extensions.md b/docs/extensions/safe-cast-cpp-component-extensions.md index 800fe8605f3..e17456a6427 100644 --- a/docs/extensions/safe-cast-cpp-component-extensions.md +++ b/docs/extensions/safe-cast-cpp-component-extensions.md @@ -5,11 +5,10 @@ ms.date: "10/12/2018" ms.topic: "reference" f1_keywords: ["safe_cast", "safe_cast_cpp", "stdcli::language::safe_cast"] helpviewer_keywords: ["safe_cast keyword [C++]"] -ms.assetid: 4fa688bf-a8ec-49bc-a4c5-f48134efa4f7 --- # safe_cast (C++/CLI and C++/CX) -The **safe_cast** operation returns the specified expression as the specified type, if successful; otherwise, throws `InvalidCastException`. +The **`safe_cast`** operation returns the specified expression as the specified type. If the operation isn't successful, it throws an `InvalidCastException`. ## All Runtimes @@ -23,7 +22,7 @@ The **safe_cast** operation returns the specified expression as the specified ty ## Windows Runtime -**safe_cast** allows you to change the type of a specified expression. In situations where you fully expect a variable or parameter to be convertible to a certain type, you can use **safe_cast** without a **try-catch** block to detect programming errors during development. For more information, see [Casting (C++/CX)](../cppcx/casting-c-cx.md). +Use **`safe_cast`** to change the type of a specified expression. If you expect a variable or parameter to be convertible to a certain type, use **`safe_cast`** without a **try-catch** block to detect programming errors during development. For more information, see [Casting (C++/CX)](../cppcx/casting-c-cx.md). ### Syntax @@ -41,7 +40,7 @@ An expression that evaluates to a handle to a reference or value type, a value t ### Remarks -**safe_cast** throws `InvalidCastException` if it cannot convert *expression* to the type specified by *type-id*. To catch `InvalidCastException`, specify the [/EH (Exception Handling Model)](../build/reference/eh-exception-handling-model.md) compiler option, and use a **try/catch** statement. +**`safe_cast`** throws `InvalidCastException` if it can't convert *expression* to the type specified by *type-id*. To catch `InvalidCastException`, specify the [/EH (Exception Handling Model)](../build/reference/eh-exception-handling-model.md) compiler option, and use a **try/catch** statement. ### Requirements @@ -49,7 +48,7 @@ Compiler option: `/ZW` ### Examples -The following code example demonstrates how to use **safe_cast** with the Windows Runtime. +The following code example demonstrates how to use **`safe_cast`** with the Windows Runtime. ```cpp // safe_cast_ZW.cpp @@ -83,7 +82,7 @@ Caught expected exception: InvalidCastException ## Common Language Runtime -**safe_cast** allows you to change the type of an expression and generate verifiable MSIL code. +**`safe_cast`** changes the type of an expression and generates verifiable MSIL code. ### Syntax @@ -93,30 +92,29 @@ Caught expected exception: InvalidCastException ### Parameters -*type-id*
+*`type-id`*\ A handle to a reference or value type, a value type, or a tracking reference to a reference or value type. -*expression*
+*`expression`* An expression that evaluates to a handle to a reference or value type, a value type, or a tracking reference to a reference or value type. ### Remarks The expression `safe_cast<`*type-id*`>(`*expression*`)` converts the operand *expression* to an object of type *type-id*. -The compiler will accept a [static_cast](../cpp/static-cast-operator.md) in most places that it will accept a **safe_cast**. However, **safe_cast** is guaranteed to produce verifiable MSIL, whereas a **`static_cast`** could produce unverifiable MSIL. See [Pure and Verifiable Code (C++/CLI)](../dotnet/pure-and-verifiable-code-cpp-cli.md) and [Peverify.exe (PEVerify Tool)](/dotnet/framework/tools/peverify-exe-peverify-tool) for more information on verifiable code. +The compiler accepts a [`static_cast`](../cpp/static-cast-operator.md) in most places that it accepts a **`safe_cast`**. However, **`safe_cast`** always produces verifiable MSIL, whereas a **`static_cast`** might produce unverifiable MSIL. For more information on verifiable code, see [Pure and Verifiable Code (C++/CLI)](../dotnet/pure-and-verifiable-code-cpp-cli.md) and [`Peverify.exe` (PEVerify Tool)](/dotnet/framework/tools/peverify-exe-peverify-tool). -Like **`static_cast`**, **safe_cast** invokes user-defined conversions. +Like **`static_cast`**, **`safe_cast`** invokes user-defined conversions. For more information about casts, see [Casting Operators](../cpp/casting-operators.md). -**safe_cast** does not apply a **`const_cast`** (cast away **`const`**). +**`safe_cast`** doesn't apply a **`const_cast`** (cast away **`const`**). -**safe_cast** is in the cli namespace. See [Platform, default, and cli Namespaces](platform-default-and-cli-namespaces-cpp-component-extensions.md) for more information. +**`safe_cast`** is in the cli namespace. For more information, see [Platform, default, and cli Namespaces](platform-default-and-cli-namespaces-cpp-component-extensions.md). -For more information on **safe_cast**, see: +For more information on **`safe_cast`**, see: - [C-Style Casts with /clr (C++/CLI)](c-style-casts-with-clr-cpp-cli.md) - - [How to: Use safe_cast in C++/CLI](../dotnet/how-to-use-safe-cast-in-cpp-cli.md) ### Requirements @@ -125,7 +123,7 @@ Compiler option: `/clr` ### Examples -One example of where the compiler will not accept a **`static_cast`** but will accept a **safe_cast** is for casts between unrelated interface types. With **safe_cast**, the compiler will not issue a conversion error and will perform a check at runtime to see if the cast is possible +One example of where the compiler doesn't accept a **`static_cast`** but accepts a **`safe_cast`** is for casts between unrelated interface types. With **`safe_cast`**, the compiler doesn't issue a conversion error and performs a check at runtime to see if the cast is possible. ```cpp // safe_cast.cpp From 9534150c2ad1465caaf968c5043dfbc0980ddacc Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 22 Jul 2025 15:47:44 -0700 Subject: [PATCH 0487/1799] acrolinx cleanup --- .../choosing-the-format-of-netmodule-input-files.md | 10 +++++----- docs/build/reference/ln-create-msil-module.md | 8 ++++---- docs/extensions/safe-cast-cpp-component-extensions.md | 6 +++--- 3 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/build/reference/choosing-the-format-of-netmodule-input-files.md b/docs/build/reference/choosing-the-format-of-netmodule-input-files.md index 5848e0a8ce2..86c167a0fb5 100644 --- a/docs/build/reference/choosing-the-format-of-netmodule-input-files.md +++ b/docs/build/reference/choosing-the-format-of-netmodule-input-files.md @@ -7,7 +7,7 @@ ms.date: "11/04/2016" You can use an MSIL `.obj` file (compiled with [`/clr`](clr-common-language-runtime-compilation.md)) as a `.netmodule` file. `.obj` files contain metadata and native symbols. `.netmodules` only contain metadata. -Pass an MSIL `.obj` file to any other Visual Studio compiler with the `/addmodule` compiler option. Be aware that the `.obj` file becomes part of the resulting assembly and must be shipped with the assembly. For example, Visual C# and Visual Basic have the `/addmodule` compiler option. +Pass an MSIL `.obj` file to any other Visual Studio compiler with the `/addmodule` compiler option. The `.obj` file becomes part of the resulting assembly and must be shipped with the assembly. For example, Visual C# and Visual Basic have the `/addmodule` compiler option. > [!NOTE] > In most cases, you need to pass to the linker the `.obj` file from the compilation that created the .net module. Passing a `.dll` or `.netmodule` MSIL module file to the linker might result in LNK1107. @@ -20,13 +20,13 @@ Use the following guidance to determine whether you need to use a `.netmodule` o - If you're building with a Visual Studio compiler other than Visual C++, produce a `.netmodule` and use the `.netmodule` as input to the linker. -- If you're using the MSVC compiler to produce modules and if the modules will be used to build something other than a library, use the `.obj` files produced by the compiler as module input to the linker. Don't use the `.netmodule` file as input. +- If you're using the MSVC compiler to produce modules and if the modules are used to build something other than a library, use the `.obj` files produced by the compiler as module input to the linker. Don't use the `.netmodule` file as input. -- If your modules will be used to build a native (not a managed) library, use `.obj` files as module input to the linker and generate a `.lib` library file. +- If your modules are used to build a native (not a managed) library, use `.obj` files as module input to the linker and generate a `.lib` library file. -- If your modules will be used to build a managed library, and if all module input to the linker is verifiable (produced with `/clr:safe`), use `.obj` files as module input to the linker and generate a `.dll` (assembly) or `.netmodule` (module) library file. +- If your modules are used to build a managed library, and if all module input to the linker is verifiable (produced with `/clr:safe`), use `.obj` files as module input to the linker and generate a `.dll` (assembly) or `.netmodule` (module) library file. -- If your modules will be used to build a managed library, and if one or more modules input to the linker are produced with just `/clr`, use `.obj` files as module input to the linker and generate a `.dll` (assembly). If you want to expose managed types from the library and if you also want C++ applications to consume the native types in the library, your library consists of the `.obj` files for the libraries component modules. You also want to ship the `.h` files for each module, so they can be referenced with #include from source code. +- If your modules are used to build a managed library, and if one or more modules input to the linker are produced with just `/clr`, use `.obj` files as module input to the linker and generate a `.dll` (assembly). If you want to expose managed types from the library and if you also want C++ applications to consume the native types in the library, your library consists of the `.obj` files for the libraries component modules. You also want to ship the `.h` files for each module, so they can be referenced with #include from source code. ## See also diff --git a/docs/build/reference/ln-create-msil-module.md b/docs/build/reference/ln-create-msil-module.md index b281c6123ee..b5cd351176f 100644 --- a/docs/build/reference/ln-create-msil-module.md +++ b/docs/build/reference/ln-create-msil-module.md @@ -21,19 +21,19 @@ By default, `/LN` isn't in effect, and the compiler inserts an assembly manifest When you use `/LN`, you must also use one of the [/clr (Common Language Runtime Compilation)](clr-common-language-runtime-compilation.md) options. -A managed program that doesn't have assembly metadata in the manifest is called a module. If you compile with [/c (Compile Without Linking)](c-compile-without-linking.md) and `/LN`, specify [/NOASSEMBLY (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. +A managed program that doesn't have assembly metadata in the manifest is called a module. If you compile with [/c (Compile Without Linking)](c-compile-without-linking.md) and `/LN`, specify [`/NOASSEMBLY `(Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. -Create modules if you want to take a component-based approach to building assemblies. You can author types and compile them into modules. Then, you can generate an assembly from one or more modules. For more information on creating assemblies from modules, see [.netmodule Files as Linker Input](netmodule-files-as-linker-input.md) or [Al.exe (Assembly Linker)](/dotnet/framework/tools/al-exe-assembly-linker). +Create modules if you want to take a component-based approach to building assemblies. You can author types and compile them into modules. Then, you can generate an assembly from one or more modules. For more information on creating assemblies from modules, see [`.netmodule` Files as Linker Input](netmodule-files-as-linker-input.md) or [`Al.exe `(Assembly Linker)](/dotnet/framework/tools/al-exe-assembly-linker). The default file extension for a module is `.netmodule`. In releases before Visual Studio 2005, you created a module with `/clr:noAssembly`. -The MSVC linker accepts `.netmodule` files as input. The output file produced by the linker is an assembly or `.netmodule` with no run-time dependence on any of the `.netmodule`s that you input to the linker. For more information, see [.netmodule Files as Linker Input](netmodule-files-as-linker-input.md). +The MSVC linker accepts `.netmodule` files as input. The output file produced by the linker is an assembly or `.netmodule` with no run-time dependence on any of the `.netmodule`s that you input to the linker. For more information, see [`.netmodule `Files as Linker Input](netmodule-files-as-linker-input.md). ### To set this compiler option in the Visual Studio development environment -- Specify [/NOASSEMBLY (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. +- Specify [`/NOASSEMBLY` (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. ### To set this compiler option programmatically diff --git a/docs/extensions/safe-cast-cpp-component-extensions.md b/docs/extensions/safe-cast-cpp-component-extensions.md index e17456a6427..a35a3a2af94 100644 --- a/docs/extensions/safe-cast-cpp-component-extensions.md +++ b/docs/extensions/safe-cast-cpp-component-extensions.md @@ -102,7 +102,7 @@ An expression that evaluates to a handle to a reference or value type, a value t The expression `safe_cast<`*type-id*`>(`*expression*`)` converts the operand *expression* to an object of type *type-id*. -The compiler accepts a [`static_cast`](../cpp/static-cast-operator.md) in most places that it accepts a **`safe_cast`**. However, **`safe_cast`** always produces verifiable MSIL, whereas a **`static_cast`** might produce unverifiable MSIL. For more information on verifiable code, see [Pure and Verifiable Code (C++/CLI)](../dotnet/pure-and-verifiable-code-cpp-cli.md) and [`Peverify.exe` (PEVerify Tool)](/dotnet/framework/tools/peverify-exe-peverify-tool). +The compiler accepts a [`static_cast`](../cpp/static-cast-operator.md) in most places that it accepts a **`safe_cast`**. However, **`safe_cast`** always produces verifiable MSIL, whereas a **`static_cast`** might produce unverifiable MSIL. For more information on verifiable code, see [Pure and Verifiable Code (C++/CLI)](../dotnet/pure-and-verifiable-code-cpp-cli.md) and [`Peverify.exe` (PEVerify Tool)](/dotnet/framework/tools/peverify-exe-peverify-tool). Like **`static_cast`**, **`safe_cast`** invokes user-defined conversions. @@ -110,7 +110,7 @@ For more information about casts, see [Casting Operators](../cpp/casting-operato **`safe_cast`** doesn't apply a **`const_cast`** (cast away **`const`**). -**`safe_cast`** is in the cli namespace. For more information, see [Platform, default, and cli Namespaces](platform-default-and-cli-namespaces-cpp-component-extensions.md). +**`safe_cast`** is in the cli namespace. For more information, see [Platform, default, and cli Namespaces](platform-default-and-cli-namespaces-cpp-component-extensions.md). For more information on **`safe_cast`**, see: @@ -123,7 +123,7 @@ Compiler option: `/clr` ### Examples -One example of where the compiler doesn't accept a **`static_cast`** but accepts a **`safe_cast`** is for casts between unrelated interface types. With **`safe_cast`**, the compiler doesn't issue a conversion error and performs a check at runtime to see if the cast is possible. +One example of where the compiler doesn't accept a **`static_cast`** but accepts a **`safe_cast`** is for casts between unrelated interface types. With **`safe_cast`**, the compiler doesn't issue a conversion error and performs a check at runtime to see if the cast is possible. ```cpp // safe_cast.cpp From 2505f9d99f8b58f18010712174aafccb9646de8f Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 22 Jul 2025 16:00:36 -0700 Subject: [PATCH 0488/1799] [tidy] replace `.00` with `.0` --- docs/overview/compiler-versions.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index 57c03deb47b..48e89639046 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -86,12 +86,12 @@ The following table lists the Visual C++ compiler `_MSC_VER` for each correspond | Visual Studio 6.0 | 1200 | 6.0 | | Visual Studio .NET 2002 (7.0) | 1300 | 7.0 | | Visual Studio .NET 2003 (7.1) | 1310 | 7.1 | -| Visual Studio 2005 (8.0) | 1400 | 8.00 | -| Visual Studio 2008 (9.0) | 1500 | 9.00 | -| Visual Studio 2010 (10.0) | 1600 | 10.00 | -| Visual Studio 2012 (11.0) | 1700 | 11.00 | -| Visual Studio 2013 (12.0) | 1800 | 12.00 | -| Visual Studio 2015 (14.0) | 1900 | 14.00 | +| Visual Studio 2005 (8.0) | 1400 | 8.0 | +| Visual Studio 2008 (9.0) | 1500 | 9.0 | +| Visual Studio 2010 (10.0) | 1600 | 10.0 | +| Visual Studio 2012 (11.0) | 1700 | 11.0 | +| Visual Studio 2013 (12.0) | 1800 | 12.0 | +| Visual Studio 2015 (14.0) | 1900 | 14.0 | | Visual Studio 2017 RTW (15.0) | 1910 | 14.10 | | Visual Studio 2017 version 15.3 | 1911 | 14.11 | | Visual Studio 2017 version 15.5 | 1912 | 14.12 | From aefc04ac47ff181da793be5cf03d3e72ccec7577 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 22 Jul 2025 16:03:09 -0700 Subject: [PATCH 0489/1799] [tidy] have the table description list the columns in the same order as they're shown --- docs/overview/compiler-versions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index 48e89639046..e9455ef10a9 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -79,7 +79,7 @@ When the major version changed between Visual Studio 2013 and Visual Studio 2015 An example of a minor change is from Visual Studio 2022 17.1 to Visual Studio 2022 17.2. In that case, `_MSC_VER` changed from 1931 to 1932. -The following table lists the Visual C++ compiler `_MSC_VER` for each corresponding Visual Studio and MSVC toolset release: +The following table lists the Visual Studio version corresponding to each Visual C++ compiler (`_MSC_VER`), and MSVC toolset release: | Visual Studio version | `_MSC_VER` | MSVC toolset version | |--|--|--| From 572dad41bf856c221ee0d7502119756b480ec7c7 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 22 Jul 2025 16:11:46 -0700 Subject: [PATCH 0490/1799] [tidy] remove bogus comma --- docs/overview/compiler-versions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index e9455ef10a9..b167daf2351 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -79,7 +79,7 @@ When the major version changed between Visual Studio 2013 and Visual Studio 2015 An example of a minor change is from Visual Studio 2022 17.1 to Visual Studio 2022 17.2. In that case, `_MSC_VER` changed from 1931 to 1932. -The following table lists the Visual Studio version corresponding to each Visual C++ compiler (`_MSC_VER`), and MSVC toolset release: +The following table lists the Visual Studio version corresponding to each Visual C++ compiler (`_MSC_VER`) and MSVC toolset release: | Visual Studio version | `_MSC_VER` | MSVC toolset version | |--|--|--| From 669f966db3cf4a3f30dc574523bf54266189730e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 15:52:36 +0800 Subject: [PATCH 0491/1799] Add backticks in "Dynamically Determining Columns Returned to the Consumer" --- ...ically-determining-columns-returned-to-the-consumer.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md index 9ae135a598a..3233a847e10 100644 --- a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md +++ b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md @@ -7,9 +7,9 @@ ms.assetid: 58522b7a-894e-4b7d-a605-f80e900a7f5f --- # Dynamically Determining Columns Returned to the Consumer -The PROVIDER_COLUMN_ENTRY macros normally handle the `IColumnsInfo::GetColumnsInfo` call. However, because a consumer might choose to use bookmarks, the provider must be able to change the columns returned depending on whether the consumer asks for a bookmark. +The `PROVIDER_COLUMN_ENTRY` macros normally handle the `IColumnsInfo::GetColumnsInfo` call. However, because a consumer might choose to use bookmarks, the provider must be able to change the columns returned depending on whether the consumer asks for a bookmark. -To handle the `IColumnsInfo::GetColumnsInfo` call, delete the PROVIDER_COLUMN_MAP, which defines a function `GetColumnInfo`, from the `CCustomWindowsFile` user record in *Custom*RS.h and replace it with the definition for your own `GetColumnInfo` function: +To handle the `IColumnsInfo::GetColumnsInfo` call, delete the `PROVIDER_COLUMN_MAP`, which defines a function `GetColumnInfo`, from the `CCustomWindowsFile` user record in *Custom*RS.h and replace it with the definition for your own `GetColumnInfo` function: ```cpp //////////////////////////////////////////////////////////////////////// @@ -36,7 +36,7 @@ Next, implement the `GetColumnInfo` function in *Custom*RS.cpp, as shown in the `GetColumnInfo` checks first to see if the OLE DB property `DBPROP_BOOKMARKS` is set. To get the property, `GetColumnInfo` uses a pointer (`pRowset`) to the rowset object. The `pThis` pointer represents the class that created the rowset, which is the class where the property map is stored. `GetColumnInfo` typecasts the `pThis` pointer to an `RCustomRowset` pointer. -To check for the `DBPROP_BOOKMARKS` property, `GetColumnInfo` uses the `IRowsetInfo` interface, which you can get by calling `QueryInterface` on the `pRowset` interface. As an alternative, you can use an ATL [CComQIPtr](../../atl/reference/ccomqiptr-class.md) method instead. +To check for the `DBPROP_BOOKMARKS` property, `GetColumnInfo` uses the `IRowsetInfo` interface, which you can get by calling `QueryInterface` on the `pRowset` interface. As an alternative, you can use an ATL [`CComQIPtr`](../../atl/reference/ccomqiptr-class.md) method instead. ```cpp //////////////////////////////////////////////////////////////////// @@ -97,7 +97,7 @@ ATLCOLUMNINFO* CCustomWindowsFile::GetColumnInfo(void* pThis, ULONG* pcCols) } ``` -This example uses a static array to hold the column information. If the consumer doesn't want the bookmark column, one entry in the array is unused. To handle the information, you create two array macros: ADD_COLUMN_ENTRY and ADD_COLUMN_ENTRY_EX. ADD_COLUMN_ENTRY_EX takes an extra parameter, *flags*, that is needed if you designate a bookmark column. +This example uses a static array to hold the column information. If the consumer doesn't want the bookmark column, one entry in the array is unused. To handle the information, you create two array macros: `ADD_COLUMN_ENTRY` and `ADD_COLUMN_ENTRY_EX`. `ADD_COLUMN_ENTRY_EX` takes an extra parameter, *`flags`*, that is needed if you designate a bookmark column. ```cpp //////////////////////////////////////////////////////////////////////// From cdd96ad17fa2271513b474d65f5b7fc4cd5353bf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 15:55:28 +0800 Subject: [PATCH 0492/1799] Fix trailing spaces syntax errors in "Dynamically Determining Columns Returned to the Consumer" --- ...mining-columns-returned-to-the-consumer.md | 44 +++++++++---------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md index 3233a847e10..1dad936b131 100644 --- a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md +++ b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md @@ -103,29 +103,29 @@ This example uses a static array to hold the column information. If the consumer //////////////////////////////////////////////////////////////////////// // CustomRS.h -#define ADD_COLUMN_ENTRY(ulCols, name, ordinal, colSize, type, precision, scale, guid, dataClass, member) \ - _rgColumns[ulCols].pwszName = (LPOLESTR)name; \ - _rgColumns[ulCols].pTypeInfo = (ITypeInfo*)NULL; \ - _rgColumns[ulCols].iOrdinal = (ULONG)ordinal; \ - _rgColumns[ulCols].dwFlags = 0; \ - _rgColumns[ulCols].ulColumnSize = (ULONG)colSize; \ - _rgColumns[ulCols].wType = (DBTYPE)type; \ - _rgColumns[ulCols].bPrecision = (BYTE)precision; \ - _rgColumns[ulCols].bScale = (BYTE)scale; \ - _rgColumns[ulCols].cbOffset = offsetof(dataClass, member); +#define ADD_COLUMN_ENTRY(ulCols, name, ordinal, colSize, type, precision, scale, guid, dataClass, member) \ + _rgColumns[ulCols].pwszName = (LPOLESTR)name; \ + _rgColumns[ulCols].pTypeInfo = (ITypeInfo*)NULL; \ + _rgColumns[ulCols].iOrdinal = (ULONG)ordinal; \ + _rgColumns[ulCols].dwFlags = 0; \ + _rgColumns[ulCols].ulColumnSize = (ULONG)colSize; \ + _rgColumns[ulCols].wType = (DBTYPE)type; \ + _rgColumns[ulCols].bPrecision = (BYTE)precision; \ + _rgColumns[ulCols].bScale = (BYTE)scale; \ + _rgColumns[ulCols].cbOffset = offsetof(dataClass, member); -#define ADD_COLUMN_ENTRY_EX(ulCols, name, ordinal, colSize, type, precision, scale, guid, dataClass, member, flags) \ - _rgColumns[ulCols].pwszName = (LPOLESTR)name; \ - _rgColumns[ulCols].pTypeInfo = (ITypeInfo*)NULL; \ - _rgColumns[ulCols].iOrdinal = (ULONG)ordinal; \ - _rgColumns[ulCols].dwFlags = flags; \ - _rgColumns[ulCols].ulColumnSize = (ULONG)colSize; \ - _rgColumns[ulCols].wType = (DBTYPE)type; \ - _rgColumns[ulCols].bPrecision = (BYTE)precision; \ - _rgColumns[ulCols].bScale = (BYTE)scale; \ - _rgColumns[ulCols].cbOffset = offsetof(dataClass, member); \ - memset(&(_rgColumns[ulCols].columnid), 0, sizeof(DBID)); \ - _rgColumns[ulCols].columnid.uName.pwszName = (LPOLESTR)name; +#define ADD_COLUMN_ENTRY_EX(ulCols, name, ordinal, colSize, type, precision, scale, guid, dataClass, member, flags) \ + _rgColumns[ulCols].pwszName = (LPOLESTR)name; \ + _rgColumns[ulCols].pTypeInfo = (ITypeInfo*)NULL; \ + _rgColumns[ulCols].iOrdinal = (ULONG)ordinal; \ + _rgColumns[ulCols].dwFlags = flags; \ + _rgColumns[ulCols].ulColumnSize = (ULONG)colSize; \ + _rgColumns[ulCols].wType = (DBTYPE)type; \ + _rgColumns[ulCols].bPrecision = (BYTE)precision; \ + _rgColumns[ulCols].bScale = (BYTE)scale; \ + _rgColumns[ulCols].cbOffset = offsetof(dataClass, member); \ + memset(&(_rgColumns[ulCols].columnid), 0, sizeof(DBID)); \ + _rgColumns[ulCols].columnid.uName.pwszName = (LPOLESTR)name; ``` In the `GetColumnInfo` function, the bookmark macro is used like this: From 813a7d8f14ca17e7db30260866fb8f4c9625b72e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 15:57:34 +0800 Subject: [PATCH 0493/1799] Remove unneeded spaces in "Dynamically Determining Columns Returned to the Consumer" --- ...mining-columns-returned-to-the-consumer.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md index 1dad936b131..5cf5dd2434b 100644 --- a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md +++ b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md @@ -23,7 +23,7 @@ public: TCHAR szText[iSize]; TCHAR szCommand2[iSize]; TCHAR szText2[iSize]; - + static ATLCOLUMNINFO* GetColumnInfo(void* pThis, ULONG* pcCols); bool operator==(const CCustomWindowsFile& am) { @@ -45,27 +45,27 @@ ATLCOLUMNINFO* CCustomWindowsFile::GetColumnInfo(void* pThis, ULONG* pcCols) { static ATLCOLUMNINFO _rgColumns[5]; ULONG ulCols = 0; - + // Check the property flag for bookmarks; if it is set, set the zero // ordinal entry in the column map with the bookmark information. CCustomRowset* pRowset = (CCustomRowset*) pThis; CComQIPtr spRowsetProps = pRowset; - + CDBPropIDSet set(DBPROPSET_ROWSET); set.AddPropertyID(DBPROP_BOOKMARKS); DBPROPSET* pPropSet = NULL; ULONG ulPropSet = 0; HRESULT hr; - + if (spRowsetProps) hr = spRowsetProps->GetProperties(1, &set, &ulPropSet, &pPropSet); - + if (pPropSet) { CComVariant var = pPropSet->rgProperties[0].vValue; CoTaskMemFree(pPropSet->rgProperties); CoTaskMemFree(pPropSet); - + if (SUCCEEDED(hr) && (var.boolVal == VARIANT_TRUE)) { ADD_COLUMN_ENTRY_EX(ulCols, OLESTR("Bookmark"), 0, sizeof(DWORD), @@ -74,7 +74,7 @@ ATLCOLUMNINFO* CCustomWindowsFile::GetColumnInfo(void* pThis, ULONG* pcCols) ulCols++; } } - + // Next, set the other columns up. ADD_COLUMN_ENTRY(ulCols, OLESTR("Command"), 1, 256, DBTYPE_STR, 0xFF, 0xFF, GUID_NULL, CCustomWindowsFile, szCommand) @@ -82,17 +82,17 @@ ATLCOLUMNINFO* CCustomWindowsFile::GetColumnInfo(void* pThis, ULONG* pcCols) ADD_COLUMN_ENTRY(ulCols, OLESTR("Text"), 2, 256, DBTYPE_STR, 0xFF, 0xFF, GUID_NULL, CCustomWindowsFile, szText) ulCols++; - + ADD_COLUMN_ENTRY(ulCols, OLESTR("Command2"), 3, 256, DBTYPE_STR, 0xFF, 0xFF, GUID_NULL, CCustomWindowsFile, szCommand2) ulCols++; ADD_COLUMN_ENTRY(ulCols, OLESTR("Text2"), 4, 256, DBTYPE_STR, 0xFF, 0xFF, GUID_NULL, CCustomWindowsFile, szText2) ulCols++; - + if (pcCols != NULL) *pcCols = ulCols; - + return _rgColumns; } ``` @@ -100,9 +100,9 @@ ATLCOLUMNINFO* CCustomWindowsFile::GetColumnInfo(void* pThis, ULONG* pcCols) This example uses a static array to hold the column information. If the consumer doesn't want the bookmark column, one entry in the array is unused. To handle the information, you create two array macros: `ADD_COLUMN_ENTRY` and `ADD_COLUMN_ENTRY_EX`. `ADD_COLUMN_ENTRY_EX` takes an extra parameter, *`flags`*, that is needed if you designate a bookmark column. ```cpp -//////////////////////////////////////////////////////////////////////// -// CustomRS.h - +//////////////////////////////////////////////////////////////////////// +// CustomRS.h + #define ADD_COLUMN_ENTRY(ulCols, name, ordinal, colSize, type, precision, scale, guid, dataClass, member) \ _rgColumns[ulCols].pwszName = (LPOLESTR)name; \ _rgColumns[ulCols].pTypeInfo = (ITypeInfo*)NULL; \ @@ -113,7 +113,7 @@ This example uses a static array to hold the column information. If the consumer _rgColumns[ulCols].bPrecision = (BYTE)precision; \ _rgColumns[ulCols].bScale = (BYTE)scale; \ _rgColumns[ulCols].cbOffset = offsetof(dataClass, member); - + #define ADD_COLUMN_ENTRY_EX(ulCols, name, ordinal, colSize, type, precision, scale, guid, dataClass, member, flags) \ _rgColumns[ulCols].pwszName = (LPOLESTR)name; \ _rgColumns[ulCols].pTypeInfo = (ITypeInfo*)NULL; \ From b01130388d97049a383b125cb5cd387540bba2f4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 15:59:09 +0800 Subject: [PATCH 0494/1799] Simplify redundant links and remove `br` element in "Dynamically Determining Columns Returned to the Consumer" --- ...ynamically-determining-columns-returned-to-the-consumer.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md index 5cf5dd2434b..1df579c68fa 100644 --- a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md +++ b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md @@ -136,8 +136,8 @@ ADD_COLUMN_ENTRY_EX(ulCols, OLESTR("Bookmark"), 0, sizeof(DWORD), DBCOLUMNFLAGS_ISBOOKMARK) ``` -You can now compile and run the enhanced provider. To test the provider, modify the test consumer as described in [Implementing a Simple Consumer](../../data/oledb/implementing-a-simple-consumer.md). Run the test consumer with the provider and verify that the test consumer retrieves the proper strings from the provider. +You can now compile and run the enhanced provider. To test the provider, modify the test consumer as described in [Implementing a Simple Consumer](implementing-a-simple-consumer.md). Run the test consumer with the provider and verify that the test consumer retrieves the proper strings from the provider. ## See also -[Enhancing the Simple Read-Only Provider](../../data/oledb/enhancing-the-simple-read-only-provider.md)
+[Enhancing the Simple Read-Only Provider](enhancing-the-simple-read-only-provider.md) From 5fa0a6d64f68d6b2e24860d18a2ff4c701320662 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 16:03:25 +0800 Subject: [PATCH 0495/1799] Update metadata in "Dynamically Determining Columns Returned to the Consumer" --- ...namically-determining-columns-returned-to-the-consumer.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md index 1df579c68fa..14175fae5ef 100644 --- a/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md +++ b/docs/data/oledb/dynamically-determining-columns-returned-to-the-consumer.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Dynamically Determining Columns Returned to the Consumer" title: "Dynamically Determining Columns Returned to the Consumer" -ms.date: "10/26/2018" +description: "Learn more about: Dynamically Determining Columns Returned to the Consumer" +ms.date: 10/26/2018 helpviewer_keywords: ["bookmarks [C++], dynamically determining columns", "dynamically determining columns [C++]"] -ms.assetid: 58522b7a-894e-4b7d-a605-f80e900a7f5f --- # Dynamically Determining Columns Returned to the Consumer From 60901939ba2ae298b932926b4239d18f460c381a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 16:40:47 +0800 Subject: [PATCH 0496/1799] Add blockquotes and update C2469 error message --- docs/error-messages/compiler-errors-1/compiler-error-c2469.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md index 46ce44d6ee3..d1ac4279e5c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md @@ -8,7 +8,7 @@ ms.assetid: 3814bdff-581a-4d3e-8b47-8de6887cea69 --- # Compiler Error C2469 -'operator': cannot allocate 'type' object +> '`new`': cannot allocate '`void`' objects An operator was passed an invalid type. From 7c39f00f34fb1b1361894637ea2e923b901b9e4f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 16:43:11 +0800 Subject: [PATCH 0497/1799] Add "Remarks" heading in C2469 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2469.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md index d1ac4279e5c..3464cd12422 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md @@ -10,6 +10,8 @@ ms.assetid: 3814bdff-581a-4d3e-8b47-8de6887cea69 > '`new`': cannot allocate '`void`' objects +## Remarks + An operator was passed an invalid type. The following sample generates C2469: From 6a33584d2768d1ef4e4d640021780907a3671949 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 16:52:00 +0800 Subject: [PATCH 0498/1799] Overhaul example in C2469 error reference --- .../compiler-errors-1/compiler-error-c2469.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md index 3464cd12422..e24b9e7ab90 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md @@ -14,12 +14,16 @@ ms.assetid: 3814bdff-581a-4d3e-8b47-8de6887cea69 An operator was passed an invalid type. -The following sample generates C2469: +## Example: Wrong allocation type + +Check if you meant to allocate `void` or some other type, such as `int`: ```cpp -// C2469.cpp -int main() { - int *i = new void; // C2469 - int *i = new int; // OK +// C2469_wrong_allocation_type.cpp + +int main() +{ + int* ptr1 = new void; // C2469 + int* ptr2 = new int; // OK } ``` From b6e51eae92bb0cc742d1aca318eb0c78d93f9cfb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 17:02:00 +0800 Subject: [PATCH 0499/1799] Add new "Allocate untyped memory" example in C2469 error reference --- .../compiler-errors-1/compiler-error-c2469.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md index e24b9e7ab90..a2a397de8d2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md @@ -27,3 +27,17 @@ int main() int* ptr2 = new int; // OK } ``` + +## Example: Allocate untyped memory + +If you meant to allocate untyped memory, use `::operator new` instead: + +```cpp +// C2469_allocate_untyped_memory.cpp + +int main() +{ + void* ptr1 = new void; // C2469 + void* ptr2 = ::operator new(4); // OK +} +``` From eaa3c7e3944d7d1283d3b7c9a8a51a6c602a72d7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 17:03:27 +0800 Subject: [PATCH 0500/1799] Update remarks in C2469 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2469.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md index a2a397de8d2..ad0c366f2de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md @@ -12,7 +12,7 @@ ms.assetid: 3814bdff-581a-4d3e-8b47-8de6887cea69 ## Remarks -An operator was passed an invalid type. +The [`new` operator](../../cpp/new-operator-cpp.md) was passed an invalid type. ## Example: Wrong allocation type From 72165c32f5bb6a6d7d12af15b0a783c23acf39f7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 17:04:11 +0800 Subject: [PATCH 0501/1799] Update metadata in C2469 error reference --- .../error-messages/compiler-errors-1/compiler-error-c2469.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md index ad0c366f2de..836e2ea2623 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2469" title: "Compiler Error C2469" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2469" +ms.date: 07/23/2025 f1_keywords: ["C2469"] helpviewer_keywords: ["C2469"] -ms.assetid: 3814bdff-581a-4d3e-8b47-8de6887cea69 --- # Compiler Error C2469 From e86f793296a089e32253019d0bffdd2b479beb48 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 18:11:44 +0800 Subject: [PATCH 0502/1799] Fix wrong sentence that implies `delete[]` can be used in place of `delete` in "Raw pointers (C++)" --- docs/cpp/raw-pointers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/raw-pointers.md b/docs/cpp/raw-pointers.md index c12c7051c64..babfbd1ea04 100644 --- a/docs/cpp/raw-pointers.md +++ b/docs/cpp/raw-pointers.md @@ -19,7 +19,7 @@ A pointer can also be *dereferenced* to retrieve the value of the object that it int j = *p; // dereference p to retrieve the value at its address ``` -A pointer can point to a typed object or to **`void`**. When a program allocates an object on the [heap](https://wikipedia.org/wiki/Heap) in memory, it receives the address of that object in the form of a pointer. Such pointers are called *owning pointers*. An owning pointer (or a copy of it) must be used to explicitly free the heap-allocated object when it's no longer needed. Failure to free the memory results in a *memory leak*, and renders that memory location unavailable to any other program on the machine. Memory allocated using **`new`** must be freed by using **`delete`** (or **`delete[]`**). For more information, see [`new` and `delete` operators](new-and-delete-operators.md). +A pointer can point to a typed object or to **`void`**. When a program allocates an object on the [heap](https://wikipedia.org/wiki/Heap) in memory, it receives the address of that object in the form of a pointer. Such pointers are called *owning pointers*. An owning pointer (or a copy of it) must be used to explicitly free the heap-allocated object when it's no longer needed. Failure to free the memory results in a *memory leak*, and renders that memory location unavailable to any other program on the machine. Memory allocated with **`new`** must be freed using **`delete`**, and memory allocated with **`new[]`** must be freed using **`delete[]`**. For more information, see [`new` and `delete` operators](new-and-delete-operators.md). ```cpp MyClass* mc = new MyClass(); // allocate object on the heap From e720bf9884cf492a38334363027f4fff1736cbac Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 18:21:59 +0800 Subject: [PATCH 0503/1799] Remove sentence that implies pointer arithmetic on `void*` is allowed in "Raw pointers (C++)" --- docs/cpp/raw-pointers.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/raw-pointers.md b/docs/cpp/raw-pointers.md index babfbd1ea04..f6d8d4aed47 100644 --- a/docs/cpp/raw-pointers.md +++ b/docs/cpp/raw-pointers.md @@ -156,7 +156,7 @@ int main() } ``` -Certain arithmetic operations can be used on non-`const` pointers to make them point to another memory location. Pointers are incremented and decremented using the **`++`**, **`+=`**, **`-=`** and **`--`** operators. This technique can be used in arrays and is especially useful in buffers of untyped data. A `void*` gets incremented by the size of a **`char`** (1 byte). A typed pointer gets incremented by size of the type it points to. +Certain arithmetic operations can be used on non-`const` pointers to make them point to another memory location. Pointers are incremented and decremented using the **`++`**, **`+=`**, **`-=`** and **`--`** operators. This technique can be used in arrays and is especially useful in buffers of untyped data. A typed pointer gets incremented by size of the type it points to. The following example demonstrates how pointer arithmetic can be used to access individual pixels in a bitmap on Windows. Note the use of **`new`** and **`delete`**, and the dereference operator. From 66d88ddfb744e93e3c406c0ce9bcb23ab508f98c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 18:31:29 +0800 Subject: [PATCH 0504/1799] Add 2 `Output` code blocks in "Raw pointers (C++)" --- docs/cpp/raw-pointers.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/cpp/raw-pointers.md b/docs/cpp/raw-pointers.md index f6d8d4aed47..5b00104653c 100644 --- a/docs/cpp/raw-pointers.md +++ b/docs/cpp/raw-pointers.md @@ -156,6 +156,10 @@ int main() } ``` +```Output +1 2 3 4 5 +``` + Certain arithmetic operations can be used on non-`const` pointers to make them point to another memory location. Pointers are incremented and decremented using the **`++`**, **`+=`**, **`-=`** and **`--`** operators. This technique can be used in arrays and is especially useful in buffers of untyped data. A typed pointer gets incremented by size of the type it points to. The following example demonstrates how pointer arithmetic can be used to access individual pixels in a bitmap on Windows. Note the use of **`new`** and **`delete`**, and the dereference operator. @@ -332,6 +336,11 @@ int main() } ``` +```Output +hello world from MSVC +Good morning and hello world from MSVC +``` + ## See also [Smart pointers](smart-pointers-modern-cpp.md)\ From e0c3d3fd6cf87ca3bc5393f4d259cffa931b9046 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 18:34:23 +0800 Subject: [PATCH 0505/1799] Use idiomatic usage of `delete` in "Raw pointers (C++)" --- docs/cpp/raw-pointers.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/cpp/raw-pointers.md b/docs/cpp/raw-pointers.md index 5b00104653c..743e7f30384 100644 --- a/docs/cpp/raw-pointers.md +++ b/docs/cpp/raw-pointers.md @@ -119,8 +119,8 @@ int main() func_B(*pmc); pmc->print(); // "Erika, 3" (original not modified by function) - delete(pmc); // don't forget to give memory back to operating system! - // delete(pmc2); //crash! memory location was already deleted + delete pmc; // don't forget to give memory back to operating system! + // delete pmc2; //crash! memory location was already deleted } ``` @@ -268,7 +268,7 @@ int main() void* p = static_cast(mc); MyClass* mc2 = static_cast(p); std::cout << mc2->name << std::endl; // "Marian" - delete(mc); + delete mc; // use operator new to allocate untyped memory block void* pvoid = operator new(1000); From c3195c9abd56b46f616126b7ffdf54d4ddba8e40 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 23 Jul 2025 18:38:42 +0800 Subject: [PATCH 0506/1799] Fix incorrect delimiter in output comments for example in "Raw pointers (C++)" --- docs/cpp/raw-pointers.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/cpp/raw-pointers.md b/docs/cpp/raw-pointers.md index 743e7f30384..3c4d07c50e6 100644 --- a/docs/cpp/raw-pointers.md +++ b/docs/cpp/raw-pointers.md @@ -78,7 +78,7 @@ void func_B(MyClass mc) // This statement modifies only the local copy of mc. mc.num = 21; std::cout << "Local copy of mc:"; - mc.print(); // "Erika, 21" + mc.print(); // "Erika:21" } int main() @@ -99,25 +99,25 @@ int main() MyClass* pcopy = &mc; // Use the -> operator to access the object's public members - pmc->print(); // "Nick, 108" + pmc->print(); // "Nick:108" // Copy the pointer. Now pmc and pmc2 point to same object! MyClass* pmc2 = pmc; // Use copied pointer to modify the original object pmc2->name = "Erika"; - pmc->print(); // "Erika, 108" - pmc2->print(); // "Erika, 108" + pmc->print(); // "Erika:108" + pmc2->print(); // "Erika:108" // Pass the pointer to a function. func_A(pmc); - pmc->print(); // "Erika, 3" - pmc2->print(); // "Erika, 3" + pmc->print(); // "Erika:3" + pmc2->print(); // "Erika:3" // Dereference the pointer and pass a copy // of the pointed-to object to a function func_B(*pmc); - pmc->print(); // "Erika, 3" (original not modified by function) + pmc->print(); // "Erika:3" (original not modified by function) delete pmc; // don't forget to give memory back to operating system! // delete pmc2; //crash! memory location was already deleted From 799ba57d2bb69449c37f03f13969fe1214fdea3f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 24 Jul 2025 21:21:36 +0800 Subject: [PATCH 0507/1799] Resolve mismatched "lt" and "gt" operator links --- docs/mfc/windows-sockets-example-of-sockets-using-archives.md | 2 +- docs/parallel/concrt/reference/concurrency-namespace.md | 2 +- docs/standard-library/deque.md | 2 +- docs/standard-library/forward-list.md | 2 +- docs/standard-library/iterator.md | 2 +- docs/standard-library/list.md | 2 +- docs/standard-library/memory.md | 2 +- docs/standard-library/optional.md | 2 +- docs/standard-library/queue.md | 2 +- docs/standard-library/regex.md | 2 +- docs/standard-library/utility.md | 2 +- docs/standard-library/variant.md | 2 +- docs/standard-library/vector.md | 2 +- 13 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/mfc/windows-sockets-example-of-sockets-using-archives.md b/docs/mfc/windows-sockets-example-of-sockets-using-archives.md index bd76e3b6f35..c97e8c3d0ca 100644 --- a/docs/mfc/windows-sockets-example-of-sockets-using-archives.md +++ b/docs/mfc/windows-sockets-example-of-sockets-using-archives.md @@ -50,6 +50,6 @@ For more information, see Windows Sockets Specification: **htonl**, **htons**, * [Windows Sockets in MFC](../mfc/windows-sockets-in-mfc.md)
[CArchive::IsStoring](../mfc/reference/carchive-class.md#isstoring)
[CArchive::operator <<](../mfc/reference/carchive-class.md#operator_lt_lt)
-[CArchive::operator >>](../mfc/reference/carchive-class.md#operator_lt_lt)
+[CArchive::operator >>](../mfc/reference/carchive-class.md#operator_gt_gt)
[CArchive::Flush](../mfc/reference/carchive-class.md#flush)
[CObject::Serialize](../mfc/reference/cobject-class.md#serialize) diff --git a/docs/parallel/concrt/reference/concurrency-namespace.md b/docs/parallel/concrt/reference/concurrency-namespace.md index a336049731c..4f5a100c3aa 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace.md +++ b/docs/parallel/concrt/reference/concurrency-namespace.md @@ -208,7 +208,7 @@ namespace concurrency; |[operator<=](concurrency-namespace-operators.md#operator_lt_eq)|Tests if the `concurrent_vector` object on the left side of the operator is less than or equal to the `concurrent_vector` object on the right side.| |[operator==](concurrency-namespace-operators.md#operator_eq_eq)|Tests if the `concurrent_vector` object on the left side of the operator is equal to the `concurrent_vector` object on the right side.| |[operator>](concurrency-namespace-operators.md#operator_gt)|Tests if the `concurrent_vector` object on the left side of the operator is greater than the `concurrent_vector` object on the right side.| -|[operator>=](concurrency-namespace-operators.md#operator_lt_eq)|Tests if the `concurrent_vector` object on the left side of the operator is greater than or equal to the `concurrent_vector` object on the right side.| +|[operator>=](concurrency-namespace-operators.md#operator_gt_eq)|Tests if the `concurrent_vector` object on the left side of the operator is greater than or equal to the `concurrent_vector` object on the right side.| ### Constants diff --git a/docs/standard-library/deque.md b/docs/standard-library/deque.md index 4a56c8107b7..2f728d94aee 100644 --- a/docs/standard-library/deque.md +++ b/docs/standard-library/deque.md @@ -25,7 +25,7 @@ Defines the container class template deque and several supporting templates. |-|-| |[operator!=](../standard-library/deque-operators.md#op_neq)|Tests if the deque object on the left side of the operator is not equal to the deque object on the right side.| |[operator<](../standard-library/deque-operators.md#op_lt)|Tests if the deque object on the left side of the operator is less than the deque object on the right side.| -|[operator\<=](../standard-library/deque-operators.md#op_gt_eq)|Tests if the deque object on the left side of the operator is less than or equal to the deque object on the right side.| +|[operator\<=](../standard-library/deque-operators.md#op_lt_eq)|Tests if the deque object on the left side of the operator is less than or equal to the deque object on the right side.| |[operator==](../standard-library/deque-operators.md#op_eq_eq)|Tests if the deque object on the left side of the operator is equal to the deque object on the right side.| |[operator>](../standard-library/deque-operators.md#op_gt)|Tests if the deque object on the left side of the operator is greater than the deque object on the right side.| |[operator>=](../standard-library/deque-operators.md#op_gt_eq)|Tests if the deque object on the left side of the operator is greater than or equal to the deque object on the right side.| diff --git a/docs/standard-library/forward-list.md b/docs/standard-library/forward-list.md index c7400192b6a..861fd7f512c 100644 --- a/docs/standard-library/forward-list.md +++ b/docs/standard-library/forward-list.md @@ -30,7 +30,7 @@ Defines the container class template forward_list and several supporting templat |[operator<](../standard-library/forward-list-operators.md#op_lt)|Tests if the forward list object on the left side of the operator is less than the forward list object on the right side.| |[operator<=](../standard-library/forward-list-operators.md#op_lt_eq)|Tests if the forward list object on the left side of the operator is less than or equal to the forward list object on the right side.| |[operator>](../standard-library/forward-list-operators.md#op_gt)|Tests if the forward list object on the left side of the operator is greater than the forward list object on the right side.| -|[operator>=](../standard-library/forward-list-operators.md#op_lt_eq)|Tests if the forward list object on the left side of the operator is greater than or equal to the forward list object on the right side.| +|[operator>=](../standard-library/forward-list-operators.md#op_gt_eq)|Tests if the forward list object on the left side of the operator is greater than or equal to the forward list object on the right side.| ### Functions diff --git a/docs/standard-library/iterator.md b/docs/standard-library/iterator.md index 4c87768cbf0..f5ac9540c1b 100644 --- a/docs/standard-library/iterator.md +++ b/docs/standard-library/iterator.md @@ -58,7 +58,7 @@ Visual Studio has added extensions to C++ Standard Library iterators to support |[`operator!=`](../standard-library/iterator-operators.md#op_neq)|Tests if the iterator object on the left side of the operator isn't equal to the iterator object on the right side.| |[`operator==`](../standard-library/iterator-operators.md#op_eq_eq)|Tests if the iterator object on the left side of the operator is equal to the iterator object on the right side.| |[`operator<`](../standard-library/iterator-operators.md#op_lt)|Tests if the iterator object on the left side of the operator is less than the iterator object on the right side.| -|[`operator<=`](../standard-library/iterator-operators.md#op_gt_eq)|Tests if the iterator object on the left side of the operator is less than or equal to the iterator object on the right side.| +|[`operator<=`](../standard-library/iterator-operators.md#op_lt_eq)|Tests if the iterator object on the left side of the operator is less than or equal to the iterator object on the right side.| |[`operator>`](../standard-library/iterator-operators.md#op_gt)|Tests if the iterator object on the left side of the operator is greater than the iterator object on the right side.| |[`operator>=`](../standard-library/iterator-operators.md#op_gt_eq)|Tests if the iterator object on the left side of the operator is greater than or equal to the iterator object on the right side.| |[`operator+`](../standard-library/iterator-operators.md#op_add)|Adds an offset to an iterator and returns the new `reverse_iterator` addressing the inserted element at the new offset position.| diff --git a/docs/standard-library/list.md b/docs/standard-library/list.md index 389e03c2301..14baffd00a2 100644 --- a/docs/standard-library/list.md +++ b/docs/standard-library/list.md @@ -27,7 +27,7 @@ Defines the container class template list and several supporting templates. |-|-| |[operator!=](../standard-library/list-operators.md#op_neq)|Tests if the list object on the left side of the operator is not equal to the list object on the right side.| |[operator<](../standard-library/list-operators.md#op_lt)|Tests if the list object on the left side of the operator is less than the list object on the right side.| -|[operator\<=](../standard-library/list-operators.md#op_gt_eq)|Tests if the list object on the left side of the operator is less than or equal to the list object on the right side.| +|[operator\<=](../standard-library/list-operators.md#op_lt_eq)|Tests if the list object on the left side of the operator is less than or equal to the list object on the right side.| |[operator==](../standard-library/list-operators.md#op_eq_eq)|Tests if the list object on the left side of the operator is equal to the list object on the right side.| |[operator>](../standard-library/list-operators.md#op_gt)|Tests if the list object on the left side of the operator is greater than the list object on the right side.| |[operator>=](../standard-library/list-operators.md#op_gt_eq)|Tests if the list object on the left side of the operator is greater than or equal to the list object on the right side.| diff --git a/docs/standard-library/memory.md b/docs/standard-library/memory.md index 336706d3f92..9395bda7406 100644 --- a/docs/standard-library/memory.md +++ b/docs/standard-library/memory.md @@ -74,7 +74,7 @@ Defines a class, an operator, and several templates that help allocate and free |[operator==](../standard-library/memory-operators.md#op_eq_eq)|Tests for equality between allocator objects of a specified class.| |[operator>=](../standard-library/memory-operators.md#op_gt_eq)|Tests for one allocator object being greater than or equal to a second allocator object, of a specified class.| |[operator<](../standard-library/memory-operators.md#op_lt)|Tests for one object being less than a second object of a specified class.| -|[operator\<=](../standard-library/memory-operators.md#op_gt_eq)|Tests for one object being less than or equal to a second object of a specified class.| +|[operator\<=](../standard-library/memory-operators.md#op_lt_eq)|Tests for one object being less than or equal to a second object of a specified class.| |[operator>](../standard-library/memory-operators.md#op_gt)|Tests for one object being greater than a second object of a specified class.| |[operator<<](../standard-library/memory-operators.md#op_lt_lt)|`shared_ptr` inserter.| diff --git a/docs/standard-library/optional.md b/docs/standard-library/optional.md index 776d8b5da68..0bfa38327bc 100644 --- a/docs/standard-library/optional.md +++ b/docs/standard-library/optional.md @@ -26,7 +26,7 @@ Defines the container class template `optional` and several supporting templates |[operator<](../standard-library/optional-operators.md#op_lt)|Tests if the object on the left is less than the object on the right.| |[operator<=](../standard-library/optional-operators.md#op_lt_eq)|Tests if the object on the left is less than or equal to the object on the right.| |[operator>](../standard-library/optional-operators.md#op_gt)|Tests if the object on the left is greater than the object on the right.| -|[operator>=](../standard-library/optional-operators.md#op_lt_eq)|Tests if the object on the left is greater than or equal to the object on the right.| +|[operator>=](../standard-library/optional-operators.md#op_gt_eq)|Tests if the object on the left is greater than or equal to the object on the right.| > [!NOTE] > In addition to relational compares, \ operators also support comparison with **nullopt** and `T`. diff --git a/docs/standard-library/queue.md b/docs/standard-library/queue.md index cd1709709b5..f6b35149a9c 100644 --- a/docs/standard-library/queue.md +++ b/docs/standard-library/queue.md @@ -27,7 +27,7 @@ Defines the class templates priority_queue and queue and several supporting temp |-|-| |[operator!=](../standard-library/queue-operators.md#op_neq)|Tests if the queue object on the left side of the operator is not equal to the queue object on the right side.| |[operator<](../standard-library/queue-operators.md#op_lt)|Tests if the queue object on the left side of the operator is less than the queue object on the right side.| -|[operator\<=](../standard-library/queue-operators.md#op_gt_eq)|Tests if the queue object on the left side of the operator is less than or equal to the queue object on the right side.| +|[operator\<=](../standard-library/queue-operators.md#op_lt_eq)|Tests if the queue object on the left side of the operator is less than or equal to the queue object on the right side.| |[operator==](../standard-library/queue-operators.md#op_eq_eq)|Tests if the queue object on the left side of the operator is equal to the queue object on the right side.| |[operator>](../standard-library/queue-operators.md#op_gt)|Tests if the queue object on the left side of the operator is greater than the queue object on the right side.| |[operator>=](../standard-library/queue-operators.md#op_gt_eq)|Tests if the queue object on the left side of the operator is greater than or equal to the queue object on the right side.| diff --git a/docs/standard-library/regex.md b/docs/standard-library/regex.md index afa6499a175..7a11ed48c83 100644 --- a/docs/standard-library/regex.md +++ b/docs/standard-library/regex.md @@ -81,7 +81,7 @@ To modify the details of the grammar of regular expressions, write a class that |[`operator==`](../standard-library/regex-operators.md#op_eq_eq)|Comparison of various objects, equal.| |[`operator!=`](../standard-library/regex-operators.md#op_neq)|Comparison of various objects, not equal.| |[`operator<`](../standard-library/regex-operators.md#op_lt)|Comparison of various objects, less than.| -|[`operator<=`](../standard-library/regex-operators.md#op_gt_eq)|Comparison of various objects, less than or equal.| +|[`operator<=`](../standard-library/regex-operators.md#op_lt_eq)|Comparison of various objects, less than or equal.| |[`operator>`](../standard-library/regex-operators.md#op_gt)|Comparison of various objects, greater than.| |[`operator>=`](../standard-library/regex-operators.md#op_gt_eq)|Comparison of various objects, greater than or equal.| |[`operator<<`](../standard-library/regex-operators.md#op_lt_lt)|Inserts a `sub_match` in a stream.| diff --git a/docs/standard-library/utility.md b/docs/standard-library/utility.md index 266e9840994..e5a97610778 100644 --- a/docs/standard-library/utility.md +++ b/docs/standard-library/utility.md @@ -61,7 +61,7 @@ Pairs are widely used in the C++ Standard Library. They're required both as the |[`operator!=`](../standard-library/utility-operators.md#op_neq)|Tests if the pair object on the left side of the operator isn't equal to the pair object on the right side.| |[`operator==`](../standard-library/utility-operators.md#op_eq_eq)|Tests if the pair object on the left side of the operator is equal to the pair object on the right side.| |[`operator<`](../standard-library/utility-operators.md#op_lt)|Tests if the pair object on the left side of the operator is less than the pair object on the right side.| -|[`operator<=`](../standard-library/utility-operators.md#op_gt_eq)|Tests if the pair object on the left side of the operator is less than or equal to the pair object on the right side.| +|[`operator<=`](../standard-library/utility-operators.md#op_lt_eq)|Tests if the pair object on the left side of the operator is less than or equal to the pair object on the right side.| |[`operator>`](../standard-library/utility-operators.md#op_gt)|Tests if the pair object on the left side of the operator is greater than the pair object on the right side.| |[`operator>=`](../standard-library/utility-operators.md#op_gt_eq)|Tests if the pair object on the left side of the operator is greater than or equal to the pair object on the right side.| diff --git a/docs/standard-library/variant.md b/docs/standard-library/variant.md index 9be7549e0ec..be23f0f5b0d 100644 --- a/docs/standard-library/variant.md +++ b/docs/standard-library/variant.md @@ -26,7 +26,7 @@ A variant object holds and manages a value. If the variant holds a value, that v |[operator<](../standard-library/forward-list-operators.md#op_lt)|Tests if the variant object on the left side of the operator is less than the variant object on the right side.| |[operator<=](../standard-library/forward-list-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is less than or equal to the variant object on the right side.| |[operator>](../standard-library/forward-list-operators.md#op_gt)|Tests if the variant object on the left side of the operator is greater than the variant object on the right side.| -|[operator>=](../standard-library/forward-list-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| +|[operator>=](../standard-library/forward-list-operators.md#op_gt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| ### Functions diff --git a/docs/standard-library/vector.md b/docs/standard-library/vector.md index f9dd7af32e4..22ea3970ae5 100644 --- a/docs/standard-library/vector.md +++ b/docs/standard-library/vector.md @@ -89,7 +89,7 @@ The second (right) vector in a compare operation. |-|-| |[`operator! =`](../standard-library/vector-operators.md#op_neq)|Tests if the `vector` object on the left side of the operator isn't equal to the `vector` object on the right side.| |[`operator<`](../standard-library/vector-operators.md#op_lt)|Tests if the `vector` object on the left side of the operator is less than the `vector` object on the right side.| -|[`operator<=`](../standard-library/vector-operators.md#op_gt_eq)|Tests if the `vector` object on the left side of the operator is less than or equal to the `vector` object on the right side.| +|[`operator<=`](../standard-library/vector-operators.md#op_lt_eq)|Tests if the `vector` object on the left side of the operator is less than or equal to the `vector` object on the right side.| |[`operator==`](../standard-library/vector-operators.md#op_eq_eq)|Tests if the `vector` object on the left side of the operator is equal to the `vector` object on the right side.| |[`operator>`](../standard-library/vector-operators.md#op_gt)|Tests if the `vector` object on the left side of the operator is greater than the `vector` object on the right side.| |[`operator>=`](../standard-library/vector-operators.md#op_gt_eq)|Tests if the `vector` object on the left side of the operator is greater than or equal to the `vector` object on the right side.| From a24ed92bf9833ec9af347273f8be654b7101fab6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 24 Jul 2025 21:26:42 +0800 Subject: [PATCH 0508/1799] Update metadata in 11 topics --- .../mfc/windows-sockets-example-of-sockets-using-archives.md | 5 ++--- docs/parallel/concrt/reference/concurrency-namespace.md | 5 ++--- docs/standard-library/deque.md | 5 ++--- docs/standard-library/forward-list.md | 5 ++--- docs/standard-library/list.md | 5 ++--- docs/standard-library/memory.md | 4 ++-- docs/standard-library/optional.md | 4 ++-- docs/standard-library/queue.md | 5 ++--- docs/standard-library/utility.md | 2 +- docs/standard-library/variant.md | 4 ++-- docs/standard-library/vector.md | 4 ++-- 11 files changed, 21 insertions(+), 27 deletions(-) diff --git a/docs/mfc/windows-sockets-example-of-sockets-using-archives.md b/docs/mfc/windows-sockets-example-of-sockets-using-archives.md index c97e8c3d0ca..89e332528ba 100644 --- a/docs/mfc/windows-sockets-example-of-sockets-using-archives.md +++ b/docs/mfc/windows-sockets-example-of-sockets-using-archives.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Windows Sockets: Example of Sockets Using Archives" title: "Windows Sockets: Example of Sockets Using Archives" -ms.date: "11/04/2016" +description: "Learn more about: Windows Sockets: Example of Sockets Using Archives" +ms.date: 11/04/2016 helpviewer_keywords: ["sockets [MFC], with archives", "examples [MFC], Windows Sockets", "Windows Sockets [MFC], with archives"] -ms.assetid: 2e3c9bb2-7e7b-4f28-8dc5-6cb7a484edac --- # Windows Sockets: Example of Sockets Using Archives diff --git a/docs/parallel/concrt/reference/concurrency-namespace.md b/docs/parallel/concrt/reference/concurrency-namespace.md index 4f5a100c3aa..db453f19ce6 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace.md +++ b/docs/parallel/concrt/reference/concurrency-namespace.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: concurrency Namespace" title: "concurrency Namespace" -ms.date: "11/04/2016" +description: "Learn more about: concurrency Namespace" +ms.date: 11/04/2016 f1_keywords: ["concurrent_priority_queue/concurrency", "agents/concurrency", "concurrent_vector/concurrency", "concrt/concurrency", "internal_split_ordered_list/concurrency", "concurrent_queue/concurrency", "pplcancellation_token/concurrency", "pplinterface/concurrency", "ppltasks/concurrency", "ppl/concurrency", "concurrent_unordered_map/concurrency", "concrtrm/concurrency", "concurrent_unordered_set/concurrency", "pplconcrt/concurrency", "internal_concurrent_hash/concurrency"] helpviewer_keywords: ["Concurrency namespace"] -ms.assetid: f1d33ca2-679b-4442-b140-22a9d9df61d1 --- # concurrency Namespace diff --git a/docs/standard-library/deque.md b/docs/standard-library/deque.md index 2f728d94aee..30e85cc0034 100644 --- a/docs/standard-library/deque.md +++ b/docs/standard-library/deque.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["deque header"] -ms.assetid: 4521fe92-5a91-4853-9e9f-59600bf9e46f --- # `` diff --git a/docs/standard-library/forward-list.md b/docs/standard-library/forward-list.md index 861fd7f512c..3a614d21840 100644 --- a/docs/standard-library/forward-list.md +++ b/docs/standard-library/forward-list.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: [""] -ms.assetid: 8b4ab09e-1475-434a-b4e0-fdbc07a08b5b --- # `` diff --git a/docs/standard-library/list.md b/docs/standard-library/list.md index 14baffd00a2..6d8ef3944f2 100644 --- a/docs/standard-library/list.md +++ b/docs/standard-library/list.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["list header"] -ms.assetid: 2345823b-5612-44d8-95d3-aa96ed076d17 --- # `` diff --git a/docs/standard-library/memory.md b/docs/standard-library/memory.md index 9395bda7406..5e3a65200e2 100644 --- a/docs/standard-library/memory.md +++ b/docs/standard-library/memory.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "08/04/2019" +description: "Learn more about: " +ms.date: 08/04/2019 f1_keywords: [""] helpviewer_keywords: ["memory header"] --- diff --git a/docs/standard-library/optional.md b/docs/standard-library/optional.md index 0bfa38327bc..5a632e0931e 100644 --- a/docs/standard-library/optional.md +++ b/docs/standard-library/optional.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "08/06/2019" +description: "Learn more about: " +ms.date: 08/06/2019 f1_keywords: [""] helpviewer_keywords: [""] --- diff --git a/docs/standard-library/queue.md b/docs/standard-library/queue.md index f6b35149a9c..f580355a8eb 100644 --- a/docs/standard-library/queue.md +++ b/docs/standard-library/queue.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["queue header"] -ms.assetid: 24fcf350-eb0e-48cf-9fef-978be1aeda1f --- # `` diff --git a/docs/standard-library/utility.md b/docs/standard-library/utility.md index e5a97610778..c522bcbcd3f 100644 --- a/docs/standard-library/utility.md +++ b/docs/standard-library/utility.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: " title: "" +description: "Learn more about: " ms.date: 11/14/2024 f1_keywords: [""] helpviewer_keywords: ["utility header"] diff --git a/docs/standard-library/variant.md b/docs/standard-library/variant.md index be23f0f5b0d..a61bd4e8bba 100644 --- a/docs/standard-library/variant.md +++ b/docs/standard-library/variant.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "04/04/2019" +description: "Learn more about: " +ms.date: 04/04/2019 f1_keywords: [""] helpviewer_keywords: [""] --- diff --git a/docs/standard-library/vector.md b/docs/standard-library/vector.md index 22ea3970ae5..ab97e690485 100644 --- a/docs/standard-library/vector.md +++ b/docs/standard-library/vector.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["vector header"] --- From 6a31d5fa2e57e7c509df1793d31653a87377758f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 24 Jul 2025 21:43:31 +0800 Subject: [PATCH 0509/1799] Add blockquotes for error messages in range [C2351, C2380] --- docs/error-messages/compiler-errors-1/compiler-error-c2351.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2352.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2353.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2355.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2356.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2357.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2360.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2361.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2364.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2365.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2368.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2369.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2370.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2371.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2373.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2374.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2375.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2376.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2377.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2378.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2379.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2380.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md index cb65e6f46a4..53d8a32c82a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md @@ -8,7 +8,7 @@ ms.assetid: 5439ccf6-66f6-4859-964c-c73f5eddfc1b --- # Compiler Error C2351 -obsolete C++ constructor initialization syntax +> obsolete C++ constructor initialization syntax In a new-style initialization list for a constructor, you must explicitly name each direct base class, even if it is the only base class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md index 54c319840ee..8555ab77211 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md @@ -8,7 +8,7 @@ ms.assetid: 0efad8cb-659f-4b3e-8f6f-9f8ec44d345c --- # Compiler Error C2352 -'class::function' : illegal call of non-static member function +> 'class::function' : illegal call of non-static member function A **`static`** member function called a nonstatic member function. Or, a nonstatic member function was called from outside the class as a static function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md index bbf3f1fdc64..440d050e101 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md @@ -8,7 +8,7 @@ ms.assetid: d57f8f77-d9b1-4bba-a940-87ec269ad183 --- # Compiler Error C2353 -exception specification is not allowed +> exception specification is not allowed Exception specifications are not allowed on member functions of managed classes. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md index 3c2ec1586f3..5894b4c81f8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md @@ -8,7 +8,7 @@ ms.assetid: 0a947881-d61f-4f98-8409-32140f39500b --- # Compiler Error C2355 -'this' : can only be referenced inside non-static member functions or non-static data member initializers +> 'this' : can only be referenced inside non-static member functions or non-static data member initializers The **`this`** pointer is valid only within non-static member functions or in non-static data member initializers. This error can result when the class scope of a member function definition outside of the class declaration is not properly qualified. The error can also occur when the **`this`** pointer is used in a function that is not declared in the class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md index 6049b17292d..bde9f2e8084 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md @@ -8,7 +8,7 @@ ms.assetid: 84d5a816-9a61-4d45-9978-38e485bbf767 --- # Compiler Error C2356 -initialization segment must not change during translation unit +> initialization segment must not change during translation unit Possible causes: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md index 0b06b9383d1..1e5f33ad68a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md @@ -8,7 +8,7 @@ ms.assetid: d1083945-0ea2-4385-9e66-8c665978806c --- # Compiler Error C2357 -'identifier' : must be a function of type 'type' +> 'identifier' : must be a function of type 'type' Your code declares a version of the `atexit` function that does not match the version declared internally by the compiler. Declare `atexit` as follows: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md index 3fc5204e7bb..c98c6196064 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md @@ -8,7 +8,7 @@ ms.assetid: 51bfd2ee-8108-4777-aa93-148b9cebfa83 --- # Compiler Error C2360 -initialization of 'identifier' is skipped by 'case' label +> initialization of 'identifier' is skipped by 'case' label The initialization of `identifier` can be skipped in a **`switch`** statement. You cannot jump past a declaration with an initializer unless the declaration is enclosed in a block. (Unless it is declared within a block, the variable is within scope until the end of the **`switch`** statement.) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md index 6a7962c2d68..4616bbf3a7f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md @@ -8,7 +8,7 @@ ms.assetid: efbdaeb9-891c-4f7d-97da-89088a8413f3 --- # Compiler Error C2361 -initialization of 'identifier' is skipped by 'default' label +> initialization of 'identifier' is skipped by 'default' label The initialization of `identifier` can be skipped in a **`switch`** statement. You cannot jump past a declaration with an initializer unless the declaration is enclosed in a block. (Unless it is declared within a block, the variable is within scope until the end of the **`switch`** statement.) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md index 38050c2e713..28bc3622e61 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md @@ -8,7 +8,7 @@ ms.assetid: 4f550571-94b5-42ca-84cb-663fecbead44 --- # Compiler Error C2364 -'type': illegal type for custom attribute +> 'type': illegal type for custom attribute Named arguments for custom attributes are limited to compile time constants. For example, integral types (int, char, etc.), System::Type^, and System::Object^. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md index 11c859cbdd7..93f2a55b649 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md @@ -8,7 +8,7 @@ ms.assetid: 35839b0b-4055-4b79-8957-b3a0871bdd02 --- # Compiler Error C2365 -'class member' : redefinition; previous definition was 'class member' +> 'class member' : redefinition; previous definition was 'class member' You attempted to redefine a class member. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2368.md b/docs/error-messages/compiler-errors-1/compiler-error-c2368.md index a2f6d269f02..e00ecc4eb64 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2368.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2368.md @@ -8,6 +8,6 @@ ms.assetid: a824626f-9fb5-453b-a3a4-da89d1e32218 --- # Compiler Error C2368 -'identifier' : redefinition; different allocation specifiers +> 'identifier' : redefinition; different allocation specifiers The declaration and definition of the symbol specify different **`__declspec`** attributes. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md index aab5f981a69..10120110664 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md @@ -8,7 +8,7 @@ ms.assetid: 2a3933f6-2313-40ff-800f-921b296fdbbf --- # Compiler Error C2369 -'array' : redefinition; different subscripts +> 'array' : redefinition; different subscripts The array is already declared with a different subscript. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md index 644e2724e52..a930d5abe00 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md @@ -8,7 +8,7 @@ ms.assetid: 03403e8f-f393-47c4-bd25-5c1c7ea7d5cd --- # Compiler Error C2370 -'identifier' : redefinition; different storage class +> 'identifier' : redefinition; different storage class The identifier is already declared with a different storage class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md index 3574efe5302..ce5d14e7ea4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md @@ -8,7 +8,7 @@ ms.assetid: d383993d-05ef-4e35-8129-3b58a6f7b7b7 --- # Compiler Error C2371 -'identifier' : redefinition; different basic types +> 'identifier' : redefinition; different basic types The identifier is already declared. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md index 2122dfb2982..d2431959e79 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md @@ -8,7 +8,7 @@ ms.assetid: 7a08bf0b-852d-48be-ba75-70df9f4b5951 --- # Compiler Error C2373 -'identifier' : redefinition; different type modifiers +> 'identifier' : redefinition; different type modifiers The identifier is already defined with a different type modifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md index 6d1b49420da..3a9af4deac6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md @@ -8,7 +8,7 @@ ms.assetid: 73b51965-e91c-4e21-9732-f71c1449d22e --- # Compiler Error C2374 -'identifier' : redefinition; multiple initialization +> 'identifier' : redefinition; multiple initialization The identifier is initialized more than once. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md index 2a7da09bf72..0cdd54228b4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md @@ -8,7 +8,7 @@ ms.assetid: 193c5e8b-1b20-4928-8a02-8c1cddaf2a26 --- # Compiler Error C2375 -'function' : redefinition; different linkage +> 'function' : redefinition; different linkage The function is already declared with a different linkage specifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2376.md b/docs/error-messages/compiler-errors-1/compiler-error-c2376.md index 6e089703c80..93f181caf41 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2376.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2376.md @@ -8,6 +8,6 @@ ms.assetid: 89423cf7-a24a-4bb3-a2ed-36a1ff8ba458 --- # Compiler Error C2376 -'function' : redefinition; different based allocation +> 'function' : redefinition; different based allocation The function is already declared with a different based allocation. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md index 409d365c347..85cbae8339d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md @@ -8,7 +8,7 @@ ms.assetid: f7660965-bf4c-4cd9-8307-1bd7016678a1 --- # Compiler Error C2377 -'identifier' : redefinition; typedef cannot be overloaded with any other symbol +> 'identifier' : redefinition; typedef cannot be overloaded with any other symbol A **`typedef`** identifier is redefined. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md index a42b65d5c7c..9226040c84b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md @@ -8,7 +8,7 @@ ms.assetid: 507a91c6-ca72-48df-b3a4-2cf931c86806 --- # Compiler Error C2378 -'identifier' : redefinition; symbol cannot be overloaded with a typedef +> 'identifier' : redefinition; symbol cannot be overloaded with a typedef The identifier was redefined as a **`typedef`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md index f10e6b2a952..62cdbf47ba5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md @@ -8,7 +8,7 @@ ms.assetid: 37dc3015-a4af-4341-bbf3-da6150df7e51 --- # Compiler Error C2379 -formal parameter number has different type when promoted +> formal parameter number has different type when promoted The type of the specified parameter is not compatible, through default promotions, with the type in a previous declaration. This is an error in ANSI C ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) and a warning with Microsoft extensions (**/Ze**). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md index 4e2bdc50260..10172591efb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md @@ -8,7 +8,7 @@ ms.assetid: 717b1e6e-ddfe-4bac-a5f3-7f9a4dcb1572 --- # Compiler Error C2380 -type(s) preceding 'identifier' (constructor with return type, or illegal redefinition of current class-name?) +> type(s) preceding 'identifier' (constructor with return type, or illegal redefinition of current class-name?) A constructor returns a value or redefines the class name. From bc4469d944066c054e6cd304447304e3da396c5a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 24 Jul 2025 21:49:58 +0800 Subject: [PATCH 0510/1799] Add "Remarks" and "Example" headings for error references in range [C2351, C2380] --- docs/error-messages/compiler-errors-1/compiler-error-c2351.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2352.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2353.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2355.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2356.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2357.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2360.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2361.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2362.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2364.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2365.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2368.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2369.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2370.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2371.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2372.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2373.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2374.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2375.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2376.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2377.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2378.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2379.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2380.md | 4 ++++ 24 files changed, 88 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md index 53d8a32c82a..29beaf3237d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md @@ -10,8 +10,12 @@ ms.assetid: 5439ccf6-66f6-4859-964c-c73f5eddfc1b > obsolete C++ constructor initialization syntax +## Remarks + In a new-style initialization list for a constructor, you must explicitly name each direct base class, even if it is the only base class. +## Example + The following sample generates C2351: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md index 8555ab77211..82bdbca4fd6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md @@ -10,8 +10,12 @@ ms.assetid: 0efad8cb-659f-4b3e-8f6f-9f8ec44d345c > 'class::function' : illegal call of non-static member function +## Remarks + A **`static`** member function called a nonstatic member function. Or, a nonstatic member function was called from outside the class as a static function. +## Examples + The following sample generates C2352 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md index 440d050e101..7ccfc49ac61 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md @@ -10,8 +10,12 @@ ms.assetid: d57f8f77-d9b1-4bba-a940-87ec269ad183 > exception specification is not allowed +## Remarks + Exception specifications are not allowed on member functions of managed classes. +## Example + The following sample generates C2353: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md index 5894b4c81f8..93e97299223 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md @@ -10,10 +10,14 @@ ms.assetid: 0a947881-d61f-4f98-8409-32140f39500b > 'this' : can only be referenced inside non-static member functions or non-static data member initializers +## Remarks + The **`this`** pointer is valid only within non-static member functions or in non-static data member initializers. This error can result when the class scope of a member function definition outside of the class declaration is not properly qualified. The error can also occur when the **`this`** pointer is used in a function that is not declared in the class. To fix this issue, make sure the member function definition matches a member function declaration in the class, and that it is not declared static. For data member initializers, make sure the data member is not declared static. +## Example + The following sample generates C2355 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md index bde9f2e8084..31123a04c56 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md @@ -10,6 +10,8 @@ ms.assetid: 84d5a816-9a61-4d45-9978-38e485bbf767 > initialization segment must not change during translation unit +## Remarks + Possible causes: - `#pragma init_seg` preceded by segment initialization code @@ -18,6 +20,8 @@ Possible causes: To resolve, move the segment initialization code to the beginning of the module. If multiple areas must be initialized, move them to separate modules. +## Example + The following sample generates C2356: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md index 1e5f33ad68a..c4e4729b9a7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md @@ -10,6 +10,8 @@ ms.assetid: d1083945-0ea2-4385-9e66-8c665978806c > 'identifier' : must be a function of type 'type' +## Remarks + Your code declares a version of the `atexit` function that does not match the version declared internally by the compiler. Declare `atexit` as follows: ``` @@ -18,6 +20,8 @@ int __cdecl atexit(void (__cdecl *)()); For more information, see [init_seg](../../preprocessor/init-seg.md). +## Example + The following sample generates C2357: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md index c98c6196064..31fae0653cf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md @@ -10,8 +10,12 @@ ms.assetid: 51bfd2ee-8108-4777-aa93-148b9cebfa83 > initialization of 'identifier' is skipped by 'case' label +## Remarks + The initialization of `identifier` can be skipped in a **`switch`** statement. You cannot jump past a declaration with an initializer unless the declaration is enclosed in a block. (Unless it is declared within a block, the variable is within scope until the end of the **`switch`** statement.) +## Example + The following sample generates C2360: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md index 4616bbf3a7f..c6ae25f0456 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md @@ -10,8 +10,12 @@ ms.assetid: efbdaeb9-891c-4f7d-97da-89088a8413f3 > initialization of 'identifier' is skipped by 'default' label +## Remarks + The initialization of `identifier` can be skipped in a **`switch`** statement. You cannot jump past a declaration with an initializer unless the declaration is enclosed in a block. (Unless it is declared within a block, the variable is within scope until the end of the **`switch`** statement.) +## Example + The following sample generates C2361: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2362.md b/docs/error-messages/compiler-errors-1/compiler-error-c2362.md index ee78fcd6f02..aecd8e1244b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2362.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2362.md @@ -10,10 +10,14 @@ ms.assetid: 7aafecbc-b3cf-45a6-9ec3-a17e3f222511 > initialization of '*identifier*' is skipped by 'goto *label*' +## Remarks + When compiled by using [/Za](../../build/reference/za-ze-disable-language-extensions.md), a jump to the label prevents the identifier from being initialized. You can only jump past a declaration with an initializer if the declaration is enclosed in a block that isn't entered, or if the variable has already been initialized. +## Example + The following sample generates C2362: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md index 28bc3622e61..f4270cb4571 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md @@ -10,6 +10,8 @@ ms.assetid: 4f550571-94b5-42ca-84cb-663fecbead44 > 'type': illegal type for custom attribute +## Remarks + Named arguments for custom attributes are limited to compile time constants. For example, integral types (int, char, etc.), System::Type^, and System::Object^. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md index 93f2a55b649..d8499b3d0e2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md @@ -10,8 +10,12 @@ ms.assetid: 35839b0b-4055-4b79-8957-b3a0871bdd02 > 'class member' : redefinition; previous definition was 'class member' +## Remarks + You attempted to redefine a class member. +## Example + The following sample generates C2365. ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2368.md b/docs/error-messages/compiler-errors-1/compiler-error-c2368.md index e00ecc4eb64..99cd2a22e23 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2368.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2368.md @@ -10,4 +10,6 @@ ms.assetid: a824626f-9fb5-453b-a3a4-da89d1e32218 > 'identifier' : redefinition; different allocation specifiers +## Remarks + The declaration and definition of the symbol specify different **`__declspec`** attributes. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md index 10120110664..1fdecdee48c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md @@ -10,8 +10,12 @@ ms.assetid: 2a3933f6-2313-40ff-800f-921b296fdbbf > 'array' : redefinition; different subscripts +## Remarks + The array is already declared with a different subscript. +## Example + The following sample generates C2369: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md index a930d5abe00..6af1197b3a1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md @@ -10,6 +10,8 @@ ms.assetid: 03403e8f-f393-47c4-bd25-5c1c7ea7d5cd > 'identifier' : redefinition; different storage class +## Remarks + The identifier is already declared with a different storage class. ## Examples diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md index ce5d14e7ea4..055c838c8ef 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md @@ -10,8 +10,12 @@ ms.assetid: d383993d-05ef-4e35-8129-3b58a6f7b7b7 > 'identifier' : redefinition; different basic types +## Remarks + The identifier is already declared. +## Example + The following sample generates C2371: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2372.md b/docs/error-messages/compiler-errors-1/compiler-error-c2372.md index eac3e935a76..cffae957d4a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2372.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2372.md @@ -10,8 +10,12 @@ ms.assetid: 406bea63-c8d3-4231-9d26-c70af6980840 > '*identifier*' : redefinition; different types of indirection +## Remarks + The identifier is already defined with a different derived type. +## Example + The following sample generates C2372: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md index d2431959e79..4706c55ff6a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md @@ -10,8 +10,12 @@ ms.assetid: 7a08bf0b-852d-48be-ba75-70df9f4b5951 > 'identifier' : redefinition; different type modifiers +## Remarks + The identifier is already defined with a different type modifier. +## Example + The following sample generates C2373: ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md index 3a9af4deac6..eb0d6215154 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md @@ -10,8 +10,12 @@ ms.assetid: 73b51965-e91c-4e21-9732-f71c1449d22e > 'identifier' : redefinition; multiple initialization +## Remarks + The identifier is initialized more than once. +## Example + The following sample generates C2374: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md index 0cdd54228b4..6ff13253e29 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md @@ -10,8 +10,12 @@ ms.assetid: 193c5e8b-1b20-4928-8a02-8c1cddaf2a26 > 'function' : redefinition; different linkage +## Remarks + The function is already declared with a different linkage specifier. +## Example + The following sample generates C2375: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2376.md b/docs/error-messages/compiler-errors-1/compiler-error-c2376.md index 93f181caf41..813e57c5179 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2376.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2376.md @@ -10,4 +10,6 @@ ms.assetid: 89423cf7-a24a-4bb3-a2ed-36a1ff8ba458 > 'function' : redefinition; different based allocation +## Remarks + The function is already declared with a different based allocation. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md index 85cbae8339d..09a39aa48ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md @@ -10,8 +10,12 @@ ms.assetid: f7660965-bf4c-4cd9-8307-1bd7016678a1 > 'identifier' : redefinition; typedef cannot be overloaded with any other symbol +## Remarks + A **`typedef`** identifier is redefined. +## Example + The following sample generates C2377: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md index 9226040c84b..731f61d68b8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md @@ -10,8 +10,12 @@ ms.assetid: 507a91c6-ca72-48df-b3a4-2cf931c86806 > 'identifier' : redefinition; symbol cannot be overloaded with a typedef +## Remarks + The identifier was redefined as a **`typedef`**. +## Example + The following sample generates C2378: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md index 62cdbf47ba5..54dfe67db20 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md @@ -10,8 +10,12 @@ ms.assetid: 37dc3015-a4af-4341-bbf3-da6150df7e51 > formal parameter number has different type when promoted +## Remarks + The type of the specified parameter is not compatible, through default promotions, with the type in a previous declaration. This is an error in ANSI C ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) and a warning with Microsoft extensions (**/Ze**). +## Example + The following sample generates C2379: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md index 10172591efb..4157aff583d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md @@ -10,8 +10,12 @@ ms.assetid: 717b1e6e-ddfe-4bac-a5f3-7f9a4dcb1572 > type(s) preceding 'identifier' (constructor with return type, or illegal redefinition of current class-name?) +## Remarks + A constructor returns a value or redefines the class name. +## Example + The following sample generates C2326: ```cpp From a902348f96645bc9f2282b0ead1db72f6c4494ec Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 24 Jul 2025 21:51:45 +0800 Subject: [PATCH 0511/1799] Replace term "sample" with "example" for error references in range [C2351, C2380] --- docs/error-messages/compiler-errors-1/compiler-error-c2351.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2352.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2353.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2355.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2356.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2357.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2360.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2361.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2362.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2364.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2365.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2369.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2370.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2371.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2372.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2373.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2374.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2375.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2377.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2378.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2379.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2380.md | 2 +- 22 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md index 29beaf3237d..68f942ce6de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md @@ -16,7 +16,7 @@ In a new-style initialization list for a constructor, you must explicitly name e ## Example -The following sample generates C2351: +The following example generates C2351: ```cpp // C2351.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md index 82bdbca4fd6..47c231b2d0d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md @@ -16,7 +16,7 @@ A **`static`** member function called a nonstatic member function. Or, a nonstat ## Examples -The following sample generates C2352 and shows how to fix it: +The following example generates C2352 and shows how to fix it: ```cpp // C2352.cpp @@ -32,7 +32,7 @@ public: }; ``` -The following sample generates C2352 and shows how to fix it: +The following example generates C2352 and shows how to fix it: ```cpp // C2352b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md index 7ccfc49ac61..47a577cab73 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md @@ -16,7 +16,7 @@ Exception specifications are not allowed on member functions of managed classes. ## Example -The following sample generates C2353: +The following example generates C2353: ```cpp // C2353.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md index 93e97299223..1e036063004 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md @@ -18,7 +18,7 @@ To fix this issue, make sure the member function definition matches a member fun ## Example -The following sample generates C2355 and shows how to fix it: +The following example generates C2355 and shows how to fix it: ```cpp // C2355.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md index 31123a04c56..926dd70ac69 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md @@ -22,7 +22,7 @@ To resolve, move the segment initialization code to the beginning of the module. ## Example -The following sample generates C2356: +The following example generates C2356: ```cpp // C2356.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md index c4e4729b9a7..b06b5817a9d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md @@ -22,7 +22,7 @@ For more information, see [init_seg](../../preprocessor/init-seg.md). ## Example -The following sample generates C2357: +The following example generates C2357: ```cpp // C2357.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md index 31fae0653cf..9809aa0e28a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md @@ -16,7 +16,7 @@ The initialization of `identifier` can be skipped in a **`switch`** statement. Y ## Example -The following sample generates C2360: +The following example generates C2360: ```cpp // C2360.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md index c6ae25f0456..3bccbed3a38 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md @@ -16,7 +16,7 @@ The initialization of `identifier` can be skipped in a **`switch`** statement. Y ## Example -The following sample generates C2361: +The following example generates C2361: ```cpp // C2361.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2362.md b/docs/error-messages/compiler-errors-1/compiler-error-c2362.md index aecd8e1244b..e3e4e7bf754 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2362.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2362.md @@ -18,7 +18,7 @@ You can only jump past a declaration with an initializer if the declaration is e ## Example -The following sample generates C2362: +The following example generates C2362: ```cpp // C2362.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md index f4270cb4571..7594f2d078a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md @@ -16,7 +16,7 @@ Named arguments for custom attributes are limited to compile time constants. For ## Example -The following sample generates C2364. +The following example generates C2364. ```cpp // c2364.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md index d8499b3d0e2..00662d6f4f7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md @@ -16,7 +16,7 @@ You attempted to redefine a class member. ## Example -The following sample generates C2365. +The following example generates C2365. ```cpp // C2365.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md index 1fdecdee48c..c7f96d0b538 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md @@ -16,7 +16,7 @@ The array is already declared with a different subscript. ## Example -The following sample generates C2369: +The following example generates C2369: ```cpp // C2369.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md index 6af1197b3a1..a47e12065d7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md @@ -16,7 +16,7 @@ The identifier is already declared with a different storage class. ## Examples -The following sample generates C2370: +The following example generates C2370: ```cpp // C2370.cpp @@ -26,7 +26,7 @@ static int i; // C2370 int i; // OK ``` -The following sample generates C2370: +The following example generates C2370: ```cpp // C2370b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md index 055c838c8ef..647339bc18c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md @@ -16,7 +16,7 @@ The identifier is already declared. ## Example -The following sample generates C2371: +The following example generates C2371: ```cpp // C2371.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2372.md b/docs/error-messages/compiler-errors-1/compiler-error-c2372.md index cffae957d4a..07f26c815cf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2372.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2372.md @@ -16,7 +16,7 @@ The identifier is already defined with a different derived type. ## Example -The following sample generates C2372: +The following example generates C2372: ```cpp // C2372.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md index 4706c55ff6a..f6f17a5fc37 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md @@ -16,7 +16,7 @@ The identifier is already defined with a different type modifier. ## Example -The following sample generates C2373: +The following example generates C2373: ``` // C2373.h diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md index eb0d6215154..85279b0d0fb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md @@ -16,7 +16,7 @@ The identifier is initialized more than once. ## Example -The following sample generates C2374: +The following example generates C2374: ```cpp // C2374.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md index 6ff13253e29..40257e1f855 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md @@ -16,7 +16,7 @@ The function is already declared with a different linkage specifier. ## Example -The following sample generates C2375: +The following example generates C2375: ```cpp // C2375.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md index 09a39aa48ac..83c17ec4b0e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md @@ -16,7 +16,7 @@ A **`typedef`** identifier is redefined. ## Example -The following sample generates C2377: +The following example generates C2377: ```cpp // C2377.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md index 731f61d68b8..7421d9eeebd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md @@ -16,7 +16,7 @@ The identifier was redefined as a **`typedef`**. ## Example -The following sample generates C2378: +The following example generates C2378: ```cpp // C2378.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md index 54dfe67db20..fbc5d991036 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md @@ -16,7 +16,7 @@ The type of the specified parameter is not compatible, through default promotion ## Example -The following sample generates C2379: +The following example generates C2379: ```c // C2379.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md index 4157aff583d..59bdc81ff27 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md @@ -16,7 +16,7 @@ A constructor returns a value or redefines the class name. ## Example -The following sample generates C2326: +The following example generates C2326: ```cpp // C2380.cpp From 6ff9386784a2581ca023fdb5d4168def692810eb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 24 Jul 2025 21:56:21 +0800 Subject: [PATCH 0512/1799] Update metadata for error references in range [C2351, C2380] --- .../error-messages/compiler-errors-1/compiler-error-c2351.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2352.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2353.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2355.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2356.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2357.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2360.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2361.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2362.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2364.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2365.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2368.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2369.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2370.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2371.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2372.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2373.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2374.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2375.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2376.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2377.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2378.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2379.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2380.md | 5 ++--- 24 files changed, 48 insertions(+), 72 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md index 68f942ce6de..a3f4108c1ca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2351" title: "Compiler Error C2351" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2351" +ms.date: 11/04/2016 f1_keywords: ["C2351"] helpviewer_keywords: ["C2351"] -ms.assetid: 5439ccf6-66f6-4859-964c-c73f5eddfc1b --- # Compiler Error C2351 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md index 47c231b2d0d..8a5af21eae8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2352" title: "Compiler Error C2352" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2352" +ms.date: 11/04/2016 f1_keywords: ["C2352"] helpviewer_keywords: ["C2352"] -ms.assetid: 0efad8cb-659f-4b3e-8f6f-9f8ec44d345c --- # Compiler Error C2352 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md index 47a577cab73..50668f8cfe2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2353" title: "Compiler Error C2353" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2353" +ms.date: 11/04/2016 f1_keywords: ["C2353"] helpviewer_keywords: ["C2353"] -ms.assetid: d57f8f77-d9b1-4bba-a940-87ec269ad183 --- # Compiler Error C2353 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md index 1e036063004..abde37c99c8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2355" title: "Compiler Error C2355" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2355" +ms.date: 11/04/2016 f1_keywords: ["C2355"] helpviewer_keywords: ["C2355"] -ms.assetid: 0a947881-d61f-4f98-8409-32140f39500b --- # Compiler Error C2355 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md index 926dd70ac69..3ee44ce9730 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2356" title: "Compiler Error C2356" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2356" +ms.date: 11/04/2016 f1_keywords: ["C2356"] helpviewer_keywords: ["C2356"] -ms.assetid: 84d5a816-9a61-4d45-9978-38e485bbf767 --- # Compiler Error C2356 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md index b06b5817a9d..67b2a2901ce 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2357" title: "Compiler Error C2357" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2357" +ms.date: 11/04/2016 f1_keywords: ["C2357"] helpviewer_keywords: ["C2357"] -ms.assetid: d1083945-0ea2-4385-9e66-8c665978806c --- # Compiler Error C2357 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md index 9809aa0e28a..58a393241ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2360" title: "Compiler Error C2360" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2360" +ms.date: 11/04/2016 f1_keywords: ["C2360"] helpviewer_keywords: ["C2360"] -ms.assetid: 51bfd2ee-8108-4777-aa93-148b9cebfa83 --- # Compiler Error C2360 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md index 3bccbed3a38..8c6743d7d40 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2361" title: "Compiler Error C2361" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2361" +ms.date: 11/04/2016 f1_keywords: ["C2361"] helpviewer_keywords: ["C2361"] -ms.assetid: efbdaeb9-891c-4f7d-97da-89088a8413f3 --- # Compiler Error C2361 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2362.md b/docs/error-messages/compiler-errors-1/compiler-error-c2362.md index e3e4e7bf754..5691441c218 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2362.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2362.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2362" title: "Compiler Error C2362" -ms.date: "06/03/2019" +description: "Learn more about: Compiler Error C2362" +ms.date: 06/03/2019 f1_keywords: ["C2362"] helpviewer_keywords: ["C2362"] -ms.assetid: 7aafecbc-b3cf-45a6-9ec3-a17e3f222511 --- # Compiler Error C2362 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md index 7594f2d078a..8eeabc0bef7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2364" title: "Compiler Error C2364" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2364" +ms.date: 11/04/2016 f1_keywords: ["C2364"] helpviewer_keywords: ["C2364"] -ms.assetid: 4f550571-94b5-42ca-84cb-663fecbead44 --- # Compiler Error C2364 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md index 00662d6f4f7..7fd276bfe74 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2365" title: "Compiler Error C2365" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2365" +ms.date: 11/04/2016 f1_keywords: ["C2365"] helpviewer_keywords: ["C2365"] -ms.assetid: 35839b0b-4055-4b79-8957-b3a0871bdd02 --- # Compiler Error C2365 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2368.md b/docs/error-messages/compiler-errors-1/compiler-error-c2368.md index 99cd2a22e23..7711b7ae2c4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2368.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2368.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2368" title: "Compiler Error C2368" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2368" +ms.date: 11/04/2016 f1_keywords: ["C2368"] helpviewer_keywords: ["C2368"] -ms.assetid: a824626f-9fb5-453b-a3a4-da89d1e32218 --- # Compiler Error C2368 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md index c7f96d0b538..27a97bd4866 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2369" title: "Compiler Error C2369" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2369" +ms.date: 11/04/2016 f1_keywords: ["C2369"] helpviewer_keywords: ["C2369"] -ms.assetid: 2a3933f6-2313-40ff-800f-921b296fdbbf --- # Compiler Error C2369 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md index a47e12065d7..256c331a639 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2370" title: "Compiler Error C2370" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2370" +ms.date: 11/04/2016 f1_keywords: ["C2370"] helpviewer_keywords: ["C2370"] -ms.assetid: 03403e8f-f393-47c4-bd25-5c1c7ea7d5cd --- # Compiler Error C2370 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md index 647339bc18c..bb5ba669bfc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2371" title: "Compiler Error C2371" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2371" +ms.date: 11/04/2016 f1_keywords: ["C2371"] helpviewer_keywords: ["C2371"] -ms.assetid: d383993d-05ef-4e35-8129-3b58a6f7b7b7 --- # Compiler Error C2371 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2372.md b/docs/error-messages/compiler-errors-1/compiler-error-c2372.md index 07f26c815cf..e893c5eb51e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2372.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2372.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2372" title: "Compiler Error C2372" -ms.date: "03/23/2020" +description: "Learn more about: Compiler Error C2372" +ms.date: 03/23/2020 f1_keywords: ["C2372"] helpviewer_keywords: ["C2372"] -ms.assetid: 406bea63-c8d3-4231-9d26-c70af6980840 --- # Compiler Error C2372 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md index f6f17a5fc37..1a2078adf1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2373" title: "Compiler Error C2373" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2373" +ms.date: 11/04/2016 f1_keywords: ["C2373"] helpviewer_keywords: ["C2373"] -ms.assetid: 7a08bf0b-852d-48be-ba75-70df9f4b5951 --- # Compiler Error C2373 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md index 85279b0d0fb..ae1d39df38d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2374" title: "Compiler Error C2374" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2374" +ms.date: 11/04/2016 f1_keywords: ["C2374"] helpviewer_keywords: ["C2374"] -ms.assetid: 73b51965-e91c-4e21-9732-f71c1449d22e --- # Compiler Error C2374 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md index 40257e1f855..a70339533a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2375" title: "Compiler Error C2375" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2375" +ms.date: 11/04/2016 f1_keywords: ["C2375"] helpviewer_keywords: ["C2375"] -ms.assetid: 193c5e8b-1b20-4928-8a02-8c1cddaf2a26 --- # Compiler Error C2375 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2376.md b/docs/error-messages/compiler-errors-1/compiler-error-c2376.md index 813e57c5179..0cb73a4d373 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2376.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2376.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2376" title: "Compiler Error C2376" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2376" +ms.date: 11/04/2016 f1_keywords: ["C2376"] helpviewer_keywords: ["C2376"] -ms.assetid: 89423cf7-a24a-4bb3-a2ed-36a1ff8ba458 --- # Compiler Error C2376 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md index 83c17ec4b0e..5ed9e0b2649 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2377" title: "Compiler Error C2377" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2377" +ms.date: 11/04/2016 f1_keywords: ["C2377"] helpviewer_keywords: ["C2377"] -ms.assetid: f7660965-bf4c-4cd9-8307-1bd7016678a1 --- # Compiler Error C2377 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md index 7421d9eeebd..5005fb5f367 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2378" title: "Compiler Error C2378" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2378" +ms.date: 11/04/2016 f1_keywords: ["C2378"] helpviewer_keywords: ["C2378"] -ms.assetid: 507a91c6-ca72-48df-b3a4-2cf931c86806 --- # Compiler Error C2378 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md index fbc5d991036..46c248af538 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2379" title: "Compiler Error C2379" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2379" +ms.date: 11/04/2016 f1_keywords: ["C2379"] helpviewer_keywords: ["C2379"] -ms.assetid: 37dc3015-a4af-4341-bbf3-da6150df7e51 --- # Compiler Error C2379 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md index 59bdc81ff27..9b317bd13db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2380" title: "Compiler Error C2380" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2380" +ms.date: 11/04/2016 f1_keywords: ["C2380"] helpviewer_keywords: ["C2380"] -ms.assetid: 717b1e6e-ddfe-4bac-a5f3-7f9a4dcb1572 --- # Compiler Error C2380 From d66c16021d6a82a9687a933123d6d86a7d16edc8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 16:36:26 +0800 Subject: [PATCH 0513/1799] Add missing class-key for `name`s in standard library `toc.yml` --- docs/standard-library/toc.yml | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/standard-library/toc.yml b/docs/standard-library/toc.yml index da060708822..e5c8a462f58 100644 --- a/docs/standard-library/toc.yml +++ b/docs/standard-library/toc.yml @@ -149,7 +149,7 @@ items: href: chrono-operators.md - name: literals href: chrono-literals.md - - name: ambiguous_local_time + - name: ambiguous_local_time class href: ambiguous-local-time.md - name: choose enum href: choose-enum.md @@ -173,7 +173,7 @@ items: href: high-resolution-clock-struct.md - name: is_clock struct href: is-clock-struct.md - - name: last_spec + - name: last_spec struct href: last-spec-struct.md - name: leap_second class href: leap-second-class.md @@ -193,7 +193,7 @@ items: href: month-weekday-class.md - name: month_weekday_last class href: month-weekday-last-class.md - - name: nonexistent_local_time + - name: nonexistent_local_time class href: nonexistent-local-time.md - name: steady_clock struct href: steady-clock-struct.md @@ -219,7 +219,7 @@ items: href: utc-clock-class.md - name: weekday class href: weekday-class.md - - name: weekday_indexed + - name: weekday_indexed class href: weekdayindexed-class.md - name: weekday_last class href: weekdaylast-class.md @@ -256,11 +256,11 @@ items: href: codecvt.md - name: enums href: codecvt-enums.md - - name: codecvt_utf8 + - name: codecvt_utf8 class href: codecvt-utf8-class.md - - name: codecvt_utf8_utf16 + - name: codecvt_utf8_utf16 class href: codecvt-utf8-utf16-class.md - - name: codecvt_utf16 + - name: codecvt_utf16 class href: codecvt-utf16-class.md - name: expanded: false @@ -980,7 +980,7 @@ items: href: transform-view-class.md - name: values_view class href: values-view-class.md - - name: view_interface + - name: view_interface class href: view-interface.md - name: alias templates href: ranges-alias-templates.md From 03fa38b507ff0612cfbf66af11f497d3ed1bf3c4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 16:56:16 +0800 Subject: [PATCH 0514/1799] Elide even more manual table of contents --- ...rrency-direct3d-namespace-functions-amp.md | 37 ----- ...ncurrency-fast-math-namespace-functions.md | 76 ---------- ...y-graphics-direct3d-namespace-functions.md | 16 -- .../concurrency-namespace-functions-amp.md | 32 ---- .../concurrency-namespace-operators-amp.md | 18 --- ...rrency-precise-math-namespace-functions.md | 142 ------------------ .../concurrency-namespace-constants1.md | 27 ---- .../reference/concurrency-namespace-enums.md | 23 --- .../concurrency-namespace-functions.md | 53 ------- .../concurrency-namespace-operators.md | 19 --- docs/standard-library/allocators-functions.md | 16 -- 11 files changed, 459 deletions(-) diff --git a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md b/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md index d0a6ddd7c47..8559395f202 100644 --- a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md +++ b/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md @@ -6,43 +6,6 @@ f1_keywords: ["amp/Concurrency::direct3d::abs", "amp/Concurrency::direct3d::coun --- # Concurrency::direct3d namespace functions (AMP) -:::row::: - :::column span=""::: - [abs](#abs)\ - [clamp](#clamp)\ - [countbits](#countbits)\ - [create_accelerator_view](#create_accelerator_view)\ - [d3d_access_lock](#d3d_access_lock)\ - [d3d_access_try_lock](#d3d_access_try_lock)\ - [d3d_access_unlock](#d3d_access_unlock) - :::column-end::: - :::column span=""::: - [firstbithigh](#firstbithigh)\ - [firstbitlow](#firstbitlow)\ - [get_buffer](#get_buffer)\ - [get_device](#get_device)\ - [imax](#imax)\ - [imin](#imin)\ - [is_timeout_disabled](#is_timeout_disabled) - :::column-end::: - :::column span=""::: - [mad](#mad)\ - [make_array](#make_array)\ - [noise](#noise)\ - [radians](#radians)\ - [rcp](#rcp)\ - [reversebits](#reversebits) - :::column-end::: - :::column span=""::: - [saturate](#saturate)\ - [sign](#sign)\ - [smoothstep](#smoothstep)\ - [step](#step)\ - [umax](#umax)\ - [umin](#umin) - :::column-end::: -:::row-end::: - ## Requirements **Header:** amp.h diff --git a/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md index dea78f5cd4d..253a4d5c69c 100644 --- a/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md @@ -7,82 +7,6 @@ ms.assetid: f5763d62-795b-4de6-a7a5-c7115f158708 --- # Concurrency::fast_math namespace functions -:::row::: - :::column span=""::: - [`acos`](#acos)\ - [`acosf`](#acosf)\ - [`asin`](#asin)\ - [`asinf`](#asinf)\ - [`atan`](#atan)\ - [`atan2`](#atan2)\ - [`atan2f`](#atan2f)\ - [`atanf`](#atanf)\ - [`ceil`](#ceil)\ - [`ceilf`](#ceilf)\ - [`cos`](#cos)\ - [`cosf`](#cosf)\ - [`cosh`](#cosh)\ - [`coshf`](#coshf)\ - [`exp`](#exp)\ - [`exp2`](#exp2)\ - [`exp2f`](#exp2f) - :::column-end::: - :::column span=""::: - [`expf`](#expf)\ - [`fabs`](#fabs)\ - [`fabsf`](#fabsf)\ - [`floor`](#floor)\ - [`floorf`](#floorf)\ - [`fmax`](#fmax)\ - [`fmaxf`](#fmaxf)\ - [`fmin`](#fmin)\ - [`fminf`](#fminf)\ - [`fmod`](#fmod)\ - [`fmodf`](#fmodf)\ - [`frexp`](#frexp)\ - [`frexpf`](#frexpf)\ - [`isfinite`](#isfinite)\ - [`isinf`](#isinf)\ - [`isnan`](#isnan) - :::column-end::: - :::column span=""::: - [`ldexp`](#ldexp)\ - [`ldexpf`](#ldexpf)\ - [`log`](#log)\ - [`log10`](#log10)\ - [`log10f`](#log10f)\ - [`log2`](#log2)\ - [`log2f`](#log2f)\ - [`logf`](#logf)\ - [`modf`](#modf)\ - [`modff`](#modff)\ - [`pow`](#pow)\ - [`powf`](#powf)\ - [`round`](#round)\ - [`roundf`](#roundf)\ - [`rsqrt`](#rsqrt)\ - [`rsqrtf`](#rsqrtf) - :::column-end::: - :::column span=""::: - [`signbit`](#signbit)\ - [`signbitf`](#signbitf)\ - [`sin`](#sin)\ - [`sincos`](#sincos)\ - [`sincosf`](#sincosf)\ - [`sinf`](#sinf)\ - [`sinh`](#sinh)\ - [`sinhf`](#sinhf)\ - [`sqrt`](#sqrt)\ - [`sqrtf`](#sqrtf)\ - [`tan`](#tan)\ - [`tanf`](#tanf)\ - [`tanh`](#tanh)\ - [`tanhf`](#tanhf)\ - [`trunc`](#trunc)\ - [`truncf`](#truncf) - :::column-end::: -:::row-end::: - ## acos Calculates the arccosine of the argument diff --git a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md index 946f6478c8f..41572910b76 100644 --- a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md @@ -7,22 +7,6 @@ ms.assetid: 11ee1d42-333e-4ae9-95ac-4cf68c06d13d --- # Concurrency::graphics::direct3d namespace functions -:::row::: - :::column span=""::: - [`get_sampler`](#get_sampler)\ - [`get_texture`](#get_texture) - :::column-end::: - :::column span=""::: - [`make_sampler`](#make_sampler) - :::column-end::: - :::column span=""::: - [`make_texture`](#make_texture) - :::column-end::: - :::column span=""::: - [`msad4`](#msad4) - :::column-end::: -:::row-end::: - ## get_sampler Get the D3D sampler state interface on the given accelerator view that represents the specified sampler object. diff --git a/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md b/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md index 5020d2c580b..959587d4204 100644 --- a/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md +++ b/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md @@ -7,38 +7,6 @@ ms.assetid: 2bef0985-cb90-4ece-90b9-66529aec73c9 --- # Concurrency namespace functions (AMP) -:::row::: - :::column span=""::: - [`all_memory_fence`](#all_memory_fence)\ - [`amp_uninitialize`](#amp_uninitialize)\ - [`atomic_compare_exchange`](#atomic_compare_exchange)\ - [`atomic_exchange`](#atomic_exchange)\ - [`atomic_fetch_add`](#atomic_fetch_add)\ - [`atomic_fetch_and`](#atomic_fetch_and) - :::column-end::: - :::column span=""::: - [`atomic_fetch_dec`](#atomic_fetch_dec)\ - [`atomic_fetch_inc`](#atomic_fetch_inc)\ - [`atomic_fetch_max`](#atomic_fetch_max)\ - [`atomic_fetch_min`](#atomic_fetch_min)\ - [`atomic_fetch_or`](#atomic_fetch_or) - :::column-end::: - :::column span=""::: - [`atomic_fetch_sub`](#atomic_fetch_sub)\ - [`atomic_fetch_xor`](#atomic_fetch_xor)\ - [`copy`](#copy)\ - [`copy_async`](#copy_async)\ - [`direct3d_abort`](#direct3d_abort) - :::column-end::: - :::column span=""::: - [`direct3d_errorf`](#direct3d_errorf)\ - [`direct3d_printf`](#direct3d_printf)\ - [`global_memory_fence`](#global_memory_fence)\ - [`parallel_for_each`](#parallel_for_each)\ - [`tile_static_memory_fence`](#tile_static_memory_fence) - :::column-end::: -:::row-end::: - ## all_memory_fence Blocks execution of all threads in a tile until all memory accesses have been completed. This ensures that all memory accesses are visible to other threads in the thread tile, and are executed in program order. diff --git a/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md b/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md index 3275296c1f8..c07c4f840f0 100644 --- a/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md +++ b/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md @@ -6,24 +6,6 @@ ms.assetid: 77f1ae17-1eb2-480d-8fe5-66d4c24bb91e --- # Concurrency namespace operators (AMP) -:::row::: - :::column span=""::: - [`operator==`](#operator_eq_eq)\ - [`operator!=`](#operator_neq) - :::column-end::: - :::column span=""::: - [`operator+`](#operator_add)\ - [`operator-`](#operator-) - :::column-end::: - :::column span=""::: - [`operator*`](#operator_star)\ - [`operator/`](#operator_div) - :::column-end::: - :::column span=""::: - [`operator%`](#operator_mod) - :::column-end::: -:::row-end::: - ## operator== Determines whether the specified arguments are equal. diff --git a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md index fba9b56557b..018b1375634 100644 --- a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md @@ -6,148 +6,6 @@ f1_keywords: ["amp_math/Concurrency::precise_math::acos", "amp_math/Concurrency: --- # Concurrency::precise_math namespace functions -:::row::: - :::column span=""::: - [`acos`](#acos)\ - [`acosf`](#acosf)\ - [`acosh`](#acosh)\ - [`acoshf`](#acoshf)\ - [`asin`](#asin)\ - [`asinf`](#asinf)\ - [`asinh`](#asinh)\ - [`asinhf`](#asinhf)\ - [`atan`](#atan)\ - [`atan2`](#atan2)\ - [`atan2f`](#atan2f)\ - [`atanf`](#atanf)\ - [`atanh`](#atanh)\ - [`atanhf`](#atanhf)\ - [`cbrt`](#cbrt)\ - [`cbrtf`](#cbrtf)\ - [`ceil`](#ceil)\ - [`ceilf`](#ceilf)\ - [`copysign`](#copysign)\ - [`copysignf`](#copysignf)\ - [`cos`](#cos)\ - [`cosf`](#cosf)\ - [`cosh`](#cosh)\ - [`coshf`](#coshf)\ - [`cospi`](#cospi)\ - [`cospif`](#cospif)\ - [`erf`](#erf)\ - [`erfc`](#erfc)\ - [`erfcf`](#erfcf)\ - [`erfcinv`](#erfcinv)\ - [`erfcinvf`](#erfcinvf)\ - [`erff`](#erff)\ - [`erfinv`](#erfinv) - :::column-end::: - :::column span=""::: - [`erfinvf`](#erfinvf)\ - [`exp`](#exp)\ - [`exp10`](#exp10)\ - [`exp10f`](#exp10f)\ - [`exp2`](#exp2)\ - [`exp2f`](#exp2f)\ - [`expf`](#expf)\ - [`expm1`](#expm1)\ - [`expm1f`](#expm1f)\ - [`fabs`](#fabs)\ - [`fabsf`](#fabsf)\ - [`floor`](#floor)\ - [`fdim`](#fdim)\ - [`fdimf`](#fdimf)|\ - [`floorf`](#floorf)\ - [`fma`](#fma)\ - [`fmaf`](#fmaf)\ - [`fmax`](#fmax)\ - [`fmaxf`](#fmaxf)\ - [`fmin`](#fmin)\ - [`fminf`](#fminf)\ - [`fmod`](#fmod)\ - [`fmodf`](#fmodf)\ - [`fpclassify`](#fpclassify)\ - [`frexp`](#frexp)\ - [`frexpf`](#frexpf)\ - [`hypot`](#hypot)\ - [`hypotf`](#hypotf)\ - [`ilogb`](#ilogb)\ - [`ilogbf`](#ilogbf)\ - [`isfinite`](#isfinite)\ - [`isinf`](#isinf)\ - [`isnan`](#isnan) - :::column-end::: - :::column span=""::: - [`isnormal`](#isnormal)\ - [`ldexp`](#ldexp)\ - [`ldexpf`](#ldexpf)\ - [`lgamma`](#lgamma)\ - [`lgammaf`](#lgammaf)\ - [`log`](#log)\ - [`log10`](#log10)\ - [`log10f`](#log10f)\ - [`log1p`](#log1p)\ - [`log1pf`](#log1pf)\ - [`log2`](#log2)\ - [`log2f`](#log2f)\ - [`logb`](#logb)\ - [`logbf`](#logbf)\ - [`logf`](#logf)\ - [`modf`](#modf)\ - [`modff`](#modff)\ - [`nan`](#nan)\ - [`nanf`](#nanf)\ - [`nearbyint`](#nearbyint)\ - [`nearbyintf`](#nearbyintf)\ - [`nextafter`](#nextafter)\ - [`nextafterf`](#nextafterf)\ - [`phi`](#phi)\ - [`phif`](#phif)\ - [`pow`](#pow)\ - [`powf`](#powf)\ - [`probit`](#probit)\ - [`probitf`](#probitf)\ - [`rcbrt`](#rcbrt)\ - [`rcbrtf`](#rcbrtf)\ - [`remainder`](#remainder)\ - [`remainderf`](#remainderf) - :::column-end::: - :::column span=""::: - [`remquo`](#remquo)\ - [`remquof`](#remquof)\ - [`round`](#round)\ - [`roundf`](#roundf)\ - [`rsqrt`](#rsqrt)\ - [`rsqrtf`](#rsqrtf)\ - [`scalb`](#scalb)\ - [`scalbf`](#scalbf)\ - [`scalbn`](#scalbn)\ - [`scalbnf`](#scalbnf)\ - [`signbit`](#signbit)\ - [`signbitf`](#signbitf)\ - [`sin`](#sin)\ - [`sincos`](#sincos)\ - [`sincosf`](#sincosf)\ - [`sinf`](#sinf)\ - [`sinh`](#sinh)\ - [`sinhf`](#sinhf)\ - [`sinpi`](#sinpi)\ - [`sinpif`](#sinpif)\ - [`sqrt`](#sqrt)\ - [`sqrtf`](#sqrtf)\ - [`tan`](#tan)\ - [`tanf`](#tanf)\ - [`tanh`](#tanh)\ - [`tanhf`](#tanhf)\ - [`tanpi`](#tanpi)\ - [`tanpif`](#tanpif)\ - [`tgamma`](#tgamma)\ - [`tgammaf`](#tgammaf)\ - [`trunc`](#trunc)\ - [`truncf`](#truncf) - :::column-end::: -:::row-end::: - ## acos Calculates the arccosine of the argument diff --git a/docs/parallel/concrt/reference/concurrency-namespace-constants1.md b/docs/parallel/concrt/reference/concurrency-namespace-constants1.md index 2cad1ace3d7..ae84ce905fe 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-constants1.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-constants1.md @@ -7,33 +7,6 @@ ms.assetid: 6f81fc4c-b10c-479e-8717-9c292360d5a0 --- # concurrency namespace constants -:::row::: - :::column span=""::: - [`AgentEventGuid`](#agenteventguid)\ - [`CONCRT_RM_VERSION_1`](#concrt_rm_version_1)\ - [`COOPERATIVE_TIMEOUT_INFINITE`](#cooperative_timeout_infinite)\ - [`COOPERATIVE_WAIT_TIMEOUT`](#cooperative_wait_timeout)\ - [`ChoreEventGuid`](#choreeventguid)\ - [`ConcRTEventGuid`](#concrteventguid) - :::column-end::: - :::column span=""::: - [`ConcRT_ProviderGuid`](#concrt_providerguid)\ - [`ContextEventGuid`](#contexteventguid)\ - [`INHERIT_THREAD_PRIORITY`](#inherit_thread_priority)\ - [`LockEventGuid`](#lockeventguid)\ - [`MaxExecutionResources`](#maxexecutionresources)\ - [`PPLParallelForEventGuid`](#pplparallelforeventguid) - :::column-end::: - :::column span=""::: - [`PPLParallelForeachEventGuid`](#pplparallelforeacheventguid)\ - [`PPLParallelInvokeEventGuid`](#pplparallelinvokeeventguid)\ - [`ResourceManagerEventGuid`](#resourcemanagereventguid)\ - [`ScheduleGroupEventGuid`](#schedulegroupeventguid)\ - [`SchedulerEventGuid`](#schedulereventguid)\ - [`VirtualProcessorEventGuid`](#virtualprocessoreventguid) - :::column-end::: -:::row-end::: - ## AgentEventGuid A category GUID ({B9B5B78C-0713-4898-A21A-C67949DCED07}) describing ETW events fired by the Agents library in the Concurrency Runtime. diff --git a/docs/parallel/concrt/reference/concurrency-namespace-enums.md b/docs/parallel/concrt/reference/concurrency-namespace-enums.md index 6d6ed28540c..0fc4dcfa590 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-enums.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-enums.md @@ -7,29 +7,6 @@ ms.assetid: a40e3b2d-ad21-4229-9880-2cfa84f7ab8f --- # concurrency namespace enums -:::row::: - :::column span=""::: - [`agent_status`](#agent_status)\ - [`Agents_EventType`](#agents_eventtype)\ - [`ConcRT_EventType`](#concrt_eventtype)\ - [`Concrt_TraceFlags`](#concrt_traceflags)\ - [`CriticalRegionType`](#criticalregiontype) - :::column-end::: - :::column span=""::: - [`DynamicProgressFeedbackType`](#dynamicprogressfeedbacktype)\ - [`join_type`](#join_type)\ - [`message_status`](#message_status)\ - [`PolicyElementKey`](#policyelementkey)\ - [`SchedulerType`](#schedulertype) - :::column-end::: - :::column span=""::: - [`SchedulingProtocolType`](#schedulingprotocoltype)\ - [`SwitchingProxyState`](#switchingproxystate)\ - [`task_group_status`](#task_group_status)\ - [`WinRTInitializationType`](#winrtinitializationtype) - :::column-end::: -:::row-end::: - ## agent_status Enumeration The valid states for an `agent`. diff --git a/docs/parallel/concrt/reference/concurrency-namespace-functions.md b/docs/parallel/concrt/reference/concurrency-namespace-functions.md index 10f4a1627f6..c1da629a135 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-functions.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-functions.md @@ -6,59 +6,6 @@ f1_keywords: ["concrt/concurrency::Alloc", "concrt/concurrency::DisableTracing", --- # concurrency namespace functions -:::row::: - :::column span=""::: - [`Alloc`](#alloc)\ - [`asend`](#asend)\ - [`cancel_current_task`](#cancel_current_task)\ - [`clear`](#clear)\ - [`create_async`](#create_async)\ - [`create_task`](#create_task)\ - [`CreateResourceManager`](#createresourcemanager)\ - [`DisableTracing`](#disabletracing)\ - [`EnableTracing`](#enabletracing)\ - [`Free`](#free)\ - [`get_ambient_scheduler`](#get_ambient_scheduler)\ - [`GetExecutionContextId`](#getexecutioncontextid)\ - [`GetOSVersion`](#getosversion)\ - [`GetProcessorCount`](#getprocessorcount)\ - [`GetProcessorNodeCount`](#getprocessornodecount) - :::column-end::: - :::column span=""::: - [`GetSchedulerId`](#getschedulerid)\ - [`internal_assign_iterators`](#internal_assign_iterators)\ - [`interruption_point`](#interruption_point)\ - [`is_current_task_group_canceling`](#is_current_task_group_canceling)\ - [`make_choice`](#make_choice)\ - [`make_greedy_join`](#make_greedy_join)\ - [`make_join`](#make_join)\ - [`make_task`](#make_task)\ - [`parallel_buffered_sort`](#parallel_buffered_sort)\ - [`parallel_for_each`](#parallel_for_each)\ - [`parallel_for`](#parallel_for)\ - [`parallel_invoke`](#parallel_invoke)\ - [`parallel_radixsort`](#parallel_radixsort)\ - [`parallel_reduce`](#parallel_reduce)\ - [`parallel_sort`](#parallel_sort) - :::column-end::: - :::column span=""::: - [`parallel_transform`](#parallel_transform)\ - [`receive`](#receive)\ - [`run_with_cancellation_token`](#run_with_cancellation_token)\ - [`send`](#send)\ - [`set_ambient_scheduler`](#set_ambient_scheduler)\ - [`set_task_execution_resources`](#set_task_execution_resources)\ - [`swap`](#swap)\ - [`task_from_exception`](#task_from_exception)\ - [`task_from_result`](#task_from_result)\ - [`Trace_agents_register_name`](#trace_agents_register_name)\ - [`try_receive`](#try_receive)\ - [`wait`](#wait)\ - [`when_all`](#when_all)\ - [`when_any`](#when_any) - :::column-end::: -:::row-end::: - ## Alloc Allocates a block of memory of the size specified from the Concurrency Runtime Caching Suballocator. diff --git a/docs/parallel/concrt/reference/concurrency-namespace-operators.md b/docs/parallel/concrt/reference/concurrency-namespace-operators.md index d3deea034e0..7363e2e6e6b 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-operators.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-operators.md @@ -7,25 +7,6 @@ ms.assetid: 8e373f23-fc8e-49f7-82e6-ba0c57b822f8 --- # concurrency namespace Operators -:::row::: - :::column span=""::: - [`operator||`](#operator_lor)\ - [`operator&&`](#operator_amp_amp) - :::column-end::: - :::column span=""::: - [`operator==`](#operator_eq_eq)\ - [`operator!=`](#operator_neq) - :::column-end::: - :::column span=""::: - [`operator<`](#operator_lt)\ - [`operator<=`](#operator_lt_eq) - :::column-end::: - :::column span=""::: - [`operator>`](#operator_gt)\ - [`operator>=`](#operator_gt_eq) - :::column-end::: -:::row-end::: - ## `operator||` Operator Creates a task that will complete successfully when either of the tasks supplied as arguments completes successfully. diff --git a/docs/standard-library/allocators-functions.md b/docs/standard-library/allocators-functions.md index fafefa60342..cf3f7def1bb 100644 --- a/docs/standard-library/allocators-functions.md +++ b/docs/standard-library/allocators-functions.md @@ -7,22 +7,6 @@ helpviewer_keywords: ["std::ALLOCATOR_DECL [C++]", "std::CACHE_CHUNKLIST [C++]", --- # `` macros -:::row::: - :::column span=""::: - [`ALLOCATOR_DECL`](#allocator_decl)\ - [`CACHE_CHUNKLIST`](#cache_chunklist) - :::column-end::: - :::column span=""::: - [`CACHE_FREELIST`](#cache_freelist) - :::column-end::: - :::column span=""::: - [`CACHE_SUBALLOC`](#cache_suballoc) - :::column-end::: - :::column span=""::: - [`SYNC_DEFAULT`](#sync_default) - :::column-end::: -:::row-end::: - ## ALLOCATOR_DECL Yields an allocator class template. From c532a45a8137962d6b64002b291cb552c6c49048 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 17:19:02 +0800 Subject: [PATCH 0515/1799] Add needed leading sentence in some references --- .../reference/concurrency-direct3d-namespace-functions-amp.md | 2 ++ .../amp/reference/concurrency-fast-math-namespace-functions.md | 2 ++ .../concurrency-graphics-direct3d-namespace-functions.md | 2 ++ .../amp/reference/concurrency-namespace-functions-amp.md | 2 ++ .../amp/reference/concurrency-namespace-operators-amp.md | 2 ++ .../reference/concurrency-precise-math-namespace-functions.md | 2 ++ .../concrt/reference/concurrency-namespace-constants1.md | 2 ++ docs/parallel/concrt/reference/concurrency-namespace-enums.md | 2 ++ .../concrt/reference/concurrency-namespace-functions.md | 2 ++ .../concrt/reference/concurrency-namespace-operators.md | 2 ++ docs/standard-library/allocators-functions.md | 2 ++ 11 files changed, 22 insertions(+) diff --git a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md b/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md index 8559395f202..f6d6c2abb14 100644 --- a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md +++ b/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md @@ -6,6 +6,8 @@ f1_keywords: ["amp/Concurrency::direct3d::abs", "amp/Concurrency::direct3d::coun --- # Concurrency::direct3d namespace functions (AMP) +The following functions are defined in the `Concurrency::direct3d` namespace (AMP): + ## Requirements **Header:** amp.h diff --git a/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md index 253a4d5c69c..f701e475aa9 100644 --- a/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md @@ -7,6 +7,8 @@ ms.assetid: f5763d62-795b-4de6-a7a5-c7115f158708 --- # Concurrency::fast_math namespace functions +The following functions are available in the `Concurrency::fast_math` namespace: + ## acos Calculates the arccosine of the argument diff --git a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md index 41572910b76..5a8df144ed7 100644 --- a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md @@ -7,6 +7,8 @@ ms.assetid: 11ee1d42-333e-4ae9-95ac-4cf68c06d13d --- # Concurrency::graphics::direct3d namespace functions +The following functions are available in the `Concurrency::graphics::direct3d` namespace: + ## get_sampler Get the D3D sampler state interface on the given accelerator view that represents the specified sampler object. diff --git a/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md b/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md index 959587d4204..750f6cbe970 100644 --- a/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md +++ b/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md @@ -7,6 +7,8 @@ ms.assetid: 2bef0985-cb90-4ece-90b9-66529aec73c9 --- # Concurrency namespace functions (AMP) +The following functions are defined in the `Concurrency` namespace (AMP): + ## all_memory_fence Blocks execution of all threads in a tile until all memory accesses have been completed. This ensures that all memory accesses are visible to other threads in the thread tile, and are executed in program order. diff --git a/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md b/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md index c07c4f840f0..39bcedd8471 100644 --- a/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md +++ b/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md @@ -6,6 +6,8 @@ ms.assetid: 77f1ae17-1eb2-480d-8fe5-66d4c24bb91e --- # Concurrency namespace operators (AMP) +The following operators are defined in the `Concurrency` namespace (AMP): + ## operator== Determines whether the specified arguments are equal. diff --git a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md index 018b1375634..4c85696fdd1 100644 --- a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md @@ -6,6 +6,8 @@ f1_keywords: ["amp_math/Concurrency::precise_math::acos", "amp_math/Concurrency: --- # Concurrency::precise_math namespace functions +The following functions are available in the `Concurrency::precise_math` namespace: + ## acos Calculates the arccosine of the argument diff --git a/docs/parallel/concrt/reference/concurrency-namespace-constants1.md b/docs/parallel/concrt/reference/concurrency-namespace-constants1.md index ae84ce905fe..e38ca37ff0f 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-constants1.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-constants1.md @@ -7,6 +7,8 @@ ms.assetid: 6f81fc4c-b10c-479e-8717-9c292360d5a0 --- # concurrency namespace constants +The following constants are defined in the `concurrency` namespace: + ## AgentEventGuid A category GUID ({B9B5B78C-0713-4898-A21A-C67949DCED07}) describing ETW events fired by the Agents library in the Concurrency Runtime. diff --git a/docs/parallel/concrt/reference/concurrency-namespace-enums.md b/docs/parallel/concrt/reference/concurrency-namespace-enums.md index 0fc4dcfa590..795c63a6622 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-enums.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-enums.md @@ -7,6 +7,8 @@ ms.assetid: a40e3b2d-ad21-4229-9880-2cfa84f7ab8f --- # concurrency namespace enums +The following enumerations are available in the `concurrency` namespace: + ## agent_status Enumeration The valid states for an `agent`. diff --git a/docs/parallel/concrt/reference/concurrency-namespace-functions.md b/docs/parallel/concrt/reference/concurrency-namespace-functions.md index c1da629a135..b8309f264f3 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-functions.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-functions.md @@ -6,6 +6,8 @@ f1_keywords: ["concrt/concurrency::Alloc", "concrt/concurrency::DisableTracing", --- # concurrency namespace functions +The following functions are available in the `concurrency` namespace: + ## Alloc Allocates a block of memory of the size specified from the Concurrency Runtime Caching Suballocator. diff --git a/docs/parallel/concrt/reference/concurrency-namespace-operators.md b/docs/parallel/concrt/reference/concurrency-namespace-operators.md index 7363e2e6e6b..b11f01cf1ad 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-operators.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-operators.md @@ -7,6 +7,8 @@ ms.assetid: 8e373f23-fc8e-49f7-82e6-ba0c57b822f8 --- # concurrency namespace Operators +The following operators are available in the `concurrency` namespace: + ## `operator||` Operator Creates a task that will complete successfully when either of the tasks supplied as arguments completes successfully. diff --git a/docs/standard-library/allocators-functions.md b/docs/standard-library/allocators-functions.md index cf3f7def1bb..47258c46189 100644 --- a/docs/standard-library/allocators-functions.md +++ b/docs/standard-library/allocators-functions.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["std::ALLOCATOR_DECL [C++]", "std::CACHE_CHUNKLIST [C++]", --- # `` macros +The `` header provides the following macros: + ## ALLOCATOR_DECL Yields an allocator class template. From fc86262b716f70d1e47e98be077b400c46b69a94 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 17:23:08 +0800 Subject: [PATCH 0516/1799] Update metadata in some parallel programming references --- .../concurrency-direct3d-namespace-functions-amp.md | 2 +- .../reference/concurrency-fast-math-namespace-functions.md | 5 ++--- .../concurrency-graphics-direct3d-namespace-functions.md | 5 ++--- .../amp/reference/concurrency-namespace-functions-amp.md | 5 ++--- .../amp/reference/concurrency-namespace-operators-amp.md | 5 ++--- .../concrt/reference/concurrency-namespace-constants1.md | 5 ++--- .../parallel/concrt/reference/concurrency-namespace-enums.md | 5 ++--- .../concrt/reference/concurrency-namespace-operators.md | 5 ++--- 8 files changed, 15 insertions(+), 22 deletions(-) diff --git a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md b/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md index f6d6c2abb14..4576e407e43 100644 --- a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md +++ b/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md @@ -1,7 +1,7 @@ --- title: "Concurrency::direct3d namespace functions (AMP)" description: "Learn more about: Concurrency::direct3d namespace functions (AMP)" -ms.date: "08/31/2018" +ms.date: 08/31/2018 f1_keywords: ["amp/Concurrency::direct3d::abs", "amp/Concurrency::direct3d::countbits", "amp/Concurrency::direct3d::create_accelerator_view", "amp/Concurrency::direct3d::d3d_access_lock", "amp/Concurrency::direct3d::d3d_access_unlock", "amp/Concurrency::direct3d::firstbithigh", "amp/Concurrency::direct3d::get_buffer", "amp/Concurrency::direct3d::get_device", "amp/Concurrency::direct3d::imax", "amp/Concurrency::direct3d::is_timeout_disabled", "amp/Concurrency::direct3d::mad", "amp/Concurrency::direct3d::noise", "amp/Concurrency::direct3d::radians", "amp/Concurrency::direct3d::reversebits", "amp/Concurrency::direct3d::saturate", "amp/Concurrency::direct3d::smoothstep", "amp/Concurrency::direct3d::step", "amp/Concurrency::direct3d::umin"] --- # Concurrency::direct3d namespace functions (AMP) diff --git a/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md index f701e475aa9..3bbf140a6af 100644 --- a/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Concurrency::fast_math namespace functions" title: "Concurrency::fast_math namespace functions" -ms.date: "11/04/2016" +description: "Learn more about: Concurrency::fast_math namespace functions" +ms.date: 11/04/2016 f1_keywords: ["amp_math/Concurrency::fast_math::acos", "amp_math/Concurrency::fast_math::asin", "amp_math/Concurrency::fast_math::asinf", "amp_math/Concurrency::fast_math::atan2", "amp_math/Concurrency::fast_math::atan2f", "amp_math/Concurrency::fast_math::ceil", "amp_math/Concurrency::fast_math::ceilf", "amp_math/Concurrency::fast_math::cosf", "amp_math/Concurrency::fast_math::cosh", "amp_math/Concurrency::fast_math::exp", "amp_math/Concurrency::fast_math::exp2", "amp_math/Concurrency::fast_math::expf", "amp_math/Concurrency::fast_math::fabs", "amp_math/Concurrency::fast_math::floor", "amp_math/Concurrency::fast_math::floorf", "amp_math/Concurrency::fast_math::fmaxf", "amp_math/Concurrency::fast_math::fmin", "amp_math/Concurrency::fast_math::fmod", "amp_math/Concurrency::fast_math::fmodf", "amp_math/Concurrency::fast_math::frexpf", "amp_math/Concurrency::fast_math::isfinite", "amp_math/Concurrency::fast_math::isnan", "amp_math/Concurrency::fast_math::ldexp", "amp_math/Concurrency::fast_math::log", "amp_math/Concurrency::fast_math::log10", "amp_math/Concurrency::fast_math::log2", "amp_math/Concurrency::fast_math::log2f", "amp_math/Concurrency::fast_math::modf", "amp_math/Concurrency::fast_math::modff", "amp_math/Concurrency::fast_math::powf", "amp_math/Concurrency::fast_math::round", "amp_math/Concurrency::fast_math::rsqrt", "amp_math/Concurrency::fast_math::rsqrtf", "amp_math/Concurrency::fast_math::signbitf", "amp_math/Concurrency::fast_math::sin", "amp_math/Concurrency::fast_math::sincosf", "amp_math/Concurrency::fast_math::sinf", "amp_math/Concurrency::fast_math::sinhf", "amp_math/Concurrency::fast_math::sqrt", "amp_math/Concurrency::fast_math::tan", "amp_math/Concurrency::fast_math::tanf", "amp_math/Concurrency::fast_math::tanhf", "amp_math/Concurrency::fast_math::trunc"] -ms.assetid: f5763d62-795b-4de6-a7a5-c7115f158708 --- # Concurrency::fast_math namespace functions diff --git a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md index 5a8df144ed7..cea85945655 100644 --- a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Concurrency::graphics::direct3d namespace functions" title: "Concurrency::graphics::direct3d namespace functions" -ms.date: "11/04/2016" +description: "Learn more about: Concurrency::graphics::direct3d namespace functions" +ms.date: 11/04/2016 f1_keywords: ["amp_graphics/Concurrency::graphics::direct3d::get_sampler", "amp_graphics/Concurrency::graphics::direct3d::make_sampler", "amp_graphics/Concurrency::graphics::direct3d::make_texture"] -ms.assetid: 11ee1d42-333e-4ae9-95ac-4cf68c06d13d --- # Concurrency::graphics::direct3d namespace functions diff --git a/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md b/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md index 750f6cbe970..ebc67e6ab11 100644 --- a/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md +++ b/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Concurrency namespace functions (AMP)" title: "Concurrency namespace functions (AMP)" -ms.date: "11/04/2016" +description: "Learn more about: Concurrency namespace functions (AMP)" +ms.date: 11/04/2016 f1_keywords: ["amp/Concurrency::all_memory_fence", "amp/Concurrency::atomic_compare_exchange", "amp/Concurrency::atomic_fetch_dec", "amp/Concurrency::atomic_fetch_max", "amp/Concurrency::atomic_fetch_min", "amp/Concurrency::copy", "amp/Concurrency::direct3d_abort", "amp/Concurrency::direct3d_printf", "amp/Concurrency::global_memory_fence", "amp/Concurrency::tile_static_memory_fence"] -ms.assetid: 2bef0985-cb90-4ece-90b9-66529aec73c9 --- # Concurrency namespace functions (AMP) diff --git a/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md b/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md index 39bcedd8471..fff2ed01733 100644 --- a/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md +++ b/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: Concurrency namespace operators (AMP)" title: "Concurrency namespace operators (AMP)" -ms.date: "11/04/2016" -ms.assetid: 77f1ae17-1eb2-480d-8fe5-66d4c24bb91e +description: "Learn more about: Concurrency namespace operators (AMP)" +ms.date: 11/04/2016 --- # Concurrency namespace operators (AMP) diff --git a/docs/parallel/concrt/reference/concurrency-namespace-constants1.md b/docs/parallel/concrt/reference/concurrency-namespace-constants1.md index e38ca37ff0f..38f2288982e 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-constants1.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-constants1.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: concurrency namespace constants" title: "concurrency namespace constants" -ms.date: "11/04/2016" +description: "Learn more about: concurrency namespace constants" +ms.date: 11/04/2016 f1_keywords: ["concrt/concurrency::AgentEventGuid", "concrt/concurrency::COOPERATIVE_TIMEOUT_INFINITE", "concrt/concurrency::COOPERATIVE_WAIT_TIMEOUT", "concrt/concurrency::ConcRTEventGuid", "concrt/concurrency::ConcRT_ProviderGuid", "concrt/concurrency::INHERIT_THREAD_PRIORITY", "concrt/concurrency::LockEventGuid", "concrt/concurrency::PPLParallelForEventGuid", "concrt/concurrency::PPLParallelForeachEventGuid", "concrt/concurrency::ResourceManagerEventGuid", "concrt/concurrency::ScheduleGroupEventGuid", "concrt/concurrency::VirtualProcessorEventGuid"] -ms.assetid: 6f81fc4c-b10c-479e-8717-9c292360d5a0 --- # concurrency namespace constants diff --git a/docs/parallel/concrt/reference/concurrency-namespace-enums.md b/docs/parallel/concrt/reference/concurrency-namespace-enums.md index 795c63a6622..c3502ea9299 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-enums.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-enums.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: concurrency namespace enums" title: "concurrency namespace enums" -ms.date: "11/04/2016" +description: "Learn more about: concurrency namespace enums" +ms.date: 11/04/2016 f1_keywords: ["CONCRT/concurrency::Agents_EventType", "CONCRT/concurrency::Concrt_TraceFlags", "CONCRT/concurrency::CriticalRegionType", "CONCRT/concurrency::PolicyElementKey", "CONCRT/concurrency::SchedulerType", "CONCRT/concurrency::SwitchingProxyState", "CONCRT/concurrency::WinRTInitializationType", "CONCRT/concurrency::join_type", "CONCRT/concurrency::message_status Enumeration"] -ms.assetid: a40e3b2d-ad21-4229-9880-2cfa84f7ab8f --- # concurrency namespace enums diff --git a/docs/parallel/concrt/reference/concurrency-namespace-operators.md b/docs/parallel/concrt/reference/concurrency-namespace-operators.md index b11f01cf1ad..cb9e6005079 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-operators.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: concurrency namespace Operators" title: "concurrency namespace Operators" -ms.date: "11/04/2016" +description: "Learn more about: concurrency namespace Operators" +ms.date: 11/04/2016 f1_keywords: ["concrt/concurrency::operator!=", "concrt/concurrency::operator&&"] -ms.assetid: 8e373f23-fc8e-49f7-82e6-ba0c57b822f8 --- # concurrency namespace Operators From 978980d907997f57ab56ca5fe14746e65eaf7972 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 17:55:38 +0800 Subject: [PATCH 0517/1799] Update unconventional single column table in `Concurrency::graphics::direct3d` namespace reference --- .../concurrency-graphics-direct3d-namespace.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md index ff00042ac40..6351ac7f578 100644 --- a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md +++ b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md @@ -19,13 +19,13 @@ namespace direct3d; ### Functions -|Name

Description| -|--------------------------| -|[get_sampler](concurrency-graphics-direct3d-namespace-functions.md#get_sampler)

Get the Direct3D sampler state interface on the given accelerator view that represents the specified sampler object.| -|[get_texture](concurrency-graphics-direct3d-namespace-functions.md#get_texture)

Gets the Direct3D texture interface underlying the specified [texture](texture-class.md) object.| -|[make_sampler](concurrency-graphics-direct3d-namespace-functions.md#make_sampler)

Create a sampler from a Direct3D sampler state interface pointer.| -|[make_texture](concurrency-graphics-direct3d-namespace-functions.md#make_texture)

Creates a [texture](texture-class.md) object by using the specified parameters.| -|[msad4](concurrency-graphics-direct3d-namespace-functions.md#msad4)

Compares a 4-byte reference value and an 8-byte source value and accumulates a vector of 4 sums.| +|Name|Description| +|----------|-----------------| +|[get_sampler](concurrency-graphics-direct3d-namespace-functions.md#get_sampler)|Get the Direct3D sampler state interface on the given accelerator view that represents the specified sampler object.| +|[get_texture](concurrency-graphics-direct3d-namespace-functions.md#get_texture)|Gets the Direct3D texture interface underlying the specified [texture](texture-class.md) object.| +|[make_sampler](concurrency-graphics-direct3d-namespace-functions.md#make_sampler)|Create a sampler from a Direct3D sampler state interface pointer.| +|[make_texture](concurrency-graphics-direct3d-namespace-functions.md#make_texture)|Creates a [texture](texture-class.md) object by using the specified parameters.| +|[msad4](concurrency-graphics-direct3d-namespace-functions.md#msad4)|Compares a 4-byte reference value and an 8-byte source value and accumulates a vector of 4 sums.| ## Requirements From f7d8c79f19e6c1eb0e2bd2423748756432bd6121 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 17:56:34 +0800 Subject: [PATCH 0518/1799] Update metadata in `Concurrency::graphics::direct3d` namespace reference --- .../amp/reference/concurrency-graphics-direct3d-namespace.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md index 6351ac7f578..05afb7f5aed 100644 --- a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md +++ b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Concurrency::graphics::direct3d Namespace" title: "Concurrency::graphics::direct3d Namespace" -ms.date: "11/04/2016" +description: "Learn more about: Concurrency::graphics::direct3d Namespace" +ms.date: 11/04/2016 f1_keywords: ["amp_graphics/Concurrency::graphics::direct3d", "amp_short_vectors/Concurrency::graphics::direct3d"] -ms.assetid: be283331-07cf-46e4-91a1-e8aa85d4ec8e --- # Concurrency::graphics::direct3d Namespace From fd548217e31c6c6bcd5ba8911cd33c3942badcae Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 18:38:18 +0800 Subject: [PATCH 0519/1799] Change "compliant" wording to "conforming" --- docs/c-runtime-library/reference/abort.md | 2 +- docs/c-runtime-library/reference/set-abort-behavior.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/reference/abort.md b/docs/c-runtime-library/reference/abort.md index 436a39de910..70885616878 100644 --- a/docs/c-runtime-library/reference/abort.md +++ b/docs/c-runtime-library/reference/abort.md @@ -46,7 +46,7 @@ By default, in non-debug builds of desktop or console apps, **`abort`** then inv If the Windows error reporting handler isn't invoked, then **`abort`** calls [`_exit`](exit-exit-exit.md) to terminate the process with exit code 3 and returns control to the parent process or the operating system. `_exit` doesn't flush stream buffers or do `atexit`/`_onexit` processing. -For Windows compatibility reasons, when **`abort`** calls `_exit`, it may invoke the Windows [`ExitProcess`](/windows/win32/api/processthreadsapi/nf-processthreadsapi-exitprocess) API, which in turn allows DLL termination routines to run. Destructors aren't run in the executable, but the same may not be true of DLLs loaded in the executable's process space. This behavior doesn't strictly conform to the C++ standard. To immediately terminate a process including any DLLs, use the Windows [`TerminateProcess`](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-terminateprocess) API. You can also register an abort signal handler that invokes `TerminateProcess` for standard-compliant behavior. Compliant behavior may come at some cost in Windows compatibility. +For Windows compatibility reasons, when **`abort`** calls `_exit`, it may invoke the Windows [`ExitProcess`](/windows/win32/api/processthreadsapi/nf-processthreadsapi-exitprocess) API, which in turn allows DLL termination routines to run. Destructors aren't run in the executable, but the same may not be true of DLLs loaded in the executable's process space. This behavior doesn't strictly conform to the C++ standard. To immediately terminate a process including any DLLs, use the Windows [`TerminateProcess`](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-terminateprocess) API. You can also register an abort signal handler that invokes `TerminateProcess` for standard-conforming behavior. Conforming behavior may come at some cost in Windows compatibility. For more information about CRT debugging, see [CRT debugging techniques](../crt-debugging-techniques.md). diff --git a/docs/c-runtime-library/reference/set-abort-behavior.md b/docs/c-runtime-library/reference/set-abort-behavior.md index 957edb74302..c914fb9de23 100644 --- a/docs/c-runtime-library/reference/set-abort-behavior.md +++ b/docs/c-runtime-library/reference/set-abort-behavior.md @@ -41,7 +41,7 @@ The old value of the flags. There are two [`abort`](abort.md) flags: `_WRITE_ABORT_MSG` and `_CALL_REPORTFAULT`. `_WRITE_ABORT_MSG` determines whether a helpful text message is printed when a program is abnormally terminated. The message states that the application has called the `abort` function. The default behavior is to print the message. `_CALL_REPORTFAULT`, if set, invokes the Windows Error Reporting Service mechanism (formerly known as Dr. Watson) to report failures to Microsoft when `abort` is called. By default, crash dump reporting is enabled in non-DEBUG builds. If the Windows error reporting handler isn't invoked, then `abort` calls [`_exit`](exit-exit-exit.md) to terminate the process with exit code 3 and returns control to the parent process or the operating system. `_exit` doesn't flush stream buffers or do `atexit`/`_onexit` processing. -For Windows compatibility reasons, when `abort` calls `_exit`, it may invoke the Windows [`ExitProcess`](/windows/win32/api/processthreadsapi/nf-processthreadsapi-exitprocess) API, which in turn allows DLL termination routines to run. Destructors aren't run in the executable, but the same may not be true of DLLs loaded in the executable's process space. This behavior doesn't strictly conform to the C++ standard. To immediately terminate a process including any DLLs, use the Windows [`TerminateProcess`](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-terminateprocess) API. You can also register an abort signal handler that invokes `TerminateProcess` for standard-compliant behavior. Compliant behavior may come at some cost in Windows compatibility. +For Windows compatibility reasons, when `abort` calls `_exit`, it may invoke the Windows [`ExitProcess`](/windows/win32/api/processthreadsapi/nf-processthreadsapi-exitprocess) API, which in turn allows DLL termination routines to run. Destructors aren't run in the executable, but the same may not be true of DLLs loaded in the executable's process space. This behavior doesn't strictly conform to the C++ standard. To immediately terminate a process including any DLLs, use the Windows [`TerminateProcess`](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-terminateprocess) API. You can also register an abort signal handler that invokes `TerminateProcess` for standard-conforming behavior. Conforming behavior may come at some cost in Windows compatibility. By default, this function's global state is scoped to the application. To change it, see [Global state in the CRT](../global-state.md). From 94f4a6a54054ac460546b00fb004d330c9d472ae Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 18:39:33 +0800 Subject: [PATCH 0520/1799] Update metadata in `_set_abort_behavior` reference --- docs/c-runtime-library/reference/set-abort-behavior.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/set-abort-behavior.md b/docs/c-runtime-library/reference/set-abort-behavior.md index c914fb9de23..dc00ccec9be 100644 --- a/docs/c-runtime-library/reference/set-abort-behavior.md +++ b/docs/c-runtime-library/reference/set-abort-behavior.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _set_abort_behavior" title: "_set_abort_behavior" +description: "Learn more about: _set_abort_behavior" ms.date: 07/07/2022 api_name: ["_set_abort_behavior", "_o__set_abort_behavior"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-runtime-l1-1-0.dll"] From 8370a6851cf9e14aa564d985ce41c167159a4750 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 23:31:07 +0800 Subject: [PATCH 0521/1799] Add blockquotes for error messages in range [C2381, C2400] --- docs/error-messages/compiler-errors-1/compiler-error-c2381.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2383.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2384.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2386.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2387.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2388.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2389.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2390.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2391.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2392.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2394.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2395.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2396.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2397.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2400.md | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md index 86b2ef3426c..af5336da248 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md @@ -8,7 +8,7 @@ ms.assetid: cc765f67-64ac-406f-93ef-ae7d548d58d7 --- # Compiler Error C2381 -'function' : redefinition; __declspec(noreturn) differs +> 'function' : redefinition; __declspec(noreturn) differs A function was declared and then defined but the definition used the [noreturn](../../cpp/noreturn.md) **`__declspec`** modifier. The use of `noreturn` constitutes a redefinition of the function; the declaration and definition need to agree on the use of `noreturn`. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2383.md b/docs/error-messages/compiler-errors-1/compiler-error-c2383.md index 1e0db5c5781..ad9b8f2d40f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2383.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2383.md @@ -8,7 +8,7 @@ ms.assetid: 6696221d-879c-477a-a0f3-a6edc15fd3d7 --- # Compiler Error C2383 -'*symbol*' : default-arguments are not allowed on this symbol +> '*symbol*' : default-arguments are not allowed on this symbol The C++ compiler does not allow default arguments on pointers to functions. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2384.md b/docs/error-messages/compiler-errors-1/compiler-error-c2384.md index ceff45b6302..a13c0fbd1c6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2384.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2384.md @@ -8,7 +8,7 @@ ms.assetid: 8145f7ad-31b1-406d-ac43-0d557feab635 --- # Compiler Error C2384 -'member' : cannot apply __declspec(thread) to a member of a managed or WinRT class +> 'member' : cannot apply __declspec(thread) to a member of a managed or WinRT class The [thread](../../cpp/thread.md) **`__declspec`** modifier cannot be used on a member of a managed or Windows Runtime class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md index 012734bc39e..6f1df04435a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md @@ -8,7 +8,7 @@ ms.assetid: aaaa1284-34a0-4da2-8547-9fcbb559dae0 --- # Compiler Error C2386 -'symbol' : a symbol with this name already exists in the current scope +> 'symbol' : a symbol with this name already exists in the current scope You tried to create a namespace alias, but the name you chose already exists. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md index 9eb33692520..937b7a7845e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md @@ -8,7 +8,7 @@ ms.assetid: 6847b8e1-ffac-458d-ab88-0c92f72f2527 --- # Compiler Error C2387 -'type' : ambiguous base class +> 'type' : ambiguous base class The compiler could not unambiguously resolve a function call because the function exists in more than one base class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md index 28c5b68ad5b..e59d9f3c8aa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md @@ -8,7 +8,7 @@ ms.assetid: 764ad2d7-cb04-425f-ba30-70989488c4a4 --- # Compiler Error C2388 -'symbol' : a symbol cannot be declared with both __declspec(appdomain) and \__declspec(process) +> 'symbol' : a symbol cannot be declared with both __declspec(appdomain) and \__declspec(process) The `appdomain` and `process` **`__declspec`** modifiers cannot be used on the same symbol. The storage for a variable exists per process or per application domain. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md index 6f13b7db12c..50280e033bb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md @@ -8,7 +8,7 @@ ms.assetid: 6122dc81-4ee3-49a5-a67d-d867808c9bac --- # Compiler Error C2389 -'operator' : illegal operand 'nullptr' +> 'operator' : illegal operand 'nullptr' **`nullptr`** cannot be an operand. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md index bab715650c8..560ff9bd237 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md @@ -8,7 +8,7 @@ ms.assetid: 06b749ee-d072-4db1-b229-715f2c0728b5 --- # Compiler Error C2390 -'identifier' : incorrect storage class 'specifier' +> 'identifier' : incorrect storage class 'specifier' The storage class is not valid for the global-scope identifier. The default storage class is used in place of the invalid class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md index b1895fb9ffc..f6ad9dd6855 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md @@ -8,7 +8,7 @@ ms.assetid: 63a9c6b9-03cc-4517-885c-bdcd048643b3 --- # Compiler Error C2391 -'identifier' : 'friend' cannot be used during type definition +> 'identifier' : 'friend' cannot be used during type definition The **`friend`** declaration includes a complete class declaration. A **`friend`** declaration can specify a member function or an elaborated type specifier, but not a complete class declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md index 81f7a1df2e4..07a98fee35b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md @@ -8,7 +8,7 @@ ms.assetid: 98ced473-6383-46ed-b79c-21857d65dcb2 --- # Compiler Error C2392 -'method1' : covariant returns types are not supported in managed or WinRTtypes, otherwise 'method2' would be overridden +> 'method1' : covariant returns types are not supported in managed or WinRTtypes, otherwise 'method2' would be overridden Covariant return types are not allowed for Windows Runtime member functions or when compiling with the [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) option. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md index 7e5ede5979e..530a38259ed 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2394"] --- # Compiler Error C2394 -'*type*::operator *operator*': CLR/WinRT operator not valid. At least one parameter must be of the following types: 'T^', 'T^%', 'T^&', where T = 'type' +> '*type*::operator *operator*': CLR/WinRT operator not valid. At least one parameter must be of the following types: 'T^', 'T^%', 'T^&', where T = 'type' An operator in a Windows Runtime or managed type did not have at least one parameter whose type is the same as the type of the operator return value. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md index 214524e4d84..e0cf7a4b0b6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md @@ -8,7 +8,7 @@ ms.assetid: 2d9e3b28-8c2c-4f41-a57f-61ef88fc2af0 --- # Compiler Error C2395 -'your_type::operator'op'' : CLR or WinRT operator not valid. At least one parameter must be of the following types: 'T', 'T%', 'T&', 'T^', 'T^%', 'T^&', where T = 'your_type' +> 'your_type::operator'op'' : CLR or WinRT operator not valid. At least one parameter must be of the following types: 'T', 'T%', 'T&', 'T^', 'T^%', 'T^&', where T = 'your_type' An operator in a Windows Runtime or managed type did not have at least one parameter whose type is the same as the type of the operator return value. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md index 1bbd9657c83..77153e4f070 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md @@ -8,7 +8,7 @@ ms.assetid: 1b515ef6-7af4-400f-b4ed-564313ea15f6 --- # Compiler Error C2396 -'your_type::operator'type'' : CLR or WinRT user-defined conversion functionnot valid. Must either convert from or convert to: 'T^', 'T^%', 'T^&', where T = 'your_type' +> 'your_type::operator'type'' : CLR or WinRT user-defined conversion functionnot valid. Must either convert from or convert to: 'T^', 'T^%', 'T^&', where T = 'your_type' A conversion function in a Windows Runtime or managed type did not have at least one parameter whose type is the same as the type containing the conversion function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2397.md b/docs/error-messages/compiler-errors-1/compiler-error-c2397.md index 56f01154682..193667832ca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2397.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2397.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2397"] --- # Compiler Error C2397 -conversion from 'type_1' to 'type_2' requires a narrowing conversion +> conversion from 'type_1' to 'type_2' requires a narrowing conversion An implicit narrowing conversion was found when using uniform initialization. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md index 5cde822bb86..195adc0e402 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md @@ -8,7 +8,7 @@ ms.assetid: 1ba441ee-73f9-42a5-bfe9-fbeab93808eb --- # Compiler Error C2400 -inline assembler syntax error in 'context'; found 'token' +> inline assembler syntax error in 'context'; found 'token' The token caused a syntax error in the specified context. From 46a375b7d9cf9d93cb610202217d327737f4f03f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 23:37:23 +0800 Subject: [PATCH 0522/1799] Add "Remarks" and "Example" headings for error references in range [C2381, C2400] --- docs/error-messages/compiler-errors-1/compiler-error-c2381.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2382.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2383.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2384.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2385.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2386.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2387.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2388.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2389.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2390.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2391.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2392.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2394.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2395.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2396.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2397.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2400.md | 4 ++++ 17 files changed, 58 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md index af5336da248..44d9c8351f5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md @@ -10,8 +10,12 @@ ms.assetid: cc765f67-64ac-406f-93ef-ae7d548d58d7 > 'function' : redefinition; __declspec(noreturn) differs +## Remarks + A function was declared and then defined but the definition used the [noreturn](../../cpp/noreturn.md) **`__declspec`** modifier. The use of `noreturn` constitutes a redefinition of the function; the declaration and definition need to agree on the use of `noreturn`. +## Example + The following sample generates C2381: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2382.md b/docs/error-messages/compiler-errors-1/compiler-error-c2382.md index 93ae496d52e..529b8deeff4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2382.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2382.md @@ -10,10 +10,10 @@ ms.assetid: 4d4436f9-d0d6-4bd0-b8ec-767b89adfb2f > '*function*' : redefinition; different exception specifications -This error indicates that a function overload was attempted only on the [exception specification](../../cpp/exception-specifications-throw-cpp.md). - ## Remarks +This error indicates that a function overload was attempted only on the [exception specification](../../cpp/exception-specifications-throw-cpp.md). + By default, the compiler considers a `noexcept` specification to be equivalent to a `throw()` or `throw(some_type)` specification. Under [`/Za`](../../build/reference/za-ze-disable-language-extensions.md), this check is more strict. To resolve this issue, change all declarations and definitions of the function (or the specific function overload) to use the same exception specification. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2383.md b/docs/error-messages/compiler-errors-1/compiler-error-c2383.md index ad9b8f2d40f..01789d54919 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2383.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2383.md @@ -10,6 +10,8 @@ ms.assetid: 6696221d-879c-477a-a0f3-a6edc15fd3d7 > '*symbol*' : default-arguments are not allowed on this symbol +## Remarks + The C++ compiler does not allow default arguments on pointers to functions. This code was accepted by the Microsoft C++ compiler in versions before Visual Studio 2005, but now gives an error. For code that works in all versions of Visual C++, do not assign a default value to a pointer-to-function argument. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2384.md b/docs/error-messages/compiler-errors-1/compiler-error-c2384.md index a13c0fbd1c6..31fc667465c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2384.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2384.md @@ -10,10 +10,14 @@ ms.assetid: 8145f7ad-31b1-406d-ac43-0d557feab635 > 'member' : cannot apply __declspec(thread) to a member of a managed or WinRT class +## Remarks + The [thread](../../cpp/thread.md) **`__declspec`** modifier cannot be used on a member of a managed or Windows Runtime class. Static thread local storage in managed code can only be used for statically loaded DLLs—the DLL must be statically loaded when the process starts. Windows Runtime does not support thread local storage. +## Example + The following line generates C2384 and shows how to fix it in C++/CLI code: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2385.md b/docs/error-messages/compiler-errors-1/compiler-error-c2385.md index 073c282ce9b..f0cc2f5da6e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2385.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2385.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2385"] > ambiguous access of 'member' +## Remarks + A member is inherited from more than one base type, making unqualified access to that member ambiguous. To resolve this error: - Explicitly qualify access to the member. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md index 6f1df04435a..9cc14ac1d02 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md @@ -10,8 +10,12 @@ ms.assetid: aaaa1284-34a0-4da2-8547-9fcbb559dae0 > 'symbol' : a symbol with this name already exists in the current scope +## Remarks + You tried to create a namespace alias, but the name you chose already exists. +## Example + The following sample generates C2386: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md index 937b7a7845e..90a5ac9d6f9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md @@ -10,10 +10,14 @@ ms.assetid: 6847b8e1-ffac-458d-ab88-0c92f72f2527 > 'type' : ambiguous base class +## Remarks + The compiler could not unambiguously resolve a function call because the function exists in more than one base class. To resolve this error, either remove one of the base classes from the inheritance, or explicitly qualify the function call. +## Example + The following sample generates C2387: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md index e59d9f3c8aa..861d94850fd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md @@ -10,10 +10,14 @@ ms.assetid: 764ad2d7-cb04-425f-ba30-70989488c4a4 > 'symbol' : a symbol cannot be declared with both __declspec(appdomain) and \__declspec(process) +## Remarks + The `appdomain` and `process` **`__declspec`** modifiers cannot be used on the same symbol. The storage for a variable exists per process or per application domain. For more information, see [appdomain](../../cpp/appdomain.md) and [process](../../cpp/process.md). +## Example + The following sample generates C2388: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md index 50280e033bb..ea2e150f55d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md @@ -10,8 +10,12 @@ ms.assetid: 6122dc81-4ee3-49a5-a67d-d867808c9bac > 'operator' : illegal operand 'nullptr' +## Remarks + **`nullptr`** cannot be an operand. +## Example + The following sample generates C2389: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md index 560ff9bd237..5563557ecfc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md @@ -10,6 +10,8 @@ ms.assetid: 06b749ee-d072-4db1-b229-715f2c0728b5 > 'identifier' : incorrect storage class 'specifier' +## Remarks + The storage class is not valid for the global-scope identifier. The default storage class is used in place of the invalid class. Possible resolutions: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md index f6ad9dd6855..f056e786437 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md @@ -10,8 +10,12 @@ ms.assetid: 63a9c6b9-03cc-4517-885c-bdcd048643b3 > 'identifier' : 'friend' cannot be used during type definition +## Remarks + The **`friend`** declaration includes a complete class declaration. A **`friend`** declaration can specify a member function or an elaborated type specifier, but not a complete class declaration. +## Example + The following sample generates C2326: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md index 07a98fee35b..56d84b13180 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md @@ -10,6 +10,8 @@ ms.assetid: 98ced473-6383-46ed-b79c-21857d65dcb2 > 'method1' : covariant returns types are not supported in managed or WinRTtypes, otherwise 'method2' would be overridden +## Remarks + Covariant return types are not allowed for Windows Runtime member functions or when compiling with the [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) option. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md index 530a38259ed..8d79179efba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2394"] > '*type*::operator *operator*': CLR/WinRT operator not valid. At least one parameter must be of the following types: 'T^', 'T^%', 'T^&', where T = 'type' +## Remarks + An operator in a Windows Runtime or managed type did not have at least one parameter whose type is the same as the type of the operator return value. +## Example + The following sample generates C2394: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md index e0cf7a4b0b6..419c68d92f3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md @@ -10,8 +10,12 @@ ms.assetid: 2d9e3b28-8c2c-4f41-a57f-61ef88fc2af0 > 'your_type::operator'op'' : CLR or WinRT operator not valid. At least one parameter must be of the following types: 'T', 'T%', 'T&', 'T^', 'T^%', 'T^&', where T = 'your_type' +## Remarks + An operator in a Windows Runtime or managed type did not have at least one parameter whose type is the same as the type of the operator return value. +## Example + The following sample generates C2395 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md index 77153e4f070..03130bda5fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md @@ -10,8 +10,12 @@ ms.assetid: 1b515ef6-7af4-400f-b4ed-564313ea15f6 > 'your_type::operator'type'' : CLR or WinRT user-defined conversion functionnot valid. Must either convert from or convert to: 'T^', 'T^%', 'T^&', where T = 'your_type' +## Remarks + A conversion function in a Windows Runtime or managed type did not have at least one parameter whose type is the same as the type containing the conversion function. +## Example + The following sample generates C2396 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2397.md b/docs/error-messages/compiler-errors-1/compiler-error-c2397.md index 193667832ca..c45124cda37 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2397.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2397.md @@ -9,12 +9,16 @@ helpviewer_keywords: ["C2397"] > conversion from 'type_1' to 'type_2' requires a narrowing conversion +## Remarks + An implicit narrowing conversion was found when using uniform initialization. The C language allows implicit narrowing conversions in assignments and initialization, and C++ follows suit, even though unexpected narrowing is a cause of many code errors. To make code safer, the C++ standard requires a diagnostic message when a narrowing conversion occurs in an initialization list. In Visual C++, the diagnostic is Compiler Error C2397 when using the uniform initialization syntax supported beginning in Visual Studio 2015. The compiler generates [Compiler Warning (level 1) C4838](../../error-messages/compiler-warnings/compiler-warning-level-1-c4838.md) when using the list or aggregate initialization syntax supported by Visual Studio 2013. A narrowing conversion can be okay when you know the possible range of converted values can fit in the target. In this case, you know more than the compiler does. If you make a narrowing conversion intentionally, make your intentions explicit by using a static cast. Otherwise, this error message almost always indicates you have a bug in your code. You can fix it by making sure the objects you initialize have types that are large enough to handle the inputs. +## Example + The following sample generates C2397: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md index 195adc0e402..c740f99197e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md @@ -10,8 +10,12 @@ ms.assetid: 1ba441ee-73f9-42a5-bfe9-fbeab93808eb > inline assembler syntax error in 'context'; found 'token' +## Remarks + The token caused a syntax error in the specified context. +## Example + The following sample generates C2400: ```cpp From a6b477fdd8d05fa5853c4788536c9f0104febf81 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 23:40:45 +0800 Subject: [PATCH 0523/1799] Replace term "sample" with "example" for error references in range [C2381, C2400] --- docs/error-messages/compiler-errors-1/compiler-error-c2381.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2382.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2385.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2386.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2387.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2388.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2389.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2390.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2391.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2392.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2393.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2394.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2395.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2396.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2397.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2400.md | 2 +- 16 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md index 44d9c8351f5..93d784ee37f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md @@ -16,7 +16,7 @@ A function was declared and then defined but the definition used the [noreturn]( ## Example -The following sample generates C2381: +The following example generates C2381: ```cpp // C2381.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2382.md b/docs/error-messages/compiler-errors-1/compiler-error-c2382.md index 529b8deeff4..55e19fb590c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2382.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2382.md @@ -20,7 +20,7 @@ To resolve this issue, change all declarations and definitions of the function ( ## Example -The following sample generates C2382: +The following example generates C2382: ```cpp // C2382.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2385.md b/docs/error-messages/compiler-errors-1/compiler-error-c2385.md index f0cc2f5da6e..f4d69730784 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2385.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2385.md @@ -20,7 +20,7 @@ A member is inherited from more than one base type, making unqualified access to ## Example -The following sample generates C2385: +The following example generates C2385: ```cpp // C2385.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md index 9cc14ac1d02..1c48af13013 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md @@ -16,7 +16,7 @@ You tried to create a namespace alias, but the name you chose already exists. ## Example -The following sample generates C2386: +The following example generates C2386: ```cpp // C2386.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md index 90a5ac9d6f9..4cc1ece6100 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md @@ -18,7 +18,7 @@ To resolve this error, either remove one of the base classes from the inheritanc ## Example -The following sample generates C2387: +The following example generates C2387: ```cpp // C2387.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md index 861d94850fd..b9226eb11e5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md @@ -18,7 +18,7 @@ For more information, see [appdomain](../../cpp/appdomain.md) and [process](../. ## Example -The following sample generates C2388: +The following example generates C2388: ```cpp // C2388.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md index ea2e150f55d..b82f5e9019c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md @@ -16,7 +16,7 @@ ms.assetid: 6122dc81-4ee3-49a5-a67d-d867808c9bac ## Example -The following sample generates C2389: +The following example generates C2389: ```cpp // C2389.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md index 5563557ecfc..ebf172ad229 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md @@ -24,7 +24,7 @@ Possible resolutions: ## Example -- The following sample generates C2390: +- The following example generates C2390: ```cpp // C2390.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md index f056e786437..50c1de9467f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md @@ -16,7 +16,7 @@ The **`friend`** declaration includes a complete class declaration. A **`friend` ## Example -The following sample generates C2326: +The following example generates C2326: ```cpp // C2391.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md index 56d84b13180..93b15c8104e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md @@ -16,7 +16,7 @@ Covariant return types are not allowed for Windows Runtime member functions or w ## Example -The following sample generates C2392 and shows how to fix it. +The following example generates C2392 and shows how to fix it. ```cpp // C2392.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2393.md b/docs/error-messages/compiler-errors-1/compiler-error-c2393.md index 36d2868f7bf..d3772466d42 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2393.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2393.md @@ -20,7 +20,7 @@ See [/clr (Common Language Runtime Compilation)](../../build/reference/clr-commo ## Example -The following sample generates C2393. To fix this issue, do not create a data segment. +The following example generates C2393. To fix this issue, do not create a data segment. ```cpp // C2393.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md index 8d79179efba..37b38d00054 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md @@ -15,7 +15,7 @@ An operator in a Windows Runtime or managed type did not have at least one param ## Example -The following sample generates C2394: +The following example generates C2394: ```cpp // C2394.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md index 419c68d92f3..115b7bbd532 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md @@ -16,7 +16,7 @@ An operator in a Windows Runtime or managed type did not have at least one param ## Example -The following sample generates C2395 and shows how to fix it: +The following example generates C2395 and shows how to fix it: ```cpp // C2395.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md index 03130bda5fa..7877923f408 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md @@ -16,7 +16,7 @@ A conversion function in a Windows Runtime or managed type did not have at least ## Example -The following sample generates C2396 and shows how to fix it: +The following example generates C2396 and shows how to fix it: ```cpp // C2396.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2397.md b/docs/error-messages/compiler-errors-1/compiler-error-c2397.md index c45124cda37..8563bf8e4fe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2397.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2397.md @@ -19,7 +19,7 @@ A narrowing conversion can be okay when you know the possible range of converted ## Example -The following sample generates C2397: +The following example generates C2397: ```cpp // C2397.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md index c740f99197e..fb1092feef8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md @@ -16,7 +16,7 @@ The token caused a syntax error in the specified context. ## Example -The following sample generates C2400: +The following example generates C2400: ```cpp // C2400.cpp From 6f637efcdd037ac78a27598ef3ffa2d298fedaeb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 25 Jul 2025 23:43:30 +0800 Subject: [PATCH 0524/1799] Update metadata for error references in range [C2381, C2400] --- .../error-messages/compiler-errors-1/compiler-error-c2381.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2382.md | 3 +-- .../error-messages/compiler-errors-1/compiler-error-c2383.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2384.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2385.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2386.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2387.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2388.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2389.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2390.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2391.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2392.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2393.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2394.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2395.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2396.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2400.md | 5 ++--- 17 files changed, 32 insertions(+), 47 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md index 93d784ee37f..01ef31cff42 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2381" title: "Compiler Error C2381" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2381" +ms.date: 11/04/2016 f1_keywords: ["C2381"] helpviewer_keywords: ["C2381"] -ms.assetid: cc765f67-64ac-406f-93ef-ae7d548d58d7 --- # Compiler Error C2381 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2382.md b/docs/error-messages/compiler-errors-1/compiler-error-c2382.md index 55e19fb590c..d4542d3dfb9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2382.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2382.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2382" title: "Compiler Error C2382" +description: "Learn more about: Compiler Error C2382" ms.date: 12/10/2021 f1_keywords: ["C2382"] helpviewer_keywords: ["C2382"] -ms.assetid: 4d4436f9-d0d6-4bd0-b8ec-767b89adfb2f --- # Compiler Error C2382 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2383.md b/docs/error-messages/compiler-errors-1/compiler-error-c2383.md index 01789d54919..07b1a0d9d32 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2383.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2383.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2383" title: "Compiler Error C2383" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2383" +ms.date: 11/04/2016 f1_keywords: ["C2383"] helpviewer_keywords: ["C2383"] -ms.assetid: 6696221d-879c-477a-a0f3-a6edc15fd3d7 --- # Compiler Error C2383 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2384.md b/docs/error-messages/compiler-errors-1/compiler-error-c2384.md index 31fc667465c..19755c18cd9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2384.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2384.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2384" title: "Compiler Error C2384" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2384" +ms.date: 11/04/2016 f1_keywords: ["C2384"] helpviewer_keywords: ["C2384"] -ms.assetid: 8145f7ad-31b1-406d-ac43-0d557feab635 --- # Compiler Error C2384 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2385.md b/docs/error-messages/compiler-errors-1/compiler-error-c2385.md index f4d69730784..1db2d3606f3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2385.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2385.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2385" title: "Compiler Error C2385" -ms.date: "1/19/2024" +description: "Learn more about: Compiler Error C2385" +ms.date: 1/19/2024 f1_keywords: ["C2385"] helpviewer_keywords: ["C2385"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md index 1c48af13013..0c6ef1105bd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2386" title: "Compiler Error C2386" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2386" +ms.date: 11/04/2016 f1_keywords: ["C2386"] helpviewer_keywords: ["C2386"] -ms.assetid: aaaa1284-34a0-4da2-8547-9fcbb559dae0 --- # Compiler Error C2386 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md index 4cc1ece6100..d14ff9cbb32 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2387" title: "Compiler Error C2387" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2387" +ms.date: 11/04/2016 f1_keywords: ["C2387"] helpviewer_keywords: ["C2387"] -ms.assetid: 6847b8e1-ffac-458d-ab88-0c92f72f2527 --- # Compiler Error C2387 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md index b9226eb11e5..8c10c31f398 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2388" title: "Compiler Error C2388" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2388" +ms.date: 11/04/2016 f1_keywords: ["C2388"] helpviewer_keywords: ["C2388"] -ms.assetid: 764ad2d7-cb04-425f-ba30-70989488c4a4 --- # Compiler Error C2388 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md index b82f5e9019c..4c354f6d1f2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2389" title: "Compiler Error C2389" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2389" +ms.date: 11/04/2016 f1_keywords: ["C2389"] helpviewer_keywords: ["C2389"] -ms.assetid: 6122dc81-4ee3-49a5-a67d-d867808c9bac --- # Compiler Error C2389 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md index ebf172ad229..8754be37546 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2390" title: "Compiler Error C2390" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2390" +ms.date: 11/04/2016 f1_keywords: ["C2390"] helpviewer_keywords: ["C2390"] -ms.assetid: 06b749ee-d072-4db1-b229-715f2c0728b5 --- # Compiler Error C2390 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md index 50c1de9467f..dcf10dedd8e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2391" title: "Compiler Error C2391" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2391" +ms.date: 11/04/2016 f1_keywords: ["C2391"] helpviewer_keywords: ["C2391"] -ms.assetid: 63a9c6b9-03cc-4517-885c-bdcd048643b3 --- # Compiler Error C2391 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md index 93b15c8104e..70e6acb33cb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2392" title: "Compiler Error C2392" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2392" +ms.date: 11/04/2016 f1_keywords: ["C2392"] helpviewer_keywords: ["C2392"] -ms.assetid: 98ced473-6383-46ed-b79c-21857d65dcb2 --- # Compiler Error C2392 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2393.md b/docs/error-messages/compiler-errors-1/compiler-error-c2393.md index d3772466d42..fe80176868d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2393.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2393.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2393" title: "Compiler Error C2393" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2393" +ms.date: 11/04/2016 f1_keywords: ["C2393"] helpviewer_keywords: ["C2393"] -ms.assetid: 4bd95728-e813-4ce8-844a-c6ebe235ca82 --- # Compiler Error C2393 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md index 37b38d00054..58274a9b468 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2394" description: "Learn more about: Compiler Error C2394" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C2394"] helpviewer_keywords: ["C2394"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md index 115b7bbd532..1d4a90319a9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2395" title: "Compiler Error C2395" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2395" +ms.date: 11/04/2016 f1_keywords: ["C2395"] helpviewer_keywords: ["C2395"] -ms.assetid: 2d9e3b28-8c2c-4f41-a57f-61ef88fc2af0 --- # Compiler Error C2395 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md index 7877923f408..8fa97066805 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2396" title: "Compiler Error C2396" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2396" +ms.date: 11/04/2016 f1_keywords: ["C2396"] helpviewer_keywords: ["C2396"] -ms.assetid: 1b515ef6-7af4-400f-b4ed-564313ea15f6 --- # Compiler Error C2396 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md index fb1092feef8..88ccb9b2eec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2400" title: "Compiler Error C2400" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2400" +ms.date: 11/04/2016 f1_keywords: ["C2400"] helpviewer_keywords: ["C2400"] -ms.assetid: 1ba441ee-73f9-42a5-bfe9-fbeab93808eb --- # Compiler Error C2400 From bc23da40f37bbf03c9504baeb7b5e71e7ed50c9a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 26 Jul 2025 07:32:32 +0800 Subject: [PATCH 0525/1799] Clean up superfluous trailing spaces in `toc.yml`s (#5502) I own these. --- docs/build/toc.yml | 4 ++-- docs/c-language/toc.yml | 2 +- docs/c-runtime-library/toc.yml | 2 +- docs/cpp/toc.yml | 2 +- docs/cross-platform/toc.yml | 2 +- docs/embedded/toc.yml | 2 +- docs/error-messages/toc.yml | 2 +- docs/get-started/toc.yml | 6 +++--- docs/ide/toc.yml | 2 +- docs/intrinsics/toc.yml | 2 +- docs/mfc/toc.yml | 4 ++-- docs/preprocessor/toc.yml | 2 +- docs/standard-library/toc.yml | 4 ++-- 13 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/build/toc.yml b/docs/build/toc.yml index 444ec54501b..40514a75141 100644 --- a/docs/build/toc.yml +++ b/docs/build/toc.yml @@ -408,7 +408,7 @@ items: - name: Command line property pages href: ../build/reference/command-line-property-pages.md - name: NMake property page - href: ../build/reference/nmake-property-page.md + href: ../build/reference/nmake-property-page.md - name: Manifest Tool property pages href: ../build/reference/manifest-tool-property-pages.md - name: Resources property pages @@ -1181,7 +1181,7 @@ items: href: ../build/reference/nmake-reference.md - name: NMAKE projects in Visual Studio href: ../build/reference/creating-a-makefile-project.md - - name: Running NMAKE + - name: Running NMAKE href: ../build/reference/running-nmake.md - name: Makefile contents and features href: ../build/reference/contents-of-a-makefile.md diff --git a/docs/c-language/toc.yml b/docs/c-language/toc.yml index cfd26f82ed8..13334cd6b4e 100644 --- a/docs/c-language/toc.yml +++ b/docs/c-language/toc.yml @@ -444,7 +444,7 @@ items: - name: Inline assembler (C) href: ../c-language/inline-assembler-c.md - name: _Noreturn (C) - href: ../c-language/noreturn.md + href: ../c-language/noreturn.md - name: DLL import and export functions items: - name: DLL import and export functions diff --git a/docs/c-runtime-library/toc.yml b/docs/c-runtime-library/toc.yml index 4eb9c708b3c..926d9dd23ff 100644 --- a/docs/c-runtime-library/toc.yml +++ b/docs/c-runtime-library/toc.yml @@ -75,7 +75,7 @@ items: - name: Global state in the CRT href: ../c-runtime-library/global-state.md - name: Type-generic math - href: ../c-runtime-library/tgmath.md + href: ../c-runtime-library/tgmath.md - name: C runtime (CRT) and C++ Standard Library (STL) .lib files href: ../c-runtime-library/crt-library-features.md - name: Universal C runtime routines by category diff --git a/docs/cpp/toc.yml b/docs/cpp/toc.yml index 35e1c6921a8..1c9d0872d8e 100644 --- a/docs/cpp/toc.yml +++ b/docs/cpp/toc.yml @@ -369,7 +369,7 @@ items: - name: Pimpl idiom for compile-time encapsulation href: ../cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md - name: Portability at ABI boundaries - href: ../cpp/portability-at-abi-boundaries-modern-cpp.md + href: ../cpp/portability-at-abi-boundaries-modern-cpp.md - name: Constructors items: - name: Constructors diff --git a/docs/cross-platform/toc.yml b/docs/cross-platform/toc.yml index 4446b6541ff..22771c639f1 100644 --- a/docs/cross-platform/toc.yml +++ b/docs/cross-platform/toc.yml @@ -2,7 +2,7 @@ items: - name: Cross-platform mobile development with C++ href: ../cross-platform/index.yml - name: Overview - href: ../cross-platform/visual-cpp-for-cross-platform-mobile-development.md + href: ../cross-platform/visual-cpp-for-cross-platform-mobile-development.md - name: Get Started expanded: true items: diff --git a/docs/embedded/toc.yml b/docs/embedded/toc.yml index 01279ba35c7..b948c79311e 100644 --- a/docs/embedded/toc.yml +++ b/docs/embedded/toc.yml @@ -19,7 +19,7 @@ items: href: ./peripheral-view.md - name: RTOS View href: ./rtos-view.md - - name: Serial Monitor + - name: Serial Monitor href: ./serial-monitor.md - name: vcpkg artifacts href: https://devblogs.microsoft.com/cppblog/vcpkg-artifacts/ diff --git a/docs/error-messages/toc.yml b/docs/error-messages/toc.yml index ed8722eb608..acb65fcdd54 100644 --- a/docs/error-messages/toc.yml +++ b/docs/error-messages/toc.yml @@ -4437,7 +4437,7 @@ items: href: tool-errors/cvtres-fatal-error-cvt1105.md - name: CVTRES warning CVT4001 href: tool-errors/cvtres-warning-cvt4001.md -- name: Expression evaluator errors +- name: Expression evaluator errors expanded: false items: - name: Expression evaluator errors (CXXxxxx) diff --git a/docs/get-started/toc.yml b/docs/get-started/toc.yml index 224ea3f49a3..49961e13203 100644 --- a/docs/get-started/toc.yml +++ b/docs/get-started/toc.yml @@ -25,7 +25,7 @@ items: items: - name: Create a console app href: tutorial-console-cpp.md - - name: Create a Universal Windows Platform app + - name: Create a Universal Windows Platform app href: /windows/uwp/cpp-and-winrt-apis/get-started - name: Create a Windows Desktop app href: /windows/desktop/learnwin32/learn-to-program-for-windows @@ -44,9 +44,9 @@ items: items: - name: Open code from a repo href: /visualstudio/get-started/tutorial-open-project-from-repo - - name: Write and edit code + - name: Write and edit code href: /visualstudio/get-started/tutorial-editor - - name: Compile and build + - name: Compile and build href: /visualstudio/ide/compiling-and-building-in-visual-studio - name: Debug your C++ code href: /visualstudio/debugger/quickstart-debug-with-cplusplus diff --git a/docs/ide/toc.yml b/docs/ide/toc.yml index c208f599e60..0b58b7607e9 100644 --- a/docs/ide/toc.yml +++ b/docs/ide/toc.yml @@ -93,7 +93,7 @@ items: - name: Add a method href: ../ide/adding-a-method-visual-cpp.md - name: Add an IDL method - href: ../ide/add-interface-definition-library-method-wizard.md + href: ../ide/add-interface-definition-library-method-wizard.md - name: Add a property href: ../ide/adding-a-property-visual-cpp.md - name: Add an IDL property diff --git a/docs/intrinsics/toc.yml b/docs/intrinsics/toc.yml index eb04364ed40..0c9053c8c38 100644 --- a/docs/intrinsics/toc.yml +++ b/docs/intrinsics/toc.yml @@ -40,7 +40,7 @@ items: - name: _bittestandset, _bittestandset64 href: ../intrinsics/bittestandset-bittestandset64.md - name: __check_isa_support, __check_arch_support - href: ../intrinsics/check-isa-arch-support.md + href: ../intrinsics/check-isa-arch-support.md - name: __cpuid, __cpuidex href: ../intrinsics/cpuid-cpuidex.md - name: __debugbreak diff --git a/docs/mfc/toc.yml b/docs/mfc/toc.yml index eff745b7441..691f07b181b 100644 --- a/docs/mfc/toc.yml +++ b/docs/mfc/toc.yml @@ -2919,6 +2919,6 @@ items: - name: Add a method to an IDL interface in a MFC project href: reference/add-idl-mfc-method-wizard.md - name: Add a property to an IDL interface in a MFC project - href: reference/add-interface-definition-library-mfc-property-wizard.md + href: reference/add-interface-definition-library-mfc-property-wizard.md - name: MFC class wizard - href: reference/mfc-class-wizard.md \ No newline at end of file + href: reference/mfc-class-wizard.md \ No newline at end of file diff --git a/docs/preprocessor/toc.yml b/docs/preprocessor/toc.yml index a2121985ada..4535a25eb64 100644 --- a/docs/preprocessor/toc.yml +++ b/docs/preprocessor/toc.yml @@ -7,7 +7,7 @@ items: - name: Preprocessor href: ../preprocessor/preprocessor.md - name: New preprocessor overview - href: ../preprocessor/preprocessor-experimental-overview.md + href: ../preprocessor/preprocessor-experimental-overview.md - name: Phases of translation href: ../preprocessor/phases-of-translation.md - name: Preprocessor directives diff --git a/docs/standard-library/toc.yml b/docs/standard-library/toc.yml index da060708822..40f30f1268f 100644 --- a/docs/standard-library/toc.yml +++ b/docs/standard-library/toc.yml @@ -169,9 +169,9 @@ items: href: gps-clock-class.md - name: hh_mm_ss class href: hhmmss-class.md - - name: high_resolution_clock struct + - name: high_resolution_clock struct href: high-resolution-clock-struct.md - - name: is_clock struct + - name: is_clock struct href: is-clock-struct.md - name: last_spec href: last-spec-struct.md From 068cb24921f656f37c1a8ab411f5955bec86a93a Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 25 Jul 2025 17:27:46 -0700 Subject: [PATCH 0526/1799] uuf fixes (#6021) --- docs/build/x64-calling-convention.md | 2 +- ...how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md | 3 +-- docs/cpp/lvalues-and-rvalues-visual-cpp.md | 2 +- docs/parallel/openmp/reference/openmp-directives.md | 2 +- docs/preprocessor/optimize.md | 6 +++--- 5 files changed, 7 insertions(+), 8 deletions(-) diff --git a/docs/build/x64-calling-convention.md b/docs/build/x64-calling-convention.md index abb153a8468..bf4a575b47f 100644 --- a/docs/build/x64-calling-convention.md +++ b/docs/build/x64-calling-convention.md @@ -93,7 +93,7 @@ If parameters are passed via varargs (for example, ellipsis arguments), then the For functions not fully prototyped, the caller passes integer values as integers and floating-point values as double precision. For floating-point values only, both the integer register and the floating-point register contain the float value in case the callee expects the value in the integer registers. -```cpp +```c func1(); func2() { // RCX = 2, RDX = XMM1 = 1.0, and R8 = 7 func1(2, 1.0, 7); diff --git a/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md b/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md index 37f9edb3800..a780106d816 100644 --- a/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md +++ b/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Create and use CComPtr and CComQIPtr ins title: "How to: Create and use CComPtr and CComQIPtr instances" ms.custom: "how-to" ms.date: "11/19/2019" -ms.assetid: b0356cfb-12cc-4ee8-b988-8311ed1ab5e0 --- # How to: Create and use CComPtr and CComQIPtr instances @@ -19,7 +18,7 @@ The following example shows how to use `CComPtr` to instantiate a COM object and `CComPtr` and its relatives are part of the ATL and are defined in \. `_com_ptr_t` is declared in \. The compiler creates specializations of `_com_ptr_t` when it generates wrapper classes for type libraries. -## Example: CComQIPt +## Example: CComQIPtr ATL also provides `CComQIPtr`, which has a simpler syntax for querying a COM object to retrieve an additional interface. However, we recommend `CComPtr` because it does everything that `CComQIPtr` can do and is semantically more consistent with raw COM interface pointers. If you use a `CComPtr` to query for an interface, the new interface pointer is placed in an out parameter. If the call fails, an HRESULT is returned, which is the typical COM pattern. With `CComQIPtr`, the return value is the pointer itself, and if the call fails, the internal HRESULT return value cannot be accessed. The following two lines show how the error handling mechanisms in `CComPtr` and `CComQIPtr` differ. diff --git a/docs/cpp/lvalues-and-rvalues-visual-cpp.md b/docs/cpp/lvalues-and-rvalues-visual-cpp.md index 0fb47aa4e20..ad2e8ebae47 100644 --- a/docs/cpp/lvalues-and-rvalues-visual-cpp.md +++ b/docs/cpp/lvalues-and-rvalues-visual-cpp.md @@ -27,7 +27,7 @@ An lvalue has an address that your program can access. Examples of lvalue expres A prvalue expression has no address that is accessible by your program. Examples of prvalue expressions include literals, function calls that return a nonreference type, and temporary objects that are created during expression evaluation but accessible only by the compiler. -An xvalue expression has an address that no longer accessible by your program but can be used to initialize an rvalue reference, which provides access to the expression. Examples include function calls that return an rvalue reference, and the array subscript, member and pointer to member expressions where the array or object is an rvalue reference. +An xvalue expression has an address that is no longer accessible by your program but can be used to initialize an rvalue reference, which provides access to the expression. Examples include function calls that return an rvalue reference, and the array subscript, member and pointer to member expressions where the array or object is an rvalue reference. ## Example diff --git a/docs/parallel/openmp/reference/openmp-directives.md b/docs/parallel/openmp/reference/openmp-directives.md index 2e841d21386..ef1fd1944d8 100644 --- a/docs/parallel/openmp/reference/openmp-directives.md +++ b/docs/parallel/openmp/reference/openmp-directives.md @@ -28,7 +28,7 @@ For main thread and synchronization: |[master](#master)|Specifies that only the main thread should execute a section of the program.| |[critical](#critical)|Specifies that code is only executed on one thread at a time.| |[barrier](#barrier)|Synchronizes all threads in a team; all threads pause at the barrier, until all threads execute the barrier.| -|[atomic](#atomic)|Specifies that a memory location that will be updated atomically.| +|[atomic](#atomic)|Specifies that a memory location will be updated atomically.| |[flush](#flush-openmp)|Specifies that all threads have the same view of memory for all shared objects.| |[ordered](#ordered-openmp-directives)|Specifies that code under a parallelized `for` loop should be executed like a sequential loop.| diff --git a/docs/preprocessor/optimize.md b/docs/preprocessor/optimize.md index ddcd04b8333..f8dd4c96252 100644 --- a/docs/preprocessor/optimize.md +++ b/docs/preprocessor/optimize.md @@ -1,7 +1,7 @@ --- description: "Learn more about: optimize pragma" title: "optimize pragma" -ms.date: 01/22/2021 +ms.date: 07/25/2025 f1_keywords: ["vc-pragma.optimize", "optimize_CPP"] helpviewer_keywords: ["pragma, optimize", "optimize pragma"] no-loc: ["pragma"] @@ -25,8 +25,8 @@ The *optimization-list* can be zero or more of the parameters shown in the follo | Parameter(s) | Type of optimization | |--------------------|--------------------------| | **`g`** | Enable global optimizations. Deprecated. For more information, see [`/Og` (Global optimizations)](../build/reference/og-global-optimizations.md). | -| **`s`** or **`t`** | Specify short or fast sequences of machine code. | -| **`y`** | Generate frame pointers on the program stack. | +| **`s`** or **`t`** | Favor short or fast sequences of machine code. | +| **`y`** | Omit frame pointers on the program stack. | These parameters are the same letters used with the [`/O`](../build/reference/o-options-optimize-code.md) compiler options. For example, the following pragma is equivalent to the **`/Os`** compiler option: From 5073e7680733a9110e3014f89e2673e828ab4a7d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 26 Jul 2025 22:48:15 +0800 Subject: [PATCH 0527/1799] Add blockquotes for error messages in range [C2401, C2430] --- docs/error-messages/compiler-errors-1/compiler-error-c2401.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2402.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2403.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2404.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2405.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2406.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2407.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2408.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2409.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2410.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2411.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2412.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2413.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2414.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2415.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2417.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2418.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2419.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2420.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2421.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2422.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2423.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2424.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2425.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2426.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2427.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2428.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2430.md | 2 +- 28 files changed, 28 insertions(+), 28 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2401.md b/docs/error-messages/compiler-errors-1/compiler-error-c2401.md index 7a729d9dc0a..31c61490008 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2401.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2401.md @@ -8,6 +8,6 @@ ms.assetid: 4c237b34-f771-4106-93e2-82dae337f1e2 --- # Compiler Error C2401 -'identifier' : register must be base in 'context' +> 'identifier' : register must be base in 'context' The register used in an indirect memory operand must be a base register in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2402.md b/docs/error-messages/compiler-errors-1/compiler-error-c2402.md index 82a4fc4ea0e..8574a5f3841 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2402.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2402.md @@ -8,6 +8,6 @@ ms.assetid: 23fa63e1-ea9e-482f-be2e-a205c548ba69 --- # Compiler Error C2402 -'identifier' : register must be index in 'context' +> 'identifier' : register must be index in 'context' The register used in an indirect memory operand must be an index register in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2403.md b/docs/error-messages/compiler-errors-1/compiler-error-c2403.md index c570c28dd6f..93799fc4d77 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2403.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2403.md @@ -8,6 +8,6 @@ ms.assetid: add1f0ba-96b6-4df3-b53f-de1433d80c0c --- # Compiler Error C2403 -'identifier' : register must be base/index in 'context' +> 'identifier' : register must be base/index in 'context' The register used in an indirect memory operand must be a base or index register in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2404.md b/docs/error-messages/compiler-errors-1/compiler-error-c2404.md index 220f381937d..a42865478a3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2404.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2404.md @@ -8,6 +8,6 @@ ms.assetid: 51794d2f-404b-4d89-b3ea-fc5faa9c197d --- # Compiler Error C2404 -'identifier' : illegal register in 'context' +> 'identifier' : illegal register in 'context' This register is invalid in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2405.md b/docs/error-messages/compiler-errors-1/compiler-error-c2405.md index f0e40a3d19c..90843a3b3f3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2405.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2405.md @@ -8,6 +8,6 @@ ms.assetid: 14f6726d-e04b-4cce-8a85-4553fc38fcf7 --- # Compiler Error C2405 -illegal short forward reference with offset +> illegal short forward reference with offset Short forward references must refer to a label only. An additional offset cannot be used. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2406.md b/docs/error-messages/compiler-errors-1/compiler-error-c2406.md index 6c58cf2252d..68778ed63b0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2406.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2406.md @@ -8,6 +8,6 @@ ms.assetid: 9d3fbc4c-40bb-42c7-bfd7-7656c40e2065 --- # Compiler Error C2406 -'identifier' : name undefined in 'context' +> 'identifier' : name undefined in 'context' An undefined identifier is used with the `SIZE`, `LENGTH`, or member-selection (.) operator. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2407.md b/docs/error-messages/compiler-errors-1/compiler-error-c2407.md index d6e33a822d3..9f687837cc0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2407.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2407.md @@ -8,6 +8,6 @@ ms.assetid: faf38041-cf0f-4624-b6f8-30ce0e1efc1e --- # Compiler Error C2407 -illegal 'float' register in 'context' +> illegal 'float' register in 'context' An `NDP` register was specified in an invalid context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2408.md b/docs/error-messages/compiler-errors-1/compiler-error-c2408.md index 0206666f921..3f77bd65ad7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2408.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2408.md @@ -8,6 +8,6 @@ ms.assetid: 3dc4881a-3c33-4c4e-b18e-a1f0e21ea931 --- # Compiler Error C2408 -illegal type on PTR operator in 'context' +> illegal type on PTR operator in 'context' The first parameter of the `PTR` operator is not a legal type specification. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2409.md b/docs/error-messages/compiler-errors-1/compiler-error-c2409.md index 0cbc1b90364..64ed319bd1b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2409.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2409.md @@ -8,6 +8,6 @@ ms.assetid: 5d4aa952-0752-4412-b5c2-050dde0636f4 --- # Compiler Error C2409 -illegal type used as operator in 'context' +> illegal type used as operator in 'context' The type is not legal as an operator in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2410.md b/docs/error-messages/compiler-errors-1/compiler-error-c2410.md index 0e1729028bb..0a51c1ca9b9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2410.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2410.md @@ -8,7 +8,7 @@ ms.assetid: b69b2de1-56f3-4ebc-8913-04ac57ffe8a1 --- # Compiler Error C2410 -'identifier' : ambiguous member name in 'context' +> 'identifier' : ambiguous member name in 'context' The identifier is a member of more than one structure or union in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2411.md b/docs/error-messages/compiler-errors-1/compiler-error-c2411.md index f2683b3a880..0e2e1387de4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2411.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2411.md @@ -8,7 +8,7 @@ ms.assetid: 453317d3-0629-4b42-b8ea-3a0b39698ca5 --- # Compiler Error C2411 -'identifier' : illegal struct/union member in 'context' +> 'identifier' : illegal struct/union member in 'context' ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2412.md b/docs/error-messages/compiler-errors-1/compiler-error-c2412.md index 7f80cf5952c..28c729411c9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2412.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2412.md @@ -8,6 +8,6 @@ ms.assetid: d1842b89-da09-4c35-89a1-84dc844a9f3e --- # Compiler Error C2412 -'label' : case-insensitive label redefined +> 'label' : case-insensitive label redefined The label is defined more than once in the current function. Change the spelling of the label and its references. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2413.md b/docs/error-messages/compiler-errors-1/compiler-error-c2413.md index d48df5df859..a5e11cff2d0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2413.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2413.md @@ -8,6 +8,6 @@ ms.assetid: d0403952-f41e-4b21-840d-ab4e44171838 --- # Compiler Error C2413 -'token' : illegal align size +> 'token' : illegal align size The size used with the `ALIGN` directive is missing or outside the valid range. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2414.md b/docs/error-messages/compiler-errors-1/compiler-error-c2414.md index 1a4d8639a07..241c04c4d0a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2414.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2414.md @@ -8,7 +8,7 @@ ms.assetid: bbe94e03-862e-4990-b15e-544ae464727d --- # Compiler Error C2414 -illegal number of operands +> illegal number of operands ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2415.md b/docs/error-messages/compiler-errors-1/compiler-error-c2415.md index 73486e37299..9d8413f99da 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2415.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2415.md @@ -8,7 +8,7 @@ ms.assetid: f225c913-2bea-46b1-b096-3d358ac94a15 --- # Compiler Error C2415 -improper operand type +> improper operand type The opcode does not use operands of this type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2417.md b/docs/error-messages/compiler-errors-1/compiler-error-c2417.md index ad1ec1ba737..0f538689b95 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2417.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2417.md @@ -8,6 +8,6 @@ ms.assetid: 8f42d7a8-5289-4f56-8404-23e5243274d2 --- # Compiler Error C2417 -divide by zero in 'context' +> divide by zero in 'context' The parameter to the right of the division operator is zero in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2418.md b/docs/error-messages/compiler-errors-1/compiler-error-c2418.md index fd9efc9dec5..eff03ad7739 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2418.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2418.md @@ -8,7 +8,7 @@ ms.assetid: 00e4690f-04a0-4159-b358-b1e0664102c1 --- # Compiler Error C2418 -cannot delete browser file: filename +> cannot delete browser file: filename The compiler could not delete the browser file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2419.md b/docs/error-messages/compiler-errors-1/compiler-error-c2419.md index 1785a274a9a..95dca5db66e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2419.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2419.md @@ -8,6 +8,6 @@ ms.assetid: 51fe3195-34b6-445e-9f01-1e93e8714295 --- # Compiler Error C2419 -mod by zero in 'context' +> mod by zero in 'context' The parameter to the right of the `MOD` operator is zero in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2420.md b/docs/error-messages/compiler-errors-1/compiler-error-c2420.md index 9f3d63e7ea4..959160c038b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2420.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2420.md @@ -8,6 +8,6 @@ ms.assetid: cc11faab-a022-4702-ac8b-9864b916cfa2 --- # Compiler Error C2420 -'identifier' : illegal symbol in context +> 'identifier' : illegal symbol in context The identifier is invalid in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2421.md b/docs/error-messages/compiler-errors-1/compiler-error-c2421.md index 7df9ea0208f..d4f2a84be6c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2421.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2421.md @@ -8,6 +8,6 @@ ms.assetid: 0a9afb9f-60d8-4df7-b2ae-5c36e86df891 --- # Compiler Error C2421 -PTR operator used with register in 'context' +> PTR operator used with register in 'context' The `PTR` operator cannot be used with a **`register`** operand. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md index 3f23f41613c..c4ce8385734 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md @@ -8,7 +8,7 @@ ms.assetid: ef0ec302-4028-4778-b134-0b8cea4bcad9 --- # Compiler Error C2422 -illegal segment override in 'operand' +> illegal segment override in 'operand' Inline assembly code incorrectly uses a segment override operator (colon) on an operand. Possible causes include: diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md index 24f2acbd023..560a9fb4cd2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md @@ -8,7 +8,7 @@ ms.assetid: 8797fb8b-b58b-4add-b6e6-2a9a3cd9084d --- # Compiler Error C2423 -'number' : illegal scale +> 'number' : illegal scale Inline assembly code uses a number other than 1, 2, 4, or 8 to scale a register. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2424.md b/docs/error-messages/compiler-errors-1/compiler-error-c2424.md index 3e87ba06f89..ad8e61c364c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2424.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2424.md @@ -8,6 +8,6 @@ ms.assetid: 03613746-a324-4b8b-94c0-424e8b0aae94 --- # Compiler Error C2424 -'token' : improper expression in 'context' +> 'token' : improper expression in 'context' The token forms part of an incorrect expression in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md index a87f7c098d7..4dd4d656de8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md @@ -8,7 +8,7 @@ ms.assetid: 0ce59404-9aff-4e01-aa8d-27d23e92eb30 --- # Compiler Error C2425 -'token' :non-constant expression in 'context' +> 'token' :non-constant expression in 'context' The token forms part of a non-constant expression in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2426.md b/docs/error-messages/compiler-errors-1/compiler-error-c2426.md index fd4668b17ba..58aa8af1749 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2426.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2426.md @@ -8,6 +8,6 @@ ms.assetid: 3428aeed-3f78-4675-9bc4-5b72f50eaaf6 --- # Compiler Error C2426 -'token' : illegal operator in 'context' +> 'token' : illegal operator in 'context' The token cannot be used as an operator in this context. Index operators, for example, cannot be nested. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md index 8d570e65b0a..187339a726f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md @@ -8,7 +8,7 @@ ms.assetid: a7d421af-6180-40b4-b7a6-9f3bc7dfaaf9 --- # Compiler Error C2427 -'class' : cannot define class in this scope +> 'class' : cannot define class in this scope An attempt was made to define a nested class, but the nested class is a member of a base class, not the most containing class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md index d58660dd89f..a3580c7eac8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md @@ -8,7 +8,7 @@ ms.assetid: 74aa5714-e930-4f9e-9061-68ccce7f0d38 --- # Compiler Error C2428 -'operation' : not allowed on operand of type 'bool' +> 'operation' : not allowed on operand of type 'bool' You cannot apply a decrement operator to objects of type **`bool`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md index 93fb29b3ba4..5f9256fe04c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md @@ -8,7 +8,7 @@ ms.assetid: 07c20f76-63e1-4d22-b2a9-98b0d45c5cac --- # Compiler Error C2430 -more than one index register in 'identifier' +> more than one index register in 'identifier' More than one register is scaled. The compiler supports scaled indexing, but you can only scale one register. From 71aa7b204a792a7d0973c048e8ee41d658126348 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 26 Jul 2025 22:53:05 +0800 Subject: [PATCH 0528/1799] Add "Remarks" and "Example" headings for error references in range [C2401, C2430] --- docs/error-messages/compiler-errors-1/compiler-error-c2401.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2402.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2403.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2404.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2405.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2406.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2407.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2408.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2409.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2410.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2412.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2413.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2415.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2417.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2418.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2419.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2420.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2421.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2422.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2423.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2424.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2425.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2426.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2427.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2428.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2429.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2430.md | 2 ++ 27 files changed, 66 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2401.md b/docs/error-messages/compiler-errors-1/compiler-error-c2401.md index 31c61490008..90ee30975a3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2401.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2401.md @@ -10,4 +10,6 @@ ms.assetid: 4c237b34-f771-4106-93e2-82dae337f1e2 > 'identifier' : register must be base in 'context' +## Remarks + The register used in an indirect memory operand must be a base register in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2402.md b/docs/error-messages/compiler-errors-1/compiler-error-c2402.md index 8574a5f3841..5423d1ca716 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2402.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2402.md @@ -10,4 +10,6 @@ ms.assetid: 23fa63e1-ea9e-482f-be2e-a205c548ba69 > 'identifier' : register must be index in 'context' +## Remarks + The register used in an indirect memory operand must be an index register in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2403.md b/docs/error-messages/compiler-errors-1/compiler-error-c2403.md index 93799fc4d77..64cb631e565 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2403.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2403.md @@ -10,4 +10,6 @@ ms.assetid: add1f0ba-96b6-4df3-b53f-de1433d80c0c > 'identifier' : register must be base/index in 'context' +## Remarks + The register used in an indirect memory operand must be a base or index register in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2404.md b/docs/error-messages/compiler-errors-1/compiler-error-c2404.md index a42865478a3..05f43ad4786 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2404.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2404.md @@ -10,4 +10,6 @@ ms.assetid: 51794d2f-404b-4d89-b3ea-fc5faa9c197d > 'identifier' : illegal register in 'context' +## Remarks + This register is invalid in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2405.md b/docs/error-messages/compiler-errors-1/compiler-error-c2405.md index 90843a3b3f3..5c444801b58 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2405.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2405.md @@ -10,4 +10,6 @@ ms.assetid: 14f6726d-e04b-4cce-8a85-4553fc38fcf7 > illegal short forward reference with offset +## Remarks + Short forward references must refer to a label only. An additional offset cannot be used. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2406.md b/docs/error-messages/compiler-errors-1/compiler-error-c2406.md index 68778ed63b0..24e6167a432 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2406.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2406.md @@ -10,4 +10,6 @@ ms.assetid: 9d3fbc4c-40bb-42c7-bfd7-7656c40e2065 > 'identifier' : name undefined in 'context' +## Remarks + An undefined identifier is used with the `SIZE`, `LENGTH`, or member-selection (.) operator. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2407.md b/docs/error-messages/compiler-errors-1/compiler-error-c2407.md index 9f687837cc0..be9446d25c0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2407.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2407.md @@ -10,4 +10,6 @@ ms.assetid: faf38041-cf0f-4624-b6f8-30ce0e1efc1e > illegal 'float' register in 'context' +## Remarks + An `NDP` register was specified in an invalid context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2408.md b/docs/error-messages/compiler-errors-1/compiler-error-c2408.md index 3f77bd65ad7..70bd64a6e89 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2408.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2408.md @@ -10,4 +10,6 @@ ms.assetid: 3dc4881a-3c33-4c4e-b18e-a1f0e21ea931 > illegal type on PTR operator in 'context' +## Remarks + The first parameter of the `PTR` operator is not a legal type specification. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2409.md b/docs/error-messages/compiler-errors-1/compiler-error-c2409.md index 64ed319bd1b..126fa3c9669 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2409.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2409.md @@ -10,4 +10,6 @@ ms.assetid: 5d4aa952-0752-4412-b5c2-050dde0636f4 > illegal type used as operator in 'context' +## Remarks + The type is not legal as an operator in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2410.md b/docs/error-messages/compiler-errors-1/compiler-error-c2410.md index 0a51c1ca9b9..dd54b32ba55 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2410.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2410.md @@ -10,6 +10,8 @@ ms.assetid: b69b2de1-56f3-4ebc-8913-04ac57ffe8a1 > 'identifier' : ambiguous member name in 'context' +## Remarks + The identifier is a member of more than one structure or union in this context. Use a structure or union specifier on the operand that caused the error. A structure or union specifier is an identifier of type **`struct`** or **`union`** (a **`typedef`** name or a variable of the same type as the structure or union being referenced). The specifier must be the left operand of the first member-selection operator (.) to use the operand. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2412.md b/docs/error-messages/compiler-errors-1/compiler-error-c2412.md index 28c729411c9..9f3b41a9356 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2412.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2412.md @@ -10,4 +10,6 @@ ms.assetid: d1842b89-da09-4c35-89a1-84dc844a9f3e > 'label' : case-insensitive label redefined +## Remarks + The label is defined more than once in the current function. Change the spelling of the label and its references. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2413.md b/docs/error-messages/compiler-errors-1/compiler-error-c2413.md index a5e11cff2d0..e5f96cbdc02 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2413.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2413.md @@ -10,4 +10,6 @@ ms.assetid: d0403952-f41e-4b21-840d-ab4e44171838 > 'token' : illegal align size +## Remarks + The size used with the `ALIGN` directive is missing or outside the valid range. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2415.md b/docs/error-messages/compiler-errors-1/compiler-error-c2415.md index 9d8413f99da..0b712cf9e7a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2415.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2415.md @@ -10,6 +10,8 @@ ms.assetid: f225c913-2bea-46b1-b096-3d358ac94a15 > improper operand type +## Remarks + The opcode does not use operands of this type. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2417.md b/docs/error-messages/compiler-errors-1/compiler-error-c2417.md index 0f538689b95..5731b73655b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2417.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2417.md @@ -10,4 +10,6 @@ ms.assetid: 8f42d7a8-5289-4f56-8404-23e5243274d2 > divide by zero in 'context' +## Remarks + The parameter to the right of the division operator is zero in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2418.md b/docs/error-messages/compiler-errors-1/compiler-error-c2418.md index eff03ad7739..1deec6d5ad5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2418.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2418.md @@ -10,6 +10,8 @@ ms.assetid: 00e4690f-04a0-4159-b358-b1e0664102c1 > cannot delete browser file: filename +## Remarks + The compiler could not delete the browser file. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2419.md b/docs/error-messages/compiler-errors-1/compiler-error-c2419.md index 95dca5db66e..ace7e4548d9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2419.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2419.md @@ -10,4 +10,6 @@ ms.assetid: 51fe3195-34b6-445e-9f01-1e93e8714295 > mod by zero in 'context' +## Remarks + The parameter to the right of the `MOD` operator is zero in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2420.md b/docs/error-messages/compiler-errors-1/compiler-error-c2420.md index 959160c038b..f3056b9f32a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2420.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2420.md @@ -10,4 +10,6 @@ ms.assetid: cc11faab-a022-4702-ac8b-9864b916cfa2 > 'identifier' : illegal symbol in context +## Remarks + The identifier is invalid in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2421.md b/docs/error-messages/compiler-errors-1/compiler-error-c2421.md index d4f2a84be6c..b6c7fce3ba1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2421.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2421.md @@ -10,4 +10,6 @@ ms.assetid: 0a9afb9f-60d8-4df7-b2ae-5c36e86df891 > PTR operator used with register in 'context' +## Remarks + The `PTR` operator cannot be used with a **`register`** operand. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md index c4ce8385734..b220fb50741 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md @@ -10,6 +10,8 @@ ms.assetid: ef0ec302-4028-4778-b134-0b8cea4bcad9 > illegal segment override in 'operand' +## Remarks + Inline assembly code incorrectly uses a segment override operator (colon) on an operand. Possible causes include: - The register preceding the operator is not a segment register. @@ -20,6 +22,8 @@ Inline assembly code incorrectly uses a segment override operator (colon) on an - The expression following the segment override operator is not an immediate operand or a memory operand. +## Example + The following sample generates C2422: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md index 560a9fb4cd2..080455a2f1b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md @@ -10,8 +10,12 @@ ms.assetid: 8797fb8b-b58b-4add-b6e6-2a9a3cd9084d > 'number' : illegal scale +## Remarks + Inline assembly code uses a number other than 1, 2, 4, or 8 to scale a register. +## Example + The following sample generates C2423: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2424.md b/docs/error-messages/compiler-errors-1/compiler-error-c2424.md index ad8e61c364c..aa099c7c663 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2424.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2424.md @@ -10,4 +10,6 @@ ms.assetid: 03613746-a324-4b8b-94c0-424e8b0aae94 > 'token' : improper expression in 'context' +## Remarks + The token forms part of an incorrect expression in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md index 4dd4d656de8..a59af7738b4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md @@ -10,10 +10,14 @@ ms.assetid: 0ce59404-9aff-4e01-aa8d-27d23e92eb30 > 'token' :non-constant expression in 'context' +## Remarks + The token forms part of a non-constant expression in this context. To fix this issue, replace the token with a constant literal or with a calculation. +## Example + The following sample generates C2425: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2426.md b/docs/error-messages/compiler-errors-1/compiler-error-c2426.md index 58aa8af1749..17d1b3c334b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2426.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2426.md @@ -10,4 +10,6 @@ ms.assetid: 3428aeed-3f78-4675-9bc4-5b72f50eaaf6 > 'token' : illegal operator in 'context' +## Remarks + The token cannot be used as an operator in this context. Index operators, for example, cannot be nested. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md index 187339a726f..df6c27fc6ad 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md @@ -10,8 +10,12 @@ ms.assetid: a7d421af-6180-40b4-b7a6-9f3bc7dfaaf9 > 'class' : cannot define class in this scope +## Remarks + An attempt was made to define a nested class, but the nested class is a member of a base class, not the most containing class. +## Example + The following sample generates C2427: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md index a3580c7eac8..a9c81083773 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md @@ -10,8 +10,12 @@ ms.assetid: 74aa5714-e930-4f9e-9061-68ccce7f0d38 > 'operation' : not allowed on operand of type 'bool' +## Remarks + You cannot apply a decrement operator to objects of type **`bool`**. +## Example + The following sample generates C2428: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2429.md b/docs/error-messages/compiler-errors-1/compiler-error-c2429.md index 6b465a254d7..341a0e353fc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2429.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2429.md @@ -10,8 +10,12 @@ ms.assetid: 57ff6df9-5cf1-49f3-8bd8-4e550dfd65a0 > '*language feature*' requires compiler flag '*compiler option*' +## Remarks + The language feature requires a specific compiler option for support. +## Example + The error **C2429: language feature 'nested-namespace-definition' requires compiler flag '/std:c++17'** is generated if you try to define a *compound namespace*, a namespace that contains one or more scope-nested namespace names, starting in Visual Studio 2015 Update 5. (In Visual Studio 2017 version 15.3, the **`/std:c++latest`** switch is required.) Compound namespace definitions are not allowed in C++ prior to C++17. The compiler supports compound namespace definitions when the [`/std:c++17`](../../build/reference/std-specify-language-standard-version.md) compiler option is specified: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md index 5f9256fe04c..fc0d4be151b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md @@ -10,6 +10,8 @@ ms.assetid: 07c20f76-63e1-4d22-b2a9-98b0d45c5cac > more than one index register in 'identifier' +## Remarks + More than one register is scaled. The compiler supports scaled indexing, but you can only scale one register. ## Example From d7c7050a24fd3e08334e30dd72b426a12437a00e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 26 Jul 2025 22:54:36 +0800 Subject: [PATCH 0529/1799] Replace term "sample" with "example" for error references in range [C2401, C2430] --- docs/error-messages/compiler-errors-1/compiler-error-c2422.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2423.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2425.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2427.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2428.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2430.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md index b220fb50741..5be9a9269eb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md @@ -24,7 +24,7 @@ Inline assembly code incorrectly uses a segment override operator (colon) on an ## Example -The following sample generates C2422: +The following example generates C2422: ```cpp // C2422.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md index 080455a2f1b..b1a4d69da7e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md @@ -16,7 +16,7 @@ Inline assembly code uses a number other than 1, 2, 4, or 8 to scale a register. ## Example -The following sample generates C2423: +The following example generates C2423: ```cpp // C2423.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md index a59af7738b4..879df7d9ef1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md @@ -18,7 +18,7 @@ To fix this issue, replace the token with a constant literal or with a calculati ## Example -The following sample generates C2425: +The following example generates C2425: ```cpp // C2425.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md index df6c27fc6ad..c69d4d14153 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md @@ -16,7 +16,7 @@ An attempt was made to define a nested class, but the nested class is a member o ## Example -The following sample generates C2427: +The following example generates C2427: ```cpp // C2427.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md index a9c81083773..53f328eabbe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md @@ -16,7 +16,7 @@ You cannot apply a decrement operator to objects of type **`bool`**. ## Example -The following sample generates C2428: +The following example generates C2428: ```cpp // C2428.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md index fc0d4be151b..ed6cb3e904c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md @@ -16,7 +16,7 @@ More than one register is scaled. The compiler supports scaled indexing, but you ## Example -The following sample generates C2430. +The following example generates C2430. ```cpp // C2430.cpp From 117e94cc73c21e0767daf86daad7774b8a6142f2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 26 Jul 2025 22:58:55 +0800 Subject: [PATCH 0530/1799] Update metadata for error references in range [C2401, C2430] --- .../error-messages/compiler-errors-1/compiler-error-c2401.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2402.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2403.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2404.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2405.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2406.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2407.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2408.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2409.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2410.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2411.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2412.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2413.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2414.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2415.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2417.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2418.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2419.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2420.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2421.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2422.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2423.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2424.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2425.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2426.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2427.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2428.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2429.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2430.md | 5 ++--- 29 files changed, 58 insertions(+), 87 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2401.md b/docs/error-messages/compiler-errors-1/compiler-error-c2401.md index 90ee30975a3..de3de95c5ea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2401.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2401.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2401" title: "Compiler Error C2401" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2401" +ms.date: 11/04/2016 f1_keywords: ["C2401"] helpviewer_keywords: ["C2401"] -ms.assetid: 4c237b34-f771-4106-93e2-82dae337f1e2 --- # Compiler Error C2401 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2402.md b/docs/error-messages/compiler-errors-1/compiler-error-c2402.md index 5423d1ca716..18f1900886b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2402.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2402.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2402" title: "Compiler Error C2402" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2402" +ms.date: 11/04/2016 f1_keywords: ["C2402"] helpviewer_keywords: ["C2402"] -ms.assetid: 23fa63e1-ea9e-482f-be2e-a205c548ba69 --- # Compiler Error C2402 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2403.md b/docs/error-messages/compiler-errors-1/compiler-error-c2403.md index 64cb631e565..3526871fd49 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2403.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2403.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2403" title: "Compiler Error C2403" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2403" +ms.date: 11/04/2016 f1_keywords: ["C2403"] helpviewer_keywords: ["C2403"] -ms.assetid: add1f0ba-96b6-4df3-b53f-de1433d80c0c --- # Compiler Error C2403 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2404.md b/docs/error-messages/compiler-errors-1/compiler-error-c2404.md index 05f43ad4786..3bb8a4dfb3a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2404.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2404.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2404" title: "Compiler Error C2404" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2404" +ms.date: 11/04/2016 f1_keywords: ["C2404"] helpviewer_keywords: ["C2404"] -ms.assetid: 51794d2f-404b-4d89-b3ea-fc5faa9c197d --- # Compiler Error C2404 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2405.md b/docs/error-messages/compiler-errors-1/compiler-error-c2405.md index 5c444801b58..e8fe1a73261 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2405.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2405.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2405" title: "Compiler Error C2405" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2405" +ms.date: 11/04/2016 f1_keywords: ["C2405"] helpviewer_keywords: ["C2405"] -ms.assetid: 14f6726d-e04b-4cce-8a85-4553fc38fcf7 --- # Compiler Error C2405 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2406.md b/docs/error-messages/compiler-errors-1/compiler-error-c2406.md index 24e6167a432..4b0c6c99dfa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2406.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2406.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2406" title: "Compiler Error C2406" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2406" +ms.date: 11/04/2016 f1_keywords: ["C2406"] helpviewer_keywords: ["C2406"] -ms.assetid: 9d3fbc4c-40bb-42c7-bfd7-7656c40e2065 --- # Compiler Error C2406 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2407.md b/docs/error-messages/compiler-errors-1/compiler-error-c2407.md index be9446d25c0..f554591dff2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2407.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2407.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2407" title: "Compiler Error C2407" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2407" +ms.date: 11/04/2016 f1_keywords: ["C2407"] helpviewer_keywords: ["C2407"] -ms.assetid: faf38041-cf0f-4624-b6f8-30ce0e1efc1e --- # Compiler Error C2407 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2408.md b/docs/error-messages/compiler-errors-1/compiler-error-c2408.md index 70bd64a6e89..d7f4e75d63f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2408.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2408.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2408" title: "Compiler Error C2408" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2408" +ms.date: 11/04/2016 f1_keywords: ["C2408"] helpviewer_keywords: ["C2408"] -ms.assetid: 3dc4881a-3c33-4c4e-b18e-a1f0e21ea931 --- # Compiler Error C2408 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2409.md b/docs/error-messages/compiler-errors-1/compiler-error-c2409.md index 126fa3c9669..f067880298e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2409.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2409.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2409" title: "Compiler Error C2409" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2409" +ms.date: 11/04/2016 f1_keywords: ["C2409"] helpviewer_keywords: ["C2409"] -ms.assetid: 5d4aa952-0752-4412-b5c2-050dde0636f4 --- # Compiler Error C2409 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2410.md b/docs/error-messages/compiler-errors-1/compiler-error-c2410.md index dd54b32ba55..497da598ce8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2410.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2410.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2410" title: "Compiler Error C2410" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2410" +ms.date: 11/04/2016 f1_keywords: ["C2410"] helpviewer_keywords: ["C2410"] -ms.assetid: b69b2de1-56f3-4ebc-8913-04ac57ffe8a1 --- # Compiler Error C2410 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2411.md b/docs/error-messages/compiler-errors-1/compiler-error-c2411.md index 0e2e1387de4..ddeca9c353c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2411.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2411.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2411" title: "Compiler Error C2411" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2411" +ms.date: 11/04/2016 f1_keywords: ["C2411"] helpviewer_keywords: ["C2411"] -ms.assetid: 453317d3-0629-4b42-b8ea-3a0b39698ca5 --- # Compiler Error C2411 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2412.md b/docs/error-messages/compiler-errors-1/compiler-error-c2412.md index 9f3b41a9356..6b82d8b7cb2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2412.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2412.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2412" title: "Compiler Error C2412" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2412" +ms.date: 11/04/2016 f1_keywords: ["C2412"] helpviewer_keywords: ["C2412"] -ms.assetid: d1842b89-da09-4c35-89a1-84dc844a9f3e --- # Compiler Error C2412 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2413.md b/docs/error-messages/compiler-errors-1/compiler-error-c2413.md index e5f96cbdc02..8bda57669c2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2413.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2413.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2413" title: "Compiler Error C2413" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2413" +ms.date: 11/04/2016 f1_keywords: ["C2413"] helpviewer_keywords: ["C2413"] -ms.assetid: d0403952-f41e-4b21-840d-ab4e44171838 --- # Compiler Error C2413 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2414.md b/docs/error-messages/compiler-errors-1/compiler-error-c2414.md index 241c04c4d0a..d504db15d26 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2414.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2414.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2414" title: "Compiler Error C2414" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2414" +ms.date: 11/04/2016 f1_keywords: ["C2414"] helpviewer_keywords: ["C2414"] -ms.assetid: bbe94e03-862e-4990-b15e-544ae464727d --- # Compiler Error C2414 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2415.md b/docs/error-messages/compiler-errors-1/compiler-error-c2415.md index 0b712cf9e7a..d393c9ad04e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2415.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2415.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2415" title: "Compiler Error C2415" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2415" +ms.date: 11/04/2016 f1_keywords: ["C2415"] helpviewer_keywords: ["C2415"] -ms.assetid: f225c913-2bea-46b1-b096-3d358ac94a15 --- # Compiler Error C2415 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2417.md b/docs/error-messages/compiler-errors-1/compiler-error-c2417.md index 5731b73655b..2627c37262a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2417.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2417.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2417" title: "Compiler Error C2417" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2417" +ms.date: 11/04/2016 f1_keywords: ["C2417"] helpviewer_keywords: ["C2417"] -ms.assetid: 8f42d7a8-5289-4f56-8404-23e5243274d2 --- # Compiler Error C2417 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2418.md b/docs/error-messages/compiler-errors-1/compiler-error-c2418.md index 1deec6d5ad5..0134d570d69 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2418.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2418.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2418" title: "Compiler Error C2418" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2418" +ms.date: 11/04/2016 f1_keywords: ["C2418"] helpviewer_keywords: ["C2418"] -ms.assetid: 00e4690f-04a0-4159-b358-b1e0664102c1 --- # Compiler Error C2418 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2419.md b/docs/error-messages/compiler-errors-1/compiler-error-c2419.md index ace7e4548d9..5b39fcc3e27 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2419.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2419.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2419" title: "Compiler Error C2419" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2419" +ms.date: 11/04/2016 f1_keywords: ["C2419"] helpviewer_keywords: ["C2419"] -ms.assetid: 51fe3195-34b6-445e-9f01-1e93e8714295 --- # Compiler Error C2419 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2420.md b/docs/error-messages/compiler-errors-1/compiler-error-c2420.md index f3056b9f32a..cfe19fb2e68 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2420.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2420.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2420" title: "Compiler Error C2420" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2420" +ms.date: 11/04/2016 f1_keywords: ["C2420"] helpviewer_keywords: ["C2420"] -ms.assetid: cc11faab-a022-4702-ac8b-9864b916cfa2 --- # Compiler Error C2420 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2421.md b/docs/error-messages/compiler-errors-1/compiler-error-c2421.md index b6c7fce3ba1..e55242b045f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2421.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2421.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2421" title: "Compiler Error C2421" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2421" +ms.date: 11/04/2016 f1_keywords: ["C2421"] helpviewer_keywords: ["C2421"] -ms.assetid: 0a9afb9f-60d8-4df7-b2ae-5c36e86df891 --- # Compiler Error C2421 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md index 5be9a9269eb..5bec6948265 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2422" title: "Compiler Error C2422" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2422" +ms.date: 11/04/2016 f1_keywords: ["C2422"] helpviewer_keywords: ["C2422"] -ms.assetid: ef0ec302-4028-4778-b134-0b8cea4bcad9 --- # Compiler Error C2422 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md index b1a4d69da7e..903fb38c3e5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2423" title: "Compiler Error C2423" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2423" +ms.date: 11/04/2016 f1_keywords: ["C2423"] helpviewer_keywords: ["C2423"] -ms.assetid: 8797fb8b-b58b-4add-b6e6-2a9a3cd9084d --- # Compiler Error C2423 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2424.md b/docs/error-messages/compiler-errors-1/compiler-error-c2424.md index aa099c7c663..8828b961d38 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2424.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2424.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2424" title: "Compiler Error C2424" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2424" +ms.date: 11/04/2016 f1_keywords: ["C2424"] helpviewer_keywords: ["C2424"] -ms.assetid: 03613746-a324-4b8b-94c0-424e8b0aae94 --- # Compiler Error C2424 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md index 879df7d9ef1..27430083843 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2425" title: "Compiler Error C2425" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2425" +ms.date: 11/04/2016 f1_keywords: ["C2425"] helpviewer_keywords: ["C2425"] -ms.assetid: 0ce59404-9aff-4e01-aa8d-27d23e92eb30 --- # Compiler Error C2425 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2426.md b/docs/error-messages/compiler-errors-1/compiler-error-c2426.md index 17d1b3c334b..8f4bc8c7f20 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2426.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2426.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2426" title: "Compiler Error C2426" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2426" +ms.date: 11/04/2016 f1_keywords: ["C2426"] helpviewer_keywords: ["C2426"] -ms.assetid: 3428aeed-3f78-4675-9bc4-5b72f50eaaf6 --- # Compiler Error C2426 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md index c69d4d14153..bd48ac4560f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2427" title: "Compiler Error C2427" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2427" +ms.date: 11/04/2016 f1_keywords: ["C2427"] helpviewer_keywords: ["C2427"] -ms.assetid: a7d421af-6180-40b4-b7a6-9f3bc7dfaaf9 --- # Compiler Error C2427 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md index 53f328eabbe..285e59c87ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2428" title: "Compiler Error C2428" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2428" +ms.date: 11/04/2016 f1_keywords: ["C2428"] helpviewer_keywords: ["C2428"] -ms.assetid: 74aa5714-e930-4f9e-9061-68ccce7f0d38 --- # Compiler Error C2428 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2429.md b/docs/error-messages/compiler-errors-1/compiler-error-c2429.md index 341a0e353fc..5e90b4c64ca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2429.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2429.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2429" title: "Compiler Error C2429" -ms.date: "11/16/2017" +description: "Learn more about: Compiler Error C2429" +ms.date: 11/16/2017 f1_keywords: ["C2429"] helpviewer_keywords: ["C2429"] -ms.assetid: 57ff6df9-5cf1-49f3-8bd8-4e550dfd65a0 --- # Compiler Error C2429 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md index ed6cb3e904c..931d37287a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2430" title: "Compiler Error C2430" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2430" +ms.date: 11/04/2016 f1_keywords: ["C2430"] helpviewer_keywords: ["C2430"] -ms.assetid: 07c20f76-63e1-4d22-b2a9-98b0d45c5cac --- # Compiler Error C2430 From 5fba2f4f18c597b51d2d0a68636aba1e9cd59595 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 18:31:20 +0800 Subject: [PATCH 0531/1799] Add "Remarks" heading in C4235 warning reference --- .../compiler-warnings/compiler-warning-level-4-c4235.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md index b555d0df57e..736ff9fbd1f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4235"] > nonstandard extension used: '*keyword*' keyword not supported on this architecture +## Remarks + The compiler doesn't support the keyword you used on the architecture your build is targeting. This warning is always issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable. From a4b8091208f9f0394c882bef871d888a0a8cea25 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 18:40:50 +0800 Subject: [PATCH 0532/1799] Extend remarks in C4235 warning reference --- .../compiler-warnings/compiler-warning-level-4-c4235.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md index 736ff9fbd1f..3a58dd4bec8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md @@ -11,6 +11,6 @@ helpviewer_keywords: ["C4235"] ## Remarks -The compiler doesn't support the keyword you used on the architecture your build is targeting. +The compiler doesn't support the keyword you used on the architecture your build is targeting. For example, the [`__asm`](../../assembler/inline/asm.md) keyword is not supported in x64 builds. This warning is always issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable. From a0da34ab27f4f83b428f26c702612f80fe152bbd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 18:52:32 +0800 Subject: [PATCH 0533/1799] Add example in C4235 warning reference --- .../compiler-warning-level-4-c4235.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md index 3a58dd4bec8..1af307e236d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md @@ -14,3 +14,17 @@ helpviewer_keywords: ["C4235"] The compiler doesn't support the keyword you used on the architecture your build is targeting. For example, the [`__asm`](../../assembler/inline/asm.md) keyword is not supported in x64 builds. This warning is always issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable. + +## Example + +The following example generates C4235 as the [Inline Assembler](../../assembler/inline/inline-assembler.md) is only supported on x86: + +```cpp +// C4235.cpp +// processor: x64 + +int main() +{ + __asm nop // C4235 +} +``` From 3c6dea46c66a52392701c110d12d4bd720770582 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 18:54:11 +0800 Subject: [PATCH 0534/1799] Update metadata in C4235 warning reference --- .../compiler-warnings/compiler-warning-level-4-c4235.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md index 1af307e236d..5cb82b34371 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4235" title: "Compiler Warning (level 1, Error) C4235" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4235" +ms.date: 07/27/2025 f1_keywords: ["C4235"] helpviewer_keywords: ["C4235"] --- From dd09025c0f870ac428fd5480c12d7aa2849e1a7b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 21:30:53 +0800 Subject: [PATCH 0535/1799] Normalize single space before `sup` element in "Keywords (C++)" topic --- docs/cpp/keywords-cpp.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/cpp/keywords-cpp.md b/docs/cpp/keywords-cpp.md index 0bb5fff6c04..e68b54476ca 100644 --- a/docs/cpp/keywords-cpp.md +++ b/docs/cpp/keywords-cpp.md @@ -166,11 +166,11 @@ The **`__based`** keyword has limited uses for 32-bit and 64-bit target compilat [`__m64`](m64.md)\ [`__multiple_inheritance`](inheritance-keywords.md) e\ [`__ptr32`](ptr32-ptr64.md) e\ - [`__ptr64`](ptr32-ptr64.md)e\ + [`__ptr64`](ptr32-ptr64.md) e\ [`__raise`](raise.md)\ [`__restrict`](extension-restrict.md) e\ - [`__single_inheritance`](inheritance-keywords.md)e\ - [`__sptr`](sptr-uptr.md)e\ + [`__single_inheritance`](inheritance-keywords.md) e\ + [`__sptr`](sptr-uptr.md) e\ [`__stdcall`](stdcall.md) e :::column-end::: :::column::: From 743d5b40c0258812f638b94749dd387d222513fd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 21:34:02 +0800 Subject: [PATCH 0536/1799] Nits for "Keywords (C++)" topic --- docs/cpp/keywords-cpp.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/cpp/keywords-cpp.md b/docs/cpp/keywords-cpp.md index e68b54476ca..8d9269c07fb 100644 --- a/docs/cpp/keywords-cpp.md +++ b/docs/cpp/keywords-cpp.md @@ -115,9 +115,9 @@ Keywords are predefined reserved identifiers that have special meanings. They ca :::column-end::: :::row-end::: -a The Microsoft-specific **`__asm`** keyword replaces C++ **`asm`** syntax. **`asm`** is reserved for compatibility with other C++ implementations, but not implemented. Use **`__asm`** for inline assembly on x86 targets. Microsoft C++ doesn't support Inline assembly for other targets. +a The Microsoft-specific **`__asm`** keyword replaces C++ **`asm`** syntax. **`asm`** is reserved for compatibility with other C++ implementations, but not implemented. Use **`__asm`** for inline assembly on x86 targets. Microsoft C++ doesn't support inline assembly for other targets. -b The extended operator synonyms are keywords when [`/permissive-`](../build/reference/permissive-standards-conformance.md) or [`/Za` \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) is specified. They aren't keywords when Microsoft extensions are enabled. +b The extended operator synonyms are keywords when [`/permissive-`](../build/reference/permissive-standards-conformance.md) or [`/Za` (Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) is specified. They aren't keywords when Microsoft extensions are enabled. c Supported when [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later (such as **`/std:c++latest`**) is specified. @@ -125,7 +125,7 @@ Keywords are predefined reserved identifiers that have special meanings. They ca In C++, identifiers that contain two consecutive underscores are reserved for compiler implementations. The Microsoft convention is to precede Microsoft-specific keywords with double underscores. These words can't be used as identifier names. -Microsoft extensions are enabled by default. To ensure that your programs are fully portable, you can disable Microsoft extensions by specifying the [`/permissive-`](../build/reference/permissive-standards-conformance.md) or [`/Za` \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) option during compilation. These options disable some Microsoft-specific keywords. +Microsoft extensions are enabled by default. To ensure that your programs are fully portable, you can disable Microsoft extensions by specifying the [`/permissive-`](../build/reference/permissive-standards-conformance.md) or [`/Za` (Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) option during compilation. These options disable some Microsoft-specific keywords. When Microsoft extensions are enabled, you can use the Microsoft-specific keywords in your programs. For ANSI conformance, these keywords are prefaced by a double underscore. For backward compatibility, single-underscore versions of many of the double-underscored keywords are supported. The **`__cdecl`** keyword is available with no leading underscore. @@ -191,7 +191,7 @@ The **`__based`** keyword has limited uses for 32-bit and 64-bit target compilat e For backward compatibility with previous versions, these keywords are available both with two leading underscores and a single leading underscore when Microsoft extensions are enabled (the default). -## Microsoft keywords in __declspec modifiers +## Microsoft keywords in `__declspec` modifiers These identifiers are extended attributes for the **`__declspec`** modifier. They're considered keywords within that context. From 5b9c9f65793451597d13f29ea0434d548a8759ef Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 21:55:14 +0800 Subject: [PATCH 0537/1799] Fix wrong language for `Output` code blocks --- docs/cpp/rvalue-reference-declarator-amp-amp.md | 6 +++--- docs/cpp/scope-visual-cpp.md | 2 +- .../using-insertion-operators-and-controlling-format.md | 2 +- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/cpp/rvalue-reference-declarator-amp-amp.md b/docs/cpp/rvalue-reference-declarator-amp-amp.md index c9dd311f112..2040d7e97c6 100644 --- a/docs/cpp/rvalue-reference-declarator-amp-amp.md +++ b/docs/cpp/rvalue-reference-declarator-amp-amp.md @@ -223,7 +223,7 @@ int main() This example produces the following output: -```cpp +```Output In g(const MemoryBlock&). In g(MemoryBlock&&). ``` @@ -266,7 +266,7 @@ int main() This example produces the following output: -```cpp +```Output In g(const MemoryBlock&). In g(MemoryBlock&&). ``` @@ -360,7 +360,7 @@ int main() This example produces the following output: -```cpp +```Output print: first print: second print: third diff --git a/docs/cpp/scope-visual-cpp.md b/docs/cpp/scope-visual-cpp.md index 6a735944423..1dbf86194d5 100644 --- a/docs/cpp/scope-visual-cpp.md +++ b/docs/cpp/scope-visual-cpp.md @@ -34,7 +34,7 @@ Block scope and name hiding The output from the program shown in the figure is: -```cpp +```Output i = 0 i = 7 j = 9 diff --git a/docs/standard-library/using-insertion-operators-and-controlling-format.md b/docs/standard-library/using-insertion-operators-and-controlling-format.md index e61172bb4dd..5ab72a90d66 100644 --- a/docs/standard-library/using-insertion-operators-and-controlling-format.md +++ b/docs/standard-library/using-insertion-operators-and-controlling-format.md @@ -165,7 +165,7 @@ Stan 4358.2 If you change the `ios::fixed` flag to `ios::scientific`, the program prints this: -```cpp +```Output Zoot 1.2e+00 Jimmy 3.5e+01 Al 6.5e+02 From f8cd8f85f27ba89bffb59121c41a2e3c8da767bc Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 21:56:43 +0800 Subject: [PATCH 0538/1799] Update metadata in 3 topics --- docs/cpp/rvalue-reference-declarator-amp-amp.md | 3 +-- docs/cpp/scope-visual-cpp.md | 5 ++--- .../using-insertion-operators-and-controlling-format.md | 2 +- 3 files changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/cpp/rvalue-reference-declarator-amp-amp.md b/docs/cpp/rvalue-reference-declarator-amp-amp.md index 2040d7e97c6..441521e11c2 100644 --- a/docs/cpp/rvalue-reference-declarator-amp-amp.md +++ b/docs/cpp/rvalue-reference-declarator-amp-amp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Rvalue reference declarator: &&" title: "Rvalue reference declarator: &&" +description: "Learn more about: Rvalue reference declarator: &&" ms.date: 09/27/2022 f1_keywords: ["&&"] helpviewer_keywords: ["&& rvalue reference declarator"] -ms.assetid: eab0ce3a-c5a3-4992-aa70-6a8ab1f7491d --- # Rvalue reference declarator: `&&` diff --git a/docs/cpp/scope-visual-cpp.md b/docs/cpp/scope-visual-cpp.md index 1dbf86194d5..3e160bde303 100644 --- a/docs/cpp/scope-visual-cpp.md +++ b/docs/cpp/scope-visual-cpp.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Scope (C++)" title: "Scope (C++)" -ms.date: "11/19/2018" +description: "Learn more about: Scope (C++)" +ms.date: 11/19/2018 helpviewer_keywords: ["classes [C++], scope", "scope [C++]", "function prototypes [C++], scope", "class scope", "prototype scope", "functions [C++], scope", "scope, C++ names"] -ms.assetid: 81fecbb0-338b-4325-8332-49f33e716352 --- # Scope (C++) diff --git a/docs/standard-library/using-insertion-operators-and-controlling-format.md b/docs/standard-library/using-insertion-operators-and-controlling-format.md index 5ab72a90d66..359347be9f4 100644 --- a/docs/standard-library/using-insertion-operators-and-controlling-format.md +++ b/docs/standard-library/using-insertion-operators-and-controlling-format.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Using Insertion Operators and Controlling Format" title: "Using Insertion Operators and Controlling Format" +description: "Learn more about: Using Insertion Operators and Controlling Format" ms.date: 10/07/2021 helpviewer_keywords: ["insertion operators"] --- From 409e8a007684547625f5b8048ef697e98c1b2056 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 22:05:27 +0800 Subject: [PATCH 0539/1799] Add blockquotes for error messages in range [C2431, C2460] --- docs/error-messages/compiler-errors-1/compiler-error-c2431.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2432.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2436.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2437.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2438.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2439.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2443.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2444.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2446.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2447.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2448.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2449.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2450.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2451.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2452.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2458.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2459.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2460.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md index bf087591be9..614abe70c1f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md @@ -8,7 +8,7 @@ ms.assetid: 88a5b648-c89f-47d1-a20e-63231ab4f0f7 --- # Compiler Error C2431 -illegal index register in 'identifier' +> illegal index register in 'identifier' The ESP register is scaled or used as both index and base register. The SIB encoding for the x86 processor does not allow either. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md index 03d4ba54d10..6c9c0dc3fba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md @@ -8,7 +8,7 @@ ms.assetid: 0e3326e8-cab1-45a5-b48d-61edd33793e8 --- # Compiler Error C2432 -illegal reference to 16-bit data in 'identifier' +> illegal reference to 16-bit data in 'identifier' A 16-bit register is used as an index or base register. The compiler does not support referencing 16-bit data. 16-bit registers cannot be used as index or base registers when compiling for 32-bit code. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md index 2c21782820b..15c12afe78b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md @@ -8,7 +8,7 @@ ms.assetid: ca4cc813-bc1d-4c0a-9a2c-3a5fe673d084 --- # Compiler Error C2436 -'identifier' : member function or nested class in constructor initializer list +> 'identifier' : member function or nested class in constructor initializer list Member functions or local classes in the constructor initializer list cannot be initialized. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md index ad2838f1954..9a54484d7de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md @@ -8,7 +8,7 @@ ms.assetid: 2d2b3c6c-856a-4b27-ae10-64813b3e5483 --- # Compiler Error C2437 -'identifier' : already initialized +> 'identifier' : already initialized An object can be initialized only once. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md index 5c50bbcf063..d6e793f1e69 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md @@ -8,7 +8,7 @@ ms.assetid: 3a0ab3ba-d0e4-4d8f-971d-e503397cc827 --- # Compiler Error C2438 -'identifier' : cannot initialize static class data via constructor +> 'identifier' : cannot initialize static class data via constructor A constructor is used to initialize a static member of a class. Static members must be initialized in a definition outside the class declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2439.md b/docs/error-messages/compiler-errors-1/compiler-error-c2439.md index 3afca77e01e..24f16ef64c2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2439.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2439.md @@ -8,7 +8,7 @@ ms.assetid: 3c5dbe5c-b7d3-4bb0-8619-92f6e280461e --- # Compiler Error C2439 -'identifier' : member could not be initialized +> 'identifier' : member could not be initialized A class, structure, or union member cannot be initialized. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md index 15026511214..690bb543446 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md @@ -8,7 +8,7 @@ ms.assetid: 315330d5-24bc-4193-a531-0642095be58f --- # Compiler Error C2443 -operand size conflict +> operand size conflict The instruction requires operands to be the same size. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2444.md b/docs/error-messages/compiler-errors-1/compiler-error-c2444.md index 94cb7948fa9..7f064161d92 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2444.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2444.md @@ -8,7 +8,7 @@ ms.assetid: 6339ed82-caad-45d3-a8ff-6c746589fd03 --- # Compiler Error C2444 -'identifier' : used ANSI prototype, found 'type', expected '{' or ';' +> 'identifier' : used ANSI prototype, found 'type', expected '{' or ';' The function prototype is followed by a type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2446.md b/docs/error-messages/compiler-errors-1/compiler-error-c2446.md index de76e6c65ac..e7edf1eaf1f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2446.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2446.md @@ -8,6 +8,6 @@ ms.assetid: 4f70dd11-6baf-4b92-9a08-f88f65ffa199 --- # Compiler Error C2446 -'operator' : no conversion from 'type1' to 'type2' +> 'operator' : no conversion from 'type1' to 'type2' The compiler cannot convert `type1` to `type2`. The conversion may not make sense because it violates C/C++ semantics. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md index e88e1565f63..6a738d9d19c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md @@ -8,7 +8,7 @@ ms.assetid: d1bd6e9a-ee42-4510-ae5e-6b0378f7b931 --- # Compiler Error C2447 -'{' : missing function header (old-style formal list?) +> '{' : missing function header (old-style formal list?) The compiler encountered an unexpected open brace at global scope. In most cases, this is caused by a badly-formed function header, a misplaced declaration, or a stray semi-colon. To resolve this issue, verify that the open brace follows a correctly-formed function header, and is not preceded by a declaration or a stray semi-colon. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md index 49c7aeafb64..f8274d9aab4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md @@ -8,7 +8,7 @@ ms.assetid: e255df3c-f861-4b4d-a193-8768cef061a5 --- # Compiler Error C2448 -'identifier' : function-style initializer appears to be a function definition +> 'identifier' : function-style initializer appears to be a function definition The function definition is incorrect. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md index 938093971e8..f8c9f76efbe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md @@ -8,7 +8,7 @@ ms.assetid: 544bf0b6-daa0-40e8-9f21-8e583d472a2d --- # Compiler Error C2449 -found '{' at file scope (missing function header?) +> found '{' at file scope (missing function header?) An open brace occurs at file scope. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md index ac6c260ef86..a3ddd820916 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2450"] --- # Compiler Error C2450 -switch expression of type 'type' is illegal +> switch expression of type 'type' is illegal The **`switch`** expression evaluates to an invalid type. It must evaluate to an integer type or a class type with unambiguous conversion to an integer type. If it evaluates to a user-defined type, you must supply a conversion operator. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md index cc99c291bb0..aab2d1a08ea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md @@ -8,7 +8,7 @@ ms.assetid: a64c93a5-ab8d-4d39-ae57-9ee7ef803036 --- # Compiler Error C2451 -conditional expression of type 'type' is illegal +> conditional expression of type 'type' is illegal The conditional expression evaluates to an integer type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md index f16f583de17..f636717e499 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md @@ -8,7 +8,7 @@ ms.assetid: a4ec7642-6660-4c7a-9866-853d1cc67daf --- # Compiler Error C2452 -'type' : invalid source type for safe_cast +> 'type' : invalid source type for safe_cast The source type for [safe_cast](../../extensions/safe-cast-cpp-component-extensions.md) was not valid. For example, all types in a `safe_cast` operation must be CLR types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md index ec96c8970fb..666d6fdc219 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md @@ -8,7 +8,7 @@ ms.assetid: ed21901f-1067-42f5-b275-19b480decf5c --- # Compiler Error C2458 -'identifier' : redefinition within definition +> 'identifier' : redefinition within definition A class, structure, union, or enumeration is redefined in its own declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md index 635f08cf2e5..26c7df62c2b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md @@ -8,7 +8,7 @@ ms.assetid: 81e29f4c-5b60-40fb-9557-1cdc630d77e8 --- # Compiler Error C2459 -'identifier' : is being defined; cannot add as an anonymous member +> 'identifier' : is being defined; cannot add as an anonymous member A class, structure, or union is redefined in its own scope by a member of an anonymous union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md index e6e7bdd164b..8aa35dca9ee 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md @@ -8,7 +8,7 @@ ms.assetid: d969fca9-3ac5-4e4e-88fc-df05510e2093 --- # Compiler Error C2460 -'identifier1' : uses 'identifier2', which is being defined +> 'identifier1' : uses 'identifier2', which is being defined A class or structure (`identifier2`) is declared as a member of itself (`identifier1`). Recursive definitions of classes and structures are not allowed. From c784665e14e8150afa2af861b95d8fbb3c11a0c6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 22:11:23 +0800 Subject: [PATCH 0540/1799] Add "Remarks" and "Example" headings for error references in range [C2431, C2460] --- docs/error-messages/compiler-errors-1/compiler-error-c2431.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2432.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2433.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2436.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2437.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2438.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2439.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2440.md | 4 ++-- docs/error-messages/compiler-errors-1/compiler-error-c2443.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2444.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2446.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2447.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2448.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2449.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2450.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2451.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2452.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2457.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2458.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2459.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2460.md | 4 ++++ 21 files changed, 72 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md index 614abe70c1f..c8e03ca57da 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md @@ -10,8 +10,12 @@ ms.assetid: 88a5b648-c89f-47d1-a20e-63231ab4f0f7 > illegal index register in 'identifier' +## Remarks + The ESP register is scaled or used as both index and base register. The SIB encoding for the x86 processor does not allow either. +## Example + The following sample generates C2431: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md index 6c9c0dc3fba..9258facd7bd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md @@ -10,8 +10,12 @@ ms.assetid: 0e3326e8-cab1-45a5-b48d-61edd33793e8 > illegal reference to 16-bit data in 'identifier' +## Remarks + A 16-bit register is used as an index or base register. The compiler does not support referencing 16-bit data. 16-bit registers cannot be used as index or base registers when compiling for 32-bit code. +## Example + The following sample generates C2432: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2433.md b/docs/error-messages/compiler-errors-1/compiler-error-c2433.md index 75ec0827854..64fa90a70b1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2433.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2433.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2433"] > '*identifier*': '*modifier*' not permitted on data declarations +## Remarks + The **`friend`**, **`virtual`**, and **`inline`** modifiers cannot be used for data declarations. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md index 15c12afe78b..9fef4cbc782 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md @@ -10,8 +10,12 @@ ms.assetid: ca4cc813-bc1d-4c0a-9a2c-3a5fe673d084 > 'identifier' : member function or nested class in constructor initializer list +## Remarks + Member functions or local classes in the constructor initializer list cannot be initialized. +## Example + The following sample generates C2436: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md index 9a54484d7de..82cee149198 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md @@ -10,8 +10,12 @@ ms.assetid: 2d2b3c6c-856a-4b27-ae10-64813b3e5483 > 'identifier' : already initialized +## Remarks + An object can be initialized only once. +## Example + The following sample generates C2437: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md index d6e793f1e69..9c2f6b4faa4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md @@ -10,8 +10,12 @@ ms.assetid: 3a0ab3ba-d0e4-4d8f-971d-e503397cc827 > 'identifier' : cannot initialize static class data via constructor +## Remarks + A constructor is used to initialize a static member of a class. Static members must be initialized in a definition outside the class declaration. +## Example + The following sample generates C2438: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2439.md b/docs/error-messages/compiler-errors-1/compiler-error-c2439.md index 24f16ef64c2..e24d5d39ec3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2439.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2439.md @@ -10,6 +10,8 @@ ms.assetid: 3c5dbe5c-b7d3-4bb0-8619-92f6e280461e > 'identifier' : member could not be initialized +## Remarks + A class, structure, or union member cannot be initialized. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2440.md b/docs/error-messages/compiler-errors-1/compiler-error-c2440.md index d12b621c4a4..4e4cd76d413 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2440.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2440.md @@ -11,10 +11,10 @@ no-loc: ["struct", "const"] > '*initializing*' : cannot convert from '*type1*' to '*type2*'\ > '*conversion*' : cannot convert from '*type1*' to '*type2*' -The compiler can't implicitly convert from *`type1`* to *`type2`*, or can't use the specified cast or conversion operator. - ## Remarks +The compiler can't implicitly convert from *`type1`* to *`type2`*, or can't use the specified cast or conversion operator. + The compiler generates C2440 when it can't convert from one type to another, either implicitly or by using the specified cast or conversion operator. There are many ways to generate this error. We've listed some common ones in the Examples section. ## Examples diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md index 690bb543446..b494fe93bb3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md @@ -10,8 +10,12 @@ ms.assetid: 315330d5-24bc-4193-a531-0642095be58f > operand size conflict +## Remarks + The instruction requires operands to be the same size. +## Example + The following sample generates C2443: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2444.md b/docs/error-messages/compiler-errors-1/compiler-error-c2444.md index 7f064161d92..ccf35d6e96c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2444.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2444.md @@ -10,6 +10,8 @@ ms.assetid: 6339ed82-caad-45d3-a8ff-6c746589fd03 > 'identifier' : used ANSI prototype, found 'type', expected '{' or ';' +## Remarks + The function prototype is followed by a type. This error can be caused by a missing semicolon or curly brace. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2446.md b/docs/error-messages/compiler-errors-1/compiler-error-c2446.md index e7edf1eaf1f..8dae8e651fc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2446.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2446.md @@ -10,4 +10,6 @@ ms.assetid: 4f70dd11-6baf-4b92-9a08-f88f65ffa199 > 'operator' : no conversion from 'type1' to 'type2' +## Remarks + The compiler cannot convert `type1` to `type2`. The conversion may not make sense because it violates C/C++ semantics. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md index 6a738d9d19c..82634bef0d5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md @@ -10,10 +10,14 @@ ms.assetid: d1bd6e9a-ee42-4510-ae5e-6b0378f7b931 > '{' : missing function header (old-style formal list?) +## Remarks + The compiler encountered an unexpected open brace at global scope. In most cases, this is caused by a badly-formed function header, a misplaced declaration, or a stray semi-colon. To resolve this issue, verify that the open brace follows a correctly-formed function header, and is not preceded by a declaration or a stray semi-colon. This error can also be caused by an old-style C-language formal argument list. To resolve this issue, refactor the argument list to use modern style—that is, enclosed in parentheses. +## Example + The following sample generates C2447: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md index f8274d9aab4..16be4eae932 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md @@ -10,10 +10,14 @@ ms.assetid: e255df3c-f861-4b4d-a193-8768cef061a5 > 'identifier' : function-style initializer appears to be a function definition +## Remarks + The function definition is incorrect. This error can be caused by an old-style C-language formal list. +## Example + The following sample generates C2448: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md index f8c9f76efbe..61810dbb3bc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md @@ -10,10 +10,14 @@ ms.assetid: 544bf0b6-daa0-40e8-9f21-8e583d472a2d > found '{' at file scope (missing function header?) +## Remarks + An open brace occurs at file scope. This error can be caused by a semicolon between a function header and the opening brace of the function definition. +## Example + The following sample generates C2499: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md index a3ddd820916..ddfc7488da0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2450"] > switch expression of type 'type' is illegal +## Remarks + The **`switch`** expression evaluates to an invalid type. It must evaluate to an integer type or a class type with unambiguous conversion to an integer type. If it evaluates to a user-defined type, you must supply a conversion operator. +## Example + The following sample generates C2450: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md index aab2d1a08ea..7e384af87cb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md @@ -10,8 +10,12 @@ ms.assetid: a64c93a5-ab8d-4d39-ae57-9ee7ef803036 > conditional expression of type 'type' is illegal +## Remarks + The conditional expression evaluates to an integer type. +## Example + The following sample generates C2451: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md index f636717e499..f0e037d227f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md @@ -10,8 +10,12 @@ ms.assetid: a4ec7642-6660-4c7a-9866-853d1cc67daf > 'type' : invalid source type for safe_cast +## Remarks + The source type for [safe_cast](../../extensions/safe-cast-cpp-component-extensions.md) was not valid. For example, all types in a `safe_cast` operation must be CLR types. +## Example + The following sample generates C2452: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2457.md b/docs/error-messages/compiler-errors-1/compiler-error-c2457.md index a60da33b7bb..8a4e90049fd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2457.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2457.md @@ -10,6 +10,8 @@ ms.assetid: 347e169d-23ad-434f-8836-5b09b53980ff > '*macro*': predefined macro cannot appear outside of a function body +## Remarks + You attempted to use a predefined macro, such as [`__FUNCTION__`](../../preprocessor/predefined-macros.md), in a global space. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md index 666d6fdc219..3d24e4459e4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md @@ -10,8 +10,12 @@ ms.assetid: ed21901f-1067-42f5-b275-19b480decf5c > 'identifier' : redefinition within definition +## Remarks + A class, structure, union, or enumeration is redefined in its own declaration. +## Example + The following sample generates C2458: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md index 26c7df62c2b..5b0db6fc492 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md @@ -10,8 +10,12 @@ ms.assetid: 81e29f4c-5b60-40fb-9557-1cdc630d77e8 > 'identifier' : is being defined; cannot add as an anonymous member +## Remarks + A class, structure, or union is redefined in its own scope by a member of an anonymous union. +## Example + The following sample generates C2459: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md index 8aa35dca9ee..74546fb97d5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md @@ -10,8 +10,12 @@ ms.assetid: d969fca9-3ac5-4e4e-88fc-df05510e2093 > 'identifier1' : uses 'identifier2', which is being defined +## Remarks + A class or structure (`identifier2`) is declared as a member of itself (`identifier1`). Recursive definitions of classes and structures are not allowed. +## Example + The following sample generates C2460: ```cpp From 8925559745c8a307646260f07e1228d4247f12c3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 22:13:32 +0800 Subject: [PATCH 0541/1799] Replace term "sample" with "example" for error references in range [C2431, C2460] --- .../compiler-errors-1/compiler-error-c2431.md | 2 +- .../compiler-errors-1/compiler-error-c2432.md | 2 +- .../compiler-errors-1/compiler-error-c2434.md | 2 +- .../compiler-errors-1/compiler-error-c2435.md | 2 +- .../compiler-errors-1/compiler-error-c2436.md | 2 +- .../compiler-errors-1/compiler-error-c2437.md | 2 +- .../compiler-errors-1/compiler-error-c2438.md | 2 +- .../compiler-errors-1/compiler-error-c2440.md | 20 +++++++++---------- .../compiler-errors-1/compiler-error-c2441.md | 2 +- .../compiler-errors-1/compiler-error-c2443.md | 2 +- .../compiler-errors-1/compiler-error-c2447.md | 2 +- .../compiler-errors-1/compiler-error-c2448.md | 2 +- .../compiler-errors-1/compiler-error-c2449.md | 2 +- .../compiler-errors-1/compiler-error-c2450.md | 2 +- .../compiler-errors-1/compiler-error-c2451.md | 2 +- .../compiler-errors-1/compiler-error-c2452.md | 2 +- .../compiler-errors-1/compiler-error-c2457.md | 2 +- .../compiler-errors-1/compiler-error-c2458.md | 2 +- .../compiler-errors-1/compiler-error-c2459.md | 2 +- .../compiler-errors-1/compiler-error-c2460.md | 2 +- 20 files changed, 29 insertions(+), 29 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md index c8e03ca57da..d89f1f703d5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md @@ -16,7 +16,7 @@ The ESP register is scaled or used as both index and base register. The SIB enco ## Example -The following sample generates C2431: +The following example generates C2431: ```cpp // C2431.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md index 9258facd7bd..61094eca026 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md @@ -16,7 +16,7 @@ A 16-bit register is used as an index or base register. The compiler does not su ## Example -The following sample generates C2432: +The following example generates C2432: ```cpp // C2432.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2434.md b/docs/error-messages/compiler-errors-1/compiler-error-c2434.md index 7a9cba1f7d9..50bb092e394 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2434.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2434.md @@ -18,7 +18,7 @@ It is not possible to dynamically initialize a per-process variable under **/clr ## Example -The following sample generates C2434. To fix this issue, use constants to initialize `process` variables. +The following example generates C2434. To fix this issue, use constants to initialize `process` variables. ```cpp // C2434.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2435.md b/docs/error-messages/compiler-errors-1/compiler-error-c2435.md index 90b82057ad1..a00ff91214a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2435.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2435.md @@ -20,7 +20,7 @@ For more information, see [appdomain](../../cpp/appdomain.md) and [process](../. ## Example -The following sample generates C2435: +The following example generates C2435: ```cpp // C2435.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md index 9fef4cbc782..7bfdeabf1c7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md @@ -16,7 +16,7 @@ Member functions or local classes in the constructor initializer list cannot be ## Example -The following sample generates C2436: +The following example generates C2436: ```cpp // C2436.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md index 82cee149198..ae3bb92a360 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md @@ -16,7 +16,7 @@ An object can be initialized only once. ## Example -The following sample generates C2437: +The following example generates C2437: ```cpp // C2437.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md index 9c2f6b4faa4..f1f784f629e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md @@ -16,7 +16,7 @@ A constructor is used to initialize a static member of a class. Static members m ## Example -The following sample generates C2438: +The following example generates C2438: ```cpp // C2438.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2440.md b/docs/error-messages/compiler-errors-1/compiler-error-c2440.md index 4e4cd76d413..b1416ad8096 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2440.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2440.md @@ -21,7 +21,7 @@ The compiler generates C2440 when it can't convert from one type to another, eit ### C++ string literals are `const` -C2440 can be caused if you attempt to initialize a non-const `char*` (or `wchar_t*`) by using a string literal in C++ code, when the compiler conformance option [`/Zc:strictStrings`](../../build/reference/zc-strictstrings-disable-string-literal-type-conversion.md) is set. In C, the type of a string literal is array of **`char`**, but in C++, it's array of `const char`. This sample generates C2440: +C2440 can be caused if you attempt to initialize a non-const `char*` (or `wchar_t*`) by using a string literal in C++ code, when the compiler conformance option [`/Zc:strictStrings`](../../build/reference/zc-strictstrings-disable-string-literal-type-conversion.md) is set. In C, the type of a string literal is array of **`char`**, but in C++, it's array of `const char`. This example generates C2440: ```cpp // C2440s.cpp @@ -40,7 +40,7 @@ int main() { ### C++20 `u8` literals are `const char8_t` -In C++20 or under [`/Zc:char8_t`](../../build/reference/zc-char8-t.md), a UTF-8 literal character or string (such as `u8'a'` or `u8"String"`) is of type `const char8_t` or `const char8_t[N]`, respectively. This sample shows how compiler behavior changes between C++17 and C++20: +In C++20 or under [`/Zc:char8_t`](../../build/reference/zc-char8-t.md), a UTF-8 literal character or string (such as `u8'a'` or `u8"String"`) is of type `const char8_t` or `const char8_t[N]`, respectively. This example shows how compiler behavior changes between C++17 and C++20: ```cpp // C2440u8.cpp @@ -60,7 +60,7 @@ int main() { ### Pointer to member -You may see C2440 if you attempt to convert a pointer to member to `void*`. The next sample generates C2440: +You may see C2440 if you attempt to convert a pointer to member to `void*`. The next example generates C2440: ```cpp // C2440.cpp @@ -83,7 +83,7 @@ public: ### Cast of undefined type -The compiler emits C2440 if you attempt to cast from a type that's only forward declared but not defined. This sample generates C2440: +The compiler emits C2440 if you attempt to cast from a type that's only forward declared but not defined. This example generates C2440: ```cpp // c2440a.cpp @@ -98,7 +98,7 @@ Base * func(Derived * d) { ### Incompatible calling convention -The C2440 errors on lines 15 and 16 of the next sample are qualified with the `Incompatible calling conventions for UDT return value` message. A *UDT* is a user-defined type, such as a class, struct, or union. These kinds of incompatibility errors are caused when the calling convention of a UDT specified in the return type of a forward declaration conflicts with the actual calling convention of the UDT and when a function pointer is involved. +The C2440 errors on lines 15 and 16 of the next example are qualified with the `Incompatible calling conventions for UDT return value` message. A *UDT* is a user-defined type, such as a class, struct, or union. These kinds of incompatibility errors are caused when the calling convention of a UDT specified in the return type of a forward declaration conflicts with the actual calling convention of the UDT and when a function pointer is involved. In the example, first there are forward declarations for a struct and for a function that returns the struct. The compiler assumes that the struct uses the C++ calling convention. Next is the struct definition, which uses the C calling convention by default. Because the compiler doesn't know the calling convention of the struct until it finishes reading the entire struct, the calling convention for the struct in the return type of `get_c2` is also assumed to be C++. @@ -163,7 +163,7 @@ int main() { ### User-defined conversions -C2440 can also occur for an incorrect use of a user-defined conversion. For example, when a conversion operator has been defined as **`explicit`**, the compiler can't use it in an implicit conversion. For more information about user-defined conversions, see [User-Defined Conversions (C++/CLI)](../../dotnet/user-defined-conversions-cpp-cli.md)). This sample generates C2440: +C2440 can also occur for an incorrect use of a user-defined conversion. For example, when a conversion operator has been defined as **`explicit`**, the compiler can't use it in an implicit conversion. For more information about user-defined conversions, see [User-Defined Conversions (C++/CLI)](../../dotnet/user-defined-conversions-cpp-cli.md)). This example generates C2440: ```cpp // C2440d.cpp @@ -187,7 +187,7 @@ int main() { ### `System::Array` creation -C2440 can also occur if you try to create an instance of an array in C++/CLI whose type is a . For more information, see [Arrays](../../extensions/arrays-cpp-component-extensions.md). The next sample generates C2440: +C2440 can also occur if you try to create an instance of an array in C++/CLI whose type is a . For more information, see [Arrays](../../extensions/arrays-cpp-component-extensions.md). The next example generates C2440: ```cpp // C2440e.cpp @@ -202,7 +202,7 @@ int main() { ### Attributes -C2440 can also occur because of changes in the attributes feature. The following sample generates C2440. +C2440 can also occur because of changes in the attributes feature. The following example generates C2440. ```cpp // c2440f.cpp @@ -218,7 +218,7 @@ The Microsoft C++ compiler no longer allows the [`const_cast` operator](../../cp To resolve this C2440, use the correct cast operator. For more information, see [Casting operators](../../cpp/casting-operators.md). -This sample generates C2440: +This example generates C2440: ```cpp // c2440g.cpp @@ -237,7 +237,7 @@ int main() { C2440 can occur because of conformance changes to the compiler in Visual Studio 2015 Update 3. Previously, the compiler incorrectly treated certain distinct expressions as the same type when identifying a template match for a **`static_cast`** operation. Now the compiler distinguishes the types correctly, and code that relied on the previous **`static_cast`** behavior is broken. To fix this issue, change the template argument to match the template parameter type, or use a **`reinterpret_cast`** or C-style cast. -This sample generates C2440: +This example generates C2440: ```cpp // c2440h.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2441.md b/docs/error-messages/compiler-errors-1/compiler-error-c2441.md index 6ec4ce06501..ba07ebc5a5a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2441.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2441.md @@ -22,7 +22,7 @@ For more information, see [process](../../cpp/process.md) and [/clr (Common Lang ## Example -The following sample generates C2441. +The following example generates C2441. ```cpp // C2441.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md index b494fe93bb3..c610476fc7d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md @@ -16,7 +16,7 @@ The instruction requires operands to be the same size. ## Example -The following sample generates C2443: +The following example generates C2443: ```cpp // C2443.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md index 82634bef0d5..aba0cdbbb14 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md @@ -18,7 +18,7 @@ This error can also be caused by an old-style C-language formal argument list. T ## Example -The following sample generates C2447: +The following example generates C2447: ```cpp // C2447.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md index 16be4eae932..b6e0971651c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md @@ -18,7 +18,7 @@ This error can be caused by an old-style C-language formal list. ## Example -The following sample generates C2448: +The following example generates C2448: ```cpp // C2448.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md index 61810dbb3bc..c3171be013c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md @@ -18,7 +18,7 @@ This error can be caused by a semicolon between a function header and the openin ## Example -The following sample generates C2499: +The following example generates C2499: ```c // C2449.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md index ddfc7488da0..12ab4a4a822 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md @@ -15,7 +15,7 @@ The **`switch`** expression evaluates to an invalid type. It must evaluate to an ## Example -The following sample generates C2450: +The following example generates C2450: ```cpp // C2450.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md index 7e384af87cb..96057c57263 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md @@ -16,7 +16,7 @@ The conditional expression evaluates to an integer type. ## Example -The following sample generates C2451: +The following example generates C2451: ```cpp // C2451.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md index f0e037d227f..a3c684d0c3e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md @@ -16,7 +16,7 @@ The source type for [safe_cast](../../extensions/safe-cast-cpp-component-extensi ## Example -The following sample generates C2452: +The following example generates C2452: ```cpp // C2452.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2457.md b/docs/error-messages/compiler-errors-1/compiler-error-c2457.md index 8a4e90049fd..771831645d0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2457.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2457.md @@ -16,7 +16,7 @@ You attempted to use a predefined macro, such as [`__FUNCTION__`](../../preproce ## Example -The following sample generates C2457 and also shows correct usage: +The following example generates C2457 and also shows correct usage: ```cpp // C2457.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md index 3d24e4459e4..50eefd75c5e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md @@ -16,7 +16,7 @@ A class, structure, union, or enumeration is redefined in its own declaration. ## Example -The following sample generates C2458: +The following example generates C2458: ```cpp // C2458.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md index 5b0db6fc492..eb3a057fd6a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md @@ -16,7 +16,7 @@ A class, structure, or union is redefined in its own scope by a member of an ano ## Example -The following sample generates C2459: +The following example generates C2459: ```cpp // C2459.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md index 74546fb97d5..15d33ca9904 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md @@ -16,7 +16,7 @@ A class or structure (`identifier2`) is declared as a member of itself (`identif ## Example -The following sample generates C2460: +The following example generates C2460: ```cpp // C2460.cpp From 1ca65a6fc9eb9e496182ea4d82168c072339995f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 27 Jul 2025 22:18:08 +0800 Subject: [PATCH 0542/1799] Update metadata for error references in range [C2431, C2460] --- .../error-messages/compiler-errors-1/compiler-error-c2431.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2432.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2434.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2435.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2436.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2437.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2438.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2439.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2441.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2443.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2444.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2446.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2447.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2448.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2449.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2450.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2451.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2452.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2457.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2458.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2459.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2460.md | 5 ++--- 22 files changed, 44 insertions(+), 65 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md index d89f1f703d5..923f9f17e1c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2431" title: "Compiler Error C2431" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2431" +ms.date: 11/04/2016 f1_keywords: ["C2431"] helpviewer_keywords: ["C2431"] -ms.assetid: 88a5b648-c89f-47d1-a20e-63231ab4f0f7 --- # Compiler Error C2431 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md index 61094eca026..ef91964904e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2432" title: "Compiler Error C2432" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2432" +ms.date: 11/04/2016 f1_keywords: ["C2432"] helpviewer_keywords: ["C2432"] -ms.assetid: 0e3326e8-cab1-45a5-b48d-61edd33793e8 --- # Compiler Error C2432 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2434.md b/docs/error-messages/compiler-errors-1/compiler-error-c2434.md index 50bb092e394..f48832f1467 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2434.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2434.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2434" title: "Compiler Error C2434" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2434" +ms.date: 11/04/2016 f1_keywords: ["C2434"] helpviewer_keywords: ["C2434"] -ms.assetid: 01329e26-7c74-4219-b74f-69e3a40c9738 --- # Compiler Error C2434 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2435.md b/docs/error-messages/compiler-errors-1/compiler-error-c2435.md index a00ff91214a..6522c4a0255 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2435.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2435.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2435" title: "Compiler Error C2435" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2435" +ms.date: 11/04/2016 f1_keywords: ["C2435"] helpviewer_keywords: ["C2435"] -ms.assetid: be6aa8f8-579b-42ea-bdd8-2d01393646ad --- # Compiler Error C2435 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md index 7bfdeabf1c7..8b1879a76d8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2436" title: "Compiler Error C2436" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2436" +ms.date: 11/04/2016 f1_keywords: ["C2436"] helpviewer_keywords: ["C2436"] -ms.assetid: ca4cc813-bc1d-4c0a-9a2c-3a5fe673d084 --- # Compiler Error C2436 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md index ae3bb92a360..07b62af2655 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2437" title: "Compiler Error C2437" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2437" +ms.date: 11/04/2016 f1_keywords: ["C2437"] helpviewer_keywords: ["C2437"] -ms.assetid: 2d2b3c6c-856a-4b27-ae10-64813b3e5483 --- # Compiler Error C2437 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md index f1f784f629e..2a0e207e1df 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2438" title: "Compiler Error C2438" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2438" +ms.date: 11/04/2016 f1_keywords: ["C2438"] helpviewer_keywords: ["C2438"] -ms.assetid: 3a0ab3ba-d0e4-4d8f-971d-e503397cc827 --- # Compiler Error C2438 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2439.md b/docs/error-messages/compiler-errors-1/compiler-error-c2439.md index e24d5d39ec3..37a5523bea6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2439.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2439.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2439" title: "Compiler Error C2439" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2439" +ms.date: 11/04/2016 f1_keywords: ["C2439"] helpviewer_keywords: ["C2439"] -ms.assetid: 3c5dbe5c-b7d3-4bb0-8619-92f6e280461e --- # Compiler Error C2439 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2441.md b/docs/error-messages/compiler-errors-1/compiler-error-c2441.md index ba07ebc5a5a..e82e9e4cb04 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2441.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2441.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2441" title: "Compiler Error C2441" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2441" +ms.date: 11/04/2016 f1_keywords: ["C2441"] helpviewer_keywords: ["C2441"] -ms.assetid: ffbd6573-777a-48dd-892f-5cf4a758dcab --- # Compiler Error C2441 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md index c610476fc7d..2246220c488 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2443" title: "Compiler Error C2443" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2443" +ms.date: 11/04/2016 f1_keywords: ["C2443"] helpviewer_keywords: ["C2443"] -ms.assetid: 315330d5-24bc-4193-a531-0642095be58f --- # Compiler Error C2443 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2444.md b/docs/error-messages/compiler-errors-1/compiler-error-c2444.md index ccf35d6e96c..8fbffad64a9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2444.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2444.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2444" title: "Compiler Error C2444" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2444" +ms.date: 11/04/2016 f1_keywords: ["C2444"] helpviewer_keywords: ["C2444"] -ms.assetid: 6339ed82-caad-45d3-a8ff-6c746589fd03 --- # Compiler Error C2444 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2446.md b/docs/error-messages/compiler-errors-1/compiler-error-c2446.md index 8dae8e651fc..0f1951562ed 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2446.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2446.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2446" title: "Compiler Error C2446" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2446" +ms.date: 11/04/2016 f1_keywords: ["C2446"] helpviewer_keywords: ["C2446"] -ms.assetid: 4f70dd11-6baf-4b92-9a08-f88f65ffa199 --- # Compiler Error C2446 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md index aba0cdbbb14..7191d5ad851 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2447" title: "Compiler Error C2447" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2447" +ms.date: 11/04/2016 f1_keywords: ["C2447"] helpviewer_keywords: ["C2447"] -ms.assetid: d1bd6e9a-ee42-4510-ae5e-6b0378f7b931 --- # Compiler Error C2447 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md index b6e0971651c..05ae565e92e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2448" title: "Compiler Error C2448" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2448" +ms.date: 11/04/2016 f1_keywords: ["C2448"] helpviewer_keywords: ["C2448"] -ms.assetid: e255df3c-f861-4b4d-a193-8768cef061a5 --- # Compiler Error C2448 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md index c3171be013c..aee2034191e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2449" title: "Compiler Error C2449" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2449" +ms.date: 11/04/2016 f1_keywords: ["C2449"] helpviewer_keywords: ["C2449"] -ms.assetid: 544bf0b6-daa0-40e8-9f21-8e583d472a2d --- # Compiler Error C2449 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md index 12ab4a4a822..61dc7caa663 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2450" title: "Compiler Error C2450" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2450" +ms.date: 11/04/2016 f1_keywords: ["C2450"] helpviewer_keywords: ["C2450"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md index 96057c57263..0d266179dbd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2451" title: "Compiler Error C2451" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2451" +ms.date: 11/04/2016 f1_keywords: ["C2451"] helpviewer_keywords: ["C2451"] -ms.assetid: a64c93a5-ab8d-4d39-ae57-9ee7ef803036 --- # Compiler Error C2451 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md index a3c684d0c3e..fabb98fbc3e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2452" title: "Compiler Error C2452" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2452" +ms.date: 11/04/2016 f1_keywords: ["C2452"] helpviewer_keywords: ["C2452"] -ms.assetid: a4ec7642-6660-4c7a-9866-853d1cc67daf --- # Compiler Error C2452 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2457.md b/docs/error-messages/compiler-errors-1/compiler-error-c2457.md index 771831645d0..55e9609401a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2457.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2457.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2457" title: "Compiler Error C2457" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2457" +ms.date: 11/04/2016 f1_keywords: ["C2457"] helpviewer_keywords: ["C2457"] -ms.assetid: 347e169d-23ad-434f-8836-5b09b53980ff --- # Compiler Error C2457 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md index 50eefd75c5e..e87f8b60f8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2458" title: "Compiler Error C2458" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2458" +ms.date: 11/04/2016 f1_keywords: ["C2458"] helpviewer_keywords: ["C2458"] -ms.assetid: ed21901f-1067-42f5-b275-19b480decf5c --- # Compiler Error C2458 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md index eb3a057fd6a..135799238c3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2459" title: "Compiler Error C2459" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2459" +ms.date: 11/04/2016 f1_keywords: ["C2459"] helpviewer_keywords: ["C2459"] -ms.assetid: 81e29f4c-5b60-40fb-9557-1cdc630d77e8 --- # Compiler Error C2459 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md index 15d33ca9904..6f13975fc47 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2460" title: "Compiler Error C2460" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2460" +ms.date: 11/04/2016 f1_keywords: ["C2460"] helpviewer_keywords: ["C2460"] -ms.assetid: d969fca9-3ac5-4e4e-88fc-df05510e2093 --- # Compiler Error C2460 From 0ae844debc549fd2e42a153585a7b88555d107cb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 28 Jul 2025 23:10:31 +0800 Subject: [PATCH 0543/1799] Add blockquotes for error messages in range [C2461, C2490] --- docs/error-messages/compiler-errors-1/compiler-error-c2464.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2465.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2467.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2471.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2473.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2474.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2477.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2479.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2480.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2485.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2486.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2487.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2488.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2489.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2490.md | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md index 15645af89f1..4466f9739a8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md @@ -8,7 +8,7 @@ ms.assetid: ace953d6-b414-49ee-bfef-90578a8da00c --- # Compiler Error C2464 -'identifier' : cannot use 'new' to allocate a reference +> 'identifier' : cannot use 'new' to allocate a reference A reference identifier was allocated with the **`new`** operator. References are not memory objects, so **`new`** cannot return a pointer to them. Use the standard variable declaration syntax to declare a reference. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2465.md b/docs/error-messages/compiler-errors-1/compiler-error-c2465.md index fc173014703..49056e0539a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2465.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2465.md @@ -8,6 +8,6 @@ ms.assetid: 65ba2a9f-d95e-4af3-b60b-1ac59a1e307c --- # Compiler Error C2465 -cannot define an anonymous type inside parentheses +> cannot define an anonymous type inside parentheses An anonymous structure, union, or enumerated type is defined inside a parenthetical expression. This is invalid in C++ because the definition is meaningless in function scope. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md index 05d89f1289e..52824f8f822 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md @@ -8,7 +8,7 @@ ms.assetid: f9ead270-5d0b-41cc-bdcd-586a647c67a7 --- # Compiler Error C2467 -illegal declaration of anonymous 'user-defined-type' +> illegal declaration of anonymous 'user-defined-type' A nested user-defined type was declared. This is an error when compiling C source code with the ANSI compatibility option ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) enabled. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2471.md b/docs/error-messages/compiler-errors-1/compiler-error-c2471.md index 062241d3ee9..85d7e4232c4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2471.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2471.md @@ -8,7 +8,7 @@ ms.assetid: a8928b44-20f6-4cbc-9aa5-7e86052a9c6b --- # Compiler Error C2471 -cannot update program database 'file' +> cannot update program database 'file' The compiler cannot write to the database file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md index 63eb9afabf2..a3e5557ee95 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md @@ -8,7 +8,7 @@ ms.assetid: 6bb7dbf5-b198-490f-860e-fd64d0c2a284 --- # Compiler Error C2473 -'identifier' : looks like a function definition, but there is no parameter list. +> 'identifier' : looks like a function definition, but there is no parameter list. The compiler detected what looked like a function, without the parameter list. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md index 939b72aa8e8..3532133c803 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md @@ -8,7 +8,7 @@ ms.assetid: 64e6c61e-6e77-480e-bcf0-b30a2fc482ac --- # Compiler Error C2474 -'keyword' : missing an adjacent semicolon, could be either keyword or identifier. +> 'keyword' : missing an adjacent semicolon, could be either keyword or identifier. The compiler expected to find a semicolon, and was unable to determine your intent. Add the semicolon to resolve this error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md index 9979cd6338c..c579646990d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md @@ -8,7 +8,7 @@ ms.assetid: 60bc324b-6605-4833-8099-a291efc712e7 --- # Compiler Error C2477 -'member' : static data member cannot be initialized via derived class +> 'member' : static data member cannot be initialized via derived class A static data member of a template class was initialized incorrectly. This is a breaking change with versions of the Microsoft C++ compiler prior to Visual Studio .NET 2003, in order to conform to the ISO C++ standard. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md index e7eca0e5cc1..510eed94a3f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md @@ -8,7 +8,7 @@ ms.assetid: c74c7869-e65b-4ca1-b6fa-eb39fed4458a --- # Compiler Error C2479 -'identifier' : 'allocate( )' is only valid for data items of static extent +> 'identifier' : 'allocate( )' is only valid for data items of static extent The `__declspec( allocate())` syntax can be used for static data only. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md index 53d48131942..100b264ee47 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md @@ -8,7 +8,7 @@ ms.assetid: 1a58d1c2-971b-4084-96fa-f94aa51c02f1 --- # Compiler Error C2480 -'identifier' : 'thread' is only valid for data items of static extent +> 'identifier' : 'thread' is only valid for data items of static extent You cannot use the `thread` attribute with an automatic variable, nonstatic data member, function parameter, or on function declarations or definitions. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2485.md b/docs/error-messages/compiler-errors-1/compiler-error-c2485.md index cc0fae6ad51..b832acfa3f9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2485.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2485.md @@ -8,6 +8,6 @@ ms.assetid: daae3fc1-76cf-4a6f-b2fa-86873fb0929d --- # Compiler Error C2485 -'identifier' : unrecognized extended attribute +> 'identifier' : unrecognized extended attribute The declaration attribute is not valid. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md index be3ef73366d..69f5db43c7d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md @@ -8,7 +8,7 @@ ms.assetid: 436da349-6461-4e32-bfca-4f3e620108e2 --- # Compiler Error C2486 -'__LOCAL_SIZE' only allowed in function with the 'naked' attribute +> '__LOCAL_SIZE' only allowed in function with the 'naked' attribute In inline assembly functions, the name `__LOCAL_SIZE` is reserved for functions declared with the [naked](../../cpp/naked-cpp.md) attribute. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md index 29a8a9beeb8..624c2ba0ebe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2487"] --- # Compiler Error C2487 -'identifier' : member of dll interface class may not be declared with dll interface +> 'identifier' : member of dll interface class may not be declared with dll interface You can declare a whole class, or certain members of a non-DLL interface class, with DLL interface. You cannot declare a class with DLL interface and then declare a member of that class with DLL interface. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md index 03afc72f646..976d7fbe7ea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md @@ -8,7 +8,7 @@ ms.assetid: cd435909-43e4-43c6-a57c-5d02468ef75f --- # Compiler Error C2488 -'identifier' : 'naked' can only be applied to non-member function definitions +> 'identifier' : 'naked' can only be applied to non-member function definitions The [naked](../../cpp/naked-cpp.md) attribute was applied to a function declaration. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md index b7cdbc9ed09..25685c29ea5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md @@ -8,7 +8,7 @@ ms.assetid: 67d8cd98-db7e-4f7f-86b4-4af7bc89ec8b --- # Compiler Error C2489 -'identifier' : initialized auto or register variable not allowed at function scope in 'naked' function +> 'identifier' : initialized auto or register variable not allowed at function scope in 'naked' function For more information, see [naked](../../cpp/naked-cpp.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md index b675d35c6b0..b24da7a13e0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md @@ -8,7 +8,7 @@ ms.assetid: 9de6bddd-b2e2-4ce6-b33b-201a8c2c8c54 --- # Compiler Error C2490 -'keyword' not allowed in function with 'naked' attribute +> 'keyword' not allowed in function with 'naked' attribute A function defined as [naked](../../cpp/naked-cpp.md) cannot use structured exception handling. From c785b6ee9e647fa5da92d2cc21e3861a4bd7e17b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 28 Jul 2025 23:16:01 +0800 Subject: [PATCH 0544/1799] Add "Remarks" and "Example" headings for error references in range [C2461, C2490] --- docs/error-messages/compiler-errors-1/compiler-error-c2461.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2462.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2464.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2465.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2466.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2467.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2470.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2471.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2473.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2474.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2477.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2479.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2480.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2483.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2485.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2486.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2487.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2488.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2489.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2490.md | 4 ++++ 20 files changed, 64 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2461.md b/docs/error-messages/compiler-errors-1/compiler-error-c2461.md index 4d3aac6503f..02e2fe23fbe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2461.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2461.md @@ -10,6 +10,8 @@ ms.assetid: e64ba651-f441-4fdb-b5cb-4209bbbe4db4 > '*class*' : constructor syntax missing formal parameters +## Remarks + The constructor for the class does not specify any formal parameters. The declaration of a constructor must specify a formal parameter list. The list can be empty. To fix this issue, add a pair of parentheses after the declaration of *class*::**class*. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md index 9a8d3f18674..739e07cecc4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2462"] > 'identifier' : cannot define a type in a 'new-expression' +## Remarks + You cannot define a type in the operand field of the **`new`** operator. Put the type definition in a separate statement. +## Example + The following sample generates C2462: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md index 4466f9739a8..185a5c591ad 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md @@ -10,8 +10,12 @@ ms.assetid: ace953d6-b414-49ee-bfef-90578a8da00c > 'identifier' : cannot use 'new' to allocate a reference +## Remarks + A reference identifier was allocated with the **`new`** operator. References are not memory objects, so **`new`** cannot return a pointer to them. Use the standard variable declaration syntax to declare a reference. +## Example + The following sample generates C2464: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2465.md b/docs/error-messages/compiler-errors-1/compiler-error-c2465.md index 49056e0539a..f3611f15a66 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2465.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2465.md @@ -10,4 +10,6 @@ ms.assetid: 65ba2a9f-d95e-4af3-b60b-1ac59a1e307c > cannot define an anonymous type inside parentheses +## Remarks + An anonymous structure, union, or enumerated type is defined inside a parenthetical expression. This is invalid in C++ because the definition is meaningless in function scope. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2466.md b/docs/error-messages/compiler-errors-1/compiler-error-c2466.md index 34e0cca5945..ed610cf53f7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2466.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2466.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2466"] > cannot allocate an array of constant size 0 +## Remarks + An array is allocated or declared with size zero. The constant expression for the array size must be an integer greater than zero. An array declaration with a zero subscript is legal only for a class, structure, or union member and only with Microsoft extensions ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)). +## Example + The following sample generates C2466: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md index 52824f8f822..6997d426c8b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md @@ -10,8 +10,12 @@ ms.assetid: f9ead270-5d0b-41cc-bdcd-586a647c67a7 > illegal declaration of anonymous 'user-defined-type' +## Remarks + A nested user-defined type was declared. This is an error when compiling C source code with the ANSI compatibility option ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) enabled. +## Example + The following sample generates C2467: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2470.md b/docs/error-messages/compiler-errors-1/compiler-error-c2470.md index d0bc5eda5ab..106ff11456a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2470.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2470.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2470"] > '*function*': looks like a function definition, but there is no parameter list; skipping apparent body +## Remarks + A function definition is missing its argument list. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2471.md b/docs/error-messages/compiler-errors-1/compiler-error-c2471.md index 85d7e4232c4..06979d8cbb9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2471.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2471.md @@ -10,6 +10,8 @@ ms.assetid: a8928b44-20f6-4cbc-9aa5-7e86052a9c6b > cannot update program database 'file' +## Remarks + The compiler cannot write to the database file. ### To fix the problem diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md index a3e5557ee95..7cf4bf36adc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md @@ -10,6 +10,8 @@ ms.assetid: 6bb7dbf5-b198-490f-860e-fd64d0c2a284 > 'identifier' : looks like a function definition, but there is no parameter list. +## Remarks + The compiler detected what looked like a function, without the parameter list. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md index 3532133c803..a274ba64a3d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md @@ -10,6 +10,8 @@ ms.assetid: 64e6c61e-6e77-480e-bcf0-b30a2fc482ac > 'keyword' : missing an adjacent semicolon, could be either keyword or identifier. +## Remarks + The compiler expected to find a semicolon, and was unable to determine your intent. Add the semicolon to resolve this error. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md index c579646990d..6c8d1b6dee7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md @@ -10,8 +10,12 @@ ms.assetid: 60bc324b-6605-4833-8099-a291efc712e7 > 'member' : static data member cannot be initialized via derived class +## Remarks + A static data member of a template class was initialized incorrectly. This is a breaking change with versions of the Microsoft C++ compiler prior to Visual Studio .NET 2003, in order to conform to the ISO C++ standard. +## Example + The following sample generates C2477: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md index 510eed94a3f..f559e8c4e93 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md @@ -10,8 +10,12 @@ ms.assetid: c74c7869-e65b-4ca1-b6fa-eb39fed4458a > 'identifier' : 'allocate( )' is only valid for data items of static extent +## Remarks + The `__declspec( allocate())` syntax can be used for static data only. +## Example + The following sample generates C2479: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md index 100b264ee47..01e6de5e4ce 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md @@ -10,10 +10,14 @@ ms.assetid: 1a58d1c2-971b-4084-96fa-f94aa51c02f1 > 'identifier' : 'thread' is only valid for data items of static extent +## Remarks + You cannot use the `thread` attribute with an automatic variable, nonstatic data member, function parameter, or on function declarations or definitions. Use the `thread` attribute for global variables, static data members, and local static variables only. +## Example + The following sample generates C2480: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2483.md b/docs/error-messages/compiler-errors-1/compiler-error-c2483.md index 5e225b8d6d9..da7fe80706d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2483.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2483.md @@ -10,6 +10,8 @@ ms.assetid: 5762b325-914b-442d-a604-e4617ba04038 >'*identifier*' : object with constructor or destructor cannot be declared 'thread' +## Remarks + This error message is obsolete in Visual Studio 2015 and later versions. In previous versions, variables declared with the `thread` attribute cannot be initialized with a constructor or other expression that requires run-time evaluation. A static expression is required to initialize `thread` data. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2485.md b/docs/error-messages/compiler-errors-1/compiler-error-c2485.md index b832acfa3f9..dfbf6da94a8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2485.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2485.md @@ -10,4 +10,6 @@ ms.assetid: daae3fc1-76cf-4a6f-b2fa-86873fb0929d > 'identifier' : unrecognized extended attribute +## Remarks + The declaration attribute is not valid. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md index 69f5db43c7d..1f990a0bba5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md @@ -10,8 +10,12 @@ ms.assetid: 436da349-6461-4e32-bfca-4f3e620108e2 > '__LOCAL_SIZE' only allowed in function with the 'naked' attribute +## Remarks + In inline assembly functions, the name `__LOCAL_SIZE` is reserved for functions declared with the [naked](../../cpp/naked-cpp.md) attribute. +## Example + The following sample generates C2486: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md index 624c2ba0ebe..07d636cb451 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2487"] > 'identifier' : member of dll interface class may not be declared with dll interface +## Remarks + You can declare a whole class, or certain members of a non-DLL interface class, with DLL interface. You cannot declare a class with DLL interface and then declare a member of that class with DLL interface. +## Example + The following sample generates C2487: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md index 976d7fbe7ea..8efc0e175de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md @@ -10,8 +10,12 @@ ms.assetid: cd435909-43e4-43c6-a57c-5d02468ef75f > 'identifier' : 'naked' can only be applied to non-member function definitions +## Remarks + The [naked](../../cpp/naked-cpp.md) attribute was applied to a function declaration. +## Example + The following sample generates C2488: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md index 25685c29ea5..5c9d0d072c0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md @@ -10,8 +10,12 @@ ms.assetid: 67d8cd98-db7e-4f7f-86b4-4af7bc89ec8b > 'identifier' : initialized auto or register variable not allowed at function scope in 'naked' function +## Remarks + For more information, see [naked](../../cpp/naked-cpp.md). +## Example + The following sample generates C2489: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md index b24da7a13e0..2f9725d8b31 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md @@ -10,8 +10,12 @@ ms.assetid: 9de6bddd-b2e2-4ce6-b33b-201a8c2c8c54 > 'keyword' not allowed in function with 'naked' attribute +## Remarks + A function defined as [naked](../../cpp/naked-cpp.md) cannot use structured exception handling. +## Example + The following sample generates C2490: ```cpp From 51673d9b78b94e169da10028bba19f435d5e5778 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 28 Jul 2025 23:17:34 +0800 Subject: [PATCH 0545/1799] Replace term "sample" with "example" for error references in range [C2461, C2490] --- docs/error-messages/compiler-errors-1/compiler-error-c2461.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2462.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2464.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2466.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2467.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2472.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2473.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2474.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2477.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2479.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2480.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2482.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2483.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2486.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2487.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2488.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2489.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2490.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2461.md b/docs/error-messages/compiler-errors-1/compiler-error-c2461.md index 02e2fe23fbe..f0073f5d25e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2461.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2461.md @@ -18,7 +18,7 @@ To fix this issue, add a pair of parentheses after the declaration of *class*::* ## Example -The following sample shows how to fix C2461: +The following example shows how to fix C2461: ```cpp // C2461.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md index 739e07cecc4..831bb7e25a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md @@ -15,7 +15,7 @@ You cannot define a type in the operand field of the **`new`** operator. Put the ## Example -The following sample generates C2462: +The following example generates C2462: ```cpp // C2462.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md index 185a5c591ad..a7722f6ad02 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md @@ -16,7 +16,7 @@ A reference identifier was allocated with the **`new`** operator. References are ## Example -The following sample generates C2464: +The following example generates C2464: ```cpp // C2464.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2466.md b/docs/error-messages/compiler-errors-1/compiler-error-c2466.md index ed610cf53f7..6de1e5bce4b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2466.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2466.md @@ -15,7 +15,7 @@ An array is allocated or declared with size zero. The constant expression for th ## Example -The following sample generates C2466: +The following example generates C2466: ```cpp // C2466.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md index 6997d426c8b..c7df5ca1031 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md @@ -16,7 +16,7 @@ A nested user-defined type was declared. This is an error when compiling C sourc ## Example -The following sample generates C2467: +The following example generates C2467: ```c //C2467.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2472.md b/docs/error-messages/compiler-errors-1/compiler-error-c2472.md index 7fce0f698a8..3b789692e08 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2472.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2472.md @@ -18,7 +18,7 @@ The **/clr:pure** and **/clr:safe** compiler options are deprecated in Visual St ## Example -The following sample generates C2472. +The following example generates C2472. ```cpp // C2472.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md index 7cf4bf36adc..fe2d170a93a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md @@ -16,7 +16,7 @@ The compiler detected what looked like a function, without the parameter list. ## Example -The following sample generates C2473. +The following example generates C2473. ```cpp // C2473.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md index a274ba64a3d..4de08fed246 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md @@ -16,7 +16,7 @@ The compiler expected to find a semicolon, and was unable to determine your inte ## Example -The following sample generates C2474. +The following example generates C2474. ```cpp // C2474.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md index 6c8d1b6dee7..9224a809cc3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md @@ -16,7 +16,7 @@ A static data member of a template class was initialized incorrectly. This is a ## Example -The following sample generates C2477: +The following example generates C2477: ```cpp // C2477.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md index f559e8c4e93..50d4cf9b2cc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md @@ -16,7 +16,7 @@ The `__declspec( allocate())` syntax can be used for static data only. ## Example -The following sample generates C2479: +The following example generates C2479: ```cpp // C2479.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md index 01e6de5e4ce..5a99cd38d18 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md @@ -18,7 +18,7 @@ Use the `thread` attribute for global variables, static data members, and local ## Example -The following sample generates C2480: +The following example generates C2480: ```cpp // C2480.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2482.md b/docs/error-messages/compiler-errors-1/compiler-error-c2482.md index 9c48b04b768..1b263c34361 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2482.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2482.md @@ -16,7 +16,7 @@ In managed or WinRT code, variables declared by using the [__declspec(thread)](. ## Example -The following sample generates C2482 in managed (**/clr**) and in WinRT (**/ZW**) code: +The following example generates C2482 in managed (**/clr**) and in WinRT (**/ZW**) code: ```cpp // C2482.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2483.md b/docs/error-messages/compiler-errors-1/compiler-error-c2483.md index da7fe80706d..9d46f72d2a5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2483.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2483.md @@ -16,7 +16,7 @@ This error message is obsolete in Visual Studio 2015 and later versions. In prev ## Example -The following sample generates C2483 in Visual Studio 2013 and earlier versions. +The following example generates C2483 in Visual Studio 2013 and earlier versions. ```cpp // C2483.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md index 1f990a0bba5..0895df95388 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md @@ -16,7 +16,7 @@ In inline assembly functions, the name `__LOCAL_SIZE` is reserved for functions ## Example -The following sample generates C2486: +The following example generates C2486: ```cpp // C2486.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md index 07d636cb451..a8400fe5432 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md @@ -15,7 +15,7 @@ You can declare a whole class, or certain members of a non-DLL interface class, ## Example -The following sample generates C2487: +The following example generates C2487: ```cpp // C2487.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md index 8efc0e175de..8d0cfe7cc0e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md @@ -16,7 +16,7 @@ The [naked](../../cpp/naked-cpp.md) attribute was applied to a function declarat ## Example -The following sample generates C2488: +The following example generates C2488: ```cpp // C2488.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md index 5c9d0d072c0..b685089082c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md @@ -16,7 +16,7 @@ For more information, see [naked](../../cpp/naked-cpp.md). ## Example -The following sample generates C2489: +The following example generates C2489: ```cpp // C2489.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md index 2f9725d8b31..20b567e5972 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md @@ -16,7 +16,7 @@ A function defined as [naked](../../cpp/naked-cpp.md) cannot use structured exce ## Example -The following sample generates C2490: +The following example generates C2490: ```cpp // C2490.cpp From b8439520263adaf48385438455e63e1dbbd08d42 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 28 Jul 2025 23:20:53 +0800 Subject: [PATCH 0546/1799] Update metadata for error references in range [C2461, C2490] --- .../error-messages/compiler-errors-1/compiler-error-c2461.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2462.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2464.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2465.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2466.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2467.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2470.md | 2 +- .../error-messages/compiler-errors-1/compiler-error-c2471.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2472.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2473.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2474.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2477.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2479.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2480.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2482.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2483.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2485.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2486.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2487.md | 4 ++-- .../error-messages/compiler-errors-1/compiler-error-c2488.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2489.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2490.md | 5 ++--- 22 files changed, 42 insertions(+), 60 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2461.md b/docs/error-messages/compiler-errors-1/compiler-error-c2461.md index f0073f5d25e..7b4d94ac41d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2461.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2461.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2461" title: "Compiler Error C2461" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2461" +ms.date: 11/04/2016 f1_keywords: ["C2461"] helpviewer_keywords: ["C2461"] -ms.assetid: e64ba651-f441-4fdb-b5cb-4209bbbe4db4 --- # Compiler Error C2461 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md index 831bb7e25a4..baad0121506 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2462" title: "Compiler Error C2462" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2462" +ms.date: 11/04/2016 f1_keywords: ["C2462"] helpviewer_keywords: ["C2462"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md index a7722f6ad02..10a9a5155f1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2464" title: "Compiler Error C2464" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2464" +ms.date: 11/04/2016 f1_keywords: ["C2464"] helpviewer_keywords: ["C2464"] -ms.assetid: ace953d6-b414-49ee-bfef-90578a8da00c --- # Compiler Error C2464 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2465.md b/docs/error-messages/compiler-errors-1/compiler-error-c2465.md index f3611f15a66..861458fb9ea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2465.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2465.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2465" title: "Compiler Error C2465" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2465" +ms.date: 11/04/2016 f1_keywords: ["C2465"] helpviewer_keywords: ["C2465"] -ms.assetid: 65ba2a9f-d95e-4af3-b60b-1ac59a1e307c --- # Compiler Error C2465 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2466.md b/docs/error-messages/compiler-errors-1/compiler-error-c2466.md index 6de1e5bce4b..05985b61cba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2466.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2466.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2466" description: "Learn more about: Compiler Error C2466" -ms.date: "03/19/2025" +ms.date: 03/19/2025 f1_keywords: ["C2466"] helpviewer_keywords: ["C2466"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md index c7df5ca1031..a941568e44a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2467" title: "Compiler Error C2467" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2467" +ms.date: 11/04/2016 f1_keywords: ["C2467"] helpviewer_keywords: ["C2467"] -ms.assetid: f9ead270-5d0b-41cc-bdcd-586a647c67a7 --- # Compiler Error C2467 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2470.md b/docs/error-messages/compiler-errors-1/compiler-error-c2470.md index 106ff11456a..228392a8ef2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2470.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2470.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2470" description: "Learn more about: Compiler Error C2470" -ms.date: "03/29/2025" +ms.date: 03/29/2025 f1_keywords: ["C2470"] helpviewer_keywords: ["C2470"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2471.md b/docs/error-messages/compiler-errors-1/compiler-error-c2471.md index 06979d8cbb9..abf9f1606c1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2471.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2471.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2471" title: "Compiler Error C2471" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2471" +ms.date: 11/04/2016 f1_keywords: ["C2471"] helpviewer_keywords: ["C2471"] -ms.assetid: a8928b44-20f6-4cbc-9aa5-7e86052a9c6b --- # Compiler Error C2471 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2472.md b/docs/error-messages/compiler-errors-1/compiler-error-c2472.md index 3b789692e08..0b322bc60c3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2472.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2472.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2472" title: "Compiler Error C2472" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2472" +ms.date: 11/04/2016 f1_keywords: ["C2472"] helpviewer_keywords: ["C2472"] -ms.assetid: 3b36bcdc-2ba5-4357-ab88-7545ba0551cd --- # Compiler Error C2472 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md index fe2d170a93a..8577d69fade 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2473" title: "Compiler Error C2473" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2473" +ms.date: 11/04/2016 f1_keywords: ["C2473"] helpviewer_keywords: ["C2473"] -ms.assetid: 6bb7dbf5-b198-490f-860e-fd64d0c2a284 --- # Compiler Error C2473 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md index 4de08fed246..a486d75c68e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2474" title: "Compiler Error C2474" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2474" +ms.date: 11/04/2016 f1_keywords: ["C2474"] helpviewer_keywords: ["C2474"] -ms.assetid: 64e6c61e-6e77-480e-bcf0-b30a2fc482ac --- # Compiler Error C2474 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md index 9224a809cc3..458ef4e497b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2477" title: "Compiler Error C2477" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2477" +ms.date: 11/04/2016 f1_keywords: ["C2477"] helpviewer_keywords: ["C2477"] -ms.assetid: 60bc324b-6605-4833-8099-a291efc712e7 --- # Compiler Error C2477 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md index 50d4cf9b2cc..9f1401b3543 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2479" title: "Compiler Error C2479" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2479" +ms.date: 11/04/2016 f1_keywords: ["C2479"] helpviewer_keywords: ["C2479"] -ms.assetid: c74c7869-e65b-4ca1-b6fa-eb39fed4458a --- # Compiler Error C2479 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md index 5a99cd38d18..669e3b97af6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2480" title: "Compiler Error C2480" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2480" +ms.date: 11/04/2016 f1_keywords: ["C2480"] helpviewer_keywords: ["C2480"] -ms.assetid: 1a58d1c2-971b-4084-96fa-f94aa51c02f1 --- # Compiler Error C2480 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2482.md b/docs/error-messages/compiler-errors-1/compiler-error-c2482.md index 1b263c34361..2e86bf038f7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2482.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2482.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2482" title: "Compiler Error C2482" -ms.date: "09/15/2017" +description: "Learn more about: Compiler Error C2482" +ms.date: 09/15/2017 f1_keywords: ["C2482"] helpviewer_keywords: ["C2482"] -ms.assetid: 98c87da2-625c-4cc2-9bf7-78d15921e779 --- # Compiler Error C2482 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2483.md b/docs/error-messages/compiler-errors-1/compiler-error-c2483.md index 9d46f72d2a5..b150748d853 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2483.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2483.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2483" title: "Compiler Error C2483" -ms.date: "09/15/2017" +description: "Learn more about: Compiler Error C2483" +ms.date: 09/15/2017 f1_keywords: ["C2483"] helpviewer_keywords: ["C2483"] -ms.assetid: 5762b325-914b-442d-a604-e4617ba04038 --- # Compiler Error C2483 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2485.md b/docs/error-messages/compiler-errors-1/compiler-error-c2485.md index dfbf6da94a8..3dcdb343ffa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2485.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2485.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2485" title: "Compiler Error C2485" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2485" +ms.date: 11/04/2016 f1_keywords: ["C2485"] helpviewer_keywords: ["C2485"] -ms.assetid: daae3fc1-76cf-4a6f-b2fa-86873fb0929d --- # Compiler Error C2485 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md index 0895df95388..6e597959509 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2486" title: "Compiler Error C2486" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2486" +ms.date: 11/04/2016 f1_keywords: ["C2486"] helpviewer_keywords: ["C2486"] -ms.assetid: 436da349-6461-4e32-bfca-4f3e620108e2 --- # Compiler Error C2486 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md index a8400fe5432..360a49315ca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2487" title: "Compiler Error C2487" -ms.date: "03/04/2024" +description: "Learn more about: Compiler Error C2487" +ms.date: 03/04/2024 f1_keywords: ["C2487"] helpviewer_keywords: ["C2487"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md index 8d0cfe7cc0e..f708e3c6c8e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2488" title: "Compiler Error C2488" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2488" +ms.date: 11/04/2016 f1_keywords: ["C2488"] helpviewer_keywords: ["C2488"] -ms.assetid: cd435909-43e4-43c6-a57c-5d02468ef75f --- # Compiler Error C2488 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md index b685089082c..fb1bc4c1b20 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2489" title: "Compiler Error C2489" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2489" +ms.date: 11/04/2016 f1_keywords: ["C2489"] helpviewer_keywords: ["C2489"] -ms.assetid: 67d8cd98-db7e-4f7f-86b4-4af7bc89ec8b --- # Compiler Error C2489 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md index 20b567e5972..56c30f37d31 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2490" title: "Compiler Error C2490" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2490" +ms.date: 11/04/2016 f1_keywords: ["C2490"] helpviewer_keywords: ["C2490"] -ms.assetid: 9de6bddd-b2e2-4ce6-b33b-201a8c2c8c54 --- # Compiler Error C2490 From ec0828690f69304bdeea0e5b0ab369297ad1a617 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 00:40:18 +0800 Subject: [PATCH 0547/1799] Fix missing trailing underscore for SAL annotations --- docs/c-runtime-library/sal-annotations.md | 2 +- .../annotating-function-parameters-and-return-values.md | 2 +- docs/code-quality/c26116.md | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/c-runtime-library/sal-annotations.md b/docs/c-runtime-library/sal-annotations.md index 3b7f7b24999..963ba6fc611 100644 --- a/docs/c-runtime-library/sal-annotations.md +++ b/docs/c-runtime-library/sal-annotations.md @@ -8,7 +8,7 @@ ms.assetid: 81893638-010c-41a0-9cb3-666fe360f3e0 --- # SAL annotations -If you examine the library header files, you may notice some unusual annotations, for example, `_In_z` and `_Out_z_cap_(_Size)`. These annotations are examples of the Microsoft source-code annotation language (SAL). SAL provides a set of annotations to describe how a function uses its parameters and return type. For example, it indicates the assumptions it makes about them and the guarantees it makes on finishing. The header file \ defines the annotations. +If you examine the library header files, you may notice some unusual annotations, for example, `_In_z_` and `_Out_z_cap_(_Size)`. These annotations are examples of the Microsoft source-code annotation language (SAL). SAL provides a set of annotations to describe how a function uses its parameters and return type. For example, it indicates the assumptions it makes about them and the guarantees it makes on finishing. The header file \ defines the annotations. For more information about using SAL annotations in Visual Studio, see [Using SAL annotations to reduce C/C++ code defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). diff --git a/docs/code-quality/annotating-function-parameters-and-return-values.md b/docs/code-quality/annotating-function-parameters-and-return-values.md index 5c0a0531f02..468dd6d9281 100644 --- a/docs/code-quality/annotating-function-parameters-and-return-values.md +++ b/docs/code-quality/annotating-function-parameters-and-return-values.md @@ -102,7 +102,7 @@ f1_keywords: - "_In_" - "_Inout_updates_bytes_" - "_In_reads_to_ptr_z_" - - "_Ret_writes_bytes_to_maybenull" + - "_Ret_writes_bytes_to_maybenull_" - "_Outptr_opt_result_nullonfailure_" - "_In_reads_to_ptr_" - "_Outptr_result_buffer_" diff --git a/docs/code-quality/c26116.md b/docs/code-quality/c26116.md index 5282963f532..b47e491bf8c 100644 --- a/docs/code-quality/c26116.md +++ b/docs/code-quality/c26116.md @@ -10,11 +10,11 @@ ms.assetid: 43e99d2c-405e-4913-b6bd-47f5858b2877 > Failing to acquire or to hold lock '*lock*' in '*func*'. -Enforcement of syntactically scoped lock *acquire* and lock *release* pairs in C/C++ programs isn't performed by the language. A function may introduce a locking side effect by making an observable modification to the concurrency state. For example, a lock wrapper function increments the number of lock acquisitions, or lock count, for a given lock. You can annotate a function that has a side effect from a lock acquire or lock release by using `_Acquires_lock_` or `_Requires_lock_held`, respectively. Without such annotations, a function is expected not to change any lock count after it returns. If acquires and releases aren't balanced, they're considered to be *orphaned*. Warning C26116 is issued when a function has been annotated with `_Acquires_lock_`, but it doesn't acquire a lock, or when a function is annotated with `_Requires_lock_held` and releases the lock. +Enforcement of syntactically scoped lock *acquire* and lock *release* pairs in C/C++ programs isn't performed by the language. A function may introduce a locking side effect by making an observable modification to the concurrency state. For example, a lock wrapper function increments the number of lock acquisitions, or lock count, for a given lock. You can annotate a function that has a side effect from a lock acquire or lock release by using `_Acquires_lock_` or `_Requires_lock_held_`, respectively. Without such annotations, a function is expected not to change any lock count after it returns. If acquires and releases aren't balanced, they're considered to be *orphaned*. Warning C26116 is issued when a function has been annotated with `_Acquires_lock_`, but it doesn't acquire a lock, or when a function is annotated with `_Requires_lock_held_` and releases the lock. ## Example -The following example generates warning C26116 because the function `DoesNotLock` was annotated with `_Acquires_lock_` but doesn't acquire it. The function `DoesNotHoldLock` generates the warning because it's annotated with `_Requires_lock_held` and doesn't hold it. +The following example generates warning C26116 because the function `DoesNotLock` was annotated with `_Acquires_lock_` but doesn't acquire it. The function `DoesNotHoldLock` generates the warning because it's annotated with `_Requires_lock_held_` and doesn't hold it. ```cpp typedef struct _DATA From 6ddbbd2c28307b8b884a9c65a8b52932d0ba2d39 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 00:42:48 +0800 Subject: [PATCH 0548/1799] Update metadata in 3 topics --- docs/c-runtime-library/sal-annotations.md | 3 +-- .../annotating-function-parameters-and-return-values.md | 3 +-- docs/code-quality/c26116.md | 3 +-- 3 files changed, 3 insertions(+), 6 deletions(-) diff --git a/docs/c-runtime-library/sal-annotations.md b/docs/c-runtime-library/sal-annotations.md index 963ba6fc611..5c145f5c570 100644 --- a/docs/c-runtime-library/sal-annotations.md +++ b/docs/c-runtime-library/sal-annotations.md @@ -1,10 +1,9 @@ --- title: "SAL Annotations" description: "A brief description of the Microsoft source-code annotation language (SAL)." -ms.date: "11/04/2016" +ms.date: 11/04/2016 ms.topic: "concept-article" helpviewer_keywords: ["__z annotation", "ref annotation", "_opt annotation", "__checkreturn annotatioin", "__deref_opt annotation", "deref_opt annotation", "__deref annotation", "__in annotation", "annotations [C++]", "z annotation", "_inout annotation", "__ref annotation", "full annotation", "_in annotation", "_ref annotation", "__out annotation", "_ecount annotation", "SAL annotations", "__opt annotation", "inout annotation", "in annotation", "_CA_SHOULD_CHECK_RETURN", "__bcount annotation", "_full annotation", "_bcount annotation", "deref annotation", "part annotation", "_out annotation", "__nz annotation", "__part annotation", "opt annotation", "__full annotation", "_nz annotation", "_z annotation", "out annotation", "__ecount annotation", "__inout annotation", "SAL annotations, _CA_SHOULD_CHECK_RETURN", "_deref_opt annotation", "_deref annotation", "nz annotation", "_part annotation", "ecount annotation", "bcount annotation"] -ms.assetid: 81893638-010c-41a0-9cb3-666fe360f3e0 --- # SAL annotations diff --git a/docs/code-quality/annotating-function-parameters-and-return-values.md b/docs/code-quality/annotating-function-parameters-and-return-values.md index 468dd6d9281..2514f7ef61b 100644 --- a/docs/code-quality/annotating-function-parameters-and-return-values.md +++ b/docs/code-quality/annotating-function-parameters-and-return-values.md @@ -1,5 +1,5 @@ --- -title: Annotating function parameters and return values +title: "Annotating function parameters and return values" description: "Reference guide to function parameter and return value annotations." ms.date: 10/15/2019 ms.topic: "concept-article" @@ -123,7 +123,6 @@ f1_keywords: - "_Scanf_format_string_" - "_Scanf_s_format_string_" - "_Printf_format_string_" -ms.assetid: 82826a3d-0c81-421c-8ffe-4072555dca3a --- # Annotating function parameters and return values diff --git a/docs/code-quality/c26116.md b/docs/code-quality/c26116.md index b47e491bf8c..b6d60a75544 100644 --- a/docs/code-quality/c26116.md +++ b/docs/code-quality/c26116.md @@ -1,10 +1,9 @@ --- +title: "Warning C26116" description: "Learn more about: Warning C26116" -title: Warning C26116 ms.date: 11/04/2016 f1_keywords: ["C26116"] helpviewer_keywords: ["C26116"] -ms.assetid: 43e99d2c-405e-4913-b6bd-47f5858b2877 --- # Warning C26116 From 4d667eeef61d724201f26eb88272b8b28eac6ba1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 01:24:14 +0800 Subject: [PATCH 0549/1799] Elide parentheses around some "For more information..." --- docs/c-language/c-comments.md | 2 +- docs/c-language/initializing-scalar-types.md | 2 +- docs/c-language/l-value-and-r-value-expressions.md | 2 +- docs/c-language/parameters.md | 2 +- docs/c-language/scope-and-visibility.md | 2 +- docs/c-language/typedef-declarations.md | 2 +- docs/c-runtime-library/code-pages.md | 2 +- docs/c-runtime-library/reference/open-wopen.md | 4 ++-- docs/c-runtime-library/reference/sopen-s-wsopen-s.md | 2 +- docs/c-runtime-library/reference/sopen-wsopen.md | 2 +- .../reference/strftime-wcsftime-strftime-l-wcsftime-l.md | 2 +- docs/cpp/anonymous-class-types.md | 2 +- docs/cpp/fundamental-types-cpp.md | 6 +++--- docs/cpp/multiple-base-classes.md | 2 +- docs/cpp/pointers-to-members.md | 2 +- docs/cpp/postfix-expressions.md | 2 +- ...ement-and-decrement-operators-increment-and-decrement.md | 2 +- ...ement-and-decrement-operators-increment-and-decrement.md | 2 +- docs/cpp/standard-conversions.md | 4 ++-- docs/cpp/virtual-functions.md | 2 +- docs/cppcx/wrl/weakref-class.md | 2 +- docs/dotnet/how-to-migrate-to-clr.md | 4 ++-- docs/mfc/exception-handling-in-mfc.md | 2 +- docs/mfc/reference/cbasepane-class.md | 4 ++-- docs/mfc/reference/cfont-class.md | 2 +- 25 files changed, 31 insertions(+), 31 deletions(-) diff --git a/docs/c-language/c-comments.md b/docs/c-language/c-comments.md index aaa1c15a1e5..f4cb0ff24b5 100644 --- a/docs/c-language/c-comments.md +++ b/docs/c-language/c-comments.md @@ -57,7 +57,7 @@ The Microsoft compiler also supports single-line comments preceded by two forwar // This is a valid comment ``` -Comments beginning with two forward slashes (**`//`**) are terminated by the next newline character that isn't preceded by an escape character. In the next example, the newline character is preceded by a backslash (**`\`**), creating an "escape sequence." This escape sequence causes the compiler to treat the next line as part of the previous line. (For more information, see [Escape Sequences](../c-language/escape-sequences.md).) +Comments beginning with two forward slashes (**`//`**) are terminated by the next newline character that isn't preceded by an escape character. In the next example, the newline character is preceded by a backslash (**`\`**), creating an "escape sequence." This escape sequence causes the compiler to treat the next line as part of the previous line. For more information, see [Escape Sequences](../c-language/escape-sequences.md). ```C // my comment \ diff --git a/docs/c-language/initializing-scalar-types.md b/docs/c-language/initializing-scalar-types.md index 77c56738257..8f195455169 100644 --- a/docs/c-language/initializing-scalar-types.md +++ b/docs/c-language/initializing-scalar-types.md @@ -38,7 +38,7 @@ You can initialize variables of any type, as long as you obey the following rule - Variables declared with the **`auto`** or **`register`** storage-class specifier are initialized each time execution control passes to the block in which they're declared. If you omit an initializer from the declaration of an **`auto`** or **`register`** variable, the initial value of the variable is undefined. For automatic and register values, the initializer isn't restricted to being a constant; it can be any expression involving previously defined values, even function calls. -- The initial values for external variable declarations and for all **`static`** variables, whether external or internal, must be constant expressions. (For more information, see [Constant Expressions](../c-language/c-constant-expressions.md).) Since the address of any externally declared or static variable is constant, it can be used to initialize an internally declared **`static`** pointer variable. However, the address of an **`auto`** variable can't be used as a static initializer because it may be different for each execution of the block. You can use either constant or variable values to initialize **`auto`** and **`register`** variables. +- The initial values for external variable declarations and for all **`static`** variables, whether external or internal, must be constant expressions. For more information, see [Constant Expressions](../c-language/c-constant-expressions.md). Since the address of any externally declared or static variable is constant, it can be used to initialize an internally declared **`static`** pointer variable. However, the address of an **`auto`** variable can't be used as a static initializer because it may be different for each execution of the block. You can use either constant or variable values to initialize **`auto`** and **`register`** variables. - If the declaration of an identifier has block scope, and the identifier has external linkage, the declaration can't have an initialization. diff --git a/docs/c-language/l-value-and-r-value-expressions.md b/docs/c-language/l-value-and-r-value-expressions.md index cca7a68bf24..423efc65b38 100644 --- a/docs/c-language/l-value-and-r-value-expressions.md +++ b/docs/c-language/l-value-and-r-value-expressions.md @@ -31,7 +31,7 @@ The term "r-value" is sometimes used to describe the value of an expression and **Microsoft Specific** -Microsoft C includes an extension to the ANSI C standard that allows casts of l-values to be used as l-values, as long as the size of the object isn't lengthened through the cast. (For more information, see [Type-Cast Conversions](../c-language/type-cast-conversions.md).) The following example illustrates this feature: +Microsoft C includes an extension to the ANSI C standard that allows casts of l-values to be used as l-values, as long as the size of the object isn't lengthened through the cast. For more information, see [Type-Cast Conversions](../c-language/type-cast-conversions.md). The following example illustrates this feature: ``` char *p ; diff --git a/docs/c-language/parameters.md b/docs/c-language/parameters.md index cc504bb4905..1cf21be2848 100644 --- a/docs/c-language/parameters.md +++ b/docs/c-language/parameters.md @@ -50,7 +50,7 @@ void new( double x, double y, double z ) } ``` -If at least one parameter occurs in the parameter list, the list can end with a comma followed by three periods (**`, ...`**). This construction, called the "ellipsis notation," indicates a variable number of arguments to the function. (For more information, see [Calls with a Variable Number of Arguments](../c-language/calls-with-a-variable-number-of-arguments.md).) However, a call to the function must have at least as many arguments as there are parameters before the last comma. +If at least one parameter occurs in the parameter list, the list can end with a comma followed by three periods (**`, ...`**). This construction, called the "ellipsis notation," indicates a variable number of arguments to the function. For more information, see [Calls with a Variable Number of Arguments](../c-language/calls-with-a-variable-number-of-arguments.md). However, a call to the function must have at least as many arguments as there are parameters before the last comma. If no arguments are to be passed to the function, the list of parameters is replaced by the keyword **`void`**. This use of **`void`** is distinct from its use as a type specifier. diff --git a/docs/c-language/scope-and-visibility.md b/docs/c-language/scope-and-visibility.md index 72e07ffd0fb..74b22dfcf92 100644 --- a/docs/c-language/scope-and-visibility.md +++ b/docs/c-language/scope-and-visibility.md @@ -15,7 +15,7 @@ All identifiers except labels have their scope determined by the level at which The declarator or type specifier for an identifier with file scope appears outside any block or list of parameters and is accessible from any place in the translation unit after its declaration. Identifier names with file scope are often called "global" or "external." The scope of a global identifier begins at the point of its definition or declaration and terminates at the end of the translation unit. **Function scope**\ -A label is the only kind of identifier that has function scope. A label is declared implicitly by its use in a statement. Label names must be unique within a function. (For more information about labels and label names, see [The goto and Labeled Statements](../c-language/goto-and-labeled-statements-c.md).) +A label is the only kind of identifier that has function scope. A label is declared implicitly by its use in a statement. Label names must be unique within a function. For more information about labels and label names, see [The goto and Labeled Statements](../c-language/goto-and-labeled-statements-c.md). **Block scope**\ The declarator or type specifier for an identifier with block scope appears inside a block or within the list of formal parameter declarations in a function definition. It is visible only from the point of its declaration or definition to the end of the block containing its declaration or definition. Its scope is limited to that block and to any blocks nested in that block and ends at the curly brace that closes the associated block. Such identifiers are sometimes called "local variables." diff --git a/docs/c-language/typedef-declarations.md b/docs/c-language/typedef-declarations.md index 019f17fbdf9..50750abc3c5 100644 --- a/docs/c-language/typedef-declarations.md +++ b/docs/c-language/typedef-declarations.md @@ -43,7 +43,7 @@ A typedef declaration is interpreted in the same way as a variable or function d A typedef declaration doesn't create new types. It creates synonyms for existing types, or names for types that could be specified in other ways. When a typedef name is used as a type specifier, it can be combined with certain type specifiers, but not others. Acceptable modifiers include **`const`** and **`volatile`**. -Typedef names share the name space with ordinary identifiers. (For more information, see [Name Spaces](../c-language/name-spaces.md).) Therefore, a program can have a typedef name and a local-scope identifier by the same name. For example: +Typedef names share the name space with ordinary identifiers. For more information, see [Name Spaces](../c-language/name-spaces.md). Therefore, a program can have a typedef name and a local-scope identifier by the same name. For example: ```C typedef char FlagType; diff --git a/docs/c-runtime-library/code-pages.md b/docs/c-runtime-library/code-pages.md index f8700a2718f..d38deedd409 100644 --- a/docs/c-runtime-library/code-pages.md +++ b/docs/c-runtime-library/code-pages.md @@ -22,7 +22,7 @@ The Microsoft runtime library uses the following types of code pages: also sets the locale to the system-default ANSI code page. -- Locale code page. The behavior of several run-time routines is dependent on the current locale setting, which includes the locale code page. (For more information, see [Locale](./locale.md).) By default, all locale-dependent routines in the Microsoft run-time library use the code page that corresponds to the "C" locale. At run time, you can change or query the locale code page in use with a call to [`setlocale`](./reference/setlocale-wsetlocale.md). +- Locale code page. The behavior of several run-time routines is dependent on the current locale setting, which includes the locale code page. For more information, see [Locale](./locale.md). By default, all locale-dependent routines in the Microsoft run-time library use the code page that corresponds to the "C" locale. At run time, you can change or query the locale code page in use with a call to [`setlocale`](./reference/setlocale-wsetlocale.md). - Multibyte code page. The behavior of most of the multibyte-character routines in the run-time library depends on the current multibyte code page setting. By default, these routines use the system-default ANSI code page. At run-time you can query and change the multibyte code page with [`_getmbcp`](./reference/getmbcp.md) and [`_setmbcp`](./reference/setmbcp.md), respectively. diff --git a/docs/c-runtime-library/reference/open-wopen.md b/docs/c-runtime-library/reference/open-wopen.md index 6b72d3b25f5..eec84497e30 100644 --- a/docs/c-runtime-library/reference/open-wopen.md +++ b/docs/c-runtime-library/reference/open-wopen.md @@ -79,7 +79,7 @@ The **`_open`** function opens the file specified by *`filename`* and prepares i | `_O_RDONLY` | Opens a file for reading only. Can't be specified with `_O_RDWR` or `_O_WRONLY`. | | `_O_RDWR` | Opens a file for both reading and writing. Can't be specified with `_O_RDONLY` or `_O_WRONLY`. | | `_O_SEQUENTIAL` | Specifies that caching is optimized for, but not restricted to, sequential access from disk. | -| `_O_TEXT` | Opens a file in ANSI text (translated) mode. (For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md).) | +| `_O_TEXT` | Opens a file in ANSI text (translated) mode. For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md). | | `_O_TRUNC` | Opens a file and truncates it to zero length; the file must have write permission. Can't be specified with `_O_RDONLY`. `_O_TRUNC` used with `_O_CREAT` opens an existing file or creates a file. **Note:** The `_O_TRUNC` flag destroys the contents of the specified file. | | `_O_WRONLY` | Opens a file for writing only. Can't be specified with `_O_RDONLY` or `_O_RDWR`. | | `_O_U16TEXT` | Opens a file in Unicode UTF-16 mode. | @@ -96,7 +96,7 @@ If **`_open`** is called with **`_O_WRONLY | _O_APPEND`** (append mode) and `_O_ When two or more manifest constants are used to form the *`oflag`* argument, the constants are combined with the bitwise-OR operator ( **`|`** ). For a discussion of binary and text modes, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md). -The *`pmode`* argument is required only when `_O_CREAT` is specified. If the file already exists, *`pmode`* is ignored. Otherwise, *`pmode`* specifies the file permission settings, which are set when the new file is closed the first time. **`_open`** applies the current file-permission mask to *`pmode`* before the permissions are set. (For more information, see [`_umask`](umask.md).) *`pmode`* is an integer expression that contains one or both of the following manifest constants, which are defined in ``. +The *`pmode`* argument is required only when `_O_CREAT` is specified. If the file already exists, *`pmode`* is ignored. Otherwise, *`pmode`* specifies the file permission settings, which are set when the new file is closed the first time. **`_open`** applies the current file-permission mask to *`pmode`* before the permissions are set. For more information, see [`_umask`](umask.md). *`pmode`* is an integer expression that contains one or both of the following manifest constants, which are defined in ``. | *`pmode`* | Meaning | |--|--| diff --git a/docs/c-runtime-library/reference/sopen-s-wsopen-s.md b/docs/c-runtime-library/reference/sopen-s-wsopen-s.md index 04f2bd984a7..9be97bd7694 100644 --- a/docs/c-runtime-library/reference/sopen-s-wsopen-s.md +++ b/docs/c-runtime-library/reference/sopen-s-wsopen-s.md @@ -94,7 +94,7 @@ The integer expression *`oflag`* is formed by combining one or more manifest con | `_O_RDONLY` | Opens a file for reading only. Can't be specified with `_O_RDWR` or `_O_WRONLY`. | | `_O_RDWR` | Opens a file for both reading and writing. Can't be specified with `_O_RDONLY` or `_O_WRONLY`. | | `_O_SEQUENTIAL` | Specifies that caching is optimized for, but not restricted to, sequential access from disk. | -| `_O_TEXT` | Opens a file in ANSI text (translated) mode. (For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md).) | +| `_O_TEXT` | Opens a file in ANSI text (translated) mode. For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md). | | `_O_TRUNC` | Opens a file and truncates it to zero length; the file must have write permission. Can't be specified with `_O_RDONLY`. `_O_TRUNC` used with `_O_CREAT` opens an existing file or creates a file. **Note:** The `_O_TRUNC` flag destroys the contents of the specified file. | | `_O_WRONLY` | Opens a file for writing only. Can't be specified with `_O_RDONLY` or `_O_RDWR`. | | `_O_U16TEXT` | Opens a file in Unicode UTF-16 mode. | diff --git a/docs/c-runtime-library/reference/sopen-wsopen.md b/docs/c-runtime-library/reference/sopen-wsopen.md index c3e9b3a0aa2..2ea72da9b58 100644 --- a/docs/c-runtime-library/reference/sopen-wsopen.md +++ b/docs/c-runtime-library/reference/sopen-wsopen.md @@ -88,7 +88,7 @@ The integer expression *`oflag`* is formed by combining one or more of the follo | `_O_RDONLY` | Opens a file for reading only. Can't be specified with `_O_RDWR` or `_O_WRONLY`. | | `_O_RDWR` | Opens a file for both reading and writing. Can't be specified with `_O_RDONLY` or `_O_WRONLY`. | | `_O_SEQUENTIAL` | Specifies that caching is optimized for, but not restricted to, sequential access from disk. | -| `_O_TEXT` | Opens a file in ANSI text (translated) mode. (For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md).) | +| `_O_TEXT` | Opens a file in ANSI text (translated) mode. For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md). | | `_O_TRUNC` | Opens a file and truncates it to zero length; the file must have write permission. Can't be specified with `_O_RDONLY`. `_O_TRUNC` used with `_O_CREAT` opens an existing file or creates a file. **Note:** The `_O_TRUNC` flag destroys the contents of the specified file. | | `_O_WRONLY` | Opens a file for writing only. Can't be specified with `_O_RDONLY` or `_O_RDWR`. | | `_O_U16TEXT` | Opens a file in Unicode UTF-16 mode. | diff --git a/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md b/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md index 9d253c5cf24..541b23cf3e4 100644 --- a/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md +++ b/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md @@ -84,7 +84,7 @@ By default, this function's global state is scoped to the application. To change |---|---|---|---| | **`_tcsftime`** | **`strftime`** | **`strftime`** | **`wcsftime`** | -The *`format`* argument consists of one or more codes; as in **`printf`**, the formatting codes are preceded by a percent sign (**`%`**). Characters that don't begin with **`%`** are copied unchanged to *`strDest`*. The `LC_TIME` category of the current locale affects the output formatting of **`strftime`**. (For more information on `LC_TIME`, see [`setlocale`](setlocale-wsetlocale.md).) The **`strftime`** and **`wcsftime`** functions use the currently set locale. The **`_strftime_l`** and **`_wcsftime_l`** versions of these functions are identical except that they take the locale as a parameter and use that instead of the currently set locale. For more information, see [Locale](../locale.md). +The *`format`* argument consists of one or more codes; as in **`printf`**, the formatting codes are preceded by a percent sign (**`%`**). Characters that don't begin with **`%`** are copied unchanged to *`strDest`*. The `LC_TIME` category of the current locale affects the output formatting of **`strftime`**. For more information on `LC_TIME`, see [`setlocale`](setlocale-wsetlocale.md). The **`strftime`** and **`wcsftime`** functions use the currently set locale. The **`_strftime_l`** and **`_wcsftime_l`** versions of these functions are identical except that they take the locale as a parameter and use that instead of the currently set locale. For more information, see [Locale](../locale.md). The **`strftime`** functions support these formatting codes: diff --git a/docs/cpp/anonymous-class-types.md b/docs/cpp/anonymous-class-types.md index 591f8492676..53d162606f3 100644 --- a/docs/cpp/anonymous-class-types.md +++ b/docs/cpp/anonymous-class-types.md @@ -42,7 +42,7 @@ In the preceding code, `iValue` can be accessed using the object member-selectio int i = ptv.iValue; ``` -Anonymous classes are subject to certain restrictions. (For more information about anonymous unions, see [Unions](../cpp/unions.md).) Anonymous classes: +Anonymous classes are subject to certain restrictions. For more information about anonymous unions, see [Unions](../cpp/unions.md). Anonymous classes: - Cannot have a constructor or destructor. diff --git a/docs/cpp/fundamental-types-cpp.md b/docs/cpp/fundamental-types-cpp.md index 457e01bac46..1122ea1144f 100644 --- a/docs/cpp/fundamental-types-cpp.md +++ b/docs/cpp/fundamental-types-cpp.md @@ -14,11 +14,11 @@ Built-in types (also called *fundamental types*) are specified by the C++ langua The [`void`](void-cpp.md) type describes an empty set of values. No variable of type **`void`** can be specified. The **`void`** type is used primarily to declare functions that return no values or to declare generic pointers to untyped or arbitrarily typed data. Any expression can be explicitly converted or cast to type **`void`**. However, such expressions are restricted to the following uses: -- An expression statement. (For more information, see [Expressions](expressions-cpp.md).) +- An expression statement. For more information, see [Expressions](expressions-cpp.md). -- The left operand of the comma operator. (For more information, see [Comma Operator](comma-operator.md).) +- The left operand of the comma operator. For more information, see [Comma Operator](comma-operator.md). -- The second or third operand of the conditional operator (`? :`). (For more information, see [Expressions with the Conditional Operator](conditional-operator-q.md).) +- The second or third operand of the conditional operator (`? :`). For more information, see [Expressions with the Conditional Operator](conditional-operator-q.md). ## std::nullptr_t diff --git a/docs/cpp/multiple-base-classes.md b/docs/cpp/multiple-base-classes.md index d792657cd24..b71004540e0 100644 --- a/docs/cpp/multiple-base-classes.md +++ b/docs/cpp/multiple-base-classes.md @@ -142,7 +142,7 @@ The compiler detects ambiguities by performing tests in this order: 1. If overloaded functions are unambiguous, they're resolved. -1. If access to the name violates member-access permission, an error message is generated. (For more information, see [Member-Access Control](../cpp/member-access-control-cpp.md).) +1. If access to the name violates member-access permission, an error message is generated. For more information, see [Member-Access Control](../cpp/member-access-control-cpp.md). When an expression produces an ambiguity through inheritance, you can manually resolve it by qualifying the name in question with its class name. To make the preceding example compile properly with no ambiguities, use code such as: diff --git a/docs/cpp/pointers-to-members.md b/docs/cpp/pointers-to-members.md index 17e5da3112e..f92ee99c25e 100644 --- a/docs/cpp/pointers-to-members.md +++ b/docs/cpp/pointers-to-members.md @@ -121,7 +121,7 @@ The address of a static member isn't a pointer to a member. It's a regular point Invoking a virtual function through a pointer-to-member function works as if the function had been called directly. The correct function is looked up in the v-table and invoked. -The key to virtual functions working, as always, is invoking them through a pointer to a base class. (For more information about virtual functions, see [Virtual Functions](../cpp/virtual-functions.md).) +The key to virtual functions working, as always, is invoking them through a pointer to a base class. For more information about virtual functions, see [Virtual Functions](../cpp/virtual-functions.md). The following code shows how to invoke a virtual function through a pointer-to-member function: diff --git a/docs/cpp/postfix-expressions.md b/docs/cpp/postfix-expressions.md index 9ed1835bcfc..635fddc23d1 100644 --- a/docs/cpp/postfix-expressions.md +++ b/docs/cpp/postfix-expressions.md @@ -72,7 +72,7 @@ When a function is called, the following tasks are performed: Func( Temp_i ); ``` - Note that the initialization is performed as if using the equal-sign syntax instead of the parentheses syntax. A copy of `i` is made prior to passing the value to the function. (For more information, see [Initializers](../cpp/initializers.md) and [Conversions](../cpp/user-defined-type-conversions-cpp.md)). + Note that the initialization is performed as if using the equal-sign syntax instead of the parentheses syntax. A copy of `i` is made prior to passing the value to the function. For more information, see [Initializers](../cpp/initializers.md) and [Conversions](../cpp/user-defined-type-conversions-cpp.md). Therefore, if the function prototype (declaration) calls for an argument of type **`long`**, and if the calling program supplies an actual argument of type **`int`**, the actual argument is promoted using a standard type conversion to type **`long`** (see [Standard Conversions](../cpp/standard-conversions.md)). diff --git a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md index 4d06719b107..9113738138e 100644 --- a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md +++ b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md @@ -16,7 +16,7 @@ postfix-expression -- ## Remarks -C++ provides prefix and postfix increment and decrement operators; this section describes only the postfix increment and decrement operators. (For more information, see [Prefix Increment and Decrement Operators](../cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md).) The difference between the two is that in the postfix notation, the operator appears after *postfix-expression*, whereas in the prefix notation, the operator appears before *expression.* The following example shows a postfix-increment operator: +C++ provides prefix and postfix increment and decrement operators; this section describes only the postfix increment and decrement operators. For more information, see [Prefix Increment and Decrement Operators](../cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md). The difference between the two is that in the postfix notation, the operator appears after *postfix-expression*, whereas in the prefix notation, the operator appears before *expression.* The following example shows a postfix-increment operator: ```cpp i++; diff --git a/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md index 238ae3dfb0e..f83cef3e6ba 100644 --- a/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md +++ b/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md @@ -23,7 +23,7 @@ The prefix decrement operator (**`--`**) is analogous to the prefix increment op **Visual Studio 2017 version 15.3 and later** (available in [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) mode and later): The operand of an increment or decrement operator may not be of type **`bool`**. -Both the prefix and postfix increment and decrement operators affect their operands. The key difference between them is the order in which the increment or decrement takes place in the evaluation of an expression. (For more information, see [Postfix Increment and Decrement Operators](../cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md).) In the prefix form, the increment or decrement takes place before the value is used in expression evaluation, so the value of the expression is different from the value of the operand. In the postfix form, the increment or decrement takes place after the value is used in expression evaluation, so the value of the expression is the same as the value of the operand. For example, the following program prints "`++i = 6`": +Both the prefix and postfix increment and decrement operators affect their operands. The key difference between them is the order in which the increment or decrement takes place in the evaluation of an expression. For more information, see [Postfix Increment and Decrement Operators](../cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md). In the prefix form, the increment or decrement takes place before the value is used in expression evaluation, so the value of the expression is different from the value of the operand. In the postfix form, the increment or decrement takes place after the value is used in expression evaluation, so the value of the expression is the same as the value of the operand. For example, the following program prints "`++i = 6`": ```cpp // expre_Increment_and_Decrement_Operators.cpp diff --git a/docs/cpp/standard-conversions.md b/docs/cpp/standard-conversions.md index 083ac66a0f1..51f3f370461 100644 --- a/docs/cpp/standard-conversions.md +++ b/docs/cpp/standard-conversions.md @@ -203,7 +203,7 @@ The second case in which a pointer to a class can be converted to a pointer to a The result of such a conversion is a pointer to the *subobject*, the portion of the object that is completely described by the base class. -The following code defines two classes, `A` and `B`, where `B` is derived from `A`. (For more information on inheritance, see [Derived Classes](../cpp/inheritance-cpp.md).) It then defines `bObject`, an object of type `B`, and two pointers (`pA` and `pB`) that point to the object. +The following code defines two classes, `A` and `B`, where `B` is derived from `A`. For more information on inheritance, see [Derived Classes](../cpp/inheritance-cpp.md). It then defines `bObject`, an object of type `B`, and two pointers (`pA` and `pB`) that point to the object. ```cpp // C2039 expected @@ -278,7 +278,7 @@ A reference to a class can be converted to a reference to a base class in these - The specified base class is accessible. -- The conversion is unambiguous. (For more information about ambiguous base-class references, see [Multiple base classes](../cpp/multiple-base-classes.md).) +- The conversion is unambiguous. For more information about ambiguous base-class references, see [Multiple base classes](../cpp/multiple-base-classes.md). The result of the conversion is a pointer to the subobject that represents the base class. diff --git a/docs/cpp/virtual-functions.md b/docs/cpp/virtual-functions.md index 665db8ecdf3..0dda0b13f22 100644 --- a/docs/cpp/virtual-functions.md +++ b/docs/cpp/virtual-functions.md @@ -137,7 +137,7 @@ Because virtual functions are called only for objects of class types, you cannot The **`virtual`** keyword can be used when declaring overriding functions in a derived class, but it is unnecessary; overrides of virtual functions are always virtual. -Virtual functions in a base class must be defined unless they are declared using the *pure-specifier*. (For more information about pure virtual functions, see [Abstract Classes](../cpp/abstract-classes-cpp.md).) +Virtual functions in a base class must be defined unless they are declared using the *pure-specifier*. For more information about pure virtual functions, see [Abstract Classes](../cpp/abstract-classes-cpp.md). The virtual function-call mechanism can be suppressed by explicitly qualifying the function name using the scope-resolution operator (`::`). Consider the earlier example involving the `Account` class. To call `PrintBalance` in the base class, use code such as the following: diff --git a/docs/cppcx/wrl/weakref-class.md b/docs/cppcx/wrl/weakref-class.md index 227bdd1cf25..f927b0de418 100644 --- a/docs/cppcx/wrl/weakref-class.md +++ b/docs/cppcx/wrl/weakref-class.md @@ -193,7 +193,7 @@ When this operation completes, an object that represents parameter *`riid`*. - `S_OK` if this operation succeeds, but the current `WeakRef` object has already been released. Parameter *`ptr`* is set to **`nullptr`**. -- `S_OK` if this operation succeeds, but the current `WeakRef` object isn't derived from parameter *`riid`*. Parameter *`ptr`* is set to **`nullptr`**. (For more information, see Remarks.) +- `S_OK` if this operation succeeds, but the current `WeakRef` object isn't derived from parameter *`riid`*. Parameter *`ptr`* is set to **`nullptr`**. For more information, see Remarks. ### Remarks diff --git a/docs/dotnet/how-to-migrate-to-clr.md b/docs/dotnet/how-to-migrate-to-clr.md index f7b4922791c..01756ffc80a 100644 --- a/docs/dotnet/how-to-migrate-to-clr.md +++ b/docs/dotnet/how-to-migrate-to-clr.md @@ -9,7 +9,7 @@ ms.topic: upgrade-and-migration-article --- # How to: Migrate to `/clr` -This article discusses issues that arise when compiling native code with **`/clr`**. (For more information, see [/clr (Common Language Runtime Compilation)](../build/reference/clr-common-language-runtime-compilation.md).) **`/clr`** allows native C++ code to invoke and be invoked from .NET assemblies in addition to other native C++ code. For more information on the advantages of compiling with **`/clr`**, see [Mixed (Native and Managed) Assemblies](../dotnet/mixed-native-and-managed-assemblies.md) and [Native and .NET Interoperability](../dotnet/native-and-dotnet-interoperability.md). +This article discusses issues that arise when compiling native code with **`/clr`**. For more information, see [/clr (Common Language Runtime Compilation)](../build/reference/clr-common-language-runtime-compilation.md). **`/clr`** allows native C++ code to invoke and be invoked from .NET assemblies in addition to other native C++ code. For more information on the advantages of compiling with **`/clr`**, see [Mixed (Native and Managed) Assemblies](../dotnet/mixed-native-and-managed-assemblies.md) and [Native and .NET Interoperability](../dotnet/native-and-dotnet-interoperability.md). ## Known issues compiling library projects with `/clr` @@ -120,7 +120,7 @@ Native types are **`private`** by default. A **`private`** native type isn't vis ### Floating point and alignment issues -`__controlfp` isn't supported in the common language runtime. (For more information, see [`_control87`, `_controlfp`, `__control87_2`](../c-runtime-library/reference/control87-controlfp-control87-2.md).) The CLR also doesn't respect [`align`](../cpp/align-cpp.md). +`__controlfp` isn't supported in the common language runtime. For more information, see [`_control87`, `_controlfp`, `__control87_2`](../c-runtime-library/reference/control87-controlfp-control87-2.md). The CLR also doesn't respect [`align`](../cpp/align-cpp.md). ### COM initialization diff --git a/docs/mfc/exception-handling-in-mfc.md b/docs/mfc/exception-handling-in-mfc.md index 3d16c77f89e..105a773e48c 100644 --- a/docs/mfc/exception-handling-in-mfc.md +++ b/docs/mfc/exception-handling-in-mfc.md @@ -40,7 +40,7 @@ Three categories of outcomes can occur when a function is called during program - Erroneous execution - The caller makes some mistake in passing arguments to the function or calls the function in an inappropriate context. This situation causes an error, and it should be detected by an assertion during program development. (For more information on assertions, see [C/C++ Assertions](/visualstudio/debugger/c-cpp-assertions).) + The caller makes some mistake in passing arguments to the function or calls the function in an inappropriate context. This situation causes an error, and it should be detected by an assertion during program development. For more information on assertions, see [C/C++ Assertions](/visualstudio/debugger/c-cpp-assertions). - Abnormal execution diff --git a/docs/mfc/reference/cbasepane-class.md b/docs/mfc/reference/cbasepane-class.md index b535d8ccdda..de3b9ea5943 100644 --- a/docs/mfc/reference/cbasepane-class.md +++ b/docs/mfc/reference/cbasepane-class.md @@ -565,8 +565,8 @@ The library adds several new styles for panes. The following table describes the |AFX_CBRS_RESIZE|The pane can be resized. **Important:** This style is not implemented.| |AFX_CBRS_CLOSE|The pane can be closed.| |AFX_CBRS_AUTO_ROLLUP|The pane can be rolled up when it floats.| -|AFX_CBRS_REGULAR_TABS|When one pane docks to another pane that has this style, a regular tabbed window is created. (For more information, see [CTabbedPane Class](../../mfc/reference/ctabbedpane-class.md).)| -|AFX_CBRS_OUTLOOK_TABS|When one pane docks to another pane that has this style, an Outlook-style tabbed window is created. (For more information, see [CMFCOutlookBar Class](../../mfc/reference/cmfcoutlookbar-class.md).)| +|AFX_CBRS_REGULAR_TABS|When one pane docks to another pane that has this style, a regular tabbed window is created. For more information, see [CTabbedPane Class](../../mfc/reference/ctabbedpane-class.md).| +|AFX_CBRS_OUTLOOK_TABS|When one pane docks to another pane that has this style, an Outlook-style tabbed window is created. For more information, see [CMFCOutlookBar Class](../../mfc/reference/cmfcoutlookbar-class.md).| To use the new styles, specify them in *dwControlBarStyle*. diff --git a/docs/mfc/reference/cfont-class.md b/docs/mfc/reference/cfont-class.md index 2b224015505..6a91e72bb95 100644 --- a/docs/mfc/reference/cfont-class.md +++ b/docs/mfc/reference/cfont-class.md @@ -141,7 +141,7 @@ Specifies the desired clipping precision. The clipping precision defines how to To use an embedded read-only font, an application must specify `CLIP_ENCAPSULATE`. -To achieve consistent rotation of device, TrueType, and vector fonts, an application can use the bitwise OR operator (`|`) to combine the `CLIP_LH_ANGLES` value with any of the other *`nClipPrecision`* values. If the `CLIP_LH_ANGLES` bit is set, the rotation for all fonts depends on whether the orientation of the coordinate system is left-handed or right-handed. (For more information about the orientation of coordinate systems, see the description of the *`nOrientation`* parameter.) If `CLIP_LH_ANGLES` is not set, device fonts always rotate counterclockwise, but the rotation of other fonts is dependent on the orientation of the coordinate system. +To achieve consistent rotation of device, TrueType, and vector fonts, an application can use the bitwise OR operator (`|`) to combine the `CLIP_LH_ANGLES` value with any of the other *`nClipPrecision`* values. If the `CLIP_LH_ANGLES` bit is set, the rotation for all fonts depends on whether the orientation of the coordinate system is left-handed or right-handed. For more information about the orientation of coordinate systems, see the description of the *`nOrientation`* parameter. If `CLIP_LH_ANGLES` is not set, device fonts always rotate counterclockwise, but the rotation of other fonts is dependent on the orientation of the coordinate system. *`nQuality`*
Specifies the font's output quality, which defines how carefully the GDI must attempt to match the logical-font attributes to those of an actual physical font. See the `lfQuality` member in the `LOGFONT` structure in the Windows SDK for a list of values. From c98d86ab0eb5545db0a5df91a367de517cf5ffb9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 01:34:49 +0800 Subject: [PATCH 0550/1799] Update metadata in 21 topics --- docs/c-language/c-comments.md | 5 ++--- docs/c-language/initializing-scalar-types.md | 5 ++--- docs/c-language/l-value-and-r-value-expressions.md | 5 ++--- docs/c-language/parameters.md | 5 ++--- docs/c-language/scope-and-visibility.md | 5 ++--- docs/c-language/typedef-declarations.md | 5 ++--- docs/c-runtime-library/code-pages.md | 3 +-- docs/c-runtime-library/reference/open-wopen.md | 3 +-- docs/c-runtime-library/reference/sopen-wsopen.md | 3 +-- .../reference/strftime-wcsftime-strftime-l-wcsftime-l.md | 5 ++--- docs/cpp/anonymous-class-types.md | 5 ++--- docs/cpp/fundamental-types-cpp.md | 3 +-- docs/cpp/multiple-base-classes.md | 4 ++-- docs/cpp/pointers-to-members.md | 5 ++--- docs/cpp/postfix-expressions.md | 5 ++--- ...ment-and-decrement-operators-increment-and-decrement.md | 5 ++--- docs/cpp/standard-conversions.md | 4 ++-- docs/cpp/virtual-functions.md | 7 +++---- docs/cppcx/wrl/weakref-class.md | 2 +- docs/dotnet/how-to-migrate-to-clr.md | 7 +++---- docs/mfc/exception-handling-in-mfc.md | 5 ++--- 21 files changed, 39 insertions(+), 57 deletions(-) diff --git a/docs/c-language/c-comments.md b/docs/c-language/c-comments.md index f4cb0ff24b5..bae13131370 100644 --- a/docs/c-language/c-comments.md +++ b/docs/c-language/c-comments.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: C Comments" title: "C Comments" -ms.date: "06/25/2018" +description: "Learn more about: C Comments" +ms.date: 06/25/2018 helpviewer_keywords: ["code comments, C code", "comments, documenting code", "comments, C code", "/* */ comment delimiters", "comments"] -ms.assetid: 0f5f2825-e673-49e7-8669-94e2f5294989 --- # C Comments diff --git a/docs/c-language/initializing-scalar-types.md b/docs/c-language/initializing-scalar-types.md index 8f195455169..bcd7ca93c1f 100644 --- a/docs/c-language/initializing-scalar-types.md +++ b/docs/c-language/initializing-scalar-types.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Initializing Scalar Types" title: "Initializing Scalar Types" -ms.date: "11/04/2016" +description: "Learn more about: Initializing Scalar Types" +ms.date: 11/04/2016 helpviewer_keywords: ["initializing scalar types", "register variables", "initialization, scalar types", "initializing variables, scalar types", "scalar types", "static variables, initializing", "automatic storage class, initializing scalar types", "automatic storage class", "types [C], initializing"] -ms.assetid: 73c516f5-c3ad-4d56-ab3b-f2a82b621104 --- # Initializing Scalar Types diff --git a/docs/c-language/l-value-and-r-value-expressions.md b/docs/c-language/l-value-and-r-value-expressions.md index 423efc65b38..5a646ce54db 100644 --- a/docs/c-language/l-value-and-r-value-expressions.md +++ b/docs/c-language/l-value-and-r-value-expressions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: L-Value and R-Value Expressions" title: "L-Value and R-Value Expressions" -ms.date: "11/04/2016" +description: "Learn more about: L-Value and R-Value Expressions" +ms.date: 11/04/2016 helpviewer_keywords: ["L-values", "member-selection expressions", "R-value expressions", "subscript expressions"] -ms.assetid: b790303e-ec6f-4d0d-bc55-df42da267172 --- # L-Value and R-Value Expressions diff --git a/docs/c-language/parameters.md b/docs/c-language/parameters.md index 1cf21be2848..f2eb26888e8 100644 --- a/docs/c-language/parameters.md +++ b/docs/c-language/parameters.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Parameters" title: "Parameters" -ms.date: "11/04/2016" +description: "Learn more about: Parameters" +ms.date: 11/04/2016 helpviewer_keywords: ["arguments [C++], function", "function parameters", "parameters [C++]", "function arguments, vs. parameters", "parameters [C++], function", "functions [C], parameters", "function parameters, syntax", "ellipsis (...), parameters", "... ellipsis"] -ms.assetid: 8f2b8026-78b5-4e21-86a3-bf0f91f05689 --- # Parameters diff --git a/docs/c-language/scope-and-visibility.md b/docs/c-language/scope-and-visibility.md index 74b22dfcf92..8f61550b6cb 100644 --- a/docs/c-language/scope-and-visibility.md +++ b/docs/c-language/scope-and-visibility.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Scope and Visibility" title: "Scope and Visibility" -ms.date: "11/04/2016" +description: "Learn more about: Scope and Visibility" +ms.date: 11/04/2016 helpviewer_keywords: ["scope, levels", "visibility", "file scope [C++]"] -ms.assetid: a019eb7c-66ed-46a7-bc9f-89a963930a56 --- # Scope and Visibility diff --git a/docs/c-language/typedef-declarations.md b/docs/c-language/typedef-declarations.md index 50750abc3c5..b503212b6c4 100644 --- a/docs/c-language/typedef-declarations.md +++ b/docs/c-language/typedef-declarations.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Typedef Declarations" title: "Typedef Declarations" -ms.date: "11/04/2016" +description: "Learn more about: Typedef Declarations" +ms.date: 11/04/2016 helpviewer_keywords: ["declarations, typedef", "typedef declarations", "types [C], declarations"] -ms.assetid: e92a3b82-9269-4bc6-834a-6f431ccac83e --- # Typedef Declarations diff --git a/docs/c-runtime-library/code-pages.md b/docs/c-runtime-library/code-pages.md index d38deedd409..25a6e84f5df 100644 --- a/docs/c-runtime-library/code-pages.md +++ b/docs/c-runtime-library/code-pages.md @@ -1,10 +1,9 @@ --- title: "Code Pages" description: "A description of code page support in the Microsoft C runtime." +ms.date: 11/04/2016 ms.topic: "concept-article" -ms.date: "11/04/2016" helpviewer_keywords: ["character sets [C++], code pages", "ANSI [C++], code pages", "system-default code page", "multibyte code pages [C++]", "localization [C++], code pages", "code pages [C++], types of", "locale code pages [C++]"] -ms.assetid: 4a26fc42-185a-4add-98bf-a7b314ae6186 --- # Code pages diff --git a/docs/c-runtime-library/reference/open-wopen.md b/docs/c-runtime-library/reference/open-wopen.md index eec84497e30..13237079cad 100644 --- a/docs/c-runtime-library/reference/open-wopen.md +++ b/docs/c-runtime-library/reference/open-wopen.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _open, _wopen" title: "_open, _wopen" +description: "Learn more about: _open, _wopen" ms.date: 05/18/2022 api_name: ["_open", "_wopen"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_IO/_open", "CORECRT_WIO/_wopen", "TCHAR/_topen", "_open", "_wopen", "_topen"] helpviewer_keywords: ["opening files, for file I/O", "topen function", "_open function", "_topen function", "_wopen function", "files [C++], opening", "wopen function", "open function"] -ms.assetid: 13f6a0c3-d1aa-450d-a7aa-74abc91b163e --- # `_open`, `_wopen` diff --git a/docs/c-runtime-library/reference/sopen-wsopen.md b/docs/c-runtime-library/reference/sopen-wsopen.md index 2ea72da9b58..8d57455bb24 100644 --- a/docs/c-runtime-library/reference/sopen-wsopen.md +++ b/docs/c-runtime-library/reference/sopen-wsopen.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _sopen, _wsopen" title: "_sopen, _wsopen" +description: "Learn more about: _sopen, _wsopen" ms.date: 05/18/2022 api_name: ["_sopen", "_wsopen", "_o__sopen"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_IO/_sopen", "CORECRT_WIO/_wsopen", "TCHAR/_tsopen", "_sopen", "_wsopen", "_tsopen", "sopen", "wsopen"] helpviewer_keywords: ["sopen function", "sharing files", "opening files, for sharing", "_sopen function", "wsopen function", "files [C++], opening", "files [C++], sharing", "_wsopen function"] -ms.assetid: a9d4cccf-06e9-414d-96fa-453fca88cc1f --- # `_sopen`, `_wsopen` diff --git a/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md b/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md index 541b23cf3e4..92cf4ff91eb 100644 --- a/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md +++ b/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: strftime, wcsftime, _strftime_l, _wcsftime_l" title: "strftime, wcsftime, _strftime_l, _wcsftime_l" -ms.date: "4/2/2020" +description: "Learn more about: strftime, wcsftime, _strftime_l, _wcsftime_l" +ms.date: 4/2/2020 api_name: ["strftime", "_wcsftime_l", "_strftime_l", "wcsftime", "_o__strftime_l", "_o__wcsftime_l", "_o_strftime", "_o_wcsftime"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-time-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_tcsftime", "strftime", "wcsftime", "_strftime_l", "_wcsftime_l"] helpviewer_keywords: ["_strftime_l function", "strftime function", "tcsftime function", "_wcsftime_l function", "wcsftime function", "_tcsftime function", "time strings"] -ms.assetid: 6330ff20-4729-4c4a-82af-932915d893ea --- # `strftime`, `wcsftime`, `_strftime_l`, `_wcsftime_l` diff --git a/docs/cpp/anonymous-class-types.md b/docs/cpp/anonymous-class-types.md index 53d162606f3..2e26ebc728b 100644 --- a/docs/cpp/anonymous-class-types.md +++ b/docs/cpp/anonymous-class-types.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Anonymous Class Types" title: "Anonymous Class Types" -ms.date: "11/04/2016" +description: "Learn more about: Anonymous Class Types" +ms.date: 11/04/2016 helpviewer_keywords: ["class types [C++], anonymous", "anonymous class types"] -ms.assetid: 9ba667b2-8c2a-4c29-82a6-fa120b9233c8 --- # Anonymous Class Types diff --git a/docs/cpp/fundamental-types-cpp.md b/docs/cpp/fundamental-types-cpp.md index 1122ea1144f..69c1c4ca01d 100644 --- a/docs/cpp/fundamental-types-cpp.md +++ b/docs/cpp/fundamental-types-cpp.md @@ -1,10 +1,9 @@ --- +title: "Built-in types (C++)" description: "Learn more about: Built-in types (C++)" -title: "Built-in types (C++)" ms.date: 07/22/2020 f1_keywords: ["__int128_cpp", "__wchar_t_cpp", "char_cpp", "char8_t_cpp", "char16_t_cpp", "char32_t_cpp", "double_cpp", "float_cpp", "int_cpp", "long_cpp", "long_double_cpp", "short_cpp", "signed_cpp", "unsigned_cpp", "unsigned_int_cpp", "wchar_t_cpp"] helpviewer_keywords: ["specifiers [C++], type", "float keyword [C++]", "char keyword [C++]", "__wchar_t keyword [C++]", "signed types [C++], summary of data types", "Integer data type [C++], C++ data types", "arithmetic operations [C++], types", "int data type", "unsigned types [C++], summary of data types", "short data type [C++]", "double data type [C++], summary of types", "long long keyword [C++]", "long double keyword [C++]", "unsigned types [C++]", "signed types [C++]", "void keyword [C++]", "storage [C++], basic type", "integral types, C++", "wchar_t keyword [C++]", "floating-point numbers [C++], C++ data types", "long keyword [C++]", "type specifiers [C++]", "integral types", "long keyword [C++]", "storing types [C++]", "data types [C++], void"] -ms.assetid: 58b0106a-0406-4b74-a430-7cbd315c0f89 --- # Built-in types (C++) diff --git a/docs/cpp/multiple-base-classes.md b/docs/cpp/multiple-base-classes.md index b71004540e0..2ed89233621 100644 --- a/docs/cpp/multiple-base-classes.md +++ b/docs/cpp/multiple-base-classes.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Multiple Base Classes" title: "Multiple Base Classes" -ms.date: "11/19/2018" +description: "Learn more about: Multiple Base Classes" +ms.date: 11/19/2018 helpviewer_keywords: ["base classes [C++], multiple", "derived classes [C++], multiple bases", "multiple inheritance, class declaration", "multiple base classes [C++]"] --- # Multiple Base Classes diff --git a/docs/cpp/pointers-to-members.md b/docs/cpp/pointers-to-members.md index f92ee99c25e..9512ed71b35 100644 --- a/docs/cpp/pointers-to-members.md +++ b/docs/cpp/pointers-to-members.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Pointers to Members" title: "Pointers to Members" -ms.date: "11/04/2016" +description: "Learn more about: Pointers to Members" +ms.date: 11/04/2016 helpviewer_keywords: ["declarations, pointers", "class members [C++], pointers to", "pointers, to members", "members [C++], pointers to", "pointers, declarations"] -ms.assetid: f42ddb79-9721-4e39-95b1-c56b55591f68 --- # Pointers to Members diff --git a/docs/cpp/postfix-expressions.md b/docs/cpp/postfix-expressions.md index 635fddc23d1..dbb3ab65ddb 100644 --- a/docs/cpp/postfix-expressions.md +++ b/docs/cpp/postfix-expressions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Postfix Expressions" title: "Postfix Expressions" -ms.date: "11/04/2016" +description: "Learn more about: Postfix Expressions" +ms.date: 11/04/2016 helpviewer_keywords: ["operators [C++], postfix", "postfix expressions", "expressions [C++], postfix"] -ms.assetid: 7ac62a57-06df-422f-b012-a75b37d7cb9b --- # Postfix Expressions diff --git a/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md index f83cef3e6ba..0ca9c55341a 100644 --- a/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md +++ b/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Prefix Increment and Decrement Operators: ++ and --" title: "Prefix Increment and Decrement Operators: ++ and --" -ms.date: "11/04/2016" +description: "Learn more about: Prefix Increment and Decrement Operators: ++ and --" +ms.date: 11/04/2016 f1_keywords: ["--", "++"] helpviewer_keywords: ["increment operators [C++], syntax", "++ operator [C++], prefix increment operators", "operators [C++], decrement", "-- operator [C++], prefix decrement operators [C++]", "operators [C++], increment", "decrement operators [C++], syntax", "decrement operators [C++]"] -ms.assetid: 45ea7fc7-f279-4be9-a216-1d9a0ef9eb7b --- # Prefix Increment and Decrement Operators: `++` and `--` diff --git a/docs/cpp/standard-conversions.md b/docs/cpp/standard-conversions.md index 51f3f370461..aabdc570be3 100644 --- a/docs/cpp/standard-conversions.md +++ b/docs/cpp/standard-conversions.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Standard conversions" title: "Standard conversions" -ms.date: "10/02/2019" +description: "Learn more about: Standard conversions" +ms.date: 10/02/2019 helpviewer_keywords: ["standard conversions, categories of", "L-values [C++]", "conversions, standard"] --- # Standard conversions diff --git a/docs/cpp/virtual-functions.md b/docs/cpp/virtual-functions.md index 0dda0b13f22..308dcd25756 100644 --- a/docs/cpp/virtual-functions.md +++ b/docs/cpp/virtual-functions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Virtual Functions" title: "Virtual Functions" -ms.date: "09/10/2019" -helpviewer_keywords: ["functions [C++], virtual functions", "derived classes [C++], virtual functions", "virtual functions"] -ms.assetid: b3e1ed88-2a90-4af8-960a-16f47deb3452 +description: "Learn more about: Virtual Functions" +ms.date: 09/10/2019 adobe-target: true +helpviewer_keywords: ["functions [C++], virtual functions", "derived classes [C++], virtual functions", "virtual functions"] --- # Virtual Functions diff --git a/docs/cppcx/wrl/weakref-class.md b/docs/cppcx/wrl/weakref-class.md index f927b0de418..66191b5c263 100644 --- a/docs/cppcx/wrl/weakref-class.md +++ b/docs/cppcx/wrl/weakref-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: WeakRef Class" title: "WeakRef Class" +description: "Learn more about: WeakRef Class" ms.date: 11/22/2021 ms.topic: "reference" f1_keywords: ["client/Microsoft::WRL::WeakRef", "client/Microsoft::WRL::WeakRef::~WeakRef", "client/Microsoft::WRL::WeakRef::As", "client/Microsoft::WRL::WeakRef::AsIID", "client/Microsoft::WRL::WeakRef::CopyTo", "client/Microsoft::WRL::WeakRef::operator&", "client/Microsoft::WRL::WeakRef::WeakRef"] diff --git a/docs/dotnet/how-to-migrate-to-clr.md b/docs/dotnet/how-to-migrate-to-clr.md index 01756ffc80a..e05adbbaf9b 100644 --- a/docs/dotnet/how-to-migrate-to-clr.md +++ b/docs/dotnet/how-to-migrate-to-clr.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: How to: Migrate to /clr" title: "How to: Migrate to /clr" +description: "Learn more about: How to: Migrate to /clr" +ms.date: 09/18/2018 ms.custom: "get-started-article" -ms.date: "09/18/2018" -helpviewer_keywords: ["upgrading Visual C++ applications, /clr compiler option", "compiling native code [C++]", "interoperability [C++], /clr compiler option", "interop [C++], /clr compiler option", "migration [C++], /clr compiler option", "/clr compiler option [C++], porting to"] -ms.assetid: c9290b8b-436a-4510-8b56-eae51f4a9afc ms.topic: upgrade-and-migration-article +helpviewer_keywords: ["upgrading Visual C++ applications, /clr compiler option", "compiling native code [C++]", "interoperability [C++], /clr compiler option", "interop [C++], /clr compiler option", "migration [C++], /clr compiler option", "/clr compiler option [C++], porting to"] --- # How to: Migrate to `/clr` diff --git a/docs/mfc/exception-handling-in-mfc.md b/docs/mfc/exception-handling-in-mfc.md index 105a773e48c..29b8e759bf4 100644 --- a/docs/mfc/exception-handling-in-mfc.md +++ b/docs/mfc/exception-handling-in-mfc.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Exception Handling in MFC" title: "Exception Handling in MFC" -ms.date: "11/19/2019" +description: "Learn more about: Exception Handling in MFC" +ms.date: 11/19/2019 helpviewer_keywords: ["DAO [MFC], exceptions", "assertions [MFC], When to use exceptions", "exception handling [MFC], MFC", "resource allocation exception", "resources [MFC], allocating", "keywords [MFC], exception handling", "errors [MFC], detected by assertions", "ODBC exceptions [MFC]", "serialization [MFC], exceptions", "Automation [MFC], exceptions", "exception macros [MFC]", "predefined exceptions [MFC]", "C++ exception handling [MFC], enabling", "C++ exception handling [MFC], MFC applications", "requests for unsupported services [MFC]", "database exceptions [MFC]", "archive exceptions [MFC]", "MFC, exceptions", "C++ exception handling [MFC], types of", "macros [MFC], exception handling", "abnormal program execution [MFC]", "OLE exceptions [MFC], MFC exception handling", "error handling [MFC], exceptions and", "class libraries [MFC], exception support", "exceptions [MFC], MFC macros vs. C++ keywords", "memory [MFC], out-of-memory exceptions", "Windows [MFC], resource allocation exceptions", "macros [MFC], MFC exception macros", "function calls [MFC], results", "out-of-memory exceptions [MFC]"] -ms.assetid: 0926627d-2ba7-44a6-babe-d851a4a2517c --- # Exception Handling in MFC From 82697ef9efaa2304d46504b7ff2cc94ff21f02d4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 22:29:11 +0800 Subject: [PATCH 0551/1799] Update `/events` links to `/shows` --- docs/build-insights/tutorials/build-insights-function-view.md | 2 +- .../tutorials/build-insights-included-files-view.md | 2 +- docs/build-insights/tutorials/build-insights-tips.md | 2 +- docs/build/cmake-presets-vs.md | 2 +- docs/standard-library/random.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-function-view.md b/docs/build-insights/tutorials/build-insights-function-view.md index bd0ccd9e319..f22dcaef188 100644 --- a/docs/build-insights/tutorials/build-insights-function-view.md +++ b/docs/build-insights/tutorials/build-insights-function-view.md @@ -145,7 +145,7 @@ Double-click, right-click, or press **Enter** while on a file in the **Functions [Build Insights tips and tricks](build-insights-tips.md)\ [Inline functions (C++)](../../cpp/inline-functions-cpp.md)\ [Faster C++ builds, simplified: a new metric for time](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time)\ -[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/events/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ +[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/shows/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ [Troubleshoot header file impact on build time](build-insights-included-files-view.md)\ [Functions View for Build Insights in Visual Studio 2022 17.8](https://devblogs.microsoft.com/cppblog/functions-view-for-build-insights-in-visual-studio-2022-17-8/)\ [Tutorial: vcperf and Windows Performance Analyzer](vcperf-and-wpa.md)\ diff --git a/docs/build-insights/tutorials/build-insights-included-files-view.md b/docs/build-insights/tutorials/build-insights-included-files-view.md index 0b686653516..3d4422e5572 100644 --- a/docs/build-insights/tutorials/build-insights-included-files-view.md +++ b/docs/build-insights/tutorials/build-insights-included-files-view.md @@ -183,7 +183,7 @@ Or, you can right-click a file in the **Include Tree** view to jump to it in the [Build Insights tips and tricks](build-insights-tips.md)\ [Compare header units, modules, and precompiled headers](../../build/compare-inclusion-methods.md)\ -[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/events/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ +[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/shows/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ [Faster C++ builds, simplified: a new metric for time](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time)\ [Troubleshoot function inlining on build time](build-insights-function-view.md)\ [vcperf and Windows Performance Analyzer](vcperf-and-wpa.md) diff --git a/docs/build-insights/tutorials/build-insights-tips.md b/docs/build-insights/tutorials/build-insights-tips.md index d071aadddaf..b9c2b0e6f6c 100644 --- a/docs/build-insights/tutorials/build-insights-tips.md +++ b/docs/build-insights/tutorials/build-insights-tips.md @@ -73,7 +73,7 @@ To see a short description for the tabs in the Build Insights window, along with ## See also -[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/events/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ +[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/shows/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ [Improving code generation time with C++ Build Insights](https://devblogs.microsoft.com/cppblog/improving-code-generation-time-with-cpp-build-insights)\ [Troubleshoot header file impact on build time](build-insights-included-files-view.md)\ [Tutorial: Troubleshoot function inlining on build time](build-insights-function-view.md) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index d2d2f03f8a6..c23559cb99f 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -478,7 +478,7 @@ cmake --build --preset ## Example *`CMakePresets.json`* file -The *`CMakePresets.json`* file in [box2d-lite](https://github.com/esweet431/box2d-lite/blob/vs-launch/CMakePresets.json) contains examples of Configure Presets, Build Presets, and Test Presets. For more information about this example, see the presentation [An Introduction to CMakePresets.json](/events/cpp-pure-virtual-cpp-2021/an-introduction-to-cmakepresetsjson). You can see another example in the [DirectXTK](https://github.com/microsoft/DirectXTK/blob/main/CMakePresets.json) project, which shows many build targets in its `configurePresets` section. +The *`CMakePresets.json`* file in [box2d-lite](https://github.com/esweet431/box2d-lite/blob/vs-launch/CMakePresets.json) contains examples of Configure Presets, Build Presets, and Test Presets. For more information about this example, see the presentation [An Introduction to CMakePresets.json](/shows/cpp-pure-virtual-cpp-2021/an-introduction-to-cmakepresetsjson). You can see another example in the [DirectXTK](https://github.com/microsoft/DirectXTK/blob/main/CMakePresets.json) project, which shows many build targets in its `configurePresets` section. ## Next steps diff --git a/docs/standard-library/random.md b/docs/standard-library/random.md index 6ba907baac2..958524b2451 100644 --- a/docs/standard-library/random.md +++ b/docs/standard-library/random.md @@ -44,7 +44,7 @@ Here are some tips to keep in mind when using ``: - The most useful pairing for most applications is the `mt19937` engine with `uniform_int_distribution`, as shown in the [code example](#code) later in this article. -There are many options to choose from in the `` header, and any of them is preferable to the outdated C Runtime function `rand()`. For information about what's wrong with `rand()` and how `` addresses these shortcomings, see [this video](/events/goingnative-2013/rand-considered-harmful). +There are many options to choose from in the `` header, and any of them is preferable to the outdated C Runtime function `rand()`. For information about what's wrong with `rand()` and how `` addresses these shortcomings, see [this video](/shows/goingnative-2013/rand-considered-harmful). ## Examples From 45ba86d052bf03455dbfa5f46e56ee989b703239 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 23:12:58 +0800 Subject: [PATCH 0552/1799] Fix `CSnapInPropertyPageImpl` syntax --- docs/atl/reference/csnapinpropertypageimpl-class.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/atl/reference/csnapinpropertypageimpl-class.md b/docs/atl/reference/csnapinpropertypageimpl-class.md index 5bbd52fce69..43c5e3a7d18 100644 --- a/docs/atl/reference/csnapinpropertypageimpl-class.md +++ b/docs/atl/reference/csnapinpropertypageimpl-class.md @@ -15,8 +15,9 @@ This class provides methods for implementing a snap-in property page object. ## Syntax -``` -CSnapInPropertyPageImpl : public CDialogImplBase +```cpp +template +class ATL_NO_VTABLE CSnapInPropertyPageImpl : public CDialogImplBase ``` ## Members From 510612a7a9e9d8dd9bfe3453d5fd4e07e4dd08c7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 23:13:45 +0800 Subject: [PATCH 0553/1799] Update metadata in `CSnapInPropertyPageImpl` class reference --- docs/atl/reference/csnapinpropertypageimpl-class.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/atl/reference/csnapinpropertypageimpl-class.md b/docs/atl/reference/csnapinpropertypageimpl-class.md index 43c5e3a7d18..e7cd51b1c78 100644 --- a/docs/atl/reference/csnapinpropertypageimpl-class.md +++ b/docs/atl/reference/csnapinpropertypageimpl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CSnapInPropertyPageImpl Class" title: "CSnapInPropertyPageImpl Class" -ms.date: "11/04/2016" +description: "Learn more about: CSnapInPropertyPageImpl Class" +ms.date: 11/04/2016 f1_keywords: ["CSnapInPropertyPageImpl", "ATLSNAP/ATL::CSnapInPropertyPageImpl", "ATLSNAP/ATL::CSnapInPropertyPageImpl::CSnapInPropertyPageImpl", "ATLSNAP/ATL::CSnapInPropertyPageImpl::CancelToClose", "ATLSNAP/ATL::CSnapInPropertyPageImpl::Create", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnApply", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnHelp", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnKillActive", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnQueryCancel", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnReset", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnSetActive", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnWizardBack", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnWizardFinish", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnWizardNext", "ATLSNAP/ATL::CSnapInPropertyPageImpl::QuerySiblings", "ATLSNAP/ATL::CSnapInPropertyPageImpl::SetModified", "ATLSNAP/ATL::CSnapInPropertyPageImpl::m_psp"] helpviewer_keywords: ["snap-ins, property pages", "snap-ins", "property pages, ATL", "CSnapInPropertyPageImpl class"] -ms.assetid: 75bdce5a-985e-4166-bd44-493132e023c4 --- # CSnapInPropertyPageImpl Class From 5d6ebc7958cf312f7c6ca01f2e7a5661601ec5bf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 23:24:36 +0800 Subject: [PATCH 0554/1799] Add blockquotes for error messages in range [C2491, C2520] --- docs/error-messages/compiler-errors-1/compiler-error-c2491.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2492.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2493.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2495.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2496.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2498.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2499.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2500.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2502.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2503.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2504.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2505.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2506.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2507.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2509.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2510.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2511.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2513.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2514.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2516.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2517.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2518.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md index d04430cdf58..4b31ea54438 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md @@ -8,7 +8,7 @@ ms.assetid: 4e5a8f81-124e-402c-a5ec-d35a89b5469e --- # Compiler Error C2491 -'identifier' : definition of dllimport function not allowed +> 'identifier' : definition of dllimport function not allowed Data, static data members, and functions can be declared as `dllimport`s but not defined as `dllimport`s. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md index 5b1d3f958a7..37cf8a5ce0d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md @@ -8,7 +8,7 @@ ms.assetid: 8c44c9bb-c366-4fe5-a0ab-882e38608aaa --- # Compiler Error C2492 -'*variable*': data with thread storage duration may not have dll interface +> '*variable*': data with thread storage duration may not have dll interface The variable is declared with the [thread](../../cpp/thread.md) attribute and with the DLL interface. The address of the `thread` variable is not known until run time, so it cannot be linked to a DLL import or export. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md index 880eb4770f3..04f804228b7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md @@ -8,7 +8,7 @@ ms.assetid: 68316cd5-682b-49c3-b6ea-23c4e5d296cf --- # Compiler Error C2493 -illegal form of __based +> illegal form of __based A **`__based`** expression must be based on a pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md index 4c574088ef9..6c7c3200707 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md @@ -8,7 +8,7 @@ ms.assetid: bb7066fe-3549-4901-97e4-157f3c04dd57 --- # Compiler Error C2495 -'identifier' : 'nothrow' can only be applied to function declarations or definitions +> 'identifier' : 'nothrow' can only be applied to function declarations or definitions The [nothrow](../../cpp/nothrow-cpp.md) extended attribute can be applied to function declarations or definitions only. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md index 8e35f8ac5c5..0b84c473248 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md @@ -8,7 +8,7 @@ ms.assetid: 9a25237d-5bbb-4112-98f3-29cd99d3f89f --- # Compiler Error C2496 -'identifier' : 'selectany' can only be applied to data items with external linkage +> 'identifier' : 'selectany' can only be applied to data items with external linkage The [selectany](../../cpp/selectany.md) attribute can be applied only to externally visible and global data items. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md index ca002045d60..bca5e4b077c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md @@ -8,7 +8,7 @@ ms.assetid: 0839f12c-aaa4-4a02-bb33-7f072715dd14 --- # Compiler Error C2498 -'function' : 'novtable' can only be applied to class declarations or definitions +> 'function' : 'novtable' can only be applied to class declarations or definitions This error can be caused by using `__declspec(novtable)` with a function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md index ce2ea37923d..6dacd2933c2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md @@ -8,7 +8,7 @@ ms.assetid: b323ff4d-b3c1-4bfd-b052-ae7292d53222 --- # Compiler Error C2499 -'class' : a class cannot be its own base class +> 'class' : a class cannot be its own base class You attempted to specify the class that you are defining as a base class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md index 172a50f9026..626393a3ceb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md @@ -8,7 +8,7 @@ ms.assetid: 6bff8161-dc9a-48ca-91f1-fd2eefdbbc93 --- # Compiler Error C2500 -'identifier1' : 'identifier2' is already a direct base class +> 'identifier1' : 'identifier2' is already a direct base class A class or structure appears more than once in a list of base classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md index 5870524c77c..ff489d7722d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md @@ -8,7 +8,7 @@ ms.assetid: affa0b86-15fc-4e17-b7f2-6aad4a3771c4 --- # Compiler Error C2502 -'identifier' : too many access modifiers on the base class +> 'identifier' : too many access modifiers on the base class The base class has more than one access modifier. Only one access modifier (**`public`**, **`private`**, or **`protected`**) is allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md index e1e75d0a6d6..baf4eaa180e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md @@ -8,7 +8,7 @@ ms.assetid: da86cc89-fd04-400b-aa8d-a5ffaf7e3918 --- # Compiler Error C2503 -'class' : base classes cannot contain zero-sized arrays +> 'class' : base classes cannot contain zero-sized arrays A base class or structure contains a zero-sized array. An array in a class must have at least one element. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md index 454446e6514..040fc3c4eab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md @@ -8,7 +8,7 @@ ms.assetid: c9e002a6-a4ee-4ba7-970e-edf4adb83692 --- # Compiler Error C2504 -'class' : base class undefined +> 'class' : base class undefined The base class is declared but never defined. Possible causes: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md index e243be38013..3d3ea8e7e04 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md @@ -8,7 +8,7 @@ ms.assetid: b19f5c53-399d-425e-90db-fe3ca9b40858 --- # Compiler Error C2505 -'symbol' : '__declspec(modifer)' can only be applied to declarations or definitions of global objects or static data members +> 'symbol' : '__declspec(modifer)' can only be applied to declarations or definitions of global objects or static data members A **`__declspec`** modifier that is designed to only be used at global scope was used in a function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md index 58498d0b67b..06c61aa7342 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md @@ -8,7 +8,7 @@ ms.assetid: cfed21cd-2404-46f2-985e-d0c2c3820830 --- # Compiler Error C2506 -'member' : '__declspec(modifier)' cannot be applied to this symbol +> 'member' : '__declspec(modifier)' cannot be applied to this symbol You cannot declare per-process or per-appdomain for static members of a managed class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md index acc9e18da98..6730874e6c2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md @@ -8,7 +8,7 @@ ms.assetid: f102aff5-de7d-4c3f-9cac-2ddf9ce02b14 --- # Compiler Error C2507 -'identifier' : too many virtual modifiers on the base class +> 'identifier' : too many virtual modifiers on the base class A class or structure is declared as **`virtual`** more than once. Only one **`virtual`** modifier can appear for each class in a list of base classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md index f352ec966de..031dd4dce2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md @@ -8,7 +8,7 @@ ms.assetid: 339c1fcd-ec4a-456c-9f18-a9b24d9921af --- # Compiler Error C2509 -'identifier' : member function not declared in 'class' +> 'identifier' : member function not declared in 'class' The function is not declared in the specified class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md index 6f3e7b8c2af..6117fba5f7b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md @@ -8,7 +8,7 @@ ms.assetid: bf6d28db-f2f4-48f8-8f4e-7d662ed278fe --- # Compiler Error C2510 -'identifier' : left of '::' must be a class/struct/union +> 'identifier' : left of '::' must be a class/struct/union A class, structure, or union name must appear on the left side of the scope-resolution operator (`::`) operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md index 366066b72ce..f7aa2d2da37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md @@ -8,7 +8,7 @@ ms.assetid: df999efe-fe2b-418b-bb55-4af6a0592631 --- # Compiler Error C2511 -'identifier' : overloaded member function not found in 'class' +> 'identifier' : overloaded member function not found in 'class' No version of the function is declared with the specified parameters. Possible causes: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md index a8b17632744..eb14d1dda4e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md @@ -8,7 +8,7 @@ ms.assetid: ab5b21d3-61e2-4df7-8eea-6f14d6ba8620 --- # Compiler Error C2513 -'type' : no variable declared before '=' +> 'type' : no variable declared before '=' The type specifier appears in declaration with no variable identifier. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md index 9d5d9b20d57..d76d8fad9eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md @@ -8,7 +8,7 @@ ms.assetid: 4b7085e5-6714-4261-80b7-bc72e64ab3e8 --- # Compiler Error C2514 -'class' : class has no constructors +> 'class' : class has no constructors The class, structure, or union has no constructor with a parameter list that matches the parameters being used to instantiate it. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md index 187439712a0..5ce4b1d3af1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md @@ -8,7 +8,7 @@ ms.assetid: cd3accc1-0179-4a13-9587-616908c4ad1d --- # Compiler Error C2516 -'name' : is not a legal base class +> 'name' : is not a legal base class The class is derived from a type name defined by a **`typedef`** statement. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2517.md b/docs/error-messages/compiler-errors-2/compiler-error-c2517.md index 4b06aacf31a..41b22cef5db 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2517.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2517.md @@ -8,6 +8,6 @@ ms.assetid: d79348d5-e271-4aad-b973-8264515f8e90 --- # Compiler Error C2517 -'identifier' : right of '::' is undefined +> 'identifier' : right of '::' is undefined The identifier on the right of the scope-resolution operator (`::`) must be a defined member of the class, structure, or union on the left. If no class, structure, or union is named, the identifier on the right must be declared with global scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md index de3a5ceab9d..314cca6e859 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md @@ -8,7 +8,7 @@ ms.assetid: a7895b47-da90-4851-ac97-18e81479595a --- # Compiler Error C2518 -keyword 'keyword' illegal in base class list; ignored +> keyword 'keyword' illegal in base class list; ignored The keywords **`class`** and **`struct`** should not appear in a base class list. From 4a98957df8fb3e52394291f510f5899a9b753c07 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 23:30:41 +0800 Subject: [PATCH 0555/1799] Add "Remarks" and "Example" headings for error references in range [C2491, C2520] --- docs/error-messages/compiler-errors-1/compiler-error-c2491.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2492.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2493.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2494.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2495.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2496.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2498.md | 2 ++ docs/error-messages/compiler-errors-1/compiler-error-c2499.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2500.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2502.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2503.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2504.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2505.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2506.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2507.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2509.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2510.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2511.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2512.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2513.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2514.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2516.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2517.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2518.md | 4 ++++ 24 files changed, 86 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md index 4b31ea54438..41c3fe77ab4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md @@ -10,10 +10,14 @@ ms.assetid: 4e5a8f81-124e-402c-a5ec-d35a89b5469e > 'identifier' : definition of dllimport function not allowed +## Remarks + Data, static data members, and functions can be declared as `dllimport`s but not defined as `dllimport`s. To fix this issue, remove the `__declspec(dllimport)` specifier from the definition of the function. +## Example + The following sample generates C2491: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md index 37cf8a5ce0d..33d8d501fa6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md @@ -10,8 +10,12 @@ ms.assetid: 8c44c9bb-c366-4fe5-a0ab-882e38608aaa > '*variable*': data with thread storage duration may not have dll interface +## Remarks + The variable is declared with the [thread](../../cpp/thread.md) attribute and with the DLL interface. The address of the `thread` variable is not known until run time, so it cannot be linked to a DLL import or export. +## Example + The following sample generates C2492: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md index 04f804228b7..ab2953043d3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md @@ -10,8 +10,12 @@ ms.assetid: 68316cd5-682b-49c3-b6ea-23c4e5d296cf > illegal form of __based +## Remarks + A **`__based`** expression must be based on a pointer. +## Example + The following sample generates C2493: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2494.md b/docs/error-messages/compiler-errors-1/compiler-error-c2494.md index b8e75b82068..7b40a0bbb0e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2494.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2494.md @@ -10,8 +10,12 @@ ms.assetid: 5dfd07ab-351d-49c9-b54e-f0a104776ab8 > '*keyword*' cannot be called from within a filter expression or __finally/finally block +## Remarks + You cannot use *keyword* in a **`__finally`** or **`finally`** block. +## Examples + The following sample generates C2494: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md index 6c7c3200707..97c6828f23a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md @@ -10,8 +10,12 @@ ms.assetid: bb7066fe-3549-4901-97e4-157f3c04dd57 > 'identifier' : 'nothrow' can only be applied to function declarations or definitions +## Remarks + The [nothrow](../../cpp/nothrow-cpp.md) extended attribute can be applied to function declarations or definitions only. +## Example + The following sample generates C2495: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md index 0b84c473248..e561ef58eed 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md @@ -10,8 +10,12 @@ ms.assetid: 9a25237d-5bbb-4112-98f3-29cd99d3f89f > 'identifier' : 'selectany' can only be applied to data items with external linkage +## Remarks + The [selectany](../../cpp/selectany.md) attribute can be applied only to externally visible and global data items. +## Example + The following sample generates C2496: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md index bca5e4b077c..0768b30b908 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md @@ -10,6 +10,8 @@ ms.assetid: 0839f12c-aaa4-4a02-bb33-7f072715dd14 > 'function' : 'novtable' can only be applied to class declarations or definitions +## Remarks + This error can be caused by using `__declspec(novtable)` with a function. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md index 6dacd2933c2..86cda09b56d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md @@ -10,8 +10,12 @@ ms.assetid: b323ff4d-b3c1-4bfd-b052-ae7292d53222 > 'class' : a class cannot be its own base class +## Remarks + You attempted to specify the class that you are defining as a base class. +## Example + The following sample generates C2499: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md index 626393a3ceb..aae6e1f58c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md @@ -10,12 +10,16 @@ ms.assetid: 6bff8161-dc9a-48ca-91f1-fd2eefdbbc93 > 'identifier1' : 'identifier2' is already a direct base class +## Remarks + A class or structure appears more than once in a list of base classes. A direct base is one mentioned in the base list. An indirect base is a base class of one of the classes in the base list. A class cannot be specified as a direct base class more than once. A class can be used as an indirect base class more than once. +## Example + The following sample generates C2500: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md index ff489d7722d..8c3d1f975d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md @@ -10,8 +10,12 @@ ms.assetid: affa0b86-15fc-4e17-b7f2-6aad4a3771c4 > 'identifier' : too many access modifiers on the base class +## Remarks + The base class has more than one access modifier. Only one access modifier (**`public`**, **`private`**, or **`protected`**) is allowed. +## Example + The following sample generates C2502: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md index baf4eaa180e..b2c02b0cbb8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md @@ -10,8 +10,12 @@ ms.assetid: da86cc89-fd04-400b-aa8d-a5ffaf7e3918 > 'class' : base classes cannot contain zero-sized arrays +## Remarks + A base class or structure contains a zero-sized array. An array in a class must have at least one element. +## Example + The following sample generates C2503: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md index 040fc3c4eab..12034b85867 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md @@ -10,12 +10,16 @@ ms.assetid: c9e002a6-a4ee-4ba7-970e-edf4adb83692 > 'class' : base class undefined +## Remarks + The base class is declared but never defined. Possible causes: 1. Missing include file. 1. External base class not declared with [extern](../../cpp/extern-cpp.md). +## Example + The following sample generates C2504: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md index 3d3ea8e7e04..76b91226610 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md @@ -10,10 +10,14 @@ ms.assetid: b19f5c53-399d-425e-90db-fe3ca9b40858 > 'symbol' : '__declspec(modifer)' can only be applied to declarations or definitions of global objects or static data members +## Remarks + A **`__declspec`** modifier that is designed to only be used at global scope was used in a function. For more information, see [appdomain](../../cpp/appdomain.md) and [process](../../cpp/process.md). +## Example + The following sample generates C2505: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md index 06c61aa7342..de3db9c4b37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md @@ -10,6 +10,8 @@ ms.assetid: cfed21cd-2404-46f2-985e-d0c2c3820830 > 'member' : '__declspec(modifier)' cannot be applied to this symbol +## Remarks + You cannot declare per-process or per-appdomain for static members of a managed class. See [appdomain](../../cpp/appdomain.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md index 6730874e6c2..d8c28e1bc6e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md @@ -10,8 +10,12 @@ ms.assetid: f102aff5-de7d-4c3f-9cac-2ddf9ce02b14 > 'identifier' : too many virtual modifiers on the base class +## Remarks + A class or structure is declared as **`virtual`** more than once. Only one **`virtual`** modifier can appear for each class in a list of base classes. +## Example + The following sample generates C2507: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md index 031dd4dce2d..0b78605cc60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md @@ -10,6 +10,8 @@ ms.assetid: 339c1fcd-ec4a-456c-9f18-a9b24d9921af > 'identifier' : member function not declared in 'class' +## Remarks + The function is not declared in the specified class. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md index 6117fba5f7b..aa8fe3cd475 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md @@ -10,8 +10,12 @@ ms.assetid: bf6d28db-f2f4-48f8-8f4e-7d662ed278fe > 'identifier' : left of '::' must be a class/struct/union +## Remarks + A class, structure, or union name must appear on the left side of the scope-resolution operator (`::`) operator. +## Example + The following sample generates C2510: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md index f7aa2d2da37..2646c7c3b6d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md @@ -10,6 +10,8 @@ ms.assetid: df999efe-fe2b-418b-bb55-4af6a0592631 > 'identifier' : overloaded member function not found in 'class' +## Remarks + No version of the function is declared with the specified parameters. Possible causes: 1. Wrong parameters passed to function. @@ -18,6 +20,8 @@ No version of the function is declared with the specified parameters. Possible 1. Incorrect spelling of parameter names. +## Example + The following sample generates C2511: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2512.md b/docs/error-messages/compiler-errors-2/compiler-error-c2512.md index 10f91ac3852..61ecc0937b2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2512.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2512.md @@ -10,6 +10,8 @@ ms.assetid: 15206da9-1164-451a-b869-280e00711aad > '*identifier*' : no appropriate default constructor available +## Remarks + A *default constructor*, a constructor that requires no arguments, is not available for the specified class, structure, or union. The compiler supplies a default constructor only if no user-defined constructors are provided. If you provide a constructor that takes a non-void parameter, and you want to allow your class to be created with no parameters (for example, as the elements of an array), you must also provide a default constructor. The default constructor can be a constructor with default values for all parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md index eb14d1dda4e..3e68d1374ab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md @@ -10,8 +10,12 @@ ms.assetid: ab5b21d3-61e2-4df7-8eea-6f14d6ba8620 > 'type' : no variable declared before '=' +## Remarks + The type specifier appears in declaration with no variable identifier. +## Examples + The following sample generates C2513: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md index d76d8fad9eb..758eeeee161 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md @@ -10,10 +10,14 @@ ms.assetid: 4b7085e5-6714-4261-80b7-bc72e64ab3e8 > 'class' : class has no constructors +## Remarks + The class, structure, or union has no constructor with a parameter list that matches the parameters being used to instantiate it. A class must be fully declared before it can be instantiated. +## Example + The following sample generates C2514: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md index 5ce4b1d3af1..79fef8513fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md @@ -10,8 +10,12 @@ ms.assetid: cd3accc1-0179-4a13-9587-616908c4ad1d > 'name' : is not a legal base class +## Remarks + The class is derived from a type name defined by a **`typedef`** statement. +## Example + The following sample generates C2516: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2517.md b/docs/error-messages/compiler-errors-2/compiler-error-c2517.md index 41b22cef5db..cf044dc31f5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2517.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2517.md @@ -10,4 +10,6 @@ ms.assetid: d79348d5-e271-4aad-b973-8264515f8e90 > 'identifier' : right of '::' is undefined +## Remarks + The identifier on the right of the scope-resolution operator (`::`) must be a defined member of the class, structure, or union on the left. If no class, structure, or union is named, the identifier on the right must be declared with global scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md index 314cca6e859..78b932ee6a5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md @@ -10,8 +10,12 @@ ms.assetid: a7895b47-da90-4851-ac97-18e81479595a > keyword 'keyword' illegal in base class list; ignored +## Remarks + The keywords **`class`** and **`struct`** should not appear in a base class list. +## Example + The following sample generates C2518: ```cpp From ee0b21e39274f9d9cdad4a69e78ee05f3c5652b9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 23:32:15 +0800 Subject: [PATCH 0556/1799] Replace term "sample" with "example" for error references in range [C2491, C2520] --- docs/error-messages/compiler-errors-1/compiler-error-c2491.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2492.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2493.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2494.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2495.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2496.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2498.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2499.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2500.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2502.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2503.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2504.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2505.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2506.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2507.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2509.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2510.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2511.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2513.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2514.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2516.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2518.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md index 41c3fe77ab4..971c94890d7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md @@ -18,7 +18,7 @@ To fix this issue, remove the `__declspec(dllimport)` specifier from the definit ## Example -The following sample generates C2491: +The following example generates C2491: ```cpp // C2491.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md index 33d8d501fa6..e60a7e2a5d2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md @@ -16,7 +16,7 @@ The variable is declared with the [thread](../../cpp/thread.md) attribute and wi ## Example -The following sample generates C2492: +The following example generates C2492: ```cpp // C2492.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md index ab2953043d3..e47607db293 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md @@ -16,7 +16,7 @@ A **`__based`** expression must be based on a pointer. ## Example -The following sample generates C2493: +The following example generates C2493: ```cpp // C2493.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2494.md b/docs/error-messages/compiler-errors-1/compiler-error-c2494.md index 7b40a0bbb0e..b375dd36230 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2494.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2494.md @@ -16,7 +16,7 @@ You cannot use *keyword* in a **`__finally`** or **`finally`** block. ## Examples -The following sample generates C2494: +The following example generates C2494: ```cpp // C2494.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md index 97c6828f23a..e3f818b3aec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md @@ -16,7 +16,7 @@ The [nothrow](../../cpp/nothrow-cpp.md) extended attribute can be applied to fun ## Example -The following sample generates C2495: +The following example generates C2495: ```cpp // C2495.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md index e561ef58eed..d1c88cbae7c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md @@ -16,7 +16,7 @@ The [selectany](../../cpp/selectany.md) attribute can be applied only to externa ## Example -The following sample generates C2496: +The following example generates C2496: ```cpp // C2496.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md index 0768b30b908..337908d6405 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md @@ -16,7 +16,7 @@ This error can be caused by using `__declspec(novtable)` with a function. ## Example -The following sample generates C2498: +The following example generates C2498: ```cpp // C2498.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md index 86cda09b56d..1f8b5c72d30 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md @@ -16,7 +16,7 @@ You attempted to specify the class that you are defining as a base class. ## Example -The following sample generates C2499: +The following example generates C2499: ```cpp // C2499.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md index aae6e1f58c4..3a075af2d90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md @@ -20,7 +20,7 @@ A class cannot be specified as a direct base class more than once. A class can b ## Example -The following sample generates C2500: +The following example generates C2500: ```cpp // C2500.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md index 8c3d1f975d5..efee518fe13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md @@ -16,7 +16,7 @@ The base class has more than one access modifier. Only one access modifier (**`p ## Example -The following sample generates C2502: +The following example generates C2502: ```cpp // C2502.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md index b2c02b0cbb8..874c99c0ade 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md @@ -16,7 +16,7 @@ A base class or structure contains a zero-sized array. An array in a class must ## Example -The following sample generates C2503: +The following example generates C2503: ```cpp // C2503.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md index 12034b85867..d6e73d3fce3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md @@ -20,7 +20,7 @@ The base class is declared but never defined. Possible causes: ## Example -The following sample generates C2504: +The following example generates C2504: ```cpp // C2504.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md index 76b91226610..82e04a11a4e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md @@ -18,7 +18,7 @@ For more information, see [appdomain](../../cpp/appdomain.md) and [process](../. ## Example -The following sample generates C2505: +The following example generates C2505: ```cpp // C2505.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md index de3db9c4b37..fc8558a0e1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md @@ -18,7 +18,7 @@ See [appdomain](../../cpp/appdomain.md) for more information. ## Example -The following sample generates C2506. +The following example generates C2506. ```cpp // C2506.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md index d8c28e1bc6e..e45dd5d4321 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md @@ -16,7 +16,7 @@ A class or structure is declared as **`virtual`** more than once. Only one **`vi ## Example -The following sample generates C2507: +The following example generates C2507: ```cpp // C2507.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md index 0b78605cc60..d3ee226bd8d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md @@ -16,7 +16,7 @@ The function is not declared in the specified class. ## Example -The following sample generates C2509. +The following example generates C2509. ```cpp // C2509.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md index aa8fe3cd475..edcfa0a9825 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md @@ -16,7 +16,7 @@ A class, structure, or union name must appear on the left side of the scope-reso ## Example -The following sample generates C2510: +The following example generates C2510: ```cpp // C2510.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md index 2646c7c3b6d..c1c96768479 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md @@ -22,7 +22,7 @@ No version of the function is declared with the specified parameters. Possible ## Example -The following sample generates C2511: +The following example generates C2511: ```cpp // C2511.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md index 3e68d1374ab..e4e24e477bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md @@ -16,7 +16,7 @@ The type specifier appears in declaration with no variable identifier. ## Examples -The following sample generates C2513: +The following example generates C2513: ```cpp // C2513.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md index 758eeeee161..5b4051db300 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md @@ -18,7 +18,7 @@ A class must be fully declared before it can be instantiated. ## Example -The following sample generates C2514: +The following example generates C2514: ```cpp // C2514.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md index 79fef8513fb..fec688d69bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md @@ -16,7 +16,7 @@ The class is derived from a type name defined by a **`typedef`** statement. ## Example -The following sample generates C2516: +The following example generates C2516: ```cpp // C2516.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md index 78b932ee6a5..b9d9574135b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md @@ -16,7 +16,7 @@ The keywords **`class`** and **`struct`** should not appear in a base class list ## Example -The following sample generates C2518: +The following example generates C2518: ```cpp // C2518.cpp From bf37f2c7626165f29713fb5ac5621ecc82178987 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 29 Jul 2025 23:36:11 +0800 Subject: [PATCH 0557/1799] Update metadata for error references in range [C2491, C2520] --- .../error-messages/compiler-errors-1/compiler-error-c2491.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2492.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2493.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2494.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2495.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2496.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2498.md | 5 ++--- .../error-messages/compiler-errors-1/compiler-error-c2499.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2500.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2502.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2503.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2504.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2505.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2506.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2507.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2509.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2510.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2511.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2512.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2513.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2514.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2516.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2517.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2518.md | 5 ++--- 24 files changed, 48 insertions(+), 72 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md index 971c94890d7..cdbaa93e35a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2491" title: "Compiler Error C2491" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2491" +ms.date: 11/04/2016 f1_keywords: ["C2491"] helpviewer_keywords: ["C2491"] -ms.assetid: 4e5a8f81-124e-402c-a5ec-d35a89b5469e --- # Compiler Error C2491 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md index e60a7e2a5d2..15b7b82c18a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2492" title: "Compiler Error C2492" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2492" +ms.date: 11/04/2016 f1_keywords: ["C2492"] helpviewer_keywords: ["C2492"] -ms.assetid: 8c44c9bb-c366-4fe5-a0ab-882e38608aaa --- # Compiler Error C2492 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md index e47607db293..9a594c154ba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2493" title: "Compiler Error C2493" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2493" +ms.date: 11/04/2016 f1_keywords: ["C2493"] helpviewer_keywords: ["C2493"] -ms.assetid: 68316cd5-682b-49c3-b6ea-23c4e5d296cf --- # Compiler Error C2493 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2494.md b/docs/error-messages/compiler-errors-1/compiler-error-c2494.md index b375dd36230..2d3a8755b78 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2494.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2494.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2494" title: "Compiler Error C2494" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2494" +ms.date: 11/04/2016 f1_keywords: ["C2494"] helpviewer_keywords: ["C2494"] -ms.assetid: 5dfd07ab-351d-49c9-b54e-f0a104776ab8 --- # Compiler Error C2494 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md index e3f818b3aec..77119a710aa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2495" title: "Compiler Error C2495" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2495" +ms.date: 11/04/2016 f1_keywords: ["C2495"] helpviewer_keywords: ["C2495"] -ms.assetid: bb7066fe-3549-4901-97e4-157f3c04dd57 --- # Compiler Error C2495 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md index d1c88cbae7c..4c8ff4c65ab 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2496" title: "Compiler Error C2496" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2496" +ms.date: 11/04/2016 f1_keywords: ["C2496"] helpviewer_keywords: ["C2496"] -ms.assetid: 9a25237d-5bbb-4112-98f3-29cd99d3f89f --- # Compiler Error C2496 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md index 337908d6405..fb603e31ed2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2498" title: "Compiler Error C2498" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2498" +ms.date: 11/04/2016 f1_keywords: ["C2498"] helpviewer_keywords: ["C2498"] -ms.assetid: 0839f12c-aaa4-4a02-bb33-7f072715dd14 --- # Compiler Error C2498 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md index 1f8b5c72d30..38e8f58cd81 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2499" title: "Compiler Error C2499" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2499" +ms.date: 11/04/2016 f1_keywords: ["C2499"] helpviewer_keywords: ["C2499"] -ms.assetid: b323ff4d-b3c1-4bfd-b052-ae7292d53222 --- # Compiler Error C2499 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md index 3a075af2d90..ca18bb6baa8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2500" title: "Compiler Error C2500" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2500" +ms.date: 11/04/2016 f1_keywords: ["C2500"] helpviewer_keywords: ["C2500"] -ms.assetid: 6bff8161-dc9a-48ca-91f1-fd2eefdbbc93 --- # Compiler Error C2500 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md index efee518fe13..682a1056c70 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2502" title: "Compiler Error C2502" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2502" +ms.date: 11/04/2016 f1_keywords: ["C2502"] helpviewer_keywords: ["C2502"] -ms.assetid: affa0b86-15fc-4e17-b7f2-6aad4a3771c4 --- # Compiler Error C2502 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md index 874c99c0ade..2f5f2a710c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2503" title: "Compiler Error C2503" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2503" +ms.date: 11/04/2016 f1_keywords: ["C2503"] helpviewer_keywords: ["C2503"] -ms.assetid: da86cc89-fd04-400b-aa8d-a5ffaf7e3918 --- # Compiler Error C2503 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md index d6e73d3fce3..82e484fe671 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2504" title: "Compiler Error C2504" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2504" +ms.date: 11/04/2016 f1_keywords: ["C2504"] helpviewer_keywords: ["C2504"] -ms.assetid: c9e002a6-a4ee-4ba7-970e-edf4adb83692 --- # Compiler Error C2504 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md index 82e04a11a4e..2418358823a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2505" title: "Compiler Error C2505" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2505" +ms.date: 11/04/2016 f1_keywords: ["C2505"] helpviewer_keywords: ["C2505"] -ms.assetid: b19f5c53-399d-425e-90db-fe3ca9b40858 --- # Compiler Error C2505 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md index fc8558a0e1b..6b29b6aa6a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2506" title: "Compiler Error C2506" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2506" +ms.date: 11/04/2016 f1_keywords: ["C2506"] helpviewer_keywords: ["C2506"] -ms.assetid: cfed21cd-2404-46f2-985e-d0c2c3820830 --- # Compiler Error C2506 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md index e45dd5d4321..4a586ada072 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2507" title: "Compiler Error C2507" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2507" +ms.date: 11/04/2016 f1_keywords: ["C2507"] helpviewer_keywords: ["C2507"] -ms.assetid: f102aff5-de7d-4c3f-9cac-2ddf9ce02b14 --- # Compiler Error C2507 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md index d3ee226bd8d..570e65755fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2509" title: "Compiler Error C2509" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2509" +ms.date: 11/04/2016 f1_keywords: ["C2509"] helpviewer_keywords: ["C2509"] -ms.assetid: 339c1fcd-ec4a-456c-9f18-a9b24d9921af --- # Compiler Error C2509 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md index edcfa0a9825..9a1d072e990 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2510" title: "Compiler Error C2510" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2510" +ms.date: 11/04/2016 f1_keywords: ["C2510"] helpviewer_keywords: ["C2510"] -ms.assetid: bf6d28db-f2f4-48f8-8f4e-7d662ed278fe --- # Compiler Error C2510 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md index c1c96768479..9b0661a8f52 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2511" title: "Compiler Error C2511" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2511" +ms.date: 11/04/2016 f1_keywords: ["C2511"] helpviewer_keywords: ["C2511"] -ms.assetid: df999efe-fe2b-418b-bb55-4af6a0592631 --- # Compiler Error C2511 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2512.md b/docs/error-messages/compiler-errors-2/compiler-error-c2512.md index 61ecc0937b2..2d3eda00460 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2512.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2512.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2512" title: "Compiler Error C2512" -ms.date: "02/09/2018" +description: "Learn more about: Compiler Error C2512" +ms.date: 02/09/2018 f1_keywords: ["C2512"] helpviewer_keywords: ["C2512"] -ms.assetid: 15206da9-1164-451a-b869-280e00711aad --- # Compiler Error C2512 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md index e4e24e477bc..f473c159cb8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2513" title: "Compiler Error C2513" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2513" +ms.date: 11/04/2016 f1_keywords: ["C2513"] helpviewer_keywords: ["C2513"] -ms.assetid: ab5b21d3-61e2-4df7-8eea-6f14d6ba8620 --- # Compiler Error C2513 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md index 5b4051db300..c42b99c7b3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2514" title: "Compiler Error C2514" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2514" +ms.date: 11/04/2016 f1_keywords: ["C2514"] helpviewer_keywords: ["C2514"] -ms.assetid: 4b7085e5-6714-4261-80b7-bc72e64ab3e8 --- # Compiler Error C2514 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md index fec688d69bc..80332510416 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2516" title: "Compiler Error C2516" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2516" +ms.date: 11/04/2016 f1_keywords: ["C2516"] helpviewer_keywords: ["C2516"] -ms.assetid: cd3accc1-0179-4a13-9587-616908c4ad1d --- # Compiler Error C2516 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2517.md b/docs/error-messages/compiler-errors-2/compiler-error-c2517.md index cf044dc31f5..ef8d366347d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2517.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2517.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2517" title: "Compiler Error C2517" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2517" +ms.date: 11/04/2016 f1_keywords: ["C2517"] helpviewer_keywords: ["C2517"] -ms.assetid: d79348d5-e271-4aad-b973-8264515f8e90 --- # Compiler Error C2517 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md index b9d9574135b..f87fee60c91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2518" title: "Compiler Error C2518" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2518" +ms.date: 11/04/2016 f1_keywords: ["C2518"] helpviewer_keywords: ["C2518"] -ms.assetid: a7895b47-da90-4851-ac97-18e81479595a --- # Compiler Error C2518 From 2de1428b311cad63d3a033fdf521fc5b2c2b1382 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 29 Jul 2025 13:59:11 -0700 Subject: [PATCH 0558/1799] Highlight the `/Oi` requirement for `memcpy-param-overlap` --- docs/sanitizers/error-memcpy-param-overlap.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/error-memcpy-param-overlap.md b/docs/sanitizers/error-memcpy-param-overlap.md index 49ded7146c4..a01d23c4842 100644 --- a/docs/sanitizers/error-memcpy-param-overlap.md +++ b/docs/sanitizers/error-memcpy-param-overlap.md @@ -9,6 +9,9 @@ helpviewer_keywords: ["memcpy-param-overlap error", "AddressSanitizer error memc > Address Sanitizer Error: memcpy-param-overlap +> [!NOTE] +> The `/Oi` flag is required to detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and `memmove` as intrinsic functions, which is necessary because some versions of the standard library implement `memcpy` and `memmove` as such. Since ASAN is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Please note that when`/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions is not guaranteed to be used. See the [`/Oi` docs](../build/reference/oi-generate-intrinsic-functions.md) for more information. + The CRT function [`memcpy`](../c-runtime-library/reference/memcpy-wmemcpy.md) **doesn't support** overlapping memory. The CRT provides an alternative to `memcpy` that does support overlapping memory: [`memmove`](../c-runtime-library/reference/memmove-wmemmove.md). A common error is to treat `memmove` as being semantically equivalent to `memcpy`. @@ -39,8 +42,6 @@ cl example1.cpp /fsanitize=address /Zi /Oi devenv /debugexe example1.exe ``` -The [/Oi flag](../build/reference/oi-generate-intrinsic-functions.md) tells the compiler to treat `memcpy` and `memmove` as intrinsic functions. This is necessary because some versions of the standard library implement `memcpy` and `memmove` in the same way. Because ASAN is a dynamic analysis tool, it only detects errors with an observable runtime effect. - ### Resulting error :::image type="content" source="media/memcpy-param-overlap-example-1.png" alt-text="Screenshot of debugger displaying memcpy-param-overlap error in example 1."::: From ffd7ba8d9c4508f286af664c6a226a9586c17b47 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 29 Jul 2025 14:03:13 -0700 Subject: [PATCH 0559/1799] Use sections to delineate x86-specific remarks --- .../reference/oi-generate-intrinsic-functions.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/build/reference/oi-generate-intrinsic-functions.md b/docs/build/reference/oi-generate-intrinsic-functions.md index 22b21114a48..80ee69c7bd9 100644 --- a/docs/build/reference/oi-generate-intrinsic-functions.md +++ b/docs/build/reference/oi-generate-intrinsic-functions.md @@ -24,23 +24,21 @@ For more information about which functions have intrinsic forms, see [intrinsic] **/Oi** is only a request to the compiler to replace some function calls with intrinsics. The compiler may call the function (and not replace the function call with an intrinsic) if it results in better performance.\ **/Oi-** turns off this behavior, which may be useful if `/Oi` has been specified elsewhere and you want to override it. -**x86 Specific** +You also use [intrinsic](../../preprocessor/intrinsic.md) to create intrinsic functions, or [function (C/C++)](../../preprocessor/function-c-cpp.md) to explicitly force a function call. + +### x86-specific remarks The intrinsic floating-point functions don't perform any special checks on input values and so work in restricted ranges of input, and have different exception handling and boundary conditions than the library routines with the same name. Using the true intrinsic forms implies loss of IEEE exception handling, and loss of `_matherr` and `errno` functionality; the latter implies loss of ANSI conformance. However, the intrinsic forms can considerably speed up floating-point-intensive programs, and for many programs, the conformance issues are of little practical value. You can use the [`Za`](za-ze-disable-language-extensions.md) compiler option to override generation of true intrinsic floating-point options. In this case, the functions are generated as library routines that pass arguments directly to the floating-point chip instead of pushing them onto the program stack. -**END x86 Specific** - -You also use [intrinsic](../../preprocessor/intrinsic.md) to create intrinsic functions, or [function (C/C++)](../../preprocessor/function-c-cpp.md) to explicitly force a function call. - -### To set this compiler option in the Visual Studio development environment +## To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). 1. Select the **Configuration Properties** > **C/C++** > **Optimization** property page. 1. Modify the **Enable Intrinsic Functions** property. -### To set this compiler option programmatically +## To set this compiler option programmatically - See . From 4c112dbd280e5d56fcc2764be4f2432475df8a0a Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 29 Jul 2025 15:13:28 -0700 Subject: [PATCH 0560/1799] soften wording: make clear that `/Oi` is needed to _reliably_ detect errors, not to detect them entirely --- docs/sanitizers/error-memcpy-param-overlap.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/error-memcpy-param-overlap.md b/docs/sanitizers/error-memcpy-param-overlap.md index a01d23c4842..3da467b258e 100644 --- a/docs/sanitizers/error-memcpy-param-overlap.md +++ b/docs/sanitizers/error-memcpy-param-overlap.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["memcpy-param-overlap error", "AddressSanitizer error memc > Address Sanitizer Error: memcpy-param-overlap > [!NOTE] -> The `/Oi` flag is required to detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and `memmove` as intrinsic functions, which is necessary because some versions of the standard library implement `memcpy` and `memmove` as such. Since ASAN is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Please note that when`/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions is not guaranteed to be used. See the [`/Oi` docs](../build/reference/oi-generate-intrinsic-functions.md) for more information. +> The `/Oi` flag is required to reliably detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and `memmove` as intrinsic functions, which is necessary because some versions of the standard library implement `memcpy` and `memmove` as such. Since ASAN is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Please note that when`/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions is not guaranteed to be used. See the [`/Oi` docs](../build/reference/oi-generate-intrinsic-functions.md) for more information. The CRT function [`memcpy`](../c-runtime-library/reference/memcpy-wmemcpy.md) **doesn't support** overlapping memory. The CRT provides an alternative to `memcpy` that does support overlapping memory: [`memmove`](../c-runtime-library/reference/memmove-wmemmove.md). From c31d707a1bf318e7df528b6e5cce0522d0619458 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 29 Jul 2025 16:09:31 -0700 Subject: [PATCH 0561/1799] Tidy up `/Oi` docs: say "you can use" instead of "you can also use" after re-arranging text. --- docs/build/reference/oi-generate-intrinsic-functions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/oi-generate-intrinsic-functions.md b/docs/build/reference/oi-generate-intrinsic-functions.md index 80ee69c7bd9..6903538cac1 100644 --- a/docs/build/reference/oi-generate-intrinsic-functions.md +++ b/docs/build/reference/oi-generate-intrinsic-functions.md @@ -24,7 +24,7 @@ For more information about which functions have intrinsic forms, see [intrinsic] **/Oi** is only a request to the compiler to replace some function calls with intrinsics. The compiler may call the function (and not replace the function call with an intrinsic) if it results in better performance.\ **/Oi-** turns off this behavior, which may be useful if `/Oi` has been specified elsewhere and you want to override it. -You also use [intrinsic](../../preprocessor/intrinsic.md) to create intrinsic functions, or [function (C/C++)](../../preprocessor/function-c-cpp.md) to explicitly force a function call. +You can use [intrinsic](../../preprocessor/intrinsic.md) to create intrinsic functions, or [function (C/C++)](../../preprocessor/function-c-cpp.md) to explicitly force a function call. ### x86-specific remarks From 2d75c9a6959618b3af508bade830614ac4c60bf9 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 29 Jul 2025 16:21:09 -0700 Subject: [PATCH 0562/1799] incorporate feedback --- docs/sanitizers/error-memcpy-param-overlap.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/error-memcpy-param-overlap.md b/docs/sanitizers/error-memcpy-param-overlap.md index 3da467b258e..3686347b4f3 100644 --- a/docs/sanitizers/error-memcpy-param-overlap.md +++ b/docs/sanitizers/error-memcpy-param-overlap.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["memcpy-param-overlap error", "AddressSanitizer error memc > Address Sanitizer Error: memcpy-param-overlap > [!NOTE] -> The `/Oi` flag is required to reliably detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and `memmove` as intrinsic functions, which is necessary because some versions of the standard library implement `memcpy` and `memmove` as such. Since ASAN is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Please note that when`/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions is not guaranteed to be used. See the [`/Oi` docs](../build/reference/oi-generate-intrinsic-functions.md) for more information. +> The `/Oi` flag is required to reliably detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and other functions as intrinsics, which is necessary because some versions of the standard library implement them as such. Since ASan is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Please note that when `/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions is not guaranteed to be used. See the [`/Oi` docs](../build/reference/oi-generate-intrinsic-functions.md) for more information. The CRT function [`memcpy`](../c-runtime-library/reference/memcpy-wmemcpy.md) **doesn't support** overlapping memory. The CRT provides an alternative to `memcpy` that does support overlapping memory: [`memmove`](../c-runtime-library/reference/memmove-wmemmove.md). From e8cfc6a54070c11d48770b084169b0d3c3c59cb1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 17:53:50 +0800 Subject: [PATCH 0563/1799] Clean up 2 stray backticks --- docs/mfc/reference/cdc-class.md | 2 +- docs/sanitizers/asan-known-issues.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/mfc/reference/cdc-class.md b/docs/mfc/reference/cdc-class.md index 1c72d7d3974..910c96cad27 100644 --- a/docs/mfc/reference/cdc-class.md +++ b/docs/mfc/reference/cdc-class.md @@ -4588,7 +4588,7 @@ BOOL Polyline( *`lpPoints`*\ Points to an array of `POINT` structures or `CPoint` objects to be connected. -*`nCount`*`\ +*`nCount`*\ Specifies the number of points in the array. This value must be at least 2. ### Return Value diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index f797f3006e1..41d1292a402 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -23,7 +23,7 @@ The following options and functionality are incompatible with [`/fsanitize=addre - [C++ AMP](../parallel/amp/cpp-amp-overview.md) is unsupported, and should be disabled. - [Universal Windows Platform](../cppcx/universal-windows-apps-cpp.md) (UWP) applications are unsupported. - [Special case list](https://clang.llvm.org/docs/SanitizerSpecialCaseList.html) files are unsupported. -- [Precompiled headers built without `/fsanitize`address`](../build/creating-precompiled-header-files.md#consistency-rules-for-yc-and-yu) are unsupported. +- [Precompiled headers built without `/fsanitize=address`](../build/creating-precompiled-header-files.md#consistency-rules-for-yc-and-yu) are unsupported. ## Standard library support From cee9d1f561dfcad779dbe58f97d9862b2636a322 Mon Sep 17 00:00:00 2001 From: Dickson Mwendia <64727760+Dickson-Mwendia@users.noreply.github.com> Date: Wed, 30 Jul 2025 13:16:14 +0300 Subject: [PATCH 0564/1799] Add SFI ms.custom values --- docs/build/cmake-presets-vs.md | 1 + docs/build/cmake-projects-in-visual-studio.md | 1 + docs/build/get-started-linux-cmake.md | 1 + docs/build/vscpp-step-0-installation.md | 5 ++++- docs/build/vscpp-step-1-create.md | 4 +++- ...kthrough-creating-and-using-a-dynamic-link-library-cpp.md | 1 + .../build-an-opengl-es-application-on-android-and-ios.md | 1 + .../install-and-configure-tools-to-build-using-ios.md | 4 +++- docs/data/odbc/data-source-managing-connections-odbc.md | 1 + docs/data/oledb/crowsetimpl-class.md | 1 + docs/data/oledb/icommandpropertiesimpl-class.md | 1 + docs/data/oledb/irowsetcreatorimpl-class.md | 1 + docs/data/oledb/irowsetinfoimpl-class.md | 1 + docs/data/oledb/isessionpropertiesimpl-class.md | 1 + docs/data/oledb/ole-db-provider-templates-reference.md | 1 + docs/linux/configure-a-linux-project.md | 1 + docs/linux/connect-to-your-remote-linux-computer.md | 1 + docs/linux/deploy-run-and-debug-your-linux-project.md | 4 +++- .../set-up-fips-compliant-secure-remote-linux-development.md | 1 + docs/mfc/reference/cdaodatabase-class.md | 1 + docs/mfc/reference/cdaotabledef-class.md | 1 + docs/mfc/reference/cdaoworkspace-class.md | 1 + docs/mfc/reference/cdatabase-class.md | 1 + ...tn054-calling-dao-directly-while-using-mfc-dao-classes.md | 1 + docs/sanitizers/error-double-free.md | 1 + docs/windows/attributes/db-param.md | 1 + docs/windows/attributes/db-source.md | 1 + docs/windows/mfc-predefined-symbols.md | 1 + .../walkthrough-creating-windows-desktop-applications-cpp.md | 4 +++- 29 files changed, 40 insertions(+), 5 deletions(-) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index d2d2f03f8a6..87d3fd71461 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -3,6 +3,7 @@ title: Configure and build with CMake Presets description: "Reference for using CMake Presets to configure and build CMake projects." ms.date: 06/09/2023 ms.topic: reference +ms.custom: sfi-image-nochange --- # Configure and build with CMake Presets in Visual Studio diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index 69b1bc18eeb..b56efcce7e5 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -4,6 +4,7 @@ description: "Learn how to create and build C++ projects using CMake in Visual S ms.date: 03/18/2025 ms.topic: concept-article f1_keywords: ["VS.ToolsOptionsPages.CMake.General", "VS.ToolsOptionsPages.CMake.LanguageServices"] +ms.custom: sfi-image-nochange --- # CMake projects in Visual Studio diff --git a/docs/build/get-started-linux-cmake.md b/docs/build/get-started-linux-cmake.md index 1ffb0fb6d25..b2f59a73810 100644 --- a/docs/build/get-started-linux-cmake.md +++ b/docs/build/get-started-linux-cmake.md @@ -3,6 +3,7 @@ title: Create C++ cross-platform projects in Visual Studio description: "How to set up, compile, and debug a C++ open-source CMake project in Visual Studio that targets both Linux and Windows." ms.topic: tutorial ms.date: 02/07/2022 +ms.custom: sfi-image-nochange --- # Tutorial: Create C++ cross-platform projects in Visual Studio diff --git a/docs/build/vscpp-step-0-installation.md b/docs/build/vscpp-step-0-installation.md index f6e9b8cea02..5ce61195dc8 100644 --- a/docs/build/vscpp-step-0-installation.md +++ b/docs/build/vscpp-step-0-installation.md @@ -1,10 +1,13 @@ --- title: Install C and C++ support in Visual Studio description: "Learn how to install Visual Studio with support for Microsoft C and C++ and related workloads." -ms.custom: vs-acquisition, intro-installation ms.date: 03/18/2025 ms.topic: tutorial ms.devlang: "cpp" +ms.custom: + - vs-acquisition + - intro-installation + - sfi-image-nochange --- # Install C and C++ support in Visual Studio diff --git a/docs/build/vscpp-step-1-create.md b/docs/build/vscpp-step-1-create.md index e4830eee922..1337c29d018 100644 --- a/docs/build/vscpp-step-1-create.md +++ b/docs/build/vscpp-step-1-create.md @@ -1,9 +1,11 @@ --- title: Create a C++ console app project description: "Create a Hello World console app using Microsoft C++ in Visual Studio." -ms.custom: "mvc" ms.date: 07/05/2023 ms.topic: "tutorial" +ms.custom: + - "mvc" + - sfi-image-nochange --- # Create a C++ console app project diff --git a/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md b/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md index ad06919a0cb..e777914ccdb 100644 --- a/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md +++ b/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md @@ -4,6 +4,7 @@ description: "Learn how to use C++ to create a Windows dynamic-link library (DLL ms.topic: tutorial ms.date: 03/17/2025 helpviewer_keywords: ["libraries [C++], DLLs", "DLLs [C++], walkthroughs"] +ms.custom: sfi-image-nochange --- # Walkthrough: Create and use your own dynamic-link library (C++) diff --git a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md index 57ef6e63903..319b56d17d1 100644 --- a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md +++ b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md @@ -3,6 +3,7 @@ description: "Learn more about: Build an OpenGL ES application on Android and iO title: "Build an OpenGL ES application on Android and iOS" ms.date: "06/09/2023" ms.topic: how-to +ms.custom: sfi-image-nochange --- # Build an OpenGL ES application on Android and iOS diff --git a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md index 65b0c66fcd0..4e7f878b3a2 100644 --- a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md +++ b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md @@ -3,8 +3,10 @@ description: "Learn more about: Install and configure tools to build using iOS" title: "Install and configure tools to build using iOS" ms.date: 12/18/2022 ms.assetid: d0c311c9-9eb9-42c5-ba07-25604362cd28 -ms.custom: intro-installation ms.topic: install-set-up-deploy +ms.custom: + - intro-installation + - sfi-image-nochange --- # Install and configure tools to build using iOS diff --git a/docs/data/odbc/data-source-managing-connections-odbc.md b/docs/data/odbc/data-source-managing-connections-odbc.md index 3c08f7c6a11..8667ed49931 100644 --- a/docs/data/odbc/data-source-managing-connections-odbc.md +++ b/docs/data/odbc/data-source-managing-connections-odbc.md @@ -4,6 +4,7 @@ title: "Data Source: Managing Connections (ODBC)" ms.date: "11/04/2016" helpviewer_keywords: ["ODBC data sources [C++], multiuser environments", "generalizing connection strings", "ODBC [C++], disconnecting from data sources", "connection strings [C++], generalizing", "database connections [C++], creating", "GetDefaultConnect method", "connections [C++], data source", "ODBC connections [C++], configuring", "disconnecting from data sources", "databases [C++], connecting to", "ODBC connections [C++], disconnecting", "data sources [C++], connecting to", "ODBC connections [C++], connecting to data source", "ODBC data sources [C++], connections", "database connections [C++], MFC ODBC classes"] ms.assetid: c0adbcdd-c000-40c6-b199-09ffdc7b6ef2 +ms.custom: sfi-ropc-nochange --- # Data Source: Managing Connections (ODBC) diff --git a/docs/data/oledb/crowsetimpl-class.md b/docs/data/oledb/crowsetimpl-class.md index e83271fca53..ee3884e6daa 100644 --- a/docs/data/oledb/crowsetimpl-class.md +++ b/docs/data/oledb/crowsetimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["CRowsetImpl", "ATL.CRowsetImpl", "ATL::CRowsetImpl", "CRowsetImpl.NameFromDBID", "CRowsetImpl::NameFromDBID", "CRowsetImpl.SetCommandText", "CRowsetImpl::SetCommandText", "CRowsetImpl.GetColumnInfo", "CRowsetImpl::GetColumnInfo", "CRowsetImpl::GetCommandFromID", "GetCommandFromID", "CRowsetImpl.GetCommandFromID", "CRowsetImpl.ValidateCommandID", "CRowsetImpl::ValidateCommandID", "CRowsetImpl.m_rgRowData", "CRowsetImpl::m_rgRowData", "CRowsetImpl::m_strCommandText", "CRowsetImpl.m_strCommandText", "CRowsetImpl::m_strIndexText", "CRowsetImpl.m_strIndexText"] helpviewer_keywords: ["CRowsetImpl class", "NameFromDBID method", "SetCommandText method", "GetColumnInfo method", "GetCommandFromID method", "ValidateCommandID method", "m_rgRowData", "m_strCommandText", "m_strIndexText"] ms.assetid: e97614b3-b11d-4806-a0d3-b9401331473f +ms.custom: sfi-ropc-nochange --- # CRowsetImpl Class diff --git a/docs/data/oledb/icommandpropertiesimpl-class.md b/docs/data/oledb/icommandpropertiesimpl-class.md index 3d50ed3c85f..2b1694ea7c9 100644 --- a/docs/data/oledb/icommandpropertiesimpl-class.md +++ b/docs/data/oledb/icommandpropertiesimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["ICommandPropertiesImpl", "ATL.ICommandPropertiesImpl", "ATL::ICommandPropertiesImpl", "ICommandPropertiesImpl::GetProperties", "ICommandPropertiesImpl.GetProperties", "ICommandPropertiesImpl.SetProperties", "ICommandPropertiesImpl::SetProperties"] helpviewer_keywords: ["ICommandPropertiesImpl class", "GetProperties method", "SetProperties method"] ms.assetid: b3cf6aea-527e-4f0d-96e0-669178b021a2 +ms.custom: sfi-ropc-nochange --- # ICommandPropertiesImpl Class diff --git a/docs/data/oledb/irowsetcreatorimpl-class.md b/docs/data/oledb/irowsetcreatorimpl-class.md index 542a3dffabe..8fb9c33eabd 100644 --- a/docs/data/oledb/irowsetcreatorimpl-class.md +++ b/docs/data/oledb/irowsetcreatorimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["ATL::IRowsetCreatorImpl", "ATL.IRowsetCreatorImpl", "ATL::IRowsetCreatorImpl", "ATL.IRowsetCreatorImpl", "IRowsetCreatorImpl", "IRowsetCreatorImpl.SetSite", "IRowsetCreatorImpl::SetSite", "IRowsetCreatorImpl::SetSite", "SetSite", "ATL.IRowsetCreatorImpl.SetSite", "ATL::IRowsetCreatorImpl::SetSite", "ATL::IRowsetCreatorImpl::SetSite", "ATL.IRowsetCreatorImpl.SetSite"] helpviewer_keywords: ["IRowsetCreatorImpl class", "SetSite method"] ms.assetid: 92cc950f-7978-4754-8d9a-defa63867d82 +ms.custom: sfi-ropc-nochange --- # IRowsetCreatorImpl Class diff --git a/docs/data/oledb/irowsetinfoimpl-class.md b/docs/data/oledb/irowsetinfoimpl-class.md index d05de7876df..d5f545e3bb7 100644 --- a/docs/data/oledb/irowsetinfoimpl-class.md +++ b/docs/data/oledb/irowsetinfoimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["ATL.IRowsetInfoImpl", "IRowsetInfoImpl", "ATL::IRowsetInfoImpl", "ATL.IRowsetInfoImpl.GetProperties", "IRowsetInfoImpl.GetProperties", "ATL::IRowsetInfoImpl::GetProperties", "IRowsetInfoImpl::GetProperties", "ATL::IRowsetInfoImpl::GetReferencedRowset", "GetReferencedRowset", "ATL.IRowsetInfoImpl.GetReferencedRowset", "IRowsetInfoImpl.GetReferencedRowset", "IRowsetInfoImpl::GetReferencedRowset", "IRowsetInfoImpl::GetSpecification", "ATL.IRowsetInfoImpl.GetSpecification", "IRowsetInfoImpl.GetSpecification", "GetSpecification", "ATL::IRowsetInfoImpl::GetSpecification"] helpviewer_keywords: ["IRowsetInfoImpl class", "GetProperties method", "GetReferencedRowset method", "GetSpecification method"] ms.assetid: 9c654155-7727-464e-bd31-143e68391a47 +ms.custom: sfi-ropc-nochange --- # IRowsetInfoImpl Class diff --git a/docs/data/oledb/isessionpropertiesimpl-class.md b/docs/data/oledb/isessionpropertiesimpl-class.md index 89043502938..5818498c6e9 100644 --- a/docs/data/oledb/isessionpropertiesimpl-class.md +++ b/docs/data/oledb/isessionpropertiesimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["ISessionPropertiesImpl", "ISessionPropertiesImpl::GetProperties", "ISessionPropertiesImpl.GetProperties", "ISessionPropertiesImpl.SetProperties", "ISessionPropertiesImpl::SetProperties"] helpviewer_keywords: ["ISessionPropertiesImpl class", "GetProperties method", "SetProperties method"] ms.assetid: ca0ba254-c7dc-4c52-abec-cf895a0c6a63 +ms.custom: sfi-ropc-nochange --- # ISessionPropertiesImpl Class diff --git a/docs/data/oledb/ole-db-provider-templates-reference.md b/docs/data/oledb/ole-db-provider-templates-reference.md index 8e4f8167f9f..ba16a0f8a26 100644 --- a/docs/data/oledb/ole-db-provider-templates-reference.md +++ b/docs/data/oledb/ole-db-provider-templates-reference.md @@ -4,6 +4,7 @@ title: "OLE DB Provider Templates Reference" ms.date: "11/04/2016" helpviewer_keywords: ["OLE DB provider templates"] ms.assetid: 518358f0-bab1-4de9-bce9-4062cc87c11f +ms.custom: sfi-ropc-nochange --- # OLE DB Provider Templates Reference diff --git a/docs/linux/configure-a-linux-project.md b/docs/linux/configure-a-linux-project.md index 88ef152274b..ac65f32b525 100644 --- a/docs/linux/configure-a-linux-project.md +++ b/docs/linux/configure-a-linux-project.md @@ -3,6 +3,7 @@ title: "Configure a Linux MSBuild C++ project in Visual Studio" ms.date: "10/16/2020" description: "Configure a MSBuild-based Linux project in Visual Studio so you can build it." ms.assetid: 4d7c6adf-54b9-4b23-bd23-5de0c825b768 +ms.custom: sfi-image-nochange --- # Configure a Linux MSBuild C++ project in Visual Studio diff --git a/docs/linux/connect-to-your-remote-linux-computer.md b/docs/linux/connect-to-your-remote-linux-computer.md index 5803f75c496..0ffc8a5aba9 100644 --- a/docs/linux/connect-to-your-remote-linux-computer.md +++ b/docs/linux/connect-to-your-remote-linux-computer.md @@ -3,6 +3,7 @@ title: "Connect to a Target Linux System by Using Visual Studio" description: "Learn how to connect to a remote Linux machine or Windows Subsystem for Linux from inside a Visual Studio C++ project." ms.topic: tutorial ms.date: 03/21/2025 +ms.custom: sfi-image-nochange --- # Connect to your remote Linux system by using Visual Studio diff --git a/docs/linux/deploy-run-and-debug-your-linux-project.md b/docs/linux/deploy-run-and-debug-your-linux-project.md index e52bfcd132d..999f3e19c0d 100644 --- a/docs/linux/deploy-run-and-debug-your-linux-project.md +++ b/docs/linux/deploy-run-and-debug-your-linux-project.md @@ -2,7 +2,9 @@ title: "Deploy, run, and debug your Linux MSBuild C++ project in Visual Studio" description: "Describes how to compile, execute, and debug code on the remote target from inside a MSBuild-based Linux C++ project in Visual Studio." ms.date: 12/5/2024 -ms.custom: intro-deployment +ms.custom: + - intro-deployment + - sfi-image-nochange --- # Deploy, run, and debug your Linux MSBuild project diff --git a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md index b3581863766..0faf68ed871 100644 --- a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md +++ b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md @@ -3,6 +3,7 @@ title: "Set up FIPS-compliant secure remote Linux development" description: "How to set up a FIPS-compliant cryptographic connection between Visual Studio and a Linux machine for remote development." ms.date: 07/06/2022 ms.topic: how-to +ms.custom: sfi-image-nochange --- # Set up FIPS-compliant secure remote Linux development diff --git a/docs/mfc/reference/cdaodatabase-class.md b/docs/mfc/reference/cdaodatabase-class.md index a59cea4963d..f1b5b85af32 100644 --- a/docs/mfc/reference/cdaodatabase-class.md +++ b/docs/mfc/reference/cdaodatabase-class.md @@ -4,6 +4,7 @@ title: "CDaoDatabase Class" ms.date: "09/17/2019" f1_keywords: ["CDaoDatabase", "AFXDAO/CDaoDatabase", "AFXDAO/CDaoDatabase::CDaoDatabase", "AFXDAO/CDaoDatabase::CanTransact", "AFXDAO/CDaoDatabase::CanUpdate", "AFXDAO/CDaoDatabase::Close", "AFXDAO/CDaoDatabase::Create", "AFXDAO/CDaoDatabase::CreateRelation", "AFXDAO/CDaoDatabase::DeleteQueryDef", "AFXDAO/CDaoDatabase::DeleteRelation", "AFXDAO/CDaoDatabase::DeleteTableDef", "AFXDAO/CDaoDatabase::Execute", "AFXDAO/CDaoDatabase::GetConnect", "AFXDAO/CDaoDatabase::GetName", "AFXDAO/CDaoDatabase::GetQueryDefCount", "AFXDAO/CDaoDatabase::GetQueryDefInfo", "AFXDAO/CDaoDatabase::GetQueryTimeout", "AFXDAO/CDaoDatabase::GetRecordsAffected", "AFXDAO/CDaoDatabase::GetRelationCount", "AFXDAO/CDaoDatabase::GetRelationInfo", "AFXDAO/CDaoDatabase::GetTableDefCount", "AFXDAO/CDaoDatabase::GetTableDefInfo", "AFXDAO/CDaoDatabase::GetVersion", "AFXDAO/CDaoDatabase::IsOpen", "AFXDAO/CDaoDatabase::Open", "AFXDAO/CDaoDatabase::SetQueryTimeout", "AFXDAO/CDaoDatabase::m_pDAODatabase", "AFXDAO/CDaoDatabase::m_pWorkspace"] helpviewer_keywords: ["CDaoDatabase [MFC], CDaoDatabase", "CDaoDatabase [MFC], CanTransact", "CDaoDatabase [MFC], CanUpdate", "CDaoDatabase [MFC], Close", "CDaoDatabase [MFC], Create", "CDaoDatabase [MFC], CreateRelation", "CDaoDatabase [MFC], DeleteQueryDef", "CDaoDatabase [MFC], DeleteRelation", "CDaoDatabase [MFC], DeleteTableDef", "CDaoDatabase [MFC], Execute", "CDaoDatabase [MFC], GetConnect", "CDaoDatabase [MFC], GetName", "CDaoDatabase [MFC], GetQueryDefCount", "CDaoDatabase [MFC], GetQueryDefInfo", "CDaoDatabase [MFC], GetQueryTimeout", "CDaoDatabase [MFC], GetRecordsAffected", "CDaoDatabase [MFC], GetRelationCount", "CDaoDatabase [MFC], GetRelationInfo", "CDaoDatabase [MFC], GetTableDefCount", "CDaoDatabase [MFC], GetTableDefInfo", "CDaoDatabase [MFC], GetVersion", "CDaoDatabase [MFC], IsOpen", "CDaoDatabase [MFC], Open", "CDaoDatabase [MFC], SetQueryTimeout", "CDaoDatabase [MFC], m_pDAODatabase", "CDaoDatabase [MFC], m_pWorkspace"] +ms.custom: sfi-ropc-nochange --- # CDaoDatabase Class diff --git a/docs/mfc/reference/cdaotabledef-class.md b/docs/mfc/reference/cdaotabledef-class.md index 5ad89da173c..8e9f63fcc55 100644 --- a/docs/mfc/reference/cdaotabledef-class.md +++ b/docs/mfc/reference/cdaotabledef-class.md @@ -4,6 +4,7 @@ title: "CDaoTableDef Class" ms.date: "11/04/2016" f1_keywords: ["CDaoTableDef", "AFXDAO/CDaoTableDef", "AFXDAO/CDaoTableDef::CDaoTableDef", "AFXDAO/CDaoTableDef::Append", "AFXDAO/CDaoTableDef::CanUpdate", "AFXDAO/CDaoTableDef::Close", "AFXDAO/CDaoTableDef::Create", "AFXDAO/CDaoTableDef::CreateField", "AFXDAO/CDaoTableDef::CreateIndex", "AFXDAO/CDaoTableDef::DeleteField", "AFXDAO/CDaoTableDef::DeleteIndex", "AFXDAO/CDaoTableDef::GetAttributes", "AFXDAO/CDaoTableDef::GetConnect", "AFXDAO/CDaoTableDef::GetDateCreated", "AFXDAO/CDaoTableDef::GetDateLastUpdated", "AFXDAO/CDaoTableDef::GetFieldCount", "AFXDAO/CDaoTableDef::GetFieldInfo", "AFXDAO/CDaoTableDef::GetIndexCount", "AFXDAO/CDaoTableDef::GetIndexInfo", "AFXDAO/CDaoTableDef::GetName", "AFXDAO/CDaoTableDef::GetRecordCount", "AFXDAO/CDaoTableDef::GetSourceTableName", "AFXDAO/CDaoTableDef::GetValidationRule", "AFXDAO/CDaoTableDef::GetValidationText", "AFXDAO/CDaoTableDef::IsOpen", "AFXDAO/CDaoTableDef::Open", "AFXDAO/CDaoTableDef::RefreshLink", "AFXDAO/CDaoTableDef::SetAttributes", "AFXDAO/CDaoTableDef::SetConnect", "AFXDAO/CDaoTableDef::SetName", "AFXDAO/CDaoTableDef::SetSourceTableName", "AFXDAO/CDaoTableDef::SetValidationRule", "AFXDAO/CDaoTableDef::SetValidationText", "AFXDAO/CDaoTableDef::m_pDAOTableDef", "AFXDAO/CDaoTableDef::m_pDatabase"] helpviewer_keywords: ["CDaoTableDef [MFC], CDaoTableDef", "CDaoTableDef [MFC], Append", "CDaoTableDef [MFC], CanUpdate", "CDaoTableDef [MFC], Close", "CDaoTableDef [MFC], Create", "CDaoTableDef [MFC], CreateField", "CDaoTableDef [MFC], CreateIndex", "CDaoTableDef [MFC], DeleteField", "CDaoTableDef [MFC], DeleteIndex", "CDaoTableDef [MFC], GetAttributes", "CDaoTableDef [MFC], GetConnect", "CDaoTableDef [MFC], GetDateCreated", "CDaoTableDef [MFC], GetDateLastUpdated", "CDaoTableDef [MFC], GetFieldCount", "CDaoTableDef [MFC], GetFieldInfo", "CDaoTableDef [MFC], GetIndexCount", "CDaoTableDef [MFC], GetIndexInfo", "CDaoTableDef [MFC], GetName", "CDaoTableDef [MFC], GetRecordCount", "CDaoTableDef [MFC], GetSourceTableName", "CDaoTableDef [MFC], GetValidationRule", "CDaoTableDef [MFC], GetValidationText", "CDaoTableDef [MFC], IsOpen", "CDaoTableDef [MFC], Open", "CDaoTableDef [MFC], RefreshLink", "CDaoTableDef [MFC], SetAttributes", "CDaoTableDef [MFC], SetConnect", "CDaoTableDef [MFC], SetName", "CDaoTableDef [MFC], SetSourceTableName", "CDaoTableDef [MFC], SetValidationRule", "CDaoTableDef [MFC], SetValidationText", "CDaoTableDef [MFC], m_pDAOTableDef", "CDaoTableDef [MFC], m_pDatabase"] +ms.custom: sfi-ropc-nochange --- # CDaoTableDef Class diff --git a/docs/mfc/reference/cdaoworkspace-class.md b/docs/mfc/reference/cdaoworkspace-class.md index 777678f429c..0f1ddba2a65 100644 --- a/docs/mfc/reference/cdaoworkspace-class.md +++ b/docs/mfc/reference/cdaoworkspace-class.md @@ -4,6 +4,7 @@ title: "CDaoWorkspace Class" ms.date: "11/04/2016" f1_keywords: ["CDaoWorkspace", "AFXDAO/CDaoWorkspace", "AFXDAO/CDaoWorkspace::CDaoWorkspace", "AFXDAO/CDaoWorkspace::Append", "AFXDAO/CDaoWorkspace::BeginTrans", "AFXDAO/CDaoWorkspace::Close", "AFXDAO/CDaoWorkspace::CommitTrans", "AFXDAO/CDaoWorkspace::CompactDatabase", "AFXDAO/CDaoWorkspace::Create", "AFXDAO/CDaoWorkspace::GetDatabaseCount", "AFXDAO/CDaoWorkspace::GetDatabaseInfo", "AFXDAO/CDaoWorkspace::GetIniPath", "AFXDAO/CDaoWorkspace::GetIsolateODBCTrans", "AFXDAO/CDaoWorkspace::GetLoginTimeout", "AFXDAO/CDaoWorkspace::GetName", "AFXDAO/CDaoWorkspace::GetUserName", "AFXDAO/CDaoWorkspace::GetVersion", "AFXDAO/CDaoWorkspace::GetWorkspaceCount", "AFXDAO/CDaoWorkspace::GetWorkspaceInfo", "AFXDAO/CDaoWorkspace::Idle", "AFXDAO/CDaoWorkspace::IsOpen", "AFXDAO/CDaoWorkspace::Open", "AFXDAO/CDaoWorkspace::RepairDatabase", "AFXDAO/CDaoWorkspace::Rollback", "AFXDAO/CDaoWorkspace::SetDefaultPassword", "AFXDAO/CDaoWorkspace::SetDefaultUser", "AFXDAO/CDaoWorkspace::SetIniPath", "AFXDAO/CDaoWorkspace::SetIsolateODBCTrans", "AFXDAO/CDaoWorkspace::SetLoginTimeout", "AFXDAO/CDaoWorkspace::m_pDAOWorkspace"] helpviewer_keywords: ["CDaoWorkspace [MFC], CDaoWorkspace", "CDaoWorkspace [MFC], Append", "CDaoWorkspace [MFC], BeginTrans", "CDaoWorkspace [MFC], Close", "CDaoWorkspace [MFC], CommitTrans", "CDaoWorkspace [MFC], CompactDatabase", "CDaoWorkspace [MFC], Create", "CDaoWorkspace [MFC], GetDatabaseCount", "CDaoWorkspace [MFC], GetDatabaseInfo", "CDaoWorkspace [MFC], GetIniPath", "CDaoWorkspace [MFC], GetIsolateODBCTrans", "CDaoWorkspace [MFC], GetLoginTimeout", "CDaoWorkspace [MFC], GetName", "CDaoWorkspace [MFC], GetUserName", "CDaoWorkspace [MFC], GetVersion", "CDaoWorkspace [MFC], GetWorkspaceCount", "CDaoWorkspace [MFC], GetWorkspaceInfo", "CDaoWorkspace [MFC], Idle", "CDaoWorkspace [MFC], IsOpen", "CDaoWorkspace [MFC], Open", "CDaoWorkspace [MFC], RepairDatabase", "CDaoWorkspace [MFC], Rollback", "CDaoWorkspace [MFC], SetDefaultPassword", "CDaoWorkspace [MFC], SetDefaultUser", "CDaoWorkspace [MFC], SetIniPath", "CDaoWorkspace [MFC], SetIsolateODBCTrans", "CDaoWorkspace [MFC], SetLoginTimeout", "CDaoWorkspace [MFC], m_pDAOWorkspace"] +ms.custom: sfi-ropc-nochange --- # CDaoWorkspace Class diff --git a/docs/mfc/reference/cdatabase-class.md b/docs/mfc/reference/cdatabase-class.md index 77fb3fd71c9..7258c18594b 100644 --- a/docs/mfc/reference/cdatabase-class.md +++ b/docs/mfc/reference/cdatabase-class.md @@ -4,6 +4,7 @@ title: "CDatabase Class" ms.date: "11/04/2016" f1_keywords: ["CDatabase", "AFXDB/CDatabase", "AFXDB/CDatabase::CDatabase", "AFXDB/CDatabase::BeginTrans", "AFXDB/CDatabase::BindParameters", "AFXDB/CDatabase::Cancel", "AFXDB/CDatabase::CanTransact", "AFXDB/CDatabase::CanUpdate", "AFXDB/CDatabase::Close", "AFXDB/CDatabase::CommitTrans", "AFXDB/CDatabase::ExecuteSQL", "AFXDB/CDatabase::GetBookmarkPersistence", "AFXDB/CDatabase::GetConnect", "AFXDB/CDatabase::GetCursorCommitBehavior", "AFXDB/CDatabase::GetCursorRollbackBehavior", "AFXDB/CDatabase::GetDatabaseName", "AFXDB/CDatabase::IsOpen", "AFXDB/CDatabase::OnSetOptions", "AFXDB/CDatabase::Open", "AFXDB/CDatabase::OpenEx", "AFXDB/CDatabase::Rollback", "AFXDB/CDatabase::SetLoginTimeout", "AFXDB/CDatabase::SetQueryTimeout", "AFXDB/CDatabase::m_hdbc"] helpviewer_keywords: ["CDatabase [MFC], CDatabase", "CDatabase [MFC], BeginTrans", "CDatabase [MFC], BindParameters", "CDatabase [MFC], Cancel", "CDatabase [MFC], CanTransact", "CDatabase [MFC], CanUpdate", "CDatabase [MFC], Close", "CDatabase [MFC], CommitTrans", "CDatabase [MFC], ExecuteSQL", "CDatabase [MFC], GetBookmarkPersistence", "CDatabase [MFC], GetConnect", "CDatabase [MFC], GetCursorCommitBehavior", "CDatabase [MFC], GetCursorRollbackBehavior", "CDatabase [MFC], GetDatabaseName", "CDatabase [MFC], IsOpen", "CDatabase [MFC], OnSetOptions", "CDatabase [MFC], Open", "CDatabase [MFC], OpenEx", "CDatabase [MFC], Rollback", "CDatabase [MFC], SetLoginTimeout", "CDatabase [MFC], SetQueryTimeout", "CDatabase [MFC], m_hdbc"] +ms.custom: sfi-ropc-nochange --- # `CDatabase` Class diff --git a/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md b/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md index 02a2e7b5061..c17812d54ab 100644 --- a/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md +++ b/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md @@ -4,6 +4,7 @@ title: "TN054: Calling DAO Directly While Using MFC DAO Classes" ms.date: "09/17/2019" helpviewer_keywords: ["MFC, DAO and", "passwords [MFC], calling DAO", "security [MFC], DAO", "DAO (Data Access Objects), calling directly", "DAO (Data Access Objects), security", "security [MFC]", "TN054", "DAO (Data Access Objects), and MFC"] ms.assetid: f7de7d85-8d6c-4426-aa05-2e617c0da957 +ms.custom: sfi-ropc-nochange --- # TN054: Calling DAO Directly While Using MFC DAO Classes diff --git a/docs/sanitizers/error-double-free.md b/docs/sanitizers/error-double-free.md index 099c9706eca..84b4dd42741 100644 --- a/docs/sanitizers/error-double-free.md +++ b/docs/sanitizers/error-double-free.md @@ -4,6 +4,7 @@ description: "Learn about the double-free Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["double-free"] helpviewer_keywords: ["double-free error", "AddressSanitizer error double-free"] +ms.custom: sfi-image-nochange --- # Error: `double-free` diff --git a/docs/windows/attributes/db-param.md b/docs/windows/attributes/db-param.md index 51538ad0a29..cebb586d5d6 100644 --- a/docs/windows/attributes/db-param.md +++ b/docs/windows/attributes/db-param.md @@ -5,6 +5,7 @@ ms.date: "10/02/2018" f1_keywords: ["vc-attr.db_param"] helpviewer_keywords: ["db_param attribute"] ms.assetid: a28315f5-4722-459e-92ef-32e83c0b205a +ms.custom: sfi-ropc-nochange --- # db_param diff --git a/docs/windows/attributes/db-source.md b/docs/windows/attributes/db-source.md index 4b5d1ff5a7b..d54e30f8a4f 100644 --- a/docs/windows/attributes/db-source.md +++ b/docs/windows/attributes/db-source.md @@ -5,6 +5,7 @@ ms.date: "10/02/2018" f1_keywords: ["vc-attr.db_source"] helpviewer_keywords: ["db_source attribute"] ms.assetid: 0ec8bbf7-ade2-4899-bf4c-8608b92779bc +ms.custom: sfi-ropc-nochange --- # db_source diff --git a/docs/windows/mfc-predefined-symbols.md b/docs/windows/mfc-predefined-symbols.md index e245d89aa44..17de2a0e82f 100644 --- a/docs/windows/mfc-predefined-symbols.md +++ b/docs/windows/mfc-predefined-symbols.md @@ -4,6 +4,7 @@ title: "MFC Predefined Symbols" ms.date: "02/14/2019" helpviewer_keywords: ["MFC symbols", "symbols [C++], MFC", "MFC database programming symbols", "symbols [C++], MFC", "databases [C++], MFC programming model", "Windows programming MFC symbols [C++]"] ms.assetid: c1e689c4-45d7-40a3-8ee9-f47676cc3bbb +ms.custom: sfi-ropc-nochange --- # MFC Predefined Symbols diff --git a/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md b/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md index a3b89d0b50b..e156b5e7b47 100644 --- a/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md +++ b/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md @@ -1,10 +1,12 @@ --- title: "Create a Traditional Windows Desktop Application (C++)" description: "Learn how to create a minimal, traditional Windows desktop application using Visual Studio, C++, and the Win32 API." -ms.custom: "get-started-article" ms.topic: tutorial ms.date: 03/17/2025 helpviewer_keywords: ["Windows applications [C++], Win32", "Windows Desktop applications [C++]", "Windows API [C++]"] +ms.custom: + - "get-started-article" + - sfi-image-nochange --- # Walkthrough: Create a traditional Windows desktop application (C++) From 041cc0fa271055a42891d23288f0ce3a40492d8b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 18:25:38 +0800 Subject: [PATCH 0565/1799] Add leading sentence in `` functions reference --- docs/standard-library/thread-functions.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/standard-library/thread-functions.md b/docs/standard-library/thread-functions.md index eea1f7215e9..290e9064dbc 100644 --- a/docs/standard-library/thread-functions.md +++ b/docs/standard-library/thread-functions.md @@ -8,6 +8,8 @@ helpviewer_keywords: ["std::get_id [C++]", "std::sleep_for [C++]", "std::sleep_u --- # `` functions +The `` header provides the following functions: + ## get_id Uniquely identifies the current thread of execution. From 56f1e26612b58ba39855a93c291f74ef5c4da9cd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 18:28:18 +0800 Subject: [PATCH 0566/1799] Add backticks in `` functions reference --- docs/standard-library/thread-functions.md | 26 +++++++++++------------ 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/standard-library/thread-functions.md b/docs/standard-library/thread-functions.md index 290e9064dbc..4d7f97442ae 100644 --- a/docs/standard-library/thread-functions.md +++ b/docs/standard-library/thread-functions.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["std::get_id [C++]", "std::sleep_for [C++]", "std::sleep_u The `` header provides the following functions: -## get_id +## `get_id` Uniquely identifies the current thread of execution. @@ -20,9 +20,9 @@ thread::id this_thread::get_id() noexcept; ### Return Value -An object of type [thread::id](../standard-library/thread-class.md) that uniquely identifies the current thread of execution. +An object of type [`thread::id`](../standard-library/thread-class.md) that uniquely identifies the current thread of execution. -## sleep_for +## `sleep_for` Blocks the calling thread. @@ -34,14 +34,14 @@ inline void sleep_for(const chrono::duration& Rel_time); ### Parameters -*Rel_time*\ -A [duration](../standard-library/duration-class.md) object that specifies a time interval. +*`Rel_time`*\ +A [`duration`](../standard-library/duration-class.md) object that specifies a time interval. ### Remarks -The function blocks the calling thread for at least the time that's specified by *Rel_time*. This function does not throw any exceptions. +The function blocks the calling thread for at least the time that's specified by *`Rel_time`*. This function does not throw any exceptions. -## sleep_until +## `sleep_until` Blocks the calling thread at least until the specified time. @@ -54,14 +54,14 @@ void sleep_until(const xtime *Abs_time); ### Parameters -*Abs_time*\ +*`Abs_time`*\ Represents a point in time. ### Remarks This function does not throw any exceptions. -## swap +## `swap` Swaps the states of two `thread` objects. @@ -71,17 +71,17 @@ void swap(thread& Left, thread& Right) noexcept; ### Parameters -*Left*\ +*`Left`*\ The left `thread` object. -*Right*\ +*`Right`*\ The right `thread` object. ### Remarks The function calls `Left.swap(Right)`. -## yield +## `yield` Signals the operating system to run other threads, even if the current thread would ordinarily continue to run. @@ -91,4 +91,4 @@ inline void yield() noexcept; ## See also -[\](../standard-library/thread.md) +[``](../standard-library/thread.md) From ffbcdd6d905c9e057c1b1c5b7c47d639627a18cd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 18:29:58 +0800 Subject: [PATCH 0567/1799] Simplify and improve links in `` functions reference --- docs/standard-library/thread-functions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/thread-functions.md b/docs/standard-library/thread-functions.md index 4d7f97442ae..7a69dbea319 100644 --- a/docs/standard-library/thread-functions.md +++ b/docs/standard-library/thread-functions.md @@ -20,7 +20,7 @@ thread::id this_thread::get_id() noexcept; ### Return Value -An object of type [`thread::id`](../standard-library/thread-class.md) that uniquely identifies the current thread of execution. +An object of type [`thread::id`](thread-class.md#id_class) that uniquely identifies the current thread of execution. ## `sleep_for` @@ -35,7 +35,7 @@ inline void sleep_for(const chrono::duration& Rel_time); ### Parameters *`Rel_time`*\ -A [`duration`](../standard-library/duration-class.md) object that specifies a time interval. +A [`duration`](duration-class.md) object that specifies a time interval. ### Remarks @@ -91,4 +91,4 @@ inline void yield() noexcept; ## See also -[``](../standard-library/thread.md) +[``](thread.md) From a7e44972b0f473d50acf6986e31403bee101c32f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 18:37:00 +0800 Subject: [PATCH 0568/1799] Add basic example for `std::this_thread::get_id` in `` functions reference --- docs/standard-library/thread-functions.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/standard-library/thread-functions.md b/docs/standard-library/thread-functions.md index 7a69dbea319..ae8de116851 100644 --- a/docs/standard-library/thread-functions.md +++ b/docs/standard-library/thread-functions.md @@ -22,6 +22,23 @@ thread::id this_thread::get_id() noexcept; An object of type [`thread::id`](thread-class.md#id_class) that uniquely identifies the current thread of execution. +### Example + +```cpp +#include +#include + +int main() +{ + std::thread::id current_thread_id = std::this_thread::get_id(); + std::cout << "Current thread id: " << current_thread_id; +} +``` + +```Output +Current thread id: 16196 +``` + ## `sleep_for` Blocks the calling thread. From 0b4c1b4927a1b946daf17dcc78abbcaf26715438 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 18:46:51 +0800 Subject: [PATCH 0569/1799] Update syntax in `` functions reference --- docs/standard-library/thread-functions.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/docs/standard-library/thread-functions.md b/docs/standard-library/thread-functions.md index ae8de116851..6f5cae74d5d 100644 --- a/docs/standard-library/thread-functions.md +++ b/docs/standard-library/thread-functions.md @@ -44,9 +44,8 @@ Current thread id: 16196 Blocks the calling thread. ```cpp -template -inline void sleep_for(const chrono::duration& Rel_time); +template +void this_thread::sleep_for(const chrono::duration& Rel_time); ``` ### Parameters @@ -64,9 +63,7 @@ Blocks the calling thread at least until the specified time. ```cpp template -void sleep_until(const chrono::time_point& Abs_time); - -void sleep_until(const xtime *Abs_time); +void this_thread::sleep_until(const chrono::time_point& Abs_time); ``` ### Parameters @@ -103,7 +100,7 @@ The function calls `Left.swap(Right)`. Signals the operating system to run other threads, even if the current thread would ordinarily continue to run. ```cpp -inline void yield() noexcept; +inline void this_thread::yield() noexcept; ``` ## See also From d813e3922814006c9a0cb34c5bbc01a280ea67f5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 18:50:42 +0800 Subject: [PATCH 0570/1799] Update metadata in `` functions reference --- docs/standard-library/thread-functions.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/thread-functions.md b/docs/standard-library/thread-functions.md index 6f5cae74d5d..2cba283ccc7 100644 --- a/docs/standard-library/thread-functions.md +++ b/docs/standard-library/thread-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["thread/std::get_id", "thread/std::sleep_for", "thread/std::sleep_until", "thread/std::swap", "thread/std::yield"] -ms.assetid: bb1aa1ef-fe3f-4e2c-8b6e-e22dbf2f5a19 helpviewer_keywords: ["std::get_id [C++]", "std::sleep_for [C++]", "std::sleep_until [C++]", "std::swap [C++]", "std::yield [C++]"] --- # `` functions From fea358f514b94142dd4c2e62f935b8d7d89de1c0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 23:15:02 +0800 Subject: [PATCH 0571/1799] Add mention of `/LDd` in `_DEBUG` macro reference --- docs/c-runtime-library/debug.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/debug.md b/docs/c-runtime-library/debug.md index 049cce0df2b..bbfddedf121 100644 --- a/docs/c-runtime-library/debug.md +++ b/docs/c-runtime-library/debug.md @@ -7,7 +7,7 @@ ms.assetid: a9901568-4846-4731-a404-399d947e2e7a --- # `_DEBUG` -The compiler defines `_DEBUG` when you specify the /MTd or /MDd option. These options specify debug versions of the C run-time library. +The compiler defines `_DEBUG` when you specify the /MTd, /MDd, or /LDd option. These options specify debug versions of the C run-time library. For more information, see [CRT debugging techniques](./crt-debugging-techniques.md). From 68fef1a903d88e08457389044101158da281000a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 23:16:05 +0800 Subject: [PATCH 0572/1799] Add backticks in `_DEBUG` macro reference --- docs/c-runtime-library/debug.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/debug.md b/docs/c-runtime-library/debug.md index bbfddedf121..cad5919065c 100644 --- a/docs/c-runtime-library/debug.md +++ b/docs/c-runtime-library/debug.md @@ -7,7 +7,7 @@ ms.assetid: a9901568-4846-4731-a404-399d947e2e7a --- # `_DEBUG` -The compiler defines `_DEBUG` when you specify the /MTd, /MDd, or /LDd option. These options specify debug versions of the C run-time library. +The compiler defines `_DEBUG` when you specify the `/MTd`, `/MDd`, or `/LDd` option. These options specify debug versions of the C run-time library. For more information, see [CRT debugging techniques](./crt-debugging-techniques.md). From 26d3f78a7609912c83c026d50c0473a3a88f7c49 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 23:19:21 +0800 Subject: [PATCH 0573/1799] Simplify and add links in `_DEBUG` macro reference --- docs/c-runtime-library/debug.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/c-runtime-library/debug.md b/docs/c-runtime-library/debug.md index cad5919065c..b2c59938525 100644 --- a/docs/c-runtime-library/debug.md +++ b/docs/c-runtime-library/debug.md @@ -7,10 +7,11 @@ ms.assetid: a9901568-4846-4731-a404-399d947e2e7a --- # `_DEBUG` -The compiler defines `_DEBUG` when you specify the `/MTd`, `/MDd`, or `/LDd` option. These options specify debug versions of the C run-time library. +The compiler defines `_DEBUG` when you specify the [`/MTd`](../build/reference/md-mt-ld-use-run-time-library.md), [`/MDd`](../build/reference/md-mt-ld-use-run-time-library.md), or [`/LDd`](../build/reference/md-mt-ld-use-run-time-library.md) option. These options specify debug versions of the C run-time library. -For more information, see [CRT debugging techniques](./crt-debugging-techniques.md). +For more information, see [CRT debugging techniques](crt-debugging-techniques.md). ## See also -[Control flags](./control-flags.md) +[Control flags](control-flags.md)\ +[Predefined macros](../preprocessor/predefined-macros.md) From 84740f300d35ff663660c758cbe65c1d6236b786 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 23:19:54 +0800 Subject: [PATCH 0574/1799] Update metadata in `_DEBUG` macro reference --- docs/c-runtime-library/debug.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/c-runtime-library/debug.md b/docs/c-runtime-library/debug.md index b2c59938525..f3d187ab4ff 100644 --- a/docs/c-runtime-library/debug.md +++ b/docs/c-runtime-library/debug.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: _DEBUG" title: "_DEBUG" -ms.date: "11/04/2016" +description: "Learn more about: _DEBUG" +ms.date: 11/04/2016 helpviewer_keywords: ["DEBUG macro", "_DEBUG macro"] -ms.assetid: a9901568-4846-4731-a404-399d947e2e7a --- # `_DEBUG` From fda1c3cbfb34e284f61440d68c615800e38bcf37 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 23:29:24 +0800 Subject: [PATCH 0575/1799] Add blockquotes for error messages in range [C2521, C2550] --- docs/error-messages/compiler-errors-2/compiler-error-c2521.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2523.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2524.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2526.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2528.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2529.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2530.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2531.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2532.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2533.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2534.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2535.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2537.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2540.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2541.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2542.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2543.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2544.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2545.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2548.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2549.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2550.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md index dee34ce80d3..1a73b9ea451 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md @@ -8,7 +8,7 @@ ms.assetid: 6042821b-e345-4a54-a7e9-a2c9019ea016 --- # Compiler Error C2521 -function does not take any arguments +> function does not take any arguments You attempted to use arguments with a destructor or finalizer. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md index 5b41bea97ec..a6b622ea140 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md @@ -8,7 +8,7 @@ ms.assetid: 7951b700-8f37-45a0-beb4-a79ae0ced72e --- # Compiler Error C2523 -'class::~identifier' : destructor/finalizer tag mismatch +> 'class::~identifier' : destructor/finalizer tag mismatch The name of the destructor must be the class name preceded by a tilde (`~`). The constructor and destructor are the only members that have the same name as the class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2524.md b/docs/error-messages/compiler-errors-2/compiler-error-c2524.md index 1614c50b8dd..36c38611aa2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2524.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2524.md @@ -8,7 +8,7 @@ ms.assetid: e71d17f5-2fc2-416b-8dbd-e9bed85eb33a --- # Compiler Error C2524 -'destructor' : a destructor/finalizer must have a 'void' parameter list +> 'destructor' : a destructor/finalizer must have a 'void' parameter list The destructor or finalizer had a parameter list that is not [void](../../cpp/void-cpp.md). Other parameter types are not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md index bd212154e23..4a9678aba1e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2526"] --- # Compiler Error C2526 -'identifier1' : C linkage function cannot return C++ class 'identifier2' +> 'identifier1' : C linkage function cannot return C++ class 'identifier2' A function defined with C linkage cannot return a user-defined type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md index a70528679d2..ce3a48736d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md @@ -8,7 +8,7 @@ ms.assetid: 2ea9d583-67a8-4b16-b35f-a50eeffc03c4 --- # Compiler Error C2528 -'name' : pointer to reference is illegal +> 'name' : pointer to reference is illegal You cannot declare a pointer to a reference. Dereference the variable before declaring a pointer to it. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md index 6a7223a5af7..e95dd10d0e3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md @@ -8,7 +8,7 @@ ms.assetid: 73a99e55-b91e-488d-9b72-cc80faaeb436 --- # Compiler Error C2529 -'name' : reference to reference is illegal +> 'name' : reference to reference is illegal This error may be fixed by using pointer syntax and declaring a reference to a pointer. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md index 4aff7437f14..df770e71992 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md @@ -8,7 +8,7 @@ ms.assetid: b790a312-48df-4a6a-9e27-be2c5f32f16c --- # Compiler Error C2530 -'identifier' : references must be initialized +> 'identifier' : references must be initialized You must initialize a reference when it was declared, unless it is declared already: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md index ea98a6788e1..f091644ada9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md @@ -8,7 +8,7 @@ ms.assetid: c49afe15-55f8-4dc8-ac01-bf653622a7db --- # Compiler Error C2531 -'identifier' : reference to a bit field illegal +> 'identifier' : reference to a bit field illegal References to bit fields are not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2532.md b/docs/error-messages/compiler-errors-2/compiler-error-c2532.md index 3b23c6eeeb6..164bd233aa2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2532.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2532.md @@ -8,6 +8,6 @@ ms.assetid: a94fdf13-5063-4206-b5a5-374930287bee --- # Compiler Error C2532 -'identifier' : illegal modifier for reference +> 'identifier' : illegal modifier for reference The reference was changed. References cannot be modified to refer to another object. Use a pointer instead. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md index bc17130d602..3cd0604a416 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md @@ -8,7 +8,7 @@ ms.assetid: 5b335652-076c-4824-87c8-a741f64a3ce0 --- # Compiler Error C2533 -'identifier' : constructors not allowed a return type +> 'identifier' : constructors not allowed a return type A constructor cannot have a return type (not even a **`void`** return type). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md index 71081526b9a..285fbc5a2a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md @@ -8,7 +8,7 @@ ms.assetid: 481f9f54-5b51-4aa0-8eea-218f10807705 --- # Compiler Error C2534 -'identifier' : constructor cannot return a value +> 'identifier' : constructor cannot return a value A constructor cannot contain a **`return`** statement with an expression (even if the expression has type **`void`**). This differs from regular void-returning function where a return expression of type **`void`** is allowed. However, using the **`return`** statement without an expression is allowed for early returns in the constructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md index 3ead6411365..06ba50f31cb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md @@ -8,7 +8,7 @@ ms.assetid: a958f83e-e2bf-4a59-b44b-d406ec325d7e --- # Compiler Error C2535 -'identifier' : member function already defined or declared +> 'identifier' : member function already defined or declared This error could be caused by using the same formal parameter list in more than one definition or declaration of an overloaded function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md index 10f8c006259..94d766b2770 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2537"] --- # Compiler Error C2537 -'specifier' : illegal linkage specification +> 'specifier' : illegal linkage specification The linkage specifier is not supported. Only the "C" and "C++" linkage specifiers are supported. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md index 89a2a496ade..bd02f01c61d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md @@ -8,7 +8,7 @@ ms.assetid: 92c805a3-2dd9-46ca-a63d-3845c18ecc95 --- # Compiler Error C2540 -non-constant expression as array bound +> non-constant expression as array bound An array must have a constant bound. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md index ac2e94c4f96..d22620cb884 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md @@ -8,7 +8,7 @@ ms.assetid: ed95180f-00df-4e62-a8e9-1b6dab8281bf --- # Compiler Error C2541 -'delete' : delete : cannot delete objects that are not pointers +> 'delete' : delete : cannot delete objects that are not pointers The [delete](../../cpp/delete-operator-cpp.md) operator was used on an object that is not a pointer. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2542.md b/docs/error-messages/compiler-errors-2/compiler-error-c2542.md index c35adf15529..aa21bc7cd5a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2542.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2542.md @@ -8,7 +8,7 @@ ms.assetid: a984520d-f835-4cac-ac0e-7f1d5f5c6278 --- # Compiler Error C2542 -'identifier' : class object has no constructor for initialization +> 'identifier' : class object has no constructor for initialization There is no constructor with a parameter list that matches the initialization. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2543.md b/docs/error-messages/compiler-errors-2/compiler-error-c2543.md index b4167a06053..c0bf93256d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2543.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2543.md @@ -8,7 +8,7 @@ ms.assetid: 6e4d2d03-ef34-4514-92fe-763543a71fa8 --- # Compiler Error C2543 -expected ']' for operator '[]' +> expected ']' for operator '[]' The subscripting operator is missing a left bracket. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2544.md b/docs/error-messages/compiler-errors-2/compiler-error-c2544.md index 7f975f4a00f..d8a7479b02b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2544.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2544.md @@ -8,7 +8,7 @@ ms.assetid: 8e79b74a-4e92-4752-a5fe-c3143dfc5524 --- # Compiler Error C2544 -expected ')' for operator '()' +> expected ')' for operator '()' The function call operator is missing a left parenthesis. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2545.md b/docs/error-messages/compiler-errors-2/compiler-error-c2545.md index 65bbf221f32..a67f891938f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2545.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2545.md @@ -8,7 +8,7 @@ ms.assetid: 51598eb9-0c57-4306-a0cd-3862980f3672 --- # Compiler Error C2545 -'operator' : unable to find overloaded operator +> 'operator' : unable to find overloaded operator The operator cannot be used with the operands provided. You must supply an overloaded operator with the required operands. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md index 975747ca343..96e3ed684ff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2548"] --- # Compiler error C2548 -'class::member' : missing default parameter for parameter parameter +> 'class::member' : missing default parameter for parameter parameter The default parameter list is missing a parameter. If you supply a default parameter anywhere in a parameter list, you must define default parameters for all subsequent parameters in the current declaration or any previous declarations within the same scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md index 95ea293aa90..a1de490cc7f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md @@ -8,7 +8,7 @@ ms.assetid: 29310094-54a3-4605-bc6d-a312a68daf5d --- # Compiler Error C2549 -user-defined conversion cannot specify a return type +> user-defined conversion cannot specify a return type The following sample generates C2549: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md index 12046ba0826..afea03519a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md @@ -8,7 +8,7 @@ ms.assetid: 3293f53e-ee66-4035-920d-34e115c3a24c --- # Compiler Error C2550 -'identifier' : constructor initializer lists are only allowed on constructor definitions +> 'identifier' : constructor initializer lists are only allowed on constructor definitions A base class initializer list is used on the definition of a function that is not a constructor. From 6e1d0266feb8df55ca6bb0c4d77d35362f0ae6cb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 23:33:52 +0800 Subject: [PATCH 0576/1799] Add "Remarks" and "Example" headings for error references in range [C2521, C2550] --- docs/error-messages/compiler-errors-2/compiler-error-c2521.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2523.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2524.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2526.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2528.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2529.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2530.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2531.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2532.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2533.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2534.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2535.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2537.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2540.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2541.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2542.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2543.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2544.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2545.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2548.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2549.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2550.md | 4 ++++ 22 files changed, 70 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md index 1a73b9ea451..065d995ee41 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md @@ -10,6 +10,8 @@ ms.assetid: 6042821b-e345-4a54-a7e9-a2c9019ea016 > function does not take any arguments +## Remarks + You attempted to use arguments with a destructor or finalizer. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md index a6b622ea140..98020918004 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md @@ -10,8 +10,12 @@ ms.assetid: 7951b700-8f37-45a0-beb4-a79ae0ced72e > 'class::~identifier' : destructor/finalizer tag mismatch +## Remarks + The name of the destructor must be the class name preceded by a tilde (`~`). The constructor and destructor are the only members that have the same name as the class. +## Example + The following sample generates C2523: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2524.md b/docs/error-messages/compiler-errors-2/compiler-error-c2524.md index 36c38611aa2..d65346d04cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2524.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2524.md @@ -10,6 +10,8 @@ ms.assetid: e71d17f5-2fc2-416b-8dbd-e9bed85eb33a > 'destructor' : a destructor/finalizer must have a 'void' parameter list +## Remarks + The destructor or finalizer had a parameter list that is not [void](../../cpp/void-cpp.md). Other parameter types are not allowed. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md index 4a9678aba1e..f457aa9a74b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2526"] > 'identifier1' : C linkage function cannot return C++ class 'identifier2' +## Remarks + A function defined with C linkage cannot return a user-defined type. +## Example + The following sample generates C2526: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md index ce3a48736d7..7e04ea8388c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md @@ -10,8 +10,12 @@ ms.assetid: 2ea9d583-67a8-4b16-b35f-a50eeffc03c4 > 'name' : pointer to reference is illegal +## Remarks + You cannot declare a pointer to a reference. Dereference the variable before declaring a pointer to it. +## Example + The following sample generates C2528: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md index e95dd10d0e3..c221afbf118 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md @@ -10,8 +10,12 @@ ms.assetid: 73a99e55-b91e-488d-9b72-cc80faaeb436 > 'name' : reference to reference is illegal +## Remarks + This error may be fixed by using pointer syntax and declaring a reference to a pointer. +## Example + The following sample generates C2529: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md index df770e71992..7751cbf3611 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md @@ -10,6 +10,8 @@ ms.assetid: b790a312-48df-4a6a-9e27-be2c5f32f16c > 'identifier' : references must be initialized +## Remarks + You must initialize a reference when it was declared, unless it is declared already: - With the keyword [extern](../../cpp/extern-cpp.md). @@ -20,6 +22,8 @@ You must initialize a reference when it was declared, unless it is declared alre - As the return type of a function. +## Example + The following sample generates C2530: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md index f091644ada9..3ff0c432ea6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md @@ -10,8 +10,12 @@ ms.assetid: c49afe15-55f8-4dc8-ac01-bf653622a7db > 'identifier' : reference to a bit field illegal +## Remarks + References to bit fields are not allowed. +## Example + The following sample generates C2531: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2532.md b/docs/error-messages/compiler-errors-2/compiler-error-c2532.md index 164bd233aa2..ce4e7ade81b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2532.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2532.md @@ -10,4 +10,6 @@ ms.assetid: a94fdf13-5063-4206-b5a5-374930287bee > 'identifier' : illegal modifier for reference +## Remarks + The reference was changed. References cannot be modified to refer to another object. Use a pointer instead. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md index 3cd0604a416..6dbbee9b918 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md @@ -10,10 +10,14 @@ ms.assetid: 5b335652-076c-4824-87c8-a741f64a3ce0 > 'identifier' : constructors not allowed a return type +## Remarks + A constructor cannot have a return type (not even a **`void`** return type). A common source of this error is a missing semicolon between the end of a class definition and the first constructor implementation. The compiler sees the class as a definition of the return type for the constructor function, and generates C2533. +## Example + The following sample generates C2533, and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md index 285fbc5a2a6..d613c68975c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md @@ -10,8 +10,12 @@ ms.assetid: 481f9f54-5b51-4aa0-8eea-218f10807705 > 'identifier' : constructor cannot return a value +## Remarks + A constructor cannot contain a **`return`** statement with an expression (even if the expression has type **`void`**). This differs from regular void-returning function where a return expression of type **`void`** is allowed. However, using the **`return`** statement without an expression is allowed for early returns in the constructor. +## Example + The following sample generates C2534: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md index 06ba50f31cb..b7e1c63a45e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md @@ -10,10 +10,14 @@ ms.assetid: a958f83e-e2bf-4a59-b44b-d406ec325d7e > 'identifier' : member function already defined or declared +## Remarks + This error could be caused by using the same formal parameter list in more than one definition or declaration of an overloaded function. If you get C2535 because of the Dispose function, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers) for more information. +## Example + The following sample generates C2535: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md index 94d766b2770..9e4e22f16f5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2537"] > 'specifier' : illegal linkage specification +## Remarks + The linkage specifier is not supported. Only the "C" and "C++" linkage specifiers are supported. +## Example + The following sample generates C2537: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md index bd02f01c61d..a0708b921d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md @@ -10,8 +10,12 @@ ms.assetid: 92c805a3-2dd9-46ca-a63d-3845c18ecc95 > non-constant expression as array bound +## Remarks + An array must have a constant bound. +## Example + The following sample generates C2540: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md index d22620cb884..7343169c13b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md @@ -10,8 +10,12 @@ ms.assetid: ed95180f-00df-4e62-a8e9-1b6dab8281bf > 'delete' : delete : cannot delete objects that are not pointers +## Remarks + The [delete](../../cpp/delete-operator-cpp.md) operator was used on an object that is not a pointer. +## Example + The following sample generates C2541: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2542.md b/docs/error-messages/compiler-errors-2/compiler-error-c2542.md index aa21bc7cd5a..3ce231ed9df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2542.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2542.md @@ -10,6 +10,8 @@ ms.assetid: a984520d-f835-4cac-ac0e-7f1d5f5c6278 > 'identifier' : class object has no constructor for initialization +## Remarks + There is no constructor with a parameter list that matches the initialization. This error can be caused by incorrect parameters in initialization. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2543.md b/docs/error-messages/compiler-errors-2/compiler-error-c2543.md index c0bf93256d6..5571c4fe250 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2543.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2543.md @@ -10,6 +10,8 @@ ms.assetid: 6e4d2d03-ef34-4514-92fe-763543a71fa8 > expected ']' for operator '[]' +## Remarks + The subscripting operator is missing a left bracket. This error can be caused by macro expansion. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2544.md b/docs/error-messages/compiler-errors-2/compiler-error-c2544.md index d8a7479b02b..e7f61268a22 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2544.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2544.md @@ -10,6 +10,8 @@ ms.assetid: 8e79b74a-4e92-4752-a5fe-c3143dfc5524 > expected ')' for operator '()' +## Remarks + The function call operator is missing a left parenthesis. This error can be caused by macro expansion. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2545.md b/docs/error-messages/compiler-errors-2/compiler-error-c2545.md index a67f891938f..a3c353f29f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2545.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2545.md @@ -10,6 +10,8 @@ ms.assetid: 51598eb9-0c57-4306-a0cd-3862980f3672 > 'operator' : unable to find overloaded operator +## Remarks + The operator cannot be used with the operands provided. You must supply an overloaded operator with the required operands. This error can be caused if operands have incorrect type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md index 96e3ed684ff..9a428018cb6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2548"] > 'class::member' : missing default parameter for parameter parameter +## Remarks + The default parameter list is missing a parameter. If you supply a default parameter anywhere in a parameter list, you must define default parameters for all subsequent parameters in the current declaration or any previous declarations within the same scope. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md index a1de490cc7f..c9561fbb173 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md @@ -10,6 +10,8 @@ ms.assetid: 29310094-54a3-4605-bc6d-a312a68daf5d > user-defined conversion cannot specify a return type +## Example + The following sample generates C2549: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md index afea03519a6..7f64c7e4e1d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md @@ -10,8 +10,12 @@ ms.assetid: 3293f53e-ee66-4035-920d-34e115c3a24c > 'identifier' : constructor initializer lists are only allowed on constructor definitions +## Remarks + A base class initializer list is used on the definition of a function that is not a constructor. +## Example + The following sample generates C2550: ```cpp From a6ab60723569aded014d40543e42f458e3b1f69a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 23:34:59 +0800 Subject: [PATCH 0577/1799] Replace term "sample" with "example" for error references in range [C2521, C2550] --- docs/error-messages/compiler-errors-2/compiler-error-c2521.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2523.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2526.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2528.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2529.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2530.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2531.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2533.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2534.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2535.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2537.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2540.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2541.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2548.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2549.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2550.md | 2 +- 16 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md index 065d995ee41..ea535a570cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md @@ -18,7 +18,7 @@ For more information, see [Destructors and finalizers](../../dotnet/how-to-defin ## Example -The following sample generates C2521. +The following example generates C2521. ```cpp // C2521.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md index 98020918004..25ef30dccb0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md @@ -16,7 +16,7 @@ The name of the destructor must be the class name preceded by a tilde (`~`). The ## Example -The following sample generates C2523: +The following example generates C2523: ```cpp // C2523.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md index f457aa9a74b..2536ae0d9de 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md @@ -15,7 +15,7 @@ A function defined with C linkage cannot return a user-defined type. ## Example -The following sample generates C2526: +The following example generates C2526: ```cpp // C2526.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md index 7e04ea8388c..5a97f088414 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md @@ -16,7 +16,7 @@ You cannot declare a pointer to a reference. Dereference the variable before dec ## Example -The following sample generates C2528: +The following example generates C2528: ```cpp // C2528.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md index c221afbf118..781ae0c0cff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md @@ -16,7 +16,7 @@ This error may be fixed by using pointer syntax and declaring a reference to a p ## Example -The following sample generates C2529: +The following example generates C2529: ```cpp // C2529.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md index 7751cbf3611..851df6bec14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md @@ -24,7 +24,7 @@ You must initialize a reference when it was declared, unless it is declared alre ## Example -The following sample generates C2530: +The following example generates C2530: ```cpp // C2530.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md index 3ff0c432ea6..563eb58371c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md @@ -16,7 +16,7 @@ References to bit fields are not allowed. ## Example -The following sample generates C2531: +The following example generates C2531: ```cpp // C2531.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md index 6dbbee9b918..fe6705922b2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md @@ -18,7 +18,7 @@ A common source of this error is a missing semicolon between the end of a class ## Example -The following sample generates C2533, and shows how to fix it: +The following example generates C2533, and shows how to fix it: ```cpp // C2533.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md index d613c68975c..7abc8743db7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md @@ -16,7 +16,7 @@ A constructor cannot contain a **`return`** statement with an expression (even i ## Example -The following sample generates C2534: +The following example generates C2534: ```cpp // C2534.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md index b7e1c63a45e..3007ace7b16 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md @@ -18,7 +18,7 @@ If you get C2535 because of the Dispose function, see [Destructors and finalizer ## Example -The following sample generates C2535: +The following example generates C2535: ```cpp // C2535.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md index 9e4e22f16f5..f21e9255bae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md @@ -15,7 +15,7 @@ The linkage specifier is not supported. Only the "C" and "C++" linkage specifier ## Example -The following sample generates C2537: +The following example generates C2537: ```cpp // C2537.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md index a0708b921d2..4ae43a791e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md @@ -16,7 +16,7 @@ An array must have a constant bound. ## Example -The following sample generates C2540: +The following example generates C2540: ```cpp // C2540.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md index 7343169c13b..15f91683b4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md @@ -16,7 +16,7 @@ The [delete](../../cpp/delete-operator-cpp.md) operator was used on an object th ## Example -The following sample generates C2541: +The following example generates C2541: ```cpp // C2541.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md index 9a428018cb6..5c8525181bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md @@ -15,12 +15,12 @@ The default parameter list is missing a parameter. If you supply a default param ## Example -The following sample generates C2548 for: +The following example generates C2548 for: - `func1` because it's missing the default argument `b`. - `func3` because it's missing the default argument `c`. -The following sample doesn't generate C2548 for: +The following example doesn't generate C2548 for: - `func2` because all the required default arguments are supplied. - The second `func4` declaration because the default argument `c` is supplied in the preceding declaration and is in the same scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md index c9561fbb173..f94416c54d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md @@ -12,7 +12,7 @@ ms.assetid: 29310094-54a3-4605-bc6d-a312a68daf5d ## Example -The following sample generates C2549: +The following example generates C2549: ```cpp // C2549.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md index 7f64c7e4e1d..10b8ee2c6e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md @@ -16,7 +16,7 @@ A base class initializer list is used on the definition of a function that is no ## Example -The following sample generates C2550: +The following example generates C2550: ```cpp // C2550.cpp From 45c58d2e972ef9a3b11cd5e48b1115ab453d875c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 30 Jul 2025 23:38:02 +0800 Subject: [PATCH 0578/1799] Update metadata for error references in range [C2521, C2550] --- .../error-messages/compiler-errors-2/compiler-error-c2521.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2523.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2524.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2526.md | 4 ++-- .../error-messages/compiler-errors-2/compiler-error-c2528.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2529.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2530.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2531.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2532.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2533.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2534.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2535.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2537.md | 4 ++-- .../error-messages/compiler-errors-2/compiler-error-c2540.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2541.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2542.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2543.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2544.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2545.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2549.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2550.md | 5 ++--- 21 files changed, 42 insertions(+), 61 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md index ea535a570cc..249652f2fd2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2521" title: "Compiler Error C2521" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2521" +ms.date: 11/04/2016 f1_keywords: ["C2521"] helpviewer_keywords: ["C2521"] -ms.assetid: 6042821b-e345-4a54-a7e9-a2c9019ea016 --- # Compiler Error C2521 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md index 25ef30dccb0..0ae81bfb1d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2523" title: "Compiler Error C2523" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2523" +ms.date: 11/04/2016 f1_keywords: ["C2523"] helpviewer_keywords: ["C2523"] -ms.assetid: 7951b700-8f37-45a0-beb4-a79ae0ced72e --- # Compiler Error C2523 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2524.md b/docs/error-messages/compiler-errors-2/compiler-error-c2524.md index d65346d04cd..b5d7096731c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2524.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2524.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2524" title: "Compiler Error C2524" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2524" +ms.date: 11/04/2016 f1_keywords: ["C2524"] helpviewer_keywords: ["C2524"] -ms.assetid: e71d17f5-2fc2-416b-8dbd-e9bed85eb33a --- # Compiler Error C2524 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md index 2536ae0d9de..9e02ec15aae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2526" title: "Compiler Error C2526" -ms.date: "03/08/2024" +description: "Learn more about: Compiler Error C2526" +ms.date: 03/08/2024 f1_keywords: ["C2526"] helpviewer_keywords: ["C2526"] --- diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md index 5a97f088414..eb69976c237 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2528" title: "Compiler Error C2528" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2528" +ms.date: 11/04/2016 f1_keywords: ["C2528"] helpviewer_keywords: ["C2528"] -ms.assetid: 2ea9d583-67a8-4b16-b35f-a50eeffc03c4 --- # Compiler Error C2528 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md index 781ae0c0cff..bec04c6a15f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2529" title: "Compiler Error C2529" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2529" +ms.date: 11/04/2016 f1_keywords: ["C2529"] helpviewer_keywords: ["C2529"] -ms.assetid: 73a99e55-b91e-488d-9b72-cc80faaeb436 --- # Compiler Error C2529 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md index 851df6bec14..17a71250c71 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2530" title: "Compiler Error C2530" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2530" +ms.date: 11/04/2016 f1_keywords: ["C2530"] helpviewer_keywords: ["C2530"] -ms.assetid: b790a312-48df-4a6a-9e27-be2c5f32f16c --- # Compiler Error C2530 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md index 563eb58371c..f6015c2c29f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2531" title: "Compiler Error C2531" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2531" +ms.date: 11/04/2016 f1_keywords: ["C2531"] helpviewer_keywords: ["C2531"] -ms.assetid: c49afe15-55f8-4dc8-ac01-bf653622a7db --- # Compiler Error C2531 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2532.md b/docs/error-messages/compiler-errors-2/compiler-error-c2532.md index ce4e7ade81b..80856245d87 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2532.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2532.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2532" title: "Compiler Error C2532" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2532" +ms.date: 11/04/2016 f1_keywords: ["C2532"] helpviewer_keywords: ["C2532"] -ms.assetid: a94fdf13-5063-4206-b5a5-374930287bee --- # Compiler Error C2532 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md index fe6705922b2..025404ed61d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2533" title: "Compiler Error C2533" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2533" +ms.date: 11/04/2016 f1_keywords: ["C2533"] helpviewer_keywords: ["C2533"] -ms.assetid: 5b335652-076c-4824-87c8-a741f64a3ce0 --- # Compiler Error C2533 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md index 7abc8743db7..514403e602d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2534" title: "Compiler Error C2534" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2534" +ms.date: 11/04/2016 f1_keywords: ["C2534"] helpviewer_keywords: ["C2534"] -ms.assetid: 481f9f54-5b51-4aa0-8eea-218f10807705 --- # Compiler Error C2534 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md index 3007ace7b16..cb2505b77c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2535" title: "Compiler Error C2535" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2535" +ms.date: 11/04/2016 f1_keywords: ["C2535"] helpviewer_keywords: ["C2535"] -ms.assetid: a958f83e-e2bf-4a59-b44b-d406ec325d7e --- # Compiler Error C2535 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md index f21e9255bae..2a767197bcb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2537" title: "Compiler Error C2537" -ms.date: "03/08/2024" +description: "Learn more about: Compiler Error C2537" +ms.date: 03/08/2024 f1_keywords: ["C2537"] helpviewer_keywords: ["C2537"] --- diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md index 4ae43a791e8..0278d815c0e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2540" title: "Compiler Error C2540" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2540" +ms.date: 11/04/2016 f1_keywords: ["C2540"] helpviewer_keywords: ["C2540"] -ms.assetid: 92c805a3-2dd9-46ca-a63d-3845c18ecc95 --- # Compiler Error C2540 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md index 15f91683b4b..54bc47b02b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2541" title: "Compiler Error C2541" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2541" +ms.date: 11/04/2016 f1_keywords: ["C2541"] helpviewer_keywords: ["C2541"] -ms.assetid: ed95180f-00df-4e62-a8e9-1b6dab8281bf --- # Compiler Error C2541 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2542.md b/docs/error-messages/compiler-errors-2/compiler-error-c2542.md index 3ce231ed9df..b41ae2e7d22 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2542.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2542.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2542" title: "Compiler Error C2542" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2542" +ms.date: 11/04/2016 f1_keywords: ["C2542"] helpviewer_keywords: ["C2542"] -ms.assetid: a984520d-f835-4cac-ac0e-7f1d5f5c6278 --- # Compiler Error C2542 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2543.md b/docs/error-messages/compiler-errors-2/compiler-error-c2543.md index 5571c4fe250..6f695891d1e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2543.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2543.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2543" title: "Compiler Error C2543" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2543" +ms.date: 11/04/2016 f1_keywords: ["C2543"] helpviewer_keywords: ["C2543"] -ms.assetid: 6e4d2d03-ef34-4514-92fe-763543a71fa8 --- # Compiler Error C2543 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2544.md b/docs/error-messages/compiler-errors-2/compiler-error-c2544.md index e7f61268a22..5a664fae23a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2544.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2544.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2544" title: "Compiler Error C2544" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2544" +ms.date: 11/04/2016 f1_keywords: ["C2544"] helpviewer_keywords: ["C2544"] -ms.assetid: 8e79b74a-4e92-4752-a5fe-c3143dfc5524 --- # Compiler Error C2544 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2545.md b/docs/error-messages/compiler-errors-2/compiler-error-c2545.md index a3c353f29f8..bbf07446c62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2545.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2545.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2545" title: "Compiler Error C2545" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2545" +ms.date: 11/04/2016 f1_keywords: ["C2545"] helpviewer_keywords: ["C2545"] -ms.assetid: 51598eb9-0c57-4306-a0cd-3862980f3672 --- # Compiler Error C2545 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md index f94416c54d2..a779b7adf17 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2549" title: "Compiler Error C2549" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2549" +ms.date: 11/04/2016 f1_keywords: ["C2549"] helpviewer_keywords: ["C2549"] -ms.assetid: 29310094-54a3-4605-bc6d-a312a68daf5d --- # Compiler Error C2549 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md index 10b8ee2c6e8..eac2acfcd2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2550" title: "Compiler Error C2550" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2550" +ms.date: 11/04/2016 f1_keywords: ["C2550"] helpviewer_keywords: ["C2550"] -ms.assetid: 3293f53e-ee66-4035-920d-34e115c3a24c --- # Compiler Error C2550 From 2cd6fb5630276abcc18ec440e55181a50be2a544 Mon Sep 17 00:00:00 2001 From: Dennis Rea Date: Wed, 30 Jul 2025 09:39:11 -0700 Subject: [PATCH 0579/1799] Attempt to raise Acrolinx score to passing --- docs/sanitizers/error-memcpy-param-overlap.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/error-memcpy-param-overlap.md b/docs/sanitizers/error-memcpy-param-overlap.md index 3686347b4f3..5c5c46173de 100644 --- a/docs/sanitizers/error-memcpy-param-overlap.md +++ b/docs/sanitizers/error-memcpy-param-overlap.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["memcpy-param-overlap error", "AddressSanitizer error memc > Address Sanitizer Error: memcpy-param-overlap > [!NOTE] -> The `/Oi` flag is required to reliably detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and other functions as intrinsics, which is necessary because some versions of the standard library implement them as such. Since ASan is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Please note that when `/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions is not guaranteed to be used. See the [`/Oi` docs](../build/reference/oi-generate-intrinsic-functions.md) for more information. +> The `/Oi` flag is required to reliably detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and other functions as intrinsics, which is necessary because some versions of the standard library implement them as such. Since ASan is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Note that when `/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions isn't guaranteed to be used. For more information, see [`/Oi` docs](../build/reference/oi-generate-intrinsic-functions.md). The CRT function [`memcpy`](../c-runtime-library/reference/memcpy-wmemcpy.md) **doesn't support** overlapping memory. The CRT provides an alternative to `memcpy` that does support overlapping memory: [`memmove`](../c-runtime-library/reference/memmove-wmemmove.md). From 690631b0bb3860bd5bbd48cca2cf02c294ea93d0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 31 Jul 2025 23:13:28 +0800 Subject: [PATCH 0580/1799] Add blockquotes for error messages in range [C2551, C2580] --- docs/error-messages/compiler-errors-2/compiler-error-c2551.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2552.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2553.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2557.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2558.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2561.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2562.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2563.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2566.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2567.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2568.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2569.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2570.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2571.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2572.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2573.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2575.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2577.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2579.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2551.md b/docs/error-messages/compiler-errors-2/compiler-error-c2551.md index a0bff6271a9..4b411dd1801 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2551.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2551.md @@ -8,6 +8,6 @@ ms.assetid: 6f48b91d-635b-4eef-b13c-1bf2056c1053 --- # Compiler Error C2551 -'void *' type needs explicit cast +> 'void *' type needs explicit cast A **`void`** pointer is assigned to a nonvoid pointer by implicit conversion. You must use an explicit cast. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md index c3714405422..632757e0461 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md @@ -8,7 +8,7 @@ ms.assetid: 0e0ab759-788a-4faf-9337-80d4b9e2e8c9 --- # Compiler Error C2552 -'identifier' : non-aggregates cannot be initialized with initializer list +> 'identifier' : non-aggregates cannot be initialized with initializer list The aggregate identifier was incorrectly initialized. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md index 4db5c543e36..e9402c9158a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md @@ -8,7 +8,7 @@ ms.assetid: 64bc1e9a-627f-4ce9-b7bc-dc911bdb9180 --- # Compiler Error C2553 -'base_function': overriding virtual function return type differs from 'override_function' +> 'base_function': overriding virtual function return type differs from 'override_function' A function in a derived class attempted to override a virtual function in a base class, but the derived class function did not have the same return type as the base class function. An override function signature must match the signature of the function being overridden. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2557.md b/docs/error-messages/compiler-errors-2/compiler-error-c2557.md index cb0f2c74826..f2ec0b82f32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2557.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2557.md @@ -8,6 +8,6 @@ ms.assetid: 48a33d82-aa16-4658-b346-2311fcb39864 --- # Compiler Error C2557 -'identifier' : private and protected members cannot be initialized without a constructor +> 'identifier' : private and protected members cannot be initialized without a constructor Only members and friends can assign a value to a private or protected member. Nonpublic members should be initialized in the class constructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2558.md b/docs/error-messages/compiler-errors-2/compiler-error-c2558.md index eb0b6683dec..c1d16acc4f5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2558.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2558.md @@ -8,7 +8,7 @@ ms.assetid: 822b701e-dcae-423a-b21f-47f36aff9c90 --- # Compiler Error C2558 -'identifier' : no copy constructor available or copy constructor is declared 'explicit' +> 'identifier' : no copy constructor available or copy constructor is declared 'explicit' A copy constructor initializes an object from another object of the same type. (It makes a copy of the object.) The compiler generates a default copy constructor if you do not define any constructors. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md index 474c57ced61..7487df0595a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md @@ -8,7 +8,7 @@ ms.assetid: 0abe955b-53a6-4a3c-8362-b1a8eb40e8d1 --- # Compiler Error C2561 -'identifier' : function must return a value +> 'identifier' : function must return a value The function was declared as returning a value, but the function definition does not contain a **`return`** statement. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md index 9e95f4fecd7..1030d305af3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md @@ -8,7 +8,7 @@ ms.assetid: 2c41e511-9952-4b98-9976-6b1523613e1b --- # Compiler Error C2562 -'identifier' : 'void' function returning a value +> 'identifier' : 'void' function returning a value The function is declared as **`void`** but returns a value. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md index 5b7c1e30083..86b3c3e42a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md @@ -8,7 +8,7 @@ ms.assetid: 54abba68-6458-4ca5-894d-3babdb7b3552 --- # Compiler Error C2563 -mismatch in formal parameter list +> mismatch in formal parameter list The formal parameter list of a function (or a pointer to a function) does not match those of another function (or pointer to a member function). As a result, the assignment of functions or pointers cannot be made. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2566.md b/docs/error-messages/compiler-errors-2/compiler-error-c2566.md index 1deba5aad6c..97893d234da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2566.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2566.md @@ -8,6 +8,6 @@ ms.assetid: 8fe10fb2-d974-432a-a56b-3a61b9a8dfc2 --- # Compiler Error C2566 -overloaded function in conditional expression +> overloaded function in conditional expression An overloaded function in a conditional expression cannot be evaluated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2567.md b/docs/error-messages/compiler-errors-2/compiler-error-c2567.md index cda3fa6ee81..b0d5030b649 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2567.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2567.md @@ -8,7 +8,7 @@ ms.assetid: 9c140ac9-7059-47e6-9ba1-e7939c8c0dc3 --- # Compiler Error C2567 -unable to open metadata in 'file', file may have been deleted or moved +> unable to open metadata in 'file', file may have been deleted or moved A metadata file that was referenced in source (with `#using`) was not found in the same directory by the compiler back end process as it was by the compiler front end process. See [#using Directive](../../preprocessor/hash-using-directive-cpp.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2568.md b/docs/error-messages/compiler-errors-2/compiler-error-c2568.md index a68ce21d1c6..05b4b10a226 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2568.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2568.md @@ -8,6 +8,6 @@ ms.assetid: 140b4dc9-5a88-4032-9aef-a224bb796f72 --- # Compiler Error C2568 -'identifier1' : unable to resolve function overload +> 'identifier1' : unable to resolve function overload The compiler cannot determine which overloaded function to call. The actual parameters passed to the function must be cast to match the formal parameters for one of the overloaded function, but no one match is unambiguously better than all others. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md index d3ac69ec987..9fd81f84106 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md @@ -8,7 +8,7 @@ ms.assetid: 092bed1e-f631-436c-9586-7750629f6fac --- # Compiler Error C2569 -'EnumOrUnion' : enum/union cannot be used as a base class +> 'EnumOrUnion' : enum/union cannot be used as a base class If you must derive a type from the specified union or enumeration, change the union or enumeration to a class or structure. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md index 161805be9e0..adfadea659c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md @@ -8,7 +8,7 @@ ms.assetid: d65d0b32-2fac-464a-bcdf-0ebcedf3bf32 --- # Compiler Error C2570 -'identifier' : union cannot have base classes +> 'identifier' : union cannot have base classes A union derives from a class, structure, or union. This is not allowed. Declare the derived type as a class or structure instead. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md index ac2efce8e24..408ca13c12f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md @@ -8,7 +8,7 @@ ms.assetid: c6522616-dee9-4d7d-9bf8-30a7e1deaadf --- # Compiler Error C2571 -'function' : virtual function cannot be in union 'union' +> 'function' : virtual function cannot be in union 'union' A union is declared with a virtual function. You can declare a virtual function only in a class or structure. Possible resolutions: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md index eec5bbb70f0..519d892ce85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md @@ -8,7 +8,7 @@ ms.assetid: f1a42d69-727d-4ce5-88c8-d5f55dea66ac --- # Compiler Error C2572 -'class::member' : redefinition of default parameter : parameter param +> 'class::member' : redefinition of default parameter : parameter param Default parameters cannot be redefined. If you require another value for the parameter, the default parameter should be left undefined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2573.md b/docs/error-messages/compiler-errors-2/compiler-error-c2573.md index 435289285d2..9176a954f92 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2573.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2573.md @@ -8,6 +8,6 @@ ms.assetid: 2ce523da-da3c-4fb4-bad2-fbde663dbfbf --- # Compiler Error C2573 -'class' : cannot delete pointers to objects of this type; the class has no non-placement overload for 'operator delete'. +> 'class' : cannot delete pointers to objects of this type; the class has no non-placement overload for 'operator delete'. The class is missing a non-placement delete operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md index ac5c97f6e50..777d97e63e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md @@ -8,7 +8,7 @@ ms.assetid: 9eb45706-37ef-4481-b373-6d193ba13634 --- # Compiler Error C2575 -'identifier' : only member functions and bases can be virtual +> 'identifier' : only member functions and bases can be virtual A global function or class is declared **`virtual`**. This is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md index c935a62d6f2..38bc6cd0170 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md @@ -8,7 +8,7 @@ ms.assetid: fc79ef83-8362-40a2-9257-8037c3195ce4 --- # Compiler Error C2577 -'member' : destructor/finalizer cannot have a return type +> 'member' : destructor/finalizer cannot have a return type A destructor or finalizer cannot return a value of **`void`** or any other type. Remove the **`return`** statement from the destructor definition. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2579.md b/docs/error-messages/compiler-errors-2/compiler-error-c2579.md index f40da38fe60..e0af842b031 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2579.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2579.md @@ -8,6 +8,6 @@ ms.assetid: ab090a8d-5462-4046-a1a6-8007e354dedb --- # Compiler Error C2579 -unable to resolve type 'type' (offset). It is expected in file +> unable to resolve type 'type' (offset). It is expected in file C2579 always follows C4691. For more information, see [Compiler Warning (level 1) C4691](../../error-messages/compiler-warnings/compiler-warning-level-1-c4691.md). From 8faaf3c9ac735d8adfce5f737b5fb09a3cc4f6ab Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 31 Jul 2025 23:19:25 +0800 Subject: [PATCH 0581/1799] Add "Remarks" and "Example" headings for error references in range [C2551, C2580] --- docs/error-messages/compiler-errors-2/compiler-error-c2551.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2552.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2553.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2555.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2557.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2558.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2561.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2562.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2563.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2566.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2567.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2568.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2569.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2570.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2571.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2572.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2573.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2575.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2577.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2579.md | 2 ++ 20 files changed, 60 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2551.md b/docs/error-messages/compiler-errors-2/compiler-error-c2551.md index 4b411dd1801..ec83b5f0f32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2551.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2551.md @@ -10,4 +10,6 @@ ms.assetid: 6f48b91d-635b-4eef-b13c-1bf2056c1053 > 'void *' type needs explicit cast +## Remarks + A **`void`** pointer is assigned to a nonvoid pointer by implicit conversion. You must use an explicit cast. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md index 632757e0461..ef3a48f442a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md @@ -10,6 +10,8 @@ ms.assetid: 0e0ab759-788a-4faf-9337-80d4b9e2e8c9 > 'identifier' : non-aggregates cannot be initialized with initializer list +## Remarks + The aggregate identifier was incorrectly initialized. [Aggregates](../../c-language/initializing-aggregate-types.md) are defined as: @@ -42,6 +44,8 @@ The following represent the reasons C2552 may fire when an aggregate initializat - The type has a non-fixed dimension array (zero-array) whose elements have destructors. +## Example + The following sample generates C2552: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md index e9402c9158a..281323ddab4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md @@ -10,8 +10,12 @@ ms.assetid: 64bc1e9a-627f-4ce9-b7bc-dc911bdb9180 > 'base_function': overriding virtual function return type differs from 'override_function' +## Remarks + A function in a derived class attempted to override a virtual function in a base class, but the derived class function did not have the same return type as the base class function. An override function signature must match the signature of the function being overridden. +## Example + The following sample generates C2553: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2555.md b/docs/error-messages/compiler-errors-2/compiler-error-c2555.md index 787b255c78b..ef7df4b56d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2555.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2555.md @@ -10,10 +10,10 @@ ms.assetid: 5e49ebb8-7c90-457a-aa12-7ca7ab6574b2 > '*class1*::*function1*': overriding virtual function return type differs and is not covariant from '*class2*::*function2*' -A virtual function and a derived overriding function have identical parameter lists but different return types. - ## Remarks +A virtual function and a derived overriding function have identical parameter lists but different return types. + In C++, an overriding function in a derived class can't differ only by return type from a virtual function in a base class. There's an exception to this rule for certain return types. When a derived class overrides a public base class, it may return a pointer or reference to the derived class instead of a base-class pointer or reference. These return types are called *covariant*, because they vary together with the type. This rule exception doesn't allow covariant reference-to-pointer or pointer-to-pointer types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2557.md b/docs/error-messages/compiler-errors-2/compiler-error-c2557.md index f2ec0b82f32..329dd6c24bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2557.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2557.md @@ -10,4 +10,6 @@ ms.assetid: 48a33d82-aa16-4658-b346-2311fcb39864 > 'identifier' : private and protected members cannot be initialized without a constructor +## Remarks + Only members and friends can assign a value to a private or protected member. Nonpublic members should be initialized in the class constructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2558.md b/docs/error-messages/compiler-errors-2/compiler-error-c2558.md index c1d16acc4f5..2ef33656e32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2558.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2558.md @@ -10,6 +10,8 @@ ms.assetid: 822b701e-dcae-423a-b21f-47f36aff9c90 > 'identifier' : no copy constructor available or copy constructor is declared 'explicit' +## Remarks + A copy constructor initializes an object from another object of the same type. (It makes a copy of the object.) The compiler generates a default copy constructor if you do not define any constructors. ### To fix this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md index 7487df0595a..525ffc0c8de 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md @@ -10,6 +10,8 @@ ms.assetid: 0abe955b-53a6-4a3c-8362-b1a8eb40e8d1 > 'identifier' : function must return a value +## Remarks + The function was declared as returning a value, but the function definition does not contain a **`return`** statement. This error can be caused by an incorrect function prototype: @@ -20,6 +22,8 @@ This error can be caused by an incorrect function prototype: 1. C++ functions containing inline assembly routines that store the return value in the `AX` register may need a return statement. Copy the value in `AX` to a temporary variable and return that variable from the function. +## Example + The following sample generates C2561: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md index 1030d305af3..e09ed867609 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md @@ -10,12 +10,16 @@ ms.assetid: 2c41e511-9952-4b98-9976-6b1523613e1b > 'identifier' : 'void' function returning a value +## Remarks + The function is declared as **`void`** but returns a value. This error can be caused by an incorrect function prototype. This error may be fixed if you specify the return type in the function declaration. +## Example + The following sample generates C2562: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md index 86b3c3e42a0..3baff2fc5c6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md @@ -10,8 +10,12 @@ ms.assetid: 54abba68-6458-4ca5-894d-3babdb7b3552 > mismatch in formal parameter list +## Remarks + The formal parameter list of a function (or a pointer to a function) does not match those of another function (or pointer to a member function). As a result, the assignment of functions or pointers cannot be made. +## Example + The following sample generates C2563: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2566.md b/docs/error-messages/compiler-errors-2/compiler-error-c2566.md index 97893d234da..cd9d7231952 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2566.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2566.md @@ -10,4 +10,6 @@ ms.assetid: 8fe10fb2-d974-432a-a56b-3a61b9a8dfc2 > overloaded function in conditional expression +## Remarks + An overloaded function in a conditional expression cannot be evaluated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2567.md b/docs/error-messages/compiler-errors-2/compiler-error-c2567.md index b0d5030b649..ff63e64c0c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2567.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2567.md @@ -10,6 +10,8 @@ ms.assetid: 9c140ac9-7059-47e6-9ba1-e7939c8c0dc3 > unable to open metadata in 'file', file may have been deleted or moved +## Remarks + A metadata file that was referenced in source (with `#using`) was not found in the same directory by the compiler back end process as it was by the compiler front end process. See [#using Directive](../../preprocessor/hash-using-directive-cpp.md) for more information. C2567 could be caused if you compile with **/c** on one machine and then attempt a link-time code generation on another machine. For more information, see [/LTCG (Link-time Code Generation)](../../build/reference/ltcg-link-time-code-generation.md)). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2568.md b/docs/error-messages/compiler-errors-2/compiler-error-c2568.md index 05b4b10a226..3cfa06515c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2568.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2568.md @@ -10,4 +10,6 @@ ms.assetid: 140b4dc9-5a88-4032-9aef-a224bb796f72 > 'identifier1' : unable to resolve function overload +## Remarks + The compiler cannot determine which overloaded function to call. The actual parameters passed to the function must be cast to match the formal parameters for one of the overloaded function, but no one match is unambiguously better than all others. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md index 9fd81f84106..136207247a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md @@ -10,8 +10,12 @@ ms.assetid: 092bed1e-f631-436c-9586-7750629f6fac > 'EnumOrUnion' : enum/union cannot be used as a base class +## Remarks + If you must derive a type from the specified union or enumeration, change the union or enumeration to a class or structure. +## Example + The following sample generates C2569: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md index adfadea659c..2c1c9844729 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md @@ -10,8 +10,12 @@ ms.assetid: d65d0b32-2fac-464a-bcdf-0ebcedf3bf32 > 'identifier' : union cannot have base classes +## Remarks + A union derives from a class, structure, or union. This is not allowed. Declare the derived type as a class or structure instead. +## Example + The following sample generates C2570: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md index 408ca13c12f..c2b175240b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md @@ -10,12 +10,16 @@ ms.assetid: c6522616-dee9-4d7d-9bf8-30a7e1deaadf > 'function' : virtual function cannot be in union 'union' +## Remarks + A union is declared with a virtual function. You can declare a virtual function only in a class or structure. Possible resolutions: 1. Change the union to a class or structure. 1. Make the function nonvirtual. +## Example + The following sample generates C2571: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md index 519d892ce85..0439618b394 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md @@ -10,8 +10,12 @@ ms.assetid: f1a42d69-727d-4ce5-88c8-d5f55dea66ac > 'class::member' : redefinition of default parameter : parameter param +## Remarks + Default parameters cannot be redefined. If you require another value for the parameter, the default parameter should be left undefined. +## Example + The following sample generates C2572: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2573.md b/docs/error-messages/compiler-errors-2/compiler-error-c2573.md index 9176a954f92..6bf3cd235a1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2573.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2573.md @@ -10,4 +10,6 @@ ms.assetid: 2ce523da-da3c-4fb4-bad2-fbde663dbfbf > 'class' : cannot delete pointers to objects of this type; the class has no non-placement overload for 'operator delete'. +## Remarks + The class is missing a non-placement delete operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md index 777d97e63e8..d312c6e8225 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md @@ -10,8 +10,12 @@ ms.assetid: 9eb45706-37ef-4481-b373-6d193ba13634 > 'identifier' : only member functions and bases can be virtual +## Remarks + A global function or class is declared **`virtual`**. This is not allowed. +## Example + The following sample generates C2575: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md index 38bc6cd0170..964aef6a442 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md @@ -10,6 +10,8 @@ ms.assetid: fc79ef83-8362-40a2-9257-8037c3195ce4 > 'member' : destructor/finalizer cannot have a return type +## Remarks + A destructor or finalizer cannot return a value of **`void`** or any other type. Remove the **`return`** statement from the destructor definition. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2579.md b/docs/error-messages/compiler-errors-2/compiler-error-c2579.md index e0af842b031..a21f238a62c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2579.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2579.md @@ -10,4 +10,6 @@ ms.assetid: ab090a8d-5462-4046-a1a6-8007e354dedb > unable to resolve type 'type' (offset). It is expected in file +## Remarks + C2579 always follows C4691. For more information, see [Compiler Warning (level 1) C4691](../../error-messages/compiler-warnings/compiler-warning-level-1-c4691.md). From cfb603fb83b751479154be2ccc14a3ea4af143ec Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 31 Jul 2025 23:20:44 +0800 Subject: [PATCH 0582/1799] Replace term "sample" with "example" for error references in range [C2551, C2580] --- docs/error-messages/compiler-errors-2/compiler-error-c2552.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2553.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2555.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2561.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2562.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2563.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2569.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2570.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2571.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2572.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2575.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2577.md | 2 +- 12 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md index ef3a48f442a..aa8f155728d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md @@ -46,7 +46,7 @@ The following represent the reasons C2552 may fire when an aggregate initializat ## Example -The following sample generates C2552: +The following example generates C2552: ```cpp // C2552.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md index 281323ddab4..e1fcead9a3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md @@ -16,7 +16,7 @@ A function in a derived class attempted to override a virtual function in a base ## Example -The following sample generates C2553: +The following example generates C2553: ```cpp // C2553.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2555.md b/docs/error-messages/compiler-errors-2/compiler-error-c2555.md index ef7df4b56d5..faa134b9ce1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2555.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2555.md @@ -34,7 +34,7 @@ is Guid CheckSources(Guid sourceID, Guid carouselIDs[]) []; ``` -The following sample generates C2555: +The following example generates C2555: ```cpp // C2555.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md index 525ffc0c8de..13725de5eab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md @@ -24,7 +24,7 @@ This error can be caused by an incorrect function prototype: ## Example -The following sample generates C2561: +The following example generates C2561: ```cpp // C2561.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md index e09ed867609..309163d8207 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md @@ -20,7 +20,7 @@ This error may be fixed if you specify the return type in the function declarati ## Example -The following sample generates C2562: +The following example generates C2562: ```cpp // C2562.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md index 3baff2fc5c6..66545044f57 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md @@ -16,7 +16,7 @@ The formal parameter list of a function (or a pointer to a function) does not ma ## Example -The following sample generates C2563: +The following example generates C2563: ```cpp // C2563.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md index 136207247a0..f498d96fbc2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md @@ -16,7 +16,7 @@ If you must derive a type from the specified union or enumeration, change the un ## Example -The following sample generates C2569: +The following example generates C2569: ```cpp // C2569.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md index 2c1c9844729..98c3c74c9c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md @@ -16,7 +16,7 @@ A union derives from a class, structure, or union. This is not allowed. Declare ## Example -The following sample generates C2570: +The following example generates C2570: ```cpp // C2570.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md index c2b175240b0..119376562ea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md @@ -20,7 +20,7 @@ A union is declared with a virtual function. You can declare a virtual function ## Example -The following sample generates C2571: +The following example generates C2571: ```cpp // C2571.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md index 0439618b394..10f78960ea8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md @@ -16,7 +16,7 @@ Default parameters cannot be redefined. If you require another value for the par ## Example -The following sample generates C2572: +The following example generates C2572: ```cpp // C2572.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md index d312c6e8225..a4473d83722 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md @@ -16,7 +16,7 @@ A global function or class is declared **`virtual`**. This is not allowed. ## Example -The following sample generates C2575: +The following example generates C2575: ```cpp // C2575.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md index 964aef6a442..436ccaabab7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md @@ -16,7 +16,7 @@ A destructor or finalizer cannot return a value of **`void`** or any other type. ## Example -The following sample generates C2577. +The following example generates C2577. ```cpp // C2577.cpp From 154e3b70288482bbbf22ceb896712d777f8fb3d7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 31 Jul 2025 23:24:22 +0800 Subject: [PATCH 0583/1799] Update metadata for error references in range [C2551, C2580] --- .../error-messages/compiler-errors-2/compiler-error-c2551.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2552.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2553.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2555.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2557.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2558.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2561.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2562.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2563.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2566.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2567.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2568.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2569.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2570.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2571.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2572.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2573.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2575.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2577.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2579.md | 5 ++--- 20 files changed, 39 insertions(+), 59 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2551.md b/docs/error-messages/compiler-errors-2/compiler-error-c2551.md index ec83b5f0f32..26983767f91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2551.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2551.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2551" title: "Compiler Error C2551" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2551" +ms.date: 11/04/2016 f1_keywords: ["C2551"] helpviewer_keywords: ["C2551"] -ms.assetid: 6f48b91d-635b-4eef-b13c-1bf2056c1053 --- # Compiler Error C2551 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md index aa8f155728d..e995484a613 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2552" title: "Compiler Error C2552" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2552" +ms.date: 11/04/2016 f1_keywords: ["C2552"] helpviewer_keywords: ["C2552"] -ms.assetid: 0e0ab759-788a-4faf-9337-80d4b9e2e8c9 --- # Compiler Error C2552 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md index e1fcead9a3b..bf468cd7234 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2553" title: "Compiler Error C2553" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2553" +ms.date: 11/04/2016 f1_keywords: ["C2553"] helpviewer_keywords: ["C2553"] -ms.assetid: 64bc1e9a-627f-4ce9-b7bc-dc911bdb9180 --- # Compiler Error C2553 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2555.md b/docs/error-messages/compiler-errors-2/compiler-error-c2555.md index faa134b9ce1..e8d97e2e695 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2555.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2555.md @@ -1,10 +1,9 @@ --- title: "Compiler Error C2555" description: "Reference for Visual Studio C++ compiler error C2555." -ms.date: "03/30/2020" +ms.date: 03/30/2020 f1_keywords: ["C2555"] helpviewer_keywords: ["C2555"] -ms.assetid: 5e49ebb8-7c90-457a-aa12-7ca7ab6574b2 --- # Compiler Error C2555 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2557.md b/docs/error-messages/compiler-errors-2/compiler-error-c2557.md index 329dd6c24bb..63bc8d7a2fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2557.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2557.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2557" title: "Compiler Error C2557" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2557" +ms.date: 11/04/2016 f1_keywords: ["C2557"] helpviewer_keywords: ["C2557"] -ms.assetid: 48a33d82-aa16-4658-b346-2311fcb39864 --- # Compiler Error C2557 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2558.md b/docs/error-messages/compiler-errors-2/compiler-error-c2558.md index 2ef33656e32..0b53dfa4199 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2558.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2558.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2558" title: "Compiler Error C2558" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2558" +ms.date: 11/04/2016 f1_keywords: ["C2558"] helpviewer_keywords: ["C2558"] -ms.assetid: 822b701e-dcae-423a-b21f-47f36aff9c90 --- # Compiler Error C2558 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md index 13725de5eab..82c6dd35778 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2561" title: "Compiler Error C2561" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2561" +ms.date: 11/04/2016 f1_keywords: ["C2561"] helpviewer_keywords: ["C2561"] -ms.assetid: 0abe955b-53a6-4a3c-8362-b1a8eb40e8d1 --- # Compiler Error C2561 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md index 309163d8207..b0a67f988fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2562" title: "Compiler Error C2562" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2562" +ms.date: 11/04/2016 f1_keywords: ["C2562"] helpviewer_keywords: ["C2562"] -ms.assetid: 2c41e511-9952-4b98-9976-6b1523613e1b --- # Compiler Error C2562 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md index 66545044f57..8a0d90be59e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2563" title: "Compiler Error C2563" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2563" +ms.date: 11/04/2016 f1_keywords: ["C2563"] helpviewer_keywords: ["C2563"] -ms.assetid: 54abba68-6458-4ca5-894d-3babdb7b3552 --- # Compiler Error C2563 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2566.md b/docs/error-messages/compiler-errors-2/compiler-error-c2566.md index cd9d7231952..728f0d13a2f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2566.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2566.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2566" title: "Compiler Error C2566" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2566" +ms.date: 11/04/2016 f1_keywords: ["C2566"] helpviewer_keywords: ["C2566"] -ms.assetid: 8fe10fb2-d974-432a-a56b-3a61b9a8dfc2 --- # Compiler Error C2566 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2567.md b/docs/error-messages/compiler-errors-2/compiler-error-c2567.md index ff63e64c0c5..9e75dfef04b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2567.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2567.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2567" title: "Compiler Error C2567" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2567" +ms.date: 11/04/2016 f1_keywords: ["C2567"] helpviewer_keywords: ["C2567"] -ms.assetid: 9c140ac9-7059-47e6-9ba1-e7939c8c0dc3 --- # Compiler Error C2567 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2568.md b/docs/error-messages/compiler-errors-2/compiler-error-c2568.md index 3cfa06515c1..20930150ec5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2568.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2568.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2568" title: "Compiler Error C2568" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2568" +ms.date: 11/04/2016 f1_keywords: ["C2568"] helpviewer_keywords: ["C2568"] -ms.assetid: 140b4dc9-5a88-4032-9aef-a224bb796f72 --- # Compiler Error C2568 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md index f498d96fbc2..ca20d30dba3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2569" title: "Compiler Error C2569" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2569" +ms.date: 11/04/2016 f1_keywords: ["C2569"] helpviewer_keywords: ["C2569"] -ms.assetid: 092bed1e-f631-436c-9586-7750629f6fac --- # Compiler Error C2569 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md index 98c3c74c9c5..29977145390 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2570" title: "Compiler Error C2570" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2570" +ms.date: 11/04/2016 f1_keywords: ["C2570"] helpviewer_keywords: ["C2570"] -ms.assetid: d65d0b32-2fac-464a-bcdf-0ebcedf3bf32 --- # Compiler Error C2570 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md index 119376562ea..358d64654b2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2571" title: "Compiler Error C2571" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2571" +ms.date: 11/04/2016 f1_keywords: ["C2571"] helpviewer_keywords: ["C2571"] -ms.assetid: c6522616-dee9-4d7d-9bf8-30a7e1deaadf --- # Compiler Error C2571 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md index 10f78960ea8..44a23efa094 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2572" title: "Compiler Error C2572" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2572" +ms.date: 11/04/2016 f1_keywords: ["C2572"] helpviewer_keywords: ["C2572"] -ms.assetid: f1a42d69-727d-4ce5-88c8-d5f55dea66ac --- # Compiler Error C2572 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2573.md b/docs/error-messages/compiler-errors-2/compiler-error-c2573.md index 6bf3cd235a1..28c8053df8d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2573.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2573.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2573" title: "Compiler Error C2573" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2573" +ms.date: 11/04/2016 f1_keywords: ["C2573"] helpviewer_keywords: ["C2573"] -ms.assetid: 2ce523da-da3c-4fb4-bad2-fbde663dbfbf --- # Compiler Error C2573 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md index a4473d83722..1e9527cef38 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2575" title: "Compiler Error C2575" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2575" +ms.date: 11/04/2016 f1_keywords: ["C2575"] helpviewer_keywords: ["C2575"] -ms.assetid: 9eb45706-37ef-4481-b373-6d193ba13634 --- # Compiler Error C2575 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md index 436ccaabab7..45c7e0f6b16 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2577" title: "Compiler Error C2577" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2577" +ms.date: 11/04/2016 f1_keywords: ["C2577"] helpviewer_keywords: ["C2577"] -ms.assetid: fc79ef83-8362-40a2-9257-8037c3195ce4 --- # Compiler Error C2577 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2579.md b/docs/error-messages/compiler-errors-2/compiler-error-c2579.md index a21f238a62c..f4e504ca778 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2579.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2579.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2579" title: "Compiler Error C2579" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2579" +ms.date: 11/04/2016 f1_keywords: ["C2579"] helpviewer_keywords: ["C2579"] -ms.assetid: ab090a8d-5462-4046-a1a6-8007e354dedb --- # Compiler Error C2579 From d95ce3e135aa25f862927cd9e3be97a1fd7f9939 Mon Sep 17 00:00:00 2001 From: Mark Rotteveel Date: Fri, 1 Aug 2025 10:28:08 +0200 Subject: [PATCH 0584/1799] Fix URLs to C++ Core Guidelines Replace repo-url with published site URL. The ids used are not valid on the GitHub repository (https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md), but are valid on the published site (https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). --- docs/code-quality/c26400.md | 2 +- docs/code-quality/c26401.md | 2 +- docs/code-quality/c26402.md | 2 +- docs/code-quality/c26403.md | 2 +- docs/code-quality/c26405.md | 2 +- docs/code-quality/c26406.md | 2 +- docs/code-quality/c26407.md | 2 +- docs/code-quality/c26408.md | 2 +- docs/code-quality/c26410.md | 4 +- docs/code-quality/c26411.md | 2 +- docs/code-quality/c26415.md | 2 +- docs/code-quality/c26416.md | 2 +- docs/code-quality/c26417.md | 2 +- docs/code-quality/c26418.md | 2 +- docs/code-quality/c26426.md | 2 +- docs/code-quality/c26427.md | 2 +- docs/code-quality/c26429.md | 2 +- docs/code-quality/c26430.md | 2 +- docs/code-quality/c26431.md | 2 +- docs/code-quality/c26433.md | 4 +- docs/code-quality/c26434.md | 2 +- docs/code-quality/c26435.md | 4 +- docs/code-quality/c26436.md | 2 +- docs/code-quality/c26438.md | 2 +- docs/code-quality/c26440.md | 2 +- docs/code-quality/c26443.md | 4 +- docs/code-quality/c26445.md | 2 +- docs/code-quality/c26446.md | 2 +- docs/code-quality/c26447.md | 2 +- docs/code-quality/c26448.md | 2 +- docs/code-quality/c26451.md | 2 +- docs/code-quality/c26456.md | 2 +- docs/code-quality/c26457.md | 2 +- docs/code-quality/c26460.md | 2 +- docs/code-quality/c26461.md | 2 +- docs/code-quality/c26462.md | 2 +- docs/code-quality/c26463.md | 2 +- docs/code-quality/c26464.md | 2 +- docs/code-quality/c26465.md | 2 +- docs/code-quality/c26466.md | 2 +- docs/code-quality/c26471.md | 2 +- docs/code-quality/c26472.md | 2 +- docs/code-quality/c26473.md | 2 +- docs/code-quality/c26474.md | 2 +- docs/code-quality/c26475.md | 2 +- docs/code-quality/c26476.md | 2 +- docs/code-quality/c26477.md | 2 +- docs/code-quality/c26481.md | 4 +- docs/code-quality/c26482.md | 2 +- docs/code-quality/c26483.md | 2 +- docs/code-quality/c26485.md | 4 +- docs/code-quality/c26490.md | 2 +- docs/code-quality/c26491.md | 2 +- docs/code-quality/c26492.md | 2 +- docs/code-quality/c26493.md | 2 +- docs/code-quality/c26495.md | 2 +- docs/code-quality/c26496.md | 2 +- docs/code-quality/c26497.md | 2 +- docs/code-quality/c26812.md | 2 +- docs/code-quality/c26814.md | 2 +- docs/code-quality/c26818.md | 2 +- .../code-analysis-for-c-cpp-overview.md | 2 +- .../code-analysis-for-cpp-corecheck.md | 146 +++++++++--------- .../quick-start-code-analysis-for-c-cpp.md | 36 ++--- .../using-the-cpp-core-guidelines-checkers.md | 36 ++--- docs/cpp/void-cpp.md | 2 +- docs/overview/overview-of-cpp-development.md | 2 +- 67 files changed, 179 insertions(+), 179 deletions(-) diff --git a/docs/code-quality/c26400.md b/docs/code-quality/c26400.md index ccdd3a65e3c..99711c0b89c 100644 --- a/docs/code-quality/c26400.md +++ b/docs/code-quality/c26400.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26400"] ## Remarks -This check helps to enforce the *rule I.11: Never transfer ownership by a raw pointer (T\*), which is a subset of the rule *R.3: A raw pointer (a T\*) is non-owning*. Specifically, it warns on any call to `operator new`, which saves its result in a variable of raw pointer type. It also warns on calls to functions that return `gsl::owner` if their results are assigned to raw pointers. The idea is that you should clearly state ownership of memory resources. For more information, see the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). +This check helps to enforce the *rule I.11: Never transfer ownership by a raw pointer (T\*), which is a subset of the rule *R.3: A raw pointer (a T\*) is non-owning*. Specifically, it warns on any call to `operator new`, which saves its result in a variable of raw pointer type. It also warns on calls to functions that return `gsl::owner` if their results are assigned to raw pointers. The idea is that you should clearly state ownership of memory resources. For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). The easiest way to fix this warning is to use **`auto`** declaration if the resource is assigned immediately at the variable declaration. If this fix isn't possible, then we suggest that you use the type `gsl::owner`. The **`auto`** declarations initialized with operator **`new`** are "owners" because we assume that the result of any allocation is implicitly an owner pointer. We transfer this assumption to the **`auto`** variable and treat it as `owner`. diff --git a/docs/code-quality/c26401.md b/docs/code-quality/c26401.md index 023338c3780..c8b4c50b84d 100644 --- a/docs/code-quality/c26401.md +++ b/docs/code-quality/c26401.md @@ -20,7 +20,7 @@ Code analysis name: `DONT_DELETE_NON_OWNER` ## See also -[C++ Core Guidelines I.11](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i11-never-transfer-ownership-by-a-raw-pointer-t-or-reference-t) +[C++ Core Guidelines I.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i11-never-transfer-ownership-by-a-raw-pointer-t-or-reference-t) ## Examples diff --git a/docs/code-quality/c26402.md b/docs/code-quality/c26402.md index b79483f914f..16f0f248d2b 100644 --- a/docs/code-quality/c26402.md +++ b/docs/code-quality/c26402.md @@ -12,7 +12,7 @@ ms.assetid: b9d3d398-697a-4a5d-8bfe-9c667dffb90b ## Remarks -To avoid confusion about whether a pointer owns an object, a function that returns a movable object should allocate it on the stack. It should then return the object by value instead of returning a heap-allocated object. If pointer semantics are required, return a smart pointer instead of a raw pointer. For more information, see [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr): *Warn if a function returns an object that was allocated within the function but has a move constructor. Suggest considering returning it by value instead.* +To avoid confusion about whether a pointer owns an object, a function that returns a movable object should allocate it on the stack. It should then return the object by value instead of returning a heap-allocated object. If pointer semantics are required, return a smart pointer instead of a raw pointer. For more information, see [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr): *Warn if a function returns an object that was allocated within the function but has a move constructor. Suggest considering returning it by value instead.* ## Example diff --git a/docs/code-quality/c26403.md b/docs/code-quality/c26403.md index 2501899487d..70f1e92ac51 100644 --- a/docs/code-quality/c26403.md +++ b/docs/code-quality/c26403.md @@ -12,7 +12,7 @@ ms.assetid: 7e14868d-df86-4df3-98d3-71b1e80ba14e Owner pointers are like unique pointers: they own a resource exclusively, and manage release of the resource, or its transfers to other owners. This check validates that a local owner pointer properly maintains its resource through all execution paths in a function. If the resource wasn't transferred to another owner, or wasn't explicitly release, the checker warns, and points to the declaration of the pointer variable. -For more information, see the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). +For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). ## Remarks diff --git a/docs/code-quality/c26405.md b/docs/code-quality/c26405.md index cf14b63ea67..4384443ba29 100644 --- a/docs/code-quality/c26405.md +++ b/docs/code-quality/c26405.md @@ -12,7 +12,7 @@ ms.assetid: 2034d961-3ec5-4184-bbef-aa792e4c03c0 ## Remarks -If an owner pointer already points to a valid memory buffer, it must not be assigned to another value without releasing its current resource first. Such assignment may lead to a resource leak even if the resource address is copied into some raw pointer (because raw pointers shouldn't release resources). For more information, see the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r3-a-raw-pointer-a-t-is-non-owning). +If an owner pointer already points to a valid memory buffer, it must not be assigned to another value without releasing its current resource first. Such assignment may lead to a resource leak even if the resource address is copied into some raw pointer (because raw pointers shouldn't release resources). For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r3-a-raw-pointer-a-t-is-non-owning). Code analysis name: `DONT_ASSIGN_TO_VALID` diff --git a/docs/code-quality/c26406.md b/docs/code-quality/c26406.md index 1dc0b113bfb..0e4688cdc28 100644 --- a/docs/code-quality/c26406.md +++ b/docs/code-quality/c26406.md @@ -10,7 +10,7 @@ ms.assetid: 02fb8e23-1989-4e24-a5a5-e30f71d00325 > Do not assign a raw pointer to an `owner` (r.3) -This warning enforces R.3 from the C++ Core Guidelines. For more information, see [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r3-a-raw-pointer-a-t-is-non-owning). +This warning enforces R.3 from the C++ Core Guidelines. For more information, see [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r3-a-raw-pointer-a-t-is-non-owning). ## Remarks diff --git a/docs/code-quality/c26407.md b/docs/code-quality/c26407.md index d082e566811..0a5af3152a4 100644 --- a/docs/code-quality/c26407.md +++ b/docs/code-quality/c26407.md @@ -10,7 +10,7 @@ ms.assetid: 5539907a-bfa0-40db-82a6-b860c97209e1 > Prefer scoped objects, don't heap-allocate unnecessarily (r.5) -To avoid unnecessary use of pointers, we try to detect common patterns of local allocations. For example, we detect when the result of a call to operator **`new`** is stored in a local variable and later explicitly deleted. This check supports the [C++ Core Guidelines rule R.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r5-prefer-scoped-objects-dont-heap-allocate-unnecessarily): *Prefer scoped objects, don't heap-allocate unnecessarily*. To fix the issue, use an RAII type instead of a raw pointer, and allow it to deal with resources. Obviously, it isn't necessary to create a wrapper type to allocate a single object. Instead, a local variable of the object's type would work better. +To avoid unnecessary use of pointers, we try to detect common patterns of local allocations. For example, we detect when the result of a call to operator **`new`** is stored in a local variable and later explicitly deleted. This check supports the [C++ Core Guidelines rule R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r5-prefer-scoped-objects-dont-heap-allocate-unnecessarily): *Prefer scoped objects, don't heap-allocate unnecessarily*. To fix the issue, use an RAII type instead of a raw pointer, and allow it to deal with resources. Obviously, it isn't necessary to create a wrapper type to allocate a single object. Instead, a local variable of the object's type would work better. ## Remarks diff --git a/docs/code-quality/c26408.md b/docs/code-quality/c26408.md index 159c8cbfb03..c426b63f2a1 100644 --- a/docs/code-quality/c26408.md +++ b/docs/code-quality/c26408.md @@ -22,7 +22,7 @@ Code analysis name: `NO_MALLOC_FREE` ## See also -[C++ Core Guidelines R.10](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r10-avoid-malloc-and-free) +[C++ Core Guidelines R.10](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r10-avoid-malloc-and-free) ## Example diff --git a/docs/code-quality/c26410.md b/docs/code-quality/c26410.md index ea77c9e0df1..57e0b75a4c7 100644 --- a/docs/code-quality/c26410.md +++ b/docs/code-quality/c26410.md @@ -10,11 +10,11 @@ ms.assetid: d1547faf-96c6-48da-90f5-841154d0e878 > The parameter '*parameter*' is a reference to const unique pointer, use `const T*` or `const T&` instead (r.32) -Generally, references to const unique pointer are meaningless. They can safely be replaced by a raw reference or a pointer. This warning enforces [C++ Core Guidelines rule R.32](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r32-take-a-unique_ptrwidget-parameter-to-express-that-a-function-assumes-ownership-of-a-widget). +Generally, references to const unique pointer are meaningless. They can safely be replaced by a raw reference or a pointer. This warning enforces [C++ Core Guidelines rule R.32](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r32-take-a-unique_ptrwidget-parameter-to-express-that-a-function-assumes-ownership-of-a-widget). ## Remarks -- Unique pointer checks have rather broad criteria to identify smart pointers. The [C++ Core Guidelines rule R.31](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r31-if-you-have-non-std-smart-pointers-follow-the-basic-pattern-from-std): *If you have non-std smart pointers, follow the basic pattern from std describes the unique pointer and shared pointer concepts*. The heuristic is simple, but may lead to surprises: a smart pointer type is any type that defines either `operator->` or `operator*`. A copy-able type (shared pointer) must have either a public copy constructor or an overloaded assignment operator that deals with a non-Rvalue reference parameter. +- Unique pointer checks have rather broad criteria to identify smart pointers. The [C++ Core Guidelines rule R.31](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r31-if-you-have-non-std-smart-pointers-follow-the-basic-pattern-from-std): *If you have non-std smart pointers, follow the basic pattern from std describes the unique pointer and shared pointer concepts*. The heuristic is simple, but may lead to surprises: a smart pointer type is any type that defines either `operator->` or `operator*`. A copy-able type (shared pointer) must have either a public copy constructor or an overloaded assignment operator that deals with a non-Rvalue reference parameter. - Template code may produce noisy warnings. Keep in mind that templates can be instantiated with various type parameters with different levels of indirection, including references. Some warnings may not be obvious and fixes may require some rework of templates (for example, explicit removal of reference indirection). If template code is intentionally generic, the warning can be suppressed. diff --git a/docs/code-quality/c26411.md b/docs/code-quality/c26411.md index d0ff131460a..e4dd8959324 100644 --- a/docs/code-quality/c26411.md +++ b/docs/code-quality/c26411.md @@ -10,7 +10,7 @@ ms.assetid: 5134e51e-8b92-4ee7-94c3-022e318a0e24 > The parameter '*parameter*' is a reference to unique pointer and it is never reassigned or reset, use `T*` or `T&` instead (r.33) -When you pass a unique pointer to a function by reference, it implies that its resource may be released or transferred inside the function. If the function uses its parameter only to access the resource, it's safe to pass a raw pointer or a reference. For more information, see [C++ Core Guidelines rule R.33](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r33-take-a-unique_ptrwidget-parameter-to-express-that-a-function-reseats-thewidget): *Take a unique_ptr\& parameter to express that a function reseats the widget*. +When you pass a unique pointer to a function by reference, it implies that its resource may be released or transferred inside the function. If the function uses its parameter only to access the resource, it's safe to pass a raw pointer or a reference. For more information, see [C++ Core Guidelines rule R.33](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r33-take-a-unique_ptrwidget-parameter-to-express-that-a-function-reseats-thewidget): *Take a unique_ptr\& parameter to express that a function reseats the widget*. ## Remarks diff --git a/docs/code-quality/c26415.md b/docs/code-quality/c26415.md index 8dfc40ae410..5438faa1ebd 100644 --- a/docs/code-quality/c26415.md +++ b/docs/code-quality/c26415.md @@ -11,7 +11,7 @@ ms.assetid: 4165f70a-78ae-4a03-b256-c4bd74b02d09 > Smart pointer parameter is used only to access contained pointer. Use T* or T& instead. **C++ Core Guidelines**: -[R.30](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r30-take-smart-pointers-as-parameters-only-to-explicitly-express-lifetime-semantics): Take smart pointers as parameters only to explicitly express lifetime semantics +[R.30](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r30-take-smart-pointers-as-parameters-only-to-explicitly-express-lifetime-semantics): Take smart pointers as parameters only to explicitly express lifetime semantics Using a smart pointer type to pass data to a function indicates that the target function needs to manage the lifetime of the contained object. However, say the function only uses the smart pointer to access the contained object and never actually calls any code that may lead to its deallocation (that is, never affects its lifetime). Then there's usually no need to complicate the interface with smart pointers. A plain pointer or reference to the contained object is preferred. diff --git a/docs/code-quality/c26416.md b/docs/code-quality/c26416.md index 1bd6192adc2..658adfea026 100644 --- a/docs/code-quality/c26416.md +++ b/docs/code-quality/c26416.md @@ -11,7 +11,7 @@ ms.assetid: f158207b-45cf-44cf-8e4b-b5b75b56ea0e > Shared pointer parameter is passed by rvalue reference. Pass by value instead. **C++ Core Guidelines**: -[R.34](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r34-take-a-shared_ptrwidget-parameter-to-express-that-a-function-is-part-owner): Take a shared_ptr\ parameter to express that a function is part owner +[R.34](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r34-take-a-shared_ptrwidget-parameter-to-express-that-a-function-is-part-owner): Take a shared_ptr\ parameter to express that a function is part owner Passing a shared pointer by rvalue reference is rarely necessary. Unless it's an implementation of move semantics for a shared pointer type itself, shared pointer objects can be safely passed by value. Using rvalue reference may be also an indication that unique pointer is more appropriate since it clearly transfers unique ownership from caller to callee. diff --git a/docs/code-quality/c26417.md b/docs/code-quality/c26417.md index 7659d012506..3ab549beac9 100644 --- a/docs/code-quality/c26417.md +++ b/docs/code-quality/c26417.md @@ -11,7 +11,7 @@ ms.assetid: 0e09fcc6-f9eb-4404-b51e-5815705c6afb > Shared pointer parameter is passed by reference and not reset or reassigned. Use T* or T& instead. **C++ Core Guidelines**: -[R.35](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r35-take-a-shared_ptrwidget-parameter-to-express-that-a-function-might-reseat-the-shared-pointer): Take a shared_ptr\& parameter to express that a function might reseat the shared pointer +[R.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r35-take-a-shared_ptrwidget-parameter-to-express-that-a-function-might-reseat-the-shared-pointer): Take a shared_ptr\& parameter to express that a function might reseat the shared pointer Passing shared pointers by reference may be useful in scenarios where called code updates the target of the smart pointer object, and its caller expects to see such updates. Using a reference solely to reduce costs of passing a shared pointer is questionable. If called code only accesses the target object and never manages its lifetime, it's safer to pass a raw pointer or reference, rather than to expose resource management details. diff --git a/docs/code-quality/c26418.md b/docs/code-quality/c26418.md index d1a07d1b8d4..30c44cf0d11 100644 --- a/docs/code-quality/c26418.md +++ b/docs/code-quality/c26418.md @@ -11,7 +11,7 @@ ms.assetid: d2c84a40-8a5d-4018-92c2-6498cdd9b541 > Shared pointer parameter is not copied or moved. Use T* or T& instead. **C++ Core Guidelines**: -[R.36](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r36-take-a-const-shared_ptrwidget-parameter-to-express-that-it-might-retain-a-reference-count-to-the-object-): Take a const shared_ptr\& parameter to express that it might retain a reference count to the object +[R.36](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r36-take-a-const-shared_ptrwidget-parameter-to-express-that-it-might-retain-a-reference-count-to-the-object-): Take a const shared_ptr\& parameter to express that it might retain a reference count to the object If a shared pointer parameter is passed by value or by reference to a constant object, the function is expected to take control of the target object's lifetime without affecting the caller. The code should either copy or move the shared pointer parameter to another shared pointer object, or pass it along to other code by invoking functions that accept shared pointers. Otherwise, a plain pointer or reference may be feasible. diff --git a/docs/code-quality/c26426.md b/docs/code-quality/c26426.md index 818d76d22de..d889960eee4 100644 --- a/docs/code-quality/c26426.md +++ b/docs/code-quality/c26426.md @@ -12,7 +12,7 @@ ms.assetid: 6fb5f6d2-b097-47f8-8b49-f2fd4e9bef0e ## C++ Core Guidelines -[I.22](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i22-avoid-complex-initialization-of-global-objects): Avoid complex initialization of global objects +[I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i22-avoid-complex-initialization-of-global-objects): Avoid complex initialization of global objects The order of execution of initializers for global objects may be inconsistent or undefined, which can lead to issues that are hard to reproduce and investigate. To avoid such problems, global initializers shouldn't depend on external code that's executed at run time, and that may depend on data that's not yet initialized. This rule flags cases where global objects call functions to obtain their initial values. diff --git a/docs/code-quality/c26427.md b/docs/code-quality/c26427.md index 556e26de751..e71f09e9561 100644 --- a/docs/code-quality/c26427.md +++ b/docs/code-quality/c26427.md @@ -11,7 +11,7 @@ ms.assetid: 8fb95a44-8704-45b1-bc55-eccd59b1db2f > Global initializer accesses extern object '*symbol*' (i.22) **C++ Core Guidelines**: -[I.22](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i22-avoid-complex-initialization-of-global-objects): Avoid complex initialization of global objects +[I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i22-avoid-complex-initialization-of-global-objects): Avoid complex initialization of global objects Global objects may be initialized in an inconsistent or undefined order, which means that interdependency between them is risky and should be avoided. This guideline is applicable when initializers refer to another object that's considered to be **`extern`**. diff --git a/docs/code-quality/c26429.md b/docs/code-quality/c26429.md index 95435952437..96726440aa0 100644 --- a/docs/code-quality/c26429.md +++ b/docs/code-quality/c26429.md @@ -11,7 +11,7 @@ ms.assetid: 4e1c74d5-7307-436c-927b-f74ae863282c > Symbol is never tested for nullness, it can be marked as `gsl::not_null`. **C++ Core Guidelines**: -[F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a `not_null` to indicate that "null" isn't a valid value +[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a `not_null` to indicate that "null" isn't a valid value It's a common practice to use asserts to enforce assumptions about the validity of pointer values. The problem is, asserts don't expose assumptions through the interface (such as in return types or parameters). Asserts are also harder to maintain and keep in sync with other code changes. The recommendation is to use `gsl::not_null` from the Guidelines Support Library to mark resources that should never have a null value. The rule `USE_NOTNULL` helps to identify places that omit checks for null and hence can be updated to use `gsl::not_null`. diff --git a/docs/code-quality/c26430.md b/docs/code-quality/c26430.md index 230352b2e9c..d417983a038 100644 --- a/docs/code-quality/c26430.md +++ b/docs/code-quality/c26430.md @@ -11,7 +11,7 @@ ms.assetid: 3dca2626-8102-4eed-8ff3-73eb3d5c328c > Symbol is not tested for nullness on all paths. **C++ Core Guidelines**: -[F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a not_null\ to indicate that "null" isn't a valid value +[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a not_null\ to indicate that "null" isn't a valid value If code ever checks pointer variables for null, it should do so consistently and validate pointers on all paths. Sometimes overaggressive checking for null is still better than the possibility of a hard crash in one of the complicated branches. Ideally, such code should be refactored to be less complex (by splitting it into multiple functions), and to rely on markers like `gsl::not_null`. These markers allow the code to isolate parts of the algorithm that can make safe assumptions about valid pointer values. The rule `TEST_ON_ALL_PATHS` helps to find places where null checks are inconsistent (meaning assumptions may require review). Or, it finds actual bugs where a potential null value can bypass null checks in some of the code paths. diff --git a/docs/code-quality/c26431.md b/docs/code-quality/c26431.md index 4b78314a6d2..ded200ef169 100644 --- a/docs/code-quality/c26431.md +++ b/docs/code-quality/c26431.md @@ -11,7 +11,7 @@ ms.assetid: 40be6032-c8de-49ab-8e43-e8eedc0ca0ba > The type of expression '*expr*' is already `gsl::not_null`. Do not test it for nullness (f.23) **C++ Core Guidelines**: -[F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a not_null\ to indicate that "null" isn't a valid value +[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a not_null\ to indicate that "null" isn't a valid value The marker type `gsl::not_null` from the Guidelines Support Library is used to clearly indicate values that are never null pointers. It causes a hard failure if the assumption doesn't hold at run time. So, obviously, there's no need to check for null if an expression evaluates to a result of type `gsl::not_null`. diff --git a/docs/code-quality/c26433.md b/docs/code-quality/c26433.md index f78b894e0af..31a482a9743 100644 --- a/docs/code-quality/c26433.md +++ b/docs/code-quality/c26433.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26433"] ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) It's not required by the compiler to clearly state that a virtual function overrides its base. Not specifying `override` can cause subtle issues during maintenance if the virtual specification ever changes in the class hierarchy. It also lowers readability and makes an interface's polymorphic behavior less obvious. If a function is clearly marked as `override`, the compiler can check the consistency of the interface, and help to spot issues before they manifest themselves at run time. @@ -44,4 +44,4 @@ public: ## See also -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) diff --git a/docs/code-quality/c26434.md b/docs/code-quality/c26434.md index 0bdfe9d1731..03e26c7b2f8 100644 --- a/docs/code-quality/c26434.md +++ b/docs/code-quality/c26434.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26434"] ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) ## Remarks diff --git a/docs/code-quality/c26435.md b/docs/code-quality/c26435.md index ab4ec78c93b..ec4fd01356e 100644 --- a/docs/code-quality/c26435.md +++ b/docs/code-quality/c26435.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26435"] ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) To improve readability, the kind of virtual behavior should be stated clearly and without unnecessary redundancy. Even though multiple virtual specifiers can be used simultaneously, it's better to specify one at a time to emphasize the most important aspect of virtual behavior. The following order of importance is apparent: @@ -49,4 +49,4 @@ public: ## See also -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) diff --git a/docs/code-quality/c26436.md b/docs/code-quality/c26436.md index 222d58fb205..ef07743865b 100644 --- a/docs/code-quality/c26436.md +++ b/docs/code-quality/c26436.md @@ -10,7 +10,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines C.35 > The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor (c.35) -[**C++ Core Guidelines**: C.35](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-non-virtual): A base class destructor should be either public and virtual, or protected and nonvirtual +[**C++ Core Guidelines**: C.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-non-virtual): A base class destructor should be either public and virtual, or protected and nonvirtual If a class defines a virtual function it becomes polymorphic, which implies that derived classes can change its behavior including resource management and destruction logic. Because client code may call polymorphic types via pointers to base classes, there's no way a client can explicitly choose which behavior is appropriate without downcasting. To make sure that resources are managed consistently and destruction occurs according to the actual type's rules, you should define a public virtual destructor. If the type hierarchy is designed to disallow client code to destroy objects directly, destructors should be defined as protected non-virtual. diff --git a/docs/code-quality/c26438.md b/docs/code-quality/c26438.md index e6c696ca31d..2317d815139 100644 --- a/docs/code-quality/c26438.md +++ b/docs/code-quality/c26438.md @@ -11,7 +11,7 @@ ms.assetid: c7b3f59c-fb2f-4816-bda4-0fad23c80d83 > Avoid `goto` (es.76) **C++ Core Guidelines**:\ -[ES.76](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es76-avoid-goto): Avoid goto +[ES.76](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es76-avoid-goto): Avoid goto The use of **`goto`** is widely considered a dangerous and error-prone practice. It's acceptable only in generated code, such as in a parser generated from a grammar. With modern C++ features and utilities provided by the Guidelines Support Library, it should be easy to avoid **`goto`** altogether. diff --git a/docs/code-quality/c26440.md b/docs/code-quality/c26440.md index edeb1db827c..bf4207b1f02 100644 --- a/docs/code-quality/c26440.md +++ b/docs/code-quality/c26440.md @@ -10,7 +10,7 @@ description: CppCoreCheck rule C26440 that enforces C++ Core Guidelines F.6 > Function can be declared 'noexcept'. -[**C++ Core Guidelines** F.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept): If your function may not throw, declare it `noexcept` +[**C++ Core Guidelines** F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept): If your function may not throw, declare it `noexcept` If code isn't supposed to cause any exceptions, it should be marked by using the `noexcept` specifier. This annotation helps to simplify error handling on the client code side, and enables the compiler to do more optimizations. diff --git a/docs/code-quality/c26443.md b/docs/code-quality/c26443.md index 090995ebdaf..5b9b55f44b2 100644 --- a/docs/code-quality/c26443.md +++ b/docs/code-quality/c26443.md @@ -13,7 +13,7 @@ This warning was removed in Visual Studio 16.8 to reflect [changes to C.128 in t ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). The current consensus on the Core Guidelines is to exclude destructors from the 'override explicitly' recommendation. @@ -44,4 +44,4 @@ public: ## See also -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) diff --git a/docs/code-quality/c26445.md b/docs/code-quality/c26445.md index 2602c8bfa53..e81beeba280 100644 --- a/docs/code-quality/c26445.md +++ b/docs/code-quality/c26445.md @@ -13,7 +13,7 @@ A reference to `gsl::span` or `std::string_view` may be an indication of a lifet ## C++ Core Guidelines -[GSL.view: Views](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#gslview-views) +[GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#gslview-views) This rule catches subtle lifetime issues that may occur in code migrated from standard containers to new span and view types. Such types can be considered as "references to buffers." Using a reference to a span or view creates an extra layer of indirection. Such indirection is often unnecessary and can be confusing for maintainers. Spans are cheap to copy and can be returned by value from function calls. Obviously, such call results should never be referenced. diff --git a/docs/code-quality/c26446.md b/docs/code-quality/c26446.md index 39091ddfde7..c63bb166bf6 100644 --- a/docs/code-quality/c26446.md +++ b/docs/code-quality/c26446.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26446"] > Prefer to use gsl::at() instead of unchecked subscript operator (bounds.4). -C++ Core Guidelines: [Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile). +C++ Core Guidelines: [Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile). ## Remarks diff --git a/docs/code-quality/c26447.md b/docs/code-quality/c26447.md index 8c4c2ef8202..daf04cf103c 100644 --- a/docs/code-quality/c26447.md +++ b/docs/code-quality/c26447.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["C26447"] > The function is declared `noexcept` but calls function *function_name* that may throw exceptions (f.6). C++ Core Guidelines:\ -[F.6: If your function may not throw, declare it noexcept](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept). +[F.6: If your function may not throw, declare it noexcept](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept). ## Remarks diff --git a/docs/code-quality/c26448.md b/docs/code-quality/c26448.md index 6173ec82b55..3da19b9eca0 100644 --- a/docs/code-quality/c26448.md +++ b/docs/code-quality/c26448.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26448"] > Consider using `gsl::finally` if final action is intended (gsl.util) -C++ Core Guidelines: [GSL.util: Utilities](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-utilities) +C++ Core Guidelines: [GSL.util: Utilities](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-utilities) The Guidelines Support Library provides a convenient utility to implement the *final action* concept. Since the C++ language doesn't support **try-finally** constructs, it became common to implement custom cleanup types that would invoke arbitrary actions on destruction. The `gsl::finally` utility is implemented in this way and provides a more uniform way to perform final actions across a code base. diff --git a/docs/code-quality/c26451.md b/docs/code-quality/c26451.md index 0067e427188..3a2246a977b 100644 --- a/docs/code-quality/c26451.md +++ b/docs/code-quality/c26451.md @@ -49,4 +49,4 @@ void leftshift(int i) noexcept [C26452](c26452.md)\ [C26453](c26453.md)\ [C26454](c26454.md)\ -[ES.103: Don't overflow](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-overflow) +[ES.103: Don't overflow](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-overflow) diff --git a/docs/code-quality/c26456.md b/docs/code-quality/c26456.md index 0abedce51bc..d027fb7be16 100644 --- a/docs/code-quality/c26456.md +++ b/docs/code-quality/c26456.md @@ -21,4 +21,4 @@ Code analysis name: `DONT_HIDE_OPERATORS` ## See also -[C++ Core Guideline c.128](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final) +[C++ Core Guideline c.128](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final) diff --git a/docs/code-quality/c26457.md b/docs/code-quality/c26457.md index e1a5560feb9..45027983705 100644 --- a/docs/code-quality/c26457.md +++ b/docs/code-quality/c26457.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26457"] ## Remarks -Excerpt from the [C++ Core Guideline ES.48](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es48-avoid-casts): +Excerpt from the [C++ Core Guideline ES.48](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es48-avoid-casts): > Never cast to `(void)` to ignore a `[[nodiscard]]` return value. If you deliberately want to discard such a result, first think hard about whether that is really a good idea (there is usually a good reason the author of the function or of the return type used `[[nodiscard]]` in the first place). If you still think it's appropriate and your code reviewer agrees, use `std::ignore =` to turn off the warning which is simple, portable, and easy to grep. diff --git a/docs/code-quality/c26460.md b/docs/code-quality/c26460.md index 2307b0d5928..008786d1a01 100644 --- a/docs/code-quality/c26460.md +++ b/docs/code-quality/c26460.md @@ -39,4 +39,4 @@ void Function2(MyStruct& myStruct) ## See also -[C++ Core Guidelines con.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-ref). +[C++ Core Guidelines con.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-ref). diff --git a/docs/code-quality/c26461.md b/docs/code-quality/c26461.md index 85cd180b56f..eb18934fd4d 100644 --- a/docs/code-quality/c26461.md +++ b/docs/code-quality/c26461.md @@ -45,4 +45,4 @@ void Function2(MyStruct* myStruct) ## See also -[C++ Core Guidelines con.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-ref). +[C++ Core Guidelines con.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-ref). diff --git a/docs/code-quality/c26462.md b/docs/code-quality/c26462.md index f39a230769a..376f8616158 100644 --- a/docs/code-quality/c26462.md +++ b/docs/code-quality/c26462.md @@ -31,4 +31,4 @@ void function1(int* ptr) ## See also -[C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). diff --git a/docs/code-quality/c26463.md b/docs/code-quality/c26463.md index a23cd9d028f..432d73548ef 100644 --- a/docs/code-quality/c26463.md +++ b/docs/code-quality/c26463.md @@ -17,4 +17,4 @@ Code analysis name: `USE_CONST_FOR_ELEMENTS` ## See also -[C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). diff --git a/docs/code-quality/c26464.md b/docs/code-quality/c26464.md index c96634aba1a..f380a3b6548 100644 --- a/docs/code-quality/c26464.md +++ b/docs/code-quality/c26464.md @@ -17,4 +17,4 @@ Code analysis name: `USE_CONST_POINTER_FOR_ELEMENTS` ## See also -[C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). diff --git a/docs/code-quality/c26465.md b/docs/code-quality/c26465.md index d6b7fa8316e..1ca3fee5d14 100644 --- a/docs/code-quality/c26465.md +++ b/docs/code-quality/c26465.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26465 that enforces C++ Core Guidelines Type.3 ## See also -[C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-constcast) +[C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-constcast) ## Example diff --git a/docs/code-quality/c26466.md b/docs/code-quality/c26466.md index 13c4d70db42..786d95159bc 100644 --- a/docs/code-quality/c26466.md +++ b/docs/code-quality/c26466.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines Type.2 ## See also -[C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-downcast) +[C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-downcast) ## Example diff --git a/docs/code-quality/c26471.md b/docs/code-quality/c26471.md index e525394288a..f44d8335af7 100644 --- a/docs/code-quality/c26471.md +++ b/docs/code-quality/c26471.md @@ -29,4 +29,4 @@ void function(void* pValue) ## See also -[C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast) +[C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast) diff --git a/docs/code-quality/c26472.md b/docs/code-quality/c26472.md index 3a18f09f0e8..814fae7c918 100644 --- a/docs/code-quality/c26472.md +++ b/docs/code-quality/c26472.md @@ -11,7 +11,7 @@ ms.assetid: 51e215a7-0e0a-4e6c-bff1-805bf5b1af29 > Don't use a static_cast for arithmetic conversions. Use brace initialization, `gsl::narrow_cast`, or `gsl::narrow`. **C++ Core Guidelines**: -[Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile): Avoid casts +[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile): Avoid casts This rule helps to find places where static casts are used to convert between integral types. These casts are unsafe because the compiler wouldn't warn if any data loss occurs. Brace initializers are better for the cases where constants are used, and a compiler error is desired. There are also utilities from the Guidelines Support Library that help to describe intentions clearly: diff --git a/docs/code-quality/c26473.md b/docs/code-quality/c26473.md index 6ff7913be8b..6cd55d5897b 100644 --- a/docs/code-quality/c26473.md +++ b/docs/code-quality/c26473.md @@ -11,7 +11,7 @@ ms.assetid: d88aaa57-0003-421f-8377-4e6a5c27f2df > Don't cast between pointer types where the source type and the target type are the same. **C++ Core Guidelines**: -[Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile): Avoid casts +[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile): Avoid casts This rule helps to remove unnecessary or suspicious casts. Obviously, when a type is converted to itself, such a conversion is ineffective. Yet the fact that the cast is used may indicate a subtle design issue or a potential for regression if types change in future. It's always safer to use as few casts as possible. diff --git a/docs/code-quality/c26474.md b/docs/code-quality/c26474.md index 30fbf70beff..ca1e9867418 100644 --- a/docs/code-quality/c26474.md +++ b/docs/code-quality/c26474.md @@ -11,7 +11,7 @@ ms.assetid: 1e23a8e6-97fa-47f5-a279-b52aa2efafa4 > Don't cast between pointer types when the conversion could be implicit. **C++ Core Guidelines**:\ -[Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile): Avoid casts +[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile): Avoid casts In some cases, implicit casts between pointer types are safe and don't require you to write a specific cast expression. This rule finds instances of unnecessary casts you can safely remove. diff --git a/docs/code-quality/c26475.md b/docs/code-quality/c26475.md index b3856c661f1..da0daf01af3 100644 --- a/docs/code-quality/c26475.md +++ b/docs/code-quality/c26475.md @@ -11,7 +11,7 @@ ms.assetid: 4ed71cf8-f155-4961-b4fe-77feb3b880c3 > Do not use function style C-casts. **C++ Core Guidelines**: -[ES.49](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es49-if-you-must-use-a-cast-use-a-named-cast): If you must use a cast, use a named cast +[ES.49](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es49-if-you-must-use-a-cast-use-a-named-cast): If you must use a cast, use a named cast Function-style casts (for example, `int(1.1)`) are another form of C-style casts (like `(int)1.1`), which have questionable safety. Specifically, the compiler doesn't try to check if any data loss can occur either in C-casts or in function casts. In both cases, it's better either to avoid casting or to use a braced initializer if possible. If neither works, static casts may be suitable, but it's still better to use utilities from the Guidelines Support Library: diff --git a/docs/code-quality/c26476.md b/docs/code-quality/c26476.md index d942009432a..b07cb80eeab 100644 --- a/docs/code-quality/c26476.md +++ b/docs/code-quality/c26476.md @@ -21,4 +21,4 @@ Code analysis name: `USE_VARIANT` ## See also -[C++ Core Guideline C.181](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ru-naked) +[C++ Core Guideline C.181](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ru-naked) diff --git a/docs/code-quality/c26477.md b/docs/code-quality/c26477.md index fe713f5618e..7da0611abfa 100644 --- a/docs/code-quality/c26477.md +++ b/docs/code-quality/c26477.md @@ -21,4 +21,4 @@ Code analysis name: `USE_NULLPTR_NOT_CONSTANT` ## See also -[C++ Core Guideline ES.47](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-nullptr) +[C++ Core Guideline ES.47](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-nullptr) diff --git a/docs/code-quality/c26481.md b/docs/code-quality/c26481.md index 051b2c96ee5..31249a98f10 100644 --- a/docs/code-quality/c26481.md +++ b/docs/code-quality/c26481.md @@ -12,11 +12,11 @@ ms.assetid: 4fd8694d-b45b-4163-b2d5-88c4889d00ed ## Remarks -This check supports the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) rule [I.13](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ri-array): *Do not pass an array as a single pointer*. Whenever raw pointers are used in arithmetic operations they should be replaced with safer kinds of buffers, such as `span` or `vector`. +This check supports the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) rule [I.13](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-array): *Do not pass an array as a single pointer*. Whenever raw pointers are used in arithmetic operations they should be replaced with safer kinds of buffers, such as `span` or `vector`. This check is more restrictive than I.13: it doesn't skip `zstring` or `czstring` types. -C26481 and [C26485](c26485.md) come from the [Bounds Safety Profile](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) rules. These rules were implemented in the first release of the C++ Core Guidelines Checker. They're applicable to the raw pointers category since they help to avoid unsafe use of raw pointers. +C26481 and [C26485](c26485.md) come from the [Bounds Safety Profile](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) rules. These rules were implemented in the first release of the C++ Core Guidelines Checker. They're applicable to the raw pointers category since they help to avoid unsafe use of raw pointers. ## Example diff --git a/docs/code-quality/c26482.md b/docs/code-quality/c26482.md index e360a51d10e..5f278d80082 100644 --- a/docs/code-quality/c26482.md +++ b/docs/code-quality/c26482.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26482 that enforces C++ Core Guidelines Bounds.2 ## See also -[C++ Core Guidelines Bounds.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +[C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) ## Example diff --git a/docs/code-quality/c26483.md b/docs/code-quality/c26483.md index 5e031b24488..73a447ebd4b 100644 --- a/docs/code-quality/c26483.md +++ b/docs/code-quality/c26483.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26483"] ## See also -[C++ Core Guidelines Bounds.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +[C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) ## Example diff --git a/docs/code-quality/c26485.md b/docs/code-quality/c26485.md index e0aa010236d..ef77b057905 100644 --- a/docs/code-quality/c26485.md +++ b/docs/code-quality/c26485.md @@ -12,9 +12,9 @@ ms.assetid: 8915ad2d-7fd6-4bbc-abe4-0b3292ea2170 ## Remarks -Like [C26481](c26481.md), this check helps to enforce the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) rule [I.13](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ri-array): *Do not pass an array as a single pointer*. The rule detects places where static array type information is lost from decay to a raw pointer. The `zstring` and `czstring` types aren't excluded. +Like [C26481](c26481.md), this check helps to enforce the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) rule [I.13](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-array): *Do not pass an array as a single pointer*. The rule detects places where static array type information is lost from decay to a raw pointer. The `zstring` and `czstring` types aren't excluded. -C26481 and C26485 come from the [Bounds Safety Profile](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) rules. These rules were implemented in the first release of the C++ Core Guidelines Checker. They're applicable to the raw pointers category since they help to avoid unsafe use of raw pointers. +C26481 and C26485 come from the [Bounds Safety Profile](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) rules. These rules were implemented in the first release of the C++ Core Guidelines Checker. They're applicable to the raw pointers category since they help to avoid unsafe use of raw pointers. ## Example diff --git a/docs/code-quality/c26490.md b/docs/code-quality/c26490.md index 48e766138e9..0a74626fc4a 100644 --- a/docs/code-quality/c26490.md +++ b/docs/code-quality/c26490.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26490 that enforces C++ Core Guidelines Type.1 ## See also -[C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +[C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). ## Example diff --git a/docs/code-quality/c26491.md b/docs/code-quality/c26491.md index b55c5b0f320..760762e2bf4 100644 --- a/docs/code-quality/c26491.md +++ b/docs/code-quality/c26491.md @@ -7,4 +7,4 @@ helpviewer_keywords: ["C26491"] --- # Warning C26491 -> Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +> Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). diff --git a/docs/code-quality/c26492.md b/docs/code-quality/c26492.md index 2e6ede538f2..f59114cba8f 100644 --- a/docs/code-quality/c26492.md +++ b/docs/code-quality/c26492.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26492 that enforces C++ Core Guidelines Type.3 ## See also -[C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +[C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). ## Example diff --git a/docs/code-quality/c26493.md b/docs/code-quality/c26493.md index 34d7225070b..8f93b4f4975 100644 --- a/docs/code-quality/c26493.md +++ b/docs/code-quality/c26493.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines Type.4 ## See also -[C++ Core Guidelines Type.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +[C++ Core Guidelines Type.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). ## Example diff --git a/docs/code-quality/c26495.md b/docs/code-quality/c26495.md index f99e5697b84..e318171fe73 100644 --- a/docs/code-quality/c26495.md +++ b/docs/code-quality/c26495.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26495"] ## Remarks -A member variable isn't initialized by a constructor or by an initializer. Make sure all variables are initialized by the end of construction. For more information, see C++ Core Guidelines [Type.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type) and [C.48](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c48-prefer-in-class-initializers-to-member-initializers-in-constructors-for-constant-initializers). +A member variable isn't initialized by a constructor or by an initializer. Make sure all variables are initialized by the end of construction. For more information, see C++ Core Guidelines [Type.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type) and [C.48](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c48-prefer-in-class-initializers-to-member-initializers-in-constructors-for-constant-initializers). This check is intra-procedural. Whenever there's a function call to a nonconst member function, the check assumes that this member function initializes all of the members. This heuristic can result in missed errors and is in place to avoid false positive results. Moreover, when a member is passed by nonconst reference to a function, the check assumes that the function initializes the member. diff --git a/docs/code-quality/c26496.md b/docs/code-quality/c26496.md index b5ad5763283..91c0d1f88b0 100644 --- a/docs/code-quality/c26496.md +++ b/docs/code-quality/c26496.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26496 that enforces C++ Core Guidelines Con.4 ## See also -[C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). ## Example diff --git a/docs/code-quality/c26497.md b/docs/code-quality/c26497.md index 7a7cd3fc6cc..36b52d3bfea 100644 --- a/docs/code-quality/c26497.md +++ b/docs/code-quality/c26497.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines F.4 ## See also -[C++ Core Guidelines F.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rf-constexpr). +[C++ Core Guidelines F.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-constexpr). ## Example diff --git a/docs/code-quality/c26812.md b/docs/code-quality/c26812.md index f5b54e10863..434ffe7fb3e 100644 --- a/docs/code-quality/c26812.md +++ b/docs/code-quality/c26812.md @@ -47,4 +47,4 @@ Print_color(Product_info::Red); // Error: cannot convert Product_info to int. ## See also -[Enum.3 Prefer enum class over enum](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#enum3-prefer-class-enums-over-plain-enums) +[Enum.3 Prefer enum class over enum](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#enum3-prefer-class-enums-over-plain-enums) diff --git a/docs/code-quality/c26814.md b/docs/code-quality/c26814.md index 0727406c7da..f446f2644b0 100644 --- a/docs/code-quality/c26814.md +++ b/docs/code-quality/c26814.md @@ -33,4 +33,4 @@ void bar() ## See also -[Con.5 Use constexpr for all variables that can be computed at compile time](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-constexpr) +[Con.5 Use constexpr for all variables that can be computed at compile time](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr) diff --git a/docs/code-quality/c26818.md b/docs/code-quality/c26818.md index aed557b6adf..db6965b1050 100644 --- a/docs/code-quality/c26818.md +++ b/docs/code-quality/c26818.md @@ -14,7 +14,7 @@ no-loc: [ default, int, char ] This check covers the missing **`default`** label in switch statements that switch over a non-enumeration type, such as **`int`**, **`char`**, and so on. -For more information, see [ES.79: Use default to handle common cases (only)](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es79-use-default-to-handle-common-cases-only) in the C++ Core Guidelines. +For more information, see [ES.79: Use default to handle common cases (only)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es79-use-default-to-handle-common-cases-only) in the C++ Core Guidelines. ## Example diff --git a/docs/code-quality/code-analysis-for-c-cpp-overview.md b/docs/code-quality/code-analysis-for-c-cpp-overview.md index 2bde55b76a3..33c4a8e91e1 100644 --- a/docs/code-quality/code-analysis-for-c-cpp-overview.md +++ b/docs/code-quality/code-analysis-for-c-cpp-overview.md @@ -20,7 +20,7 @@ ms.assetid: 81f0c9e8-f471-4de5-aac4-99db336a8809 --- # Code analysis for C/C++ overview -The C/C++ Code Analysis tool provides information about possible defects in your C/C++ source code. Common coding errors reported by the tool include buffer overruns, uninitialized memory, null pointer dereferences, and memory and resource leaks. The tool can also run checks against the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +The C/C++ Code Analysis tool provides information about possible defects in your C/C++ source code. Common coding errors reported by the tool include buffer overruns, uninitialized memory, null pointer dereferences, and memory and resource leaks. The tool can also run checks against the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). ## IDE (integrated development environment) integration diff --git a/docs/code-quality/code-analysis-for-cpp-corecheck.md b/docs/code-quality/code-analysis-for-cpp-corecheck.md index ecae8ba0d0f..63877154bae 100644 --- a/docs/code-quality/code-analysis-for-cpp-corecheck.md +++ b/docs/code-quality/code-analysis-for-cpp-corecheck.md @@ -17,250 +17,250 @@ This section lists C++ Core Guidelines Checker warnings. For information about C ## OWNER_POINTER Group [C26402 DONT_HEAP_ALLOCATE_MOVABLE_RESULT](C26402.md)\ -Return a scoped object instead of a heap-allocated if it has a move constructor. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Return a scoped object instead of a heap-allocated if it has a move constructor. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26403 RESET_OR_DELETE_OWNER](C26403.md)\ -Reset or explicitly delete an owner\ pointer '*variable*'. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Reset or explicitly delete an owner\ pointer '*variable*'. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26404 DONT_DELETE_INVALID](C26404.md)\ -Do not delete an owner\ that may be in invalid state. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Do not delete an owner\ that may be in invalid state. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26405 DONT_ASSIGN_TO_VALID](C26405.md)\ -Do not assign to an owner\ that may be in valid state. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Do not assign to an owner\ that may be in valid state. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26406 DONT_ASSIGN_RAW_TO_OWNER](C26406.md)\ -Do not assign a raw pointer to an owner\. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Do not assign a raw pointer to an owner\. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26407 DONT_HEAP_ALLOCATE_UNNECESSARILY](C26407.md)\ -Prefer scoped objects, don't heap-allocate unnecessarily. See [C++ Core Guidelines R.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-scoped). +Prefer scoped objects, don't heap-allocate unnecessarily. See [C++ Core Guidelines R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped). [C26429 USE_NOTNULL](C26429.md)\ -Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). [C26430 TEST_ON_ALL_PATHS](C26430.md)\ -Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). [C26431 DONT_TEST_NOTNULL](C26431.md)\ -The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). ## RAW_POINTER Group [C26400 NO_RAW_POINTER_ASSIGNMENT](c26400.md)\ -Do not assign the result of an allocation or a function call with an owner\ return value to a raw pointer; use owner\ instead. See [C++ Core Guidelines I.11](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ri-raw). +Do not assign the result of an allocation or a function call with an owner\ return value to a raw pointer; use owner\ instead. See [C++ Core Guidelines I.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-raw). [C26401 DONT_DELETE_NON_OWNER](c26401.md)\ -Do not delete a raw pointer that is not an owner\. See [C++ Core Guidelines I.11](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ri-raw). +Do not delete a raw pointer that is not an owner\. See [C++ Core Guidelines I.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-raw). [C26402 DONT_HEAP_ALLOCATE_MOVABLE_RESULT](C26402.md)\ -Return a scoped object instead of a heap-allocated if it has a move constructor. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Return a scoped object instead of a heap-allocated if it has a move constructor. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26408 NO_MALLOC_FREE](C26408.md)\ -Avoid malloc() and free(), prefer the nothrow version of new with delete. See [C++ Core Guidelines R.10](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-mallocfree). +Avoid malloc() and free(), prefer the nothrow version of new with delete. See [C++ Core Guidelines R.10](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-mallocfree). [C26409 NO_NEW_DELETE](C26409.md)\ -Avoid calling new and delete explicitly, use std::make_unique\ instead. See [C++ Core Guidelines R.11](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-newdelete). +Avoid calling new and delete explicitly, use std::make_unique\ instead. See [C++ Core Guidelines R.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-newdelete). [C26429 USE_NOTNULL](C26429.md)\ -Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). [C26430 TEST_ON_ALL_PATHS](C26430.md)\ -Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). [C26431 DONT_TEST_NOTNULL](C26431.md)\ -The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). [C26481 NO_POINTER_ARITHMETIC](C26481.md)\ -Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds). +Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds). [C26485 NO_ARRAY_TO_POINTER_DECAY](C26485.md)\ -Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds). +Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds). ## UNIQUE_POINTER Group [C26410 NO_REF_TO_CONST_UNIQUE_PTR](C26410.md)\ -The parameter '*parameter*' is a reference to `const` unique pointer, use const T* or const T& instead. See [C++ Core Guidelines R.32](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-uniqueptrparam). +The parameter '*parameter*' is a reference to `const` unique pointer, use const T* or const T& instead. See [C++ Core Guidelines R.32](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-uniqueptrparam). [C26411 NO_REF_TO_UNIQUE_PTR](C26411.md)\ -The parameter '*parameter*' is a reference to unique pointer and it is never reassigned or reset, use T* or T& instead. See [C++ Core Guidelines R.33](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-reseat). +The parameter '*parameter*' is a reference to unique pointer and it is never reassigned or reset, use T* or T& instead. See [C++ Core Guidelines R.33](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-reseat). [C26414 RESET_LOCAL_SMART_PTR](C26414.md)\ -Move, copy, reassign, or reset a local smart pointer '*symbol*'. See [C++ Core Guidelines R.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-scoped). +Move, copy, reassign, or reset a local smart pointer '*symbol*'. See [C++ Core Guidelines R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped). [C26415 SMART_PTR_NOT_NEEDED](C26415.md)\ -Smart pointer parameter '*symbol*' is used only to access contained pointer. Use T* or T& instead. See [C++ Core Guidelines R.30](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-smartptrparam). +Smart pointer parameter '*symbol*' is used only to access contained pointer. Use T* or T& instead. See [C++ Core Guidelines R.30](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-smartptrparam). ## SHARED_POINTER Group [C26414 RESET_LOCAL_SMART_PTR](C26414.md)\ -Move, copy, reassign, or reset a local smart pointer '*symbol*'. See [C++ Core Guidelines R.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-scoped). +Move, copy, reassign, or reset a local smart pointer '*symbol*'. See [C++ Core Guidelines R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped). [C26415 SMART_PTR_NOT_NEEDED](C26415.md)\ -Smart pointer parameter '*symbol*' is used only to access contained pointer. Use T* or T& instead. See [C++ Core Guidelines R.30](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-smartptrparam). +Smart pointer parameter '*symbol*' is used only to access contained pointer. Use T* or T& instead. See [C++ Core Guidelines R.30](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-smartptrparam). [C26416 NO_RVALUE_REF_SHARED_PTR](C26416.md)\ -Shared pointer parameter '*symbol*' is passed by rvalue reference. Pass by value instead. See [C++ Core Guidelines R.34](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-sharedptrparam-owner). +Shared pointer parameter '*symbol*' is passed by rvalue reference. Pass by value instead. See [C++ Core Guidelines R.34](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam-owner). [C26417 NO_LVALUE_REF_SHARED_PTR](C26417.md)\ -Shared pointer parameter '*symbol*' is passed by reference and not reset or reassigned. Use T* or T& instead. See [C++ Core Guidelines R.35](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-sharedptrparam). +Shared pointer parameter '*symbol*' is passed by reference and not reset or reassigned. Use T* or T& instead. See [C++ Core Guidelines R.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam). [C26418 NO_VALUE_OR_CONST_REF_SHARED_PTR](C26418.md)\ -Shared pointer parameter '*symbol*' is not copied or moved. Use T* or T& instead. See [C++ Core Guidelines R.36](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-sharedptrparam-const). +Shared pointer parameter '*symbol*' is not copied or moved. Use T* or T& instead. See [C++ Core Guidelines R.36](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam-const). ## DECLARATION Group [C26426 NO_GLOBAL_INIT_CALLS](C26426.md)\ -Global initializer calls a non-constexpr function '*symbol*'. See [C++ Core Guidelines I.22](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i22-avoid-complex-initialization-of-global-objects). +Global initializer calls a non-constexpr function '*symbol*'. See [C++ Core Guidelines I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i22-avoid-complex-initialization-of-global-objects). [C26427 NO_GLOBAL_INIT_EXTERNS](C26427.md)\ -Global initializer accesses extern object '*symbol*'. See [C++ Core Guidelines I.22](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i22-avoid-complex-initialization-of-global-objects). +Global initializer accesses extern object '*symbol*'. See [C++ Core Guidelines I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i22-avoid-complex-initialization-of-global-objects). [C26444 NO_UNNAMED_RAII_OBJECTS](c26444.md)\ -Avoid unnamed objects with custom construction and destruction. See [ES.84: Don't (try to) declare a local variable with no name](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +Avoid unnamed objects with custom construction and destruction. See [ES.84: Don't (try to) declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). ## CLASS Group [C26432 DEFINE_OR_DELETE_SPECIAL_OPS](C26432.md)\ -If you define or delete any default operation in the type '*symbol*', define or delete them all. See [C++ Core Guidelines C.21](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c21-if-you-define-or-delete-any-default-operation-define-or-delete-them-all). +If you define or delete any default operation in the type '*symbol*', define or delete them all. See [C++ Core Guidelines C.21](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c21-if-you-define-or-delete-any-default-operation-define-or-delete-them-all). [C26433 OVERRIDE_EXPLICITLY](c26433.md)\ -Function '*symbol*' should be marked with 'override'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final). +Function '*symbol*' should be marked with 'override'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final). [C26434 DONT_HIDE_METHODS](C26434.md)\ -Function '*symbol_1*' hides a non-virtual function '*symbol_2*'. See [C++ Core Guidelines C.128](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final). +Function '*symbol_1*' hides a non-virtual function '*symbol_2*'. See [C++ Core Guidelines C.128](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final). [C26435 SINGLE_VIRTUAL_SPECIFICATION](c26435.md)\ -Function '*symbol*' should specify exactly one of 'virtual', 'override', or 'final'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +Function '*symbol*' should specify exactly one of 'virtual', 'override', or 'final'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). [C26436 NEED_VIRTUAL_DTOR](C26436.md)\ -The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor. See [C++ Core Guidelines C.35](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-nonvirtual). +The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor. See [C++ Core Guidelines C.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-nonvirtual). [C26443 NO_EXPLICIT_DTOR_OVERRIDE](c26443.md)\ -Overriding destructor should not use explicit 'override' or 'virtual' specifiers. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +Overriding destructor should not use explicit 'override' or 'virtual' specifiers. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). ## STYLE Group [C26438 NO_GOTO](C26438.md)\ -Avoid `goto`. See [C++ Core Guidelines ES.76](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es76-avoid-goto). +Avoid `goto`. See [C++ Core Guidelines ES.76](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es76-avoid-goto). ## FUNCTION Group [C26439 SPECIAL_NOEXCEPT](C26439.md)\ -This kind of function may not throw. Declare it **`noexcept`**. See [C++ Core Guidelines F.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept). +This kind of function may not throw. Declare it **`noexcept`**. See [C++ Core Guidelines F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept). [C26440 DECLARE_NOEXCEPT](C26440.md)\ -Function '*symbol*' can be declared **`noexcept`**. See [C++ Core Guidelines F.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept). +Function '*symbol*' can be declared **`noexcept`**. See [C++ Core Guidelines F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept). [C26447 DONT_THROW_IN_NOEXCEPT](c26447.md)\ The function is declared **`noexcept`** but calls a function which may throw exceptions. -See [C++ Core Guidelines: F.6: If your function may not throw, declare it noexcept](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept). +See [C++ Core Guidelines: F.6: If your function may not throw, declare it noexcept](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept). ## CONCURRENCY Group [C26441 NO_UNNAMED_GUARDS](C26441.md)\ -Guard objects must be named. See [C++ Core Guidelines cp.44](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#cp44-remember-to-name-your-lock_guards-and-unique_locks). +Guard objects must be named. See [C++ Core Guidelines cp.44](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#cp44-remember-to-name-your-lock_guards-and-unique_locks). ## CONST Group [C26460 USE_CONST_REFERENCE_ARGUMENTS](c26460.md)\ -The reference argument '*argument*' for function '*function*' can be marked as `const`. See [C++ Core Guidelines con.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-ref). +The reference argument '*argument*' for function '*function*' can be marked as `const`. See [C++ Core Guidelines con.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-ref). [C26461 USE_CONST_POINTER_ARGUMENTS](c26461.md):\ -The pointer argument '*argument*' for function '*function*' can be marked as a pointer to `const`. See [C++ Core Guidelines con.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-ref). +The pointer argument '*argument*' for function '*function*' can be marked as a pointer to `const`. See [C++ Core Guidelines con.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-ref). [C26462 USE_CONST_POINTER_FOR_VARIABLE](c26462.md)\ -The value pointed to by '*variable*' is assigned only once, mark it as a pointer to `const`. See [C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The value pointed to by '*variable*' is assigned only once, mark it as a pointer to `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). [C26463 USE_CONST_FOR_ELEMENTS](c26463.md)\ -The elements of array '*array*' are assigned only once, mark elements `const`. See [C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The elements of array '*array*' are assigned only once, mark elements `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). [C26464 USE_CONST_POINTER_FOR_ELEMENTS](c26464.md)\ -The values pointed to by elements of array '*array*' are assigned only once, mark elements as pointer to `const`. See [C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The values pointed to by elements of array '*array*' are assigned only once, mark elements as pointer to `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). [C26496 USE_CONST_FOR_VARIABLE](c26496.md)\ -The variable '*variable*' is assigned only once, mark it as `const`. See [C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The variable '*variable*' is assigned only once, mark it as `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). [C26497 USE_CONSTEXPR_FOR_FUNCTION](c26497.md)\ -This function *function* could be marked `constexpr` if compile-time evaluation is desired. See [C++ Core Guidelines F.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rf-constexpr). +This function *function* could be marked `constexpr` if compile-time evaluation is desired. See [C++ Core Guidelines F.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-constexpr). [C26498 USE_CONSTEXPR_FOR_FUNCTIONCALL](c26498.md)\ -This function call *function* can use `constexpr` if compile-time evaluation is desired. See [C++ Core Guidelines con.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-constexpr). +This function call *function* can use `constexpr` if compile-time evaluation is desired. See [C++ Core Guidelines con.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr). ## TYPE Group [C26437 DONT_SLICE](C26437.md)\ -Do not slice. See [C++ Core Guidelines ES.63](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es63-dont-slice). +Do not slice. See [C++ Core Guidelines ES.63](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es63-dont-slice). [C26465 NO_CONST_CAST_UNNECESSARY](c26465.md)\ -Don't use `const_cast` to cast away `const`. `const_cast` is not required; constness or volatility is not being removed by this conversion. See [C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-constcast). +Don't use `const_cast` to cast away `const`. `const_cast` is not required; constness or volatility is not being removed by this conversion. See [C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-constcast). [C26466 NO_STATIC_DOWNCAST_POLYMORPHIC](c26466.md)\ -Don't use `static_cast` downcasts. A cast from a polymorphic type should use dynamic_cast. See [C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-downcast). +Don't use `static_cast` downcasts. A cast from a polymorphic type should use dynamic_cast. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-downcast). [C26471 NO_REINTERPRET_CAST_FROM_VOID_PTR](c26471.md)\ -Don't use `reinterpret_cast`. A cast from void* can use `static_cast`. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast). +Don't use `reinterpret_cast`. A cast from void* can use `static_cast`. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). [C26472 NO_CASTS_FOR_ARITHMETIC_CONVERSION](C26472.md)\ -Don't use a `static_cast` for arithmetic conversions. Use brace initialization, gsl::narrow_cast, or gsl::narrow. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast). +Don't use a `static_cast` for arithmetic conversions. Use brace initialization, gsl::narrow_cast, or gsl::narrow. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). [C26473 NO_IDENTITY_CAST](C26473.md)\ -Don't cast between pointer types where the source type and the target type are the same. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast). +Don't cast between pointer types where the source type and the target type are the same. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). [C26474 NO_IMPLICIT_CAST](C26474.md)\ -Don't cast between pointer types when the conversion could be implicit. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast). +Don't cast between pointer types when the conversion could be implicit. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). [C26475 NO_FUNCTION_STYLE_CASTS](C26475.md)\ -Do not use function style C-casts. See [C++ Core Guidelines ES.49](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es49-if-you-must-use-a-cast-use-a-named-cast). +Do not use function style C-casts. See [C++ Core Guidelines ES.49](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es49-if-you-must-use-a-cast-use-a-named-cast). [C26490 NO_REINTERPRET_CAST](c26490.md)\ -Don't use `reinterpret_cast`. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Don't use `reinterpret_cast`. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). [C26491 NO_STATIC_DOWNCAST](c26490.md)\ -Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). [C26492 NO_CONST_CAST](c26492.md)\ -Don't use `const_cast` to cast away `const`. See [C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Don't use `const_cast` to cast away `const`. See [C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). [C26493 NO_CSTYLE_CAST](c26493.md)\ -Don't use C-style casts. See [C++ Core Guidelines Type.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Don't use C-style casts. See [C++ Core Guidelines Type.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). [C26494 VAR_USE_BEFORE_INIT](c26494.md)\ -Variable '*variable*' is uninitialized. Always initialize an object. See [C++ Core Guidelines Type.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Variable '*variable*' is uninitialized. Always initialize an object. See [C++ Core Guidelines Type.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). [C26495 MEMBER_UNINIT](c26495.md)\ -Variable '*variable*' is uninitialized. Always initialize a member variable. See [C++ Core Guidelines Type.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Variable '*variable*' is uninitialized. Always initialize a member variable. See [C++ Core Guidelines Type.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). ## BOUNDS Group [C26446 USE_GSL_AT](c26446.md)\ -Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile). +Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile). [C26481 NO_POINTER_ARITHMETIC](C26481.md)\ -Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) [C26482 NO_DYNAMIC_ARRAY_INDEXING](c26482.md)\ -Only index into arrays using constant expressions. See [C++ Core Guidelines Bounds.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +Only index into arrays using constant expressions. See [C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) [C26483 STATIC_INDEX_OUT_OF_RANGE](c26483.md)\ -Value *value* is outside the bounds (0, *bound*) of variable '*variable*'. Only index into arrays using constant expressions that are within bounds of the array. See [C++ Core Guidelines Bounds.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +Value *value* is outside the bounds (0, *bound*) of variable '*variable*'. Only index into arrays using constant expressions that are within bounds of the array. See [C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) [C26485 NO_ARRAY_TO_POINTER_DECAY](C26485.md)\ -Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) ## GSL Group [C26445 NO_SPAN_REF](c26445.md)\ A reference to `gsl::span` or `std::string_view` may be an indication of a lifetime issue. -See [C++ Core Guidelines GSL.view: Views](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#gslview-views) +See [C++ Core Guidelines GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#gslview-views) [C26446 USE_GSL_AT](c26446.md)\ -Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile). +Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile). [C26448 USE_GSL_FINALLY](c26448.md)\ -Consider using `gsl::finally` if final action is intended. See [C++ Core Guidelines: GSL.util: Utilities](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-utilities). +Consider using `gsl::finally` if final action is intended. See [C++ Core Guidelines: GSL.util: Utilities](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-utilities). [C26449 NO_SPAN_FROM_TEMPORARY](c26449.md)\ `gsl::span` or `std::string_view` created from a temporary will be invalid when the temporary is invalidated. See -[C++ Core Guidelines: GSL.view: Views](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#gslview-views). +[C++ Core Guidelines: GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#gslview-views). ## Deprecated Warnings diff --git a/docs/code-quality/quick-start-code-analysis-for-c-cpp.md b/docs/code-quality/quick-start-code-analysis-for-c-cpp.md index 39c416ac326..7c2a7c05f31 100644 --- a/docs/code-quality/quick-start-code-analysis-for-c-cpp.md +++ b/docs/code-quality/quick-start-code-analysis-for-c-cpp.md @@ -27,25 +27,25 @@ Visual Studio includes these standard sets of rules for native code: | Rule Set | Description | |--|--| -| **C++ Core Check Arithmetic Rules** | These rules enforce checks related to [arithmetic operations from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es-expressions-and-statements). | -| **C++ Core Check Bounds Rules** | These rules enforce the [Bounds profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile). | -| **C++ Core Check Class Rules** | These rules enforce checks related to [classes from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c-classes-and-class-hierarchies). | -| **C++ Core Check Concurrency Rules** | These rules enforce checks related to [concurrency from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#cpcon-concurrency). | -| **C++ Core Check Const Rules** | These rules enforce [const-related checks from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con-constants-and-immutability). | -| **C++ Core Check Declaration Rules** | These rules enforce checks related to [declarations from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i-interfaces). | -| **C++ Core Check Enum Rules** | These rules enforce [enum-related checks from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-enum). | +| **C++ Core Check Arithmetic Rules** | These rules enforce checks related to [arithmetic operations from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es-expressions-and-statements). | +| **C++ Core Check Bounds Rules** | These rules enforce the [Bounds profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile). | +| **C++ Core Check Class Rules** | These rules enforce checks related to [classes from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c-classes-and-class-hierarchies). | +| **C++ Core Check Concurrency Rules** | These rules enforce checks related to [concurrency from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#cpcon-concurrency). | +| **C++ Core Check Const Rules** | These rules enforce [const-related checks from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con-constants-and-immutability). | +| **C++ Core Check Declaration Rules** | These rules enforce checks related to [declarations from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i-interfaces). | +| **C++ Core Check Enum Rules** | These rules enforce [enum-related checks from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-enum). | | **C++ Core Check Experimental Rules** | These rules collect some experimental checks. Eventually, we expect these checks to be moved to other rulesets or removed completely. | -| **C++ Core Check Function Rules** | These rules enforce checks related to [functions from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f-functions). | -| **C++ Core Check GSL Rules** | These rules enforce checks related to the [Guidelines Support Library from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-gsl). | -| **C++ Core Check Lifetime Rules** | These rules enforce the [Lifetime profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prolifetime-lifetime-safety-profile). | -| **C++ Core Check Owner Pointer Rules** | These rules enforce resource-management checks related to [`owner` from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). | -| **C++ Core Check Raw Pointer Rules** | These rules enforce resource-management checks related to [raw pointers from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). | -| **C++ Core Check Rules** | These rules enforce a subset of the checks from the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c-core-guidelines). Use this ruleset to include all of the C++ Core Check rules except the Enum and Experimental rulesets. | -| **C++ Core Check Shared Pointer Rules** | These rules enforce resource-management checks related to [types with shared pointer semantics from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). | -| **C++ Core Check STL Rules** | These rules enforce checks related to the [C++ Standard Library from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-stdlib). | -| **C++ Core Check Style Rules** | These rules enforce checks related to use of [expressions and statements from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es-expressions-and-statements). | -| **C++ Core Check Type Rules** | These rules enforce the [Type profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile). | -| **C++ Core Check Unique Pointer Rules** | These rules enforce resource-management checks related to types with [unique pointer semantics from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). | +| **C++ Core Check Function Rules** | These rules enforce checks related to [functions from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f-functions). | +| **C++ Core Check GSL Rules** | These rules enforce checks related to the [Guidelines Support Library from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-gsl). | +| **C++ Core Check Lifetime Rules** | These rules enforce the [Lifetime profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prolifetime-lifetime-safety-profile). | +| **C++ Core Check Owner Pointer Rules** | These rules enforce resource-management checks related to [`owner` from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). | +| **C++ Core Check Raw Pointer Rules** | These rules enforce resource-management checks related to [raw pointers from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). | +| **C++ Core Check Rules** | These rules enforce a subset of the checks from the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c-core-guidelines). Use this ruleset to include all of the C++ Core Check rules except the Enum and Experimental rulesets. | +| **C++ Core Check Shared Pointer Rules** | These rules enforce resource-management checks related to [types with shared pointer semantics from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). | +| **C++ Core Check STL Rules** | These rules enforce checks related to the [C++ Standard Library from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-stdlib). | +| **C++ Core Check Style Rules** | These rules enforce checks related to use of [expressions and statements from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es-expressions-and-statements). | +| **C++ Core Check Type Rules** | These rules enforce the [Type profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile). | +| **C++ Core Check Unique Pointer Rules** | These rules enforce resource-management checks related to types with [unique pointer semantics from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). | | **Concurrency Check Rules** | These rules enforce a set of Win32 concurrency pattern checks in C++. | | **Concurrency Rules** | Adds concurrency rules from C++ Core Guidelines to **Concurrency Check Rules**. | | **Microsoft Native Minimum Rules** | These rules focus on the most critical problems in your native code, including potential security holes and application crashes. We recommend you include this rule set in any custom rule set you create for your native projects. | diff --git a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md index 5b242bc21fa..0010cfda987 100644 --- a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md +++ b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md @@ -111,43 +111,43 @@ The C++ Core Guidelines are there to help you write better and safer code. Howev As new rules are added to the C++ Core Guidelines Checker, the number of warnings that are produced for pre-existing code might increase. You can use predefined rule sets to filter which kinds of rules to enable. You'll find reference articles for most rules under [Visual Studio C++ Core Check Reference](code-analysis-for-cpp-corecheck.md). -- **Arithmetic Rules**: Rules to detect arithmetic [overflow](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-overflow), [signed-unsigned operations](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-unsigned), and [bit manipulation](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-nonnegative).15.6 +- **Arithmetic Rules**: Rules to detect arithmetic [overflow](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-overflow), [signed-unsigned operations](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-unsigned), and [bit manipulation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-nonnegative).15.6 -- **Bounds Rules**: Enforce the [Bounds profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile).15.3 +- **Bounds Rules**: Enforce the [Bounds profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile).15.3 -- **Class Rules**: A few rules that focus on proper use of special member functions and virtual specifications. They're a subset of the checks recommended for [classes and class hierarchies](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-class).15.5 +- **Class Rules**: A few rules that focus on proper use of special member functions and virtual specifications. They're a subset of the checks recommended for [classes and class hierarchies](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-class).15.5 -- **Concurrency Rules**: A single rule, which catches bad guard object declarations. For more information, see [guidelines related to concurrency](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-concurrency).15.5 +- **Concurrency Rules**: A single rule, which catches bad guard object declarations. For more information, see [guidelines related to concurrency](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-concurrency).15.5 -- **Const Rules**: Enforce [const-related checks from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con-constants-and-immutability).15.3 +- **Const Rules**: Enforce [const-related checks from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con-constants-and-immutability).15.3 -- **Declaration Rules**: A couple of rules from the [interfaces guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-interfaces) that focus on how global variables are declared.15.5 +- **Declaration Rules**: A couple of rules from the [interfaces guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-interfaces) that focus on how global variables are declared.15.5 -- **Enum Rules**: These rules enforce [enum-related checks from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-enum).16.3 +- **Enum Rules**: These rules enforce [enum-related checks from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-enum).16.3 - **Experimental Rules** These are experimental C++ Core Check rules that are useful but not ready for everyday use. Try them out and [provide feedback](https://aka.ms/feedback/suggest?space=62).16.0 -- **Function Rules**: Two checks that help with adoption of the **`noexcept`** specifier. They're part of the guidelines for [clear function design and implementation](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-functions).15.5 +- **Function Rules**: Two checks that help with adoption of the **`noexcept`** specifier. They're part of the guidelines for [clear function design and implementation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-functions).15.5 -- **GSL Rules**: These rules enforce checks related to the [Guidelines Support Library from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-gsl).15.7 +- **GSL Rules**: These rules enforce checks related to the [Guidelines Support Library from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-gsl).15.7 -- **Lifetime Rules**: These rules enforce the [Lifetime profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prolifetime-lifetime-safety-profile).15.7 +- **Lifetime Rules**: These rules enforce the [Lifetime profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prolifetime-lifetime-safety-profile).15.7 -- **Owner Pointer Rules**: Enforce [resource-management checks related to owner\ from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).15.3 +- **Owner Pointer Rules**: Enforce [resource-management checks related to owner\ from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management).15.3 -- **Raw Pointer Rules**: Enforce [resource-management checks related to raw pointers from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).15.3 +- **Raw Pointer Rules**: Enforce [resource-management checks related to raw pointers from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management).15.3 -- **Shared pointer Rules**: It's part of [resource management](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-resource) guidelines enforcement.15.5 We added a few rules specific to how shared pointers are passed into functions or used locally. +- **Shared pointer Rules**: It's part of [resource management](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-resource) guidelines enforcement.15.5 We added a few rules specific to how shared pointers are passed into functions or used locally. -- **STL Rules**: These rules enforce checks related to the [C++ Standard Library (STL) from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-stdlib).15.7 +- **STL Rules**: These rules enforce checks related to the [C++ Standard Library (STL) from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-stdlib).15.7 -- **Style Rules**: One simple but important check, which bans use of [goto](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-goto).15.5 It's the first step to improve your coding style and use of expressions and statements in C++. +- **Style Rules**: One simple but important check, which bans use of [goto](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-goto).15.5 It's the first step to improve your coding style and use of expressions and statements in C++. -- **Type Rules**: Enforce the [Type profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile).15.3 +- **Type Rules**: Enforce the [Type profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile).15.3 -- **Unique Pointer Rules**: Enforce [resource-management checks related to types with unique pointer semantics from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).15.3 +- **Unique Pointer Rules**: Enforce [resource-management checks related to types with unique pointer semantics from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management).15.3 -- **C++ Core Check Rules**: This rule set contains all the currently implemented checks from the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c-core-guidelines), except for the Experimental rules. +- **C++ Core Check Rules**: This rule set contains all the currently implemented checks from the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c-core-guidelines), except for the Experimental rules. 15.3 These rules first appeared in Visual Studio 2017 version 15.3\ 15.5 These rules first appeared in Visual Studio 2017 version 15.5\ diff --git a/docs/cpp/void-cpp.md b/docs/cpp/void-cpp.md index 09444a7cc04..b53334fff27 100644 --- a/docs/cpp/void-cpp.md +++ b/docs/cpp/void-cpp.md @@ -16,7 +16,7 @@ In C++, a **`void`** pointer can point to a free function (a function that's not You can't declare a variable of type **`void`**. -As a matter of style, the C++ Core Guidelines recommend you don't use **`void`** to specify an empty formal parameter list. For more information, see [C++ Core Guidelines NL.25: Don't use `void` as an argument type](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#nl25-dont-use-void-as-an-argument-type). +As a matter of style, the C++ Core Guidelines recommend you don't use **`void`** to specify an empty formal parameter list. For more information, see [C++ Core Guidelines NL.25: Don't use `void` as an argument type](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#nl25-dont-use-void-as-an-argument-type). ## Example diff --git a/docs/overview/overview-of-cpp-development.md b/docs/overview/overview-of-cpp-development.md index 3c29ebebb85..ca4cb394b97 100644 --- a/docs/overview/overview-of-cpp-development.md +++ b/docs/overview/overview-of-cpp-development.md @@ -110,7 +110,7 @@ For more information, see [Verifying Code by Using Unit Tests](/visualstudio/tes ## Analyze -Visual Studio includes static code analysis tools that can detect potential problems in your source code. These tools include an implementation of the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) rules checkers. For more information, see [Code analysis for C/C++ overview](../code-quality/code-analysis-for-c-cpp-overview.md). +Visual Studio includes static code analysis tools that can detect potential problems in your source code. These tools include an implementation of the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) rules checkers. For more information, see [Code analysis for C/C++ overview](../code-quality/code-analysis-for-c-cpp-overview.md). ## Deploy completed applications From cd51765cf374643005f26f8b9fe13fa3949d9740 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 17:07:23 +0800 Subject: [PATCH 0585/1799] Adjust link text in ASan `memcpy-param-overlap` error reference --- docs/sanitizers/error-memcpy-param-overlap.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/error-memcpy-param-overlap.md b/docs/sanitizers/error-memcpy-param-overlap.md index 5c5c46173de..e8b4d0b5062 100644 --- a/docs/sanitizers/error-memcpy-param-overlap.md +++ b/docs/sanitizers/error-memcpy-param-overlap.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["memcpy-param-overlap error", "AddressSanitizer error memc > Address Sanitizer Error: memcpy-param-overlap > [!NOTE] -> The `/Oi` flag is required to reliably detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and other functions as intrinsics, which is necessary because some versions of the standard library implement them as such. Since ASan is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Note that when `/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions isn't guaranteed to be used. For more information, see [`/Oi` docs](../build/reference/oi-generate-intrinsic-functions.md). +> The `/Oi` flag is required to reliably detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and other functions as intrinsics, which is necessary because some versions of the standard library implement them as such. Since ASan is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Note that when `/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions isn't guaranteed to be used. For more information, see [`/Oi` (Generate Intrinsic Functions)](../build/reference/oi-generate-intrinsic-functions.md). The CRT function [`memcpy`](../c-runtime-library/reference/memcpy-wmemcpy.md) **doesn't support** overlapping memory. The CRT provides an alternative to `memcpy` that does support overlapping memory: [`memmove`](../c-runtime-library/reference/memmove-wmemmove.md). From 7144f8afc4419ebe73ead6937189fa79fb0ff36d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 17:28:20 +0800 Subject: [PATCH 0586/1799] Tweak descriptions in `errno` constants reference --- docs/c-runtime-library/errno-constants.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/c-runtime-library/errno-constants.md b/docs/c-runtime-library/errno-constants.md index 57db146f7bd..13b8fa3f675 100644 --- a/docs/c-runtime-library/errno-constants.md +++ b/docs/c-runtime-library/errno-constants.md @@ -34,7 +34,7 @@ The following `errno` values are supported: | `EDEADLK` | Resource deadlock would occur. | 36 | | `EDEADLOCK` | Same as `EDEADLK` for compatibility with older Microsoft C versions. | 36 | | `EDOM` | Math argument. The argument to a math function isn't in the domain of the function. | 33 | -| `EEXIST` | Files exists. An attempt has been made to create a file that already exists. For example, the `_O_CREAT` and `_O_EXCL` flags are specified in an `_open` call, but the named file already exists. | 17 | +| `EEXIST` | File exists. An attempt has been made to create a file that already exists. For example, the `_O_CREAT` and `_O_EXCL` flags are specified in an `_open` call, but the named file already exists. | 17 | | `EFAULT` | Bad address. | 14 | | `EFBIG` | File too large. | 27 | | `EILSEQ` | Illegal sequence of bytes (for example, in an `MBCS` string). | 42 | @@ -50,7 +50,7 @@ The following `errno` values are supported: | `ENOENT` | No such file or directory. The specified file or directory doesn't exist or can't be found. This message can occur whenever a specified file doesn't exist or a component of a path doesn't specify an existing directory. | 2 | | `ENOEXEC` | Exec format error. An attempt was made to execute a file that isn't executable or that has an invalid executable-file format. | 8 | | `ENOLCK` | No locks available. | 39 | -| `ENOMEM` | Not enough memory is available for the attempted operator. For example, this message can occur when insufficient memory is available to execute a child process, or when the allocation request in a `_getcwd` call can't be satisfied. | 12 | +| `ENOMEM` | Not enough memory is available for the attempted operation. For example, this message can occur when insufficient memory is available to execute a child process, or when the allocation request in a `_getcwd` call can't be satisfied. | 12 | | `ENOSPC` | No space left on device. No more space for writing is available on the device (for example, when the disk is full). | 28 | | `ENOSYS` | Function not supported. | 40 | | `ENOTDIR` | Not a directory. | 20 | @@ -60,7 +60,7 @@ The following `errno` values are supported: | `EPERM` | Operation not permitted. | 1 | | `EPIPE` | Broken pipe. | 32 | | `ERANGE` | Result too large. An argument to a math function is too large, resulting in partial or total loss of significance in the result. This error can also occur in other functions when an argument is larger than expected (for example, when the *`buffer`* argument to `_getcwd` is longer than expected). | 34 | -| `EROFS` | Read only file system. | 30 | +| `EROFS` | Read-only file system. | 30 | | `ESPIPE` | Invalid seek. | 29 | | `ESRCH` | No such process. | 3 | | `EXDEV` | Cross-device link. An attempt was made to move a file to a different device (using the `rename` function). | 18 | @@ -84,8 +84,8 @@ The following values are supported for compatibility with POSIX: | `EIDRM` | Identifier removed. | 111 | | `EINPROGRESS` | Operation in progress. | 112 | | `EISCONN` | Already connected. | 113 | -| `ELOOP` | Too many symbolic link levels. | 114 | -| `EMSGSIZE` | Message size. | 115 | +| `ELOOP` | Too many levels of symbolic links. | 114 | +| `EMSGSIZE` | Message too long. | 115 | | `ENETDOWN` | Network down. | 116 | | `ENETRESET` | Network reset. | 117 | | `ENETUNREACH` | Network unreachable. | 118 | From 3e864b8f08b351042ca8e671d68b9a2c1641ac32 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 17:31:12 +0800 Subject: [PATCH 0587/1799] Clean up unneeded `./` link prefix in `errno` constants reference --- docs/c-runtime-library/errno-constants.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/c-runtime-library/errno-constants.md b/docs/c-runtime-library/errno-constants.md index 13b8fa3f675..9da8594cefc 100644 --- a/docs/c-runtime-library/errno-constants.md +++ b/docs/c-runtime-library/errno-constants.md @@ -15,11 +15,11 @@ helpviewer_keywords: ["E2BIG constant", "EACCES constant", "EAGAIN constant", "E ## Remarks -The `errno` constants are values assigned to [`errno`](./errno-doserrno-sys-errlist-and-sys-nerr.md) for various error conditions. +The `errno` constants are values assigned to [`errno`](errno-doserrno-sys-errlist-and-sys-nerr.md) for various error conditions. `ERRNO.H` contains the definitions of the `errno` values. However, not all the definitions given in `ERRNO.H` are used in 32-bit Windows operating systems. Some of the values in `ERRNO.H` are present to maintain compatibility with the UNIX family of operating systems. The `errno` values in a 32-bit Windows operating system are a subset of the values for `errno` in UNIX systems. -The `errno` value isn't necessarily the same as the actual error code returned by a system call from the Windows operating system. To access the actual operating system error code, use the [`_doserrno`](./errno-doserrno-sys-errlist-and-sys-nerr.md) variable, which contains this value. +The `errno` value isn't necessarily the same as the actual error code returned by a system call from the Windows operating system. To access the actual operating system error code, use the [`_doserrno`](errno-doserrno-sys-errlist-and-sys-nerr.md) variable, which contains this value. The following `errno` values are supported: @@ -64,7 +64,7 @@ The following `errno` values are supported: | `ESPIPE` | Invalid seek. | 29 | | `ESRCH` | No such process. | 3 | | `EXDEV` | Cross-device link. An attempt was made to move a file to a different device (using the `rename` function). | 18 | -| `STRUNCATE` | A string copy or concatenation resulted in a truncated string. See [`_TRUNCATE`](./truncate.md). | 80 | +| `STRUNCATE` | A string copy or concatenation resulted in a truncated string. See [`_TRUNCATE`](truncate.md). | 80 | The following values are supported for compatibility with POSIX: @@ -114,4 +114,4 @@ The following values are supported for compatibility with POSIX: ## See also -[Global constants](./global-constants.md) +[Global constants](global-constants.md) From d348684dd6128802b1c20f7a51147b0f235f2ea8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 17:32:11 +0800 Subject: [PATCH 0588/1799] Move `title` metadata above `description` in `errno` constants reference --- docs/c-runtime-library/errno-constants.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/errno-constants.md b/docs/c-runtime-library/errno-constants.md index 9da8594cefc..20b1f808cd2 100644 --- a/docs/c-runtime-library/errno-constants.md +++ b/docs/c-runtime-library/errno-constants.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: errno constants" title: "errno constants" +description: "Learn more about: errno constants" ms.date: 04/26/2021 f1_keywords: ["E2BIG", "EACCES", "EAGAIN", "EBADF", "EBUSY", "ECHILD", "EDEADLK", "EDEADLOCK", "EDOM", "EEXIST", "EFAULT", "EFBIG", "EILSEQ", "EINTR", "EINVAL", "EIO", "EISDIR", "EMFILE", "EMLINK", "ENAMETOOLONG", "ENFILE", "ENODEV", "ENOENT", "ENOEXEC", "ENOLCK", "ENOMEM", "ENOSPC", "ENOSYS", "ENOTDIR", "ENOTEMPTY", "ENOTTY", "ENXIO", "EPERM", "EPIPE", "ERANGE", "EROFS", "ESPIPE", "ESRCH", "EXDEV", "STRUNCATE", "EADDRINUSE", "EADDRNOTAVAIL", "EAFNOSUPPORT", "EALREADY", "EBADMSG", "ECANCELED", "ECONNABORTED", "ECONNREFUSED", "ECONNRESET", "EDESTADDRREQ", "EHOSTUNREACH", "EIDRM", "EINPROGRESS", "EISCONN", "ELOOP", "EMSGSIZE", "ENETDOWN", "ENETRESET", "ENETUNREACH", "ENOBUFS", "ENODATA", "ENOLINK", "ENOMSG", "ENOPROTOOPT", "ENOSR", "ENOSTR", "ENOTCONN", "ENOTRECOVERABLE", "ENOTSOCK", "ENOTSUP", "EOPNOTSUPP", "EOTHER", "EOVERFLOW", "EOWNERDEAD", "EPROTO", "EPROTONOSUPPORT", "EPROTOTYPE", "ETIME", "ETIMEDOUT", "ETXTBSY", "EWOULDBLOCK"] helpviewer_keywords: ["E2BIG constant", "EACCES constant", "EAGAIN constant", "EBADF constant", "EBUSY constant", "ECHILD constant", "EDEADLK constant", "EDEADLOCK constant", "EDOM constant", "EEXIST constant", "EFAULT constant", "EFBIG constant", "EILSEQ constant", "EINTR constant", "EINVAL constant", "EIO constant", "EISDIR constant", "EMFILE constant", "EMLINK constant", "ENAMETOOLONG constant", "ENFILE constant", "ENODEV constant", "ENOENT constant", "ENOEXEC constant", "ENOLCK constant", "ENOMEM constant", "ENOSPC constant", "ENOSYS constant", "ENOTDIR constant", "ENOTEMPTY constant", "ENOTTY constant", "ENXIO constant", "EPERM constant", "EPIPE constant", "ERANGE constant", "EROFS constant", "ESPIPE constant", "ESRCH constant", "EXDEV constant", "STRUNCATE constant", "EADDRINUSE constant", "EADDRNOTAVAIL constant", "EAFNOSUPPORT constant", "EALREADY constant", "EBADMSG constant", "ECANCELED constant", "ECONNABORTED constant", "ECONNREFUSED constant", "ECONNRESET constant", "EDESTADDRREQ constant", "EHOSTUNREACH constant", "EIDRM constant", "EINPROGRESS constant", "EISCONN constant", "ELOOP constant", "EMSGSIZE constant", "ENETDOWN constant", "ENETRESET constant", "ENETUNREACH constant", "ENOBUFS constant", "ENODATA constant", "ENOLINK constant", "ENOMSG constant", "ENOPROTOOPT constant", "ENOSR constant", "ENOSTR constant", "ENOTCONN constant", "ENOTRECOVERABLE constant", "ENOTSOCK constant", "ENOTSUP constant", "EOPNOTSUPP constant", "EOTHER constant", "EOVERFLOW constant", "EOWNERDEAD constant", "EPROTO constant", "EPROTONOSUPPORT constant", "EPROTOTYPE constant", "ETIME constant", "ETIMEDOUT constant", "ETXTBSY constant", "EWOULDBLOCK constant"] From 8bd2bc7d00fe379d40a4816ad5711b3cc159c9cc Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 17:56:20 +0800 Subject: [PATCH 0589/1799] Convert Expression evaluator errors list into a table --- ...valuator-errors-cxx0000-through-cxx0072.md | 136 +++++++++--------- 1 file changed, 69 insertions(+), 67 deletions(-) diff --git a/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md b/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md index 3347b385f8a..2b8aac4220d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md +++ b/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md @@ -12,73 +12,75 @@ This section is a reference to the errors generated by the debugger and diagnost ## Expression evaluator error messages -[Expression evaluator error CXX0000](expression-evaluator-error-cxx0000.md) \ -[Expression evaluator error CXX0001](expression-evaluator-error-cxx0001.md) \ -[Expression evaluator error CXX0002](expression-evaluator-error-cxx0002.md) \ -[Expression evaluator error CXX0004](expression-evaluator-error-cxx0004.md) \ -[Expression evaluator error CXX0005](expression-evaluator-error-cxx0005.md) \ -[Expression evaluator error CXX0006](expression-evaluator-error-cxx0006.md) \ -[Expression evaluator error CXX0007](expression-evaluator-error-cxx0007.md) \ -[Expression evaluator error CXX0008](expression-evaluator-error-cxx0008.md) \ -[Expression evaluator error CXX0009](expression-evaluator-error-cxx0009.md) \ -[Expression evaluator error CXX0010](expression-evaluator-error-cxx0010.md) \ -[Expression evaluator error CXX0011](expression-evaluator-error-cxx0011.md) \ -[Expression evaluator error CXX0012](expression-evaluator-error-cxx0012.md) \ -[Expression evaluator error CXX0013](expression-evaluator-error-cxx0013.md) \ -[Expression evaluator error CXX0014](expression-evaluator-error-cxx0014.md) \ -[Expression evaluator error CXX0015](expression-evaluator-error-cxx0015.md) \ -[Expression evaluator error CXX0016](expression-evaluator-error-cxx0016.md) \ -[Expression evaluator error CXX0017](expression-evaluator-error-cxx0017.md) \ -[Expression evaluator error CXX0018](expression-evaluator-error-cxx0018.md) \ -[Expression evaluator error CXX0019](expression-evaluator-error-cxx0019.md) \ -[Expression evaluator error CXX0020](expression-evaluator-error-cxx0020.md) \ -[Expression evaluator error CXX0021](expression-evaluator-error-cxx0021.md) \ -[Expression evaluator error CXX0022](expression-evaluator-error-cxx0022.md) \ -[Expression evaluator error CXX0023](expression-evaluator-error-cxx0023.md) \ -[Expression evaluator error CXX0024](expression-evaluator-error-cxx0024.md) \ -[Expression evaluator error CXX0025](expression-evaluator-error-cxx0025.md) \ -[Expression evaluator error CXX0026](expression-evaluator-error-cxx0026.md) \ -[Expression evaluator error CXX0027](expression-evaluator-error-cxx0027.md) \ -[Expression evaluator error CXX0028](expression-evaluator-error-cxx0028.md) \ -[Expression evaluator error CXX0029](expression-evaluator-error-cxx0029.md) \ -[Expression evaluator error CXX0030](expression-evaluator-error-cxx0030.md) \ -[Expression evaluator error CXX0031](expression-evaluator-error-cxx0031.md) \ -[Expression evaluator error CXX0032](expression-evaluator-error-cxx0032.md) \ -[Expression evaluator error CXX0033](expression-evaluator-error-cxx0033.md) \ -[Expression evaluator error CXX0034](expression-evaluator-error-cxx0034.md) \ -[Expression evaluator error CXX0036](expression-evaluator-error-cxx0036.md) \ -[Expression evaluator error CXX0037](expression-evaluator-error-cxx0037.md) \ -[Expression evaluator error CXX0038](expression-evaluator-error-cxx0038.md) \ -[Expression evaluator error CXX0039](expression-evaluator-error-cxx0039.md) \ -[Expression evaluator error CXX0040](expression-evaluator-error-cxx0040.md) \ -[Expression evaluator error CXX0041](expression-evaluator-error-cxx0041.md) \ -[Expression evaluator error CXX0043](expression-evaluator-error-cxx0043.md) \ -[Expression evaluator error CXX0044](expression-evaluator-error-cxx0044.md) \ -[Expression evaluator error CXX0045](expression-evaluator-error-cxx0045.md) \ -[Expression evaluator error CXX0046](expression-evaluator-error-cxx0046.md) \ -[Expression evaluator error CXX0047](expression-evaluator-error-cxx0047.md) \ -[Expression evaluator error CXX0048](expression-evaluator-error-cxx0048.md) \ -[Expression evaluator error CXX0049](expression-evaluator-error-cxx0049.md) \ -[Expression evaluator error CXX0050](expression-evaluator-error-cxx0050.md) \ -[Expression evaluator error CXX0051](expression-evaluator-error-cxx0051.md) \ -[Expression evaluator error CXX0052](expression-evaluator-error-cxx0052.md) \ -[Expression evaluator error CXX0053](expression-evaluator-error-cxx0053.md) \ -[Expression evaluator error CXX0054](expression-evaluator-error-cxx0054.md) \ -[Expression evaluator error CXX0055](expression-evaluator-error-cxx0055.md) \ -[Expression evaluator error CXX0056](expression-evaluator-error-cxx0056.md) \ -[Expression evaluator error CXX0057](expression-evaluator-error-cxx0057.md) \ -[Expression evaluator error CXX0058](expression-evaluator-error-cxx0058.md) \ -[Expression evaluator error CXX0059](expression-evaluator-error-cxx0059.md) \ -[Expression evaluator error CXX0060](expression-evaluator-error-cxx0060.md) \ -[Expression evaluator error CXX0061](expression-evaluator-error-cxx0061.md) \ -[Expression evaluator error CXX0062](expression-evaluator-error-cxx0062.md) \ -[Expression evaluator error CXX0063](expression-evaluator-error-cxx0063.md) \ -[Expression evaluator error CXX0064](expression-evaluator-error-cxx0064.md) \ -[Expression evaluator error CXX0065](expression-evaluator-error-cxx0065.md) \ -[Expression evaluator error CXX0066](expression-evaluator-error-cxx0066.md) \ -[Expression evaluator error CXX0067](expression-evaluator-error-cxx0067.md) \ -[Expression evaluator error CXX0069](expression-evaluator-error-cxx0069.md) \ -[Expression evaluator error CXX0072](expression-evaluator-error-cxx0072.md) +| Error | Message | +|--|--| +| [Expression evaluator error CXX0000](expression-evaluator-error-cxx0000.md) | no error condition | +| [Expression evaluator error CXX0001](expression-evaluator-error-cxx0001.md) | exception executing user function | +| [Expression evaluator error CXX0002](expression-evaluator-error-cxx0002.md) | error accessing user memory | +| [Expression evaluator error CXX0004](expression-evaluator-error-cxx0004.md) | syntax error | +| [Expression evaluator error CXX0005](expression-evaluator-error-cxx0005.md) | operator not supported | +| [Expression evaluator error CXX0006](expression-evaluator-error-cxx0006.md) | missing left parenthesis | +| [Expression evaluator error CXX0007](expression-evaluator-error-cxx0007.md) | missing right parenthesis | +| [Expression evaluator error CXX0008](expression-evaluator-error-cxx0008.md) | missing " at end of string | +| [Expression evaluator error CXX0009](expression-evaluator-error-cxx0009.md) | missing ' after character constant | +| [Expression evaluator error CXX0010](expression-evaluator-error-cxx0010.md) | missing left bracket | +| [Expression evaluator error CXX0011](expression-evaluator-error-cxx0011.md) | missing right bracket | +| [Expression evaluator error CXX0012](expression-evaluator-error-cxx0012.md) | missing left curly brace | +| [Expression evaluator error CXX0013](expression-evaluator-error-cxx0013.md) | missing operator | +| [Expression evaluator error CXX0014](expression-evaluator-error-cxx0014.md) | missing operand | +| [Expression evaluator error CXX0015](expression-evaluator-error-cxx0015.md) | expression too complex (stack overflow) | +| [Expression evaluator error CXX0016](expression-evaluator-error-cxx0016.md) | constant too big | +| [Expression evaluator error CXX0017](expression-evaluator-error-cxx0017.md) | symbol not found | +| [Expression evaluator error CXX0018](expression-evaluator-error-cxx0018.md) | bad register name | +| [Expression evaluator error CXX0019](expression-evaluator-error-cxx0019.md) | bad type cast | +| [Expression evaluator error CXX0020](expression-evaluator-error-cxx0020.md) | operand types bad for this operation | +| [Expression evaluator error CXX0021](expression-evaluator-error-cxx0021.md) | struct or union used as scalar | +| [Expression evaluator error CXX0022](expression-evaluator-error-cxx0022.md) | function call before _main | +| [Expression evaluator error CXX0023](expression-evaluator-error-cxx0023.md) | bad radix | +| [Expression evaluator error CXX0024](expression-evaluator-error-cxx0024.md) | operation needs l-value | +| [Expression evaluator error CXX0025](expression-evaluator-error-cxx0025.md) | operator needs struct/union | +| [Expression evaluator error CXX0026](expression-evaluator-error-cxx0026.md) | bad format string | +| [Expression evaluator error CXX0027](expression-evaluator-error-cxx0027.md) | tp addr not l-value | +| [Expression evaluator error CXX0028](expression-evaluator-error-cxx0028.md) | not struct/union element | +| [Expression evaluator error CXX0029](expression-evaluator-error-cxx0029.md) | not struct pointer | +| [Expression evaluator error CXX0030](expression-evaluator-error-cxx0030.md) | expression not evaluatable | +| [Expression evaluator error CXX0031](expression-evaluator-error-cxx0031.md) | expression not expandable | +| [Expression evaluator error CXX0032](expression-evaluator-error-cxx0032.md) | divide by 0 | +| [Expression evaluator error CXX0033](expression-evaluator-error-cxx0033.md) | error in OMF type information | +| [Expression evaluator error CXX0034](expression-evaluator-error-cxx0034.md) | types incompatible with operator | +| [Expression evaluator error CXX0036](expression-evaluator-error-cxx0036.md) | bad context {...} specification | +| [Expression evaluator error CXX0037](expression-evaluator-error-cxx0037.md) | out of memory | +| [Expression evaluator error CXX0038](expression-evaluator-error-cxx0038.md) | function argument count and/or type mismatch | +| [Expression evaluator error CXX0039](expression-evaluator-error-cxx0039.md) | symbol is ambiguous | +| [Expression evaluator error CXX0040](expression-evaluator-error-cxx0040.md) | function requires implicit conversion | +| [Expression evaluator error CXX0041](expression-evaluator-error-cxx0041.md) | class element must be static member or member function | +| [Expression evaluator error CXX0043](expression-evaluator-error-cxx0043.md) | this pointer used outside member function | +| [Expression evaluator error CXX0044](expression-evaluator-error-cxx0044.md) | use of _based(void) pointer requires :> operator | +| [Expression evaluator error CXX0045](expression-evaluator-error-cxx0045.md) | not a function | +| [Expression evaluator error CXX0046](expression-evaluator-error-cxx0046.md) | argument list required for member function | +| [Expression evaluator error CXX0047](expression-evaluator-error-cxx0047.md) | argument list does not match a function | +| [Expression evaluator error CXX0048](expression-evaluator-error-cxx0048.md) | calling sequence not supported | +| [Expression evaluator error CXX0049](expression-evaluator-error-cxx0049.md) | obsolete OMF - please relink program | +| [Expression evaluator error CXX0050](expression-evaluator-error-cxx0050.md) | left side of :: must be class/struct/union | +| [Expression evaluator error CXX0051](expression-evaluator-error-cxx0051.md) | more than one overloaded symbol specified in breakpoint | +| [Expression evaluator error CXX0052](expression-evaluator-error-cxx0052.md) | member function not present | +| [Expression evaluator error CXX0053](expression-evaluator-error-cxx0053.md) | nonfunction symbol match while binding breakpoints | +| [Expression evaluator error CXX0054](expression-evaluator-error-cxx0054.md) | register in breakpoint expression illegal | +| [Expression evaluator error CXX0055](expression-evaluator-error-cxx0055.md) | ambiguous symbol in context operator | +| [Expression evaluator error CXX0056](expression-evaluator-error-cxx0056.md) | error in line number | +| [Expression evaluator error CXX0057](expression-evaluator-error-cxx0057.md) | no code at line number | +| [Expression evaluator error CXX0058](expression-evaluator-error-cxx0058.md) | overloaded operator not found | +| [Expression evaluator error CXX0059](expression-evaluator-error-cxx0059.md) | left operand is class not a function name | +| [Expression evaluator error CXX0060](expression-evaluator-error-cxx0060.md) | register is not available | +| [Expression evaluator error CXX0061](expression-evaluator-error-cxx0061.md) | function nesting depth exceeded | +| [Expression evaluator error CXX0062](expression-evaluator-error-cxx0062.md) | constructor calls not supported | +| [Expression evaluator error CXX0063](expression-evaluator-error-cxx0063.md) | overloaded operator -> not supported | +| [Expression evaluator error CXX0064](expression-evaluator-error-cxx0064.md) | can't set breakpoint on bound virtual member function | +| [Expression evaluator error CXX0065](expression-evaluator-error-cxx0065.md) | variable needs stack frame | +| [Expression evaluator error CXX0066](expression-evaluator-error-cxx0066.md) | static member not present | +| [Expression evaluator error CXX0067](expression-evaluator-error-cxx0067.md) | function evaluation not supported | +| [Expression evaluator error CXX0069](expression-evaluator-error-cxx0069.md) | variable needs stack frame | +| [Expression evaluator error CXX0072](expression-evaluator-error-cxx0072.md) | Error: type information missing or unknown | ## See also From c053abc0847aadc1641b258ea70a64396420ad3e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 17:57:28 +0800 Subject: [PATCH 0590/1799] Simplify superfluous relative links in "Expression evaluator errors (CXXxxxx)" --- .../expression-evaluator-errors-cxx0000-through-cxx0072.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md b/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md index 2b8aac4220d..8132169f9f6 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md +++ b/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md @@ -8,7 +8,7 @@ ms.assetid: a47a9866-7fb2-4b21-978c-2b77402c7105 This section is a reference to the errors generated by the debugger and diagnostics tools. These tools generate errors of the form CXX*xxxx* or CAN*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Expression evaluator error messages From 6ee25957250e3ab7ade5152123ac441a00122999 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 17:59:36 +0800 Subject: [PATCH 0591/1799] Update metadata in "Expression evaluator errors (CXXxxxx)" --- .../expression-evaluator-errors-cxx0000-through-cxx0072.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md b/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md index 8132169f9f6..a35f769cf05 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md +++ b/docs/error-messages/tool-errors/expression-evaluator-errors-cxx0000-through-cxx0072.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: Expression evaluator errors (CXXxxxx)" title: "Expression evaluator errors" -ms.date: "04/16/2019" -ms.assetid: a47a9866-7fb2-4b21-978c-2b77402c7105 +description: "Learn more about: Expression evaluator errors (CXXxxxx)" +ms.date: 04/16/2019 --- # Expression evaluator errors (CXXxxxx) From 049e07ec7c9318208eb6521789ccf0c94842e51b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 18:12:38 +0800 Subject: [PATCH 0592/1799] Add blockquotes for error messages in range [C2581, C2610] --- docs/error-messages/compiler-errors-2/compiler-error-c2581.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2582.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2584.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2585.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2586.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2587.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2588.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2589.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2592.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2593.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2594.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2597.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2598.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2599.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2600.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2602.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2605.md | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md index c6e7b9a608c..18e774904d1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md @@ -8,7 +8,7 @@ ms.assetid: 24a4e4c1-24d3-4e42-b760-7dcaf9740b16 --- # Compiler Error C2581 -'type' : static 'operator =' function is illegal +> 'type' : static 'operator =' function is illegal The assignment (`=`) operator is incorrectly declared as **`static`**. Assignment operators cannot be **`static`**. For more information, see [User-Defined Operators (C++/CLI)](../../dotnet/user-defined-operators-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md index 82484c7c1ad..adf0764e41f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md @@ -8,7 +8,7 @@ ms.assetid: ee1b9378-8bcd-4792-b87e-6d7a466d29ed --- # Compiler Error C2582 -'function' function is unavailable in 'type' +> 'function' function is unavailable in 'type' An attempt was made to assign to an object that does not have an assignment operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md index e63ec9e0542..49251f08bf1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md @@ -8,7 +8,7 @@ ms.assetid: 836e2c0a-86c0-4742-b432-beb0191ad20e --- # Compiler Error C2584 -'Class' : direct base 'Base2' is inaccessible; already a base of 'Base1' +> 'Class' : direct base 'Base2' is inaccessible; already a base of 'Base1' `Class` already derives directly from `Base1`. `Base2` also derives from `Base1`. `Class` cannot derive from `Base2` because that would mean inheriting (indirectly) from `Base1` again, which is not legal because `Base1` is already a direct base class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2585.md b/docs/error-messages/compiler-errors-2/compiler-error-c2585.md index 7ced014cea2..58f4a8a5519 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2585.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2585.md @@ -8,7 +8,7 @@ ms.assetid: 05bb1a9c-28fb-4a88-a1b5-aea85ebdee1c --- # Compiler Error C2585 -explicit conversion to 'type' is ambiguous +> explicit conversion to 'type' is ambiguous The type conversion can produce more than one result. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md index a5767ea958e..5316ceef8c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md @@ -8,7 +8,7 @@ ms.assetid: dae703c7-5c38-4db6-8411-4d1b22713eb5 --- # Compiler Error C2586 -incorrect user-defined conversion syntax : illegal indirections +> incorrect user-defined conversion syntax : illegal indirections Indirection of a conversion operator is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md index dd0b86bde45..bdc62e9435d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md @@ -8,7 +8,7 @@ ms.assetid: 7637a2c7-35d4-4b5a-a8f2-515a7bda98fd --- # Compiler Error C2587 -'identifier' : illegal use of local variable as default parameter +> 'identifier' : illegal use of local variable as default parameter Local variables are not allowed as default parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md index 97560fa93c1..3e6351e4752 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md @@ -8,7 +8,7 @@ ms.assetid: 19a0cabd-ca13-44a5-9be3-ee676abf9bc4 --- # Compiler Error C2588 -'::~identifier' : illegal global destructor +> '::~identifier' : illegal global destructor The destructor is defined for something other than a class, structure, or union. This is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md index e712be3b261..104f1ef0e2f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md @@ -8,7 +8,7 @@ ms.assetid: 1d7942c7-8a81-4bb4-b272-76a0019e8513 --- # Compiler Error C2589 -'identifier' : illegal token on right side of '::' +> 'identifier' : illegal token on right side of '::' If a class, structure, or union name appears to the left of the scope-resolution operator (double colons), the token on the right must be a class, structure, or union member. Otherwise, any global identifier can appear on the right. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2592.md b/docs/error-messages/compiler-errors-2/compiler-error-c2592.md index 637edee9781..c0e8112dc7d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2592.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2592.md @@ -8,6 +8,6 @@ ms.assetid: 833a4d7b-66ef-4d4c-ae83-a533c2b0eb07 --- # Compiler Error C2592 -'class': 'base_class_2' is inherited from 'base_class_1' and cannot be re-specified +> 'class': 'base_class_2' is inherited from 'base_class_1' and cannot be re-specified You can only specify base classes that do not inherit from other base classes. In this case, only `base_class_1` is needed in the specification of **`class`** because `base_class_1` already inherits `base_class_2`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md index b12f1563fd6..69bdbd3a6b3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md @@ -8,7 +8,7 @@ ms.assetid: 4a0fe9bb-2163-447d-91f6-1890ed8250f6 --- # Compiler Error C2593 -'operator identifier' is ambiguous +> 'operator identifier' is ambiguous More than one possible operator is defined for an overloaded operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md index a68fd0ce545..82733c55eb8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md @@ -8,7 +8,7 @@ ms.assetid: 68cd708f-266e-44b0-a211-3e3ab63b11bf --- # Compiler Error C2594 -'operator' : ambiguous conversions from 'type1' to 'type2' +> 'operator' : ambiguous conversions from 'type1' to 'type2' No conversion from *type1* to *type2* was more direct than any other. We suggest two possible solutions to converting from *type1* to *type2*. The first option is to define a direct conversion from *type1* to *type2*, and the second option is to specify a sequence of conversions from *type1* to *type2*. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md index 1c77cfc6004..68b6986a658 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md @@ -8,7 +8,7 @@ ms.assetid: 2e48127d-e3ff-4a40-8156-2863e45b1a38 --- # Compiler Error C2597 -illegal reference to non-static member 'identifier' +> illegal reference to non-static member 'identifier' Possible causes: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md index 017757d46f4..24d581910ab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md @@ -8,7 +8,7 @@ ms.assetid: 40777c62-39ba-441e-b081-f49f94b43547 --- # Compiler Error C2598 -linkage specification must be at global scope +> linkage specification must be at global scope The linkage specifier is declared at local scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md index 4d8490f2778..e2a970b0c4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md @@ -8,7 +8,7 @@ ms.assetid: 88515f36-7589-47e2-862e-0de8b18d6668 --- # Compiler Error C2599 -'enum' : forward declaration of enum type is not allowed +> 'enum' : forward declaration of enum type is not allowed The compiler no longer supports forward declaration of a managed enumeration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md index 75038e37b85..e57b37e3c47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md @@ -8,7 +8,7 @@ ms.assetid: cce11943-ea01-4bee-a7b0-b67d24ec6493 --- # Compiler Error C2600 -'function' : cannot define a compiler-generated special member function (must be declared in the class first) +> 'function' : cannot define a compiler-generated special member function (must be declared in the class first) Before member functions such as constructors or destructors can be defined for a class, they must be declared in the class. The compiler can generate default constructors and destructors (called special member functions) if none are declared in the class. However, if you define one of these functions without a matching declaration in the class, the compiler detects a conflict. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md index dabc0048be8..ebf89c4a8d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md @@ -8,7 +8,7 @@ ms.assetid: 6c07a40e-537e-4954-b5c5-1e0e58fe1952 --- # Compiler Error C2602 -'class::Identifier' is not a member of a base class of 'class' +> 'class::Identifier' is not a member of a base class of 'class' `Identifier` cannot be accessed because it is not a member inherited from any base class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md index a11f99a7a35..9ce7c9cf136 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md @@ -8,7 +8,7 @@ ms.assetid: a0e6f132-5acf-4e19-b277-ddf196d182bf --- # Compiler Error C2605 -'name' : this method is reserved within a managed or WinRT class +> 'name' : this method is reserved within a managed or WinRT class Certain names are reserved by the compiler for internal functions. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). From 1fcc773c753e164667a3a40e2463afee8ea71cb9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 18:20:03 +0800 Subject: [PATCH 0593/1799] Add "Remarks" and "Example" headings for error references in range [C2581, C2610] --- docs/error-messages/compiler-errors-2/compiler-error-c2581.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2582.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2584.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2585.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2586.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2587.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2588.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2589.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2592.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2593.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2594.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2597.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2598.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2599.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2600.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2602.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2603.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2605.md | 2 ++ 18 files changed, 60 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md index 18e774904d1..8ba27538096 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md @@ -10,6 +10,8 @@ ms.assetid: 24a4e4c1-24d3-4e42-b760-7dcaf9740b16 > 'type' : static 'operator =' function is illegal +## Remarks + The assignment (`=`) operator is incorrectly declared as **`static`**. Assignment operators cannot be **`static`**. For more information, see [User-Defined Operators (C++/CLI)](../../dotnet/user-defined-operators-cpp-cli.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md index adf0764e41f..5c6c69f0b1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md @@ -10,8 +10,12 @@ ms.assetid: ee1b9378-8bcd-4792-b87e-6d7a466d29ed > 'function' function is unavailable in 'type' +## Remarks + An attempt was made to assign to an object that does not have an assignment operator. +## Example + The following sample generates C2582: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md index 49251f08bf1..e17ad5bb8e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md @@ -10,6 +10,8 @@ ms.assetid: 836e2c0a-86c0-4742-b432-beb0191ad20e > 'Class' : direct base 'Base2' is inaccessible; already a base of 'Base1' +## Remarks + `Class` already derives directly from `Base1`. `Base2` also derives from `Base1`. `Class` cannot derive from `Base2` because that would mean inheriting (indirectly) from `Base1` again, which is not legal because `Base1` is already a direct base class. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2585.md b/docs/error-messages/compiler-errors-2/compiler-error-c2585.md index 58f4a8a5519..d9924073e82 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2585.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2585.md @@ -10,6 +10,8 @@ ms.assetid: 05bb1a9c-28fb-4a88-a1b5-aea85ebdee1c > explicit conversion to 'type' is ambiguous +## Remarks + The type conversion can produce more than one result. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md index 5316ceef8c5..1fc9cf28c71 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md @@ -10,8 +10,12 @@ ms.assetid: dae703c7-5c38-4db6-8411-4d1b22713eb5 > incorrect user-defined conversion syntax : illegal indirections +## Remarks + Indirection of a conversion operator is not allowed. +## Example + The following sample generates C2586: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md index bdc62e9435d..92d214cc1a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md @@ -10,8 +10,12 @@ ms.assetid: 7637a2c7-35d4-4b5a-a8f2-515a7bda98fd > 'identifier' : illegal use of local variable as default parameter +## Remarks + Local variables are not allowed as default parameters. +## Example + The following sample generates C2587: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md index 3e6351e4752..ca7c81a2301 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md @@ -10,10 +10,14 @@ ms.assetid: 19a0cabd-ca13-44a5-9be3-ee676abf9bc4 > '::~identifier' : illegal global destructor +## Remarks + The destructor is defined for something other than a class, structure, or union. This is not allowed. This error can be caused by a missing class, structure, or union name on the left side of the scope resolution (`::`) operator. +## Example + The following sample generates C2588: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md index 104f1ef0e2f..e2e291b566f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md @@ -10,10 +10,14 @@ ms.assetid: 1d7942c7-8a81-4bb4-b272-76a0019e8513 > 'identifier' : illegal token on right side of '::' +## Remarks + If a class, structure, or union name appears to the left of the scope-resolution operator (double colons), the token on the right must be a class, structure, or union member. Otherwise, any global identifier can appear on the right. The scope-resolution operator cannot be overloaded. +## Example + The following sample generates C2589: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2592.md b/docs/error-messages/compiler-errors-2/compiler-error-c2592.md index c0e8112dc7d..2f168e28862 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2592.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2592.md @@ -10,4 +10,6 @@ ms.assetid: 833a4d7b-66ef-4d4c-ae83-a533c2b0eb07 > 'class': 'base_class_2' is inherited from 'base_class_1' and cannot be re-specified +## Remarks + You can only specify base classes that do not inherit from other base classes. In this case, only `base_class_1` is needed in the specification of **`class`** because `base_class_1` already inherits `base_class_2`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md index 69bdbd3a6b3..1c6b265ad93 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md @@ -10,10 +10,14 @@ ms.assetid: 4a0fe9bb-2163-447d-91f6-1890ed8250f6 > 'operator identifier' is ambiguous +## Remarks + More than one possible operator is defined for an overloaded operator. This error may be fixed if you use an explicit cast on one or more actual parameters. +## Examples + The following sample generates C2593: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md index 82733c55eb8..1e218bf85d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md @@ -10,8 +10,12 @@ ms.assetid: 68cd708f-266e-44b0-a211-3e3ab63b11bf > 'operator' : ambiguous conversions from 'type1' to 'type2' +## Remarks + No conversion from *type1* to *type2* was more direct than any other. We suggest two possible solutions to converting from *type1* to *type2*. The first option is to define a direct conversion from *type1* to *type2*, and the second option is to specify a sequence of conversions from *type1* to *type2*. +## Example + The following sample generates C2594. The suggested resolution to the error is a sequence of conversions: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md index 68b6986a658..f87638db0c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md @@ -10,6 +10,8 @@ ms.assetid: 2e48127d-e3ff-4a40-8156-2863e45b1a38 > illegal reference to non-static member 'identifier' +## Remarks + Possible causes: 1. A nonstatic member is specified in a static member function. To access the nonstatic member, you must pass in or create a local instance of the class and use a member-access operator (`.` or `->`). @@ -18,6 +20,8 @@ Possible causes: 1. A member access operator refers to a nonmember function. +## Example + 1. The following sample generates C2597 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md index 24d581910ab..032e9ee4dc2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md @@ -10,8 +10,12 @@ ms.assetid: 40777c62-39ba-441e-b081-f49f94b43547 > linkage specification must be at global scope +## Remarks + The linkage specifier is declared at local scope. +## Example + The following sample generates C2598: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md index e2a970b0c4b..71a706d08d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md @@ -10,10 +10,14 @@ ms.assetid: 88515f36-7589-47e2-862e-0de8b18d6668 > 'enum' : forward declaration of enum type is not allowed +## Remarks + The compiler no longer supports forward declaration of a managed enumeration. Forward declaration of an enum type is not allowed under [/Za](../../build/reference/za-ze-disable-language-extensions.md). +## Example + The following sample generates C2599: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md index e57b37e3c47..2377173869d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md @@ -10,10 +10,14 @@ ms.assetid: cce11943-ea01-4bee-a7b0-b67d24ec6493 > 'function' : cannot define a compiler-generated special member function (must be declared in the class first) +## Remarks + Before member functions such as constructors or destructors can be defined for a class, they must be declared in the class. The compiler can generate default constructors and destructors (called special member functions) if none are declared in the class. However, if you define one of these functions without a matching declaration in the class, the compiler detects a conflict. To fix this error, in the class declaration, declare each member function that you define outside the class declaration. +## Example + The following sample generates C2600: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md index ebf89c4a8d8..9d31fc7a1e0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md @@ -10,8 +10,12 @@ ms.assetid: 6c07a40e-537e-4954-b5c5-1e0e58fe1952 > 'class::Identifier' is not a member of a base class of 'class' +## Remarks + `Identifier` cannot be accessed because it is not a member inherited from any base class. +## Example + The following sample generates C2602: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2603.md b/docs/error-messages/compiler-errors-2/compiler-error-c2603.md index c66a5ff3e1c..81a653f3a70 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2603.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2603.md @@ -10,6 +10,8 @@ ms.assetid: 9ca520d0-f082-4b65-933d-17c3bcf8b02c > '*function*' : Too many block scope static objects with constructor/destructors in function +## Remarks + In versions of the Microsoft C++ compiler before Visual Studio 2015, or when the [/Zc:threadSafeInit-](../../build/reference/zc-threadsafeinit-thread-safe-local-static-initialization.md) compiler option is specified, there is a limit of 31 on the number of static objects you can have in an externally visible inline function. To resolve this issue, we recommend you adopt more recent version of the Microsoft C++ compiler toolset, or if possible, remove the /Zc:threadSafeInit- compiler option. If this is not possible, consider combining your static objects. If the objects are of the same type, consider use of a single static array of that type, and reference individual members as required. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md index 9ce7c9cf136..635e018ec32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md @@ -10,6 +10,8 @@ ms.assetid: a0e6f132-5acf-4e19-b277-ddf196d182bf > 'name' : this method is reserved within a managed or WinRT class +## Remarks + Certain names are reserved by the compiler for internal functions. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). ## Example From 812dbe0b8af0b1e07b5ef4b2cd717705ed66ad02 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 18:23:25 +0800 Subject: [PATCH 0594/1799] Replace term "sample" with "example" for error references in range [C2581, C2610] --- docs/error-messages/compiler-errors-2/compiler-error-c2581.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2582.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2584.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2586.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2587.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2588.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2589.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2593.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2594.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2597.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2598.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2599.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2600.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2602.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2605.md | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md index 8ba27538096..752ff03597f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md @@ -16,7 +16,7 @@ The assignment (`=`) operator is incorrectly declared as **`static`**. Assignmen ## Example -The following sample generates C2581. +The following example generates C2581. ```cpp // C2581.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md index 5c6c69f0b1b..6c656c04c2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md @@ -16,7 +16,7 @@ An attempt was made to assign to an object that does not have an assignment oper ## Example -The following sample generates C2582: +The following example generates C2582: ```cpp // C2582.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md index e17ad5bb8e1..91e968e3387 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md @@ -16,7 +16,7 @@ ms.assetid: 836e2c0a-86c0-4742-b432-beb0191ad20e ## Example -The following sample generates C2584. +The following example generates C2584. ```cpp // C2584.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md index 1fc9cf28c71..70c18f83de9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md @@ -16,7 +16,7 @@ Indirection of a conversion operator is not allowed. ## Example -The following sample generates C2586: +The following example generates C2586: ```cpp // c2586.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md index 92d214cc1a0..a70bbab981b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md @@ -16,7 +16,7 @@ Local variables are not allowed as default parameters. ## Example -The following sample generates C2587: +The following example generates C2587: ```cpp // C2587.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md index ca7c81a2301..4fc0aac25ab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md @@ -18,7 +18,7 @@ This error can be caused by a missing class, structure, or union name on the lef ## Example -The following sample generates C2588: +The following example generates C2588: ```cpp // C2588.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md index e2e291b566f..cfe6404b42c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md @@ -18,7 +18,7 @@ The scope-resolution operator cannot be overloaded. ## Example -The following sample generates C2589: +The following example generates C2589: ```cpp // C2589.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md index 1c6b265ad93..b1731e7dcbb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md @@ -18,7 +18,7 @@ This error may be fixed if you use an explicit cast on one or more actual parame ## Examples -The following sample generates C2593: +The following example generates C2593: ```cpp // C2593.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md index 1e218bf85d6..e2e6c88017d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md @@ -16,7 +16,7 @@ No conversion from *type1* to *type2* was more direct than any other. We suggest ## Example -The following sample generates C2594. The suggested resolution to the error is a sequence of conversions: +The following example generates C2594. The suggested resolution to the error is a sequence of conversions: ```cpp // C2594.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md index f87638db0c9..7e498a0a86f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md @@ -22,7 +22,7 @@ Possible causes: ## Example -1. The following sample generates C2597 and shows how to fix it: +1. The following example generates C2597 and shows how to fix it: ```cpp // C2597.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md index 032e9ee4dc2..7ae9783e6fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md @@ -16,7 +16,7 @@ The linkage specifier is declared at local scope. ## Example -The following sample generates C2598: +The following example generates C2598: ```cpp // C2598.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md index 71a706d08d5..268b2f0a21b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md @@ -18,7 +18,7 @@ Forward declaration of an enum type is not allowed under [/Za](../../build/refer ## Example -The following sample generates C2599: +The following example generates C2599: ```cpp // C2599.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md index 2377173869d..9afbef58abf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md @@ -18,7 +18,7 @@ To fix this error, in the class declaration, declare each member function that y ## Example -The following sample generates C2600: +The following example generates C2600: ```cpp // C2600.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md index 9d31fc7a1e0..c4c3c71ec2c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md @@ -16,7 +16,7 @@ ms.assetid: 6c07a40e-537e-4954-b5c5-1e0e58fe1952 ## Example -The following sample generates C2602: +The following example generates C2602: ```cpp // C2602.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md index 635e018ec32..045432c28cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md @@ -16,7 +16,7 @@ Certain names are reserved by the compiler for internal functions. For more inf ## Example -The following sample generates C2605. +The following example generates C2605. ```cpp // C2605.cpp From a2914fa550b6ad85976d0a50cbf2ca4e3b05cfe3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 1 Aug 2025 18:26:23 +0800 Subject: [PATCH 0595/1799] Update metadata for error references in range [C2581, C2610] --- .../error-messages/compiler-errors-2/compiler-error-c2581.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2582.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2584.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2585.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2586.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2587.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2588.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2589.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2592.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2593.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2594.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2597.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2598.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2599.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2600.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2602.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2603.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2605.md | 5 ++--- 18 files changed, 36 insertions(+), 54 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md index 752ff03597f..9097b0b6b34 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2581" title: "Compiler Error C2581" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2581" +ms.date: 11/04/2016 f1_keywords: ["C2581"] helpviewer_keywords: ["C2581"] -ms.assetid: 24a4e4c1-24d3-4e42-b760-7dcaf9740b16 --- # Compiler Error C2581 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md index 6c656c04c2a..2a57df672e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2582" title: "Compiler Error C2582" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2582" +ms.date: 11/04/2016 f1_keywords: ["C2582"] helpviewer_keywords: ["C2582"] -ms.assetid: ee1b9378-8bcd-4792-b87e-6d7a466d29ed --- # Compiler Error C2582 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md index 91e968e3387..8164ce8b38c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2584" title: "Compiler Error C2584" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2584" +ms.date: 11/04/2016 f1_keywords: ["C2584"] helpviewer_keywords: ["C2584"] -ms.assetid: 836e2c0a-86c0-4742-b432-beb0191ad20e --- # Compiler Error C2584 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2585.md b/docs/error-messages/compiler-errors-2/compiler-error-c2585.md index d9924073e82..32c34f271a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2585.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2585.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2585" title: "Compiler Error C2585" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2585" +ms.date: 11/04/2016 f1_keywords: ["C2585"] helpviewer_keywords: ["C2585"] -ms.assetid: 05bb1a9c-28fb-4a88-a1b5-aea85ebdee1c --- # Compiler Error C2585 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md index 70c18f83de9..412a45f14d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2586" title: "Compiler Error C2586" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2586" +ms.date: 11/04/2016 f1_keywords: ["C2586"] helpviewer_keywords: ["C2586"] -ms.assetid: dae703c7-5c38-4db6-8411-4d1b22713eb5 --- # Compiler Error C2586 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md index a70bbab981b..f70167f35f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2587" title: "Compiler Error C2587" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2587" +ms.date: 11/04/2016 f1_keywords: ["C2587"] helpviewer_keywords: ["C2587"] -ms.assetid: 7637a2c7-35d4-4b5a-a8f2-515a7bda98fd --- # Compiler Error C2587 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md index 4fc0aac25ab..774f364b96c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2588" title: "Compiler Error C2588" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2588" +ms.date: 11/04/2016 f1_keywords: ["C2588"] helpviewer_keywords: ["C2588"] -ms.assetid: 19a0cabd-ca13-44a5-9be3-ee676abf9bc4 --- # Compiler Error C2588 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md index cfe6404b42c..3f7e4fa6da6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2589" title: "Compiler Error C2589" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2589" +ms.date: 11/04/2016 f1_keywords: ["C2589"] helpviewer_keywords: ["C2589"] -ms.assetid: 1d7942c7-8a81-4bb4-b272-76a0019e8513 --- # Compiler Error C2589 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2592.md b/docs/error-messages/compiler-errors-2/compiler-error-c2592.md index 2f168e28862..054f08281e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2592.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2592.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2592" title: "Compiler Error C2592" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2592" +ms.date: 11/04/2016 f1_keywords: ["C2592"] helpviewer_keywords: ["C2592"] -ms.assetid: 833a4d7b-66ef-4d4c-ae83-a533c2b0eb07 --- # Compiler Error C2592 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md index b1731e7dcbb..b31ff336de4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2593" title: "Compiler Error C2593" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2593" +ms.date: 11/04/2016 f1_keywords: ["C2593"] helpviewer_keywords: ["C2593"] -ms.assetid: 4a0fe9bb-2163-447d-91f6-1890ed8250f6 --- # Compiler Error C2593 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md index e2e6c88017d..c962231113f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2594" title: "Compiler Error C2594" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2594" +ms.date: 11/04/2016 f1_keywords: ["C2594"] helpviewer_keywords: ["C2594"] -ms.assetid: 68cd708f-266e-44b0-a211-3e3ab63b11bf --- # Compiler Error C2594 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md index 7e498a0a86f..ed1bcf191ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2597" title: "Compiler Error C2597" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2597" +ms.date: 11/04/2016 f1_keywords: ["C2597"] helpviewer_keywords: ["C2597"] -ms.assetid: 2e48127d-e3ff-4a40-8156-2863e45b1a38 --- # Compiler Error C2597 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md index 7ae9783e6fa..9e996c4837a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2598" title: "Compiler Error C2598" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2598" +ms.date: 11/04/2016 f1_keywords: ["C2598"] helpviewer_keywords: ["C2598"] -ms.assetid: 40777c62-39ba-441e-b081-f49f94b43547 --- # Compiler Error C2598 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md index 268b2f0a21b..56a13a45eeb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2599" title: "Compiler Error C2599" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2599" +ms.date: 11/04/2016 f1_keywords: ["C2599"] helpviewer_keywords: ["C2599"] -ms.assetid: 88515f36-7589-47e2-862e-0de8b18d6668 --- # Compiler Error C2599 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md index 9afbef58abf..63dcc2d64a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2600" title: "Compiler Error C2600" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2600" +ms.date: 11/04/2016 f1_keywords: ["C2600"] helpviewer_keywords: ["C2600"] -ms.assetid: cce11943-ea01-4bee-a7b0-b67d24ec6493 --- # Compiler Error C2600 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md index c4c3c71ec2c..bc32d316af0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2602" title: "Compiler Error C2602" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2602" +ms.date: 11/04/2016 f1_keywords: ["C2602"] helpviewer_keywords: ["C2602"] -ms.assetid: 6c07a40e-537e-4954-b5c5-1e0e58fe1952 --- # Compiler Error C2602 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2603.md b/docs/error-messages/compiler-errors-2/compiler-error-c2603.md index 81a653f3a70..c4700923f0f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2603.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2603.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2603" title: "Compiler Error C2603" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2603" +ms.date: 11/04/2016 f1_keywords: ["C2603"] helpviewer_keywords: ["C2603"] -ms.assetid: 9ca520d0-f082-4b65-933d-17c3bcf8b02c --- # Compiler Error C2603 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md index 045432c28cc..ee73a6aa642 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2605" title: "Compiler Error C2605" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2605" +ms.date: 11/04/2016 f1_keywords: ["C2605"] helpviewer_keywords: ["C2605"] -ms.assetid: a0e6f132-5acf-4e19-b277-ddf196d182bf --- # Compiler Error C2605 From 52bb410368e1f770f531145de5028c9284499628 Mon Sep 17 00:00:00 2001 From: Mark Rotteveel Date: Fri, 1 Aug 2025 12:43:44 +0200 Subject: [PATCH 0596/1799] Add missing anchors to specific guideline --- docs/code-quality/c26433.md | 4 ++-- docs/code-quality/c26434.md | 2 +- docs/code-quality/c26435.md | 2 +- docs/code-quality/c26443.md | 4 ++-- docs/code-quality/code-analysis-for-cpp-corecheck.md | 6 +++--- 5 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/code-quality/c26433.md b/docs/code-quality/c26433.md index 31a482a9743..20d866f966d 100644 --- a/docs/code-quality/c26433.md +++ b/docs/code-quality/c26433.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26433"] ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) It's not required by the compiler to clearly state that a virtual function overrides its base. Not specifying `override` can cause subtle issues during maintenance if the virtual specification ever changes in the class hierarchy. It also lowers readability and makes an interface's polymorphic behavior less obvious. If a function is clearly marked as `override`, the compiler can check the consistency of the interface, and help to spot issues before they manifest themselves at run time. @@ -44,4 +44,4 @@ public: ## See also -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) diff --git a/docs/code-quality/c26434.md b/docs/code-quality/c26434.md index 03e26c7b2f8..197a57cbcf8 100644 --- a/docs/code-quality/c26434.md +++ b/docs/code-quality/c26434.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26434"] ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) ## Remarks diff --git a/docs/code-quality/c26435.md b/docs/code-quality/c26435.md index ec4fd01356e..61b57161dc4 100644 --- a/docs/code-quality/c26435.md +++ b/docs/code-quality/c26435.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26435"] ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) To improve readability, the kind of virtual behavior should be stated clearly and without unnecessary redundancy. Even though multiple virtual specifiers can be used simultaneously, it's better to specify one at a time to emphasize the most important aspect of virtual behavior. The following order of importance is apparent: diff --git a/docs/code-quality/c26443.md b/docs/code-quality/c26443.md index 5b9b55f44b2..e07e15b419b 100644 --- a/docs/code-quality/c26443.md +++ b/docs/code-quality/c26443.md @@ -13,7 +13,7 @@ This warning was removed in Visual Studio 16.8 to reflect [changes to C.128 in t ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). The current consensus on the Core Guidelines is to exclude destructors from the 'override explicitly' recommendation. @@ -44,4 +44,4 @@ public: ## See also -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) diff --git a/docs/code-quality/code-analysis-for-cpp-corecheck.md b/docs/code-quality/code-analysis-for-cpp-corecheck.md index 63877154bae..b5baf2cc339 100644 --- a/docs/code-quality/code-analysis-for-cpp-corecheck.md +++ b/docs/code-quality/code-analysis-for-cpp-corecheck.md @@ -115,7 +115,7 @@ Global initializer calls a non-constexpr function '*symbol*'. See [C++ Core Guid Global initializer accesses extern object '*symbol*'. See [C++ Core Guidelines I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i22-avoid-complex-initialization-of-global-objects). [C26444 NO_UNNAMED_RAII_OBJECTS](c26444.md)\ -Avoid unnamed objects with custom construction and destruction. See [ES.84: Don't (try to) declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). +Avoid unnamed objects with custom construction and destruction. See [ES.84: Don't (try to) declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-noname). ## CLASS Group @@ -129,13 +129,13 @@ Function '*symbol*' should be marked with 'override'. See [C.128: Virtual functi Function '*symbol_1*' hides a non-virtual function '*symbol_2*'. See [C++ Core Guidelines C.128](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final). [C26435 SINGLE_VIRTUAL_SPECIFICATION](c26435.md)\ -Function '*symbol*' should specify exactly one of 'virtual', 'override', or 'final'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). +Function '*symbol*' should specify exactly one of 'virtual', 'override', or 'final'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). [C26436 NEED_VIRTUAL_DTOR](C26436.md)\ The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor. See [C++ Core Guidelines C.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-nonvirtual). [C26443 NO_EXPLICIT_DTOR_OVERRIDE](c26443.md)\ -Overriding destructor should not use explicit 'override' or 'virtual' specifiers. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). +Overriding destructor should not use explicit 'override' or 'virtual' specifiers. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). ## STYLE Group From 7b5d19e92a10f5f874d57dce226ce5a6ab1a3968 Mon Sep 17 00:00:00 2001 From: Mark Rotteveel Date: Sat, 2 Aug 2025 10:39:27 +0200 Subject: [PATCH 0597/1799] Replace generated IDs with explicit IDs Also replaced some explicit IDs with more specific explicit IDs for Bounds.N and Type.N (to the specific rule, instead of the section containing the rule). --- docs/code-quality/c26400.md | 2 +- docs/code-quality/c26401.md | 2 +- docs/code-quality/c26403.md | 2 +- docs/code-quality/c26405.md | 2 +- docs/code-quality/c26406.md | 2 +- docs/code-quality/c26407.md | 2 +- docs/code-quality/c26408.md | 2 +- docs/code-quality/c26409.md | 2 +- docs/code-quality/c26410.md | 4 +- docs/code-quality/c26411.md | 2 +- docs/code-quality/c26414.md | 2 +- docs/code-quality/c26415.md | 2 +- docs/code-quality/c26416.md | 2 +- docs/code-quality/c26417.md | 2 +- docs/code-quality/c26418.md | 2 +- docs/code-quality/c26426.md | 2 +- docs/code-quality/c26427.md | 2 +- docs/code-quality/c26429.md | 2 +- docs/code-quality/c26430.md | 2 +- docs/code-quality/c26431.md | 2 +- docs/code-quality/c26432.md | 2 +- docs/code-quality/c26436.md | 2 +- docs/code-quality/c26437.md | 2 +- docs/code-quality/c26438.md | 2 +- docs/code-quality/c26439.md | 4 +- docs/code-quality/c26440.md | 2 +- docs/code-quality/c26441.md | 2 +- docs/code-quality/c26444.md | 4 +- docs/code-quality/c26445.md | 2 +- docs/code-quality/c26446.md | 2 +- docs/code-quality/c26447.md | 2 +- docs/code-quality/c26449.md | 2 +- docs/code-quality/c26450.md | 2 +- docs/code-quality/c26452.md | 4 +- docs/code-quality/c26453.md | 4 +- docs/code-quality/c26454.md | 2 +- docs/code-quality/c26455.md | 2 +- docs/code-quality/c26456.md | 2 +- docs/code-quality/c26457.md | 2 +- docs/code-quality/c26462.md | 2 +- docs/code-quality/c26463.md | 2 +- docs/code-quality/c26464.md | 2 +- docs/code-quality/c26472.md | 2 +- docs/code-quality/c26473.md | 2 +- docs/code-quality/c26474.md | 2 +- docs/code-quality/c26475.md | 2 +- docs/code-quality/c26478.md | 2 +- docs/code-quality/c26479.md | 4 +- docs/code-quality/c26482.md | 2 +- docs/code-quality/c26483.md | 2 +- docs/code-quality/c26490.md | 2 +- docs/code-quality/c26491.md | 2 +- docs/code-quality/c26492.md | 2 +- docs/code-quality/c26493.md | 2 +- docs/code-quality/c26494.md | 4 +- docs/code-quality/c26495.md | 2 +- docs/code-quality/c26496.md | 2 +- docs/code-quality/c26498.md | 4 +- docs/code-quality/c26812.md | 2 +- docs/code-quality/c26815.md | 2 +- docs/code-quality/c26816.md | 2 +- docs/code-quality/c26817.md | 2 +- docs/code-quality/c26818.md | 2 +- docs/code-quality/c26819.md | 4 +- docs/code-quality/c26820.md | 2 +- docs/code-quality/c26826.md | 2 +- .../code-analysis-for-cpp-corecheck.md | 84 +++++++++---------- 67 files changed, 117 insertions(+), 117 deletions(-) diff --git a/docs/code-quality/c26400.md b/docs/code-quality/c26400.md index 99711c0b89c..e4819ceeaaf 100644 --- a/docs/code-quality/c26400.md +++ b/docs/code-quality/c26400.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26400"] ## Remarks -This check helps to enforce the *rule I.11: Never transfer ownership by a raw pointer (T\*), which is a subset of the rule *R.3: A raw pointer (a T\*) is non-owning*. Specifically, it warns on any call to `operator new`, which saves its result in a variable of raw pointer type. It also warns on calls to functions that return `gsl::owner` if their results are assigned to raw pointers. The idea is that you should clearly state ownership of memory resources. For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). +This check helps to enforce the *rule I.11: Never transfer ownership by a raw pointer (T\*), which is a subset of the rule *R.3: A raw pointer (a T\*) is non-owning*. Specifically, it warns on any call to `operator new`, which saves its result in a variable of raw pointer type. It also warns on calls to functions that return `gsl::owner` if their results are assigned to raw pointers. The idea is that you should clearly state ownership of memory resources. For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-resource). The easiest way to fix this warning is to use **`auto`** declaration if the resource is assigned immediately at the variable declaration. If this fix isn't possible, then we suggest that you use the type `gsl::owner`. The **`auto`** declarations initialized with operator **`new`** are "owners" because we assume that the result of any allocation is implicitly an owner pointer. We transfer this assumption to the **`auto`** variable and treat it as `owner`. diff --git a/docs/code-quality/c26401.md b/docs/code-quality/c26401.md index c8b4c50b84d..0029e443d56 100644 --- a/docs/code-quality/c26401.md +++ b/docs/code-quality/c26401.md @@ -20,7 +20,7 @@ Code analysis name: `DONT_DELETE_NON_OWNER` ## See also -[C++ Core Guidelines I.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i11-never-transfer-ownership-by-a-raw-pointer-t-or-reference-t) +[C++ Core Guidelines I.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-raw) ## Examples diff --git a/docs/code-quality/c26403.md b/docs/code-quality/c26403.md index 70f1e92ac51..801e33dce9a 100644 --- a/docs/code-quality/c26403.md +++ b/docs/code-quality/c26403.md @@ -12,7 +12,7 @@ ms.assetid: 7e14868d-df86-4df3-98d3-71b1e80ba14e Owner pointers are like unique pointers: they own a resource exclusively, and manage release of the resource, or its transfers to other owners. This check validates that a local owner pointer properly maintains its resource through all execution paths in a function. If the resource wasn't transferred to another owner, or wasn't explicitly release, the checker warns, and points to the declaration of the pointer variable. -For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). +For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-resource). ## Remarks diff --git a/docs/code-quality/c26405.md b/docs/code-quality/c26405.md index 4384443ba29..8c8d2b45eb6 100644 --- a/docs/code-quality/c26405.md +++ b/docs/code-quality/c26405.md @@ -12,7 +12,7 @@ ms.assetid: 2034d961-3ec5-4184-bbef-aa792e4c03c0 ## Remarks -If an owner pointer already points to a valid memory buffer, it must not be assigned to another value without releasing its current resource first. Such assignment may lead to a resource leak even if the resource address is copied into some raw pointer (because raw pointers shouldn't release resources). For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r3-a-raw-pointer-a-t-is-non-owning). +If an owner pointer already points to a valid memory buffer, it must not be assigned to another value without releasing its current resource first. Such assignment may lead to a resource leak even if the resource address is copied into some raw pointer (because raw pointers shouldn't release resources). For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). Code analysis name: `DONT_ASSIGN_TO_VALID` diff --git a/docs/code-quality/c26406.md b/docs/code-quality/c26406.md index 0e4688cdc28..3027afd7284 100644 --- a/docs/code-quality/c26406.md +++ b/docs/code-quality/c26406.md @@ -10,7 +10,7 @@ ms.assetid: 02fb8e23-1989-4e24-a5a5-e30f71d00325 > Do not assign a raw pointer to an `owner` (r.3) -This warning enforces R.3 from the C++ Core Guidelines. For more information, see [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r3-a-raw-pointer-a-t-is-non-owning). +This warning enforces R.3 from the C++ Core Guidelines. For more information, see [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). ## Remarks diff --git a/docs/code-quality/c26407.md b/docs/code-quality/c26407.md index 0a5af3152a4..79022356f01 100644 --- a/docs/code-quality/c26407.md +++ b/docs/code-quality/c26407.md @@ -10,7 +10,7 @@ ms.assetid: 5539907a-bfa0-40db-82a6-b860c97209e1 > Prefer scoped objects, don't heap-allocate unnecessarily (r.5) -To avoid unnecessary use of pointers, we try to detect common patterns of local allocations. For example, we detect when the result of a call to operator **`new`** is stored in a local variable and later explicitly deleted. This check supports the [C++ Core Guidelines rule R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r5-prefer-scoped-objects-dont-heap-allocate-unnecessarily): *Prefer scoped objects, don't heap-allocate unnecessarily*. To fix the issue, use an RAII type instead of a raw pointer, and allow it to deal with resources. Obviously, it isn't necessary to create a wrapper type to allocate a single object. Instead, a local variable of the object's type would work better. +To avoid unnecessary use of pointers, we try to detect common patterns of local allocations. For example, we detect when the result of a call to operator **`new`** is stored in a local variable and later explicitly deleted. This check supports the [C++ Core Guidelines rule R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped): *Prefer scoped objects, don't heap-allocate unnecessarily*. To fix the issue, use an RAII type instead of a raw pointer, and allow it to deal with resources. Obviously, it isn't necessary to create a wrapper type to allocate a single object. Instead, a local variable of the object's type would work better. ## Remarks diff --git a/docs/code-quality/c26408.md b/docs/code-quality/c26408.md index c426b63f2a1..423b99d972a 100644 --- a/docs/code-quality/c26408.md +++ b/docs/code-quality/c26408.md @@ -22,7 +22,7 @@ Code analysis name: `NO_MALLOC_FREE` ## See also -[C++ Core Guidelines R.10](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r10-avoid-malloc-and-free) +[C++ Core Guidelines R.10](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-mallocfree) ## Example diff --git a/docs/code-quality/c26409.md b/docs/code-quality/c26409.md index a0dc4a4f3da..459ce8cf922 100644 --- a/docs/code-quality/c26409.md +++ b/docs/code-quality/c26409.md @@ -12,7 +12,7 @@ helpviewer_keywords: ["C26409"] Even if code is clean of calls to `malloc` and `free`, we still suggest that you consider better options than explicit use of operators [`new` and `delete`](../cpp/new-and-delete-operators.md). **C++ Core Guidelines**:\ -[R.11: Avoid calling `new` and `delete` explicitly](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r11-avoid-calling-new-and-delete-explicitly) +[R.11: Avoid calling `new` and `delete` explicitly](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-newdelete) The ultimate fix is to use smart pointers and appropriate factory functions, such as [`std::make_unique`](../standard-library/memory-functions.md#make_unique). diff --git a/docs/code-quality/c26410.md b/docs/code-quality/c26410.md index 57e0b75a4c7..6a8429c1ec5 100644 --- a/docs/code-quality/c26410.md +++ b/docs/code-quality/c26410.md @@ -10,11 +10,11 @@ ms.assetid: d1547faf-96c6-48da-90f5-841154d0e878 > The parameter '*parameter*' is a reference to const unique pointer, use `const T*` or `const T&` instead (r.32) -Generally, references to const unique pointer are meaningless. They can safely be replaced by a raw reference or a pointer. This warning enforces [C++ Core Guidelines rule R.32](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r32-take-a-unique_ptrwidget-parameter-to-express-that-a-function-assumes-ownership-of-a-widget). +Generally, references to const unique pointer are meaningless. They can safely be replaced by a raw reference or a pointer. This warning enforces [C++ Core Guidelines rule R.32](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-uniqueptrparam). ## Remarks -- Unique pointer checks have rather broad criteria to identify smart pointers. The [C++ Core Guidelines rule R.31](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r31-if-you-have-non-std-smart-pointers-follow-the-basic-pattern-from-std): *If you have non-std smart pointers, follow the basic pattern from std describes the unique pointer and shared pointer concepts*. The heuristic is simple, but may lead to surprises: a smart pointer type is any type that defines either `operator->` or `operator*`. A copy-able type (shared pointer) must have either a public copy constructor or an overloaded assignment operator that deals with a non-Rvalue reference parameter. +- Unique pointer checks have rather broad criteria to identify smart pointers. The [C++ Core Guidelines rule R.31](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-smart): *If you have non-std smart pointers, follow the basic pattern from std describes the unique pointer and shared pointer concepts*. The heuristic is simple, but may lead to surprises: a smart pointer type is any type that defines either `operator->` or `operator*`. A copy-able type (shared pointer) must have either a public copy constructor or an overloaded assignment operator that deals with a non-Rvalue reference parameter. - Template code may produce noisy warnings. Keep in mind that templates can be instantiated with various type parameters with different levels of indirection, including references. Some warnings may not be obvious and fixes may require some rework of templates (for example, explicit removal of reference indirection). If template code is intentionally generic, the warning can be suppressed. diff --git a/docs/code-quality/c26411.md b/docs/code-quality/c26411.md index e4dd8959324..cf66a21b4de 100644 --- a/docs/code-quality/c26411.md +++ b/docs/code-quality/c26411.md @@ -10,7 +10,7 @@ ms.assetid: 5134e51e-8b92-4ee7-94c3-022e318a0e24 > The parameter '*parameter*' is a reference to unique pointer and it is never reassigned or reset, use `T*` or `T&` instead (r.33) -When you pass a unique pointer to a function by reference, it implies that its resource may be released or transferred inside the function. If the function uses its parameter only to access the resource, it's safe to pass a raw pointer or a reference. For more information, see [C++ Core Guidelines rule R.33](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r33-take-a-unique_ptrwidget-parameter-to-express-that-a-function-reseats-thewidget): *Take a unique_ptr\& parameter to express that a function reseats the widget*. +When you pass a unique pointer to a function by reference, it implies that its resource may be released or transferred inside the function. If the function uses its parameter only to access the resource, it's safe to pass a raw pointer or a reference. For more information, see [C++ Core Guidelines rule R.33](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-reseat): *Take a unique_ptr\& parameter to express that a function reseats the widget*. ## Remarks diff --git a/docs/code-quality/c26414.md b/docs/code-quality/c26414.md index d33427adcbe..704a57d4e80 100644 --- a/docs/code-quality/c26414.md +++ b/docs/code-quality/c26414.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["C26414"] > "Move, copy, reassign or reset a local smart pointer." **C++ Core Guidelines**:\ -[R.5: Prefer scoped objects, don't heap-allocate unnecessarily](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r5-prefer-scoped-objects-dont-heap-allocate-unnecessarily) +[R.5: Prefer scoped objects, don't heap-allocate unnecessarily](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped) Smart pointers are convenient for dynamic resource management, but they're not always necessary. For example, it may be easier and more efficient to manage a local dynamic buffer by using a standard container. You may not need dynamic allocation at all for single objects, for example, if they never outlive their creator function. They can be replaced with local variables. Smart pointers become handy when a scenario requires a change of ownership. For example, when you reassign a dynamic resource multiple times, or in multiple paths. They're also useful for resources obtained from external code. And, when smart pointers are used to extend the lifetime of a resource. diff --git a/docs/code-quality/c26415.md b/docs/code-quality/c26415.md index 5438faa1ebd..93c445fc29c 100644 --- a/docs/code-quality/c26415.md +++ b/docs/code-quality/c26415.md @@ -11,7 +11,7 @@ ms.assetid: 4165f70a-78ae-4a03-b256-c4bd74b02d09 > Smart pointer parameter is used only to access contained pointer. Use T* or T& instead. **C++ Core Guidelines**: -[R.30](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r30-take-smart-pointers-as-parameters-only-to-explicitly-express-lifetime-semantics): Take smart pointers as parameters only to explicitly express lifetime semantics +[R.30](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-smartptrparam): Take smart pointers as parameters only to explicitly express lifetime semantics Using a smart pointer type to pass data to a function indicates that the target function needs to manage the lifetime of the contained object. However, say the function only uses the smart pointer to access the contained object and never actually calls any code that may lead to its deallocation (that is, never affects its lifetime). Then there's usually no need to complicate the interface with smart pointers. A plain pointer or reference to the contained object is preferred. diff --git a/docs/code-quality/c26416.md b/docs/code-quality/c26416.md index 658adfea026..c658471dc4d 100644 --- a/docs/code-quality/c26416.md +++ b/docs/code-quality/c26416.md @@ -11,7 +11,7 @@ ms.assetid: f158207b-45cf-44cf-8e4b-b5b75b56ea0e > Shared pointer parameter is passed by rvalue reference. Pass by value instead. **C++ Core Guidelines**: -[R.34](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r34-take-a-shared_ptrwidget-parameter-to-express-that-a-function-is-part-owner): Take a shared_ptr\ parameter to express that a function is part owner +[R.34](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam-owner): Take a shared_ptr\ parameter to express shared ownership Passing a shared pointer by rvalue reference is rarely necessary. Unless it's an implementation of move semantics for a shared pointer type itself, shared pointer objects can be safely passed by value. Using rvalue reference may be also an indication that unique pointer is more appropriate since it clearly transfers unique ownership from caller to callee. diff --git a/docs/code-quality/c26417.md b/docs/code-quality/c26417.md index 3ab549beac9..b8138b42abd 100644 --- a/docs/code-quality/c26417.md +++ b/docs/code-quality/c26417.md @@ -11,7 +11,7 @@ ms.assetid: 0e09fcc6-f9eb-4404-b51e-5815705c6afb > Shared pointer parameter is passed by reference and not reset or reassigned. Use T* or T& instead. **C++ Core Guidelines**: -[R.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r35-take-a-shared_ptrwidget-parameter-to-express-that-a-function-might-reseat-the-shared-pointer): Take a shared_ptr\& parameter to express that a function might reseat the shared pointer +[R.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam): Take a shared_ptr\& parameter to express that a function might reseat the shared pointer Passing shared pointers by reference may be useful in scenarios where called code updates the target of the smart pointer object, and its caller expects to see such updates. Using a reference solely to reduce costs of passing a shared pointer is questionable. If called code only accesses the target object and never manages its lifetime, it's safer to pass a raw pointer or reference, rather than to expose resource management details. diff --git a/docs/code-quality/c26418.md b/docs/code-quality/c26418.md index 30c44cf0d11..d29c62c8656 100644 --- a/docs/code-quality/c26418.md +++ b/docs/code-quality/c26418.md @@ -11,7 +11,7 @@ ms.assetid: d2c84a40-8a5d-4018-92c2-6498cdd9b541 > Shared pointer parameter is not copied or moved. Use T* or T& instead. **C++ Core Guidelines**: -[R.36](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r36-take-a-const-shared_ptrwidget-parameter-to-express-that-it-might-retain-a-reference-count-to-the-object-): Take a const shared_ptr\& parameter to express that it might retain a reference count to the object +[R.36](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam-const): Take a const shared_ptr\& parameter to express that it might retain a reference count to the object If a shared pointer parameter is passed by value or by reference to a constant object, the function is expected to take control of the target object's lifetime without affecting the caller. The code should either copy or move the shared pointer parameter to another shared pointer object, or pass it along to other code by invoking functions that accept shared pointers. Otherwise, a plain pointer or reference may be feasible. diff --git a/docs/code-quality/c26426.md b/docs/code-quality/c26426.md index d889960eee4..15289f08c7c 100644 --- a/docs/code-quality/c26426.md +++ b/docs/code-quality/c26426.md @@ -12,7 +12,7 @@ ms.assetid: 6fb5f6d2-b097-47f8-8b49-f2fd4e9bef0e ## C++ Core Guidelines -[I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i22-avoid-complex-initialization-of-global-objects): Avoid complex initialization of global objects +[I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-global-init): Avoid complex initialization of global objects The order of execution of initializers for global objects may be inconsistent or undefined, which can lead to issues that are hard to reproduce and investigate. To avoid such problems, global initializers shouldn't depend on external code that's executed at run time, and that may depend on data that's not yet initialized. This rule flags cases where global objects call functions to obtain their initial values. diff --git a/docs/code-quality/c26427.md b/docs/code-quality/c26427.md index e71f09e9561..5586e4d46a4 100644 --- a/docs/code-quality/c26427.md +++ b/docs/code-quality/c26427.md @@ -11,7 +11,7 @@ ms.assetid: 8fb95a44-8704-45b1-bc55-eccd59b1db2f > Global initializer accesses extern object '*symbol*' (i.22) **C++ Core Guidelines**: -[I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i22-avoid-complex-initialization-of-global-objects): Avoid complex initialization of global objects +[I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-global-init): Avoid complex initialization of global objects Global objects may be initialized in an inconsistent or undefined order, which means that interdependency between them is risky and should be avoided. This guideline is applicable when initializers refer to another object that's considered to be **`extern`**. diff --git a/docs/code-quality/c26429.md b/docs/code-quality/c26429.md index 96726440aa0..857bffecf9d 100644 --- a/docs/code-quality/c26429.md +++ b/docs/code-quality/c26429.md @@ -11,7 +11,7 @@ ms.assetid: 4e1c74d5-7307-436c-927b-f74ae863282c > Symbol is never tested for nullness, it can be marked as `gsl::not_null`. **C++ Core Guidelines**: -[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a `not_null` to indicate that "null" isn't a valid value +[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr): Use a `not_null` to indicate that "null" is not a valid value It's a common practice to use asserts to enforce assumptions about the validity of pointer values. The problem is, asserts don't expose assumptions through the interface (such as in return types or parameters). Asserts are also harder to maintain and keep in sync with other code changes. The recommendation is to use `gsl::not_null` from the Guidelines Support Library to mark resources that should never have a null value. The rule `USE_NOTNULL` helps to identify places that omit checks for null and hence can be updated to use `gsl::not_null`. diff --git a/docs/code-quality/c26430.md b/docs/code-quality/c26430.md index d417983a038..92fa6af1ec7 100644 --- a/docs/code-quality/c26430.md +++ b/docs/code-quality/c26430.md @@ -11,7 +11,7 @@ ms.assetid: 3dca2626-8102-4eed-8ff3-73eb3d5c328c > Symbol is not tested for nullness on all paths. **C++ Core Guidelines**: -[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a not_null\ to indicate that "null" isn't a valid value +[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr): Use a not_null\ to indicate that "null" is not a valid value If code ever checks pointer variables for null, it should do so consistently and validate pointers on all paths. Sometimes overaggressive checking for null is still better than the possibility of a hard crash in one of the complicated branches. Ideally, such code should be refactored to be less complex (by splitting it into multiple functions), and to rely on markers like `gsl::not_null`. These markers allow the code to isolate parts of the algorithm that can make safe assumptions about valid pointer values. The rule `TEST_ON_ALL_PATHS` helps to find places where null checks are inconsistent (meaning assumptions may require review). Or, it finds actual bugs where a potential null value can bypass null checks in some of the code paths. diff --git a/docs/code-quality/c26431.md b/docs/code-quality/c26431.md index ded200ef169..ae48a3ac66d 100644 --- a/docs/code-quality/c26431.md +++ b/docs/code-quality/c26431.md @@ -11,7 +11,7 @@ ms.assetid: 40be6032-c8de-49ab-8e43-e8eedc0ca0ba > The type of expression '*expr*' is already `gsl::not_null`. Do not test it for nullness (f.23) **C++ Core Guidelines**: -[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a not_null\ to indicate that "null" isn't a valid value +[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr): Use a not_null\ to indicate that "null" is not a valid value The marker type `gsl::not_null` from the Guidelines Support Library is used to clearly indicate values that are never null pointers. It causes a hard failure if the assumption doesn't hold at run time. So, obviously, there's no need to check for null if an expression evaluates to a result of type `gsl::not_null`. diff --git a/docs/code-quality/c26432.md b/docs/code-quality/c26432.md index b9de0b89298..98a45f3475e 100644 --- a/docs/code-quality/c26432.md +++ b/docs/code-quality/c26432.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["C26432"] > `If you define or delete any default operation in the type 'type-name', define or delete them all (c.21).` **C++ Core Guidelines**:\ -[C.21: If you define or `=delete` any copy, move, or destructor function, define or `=delete` them all](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c21-if-you-define-or-delete-any-copy-move-or-destructor-function-define-or-delete-them-all) +[C.21: If you define or `=delete` any copy, move, or destructor function, define or `=delete` them all](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-five) Special operations such as constructors are assumed to alter the behavior of types so they rely more on language mechanisms to automatically enforce specific scenarios. The canonical example is resource management. If you explicitly define, default, or delete any of these special operations, it signals you want to avoid any special handling of a type. It's inconsistent to leave the other operations unspecified, that is, implicitly defined as deleted by the compiler. diff --git a/docs/code-quality/c26436.md b/docs/code-quality/c26436.md index ef07743865b..f2c433854f4 100644 --- a/docs/code-quality/c26436.md +++ b/docs/code-quality/c26436.md @@ -10,7 +10,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines C.35 > The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor (c.35) -[**C++ Core Guidelines**: C.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-non-virtual): A base class destructor should be either public and virtual, or protected and nonvirtual +[**C++ Core Guidelines**: C.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-dtor-virtual): A base class destructor should be either public and virtual, or protected and non-virtual If a class defines a virtual function it becomes polymorphic, which implies that derived classes can change its behavior including resource management and destruction logic. Because client code may call polymorphic types via pointers to base classes, there's no way a client can explicitly choose which behavior is appropriate without downcasting. To make sure that resources are managed consistently and destruction occurs according to the actual type's rules, you should define a public virtual destructor. If the type hierarchy is designed to disallow client code to destroy objects directly, destructors should be defined as protected non-virtual. diff --git a/docs/code-quality/c26437.md b/docs/code-quality/c26437.md index 2f96db0776e..1ec3dbc4327 100644 --- a/docs/code-quality/c26437.md +++ b/docs/code-quality/c26437.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["C26437"] > Do not slice. **C++ Core Guidelines**: -[ES.63: Don't slice](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es63-dont-slice) +[ES.63: Don't slice](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-slice) The language allows [slicing](https://en.wikipedia.org/wiki/Object_slicing) and can be viewed as a special case of a dangerous implicit cast. Even if it's done intentionally and doesn't lead to immediate issues, it's still highly discouraged. It makes code harder to change, by forcing extra requirements on related data types. It's especially true if types are polymorphic or involve resource management. diff --git a/docs/code-quality/c26438.md b/docs/code-quality/c26438.md index 2317d815139..dd7f16b4ebf 100644 --- a/docs/code-quality/c26438.md +++ b/docs/code-quality/c26438.md @@ -11,7 +11,7 @@ ms.assetid: c7b3f59c-fb2f-4816-bda4-0fad23c80d83 > Avoid `goto` (es.76) **C++ Core Guidelines**:\ -[ES.76](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es76-avoid-goto): Avoid goto +[ES.76](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-goto): Avoid goto The use of **`goto`** is widely considered a dangerous and error-prone practice. It's acceptable only in generated code, such as in a parser generated from a grammar. With modern C++ features and utilities provided by the Guidelines Support Library, it should be easy to avoid **`goto`** altogether. diff --git a/docs/code-quality/c26439.md b/docs/code-quality/c26439.md index 85e7499a1e7..385f65ca546 100644 --- a/docs/code-quality/c26439.md +++ b/docs/code-quality/c26439.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26439"] > This kind of function may not throw. Declare it 'noexcept'. -[F.6: If your function must not throw, declare it `noexcept`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-must-not-throw-declare-it-noexcept) +[F.6: If your function must not throw, declare it `noexcept`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept) Some operations should never throw exceptions. Their implementations should be reliable and should handle possible errors conditions gracefully. They shouldn't use exceptions to indicate failure. This rule flags cases where such operations aren't explicitly marked as `noexcept`, which means that they may throw exceptions and consumers can't make assumptions about its reliability. @@ -63,4 +63,4 @@ struct S ## See also [C26455](c26455.md)\ -[F.6: If your function must not throw, declare it `noexcept`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-must-not-throw-declare-it-noexcept) +[F.6: If your function must not throw, declare it `noexcept`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept) diff --git a/docs/code-quality/c26440.md b/docs/code-quality/c26440.md index bf4207b1f02..62a9c87e536 100644 --- a/docs/code-quality/c26440.md +++ b/docs/code-quality/c26440.md @@ -10,7 +10,7 @@ description: CppCoreCheck rule C26440 that enforces C++ Core Guidelines F.6 > Function can be declared 'noexcept'. -[**C++ Core Guidelines** F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept): If your function may not throw, declare it `noexcept` +[**C++ Core Guidelines** F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept): If your function must not throw, declare it `noexcept` If code isn't supposed to cause any exceptions, it should be marked by using the `noexcept` specifier. This annotation helps to simplify error handling on the client code side, and enables the compiler to do more optimizations. diff --git a/docs/code-quality/c26441.md b/docs/code-quality/c26441.md index c2f5dc91b8e..a91a41ff873 100644 --- a/docs/code-quality/c26441.md +++ b/docs/code-quality/c26441.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26441"] ## C++ Core Guidelines -[CP.44: Remember to name your `lock_guard`s and `unique_lock`s](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#cp44-remember-to-name-your-lock_guards-and-unique_locks) +[CP.44: Remember to name your `lock_guard`s and `unique_lock`s](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconc-name) ## Remarks diff --git a/docs/code-quality/c26444.md b/docs/code-quality/c26444.md index cc020442fef..cca16a240be 100644 --- a/docs/code-quality/c26444.md +++ b/docs/code-quality/c26444.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26444"] ## C++ Core Guidelines -[ES.84: Don't try to declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es84-dont-try-to-declare-a-local-variable-with-no-name) +[ES.84: Don't try to declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-noname) An unnamed variable declaration creates a temporary object that is discarded at the end of the statement. Such temporary objects with nontrivial behavior may point to either inefficient code that allocates and immediately throws away resources or to the code that unintentionally ignores nonprimitive data. Sometimes it may also indicate plainly wrong declaration. @@ -46,4 +46,4 @@ void Foo() ## See also [C26441](C26441.md)\ -[ES.84: Don't try to declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es84-dont-try-to-declare-a-local-variable-with-no-name) +[ES.84: Don't try to declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-noname) diff --git a/docs/code-quality/c26445.md b/docs/code-quality/c26445.md index e81beeba280..2269f7e0653 100644 --- a/docs/code-quality/c26445.md +++ b/docs/code-quality/c26445.md @@ -13,7 +13,7 @@ A reference to `gsl::span` or `std::string_view` may be an indication of a lifet ## C++ Core Guidelines -[GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#gslview-views) +[GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-views) This rule catches subtle lifetime issues that may occur in code migrated from standard containers to new span and view types. Such types can be considered as "references to buffers." Using a reference to a span or view creates an extra layer of indirection. Such indirection is often unnecessary and can be confusing for maintainers. Spans are cheap to copy and can be returned by value from function calls. Obviously, such call results should never be referenced. diff --git a/docs/code-quality/c26446.md b/docs/code-quality/c26446.md index c63bb166bf6..c8e7f37213f 100644 --- a/docs/code-quality/c26446.md +++ b/docs/code-quality/c26446.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26446"] > Prefer to use gsl::at() instead of unchecked subscript operator (bounds.4). -C++ Core Guidelines: [Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile). +C++ Core Guidelines: [Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds). ## Remarks diff --git a/docs/code-quality/c26447.md b/docs/code-quality/c26447.md index daf04cf103c..1835053be83 100644 --- a/docs/code-quality/c26447.md +++ b/docs/code-quality/c26447.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["C26447"] > The function is declared `noexcept` but calls function *function_name* that may throw exceptions (f.6). C++ Core Guidelines:\ -[F.6: If your function may not throw, declare it noexcept](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept). +[F.6: If your function must not throw, declare it noexcept](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept). ## Remarks diff --git a/docs/code-quality/c26449.md b/docs/code-quality/c26449.md index 85de9ef0c33..594025669c1 100644 --- a/docs/code-quality/c26449.md +++ b/docs/code-quality/c26449.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26449"] > `gsl::span` or `std::string_view` created from a temporary will be invalid when the temporary is invalidated (gsl.view) -C++ Core Guidelines: [GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#gslview-views). +C++ Core Guidelines: [GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-views). Spans and views are convenient and lightweight types that allow you to reference memory buffers. But they must be used carefully: while their interface looks similar to standard containers, their behavior is more like the behavior of pointers and references. They don't own data and must never be constructed from temporary buffers. This check focuses on cases where source data is temporary, while a span or view isn't. This rule can help to avoid subtle but dangerous mistakes made when legacy code gets modernized and adopts spans or views. There's another check that handles a slightly different scenario involving span references: [C26445 NO_SPAN_REF](c26445.md). diff --git a/docs/code-quality/c26450.md b/docs/code-quality/c26450.md index 66044efb234..2f4d1f351da 100644 --- a/docs/code-quality/c26450.md +++ b/docs/code-quality/c26450.md @@ -47,4 +47,4 @@ long long multiply() [C26452](c26452.md)\ [C26453](c26453.md)\ [C26454](c26454.md)\ -[ES.103: Don't overflow](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es103-dont-overflow) +[ES.103: Don't overflow](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-overflow) diff --git a/docs/code-quality/c26452.md b/docs/code-quality/c26452.md index 0f529f60ce5..14a7f7d7279 100644 --- a/docs/code-quality/c26452.md +++ b/docs/code-quality/c26452.md @@ -41,5 +41,5 @@ unsigned long long combine(unsigned lo, unsigned hi) [C26451](c26451.md)\ [C26453](c26453.md)\ [C26454](c26454.md)\ -[ES.101: Use unsigned types for bit manipulation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es101-use-unsigned-types-for-bit-manipulation)\ -[ES.102: Use signed types for arithmetic](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es102-use-signed-types-for-arithmetic) +[ES.101: Use unsigned types for bit manipulation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-unsigned)\ +[ES.102: Use signed types for arithmetic](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-signed) diff --git a/docs/code-quality/c26453.md b/docs/code-quality/c26453.md index 32a70642096..f7a44f29ab0 100644 --- a/docs/code-quality/c26453.md +++ b/docs/code-quality/c26453.md @@ -43,5 +43,5 @@ void leftshift(int shiftCount) [C26451](c26451.md)\ [C26452](c26452.md)\ [C26454](c26454.md)\ -[ES.101: Use unsigned types for bit manipulation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es101-use-unsigned-types-for-bit-manipulation)\ -[ES.102: Use signed types for arithmetic](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es102-use-signed-types-for-arithmetic) +[ES.101: Use unsigned types for bit manipulation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-unsigned)\ +[ES.102: Use signed types for arithmetic](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-signed) diff --git a/docs/code-quality/c26454.md b/docs/code-quality/c26454.md index 77b21092ec7..59e6c58c517 100644 --- a/docs/code-quality/c26454.md +++ b/docs/code-quality/c26454.md @@ -41,4 +41,4 @@ unsigned int negativeunsigned() [C26451](c26451.md)\ [C26452](c26452.md)\ [C26453](c26453.md)\ -[ES.106: Don't try to avoid negative values by using `unsigned`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es106-dont-try-to-avoid-negative-values-by-using-unsigned) +[ES.106: Don't try to avoid negative values by using `unsigned`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-nonnegative) diff --git a/docs/code-quality/c26455.md b/docs/code-quality/c26455.md index 617f0cedd5d..756871cae8f 100644 --- a/docs/code-quality/c26455.md +++ b/docs/code-quality/c26455.md @@ -23,4 +23,4 @@ Code analysis name: `DEFAULT_CTOR_NOEXCEPT` ## See also [C26439](./c26439.md)\ -[F.6: If your function must not throw, declare it `noexcept`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-must-not-throw-declare-it-noexcept) +[F.6: If your function must not throw, declare it `noexcept`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexceptt) diff --git a/docs/code-quality/c26456.md b/docs/code-quality/c26456.md index d027fb7be16..74456141ad6 100644 --- a/docs/code-quality/c26456.md +++ b/docs/code-quality/c26456.md @@ -21,4 +21,4 @@ Code analysis name: `DONT_HIDE_OPERATORS` ## See also -[C++ Core Guideline c.128](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final) +[C++ Core Guideline c.128](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) diff --git a/docs/code-quality/c26457.md b/docs/code-quality/c26457.md index 45027983705..17430f18309 100644 --- a/docs/code-quality/c26457.md +++ b/docs/code-quality/c26457.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26457"] ## Remarks -Excerpt from the [C++ Core Guideline ES.48](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es48-avoid-casts): +Excerpt from the [C++ Core Guideline ES.48](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-casts): > Never cast to `(void)` to ignore a `[[nodiscard]]` return value. If you deliberately want to discard such a result, first think hard about whether that is really a good idea (there is usually a good reason the author of the function or of the return type used `[[nodiscard]]` in the first place). If you still think it's appropriate and your code reviewer agrees, use `std::ignore =` to turn off the warning which is simple, portable, and easy to grep. diff --git a/docs/code-quality/c26462.md b/docs/code-quality/c26462.md index 376f8616158..8f9adfd83d4 100644 --- a/docs/code-quality/c26462.md +++ b/docs/code-quality/c26462.md @@ -31,4 +31,4 @@ void function1(int* ptr) ## See also -[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). diff --git a/docs/code-quality/c26463.md b/docs/code-quality/c26463.md index 432d73548ef..1da69c4f32e 100644 --- a/docs/code-quality/c26463.md +++ b/docs/code-quality/c26463.md @@ -17,4 +17,4 @@ Code analysis name: `USE_CONST_FOR_ELEMENTS` ## See also -[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). diff --git a/docs/code-quality/c26464.md b/docs/code-quality/c26464.md index f380a3b6548..aa5d02d1284 100644 --- a/docs/code-quality/c26464.md +++ b/docs/code-quality/c26464.md @@ -17,4 +17,4 @@ Code analysis name: `USE_CONST_POINTER_FOR_ELEMENTS` ## See also -[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). diff --git a/docs/code-quality/c26472.md b/docs/code-quality/c26472.md index 814fae7c918..67a2f80fd15 100644 --- a/docs/code-quality/c26472.md +++ b/docs/code-quality/c26472.md @@ -11,7 +11,7 @@ ms.assetid: 51e215a7-0e0a-4e6c-bff1-805bf5b1af29 > Don't use a static_cast for arithmetic conversions. Use brace initialization, `gsl::narrow_cast`, or `gsl::narrow`. **C++ Core Guidelines**: -[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile): Avoid casts +[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-arithmeticcast): Avoid casts This rule helps to find places where static casts are used to convert between integral types. These casts are unsafe because the compiler wouldn't warn if any data loss occurs. Brace initializers are better for the cases where constants are used, and a compiler error is desired. There are also utilities from the Guidelines Support Library that help to describe intentions clearly: diff --git a/docs/code-quality/c26473.md b/docs/code-quality/c26473.md index 6cd55d5897b..410129d326e 100644 --- a/docs/code-quality/c26473.md +++ b/docs/code-quality/c26473.md @@ -11,7 +11,7 @@ ms.assetid: d88aaa57-0003-421f-8377-4e6a5c27f2df > Don't cast between pointer types where the source type and the target type are the same. **C++ Core Guidelines**: -[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile): Avoid casts +[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-identitycast): Avoid casts This rule helps to remove unnecessary or suspicious casts. Obviously, when a type is converted to itself, such a conversion is ineffective. Yet the fact that the cast is used may indicate a subtle design issue or a potential for regression if types change in future. It's always safer to use as few casts as possible. diff --git a/docs/code-quality/c26474.md b/docs/code-quality/c26474.md index ca1e9867418..fd62d069f68 100644 --- a/docs/code-quality/c26474.md +++ b/docs/code-quality/c26474.md @@ -11,7 +11,7 @@ ms.assetid: 1e23a8e6-97fa-47f5-a279-b52aa2efafa4 > Don't cast between pointer types when the conversion could be implicit. **C++ Core Guidelines**:\ -[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile): Avoid casts +[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-implicitpointercast): Avoid casts In some cases, implicit casts between pointer types are safe and don't require you to write a specific cast expression. This rule finds instances of unnecessary casts you can safely remove. diff --git a/docs/code-quality/c26475.md b/docs/code-quality/c26475.md index da0daf01af3..b44baae8a8e 100644 --- a/docs/code-quality/c26475.md +++ b/docs/code-quality/c26475.md @@ -11,7 +11,7 @@ ms.assetid: 4ed71cf8-f155-4961-b4fe-77feb3b880c3 > Do not use function style C-casts. **C++ Core Guidelines**: -[ES.49](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es49-if-you-must-use-a-cast-use-a-named-cast): If you must use a cast, use a named cast +[ES.49](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-casts-named): If you must use a cast, use a named cast Function-style casts (for example, `int(1.1)`) are another form of C-style casts (like `(int)1.1`), which have questionable safety. Specifically, the compiler doesn't try to check if any data loss can occur either in C-casts or in function casts. In both cases, it's better either to avoid casting or to use a braced initializer if possible. If neither works, static casts may be suitable, but it's still better to use utilities from the Guidelines Support Library: diff --git a/docs/code-quality/c26478.md b/docs/code-quality/c26478.md index ddaff2f01b2..47dc1d62bf3 100644 --- a/docs/code-quality/c26478.md +++ b/docs/code-quality/c26478.md @@ -37,4 +37,4 @@ To fix the issue, remove the redundant `std::move`. ## See also -[ES.56: Write `std::move()` only when you need to explicitly move an object to another scope](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es56-write-stdmove-only-when-you-need-to-explicitly-move-an-object-to-another-scope) +[ES.56: Write `std::move()` only when you need to explicitly move an object to another scope](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-move) diff --git a/docs/code-quality/c26479.md b/docs/code-quality/c26479.md index 4612d6fea0a..130adb11af8 100644 --- a/docs/code-quality/c26479.md +++ b/docs/code-quality/c26479.md @@ -38,5 +38,5 @@ S foo() ## See also -[F.48: Don't `return std::move(local)`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f48-dont-return-stdmovelocal)\ -[ES.56: Write `std::move()` only when you need to explicitly move an object to another scope](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es56-write-stdmove-only-when-you-need-to-explicitly-move-an-object-to-another-scope) +[F.48: Don't `return std::move(local)`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-return-move-local)\ +[ES.56: Write `std::move()` only when you need to explicitly move an object to another scope](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-move) diff --git a/docs/code-quality/c26482.md b/docs/code-quality/c26482.md index 5f278d80082..9fafb3b9124 100644 --- a/docs/code-quality/c26482.md +++ b/docs/code-quality/c26482.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26482 that enforces C++ Core Guidelines Bounds.2 ## See also -[C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) +[C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arrayindex) ## Example diff --git a/docs/code-quality/c26483.md b/docs/code-quality/c26483.md index 73a447ebd4b..45fb0f24716 100644 --- a/docs/code-quality/c26483.md +++ b/docs/code-quality/c26483.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26483"] ## See also -[C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) +[C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arrayindex) ## Example diff --git a/docs/code-quality/c26490.md b/docs/code-quality/c26490.md index 0a74626fc4a..141a6a19411 100644 --- a/docs/code-quality/c26490.md +++ b/docs/code-quality/c26490.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26490 that enforces C++ Core Guidelines Type.1 ## See also -[C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +[C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). ## Example diff --git a/docs/code-quality/c26491.md b/docs/code-quality/c26491.md index 760762e2bf4..109c4dae5aa 100644 --- a/docs/code-quality/c26491.md +++ b/docs/code-quality/c26491.md @@ -7,4 +7,4 @@ helpviewer_keywords: ["C26491"] --- # Warning C26491 -> Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +> Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-downcast). diff --git a/docs/code-quality/c26492.md b/docs/code-quality/c26492.md index f59114cba8f..33735543dcd 100644 --- a/docs/code-quality/c26492.md +++ b/docs/code-quality/c26492.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26492 that enforces C++ Core Guidelines Type.3 ## See also -[C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +[C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-constcast). ## Example diff --git a/docs/code-quality/c26493.md b/docs/code-quality/c26493.md index 8f93b4f4975..c67d9ffdd55 100644 --- a/docs/code-quality/c26493.md +++ b/docs/code-quality/c26493.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines Type.4 ## See also -[C++ Core Guidelines Type.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +[C++ Core Guidelines Type.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-cstylecast). ## Example diff --git a/docs/code-quality/c26494.md b/docs/code-quality/c26494.md index 7ed21fb0029..447b03a4c41 100644 --- a/docs/code-quality/c26494.md +++ b/docs/code-quality/c26494.md @@ -37,5 +37,5 @@ void function() ## See also -[ES.20: Always initialize an object](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es20-always-initialize-an-object)\ -[Pro.safety: Type-safety profile](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile) +[ES.20: Always initialize an object](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-always)\ +[Pro.safety: Type-safety profile](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type) diff --git a/docs/code-quality/c26495.md b/docs/code-quality/c26495.md index e318171fe73..5bfc3c16854 100644 --- a/docs/code-quality/c26495.md +++ b/docs/code-quality/c26495.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26495"] ## Remarks -A member variable isn't initialized by a constructor or by an initializer. Make sure all variables are initialized by the end of construction. For more information, see C++ Core Guidelines [Type.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type) and [C.48](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c48-prefer-in-class-initializers-to-member-initializers-in-constructors-for-constant-initializers). +A member variable isn't initialized by a constructor or by an initializer. Make sure all variables are initialized by the end of construction. For more information, see C++ Core Guidelines [Type.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-memberinit) and [C.48](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-in-class-initializer). This check is intra-procedural. Whenever there's a function call to a nonconst member function, the check assumes that this member function initializes all of the members. This heuristic can result in missed errors and is in place to avoid false positive results. Moreover, when a member is passed by nonconst reference to a function, the check assumes that the function initializes the member. diff --git a/docs/code-quality/c26496.md b/docs/code-quality/c26496.md index 91c0d1f88b0..9fd6800df5a 100644 --- a/docs/code-quality/c26496.md +++ b/docs/code-quality/c26496.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26496 that enforces C++ Core Guidelines Con.4 ## See also -[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). ## Example diff --git a/docs/code-quality/c26498.md b/docs/code-quality/c26498.md index e4953721454..417a4254275 100644 --- a/docs/code-quality/c26498.md +++ b/docs/code-quality/c26498.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26498"] > The function '*function*' is constexpr, mark variable '*variable*' constexpr if compile-time evaluation is desired (con.5) -This rule helps to enforce [Con.5: Use `constexpr` for values that can be computed at compile time](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con5-use-constexpr-for-values-that-can-be-computed-at-compile-time) in the C++ Core Guidelines. +This rule helps to enforce [Con.5: Use `constexpr` for values that can be computed at compile time](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr) in the C++ Core Guidelines. ## Remarks @@ -60,4 +60,4 @@ void foo() [C26497](c26407.md)\ [C26814](c26814.md)\ -[Con.5: Use `constexpr` for values that can be computed at compile time](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con5-use-constexpr-for-values-that-can-be-computed-at-compile-time) +[Con.5: Use `constexpr` for values that can be computed at compile time](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr) diff --git a/docs/code-quality/c26812.md b/docs/code-quality/c26812.md index 434ffe7fb3e..d7a3ef1038b 100644 --- a/docs/code-quality/c26812.md +++ b/docs/code-quality/c26812.md @@ -47,4 +47,4 @@ Print_color(Product_info::Red); // Error: cannot convert Product_info to int. ## See also -[Enum.3 Prefer enum class over enum](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#enum3-prefer-class-enums-over-plain-enums) +[Enum.3 Prefer enum class over enum](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Renum-class) diff --git a/docs/code-quality/c26815.md b/docs/code-quality/c26815.md index 5a8c319b65f..8778703ae41 100644 --- a/docs/code-quality/c26815.md +++ b/docs/code-quality/c26815.md @@ -78,4 +78,4 @@ void f() { ## See also [C26816](c26816.md)\ -[ES.65: Don't dereference an invalid pointer](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es65-dont-dereference-an-invalid-pointer) +[ES.65: Don't dereference an invalid pointer](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-deref) diff --git a/docs/code-quality/c26816.md b/docs/code-quality/c26816.md index f60d02ef09e..f01ea3bc00d 100644 --- a/docs/code-quality/c26816.md +++ b/docs/code-quality/c26816.md @@ -62,4 +62,4 @@ int f() { ## See also [C26815](c26815.md)\ -[ES.65: Don't dereference an invalid pointer](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es65-dont-dereference-an-invalid-pointer) +[ES.65: Don't dereference an invalid pointer](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-deref) diff --git a/docs/code-quality/c26817.md b/docs/code-quality/c26817.md index 3e66b660cf5..470b699dd2e 100644 --- a/docs/code-quality/c26817.md +++ b/docs/code-quality/c26817.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26817"] > Potentially expensive copy of variable *name* in range-for loop. Consider making it a const reference (es.71). -For more information, see [ES.71: Prefer a range-`for`-statement to a `for`-statement when there is a choice](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es71-prefer-a-range-for-statement-to-a-for-statement-when-there-is-a-choice) in the C++ Core Guidelines. +For more information, see [ES.71: Prefer a range-`for`-statement to a `for`-statement when there is a choice](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-for-range) in the C++ Core Guidelines. ## Example diff --git a/docs/code-quality/c26818.md b/docs/code-quality/c26818.md index db6965b1050..52adf70f5b6 100644 --- a/docs/code-quality/c26818.md +++ b/docs/code-quality/c26818.md @@ -14,7 +14,7 @@ no-loc: [ default, int, char ] This check covers the missing **`default`** label in switch statements that switch over a non-enumeration type, such as **`int`**, **`char`**, and so on. -For more information, see [ES.79: Use default to handle common cases (only)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es79-use-default-to-handle-common-cases-only) in the C++ Core Guidelines. +For more information, see [ES.79: Use default to handle common cases (only)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-default) in the C++ Core Guidelines. ## Example diff --git a/docs/code-quality/c26819.md b/docs/code-quality/c26819.md index fea652f765d..2e2007c9ff0 100644 --- a/docs/code-quality/c26819.md +++ b/docs/code-quality/c26819.md @@ -13,7 +13,7 @@ helpviewer_keywords: ["C26819"] This check covers implicit fallthrough in switch statements. Implicit fallthrough is when control flow transfers from one switch case directly into a following switch case without the use of the `[[fallthrough]];` statement. This warning is raised when an implicit fallthrough is detected in a switch case containing at least one statement. -For more information, see [ES.78: Don't rely on implicit fallthrough in `switch` statements](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es78-dont-rely-on-implicit-fallthrough-in-switch-statements) in the C++ Core Guidelines. +For more information, see [ES.78: Don't rely on implicit fallthrough in `switch` statements](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-break) in the C++ Core Guidelines. ## Example @@ -87,4 +87,4 @@ void foo(int a) ## See also -[ES.78: Don't rely on implicit fallthrough in `switch` statements](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es78-dont-rely-on-implicit-fallthrough-in-switch-statements) +[ES.78: Don't rely on implicit fallthrough in `switch` statements](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-break) diff --git a/docs/code-quality/c26820.md b/docs/code-quality/c26820.md index 133edaf1300..291f3abc21c 100644 --- a/docs/code-quality/c26820.md +++ b/docs/code-quality/c26820.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26820"] > This is a potentially expensive copy operation. Consider using a reference unless a copy is required (p.9) -For more information, see [P.9: Don't waste time or space](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#p9-dont-waste-time-or-space) in the C++ Core Guidelines. +For more information, see [P.9: Don't waste time or space](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rp-waste) in the C++ Core Guidelines. This check covers nonobvious and easy-to-miss behavior when assigning a reference to a variable marked **`auto`**. The type of the **`auto`** variable is resolved to a value rather than a reference, and an implicit copy is made. diff --git a/docs/code-quality/c26826.md b/docs/code-quality/c26826.md index 47fd2d9e8d3..8c0f827e9d5 100644 --- a/docs/code-quality/c26826.md +++ b/docs/code-quality/c26826.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26826"] > Don't use C-style variable arguments (f.55). -For more information, see [F.55: Don't use `va_arg` arguments](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f55-dont-use-va_arg-arguments) in the C++ Core Guidelines. +For more information, see [F.55: Don't use `va_arg` arguments](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#F-varargs) in the C++ Core Guidelines. ## Remarks diff --git a/docs/code-quality/code-analysis-for-cpp-corecheck.md b/docs/code-quality/code-analysis-for-cpp-corecheck.md index b5baf2cc339..82158f2233b 100644 --- a/docs/code-quality/code-analysis-for-cpp-corecheck.md +++ b/docs/code-quality/code-analysis-for-cpp-corecheck.md @@ -35,13 +35,13 @@ Do not assign a raw pointer to an owner\. See [C++ Core Guidelines R.3](https Prefer scoped objects, don't heap-allocate unnecessarily. See [C++ Core Guidelines R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped). [C26429 USE_NOTNULL](C26429.md)\ -Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26430 TEST_ON_ALL_PATHS](C26430.md)\ -Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26431 DONT_TEST_NOTNULL](C26431.md)\ -The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). ## RAW_POINTER Group @@ -61,19 +61,19 @@ Avoid malloc() and free(), prefer the nothrow version of new with delete. See [C Avoid calling new and delete explicitly, use std::make_unique\ instead. See [C++ Core Guidelines R.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-newdelete). [C26429 USE_NOTNULL](C26429.md)\ -Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26430 TEST_ON_ALL_PATHS](C26430.md)\ -Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26431 DONT_TEST_NOTNULL](C26431.md)\ -The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26481 NO_POINTER_ARITHMETIC](C26481.md)\ -Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds). +Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arithmetic). [C26485 NO_ARRAY_TO_POINTER_DECAY](C26485.md)\ -Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds). +Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-decay). ## UNIQUE_POINTER Group @@ -109,10 +109,10 @@ Shared pointer parameter '*symbol*' is not copied or moved. Use T* or T& instead ## DECLARATION Group [C26426 NO_GLOBAL_INIT_CALLS](C26426.md)\ -Global initializer calls a non-constexpr function '*symbol*'. See [C++ Core Guidelines I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i22-avoid-complex-initialization-of-global-objects). +Global initializer calls a non-constexpr function '*symbol*'. See [C++ Core Guidelines I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-global-init). [C26427 NO_GLOBAL_INIT_EXTERNS](C26427.md)\ -Global initializer accesses extern object '*symbol*'. See [C++ Core Guidelines I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i22-avoid-complex-initialization-of-global-objects). +Global initializer accesses extern object '*symbol*'. See [C++ Core Guidelines I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-global-init). [C26444 NO_UNNAMED_RAII_OBJECTS](c26444.md)\ Avoid unnamed objects with custom construction and destruction. See [ES.84: Don't (try to) declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-noname). @@ -120,19 +120,19 @@ Avoid unnamed objects with custom construction and destruction. See [ES.84: Don' ## CLASS Group [C26432 DEFINE_OR_DELETE_SPECIAL_OPS](C26432.md)\ -If you define or delete any default operation in the type '*symbol*', define or delete them all. See [C++ Core Guidelines C.21](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c21-if-you-define-or-delete-any-default-operation-define-or-delete-them-all). +If you define or delete any default operation in the type '*symbol*', define or delete them all. See [C++ Core Guidelines C.21](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-five). [C26433 OVERRIDE_EXPLICITLY](c26433.md)\ -Function '*symbol*' should be marked with 'override'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final). +Function '*symbol*' should be marked with 'override'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). [C26434 DONT_HIDE_METHODS](C26434.md)\ -Function '*symbol_1*' hides a non-virtual function '*symbol_2*'. See [C++ Core Guidelines C.128](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final). +Function '*symbol_1*' hides a non-virtual function '*symbol_2*'. See [C++ Core Guidelines C.128](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). [C26435 SINGLE_VIRTUAL_SPECIFICATION](c26435.md)\ Function '*symbol*' should specify exactly one of 'virtual', 'override', or 'final'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). [C26436 NEED_VIRTUAL_DTOR](C26436.md)\ -The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor. See [C++ Core Guidelines C.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-nonvirtual). +The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor. See [C++ Core Guidelines C.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-dtor-virtual). [C26443 NO_EXPLICIT_DTOR_OVERRIDE](c26443.md)\ Overriding destructor should not use explicit 'override' or 'virtual' specifiers. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). @@ -140,24 +140,24 @@ Overriding destructor should not use explicit 'override' or 'virtual' specifiers ## STYLE Group [C26438 NO_GOTO](C26438.md)\ -Avoid `goto`. See [C++ Core Guidelines ES.76](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es76-avoid-goto). +Avoid `goto`. See [C++ Core Guidelines ES.76](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-goto). ## FUNCTION Group [C26439 SPECIAL_NOEXCEPT](C26439.md)\ -This kind of function may not throw. Declare it **`noexcept`**. See [C++ Core Guidelines F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept). +This kind of function may not throw. Declare it **`noexcept`**. See [C++ Core Guidelines F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept). [C26440 DECLARE_NOEXCEPT](C26440.md)\ -Function '*symbol*' can be declared **`noexcept`**. See [C++ Core Guidelines F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept). +Function '*symbol*' can be declared **`noexcept`**. See [C++ Core Guidelines F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept). [C26447 DONT_THROW_IN_NOEXCEPT](c26447.md)\ The function is declared **`noexcept`** but calls a function which may throw exceptions. -See [C++ Core Guidelines: F.6: If your function may not throw, declare it noexcept](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f6-if-your-function-may-not-throw-declare-it-noexcept). +See [C++ Core Guidelines: F.6: If your function may not throw, declare it noexcept](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept). ## CONCURRENCY Group [C26441 NO_UNNAMED_GUARDS](C26441.md)\ -Guard objects must be named. See [C++ Core Guidelines cp.44](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#cp44-remember-to-name-your-lock_guards-and-unique_locks). +Guard objects must be named. See [C++ Core Guidelines cp.44](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconc-name). ## CONST Group @@ -168,16 +168,16 @@ The reference argument '*argument*' for function '*function*' can be marked as ` The pointer argument '*argument*' for function '*function*' can be marked as a pointer to `const`. See [C++ Core Guidelines con.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-ref). [C26462 USE_CONST_POINTER_FOR_VARIABLE](c26462.md)\ -The value pointed to by '*variable*' is assigned only once, mark it as a pointer to `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The value pointed to by '*variable*' is assigned only once, mark it as a pointer to `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). [C26463 USE_CONST_FOR_ELEMENTS](c26463.md)\ -The elements of array '*array*' are assigned only once, mark elements `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The elements of array '*array*' are assigned only once, mark elements `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). [C26464 USE_CONST_POINTER_FOR_ELEMENTS](c26464.md)\ -The values pointed to by elements of array '*array*' are assigned only once, mark elements as pointer to `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The values pointed to by elements of array '*array*' are assigned only once, mark elements as pointer to `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). [C26496 USE_CONST_FOR_VARIABLE](c26496.md)\ -The variable '*variable*' is assigned only once, mark it as `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The variable '*variable*' is assigned only once, mark it as `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). [C26497 USE_CONSTEXPR_FOR_FUNCTION](c26497.md)\ This function *function* could be marked `constexpr` if compile-time evaluation is desired. See [C++ Core Guidelines F.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-constexpr). @@ -188,7 +188,7 @@ This function call *function* can use `constexpr` if compile-time evaluation is ## TYPE Group [C26437 DONT_SLICE](C26437.md)\ -Do not slice. See [C++ Core Guidelines ES.63](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es63-dont-slice). +Do not slice. See [C++ Core Guidelines ES.63](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-slice). [C26465 NO_CONST_CAST_UNNECESSARY](c26465.md)\ Don't use `const_cast` to cast away `const`. `const_cast` is not required; constness or volatility is not being removed by this conversion. See [C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-constcast). @@ -200,67 +200,67 @@ Don't use `static_cast` downcasts. A cast from a polymorphic type should use dyn Don't use `reinterpret_cast`. A cast from void* can use `static_cast`. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). [C26472 NO_CASTS_FOR_ARITHMETIC_CONVERSION](C26472.md)\ -Don't use a `static_cast` for arithmetic conversions. Use brace initialization, gsl::narrow_cast, or gsl::narrow. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). +Don't use a `static_cast` for arithmetic conversions. Use brace initialization, gsl::narrow_cast, or gsl::narrow. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-arithmeticcast). [C26473 NO_IDENTITY_CAST](C26473.md)\ -Don't cast between pointer types where the source type and the target type are the same. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). +Don't cast between pointer types where the source type and the target type are the same. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-identitycast). [C26474 NO_IMPLICIT_CAST](C26474.md)\ -Don't cast between pointer types when the conversion could be implicit. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). +Don't cast between pointer types when the conversion could be implicit. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-implicitpointercast). [C26475 NO_FUNCTION_STYLE_CASTS](C26475.md)\ -Do not use function style C-casts. See [C++ Core Guidelines ES.49](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es49-if-you-must-use-a-cast-use-a-named-cast). +Do not use function style C-casts. See [C++ Core Guidelines ES.49](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-casts-named). [C26490 NO_REINTERPRET_CAST](c26490.md)\ -Don't use `reinterpret_cast`. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +Don't use `reinterpret_cast`. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). [C26491 NO_STATIC_DOWNCAST](c26490.md)\ -Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-downcast). [C26492 NO_CONST_CAST](c26492.md)\ -Don't use `const_cast` to cast away `const`. See [C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +Don't use `const_cast` to cast away `const`. See [C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-constcast). [C26493 NO_CSTYLE_CAST](c26493.md)\ -Don't use C-style casts. See [C++ Core Guidelines Type.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +Don't use C-style casts. See [C++ Core Guidelines Type.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-cstylecast). [C26494 VAR_USE_BEFORE_INIT](c26494.md)\ -Variable '*variable*' is uninitialized. Always initialize an object. See [C++ Core Guidelines Type.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +Variable '*variable*' is uninitialized. Always initialize an object. See [C++ Core Guidelines Type.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-init). [C26495 MEMBER_UNINIT](c26495.md)\ -Variable '*variable*' is uninitialized. Always initialize a member variable. See [C++ Core Guidelines Type.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type). +Variable '*variable*' is uninitialized. Always initialize a member variable. See [C++ Core Guidelines Type.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-memberinit). ## BOUNDS Group [C26446 USE_GSL_AT](c26446.md)\ -Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile). +Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-stdlib). [C26481 NO_POINTER_ARITHMETIC](C26481.md)\ -Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) +Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arithmetic) [C26482 NO_DYNAMIC_ARRAY_INDEXING](c26482.md)\ -Only index into arrays using constant expressions. See [C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) +Only index into arrays using constant expressions. See [C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arrayindex) [C26483 STATIC_INDEX_OUT_OF_RANGE](c26483.md)\ -Value *value* is outside the bounds (0, *bound*) of variable '*variable*'. Only index into arrays using constant expressions that are within bounds of the array. See [C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) +Value *value* is outside the bounds (0, *bound*) of variable '*variable*'. Only index into arrays using constant expressions that are within bounds of the array. See [C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arrayindex) [C26485 NO_ARRAY_TO_POINTER_DECAY](C26485.md)\ -Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) +Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-decay) ## GSL Group [C26445 NO_SPAN_REF](c26445.md)\ A reference to `gsl::span` or `std::string_view` may be an indication of a lifetime issue. -See [C++ Core Guidelines GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#gslview-views) +See [C++ Core Guidelines GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-views) [C26446 USE_GSL_AT](c26446.md)\ -Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile). +Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-stdlib). [C26448 USE_GSL_FINALLY](c26448.md)\ Consider using `gsl::finally` if final action is intended. See [C++ Core Guidelines: GSL.util: Utilities](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-utilities). [C26449 NO_SPAN_FROM_TEMPORARY](c26449.md)\ `gsl::span` or `std::string_view` created from a temporary will be invalid when the temporary is invalidated. See -[C++ Core Guidelines: GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#gslview-views). +[C++ Core Guidelines: GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-views). ## Deprecated Warnings From 747deb3672c5e87120e92e04ae399ef069a36bed Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 18:06:51 +0800 Subject: [PATCH 0598/1799] Add new C4862 in "Microsoft C/C++ compiler warnings C4800 through C4999" --- .../compiler-warnings-c4800-through-c4999.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md index 604fdbc580c..3ac4f3718a5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md @@ -2,8 +2,8 @@ title: "Microsoft C/C++ compiler (MSVC) warnings C4800 through C4999" description: "Table of Microsoft C/C++ compiler (MSVC) warnings C4800 through C4999." ms.date: 04/17/2024 -f1_keywords: ["C4801", "C4808", "C4809", "C4815", "C4826", "C4827", "C4828", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4849", "C4854", "C4855", "C4856", "C4857", "C4858", "C4859", "C4860", "C4861", "C4869", "C4872", "C4880", "C4881", "C4882", "C4883", "C4907", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4975", "C4976", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998"] -helpviewer_keywords: ["C4801", "C4808", "C4809", "C4815", "C4826", "C4827", "C4828", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4849", "C4854", "C4855", "C4856", "C4857", "C4858", "C4859", "C4860", "C4861", "C4869", "C4872", "C4880", "C4881", "C4882", "C4883", "C4907", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4975", "C4976", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998"] +f1_keywords: ["C4801", "C4808", "C4809", "C4815", "C4826", "C4827", "C4828", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4849", "C4854", "C4855", "C4856", "C4857", "C4858", "C4859", "C4860", "C4861", "C4862", "C4869", "C4872", "C4880", "C4881", "C4882", "C4883", "C4907", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4975", "C4976", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998"] +helpviewer_keywords: ["C4801", "C4808", "C4809", "C4815", "C4826", "C4827", "C4828", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4849", "C4854", "C4855", "C4856", "C4857", "C4858", "C4859", "C4860", "C4861", "C4862", "C4869", "C4872", "C4880", "C4881", "C4882", "C4883", "C4907", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4975", "C4976", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998"] --- # Microsoft C/C++ compiler warnings C4800 through C4999 @@ -63,6 +63,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages | Compiler warning (level 4) C4859 | '*value*' is not a valid argument for '`/presetWarn`': it must be a decimal value > 0. Command-line flag ignored | | Compiler warning (level 4) C4860 | '*object name*': compiler zero initialized '*number*' bytes of storage | | Compiler warning (level 4) C4861 | compiler zero initialized '*number*' bytes of storage | +| Compiler warning (level 1) C4862 | justification property is not allowed with more than one warning number | | [Compiler warning (level 4) C4866](c4866.md) | compiler may not enforce left-to-right evaluation order for call to *operator_name* | | [Compiler warning (level 1, error) C4867](compiler-warning-c4867.md) |'*function name*': non-standard syntax; use '`&`' to create a pointer to member| | [Compiler warning (level 4) C4868](compiler-warning-c4868.md) | '*file*(*line_number*)' compiler may not enforce left-to-right evaluation order in braced initialization list | From 73e4301ded999717b61d9476ba999d3e23d6a8d6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 18:11:24 +0800 Subject: [PATCH 0599/1799] Add boilerplate for version 17.14 in "Compiler Warnings by compiler version" --- .../compiler-warnings-by-compiler-version.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md b/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md index f68e772b833..75ab891de43 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md @@ -12,6 +12,7 @@ These versions of the compiler introduced new warnings: | Product | Compiler version number | |--|--| +| Visual Studio 2022 version 17.14 | 19.44 | | Visual Studio 2022 version 17.13 | 19.43 | | Visual Studio 2022 version 17.12 | 19.42 | | Visual Studio 2022 version 17.11 | 19.41 | @@ -63,6 +64,13 @@ The following sections list the warnings introduced by each version of Visual C+ ::: moniker range=">= msvc-170" +## Warnings introduced in Visual Studio 2022 version 17.14 (compiler version 19.44) + +These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.43`**. + +| Warning | Message | +|--|--| + ## Warnings introduced in Visual Studio 2022 version 17.13 (compiler version 19.43) These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.42`**. From 5d5bfd762fb0ee6cd8472c85dec78bb093fa33a3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 18:12:48 +0800 Subject: [PATCH 0600/1799] Add new C4862 in "Compiler Warnings by compiler version" --- .../compiler-warnings/compiler-warnings-by-compiler-version.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md b/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md index 75ab891de43..d5706dfc19c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md @@ -70,6 +70,7 @@ These warnings, and all warnings in later versions, are suppressed by using the | Warning | Message | |--|--| +| C4862 | justification property is not allowed with more than one warning number | ## Warnings introduced in Visual Studio 2022 version 17.13 (compiler version 19.43) From 68ef6ad6315e7a5fa8bee80f2a30cf8a7f25d03a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 18:50:45 +0800 Subject: [PATCH 0601/1799] Convert Resource compiler errors and warnings list into a table --- ...e-compiler-errors-rc1000-through-rc4413.md | 152 +++++++++--------- 1 file changed, 79 insertions(+), 73 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md index bc1f2f17fe6..609527c192b 100644 --- a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md +++ b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md @@ -11,85 +11,91 @@ This section is a reference to the errors generated by the resource compiler. Re ## Resource compiler fatal errors -[Resource compiler fatal error RC1002](resource-compiler-fatal-error-rc1002.md) \ -[Resource compiler fatal error RC1004](resource-compiler-fatal-error-rc1004.md) \ -[Resource compiler fatal error RC1009](resource-compiler-fatal-error-rc1009.md) \ -[Resource compiler fatal error RC1011](resource-compiler-fatal-error-rc1011.md) \ -[Resource compiler fatal error RC1015](resource-compiler-fatal-error-rc1015.md) \ -[Resource compiler fatal error RC1017](resource-compiler-fatal-error-rc1017.md) \ -[Resource compiler fatal error RC1018](resource-compiler-fatal-error-rc1018.md) \ -[Resource compiler fatal error RC1019](resource-compiler-fatal-error-rc1019.md) \ -[Resource compiler fatal error RC1020](resource-compiler-fatal-error-rc1020.md) \ -[Resource compiler fatal error RC1021](resource-compiler-fatal-error-rc1021.md) \ -[Resource compiler fatal error RC1022](resource-compiler-fatal-error-rc1022.md) \ -[Resource compiler fatal error RC1047](resource-compiler-fatal-error-rc1047.md) \ -[Resource compiler fatal error RC1052](resource-compiler-fatal-error-rc1052.md) \ -[Resource compiler fatal error RC1067](resource-compiler-fatal-error-rc1067.md) \ -[Resource compiler fatal error RC1101](resource-compiler-fatal-error-rc1101.md) \ -[Resource compiler fatal error RC1102](resource-compiler-fatal-error-rc1102.md) \ -[Resource compiler fatal error RC1105](resource-compiler-fatal-error-rc1105.md) \ -[Resource compiler fatal error RC1109](resource-compiler-fatal-error-rc1109.md) \ -[Resource compiler fatal error RC1116](resource-compiler-fatal-error-rc1116.md) \ -[Resource compiler fatal error RC1120](resource-compiler-fatal-error-rc1120.md) \ -[Resource compiler fatal error RC1121](resource-compiler-fatal-error-rc1121.md) \ -[Resource compiler fatal error RC1203](resource-compiler-fatal-error-rc1203.md) \ -[Resource compiler fatal error RC1205](resource-compiler-fatal-error-rc1205.md) \ -[Resource compiler fatal error RC1208](resource-compiler-fatal-error-rc1208.md) \ -[Resource compiler fatal error RW1004](resource-compiler-fatal-error-rw1004.md) \ -[Resource compiler fatal error RW1009](resource-compiler-fatal-error-rw1009.md) \ -[Resource compiler fatal error RW1016](resource-compiler-fatal-error-rw1016.md) \ -[Resource compiler fatal error RW1022](resource-compiler-fatal-error-rw1022.md) \ -[Resource compiler fatal error RW1023](resource-compiler-fatal-error-rw1023.md) \ -[Resource compiler fatal error RW1025](resource-compiler-fatal-error-rw1025.md) \ -[Resource compiler fatal error RW1030](resource-compiler-fatal-error-rw1030.md) +| Error | Message | +|--|--| +| [Resource compiler fatal error RC1002](resource-compiler-fatal-error-rc1002.md) | out of heap space | +| [Resource compiler fatal error RC1004](resource-compiler-fatal-error-rc1004.md) | unexpected end of file found | +| [Resource compiler fatal error RC1009](resource-compiler-fatal-error-rc1009.md) | compiler limit : macros too deeply nested 'macro' | +| [Resource compiler fatal error RC1011](resource-compiler-fatal-error-rc1011.md) | compiler limit : 'identifier' : macro definition too big | +| [Resource compiler fatal error RC1015](resource-compiler-fatal-error-rc1015.md) | cannot open include file 'filename' | +| [Resource compiler fatal error RC1017](resource-compiler-fatal-error-rc1017.md) | invalid integer constant expression | +| [Resource compiler fatal error RC1018](resource-compiler-fatal-error-rc1018.md) | unexpected '#elif' | +| [Resource compiler fatal error RC1019](resource-compiler-fatal-error-rc1019.md) | unexpected '#else' | +| [Resource compiler fatal error RC1020](resource-compiler-fatal-error-rc1020.md) | unexpected '#endif' | +| [Resource compiler fatal error RC1021](resource-compiler-fatal-error-rc1021.md) | invalid preprocessor command 'string' | +| [Resource compiler fatal error RC1022](resource-compiler-fatal-error-rc1022.md) | expected '#endif' | +| [Resource compiler fatal error RC1047](resource-compiler-fatal-error-rc1047.md) | "too many option options, 'string'" | +| [Resource compiler fatal error RC1052](resource-compiler-fatal-error-rc1052.md) | compiler limit : #if or #ifdef blocks nested too deeply | +| [Resource compiler fatal error RC1067](resource-compiler-fatal-error-rc1067.md) | compiler limit : identifier overflowed internal buffer | +| [Resource compiler fatal error RC1101](resource-compiler-fatal-error-rc1101.md) | no resource binary filename specified | +| [Resource compiler fatal error RC1102](resource-compiler-fatal-error-rc1102.md) | internal error : too many arguments to RCPP | +| [Resource compiler fatal error RC1105](resource-compiler-fatal-error-rc1105.md) | invalid switch, option: too many /d switches | +| [Resource compiler fatal error RC1109](resource-compiler-fatal-error-rc1109.md) | error creating resource-name | +| [Resource compiler fatal error RC1116](resource-compiler-fatal-error-rc1116.md) | RC terminating after preprocessor errors | +| [Resource compiler fatal error RC1120](resource-compiler-fatal-error-rc1120.md) | out of memory, needed number bytes | +| [Resource compiler fatal error RC1121](resource-compiler-fatal-error-rc1121.md) | I/O error reading file | +| [Resource compiler fatal error RC1203](resource-compiler-fatal-error-rc1203.md) | invalid hexadecimal default language ID specified. | +| [Resource compiler fatal error RC1205](resource-compiler-fatal-error-rc1205.md) | invalid code page | +| [Resource compiler fatal error RC1208](resource-compiler-fatal-error-rc1208.md) | input file has .RES extension | +| [Resource compiler fatal error RW1004](resource-compiler-fatal-error-rw1004.md) | Unexpected end of file | +| [Resource compiler fatal error RW1009](resource-compiler-fatal-error-rw1009.md) | Error creating resource-name | +| [Resource compiler fatal error RW1016](resource-compiler-fatal-error-rw1016.md) | RC terminating after preprocessor errors | +| [Resource compiler fatal error RW1022](resource-compiler-fatal-error-rw1022.md) | I/O error writing file | +| [Resource compiler fatal error RW1023](resource-compiler-fatal-error-rw1023.md) | I/O error writing file, drive full | +| [Resource compiler fatal error RW1025](resource-compiler-fatal-error-rw1025.md) | Out of far heap memory | +| [Resource compiler fatal error RW1030](resource-compiler-fatal-error-rw1030.md) | Output Error | ## Resource compiler errors -[Resource compiler error RC2001](resource-compiler-error-rc2001.md) \ -[Resource compiler error RC2007](resource-compiler-error-rc2007.md) \ -[Resource compiler error RC2015](resource-compiler-error-rc2015.md) \ -[Resource compiler error RC2017](resource-compiler-error-rc2017.md) \ -[Resource compiler error RC2101](resource-compiler-error-rc2101.md) \ -[Resource compiler error RC2103](resource-compiler-error-rc2103.md) \ -[Resource compiler error RC2104](resource-compiler-error-rc2104.md) \ -[Resource compiler error RC2107](resource-compiler-error-rc2107.md) \ -[Resource compiler error RC2109](resource-compiler-error-rc2109.md) \ -[Resource compiler error RC2111](resource-compiler-error-rc2111.md) \ -[Resource compiler error RC2112](resource-compiler-error-rc2112.md) \ -[Resource compiler error RC2113](resource-compiler-error-rc2113.md) \ -[Resource compiler error RC2114](resource-compiler-error-rc2114.md) \ -[Resource compiler error RC2116](resource-compiler-error-rc2116.md) \ -[Resource compiler error RC2122](resource-compiler-error-rc2122.md) \ -[Resource compiler error RC2124](resource-compiler-error-rc2124.md) \ -[Resource compiler error RC2127](resource-compiler-error-rc2127.md) \ -[Resource compiler error RC2135](resource-compiler-error-rc2135.md) \ -[Resource compiler error RC2144](resource-compiler-error-rc2144.md) \ -[Resource compiler error RC2147](resource-compiler-error-rc2147.md) \ -[Resource compiler error RC2148](resource-compiler-error-rc2148.md) \ -[Resource compiler error RC2151](resource-compiler-error-rc2151.md) \ -[Resource compiler error RC2152](resource-compiler-error-rc2152.md) \ -[Resource compiler error RC2162](resource-compiler-error-rc2162.md) \ -[Resource compiler error RC2163](resource-compiler-error-rc2163.md) \ -[Resource compiler error RC2164](resource-compiler-error-rc2164.md) \ -[Resource compiler error RC2165](resource-compiler-error-rc2165.md) \ -[Resource compiler error RC2167](resource-compiler-error-rc2167.md) \ -[Resource compiler error RC2169](resource-compiler-error-rc2169.md) \ -[Resource compiler error RC2170](resource-compiler-error-rc2170.md) \ -[Resource compiler error RC2171](resource-compiler-error-rc2171.md) \ -[Resource compiler error RC2175](resource-compiler-error-rc2175.md) \ -[Resource compiler error RW2001](resource-compiler-error-rw2001.md) \ -[Resource compiler error RW2002](resource-compiler-error-rw2002.md) \ -[Resource compiler error RW2003](resource-compiler-error-rw2003.md) +| Error | Message | +|--|--| +| [Resource compiler error RC2001](resource-compiler-error-rc2001.md) | newline in constant | +| [Resource compiler error RC2007](resource-compiler-error-rc2007.md) | #define syntax | +| [Resource compiler error RC2015](resource-compiler-error-rc2015.md) | too many chars in constant | +| [Resource compiler error RC2017](resource-compiler-error-rc2017.md) | illegal escape sequence | +| [Resource compiler error RC2101](resource-compiler-error-rc2101.md) | Invalid directive in preprocessed RC file | +| [Resource compiler error RC2103](resource-compiler-error-rc2103.md) | unexpected end of file in string literal | +| [Resource compiler error RC2104](resource-compiler-error-rc2104.md) | undefined keyword or key name: key | +| [Resource compiler error RC2107](resource-compiler-error-rc2107.md) | expected numeric command value | +| [Resource compiler error RC2109](resource-compiler-error-rc2109.md) | expected numerical dialog constant | +| [Resource compiler error RC2111](resource-compiler-error-rc2111.md) | invalid control type | +| [Resource compiler error RC2112](resource-compiler-error-rc2112.md) | BEGIN expected in dialog | +| [Resource compiler error RC2113](resource-compiler-error-rc2113.md) | END expected in dialog | +| [Resource compiler error RC2114](resource-compiler-error-rc2114.md) | expected control class name | +| [Resource compiler error RC2116](resource-compiler-error-rc2116.md) | expecting number for ID | +| [Resource compiler error RC2122](resource-compiler-error-rc2122.md) | unknown menu subtype | +| [Resource compiler error RC2124](resource-compiler-error-rc2124.md) | empty menus not allowed | +| [Resource compiler error RC2127](resource-compiler-error-rc2127.md) | version WORDs separated by commas expected | +| [Resource compiler error RC2135](resource-compiler-error-rc2135.md) | file not found: filename | +| [Resource compiler error RC2144](resource-compiler-error-rc2144.md) | PRIMARY LANGUAGE ID not a number | +| [Resource compiler error RC2147](resource-compiler-error-rc2147.md) | SUBLANGUAGE ID not a number | +| [Resource compiler error RC2148](resource-compiler-error-rc2148.md) | SUBLANGUAGE ID too large | +| [Resource compiler error RC2151](resource-compiler-error-rc2151.md) | cannot re-use string constants | +| [Resource compiler error RC2152](resource-compiler-error-rc2152.md) | invalid control character | +| [Resource compiler error RC2162](resource-compiler-error-rc2162.md) | expected macro formal parameter | +| [Resource compiler error RC2163](resource-compiler-error-rc2163.md) | accelerator type required [ASCII or VIRTKEY] | +| [Resource compiler error RC2164](resource-compiler-error-rc2164.md) | unexpected value in RCDATA | +| [Resource compiler error RC2165](resource-compiler-error-rc2165.md) | string not found in DLGINCLUDE statement | +| [Resource compiler error RC2167](resource-compiler-error-rc2167.md) | unrecognized VERSIONINFO field; BEGIN or comma expected | +| [Resource compiler error RC2169](resource-compiler-error-rc2169.md) | resource file filename is not in 2.03 format | +| [Resource compiler error RC2170](resource-compiler-error-rc2170.md) | bitmap file filename is not in 3.00 format | +| [Resource compiler error RC2171](resource-compiler-error-rc2171.md) | unknown DIB header format | +| [Resource compiler error RC2175](resource-compiler-error-rc2175.md) | resource file filename is not in 3.00 format | +| [Resource compiler error RW2001](resource-compiler-error-rw2001.md) | Invalid directive in preprocessed RC file | +| [Resource compiler error RW2002](resource-compiler-error-rw2002.md) | Parsing error | +| [Resource compiler error RW2003](resource-compiler-error-rw2003.md) | Generation Error | ## Resource compiler warnings -[Resource compiler warning RC4002](resource-compiler-warning-rc4002.md) \ -[Resource compiler warning RC4005](resource-compiler-warning-rc4005.md) \ -[Resource compiler warning RC4093](resource-compiler-warning-rc4093.md) \ -[Resource compiler warning RC4214](resource-compiler-warning-rc4214.md) \ -[Resource compiler warning RW4001](resource-compiler-warning-rw4001.md) \ -[Resource compiler warning RW4003](resource-compiler-warning-rw4003.md) \ -[Resource compiler warning RW4004](resource-compiler-warning-rw4004.md) +| Warning | Message | +|--|--| +| [Resource compiler warning RC4002](resource-compiler-warning-rc4002.md) | too many actual parameters for macro 'identifier' | +| [Resource compiler warning RC4005](resource-compiler-warning-rc4005.md) | 'identifier' : macro redefinition | +| [Resource compiler warning RC4093](resource-compiler-warning-rc4093.md) | unescaped newline in character constant in inactive code | +| [Resource compiler warning RC4214](resource-compiler-warning-rc4214.md) | Codepage not valid : ignored | +| [Resource compiler warning RW4001](resource-compiler-warning-rw4001.md) | .EXE processing options (/L /M /P /T /K /E /31 or /30) | +| [Resource compiler warning RW4003](resource-compiler-warning-rw4003.md) | SHIFT or CONTROL used without VIRTKEY | +| [Resource compiler warning RW4004](resource-compiler-warning-rw4004.md) | ASCII character not equivalent to virtual key code | ## See also From 960895dd473839a1f1de7559c64bc39b542b4253 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 18:51:59 +0800 Subject: [PATCH 0602/1799] Simplify superfluous relative links in "Resource compiler errors and warnings (RCxxxx, RWxxxx)" --- .../resource-compiler-errors-rc1000-through-rc4413.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md index 609527c192b..13c91af718c 100644 --- a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md +++ b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md @@ -7,7 +7,7 @@ ms.date: "04/17/2019" This section is a reference to the errors generated by the resource compiler. Resource compiler errors and warnings have the form RC*xxxx* or RW*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Resource compiler fatal errors From f13676e8a1411a0735ad8c6d9c0f8528fec5b85f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 18:53:00 +0800 Subject: [PATCH 0603/1799] Remove double quotes for `ms.date` in "Resource compiler errors and warnings (RCxxxx, RWxxxx)" --- .../resource-compiler-errors-rc1000-through-rc4413.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md index 13c91af718c..00125ae5b55 100644 --- a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md +++ b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md @@ -1,7 +1,7 @@ --- title: "Resource compiler errors and warnings" description: "Learn more about: Resource compiler errors and warnings (RCxxxx, RWxxxx)" -ms.date: "04/17/2019" +ms.date: 04/17/2019 --- # Resource compiler errors and warnings (RCxxxx, RWxxxx) From 92eb29ea67188c418a74ddb3896d068f8ed72a6f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 22:02:44 +0800 Subject: [PATCH 0604/1799] Remove space before closing parenthesis in title of "Namespaces and Type Visibility (C++/CX)" topic --- docs/cppcx/namespaces-and-type-visibility-c-cx.md | 6 +++--- docs/cppcx/toc.yml | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/cppcx/namespaces-and-type-visibility-c-cx.md b/docs/cppcx/namespaces-and-type-visibility-c-cx.md index 83ed1947d70..2b6464f1268 100644 --- a/docs/cppcx/namespaces-and-type-visibility-c-cx.md +++ b/docs/cppcx/namespaces-and-type-visibility-c-cx.md @@ -1,10 +1,10 @@ --- -description: "Learn more about: Namespaces and Type Visibility (C++/CX )" -title: "Namespaces and Type Visibility (C++/CX )" +description: "Learn more about: Namespaces and Type Visibility (C++/CX)" +title: "Namespaces and Type Visibility (C++/CX)" ms.date: "12/30/2016" ms.assetid: cbc01a3a-3b69-4ded-9c42-ecbf0fd0a00e --- -# Namespaces and Type Visibility (C++/CX ) +# Namespaces and Type Visibility (C++/CX) A namespace is a standard C++ construct for grouping types that have related functionality and for preventing name collisions in libraries. The Windows Runtime type system requires that all public Windows Runtime types, including those in your own code, must be declared in a namespace at namespace scope. Public types that are declared at global scope or nested inside another class will cause a compile-time error. diff --git a/docs/cppcx/toc.yml b/docs/cppcx/toc.yml index edc76e601e7..12708f934f9 100644 --- a/docs/cppcx/toc.yml +++ b/docs/cppcx/toc.yml @@ -13,7 +13,7 @@ items: items: - name: Type system overview href: ../cppcx/type-system-c-cx.md - - name: Namespaces and type visibility (C++/CX ) + - name: Namespaces and type visibility (C++/CX) href: ../cppcx/namespaces-and-type-visibility-c-cx.md - name: Fundamental types href: ../cppcx/fundamental-types-c-cx.md From 7a381737e5cf326f4bad424e3765f4f472f61682 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 22:06:18 +0800 Subject: [PATCH 0605/1799] Add backticks in "Namespaces and Type Visibility (C++/CX)" topic --- docs/cppcx/namespaces-and-type-visibility-c-cx.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/cppcx/namespaces-and-type-visibility-c-cx.md b/docs/cppcx/namespaces-and-type-visibility-c-cx.md index 2b6464f1268..75e446358ff 100644 --- a/docs/cppcx/namespaces-and-type-visibility-c-cx.md +++ b/docs/cppcx/namespaces-and-type-visibility-c-cx.md @@ -8,7 +8,7 @@ ms.assetid: cbc01a3a-3b69-4ded-9c42-ecbf0fd0a00e A namespace is a standard C++ construct for grouping types that have related functionality and for preventing name collisions in libraries. The Windows Runtime type system requires that all public Windows Runtime types, including those in your own code, must be declared in a namespace at namespace scope. Public types that are declared at global scope or nested inside another class will cause a compile-time error. -A .winmd file must have the same name that the root namespace has. For example, a class that's named A.B.C.MyClass can be instantiated only if it's defined in a metadata file that's named A.winmd or A.B.winmd or A.B.C.winmd. The name of the executable is not required to match the .winmd file name. +A `.winmd` file must have the same name that the root namespace has. For example, a class that's named `A.B.C.MyClass` can be instantiated only if it's defined in a metadata file that's named `A.winmd` or `A.B.winmd` or `A.B.C.winmd`. The name of the executable is not required to match the `.winmd` file name. ## Type visibility @@ -34,7 +34,7 @@ Use the following access modifiers to control both metadata visibility and sourc ## Windows Runtime namespaces -The Windows API consists of types that are declared in the Windows::\* namespaces. These namespaces are reserved for Windows, and types cannot be added to them. In the **Object Browser**, you can view these namespaces in the windows.winmd file. For documentation about these namespaces, see [Windows API](/uwp/api/). +The Windows API consists of types that are declared in the `Windows::*` namespaces. These namespaces are reserved for Windows, and types cannot be added to them. In the **Object Browser**, you can view these namespaces in the `windows.winmd` file. For documentation about these namespaces, see [Windows API](/uwp/api/). ## C++/CX namespaces @@ -44,7 +44,7 @@ The C++/CX define certain types in these namespaces as part of the projection of |--|--| | default | Contains the built-in numeric and char16 types. These types are in scope in every namespace and a **`using`** statement is never required. | | `Platform` | Contains primarily public types that correspond to Windows Runtime types such as `Array`, `String`, `Guid`, and `Boolean`. Also includes specialized helper types such as `Platform::Agile` and `Platform::Box`. | -| `Platform::Collections` | Contains the concrete collection classes that implement the Windows Runtime collection interfaces `IVector`, `IMap`, and so on. These types are defined in a header file, collection.h, not in platform.winmd. | +| `Platform::Collections` | Contains the concrete collection classes that implement the Windows Runtime collection interfaces `IVector`, `IMap`, and so on. These types are defined in a header file, `collection.h`, not in `platform.winmd`. | | `Platform::Details` | Contains types that are used by the compiler and are not meant for public consumption. | ## See also From 01bbdb8bad8dd994a20000646093a7f663880121 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 22:08:38 +0800 Subject: [PATCH 0606/1799] Clean up redundant relative link in "Namespaces and Type Visibility (C++/CX)" topic --- docs/cppcx/namespaces-and-type-visibility-c-cx.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cppcx/namespaces-and-type-visibility-c-cx.md b/docs/cppcx/namespaces-and-type-visibility-c-cx.md index 75e446358ff..c45561ec688 100644 --- a/docs/cppcx/namespaces-and-type-visibility-c-cx.md +++ b/docs/cppcx/namespaces-and-type-visibility-c-cx.md @@ -49,4 +49,4 @@ The C++/CX define certain types in these namespaces as part of the projection of ## See also -[Type System (C++/CX)](../cppcx/type-system-c-cx.md) +[Type System (C++/CX)](type-system-c-cx.md) From 47ff16f7fac36ea5d5815145d5ea149b8245cc37 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 22:12:34 +0800 Subject: [PATCH 0607/1799] Fix comma in "Namespaces and Type Visibility (C++/CX)" topic --- docs/cppcx/namespaces-and-type-visibility-c-cx.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cppcx/namespaces-and-type-visibility-c-cx.md b/docs/cppcx/namespaces-and-type-visibility-c-cx.md index c45561ec688..5b6c19d2af6 100644 --- a/docs/cppcx/namespaces-and-type-visibility-c-cx.md +++ b/docs/cppcx/namespaces-and-type-visibility-c-cx.md @@ -15,7 +15,7 @@ A `.winmd` file must have the same name that the root namespace has. For example In a namespace, Windows Runtime types—unlike standard C++ types—have either private or public accessibility. By default, the accessibility is private. Only a public type is visible to metadata and is therefore consumable from apps and components that might be written in languages other than C++. In general, the rules for visible types are more restrictive than the rules for non-visible types because visible types cannot expose C++-specific concepts that are not supported in .NET languages or JavaScript. > [!NOTE] -> Metadata is only consumed at run time by .NET languages and JavaScript. When a C++ app or component is talking to another C++ app or component—this includes Windows components ,which are all written in C++—then no run-time consumption of metadata is required. +> Metadata is only consumed at run time by .NET languages and JavaScript. When a C++ app or component is talking to another C++ app or component—this includes Windows components, which are all written in C++—then no run-time consumption of metadata is required. ## Member accessibility and visibility From 0d97ec6c2c6872f19ecef0765f43ca2252680b1e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 22:13:04 +0800 Subject: [PATCH 0608/1799] Update metadata in "Namespaces and Type Visibility (C++/CX)" topic --- docs/cppcx/namespaces-and-type-visibility-c-cx.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/cppcx/namespaces-and-type-visibility-c-cx.md b/docs/cppcx/namespaces-and-type-visibility-c-cx.md index 5b6c19d2af6..c225de9e734 100644 --- a/docs/cppcx/namespaces-and-type-visibility-c-cx.md +++ b/docs/cppcx/namespaces-and-type-visibility-c-cx.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: Namespaces and Type Visibility (C++/CX)" title: "Namespaces and Type Visibility (C++/CX)" -ms.date: "12/30/2016" -ms.assetid: cbc01a3a-3b69-4ded-9c42-ecbf0fd0a00e +description: "Learn more about: Namespaces and Type Visibility (C++/CX)" +ms.date: 12/30/2016 --- # Namespaces and Type Visibility (C++/CX) From 1689d282419e22b5515a7b3d88ceca378c3d3def Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 22:28:11 +0800 Subject: [PATCH 0609/1799] Elide single stray parenthesis and comma --- docs/c-runtime-library/reference/modf-modff-modfl.md | 2 +- .../compiler-warnings/compiler-warnings-c4200-through-c4399.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/reference/modf-modff-modfl.md b/docs/c-runtime-library/reference/modf-modff-modfl.md index 80f2a849e47..d2231bc0bde 100644 --- a/docs/c-runtime-library/reference/modf-modff-modfl.md +++ b/docs/c-runtime-library/reference/modf-modff-modfl.md @@ -52,7 +52,7 @@ By default, this function's global state is scoped to the application. To change | Routine | Required header | |---|---| -| **`modf`**, **`modff`**, **`modfl`** | C: ``

C++: , `` or `` | +| **`modf`**, **`modff`**, **`modfl`** | C: ``

C++: `` or `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md index 08698aef3ad..03ae1478d6a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md @@ -163,7 +163,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1) C4383](compiler-warning-level-1-c4383.md)|'*instance_dereference_operator*': the meaning of dereferencing a handle can change, when a user-defined '*instance_dereference_operator*' operator exists; write the operator as a static function to be explicit about the operand| |[Compiler warning (level 1) C4384](compiler-warning-level-1-c4384.md)|`#pragma` '*pragma_name*' should only be used at global scope| |Compiler warning (level 3) C4387|'*alternative*': was considered| -|[Compiler warning (level 4, off) C4388](./c4388.md))|'*expression*': signed/unsigned mismatch| +|[Compiler warning (level 4, off) C4388](./c4388.md)|'*expression*': signed/unsigned mismatch| |[Compiler warning (level 4) C4389](compiler-warning-level-4-c4389.md)|'*operator*': signed/unsigned mismatch| |[Compiler warning (level 3) C4390](compiler-warning-level-3-c4390.md)|';': empty controlled statement found; is this the intent?| |[Compiler warning (level 1) C4391](compiler-warning-level-1-c4391.md)|'*function_signature*': incorrect return type for intrinsic function, expected '*type*'| From 1d8f638100b9def9a2c46ef3a5c5165a97c503b7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 22:29:51 +0800 Subject: [PATCH 0610/1799] Remove double quotes for `ms.date` in `modf` reference --- docs/c-runtime-library/reference/modf-modff-modfl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/modf-modff-modfl.md b/docs/c-runtime-library/reference/modf-modff-modfl.md index d2231bc0bde..8b55826f947 100644 --- a/docs/c-runtime-library/reference/modf-modff-modfl.md +++ b/docs/c-runtime-library/reference/modf-modff-modfl.md @@ -1,7 +1,7 @@ --- title: "modf, modff, modfl" description: "API reference for modf, modff, and modfl; which split a floating-point value into fractional and integer parts." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["modff", "modf", "modfl", "_o_modf", "_o_modff"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] From 486cd528651ecdeb04eb6b2fe2712867f5ea97fe Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 22:58:15 +0800 Subject: [PATCH 0611/1799] Add blockquotes for error messages in range [C2611, C2650] --- docs/error-messages/compiler-errors-2/compiler-error-c2611.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2612.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2613.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2614.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2616.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2617.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2619.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2624.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2626.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2627.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2628.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2630.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2632.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2633.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2634.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2635.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2636.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2637.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2638.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2645.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2646.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2647.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2648.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2649.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2650.md | 2 +- 25 files changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md index 46d020f2d8d..0deaea6f4cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md @@ -8,7 +8,7 @@ ms.assetid: 3f2d5253-f24f-4724-83d0-6b2aa6a4e551 --- # Compiler Error C2611 -'token' : illegal following '~' (expected identifier) +> 'token' : illegal following '~' (expected identifier) The token is not an identifier. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md index 58b1d0ff3d6..d67b250202a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md @@ -8,7 +8,7 @@ ms.assetid: 6faacfd6-4455-41a2-808e-0f6799f84d6d --- # Compiler Error C2612 -trailing 'char' illegal in base/member initializer list +> trailing 'char' illegal in base/member initializer list A character appears after the last base or member in an initializer list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2613.md b/docs/error-messages/compiler-errors-2/compiler-error-c2613.md index 547668b933c..d546d99c122 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2613.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2613.md @@ -8,6 +8,6 @@ ms.assetid: d8fa7b32-08cb-4bb4-96e7-c04dded0e917 --- # Compiler Error C2613 -trailing ',' illegal in base class list +> trailing ',' illegal in base class list A comma appears after the last base in a base class list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md index c8ef3814a7c..2eb8eb6e5c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2614"] --- # Compiler Error C2614 -'class1' : illegal member initialization: 'class2' is not a base or member +> 'class1' : illegal member initialization: 'class2' is not a base or member Only member or base classes can appear in the initialization list for a class or structure. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2616.md b/docs/error-messages/compiler-errors-2/compiler-error-c2616.md index 77c845af313..bc3d1d8c37c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2616.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2616.md @@ -8,7 +8,7 @@ ms.assetid: 8d0c02d6-a0b0-4135-b10f-438d67da68c6 --- # Compiler Error C2616 -'conversion' : cannot implicitly convert a non-lvalue 'type1' to a 'type2' that is not const +> 'conversion' : cannot implicitly convert a non-lvalue 'type1' to a 'type2' that is not const A reference cannot be initialized from a non-lvalue. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md index 1cd6a242ae3..03a2b2d98fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md @@ -8,7 +8,7 @@ ms.assetid: d6a435d2-7d95-4dbf-ad4a-abe4744f63e8 --- # Compiler Error C2617 -'function' : inconsistent return statement +> 'function' : inconsistent return statement The specified function does not have a declared return type, and a previous return statement did not supply a value. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md index 0b31549ce06..e960f75850a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md @@ -8,7 +8,7 @@ ms.assetid: c826f8ab-d66a-4b79-a0b2-93b0af8c41ac --- # Compiler Error C2619 -'identifier': a static data member is not allowed in an anonymous struct or union +> 'identifier': a static data member is not allowed in an anonymous struct or union A member of an anonymous struct or union is declared **`static`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md index 7532dae0b40..1113c2e9d8c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md @@ -8,7 +8,7 @@ ms.assetid: 32f2ec15-a7cd-4049-a64b-131746d3152b --- # Compiler Error C2624 -local classes cannot be used to declare 'extern' variables +> local classes cannot be used to declare 'extern' variables A local class or structure cannot be used to declare **`extern`** variables. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md index 3ee3d112c02..d53a0a6826a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md @@ -8,7 +8,7 @@ ms.assetid: 4c283ad0-251b-4571-bc18-468b9836746f --- # Compiler Error C2626 -'identifier': a private or protected data member is not allowed in an anonymous struct or union +> 'identifier': a private or protected data member is not allowed in an anonymous struct or union A member of an anonymous struct or union must have public access. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md index f0cd09ab0b8..7ecf3bf338d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md @@ -8,7 +8,7 @@ ms.assetid: 7fc6c5ac-c7c9-4f0b-ad52-f52252526458 --- # Compiler Error C2627 -'function' : member function not allowed in anonymous union +> 'function' : member function not allowed in anonymous union An [anonymous union](../../cpp/unions.md#anonymous_unions) cannot have member functions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md index 561bc2aa568..15f18b98e2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md @@ -8,7 +8,7 @@ ms.assetid: 19a25e77-d5be-4107-88d5-0745b6281f98 --- # Compiler Error C2628 -'type1' followed by 'type2' is illegal (did you forget a ';'?) +> 'type1' followed by 'type2' is illegal (did you forget a ';'?) A semicolon may be missing. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md index 205a06a4753..a95da76b5ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md @@ -8,7 +8,7 @@ ms.assetid: 7a655a9c-bab4-495b-97a3-a3f34cf5369a --- # Compiler Error C2630 -'symbol' found in what should be a comma-separated list +> 'symbol' found in what should be a comma-separated list The symbol appears in a context that requires a comma. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md index 2471e652250..4755b981a9c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md @@ -8,7 +8,7 @@ ms.assetid: b15a6b1b-42d2-4e1b-8660-e6bfde61052d --- # Compiler Error C2632 -'type1' followed by 'type2' is illegal +> 'type1' followed by 'type2' is illegal This error can be caused if there is missing code between two type specifiers. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md index db695cecb70..bba90c22e3a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md @@ -8,7 +8,7 @@ ms.assetid: a7aceb65-4255-42d6-a8fb-e3cb6c4d2270 --- # Compiler Error C2633 -'identifier' : 'inline' is the only legal storage class for constructors +> 'identifier' : 'inline' is the only legal storage class for constructors A constructor is declared as a storage class other than inline. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md index 721415f346f..c9f47a321a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md @@ -8,7 +8,7 @@ ms.assetid: 58c8f2db-ac95-4a81-9355-ef3cfb0ba7b3 --- # Compiler Error C2634 -'&class::member' : pointer to reference member is illegal +> '&class::member' : pointer to reference member is illegal A pointer to a reference member is declared. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md index eb9ed290c46..b068a4f4c31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md @@ -8,7 +8,7 @@ ms.assetid: 9deca2a8-2d61-42eb-9783-6578132ee3fb --- # Compiler Error C2635 -cannot convert an 'identifier1*' to an 'identifier2\*'; conversion from a virtual base class is implied +> cannot convert an 'identifier1*' to an 'identifier2\*'; conversion from a virtual base class is implied The conversion requires a cast from a **`virtual`** base class to a derived class, which is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md index b60fb195320..7651ce5ab5f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md @@ -8,7 +8,7 @@ ms.assetid: 379873ec-8d05-49f8-adf1-b067bc07bdb8 --- # Compiler Error C2636 -'identifier' : pointer to reference member is illegal +> 'identifier' : pointer to reference member is illegal A pointer to a reference member was declared. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md index 40cb31b6061..5f2471fe8c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md @@ -8,7 +8,7 @@ ms.assetid: 58d94447-eb96-4d8f-a690-dd78d322462e --- # Compiler Error C2637 -'identifier' : cannot modify pointers to data members +> 'identifier' : cannot modify pointers to data members A pointer to a data member cannot have a calling convention. To resolve, either remove the calling convention or declare a pointer to member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md index 0f19715ed7f..57f14f247d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md @@ -8,7 +8,7 @@ ms.assetid: 9d4275e8-406d-455e-afee-3a37799230e0 --- # Compiler Error C2638 -'identifier' : __based modifier illegal on pointer to member +> 'identifier' : __based modifier illegal on pointer to member The **`__based`** modifier cannot be used for pointers to members. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md index 10f903aa458..a8abcf9f559 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md @@ -8,7 +8,7 @@ ms.assetid: 6609c2fa-c3b2-4a6b-8e8d-58fb52f67175 --- # Compiler Error C2645 -no qualified name for pointer to member (found ':: *') +> no qualified name for pointer to member (found ':: *') The declaration of a pointer to a member does not specify a class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md index 733efb98bc5..9818bbf20c6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md @@ -8,7 +8,7 @@ ms.assetid: 92ff1f02-5eaf-40a5-8b7a-a682f149e967 --- # Compiler Error C2646 -an anonymous struct or union at global or namespace scope must be declared static +> an anonymous struct or union at global or namespace scope must be declared static An anonymous struct or union has global or namespace scope but is not declared **`static`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2647.md b/docs/error-messages/compiler-errors-2/compiler-error-c2647.md index 736eee85d9d..0a280750906 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2647.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2647.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2647"] --- # Compiler Error C2647 -'operator': cannot dereference a 'type1' on a 'type2' +> 'operator': cannot dereference a 'type1' on a 'type2' The left operand of a pointer-to-member operator (`->*` or `.*`) cannot be implicitly converted to a type related to the right operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md index ef44b945847..fd458d6b6e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md @@ -8,7 +8,7 @@ ms.assetid: ce338337-9154-4f85-bb61-b05fdbfad75d --- # Compiler Error C2648 -'identifier' : use of member as default parameter requires static member +> 'identifier' : use of member as default parameter requires static member A non-static member is used as a default parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2649.md b/docs/error-messages/compiler-errors-2/compiler-error-c2649.md index fb6e19c4f93..03146b79aba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2649.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2649.md @@ -8,6 +8,6 @@ ms.assetid: 09e78f08-9b74-41e7-a76f-66bc190ba0d2 --- # Compiler Error C2649 -'identifier' : is not a 'class-key' +> 'identifier' : is not a 'class-key' A class, structure, or union declaration uses an incorrect tag. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md index 005db3ee7ac..84b58237e26 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md @@ -8,7 +8,7 @@ ms.assetid: 49a8ac6e-aa6d-4616-917c-a3cfcdbad5a4 --- # Compiler Error C2650 -'operator' : cannot be a virtual function +> 'operator' : cannot be a virtual function A **`new`** or **`delete`** operator is declared **`virtual`**. These operators are **`static`** member functions and cannot be **`virtual`**. From 521ef6366477356a55761921dd8a79ed9926c7f5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 23:04:04 +0800 Subject: [PATCH 0612/1799] Add "Remarks" and "Example" headings for error references in range [C2611, C2650] --- docs/error-messages/compiler-errors-2/compiler-error-c2611.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2612.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2613.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2614.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2616.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2617.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2619.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2624.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2626.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2627.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2628.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2630.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2632.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2633.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2634.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2635.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2636.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2637.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2638.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2640.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2645.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2646.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2647.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2648.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2649.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2650.md | 2 ++ 26 files changed, 94 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md index 0deaea6f4cd..05c79b9ec02 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md @@ -10,8 +10,12 @@ ms.assetid: 3f2d5253-f24f-4724-83d0-6b2aa6a4e551 > 'token' : illegal following '~' (expected identifier) +## Remarks + The token is not an identifier. +## Example + The following sample generates C2611: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md index d67b250202a..d95d86f0bc6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md @@ -10,8 +10,12 @@ ms.assetid: 6faacfd6-4455-41a2-808e-0f6799f84d6d > trailing 'char' illegal in base/member initializer list +## Remarks + A character appears after the last base or member in an initializer list. +## Example + The following sample generates C2612: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2613.md b/docs/error-messages/compiler-errors-2/compiler-error-c2613.md index d546d99c122..b84ca9890d4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2613.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2613.md @@ -10,4 +10,6 @@ ms.assetid: d8fa7b32-08cb-4bb4-96e7-c04dded0e917 > trailing ',' illegal in base class list +## Remarks + A comma appears after the last base in a base class list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md index 2eb8eb6e5c7..c6b7a942fb8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2614"] > 'class1' : illegal member initialization: 'class2' is not a base or member +## Remarks + Only member or base classes can appear in the initialization list for a class or structure. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2616.md b/docs/error-messages/compiler-errors-2/compiler-error-c2616.md index bc3d1d8c37c..0ff1abe3246 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2616.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2616.md @@ -10,6 +10,8 @@ ms.assetid: 8d0c02d6-a0b0-4135-b10f-438d67da68c6 > 'conversion' : cannot implicitly convert a non-lvalue 'type1' to a 'type2' that is not const +## Remarks + A reference cannot be initialized from a non-lvalue. This is an error under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) and a warning under Microsoft extensions (**/Ze**). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md index 03a2b2d98fb..df95688fa09 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md @@ -10,8 +10,12 @@ ms.assetid: d6a435d2-7d95-4dbf-ad4a-abe4744f63e8 > 'function' : inconsistent return statement +## Remarks + The specified function does not have a declared return type, and a previous return statement did not supply a value. +## Example + The following sample generates C2617: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md index e960f75850a..6472e918f34 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md @@ -10,8 +10,12 @@ ms.assetid: c826f8ab-d66a-4b79-a0b2-93b0af8c41ac > 'identifier': a static data member is not allowed in an anonymous struct or union +## Remarks + A member of an anonymous struct or union is declared **`static`**. +## Example + The following sample generates C2619, and demonstrates how to fix it by removing the static keyword. ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md index 1113c2e9d8c..cf936497435 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md @@ -10,8 +10,12 @@ ms.assetid: 32f2ec15-a7cd-4049-a64b-131746d3152b > local classes cannot be used to declare 'extern' variables +## Remarks + A local class or structure cannot be used to declare **`extern`** variables. +## Example + The following sample generates C2624: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md index d53a0a6826a..e96529f6530 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md @@ -10,8 +10,12 @@ ms.assetid: 4c283ad0-251b-4571-bc18-468b9836746f > 'identifier': a private or protected data member is not allowed in an anonymous struct or union +## Remarks + A member of an anonymous struct or union must have public access. +## Example + The following sample generates C2626: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md index 7ecf3bf338d..eb196ed24b3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md @@ -10,8 +10,12 @@ ms.assetid: 7fc6c5ac-c7c9-4f0b-ad52-f52252526458 > 'function' : member function not allowed in anonymous union +## Remarks + An [anonymous union](../../cpp/unions.md#anonymous_unions) cannot have member functions. +## Example + The following sample generates C2627: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md index 15f18b98e2a..42708fe4f3f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md @@ -10,8 +10,12 @@ ms.assetid: 19a25e77-d5be-4107-88d5-0745b6281f98 > 'type1' followed by 'type2' is illegal (did you forget a ';'?) +## Remarks + A semicolon may be missing. +## Example + The following sample generates C2628: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md index a95da76b5ef..90163a679bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md @@ -10,8 +10,12 @@ ms.assetid: 7a655a9c-bab4-495b-97a3-a3f34cf5369a > 'symbol' found in what should be a comma-separated list +## Remarks + The symbol appears in a context that requires a comma. +## Example + The following sample generates C2630: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md index 4755b981a9c..024f492d3af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md @@ -10,8 +10,12 @@ ms.assetid: b15a6b1b-42d2-4e1b-8660-e6bfde61052d > 'type1' followed by 'type2' is illegal +## Remarks + This error can be caused if there is missing code between two type specifiers. +## Examples + The following sample generates C2632: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md index bba90c22e3a..6a5aeff9867 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md @@ -10,8 +10,12 @@ ms.assetid: a7aceb65-4255-42d6-a8fb-e3cb6c4d2270 > 'identifier' : 'inline' is the only legal storage class for constructors +## Remarks + A constructor is declared as a storage class other than inline. +## Example + The following sample generates C2633: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md index c9f47a321a3..9d66109703d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md @@ -10,8 +10,12 @@ ms.assetid: 58c8f2db-ac95-4a81-9355-ef3cfb0ba7b3 > '&class::member' : pointer to reference member is illegal +## Remarks + A pointer to a reference member is declared. +## Example + The following sample generates C2634: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md index b068a4f4c31..9b2af33b729 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md @@ -10,8 +10,12 @@ ms.assetid: 9deca2a8-2d61-42eb-9783-6578132ee3fb > cannot convert an 'identifier1*' to an 'identifier2\*'; conversion from a virtual base class is implied +## Remarks + The conversion requires a cast from a **`virtual`** base class to a derived class, which is not allowed. +## Example + The following sample generates C2635: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md index 7651ce5ab5f..407f4937ac9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md @@ -10,8 +10,12 @@ ms.assetid: 379873ec-8d05-49f8-adf1-b067bc07bdb8 > 'identifier' : pointer to reference member is illegal +## Remarks + A pointer to a reference member was declared. +## Example + The following sample generates C2636: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md index 5f2471fe8c4..ee59caa8d35 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md @@ -10,8 +10,12 @@ ms.assetid: 58d94447-eb96-4d8f-a690-dd78d322462e > 'identifier' : cannot modify pointers to data members +## Remarks + A pointer to a data member cannot have a calling convention. To resolve, either remove the calling convention or declare a pointer to member function. +## Example + The following sample generates C2637: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md index 57f14f247d7..46b1a718cc2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md @@ -10,8 +10,12 @@ ms.assetid: 9d4275e8-406d-455e-afee-3a37799230e0 > 'identifier' : __based modifier illegal on pointer to member +## Remarks + The **`__based`** modifier cannot be used for pointers to members. +## Example + The following sample generates C2638: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2640.md b/docs/error-messages/compiler-errors-2/compiler-error-c2640.md index 5014adb77d0..62ffa8cfadf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2640.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2640.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2640"] > 'abstract declarator': __based modifier illegal on reference +## Remarks + The [**`__based`**](../../cpp/based-pointers-cpp.md) modifier can be used on pointers only. +## Example + The following sample generates C2640: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md index a8abcf9f559..fe35f9e0314 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md @@ -10,8 +10,12 @@ ms.assetid: 6609c2fa-c3b2-4a6b-8e8d-58fb52f67175 > no qualified name for pointer to member (found ':: *') +## Remarks + The declaration of a pointer to a member does not specify a class. +## Example + The following sample generates C2645: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md index 9818bbf20c6..adae00f00f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md @@ -10,8 +10,12 @@ ms.assetid: 92ff1f02-5eaf-40a5-8b7a-a682f149e967 > an anonymous struct or union at global or namespace scope must be declared static +## Remarks + An anonymous struct or union has global or namespace scope but is not declared **`static`**. +## Example + The following sample generates C2646 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2647.md b/docs/error-messages/compiler-errors-2/compiler-error-c2647.md index 0a280750906..dcb2c717481 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2647.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2647.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2647"] > 'operator': cannot dereference a 'type1' on a 'type2' +## Remarks + The left operand of a pointer-to-member operator (`->*` or `.*`) cannot be implicitly converted to a type related to the right operator. +## Example + The following sample generates C2647: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md index fd458d6b6e6..f1a863569bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md @@ -10,8 +10,12 @@ ms.assetid: ce338337-9154-4f85-bb61-b05fdbfad75d > 'identifier' : use of member as default parameter requires static member +## Remarks + A non-static member is used as a default parameter. +## Example + The following sample generates C2648: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2649.md b/docs/error-messages/compiler-errors-2/compiler-error-c2649.md index 03146b79aba..111794a5c86 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2649.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2649.md @@ -10,4 +10,6 @@ ms.assetid: 09e78f08-9b74-41e7-a76f-66bc190ba0d2 > 'identifier' : is not a 'class-key' +## Remarks + A class, structure, or union declaration uses an incorrect tag. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md index 84b58237e26..a4db0d720e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md @@ -10,6 +10,8 @@ ms.assetid: 49a8ac6e-aa6d-4616-917c-a3cfcdbad5a4 > 'operator' : cannot be a virtual function +## Remarks + A **`new`** or **`delete`** operator is declared **`virtual`**. These operators are **`static`** member functions and cannot be **`virtual`**. ## Example From 6daf2d4745b0c525d52715e297d26cd07dec206c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 23:05:35 +0800 Subject: [PATCH 0613/1799] Replace term "sample" with "example" for error references in range [C2611, C2650] --- docs/error-messages/compiler-errors-2/compiler-error-c2611.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2612.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2614.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2617.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2619.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2624.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2626.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2627.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2628.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2630.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2632.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2633.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2634.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2635.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2636.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2637.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2638.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2640.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2645.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2646.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2647.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2648.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2650.md | 2 +- 23 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md index 05c79b9ec02..252b952dbc3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md @@ -16,7 +16,7 @@ The token is not an identifier. ## Example -The following sample generates C2611: +The following example generates C2611: ```cpp // C2611.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md index d95d86f0bc6..3844bdef9f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md @@ -16,7 +16,7 @@ A character appears after the last base or member in an initializer list. ## Example -The following sample generates C2612: +The following example generates C2612: ```cpp // C2612.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md index c6b7a942fb8..4764e9574fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md @@ -15,7 +15,7 @@ Only member or base classes can appear in the initialization list for a class or ## Example -The following sample generates C2614. +The following example generates C2614. ```cpp // C2614.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md index df95688fa09..e6443b4bbf2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md @@ -16,7 +16,7 @@ The specified function does not have a declared return type, and a previous retu ## Example -The following sample generates C2617: +The following example generates C2617: ```cpp // C2617.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md index 6472e918f34..ecc8c1459bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md @@ -16,7 +16,7 @@ A member of an anonymous struct or union is declared **`static`**. ## Example -The following sample generates C2619, and demonstrates how to fix it by removing the static keyword. +The following example generates C2619, and demonstrates how to fix it by removing the static keyword. ```cpp // C2619.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md index cf936497435..1132775251b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md @@ -16,7 +16,7 @@ A local class or structure cannot be used to declare **`extern`** variables. ## Example -The following sample generates C2624: +The following example generates C2624: ```cpp // C2624.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md index e96529f6530..47591e2d927 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md @@ -16,7 +16,7 @@ A member of an anonymous struct or union must have public access. ## Example -The following sample generates C2626: +The following example generates C2626: ```cpp // C2626.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md index eb196ed24b3..4fb3780a0e5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md @@ -16,7 +16,7 @@ An [anonymous union](../../cpp/unions.md#anonymous_unions) cannot have member fu ## Example -The following sample generates C2627: +The following example generates C2627: ```cpp // C2627.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md index 42708fe4f3f..0e8cd74b28d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md @@ -16,7 +16,7 @@ A semicolon may be missing. ## Example -The following sample generates C2628: +The following example generates C2628: ```cpp // C2628.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md index 90163a679bb..5ac8e6c5fd0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md @@ -16,7 +16,7 @@ The symbol appears in a context that requires a comma. ## Example -The following sample generates C2630: +The following example generates C2630: ```cpp // C2630.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md index 024f492d3af..13110e37f9c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md @@ -16,7 +16,7 @@ This error can be caused if there is missing code between two type specifiers. ## Examples -The following sample generates C2632: +The following example generates C2632: ```cpp // C2632.cpp @@ -25,7 +25,7 @@ int float i; // C2632 This error can also be generated as a result of compiler conformance work that was done for Visual Studio .NET 2003. **`bool`** is now a proper type. In previous versions, **`bool`** was a typedef, and you could create identifiers with that name. -The following sample generates C2632: +The following example generates C2632: ```cpp // C2632_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md index 6a5aeff9867..081620141fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md @@ -16,7 +16,7 @@ A constructor is declared as a storage class other than inline. ## Example -The following sample generates C2633: +The following example generates C2633: ```cpp // C2633.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md index 9d66109703d..7cac275e9bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md @@ -16,7 +16,7 @@ A pointer to a reference member is declared. ## Example -The following sample generates C2634: +The following example generates C2634: ```cpp // C2634.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md index 9b2af33b729..001ea471fcd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md @@ -16,7 +16,7 @@ The conversion requires a cast from a **`virtual`** base class to a derived clas ## Example -The following sample generates C2635: +The following example generates C2635: ```cpp // C2635.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md index 407f4937ac9..497585e696e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md @@ -16,7 +16,7 @@ A pointer to a reference member was declared. ## Example -The following sample generates C2636: +The following example generates C2636: ```cpp // C2636.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md index ee59caa8d35..041cdf4b81b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md @@ -16,7 +16,7 @@ A pointer to a data member cannot have a calling convention. To resolve, either ## Example -The following sample generates C2637: +The following example generates C2637: ```cpp // C2637.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md index 46b1a718cc2..fc07072c4ea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md @@ -16,7 +16,7 @@ The **`__based`** modifier cannot be used for pointers to members. ## Example -The following sample generates C2638: +The following example generates C2638: ```cpp // C2638.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2640.md b/docs/error-messages/compiler-errors-2/compiler-error-c2640.md index 62ffa8cfadf..323f08771cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2640.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2640.md @@ -15,7 +15,7 @@ The [**`__based`**](../../cpp/based-pointers-cpp.md) modifier can be used on poi ## Example -The following sample generates C2640: +The following example generates C2640: ```cpp // C2640.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md index fe35f9e0314..a9aa00b1ce1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md @@ -16,7 +16,7 @@ The declaration of a pointer to a member does not specify a class. ## Example -The following sample generates C2645: +The following example generates C2645: ```cpp // C2645.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md index adae00f00f8..3b60060d67e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md @@ -16,7 +16,7 @@ An anonymous struct or union has global or namespace scope but is not declared * ## Example -The following sample generates C2646 and shows how to fix it: +The following example generates C2646 and shows how to fix it: ```cpp // C2646.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2647.md b/docs/error-messages/compiler-errors-2/compiler-error-c2647.md index dcb2c717481..0a6e5dab39d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2647.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2647.md @@ -15,7 +15,7 @@ The left operand of a pointer-to-member operator (`->*` or `.*`) cannot be impli ## Example -The following sample generates C2647: +The following example generates C2647: ```cpp // C2647.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md index f1a863569bb..6e35d9ed5f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md @@ -16,7 +16,7 @@ A non-static member is used as a default parameter. ## Example -The following sample generates C2648: +The following example generates C2648: ```cpp // C2648.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md index a4db0d720e8..bc990e2b3b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md @@ -16,7 +16,7 @@ A **`new`** or **`delete`** operator is declared **`virtual`**. These operators ## Example -The following sample generates C2650: +The following example generates C2650: ```cpp // C2650.cpp From 0899844ebd470aaf13dc08e4f9d38c8daf6152e3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 2 Aug 2025 23:09:23 +0800 Subject: [PATCH 0614/1799] Update metadata for error references in range [C2611, C2650] --- .../error-messages/compiler-errors-2/compiler-error-c2611.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2612.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2613.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2616.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2617.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2619.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2624.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2626.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2627.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2628.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2630.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2632.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2633.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2634.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2635.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2636.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2637.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2638.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2640.md | 2 +- .../error-messages/compiler-errors-2/compiler-error-c2645.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2646.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2648.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2649.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2650.md | 5 ++--- 24 files changed, 47 insertions(+), 70 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md index 252b952dbc3..9c4825ce615 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2611" title: "Compiler Error C2611" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2611" +ms.date: 11/04/2016 f1_keywords: ["C2611"] helpviewer_keywords: ["C2611"] -ms.assetid: 3f2d5253-f24f-4724-83d0-6b2aa6a4e551 --- # Compiler Error C2611 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md index 3844bdef9f8..2966afaeb11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2612" title: "Compiler Error C2612" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2612" +ms.date: 11/04/2016 f1_keywords: ["C2612"] helpviewer_keywords: ["C2612"] -ms.assetid: 6faacfd6-4455-41a2-808e-0f6799f84d6d --- # Compiler Error C2612 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2613.md b/docs/error-messages/compiler-errors-2/compiler-error-c2613.md index b84ca9890d4..70ef49410d0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2613.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2613.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2613" title: "Compiler Error C2613" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2613" +ms.date: 11/04/2016 f1_keywords: ["C2613"] helpviewer_keywords: ["C2613"] -ms.assetid: d8fa7b32-08cb-4bb4-96e7-c04dded0e917 --- # Compiler Error C2613 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2616.md b/docs/error-messages/compiler-errors-2/compiler-error-c2616.md index 0ff1abe3246..9da31ed6fe6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2616.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2616.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2616" title: "Compiler Error C2616" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2616" +ms.date: 11/04/2016 f1_keywords: ["C2616"] helpviewer_keywords: ["C2616"] -ms.assetid: 8d0c02d6-a0b0-4135-b10f-438d67da68c6 --- # Compiler Error C2616 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md index e6443b4bbf2..a868e75c05d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2617" title: "Compiler Error C2617" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2617" +ms.date: 11/04/2016 f1_keywords: ["C2617"] helpviewer_keywords: ["C2617"] -ms.assetid: d6a435d2-7d95-4dbf-ad4a-abe4744f63e8 --- # Compiler Error C2617 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md index ecc8c1459bd..7defff06cd1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2619" title: "Compiler Error C2619" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2619" +ms.date: 11/04/2016 f1_keywords: ["C2619"] helpviewer_keywords: ["C2619"] -ms.assetid: c826f8ab-d66a-4b79-a0b2-93b0af8c41ac --- # Compiler Error C2619 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md index 1132775251b..a1e2ad3153d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2624" title: "Compiler Error C2624" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2624" +ms.date: 11/04/2016 f1_keywords: ["C2624"] helpviewer_keywords: ["C2624"] -ms.assetid: 32f2ec15-a7cd-4049-a64b-131746d3152b --- # Compiler Error C2624 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md index 47591e2d927..bc83bd476dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2626" title: "Compiler Error C2626" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2626" +ms.date: 11/04/2016 f1_keywords: ["C2626"] helpviewer_keywords: ["C2626"] -ms.assetid: 4c283ad0-251b-4571-bc18-468b9836746f --- # Compiler Error C2626 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md index 4fb3780a0e5..b35f668333b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2627" title: "Compiler Error C2627" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2627" +ms.date: 11/04/2016 f1_keywords: ["C2627"] helpviewer_keywords: ["C2627"] -ms.assetid: 7fc6c5ac-c7c9-4f0b-ad52-f52252526458 --- # Compiler Error C2627 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md index 0e8cd74b28d..e398afc1aa4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2628" title: "Compiler Error C2628" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2628" +ms.date: 11/04/2016 f1_keywords: ["C2628"] helpviewer_keywords: ["C2628"] -ms.assetid: 19a25e77-d5be-4107-88d5-0745b6281f98 --- # Compiler Error C2628 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md index 5ac8e6c5fd0..367ec0360cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2630" title: "Compiler Error C2630" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2630" +ms.date: 11/04/2016 f1_keywords: ["C2630"] helpviewer_keywords: ["C2630"] -ms.assetid: 7a655a9c-bab4-495b-97a3-a3f34cf5369a --- # Compiler Error C2630 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md index 13110e37f9c..28b0937c21b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2632" title: "Compiler Error C2632" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2632" +ms.date: 11/04/2016 f1_keywords: ["C2632"] helpviewer_keywords: ["C2632"] -ms.assetid: b15a6b1b-42d2-4e1b-8660-e6bfde61052d --- # Compiler Error C2632 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md index 081620141fb..4270773097f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2633" title: "Compiler Error C2633" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2633" +ms.date: 11/04/2016 f1_keywords: ["C2633"] helpviewer_keywords: ["C2633"] -ms.assetid: a7aceb65-4255-42d6-a8fb-e3cb6c4d2270 --- # Compiler Error C2633 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md index 7cac275e9bb..234acb5b249 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2634" title: "Compiler Error C2634" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2634" +ms.date: 11/04/2016 f1_keywords: ["C2634"] helpviewer_keywords: ["C2634"] -ms.assetid: 58c8f2db-ac95-4a81-9355-ef3cfb0ba7b3 --- # Compiler Error C2634 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md index 001ea471fcd..065efac641f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2635" title: "Compiler Error C2635" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2635" +ms.date: 11/04/2016 f1_keywords: ["C2635"] helpviewer_keywords: ["C2635"] -ms.assetid: 9deca2a8-2d61-42eb-9783-6578132ee3fb --- # Compiler Error C2635 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md index 497585e696e..0d37fabe818 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2636" title: "Compiler Error C2636" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2636" +ms.date: 11/04/2016 f1_keywords: ["C2636"] helpviewer_keywords: ["C2636"] -ms.assetid: 379873ec-8d05-49f8-adf1-b067bc07bdb8 --- # Compiler Error C2636 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md index 041cdf4b81b..4eda884eb63 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2637" title: "Compiler Error C2637" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2637" +ms.date: 11/04/2016 f1_keywords: ["C2637"] helpviewer_keywords: ["C2637"] -ms.assetid: 58d94447-eb96-4d8f-a690-dd78d322462e --- # Compiler Error C2637 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md index fc07072c4ea..bb2c3beed90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2638" title: "Compiler Error C2638" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2638" +ms.date: 11/04/2016 f1_keywords: ["C2638"] helpviewer_keywords: ["C2638"] -ms.assetid: 9d4275e8-406d-455e-afee-3a37799230e0 --- # Compiler Error C2638 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2640.md b/docs/error-messages/compiler-errors-2/compiler-error-c2640.md index 323f08771cf..365c80e4250 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2640.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2640.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2640" description: "Learn more about: Compiler Error C2640" -ms.date: "03/17/2025" +ms.date: 03/17/2025 f1_keywords: ["C2640"] helpviewer_keywords: ["C2640"] --- diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md index a9aa00b1ce1..51bc814c4a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2645" title: "Compiler Error C2645" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2645" +ms.date: 11/04/2016 f1_keywords: ["C2645"] helpviewer_keywords: ["C2645"] -ms.assetid: 6609c2fa-c3b2-4a6b-8e8d-58fb52f67175 --- # Compiler Error C2645 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md index 3b60060d67e..f6c33292e47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2646" title: "Compiler Error C2646" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2646" +ms.date: 11/04/2016 f1_keywords: ["C2646"] helpviewer_keywords: ["C2646"] -ms.assetid: 92ff1f02-5eaf-40a5-8b7a-a682f149e967 --- # Compiler Error C2646 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md index 6e35d9ed5f7..8ece835b5be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2648" title: "Compiler Error C2648" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2648" +ms.date: 11/04/2016 f1_keywords: ["C2648"] helpviewer_keywords: ["C2648"] -ms.assetid: ce338337-9154-4f85-bb61-b05fdbfad75d --- # Compiler Error C2648 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2649.md b/docs/error-messages/compiler-errors-2/compiler-error-c2649.md index 111794a5c86..5cca3fb8e7a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2649.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2649.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2649" title: "Compiler Error C2649" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2649" +ms.date: 11/04/2016 f1_keywords: ["C2649"] helpviewer_keywords: ["C2649"] -ms.assetid: 09e78f08-9b74-41e7-a76f-66bc190ba0d2 --- # Compiler Error C2649 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md index bc990e2b3b4..dfaf2272cb3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2650" title: "Compiler Error C2650" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2650" +ms.date: 11/04/2016 f1_keywords: ["C2650"] helpviewer_keywords: ["C2650"] -ms.assetid: 49a8ac6e-aa6d-4616-917c-a3cfcdbad5a4 --- # Compiler Error C2650 From 4b080d8c3cfc163e9a858112988cc1c52f01ac68 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 3 Aug 2025 18:24:16 +0800 Subject: [PATCH 0615/1799] Add missing `f1_keywords` and `helpviewer_keywords` in "Microsoft C/C++ compiler warnings C5200 through C5399" --- .../compiler-warnings-c5200-through-c5399.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c5200-through-c5399.md b/docs/error-messages/compiler-warnings/compiler-warnings-c5200-through-c5399.md index 1b66790fb1e..0bebc97caa6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c5200-through-c5399.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c5200-through-c5399.md @@ -2,8 +2,8 @@ title: "Microsoft C/C++ compiler (MSVC) compiler warnings C5200 through C5399" description: "Table of Microsoft C/C++ compiler (MSVC) warnings C5200 through C5399." ms.date: 04/19/2024 -f1_keywords: ["C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5265", "C5268", "C5269", "C5270", "C5271", "C5272", "C5273", "C5274", "C5275", "C5300", "C5303", "C5304", "C5305"] -helpviewer_keywords: ["C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5265", "C5268", "C5269", "C5270", "C5271", "C5272", "C5273", "C5274", "C5275", "C5300", "C5303", "C5304", "C5305"] +f1_keywords: ["C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5265", "C5268", "C5269", "C5270", "C5271", "C5272", "C5273", "C5274", "C5275", "C5276", "C5277", "C5278", "C5279", "C5280", "C5281", "C5282", "C5283", "C5284", "C5285", "C5286", "C5287", "C5300", "C5303", "C5304", "C5305", "C5306", "C5307", "C5308", "C5309"] +helpviewer_keywords: ["C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5265", "C5268", "C5269", "C5270", "C5271", "C5272", "C5273", "C5274", "C5275", "C5276", "C5277", "C5278", "C5279", "C5280", "C5281", "C5282", "C5283", "C5284", "C5285", "C5286", "C5287", "C5300", "C5303", "C5304", "C5305", "C5306", "C5307", "C5308", "C5309"] --- # Microsoft C/C++ compiler warnings C5200 through C5399 From 3a3da870429ff9aa74b0777534555bef271a4123 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 3 Aug 2025 22:31:06 +0800 Subject: [PATCH 0616/1799] Add blockquotes for error messages in range [C2651, C2670] --- docs/error-messages/compiler-errors-2/compiler-error-c2651.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2652.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2654.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2655.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2656.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2657.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2658.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2659.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2660.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2661.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2662.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2663.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2664.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2665.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2666.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2667.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2669.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2670.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2651.md b/docs/error-messages/compiler-errors-2/compiler-error-c2651.md index 1c1c8fcddf5..03dc4c56a2c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2651.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2651.md @@ -8,6 +8,6 @@ ms.assetid: c3524a89-47d1-43f6-9e20-2cda15f9ae8a --- # Compiler Error C2651 -'data type' : left of 'operator' must be a class, struct or union +> 'data type' : left of 'operator' must be a class, struct or union To use a template parameter as if it is a class, specialize the class template with a class instead of an integral type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md index 8c816d24a78..352267ec77e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md @@ -8,7 +8,7 @@ ms.assetid: 6e3d1a90-a989-4088-8afd-dc82f6a2d66f --- # Compiler Error C2652 -'identifier' : illegal copy constructor: first parameter must not be an 'identifier' +> 'identifier' : illegal copy constructor: first parameter must not be an 'identifier' The first parameter in the copy constructor has the same type as the class, structure, or union for which it is defined. The first parameter can be a reference to the type but not the type itself. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2654.md b/docs/error-messages/compiler-errors-2/compiler-error-c2654.md index c1905fbdb7c..af61c405fe8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2654.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2654.md @@ -8,7 +8,7 @@ ms.assetid: ca7de1bd-576b-40bf-96fc-a91984827d20 --- # Compiler Error C2654 -'identifier' : attempt to access member outside a member function +> 'identifier' : attempt to access member outside a member function A member is accessed in a declaration. Member data can be accessed only in member functions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md index 77dcb0e48d4..901b218fc4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md @@ -8,7 +8,7 @@ ms.assetid: beaefa6e-51b3-4df9-9150-960f3fbf40e0 --- # Compiler Error C2655 -'identifier' : definition or redeclaration illegal in current scope +> 'identifier' : definition or redeclaration illegal in current scope An identifier can be redeclared only at global scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2656.md b/docs/error-messages/compiler-errors-2/compiler-error-c2656.md index c76d36e6f7b..d001d70f592 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2656.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2656.md @@ -8,7 +8,7 @@ ms.assetid: 1ec91186-0735-4904-859b-59da9af2d426 --- # Compiler Error C2656 -'function' : function not allowed as a bit field +> 'function' : function not allowed as a bit field A function is declared as a member of a bit field. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md index 8cb0fddc1ef..46b73efb557 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md @@ -8,7 +8,7 @@ ms.assetid: f7cf29a9-684a-4605-9469-ecfee9ba4b03 --- # Compiler Error C2657 -'class::*' found at the start of a statement (did you forget to specify a type?) +> 'class::*' found at the start of a statement (did you forget to specify a type?) The line began with a pointer-to-member identifier. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md index e71e04ef906..0f4c4538f5b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md @@ -8,7 +8,7 @@ ms.assetid: 638368e8-7893-4a14-abec-13c768a9543a --- # Compiler Error C2658 -'member': redefinition in anonymous struct/union +> 'member': redefinition in anonymous struct/union Two anonymous structures or unions contained member declarations with the same identifier but with different types. Under [/Za](../../build/reference/za-ze-disable-language-extensions.md), you will also get this error for members with the same identifier and type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2659.md b/docs/error-messages/compiler-errors-2/compiler-error-c2659.md index ab818a1f07a..562b7ce3e2b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2659.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2659.md @@ -8,7 +8,7 @@ ms.assetid: b0883600-4d27-4ca7-a931-8ca6bd48654d --- # Compiler Error C2659 -'operator' : function as left operand +> 'operator' : function as left operand A function was on the left side of the specified operator. The most common reason for this error is that the compiler has parsed the identifier on the left side of the operator as a function when the developer intended it to be a variable. For more information, see Wikipedia article [Most vexing parse](https://en.wikipedia.org/wiki/Most_vexing_parse). This example shows a function declaration and a variable definition that are easily confused: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md index b825312531a..a6b6859dbaa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md @@ -8,7 +8,7 @@ ms.assetid: 2e01a1db-4f00-4df6-a04d-cb6f70a6922b --- # Compiler Error C2660 -'function' : function does not take number parameters +> 'function' : function does not take number parameters The function is called with an incorrect number of parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md index 9f2a5bbc1c3..c82452258af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md @@ -8,7 +8,7 @@ ms.assetid: 60021467-71cd-451b-9877-23840c69309f --- # Compiler Error C2661 -'function' : no overloaded function takes number parameters +> 'function' : no overloaded function takes number parameters Possible causes: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md index 0afdad4fbd3..58536b7b348 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md @@ -8,7 +8,7 @@ ms.assetid: e172c2a4-f29e-4034-8232-e7dc6f83689f --- # Compiler Error C2662 -'function' : cannot convert 'this' pointer from 'type1' to 'type2' +> 'function' : cannot convert 'this' pointer from 'type1' to 'type2' The compiler could not convert the **`this`** pointer from `type1` to `type2`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md index 8c3e53207f7..f286362f59d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md @@ -8,7 +8,7 @@ ms.assetid: 1e93e368-fd52-42bf-9908-9b6df467c8c9 --- # Compiler Error C2663 -'function' : number overloads have no legal conversions for 'this' pointer +> 'function' : number overloads have no legal conversions for 'this' pointer The compiler could not convert **`this`** to any of the overloaded versions of the member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md index 0c712df8206..1702da88834 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2664"] --- # Compiler Error C2664 -'function' : cannot convert argument n from 'type1' to 'type2' +> 'function' : cannot convert argument n from 'type1' to 'type2' This parameter conversion problem might happen if an instance of a class is created and an implicit conversion is attempted on a constructor marked with the **`explicit`** keyword. For more information about explicit conversions, see [User-Defined Type Conversions](../../cpp/user-defined-type-conversions-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md index c1efc17c246..3612b411e83 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md @@ -8,7 +8,7 @@ ms.assetid: a7f99b61-2eae-4f2b-ba75-ea68fd1e8312 --- # Compiler Error C2665 -'function' : none of the number1 overloads can convert parameter number2 from type 'type' +> 'function' : none of the number1 overloads can convert parameter number2 from type 'type' A parameter of the overloaded function cannot be converted to the required type. Possible resolutions: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md index 7307e34bb41..68ab888df63 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md @@ -8,7 +8,7 @@ ms.assetid: 78364d15-c6eb-439a-9088-e04a0176692b --- # Compiler Error C2666 -'identifier' : number overloads have similar conversions +> 'identifier' : number overloads have similar conversions An overloaded function or operator is ambiguous. Formal parameter lists may be too similar for the compiler to resolve the ambiguity. To resolve this error, explicitly cast one or more of the actual parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2667.md b/docs/error-messages/compiler-errors-2/compiler-error-c2667.md index 17887deb7b7..e13c448100e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2667.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2667.md @@ -8,7 +8,7 @@ ms.assetid: 3c91d9d1-18fa-4e0d-a9ba-984d38980ca3 --- # Compiler Error C2667 -'function' : none of number overloads have a best conversion +> 'function' : none of number overloads have a best conversion An overloaded function call is ambiguous and cannot be resolved. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md index c2145433cb5..cea33fd770e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md @@ -8,7 +8,7 @@ ms.assetid: f9cb8111-bcdc-484b-a863-2c42e15a0496 --- # Compiler Error C2669 -member function not allowed in anonymous union +> member function not allowed in anonymous union [Anonymous unions](../../cpp/unions.md#anonymous_unions) cannot have member functions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2670.md b/docs/error-messages/compiler-errors-2/compiler-error-c2670.md index be41ed903cd..4cf871f2a5f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2670.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2670.md @@ -8,7 +8,7 @@ ms.assetid: 4b3b74c7-a750-4b0d-abd3-216d1234461f --- # Compiler Error C2670 -'identifier' : the function template cannot convert parameter number from type 'type' +> 'identifier' : the function template cannot convert parameter number from type 'type' A parameter could not be converted to the required type. From 270ac1793b3d371ab6075f7b59c78a4ef9817d3b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 3 Aug 2025 22:37:19 +0800 Subject: [PATCH 0617/1799] Add "Remarks" and "Example" headings for error references in range [C2651, C2670] --- .../compiler-errors-2/compiler-error-c2651.md | 2 ++ .../compiler-errors-2/compiler-error-c2652.md | 4 ++++ .../compiler-errors-2/compiler-error-c2653.md | 2 ++ .../compiler-errors-2/compiler-error-c2654.md | 2 ++ .../compiler-errors-2/compiler-error-c2655.md | 4 ++++ .../compiler-errors-2/compiler-error-c2656.md | 2 ++ .../compiler-errors-2/compiler-error-c2657.md | 4 ++++ .../compiler-errors-2/compiler-error-c2658.md | 4 ++++ .../compiler-errors-2/compiler-error-c2659.md | 8 +++++++- .../compiler-errors-2/compiler-error-c2660.md | 2 ++ .../compiler-errors-2/compiler-error-c2661.md | 4 ++++ .../compiler-errors-2/compiler-error-c2662.md | 4 ++++ .../compiler-errors-2/compiler-error-c2663.md | 4 ++++ .../compiler-errors-2/compiler-error-c2664.md | 2 ++ .../compiler-errors-2/compiler-error-c2665.md | 2 ++ .../compiler-errors-2/compiler-error-c2666.md | 2 ++ .../compiler-errors-2/compiler-error-c2667.md | 2 ++ .../compiler-errors-2/compiler-error-c2668.md | 2 ++ .../compiler-errors-2/compiler-error-c2669.md | 2 ++ .../compiler-errors-2/compiler-error-c2670.md | 2 ++ 20 files changed, 59 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2651.md b/docs/error-messages/compiler-errors-2/compiler-error-c2651.md index 03dc4c56a2c..5d4fc1f2fa8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2651.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2651.md @@ -10,4 +10,6 @@ ms.assetid: c3524a89-47d1-43f6-9e20-2cda15f9ae8a > 'data type' : left of 'operator' must be a class, struct or union +## Remarks + To use a template parameter as if it is a class, specialize the class template with a class instead of an integral type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md index 352267ec77e..e2f5ae6f4d1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md @@ -10,8 +10,12 @@ ms.assetid: 6e3d1a90-a989-4088-8afd-dc82f6a2d66f > 'identifier' : illegal copy constructor: first parameter must not be an 'identifier' +## Remarks + The first parameter in the copy constructor has the same type as the class, structure, or union for which it is defined. The first parameter can be a reference to the type but not the type itself. +## Example + The following sample generates C2651: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md index dba63492f1a..8b982bdf31c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2653"] > '*identifier*' : is not a class or namespace name +## Remarks + The language syntax requires a class, structure, union, or namespace name here. This error can occur when you use a name that has not been declared as a class, structure, union, or namespace in front of a scope operator. To fix this issue, declare the name or include the header that declares the name before it is used. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2654.md b/docs/error-messages/compiler-errors-2/compiler-error-c2654.md index af61c405fe8..36118cae469 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2654.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2654.md @@ -10,6 +10,8 @@ ms.assetid: ca7de1bd-576b-40bf-96fc-a91984827d20 > 'identifier' : attempt to access member outside a member function +## Remarks + A member is accessed in a declaration. Member data can be accessed only in member functions. This error can be caused when trying to initialize variables in a declaration. Use a constructor for this purpose. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md index 901b218fc4b..95ec7404dd2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md @@ -10,8 +10,12 @@ ms.assetid: beaefa6e-51b3-4df9-9150-960f3fbf40e0 > 'identifier' : definition or redeclaration illegal in current scope +## Remarks + An identifier can be redeclared only at global scope. +## Example + The following sample generates C2655: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2656.md b/docs/error-messages/compiler-errors-2/compiler-error-c2656.md index d001d70f592..9b06f3710ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2656.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2656.md @@ -10,6 +10,8 @@ ms.assetid: 1ec91186-0735-4904-859b-59da9af2d426 > 'function' : function not allowed as a bit field +## Remarks + A function is declared as a member of a bit field. This error can be caused by a syntax error in a constructor initializer list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md index 46b73efb557..90fd9ecd194 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md @@ -10,10 +10,14 @@ ms.assetid: f7cf29a9-684a-4605-9469-ecfee9ba4b03 > 'class::*' found at the start of a statement (did you forget to specify a type?) +## Remarks + The line began with a pointer-to-member identifier. This error can be caused by a missing type specifier in the declaration of a pointer to a member. +## Example + The following sample generates C2657: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md index 0f4c4538f5b..b933022d92a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md @@ -10,8 +10,12 @@ ms.assetid: 638368e8-7893-4a14-abec-13c768a9543a > 'member': redefinition in anonymous struct/union +## Remarks + Two anonymous structures or unions contained member declarations with the same identifier but with different types. Under [/Za](../../build/reference/za-ze-disable-language-extensions.md), you will also get this error for members with the same identifier and type. +## Example + The following sample generates C2658: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2659.md b/docs/error-messages/compiler-errors-2/compiler-error-c2659.md index 562b7ce3e2b..b20a97393ed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2659.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2659.md @@ -10,7 +10,13 @@ ms.assetid: b0883600-4d27-4ca7-a931-8ca6bd48654d > 'operator' : function as left operand -A function was on the left side of the specified operator. The most common reason for this error is that the compiler has parsed the identifier on the left side of the operator as a function when the developer intended it to be a variable. For more information, see Wikipedia article [Most vexing parse](https://en.wikipedia.org/wiki/Most_vexing_parse). This example shows a function declaration and a variable definition that are easily confused: +## Remarks + +A function was on the left side of the specified operator. The most common reason for this error is that the compiler has parsed the identifier on the left side of the operator as a function when the developer intended it to be a variable. For more information, see Wikipedia article [Most vexing parse](https://en.wikipedia.org/wiki/Most_vexing_parse). + +## Examples + +This example shows a function declaration and a variable definition that are easily confused: ```cpp // C2659a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md index a6b6859dbaa..db256210d61 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md @@ -10,6 +10,8 @@ ms.assetid: 2e01a1db-4f00-4df6-a04d-cb6f70a6922b > 'function' : function does not take number parameters +## Remarks + The function is called with an incorrect number of parameters. C2660 can occur if you accidentally call a Windows API function rather than an MFC member function of the same name. To solve this problem: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md index c82452258af..0b5f3085d0e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md @@ -10,12 +10,16 @@ ms.assetid: 60021467-71cd-451b-9877-23840c69309f > 'function' : no overloaded function takes number parameters +## Remarks + Possible causes: 1. Incorrect actual parameters in function call. 1. Missing function declaration. +## Example + The following sample generates C2661: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md index 58536b7b348..54de644d030 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md @@ -10,6 +10,8 @@ ms.assetid: e172c2a4-f29e-4034-8232-e7dc6f83689f > 'function' : cannot convert 'this' pointer from 'type1' to 'type2' +## Remarks + The compiler could not convert the **`this`** pointer from `type1` to `type2`. This error can be caused by invoking a non-**`const`** member function on a **`const`** object. Possible resolutions: @@ -18,6 +20,8 @@ This error can be caused by invoking a non-**`const`** member function on a **`c - Add **`const`** to the member function. +## Examples + The following sample generates C2662: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md index f286362f59d..ce9065b570d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md @@ -10,6 +10,8 @@ ms.assetid: 1e93e368-fd52-42bf-9908-9b6df467c8c9 > 'function' : number overloads have no legal conversions for 'this' pointer +## Remarks + The compiler could not convert **`this`** to any of the overloaded versions of the member function. This error can be caused by invoking a non-**`const`** member function on a **`const`** object. Possible resolutions: @@ -18,6 +20,8 @@ This error can be caused by invoking a non-**`const`** member function on a **`c 1. Add **`const`** to one of the member function overloads. +## Example + The following sample generates C2663: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md index 1702da88834..da226bbd2be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2664"] > 'function' : cannot convert argument n from 'type1' to 'type2' +## Remarks + This parameter conversion problem might happen if an instance of a class is created and an implicit conversion is attempted on a constructor marked with the **`explicit`** keyword. For more information about explicit conversions, see [User-Defined Type Conversions](../../cpp/user-defined-type-conversions-cpp.md). If a temporary object is passed to a function that takes a reference to an object as a parameter, that reference must be a **`const`** reference. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md index 3612b411e83..9d7f3c23ff6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md @@ -10,6 +10,8 @@ ms.assetid: a7f99b61-2eae-4f2b-ba75-ea68fd1e8312 > 'function' : none of the number1 overloads can convert parameter number2 from type 'type' +## Remarks + A parameter of the overloaded function cannot be converted to the required type. Possible resolutions: - Supply a conversion operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md index 68ab888df63..369498837a9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md @@ -10,6 +10,8 @@ ms.assetid: 78364d15-c6eb-439a-9088-e04a0176692b > 'identifier' : number overloads have similar conversions +## Remarks + An overloaded function or operator is ambiguous. Formal parameter lists may be too similar for the compiler to resolve the ambiguity. To resolve this error, explicitly cast one or more of the actual parameters. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2667.md b/docs/error-messages/compiler-errors-2/compiler-error-c2667.md index e13c448100e..2d20c8c3324 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2667.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2667.md @@ -10,6 +10,8 @@ ms.assetid: 3c91d9d1-18fa-4e0d-a9ba-984d38980ca3 > 'function' : none of number overloads have a best conversion +## Remarks + An overloaded function call is ambiguous and cannot be resolved. The conversion required to match the actual parameters in the function call to one of the overloaded functions must be strictly better than the conversions required by all the other overloaded functions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2668.md b/docs/error-messages/compiler-errors-2/compiler-error-c2668.md index 797a39b3122..ceae45ae6fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2668.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2668.md @@ -10,6 +10,8 @@ ms.assetid: 041e9627-1c76-420e-a653-cfc83f933bd3 > 'function' : ambiguous call to overloaded function +## Remarks + The specified overloaded function call couldn't be resolved. You may want to explicitly cast one or more of the actual parameters. You can also get this error through template use. If, in the same class, you have a regular member function and a templated member function with the same signature, the templated one must come first. This limitation remains in the current implementation of Visual C++. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md index cea33fd770e..446e21f6f22 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md @@ -10,6 +10,8 @@ ms.assetid: f9cb8111-bcdc-484b-a863-2c42e15a0496 > member function not allowed in anonymous union +## Remarks + [Anonymous unions](../../cpp/unions.md#anonymous_unions) cannot have member functions. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2670.md b/docs/error-messages/compiler-errors-2/compiler-error-c2670.md index 4cf871f2a5f..3e57c07c735 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2670.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2670.md @@ -10,6 +10,8 @@ ms.assetid: 4b3b74c7-a750-4b0d-abd3-216d1234461f > 'identifier' : the function template cannot convert parameter number from type 'type' +## Remarks + A parameter could not be converted to the required type. This error may be fixed if you create an explicit conversion. From 43cfbc572722836f5f83f2c016a604a045b5d215 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 3 Aug 2025 22:38:52 +0800 Subject: [PATCH 0618/1799] Replace term "sample" with "example" for error references in range [C2651, C2670] --- .../compiler-errors-2/compiler-error-c2652.md | 2 +- .../compiler-errors-2/compiler-error-c2653.md | 2 +- .../compiler-errors-2/compiler-error-c2655.md | 2 +- .../compiler-errors-2/compiler-error-c2657.md | 2 +- .../compiler-errors-2/compiler-error-c2658.md | 2 +- .../compiler-errors-2/compiler-error-c2660.md | 4 ++-- .../compiler-errors-2/compiler-error-c2661.md | 2 +- .../compiler-errors-2/compiler-error-c2662.md | 4 ++-- .../compiler-errors-2/compiler-error-c2663.md | 2 +- .../compiler-errors-2/compiler-error-c2664.md | 12 ++++++------ .../compiler-errors-2/compiler-error-c2665.md | 2 +- .../compiler-errors-2/compiler-error-c2666.md | 4 ++-- .../compiler-errors-2/compiler-error-c2668.md | 2 +- .../compiler-errors-2/compiler-error-c2669.md | 2 +- 14 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md index e2f5ae6f4d1..2c75924d829 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md @@ -16,7 +16,7 @@ The first parameter in the copy constructor has the same type as the class, stru ## Example -The following sample generates C2651: +The following example generates C2651: ```cpp // C2652.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md index 8b982bdf31c..658521dbf31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md @@ -19,7 +19,7 @@ C2653 is also possible if you try to define a *compound namespace*, a namespace ## Examples -This sample generates C2653 because a scope name is used but not declared. The compiler expects a class, structure, union, or namespace name before a scope operator (::). +This example generates C2653 because a scope name is used but not declared. The compiler expects a class, structure, union, or namespace name before a scope operator (::). ```cpp // C2653.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md index 95ec7404dd2..ed376ae3009 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md @@ -16,7 +16,7 @@ An identifier can be redeclared only at global scope. ## Example -The following sample generates C2655: +The following example generates C2655: ```cpp // C2655.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md index 90fd9ecd194..761645a93eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md @@ -18,7 +18,7 @@ This error can be caused by a missing type specifier in the declaration of a poi ## Example -The following sample generates C2657: +The following example generates C2657: ```cpp // C2657.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md index b933022d92a..b39e9e85240 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md @@ -16,7 +16,7 @@ Two anonymous structures or unions contained member declarations with the same i ## Example -The following sample generates C2658: +The following example generates C2658: ```cpp // C2658.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md index db256210d61..6858fd7a4e3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md @@ -22,7 +22,7 @@ C2660 can occur if you accidentally call a Windows API function rather than an M ## Examples -The following sample generates C2660. +The following example generates C2660. ```cpp // C2660.cpp @@ -34,7 +34,7 @@ int main() { } ``` -C2660 can also occur if you attempt to directly call the Dispose method of a managed type. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). The following sample generates C2660. +C2660 can also occur if you attempt to directly call the Dispose method of a managed type. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). The following example generates C2660. ```cpp // C2660_a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md index 0b5f3085d0e..19b8bde8c31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md @@ -20,7 +20,7 @@ Possible causes: ## Example -The following sample generates C2661: +The following example generates C2661: ```cpp // C2661.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md index 54de644d030..79960b74193 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md @@ -22,7 +22,7 @@ This error can be caused by invoking a non-**`const`** member function on a **`c ## Examples -The following sample generates C2662: +The following example generates C2662: ```cpp // C2662.cpp @@ -64,7 +64,7 @@ ref struct N { }; ``` -The following sample generates C2662: +The following example generates C2662: ```cpp // C2662_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md index ce9065b570d..3d170dbe35f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md @@ -22,7 +22,7 @@ This error can be caused by invoking a non-**`const`** member function on a **`c ## Example -The following sample generates C2663: +The following example generates C2663: ```cpp // C2663.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md index da226bbd2be..f08a2cb9704 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md @@ -29,7 +29,7 @@ For more information, see [How to: Convert System::String to wchar_t* or char\*] ## Examples -The following sample generates C2664 and shows how to fix it. +The following example generates C2664 and shows how to fix it. ```cpp // C2664.cpp @@ -51,7 +51,7 @@ int main() { } ``` -This sample also generates C2664 and shows how to fix it. +This example also generates C2664 and shows how to fix it. ```cpp // C2664b.cpp @@ -68,7 +68,7 @@ int main() { } ``` -The next sample demonstrates C2664 by using a string literal to call `Test`, and shows how to fix it. Because the parameter is an `szString` reference, an object must be created by the appropriate constructor. The result is a temporary object that cannot be used to initialize the reference. +The next example demonstrates C2664 by using a string literal to call `Test`, and shows how to fix it. Because the parameter is an `szString` reference, an object must be created by the appropriate constructor. The result is a temporary object that cannot be used to initialize the reference. ```cpp // C2664c.cpp @@ -107,7 +107,7 @@ int main() { } ``` -The compiler enforces the C++ standard requirements for applying **`const`**. This sample generates C2664: +The compiler enforces the C++ standard requirements for applying **`const`**. This example generates C2664: ```cpp // C2664d.cpp @@ -173,7 +173,7 @@ int main( ) { } ``` -An enum variable is not converted to its underlying type such that a function call will be satisfied. For more information, see [enum class](../../extensions/enum-class-cpp-component-extensions.md). The following sample generates C2664 and shows how to fix it. +An enum variable is not converted to its underlying type such that a function call will be satisfied. For more information, see [enum class](../../extensions/enum-class-cpp-component-extensions.md). The following example generates C2664 and shows how to fix it. ```cpp // C2664f.cpp @@ -216,7 +216,7 @@ library myproj1 { C2664 is also raised by using **`wchar_t`** when porting code from Visual C++ 6.0 to later versions. In Visual C++ 6.0 and earlier, **`wchar_t`** was a **`typedef`** for **`unsigned short`** and was therefore implicitly convertible to that type. After Visual C++ 6.0, **`wchar_t`** is its own built-in type, as specified in the C++ standard, and is no longer implicitly convertible to **`unsigned short`**. See [/Zc:wchar_t (wchar_t Is Native Type)](../../build/reference/zc-wchar-t-wchar-t-is-native-type.md). -The following sample generates C2664 and shows how to fix it. +The following example generates C2664 and shows how to fix it. ```cpp // C2664h.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md index 9d7f3c23ff6..4bc06cb2ffe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md @@ -20,7 +20,7 @@ A parameter of the overloaded function cannot be converted to the required type. ## Example -The following sample generates C2665. +The following example generates C2665. ```cpp // C2665.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md index 369498837a9..3beb56c0503 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md @@ -16,7 +16,7 @@ An overloaded function or operator is ambiguous. Formal parameter lists may be ## Examples -The following sample generates C2666: +The following example generates C2666: ```cpp // C2666.cpp @@ -143,7 +143,7 @@ int main() } ``` -The following sample generates C2666 +The following example generates C2666 ```cpp // C2666c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2668.md b/docs/error-messages/compiler-errors-2/compiler-error-c2668.md index ceae45ae6fb..08b2d1f39d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2668.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2668.md @@ -18,7 +18,7 @@ You can also get this error through template use. If, in the same class, you hav ## Examples -The following sample generates C2668: +The following example generates C2668: ```cpp // C2668.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md index 446e21f6f22..f78dcdc40f3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md @@ -16,7 +16,7 @@ ms.assetid: f9cb8111-bcdc-484b-a863-2c42e15a0496 ## Example -The following sample generates C2669: +The following example generates C2669: ```cpp // C2669.cpp From a4847bc930bb8c9da3eda45612760a9e9f3edb81 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 3 Aug 2025 22:42:07 +0800 Subject: [PATCH 0619/1799] Update metadata for error references in range [C2651, C2670] --- .../error-messages/compiler-errors-2/compiler-error-c2651.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2652.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2654.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2655.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2656.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2657.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2658.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2659.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2660.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2661.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2662.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2663.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2665.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2666.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2667.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2668.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2669.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2670.md | 5 ++--- 18 files changed, 34 insertions(+), 52 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2651.md b/docs/error-messages/compiler-errors-2/compiler-error-c2651.md index 5d4fc1f2fa8..14c8d273955 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2651.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2651.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2651" title: "Compiler Error C2651" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2651" +ms.date: 11/04/2016 f1_keywords: ["C2651"] helpviewer_keywords: ["C2651"] -ms.assetid: c3524a89-47d1-43f6-9e20-2cda15f9ae8a --- # Compiler Error C2651 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md index 2c75924d829..062e00a09ed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2652" title: "Compiler Error C2652" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2652" +ms.date: 11/04/2016 f1_keywords: ["C2652"] helpviewer_keywords: ["C2652"] -ms.assetid: 6e3d1a90-a989-4088-8afd-dc82f6a2d66f --- # Compiler Error C2652 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2654.md b/docs/error-messages/compiler-errors-2/compiler-error-c2654.md index 36118cae469..2c7a489eb1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2654.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2654.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2654" title: "Compiler Error C2654" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2654" +ms.date: 11/04/2016 f1_keywords: ["C2654"] helpviewer_keywords: ["C2654"] -ms.assetid: ca7de1bd-576b-40bf-96fc-a91984827d20 --- # Compiler Error C2654 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md index ed376ae3009..4169ae3ee9f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2655" title: "Compiler Error C2655" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2655" +ms.date: 11/04/2016 f1_keywords: ["C2655"] helpviewer_keywords: ["C2655"] -ms.assetid: beaefa6e-51b3-4df9-9150-960f3fbf40e0 --- # Compiler Error C2655 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2656.md b/docs/error-messages/compiler-errors-2/compiler-error-c2656.md index 9b06f3710ca..acdffd18ea1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2656.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2656.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2656" title: "Compiler Error C2656" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2656" +ms.date: 11/04/2016 f1_keywords: ["C2656"] helpviewer_keywords: ["C2656"] -ms.assetid: 1ec91186-0735-4904-859b-59da9af2d426 --- # Compiler Error C2656 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md index 761645a93eb..af0af9e0dd2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2657" title: "Compiler Error C2657" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2657" +ms.date: 11/04/2016 f1_keywords: ["C2657"] helpviewer_keywords: ["C2657"] -ms.assetid: f7cf29a9-684a-4605-9469-ecfee9ba4b03 --- # Compiler Error C2657 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md index b39e9e85240..fb3c762da11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2658" title: "Compiler Error C2658" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2658" +ms.date: 11/04/2016 f1_keywords: ["C2658"] helpviewer_keywords: ["C2658"] -ms.assetid: 638368e8-7893-4a14-abec-13c768a9543a --- # Compiler Error C2658 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2659.md b/docs/error-messages/compiler-errors-2/compiler-error-c2659.md index b20a97393ed..d02a04abd4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2659.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2659.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2659" title: "Compiler Error C2659" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2659" +ms.date: 11/04/2016 f1_keywords: ["C2659"] helpviewer_keywords: ["C2659"] -ms.assetid: b0883600-4d27-4ca7-a931-8ca6bd48654d --- # Compiler Error C2659 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md index 6858fd7a4e3..206114d0ac4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2660" title: "Compiler Error C2660" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2660" +ms.date: 11/04/2016 f1_keywords: ["C2660"] helpviewer_keywords: ["C2660"] -ms.assetid: 2e01a1db-4f00-4df6-a04d-cb6f70a6922b --- # Compiler Error C2660 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md index 19b8bde8c31..720b9f3334e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2661" title: "Compiler Error C2661" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2661" +ms.date: 11/04/2016 f1_keywords: ["C2661"] helpviewer_keywords: ["C2661"] -ms.assetid: 60021467-71cd-451b-9877-23840c69309f --- # Compiler Error C2661 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md index 79960b74193..b6184513912 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2662" title: "Compiler Error C2662" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2662" +ms.date: 11/04/2016 f1_keywords: ["C2662"] helpviewer_keywords: ["C2662"] -ms.assetid: e172c2a4-f29e-4034-8232-e7dc6f83689f --- # Compiler Error C2662 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md index 3d170dbe35f..8f6ee981e2b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2663" title: "Compiler Error C2663" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2663" +ms.date: 11/04/2016 f1_keywords: ["C2663"] helpviewer_keywords: ["C2663"] -ms.assetid: 1e93e368-fd52-42bf-9908-9b6df467c8c9 --- # Compiler Error C2663 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md index 4bc06cb2ffe..cc110cf8229 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2665" title: "Compiler Error C2665" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2665" +ms.date: 11/04/2016 f1_keywords: ["C2665"] helpviewer_keywords: ["C2665"] -ms.assetid: a7f99b61-2eae-4f2b-ba75-ea68fd1e8312 --- # Compiler Error C2665 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md index 3beb56c0503..9dbac3a9b13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2666" title: "Compiler Error C2666" +description: "Learn more about: Compiler Error C2666" ms.date: 10/18/2021 f1_keywords: ["C2666"] helpviewer_keywords: ["C2666"] -ms.assetid: 78364d15-c6eb-439a-9088-e04a0176692b --- # Compiler Error C2666 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2667.md b/docs/error-messages/compiler-errors-2/compiler-error-c2667.md index 2d20c8c3324..883874fb3d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2667.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2667.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2667" title: "Compiler Error C2667" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2667" +ms.date: 11/04/2016 f1_keywords: ["C2667"] helpviewer_keywords: ["C2667"] -ms.assetid: 3c91d9d1-18fa-4e0d-a9ba-984d38980ca3 --- # Compiler Error C2667 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2668.md b/docs/error-messages/compiler-errors-2/compiler-error-c2668.md index 08b2d1f39d5..5c85dee6a57 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2668.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2668.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2668" title: "Compiler Error C2668" +description: "Learn more about: Compiler Error C2668" ms.date: 05/03/2021 f1_keywords: ["C2668"] helpviewer_keywords: ["C2668"] -ms.assetid: 041e9627-1c76-420e-a653-cfc83f933bd3 --- # Compiler Error C2668 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md index f78dcdc40f3..13d58e90c33 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2669" title: "Compiler Error C2669" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2669" +ms.date: 11/04/2016 f1_keywords: ["C2669"] helpviewer_keywords: ["C2669"] -ms.assetid: f9cb8111-bcdc-484b-a863-2c42e15a0496 --- # Compiler Error C2669 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2670.md b/docs/error-messages/compiler-errors-2/compiler-error-c2670.md index 3e57c07c735..a1bfb105edc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2670.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2670.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2670" title: "Compiler Error C2670" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2670" +ms.date: 11/04/2016 f1_keywords: ["C2670"] helpviewer_keywords: ["C2670"] -ms.assetid: 4b3b74c7-a750-4b0d-abd3-216d1234461f --- # Compiler Error C2670 From f993805f2537bc2ee3c6ef1258c0a31eeacae204 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 4 Aug 2025 23:10:19 +0800 Subject: [PATCH 0620/1799] Add blockquotes for error messages in range [C2671, C2700] --- docs/error-messages/compiler-errors-2/compiler-error-c2671.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2673.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2674.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2675.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2677.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2678.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2679.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2680.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2681.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2682.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2683.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2687.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2688.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2689.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2690.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2691.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2692.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2693.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2694.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2695.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2696.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2698.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2700.md | 2 +- 23 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md index faa1b927d76..7792c1feda2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md @@ -8,7 +8,7 @@ ms.assetid: fc0ee40f-c8f3-408f-b89d-745d149c4169 --- # Compiler Error C2671 -'function' : static member functions do not have 'this' pointers +> 'function' : static member functions do not have 'this' pointers A **`static`** member function tried to access **`this`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md index b122a1aabbb..762c3810437 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md @@ -8,7 +8,7 @@ ms.assetid: 780230c0-619b-4a78-b01d-ff5886306741 --- # Compiler Error C2673 -'function' : global functions do not have 'this' pointers +> 'function' : global functions do not have 'this' pointers A global function tried to access **`this`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md index 6f86c485aaa..16263cd27c2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md @@ -8,7 +8,7 @@ ms.assetid: 7cbd70d8-d992-44d7-a5cb-dd8cf9c759d2 --- # Compiler Error C2674 -a generic declaration is not allowed in this context +> a generic declaration is not allowed in this context A generic was declared incorrectly. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md index 4bd9416580f..e256c1589bf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md @@ -8,7 +8,7 @@ ms.assetid: 4b92a12b-bff8-4dd5-a109-620065fc146c --- # Compiler Error C2675 -unary 'operator' : 'type' does not define this operator or a conversion to a type acceptable to the predefined operator +> unary 'operator' : 'type' does not define this operator or a conversion to a type acceptable to the predefined operator C2675 can also occur when using a unary operator, and the type does not define the operator or a conversion to a type acceptable to the predefined operator. To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md index e5e8937b497..8c14e1730e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md @@ -8,7 +8,7 @@ ms.assetid: 76bc0b65-f52a-45a6-b6d6-0555f89da9a8 --- # Compiler Error C2677 -binary 'operator' : no global operator found which takes type 'type' (or there is no acceptable conversion) +> binary 'operator' : no global operator found which takes type 'type' (or there is no acceptable conversion) To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md index 3c56b110b05..9febb975b8f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md @@ -8,7 +8,7 @@ ms.assetid: 1f0a4e26-b429-44f5-9f94-cb66441220c8 --- # Compiler Error C2678 -binary 'operator' : no operator defined which takes a left-hand operand of type 'type' (or there is no acceptable conversion) +> binary 'operator' : no operator defined which takes a left-hand operand of type 'type' (or there is no acceptable conversion) To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md index 41762a92db1..32e40394a13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md @@ -8,7 +8,7 @@ ms.assetid: 1a5f9d00-9190-4aa6-bc72-949f68ec136f --- # Compiler Error C2679 -binary 'operator' : no operator found which takes a right-hand operand of type 'type' (or there is no acceptable conversion) +> binary 'operator' : no operator found which takes a right-hand operand of type 'type' (or there is no acceptable conversion) To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md index de9fce157af..625d75eaa8c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md @@ -8,7 +8,7 @@ ms.assetid: d6f7129e-dd17-4661-b680-18d6b925b1cc --- # Compiler Error C2680 -'type' : invalid target type for name +> 'type' : invalid target type for name A casting operator tried to convert to a type that is not a pointer or reference. The [dynamic_cast](../../cpp/dynamic-cast-operator.md) operator can be used only for pointers or references. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md index 36739b95071..cb6db3a203a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md @@ -8,7 +8,7 @@ ms.assetid: eb42da6d-8d2c-43fd-986b-e73e2b004885 --- # Compiler Error C2681 -'type' : invalid expression type for name +> 'type' : invalid expression type for name A casting operator tried to convert from an invalid type. For example, if you use the [dynamic_cast](../../cpp/dynamic-cast-operator.md) operator to convert an expression to a pointer type, the source expression must be a pointer. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md index 09a250de791..2da2ecc1413 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md @@ -8,7 +8,7 @@ ms.assetid: 30c6a7c4-f5f7-4fe8-81a8-c48938521ab4 --- # Compiler Error C2682 -cannot use casting_operator to convert from 'type1' to 'type2' +> cannot use casting_operator to convert from 'type1' to 'type2' A casting operator tried to convert between incompatible types. For example, you cannot use the [dynamic_cast](../../cpp/dynamic-cast-operator.md) operator to convert a pointer to a reference. The **`dynamic_cast`** operator cannot be used to cast away qualifiers. All qualifiers on the types must match. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md index 27edb0c552f..8bd16ce09d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md @@ -8,7 +8,7 @@ ms.assetid: db605e4f-601b-4d05-92a1-c43ca24de08d --- # Compiler Error C2683 -'cast' : 'type' is not a polymorphic type +> 'cast' : 'type' is not a polymorphic type You cannot use [dynamic_cast](../../cpp/dynamic-cast-operator.md) to convert from a non-polymorphic class (a class with no virtual functions). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md index 9284b359bc2..8df00339cf5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md @@ -8,7 +8,7 @@ ms.assetid: 1d24b24a-cd0f-41cc-975c-b08dcfb7f402 --- # Compiler Error C2687 -'type' : exception-declaration cannot be 'void' or denote an incomplete type or pointer or reference to an incomplete type +> 'type' : exception-declaration cannot be 'void' or denote an incomplete type or pointer or reference to an incomplete type For a type to be part of an exception declaration, it must be defined and not void. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md index ddad95bbbfa..199432503f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md @@ -8,7 +8,7 @@ ms.assetid: 168c9e9d-8f65-4664-af86-db71d3e6ee46 --- # Compiler Error C2688 -'C2::fgrv' : covariant returns with multiple or virtual inheritance not supported for varargs functions +> 'C2::fgrv' : covariant returns with multiple or virtual inheritance not supported for varargs functions Covariant return types are not supported in Visual C++ when a function contains variable arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md index 82ab8e83b9d..b26e83ce448 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md @@ -8,7 +8,7 @@ ms.assetid: b5216fba-524d-4194-9168-26e9dc5210ce --- # Compiler Error C2689 -'function' : a friend function cannot be defined within a local class +> 'function' : a friend function cannot be defined within a local class You can declare but not define a friend function in a local class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2690.md b/docs/error-messages/compiler-errors-2/compiler-error-c2690.md index 8d9cf9f82a5..a9cd31387fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2690.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2690.md @@ -8,6 +8,6 @@ ms.assetid: f165a806-14bd-4942-99b7-8a9fc7dea227 --- # Compiler Error C2690 -'operator' : cannot perform pointer arithmetic on a managed or WinRT array +> 'operator' : cannot perform pointer arithmetic on a managed or WinRT array Pointer arithmetic is not allowed on a managed or WinRT array. Use array index notation to traverse the array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md index 9a6d9a67d90..7de70d5b519 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md @@ -8,7 +8,7 @@ ms.assetid: 6925f8f3-ea60-4909-91e6-b781492c645d --- # Compiler Error C2691 -'data type' : a managed or WinRTarray cannot have this element type +> 'data type' : a managed or WinRTarray cannot have this element type The type of a managed or WinRT array element can be a value type or a reference type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2692.md b/docs/error-messages/compiler-errors-2/compiler-error-c2692.md index cfeedd4078c..b27e4fd3fb0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2692.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2692.md @@ -8,6 +8,6 @@ ms.assetid: 02ade3b4-b757-448b-b065-d7d71bc3f441 --- # Compiler Error C2692 -'function_name' : fully prototyped functions required in C compiler with the '/clr' option +> 'function_name' : fully prototyped functions required in C compiler with the '/clr' option When compiling for .NET managed code, the C compiler requires ANSI function declarations. In addition, if a function takes no parameters, it must explicitly declare **`void`** as the parameter type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2693.md b/docs/error-messages/compiler-errors-2/compiler-error-c2693.md index d26adbe71c5..181a17a9a9e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2693.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2693.md @@ -8,6 +8,6 @@ ms.assetid: b7364ca8-b6be-48c0-97d6-6029787fb171 --- # Compiler Error C2693 -'operator' : illegal comparison for references to a managed or WinRT array +> 'operator' : illegal comparison for references to a managed or WinRT array You cannot test a managed or WinRT array for any kind of inequality. For example, you can test to see if managed arrays are equal but you cannot test to see if one array is greater or less than another array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md index c093639deba..f739bea83ee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md @@ -8,7 +8,7 @@ ms.assetid: 8dc2cec2-67ae-4e16-8c0c-374425aca8bc --- # Compiler Error C2694 -'override': overriding virtual function has less restrictive exception specification than base class virtual member function 'base' +> 'override': overriding virtual function has less restrictive exception specification than base class virtual member function 'base' A virtual function was overridden, but under [/Za](../../build/reference/za-ze-disable-language-extensions.md), the overriding function had a less restrictive [exception specification](../../cpp/exception-specifications-throw-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md index 5b24ca30b5d..2184a0f6dba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md @@ -8,7 +8,7 @@ ms.assetid: 3f6f2091-c38b-40ea-ab6c-f1846f5702d7 --- # Compiler Error C2695 -'function1': overriding virtual function differs from 'function2' only by calling convention +> 'function1': overriding virtual function differs from 'function2' only by calling convention The signature of a function in a derived class cannot override a function in a base class and change the calling convention. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2696.md b/docs/error-messages/compiler-errors-2/compiler-error-c2696.md index 4939dc99786..eb8f96f9c79 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2696.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2696.md @@ -8,7 +8,7 @@ ms.assetid: 6c6eb7df-1230-4346-9a73-abf14c20785d --- # Compiler Error C2696 -Cannot create a temporary object of a managed type 'type' +> Cannot create a temporary object of a managed type 'type' References to **`const`** in an unmanaged program cause the compiler to call the constructor and create a temporary object on the stack. However, a managed class can never be created on the stack. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md index efdb26599fb..d03fd78e180 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md @@ -8,7 +8,7 @@ ms.assetid: 3ebfe395-c20b-4c56-9980-ca9ed8653382 --- # Compiler Error C2698 -the using-declaration for 'declaration 1' cannot co-exist with the existing using-declaration for 'declaration 2' +> the using-declaration for 'declaration 1' cannot co-exist with the existing using-declaration for 'declaration 2' Once you have a [using declaration](../../cpp/using-declaration.md) for a data member, any using declaration in the same scope that uses the same name is not permitted, as only functions can be overloaded. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2700.md b/docs/error-messages/compiler-errors-2/compiler-error-c2700.md index d843b7d0d84..66d4ca729c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2700.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2700.md @@ -8,6 +8,6 @@ ms.assetid: a231eb86-bdae-4b37-a606-06854f47929f --- # Compiler Error C2700 -'identifier' : cannot be thrown (use /W4 for more info) +> 'identifier' : cannot be thrown (use /W4 for more info) The object cannot be thrown. Compile with [/W4](../../build/reference/compiler-option-warning-level.md) for more diagnostic information. From 22a615cc1afd05815804528772a17e18c5b21d6d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 4 Aug 2025 23:16:36 +0800 Subject: [PATCH 0621/1799] Add "Remarks" and "Example" headings for error references in range [C2671, C2700] --- docs/error-messages/compiler-errors-2/compiler-error-c2671.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2672.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2673.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2674.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2675.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2677.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2678.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2679.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2680.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2681.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2682.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2683.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2687.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2688.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2689.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2690.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2691.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2692.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2693.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2694.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2695.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2696.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2698.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2700.md | 2 ++ 24 files changed, 78 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md index 7792c1feda2..d133fc86546 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md @@ -10,8 +10,12 @@ ms.assetid: fc0ee40f-c8f3-408f-b89d-745d149c4169 > 'function' : static member functions do not have 'this' pointers +## Remarks + A **`static`** member function tried to access **`this`**. +## Example + The following sample generates C2671: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2672.md b/docs/error-messages/compiler-errors-2/compiler-error-c2672.md index a43ddf67cc8..d88fc22d35a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2672.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2672.md @@ -10,6 +10,8 @@ ms.assetid: 7e86338a-2d4b-40fe-9dd2-ac6886f3f31a > '*function*': no matching overloaded function found +## Remarks + The compiler could not find an overloaded function that matches the specified function. No function was found that takes matching parameters, or no matching function has the required accessibility in context. When used by certain standard library containers or algorithms, your types must provide accessible members or friend functions that satisfy the requirements of the container or algorithm. For example, your iterator types should derive from `std::iterator<>`. Comparison operations or use of other operators on container element types may require the type be considered as both a left-hand and a right-hand operand. Use of the type as a right-hand operand can require implementation of the operator as a non-member function of the type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md index 762c3810437..50a6c762e73 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md @@ -10,8 +10,12 @@ ms.assetid: 780230c0-619b-4a78-b01d-ff5886306741 > 'function' : global functions do not have 'this' pointers +## Remarks + A global function tried to access **`this`**. +## Example + The following sample generates C2673: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md index 16263cd27c2..8d32ee39a9e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md @@ -10,6 +10,8 @@ ms.assetid: 7cbd70d8-d992-44d7-a5cb-dd8cf9c759d2 > a generic declaration is not allowed in this context +## Remarks + A generic was declared incorrectly. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md index e256c1589bf..34b5400c1d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md @@ -10,6 +10,8 @@ ms.assetid: 4b92a12b-bff8-4dd5-a109-620065fc146c > unary 'operator' : 'type' does not define this operator or a conversion to a type acceptable to the predefined operator +## Remarks + C2675 can also occur when using a unary operator, and the type does not define the operator or a conversion to a type acceptable to the predefined operator. To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md index 8c14e1730e2..7bc9e69b045 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md @@ -10,8 +10,12 @@ ms.assetid: 76bc0b65-f52a-45a6-b6d6-0555f89da9a8 > binary 'operator' : no global operator found which takes type 'type' (or there is no acceptable conversion) +## Remarks + To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. +## Example + The following sample generates C2677: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md index 9febb975b8f..de4186fb505 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md @@ -10,6 +10,8 @@ ms.assetid: 1f0a4e26-b429-44f5-9f94-cb66441220c8 > binary 'operator' : no operator defined which takes a left-hand operand of type 'type' (or there is no acceptable conversion) +## Remarks + To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. C2678 can occur when the left-hand operand is const-qualified but the operator is defined to take a non-const argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md index 32e40394a13..ffbe2780e10 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md @@ -10,8 +10,12 @@ ms.assetid: 1a5f9d00-9190-4aa6-bc72-949f68ec136f > binary 'operator' : no operator found which takes a right-hand operand of type 'type' (or there is no acceptable conversion) +## Remarks + To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. +## Example + The following sample generates C2679: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md index 625d75eaa8c..98c2bb56a5d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md @@ -10,8 +10,12 @@ ms.assetid: d6f7129e-dd17-4661-b680-18d6b925b1cc > 'type' : invalid target type for name +## Remarks + A casting operator tried to convert to a type that is not a pointer or reference. The [dynamic_cast](../../cpp/dynamic-cast-operator.md) operator can be used only for pointers or references. +## Examples + The following sample generates C2680: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md index cb6db3a203a..d2926a448ad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md @@ -10,8 +10,12 @@ ms.assetid: eb42da6d-8d2c-43fd-986b-e73e2b004885 > 'type' : invalid expression type for name +## Remarks + A casting operator tried to convert from an invalid type. For example, if you use the [dynamic_cast](../../cpp/dynamic-cast-operator.md) operator to convert an expression to a pointer type, the source expression must be a pointer. +## Example + The following sample generates C2681: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md index 2da2ecc1413..81712cc6b1d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md @@ -10,10 +10,14 @@ ms.assetid: 30c6a7c4-f5f7-4fe8-81a8-c48938521ab4 > cannot use casting_operator to convert from 'type1' to 'type2' +## Remarks + A casting operator tried to convert between incompatible types. For example, you cannot use the [dynamic_cast](../../cpp/dynamic-cast-operator.md) operator to convert a pointer to a reference. The **`dynamic_cast`** operator cannot be used to cast away qualifiers. All qualifiers on the types must match. You can use the **`const_cast`** operator to remove attributes such as **`const`**, **`volatile`**, or **`__unaligned`**. +## Examples + The following sample generates C2682: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md index 8bd16ce09d7..27143e499b7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md @@ -10,10 +10,14 @@ ms.assetid: db605e4f-601b-4d05-92a1-c43ca24de08d > 'cast' : 'type' is not a polymorphic type +## Remarks + You cannot use [dynamic_cast](../../cpp/dynamic-cast-operator.md) to convert from a non-polymorphic class (a class with no virtual functions). You can use [static_cast](../../cpp/static-cast-operator.md) to perform conversions of non-polymorphic types. However, **`static_cast`** does not perform a run-time check. +## Example + The following sample generates C2683: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md index 8df00339cf5..be27a741e94 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md @@ -10,8 +10,12 @@ ms.assetid: 1d24b24a-cd0f-41cc-975c-b08dcfb7f402 > 'type' : exception-declaration cannot be 'void' or denote an incomplete type or pointer or reference to an incomplete type +## Remarks + For a type to be part of an exception declaration, it must be defined and not void. +## Example + The following sample generates C2687: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md index 199432503f6..cd78550485f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md @@ -10,10 +10,14 @@ ms.assetid: 168c9e9d-8f65-4664-af86-db71d3e6ee46 > 'C2::fgrv' : covariant returns with multiple or virtual inheritance not supported for varargs functions +## Remarks + Covariant return types are not supported in Visual C++ when a function contains variable arguments. To resolve this error, either define your functions so that they do not use variable arguments or make the return values the same for all virtual functions. +## Example + The following sample generates C2688: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md index b26e83ce448..dbe836241ba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md @@ -10,8 +10,12 @@ ms.assetid: b5216fba-524d-4194-9168-26e9dc5210ce > 'function' : a friend function cannot be defined within a local class +## Remarks + You can declare but not define a friend function in a local class. +## Example + The following sample generates C2689: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2690.md b/docs/error-messages/compiler-errors-2/compiler-error-c2690.md index a9cd31387fd..636019fb18f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2690.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2690.md @@ -10,4 +10,6 @@ ms.assetid: f165a806-14bd-4942-99b7-8a9fc7dea227 > 'operator' : cannot perform pointer arithmetic on a managed or WinRT array +## Remarks + Pointer arithmetic is not allowed on a managed or WinRT array. Use array index notation to traverse the array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md index 7de70d5b519..b207f9a9969 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md @@ -10,8 +10,12 @@ ms.assetid: 6925f8f3-ea60-4909-91e6-b781492c645d > 'data type' : a managed or WinRTarray cannot have this element type +## Remarks + The type of a managed or WinRT array element can be a value type or a reference type. +## Example + The following sample generates C2691: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2692.md b/docs/error-messages/compiler-errors-2/compiler-error-c2692.md index b27e4fd3fb0..480cf0de7b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2692.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2692.md @@ -10,4 +10,6 @@ ms.assetid: 02ade3b4-b757-448b-b065-d7d71bc3f441 > 'function_name' : fully prototyped functions required in C compiler with the '/clr' option +## Remarks + When compiling for .NET managed code, the C compiler requires ANSI function declarations. In addition, if a function takes no parameters, it must explicitly declare **`void`** as the parameter type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2693.md b/docs/error-messages/compiler-errors-2/compiler-error-c2693.md index 181a17a9a9e..2cb222390ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2693.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2693.md @@ -10,4 +10,6 @@ ms.assetid: b7364ca8-b6be-48c0-97d6-6029787fb171 > 'operator' : illegal comparison for references to a managed or WinRT array +## Remarks + You cannot test a managed or WinRT array for any kind of inequality. For example, you can test to see if managed arrays are equal but you cannot test to see if one array is greater or less than another array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md index f739bea83ee..0486e75ae9d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md @@ -10,8 +10,12 @@ ms.assetid: 8dc2cec2-67ae-4e16-8c0c-374425aca8bc > 'override': overriding virtual function has less restrictive exception specification than base class virtual member function 'base' +## Remarks + A virtual function was overridden, but under [/Za](../../build/reference/za-ze-disable-language-extensions.md), the overriding function had a less restrictive [exception specification](../../cpp/exception-specifications-throw-cpp.md). +## Example + The following sample generates C2694: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md index 2184a0f6dba..80d124f911e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md @@ -10,8 +10,12 @@ ms.assetid: 3f6f2091-c38b-40ea-ab6c-f1846f5702d7 > 'function1': overriding virtual function differs from 'function2' only by calling convention +## Remarks + The signature of a function in a derived class cannot override a function in a base class and change the calling convention. +## Example + The following sample generates C2695: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2696.md b/docs/error-messages/compiler-errors-2/compiler-error-c2696.md index eb8f96f9c79..921c2aa9bfc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2696.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2696.md @@ -10,6 +10,8 @@ ms.assetid: 6c6eb7df-1230-4346-9a73-abf14c20785d > Cannot create a temporary object of a managed type 'type' +## Remarks + References to **`const`** in an unmanaged program cause the compiler to call the constructor and create a temporary object on the stack. However, a managed class can never be created on the stack. C2696 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md index d03fd78e180..aa56f166aa8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md @@ -10,8 +10,12 @@ ms.assetid: 3ebfe395-c20b-4c56-9980-ca9ed8653382 > the using-declaration for 'declaration 1' cannot co-exist with the existing using-declaration for 'declaration 2' +## Remarks + Once you have a [using declaration](../../cpp/using-declaration.md) for a data member, any using declaration in the same scope that uses the same name is not permitted, as only functions can be overloaded. +## Example + The following sample generates C2698: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2700.md b/docs/error-messages/compiler-errors-2/compiler-error-c2700.md index 66d4ca729c7..b1a400565df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2700.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2700.md @@ -10,4 +10,6 @@ ms.assetid: a231eb86-bdae-4b37-a606-06854f47929f > 'identifier' : cannot be thrown (use /W4 for more info) +## Remarks + The object cannot be thrown. Compile with [/W4](../../build/reference/compiler-option-warning-level.md) for more diagnostic information. From 02fdfa6c14933cbf6ced249e93ca135c3cc33ef2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 4 Aug 2025 23:18:19 +0800 Subject: [PATCH 0622/1799] Replace term "sample" with "example" for error references in range [C2671, C2700] --- docs/error-messages/compiler-errors-2/compiler-error-c2671.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2673.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2674.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2675.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2676.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2677.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2678.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2679.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2680.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2681.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2682.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2683.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2687.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2688.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2689.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2691.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2694.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2695.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2698.md | 2 +- 19 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md index d133fc86546..8195a903290 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md @@ -16,7 +16,7 @@ A **`static`** member function tried to access **`this`**. ## Example -The following sample generates C2671: +The following example generates C2671: ```cpp // C2671.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md index 50a6c762e73..4fb9ca3aac7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md @@ -16,7 +16,7 @@ A global function tried to access **`this`**. ## Example -The following sample generates C2673: +The following example generates C2673: ```cpp // C2673.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md index 8d32ee39a9e..f89a9e7d94d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md @@ -16,7 +16,7 @@ A generic was declared incorrectly. For more information, see [Generics](../../e ## Example -The following sample generates C2674. +The following example generates C2674. ```cpp // C2674.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md index 34b5400c1d5..05d53f12ce8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md @@ -16,7 +16,7 @@ C2675 can also occur when using a unary operator, and the type does not define t ## Example -The following sample generates C2675. +The following example generates C2675. ```cpp // C2675.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2676.md b/docs/error-messages/compiler-errors-2/compiler-error-c2676.md index c2368b92a68..a4d5256bf68 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2676.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2676.md @@ -16,7 +16,7 @@ To use the operator, you must overload it for the specified type or define a con ## Examples -The following sample generates C2676. +The following example generates C2676. ```cpp // C2676.cpp @@ -50,7 +50,7 @@ C2676 can also occur if you attempt to do pointer arithmetic on the **`this`** p The **`this`** pointer is of type handle in a reference type. For more information, see [Semantics of the `this` pointer](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Semantics_of_the_this_pointer). -The following sample generates C2676. +The following example generates C2676. ```cpp // C2676_a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md index 7bc9e69b045..bc94ad8fee1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md @@ -16,7 +16,7 @@ To use the operator, you must overload it for the specified type or define a con ## Example -The following sample generates C2677: +The following example generates C2677: ```cpp // C2677.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md index de4186fb505..b9675c6db08 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md @@ -18,7 +18,7 @@ C2678 can occur when the left-hand operand is const-qualified but the operator i ## Examples -The following sample generates C2678 and shows how to fix it: +The following example generates C2678 and shows how to fix it: ```cpp // C2678a.cpp @@ -44,7 +44,7 @@ int main() { C2678 can also occur if you do not pin a native member before calling a member function on it. -The following sample generates C2678 and shows how to fix it. +The following example generates C2678 and shows how to fix it. ```cpp // C2678.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md index ffbe2780e10..5dea528d0ba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md @@ -16,7 +16,7 @@ To use the operator, you must overload it for the specified type or define a con ## Example -The following sample generates C2679: +The following example generates C2679: ```cpp // C2679.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md index 98c2bb56a5d..cc925a38fb4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md @@ -16,7 +16,7 @@ A casting operator tried to convert to a type that is not a pointer or reference ## Examples -The following sample generates C2680: +The following example generates C2680: ```cpp // C2680.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md index d2926a448ad..1be75b3147e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md @@ -16,7 +16,7 @@ A casting operator tried to convert from an invalid type. For example, if you us ## Example -The following sample generates C2681: +The following example generates C2681: ```cpp // C2681.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md index 81712cc6b1d..00375c03ca4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md @@ -18,7 +18,7 @@ You can use the **`const_cast`** operator to remove attributes such as **`const` ## Examples -The following sample generates C2682: +The following example generates C2682: ```cpp // C2682.cpp @@ -30,7 +30,7 @@ void g(A* pa) { } ``` -The following sample generates C2682: +The following example generates C2682: ```cpp // C2682b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md index 27143e499b7..46677faca17 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md @@ -18,7 +18,7 @@ You can use [static_cast](../../cpp/static-cast-operator.md) to perform conversi ## Example -The following sample generates C2683: +The following example generates C2683: ```cpp // C2683.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md index be27a741e94..cc47a106cef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md @@ -16,7 +16,7 @@ For a type to be part of an exception declaration, it must be defined and not vo ## Example -The following sample generates C2687: +The following example generates C2687: ```cpp // C2687.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md index cd78550485f..56140fe8e06 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md @@ -18,7 +18,7 @@ To resolve this error, either define your functions so that they do not use vari ## Example -The following sample generates C2688: +The following example generates C2688: ```cpp // C2688.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md index dbe836241ba..f44a9aa8f02 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md @@ -16,7 +16,7 @@ You can declare but not define a friend function in a local class. ## Example -The following sample generates C2689: +The following example generates C2689: ```cpp // C2689.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md index b207f9a9969..3617dad801c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md @@ -16,7 +16,7 @@ The type of a managed or WinRT array element can be a value type or a reference ## Example -The following sample generates C2691: +The following example generates C2691: ```cpp // C2691a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md index 0486e75ae9d..1b2d626c7b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md @@ -16,7 +16,7 @@ A virtual function was overridden, but under [/Za](../../build/reference/za-ze-d ## Example -The following sample generates C2694: +The following example generates C2694: ```cpp // C2694.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md index 80d124f911e..d1d785f68d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md @@ -16,7 +16,7 @@ The signature of a function in a derived class cannot override a function in a b ## Example -The following sample generates C2695: +The following example generates C2695: ```cpp // C2695.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md index aa56f166aa8..478d4e26f51 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md @@ -16,7 +16,7 @@ Once you have a [using declaration](../../cpp/using-declaration.md) for a data m ## Example -The following sample generates C2698: +The following example generates C2698: ```cpp // C2698.cpp From d94c130240155c45c337e713bb4ead0b32439ce2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 4 Aug 2025 23:22:51 +0800 Subject: [PATCH 0623/1799] Update metadata for error references in range [C2671, C2700] --- .../error-messages/compiler-errors-2/compiler-error-c2671.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2672.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2673.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2674.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2675.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2676.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2677.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2678.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2679.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2680.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2681.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2682.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2683.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2687.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2688.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2689.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2690.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2691.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2692.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2693.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2694.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2695.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2696.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2698.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2700.md | 5 ++--- 25 files changed, 49 insertions(+), 74 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md index 8195a903290..fd2c623dd42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2671" title: "Compiler Error C2671" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2671" +ms.date: 11/04/2016 f1_keywords: ["C2671"] helpviewer_keywords: ["C2671"] -ms.assetid: fc0ee40f-c8f3-408f-b89d-745d149c4169 --- # Compiler Error C2671 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2672.md b/docs/error-messages/compiler-errors-2/compiler-error-c2672.md index d88fc22d35a..8af88f34643 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2672.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2672.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2672" title: "Compiler Error C2672" -ms.date: "10/24/2017" +description: "Learn more about: Compiler Error C2672" +ms.date: 10/24/2017 f1_keywords: ["C2672"] helpviewer_keywords: ["C2672"] -ms.assetid: 7e86338a-2d4b-40fe-9dd2-ac6886f3f31a --- # Compiler Error C2672 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md index 4fb9ca3aac7..bd53c6d9836 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2673" title: "Compiler Error C2673" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2673" +ms.date: 11/04/2016 f1_keywords: ["C2673"] helpviewer_keywords: ["C2673"] -ms.assetid: 780230c0-619b-4a78-b01d-ff5886306741 --- # Compiler Error C2673 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md index f89a9e7d94d..25f54555820 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2674" title: "Compiler Error C2674" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2674" +ms.date: 11/04/2016 f1_keywords: ["C2674"] helpviewer_keywords: ["C2674"] -ms.assetid: 7cbd70d8-d992-44d7-a5cb-dd8cf9c759d2 --- # Compiler Error C2674 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md index 05d53f12ce8..44d681044bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2675" title: "Compiler Error C2675" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2675" +ms.date: 11/04/2016 f1_keywords: ["C2675"] helpviewer_keywords: ["C2675"] -ms.assetid: 4b92a12b-bff8-4dd5-a109-620065fc146c --- # Compiler Error C2675 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2676.md b/docs/error-messages/compiler-errors-2/compiler-error-c2676.md index a4d5256bf68..f12d12d14d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2676.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2676.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2676" title: "Compiler Error C2676" +description: "Learn more about: Compiler Error C2676" ms.date: 06/03/2022 f1_keywords: ["C2676"] helpviewer_keywords: ["C2676"] -ms.assetid: 838a5e34-c92f-4f65-a597-e150bf8cf737 --- # Compiler Error C2676 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md index bc94ad8fee1..665726d4c01 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2677" title: "Compiler Error C2677" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2677" +ms.date: 11/04/2016 f1_keywords: ["C2677"] helpviewer_keywords: ["C2677"] -ms.assetid: 76bc0b65-f52a-45a6-b6d6-0555f89da9a8 --- # Compiler Error C2677 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md index b9675c6db08..6719229f6e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2678" title: "Compiler Error C2678" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2678" +ms.date: 11/04/2016 f1_keywords: ["C2678"] helpviewer_keywords: ["C2678"] -ms.assetid: 1f0a4e26-b429-44f5-9f94-cb66441220c8 --- # Compiler Error C2678 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md index 5dea528d0ba..88f7498add1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2679" title: "Compiler Error C2679" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2679" +ms.date: 11/04/2016 f1_keywords: ["C2679"] helpviewer_keywords: ["C2679"] -ms.assetid: 1a5f9d00-9190-4aa6-bc72-949f68ec136f --- # Compiler Error C2679 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md index cc925a38fb4..29a2effd882 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2680" title: "Compiler Error C2680" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2680" +ms.date: 11/04/2016 f1_keywords: ["C2680"] helpviewer_keywords: ["C2680"] -ms.assetid: d6f7129e-dd17-4661-b680-18d6b925b1cc --- # Compiler Error C2680 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md index 1be75b3147e..8920a1c75f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2681" title: "Compiler Error C2681" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2681" +ms.date: 11/04/2016 f1_keywords: ["C2681"] helpviewer_keywords: ["C2681"] -ms.assetid: eb42da6d-8d2c-43fd-986b-e73e2b004885 --- # Compiler Error C2681 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md index 00375c03ca4..6dbf392b6f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2682" title: "Compiler Error C2682" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2682" +ms.date: 11/04/2016 f1_keywords: ["C2682"] helpviewer_keywords: ["C2682"] -ms.assetid: 30c6a7c4-f5f7-4fe8-81a8-c48938521ab4 --- # Compiler Error C2682 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md index 46677faca17..a2b7b04276a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2683" title: "Compiler Error C2683" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2683" +ms.date: 11/04/2016 f1_keywords: ["C2683"] helpviewer_keywords: ["C2683"] -ms.assetid: db605e4f-601b-4d05-92a1-c43ca24de08d --- # Compiler Error C2683 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md index cc47a106cef..d61bb9d910f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2687" title: "Compiler Error C2687" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2687" +ms.date: 11/04/2016 f1_keywords: ["C2687"] helpviewer_keywords: ["C2687"] -ms.assetid: 1d24b24a-cd0f-41cc-975c-b08dcfb7f402 --- # Compiler Error C2687 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md index 56140fe8e06..438291e9818 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2688" title: "Compiler Error C2688" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2688" +ms.date: 11/04/2016 f1_keywords: ["C2688"] helpviewer_keywords: ["C2688"] -ms.assetid: 168c9e9d-8f65-4664-af86-db71d3e6ee46 --- # Compiler Error C2688 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md index f44a9aa8f02..0fb3674eb26 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2689" title: "Compiler Error C2689" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2689" +ms.date: 11/04/2016 f1_keywords: ["C2689"] helpviewer_keywords: ["C2689"] -ms.assetid: b5216fba-524d-4194-9168-26e9dc5210ce --- # Compiler Error C2689 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2690.md b/docs/error-messages/compiler-errors-2/compiler-error-c2690.md index 636019fb18f..9885b8a0b12 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2690.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2690.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2690" title: "Compiler Error C2690" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2690" +ms.date: 11/04/2016 f1_keywords: ["C2690"] helpviewer_keywords: ["C2690"] -ms.assetid: f165a806-14bd-4942-99b7-8a9fc7dea227 --- # Compiler Error C2690 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md index 3617dad801c..b2ff8c3044d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2691" title: "Compiler Error C2691" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2691" +ms.date: 11/04/2016 f1_keywords: ["C2691"] helpviewer_keywords: ["C2691"] -ms.assetid: 6925f8f3-ea60-4909-91e6-b781492c645d --- # Compiler Error C2691 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2692.md b/docs/error-messages/compiler-errors-2/compiler-error-c2692.md index 480cf0de7b4..a415df2551f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2692.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2692.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2692" title: "Compiler Error C2692" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2692" +ms.date: 11/04/2016 f1_keywords: ["C2692"] helpviewer_keywords: ["C2692"] -ms.assetid: 02ade3b4-b757-448b-b065-d7d71bc3f441 --- # Compiler Error C2692 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2693.md b/docs/error-messages/compiler-errors-2/compiler-error-c2693.md index 2cb222390ce..3cbf3814c91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2693.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2693.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2693" title: "Compiler Error C2693" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2693" +ms.date: 11/04/2016 f1_keywords: ["C2693"] helpviewer_keywords: ["C2693"] -ms.assetid: b7364ca8-b6be-48c0-97d6-6029787fb171 --- # Compiler Error C2693 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md index 1b2d626c7b0..3b33248c161 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2694" title: "Compiler Error C2694" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2694" +ms.date: 11/04/2016 f1_keywords: ["C2694"] helpviewer_keywords: ["C2694"] -ms.assetid: 8dc2cec2-67ae-4e16-8c0c-374425aca8bc --- # Compiler Error C2694 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md index d1d785f68d8..4e2b58d9815 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2695" title: "Compiler Error C2695" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2695" +ms.date: 11/04/2016 f1_keywords: ["C2695"] helpviewer_keywords: ["C2695"] -ms.assetid: 3f6f2091-c38b-40ea-ab6c-f1846f5702d7 --- # Compiler Error C2695 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2696.md b/docs/error-messages/compiler-errors-2/compiler-error-c2696.md index 921c2aa9bfc..27d130d222b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2696.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2696.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2696" title: "Compiler Error C2696" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2696" +ms.date: 11/04/2016 f1_keywords: ["C2696"] helpviewer_keywords: ["C2696"] -ms.assetid: 6c6eb7df-1230-4346-9a73-abf14c20785d --- # Compiler Error C2696 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md index 478d4e26f51..464373f1458 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2698" title: "Compiler Error C2698" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2698" +ms.date: 11/04/2016 f1_keywords: ["C2698"] helpviewer_keywords: ["C2698"] -ms.assetid: 3ebfe395-c20b-4c56-9980-ca9ed8653382 --- # Compiler Error C2698 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2700.md b/docs/error-messages/compiler-errors-2/compiler-error-c2700.md index b1a400565df..9032db07969 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2700.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2700.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2700" title: "Compiler Error C2700" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2700" +ms.date: 11/04/2016 f1_keywords: ["C2700"] helpviewer_keywords: ["C2700"] -ms.assetid: a231eb86-bdae-4b37-a606-06854f47929f --- # Compiler Error C2700 From e05af0fcc984a26fb89dabe0f7abebf7aa6ee455 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 4 Aug 2025 23:46:52 +0800 Subject: [PATCH 0624/1799] Fix wrong Visual Studio year in "Use the Microsoft C++ toolset from the command line" topic --- docs/build/building-on-the-command-line.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index 7b4a452f29b..00e62ede30d 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -89,7 +89,7 @@ If you prefer to set the build environment in an existing command prompt window, ::: moniker range=">= msvc-170" -The command file location depends on the version of Visual Studio you installed, and on choices you made during installation. For Visual Studio 2019, the typical installation location on a 64-bit system is in *`\Program Files\Microsoft Visual Studio\2022\`*. The *``* may be Community, Professional, Enterprise, BuildTools, or another nickname you supplied. +The command file location depends on the version of Visual Studio you installed, and on choices you made during installation. For Visual Studio 2022, the typical installation location on a 64-bit system is in *`\Program Files\Microsoft Visual Studio\2022\`*. The *``* may be Community, Professional, Enterprise, BuildTools, or another nickname you supplied. ::: moniker-end ::: moniker range="= msvc-160" From 166ac40867a0c730e546624fc9fe7dd410284167 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 4 Aug 2025 23:50:09 +0800 Subject: [PATCH 0625/1799] Replace `
` with escapes in "Use the Microsoft C++ toolset from the command line" topic --- docs/build/building-on-the-command-line.md | 32 +++++++++++----------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index 00e62ede30d..a83b6da3f9d 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -150,7 +150,7 @@ When used with no arguments, *`vcvarsall.bat`* configures the environment variab > **`vcvarsall.bat`** [*`architecture`*] [*`platform_type`*] [*`winsdk_version`*] [**`-vcvars_ver=`***`vcversion`*] [*`spectre_mode`*] -*`architecture`*
+*`architecture`*\ This optional argument specifies the host and target architecture to use. If *architecture* isn't specified, the default build environment is used. These arguments are supported: | *`architecture`* | Compiler | Host computer architecture | Build output (target) architecture | @@ -164,13 +164,13 @@ This optional argument specifies the host and target architecture to use. If *ar | `amd64_arm` or `x64_arm` | ARM on x64 cross | x64 | ARM | | `amd64_arm64` or `x64_arm64` | ARM64 on x64 cross | x64 | ARM64 | -*`platform_type`*
+*`platform_type`*\ This optional argument allows you to specify **`store`** or **`uwp`** as the platform type. By default, the environment is set to build desktop or console apps. -*`winsdk_version`*
+*`winsdk_version`*\ Optionally specifies the version of the Windows SDK to use. By default, the latest installed Windows SDK is used. To specify the Windows SDK version, you can use a full Windows SDK number such as **`10.0.10240.0`**, or specify **`8.1`** to use the Windows 8.1 SDK. -*`vcversion`*
+*`vcversion`*\ Optionally specifies the Visual Studio compiler toolset to use. By default, the environment is set to use the current Visual Studio compiler toolset. ::: moniker range=">= msvc-160" @@ -249,10 +249,10 @@ Adjust the path to reflect your Visual Studio installation directory. The vcvars To build a C/C++ project at a command prompt, Visual Studio provides these command-line tools: -[`CL`](reference/compiling-a-c-cpp-program.md)
+[`CL`](reference/compiling-a-c-cpp-program.md)\ Use the compiler (cl.exe) to compile and link source code files into apps, libraries, and DLLs. -[`Link`](reference/linking.md)
+[`Link`](reference/linking.md)\ Use the linker (link.exe) to link compiled object files and libraries into apps and DLLs. When you build on the command line, the F1 command isn't available for instant help. Instead, you can use a search engine to get information about warnings, errors, and messages. You can also download and use the offline help files. To use the search in Microsoft Learn, enter your query in the search box at the top of any article. @@ -280,36 +280,36 @@ Use NMAKE (nmake.exe) to build C++ projects by using a traditional makefile. These articles show how to build apps on the command line, and describe how to customize the command-line build environment. Some show how to use 64-bit toolsets, and target x86, x64, ARM, and ARM64 platforms. They also describe use of the command-line build tools MSBuild and NMAKE. -[Walkthrough: Compiling a native C++ program on the command line](walkthrough-compiling-a-native-cpp-program-on-the-command-line.md)
+[Walkthrough: Compiling a native C++ program on the command line](walkthrough-compiling-a-native-cpp-program-on-the-command-line.md)\ Gives an example that shows how to create and compile a C++ program on the command line. -[Walkthrough: Compile a C program on the command line](walkthrough-compile-a-c-program-on-the-command-line.md)
+[Walkthrough: Compile a C program on the command line](walkthrough-compile-a-c-program-on-the-command-line.md)\ Describes how to compile a program written in the C programming language. -[Walkthrough: Compiling a C++/CLI program on the command line](walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md)
+[Walkthrough: Compiling a C++/CLI program on the command line](walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md)\ Describes how to create and compile a C++/CLI program that uses the .NET Framework. -[Walkthrough: Compiling a C++/CX program on the command line](walkthrough-compiling-a-cpp-cx-program-on-the-command-line.md)
+[Walkthrough: Compiling a C++/CX program on the command line](walkthrough-compiling-a-cpp-cx-program-on-the-command-line.md)\ Describes how to create and compile a C++/CX program that uses the Windows Runtime. -[NMAKE reference](reference/nmake-reference.md)
+[NMAKE reference](reference/nmake-reference.md)\ Provides links to articles that describe the Microsoft Program Maintenance Utility (NMAKE.EXE). -[MSBuild on the command line - C++](msbuild-visual-cpp.md)
+[MSBuild on the command line - C++](msbuild-visual-cpp.md)\ Provides links to articles that discuss how to use msbuild.exe from the command line. ## Related sections -[/MD, /MT, /LD (Use run-time library)](reference/md-mt-ld-use-run-time-library.md)
+[/MD, /MT, /LD (Use run-time library)](reference/md-mt-ld-use-run-time-library.md)\ Describes how to use these compiler options to use a Debug or Release run-time library. -[C/C++ compiler options](reference/compiler-options.md)
+[C/C++ compiler options](reference/compiler-options.md)\ Provides links to articles that discuss the C and C++ compiler options and CL.exe. -[MSVC linker options](reference/linker-options.md)
+[MSVC linker options](reference/linker-options.md)\ Provides links to articles that discuss the linker options and LINK.exe. -[Additional MSVC build tools](reference/c-cpp-build-tools.md)
+[Additional MSVC build tools](reference/c-cpp-build-tools.md)\ Provides links to the C/C++ build tools that are included in Visual Studio. ## See also From fdcbbc6986c5b10ca67e0cccff9274bd41977ed8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 5 Aug 2025 00:08:23 +0800 Subject: [PATCH 0626/1799] Add backticks and italics in "Use the Microsoft C++ toolset from the command line" topic --- docs/build/building-on-the-command-line.md | 34 +++++++++++----------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index a83b6da3f9d..29b269c18c1 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -81,7 +81,7 @@ The Start menu folder and shortcut names vary depending on the installed version For an even faster way to open a developer command prompt, enter *developer command prompt* in the desktop search box. Then choose the result you want. > [!NOTE] -> By default, the current working directory in a developer command prompt is the root of your Visual Studio installation in the Program Files directory. This isn't an appropriate location for your code and projects. Change the current working directory to another location before you create a project. The IDE creates projects in your user directory, typically in *%USERPROFILE%\\source\\repos*. +> By default, the current working directory in a developer command prompt is the root of your Visual Studio installation in the Program Files directory. This isn't an appropriate location for your code and projects. Change the current working directory to another location before you create a project. The IDE creates projects in your user directory, typically in *`%USERPROFILE%\source\repos`*. ## Developer command file locations @@ -112,12 +112,12 @@ The primary developer command prompt command file, *`VsDevCmd.bat`*, is located ::: moniker range=">= msvc-150" -More command files are available to set up specific build architectures. The command files available depend on the Visual Studio workloads and options you've installed. In Visual Studio 2017 and Visual Studio 2019, you'll find them in the VC\\Auxiliary\\Build subdirectory. +More command files are available to set up specific build architectures. The command files available depend on the Visual Studio workloads and options you've installed. In Visual Studio 2017 and Visual Studio 2019, you'll find them in the *`VC\Auxiliary\Build`* subdirectory. ::: moniker-end ::: moniker range="< msvc-150" -More command files are available to set up specific build architectures. The command files available depend on the Visual Studio workloads and options you've installed. In Visual Studio 2015, they're located in the VC, VC\\bin, or VC\\bin\\*architecture* subdirectories, where *architecture* is one of the native or cross-compiler options. +More command files are available to set up specific build architectures. The command files available depend on the Visual Studio workloads and options you've installed. In Visual Studio 2015, they're located in the *`VC`*, *`VC\bin`*, or *`VC\bin\`* subdirectories, where *``* is one of the native or cross-compiler options. ::: moniker-end @@ -151,7 +151,7 @@ When used with no arguments, *`vcvarsall.bat`* configures the environment variab > **`vcvarsall.bat`** [*`architecture`*] [*`platform_type`*] [*`winsdk_version`*] [**`-vcvars_ver=`***`vcversion`*] [*`spectre_mode`*] *`architecture`*\ -This optional argument specifies the host and target architecture to use. If *architecture* isn't specified, the default build environment is used. These arguments are supported: +This optional argument specifies the host and target architecture to use. If *`architecture`* isn't specified, the default build environment is used. These arguments are supported: | *`architecture`* | Compiler | Host computer architecture | Build output (target) architecture | |--|--|--|--| @@ -195,7 +195,7 @@ Leave this parameter out to use libraries without Spectre mitigations. Use the v #### To set up the build environment in an existing command prompt window -1. At the command prompt, use the CD command to change to the Visual Studio installation directory. Then, use CD again to change to the subdirectory that contains the configuration-specific command files. For Visual Studio 2019 and Visual Studio 2017, use the *VC\\Auxiliary\\Build* subdirectory. For Visual Studio 2015, use the *VC* subdirectory. +1. At the command prompt, use the `CD` command to change to the Visual Studio installation directory. Then, use `CD` again to change to the subdirectory that contains the configuration-specific command files. For Visual Studio 2019 and Visual Studio 2017, use the *`VC\Auxiliary\Build`* subdirectory. For Visual Studio 2015, use the *`VC`* subdirectory. 1. Enter the command for your preferred developer environment. For example, to build ARM code for UWP on a 64-bit platform, using the latest Windows SDK and Visual Studio compiler toolset, use this command line: @@ -243,17 +243,17 @@ The architecture-specific batch files set the *`architecture`* parameter and cal ::: moniker-end -Adjust the path to reflect your Visual Studio installation directory. The vcvarsall.bat file has additional information about specific version numbers. +Adjust the path to reflect your Visual Studio installation directory. The *`vcvarsall.bat`* file has additional information about specific version numbers. ## Command-line tools To build a C/C++ project at a command prompt, Visual Studio provides these command-line tools: [`CL`](reference/compiling-a-c-cpp-program.md)\ -Use the compiler (cl.exe) to compile and link source code files into apps, libraries, and DLLs. +Use the compiler (`cl.exe`) to compile and link source code files into apps, libraries, and DLLs. [`Link`](reference/linking.md)\ -Use the linker (link.exe) to link compiled object files and libraries into apps and DLLs. +Use the linker (`link.exe`) to link compiled object files and libraries into apps and DLLs. When you build on the command line, the F1 command isn't available for instant help. Instead, you can use a search engine to get information about warnings, errors, and messages. You can also download and use the offline help files. To use the search in Microsoft Learn, enter your query in the search box at the top of any article. @@ -262,16 +262,16 @@ When you build on the command line, the F1 command isn't available for instant h By default, the Visual Studio IDE uses native project build systems based on MSBuild. You can invoke MSBuild directly to build projects without using the IDE. You can also use the `devenv` command to use Visual Studio to build projects and solutions. Visual Studio also supports build systems based on CMake or NMake. [`MSBuild`](msbuild-visual-cpp.md)\ -Use MSBuild (msbuild.exe) and a project file (.vcxproj) to configure a build and invoke the toolset without loading the Visual Studio IDE. It's equivalent to running the **Build** project or **Build Solution** command in the Visual Studio IDE. MSBuild has advantages over the IDE when you build at the command line. You don't have to install the full IDE on all your build servers and build pipelines. You avoid the extra overhead of the IDE. MSBuild runs in containerized build environments, and supports a [binary logger](https://msbuildlog.com/). +Use MSBuild (`msbuild.exe`) and a project file (`.vcxproj`) to configure a build and invoke the toolset without loading the Visual Studio IDE. It's equivalent to running the **Build** project or **Build Solution** command in the Visual Studio IDE. MSBuild has advantages over the IDE when you build at the command line. You don't have to install the full IDE on all your build servers and build pipelines. You avoid the extra overhead of the IDE. MSBuild runs in containerized build environments, and supports a [binary logger](https://msbuildlog.com/). [`DEVENV`](/visualstudio/ide/reference/devenv-command-line-switches)\ -Use DEVENV (devenv.exe) combined with a command-line switch such as **`/Build`** or **`/Clean`** to execute certain build commands without displaying the Visual Studio IDE. +Use DEVENV (`devenv.exe`) combined with a command-line switch such as **`/Build`** or **`/Clean`** to execute certain build commands without displaying the Visual Studio IDE. [`CMake`](../build/cmake-projects-in-visual-studio.md)\ -CMake (cmake.exe) is a cross-platform, open-source tool for defining build processes that run on multiple platforms. CMake can configure and control native build tools for its supported platforms, such as MSBuild and Make. For more information about CMake, see the [CMake documentation](https://cmake.org/cmake/help/latest/index.html#). +CMake (`cmake.exe`) is a cross-platform, open-source tool for defining build processes that run on multiple platforms. CMake can configure and control native build tools for its supported platforms, such as MSBuild and Make. For more information about CMake, see the [CMake documentation](https://cmake.org/cmake/help/latest/index.html#). [`NMAKE`](reference/nmake-reference.md)\ -Use NMAKE (nmake.exe) to build C++ projects by using a traditional makefile. +Use NMAKE (`nmake.exe`) to build C++ projects by using a traditional makefile. > [!NOTE] > Starting in Visual Studio 2019 version 16.5, MSBuild and DEVENV don't use the command-line environment to control the toolset and libraries used. @@ -293,21 +293,21 @@ Describes how to create and compile a C++/CLI program that uses the .NET Framewo Describes how to create and compile a C++/CX program that uses the Windows Runtime. [NMAKE reference](reference/nmake-reference.md)\ -Provides links to articles that describe the Microsoft Program Maintenance Utility (NMAKE.EXE). +Provides links to articles that describe the Microsoft Program Maintenance Utility (`NMAKE.EXE`). [MSBuild on the command line - C++](msbuild-visual-cpp.md)\ -Provides links to articles that discuss how to use msbuild.exe from the command line. +Provides links to articles that discuss how to use `msbuild.exe` from the command line. ## Related sections -[/MD, /MT, /LD (Use run-time library)](reference/md-mt-ld-use-run-time-library.md)\ +[`/MD`, `/MT`, `/LD` (Use run-time library)](reference/md-mt-ld-use-run-time-library.md)\ Describes how to use these compiler options to use a Debug or Release run-time library. [C/C++ compiler options](reference/compiler-options.md)\ -Provides links to articles that discuss the C and C++ compiler options and CL.exe. +Provides links to articles that discuss the C and C++ compiler options and `CL.exe`. [MSVC linker options](reference/linker-options.md)\ -Provides links to articles that discuss the linker options and LINK.exe. +Provides links to articles that discuss the linker options and `LINK.exe`. [Additional MSVC build tools](reference/c-cpp-build-tools.md)\ Provides links to the C/C++ build tools that are included in Visual Studio. From ef4506c41322c79a5ed6da4a660b00968d4515bc Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 5 Aug 2025 00:18:27 +0800 Subject: [PATCH 0627/1799] Convert single line inline code to code block in "Use the Microsoft C++ toolset from the command line" topic --- docs/build/building-on-the-command-line.md | 28 ++++++++++++++++------ 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index 29b269c18c1..fc578fa217c 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -199,7 +199,9 @@ Leave this parameter out to use libraries without Spectre mitigations. Use the v 1. Enter the command for your preferred developer environment. For example, to build ARM code for UWP on a 64-bit platform, using the latest Windows SDK and Visual Studio compiler toolset, use this command line: - `vcvarsall.bat amd64_arm uwp` + ```cmd + vcvarsall.bat amd64_arm uwp + ``` ## Create your own command prompt shortcut @@ -207,21 +209,27 @@ Leave this parameter out to use libraries without Spectre mitigations. Use the v Open the Properties dialog for a developer command prompt shortcut to see the command target used. For example, the target for the **x64 Native Tools Command Prompt for VS 2019** shortcut is something similar to: -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"` +``` +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat" +``` ::: moniker-end ::: moniker range="= msvc-150" Open the Properties dialog for a developer command prompt shortcut to see the command target used. For example, the target for the **x64 Native Tools Command Prompt for VS 2017** shortcut is something similar to: -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars64.bat"` +``` +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars64.bat" +``` ::: moniker-end ::: moniker range="< msvc-150" Open the Properties dialog for a developer command prompt shortcut to see the command target used. For example, the target for the **VS2015 x64 Native Tools Command Prompt** shortcut is something similar to: -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64` +``` +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 +``` ::: moniker-end @@ -229,17 +237,23 @@ The architecture-specific batch files set the *`architecture`* parameter and cal ::: moniker range=">= msvc-160" -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29` +``` +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29 +``` ::: moniker-end ::: moniker range="= msvc-150" -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.19` +``` +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.19 +``` ::: moniker-end ::: moniker range="< msvc-150" -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0` +``` +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0 +``` ::: moniker-end From e9d1cc091afea8e64230244f4be67fa791ec61e6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 5 Aug 2025 00:19:12 +0800 Subject: [PATCH 0628/1799] Update metadata in "Use the Microsoft C++ toolset from the command line" topic --- docs/build/building-on-the-command-line.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index fc578fa217c..ffc6dff0b5a 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -1,11 +1,10 @@ --- title: "Use the Microsoft C++ toolset from the command line" description: "Use the Microsoft C++ (MSVC) compiler toolset from the command line outside of the Visual Studio IDE." -ms.custom: "conceptual" ms.date: 04/07/2022 -helpviewer_keywords: ["command-line builds [C++]", "compiling source code [C++], command line", "builds [C++], command-line", "command line [C++], building from", "command line [C++], compilers"] -ms.assetid: 7ca9daed-a003-4162-842d-908f79058365 +ms.custom: "conceptual" ms.topic: how-to +helpviewer_keywords: ["command-line builds [C++]", "compiling source code [C++], command line", "builds [C++], command-line", "command line [C++], building from", "command line [C++], compilers"] --- # Use the Microsoft C++ toolset from the command line From 8e1983e9de9c2a819d18442a48b53a60d04815a4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 5 Aug 2025 22:50:27 +0800 Subject: [PATCH 0629/1799] Add blockquotes for error messages in range [C2701, C2730] --- docs/error-messages/compiler-errors-2/compiler-error-c2704.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2707.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2708.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2709.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2710.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2711.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2715.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2718.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2719.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2721.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2722.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2723.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2724.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2725.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2726.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2728.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2730.md | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2704.md b/docs/error-messages/compiler-errors-2/compiler-error-c2704.md index 476dd462288..7205c45ac0a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2704.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2704.md @@ -8,6 +8,6 @@ ms.assetid: 185797e2-55b5-4c11-8493-e70eb1d15a94 --- # Compiler Error C2704 -'identifier' : __va_start intrinsic only allowed in varargs +> 'identifier' : __va_start intrinsic only allowed in varargs The `__va_start` intrinsic is used in a declaration for a function with a fixed number of arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md index ff081cdf341..3ed6aa213bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md @@ -8,7 +8,7 @@ ms.assetid: 3deaf45c-74da-4c9d-acc6-b82412720b74 --- # Compiler Error C2707 -'identifier' : bad context for intrinsic function +> 'identifier' : bad context for intrinsic function Structured exception-handling intrinsics are invalid in certain contexts: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2708.md b/docs/error-messages/compiler-errors-2/compiler-error-c2708.md index 72031e762ad..5a2c8b82c6f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2708.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2708.md @@ -8,7 +8,7 @@ ms.assetid: d52d3088-1141-42f4-829c-74755a7fcc3a --- # Compiler Error C2708 -'identifier' : actual parameters length in bytes differs from previous call or reference +> 'identifier' : actual parameters length in bytes differs from previous call or reference A [__stdcall](../../cpp/stdcall.md) function must be preceded by a prototype. Otherwise, the compiler interprets the first call to the function as a prototype and this error occurs when the compiler encounters a call that does not match. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2709.md b/docs/error-messages/compiler-errors-2/compiler-error-c2709.md index 8412aaff029..d06b72efe22 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2709.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2709.md @@ -8,6 +8,6 @@ ms.assetid: e66fc7e6-0e91-4b99-a6e0-fdb069b09fbc --- # Compiler Error C2709 -'identifier' : formal parameter's length in bytes differs from previous declaration +> 'identifier' : formal parameter's length in bytes differs from previous declaration The signature in a call to the specified function differs from the prototype. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md index 5b2ddea8617..c40d0161df9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md @@ -8,7 +8,7 @@ ms.assetid: a2a6bb5b-86ad-4a6c-acd0-e2bef8464e0e --- # Compiler Error C2710 -'construct' : '__declspec(modifier)' can only be applied to a function returning a pointer +> 'construct' : '__declspec(modifier)' can only be applied to a function returning a pointer A function whose return value is a pointer is the only construct to which `modifier` can be applied. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md index 137e67e9338..d3e889d0ef7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md @@ -8,7 +8,7 @@ ms.assetid: 9df9f808-7419-4e63-abdd-e6538ff0871f --- # Compiler Error C2711 -'function' : this function cannot be compiled as managed, consider using #pragma unmanaged +> 'function' : this function cannot be compiled as managed, consider using #pragma unmanaged Some instructions will prevent the compiler from generating MSIL for the enclosing function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md index 1321f85ca92..c4f985c864a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md @@ -8,7 +8,7 @@ ms.assetid: c81567a7-5b65-468f-aaf9-835f91e468e4 --- # Compiler Error C2715 -'type' : cannot throw or catch this type +> 'type' : cannot throw or catch this type Value types are not valid arguments when using exception handling in managed code (see [Exception Handling](../../extensions/exception-handling-cpp-component-extensions.md) for more information). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md index 6b67c1f9331..f483336182e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md @@ -8,7 +8,7 @@ ms.assetid: 78cc71f8-c142-46fc-9aed-970635d74f0c --- # Compiler Error C2718 -'parameter': actual parameter with __declspec(align('#')) won't be aligned +> 'parameter': actual parameter with __declspec(align('#')) won't be aligned The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted on function parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md index 3b367a25ba2..6954b6bd4ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md @@ -8,7 +8,7 @@ ms.assetid: ea6236d3-8286-45cc-9478-c84ad3dd3c8e --- # Compiler Error C2719 -'parameter': formal parameter with __declspec(align('#')) won't be aligned +> 'parameter': formal parameter with __declspec(align('#')) won't be aligned The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted on function parameters. Function parameter alignment is controlled by the calling convention used. For more information, see [Calling Conventions](../../cpp/calling-conventions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2721.md b/docs/error-messages/compiler-errors-2/compiler-error-c2721.md index 0bafc693b29..55ddccc19ba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2721.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2721.md @@ -8,6 +8,6 @@ ms.assetid: 7a97823c-3ce1-4112-8253-fc1448685235 --- # Compiler Error C2721 -'specifier' : storage-class specifier illegal between operator keyword and type +> 'specifier' : storage-class specifier illegal between operator keyword and type User-defined type conversions apply to all storage classes, so you cannot specify a storage class in a type conversion. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2722.md b/docs/error-messages/compiler-errors-2/compiler-error-c2722.md index 0240cca6d41..817b3296f47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2722.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2722.md @@ -8,6 +8,6 @@ ms.assetid: 4cc2c7fa-cb12-4bcf-9df1-6d627ef62973 --- # Compiler Error C2722 -'::operator' : illegal following operator command; use 'operator operator' +> '::operator' : illegal following operator command; use 'operator operator' An `operator` statement redefines `::new` or `::delete`. The `new` and `delete` operators are global, so the scope resolution operator (`::`) is meaningless. Remove the `::` operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md index 48dad9d850c..348cfbc15c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md @@ -8,7 +8,7 @@ ms.assetid: 86925601-2297-4cfd-94e2-2caf27c474c4 --- # Compiler Error C2723 -'function' : 'specifier' specifier illegal on function definition +> 'function' : 'specifier' specifier illegal on function definition The specifier cannot appear with a function definition outside of a class declaration. The **`virtual`** specifier can be specified only on a member function declaration within a class declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md index 8860220e666..7fe9c7fc723 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2724"] --- # Compiler Error C2724 -'identifier' : 'static' should not be used on member functions defined at file scope +> 'identifier' : 'static' should not be used on member functions defined at file scope Static member functions should be declared with external linkage. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md index b362cad13e2..695283a829f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md @@ -8,7 +8,7 @@ ms.assetid: 13cd5b1b-e906-4cd8-9b2b-510d587c665a --- # Compiler Error C2725 -'exception' : unable to throw or catch a managed or WinRT object by value or reference +> 'exception' : unable to throw or catch a managed or WinRT object by value or reference The type of a managed or WinRT exception was not correct. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md index 1cf7c3f939c..634d19c64d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md @@ -8,7 +8,7 @@ ms.assetid: f0191bb7-c175-450b-bf09-a3213db96d09 --- # Compiler Error C2726 -'gcnew' may only be used to create an object with managed or WinRT type +> 'gcnew' may only be used to create an object with managed or WinRT type You cannot create an instance of a native type on the garbage-collected heap. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md index 79660264d06..ea61c2b9943 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md @@ -8,7 +8,7 @@ ms.assetid: 65635f91-1cd1-46e4-9ad7-14726d0546af --- # Compiler Error C2728 -'type' : a native array cannot contain this type +> 'type' : a native array cannot contain this type Array creation syntax was used to create an array of managed or WinRT objects. You cannot create an array of managed or WinRT objects using native array syntax. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2730.md b/docs/error-messages/compiler-errors-2/compiler-error-c2730.md index b7a014e42cd..38563bc9ea3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2730.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2730.md @@ -8,6 +8,6 @@ ms.assetid: 07f0b17a-bc8e-4d79-af5a-07a07af3687b --- # Compiler Error C2730 -'class' : cannot be a base class of itself +> 'class' : cannot be a base class of itself Recursive base classes are invalid. Specify another class as the base class. From b0a2b5c3fa5a1717871d9e6d193f52cae20b99d0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 5 Aug 2025 22:56:33 +0800 Subject: [PATCH 0630/1799] Add "Remarks" and "Example" headings for error references in range [C2701, C2730] --- docs/error-messages/compiler-errors-2/compiler-error-c2701.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2702.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2704.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2706.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2707.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2708.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2709.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2710.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2711.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2713.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2714.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2715.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2718.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2719.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2720.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2721.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2722.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2723.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2724.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2725.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2726.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2728.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2730.md | 2 ++ 23 files changed, 70 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2701.md b/docs/error-messages/compiler-errors-2/compiler-error-c2701.md index 7db2a0789fb..b887f887dd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2701.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2701.md @@ -10,8 +10,12 @@ ms.assetid: 31cf2ab7-ced9-4f75-aa51-e169e20407fb > 'function': a function template cannot be a `friend` of a local class +## Remarks + A local class can't have a function template as a `friend` function. +## Example + The following sample generates C2701: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2702.md b/docs/error-messages/compiler-errors-2/compiler-error-c2702.md index 8ab3ce78de1..d391cb4cecf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2702.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2702.md @@ -10,8 +10,12 @@ ms.assetid: 6def15d4-9a8d-43e7-ae35-42d7cb57c27e > `__except` may not appear in termination block +## Remarks + An exception handler (**`__try`**/**`__except`**) cannot be nested inside a **`__finally`** block. +## Example + The following sample generates C2702: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2704.md b/docs/error-messages/compiler-errors-2/compiler-error-c2704.md index 7205c45ac0a..eaac6df6c72 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2704.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2704.md @@ -10,4 +10,6 @@ ms.assetid: 185797e2-55b5-4c11-8493-e70eb1d15a94 > 'identifier' : __va_start intrinsic only allowed in varargs +## Remarks + The `__va_start` intrinsic is used in a declaration for a function with a fixed number of arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2706.md b/docs/error-messages/compiler-errors-2/compiler-error-c2706.md index c21375885ed..c602b969a42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2706.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2706.md @@ -10,8 +10,12 @@ ms.assetid: e18da924-c42d-4b09-8e29-f4e0382d7dc6 > illegal `__except` without matching `__try` (missing '}' in `__try` block?) +## Remarks + The compiler did not find a closing brace for a **`__try`** block. +## Example + The following sample generates C2706: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md index 3ed6aa213bb..ac228a5eff9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md @@ -10,6 +10,8 @@ ms.assetid: 3deaf45c-74da-4c9d-acc6-b82412720b74 > 'identifier' : bad context for intrinsic function +## Remarks + Structured exception-handling intrinsics are invalid in certain contexts: - `_exception_code()` outside an exception filter or **`__except`** block diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2708.md b/docs/error-messages/compiler-errors-2/compiler-error-c2708.md index 5a2c8b82c6f..9b6bc30afe3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2708.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2708.md @@ -10,6 +10,8 @@ ms.assetid: d52d3088-1141-42f4-829c-74755a7fcc3a > 'identifier' : actual parameters length in bytes differs from previous call or reference +## Remarks + A [__stdcall](../../cpp/stdcall.md) function must be preceded by a prototype. Otherwise, the compiler interprets the first call to the function as a prototype and this error occurs when the compiler encounters a call that does not match. To fix this error add a function prototype. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2709.md b/docs/error-messages/compiler-errors-2/compiler-error-c2709.md index d06b72efe22..d87b78d38a7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2709.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2709.md @@ -10,4 +10,6 @@ ms.assetid: e66fc7e6-0e91-4b99-a6e0-fdb069b09fbc > 'identifier' : formal parameter's length in bytes differs from previous declaration +## Remarks + The signature in a call to the specified function differs from the prototype. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md index c40d0161df9..fc132c7070a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md @@ -10,8 +10,12 @@ ms.assetid: a2a6bb5b-86ad-4a6c-acd0-e2bef8464e0e > 'construct' : '__declspec(modifier)' can only be applied to a function returning a pointer +## Remarks + A function whose return value is a pointer is the only construct to which `modifier` can be applied. +## Example + The following sample generates C2710: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md index d3e889d0ef7..588566439af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md @@ -10,8 +10,12 @@ ms.assetid: 9df9f808-7419-4e63-abdd-e6538ff0871f > 'function' : this function cannot be compiled as managed, consider using #pragma unmanaged +## Remarks + Some instructions will prevent the compiler from generating MSIL for the enclosing function. +## Example + The following sample generates C2711: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2713.md b/docs/error-messages/compiler-errors-2/compiler-error-c2713.md index 59ee0bf0a9e..dfd1e055817 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2713.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2713.md @@ -10,4 +10,6 @@ ms.assetid: bae9bee3-b4b8-4be5-b6a5-02df587a7278 > only one form of exception handling permitted per function +## Remarks + You can't use structured exception handling (**`__try`**/**`__except`**) and C++ exception handling (**`try`**/**`catch`**) in the same function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2714.md b/docs/error-messages/compiler-errors-2/compiler-error-c2714.md index 95d86859dc7..1b2fb857e72 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2714.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2714.md @@ -10,10 +10,10 @@ ms.assetid: 401a5a42-660c-4bad-9d63-1a2d092bc489 > `alignof(void)` is not allowed -An invalid value was passed to an operator. - ## Remarks +An invalid value was passed to an operator. + See [`alignof` operator](../../cpp/alignof-operator.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md index c4f985c864a..29d1a4e99d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md @@ -10,8 +10,12 @@ ms.assetid: c81567a7-5b65-468f-aaf9-835f91e468e4 > 'type' : cannot throw or catch this type +## Remarks + Value types are not valid arguments when using exception handling in managed code (see [Exception Handling](../../extensions/exception-handling-cpp-component-extensions.md) for more information). +## Example + ```cpp // C2715a.cpp // compile with: /clr diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md index f483336182e..2563220a7f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md @@ -10,8 +10,12 @@ ms.assetid: 78cc71f8-c142-46fc-9aed-970635d74f0c > 'parameter': actual parameter with __declspec(align('#')) won't be aligned +## Remarks + The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted on function parameters. +## Example + The following sample generates C2718: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md index 6954b6bd4ef..f550d5e45e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md @@ -10,8 +10,12 @@ ms.assetid: ea6236d3-8286-45cc-9478-c84ad3dd3c8e > 'parameter': formal parameter with __declspec(align('#')) won't be aligned +## Remarks + The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted on function parameters. Function parameter alignment is controlled by the calling convention used. For more information, see [Calling Conventions](../../cpp/calling-conventions.md). +## Example + The following sample generates C2719 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2720.md b/docs/error-messages/compiler-errors-2/compiler-error-c2720.md index 40b1afaa4e3..fb564ba7d5f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2720.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2720.md @@ -10,6 +10,8 @@ ms.assetid: 9ee3aab7-711b-4f5a-b2f1-cb62b130f1ce > '*identifier*' : '*specifier*' storage-class specifier illegal on members +## Remarks + The storage class cannot be used on class members outside the declaration. To fix this error, remove the unneeded [storage class](../../cpp/storage-classes-cpp.md) specifier from the definition of the member outside the class declaration. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2721.md b/docs/error-messages/compiler-errors-2/compiler-error-c2721.md index 55ddccc19ba..385dfe0d345 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2721.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2721.md @@ -10,4 +10,6 @@ ms.assetid: 7a97823c-3ce1-4112-8253-fc1448685235 > 'specifier' : storage-class specifier illegal between operator keyword and type +## Remarks + User-defined type conversions apply to all storage classes, so you cannot specify a storage class in a type conversion. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2722.md b/docs/error-messages/compiler-errors-2/compiler-error-c2722.md index 817b3296f47..59a01019021 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2722.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2722.md @@ -10,4 +10,6 @@ ms.assetid: 4cc2c7fa-cb12-4bcf-9df1-6d627ef62973 > '::operator' : illegal following operator command; use 'operator operator' +## Remarks + An `operator` statement redefines `::new` or `::delete`. The `new` and `delete` operators are global, so the scope resolution operator (`::`) is meaningless. Remove the `::` operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md index 348cfbc15c5..930165606e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md @@ -10,8 +10,12 @@ ms.assetid: 86925601-2297-4cfd-94e2-2caf27c474c4 > 'function' : 'specifier' specifier illegal on function definition +## Remarks + The specifier cannot appear with a function definition outside of a class declaration. The **`virtual`** specifier can be specified only on a member function declaration within a class declaration. +## Example + The following sample generates C2723 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md index 7fe9c7fc723..562f7791ed5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2724"] > 'identifier' : 'static' should not be used on member functions defined at file scope +## Remarks + Static member functions should be declared with external linkage. +## Example + The following sample generates C2724: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md index 695283a829f..7e52f9f01ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md @@ -10,6 +10,8 @@ ms.assetid: 13cd5b1b-e906-4cd8-9b2b-510d587c665a > 'exception' : unable to throw or catch a managed or WinRT object by value or reference +## Remarks + The type of a managed or WinRT exception was not correct. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md index 634d19c64d7..f359bc09263 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md @@ -10,8 +10,12 @@ ms.assetid: f0191bb7-c175-450b-bf09-a3213db96d09 > 'gcnew' may only be used to create an object with managed or WinRT type +## Remarks + You cannot create an instance of a native type on the garbage-collected heap. +## Example + The following sample generates C2726 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md index ea61c2b9943..08eed488b81 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md @@ -10,10 +10,14 @@ ms.assetid: 65635f91-1cd1-46e4-9ad7-14726d0546af > 'type' : a native array cannot contain this type +## Remarks + Array creation syntax was used to create an array of managed or WinRT objects. You cannot create an array of managed or WinRT objects using native array syntax. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). +## Example + The following sample generates C2728 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2730.md b/docs/error-messages/compiler-errors-2/compiler-error-c2730.md index 38563bc9ea3..e33bac443cb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2730.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2730.md @@ -10,4 +10,6 @@ ms.assetid: 07f0b17a-bc8e-4d79-af5a-07a07af3687b > 'class' : cannot be a base class of itself +## Remarks + Recursive base classes are invalid. Specify another class as the base class. From f597f8c9dfd06f7043b1a97d2204f1846f14eef3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 5 Aug 2025 22:58:00 +0800 Subject: [PATCH 0631/1799] Replace term "sample" with "example" for error references in range [C2701, C2730] --- docs/error-messages/compiler-errors-2/compiler-error-c2701.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2702.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2703.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2705.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2706.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2707.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2710.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2711.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2712.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2714.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2718.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2719.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2720.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2723.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2724.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2725.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2726.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2728.md | 2 +- 18 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2701.md b/docs/error-messages/compiler-errors-2/compiler-error-c2701.md index b887f887dd4..6672028e0ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2701.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2701.md @@ -16,7 +16,7 @@ A local class can't have a function template as a `friend` function. ## Example -The following sample generates C2701: +The following example generates C2701: ```cpp // C2701.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2702.md b/docs/error-messages/compiler-errors-2/compiler-error-c2702.md index d391cb4cecf..d2b3d54a2d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2702.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2702.md @@ -16,7 +16,7 @@ An exception handler (**`__try`**/**`__except`**) cannot be nested inside a **`_ ## Example -The following sample generates C2702: +The following example generates C2702: ```cpp // C2702.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2703.md b/docs/error-messages/compiler-errors-2/compiler-error-c2703.md index 113bf49c705..623d6ac1c2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2703.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2703.md @@ -16,7 +16,7 @@ A **`__leave`** statement must be inside a **`__try`** block. ## Example -The following sample generates C2703: +The following example generates C2703: ```cpp // C2703.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2705.md b/docs/error-messages/compiler-errors-2/compiler-error-c2705.md index 39fdf0029a3..e9ec12edaac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2705.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2705.md @@ -16,7 +16,7 @@ Execution jumps to a label within a **`try`**/**`catch`**, **`__try`**/**`__exce ## Example -The following sample generates C2705: +The following example generates C2705: ```cpp // C2705.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2706.md b/docs/error-messages/compiler-errors-2/compiler-error-c2706.md index c602b969a42..7209a543250 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2706.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2706.md @@ -16,7 +16,7 @@ The compiler did not find a closing brace for a **`__try`** block. ## Example -The following sample generates C2706: +The following example generates C2706: ```cpp // C2706.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md index ac228a5eff9..76a5a20823f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md @@ -24,7 +24,7 @@ To resolve the error, be sure that the exception-handling intrinsics are placed ## Example -The following sample generates C2707. +The following example generates C2707. ```cpp // C2707.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md index fc132c7070a..6d8e73d9424 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md @@ -16,7 +16,7 @@ A function whose return value is a pointer is the only construct to which `modif ## Example -The following sample generates C2710: +The following example generates C2710: ```cpp // C2710.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md index 588566439af..c27eaf12bec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md @@ -16,7 +16,7 @@ Some instructions will prevent the compiler from generating MSIL for the enclosi ## Example -The following sample generates C2711: +The following example generates C2711: ```cpp // C2711.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2712.md b/docs/error-messages/compiler-errors-2/compiler-error-c2712.md index 8b1b715cb00..926c02efbc0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2712.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2712.md @@ -30,7 +30,7 @@ The **`/clr:pure`** and **`/clr:safe`** compiler options are deprecated in Visua ## Example -The following sample generates C2712 and shows how to fix it. +The following example generates C2712 and shows how to fix it. ```cpp // C2712.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2714.md b/docs/error-messages/compiler-errors-2/compiler-error-c2714.md index 1b2fb857e72..7511bd218ab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2714.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2714.md @@ -18,7 +18,7 @@ See [`alignof` operator](../../cpp/alignof-operator.md) for more information. ## Example -The following sample generates C2714. +The following example generates C2714. ```cpp // C2714.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md index 2563220a7f9..7f2c2f1387b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md @@ -16,7 +16,7 @@ The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted o ## Example -The following sample generates C2718: +The following example generates C2718: ```cpp // C2718.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md index f550d5e45e9..2e1062c3993 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md @@ -16,7 +16,7 @@ The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted o ## Example -The following sample generates C2719 and shows how to fix it: +The following example generates C2719 and shows how to fix it: ```cpp // C2719.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2720.md b/docs/error-messages/compiler-errors-2/compiler-error-c2720.md index fb564ba7d5f..6e0cbaab448 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2720.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2720.md @@ -16,7 +16,7 @@ The storage class cannot be used on class members outside the declaration. To fi ## Example -The following sample generates C2720 and shows how to fix it: +The following example generates C2720 and shows how to fix it: ```cpp // C2720.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md index 930165606e7..6d2a1a70dd8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md @@ -16,7 +16,7 @@ The specifier cannot appear with a function definition outside of a class declar ## Example -The following sample generates C2723 and shows how to fix it: +The following example generates C2723 and shows how to fix it: ```cpp // C2723.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md index 562f7791ed5..21e3b41693d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md @@ -15,7 +15,7 @@ Static member functions should be declared with external linkage. ## Example -The following sample generates C2724: +The following example generates C2724: ```cpp // C2724.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md index 7e52f9f01ac..e500613b2c6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md @@ -16,7 +16,7 @@ The type of a managed or WinRT exception was not correct. ## Examples -The following sample generates C2725 and shows how to fix it. +The following example generates C2725 and shows how to fix it. ```cpp // C2725.cpp @@ -35,7 +35,7 @@ int main() { } ``` -The following sample generates C2725 and shows how to fix it. +The following example generates C2725 and shows how to fix it. ```cpp // C2725b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md index f359bc09263..42a2a207ced 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md @@ -16,7 +16,7 @@ You cannot create an instance of a native type on the garbage-collected heap. ## Example -The following sample generates C2726 and shows how to fix it: +The following example generates C2726 and shows how to fix it: ```cpp // C2726.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md index 08eed488b81..6aa45f9c904 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md @@ -18,7 +18,7 @@ For more information, see [array](../../extensions/arrays-cpp-component-extensio ## Example -The following sample generates C2728 and shows how to fix it: +The following example generates C2728 and shows how to fix it: ```cpp // C2728.cpp From 19a1730bfb314e1378760d67d789c19d2b6be67f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 5 Aug 2025 23:02:17 +0800 Subject: [PATCH 0632/1799] Update metadata for error references in range [C2701, C2730] --- .../error-messages/compiler-errors-2/compiler-error-c2701.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2702.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c2703.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c2704.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2705.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c2706.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c2707.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2708.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2709.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2710.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2711.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2712.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c2713.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c2714.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2715.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2718.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2719.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2720.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2721.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2722.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2723.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2725.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2726.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2728.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2730.md | 5 ++--- 25 files changed, 36 insertions(+), 61 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2701.md b/docs/error-messages/compiler-errors-2/compiler-error-c2701.md index 6672028e0ce..6d038a0270c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2701.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2701.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2701" title: "Compiler Error C2701" +description: "Learn more about: Compiler Error C2701" ms.date: 09/27/2022 f1_keywords: ["C2701"] helpviewer_keywords: ["C2701"] -ms.assetid: 31cf2ab7-ced9-4f75-aa51-e169e20407fb --- # Compiler Error C2701 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2702.md b/docs/error-messages/compiler-errors-2/compiler-error-c2702.md index d2b3d54a2d7..d552a512152 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2702.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2702.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2702." ms.date: 08/25/2020 f1_keywords: ["C2702"] helpviewer_keywords: ["C2702"] -ms.assetid: 6def15d4-9a8d-43e7-ae35-42d7cb57c27e --- # Compiler Error C2702 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2703.md b/docs/error-messages/compiler-errors-2/compiler-error-c2703.md index 623d6ac1c2a..87adbc90511 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2703.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2703.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2703." ms.date: 08/24/2020 f1_keywords: ["C2703"] helpviewer_keywords: ["C2703"] -ms.assetid: 384295c3-643d-47ae-a9a6-865b3036aa84 --- # Compiler Error C2703 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2704.md b/docs/error-messages/compiler-errors-2/compiler-error-c2704.md index eaac6df6c72..4d231d20a99 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2704.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2704.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2704" title: "Compiler Error C2704" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2704" +ms.date: 11/04/2016 f1_keywords: ["C2704"] helpviewer_keywords: ["C2704"] -ms.assetid: 185797e2-55b5-4c11-8493-e70eb1d15a94 --- # Compiler Error C2704 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2705.md b/docs/error-messages/compiler-errors-2/compiler-error-c2705.md index e9ec12edaac..d080e7a213e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2705.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2705.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2705." ms.date: 08/25/2020 f1_keywords: ["C2705"] helpviewer_keywords: ["C2705"] -ms.assetid: 29249ea3-4ea7-4105-944b-bdb83e8d6852 --- # Compiler Error C2705 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2706.md b/docs/error-messages/compiler-errors-2/compiler-error-c2706.md index 7209a543250..0490d7807ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2706.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2706.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2706." ms.date: 08/25/2020 f1_keywords: ["C2706"] helpviewer_keywords: ["C2706"] -ms.assetid: e18da924-c42d-4b09-8e29-f4e0382d7dc6 --- # Compiler Error C2706 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md index 76a5a20823f..3bfc8a90ae7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2707" title: "Compiler Error C2707" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2707" +ms.date: 11/04/2016 f1_keywords: ["C2707"] helpviewer_keywords: ["C2707"] -ms.assetid: 3deaf45c-74da-4c9d-acc6-b82412720b74 --- # Compiler Error C2707 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2708.md b/docs/error-messages/compiler-errors-2/compiler-error-c2708.md index 9b6bc30afe3..a8b2f3d6500 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2708.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2708.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2708" title: "Compiler Error C2708" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2708" +ms.date: 11/04/2016 f1_keywords: ["C2708"] helpviewer_keywords: ["C2708"] -ms.assetid: d52d3088-1141-42f4-829c-74755a7fcc3a --- # Compiler Error C2708 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2709.md b/docs/error-messages/compiler-errors-2/compiler-error-c2709.md index d87b78d38a7..36a2376616d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2709.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2709.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2709" title: "Compiler Error C2709" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2709" +ms.date: 11/04/2016 f1_keywords: ["C2709"] helpviewer_keywords: ["C2709"] -ms.assetid: e66fc7e6-0e91-4b99-a6e0-fdb069b09fbc --- # Compiler Error C2709 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md index 6d8e73d9424..3019c67c1ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2710" title: "Compiler Error C2710" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2710" +ms.date: 11/04/2016 f1_keywords: ["C2710"] helpviewer_keywords: ["C2710"] -ms.assetid: a2a6bb5b-86ad-4a6c-acd0-e2bef8464e0e --- # Compiler Error C2710 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md index c27eaf12bec..a0b44f38278 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2711" title: "Compiler Error C2711" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2711" +ms.date: 11/04/2016 f1_keywords: ["C2711"] helpviewer_keywords: ["C2711"] -ms.assetid: 9df9f808-7419-4e63-abdd-e6538ff0871f --- # Compiler Error C2711 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2712.md b/docs/error-messages/compiler-errors-2/compiler-error-c2712.md index 926c02efbc0..b1caf1ca2da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2712.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2712.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2712." ms.date: 08/25/2020 f1_keywords: ["C2712"] helpviewer_keywords: ["C2712"] -ms.assetid: f7d4ffcc-7ed2-459b-8067-a728ce647071 --- # Compiler Error C2712 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2713.md b/docs/error-messages/compiler-errors-2/compiler-error-c2713.md index dfd1e055817..65eeed13bdc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2713.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2713.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2713." ms.date: 08/25/2020 f1_keywords: ["C2713"] helpviewer_keywords: ["C2713"] -ms.assetid: bae9bee3-b4b8-4be5-b6a5-02df587a7278 --- # Compiler Error C2713 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2714.md b/docs/error-messages/compiler-errors-2/compiler-error-c2714.md index 7511bd218ab..c876015451b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2714.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2714.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2714" title: "Compiler Error C2714" +description: "Learn more about: Compiler Error C2714" ms.date: 07/22/2020 f1_keywords: ["C2714"] helpviewer_keywords: ["C2714"] -ms.assetid: 401a5a42-660c-4bad-9d63-1a2d092bc489 --- # Compiler Error C2714 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md index 29d1a4e99d8..86f7e5ce731 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2715" title: "Compiler Error C2715" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2715" +ms.date: 11/04/2016 f1_keywords: ["C2715"] helpviewer_keywords: ["C2715"] -ms.assetid: c81567a7-5b65-468f-aaf9-835f91e468e4 --- # Compiler Error C2715 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md index 7f2c2f1387b..180afef6eac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2718" title: "Compiler Error C2718" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2718" +ms.date: 11/04/2016 f1_keywords: ["C2718"] helpviewer_keywords: ["C2718"] -ms.assetid: 78cc71f8-c142-46fc-9aed-970635d74f0c --- # Compiler Error C2718 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md index 2e1062c3993..6df11d9414e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2719" title: "Compiler Error C2719" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2719" +ms.date: 11/04/2016 f1_keywords: ["C2719"] helpviewer_keywords: ["C2719"] -ms.assetid: ea6236d3-8286-45cc-9478-c84ad3dd3c8e --- # Compiler Error C2719 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2720.md b/docs/error-messages/compiler-errors-2/compiler-error-c2720.md index 6e0cbaab448..66fd999f7a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2720.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2720.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2720" title: "Compiler Error C2720" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2720" +ms.date: 11/04/2016 f1_keywords: ["C2720"] helpviewer_keywords: ["C2720"] -ms.assetid: 9ee3aab7-711b-4f5a-b2f1-cb62b130f1ce --- # Compiler Error C2720 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2721.md b/docs/error-messages/compiler-errors-2/compiler-error-c2721.md index 385dfe0d345..2bfd272ae2c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2721.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2721.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2721" title: "Compiler Error C2721" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2721" +ms.date: 11/04/2016 f1_keywords: ["C2721"] helpviewer_keywords: ["C2721"] -ms.assetid: 7a97823c-3ce1-4112-8253-fc1448685235 --- # Compiler Error C2721 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2722.md b/docs/error-messages/compiler-errors-2/compiler-error-c2722.md index 59a01019021..892e345c5cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2722.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2722.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2722" title: "Compiler Error C2722" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2722" +ms.date: 11/04/2016 f1_keywords: ["C2722"] helpviewer_keywords: ["C2722"] -ms.assetid: 4cc2c7fa-cb12-4bcf-9df1-6d627ef62973 --- # Compiler Error C2722 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md index 6d2a1a70dd8..b878410fa11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2723" title: "Compiler Error C2723" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2723" +ms.date: 11/04/2016 f1_keywords: ["C2723"] helpviewer_keywords: ["C2723"] -ms.assetid: 86925601-2297-4cfd-94e2-2caf27c474c4 --- # Compiler Error C2723 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md index e500613b2c6..ef72d45e281 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2725" title: "Compiler Error C2725" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2725" +ms.date: 11/04/2016 f1_keywords: ["C2725"] helpviewer_keywords: ["C2725"] -ms.assetid: 13cd5b1b-e906-4cd8-9b2b-510d587c665a --- # Compiler Error C2725 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md index 42a2a207ced..22aa1b52408 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2726" title: "Compiler Error C2726" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2726" +ms.date: 11/04/2016 f1_keywords: ["C2726"] helpviewer_keywords: ["C2726"] -ms.assetid: f0191bb7-c175-450b-bf09-a3213db96d09 --- # Compiler Error C2726 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md index 6aa45f9c904..8300ece3561 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2728" title: "Compiler Error C2728" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2728" +ms.date: 11/04/2016 f1_keywords: ["C2728"] helpviewer_keywords: ["C2728"] -ms.assetid: 65635f91-1cd1-46e4-9ad7-14726d0546af --- # Compiler Error C2728 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2730.md b/docs/error-messages/compiler-errors-2/compiler-error-c2730.md index e33bac443cb..f06cf3b7fed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2730.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2730.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2730" title: "Compiler Error C2730" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2730" +ms.date: 11/04/2016 f1_keywords: ["C2730"] helpviewer_keywords: ["C2730"] -ms.assetid: 07f0b17a-bc8e-4d79-af5a-07a07af3687b --- # Compiler Error C2730 From a5a95ab57d839e1822a1f1aa129decdc3c916472 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 17:05:25 +0800 Subject: [PATCH 0633/1799] Add backticks in `/ZW` flag reference topic --- docs/build/reference/zw-windows-runtime-compilation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/zw-windows-runtime-compilation.md b/docs/build/reference/zw-windows-runtime-compilation.md index 6bba2c712c5..e841d78b070 100644 --- a/docs/build/reference/zw-windows-runtime-compilation.md +++ b/docs/build/reference/zw-windows-runtime-compilation.md @@ -32,7 +32,7 @@ When you specify the **`/ZW`** option, the compiler supports these features: - Automatic reference-counting of Windows Runtime objects, and automatic discarding of an object when its reference count goes to zero. -Because the incremental linker doesn't support the Windows metadata included in .obj files by using the **`/ZW`** option, the deprecated [/Gm (Enable Minimal Rebuild)](gm-enable-minimal-rebuild.md) option is incompatible with **`/ZW`**. +Because the incremental linker doesn't support the Windows metadata included in `.obj` files by using the **`/ZW`** option, the deprecated [`/Gm` (Enable Minimal Rebuild)](gm-enable-minimal-rebuild.md) option is incompatible with **`/ZW`**. For more information, see [Visual C++ Language Reference](../../cppcx/visual-c-language-reference-c-cx.md). From 2eda1717e8734984bc65d8037bbd62c4237c07c1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 17:06:32 +0800 Subject: [PATCH 0634/1799] Add and update links in `/ZW` flag reference topic --- docs/build/reference/zw-windows-runtime-compilation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/build/reference/zw-windows-runtime-compilation.md b/docs/build/reference/zw-windows-runtime-compilation.md index e841d78b070..75d3bf91695 100644 --- a/docs/build/reference/zw-windows-runtime-compilation.md +++ b/docs/build/reference/zw-windows-runtime-compilation.md @@ -9,8 +9,8 @@ helpviewer_keywords: ["/ZW", "-ZW compiler option", "/ZW compiler option", "-ZW" Compiles source code to support Microsoft C++ component extensions C++/CX for the creation of Universal Windows Platform (UWP) apps. -When you use **`/ZW`** to compile, always specify **`/EHsc`** as well.\ -**`/ZW`** isn't compatible with **`/std:c++20`**. +When you use **`/ZW`** to compile, always specify [`/EHsc`](eh-exception-handling-model.md) as well.\ +**`/ZW`** isn't compatible with [`/std:c++20`](std-specify-language-standard-version.md). ## Syntax @@ -34,7 +34,7 @@ When you specify the **`/ZW`** option, the compiler supports these features: Because the incremental linker doesn't support the Windows metadata included in `.obj` files by using the **`/ZW`** option, the deprecated [`/Gm` (Enable Minimal Rebuild)](gm-enable-minimal-rebuild.md) option is incompatible with **`/ZW`**. -For more information, see [Visual C++ Language Reference](../../cppcx/visual-c-language-reference-c-cx.md). +For more information, see [C++/CX Language Reference](../../cppcx/visual-c-language-reference-c-cx.md). ## Requirements From 26c3ff3702f9250a7c74b2c038ba0c9817bfa4df Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 17:07:10 +0800 Subject: [PATCH 0635/1799] Remove empty "Requirements" section and small tweak in `/ZW` flag reference topic --- docs/build/reference/zw-windows-runtime-compilation.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/build/reference/zw-windows-runtime-compilation.md b/docs/build/reference/zw-windows-runtime-compilation.md index 75d3bf91695..a3e1564b395 100644 --- a/docs/build/reference/zw-windows-runtime-compilation.md +++ b/docs/build/reference/zw-windows-runtime-compilation.md @@ -21,7 +21,7 @@ When you use **`/ZW`** to compile, always specify [`/EHsc`](eh-exception-handlin ## Arguments -**`nostdlib`**\ +*`nostdlib`*\ Indicates that `Platform.winmd`, `Windows.Foundation.winmd`, and other default Windows metadata (`.winmd`) files aren't automatically included in the compilation. Instead, you must use the [`/FU` (Name Forced #using File)](fu-name-forced-hash-using-file.md) compiler option to explicitly specify Windows metadata files. ## Remarks @@ -36,8 +36,6 @@ Because the incremental linker doesn't support the Windows metadata included in For more information, see [C++/CX Language Reference](../../cppcx/visual-c-language-reference-c-cx.md). -## Requirements - ## See also [MSVC Compiler Options](compiler-options.md)\ From 2bf62d6d1100a851f1bff7ecb74c382f39eb2749 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 17:07:37 +0800 Subject: [PATCH 0636/1799] Remove `cpp` language from syntax code block in `/ZW` flag reference topic --- docs/build/reference/zw-windows-runtime-compilation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/zw-windows-runtime-compilation.md b/docs/build/reference/zw-windows-runtime-compilation.md index a3e1564b395..95d63422396 100644 --- a/docs/build/reference/zw-windows-runtime-compilation.md +++ b/docs/build/reference/zw-windows-runtime-compilation.md @@ -14,7 +14,7 @@ When you use **`/ZW`** to compile, always specify [`/EHsc`](eh-exception-handlin ## Syntax -```cpp +``` /ZW /EHsc /ZW:nostdlib /EHsc ``` From ac9f5ffdf046d456ebf7c21241559ef590ff9e23 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 17:08:30 +0800 Subject: [PATCH 0637/1799] Clarify that `/ZW` is incompatible with `/std:c++20` or later in `/ZW` flag reference topic --- docs/build/reference/zw-windows-runtime-compilation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/zw-windows-runtime-compilation.md b/docs/build/reference/zw-windows-runtime-compilation.md index 95d63422396..78f5a55ae28 100644 --- a/docs/build/reference/zw-windows-runtime-compilation.md +++ b/docs/build/reference/zw-windows-runtime-compilation.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["/ZW", "-ZW compiler option", "/ZW compiler option", "-ZW" Compiles source code to support Microsoft C++ component extensions C++/CX for the creation of Universal Windows Platform (UWP) apps. When you use **`/ZW`** to compile, always specify [`/EHsc`](eh-exception-handling-model.md) as well.\ -**`/ZW`** isn't compatible with [`/std:c++20`](std-specify-language-standard-version.md). +**`/ZW`** isn't compatible with [`/std:c++20`](std-specify-language-standard-version.md) or later. ## Syntax From 8877d14ec4f58c912e0da096ed98208033be4a43 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 17:09:01 +0800 Subject: [PATCH 0638/1799] Move `title` metadata above `description` in `/ZW` flag reference topic --- docs/build/reference/zw-windows-runtime-compilation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/zw-windows-runtime-compilation.md b/docs/build/reference/zw-windows-runtime-compilation.md index 78f5a55ae28..b535b3e7c78 100644 --- a/docs/build/reference/zw-windows-runtime-compilation.md +++ b/docs/build/reference/zw-windows-runtime-compilation.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: /ZW (Windows Runtime Compilation)" title: "/ZW (Windows Runtime Compilation)" +description: "Learn more about: /ZW (Windows Runtime Compilation)" ms.date: 06/22/2023 f1_keywords: ["VC.Project.VCCLCompilerTool.CompileAsWinRT", "/zw"] helpviewer_keywords: ["/ZW", "-ZW compiler option", "/ZW compiler option", "-ZW", "Windows Runtime compiler option"] From b62f7c56ce73780c20c45344a5e96975bd8aa5ad Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 17:49:23 +0800 Subject: [PATCH 0639/1799] Clean up empty "Requirements" headings --- docs/c-runtime-library/setjmp3.md | 2 -- docs/cppcx/operator-type-hat.md | 2 -- docs/cppcx/operator-windows-ui-xaml-interop-typename.md | 2 -- docs/cppcx/platform-ibox-interface.md | 2 -- 4 files changed, 8 deletions(-) diff --git a/docs/c-runtime-library/setjmp3.md b/docs/c-runtime-library/setjmp3.md index 05fbacbc026..48049558c60 100644 --- a/docs/c-runtime-library/setjmp3.md +++ b/docs/c-runtime-library/setjmp3.md @@ -43,8 +43,6 @@ Always returns 0. Don't use this function in a C++ program. It's an intrinsic function that doesn't support C++. For more information about how to use `setjmp`, see [Using setjmp/longjmp](../cpp/using-setjmp-longjmp.md). -## Requirements - ## See also [Alphabetical function reference](./reference/crt-alphabetical-function-reference.md)\ diff --git a/docs/cppcx/operator-type-hat.md b/docs/cppcx/operator-type-hat.md index 658cfdad71f..2417ad92e76 100644 --- a/docs/cppcx/operator-type-hat.md +++ b/docs/cppcx/operator-type-hat.md @@ -42,8 +42,6 @@ Type^ tx2 = (Type^)(tn); .NET Framework programs project `TypeName` as -### Requirements - ## See also [operator Windows::UI::Xaml::Interop::TypeName](../cppcx/operator-windows-ui-xaml-interop-typename.md)
diff --git a/docs/cppcx/operator-windows-ui-xaml-interop-typename.md b/docs/cppcx/operator-windows-ui-xaml-interop-typename.md index 750e6301a96..fae1128437d 100644 --- a/docs/cppcx/operator-windows-ui-xaml-interop-typename.md +++ b/docs/cppcx/operator-windows-ui-xaml-interop-typename.md @@ -42,8 +42,6 @@ Type^ tx2 = (Type^)(tn); .NET Framework programs project `TypeName` as [System.Type](/dotnet/api/system.type). -### Requirements - ## See also [operator Windows::UI::Xaml::Interop::TypeName](../cppcx/operator-windows-ui-xaml-interop-typename.md)
diff --git a/docs/cppcx/platform-ibox-interface.md b/docs/cppcx/platform-ibox-interface.md index bf606fcf34c..c57a1f3a43a 100644 --- a/docs/cppcx/platform-ibox-interface.md +++ b/docs/cppcx/platform-ibox-interface.md @@ -26,8 +26,6 @@ The type of the boxed value. The `IBox` interface is primarily used internally to represent nullable value types, as described in [Value classes and structs (C++/CX)](../cppcx/value-classes-and-structs-c-cx.md). The interface is also used to box value types that are passed to C++ methods that take parameters of type `Object^`. You can explicitly declare an input parameter as `IBox`. For an example, see [Boxing](../cppcx/boxing-c-cx.md). -### Requirements - ### Members The `Platform::IBox` interface inherits from the [Platform::IValueType](../cppcx/platform-ivaluetype-interface.md) interface. `IBox` has these members: From 3b7df36f120b65ac57c66d833f80ef8f4438bf73 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 17:51:13 +0800 Subject: [PATCH 0640/1799] Update metadata in 4 topics --- docs/c-runtime-library/setjmp3.md | 5 ++--- docs/cppcx/operator-type-hat.md | 5 ++--- docs/cppcx/operator-windows-ui-xaml-interop-typename.md | 5 ++--- docs/cppcx/platform-ibox-interface.md | 5 ++--- 4 files changed, 8 insertions(+), 12 deletions(-) diff --git a/docs/c-runtime-library/setjmp3.md b/docs/c-runtime-library/setjmp3.md index 48049558c60..d406921ec9d 100644 --- a/docs/c-runtime-library/setjmp3.md +++ b/docs/c-runtime-library/setjmp3.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _setjmp3" title: "_setjmp3" -ms.date: "1/14/2021" +description: "Learn more about: _setjmp3" +ms.date: 1/14/2021 api_name: ["_setjmp3"] api_location: ["msvcrt.dll", "msvcr90.dll", "msvcr110.dll", "msvcr80.dll", "msvcr110_clr0400.dll", "msvcr100.dll", "msvcr120.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["setjmp3", "_setjmp3"] helpviewer_keywords: ["_setjmp3 function", "setjmp3 function"] -ms.assetid: 6129c2f3-8bac-4fdb-a827-44e1eebba500 --- # `_setjmp3` diff --git a/docs/cppcx/operator-type-hat.md b/docs/cppcx/operator-type-hat.md index 2417ad92e76..238e11d9715 100644 --- a/docs/cppcx/operator-type-hat.md +++ b/docs/cppcx/operator-type-hat.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: operator Type^" title: "operator Type^" -ms.date: "12/30/2016" -ms.assetid: b24ffc83-0780-4f9a-8ee0-f5725db339d1 +description: "Learn more about: operator Type^" +ms.date: 12/30/2016 --- # operator Type^ diff --git a/docs/cppcx/operator-windows-ui-xaml-interop-typename.md b/docs/cppcx/operator-windows-ui-xaml-interop-typename.md index fae1128437d..0e585769a5e 100644 --- a/docs/cppcx/operator-windows-ui-xaml-interop-typename.md +++ b/docs/cppcx/operator-windows-ui-xaml-interop-typename.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: operator Windows::UI::Xaml::Interop::TypeName" title: "operator Windows::UI::Xaml::Interop::TypeName" -ms.date: "12/30/2016" -ms.assetid: a65a105e-7e3a-452f-932f-2cdaf00fbba5 +description: "Learn more about: operator Windows::UI::Xaml::Interop::TypeName" +ms.date: 12/30/2016 --- # operator Windows::UI::Xaml::Interop::TypeName diff --git a/docs/cppcx/platform-ibox-interface.md b/docs/cppcx/platform-ibox-interface.md index c57a1f3a43a..fdc629b0e21 100644 --- a/docs/cppcx/platform-ibox-interface.md +++ b/docs/cppcx/platform-ibox-interface.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Platform::IBox Interface" title: "Platform::IBox Interface" -ms.date: "12/30/2016" +description: "Learn more about: Platform::IBox Interface" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Namespace not found::Platform", "VCCORLIB/Namespace not found::Platform::Value"] -ms.assetid: 774df45d-f8a7-45a3-ae24-eecc3c681040 --- # Platform::IBox Interface From 1fa294bfc790250d7a1828c47e21dc3e36f81a9b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 18:14:52 +0800 Subject: [PATCH 0641/1799] Rectify mismatched warning link text and link --- docs/code-quality/c26498.md | 2 +- docs/code-quality/code-analysis-for-cpp-corecheck.md | 2 +- docs/preprocessor/compiler-warnings-that-are-off-by-default.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/code-quality/c26498.md b/docs/code-quality/c26498.md index 417a4254275..fe3de0e6325 100644 --- a/docs/code-quality/c26498.md +++ b/docs/code-quality/c26498.md @@ -58,6 +58,6 @@ void foo() ## See also -[C26497](c26407.md)\ +[C26497](c26497.md)\ [C26814](c26814.md)\ [Con.5: Use `constexpr` for values that can be computed at compile time](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr) diff --git a/docs/code-quality/code-analysis-for-cpp-corecheck.md b/docs/code-quality/code-analysis-for-cpp-corecheck.md index 82158f2233b..a70fc634739 100644 --- a/docs/code-quality/code-analysis-for-cpp-corecheck.md +++ b/docs/code-quality/code-analysis-for-cpp-corecheck.md @@ -214,7 +214,7 @@ Do not use function style C-casts. See [C++ Core Guidelines ES.49](https://isocp [C26490 NO_REINTERPRET_CAST](c26490.md)\ Don't use `reinterpret_cast`. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). -[C26491 NO_STATIC_DOWNCAST](c26490.md)\ +[C26491 NO_STATIC_DOWNCAST](c26491.md)\ Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-downcast). [C26492 NO_CONST_CAST](c26492.md)\ diff --git a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md index 96a31c29833..04ffb783279 100644 --- a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md +++ b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md @@ -168,7 +168,7 @@ The following warnings are turned off by default in Visual Studio 2019 and later | C5220 (level 4) | '*member*': a non-static data member with a volatile qualified type no longer implies that
compiler generated copy/move constructors and copy/move assignment operators are not trivial 16.7 | | C5233 (level 4) | explicit lambda capture '*identifier*' is not used 16.10 | | [C5240 (level 4)](../error-messages/compiler-warnings/c5240.md) | '*attribute-name*': attribute is ignored in this syntactic position 16.10 | -| [C5243 (level 1)](../error-messages/compiler-warnings/c5247.md) | '*type-name*': using incomplete class '*class-name*' can cause potential one definition rule violation due to ABI limitation 16.10 | +| [C5243 (level 1)](../error-messages/compiler-warnings/c5243.md) | '*type-name*': using incomplete class '*class-name*' can cause potential one definition rule violation due to ABI limitation 16.10 | | C5245 (level 4) | '*function*': unreferenced function with internal linkage has been removed | | C5246 (level 1) | '*member*': the initialization of a subobject should be wrapped in braces 16.10 | | [C5247 (level 1)](../error-messages/compiler-warnings/c5247.md) | Section '*section-name*' is reserved for C++ dynamic initialization. Manually creating the section will interfere with C++ dynamic initialization and may lead to undefined behavior 16.11 | From 2584684ac54de625ddb2fa9a454d49300c7afd60 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 18:16:07 +0800 Subject: [PATCH 0642/1799] Update metadata in 2 topics --- docs/code-quality/c26498.md | 2 +- docs/code-quality/code-analysis-for-cpp-corecheck.md | 3 +-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/code-quality/c26498.md b/docs/code-quality/c26498.md index fe3de0e6325..7bb0edb9750 100644 --- a/docs/code-quality/c26498.md +++ b/docs/code-quality/c26498.md @@ -1,5 +1,5 @@ --- -title: Warning C26498 +title: "Warning C26498" description: "Learn more about: Warning C26498 USE_CONSTEXPR_FOR_FUNCTIONCALL" ms.date: 08/18/2020 f1_keywords: ["C26498", "USE_CONSTEXPR_FOR_FUNCTIONCALL"] diff --git a/docs/code-quality/code-analysis-for-cpp-corecheck.md b/docs/code-quality/code-analysis-for-cpp-corecheck.md index a70fc634739..c57ae64393f 100644 --- a/docs/code-quality/code-analysis-for-cpp-corecheck.md +++ b/docs/code-quality/code-analysis-for-cpp-corecheck.md @@ -1,11 +1,10 @@ --- +title: "C++ Core Guidelines checker reference" description: "Learn more about: C++ Core Guidelines checker reference" -title: C++ Core Guidelines checker reference ms.date: 03/22/2018 ms.topic: reference helpviewer_keywords: - "code analysis, C++ core check" -ms.assetid: f1429463-136e-41ed-8a75-a8dbf0b4fd89 --- # C++ Core Guidelines checker reference From 2fa003c236e32bbd01f5811d29b9c87c7871edf9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 18:52:35 +0800 Subject: [PATCH 0643/1799] Elide some wrong uses of `/c` flag in C runtime library --- .../reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md | 1 - .../reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md | 1 - .../reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md | 1 - docs/c-runtime-library/reference/cwait.md | 1 - docs/c-runtime-library/reference/getch-getwch.md | 1 - docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md | 1 - docs/c-runtime-library/reference/getche-getwche.md | 1 - .../c-runtime-library/reference/getche-nolock-getwche-nolock.md | 1 - docs/c-runtime-library/reference/getdiskfree.md | 2 +- docs/c-runtime-library/reference/getdrive.md | 1 - docs/c-runtime-library/reference/kbhit.md | 1 - docs/c-runtime-library/reference/set-error-mode.md | 2 +- .../ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md | 1 - .../vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md | 2 +- .../reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md | 2 +- 15 files changed, 4 insertions(+), 15 deletions(-) diff --git a/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md b/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md index 55418b0ad26..1d39021b00b 100644 --- a/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md +++ b/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md @@ -85,7 +85,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_cprintf.c -// compile with: /c // This program displays some variables to the console. #include diff --git a/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md b/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md index 0c80a6f0680..3dc9149a342 100644 --- a/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md +++ b/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md @@ -93,7 +93,6 @@ All versions of the [C run-time libraries](../crt-library-features.md). ```C // crt_cprintf_s.c -// compile with: /c // This program displays some variables to the console. #include diff --git a/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md b/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md index 87dac808b60..9a686228d90 100644 --- a/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md +++ b/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md @@ -92,7 +92,6 @@ All versions of the [C run-time libraries](../crt-library-features.md). ```C // crt_cscanf_s.c -// compile with: /c /* This program prompts for a string * and uses _cscanf_s to read in the response. * Then _cscanf_s returns the number of items diff --git a/docs/c-runtime-library/reference/cwait.md b/docs/c-runtime-library/reference/cwait.md index aeaaad8adc5..3bbde03daf5 100644 --- a/docs/c-runtime-library/reference/cwait.md +++ b/docs/c-runtime-library/reference/cwait.md @@ -73,7 +73,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_cwait.c -// compile with: /c // This program launches several processes and waits // for a specified process to finish. diff --git a/docs/c-runtime-library/reference/getch-getwch.md b/docs/c-runtime-library/reference/getch-getwch.md index 82d45dd7758..742895fddbc 100644 --- a/docs/c-runtime-library/reference/getch-getwch.md +++ b/docs/c-runtime-library/reference/getch-getwch.md @@ -54,7 +54,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getch.c -// compile with: /c // This program reads characters from // the keyboard until it receives a 'Y' or 'y'. diff --git a/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md b/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md index 61bf1a4acec..96bdf201474 100644 --- a/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md +++ b/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md @@ -52,7 +52,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getch_nolock.c -// compile with: /c // This program reads characters from // the keyboard until it receives a 'Y' or 'y'. diff --git a/docs/c-runtime-library/reference/getche-getwche.md b/docs/c-runtime-library/reference/getche-getwche.md index 188c2ee2e72..77b7351a950 100644 --- a/docs/c-runtime-library/reference/getche-getwche.md +++ b/docs/c-runtime-library/reference/getche-getwche.md @@ -55,7 +55,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getche.c -// compile with: /c // This program reads characters from // the keyboard until it receives a 'Y' or 'y'. diff --git a/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md b/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md index c9c6b7ad6fa..c3293873c86 100644 --- a/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md +++ b/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md @@ -52,7 +52,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getche_nolock.c -// compile with: /c // This program reads characters from // the keyboard until it receives a 'Y' or 'y'. diff --git a/docs/c-runtime-library/reference/getdiskfree.md b/docs/c-runtime-library/reference/getdiskfree.md index 9ddb84d87bd..c622fb7cba4 100644 --- a/docs/c-runtime-library/reference/getdiskfree.md +++ b/docs/c-runtime-library/reference/getdiskfree.md @@ -66,7 +66,7 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getdiskfree.c -// compile with: /c + #include #include #include diff --git a/docs/c-runtime-library/reference/getdrive.md b/docs/c-runtime-library/reference/getdrive.md index 571445fb636..36295f24909 100644 --- a/docs/c-runtime-library/reference/getdrive.md +++ b/docs/c-runtime-library/reference/getdrive.md @@ -43,7 +43,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getdrive.c -// compile with: /c // Illustrates drive functions including: // _getdrive _chdrive _getdcwd // diff --git a/docs/c-runtime-library/reference/kbhit.md b/docs/c-runtime-library/reference/kbhit.md index 3d89e65caa9..290a8c64bd0 100644 --- a/docs/c-runtime-library/reference/kbhit.md +++ b/docs/c-runtime-library/reference/kbhit.md @@ -48,7 +48,6 @@ All versions of the [C run-time libraries](../crt-library-features.md). ```C // crt_kbhit.c -// compile with: /c /* This program loops until the user * presses a key. If _kbhit returns nonzero, a * keystroke is waiting in the buffer. The program diff --git a/docs/c-runtime-library/reference/set-error-mode.md b/docs/c-runtime-library/reference/set-error-mode.md index cdbce0d93f7..f85edc97423 100644 --- a/docs/c-runtime-library/reference/set-error-mode.md +++ b/docs/c-runtime-library/reference/set-error-mode.md @@ -61,7 +61,7 @@ When it's used with an [`assert`](assert-macro-assert-wassert.md), **`_set_error ```C // crt_set_error_mode.c -// compile with: /c + #include #include diff --git a/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md b/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md index 5c15bfbf429..42c44c2c9e5 100644 --- a/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md +++ b/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md @@ -70,7 +70,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_ungetch.c -// compile with: /c // In this program, a white-space delimited // token is read from the keyboard. When the program // encounters a delimiter, it uses _ungetch to replace diff --git a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md index 5a40fed9d72..d110402b8a4 100644 --- a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md @@ -94,7 +94,7 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_vcprintf_p.c -// compile with: /c + #include #include diff --git a/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md b/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md index 236d8685bef..0bffc074e8c 100644 --- a/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md +++ b/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md @@ -89,7 +89,7 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```cpp // crt_vcprintf.cpp -// compile with: /c + #include #include From 84283019c57d2db115cf3f3a5d97d27db0b9dba5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 18:58:14 +0800 Subject: [PATCH 0644/1799] Update metadata in 13 C runtime library topics --- .../reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md | 4 ++-- .../reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md | 5 ++--- docs/c-runtime-library/reference/cwait.md | 3 +-- docs/c-runtime-library/reference/getch-getwch.md | 2 +- .../reference/getch-nolock-getwch-nolock.md | 2 +- docs/c-runtime-library/reference/getche-getwche.md | 3 +-- .../reference/getche-nolock-getwche-nolock.md | 2 +- docs/c-runtime-library/reference/getdiskfree.md | 2 +- docs/c-runtime-library/reference/getdrive.md | 5 ++--- docs/c-runtime-library/reference/kbhit.md | 2 +- docs/c-runtime-library/reference/set-error-mode.md | 5 ++--- .../ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md | 2 +- .../vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md | 4 ++-- 13 files changed, 18 insertions(+), 23 deletions(-) diff --git a/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md b/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md index 1d39021b00b..8dfe11ae631 100644 --- a/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md +++ b/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _cprintf, _cprintf_l, _cwprintf, _cwprintf_l" title: "_cprintf, _cprintf_l, _cwprintf, _cwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: _cprintf, _cprintf_l, _cwprintf, _cwprintf_l" +ms.date: 3/9/2021 api_name: ["_cwprintf_l", "_cprintf_l", "_cwprintf", "_cprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md b/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md index 9a686228d90..7ca544e88b7 100644 --- a/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md +++ b/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l" title: "_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l" -ms.date: "11/04/2016" +description: "Learn more about: _cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l" +ms.date: 11/04/2016 api_name: ["_cwscanf_s_l", "_cwscanf_s", "_cscanf_s", "_cscanf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cscanf_s", "cscanf_s_l", "cwscanf_s", "_cwscanf_s", "_tcscanf_s", "_cscanf_s", "_cwscanf_s_l", "_cscanf_s_l", "cwscanf_s_l", "_tcscanf_s_l", "tcscanf_s", "tcscanf_s_l"] helpviewer_keywords: ["cscanf_s function", "_cwscanf_s_l function", "tcscanf_s function", "console [C++], reading from", "_cscanf_s function", "data [C++], reading from the console", "cwscanf_s function", "_tcscanf_s_l function", "_cscanf_s_l function", "cscanf_s_l function", "cwscanf_s_l function", "reading data [C++], from the console", "_cwscanf_s function", "_tcscanf_s function", "tcscanf_s_l function"] -ms.assetid: 9ccab74d-916f-42a6-93d8-920525efdf4b --- # `_cscanf_s`, `_cscanf_s_l`, `_cwscanf_s`, `_cwscanf_s_l` diff --git a/docs/c-runtime-library/reference/cwait.md b/docs/c-runtime-library/reference/cwait.md index 3bbde03daf5..4f2d069a7c6 100644 --- a/docs/c-runtime-library/reference/cwait.md +++ b/docs/c-runtime-library/reference/cwait.md @@ -1,14 +1,13 @@ --- title: "_cwait" description: "API reference for the Microsoft Visual C runtime `_cwait()` function." -ms.date: "10/23/2020" +ms.date: 10/23/2020 api_name: ["_cwait", "_o__cwait"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-process-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_cwait"] helpviewer_keywords: ["cwait function", "_cwait function"] -ms.assetid: d9b596b5-45f4-4e03-9896-3f383cb922b8 --- # `_cwait` diff --git a/docs/c-runtime-library/reference/getch-getwch.md b/docs/c-runtime-library/reference/getch-getwch.md index 742895fddbc..08a4ff83acf 100644 --- a/docs/c-runtime-library/reference/getch-getwch.md +++ b/docs/c-runtime-library/reference/getch-getwch.md @@ -1,7 +1,7 @@ --- title: "_getch, _getwch" description: "API reference for _getch and _getwch; which get a character from the console without echo." -ms.date: "3/8/2023" +ms.date: 3/8/2023 api_name: ["_getch", "_getwch", "_o__getch", "_o__getwch"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md b/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md index 96bdf201474..91400665f61 100644 --- a/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md +++ b/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md @@ -1,7 +1,7 @@ --- title: "_getch_nolock, _getwch_nolock" description: "Learn more about: _getch_nolock, _getwch_nolock" -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_getwch_nolock", "_getch_nolock", "_o__getch_nolock", "_o__getwch_nolock"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/getche-getwche.md b/docs/c-runtime-library/reference/getche-getwche.md index 77b7351a950..6463db78934 100644 --- a/docs/c-runtime-library/reference/getche-getwche.md +++ b/docs/c-runtime-library/reference/getche-getwche.md @@ -1,14 +1,13 @@ --- title: "_getche, _getwche" description: "API reference for _getche and _getwche; which get a character from the console with echo." -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_getwche", "_getche", "_o__getche", "_o__getwche"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["getwche", "_getche", "_getwche"] helpviewer_keywords: ["characters, getting from console", "_getwche function", "getche function", "console, reading from", "getwche function", "_getche function"] -ms.assetid: eac978a8-c43a-4130-938f-54f12e2a0fda --- # `_getche`, `_getwche` diff --git a/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md b/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md index c3293873c86..9165a4f7b2a 100644 --- a/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md +++ b/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md @@ -1,7 +1,7 @@ --- title: "_getche_nolock, _getwche_nolock" description: "Learn more about: _getche_nolock, _getwche_nolock" -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_getche_nolock", "_getwche_nolock", "_o__getche_nolock", "_o__getwche_nolock"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/getdiskfree.md b/docs/c-runtime-library/reference/getdiskfree.md index c622fb7cba4..68fa48a070e 100644 --- a/docs/c-runtime-library/reference/getdiskfree.md +++ b/docs/c-runtime-library/reference/getdiskfree.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _getdiskfree" title: "_getdiskfree" +description: "Learn more about: _getdiskfree" ms.date: 05/11/2022 api_name: ["_getdiskfree", "_o__getdiskfree"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-filesystem-l1-1-0.dll"] diff --git a/docs/c-runtime-library/reference/getdrive.md b/docs/c-runtime-library/reference/getdrive.md index 36295f24909..743ae0d8239 100644 --- a/docs/c-runtime-library/reference/getdrive.md +++ b/docs/c-runtime-library/reference/getdrive.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _getdrive" title: "_getdrive" -ms.date: "4/2/2020" +description: "Learn more about: _getdrive" +ms.date: 4/2/2020 api_name: ["_getdrive", "_o__getdrive"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-filesystem-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_getdrive", "getdrive"] helpviewer_keywords: ["current disk drive", "getdrive function", "disk drives", "_getdrive function"] -ms.assetid: e40631a0-8f1a-4897-90ac-e1037ff30bca --- # `_getdrive` diff --git a/docs/c-runtime-library/reference/kbhit.md b/docs/c-runtime-library/reference/kbhit.md index 290a8c64bd0..fe9bfbf45fa 100644 --- a/docs/c-runtime-library/reference/kbhit.md +++ b/docs/c-runtime-library/reference/kbhit.md @@ -1,7 +1,7 @@ --- title: "_kbhit" description: "Learn more about: _kbhit" -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_kbhit", "_o__kbhit"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/set-error-mode.md b/docs/c-runtime-library/reference/set-error-mode.md index f85edc97423..28766500919 100644 --- a/docs/c-runtime-library/reference/set-error-mode.md +++ b/docs/c-runtime-library/reference/set-error-mode.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _set_error_mode" title: "_set_error_mode" -ms.date: "11/04/2016" +description: "Learn more about: _set_error_mode" +ms.date: 11/04/2016 api_name: ["_set_error_mode"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-runtime-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["set_error_mode", "_set_error_mode"] helpviewer_keywords: ["_set_error_mode function", "set_error_mode function"] -ms.assetid: f0807be5-73d1-4a32-a701-3c9bdd139c5c --- # `_set_error_mode` diff --git a/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md b/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md index 42c44c2c9e5..1564dabc49c 100644 --- a/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md +++ b/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md @@ -1,7 +1,7 @@ --- title: "_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock" description: "Learn more about: _ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock" -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_ungetch_nolock", "_ungetwch_nolock", "_ungetwch", "_ungetch", "_o__ungetch", "_o__ungetch_nolock", "_o__ungetwch", "_o__ungetwch_nolock"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md index d110402b8a4..99103757608 100644 --- a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l" title: "_vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_vcprintf_p", "_vcwprintf_p_l", "_vcprintf_p_l", "_vcwprintf_p"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] From 9f8372cf3567a925a9cac293b1264a523ab85b9c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 23:04:53 +0800 Subject: [PATCH 0645/1799] Add blockquotes for error messages in range [C2731, C2760] --- docs/error-messages/compiler-errors-2/compiler-error-c2731.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2732.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2734.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2735.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2736.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2738.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2739.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2743.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2745.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2748.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2749.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2750.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2751.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2752.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2753.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2754.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2755.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2756.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2757.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2758.md | 2 +- 20 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md index 3140f55a23e..eed56b56a8b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md @@ -8,7 +8,7 @@ ms.assetid: 9b563999-febd-4582-9147-f355083c091e --- # Compiler Error C2731 -'identifier' : function cannot be overloaded +> 'identifier' : function cannot be overloaded The functions `main`, `WinMain`, `DllMain`, and `LibMain` cannot be overloaded. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md index a8c934d69a8..b4453ea4c34 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md @@ -8,7 +8,7 @@ ms.assetid: 01b7ad2c-93cf-456f-a4c0-c5f2fdc7c07c --- # Compiler Error C2732 -linkage specification contradicts earlier specification for 'function' +> linkage specification contradicts earlier specification for 'function' The function is already declared with a different linkage specifier. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md index 926b55a676b..7e653ed6875 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md @@ -8,7 +8,7 @@ ms.assetid: e53a77b7-825c-42d1-a655-90e1c93b833e --- # Compiler Error C2734 -'identifier' : const object must be initialized if not extern +> 'identifier' : const object must be initialized if not extern The identifier is declared **`const`** but not initialized or **`extern`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md index c3549dc46d5..008da716a8f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md @@ -8,7 +8,7 @@ ms.assetid: 6ce45600-7148-4bc0-8699-af0ef137571e --- # Compiler Error C2735 -'keyword' keyword is not permitted in formal parameter type specifier +> 'keyword' keyword is not permitted in formal parameter type specifier The keyword is invalid in this context. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md index b0135806686..1efa45e48e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md @@ -8,7 +8,7 @@ ms.assetid: 95a6bc28-c0cb-49dc-87e6-e993dbbba881 --- # Compiler Error C2736 -'keyword' keyword is not permitted in cast +> 'keyword' keyword is not permitted in cast The keyword is invalid in a cast. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md index b640ef4a018..5a0c689bf89 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md @@ -8,7 +8,7 @@ ms.assetid: 896b4640-1ee0-4cd8-9910-de3efa30006a --- # Compiler Error C2738 -'declaration' : is ambiguous or is not a member of 'type' +> 'declaration' : is ambiguous or is not a member of 'type' A function was declared incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md index 15c3f8b0ea8..49025c6f196 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md @@ -8,7 +8,7 @@ ms.assetid: 5b63e435-7631-43d7-805e-f2adefb7e517 --- # Compiler Error C2739 -'number' : explicit managed or WinRT array dimensions must be between 1 and 32 +> 'number' : explicit managed or WinRT array dimensions must be between 1 and 32 An array dimension was not between 1 and 32. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md index 82d0b04f293..83b9c980684 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md @@ -8,7 +8,7 @@ ms.assetid: 644cd444-21d2-471d-a176-f5f52c5a0b73 --- # Compiler Error C2743 -'type' : cannot catch a native type with __clrcall destructor or copy constructor +> 'type' : cannot catch a native type with __clrcall destructor or copy constructor A module compiled with **/clr** attempted to catch an exception of native type and where the type's destructor or copy constructor uses `__clrcall` calling convention. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md index efa92f63c9e..1fd02ee31ee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md @@ -8,7 +8,7 @@ ms.assetid: a1c45f13-7667-4678-aa16-265304a449a1 --- # Compiler Error C2745 -'token' : this token cannot be converted to an identifier +> 'token' : this token cannot be converted to an identifier Identifiers must be comprised of legal characters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md index df420793898..f398794448c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md @@ -8,7 +8,7 @@ ms.assetid: b63ac78b-a200-499c-afea-15af1a1e819e --- # Compiler Error C2748 -managed or WinRT array creation must have array size or array initializer +> managed or WinRT array creation must have array size or array initializer A managed or WinRT array was ill formed. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md index 293ce1aaab8..9073cde5a8e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md @@ -8,7 +8,7 @@ ms.assetid: a81aef36-cdca-4d78-89d5-b72eff2500b2 --- # Compiler Error C2749 -'type' : can only throw or catch handle to a managed class with /clr:safe +> 'type' : can only throw or catch handle to a managed class with /clr:safe When using **/clr:safe**, you can only throw or catch a reference type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md index f38c917907c..b1ba0909d0c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md @@ -8,7 +8,7 @@ ms.assetid: 30450034-feb5-448c-9655-b8c5f3639695 --- # Compiler Error C2750 -'type' : cannot use 'new' on the reference type; use 'gcnew' instead +> 'type' : cannot use 'new' on the reference type; use 'gcnew' instead To create an instance of a CLR type, which causes the instance to be placed on the garbage-collected heap, you must use [gcnew](../../extensions/ref-new-gcnew-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md index 6a466cdf6a8..2dc760cb0e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2751"] --- # Compiler Error C2751 -'parameter' : the name of a function parameter cannot be qualified +> 'parameter' : the name of a function parameter cannot be qualified You cannot use a qualified name as a function parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md index 62770f96025..cc224302cfc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md @@ -8,7 +8,7 @@ ms.assetid: ae42b3ec-84a9-4e9d-8d59-3d208132d0b2 --- # Compiler Error C2752 -'template' : more than one partial specialization matches the template argument list +> 'template' : more than one partial specialization matches the template argument list An instantiation was ambiguous. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md index ba0897b0d1e..ad73979605e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md @@ -8,7 +8,7 @@ ms.assetid: 92bfeeac-524a-4a8e-9a4f-fb8269055826 --- # Compiler Error C2753 -'*template*' : partial specialization cannot match argument list for primary template +> '*template*' : partial specialization cannot match argument list for primary template If the template argument list matches the parameter list, the compiler treats it as the same template. Defining the same template twice is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md index fafd439fa48..ff0a83a3996 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md @@ -8,7 +8,7 @@ ms.assetid: 1cab66c5-da9d-4b81-b7fb-9cdc48ff1ccc --- # Compiler Error C2754 -'specialization' : a partial specialization cannot have a dependent non-type template parameter +> 'specialization' : a partial specialization cannot have a dependent non-type template parameter An attempt was made to partially specialize a template class that has a dependent non-type template parameter. This is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md index 99a5290a5fd..6c9f435c926 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md @@ -8,7 +8,7 @@ ms.assetid: 8ee4eeb6-4757-4efe-9100-38ff4a96f1de --- # Compiler Error C2755 -'param' : non-type parameter of a partial specialization must be a simple identifier +> 'param' : non-type parameter of a partial specialization must be a simple identifier The non-type parameter needs to be a simple identifier, something the compiler can resolve at compile time to a single identifier or a constant value. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md index 429fa87ea10..b4cac8973fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md @@ -8,7 +8,7 @@ ms.assetid: 42eb988d-4043-4dee-8fd4-596949f69a55 --- # Compiler Error C2756 -'template type' : default template arguments not allowed on a partial specialization +> 'template type' : default template arguments not allowed on a partial specialization The template for a partial specialization may not contain a default argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md index 5a863c1b734..96e1413bcc6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md @@ -8,7 +8,7 @@ ms.assetid: 421f102f-8a32-4d47-a109-811ddf2c909d --- # Compiler Error C2757 -'symbol' : a symbol with this name already exists and therefore this name cannot be used as a namespace name +> 'symbol' : a symbol with this name already exists and therefore this name cannot be used as a namespace name A symbol used in the current compilation as a namespace identifier is already being used in a referenced assembly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md index 534c6219932..08096850656 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2758"] --- # Compiler Error C2758 -'member': a member of reference type must be initialized +> 'member': a member of reference type must be initialized Compiler error C2758 is caused when the constructor does not initialize a member of reference type in an initializer list. The compiler leaves the member undefined. Reference member variables must initialized when declared or be given a value in the initialization list of the constructor. From 3054fccd4b920e9768c880d44a7d39a35f6e8aa3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 23:10:54 +0800 Subject: [PATCH 0646/1799] Add "Remarks" and "Example" headings for error references in range [C2731, C2760] --- docs/error-messages/compiler-errors-2/compiler-error-c2731.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2732.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2733.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2734.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2735.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2736.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2738.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2739.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2743.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2745.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2748.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2749.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2750.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2751.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2752.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2753.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2754.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2755.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2756.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2757.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2758.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2760.md | 2 +- 22 files changed, 75 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md index eed56b56a8b..7452dc63196 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md @@ -10,8 +10,12 @@ ms.assetid: 9b563999-febd-4582-9147-f355083c091e > 'identifier' : function cannot be overloaded +## Remarks + The functions `main`, `WinMain`, `DllMain`, and `LibMain` cannot be overloaded. +## Example + The following sample generates C2731: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md index b4453ea4c34..2a75b2fe7aa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md @@ -10,6 +10,8 @@ ms.assetid: 01b7ad2c-93cf-456f-a4c0-c5f2fdc7c07c > linkage specification contradicts earlier specification for 'function' +## Remarks + The function is already declared with a different linkage specifier. This error can be caused by include files with different linkage specifiers. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2733.md b/docs/error-messages/compiler-errors-2/compiler-error-c2733.md index 03a7ae6bf2f..b4fc45f5eb1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2733.md @@ -10,6 +10,8 @@ ms.assetid: 67f83561-c633-407c-a2ee-f9fd16e165bf > you cannot overload a function with 'C' linkage +## Remarks + More than one overloaded function is declared with `extern "C"` linkage. When using `"C"` linkage, only one form of a specified function can be external. Since overloaded functions have the same undecorated name, they can't be used with C programs. This error may occur after an upgrade because of conformance changes in Visual Studio 2019. Starting in Visual Studio 2019 version 16.3, the [`/Zc:externC-`](../../build/reference/zc-externc.md) compiler option relaxes this check. The option must come after any [`/permissive-`](../../build/reference/permissive-standards-conformance.md) option on the command line. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md index 7e653ed6875..2806335ae69 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md @@ -10,8 +10,12 @@ ms.assetid: e53a77b7-825c-42d1-a655-90e1c93b833e > 'identifier' : const object must be initialized if not extern +## Remarks + The identifier is declared **`const`** but not initialized or **`extern`**. +## Example + The following sample generates C2734: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md index 008da716a8f..fcaab3f1e25 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md @@ -10,8 +10,12 @@ ms.assetid: 6ce45600-7148-4bc0-8699-af0ef137571e > 'keyword' keyword is not permitted in formal parameter type specifier +## Remarks + The keyword is invalid in this context. +## Example + The following sample generates C2735: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md index 1efa45e48e6..db2c66c0d59 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md @@ -10,8 +10,12 @@ ms.assetid: 95a6bc28-c0cb-49dc-87e6-e993dbbba881 > 'keyword' keyword is not permitted in cast +## Remarks + The keyword is invalid in a cast. +## Example + The following sample generates C2736: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md index 5a0c689bf89..14f992ad73a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md @@ -10,8 +10,12 @@ ms.assetid: 896b4640-1ee0-4cd8-9910-de3efa30006a > 'declaration' : is ambiguous or is not a member of 'type' +## Remarks + A function was declared incorrectly. +## Example + The following sample generates C2738: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md index 49025c6f196..e663e146ba3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md @@ -10,8 +10,12 @@ ms.assetid: 5b63e435-7631-43d7-805e-f2adefb7e517 > 'number' : explicit managed or WinRT array dimensions must be between 1 and 32 +## Remarks + An array dimension was not between 1 and 32. +## Example + The following sample generates C2739 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md index 83b9c980684..1fd2bd3933d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md @@ -10,6 +10,8 @@ ms.assetid: 644cd444-21d2-471d-a176-f5f52c5a0b73 > 'type' : cannot catch a native type with __clrcall destructor or copy constructor +## Remarks + A module compiled with **/clr** attempted to catch an exception of native type and where the type's destructor or copy constructor uses `__clrcall` calling convention. When compiled with **/clr**, exception handling expects the member functions in a native type to be [__cdecl](../../cpp/cdecl.md) and not [__clrcall](../../cpp/clrcall.md). Native types with member functions using `__clrcall` calling convention cannot be caught in a module compiled with **/clr**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md index 1fd02ee31ee..5af41285bda 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md @@ -10,8 +10,12 @@ ms.assetid: a1c45f13-7667-4678-aa16-265304a449a1 > 'token' : this token cannot be converted to an identifier +## Remarks + Identifiers must be comprised of legal characters. +## Example + The following sample generates C2745: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md index f398794448c..9c70e234df9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md @@ -10,8 +10,12 @@ ms.assetid: b63ac78b-a200-499c-afea-15af1a1e819e > managed or WinRT array creation must have array size or array initializer +## Remarks + A managed or WinRT array was ill formed. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). +## Example + The following sample generates C2748 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md index 9073cde5a8e..332bc762dd7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md @@ -10,6 +10,8 @@ ms.assetid: a81aef36-cdca-4d78-89d5-b72eff2500b2 > 'type' : can only throw or catch handle to a managed class with /clr:safe +## Remarks + When using **/clr:safe**, you can only throw or catch a reference type. For more information, see [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md index b1ba0909d0c..2a13bf39c5e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md @@ -10,8 +10,12 @@ ms.assetid: 30450034-feb5-448c-9655-b8c5f3639695 > 'type' : cannot use 'new' on the reference type; use 'gcnew' instead +## Remarks + To create an instance of a CLR type, which causes the instance to be placed on the garbage-collected heap, you must use [gcnew](../../extensions/ref-new-gcnew-cpp-component-extensions.md). +## Example + The following sample generates C2750: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md index 2dc760cb0e2..85220ac36f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2751"] > 'parameter' : the name of a function parameter cannot be qualified +## Remarks + You cannot use a qualified name as a function parameter. +## Example + The following sample generates C2751: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md index cc224302cfc..8a3e8e78d99 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md @@ -10,8 +10,12 @@ ms.assetid: ae42b3ec-84a9-4e9d-8d59-3d208132d0b2 > 'template' : more than one partial specialization matches the template argument list +## Remarks + An instantiation was ambiguous. +## Example + The following sample generates C2752: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md index ad73979605e..ddefd79b0f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md @@ -10,6 +10,8 @@ ms.assetid: 92bfeeac-524a-4a8e-9a4f-fb8269055826 > '*template*' : partial specialization cannot match argument list for primary template +## Remarks + If the template argument list matches the parameter list, the compiler treats it as the same template. Defining the same template twice is not allowed. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md index ff0a83a3996..0d1a2204add 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md @@ -10,8 +10,12 @@ ms.assetid: 1cab66c5-da9d-4b81-b7fb-9cdc48ff1ccc > 'specialization' : a partial specialization cannot have a dependent non-type template parameter +## Remarks + An attempt was made to partially specialize a template class that has a dependent non-type template parameter. This is not allowed. +## Example + The following sample generates C2754: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md index 6c9f435c926..5c1455ab07b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md @@ -10,8 +10,12 @@ ms.assetid: 8ee4eeb6-4757-4efe-9100-38ff4a96f1de > 'param' : non-type parameter of a partial specialization must be a simple identifier +## Remarks + The non-type parameter needs to be a simple identifier, something the compiler can resolve at compile time to a single identifier or a constant value. +## Example + The following sample generates C2755: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md index b4cac8973fd..6e21f7d0dc5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md @@ -10,8 +10,12 @@ ms.assetid: 42eb988d-4043-4dee-8fd4-596949f69a55 > 'template type' : default template arguments not allowed on a partial specialization +## Remarks + The template for a partial specialization may not contain a default argument. +## Example + The following sample generates C2756 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md index 96e1413bcc6..c1de5fa31bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md @@ -10,8 +10,12 @@ ms.assetid: 421f102f-8a32-4d47-a109-811ddf2c909d > 'symbol' : a symbol with this name already exists and therefore this name cannot be used as a namespace name +## Remarks + A symbol used in the current compilation as a namespace identifier is already being used in a referenced assembly. +## Example + The following sample generates C2757: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md index 08096850656..63106491a7d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2758"] > 'member': a member of reference type must be initialized +## Remarks + Compiler error C2758 is caused when the constructor does not initialize a member of reference type in an initializer list. The compiler leaves the member undefined. Reference member variables must initialized when declared or be given a value in the initialization list of the constructor. +## Example + The following sample generates C2758: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2760.md b/docs/error-messages/compiler-errors-2/compiler-error-c2760.md index e33c5a9552a..4a8aca52469 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2760.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2760.md @@ -16,7 +16,7 @@ ms.assetid: 585757fd-d519-43f3-94e5-50316ac8b90b There are several ways to cause this error. Usually, it's caused by a token sequence that the compiler can't make sense of. -## Example +## Examples In this sample, a casting operator is used with an invalid operator. From 5a9e42e97c11e2d2540da7f7ab97535b99ee24bf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 23:12:20 +0800 Subject: [PATCH 0647/1799] Replace term "sample" with "example" for error references in range [C2731, C2760] --- docs/error-messages/compiler-errors-2/compiler-error-c2731.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2732.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2733.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2734.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2735.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2736.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2738.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2739.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2743.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2745.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2748.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2749.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2750.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2751.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2752.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2753.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2754.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2755.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2756.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2757.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2758.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2760.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md index 7452dc63196..2a666957af8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md @@ -16,7 +16,7 @@ The functions `main`, `WinMain`, `DllMain`, and `LibMain` cannot be overloaded. ## Example -The following sample generates C2731: +The following example generates C2731: ```cpp // C2731.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md index 2a75b2fe7aa..b735900309e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md @@ -20,7 +20,7 @@ To fix this error, change the **`extern`** statements so that the linkages agree ## Example -The following sample generates C2732: +The following example generates C2732: ```cpp // C2732.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2733.md b/docs/error-messages/compiler-errors-2/compiler-error-c2733.md index b4fc45f5eb1..66e1c979cb3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2733.md @@ -18,7 +18,7 @@ This error may occur after an upgrade because of conformance changes in Visual S ## Example -The following sample generates C2733: +The following example generates C2733: ```cpp // C2733.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md index 2806335ae69..c729dec5b61 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md @@ -16,7 +16,7 @@ The identifier is declared **`const`** but not initialized or **`extern`**. ## Example -The following sample generates C2734: +The following example generates C2734: ```cpp // C2734.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md index fcaab3f1e25..a66fe52c51c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md @@ -16,7 +16,7 @@ The keyword is invalid in this context. ## Example -The following sample generates C2735: +The following example generates C2735: ```cpp // C2735.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md index db2c66c0d59..24d47588a16 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md @@ -16,7 +16,7 @@ The keyword is invalid in a cast. ## Example -The following sample generates C2736: +The following example generates C2736: ```cpp // C2736.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md index 14f992ad73a..a5a05f1c143 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md @@ -16,7 +16,7 @@ A function was declared incorrectly. ## Example -The following sample generates C2738: +The following example generates C2738: ```cpp // C2738.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md index e663e146ba3..1b88c544ed6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md @@ -16,7 +16,7 @@ An array dimension was not between 1 and 32. ## Example -The following sample generates C2739 and shows how to fix it: +The following example generates C2739 and shows how to fix it: ```cpp // C2739.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md index 1fd2bd3933d..61036f4a2f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md @@ -20,7 +20,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates C2743. +The following example generates C2743. ```cpp // C2743.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md index 5af41285bda..edcc7284690 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md @@ -16,7 +16,7 @@ Identifiers must be comprised of legal characters. ## Example -The following sample generates C2745: +The following example generates C2745: ```cpp // C2745.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md index 9c70e234df9..038fc558630 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md @@ -16,7 +16,7 @@ A managed or WinRT array was ill formed. For more information, see [array](../.. ## Example -The following sample generates C2748 and shows how to fix it: +The following example generates C2748 and shows how to fix it: ```cpp // C2748.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md index 332bc762dd7..90a890f605d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md @@ -18,7 +18,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates C2749: +The following example generates C2749: ```cpp // C2749.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md index 2a13bf39c5e..b88e10482a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md @@ -16,7 +16,7 @@ To create an instance of a CLR type, which causes the instance to be placed on t ## Example -The following sample generates C2750: +The following example generates C2750: ```cpp // C2750.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md index 85220ac36f7..4727177cc82 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md @@ -15,7 +15,7 @@ You cannot use a qualified name as a function parameter. ## Example -The following sample generates C2751: +The following example generates C2751: ```cpp // C2751.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md index 8a3e8e78d99..c21aa8ba3d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md @@ -16,7 +16,7 @@ An instantiation was ambiguous. ## Example -The following sample generates C2752: +The following example generates C2752: ```cpp // C2752.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md index ddefd79b0f6..2413b20028f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md @@ -16,7 +16,7 @@ If the template argument list matches the parameter list, the compiler treats it ## Example -The following sample generates C2753 and shows a way to fix it: +The following example generates C2753 and shows a way to fix it: ```cpp // C2753.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md index 0d1a2204add..291f6a75a31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md @@ -16,7 +16,7 @@ An attempt was made to partially specialize a template class that has a dependen ## Example -The following sample generates C2754: +The following example generates C2754: ```cpp // C2754.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md index 5c1455ab07b..eaf3cff3348 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md @@ -16,7 +16,7 @@ The non-type parameter needs to be a simple identifier, something the compiler c ## Example -The following sample generates C2755: +The following example generates C2755: ```cpp // C2755.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md index 6e21f7d0dc5..60d1ee73aea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md @@ -16,7 +16,7 @@ The template for a partial specialization may not contain a default argument. ## Example -The following sample generates C2756 and shows how to fix it: +The following example generates C2756 and shows how to fix it: ```cpp // C2756.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md index c1de5fa31bb..c56b011f502 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md @@ -16,7 +16,7 @@ A symbol used in the current compilation as a namespace identifier is already be ## Example -The following sample generates C2757: +The following example generates C2757: ```cpp // C2757a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md index 63106491a7d..3b5c2bed46f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md @@ -15,7 +15,7 @@ Compiler error C2758 is caused when the constructor does not initialize a member ## Example -The following sample generates C2758: +The following example generates C2758: ```cpp // C2758.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2760.md b/docs/error-messages/compiler-errors-2/compiler-error-c2760.md index 4a8aca52469..c2a60c82c6e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2760.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2760.md @@ -18,7 +18,7 @@ There are several ways to cause this error. Usually, it's caused by a token sequ ## Examples -In this sample, a casting operator is used with an invalid operator. +In this example, a casting operator is used with an invalid operator. ```cpp // C2760.cpp From 7a644236eed0ed035c20c2a1f814fe52d1cfa4a8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 6 Aug 2025 23:15:35 +0800 Subject: [PATCH 0648/1799] Update metadata for error references in range [C2731, C2760] --- .../error-messages/compiler-errors-2/compiler-error-c2731.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2732.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2733.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2734.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2735.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2736.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2738.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2739.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2743.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2745.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2748.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2749.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2750.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2751.md | 4 ++-- .../error-messages/compiler-errors-2/compiler-error-c2752.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2753.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2754.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2755.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2756.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2757.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2760.md | 3 +-- 21 files changed, 40 insertions(+), 60 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md index 2a666957af8..beb16353908 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2731" title: "Compiler Error C2731" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2731" +ms.date: 11/04/2016 f1_keywords: ["C2731"] helpviewer_keywords: ["C2731"] -ms.assetid: 9b563999-febd-4582-9147-f355083c091e --- # Compiler Error C2731 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md index b735900309e..6984e65b413 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2732" title: "Compiler Error C2732" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2732" +ms.date: 11/04/2016 f1_keywords: ["C2732"] helpviewer_keywords: ["C2732"] -ms.assetid: 01b7ad2c-93cf-456f-a4c0-c5f2fdc7c07c --- # Compiler Error C2732 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2733.md b/docs/error-messages/compiler-errors-2/compiler-error-c2733.md index 66e1c979cb3..ba6d27d4753 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2733.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2733" title: "Compiler Error C2733" +description: "Learn more about: Compiler Error C2733" ms.date: 12/02/2021 f1_keywords: ["C2733"] helpviewer_keywords: ["C2733"] -ms.assetid: 67f83561-c633-407c-a2ee-f9fd16e165bf --- # Compiler Error C2733 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md index c729dec5b61..c11247bd758 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2734" title: "Compiler Error C2734" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2734" +ms.date: 11/04/2016 f1_keywords: ["C2734"] helpviewer_keywords: ["C2734"] -ms.assetid: e53a77b7-825c-42d1-a655-90e1c93b833e --- # Compiler Error C2734 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md index a66fe52c51c..91def172aa9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2735" title: "Compiler Error C2735" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2735" +ms.date: 11/04/2016 f1_keywords: ["C2735"] helpviewer_keywords: ["C2735"] -ms.assetid: 6ce45600-7148-4bc0-8699-af0ef137571e --- # Compiler Error C2735 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md index 24d47588a16..a17c5de2ad8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2736" title: "Compiler Error C2736" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2736" +ms.date: 11/04/2016 f1_keywords: ["C2736"] helpviewer_keywords: ["C2736"] -ms.assetid: 95a6bc28-c0cb-49dc-87e6-e993dbbba881 --- # Compiler Error C2736 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md index a5a05f1c143..4eeec6e77a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2738" title: "Compiler Error C2738" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2738" +ms.date: 11/04/2016 f1_keywords: ["C2738"] helpviewer_keywords: ["C2738"] -ms.assetid: 896b4640-1ee0-4cd8-9910-de3efa30006a --- # Compiler Error C2738 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md index 1b88c544ed6..3125f5102bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2739" title: "Compiler Error C2739" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2739" +ms.date: 11/04/2016 f1_keywords: ["C2739"] helpviewer_keywords: ["C2739"] -ms.assetid: 5b63e435-7631-43d7-805e-f2adefb7e517 --- # Compiler Error C2739 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md index 61036f4a2f7..0f2118ff291 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2743" title: "Compiler Error C2743" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2743" +ms.date: 11/04/2016 f1_keywords: ["C2743"] helpviewer_keywords: ["C2743"] -ms.assetid: 644cd444-21d2-471d-a176-f5f52c5a0b73 --- # Compiler Error C2743 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md index edcc7284690..4fbbf13bcce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2745" title: "Compiler Error C2745" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2745" +ms.date: 11/04/2016 f1_keywords: ["C2745"] helpviewer_keywords: ["C2745"] -ms.assetid: a1c45f13-7667-4678-aa16-265304a449a1 --- # Compiler Error C2745 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md index 038fc558630..c7a99b67943 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2748" title: "Compiler Error C2748" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2748" +ms.date: 11/04/2016 f1_keywords: ["C2748"] helpviewer_keywords: ["C2748"] -ms.assetid: b63ac78b-a200-499c-afea-15af1a1e819e --- # Compiler Error C2748 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md index 90a890f605d..c2bc309d835 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2749" title: "Compiler Error C2749" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2749" +ms.date: 11/04/2016 f1_keywords: ["C2749"] helpviewer_keywords: ["C2749"] -ms.assetid: a81aef36-cdca-4d78-89d5-b72eff2500b2 --- # Compiler Error C2749 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md index b88e10482a8..55899400da8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2750" title: "Compiler Error C2750" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2750" +ms.date: 11/04/2016 f1_keywords: ["C2750"] helpviewer_keywords: ["C2750"] -ms.assetid: 30450034-feb5-448c-9655-b8c5f3639695 --- # Compiler Error C2750 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md index 4727177cc82..ef7c77075c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2751" title: "Compiler Error C2751" -ms.date: "03/11/2024" +description: "Learn more about: Compiler Error C2751" +ms.date: 03/11/2024 f1_keywords: ["C2751"] helpviewer_keywords: ["C2751"] --- diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md index c21aa8ba3d6..5c0d2337ce2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2752" title: "Compiler Error C2752" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2752" +ms.date: 11/04/2016 f1_keywords: ["C2752"] helpviewer_keywords: ["C2752"] -ms.assetid: ae42b3ec-84a9-4e9d-8d59-3d208132d0b2 --- # Compiler Error C2752 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md index 2413b20028f..9f68e282613 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2753" title: "Compiler Error C2753" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2753" +ms.date: 11/04/2016 f1_keywords: ["C2753"] helpviewer_keywords: ["C2753"] -ms.assetid: 92bfeeac-524a-4a8e-9a4f-fb8269055826 --- # Compiler Error C2753 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md index 291f6a75a31..8b391baaa37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2754" title: "Compiler Error C2754" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2754" +ms.date: 11/04/2016 f1_keywords: ["C2754"] helpviewer_keywords: ["C2754"] -ms.assetid: 1cab66c5-da9d-4b81-b7fb-9cdc48ff1ccc --- # Compiler Error C2754 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md index eaf3cff3348..adabdd70a83 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2755" title: "Compiler Error C2755" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2755" +ms.date: 11/04/2016 f1_keywords: ["C2755"] helpviewer_keywords: ["C2755"] -ms.assetid: 8ee4eeb6-4757-4efe-9100-38ff4a96f1de --- # Compiler Error C2755 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md index 60d1ee73aea..5f7089c2367 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2756" title: "Compiler Error C2756" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2756" +ms.date: 11/04/2016 f1_keywords: ["C2756"] helpviewer_keywords: ["C2756"] -ms.assetid: 42eb988d-4043-4dee-8fd4-596949f69a55 --- # Compiler Error C2756 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md index c56b011f502..a759aa5196f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2757" title: "Compiler Error C2757" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2757" +ms.date: 11/04/2016 f1_keywords: ["C2757"] helpviewer_keywords: ["C2757"] -ms.assetid: 421f102f-8a32-4d47-a109-811ddf2c909d --- # Compiler Error C2757 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2760.md b/docs/error-messages/compiler-errors-2/compiler-error-c2760.md index c2a60c82c6e..619d63d8c42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2760.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2760.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2760" title: "Compiler Error C2760" +description: "Learn more about: Compiler Error C2760" ms.date: 08/12/2021 f1_keywords: ["C2760"] helpviewer_keywords: ["C2760"] -ms.assetid: 585757fd-d519-43f3-94e5-50316ac8b90b --- # Compiler Error C2760 From 9bd2af9151433a3394715456dd263ae52f731c81 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 7 Aug 2025 00:04:16 +0800 Subject: [PATCH 0649/1799] Resolve invalid type `Int` in syntax references --- docs/cpp/com-ptr-t-relational-operators.md | 4 ++-- docs/mfc/reference/cmfcribboncombobox-class.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/cpp/com-ptr-t-relational-operators.md b/docs/cpp/com-ptr-t-relational-operators.md index 37ebee59797..24b6a8c9270 100644 --- a/docs/cpp/com-ptr-t-relational-operators.md +++ b/docs/cpp/com-ptr-t-relational-operators.md @@ -33,7 +33,7 @@ bool operator==( const _com_ptr_t& p ) throw(); template<> bool operator==( _com_ptr_t& p ) throw(); -bool operator==( Int null ); +bool operator==( int null ); template bool operator!=( const _com_ptr_t<_OtherIID>& p ); @@ -44,7 +44,7 @@ bool operator!=( _com_ptr_t<_OtherIID>& p ); template bool operator!=( _InterfaceType* p ); -bool operator!=( Int null ); +bool operator!=( int null ); template bool operator<( const _com_ptr_t<_OtherIID>& p ); diff --git a/docs/mfc/reference/cmfcribboncombobox-class.md b/docs/mfc/reference/cmfcribboncombobox-class.md index 91d6fe19fa7..6ec436875fd 100644 --- a/docs/mfc/reference/cmfcribboncombobox-class.md +++ b/docs/mfc/reference/cmfcribboncombobox-class.md @@ -102,9 +102,9 @@ public: CMFCRibbonComboBox( UINT nID, BOOL bHasEditBox=TRUE, - Int nWidth=-1, + int nWidth=-1, LPCTSTR lpszLabel=NULL, - Int nImage=-1); + int nImage=-1); protected: CMFCRibbonComboBox(); From 849b46889ff08ee285654df4b55a7de65cd0ab77 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 7 Aug 2025 00:04:45 +0800 Subject: [PATCH 0650/1799] Update metadata in 2 topics --- docs/cpp/com-ptr-t-relational-operators.md | 5 ++--- docs/mfc/reference/cmfcribboncombobox-class.md | 5 ++--- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/cpp/com-ptr-t-relational-operators.md b/docs/cpp/com-ptr-t-relational-operators.md index 24b6a8c9270..7101967bd2a 100644 --- a/docs/cpp/com-ptr-t-relational-operators.md +++ b/docs/cpp/com-ptr-t-relational-operators.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: _com_ptr_t Relational Operators" title: "_com_ptr_t Relational Operators" -ms.date: "11/04/2016" +description: "Learn more about: _com_ptr_t Relational Operators" +ms.date: 11/04/2016 f1_keywords: ["_com_ptr_t::operator>", "_com_ptr_t::operator>=", "_com_ptr_t::operator<=", "_com_ptr_t::operator==", "_com_ptr_t::operator!=", "_com_ptr_t::operator<"] helpviewer_keywords: [">= operator [C++], comparing specific objects", "!= operator", "operator > [C++], pointers", "operator>= [C++], pointers", "operator < [C++], pointers", "operator!= [C++], relational operators", "< operator [C++], comparing specific objects", "operator== [C++], pointers", "operator == [C++], pointers", "<= operator [C++], with specific objects", "relational operators [C++], _com_ptr_t class", "operator >= [C++], pointers", "operator != [C++], relational operators", "operator <= [C++], pointers", "> operator [C++], comparing specific objects", "operator<= [C++], pointers", "operator< [C++], pointers", "== operator [C++], with specific Visual C++ objects"] -ms.assetid: 5ae4028c-33ee-485d-bbda-88d2604d6d4b --- # _com_ptr_t Relational Operators diff --git a/docs/mfc/reference/cmfcribboncombobox-class.md b/docs/mfc/reference/cmfcribboncombobox-class.md index 6ec436875fd..8c68550f07e 100644 --- a/docs/mfc/reference/cmfcribboncombobox-class.md +++ b/docs/mfc/reference/cmfcribboncombobox-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCRibbonComboBox Class" title: "CMFCRibbonComboBox Class" -ms.date: "11/04/2016" +description: "Learn more about: CMFCRibbonComboBox Class" +ms.date: 11/04/2016 f1_keywords: ["CMFCRibbonComboBox", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::CMFCRibbonComboBox", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::AddItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::DeleteItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::EnableDropDownListResize", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::FindItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetCount", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetCurSel", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetDropDownHeight", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetIntermediateSize", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetItemData", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::HasEditBox", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::IsResizeDropDownList", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::OnSelectItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::RemoveAllItems", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::SelectItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::SetDropDownHeight"] helpviewer_keywords: ["CMFCRibbonComboBox [MFC], CMFCRibbonComboBox", "CMFCRibbonComboBox [MFC], AddItem", "CMFCRibbonComboBox [MFC], DeleteItem", "CMFCRibbonComboBox [MFC], EnableDropDownListResize", "CMFCRibbonComboBox [MFC], FindItem", "CMFCRibbonComboBox [MFC], GetCount", "CMFCRibbonComboBox [MFC], GetCurSel", "CMFCRibbonComboBox [MFC], GetDropDownHeight", "CMFCRibbonComboBox [MFC], GetIntermediateSize", "CMFCRibbonComboBox [MFC], GetItem", "CMFCRibbonComboBox [MFC], GetItemData", "CMFCRibbonComboBox [MFC], HasEditBox", "CMFCRibbonComboBox [MFC], IsResizeDropDownList", "CMFCRibbonComboBox [MFC], OnSelectItem", "CMFCRibbonComboBox [MFC], RemoveAllItems", "CMFCRibbonComboBox [MFC], SelectItem", "CMFCRibbonComboBox [MFC], SetDropDownHeight"] -ms.assetid: 9b29a6a4-cf17-4152-9b13-0bf90784b30d --- # CMFCRibbonComboBox Class From 72e62e04c3c5638ee7ed43abd1a6d0f3e43f8724 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 7 Aug 2025 22:52:52 +0800 Subject: [PATCH 0651/1799] Fix erroneous `__Pragma` in link texts --- docs/c-language/c-pragmas.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3295.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4789.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/c-language/c-pragmas.md b/docs/c-language/c-pragmas.md index e98dccbd721..c96cad6b4cf 100644 --- a/docs/c-language/c-pragmas.md +++ b/docs/c-language/c-pragmas.md @@ -59,7 +59,7 @@ A *pragma* instructs the compiler to perform a particular action at compile time :::column-end::: :::row-end::: -See [Pragma Directives and the `__Pragma` Keyword](../preprocessor/pragma-directives-and-the-pragma-keyword.md) for a description of the Microsoft C compiler pragmas. +See [Pragma directives and the `__pragma` and `_Pragma` keywords](../preprocessor/pragma-directives-and-the-pragma-keyword.md) for a description of the Microsoft C compiler pragmas. **END Microsoft Specific** diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3295.md b/docs/error-messages/compiler-errors-2/compiler-error-c3295.md index 422e2296b2b..96b7a98762e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3295.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3295.md @@ -10,7 +10,7 @@ ms.assetid: 83f0aa4d-0e0a-4905-9f66-fcf9991fc07a '#pragma pragma' can only be used at global or namespace scope -Some pragmas cannot be used in a function. See [Pragma Directives and the __Pragma Keyword](../../preprocessor/pragma-directives-and-the-pragma-keyword.md) for more information. +Some pragmas cannot be used in a function. See [Pragma directives and the `__pragma` and `_Pragma` keywords](../../preprocessor/pragma-directives-and-the-pragma-keyword.md) for more information. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md index 696cc4eacdf..8ebdf24fb9f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md @@ -32,7 +32,7 @@ Visual C++ might generate this warning for a code path that never executes. You #pragma warning( pop ) ``` -This idiom keeps Visual C++ from generating the warning for that specific block of code. The `#pragma warning(push)` preserves the existing state before `#pragma warning(disable: 4789)` changes it. The `#pragma warning(pop)` restores the pushed state, and removes the effects of the `#pragma warning(disable:4789)`. For more information about the C++ preprocessor directive `#pragma`, see [`warning`](../../preprocessor/warning.md) and [Pragma Directives and the `__Pragma` Keyword](../../preprocessor/pragma-directives-and-the-pragma-keyword.md). +This idiom keeps Visual C++ from generating the warning for that specific block of code. The `#pragma warning(push)` preserves the existing state before `#pragma warning(disable: 4789)` changes it. The `#pragma warning(pop)` restores the pushed state, and removes the effects of the `#pragma warning(disable:4789)`. For more information about the C++ preprocessor directive `#pragma`, see [`warning`](../../preprocessor/warning.md) and [Pragma directives and the `__pragma` and `_Pragma` keywords](../../preprocessor/pragma-directives-and-the-pragma-keyword.md). The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error. From 57b51ca71b472e1cbfecc8bd09f0cef02ae20dbd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 7 Aug 2025 22:53:55 +0800 Subject: [PATCH 0652/1799] Update metadata in 2 topics --- docs/c-language/c-pragmas.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c3295.md | 5 ++--- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/c-language/c-pragmas.md b/docs/c-language/c-pragmas.md index c96cad6b4cf..bb5cb70aee4 100644 --- a/docs/c-language/c-pragmas.md +++ b/docs/c-language/c-pragmas.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: C Pragmas" title: "C Pragmas" +description: "Learn more about: C Pragmas" ms.date: 07/26/2020 helpviewer_keywords: ["pragmas, C/C++"] -ms.assetid: 3d6d36b4-d565-4632-a4cd-e39aeaded5ad --- # C Pragmas diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3295.md b/docs/error-messages/compiler-errors-2/compiler-error-c3295.md index 96b7a98762e..262bb7979b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3295.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3295.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3295" title: "Compiler Error C3295" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3295" +ms.date: 11/04/2016 f1_keywords: ["C3295"] helpviewer_keywords: ["C3295"] -ms.assetid: 83f0aa4d-0e0a-4905-9f66-fcf9991fc07a --- # Compiler Error C3295 From ba9902739eeaaa20c3ecb4f709c029356ccf5731 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 7 Aug 2025 23:13:20 +0800 Subject: [PATCH 0653/1799] Add blockquotes for error messages in range [C2761, C2790] --- docs/error-messages/compiler-errors-2/compiler-error-c2761.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2762.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2764.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2765.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2766.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2767.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2770.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2771.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2773.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2774.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2775.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2776.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2777.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2778.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2779.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2780.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2781.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2782.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2783.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2784.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2785.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2786.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2787.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2788.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2790.md | 2 +- 25 files changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md index 1e8e60e233f..b96797f41f3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md @@ -8,7 +8,7 @@ ms.assetid: 38c79a05-b56d-485b-820f-95e8c0cb926f --- # Compiler Error C2761 -'function' : member function redeclaration not allowed +> 'function' : member function redeclaration not allowed You cannot redeclare a member function. You can define it, but not redeclare it. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md index 6b64d52ba52..83aa82101f4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md @@ -8,7 +8,7 @@ ms.assetid: 8b81a801-fd48-40a1-8bee-0748795b12e4 --- # Compiler Error C2762 -'class' : invalid expression as a template argument for 'argument' +> 'class' : invalid expression as a template argument for 'argument' When using [/Za](../../build/reference/za-ze-disable-language-extensions.md), the compiler will not convert an integral to a pointer. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md index cc1c8e94940..da4a5f0259b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md @@ -8,7 +8,7 @@ ms.assetid: 3754f5af-e094-4425-be20-d0c9a9b5baec --- # Compiler Error C2764 -'param' : template parameter not used or deducible in partial specialization 'specialization' +> 'param' : template parameter not used or deducible in partial specialization 'specialization' A template parameter is not used in a partial specialization. This makes the partial specialization unusable because the template parameter cannot be deduced. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md index 08850d76472..5a653696ce2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2765"] --- # Compiler Error C2765 -'function' : an explicit specialization of a function template cannot have any default arguments +> 'function' : an explicit specialization of a function template cannot have any default arguments Default arguments are not allowed on an explicit specialization of a function template. For more information, see [Explicit Specialization of Function Templates](../../cpp/explicit-specialization-of-function-templates.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md index 765ffaba7d7..4a5d32492a7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md @@ -8,7 +8,7 @@ ms.assetid: 8032f4ca-6827-4f04-9c61-c44643c85cc4 --- # Compiler Error C2766 -explicit specialization; 'specialization' has already been defined +> explicit specialization; 'specialization' has already been defined Duplicate explicit specializations are not allowed. For more information, see [Explicit Specialization of Function Templates](../../cpp/explicit-specialization-of-function-templates.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md index 0e37e783405..617f7bc801c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md @@ -8,7 +8,7 @@ ms.assetid: e8f84178-a160-4d71-a236-07e4fcc11e96 --- # Compiler Error C2767 -managed or WinRTarray dimension mismatch : expected N argument(s) - M provided +> managed or WinRTarray dimension mismatch : expected N argument(s) - M provided A managed or WinRT array declaration was ill formed. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md index 93734f5356f..791dca1d754 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md @@ -8,7 +8,7 @@ ms.assetid: 100001b5-80b0-4971-8ff6-9023f443c926 --- # Compiler Error C2770 -invalid explicit template_or_generic argument(s) for 'template' +> invalid explicit template_or_generic argument(s) for 'template' Function template candidates with explicit template or generic arguments resulted in disallowed function types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2771.md b/docs/error-messages/compiler-errors-2/compiler-error-c2771.md index f6d00ce5b5e..78a985a4c7d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2771.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2771.md @@ -8,6 +8,6 @@ ms.assetid: b649cc9f-7cbc-4b42-a5e8-51dad5c55e4b --- # Compiler Error C2771 -\#import only permitted at global or namespace scope +> #import only permitted at global or namespace scope The `#import` directive is not allowed in, for example, a function or structure. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2773.md b/docs/error-messages/compiler-errors-2/compiler-error-c2773.md index a5269df8cb4..b6bf1059362 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2773.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2773.md @@ -8,6 +8,6 @@ ms.assetid: 8d564b26-1623-4d92-aabc-dff33f7b1145 --- # Compiler Error C2773 -\#import and #using available only in C++ compiler +> #import and #using available only in C++ compiler The C compiler does not recognize the `#import` preprocessor directive. Compile the source as C++. Use [/TP](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) if necessary. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md index 83bb2f1f579..105c1bad50d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md @@ -8,7 +8,7 @@ ms.assetid: 10f428c6-7f49-489a-92ba-6ef978b7caaf --- # Compiler Error C2774 -'identifier' : no 'put' method is associated with this property +> 'identifier' : no 'put' method is associated with this property A data member declared with [property](../../cpp/property-cpp.md) has no `put` function, but an expression tries to set its value. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md index 0997247f838..efd84ad2766 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md @@ -8,7 +8,7 @@ ms.assetid: 9c488508-ade0-48f1-b94f-d538d15f807a --- # Compiler Error C2775 -'identifier' : no 'get' method is associated with this property +> 'identifier' : no 'get' method is associated with this property A data member declared with the [property](../../cpp/property-cpp.md) extended attribute does not have a `get` function specified, but an expression tries to retrieve its value. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md index 94145080436..259e19ea590 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md @@ -8,7 +8,7 @@ ms.assetid: 9d80addc-62c7-40fc-a2cc-60303abb87df --- # Compiler Error C2776 -only one 'get' method can be specified per property +> only one 'get' method can be specified per property You can only specify one `get` function in the [property](../../cpp/property-cpp.md) extended attribute. This error occurs when multiple `get` functions are specified. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md index cff4aef538b..886e7579f54 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md @@ -8,7 +8,7 @@ ms.assetid: 5fe158c0-2a65-488a-aca2-61d4a8b32d43 --- # Compiler Error C2777 -only one 'put' method can be specified per property +> only one 'put' method can be specified per property A [property](../../cpp/property-cpp.md) declspec modifier had more than one `put` property. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md index febe7f24c82..7f6739f3589 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md @@ -8,7 +8,7 @@ ms.assetid: b24cb732-2914-42cc-8928-e2d87b393428 --- # Compiler Error C2778 -improperly formed GUID in __declspec(uuid()) +> improperly formed GUID in __declspec(uuid()) An incorrect GUID is supplied to the [uuid](../../cpp/uuid-cpp.md) extended attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md index a5cceba3ae5..881ec6e4584 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md @@ -8,7 +8,7 @@ ms.assetid: 4a00e492-855a-41f3-8a18-5f60ee20c2f2 --- # Compiler Error C2779 -'declaration' : property methods can only be associated with non-static data members +> 'declaration' : property methods can only be associated with non-static data members The **`property`** extended attribute is incorrectly applied to a static data member. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md index e1d639ffdf2..8d8ee7ae9ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md @@ -8,7 +8,7 @@ ms.assetid: 423793d8-a3b2-4f35-85f8-ae1d043e2b69 --- # Compiler Error C2780 -'declaration' : expects N arguments - M provided +> 'declaration' : expects N arguments - M provided A function template has too few or too many arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md index e7ac58ef5a7..2d0e2b2b8e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md @@ -8,7 +8,7 @@ ms.assetid: f29b9963-f55b-427c-8db6-50f37713df5a --- # Compiler Error C2781 -'declaration' : expects at least value1 argument - value2 provided +> 'declaration' : expects at least value1 argument - value2 provided A function template with a variable parameter list has too few arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md index 0b253401473..a9cb8481437 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md @@ -8,7 +8,7 @@ ms.assetid: 8b685422-294d-4f64-9f3d-c14eaf03a93d --- # Compiler Error C2782 -'declaration' : template parameter 'identifier' is ambiguous +> 'declaration' : template parameter 'identifier' is ambiguous The compiler cannot determine the type of a template argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md index c44ff86dbb7..764f2d72f7f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md @@ -8,7 +8,7 @@ ms.assetid: 1ce94a11-bb8b-4be3-a222-f1f105da74b3 --- # Compiler Error C2783 -'declaration' : could not deduce template argument for 'identifier' +> 'declaration' : could not deduce template argument for 'identifier' The compiler cannot determine a template argument. Default arguments cannot be used to deduce a template argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md index a8b82581e80..9c1052a9bd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md @@ -8,7 +8,7 @@ ms.assetid: 3d761fe2-881c-48bd-afae-e2e714e20473 --- # Compiler Error C2784 -'declaration' : could not deduce template argument for 'type' from 'type' +> 'declaration' : could not deduce template argument for 'type' from 'type' The compiler cannot determine a template argument from the supplied function arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md index db69f33c9fe..f93d6751987 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md @@ -8,7 +8,7 @@ ms.assetid: d8d13360-0d00-4815-8475-b49c7f0dc0f3 --- # Compiler Error C2785 -'declaration1' and 'declaration2' have different return types +> 'declaration1' and 'declaration2' have different return types The return type of function template specialization differs from the return type of the primary function template. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md index f8befff1ee9..55e73a6493a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md @@ -8,7 +8,7 @@ ms.assetid: 6676d8c0-86dd-4a39-bdda-b75a35f4d137 --- # Compiler Error C2786 -'type' : invalid operand for __uuidof +> 'type' : invalid operand for __uuidof The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. Possible causes: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md index f6e3c1e6f5b..1936e4201b1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md @@ -8,7 +8,7 @@ ms.assetid: 34cb57e6-cafe-4ce7-bcc6-53d194629bd0 --- # Compiler Error C2787 -'identifier' : no GUID has been associated with this object +> 'identifier' : no GUID has been associated with this object The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. This error occurs when the argument is a user-defined type with no GUID. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md index 688823ae549..9919fec7ce4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md @@ -8,7 +8,7 @@ ms.assetid: 8688fc5c-e652-43b4-b407-9c488c76f2db --- # Compiler Error C2788 -'identifier' : more than one GUID associated with this object +> 'identifier' : more than one GUID associated with this object The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. This error occurs when the argument is an object with multiple GUIDs. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md index 7fa8d57c9bf..bbf6547442e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md @@ -8,7 +8,7 @@ ms.assetid: 38d4fce1-ba00-413d-8bc1-e8aa43d7bc1f --- # Compiler Error C2790 -'super' : this keyword can only be used within the body of class member function +> 'super' : this keyword can only be used within the body of class member function This error message appears if the user ever tries to uses the keyword [super](../../cpp/super.md) outside of the context of a member function. From 8cc9edd3907ba46352e6a118366293dd33996000 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 7 Aug 2025 23:19:15 +0800 Subject: [PATCH 0654/1799] Add "Remarks" and "Example" headings for error references in range [C2761, C2790] --- docs/error-messages/compiler-errors-2/compiler-error-c2761.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2762.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2764.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2765.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2766.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2767.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2770.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2771.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2773.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2774.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2775.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2776.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2777.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2778.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2779.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2780.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2781.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2782.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2783.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2784.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2785.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2786.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2787.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2788.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2790.md | 4 ++++ 25 files changed, 90 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md index b96797f41f3..4109c387e06 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md @@ -10,6 +10,8 @@ ms.assetid: 38c79a05-b56d-485b-820f-95e8c0cb926f > 'function' : member function redeclaration not allowed +## Remarks + You cannot redeclare a member function. You can define it, but not redeclare it. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md index 83aa82101f4..51e06ab18c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md @@ -10,8 +10,12 @@ ms.assetid: 8b81a801-fd48-40a1-8bee-0748795b12e4 > 'class' : invalid expression as a template argument for 'argument' +## Remarks + When using [/Za](../../build/reference/za-ze-disable-language-extensions.md), the compiler will not convert an integral to a pointer. +## Example + The following sample generates C2762: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md index da4a5f0259b..1bc89ef44ed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md @@ -10,6 +10,8 @@ ms.assetid: 3754f5af-e094-4425-be20-d0c9a9b5baec > 'param' : template parameter not used or deducible in partial specialization 'specialization' +## Remarks + A template parameter is not used in a partial specialization. This makes the partial specialization unusable because the template parameter cannot be deduced. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md index 5a653696ce2..be918132f78 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2765"] > 'function' : an explicit specialization of a function template cannot have any default arguments +## Remarks + Default arguments are not allowed on an explicit specialization of a function template. For more information, see [Explicit Specialization of Function Templates](../../cpp/explicit-specialization-of-function-templates.md). +## Example + The following sample generates C2765: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md index 4a5d32492a7..ccbdafdd122 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md @@ -10,8 +10,12 @@ ms.assetid: 8032f4ca-6827-4f04-9c61-c44643c85cc4 > explicit specialization; 'specialization' has already been defined +## Remarks + Duplicate explicit specializations are not allowed. For more information, see [Explicit Specialization of Function Templates](../../cpp/explicit-specialization-of-function-templates.md). +## Example + The following sample generates C2766: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md index 617f7bc801c..a94755dd978 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md @@ -10,8 +10,12 @@ ms.assetid: e8f84178-a160-4d71-a236-07e4fcc11e96 > managed or WinRTarray dimension mismatch : expected N argument(s) - M provided +## Remarks + A managed or WinRT array declaration was ill formed. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). +## Example + The following sample generates C2767 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md index 791dca1d754..892cd7a8554 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md @@ -10,8 +10,12 @@ ms.assetid: 100001b5-80b0-4971-8ff6-9023f443c926 > invalid explicit template_or_generic argument(s) for 'template' +## Remarks + Function template candidates with explicit template or generic arguments resulted in disallowed function types. +## Example + The following sample generates C2770: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2771.md b/docs/error-messages/compiler-errors-2/compiler-error-c2771.md index 78a985a4c7d..d31cf00eec5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2771.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2771.md @@ -10,4 +10,6 @@ ms.assetid: b649cc9f-7cbc-4b42-a5e8-51dad5c55e4b > #import only permitted at global or namespace scope +## Remarks + The `#import` directive is not allowed in, for example, a function or structure. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2773.md b/docs/error-messages/compiler-errors-2/compiler-error-c2773.md index b6bf1059362..138dd245bb1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2773.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2773.md @@ -10,4 +10,6 @@ ms.assetid: 8d564b26-1623-4d92-aabc-dff33f7b1145 > #import and #using available only in C++ compiler +## Remarks + The C compiler does not recognize the `#import` preprocessor directive. Compile the source as C++. Use [/TP](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) if necessary. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md index 105c1bad50d..2c53ed6f7de 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md @@ -10,8 +10,12 @@ ms.assetid: 10f428c6-7f49-489a-92ba-6ef978b7caaf > 'identifier' : no 'put' method is associated with this property +## Remarks + A data member declared with [property](../../cpp/property-cpp.md) has no `put` function, but an expression tries to set its value. +## Example + The following sample generates C2774: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md index efd84ad2766..5d09b2da006 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md @@ -10,8 +10,12 @@ ms.assetid: 9c488508-ade0-48f1-b94f-d538d15f807a > 'identifier' : no 'get' method is associated with this property +## Remarks + A data member declared with the [property](../../cpp/property-cpp.md) extended attribute does not have a `get` function specified, but an expression tries to retrieve its value. +## Example + The following sample generates C2775: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md index 259e19ea590..c7304738f2b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md @@ -10,8 +10,12 @@ ms.assetid: 9d80addc-62c7-40fc-a2cc-60303abb87df > only one 'get' method can be specified per property +## Remarks + You can only specify one `get` function in the [property](../../cpp/property-cpp.md) extended attribute. This error occurs when multiple `get` functions are specified. +## Example + The following sample generates C2776: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md index 886e7579f54..89a896e7b44 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md @@ -10,8 +10,12 @@ ms.assetid: 5fe158c0-2a65-488a-aca2-61d4a8b32d43 > only one 'put' method can be specified per property +## Remarks + A [property](../../cpp/property-cpp.md) declspec modifier had more than one `put` property. +## Example + The following sample generates C2777: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md index 7f6739f3589..eb021823c2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md @@ -10,8 +10,12 @@ ms.assetid: b24cb732-2914-42cc-8928-e2d87b393428 > improperly formed GUID in __declspec(uuid()) +## Remarks + An incorrect GUID is supplied to the [uuid](../../cpp/uuid-cpp.md) extended attribute. +## Example + The GUID must be a string of hexadecimal numbers with the following format: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md index 881ec6e4584..9fa794e8ff8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md @@ -10,8 +10,12 @@ ms.assetid: 4a00e492-855a-41f3-8a18-5f60ee20c2f2 > 'declaration' : property methods can only be associated with non-static data members +## Remarks + The **`property`** extended attribute is incorrectly applied to a static data member. +## Example + The following sample generates C2779: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md index 8d8ee7ae9ef..8328124370f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md @@ -10,8 +10,12 @@ ms.assetid: 423793d8-a3b2-4f35-85f8-ae1d043e2b69 > 'declaration' : expects N arguments - M provided +## Remarks + A function template has too few or too many arguments. +## Example + The following sample generates C2780 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md index 2d0e2b2b8e1..43c3b8d29f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md @@ -10,8 +10,12 @@ ms.assetid: f29b9963-f55b-427c-8db6-50f37713df5a > 'declaration' : expects at least value1 argument - value2 provided +## Remarks + A function template with a variable parameter list has too few arguments. +## Example + The following sample generates C2781: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md index a9cb8481437..e2e4820ef1e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md @@ -10,8 +10,12 @@ ms.assetid: 8b685422-294d-4f64-9f3d-c14eaf03a93d > 'declaration' : template parameter 'identifier' is ambiguous +## Remarks + The compiler cannot determine the type of a template argument. +## Examples + The following sample generates C2782: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md index 764f2d72f7f..38aafbb8c4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md @@ -10,8 +10,12 @@ ms.assetid: 1ce94a11-bb8b-4be3-a222-f1f105da74b3 > 'declaration' : could not deduce template argument for 'identifier' +## Remarks + The compiler cannot determine a template argument. Default arguments cannot be used to deduce a template argument. +## Examples + The following sample generates C2783: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md index 9c1052a9bd4..9805fb7257b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md @@ -10,8 +10,12 @@ ms.assetid: 3d761fe2-881c-48bd-afae-e2e714e20473 > 'declaration' : could not deduce template argument for 'type' from 'type' +## Remarks + The compiler cannot determine a template argument from the supplied function arguments. +## Example + The following sample generates C2784 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md index f93d6751987..feac08b5fea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md @@ -10,6 +10,8 @@ ms.assetid: d8d13360-0d00-4815-8475-b49c7f0dc0f3 > 'declaration1' and 'declaration2' have different return types +## Remarks + The return type of function template specialization differs from the return type of the primary function template. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md index 55e73a6493a..a10cb7d413c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md @@ -10,12 +10,16 @@ ms.assetid: 6676d8c0-86dd-4a39-bdda-b75a35f4d137 > 'type' : invalid operand for __uuidof +## Remarks + The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. Possible causes: 1. The argument is not a user-defined type. 1. **`__uuidof`** cannot extract the GUID from the argument. +## Example + The following sample generates C2786: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md index 1936e4201b1..bbc7a22de7d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md @@ -10,8 +10,12 @@ ms.assetid: 34cb57e6-cafe-4ce7-bcc6-53d194629bd0 > 'identifier' : no GUID has been associated with this object +## Remarks + The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. This error occurs when the argument is a user-defined type with no GUID. +## Example + The following sample generates C2787: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md index 9919fec7ce4..c13088fb149 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md @@ -10,8 +10,12 @@ ms.assetid: 8688fc5c-e652-43b4-b407-9c488c76f2db > 'identifier' : more than one GUID associated with this object +## Remarks + The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. This error occurs when the argument is an object with multiple GUIDs. +## Example + The following sample generates C2788: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md index bbf6547442e..5b9a680a0b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md @@ -10,8 +10,12 @@ ms.assetid: 38d4fce1-ba00-413d-8bc1-e8aa43d7bc1f > 'super' : this keyword can only be used within the body of class member function +## Remarks + This error message appears if the user ever tries to uses the keyword [super](../../cpp/super.md) outside of the context of a member function. +## Example + The following sample generates C2790: ```cpp From 9099637fc15f53020cb2743cbf15c938706f3114 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 7 Aug 2025 23:20:51 +0800 Subject: [PATCH 0655/1799] Replace term "sample" with "example" for error references in range [C2761, C2790] --- docs/error-messages/compiler-errors-2/compiler-error-c2761.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2762.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2764.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2765.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2766.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2767.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2768.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2770.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2774.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2775.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2776.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2777.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2778.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2779.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2780.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2781.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2782.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2783.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2784.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2785.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2786.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2787.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2788.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2790.md | 2 +- 24 files changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md index 4109c387e06..63ae44b1daf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md @@ -16,7 +16,7 @@ You cannot redeclare a member function. You can define it, but not redeclare it. ## Examples -The following sample generates C2761. +The following example generates C2761. ```cpp // C2761.cpp @@ -29,7 +29,7 @@ void a::a; // C2761 void a::test; // C2761 ``` -Nonstatic members of a class or structure cannot be defined. The following sample generates C2761. +Nonstatic members of a class or structure cannot be defined. The following example generates C2761. ```cpp // C2761_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md index 51e06ab18c8..7d5e0ae06c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md @@ -16,7 +16,7 @@ When using [/Za](../../build/reference/za-ze-disable-language-extensions.md), th ## Example -The following sample generates C2762: +The following example generates C2762: ```cpp // C2762.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md index 1bc89ef44ed..3feffc12491 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md @@ -16,7 +16,7 @@ A template parameter is not used in a partial specialization. This makes the par ## Example -The following sample generates C2764: +The following example generates C2764: ```cpp // C2764.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md index be918132f78..46067a15fc3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md @@ -15,7 +15,7 @@ Default arguments are not allowed on an explicit specialization of a function te ## Example -The following sample generates C2765: +The following example generates C2765: ```cpp // C2765.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md index ccbdafdd122..5b30a1aa0a1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md @@ -16,7 +16,7 @@ Duplicate explicit specializations are not allowed. For more information, see [E ## Example -The following sample generates C2766: +The following example generates C2766: ```cpp // C2766.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md index a94755dd978..44823754892 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md @@ -16,7 +16,7 @@ A managed or WinRT array declaration was ill formed. For more information, see [ ## Example -The following sample generates C2767 and shows how to fix it: +The following example generates C2767 and shows how to fix it: ```cpp // C2767.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2768.md b/docs/error-messages/compiler-errors-2/compiler-error-c2768.md index c8ae01c2c0c..64bed60ba95 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2768.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2768.md @@ -18,7 +18,7 @@ This error was introduced in Visual Studio .NET 2003, as part of the compiler co ## Example -The following sample generates C2768: +The following example generates C2768: ```cpp // C2768.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md index 892cd7a8554..f4124ec3b2b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md @@ -16,7 +16,7 @@ Function template candidates with explicit template or generic arguments resulte ## Example -The following sample generates C2770: +The following example generates C2770: ```cpp // C2770.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md index 2c53ed6f7de..e68947b1511 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md @@ -16,7 +16,7 @@ A data member declared with [property](../../cpp/property-cpp.md) has no `put` f ## Example -The following sample generates C2774: +The following example generates C2774: ```cpp // C2774.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md index 5d09b2da006..86834667cdd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md @@ -16,7 +16,7 @@ A data member declared with the [property](../../cpp/property-cpp.md) extended a ## Example -The following sample generates C2775: +The following example generates C2775: ```cpp // C2775.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md index c7304738f2b..5e18b92d1f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md @@ -16,7 +16,7 @@ You can only specify one `get` function in the [property](../../cpp/property-cpp ## Example -The following sample generates C2776: +The following example generates C2776: ```cpp // C2776.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md index 89a896e7b44..096cc46923c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md @@ -16,7 +16,7 @@ A [property](../../cpp/property-cpp.md) declspec modifier had more than one `put ## Example -The following sample generates C2777: +The following example generates C2777: ```cpp // C2777.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md index eb021823c2d..4873bda0996 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md @@ -27,7 +27,7 @@ struct __declspec(uuid("{00000000-0000-0000-0000-000000000000}")) B{}; The `uuid` extended attribute accepts strings recognized by [CLSIDFromString](/windows/win32/api/combaseapi/nf-combaseapi-clsidfromstring), with or without brace delimiters. -The following sample generates C2778: +The following example generates C2778: ```cpp // C2778b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md index 9fa794e8ff8..6641f047454 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md @@ -16,7 +16,7 @@ The **`property`** extended attribute is incorrectly applied to a static data me ## Example -The following sample generates C2779: +The following example generates C2779: ```cpp // C2779.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md index 8328124370f..6671fbd1b8d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md @@ -16,7 +16,7 @@ A function template has too few or too many arguments. ## Example -The following sample generates C2780 and shows how to fix it: +The following example generates C2780 and shows how to fix it: ```cpp // C2780.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md index 43c3b8d29f0..927f23387d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md @@ -16,7 +16,7 @@ A function template with a variable parameter list has too few arguments. ## Example -The following sample generates C2781: +The following example generates C2781: ```cpp // C2781.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md index e2e4820ef1e..088e90a558b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md @@ -16,7 +16,7 @@ The compiler cannot determine the type of a template argument. ## Examples -The following sample generates C2782: +The following example generates C2782: ```cpp // C2782.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md index 38aafbb8c4b..3e47e7fab4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md @@ -16,7 +16,7 @@ The compiler cannot determine a template argument. Default arguments cannot be u ## Examples -The following sample generates C2783: +The following example generates C2783: ```cpp // C2783.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md index 9805fb7257b..56f8a2d465f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md @@ -16,7 +16,7 @@ The compiler cannot determine a template argument from the supplied function arg ## Example -The following sample generates C2784 and shows how to fix it: +The following example generates C2784 and shows how to fix it: ```cpp // C2784.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md index feac08b5fea..2ec516b9571 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md @@ -20,7 +20,7 @@ The return type of function template specialization differs from the return type ## Example -The following sample generates C2785: +The following example generates C2785: ```cpp // C2785.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md index a10cb7d413c..5170b1a6569 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md @@ -20,7 +20,7 @@ The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type ## Example -The following sample generates C2786: +The following example generates C2786: ```cpp // C2786.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md index bbc7a22de7d..ccfe3ba8418 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md @@ -16,7 +16,7 @@ The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type ## Example -The following sample generates C2787: +The following example generates C2787: ```cpp // C2787.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md index c13088fb149..778d244d790 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md @@ -16,7 +16,7 @@ The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type ## Example -The following sample generates C2788: +The following example generates C2788: ```cpp // C2788.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md index 5b9a680a0b0..9226bdf4e04 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md @@ -16,7 +16,7 @@ This error message appears if the user ever tries to uses the keyword [super](.. ## Example -The following sample generates C2790: +The following example generates C2790: ```cpp // C2790.cpp From b2cff3c6b1100ba9659596ddfae75a735e37e709 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 7 Aug 2025 23:24:42 +0800 Subject: [PATCH 0656/1799] Update metadata for error references in range [C2761, C2790] --- .../error-messages/compiler-errors-2/compiler-error-c2761.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2762.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2764.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2766.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2767.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2768.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2770.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2771.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2773.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2774.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2775.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2776.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2777.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2778.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2779.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2780.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2781.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2782.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2783.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2784.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2785.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2786.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2787.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2788.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2790.md | 5 ++--- 25 files changed, 50 insertions(+), 75 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md index 63ae44b1daf..ab82d98deff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2761" title: "Compiler Error C2761" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2761" +ms.date: 11/04/2016 f1_keywords: ["C2761"] helpviewer_keywords: ["C2761"] -ms.assetid: 38c79a05-b56d-485b-820f-95e8c0cb926f --- # Compiler Error C2761 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md index 7d5e0ae06c3..6892019ad37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2762" title: "Compiler Error C2762" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2762" +ms.date: 11/04/2016 f1_keywords: ["C2762"] helpviewer_keywords: ["C2762"] -ms.assetid: 8b81a801-fd48-40a1-8bee-0748795b12e4 --- # Compiler Error C2762 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md index 3feffc12491..52a87747fd5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2764" title: "Compiler Error C2764" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2764" +ms.date: 11/04/2016 f1_keywords: ["C2764"] helpviewer_keywords: ["C2764"] -ms.assetid: 3754f5af-e094-4425-be20-d0c9a9b5baec --- # Compiler Error C2764 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md index 5b30a1aa0a1..f683b8433a2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2766" title: "Compiler Error C2766" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2766" +ms.date: 11/04/2016 f1_keywords: ["C2766"] helpviewer_keywords: ["C2766"] -ms.assetid: 8032f4ca-6827-4f04-9c61-c44643c85cc4 --- # Compiler Error C2766 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md index 44823754892..07706df7ad5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2767" title: "Compiler Error C2767" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2767" +ms.date: 11/04/2016 f1_keywords: ["C2767"] helpviewer_keywords: ["C2767"] -ms.assetid: e8f84178-a160-4d71-a236-07e4fcc11e96 --- # Compiler Error C2767 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2768.md b/docs/error-messages/compiler-errors-2/compiler-error-c2768.md index 64bed60ba95..472b925a5e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2768.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2768.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2768" title: "Compiler Error C2768" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2768" +ms.date: 11/04/2016 f1_keywords: ["C2768"] helpviewer_keywords: ["C2768"] -ms.assetid: a7f6047a-6a80-4737-ad5c-c12868639fb5 --- # Compiler Error C2768 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md index f4124ec3b2b..0e0d7839fdb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2770" title: "Compiler Error C2770" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2770" +ms.date: 11/04/2016 f1_keywords: ["C2770"] helpviewer_keywords: ["C2770"] -ms.assetid: 100001b5-80b0-4971-8ff6-9023f443c926 --- # Compiler Error C2770 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2771.md b/docs/error-messages/compiler-errors-2/compiler-error-c2771.md index d31cf00eec5..beafafe99db 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2771.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2771.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2771" title: "Compiler Error C2771" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2771" +ms.date: 11/04/2016 f1_keywords: ["C2771"] helpviewer_keywords: ["C2771"] -ms.assetid: b649cc9f-7cbc-4b42-a5e8-51dad5c55e4b --- # Compiler Error C2771 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2773.md b/docs/error-messages/compiler-errors-2/compiler-error-c2773.md index 138dd245bb1..01ca8986236 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2773.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2773.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2773" title: "Compiler Error C2773" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2773" +ms.date: 11/04/2016 f1_keywords: ["C2773"] helpviewer_keywords: ["C2773"] -ms.assetid: 8d564b26-1623-4d92-aabc-dff33f7b1145 --- # Compiler Error C2773 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md index e68947b1511..6ad8e6659e4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2774" title: "Compiler Error C2774" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2774" +ms.date: 11/04/2016 f1_keywords: ["C2774"] helpviewer_keywords: ["C2774"] -ms.assetid: 10f428c6-7f49-489a-92ba-6ef978b7caaf --- # Compiler Error C2774 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md index 86834667cdd..00654e73f7a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2775" title: "Compiler Error C2775" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2775" +ms.date: 11/04/2016 f1_keywords: ["C2775"] helpviewer_keywords: ["C2775"] -ms.assetid: 9c488508-ade0-48f1-b94f-d538d15f807a --- # Compiler Error C2775 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md index 5e18b92d1f2..a1844454dfa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2776" title: "Compiler Error C2776" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2776" +ms.date: 11/04/2016 f1_keywords: ["C2776"] helpviewer_keywords: ["C2776"] -ms.assetid: 9d80addc-62c7-40fc-a2cc-60303abb87df --- # Compiler Error C2776 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md index 096cc46923c..5b624a0afe0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2777" title: "Compiler Error C2777" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2777" +ms.date: 11/04/2016 f1_keywords: ["C2777"] helpviewer_keywords: ["C2777"] -ms.assetid: 5fe158c0-2a65-488a-aca2-61d4a8b32d43 --- # Compiler Error C2777 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md index 4873bda0996..5988f1aa528 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2778" title: "Compiler Error C2778" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2778" +ms.date: 11/04/2016 f1_keywords: ["C2778"] helpviewer_keywords: ["C2778"] -ms.assetid: b24cb732-2914-42cc-8928-e2d87b393428 --- # Compiler Error C2778 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md index 6641f047454..8e0b8797e1f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2779" title: "Compiler Error C2779" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2779" +ms.date: 11/04/2016 f1_keywords: ["C2779"] helpviewer_keywords: ["C2779"] -ms.assetid: 4a00e492-855a-41f3-8a18-5f60ee20c2f2 --- # Compiler Error C2779 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md index 6671fbd1b8d..6c5c901d405 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2780" title: "Compiler Error C2780" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2780" +ms.date: 11/04/2016 f1_keywords: ["C2780"] helpviewer_keywords: ["C2780"] -ms.assetid: 423793d8-a3b2-4f35-85f8-ae1d043e2b69 --- # Compiler Error C2780 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md index 927f23387d5..8af20a38e2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2781" title: "Compiler Error C2781" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2781" +ms.date: 11/04/2016 f1_keywords: ["C2781"] helpviewer_keywords: ["C2781"] -ms.assetid: f29b9963-f55b-427c-8db6-50f37713df5a --- # Compiler Error C2781 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md index 088e90a558b..1437c8068c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2782" title: "Compiler Error C2782" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2782" +ms.date: 11/04/2016 f1_keywords: ["C2782"] helpviewer_keywords: ["C2782"] -ms.assetid: 8b685422-294d-4f64-9f3d-c14eaf03a93d --- # Compiler Error C2782 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md index 3e47e7fab4f..d906f0cd87f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2783" title: "Compiler Error C2783" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2783" +ms.date: 11/04/2016 f1_keywords: ["C2783"] helpviewer_keywords: ["C2783"] -ms.assetid: 1ce94a11-bb8b-4be3-a222-f1f105da74b3 --- # Compiler Error C2783 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md index 56f8a2d465f..289c3733624 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2784" title: "Compiler Error C2784" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2784" +ms.date: 11/04/2016 f1_keywords: ["C2784"] helpviewer_keywords: ["C2784"] -ms.assetid: 3d761fe2-881c-48bd-afae-e2e714e20473 --- # Compiler Error C2784 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md index 2ec516b9571..07589c43d27 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2785" title: "Compiler Error C2785" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2785" +ms.date: 11/04/2016 f1_keywords: ["C2785"] helpviewer_keywords: ["C2785"] -ms.assetid: d8d13360-0d00-4815-8475-b49c7f0dc0f3 --- # Compiler Error C2785 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md index 5170b1a6569..3cdd52ad9a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2786" title: "Compiler Error C2786" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2786" +ms.date: 11/04/2016 f1_keywords: ["C2786"] helpviewer_keywords: ["C2786"] -ms.assetid: 6676d8c0-86dd-4a39-bdda-b75a35f4d137 --- # Compiler Error C2786 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md index ccfe3ba8418..e7e92cd8d32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2787" title: "Compiler Error C2787" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2787" +ms.date: 11/04/2016 f1_keywords: ["C2787"] helpviewer_keywords: ["C2787"] -ms.assetid: 34cb57e6-cafe-4ce7-bcc6-53d194629bd0 --- # Compiler Error C2787 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md index 778d244d790..f45b9117036 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2788" title: "Compiler Error C2788" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2788" +ms.date: 11/04/2016 f1_keywords: ["C2788"] helpviewer_keywords: ["C2788"] -ms.assetid: 8688fc5c-e652-43b4-b407-9c488c76f2db --- # Compiler Error C2788 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md index 9226bdf4e04..bf32485d812 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2790" title: "Compiler Error C2790" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2790" +ms.date: 11/04/2016 f1_keywords: ["C2790"] helpviewer_keywords: ["C2790"] -ms.assetid: 38d4fce1-ba00-413d-8bc1-e8aa43d7bc1f --- # Compiler Error C2790 From c42ae099401f22e8b6f69da5df5b0419a59cb981 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 7 Aug 2025 17:40:50 -0700 Subject: [PATCH 0657/1799] Update compiler-error-c2715.md added the example intro sentence --- docs/error-messages/compiler-errors-2/compiler-error-c2715.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md index 86f7e5ce731..266c4e4c718 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md @@ -15,6 +15,8 @@ Value types are not valid arguments when using exception handling in managed cod ## Example +The following example generates C2715: + ```cpp // C2715a.cpp // compile with: /clr From 36a0527b44c31f1800fbc48375095b178c000b06 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 7 Aug 2025 17:42:23 -0700 Subject: [PATCH 0658/1799] Update compiler-error-c2715.md --- docs/error-messages/compiler-errors-2/compiler-error-c2715.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md index 266c4e4c718..ddb31bc681b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md @@ -15,7 +15,7 @@ Value types are not valid arguments when using exception handling in managed cod ## Example -The following example generates C2715: +The following example generates C2715 and shows how to fix it: ```cpp // C2715a.cpp From b66d87e0252d8f3e3161222c9f7e6b923b64f4a4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 17:19:54 +0800 Subject: [PATCH 0659/1799] Add backticks in `` header reference --- docs/standard-library/system-error.md | 42 +++++++++++++-------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/standard-library/system-error.md b/docs/standard-library/system-error.md index 0d12bfef30e..cb0f6967ea1 100644 --- a/docs/standard-library/system-error.md +++ b/docs/standard-library/system-error.md @@ -8,13 +8,13 @@ ms.assetid: 5e046c6e-48d9-4740-8c8a-05f3727c1215 --- # `` -Include the header \ to define the exception class `system_error` and related templates for processing low-level system errors. +Include the header `` to define the exception class `system_error` and related templates for processing low-level system errors. ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## Members @@ -22,44 +22,44 @@ Include the header \ to define the exception class `system_error` |Name|Description| |-|-| -|[generic_category](../standard-library/system-error-functions.md#generic_category)|Represents the category for generic errors.| -|[is_error_code_enum_v](../standard-library/system-error-functions.md#is_error_code_enum_v)|| -|[is_error_condition_enum_v](../standard-library/system-error-functions.md#is_error_condition_enum_v)|| -|[system_category](../standard-library/system-error-functions.md#system_category)|Represents the category for errors caused by low-level system overflows.| +|[`generic_category`](../standard-library/system-error-functions.md#generic_category)|Represents the category for generic errors.| +|[`is_error_code_enum_v`](../standard-library/system-error-functions.md#is_error_code_enum_v)|| +|[`is_error_condition_enum_v`](../standard-library/system-error-functions.md#is_error_condition_enum_v)|| +|[`system_category`](../standard-library/system-error-functions.md#system_category)|Represents the category for errors caused by low-level system overflows.| ### Functions |Name|Description| |-|-| -|[make_error_code](../standard-library/system-error-functions.md#make_error_code)|Creates an `error_code` object.| -|[make_error_condition](../standard-library/system-error-functions.md#make_error_condition)|Creates an `error_condition` object.| +|[`make_error_code`](../standard-library/system-error-functions.md#make_error_code)|Creates an `error_code` object.| +|[`make_error_condition`](../standard-library/system-error-functions.md#make_error_condition)|Creates an `error_condition` object.| ### Operators |Name|Description| |-|-| -|[operator==](../standard-library/system-error-operators.md#op_eq_eq)|Tests if the object on the left side of the operator is equal to the object on the right side.| -|[operator!=](../standard-library/system-error-operators.md#op_neq)|Tests if the object on the left side of the operator is not equal to the object on the right side.| -|[operator<](../standard-library/system-error-operators.md#op_lt)|Tests if an object is less than the object passed in for comparison.| -|[operator<<](../standard-library/system-error-operators.md#op_ostream)|| +|[`operator==`](../standard-library/system-error-operators.md#op_eq_eq)|Tests if the object on the left side of the operator is equal to the object on the right side.| +|[`operator!=`](../standard-library/system-error-operators.md#op_neq)|Tests if the object on the left side of the operator is not equal to the object on the right side.| +|[`operator<`](../standard-library/system-error-operators.md#op_lt)|Tests if an object is less than the object passed in for comparison.| +|[`operator<<`](../standard-library/system-error-operators.md#op_ostream)|| ### Enums |Name|Description| |-|-| -|[errc](../standard-library/system-error-enums.md#errc)|Provides symbolic names for all the error-code macros defined by POSIX in ``.| +|[`errc`](../standard-library/system-error-enums.md#errc)|Provides symbolic names for all the error-code macros defined by POSIX in ``.| ### Classes and Structs |Name|Description| |-|-| -|[error_category](../standard-library/error-category-class.md)|Represents the abstract, common base for objects that describes a category of error codes.| -|[error_code](../standard-library/error-code-class.md)|Represents low-level system errors that are implementation-specific.| -|[error_condition](../standard-library/error-condition-class.md)|Represents user-defined error codes.| -|[hash](../standard-library/hash-structure.md#system_error)|| -|[is_error_code_enum](../standard-library/is-error-code-enum-class.md)|Represents a type predicate that tests for the [error_code Class](../standard-library/error-code-class.md) enumeration.| -|[is_error_condition_enum](../standard-library/is-error-condition-enum-class.md)|Represents a type predicate that tests for the [error_condition Class](../standard-library/error-condition-class.md) enumeration.| -|[system_error](../standard-library/system-error-class.md)|Represents the base class for all exceptions thrown to report a low-level system overflow.| +|[`error_category`](../standard-library/error-category-class.md)|Represents the abstract, common base for objects that describes a category of error codes.| +|[`error_code`](../standard-library/error-code-class.md)|Represents low-level system errors that are implementation-specific.| +|[`error_condition`](../standard-library/error-condition-class.md)|Represents user-defined error codes.| +|[`hash`](../standard-library/hash-structure.md#system_error)|| +|[`is_error_code_enum`](../standard-library/is-error-code-enum-class.md)|Represents a type predicate that tests for the [`error_code` Class](../standard-library/error-code-class.md) enumeration.| +|[`is_error_condition_enum`](../standard-library/is-error-condition-enum-class.md)|Represents a type predicate that tests for the [`error_condition` Class](../standard-library/error-condition-class.md) enumeration.| +|[`system_error`](../standard-library/system-error-class.md)|Represents the base class for all exceptions thrown to report a low-level system overflow.| ## See also From 71995902323c61ee1bb4f40914a76dd94cdfc1de Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 17:23:17 +0800 Subject: [PATCH 0660/1799] Simplify redundant relative links in `` header reference --- docs/standard-library/system-error.md | 38 +++++++++++++-------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/standard-library/system-error.md b/docs/standard-library/system-error.md index cb0f6967ea1..6d13e7e1291 100644 --- a/docs/standard-library/system-error.md +++ b/docs/standard-library/system-error.md @@ -22,45 +22,45 @@ Include the header `` to define the exception class `system_error` |Name|Description| |-|-| -|[`generic_category`](../standard-library/system-error-functions.md#generic_category)|Represents the category for generic errors.| -|[`is_error_code_enum_v`](../standard-library/system-error-functions.md#is_error_code_enum_v)|| -|[`is_error_condition_enum_v`](../standard-library/system-error-functions.md#is_error_condition_enum_v)|| -|[`system_category`](../standard-library/system-error-functions.md#system_category)|Represents the category for errors caused by low-level system overflows.| +|[`generic_category`](system-error-functions.md#generic_category)|Represents the category for generic errors.| +|[`is_error_code_enum_v`](system-error-functions.md#is_error_code_enum_v)|| +|[`is_error_condition_enum_v`](system-error-functions.md#is_error_condition_enum_v)|| +|[`system_category`](system-error-functions.md#system_category)|Represents the category for errors caused by low-level system overflows.| ### Functions |Name|Description| |-|-| -|[`make_error_code`](../standard-library/system-error-functions.md#make_error_code)|Creates an `error_code` object.| -|[`make_error_condition`](../standard-library/system-error-functions.md#make_error_condition)|Creates an `error_condition` object.| +|[`make_error_code`](system-error-functions.md#make_error_code)|Creates an `error_code` object.| +|[`make_error_condition`](system-error-functions.md#make_error_condition)|Creates an `error_condition` object.| ### Operators |Name|Description| |-|-| -|[`operator==`](../standard-library/system-error-operators.md#op_eq_eq)|Tests if the object on the left side of the operator is equal to the object on the right side.| -|[`operator!=`](../standard-library/system-error-operators.md#op_neq)|Tests if the object on the left side of the operator is not equal to the object on the right side.| -|[`operator<`](../standard-library/system-error-operators.md#op_lt)|Tests if an object is less than the object passed in for comparison.| -|[`operator<<`](../standard-library/system-error-operators.md#op_ostream)|| +|[`operator==`](system-error-operators.md#op_eq_eq)|Tests if the object on the left side of the operator is equal to the object on the right side.| +|[`operator!=`](system-error-operators.md#op_neq)|Tests if the object on the left side of the operator is not equal to the object on the right side.| +|[`operator<`](system-error-operators.md#op_lt)|Tests if an object is less than the object passed in for comparison.| +|[`operator<<`](system-error-operators.md#op_ostream)|| ### Enums |Name|Description| |-|-| -|[`errc`](../standard-library/system-error-enums.md#errc)|Provides symbolic names for all the error-code macros defined by POSIX in ``.| +|[`errc`](system-error-enums.md#errc)|Provides symbolic names for all the error-code macros defined by POSIX in ``.| ### Classes and Structs |Name|Description| |-|-| -|[`error_category`](../standard-library/error-category-class.md)|Represents the abstract, common base for objects that describes a category of error codes.| -|[`error_code`](../standard-library/error-code-class.md)|Represents low-level system errors that are implementation-specific.| -|[`error_condition`](../standard-library/error-condition-class.md)|Represents user-defined error codes.| -|[`hash`](../standard-library/hash-structure.md#system_error)|| -|[`is_error_code_enum`](../standard-library/is-error-code-enum-class.md)|Represents a type predicate that tests for the [`error_code` Class](../standard-library/error-code-class.md) enumeration.| -|[`is_error_condition_enum`](../standard-library/is-error-condition-enum-class.md)|Represents a type predicate that tests for the [`error_condition` Class](../standard-library/error-condition-class.md) enumeration.| -|[`system_error`](../standard-library/system-error-class.md)|Represents the base class for all exceptions thrown to report a low-level system overflow.| +|[`error_category`](error-category-class.md)|Represents the abstract, common base for objects that describes a category of error codes.| +|[`error_code`](error-code-class.md)|Represents low-level system errors that are implementation-specific.| +|[`error_condition`](error-condition-class.md)|Represents user-defined error codes.| +|[`hash`](hash-structure.md#system_error)|| +|[`is_error_code_enum`](is-error-code-enum-class.md)|Represents a type predicate that tests for the [`error_code` Class](error-code-class.md) enumeration.| +|[`is_error_condition_enum`](is-error-condition-enum-class.md)|Represents a type predicate that tests for the [`error_condition` Class](error-condition-class.md) enumeration.| +|[`system_error`](system-error-class.md)|Represents the base class for all exceptions thrown to report a low-level system overflow.| ## See also -[Header Files Reference](../standard-library/cpp-standard-library-header-files.md) +[Header Files Reference](cpp-standard-library-header-files.md) From c6fdfafd5787c178f329525a9c2dd0edf4cb9b15 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 17:38:59 +0800 Subject: [PATCH 0661/1799] Add and update descriptions in `` header reference --- docs/standard-library/system-error.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/standard-library/system-error.md b/docs/standard-library/system-error.md index 6d13e7e1291..d40120a130c 100644 --- a/docs/standard-library/system-error.md +++ b/docs/standard-library/system-error.md @@ -23,16 +23,16 @@ Include the header `` to define the exception class `system_error` |Name|Description| |-|-| |[`generic_category`](system-error-functions.md#generic_category)|Represents the category for generic errors.| -|[`is_error_code_enum_v`](system-error-functions.md#is_error_code_enum_v)|| -|[`is_error_condition_enum_v`](system-error-functions.md#is_error_condition_enum_v)|| -|[`system_category`](system-error-functions.md#system_category)|Represents the category for errors caused by low-level system overflows.| +|[`is_error_code_enum_v`](system-error-functions.md#is_error_code_enum_v)|A helper variable template for the [`is_error_code_enum`](is-error-code-enum-class.md) value.| +|[`is_error_condition_enum_v`](system-error-functions.md#is_error_condition_enum_v)|A helper variable template for the [`is_error_condition_enum`](is-error-condition-enum-class.md) value.| +|[`system_category`](system-error-functions.md#system_category)|Represents the category for operating system errors.| ### Functions |Name|Description| |-|-| -|[`make_error_code`](system-error-functions.md#make_error_code)|Creates an `error_code` object.| -|[`make_error_condition`](system-error-functions.md#make_error_condition)|Creates an `error_condition` object.| +|[`make_error_code`](system-error-functions.md#make_error_code)|Creates an [`error_code`](error-code-class.md) object.| +|[`make_error_condition`](system-error-functions.md#make_error_condition)|Creates an [`error_condition`](error-condition-class.md) object.| ### Operators @@ -41,7 +41,7 @@ Include the header `` to define the exception class `system_error` |[`operator==`](system-error-operators.md#op_eq_eq)|Tests if the object on the left side of the operator is equal to the object on the right side.| |[`operator!=`](system-error-operators.md#op_neq)|Tests if the object on the left side of the operator is not equal to the object on the right side.| |[`operator<`](system-error-operators.md#op_lt)|Tests if an object is less than the object passed in for comparison.| -|[`operator<<`](system-error-operators.md#op_ostream)|| +|[`operator<<`](system-error-operators.md#op_ostream)|Inserts an [`error_code`](error-code-class.md) object into the output stream.| ### Enums @@ -56,10 +56,10 @@ Include the header `` to define the exception class `system_error` |[`error_category`](error-category-class.md)|Represents the abstract, common base for objects that describes a category of error codes.| |[`error_code`](error-code-class.md)|Represents low-level system errors that are implementation-specific.| |[`error_condition`](error-condition-class.md)|Represents user-defined error codes.| -|[`hash`](hash-structure.md#system_error)|| -|[`is_error_code_enum`](is-error-code-enum-class.md)|Represents a type predicate that tests for the [`error_code` Class](error-code-class.md) enumeration.| -|[`is_error_condition_enum`](is-error-condition-enum-class.md)|Represents a type predicate that tests for the [`error_condition` Class](error-condition-class.md) enumeration.| -|[`system_error`](system-error-class.md)|Represents the base class for all exceptions thrown to report a low-level system overflow.| +|[`hash`](hash-structure.md#system_error)|Template specializations of [`std::hash`](hash-class.md) for [`error_code`](error-code-class.md) and [`error_condition`](error-condition-class.md).| +|[`is_error_code_enum`](is-error-code-enum-class.md)|Represents a type predicate that tests for the [`error_code`](error-code-class.md) enumeration.| +|[`is_error_condition_enum`](is-error-condition-enum-class.md)|Represents a type predicate that tests for the [`error_condition`](error-condition-class.md) enumeration.| +|[`system_error`](system-error-class.md)|Represents the base class for all exceptions thrown to report a low-level system error.| ## See also From 52815894a789a320227bbdc248acaa090bfa134c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 17:39:41 +0800 Subject: [PATCH 0662/1799] Update metadata in `` header reference --- docs/standard-library/system-error.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/system-error.md b/docs/standard-library/system-error.md index d40120a130c..8a633804bff 100644 --- a/docs/standard-library/system-error.md +++ b/docs/standard-library/system-error.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "03/15/2019" +description: "Learn more about: " +ms.date: 03/15/2019 f1_keywords: [""] helpviewer_keywords: ["system_error header"] -ms.assetid: 5e046c6e-48d9-4740-8c8a-05f3727c1215 --- # `` From 645bfcc28f9d2f2b0570827a46b6420662dc5d33 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 17:59:37 +0800 Subject: [PATCH 0663/1799] Add C6064 "See also" link in C4473 warning reference --- docs/error-messages/compiler-warnings/c4473.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-warnings/c4473.md b/docs/error-messages/compiler-warnings/c4473.md index b10194290b8..c83108b1f7f 100644 --- a/docs/error-messages/compiler-warnings/c4473.md +++ b/docs/error-messages/compiler-warnings/c4473.md @@ -54,3 +54,7 @@ void scan_func(int a, float f) ``` In this example, **scanf_s** requires two arguments for each placeholder, one to supply the address to write to, and a second to supply the size of the first. Check the documentation for each library function for an explanation of the required arguments. + +## See also + +[C6064](../../code-quality/c6064.md) From 38fcfd60b91a772ee4822439235c0bf835fd61d0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 18:00:19 +0800 Subject: [PATCH 0664/1799] Update metadata in 2 warning topics --- docs/code-quality/c6064.md | 2 +- docs/error-messages/compiler-warnings/c4473.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/code-quality/c6064.md b/docs/code-quality/c6064.md index 645f77ff241..c17eeaf1c7a 100644 --- a/docs/code-quality/c6064.md +++ b/docs/code-quality/c6064.md @@ -1,6 +1,6 @@ --- +title: "Warning C6064" description: "Learn more about: Warning C6064" -title: Warning C6064 ms.date: 2/07/2023 f1_keywords: ["C6064", "MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6064"] diff --git a/docs/error-messages/compiler-warnings/c4473.md b/docs/error-messages/compiler-warnings/c4473.md index c83108b1f7f..5dfe94c2862 100644 --- a/docs/error-messages/compiler-warnings/c4473.md +++ b/docs/error-messages/compiler-warnings/c4473.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4473" title: "Compiler Warning C4473" -ms.date: "02/16/2018" +description: "Learn more about: Compiler Warning (level 1) C4473" +ms.date: 02/16/2018 f1_keywords: ["C4473"] helpviewer_keywords: ["C4473"] --- From 8afb23c2b8ffbe734b4a19b0edb24a4e2cd02444 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 18:26:18 +0800 Subject: [PATCH 0665/1799] Merge unnecessary multiline `f1_keywords` and `helpviewer_keywords` --- docs/standard-library/span-class.md | 3 +-- docs/standard-library/unordered-multimap-class.md | 7 ++----- 2 files changed, 3 insertions(+), 7 deletions(-) diff --git a/docs/standard-library/span-class.md b/docs/standard-library/span-class.md index 010b8fef931..ee46c66ff03 100644 --- a/docs/standard-library/span-class.md +++ b/docs/standard-library/span-class.md @@ -2,8 +2,7 @@ title: span class (C++ Standard Library) description: "API reference for the Standard Template Library (STL) span class, which provides a lightweight view over a contiguous sequence of objects." ms.date: "05/28/2020" -f1_keywords: ["span/std::span", "span/std::span::const_pointer", "span/std::span::const_reference", "span/std::span::difference_type", "span/std::span::element_type", "span/std::span::iterator", "span/std::span::pointer", "span/std::span::reference", "span/std::span::reverse_iterator", "span/std::span::size_type", "span/std::span::value_type", "span/std::span::at", "span/std::span::assign", "span/std::span::back", "span/std::span::begin", "span/std::span::data", "span/std::span::empty", "span/std::span::end", "span/std::span::front", "span/std::span::rbegin", "span/std::span::rend", -"span/std::span::size", "span/std::span::size_bytes", "span/std::span::operator=", "span/std::span::operator[]"] +f1_keywords: ["span/std::span", "span/std::span::const_pointer", "span/std::span::const_reference", "span/std::span::difference_type", "span/std::span::element_type", "span/std::span::iterator", "span/std::span::pointer", "span/std::span::reference", "span/std::span::reverse_iterator", "span/std::span::size_type", "span/std::span::value_type", "span/std::span::at", "span/std::span::assign", "span/std::span::back", "span/std::span::begin", "span/std::span::data", "span/std::span::empty", "span/std::span::end", "span/std::span::front", "span/std::span::rbegin", "span/std::span::rend", "span/std::span::size", "span/std::span::size_bytes", "span/std::span::operator=", "span/std::span::operator[]"] helpviewer_keywords: ["std::span [C++]", "std::span [C++], const_pointer", "std::span [C++], const_reference", "std::span [C++], difference_type", "std::span [C++], element_type", "std::span [C++], iterator", "std::span [C++], pointer", "std::span [C++], reference", "std::span [C++], reverse_iterator", "std::span [C++], size_type", "std::span [C++], value_type", "std::span [C++], assign", "std::span [C++], at", "std::span [C++], back", "std::span [C++], begin", "std::span [C++], data", "std::span [C++], empty", "std::span [C++], end", "std::span [C++], front", "std::span [C++], rbegin", "std::span [C++], rend", "std::span [C++], size", "std::span [C++], size_bytes"] dev_langs: ["C++"] --- diff --git a/docs/standard-library/unordered-multimap-class.md b/docs/standard-library/unordered-multimap-class.md index 516585e9dcb..b1071b77809 100644 --- a/docs/standard-library/unordered-multimap-class.md +++ b/docs/standard-library/unordered-multimap-class.md @@ -2,11 +2,8 @@ title: "unordered_multimap Class" description: "API overview for the C++ Standard Library container class `unordered_multimap`." ms.date: 9/9/2020 -f1_keywords: ["unordered_map/std::unordered_multimap", "unordered_map/std::unordered_multimap::allocator_type", "unordered_map/std::unordered_multimap::const_iterator", "unordered_map/std::unordered_multimap::const_local_iterator", "unordered_map/std::unordered_multimap::const_pointer", "unordered_map/std::unordered_multimap::const_reference", "unordered_map/std::unordered_multimap::difference_type", "unordered_map/std::unordered_multimap::hasher", "unordered_map/std::unordered_multimap::iterator", "unordered_map/std::unordered_multimap::key_equal", "unordered_map/std::unordered_multimap::key_type", "unordered_map/std::unordered_multimap::local_iterator", "unordered_map/std::unordered_multimap::mapped_type", "unordered_map/std::unordered_multimap::pointer", "unordered_map/std::unordered_multimap::reference", "unordered_map/std::unordered_multimap::size_type", "unordered_map/std::unordered_multimap::value_type", "unordered_map/std::unordered_multimap::begin", "unordered_map/std::unordered_multimap::bucket", "unordered_map/std::unordered_multimap::bucket_count", "unordered_map/std::unordered_multimap::bucket_size", "unordered_map/std::unordered_multimap::cbegin", "unordered_map/std::unordered_multimap::cend", "unordered_map/std::unordered_multimap::clear", -"unordered_map/std::unordered_multimap::contains", "unordered_map/std::unordered_multimap::count", "unordered_map/std::unordered_multimap::emplace", "unordered_map/std::unordered_multimap::emplace_hint", "unordered_map/std::unordered_multimap::empty", "unordered_map/std::unordered_multimap::end", "unordered_map/std::unordered_multimap::equal_range", "unordered_map/std::unordered_multimap::erase", "unordered_map/std::unordered_multimap::find", "unordered_map/std::unordered_multimap::get_allocator", "unordered_map/std::unordered_multimap::hash", "unordered_map/std::unordered_multimap::insert", "unordered_map/std::unordered_multimap::key_eq", "unordered_map/std::unordered_multimap::load_factor", "unordered_map/std::unordered_multimap::max_bucket_count", "unordered_map/std::unordered_multimap::max_load_factor", "unordered_map/std::unordered_multimap::max_size", "unordered_map/std::unordered_multimap::rehash", "unordered_map/std::unordered_multimap::size", "unordered_map/std::unordered_multimap::swap", "unordered_map/std::unordered_multimap::unordered_multimap", "unordered_map/std::unordered_multimap::operator=", "unordered_map/std::unordered_multimap::hash_function"] -helpviewer_keywords: ["std::unordered_multimap", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", -"std::unordered_multimap::contains", -"std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap", "std::unordered_multimap::unordered_multimap", "std::unordered_multimap::operator=", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", "std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash_function", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap"] +f1_keywords: ["unordered_map/std::unordered_multimap", "unordered_map/std::unordered_multimap::allocator_type", "unordered_map/std::unordered_multimap::const_iterator", "unordered_map/std::unordered_multimap::const_local_iterator", "unordered_map/std::unordered_multimap::const_pointer", "unordered_map/std::unordered_multimap::const_reference", "unordered_map/std::unordered_multimap::difference_type", "unordered_map/std::unordered_multimap::hasher", "unordered_map/std::unordered_multimap::iterator", "unordered_map/std::unordered_multimap::key_equal", "unordered_map/std::unordered_multimap::key_type", "unordered_map/std::unordered_multimap::local_iterator", "unordered_map/std::unordered_multimap::mapped_type", "unordered_map/std::unordered_multimap::pointer", "unordered_map/std::unordered_multimap::reference", "unordered_map/std::unordered_multimap::size_type", "unordered_map/std::unordered_multimap::value_type", "unordered_map/std::unordered_multimap::begin", "unordered_map/std::unordered_multimap::bucket", "unordered_map/std::unordered_multimap::bucket_count", "unordered_map/std::unordered_multimap::bucket_size", "unordered_map/std::unordered_multimap::cbegin", "unordered_map/std::unordered_multimap::cend", "unordered_map/std::unordered_multimap::clear", "unordered_map/std::unordered_multimap::contains", "unordered_map/std::unordered_multimap::count", "unordered_map/std::unordered_multimap::emplace", "unordered_map/std::unordered_multimap::emplace_hint", "unordered_map/std::unordered_multimap::empty", "unordered_map/std::unordered_multimap::end", "unordered_map/std::unordered_multimap::equal_range", "unordered_map/std::unordered_multimap::erase", "unordered_map/std::unordered_multimap::find", "unordered_map/std::unordered_multimap::get_allocator", "unordered_map/std::unordered_multimap::hash", "unordered_map/std::unordered_multimap::insert", "unordered_map/std::unordered_multimap::key_eq", "unordered_map/std::unordered_multimap::load_factor", "unordered_map/std::unordered_multimap::max_bucket_count", "unordered_map/std::unordered_multimap::max_load_factor", "unordered_map/std::unordered_multimap::max_size", "unordered_map/std::unordered_multimap::rehash", "unordered_map/std::unordered_multimap::size", "unordered_map/std::unordered_multimap::swap", "unordered_map/std::unordered_multimap::unordered_multimap", "unordered_map/std::unordered_multimap::operator=", "unordered_map/std::unordered_multimap::hash_function"] +helpviewer_keywords: ["std::unordered_multimap", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", "std::unordered_multimap::contains", "std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap", "std::unordered_multimap::unordered_multimap", "std::unordered_multimap::operator=", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", "std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash_function", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap"] --- # unordered_multimap Class From 7d2fac6c216bef02126490f7452c0ff8a5afeae5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 18:27:02 +0800 Subject: [PATCH 0666/1799] Update metadata in `span` class reference --- docs/standard-library/span-class.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/span-class.md b/docs/standard-library/span-class.md index ee46c66ff03..8fc221fe457 100644 --- a/docs/standard-library/span-class.md +++ b/docs/standard-library/span-class.md @@ -1,7 +1,7 @@ --- -title: span class (C++ Standard Library) +title: "span class (C++ Standard Library)" description: "API reference for the Standard Template Library (STL) span class, which provides a lightweight view over a contiguous sequence of objects." -ms.date: "05/28/2020" +ms.date: 05/28/2020 f1_keywords: ["span/std::span", "span/std::span::const_pointer", "span/std::span::const_reference", "span/std::span::difference_type", "span/std::span::element_type", "span/std::span::iterator", "span/std::span::pointer", "span/std::span::reference", "span/std::span::reverse_iterator", "span/std::span::size_type", "span/std::span::value_type", "span/std::span::at", "span/std::span::assign", "span/std::span::back", "span/std::span::begin", "span/std::span::data", "span/std::span::empty", "span/std::span::end", "span/std::span::front", "span/std::span::rbegin", "span/std::span::rend", "span/std::span::size", "span/std::span::size_bytes", "span/std::span::operator=", "span/std::span::operator[]"] helpviewer_keywords: ["std::span [C++]", "std::span [C++], const_pointer", "std::span [C++], const_reference", "std::span [C++], difference_type", "std::span [C++], element_type", "std::span [C++], iterator", "std::span [C++], pointer", "std::span [C++], reference", "std::span [C++], reverse_iterator", "std::span [C++], size_type", "std::span [C++], value_type", "std::span [C++], assign", "std::span [C++], at", "std::span [C++], back", "std::span [C++], begin", "std::span [C++], data", "std::span [C++], empty", "std::span [C++], end", "std::span [C++], front", "std::span [C++], rbegin", "std::span [C++], rend", "std::span [C++], size", "std::span [C++], size_bytes"] dev_langs: ["C++"] From a97223e06c19cf035a55b19fee96f238eb3f0bf3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 22:59:38 +0800 Subject: [PATCH 0667/1799] Add blockquotes for error messages in range [C2791, C2820] --- docs/error-messages/compiler-errors-2/compiler-error-c2791.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2792.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2793.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2794.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2795.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2797.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2798.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2800.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2801.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2802.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2803.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2804.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2805.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2806.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2807.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2808.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2809.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2810.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2811.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2812.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2813.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2814.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2815.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2817.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2818.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2819.md | 2 +- 26 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md index 127353149a4..2e8be8fd0ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md @@ -8,7 +8,7 @@ ms.assetid: 938ad1fb-75d9-4ce2-ad92-83d6249005b5 --- # Compiler Error C2791 -illegal use of 'super': 'class' does not have any base classes +> illegal use of 'super': 'class' does not have any base classes The keyword [super](../../cpp/super.md) was used within the context of a member function of a class that does not have any base classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md index 54f751a3118..66551ace49d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md @@ -8,7 +8,7 @@ ms.assetid: 392cf748-4f5e-4e62-a364-3118d5658408 --- # Compiler Error C2792 -'super' : this keyword must be followed by '::' +> 'super' : this keyword must be followed by '::' The only token that can follow the keyword **`__super`** is `::`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md index 6421099661f..5dae54a4c6b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md @@ -8,7 +8,7 @@ ms.assetid: ce35f4e8-c357-40ca-95c4-15ff001ad69d --- # Compiler Error C2793 -'token' : unexpected token following '::', identifier or keyword 'operator' expected +> 'token' : unexpected token following '::', identifier or keyword 'operator' expected The only tokens that can follow `__super::` are an identifier or the keyword **`operator`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md index d9d8fbb45ff..84d3c0d9510 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md @@ -8,7 +8,7 @@ ms.assetid: d508191c-9044-4c6a-9119-4bca668c0b93 --- # Compiler Error C2794 -'function' : is not a member of any direct or indirect base class of 'class' +> 'function' : is not a member of any direct or indirect base class of 'class' You tried to use [super](../../cpp/super.md) to call a nonexistent member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2795.md b/docs/error-messages/compiler-errors-2/compiler-error-c2795.md index b9aaa67ad82..450f10004bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2795.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2795.md @@ -8,6 +8,6 @@ ms.assetid: 8cd8c7fe-2add-4871-85f7-9a6afe4ac588 --- # Compiler Error C2795 -'super::function' is not a member function +> 'super::function' is not a member function This error message appears whenever you try to use [super](../../cpp/super.md) to access a member other than a member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md index 9b3f1a04db2..eb500a79487 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2797"] --- # Compiler Error C2797 -(Obsolete) List initialization inside member initializer list or non-static data member initializer is not implemented. +> (Obsolete) List initialization inside member initializer list or non-static data member initializer is not implemented. This warning is obsolete in Visual Studio 2015. In Visual Studio 2013 and earlier versions, the Microsoft C++ compiler does not implement list initialization inside either a member initializer list or a non-static data member initializer. Before Visual Studio 2013 Update 3, this was silently converted to a function call, which could lead to bad code generation. Visual Studio 2013 Update 3 reports this as an error. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md index 9bdca5513c9..59872836d79 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md @@ -8,7 +8,7 @@ ms.assetid: fb0cd861-b228-4f81-8090-e28344a727e0 --- # Compiler Error C2798 -'super::member' is ambiguous +> 'super::member' is ambiguous Multiple inherited structures contain the member you referenced with [super](../../cpp/super.md). You could fix the error by either: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md index 31f8908e35f..87a4ad83f59 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md @@ -8,7 +8,7 @@ ms.assetid: a2f1a590-9fe6-44cb-ad09-b4505ef47c6a --- # Compiler Error C2800 -'operator operator' cannot be overloaded +> 'operator operator' cannot be overloaded The following operators cannot be overloaded: class member access (`.`), pointer to member (`.*`), scope resolution (`::`), conditional expression (`? :`), and **`sizeof`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md index 072efc5bada..6dccb3d9c49 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md @@ -8,7 +8,7 @@ ms.assetid: 35dfc7ea-9e37-4e30-baa1-944dc61302f5 --- # Compiler Error C2801 -'operator operator' must be a non-static member +> 'operator operator' must be a non-static member The following operators can be overloaded only as nonstatic members: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md index 6213cbba277..b34e3185d0c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md @@ -8,7 +8,7 @@ ms.assetid: 08b68c0e-9382-40ac-8949-39a7a2749e05 --- # Compiler Error C2802 -static member 'operator operator' has no formal parameters +> static member 'operator operator' has no formal parameters An operator declared by a **`static`** member function must have at least one parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md index d3b3c841e34..a6740105639 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md @@ -8,7 +8,7 @@ ms.assetid: 2cdbe374-8cc4-4c4e-ba15-062a7479e937 --- # Compiler Error C2803 -'operator operator' must have at least one formal parameter of class type +> 'operator operator' must have at least one formal parameter of class type The overloaded operator lacks a parameter of class type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md index 1ca73c5ca65..2c9c5eb059f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md @@ -8,7 +8,7 @@ ms.assetid: b066e563-cca4-450c-8ba7-3b0d7a89f3ea --- # Compiler Error C2804 -binary 'operator operator' has too many parameters +> binary 'operator operator' has too many parameters The overloaded binary operator member function is declared with more than one parameter. The first operand parameter of a binary operator member function, whose type is the operator's enclosing type, is implied. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md index 69a25b9734a..6087550629c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md @@ -8,7 +8,7 @@ ms.assetid: c997dc56-e199-442f-b94e-ac551ec9b015 --- # Compiler Error C2805 -binary 'operator operator' has too few parameters +> binary 'operator operator' has too few parameters The binary operator has no parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md index a1efc1388d3..1a9de42a832 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md @@ -8,7 +8,7 @@ ms.assetid: 7c9ff1f4-1590-4c47-991d-b1075a173b48 --- # Compiler Error C2806 -'operator operator' has too many formal parameters +> 'operator operator' has too many formal parameters An overloaded operator has too many parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md index 1eb9f971c86..4b3e19020ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md @@ -8,7 +8,7 @@ ms.assetid: bd7a207a-f379-4de6-8ee8-c7cab78b3480 --- # Compiler Error C2807 -the second formal parameter to postfix 'operator operator' must be 'int' +> the second formal parameter to postfix 'operator operator' must be 'int' The second parameter to a postfix operator has the wrong type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md index 438adafd4a0..cbe6f7eb7ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md @@ -8,7 +8,7 @@ ms.assetid: 3d745102-d3b3-4735-a7d2-ad42d5bf3cfa --- # Compiler Error C2808 -unary 'operator operator' has too many formal parameters +> unary 'operator operator' has too many formal parameters The unary operator has a nonvoid parameter list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md index 48d236e3e85..a466d2942b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md @@ -8,7 +8,7 @@ ms.assetid: ce796b8e-1a8c-4074-995d-1ad09afd0e93 --- # Compiler Error C2809 -'operator operator' has no formal parameters +> 'operator operator' has no formal parameters The operator lacks required parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md index 43de6906e30..0c86142cd51 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md @@ -8,7 +8,7 @@ ms.assetid: f63e8f24-d7f6-42ac-904f-72ff49592ba6 --- # Compiler Error C2810 -'interface' : an interface can only inherit from another interface +> 'interface' : an interface can only inherit from another interface An [interface](../../cpp/interface.md) may only inherit from another interface and may not inherit from a class or struct. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md index 4f36772c6c5..3b58e730a58 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md @@ -8,7 +8,7 @@ ms.assetid: 6a44b18e-44c1-49d8-9b99-e0545b9a6e7d --- # Compiler Error C2811 -'type1' : cannot inherit from 'type2', a ref class can only inherit from a ref class or interface class +> 'type1' : cannot inherit from 'type2', a ref class can only inherit from a ref class or interface class You attempted to use an unmanaged class as a base class for a managed class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2812.md b/docs/error-messages/compiler-errors-2/compiler-error-c2812.md index 5b4483c3476..a9f6938643a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2812.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2812.md @@ -8,7 +8,7 @@ ms.assetid: 22aadb8c-7232-489d-a3ad-60662dda30a8 --- # Compiler Error C2812 -> \#import is not supported with /clr:pure and /clr:safe +> #import is not supported with /clr:pure and /clr:safe ## Remarks diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md index a9ae15d2023..9b03c798820 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md @@ -8,7 +8,7 @@ ms.assetid: 6cf2135f-7b82-42d1-909a-5e864308a09c --- # Compiler Error C2813 -\#import is not supported with /MP +> #import is not supported with /MP C2813 is emitted if in a compiler command you specify the **/MP** compiler option and two or more files to compile, and one or more of the files contains the[#import](../../preprocessor/hash-import-directive-cpp.md) preprocessor directive. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive generates C++ classes from the types in the specified type library, and then writes those classes to two header files. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive is not supported because if multiple compilation units import the same type library, those units conflict when they try to write the same header files at the same time. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md index 3c5b827f798..f36bf07bb6b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md @@ -8,7 +8,7 @@ ms.assetid: 7d165136-a08b-4497-a76d-60a21bb19404 --- # Compiler Error C2814 -'member' : a native type cannot be nested within a managed or WinRT type 'type' +> 'member' : a native type cannot be nested within a managed or WinRT type 'type' ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md index 8c0711ede95..eb56186f44c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md @@ -8,7 +8,7 @@ ms.assetid: d0256fd6-0721-4c99-b03c-52d96e77a613 --- # Compiler Error C2815 -'operator delete' : first formal parameter must be 'void *', but 'param' was used +> 'operator delete' : first formal parameter must be 'void *', but 'param' was used Any user-defined [operator delete](../../standard-library/new-operators.md#op_delete) function must take a first formal parameter of type `void *`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2817.md b/docs/error-messages/compiler-errors-2/compiler-error-c2817.md index b437cf9ca4e..c761a0d15e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2817.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2817.md @@ -8,6 +8,6 @@ ms.assetid: bca2e55a-8d86-4ddf-ba2b-4568f3bb776e --- # Compiler Error C2817 -return type for 'operator delete' must be 'void' +> return type for 'operator delete' must be 'void' An overloaded [operator delete](../../standard-library/new-operators.md#op_delete) function cannot return a value. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2818.md b/docs/error-messages/compiler-errors-2/compiler-error-c2818.md index 9ca58a16377..7ec868280df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2818.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2818.md @@ -8,6 +8,6 @@ ms.assetid: 715fc7c9-0c6d-452b-b7f5-1682cea5e907 --- # Compiler Error C2818 -application of overloaded 'operator ->' is recursive through type 'type' +> application of overloaded 'operator ->' is recursive through type 'type' A redefinition of the class member access operator contains a recursive **`return`** statement. To redefine the `->` operator with recursion, you must move the recursive routine to a separate function called from the operator override function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md index 7021fec040b..7097af1f7e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md @@ -8,7 +8,7 @@ ms.assetid: fcc7762d-cb82-4bb1-a715-0d82da832edf --- # Compiler Error C2819 -type 'type' does not have an overloaded member 'operator ->' +> type 'type' does not have an overloaded member 'operator ->' You need to define `operator->()` to use this pointer operation. From 3a348b39d518d63604497f0ded652a3e745b5552 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 23:07:04 +0800 Subject: [PATCH 0668/1799] Add "Remarks" and "Example" headings for error references in range [C2791, C2820] --- .../compiler-errors-2/compiler-error-c2791.md | 4 ++++ .../compiler-errors-2/compiler-error-c2792.md | 4 ++++ .../compiler-errors-2/compiler-error-c2793.md | 4 ++++ .../compiler-errors-2/compiler-error-c2794.md | 4 ++++ .../compiler-errors-2/compiler-error-c2795.md | 2 ++ .../compiler-errors-2/compiler-error-c2797.md | 4 ++++ .../compiler-errors-2/compiler-error-c2798.md | 4 ++++ .../compiler-errors-2/compiler-error-c2800.md | 4 ++++ .../compiler-errors-2/compiler-error-c2801.md | 4 ++++ .../compiler-errors-2/compiler-error-c2802.md | 4 ++++ .../compiler-errors-2/compiler-error-c2803.md | 4 ++++ .../compiler-errors-2/compiler-error-c2804.md | 2 ++ .../compiler-errors-2/compiler-error-c2805.md | 4 ++++ .../compiler-errors-2/compiler-error-c2806.md | 4 ++++ .../compiler-errors-2/compiler-error-c2807.md | 4 ++++ .../compiler-errors-2/compiler-error-c2808.md | 4 ++++ .../compiler-errors-2/compiler-error-c2809.md | 4 ++++ .../compiler-errors-2/compiler-error-c2810.md | 4 ++++ .../compiler-errors-2/compiler-error-c2811.md | 4 ++++ .../compiler-errors-2/compiler-error-c2813.md | 2 ++ .../compiler-errors-2/compiler-error-c2814.md | 6 +++++- .../compiler-errors-2/compiler-error-c2815.md | 4 ++++ .../compiler-errors-2/compiler-error-c2817.md | 2 ++ .../compiler-errors-2/compiler-error-c2818.md | 2 ++ .../compiler-errors-2/compiler-error-c2819.md | 4 ++++ 25 files changed, 91 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md index 2e8be8fd0ac..b52eaf7f9e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md @@ -10,8 +10,12 @@ ms.assetid: 938ad1fb-75d9-4ce2-ad92-83d6249005b5 > illegal use of 'super': 'class' does not have any base classes +## Remarks + The keyword [super](../../cpp/super.md) was used within the context of a member function of a class that does not have any base classes. +## Example + The following sample generates C2791: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md index 66551ace49d..64ef8884067 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md @@ -10,8 +10,12 @@ ms.assetid: 392cf748-4f5e-4e62-a364-3118d5658408 > 'super' : this keyword must be followed by '::' +## Remarks + The only token that can follow the keyword **`__super`** is `::`. +## Example + The following sample generates C2792: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md index 5dae54a4c6b..29e19899540 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md @@ -10,8 +10,12 @@ ms.assetid: ce35f4e8-c357-40ca-95c4-15ff001ad69d > 'token' : unexpected token following '::', identifier or keyword 'operator' expected +## Remarks + The only tokens that can follow `__super::` are an identifier or the keyword **`operator`**. +## Example + The following sample generates C2793 ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md index 84d3c0d9510..5815f9ea10e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md @@ -10,8 +10,12 @@ ms.assetid: d508191c-9044-4c6a-9119-4bca668c0b93 > 'function' : is not a member of any direct or indirect base class of 'class' +## Remarks + You tried to use [super](../../cpp/super.md) to call a nonexistent member function. +## Example + The following sample generates C2794 ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2795.md b/docs/error-messages/compiler-errors-2/compiler-error-c2795.md index 450f10004bd..15dec9d6f75 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2795.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2795.md @@ -10,4 +10,6 @@ ms.assetid: 8cd8c7fe-2add-4871-85f7-9a6afe4ac588 > 'super::function' is not a member function +## Remarks + This error message appears whenever you try to use [super](../../cpp/super.md) to access a member other than a member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md index eb500a79487..52e3d27661b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2797"] > (Obsolete) List initialization inside member initializer list or non-static data member initializer is not implemented. +## Remarks + This warning is obsolete in Visual Studio 2015. In Visual Studio 2013 and earlier versions, the Microsoft C++ compiler does not implement list initialization inside either a member initializer list or a non-static data member initializer. Before Visual Studio 2013 Update 3, this was silently converted to a function call, which could lead to bad code generation. Visual Studio 2013 Update 3 reports this as an error. +## Examples + This example generates C2797: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md index 59872836d79..e6fa2b88c77 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md @@ -10,12 +10,16 @@ ms.assetid: fb0cd861-b228-4f81-8090-e28344a727e0 > 'super::member' is ambiguous +## Remarks + Multiple inherited structures contain the member you referenced with [super](../../cpp/super.md). You could fix the error by either: - Removing B1 or B2 from the inheritance list of D. - Changing the name of the data member in B1 or B2. +## Example + The following sample generates C2798: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md index 87a4ad83f59..2aabb83172b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md @@ -10,8 +10,12 @@ ms.assetid: a2f1a590-9fe6-44cb-ad09-b4505ef47c6a > 'operator operator' cannot be overloaded +## Remarks + The following operators cannot be overloaded: class member access (`.`), pointer to member (`.*`), scope resolution (`::`), conditional expression (`? :`), and **`sizeof`**. +## Example + The following sample generates C2800: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md index 6dccb3d9c49..950e71782c2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md @@ -10,6 +10,8 @@ ms.assetid: 35dfc7ea-9e37-4e30-baa1-944dc61302f5 > 'operator operator' must be a non-static member +## Remarks + The following operators can be overloaded only as nonstatic members: - Assignment `=` @@ -26,6 +28,8 @@ Possible C2801 causes: - Overloaded operator is declared **`static`**. +## Example + - The following sample generates C2801: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md index b34e3185d0c..498d17fa992 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md @@ -10,8 +10,12 @@ ms.assetid: 08b68c0e-9382-40ac-8949-39a7a2749e05 > static member 'operator operator' has no formal parameters +## Remarks + An operator declared by a **`static`** member function must have at least one parameter. +## Example + The following sample generates C2802: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md index a6740105639..2973de86407 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md @@ -10,12 +10,16 @@ ms.assetid: 2cdbe374-8cc4-4c4e-ba15-062a7479e937 > 'operator operator' must have at least one formal parameter of class type +## Remarks + The overloaded operator lacks a parameter of class type. You need to pass at least one parameter by reference (not using pointers, but references) or by value to be able to write "a < b" (a and b being of type class A). If both parameters are pointers it will be a pure comparison of pointer addresses and will not use the user-defined conversion. +## Example + The following sample generates C2803: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md index 2c9c5eb059f..6b793413bd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md @@ -10,6 +10,8 @@ ms.assetid: b066e563-cca4-450c-8ba7-3b0d7a89f3ea > binary 'operator operator' has too many parameters +## Remarks + The overloaded binary operator member function is declared with more than one parameter. The first operand parameter of a binary operator member function, whose type is the operator's enclosing type, is implied. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md index 6087550629c..28c5ac4d3b3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md @@ -10,8 +10,12 @@ ms.assetid: c997dc56-e199-442f-b94e-ac551ec9b015 > binary 'operator operator' has too few parameters +## Remarks + The binary operator has no parameters. +## Example + The following sample generates C2805: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md index 1a9de42a832..181ae38d06d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md @@ -10,8 +10,12 @@ ms.assetid: 7c9ff1f4-1590-4c47-991d-b1075a173b48 > 'operator operator' has too many formal parameters +## Remarks + An overloaded operator has too many parameters. +## Example + The following sample generates C2806: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md index 4b3e19020ce..a9e7d370788 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md @@ -10,8 +10,12 @@ ms.assetid: bd7a207a-f379-4de6-8ee8-c7cab78b3480 > the second formal parameter to postfix 'operator operator' must be 'int' +## Remarks + The second parameter to a postfix operator has the wrong type. +## Example + The following sample generates C2807: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md index cbe6f7eb7ac..e848831c4d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md @@ -10,8 +10,12 @@ ms.assetid: 3d745102-d3b3-4735-a7d2-ad42d5bf3cfa > unary 'operator operator' has too many formal parameters +## Remarks + The unary operator has a nonvoid parameter list. +## Example + The following sample generates C2808: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md index a466d2942b9..c03af503d65 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md @@ -10,8 +10,12 @@ ms.assetid: ce796b8e-1a8c-4074-995d-1ad09afd0e93 > 'operator operator' has no formal parameters +## Remarks + The operator lacks required parameters. +## Example + The following sample generates C2809: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md index 0c86142cd51..a112f602b5c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md @@ -10,8 +10,12 @@ ms.assetid: f63e8f24-d7f6-42ac-904f-72ff49592ba6 > 'interface' : an interface can only inherit from another interface +## Remarks + An [interface](../../cpp/interface.md) may only inherit from another interface and may not inherit from a class or struct. +## Example + The following sample generates C2810: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md index 3b58e730a58..b324304127f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md @@ -10,8 +10,12 @@ ms.assetid: 6a44b18e-44c1-49d8-9b99-e0545b9a6e7d > 'type1' : cannot inherit from 'type2', a ref class can only inherit from a ref class or interface class +## Remarks + You attempted to use an unmanaged class as a base class for a managed class. +## Example + The following sample generates C2811: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md index 9b03c798820..8aadad43dc6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md @@ -10,6 +10,8 @@ ms.assetid: 6cf2135f-7b82-42d1-909a-5e864308a09c > #import is not supported with /MP +## Remarks + C2813 is emitted if in a compiler command you specify the **/MP** compiler option and two or more files to compile, and one or more of the files contains the[#import](../../preprocessor/hash-import-directive-cpp.md) preprocessor directive. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive generates C++ classes from the types in the specified type library, and then writes those classes to two header files. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive is not supported because if multiple compilation units import the same type library, those units conflict when they try to write the same header files at the same time. This compiler error and the **/MP** compiler option are new in Visual Studio 2008. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md index f36bf07bb6b..4911a4b37b2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md @@ -10,9 +10,13 @@ ms.assetid: 7d165136-a08b-4497-a76d-60a21bb19404 > 'member' : a native type cannot be nested within a managed or WinRT type 'type' +## Remarks + +A native type cannot be nested in a CLR or WinRT type. + ## Example -A native type cannot be nested in a CLR or WinRT type. The following sample generates C2814 and shows how to fix it. +The following sample generates C2814 and shows how to fix it. ```cpp // C2814.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md index eb56186f44c..7c2434adb18 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md @@ -10,8 +10,12 @@ ms.assetid: d0256fd6-0721-4c99-b03c-52d96e77a613 > 'operator delete' : first formal parameter must be 'void *', but 'param' was used +## Remarks + Any user-defined [operator delete](../../standard-library/new-operators.md#op_delete) function must take a first formal parameter of type `void *`. +## Example + The following sample generates C2815: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2817.md b/docs/error-messages/compiler-errors-2/compiler-error-c2817.md index c761a0d15e6..fb666f45e8a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2817.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2817.md @@ -10,4 +10,6 @@ ms.assetid: bca2e55a-8d86-4ddf-ba2b-4568f3bb776e > return type for 'operator delete' must be 'void' +## Remarks + An overloaded [operator delete](../../standard-library/new-operators.md#op_delete) function cannot return a value. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2818.md b/docs/error-messages/compiler-errors-2/compiler-error-c2818.md index 7ec868280df..0ba151fad22 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2818.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2818.md @@ -10,4 +10,6 @@ ms.assetid: 715fc7c9-0c6d-452b-b7f5-1682cea5e907 > application of overloaded 'operator ->' is recursive through type 'type' +## Remarks + A redefinition of the class member access operator contains a recursive **`return`** statement. To redefine the `->` operator with recursion, you must move the recursive routine to a separate function called from the operator override function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md index 7097af1f7e2..909ade2ad12 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md @@ -10,8 +10,12 @@ ms.assetid: fcc7762d-cb82-4bb1-a715-0d82da832edf > type 'type' does not have an overloaded member 'operator ->' +## Remarks + You need to define `operator->()` to use this pointer operation. +## Examples + The following sample generates C2819: ```cpp From 24d64541c12c47083cfd6b03c9f1b4d41128b91e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 23:08:38 +0800 Subject: [PATCH 0669/1799] Replace term "sample" with "example" for error references in range [C2791, C2820] --- docs/error-messages/compiler-errors-2/compiler-error-c2791.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2792.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2793.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2794.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2798.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2800.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2801.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2802.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2803.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2804.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2805.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2806.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2807.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2808.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2809.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2810.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2811.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2812.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2813.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2814.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2815.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2819.md | 4 ++-- 22 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md index b52eaf7f9e9..4849b3bcf26 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md @@ -16,7 +16,7 @@ The keyword [super](../../cpp/super.md) was used within the context of a member ## Example -The following sample generates C2791: +The following example generates C2791: ```cpp // C2791.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md index 64ef8884067..593b74c1bf4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md @@ -16,7 +16,7 @@ The only token that can follow the keyword **`__super`** is `::`. ## Example -The following sample generates C2792: +The following example generates C2792: ```cpp // C2792.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md index 29e19899540..f757185249c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md @@ -16,7 +16,7 @@ The only tokens that can follow `__super::` are an identifier or the keyword **` ## Example -The following sample generates C2793 +The following example generates C2793 ```cpp // C2793.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md index 5815f9ea10e..5264c870804 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md @@ -16,7 +16,7 @@ You tried to use [super](../../cpp/super.md) to call a nonexistent member functi ## Example -The following sample generates C2794 +The following example generates C2794 ```cpp // C2794.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md index e6fa2b88c77..5410bf1f29e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md @@ -20,7 +20,7 @@ Multiple inherited structures contain the member you referenced with [super](../ ## Example -The following sample generates C2798: +The following example generates C2798: ```cpp // C2798.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md index 2aabb83172b..52998d44890 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md @@ -16,7 +16,7 @@ The following operators cannot be overloaded: class member access (`.`), pointer ## Example -The following sample generates C2800: +The following example generates C2800: ```cpp // C2800.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md index 950e71782c2..4babfb303ae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md @@ -30,7 +30,7 @@ Possible C2801 causes: ## Example -- The following sample generates C2801: +- The following example generates C2801: ```cpp // C2801.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md index 498d17fa992..f56e0e1cf19 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md @@ -16,7 +16,7 @@ An operator declared by a **`static`** member function must have at least one pa ## Example -The following sample generates C2802: +The following example generates C2802: ```cpp // C2802.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md index 2973de86407..d2b54635236 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md @@ -20,7 +20,7 @@ If both parameters are pointers it will be a pure comparison of pointer addresse ## Example -The following sample generates C2803: +The following example generates C2803: ```cpp // C2803.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md index 6b793413bd4..a7c5a3281e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md @@ -16,7 +16,7 @@ The overloaded binary operator member function is declared with more than one pa ## Examples -The following sample generates C2804 and shows how to fix it. +The following example generates C2804 and shows how to fix it. ```cpp // C2804.cpp @@ -33,7 +33,7 @@ int main() { } ``` -The following sample generates C2804 and shows how to fix it. +The following example generates C2804 and shows how to fix it. ```cpp // C2804_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md index 28c5ac4d3b3..1e769dda1e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md @@ -16,7 +16,7 @@ The binary operator has no parameters. ## Example -The following sample generates C2805: +The following example generates C2805: ```cpp // C2805.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md index 181ae38d06d..dec2cfa9a4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md @@ -16,7 +16,7 @@ An overloaded operator has too many parameters. ## Example -The following sample generates C2806: +The following example generates C2806: ```cpp // C2806.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md index a9e7d370788..9b29d9d0067 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md @@ -16,7 +16,7 @@ The second parameter to a postfix operator has the wrong type. ## Example -The following sample generates C2807: +The following example generates C2807: ```cpp // C2807.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md index e848831c4d2..8f8a6210767 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md @@ -16,7 +16,7 @@ The unary operator has a nonvoid parameter list. ## Example -The following sample generates C2808: +The following example generates C2808: ```cpp // C2808.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md index c03af503d65..f7871e1efd7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md @@ -16,7 +16,7 @@ The operator lacks required parameters. ## Example -The following sample generates C2809: +The following example generates C2809: ```cpp // C2809.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md index a112f602b5c..41cba66bcde 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md @@ -16,7 +16,7 @@ An [interface](../../cpp/interface.md) may only inherit from another interface a ## Example -The following sample generates C2810: +The following example generates C2810: ```cpp // C2810.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md index b324304127f..a611e8e333f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md @@ -16,7 +16,7 @@ You attempted to use an unmanaged class as a base class for a managed class. ## Example -The following sample generates C2811: +The following example generates C2811: ```cpp // C2811.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2812.md b/docs/error-messages/compiler-errors-2/compiler-error-c2812.md index a9f6938643a..de8b1557887 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2812.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2812.md @@ -18,7 +18,7 @@ The **/clr:pure** and **/clr:safe** compiler options are deprecated in Visual St ## Example -The following sample generates C2812. +The following example generates C2812. ```cpp // C2812.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md index 8aadad43dc6..e5bddc775fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md @@ -18,7 +18,7 @@ This compiler error and the **/MP** compiler option are new in Visual Studio 200 ## Example -The following sample generates C2813. The command line in the "compile with:" comment indicates to the compiler to use the **/MP** and **/c** compiler options to compile several files. At least one of the files contains the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. We use the same file twice for the sake of testing this example. +The following example generates C2813. The command line in the "compile with:" comment indicates to the compiler to use the **/MP** and **/c** compiler options to compile several files. At least one of the files contains the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. We use the same file twice for the sake of testing this example. ```cpp // C2813.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md index 4911a4b37b2..b61b5d7d671 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md @@ -16,7 +16,7 @@ A native type cannot be nested in a CLR or WinRT type. ## Example -The following sample generates C2814 and shows how to fix it. +The following example generates C2814 and shows how to fix it. ```cpp // C2814.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md index 7c2434adb18..209ef0d1f4c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md @@ -16,7 +16,7 @@ Any user-defined [operator delete](../../standard-library/new-operators.md#op_de ## Example -The following sample generates C2815: +The following example generates C2815: ```cpp // C2815.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md index 909ade2ad12..4f6af3a8f60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md @@ -16,7 +16,7 @@ You need to define `operator->()` to use this pointer operation. ## Examples -The following sample generates C2819: +The following example generates C2819: ```cpp // C2819.cpp @@ -46,7 +46,7 @@ void F(D j) { } ``` -C2819 can also occur when using [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). The following sample generates C2819: +C2819 can also occur when using [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). The following example generates C2819: ```cpp // C2819_b.cpp From 2e189f890516ff638e9f0405c92c9e3e578ba67b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 23:12:57 +0800 Subject: [PATCH 0670/1799] Update metadata for error references in range [C2791, C2820] --- .../error-messages/compiler-errors-2/compiler-error-c2791.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2792.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2793.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2794.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2795.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2798.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2800.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2801.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2802.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2803.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2804.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2805.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2806.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2807.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2808.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2809.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2810.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2811.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2812.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2813.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2814.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2815.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2817.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2818.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2819.md | 5 ++--- 25 files changed, 50 insertions(+), 75 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md index 4849b3bcf26..24de65980a5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2791" title: "Compiler Error C2791" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2791" +ms.date: 11/04/2016 f1_keywords: ["C2791"] helpviewer_keywords: ["C2791"] -ms.assetid: 938ad1fb-75d9-4ce2-ad92-83d6249005b5 --- # Compiler Error C2791 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md index 593b74c1bf4..5503da07a8e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2792" title: "Compiler Error C2792" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2792" +ms.date: 11/04/2016 f1_keywords: ["C2792"] helpviewer_keywords: ["C2792"] -ms.assetid: 392cf748-4f5e-4e62-a364-3118d5658408 --- # Compiler Error C2792 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md index f757185249c..3581467aef3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2793" title: "Compiler Error C2793" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2793" +ms.date: 11/04/2016 f1_keywords: ["C2793"] helpviewer_keywords: ["C2793"] -ms.assetid: ce35f4e8-c357-40ca-95c4-15ff001ad69d --- # Compiler Error C2793 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md index 5264c870804..72657858861 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2794" title: "Compiler Error C2794" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2794" +ms.date: 11/04/2016 f1_keywords: ["C2794"] helpviewer_keywords: ["C2794"] -ms.assetid: d508191c-9044-4c6a-9119-4bca668c0b93 --- # Compiler Error C2794 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2795.md b/docs/error-messages/compiler-errors-2/compiler-error-c2795.md index 15dec9d6f75..1505d3af111 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2795.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2795.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2795" title: "Compiler Error C2795" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2795" +ms.date: 11/04/2016 f1_keywords: ["C2795"] helpviewer_keywords: ["C2795"] -ms.assetid: 8cd8c7fe-2add-4871-85f7-9a6afe4ac588 --- # Compiler Error C2795 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md index 5410bf1f29e..5e5d7754190 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2798" title: "Compiler Error C2798" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2798" +ms.date: 11/04/2016 f1_keywords: ["C2798"] helpviewer_keywords: ["C2798"] -ms.assetid: fb0cd861-b228-4f81-8090-e28344a727e0 --- # Compiler Error C2798 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md index 52998d44890..7de01cf11dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2800" title: "Compiler Error C2800" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2800" +ms.date: 11/04/2016 f1_keywords: ["C2800"] helpviewer_keywords: ["C2800"] -ms.assetid: a2f1a590-9fe6-44cb-ad09-b4505ef47c6a --- # Compiler Error C2800 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md index 4babfb303ae..1fc1d35138c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2801" title: "Compiler Error C2801" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2801" +ms.date: 11/04/2016 f1_keywords: ["C2801"] helpviewer_keywords: ["C2801"] -ms.assetid: 35dfc7ea-9e37-4e30-baa1-944dc61302f5 --- # Compiler Error C2801 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md index f56e0e1cf19..d7920ab5bd3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2802" title: "Compiler Error C2802" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2802" +ms.date: 11/04/2016 f1_keywords: ["C2802"] helpviewer_keywords: ["C2802"] -ms.assetid: 08b68c0e-9382-40ac-8949-39a7a2749e05 --- # Compiler Error C2802 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md index d2b54635236..56585a0492d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2803" title: "Compiler Error C2803" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2803" +ms.date: 11/04/2016 f1_keywords: ["C2803"] helpviewer_keywords: ["C2803"] -ms.assetid: 2cdbe374-8cc4-4c4e-ba15-062a7479e937 --- # Compiler Error C2803 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md index a7c5a3281e6..6837c7650c2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2804" title: "Compiler Error C2804" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2804" +ms.date: 11/04/2016 f1_keywords: ["C2804"] helpviewer_keywords: ["C2804"] -ms.assetid: b066e563-cca4-450c-8ba7-3b0d7a89f3ea --- # Compiler Error C2804 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md index 1e769dda1e2..219a8c8d65b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2805" title: "Compiler Error C2805" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2805" +ms.date: 11/04/2016 f1_keywords: ["C2805"] helpviewer_keywords: ["C2805"] -ms.assetid: c997dc56-e199-442f-b94e-ac551ec9b015 --- # Compiler Error C2805 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md index dec2cfa9a4f..84ff0db1dfa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2806" title: "Compiler Error C2806" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2806" +ms.date: 11/04/2016 f1_keywords: ["C2806"] helpviewer_keywords: ["C2806"] -ms.assetid: 7c9ff1f4-1590-4c47-991d-b1075a173b48 --- # Compiler Error C2806 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md index 9b29d9d0067..eda69103326 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2807" title: "Compiler Error C2807" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2807" +ms.date: 11/04/2016 f1_keywords: ["C2807"] helpviewer_keywords: ["C2807"] -ms.assetid: bd7a207a-f379-4de6-8ee8-c7cab78b3480 --- # Compiler Error C2807 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md index 8f8a6210767..7a2df195342 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2808" title: "Compiler Error C2808" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2808" +ms.date: 11/04/2016 f1_keywords: ["C2808"] helpviewer_keywords: ["C2808"] -ms.assetid: 3d745102-d3b3-4735-a7d2-ad42d5bf3cfa --- # Compiler Error C2808 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md index f7871e1efd7..e99316b66eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2809" title: "Compiler Error C2809" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2809" +ms.date: 11/04/2016 f1_keywords: ["C2809"] helpviewer_keywords: ["C2809"] -ms.assetid: ce796b8e-1a8c-4074-995d-1ad09afd0e93 --- # Compiler Error C2809 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md index 41cba66bcde..822e5b9de74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2810" title: "Compiler Error C2810" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2810" +ms.date: 11/04/2016 f1_keywords: ["C2810"] helpviewer_keywords: ["C2810"] -ms.assetid: f63e8f24-d7f6-42ac-904f-72ff49592ba6 --- # Compiler Error C2810 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md index a611e8e333f..e10b1d0ebea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2811" title: "Compiler Error C2811" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2811" +ms.date: 11/04/2016 f1_keywords: ["C2811"] helpviewer_keywords: ["C2811"] -ms.assetid: 6a44b18e-44c1-49d8-9b99-e0545b9a6e7d --- # Compiler Error C2811 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2812.md b/docs/error-messages/compiler-errors-2/compiler-error-c2812.md index de8b1557887..247df73f444 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2812.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2812.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2812" title: "Compiler Error C2812" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2812" +ms.date: 11/04/2016 f1_keywords: ["C2812"] helpviewer_keywords: ["C2812"] -ms.assetid: 22aadb8c-7232-489d-a3ad-60662dda30a8 --- # Compiler Error C2812 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md index e5bddc775fc..ac5acab6159 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2813" title: "Compiler Error C2813" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2813" +ms.date: 11/04/2016 f1_keywords: ["C2813"] helpviewer_keywords: ["C2813"] -ms.assetid: 6cf2135f-7b82-42d1-909a-5e864308a09c --- # Compiler Error C2813 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md index b61b5d7d671..a34fc692a4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2814" title: "Compiler Error C2814" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2814" +ms.date: 11/04/2016 f1_keywords: ["C2814"] helpviewer_keywords: ["C2814"] -ms.assetid: 7d165136-a08b-4497-a76d-60a21bb19404 --- # Compiler Error C2814 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md index 209ef0d1f4c..d4e855253e4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2815" title: "Compiler Error C2815" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2815" +ms.date: 11/04/2016 f1_keywords: ["C2815"] helpviewer_keywords: ["C2815"] -ms.assetid: d0256fd6-0721-4c99-b03c-52d96e77a613 --- # Compiler Error C2815 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2817.md b/docs/error-messages/compiler-errors-2/compiler-error-c2817.md index fb666f45e8a..24c59040cf3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2817.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2817.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2817" title: "Compiler Error C2817" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2817" +ms.date: 11/04/2016 f1_keywords: ["C2817"] helpviewer_keywords: ["C2817"] -ms.assetid: bca2e55a-8d86-4ddf-ba2b-4568f3bb776e --- # Compiler Error C2817 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2818.md b/docs/error-messages/compiler-errors-2/compiler-error-c2818.md index 0ba151fad22..88373838771 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2818.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2818.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2818" title: "Compiler Error C2818" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2818" +ms.date: 11/04/2016 f1_keywords: ["C2818"] helpviewer_keywords: ["C2818"] -ms.assetid: 715fc7c9-0c6d-452b-b7f5-1682cea5e907 --- # Compiler Error C2818 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md index 4f6af3a8f60..063bf1c863a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2819" title: "Compiler Error C2819" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2819" +ms.date: 11/04/2016 f1_keywords: ["C2819"] helpviewer_keywords: ["C2819"] -ms.assetid: fcc7762d-cb82-4bb1-a715-0d82da832edf --- # Compiler Error C2819 From b42a72c57e5ceb90b5f7c45239c081f41d18a081 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 23:29:38 +0800 Subject: [PATCH 0671/1799] Add missing integer argument to `_cprintf_s` call for example in `_vcprintf_p` reference --- .../vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md index 99103757608..e663b4c13b2 100644 --- a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md @@ -112,7 +112,7 @@ int main() { int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n", "one", 222); - _cprintf_s("%d characters printed\r\n"); + _cprintf_s("%d characters printed\r\n", n); } ``` From 49044a62fa79d97d0e3aad2d251cfea50437aebb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 23:37:07 +0800 Subject: [PATCH 0672/1799] Add backticks in `_vcprintf_p` reference --- ...cprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md index e663b4c13b2..55c2eae6a83 100644 --- a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md @@ -62,7 +62,7 @@ Each of these functions takes a pointer to an argument list, and then uses the ` The versions of these functions that have the `_l` suffix are identical except that they use the locale parameter that's passed in instead of the current locale. -Each *`argument`* (if any) is converted and is output according to the corresponding format specification in *`format`*. The format specification supports positional parameters so that you can specify the order in which the arguments are used in the format string. For more information, see [printf_p Positional Parameters](../printf-p-positional-parameters.md). +Each *`argument`* (if any) is converted and is output according to the corresponding format specification in *`format`*. The format specification supports positional parameters so that you can specify the order in which the arguments are used in the format string. For more information, see [`printf_p` Positional Parameters](../printf-p-positional-parameters.md). These functions don't translate line-feed characters on output into carriage return-line feed (CR-LF) combinations. @@ -73,7 +73,7 @@ These functions validate the input pointer and the format string. If *`format`* ### Generic-text routine mappings -| Tchar.h routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | +| `Tchar.h` routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| | `_vtcprintf_p` | **`_vcprintf_p`** | **`_vcprintf_p`** | **`_vcwprintf_p`** | | `_vtcprintf_p_l` | **`_vcprintf_p_l`** | **`_vcprintf_p_l`** | **`_vcwprintf_p_l`** | @@ -82,8 +82,8 @@ These functions validate the input pointer and the format string. If *`format`* | Routine | Required header | |---|---| -| **`_vcprintf_p`**, **`_vcprintf_p_l`** | \ and \ | -| **`_vcwprintf_p`**, **`_vcwprintf_p_l`** | \ and \ | +| **`_vcprintf_p`**, **`_vcprintf_p_l`** | `` and `` | +| **`_vcwprintf_p`**, **`_vcwprintf_p_l`** | `` and `` | For more compatibility information, see [Compatibility](../compatibility.md). @@ -126,4 +126,4 @@ parameter 2 = 222; parameter 1 = one [Console and port I/O](../console-and-port-i-o.md)\ [`_cprintf`, `_cprintf_l`, `_cwprintf`, `_cwprintf_l`](cprintf-cprintf-l-cwprintf-cwprintf-l.md)\ [`va_arg`, `va_copy`, `va_end`, `va_start`](va-arg-va-copy-va-end-va-start.md)\ -[printf_p Positional Parameters](../printf-p-positional-parameters.md) +[`printf_p` Positional Parameters](../printf-p-positional-parameters.md) From f4836970b7a37530a935f7d0d761af8432f09cef Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 23:38:42 +0800 Subject: [PATCH 0673/1799] Update link text to "`printf_p` positional parameters" in `_vcprintf_p` reference --- .../vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md index 55c2eae6a83..870ad99d11e 100644 --- a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md @@ -62,7 +62,7 @@ Each of these functions takes a pointer to an argument list, and then uses the ` The versions of these functions that have the `_l` suffix are identical except that they use the locale parameter that's passed in instead of the current locale. -Each *`argument`* (if any) is converted and is output according to the corresponding format specification in *`format`*. The format specification supports positional parameters so that you can specify the order in which the arguments are used in the format string. For more information, see [`printf_p` Positional Parameters](../printf-p-positional-parameters.md). +Each *`argument`* (if any) is converted and is output according to the corresponding format specification in *`format`*. The format specification supports positional parameters so that you can specify the order in which the arguments are used in the format string. For more information, see [`printf_p` positional parameters](../printf-p-positional-parameters.md). These functions don't translate line-feed characters on output into carriage return-line feed (CR-LF) combinations. @@ -126,4 +126,4 @@ parameter 2 = 222; parameter 1 = one [Console and port I/O](../console-and-port-i-o.md)\ [`_cprintf`, `_cprintf_l`, `_cwprintf`, `_cwprintf_l`](cprintf-cprintf-l-cwprintf-cwprintf-l.md)\ [`va_arg`, `va_copy`, `va_end`, `va_start`](va-arg-va-copy-va-end-va-start.md)\ -[`printf_p` Positional Parameters](../printf-p-positional-parameters.md) +[`printf_p` positional parameters](../printf-p-positional-parameters.md) From a0ac6efce9368468bed245f36ba41308068915b1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 8 Aug 2025 23:41:23 +0800 Subject: [PATCH 0674/1799] Normalize example indent to 4 spaces in `_vcprintf_p` reference --- ...f-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md index 870ad99d11e..04735adbee7 100644 --- a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md @@ -101,18 +101,18 @@ For more compatibility information, see [Compatibility](../compatibility.md). // An error formatting function that's used to print to the console. int eprintf(const char* format, ...) { - va_list args; - va_start(args, format); - int result = _vcprintf_p(format, args); - va_end(args); - return result; + va_list args; + va_start(args, format); + int result = _vcprintf_p(format, args); + va_end(args); + return result; } int main() { - int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n", - "one", 222); - _cprintf_s("%d characters printed\r\n", n); + int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n", + "one", 222); + _cprintf_s("%d characters printed\r\n", n); } ``` From d3cae2280eef22307696dd0611fcf41422115eff Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 8 Aug 2025 10:06:48 -0700 Subject: [PATCH 0675/1799] Add ASan Runtime Options Page --- docs/sanitizers/asan-flags.md | 132 ++++++++++++++++++++++++++++++++ docs/sanitizers/asan-runtime.md | 2 +- 2 files changed, 133 insertions(+), 1 deletion(-) create mode 100644 docs/sanitizers/asan-flags.md diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md new file mode 100644 index 00000000000..04e3774c362 --- /dev/null +++ b/docs/sanitizers/asan-flags.md @@ -0,0 +1,132 @@ +--- +title: "AddressSanitizer Runtime Options" +description: "List of runtime options for the Microsoft C/C++ Address Sanitizer" +ms.date: 8/05/2025 +helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Address Sanitizer options", "Address Sanitizer flags", "asan options", "asan flags", "sanitizer flags", "asan_options", "AddressSanitizerFlags", "CommonSanitizerFlags"] +--- + +# AddressSanitizer Runtime Options + +The following is a list of supported runtime options that can be set by the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function. Reference: [AddressSanitizer Runtime Options](./asan-runtime.md#runtime-options). Note that while these mirror the options available in Clang's ASan, the description will differ by varying amounts in consideration of the MSVC ASan runtime. + +This is a living document that may update at any time due to the constant development of AddressSanitizer on the Windows platform. If you discover options that aren't accurately documented, we invite you to [report a bug](https://aka.ms/feedback/report?space=62). + +| Flag | Default value | Description | +|:-----|:--------------|:------------| +|abort_on_error | false | If true, the tool calls `abort()` instead of `_exit()` after printing the error report.| +|alloc_dealloc_mismatch | false | Enables runtime detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| +|allocator_frees_and_returns_null_on_realloc_zero | 1 | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| +|allocator_may_return_null | false | If true, the allocator will return `nullptr` and fail when out of memory instead of crashing.| +|allocator_release_to_os_interval_ms | -1 | Experimental. 64-bit allocator only. Specify minimum time interval in ms between attempts to release memory | +|allow_addr2line | false | If true, the tool uses the `addr2line` binary to symbolize stack traces when `llvm-symbolizer` is not available.| +|allow_user_poisoning | true | If true, user may manually mark memory regions as poisoned or unpoisoned.| +|atexit | false | If true, prints ASan exit stats even after program terminates successfully.| +|can_use_proc_maps_statm | true | If false, do not attempt to read `/proc/maps/statm`. Mostly useful for testing sanitizers. (Not implemented - `/proc/maps/statm` doesn't exist on Windows)| +|check_initialization_order | false | If true, attempts to catch initialization order issues.| +|check_malloc_usable_size | true | Allows the users to work around the bug in Nvidia drivers prior to 295.*.| +|check_printf | true | If true, enables ASan to validate printf family function arguments for memory safety violations.| +|clear_shadow_mmap_threshold | 64 * 1024 | Large shadow regions are zero-filled using `mmap(NORESERVE)` instead of `memset()`. This is the threshold size in bytes. (Not Implemented - `memset()` is always called on Windows)| +|color | auto | Colorize reports: (always|never|auto). (Not Implemented on Windows)| +|continue_on_error | 0 | Allows an application to continue running while reporting unique memory safety errors. 0 - disabled, 1 - stderr(1), 2 - stderr(2). See [continue_on_error](asan-continue-on-error.md).| +|coverage | false | If true, coverage information will be dumped at program shutdown (if the coverage instrumentation was enabled at compile time).| +|coverage_bitset | false | If true (and if 'coverage' is set too), the coverage information will also be dumped as a bitset to a separate file.| +|coverage_counters | false | If true (and if 'coverage' is set too), the bitmap that corresponds to coverage counters will be dumped.| +|coverage_dir | "." | Target directory for coverage dumps. Defaults to the current directory.| +|coverage_direct | false (true on Android) | If true, coverage information will be dumped directly to a memory mapped file. This way data is not lost even if the process is suddenly killed.| +|coverage_order_pcs | false | If true, the PCs will be dumped in the order they've appeared during the execution.| +|coverage_pcs | true | If true (and if 'coverage' is set too), the coverage information will be dumped as a set of PC offsets for every module.| +|debug | false | If true, prints some debugging information and does additional checks.| +|decorate_proc_maps | false | If true, decorate sanitizer mappings in /proc/self/maps with user-readable names (Not Implemented - `/proc/self/maps` doesn't exist on Windows)| +|detect_container_overflow | true | If true, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md)| +|detect_deadlocks | true | If true, deadlock detection is enabled.| +|detect_invalid_pointer_pairs | 0 | If non-zero, try to detect operations like <, <=, >, >= and - on invalid pointer pairs (e.g. when pointers belong to different objects). The bigger the value the harder we try.| +|detect_leaks | true | Enable memory leak detection. (Not Implemented - LSan not implemented on Windows as of yet.)| +|detect_odr_violation | 2 | If >=2, detect violation of One-Definition-Rule (ODR); If 1, detect ODR-violation only if the two variables have different sizes| +|detect_stack_use_after_return | false | Enables stack-use-after-return checking at run-time. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md)| +|disable_coredump | true (false on non-64-bit systems) | Disable core dumping. By default, disable_coredump=1 on 64-bit to avoid dumping a 16T+ core file. Ignored on OSes that don't dump core by default and for sanitizers that don't reserve lots of virtual memory.| +|dump_instruction_bytes | false | If true, dump 16 bytes starting at the instruction that caused SEGV| +|exitcode | 1 | Override the program exit status if the tool found an error| +|external_symbolizer_path | "" | Path to external symbolizer. If empty, the tool will search $PATH for the symbolizer.| +|fast_unwind_on_check | false | If available, use the fast frame-pointer-based unwinder on internal CHECK failures.| +|fast_unwind_on_fatal | false | If available, use the fast frame-pointer-based unwinder on fatal errors.| +|fast_unwind_on_malloc | true | If available, use the fast frame-pointer-based unwinder on malloc/free.| +|full_address_space | false | Sanitize complete address space; by default kernel area on 32-bit platforms will not be sanitized| +|halt_on_error | true | Exit/abort the program after printing the first error report (May cause undefined behavior).| +|handle_abort | false | Controls custom tool's SIGABRT handler (Not Implemented on Windows) | +|handle_ioctl | false | Intercept and handle ioctl requests. (Not Implemented on Windows)| +|handle_segv | true | false - ASan will not handle SEGV errors, true - ASan handles SEGV errors.| +|handle_sigbus | true | Controls custom tool's SIGBUS handler (Not Implemented on Windows)| +|handle_sigfpe | true | false - ASan will not handle SIGFPE errors, true - ASan will handle SIGFPE errors. | +|handle_sigill | true | false - ASan will not handle SIGILL errors, true - ASan will handle SIGILL errors.| +|hard_rss_limit_mb | 0 | (Not Implemented on Windows) | +|heap_profile | false | (Not Implemented on Windows)| +|help | false | If true, ASan prints the flag options to console.| +|html_cov_report | false | If true, ASan generates a coverage report.| +|include | "" | read more options from the given file| +|include_if_exists | "" | read more options from the given file (if it exists)| +|intercept_memcmp | true | If true, uses custom wrappers for memcmp function to find more errors.| +|intercept_strpbrk | true | If true, uses custom wrappers for strpbrk function to find more errors.| +|intercept_strspn | true | If true, uses custom wrappers for strspn and strcspn function to find more errors.| +|intercept_strstr | true | If true, uses custom wrappers for strstr and strcasestr functions to find more errors.| +|intercept_tls_get_addr | false | Intercept __tls_get_addr.| +|leak_check_at_exit | true | Invoke leak checking in an atexit handler. Has no effect if detect_leaks=false, or if __lsan_do_leak_check() is called before the handler has a chance to run. (Not Implemented - LSan not implemented on Windows as of yet.)| +|legacy_pthread_cond | false | Enables support for dynamic libraries linked with libpthread 2.2.5. (Not Implemented on Windows)| +|log_exe_name | false | Mention name of executable when reporting error and append executable name to logs (as in `log_path.exe_name.pid`).| +|log_path | stderr | Write logs to `log_path.pid`. The special values are `stdout` and `stderr`. The default is `stderr`.| +|log_to_syslog | false | Write all sanitizer output to syslog in addition to other means of logging.| +|malloc_context_size | 1 | Max number of stack frames kept for each allocation/deallocation.| +|malloc_fill_byte | 0xbe | Value used to fill the newly allocated memory.| +|max_malloc_fill_size | 4096 | ASan allocator flag. `max_malloc_fill_size` is the maximal amount of bytes that will be filled with `malloc_fill_byte` on `malloc`.| +|max_redzone | 2048 | Maximal size (in bytes) of redzones around heap objects.| +|max_uar_stack_size_log | 20 | Maximum fake stack size log.| +|min_uar_stack_size_log | 16 | Minimum fake stack size log. (Cannot do smaller than 16)| +|mmap_limit_mb | 0 | Limit the amount of mmap-ed memory (excluding shadow) in Mb; (Not Implemented on Windows) | +|new_delete_type_mismatch | true | Report errors on mismatch betwen size of new and delete. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md)| +|no_huge_pages_for_shadow | true | If true, the shadow is not allowed to use huge pages. (Not Implemented on Windows) | +|poison_array_cookie | true | Poison (or not) the array cookie after operator `new[]`.| +|poison_heap | true | Poison (or not) the heap memory on [de]allocation. Zero value is useful for benchmarking the allocator or instrumentator.| +|poison_partial | true | If true, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| +|print_cmdline | false | Print command line on crash. With `continue_on_error` set >= 1, print current working directory as UTF-16 aware.| +|print_full_thread_history | true | If true, prints thread creation stacks for the threads involved in the report and their ancestors up to the main thread.| +|print_legend | true | Print the legend for the shadow bytes.| +|print_stats | false | Print various statistics after printing an error message or if atexit=1.| +|print_summary | true | If false, disable printing error summaries in addition to error reports.| +|print_suppressions | true | Print matched suppressions at exit.| +|protect_shadow_gap | true | If true, `mprotect` the shadow gap| +|quarantine_size | -1 | Deprecated, please use quarantine_size_mb.| +|quarantine_size_mb | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| +|redzone | 16 | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| +|replace_intrin | true | If true, uses custom wrappers for `memset`/`memcpy`/`memmove` intinsics.| +|replace_str | true | If true, uses custom wrappers and replacements for libc string functions to find more errors.| +|report_globals | 1 | Controls the way to handle globals (0 - don't detect buffer overflow on globals, 1 - detect buffer overflow, 2 - detect buffer overflow and print data about registered globals).| +|sancov_path | sancov | Sancov tool location.| +|sleep_before_dying | 0 | Number of seconds to sleep between printing an error report and terminating the program.| +|soft_rss_limit_mb | 0 | (Not Implemented on Windows) | +|stack_trace_format | DEFAULT | Format string used to render stack frames. | +|start_deactivated | false | If true, preserves configuration and allocator, and deactivates ASan at initialization. ASan will reactivate when requested. | +|strict_init_order | false | If true, assume that dynamic initializers can never access globals from other modules, even if the latter are already initialized. (Strict init-order checking is thread-hostile. Options is moot on Windows.)| +|strict_memcmp | true | If true, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| +|strict_string_checks | false | If true check that string arguments are properly null-terminated| +|strip_path_prefix | "" | Strips this prefix from file paths in error reports.| +|suppress_equal_pcs | true | Deduplicate multiple reports for single source location in `halt_on_error=false` mode.| +|suppressions | "" | Suppresses file name.| +|symbolize | true | If true, use the `llvm-symbolizer` to turn virtual addresses to file/line locations.| +|symbolize_inline_frames | true | Print inlined frames in stacktraces. | +|symbolize_vs_style | false | Print file locations in Visual Studio style (e.g: file(10,42): ...)| +|uar_noreserve | false | Use mmap with 'noreserve' flag to allocate fake stack. (Not Implemented - Windows uses `VirtualAlloc()`)| +|unmap_shadow_on_exit | false | If true, explicitly unmaps the shadow memory at exit.| +|use_madv_dontdump | true | If true, instructs kernel to not store shadow in core file.| +|use_odr_indicator | false | If true, emit odr violations | +|use_sigaltstack | true | If true, uses alternate stack for signal handling. (Not Implemented on Windows)| +|verbosity | 0 | Verbosity level: 0 - default, 1 - more, 2+ - even more output | +|verify_asan_link_order | true | Check position of ASan runtime in library list (Not Implemented on Windows)| + +## See also + +[AddressSanitizer overview](./asan.md)\ +[AddressSanitizer known issues](./asan-known-issues.md)\ +[AddressSanitizer build and language reference](./asan-building.md)\ +[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ +[AddressSanitizer error examples](./asan-error-examples.md) \ No newline at end of file diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 52fac2efa2a..a4daaa517b7 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -101,7 +101,7 @@ For an illustration of the alignment requirement and potential issues, see the p ## Runtime options -The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most of clang's ASan runtime options available in MSVC as well. [A complete list of the public Clang runtime options is available here](https://github.com/google/sanitizers/wiki/SanitizerCommonFlags). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). +The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most of Clang's ASan runtime options available in MSVC as well. [A complete list of runtime options we support is available here](./asan-flags.md). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). ### Configure runtime options From 62a8be95d806739be9e1aa62da460cea8f2607fb Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 8 Aug 2025 13:46:30 -0700 Subject: [PATCH 0676/1799] Remove unsupported Runtime options. Code Escape flags, values, and code --- docs/sanitizers/asan-flags.md | 204 +++++++++++++++------------------- 1 file changed, 92 insertions(+), 112 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 04e3774c362..bce5940efb0 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -1,125 +1,105 @@ --- title: "AddressSanitizer Runtime Options" description: "List of runtime options for the Microsoft C/C++ Address Sanitizer" -ms.date: 8/05/2025 -helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Address Sanitizer options", "Address Sanitizer flags", "asan options", "asan flags", "sanitizer flags", "asan_options", "AddressSanitizerFlags", "CommonSanitizerFlags"] +ms.date: 8/08/2025 +helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Address sanitizer options", "Address sanitizer flags", "asan options", "asan flags", "sanitizer flags", "asan_options", "AddressSanitizerFlags", "SanitizerCommonFlags"] --- # AddressSanitizer Runtime Options -The following is a list of supported runtime options that can be set by the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function. Reference: [AddressSanitizer Runtime Options](./asan-runtime.md#runtime-options). Note that while these mirror the options available in Clang's ASan, the description will differ by varying amounts in consideration of the MSVC ASan runtime. +The following is a list of supported runtime options that can be set by the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function. Reference: [AddressSanitizer Runtime Options](./asan-runtime.md#runtime-options). While these mirror the options available in Clang's ASan, the description will differ by varying amounts in consideration of the MSVC ASan runtime. -This is a living document that may update at any time due to the constant development of AddressSanitizer on the Windows platform. If you discover options that aren't accurately documented, we invite you to [report a bug](https://aka.ms/feedback/report?space=62). +If you discover options that are inaccurately documented, we invite you to [report a bug](https://aka.ms/feedback/report?space=62). | Flag | Default value | Description | -|:-----|:--------------|:------------| -|abort_on_error | false | If true, the tool calls `abort()` instead of `_exit()` after printing the error report.| -|alloc_dealloc_mismatch | false | Enables runtime detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| -|allocator_frees_and_returns_null_on_realloc_zero | 1 | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| -|allocator_may_return_null | false | If true, the allocator will return `nullptr` and fail when out of memory instead of crashing.| -|allocator_release_to_os_interval_ms | -1 | Experimental. 64-bit allocator only. Specify minimum time interval in ms between attempts to release memory | -|allow_addr2line | false | If true, the tool uses the `addr2line` binary to symbolize stack traces when `llvm-symbolizer` is not available.| -|allow_user_poisoning | true | If true, user may manually mark memory regions as poisoned or unpoisoned.| -|atexit | false | If true, prints ASan exit stats even after program terminates successfully.| -|can_use_proc_maps_statm | true | If false, do not attempt to read `/proc/maps/statm`. Mostly useful for testing sanitizers. (Not implemented - `/proc/maps/statm` doesn't exist on Windows)| -|check_initialization_order | false | If true, attempts to catch initialization order issues.| -|check_malloc_usable_size | true | Allows the users to work around the bug in Nvidia drivers prior to 295.*.| -|check_printf | true | If true, enables ASan to validate printf family function arguments for memory safety violations.| -|clear_shadow_mmap_threshold | 64 * 1024 | Large shadow regions are zero-filled using `mmap(NORESERVE)` instead of `memset()`. This is the threshold size in bytes. (Not Implemented - `memset()` is always called on Windows)| -|color | auto | Colorize reports: (always|never|auto). (Not Implemented on Windows)| -|continue_on_error | 0 | Allows an application to continue running while reporting unique memory safety errors. 0 - disabled, 1 - stderr(1), 2 - stderr(2). See [continue_on_error](asan-continue-on-error.md).| -|coverage | false | If true, coverage information will be dumped at program shutdown (if the coverage instrumentation was enabled at compile time).| -|coverage_bitset | false | If true (and if 'coverage' is set too), the coverage information will also be dumped as a bitset to a separate file.| -|coverage_counters | false | If true (and if 'coverage' is set too), the bitmap that corresponds to coverage counters will be dumped.| -|coverage_dir | "." | Target directory for coverage dumps. Defaults to the current directory.| -|coverage_direct | false (true on Android) | If true, coverage information will be dumped directly to a memory mapped file. This way data is not lost even if the process is suddenly killed.| -|coverage_order_pcs | false | If true, the PCs will be dumped in the order they've appeared during the execution.| -|coverage_pcs | true | If true (and if 'coverage' is set too), the coverage information will be dumped as a set of PC offsets for every module.| -|debug | false | If true, prints some debugging information and does additional checks.| -|decorate_proc_maps | false | If true, decorate sanitizer mappings in /proc/self/maps with user-readable names (Not Implemented - `/proc/self/maps` doesn't exist on Windows)| -|detect_container_overflow | true | If true, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md)| -|detect_deadlocks | true | If true, deadlock detection is enabled.| -|detect_invalid_pointer_pairs | 0 | If non-zero, try to detect operations like <, <=, >, >= and - on invalid pointer pairs (e.g. when pointers belong to different objects). The bigger the value the harder we try.| -|detect_leaks | true | Enable memory leak detection. (Not Implemented - LSan not implemented on Windows as of yet.)| -|detect_odr_violation | 2 | If >=2, detect violation of One-Definition-Rule (ODR); If 1, detect ODR-violation only if the two variables have different sizes| -|detect_stack_use_after_return | false | Enables stack-use-after-return checking at run-time. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md)| -|disable_coredump | true (false on non-64-bit systems) | Disable core dumping. By default, disable_coredump=1 on 64-bit to avoid dumping a 16T+ core file. Ignored on OSes that don't dump core by default and for sanitizers that don't reserve lots of virtual memory.| -|dump_instruction_bytes | false | If true, dump 16 bytes starting at the instruction that caused SEGV| -|exitcode | 1 | Override the program exit status if the tool found an error| -|external_symbolizer_path | "" | Path to external symbolizer. If empty, the tool will search $PATH for the symbolizer.| -|fast_unwind_on_check | false | If available, use the fast frame-pointer-based unwinder on internal CHECK failures.| -|fast_unwind_on_fatal | false | If available, use the fast frame-pointer-based unwinder on fatal errors.| -|fast_unwind_on_malloc | true | If available, use the fast frame-pointer-based unwinder on malloc/free.| -|full_address_space | false | Sanitize complete address space; by default kernel area on 32-bit platforms will not be sanitized| -|halt_on_error | true | Exit/abort the program after printing the first error report (May cause undefined behavior).| -|handle_abort | false | Controls custom tool's SIGABRT handler (Not Implemented on Windows) | -|handle_ioctl | false | Intercept and handle ioctl requests. (Not Implemented on Windows)| -|handle_segv | true | false - ASan will not handle SEGV errors, true - ASan handles SEGV errors.| -|handle_sigbus | true | Controls custom tool's SIGBUS handler (Not Implemented on Windows)| -|handle_sigfpe | true | false - ASan will not handle SIGFPE errors, true - ASan will handle SIGFPE errors. | -|handle_sigill | true | false - ASan will not handle SIGILL errors, true - ASan will handle SIGILL errors.| -|hard_rss_limit_mb | 0 | (Not Implemented on Windows) | -|heap_profile | false | (Not Implemented on Windows)| -|help | false | If true, ASan prints the flag options to console.| -|html_cov_report | false | If true, ASan generates a coverage report.| -|include | "" | read more options from the given file| -|include_if_exists | "" | read more options from the given file (if it exists)| -|intercept_memcmp | true | If true, uses custom wrappers for memcmp function to find more errors.| -|intercept_strpbrk | true | If true, uses custom wrappers for strpbrk function to find more errors.| -|intercept_strspn | true | If true, uses custom wrappers for strspn and strcspn function to find more errors.| -|intercept_strstr | true | If true, uses custom wrappers for strstr and strcasestr functions to find more errors.| -|intercept_tls_get_addr | false | Intercept __tls_get_addr.| -|leak_check_at_exit | true | Invoke leak checking in an atexit handler. Has no effect if detect_leaks=false, or if __lsan_do_leak_check() is called before the handler has a chance to run. (Not Implemented - LSan not implemented on Windows as of yet.)| -|legacy_pthread_cond | false | Enables support for dynamic libraries linked with libpthread 2.2.5. (Not Implemented on Windows)| -|log_exe_name | false | Mention name of executable when reporting error and append executable name to logs (as in `log_path.exe_name.pid`).| -|log_path | stderr | Write logs to `log_path.pid`. The special values are `stdout` and `stderr`. The default is `stderr`.| -|log_to_syslog | false | Write all sanitizer output to syslog in addition to other means of logging.| -|malloc_context_size | 1 | Max number of stack frames kept for each allocation/deallocation.| -|malloc_fill_byte | 0xbe | Value used to fill the newly allocated memory.| -|max_malloc_fill_size | 4096 | ASan allocator flag. `max_malloc_fill_size` is the maximal amount of bytes that will be filled with `malloc_fill_byte` on `malloc`.| -|max_redzone | 2048 | Maximal size (in bytes) of redzones around heap objects.| -|max_uar_stack_size_log | 20 | Maximum fake stack size log.| -|min_uar_stack_size_log | 16 | Minimum fake stack size log. (Cannot do smaller than 16)| -|mmap_limit_mb | 0 | Limit the amount of mmap-ed memory (excluding shadow) in Mb; (Not Implemented on Windows) | -|new_delete_type_mismatch | true | Report errors on mismatch betwen size of new and delete. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md)| -|no_huge_pages_for_shadow | true | If true, the shadow is not allowed to use huge pages. (Not Implemented on Windows) | -|poison_array_cookie | true | Poison (or not) the array cookie after operator `new[]`.| -|poison_heap | true | Poison (or not) the heap memory on [de]allocation. Zero value is useful for benchmarking the allocator or instrumentator.| -|poison_partial | true | If true, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| -|print_cmdline | false | Print command line on crash. With `continue_on_error` set >= 1, print current working directory as UTF-16 aware.| -|print_full_thread_history | true | If true, prints thread creation stacks for the threads involved in the report and their ancestors up to the main thread.| -|print_legend | true | Print the legend for the shadow bytes.| -|print_stats | false | Print various statistics after printing an error message or if atexit=1.| -|print_summary | true | If false, disable printing error summaries in addition to error reports.| -|print_suppressions | true | Print matched suppressions at exit.| -|protect_shadow_gap | true | If true, `mprotect` the shadow gap| -|quarantine_size | -1 | Deprecated, please use quarantine_size_mb.| -|quarantine_size_mb | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| -|redzone | 16 | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| -|replace_intrin | true | If true, uses custom wrappers for `memset`/`memcpy`/`memmove` intinsics.| -|replace_str | true | If true, uses custom wrappers and replacements for libc string functions to find more errors.| -|report_globals | 1 | Controls the way to handle globals (0 - don't detect buffer overflow on globals, 1 - detect buffer overflow, 2 - detect buffer overflow and print data about registered globals).| -|sancov_path | sancov | Sancov tool location.| -|sleep_before_dying | 0 | Number of seconds to sleep between printing an error report and terminating the program.| -|soft_rss_limit_mb | 0 | (Not Implemented on Windows) | -|stack_trace_format | DEFAULT | Format string used to render stack frames. | -|start_deactivated | false | If true, preserves configuration and allocator, and deactivates ASan at initialization. ASan will reactivate when requested. | -|strict_init_order | false | If true, assume that dynamic initializers can never access globals from other modules, even if the latter are already initialized. (Strict init-order checking is thread-hostile. Options is moot on Windows.)| -|strict_memcmp | true | If true, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| -|strict_string_checks | false | If true check that string arguments are properly null-terminated| -|strip_path_prefix | "" | Strips this prefix from file paths in error reports.| -|suppress_equal_pcs | true | Deduplicate multiple reports for single source location in `halt_on_error=false` mode.| -|suppressions | "" | Suppresses file name.| -|symbolize | true | If true, use the `llvm-symbolizer` to turn virtual addresses to file/line locations.| -|symbolize_inline_frames | true | Print inlined frames in stacktraces. | -|symbolize_vs_style | false | Print file locations in Visual Studio style (e.g: file(10,42): ...)| -|uar_noreserve | false | Use mmap with 'noreserve' flag to allocate fake stack. (Not Implemented - Windows uses `VirtualAlloc()`)| -|unmap_shadow_on_exit | false | If true, explicitly unmaps the shadow memory at exit.| -|use_madv_dontdump | true | If true, instructs kernel to not store shadow in core file.| -|use_odr_indicator | false | If true, emit odr violations | -|use_sigaltstack | true | If true, uses alternate stack for signal handling. (Not Implemented on Windows)| -|verbosity | 0 | Verbosity level: 0 - default, 1 - more, 2+ - even more output | -|verify_asan_link_order | true | Check position of ASan runtime in library list (Not Implemented on Windows)| +|------|---------------|-------------| +|`abort_on_error` | `false` | If `true`, the tool calls `abort()` instead of `_exit()` after printing the error report.| +|`alloc_dealloc_mismatch` | `false` | Enables runtime detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| +|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| +|`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` and fail when out of memory instead of crashing.| +|`allocator_release_to_os_interval_ms` | `-1` | Experimental. 64-bit allocator only. Specify minimum time interval in ms between attempts to release memory.| +|`allow_addr2line` | `false` | If `true`, the tool uses the `addr2line` binary to symbolize stack traces when `llvm-symbolizer` is not available.| +|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned.| +|`atexit` | `false` | If `true`, prints ASan exit stats even after program terminates successfully.| +|`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| +|`check_malloc_usable_size` | `true` | Allows the users to work around the bug in Nvidia drivers prior to `295.*`.| +|`check_printf` | `true` | If `true`, enables ASan to validate printf family function arguments for memory safety violations.| +|`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - `stderr(1)`, `2` - `stderr(2)`. See [continue_on_error](asan-continue-on-error.md).| +|`coverage` | `false` | If `true` and the coverage instrumentation was enabled at compile time, coverage information will be dumped at program shutdown.| +|`coverage_bitset` | `false` | If `true`, the coverage information will also be dumped as a bitset to a separate file.| +|`coverage_counters` | `false` | If `true`, the bitmap that corresponds to coverage counters will be dumped.| +|`coverage_dir` | `"."` | Target directory for coverage dumps. Defaults to the current directory.| +|`coverage_direct` | `false` | If `true`, coverage information will be dumped directly to a memory mapped file. This way data is not lost even if the process is suddenly killed.| +|`coverage_order_pcs` | `false` | If `true`, the PCs will be dumped in the order they've appeared during the execution.| +|`coverage_pcs` | `true` | If `true` the coverage information will be dumped as a set of PC offsets for every module.| +|`debug` | `false` | If `true`, prints some debugging information and does additional checks.| +|`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| +|`detect_invalid_pointer_pairs` | `0` | If >`0`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects. Higher values increase detection effort.| +|`detect_odr_violation` | `2` | If >=`2`, detect violation of One-Definition-Rule (ODR) violation; If `1`, detect ODR-violation only if the two variables have different sizes.| +|`detect_stack_use_after_return` | `false` | Enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| +|`disable_coredump` | `true`/`false` (on non-64-bit systems) | Disables core dumping. By default, the tool sets `disable_coredump=1` on 64-bit systems to prevent dumping a 16T+ core file. The tool ignores this flag on operating systems that don't dump core by default and for sanitizers that don't reserve large amounts of virtual memory.| +|`dump_instruction_bytes` | `false` | If `true`, dump 16 bytes starting at the instruction that caused `SEGV`.| +|`exitcode` | `1` | Override the program exit status with this value if the tool found an error.| +|`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, the tool will search `$PATH` for the symbolizer.| +|`fast_unwind_on_check` | `false` | If available, the tool uses the fast frame-pointer-based unwinder on internal `CHECK` failures.| +|`fast_unwind_on_fatal` | `false` | If available, the tool uses the fast frame-pointer-based unwinder on fatal errors.| +|`fast_unwind_on_malloc` | `true` | If available, the tool uses the fast frame-pointer-based unwinder on `malloc`/`free`.| +|`full_address_space` | `false` | Sanitize complete address space; by default kernel area on 32-bit platforms will not be sanitized.| +|`halt_on_error` | `true` | Exit/abort the program after printing the first error report (May cause undefined behavior).| +|`handle_segv` | `true` | `false` - ASan will not handle `SEGV` errors, `true` - ASan handles `SEGV` errors.| +|`handle_sigfpe` | `true` | `false` - ASan will not handle `SIGFPE` errors, `true` - ASan will handle `SIGFPE` errors.| +|`handle_sigill` | `true` | `false` - ASan will not handle `SIGILL` errors, `true` - ASan will handle `SIGILL` errors.| +|`help` | `false` | If `true`, ASan prints the flag options to console.| +|`html_cov_report` | `false` | If `true`, ASan generates a coverage report.| +|`include` | `""` | Read more options from the given file.| +|`include_if_exists` | `""` | Read more options from the given file (if it exists).| +|`intercept_memcmp` | `true` | If `true`, uses custom wrappers for memcmp function to find more errors.| +|`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for strpbrk function to find more errors.| +|`intercept_strspn` | `true` | If `true`, uses custom wrappers for strspn and strcspn function to find more errors.| +|`intercept_strstr` | `true` | If `true`, uses custom wrappers for strstr and strcasestr functions to find more errors.| +|`intercept_tls_get_addr` | `false` | Intercept __tls_get_addr.| +|`log_exe_name` | `false` | Mention name of executable when reporting error and append executable name to logs (as in `log_path.exe_name.pid`).| +|`log_path` | `stderr` | Write logs to `log_path.pid`. The special values are `stdout` and `stderr`. The default is `stderr`.| +|`log_to_syslog` | `false` | Write all sanitizer output to syslog in addition to other means of logging.| +|`malloc_context_size` | `1` | Max number of stack frames kept for each allocation/deallocation.| +|`malloc_fill_byte` | `0xbe` | Value used to fill the newly allocated memory.| +|`max_malloc_fill_size` | `4096` | ASan allocator flag. `max_malloc_fill_size` is the maximal amount of bytes that will be filled with `malloc_fill_byte` on `malloc`.| +|`max_redzone` | `2048` | Maximal size (in bytes) of redzones around heap objects.| +|`max_uar_stack_size_log` | `20` | Maximum fake stack size log.| +|`min_uar_stack_size_log` | `16` | Minimum fake stack size log. (Minimum value accepted: `16`).| +|`new_delete_type_mismatch` | `true` | Report errors on mismatch betwen size of new and delete. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| +|`poison_array_cookie` | `true` | Poison (or not) the array cookie after operator `new[]`.| +|`poison_heap` | `true` | Poison (or not) the heap memory on [de]allocation. Zero value is useful for benchmarking the allocator or instrumentator.| +|`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| +|`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| +|`print_full_thread_history` | `true` | If `true`, prints thread creation stacks for the threads involved in the report and their ancestors up to the main thread.| +|`print_legend` | `true` | Print the legend for the shadow bytes.| +|`print_stats` | `false` | Print various statistics after printing an error message or if atexit=1.| +|`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| +|`print_suppressions` | `true` | Print matched suppressions at exit.| +|`protect_shadow_gap` | `true` | If `true`, `mprotect` the shadow gap.| +|`quarantine_size` | `-1` | Deprecated, please use `quarantine_size_mb`.| +|`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| +|`redzone` | `16` | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| +|`replace_intrin` | `true` | If `true`, uses custom wrappers for `memset` or `memcpy` or `memmove` intinsics.| +|`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| +|`report_globals` | `1` | Controls the way to handle globals (`0` - don't detect buffer overflow on globals, `1` - detect buffer overflow, `2` - detect buffer overflow and print data about registered globals).| +|`sancov_path` | `sancov` | Sancov tool location.| +|`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.| +|`stack_trace_format` | `DEFAULT` | Format string used to render stack frames.| +|`start_deactivated` | `false` | If `true`, preserves configuration and allocator, and deactivates ASan at initialization. ASan will reactivate when requested.| +|`strict_memcmp` | `true` | If `true`, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| +|`strict_string_checks` | `false` | If `true` check that string arguments are properly null-terminated.| +|`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| +|`suppress_equal_pcs` | `true` | Deduplicate multiple reports for single source location in `halt_on_error=false` mode.| +|`suppressions` | `""` | Suppresses file name.| +|`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses to file or line locations.| +|`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| +|`symbolize_vs_style` | `false` | Print file locations in Visual Studio style (e.g: file(10,42): ...).| +|`unmap_shadow_on_exit` | `false` | If `true`, explicitly unmaps the shadow memory at exit.| +|`use_madv_dontdump` | `true` | If `true`, instructs kernel to not store shadow in core file.| +|`use_odr_indicator` | `false` | If `true`, emit odr violations.| +|`verbosity` | `0` | Verbosity level: `0` - default, `1` - more, `2+` - even more output.| ## See also From e8f62b01159399ad2116ae8eb10570a31273ec53 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 18:37:01 +0800 Subject: [PATCH 0677/1799] Overhaul documentation issue section in "How to report a problem with the Microsoft C++ toolset or documentation" --- .../how-to-report-a-problem-with-the-visual-cpp-toolset.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index 5fff09d04d6..8d979f94317 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -408,6 +408,6 @@ To maintain your privacy and keep your sensitive information out of public view, ## How to report a C++ documentation issue -We use GitHub issues to track problems reported in our documentation. You can now create GitHub issues directly from a content page, which enables you interact in a richer way with writers and product teams. If you see an issue with a document, a bad code sample, a confusing explanation, a critical omission, or even just a typo, you can easily let us know. Scroll to the bottom of the page and select **Sign in to give documentation feedback**. You need to create a GitHub account if you don't have one already. When you have a GitHub account, you can see all of our documentation issues and their status. You also get notifications when changes are made for the issue you reported. For more information, see our [Feedback System blog entry](/teamblog/a-new-feedback-system-is-coming-to-docs). +If you see an issue with a document, a bad code sample, a confusing explanation, a critical omission, or even just a typo, you can easily let us know by using the feedback buttons on the page. Since 2024, we no longer use GitHub issues to track problems reported. For more information, see [Announcing a new way to give feedback on Microsoft Learn](https://techcommunity.microsoft.com/blog/microsoftlearnblog/announcing-a-new-way-to-give-feedback-on-microsoft-learn/4027635). -You create a documentation issue on GitHub when you use the documentation feedback button. The issue is automatically filled in with some information about the page you created the issue on. That's how we know where the problem is located, so don't edit this information. Just append the details about what's wrong, and if you like, a suggested fix. [Our C++ docs are open source](https://github.com/MicrosoftDocs/cpp-docs/), so if you'd like to submit a fix yourself, you can. For more information about how you can contribute to our documentation, see our [Contributing guide](https://github.com/MicrosoftDocs/cpp-docs/blob/main/CONTRIBUTING.md) on GitHub. +[Our C++ docs are open source](https://github.com/MicrosoftDocs/cpp-docs/), so if you'd like to submit a fix yourself, you can. For more information about how you can contribute to our documentation, see our [Contributing guide](https://github.com/MicrosoftDocs/cpp-docs/blob/main/CONTRIBUTING.md) on GitHub. From 65b364520cef72284450f28c023ca699f9e8a1b1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 18:37:40 +0800 Subject: [PATCH 0678/1799] Update metadata in "How to report a problem with the Microsoft C++ toolset or documentation" --- .../how-to-report-a-problem-with-the-visual-cpp-toolset.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index 8d979f94317..97a4e65ca48 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -1,7 +1,7 @@ --- title: "How to report a problem with the Microsoft C++ toolset" -description: How to create a good problem report and repro information for the Microsoft C++ toolset. -ms.date: "09/24/2019" +description: "How to create a good problem report and repro information for the Microsoft C++ toolset." +ms.date: 09/24/2019 ms.service: "visual-cpp" ms.subservice: "ide" author: "tylermsft" From b080dbf47af5594849b1de6869df76eb046dabd2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 21:52:52 +0800 Subject: [PATCH 0679/1799] Add blockquotes for error messages in range [C2821, C2850] --- docs/error-messages/compiler-errors-2/compiler-error-c2821.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2824.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2825.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2827.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2828.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2829.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2830.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2831.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2835.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2838.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2839.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2843.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2844.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2845.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2846.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2847.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2849.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2850.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md index d187c402136..7c91d44284e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md @@ -8,7 +8,7 @@ ms.assetid: e8d71988-a968-4484-94db-e8c3bad74a4a --- # Compiler Error C2821 -first formal parameter to 'operator new' must be 'unsigned int' +> first formal parameter to 'operator new' must be 'unsigned int' The first formal parameter of the [operator new](../../standard-library/new-operators.md#op_new) must be an unsigned **`int`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md index 2178beb0a79..affbd208848 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md @@ -8,7 +8,7 @@ ms.assetid: 5bd865f7-e0af-404e-80fe-e2b798b44a59 --- # Compiler Error C2824 -return type for 'operator new' must be 'void *' +> return type for 'operator new' must be 'void *' With non-based pointers, overloads of operator `new` must return `void *`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md index fc7b5f733e7..bcf79a68fa6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md @@ -8,7 +8,7 @@ ms.assetid: c832f1c1-5184-4fc2-9356-12b21daa7af3 --- # Compiler Error C2825 -var : must be a class or namespace when followed by '::' +> var : must be a class or namespace when followed by '::' An unsuccessful attempt was made to form a qualified name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2827.md b/docs/error-messages/compiler-errors-2/compiler-error-c2827.md index fe90f7e62bf..89a2cc8393b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2827.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2827.md @@ -8,7 +8,7 @@ ms.assetid: cb3e5814-0c92-40e4-b620-98578ae3003a --- # Compiler Error C2827 -'operator operator' cannot be globally overridden with unary form +> 'operator operator' cannot be globally overridden with unary form The operator cannot have a unary form outside of an object. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2828.md b/docs/error-messages/compiler-errors-2/compiler-error-c2828.md index 0273a717134..36858332329 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2828.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2828.md @@ -8,7 +8,7 @@ ms.assetid: d8df6ed4-5954-46c2-b59b-52881d4e923d --- # Compiler Error C2828 -'operator operator' cannot be globally overridden with binary form +> 'operator operator' cannot be globally overridden with binary form The operator cannot have a binary form outside of an object. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2829.md b/docs/error-messages/compiler-errors-2/compiler-error-c2829.md index 137d653a228..375e0c875e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2829.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2829.md @@ -8,7 +8,7 @@ ms.assetid: b3bfecb8-c8c1-45fd-bb85-4b42a6b8ed2b --- # Compiler Error C2829 -'operator operator' cannot have a variable parameter list +> 'operator operator' cannot have a variable parameter list Only two operators can take variable parameter lists: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2830.md b/docs/error-messages/compiler-errors-2/compiler-error-c2830.md index 6141a2a5023..cb6393d14a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2830.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2830.md @@ -8,6 +8,6 @@ ms.assetid: 91607d2d-6aab-4c1b-b253-a7b8ec37760e --- # Compiler Error C2830 -only placement parameters to 'operator new' can have default values +> only placement parameters to 'operator new' can have default values The standard formal parameters for [operator new](../../standard-library/new-operators.md#op_new) cannot have default values. Only user-defined placement parameters can specify defaults. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md index 9512ca8f412..46284818bd2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md @@ -8,7 +8,7 @@ ms.assetid: c8c04288-0889-4265-a077-17f94cbcdcc9 --- # Compiler Error C2831 -'operator operator' cannot have default parameters +> 'operator operator' cannot have default parameters Only three operators can have default parameters: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2835.md b/docs/error-messages/compiler-errors-2/compiler-error-c2835.md index ae076c90aff..19b93e6b993 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2835.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2835.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2835"] --- # Compiler Error C2835 -user-defined conversion 'type' takes no formal parameters +> user-defined conversion 'type' takes no formal parameters User-defined type conversions cannot take formal parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md index 5667a087511..98106bd67fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md @@ -8,7 +8,7 @@ ms.assetid: 176b2ad6-7a84-4019-b97e-328866054457 --- # Compiler Error C2838 -'member' : illegal qualified name in member declaration +> 'member' : illegal qualified name in member declaration A class, structure, or union uses a fully qualified name to redeclare a member of another class, structure, or union. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2839.md b/docs/error-messages/compiler-errors-2/compiler-error-c2839.md index f7480b7bc45..8de1a86d69a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2839.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2839.md @@ -8,6 +8,6 @@ ms.assetid: e4914def-2ee1-4e2e-8951-d35f9515c2b2 --- # Compiler Error C2839 -invalid return type 'type' for overloaded 'operator ->' +> invalid return type 'type' for overloaded 'operator ->' The `->` operator must return a class, struct, or union, or a reference to one. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md index 14b5171ffa2..b666371ecd8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md @@ -8,7 +8,7 @@ ms.assetid: 9d3f2ac4-eea5-4fed-abeb-e752f442bfcc --- # Compiler Error C2843 -'member' : cannot take the address of a non-static data member or method of a managed or WinRT type +> 'member' : cannot take the address of a non-static data member or method of a managed or WinRT type An instance is needed to take the address of nonstatic data members of a managed or WinRT class or interface. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md index 5fd3a703db6..7a9a221b428 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md @@ -8,7 +8,7 @@ ms.assetid: dcaf4cd2-21b0-4280-ae42-0a706c524d83 --- # Compiler Error C2844 -'member' : cannot be a member of interface 'interface' +> 'member' : cannot be a member of interface 'interface' An [interface class](../../extensions/interface-class-cpp-component-extensions.md) cannot contain a data member unless it is also a property. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2845.md b/docs/error-messages/compiler-errors-2/compiler-error-c2845.md index 16511963892..edf83077344 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2845.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2845.md @@ -8,6 +8,6 @@ ms.assetid: 31b28ee9-978f-403b-94d8-dbaacd24cce0 --- # Compiler Error C2845 -'operator' : pointer arithmetic not allowed on this type +> 'operator' : pointer arithmetic not allowed on this type You cannot increment the pointer to a managed class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md index a33ecf9a560..c737354bda5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md @@ -8,7 +8,7 @@ ms.assetid: bc090ec2-5410-4112-9ec6-261325374375 --- # Compiler Error C2846 -'constructor' : an interface cannot have a constructor +> 'constructor' : an interface cannot have a constructor A Visual C++ [interface](../../cpp/interface.md) cannot have a constructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md index ef48d9496b8..c48edc249d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md @@ -8,7 +8,7 @@ ms.assetid: 9ad9a0e0-8b16-49d9-a5be-f8eda2372aa9 --- # Compiler Error C2847 -cannot apply sizeof to managed or WinRT type 'class' +> cannot apply sizeof to managed or WinRT type 'class' The [sizeof](../../cpp/sizeof-operator.md) operator gets the value of an object at compile time. The size of a managed or WinRT class, interface, or value type is dynamic and so cannot be known at compile time. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md index 529a6699481..864390d0e2e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md @@ -8,7 +8,7 @@ ms.assetid: e28f6b3e-e0e7-4f92-b006-ebaa81d368e6 --- # Compiler Error C2849 -'destructor' : an interface cannot have a destructor +> 'destructor' : an interface cannot have a destructor A Visual C++ [interface](../../cpp/interface.md) cannot have a destructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md index 86e1d28646f..66cb4224b18 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md @@ -8,7 +8,7 @@ ms.assetid: f3efe86c-4168-4e76-a133-3f8314c69f51 --- # Compiler Error C2850 -'construct' : only allowed at file scope; may not be in a nested construct +> 'construct' : only allowed at file scope; may not be in a nested construct Constructs, such as some pragmas, can only appear at global scope. From e7243377cf3f6ac951f91faa1b099bc2f5ed84a1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 21:56:57 +0800 Subject: [PATCH 0680/1799] Add "Remarks" and "Example" headings for error references in range [C2821, C2850] --- docs/error-messages/compiler-errors-2/compiler-error-c2821.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2823.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2824.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2825.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2827.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2828.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2829.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2830.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2831.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2833.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2834.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2835.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2838.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2839.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2843.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2844.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2845.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2846.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2847.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2849.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2850.md | 4 ++++ 21 files changed, 64 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md index 7c91d44284e..9c4967c4aa7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md @@ -10,6 +10,8 @@ ms.assetid: e8d71988-a968-4484-94db-e8c3bad74a4a > first formal parameter to 'operator new' must be 'unsigned int' +## Remarks + The first formal parameter of the [operator new](../../standard-library/new-operators.md#op_new) must be an unsigned **`int`**. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2823.md b/docs/error-messages/compiler-errors-2/compiler-error-c2823.md index acdfe09f032..a49c7317cdc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2823.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2823.md @@ -10,6 +10,8 @@ ms.assetid: 982b1b35-1a7c-456e-b711-f80cfe2d571e > a typedef template is illegal +## Remarks + Templates are not allowed in **`typedef`** definitions. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md index affbd208848..8e38adef9a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md @@ -10,8 +10,12 @@ ms.assetid: 5bd865f7-e0af-404e-80fe-e2b798b44a59 > return type for 'operator new' must be 'void *' +## Remarks + With non-based pointers, overloads of operator `new` must return `void *`. +## Example + The following sample generates C2824: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md index bcf79a68fa6..08c07cd4e59 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md @@ -10,6 +10,8 @@ ms.assetid: c832f1c1-5184-4fc2-9356-12b21daa7af3 > var : must be a class or namespace when followed by '::' +## Remarks + An unsuccessful attempt was made to form a qualified name. For example, make sure that your code does not contain a function declaration where the function name begins with ::. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2827.md b/docs/error-messages/compiler-errors-2/compiler-error-c2827.md index 89a2cc8393b..858b6cb289f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2827.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2827.md @@ -10,6 +10,8 @@ ms.assetid: cb3e5814-0c92-40e4-b620-98578ae3003a > 'operator operator' cannot be globally overridden with unary form +## Remarks + The operator cannot have a unary form outside of an object. ### To fix by using the following possible solutions diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2828.md b/docs/error-messages/compiler-errors-2/compiler-error-c2828.md index 36858332329..febda82f05a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2828.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2828.md @@ -10,6 +10,8 @@ ms.assetid: d8df6ed4-5954-46c2-b59b-52881d4e923d > 'operator operator' cannot be globally overridden with binary form +## Remarks + The operator cannot have a binary form outside of an object. ### To fix by using the following possible solutions diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2829.md b/docs/error-messages/compiler-errors-2/compiler-error-c2829.md index 375e0c875e8..e2c555c46dd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2829.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2829.md @@ -10,6 +10,8 @@ ms.assetid: b3bfecb8-c8c1-45fd-bb85-4b42a6b8ed2b > 'operator operator' cannot have a variable parameter list +## Remarks + Only two operators can take variable parameter lists: - Function call `()` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2830.md b/docs/error-messages/compiler-errors-2/compiler-error-c2830.md index cb6393d14a3..e8d7447dd1d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2830.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2830.md @@ -10,4 +10,6 @@ ms.assetid: 91607d2d-6aab-4c1b-b253-a7b8ec37760e > only placement parameters to 'operator new' can have default values +## Remarks + The standard formal parameters for [operator new](../../standard-library/new-operators.md#op_new) cannot have default values. Only user-defined placement parameters can specify defaults. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md index 46284818bd2..0b0e11faa78 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md @@ -10,6 +10,8 @@ ms.assetid: c8c04288-0889-4265-a077-17f94cbcdcc9 > 'operator operator' cannot have default parameters +## Remarks + Only three operators can have default parameters: - [new](../../cpp/new-operator-cpp.md) @@ -18,6 +20,8 @@ Only three operators can have default parameters: - Left parenthesis ( +## Example + The following sample generates C2831: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2833.md b/docs/error-messages/compiler-errors-2/compiler-error-c2833.md index 84e1e48a152..c8ade7ff3e0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2833.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2833.md @@ -10,10 +10,14 @@ ms.assetid: b9418ce1-e2ee-4599-8959-6fde89c27569 > 'operator *operator-name*' is not a recognized operator or type +## Remarks + The word **`operator`** must be followed by an *operator-name* that you want to override or a type you want to convert. For a list of the operators that you can define in a managed type, see [User-defined Operators](../../dotnet/user-defined-operators-cpp-cli.md). +## Example + The following sample generates C2833: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2834.md b/docs/error-messages/compiler-errors-2/compiler-error-c2834.md index 716e1c7e5a9..d03dff30ccf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2834.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2834.md @@ -10,6 +10,8 @@ ms.assetid: 28f9f6eb-ab2a-4e64-aaaa-9d14f955de41 > 'operator *operator-name*' must be globally qualified +## Remarks + The `new` and `delete` operators are tied to the class where they reside. Scope resolution cannot be used to select a version of `new` or `delete` from a different class. To implement multiple forms of the `new` or `delete` operator, create a version of the operator with extra formal parameters. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2835.md b/docs/error-messages/compiler-errors-2/compiler-error-c2835.md index 19b93e6b993..75df8cb48e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2835.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2835.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2835"] > user-defined conversion 'type' takes no formal parameters +## Remarks + User-defined type conversions cannot take formal parameters. +## Example + The following sample generates C2835: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md index 98106bd67fc..cb3b9cdad0c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md @@ -10,8 +10,12 @@ ms.assetid: 176b2ad6-7a84-4019-b97e-328866054457 > 'member' : illegal qualified name in member declaration +## Remarks + A class, structure, or union uses a fully qualified name to redeclare a member of another class, structure, or union. +## Example + The following sample generates C2838: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2839.md b/docs/error-messages/compiler-errors-2/compiler-error-c2839.md index 8de1a86d69a..b80a6b1cd4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2839.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2839.md @@ -10,4 +10,6 @@ ms.assetid: e4914def-2ee1-4e2e-8951-d35f9515c2b2 > invalid return type 'type' for overloaded 'operator ->' +## Remarks + The `->` operator must return a class, struct, or union, or a reference to one. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md index b666371ecd8..dea5b01a403 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md @@ -10,8 +10,12 @@ ms.assetid: 9d3f2ac4-eea5-4fed-abeb-e752f442bfcc > 'member' : cannot take the address of a non-static data member or method of a managed or WinRT type +## Remarks + An instance is needed to take the address of nonstatic data members of a managed or WinRT class or interface. +## Example + The following sample generates C2843 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md index 7a9a221b428..f15e038d55f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md @@ -10,10 +10,14 @@ ms.assetid: dcaf4cd2-21b0-4280-ae42-0a706c524d83 > 'member' : cannot be a member of interface 'interface' +## Remarks + An [interface class](../../extensions/interface-class-cpp-component-extensions.md) cannot contain a data member unless it is also a property. Anything other than a property or member function is not allowed in an interface. Furthermore, constructors, destructors, and operators are not allowed. +## Example + The following sample generates C2844: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2845.md b/docs/error-messages/compiler-errors-2/compiler-error-c2845.md index edf83077344..cb46da4baec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2845.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2845.md @@ -10,4 +10,6 @@ ms.assetid: 31b28ee9-978f-403b-94d8-dbaacd24cce0 > 'operator' : pointer arithmetic not allowed on this type +## Remarks + You cannot increment the pointer to a managed class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md index c737354bda5..03d26231951 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md @@ -10,8 +10,12 @@ ms.assetid: bc090ec2-5410-4112-9ec6-261325374375 > 'constructor' : an interface cannot have a constructor +## Remarks + A Visual C++ [interface](../../cpp/interface.md) cannot have a constructor. +## Example + The following sample generates C2846: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md index c48edc249d8..fc05dd38142 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md @@ -10,8 +10,12 @@ ms.assetid: 9ad9a0e0-8b16-49d9-a5be-f8eda2372aa9 > cannot apply sizeof to managed or WinRT type 'class' +## Remarks + The [sizeof](../../cpp/sizeof-operator.md) operator gets the value of an object at compile time. The size of a managed or WinRT class, interface, or value type is dynamic and so cannot be known at compile time. +## Example + For example, the following sample generates C2847: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md index 864390d0e2e..178703cfb60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md @@ -10,8 +10,12 @@ ms.assetid: e28f6b3e-e0e7-4f92-b006-ebaa81d368e6 > 'destructor' : an interface cannot have a destructor +## Remarks + A Visual C++ [interface](../../cpp/interface.md) cannot have a destructor. +## Example + The following sample generates C2849: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md index 66cb4224b18..bc0b37da2b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md @@ -10,8 +10,12 @@ ms.assetid: f3efe86c-4168-4e76-a133-3f8314c69f51 > 'construct' : only allowed at file scope; may not be in a nested construct +## Remarks + Constructs, such as some pragmas, can only appear at global scope. +## Example + The following sample generates C2850: ```cpp From 6b6a21c9e702fd1f38754c7445a5703a676ab141 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 21:58:08 +0800 Subject: [PATCH 0681/1799] Replace term "sample" with "example" for error references in range [C2821, C2850] --- docs/error-messages/compiler-errors-2/compiler-error-c2821.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2823.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2824.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2825.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2831.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2833.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2835.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2838.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2842.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2843.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2844.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2846.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2847.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2849.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2850.md | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md index 9c4967c4aa7..ae1142b449f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md @@ -16,7 +16,7 @@ The first formal parameter of the [operator new](../../standard-library/new-oper ## Example -The following sample generates C2821: +The following example generates C2821: ```cpp // C2821.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2823.md b/docs/error-messages/compiler-errors-2/compiler-error-c2823.md index a49c7317cdc..e30e34a4684 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2823.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2823.md @@ -16,7 +16,7 @@ Templates are not allowed in **`typedef`** definitions. ## Example -The following sample generates C2823, and shows one way to fix it: +The following example generates C2823, and shows one way to fix it: ```cpp // C2823.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md index 8e38adef9a0..7dfd80d1c80 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md @@ -16,7 +16,7 @@ With non-based pointers, overloads of operator `new` must return `void *`. ## Example -The following sample generates C2824: +The following example generates C2824: ```cpp // C2824.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md index 08c07cd4e59..3cec16b8510 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md @@ -18,7 +18,7 @@ For example, make sure that your code does not contain a function declaration wh ## Example -The following sample generates C2825: +The following example generates C2825: ```cpp // C2825.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md index 0b0e11faa78..da0862f24c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md @@ -22,7 +22,7 @@ Only three operators can have default parameters: ## Example -The following sample generates C2831: +The following example generates C2831: ```cpp // C2831.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2833.md b/docs/error-messages/compiler-errors-2/compiler-error-c2833.md index c8ade7ff3e0..159efd539f5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2833.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2833.md @@ -18,7 +18,7 @@ For a list of the operators that you can define in a managed type, see [User-def ## Example -The following sample generates C2833: +The following example generates C2833: ```cpp // C2833.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2835.md b/docs/error-messages/compiler-errors-2/compiler-error-c2835.md index 75df8cb48e7..5492c49de67 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2835.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2835.md @@ -15,7 +15,7 @@ User-defined type conversions cannot take formal parameters. ## Example -The following sample generates C2835: +The following example generates C2835: ```cpp // C2835.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md index cb3b9cdad0c..b77835e14fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md @@ -16,7 +16,7 @@ A class, structure, or union uses a fully qualified name to redeclare a member o ## Example -The following sample generates C2838: +The following example generates C2838: ```cpp // C2838.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2842.md b/docs/error-messages/compiler-errors-2/compiler-error-c2842.md index 62762894e97..dc1ed07457c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2842.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2842.md @@ -18,7 +18,7 @@ For more information, see [User-Defined Operators (C++/CLI)](../../dotnet/user-d ## Example -The following sample generates C2842. +The following example generates C2842. ```cpp // C2842.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md index dea5b01a403..9cca146112f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md @@ -16,7 +16,7 @@ An instance is needed to take the address of nonstatic data members of a managed ## Example -The following sample generates C2843 and shows how to fix it: +The following example generates C2843 and shows how to fix it: ```cpp // C2843_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md index f15e038d55f..7bdc023e82e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md @@ -18,7 +18,7 @@ Anything other than a property or member function is not allowed in an interface ## Example -The following sample generates C2844: +The following example generates C2844: ```cpp // C2844a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md index 03d26231951..ef557074a58 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md @@ -16,7 +16,7 @@ A Visual C++ [interface](../../cpp/interface.md) cannot have a constructor. ## Example -The following sample generates C2846: +The following example generates C2846: ```cpp // C2846.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md index fc05dd38142..6a44aaa4a32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md @@ -16,7 +16,7 @@ The [sizeof](../../cpp/sizeof-operator.md) operator gets the value of an object ## Example -For example, the following sample generates C2847: +For example, the following example generates C2847: ```cpp // C2847.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md index 178703cfb60..a5c8f78d2e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md @@ -16,7 +16,7 @@ A Visual C++ [interface](../../cpp/interface.md) cannot have a destructor. ## Example -The following sample generates C2849: +The following example generates C2849: ```cpp // C2849.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md index bc0b37da2b6..7fd187208ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md @@ -16,7 +16,7 @@ Constructs, such as some pragmas, can only appear at global scope. ## Example -The following sample generates C2850: +The following example generates C2850: ```cpp // C2850.cpp From 683e9d7570e6d5e470938883747f049bc8c1c6d4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 22:01:31 +0800 Subject: [PATCH 0682/1799] Update metadata for error references in range [C2821, C2850] --- .../error-messages/compiler-errors-2/compiler-error-c2821.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2823.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2824.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2825.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2827.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2828.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2829.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2830.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2831.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2833.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2834.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2838.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2839.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2842.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2843.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2844.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2845.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2846.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2847.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2849.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2850.md | 5 ++--- 21 files changed, 41 insertions(+), 62 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md index ae1142b449f..aff747245de 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2821" title: "Compiler Error C2821" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2821" +ms.date: 11/04/2016 f1_keywords: ["C2821"] helpviewer_keywords: ["C2821"] -ms.assetid: e8d71988-a968-4484-94db-e8c3bad74a4a --- # Compiler Error C2821 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2823.md b/docs/error-messages/compiler-errors-2/compiler-error-c2823.md index e30e34a4684..461936a5360 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2823.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2823.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2823" title: "Compiler Error C2823" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2823" +ms.date: 11/04/2016 f1_keywords: ["C2823"] helpviewer_keywords: ["C2823"] -ms.assetid: 982b1b35-1a7c-456e-b711-f80cfe2d571e --- # Compiler Error C2823 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md index 7dfd80d1c80..f314fdc5d08 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2824" title: "Compiler Error C2824" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2824" +ms.date: 11/04/2016 f1_keywords: ["C2824"] helpviewer_keywords: ["C2824"] -ms.assetid: 5bd865f7-e0af-404e-80fe-e2b798b44a59 --- # Compiler Error C2824 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md index 3cec16b8510..451592c6a90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2825" title: "Compiler Error C2825" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2825" +ms.date: 11/04/2016 f1_keywords: ["C2825"] helpviewer_keywords: ["C2825"] -ms.assetid: c832f1c1-5184-4fc2-9356-12b21daa7af3 --- # Compiler Error C2825 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2827.md b/docs/error-messages/compiler-errors-2/compiler-error-c2827.md index 858b6cb289f..77edf9d6175 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2827.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2827.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2827" title: "Compiler Error C2827" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2827" +ms.date: 11/04/2016 f1_keywords: ["C2827"] helpviewer_keywords: ["C2827"] -ms.assetid: cb3e5814-0c92-40e4-b620-98578ae3003a --- # Compiler Error C2827 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2828.md b/docs/error-messages/compiler-errors-2/compiler-error-c2828.md index febda82f05a..3a2f05f16f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2828.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2828.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2828" title: "Compiler Error C2828" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2828" +ms.date: 11/04/2016 f1_keywords: ["C2828"] helpviewer_keywords: ["C2828"] -ms.assetid: d8df6ed4-5954-46c2-b59b-52881d4e923d --- # Compiler Error C2828 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2829.md b/docs/error-messages/compiler-errors-2/compiler-error-c2829.md index e2c555c46dd..785f6ffbe62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2829.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2829.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2829" title: "Compiler Error C2829" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2829" +ms.date: 11/04/2016 f1_keywords: ["C2829"] helpviewer_keywords: ["C2829"] -ms.assetid: b3bfecb8-c8c1-45fd-bb85-4b42a6b8ed2b --- # Compiler Error C2829 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2830.md b/docs/error-messages/compiler-errors-2/compiler-error-c2830.md index e8d7447dd1d..44f5c71e35d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2830.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2830.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2830" title: "Compiler Error C2830" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2830" +ms.date: 11/04/2016 f1_keywords: ["C2830"] helpviewer_keywords: ["C2830"] -ms.assetid: 91607d2d-6aab-4c1b-b253-a7b8ec37760e --- # Compiler Error C2830 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md index da0862f24c3..bc27fed8ecd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2831" title: "Compiler Error C2831" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2831" +ms.date: 11/04/2016 f1_keywords: ["C2831"] helpviewer_keywords: ["C2831"] -ms.assetid: c8c04288-0889-4265-a077-17f94cbcdcc9 --- # Compiler Error C2831 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2833.md b/docs/error-messages/compiler-errors-2/compiler-error-c2833.md index 159efd539f5..db4f336ded0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2833.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2833.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2833" title: "Compiler Error C2833" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2833" +ms.date: 11/04/2016 f1_keywords: ["C2833"] helpviewer_keywords: ["C2833"] -ms.assetid: b9418ce1-e2ee-4599-8959-6fde89c27569 --- # Compiler Error C2833 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2834.md b/docs/error-messages/compiler-errors-2/compiler-error-c2834.md index d03dff30ccf..32d04c4ef42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2834.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2834.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2834" title: "Compiler Error C2834" +description: "Learn more about: Compiler Error C2834" ms.date: 06/01/2022 f1_keywords: ["C2834"] helpviewer_keywords: ["C2834"] -ms.assetid: 28f9f6eb-ab2a-4e64-aaaa-9d14f955de41 --- # Compiler Error C2834 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md index b77835e14fd..d25d68cdfc3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2838" title: "Compiler Error C2838" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2838" +ms.date: 11/04/2016 f1_keywords: ["C2838"] helpviewer_keywords: ["C2838"] -ms.assetid: 176b2ad6-7a84-4019-b97e-328866054457 --- # Compiler Error C2838 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2839.md b/docs/error-messages/compiler-errors-2/compiler-error-c2839.md index b80a6b1cd4b..94fe1998ec3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2839.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2839.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2839" title: "Compiler Error C2839" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2839" +ms.date: 11/04/2016 f1_keywords: ["C2839"] helpviewer_keywords: ["C2839"] -ms.assetid: e4914def-2ee1-4e2e-8951-d35f9515c2b2 --- # Compiler Error C2839 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2842.md b/docs/error-messages/compiler-errors-2/compiler-error-c2842.md index dc1ed07457c..b31737736aa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2842.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2842.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2842" title: "Compiler Error C2842" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2842" +ms.date: 11/04/2016 f1_keywords: ["C2842"] helpviewer_keywords: ["C2842"] -ms.assetid: 8674f08d-9f50-46ad-9229-abc6b74fa0e5 --- # Compiler Error C2842 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md index 9cca146112f..87266f66be2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2843" title: "Compiler Error C2843" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2843" +ms.date: 11/04/2016 f1_keywords: ["C2843"] helpviewer_keywords: ["C2843"] -ms.assetid: 9d3f2ac4-eea5-4fed-abeb-e752f442bfcc --- # Compiler Error C2843 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md index 7bdc023e82e..4560e90ad50 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2844" title: "Compiler Error C2844" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2844" +ms.date: 11/04/2016 f1_keywords: ["C2844"] helpviewer_keywords: ["C2844"] -ms.assetid: dcaf4cd2-21b0-4280-ae42-0a706c524d83 --- # Compiler Error C2844 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2845.md b/docs/error-messages/compiler-errors-2/compiler-error-c2845.md index cb46da4baec..772b3afbfc4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2845.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2845.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2845" title: "Compiler Error C2845" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2845" +ms.date: 11/04/2016 f1_keywords: ["C2845"] helpviewer_keywords: ["C2845"] -ms.assetid: 31b28ee9-978f-403b-94d8-dbaacd24cce0 --- # Compiler Error C2845 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md index ef557074a58..a7e56fc19f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2846" title: "Compiler Error C2846" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2846" +ms.date: 11/04/2016 f1_keywords: ["C2846"] helpviewer_keywords: ["C2846"] -ms.assetid: bc090ec2-5410-4112-9ec6-261325374375 --- # Compiler Error C2846 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md index 6a44aaa4a32..93cc7ebfb76 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2847" title: "Compiler Error C2847" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2847" +ms.date: 11/04/2016 f1_keywords: ["C2847"] helpviewer_keywords: ["C2847"] -ms.assetid: 9ad9a0e0-8b16-49d9-a5be-f8eda2372aa9 --- # Compiler Error C2847 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md index a5c8f78d2e9..4b2afd8008a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2849" title: "Compiler Error C2849" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2849" +ms.date: 11/04/2016 f1_keywords: ["C2849"] helpviewer_keywords: ["C2849"] -ms.assetid: e28f6b3e-e0e7-4f92-b006-ebaa81d368e6 --- # Compiler Error C2849 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md index 7fd187208ef..a5720a6a0bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2850" title: "Compiler Error C2850" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2850" +ms.date: 11/04/2016 f1_keywords: ["C2850"] helpviewer_keywords: ["C2850"] -ms.assetid: f3efe86c-4168-4e76-a133-3f8314c69f51 --- # Compiler Error C2850 From 4ca46164f7a284a5eac6aea38b1f63cb5bf6d32f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 22:09:56 +0800 Subject: [PATCH 0683/1799] Remove rogue semicolon for LWG 2729 link text in "C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2019" --- docs/overview/cpp-conformance-improvements-2019.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/cpp-conformance-improvements-2019.md b/docs/overview/cpp-conformance-improvements-2019.md index e3b390b72fe..e95f1e7fd5c 100644 --- a/docs/overview/cpp-conformance-improvements-2019.md +++ b/docs/overview/cpp-conformance-improvements-2019.md @@ -455,7 +455,7 @@ The `std::bitset` constructor no longer reads the ones and zeroes in reverse ord ### `std::pair::operator=` regression -We fixed a regression in the `std::pair` assignment operator introduced when implementing [LWG 2729 "Missing SFINAE on `std::pair::operator=`";](https://cplusplus.github.io/LWG/issue2729). It now correctly accepts types convertible to `std::pair` again. +We fixed a regression in the `std::pair` assignment operator introduced when implementing [LWG 2729 "Missing SFINAE on `std::pair::operator=`"](https://cplusplus.github.io/LWG/issue2729). It now correctly accepts types convertible to `std::pair` again. ### Non-deduced contexts for `add_const_t` From da3abcb1a6a906962de517cbb02956f069083055 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 22:12:05 +0800 Subject: [PATCH 0684/1799] Fix wrong error code in "C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2019" --- docs/overview/cpp-conformance-improvements-2019.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/cpp-conformance-improvements-2019.md b/docs/overview/cpp-conformance-improvements-2019.md index e95f1e7fd5c..1eee2500447 100644 --- a/docs/overview/cpp-conformance-improvements-2019.md +++ b/docs/overview/cpp-conformance-improvements-2019.md @@ -694,7 +694,7 @@ std::equal(std::begin(a), std::end(a), std::begin(b), std::end(b)); ### Effect of defining spaceship operator on `==` and `!=` -A definition of the spaceship operator (**`<=>`**) alone will no longer rewrite expressions involving **`==`** or **`!=`** unless the spaceship operator is marked as **`= default`** ([P1185R2](https://wg21.link/p1185r2)). The following example compiles in Visual Studio 2019 RTW and version 16.1, but produces C2678 in Visual Studio 2019 version 16.2: +A definition of the spaceship operator (**`<=>`**) alone will no longer rewrite expressions involving **`==`** or **`!=`** unless the spaceship operator is marked as **`= default`** ([P1185R2](https://wg21.link/p1185r2)). The following example compiles in Visual Studio 2019 RTW and version 16.1, but produces C2676 in Visual Studio 2019 version 16.2: ```cpp #include From e0cf03b5caaef0cd24d300c5f1672471ac7fe392 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 22:15:43 +0800 Subject: [PATCH 0685/1799] Format note alert and add period in "C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2019" --- docs/overview/cpp-conformance-improvements-2019.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overview/cpp-conformance-improvements-2019.md b/docs/overview/cpp-conformance-improvements-2019.md index 1eee2500447..fcdcabc5417 100644 --- a/docs/overview/cpp-conformance-improvements-2019.md +++ b/docs/overview/cpp-conformance-improvements-2019.md @@ -67,8 +67,8 @@ To avoid the errors, insert a space in the offending line before the final angle ### References to types with mismatched cv-qualifiers ->[!Note] -> This change only affects Visual Studio 2019 versions 16.0 through 16.8. It was reverted starting in Visual Studio 2019 version 16.9 +> [!NOTE] +> This change only affects Visual Studio 2019 versions 16.0 through 16.8. It was reverted starting in Visual Studio 2019 version 16.9. Previously, MSVC allowed direct binding of a reference from a type with mismatched cv-qualifiers below the top level. This binding could allow modification of supposedly const data referred to by the reference. From 93a81c7944d0638636a922b5c0a60519f8b425d2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 22:17:49 +0800 Subject: [PATCH 0686/1799] Clean up double and trailing spaces in "C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2019" --- .../cpp-conformance-improvements-2019.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/overview/cpp-conformance-improvements-2019.md b/docs/overview/cpp-conformance-improvements-2019.md index fcdcabc5417..03fdb7fe9c9 100644 --- a/docs/overview/cpp-conformance-improvements-2019.md +++ b/docs/overview/cpp-conformance-improvements-2019.md @@ -579,8 +579,8 @@ int main() // The conversion from 'E' to the fixed underlying type 'unsigned char' is better than the // conversion from 'E' to the promoted type 'unsigned int'. f(e); - - // Error C2666. This call is ambiguous, but previously called f(unsigned int, const B&). + + // Error C2666. This call is ambiguous, but previously called f(unsigned int, const B&). f(e, B{}); } ``` @@ -885,7 +885,7 @@ The non-standard headers \ and \ have been removed. Code Two-phase name lookup requires that non-dependent names used in template bodies must be visible to the template at definition time. Previously, such names may have been found when the template is instantiated. This change makes it easier to write portable and conforming code in MSVC under the [`/permissive-`](../build/reference/permissive-standards-conformance.md) flag. -In Visual Studio 2019 version 16.4 with the **`/permissive-`** flag set, the following example produces an error, because `N::f` isn't visible when the `f` template is defined: +In Visual Studio 2019 version 16.4 with the **`/permissive-`** flag set, the following example produces an error, because `N::f` isn't visible when the `f` template is defined: ```cpp template @@ -1424,7 +1424,7 @@ In Visual Studio 2019 version 16.6 and later, the behavior of **`typedef`** decl The same restrictions are applied recursively to each nested class. The restriction is meant to ensure the simplicity of structs that have **`typedef`** names for linkage purposes. They must be simple enough that no linkage calculations are necessary before the compiler gets to the **`typedef`** name for linkage. -This change affects all standards modes of the compiler. In default (**`/std:c++14`**) and **`/std:c++17`** modes, the compiler emits warning C5208 for non-conforming code. If **`/permissive-`** is specified, the compiler emits warning C5208 as an error under **`/std:c++14`** and emits error C7626 under **`/std:c++17`**. The compiler emits error C7626 for non-conforming code when **`/std:c++20`** or **`/std:c++latest`** is specified. +This change affects all standards modes of the compiler. In default (**`/std:c++14`**) and **`/std:c++17`** modes, the compiler emits warning C5208 for non-conforming code. If **`/permissive-`** is specified, the compiler emits warning C5208 as an error under **`/std:c++14`** and emits error C7626 under **`/std:c++17`**. The compiler emits error C7626 for non-conforming code when **`/std:c++20`** or **`/std:c++latest`** is specified. The following sample shows the constructs that are no longer allowed in unnamed structs. Depending on the standards mode specified, C5208 or C7626 errors or warnings are emitted: @@ -2101,7 +2101,7 @@ The update may change program behavior that relied on an introduced temporary: int func() { int i1 = 13; int i2 = 23; - + int* iptr = &i1; int const * const& iptrcref = iptr; @@ -2110,7 +2110,7 @@ int func() { { return 1; } - + // Now change what iptr points to. // Prior to CWG 2352 iptrcref should be bound to a temporary and still points to the value 13. @@ -2151,7 +2151,7 @@ class B { template B::~B() { /* ... */ } // Before: no diagnostic. -// Now diagnoses a definition mismatch. To fix, define the implementation by +// Now diagnoses a definition mismatch. To fix, define the implementation by // using the same noexcept-specifier. For example, // B::~B() noexcept { /* ... */ } ``` @@ -2254,7 +2254,7 @@ Earlier versions of the compiler would incorrectly convert the argument of `f` f This change can also correct the chosen overload in some other situations: ```cpp -struct Base +struct Base { operator char *(); }; From f8b616e5be0e8f2695732e430ebb07cad9d8dd2a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 22:36:46 +0800 Subject: [PATCH 0687/1799] Fix wrong link to P0226R1 in "C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2017" --- docs/overview/cpp-conformance-improvements-2017.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/cpp-conformance-improvements-2017.md b/docs/overview/cpp-conformance-improvements-2017.md index af33b89fb3f..66d39ebad95 100644 --- a/docs/overview/cpp-conformance-improvements-2017.md +++ b/docs/overview/cpp-conformance-improvements-2017.md @@ -1457,7 +1457,7 @@ void sample(A<0> *p) ### C++17: Mathematical special functions -[P0226R1](https://wg21.link/p0220r1) Adopts previous technical specifications for Mathematical Special Functions into the standard *``* header. +[P0226R1](https://wg21.link/p0226r1) Adopts previous technical specifications for Mathematical Special Functions into the standard *``* header. ### C++17: Deduction guides for the standard library From 02dea38252a3325f88aff814f0221ff8df5edaee Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 22:43:40 +0800 Subject: [PATCH 0688/1799] Fix some typos in "C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2017" --- docs/overview/cpp-conformance-improvements-2017.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/overview/cpp-conformance-improvements-2017.md b/docs/overview/cpp-conformance-improvements-2017.md index 66d39ebad95..e66afb478d8 100644 --- a/docs/overview/cpp-conformance-improvements-2017.md +++ b/docs/overview/cpp-conformance-improvements-2017.md @@ -7,7 +7,7 @@ ms.subservice: "cpp-lang" --- # C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2017 -Microsoft C/C++ in Visual Studio (MSVC) makes conformance improvements and bug fixes in every release. This article lists the improvements by major release, then by version. To jump directly to the changes for a specific version, use list below **In this article**. +Microsoft C/C++ in Visual Studio (MSVC) makes conformance improvements and bug fixes in every release. This article lists the improvements by major release, then by version. To jump directly to the changes for a specific version, use the list below **In this article**. This document lists the changes in Visual Studio 2017. For a guide to the changes in Visual Studio 2022, see [C++ conformance improvements in Visual Studio 2022](cpp-conformance-improvements.md). For a guide to the changes in Visual Studio 2019, see [C++ conformance improvements in Visual Studio 2019](cpp-conformance-improvements-2019.md). For a complete list of previous conformance improvements, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). @@ -805,7 +805,7 @@ In earlier versions of Visual Studio, the compiler always gave a **`constexpr`** ### Removing allocator support in `std::function` -[P0302R1](https://wg21.link/p0302r1) Prior to C++17, the class template `std::function` had several constructors that took an allocator argument. However, the use of allocators in this context was problematic, and the semantics were unclear. The problem contructors have been removed. +[P0302R1](https://wg21.link/p0302r1) Prior to C++17, the class template `std::function` had several constructors that took an allocator argument. However, the use of allocators in this context was problematic, and the semantics were unclear. The problematic constructors have been removed. ### Fixes for `not_fn()` @@ -1051,7 +1051,7 @@ When the code doesn't need to be backwards compatible, avoid the warning by remo ### `__declspec` attributes with `extern "C"` linkage -In earlier versions of Visual Studio, the compiler ignored `__declspec(...)` attributes when `__declspec(...)` was applied before the `extern "C"` linkage specification. This behavior caused code to be generated that user didn't intend, with possible runtime implications. The [C4768](../error-messages/compiler-warnings/c4768.md) warning was added in Visual Studio version 15.3, but was off by default. In Visual Studio 2017 version 15.5, the warning is enabled by default. +In earlier versions of Visual Studio, the compiler ignored `__declspec(...)` attributes when `__declspec(...)` was applied before the `extern "C"` linkage specification. This behavior caused code to be generated that the user didn't intend, with possible runtime implications. The [C4768](../error-messages/compiler-warnings/c4768.md) warning was added in Visual Studio version 15.3, but was off by default. In Visual Studio 2017 version 15.5, the warning is enabled by default. ```cpp __declspec(noinline) extern "C" HRESULT __stdcall // C4768 @@ -1632,7 +1632,7 @@ using X = __declspec(deprecated("msg")) T; // C2760: syntax error: // expected 'type specifier' ``` -To fix the error, change to code to the following (with the attribute placed before the '=' of the alias definition): +To fix the error, change the code to the following (with the attribute placed before the '=' of the alias definition): ```cpp template From 7b4b65691d639387d66e9ea08d8cd8105ba5e705 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 22:45:51 +0800 Subject: [PATCH 0689/1799] Clean up double and trailing spaces in "C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2017" --- docs/overview/cpp-conformance-improvements-2017.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/overview/cpp-conformance-improvements-2017.md b/docs/overview/cpp-conformance-improvements-2017.md index e66afb478d8..21a28fc7af8 100644 --- a/docs/overview/cpp-conformance-improvements-2017.md +++ b/docs/overview/cpp-conformance-improvements-2017.md @@ -611,7 +611,7 @@ To fix the warning, put `extern "C"` first: extern "C" __declspec(noinline) HRESULT __stdcall ``` -This warning is off by default in Visual Studio 2017 version 15.3, and only impacts code compiled with **`/Wall`** **`/WX`**. Starting in Visual Studio 2017 version 15.5, it's enabled by default as a level 3 warning. +This warning is off by default in Visual Studio 2017 version 15.3, and only impacts code compiled with **`/Wall`** **`/WX`**. Starting in Visual Studio 2017 version 15.5, it's enabled by default as a level 3 warning. ### `decltype` and calls to deleted destructors @@ -1022,7 +1022,7 @@ To fix the error, remove the unused variable. ### Single-line comments -In Visual Studio 2017 version 15.5, warnings C4001 and C4179 are no longer emitted by the C compiler. Previously, they were only emitted under the **`/Za`** compiler switch. The warnings are no longer needed because single-line comments have been part of the C standard since C99. +In Visual Studio 2017 version 15.5, warnings C4001 and C4179 are no longer emitted by the C compiler. Previously, they were only emitted under the **`/Za`** compiler switch. The warnings are no longer needed because single-line comments have been part of the C standard since C99. ```cpp /* C only */ @@ -1116,7 +1116,7 @@ error C2027: use of undefined type 'S' ### `std::is_convertible` target type -`std::is_convertible` requires the target type to be a valid return type. In earlier versions of Visual Studio, the compiler incorrectly allowed abstract types, which might lead to incorrect overload resolution and unintended runtime behavior. The following code now correctly raises C2338: +`std::is_convertible` requires the target type to be a valid return type. In earlier versions of Visual Studio, the compiler incorrectly allowed abstract types, which might lead to incorrect overload resolution and unintended runtime behavior. The following code now correctly raises C2338: ```cpp #include @@ -1193,7 +1193,7 @@ The warning was added in Visual Studio 2017 version 15.3, but was off by default ### Defaulted functions and `__declspec(nothrow)` -The compiler previously allowed defaulted functions to be declared with `__declspec(nothrow)` when the corresponding base/member functions permitted exceptions. This behavior is contrary to the C++ standard and can cause undefined behavior at runtime. The standard requires such functions to be defined as deleted if there's an exception specification mismatch. Under **`/std:c++17`**, the following code raises C2280: +The compiler previously allowed defaulted functions to be declared with `__declspec(nothrow)` when the corresponding base/member functions permitted exceptions. This behavior is contrary to the C++ standard and can cause undefined behavior at runtime. The standard requires such functions to be defined as deleted if there's an exception specification mismatch. Under **`/std:c++17`**, the following code raises C2280: ```cpp struct A { @@ -1441,7 +1441,7 @@ void sample(A<0> *p) ### C++20: Avoiding unnecessary decay (partial) -[P0777R1](https://wg21.link/p0777r1) Adds differentiation between the concept of "decay" and that of simply removing const or reference qualifiers. New type trait `remove_reference_t` replaces `decay_t` in some contexts. Support for `remove_cvref_t` is implemented in Visual Studio 2019. +[P0777R1](https://wg21.link/p0777r1) Adds differentiation between the concept of "decay" and that of simply removing const or reference qualifiers. New type trait `remove_reference_t` replaces `decay_t` in some contexts. Support for `remove_cvref_t` is implemented in Visual Studio 2019. ### C++17: Parallel algorithms @@ -1613,7 +1613,7 @@ In [`/permissive-`](../build/reference/permissive-standards-conformance.md) mode ```cpp template -using X = typename T; // C7511: 'T': 'typename' keyword must be +using X = typename T; // C7511: 'T': 'typename' keyword must be // followed by a qualified name ``` From 96a245bbb2436690f4a4f48b2561f479f899ddcd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 22:54:48 +0800 Subject: [PATCH 0690/1799] Add blockquotes for error messages in range [C2851, C2880] --- docs/error-messages/compiler-errors-2/compiler-error-c2854.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2856.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2859.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2860.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2861.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2862.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2863.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2865.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2867.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2869.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2870.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2871.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2872.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2873.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2874.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2876.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2877.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2878.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2879.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md index f4c3ab89deb..c88f0fe9bce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md @@ -8,7 +8,7 @@ ms.assetid: 917fec9c-790a-4149-8dfc-00d17a09199c --- # Compiler Error C2854 -syntax error in #pragma hdrstop +> syntax error in #pragma hdrstop The `#pragma hdrstop` gives an invalid filename. The pragma can be followed by an optional filename in parentheses and quotation marks: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2856.md b/docs/error-messages/compiler-errors-2/compiler-error-c2856.md index 900d8c6d6a8..543a1c21e58 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2856.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2856.md @@ -8,7 +8,7 @@ ms.assetid: fe616c51-124e-49e3-9dd8-883ec1660680 --- # Compiler Error C2856 -\#pragma hdrstop cannot be inside an #if block +> #pragma hdrstop cannot be inside an #if block The `hdrstop` pragma cannot be placed inside the body of a conditional compilation block. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2859.md b/docs/error-messages/compiler-errors-2/compiler-error-c2859.md index 10dbcd0e841..f99bbb1cf9c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2859.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2859.md @@ -8,7 +8,7 @@ ms.assetid: fcfbc58d-08f6-4752-9688-8aaac517e684 --- # Compiler Error C2859 -filename is not the type file that was used when this precompiled header was created, recreate the precompiled header. +> filename is not the type file that was used when this precompiled header was created, recreate the precompiled header. The project database and precompiled header files must be created together to ensure consistent information. Rebuild the project to recreate the precompiled header. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md index 5d0d5958203..d35db99dce9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2860"] --- # Compiler Error C2860 -'void' cannot be used as a function parameter except for '(void)' +> 'void' cannot be used as a function parameter except for '(void)' A function parameter cannot be of type **`void`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md index 2a03308508a..bda2a8637d1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md @@ -8,7 +8,7 @@ ms.assetid: 012bb44d-6c9b-4def-b54e-b19f1f8ddd1b --- # Compiler Error C2861 -'function name' : an interface member function cannot be defined +> 'function name' : an interface member function cannot be defined The compiler encountered the interface keyword or deduced a struct as an interface but then found a member function definition. An interface cannot contain a definition for a member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md index 1e293348d28..37ca641ed8c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md @@ -8,7 +8,7 @@ ms.assetid: c04d8499-b799-48a1-9fb4-7902a0b0ac8e --- # Compiler Error C2862 -'interface' : an interface can only have public members +> 'interface' : an interface can only have public members Protected and private members may be accessed only from other member functions. Such members are no use in an interface, since it may not provide implementations for any of its members. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md index 5df82ef31b2..9cf8bba351c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md @@ -8,7 +8,7 @@ ms.assetid: 32561d67-a795-486b-b3b6-4b90a1acb176 --- # Compiler Error C2863 -'interface' : an interface cannot have friends +> 'interface' : an interface cannot have friends Declaring friends on an interface is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2865.md b/docs/error-messages/compiler-errors-2/compiler-error-c2865.md index 798e14910ec..de8d2d05fbb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2865.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2865.md @@ -8,7 +8,7 @@ ms.assetid: 973eb6a0-c99a-4d25-b3e5-fe0539794d77 --- # Compiler Error C2865 -'function' : illegal comparison for handle_or_pointer +> 'function' : illegal comparison for handle_or_pointer You can compare references to [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md) or managed reference types only for equality to see if they refer to the same object (==) or to different objects (!=). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md index 5a5373bcccf..bf586df2210 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md @@ -8,7 +8,7 @@ ms.assetid: 63be26b2-d9ab-4f3d-a8b7-981ce3e4d6b9 --- # Compiler Error C2867 -'identifier' : is not a namespace +> 'identifier' : is not a namespace A **`using`** directive is applied to something other than a namespace. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md index e42f10940ac..36ad2909a90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md @@ -8,7 +8,7 @@ ms.assetid: 6e30c001-47f3-4101-b9f1-cc542c9fffae --- # Compiler Error C2869 -'name' : has already been defined to be a namespace +> 'name' : has already been defined to be a namespace You cannot reuse a name already used as a namespace. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md index 47ea940abcd..27df1d85682 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md @@ -8,7 +8,7 @@ ms.assetid: 80523ee9-1fd3-4dc4-8a77-5083deb99066 --- # Compiler Error C2870 -'name' : a namespace definition must appear either at file scope or immediately within another namespace definition +> 'name' : a namespace definition must appear either at file scope or immediately within another namespace definition You defined namespace `name` incorrectly. Namespaces must be defined at file scope (outside all blocks and classes) or immediately within another namespace. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md index 2e451cbade7..a1fbef1b15d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md @@ -8,7 +8,7 @@ ms.assetid: 44aeb84d-61f0-45e0-8dad-22a3cd46b7f8 --- # Compiler Error C2871 -'name' : a namespace with this name does not exist +> 'name' : a namespace with this name does not exist This error will occur when you pass an identifier that is not a namespace to a [using](../../cpp/namespaces-cpp.md#using_directives) directive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md index 8c90fb01c05..7718d51e823 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md @@ -8,7 +8,7 @@ ms.assetid: c619ef97-6e0e-41d7-867c-f8d28a07d553 --- # Compiler Error C2872 -'*symbol*' : ambiguous symbol +> '*symbol*' : ambiguous symbol The compiler cannot determine which symbol you are referring to. More than one symbol with the specified name is in scope. See the notes following the error message for the file locations and declarations the compiler found for the ambiguous symbol. To fix this issue, you can fully qualify the ambiguous symbol by using its namespace, for example, `std::byte` or `::byte`. You can also use a [namespace alias](../../cpp/namespaces-cpp.md#namespace_aliases) to give an included namespace a convenient short name for use when disambiguating symbols in your source code. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2873.md b/docs/error-messages/compiler-errors-2/compiler-error-c2873.md index f68141e9cb5..bc5bddc3bc4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2873.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2873.md @@ -8,6 +8,6 @@ ms.assetid: 7a10036b-400e-4364-bd2f-dcd7370c5e28 --- # Compiler Error C2873 -'symbol' : symbol cannot be used in a using-declaration +> 'symbol' : symbol cannot be used in a using-declaration A **`using`** directive is missing a [namespace](../../cpp/namespaces-cpp.md) keyword. This causes the compiler to misinterpret the code as a [using declaration](../../cpp/using-declaration.md) rather than a [using directive](../../cpp/namespaces-cpp.md#using_directives). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md index f77e52f6aa5..8442862e206 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md @@ -8,7 +8,7 @@ ms.assetid: b54fa9d8-8df5-40d9-9b3b-aa3e9dd6a3be --- # Compiler Error C2874 -using-declaration causes a multiple declaration of 'symbol' +> using-declaration causes a multiple declaration of 'symbol' The declaration causes the same item to be defined twice. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md index 4aa48c784ad..c8d255d4956 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md @@ -8,7 +8,7 @@ ms.assetid: 8b674bf1-f9f4-4a8e-8127-e884c1d1708f --- # Compiler Error C2876 -'class::symbol' : not all overloads are accessible +> 'class::symbol' : not all overloads are accessible All overloaded forms of a function in a base class must be accessible to the derived class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md index dfe1367cf52..52dc619aac4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md @@ -8,7 +8,7 @@ ms.assetid: 0b54837e-fcae-4d90-9658-623250435e24 --- # Compiler Error C2877 -'symbol' is not accessible from 'class' +> 'symbol' is not accessible from 'class' All members derived from a base class must be accessible in the derived class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md index cc6a1320dac..600fa940f96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md @@ -8,7 +8,7 @@ ms.assetid: 83ee3de1-f554-49e8-a840-1f550cee7f69 --- # Compiler Error C2878 -'name' : a namespace or class of this name does not exist +> 'name' : a namespace or class of this name does not exist You made reference to a namespace or class that is not defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md index 90cfabfe639..0292204c2fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md @@ -8,7 +8,7 @@ ms.assetid: ac92b645-2394-49de-8632-43d44e0553ed --- # Compiler Error C2879 -'symbol' : only an existing namespace can be given an alternative name by a namespace alias definition +> 'symbol' : only an existing namespace can be given an alternative name by a namespace alias definition You cannot create a [namespace alias](../../cpp/namespaces-cpp.md#namespace_aliases) to a symbol other than a namespace. From 055bafe15faa4adc31913ee3d20f3b8326e9818a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 23:01:33 +0800 Subject: [PATCH 0691/1799] Add "Remarks" and "Example" headings for error references in range [C2851, C2880] --- docs/error-messages/compiler-errors-2/compiler-error-c2854.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2855.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2856.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2857.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2858.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2859.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2860.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2861.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2862.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2863.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2865.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2867.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2868.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2869.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2870.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2871.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2872.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2873.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2874.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2875.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2876.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2877.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2878.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2879.md | 4 ++++ 24 files changed, 74 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md index c88f0fe9bce..d39a8679338 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md @@ -10,8 +10,12 @@ ms.assetid: 917fec9c-790a-4149-8dfc-00d17a09199c > syntax error in #pragma hdrstop +## Remarks + The `#pragma hdrstop` gives an invalid filename. The pragma can be followed by an optional filename in parentheses and quotation marks: +## Example + The following sample generates C2854: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2855.md b/docs/error-messages/compiler-errors-2/compiler-error-c2855.md index c67e56ab236..c1d986985f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2855.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2855.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C2855"] > command-line option '*option*' inconsistent with precompiled header -This error occurs when a command-line option differs from the options used to create the precompiled header. - ## Remarks +This error occurs when a command-line option differs from the options used to create the precompiled header. + Error C2855 can occur when you make an incremental build after changing a compiler option. It can also happen if you set specific compiler options for individual source files. To resolve this error, regenerate the precompiled header by using the specified command-line option. To regenerate the precompiled header, build the associated source file. For example, projects created by a Visual Studio template usually create a source file named *`pch.cpp`* to generate the precompiled header. (In older versions of Visual Studio, this file is named *`stdafx.cpp`*.) In other projects, the source file to rebuild is the one built by using the [`/Yc` (Create precompiled header file)](../../build/reference/yc-create-precompiled-header-file.md) compiler option. We recommend you rebuild your entire project after making a change to the precompiled header. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2856.md b/docs/error-messages/compiler-errors-2/compiler-error-c2856.md index 543a1c21e58..db0ed9bc05e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2856.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2856.md @@ -10,6 +10,8 @@ ms.assetid: fe616c51-124e-49e3-9dd8-883ec1660680 > #pragma hdrstop cannot be inside an #if block +## Remarks + The `hdrstop` pragma cannot be placed inside the body of a conditional compilation block. Move the `#pragma hdrstop` statement to an area that is not contained in an `#if/#endif` block. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2857.md b/docs/error-messages/compiler-errors-2/compiler-error-c2857.md index 8b8572462b6..c76c6fc39bf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2857.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2857.md @@ -10,10 +10,10 @@ ms.assetid: b57302bd-58ec-45ae-992a-1e282d5eeccc > '#include' statement specified with the /Yc*filename* command-line option was not found in the source file -The [/Yc](../../build/reference/yc-create-precompiled-header-file.md) option specifies the name of an include file that is not included in the source file being compiled. - ## Remarks +The [/Yc](../../build/reference/yc-create-precompiled-header-file.md) option specifies the name of an include file that is not included in the source file being compiled. + When you use the **/Yc**filename option on a source file to create a precompiled header (PCH) file, that source file must include the *filename* header file. Every file included by the source file, up to and including the specified *filename*, is included in the PCH file. In other source files compiled by using the **/Yu**filename option to use the PCH file, an include of *filename* must be the first non-comment line in the file. The compiler ignores anything in the source file before this include. This error can be caused by an `#include "filename"` statement in a conditional compilation block that is not compiled in your PCH source file. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2858.md b/docs/error-messages/compiler-errors-2/compiler-error-c2858.md index 5c73c903ae3..4efb856c314 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2858.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2858.md @@ -10,6 +10,8 @@ ms.assetid: 1fb1d770-307e-476e-9984-a1d8f8ce2820 > command-line option '/Yc (/Fd*filename1*)' inconsistent with precompiled header, which used '/Fd*filename2*' +## Remarks + The program database specified by the Use Precompiled Header ([`/Yu`](../../build/reference/yu-use-precompiled-header-file.md)) option is not the one specified by the previous Create Precompiled Header ([`/Yc`](../../build/reference/yc-create-precompiled-header-file.md)) option. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2859.md b/docs/error-messages/compiler-errors-2/compiler-error-c2859.md index f99bbb1cf9c..ee6e1d67288 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2859.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2859.md @@ -10,6 +10,8 @@ ms.assetid: fcfbc58d-08f6-4752-9688-8aaac517e684 > filename is not the type file that was used when this precompiled header was created, recreate the precompiled header. +## Remarks + The project database and precompiled header files must be created together to ensure consistent information. Rebuild the project to recreate the precompiled header. For information on precompiled headers, see [/Y (Precompiled Headers)](../../build/reference/y-precompiled-headers.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md index d35db99dce9..c40cb77edf3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2860"] > 'void' cannot be used as a function parameter except for '(void)' +## Remarks + A function parameter cannot be of type **`void`**. +## Example + The following sample generates C2860: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md index bda2a8637d1..a650835ade3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md @@ -10,6 +10,8 @@ ms.assetid: 012bb44d-6c9b-4def-b54e-b19f1f8ddd1b > 'function name' : an interface member function cannot be defined +## Remarks + The compiler encountered the interface keyword or deduced a struct as an interface but then found a member function definition. An interface cannot contain a definition for a member function. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md index 37ca641ed8c..37fdea22bf7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md @@ -10,8 +10,12 @@ ms.assetid: c04d8499-b799-48a1-9fb4-7902a0b0ac8e > 'interface' : an interface can only have public members +## Remarks + Protected and private members may be accessed only from other member functions. Such members are no use in an interface, since it may not provide implementations for any of its members. +## Example + The following sample will generate C2862: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md index 9cf8bba351c..ca736cbc777 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md @@ -10,8 +10,12 @@ ms.assetid: 32561d67-a795-486b-b3b6-4b90a1acb176 > 'interface' : an interface cannot have friends +## Remarks + Declaring friends on an interface is not allowed. +## Example + The following sample generates C2863: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2865.md b/docs/error-messages/compiler-errors-2/compiler-error-c2865.md index de8d2d05fbb..f4b758b9748 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2865.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2865.md @@ -10,6 +10,8 @@ ms.assetid: 973eb6a0-c99a-4d25-b3e5-fe0539794d77 > 'function' : illegal comparison for handle_or_pointer +## Remarks + You can compare references to [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md) or managed reference types only for equality to see if they refer to the same object (==) or to different objects (!=). You cannot compare them for ordering because the .NET runtime might move managed objects at any time, changing the outcome of the test. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md index bf586df2210..ce9062d1727 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md @@ -10,8 +10,12 @@ ms.assetid: 63be26b2-d9ab-4f3d-a8b7-981ce3e4d6b9 > 'identifier' : is not a namespace +## Remarks + A **`using`** directive is applied to something other than a namespace. +## Example + The following sample generates C2867: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2868.md b/docs/error-messages/compiler-errors-2/compiler-error-c2868.md index 3c9e74506eb..364c9de8508 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2868.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2868.md @@ -10,6 +10,8 @@ ms.assetid: 6ff5837b-e66d-44d1-9d17-80af35e08d08 > '*identifier*' : illegal syntax for using-declaration; expected qualified-name +## Remarks + A [using declaration](../../cpp/using-declaration.md) requires a *qualified name*, a scope-operator (`::`) separated sequence of namespace, class, or enumeration names that ends with the identifier name. A single scope resolution operator may be used to introduce a name from the global namespace. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md index 36ad2909a90..16ad9ec94a2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md @@ -10,8 +10,12 @@ ms.assetid: 6e30c001-47f3-4101-b9f1-cc542c9fffae > 'name' : has already been defined to be a namespace +## Remarks + You cannot reuse a name already used as a namespace. +## Example + The following sample generates C2869: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md index 27df1d85682..d2c18bc9f7f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md @@ -10,8 +10,12 @@ ms.assetid: 80523ee9-1fd3-4dc4-8a77-5083deb99066 > 'name' : a namespace definition must appear either at file scope or immediately within another namespace definition +## Remarks + You defined namespace `name` incorrectly. Namespaces must be defined at file scope (outside all blocks and classes) or immediately within another namespace. +## Example + The following sample generates C2870: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md index a1fbef1b15d..f729e31a9a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md @@ -10,6 +10,8 @@ ms.assetid: 44aeb84d-61f0-45e0-8dad-22a3cd46b7f8 > 'name' : a namespace with this name does not exist +## Remarks + This error will occur when you pass an identifier that is not a namespace to a [using](../../cpp/namespaces-cpp.md#using_directives) directive. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md index 7718d51e823..83b319b3412 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md @@ -10,6 +10,8 @@ ms.assetid: c619ef97-6e0e-41d7-867c-f8d28a07d553 > '*symbol*' : ambiguous symbol +## Remarks + The compiler cannot determine which symbol you are referring to. More than one symbol with the specified name is in scope. See the notes following the error message for the file locations and declarations the compiler found for the ambiguous symbol. To fix this issue, you can fully qualify the ambiguous symbol by using its namespace, for example, `std::byte` or `::byte`. You can also use a [namespace alias](../../cpp/namespaces-cpp.md#namespace_aliases) to give an included namespace a convenient short name for use when disambiguating symbols in your source code. C2872 can occur if a header file includes a [using directive](../../cpp/namespaces-cpp.md#using_directives), and a subsequent header file is included that contains a type that is also in the namespace specified in the **`using`** directive. Specify a **`using`** directive only after all your header files are specified with `#include`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2873.md b/docs/error-messages/compiler-errors-2/compiler-error-c2873.md index bc5bddc3bc4..61f3b49cd78 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2873.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2873.md @@ -10,4 +10,6 @@ ms.assetid: 7a10036b-400e-4364-bd2f-dcd7370c5e28 > 'symbol' : symbol cannot be used in a using-declaration +## Remarks + A **`using`** directive is missing a [namespace](../../cpp/namespaces-cpp.md) keyword. This causes the compiler to misinterpret the code as a [using declaration](../../cpp/using-declaration.md) rather than a [using directive](../../cpp/namespaces-cpp.md#using_directives). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md index 8442862e206..945195f233a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md @@ -10,8 +10,12 @@ ms.assetid: b54fa9d8-8df5-40d9-9b3b-aa3e9dd6a3be > using-declaration causes a multiple declaration of 'symbol' +## Remarks + The declaration causes the same item to be defined twice. +## Example + The following sample generates C2874: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2875.md b/docs/error-messages/compiler-errors-2/compiler-error-c2875.md index ed6b53506d0..4c710d942b1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2875.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2875.md @@ -10,10 +10,14 @@ ms.assetid: d589fc0c-08b2-4a79-bc0e-dca5eb80bdd5 > using-declaration causes a multiple declaration of 'class::identifier' +## Remarks + The declaration causes the same item to be defined twice. This error is obsolete in Visual Studio 2022 and later versions. +## Example + The following sample generates C2875: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md index c8d255d4956..4eca8cd9704 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md @@ -10,8 +10,12 @@ ms.assetid: 8b674bf1-f9f4-4a8e-8127-e884c1d1708f > 'class::symbol' : not all overloads are accessible +## Remarks + All overloaded forms of a function in a base class must be accessible to the derived class. +## Example + The following sample generates C2876: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md index 52dc619aac4..ebb2d7657ee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md @@ -10,8 +10,12 @@ ms.assetid: 0b54837e-fcae-4d90-9658-623250435e24 > 'symbol' is not accessible from 'class' +## Remarks + All members derived from a base class must be accessible in the derived class. +## Example + The following sample generates C2877: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md index 600fa940f96..8d49ebbac54 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md @@ -10,8 +10,12 @@ ms.assetid: 83ee3de1-f554-49e8-a840-1f550cee7f69 > 'name' : a namespace or class of this name does not exist +## Remarks + You made reference to a namespace or class that is not defined. +## Example + The following sample generates C2878: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md index 0292204c2fd..469fae185fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md @@ -10,8 +10,12 @@ ms.assetid: ac92b645-2394-49de-8632-43d44e0553ed > 'symbol' : only an existing namespace can be given an alternative name by a namespace alias definition +## Remarks + You cannot create a [namespace alias](../../cpp/namespaces-cpp.md#namespace_aliases) to a symbol other than a namespace. +## Example + The following sample generates C2879: ```cpp From c901ee3b7581f46590d1bb5e4bf592520538d936 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 23:03:05 +0800 Subject: [PATCH 0692/1799] Replace term "sample" with "example" for error references in range [C2851, C2880] --- docs/error-messages/compiler-errors-2/compiler-error-c2854.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2857.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2860.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2861.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2862.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2863.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2864.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2867.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2868.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2869.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2870.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2871.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2872.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2874.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2875.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2876.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2877.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2878.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2879.md | 2 +- 19 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md index d39a8679338..2f1f73997d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md @@ -16,7 +16,7 @@ The `#pragma hdrstop` gives an invalid filename. The pragma can be followed by a ## Example -The following sample generates C2854: +The following example generates C2854: ```cpp // C2854.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2857.md b/docs/error-messages/compiler-errors-2/compiler-error-c2857.md index c76c6fc39bf..f72675f80be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2857.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2857.md @@ -20,7 +20,7 @@ This error can be caused by an `#include "filename"` statement in a conditional ## Example -In typical usage, one source file in your project is designated as the PCH source file, and one header file is used as the PCH header file. A typical PCH header file has all of the library headers used in your project, but not local headers that are still under development. In this sample, the PCH header file is named *my_pch.h*. +In typical usage, one source file in your project is designated as the PCH source file, and one header file is used as the PCH header file. A typical PCH header file has all of the library headers used in your project, but not local headers that are still under development. In this example, the PCH header file is named *my_pch.h*. ```cpp // my_pch.h diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md index c40cb77edf3..793d6ccf87b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md @@ -15,7 +15,7 @@ A function parameter cannot be of type **`void`**. ## Example -The following sample generates C2860: +The following example generates C2860: ```cpp // C2860.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md index a650835ade3..8c59e19122b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md @@ -16,7 +16,7 @@ The compiler encountered the interface keyword or deduced a struct as an interfa ## Example -The following sample generates C2861: +The following example generates C2861: ```cpp // C2861.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md index 37fdea22bf7..da87d381715 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md @@ -16,7 +16,7 @@ Protected and private members may be accessed only from other member functions. ## Example -The following sample will generate C2862: +The following example will generate C2862: ```cpp // C2862.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md index ca736cbc777..f28ec17bc45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md @@ -16,7 +16,7 @@ Declaring friends on an interface is not allowed. ## Example -The following sample generates C2863: +The following example generates C2863: ```cpp // C2863.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2864.md b/docs/error-messages/compiler-errors-2/compiler-error-c2864.md index 9dd8b4fe30e..bdd7632f1c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2864.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2864.md @@ -16,7 +16,7 @@ To initialize a **`static`** data member that's defined as **`volatile`**, non-* ## Example -This sample generates C2864: +This example generates C2864: ```cpp // C2864.cpp @@ -32,7 +32,7 @@ private: }; ``` -This sample shows how to fix C2864: +This example shows how to fix C2864: ```cpp // C2864b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md index ce9062d1727..86a045b2bde 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md @@ -16,7 +16,7 @@ A **`using`** directive is applied to something other than a namespace. ## Example -The following sample generates C2867: +The following example generates C2867: ```cpp // C2867.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2868.md b/docs/error-messages/compiler-errors-2/compiler-error-c2868.md index 364c9de8508..3d57df14e95 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2868.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2868.md @@ -16,7 +16,7 @@ A [using declaration](../../cpp/using-declaration.md) requires a *qualified name ## Example -The following sample generates C2868 and also shows correct usage: +The following example generates C2868 and also shows correct usage: ```cpp // C2868.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md index 16ad9ec94a2..c2da232f4b3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md @@ -16,7 +16,7 @@ You cannot reuse a name already used as a namespace. ## Example -The following sample generates C2869: +The following example generates C2869: ```cpp // C2869.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md index d2c18bc9f7f..6e5addcfcff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md @@ -16,7 +16,7 @@ You defined namespace `name` incorrectly. Namespaces must be defined at file sco ## Example -The following sample generates C2870: +The following example generates C2870: ```cpp // C2870.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md index f729e31a9a0..341b85b7046 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md @@ -16,7 +16,7 @@ This error will occur when you pass an identifier that is not a namespace to a [ ## Example -The following sample generates C2871: +The following example generates C2871: ```cpp // C2871.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md index 83b319b3412..d4586bd17f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md @@ -24,7 +24,7 @@ C2872 can occur in Visual Studio 2013 due to a conflict between the `Windows::Fo ## Example -The following sample generates C2872, because an ambiguous reference is made to a variable named `i`; two variables with the same name are in scope: +The following example generates C2872, because an ambiguous reference is made to a variable named `i`; two variables with the same name are in scope: ```cpp // C2872.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md index 945195f233a..25b0b9201d0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md @@ -16,7 +16,7 @@ The declaration causes the same item to be defined twice. ## Example -The following sample generates C2874: +The following example generates C2874: ```cpp // C2874.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2875.md b/docs/error-messages/compiler-errors-2/compiler-error-c2875.md index 4c710d942b1..ff4b0b49f16 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2875.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2875.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Example -The following sample generates C2875: +The following example generates C2875: ```cpp // C2875.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md index 4eca8cd9704..af2bb3f2d88 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md @@ -16,7 +16,7 @@ All overloaded forms of a function in a base class must be accessible to the der ## Example -The following sample generates C2876: +The following example generates C2876: ```cpp // C2876.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md index ebb2d7657ee..94c11b20d7e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md @@ -16,7 +16,7 @@ All members derived from a base class must be accessible in the derived class. ## Example -The following sample generates C2877: +The following example generates C2877: ```cpp // C2877.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md index 8d49ebbac54..f41e0c1c0e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md @@ -16,7 +16,7 @@ You made reference to a namespace or class that is not defined. ## Example -The following sample generates C2878: +The following example generates C2878: ```cpp // C2878.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md index 469fae185fd..0cf0e501595 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md @@ -16,7 +16,7 @@ You cannot create a [namespace alias](../../cpp/namespaces-cpp.md#namespace_alia ## Example -The following sample generates C2879: +The following example generates C2879: ```cpp // C2879.cpp From 4bb41b2e213cdcb7cd100c10b8580e9be2c46e90 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 9 Aug 2025 23:07:57 +0800 Subject: [PATCH 0693/1799] Update metadata for error references in range [C2851, C2880] --- .../error-messages/compiler-errors-2/compiler-error-c2854.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2855.md | 2 +- .../error-messages/compiler-errors-2/compiler-error-c2856.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2857.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2858.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2859.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2860.md | 4 ++-- .../error-messages/compiler-errors-2/compiler-error-c2861.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2862.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2863.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2864.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2865.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2867.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2868.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2869.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2870.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2871.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2872.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2873.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2874.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2875.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2876.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2877.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2878.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2879.md | 5 ++--- 25 files changed, 47 insertions(+), 70 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md index 2f1f73997d5..881fa57914a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2854" title: "Compiler Error C2854" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2854" +ms.date: 11/04/2016 f1_keywords: ["C2854"] helpviewer_keywords: ["C2854"] -ms.assetid: 917fec9c-790a-4149-8dfc-00d17a09199c --- # Compiler Error C2854 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2855.md b/docs/error-messages/compiler-errors-2/compiler-error-c2855.md index c1d986985f8..03760f6647a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2855.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2855.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2855" title: "Compiler Error C2855" +description: "Learn more about: Compiler Error C2855" ms.date: 02/16/2021 f1_keywords: ["C2855"] helpviewer_keywords: ["C2855"] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2856.md b/docs/error-messages/compiler-errors-2/compiler-error-c2856.md index db0ed9bc05e..1a6f8ec7dd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2856.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2856.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2856" title: "Compiler Error C2856" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2856" +ms.date: 11/04/2016 f1_keywords: ["C2856"] helpviewer_keywords: ["C2856"] -ms.assetid: fe616c51-124e-49e3-9dd8-883ec1660680 --- # Compiler Error C2856 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2857.md b/docs/error-messages/compiler-errors-2/compiler-error-c2857.md index f72675f80be..f81d9f06527 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2857.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2857.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2857" title: "Compiler Error C2857" -ms.date: "09/13/2018" +description: "Learn more about: Compiler Error C2857" +ms.date: 09/13/2018 f1_keywords: ["C2857"] helpviewer_keywords: ["C2857"] -ms.assetid: b57302bd-58ec-45ae-992a-1e282d5eeccc --- # Compiler Error C2857 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2858.md b/docs/error-messages/compiler-errors-2/compiler-error-c2858.md index 4efb856c314..5779b92df96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2858.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2858.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2858" title: "Compiler Error C2858" +description: "Learn more about: Compiler Error C2858" ms.date: 06/01/2022 f1_keywords: ["C2858"] helpviewer_keywords: ["C2858"] -ms.assetid: 1fb1d770-307e-476e-9984-a1d8f8ce2820 --- # Compiler Error C2858 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2859.md b/docs/error-messages/compiler-errors-2/compiler-error-c2859.md index ee6e1d67288..5d2a5e941e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2859.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2859.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2859" title: "Compiler Error C2859" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2859" +ms.date: 11/04/2016 f1_keywords: ["C2859"] helpviewer_keywords: ["C2859"] -ms.assetid: fcfbc58d-08f6-4752-9688-8aaac517e684 --- # Compiler Error C2859 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md index 793d6ccf87b..3ac684a3f24 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2860" title: "Compiler Error C2860" -ms.date: "03/16/2024" +description: "Learn more about: Compiler Error C2860" +ms.date: 03/16/2024 f1_keywords: ["C2860"] helpviewer_keywords: ["C2860"] --- diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md index 8c59e19122b..eeba808fa07 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2861" title: "Compiler Error C2861" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2861" +ms.date: 11/04/2016 f1_keywords: ["C2861"] helpviewer_keywords: ["C2861"] -ms.assetid: 012bb44d-6c9b-4def-b54e-b19f1f8ddd1b --- # Compiler Error C2861 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md index da87d381715..ccef63bbcf6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2862" title: "Compiler Error C2862" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2862" +ms.date: 11/04/2016 f1_keywords: ["C2862"] helpviewer_keywords: ["C2862"] -ms.assetid: c04d8499-b799-48a1-9fb4-7902a0b0ac8e --- # Compiler Error C2862 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md index f28ec17bc45..dbd762cdf7e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2863" title: "Compiler Error C2863" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2863" +ms.date: 11/04/2016 f1_keywords: ["C2863"] helpviewer_keywords: ["C2863"] -ms.assetid: 32561d67-a795-486b-b3b6-4b90a1acb176 --- # Compiler Error C2863 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2864.md b/docs/error-messages/compiler-errors-2/compiler-error-c2864.md index bdd7632f1c7..950b3a8bacb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2864.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2864.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2864" title: "Compiler Error C2864" +description: "Learn more about: Compiler Error C2864" ms.date: 10/04/2019 f1_keywords: ["C2864"] helpviewer_keywords: ["C2864"] -ms.assetid: d0ca2ad9-90a6-4aef-8511-98a3b414c102 --- # Compiler Error C2864 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2865.md b/docs/error-messages/compiler-errors-2/compiler-error-c2865.md index f4b758b9748..1f9f9040dfc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2865.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2865.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2865" title: "Compiler Error C2865" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2865" +ms.date: 11/04/2016 f1_keywords: ["C2865"] helpviewer_keywords: ["C2865"] -ms.assetid: 973eb6a0-c99a-4d25-b3e5-fe0539794d77 --- # Compiler Error C2865 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md index 86a045b2bde..6f82ffe3058 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2867" title: "Compiler Error C2867" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2867" +ms.date: 11/04/2016 f1_keywords: ["C2867"] helpviewer_keywords: ["C2867"] -ms.assetid: 63be26b2-d9ab-4f3d-a8b7-981ce3e4d6b9 --- # Compiler Error C2867 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2868.md b/docs/error-messages/compiler-errors-2/compiler-error-c2868.md index 3d57df14e95..aace8ea2a24 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2868.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2868.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2868" title: "Compiler Error C2868" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2868" +ms.date: 11/04/2016 f1_keywords: ["C2868"] helpviewer_keywords: ["C2868"] -ms.assetid: 6ff5837b-e66d-44d1-9d17-80af35e08d08 --- # Compiler Error C2868 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md index c2da232f4b3..74243dc953f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2869" title: "Compiler Error C2869" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2869" +ms.date: 11/04/2016 f1_keywords: ["C2869"] helpviewer_keywords: ["C2869"] -ms.assetid: 6e30c001-47f3-4101-b9f1-cc542c9fffae --- # Compiler Error C2869 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md index 6e5addcfcff..0aa1c8d1ccd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2870" title: "Compiler Error C2870" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2870" +ms.date: 11/04/2016 f1_keywords: ["C2870"] helpviewer_keywords: ["C2870"] -ms.assetid: 80523ee9-1fd3-4dc4-8a77-5083deb99066 --- # Compiler Error C2870 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md index 341b85b7046..c3261549f3c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2871" title: "Compiler Error C2871" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2871" +ms.date: 11/04/2016 f1_keywords: ["C2871"] helpviewer_keywords: ["C2871"] -ms.assetid: 44aeb84d-61f0-45e0-8dad-22a3cd46b7f8 --- # Compiler Error C2871 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md index d4586bd17f7..9e5f59ead02 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2872" title: "Compiler Error C2872" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2872" +ms.date: 11/04/2016 f1_keywords: ["C2872"] helpviewer_keywords: ["C2872"] -ms.assetid: c619ef97-6e0e-41d7-867c-f8d28a07d553 --- # Compiler Error C2872 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2873.md b/docs/error-messages/compiler-errors-2/compiler-error-c2873.md index 61f3b49cd78..befff3cf35f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2873.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2873.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2873" title: "Compiler Error C2873" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2873" +ms.date: 11/04/2016 f1_keywords: ["C2873"] helpviewer_keywords: ["C2873"] -ms.assetid: 7a10036b-400e-4364-bd2f-dcd7370c5e28 --- # Compiler Error C2873 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md index 25b0b9201d0..2903d83b7e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2874" title: "Compiler Error C2874" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2874" +ms.date: 11/04/2016 f1_keywords: ["C2874"] helpviewer_keywords: ["C2874"] -ms.assetid: b54fa9d8-8df5-40d9-9b3b-aa3e9dd6a3be --- # Compiler Error C2874 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2875.md b/docs/error-messages/compiler-errors-2/compiler-error-c2875.md index ff4b0b49f16..2a2e0688f85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2875.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2875.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2875" title: "Compiler Error C2875" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2875" +ms.date: 11/04/2016 f1_keywords: ["C2875"] helpviewer_keywords: ["C2875"] -ms.assetid: d589fc0c-08b2-4a79-bc0e-dca5eb80bdd5 --- # Compiler Error C2875 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md index af2bb3f2d88..d102a7f0192 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2876" title: "Compiler Error C2876" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2876" +ms.date: 11/04/2016 f1_keywords: ["C2876"] helpviewer_keywords: ["C2876"] -ms.assetid: 8b674bf1-f9f4-4a8e-8127-e884c1d1708f --- # Compiler Error C2876 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md index 94c11b20d7e..62a17b4f704 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2877" title: "Compiler Error C2877" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2877" +ms.date: 11/04/2016 f1_keywords: ["C2877"] helpviewer_keywords: ["C2877"] -ms.assetid: 0b54837e-fcae-4d90-9658-623250435e24 --- # Compiler Error C2877 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md index f41e0c1c0e1..d5c043adce3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2878" title: "Compiler Error C2878" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2878" +ms.date: 11/04/2016 f1_keywords: ["C2878"] helpviewer_keywords: ["C2878"] -ms.assetid: 83ee3de1-f554-49e8-a840-1f550cee7f69 --- # Compiler Error C2878 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md index 0cf0e501595..0baee26805f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2879" title: "Compiler Error C2879" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2879" +ms.date: 11/04/2016 f1_keywords: ["C2879"] helpviewer_keywords: ["C2879"] -ms.assetid: ac92b645-2394-49de-8632-43d44e0553ed --- # Compiler Error C2879 From 2050d226bcf920db1de13a11dc57a9012470d89a Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Sat, 9 Aug 2025 14:15:21 -0700 Subject: [PATCH 0694/1799] Update routine-mappings.md remove stray api_name metadata --- docs/c-runtime-library/routine-mappings.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/c-runtime-library/routine-mappings.md b/docs/c-runtime-library/routine-mappings.md index 8c75157b5c5..e36658b7393 100644 --- a/docs/c-runtime-library/routine-mappings.md +++ b/docs/c-runtime-library/routine-mappings.md @@ -3,7 +3,6 @@ title: "Generic-text function mappings" description: "Learn more about: Microsoft specific generic-text functions and the CRT functions they map to." ms.date: 11/04/2016 ms.author: twhitney -api_name: ["foo",] f1_keywords: ["_cgetts", "_cgetts_s", "_cputts", "_fgettc", "_fgettchar", "_fgetts", "_fputtc", "_fputtchar", "_fputts", "_ftscanf", "_ftscanf_s", "_gettc", "_gettch", "_gettchar", "_gettche", "_getts", "_getts_s", "_istalnum", "_istalpha", "_istascii", "_istcntrl", "_istdigit", "_istgraph", "_istlead", "_istleadbyte", "_istlegal", "_istlower", "_istprint", "_istpunct", "_istspace", "_istupper", "_istxdigit", "_itot", "_itot_s", "_ltot", "_ltot_s", "_puttc", "_puttch", "_puttchar", "_putts", "_sctprintf", "_sntprintf", "_sntprintf_s", "_sntscanf", "_sntscanf_s", "_stprintf", "_stprintf_s", "_stscanf", "_stscanf_s", "_taccess", "_tasctime", "_tasctime_s", "_tccmp", "_tccpy", "_tccpy_s", "_tchdir", "_tclen", "_tchmod", "_tcprintf", "_tcprintf_s", "_tcreat", "_tcscanf", "_tcscanf_s", "_tcscat", "_tcscat_s", "_tcschr", "_tcsclen", "_tcsclen_s", "_tcscmp", "_tcscoll", "_tcscpy", "_tcscpy_s", "_tcscspn", "_tcsdec", "_tcsdup", "_tcserror", "_tcserror_s", "_tcsftime", "_tcsicmp", "_tcsicoll", "_tcsinc", "_tcslen", "_tcslwr", "_tcslwr_s", "_tcsnbcnt", "_tcsncat", "_tcsncat_s", "_tcsnccat", "_tcsnccmp", "_tcsnccmp_s", "_tcsnccoll", "_tcsncmp", "_tcsnccnt", "_tcsnccpy", "_tcsncicmp", "_tcsncicoll", "_tcsncpy", "_tcsncset", "_tcsnextc", "_tcsnicmp", "_tcsnicoll", "_tcsninc", "_tcsnccnt", "_tcsnset", "_tcspbrk", "_tcsspnp", "_tcsrchr", "_tcsrev", "_tcsset", "_tcsspn", "_tcsstr", "_tcstod", "_tcstoi64", "_tcstok", "_tcstok_s", "_tcstol", "_tcstoui64", "_tcstoul", "_tcsupr", "_tcsupr_s", "_tcsxfrm", "_tctime", "_tctime_s", "_tctime32", "_tctime32_s", "_tctime64", "_tctime64_s", "_texecl", "_texecle", "_texeclp", "_texeclpe", "_texecv", "_texecve", "_texecvp", "_texecvpe", "_tfdopen", "_tfindfirst", "_tfindnext", "_tfindnext32", "_tfindnext64", "_tfindnexti64", "_tfindnexti6432", "_tfindnext32i64", "_tfopen", "_tfopen_s", "_tfreopen", "_tfreopen_s", "_tfsopen", "_tfullpath", "_tgetcwd", "_tgetdcwd", "_tgetenv", "_tgetenv_s", "_tmain", "_tmakepath", "_tmakepath_s", "_tmkdir", "_tmktemp", "_tmktemp_s", "_topen", "_topen_s", "_totlower", "_totupper", "_tperror", "_tpopen", "_tprintf", "_tprintf_s", "_tputenv", "_tremove", "_trename", "_trmdir", "_tsearchenv", "_tsearchenv_s", "_tscanf", "_tscanf_s", "_tsetlocale", "_tsopen", "_tsopen_s", "_tspawnl", "_tspawnle", "_tspawnlp", "_tspawnlpe", "_tspawnv", "_tspawnve", "_tspawnvp", "_tspawnvpe", "_tsplitpath", "_tstat", "_tstat32", "_tstati32", "_tstat64", "_tstati64", "_tstof", "_tstoi", "_tstoi64", "_tstol", "_tstrdate", "_tstrdate_s", "_tstrtime", "_tstrtime_s", "_tsystem", "_ttempnam", "_ttmpnam", "_ttmpnam_s", "_ttoi", "_ttoi64", "_ttol", "_tunlink", "_tutime", "_tutime32", "_tutime64", "_tWinMain", "_ui64tot", "_ui64tot_s", "_ultot", "_ultot_s", "_ungettc", "_ungettch", "_vftprintf", "_vftprintf_s", "_vsctprintf", "_vsctprintf_s", "_vsntprintf", "_vsntprintf_s", "_vstprintf", "_vtprintf", "_vtprintf_s"] helpviewer_keywords: ["_tWinMain", "TCHAR.H functions, list of generic-text function mappings", "generic-text mappings", "_cgetts function", "_cgetts_s function", "_cputts function", "_fgettc function", "_fgettchar function", "_fgetts function", "_fputtc function", "_fputtchar function", "_fputts function", "_ftscanf function", "_ftscanf_s function", "_gettc function", "_gettch function", "_gettchar function", "_gettche function", "_getts function", "_getts_s function", "_istalnum function", "_istalpha function", "_istascii function", "_istcntrl function", "_istdigit function", "_istgraph function", "_istlead function", "_istleadbyte function", "_istlegal function", "_istlower function", "_istprint function", "_istpunct function", "_istspace function", "_istupper function", "_istxdigit function", "_itot function", "_itot_s function", "_ltot function", "_ltot_s function", "_puttc function", "_puttch function", "_puttchar function", "_putts function", "_sctprintf function", "_sntprintf function", "_sntprintf_s function", "_sntscanf function", "_sntscanf_s function", "_stprintf function", "_stprintf_s function", "_stscanf function", "_stscanf_s function", "_taccess function", "_tasctime function", "_tasctime_s function", "_tccmp function", "_tccpy function", "_tccpy_s function", "_tchdir function", "_tclen function", "_tchmod function", "_tcprintf function", "_tcprintf_s function", "_tcreat function", "_tcscanf function", "_tcscanf_s function", "_tcscat function", "_tcscat_s function", "_tcschr function", "_tcsclen function", "_tcsclen_s function", "_tcscmp function", "_tcscoll function", "_tcscpy function", "_tcscpy_s function", "_tcscspn function", "_tcsdec function", "_tcsdup function", "_tcserror function", "_tcserror_s function", "_tcsftime function", "_tcsicmp function", "_tcsicoll function", "_tcsinc function", "_tcslen function", "_tcslwr function", "_tcslwr_s function", "_tcsnbcnt function", "_tcsncat function", "_tcsncat_s function", "_tcsnccat function", "_tcsnccmp function", "_tcsnccmp_s function", "_tcsnccoll function", "_tcsncmp function", "_tcsnccnt function", "_tcsnccpy function", "_tcsncicmp function", "_tcsncicoll function", "_tcsncpy function", "_tcsncset function", "_tcsnextc function", "_tcsnicmp function", "_tcsnicoll function", "_tcsninc function", "_tcsnccnt function", "_tcsnset function", "_tcspbrk function", "_tcsspnp function", "_tcsrchr function", "_tcsrev function", "_tcsset function", "_tcsspn function", "_tcsstr function", "_tcstod function", "_tcstoi64 function", "_tcstok function", "_tcstok_s function", "_tcstol function", "_tcstoui64 function", "_tcstoul function", "_tcsupr function", "_tcsupr_s function", "_tcsxfrm function", "_tctime function", "_tctime_s function", "_tctime32 function", "_tctime32_s function", "_tctime64 function", "_tctime64_s function", "_texecl function", "_texecle function", "_texeclp function", "_texeclpe function", "_texecv function", "_texecve function", "_texecvp function", "_texecvpe function", "_tfdopen function", "_tfindfirst function", "_tfindnext function", "_tfindnext32 function", "_tfindnext64 function", "_tfindnexti64 function", "_tfindnexti6432 function", "_tfindnext32i64 function", "_tfopen function", "_tfopen_s function", "_tfreopen function", "_tfreopen_s function", "_tfsopen function", "_tfullpath function", "_tgetcwd function", "_tgetdcwd function", "_tgetenv function", "_tgetenv_s function", "_tmain function", "_tmakepath function", "_tmakepath_s function", "_tmkdir function", "_tmktemp function", "_tmktemp_s function", "_topen function", "_topen_s function", "_totlower function", "_totupper function", "_tperror function", "_tpopen function", "_tprintf function", "_tprintf_s function", "_tputenv function", "_tremove function", "_trename function", "_trmdir function", "_tsearchenv function", "_tsearchenv_s function", "_tscanf function", "_tscanf_s function", "_tsetlocale function", "_tsopen function", "_tsopen_s function", "_tspawnl function", "_tspawnle function", "_tspawnlp function", "_tspawnlpe function", "_tspawnv function", "_tspawnve function", "_tspawnvp function", "_tspawnvpe function", "_tsplitpath function", "_tstat function", "_tstat32 function", "_tstati32 function", "_tstat64 function", "_tstati64 function", "_tstof function", "_tstoi function", "_tstoi64 function", "_tstol function", "_tstrdate function", "_tstrdate_s function", "_tstrtime function", "_tstrtime_s function", "_tsystem function", "_ttempnam function", "_ttmpnam function", "_ttmpnam_s function", "_ttoi function", "_ttoi64 function", "_ttol function", "_tunlink function", "_tutime function", "_tutime32 function", "_tutime64 function", "_tWinMain function", "_ui64tot function", "_ui64tot_s function", "_ultot function", "_ultot_s function", "_ungettc function", "_ungettch function", "_vftprintf function", "_vftprintf_s function", "_vsctprintf function", "_vsctprintf_s function", "_vsntprintf function", "_vsntprintf_s function", "_vstprintf function", "_vtprintf function", "_vtprintf_s function"] --- From 20dcd8b5965b318f0d969d5cb235a9ab1e31ec6c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 17:54:10 +0800 Subject: [PATCH 0695/1799] Add blockquotes for error messages in range [C2881, C2910] --- docs/error-messages/compiler-errors-2/compiler-error-c2881.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2882.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2883.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2884.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2885.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2886.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2888.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2890.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2891.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2892.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2893.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2894.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2897.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2898.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2903.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2904.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2906.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2908.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2909.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2910.md | 2 +- 20 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md index 45d454a253a..84b384001aa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md @@ -8,7 +8,7 @@ ms.assetid: b49c63c2-b064-4d4b-a75e-ddd2af947522 --- # Compiler Error C2881 -'namespace1' : is already used as an alias for 'namespace2' +> 'namespace1' : is already used as an alias for 'namespace2' You cannot use the same name as an alias for two namespaces. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md index e3a0d257e3e..14de286f178 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md @@ -8,7 +8,7 @@ ms.assetid: 617018ee-5a0d-4b8d-9612-77e8ae52679b --- # Compiler Error C2882 -'name' : illegal use of namespace identifier in expression +> 'name' : illegal use of namespace identifier in expression You tried to use the name of a namespace in an expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md index e503e3d6ad6..027381bf55b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md @@ -8,7 +8,7 @@ ms.assetid: 5c6d689d-ed42-41ad-b5c0-e9c2e0b8c356 --- # Compiler Error C2883 -'name' : function declaration conflicts with 'identifier' introduced by using-declaration +> 'name' : function declaration conflicts with 'identifier' introduced by using-declaration You tried to define a function more than once. The first definition was made from a namespace with a **`using`** declaration. The second was a local definition. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md index fedd4259709..5353c2a6c9b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md @@ -8,7 +8,7 @@ ms.assetid: 8b4d43e3-3fb5-4360-86c8-de59d8736d4f --- # Compiler Error C2884 -'name' : introduced by using-declaration conflicts with local function 'function' +> 'name' : introduced by using-declaration conflicts with local function 'function' You tried to define a function more than once. The first definition is a local definition. The second is from a namespace with a **`using`** declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md index 018ee3660e2..4ca437c592d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md @@ -8,7 +8,7 @@ ms.assetid: 7743e5f3-a034-44b4-9ee8-5a6254c27f8c --- # Compiler Error C2885 -'class::identifier' : not a valid using-declaration at non-class scope +> 'class::identifier' : not a valid using-declaration at non-class scope You used a [using](../../cpp/using-declaration.md) declaration incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md index b93a4b5c767..e4f99e84eaa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md @@ -8,7 +8,7 @@ ms.assetid: c01588a1-484c-4dc9-a3f1-f900c6e44543 --- # Compiler Error C2886 -'class::identifier' : symbol cannot be used in a member using-declaration +> 'class::identifier' : symbol cannot be used in a member using-declaration A **`using`** declaration uses a symbol, such as a namespace name. A **`using`** declaration is for declaring base class members. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2888.md b/docs/error-messages/compiler-errors-2/compiler-error-c2888.md index eed0d34ea2f..2523dff66d0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2888.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2888.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2888"] --- # Compiler Error C2888 -'identifier' : symbol cannot be defined within namespace 'namespace' +> 'identifier' : symbol cannot be defined within namespace 'namespace' A symbol belonging to namespace A must be defined in a namespace that encloses A. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md index d17bdde458f..d34264cfaca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md @@ -8,7 +8,7 @@ ms.assetid: 49147375-182c-42b1-b170-f475cd436d47 --- # Compiler Error C2890 -'class' : a ref class can only have one non-interface base class +> 'class' : a ref class can only have one non-interface base class A reference class can only have one base class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md index f9b41d60076..8d1719da6cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2891"] --- # Compiler Error C2891 -'parameter' : cannot take the address of a template parameter +> 'parameter' : cannot take the address of a template parameter You can't take the address of a template parameter unless it is an lvalue. Type parameters are not lvalues because they have no address. Non-type values in template parameter lists that are not lvalues also do not have an address. This is an example of code that causes Compiler Error C2891, because the value passed as the template parameter is a compiler-generated copy of the template argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md index 4ae86e0ab38..f6917c2efef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md @@ -8,7 +8,7 @@ ms.assetid: c22a5084-2f50-42c2-a56b-6dfe5442edc9 --- # Compiler Error C2892 -local class shall not have member templates +> local class shall not have member templates Templated member functions are not valid in a class that is defined in a function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md index 01cb21c042a..c4ab267c838 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2893"] --- # Compiler Error C2893 -Failed to specialize function template 'template name' +> Failed to specialize function template 'template name' The compiler failed to specialize a function template. There can be many causes for this error. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md index 1d4ddc374de..6bbd6f8600e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md @@ -8,7 +8,7 @@ ms.assetid: 4e250579-2b59-4993-a6f4-49273e7ecf06 --- # Compiler Error C2894 -templates cannot be declared to have 'C' linkage +> templates cannot be declared to have 'C' linkage This error can be caused by a template defined inside an `extern "C"` block. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md index f68c4fe3304..da51f88e0db 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md @@ -8,7 +8,7 @@ ms.assetid: a88349e2-823f-42a0-8660-0653b677afa4 --- # Compiler Error C2897 -a destructor/finalizer cannot be a function template +> a destructor/finalizer cannot be a function template Destructors or finalizers cannot be overloaded, so declaring a destructor as a template (which would define a set of destructors) is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md index f4dd5343894..f864bcfebda 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md @@ -8,7 +8,7 @@ ms.assetid: 68466e11-2541-4f6b-b772-13a642f30dfb --- # Compiler Error C2898 -'declaration' : member function templates cannot be virtual +> 'declaration' : member function templates cannot be virtual The following sample generates C2898: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md index 4b8619c11ef..31e95dcfc31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md @@ -8,7 +8,7 @@ ms.assetid: bf6b223f-4921-48c7-82b9-ff318b42c801 --- # Compiler Error C2903 -'identifier' : symbol is neither a class template nor a function template +> 'identifier' : symbol is neither a class template nor a function template Code attempts explicit instantiation of something that is not a template. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md index c499ffed634..d77ebda8520 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md @@ -8,7 +8,7 @@ ms.assetid: d5802f2e-d3fc-473d-aa04-36957b4eaca5 --- # Compiler Error C2904 -'identifier' : name already used for a template in the current scope +> 'identifier' : name already used for a template in the current scope Check the code for duplicate names. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md index f48e4457855..602b48cf51f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md @@ -8,7 +8,7 @@ ms.assetid: 30f652f1-6af6-4a2f-a69e-a1a4876cc8c6 --- # Compiler Error C2906 -'specialization' : explicit specialization requires 'template <>' +> 'specialization' : explicit specialization requires 'template <>' You must use the new syntax for explicit specialization of templates. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md index 19d7588b5f4..4023e1b4c3e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md @@ -8,7 +8,7 @@ ms.assetid: 49cd2a21-cad8-4ba0-9a0b-3a0190d9344c --- # Compiler Error C2908 -explicit specialization; 'template' has already been instantiated +> explicit specialization; 'template' has already been instantiated A specialization of the primary template occurs before the explicit specialization. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md index 6483ee73dad..3c3dd40af47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md @@ -8,7 +8,7 @@ ms.assetid: 1c9df8ae-925d-4002-a5f8-a71413c45f9e --- # Compiler Error C2909 -'identifier': explicit instantiation of function template requires return type +> 'identifier': explicit instantiation of function template requires return type An explicit instantiation of a function template requires explicit specification of its return type. Implicit return type specification does not work. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md index 1aa3cc27a3d..c6b012013b7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md @@ -8,7 +8,7 @@ ms.assetid: 09c50e6a-e099-42f6-8ed6-d80e292a7a36 --- # Compiler Error C2910 -'function' : cannot be explicitly specialized +> 'function' : cannot be explicitly specialized The compiler detected an attempt to explicitly specialize a function twice. From cf7b65db16fe9b9981ed62e30e24f14846a571b7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 18:03:02 +0800 Subject: [PATCH 0696/1799] Add "Remarks" and "Example" headings for error references in range [C2881, C2910] --- .../compiler-errors-2/compiler-error-c2881.md | 4 ++++ .../compiler-errors-2/compiler-error-c2882.md | 4 ++++ .../compiler-errors-2/compiler-error-c2883.md | 4 ++++ .../compiler-errors-2/compiler-error-c2884.md | 4 ++++ .../compiler-errors-2/compiler-error-c2885.md | 2 ++ .../compiler-errors-2/compiler-error-c2886.md | 4 ++++ .../compiler-errors-2/compiler-error-c2888.md | 4 ++++ .../compiler-errors-2/compiler-error-c2890.md | 4 ++++ .../compiler-errors-2/compiler-error-c2891.md | 8 +++++++- .../compiler-errors-2/compiler-error-c2892.md | 4 ++++ .../compiler-errors-2/compiler-error-c2893.md | 2 ++ .../compiler-errors-2/compiler-error-c2894.md | 4 ++++ .../compiler-errors-2/compiler-error-c2896.md | 4 ++++ .../compiler-errors-2/compiler-error-c2897.md | 2 ++ .../compiler-errors-2/compiler-error-c2898.md | 2 ++ .../compiler-errors-2/compiler-error-c2902.md | 4 ++++ .../compiler-errors-2/compiler-error-c2903.md | 4 ++++ .../compiler-errors-2/compiler-error-c2904.md | 4 ++++ .../compiler-errors-2/compiler-error-c2906.md | 4 ++++ .../compiler-errors-2/compiler-error-c2908.md | 4 ++++ .../compiler-errors-2/compiler-error-c2909.md | 4 ++++ .../compiler-errors-2/compiler-error-c2910.md | 4 ++++ 22 files changed, 83 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md index 84b384001aa..0b058a1e996 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md @@ -10,8 +10,12 @@ ms.assetid: b49c63c2-b064-4d4b-a75e-ddd2af947522 > 'namespace1' : is already used as an alias for 'namespace2' +## Remarks + You cannot use the same name as an alias for two namespaces. +## Example + The following sample generates C2881: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md index 14de286f178..784e34914c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md @@ -10,8 +10,12 @@ ms.assetid: 617018ee-5a0d-4b8d-9612-77e8ae52679b > 'name' : illegal use of namespace identifier in expression +## Remarks + You tried to use the name of a namespace in an expression. +## Example + The following sample generates C2882: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md index 027381bf55b..6e20a21ed4e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md @@ -10,8 +10,12 @@ ms.assetid: 5c6d689d-ed42-41ad-b5c0-e9c2e0b8c356 > 'name' : function declaration conflicts with 'identifier' introduced by using-declaration +## Remarks + You tried to define a function more than once. The first definition was made from a namespace with a **`using`** declaration. The second was a local definition. +## Example + The following sample generates C2883: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md index 5353c2a6c9b..6c2d22971dd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md @@ -10,8 +10,12 @@ ms.assetid: 8b4d43e3-3fb5-4360-86c8-de59d8736d4f > 'name' : introduced by using-declaration conflicts with local function 'function' +## Remarks + You tried to define a function more than once. The first definition is a local definition. The second is from a namespace with a **`using`** declaration. +## Example + The following sample generates C2884: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md index 4ca437c592d..98247bffdc2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md @@ -10,6 +10,8 @@ ms.assetid: 7743e5f3-a034-44b4-9ee8-5a6254c27f8c > 'class::identifier' : not a valid using-declaration at non-class scope +## Remarks + You used a [using](../../cpp/using-declaration.md) declaration incorrectly. This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: it is no longer valid to have a **`using`** declaration to a nested type; you must explicitly qualify each reference you make to the nested type, put the type in a namespace, or create a typedef. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md index e4f99e84eaa..376b185c245 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md @@ -10,8 +10,12 @@ ms.assetid: c01588a1-484c-4dc9-a3f1-f900c6e44543 > 'class::identifier' : symbol cannot be used in a member using-declaration +## Remarks + A **`using`** declaration uses a symbol, such as a namespace name. A **`using`** declaration is for declaring base class members. +## Example + The following sample generates C2886: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2888.md b/docs/error-messages/compiler-errors-2/compiler-error-c2888.md index 2523dff66d0..79f095b1927 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2888.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2888.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2888"] > 'identifier' : symbol cannot be defined within namespace 'namespace' +## Remarks + A symbol belonging to namespace A must be defined in a namespace that encloses A. +## Example + The following sample generates C2888: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md index d34264cfaca..5b17b6c2199 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md @@ -10,8 +10,12 @@ ms.assetid: 49147375-182c-42b1-b170-f475cd436d47 > 'class' : a ref class can only have one non-interface base class +## Remarks + A reference class can only have one base class. +## Example + The following sample generates C2890: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md index 8d1719da6cd..d4068c29352 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md @@ -9,7 +9,13 @@ helpviewer_keywords: ["C2891"] > 'parameter' : cannot take the address of a template parameter -You can't take the address of a template parameter unless it is an lvalue. Type parameters are not lvalues because they have no address. Non-type values in template parameter lists that are not lvalues also do not have an address. This is an example of code that causes Compiler Error C2891, because the value passed as the template parameter is a compiler-generated copy of the template argument. +## Remarks + +You can't take the address of a template parameter unless it is an lvalue. Type parameters are not lvalues because they have no address. Non-type values in template parameter lists that are not lvalues also do not have an address. + +## Example + +This is an example of code that causes Compiler Error C2891, because the value passed as the template parameter is a compiler-generated copy of the template argument. ```cpp template int* f() { return &i; } diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md index f6917c2efef..d2d17f5ddad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md @@ -10,8 +10,12 @@ ms.assetid: c22a5084-2f50-42c2-a56b-6dfe5442edc9 > local class shall not have member templates +## Remarks + Templated member functions are not valid in a class that is defined in a function. +## Example + The following sample generates C2892: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md index c4ab267c838..5a53b1f8558 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2893"] > Failed to specialize function template 'template name' +## Remarks + The compiler failed to specialize a function template. There can be many causes for this error. In general, the way to resolve a C2893 error is to review the function's signature and make sure you can instantiate every type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md index 6bbd6f8600e..7a5b7f89f99 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md @@ -10,8 +10,12 @@ ms.assetid: 4e250579-2b59-4993-a6f4-49273e7ecf06 > templates cannot be declared to have 'C' linkage +## Remarks + This error can be caused by a template defined inside an `extern "C"` block. +## Examples + The following sample generates C2894: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2896.md b/docs/error-messages/compiler-errors-2/compiler-error-c2896.md index 32db06f54ff..b77de03774b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2896.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2896.md @@ -10,10 +10,14 @@ ms.assetid: b600407b-cb05-42e3-9069-2aa6960f0eaa > '*function1*' : cannot use function template '*function2*' as argument +## Remarks + A function template can't be an argument to another function template. This error is obsolete in Visual Studio 2022 and later versions. +## Examples + The following sample generates C2896: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md index da51f88e0db..0fad6f3f9da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md @@ -10,6 +10,8 @@ ms.assetid: a88349e2-823f-42a0-8660-0653b677afa4 > a destructor/finalizer cannot be a function template +## Remarks + Destructors or finalizers cannot be overloaded, so declaring a destructor as a template (which would define a set of destructors) is not allowed. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md index f864bcfebda..63a7ea65a16 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md @@ -10,6 +10,8 @@ ms.assetid: 68466e11-2541-4f6b-b772-13a642f30dfb > 'declaration' : member function templates cannot be virtual +## Example + The following sample generates C2898: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2902.md b/docs/error-messages/compiler-errors-2/compiler-error-c2902.md index 1769f12a7de..7955baf2738 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2902.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2902.md @@ -10,10 +10,14 @@ ms.assetid: 89d78d0e-78e5-4c2c-a0f9-a60110e9395e > '*token*' : unexpected token following '*template*', identifier expected +## Remarks + The token following the keyword **`template`** was not an identifier. This error is obsolete in Visual Studio 2022 and later versions. +## Examples + The following sample generates C2902: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md index 31e95dcfc31..fe7c769f39a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md @@ -10,8 +10,12 @@ ms.assetid: bf6b223f-4921-48c7-82b9-ff318b42c801 > 'identifier' : symbol is neither a class template nor a function template +## Remarks + Code attempts explicit instantiation of something that is not a template. +## Examples + The following sample generates C2903: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md index d77ebda8520..89809be0706 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md @@ -10,8 +10,12 @@ ms.assetid: d5802f2e-d3fc-473d-aa04-36957b4eaca5 > 'identifier' : name already used for a template in the current scope +## Remarks + Check the code for duplicate names. +## Example + The following sample generates C2904: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md index 602b48cf51f..588da470154 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md @@ -10,8 +10,12 @@ ms.assetid: 30f652f1-6af6-4a2f-a69e-a1a4876cc8c6 > 'specialization' : explicit specialization requires 'template <>' +## Remarks + You must use the new syntax for explicit specialization of templates. +## Example + The following sample generates C2906: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md index 4023e1b4c3e..2c576c34c54 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md @@ -10,8 +10,12 @@ ms.assetid: 49cd2a21-cad8-4ba0-9a0b-3a0190d9344c > explicit specialization; 'template' has already been instantiated +## Remarks + A specialization of the primary template occurs before the explicit specialization. +## Example + The following sample generates C2908: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md index 3c3dd40af47..36447e04fe8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md @@ -10,8 +10,12 @@ ms.assetid: 1c9df8ae-925d-4002-a5f8-a71413c45f9e > 'identifier': explicit instantiation of function template requires return type +## Remarks + An explicit instantiation of a function template requires explicit specification of its return type. Implicit return type specification does not work. +## Example + The following sample generates C2909: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md index c6b012013b7..d859c911ca9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md @@ -10,8 +10,12 @@ ms.assetid: 09c50e6a-e099-42f6-8ed6-d80e292a7a36 > 'function' : cannot be explicitly specialized +## Remarks + The compiler detected an attempt to explicitly specialize a function twice. +## Examples + The following sample generates C2910: ```cpp From 22b7bd81caa4e0b60df2c5e84355ab980ce26483 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 18:04:42 +0800 Subject: [PATCH 0697/1799] Replace term "sample" with "example" for error references in range [C2881, C2910] --- .../compiler-errors-2/compiler-error-c2881.md | 2 +- .../compiler-errors-2/compiler-error-c2882.md | 2 +- .../compiler-errors-2/compiler-error-c2883.md | 2 +- .../compiler-errors-2/compiler-error-c2884.md | 2 +- .../compiler-errors-2/compiler-error-c2885.md | 4 ++-- .../compiler-errors-2/compiler-error-c2886.md | 2 +- .../compiler-errors-2/compiler-error-c2888.md | 2 +- .../compiler-errors-2/compiler-error-c2890.md | 2 +- .../compiler-errors-2/compiler-error-c2892.md | 2 +- .../compiler-errors-2/compiler-error-c2893.md | 2 +- .../compiler-errors-2/compiler-error-c2894.md | 4 ++-- .../compiler-errors-2/compiler-error-c2896.md | 2 +- .../compiler-errors-2/compiler-error-c2897.md | 4 ++-- .../compiler-errors-2/compiler-error-c2898.md | 2 +- .../compiler-errors-2/compiler-error-c2902.md | 2 +- .../compiler-errors-2/compiler-error-c2903.md | 2 +- .../compiler-errors-2/compiler-error-c2904.md | 2 +- .../compiler-errors-2/compiler-error-c2906.md | 2 +- .../compiler-errors-2/compiler-error-c2908.md | 2 +- .../compiler-errors-2/compiler-error-c2909.md | 2 +- .../compiler-errors-2/compiler-error-c2910.md | 6 +++--- 21 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md index 0b058a1e996..1327fbb2683 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md @@ -16,7 +16,7 @@ You cannot use the same name as an alias for two namespaces. ## Example -The following sample generates C2881: +The following example generates C2881: ```cpp // C2881.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md index 784e34914c0..1492d6aa8ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md @@ -16,7 +16,7 @@ You tried to use the name of a namespace in an expression. ## Example -The following sample generates C2882: +The following example generates C2882: ```cpp // C2882.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md index 6e20a21ed4e..864f46ac846 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md @@ -16,7 +16,7 @@ You tried to define a function more than once. The first definition was made fro ## Example -The following sample generates C2883: +The following example generates C2883: ```cpp // C2883.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md index 6c2d22971dd..5b1be896ff7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md @@ -16,7 +16,7 @@ You tried to define a function more than once. The first definition is a local d ## Example -The following sample generates C2884: +The following example generates C2884: ```cpp // C2884.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md index 98247bffdc2..960e1b960e5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md @@ -18,7 +18,7 @@ This error can be generated as a result of compiler conformance work that was do ## Examples -The following sample generates C2885. +The following example generates C2885. ```cpp // C2885.cpp @@ -49,7 +49,7 @@ int main () { If you use the **`using`** keyword with a class member, C++ requires you to define that member inside another class (a derived class). -The following sample generates C2885. +The following example generates C2885. ```cpp // C2885_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md index 376b185c245..06df29ed03d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md @@ -16,7 +16,7 @@ A **`using`** declaration uses a symbol, such as a namespace name. A **`using`** ## Example -The following sample generates C2886: +The following example generates C2886: ```cpp // C2886.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2888.md b/docs/error-messages/compiler-errors-2/compiler-error-c2888.md index 79f095b1927..cc6421b7442 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2888.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2888.md @@ -15,7 +15,7 @@ A symbol belonging to namespace A must be defined in a namespace that encloses A ## Example -The following sample generates C2888: +The following example generates C2888: ```cpp // C2888.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md index 5b17b6c2199..cdc9defe752 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md @@ -16,7 +16,7 @@ A reference class can only have one base class. ## Example -The following sample generates C2890: +The following example generates C2890: ```cpp // C2890.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md index d2d17f5ddad..d8b571b8027 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md @@ -16,7 +16,7 @@ Templated member functions are not valid in a class that is defined in a functio ## Example -The following sample generates C2892: +The following example generates C2892: ```cpp // C2892.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md index 5a53b1f8558..33c6fa7b45b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md @@ -17,7 +17,7 @@ In general, the way to resolve a C2893 error is to review the function's signatu ## Example -C2893 occurs because `f`'s template parameter `T` is deduced to be `std::map`, but `std::map` has no member `data_type` (`T::data_type` can not be instantiated with `T = std::map`.). The following sample generates C2893. +C2893 occurs because `f`'s template parameter `T` is deduced to be `std::map`, but `std::map` has no member `data_type` (`T::data_type` can not be instantiated with `T = std::map`.). The following example generates C2893. ```cpp // C2893.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md index 7a5b7f89f99..9ff10abcf44 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md @@ -16,7 +16,7 @@ This error can be caused by a template defined inside an `extern "C"` block. ## Examples -The following sample generates C2894: +The following example generates C2894: ```cpp // C2894.cpp @@ -27,7 +27,7 @@ extern "C" { } ``` -The following sample generates C2894: +The following example generates C2894: ```cpp // C2894b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2896.md b/docs/error-messages/compiler-errors-2/compiler-error-c2896.md index b77de03774b..8a18155583a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2896.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2896.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Examples -The following sample generates C2896: +The following example generates C2896: ```cpp // C2896.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md index 0fad6f3f9da..9dc559c90ba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md @@ -16,7 +16,7 @@ Destructors or finalizers cannot be overloaded, so declaring a destructor as a t ## Examples -The following sample generates C2897. +The following example generates C2897. ```cpp // C2897.cpp @@ -27,7 +27,7 @@ public: }; ``` -The following sample generates C2897. +The following example generates C2897. ```cpp // C2897_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md index 63a7ea65a16..d281ecb5c6f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md @@ -12,7 +12,7 @@ ms.assetid: 68466e11-2541-4f6b-b772-13a642f30dfb ## Example -The following sample generates C2898: +The following example generates C2898: ```cpp // C2898.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2902.md b/docs/error-messages/compiler-errors-2/compiler-error-c2902.md index 7955baf2738..aba5eb8c119 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2902.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2902.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Examples -The following sample generates C2902: +The following example generates C2902: ```cpp // C2902.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md index fe7c769f39a..ebe6391d2b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md @@ -16,7 +16,7 @@ Code attempts explicit instantiation of something that is not a template. ## Examples -The following sample generates C2903: +The following example generates C2903: ```cpp // C2903.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md index 89809be0706..ad9f376cc49 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md @@ -16,7 +16,7 @@ Check the code for duplicate names. ## Example -The following sample generates C2904: +The following example generates C2904: ```cpp // C2904.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md index 588da470154..02faf76195c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md @@ -16,7 +16,7 @@ You must use the new syntax for explicit specialization of templates. ## Example -The following sample generates C2906: +The following example generates C2906: ```cpp // C2906.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md index 2c576c34c54..c8503668373 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md @@ -16,7 +16,7 @@ A specialization of the primary template occurs before the explicit specializati ## Example -The following sample generates C2908: +The following example generates C2908: ```cpp // C2908.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md index 36447e04fe8..a8efef3f1b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md @@ -16,7 +16,7 @@ An explicit instantiation of a function template requires explicit specification ## Example -The following sample generates C2909: +The following example generates C2909: ```cpp // C2909.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md index d859c911ca9..003f7c4e86a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md @@ -16,7 +16,7 @@ The compiler detected an attempt to explicitly specialize a function twice. ## Examples -The following sample generates C2910: +The following example generates C2910: ```cpp // C2910.cpp @@ -30,7 +30,7 @@ template <> void S::f() {} // C2910 delete this specialization C2910 can also be generated if you try to explicitly specialize a non-template member. That is, you can only explicitly specialize a function template. -The following sample generates C2910: +The following example generates C2910: ```cpp // C2910b.cpp @@ -55,7 +55,7 @@ This error will also be generated as a result of compiler conformance work that For code will be valid in the Visual Studio .NET 2003 and Visual Studio .NET versions of Visual C++, remove `template <>`. -The following sample generates C2910: +The following example generates C2910: ```cpp // C2910c.cpp From e907b3922419dee8cbb0849b713d87ba7d9bc32f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 18:08:32 +0800 Subject: [PATCH 0698/1799] Update metadata for error references in range [C2881, C2910] --- .../error-messages/compiler-errors-2/compiler-error-c2881.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2882.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2883.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2884.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2885.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2886.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2890.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2892.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2893.md | 2 +- .../error-messages/compiler-errors-2/compiler-error-c2894.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2896.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2897.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2898.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2902.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2903.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2904.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2906.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2908.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2909.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2910.md | 5 ++--- 20 files changed, 37 insertions(+), 56 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md index 1327fbb2683..b454691769b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2881" title: "Compiler Error C2881" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2881" +ms.date: 11/04/2016 f1_keywords: ["C2881"] helpviewer_keywords: ["C2881"] -ms.assetid: b49c63c2-b064-4d4b-a75e-ddd2af947522 --- # Compiler Error C2881 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md index 1492d6aa8ac..a9197ff4b8f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2882" title: "Compiler Error C2882" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2882" +ms.date: 11/04/2016 f1_keywords: ["C2882"] helpviewer_keywords: ["C2882"] -ms.assetid: 617018ee-5a0d-4b8d-9612-77e8ae52679b --- # Compiler Error C2882 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md index 864f46ac846..8f99b1c5f3e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2883" title: "Compiler Error C2883" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2883" +ms.date: 11/04/2016 f1_keywords: ["C2883"] helpviewer_keywords: ["C2883"] -ms.assetid: 5c6d689d-ed42-41ad-b5c0-e9c2e0b8c356 --- # Compiler Error C2883 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md index 5b1be896ff7..246efeaf563 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2884" title: "Compiler Error C2884" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2884" +ms.date: 11/04/2016 f1_keywords: ["C2884"] helpviewer_keywords: ["C2884"] -ms.assetid: 8b4d43e3-3fb5-4360-86c8-de59d8736d4f --- # Compiler Error C2884 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md index 960e1b960e5..05e2cc3e2a1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2885" title: "Compiler Error C2885" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2885" +ms.date: 11/04/2016 f1_keywords: ["C2885"] helpviewer_keywords: ["C2885"] -ms.assetid: 7743e5f3-a034-44b4-9ee8-5a6254c27f8c --- # Compiler Error C2885 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md index 06df29ed03d..485fb01d635 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2886" title: "Compiler Error C2886" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2886" +ms.date: 11/04/2016 f1_keywords: ["C2886"] helpviewer_keywords: ["C2886"] -ms.assetid: c01588a1-484c-4dc9-a3f1-f900c6e44543 --- # Compiler Error C2886 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md index cdc9defe752..85a41dc4631 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2890" title: "Compiler Error C2890" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2890" +ms.date: 11/04/2016 f1_keywords: ["C2890"] helpviewer_keywords: ["C2890"] -ms.assetid: 49147375-182c-42b1-b170-f475cd436d47 --- # Compiler Error C2890 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md index d8b571b8027..9ac778b80eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2892" title: "Compiler Error C2892" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2892" +ms.date: 11/04/2016 f1_keywords: ["C2892"] helpviewer_keywords: ["C2892"] -ms.assetid: c22a5084-2f50-42c2-a56b-6dfe5442edc9 --- # Compiler Error C2892 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md index 33c6fa7b45b..2e416b3f4fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2893" description: "Learn more about: Compiler Error C2893" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C2893"] helpviewer_keywords: ["C2893"] --- diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md index 9ff10abcf44..0e16df5bc87 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2894" title: "Compiler Error C2894" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2894" +ms.date: 11/04/2016 f1_keywords: ["C2894"] helpviewer_keywords: ["C2894"] -ms.assetid: 4e250579-2b59-4993-a6f4-49273e7ecf06 --- # Compiler Error C2894 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2896.md b/docs/error-messages/compiler-errors-2/compiler-error-c2896.md index 8a18155583a..b46ff6e8c4d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2896.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2896.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2896" title: "Compiler Error C2896" +description: "Learn more about: Compiler Error C2896" ms.date: 06/01/2022 f1_keywords: ["C2896"] helpviewer_keywords: ["C2896"] -ms.assetid: b600407b-cb05-42e3-9069-2aa6960f0eaa --- # Compiler Error C2896 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md index 9dc559c90ba..3ecd2efb034 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2897" title: "Compiler Error C2897" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2897" +ms.date: 11/04/2016 f1_keywords: ["C2897"] helpviewer_keywords: ["C2897"] -ms.assetid: a88349e2-823f-42a0-8660-0653b677afa4 --- # Compiler Error C2897 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md index d281ecb5c6f..2a75f55d76f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2898" title: "Compiler Error C2898" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2898" +ms.date: 11/04/2016 f1_keywords: ["C2898"] helpviewer_keywords: ["C2898"] -ms.assetid: 68466e11-2541-4f6b-b772-13a642f30dfb --- # Compiler Error C2898 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2902.md b/docs/error-messages/compiler-errors-2/compiler-error-c2902.md index aba5eb8c119..4c05069ed3d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2902.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2902.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2902" title: "Compiler Error C2902" +description: "Learn more about: Compiler Error C2902" ms.date: 06/01/2022 f1_keywords: ["C2902"] helpviewer_keywords: ["C2902"] -ms.assetid: 89d78d0e-78e5-4c2c-a0f9-a60110e9395e --- # Compiler Error C2902 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md index ebe6391d2b9..0024b394e0d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2903" title: "Compiler Error C2903" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2903" +ms.date: 11/04/2016 f1_keywords: ["C2903"] helpviewer_keywords: ["C2903"] -ms.assetid: bf6b223f-4921-48c7-82b9-ff318b42c801 --- # Compiler Error C2903 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md index ad9f376cc49..f7193434586 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2904" title: "Compiler Error C2904" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2904" +ms.date: 11/04/2016 f1_keywords: ["C2904"] helpviewer_keywords: ["C2904"] -ms.assetid: d5802f2e-d3fc-473d-aa04-36957b4eaca5 --- # Compiler Error C2904 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md index 02faf76195c..9a081d51aa9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2906" title: "Compiler Error C2906" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2906" +ms.date: 11/04/2016 f1_keywords: ["C2906"] helpviewer_keywords: ["C2906"] -ms.assetid: 30f652f1-6af6-4a2f-a69e-a1a4876cc8c6 --- # Compiler Error C2906 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md index c8503668373..c440d9f60f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2908" title: "Compiler Error C2908" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2908" +ms.date: 11/04/2016 f1_keywords: ["C2908"] helpviewer_keywords: ["C2908"] -ms.assetid: 49cd2a21-cad8-4ba0-9a0b-3a0190d9344c --- # Compiler Error C2908 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md index a8efef3f1b6..d665e604712 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2909" title: "Compiler Error C2909" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2909" +ms.date: 11/04/2016 f1_keywords: ["C2909"] helpviewer_keywords: ["C2909"] -ms.assetid: 1c9df8ae-925d-4002-a5f8-a71413c45f9e --- # Compiler Error C2909 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md index 003f7c4e86a..aa2f41b2086 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2910" title: "Compiler Error C2910" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2910" +ms.date: 11/04/2016 f1_keywords: ["C2910"] helpviewer_keywords: ["C2910"] -ms.assetid: 09c50e6a-e099-42f6-8ed6-d80e292a7a36 --- # Compiler Error C2910 From 87bd5d0ae7b07babd9da7500b675ac8f07553c79 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 18:53:01 +0800 Subject: [PATCH 0699/1799] Add missing `f1_keywords` and `helpviewer_keywords` in "Compiler errors C7500 through C7999" --- .../compiler-errors-2/compiler-errors-c7500-through-c7999.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md index 984ce5a3d8f..23c315e03db 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md @@ -2,8 +2,8 @@ description: "Learn more about: Compiler errors C7500 through C7999" title: "Compiler errors C7500 through C7999" ms.date: 10/13/2023 -f1_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704"] -helpviewer_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7686", "C7700", "C7701", "C7702", "C7703", "C7704"] +f1_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7598", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7665", "C7666", "C7667", "C7668", "C7669", "C7670", "C7671", "C7672", "C7673", "C7674", "C7675", "C7676", "C7677", "C7678", "C7679", "C7680", "C7682", "C7683", "C7684", "C7685", "C7686", "C7687", "C7689", "C7690", "C7691", "C7692", "C7693", "C7694", "C7695", "C7696", "C7697", "C7698", "C7699", "C7700", "C7701", "C7702", "C7703", "C7704", "C7705", "C7706", "C7707", "C7708", "C7709", "C7710", "C7711", "C7712", "C7713", "C7714", "C7720", "C7730", "C7731", "C7732", "C7733", "C7734", "C7735", "C7736", "C7737", "C7738", "C7739", "C7740", "C7741", "C7800", "C7801", "C7802", "C7803", "C7804", "C7806", "C7807"] +helpviewer_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7598", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7665", "C7666", "C7667", "C7668", "C7669", "C7670", "C7671", "C7672", "C7673", "C7674", "C7675", "C7676", "C7677", "C7678", "C7679", "C7680", "C7682", "C7683", "C7684", "C7685", "C7686", "C7687", "C7689", "C7690", "C7691", "C7692", "C7693", "C7694", "C7695", "C7696", "C7697", "C7698", "C7699", "C7700", "C7701", "C7702", "C7703", "C7704", "C7705", "C7706", "C7707", "C7708", "C7709", "C7710", "C7711", "C7712", "C7713", "C7714", "C7720", "C7730", "C7731", "C7732", "C7733", "C7734", "C7735", "C7736", "C7737", "C7738", "C7739", "C7740", "C7741", "C7800", "C7801", "C7802", "C7803", "C7804", "C7806", "C7807"] --- # Compiler errors C7500 through C7999 From 82f7be8af19add51898071f9943338afa6682667 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 18:53:53 +0800 Subject: [PATCH 0700/1799] Move `title` metadata above `description` in "Compiler errors C7500 through C7999" --- .../compiler-errors-2/compiler-errors-c7500-through-c7999.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md index 23c315e03db..5af9b70e4ff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler errors C7500 through C7999" title: "Compiler errors C7500 through C7999" +description: "Learn more about: Compiler errors C7500 through C7999" ms.date: 10/13/2023 f1_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7598", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7665", "C7666", "C7667", "C7668", "C7669", "C7670", "C7671", "C7672", "C7673", "C7674", "C7675", "C7676", "C7677", "C7678", "C7679", "C7680", "C7682", "C7683", "C7684", "C7685", "C7686", "C7687", "C7689", "C7690", "C7691", "C7692", "C7693", "C7694", "C7695", "C7696", "C7697", "C7698", "C7699", "C7700", "C7701", "C7702", "C7703", "C7704", "C7705", "C7706", "C7707", "C7708", "C7709", "C7710", "C7711", "C7712", "C7713", "C7714", "C7720", "C7730", "C7731", "C7732", "C7733", "C7734", "C7735", "C7736", "C7737", "C7738", "C7739", "C7740", "C7741", "C7800", "C7801", "C7802", "C7803", "C7804", "C7806", "C7807"] helpviewer_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7598", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7665", "C7666", "C7667", "C7668", "C7669", "C7670", "C7671", "C7672", "C7673", "C7674", "C7675", "C7676", "C7677", "C7678", "C7679", "C7680", "C7682", "C7683", "C7684", "C7685", "C7686", "C7687", "C7689", "C7690", "C7691", "C7692", "C7693", "C7694", "C7695", "C7696", "C7697", "C7698", "C7699", "C7700", "C7701", "C7702", "C7703", "C7704", "C7705", "C7706", "C7707", "C7708", "C7709", "C7710", "C7711", "C7712", "C7713", "C7714", "C7720", "C7730", "C7731", "C7732", "C7733", "C7734", "C7735", "C7736", "C7737", "C7738", "C7739", "C7740", "C7741", "C7800", "C7801", "C7802", "C7803", "C7804", "C7806", "C7807"] From 5b7deee6b2311ab96904c5d1337cd62dcc6a1eb4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 21:52:56 +0800 Subject: [PATCH 0701/1799] Fix mix up of `title` and `description` in "Create an icon or other image" --- .../creating-an-icon-or-other-image-image-editor-for-icons.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md b/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md index 19767ebd322..f6b11d3d2e5 100644 --- a/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md +++ b/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md @@ -1,6 +1,6 @@ --- -description: "Create an Icon or Other Image" -title: "Learn how to create a new image, bitmap, icon, cursor, or toolbar, and then use the Image Editor to customize its appearance." +title: "Create an Icon or Other Image" +description: "Learn how to create a new image, bitmap, icon, cursor, or toolbar, and then use the Image Editor to customize its appearance." ms.date: 03/21/2025 ms.topic: how-to helpviewer_keywords: ["bitmaps [C++]", "images [C++], creating", "resources [C++], creating images", "bitmaps [C++], creating", "graphics [C++], creating", "Image editor [C++], creating images", "cursors [C++], creating", "image resources [C++], display devices", "icons [C++], creating", "cursors [C++], types", "icons [C++]", "Image editor [C++], icons and cursors", "cursors [C++]", "display devices [C++], creating icons for", "cursors [C++], hot spots", "icons [C++], types", "icons [C++], creating", "display devices [C++], creating image", "images [C++], creating for display devices", "icons [C++], inserting", "New Image Type dialog box [C++]", "Custom Image dialog box [C++]", "Open Image dialog box [C++]", "New Device Image command", "display devices [C++], adding images", "cursors [C++], adding", "icons, adding", "display devices [C++], copying images", "cursors [C++], copying", "icons, copying", "cursors [C++], deleting", "display devices [C++], deleting device image", "icons, erasing", "icons, deleting", "cursors [C++], undoing changes", "icons, undoing changes", "cursors [C++], screen regions", "inverse colors [C++], device images", "transparent regions, device images", "transparency, device images", "Image editor [C++], device images", "inverse regions, device images", "cursors [C++], transparent regions", "screen colors", "regions, transparent", "icons [C++], transparent regions", "display devices [C++], transparent and screen regions", "transparent regions in devices", "regions, inverse", "colors [C++], Image editor", "device projects [C++], transparent images", "icons [C++], screen regions", "256-color palette", "cursors [C++], color", "colors [C++], icons", "colors [C++], cursors", "icons, color", "colors [C++], icons and cursors", "color palettes, 256-color", "palettes, 256-color", "cursors [C++], hot spots", "hot spots", ".gif files [C++], saving bitmaps as", "jpg files [C++], saving bitmaps as", "jpeg files [C++], saving bitmaps as", ".jpg files [C++], saving bitmaps as", "Image editor [C++], converting image formats", "gif files [C++], saving bitmaps as", "bitmaps [C++], converting formats", ".jpeg files [C++], saving bitmaps as", "graphics [C++], converting formats", "images [C++], converting formats", "images [C++], stand-alone editing", "Image editor [C++], converting image formats", "graphics [C++], converting formats", "images [C++], converting formats"] From ad4ab31a4edaa65b1f61a6dfd10acc95e2e5be65 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 21:53:36 +0800 Subject: [PATCH 0702/1799] Tweak metadata in "Create an icon or other image" --- .../creating-an-icon-or-other-image-image-editor-for-icons.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md b/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md index f6b11d3d2e5..5c477289796 100644 --- a/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md +++ b/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md @@ -1,10 +1,9 @@ --- -title: "Create an Icon or Other Image" +title: "Create an icon or other image" description: "Learn how to create a new image, bitmap, icon, cursor, or toolbar, and then use the Image Editor to customize its appearance." ms.date: 03/21/2025 ms.topic: how-to helpviewer_keywords: ["bitmaps [C++]", "images [C++], creating", "resources [C++], creating images", "bitmaps [C++], creating", "graphics [C++], creating", "Image editor [C++], creating images", "cursors [C++], creating", "image resources [C++], display devices", "icons [C++], creating", "cursors [C++], types", "icons [C++]", "Image editor [C++], icons and cursors", "cursors [C++]", "display devices [C++], creating icons for", "cursors [C++], hot spots", "icons [C++], types", "icons [C++], creating", "display devices [C++], creating image", "images [C++], creating for display devices", "icons [C++], inserting", "New Image Type dialog box [C++]", "Custom Image dialog box [C++]", "Open Image dialog box [C++]", "New Device Image command", "display devices [C++], adding images", "cursors [C++], adding", "icons, adding", "display devices [C++], copying images", "cursors [C++], copying", "icons, copying", "cursors [C++], deleting", "display devices [C++], deleting device image", "icons, erasing", "icons, deleting", "cursors [C++], undoing changes", "icons, undoing changes", "cursors [C++], screen regions", "inverse colors [C++], device images", "transparent regions, device images", "transparency, device images", "Image editor [C++], device images", "inverse regions, device images", "cursors [C++], transparent regions", "screen colors", "regions, transparent", "icons [C++], transparent regions", "display devices [C++], transparent and screen regions", "transparent regions in devices", "regions, inverse", "colors [C++], Image editor", "device projects [C++], transparent images", "icons [C++], screen regions", "256-color palette", "cursors [C++], color", "colors [C++], icons", "colors [C++], cursors", "icons, color", "colors [C++], icons and cursors", "color palettes, 256-color", "palettes, 256-color", "cursors [C++], hot spots", "hot spots", ".gif files [C++], saving bitmaps as", "jpg files [C++], saving bitmaps as", "jpeg files [C++], saving bitmaps as", ".jpg files [C++], saving bitmaps as", "Image editor [C++], converting image formats", "gif files [C++], saving bitmaps as", "bitmaps [C++], converting formats", ".jpeg files [C++], saving bitmaps as", "graphics [C++], converting formats", "images [C++], converting formats", "images [C++], stand-alone editing", "Image editor [C++], converting image formats", "graphics [C++], converting formats", "images [C++], converting formats"] -ms.assetid: 66db3fb2-cfc1-48a2-9bdd-53f61eb7ee30 --- # Create an icon or other image From b2dbd4ff4e74d5ec9d6a9cbb60d35804d48193e6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 22:29:20 +0800 Subject: [PATCH 0703/1799] Add blockquotes for error messages in range [C2911, C2940] --- docs/error-messages/compiler-errors-2/compiler-error-c2911.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2912.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2913.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2914.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2918.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2919.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2920.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2921.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2923.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2927.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2929.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2930.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2931.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2934.md | 2 +- 14 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md index 980b21e196c..462aa324fdb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md @@ -8,7 +8,7 @@ ms.assetid: 83c7c01a-ab6a-4179-9fb0-289a9ec8d44e --- # Compiler Error C2911 -'member' : cannot be declared or defined in the current scope +> 'member' : cannot be declared or defined in the current scope Inside a namespace, class, or function, you can only define a member of the same namespace, class, or function or a member that is enclosed by the same namespace, class, or function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md index 70fe8cd6599..70b5189293e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md @@ -8,7 +8,7 @@ ms.assetid: bd55cecd-ab1a-4636-ab8a-a00393fe7b3d --- # Compiler Error C2912 -explicit specialization 'declaration' is not a specialization of a function template +> explicit specialization 'declaration' is not a specialization of a function template You cannot specialize a non-template function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md index 4b9adf22edd..a2e14b64c0b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md @@ -8,7 +8,7 @@ ms.assetid: c6cf6090-02e8-49a5-913f-5bc6f864b769 --- # Compiler Error C2913 -explicit specialization; 'declaration' is not a specialization of a class template +> explicit specialization; 'declaration' is not a specialization of a class template You cannot specialize a non-template class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md index dc67e9f0658..8076604743d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md @@ -8,7 +8,7 @@ ms.assetid: fc6a0592-f53e-4f5a-88cb-780bbed4acf2 --- # Compiler Error C2914 -'identifier' : cannot deduce type argument as function argument is ambiguous +> 'identifier' : cannot deduce type argument as function argument is ambiguous The compiler cannot determine which overloaded functions to use for a generic or template argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2918.md b/docs/error-messages/compiler-errors-2/compiler-error-c2918.md index a32dfb09d0d..b57687fcd7d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2918.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2918.md @@ -8,6 +8,6 @@ ms.assetid: e452f7ef-0590-45e6-9c7c-ee75dc014670 --- # Compiler Error C2918 -'name': Indexed properties cannot be used on the published surface of a WinRT type +> 'name': Indexed properties cannot be used on the published surface of a WinRT type Indexed properties are not supported on the published surface of a WinRT type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2919.md b/docs/error-messages/compiler-errors-2/compiler-error-c2919.md index 4a127dde77d..49010abe076 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2919.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2919.md @@ -8,7 +8,7 @@ ms.assetid: 140a6db9-eb48-4c5e-84a7-a09d2653605b --- # Compiler Error C2919 -'type': Operators cannot be used on the published surface of a WinRT type +> 'type': Operators cannot be used on the published surface of a WinRT type The Windows Runtime type system does not support operator member functions in the published surface of a type. This is because not all languages can consume operator member functions. You can create private or internal operator member functions that can be called from C++ code in the same class or compilation unit. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md index 09e52d53e3c..84f0c746368 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md @@ -8,7 +8,7 @@ ms.assetid: 0a4cb2de-00a0-4209-8160-c7ce6ed7d9ab --- # Compiler Error C2920 -redefinition : 'class' : class template or generic has already been declared as 'type' +> redefinition : 'class' : class template or generic has already been declared as 'type' A generic or template class has multiple declarations, which are not equivalent. To fix this error, use different names for different types, or remove the redefinition of the type name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md index 9e54aedc97d..792351d46b7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md @@ -8,7 +8,7 @@ ms.assetid: 323642a0-bfc4-4942-9f41-c3adf5c54296 --- # Compiler Error C2921 -redefinition : 'class' : class template or generic is being redeclared as 'type' +> redefinition : 'class' : class template or generic is being redeclared as 'type' A generic or template class has multiple declarations that are not equivalent. To fix this error, use different names for different types, or remove the redefinition of the type name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md index aa7b7cb9f12..ac87e453dbf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md @@ -8,7 +8,7 @@ ms.assetid: 6b92933b-13ef-4124-99d9-b89f9fdae030 --- # Compiler Error C2923 -'type' : 'identifier' is not a valid template type argument for parameter 'param' +> 'type' : 'identifier' is not a valid template type argument for parameter 'param' The argument list is missing a type needed to instantiate the template or generic. Check the template or generic declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2927.md b/docs/error-messages/compiler-errors-2/compiler-error-c2927.md index 26c2fc59b5e..059f13a89e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2927.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2927.md @@ -8,6 +8,6 @@ ms.assetid: 3f75beec-ff5c-44e1-9085-990ecd55198d --- # Compiler Error C2927 -'function' : a function template must be called with at least one argument +> 'function' : a function template must be called with at least one argument You cannot call a function template without arguments. The type of the template arguments determines what version of the function to generate. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md index 64c2ad0086f..2a777fd6f9c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md @@ -8,7 +8,7 @@ ms.assetid: 11134027-6adc-4733-b6bd-b94486bd1933 --- # Compiler Error C2929 -'identifier' : explicit instantiation; cannot explicitly force and suppress instantiation of template-class member +> 'identifier' : explicit instantiation; cannot explicitly force and suppress instantiation of template-class member You cannot explicitly instantiate an identifier while preventing it from being instantiated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md index 882645295d0..d825ac4a48f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md @@ -8,7 +8,7 @@ ms.assetid: f07eecd1-e5d1-4518-bd89-b1fd2a003a17 --- # Compiler Error C2930 -'class' : type-class-id redefined as an enumerator of 'enum identifier' +> 'class' : type-class-id redefined as an enumerator of 'enum identifier' You cannot use a generic or template class as a member of an enumeration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md index 569af1e5875..8b1cb7df065 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md @@ -8,7 +8,7 @@ ms.assetid: 33430407-b149-4ba3-baf8-b0dae1ea3a5d --- # Compiler Error C2931 -'*class*' : type-class-id redefined as a member function of '*identifier*' +> '*class*' : type-class-id redefined as a member function of '*identifier*' You can't use a generic or template class as a member function of another class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2934.md b/docs/error-messages/compiler-errors-2/compiler-error-c2934.md index f95f66da05f..03e914d4602 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2934.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2934.md @@ -8,7 +8,7 @@ ms.assetid: b7f7e7aa-2d4c-4e17-8564-2c005ab81fd5 --- # Compiler Error C2934 -'*class*' : type-class-id redefined as a nested 'item' of '*identifier*' +> '*class*' : type-class-id redefined as a nested 'item' of '*identifier*' You can't use a generic or template class as a nested item. From dd4064c5ae33a9e262508fb6e5563dc353a52699 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 22:34:45 +0800 Subject: [PATCH 0704/1799] Add "Remarks" and "Example" headings for error references in range [C2911, C2940] --- docs/error-messages/compiler-errors-2/compiler-error-c2911.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2912.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2913.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2914.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2918.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2919.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2920.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2921.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2923.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2927.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2928.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2929.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2930.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2931.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2932.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2933.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2934.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2935.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2936.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2937.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2939.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2940.md | 4 ++++ 22 files changed, 78 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md index 462aa324fdb..1b8281eba3f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md @@ -10,8 +10,12 @@ ms.assetid: 83c7c01a-ab6a-4179-9fb0-289a9ec8d44e > 'member' : cannot be declared or defined in the current scope +## Remarks + Inside a namespace, class, or function, you can only define a member of the same namespace, class, or function or a member that is enclosed by the same namespace, class, or function. +## Example + The following sample generates C2911: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md index 70b5189293e..57a19630761 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md @@ -10,8 +10,12 @@ ms.assetid: bd55cecd-ab1a-4636-ab8a-a00393fe7b3d > explicit specialization 'declaration' is not a specialization of a function template +## Remarks + You cannot specialize a non-template function. +## Examples + The following sample generates C2912: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md index a2e14b64c0b..10af5b0ad60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md @@ -10,8 +10,12 @@ ms.assetid: c6cf6090-02e8-49a5-913f-5bc6f864b769 > explicit specialization; 'declaration' is not a specialization of a class template +## Remarks + You cannot specialize a non-template class. +## Example + The following sample generates C2913: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md index 8076604743d..646bae6acd7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md @@ -10,8 +10,12 @@ ms.assetid: fc6a0592-f53e-4f5a-88cb-780bbed4acf2 > 'identifier' : cannot deduce type argument as function argument is ambiguous +## Remarks + The compiler cannot determine which overloaded functions to use for a generic or template argument. +## Examples + The following sample generates C2914: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2918.md b/docs/error-messages/compiler-errors-2/compiler-error-c2918.md index b57687fcd7d..25cadd018e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2918.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2918.md @@ -10,4 +10,6 @@ ms.assetid: e452f7ef-0590-45e6-9c7c-ee75dc014670 > 'name': Indexed properties cannot be used on the published surface of a WinRT type +## Remarks + Indexed properties are not supported on the published surface of a WinRT type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2919.md b/docs/error-messages/compiler-errors-2/compiler-error-c2919.md index 49010abe076..42a18ca5630 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2919.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2919.md @@ -10,6 +10,8 @@ ms.assetid: 140a6db9-eb48-4c5e-84a7-a09d2653605b > 'type': Operators cannot be used on the published surface of a WinRT type +## Remarks + The Windows Runtime type system does not support operator member functions in the published surface of a type. This is because not all languages can consume operator member functions. You can create private or internal operator member functions that can be called from C++ code in the same class or compilation unit. To fix this issue, remove the operator member function from the public interface, or change it to a named member function. For example, instead of `operator==`, name the member function `Equals`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md index 84f0c746368..e3cbbc692a2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md @@ -10,8 +10,12 @@ ms.assetid: 0a4cb2de-00a0-4209-8160-c7ce6ed7d9ab > redefinition : 'class' : class template or generic has already been declared as 'type' +## Remarks + A generic or template class has multiple declarations, which are not equivalent. To fix this error, use different names for different types, or remove the redefinition of the type name. +## Examples + The following sample generates C2920 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md index 792351d46b7..af13d50a848 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md @@ -10,8 +10,12 @@ ms.assetid: 323642a0-bfc4-4942-9f41-c3adf5c54296 > redefinition : 'class' : class template or generic is being redeclared as 'type' +## Remarks + A generic or template class has multiple declarations that are not equivalent. To fix this error, use different names for different types, or remove the redefinition of the type name. +## Examples + The following sample generates C2921: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md index ac87e453dbf..938c419094e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md @@ -10,8 +10,12 @@ ms.assetid: 6b92933b-13ef-4124-99d9-b89f9fdae030 > 'type' : 'identifier' is not a valid template type argument for parameter 'param' +## Remarks + The argument list is missing a type needed to instantiate the template or generic. Check the template or generic declaration. +## Examples + The following sample generates C2923: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2927.md b/docs/error-messages/compiler-errors-2/compiler-error-c2927.md index 059f13a89e7..7703166fb1e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2927.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2927.md @@ -10,4 +10,6 @@ ms.assetid: 3f75beec-ff5c-44e1-9085-990ecd55198d > 'function' : a function template must be called with at least one argument +## Remarks + You cannot call a function template without arguments. The type of the template arguments determines what version of the function to generate. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2928.md b/docs/error-messages/compiler-errors-2/compiler-error-c2928.md index 87bc5a29d23..016cba41f58 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2928.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2928.md @@ -10,4 +10,6 @@ ms.assetid: 869e57f4-7024-4cbe-b47b-6e1e2a6005c5 > explicit instantiation; '*identifier*' is not a function or static data member of template-class '*class-name*' +## Remarks + You cannot explicitly instantiate a member of *class-name* that is not a function or **`static`** variable. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md index 2a777fd6f9c..243e422ea95 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md @@ -10,8 +10,12 @@ ms.assetid: 11134027-6adc-4733-b6bd-b94486bd1933 > 'identifier' : explicit instantiation; cannot explicitly force and suppress instantiation of template-class member +## Remarks + You cannot explicitly instantiate an identifier while preventing it from being instantiated. +## Example + The following sample generates C2929: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md index d825ac4a48f..01293a42b2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md @@ -10,10 +10,14 @@ ms.assetid: f07eecd1-e5d1-4518-bd89-b1fd2a003a17 > 'class' : type-class-id redefined as an enumerator of 'enum identifier' +## Remarks + You cannot use a generic or template class as a member of an enumeration. This error can be caused if braces are improperly matched. +## Examples + The following sample generates C2930: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md index 8b1cb7df065..ad468d20cc7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md @@ -10,12 +10,16 @@ ms.assetid: 33430407-b149-4ba3-baf8-b0dae1ea3a5d > '*class*' : type-class-id redefined as a member function of '*identifier*' +## Remarks + You can't use a generic or template class as a member function of another class. This error is obsolete in Visual Studio 2022 and later versions. This error can be caused if braces are improperly matched. +## Examples + The following sample generates C2931: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2932.md b/docs/error-messages/compiler-errors-2/compiler-error-c2932.md index 3ec4a323b08..83df72aa16a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2932.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2932.md @@ -10,10 +10,14 @@ ms.assetid: c28e88d9-e654-4367-bfb4-13c780bca9bd > '*class*' : type-class-id redefined as a data member of '*identifier*' +## Remarks + You can't use a generic or template class as a data member. This error is obsolete in Visual Studio 2022 and later versions. +## Examples + The following sample generates C2932: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2933.md b/docs/error-messages/compiler-errors-2/compiler-error-c2933.md index c908e2a05c6..920f00231b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2933.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2933.md @@ -10,10 +10,14 @@ ms.assetid: 394891e3-6b52-4b61-83d2-a1c5125d9bd5 > '*class*' : type-class-id redefined as a typedef member of '*identifier*' +## Remarks + You can't use a generic or template class as a **`typedef`** member. This error is obsolete in Visual Studio 2022 and later versions. +## Examples + The following sample generates C2933: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2934.md b/docs/error-messages/compiler-errors-2/compiler-error-c2934.md index 03e914d4602..bba3065f7aa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2934.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2934.md @@ -10,6 +10,8 @@ ms.assetid: b7f7e7aa-2d4c-4e17-8564-2c005ab81fd5 > '*class*' : type-class-id redefined as a nested 'item' of '*identifier*' +## Remarks + You can't use a generic or template class as a nested item. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2935.md b/docs/error-messages/compiler-errors-2/compiler-error-c2935.md index 277c0cafd58..d45dbf57b9f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2935.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2935.md @@ -10,12 +10,16 @@ ms.assetid: e11ef90d-0756-4e43-8a09-4974c6aa72a3 > '*class*' : type-class-id redefined as a global function +## Remarks + You can't use a generic or template class as a global function. This error is obsolete in Visual Studio 2022 and later versions. This error can be caused if braces are improperly matched. +## Examples + The following sample generates C2935: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2936.md b/docs/error-messages/compiler-errors-2/compiler-error-c2936.md index 0b7ee74a590..650757020fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2936.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2936.md @@ -10,12 +10,16 @@ ms.assetid: 5d1ba0fc-0c78-4a37-a83b-1ef8527763be > '*class*' : type-class-id redefined as a global data variable +## Remarks + You can't use a generic or template class as a global data variable. This error is obsolete in Visual Studio 2022 and later versions. This error can be caused if braces are improperly matched. +## Examples + The following sample generates C2936: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2937.md b/docs/error-messages/compiler-errors-2/compiler-error-c2937.md index 7c14567bc23..e3511972ece 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2937.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2937.md @@ -10,10 +10,14 @@ ms.assetid: 95671ca3-79f7-4b56-a5f2-a92296da1629 > '*class*' : type-class-id redefined as a global typedef +## Remarks + You can't use a generic or template class as a global **`typedef`**. This error is obsolete in Visual Studio 2022 and later versions. +## Examples + The following sample generates C2937: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2939.md b/docs/error-messages/compiler-errors-2/compiler-error-c2939.md index 602ed451dc0..5438463d311 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2939.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2939.md @@ -10,12 +10,16 @@ ms.assetid: 455b050b-f2dc-4b5b-bd6a-e1f81d3d1644 > '*class*' : type-class-id redefined as a local data variable +## Remarks + You can't use a generic or template class as a local data variable. This error is obsolete in Visual Studio 2022 and later versions. This error can be caused if braces are improperly matched. +## Examples + The following sample generates C2939: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2940.md b/docs/error-messages/compiler-errors-2/compiler-error-c2940.md index dec4f0abd4a..d4a41b3f037 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2940.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2940.md @@ -10,10 +10,14 @@ ms.assetid: af6bf2bf-8de6-4cfd-bbf0-4c6b32a30edf > '*class*' : type-class-id redefined as a local typedef +## Remarks + You can't use a generic or template class as a local **`typedef`**. This error is obsolete in Visual Studio 2022 and later versions. +## Examples + The following sample generates C2940: ```cpp From 5742462a34c9cb0409dc663097a6e79986a372df Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 22:36:06 +0800 Subject: [PATCH 0705/1799] Replace term "sample" with "example" for error references in range [C2911, C2940] --- docs/error-messages/compiler-errors-2/compiler-error-c2911.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2912.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2913.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2914.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2917.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2920.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2921.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2923.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2929.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2930.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2931.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2932.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2933.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2935.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2936.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2937.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2939.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2940.md | 2 +- 18 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md index 1b8281eba3f..8d3c38fcb12 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md @@ -16,7 +16,7 @@ Inside a namespace, class, or function, you can only define a member of the same ## Example -The following sample generates C2911: +The following example generates C2911: ```cpp // C2911.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md index 57a19630761..ed5a071e9c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md @@ -16,7 +16,7 @@ You cannot specialize a non-template function. ## Examples -The following sample generates C2912: +The following example generates C2912: ```cpp // C2912.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md index 10af5b0ad60..200adf33cb5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md @@ -16,7 +16,7 @@ You cannot specialize a non-template class. ## Example -The following sample generates C2913: +The following example generates C2913: ```cpp // C2913.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md index 646bae6acd7..23489af4899 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md @@ -16,7 +16,7 @@ The compiler cannot determine which overloaded functions to use for a generic or ## Examples -The following sample generates C2914: +The following example generates C2914: ```cpp // C2914.cpp @@ -29,7 +29,7 @@ void h() { g(f); } // C2914 // void h() { g(f); } ``` -C2914 can also occur when using generics. The following sample generates C2914: +C2914 can also occur when using generics. The following example generates C2914: ```cpp // C2914b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2917.md b/docs/error-messages/compiler-errors-2/compiler-error-c2917.md index f7b627b4264..fae90e2a73e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2917.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2917.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Example -The following sample generates C2917. +The following example generates C2917. ```cpp // C2917.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md index e3cbbc692a2..aaf35ce71d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md @@ -16,7 +16,7 @@ A generic or template class has multiple declarations, which are not equivalent. ## Examples -The following sample generates C2920 and shows how to fix it: +The following example generates C2920 and shows how to fix it: ```cpp // C2920.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md index af13d50a848..e32be21f17a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md @@ -16,7 +16,7 @@ A generic or template class has multiple declarations that are not equivalent. T ## Examples -The following sample generates C2921: +The following example generates C2921: ```cpp // C2921.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md index 938c419094e..19ded2ba2f4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md @@ -16,7 +16,7 @@ The argument list is missing a type needed to instantiate the template or generi ## Examples -The following sample generates C2923: +The following example generates C2923: ```cpp // C2923.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md index 243e422ea95..76fa7e0658d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md @@ -16,7 +16,7 @@ You cannot explicitly instantiate an identifier while preventing it from being i ## Example -The following sample generates C2929: +The following example generates C2929: ```cpp // C2929.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md index 01293a42b2a..10b9e7bf403 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md @@ -18,7 +18,7 @@ This error can be caused if braces are improperly matched. ## Examples -The following sample generates C2930: +The following example generates C2930: ```cpp // C2930.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md index ad468d20cc7..fb9f702ba19 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md @@ -20,7 +20,7 @@ This error can be caused if braces are improperly matched. ## Examples -The following sample generates C2931: +The following example generates C2931: ```cpp // C2931.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2932.md b/docs/error-messages/compiler-errors-2/compiler-error-c2932.md index 83df72aa16a..350b0563b34 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2932.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2932.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Examples -The following sample generates C2932: +The following example generates C2932: ```cpp // C2932.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2933.md b/docs/error-messages/compiler-errors-2/compiler-error-c2933.md index 920f00231b8..cc8fefe104a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2933.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2933.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Examples -The following sample generates C2933: +The following example generates C2933: ```cpp // C2933.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2935.md b/docs/error-messages/compiler-errors-2/compiler-error-c2935.md index d45dbf57b9f..e39f5ff975d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2935.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2935.md @@ -20,7 +20,7 @@ This error can be caused if braces are improperly matched. ## Examples -The following sample generates C2935: +The following example generates C2935: ```cpp // C2935.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2936.md b/docs/error-messages/compiler-errors-2/compiler-error-c2936.md index 650757020fd..4bd17e71018 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2936.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2936.md @@ -20,7 +20,7 @@ This error can be caused if braces are improperly matched. ## Examples -The following sample generates C2936: +The following example generates C2936: ```cpp // C2936.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2937.md b/docs/error-messages/compiler-errors-2/compiler-error-c2937.md index e3511972ece..14a51f5fc15 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2937.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2937.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Examples -The following sample generates C2937: +The following example generates C2937: ```cpp // C2937.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2939.md b/docs/error-messages/compiler-errors-2/compiler-error-c2939.md index 5438463d311..e4b6cde5861 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2939.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2939.md @@ -20,7 +20,7 @@ This error can be caused if braces are improperly matched. ## Examples -The following sample generates C2939: +The following example generates C2939: ```cpp // C2939.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2940.md b/docs/error-messages/compiler-errors-2/compiler-error-c2940.md index d4a41b3f037..b99e1f2a630 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2940.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2940.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Examples -The following sample generates C2940: +The following example generates C2940: ```cpp // C2940.cpp From 2d3669ca8ab8c17191ad7ed132811d36cb77980a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 10 Aug 2025 22:40:00 +0800 Subject: [PATCH 0706/1799] Update metadata for error references in range [C2911, C2940] --- .../error-messages/compiler-errors-2/compiler-error-c2911.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2912.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2913.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2914.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2917.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2918.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2919.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2920.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2921.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2923.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2927.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2928.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2929.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2930.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2931.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2932.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2933.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2934.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2935.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2936.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2937.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2939.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2940.md | 3 +-- 23 files changed, 37 insertions(+), 60 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md index 8d3c38fcb12..89012b64268 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2911" title: "Compiler Error C2911" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2911" +ms.date: 11/04/2016 f1_keywords: ["C2911"] helpviewer_keywords: ["C2911"] -ms.assetid: 83c7c01a-ab6a-4179-9fb0-289a9ec8d44e --- # Compiler Error C2911 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md index ed5a071e9c4..3184529521a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2912" title: "Compiler Error C2912" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2912" +ms.date: 11/04/2016 f1_keywords: ["C2912"] helpviewer_keywords: ["C2912"] -ms.assetid: bd55cecd-ab1a-4636-ab8a-a00393fe7b3d --- # Compiler Error C2912 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md index 200adf33cb5..db8bc5ec90c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2913" title: "Compiler Error C2913" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2913" +ms.date: 11/04/2016 f1_keywords: ["C2913"] helpviewer_keywords: ["C2913"] -ms.assetid: c6cf6090-02e8-49a5-913f-5bc6f864b769 --- # Compiler Error C2913 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md index 23489af4899..89cb2921fca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2914" title: "Compiler Error C2914" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2914" +ms.date: 11/04/2016 f1_keywords: ["C2914"] helpviewer_keywords: ["C2914"] -ms.assetid: fc6a0592-f53e-4f5a-88cb-780bbed4acf2 --- # Compiler Error C2914 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2917.md b/docs/error-messages/compiler-errors-2/compiler-error-c2917.md index fae90e2a73e..f572ec0664c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2917.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2917.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2917" title: "Compiler Error C2917" +description: "Learn more about: Compiler Error C2917" ms.date: 06/01/2022 f1_keywords: ["C2917"] helpviewer_keywords: ["C2917"] -ms.assetid: ec9da9ee-0f37-47b3-87dd-19ef5a14dc4c --- # Compiler Error C2917 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2918.md b/docs/error-messages/compiler-errors-2/compiler-error-c2918.md index 25cadd018e2..805c9907a4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2918.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2918.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2918" title: "Compiler Error C2918" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2918" +ms.date: 11/04/2016 f1_keywords: ["C2918"] helpviewer_keywords: ["C2918"] -ms.assetid: e452f7ef-0590-45e6-9c7c-ee75dc014670 --- # Compiler Error C2918 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2919.md b/docs/error-messages/compiler-errors-2/compiler-error-c2919.md index 42a18ca5630..0c922ead41a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2919.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2919.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2919" title: "Compiler Error C2919" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2919" +ms.date: 11/04/2016 f1_keywords: ["C2919"] helpviewer_keywords: ["C2919"] -ms.assetid: 140a6db9-eb48-4c5e-84a7-a09d2653605b --- # Compiler Error C2919 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md index aaf35ce71d6..d93a9e6731b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2920" title: "Compiler Error C2920" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2920" +ms.date: 11/04/2016 f1_keywords: ["C2920"] helpviewer_keywords: ["C2920"] -ms.assetid: 0a4cb2de-00a0-4209-8160-c7ce6ed7d9ab --- # Compiler Error C2920 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md index e32be21f17a..1e95a49174b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2921" title: "Compiler Error C2921" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2921" +ms.date: 11/04/2016 f1_keywords: ["C2921"] helpviewer_keywords: ["C2921"] -ms.assetid: 323642a0-bfc4-4942-9f41-c3adf5c54296 --- # Compiler Error C2921 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md index 19ded2ba2f4..d5867c16777 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2923" title: "Compiler Error C2923" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2923" +ms.date: 11/04/2016 f1_keywords: ["C2923"] helpviewer_keywords: ["C2923"] -ms.assetid: 6b92933b-13ef-4124-99d9-b89f9fdae030 --- # Compiler Error C2923 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2927.md b/docs/error-messages/compiler-errors-2/compiler-error-c2927.md index 7703166fb1e..eefb7751741 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2927.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2927.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2927" title: "Compiler Error C2927" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2927" +ms.date: 11/04/2016 f1_keywords: ["C2927"] helpviewer_keywords: ["C2927"] -ms.assetid: 3f75beec-ff5c-44e1-9085-990ecd55198d --- # Compiler Error C2927 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2928.md b/docs/error-messages/compiler-errors-2/compiler-error-c2928.md index 016cba41f58..d2660e9a556 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2928.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2928.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2928" title: "Compiler Error C2928" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2928" +ms.date: 11/04/2016 f1_keywords: ["C2928"] helpviewer_keywords: ["C2928"] -ms.assetid: 869e57f4-7024-4cbe-b47b-6e1e2a6005c5 --- # Compiler Error C2928 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md index 76fa7e0658d..9ebb6d95a29 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2929" title: "Compiler Error C2929" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2929" +ms.date: 11/04/2016 f1_keywords: ["C2929"] helpviewer_keywords: ["C2929"] -ms.assetid: 11134027-6adc-4733-b6bd-b94486bd1933 --- # Compiler Error C2929 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md index 10b9e7bf403..5cfc1f444e4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2930" title: "Compiler Error C2930" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2930" +ms.date: 11/04/2016 f1_keywords: ["C2930"] helpviewer_keywords: ["C2930"] -ms.assetid: f07eecd1-e5d1-4518-bd89-b1fd2a003a17 --- # Compiler Error C2930 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md index fb9f702ba19..a282986af7b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2931" title: "Compiler Error C2931" +description: "Learn more about: Compiler Error C2931" ms.date: 06/01/2022 f1_keywords: ["C2931"] helpviewer_keywords: ["C2931"] -ms.assetid: 33430407-b149-4ba3-baf8-b0dae1ea3a5d --- # Compiler Error C2931 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2932.md b/docs/error-messages/compiler-errors-2/compiler-error-c2932.md index 350b0563b34..e42e9e08fde 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2932.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2932.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2932" title: "Compiler Error C2932" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2932" +ms.date: 11/04/2016 f1_keywords: ["C2932"] helpviewer_keywords: ["C2932"] -ms.assetid: c28e88d9-e654-4367-bfb4-13c780bca9bd --- # Compiler Error C2932 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2933.md b/docs/error-messages/compiler-errors-2/compiler-error-c2933.md index cc8fefe104a..93b6124a889 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2933.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2933.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2933" title: "Compiler Error C2933" +description: "Learn more about: Compiler Error C2933" ms.date: 06/01/2022 f1_keywords: ["C2933"] helpviewer_keywords: ["C2933"] -ms.assetid: 394891e3-6b52-4b61-83d2-a1c5125d9bd5 --- # Compiler Error C2933 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2934.md b/docs/error-messages/compiler-errors-2/compiler-error-c2934.md index bba3065f7aa..43f7ec8c538 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2934.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2934.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2934" title: "Compiler Error C2934" +description: "Learn more about: Compiler Error C2934" ms.date: 06/01/2022 f1_keywords: ["C2934"] helpviewer_keywords: ["C2934"] -ms.assetid: b7f7e7aa-2d4c-4e17-8564-2c005ab81fd5 --- # Compiler Error C2934 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2935.md b/docs/error-messages/compiler-errors-2/compiler-error-c2935.md index e39f5ff975d..7c8f46a10f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2935.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2935.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2935" title: "Compiler Error C2935" +description: "Learn more about: Compiler Error C2935" ms.date: 06/01/2022 f1_keywords: ["C2935"] helpviewer_keywords: ["C2935"] -ms.assetid: e11ef90d-0756-4e43-8a09-4974c6aa72a3 --- # Compiler Error C2935 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2936.md b/docs/error-messages/compiler-errors-2/compiler-error-c2936.md index 4bd17e71018..803199c6e6e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2936.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2936.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2936" title: "Compiler Error C2936" +description: "Learn more about: Compiler Error C2936" ms.date: 06/01/2022 f1_keywords: ["C2936"] helpviewer_keywords: ["C2936"] -ms.assetid: 5d1ba0fc-0c78-4a37-a83b-1ef8527763be --- # Compiler Error C2936 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2937.md b/docs/error-messages/compiler-errors-2/compiler-error-c2937.md index 14a51f5fc15..d69d2a883a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2937.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2937.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2937" title: "Compiler Error C2937" +description: "Learn more about: Compiler Error C2937" ms.date: 06/01/2022 f1_keywords: ["C2937"] helpviewer_keywords: ["C2937"] -ms.assetid: 95671ca3-79f7-4b56-a5f2-a92296da1629 --- # Compiler Error C2937 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2939.md b/docs/error-messages/compiler-errors-2/compiler-error-c2939.md index e4b6cde5861..50bf40c9c39 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2939.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2939.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2939" title: "Compiler Error C2939" +description: "Learn more about: Compiler Error C2939" ms.date: 06/01/2022 f1_keywords: ["C2939"] helpviewer_keywords: ["C2939"] -ms.assetid: 455b050b-f2dc-4b5b-bd6a-e1f81d3d1644 --- # Compiler Error C2939 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2940.md b/docs/error-messages/compiler-errors-2/compiler-error-c2940.md index b99e1f2a630..583db713d13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2940.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2940.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2940" title: "Compiler Error C2940" +description: "Learn more about: Compiler Error C2940" ms.date: 06/01/2022 f1_keywords: ["C2940"] helpviewer_keywords: ["C2940"] -ms.assetid: af6bf2bf-8de6-4cfd-bbf0-4c6b32a30edf --- # Compiler Error C2940 From f19c6597a957c9e249bcca77d84b71b565a6588c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 11 Aug 2025 23:32:23 +0800 Subject: [PATCH 0707/1799] Add blockquotes for error messages in range [C2941, C2980] --- docs/error-messages/compiler-errors-2/compiler-error-c2945.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2946.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2947.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2948.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2951.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2952.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2953.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2955.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2957.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2958.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2959.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2962.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2969.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2970.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2971.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2973.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2974.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2976.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2977.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2978.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2979.md | 2 +- 21 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2945.md b/docs/error-messages/compiler-errors-2/compiler-error-c2945.md index 2d13eb9f49e..dd14477de6c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2945.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2945.md @@ -8,6 +8,6 @@ ms.assetid: be640257-7017-45d1-986a-9fe8caab52f3 --- # Compiler Error C2945 -explicit instantiation does not refer to a template-class specialization +> explicit instantiation does not refer to a template-class specialization You cannot explicitly instantiate something that is not templated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md index 382b205402a..11de0af1d29 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md @@ -8,7 +8,7 @@ ms.assetid: c86dfbfc-7702-4f09-8a53-d205710e99c2 --- # Compiler Error C2946 -explicit instantiation; 'class' is not a template-class specialization +> explicit instantiation; 'class' is not a template-class specialization You cannot explicitly instantiate a nontemplated class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md index 77faf9893e2..db8b7e50bed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md @@ -8,7 +8,7 @@ ms.assetid: 6c056f62-ec90-4883-8a67-aeeb6ec13546 --- # Compiler Error C2947 -expecting '>' to terminate construct, found 'syntax' +> expecting '>' to terminate construct, found 'syntax' A generic or template argument list may not have been terminated correctly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2948.md b/docs/error-messages/compiler-errors-2/compiler-error-c2948.md index b3a878a050a..7d7892973c2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2948.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2948.md @@ -8,6 +8,6 @@ ms.assetid: 780c6ed3-43a0-4112-8d00-b7bf79086c05 --- # Compiler Error C2948 -explicit instantiation; storage class specifier 'specifier' not permitted on specialization +> explicit instantiation; storage class specifier 'specifier' not permitted on specialization You cannot use storage-class specifiers (such as **`extern`**) in a specialization of a template class that was previously explicitly instantiated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md index a38b41dfaf7..a4bf3f395bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md @@ -8,7 +8,7 @@ ms.assetid: c6f95aa2-c894-425b-a51c-d40d70c8daa1 --- # Compiler Error C2951 -type declarations are only permitted at global, namespace, or class scope +> type declarations are only permitted at global, namespace, or class scope You cannot declare a generic or template class outside global or namespace scope. If you make your generic or template declarations in an include file, make sure the include file is at global scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md index 9998595a1ca..40576ad31e3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md @@ -8,7 +8,7 @@ ms.assetid: a40e18a2-d02c-4511-854f-6c6fd6789a1a --- # Compiler Error C2952 -'declaration' : type declaration missing template parameter list +> 'declaration' : type declaration missing template parameter list A template declaration was ill formed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md index 6e0d8091d5c..cda622b333c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md @@ -8,7 +8,7 @@ ms.assetid: 8dbcfa24-8296-4e40-bdc4-5526c07d8892 --- # Compiler Error C2953 -'identifier' : class template has already been defined +> 'identifier' : class template has already been defined Check the source file and include files for other definitions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md index 521cf7a352c..cbe258a9df4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md @@ -8,7 +8,7 @@ ms.assetid: 77709fb6-d69b-46fd-a62f-e8564563d01b --- # Compiler Error C2955 -'identifier' : use of class template or alias generic requires template or generic argument list +> 'identifier' : use of class template or alias generic requires template or generic argument list You cannot use a class template or class generic as an identifier without a template or generic argument list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md index e2d17ce3dd2..678e08e2882 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md @@ -8,7 +8,7 @@ ms.assetid: 9cb4526f-4af8-47e9-b786-56192627ca72 --- # Compiler Error C2957 -'delim' : invalid left delimiter : expected '<' +> 'delim' : invalid left delimiter : expected '<' A generic class was ill formed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2958.md b/docs/error-messages/compiler-errors-2/compiler-error-c2958.md index 72706383992..eddd75f6066 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2958.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2958.md @@ -8,7 +8,7 @@ ms.assetid: 332bf6d3-7cd1-4b1a-8ddb-d4a8cbf01115 --- # Compiler Error C2958 -the left delimiter found at 'location' was not matched correctly +> the left delimiter found at 'location' was not matched correctly A delimiter is not properly matched. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md index 6855bf67bb9..5720765cfd6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md @@ -8,7 +8,7 @@ ms.assetid: d66bb2a8-70c3-4209-a358-b0c47f111a50 --- # Compiler Error C2959 -a generic class or function may not be a member of a template +> a generic class or function may not be a member of a template For more information, see [Windows Runtime and Managed Templates](../../extensions/windows-runtime-and-managed-templates-cpp-component-extensions.md) and [Generics](../../extensions/generics-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2962.md b/docs/error-messages/compiler-errors-2/compiler-error-c2962.md index 9059b4b8787..18b34b1231b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2962.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2962.md @@ -8,7 +8,7 @@ ms.assetid: 6f966aec-4eea-4221-8e1b-fe66808c6f5c --- # Compiler Error C2962 -syntax error : 'token' : expected template-class member function definition to end with '}' +> syntax error : 'token' : expected template-class member function definition to end with '}' The token caused a syntax error in a template declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md index 47b9816261f..3c70de7938c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md @@ -8,7 +8,7 @@ ms.assetid: e4ea3d66-b937-4b2c-b42a-96e03fb11579 --- # Compiler Error C2969 -syntax error : 'symbol' : expected member function definition to end with '}' +> syntax error : 'symbol' : expected member function definition to end with '}' A template member function definition has an unmatched closing brace. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md index 4f25c08138b..80ff0e6f7dd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md @@ -8,7 +8,7 @@ ms.assetid: 21d90348-20d3-438c-b278-efdbfb93a7d2 --- # Compiler Error C2970 -'class' : template parameter 'param' : 'arg' : an expression involving objects with internal linkage cannot be used as a non-type argument +> 'class' : template parameter 'param' : 'arg' : an expression involving objects with internal linkage cannot be used as a non-type argument You cannot use the name or address of a static variable as a template argument. The template class expects a const value that can be evaluated at compile time. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md index 2ff75e440c6..cb1e18bfd97 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md @@ -8,7 +8,7 @@ ms.assetid: fdb5467b-9a41-41ef-ac20-2e9428d5a4fc --- # Compiler Error C2971 -'class' : template parameter 'param' : 'arg' : a local variable cannot be used as a non-type argument +> 'class' : template parameter 'param' : 'arg' : a local variable cannot be used as a non-type argument You cannot use the name or address of a local variable as a template argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2973.md b/docs/error-messages/compiler-errors-2/compiler-error-c2973.md index 2a06b243465..806e4ccc9a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2973.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2973.md @@ -8,6 +8,6 @@ ms.assetid: 18b4a1c1-0ef6-43af-887a-1b5b1ab88d5b --- # Compiler Error C2973 -invalid template argument 'number' +> invalid template argument 'number' Check the template definition to find the correct types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md index 1b9610dfcde..2034afee18a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md @@ -8,7 +8,7 @@ ms.assetid: 1b444260-f2bf-48d7-ab1e-35573d8c4a0e --- # Compiler Error C2974 -invalid type argument 'number', type expected +> invalid type argument 'number', type expected The generic or template argument does not match the generic or template declaration. A type should appear within the angle brackets. Check the generic or template definition to find the correct types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md index 3ed9ac47998..ec6851055f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md @@ -8,7 +8,7 @@ ms.assetid: d9bf9836-325e-4f72-a7e3-a67cf19d32e7 --- # Compiler Error C2976 -'identifier' : too few type arguments +> 'identifier' : too few type arguments A generic or template is missing one or more actual arguments. Check the generic or template declaration to find the correct number of parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md index 4be0207cbb0..bacb489f8e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md @@ -8,7 +8,7 @@ ms.assetid: 3c4218e0-5d03-4a2b-b757-c507c35f3542 --- # Compiler Error C2977 -'identifier' : too many type arguments +> 'identifier' : too many type arguments A generic or template has too many actual arguments. Check the generic or template declaration to find the correct number of parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2978.md b/docs/error-messages/compiler-errors-2/compiler-error-c2978.md index cf6adef4931..55df64fa587 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2978.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2978.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2978"] --- # Compiler Error C2978 -syntax error : expected 'keyword1' or 'keyword2'; found type 'keyword3'; non-type parameters are not supported in generics +> syntax error : expected 'keyword1' or 'keyword2'; found type 'keyword3'; non-type parameters are not supported in generics A generic class was declared incorrectly. See [Generics](../../extensions/generics-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md index c880a70db6b..2fb474dd6fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md @@ -8,7 +8,7 @@ ms.assetid: 98bd9043-ec44-451e-a482-3a8e35fc7464 --- # Compiler Error C2979 -explicit specializations are not supported in generics +> explicit specializations are not supported in generics A generic class was declared incorrectly. See [Generics](../../extensions/generics-cpp-component-extensions.md) for more information. From 7745b4cfd38b7ebf4c0632db866238f3d71f559f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 11 Aug 2025 23:38:06 +0800 Subject: [PATCH 0708/1799] Add "Remarks" and "Example" headings for error references in range [C2941, C2980] --- .../compiler-errors-2/compiler-error-c2941.md | 2 ++ .../compiler-errors-2/compiler-error-c2942.md | 4 ++++ .../compiler-errors-2/compiler-error-c2943.md | 4 ++++ .../compiler-errors-2/compiler-error-c2944.md | 4 ++++ .../compiler-errors-2/compiler-error-c2945.md | 2 ++ .../compiler-errors-2/compiler-error-c2946.md | 2 ++ .../compiler-errors-2/compiler-error-c2947.md | 4 ++++ .../compiler-errors-2/compiler-error-c2948.md | 2 ++ .../compiler-errors-2/compiler-error-c2951.md | 4 ++++ .../compiler-errors-2/compiler-error-c2952.md | 4 ++++ .../compiler-errors-2/compiler-error-c2953.md | 4 ++++ .../compiler-errors-2/compiler-error-c2955.md | 6 ++++-- .../compiler-errors-2/compiler-error-c2956.md | 2 ++ .../compiler-errors-2/compiler-error-c2957.md | 4 ++++ .../compiler-errors-2/compiler-error-c2958.md | 2 ++ .../compiler-errors-2/compiler-error-c2959.md | 2 ++ .../compiler-errors-2/compiler-error-c2962.md | 2 ++ .../compiler-errors-2/compiler-error-c2969.md | 4 ++++ .../compiler-errors-2/compiler-error-c2970.md | 4 ++++ .../compiler-errors-2/compiler-error-c2971.md | 4 ++++ .../compiler-errors-2/compiler-error-c2973.md | 2 ++ .../compiler-errors-2/compiler-error-c2974.md | 4 ++++ .../compiler-errors-2/compiler-error-c2975.md | 4 +++- .../compiler-errors-2/compiler-error-c2976.md | 4 ++++ .../compiler-errors-2/compiler-error-c2977.md | 4 ++++ .../compiler-errors-2/compiler-error-c2978.md | 2 ++ .../compiler-errors-2/compiler-error-c2979.md | 2 ++ 27 files changed, 85 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2941.md b/docs/error-messages/compiler-errors-2/compiler-error-c2941.md index 53c28a6c841..48c997bc082 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2941.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2941.md @@ -10,6 +10,8 @@ ms.assetid: 1bba94eb-5bf6-468d-8f84-96a6391a7048 > '*class*' : type-class-id redefined as a local 'item' +## Remarks + You can't use a generic or template class as an item. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2942.md b/docs/error-messages/compiler-errors-2/compiler-error-c2942.md index 83426631265..a300558b8af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2942.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2942.md @@ -10,10 +10,14 @@ ms.assetid: 13abf744-8fa1-450d-886d-e5717c04956e > '*class*' : type-class-id redefined as a formal argument of a function +## Remarks + You can't use a generic or template class as a formal argument. You cannot pass an argument directly to the constructor of a generic or template class. This error is obsolete in Visual Studio 2022 and later versions. +## Examples + The following sample generates C2942: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2943.md b/docs/error-messages/compiler-errors-2/compiler-error-c2943.md index 99b4d8f7abd..0f91de379a5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2943.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2943.md @@ -10,10 +10,14 @@ ms.assetid: ede6565e-d892-44c0-8eee-c69545f3be2e > '*class*' : type-class-id redefined as a type argument of a template +## Remarks + You can't use a generic or template class, instead of a symbol, as a generic or template type argument. This error is obsolete in Visual Studio 2022 and later versions. +## Example + The following sample generates C2943: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2944.md b/docs/error-messages/compiler-errors-2/compiler-error-c2944.md index 68866586941..178cb0300e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2944.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2944.md @@ -10,10 +10,14 @@ ms.assetid: f209e668-e72f-442a-a438-8c4ff43a404a > '*class*' : type-class-id redefined as a value argument of a template +## Remarks + You can't use a generic or template class, instead of a symbol, as a template value argument. This error is obsolete in Visual Studio 2022 and later versions. +## Examples + The following sample generates C2944: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2945.md b/docs/error-messages/compiler-errors-2/compiler-error-c2945.md index dd14477de6c..ec81b20ef13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2945.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2945.md @@ -10,4 +10,6 @@ ms.assetid: be640257-7017-45d1-986a-9fe8caab52f3 > explicit instantiation does not refer to a template-class specialization +## Remarks + You cannot explicitly instantiate something that is not templated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md index 11de0af1d29..15c453bca86 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md @@ -10,6 +10,8 @@ ms.assetid: c86dfbfc-7702-4f09-8a53-d205710e99c2 > explicit instantiation; 'class' is not a template-class specialization +## Remarks + You cannot explicitly instantiate a nontemplated class. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md index db8b7e50bed..1b37343eafc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md @@ -10,10 +10,14 @@ ms.assetid: 6c056f62-ec90-4883-8a67-aeeb6ec13546 > expecting '>' to terminate construct, found 'syntax' +## Remarks + A generic or template argument list may not have been terminated correctly. C2947 can also be generated by syntax errors. +## Example + The following sample generates C2947: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2948.md b/docs/error-messages/compiler-errors-2/compiler-error-c2948.md index 7d7892973c2..6fc41cdf2b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2948.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2948.md @@ -10,4 +10,6 @@ ms.assetid: 780c6ed3-43a0-4112-8d00-b7bf79086c05 > explicit instantiation; storage class specifier 'specifier' not permitted on specialization +## Remarks + You cannot use storage-class specifiers (such as **`extern`**) in a specialization of a template class that was previously explicitly instantiated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md index a4bf3f395bc..a6094c0acd9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md @@ -10,8 +10,12 @@ ms.assetid: c6f95aa2-c894-425b-a51c-d40d70c8daa1 > type declarations are only permitted at global, namespace, or class scope +## Remarks + You cannot declare a generic or template class outside global or namespace scope. If you make your generic or template declarations in an include file, make sure the include file is at global scope. +## Examples + The following sample generates C2951: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md index 40576ad31e3..ce6a47e58b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md @@ -10,8 +10,12 @@ ms.assetid: a40e18a2-d02c-4511-854f-6c6fd6789a1a > 'declaration' : type declaration missing template parameter list +## Remarks + A template declaration was ill formed. +## Examples + The following sample generates C2952: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md index cda622b333c..b125625cbb5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md @@ -10,8 +10,12 @@ ms.assetid: 8dbcfa24-8296-4e40-bdc4-5526c07d8892 > 'identifier' : class template has already been defined +## Remarks + Check the source file and include files for other definitions. +## Example + The following sample generates C2953: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md index cbe258a9df4..3ee78a6400c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md @@ -10,10 +10,14 @@ ms.assetid: 77709fb6-d69b-46fd-a62f-e8564563d01b > 'identifier' : use of class template or alias generic requires template or generic argument list +## Remarks + You cannot use a class template or class generic as an identifier without a template or generic argument list. For more information, see [Class Templates](../../cpp/class-templates.md). +## Examples + The following sample generates C2955 and shows how to fix it: ```cpp @@ -61,8 +65,6 @@ int main() { } ``` -## Example - **Visual Studio 2017 and later:** The compiler correctly diagnoses missing template argument lists when the template appears in a template parameter list (for example as part of a default template argument or a non-type template parameter). The following code compiles in Visual Studio 2015 but produces an error in Visual Studio 2017. ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2956.md b/docs/error-messages/compiler-errors-2/compiler-error-c2956.md index d5fc9187030..c47796370f3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2956.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2956.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2956"] > usual deallocation function '*function*' would be chosen as placement deallocation function +## Remarks + The deallocation function found for the placement new expression matches one of the usual deallocation functions. Either an implicit compiler-generated deallocation or an explicit `delete` (or `delete[]`) would use the wrong deallocation function. ## Remarks diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md index 678e08e2882..2978f883730 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md @@ -10,8 +10,12 @@ ms.assetid: 9cb4526f-4af8-47e9-b786-56192627ca72 > 'delim' : invalid left delimiter : expected '<' +## Remarks + A generic class was ill formed. +## Example + The following sample generates C2957: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2958.md b/docs/error-messages/compiler-errors-2/compiler-error-c2958.md index eddd75f6066..d8a0645ad07 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2958.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2958.md @@ -10,6 +10,8 @@ ms.assetid: 332bf6d3-7cd1-4b1a-8ddb-d4a8cbf01115 > the left delimiter found at 'location' was not matched correctly +## Remarks + A delimiter is not properly matched. This error can be caused by mismatched parenthesis in a function template declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md index 5720765cfd6..6b32f772624 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md @@ -10,6 +10,8 @@ ms.assetid: d66bb2a8-70c3-4209-a358-b0c47f111a50 > a generic class or function may not be a member of a template +## Remarks + For more information, see [Windows Runtime and Managed Templates](../../extensions/windows-runtime-and-managed-templates-cpp-component-extensions.md) and [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2962.md b/docs/error-messages/compiler-errors-2/compiler-error-c2962.md index 18b34b1231b..3636f1fcd50 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2962.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2962.md @@ -10,6 +10,8 @@ ms.assetid: 6f966aec-4eea-4221-8e1b-fe66808c6f5c > syntax error : 'token' : expected template-class member function definition to end with '}' +## Remarks + The token caused a syntax error in a template declaration. This error can be caused by mismatched delimiters diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md index 3c70de7938c..599ff99228c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md @@ -10,8 +10,12 @@ ms.assetid: e4ea3d66-b937-4b2c-b42a-96e03fb11579 > syntax error : 'symbol' : expected member function definition to end with '}' +## Remarks + A template member function definition has an unmatched closing brace. +## Example + The following sample generates C2969: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md index 80ff0e6f7dd..4384e207deb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md @@ -10,8 +10,12 @@ ms.assetid: 21d90348-20d3-438c-b278-efdbfb93a7d2 > 'class' : template parameter 'param' : 'arg' : an expression involving objects with internal linkage cannot be used as a non-type argument +## Remarks + You cannot use the name or address of a static variable as a template argument. The template class expects a const value that can be evaluated at compile time. +## Example + The following sample generates C2970: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md index cb1e18bfd97..01b6d31d2a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md @@ -10,8 +10,12 @@ ms.assetid: fdb5467b-9a41-41ef-ac20-2e9428d5a4fc > 'class' : template parameter 'param' : 'arg' : a local variable cannot be used as a non-type argument +## Remarks + You cannot use the name or address of a local variable as a template argument. +## Example + The following sample generates C2971: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2973.md b/docs/error-messages/compiler-errors-2/compiler-error-c2973.md index 806e4ccc9a0..4f1a1d9e9f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2973.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2973.md @@ -10,4 +10,6 @@ ms.assetid: 18b4a1c1-0ef6-43af-887a-1b5b1ab88d5b > invalid template argument 'number' +## Remarks + Check the template definition to find the correct types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md index 2034afee18a..6d30a4ced44 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md @@ -10,8 +10,12 @@ ms.assetid: 1b444260-f2bf-48d7-ab1e-35573d8c4a0e > invalid type argument 'number', type expected +## Remarks + The generic or template argument does not match the generic or template declaration. A type should appear within the angle brackets. Check the generic or template definition to find the correct types. +## Examples + The following sample generates C2974: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2975.md b/docs/error-messages/compiler-errors-2/compiler-error-c2975.md index 5e91d46fa5c..e88bcc7d0c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2975.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2975.md @@ -10,9 +10,11 @@ ms.assetid: 526f6b9d-6c76-4c12-9252-1b1d7c1e06c7 > '*argument*' : invalid template argument for '*type*', expected compile-time constant expression +## Remarks + The template argument does not match the template declaration; a constant expression should appear within the angle brackets. Variables are not allowed as template actual arguments. Check the template definition to find the correct types. -## Example +## Examples The following sample generates C2975 and also shows correct usage: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md index ec6851055f8..a1009459956 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md @@ -10,10 +10,14 @@ ms.assetid: d9bf9836-325e-4f72-a7e3-a67cf19d32e7 > 'identifier' : too few type arguments +## Remarks + A generic or template is missing one or more actual arguments. Check the generic or template declaration to find the correct number of parameters. This error can be caused by missing template arguments in C++ Standard Library components. +## Examples + The following sample generates C2976: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md index bacb489f8e8..6351cd87ab8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md @@ -10,8 +10,12 @@ ms.assetid: 3c4218e0-5d03-4a2b-b757-c507c35f3542 > 'identifier' : too many type arguments +## Remarks + A generic or template has too many actual arguments. Check the generic or template declaration to find the correct number of parameters. +## Examples + The following sample generates C2977: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2978.md b/docs/error-messages/compiler-errors-2/compiler-error-c2978.md index 55df64fa587..7ad37f4c11d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2978.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2978.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2978"] > syntax error : expected 'keyword1' or 'keyword2'; found type 'keyword3'; non-type parameters are not supported in generics +## Remarks + A generic class was declared incorrectly. See [Generics](../../extensions/generics-cpp-component-extensions.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md index 2fb474dd6fc..0acf0cb9a1f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md @@ -10,6 +10,8 @@ ms.assetid: 98bd9043-ec44-451e-a482-3a8e35fc7464 > explicit specializations are not supported in generics +## Remarks + A generic class was declared incorrectly. See [Generics](../../extensions/generics-cpp-component-extensions.md) for more information. ## Example From efa6ffe69d0fae54aeb7226df09cc52bca431d89 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 11 Aug 2025 23:39:28 +0800 Subject: [PATCH 0709/1799] Replace term "sample" with "example" for error references in range [C2941, C2980] --- docs/error-messages/compiler-errors-2/compiler-error-c2942.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2943.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2944.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2946.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2947.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2951.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2952.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2953.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2955.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2957.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2959.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2969.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2970.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2971.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2974.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2975.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2976.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2977.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2978.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2979.md | 2 +- 20 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2942.md b/docs/error-messages/compiler-errors-2/compiler-error-c2942.md index a300558b8af..7637fb69626 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2942.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2942.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Examples -The following sample generates C2942: +The following example generates C2942: ```cpp // C2942.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2943.md b/docs/error-messages/compiler-errors-2/compiler-error-c2943.md index 0f91de379a5..dfff0b2c30a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2943.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2943.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Example -The following sample generates C2943: +The following example generates C2943: ```cpp // C2943.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2944.md b/docs/error-messages/compiler-errors-2/compiler-error-c2944.md index 178cb0300e7..3b58aecf56a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2944.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2944.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Examples -The following sample generates C2944: +The following example generates C2944: ```cpp // C2944.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md index 15c453bca86..cd593c8c11f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md @@ -16,7 +16,7 @@ You cannot explicitly instantiate a nontemplated class. ## Example -The following sample generates C2946. +The following example generates C2946. ```cpp // C2946.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md index 1b37343eafc..97b76df03ed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md @@ -18,7 +18,7 @@ C2947 can also be generated by syntax errors. ## Example -The following sample generates C2947: +The following example generates C2947: ```cpp // C2947.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md index a6094c0acd9..92f5aab3032 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md @@ -16,7 +16,7 @@ You cannot declare a generic or template class outside global or namespace scope ## Examples -The following sample generates C2951: +The following example generates C2951: ```cpp // C2951.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md index ce6a47e58b9..2ac4f5650cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md @@ -16,7 +16,7 @@ A template declaration was ill formed. ## Examples -The following sample generates C2952: +The following example generates C2952: ```cpp // C2952.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md index b125625cbb5..c05a495facd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md @@ -16,7 +16,7 @@ Check the source file and include files for other definitions. ## Example -The following sample generates C2953: +The following example generates C2953: ```cpp // C2953.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md index 3ee78a6400c..9a43cfb8531 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md @@ -18,7 +18,7 @@ For more information, see [Class Templates](../../cpp/class-templates.md). ## Examples -The following sample generates C2955 and shows how to fix it: +The following example generates C2955 and shows how to fix it: ```cpp // C2955.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md index 2978f883730..ca9e2e38db9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md @@ -16,7 +16,7 @@ A generic class was ill formed. ## Example -The following sample generates C2957: +The following example generates C2957: ```cpp // C2957.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md index 6b32f772624..25db02eeae6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md @@ -16,7 +16,7 @@ For more information, see [Windows Runtime and Managed Templates](../../extensio ## Example -The following sample generates C2959. +The following example generates C2959. ```cpp // C2959.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md index 599ff99228c..0b0700d1492 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md @@ -16,7 +16,7 @@ A template member function definition has an unmatched closing brace. ## Example -The following sample generates C2969: +The following example generates C2969: ```cpp // C2969.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md index 4384e207deb..ec49df394e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md @@ -16,7 +16,7 @@ You cannot use the name or address of a static variable as a template argument. ## Example -The following sample generates C2970: +The following example generates C2970: ```cpp // C2970.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md index 01b6d31d2a4..ef6fdc52e2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md @@ -16,7 +16,7 @@ You cannot use the name or address of a local variable as a template argument. ## Example -The following sample generates C2971: +The following example generates C2971: ```cpp // C2971.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md index 6d30a4ced44..63cbb1a65c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md @@ -16,7 +16,7 @@ The generic or template argument does not match the generic or template declarat ## Examples -The following sample generates C2974: +The following example generates C2974: ```cpp // C2974.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2975.md b/docs/error-messages/compiler-errors-2/compiler-error-c2975.md index e88bcc7d0c9..021cf829d09 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2975.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2975.md @@ -16,7 +16,7 @@ The template argument does not match the template declaration; a constant expres ## Examples -The following sample generates C2975 and also shows correct usage: +The following example generates C2975 and also shows correct usage: ```cpp // C2975.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md index a1009459956..ce5e294b1ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md @@ -18,7 +18,7 @@ This error can be caused by missing template arguments in C++ Standard Library c ## Examples -The following sample generates C2976: +The following example generates C2976: ```cpp // C2976.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md index 6351cd87ab8..810d28566d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md @@ -16,7 +16,7 @@ A generic or template has too many actual arguments. Check the generic or templa ## Examples -The following sample generates C2977: +The following example generates C2977: ```cpp // C2977.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2978.md b/docs/error-messages/compiler-errors-2/compiler-error-c2978.md index 7ad37f4c11d..d9bee87b88d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2978.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2978.md @@ -15,7 +15,7 @@ A generic class was declared incorrectly. See [Generics](../../extensions/generi ## Example -The following sample generates C2978. +The following example generates C2978. ```cpp // C2978.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md index 0acf0cb9a1f..74ae7d58b1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md @@ -16,7 +16,7 @@ A generic class was declared incorrectly. See [Generics](../../extensions/gener ## Example -The following sample generates C2979. +The following example generates C2979. ```cpp // C2979.cpp From dfc2f0766d0a921c0b0262f5c50bc9cb29b05e94 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 11 Aug 2025 23:43:23 +0800 Subject: [PATCH 0710/1799] Update metadata for error references in range [C2941, C2980] --- .../error-messages/compiler-errors-2/compiler-error-c2941.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2942.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2943.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2944.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c2945.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2946.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2947.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2948.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2951.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2952.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2953.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2955.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2956.md | 2 +- .../error-messages/compiler-errors-2/compiler-error-c2957.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2958.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2959.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2962.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2969.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2970.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2971.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2973.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2974.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2975.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2976.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2977.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2979.md | 5 ++--- 26 files changed, 47 insertions(+), 72 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2941.md b/docs/error-messages/compiler-errors-2/compiler-error-c2941.md index 48c997bc082..4d14d929168 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2941.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2941.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2941" title: "Compiler Error C2941" +description: "Learn more about: Compiler Error C2941" ms.date: 06/01/2022 f1_keywords: ["C2941"] helpviewer_keywords: ["C2941"] -ms.assetid: 1bba94eb-5bf6-468d-8f84-96a6391a7048 --- # Compiler Error C2941 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2942.md b/docs/error-messages/compiler-errors-2/compiler-error-c2942.md index 7637fb69626..f806be05068 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2942.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2942.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2942" title: "Compiler Error C2942" +description: "Learn more about: Compiler Error C2942" ms.date: 06/01/2022 f1_keywords: ["C2942"] helpviewer_keywords: ["C2942"] -ms.assetid: 13abf744-8fa1-450d-886d-e5717c04956e --- # Compiler Error C2942 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2943.md b/docs/error-messages/compiler-errors-2/compiler-error-c2943.md index dfff0b2c30a..d2ede6f3564 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2943.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2943.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2943" title: "Compiler Error C2943" +description: "Learn more about: Compiler Error C2943" ms.date: 06/01/2022 f1_keywords: ["C2943"] helpviewer_keywords: ["C2943"] -ms.assetid: ede6565e-d892-44c0-8eee-c69545f3be2e --- # Compiler Error C2943 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2944.md b/docs/error-messages/compiler-errors-2/compiler-error-c2944.md index 3b58aecf56a..4c2a3a33869 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2944.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2944.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2944" title: "Compiler Error C2944" +description: "Learn more about: Compiler Error C2944" ms.date: 06/01/2022 f1_keywords: ["C2944"] helpviewer_keywords: ["C2944"] -ms.assetid: f209e668-e72f-442a-a438-8c4ff43a404a --- # Compiler Error C2944 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2945.md b/docs/error-messages/compiler-errors-2/compiler-error-c2945.md index ec81b20ef13..9674071222b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2945.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2945.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2945" title: "Compiler Error C2945" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2945" +ms.date: 11/04/2016 f1_keywords: ["C2945"] helpviewer_keywords: ["C2945"] -ms.assetid: be640257-7017-45d1-986a-9fe8caab52f3 --- # Compiler Error C2945 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md index cd593c8c11f..01b72d1aeb9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2946" title: "Compiler Error C2946" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2946" +ms.date: 11/04/2016 f1_keywords: ["C2946"] helpviewer_keywords: ["C2946"] -ms.assetid: c86dfbfc-7702-4f09-8a53-d205710e99c2 --- # Compiler Error C2946 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md index 97b76df03ed..ef70b5db307 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2947" title: "Compiler Error C2947" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2947" +ms.date: 11/04/2016 f1_keywords: ["C2947"] helpviewer_keywords: ["C2947"] -ms.assetid: 6c056f62-ec90-4883-8a67-aeeb6ec13546 --- # Compiler Error C2947 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2948.md b/docs/error-messages/compiler-errors-2/compiler-error-c2948.md index 6fc41cdf2b8..18dda3d7874 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2948.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2948.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2948" title: "Compiler Error C2948" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2948" +ms.date: 11/04/2016 f1_keywords: ["C2948"] helpviewer_keywords: ["C2948"] -ms.assetid: 780c6ed3-43a0-4112-8d00-b7bf79086c05 --- # Compiler Error C2948 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md index 92f5aab3032..993bf2811b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2951" title: "Compiler Error C2951" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2951" +ms.date: 11/04/2016 f1_keywords: ["C2951"] helpviewer_keywords: ["C2951"] -ms.assetid: c6f95aa2-c894-425b-a51c-d40d70c8daa1 --- # Compiler Error C2951 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md index 2ac4f5650cc..59b2ce3c7f4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2952" title: "Compiler Error C2952" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2952" +ms.date: 11/04/2016 f1_keywords: ["C2952"] helpviewer_keywords: ["C2952"] -ms.assetid: a40e18a2-d02c-4511-854f-6c6fd6789a1a --- # Compiler Error C2952 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md index c05a495facd..a9f3ae8178a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2953" title: "Compiler Error C2953" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2953" +ms.date: 11/04/2016 f1_keywords: ["C2953"] helpviewer_keywords: ["C2953"] -ms.assetid: 8dbcfa24-8296-4e40-bdc4-5526c07d8892 --- # Compiler Error C2953 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md index 9a43cfb8531..93996879010 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2955" title: "Compiler Error C2955" -ms.date: "03/28/2017" +description: "Learn more about: Compiler Error C2955" +ms.date: 03/28/2017 f1_keywords: ["C2955"] helpviewer_keywords: ["C2955"] -ms.assetid: 77709fb6-d69b-46fd-a62f-e8564563d01b --- # Compiler Error C2955 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2956.md b/docs/error-messages/compiler-errors-2/compiler-error-c2956.md index c47796370f3..e9701d87421 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2956.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2956.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2956" title: "Compiler Error C2956" +description: "Learn more about: Compiler Error C2956" ms.date: 04/05/2022 f1_keywords: ["C2956"] helpviewer_keywords: ["C2956"] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md index ca9e2e38db9..2c1e921c6a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2957" title: "Compiler Error C2957" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2957" +ms.date: 11/04/2016 f1_keywords: ["C2957"] helpviewer_keywords: ["C2957"] -ms.assetid: 9cb4526f-4af8-47e9-b786-56192627ca72 --- # Compiler Error C2957 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2958.md b/docs/error-messages/compiler-errors-2/compiler-error-c2958.md index d8a0645ad07..341ff3c1dd6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2958.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2958.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2958" title: "Compiler Error C2958" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2958" +ms.date: 11/04/2016 f1_keywords: ["C2958"] helpviewer_keywords: ["C2958"] -ms.assetid: 332bf6d3-7cd1-4b1a-8ddb-d4a8cbf01115 --- # Compiler Error C2958 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md index 25db02eeae6..af70755a70c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2959" title: "Compiler Error C2959" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2959" +ms.date: 11/04/2016 f1_keywords: ["C2959"] helpviewer_keywords: ["C2959"] -ms.assetid: d66bb2a8-70c3-4209-a358-b0c47f111a50 --- # Compiler Error C2959 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2962.md b/docs/error-messages/compiler-errors-2/compiler-error-c2962.md index 3636f1fcd50..87f5149e549 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2962.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2962.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2962" title: "Compiler Error C2962" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2962" +ms.date: 11/04/2016 f1_keywords: ["C2962"] helpviewer_keywords: ["C2962"] -ms.assetid: 6f966aec-4eea-4221-8e1b-fe66808c6f5c --- # Compiler Error C2962 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md index 0b0700d1492..76d07d11952 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2969" title: "Compiler Error C2969" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2969" +ms.date: 11/04/2016 f1_keywords: ["C2969"] helpviewer_keywords: ["C2969"] -ms.assetid: e4ea3d66-b937-4b2c-b42a-96e03fb11579 --- # Compiler Error C2969 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md index ec49df394e6..f92b1c41441 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2970" title: "Compiler Error C2970" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2970" +ms.date: 11/04/2016 f1_keywords: ["C2970"] helpviewer_keywords: ["C2970"] -ms.assetid: 21d90348-20d3-438c-b278-efdbfb93a7d2 --- # Compiler Error C2970 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md index ef6fdc52e2a..667d494be2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2971" title: "Compiler Error C2971" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2971" +ms.date: 11/04/2016 f1_keywords: ["C2971"] helpviewer_keywords: ["C2971"] -ms.assetid: fdb5467b-9a41-41ef-ac20-2e9428d5a4fc --- # Compiler Error C2971 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2973.md b/docs/error-messages/compiler-errors-2/compiler-error-c2973.md index 4f1a1d9e9f2..79b7b4ab806 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2973.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2973.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2973" title: "Compiler Error C2973" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2973" +ms.date: 11/04/2016 f1_keywords: ["C2973"] helpviewer_keywords: ["C2973"] -ms.assetid: 18b4a1c1-0ef6-43af-887a-1b5b1ab88d5b --- # Compiler Error C2973 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md index 63cbb1a65c5..1ae52a62674 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2974" title: "Compiler Error C2974" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2974" +ms.date: 11/04/2016 f1_keywords: ["C2974"] helpviewer_keywords: ["C2974"] -ms.assetid: 1b444260-f2bf-48d7-ab1e-35573d8c4a0e --- # Compiler Error C2974 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2975.md b/docs/error-messages/compiler-errors-2/compiler-error-c2975.md index 021cf829d09..e9254cb923f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2975.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2975.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2975" title: "Compiler Error C2975" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2975" +ms.date: 11/04/2016 f1_keywords: ["C2975"] helpviewer_keywords: ["C2975"] -ms.assetid: 526f6b9d-6c76-4c12-9252-1b1d7c1e06c7 --- # Compiler Error C2975 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md index ce5e294b1ce..d9b7e0953b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2976" title: "Compiler Error C2976" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2976" +ms.date: 11/04/2016 f1_keywords: ["C2976"] helpviewer_keywords: ["C2976"] -ms.assetid: d9bf9836-325e-4f72-a7e3-a67cf19d32e7 --- # Compiler Error C2976 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md index 810d28566d8..302846e67d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2977" title: "Compiler Error C2977" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2977" +ms.date: 11/04/2016 f1_keywords: ["C2977"] helpviewer_keywords: ["C2977"] -ms.assetid: 3c4218e0-5d03-4a2b-b757-c507c35f3542 --- # Compiler Error C2977 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md index 74ae7d58b1b..691bd16a70c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2979" title: "Compiler Error C2979" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2979" +ms.date: 11/04/2016 f1_keywords: ["C2979"] helpviewer_keywords: ["C2979"] -ms.assetid: 98bd9043-ec44-451e-a482-3a8e35fc7464 --- # Compiler Error C2979 From 032a5857b592eebbb832b12f77bbde2ed00dc02a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 11 Aug 2025 23:46:56 +0800 Subject: [PATCH 0711/1799] Revert extraneous "Remarks" heading added in C2956 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c2956.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2956.md b/docs/error-messages/compiler-errors-2/compiler-error-c2956.md index e9701d87421..77f9fee4e42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2956.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2956.md @@ -13,8 +13,6 @@ helpviewer_keywords: ["C2956"] The deallocation function found for the placement new expression matches one of the usual deallocation functions. Either an implicit compiler-generated deallocation or an explicit `delete` (or `delete[]`) would use the wrong deallocation function. -## Remarks - Error C2956 indicates you used a *placement new expression* (a `new` expression that takes parameters) in a way that can cause a memory leak or runtime crash. It usually means the resulting value can't be deleted in a typical way. That is, either an explicit `delete` (or `delete[]`) expression in your code, or the implicit deallocation when a constructor throws an exception, could invoke the wrong `operator delete` or supply it with the wrong parameters. The C++ standard specifies *usual deallocation functions* as overloads of `operator delete` or `operator delete[]` that take extra parameters of type `std::size_t` (C++14 or later), `std::align_val_t` (C++17 or later), and `std::destroying_delete_t` (C++20 or later). When you use a placement new expression, the compiler looks for a matching `operator delete` function that takes the same parameters (after the first one). If one is found and its signature matches a usual deallocation function, the compiler reports error C2956. From 09f465101094373a1eaa8f9295557ac480dba3f6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 00:40:21 +0800 Subject: [PATCH 0712/1799] Merge and condense `mutable` remarks in C2178 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2178.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index ce0dfb543fd..37211d190e3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -11,9 +11,7 @@ helpviewer_keywords: ["C2178"] ## Remarks -A **`mutable`** specifier was used in a declaration, but the specifier is not allowed in this context. - -The **`mutable`** specifier can be applied only to names of class data members, and cannot be applied to names declared **`const`** or **`static`**, and cannot be applied to reference members. +A **`mutable`** specifier was used in a declaration, but the specifier is not allowed in this context. It can only be applied to non-static, non-const, and non-reference data members. For more information, see [Mutable Data Members](../../cpp/mutable-data-members-cpp.md). ## Example From db8eef149c6aa4e5397173c6e2d880a160b54442 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 00:53:41 +0800 Subject: [PATCH 0713/1799] Improve `mutable` example in C2178 error reference --- .../compiler-errors-1/compiler-error-c2178.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index 37211d190e3..71d88406979 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -13,19 +13,18 @@ helpviewer_keywords: ["C2178"] A **`mutable`** specifier was used in a declaration, but the specifier is not allowed in this context. It can only be applied to non-static, non-const, and non-reference data members. For more information, see [Mutable Data Members](../../cpp/mutable-data-members-cpp.md). -## Example +## Example: `mutable` -The following example shows how C2178 may occur, and how to fix it. +The following example shows how C2178 may occur with the **`mutable`** specifier, and how to resolve it: ```cpp -// C2178.cpp -// compile with: cl /c /W4 C2178.cpp +// C2178_mutable.cpp +// compile with: /c -class S { - mutable const int i; // C2178 - // To fix, declare either const or mutable, not both. +struct S +{ + mutable const int i; // C2178, remove mutable or const to resolve }; -mutable int x = 4; // C2178 -// To fix, remove mutable keyword +mutable int x = 4; // C2178, remove mutable to resolve ``` From 69de9153bb8df413df1f65d828ddcbd9aa6c9700 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 01:09:08 +0800 Subject: [PATCH 0714/1799] Add remarks on `consteval` in C2178 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2178.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index 71d88406979..c3c17849f14 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -13,6 +13,8 @@ helpviewer_keywords: ["C2178"] A **`mutable`** specifier was used in a declaration, but the specifier is not allowed in this context. It can only be applied to non-static, non-const, and non-reference data members. For more information, see [Mutable Data Members](../../cpp/mutable-data-members-cpp.md). +A **`consteval`** specifier was used on a [destructor](../../cpp/destructors-cpp.md), allocation function, or deallocation function. + ## Example: `mutable` The following example shows how C2178 may occur with the **`mutable`** specifier, and how to resolve it: From c2143792f68dcee1ec82cc9d218a523e80818cbe Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 01:15:28 +0800 Subject: [PATCH 0715/1799] Add `consteval` example in C2178 error reference --- .../compiler-errors-1/compiler-error-c2178.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index c3c17849f14..4482c040175 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -30,3 +30,22 @@ struct S mutable int x = 4; // C2178, remove mutable to resolve ``` + +## Example: `consteval` + +The following example shows how C2178 may occur with the **`consteval`** specifier. To resolve this error, remove all **`consteval`** specifiers: + +```cpp +// C2178_consteval.cpp +// compile with: /c /std:c++20 + +#include + +struct S +{ + consteval ~S() {} // C2178 + + consteval static void* operator new(std::size_t size); // C2178 + consteval static void operator delete(void* ptr); // C2178 +}; +``` From 7f4c5e6438ed1ee764792713d171d8fc0851cbbe Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 01:16:43 +0800 Subject: [PATCH 0716/1799] Update `ms.date` metadata in C2178 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2178.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index 4482c040175..4c93e6c79d6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2178" description: "Learn more about: Compiler Error C2178" -ms.date: 05/08/2017 +ms.date: 08/11/2025 f1_keywords: ["C2178"] helpviewer_keywords: ["C2178"] --- From 4b5730b2792d9bfb14c333ff4ecb3f9a09af2334 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 11 Aug 2025 14:56:00 -0700 Subject: [PATCH 0717/1799] Write original description for check_malloc_usable_size --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index bce5940efb0..49155fe28b7 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -22,7 +22,7 @@ If you discover options that are inaccurately documented, we invite you to [repo |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned.| |`atexit` | `false` | If `true`, prints ASan exit stats even after program terminates successfully.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| -|`check_malloc_usable_size` | `true` | Allows the users to work around the bug in Nvidia drivers prior to `295.*`.| +|`check_malloc_usable_size` | `true` | If `true`, reports an error when the pointer does not reference a valid, currently allocated block.| |`check_printf` | `true` | If `true`, enables ASan to validate printf family function arguments for memory safety violations.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - `stderr(1)`, `2` - `stderr(2)`. See [continue_on_error](asan-continue-on-error.md).| |`coverage` | `false` | If `true` and the coverage instrumentation was enabled at compile time, coverage information will be dumped at program shutdown.| From b155f114e5d8f87ba1e65cb6e5eca89a44f23e2e Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 11 Aug 2025 14:56:43 -0700 Subject: [PATCH 0718/1799] Update windows flags --- docs/sanitizers/asan-flags.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 49155fe28b7..c4729fa84bb 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -24,7 +24,7 @@ If you discover options that are inaccurately documented, we invite you to [repo |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`check_malloc_usable_size` | `true` | If `true`, reports an error when the pointer does not reference a valid, currently allocated block.| |`check_printf` | `true` | If `true`, enables ASan to validate printf family function arguments for memory safety violations.| -|`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - `stderr(1)`, `2` - `stderr(2)`. See [continue_on_error](asan-continue-on-error.md).| +|`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`coverage` | `false` | If `true` and the coverage instrumentation was enabled at compile time, coverage information will be dumped at program shutdown.| |`coverage_bitset` | `false` | If `true`, the coverage information will also be dumped as a bitset to a separate file.| |`coverage_counters` | `false` | If `true`, the bitmap that corresponds to coverage counters will be dumped.| @@ -45,12 +45,13 @@ If you discover options that are inaccurately documented, we invite you to [repo |`fast_unwind_on_fatal` | `false` | If available, the tool uses the fast frame-pointer-based unwinder on fatal errors.| |`fast_unwind_on_malloc` | `true` | If available, the tool uses the fast frame-pointer-based unwinder on `malloc`/`free`.| |`full_address_space` | `false` | Sanitize complete address space; by default kernel area on 32-bit platforms will not be sanitized.| -|`halt_on_error` | `true` | Exit/abort the program after printing the first error report (May cause undefined behavior).| +|`halt_on_error` | `true` | Exit/abort the program after printing the first error report (May cause undefined behavior, use `continue_on_error` for full support).| |`handle_segv` | `true` | `false` - ASan will not handle `SEGV` errors, `true` - ASan handles `SEGV` errors.| |`handle_sigfpe` | `true` | `false` - ASan will not handle `SIGFPE` errors, `true` - ASan will handle `SIGFPE` errors.| |`handle_sigill` | `true` | `false` - ASan will not handle `SIGILL` errors, `true` - ASan will handle `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to console.| |`html_cov_report` | `false` | If `true`, ASan generates a coverage report.| +|`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include` | `""` | Read more options from the given file.| |`include_if_exists` | `""` | Read more options from the given file (if it exists).| |`intercept_memcmp` | `true` | If `true`, uses custom wrappers for memcmp function to find more errors.| @@ -100,6 +101,8 @@ If you discover options that are inaccurately documented, we invite you to [repo |`use_madv_dontdump` | `true` | If `true`, instructs kernel to not store shadow in core file.| |`use_odr_indicator` | `false` | If `true`, emit odr violations.| |`verbosity` | `0` | Verbosity level: `0` - default, `1` - more, `2+` - even more output.| +|`windows_fast_fail_on_error`|`false`|If `true`, enable the process to terminate with a `__fastfail(71)` after printing the error report. See [windows_fast_fail_on_error](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| +|`windows_hook_legacy_allocators`|`true`|If `true`, enable hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| ## See also From b2c6db0db28a93ca07bb3ea08a2943de24f547a9 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 11 Aug 2025 16:24:00 -0700 Subject: [PATCH 0719/1799] Remove flags with no codepath --- docs/sanitizers/asan-flags.md | 8 -------- 1 file changed, 8 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index c4729fa84bb..fe467452831 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -26,13 +26,6 @@ If you discover options that are inaccurately documented, we invite you to [repo |`check_printf` | `true` | If `true`, enables ASan to validate printf family function arguments for memory safety violations.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`coverage` | `false` | If `true` and the coverage instrumentation was enabled at compile time, coverage information will be dumped at program shutdown.| -|`coverage_bitset` | `false` | If `true`, the coverage information will also be dumped as a bitset to a separate file.| -|`coverage_counters` | `false` | If `true`, the bitmap that corresponds to coverage counters will be dumped.| -|`coverage_dir` | `"."` | Target directory for coverage dumps. Defaults to the current directory.| -|`coverage_direct` | `false` | If `true`, coverage information will be dumped directly to a memory mapped file. This way data is not lost even if the process is suddenly killed.| -|`coverage_order_pcs` | `false` | If `true`, the PCs will be dumped in the order they've appeared during the execution.| -|`coverage_pcs` | `true` | If `true` the coverage information will be dumped as a set of PC offsets for every module.| -|`debug` | `false` | If `true`, prints some debugging information and does additional checks.| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If >`0`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects. Higher values increase detection effort.| |`detect_odr_violation` | `2` | If >=`2`, detect violation of One-Definition-Rule (ODR) violation; If `1`, detect ODR-violation only if the two variables have different sizes.| @@ -99,7 +92,6 @@ If you discover options that are inaccurately documented, we invite you to [repo |`symbolize_vs_style` | `false` | Print file locations in Visual Studio style (e.g: file(10,42): ...).| |`unmap_shadow_on_exit` | `false` | If `true`, explicitly unmaps the shadow memory at exit.| |`use_madv_dontdump` | `true` | If `true`, instructs kernel to not store shadow in core file.| -|`use_odr_indicator` | `false` | If `true`, emit odr violations.| |`verbosity` | `0` | Verbosity level: `0` - default, `1` - more, `2+` - even more output.| |`windows_fast_fail_on_error`|`false`|If `true`, enable the process to terminate with a `__fastfail(71)` after printing the error report. See [windows_fast_fail_on_error](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`windows_hook_legacy_allocators`|`true`|If `true`, enable hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| From ba303de9efc865d238fb0c36e4f32b3c81621660 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 11 Aug 2025 16:24:19 -0700 Subject: [PATCH 0720/1799] Fix default value for detect_odr_violation --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index fe467452831..810386caa89 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -28,7 +28,7 @@ If you discover options that are inaccurately documented, we invite you to [repo |`coverage` | `false` | If `true` and the coverage instrumentation was enabled at compile time, coverage information will be dumped at program shutdown.| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If >`0`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects. Higher values increase detection effort.| -|`detect_odr_violation` | `2` | If >=`2`, detect violation of One-Definition-Rule (ODR) violation; If `1`, detect ODR-violation only if the two variables have different sizes.| +|`detect_odr_violation` | `0` | If >=`2`, detect violation of One-Definition-Rule (ODR) violation; If `1`, detect ODR-violation only if the two variables have different sizes.| |`detect_stack_use_after_return` | `false` | Enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`disable_coredump` | `true`/`false` (on non-64-bit systems) | Disables core dumping. By default, the tool sets `disable_coredump=1` on 64-bit systems to prevent dumping a 16T+ core file. The tool ignores this flag on operating systems that don't dump core by default and for sanitizers that don't reserve large amounts of virtual memory.| |`dump_instruction_bytes` | `false` | If `true`, dump 16 bytes starting at the instruction that caused `SEGV`.| From 1f985ca9d0663288a3cb1d2afe4c0f684178c4a5 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 11 Aug 2025 16:24:43 -0700 Subject: [PATCH 0721/1799] Add AddressSanitizer Runtime Options to TOC --- docs/sanitizers/toc.yml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/sanitizers/toc.yml b/docs/sanitizers/toc.yml index f46431207c9..b7f72923398 100644 --- a/docs/sanitizers/toc.yml +++ b/docs/sanitizers/toc.yml @@ -12,6 +12,10 @@ items: href: ../sanitizers/asan-building.md - name: "Runtime reference" href: ../sanitizers/asan-runtime.md + expanded: true + items: + - name: "AddressSanitizer runtime options" + href: ../sanitizers/asan-flags.md - name: "Debugger integration" href: ../sanitizers/asan-debugger-integration.md - name: "Shadow bytes" From 06bc0537fd1af5623a2deaceb80fce5b3be8ef64 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 11 Aug 2025 16:30:10 -0700 Subject: [PATCH 0722/1799] Removed coverage --- docs/sanitizers/asan-flags.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 810386caa89..6237688eb2d 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -25,7 +25,6 @@ If you discover options that are inaccurately documented, we invite you to [repo |`check_malloc_usable_size` | `true` | If `true`, reports an error when the pointer does not reference a valid, currently allocated block.| |`check_printf` | `true` | If `true`, enables ASan to validate printf family function arguments for memory safety violations.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| -|`coverage` | `false` | If `true` and the coverage instrumentation was enabled at compile time, coverage information will be dumped at program shutdown.| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If >`0`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects. Higher values increase detection effort.| |`detect_odr_violation` | `0` | If >=`2`, detect violation of One-Definition-Rule (ODR) violation; If `1`, detect ODR-violation only if the two variables have different sizes.| From 628fdb214012b0fb1bfbf7dfac5ad49c8f829ecf Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 11 Aug 2025 16:34:28 -0700 Subject: [PATCH 0723/1799] Removed allow_addr2line --- docs/sanitizers/asan-flags.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 6237688eb2d..996a29b8de0 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -18,7 +18,6 @@ If you discover options that are inaccurately documented, we invite you to [repo |`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| |`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` and fail when out of memory instead of crashing.| |`allocator_release_to_os_interval_ms` | `-1` | Experimental. 64-bit allocator only. Specify minimum time interval in ms between attempts to release memory.| -|`allow_addr2line` | `false` | If `true`, the tool uses the `addr2line` binary to symbolize stack traces when `llvm-symbolizer` is not available.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned.| |`atexit` | `false` | If `true`, prints ASan exit stats even after program terminates successfully.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| From 4e983bbcb54b537aebeb7ca8949655c1ce02f40e Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 11 Aug 2025 16:36:51 -0700 Subject: [PATCH 0724/1799] Fix TOC --- docs/sanitizers/toc.yml | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/sanitizers/toc.yml b/docs/sanitizers/toc.yml index b7f72923398..b3c548bda9e 100644 --- a/docs/sanitizers/toc.yml +++ b/docs/sanitizers/toc.yml @@ -12,10 +12,8 @@ items: href: ../sanitizers/asan-building.md - name: "Runtime reference" href: ../sanitizers/asan-runtime.md - expanded: true - items: - - name: "AddressSanitizer runtime options" - href: ../sanitizers/asan-flags.md + - name: "AddressSanitizer runtime options" + href: ../sanitizers/asan-flags.md - name: "Debugger integration" href: ../sanitizers/asan-debugger-integration.md - name: "Shadow bytes" From bf56a02bd050decdc53e7d3fc97610632fc54614 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 21:50:40 +0800 Subject: [PATCH 0725/1799] Add blockquotes for error messages in range [C2981, C3010] --- docs/error-messages/compiler-errors-2/compiler-error-c2988.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2989.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2990.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2991.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2992.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2993.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2994.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2995.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2996.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3001.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3002.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3003.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3004.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3005.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3006.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3007.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3008.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3009.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3010.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2988.md b/docs/error-messages/compiler-errors-2/compiler-error-c2988.md index a7abd23cc3a..61e31d4a76b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2988.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2988.md @@ -8,6 +8,6 @@ ms.assetid: c07ada8d-7cdf-4496-8656-cc3851e76b46 --- # Compiler Error C2988 -unrecognizable template declaration/definition +> unrecognizable template declaration/definition The template declaration does not parse correctly. Check delimiters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md index 7b6991ded17..893a711ef62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md @@ -8,7 +8,7 @@ ms.assetid: 936303d8-eb3b-4746-82ec-2f18020a6f64 --- # Compiler Error C2989 -'class' : class type has already been declared as a non-class type +> 'class' : class type has already been declared as a non-class type The class generic or template redefines a non-template or non-generic class. Check header files for conflicts. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md index b0132230ba9..7064767974e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md @@ -8,7 +8,7 @@ ms.assetid: 674e9f6a-6743-4af0-a7ed-cbe11103a2f8 --- # Compiler Error C2990 -'class' : non-class type as already been declared as a class type +> 'class' : non-class type as already been declared as a class type The non generic or template class redefines a generic or template class. Check header files for conflicts. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md index 6a972a047e6..d15806a7b14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md @@ -8,7 +8,7 @@ ms.assetid: a87e4404-26e8-4927-b3ee-5d02b3b8bee1 --- # Compiler Error C2991 -redefinition of type parameter 'parameter' +> redefinition of type parameter 'parameter' There was a type conflict between two generic or template definitions of `parameter`. When defining multiple generic or template parameters, you must use equivalent types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md index 2220dec8212..f2ff5d79252 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md @@ -8,7 +8,7 @@ ms.assetid: 01b16447-43fe-4e91-9a5a-af884a166a31 --- # Compiler Error C2992 -'class' : invalid or missing type parameter list +> 'class' : invalid or missing type parameter list The class is preceded by a **`template`** or **generic** keyword with missing or invalid parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md index 3588a205e10..3c25c04806a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2993"] --- # Compiler Error C2993 -'identifier' : illegal type for non-type template parameter 'parameter' +> 'identifier' : illegal type for non-type template parameter 'parameter' - Prior to C++20, you cannot declare a template with a structure, class, or union argument. Pointers can be used in place of these types as template parameters. - Since C++20, structure, class, or unions *can* be used as non-type template parameters. A non-type template parameter can't be a rvalue reference type or a parameter pack of rvalue types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2994.md b/docs/error-messages/compiler-errors-2/compiler-error-c2994.md index 506170906f5..876e11fe68c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2994.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2994.md @@ -8,6 +8,6 @@ ms.assetid: b03570b5-e5fd-41d8-bdf1-dfadc2b1e116 --- # Compiler Error C2994 -unnamed class in template parameter list +> unnamed class in template parameter list You cannot use the **`class`** keyword as a template argument without specifying a class name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md index c720f6294c5..5021ac81359 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md @@ -8,7 +8,7 @@ ms.assetid: a57cdfe0-b40b-4a67-a95c-1a49ace4842b --- # Compiler Error C2995 -'function' : function template has already been defined +> 'function' : function template has already been defined Make sure that there is only one definition for each member function of a templated class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2996.md b/docs/error-messages/compiler-errors-2/compiler-error-c2996.md index d21aa58ca7f..547ff605e42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2996.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2996.md @@ -8,6 +8,6 @@ ms.assetid: f0ca9f8b-1751-4182-adab-1424f0c5e0c0 --- # Compiler Error C2996 -'function' : recursive function template definition +> 'function' : recursive function template definition A function definition attempts to instantiate its root templated class. Recursive template instantiations are not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md index 8839791989f..b7c74724815 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md @@ -8,7 +8,7 @@ ms.assetid: d0e03478-1b44-47e5-8f5b-70415fa1f8bc --- # Compiler Error C3001 -'error_text' : expected an OpenMP directive name +> 'error_text' : expected an OpenMP directive name The `omp` pragma must be followed by a directive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md index 0bc4652dba0..a789c036487 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md @@ -8,7 +8,7 @@ ms.assetid: 2d4241a7-c8eb-4d43-a128-dca255d137bc --- # Compiler Error C3002 -'name1 name2' : multiple OpenMP directive names +> 'name1 name2' : multiple OpenMP directive names Multiple directive names are not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md index 9bec4bf3c4a..c0be6722c0e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md @@ -8,7 +8,7 @@ ms.assetid: 22e74f99-bb7f-4518-ab0d-934d5d49bcc7 --- # Compiler Error C3003 -'directive' : OpenMP directive name not allowed after directive clauses +> 'directive' : OpenMP directive name not allowed after directive clauses An OpenMP directive name cannot follow an OpenMP directive clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md index 47e57c17a04..94561fc3aae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md @@ -8,7 +8,7 @@ ms.assetid: 819c2b57-8366-4ca7-9135-1f0c5e5b6bb6 --- # Compiler Error C3004 -'clause' : clause not valid on OpenMP 'directive' directive +> 'clause' : clause not valid on OpenMP 'directive' directive An OpenMP clause was used on a directive for which it is not enabled. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md index 6548d72a0f2..489bb58fbfb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md @@ -8,7 +8,7 @@ ms.assetid: 30bad565-e79f-4c3f-82cb-a74bd0baab8f --- # Compiler Error C3005 -'error_text' : unexpected token encountered on OpenMP 'directive' directive +> 'error_text' : unexpected token encountered on OpenMP 'directive' directive An OpenMP directive was ill formed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md index 13bc64c5b49..788f1c039b1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md @@ -8,7 +8,7 @@ ms.assetid: 449082ec-fd45-4c47-8ab3-ba6a719e4dc4 --- # Compiler Error C3006 -'clause' : clause on OpenMP 'directive' directive is missing an expected argument +> 'clause' : clause on OpenMP 'directive' directive is missing an expected argument An OpenMP directive did not have an expected argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md index f4d9bd13b97..a860cb4c431 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md @@ -8,7 +8,7 @@ ms.assetid: e415ef42-bdc9-4f32-8198-5e25b289a089 --- # Compiler Error C3007 -'arg' : clause on OpenMP 'directive' directive does not take an argument +> 'arg' : clause on OpenMP 'directive' directive does not take an argument An OpenMP directive had an argument, but the directive does not take an argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md index 41bbfcc6010..96d25b1813e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md @@ -8,7 +8,7 @@ ms.assetid: 04d93201-28e5-4be0-945c-aad616376f4b --- # Compiler Error C3008 -'arg' : argument is missing closing ')' on OpenMP 'directive' directive +> 'arg' : argument is missing closing ')' on OpenMP 'directive' directive An OpenMP directive that takes an argument did not have a closing parenthesis. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md index 83fd8c99acc..0d84bcf690a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md @@ -8,7 +8,7 @@ ms.assetid: aded5985-f5fd-4c3e-a157-16be55ec1313 --- # Compiler Error C3009 -'label' : jump into OpenMP structured block not allowed +> 'label' : jump into OpenMP structured block not allowed Code cannot jump into or out of an OpenMP block. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md index dc715809c72..cc5e752fa1d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md @@ -8,7 +8,7 @@ ms.assetid: e959d038-bba6-432a-9c0a-0470474de7d9 --- # Compiler Error C3010 -'label' : jump out of OpenMP structured block not allowed +> 'label' : jump out of OpenMP structured block not allowed Code cannot jump into or out of an OpenMP block. From 4e657a0d792ecc352137d556e6889eac91af5389 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 21:55:50 +0800 Subject: [PATCH 0726/1799] Add "Remarks" and "Example" headings for error references in range [C2981, C3010] --- docs/error-messages/compiler-errors-2/compiler-error-c2988.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2989.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2990.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2991.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2992.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c2993.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2994.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c2995.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c2996.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3001.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3002.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3003.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3004.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3005.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3006.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3007.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3008.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3009.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3010.md | 4 ++++ 19 files changed, 69 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2988.md b/docs/error-messages/compiler-errors-2/compiler-error-c2988.md index 61e31d4a76b..6587264a0e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2988.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2988.md @@ -10,4 +10,6 @@ ms.assetid: c07ada8d-7cdf-4496-8656-cc3851e76b46 > unrecognizable template declaration/definition +## Remarks + The template declaration does not parse correctly. Check delimiters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md index 893a711ef62..8e56b4345af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md @@ -10,8 +10,12 @@ ms.assetid: 936303d8-eb3b-4746-82ec-2f18020a6f64 > 'class' : class type has already been declared as a non-class type +## Remarks + The class generic or template redefines a non-template or non-generic class. Check header files for conflicts. +## Examples + The following sample generates C2989: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md index 7064767974e..57cc884f8f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md @@ -10,8 +10,12 @@ ms.assetid: 674e9f6a-6743-4af0-a7ed-cbe11103a2f8 > 'class' : non-class type as already been declared as a class type +## Remarks + The non generic or template class redefines a generic or template class. Check header files for conflicts. +## Examples + The following sample generates C2990: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md index d15806a7b14..34a450788d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md @@ -10,8 +10,12 @@ ms.assetid: a87e4404-26e8-4927-b3ee-5d02b3b8bee1 > redefinition of type parameter 'parameter' +## Remarks + There was a type conflict between two generic or template definitions of `parameter`. When defining multiple generic or template parameters, you must use equivalent types. +## Examples + The following sample generates C2991: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md index f2ff5d79252..7e354443583 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md @@ -10,9 +10,11 @@ ms.assetid: 01b16447-43fe-4e91-9a5a-af884a166a31 > 'class' : invalid or missing type parameter list +## Remarks + The class is preceded by a **`template`** or **generic** keyword with missing or invalid parameters. -## Example +## Examples The following sample generates C2992: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md index 3c25c04806a..6dd712f21c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md @@ -9,9 +9,13 @@ helpviewer_keywords: ["C2993"] > 'identifier' : illegal type for non-type template parameter 'parameter' +## Remarks + - Prior to C++20, you cannot declare a template with a structure, class, or union argument. Pointers can be used in place of these types as template parameters. - Since C++20, structure, class, or unions *can* be used as non-type template parameters. A non-type template parameter can't be a rvalue reference type or a parameter pack of rvalue types. +## Examples + The following sample generates C2993: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2994.md b/docs/error-messages/compiler-errors-2/compiler-error-c2994.md index 876e11fe68c..1c00b2db304 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2994.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2994.md @@ -10,4 +10,6 @@ ms.assetid: b03570b5-e5fd-41d8-bdf1-dfadc2b1e116 > unnamed class in template parameter list +## Remarks + You cannot use the **`class`** keyword as a template argument without specifying a class name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md index 5021ac81359..441aad5706f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md @@ -10,8 +10,12 @@ ms.assetid: a57cdfe0-b40b-4a67-a95c-1a49ace4842b > 'function' : function template has already been defined +## Remarks + Make sure that there is only one definition for each member function of a templated class. +## Example + The following sample generates C2995: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2996.md b/docs/error-messages/compiler-errors-2/compiler-error-c2996.md index 547ff605e42..725753f83ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2996.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2996.md @@ -10,4 +10,6 @@ ms.assetid: f0ca9f8b-1751-4182-adab-1424f0c5e0c0 > 'function' : recursive function template definition +## Remarks + A function definition attempts to instantiate its root templated class. Recursive template instantiations are not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md index b7c74724815..582f4846df0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md @@ -10,8 +10,12 @@ ms.assetid: d0e03478-1b44-47e5-8f5b-70415fa1f8bc > 'error_text' : expected an OpenMP directive name +## Remarks + The `omp` pragma must be followed by a directive. +## Example + The following sample generates C3001: ```c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md index a789c036487..1320bf7e62a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md @@ -10,8 +10,12 @@ ms.assetid: 2d4241a7-c8eb-4d43-a128-dca255d137bc > 'name1 name2' : multiple OpenMP directive names +## Remarks + Multiple directive names are not allowed. +## Example + The following sample generates C3002: ```c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md index c0be6722c0e..4e62e0d710f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md @@ -10,8 +10,12 @@ ms.assetid: 22e74f99-bb7f-4518-ab0d-934d5d49bcc7 > 'directive' : OpenMP directive name not allowed after directive clauses +## Remarks + An OpenMP directive name cannot follow an OpenMP directive clause. +## Example + The following sample generates C3003: ```c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md index 94561fc3aae..e39eca40a96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md @@ -10,8 +10,12 @@ ms.assetid: 819c2b57-8366-4ca7-9135-1f0c5e5b6bb6 > 'clause' : clause not valid on OpenMP 'directive' directive +## Remarks + An OpenMP clause was used on a directive for which it is not enabled. +## Example + The following sample generates C3004: ```c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md index 489bb58fbfb..ead2e3d6e34 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md @@ -10,8 +10,12 @@ ms.assetid: 30bad565-e79f-4c3f-82cb-a74bd0baab8f > 'error_text' : unexpected token encountered on OpenMP 'directive' directive +## Remarks + An OpenMP directive was ill formed. +## Examples + The following sample generates C3005: ```c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md index 788f1c039b1..37bb9f389c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md @@ -10,8 +10,12 @@ ms.assetid: 449082ec-fd45-4c47-8ab3-ba6a719e4dc4 > 'clause' : clause on OpenMP 'directive' directive is missing an expected argument +## Remarks + An OpenMP directive did not have an expected argument. +## Example + The following sample generates C3006: ```c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md index a860cb4c431..7509223f975 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md @@ -10,8 +10,12 @@ ms.assetid: e415ef42-bdc9-4f32-8198-5e25b289a089 > 'arg' : clause on OpenMP 'directive' directive does not take an argument +## Remarks + An OpenMP directive had an argument, but the directive does not take an argument. +## Example + The following sample generates C3007: ```c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md index 96d25b1813e..172d9d1f013 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md @@ -10,8 +10,12 @@ ms.assetid: 04d93201-28e5-4be0-945c-aad616376f4b > 'arg' : argument is missing closing ')' on OpenMP 'directive' directive +## Remarks + An OpenMP directive that takes an argument did not have a closing parenthesis. +## Example + The following sample generates C3008: ```c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md index 0d84bcf690a..96715bbb449 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md @@ -10,8 +10,12 @@ ms.assetid: aded5985-f5fd-4c3e-a157-16be55ec1313 > 'label' : jump into OpenMP structured block not allowed +## Remarks + Code cannot jump into or out of an OpenMP block. +## Example + The following sample generates C3009: ```c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md index cc5e752fa1d..5f43a2c7ff9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md @@ -10,8 +10,12 @@ ms.assetid: e959d038-bba6-432a-9c0a-0470474de7d9 > 'label' : jump out of OpenMP structured block not allowed +## Remarks + Code cannot jump into or out of an OpenMP block. +## Example + The following sample generates C3010: ```c From 7091e9a4e90081f34c2e9dba5aa7d9bbc122c3c8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 21:57:00 +0800 Subject: [PATCH 0727/1799] Replace term "sample" with "example" for error references in range [C2981, C3010] --- docs/error-messages/compiler-errors-2/compiler-error-c2989.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2990.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c2991.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2992.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2993.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2995.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3001.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3002.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3003.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3004.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3005.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3006.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3007.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3008.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3009.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3010.md | 2 +- 16 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md index 8e56b4345af..1ec1f6ab7a5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md @@ -16,7 +16,7 @@ The class generic or template redefines a non-template or non-generic class. Che ## Examples -The following sample generates C2989: +The following example generates C2989: ```cpp // C2989.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md index 57cc884f8f9..9413e360d38 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md @@ -16,7 +16,7 @@ The non generic or template class redefines a generic or template class. Check h ## Examples -The following sample generates C2990: +The following example generates C2990: ```cpp // C2990.cpp @@ -39,7 +39,7 @@ ref struct GC {}; // C2990 C2990 can also occur due to a breaking change in the Microsoft C++ compiler for Visual Studio 2005; the compiler now requires that multiple declarations for the same type be identical with respect to template specification. -The following sample generates C2990: +The following example generates C2990: ```cpp // C2990c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md index 34a450788d5..300ff2c2554 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md @@ -16,7 +16,7 @@ There was a type conflict between two generic or template definitions of `parame ## Examples -The following sample generates C2991: +The following example generates C2991: ```cpp // C2991.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md index 7e354443583..a74b31344e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md @@ -16,7 +16,7 @@ The class is preceded by a **`template`** or **generic** keyword with missing or ## Examples -The following sample generates C2992: +The following example generates C2992: ```cpp // C2992.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md index 6dd712f21c9..fa2850f6cc3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md @@ -16,7 +16,7 @@ helpviewer_keywords: ["C2993"] ## Examples -The following sample generates C2993: +The following example generates C2993: ```cpp // compile with: /c and /std:c++17 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md index 441aad5706f..3021b307936 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md @@ -16,7 +16,7 @@ Make sure that there is only one definition for each member function of a templa ## Example -The following sample generates C2995: +The following example generates C2995: ```cpp // C2995.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md index 582f4846df0..051c5b3d0da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md @@ -16,7 +16,7 @@ The `omp` pragma must be followed by a directive. ## Example -The following sample generates C3001: +The following example generates C3001: ```c // C3001.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md index 1320bf7e62a..b7afe81ef37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md @@ -16,7 +16,7 @@ Multiple directive names are not allowed. ## Example -The following sample generates C3002: +The following example generates C3002: ```c // C3002.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md index 4e62e0d710f..9a886f734da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md @@ -16,7 +16,7 @@ An OpenMP directive name cannot follow an OpenMP directive clause. ## Example -The following sample generates C3003: +The following example generates C3003: ```c // C3003.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md index e39eca40a96..556e8685aee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md @@ -16,7 +16,7 @@ An OpenMP clause was used on a directive for which it is not enabled. ## Example -The following sample generates C3004: +The following example generates C3004: ```c // C3004.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md index ead2e3d6e34..9e18b66ee80 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md @@ -16,7 +16,7 @@ An OpenMP directive was ill formed. ## Examples -The following sample generates C3005: +The following example generates C3005: ```c // C3005.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md index 37bb9f389c9..88b0254e9c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md @@ -16,7 +16,7 @@ An OpenMP directive did not have an expected argument. ## Example -The following sample generates C3006: +The following example generates C3006: ```c // C3006.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md index 7509223f975..dbd79f8cb59 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md @@ -16,7 +16,7 @@ An OpenMP directive had an argument, but the directive does not take an argument ## Example -The following sample generates C3007: +The following example generates C3007: ```c // C3007.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md index 172d9d1f013..7423297d682 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md @@ -16,7 +16,7 @@ An OpenMP directive that takes an argument did not have a closing parenthesis. ## Example -The following sample generates C3008: +The following example generates C3008: ```c // C3008.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md index 96715bbb449..fa2d153d9d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md @@ -16,7 +16,7 @@ Code cannot jump into or out of an OpenMP block. ## Example -The following sample generates C3009: +The following example generates C3009: ```c // C3009.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md index 5f43a2c7ff9..0d5053d4894 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md @@ -16,7 +16,7 @@ Code cannot jump into or out of an OpenMP block. ## Example -The following sample generates C3010: +The following example generates C3010: ```c // C3010.c From 7d86057e7518ce6ec609e9d55fa2cf79b154d6e9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 21:59:58 +0800 Subject: [PATCH 0728/1799] Update metadata for error references in range [C2981, C3010] --- .../error-messages/compiler-errors-2/compiler-error-c2988.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2989.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2990.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2991.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2992.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2993.md | 4 ++-- .../error-messages/compiler-errors-2/compiler-error-c2994.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2995.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c2996.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3001.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3002.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3003.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3004.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3005.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3006.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3007.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3008.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3009.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3010.md | 5 ++--- 19 files changed, 38 insertions(+), 56 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2988.md b/docs/error-messages/compiler-errors-2/compiler-error-c2988.md index 6587264a0e1..06f37437baa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2988.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2988.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2988" title: "Compiler Error C2988" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2988" +ms.date: 11/04/2016 f1_keywords: ["C2988"] helpviewer_keywords: ["C2988"] -ms.assetid: c07ada8d-7cdf-4496-8656-cc3851e76b46 --- # Compiler Error C2988 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md index 1ec1f6ab7a5..973a9e9107e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2989" title: "Compiler Error C2989" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2989" +ms.date: 11/04/2016 f1_keywords: ["C2989"] helpviewer_keywords: ["C2989"] -ms.assetid: 936303d8-eb3b-4746-82ec-2f18020a6f64 --- # Compiler Error C2989 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md index 9413e360d38..02ecde2c786 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2990" title: "Compiler Error C2990" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2990" +ms.date: 11/04/2016 f1_keywords: ["C2990"] helpviewer_keywords: ["C2990"] -ms.assetid: 674e9f6a-6743-4af0-a7ed-cbe11103a2f8 --- # Compiler Error C2990 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md index 300ff2c2554..7b9c8c2bc13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2991" title: "Compiler Error C2991" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2991" +ms.date: 11/04/2016 f1_keywords: ["C2991"] helpviewer_keywords: ["C2991"] -ms.assetid: a87e4404-26e8-4927-b3ee-5d02b3b8bee1 --- # Compiler Error C2991 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md index a74b31344e6..023ef93a9b3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2992" title: "Compiler Error C2992" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2992" +ms.date: 11/04/2016 f1_keywords: ["C2992"] helpviewer_keywords: ["C2992"] -ms.assetid: 01b16447-43fe-4e91-9a5a-af884a166a31 --- # Compiler Error C2992 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md index fa2850f6cc3..dc9f175046f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2993" title: "Compiler Error C2993" -ms.date: "10/03/2023" +description: "Learn more about: Compiler Error C2993" +ms.date: 10/03/2023 f1_keywords: ["C2993"] helpviewer_keywords: ["C2993"] --- diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2994.md b/docs/error-messages/compiler-errors-2/compiler-error-c2994.md index 1c00b2db304..9aa9c4f11a1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2994.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2994.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2994" title: "Compiler Error C2994" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2994" +ms.date: 11/04/2016 f1_keywords: ["C2994"] helpviewer_keywords: ["C2994"] -ms.assetid: b03570b5-e5fd-41d8-bdf1-dfadc2b1e116 --- # Compiler Error C2994 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md index 3021b307936..03f7125d169 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2995" title: "Compiler Error C2995" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2995" +ms.date: 11/04/2016 f1_keywords: ["C2995"] helpviewer_keywords: ["C2995"] -ms.assetid: a57cdfe0-b40b-4a67-a95c-1a49ace4842b --- # Compiler Error C2995 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2996.md b/docs/error-messages/compiler-errors-2/compiler-error-c2996.md index 725753f83ca..8222baa8df3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2996.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2996.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2996" title: "Compiler Error C2996" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2996" +ms.date: 11/04/2016 f1_keywords: ["C2996"] helpviewer_keywords: ["C2996"] -ms.assetid: f0ca9f8b-1751-4182-adab-1424f0c5e0c0 --- # Compiler Error C2996 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md index 051c5b3d0da..617f88cb018 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3001" title: "Compiler Error C3001" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3001" +ms.date: 11/04/2016 f1_keywords: ["C3001"] helpviewer_keywords: ["C3001"] -ms.assetid: d0e03478-1b44-47e5-8f5b-70415fa1f8bc --- # Compiler Error C3001 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md index b7afe81ef37..ee452060426 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3002" title: "Compiler Error C3002" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3002" +ms.date: 11/04/2016 f1_keywords: ["C3002"] helpviewer_keywords: ["C3002"] -ms.assetid: 2d4241a7-c8eb-4d43-a128-dca255d137bc --- # Compiler Error C3002 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md index 9a886f734da..c9a04e0dbb2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3003" title: "Compiler Error C3003" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3003" +ms.date: 11/04/2016 f1_keywords: ["C3003"] helpviewer_keywords: ["C3003"] -ms.assetid: 22e74f99-bb7f-4518-ab0d-934d5d49bcc7 --- # Compiler Error C3003 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md index 556e8685aee..7d9edc3a448 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3004" title: "Compiler Error C3004" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3004" +ms.date: 11/04/2016 f1_keywords: ["C3004"] helpviewer_keywords: ["C3004"] -ms.assetid: 819c2b57-8366-4ca7-9135-1f0c5e5b6bb6 --- # Compiler Error C3004 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md index 9e18b66ee80..83f3fcf62df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3005" title: "Compiler Error C3005" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3005" +ms.date: 11/04/2016 f1_keywords: ["C3005"] helpviewer_keywords: ["C3005"] -ms.assetid: 30bad565-e79f-4c3f-82cb-a74bd0baab8f --- # Compiler Error C3005 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md index 88b0254e9c8..278771bdba0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3006" title: "Compiler Error C3006" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3006" +ms.date: 11/04/2016 f1_keywords: ["C3006"] helpviewer_keywords: ["C3006"] -ms.assetid: 449082ec-fd45-4c47-8ab3-ba6a719e4dc4 --- # Compiler Error C3006 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md index dbd79f8cb59..a18f67035f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3007" title: "Compiler Error C3007" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3007" +ms.date: 11/04/2016 f1_keywords: ["C3007"] helpviewer_keywords: ["C3007"] -ms.assetid: e415ef42-bdc9-4f32-8198-5e25b289a089 --- # Compiler Error C3007 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md index 7423297d682..e9578e2930f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3008" title: "Compiler Error C3008" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3008" +ms.date: 11/04/2016 f1_keywords: ["C3008"] helpviewer_keywords: ["C3008"] -ms.assetid: 04d93201-28e5-4be0-945c-aad616376f4b --- # Compiler Error C3008 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md index fa2d153d9d6..7a3a7aa8252 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3009" title: "Compiler Error C3009" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3009" +ms.date: 11/04/2016 f1_keywords: ["C3009"] helpviewer_keywords: ["C3009"] -ms.assetid: aded5985-f5fd-4c3e-a157-16be55ec1313 --- # Compiler Error C3009 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md index 0d5053d4894..def3dcb1b98 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3010" title: "Compiler Error C3010" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3010" +ms.date: 11/04/2016 f1_keywords: ["C3010"] helpviewer_keywords: ["C3010"] -ms.assetid: e959d038-bba6-432a-9c0a-0470474de7d9 --- # Compiler Error C3010 From eecc5c350906aadbbd53409ef5364927a8edffc1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 22:41:34 +0800 Subject: [PATCH 0729/1799] Fix wrong link destination in table of standard library references --- docs/standard-library/chrono.md | 2 +- docs/standard-library/new.md | 2 +- docs/standard-library/path-class.md | 2 +- docs/standard-library/zoned-time-class.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/chrono.md b/docs/standard-library/chrono.md index 82bc6ae8243..f2fdb6b4b75 100644 --- a/docs/standard-library/chrono.md +++ b/docs/standard-library/chrono.md @@ -44,7 +44,7 @@ Using the time-zone facilities on older versions of Windows results in a runtime | [`month` class](month-class.md) | A month of a year. For example, July. | | [`month_day` class](month-day-class.md) | A specific day of a specific month. For example, July 30. | | [`month_day_last` class](month-day-last-class.md) | The last day of a month. | -| [`month_weekday` class](month-day-last-class.md) | The nth weekday of a specific month. | +| [`month_weekday` class](month-weekday-class.md) | The nth weekday of a specific month. | | [`month_weekday_last` class](month-weekday-last-class.md) | The nth weekday of a specific month. | | [`time_point` class](time-point-class.md) | A point in time. | | [`weekday` class](weekday-class.md) | A day of the week. | diff --git a/docs/standard-library/new.md b/docs/standard-library/new.md index 79dfcd6b5b4..ef0a6dba9bf 100644 --- a/docs/standard-library/new.md +++ b/docs/standard-library/new.md @@ -33,7 +33,7 @@ Some of the functions declared in this header are replaceable. The implementatio |Name|Description| |-|-| |[new_handler](../standard-library/new-typedefs.md#new_handler)|A type that points to a function suitable for use as a new handler.| -|[hardware_constructive_interference_size](../standard-library/new-typedefs.md#hardware_destructive_interference_size)|| +|[hardware_constructive_interference_size](../standard-library/new-typedefs.md#hardware_constructive_interference_size)|| |[hardware_destructive_interference_size](../standard-library/new-typedefs.md#hardware_destructive_interference_size)|| ### Functions diff --git a/docs/standard-library/path-class.md b/docs/standard-library/path-class.md index 6e5499a4672..b358291f7fc 100644 --- a/docs/standard-library/path-class.md +++ b/docs/standard-library/path-class.md @@ -41,7 +41,7 @@ class path; |[`c_str`](#c_str)|Returns a pointer to the first character in `mypath`.| |[`clear`](#clear)|Executes `mypath.clear()`.| |[`compare`](#compare)|Returns comparison values.| -|[`concat`](#compare)|Appends the specified sequence to `mypath`, converted (but not inserting a separator) as needed.| +|[`concat`](#concat)|Appends the specified sequence to `mypath`, converted (but not inserting a separator) as needed.| |[`empty`](#empty)|Returns `mypath.empty()`.| |[`end`](#end)|Returns an end-of-sequence iterator of type `iterator`.| |[`extension`](#extension)|Returns the suffix of `filename()`.| diff --git a/docs/standard-library/zoned-time-class.md b/docs/standard-library/zoned-time-class.md index 3fbc4f7dcc1..c5b82df46cf 100644 --- a/docs/standard-library/zoned-time-class.md +++ b/docs/standard-library/zoned-time-class.md @@ -33,7 +33,7 @@ A `zoned_time` always refers to a valid time zone and represents a point in time |[`get_time_zone`](#get_time_zone) | Gets the [time_zone](time-zone-class.md) stored in this `zoned_time`. | |[`operator=`](#op_=)| Assign the value of another `zoned_time`, or another `zoned_time`'s `local_time` or `sys_time`, to this `zoned_time`.| |[`operator local_time`](#op_local_time)| Combines the `zoned_time`'s time zone with the stored time point to produce the local time in that time zone.| -|[`operator sys_time`](#op_local_time)| Gets the time stored in this `zoned_time` without applying the time zone. | +|[`operator sys_time`](#op_sys_time)| Gets the time stored in this `zoned_time` without applying the time zone. | ## Non-members From 4af37caf4aa230411d3b633deb30bb89230cf28b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 22:44:09 +0800 Subject: [PATCH 0730/1799] Update metadata in 2 standard library references --- docs/standard-library/new.md | 5 ++--- docs/standard-library/path-class.md | 2 +- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/new.md b/docs/standard-library/new.md index ef0a6dba9bf..09baa6795b1 100644 --- a/docs/standard-library/new.md +++ b/docs/standard-library/new.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["new header"] -ms.assetid: 218e2a15-34e8-4ef3-9122-1e90eccf8559 --- # `` diff --git a/docs/standard-library/path-class.md b/docs/standard-library/path-class.md index b358291f7fc..8f7edbb9c17 100644 --- a/docs/standard-library/path-class.md +++ b/docs/standard-library/path-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: path Class" title: "path Class" +description: "Learn more about: path Class" ms.date: 06/17/2022 f1_keywords: ["filesystem/std::experimental::filesystem::path"] --- From c47a61b4213ce5fd05d29539f6da5f9684cb176b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 23:28:13 +0800 Subject: [PATCH 0731/1799] Add blockquotes for error messages in range [C3011, C3030] --- docs/error-messages/compiler-errors-2/compiler-error-c3011.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3013.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3014.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3015.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3016.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3017.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3018.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3019.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3020.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3021.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3022.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3023.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3024.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3025.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3026.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3027.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3028.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3029.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3030.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md index 830e14b0863..184908ef9f3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md @@ -8,7 +8,7 @@ ms.assetid: 24c3a917-ebff-4deb-9155-23adf6468531 --- # Compiler Error C3011 -inline assembly not allowed directly within a parallel region +> inline assembly not allowed directly within a parallel region An `omp` parallel region cannot contain inline assembly instructions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md index cd9019d1f11..e24b4b609d3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md @@ -8,7 +8,7 @@ ms.assetid: f896777d-27e6-4b6d-baab-1567317f3374 --- # Compiler Error C3013 -'clause' : clause may only appear once on OpenMP 'directive' directive +> 'clause' : clause may only appear once on OpenMP 'directive' directive A clause appeared twice on the same directive. Delete one occurrence of the clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md index 6f59ffd243c..7f753b92046 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md @@ -8,7 +8,7 @@ ms.assetid: af1c5b0c-dbf9-4274-b06a-c6c2cdcf2a52 --- # Compiler Error C3014 -expected a for loop following OpenMP 'directive' directive +> expected a for loop following OpenMP 'directive' directive It is an error for anything other than a **`for`** loop to immediately follow a `#pragma omp for` directive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md index cbc3d828a33..c5cb3b11812 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md @@ -8,7 +8,7 @@ ms.assetid: d5e8e50b-7542-4b2d-8665-1b22072a5bc6 --- # Compiler Error C3015 -initialization in OpenMP 'for' statement has improper form +> initialization in OpenMP 'for' statement has improper form A **`for`** loop in an OpenMP statement must be fully and explicitly specified. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md index ef990e16bb7..20d461bc7c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md @@ -8,7 +8,7 @@ ms.assetid: 3423467e-e8bb-4f35-b4db-7925cafa74c1 --- # Compiler Error C3016 -'var' : index variable in OpenMP 'for' statement must have signed integral type +> 'var' : index variable in OpenMP 'for' statement must have signed integral type The index variable in an OpenMP **`for`** statement must be a signed integral type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md index 35ffc5aecf9..23f6a183d7c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md @@ -8,7 +8,7 @@ ms.assetid: 12ab2c2a-d0d2-4900-9cbf-39be0af590dd --- # Compiler Error C3017 -termination test in OpenMP 'for' statement has improper form +> termination test in OpenMP 'for' statement has improper form A **`for`** loop in an OpenMP statement must be fully and explicitly specified. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md index 9843c07518c..1451896ed8c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md @@ -8,7 +8,7 @@ ms.assetid: 685be45f-f116-43a8-a88d-05ab6616e2f1 --- # Compiler Error C3018 -'var1' : OpenMP 'for' test or increment must use index variable 'var2' +> 'var1' : OpenMP 'for' test or increment must use index variable 'var2' A **`for`** loop in an OpenMP statement must use the same variable for its test and increment as it uses for its index. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md index 72a6e03a165..96ce0b9966e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md @@ -8,7 +8,7 @@ ms.assetid: 31a6d9b6-d29f-4499-9ad8-48dd751e87c7 --- # Compiler Error C3019 -increment in OpenMP 'for' statement has improper form +> increment in OpenMP 'for' statement has improper form The increment part of an OpenMP **`for`** loop must use the index variable both on the left and right side of the operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md index 4f67e28e54e..c465b030a06 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md @@ -8,7 +8,7 @@ ms.assetid: f625c7a3-afaa-4bd8-9c1b-51891b832f36 --- # Compiler Error C3020 -'var' : index variable of OpenMP 'for' loop cannot be modified in loop body +> 'var' : index variable of OpenMP 'for' loop cannot be modified in loop body An OpenMP **`for`** loop may not modify the index (loop counter) in the body of the **`for`** loop. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md index 5a016f5608e..64cdebd6283 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md @@ -8,7 +8,7 @@ ms.assetid: 0cef6d97-e267-438a-ac8b-0daf5bbbc2cf --- # Compiler Error C3021 -'arg' : argument is empty on OpenMP directive 'directive' +> 'arg' : argument is empty on OpenMP directive 'directive' An argument is required for an OpenMP directive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md index ca6749b8abb..91aca931e2b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md @@ -8,7 +8,7 @@ ms.assetid: 9f1d444c-6c6e-48d9-9346-69128390aa33 --- # Compiler Error C3022 -'clause' : invalid schedule kind of 'value' on OpenMP 'directive' directive +> 'clause' : invalid schedule kind of 'value' on OpenMP 'directive' directive An unsupported value was passed to a clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md index 5cc79ab4b52..d0a4b21be80 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md @@ -8,7 +8,7 @@ ms.assetid: 89dcce98-3cd7-4931-a50f-87df1d2ebc9b --- # Compiler Error C3023 -'value' : unexpected token encountered in argument to OpenMP 'clause' clause +> 'value' : unexpected token encountered in argument to OpenMP 'clause' clause The values passed to a clause were not valid. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md index a9c91358b3c..c906fc8ca20 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md @@ -8,7 +8,7 @@ ms.assetid: 1c031c28-ce37-4de3-aead-cfe76b261856 --- # Compiler Error C3024 -'schedule(runtime)' : chunk_size expression is not allowed +> 'schedule(runtime)' : chunk_size expression is not allowed A value cannot be passed to the run-time parameter of the schedule clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md index ef52fb54153..2f289eb5a32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md @@ -8,7 +8,7 @@ ms.assetid: 4442f5a3-d9ea-4873-b1fb-e7e5bd3cbe5e --- # Compiler Error C3025 -'clause' : integral expression expected +> 'clause' : integral expression expected A clause requires an integer expression but was given a noninteger expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md index cf7c5487239..a6465945175 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md @@ -8,7 +8,7 @@ ms.assetid: 3297060e-cc5b-4600-a2db-09bfc4ffa21f --- # Compiler Error C3026 -'clause' : constant expression must be positive +> 'clause' : constant expression must be positive A clause was passed an integer value, but the value was not a positive number. The number must be positive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md index 8276f6de600..1066399f1c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md @@ -8,7 +8,7 @@ ms.assetid: 6562a5c2-2f28-4b36-91ca-2a64c0f0501a --- # Compiler Error C3027 -'clause' : arithmetic or pointer expression expected +> 'clause' : arithmetic or pointer expression expected A clause that requires an arithmetic or pointer expression was passed another kind of expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md index d64d33f2004..9c18838cbdb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md @@ -8,7 +8,7 @@ ms.assetid: 175e697f-8e8f-492a-8456-6240ffbbb900 --- # Compiler Error C3028 -'member' : only a variable or static data member can be used in a data-sharing clause +> 'member' : only a variable or static data member can be used in a data-sharing clause A symbol other than a variable or static data member was passed to the reduction clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md index 8b2b019ed48..9b7d8632711 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md @@ -8,7 +8,7 @@ ms.assetid: 655eb04d-504a-468d-8c0c-bda1e5f297b7 --- # Compiler Error C3029 -'symbol' : can only appear once in data-sharing clauses in an OpenMP directive +> 'symbol' : can only appear once in data-sharing clauses in an OpenMP directive A symbol was used more than once in one or more clauses in a directive. The symbol can only be used once in the directive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md index daf295ebe76..5d197ced09d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md @@ -8,7 +8,7 @@ ms.assetid: de92fd7e-29ba-46e8-b43b-f4b985cd74de --- # Compiler Error C3030 -'var' : variable in 'reduction' clause/directive cannot have reference type +> 'var' : variable in 'reduction' clause/directive cannot have reference type You can only pass value parameters to certain clauses, such as the reduction clause. From 87e152c6e6afd5c90ad1ef77ef9f5defa0e1b593 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 23:33:11 +0800 Subject: [PATCH 0732/1799] Add "Remarks" and "Example" headings for error references in range [C3011, C3030] --- docs/error-messages/compiler-errors-2/compiler-error-c3011.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3012.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3013.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3014.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3015.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3016.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3017.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3018.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3019.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3020.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3021.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3022.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3023.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3024.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3025.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3026.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3027.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3028.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3029.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3030.md | 4 ++++ 20 files changed, 70 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md index 184908ef9f3..27ca8b1ad47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md @@ -10,8 +10,12 @@ ms.assetid: 24c3a917-ebff-4deb-9155-23adf6468531 > inline assembly not allowed directly within a parallel region +## Remarks + An `omp` parallel region cannot contain inline assembly instructions. +## Example + The following sample generates C3011: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3012.md b/docs/error-messages/compiler-errors-2/compiler-error-c3012.md index 8754ce80f9b..c0e3ad5038a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3012.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3012.md @@ -10,6 +10,8 @@ ms.assetid: cc7040b1-b3fb-4da6-a474-877914d30332 > '*intrinsic*' : intrinsic function not allowed directly within a parallel region +## Remarks + A [compiler intrinsic](../../intrinsics/compiler-intrinsics.md) function is not allowed in an `omp parallel` region. To fix this issue, move intrinsics out of the region, or replace them with non-intrinsic equivalents. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md index e24b4b609d3..2c8d9745f1c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md @@ -10,8 +10,12 @@ ms.assetid: f896777d-27e6-4b6d-baab-1567317f3374 > 'clause' : clause may only appear once on OpenMP 'directive' directive +## Remarks + A clause appeared twice on the same directive. Delete one occurrence of the clause. +## Example + The following sample generates C3013: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md index 7f753b92046..66db6d4d0a9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md @@ -10,8 +10,12 @@ ms.assetid: af1c5b0c-dbf9-4274-b06a-c6c2cdcf2a52 > expected a for loop following OpenMP 'directive' directive +## Remarks + It is an error for anything other than a **`for`** loop to immediately follow a `#pragma omp for` directive. +## Example + The following sample generates C3014: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md index c5cb3b11812..395e5bf21b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md @@ -10,8 +10,12 @@ ms.assetid: d5e8e50b-7542-4b2d-8665-1b22072a5bc6 > initialization in OpenMP 'for' statement has improper form +## Remarks + A **`for`** loop in an OpenMP statement must be fully and explicitly specified. +## Example + The following sample generates C3015: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md index 20d461bc7c3..eebec69cdea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md @@ -10,8 +10,12 @@ ms.assetid: 3423467e-e8bb-4f35-b4db-7925cafa74c1 > 'var' : index variable in OpenMP 'for' statement must have signed integral type +## Remarks + The index variable in an OpenMP **`for`** statement must be a signed integral type. +## Example + The following sample generates C3016: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md index 23f6a183d7c..cc236ebc241 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md @@ -10,8 +10,12 @@ ms.assetid: 12ab2c2a-d0d2-4900-9cbf-39be0af590dd > termination test in OpenMP 'for' statement has improper form +## Remarks + A **`for`** loop in an OpenMP statement must be fully and explicitly specified. +## Example + The following sample generates C3017: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md index 1451896ed8c..7e0760e0317 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md @@ -10,8 +10,12 @@ ms.assetid: 685be45f-f116-43a8-a88d-05ab6616e2f1 > 'var1' : OpenMP 'for' test or increment must use index variable 'var2' +## Remarks + A **`for`** loop in an OpenMP statement must use the same variable for its test and increment as it uses for its index. +## Example + The following sample generates C3018: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md index 96ce0b9966e..5e26f0053ad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md @@ -10,8 +10,12 @@ ms.assetid: 31a6d9b6-d29f-4499-9ad8-48dd751e87c7 > increment in OpenMP 'for' statement has improper form +## Remarks + The increment part of an OpenMP **`for`** loop must use the index variable both on the left and right side of the operator. +## Example + The following sample generates C3019: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md index c465b030a06..4dd37d8ea96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md @@ -10,8 +10,12 @@ ms.assetid: f625c7a3-afaa-4bd8-9c1b-51891b832f36 > 'var' : index variable of OpenMP 'for' loop cannot be modified in loop body +## Remarks + An OpenMP **`for`** loop may not modify the index (loop counter) in the body of the **`for`** loop. +## Examples + The following sample generates C3020: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md index 64cdebd6283..4ce78cd3f75 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md @@ -10,6 +10,8 @@ ms.assetid: 0cef6d97-e267-438a-ac8b-0daf5bbbc2cf > 'arg' : argument is empty on OpenMP directive 'directive' +## Remarks + An argument is required for an OpenMP directive. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md index 91aca931e2b..ca958d5229a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md @@ -10,8 +10,12 @@ ms.assetid: 9f1d444c-6c6e-48d9-9346-69128390aa33 > 'clause' : invalid schedule kind of 'value' on OpenMP 'directive' directive +## Remarks + An unsupported value was passed to a clause. +## Example + The following sample generates C3022: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md index d0a4b21be80..dc55a9ee9eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md @@ -10,8 +10,12 @@ ms.assetid: 89dcce98-3cd7-4931-a50f-87df1d2ebc9b > 'value' : unexpected token encountered in argument to OpenMP 'clause' clause +## Remarks + The values passed to a clause were not valid. +## Example + The following sample generates C3023: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md index c906fc8ca20..33f5f906d85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md @@ -10,8 +10,12 @@ ms.assetid: 1c031c28-ce37-4de3-aead-cfe76b261856 > 'schedule(runtime)' : chunk_size expression is not allowed +## Remarks + A value cannot be passed to the run-time parameter of the schedule clause. +## Example + The following sample generates C3024: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md index 2f289eb5a32..7b7b1209762 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md @@ -10,6 +10,8 @@ ms.assetid: 4442f5a3-d9ea-4873-b1fb-e7e5bd3cbe5e > 'clause' : integral expression expected +## Remarks + A clause requires an integer expression but was given a noninteger expression. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md index a6465945175..e80366db2ff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md @@ -10,6 +10,8 @@ ms.assetid: 3297060e-cc5b-4600-a2db-09bfc4ffa21f > 'clause' : constant expression must be positive +## Remarks + A clause was passed an integer value, but the value was not a positive number. The number must be positive. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md index 1066399f1c8..be2f51da20b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md @@ -10,6 +10,8 @@ ms.assetid: 6562a5c2-2f28-4b36-91ca-2a64c0f0501a > 'clause' : arithmetic or pointer expression expected +## Remarks + A clause that requires an arithmetic or pointer expression was passed another kind of expression. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md index 9c18838cbdb..9ea3e8e09bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md @@ -10,8 +10,12 @@ ms.assetid: 175e697f-8e8f-492a-8456-6240ffbbb900 > 'member' : only a variable or static data member can be used in a data-sharing clause +## Remarks + A symbol other than a variable or static data member was passed to the reduction clause. +## Example + The following sample generates C3028: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md index 9b7d8632711..584966be5d9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md @@ -10,8 +10,12 @@ ms.assetid: 655eb04d-504a-468d-8c0c-bda1e5f297b7 > 'symbol' : can only appear once in data-sharing clauses in an OpenMP directive +## Remarks + A symbol was used more than once in one or more clauses in a directive. The symbol can only be used once in the directive. +## Example + The following sample generates C3029: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md index 5d197ced09d..c7adbe28082 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md @@ -10,8 +10,12 @@ ms.assetid: de92fd7e-29ba-46e8-b43b-f4b985cd74de > 'var' : variable in 'reduction' clause/directive cannot have reference type +## Remarks + You can only pass value parameters to certain clauses, such as the reduction clause. +## Example + The following sample generates C3030: ```cpp From b8f0ae746a348c8084fe9b5e13f8c95cf385d4a0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 23:34:40 +0800 Subject: [PATCH 0733/1799] Replace term "sample" with "example" for error references in range [C3011, C3030] --- .../compiler-errors-2/compiler-error-c3011.md | 2 +- .../compiler-errors-2/compiler-error-c3012.md | 2 +- .../compiler-errors-2/compiler-error-c3013.md | 2 +- .../compiler-errors-2/compiler-error-c3014.md | 2 +- .../compiler-errors-2/compiler-error-c3015.md | 2 +- .../compiler-errors-2/compiler-error-c3016.md | 2 +- .../compiler-errors-2/compiler-error-c3017.md | 2 +- .../compiler-errors-2/compiler-error-c3018.md | 2 +- .../compiler-errors-2/compiler-error-c3019.md | 2 +- .../compiler-errors-2/compiler-error-c3020.md | 6 +++--- .../compiler-errors-2/compiler-error-c3021.md | 2 +- .../compiler-errors-2/compiler-error-c3022.md | 2 +- .../compiler-errors-2/compiler-error-c3023.md | 2 +- .../compiler-errors-2/compiler-error-c3024.md | 2 +- .../compiler-errors-2/compiler-error-c3025.md | 2 +- .../compiler-errors-2/compiler-error-c3026.md | 2 +- .../compiler-errors-2/compiler-error-c3027.md | 2 +- .../compiler-errors-2/compiler-error-c3028.md | 2 +- .../compiler-errors-2/compiler-error-c3029.md | 2 +- .../compiler-errors-2/compiler-error-c3030.md | 2 +- 20 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md index 27ca8b1ad47..db0c349c4cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md @@ -16,7 +16,7 @@ An `omp` parallel region cannot contain inline assembly instructions. ## Example -The following sample generates C3011: +The following example generates C3011: ```cpp // C3011.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3012.md b/docs/error-messages/compiler-errors-2/compiler-error-c3012.md index c0e3ad5038a..2948a59c08c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3012.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3012.md @@ -16,7 +16,7 @@ A [compiler intrinsic](../../intrinsics/compiler-intrinsics.md) function is not ## Example -The following sample generates C3012, and shows one way to fix it: +The following example generates C3012, and shows one way to fix it: ```cpp // C3012.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md index 2c8d9745f1c..ecd9bae6569 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md @@ -16,7 +16,7 @@ A clause appeared twice on the same directive. Delete one occurrence of the clau ## Example -The following sample generates C3013: +The following example generates C3013: ```cpp // C3013.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md index 66db6d4d0a9..e245421fe56 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md @@ -16,7 +16,7 @@ It is an error for anything other than a **`for`** loop to immediately follow a ## Example -The following sample generates C3014: +The following example generates C3014: ```cpp // C3014.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md index 395e5bf21b9..a169793ab6d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md @@ -16,7 +16,7 @@ A **`for`** loop in an OpenMP statement must be fully and explicitly specified. ## Example -The following sample generates C3015: +The following example generates C3015: ```cpp // C3015.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md index eebec69cdea..b601657146f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md @@ -16,7 +16,7 @@ The index variable in an OpenMP **`for`** statement must be a signed integral ty ## Example -The following sample generates C3016: +The following example generates C3016: ```cpp // C3016.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md index cc236ebc241..54cc4adfc14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md @@ -16,7 +16,7 @@ A **`for`** loop in an OpenMP statement must be fully and explicitly specified. ## Example -The following sample generates C3017: +The following example generates C3017: ```cpp // C3017.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md index 7e0760e0317..6d90acaad62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md @@ -16,7 +16,7 @@ A **`for`** loop in an OpenMP statement must use the same variable for its test ## Example -The following sample generates C3018: +The following example generates C3018: ```cpp // C3018.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md index 5e26f0053ad..5fe82297864 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md @@ -16,7 +16,7 @@ The increment part of an OpenMP **`for`** loop must use the index variable both ## Example -The following sample generates C3019: +The following example generates C3019: ```cpp // C3019.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md index 4dd37d8ea96..300cdf6c831 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md @@ -16,7 +16,7 @@ An OpenMP **`for`** loop may not modify the index (loop counter) in the body of ## Examples -The following sample generates C3020: +The following example generates C3020: ```cpp // C3020.cpp @@ -37,7 +37,7 @@ int main() { A variable declared with [lastprivate](../../parallel/openmp/reference/openmp-clauses.md#lastprivate) cannot be used as the index inside a parallelized loop. -The following sample will give C3020 for the second lastprivate because that lastprivate will trigger a write to idx_a within the outermost for loop. The first lastprivate doesn't give an error because that lastprivate triggers a write to idx_a outside the outermost for loop (technically, at the very end of the last iteration). The following sample generates C3020. +The following example will give C3020 for the second lastprivate because that lastprivate will trigger a write to idx_a within the outermost for loop. The first lastprivate doesn't give an error because that lastprivate triggers a write to idx_a outside the outermost for loop (technically, at the very end of the last iteration). The following example generates C3020. ```cpp // C3020b.cpp @@ -56,7 +56,7 @@ void test(int first, int last) } ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3020c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md index 4ce78cd3f75..968c628c7ad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md @@ -16,7 +16,7 @@ An argument is required for an OpenMP directive. ## Example -The following sample generates C3021: +The following example generates C3021: ```cpp // C3021.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md index ca958d5229a..7c352d250d9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md @@ -16,7 +16,7 @@ An unsupported value was passed to a clause. ## Example -The following sample generates C3022: +The following example generates C3022: ```cpp // C3022.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md index dc55a9ee9eb..f99d1ac39e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md @@ -16,7 +16,7 @@ The values passed to a clause were not valid. ## Example -The following sample generates C3023: +The following example generates C3023: ```cpp // C3023.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md index 33f5f906d85..0f6864ed9c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md @@ -16,7 +16,7 @@ A value cannot be passed to the run-time parameter of the schedule clause. ## Example -The following sample generates C3024: +The following example generates C3024: ```cpp // C3024.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md index 7b7b1209762..619083a1f11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md @@ -16,7 +16,7 @@ A clause requires an integer expression but was given a noninteger expression. ## Example -The following sample generates C3025. +The following example generates C3025. ```cpp // C3025.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md index e80366db2ff..102e9ef052b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md @@ -16,7 +16,7 @@ A clause was passed an integer value, but the value was not a positive number. T ## Example -The following sample generates C3026: +The following example generates C3026: ```cpp // C3026.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md index be2f51da20b..3a36d706f33 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md @@ -16,7 +16,7 @@ A clause that requires an arithmetic or pointer expression was passed another ki ## Example -The following sample generates C3027: +The following example generates C3027: ```cpp // C3027.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md index 9ea3e8e09bc..953ff6ac405 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md @@ -16,7 +16,7 @@ A symbol other than a variable or static data member was passed to the reduction ## Example -The following sample generates C3028: +The following example generates C3028: ```cpp // C3028.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md index 584966be5d9..399a2bf04f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md @@ -16,7 +16,7 @@ A symbol was used more than once in one or more clauses in a directive. The symb ## Example -The following sample generates C3029: +The following example generates C3029: ```cpp // C3029.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md index c7adbe28082..2bb0c9c44f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md @@ -16,7 +16,7 @@ You can only pass value parameters to certain clauses, such as the reduction cla ## Example -The following sample generates C3030: +The following example generates C3030: ```cpp // C3030.cpp From 23617912fe18a23bc57bc5b9db1fe33220eaea7b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 12 Aug 2025 23:37:40 +0800 Subject: [PATCH 0734/1799] Update metadata for error references in range [C3011, C3030] --- .../error-messages/compiler-errors-2/compiler-error-c3011.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3012.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3013.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3014.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3015.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3016.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3017.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3018.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3019.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3020.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3021.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3022.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3023.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3024.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3025.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3026.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3027.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3028.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3029.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3030.md | 5 ++--- 20 files changed, 40 insertions(+), 60 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md index db0c349c4cf..65e8f9cd82b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3011" title: "Compiler Error C3011" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3011" +ms.date: 11/04/2016 f1_keywords: ["C3011"] helpviewer_keywords: ["C3011"] -ms.assetid: 24c3a917-ebff-4deb-9155-23adf6468531 --- # Compiler Error C3011 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3012.md b/docs/error-messages/compiler-errors-2/compiler-error-c3012.md index 2948a59c08c..e6abf61a319 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3012.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3012.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3012" title: "Compiler Error C3012" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3012" +ms.date: 11/04/2016 f1_keywords: ["C3012"] helpviewer_keywords: ["C3012"] -ms.assetid: cc7040b1-b3fb-4da6-a474-877914d30332 --- # Compiler Error C3012 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md index ecd9bae6569..744d28b348c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3013" title: "Compiler Error C3013" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3013" +ms.date: 11/04/2016 f1_keywords: ["C3013"] helpviewer_keywords: ["C3013"] -ms.assetid: f896777d-27e6-4b6d-baab-1567317f3374 --- # Compiler Error C3013 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md index e245421fe56..b57685ca12d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3014" title: "Compiler Error C3014" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3014" +ms.date: 11/04/2016 f1_keywords: ["C3014"] helpviewer_keywords: ["C3014"] -ms.assetid: af1c5b0c-dbf9-4274-b06a-c6c2cdcf2a52 --- # Compiler Error C3014 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md index a169793ab6d..57be2b65cd9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3015" title: "Compiler Error C3015" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3015" +ms.date: 11/04/2016 f1_keywords: ["C3015"] helpviewer_keywords: ["C3015"] -ms.assetid: d5e8e50b-7542-4b2d-8665-1b22072a5bc6 --- # Compiler Error C3015 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md index b601657146f..4da397545bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3016" title: "Compiler Error C3016" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3016" +ms.date: 11/04/2016 f1_keywords: ["C3016"] helpviewer_keywords: ["C3016"] -ms.assetid: 3423467e-e8bb-4f35-b4db-7925cafa74c1 --- # Compiler Error C3016 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md index 54cc4adfc14..5a9bcff8460 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3017" title: "Compiler Error C3017" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3017" +ms.date: 11/04/2016 f1_keywords: ["C3017"] helpviewer_keywords: ["C3017"] -ms.assetid: 12ab2c2a-d0d2-4900-9cbf-39be0af590dd --- # Compiler Error C3017 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md index 6d90acaad62..4dc33cbf6a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3018" title: "Compiler Error C3018" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3018" +ms.date: 11/04/2016 f1_keywords: ["C3018"] helpviewer_keywords: ["C3018"] -ms.assetid: 685be45f-f116-43a8-a88d-05ab6616e2f1 --- # Compiler Error C3018 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md index 5fe82297864..ad39fe669ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3019" title: "Compiler Error C3019" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3019" +ms.date: 11/04/2016 f1_keywords: ["C3019"] helpviewer_keywords: ["C3019"] -ms.assetid: 31a6d9b6-d29f-4499-9ad8-48dd751e87c7 --- # Compiler Error C3019 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md index 300cdf6c831..ca7e3d3f787 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3020" title: "Compiler Error C3020" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3020" +ms.date: 11/04/2016 f1_keywords: ["C3020"] helpviewer_keywords: ["C3020"] -ms.assetid: f625c7a3-afaa-4bd8-9c1b-51891b832f36 --- # Compiler Error C3020 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md index 968c628c7ad..c144f991470 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3021" title: "Compiler Error C3021" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3021" +ms.date: 11/04/2016 f1_keywords: ["C3021"] helpviewer_keywords: ["C3021"] -ms.assetid: 0cef6d97-e267-438a-ac8b-0daf5bbbc2cf --- # Compiler Error C3021 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md index 7c352d250d9..a833519ab11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3022" title: "Compiler Error C3022" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3022" +ms.date: 11/04/2016 f1_keywords: ["C3022"] helpviewer_keywords: ["C3022"] -ms.assetid: 9f1d444c-6c6e-48d9-9346-69128390aa33 --- # Compiler Error C3022 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md index f99d1ac39e7..76419763f3a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3023" title: "Compiler Error C3023" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3023" +ms.date: 11/04/2016 f1_keywords: ["C3023"] helpviewer_keywords: ["C3023"] -ms.assetid: 89dcce98-3cd7-4931-a50f-87df1d2ebc9b --- # Compiler Error C3023 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md index 0f6864ed9c9..4fd7152b8fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3024" title: "Compiler Error C3024" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3024" +ms.date: 11/04/2016 f1_keywords: ["C3024"] helpviewer_keywords: ["C3024"] -ms.assetid: 1c031c28-ce37-4de3-aead-cfe76b261856 --- # Compiler Error C3024 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md index 619083a1f11..5f8148aa80d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3025" title: "Compiler Error C3025" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3025" +ms.date: 11/04/2016 f1_keywords: ["C3025"] helpviewer_keywords: ["C3025"] -ms.assetid: 4442f5a3-d9ea-4873-b1fb-e7e5bd3cbe5e --- # Compiler Error C3025 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md index 102e9ef052b..458980db4a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3026" title: "Compiler Error C3026" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3026" +ms.date: 11/04/2016 f1_keywords: ["C3026"] helpviewer_keywords: ["C3026"] -ms.assetid: 3297060e-cc5b-4600-a2db-09bfc4ffa21f --- # Compiler Error C3026 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md index 3a36d706f33..853563e4b62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3027" title: "Compiler Error C3027" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3027" +ms.date: 11/04/2016 f1_keywords: ["C3027"] helpviewer_keywords: ["C3027"] -ms.assetid: 6562a5c2-2f28-4b36-91ca-2a64c0f0501a --- # Compiler Error C3027 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md index 953ff6ac405..c4a24a6afbe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3028" title: "Compiler Error C3028" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3028" +ms.date: 11/04/2016 f1_keywords: ["C3028"] helpviewer_keywords: ["C3028"] -ms.assetid: 175e697f-8e8f-492a-8456-6240ffbbb900 --- # Compiler Error C3028 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md index 399a2bf04f7..a92c60fda2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3029" title: "Compiler Error C3029" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3029" +ms.date: 11/04/2016 f1_keywords: ["C3029"] helpviewer_keywords: ["C3029"] -ms.assetid: 655eb04d-504a-468d-8c0c-bda1e5f297b7 --- # Compiler Error C3029 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md index 2bb0c9c44f7..96dde7dad6e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3030" title: "Compiler Error C3030" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3030" +ms.date: 11/04/2016 f1_keywords: ["C3030"] helpviewer_keywords: ["C3030"] -ms.assetid: de92fd7e-29ba-46e8-b43b-f4b985cd74de --- # Compiler Error C3030 From 277f4a2600fd368156d8b07acbff2ed0b5fd162a Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Tue, 12 Aug 2025 12:46:31 -0700 Subject: [PATCH 0735/1799] Use complete, conjugated sentences Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 996a29b8de0..5fe7b3aecc6 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -7,7 +7,10 @@ helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Add # AddressSanitizer Runtime Options -The following is a list of supported runtime options that can be set by the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function. Reference: [AddressSanitizer Runtime Options](./asan-runtime.md#runtime-options). While these mirror the options available in Clang's ASan, the description will differ by varying amounts in consideration of the MSVC ASan runtime. +The following is a list of supported actively supported options for the AddressSanitizer. They can be enabled through the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function, as described [here](/asan-runtime.md#runtime-options). + +> [!NOTE] +> These descriptions may vary from those found in Clang's ASan docs to account for MSVC specific behaviors. If you discover options that are inaccurately documented, we invite you to [report a bug](https://aka.ms/feedback/report?space=62). From 10f875711587627496c075696bf8e3e47cb8afc4 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Tue, 12 Aug 2025 12:47:22 -0700 Subject: [PATCH 0736/1799] Update docs/sanitizers/asan-flags.md To fit acrolynx tone and typo preferences. Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 5fe7b3aecc6..2898327f81a 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -12,7 +12,8 @@ The following is a list of supported actively supported options for the AddressS > [!NOTE] > These descriptions may vary from those found in Clang's ASan docs to account for MSVC specific behaviors. -If you discover options that are inaccurately documented, we invite you to [report a bug](https://aka.ms/feedback/report?space=62). +If you discover documentation errors, report them [here](https://aka.ms/feedback/report?space=62). + | Flag | Default value | Description | |------|---------------|-------------| From f6c0f6b755d5af6e43d985a0e0c80c2a375e1f50 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Tue, 12 Aug 2025 12:49:30 -0700 Subject: [PATCH 0737/1799] Update docs/sanitizers/asan-runtime.md Co-authored-by: David Justo --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index a4daaa517b7..777d3e2be46 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -101,7 +101,7 @@ For an illustration of the alignment requirement and potential issues, see the p ## Runtime options -The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most of Clang's ASan runtime options available in MSVC as well. [A complete list of runtime options we support is available here](./asan-flags.md). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). +The MSVC AddressSanitizer is a regularly synced fork of the [Clang AddressSanitizer runtime](https://github.com/llvm/llvm-project). As a result, MSVC implicitly inherits many Clang's ASan runtime options. A complete list of options that we actively maintain and test can be found [here](./asan-flags.md). If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). ### Configure runtime options From 159a75a38f86c1808a8c3d40863f8a2bca3911bb Mon Sep 17 00:00:00 2001 From: Amy Wishnousky Date: Tue, 12 Aug 2025 16:27:52 -0700 Subject: [PATCH 0738/1799] ASAN thunks require /wholearchive The docs do not mention the requirement for /wholearchive when using /INFERASANLIBS:NO. --- docs/sanitizers/asan-building.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/sanitizers/asan-building.md b/docs/sanitizers/asan-building.md index 003492cbbbc..9c7f0db25b3 100644 --- a/docs/sanitizers/asan-building.md +++ b/docs/sanitizers/asan-building.md @@ -128,10 +128,10 @@ The **`/fsanitize=address`** compiler option marks objects to specify which Addr | CRT option | AddressSanitizer runtime library (.lib) | Address runtime binary (.dll) |--|--|--| -| `/MT` or `/MTd` | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_static_runtime_thunk-{arch}`* | *`clang_rt.asan_dynamic-{arch}`* -| `/MD` or `/MDd` | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_dynamic_runtime_thunk-{arch}`* | *`clang_rt.asan_dynamic-{arch}`* +| `/MT` or `/MTd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_static_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* +| `/MD` or `/MDd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_dynamic_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* -The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) prevents the linker from linking a *`clang_rt.asan*`* library file from the default location. Add the library path in your build scripts if you use this option. Otherwise, the linker reports an unresolved external symbol error. +The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) prevents the linker from linking a *`clang_rt.asan*`* library file from the default location. Add the library path in your build scripts if you use this option. Otherwise, the linker reports an unresolved external symbol error. Note that the runtime thunk lib **must** be linked with `/wholearchive` option applied. **Previous Versions** @@ -140,12 +140,12 @@ Prior to Visual Studio 17.7 Preview 3, statically linked (**`/MT`** or **`/MTd`* | CRT runtime option | DLL or EXE | AddressSanitizer runtime libraries | |--|--|--| -| **`/MT`** | EXE | *`clang_rt.asan-{arch}`*, *`clang_rt.asan_cxx-{arch}`* | -| **`/MT`** | DLL | *`clang_rt.asan_dll_thunk-{arch}`* | -| **`/MD`** | Either | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_dynamic_runtime_thunk-{arch}`* | -| **`/MTd`** | EXE | *`clang_rt.asan_dbg-{arch}`*, *`clang_rt.asan_dbg_cxx-{arch}`* | -| **`/MTd`** | DLL | *`clang_rt.asan_dbg_dll_thunk-{arch}`* | -| **`/MDd`** | Either | *`clang_rt.asan_dbg_dynamic-{arch}`*, *`clang_rt.asan_dbg_dynamic_runtime_thunk-{arch}`* | +| **`/MT`** | EXE | *`/wholearchive:clang_rt.asan-{arch}.lib`*, *`clang_rt.asan_cxx-{arch}.lib`* | +| **`/MT`** | DLL | *`/wholearchive:clang_rt.asan_dll_thunk-{arch}.lib`* | +| **`/MD`** | Either | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_dynamic_runtime_thunk-{arch}.lib`* | +| **`/MTd`** | EXE | *`/wholearchive:clang_rt.asan_dbg-{arch}.lib`*, *`clang_rt.asan_cxx_dbg-{arch}.lib`* | +| **`/MTd`** | DLL | *`/wholearchive:clang_rt.asan_dbg_dll_thunk-{arch}.lib`* | +| **`/MDd`** | Either | *`/wholearchive:clang_rt.asan_dbg_dynamic-{arch}.lib`*, *`clang_rt.asan_dbg_dynamic_runtime_thunk-{arch}.lib`* | ## Visual Studio integration From 90cb1794d587c9c74783d42eddae11c0c160c18d Mon Sep 17 00:00:00 2001 From: Amy Wishnousky Date: Tue, 12 Aug 2025 16:31:01 -0700 Subject: [PATCH 0739/1799] lib -> libraries --- docs/sanitizers/asan-building.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-building.md b/docs/sanitizers/asan-building.md index 9c7f0db25b3..cbeba6747dc 100644 --- a/docs/sanitizers/asan-building.md +++ b/docs/sanitizers/asan-building.md @@ -131,7 +131,7 @@ The **`/fsanitize=address`** compiler option marks objects to specify which Addr | `/MT` or `/MTd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_static_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* | `/MD` or `/MDd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_dynamic_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* -The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) prevents the linker from linking a *`clang_rt.asan*`* library file from the default location. Add the library path in your build scripts if you use this option. Otherwise, the linker reports an unresolved external symbol error. Note that the runtime thunk lib **must** be linked with `/wholearchive` option applied. +The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) prevents the linker from linking a *`clang_rt.asan*`* library file from the default location. Add the library path in your build scripts if you use this option. Otherwise, the linker reports an unresolved external symbol error. Note that the runtime thunk libraries **must** be linked with `/wholearchive` option applied. **Previous Versions** From 816ede4354470e69802b1be7ccc8d13c156c2888 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 16:47:41 +0800 Subject: [PATCH 0740/1799] Add blockquotes for error messages in range [C3031, C3050] --- docs/error-messages/compiler-errors-2/compiler-error-c3031.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3032.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3033.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3034.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3035.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3036.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3037.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3038.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3039.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3040.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3041.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3042.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3043.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3044.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3045.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3046.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3048.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3049.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3050.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md index ad1689a82f3..27d239f9ac0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md @@ -8,7 +8,7 @@ ms.assetid: 7e621e7e-eda7-45b5-8836-29599cd05255 --- # Compiler Error C3031 -'var' : variable in 'reduction' clause must have scalar arithmetic type +> 'var' : variable in 'reduction' clause must have scalar arithmetic type A variable of the wrong type was passed to a reduction clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md index 0feba15df8c..61a2bf51418 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md @@ -8,7 +8,7 @@ ms.assetid: 6a92bd8e-319f-4a99-aef4-a9021f6f9928 --- # Compiler Error C3032 -'var' : variable in 'clause' clause cannot have incomplete type 'type' +> 'var' : variable in 'clause' clause cannot have incomplete type 'type' Types passed to certain clauses must be fully visible to the compiler. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md index b1dcebc9f78..1489b9c279d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md @@ -8,7 +8,7 @@ ms.assetid: 8628b6bb-a650-4ed2-af13-57acd2f7ddbb --- # Compiler Error C3033 -'var' : variable in 'clause' clause cannot have const-qualified type +> 'var' : variable in 'clause' clause cannot have const-qualified type Values passed to certain clauses cannot be **`const`** variables. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md index c6581ba1b3e..d4ca292fa62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md @@ -8,7 +8,7 @@ ms.assetid: 49db8bac-2720-4622-94e3-7988f1603fa3 --- # Compiler Error C3034 -OpenMP 'directive1' directive cannot be directly nested within 'directive2' directive +> OpenMP 'directive1' directive cannot be directly nested within 'directive2' directive Some directives cannot be nested. To fix this error, you can merge the statements of both directives into the block of one directive, or you can construct consecutive directives. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md index 3fcf1e25f17..3fb792d4cb6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md @@ -8,7 +8,7 @@ ms.assetid: af34fad2-2b45-42d0-a9ff-04eab3e91c37 --- # Compiler Error C3035 -OpenMP 'ordered' directive must bind directly to a 'for' or 'parallel for' directive with the 'ordered' clause +> OpenMP 'ordered' directive must bind directly to a 'for' or 'parallel for' directive with the 'ordered' clause An ordered clause was ill formed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md index 597adf0ff4f..a40d27cd1ec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md @@ -8,7 +8,7 @@ ms.assetid: 10c6993e-bc42-4a07-85c7-cdc34ac30906 --- # Compiler Error C3036 -'operator' : invalid operator token in OpenMP 'reduction' clause +> 'operator' : invalid operator token in OpenMP 'reduction' clause A [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause was not specified correctly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md index 13cb9a96f50..70b63b40c4d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md @@ -8,7 +8,7 @@ ms.assetid: 9ba8a890-d3c7-4cce-93c5-d358e2bfad28 --- # Compiler Error C3037 -'var' : variable in 'reduction' clause must be shared in enclosing context +> 'var' : variable in 'reduction' clause must be shared in enclosing context A variable specified in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause may not be private to each thread in the context. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md index 1219fcdd1e3..9740f9aac41 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md @@ -8,7 +8,7 @@ ms.assetid: 140ada3e-5636-43ef-a4ee-22a9f66a771f --- # Compiler Error C3038 -'var' : variable in 'private' clause cannot be a reduction variable in enclosing context +> 'var' : variable in 'private' clause cannot be a reduction variable in enclosing context Variables that appear in the [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause of a parallel directive cannot be specified in a [private](../../parallel/openmp/reference/openmp-clauses.md#private-openmp) clause on a work-sharing directive that binds to the parallel construct. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md index c5029592752..a391e8b3ef7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md @@ -8,7 +8,7 @@ ms.assetid: 02776f16-f57a-4ffd-b7f7-9c696b633e08 --- # Compiler Error C3039 -'var' : index variable in OpenMP 'for' statement cannot be a reduction variable +> 'var' : index variable in OpenMP 'for' statement cannot be a reduction variable An index variable is implicitly private, so the variable cannot be used in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause in the enclosing [parallel](../../parallel/openmp/reference/openmp-directives.md#parallel) directive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md index 33c117e5f43..c11aff1ad67 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md @@ -8,7 +8,7 @@ ms.assetid: 29e857ac-74f0-4ec6-becf-9026e38c160e --- # Compiler Error C3040 -'var' : type of variable in 'reduction' clause is incompatible with reduction operator 'operator' +> 'var' : type of variable in 'reduction' clause is incompatible with reduction operator 'operator' A variable in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause cannot be used with the reduction operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md index fb2a1a285d7..4869e907cfd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md @@ -8,7 +8,7 @@ ms.assetid: 9df1ae44-3ac7-4c6c-899f-f35ffe7ccf0d --- # Compiler Error C3041 -'var' : variable in 'copyprivate' clause must be private in enclosing context +> 'var' : variable in 'copyprivate' clause must be private in enclosing context A variable passed to [copyprivate](../../parallel/openmp/reference/openmp-clauses.md#copyprivate) cannot be shared in the enclosing context. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md index ba13716ff03..d3b8f8055d3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md @@ -8,7 +8,7 @@ ms.assetid: bf73f61e-5bd2-40a8-9b06-6244e6a15a41 --- # Compiler Error C3042 -'copyprivate' and 'nowait' clauses cannot appear together on OpenMP 'directive' directive +> 'copyprivate' and 'nowait' clauses cannot appear together on OpenMP 'directive' directive The [copyprivate](../../parallel/openmp/reference/openmp-clauses.md#copyprivate) and [nowait](../../parallel/openmp/reference/openmp-clauses.md#nowait) clauses are mutually exclusive on the specified directive. To fix this error, remove one or both of the `copyprivate` or `nowait` clauses. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md index 2e2a807aa5e..ca41588339d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md @@ -8,7 +8,7 @@ ms.assetid: 0ef55e63-e82b-48eb-9d44-690950ac34c6 --- # Compiler Error C3043 -OpenMP 'critical' directive cannot be nested in 'critical' directive with same name +> OpenMP 'critical' directive cannot be nested in 'critical' directive with same name A [critical](../../parallel/openmp/reference/openmp-directives.md#critical) directive cannot be nested in a `critical` directive that uses the same name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md index 26b146188d2..b8b4f0711c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md @@ -8,7 +8,7 @@ ms.assetid: 9f3e25b2-4676-49ab-97bf-6c88cd0fa377 --- # Compiler Error C3044 -'section' : only allowed directly nested under an OpenMP 'sections' directive +> 'section' : only allowed directly nested under an OpenMP 'sections' directive The compiler found a `section` directive was used incorrectly. For more information, see [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md index 67891c401ee..8cf45bdbc54 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md @@ -8,7 +8,7 @@ ms.assetid: 9351ba3e-3d3f-455f-ac90-a810fa9fd947 --- # Compiler Error C3045 -Expected a compound statement following OpenMP 'sections' directive. Missing '{' +> Expected a compound statement following OpenMP 'sections' directive. Missing '{' A code block delimited by braces must follow a [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp) directive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md index da74cf83c76..79f872c5a6d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md @@ -8,7 +8,7 @@ ms.assetid: 2e53d835-faa1-4ec0-9807-41f3dc552635 --- # Compiler Error C3046 -Missing structured block in an OpenMP '#pragma omp sections' region +> Missing structured block in an OpenMP '#pragma omp sections' region A [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp) directive has an empty code block. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md index 62ceeb6d4e4..09f8b66c30a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md @@ -8,7 +8,7 @@ ms.assetid: 48e07091-94d9-471d-befe-7e2507631edd --- # Compiler Error C3048 -Expression following '#pragma omp atomic' has improper form +> Expression following '#pragma omp atomic' has improper form An atomic directive was incorrectly specified. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md index 3b87b0f3746..8930091c500 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md @@ -8,7 +8,7 @@ ms.assetid: 6ddf54f6-2c30-4d04-b637-98c6c922c533 --- # Compiler Error C3049 -'arg' : invalid argument in OpenMP 'default' clause +> 'arg' : invalid argument in OpenMP 'default' clause An incorrect value was passed to a [default](../../parallel/openmp/reference/openmp-clauses.md#default-openmp) clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md index 95167d41bce..594d824bf58 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md @@ -8,7 +8,7 @@ ms.assetid: ee090a0b-29cc-4215-a2f9-d82af79b8e82 --- # Compiler Error C3050 -'type1' : a ref class cannot inherit from 'type1' +> 'type1' : a ref class cannot inherit from 'type1' `System::ValueType` cannot be a base class for a reference type. From fc24cb31d19d50b1feea630fa384c134c7930bf3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 16:52:24 +0800 Subject: [PATCH 0741/1799] Add "Remarks" and "Example" headings for error references in range [C3031, C3050] --- docs/error-messages/compiler-errors-2/compiler-error-c3031.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3032.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3033.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3034.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3035.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3036.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3037.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3038.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3039.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3040.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3041.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3042.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3043.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3044.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3045.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3046.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3047.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3048.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3049.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3050.md | 4 ++++ 20 files changed, 78 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md index 27d239f9ac0..8c446168730 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md @@ -10,8 +10,12 @@ ms.assetid: 7e621e7e-eda7-45b5-8836-29599cd05255 > 'var' : variable in 'reduction' clause must have scalar arithmetic type +## Remarks + A variable of the wrong type was passed to a reduction clause. +## Example + The following sample generates C3031: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md index 61a2bf51418..4dd33c98458 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md @@ -10,8 +10,12 @@ ms.assetid: 6a92bd8e-319f-4a99-aef4-a9021f6f9928 > 'var' : variable in 'clause' clause cannot have incomplete type 'type' +## Remarks + Types passed to certain clauses must be fully visible to the compiler. +## Example + The following sample generates C3032: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md index 1489b9c279d..21535cd2211 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md @@ -10,8 +10,12 @@ ms.assetid: 8628b6bb-a650-4ed2-af13-57acd2f7ddbb > 'var' : variable in 'clause' clause cannot have const-qualified type +## Remarks + Values passed to certain clauses cannot be **`const`** variables. +## Example + The following sample generates C3033: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md index d4ca292fa62..ea58959910d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md @@ -10,8 +10,12 @@ ms.assetid: 49db8bac-2720-4622-94e3-7988f1603fa3 > OpenMP 'directive1' directive cannot be directly nested within 'directive2' directive +## Remarks + Some directives cannot be nested. To fix this error, you can merge the statements of both directives into the block of one directive, or you can construct consecutive directives. +## Example + The following sample generates C3034: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md index 3fb792d4cb6..e5a6e612b3f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md @@ -10,8 +10,12 @@ ms.assetid: af34fad2-2b45-42d0-a9ff-04eab3e91c37 > OpenMP 'ordered' directive must bind directly to a 'for' or 'parallel for' directive with the 'ordered' clause +## Remarks + An ordered clause was ill formed. +## Example + The following sample generates C3035: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md index a40d27cd1ec..eb4d9dab508 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md @@ -10,8 +10,12 @@ ms.assetid: 10c6993e-bc42-4a07-85c7-cdc34ac30906 > 'operator' : invalid operator token in OpenMP 'reduction' clause +## Remarks + A [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause was not specified correctly. +## Example + The following sample generates C3036: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md index 70b63b40c4d..bb520c38d8d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md @@ -10,8 +10,12 @@ ms.assetid: 9ba8a890-d3c7-4cce-93c5-d358e2bfad28 > 'var' : variable in 'reduction' clause must be shared in enclosing context +## Remarks + A variable specified in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause may not be private to each thread in the context. +## Example + The following sample generates C3037: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md index 9740f9aac41..f35af110b43 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md @@ -10,8 +10,12 @@ ms.assetid: 140ada3e-5636-43ef-a4ee-22a9f66a771f > 'var' : variable in 'private' clause cannot be a reduction variable in enclosing context +## Remarks + Variables that appear in the [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause of a parallel directive cannot be specified in a [private](../../parallel/openmp/reference/openmp-clauses.md#private-openmp) clause on a work-sharing directive that binds to the parallel construct. +## Example + The following sample generates C3038: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md index a391e8b3ef7..75733d3337f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md @@ -10,6 +10,8 @@ ms.assetid: 02776f16-f57a-4ffd-b7f7-9c696b633e08 > 'var' : index variable in OpenMP 'for' statement cannot be a reduction variable +## Remarks + An index variable is implicitly private, so the variable cannot be used in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause in the enclosing [parallel](../../parallel/openmp/reference/openmp-directives.md#parallel) directive. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md index c11aff1ad67..011bc913f54 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md @@ -10,8 +10,12 @@ ms.assetid: 29e857ac-74f0-4ec6-becf-9026e38c160e > 'var' : type of variable in 'reduction' clause is incompatible with reduction operator 'operator' +## Remarks + A variable in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause cannot be used with the reduction operator. +## Example + The following sample generates C3040: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md index 4869e907cfd..088d53e7be2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md @@ -10,8 +10,12 @@ ms.assetid: 9df1ae44-3ac7-4c6c-899f-f35ffe7ccf0d > 'var' : variable in 'copyprivate' clause must be private in enclosing context +## Remarks + A variable passed to [copyprivate](../../parallel/openmp/reference/openmp-clauses.md#copyprivate) cannot be shared in the enclosing context. +## Example + The following sample generates C3041: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md index d3b8f8055d3..f992ea09aac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md @@ -10,8 +10,12 @@ ms.assetid: bf73f61e-5bd2-40a8-9b06-6244e6a15a41 > 'copyprivate' and 'nowait' clauses cannot appear together on OpenMP 'directive' directive +## Remarks + The [copyprivate](../../parallel/openmp/reference/openmp-clauses.md#copyprivate) and [nowait](../../parallel/openmp/reference/openmp-clauses.md#nowait) clauses are mutually exclusive on the specified directive. To fix this error, remove one or both of the `copyprivate` or `nowait` clauses. +## Example + The following sample generates C3042: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md index ca41588339d..08592abebe2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md @@ -10,8 +10,12 @@ ms.assetid: 0ef55e63-e82b-48eb-9d44-690950ac34c6 > OpenMP 'critical' directive cannot be nested in 'critical' directive with same name +## Remarks + A [critical](../../parallel/openmp/reference/openmp-directives.md#critical) directive cannot be nested in a `critical` directive that uses the same name. +## Example + The following sample generates C3043: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md index b8b4f0711c0..82268cff9b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md @@ -10,8 +10,12 @@ ms.assetid: 9f3e25b2-4676-49ab-97bf-6c88cd0fa377 > 'section' : only allowed directly nested under an OpenMP 'sections' directive +## Remarks + The compiler found a `section` directive was used incorrectly. For more information, see [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp). +## Example + The following sample generates C3044: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md index 8cf45bdbc54..7020dbbdc89 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md @@ -10,8 +10,12 @@ ms.assetid: 9351ba3e-3d3f-455f-ac90-a810fa9fd947 > Expected a compound statement following OpenMP 'sections' directive. Missing '{' +## Remarks + A code block delimited by braces must follow a [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp) directive. +## Example + The following sample generates C3045: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md index 79f872c5a6d..16708bcf653 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md @@ -10,8 +10,12 @@ ms.assetid: 2e53d835-faa1-4ec0-9807-41f3dc552635 > Missing structured block in an OpenMP '#pragma omp sections' region +## Remarks + A [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp) directive has an empty code block. +## Example + The following sample generates C3046: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3047.md b/docs/error-messages/compiler-errors-2/compiler-error-c3047.md index 33412373c1d..9de9014520e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3047.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3047.md @@ -10,10 +10,14 @@ ms.assetid: 91c14566-5958-433d-8549-0e8bc3196f76 > Structured block in an OpenMP 'sections' region must be preceded by '#pragma omp section' +## Remarks + Any code in a code block introduced by a [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp) directive must be in a code block introduced by a `section` directive. This error is obsolete in Visual Studio 2022 and later versions. +## Example + The following sample generates C3047: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md index 09f8b66c30a..eac6513ce72 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md @@ -10,8 +10,12 @@ ms.assetid: 48e07091-94d9-471d-befe-7e2507631edd > Expression following '#pragma omp atomic' has improper form +## Remarks + An atomic directive was incorrectly specified. +## Example + The following sample generates C3048: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md index 8930091c500..ca624c76e26 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md @@ -10,8 +10,12 @@ ms.assetid: 6ddf54f6-2c30-4d04-b637-98c6c922c533 > 'arg' : invalid argument in OpenMP 'default' clause +## Remarks + An incorrect value was passed to a [default](../../parallel/openmp/reference/openmp-clauses.md#default-openmp) clause. +## Example + The following sample generates C3049: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md index 594d824bf58..728b29f20e5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md @@ -10,8 +10,12 @@ ms.assetid: ee090a0b-29cc-4215-a2f9-d82af79b8e82 > 'type1' : a ref class cannot inherit from 'type1' +## Remarks + `System::ValueType` cannot be a base class for a reference type. +## Example + The following sample generates C3050: ```cpp From 02b89f813c70b358595dfaf3d13571a3bf406bb6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 16:54:16 +0800 Subject: [PATCH 0742/1799] Replace term "sample" with "example" for error references in range [C3031, C3050] --- docs/error-messages/compiler-errors-2/compiler-error-c3031.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3032.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3033.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3034.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3035.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3036.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3037.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3038.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3039.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3040.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3041.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3042.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3043.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3044.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3045.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3046.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3047.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3048.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3049.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3050.md | 2 +- 20 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md index 8c446168730..bd2e91f261f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md @@ -16,7 +16,7 @@ A variable of the wrong type was passed to a reduction clause. ## Example -The following sample generates C3031: +The following example generates C3031: ```cpp // C3031.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md index 4dd33c98458..6388cbb4d70 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md @@ -16,7 +16,7 @@ Types passed to certain clauses must be fully visible to the compiler. ## Example -The following sample generates C3032: +The following example generates C3032: ```cpp // C3032.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md index 21535cd2211..37eabbaf92c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md @@ -16,7 +16,7 @@ Values passed to certain clauses cannot be **`const`** variables. ## Example -The following sample generates C3033: +The following example generates C3033: ```cpp // C3033.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md index ea58959910d..1fbefb86798 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md @@ -16,7 +16,7 @@ Some directives cannot be nested. To fix this error, you can merge the statement ## Example -The following sample generates C3034: +The following example generates C3034: ```cpp // C3034.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md index e5a6e612b3f..5863421056b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md @@ -16,7 +16,7 @@ An ordered clause was ill formed. ## Example -The following sample generates C3035: +The following example generates C3035: ```cpp // C3035.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md index eb4d9dab508..0bc004c00ae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md @@ -16,7 +16,7 @@ A [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) claus ## Example -The following sample generates C3036: +The following example generates C3036: ```cpp // C3036.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md index bb520c38d8d..d93499354fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md @@ -16,7 +16,7 @@ A variable specified in a [reduction](../../parallel/openmp/reference/openmp-cla ## Example -The following sample generates C3037: +The following example generates C3037: ```cpp // C3037.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md index f35af110b43..dab32872b3d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md @@ -16,7 +16,7 @@ Variables that appear in the [reduction](../../parallel/openmp/reference/openmp- ## Example -The following sample generates C3038: +The following example generates C3038: ```cpp // C3038.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md index 75733d3337f..624e5c47788 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md @@ -16,7 +16,7 @@ An index variable is implicitly private, so the variable cannot be used in a [re ## Example -The following sample generates C3039: +The following example generates C3039: ```cpp // C3039.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md index 011bc913f54..858f23098d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md @@ -16,7 +16,7 @@ A variable in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#re ## Example -The following sample generates C3040: +The following example generates C3040: ```cpp // C3040.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md index 088d53e7be2..bc27f2f2227 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md @@ -16,7 +16,7 @@ A variable passed to [copyprivate](../../parallel/openmp/reference/openmp-clause ## Example -The following sample generates C3041: +The following example generates C3041: ```cpp // C3041.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md index f992ea09aac..b59a4166856 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md @@ -16,7 +16,7 @@ The [copyprivate](../../parallel/openmp/reference/openmp-clauses.md#copyprivate) ## Example -The following sample generates C3042: +The following example generates C3042: ```cpp // C3042.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md index 08592abebe2..b5b206b7a7a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md @@ -16,7 +16,7 @@ A [critical](../../parallel/openmp/reference/openmp-directives.md#critical) dire ## Example -The following sample generates C3043: +The following example generates C3043: ```cpp // C3043.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md index 82268cff9b0..2df140511b1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md @@ -16,7 +16,7 @@ The compiler found a `section` directive was used incorrectly. For more informat ## Example -The following sample generates C3044: +The following example generates C3044: ```cpp // C3044.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md index 7020dbbdc89..81bad5f022f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md @@ -16,7 +16,7 @@ A code block delimited by braces must follow a [sections](../../parallel/openmp/ ## Example -The following sample generates C3045: +The following example generates C3045: ```cpp // C3045.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md index 16708bcf653..d755e2527b1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md @@ -16,7 +16,7 @@ A [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openm ## Example -The following sample generates C3046: +The following example generates C3046: ```cpp // C3046.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3047.md b/docs/error-messages/compiler-errors-2/compiler-error-c3047.md index 9de9014520e..992895ee810 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3047.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3047.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Example -The following sample generates C3047: +The following example generates C3047: ```cpp // C3047.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md index eac6513ce72..2f593cc561b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md @@ -16,7 +16,7 @@ An atomic directive was incorrectly specified. ## Example -The following sample generates C3048: +The following example generates C3048: ```cpp // C3048.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md index ca624c76e26..3eb75bd1f54 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md @@ -16,7 +16,7 @@ An incorrect value was passed to a [default](../../parallel/openmp/reference/ope ## Example -The following sample generates C3049: +The following example generates C3049: ```cpp // C3049.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md index 728b29f20e5..6cb25a546b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md @@ -16,7 +16,7 @@ ms.assetid: ee090a0b-29cc-4215-a2f9-d82af79b8e82 ## Example -The following sample generates C3050: +The following example generates C3050: ```cpp // C3050.cpp From e879c5d692555530d088e1d5ed80960986b121f9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 16:57:09 +0800 Subject: [PATCH 0743/1799] Update metadata for error references in range [C3031, C3050] --- .../error-messages/compiler-errors-2/compiler-error-c3031.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3032.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3033.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3034.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3035.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3036.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3037.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3038.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3039.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3040.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3041.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3042.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3043.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3044.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3045.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3046.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3047.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c3048.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3049.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3050.md | 5 ++--- 20 files changed, 39 insertions(+), 59 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md index bd2e91f261f..583e25e206f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3031" title: "Compiler Error C3031" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3031" +ms.date: 11/04/2016 f1_keywords: ["C3031"] helpviewer_keywords: ["C3031"] -ms.assetid: 7e621e7e-eda7-45b5-8836-29599cd05255 --- # Compiler Error C3031 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md index 6388cbb4d70..02ada4cb731 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3032" title: "Compiler Error C3032" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3032" +ms.date: 11/04/2016 f1_keywords: ["C3032"] helpviewer_keywords: ["C3032"] -ms.assetid: 6a92bd8e-319f-4a99-aef4-a9021f6f9928 --- # Compiler Error C3032 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md index 37eabbaf92c..420ba6376bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3033" title: "Compiler Error C3033" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3033" +ms.date: 11/04/2016 f1_keywords: ["C3033"] helpviewer_keywords: ["C3033"] -ms.assetid: 8628b6bb-a650-4ed2-af13-57acd2f7ddbb --- # Compiler Error C3033 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md index 1fbefb86798..9d76496fe4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3034" title: "Compiler Error C3034" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3034" +ms.date: 11/04/2016 f1_keywords: ["C3034"] helpviewer_keywords: ["C3034"] -ms.assetid: 49db8bac-2720-4622-94e3-7988f1603fa3 --- # Compiler Error C3034 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md index 5863421056b..fd2006a31d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3035" title: "Compiler Error C3035" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3035" +ms.date: 11/04/2016 f1_keywords: ["C3035"] helpviewer_keywords: ["C3035"] -ms.assetid: af34fad2-2b45-42d0-a9ff-04eab3e91c37 --- # Compiler Error C3035 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md index 0bc004c00ae..0584a878e54 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3036" title: "Compiler Error C3036" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3036" +ms.date: 11/04/2016 f1_keywords: ["C3036"] helpviewer_keywords: ["C3036"] -ms.assetid: 10c6993e-bc42-4a07-85c7-cdc34ac30906 --- # Compiler Error C3036 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md index d93499354fb..fce1f7b9649 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3037" title: "Compiler Error C3037" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3037" +ms.date: 11/04/2016 f1_keywords: ["C3037"] helpviewer_keywords: ["C3037"] -ms.assetid: 9ba8a890-d3c7-4cce-93c5-d358e2bfad28 --- # Compiler Error C3037 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md index dab32872b3d..9819029d531 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3038" title: "Compiler Error C3038" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3038" +ms.date: 11/04/2016 f1_keywords: ["C3038"] helpviewer_keywords: ["C3038"] -ms.assetid: 140ada3e-5636-43ef-a4ee-22a9f66a771f --- # Compiler Error C3038 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md index 624e5c47788..92bc1abf4be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3039" title: "Compiler Error C3039" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3039" +ms.date: 11/04/2016 f1_keywords: ["C3039"] helpviewer_keywords: ["C3039"] -ms.assetid: 02776f16-f57a-4ffd-b7f7-9c696b633e08 --- # Compiler Error C3039 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md index 858f23098d7..82f04a80bcd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3040" title: "Compiler Error C3040" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3040" +ms.date: 11/04/2016 f1_keywords: ["C3040"] helpviewer_keywords: ["C3040"] -ms.assetid: 29e857ac-74f0-4ec6-becf-9026e38c160e --- # Compiler Error C3040 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md index bc27f2f2227..5c60eb3ff1a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3041" title: "Compiler Error C3041" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3041" +ms.date: 11/04/2016 f1_keywords: ["C3041"] helpviewer_keywords: ["C3041"] -ms.assetid: 9df1ae44-3ac7-4c6c-899f-f35ffe7ccf0d --- # Compiler Error C3041 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md index b59a4166856..8b52b9ae987 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3042" title: "Compiler Error C3042" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3042" +ms.date: 11/04/2016 f1_keywords: ["C3042"] helpviewer_keywords: ["C3042"] -ms.assetid: bf73f61e-5bd2-40a8-9b06-6244e6a15a41 --- # Compiler Error C3042 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md index b5b206b7a7a..ceb6883d661 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3043" title: "Compiler Error C3043" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3043" +ms.date: 11/04/2016 f1_keywords: ["C3043"] helpviewer_keywords: ["C3043"] -ms.assetid: 0ef55e63-e82b-48eb-9d44-690950ac34c6 --- # Compiler Error C3043 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md index 2df140511b1..ae3ed18c230 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3044" title: "Compiler Error C3044" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3044" +ms.date: 11/04/2016 f1_keywords: ["C3044"] helpviewer_keywords: ["C3044"] -ms.assetid: 9f3e25b2-4676-49ab-97bf-6c88cd0fa377 --- # Compiler Error C3044 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md index 81bad5f022f..6c59aff18d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3045" title: "Compiler Error C3045" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3045" +ms.date: 11/04/2016 f1_keywords: ["C3045"] helpviewer_keywords: ["C3045"] -ms.assetid: 9351ba3e-3d3f-455f-ac90-a810fa9fd947 --- # Compiler Error C3045 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md index d755e2527b1..3633da04abd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3046" title: "Compiler Error C3046" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3046" +ms.date: 11/04/2016 f1_keywords: ["C3046"] helpviewer_keywords: ["C3046"] -ms.assetid: 2e53d835-faa1-4ec0-9807-41f3dc552635 --- # Compiler Error C3046 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3047.md b/docs/error-messages/compiler-errors-2/compiler-error-c3047.md index 992895ee810..850e45397bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3047.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3047.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3047" title: "Compiler Error C3047" +description: "Learn more about: Compiler Error C3047" ms.date: 06/01/2022 f1_keywords: ["C3047"] helpviewer_keywords: ["C3047"] -ms.assetid: 91c14566-5958-433d-8549-0e8bc3196f76 --- # Compiler Error C3047 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md index 2f593cc561b..20c553cc781 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3048" title: "Compiler Error C3048" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3048" +ms.date: 11/04/2016 f1_keywords: ["C3048"] helpviewer_keywords: ["C3048"] -ms.assetid: 48e07091-94d9-471d-befe-7e2507631edd --- # Compiler Error C3048 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md index 3eb75bd1f54..b89c25bb6dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3049" title: "Compiler Error C3049" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3049" +ms.date: 11/04/2016 f1_keywords: ["C3049"] helpviewer_keywords: ["C3049"] -ms.assetid: 6ddf54f6-2c30-4d04-b637-98c6c922c533 --- # Compiler Error C3049 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md index 6cb25a546b5..853b205551f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3050" title: "Compiler Error C3050" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3050" +ms.date: 11/04/2016 f1_keywords: ["C3050"] helpviewer_keywords: ["C3050"] -ms.assetid: ee090a0b-29cc-4215-a2f9-d82af79b8e82 --- # Compiler Error C3050 From c099a457591c65f199e1d84c5b15d9902eaf4ccc Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 17:13:26 +0800 Subject: [PATCH 0744/1799] Fix wrong operator links in `` header reference --- docs/standard-library/variant.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/standard-library/variant.md b/docs/standard-library/variant.md index a61bd4e8bba..eca66c3552e 100644 --- a/docs/standard-library/variant.md +++ b/docs/standard-library/variant.md @@ -21,12 +21,12 @@ A variant object holds and manages a value. If the variant holds a value, that v |Name|Description| |-|-| -|[operator==](../standard-library/forward-list-operators.md#op_eq_eq)|Tests if the variant object on the left side of the operator is equal to the variant object on the right side.| -|[operator!=](../standard-library/forward-list-operators.md#op_neq)|Tests if the variant object on the left side of the operator is not equal to the variant object on the right side.| -|[operator<](../standard-library/forward-list-operators.md#op_lt)|Tests if the variant object on the left side of the operator is less than the variant object on the right side.| -|[operator<=](../standard-library/forward-list-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is less than or equal to the variant object on the right side.| -|[operator>](../standard-library/forward-list-operators.md#op_gt)|Tests if the variant object on the left side of the operator is greater than the variant object on the right side.| -|[operator>=](../standard-library/forward-list-operators.md#op_gt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| +|[operator==](../standard-library/variant-operators.md#op_eq_eq)|Tests if the variant object on the left side of the operator is equal to the variant object on the right side.| +|[operator!=](../standard-library/variant-operators.md#op_neq)|Tests if the variant object on the left side of the operator is not equal to the variant object on the right side.| +|[operator<](../standard-library/variant-operators.md#op_lt)|Tests if the variant object on the left side of the operator is less than the variant object on the right side.| +|[operator<=](../standard-library/variant-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is less than or equal to the variant object on the right side.| +|[operator>](../standard-library/variant-operators.md#op_gt)|Tests if the variant object on the left side of the operator is greater than the variant object on the right side.| +|[operator>=](../standard-library/variant-operators.md#op_gt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| ### Functions From 9c50ae96ca947162adf32eebb55a95b67405ddef Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 17:15:46 +0800 Subject: [PATCH 0745/1799] Add backticks in `` header reference --- docs/standard-library/variant.md | 42 ++++++++++++++++---------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/standard-library/variant.md b/docs/standard-library/variant.md index eca66c3552e..b13d8745e33 100644 --- a/docs/standard-library/variant.md +++ b/docs/standard-library/variant.md @@ -11,9 +11,9 @@ A variant object holds and manages a value. If the variant holds a value, that v ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## Members @@ -21,45 +21,45 @@ A variant object holds and manages a value. If the variant holds a value, that v |Name|Description| |-|-| -|[operator==](../standard-library/variant-operators.md#op_eq_eq)|Tests if the variant object on the left side of the operator is equal to the variant object on the right side.| -|[operator!=](../standard-library/variant-operators.md#op_neq)|Tests if the variant object on the left side of the operator is not equal to the variant object on the right side.| -|[operator<](../standard-library/variant-operators.md#op_lt)|Tests if the variant object on the left side of the operator is less than the variant object on the right side.| -|[operator<=](../standard-library/variant-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is less than or equal to the variant object on the right side.| -|[operator>](../standard-library/variant-operators.md#op_gt)|Tests if the variant object on the left side of the operator is greater than the variant object on the right side.| -|[operator>=](../standard-library/variant-operators.md#op_gt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| +|[`operator==`](../standard-library/variant-operators.md#op_eq_eq)|Tests if the variant object on the left side of the operator is equal to the variant object on the right side.| +|[`operator!=`](../standard-library/variant-operators.md#op_neq)|Tests if the variant object on the left side of the operator is not equal to the variant object on the right side.| +|[`operator<`](../standard-library/variant-operators.md#op_lt)|Tests if the variant object on the left side of the operator is less than the variant object on the right side.| +|[`operator<=`](../standard-library/variant-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is less than or equal to the variant object on the right side.| +|[`operator>`](../standard-library/variant-operators.md#op_gt)|Tests if the variant object on the left side of the operator is greater than the variant object on the right side.| +|[`operator>=`](../standard-library/variant-operators.md#op_gt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| ### Functions |Name|Description| |-|-| -|[get](../standard-library/variant-functions.md#get)|Gets the variant of an object.| -|[get_if](../standard-library/variant-functions.md#get_if)|Gets the variant of an object if it exists.| -|[holds_alternative](../standard-library/variant-functions.md#holds_alternative)|Return **`true`** if a variant exists.| -|[swap](../standard-library/variant-functions.md#swap)|Swaps a **variant**.| -|[visit](../standard-library/variant-functions.md#visit)|Moves to the next **variant**.| +|[`get`](../standard-library/variant-functions.md#get)|Gets the variant of an object.| +|[`get_if`](../standard-library/variant-functions.md#get_if)|Gets the variant of an object if it exists.| +|[`holds_alternative`](../standard-library/variant-functions.md#holds_alternative)|Return **`true`** if a variant exists.| +|[`swap`](../standard-library/variant-functions.md#swap)|Swaps a **variant**.| +|[`visit`](../standard-library/variant-functions.md#visit)|Moves to the next **variant**.| ### Classes |Name|Description| |-|-| -|[bad_variant_access](../standard-library/bad-variant-access-class.md)|Objects thrown to report invalid accesses to the value of a variant object.| -|[variant](../standard-library/variant.md)|An object to either hold a value of one of its alternative types, or no value.| +|[`bad_variant_access`](../standard-library/bad-variant-access-class.md)|Objects thrown to report invalid accesses to the value of a variant object.| +|[`variant`](../standard-library/variant.md)|An object to either hold a value of one of its alternative types, or no value.| ### Structs |Name|Description| |-|-| -|[hash](../standard-library/hash-structure.md)|| -|[monostate](../standard-library/monostate-structure.md)|An alternative type for a variant to make the variant type default constructible.| -|[uses_allocator](../standard-library/uses-allocator-structure.md)|| -|[variant_alternative](../standard-library/variant-alternative-structure.md)|Assists the variant objects.| -|[variant_size](../standard-library/variant-size-structure.md)|Assists the variant objects.| +|[`hash`](../standard-library/hash-structure.md)|| +|[`monostate`](../standard-library/monostate-structure.md)|An alternative type for a variant to make the variant type default constructible.| +|[`uses_allocator`](../standard-library/uses-allocator-structure.md)|| +|[`variant_alternative`](../standard-library/variant-alternative-structure.md)|Assists the variant objects.| +|[`variant_size`](../standard-library/variant-size-structure.md)|Assists the variant objects.| ### Objects |Name|Description| |-|-| -|[variant_npos](../standard-library/variant-functions.md#variant_npos)|| +|[`variant_npos`](../standard-library/variant-functions.md#variant_npos)|| ## See also From af79a0e4b8ab3b5e701804bc12b6c0bbcece8628 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 17:20:46 +0800 Subject: [PATCH 0746/1799] Clean up redundant relative links in `` header reference --- docs/standard-library/variant.md | 40 ++++++++++++++++---------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/standard-library/variant.md b/docs/standard-library/variant.md index b13d8745e33..79e24eb8f20 100644 --- a/docs/standard-library/variant.md +++ b/docs/standard-library/variant.md @@ -21,46 +21,46 @@ A variant object holds and manages a value. If the variant holds a value, that v |Name|Description| |-|-| -|[`operator==`](../standard-library/variant-operators.md#op_eq_eq)|Tests if the variant object on the left side of the operator is equal to the variant object on the right side.| -|[`operator!=`](../standard-library/variant-operators.md#op_neq)|Tests if the variant object on the left side of the operator is not equal to the variant object on the right side.| -|[`operator<`](../standard-library/variant-operators.md#op_lt)|Tests if the variant object on the left side of the operator is less than the variant object on the right side.| -|[`operator<=`](../standard-library/variant-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is less than or equal to the variant object on the right side.| -|[`operator>`](../standard-library/variant-operators.md#op_gt)|Tests if the variant object on the left side of the operator is greater than the variant object on the right side.| -|[`operator>=`](../standard-library/variant-operators.md#op_gt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| +|[`operator==`](variant-operators.md#op_eq_eq)|Tests if the variant object on the left side of the operator is equal to the variant object on the right side.| +|[`operator!=`](variant-operators.md#op_neq)|Tests if the variant object on the left side of the operator is not equal to the variant object on the right side.| +|[`operator<`](variant-operators.md#op_lt)|Tests if the variant object on the left side of the operator is less than the variant object on the right side.| +|[`operator<=`](variant-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is less than or equal to the variant object on the right side.| +|[`operator>`](variant-operators.md#op_gt)|Tests if the variant object on the left side of the operator is greater than the variant object on the right side.| +|[`operator>=`](variant-operators.md#op_gt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| ### Functions |Name|Description| |-|-| -|[`get`](../standard-library/variant-functions.md#get)|Gets the variant of an object.| -|[`get_if`](../standard-library/variant-functions.md#get_if)|Gets the variant of an object if it exists.| -|[`holds_alternative`](../standard-library/variant-functions.md#holds_alternative)|Return **`true`** if a variant exists.| -|[`swap`](../standard-library/variant-functions.md#swap)|Swaps a **variant**.| -|[`visit`](../standard-library/variant-functions.md#visit)|Moves to the next **variant**.| +|[`get`](variant-functions.md#get)|Gets the variant of an object.| +|[`get_if`](variant-functions.md#get_if)|Gets the variant of an object if it exists.| +|[`holds_alternative`](variant-functions.md#holds_alternative)|Return **`true`** if a variant exists.| +|[`swap`](variant-functions.md#swap)|Swaps a **variant**.| +|[`visit`](variant-functions.md#visit)|Moves to the next **variant**.| ### Classes |Name|Description| |-|-| -|[`bad_variant_access`](../standard-library/bad-variant-access-class.md)|Objects thrown to report invalid accesses to the value of a variant object.| -|[`variant`](../standard-library/variant.md)|An object to either hold a value of one of its alternative types, or no value.| +|[`bad_variant_access`](bad-variant-access-class.md)|Objects thrown to report invalid accesses to the value of a variant object.| +|[`variant`](variant.md)|An object to either hold a value of one of its alternative types, or no value.| ### Structs |Name|Description| |-|-| -|[`hash`](../standard-library/hash-structure.md)|| -|[`monostate`](../standard-library/monostate-structure.md)|An alternative type for a variant to make the variant type default constructible.| -|[`uses_allocator`](../standard-library/uses-allocator-structure.md)|| -|[`variant_alternative`](../standard-library/variant-alternative-structure.md)|Assists the variant objects.| -|[`variant_size`](../standard-library/variant-size-structure.md)|Assists the variant objects.| +|[`hash`](hash-structure.md)|| +|[`monostate`](monostate-structure.md)|An alternative type for a variant to make the variant type default constructible.| +|[`uses_allocator`](uses-allocator-structure.md)|| +|[`variant_alternative`](variant-alternative-structure.md)|Assists the variant objects.| +|[`variant_size`](variant-size-structure.md)|Assists the variant objects.| ### Objects |Name|Description| |-|-| -|[`variant_npos`](../standard-library/variant-functions.md#variant_npos)|| +|[`variant_npos`](variant-functions.md#variant_npos)|| ## See also -[Header Files Reference](../standard-library/cpp-standard-library-header-files.md) +[Header Files Reference](cpp-standard-library-header-files.md) From adc7a7fcb3241cad82ebf848e533e776ef14c5b5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 17:29:28 +0800 Subject: [PATCH 0747/1799] Fix wrong link to `variant` class in `` header reference --- docs/standard-library/variant.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/variant.md b/docs/standard-library/variant.md index 79e24eb8f20..04f6018d139 100644 --- a/docs/standard-library/variant.md +++ b/docs/standard-library/variant.md @@ -43,7 +43,7 @@ A variant object holds and manages a value. If the variant holds a value, that v |Name|Description| |-|-| |[`bad_variant_access`](bad-variant-access-class.md)|Objects thrown to report invalid accesses to the value of a variant object.| -|[`variant`](variant.md)|An object to either hold a value of one of its alternative types, or no value.| +|[`variant`](variant-class.md)|An object to either hold a value of one of its alternative types, or no value.| ### Structs From 8697f098c0df70b4fbe1dddd7d7e4441fcf46b3e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 17:42:51 +0800 Subject: [PATCH 0748/1799] Add blockquotes for error message C2349 --- docs/error-messages/compiler-errors-1/compiler-error-c2349.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md index 3b2cf2a02a2..41aea3c1147 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md @@ -7,6 +7,6 @@ helpviewer_keywords: ["C2349"] --- # Compiler Error C2349 -'function' cannot be compiled as managed: 'reason'; use #pragma unmanaged +> 'function' cannot be compiled as managed: 'reason'; use #pragma unmanaged For more information, see [Compiler Warning (level 1 and 3) C4793](../../error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md). From 3625036382cc5ed29974f8e6044e09fe63b443a1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 17:44:13 +0800 Subject: [PATCH 0749/1799] Add "Remarks" heading for error reference C2349 --- docs/error-messages/compiler-errors-1/compiler-error-c2349.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md index 41aea3c1147..b365f1b240e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C2349"] > 'function' cannot be compiled as managed: 'reason'; use #pragma unmanaged +## Remarks + For more information, see [Compiler Warning (level 1 and 3) C4793](../../error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md). From 9577d89b457287ee15c0be792546d7fe4b6e84b6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 18:42:46 +0800 Subject: [PATCH 0750/1799] Update error message in C2135 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2135.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index 4af1d4f1b40..db2f0fff8af 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2135"] --- # Compiler Error C2135 -> 'bit operator' : illegal bit field operation +> '*identifier*': you cannot apply '*operator*' to a bit-field ## Remarks From 5ec8f130db282b6e5d8e2d3be00ed3abb5cc459a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 18:47:50 +0800 Subject: [PATCH 0751/1799] Improve example in C2135 error reference --- .../compiler-errors-1/compiler-error-c2135.md | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index db2f0fff8af..48ab905e946 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -19,15 +19,16 @@ The following example generates C2135: ```cpp // C2135.cpp -struct S { - int i : 1; -}; -struct T { - int j; +struct S +{ + int bit_field : 1; + int integer; }; -int main() { - &S::i; // C2135 address of a bit field - &T::j; // OK + +int main() +{ + &S::bit_field; // C2135 + &S::integer; // OK } ``` From a656d0ce02b1f8d2e7b8346b3d2912cc0dea90e9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 19:03:53 +0800 Subject: [PATCH 0752/1799] Augment remarks in C2135 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2135.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index 48ab905e946..899b8ac2334 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C2135"] ## Remarks -The address-of operator (`&`) cannot be applied to a bit field. +The [address-of operator (`&`)](../../cpp/address-of-operator-amp.md), [unary plus operator (`+`)](../../cpp/unary-plus-and-negation-operators-plus-and.md), [unary negation operator (`-`)](../../cpp/unary-plus-and-negation-operators-plus-and.md), [logical negation operator (`!`)](../../cpp/logical-negation-operator-exclpt.md), [one's complement operator (`~`)](../../cpp/one-s-complement-operator-tilde.md), and [indirection operator (`*`)](../../cpp/indirection-operator-star.md) cannot be applied to a bit-field in this context. ## Example From 8759fc37887b21693c3fa05ad5e50cc526238f6e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 19:06:20 +0800 Subject: [PATCH 0753/1799] Add C2104 "See also" link in C2135 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2135.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index 899b8ac2334..921540e5b9f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -32,3 +32,7 @@ int main() &S::integer; // OK } ``` + +## See also + +[C2104](compiler-error-c2104.md) From 797e67bb08dd7e4d5985d6b057038f1c1892999e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 19:07:21 +0800 Subject: [PATCH 0754/1799] Update `ms.date` metadata in C2135 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2135.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index 921540e5b9f..aff3621ccb1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2135" description: "Learn more about: Compiler Error C2135" -ms.date: 11/04/2016 +ms.date: 08/13/2025 f1_keywords: ["C2135"] helpviewer_keywords: ["C2135"] --- From 20a92e1ec3013d14dc62c9a5de5714e010d877f1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 23:23:49 +0800 Subject: [PATCH 0755/1799] Add blockquotes for error messages in range [C3051, C3080] --- docs/error-messages/compiler-errors-2/compiler-error-c3052.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3053.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3055.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3056.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3057.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3058.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3059.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3060.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3062.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3063.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3065.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3066.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3068.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3069.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3070.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3071.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3073.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3075.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3076.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3077.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3080.md | 2 +- 21 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md index 2eaaa547883..bd6de2a6e53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md @@ -8,7 +8,7 @@ ms.assetid: 87480c42-1ceb-4775-8d20-88c54a7bb6a6 --- # Compiler Error C3052 -'var' : variable doesn't appear in a data-sharing clause under a default(none) clause +> 'var' : variable doesn't appear in a data-sharing clause under a default(none) clause If [default(none)](../../parallel/openmp/reference/openmp-clauses.md#default-openmp) is used, any variable used in the structured block must be explicitly specified as either [shared](../../parallel/openmp/reference/openmp-clauses.md#shared-openmp) or [private](../../parallel/openmp/reference/openmp-clauses.md#private-openmp). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md index e2ca4233799..11b8278ef69 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md @@ -8,7 +8,7 @@ ms.assetid: ab9a25f3-e341-4f6e-8e69-069b4a963a64 --- # Compiler Error C3053 -'symbol' : 'threadprivate' is only valid for global or static data items +> 'symbol' : 'threadprivate' is only valid for global or static data items Symbols passed to [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) must either be global or static. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md index a3e046633f4..140f3494f1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md @@ -8,7 +8,7 @@ ms.assetid: 60446ee0-18dd-48fc-9059-f0a14229dce8 --- # Compiler Error C3055 -'symbol' : symbol cannot be referenced before it is used in 'threadprivate' directive +> 'symbol' : symbol cannot be referenced before it is used in 'threadprivate' directive A symbol was referenced and then used in a [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) clause, which is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md index cf9e92e01a6..ffcb1f534fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md @@ -8,7 +8,7 @@ ms.assetid: 9500173d-870b-49b3-8e88-0ee93586d19a --- # Compiler Error C3056 -'symbol' : symbol is not in the same scope with 'threadprivate' directive +> 'symbol' : symbol is not in the same scope with 'threadprivate' directive A symbol used in a [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) clause must be in the same scope as the `threadprivate` clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md index e2b10e3f31f..bcf25658546 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md @@ -8,7 +8,7 @@ ms.assetid: b0b2ba88-9c74-4bec-bf60-8fc72eade34c --- # Compiler Error C3057 -'symbol' : dynamic initialization of 'threadprivate' symbols is not currently supported +> 'symbol' : dynamic initialization of 'threadprivate' symbols is not currently supported The initialized value of a symbol used in a [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) clause must be known at compile time. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md index 2e52864c0de..68b65b76f78 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md @@ -8,7 +8,7 @@ ms.assetid: 669d08c8-0b58-4351-88aa-c6e6e1af481c --- # Compiler Error C3058 -'symbol' : symbol not declared as 'threadprivate' before it is used in the 'copyin' clause +> 'symbol' : symbol not declared as 'threadprivate' before it is used in the 'copyin' clause A symbol must first be declared [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) before it can be used in a [copyin](../../parallel/openmp/reference/openmp-clauses.md#copyin) clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md index 0385160ecf1..f836c0831eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md @@ -8,7 +8,7 @@ ms.assetid: 57220324-8286-4cab-a1ab-45385eb1eae0 --- # Compiler Error C3059 -'var' : 'threadprivate' symbol cannot be used in the 'clause' clause +> 'var' : 'threadprivate' symbol cannot be used in the 'clause' clause A [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) symbol was used in a clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md index 56687093106..c37a081e759 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md @@ -8,7 +8,7 @@ ms.assetid: 6282bb92-0546-4b59-9435-d3840bf93bdb --- # Compiler Error C3060 -'member' : a friend function may not be defined inside a class using a qualified name (it may only be declared) +> 'member' : a friend function may not be defined inside a class using a qualified name (it may only be declared) A friend function was defined using a qualified name, which is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md index ecd02c05848..41c4eaf6346 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md @@ -8,7 +8,7 @@ ms.assetid: 78632e6d-255f-42c3-b124-31a9194ff86d --- # Compiler Error C3062 -'enum': enumerator requires value since the underlying type is 'type' +> 'enum': enumerator requires value since the underlying type is 'type' You can specify an underlying type for an enumeration. However, some types require you to assign values to each enumerator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md index 14672ef7f5f..f17538111ad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md @@ -8,7 +8,7 @@ ms.assetid: 0ecf6f1f-e4a7-487a-9fd5-79d8ac470001 --- # Compiler Error C3063 -operator 'operator': all operands must have the same enumeration type +> operator 'operator': all operands must have the same enumeration type When using operators on enumerators, both operands must be of the enumeration type. For more information, see [How to: Define and consume enums in C++/CLI](../../dotnet/how-to-define-and-consume-enums-in-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md index 38985064a54..0b8c36e4e57 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md @@ -8,7 +8,7 @@ ms.assetid: e7a0bc69-1c68-459e-a7c4-93c65609ff7c --- # Compiler Error C3065 -property declaration at non-class scope is not allowed +> property declaration at non-class scope is not allowed The [property](../../cpp/property-cpp.md) __declspec modifier was used outside a class. A property can only be declared inside a class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md index 59508836a8e..b80bc9801de 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md @@ -8,7 +8,7 @@ ms.assetid: 226f6de5-c4c5-41e2-b31a-2e30a37fbbeb --- # Compiler Error C3066 -there are multiple ways that an object of this type can be called with these arguments +> there are multiple ways that an object of this type can be called with these arguments The compiler detected an ambiguous function call involving surrogates. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md index 22e5e30c360..ad98acdd24e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3068"] --- # Compiler Error C3068 -'function' : a 'naked' function cannot contain objects that would require unwinding if a C++ exception occurred +> 'function' : a 'naked' function cannot contain objects that would require unwinding if a C++ exception occurred The compiler was unable to perform stack unwinding on a [naked](../../cpp/naked-cpp.md) function that threw an exception because a temporary object was created in the function and C++ exception handling ([/EHsc](../../build/reference/eh-exception-handling-model.md)) was specified. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md index 34a45c96c9d..b0526faca07 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md @@ -8,7 +8,7 @@ ms.assetid: ca94291b-2bb4-4e3f-9acf-534234b83513 --- # Compiler Error C3069 -'operator': not allowed for enumeration type +> 'operator': not allowed for enumeration type An operator is not supported for CLR enumerations. For more information, see [How to: Define and consume enums in C++/CLI](../../dotnet/how-to-define-and-consume-enums-in-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md index 9740fc45eeb..f927489a292 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md @@ -8,7 +8,7 @@ ms.assetid: ac88584d-40a6-4176-90f3-2371c3c935f2 --- # Compiler Error C3070 -'property': property does not have a 'set' method +> 'property': property does not have a 'set' method A property's set accessor method was not defined. For more information, see [property](../../extensions/property-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md index 2b25f530af2..cfdc67e8d43 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md @@ -8,7 +8,7 @@ ms.assetid: 69879e66-a60e-4058-9bbd-d5c5e2d8ee37 --- # Compiler Error C3071 -operator 'operator' can only be applied to an instance of a ref class or a value-type +> operator 'operator' can only be applied to an instance of a ref class or a value-type A CLR operator cannot be used on a native type. The operator can be used on a ref class or a ref struct (a value type) but not a native type such as int or an alias for a native type such as System::Int32. These types can't be boxed from C++ code in a way that refers to the native variable, so the operator cannot be used. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md index abfadfab32d..bac7ba3831b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md @@ -8,7 +8,7 @@ ms.assetid: b24b9b8b-f9fb-4c3c-a1a0-97fad2081bfc --- # Compiler Error C3073 -'type' : ref class does not have a user-defined copy constructor +> 'type' : ref class does not have a user-defined copy constructor In a [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) compilation, the compiler will not generate a copy constructor for a reference type. In any **/clr** compilation, you must define your own copy constructor for a reference type if you expect an instance of the type to be copied. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md index edb6485a4cd..27ac63db403 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md @@ -8,7 +8,7 @@ ms.assetid: f431daa9-e0fa-48f0-a5c3-f99be96b55e3 --- # Compiler Error C3075 -'instance' : you cannot embed an instance of a reference type, 'type', in a value-type +> 'instance' : you cannot embed an instance of a reference type, 'type', in a value-type A value type cannot contain an instance of a reference type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md index 35183fa19d4..5e381464105 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md @@ -8,7 +8,7 @@ ms.assetid: 8a87b3e4-2c17-4b87-9622-ef0962d6a34e --- # Compiler Error C3076 -'instance' : you cannot embed an instance of a reference type, 'type', in a native type +> 'instance' : you cannot embed an instance of a reference type, 'type', in a native type A native type cannot contain an instance of a CLR type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md index 4ceb95d997d..6441e9b9455 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md @@ -8,7 +8,7 @@ ms.assetid: d9f3c619-d1e2-4656-81a5-a35a9586a7d4 --- # Compiler Error C3077 -'finalizer' : a finalizer can only be a member of a reference type +> 'finalizer' : a finalizer can only be a member of a reference type You cannot declare a finalizer in a native or value type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md index 14b0241f785..292851ad834 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md @@ -8,7 +8,7 @@ ms.assetid: ff62a3f7-9b3b-44bd-b8d9-f3a8e5354560 --- # Compiler Error C3080 -'finalizer_function' : a finalizer cannot have a storage-class-specifier +> 'finalizer_function' : a finalizer cannot have a storage-class-specifier For more information, see [Destructors and finalizers in How to: Define and consume classes and structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). From 22ffa2925b4f6436c880bab6fcb08c8c0e5fcae3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 23:29:26 +0800 Subject: [PATCH 0756/1799] Add "Remarks" and "Example" headings for error references in range [C3051, C3080] --- .../compiler-errors-2/compiler-error-c3052.md | 4 ++++ .../compiler-errors-2/compiler-error-c3053.md | 4 ++++ .../compiler-errors-2/compiler-error-c3055.md | 4 ++++ .../compiler-errors-2/compiler-error-c3056.md | 4 ++++ .../compiler-errors-2/compiler-error-c3057.md | 4 ++++ .../compiler-errors-2/compiler-error-c3058.md | 4 ++++ .../compiler-errors-2/compiler-error-c3059.md | 4 ++++ .../compiler-errors-2/compiler-error-c3060.md | 4 ++++ .../compiler-errors-2/compiler-error-c3062.md | 4 ++++ .../compiler-errors-2/compiler-error-c3063.md | 2 ++ .../compiler-errors-2/compiler-error-c3065.md | 4 ++++ .../compiler-errors-2/compiler-error-c3066.md | 6 +++++- .../compiler-errors-2/compiler-error-c3068.md | 2 ++ .../compiler-errors-2/compiler-error-c3069.md | 2 ++ .../compiler-errors-2/compiler-error-c3070.md | 4 ++++ .../compiler-errors-2/compiler-error-c3071.md | 2 ++ .../compiler-errors-2/compiler-error-c3072.md | 2 ++ .../compiler-errors-2/compiler-error-c3073.md | 2 ++ .../compiler-errors-2/compiler-error-c3075.md | 2 ++ .../compiler-errors-2/compiler-error-c3076.md | 2 ++ .../compiler-errors-2/compiler-error-c3077.md | 2 ++ .../compiler-errors-2/compiler-error-c3080.md | 2 ++ 22 files changed, 69 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md index bd6de2a6e53..d575f57f451 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md @@ -10,8 +10,12 @@ ms.assetid: 87480c42-1ceb-4775-8d20-88c54a7bb6a6 > 'var' : variable doesn't appear in a data-sharing clause under a default(none) clause +## Remarks + If [default(none)](../../parallel/openmp/reference/openmp-clauses.md#default-openmp) is used, any variable used in the structured block must be explicitly specified as either [shared](../../parallel/openmp/reference/openmp-clauses.md#shared-openmp) or [private](../../parallel/openmp/reference/openmp-clauses.md#private-openmp). +## Example + The following sample generates C3052: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md index 11b8278ef69..7a42db5f108 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md @@ -10,8 +10,12 @@ ms.assetid: ab9a25f3-e341-4f6e-8e69-069b4a963a64 > 'symbol' : 'threadprivate' is only valid for global or static data items +## Remarks + Symbols passed to [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) must either be global or static. +## Example + The following sample generates C3053: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md index 140f3494f1b..a9e18696837 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md @@ -10,8 +10,12 @@ ms.assetid: 60446ee0-18dd-48fc-9059-f0a14229dce8 > 'symbol' : symbol cannot be referenced before it is used in 'threadprivate' directive +## Remarks + A symbol was referenced and then used in a [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) clause, which is not allowed. +## Example + The following sample generates C3055: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md index ffcb1f534fa..3020d12767f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md @@ -10,8 +10,12 @@ ms.assetid: 9500173d-870b-49b3-8e88-0ee93586d19a > 'symbol' : symbol is not in the same scope with 'threadprivate' directive +## Remarks + A symbol used in a [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) clause must be in the same scope as the `threadprivate` clause. +## Example + The following sample generates C3056: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md index bcf25658546..195c7ab294e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md @@ -10,8 +10,12 @@ ms.assetid: b0b2ba88-9c74-4bec-bf60-8fc72eade34c > 'symbol' : dynamic initialization of 'threadprivate' symbols is not currently supported +## Remarks + The initialized value of a symbol used in a [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) clause must be known at compile time. +## Examples + The following sample generates C3057: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md index 68b65b76f78..e6a1c02f3a5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md @@ -10,8 +10,12 @@ ms.assetid: 669d08c8-0b58-4351-88aa-c6e6e1af481c > 'symbol' : symbol not declared as 'threadprivate' before it is used in the 'copyin' clause +## Remarks + A symbol must first be declared [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) before it can be used in a [copyin](../../parallel/openmp/reference/openmp-clauses.md#copyin) clause. +## Example + The following sample generates C3058: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md index f836c0831eb..3e549f42463 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md @@ -10,8 +10,12 @@ ms.assetid: 57220324-8286-4cab-a1ab-45385eb1eae0 > 'var' : 'threadprivate' symbol cannot be used in the 'clause' clause +## Remarks + A [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) symbol was used in a clause. +## Example + The following sample generates C3059: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md index c37a081e759..7a4d2199269 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md @@ -10,8 +10,12 @@ ms.assetid: 6282bb92-0546-4b59-9435-d3840bf93bdb > 'member' : a friend function may not be defined inside a class using a qualified name (it may only be declared) +## Remarks + A friend function was defined using a qualified name, which is not allowed. +## Example + The following sample generates C3060: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md index 41c4eaf6346..91e217c260e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md @@ -10,10 +10,14 @@ ms.assetid: 78632e6d-255f-42c3-b124-31a9194ff86d > 'enum': enumerator requires value since the underlying type is 'type' +## Remarks + You can specify an underlying type for an enumeration. However, some types require you to assign values to each enumerator. For more information on enums, see [enum class](../../extensions/enum-class-cpp-component-extensions.md). +## Example + The following sample generates C3062: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md index f17538111ad..2ba2082eaba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md @@ -10,6 +10,8 @@ ms.assetid: 0ecf6f1f-e4a7-487a-9fd5-79d8ac470001 > operator 'operator': all operands must have the same enumeration type +## Remarks + When using operators on enumerators, both operands must be of the enumeration type. For more information, see [How to: Define and consume enums in C++/CLI](../../dotnet/how-to-define-and-consume-enums-in-cpp-cli.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md index 0b8c36e4e57..f35b3f77c94 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md @@ -10,8 +10,12 @@ ms.assetid: e7a0bc69-1c68-459e-a7c4-93c65609ff7c > property declaration at non-class scope is not allowed +## Remarks + The [property](../../cpp/property-cpp.md) __declspec modifier was used outside a class. A property can only be declared inside a class. +## Example + The following sample generates C3065: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md index b80bc9801de..b0cd87c4d3a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md @@ -10,8 +10,12 @@ ms.assetid: 226f6de5-c4c5-41e2-b31a-2e30a37fbbeb > there are multiple ways that an object of this type can be called with these arguments +## Remarks + The compiler detected an ambiguous function call involving surrogates. +## Examples + The following sample generates C3066: ```cpp @@ -46,7 +50,7 @@ int main() { } ``` -## Copy-list-initialization +### Copy-list-initialization In Visual Studio 2015, the compiler erroneously treated copy-list-initialization in the same way as regular copy-initialization; it considered only converting constructors for overload resolution. In the following example, Visual Studio 2015 chooses MyInt(23) but Visual Studio 2017 correctly raises the error. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md index ad98acdd24e..db6b5304f79 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C3068"] > 'function' : a 'naked' function cannot contain objects that would require unwinding if a C++ exception occurred +## Remarks + The compiler was unable to perform stack unwinding on a [naked](../../cpp/naked-cpp.md) function that threw an exception because a temporary object was created in the function and C++ exception handling ([/EHsc](../../build/reference/eh-exception-handling-model.md)) was specified. To resolve this error, do at least one of the following: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md index b0526faca07..b9ef4dda4cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md @@ -10,6 +10,8 @@ ms.assetid: ca94291b-2bb4-4e3f-9acf-534234b83513 > 'operator': not allowed for enumeration type +## Remarks + An operator is not supported for CLR enumerations. For more information, see [How to: Define and consume enums in C++/CLI](../../dotnet/how-to-define-and-consume-enums-in-cpp-cli.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md index f927489a292..4afc2c48543 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md @@ -10,8 +10,12 @@ ms.assetid: ac88584d-40a6-4176-90f3-2371c3c935f2 > 'property': property does not have a 'set' method +## Remarks + A property's set accessor method was not defined. For more information, see [property](../../extensions/property-cpp-component-extensions.md). +## Example + The following sample generates C3070: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md index cfdc67e8d43..0e1d1ae8541 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md @@ -10,6 +10,8 @@ ms.assetid: 69879e66-a60e-4058-9bbd-d5c5e2d8ee37 > operator 'operator' can only be applied to an instance of a ref class or a value-type +## Remarks + A CLR operator cannot be used on a native type. The operator can be used on a ref class or a ref struct (a value type) but not a native type such as int or an alias for a native type such as System::Int32. These types can't be boxed from C++ code in a way that refers to the native variable, so the operator cannot be used. For more information, see [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3072.md b/docs/error-messages/compiler-errors-2/compiler-error-c3072.md index 3fc36b7657a..cee557a9090 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3072.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3072.md @@ -10,6 +10,8 @@ ms.assetid: cdd5cb6b-c478-4698-adfa-c40188d34a18 > operator '*operator-name*' cannot be applied to an instance of a ref class +## Remarks + use the unary *operator-name* operator to convert an instance of a ref class to a handle type A CLR type requires CLR operators, not native (or standard) operators. For more information, see [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md index bac7ba3831b..4467da76ef0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md @@ -10,6 +10,8 @@ ms.assetid: b24b9b8b-f9fb-4c3c-a1a0-97fad2081bfc > 'type' : ref class does not have a user-defined copy constructor +## Remarks + In a [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) compilation, the compiler will not generate a copy constructor for a reference type. In any **/clr** compilation, you must define your own copy constructor for a reference type if you expect an instance of the type to be copied. For more information, see [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md index 27ac63db403..102125ccd76 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md @@ -10,6 +10,8 @@ ms.assetid: f431daa9-e0fa-48f0-a5c3-f99be96b55e3 > 'instance' : you cannot embed an instance of a reference type, 'type', in a value-type +## Remarks + A value type cannot contain an instance of a reference type. For more information, see [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md index 5e381464105..dc1bd0e0460 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md @@ -10,6 +10,8 @@ ms.assetid: 8a87b3e4-2c17-4b87-9622-ef0962d6a34e > 'instance' : you cannot embed an instance of a reference type, 'type', in a native type +## Remarks + A native type cannot contain an instance of a CLR type. For more information, see [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md index 6441e9b9455..1ba323d027b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md @@ -10,6 +10,8 @@ ms.assetid: d9f3c619-d1e2-4656-81a5-a35a9586a7d4 > 'finalizer' : a finalizer can only be a member of a reference type +## Remarks + You cannot declare a finalizer in a native or value type. For more information, see [Destructors and finalizers in How to: Define and consume classes and structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md index 292851ad834..c838ac27edc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md @@ -10,6 +10,8 @@ ms.assetid: ff62a3f7-9b3b-44bd-b8d9-f3a8e5354560 > 'finalizer_function' : a finalizer cannot have a storage-class-specifier +## Remarks + For more information, see [Destructors and finalizers in How to: Define and consume classes and structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). ## Example From dc164e0d6743f5a39e26978e76cd6666ba6eb218 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 23:31:00 +0800 Subject: [PATCH 0757/1799] Replace term "sample" with "example" for error references in range [C3051, C3080] --- docs/error-messages/compiler-errors-2/compiler-error-c3052.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3053.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3054.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3055.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3056.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3057.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3058.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3059.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3060.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3062.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3063.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3065.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3066.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3068.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3069.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3070.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3071.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3072.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3073.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3075.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3076.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3077.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3080.md | 2 +- 23 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md index d575f57f451..9ecb55df3b7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md @@ -16,7 +16,7 @@ If [default(none)](../../parallel/openmp/reference/openmp-clauses.md#default-ope ## Example -The following sample generates C3052: +The following example generates C3052: ```cpp // C3052.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md index 7a42db5f108..a411012c617 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md @@ -16,7 +16,7 @@ Symbols passed to [threadprivate](../../parallel/openmp/reference/openmp-directi ## Example -The following sample generates C3053: +The following example generates C3053: ```cpp // C3053.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3054.md b/docs/error-messages/compiler-errors-2/compiler-error-c3054.md index 4961c563e50..80e849970a2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3054.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3054.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Example -The following sample generates C3054. +The following example generates C3054. ```cpp // C3054.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md index a9e18696837..8e43726f340 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md @@ -16,7 +16,7 @@ A symbol was referenced and then used in a [threadprivate](../../parallel/openmp ## Example -The following sample generates C3055: +The following example generates C3055: ```cpp // C3055.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md index 3020d12767f..ee897562000 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md @@ -16,7 +16,7 @@ A symbol used in a [threadprivate](../../parallel/openmp/reference/openmp-direct ## Example -The following sample generates C3056: +The following example generates C3056: ```cpp // C3056.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md index 195c7ab294e..f536d24d98f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md @@ -16,7 +16,7 @@ The initialized value of a symbol used in a [threadprivate](../../parallel/openm ## Examples -The following sample generates C3057: +The following example generates C3057: ```cpp // C3057.cpp @@ -42,7 +42,7 @@ int main() { } ``` -The following sample generates C3057: +The following example generates C3057: ```cpp // C3057b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md index e6a1c02f3a5..930b88ea8ba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md @@ -16,7 +16,7 @@ A symbol must first be declared [threadprivate](../../parallel/openmp/reference/ ## Example -The following sample generates C3058: +The following example generates C3058: ```cpp // C3058.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md index 3e549f42463..19f8f13adc1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md @@ -16,7 +16,7 @@ A [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadpri ## Example -The following sample generates C3059: +The following example generates C3059: ```cpp // C3059.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md index 7a4d2199269..c75119aba24 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md @@ -16,7 +16,7 @@ A friend function was defined using a qualified name, which is not allowed. ## Example -The following sample generates C3060: +The following example generates C3060: ```cpp // C3060.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md index 91e217c260e..c18991cd2fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md @@ -18,7 +18,7 @@ For more information on enums, see [enum class](../../extensions/enum-class-cpp- ## Example -The following sample generates C3062: +The following example generates C3062: ```cpp // C3062.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md index 2ba2082eaba..18c6afb8007 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md @@ -16,7 +16,7 @@ When using operators on enumerators, both operands must be of the enumeration ty ## Example -The following sample generates C3063 and shows how to fix it: +The following example generates C3063 and shows how to fix it: ```cpp // C3063.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md index f35b3f77c94..05598a37737 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md @@ -16,7 +16,7 @@ The [property](../../cpp/property-cpp.md) __declspec modifier was used outside a ## Example -The following sample generates C3065: +The following example generates C3065: ```cpp // C3065.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md index b0cd87c4d3a..421799e1e74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md @@ -16,7 +16,7 @@ The compiler detected an ambiguous function call involving surrogates. ## Examples -The following sample generates C3066: +The following example generates C3066: ```cpp // C3066.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md index db6b5304f79..70488a70967 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md @@ -27,7 +27,7 @@ When an exception is thrown, compiler generated code, called the prolog and epil ## Example -The following sample generates C3068: +The following example generates C3068: ```cpp // C3068.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md index b9ef4dda4cd..456c57b6250 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md @@ -16,7 +16,7 @@ An operator is not supported for CLR enumerations. For more information, see [H ## Example -The following sample generates C3069: +The following example generates C3069: ```cpp // C3069.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md index 4afc2c48543..9bdc7b14279 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md @@ -16,7 +16,7 @@ A property's set accessor method was not defined. For more information, see [pro ## Example -The following sample generates C3070: +The following example generates C3070: ```cpp // C3070.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md index 0e1d1ae8541..7324611d459 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md @@ -18,7 +18,7 @@ For more information, see [Tracking Reference Operator](../../extensions/trackin ## Example -The following sample generates C3071. +The following example generates C3071. ```cpp // C3071.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3072.md b/docs/error-messages/compiler-errors-2/compiler-error-c3072.md index cee557a9090..0282b81e5e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3072.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3072.md @@ -18,7 +18,7 @@ A CLR type requires CLR operators, not native (or standard) operators. For more ## Example -The following sample generates C3072. +The following example generates C3072. ```cpp // C3072.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md index 4467da76ef0..1d63189cf50 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md @@ -18,7 +18,7 @@ For more information, see [C++ Stack Semantics for Reference Types](../../dotnet ## Example -The following sample generates C3073. +The following example generates C3073. ```cpp // C3073.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md index 102125ccd76..9149f10f370 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md @@ -18,7 +18,7 @@ For more information, see [C++ Stack Semantics for Reference Types](../../dotnet ## Example -The following sample generates C3075. +The following example generates C3075. ```cpp // C3075.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md index dc1bd0e0460..1e469a6af24 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md @@ -18,7 +18,7 @@ For more information, see [C++ Stack Semantics for Reference Types](../../dotnet ## Example -The following sample generates C3076. +The following example generates C3076. ```cpp // C3076.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md index 1ba323d027b..4eda0a4e536 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md @@ -18,7 +18,7 @@ For more information, see [Destructors and finalizers in How to: Define and cons ## Example -The following sample generates C3077. +The following example generates C3077. ```cpp // C3077.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md index c838ac27edc..14d33781ae6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md @@ -16,7 +16,7 @@ For more information, see [Destructors and finalizers in How to: Define and cons ## Example -The following sample generates C3080. +The following example generates C3080. ```cpp // C3080.cpp From 468f814c431a42b2262a75a41108b9c71447b3c9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 13 Aug 2025 23:35:02 +0800 Subject: [PATCH 0758/1799] Update metadata for error references in range [C3051, C3080] --- .../error-messages/compiler-errors-2/compiler-error-c3052.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3053.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3054.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c3055.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3056.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3057.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3058.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3059.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3060.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3062.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3063.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3065.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3066.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3069.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3070.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3071.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3072.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3073.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3075.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3076.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3077.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3080.md | 5 ++--- 22 files changed, 43 insertions(+), 65 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md index 9ecb55df3b7..57d7f03c1d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3052" title: "Compiler Error C3052" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3052" +ms.date: 11/04/2016 f1_keywords: ["C3052"] helpviewer_keywords: ["C3052"] -ms.assetid: 87480c42-1ceb-4775-8d20-88c54a7bb6a6 --- # Compiler Error C3052 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md index a411012c617..62bcc0b3055 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3053" title: "Compiler Error C3053" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3053" +ms.date: 11/04/2016 f1_keywords: ["C3053"] helpviewer_keywords: ["C3053"] -ms.assetid: ab9a25f3-e341-4f6e-8e69-069b4a963a64 --- # Compiler Error C3053 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3054.md b/docs/error-messages/compiler-errors-2/compiler-error-c3054.md index 80e849970a2..be1a516fcf8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3054.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3054.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3054" title: "Compiler Error C3054" +description: "Learn more about: Compiler Error C3054" ms.date: 06/01/2022 f1_keywords: ["C3054"] helpviewer_keywords: ["C3054"] -ms.assetid: 6f4b7ac5-0d12-474b-b611-76ff26ee41ac --- # Compiler Error C3054 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md index 8e43726f340..c27fbebbe56 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3055" title: "Compiler Error C3055" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3055" +ms.date: 11/04/2016 f1_keywords: ["C3055"] helpviewer_keywords: ["C3055"] -ms.assetid: 60446ee0-18dd-48fc-9059-f0a14229dce8 --- # Compiler Error C3055 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md index ee897562000..48b72cc3463 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3056" title: "Compiler Error C3056" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3056" +ms.date: 11/04/2016 f1_keywords: ["C3056"] helpviewer_keywords: ["C3056"] -ms.assetid: 9500173d-870b-49b3-8e88-0ee93586d19a --- # Compiler Error C3056 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md index f536d24d98f..009ad60d670 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3057" title: "Compiler Error C3057" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3057" +ms.date: 11/04/2016 f1_keywords: ["C3057"] helpviewer_keywords: ["C3057"] -ms.assetid: b0b2ba88-9c74-4bec-bf60-8fc72eade34c --- # Compiler Error C3057 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md index 930b88ea8ba..b02ea0b7cd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3058" title: "Compiler Error C3058" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3058" +ms.date: 11/04/2016 f1_keywords: ["C3058"] helpviewer_keywords: ["C3058"] -ms.assetid: 669d08c8-0b58-4351-88aa-c6e6e1af481c --- # Compiler Error C3058 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md index 19f8f13adc1..d7518ccc873 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3059" title: "Compiler Error C3059" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3059" +ms.date: 11/04/2016 f1_keywords: ["C3059"] helpviewer_keywords: ["C3059"] -ms.assetid: 57220324-8286-4cab-a1ab-45385eb1eae0 --- # Compiler Error C3059 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md index c75119aba24..1745f7c3480 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3060" title: "Compiler Error C3060" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3060" +ms.date: 11/04/2016 f1_keywords: ["C3060"] helpviewer_keywords: ["C3060"] -ms.assetid: 6282bb92-0546-4b59-9435-d3840bf93bdb --- # Compiler Error C3060 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md index c18991cd2fd..bb87d31e352 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3062" title: "Compiler Error C3062" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3062" +ms.date: 11/04/2016 f1_keywords: ["C3062"] helpviewer_keywords: ["C3062"] -ms.assetid: 78632e6d-255f-42c3-b124-31a9194ff86d --- # Compiler Error C3062 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md index 18c6afb8007..00e1890b694 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3063" title: "Compiler Error C3063" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3063" +ms.date: 11/04/2016 f1_keywords: ["C3063"] helpviewer_keywords: ["C3063"] -ms.assetid: 0ecf6f1f-e4a7-487a-9fd5-79d8ac470001 --- # Compiler Error C3063 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md index 05598a37737..6c8a2fdb26e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3065" title: "Compiler Error C3065" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3065" +ms.date: 11/04/2016 f1_keywords: ["C3065"] helpviewer_keywords: ["C3065"] -ms.assetid: e7a0bc69-1c68-459e-a7c4-93c65609ff7c --- # Compiler Error C3065 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md index 421799e1e74..abba7aee354 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3066" title: "Compiler Error C3066" -ms.date: "03/28/2017" +description: "Learn more about: Compiler Error C3066" +ms.date: 03/28/2017 f1_keywords: ["C3066"] helpviewer_keywords: ["C3066"] -ms.assetid: 226f6de5-c4c5-41e2-b31a-2e30a37fbbeb --- # Compiler Error C3066 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md index 456c57b6250..e334e11aaa5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3069" title: "Compiler Error C3069" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3069" +ms.date: 11/04/2016 f1_keywords: ["C3069"] helpviewer_keywords: ["C3069"] -ms.assetid: ca94291b-2bb4-4e3f-9acf-534234b83513 --- # Compiler Error C3069 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md index 9bdc7b14279..3e5cd8cee5e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3070" title: "Compiler Error C3070" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3070" +ms.date: 11/04/2016 f1_keywords: ["C3070"] helpviewer_keywords: ["C3070"] -ms.assetid: ac88584d-40a6-4176-90f3-2371c3c935f2 --- # Compiler Error C3070 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md index 7324611d459..b8f37bba23f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3071" title: "Compiler Error C3071" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3071" +ms.date: 11/04/2016 f1_keywords: ["C3071"] helpviewer_keywords: ["C3071"] -ms.assetid: 69879e66-a60e-4058-9bbd-d5c5e2d8ee37 --- # Compiler Error C3071 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3072.md b/docs/error-messages/compiler-errors-2/compiler-error-c3072.md index 0282b81e5e7..c4a4aa4d695 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3072.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3072.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3072" title: "Compiler Error C3072" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3072" +ms.date: 11/04/2016 f1_keywords: ["C3072"] helpviewer_keywords: ["C3072"] -ms.assetid: cdd5cb6b-c478-4698-adfa-c40188d34a18 --- # Compiler Error C3072 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md index 1d63189cf50..ee969551dee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3073" title: "Compiler Error C3073" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3073" +ms.date: 11/04/2016 f1_keywords: ["C3073"] helpviewer_keywords: ["C3073"] -ms.assetid: b24b9b8b-f9fb-4c3c-a1a0-97fad2081bfc --- # Compiler Error C3073 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md index 9149f10f370..eddf91c56cb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3075" title: "Compiler Error C3075" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3075" +ms.date: 11/04/2016 f1_keywords: ["C3075"] helpviewer_keywords: ["C3075"] -ms.assetid: f431daa9-e0fa-48f0-a5c3-f99be96b55e3 --- # Compiler Error C3075 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md index 1e469a6af24..62da9d235f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3076" title: "Compiler Error C3076" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3076" +ms.date: 11/04/2016 f1_keywords: ["C3076"] helpviewer_keywords: ["C3076"] -ms.assetid: 8a87b3e4-2c17-4b87-9622-ef0962d6a34e --- # Compiler Error C3076 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md index 4eda0a4e536..db80911f95c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3077" title: "Compiler Error C3077" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3077" +ms.date: 11/04/2016 f1_keywords: ["C3077"] helpviewer_keywords: ["C3077"] -ms.assetid: d9f3c619-d1e2-4656-81a5-a35a9586a7d4 --- # Compiler Error C3077 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md index 14d33781ae6..88cbc6ca129 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3080" title: "Compiler Error C3080" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3080" +ms.date: 11/04/2016 f1_keywords: ["C3080"] helpviewer_keywords: ["C3080"] -ms.assetid: ff62a3f7-9b3b-44bd-b8d9-f3a8e5354560 --- # Compiler Error C3080 From 6bf0908284289b22e761a203e8a72746c4d474a6 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 13 Aug 2025 18:40:45 -0700 Subject: [PATCH 0759/1799] Remove extra word --- docs/sanitizers/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/toc.yml b/docs/sanitizers/toc.yml index b3c548bda9e..66b72750b80 100644 --- a/docs/sanitizers/toc.yml +++ b/docs/sanitizers/toc.yml @@ -12,7 +12,7 @@ items: href: ../sanitizers/asan-building.md - name: "Runtime reference" href: ../sanitizers/asan-runtime.md - - name: "AddressSanitizer runtime options" + - name: "Runtime options" href: ../sanitizers/asan-flags.md - name: "Debugger integration" href: ../sanitizers/asan-debugger-integration.md From 81b01f816444b586aaa938d6d418cabb933589a3 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 13 Aug 2025 18:41:30 -0700 Subject: [PATCH 0760/1799] check_printf not supported on windows --- docs/sanitizers/asan-flags.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 996a29b8de0..93c81e75162 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -22,7 +22,6 @@ If you discover options that are inaccurately documented, we invite you to [repo |`atexit` | `false` | If `true`, prints ASan exit stats even after program terminates successfully.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`check_malloc_usable_size` | `true` | If `true`, reports an error when the pointer does not reference a valid, currently allocated block.| -|`check_printf` | `true` | If `true`, enables ASan to validate printf family function arguments for memory safety violations.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If >`0`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects. Higher values increase detection effort.| From bbb34f4b02e1f0e10c2f24b6f6c25ee8639387f6 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 13 Aug 2025 18:41:45 -0700 Subject: [PATCH 0761/1799] include not supported on windows --- docs/sanitizers/asan-flags.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 93c81e75162..f4fb2552652 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -42,7 +42,6 @@ If you discover options that are inaccurately documented, we invite you to [repo |`help` | `false` | If `true`, ASan prints the flag options to console.| |`html_cov_report` | `false` | If `true`, ASan generates a coverage report.| |`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| -|`include` | `""` | Read more options from the given file.| |`include_if_exists` | `""` | Read more options from the given file (if it exists).| |`intercept_memcmp` | `true` | If `true`, uses custom wrappers for memcmp function to find more errors.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for strpbrk function to find more errors.| From a82940d7cd67f269e8e814c97b0c735a2f6ba66e Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 13 Aug 2025 18:42:11 -0700 Subject: [PATCH 0762/1799] Not Supported on windows --- docs/sanitizers/asan-flags.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index f4fb2552652..90083bae452 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -43,7 +43,6 @@ If you discover options that are inaccurately documented, we invite you to [repo |`html_cov_report` | `false` | If `true`, ASan generates a coverage report.| |`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include_if_exists` | `""` | Read more options from the given file (if it exists).| -|`intercept_memcmp` | `true` | If `true`, uses custom wrappers for memcmp function to find more errors.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for strpbrk function to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for strspn and strcspn function to find more errors.| |`intercept_strstr` | `true` | If `true`, uses custom wrappers for strstr and strcasestr functions to find more errors.| From f9ce9534293f2c7fabb9c072cf3e5ab4f17e8cdb Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 13 Aug 2025 18:43:09 -0700 Subject: [PATCH 0763/1799] Not supported --- docs/sanitizers/asan-flags.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 90083bae452..9994afc68af 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -46,7 +46,6 @@ If you discover options that are inaccurately documented, we invite you to [repo |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for strpbrk function to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for strspn and strcspn function to find more errors.| |`intercept_strstr` | `true` | If `true`, uses custom wrappers for strstr and strcasestr functions to find more errors.| -|`intercept_tls_get_addr` | `false` | Intercept __tls_get_addr.| |`log_exe_name` | `false` | Mention name of executable when reporting error and append executable name to logs (as in `log_path.exe_name.pid`).| |`log_path` | `stderr` | Write logs to `log_path.pid`. The special values are `stdout` and `stderr`. The default is `stderr`.| |`log_to_syslog` | `false` | Write all sanitizer output to syslog in addition to other means of logging.| From edb3e0d54e1b3933e1467e0d246a2af8b13568ec Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 13 Aug 2025 18:43:18 -0700 Subject: [PATCH 0764/1799] Not supported --- docs/sanitizers/asan-flags.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 9994afc68af..893202ec709 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -64,7 +64,6 @@ If you discover options that are inaccurately documented, we invite you to [repo |`print_legend` | `true` | Print the legend for the shadow bytes.| |`print_stats` | `false` | Print various statistics after printing an error message or if atexit=1.| |`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| -|`print_suppressions` | `true` | Print matched suppressions at exit.| |`protect_shadow_gap` | `true` | If `true`, `mprotect` the shadow gap.| |`quarantine_size` | `-1` | Deprecated, please use `quarantine_size_mb`.| |`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| From 6d7a8650aaea16015500c3e8887bcd8e439dc4df Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 21:05:58 +0800 Subject: [PATCH 0765/1799] Add blockquotes and update error message in C3083 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3083.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md index 35cefa54416..7f5871d0304 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md @@ -8,7 +8,7 @@ ms.assetid: 05ff791d-52bb-41eb-9511-3ef89d7f4710 --- # Compiler Error C3083 -'function': the symbol to the left of a '::' must be a type +> '*identifier*': the symbol to the left of a '::' must be a type A function was called incorrectly. From 80b3960228e32215cddd86e79303e70cfeb3c500 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 21:06:51 +0800 Subject: [PATCH 0766/1799] Add "Remarks" heading in C3083 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3083.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md index 7f5871d0304..3792c711f26 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md @@ -10,6 +10,8 @@ ms.assetid: 05ff791d-52bb-41eb-9511-3ef89d7f4710 > '*identifier*': the symbol to the left of a '::' must be a type +## Remarks + A function was called incorrectly. ## Example From 4243428b360981ffec222356fe17d310cf0b5190 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 21:28:30 +0800 Subject: [PATCH 0767/1799] Overhaul remarks in C3083 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3083.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md index 3792c711f26..7a86aaf4a0c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md @@ -12,7 +12,7 @@ ms.assetid: 05ff791d-52bb-41eb-9511-3ef89d7f4710 ## Remarks -A function was called incorrectly. +The qualification used is invalid. Ensure that no extra symbols were used in the qualification and that you included all required headers. ## Example From 39250ac89130c2fa3ae880c0cf2cfbe41b48e1ca Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 21:34:44 +0800 Subject: [PATCH 0768/1799] Fix and improve example in C3083 error reference --- .../compiler-errors-2/compiler-error-c3083.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md index 7a86aaf4a0c..fd0580e5a49 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md @@ -16,19 +16,17 @@ The qualification used is invalid. Ensure that no extra symbols were used in the ## Example -The following sample generates C3083. +The following example generates C3083: ```cpp // C3083.cpp // compile with: /c -struct N { - ~N(); -}; -struct N1 { - ~N1(); +struct S +{ + S(); }; -N::N::~N() {} // C3083 -N1::~N1() {} // OK +S::Extra::S() {} // C3083 +S::S() {} // OK ``` From 5f6fa92144dd7373e9270d16e5b283fb3d00b494 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 21:35:31 +0800 Subject: [PATCH 0769/1799] Update metadata in C3083 error reference --- .../error-messages/compiler-errors-2/compiler-error-c3083.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md index fd0580e5a49..8b0ec411136 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3083" title: "Compiler Error C3083" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3083" +ms.date: 08/14/2025 f1_keywords: ["C3083"] helpviewer_keywords: ["C3083"] -ms.assetid: 05ff791d-52bb-41eb-9511-3ef89d7f4710 --- # Compiler Error C3083 From 7d2e9267b22c3a25edc72b543d1fe6a2f63b83cd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 22:01:41 +0800 Subject: [PATCH 0770/1799] Add blockquotes for error messages in range [C3081, C3130] --- docs/error-messages/compiler-errors-2/compiler-error-c3084.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3085.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3087.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3094.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3095.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3096.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3097.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3099.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3100.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3101.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3103.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3104.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3106.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3110.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3113.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3114.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3115.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3116.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3117.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3118.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3120.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3121.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3126.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3130.md | 2 +- 24 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md index aebe230b47a..f2818964fa6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md @@ -8,7 +8,7 @@ ms.assetid: 0362cb70-e24e-476f-a24d-8f5bb97c3afd --- # Compiler Error C3084 -'function': a finalizer/destructor cannot be 'keyword' +> 'function': a finalizer/destructor cannot be 'keyword' A finalizer or destructor was declared incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md index 7fe1b774584..102a0b05f22 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md @@ -8,7 +8,7 @@ ms.assetid: 1ac40bf2-f63e-439e-8921-47e6dadc8354 --- # Compiler Error C3085 -'constructor': a constructor cannot be 'keyword' +> 'constructor': a constructor cannot be 'keyword' A constructor was declared incorrectly. See [Override Specifiers](../../extensions/override-specifiers-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md index a55aa67f4bd..dfa4003fc8d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md @@ -8,7 +8,7 @@ ms.assetid: 4f5bdd52-a853-4f02-b160-6868e9190b9d --- # Compiler Error C3087 -'named_argument': call of 'attribute' already initializes this member +> 'named_argument': call of 'attribute' already initializes this member A named argument was specified in the same attribute block as an unnamed argument for the same value. Specify only a named or unnamed argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md index a97f0f43706..426657dc142 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md @@ -8,7 +8,7 @@ ms.assetid: 10da9b7c-e72d-4013-9925-c83e1bb142db --- # Compiler Error C3094 -'attribute': anonymous usage not allowed +> 'attribute': anonymous usage not allowed An attribute was not scoped correctly. 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-c3095.md b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md index bd8be003cbd..fea59c44b95 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md @@ -8,7 +8,7 @@ ms.assetid: cde725be-0936-40f6-9e57-e1d7d0710f83 --- # Compiler Error C3095 -'attribute': attribute cannot be repeated +> 'attribute': attribute cannot be repeated Some attributes are declared such that, multiple occurrences of the attribute cannot be applied to a target. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3096.md b/docs/error-messages/compiler-errors-2/compiler-error-c3096.md index aef61fc0947..3946185e304 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3096.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3096.md @@ -8,7 +8,7 @@ ms.assetid: 56353c9a-800c-474f-b428-3e5d2a7afc9a --- # Compiler Error C3096 -'attribute': attribute is allowed on data members of attribute classes only +> 'attribute': attribute is allowed on data members of attribute classes only An attribute was applied incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md index b8147494239..fdb024cf083 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md @@ -8,7 +8,7 @@ ms.assetid: b24bd8f8-e04f-4fbb-be57-4feb9165572e --- # Compiler Error C3097 -'attribute': attribute must be scoped with 'assembly:' or 'module:' +> 'attribute': attribute must be scoped with 'assembly:' or 'module:' A global attribute was used incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md index ae0c8f89aa8..204a3027e48 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md @@ -8,7 +8,7 @@ ms.assetid: b3dded0f-76c9-42c1-991b-532eb8619661 --- # Compiler Error C3099 -'keyword': use [System::AttributeUsageAttribute] for managed attributes; use [Windows::Foundation::Metadata::AttributeUsageAttribute] for WinRT attributes +> 'keyword': use [System::AttributeUsageAttribute] for managed attributes; use [Windows::Foundation::Metadata::AttributeUsageAttribute] for WinRT attributes Use to declare **/clr** attributes. Use `Windows::Foundation::Metadata::AttributeUsageAttribute` to declare Windows Runtime attributes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md index 5fa251c5129..a4583d78d83 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md @@ -8,7 +8,7 @@ ms.assetid: 7a9c9eaf-08ef-442d-94a0-e457beee8549 --- # Compiler Error C3100 -'target' : unknown attribute qualifier +> 'target' : unknown attribute qualifier An invalid attribute target was specified. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md index 045856000f7..c519944550f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md @@ -8,7 +8,7 @@ ms.assetid: 4f673766-d4f7-4632-94a5-d36a83f7f4b5 --- # Compiler Error C3101 -illegal expression for named attribute argument 'field' +> illegal expression for named attribute argument 'field' When initializing a named attribute argument, the value must be a compile time constant. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md index c877baa9b96..123be858e4e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md @@ -8,7 +8,7 @@ ms.assetid: 7984bd3e-d51d-43e4-b6f4-08c1e9fb9704 --- # Compiler Error C3103 -'argument': repeated named argument +> 'argument': repeated named argument An attribute can not repeat named arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md index 1dec0a81074..28ba2468bdb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md @@ -8,7 +8,7 @@ ms.assetid: b5648d47-e5d3-4b45-a3c0-f46e04eae731 --- # Compiler Error C3104 -illegal attribute argument +> illegal attribute argument You specified an invalid argument to an attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md index 0722bc47ab8..0ea2a3b2db1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md @@ -8,7 +8,7 @@ ms.assetid: 39d97a32-0905-4702-87d3-7f8ce473fb93 --- # Compiler Error C3106 -'attribute': unnamed arguments must precede named arguments +> 'attribute': unnamed arguments must precede named arguments Unnamed arguments must be passed to an attribute before named arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3110.md b/docs/error-messages/compiler-errors-2/compiler-error-c3110.md index d9394cedf03..b8b6d21e522 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3110.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3110.md @@ -8,7 +8,7 @@ ms.assetid: 821dc71f-896e-4b2d-af0e-aa9932934b7b --- # Compiler Error C3110 -'function_name' : you cannot overload a COM interface method +> 'function_name' : you cannot overload a COM interface method An interface that is prefaced by an interface attribute, such as: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md index 970f7590709..7b400ef127e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md @@ -8,7 +8,7 @@ ms.assetid: 3afdc668-b29e-474e-9ea3-aa027d42db7c --- # Compiler Error C3113 -an 'structure' cannot be a template/generic +> an 'structure' cannot be a template/generic You attempted to make a class template or class generic out of an interface or an enum. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md index 6fac377ccb8..0bd5839e0d3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md @@ -8,7 +8,7 @@ ms.assetid: b5d2df4f-87d0-4292-9981-25c6a6013c05 --- # Compiler Error C3114 -'argument': not a valid named attribute argument +> 'argument': not a valid named attribute argument In order for an attribute class data member to be a valid named argument, it must not be marked **`static`**, **`const`**, or **`literal`**. If a property, the property must not be **`static`** and must have get and set accessors. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md index 217ea876771..03b42e5ca77 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md @@ -8,7 +8,7 @@ ms.assetid: 51726145-9782-4ec9-84b9-286f366d9cbd --- # Compiler Error C3115 -'attribute': this attribute is not allowed on 'construct' +> 'attribute': this attribute is not allowed on 'construct' An attribute was applied to a construct for which it was not intended. See [Attributes by Usage](../../windows/attributes/attributes-by-usage.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md index 57dbf504d7f..d291688f14c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md @@ -8,7 +8,7 @@ ms.assetid: 597463e1-a5cc-4ed3-a917-eae9a61d3312 --- # Compiler Error C3116 -'storage specifier' : invalid storage class for interface method +> 'storage specifier' : invalid storage class for interface method You used **`typedef`**, **`register`**, or **`static`** as the storage class for an interface method. These storage classes are not permitted on interface members. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md index d8564c19483..a35034fb256 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md @@ -8,7 +8,7 @@ ms.assetid: dceee392-d4c7-4599-b75e-7aaac7c36fdd --- # Compiler Error C3117 -'%$S' : an interface can only have one base class +> '%$S' : an interface can only have one base class You declared an interface that inherits from multiple base classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3118.md b/docs/error-messages/compiler-errors-2/compiler-error-c3118.md index 336a3aaf927..b90b7c0cad8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3118.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3118.md @@ -8,7 +8,7 @@ ms.assetid: 40fbe681-8868-4cb2-a2b2-4db4449319a7 --- # Compiler Error C3118 -'interface' : interfaces do not support virtual inheritance +> 'interface' : interfaces do not support virtual inheritance You tried to virtually inherit from an interface. For example, diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3120.md b/docs/error-messages/compiler-errors-2/compiler-error-c3120.md index b9d10eea8a6..0e2eabee5ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3120.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3120.md @@ -8,7 +8,7 @@ ms.assetid: 9b6b210f-9948-4517-a4cc-b4aaadebde68 --- # Compiler Error C3120 -'method_name' : interface methods cannot take a variable argument list +> 'method_name' : interface methods cannot take a variable argument list An interface method cannot take a variable argument list. For example, the following interface definition generates C3120: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3121.md b/docs/error-messages/compiler-errors-2/compiler-error-c3121.md index 227db69a1d0..dc92ada5e11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3121.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3121.md @@ -8,7 +8,7 @@ ms.assetid: 1d3c7be4-d42d-4def-8d53-182c0c5cc237 --- # Compiler Error C3121 -cannot change GUID for class 'class_name' +> cannot change GUID for class 'class_name' You attempted to change the class ID with [__declspec(uuid)](../../cpp/uuid-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md index 2822c84cc6a..8536c3f4a3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md @@ -8,7 +8,7 @@ ms.assetid: e72658a3-5d85-4a31-89a4-dbc3d475973d --- # Compiler Error C3126 -cannot define a union 'union' inside of managed type 'type' +> cannot define a union 'union' inside of managed type 'type' A union cannot be defined inside a managed type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3130.md b/docs/error-messages/compiler-errors-2/compiler-error-c3130.md index 4da60e51e93..4006e92b68a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3130.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3130.md @@ -8,6 +8,6 @@ ms.assetid: c1462f33-434f-41f0-937e-392864916850 --- # Compiler Error C3130 -Internal Compiler Error: failed to write injected code block to PDB +> Internal Compiler Error: failed to write injected code block to PDB This error occurs if the compiler failed to write an injected code block to the .pdb file. The most common reason for the failure is lack of disk space. From 926b19f625b07a0f8694a54012abdace25c92a42 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 22:07:44 +0800 Subject: [PATCH 0771/1799] Add "Remarks" and "Example" headings for error references in range [C3081, C3130] --- .../compiler-errors-2/compiler-error-c3084.md | 2 ++ .../compiler-errors-2/compiler-error-c3085.md | 2 ++ .../compiler-errors-2/compiler-error-c3087.md | 2 ++ .../compiler-errors-2/compiler-error-c3094.md | 2 ++ .../compiler-errors-2/compiler-error-c3095.md | 2 ++ .../compiler-errors-2/compiler-error-c3096.md | 2 ++ .../compiler-errors-2/compiler-error-c3097.md | 2 ++ .../compiler-errors-2/compiler-error-c3099.md | 2 ++ .../compiler-errors-2/compiler-error-c3100.md | 2 ++ .../compiler-errors-2/compiler-error-c3101.md | 2 ++ .../compiler-errors-2/compiler-error-c3103.md | 2 ++ .../compiler-errors-2/compiler-error-c3104.md | 2 ++ .../compiler-errors-2/compiler-error-c3106.md | 2 ++ .../compiler-errors-2/compiler-error-c3110.md | 8 +++++++- .../compiler-errors-2/compiler-error-c3113.md | 4 ++++ .../compiler-errors-2/compiler-error-c3114.md | 2 ++ .../compiler-errors-2/compiler-error-c3115.md | 2 ++ .../compiler-errors-2/compiler-error-c3116.md | 4 ++++ .../compiler-errors-2/compiler-error-c3117.md | 4 ++++ .../compiler-errors-2/compiler-error-c3118.md | 8 +++++++- .../compiler-errors-2/compiler-error-c3120.md | 8 +++++++- .../compiler-errors-2/compiler-error-c3121.md | 4 ++++ .../compiler-errors-2/compiler-error-c3126.md | 4 ++++ .../compiler-errors-2/compiler-error-c3130.md | 2 ++ 24 files changed, 73 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md index f2818964fa6..60cd5972942 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md @@ -10,6 +10,8 @@ ms.assetid: 0362cb70-e24e-476f-a24d-8f5bb97c3afd > 'function': a finalizer/destructor cannot be 'keyword' +## Remarks + A finalizer or destructor was declared incorrectly. For example, a destructor should not be marked as sealed. The destructor will be inaccessible to derived types. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md) and [Destructors and finalizers in How to: Define and consume classes and structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md index 102a0b05f22..95ccea1ae62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md @@ -10,6 +10,8 @@ ms.assetid: 1ac40bf2-f63e-439e-8921-47e6dadc8354 > 'constructor': a constructor cannot be 'keyword' +## Remarks + A constructor was declared incorrectly. See [Override Specifiers](../../extensions/override-specifiers-cpp-component-extensions.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md index dfa4003fc8d..8c9d6b5f62f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md @@ -10,6 +10,8 @@ ms.assetid: 4f5bdd52-a853-4f02-b160-6868e9190b9d > 'named_argument': call of 'attribute' already initializes this member +## Remarks + A named argument was specified in the same attribute block as an unnamed argument for the same value. Specify only a named or unnamed argument. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md index 426657dc142..8c59eccec4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md @@ -10,6 +10,8 @@ ms.assetid: 10da9b7c-e72d-4013-9925-c83e1bb142db > 'attribute': anonymous usage not allowed +## Remarks + An attribute was not scoped correctly. For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md index fea59c44b95..d9f6c189284 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md @@ -10,6 +10,8 @@ ms.assetid: cde725be-0936-40f6-9e57-e1d7d0710f83 > 'attribute': attribute cannot be repeated +## Remarks + Some attributes are declared such that, multiple occurrences of the attribute cannot be applied to a target. 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-c3096.md b/docs/error-messages/compiler-errors-2/compiler-error-c3096.md index 3946185e304..0a3e89f08ba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3096.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3096.md @@ -10,6 +10,8 @@ ms.assetid: 56353c9a-800c-474f-b428-3e5d2a7afc9a > 'attribute': attribute is allowed on data members of attribute classes only +## Remarks + An attribute was applied incorrectly. 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-c3097.md b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md index fdb024cf083..8ef0171dba9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md @@ -10,6 +10,8 @@ ms.assetid: b24bd8f8-e04f-4fbb-be57-4feb9165572e > 'attribute': attribute must be scoped with 'assembly:' or 'module:' +## Remarks + A global attribute was used incorrectly. 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-c3099.md b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md index 204a3027e48..c2c416daba7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md @@ -10,6 +10,8 @@ ms.assetid: b3dded0f-76c9-42c1-991b-532eb8619661 > 'keyword': use [System::AttributeUsageAttribute] for managed attributes; use [Windows::Foundation::Metadata::AttributeUsageAttribute] for WinRT attributes +## Remarks + Use to declare **/clr** attributes. Use `Windows::Foundation::Metadata::AttributeUsageAttribute` to declare Windows Runtime attributes. For more information about /CLR attributes, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md). For supported attributes in Windows Runtime, see [Windows.Foundation.Metadata namespace](/uwp/api/windows.foundation.metadata) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md index a4583d78d83..47b9d7a82e5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md @@ -10,6 +10,8 @@ ms.assetid: 7a9c9eaf-08ef-442d-94a0-e457beee8549 > 'target' : unknown attribute qualifier +## Remarks + An invalid attribute target was specified. 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-c3101.md b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md index c519944550f..eaea04a0748 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md @@ -10,6 +10,8 @@ ms.assetid: 4f673766-d4f7-4632-94a5-d36a83f7f4b5 > illegal expression for named attribute argument 'field' +## Remarks + When initializing a named attribute argument, the value must be a compile time constant. For more information on attributes, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md index 123be858e4e..9f7d54c3264 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md @@ -10,6 +10,8 @@ ms.assetid: 7984bd3e-d51d-43e4-b6f4-08c1e9fb9704 > 'argument': repeated named argument +## Remarks + An attribute can not repeat named 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-c3104.md b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md index 28ba2468bdb..ae9c09df735 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md @@ -10,6 +10,8 @@ ms.assetid: b5648d47-e5d3-4b45-a3c0-f46e04eae731 > illegal attribute argument +## Remarks + You specified an invalid argument to an attribute. See [Attribute Parameter Types](../../extensions/attribute-parameter-types-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md index 0ea2a3b2db1..c19a6bba0c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md @@ -10,6 +10,8 @@ ms.assetid: 39d97a32-0905-4702-87d3-7f8ce473fb93 > 'attribute': unnamed arguments must precede named arguments +## Remarks + Unnamed arguments must be passed to an attribute before named 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-c3110.md b/docs/error-messages/compiler-errors-2/compiler-error-c3110.md index b8b6d21e522..76f3be430a9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3110.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3110.md @@ -10,6 +10,8 @@ ms.assetid: 821dc71f-896e-4b2d-af0e-aa9932934b7b > 'function_name' : you cannot overload a COM interface method +## Remarks + An interface that is prefaced by an interface attribute, such as: - [custom](../../windows/attributes/custom-cpp.md) @@ -20,7 +22,11 @@ An interface that is prefaced by an interface attribute, such as: - [object](../../windows/attributes/object-cpp.md) -cannot be overloaded. For example: +cannot be overloaded. + +## Example + +For example: ```cpp // C3110.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md index 7b400ef127e..131e99231e5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md @@ -10,8 +10,12 @@ ms.assetid: 3afdc668-b29e-474e-9ea3-aa027d42db7c > an 'structure' cannot be a template/generic +## Remarks + You attempted to make a class template or class generic out of an interface or an enum. +## Example + The following sample generates C3113: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md index 0bd5839e0d3..0102714bcaa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md @@ -10,6 +10,8 @@ ms.assetid: b5d2df4f-87d0-4292-9981-25c6a6013c05 > 'argument': not a valid named attribute argument +## Remarks + In order for an attribute class data member to be a valid named argument, it must not be marked **`static`**, **`const`**, or **`literal`**. If a property, the property must not be **`static`** and must have get and set accessors. For more information, see [property](../../extensions/property-cpp-component-extensions.md) and [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md index 03b42e5ca77..ed2db990d20 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md @@ -10,6 +10,8 @@ ms.assetid: 51726145-9782-4ec9-84b9-286f366d9cbd > 'attribute': this attribute is not allowed on 'construct' +## Remarks + An attribute was applied to a construct for which it was not intended. See [Attributes by Usage](../../windows/attributes/attributes-by-usage.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md index d291688f14c..2c90667dd74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md @@ -10,8 +10,12 @@ ms.assetid: 597463e1-a5cc-4ed3-a917-eae9a61d3312 > 'storage specifier' : invalid storage class for interface method +## Remarks + You used **`typedef`**, **`register`**, or **`static`** as the storage class for an interface method. These storage classes are not permitted on interface members. +## Example + The following sample generates C3116: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md index a35034fb256..58c4797b9a7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md @@ -10,8 +10,12 @@ ms.assetid: dceee392-d4c7-4599-b75e-7aaac7c36fdd > '%$S' : an interface can only have one base class +## Remarks + You declared an interface that inherits from multiple base classes. +## Example + The following sample generates C3117: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3118.md b/docs/error-messages/compiler-errors-2/compiler-error-c3118.md index b90b7c0cad8..937ce784d55 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3118.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3118.md @@ -10,7 +10,13 @@ ms.assetid: 40fbe681-8868-4cb2-a2b2-4db4449319a7 > 'interface' : interfaces do not support virtual inheritance -You tried to virtually inherit from an interface. For example, +## Remarks + +You tried to virtually inherit from an interface. + +## Example + +For example, ```cpp // C3118.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3120.md b/docs/error-messages/compiler-errors-2/compiler-error-c3120.md index 0e2eabee5ac..4d9bc906174 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3120.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3120.md @@ -10,7 +10,13 @@ ms.assetid: 9b6b210f-9948-4517-a4cc-b4aaadebde68 > 'method_name' : interface methods cannot take a variable argument list -An interface method cannot take a variable argument list. For example, the following interface definition generates C3120: +## Remarks + +An interface method cannot take a variable argument list. + +## Example + +For example, the following interface definition generates C3120: ```cpp // C3120.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3121.md b/docs/error-messages/compiler-errors-2/compiler-error-c3121.md index dc92ada5e11..2989ce1d1ee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3121.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3121.md @@ -10,8 +10,12 @@ ms.assetid: 1d3c7be4-d42d-4def-8d53-182c0c5cc237 > cannot change GUID for class 'class_name' +## Remarks + You attempted to change the class ID with [__declspec(uuid)](../../cpp/uuid-cpp.md). +## Example + For example, the following code generates C3121: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md index 8536c3f4a3b..21cb9c326b7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md @@ -10,8 +10,12 @@ ms.assetid: e72658a3-5d85-4a31-89a4-dbc3d475973d > cannot define a union 'union' inside of managed type 'type' +## Remarks + A union cannot be defined inside a managed type. +## Example + The following sample generates C3126: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3130.md b/docs/error-messages/compiler-errors-2/compiler-error-c3130.md index 4006e92b68a..db822e6157d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3130.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3130.md @@ -10,4 +10,6 @@ ms.assetid: c1462f33-434f-41f0-937e-392864916850 > Internal Compiler Error: failed to write injected code block to PDB +## Remarks + This error occurs if the compiler failed to write an injected code block to the .pdb file. The most common reason for the failure is lack of disk space. From b72054c1b313d52cfe9142782c7ed4e1f7cb2b59 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 22:09:04 +0800 Subject: [PATCH 0772/1799] Replace term "sample" with "example" for error references in range [C3081, C3130] --- docs/error-messages/compiler-errors-2/compiler-error-c3084.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3085.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3087.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3094.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3095.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3097.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3099.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3100.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3101.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3103.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3104.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3106.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3113.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3114.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3115.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3116.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3117.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3126.md | 2 +- 18 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md index 60cd5972942..9964d290304 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md @@ -18,7 +18,7 @@ For example, a destructor should not be marked as sealed. The destructor will b ## Example -The following sample generates C3084. +The following example generates C3084. ```cpp // C3084.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md index 95ccea1ae62..d8fab587149 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md @@ -16,7 +16,7 @@ A constructor was declared incorrectly. See [Override Specifiers](../../extensio ## Example -The following sample generates C3085. +The following example generates C3085. ```cpp // C3085.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md index 8c9d6b5f62f..78a63679697 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md @@ -16,7 +16,7 @@ A named argument was specified in the same attribute block as an unnamed argumen ## Example -The following sample generates C3087. +The following example generates C3087. ```cpp // C3087.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md index 8c59eccec4b..7c86d55bd16 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md @@ -16,7 +16,7 @@ An attribute was not scoped correctly. For more information, see [User-Defined ## Example -The following sample generates C3094. +The following example generates C3094. ```cpp // C3094.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md index d9f6c189284..ad87104a40a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md @@ -18,7 +18,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3095. +The following example generates C3095. ```cpp // C3095.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md index 8ef0171dba9..1aec39847bf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md @@ -18,7 +18,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3097. +The following example generates C3097. ```cpp // C3097.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md index c2c416daba7..418a783b6ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md @@ -18,7 +18,7 @@ For more information about /CLR attributes, see [User-Defined Attributes](../../ ## Example -The following sample generates C3099 and shows how to fix it. +The following example generates C3099 and shows how to fix it. ```cpp // C3099.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md index 47b9d7a82e5..1598117e708 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md @@ -18,7 +18,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3100. +The following example generates C3100. ```cpp // C3100.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md index eaea04a0748..dd8430cecc8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md @@ -18,7 +18,7 @@ For more information on attributes, see [User-Defined Attributes](../../extensio ## Example -The following sample generates C3101. +The following example generates C3101. ```cpp // C3101.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md index 9f7d54c3264..66d3292b5e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md @@ -18,7 +18,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3103. +The following example generates C3103. ```cpp // C3103.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md index ae9c09df735..1c89cb24ef4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md @@ -20,7 +20,7 @@ This error can be generated as a result of compiler conformance work that was do ## Examples -The following sample generates C3104. +The following example generates C3104. ```cpp // C3104a.cpp @@ -39,7 +39,7 @@ public ref struct ABC : public Attribute { ref struct AStruct{}; ``` -The following sample generates C3104. +The following example generates C3104. ```cpp // C3104b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md index c19a6bba0c5..f139cc0d4df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md @@ -18,7 +18,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3106. +The following example generates C3106. ```cpp // C3106.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md index 131e99231e5..68a267de11a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md @@ -16,7 +16,7 @@ You attempted to make a class template or class generic out of an interface or a ## Example -The following sample generates C3113: +The following example generates C3113: ```cpp // C3113.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md index 0102714bcaa..185d7ecebf1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md @@ -18,7 +18,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Example -The following sample generates C3114. +The following example generates C3114. ```cpp // C3114.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md index ed2db990d20..d8ed905fa1f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md @@ -16,7 +16,7 @@ An attribute was applied to a construct for which it was not intended. See [Att ## Example -The following sample generates C3115. +The following example generates C3115. ```cpp // C3115.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md index 2c90667dd74..12d7a8bc5de 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md @@ -16,7 +16,7 @@ You used **`typedef`**, **`register`**, or **`static`** as the storage class for ## Example -The following sample generates C3116: +The following example generates C3116: ```cpp // C3116.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md index 58c4797b9a7..ad3d4a020fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md @@ -16,7 +16,7 @@ You declared an interface that inherits from multiple base classes. ## Example -The following sample generates C3117: +The following example generates C3117: ```cpp // C3117.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md index 21cb9c326b7..5ed1296cc09 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md @@ -16,7 +16,7 @@ A union cannot be defined inside a managed type. ## Example -The following sample generates C3126: +The following example generates C3126: ```cpp // C3126_2.cpp From f20c3701c0bf5441b41dd33a171149175b0bd522 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 22:12:36 +0800 Subject: [PATCH 0773/1799] Update metadata for error references in range [C3081, C3130] --- .../error-messages/compiler-errors-2/compiler-error-c3084.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3085.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3087.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3094.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3095.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3096.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3097.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3099.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3100.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3101.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3103.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3104.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3106.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3110.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3113.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3114.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3115.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3116.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3117.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3118.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3120.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3121.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3126.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3130.md | 5 ++--- 24 files changed, 48 insertions(+), 72 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md index 9964d290304..a07399b74d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3084" title: "Compiler Error C3084" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3084" +ms.date: 11/04/2016 f1_keywords: ["C3084"] helpviewer_keywords: ["C3084"] -ms.assetid: 0362cb70-e24e-476f-a24d-8f5bb97c3afd --- # Compiler Error C3084 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md index d8fab587149..74751546f6d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3085" title: "Compiler Error C3085" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3085" +ms.date: 11/04/2016 f1_keywords: ["C3085"] helpviewer_keywords: ["C3085"] -ms.assetid: 1ac40bf2-f63e-439e-8921-47e6dadc8354 --- # Compiler Error C3085 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md index 78a63679697..1ab7a8e1e53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3087" title: "Compiler Error C3087" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3087" +ms.date: 11/04/2016 f1_keywords: ["C3087"] helpviewer_keywords: ["C3087"] -ms.assetid: 4f5bdd52-a853-4f02-b160-6868e9190b9d --- # Compiler Error C3087 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md index 7c86d55bd16..83e295f29c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3094" title: "Compiler Error C3094" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3094" +ms.date: 11/04/2016 f1_keywords: ["C3094"] helpviewer_keywords: ["C3094"] -ms.assetid: 10da9b7c-e72d-4013-9925-c83e1bb142db --- # Compiler Error C3094 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md index ad87104a40a..5cae3a92d4e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3095" title: "Compiler Error C3095" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3095" +ms.date: 11/04/2016 f1_keywords: ["C3095"] helpviewer_keywords: ["C3095"] -ms.assetid: cde725be-0936-40f6-9e57-e1d7d0710f83 --- # Compiler Error C3095 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3096.md b/docs/error-messages/compiler-errors-2/compiler-error-c3096.md index 0a3e89f08ba..65387f15584 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3096.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3096.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3096" title: "Compiler Error C3096" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3096" +ms.date: 11/04/2016 f1_keywords: ["C3096"] helpviewer_keywords: ["C3096"] -ms.assetid: 56353c9a-800c-474f-b428-3e5d2a7afc9a --- # Compiler Error C3096 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md index 1aec39847bf..0df9c143f97 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3097" title: "Compiler Error C3097" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3097" +ms.date: 11/04/2016 f1_keywords: ["C3097"] helpviewer_keywords: ["C3097"] -ms.assetid: b24bd8f8-e04f-4fbb-be57-4feb9165572e --- # Compiler Error C3097 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md index 418a783b6ef..715d0b0c786 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3099" title: "Compiler Error C3099" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3099" +ms.date: 11/04/2016 f1_keywords: ["C3099"] helpviewer_keywords: ["C3099"] -ms.assetid: b3dded0f-76c9-42c1-991b-532eb8619661 --- # Compiler Error C3099 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md index 1598117e708..c67b602e9a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3100" title: "Compiler Error C3100" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3100" +ms.date: 11/04/2016 f1_keywords: ["C3100"] helpviewer_keywords: ["C3100"] -ms.assetid: 7a9c9eaf-08ef-442d-94a0-e457beee8549 --- # Compiler Error C3100 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md index dd8430cecc8..6c5f88063b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3101" title: "Compiler Error C3101" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3101" +ms.date: 11/04/2016 f1_keywords: ["C3101"] helpviewer_keywords: ["C3101"] -ms.assetid: 4f673766-d4f7-4632-94a5-d36a83f7f4b5 --- # Compiler Error C3101 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md index 66d3292b5e1..46b7d95b5f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3103" title: "Compiler Error C3103" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3103" +ms.date: 11/04/2016 f1_keywords: ["C3103"] helpviewer_keywords: ["C3103"] -ms.assetid: 7984bd3e-d51d-43e4-b6f4-08c1e9fb9704 --- # Compiler Error C3103 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md index 1c89cb24ef4..b2b05bdc091 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3104" title: "Compiler Error C3104" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3104" +ms.date: 11/04/2016 f1_keywords: ["C3104"] helpviewer_keywords: ["C3104"] -ms.assetid: b5648d47-e5d3-4b45-a3c0-f46e04eae731 --- # Compiler Error C3104 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md index f139cc0d4df..e44c24da629 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3106" title: "Compiler Error C3106" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3106" +ms.date: 11/04/2016 f1_keywords: ["C3106"] helpviewer_keywords: ["C3106"] -ms.assetid: 39d97a32-0905-4702-87d3-7f8ce473fb93 --- # Compiler Error C3106 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3110.md b/docs/error-messages/compiler-errors-2/compiler-error-c3110.md index 76f3be430a9..9cf78b27444 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3110.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3110.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3110" title: "Compiler Error C3110" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3110" +ms.date: 11/04/2016 f1_keywords: ["C3110"] helpviewer_keywords: ["C3110"] -ms.assetid: 821dc71f-896e-4b2d-af0e-aa9932934b7b --- # Compiler Error C3110 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md index 68a267de11a..640eb8d5bb1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3113" title: "Compiler Error C3113" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3113" +ms.date: 11/04/2016 f1_keywords: ["C3113"] helpviewer_keywords: ["C3113"] -ms.assetid: 3afdc668-b29e-474e-9ea3-aa027d42db7c --- # Compiler Error C3113 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md index 185d7ecebf1..0d6fdb2e633 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3114" title: "Compiler Error C3114" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3114" +ms.date: 11/04/2016 f1_keywords: ["C3114"] helpviewer_keywords: ["C3114"] -ms.assetid: b5d2df4f-87d0-4292-9981-25c6a6013c05 --- # Compiler Error C3114 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md index d8ed905fa1f..f6be15f40d3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3115" title: "Compiler Error C3115" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3115" +ms.date: 11/04/2016 f1_keywords: ["C3115"] helpviewer_keywords: ["C3115"] -ms.assetid: 51726145-9782-4ec9-84b9-286f366d9cbd --- # Compiler Error C3115 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md index 12d7a8bc5de..4a3b9237bc0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3116" title: "Compiler Error C3116" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3116" +ms.date: 11/04/2016 f1_keywords: ["C3116"] helpviewer_keywords: ["C3116"] -ms.assetid: 597463e1-a5cc-4ed3-a917-eae9a61d3312 --- # Compiler Error C3116 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md index ad3d4a020fb..67f914ff316 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3117" title: "Compiler Error C3117" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3117" +ms.date: 11/04/2016 f1_keywords: ["C3117"] helpviewer_keywords: ["C3117"] -ms.assetid: dceee392-d4c7-4599-b75e-7aaac7c36fdd --- # Compiler Error C3117 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3118.md b/docs/error-messages/compiler-errors-2/compiler-error-c3118.md index 937ce784d55..48d11292d5f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3118.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3118.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3118" title: "Compiler Error C3118" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3118" +ms.date: 11/04/2016 f1_keywords: ["C3118"] helpviewer_keywords: ["C3118"] -ms.assetid: 40fbe681-8868-4cb2-a2b2-4db4449319a7 --- # Compiler Error C3118 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3120.md b/docs/error-messages/compiler-errors-2/compiler-error-c3120.md index 4d9bc906174..a292987bc60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3120.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3120.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3120" title: "Compiler Error C3120" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3120" +ms.date: 11/04/2016 f1_keywords: ["C3120"] helpviewer_keywords: ["C3120"] -ms.assetid: 9b6b210f-9948-4517-a4cc-b4aaadebde68 --- # Compiler Error C3120 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3121.md b/docs/error-messages/compiler-errors-2/compiler-error-c3121.md index 2989ce1d1ee..463bcaba93a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3121.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3121.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3121" title: "Compiler Error C3121" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3121" +ms.date: 11/04/2016 f1_keywords: ["C3121"] helpviewer_keywords: ["C3121"] -ms.assetid: 1d3c7be4-d42d-4def-8d53-182c0c5cc237 --- # Compiler Error C3121 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md index 5ed1296cc09..2b8904f94d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3126" title: "Compiler Error C3126" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3126" +ms.date: 11/04/2016 f1_keywords: ["C3126"] helpviewer_keywords: ["C3126"] -ms.assetid: e72658a3-5d85-4a31-89a4-dbc3d475973d --- # Compiler Error C3126 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3130.md b/docs/error-messages/compiler-errors-2/compiler-error-c3130.md index db822e6157d..ebd75f87f3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3130.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3130.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3130" title: "Compiler Error C3130" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3130" +ms.date: 11/04/2016 f1_keywords: ["C3130"] helpviewer_keywords: ["C3130"] -ms.assetid: c1462f33-434f-41f0-937e-392864916850 --- # Compiler Error C3130 From 88fc24a534da13c0feaaf819ce38e0b4551ebaa0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 22:27:17 +0800 Subject: [PATCH 0774/1799] Fix erroneous `template class<...` syntax in standard library references --- docs/standard-library/istream-functions.md | 3 ++- docs/standard-library/ostream-functions.md | 6 +++--- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/istream-functions.md b/docs/standard-library/istream-functions.md index 8c6d33665e1..5b0e2c372b6 100644 --- a/docs/standard-library/istream-functions.md +++ b/docs/standard-library/istream-functions.md @@ -37,7 +37,8 @@ A stream. Skips white space in the stream. ```cpp -template class basic_istream& ws(basic_istream& _Istr); +template +basic_istream& ws(basic_istream& _Istr); ``` ### Parameters diff --git a/docs/standard-library/ostream-functions.md b/docs/standard-library/ostream-functions.md index e306c7f49e0..3721ebdd884 100644 --- a/docs/standard-library/ostream-functions.md +++ b/docs/standard-library/ostream-functions.md @@ -14,7 +14,7 @@ These are the global template functions defined in ``. For member funct Terminates a line and flushes the buffer. ```cpp -template class +template basic_ostream& endl( basic_ostream& Ostr); ``` @@ -61,7 +61,7 @@ testing Terminates a string. ```cpp -template class +template basic_ostream& ends( basic_ostream& Ostr); ``` @@ -110,7 +110,7 @@ ab c Flushes the buffer. ```cpp -template class +template basic_ostream& flush( basic_ostream& Ostr); ``` From df5b0769da39f34097c002afee425aae78ad025f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 22:33:41 +0800 Subject: [PATCH 0775/1799] Add blockquotes for error messages in range [C3131, C3160] --- docs/error-messages/compiler-errors-2/compiler-error-c3131.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3132.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3133.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3134.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3135.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3136.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3137.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3138.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3139.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3140.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3141.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3142.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3145.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3149.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3150.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3152.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3153.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3154.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3155.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3156.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3157.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3159.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3160.md | 2 +- 23 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md index 54a1b28c50b..282fcbce613 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md @@ -8,7 +8,7 @@ ms.assetid: 38f20fac-83c9-4cd9-b7b5-74ca8f650ea6 --- # Compiler Error C3131 -project must have a 'module' attribute with a 'name' property +> project must have a 'module' attribute with a 'name' property The [module](../../windows/attributes/module-cpp.md) attribute must have a name parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3132.md b/docs/error-messages/compiler-errors-2/compiler-error-c3132.md index d61facc1aab..92724dec7c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3132.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3132.md @@ -8,7 +8,7 @@ ms.assetid: d54a3d12-336a-4ed0-ad4e-43cddac33b5e --- # Compiler Error C3132 -'function-parameter' : parameter arrays can only be applied to a formal argument of type 'single-dimensional managed array' +> 'function-parameter' : parameter arrays can only be applied to a formal argument of type 'single-dimensional managed array' The attribute was applied to a parameter that was not a single-dimension array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3133.md b/docs/error-messages/compiler-errors-2/compiler-error-c3133.md index d26c091a66a..7fbdbbe71e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3133.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3133.md @@ -8,7 +8,7 @@ ms.assetid: 4a709405-b67b-4061-8a2a-19fa5fb34a2a --- # Compiler Error C3133 -Attributes cannot be applied to C++ varargs +> Attributes cannot be applied to C++ varargs An attribute was applied incorrectly. Attributes can not be applied to an ellipsis representing variable arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3134.md b/docs/error-messages/compiler-errors-2/compiler-error-c3134.md index f8e04a9e7b5..53325748765 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3134.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3134.md @@ -8,7 +8,7 @@ ms.assetid: f887e4d2-7740-49e4-9972-7edceb8fa77b --- # Compiler Error C3134 -'value' : value of attribute argument 'attribute' does not have valid type 'type' +> 'value' : value of attribute argument 'attribute' does not have valid type 'type' A syntax error was detected when a value was assigned to an attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3135.md b/docs/error-messages/compiler-errors-2/compiler-error-c3135.md index 1b97325d54a..6c8d3cd64f1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3135.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3135.md @@ -8,6 +8,6 @@ ms.assetid: e92ee007-5a26-47f4-8ef4-339f2d9528d1 --- # Compiler Error C3135 -'property' : a property cannot have a 'const' or 'volatile' type +> 'property' : a property cannot have a 'const' or 'volatile' type 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 index d7f66d04349..f391a682851 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3136.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3136.md @@ -8,7 +8,7 @@ ms.assetid: c77103cd-00f7-408e-b74b-4f8562039d31 --- # Compiler Error C3136 -'interface' : a COM interface can only inherit from another COM interface, 'interface' is not a COM interface +> 'interface' : a COM interface can only inherit from another COM interface, 'interface' is not a COM interface 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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3137.md b/docs/error-messages/compiler-errors-2/compiler-error-c3137.md index 1ac5395685b..2422ae7aefa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3137.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3137.md @@ -8,7 +8,7 @@ ms.assetid: 70bb1313-2e87-43ed-a0d8-33fa6ff475e4 --- # Compiler Error C3137 -'property' : a property cannot be initialized +> 'property' : a property cannot be initialized A property cannot be initialized, for example, in a constructor's initialization list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3138.md b/docs/error-messages/compiler-errors-2/compiler-error-c3138.md index d02f0ad8c55..cd8297525a9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3138.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3138.md @@ -8,7 +8,7 @@ ms.assetid: 364ee9e8-9358-410e-bd35-9c4a226a3753 --- # Compiler Error C3138 -'interface' : a 'attribute' interface must inherit from IDispatch, or from an interface that inherits from IDispatch +> 'interface' : a 'attribute' interface must inherit from IDispatch, or from an interface that inherits from IDispatch 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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3139.md b/docs/error-messages/compiler-errors-2/compiler-error-c3139.md index 7d5df2ca7ad..d2dc1210745 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3139.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3139.md @@ -8,7 +8,7 @@ ms.assetid: 95c92263-10ac-4ff3-b385-6312dd92adbc --- # Compiler Error C3139 -'struct' : cannot export a UDT without members +> '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: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3140.md b/docs/error-messages/compiler-errors-2/compiler-error-c3140.md index 4339d3f6bd6..dc94856461e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3140.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3140.md @@ -8,7 +8,7 @@ ms.assetid: 122f8943-fac3-4db8-a3a8-2c5d19233de6 --- # Compiler Error C3140 -cannot have multiple 'module' attributes in the same compilation unit +> cannot have multiple 'module' attributes in the same compilation unit The [module](../../windows/attributes/module-cpp.md) attribute can only be defined once per project. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3141.md b/docs/error-messages/compiler-errors-2/compiler-error-c3141.md index 6811def6fc9..4b47040c32a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3141.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3141.md @@ -8,7 +8,7 @@ ms.assetid: b4fd65c3-50cc-46cd-8de0-6a6d24cb9cda --- # Compiler Error C3141 -'interface_name' : interfaces only support public inheritance +> 'interface_name' : interfaces only support public inheritance Interfaces defined with the [interface (or __interface)](../../cpp/interface.md) keyword only support public inheritance. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3142.md b/docs/error-messages/compiler-errors-2/compiler-error-c3142.md index 0a7e12997f3..dccde094fe7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3142.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3142.md @@ -8,7 +8,7 @@ ms.assetid: 795137ad-d00a-4a9c-9665-0cd8bfb5da8b --- # Compiler Error C3142 -'property_name' : you cannot take the address of a property +> 'property_name' : you cannot take the address of a property The address of a property is not available to the developer. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3145.md b/docs/error-messages/compiler-errors-2/compiler-error-c3145.md index 0105f33cfee..36085ad5a69 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3145.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3145.md @@ -8,7 +8,7 @@ ms.assetid: f165c874-0f51-45c7-85e8-ebe321cbc168 --- # Compiler Error C3145 -'object' : global or static variable may not have managed or WinRT type 'type' +> 'object' : global or static variable may not have managed or WinRT type 'type' You can only define CLR or WinRT objects within function scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3149.md b/docs/error-messages/compiler-errors-2/compiler-error-c3149.md index d28f9366044..31522089242 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3149.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3149.md @@ -8,7 +8,7 @@ ms.assetid: cf6e2616-2f06-46da-8a8a-d449cb481c51 --- # Compiler Error C3149 -'type' : cannot use this type here without a top-level 'char' +> 'type' : cannot use this type here without a top-level 'char' A declaration was not specified correctly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3150.md b/docs/error-messages/compiler-errors-2/compiler-error-c3150.md index 3145de7e129..c54dca25ba2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3150.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3150.md @@ -8,7 +8,7 @@ ms.assetid: c1ff28f5-52fe-4fd4-81d0-2e0ad8548631 --- # Compiler Error C3150 -'element' : 'attribute' can only be applied to a class, interface, array or pointer +> 'element' : 'attribute' can only be applied to a class, interface, array or pointer **`__gc`** can only be used on a class, interface, or array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3152.md b/docs/error-messages/compiler-errors-2/compiler-error-c3152.md index 2208919a996..99d57b0e194 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3152.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3152.md @@ -8,7 +8,7 @@ ms.assetid: 4ee6e2cd-5d19-4b73-833d-765c35797e4b --- # Compiler Error C3152 -'construct' : 'keyword' can only be applied to a class, struct, or virtual member function +> 'construct' : 'keyword' can only be applied to a class, struct, or virtual member function Certain keywords can only be applied to a C++ class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3153.md b/docs/error-messages/compiler-errors-2/compiler-error-c3153.md index 5aacbbacaae..a17e8a9fbc3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3153.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3153.md @@ -8,7 +8,7 @@ ms.assetid: d775d97e-2480-484f-81f1-88406b10f947 --- # Compiler Error C3153 -'interface' : you cannot create an instance of an interface +> 'interface' : you cannot create an instance of an interface 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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3154.md b/docs/error-messages/compiler-errors-2/compiler-error-c3154.md index 1a22ee051b2..44cb721a793 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3154.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3154.md @@ -8,7 +8,7 @@ ms.assetid: 78005c74-eaaf-4ac2-88ae-6c25d01a302a --- # Compiler Error C3154 -Expected ',' before ellipsis. Non-comma separated ellipsis not supported on parameter array functions. +> Expected ',' before ellipsis. Non-comma separated ellipsis not supported on parameter array functions. A variable argument function was not declared correctly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3155.md b/docs/error-messages/compiler-errors-2/compiler-error-c3155.md index 313c3c080a6..aadcbf6350a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3155.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3155.md @@ -8,7 +8,7 @@ ms.assetid: b04a42e1-64e7-40f8-81fe-c7945348b2cf --- # Compiler Error C3155 -attributes are not allowed in a property indexer +> attributes are not allowed in a property indexer 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). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3156.md b/docs/error-messages/compiler-errors-2/compiler-error-c3156.md index 6fdca14c852..fcb81121ed5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3156.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3156.md @@ -8,7 +8,7 @@ ms.assetid: 1876da78-b94e-4af7-9795-28f72b209b3e --- # Compiler Error C3156 -'class' : you cannot have a local definition of a managed or WinRT type +> 'class' : you cannot have a local definition of a managed or WinRT type A function cannot contain the definition, or declaration, of a managed or WinRT class, struct, or interface. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3157.md b/docs/error-messages/compiler-errors-2/compiler-error-c3157.md index bc9741e6078..647488e9844 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3157.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3157.md @@ -8,6 +8,6 @@ ms.assetid: fe94d97f-612e-4729-8b2b-b057d84822a1 --- # Compiler Error C3157 -ParamArray attribute can only be applied to the last parameter +> ParamArray attribute can only be applied to the last parameter The 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 index 92cdaba9c63..d2ab9cb1ece 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3159.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3159.md @@ -8,7 +8,7 @@ ms.assetid: e115cc76-0021-4568-95fd-61a324c41a85 --- # Compiler Error C3159 -'pointer' : array of pointers to value type cannot be declared +> 'pointer' : array of pointers to value type cannot be declared An array of pointers to a value type cannot be declared. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3160.md b/docs/error-messages/compiler-errors-2/compiler-error-c3160.md index b28eace9bbe..8cce91f5860 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3160.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3160.md @@ -8,7 +8,7 @@ ms.assetid: a250c433-8adf-43b9-8dee-c3794e09b0a5 --- # Compiler Error C3160 -'pointer' : a data member of a managed or WinRT class cannot have this type +> 'pointer' : a data member of a managed or WinRT class cannot have this type 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. From 6f9458eb63732166628ef165708b58fe00a599fe Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 22:39:18 +0800 Subject: [PATCH 0776/1799] Add "Remarks" and "Example" headings for error references in range [C3131, C3160] --- .../compiler-errors-2/compiler-error-c3131.md | 4 ++++ .../compiler-errors-2/compiler-error-c3132.md | 4 ++++ .../compiler-errors-2/compiler-error-c3133.md | 2 ++ .../compiler-errors-2/compiler-error-c3134.md | 2 ++ .../compiler-errors-2/compiler-error-c3135.md | 2 ++ .../compiler-errors-2/compiler-error-c3136.md | 4 ++++ .../compiler-errors-2/compiler-error-c3137.md | 4 ++++ .../compiler-errors-2/compiler-error-c3138.md | 4 ++++ .../compiler-errors-2/compiler-error-c3139.md | 8 +++++++- .../compiler-errors-2/compiler-error-c3140.md | 4 ++++ .../compiler-errors-2/compiler-error-c3141.md | 4 ++++ .../compiler-errors-2/compiler-error-c3142.md | 4 ++++ .../compiler-errors-2/compiler-error-c3145.md | 4 ++++ .../compiler-errors-2/compiler-error-c3149.md | 4 ++++ .../compiler-errors-2/compiler-error-c3150.md | 2 ++ .../compiler-errors-2/compiler-error-c3152.md | 4 ++++ .../compiler-errors-2/compiler-error-c3153.md | 4 ++++ .../compiler-errors-2/compiler-error-c3154.md | 2 ++ .../compiler-errors-2/compiler-error-c3155.md | 2 ++ .../compiler-errors-2/compiler-error-c3156.md | 2 ++ .../compiler-errors-2/compiler-error-c3157.md | 2 ++ .../compiler-errors-2/compiler-error-c3159.md | 2 ++ .../compiler-errors-2/compiler-error-c3160.md | 4 ++++ 23 files changed, 77 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md index 282fcbce613..27b316fe6f0 100644 --- 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 index 92724dec7c7..590ce96e0eb 100644 --- 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 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 index 7fbdbbe71e7..54bc1be03cf 100644 --- 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 index 53325748765..1c14ebca3dd 100644 --- 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 index 6c8d3cd64f1..53d469d7af7 100644 --- 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 index f391a682851..89bd042d3a3 100644 --- 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 index 2422ae7aefa..84de4d4a588 100644 --- 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 index cd8297525a9..b741b192c29 100644 --- 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 index d2dc1210745..4f3e20b3f0a 100644 --- 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 index dc94856461e..e15fbd083cb 100644 --- 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 index 4b47040c32a..b75d64eabc6 100644 --- 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 index dccde094fe7..fa1c98bf1bc 100644 --- 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 index 36085ad5a69..27c37a0c321 100644 --- 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 index 31522089242..95610b0e572 100644 --- 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 index c54dca25ba2..990b6b1409e 100644 --- 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 index 99d57b0e194..0027381af2c 100644 --- 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 index a17e8a9fbc3..f9262c03c4c 100644 --- 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 index 44cb721a793..a36924aa57b 100644 --- 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 index aadcbf6350a..87c5fe89b71 100644 --- 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 index fcb81121ed5..8d8498df139 100644 --- 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 index 647488e9844..b5ef09dc744 100644 --- 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 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 index d2ab9cb1ece..1ff1fe92982 100644 --- 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 index 8cce91f5860..9eafcf78c36 100644 --- 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 From 1d6c5ba136c33ece276b6671fbd58116506fdb8d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 22:40:40 +0800 Subject: [PATCH 0777/1799] Replace term "sample" with "example" for error references in range [C3131, C3160] --- docs/error-messages/compiler-errors-2/compiler-error-c3131.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3132.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3133.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3140.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3141.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3142.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3145.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3149.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3152.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3153.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3154.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3155.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3156.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3160.md | 2 +- 14 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md index 27b316fe6f0..45a3a3c3e4d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md @@ -16,7 +16,7 @@ The [module](../../windows/attributes/module-cpp.md) attribute must have a name ## Example -The following sample generates C3131: +The following example generates C3131: ```cpp // 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 index 590ce96e0eb..db542839905 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3132.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3132.md @@ -16,7 +16,7 @@ The attribute was applied to a parameter that ## Example -The following sample generates C3132: +The following example generates C3132: ```cpp // 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 index 54bc1be03cf..258bee5b438 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3133.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3133.md @@ -18,7 +18,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3133. +The following example generates C3133. ```cpp // C3133.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 index e15fbd083cb..9cdae760d41 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3140.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3140.md @@ -16,7 +16,7 @@ The [module](../../windows/attributes/module-cpp.md) attribute can only be defin ## Example -The following sample generates C3140: +The following example generates C3140: ```cpp // 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 index b75d64eabc6..d8fdd5aa0b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3141.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3141.md @@ -16,7 +16,7 @@ Interfaces defined with the [interface (or __interface)](../../cpp/interface.md) ## Example -The following sample generates C3141: +The following example generates C3141: ```cpp // 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 index fa1c98bf1bc..bb96af1a7ae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3142.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3142.md @@ -16,7 +16,7 @@ The address of a property is not available to the developer. ## Example -The following sample generates C3142: +The following example generates C3142: ```cpp // C3142_2.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 index 27c37a0c321..e51eb4906a5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3145.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3145.md @@ -16,7 +16,7 @@ You can only define CLR or WinRT objects within function scope. ## Examples -The following sample generates C3145 and shows how to fix it: +The following example generates C3145 and shows how to fix it: ```cpp // C3145.cpp @@ -39,7 +39,7 @@ int main() { } ``` -The following sample generates C3145: +The following example generates C3145: ```cpp // C3145b.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 index 95610b0e572..af88501c3f1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3149.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3149.md @@ -20,7 +20,7 @@ To resolve this error, declare variables of CLR types inside a function or type ## Examples -The following sample generates C3149: +The following example generates C3149: ```cpp // C3149.cpp @@ -33,7 +33,7 @@ int main() { } ``` -The following sample generates C3149: +The following example generates C3149: ```cpp // C3149b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3152.md b/docs/error-messages/compiler-errors-2/compiler-error-c3152.md index 0027381af2c..9fc6aebf8f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3152.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3152.md @@ -16,7 +16,7 @@ Certain keywords can only be applied to a C++ class. ## Example -The following sample generates C3152 and shows how to fix it: +The following example generates C3152 and shows how to fix it: ```cpp // C3152.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 index f9262c03c4c..c472a3c4846 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3153.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3153.md @@ -16,7 +16,7 @@ An interface cannot be instantiated. To use the members of an interface, derive ## Example -The following sample generates C3153: +The following example generates C3153: ```cpp // 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 index a36924aa57b..51771371cef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3154.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3154.md @@ -18,7 +18,7 @@ For more information, see [Variable Argument Lists (...) (C++/CLI)](../../extens ## Example -The following sample generates C3154. +The following example generates C3154. ```cpp // C3154.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3155.md b/docs/error-messages/compiler-errors-2/compiler-error-c3155.md index 87c5fe89b71..aca1c4babbc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3155.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3155.md @@ -16,7 +16,7 @@ An indexed property was declared incorrectly. For more information, see [How to: ## Example -The following sample generates C3155. +The following example generates C3155. ```cpp // C3155.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3156.md b/docs/error-messages/compiler-errors-2/compiler-error-c3156.md index 8d8498df139..28a87eb518f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3156.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3156.md @@ -16,7 +16,7 @@ A function cannot contain the definition, or declaration, of a managed or WinRT ## Example -The following sample generates C3156. +The following example generates C3156. ```cpp // C3156.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3160.md b/docs/error-messages/compiler-errors-2/compiler-error-c3160.md index 9eafcf78c36..3d47866c30e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3160.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3160.md @@ -16,7 +16,7 @@ Interior garbage collection pointers may point to the interior of a managed or W ## Example -The following sample generates C3160: +The following example generates C3160: ```cpp // C3160.cpp From c314fd6a496988d07bdccf405fc2bdb1b8d9a8ff Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 14 Aug 2025 22:44:06 +0800 Subject: [PATCH 0778/1799] Update metadata for error references in range [C3131, C3160] --- .../error-messages/compiler-errors-2/compiler-error-c3131.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3132.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3133.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3134.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3135.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3136.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3137.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3138.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3139.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3140.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3141.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3142.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3145.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3149.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3150.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3152.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3153.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3154.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3155.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3156.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3157.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3159.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3160.md | 5 ++--- 23 files changed, 46 insertions(+), 69 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md index 45a3a3c3e4d..6206cebbdfa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3131" title: "Compiler Error C3131" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3131" +ms.date: 11/04/2016 f1_keywords: ["C3131"] helpviewer_keywords: ["C3131"] -ms.assetid: 38f20fac-83c9-4cd9-b7b5-74ca8f650ea6 --- # Compiler Error C3131 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3132.md b/docs/error-messages/compiler-errors-2/compiler-error-c3132.md index db542839905..83bbc2fe187 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3132.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3132.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3132" title: "Compiler Error C3132" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3132" +ms.date: 11/04/2016 f1_keywords: ["C3132"] helpviewer_keywords: ["C3132"] -ms.assetid: d54a3d12-336a-4ed0-ad4e-43cddac33b5e --- # Compiler Error C3132 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3133.md b/docs/error-messages/compiler-errors-2/compiler-error-c3133.md index 258bee5b438..cb737253640 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3133.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3133.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3133" title: "Compiler Error C3133" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3133" +ms.date: 11/04/2016 f1_keywords: ["C3133"] helpviewer_keywords: ["C3133"] -ms.assetid: 4a709405-b67b-4061-8a2a-19fa5fb34a2a --- # Compiler Error C3133 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3134.md b/docs/error-messages/compiler-errors-2/compiler-error-c3134.md index 1c14ebca3dd..ee6d5ab7c78 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3134.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3134.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3134" title: "Compiler Error C3134" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3134" +ms.date: 11/04/2016 f1_keywords: ["C3134"] helpviewer_keywords: ["C3134"] -ms.assetid: f887e4d2-7740-49e4-9972-7edceb8fa77b --- # Compiler Error C3134 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3135.md b/docs/error-messages/compiler-errors-2/compiler-error-c3135.md index 53d469d7af7..9e421773ca1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3135.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3135.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3135" title: "Compiler Error C3135" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3135" +ms.date: 11/04/2016 f1_keywords: ["C3135"] helpviewer_keywords: ["C3135"] -ms.assetid: e92ee007-5a26-47f4-8ef4-339f2d9528d1 --- # Compiler Error C3135 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3136.md b/docs/error-messages/compiler-errors-2/compiler-error-c3136.md index 89bd042d3a3..6a3a0d24b47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3136.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3136.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3136" title: "Compiler Error C3136" -ms.date: "10/03/2018" +description: "Learn more about: Compiler Error C3136" +ms.date: 10/03/2018 f1_keywords: ["C3136"] helpviewer_keywords: ["C3136"] -ms.assetid: c77103cd-00f7-408e-b74b-4f8562039d31 --- # Compiler Error C3136 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3137.md b/docs/error-messages/compiler-errors-2/compiler-error-c3137.md index 84de4d4a588..6e731bc7062 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3137.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3137.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3137" title: "Compiler Error C3137" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3137" +ms.date: 11/04/2016 f1_keywords: ["C3137"] helpviewer_keywords: ["C3137"] -ms.assetid: 70bb1313-2e87-43ed-a0d8-33fa6ff475e4 --- # Compiler Error C3137 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3138.md b/docs/error-messages/compiler-errors-2/compiler-error-c3138.md index b741b192c29..d7f229b6067 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3138.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3138.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3138" title: "Compiler Error C3138" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3138" +ms.date: 11/04/2016 f1_keywords: ["C3138"] helpviewer_keywords: ["C3138"] -ms.assetid: 364ee9e8-9358-410e-bd35-9c4a226a3753 --- # Compiler Error C3138 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3139.md b/docs/error-messages/compiler-errors-2/compiler-error-c3139.md index 4f3e20b3f0a..2fd93ca5493 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3139.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3139.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3139" title: "Compiler Error C3139" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3139" +ms.date: 11/04/2016 f1_keywords: ["C3139"] helpviewer_keywords: ["C3139"] -ms.assetid: 95c92263-10ac-4ff3-b385-6312dd92adbc --- # Compiler Error C3139 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3140.md b/docs/error-messages/compiler-errors-2/compiler-error-c3140.md index 9cdae760d41..6141df55509 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3140.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3140.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3140" title: "Compiler Error C3140" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3140" +ms.date: 11/04/2016 f1_keywords: ["C3140"] helpviewer_keywords: ["C3140"] -ms.assetid: 122f8943-fac3-4db8-a3a8-2c5d19233de6 --- # Compiler Error C3140 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3141.md b/docs/error-messages/compiler-errors-2/compiler-error-c3141.md index d8fdd5aa0b5..a46f2847091 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3141.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3141.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3141" title: "Compiler Error C3141" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3141" +ms.date: 11/04/2016 f1_keywords: ["C3141"] helpviewer_keywords: ["C3141"] -ms.assetid: b4fd65c3-50cc-46cd-8de0-6a6d24cb9cda --- # Compiler Error C3141 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3142.md b/docs/error-messages/compiler-errors-2/compiler-error-c3142.md index bb96af1a7ae..ac7aaeb13d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3142.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3142.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3142" title: "Compiler Error C3142" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3142" +ms.date: 11/04/2016 f1_keywords: ["C3142"] helpviewer_keywords: ["C3142"] -ms.assetid: 795137ad-d00a-4a9c-9665-0cd8bfb5da8b --- # Compiler Error C3142 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3145.md b/docs/error-messages/compiler-errors-2/compiler-error-c3145.md index e51eb4906a5..fad9fdabf3f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3145.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3145.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3145" title: "Compiler Error C3145" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3145" +ms.date: 11/04/2016 f1_keywords: ["C3145"] helpviewer_keywords: ["C3145"] -ms.assetid: f165c874-0f51-45c7-85e8-ebe321cbc168 --- # Compiler Error C3145 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3149.md b/docs/error-messages/compiler-errors-2/compiler-error-c3149.md index af88501c3f1..241585d1b14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3149.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3149.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3149" title: "Compiler Error C3149" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3149" +ms.date: 11/04/2016 f1_keywords: ["C3149"] helpviewer_keywords: ["C3149"] -ms.assetid: cf6e2616-2f06-46da-8a8a-d449cb481c51 --- # Compiler Error C3149 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3150.md b/docs/error-messages/compiler-errors-2/compiler-error-c3150.md index 990b6b1409e..2c26b49381a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3150.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3150.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3150" title: "Compiler Error C3150" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3150" +ms.date: 11/04/2016 f1_keywords: ["C3150"] helpviewer_keywords: ["C3150"] -ms.assetid: c1ff28f5-52fe-4fd4-81d0-2e0ad8548631 --- # Compiler Error C3150 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3152.md b/docs/error-messages/compiler-errors-2/compiler-error-c3152.md index 9fc6aebf8f8..6372b7c33e0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3152.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3152.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3152" title: "Compiler Error C3152" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3152" +ms.date: 11/04/2016 f1_keywords: ["C3152"] helpviewer_keywords: ["C3152"] -ms.assetid: 4ee6e2cd-5d19-4b73-833d-765c35797e4b --- # Compiler Error C3152 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3153.md b/docs/error-messages/compiler-errors-2/compiler-error-c3153.md index c472a3c4846..8f85face4cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3153.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3153.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3153" title: "Compiler Error C3153" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3153" +ms.date: 11/04/2016 f1_keywords: ["C3153"] helpviewer_keywords: ["C3153"] -ms.assetid: d775d97e-2480-484f-81f1-88406b10f947 --- # Compiler Error C3153 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3154.md b/docs/error-messages/compiler-errors-2/compiler-error-c3154.md index 51771371cef..6d9110b55cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3154.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3154.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3154" title: "Compiler Error C3154" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3154" +ms.date: 11/04/2016 f1_keywords: ["C3154"] helpviewer_keywords: ["C3154"] -ms.assetid: 78005c74-eaaf-4ac2-88ae-6c25d01a302a --- # Compiler Error C3154 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3155.md b/docs/error-messages/compiler-errors-2/compiler-error-c3155.md index aca1c4babbc..8fadcc0c30c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3155.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3155.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3155" title: "Compiler Error C3155" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3155" +ms.date: 11/04/2016 f1_keywords: ["C3155"] helpviewer_keywords: ["C3155"] -ms.assetid: b04a42e1-64e7-40f8-81fe-c7945348b2cf --- # Compiler Error C3155 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3156.md b/docs/error-messages/compiler-errors-2/compiler-error-c3156.md index 28a87eb518f..8f70a06967b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3156.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3156.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3156" title: "Compiler Error C3156" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3156" +ms.date: 11/04/2016 f1_keywords: ["C3156"] helpviewer_keywords: ["C3156"] -ms.assetid: 1876da78-b94e-4af7-9795-28f72b209b3e --- # Compiler Error C3156 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3157.md b/docs/error-messages/compiler-errors-2/compiler-error-c3157.md index b5ef09dc744..445bf3ff9ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3157.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3157.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3157" title: "Compiler Error C3157" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3157" +ms.date: 11/04/2016 f1_keywords: ["C3157"] helpviewer_keywords: ["C3157"] -ms.assetid: fe94d97f-612e-4729-8b2b-b057d84822a1 --- # Compiler Error C3157 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3159.md b/docs/error-messages/compiler-errors-2/compiler-error-c3159.md index 1ff1fe92982..c1090d08ec0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3159.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3159.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3159" title: "Compiler Error C3159" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3159" +ms.date: 11/04/2016 f1_keywords: ["C3159"] helpviewer_keywords: ["C3159"] -ms.assetid: e115cc76-0021-4568-95fd-61a324c41a85 --- # Compiler Error C3159 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3160.md b/docs/error-messages/compiler-errors-2/compiler-error-c3160.md index 3d47866c30e..a509272d5a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3160.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3160.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3160" title: "Compiler Error C3160" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3160" +ms.date: 11/04/2016 f1_keywords: ["C3160"] helpviewer_keywords: ["C3160"] -ms.assetid: a250c433-8adf-43b9-8dee-c3794e09b0a5 --- # Compiler Error C3160 From d9b16697cc04cc30bec2725f81125201cea082ec Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Thu, 14 Aug 2025 10:24:22 -0700 Subject: [PATCH 0779/1799] Update docs/sanitizers/asan-flags.md Remove duplicate word "supported" Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 98a4f5a4aaf..cc8f94e7fda 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Add # AddressSanitizer Runtime Options -The following is a list of supported actively supported options for the AddressSanitizer. They can be enabled through the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function, as described [here](/asan-runtime.md#runtime-options). +The following is a list of actively supported options for the AddressSanitizer. They can be enabled through the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function, as described [here](/asan-runtime.md#runtime-options). > [!NOTE] > These descriptions may vary from those found in Clang's ASan docs to account for MSVC specific behaviors. From 358044b4fd343cea45b4fa188002f3a9efbddf57 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Thu, 14 Aug 2025 10:30:16 -0700 Subject: [PATCH 0780/1799] Update docs/sanitizers/asan-runtime.md Fix typo Co-authored-by: David Justo --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 777d3e2be46..43b091af085 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -101,7 +101,7 @@ For an illustration of the alignment requirement and potential issues, see the p ## Runtime options -The MSVC AddressSanitizer is a regularly synced fork of the [Clang AddressSanitizer runtime](https://github.com/llvm/llvm-project). As a result, MSVC implicitly inherits many Clang's ASan runtime options. A complete list of options that we actively maintain and test can be found [here](./asan-flags.md). If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). +The MSVC AddressSanitizer is a regularly synced fork of the [Clang AddressSanitizer runtime](https://github.com/llvm/llvm-project). As a result, MSVC implicitly inherits many of Clang's ASan runtime options. A complete list of options that we actively maintain and test can be found [here](./asan-flags.md). If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). ### Configure runtime options From 2c9e9b51cc612bf28edc0c7b72e38b86146d0736 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Thu, 14 Aug 2025 10:32:17 -0700 Subject: [PATCH 0781/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index cc8f94e7fda..98550be693c 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -12,8 +12,6 @@ The following is a list of actively supported options for the AddressSanitizer. > [!NOTE] > These descriptions may vary from those found in Clang's ASan docs to account for MSVC specific behaviors. -If you discover documentation errors, report them [here](https://aka.ms/feedback/report?space=62). - | Flag | Default value | Description | |------|---------------|-------------| From 4aecc9b6f09bb7caddb93c3560ce2ca5912d3f80 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Thu, 14 Aug 2025 10:32:33 -0700 Subject: [PATCH 0782/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 98550be693c..f61bb470edf 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Add The following is a list of actively supported options for the AddressSanitizer. They can be enabled through the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function, as described [here](/asan-runtime.md#runtime-options). > [!NOTE] -> These descriptions may vary from those found in Clang's ASan docs to account for MSVC specific behaviors. +> These descriptions may vary from those in Clang's ASan docs to account for MSVC specific behaviors. | Flag | Default value | Description | From dcf021f50b959da95f625b5276a1b7649a9ff9df Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Thu, 14 Aug 2025 11:33:44 -0700 Subject: [PATCH 0783/1799] Remove flags for later commit --- docs/sanitizers/asan-flags.md | 18 ------------------ 1 file changed, 18 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 98a4f5a4aaf..dbe442f5695 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -25,18 +25,13 @@ If you discover documentation errors, report them [here](https://aka.ms/feedback |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned.| |`atexit` | `false` | If `true`, prints ASan exit stats even after program terminates successfully.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| -|`check_malloc_usable_size` | `true` | If `true`, reports an error when the pointer does not reference a valid, currently allocated block.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If >`0`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects. Higher values increase detection effort.| -|`detect_odr_violation` | `0` | If >=`2`, detect violation of One-Definition-Rule (ODR) violation; If `1`, detect ODR-violation only if the two variables have different sizes.| |`detect_stack_use_after_return` | `false` | Enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`disable_coredump` | `true`/`false` (on non-64-bit systems) | Disables core dumping. By default, the tool sets `disable_coredump=1` on 64-bit systems to prevent dumping a 16T+ core file. The tool ignores this flag on operating systems that don't dump core by default and for sanitizers that don't reserve large amounts of virtual memory.| -|`dump_instruction_bytes` | `false` | If `true`, dump 16 bytes starting at the instruction that caused `SEGV`.| |`exitcode` | `1` | Override the program exit status with this value if the tool found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, the tool will search `$PATH` for the symbolizer.| -|`fast_unwind_on_check` | `false` | If available, the tool uses the fast frame-pointer-based unwinder on internal `CHECK` failures.| -|`fast_unwind_on_fatal` | `false` | If available, the tool uses the fast frame-pointer-based unwinder on fatal errors.| |`fast_unwind_on_malloc` | `true` | If available, the tool uses the fast frame-pointer-based unwinder on `malloc`/`free`.| |`full_address_space` | `false` | Sanitize complete address space; by default kernel area on 32-bit platforms will not be sanitized.| |`halt_on_error` | `true` | Exit/abort the program after printing the first error report (May cause undefined behavior, use `continue_on_error` for full support).| @@ -44,7 +39,6 @@ If you discover documentation errors, report them [here](https://aka.ms/feedback |`handle_sigfpe` | `true` | `false` - ASan will not handle `SIGFPE` errors, `true` - ASan will handle `SIGFPE` errors.| |`handle_sigill` | `true` | `false` - ASan will not handle `SIGILL` errors, `true` - ASan will handle `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to console.| -|`html_cov_report` | `false` | If `true`, ASan generates a coverage report.| |`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include_if_exists` | `""` | Read more options from the given file (if it exists).| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for strpbrk function to find more errors.| @@ -57,28 +51,19 @@ If you discover documentation errors, report them [here](https://aka.ms/feedback |`malloc_fill_byte` | `0xbe` | Value used to fill the newly allocated memory.| |`max_malloc_fill_size` | `4096` | ASan allocator flag. `max_malloc_fill_size` is the maximal amount of bytes that will be filled with `malloc_fill_byte` on `malloc`.| |`max_redzone` | `2048` | Maximal size (in bytes) of redzones around heap objects.| -|`max_uar_stack_size_log` | `20` | Maximum fake stack size log.| |`min_uar_stack_size_log` | `16` | Minimum fake stack size log. (Minimum value accepted: `16`).| |`new_delete_type_mismatch` | `true` | Report errors on mismatch betwen size of new and delete. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| -|`poison_array_cookie` | `true` | Poison (or not) the array cookie after operator `new[]`.| |`poison_heap` | `true` | Poison (or not) the heap memory on [de]allocation. Zero value is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| -|`print_full_thread_history` | `true` | If `true`, prints thread creation stacks for the threads involved in the report and their ancestors up to the main thread.| -|`print_legend` | `true` | Print the legend for the shadow bytes.| -|`print_stats` | `false` | Print various statistics after printing an error message or if atexit=1.| |`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| -|`protect_shadow_gap` | `true` | If `true`, `mprotect` the shadow gap.| |`quarantine_size` | `-1` | Deprecated, please use `quarantine_size_mb`.| |`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| |`redzone` | `16` | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| -|`replace_intrin` | `true` | If `true`, uses custom wrappers for `memset` or `memcpy` or `memmove` intinsics.| |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| |`report_globals` | `1` | Controls the way to handle globals (`0` - don't detect buffer overflow on globals, `1` - detect buffer overflow, `2` - detect buffer overflow and print data about registered globals).| -|`sancov_path` | `sancov` | Sancov tool location.| |`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.| |`stack_trace_format` | `DEFAULT` | Format string used to render stack frames.| -|`start_deactivated` | `false` | If `true`, preserves configuration and allocator, and deactivates ASan at initialization. ASan will reactivate when requested.| |`strict_memcmp` | `true` | If `true`, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| |`strict_string_checks` | `false` | If `true` check that string arguments are properly null-terminated.| |`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| @@ -86,9 +71,6 @@ If you discover documentation errors, report them [here](https://aka.ms/feedback |`suppressions` | `""` | Suppresses file name.| |`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses to file or line locations.| |`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| -|`symbolize_vs_style` | `false` | Print file locations in Visual Studio style (e.g: file(10,42): ...).| -|`unmap_shadow_on_exit` | `false` | If `true`, explicitly unmaps the shadow memory at exit.| -|`use_madv_dontdump` | `true` | If `true`, instructs kernel to not store shadow in core file.| |`verbosity` | `0` | Verbosity level: `0` - default, `1` - more, `2+` - even more output.| |`windows_fast_fail_on_error`|`false`|If `true`, enable the process to terminate with a `__fastfail(71)` after printing the error report. See [windows_fast_fail_on_error](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`windows_hook_legacy_allocators`|`true`|If `true`, enable hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| From a1bd6fc8bca7a7b7f22c30c0b3c51ac8b2a42747 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Thu, 14 Aug 2025 11:33:57 -0700 Subject: [PATCH 0784/1799] Fix linking --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index dbe442f5695..75fb8b9bc4f 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Add # AddressSanitizer Runtime Options -The following is a list of supported actively supported options for the AddressSanitizer. They can be enabled through the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function, as described [here](/asan-runtime.md#runtime-options). +The following is a list of supported actively supported options for the AddressSanitizer. They can be enabled through the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function, as described [here](./asan-runtime.md#runtime-options). > [!NOTE] > These descriptions may vary from those found in Clang's ASan docs to account for MSVC specific behaviors. From 013292ca980791adf2d4ba55b4e4889d4bdd4bcf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 16:23:20 +0800 Subject: [PATCH 0785/1799] Add "Remarks" heading in C3187 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3187.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md index 4ef3efeedb4..67cebe86c14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md @@ -10,6 +10,8 @@ ms.assetid: 9d2ebf55-1a6a-4087-bf5b-5274baae6351 > '`__func__`' : is only available within the body of a function +## Remarks + The predefined macro is not available outside the body of a function. To correct this error, move the macro inside the body of a function. From 59adf3ebac46a3349c44a08d456ecfc36a53608e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 16:27:18 +0800 Subject: [PATCH 0786/1799] Add link and tweak remarks in C3187 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3187.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md index 67cebe86c14..8195456820c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md @@ -12,6 +12,6 @@ ms.assetid: 9d2ebf55-1a6a-4087-bf5b-5274baae6351 ## Remarks -The predefined macro is not available outside the body of a function. +The predefined identifier [`__func__`](../../cpp/func.md) is not available outside the body of a function. -To correct this error, move the macro inside the body of a function. +To correct this error, move the identifier inside the body of a function. From 6f6a2b240d9c8e4966fade4c9758a6f92ea06a39 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 16:42:35 +0800 Subject: [PATCH 0787/1799] Add example in C3187 error reference --- .../compiler-errors-2/compiler-error-c3187.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md index 8195456820c..e82957b16eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md @@ -15,3 +15,16 @@ ms.assetid: 9d2ebf55-1a6a-4087-bf5b-5274baae6351 The predefined identifier [`__func__`](../../cpp/func.md) is not available outside the body of a function. To correct this error, move the identifier inside the body of a function. + +## Example + +The following example generates C3187: + +```cpp +// C3187.cpp +// compile with: /c + +auto global = __func__; // C3187, usage in global scope + +void func(const char* f = __func__); // C3187, usage in parameter list +``` From 6ffde87dfebbc768e32977c90ac877b0663f0e16 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 16:50:32 +0800 Subject: [PATCH 0788/1799] Update error message for C3187 --- docs/error-messages/compiler-errors-2/compiler-error-c3187.md | 2 +- .../compiler-errors-2/compiler-errors-c3100-through-c3199.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md index e82957b16eb..423bc277df2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md @@ -8,7 +8,7 @@ ms.assetid: 9d2ebf55-1a6a-4087-bf5b-5274baae6351 --- # Compiler Error C3187 -> '`__func__`' : is only available within the body of a function +> '`__func__`': is only available within the body of a function ## Remarks diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md b/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md index 338e4eceb9f..d9fb3719199 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md @@ -102,7 +102,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C3184 | Obsolete. | | [Compiler error C3185](compiler-error-c3185.md) | 'typeid': used on managed/WinRT type '*type*', use '*operator*' instead | | Compiler error C3186 | Obsolete. | -| [Compiler error C3187](compiler-error-c3187.md) | '*identifier*': is only available within the body of a function | +| [Compiler error C3187](compiler-error-c3187.md) | '`__func__`': is only available within the body of a function | | Compiler error C3188 | Obsolete. | | [Compiler error C3189](compiler-error-c3189.md) | 'typeid<*declarator*>': this syntax is no longer supported, use::typeid instead (Obsolete in Visual Studio 2022.) | | [Compiler error C3190](compiler-error-c3190.md) | '*declarator*' with the provided template arguments is not the explicit instantiation of any member function of '*type*' | From ac6165812a63146a1071bd3f23e272458a22d8bd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 16:52:39 +0800 Subject: [PATCH 0789/1799] Update metadata in 2 error reference topics --- .../error-messages/compiler-errors-2/compiler-error-c3187.md | 5 ++--- .../compiler-errors-2/compiler-errors-c3100-through-c3199.md | 2 +- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md index 423bc277df2..f4f244b6d9b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3187" title: "Compiler Error C3187" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3187" +ms.date: 08/15/2025 f1_keywords: ["C3187"] helpviewer_keywords: ["C3187"] -ms.assetid: 9d2ebf55-1a6a-4087-bf5b-5274baae6351 --- # Compiler Error C3187 diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md b/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md index d9fb3719199..92e4a1b994d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler errors C3100 Through C3199" title: "Compiler errors C3100 Through C3199" +description: "Learn more about: Compiler errors C3100 Through C3199" ms.date: 06/01/2022 f1_keywords: ["C3102", "C3105", "C3107", "C3108", "C3109", "C3111", "C3112", "C3119", "C3122", "C3123", "C3124", "C3125", "C3127", "C3128", "C3129", "C3143", "C3144", "C3146", "C3147", "C3148", "C3151", "C3158", "C3164", "C3165", "C3169", "C3177", "C3178", "C3184", "C3186", "C3188", "C3191", "C3193"] helpviewer_keywords: ["C3102", "C3105", "C3107", "C3108", "C3109", "C3111", "C3112", "C3119", "C3122", "C3123", "C3124", "C3125", "C3127", "C3128", "C3129", "C3143", "C3144", "C3146", "C3147", "C3148", "C3151", "C3158", "C3164", "C3165", "C3169", "C3177", "C3178", "C3184", "C3186", "C3188", "C3191", "C3193"] From b8cdb92469c34f627b1d06021876c92c8cb9e24d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 16:58:16 +0800 Subject: [PATCH 0790/1799] Add C2457 "See also" link in C3187 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3187.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md index f4f244b6d9b..3710ca2abe3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md @@ -27,3 +27,7 @@ auto global = __func__; // C3187, usage in global scope void func(const char* f = __func__); // C3187, usage in parameter list ``` + +## See also + +[C2457](../compiler-errors-1/compiler-error-c2457.md) From e8176e8a6166c5392fbcdcbfcb6cf0b5e6e35383 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 17:06:53 +0800 Subject: [PATCH 0791/1799] Add blockquotes for error messages in range [C3161, C3190] --- docs/error-messages/compiler-errors-2/compiler-error-c3161.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3162.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3167.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3168.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3170.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3171.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3172.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3173.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3174.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3175.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3176.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3179.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3180.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3181.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3182.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3183.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3185.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3190.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md index 2dbb59b9051..991e931306f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md @@ -8,7 +8,7 @@ ms.assetid: 1fe2be85-a343-487b-8476-bf9e257eb29d --- # Compiler Error C3161 -'interface' : nesting class, struct, union or interface in an interface is illegal; nesting interface in a class, struct or union is illegal +> 'interface' : nesting class, struct, union or interface in an interface is illegal; nesting interface in a class, struct or union is illegal 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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3162.md b/docs/error-messages/compiler-errors-2/compiler-error-c3162.md index 6c059c9c65b..9386770e773 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3162.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3162.md @@ -8,7 +8,7 @@ ms.assetid: 0d4c4a24-1456-4191-b7d8-c38cb7b17c32 --- # Compiler Error C3162 -'type' : a reference type which has a destructor cannot be used as the type of static data member 'member' +> 'type' : a reference type which has a destructor cannot be used as the type of static data member 'member' The common language runtime cannot know when to run a user-defined destructor when the class also contains static member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3167.md b/docs/error-messages/compiler-errors-2/compiler-error-c3167.md index 32c75e4d421..693c0b3ac19 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3167.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3167.md @@ -8,6 +8,6 @@ ms.assetid: 58c25fe7-8562-4a18-ad3f-487f081ff173 --- # Compiler Error C3167 -Unable to initialize .NET Framework: make sure it is installed +> Unable to initialize .NET Framework: make sure it is installed 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 index bdfd093a15a..74facf3e018 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3168.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3168.md @@ -8,7 +8,7 @@ ms.assetid: 4c36fcfb-c351-48ff-b4eb-78d2aa1b4d55 --- # Compiler Error C3168 -'type' : illegal underlying type for enum +> 'type' : illegal underlying type for enum 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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3170.md b/docs/error-messages/compiler-errors-2/compiler-error-c3170.md index 10e9b317c49..ec13b962453 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3170.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3170.md @@ -8,7 +8,7 @@ ms.assetid: ca9a59d6-7df3-42f0-b028-c09d0af3ac2a --- # Compiler Error C3170 -cannot have different module identifiers in a project +> cannot have different module identifiers in a project [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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3171.md b/docs/error-messages/compiler-errors-2/compiler-error-c3171.md index b51a5d11dd0..9d30d186bfd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3171.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3171.md @@ -8,7 +8,7 @@ ms.assetid: 1ce26997-7ef1-4c9f-84da-003ea1a4251e --- # Compiler Error C3171 -'module': cannot specify different module attributes in a project +> 'module': cannot specify different module attributes in a project [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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3172.md b/docs/error-messages/compiler-errors-2/compiler-error-c3172.md index 832aaa9c403..3513160527f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3172.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3172.md @@ -8,7 +8,7 @@ ms.assetid: 1834e2fd-6036-4c33-aff2-b51bc7c99441 --- # Compiler Error C3172 -'module_name': cannot specify different idl_module attributes in a project +> 'module_name': cannot specify different idl_module attributes in a project [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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3173.md b/docs/error-messages/compiler-errors-2/compiler-error-c3173.md index 264132ec13c..9cc86a69910 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3173.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3173.md @@ -8,7 +8,7 @@ ms.assetid: edf79e10-e8cf-4f76-8d33-ab9d05e974e9 --- # Compiler Error C3173 -version mismatch in idl merge +> version mismatch in idl merge 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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3174.md b/docs/error-messages/compiler-errors-2/compiler-error-c3174.md index 43fbd18675c..497ccf61930 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3174.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3174.md @@ -8,7 +8,7 @@ ms.assetid: fe6b3b5a-8196-485f-a45f-0b2e51df4086 --- # Compiler Error C3174 -module attribute was not specified +> module attribute was not specified 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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3175.md b/docs/error-messages/compiler-errors-2/compiler-error-c3175.md index 410de47bc69..2a56f53b737 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3175.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3175.md @@ -8,7 +8,7 @@ ms.assetid: 3f19d513-a05a-4b6c-806f-276fe5c36b90 --- # Compiler Error C3175 -'function1' : cannot call a method of a managed type from unmanaged function 'function2' +> 'function1' : cannot call a method of a managed type from unmanaged function 'function2' Unmanaged functions cannot call member functions of managed classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3176.md b/docs/error-messages/compiler-errors-2/compiler-error-c3176.md index 9252c20ad4c..c729636822b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3176.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3176.md @@ -8,7 +8,7 @@ ms.assetid: 6cc8d602-8e15-47a7-b1b5-e93e5d50e271 --- # Compiler Error C3176 -'type' : cannot declare local value type +> 'type' : cannot declare local value type A class can only be declared as a value type at global scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3179.md b/docs/error-messages/compiler-errors-2/compiler-error-c3179.md index 3ae78d152d7..41ff42fa850 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3179.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3179.md @@ -8,7 +8,7 @@ ms.assetid: 60d7e41b-25fd-48ac-8b79-830c062f4dcd --- # Compiler Error C3179 -an unnamed managed or WinRT type is not allowed +> an unnamed managed or WinRT type is not allowed All CLR and WinRT classes and structs must have names. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3180.md b/docs/error-messages/compiler-errors-2/compiler-error-c3180.md index 7c795d00663..10d2a51f022 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3180.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3180.md @@ -8,7 +8,7 @@ ms.assetid: 5281f583-7df7-418a-8507-d4da67ed6572 --- # Compiler Error C3180 -'type name' : name exceeds meta-data limit of 'limit' characters +> 'type name' : name exceeds meta-data limit of 'limit' characters 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). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3181.md b/docs/error-messages/compiler-errors-2/compiler-error-c3181.md index 1af9f7eccf5..2f49d519bda 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3181.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3181.md @@ -8,7 +8,7 @@ ms.assetid: 5d450f8b-6cef-4452-a0c4-2076e967451d --- # Compiler Error C3181 -'type' : invalid operand for operator +> 'type' : invalid operand for operator An invalid parameter was passed to the [typeid](../../extensions/typeid-cpp-component-extensions.md) operator. The parameter must be a managed type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3182.md b/docs/error-messages/compiler-errors-2/compiler-error-c3182.md index 9c3772dff9c..671e7498dbb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3182.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3182.md @@ -8,7 +8,7 @@ ms.assetid: f3681266-308e-4990-a979-8eef8920e186 --- # Compiler Error C3182 -'class' : a member using-declaration or access declaration is illegal within a managed or WinRTtype +> 'class' : a member using-declaration or access declaration is illegal within a managed or WinRTtype A [using](../../cpp/using-declaration.md) declaration is invalid within all forms of managed classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3183.md b/docs/error-messages/compiler-errors-2/compiler-error-c3183.md index 82ad13cdc56..9671cafe292 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3183.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3183.md @@ -8,7 +8,7 @@ ms.assetid: dbd0f020-c739-43c9-947e-9ce21537331b --- # Compiler Error C3183 -cannot define unnamed class, struct or union inside of managed or WinRT type 'type' +> cannot define unnamed class, struct or union inside of managed or WinRT type 'type' A type that is embedded in a managed or WinRT type must be named. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3185.md b/docs/error-messages/compiler-errors-2/compiler-error-c3185.md index 315365082c0..2707c1c2e11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3185.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3185.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3185"] --- # Compiler Error C3185 -'typeid' used on managed or WinRT type 'type', use 'operator' instead +> 'typeid' used on managed or WinRT type 'type', use 'operator' instead 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. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3190.md b/docs/error-messages/compiler-errors-2/compiler-error-c3190.md index a1fd356cb1b..38205552a70 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3190.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3190.md @@ -8,7 +8,7 @@ ms.assetid: 7c701afa-85a7-4f7a-8881-0662436ac244 --- # Compiler Error C3190 -'instantiation' with the provided template arguments is not the explicit instantiation of any member function of 'type' +> 'instantiation' with the provided template arguments is not the explicit instantiation of any member function of 'type' The compiler detected an attempt to make an explicit function instantiation; however, the provided type arguments do not match any of the possible functions. From 6a07aa00f3eb327ede2c32c2710254567b98dc3f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 17:11:39 +0800 Subject: [PATCH 0792/1799] Add "Remarks" and "Example" headings for error references in range [C3161, C3190] --- docs/error-messages/compiler-errors-2/compiler-error-c3161.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3162.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3163.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3166.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3167.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3168.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3170.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3171.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3172.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3173.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3174.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3175.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3176.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3179.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3180.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3181.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3182.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3183.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3185.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3189.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3190.md | 4 ++++ 21 files changed, 68 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md index 991e931306f..564664f7420 100644 --- 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 index 9386770e773..1bb409fb67d 100644 --- 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 index efd0231c211..21303a4e941 100644 --- 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 index 6b12aa26515..557ea5648e0 100644 --- 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 index 693c0b3ac19..28e910770ae 100644 --- 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 index 74facf3e018..325b4e3f236 100644 --- 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 index ec13b962453..faa2901e65a 100644 --- 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 index 9d30d186bfd..77238ce11aa 100644 --- 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 index 3513160527f..574b5de0abc 100644 --- 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 index 9cc86a69910..a981f2b87bf 100644 --- 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 index 497ccf61930..0d8d2e05fcd 100644 --- 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 index 2a56f53b737..486f6c8e80d 100644 --- 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 index c729636822b..fda80d05602 100644 --- 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 index 41ff42fa850..2540286635c 100644 --- 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 index 10d2a51f022..c9602acccfa 100644 --- 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 index 2f49d519bda..7abc923cfdd 100644 --- 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 index 671e7498dbb..5f81b0a9ea2 100644 --- 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 index 9671cafe292..f17d2a52d57 100644 --- 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 index 2707c1c2e11..8b70e19e327 100644 --- 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 index 6197c274ae7..4772b5d19bf 100644 --- 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\': 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 index 38205552a70..5692d8f5826 100644 --- 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 From a302c74ea71a1bae855726ede7cf574bd4014301 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 17:14:09 +0800 Subject: [PATCH 0793/1799] Replace term "sample" with "example" for error references in range [C3161, C3190] --- docs/error-messages/compiler-errors-2/compiler-error-c3161.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3162.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3163.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3168.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3174.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3175.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3176.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3179.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3181.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3182.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3183.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3185.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3189.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3190.md | 2 +- 14 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md index 564664f7420..10778f1ef23 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md @@ -16,7 +16,7 @@ An [__interface](../../cpp/interface.md) can only appear at global scope or with ## Example -The following sample generates C3161. +The following example generates C3161. ```cpp // C3161.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3162.md b/docs/error-messages/compiler-errors-2/compiler-error-c3162.md index 1bb409fb67d..a1b5f9b3336 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3162.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3162.md @@ -24,7 +24,7 @@ For more information, see, ## Example -The following sample generates C3162. +The following example generates C3162. ```cpp // C3162.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3163.md b/docs/error-messages/compiler-errors-2/compiler-error-c3163.md index 21303a4e941..a35735663e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3163.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3163.md @@ -20,7 +20,7 @@ A possible cause of the C3163 error involves the Microsoft source code annotatio ## Example -The following sample generates C3163. +The following example generates C3163. ```cpp // C3163.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3168.md b/docs/error-messages/compiler-errors-2/compiler-error-c3168.md index 325b4e3f236..2a3b2813980 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3168.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3168.md @@ -16,7 +16,7 @@ The underlying type you specified for the **`enum`** type was not valid. The und ## Example -The following sample generates C3168: +The following example generates C3168: ```cpp // C3168.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3174.md b/docs/error-messages/compiler-errors-2/compiler-error-c3174.md index 0d8d2e05fcd..8fec7b9d121 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3174.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3174.md @@ -16,7 +16,7 @@ A program that uses Visual C++ attributes did not also use the [module](../../wi ## Example -The following sample generates C3174: +The following example generates C3174: ```cpp // 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 index 486f6c8e80d..4b0b44fa107 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3175.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3175.md @@ -16,7 +16,7 @@ Unmanaged functions cannot call member functions of managed classes. ## Example -The following sample generates C3175: +The following example generates C3175: ```cpp // C3175_2.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 index fda80d05602..7b20e76e179 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3176.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3176.md @@ -16,7 +16,7 @@ A class can only be declared as a value type at global scope. ## Example -The following sample generates C3176. +The following example generates C3176. ```cpp // C3176.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3179.md b/docs/error-messages/compiler-errors-2/compiler-error-c3179.md index 2540286635c..b00a22d016a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3179.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3179.md @@ -16,7 +16,7 @@ All CLR and WinRT classes and structs must have names. ## Example -The following sample generates C3179 and shows how to fix it: +The following example generates C3179 and shows how to fix it: ```cpp // C3179a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3181.md b/docs/error-messages/compiler-errors-2/compiler-error-c3181.md index 7abc923cfdd..d19b6a85722 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3181.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3181.md @@ -18,7 +18,7 @@ Note that the compiler uses aliases for native types that map to types in the co ## Example -The following sample generates C3181: +The following example generates C3181: ```cpp // C3181a.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 index 5f81b0a9ea2..59016f61e42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3182.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3182.md @@ -16,7 +16,7 @@ A [using](../../cpp/using-declaration.md) declaration is invalid within all form ## Example -The following sample generates C3182 and shows how to fix it. +The following example generates C3182 and shows how to fix it. ```cpp // C3182a.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 index f17d2a52d57..022f2013a9a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3183.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3183.md @@ -16,7 +16,7 @@ A type that is embedded in a managed or WinRT type must be named. ## Example -The following sample generates C3183: +The following example generates C3183: ```cpp // C3183a.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 index 8b70e19e327..a4b6c832e37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3185.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3185.md @@ -15,7 +15,7 @@ You cannot apply the [typeid](../../cpp/typeid-operator.md) operator to a manage ## Example -The following sample generates C3185 and shows how to fix it: +The following example generates C3185 and shows how to fix it: ```cpp // C3185a.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 index 4772b5d19bf..7cd9b8cd37b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3189.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3189.md @@ -18,7 +18,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Example -The following sample generates C3189: +The following example generates C3189: ```cpp // 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 index 5692d8f5826..854f5bec399 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3190.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3190.md @@ -16,7 +16,7 @@ The compiler detected an attempt to make an explicit function instantiation; how ## Example -The following sample generates C3190: +The following example generates C3190: ```cpp // C3190.cpp From 16c1bb85e14a4e0f7cd1fb0a6b97b3957adabc63 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 17:17:33 +0800 Subject: [PATCH 0794/1799] Update metadata for error references in range [C3161, C3190] --- .../error-messages/compiler-errors-2/compiler-error-c3161.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3162.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3163.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3166.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3167.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3168.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3170.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3171.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3172.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3173.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3174.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3175.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3176.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3179.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3180.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3181.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3182.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3183.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3189.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3190.md | 5 ++--- 20 files changed, 40 insertions(+), 60 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md index 10778f1ef23..f462c3b2494 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3161" title: "Compiler Error C3161" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3161" +ms.date: 11/04/2016 f1_keywords: ["C3161"] helpviewer_keywords: ["C3161"] -ms.assetid: 1fe2be85-a343-487b-8476-bf9e257eb29d --- # Compiler Error C3161 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3162.md b/docs/error-messages/compiler-errors-2/compiler-error-c3162.md index a1b5f9b3336..8823e0e12ec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3162.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3162.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3162" title: "Compiler Error C3162" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3162" +ms.date: 11/04/2016 f1_keywords: ["C3162"] helpviewer_keywords: ["C3162"] -ms.assetid: 0d4c4a24-1456-4191-b7d8-c38cb7b17c32 --- # Compiler Error C3162 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3163.md b/docs/error-messages/compiler-errors-2/compiler-error-c3163.md index a35735663e7..f8d07d28b1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3163.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3163.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3163" title: "Compiler Error C3163" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3163" +ms.date: 11/04/2016 f1_keywords: ["C3163"] helpviewer_keywords: ["C3163"] -ms.assetid: 17dcafa3-f416-4e04-a232-f9569218ba75 --- # Compiler Error C3163 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3166.md b/docs/error-messages/compiler-errors-2/compiler-error-c3166.md index 557ea5648e0..4c7d4cdb3f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3166.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3166.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3166" title: "Compiler Error C3166" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3166" +ms.date: 11/04/2016 f1_keywords: ["C3166"] helpviewer_keywords: ["C3166"] -ms.assetid: ec3e330d-c15d-4158-8268-09101486c566 --- # Compiler Error C3166 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3167.md b/docs/error-messages/compiler-errors-2/compiler-error-c3167.md index 28e910770ae..62b80984084 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3167.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3167.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3167" title: "Compiler Error C3167" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3167" +ms.date: 11/04/2016 f1_keywords: ["C3167"] helpviewer_keywords: ["C3167"] -ms.assetid: 58c25fe7-8562-4a18-ad3f-487f081ff173 --- # Compiler Error C3167 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3168.md b/docs/error-messages/compiler-errors-2/compiler-error-c3168.md index 2a3b2813980..fe5c27dd2ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3168.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3168.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3168" title: "Compiler Error C3168" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3168" +ms.date: 11/04/2016 f1_keywords: ["C3168"] helpviewer_keywords: ["C3168"] -ms.assetid: 4c36fcfb-c351-48ff-b4eb-78d2aa1b4d55 --- # Compiler Error C3168 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3170.md b/docs/error-messages/compiler-errors-2/compiler-error-c3170.md index faa2901e65a..5613a0ec2d4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3170.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3170.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3170" title: "Compiler Error C3170" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3170" +ms.date: 11/04/2016 f1_keywords: ["C3170"] helpviewer_keywords: ["C3170"] -ms.assetid: ca9a59d6-7df3-42f0-b028-c09d0af3ac2a --- # Compiler Error C3170 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3171.md b/docs/error-messages/compiler-errors-2/compiler-error-c3171.md index 77238ce11aa..63f770be44f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3171.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3171.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3171" title: "Compiler Error C3171" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3171" +ms.date: 11/04/2016 f1_keywords: ["C3171"] helpviewer_keywords: ["C3171"] -ms.assetid: 1ce26997-7ef1-4c9f-84da-003ea1a4251e --- # Compiler Error C3171 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3172.md b/docs/error-messages/compiler-errors-2/compiler-error-c3172.md index 574b5de0abc..5bcbd0ef9ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3172.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3172.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3172" title: "Compiler Error C3172" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3172" +ms.date: 11/04/2016 f1_keywords: ["C3172"] helpviewer_keywords: ["C3172"] -ms.assetid: 1834e2fd-6036-4c33-aff2-b51bc7c99441 --- # Compiler Error C3172 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3173.md b/docs/error-messages/compiler-errors-2/compiler-error-c3173.md index a981f2b87bf..39d61590982 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3173.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3173.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3173" title: "Compiler Error C3173" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3173" +ms.date: 11/04/2016 f1_keywords: ["C3173"] helpviewer_keywords: ["C3173"] -ms.assetid: edf79e10-e8cf-4f76-8d33-ab9d05e974e9 --- # Compiler Error C3173 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3174.md b/docs/error-messages/compiler-errors-2/compiler-error-c3174.md index 8fec7b9d121..c73157a2997 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3174.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3174.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3174" title: "Compiler Error C3174" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3174" +ms.date: 11/04/2016 f1_keywords: ["C3174"] helpviewer_keywords: ["C3174"] -ms.assetid: fe6b3b5a-8196-485f-a45f-0b2e51df4086 --- # Compiler Error C3174 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3175.md b/docs/error-messages/compiler-errors-2/compiler-error-c3175.md index 4b0b44fa107..8cce6182a2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3175.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3175.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3175" title: "Compiler Error C3175" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3175" +ms.date: 11/04/2016 f1_keywords: ["C3175"] helpviewer_keywords: ["C3175"] -ms.assetid: 3f19d513-a05a-4b6c-806f-276fe5c36b90 --- # Compiler Error C3175 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3176.md b/docs/error-messages/compiler-errors-2/compiler-error-c3176.md index 7b20e76e179..dac1b4f9bdc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3176.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3176.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3176" title: "Compiler Error C3176" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3176" +ms.date: 11/04/2016 f1_keywords: ["C3176"] helpviewer_keywords: ["C3176"] -ms.assetid: 6cc8d602-8e15-47a7-b1b5-e93e5d50e271 --- # Compiler Error C3176 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3179.md b/docs/error-messages/compiler-errors-2/compiler-error-c3179.md index b00a22d016a..20752c024d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3179.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3179.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3179" title: "Compiler Error C3179" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3179" +ms.date: 11/04/2016 f1_keywords: ["C3179"] helpviewer_keywords: ["C3179"] -ms.assetid: 60d7e41b-25fd-48ac-8b79-830c062f4dcd --- # Compiler Error C3179 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3180.md b/docs/error-messages/compiler-errors-2/compiler-error-c3180.md index c9602acccfa..c5e39e638b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3180.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3180.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3180" title: "Compiler Error C3180" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3180" +ms.date: 11/04/2016 f1_keywords: ["C3180"] helpviewer_keywords: ["C3180"] -ms.assetid: 5281f583-7df7-418a-8507-d4da67ed6572 --- # Compiler Error C3180 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3181.md b/docs/error-messages/compiler-errors-2/compiler-error-c3181.md index d19b6a85722..4c71262029e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3181.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3181.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3181" title: "Compiler Error C3181" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3181" +ms.date: 11/04/2016 f1_keywords: ["C3181"] helpviewer_keywords: ["C3181"] -ms.assetid: 5d450f8b-6cef-4452-a0c4-2076e967451d --- # Compiler Error C3181 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3182.md b/docs/error-messages/compiler-errors-2/compiler-error-c3182.md index 59016f61e42..56822448225 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3182.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3182.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3182" title: "Compiler Error C3182" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3182" +ms.date: 11/04/2016 f1_keywords: ["C3182"] helpviewer_keywords: ["C3182"] -ms.assetid: f3681266-308e-4990-a979-8eef8920e186 --- # Compiler Error C3182 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3183.md b/docs/error-messages/compiler-errors-2/compiler-error-c3183.md index 022f2013a9a..c23ae7054a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3183.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3183.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3183" title: "Compiler Error C3183" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3183" +ms.date: 11/04/2016 f1_keywords: ["C3183"] helpviewer_keywords: ["C3183"] -ms.assetid: dbd0f020-c739-43c9-947e-9ce21537331b --- # Compiler Error C3183 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3189.md b/docs/error-messages/compiler-errors-2/compiler-error-c3189.md index 7cd9b8cd37b..90248e75159 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3189.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3189.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3189" title: "Compiler Error C3189" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3189" +ms.date: 11/04/2016 f1_keywords: ["C3189"] helpviewer_keywords: ["C3189"] -ms.assetid: b254de79-931e-4a59-a9f4-1c690d90ca5e --- # Compiler Error C3189 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3190.md b/docs/error-messages/compiler-errors-2/compiler-error-c3190.md index 854f5bec399..3b55ad91f4e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3190.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3190.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3190" title: "Compiler Error C3190" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3190" +ms.date: 11/04/2016 f1_keywords: ["C3190"] helpviewer_keywords: ["C3190"] -ms.assetid: 7c701afa-85a7-4f7a-8881-0662436ac244 --- # Compiler Error C3190 From 086bbd4cebf877c8d7151ecec37de9bd5e7dae7c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 17:57:48 +0800 Subject: [PATCH 0795/1799] Clean up dedents in standard library references --- docs/standard-library/allocator-class.md | 4 +- .../back-insert-iterator-class.md | 16 +++---- docs/standard-library/basic-string-class.md | 2 +- docs/standard-library/deque-class.md | 4 +- .../front-insert-iterator-class.md | 12 +++--- .../standard-library/insert-iterator-class.md | 6 +-- .../istreambuf-iterator-class.md | 2 +- docs/standard-library/less-struct.md | 4 +- docs/standard-library/list-class.md | 6 +-- docs/standard-library/locale-functions.md | 7 ++-- .../ostream-iterator-class.md | 22 +++++----- .../ostreambuf-iterator-class.md | 42 +++++++++---------- .../raw-storage-iterator-class.md | 4 +- docs/standard-library/shared-mutex.md | 4 +- 14 files changed, 68 insertions(+), 67 deletions(-) diff --git a/docs/standard-library/allocator-class.md b/docs/standard-library/allocator-class.md index 86e07e0e632..a30a09460cc 100644 --- a/docs/standard-library/allocator-class.md +++ b/docs/standard-library/allocator-class.md @@ -396,7 +396,7 @@ int main( ) // vcref = 150; // but the value of the first element could be modified through // its nonconst iterator and the const reference would remain valid -*vfIter = 175; + *vfIter = 175; cout << "The value of the element referred to by vcref," <<"\n after nofication through its nonconst iterator, is: " << vcref << "." << endl; @@ -1024,7 +1024,7 @@ int main( ) vfIter = v.begin( ); allocator::value_type vecVal = 150.0; -*vfIter = vecVal; + *vfIter = vecVal; cout << "The value of the element addressed by vfIter is: " << *vfIter << ",\n the first element in the vector." << endl; diff --git a/docs/standard-library/back-insert-iterator-class.md b/docs/standard-library/back-insert-iterator-class.md index 41038cc72eb..9f6d41f8159 100644 --- a/docs/standard-library/back-insert-iterator-class.md +++ b/docs/standard-library/back-insert-iterator-class.md @@ -103,9 +103,9 @@ int main( ) // Alternatively, insertions can be done with template function back_insert_iterator > backiter ( vec ); -*backiter = 600; + *backiter = 600; backiter++; -*backiter = 700; + *backiter = 700; cout << "After the insertions, the vector vec is: ( "; for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++) @@ -216,9 +216,9 @@ int main( ) cout << ")." << endl; back_insert_iterator > backiter ( vec ); -*backiter = 10; + *backiter = 10; backiter++; // Increment to the next element -*backiter = 20; + *backiter = 20; backiter++; cout << "After the insertions, the vector vec becomes: ( "; @@ -277,9 +277,9 @@ int main( ) cout << ")." << endl; back_insert_iterator > backiter ( vec ); -*backiter = 30; + *backiter = 30; backiter++; // Increment to the next element -*backiter = 40; + *backiter = 40; backiter++; cout << "After the insertions, the vector vec becomes: ( "; @@ -349,9 +349,9 @@ int main( ) cout << ")." << endl; back_insert_iterator > backiter ( vec ); -*backiter = 10; + *backiter = 10; backiter++; // Increment to the next element -*backiter = 20; + *backiter = 20; backiter++; cout << "After the insertions, the vector vec becomes: ( "; diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 4cfe39831e2..ee5a92355ad 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -760,7 +760,7 @@ int main( ) { cout << "The full original string str1 is: " << str1 << endl; // The dereferenced iterator can be used to modify a character -*str1_Iter = 'G'; + *str1_Iter = 'G'; cout << "The first character of the modified str1 is now: " << *str1_Iter << endl; cout << "The full modified string str1 is now: " << str1 << endl; diff --git a/docs/standard-library/deque-class.md b/docs/standard-library/deque-class.md index 8e82314f40c..f7921cd41eb 100644 --- a/docs/standard-library/deque-class.md +++ b/docs/standard-library/deque-class.md @@ -354,7 +354,7 @@ int main( ) c1_Iter = c1.begin( ); cout << "The first element of c1 is " << *c1_Iter << endl; -*c1_Iter = 20; + *c1_Iter = 20; c1_Iter = c1.begin( ); cout << "The first element of c1 is now " << *c1_Iter << endl; @@ -1604,7 +1604,7 @@ template struct S { MyDeque::const_iterator iter; for (iter = d.cbegin(); iter != d.cend(); iter++) cout << *iter << " "; -cout << " via unnamed rvalue reference " << endl; + cout << " via unnamed rvalue reference " << endl; } }; diff --git a/docs/standard-library/front-insert-iterator-class.md b/docs/standard-library/front-insert-iterator-class.md index 3ca56a1eb32..bce621b13b3 100644 --- a/docs/standard-library/front-insert-iterator-class.md +++ b/docs/standard-library/front-insert-iterator-class.md @@ -254,11 +254,11 @@ int main( ) list L1; front_insert_iterator > iter ( L1 ); -*iter = 10; + *iter = 10; iter++; -*iter = 20; + *iter = 20; iter++; -*iter = 30; + *iter = 30; iter++; list ::iterator vIter; @@ -316,11 +316,11 @@ int main( ) list L1; front_insert_iterator > iter ( L1 ); -*iter = 10; + *iter = 10; iter++; -*iter = 20; + *iter = 20; iter++; -*iter = 30; + *iter = 30; iter++; list ::iterator vIter; diff --git a/docs/standard-library/insert-iterator-class.md b/docs/standard-library/insert-iterator-class.md index 6932e17a30f..591880c48df 100644 --- a/docs/standard-library/insert-iterator-class.md +++ b/docs/standard-library/insert-iterator-class.md @@ -267,11 +267,11 @@ int main( ) cout << ")." << endl; insert_iterator > ii ( vec, vec.begin ( ) ); -*ii = 30; + *ii = 30; ii++; -*ii = 40; + *ii = 40; ii++; -*ii = 50; + *ii = 50; cout << "After the insertions, the vector vec becomes:\n ( "; for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++ ) diff --git a/docs/standard-library/istreambuf-iterator-class.md b/docs/standard-library/istreambuf-iterator-class.md index 9b05304ed12..713a31c2912 100644 --- a/docs/standard-library/istreambuf-iterator-class.md +++ b/docs/standard-library/istreambuf-iterator-class.md @@ -341,7 +341,7 @@ int main( ) ostreambuf_iterator outpos ( cout ); while ( inpos != endpos ) { -*outpos = *inpos; + *outpos = *inpos; ++inpos; //Increment istreambuf_iterator ++outpos; } diff --git a/docs/standard-library/less-struct.md b/docs/standard-library/less-struct.md index 380355a2562..e16685ec94f 100644 --- a/docs/standard-library/less-struct.md +++ b/docs/standard-library/less-struct.md @@ -80,7 +80,7 @@ int main() { cout << "Original vector v1 = ( " ; for ( Iter1 = v1.begin() ; Iter1 != v1.end() ; Iter1++ ) -cout << Iter1->m_i << " "; + cout << Iter1->m_i << " "; cout << ")" << endl; // To sort in ascending order, @@ -88,7 +88,7 @@ cout << Iter1->m_i << " "; cout << "Sorted vector v1 = ( " ; for ( Iter1 = v1.begin() ; Iter1 != v1.end() ; Iter1++ ) -cout << Iter1->m_i << " "; + cout << Iter1->m_i << " "; cout << ")" << endl; } ``` diff --git a/docs/standard-library/list-class.md b/docs/standard-library/list-class.md index 3e8d6dbc987..f73b108a79b 100644 --- a/docs/standard-library/list-class.md +++ b/docs/standard-library/list-class.md @@ -303,7 +303,7 @@ int main( ) c1_Iter = c1.begin( ); cout << "The first element of c1 is " << *c1_Iter << endl; -*c1_Iter = 20; + *c1_Iter = 20; c1_Iter = c1.begin( ); cout << "The first element of c1 is now " << *c1_Iter << endl; @@ -851,7 +851,7 @@ int main( ) cout << "The last integer of c1 is " << *c1_Iter << endl; c1_Iter--; -*c1_Iter = 400; + *c1_Iter = 400; cout << "The new next-to-last integer of c1 is " << *c1_Iter << endl; @@ -1754,7 +1754,7 @@ int main( ) cout << endl; c1_rIter = c1.rbegin( ); -*c1_rIter = 40; + *c1_rIter = 40; cout << "The last element in the list is now " << *c1_rIter << "." << endl; } ``` diff --git a/docs/standard-library/locale-functions.md b/docs/standard-library/locale-functions.md index 98ff04ced77..5a616e7085a 100644 --- a/docs/standard-library/locale-functions.md +++ b/docs/standard-library/locale-functions.md @@ -903,9 +903,10 @@ int main( ) { locale loc1 ( "German_Germany" ), loc2 ( "English_Australia" ); bool result1 = use_facet > ( loc1 ).is( - ctype_base::alpha, 'a' -); - bool result2 = use_facet > ( loc2 ).is( ctype_base::alpha, '!' + ctype_base::alpha, 'a' + ); + bool result2 = use_facet > ( loc2 ).is( + ctype_base::alpha, '!' ); if ( result1 ) diff --git a/docs/standard-library/ostream-iterator-class.md b/docs/standard-library/ostream-iterator-class.md index de3f56cd39c..c31709bbd4d 100644 --- a/docs/standard-library/ostream-iterator-class.md +++ b/docs/standard-library/ostream-iterator-class.md @@ -145,10 +145,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*intOut = 10; + *intOut = 10; intOut++; // No effect on iterator position -*intOut = 20; -*intOut = 30; + *intOut = 20; + *intOut = 30; } /* Output: Elements written to output stream: @@ -195,10 +195,10 @@ int main( ) // standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*intOut = 10; + *intOut = 10; intOut++; // No effect on iterator position -*intOut = 20; -*intOut = 30; + *intOut = 20; + *intOut = 30; } /* Output: Elements written to output stream: @@ -249,10 +249,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*intOut = 10; + *intOut = 10; intOut++; // No effect on iterator position -*intOut = 20; -*intOut = 30; + *intOut = 20; + *intOut = 30; } /* Output: Elements written to output stream: @@ -304,9 +304,9 @@ int main( ) // ostream_iterator for stream cout ostream_iterator intOut ( cout , "\n" ); -*intOut = 10; + *intOut = 10; intOut++; -*intOut = 20; + *intOut = 20; intOut++; int i; diff --git a/docs/standard-library/ostreambuf-iterator-class.md b/docs/standard-library/ostreambuf-iterator-class.md index dea0af412dd..f9c61ad7a49 100644 --- a/docs/standard-library/ostreambuf-iterator-class.md +++ b/docs/standard-library/ostreambuf-iterator-class.md @@ -99,11 +99,11 @@ int main( ) // elements to the output streambuf: cout << "The characters written to the output stream\n" << " by charOutBuf are: "; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; -*charOutBuf = 'U'; + *charOutBuf = 'U'; charOutBuf++; -*charOutBuf = 'T'; + *charOutBuf = 'T'; charOutBuf++; cout << "." << endl; } @@ -145,11 +145,11 @@ int main( ) // ostreambuf_iterator for stream cout ostreambuf_iterator charOut ( cout ); -*charOut = 'a'; + *charOut = 'a'; charOut ++; -*charOut = 'b'; + *charOut = 'b'; charOut ++; -*charOut = 'c'; + *charOut = 'c'; cout << " are characters output individually." << endl; bool b1 = charOut.failed ( ); @@ -200,10 +200,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; // no effect on iterator position -*charOutBuf = 'U'; -*charOutBuf = 'T'; + *charOutBuf = 'U'; + *charOutBuf = 'T'; } /* Output: Elements written to output stream: @@ -248,10 +248,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; // No effect on iterator position -*charOutBuf = 'U'; -*charOutBuf = 'T'; + *charOutBuf = 'U'; + *charOutBuf = 'T'; } /* Output: Elements written to output stream: @@ -300,10 +300,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; // No effect on iterator position -*charOutBuf = 'U'; -*charOutBuf = 'T'; + *charOutBuf = 'U'; + *charOutBuf = 'T'; } /* Output: Elements written to output stream: @@ -350,11 +350,11 @@ int main( ) // ostreambuf_iterator for stream cout ostreambuf_iterator charOut ( cout ); -*charOut = 'O'; + *charOut = 'O'; charOut ++; -*charOut = 'U'; + *charOut = 'U'; charOut ++; -*charOut = 'T'; + *charOut = 'T'; cout << " are characters output individually." << endl; ostreambuf_iterator strOut ( cout ); @@ -435,11 +435,11 @@ int main( ) // elements to the output streambuf: cout << "The characters written to the output stream\n" << " by charOutBuf are: "; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; -*charOutBuf = 'U'; + *charOutBuf = 'U'; charOutBuf++; -*charOutBuf = 'T'; + *charOutBuf = 'T'; charOutBuf++; cout << "." << endl; } diff --git a/docs/standard-library/raw-storage-iterator-class.md b/docs/standard-library/raw-storage-iterator-class.md index 195b79a1f60..e4efd88df18 100644 --- a/docs/standard-library/raw-storage-iterator-class.md +++ b/docs/standard-library/raw-storage-iterator-class.md @@ -134,9 +134,9 @@ int main( void) { Int *pInt = ( Int* ) malloc( sizeof( Int ) ); memset( pInt, 0, sizeof( Int ) ); // Set bIsConstructed to false; -*pInt = 5; + *pInt = 5; raw_storage_iterator< Int*, Int > it( pInt ); -*it = 5; + *it = 5; } ``` diff --git a/docs/standard-library/shared-mutex.md b/docs/standard-library/shared-mutex.md index 4506e8bb917..5349ffb70bc 100644 --- a/docs/standard-library/shared-mutex.md +++ b/docs/standard-library/shared-mutex.md @@ -28,9 +28,9 @@ namespace std { class shared_mutex; class shared_timed_mutex; template -class shared_lock; + class shared_lock; template -void swap(shared_lock& x, shared_lock& y) noexcept; + void swap(shared_lock& x, shared_lock& y) noexcept; } ``` From 14c3b8b00618e1b5bf675a54c75d47f9317d1002 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 18:03:57 +0800 Subject: [PATCH 0796/1799] Update metadata in 10 standard library topics --- docs/standard-library/allocator-class.md | 5 ++--- docs/standard-library/back-insert-iterator-class.md | 3 +-- docs/standard-library/deque-class.md | 2 +- docs/standard-library/front-insert-iterator-class.md | 3 +-- docs/standard-library/istreambuf-iterator-class.md | 3 +-- docs/standard-library/less-struct.md | 5 ++--- docs/standard-library/list-class.md | 5 ++--- docs/standard-library/ostream-iterator-class.md | 3 +-- docs/standard-library/ostreambuf-iterator-class.md | 5 ++--- docs/standard-library/shared-mutex.md | 5 ++--- 10 files changed, 15 insertions(+), 24 deletions(-) diff --git a/docs/standard-library/allocator-class.md b/docs/standard-library/allocator-class.md index a30a09460cc..8c090dd434b 100644 --- a/docs/standard-library/allocator-class.md +++ b/docs/standard-library/allocator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: allocator Class" title: "allocator Class" -ms.date: "11/04/2016" +description: "Learn more about: allocator Class" +ms.date: 11/04/2016 f1_keywords: ["memory/std::allocator", "memory/std::allocator::const_pointer", "memory/std::allocator::const_reference", "memory/std::allocator::difference_type", "memory/std::allocator::pointer", "memory/std::allocator::reference", "memory/std::allocator::size_type", "memory/std::allocator::value_type", "memory/std::allocator::address", "memory/std::allocator::allocate", "memory/std::allocator::construct", "memory/std::allocator::deallocate", "memory/std::allocator::destroy", "memory/std::allocator::max_size", "memory/std::allocator::rebind"] helpviewer_keywords: ["std::allocator [C++]", "std::allocator [C++], const_pointer", "std::allocator [C++], const_reference", "std::allocator [C++], difference_type", "std::allocator [C++], pointer", "std::allocator [C++], reference", "std::allocator [C++], size_type", "std::allocator [C++], value_type", "std::allocator [C++], address", "std::allocator [C++], allocate", "std::allocator [C++], construct", "std::allocator [C++], deallocate", "std::allocator [C++], destroy", "std::allocator [C++], max_size", "std::allocator [C++], rebind"] -ms.assetid: 3fd58076-56cc-43bb-ad58-b4b7c9c6b410 --- # allocator Class diff --git a/docs/standard-library/back-insert-iterator-class.md b/docs/standard-library/back-insert-iterator-class.md index 9f6d41f8159..2134ccf1b15 100644 --- a/docs/standard-library/back-insert-iterator-class.md +++ b/docs/standard-library/back-insert-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: back_insert_iterator Class" title: "back_insert_iterator Class" +description: "Learn more about: back_insert_iterator Class" ms.date: 06/07/2022 f1_keywords: ["iterator/std::back_insert_iterator", "iterator/std::back_insert_iterator::container_type", "iterator/std::back_insert_iterator::reference"] helpviewer_keywords: ["std::back_insert_iterator [C++]", "std::back_insert_iterator [C++], container_type", "std::back_insert_iterator [C++], reference"] -ms.assetid: a1ee07f2-cf9f-46a1-8608-cfaf207f9713 ms.custom: devdivchpfy22 --- # back_insert_iterator Class diff --git a/docs/standard-library/deque-class.md b/docs/standard-library/deque-class.md index f7921cd41eb..775b92a2d87 100644 --- a/docs/standard-library/deque-class.md +++ b/docs/standard-library/deque-class.md @@ -1,7 +1,7 @@ --- title: "deque Class" description: "Learn more about: deque Class" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["deque/std::deque", "deque/std::deque::allocator_type", "deque/std::deque::const_iterator", "deque/std::deque::const_pointer", "deque/std::deque::const_reference", "deque/std::deque::const_reverse_iterator", "deque/std::deque::difference_type", "deque/std::deque::iterator", "deque/std::deque::pointer", "deque/std::deque::reference", "deque/std::deque::reverse_iterator", "deque/std::deque::size_type", "deque/std::deque::value_type", "deque/std::deque::assign", "deque/std::deque::at", "deque/std::deque::back", "deque/std::deque::begin", "deque/std::deque::cbegin", "deque/std::deque::cend", "deque/std::deque::clear", "deque/std::deque::crbegin", "deque/std::deque::crend", "deque/std::deque::emplace", "deque/std::deque::emplace_back", "deque/std::deque::emplace_front", "deque/std::deque::empty", "deque/std::deque::end", "deque/std::deque::erase", "deque/std::deque::front", "deque/std::deque::get_allocator", "deque/std::deque::insert", "deque/std::deque::max_size", "deque/std::deque::pop_back", "deque/std::deque::pop_front", "deque/std::deque::push_back", "deque/std::deque::push_front", "deque/std::deque::rbegin", "deque/std::deque::rend", "deque/std::deque::resize", "deque/std::deque::shrink_to_fit", "deque/std::deque::size", "deque/std::deque::swap"] helpviewer_keywords: ["std::deque [C++]", "std::deque [C++], allocator_type", "std::deque [C++], const_iterator", "std::deque [C++], const_pointer", "std::deque [C++], const_reference", "std::deque [C++], const_reverse_iterator", "std::deque [C++], difference_type", "std::deque [C++], iterator", "std::deque [C++], pointer", "std::deque [C++], reference", "std::deque [C++], reverse_iterator", "std::deque [C++], size_type", "std::deque [C++], value_type", "std::deque [C++], assign", "std::deque [C++], at", "std::deque [C++], back", "std::deque [C++], begin", "std::deque [C++], cbegin", "std::deque [C++], cend", "std::deque [C++], clear", "std::deque [C++], crbegin", "std::deque [C++], crend", "std::deque [C++], emplace", "std::deque [C++], emplace_back", "std::deque [C++], emplace_front", "std::deque [C++], empty", "std::deque [C++], end", "std::deque [C++], erase", "std::deque [C++], front", "std::deque [C++], get_allocator", "std::deque [C++], insert", "std::deque [C++], max_size", "std::deque [C++], pop_back", "std::deque [C++], pop_front", "std::deque [C++], push_back", "std::deque [C++], push_front", "std::deque [C++], rbegin", "std::deque [C++], rend", "std::deque [C++], resize", "std::deque [C++], shrink_to_fit", "std::deque [C++], size", "std::deque [C++], swap"] --- diff --git a/docs/standard-library/front-insert-iterator-class.md b/docs/standard-library/front-insert-iterator-class.md index bce621b13b3..9a5859e8455 100644 --- a/docs/standard-library/front-insert-iterator-class.md +++ b/docs/standard-library/front-insert-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: front_insert_iterator Class" title: "front_insert_iterator Class" +description: "Learn more about: front_insert_iterator Class" ms.date: 06/15/2022 f1_keywords: ["iterator/std::front_insert_iterator", "iterator/std::front_insert_iterator::container_type", "iterator/std::front_insert_iterator::reference"] helpviewer_keywords: ["std::front_insert_iterator [C++]", "std::front_insert_iterator [C++], container_type", "std::front_insert_iterator [C++], reference"] -ms.assetid: a9a9c075-136a-4419-928b-c4871afa033c ms.custom: devdivchpfy22 --- diff --git a/docs/standard-library/istreambuf-iterator-class.md b/docs/standard-library/istreambuf-iterator-class.md index 713a31c2912..5cbf0e24d8d 100644 --- a/docs/standard-library/istreambuf-iterator-class.md +++ b/docs/standard-library/istreambuf-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: istreambuf_iterator Class" title: "istreambuf_iterator Class" +description: "Learn more about: istreambuf_iterator Class" ms.date: 06/15/2022 f1_keywords: ["streambuf/std::istreambuf_iterator", "iterator/std::istreambuf_iterator::char_type", "iterator/std::istreambuf_iterator::int_type", "iterator/std::istreambuf_iterator::istream_type", "iterator/std::istreambuf_iterator::streambuf_type", "iterator/std::istreambuf_iterator::traits_type", "iterator/std::istreambuf_iterator::equal"] helpviewer_keywords: ["std::istreambuf_iterator [C++]", "std::istreambuf_iterator [C++], char_type", "std::istreambuf_iterator [C++], int_type", "std::istreambuf_iterator [C++], istream_type", "std::istreambuf_iterator [C++], streambuf_type", "std::istreambuf_iterator [C++], traits_type", "std::istreambuf_iterator [C++], equal"] -ms.assetid: 39002da2-61a6-48a5-9d0c-5df8271f6038 ms.custom: devdivchpfy22 --- diff --git a/docs/standard-library/less-struct.md b/docs/standard-library/less-struct.md index e16685ec94f..d4c3d3ac567 100644 --- a/docs/standard-library/less-struct.md +++ b/docs/standard-library/less-struct.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: less Struct" title: "less Struct" -ms.date: "11/04/2016" +description: "Learn more about: less Struct" +ms.date: 11/04/2016 f1_keywords: ["functional/std::less"] helpviewer_keywords: ["less struct", "less function"] -ms.assetid: 39349da3-11cd-4774-b2cc-b46af5aae5d7 --- # less Struct diff --git a/docs/standard-library/list-class.md b/docs/standard-library/list-class.md index f73b108a79b..e2c7a17216c 100644 --- a/docs/standard-library/list-class.md +++ b/docs/standard-library/list-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: list Class" title: "list Class" -ms.date: "11/04/2016" +description: "Learn more about: list Class" +ms.date: 11/04/2016 f1_keywords: ["list/std::list", "list/std::list::allocator_type", "list/std::list::const_iterator", "list/std::list::const_pointer", "list/std::list::const_reference", "list/std::list::const_reverse_iterator", "list/std::list::difference_type", "list/std::list::iterator", "list/std::list::pointer", "list/std::list::reference", "list/std::list::reverse_iterator", "list/std::list::size_type", "list/std::list::value_type", "list/std::list::assign", "list/std::list::back", "list/std::list::begin", "list/std::list::cbegin", "list/std::list::cend", "list/std::list::clear", "list/std::list::crbegin", "list/std::list::crend", "list/std::list::emplace", "list/std::list::emplace_back", "list/std::list::emplace_front", "list/std::list::empty", "list/std::list::end", "list/std::list::erase", "list/std::list::front", "list/std::list::get_allocator", "list/std::list::insert", "list/std::list::max_size", "list/std::list::merge", "list/std::list::pop_back", "list/std::list::pop_front", "list/std::list::push_back", "list/std::list::push_front", "list/std::list::rbegin", "list/std::list::remove", "list/std::list::remove_if", "list/std::list::rend", "list/std::list::resize", "list/std::list::reverse", "list/std::list::size", "list/std::list::sort", "list/std::list::splice", "list/std::list::swap", "list/std::list::unique"] helpviewer_keywords: ["std::list [C++]", "std::list [C++], allocator_type", "std::list [C++], const_iterator", "std::list [C++], const_pointer", "std::list [C++], const_reference", "std::list [C++], const_reverse_iterator", "std::list [C++], difference_type", "std::list [C++], iterator", "std::list [C++], pointer", "std::list [C++], reference", "std::list [C++], reverse_iterator", "std::list [C++], size_type", "std::list [C++], value_type", "std::list [C++], assign", "std::list [C++], back", "std::list [C++], begin", "std::list [C++], cbegin", "std::list [C++], cend", "std::list [C++], clear", "std::list [C++], crbegin", "std::list [C++], crend", "std::list [C++], emplace", "std::list [C++], emplace_back", "std::list [C++], emplace_front", "std::list [C++], empty", "std::list [C++], end", "std::list [C++], erase", "std::list [C++], front", "std::list [C++], get_allocator", "std::list [C++], insert", "std::list [C++], max_size", "std::list [C++], merge", "std::list [C++], pop_back", "std::list [C++], pop_front", "std::list [C++], push_back", "std::list [C++], push_front", "std::list [C++], rbegin", "std::list [C++], remove", "std::list [C++], remove_if", "std::list [C++], rend", "std::list [C++], resize", "std::list [C++], reverse", "std::list [C++], size", "std::list [C++], sort", "std::list [C++], splice", "std::list [C++], swap", "std::list [C++], unique"] -ms.assetid: d3707f4a-10fd-444f-b856-f9ca2077c1cd --- # `list` Class diff --git a/docs/standard-library/ostream-iterator-class.md b/docs/standard-library/ostream-iterator-class.md index c31709bbd4d..d2fcea91de0 100644 --- a/docs/standard-library/ostream-iterator-class.md +++ b/docs/standard-library/ostream-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ostream_iterator Class" title: "ostream_iterator Class" +description: "Learn more about: ostream_iterator Class" ms.date: 06/17/2022 f1_keywords: ["iterator/std::ostream_iterator", "iterator/std::ostream_iterator::char_type", "iterator/std::ostream_iterator::ostream_type", "iterator/std::ostream_iterator::traits_type"] helpviewer_keywords: ["std::ostream_iterator [C++]", "std::ostream_iterator [C++], char_type", "std::ostream_iterator [C++], ostream_type", "std::ostream_iterator [C++], traits_type"] -ms.assetid: 24d842d3-9f45-4bf6-a697-62f5968f5a03 ms.custom: devdivchpfy22 --- diff --git a/docs/standard-library/ostreambuf-iterator-class.md b/docs/standard-library/ostreambuf-iterator-class.md index f9c61ad7a49..d6b21df15c7 100644 --- a/docs/standard-library/ostreambuf-iterator-class.md +++ b/docs/standard-library/ostreambuf-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ostreambuf_iterator Class" title: "ostreambuf_iterator Class" -ms.date: "11/04/2016" +description: "Learn more about: ostreambuf_iterator Class" +ms.date: 11/04/2016 f1_keywords: ["streambuf/std::ostreambuf_iterator", "iterator/std::ostreambuf_iterator::char_type", "iterator/std::ostreambuf_iterator::ostream_type", "iterator/std::ostreambuf_iterator::streambuf_type", "iterator/std::ostreambuf_iterator::traits_type", "iterator/std::ostreambuf_iterator::failed"] helpviewer_keywords: ["std::ostreambuf_iterator [C++]", "std::ostreambuf_iterator [C++], char_type", "std::ostreambuf_iterator [C++], ostream_type", "std::ostreambuf_iterator [C++], streambuf_type", "std::ostreambuf_iterator [C++], traits_type", "std::ostreambuf_iterator [C++], failed"] -ms.assetid: dad1e624-2f45-4e94-8887-a885e95f9071 --- # ostreambuf_iterator Class diff --git a/docs/standard-library/shared-mutex.md b/docs/standard-library/shared-mutex.md index 5349ffb70bc..aa70e3c56c8 100644 --- a/docs/standard-library/shared-mutex.md +++ b/docs/standard-library/shared-mutex.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: " title: "" -ms.date: "03/27/2019" +description: "Learn more about: " +ms.date: 03/27/2019 f1_keywords: ["", "shared_mutex/std::swap", "shared_mutex/std::shared_lock", "shared_mutex/std::shared_lock::shared_lock", "shared_mutex/std::shared_lock::operator=", "shared_mutex/std::shared_lock::operator =", "shared_mutex/std::shared_lock::lock", "shared_mutex/std::shared_lock::try_lock", "shared_mutex/std::shared_lock::try_lock_for", "shared_mutex/std::shared_lock::try_lock_until", "shared_mutex/std::shared_lock::unlock", "shared_mutex/std::shared_lock::swap", "shared_mutex/std::shared_lock::release", "shared_mutex/std::shared_lock::owns_lock", "shared_mutex/std::shared_lock::operator bool", "shared_mutex/std::shared_lock::mutex", "shared_mutex/std::shared_mutex", "shared_mutex/std::shared_mutex::native_handle_type", "shared_mutex/std::shared_mutex::shared_mutex", "shared_mutex/std::shared_mutex::operator=", "shared_mutex/std::shared_mutex::operator =", "shared_mutex/std::shared_mutex::lock", "shared_mutex/std::shared_mutex::try_lock", "shared_mutex/std::shared_mutex::unlock", "shared_mutex/std::shared_mutex::lock_shared", "shared_mutex/std::shared_mutex::try_lock_shared", "shared_mutex/std::shared_mutex::unlock_shared", "shared_mutex/std::shared_mutex::native_handle", "shared_mutex/std::shared_timed_mutex", "shared_mutex/std::shared_timed_mutex::shared_timed_mutex", "shared_mutex/std::shared_timed_mutex::operator=", "shared_mutex/std::shared_timed_mutex::operator =", "shared_mutex/std::shared_timed_mutex::lock", "shared_mutex/std::shared_timed_mutex::try_lock", "shared_mutex/std::shared_timed_mutex::try_lock_for", "shared_mutex/std::shared_timed_mutex::try_lock_until", "shared_mutex/std::shared_timed_mutex::unlock", "shared_mutex/std::shared_timed_mutex::lock_shared", "shared_mutex/std::shared_timed_mutex::try_lock_shared", "shared_mutex/std::shared_timed_mutex::try_lock_shared_for", "shared_mutex/std::shared_timed_mutex::try_lock_shared_until", "shared_mutex/std::shared_timed_mutex::unlock_shared"] -ms.assetid: 0b37a97d-ee5d-4050-b29f-09db9f76beb3 --- # `` From 42c6096bdaef8f884aa6aa624cceffb56981d621 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 23:00:07 +0800 Subject: [PATCH 0797/1799] Add blockquotes for error messages in range [C3191, C3220] --- docs/error-messages/compiler-errors-2/compiler-error-c3192.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3194.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3195.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3196.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3197.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3198.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3199.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3200.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3201.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3202.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3203.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3204.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3205.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3206.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3207.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3208.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3209.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3210.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3211.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3212.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3213.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3214.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3215.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3216.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3217.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3218.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3219.md | 2 +- 27 files changed, 27 insertions(+), 27 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md index b9e9dd8a921..ce19145c97f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md @@ -8,7 +8,7 @@ ms.assetid: 8b0083d4-706f-46f6-858a-e1d9af464cf8 --- # Compiler Error C3192 -syntax error : '^' is not a prefix operator (did you mean '*'?) +> syntax error : '^' is not a prefix operator (did you mean '*'?) A handle cannot be used as a dereference operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md index a33d63090f6..22442f746ea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md @@ -8,7 +8,7 @@ ms.assetid: 49d3ffc6-eff6-4b46-865b-18811692a8bb --- # Compiler Error C3194 -'member' : a value-type cannot have an assignment operator +> 'member' : a value-type cannot have an assignment operator Special member functions that require automatic invocation by the compiler, such as a copy constructor or copy assignment operator are not supported within a value class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md index 415527ec2dd..bf9a019b50c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md @@ -8,7 +8,7 @@ ms.assetid: 97e4f681-812b-49e8-ba57-24b7817e3cd8 --- # Compiler Error C3195 -'operator' : is reserved and cannot be used as a member of a ref class or value type. CLR or WinRT operators must be defined using the 'operator' keyword +> 'operator' : is reserved and cannot be used as a member of a ref class or value type. CLR or WinRT operators must be defined using the 'operator' keyword The compiler detected an operator definition using the Managed Extensions for C++ syntax. You must use the C++ syntax for operators. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md index 38cf9afdc32..f170f5fe184 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md @@ -8,7 +8,7 @@ ms.assetid: d9c38a13-191d-472d-aa2b-f61a6459d16c --- # Compiler Error C3196 -'keyword' : used more than once +> 'keyword' : used more than once A keyword was used more than once. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md index b5153e95918..552a1f5cca4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md @@ -8,7 +8,7 @@ ms.assetid: 4e385c3b-222e-425c-9612-46e83ed41650 --- # Compiler Error C3197 -'keyword' : can only be used in definitions +> 'keyword' : can only be used in definitions A keyword was used in a declaration but is only valid in a definition. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md index d853ab33b43..a71bb3fed5f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md @@ -8,7 +8,7 @@ ms.assetid: ec4ecf61-0067-4aa4-b443-a91013a1e59d --- # Compiler Error C3198 -invalid use of floating-point pragmas: fenv_access pragma operates only in precise mode +> invalid use of floating-point pragmas: fenv_access pragma operates only in precise mode [fenv_access](../../preprocessor/fenv-access.md) pragma was used under an [/fp](../../build/reference/fp-specify-floating-point-behavior.md) setting other than **/fp:precise**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md index 724e71a9f0d..7d7be74a98a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md @@ -8,7 +8,7 @@ ms.assetid: e7a478d3-115a-40a3-991b-c7454fd2e28e --- # Compiler Error C3199 -invalid use of floating-point pragmas: exceptions are not supported in non-precise mode +> invalid use of floating-point pragmas: exceptions are not supported in non-precise mode The [float_control](../../preprocessor/float-control.md) pragma was used to specify floating-point exception model under an [/fp](../../build/reference/fp-specify-floating-point-behavior.md) setting other than **/fp:precise**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3200.md b/docs/error-messages/compiler-errors-2/compiler-error-c3200.md index e4b6fe76163..390da757bf7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3200.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3200.md @@ -8,7 +8,7 @@ ms.assetid: 44bb5e77-f0ec-421c-a732-b9ee7c0a3529 --- # Compiler Error C3200 -'template' : invalid template argument for template parameter 'parameter', expected a class template +> 'template' : invalid template argument for template parameter 'parameter', expected a class template You passed an invalid argument to a class template. The class template expects template as a parameter. In the following example, calling `Y aY` will generate C3200. The first parameter needs to be a template, such as `Y aY`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md index a8042c538fe..fac57c71729 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md @@ -8,7 +8,7 @@ ms.assetid: ec19cd64-1789-40a3-b2db-dff2852b9d98 --- # Compiler Error C3201 -the template parameter list for class template 'template' does not match the template parameter list for template parameter 'template' +> the template parameter list for class template 'template' does not match the template parameter list for template parameter 'template' You passed a class template in the argument to a class template that does not take a template parameter, or you passed a mismatched number of template arguments for the default template argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md index 30bd9a0ebd0..337c963d353 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md @@ -8,7 +8,7 @@ ms.assetid: 23528a0c-5493-4804-9789-cd3c38e49fb9 --- # Compiler Error C3202 -'arg name' : invalid default argument for template parameter 'parameter', expected a class template +> 'arg name' : invalid default argument for template parameter 'parameter', expected a class template You passed an invalid default argument for a template parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md index f06d5ca3de2..1142aad00da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md @@ -8,7 +8,7 @@ ms.assetid: 6356770e-22c1-434c-91fe-f60b0aa23b91 --- # Compiler Error C3203 -'type' : unspecialized class template or generic can't be used as a template or generic argument for template or generic parameter 'param', expected a real type +> 'type' : unspecialized class template or generic can't be used as a template or generic argument for template or generic parameter 'param', expected a real type You passed an invalid argument to a class template or generic. The class template or generic expects a type as a parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md index 60063fce8c1..da1e591b4b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md @@ -8,7 +8,7 @@ ms.assetid: 06e578da-0262-48c8-b2ae-be1cd6d28884 --- # Compiler Error C3204 -'_alloca' cannot be called from within a catch block +> '_alloca' cannot be called from within a catch block This error occurs when you use a call to [_alloca](../../c-runtime-library/reference/alloca.md) from within a catch block. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md index 40350e71348..7a3a8de2a56 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md @@ -8,7 +8,7 @@ ms.assetid: 802d306e-5ff3-4491-8a22-c5f1c072d005 --- # Compiler Error C3205 -argument list for template parameter 'parameter' is missing +> argument list for template parameter 'parameter' is missing A [template](../../cpp/templates-cpp.md) parameter is missing. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md index 0832f2a6ebe..a0bcdcf52b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md @@ -8,7 +8,7 @@ ms.assetid: d62995b5-e349-4418-bbe8-8a5e776ca7b0 --- # Compiler Error C3206 -'function' : invalid type argument for 'param', missing type argument list on class type 'typename' +> 'function' : invalid type argument for 'param', missing type argument list on class type 'typename' A function template is defined as taking a template type argument. However, a template template argument was passed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md index bef3bea2a4a..a2a00a83c53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md @@ -8,7 +8,7 @@ ms.assetid: 4a28b976-142a-4cff-aa2f-480b892c50ca --- # Compiler Error C3207 -'function' : invalid template argument for 'arg', class template expected +> 'function' : invalid template argument for 'arg', class template expected A function template is defined as taking a template template argument. However, a template type argument was passed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md index 503703f98ee..d3b2111a3c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md @@ -8,7 +8,7 @@ ms.assetid: 6d060bfe-52cf-4599-8f70-bdeb5a670df3 --- # Compiler Error C3208 -'function' : template parameter list for class template 'class' does not match template parameter list for template template parameter 'parameter' +> 'function' : template parameter list for class template 'class' does not match template parameter list for template template parameter 'parameter' A template template parameter does not have the same number of template parameters as the provided class template. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md index 333144c305b..870888e03ea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md @@ -8,7 +8,7 @@ ms.assetid: 1de44e39-69d1-4894-8f89-ff92136e8e5d --- # Compiler Error C3209 -'class' : generic class must be a managed or WinRTclass +> 'class' : generic class must be a managed or WinRTclass A generic class must be a managed class or a Windows Runtime class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md index 53f447d6de6..c2acf339e23 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md @@ -8,7 +8,7 @@ ms.assetid: c6e9d309-fabc-4e7d-b526-be20d9fe3f6a --- # Compiler Error C3210 -'type' : access declaration can only be applied to a base class member +> 'type' : access declaration can only be applied to a base class member A [using declaration](../../cpp/using-declaration.md) was specified incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md index 964563891f5..d70f121d2e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md @@ -8,7 +8,7 @@ ms.assetid: 85e33fed-3b59-4315-97e6-20d31c6a985a --- # Compiler Error C3211 -'explicit specialization' : explicit specialization is using partial specialization syntax, use template <> instead +> 'explicit specialization' : explicit specialization is using partial specialization syntax, use template <> instead An explicit specialization was ill formed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md index 0930774cd11..784c60e1d71 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md @@ -8,7 +8,7 @@ ms.assetid: 9e271bb6-a51f-4b96-b26b-9f4ca28fca0a --- # Compiler Error C3212 -'specialization' : an explicit specialization of a template member must be a member of an explicit specialization +> 'specialization' : an explicit specialization of a template member must be a member of an explicit specialization An explicit specialization was ill formed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md index 9e56eefd1b3..10fa8dd0c1c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md @@ -8,7 +8,7 @@ ms.assetid: 1f079e36-b3e9-40f8-8e95-08eeba3adc82 --- # Compiler Error C3213 -base class 'base_type' is less accessible than 'derived_type' +> base class 'base_type' is less accessible than 'derived_type' A type that will be visible from an assembly must use publicly visible base classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md index 7eeb9bc371a..469eb821294 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md @@ -8,7 +8,7 @@ ms.assetid: 49ee4a9a-2549-4adb-9d3a-38e154303c2e --- # Compiler Error C3214 -'type' : invalid type argument for generic parameter 'param' of generic 'generic_type', does not meet constraint 'constraint' +> 'type' : invalid type argument for generic parameter 'param' of generic 'generic_type', does not meet constraint 'constraint' The type was specified for an instantiation of a generic class that does not meet the generic class's constraint. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md index 6a6ca708566..1869945d480 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md @@ -8,7 +8,7 @@ ms.assetid: d0d16007-8885-42e0-b086-2d3a61f348c5 --- # Compiler Error C3215 -'type1' : generic type parameter already constrained by 'type2' +> 'type1' : generic type parameter already constrained by 'type2' A constraint was specified more than once. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md index bbb2967e39e..7202241ea5c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md @@ -8,7 +8,7 @@ ms.assetid: bbab1efe-8779-4489-8bb0-b11e45f5cbe5 --- # Compiler Error C3216 -constraint must be a generic parameter, not 'type' +> constraint must be a generic parameter, not 'type' A constraint was ill formed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md index 8cacbfeb157..ce2ec11c277 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md @@ -8,7 +8,7 @@ ms.assetid: 99070417-c23a-4d82-bdd2-04be1a07adea --- # Compiler Error C3217 -'param' : generic parameter cannot be constrained in this declaration +> 'param' : generic parameter cannot be constrained in this declaration A constraint was ill formed; the constraint generic parameter must agree with the generic class template parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md index c1abbab3d5a..e91b50c36e4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md @@ -8,7 +8,7 @@ ms.assetid: 0eea19e0-503e-4e07-ae8b-2cb2e95922cd --- # Compiler Error C3218 -'type' : type not allowed as a constraint +> 'type' : type not allowed as a constraint For a type to be a constraint, it must be either a value type or reference to a managed class or interface. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md index 4ee80752f48..26c9a2ec246 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md @@ -8,7 +8,7 @@ ms.assetid: 9c9757b0-1256-4cdf-9d8c-a3a72f300ce5 --- # Compiler Error C3219 -'param' : generic parameter cannot be constrained by multiple non-interfaces : 'class' +> 'param' : generic parameter cannot be constrained by multiple non-interfaces : 'class' It is not valid to constrain a generic parameter by two or more managed classes. From f0cf14c0ef701feaed437472a1aaff8ead6327eb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 23:08:34 +0800 Subject: [PATCH 0798/1799] Add "Remarks" and "Example" headings for error references in range [C3191, C3220] --- .../compiler-errors-2/compiler-error-c3192.md | 4 ++++ .../compiler-errors-2/compiler-error-c3194.md | 2 ++ .../compiler-errors-2/compiler-error-c3195.md | 4 ++++ .../compiler-errors-2/compiler-error-c3196.md | 4 ++++ .../compiler-errors-2/compiler-error-c3197.md | 4 ++++ .../compiler-errors-2/compiler-error-c3198.md | 4 ++++ .../compiler-errors-2/compiler-error-c3199.md | 4 ++++ .../compiler-errors-2/compiler-error-c3200.md | 8 +++++++- .../compiler-errors-2/compiler-error-c3201.md | 4 ++++ .../compiler-errors-2/compiler-error-c3202.md | 4 ++++ .../compiler-errors-2/compiler-error-c3203.md | 4 ++++ .../compiler-errors-2/compiler-error-c3204.md | 2 ++ .../compiler-errors-2/compiler-error-c3205.md | 2 ++ .../compiler-errors-2/compiler-error-c3206.md | 4 ++++ .../compiler-errors-2/compiler-error-c3207.md | 4 ++++ .../compiler-errors-2/compiler-error-c3208.md | 4 ++++ .../compiler-errors-2/compiler-error-c3209.md | 4 ++++ .../compiler-errors-2/compiler-error-c3210.md | 2 ++ .../compiler-errors-2/compiler-error-c3211.md | 4 ++++ .../compiler-errors-2/compiler-error-c3212.md | 4 ++++ .../compiler-errors-2/compiler-error-c3213.md | 4 ++++ .../compiler-errors-2/compiler-error-c3214.md | 4 ++++ .../compiler-errors-2/compiler-error-c3215.md | 4 ++++ .../compiler-errors-2/compiler-error-c3216.md | 4 ++++ .../compiler-errors-2/compiler-error-c3217.md | 4 ++++ .../compiler-errors-2/compiler-error-c3218.md | 2 ++ .../compiler-errors-2/compiler-error-c3219.md | 4 ++++ 27 files changed, 101 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md index ce19145c97f..79a06fd4506 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md @@ -10,8 +10,12 @@ ms.assetid: 8b0083d4-706f-46f6-858a-e1d9af464cf8 > syntax error : '^' is not a prefix operator (did you mean '*'?) +## Remarks + A handle cannot be used as a dereference operator. +## Example + The following sample generates C3192: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md index 22442f746ea..85ad84e077a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md @@ -10,6 +10,8 @@ ms.assetid: 49d3ffc6-eff6-4b46-865b-18811692a8bb > 'member' : a value-type cannot have an assignment operator +## Remarks + Special member functions that require automatic invocation by the compiler, such as a copy constructor or copy assignment operator are not supported within a value class. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md index bf9a019b50c..19b96e4685f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md @@ -10,8 +10,12 @@ ms.assetid: 97e4f681-812b-49e8-ba57-24b7817e3cd8 > 'operator' : is reserved and cannot be used as a member of a ref class or value type. CLR or WinRT operators must be defined using the 'operator' keyword +## Remarks + The compiler detected an operator definition using the Managed Extensions for C++ syntax. You must use the C++ syntax for operators. +## Example + The following sample generates C3195 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md index f170f5fe184..5dbac1ba100 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md @@ -10,8 +10,12 @@ ms.assetid: d9c38a13-191d-472d-aa2b-f61a6459d16c > 'keyword' : used more than once +## Remarks + A keyword was used more than once. +## Example + The following sample generates C3196: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md index 552a1f5cca4..f63e0314129 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md @@ -10,8 +10,12 @@ ms.assetid: 4e385c3b-222e-425c-9612-46e83ed41650 > 'keyword' : can only be used in definitions +## Remarks + A keyword was used in a declaration but is only valid in a definition. +## Example + The following sample generates C3197: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md index a71bb3fed5f..94829ecb1c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md @@ -10,8 +10,12 @@ ms.assetid: ec4ecf61-0067-4aa4-b443-a91013a1e59d > invalid use of floating-point pragmas: fenv_access pragma operates only in precise mode +## Remarks + [fenv_access](../../preprocessor/fenv-access.md) pragma was used under an [/fp](../../build/reference/fp-specify-floating-point-behavior.md) setting other than **/fp:precise**. +## Example + The following sample generates C3198: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md index 7d7be74a98a..be23a4394a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md @@ -10,8 +10,12 @@ ms.assetid: e7a478d3-115a-40a3-991b-c7454fd2e28e > invalid use of floating-point pragmas: exceptions are not supported in non-precise mode +## Remarks + The [float_control](../../preprocessor/float-control.md) pragma was used to specify floating-point exception model under an [/fp](../../build/reference/fp-specify-floating-point-behavior.md) setting other than **/fp:precise**. +## Example + The following sample generates C3199: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3200.md b/docs/error-messages/compiler-errors-2/compiler-error-c3200.md index 390da757bf7..447467d6873 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3200.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3200.md @@ -10,7 +10,13 @@ ms.assetid: 44bb5e77-f0ec-421c-a732-b9ee7c0a3529 > 'template' : invalid template argument for template parameter 'parameter', expected a class template -You passed an invalid argument to a class template. The class template expects template as a parameter. In the following example, calling `Y aY` will generate C3200. The first parameter needs to be a template, such as `Y aY`. +## Remarks + +You passed an invalid argument to a class template. The class template expects template as a parameter. + +## Example + +In the following example, calling `Y aY` will generate C3200. The first parameter needs to be a template, such as `Y aY`. ```cpp // C3200.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md index fac57c71729..049418dfddb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md @@ -10,8 +10,12 @@ ms.assetid: ec19cd64-1789-40a3-b2db-dff2852b9d98 > the template parameter list for class template 'template' does not match the template parameter list for template parameter 'template' +## Remarks + You passed a class template in the argument to a class template that does not take a template parameter, or you passed a mismatched number of template arguments for the default template argument. +## Example + ```cpp // C3201.cpp template diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md index 337c963d353..a11a094962a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md @@ -10,8 +10,12 @@ ms.assetid: 23528a0c-5493-4804-9789-cd3c38e49fb9 > 'arg name' : invalid default argument for template parameter 'parameter', expected a class template +## Remarks + You passed an invalid default argument for a template parameter. +## Example + The following sample generates C3202: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md index 1142aad00da..16cc9c2e8dd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md @@ -10,10 +10,14 @@ ms.assetid: 6356770e-22c1-434c-91fe-f60b0aa23b91 > 'type' : unspecialized class template or generic can't be used as a template or generic argument for template or generic parameter 'param', expected a real type +## Remarks + You passed an invalid argument to a class template or generic. The class template or generic expects a type as a parameter. This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: an unspecialized class template can't be used as a template argument in a base class list. To resolve C3203, explicitly add the template type parameter(s) to the template class name when using it as a template parameter in a base class list. +## Examples + ```cpp // C3203.cpp template< typename T > diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md index da1e591b4b4..2672377c215 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md @@ -10,6 +10,8 @@ ms.assetid: 06e578da-0262-48c8-b2ae-be1cd6d28884 > '_alloca' cannot be called from within a catch block +## Remarks + This error occurs when you use a call to [_alloca](../../c-runtime-library/reference/alloca.md) from within a catch block. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md index 7a3a8de2a56..94adcadb515 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md @@ -10,6 +10,8 @@ ms.assetid: 802d306e-5ff3-4491-8a22-c5f1c072d005 > argument list for template parameter 'parameter' is missing +## Remarks + A [template](../../cpp/templates-cpp.md) parameter is missing. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md index a0bcdcf52b8..34f04377500 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md @@ -10,8 +10,12 @@ ms.assetid: d62995b5-e349-4418-bbe8-8a5e776ca7b0 > 'function' : invalid type argument for 'param', missing type argument list on class type 'typename' +## Remarks + A function template is defined as taking a template type argument. However, a template template argument was passed. +## Examples + The following sample generates C3206: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md index a2a00a83c53..6c44833aca2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md @@ -10,8 +10,12 @@ ms.assetid: 4a28b976-142a-4cff-aa2f-480b892c50ca > 'function' : invalid template argument for 'arg', class template expected +## Remarks + A function template is defined as taking a template template argument. However, a template type argument was passed. +## Example + The following sample generates C3207: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md index d3b2111a3c3..c680da84323 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md @@ -10,8 +10,12 @@ ms.assetid: 6d060bfe-52cf-4599-8f70-bdeb5a670df3 > 'function' : template parameter list for class template 'class' does not match template parameter list for template template parameter 'parameter' +## Remarks + A template template parameter does not have the same number of template parameters as the provided class template. +## Example + The following sample generates C3208: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md index 870888e03ea..35ee6134a30 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md @@ -10,8 +10,12 @@ ms.assetid: 1de44e39-69d1-4894-8f89-ff92136e8e5d > 'class' : generic class must be a managed or WinRTclass +## Remarks + A generic class must be a managed class or a Windows Runtime class. +## Example + The following sample generates C3209 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md index c2acf339e23..1f0a8eabeb4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md @@ -10,6 +10,8 @@ ms.assetid: c6e9d309-fabc-4e7d-b526-be20d9fe3f6a > 'type' : access declaration can only be applied to a base class member +## Remarks + A [using declaration](../../cpp/using-declaration.md) was specified incorrectly. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md index d70f121d2e8..1f9be8836e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md @@ -10,8 +10,12 @@ ms.assetid: 85e33fed-3b59-4315-97e6-20d31c6a985a > 'explicit specialization' : explicit specialization is using partial specialization syntax, use template <> instead +## Remarks + An explicit specialization was ill formed. +## Example + The following sample generates C3211: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md index 784c60e1d71..219f0f2f9ee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md @@ -10,8 +10,12 @@ ms.assetid: 9e271bb6-a51f-4b96-b26b-9f4ca28fca0a > 'specialization' : an explicit specialization of a template member must be a member of an explicit specialization +## Remarks + An explicit specialization was ill formed. +## Example + The following sample generates C3212: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md index 10fa8dd0c1c..e35b9de91f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md @@ -10,8 +10,12 @@ ms.assetid: 1f079e36-b3e9-40f8-8e95-08eeba3adc82 > base class 'base_type' is less accessible than 'derived_type' +## Remarks + A type that will be visible from an assembly must use publicly visible base classes. +## Example + The following sample generates C3213: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md index 469eb821294..9e259439402 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md @@ -10,8 +10,12 @@ ms.assetid: 49ee4a9a-2549-4adb-9d3a-38e154303c2e > 'type' : invalid type argument for generic parameter 'param' of generic 'generic_type', does not meet constraint 'constraint' +## Remarks + The type was specified for an instantiation of a generic class that does not meet the generic class's constraint. +## Example + The following sample generates C3214: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md index 1869945d480..5d336d7b6d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md @@ -10,10 +10,14 @@ ms.assetid: d0d16007-8885-42e0-b086-2d3a61f348c5 > 'type1' : generic type parameter already constrained by 'type2' +## Remarks + A constraint was specified more than once. For more information on generics, see [Generics](../../extensions/generics-cpp-component-extensions.md). +## Example + The following sample generates C3215: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md index 7202241ea5c..350930786ae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md @@ -10,8 +10,12 @@ ms.assetid: bbab1efe-8779-4489-8bb0-b11e45f5cbe5 > constraint must be a generic parameter, not 'type' +## Remarks + A constraint was ill formed. +## Example + The following sample generates C3216: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md index ce2ec11c277..7176aa35996 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md @@ -10,8 +10,12 @@ ms.assetid: 99070417-c23a-4d82-bdd2-04be1a07adea > 'param' : generic parameter cannot be constrained in this declaration +## Remarks + A constraint was ill formed; the constraint generic parameter must agree with the generic class template parameter. +## Example + The following sample generates C3217: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md index e91b50c36e4..822a1622b7f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md @@ -10,6 +10,8 @@ ms.assetid: 0eea19e0-503e-4e07-ae8b-2cb2e95922cd > 'type' : type not allowed as a constraint +## Remarks + For a type to be a constraint, it must be either a value type or reference to a managed class or interface. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md index 26c9a2ec246..94434e97894 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md @@ -10,8 +10,12 @@ ms.assetid: 9c9757b0-1256-4cdf-9d8c-a3a72f300ce5 > 'param' : generic parameter cannot be constrained by multiple non-interfaces : 'class' +## Remarks + It is not valid to constrain a generic parameter by two or more managed classes. +## Example + The following sample generates C3219: ```cpp From c33a8fa41b2825b25d83d2e28e55bda200b11d1a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 23:10:24 +0800 Subject: [PATCH 0799/1799] Replace term "sample" with "example" for error references in range [C3191, C3220] --- docs/error-messages/compiler-errors-2/compiler-error-c3192.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3194.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3195.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3196.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3197.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3198.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3199.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3202.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3203.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3204.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3205.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3206.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3207.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3208.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3209.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3210.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3211.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3212.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3213.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3214.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3215.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3216.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3217.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3218.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3219.md | 4 ++-- 25 files changed, 28 insertions(+), 28 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md index 79a06fd4506..cf344cb163c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md @@ -16,7 +16,7 @@ A handle cannot be used as a dereference operator. ## Example -The following sample generates C3192: +The following example generates C3192: ```cpp // C3192.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md index 85ad84e077a..aea7b336136 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md @@ -16,7 +16,7 @@ Special member functions that require automatic invocation by the compiler, such ## Example -The following sample generates C3194. +The following example generates C3194. ```cpp // C3194.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md index 19b96e4685f..773285472b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md @@ -16,7 +16,7 @@ The compiler detected an operator definition using the Managed Extensions for C+ ## Example -The following sample generates C3195 and shows how to fix it: +The following example generates C3195 and shows how to fix it: ```cpp // C3195.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md index 5dbac1ba100..ce589dca258 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md @@ -16,7 +16,7 @@ A keyword was used more than once. ## Example -The following sample generates C3196: +The following example generates C3196: ```cpp // C3196.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md index f63e0314129..06e64c69b7e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md @@ -16,7 +16,7 @@ A keyword was used in a declaration but is only valid in a definition. ## Example -The following sample generates C3197: +The following example generates C3197: ```cpp // C3197.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md index 94829ecb1c8..76dd7c51bbb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md @@ -16,7 +16,7 @@ ms.assetid: ec4ecf61-0067-4aa4-b443-a91013a1e59d ## Example -The following sample generates C3198: +The following example generates C3198: ```cpp // C3198.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md index be23a4394a3..865fb26a490 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md @@ -16,7 +16,7 @@ The [float_control](../../preprocessor/float-control.md) pragma was used to spec ## Example -The following sample generates C3199: +The following example generates C3199: ```cpp // C3199.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md index a11a094962a..8847ab99955 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md @@ -16,7 +16,7 @@ You passed an invalid default argument for a template parameter. ## Example -The following sample generates C3202: +The following example generates C3202: ```cpp // C3202.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md index 16cc9c2e8dd..ca40ee3e3dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md @@ -37,7 +37,7 @@ int main() { } ``` -The following sample generates C3203 and shows how to fix it: +The following example generates C3203 and shows how to fix it: ```cpp // C3203_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md index 2672377c215..14f043bb5b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md @@ -16,7 +16,7 @@ This error occurs when you use a call to [_alloca](../../c-runtime-library/refer ## Example -The following sample generates C3204: +The following example generates C3204: ```cpp // C3204.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md index 94adcadb515..9120edff432 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md @@ -16,7 +16,7 @@ A [template](../../cpp/templates-cpp.md) parameter is missing. ## Example -The following sample generates C3205: +The following example generates C3205: ```cpp // C3205.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md index 34f04377500..eb14c962a23 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md @@ -16,7 +16,7 @@ A function template is defined as taking a template type argument. However, a te ## Examples -The following sample generates C3206: +The following example generates C3206: ```cpp // C3206.cpp @@ -81,7 +81,7 @@ int main() { } ``` -A class template is not allowed as a template type argument. The following sample raises C3206: +A class template is not allowed as a template type argument. The following example raises C3206: ```cpp // C3206e.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md index 6c44833aca2..aeba4cfc66c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md @@ -16,7 +16,7 @@ A function template is defined as taking a template template argument. However, ## Example -The following sample generates C3207: +The following example generates C3207: ```cpp // C3207.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md index c680da84323..2e53622c72e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md @@ -16,7 +16,7 @@ A template template parameter does not have the same number of template paramete ## Example -The following sample generates C3208: +The following example generates C3208: ```cpp // C3208.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md index 35ee6134a30..6877cb55c63 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md @@ -16,7 +16,7 @@ A generic class must be a managed class or a Windows Runtime class. ## Example -The following sample generates C3209 and shows how to fix it: +The following example generates C3209 and shows how to fix it: ```cpp // C3209.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md index 1f0a8eabeb4..9c251364d52 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md @@ -16,7 +16,7 @@ A [using declaration](../../cpp/using-declaration.md) was specified incorrectly. ## Example -The following sample generates C3210. +The following example generates C3210. ```cpp // C3210.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md index 1f9be8836e9..943787ce999 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md @@ -16,7 +16,7 @@ An explicit specialization was ill formed. ## Example -The following sample generates C3211: +The following example generates C3211: ```cpp // C3211.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md index 219f0f2f9ee..726b201ed60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md @@ -16,7 +16,7 @@ An explicit specialization was ill formed. ## Example -The following sample generates C3212: +The following example generates C3212: ```cpp // C3212.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md index e35b9de91f2..ea62632e156 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md @@ -16,7 +16,7 @@ A type that will be visible from an assembly must use publicly visible base clas ## Example -The following sample generates C3213: +The following example generates C3213: ```cpp // C3213.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md index 9e259439402..3945380f054 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md @@ -16,7 +16,7 @@ The type was specified for an instantiation of a generic class that does not mee ## Example -The following sample generates C3214: +The following example generates C3214: ```cpp // C3214.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md index 5d336d7b6d6..5e611fc7a7e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md @@ -18,7 +18,7 @@ For more information on generics, see [Generics](../../extensions/generics-cpp-c ## Example -The following sample generates C3215: +The following example generates C3215: ```cpp // C3215.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md index 350930786ae..a5e01a51a55 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md @@ -16,7 +16,7 @@ A constraint was ill formed. ## Example -The following sample generates C3216: +The following example generates C3216: ```cpp // C3216.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md index 7176aa35996..253bda8d877 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md @@ -16,7 +16,7 @@ A constraint was ill formed; the constraint generic parameter must agree with th ## Example -The following sample generates C3217: +The following example generates C3217: ```cpp // C3217.cpp @@ -31,7 +31,7 @@ ref class C { }; ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3217b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md index 822a1622b7f..732f2dc54b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md @@ -16,7 +16,7 @@ For a type to be a constraint, it must be either a value type or reference to a ## Example -The following sample generates C3218. +The following example generates C3218. ```cpp // C3218.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md index 94434e97894..6277a80b32f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md @@ -16,7 +16,7 @@ It is not valid to constrain a generic parameter by two or more managed classes. ## Example -The following sample generates C3219: +The following example generates C3219: ```cpp // C3219.cpp @@ -29,7 +29,7 @@ where T : A, B ref class E {}; // C3219 ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3219b.cpp From b1fdb9fec7a2060f70829fa474b3b8d1bda546eb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 23:15:00 +0800 Subject: [PATCH 0800/1799] Update metadata for error references in range [C3191, C3220] --- .../error-messages/compiler-errors-2/compiler-error-c3192.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3194.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3195.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3196.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3197.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3198.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3199.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3200.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3201.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3202.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3203.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3204.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3205.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3206.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3207.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3208.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3209.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3210.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3211.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3212.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3213.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3214.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3215.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3216.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3217.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3218.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3219.md | 5 ++--- 27 files changed, 54 insertions(+), 81 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md index cf344cb163c..28b5f9c2d5a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3192" title: "Compiler Error C3192" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3192" +ms.date: 11/04/2016 f1_keywords: ["C3192"] helpviewer_keywords: ["C3192"] -ms.assetid: 8b0083d4-706f-46f6-858a-e1d9af464cf8 --- # Compiler Error C3192 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md index aea7b336136..8db7784857a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3194" title: "Compiler Error C3194" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3194" +ms.date: 11/04/2016 f1_keywords: ["C3194"] helpviewer_keywords: ["C3194"] -ms.assetid: 49d3ffc6-eff6-4b46-865b-18811692a8bb --- # Compiler Error C3194 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md index 773285472b0..ec488b88ac7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3195" title: "Compiler Error C3195" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3195" +ms.date: 11/04/2016 f1_keywords: ["C3195"] helpviewer_keywords: ["C3195"] -ms.assetid: 97e4f681-812b-49e8-ba57-24b7817e3cd8 --- # Compiler Error C3195 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md index ce589dca258..070c0c87ed4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3196" title: "Compiler Error C3196" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3196" +ms.date: 11/04/2016 f1_keywords: ["C3196"] helpviewer_keywords: ["C3196"] -ms.assetid: d9c38a13-191d-472d-aa2b-f61a6459d16c --- # Compiler Error C3196 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md index 06e64c69b7e..3362584a4a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3197" title: "Compiler Error C3197" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3197" +ms.date: 11/04/2016 f1_keywords: ["C3197"] helpviewer_keywords: ["C3197"] -ms.assetid: 4e385c3b-222e-425c-9612-46e83ed41650 --- # Compiler Error C3197 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md index 76dd7c51bbb..b871f254a6e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3198" title: "Compiler Error C3198" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3198" +ms.date: 11/04/2016 f1_keywords: ["C3198"] helpviewer_keywords: ["C3198"] -ms.assetid: ec4ecf61-0067-4aa4-b443-a91013a1e59d --- # Compiler Error C3198 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md index 865fb26a490..fd0da44ace7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3199" title: "Compiler Error C3199" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3199" +ms.date: 11/04/2016 f1_keywords: ["C3199"] helpviewer_keywords: ["C3199"] -ms.assetid: e7a478d3-115a-40a3-991b-c7454fd2e28e --- # Compiler Error C3199 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3200.md b/docs/error-messages/compiler-errors-2/compiler-error-c3200.md index 447467d6873..548a0b21c5a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3200.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3200.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3200" title: "Compiler Error C3200" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3200" +ms.date: 11/04/2016 f1_keywords: ["C3200"] helpviewer_keywords: ["C3200"] -ms.assetid: 44bb5e77-f0ec-421c-a732-b9ee7c0a3529 --- # Compiler Error C3200 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md index 049418dfddb..610eefee9db 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3201" title: "Compiler Error C3201" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3201" +ms.date: 11/04/2016 f1_keywords: ["C3201"] helpviewer_keywords: ["C3201"] -ms.assetid: ec19cd64-1789-40a3-b2db-dff2852b9d98 --- # Compiler Error C3201 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md index 8847ab99955..f84c285a958 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3202" title: "Compiler Error C3202" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3202" +ms.date: 11/04/2016 f1_keywords: ["C3202"] helpviewer_keywords: ["C3202"] -ms.assetid: 23528a0c-5493-4804-9789-cd3c38e49fb9 --- # Compiler Error C3202 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md index ca40ee3e3dc..a68ffb619c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3203" title: "Compiler Error C3203" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3203" +ms.date: 11/04/2016 f1_keywords: ["C3203"] helpviewer_keywords: ["C3203"] -ms.assetid: 6356770e-22c1-434c-91fe-f60b0aa23b91 --- # Compiler Error C3203 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md index 14f043bb5b4..fcbc33e8a80 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3204" title: "Compiler Error C3204" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3204" +ms.date: 11/04/2016 f1_keywords: ["C3204"] helpviewer_keywords: ["C3204"] -ms.assetid: 06e578da-0262-48c8-b2ae-be1cd6d28884 --- # Compiler Error C3204 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md index 9120edff432..0e0223a4cd1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3205" title: "Compiler Error C3205" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3205" +ms.date: 11/04/2016 f1_keywords: ["C3205"] helpviewer_keywords: ["C3205"] -ms.assetid: 802d306e-5ff3-4491-8a22-c5f1c072d005 --- # Compiler Error C3205 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md index eb14c962a23..188fa575037 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3206" title: "Compiler Error C3206" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3206" +ms.date: 11/04/2016 f1_keywords: ["C3206"] helpviewer_keywords: ["C3206"] -ms.assetid: d62995b5-e349-4418-bbe8-8a5e776ca7b0 --- # Compiler Error C3206 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md index aeba4cfc66c..b26b866d47d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3207" title: "Compiler Error C3207" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3207" +ms.date: 11/04/2016 f1_keywords: ["C3207"] helpviewer_keywords: ["C3207"] -ms.assetid: 4a28b976-142a-4cff-aa2f-480b892c50ca --- # Compiler Error C3207 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md index 2e53622c72e..f8478e5ba06 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3208" title: "Compiler Error C3208" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3208" +ms.date: 11/04/2016 f1_keywords: ["C3208"] helpviewer_keywords: ["C3208"] -ms.assetid: 6d060bfe-52cf-4599-8f70-bdeb5a670df3 --- # Compiler Error C3208 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md index 6877cb55c63..7be3106af49 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3209" title: "Compiler Error C3209" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3209" +ms.date: 11/04/2016 f1_keywords: ["C3209"] helpviewer_keywords: ["C3209"] -ms.assetid: 1de44e39-69d1-4894-8f89-ff92136e8e5d --- # Compiler Error C3209 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md index 9c251364d52..bea665dad72 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3210" title: "Compiler Error C3210" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3210" +ms.date: 11/04/2016 f1_keywords: ["C3210"] helpviewer_keywords: ["C3210"] -ms.assetid: c6e9d309-fabc-4e7d-b526-be20d9fe3f6a --- # Compiler Error C3210 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md index 943787ce999..be567ccd716 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3211" title: "Compiler Error C3211" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3211" +ms.date: 11/04/2016 f1_keywords: ["C3211"] helpviewer_keywords: ["C3211"] -ms.assetid: 85e33fed-3b59-4315-97e6-20d31c6a985a --- # Compiler Error C3211 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md index 726b201ed60..0364fb2ac86 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3212" title: "Compiler Error C3212" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3212" +ms.date: 11/04/2016 f1_keywords: ["C3212"] helpviewer_keywords: ["C3212"] -ms.assetid: 9e271bb6-a51f-4b96-b26b-9f4ca28fca0a --- # Compiler Error C3212 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md index ea62632e156..92f037e2fc1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3213" title: "Compiler Error C3213" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3213" +ms.date: 11/04/2016 f1_keywords: ["C3213"] helpviewer_keywords: ["C3213"] -ms.assetid: 1f079e36-b3e9-40f8-8e95-08eeba3adc82 --- # Compiler Error C3213 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md index 3945380f054..7f83f18b2e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3214" title: "Compiler Error C3214" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3214" +ms.date: 11/04/2016 f1_keywords: ["C3214"] helpviewer_keywords: ["C3214"] -ms.assetid: 49ee4a9a-2549-4adb-9d3a-38e154303c2e --- # Compiler Error C3214 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md index 5e611fc7a7e..23799ce938e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3215" title: "Compiler Error C3215" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3215" +ms.date: 11/04/2016 f1_keywords: ["C3215"] helpviewer_keywords: ["C3215"] -ms.assetid: d0d16007-8885-42e0-b086-2d3a61f348c5 --- # Compiler Error C3215 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md index a5e01a51a55..22291b161a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3216" title: "Compiler Error C3216" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3216" +ms.date: 11/04/2016 f1_keywords: ["C3216"] helpviewer_keywords: ["C3216"] -ms.assetid: bbab1efe-8779-4489-8bb0-b11e45f5cbe5 --- # Compiler Error C3216 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md index 253bda8d877..c2628b1b6b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3217" title: "Compiler Error C3217" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3217" +ms.date: 11/04/2016 f1_keywords: ["C3217"] helpviewer_keywords: ["C3217"] -ms.assetid: 99070417-c23a-4d82-bdd2-04be1a07adea --- # Compiler Error C3217 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md index 732f2dc54b6..691dc13049b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3218" title: "Compiler Error C3218" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3218" +ms.date: 11/04/2016 f1_keywords: ["C3218"] helpviewer_keywords: ["C3218"] -ms.assetid: 0eea19e0-503e-4e07-ae8b-2cb2e95922cd --- # Compiler Error C3218 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md index 6277a80b32f..4800bece797 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3219" title: "Compiler Error C3219" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3219" +ms.date: 11/04/2016 f1_keywords: ["C3219"] helpviewer_keywords: ["C3219"] -ms.assetid: 9c9757b0-1256-4cdf-9d8c-a3a72f300ce5 --- # Compiler Error C3219 From 42e0d8e089bc6d6c8924771aca3ef9676eb8a823 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 15 Aug 2025 23:17:55 +0800 Subject: [PATCH 0801/1799] Add leading example sentence in C3201 and C3203 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3201.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3203.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md index 610eefee9db..6799ee98060 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md @@ -15,6 +15,8 @@ You passed a class template in the argument to a class template that does not ta ## Example +The following example generates C3201: + ```cpp // C3201.cpp template diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md index a68ffb619c0..9eda8670397 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md @@ -17,6 +17,8 @@ This error can be generated as a result of compiler conformance work that was do ## Examples +The following example generates C3203: + ```cpp // C3203.cpp template< typename T > From 9104da338a88710a68bb4fa63df38bdfd6e17907 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Fri, 15 Aug 2025 10:51:35 -0700 Subject: [PATCH 0802/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 28ed0085b32..7e4d920abde 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -15,7 +15,7 @@ The following is a list of actively supported options for the AddressSanitizer. | Flag | Default value | Description | |------|---------------|-------------| -|`abort_on_error` | `false` | If `true`, the tool calls `abort()` instead of `_exit()` after printing the error report.| +|`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Enables runtime detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| |`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| |`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` and fail when out of memory instead of crashing.| From eeed5516753f2b44010fa0e703c6aa1359d3a6bc Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Fri, 15 Aug 2025 10:52:05 -0700 Subject: [PATCH 0803/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 7e4d920abde..1c2b66a5a59 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -16,7 +16,8 @@ The following is a list of actively supported options for the AddressSanitizer. | Flag | Default value | Description | |------|---------------|-------------| |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| -|`alloc_dealloc_mismatch` | `false` | Enables runtime detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| +|`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| + |`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| |`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` and fail when out of memory instead of crashing.| |`allocator_release_to_os_interval_ms` | `-1` | Experimental. 64-bit allocator only. Specify minimum time interval in ms between attempts to release memory.| From 8a8a77f85163f0d810f2a6672126ae55b3041387 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Fri, 15 Aug 2025 11:04:27 -0700 Subject: [PATCH 0804/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 1c2b66a5a59..35dfbf3d395 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -31,7 +31,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`disable_coredump` | `true`/`false` (on non-64-bit systems) | Disables core dumping. By default, the tool sets `disable_coredump=1` on 64-bit systems to prevent dumping a 16T+ core file. The tool ignores this flag on operating systems that don't dump core by default and for sanitizers that don't reserve large amounts of virtual memory.| |`exitcode` | `1` | Override the program exit status with this value if the tool found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, the tool will search `$PATH` for the symbolizer.| -|`fast_unwind_on_malloc` | `true` | If available, the tool uses the fast frame-pointer-based unwinder on `malloc`/`free`.| +|`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| |`full_address_space` | `false` | Sanitize complete address space; by default kernel area on 32-bit platforms will not be sanitized.| |`halt_on_error` | `true` | Exit/abort the program after printing the first error report (May cause undefined behavior, use `continue_on_error` for full support).| |`handle_segv` | `true` | `false` - ASan will not handle `SEGV` errors, `true` - ASan handles `SEGV` errors.| From 6e7f3832dfe2bba538230ffe2385315f3bdf5cc8 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Fri, 15 Aug 2025 12:26:13 -0700 Subject: [PATCH 0805/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 35dfbf3d395..cd15d820ab1 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -52,7 +52,8 @@ The following is a list of actively supported options for the AddressSanitizer. |`max_redzone` | `2048` | Maximal size (in bytes) of redzones around heap objects.| |`min_uar_stack_size_log` | `16` | Minimum fake stack size log. (Minimum value accepted: `16`).| |`new_delete_type_mismatch` | `true` | Report errors on mismatch betwen size of new and delete. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| -|`poison_heap` | `true` | Poison (or not) the heap memory on [de]allocation. Zero value is useful for benchmarking the allocator or instrumentator.| +|`poison_heap` | `true` | Poison (or not) the heap memory on (de-)allocation. Zero value is useful for benchmarking the allocator or instrumentator.| + |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| |`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| From 8d84c4cf0866c55a37aa25b236f2171d567ce7ec Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 15 Aug 2025 12:39:05 -0700 Subject: [PATCH 0806/1799] Remove more unused flags --- docs/sanitizers/asan-flags.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 35dfbf3d395..216b2b13424 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -17,22 +17,18 @@ The following is a list of actively supported options for the AddressSanitizer. |------|---------------|-------------| |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| - |`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| |`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` and fail when out of memory instead of crashing.| |`allocator_release_to_os_interval_ms` | `-1` | Experimental. 64-bit allocator only. Specify minimum time interval in ms between attempts to release memory.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned.| -|`atexit` | `false` | If `true`, prints ASan exit stats even after program terminates successfully.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If >`0`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects. Higher values increase detection effort.| |`detect_stack_use_after_return` | `false` | Enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| -|`disable_coredump` | `true`/`false` (on non-64-bit systems) | Disables core dumping. By default, the tool sets `disable_coredump=1` on 64-bit systems to prevent dumping a 16T+ core file. The tool ignores this flag on operating systems that don't dump core by default and for sanitizers that don't reserve large amounts of virtual memory.| |`exitcode` | `1` | Override the program exit status with this value if the tool found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, the tool will search `$PATH` for the symbolizer.| |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| -|`full_address_space` | `false` | Sanitize complete address space; by default kernel area on 32-bit platforms will not be sanitized.| |`halt_on_error` | `true` | Exit/abort the program after printing the first error report (May cause undefined behavior, use `continue_on_error` for full support).| |`handle_segv` | `true` | `false` - ASan will not handle `SEGV` errors, `true` - ASan handles `SEGV` errors.| |`handle_sigfpe` | `true` | `false` - ASan will not handle `SIGFPE` errors, `true` - ASan will handle `SIGFPE` errors.| @@ -43,9 +39,6 @@ The following is a list of actively supported options for the AddressSanitizer. |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for strpbrk function to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for strspn and strcspn function to find more errors.| |`intercept_strstr` | `true` | If `true`, uses custom wrappers for strstr and strcasestr functions to find more errors.| -|`log_exe_name` | `false` | Mention name of executable when reporting error and append executable name to logs (as in `log_path.exe_name.pid`).| -|`log_path` | `stderr` | Write logs to `log_path.pid`. The special values are `stdout` and `stderr`. The default is `stderr`.| -|`log_to_syslog` | `false` | Write all sanitizer output to syslog in addition to other means of logging.| |`malloc_context_size` | `1` | Max number of stack frames kept for each allocation/deallocation.| |`malloc_fill_byte` | `0xbe` | Value used to fill the newly allocated memory.| |`max_malloc_fill_size` | `4096` | ASan allocator flag. `max_malloc_fill_size` is the maximal amount of bytes that will be filled with `malloc_fill_byte` on `malloc`.| From 6d7cd9c7c0aefa2a04fdaf88a1b9974c12603e44 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 15 Aug 2025 12:39:18 -0700 Subject: [PATCH 0807/1799] Fix verbiage --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 216b2b13424..dcfcbbd7db0 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -24,7 +24,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| -|`detect_invalid_pointer_pairs` | `0` | If >`0`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects. Higher values increase detection effort.| +|`detect_invalid_pointer_pairs` | `0` | If `1`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`exitcode` | `1` | Override the program exit status with this value if the tool found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, the tool will search `$PATH` for the symbolizer.| From 925462e539596a47a1c9b34b8734f77d80f4fa62 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 15 Aug 2025 12:39:27 -0700 Subject: [PATCH 0808/1799] Fix verbiage --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index dcfcbbd7db0..fc20008d032 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -35,7 +35,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`handle_sigill` | `true` | `false` - ASan will not handle `SIGILL` errors, `true` - ASan will handle `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to console.| |`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| -|`include_if_exists` | `""` | Read more options from the given file (if it exists).| +|`include_if_exists` | `""` | Takes a path to a file, and reads options from the given file. ASan does not fail if file does not exist.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for strpbrk function to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for strspn and strcspn function to find more errors.| |`intercept_strstr` | `true` | If `true`, uses custom wrappers for strstr and strcasestr functions to find more errors.| From 3696d2bd5a13229c0bac7eed951c226a541a5821 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 15 Aug 2025 12:39:45 -0700 Subject: [PATCH 0809/1799] Remove flag and fix verbiage --- docs/sanitizers/asan-flags.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index fc20008d032..441fd51018c 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -18,8 +18,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| |`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| -|`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` and fail when out of memory instead of crashing.| -|`allocator_release_to_os_interval_ms` | `-1` | Experimental. 64-bit allocator only. Specify minimum time interval in ms between attempts to release memory.| +|`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` and when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution resumes.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| From adb8ee326b50c6acbff9020dd0f6c3dc5d87bb36 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 15 Aug 2025 12:46:50 -0700 Subject: [PATCH 0810/1799] Improve verbiage --- docs/sanitizers/asan-flags.md | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 441fd51018c..78ab019c135 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -24,14 +24,14 @@ The following is a list of actively supported options for the AddressSanitizer. |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If `1`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| -|`detect_stack_use_after_return` | `false` | Enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| +|`detect_stack_use_after_return` | `false` | If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`exitcode` | `1` | Override the program exit status with this value if the tool found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, the tool will search `$PATH` for the symbolizer.| |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| -|`halt_on_error` | `true` | Exit/abort the program after printing the first error report (May cause undefined behavior, use `continue_on_error` for full support).| -|`handle_segv` | `true` | `false` - ASan will not handle `SEGV` errors, `true` - ASan handles `SEGV` errors.| -|`handle_sigfpe` | `true` | `false` - ASan will not handle `SIGFPE` errors, `true` - ASan will handle `SIGFPE` errors.| -|`handle_sigill` | `true` | `false` - ASan will not handle `SIGILL` errors, `true` - ASan will handle `SIGILL` errors.| +|`halt_on_error` | `true` | Not supported. Use `continue_on_error` for full support.| +|`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.| +|`handle_sigfpe` | `true` | If `true`, ASan will handle `SIGFPE` errors.| +|`handle_sigill` | `true` | If `true`, ASan will handle `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to console.| |`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include_if_exists` | `""` | Takes a path to a file, and reads options from the given file. ASan does not fail if file does not exist.| @@ -42,13 +42,11 @@ The following is a list of actively supported options for the AddressSanitizer. |`malloc_fill_byte` | `0xbe` | Value used to fill the newly allocated memory.| |`max_malloc_fill_size` | `4096` | ASan allocator flag. `max_malloc_fill_size` is the maximal amount of bytes that will be filled with `malloc_fill_byte` on `malloc`.| |`max_redzone` | `2048` | Maximal size (in bytes) of redzones around heap objects.| -|`min_uar_stack_size_log` | `16` | Minimum fake stack size log. (Minimum value accepted: `16`).| |`new_delete_type_mismatch` | `true` | Report errors on mismatch betwen size of new and delete. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| |`poison_heap` | `true` | Poison (or not) the heap memory on [de]allocation. Zero value is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| |`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| -|`quarantine_size` | `-1` | Deprecated, please use `quarantine_size_mb`.| |`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| |`redzone` | `16` | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| @@ -58,8 +56,6 @@ The following is a list of actively supported options for the AddressSanitizer. |`strict_memcmp` | `true` | If `true`, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| |`strict_string_checks` | `false` | If `true` check that string arguments are properly null-terminated.| |`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| -|`suppress_equal_pcs` | `true` | Deduplicate multiple reports for single source location in `halt_on_error=false` mode.| -|`suppressions` | `""` | Suppresses file name.| |`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses to file or line locations.| |`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| |`verbosity` | `0` | Verbosity level: `0` - default, `1` - more, `2+` - even more output.| From de63d18872b70764e80b249e14bf49b103ced63e Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 15 Aug 2025 12:47:18 -0700 Subject: [PATCH 0811/1799] Fix table syntax --- docs/sanitizers/asan-flags.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index ea82934c1b0..aaad77936cc 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -44,7 +44,6 @@ The following is a list of actively supported options for the AddressSanitizer. |`max_redzone` | `2048` | Maximal size (in bytes) of redzones around heap objects.| |`new_delete_type_mismatch` | `true` | Report errors on mismatch betwen size of new and delete. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| |`poison_heap` | `true` | Poison (or not) the heap memory on (de-)allocation. Zero value is useful for benchmarking the allocator or instrumentator.| - |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| |`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| From f05cd86459d16126e3b74b2ccce2b8d90e5b3511 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 15 Aug 2025 12:58:29 -0700 Subject: [PATCH 0812/1799] Added experimental disclaimer --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index aaad77936cc..6823211bdca 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -24,7 +24,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If `1`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| -|`detect_stack_use_after_return` | `false` | If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| +|`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`exitcode` | `1` | Override the program exit status with this value if the tool found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, the tool will search `$PATH` for the symbolizer.| |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| From b4a378dbab8c6c30b1f5c468698a0e91e1c3239d Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 15 Aug 2025 13:06:01 -0700 Subject: [PATCH 0813/1799] We still honor quarantine_size --- docs/sanitizers/asan-flags.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 6823211bdca..55d1fb49d4d 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -47,6 +47,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| |`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| +|`quarantine_size` | `-1` | Deprecated, please use `quarantine_size_mb`.| |`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| |`redzone` | `16` | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| From e553bab2d5d84179286818b343f51468306604f6 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Fri, 15 Aug 2025 13:23:24 -0700 Subject: [PATCH 0814/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 55d1fb49d4d..0b7721fc361 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -18,7 +18,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| |`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| -|`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` and when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution resumes.| +|`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| From 21412ee0c5df9304492980ae171b9d33b82e9beb Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Fri, 15 Aug 2025 13:27:04 -0700 Subject: [PATCH 0815/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 0b7721fc361..046c1e01f19 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -19,7 +19,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| |`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| |`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| -|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned.| +|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](https://learn.microsoft.com/en-us/cpp/sanitizers/asan-runtime?view=msvc-170#poisoning) APIs.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| From ec3814b5a4a7cdbf135be181bfcc6f91780dc43e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 16 Aug 2025 22:16:59 +0800 Subject: [PATCH 0816/1799] Add blockquotes for error messages in range [C3221, C3250] --- docs/error-messages/compiler-errors-2/compiler-error-c3222.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3223.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3224.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3225.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3226.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3227.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3228.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3229.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3230.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3231.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3232.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3233.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3234.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3235.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3236.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3237.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3238.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3239.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3240.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3241.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3242.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3243.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3244.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3246.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3247.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3248.md | 2 +- 26 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md index 09815402d91..b334fbfdc69 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md @@ -8,7 +8,7 @@ ms.assetid: 5624bde8-2fd0-4b8b-92ce-5dfbaf91cf93 --- # Compiler Error C3222 -'parameter' : cannot declare default arguments for member functions of a managed or WinRT type or generic functions +> 'parameter' : cannot declare default arguments for member functions of a managed or WinRT type or generic functions It is not permitted to declare a method parameter with a default argument. An overloaded form of the method is one way to work around this issue. That is, define a method with the same name with no parameters and then initialize the variable in the method body. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md index 0895d06aaa9..8cd6cdfae7b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md @@ -8,7 +8,7 @@ ms.assetid: 1f4380b4-0413-40db-a868-62f97babaf78 --- # Compiler Error C3223 -'property' : you cannot apply 'typeid' to a property +> 'property' : you cannot apply 'typeid' to a property You cannot apply [typeid](../../extensions/typeid-cpp-component-extensions.md) to a property. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md index 3262737e78b..1c70ef385e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md @@ -8,7 +8,7 @@ ms.assetid: 129be22f-8f3e-4fc6-9ccd-d27d8ef91251 --- # Compiler Error C3224 -'type' : no overloaded generic class takes 'number' generic type arguments +> 'type' : no overloaded generic class takes 'number' generic type arguments The compiler failed to find an appropriate overload. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md index d43f5993964..d774ccbc59e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md @@ -8,7 +8,7 @@ ms.assetid: f5f66973-256e-4298-ac46-c87819cbde34 --- # Compiler Error C3225 -generic type argument for 'arg' cannot be 'type', it must be a value type or handle type +> generic type argument for 'arg' cannot be 'type', it must be a value type or handle type The generic type argument was not of the correct type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md index ecdbe62b7b5..9b52ecd39f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md @@ -8,7 +8,7 @@ ms.assetid: 636106ca-6f4e-4303-a6a0-8803221ec67d --- # Compiler Error C3226 -A template declaration is not allowed inside a generic declaration +> A template declaration is not allowed inside a generic declaration Use a generic declaration inside a generic class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md index 4917215a910..80cb2f637df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md @@ -8,7 +8,7 @@ ms.assetid: 7939c23a-96c8-43c2-89e9-f217d132d155 --- # Compiler Error C3227 -'parameter' : cannot use 'keyword' to allocate a generic type +> 'parameter' : cannot use 'keyword' to allocate a generic type In order to instantiate a type, an appropriate constructor is required. However, the compiler is not able to ensure that an appropriate constructor is available. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md index 78fa2305b55..2d470109bb8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md @@ -8,7 +8,7 @@ ms.assetid: 9015adf9-17b0-4312-b4a7-c1f33e4126f4 --- # Compiler Error C3228 -'function' : generic type argument for 'param' cannot be 'type', it must be a valuetype or handle type +> 'function' : generic type argument for 'param' cannot be 'type', it must be a valuetype or handle type An incorrect type was passed as a generic type argument. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md index ed9e525ef2c..a4942eb12d4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md @@ -8,7 +8,7 @@ ms.assetid: f2d90923-aa8b-444f-ab10-1f37dbb864e1 --- # Compiler Error C3229 -'type' : indirections on a generic type parameter are not allowed +> 'type' : indirections on a generic type parameter are not allowed You cannot use generic parameters with `*`, `^`, or `&`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md index 75fbf6d7d1c..efa713316c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md @@ -8,7 +8,7 @@ ms.assetid: 5ec53f25-59f6-4801-81e7-7b68bf04994d --- # Compiler Error C3230 -'function' : template type argument for 'template' cannot contain a generic type parameter: 'param' +> 'function' : template type argument for 'template' cannot contain a generic type parameter: 'param' Templates are instantiated at compile time, but generics are instantiated at run time. Therefore, it is not possible to generate generic code that can call the template because the template cannot be instantiated at run time when the generic type is finally known. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md index 8b4b8d161bf..188c1c39232 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md @@ -8,7 +8,7 @@ ms.assetid: fe5dc352-e634-45fa-9534-3da176294c98 --- # Compiler Error C3231 -'arg' : template type argument cannot use a generic type parameter +> 'arg' : template type argument cannot use a generic type parameter Templates are instantiated at compile time, but generics are instantiated at run time. Therefore, it is not possible to generate generic code that can call the template because the template cannot be instantiated at run time when the generic type is finally known. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md index ed8f0a32c43..0e649608bcf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md @@ -8,7 +8,7 @@ ms.assetid: 3119b3a9-0eff-4a3f-b805-e4d160af9e39 --- # Compiler Error C3232 -'param' : a generic type parameter cannot be used in a qualified name +> 'param' : a generic type parameter cannot be used in a qualified name A generic type parameter was used incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md index cab7999c98c..00258840026 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md @@ -8,7 +8,7 @@ ms.assetid: a9210830-1136-4f02-ba41-030c85f93547 --- # Compiler Error C3233 -'type' : generic type parameter already constrained +> 'type' : generic type parameter already constrained It is not valid to constrain a generic parameter in more than one `where` clause. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md index 0239ec60f31..aca2c2cb1cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md @@ -8,7 +8,7 @@ ms.assetid: ebefc15a-e40d-424b-a3dd-d7e185d0ed7b --- # Compiler Error C3234 -a generic class may not derive from a generic type parameter +> a generic class may not derive from a generic type parameter A generic class cannot inherit from a generic type parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md index 40c569e6718..6372a127e41 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md @@ -8,7 +8,7 @@ ms.assetid: 0554d6c7-e1dc-4c99-8934-cbcf491c8203 --- # Compiler Error C3235 -'specialization' : explicit or partial specialization of a generic class is not allowed +> 'specialization' : explicit or partial specialization of a generic class is not allowed Generic classes cannot be used for explicit or partial specializations. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md index 7bdd011603e..22243cf6265 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md @@ -8,7 +8,7 @@ ms.assetid: 4ef1871f-a348-44ae-922b-1e2081de20d0 --- # Compiler Error C3236 -explicit instantiation of a generic is not allowed +> explicit instantiation of a generic is not allowed The compiler does not allow explicit instantiation of generic classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md index 5faaa77e2c8..7c06c794ceb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md @@ -8,7 +8,7 @@ ms.assetid: 690970c8-e13b-4ff3-96e3-5fd93c4d356b --- # Compiler Error C3237 -'generic_class' : a generic class cannot be a custom attribute +> 'generic_class' : a generic class cannot be a custom attribute Generic classes cannot be user-defined attributes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md index fa015df2c29..2237497c130 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md @@ -8,7 +8,7 @@ ms.assetid: 19942497-b3c5-4df0-9144-142ced92468b --- # Compiler Error C3238 -'type' : a type with this name has already been forwarded to assembly 'assembly' +> 'type' : a type with this name has already been forwarded to assembly 'assembly' A type was defined in a client application that is also defined, via type forwarding syntax, in a referenced assembly. Both types cannot be defined in the scope of the application. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md index 9c080208e2a..7cbbdecb934 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md @@ -8,7 +8,7 @@ ms.assetid: 22a518b7-020f-4f3c-9963-a094667fd1ac --- # Compiler Error C3239 -'type' : pointer to interior/pin pointer is disallowed by the common language runtime +> 'type' : pointer to interior/pin pointer is disallowed by the common language runtime The compiler encountered an invalid type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md index 4dd2cc0d81f..77db2a352ab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md @@ -8,7 +8,7 @@ ms.assetid: 1a8dc213-b80c-47ae-ada0-e9554b635d1e --- # Compiler Error C3240 -'function' : must be a non-overloaded abstract member function of 'type' +> 'function' : must be a non-overloaded abstract member function of 'type' A base type contained a function that was defined. Function must be virtual. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md index 34ba8ad6560..ace744db3bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md @@ -8,7 +8,7 @@ ms.assetid: 2ca14879-bba0-4a23-b22a-72cfff92d6a4 --- # Compiler Error C3241 -'method' : this method was not introduced by 'interface' +> 'method' : this method was not introduced by 'interface' When you explicitly override a function, the function signature must exactly match the declaration for the function that you are overriding. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3242.md b/docs/error-messages/compiler-errors-2/compiler-error-c3242.md index 323f6db037c..86c24ece1b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3242.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3242.md @@ -8,6 +8,6 @@ ms.assetid: c7621ced-d5c7-4595-904b-bd871676784c --- # Compiler Error C3242 -'function' : you can only explicitly override virtual functions +> 'function' : you can only explicitly override virtual functions You tried to explicitly override a nonvirtual method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md index a250dd83090..e8b4c1a9b05 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md @@ -8,7 +8,7 @@ ms.assetid: 35d8ad1a-377d-47df-be9d-c55eea23340f --- # Compiler Error C3243 -none of the overload functions were introduced by 'interface' +> none of the overload functions were introduced by 'interface' You tried to [explicitly override](../../cpp/explicit-overrides-cpp.md) a member that does not exist in the specified interface. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md index acaad50b54a..82ca2ef344e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md @@ -8,7 +8,7 @@ ms.assetid: dae6c49b-5212-4206-8f61-d4010c0b9969 --- # Compiler Error C3244 -'method' : this method was introduced by 'interface' not by 'interface' +> 'method' : this method was introduced by 'interface' not by 'interface' You tried to [explicitly override](../../cpp/explicit-overrides-cpp.md) a member that does not exist in the specified interface but does exist in another base class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md index e3150e1036a..f480696567e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md @@ -8,7 +8,7 @@ ms.assetid: ad85224a-e540-479b-a5eb-a3bc3964c30b --- # Compiler Error C3246 -'class' : cannot inherit from 'type' as it has been declared as 'sealed' +> 'class' : cannot inherit from 'type' as it has been declared as 'sealed' A class that is marked as [sealed](../../extensions/sealed-cpp-component-extensions.md) cannot be the base class for any other classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md index b5fa60f4205..aa4d9756272 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md @@ -8,7 +8,7 @@ ms.assetid: f9a2bbb5-3fce-40bf-9fd3-835a5f164dbb --- # Compiler Error C3247 -'class1' : a coclass cannot inherit from another coclass 'class2' +> 'class1' : a coclass cannot inherit from another coclass 'class2' A class marked with the [coclass](../../windows/attributes/coclass.md) attribute cannot inherit from another class marked with the `coclass` attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3248.md b/docs/error-messages/compiler-errors-2/compiler-error-c3248.md index 700129cccdd..9c4639a7f70 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3248.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3248.md @@ -8,7 +8,7 @@ ms.assetid: d00b9d7d-b6be-4a5b-bb52-48174ea71fc4 --- # Compiler Error C3248 -'function1': function declared as '__sealed' cannot be overridden by 'function2' +> 'function1': function declared as '__sealed' cannot be overridden by 'function2' A derived class tried to override a **__sealed** virtual method. From 0dbfd7d3288d41e9db7868e19aea3ae1b3b433f4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 16 Aug 2025 22:23:55 +0800 Subject: [PATCH 0817/1799] Add "Remarks" and "Example" headings for error references in range [C3221, C3250] --- docs/error-messages/compiler-errors-2/compiler-error-c3222.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3223.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3224.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3225.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3226.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3227.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3228.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3229.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3230.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3231.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3232.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3233.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3234.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3235.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3236.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3237.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3238.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3239.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3240.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3241.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3242.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3243.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3244.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3246.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3247.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3248.md | 2 ++ 26 files changed, 82 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md index b334fbfdc69..9183a334154 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md @@ -10,8 +10,12 @@ ms.assetid: 5624bde8-2fd0-4b8b-92ce-5dfbaf91cf93 > 'parameter' : cannot declare default arguments for member functions of a managed or WinRT type or generic functions +## Remarks + It is not permitted to declare a method parameter with a default argument. An overloaded form of the method is one way to work around this issue. That is, define a method with the same name with no parameters and then initialize the variable in the method body. +## Example + The following sample generates C3222: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md index 8cd6cdfae7b..7936868323e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md @@ -10,6 +10,8 @@ ms.assetid: 1f4380b4-0413-40db-a868-62f97babaf78 > 'property' : you cannot apply 'typeid' to a property +## Remarks + You cannot apply [typeid](../../extensions/typeid-cpp-component-extensions.md) to a property. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md index 1c70ef385e8..8d2077d71cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md @@ -10,8 +10,12 @@ ms.assetid: 129be22f-8f3e-4fc6-9ccd-d27d8ef91251 > 'type' : no overloaded generic class takes 'number' generic type arguments +## Remarks + The compiler failed to find an appropriate overload. +## Example + The following sample generates C3224: ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md index d774ccbc59e..c86520b569f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md @@ -10,6 +10,8 @@ ms.assetid: f5f66973-256e-4298-ac46-c87819cbde34 > generic type argument for 'arg' cannot be 'type', it must be a value type or handle type +## Remarks + The generic type argument was not of the correct type. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md index 9b52ecd39f7..e80b912c718 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md @@ -10,8 +10,12 @@ ms.assetid: 636106ca-6f4e-4303-a6a0-8803221ec67d > A template declaration is not allowed inside a generic declaration +## Remarks + Use a generic declaration inside a generic class. +## Example + The following sample generates C3226: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md index 80cb2f637df..9e45bcaec7c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md @@ -10,6 +10,8 @@ ms.assetid: 7939c23a-96c8-43c2-89e9-f217d132d155 > 'parameter' : cannot use 'keyword' to allocate a generic type +## Remarks + In order to instantiate a type, an appropriate constructor is required. However, the compiler is not able to ensure that an appropriate constructor is available. You can use templates instead of generics to resolve this error, or you can use one of several methods to create an instance of the type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md index 2d470109bb8..f675df00379 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md @@ -10,8 +10,12 @@ ms.assetid: 9015adf9-17b0-4312-b4a7-c1f33e4126f4 > 'function' : generic type argument for 'param' cannot be 'type', it must be a valuetype or handle type +## Remarks + An incorrect type was passed as a generic type argument. +## Example + The following sample generates C3228: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md index a4942eb12d4..1d8488218bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md @@ -10,6 +10,8 @@ ms.assetid: f2d90923-aa8b-444f-ab10-1f37dbb864e1 > 'type' : indirections on a generic type parameter are not allowed +## Remarks + You cannot use generic parameters with `*`, `^`, or `&`. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md index efa713316c8..59da412d5ea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md @@ -10,8 +10,12 @@ ms.assetid: 5ec53f25-59f6-4801-81e7-7b68bf04994d > 'function' : template type argument for 'template' cannot contain a generic type parameter: 'param' +## Remarks + Templates are instantiated at compile time, but generics are instantiated at run time. Therefore, it is not possible to generate generic code that can call the template because the template cannot be instantiated at run time when the generic type is finally known. +## Example + The following sample generates C3230: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md index 188c1c39232..75a74a5995b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md @@ -10,8 +10,12 @@ ms.assetid: fe5dc352-e634-45fa-9534-3da176294c98 > 'arg' : template type argument cannot use a generic type parameter +## Remarks + Templates are instantiated at compile time, but generics are instantiated at run time. Therefore, it is not possible to generate generic code that can call the template because the template cannot be instantiated at run time when the generic type is finally known. +## Example + The following sample generates C3231: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md index 0e649608bcf..78e8cd845b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md @@ -10,8 +10,12 @@ ms.assetid: 3119b3a9-0eff-4a3f-b805-e4d160af9e39 > 'param' : a generic type parameter cannot be used in a qualified name +## Remarks + A generic type parameter was used incorrectly. +## Example + The following sample generates C3232: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md index 00258840026..8e6bf44e396 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md @@ -10,8 +10,12 @@ ms.assetid: a9210830-1136-4f02-ba41-030c85f93547 > 'type' : generic type parameter already constrained +## Remarks + It is not valid to constrain a generic parameter in more than one `where` clause. +## Example + The following sample generates C3233: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md index aca2c2cb1cd..969f9532ca9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md @@ -10,6 +10,8 @@ ms.assetid: ebefc15a-e40d-424b-a3dd-d7e185d0ed7b > a generic class may not derive from a generic type parameter +## Remarks + A generic class cannot inherit from a generic type parameter. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md index 6372a127e41..a783868304d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md @@ -10,6 +10,8 @@ ms.assetid: 0554d6c7-e1dc-4c99-8934-cbcf491c8203 > 'specialization' : explicit or partial specialization of a generic class is not allowed +## Remarks + Generic classes cannot be used for explicit or partial specializations. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md index 22243cf6265..fd35fd3e0fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md @@ -10,8 +10,12 @@ ms.assetid: 4ef1871f-a348-44ae-922b-1e2081de20d0 > explicit instantiation of a generic is not allowed +## Remarks + The compiler does not allow explicit instantiation of generic classes. +## Example + The following sample generates C3236: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md index 7c06c794ceb..a5c43c743f1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md @@ -10,6 +10,8 @@ ms.assetid: 690970c8-e13b-4ff3-96e3-5fd93c4d356b > 'generic_class' : a generic class cannot be a custom attribute +## Remarks + Generic classes cannot be user-defined attributes. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md index 2237497c130..430a8d3ba58 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md @@ -10,6 +10,8 @@ ms.assetid: 19942497-b3c5-4df0-9144-142ced92468b > 'type' : a type with this name has already been forwarded to assembly 'assembly' +## Remarks + A type was defined in a client application that is also defined, via type forwarding syntax, in a referenced assembly. Both types cannot be defined in the scope of the application. See [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md index 7cbbdecb934..44cb98ba65a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md @@ -10,8 +10,12 @@ ms.assetid: 22a518b7-020f-4f3c-9963-a094667fd1ac > 'type' : pointer to interior/pin pointer is disallowed by the common language runtime +## Remarks + The compiler encountered an invalid type. +## Example + The following sample generates C3229: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md index 77db2a352ab..9d5401b323e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md @@ -10,6 +10,8 @@ ms.assetid: 1a8dc213-b80c-47ae-ada0-e9554b635d1e > 'function' : must be a non-overloaded abstract member function of 'type' +## Remarks + A base type contained a function that was defined. Function must be virtual. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md index ace744db3bc..55ab8365251 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md @@ -10,8 +10,12 @@ ms.assetid: 2ca14879-bba0-4a23-b22a-72cfff92d6a4 > 'method' : this method was not introduced by 'interface' +## Remarks + When you explicitly override a function, the function signature must exactly match the declaration for the function that you are overriding. +## Example + The following sample generates C3241: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3242.md b/docs/error-messages/compiler-errors-2/compiler-error-c3242.md index 86c24ece1b8..8eb38f5649d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3242.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3242.md @@ -10,4 +10,6 @@ ms.assetid: c7621ced-d5c7-4595-904b-bd871676784c > 'function' : you can only explicitly override virtual functions +## Remarks + You tried to explicitly override a nonvirtual method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md index e8b4c1a9b05..2cdd3923457 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md @@ -10,8 +10,12 @@ ms.assetid: 35d8ad1a-377d-47df-be9d-c55eea23340f > none of the overload functions were introduced by 'interface' +## Remarks + You tried to [explicitly override](../../cpp/explicit-overrides-cpp.md) a member that does not exist in the specified interface. +## Example + The following sample generates C3243: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md index 82ca2ef344e..21285694e51 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md @@ -10,8 +10,12 @@ ms.assetid: dae6c49b-5212-4206-8f61-d4010c0b9969 > 'method' : this method was introduced by 'interface' not by 'interface' +## Remarks + You tried to [explicitly override](../../cpp/explicit-overrides-cpp.md) a member that does not exist in the specified interface but does exist in another base class. +## Example + The following sample generates C3244: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md index f480696567e..e7995ef59f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md @@ -10,8 +10,12 @@ ms.assetid: ad85224a-e540-479b-a5eb-a3bc3964c30b > 'class' : cannot inherit from 'type' as it has been declared as 'sealed' +## Remarks + A class that is marked as [sealed](../../extensions/sealed-cpp-component-extensions.md) cannot be the base class for any other classes. +## Example + The following sample generates C3246: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md index aa4d9756272..679f5746c35 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md @@ -10,8 +10,12 @@ ms.assetid: f9a2bbb5-3fce-40bf-9fd3-835a5f164dbb > 'class1' : a coclass cannot inherit from another coclass 'class2' +## Remarks + A class marked with the [coclass](../../windows/attributes/coclass.md) attribute cannot inherit from another class marked with the `coclass` attribute. +## Example + The following sample generates C3247: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3248.md b/docs/error-messages/compiler-errors-2/compiler-error-c3248.md index 9c4639a7f70..9708bc83379 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3248.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3248.md @@ -10,6 +10,8 @@ ms.assetid: d00b9d7d-b6be-4a5b-bb52-48174ea71fc4 > 'function1': function declared as '__sealed' cannot be overridden by 'function2' +## Remarks + A derived class tried to override a **__sealed** virtual method. C3248 is only reachable using the obsolete compiler option **/clr:oldSyntax**. From 057862396b8c6ef3a83a571a0ef582d9e1f71715 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 16 Aug 2025 22:25:55 +0800 Subject: [PATCH 0818/1799] Replace term "sample" with "example" for error references in range [C3221, C3250] --- .../compiler-errors-2/compiler-error-c3222.md | 2 +- .../compiler-errors-2/compiler-error-c3223.md | 2 +- .../compiler-errors-2/compiler-error-c3224.md | 2 +- .../compiler-errors-2/compiler-error-c3225.md | 6 +++--- .../compiler-errors-2/compiler-error-c3226.md | 4 ++-- .../compiler-errors-2/compiler-error-c3227.md | 2 +- .../compiler-errors-2/compiler-error-c3228.md | 2 +- .../compiler-errors-2/compiler-error-c3229.md | 4 ++-- .../compiler-errors-2/compiler-error-c3230.md | 2 +- .../compiler-errors-2/compiler-error-c3231.md | 2 +- .../compiler-errors-2/compiler-error-c3232.md | 2 +- .../compiler-errors-2/compiler-error-c3233.md | 2 +- .../compiler-errors-2/compiler-error-c3234.md | 2 +- .../compiler-errors-2/compiler-error-c3235.md | 2 +- .../compiler-errors-2/compiler-error-c3236.md | 4 ++-- .../compiler-errors-2/compiler-error-c3237.md | 2 +- .../compiler-errors-2/compiler-error-c3238.md | 6 +++--- .../compiler-errors-2/compiler-error-c3239.md | 2 +- .../compiler-errors-2/compiler-error-c3240.md | 2 +- .../compiler-errors-2/compiler-error-c3241.md | 2 +- .../compiler-errors-2/compiler-error-c3243.md | 2 +- .../compiler-errors-2/compiler-error-c3244.md | 2 +- .../compiler-errors-2/compiler-error-c3246.md | 2 +- .../compiler-errors-2/compiler-error-c3247.md | 2 +- 24 files changed, 31 insertions(+), 31 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md index 9183a334154..3e15410a201 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md @@ -16,7 +16,7 @@ It is not permitted to declare a method parameter with a default argument. An ov ## Example -The following sample generates C3222: +The following example generates C3222: ```cpp // C3222_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md index 7936868323e..be2ba14b85d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md @@ -16,7 +16,7 @@ You cannot apply [typeid](../../extensions/typeid-cpp-component-extensions.md) t ## Example -The following sample generates C3223. +The following example generates C3223. ```cpp // C3223.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md index 8d2077d71cf..255d8f263f3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md @@ -16,7 +16,7 @@ The compiler failed to find an appropriate overload. ## Example -The following sample generates C3224: +The following example generates C3224: ``` // C3224.cs diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md index c86520b569f..44b4bff1dcf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md @@ -18,7 +18,7 @@ For more information, see [Generics](../../extensions/generics-cpp-component-ext ## Examples -You cannot instantiate a generic type with a native type. The following sample generates C3225. +You cannot instantiate a generic type with a native type. The following example generates C3225. ```cpp // C3225.cpp @@ -36,7 +36,7 @@ int main() { } ``` -The following sample creates a component using C#. Notice that the constraint specifies that the generic type can only be instantiated with a value type. +The following example creates a component using C#. Notice that the constraint specifies that the generic type can only be instantiated with a value type. ``` // C3225_b.cs @@ -45,7 +45,7 @@ The following sample creates a component using C#. Notice that the constraint sp public class MyList where T: struct {} ``` -This sample consumes the C#-authored component, and violates the constraint that MyList can only be instantiated with a value type other than . The following sample generates C3225. +This example consumes the C#-authored component, and violates the constraint that MyList can only be instantiated with a value type other than . The following example generates C3225. ```cpp // C3225_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md index e80b912c718..f87d3b57b4a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md @@ -16,7 +16,7 @@ Use a generic declaration inside a generic class. ## Example -The following sample generates C3226: +The following example generates C3226: ```cpp // C3226.cpp @@ -28,7 +28,7 @@ ref class C { }; ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3226b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md index 9e45bcaec7c..9fc86ceb301 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md @@ -18,7 +18,7 @@ You can use templates instead of generics to resolve this error, or you can use ## Example -The following sample generates C3227. +The following example generates C3227. ```cpp // C3227.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md index f675df00379..b180997f0b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md @@ -16,7 +16,7 @@ An incorrect type was passed as a generic type argument. ## Example -The following sample generates C3228: +The following example generates C3228: ```cpp // C3228.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md index 1d8488218bd..bb6b95e1735 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md @@ -16,7 +16,7 @@ You cannot use generic parameters with `*`, `^`, or `&`. ## Examples -The following sample generates C3229. +The following example generates C3229. ```cpp // C3229.cpp @@ -33,7 +33,7 @@ ref class D { }; ``` -The following sample generates C3229. +The following example generates C3229. ```cpp // C3229_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md index 59da412d5ea..e664450c5ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md @@ -16,7 +16,7 @@ Templates are instantiated at compile time, but generics are instantiated at run ## Example -The following sample generates C3230: +The following example generates C3230: ```cpp // C3230.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md index 75a74a5995b..1ec2b826027 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md @@ -16,7 +16,7 @@ Templates are instantiated at compile time, but generics are instantiated at run ## Example -The following sample generates C3231: +The following example generates C3231: ```cpp // C3231.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md index 78e8cd845b0..56e7bbf0590 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md @@ -16,7 +16,7 @@ A generic type parameter was used incorrectly. ## Example -The following sample generates C3232: +The following example generates C3232: ```cpp // C3232.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md index 8e6bf44e396..4a6ded83496 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md @@ -16,7 +16,7 @@ It is not valid to constrain a generic parameter in more than one `where` clause ## Example -The following sample generates C3233: +The following example generates C3233: ```cpp // C3233.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md index 969f9532ca9..0cb1abbe0c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md @@ -16,7 +16,7 @@ A generic class cannot inherit from a generic type parameter. ## Example -The following sample generates C3234. +The following example generates C3234. ```cpp // C3234.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md index a783868304d..48676dc28fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md @@ -16,7 +16,7 @@ Generic classes cannot be used for explicit or partial specializations. ## Example -The following sample generates C3235. +The following example generates C3235. ```cpp // C3235.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md index fd35fd3e0fd..c32de9a2431 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md @@ -16,7 +16,7 @@ The compiler does not allow explicit instantiation of generic classes. ## Example -The following sample generates C3236: +The following example generates C3236: ```cpp // C3236.cpp @@ -27,7 +27,7 @@ public ref class X {}; generic ref class X; // C3236 ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3236b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md index a5c43c743f1..6a5959bce1d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md @@ -16,7 +16,7 @@ Generic classes cannot be user-defined attributes. ## Example -The following sample generates C3237. +The following example generates C3237. ```cpp // C3237.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md index 430a8d3ba58..2159b2a0a7c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md @@ -18,7 +18,7 @@ See [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md) for ## Examples -The following sample creates an assembly that contains a type that was forwarded from another assembly. +The following example creates an assembly that contains a type that was forwarded from another assembly. ```cpp // C3238.cpp @@ -26,7 +26,7 @@ The following sample creates an assembly that contains a type that was forwarded public ref class R {}; ``` -The following sample creates an assembly that used to contain the type definition, but not only contains type forwarding syntax. +The following example creates an assembly that used to contain the type definition, but not only contains type forwarding syntax. ```cpp // C3238_b.cpp @@ -35,7 +35,7 @@ The following sample creates an assembly that used to contain the type definitio [ assembly:TypeForwardedTo(R::typeid) ]; ``` -The following sample generates C3238. +The following example generates C3238. ```cpp // C3238_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md index 44cb98ba65a..fa35e0c881d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md @@ -16,7 +16,7 @@ The compiler encountered an invalid type. ## Example -The following sample generates C3229: +The following example generates C3229: ```cpp // C3239.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md index 9d5401b323e..38d3dcc888b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md @@ -16,7 +16,7 @@ A base type contained a function that was defined. Function must be virtual. ## Example -The following sample generates C3240. +The following example generates C3240. ```cpp // C3240.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md index 55ab8365251..e8c298ed9d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md @@ -16,7 +16,7 @@ When you explicitly override a function, the function signature must exactly mat ## Example -The following sample generates C3241: +The following example generates C3241: ```cpp // C3241.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md index 2cdd3923457..4f2f4fb074b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md @@ -16,7 +16,7 @@ You tried to [explicitly override](../../cpp/explicit-overrides-cpp.md) a member ## Example -The following sample generates C3243: +The following example generates C3243: ```cpp // C3243.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md index 21285694e51..9701b16b45b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md @@ -16,7 +16,7 @@ You tried to [explicitly override](../../cpp/explicit-overrides-cpp.md) a member ## Example -The following sample generates C3244: +The following example generates C3244: ```cpp // C3244.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md index e7995ef59f9..721d538bfc7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md @@ -16,7 +16,7 @@ A class that is marked as [sealed](../../extensions/sealed-cpp-component-extensi ## Example -The following sample generates C3246: +The following example generates C3246: ```cpp // C3246_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md index 679f5746c35..ba7221382b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md @@ -16,7 +16,7 @@ A class marked with the [coclass](../../windows/attributes/coclass.md) attribute ## Example -The following sample generates C3247: +The following example generates C3247: ```cpp // C3247.cpp From 5350e44e92397f2e4c2ba07fd587560a971dbe29 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 16 Aug 2025 22:30:05 +0800 Subject: [PATCH 0819/1799] Update metadata for error references in range [C3221, C3250] --- .../error-messages/compiler-errors-2/compiler-error-c3222.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3223.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3224.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3225.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3226.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3227.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3228.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3229.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3230.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3231.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3232.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3233.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3234.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3235.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3236.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3237.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3238.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3239.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3240.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3241.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3242.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3243.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3244.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3246.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3247.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3248.md | 5 ++--- 26 files changed, 52 insertions(+), 78 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md index 3e15410a201..0bf257f399f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3222" title: "Compiler Error C3222" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3222" +ms.date: 11/04/2016 f1_keywords: ["C3222"] helpviewer_keywords: ["C3222"] -ms.assetid: 5624bde8-2fd0-4b8b-92ce-5dfbaf91cf93 --- # Compiler Error C3222 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md index be2ba14b85d..778004eaa27 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3223" title: "Compiler Error C3223" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3223" +ms.date: 11/04/2016 f1_keywords: ["C3223"] helpviewer_keywords: ["C3223"] -ms.assetid: 1f4380b4-0413-40db-a868-62f97babaf78 --- # Compiler Error C3223 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md index 255d8f263f3..83735abdfb6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3224" title: "Compiler Error C3224" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3224" +ms.date: 11/04/2016 f1_keywords: ["C3224"] helpviewer_keywords: ["C3224"] -ms.assetid: 129be22f-8f3e-4fc6-9ccd-d27d8ef91251 --- # Compiler Error C3224 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md index 44b4bff1dcf..c0bb2c4af55 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3225" title: "Compiler Error C3225" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3225" +ms.date: 11/04/2016 f1_keywords: ["C3225"] helpviewer_keywords: ["C3225"] -ms.assetid: f5f66973-256e-4298-ac46-c87819cbde34 --- # Compiler Error C3225 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md index f87d3b57b4a..298a2d8a275 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3226" title: "Compiler Error C3226" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3226" +ms.date: 11/04/2016 f1_keywords: ["C3226"] helpviewer_keywords: ["C3226"] -ms.assetid: 636106ca-6f4e-4303-a6a0-8803221ec67d --- # Compiler Error C3226 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md index 9fc86ceb301..1674ac4f55c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3227" title: "Compiler Error C3227" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3227" +ms.date: 11/04/2016 f1_keywords: ["C3227"] helpviewer_keywords: ["C3227"] -ms.assetid: 7939c23a-96c8-43c2-89e9-f217d132d155 --- # Compiler Error C3227 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md index b180997f0b4..99d9de708f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3228" title: "Compiler Error C3228" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3228" +ms.date: 11/04/2016 f1_keywords: ["C3228"] helpviewer_keywords: ["C3228"] -ms.assetid: 9015adf9-17b0-4312-b4a7-c1f33e4126f4 --- # Compiler Error C3228 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md index bb6b95e1735..c19f6c0bf8c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3229" title: "Compiler Error C3229" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3229" +ms.date: 11/04/2016 f1_keywords: ["C3229"] helpviewer_keywords: ["C3229"] -ms.assetid: f2d90923-aa8b-444f-ab10-1f37dbb864e1 --- # Compiler Error C3229 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md index e664450c5ca..c58e94c7255 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3230" title: "Compiler Error C3230" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3230" +ms.date: 11/04/2016 f1_keywords: ["C3230"] helpviewer_keywords: ["C3230"] -ms.assetid: 5ec53f25-59f6-4801-81e7-7b68bf04994d --- # Compiler Error C3230 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md index 1ec2b826027..f6d1c264985 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3231" title: "Compiler Error C3231" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3231" +ms.date: 11/04/2016 f1_keywords: ["C3231"] helpviewer_keywords: ["C3231"] -ms.assetid: fe5dc352-e634-45fa-9534-3da176294c98 --- # Compiler Error C3231 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md index 56e7bbf0590..9608a4d798f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3232" title: "Compiler Error C3232" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3232" +ms.date: 11/04/2016 f1_keywords: ["C3232"] helpviewer_keywords: ["C3232"] -ms.assetid: 3119b3a9-0eff-4a3f-b805-e4d160af9e39 --- # Compiler Error C3232 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md index 4a6ded83496..93f9a1bbf8e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3233" title: "Compiler Error C3233" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3233" +ms.date: 11/04/2016 f1_keywords: ["C3233"] helpviewer_keywords: ["C3233"] -ms.assetid: a9210830-1136-4f02-ba41-030c85f93547 --- # Compiler Error C3233 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md index 0cb1abbe0c8..e6b26096cb8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3234" title: "Compiler Error C3234" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3234" +ms.date: 11/04/2016 f1_keywords: ["C3234"] helpviewer_keywords: ["C3234"] -ms.assetid: ebefc15a-e40d-424b-a3dd-d7e185d0ed7b --- # Compiler Error C3234 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md index 48676dc28fe..e88284ee42d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3235" title: "Compiler Error C3235" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3235" +ms.date: 11/04/2016 f1_keywords: ["C3235"] helpviewer_keywords: ["C3235"] -ms.assetid: 0554d6c7-e1dc-4c99-8934-cbcf491c8203 --- # Compiler Error C3235 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md index c32de9a2431..40f1e394497 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3236" title: "Compiler Error C3236" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3236" +ms.date: 11/04/2016 f1_keywords: ["C3236"] helpviewer_keywords: ["C3236"] -ms.assetid: 4ef1871f-a348-44ae-922b-1e2081de20d0 --- # Compiler Error C3236 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md index 6a5959bce1d..7e528bc49d1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3237" title: "Compiler Error C3237" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3237" +ms.date: 11/04/2016 f1_keywords: ["C3237"] helpviewer_keywords: ["C3237"] -ms.assetid: 690970c8-e13b-4ff3-96e3-5fd93c4d356b --- # Compiler Error C3237 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md index 2159b2a0a7c..f2c99fe1706 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3238" title: "Compiler Error C3238" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3238" +ms.date: 11/04/2016 f1_keywords: ["C3238"] helpviewer_keywords: ["C3238"] -ms.assetid: 19942497-b3c5-4df0-9144-142ced92468b --- # Compiler Error C3238 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md index fa35e0c881d..58302dfdb41 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3239" title: "Compiler Error C3239" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3239" +ms.date: 11/04/2016 f1_keywords: ["C3239"] helpviewer_keywords: ["C3239"] -ms.assetid: 22a518b7-020f-4f3c-9963-a094667fd1ac --- # Compiler Error C3239 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md index 38d3dcc888b..19d9853fa83 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3240" title: "Compiler Error C3240" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3240" +ms.date: 11/04/2016 f1_keywords: ["C3240"] helpviewer_keywords: ["C3240"] -ms.assetid: 1a8dc213-b80c-47ae-ada0-e9554b635d1e --- # Compiler Error C3240 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md index e8c298ed9d8..9151758b840 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3241" title: "Compiler Error C3241" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3241" +ms.date: 11/04/2016 f1_keywords: ["C3241"] helpviewer_keywords: ["C3241"] -ms.assetid: 2ca14879-bba0-4a23-b22a-72cfff92d6a4 --- # Compiler Error C3241 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3242.md b/docs/error-messages/compiler-errors-2/compiler-error-c3242.md index 8eb38f5649d..290e2ae1513 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3242.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3242.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3242" title: "Compiler Error C3242" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3242" +ms.date: 11/04/2016 f1_keywords: ["C3242"] helpviewer_keywords: ["C3242"] -ms.assetid: c7621ced-d5c7-4595-904b-bd871676784c --- # Compiler Error C3242 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md index 4f2f4fb074b..3a52311b95c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3243" title: "Compiler Error C3243" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3243" +ms.date: 11/04/2016 f1_keywords: ["C3243"] helpviewer_keywords: ["C3243"] -ms.assetid: 35d8ad1a-377d-47df-be9d-c55eea23340f --- # Compiler Error C3243 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md index 9701b16b45b..f94ccbfce06 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3244" title: "Compiler Error C3244" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3244" +ms.date: 11/04/2016 f1_keywords: ["C3244"] helpviewer_keywords: ["C3244"] -ms.assetid: dae6c49b-5212-4206-8f61-d4010c0b9969 --- # Compiler Error C3244 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md index 721d538bfc7..6458e051d45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3246" title: "Compiler Error C3246" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3246" +ms.date: 11/04/2016 f1_keywords: ["C3246"] helpviewer_keywords: ["C3246"] -ms.assetid: ad85224a-e540-479b-a5eb-a3bc3964c30b --- # Compiler Error C3246 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md index ba7221382b6..93888a5ddb5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3247" title: "Compiler Error C3247" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3247" +ms.date: 11/04/2016 f1_keywords: ["C3247"] helpviewer_keywords: ["C3247"] -ms.assetid: f9a2bbb5-3fce-40bf-9fd3-835a5f164dbb --- # Compiler Error C3247 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3248.md b/docs/error-messages/compiler-errors-2/compiler-error-c3248.md index 9708bc83379..f2edd92a462 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3248.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3248.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3248" title: "Compiler Error C3248" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3248" +ms.date: 11/04/2016 f1_keywords: ["C3248"] helpviewer_keywords: ["C3248"] -ms.assetid: d00b9d7d-b6be-4a5b-bb52-48174ea71fc4 --- # Compiler Error C3248 From 8736f5b1ac789d13aa0cf503c590a28272a3bf96 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 17 Aug 2025 23:10:07 +0800 Subject: [PATCH 0820/1799] Add blockquotes for error messages in range [C3251, C3280] --- docs/error-messages/compiler-errors-2/compiler-error-c3252.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3253.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3254.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3255.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3262.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3264.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3265.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3266.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3269.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3270.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3271.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3272.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3273.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3274.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3276.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3277.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3279.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3280.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md index 979108c12a0..8f516143829 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md @@ -8,7 +8,7 @@ ms.assetid: aa9ad096-e9ac-41c7-8ad9-b966751c7c75 --- # Compiler Error C3252 -'method' : cannot reduce accessibility of a virtual method in a managed or WinRT type +> 'method' : cannot reduce accessibility of a virtual method in a managed or WinRT type A class that implements a virtual method from a base class or any method from an interface cannot reduce the access of that method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md index 789a18bd235..931d6f7a4af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md @@ -8,7 +8,7 @@ ms.assetid: da40be26-0f78-4730-8727-ad11cddf8869 --- # Compiler Error C3253 -'function' : error with explicit override +> 'function' : error with explicit override An explicit override was specified incorrectly. For example, you cannot specify an implementation for an override that you also specify as pure. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md index 8d7f4685f95..8c5d38bf43c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md @@ -8,7 +8,7 @@ ms.assetid: 93427b10-fa72-4e43-80d1-1a6e122f9f40 --- # Compiler Error C3254 -'explicit override' : class contains explicit override 'override' but does not derive from an interface that contains the function declaration +> 'explicit override' : class contains explicit override 'override' but does not derive from an interface that contains the function declaration When you [explicitly override](../../cpp/explicit-overrides-cpp.md) a method, the class that contains the override must derive, directly or indirectly, from the type that contains the function you are overriding. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md index 5e2b71a8530..7f825db9462 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md @@ -8,7 +8,7 @@ ms.assetid: 877ffca2-fd92-44b6-9060-6091b928b1c1 --- # Compiler Error C3255 -'value type' : cannot dynamically allocate this value type object on native heap +> 'value type' : cannot dynamically allocate this value type object on native heap Instances of a value type (see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md)) that contain managed members can be created on the stack but not on the heap. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md index aeff907ea7f..cba1bb17051 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md @@ -8,7 +8,7 @@ ms.assetid: 3e74b9aa-de3c-4492-9331-ee73012b958b --- # Compiler Error C3262 -invalid array indexing: '#' dimension(s) specified for '#'-dimensional 'array type' +> invalid array indexing: '#' dimension(s) specified for '#'-dimensional 'array type' An array was improperly subscripted. The number of indices may not match the number of dimensions in the array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md index 2f620f59858..754de813759 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md @@ -8,7 +8,7 @@ ms.assetid: 94ece687-2364-4f7a-8ebb-7afd3ae9d63d --- # Compiler Error C3264 -'class' : a class-constructor cannot have a return type +> 'class' : a class-constructor cannot have a return type Class constructors cannot have return types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md index c1b01d64d2f..4f891b1c9ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md @@ -8,7 +8,7 @@ ms.assetid: 10ab3e17-4a9f-4120-bab5-21473869b70f --- # Compiler Error C3265 -cannot declare a managed 'managed construct' in an unmanaged 'unmanaged construct' +> cannot declare a managed 'managed construct' in an unmanaged 'unmanaged construct' You cannot include a managed object in an unmanaged context. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md index 80ca7c50aaa..e7c9ec20d07 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md @@ -8,7 +8,7 @@ ms.assetid: 7375c099-acb7-42f6-898d-57cfefa010b8 --- # Compiler Error C3266 -'class' : a class-constructor must have a 'void' parameter list +> 'class' : a class-constructor must have a 'void' parameter list Class-constructors in a class using /clr programming cannot take parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md index 30e3769f27f..22d10a0d60f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md @@ -8,7 +8,7 @@ ms.assetid: c575f067-244d-4dd5-bf58-9e7630ea58b7 --- # Compiler Error C3269 -'function' : a member-function of a managed or WinRTtype cannot be declared with '...' +> 'function' : a member-function of a managed or WinRTtype cannot be declared with '...' Managed and WinRT class member functions cannot declare variable-length parameter lists. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md index 1fbce5730df..ca242820223 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md @@ -8,7 +8,7 @@ ms.assetid: 70e6e76b-7415-48f5-a61e-2ed50caf08e4 --- # Compiler Error C3270 -'field': the FieldOffset attribute can only be used in the context of StructLayout(Explicit), in which case it is required +> 'field': the FieldOffset attribute can only be used in the context of StructLayout(Explicit), in which case it is required A field was marked with **FieldOffset**, which is only allowed when **StructLayout(Explicit)** is in effect. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md index 13e5aa3832a..bf82888973b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md @@ -8,7 +8,7 @@ ms.assetid: 16d8bd1d-2e30-4c6a-a07f-0c4f3342fab5 --- # Compiler Error C3271 -'member': invalid value 'value' for the FieldOffset attribute +> 'member': invalid value 'value' for the FieldOffset attribute A negative number was passed to the **FieldOffset** attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md index 6431d6dcf5b..c9d2886de6b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md @@ -8,7 +8,7 @@ ms.assetid: 7cdf254d-f207-4116-a1bf-7386f3b82a6f --- # Compiler Error C3272 -'symbol' : symbol requires FieldOffset, as it is a member of type typename defined with StructLayout(LayoutKind::Explicit) +> 'symbol' : symbol requires FieldOffset, as it is a member of type typename defined with StructLayout(LayoutKind::Explicit) When `StructLayout(LayoutKind::Explicit)` is in effect, fields must be marked with `FieldOffset`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md index c1d5a9f6802..199e03a1e5c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md @@ -8,7 +8,7 @@ ms.assetid: 1d2ce9d9-222b-4cab-94e2-d2c1a9f5ebe0 --- # Compiler Error C3273 -__finally cannot be used on an exception block in unmanaged code. +> __finally cannot be used on an exception block in unmanaged code. The following sample generates C3273: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md index b3732ce47ae..3189f779d30 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md @@ -8,7 +8,7 @@ ms.assetid: 1f03f18e-b569-48eb-9249-11c70122a305 --- # Compiler Error C3274 -__finally/finally without matching try +> __finally/finally without matching try A [__finally](../../cpp/try-finally-statement.md) or [finally](../../dotnet/finally.md) statement was found without a matching **`try`**. To resolve this, either delete the **`__finally`** statement or add a **`try`** statement for the **`__finally`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3276.md b/docs/error-messages/compiler-errors-2/compiler-error-c3276.md index 7734a6efa52..5a99ed0d370 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3276.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3276.md @@ -8,6 +8,6 @@ ms.assetid: dd6b4fd2-094d-4d34-a467-a9afd59789f7 --- # Compiler Error C3276 -'keyword' : jump out of __finally/finally block has undefined behavior during termination handling +> 'keyword' : jump out of __finally/finally block has undefined behavior during termination handling This error is the same as the [C4532](../../error-messages/compiler-warnings/compiler-warning-level-1-c4532.md) warning. However, when you are using /clr, this condition cannot be disabled with the [warning](../../preprocessor/warning.md) pragma. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md index 5dda1f60f5e..30e4e2ee1e3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md @@ -8,7 +8,7 @@ ms.assetid: 8ac5f476-e30c-4879-92c6-f03cdbd74045 --- # Compiler Error C3277 -cannot define an unmanaged enum 'enum' inside managed 'type' +> cannot define an unmanaged enum 'enum' inside managed 'type' An enumeration was defined incorrectly inside a managed type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md index ed97e7991d8..b7f20b86a7b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md @@ -8,7 +8,7 @@ ms.assetid: 639afc20-984c-4a95-be35-8bf9409f02d5 --- # Compiler Error C3279 -partial and explicit specializations as well as explicit instantiations of class templates declared in the cli namespace are disallowed +> partial and explicit specializations as well as explicit instantiations of class templates declared in the cli namespace are disallowed The `cli` namespace is defined by Microsoft and contains pseudo-templates. The Microsoft C++ compiler does not allow user-defined, partial and explicit specializations, and explicit instantiations of class templates in this namespace. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md index c4d98cceae1..14c03dcd1e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md @@ -8,7 +8,7 @@ ms.assetid: 86dc5bbc-8818-4786-a728-9334268d308b --- # Compiler Error C3280 -'class' : a member-function of a managed type cannot be compiled as an unmanaged function +> 'class' : a member-function of a managed type cannot be compiled as an unmanaged function Managed class member functions cannot be compiled as unmanaged functions. From bb45a4b1621ec94ab4a3879d34ca51f3ddf12cc2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 17 Aug 2025 23:14:41 +0800 Subject: [PATCH 0821/1799] Add "Remarks" and "Example" headings for error references in range [C3251, C3280] --- docs/error-messages/compiler-errors-2/compiler-error-c3251.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3252.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3253.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3254.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3255.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3262.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3264.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3265.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3266.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3269.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3270.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3271.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3272.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3273.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3274.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3275.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3276.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3277.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3279.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3280.md | 4 ++++ 20 files changed, 72 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3251.md b/docs/error-messages/compiler-errors-2/compiler-error-c3251.md index 8756c4429db..413521fc4c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3251.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3251.md @@ -10,6 +10,8 @@ ms.assetid: 541c163e-5ee9-457c-a1e5-da860788b10d > cannot invoke base class method on a value type instance +## Remarks + The following error occurs because `GetClass` is a member of `Microsoft.Runtime.Object`, not of `Microsoft.Runtime.Integer4`. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md index 8f516143829..b1b5733841f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md @@ -10,10 +10,14 @@ ms.assetid: aa9ad096-e9ac-41c7-8ad9-b966751c7c75 > 'method' : cannot reduce accessibility of a virtual method in a managed or WinRT type +## Remarks + A class that implements a virtual method from a base class or any method from an interface cannot reduce the access of that method. Note that all methods in an interface are public. +## Example + The following sample generates C3252 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md index 931d6f7a4af..037dce08e11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md @@ -10,8 +10,12 @@ ms.assetid: da40be26-0f78-4730-8727-ad11cddf8869 > 'function' : error with explicit override +## Remarks + An explicit override was specified incorrectly. For example, you cannot specify an implementation for an override that you also specify as pure. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). +## Example + The following sample generates C3253: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md index 8c5d38bf43c..cb54584d948 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md @@ -10,8 +10,12 @@ ms.assetid: 93427b10-fa72-4e43-80d1-1a6e122f9f40 > 'explicit override' : class contains explicit override 'override' but does not derive from an interface that contains the function declaration +## Remarks + When you [explicitly override](../../cpp/explicit-overrides-cpp.md) a method, the class that contains the override must derive, directly or indirectly, from the type that contains the function you are overriding. +## Example + The following sample generates C3254: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md index 7f825db9462..97ffc53200b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md @@ -10,8 +10,12 @@ ms.assetid: 877ffca2-fd92-44b6-9060-6091b928b1c1 > 'value type' : cannot dynamically allocate this value type object on native heap +## Remarks + Instances of a value type (see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md)) that contain managed members can be created on the stack but not on the heap. +## Example + The following sample generates C3255: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md index cba1bb17051..b119ff49c59 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md @@ -10,8 +10,12 @@ ms.assetid: 3e74b9aa-de3c-4492-9331-ee73012b958b > invalid array indexing: '#' dimension(s) specified for '#'-dimensional 'array type' +## Remarks + An array was improperly subscripted. The number of indices may not match the number of dimensions in the array. +## Example + The following sample generates C3262: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md index 754de813759..4e0726cfd1c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md @@ -10,8 +10,12 @@ ms.assetid: 94ece687-2364-4f7a-8ebb-7afd3ae9d63d > 'class' : a class-constructor cannot have a return type +## Remarks + Class constructors cannot have return types. +## Example + The following sample generates C3264: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md index 4f891b1c9ca..c9ac30cff4c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md @@ -10,8 +10,12 @@ ms.assetid: 10ab3e17-4a9f-4120-bab5-21473869b70f > cannot declare a managed 'managed construct' in an unmanaged 'unmanaged construct' +## Remarks + You cannot include a managed object in an unmanaged context. +## Example + The following sample reproduces C3265: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md index e7c9ec20d07..2c062118c15 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md @@ -10,8 +10,12 @@ ms.assetid: 7375c099-acb7-42f6-898d-57cfefa010b8 > 'class' : a class-constructor must have a 'void' parameter list +## Remarks + Class-constructors in a class using /clr programming cannot take parameters. +## Example + The following sample generates C3266: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md index 22d10a0d60f..d1568d0ed8e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md @@ -10,8 +10,12 @@ ms.assetid: c575f067-244d-4dd5-bf58-9e7630ea58b7 > 'function' : a member-function of a managed or WinRTtype cannot be declared with '...' +## Remarks + Managed and WinRT class member functions cannot declare variable-length parameter lists. +## Example + The following sample generates C3269 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md index ca242820223..2f3a72e7e4d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md @@ -10,8 +10,12 @@ ms.assetid: 70e6e76b-7415-48f5-a61e-2ed50caf08e4 > 'field': the FieldOffset attribute can only be used in the context of StructLayout(Explicit), in which case it is required +## Remarks + A field was marked with **FieldOffset**, which is only allowed when **StructLayout(Explicit)** is in effect. +## Example + The following sample generates C3270: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md index bf82888973b..35b9cb9e5fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md @@ -10,8 +10,12 @@ ms.assetid: 16d8bd1d-2e30-4c6a-a07f-0c4f3342fab5 > 'member': invalid value 'value' for the FieldOffset attribute +## Remarks + A negative number was passed to the **FieldOffset** attribute. +## Example + The following sample generates C3271: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md index c9d2886de6b..7307ea2e0b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md @@ -10,8 +10,12 @@ ms.assetid: 7cdf254d-f207-4116-a1bf-7386f3b82a6f > 'symbol' : symbol requires FieldOffset, as it is a member of type typename defined with StructLayout(LayoutKind::Explicit) +## Remarks + When `StructLayout(LayoutKind::Explicit)` is in effect, fields must be marked with `FieldOffset`. +## Example + The following sample generates C3272: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md index 199e03a1e5c..c21530dece0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md @@ -10,6 +10,8 @@ ms.assetid: 1d2ce9d9-222b-4cab-94e2-d2c1a9f5ebe0 > __finally cannot be used on an exception block in unmanaged code. +## Example + The following sample generates C3273: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md index 3189f779d30..a82e8113c0a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md @@ -10,8 +10,12 @@ ms.assetid: 1f03f18e-b569-48eb-9249-11c70122a305 > __finally/finally without matching try +## Remarks + A [__finally](../../cpp/try-finally-statement.md) or [finally](../../dotnet/finally.md) statement was found without a matching **`try`**. To resolve this, either delete the **`__finally`** statement or add a **`try`** statement for the **`__finally`**. +## Example + The following sample generates C3274: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3275.md b/docs/error-messages/compiler-errors-2/compiler-error-c3275.md index ec6d61c49ef..5004f9f1cf0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3275.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3275.md @@ -10,6 +10,8 @@ ms.assetid: 5752680f-7d3e-4c42-ba9c-845e09d32e7a > 'enum member' : cannot use this symbol without qualifier +## Remarks + When using managed code and when two or more enumerations contain an identifier with the same name, you must explicitly qualify references to the identifier. C3275 is only reachable using the obsolete compiler option **`/clr:oldSyntax`**. It's not generated in Visual Studio 2022 or later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3276.md b/docs/error-messages/compiler-errors-2/compiler-error-c3276.md index 5a99ed0d370..c4a52f85519 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3276.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3276.md @@ -10,4 +10,6 @@ ms.assetid: dd6b4fd2-094d-4d34-a467-a9afd59789f7 > 'keyword' : jump out of __finally/finally block has undefined behavior during termination handling +## Remarks + This error is the same as the [C4532](../../error-messages/compiler-warnings/compiler-warning-level-1-c4532.md) warning. However, when you are using /clr, this condition cannot be disabled with the [warning](../../preprocessor/warning.md) pragma. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md index 30e4e2ee1e3..8fc2469a8c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md @@ -10,8 +10,12 @@ ms.assetid: 8ac5f476-e30c-4879-92c6-f03cdbd74045 > cannot define an unmanaged enum 'enum' inside managed 'type' +## Remarks + An enumeration was defined incorrectly inside a managed type. +## Example + The following sample generates C3277: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md index b7f20b86a7b..14f9a49eb5b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md @@ -10,8 +10,12 @@ ms.assetid: 639afc20-984c-4a95-be35-8bf9409f02d5 > partial and explicit specializations as well as explicit instantiations of class templates declared in the cli namespace are disallowed +## Remarks + The `cli` namespace is defined by Microsoft and contains pseudo-templates. The Microsoft C++ compiler does not allow user-defined, partial and explicit specializations, and explicit instantiations of class templates in this namespace. +## Example + The following sample generates C3279: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md index 14c03dcd1e8..c06206030f5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md @@ -10,8 +10,12 @@ ms.assetid: 86dc5bbc-8818-4786-a728-9334268d308b > 'class' : a member-function of a managed type cannot be compiled as an unmanaged function +## Remarks + Managed class member functions cannot be compiled as unmanaged functions. +## Example + The following sample generates C3280: ```cpp From 462b3c7fd9b8ead7f210192db518bc2ff9bd005f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 17 Aug 2025 23:16:04 +0800 Subject: [PATCH 0822/1799] Replace term "sample" with "example" for error references in range [C3251, C3280] --- docs/error-messages/compiler-errors-2/compiler-error-c3252.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3253.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3254.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3255.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3262.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3264.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3265.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3266.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3268.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3269.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3270.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3271.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3272.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3273.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3274.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3277.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3278.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3279.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3280.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md index b1b5733841f..b95962cba1d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md @@ -18,7 +18,7 @@ Note that all methods in an interface are public. ## Example -The following sample generates C3252 and shows how to fix it: +The following example generates C3252 and shows how to fix it: ```cpp // C3252.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md index 037dce08e11..46e90270950 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md @@ -16,7 +16,7 @@ An explicit override was specified incorrectly. For example, you cannot specify ## Example -The following sample generates C3253: +The following example generates C3253: ```cpp // C3253.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md index cb54584d948..10d1555f841 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md @@ -16,7 +16,7 @@ When you [explicitly override](../../cpp/explicit-overrides-cpp.md) a method, th ## Example -The following sample generates C3254: +The following example generates C3254: ```cpp // C3254.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md index 97ffc53200b..20a8c5c7704 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md @@ -16,7 +16,7 @@ Instances of a value type (see [Classes and Structs](../../extensions/classes-an ## Example -The following sample generates C3255: +The following example generates C3255: ```cpp // C3255.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md index b119ff49c59..1dc4da61595 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md @@ -16,7 +16,7 @@ An array was improperly subscripted. The number of indices may not match the num ## Example -The following sample generates C3262: +The following example generates C3262: ```cpp // C3262.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md index 4e0726cfd1c..121e7374843 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md @@ -16,7 +16,7 @@ Class constructors cannot have return types. ## Example -The following sample generates C3264: +The following example generates C3264: ```cpp // C3264_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md index c9ac30cff4c..8787521d77c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md @@ -16,7 +16,7 @@ You cannot include a managed object in an unmanaged context. ## Example -The following sample reproduces C3265: +The following example reproduces C3265: ```cpp // C3265_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md index 2c062118c15..93d193a4f63 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md @@ -16,7 +16,7 @@ Class-constructors in a class using /clr programming cannot take parameters. ## Example -The following sample generates C3266: +The following example generates C3266: ```cpp // C3266.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3268.md b/docs/error-messages/compiler-errors-2/compiler-error-c3268.md index f58d77ec0de..bbc7e2712fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3268.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3268.md @@ -18,7 +18,7 @@ See [Generics](../../extensions/generics-cpp-component-extensions.md) for more i ## Example -The following sample generates C3268. +The following example generates C3268. ```cpp // C3268.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md index d1568d0ed8e..d99897be536 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md @@ -16,7 +16,7 @@ Managed and WinRT class member functions cannot declare variable-length paramete ## Example -The following sample generates C3269 and shows how to fix it: +The following example generates C3269 and shows how to fix it: ```cpp // C3269_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md index 2f3a72e7e4d..b2b2f87db7d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md @@ -16,7 +16,7 @@ A field was marked with **FieldOffset**, which is only allowed when **StructLayo ## Example -The following sample generates C3270: +The following example generates C3270: ```cpp // C3270_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md index 35b9cb9e5fc..33a13a28be7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md @@ -16,7 +16,7 @@ A negative number was passed to the **FieldOffset** attribute. ## Example -The following sample generates C3271: +The following example generates C3271: ```cpp // C3271.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md index 7307ea2e0b8..12c655feb44 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md @@ -16,7 +16,7 @@ When `StructLayout(LayoutKind::Explicit)` is in effect, fields must be marked wi ## Example -The following sample generates C3272: +The following example generates C3272: ```cpp // C3272_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md index c21530dece0..914b807c65b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md @@ -12,7 +12,7 @@ ms.assetid: 1d2ce9d9-222b-4cab-94e2-d2c1a9f5ebe0 ## Example -The following sample generates C3273: +The following example generates C3273: ```cpp // C3273.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md index a82e8113c0a..b4fba54c8d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md @@ -16,7 +16,7 @@ A [__finally](../../cpp/try-finally-statement.md) or [finally](../../dotnet/fina ## Example -The following sample generates C3274: +The following example generates C3274: ```cpp // C3274.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md index 8fc2469a8c0..f9f327289e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md @@ -16,7 +16,7 @@ An enumeration was defined incorrectly inside a managed type. ## Example -The following sample generates C3277: +The following example generates C3277: ```cpp // C3277a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3278.md b/docs/error-messages/compiler-errors-2/compiler-error-c3278.md index 633bd972416..fafb911d672 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3278.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3278.md @@ -16,7 +16,7 @@ A call was made to an interface method or a pure method, which is not allowed. ## Example -The following sample generates C3278: +The following example generates C3278: ```cpp // C3278_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md index 14f9a49eb5b..b773fd93cb1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md @@ -16,7 +16,7 @@ The `cli` namespace is defined by Microsoft and contains pseudo-templates. The M ## Example -The following sample generates C3279: +The following example generates C3279: ```cpp // C3279.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md index c06206030f5..aabbacdd4f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md @@ -16,7 +16,7 @@ Managed class member functions cannot be compiled as unmanaged functions. ## Example -The following sample generates C3280: +The following example generates C3280: ```cpp // C3280_2.cpp From e4c01341a7acd0b94486a002c98ab6810d586903 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 17 Aug 2025 23:19:27 +0800 Subject: [PATCH 0823/1799] Update metadata for error references in range [C3251, C3280] --- .../error-messages/compiler-errors-2/compiler-error-c3251.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c3252.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3253.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3254.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3255.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3262.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3264.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3265.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3266.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3268.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3269.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3270.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3271.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3272.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3273.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3274.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3275.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c3276.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3277.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3278.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3279.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3280.md | 5 ++--- 22 files changed, 42 insertions(+), 64 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3251.md b/docs/error-messages/compiler-errors-2/compiler-error-c3251.md index 413521fc4c8..ff7203c63a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3251.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3251.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3251" title: "Compiler Error C3251" +description: "Learn more about: Compiler Error C3251" ms.date: 06/01/2022 f1_keywords: ["C3251"] helpviewer_keywords: ["C3251"] -ms.assetid: 541c163e-5ee9-457c-a1e5-da860788b10d --- # Compiler Error C3251 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md index b95962cba1d..0313cb3e10d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3252" title: "Compiler Error C3252" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3252" +ms.date: 11/04/2016 f1_keywords: ["C3252"] helpviewer_keywords: ["C3252"] -ms.assetid: aa9ad096-e9ac-41c7-8ad9-b966751c7c75 --- # Compiler Error C3252 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md index 46e90270950..3fc664e8ad4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3253" title: "Compiler Error C3253" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3253" +ms.date: 11/04/2016 f1_keywords: ["C3253"] helpviewer_keywords: ["C3253"] -ms.assetid: da40be26-0f78-4730-8727-ad11cddf8869 --- # Compiler Error C3253 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md index 10d1555f841..564020dfafb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3254" title: "Compiler Error C3254" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3254" +ms.date: 11/04/2016 f1_keywords: ["C3254"] helpviewer_keywords: ["C3254"] -ms.assetid: 93427b10-fa72-4e43-80d1-1a6e122f9f40 --- # Compiler Error C3254 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md index 20a8c5c7704..85780e5caf6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3255" title: "Compiler Error C3255" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3255" +ms.date: 11/04/2016 f1_keywords: ["C3255"] helpviewer_keywords: ["C3255"] -ms.assetid: 877ffca2-fd92-44b6-9060-6091b928b1c1 --- # Compiler Error C3255 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md index 1dc4da61595..a03b9b56756 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3262" title: "Compiler Error C3262" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3262" +ms.date: 11/04/2016 f1_keywords: ["C3262"] helpviewer_keywords: ["C3262"] -ms.assetid: 3e74b9aa-de3c-4492-9331-ee73012b958b --- # Compiler Error C3262 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md index 121e7374843..67246af20c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3264" title: "Compiler Error C3264" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3264" +ms.date: 11/04/2016 f1_keywords: ["C3264"] helpviewer_keywords: ["C3264"] -ms.assetid: 94ece687-2364-4f7a-8ebb-7afd3ae9d63d --- # Compiler Error C3264 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md index 8787521d77c..0a42b012bb7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3265" title: "Compiler Error C3265" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3265" +ms.date: 11/04/2016 f1_keywords: ["C3265"] helpviewer_keywords: ["C3265"] -ms.assetid: 10ab3e17-4a9f-4120-bab5-21473869b70f --- # Compiler Error C3265 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md index 93d193a4f63..74c180fce42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3266" title: "Compiler Error C3266" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3266" +ms.date: 11/04/2016 f1_keywords: ["C3266"] helpviewer_keywords: ["C3266"] -ms.assetid: 7375c099-acb7-42f6-898d-57cfefa010b8 --- # Compiler Error C3266 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3268.md b/docs/error-messages/compiler-errors-2/compiler-error-c3268.md index bbc7e2712fe..48c86a4db5a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3268.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3268.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3268" title: "Compiler Error C3268" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3268" +ms.date: 11/04/2016 f1_keywords: ["C3268"] helpviewer_keywords: ["C3268"] -ms.assetid: d74a630c-daea-4e29-9759-83efef7fb184 --- # Compiler Error C3268 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md index d99897be536..dda026a75a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3269" title: "Compiler Error C3269" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3269" +ms.date: 11/04/2016 f1_keywords: ["C3269"] helpviewer_keywords: ["C3269"] -ms.assetid: c575f067-244d-4dd5-bf58-9e7630ea58b7 --- # Compiler Error C3269 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md index b2b2f87db7d..67d801e0485 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3270" title: "Compiler Error C3270" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3270" +ms.date: 11/04/2016 f1_keywords: ["C3270"] helpviewer_keywords: ["C3270"] -ms.assetid: 70e6e76b-7415-48f5-a61e-2ed50caf08e4 --- # Compiler Error C3270 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md index 33a13a28be7..d40c824e597 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3271" title: "Compiler Error C3271" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3271" +ms.date: 11/04/2016 f1_keywords: ["C3271"] helpviewer_keywords: ["C3271"] -ms.assetid: 16d8bd1d-2e30-4c6a-a07f-0c4f3342fab5 --- # Compiler Error C3271 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md index 12c655feb44..6cdc82dc549 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3272" title: "Compiler Error C3272" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3272" +ms.date: 11/04/2016 f1_keywords: ["C3272"] helpviewer_keywords: ["C3272"] -ms.assetid: 7cdf254d-f207-4116-a1bf-7386f3b82a6f --- # Compiler Error C3272 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md index 914b807c65b..c19397dfa91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3273" title: "Compiler Error C3273" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3273" +ms.date: 11/04/2016 f1_keywords: ["C3273"] helpviewer_keywords: ["C3273"] -ms.assetid: 1d2ce9d9-222b-4cab-94e2-d2c1a9f5ebe0 --- # Compiler Error C3273 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md index b4fba54c8d6..59a9dfa237a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3274" title: "Compiler Error C3274" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3274" +ms.date: 11/04/2016 f1_keywords: ["C3274"] helpviewer_keywords: ["C3274"] -ms.assetid: 1f03f18e-b569-48eb-9249-11c70122a305 --- # Compiler Error C3274 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3275.md b/docs/error-messages/compiler-errors-2/compiler-error-c3275.md index 5004f9f1cf0..8164db7e728 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3275.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3275.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3275" title: "Compiler Error C3275" +description: "Learn more about: Compiler Error C3275" ms.date: 06/01/2022 f1_keywords: ["C3275"] helpviewer_keywords: ["C3275"] -ms.assetid: 5752680f-7d3e-4c42-ba9c-845e09d32e7a --- # Compiler Error C3275 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3276.md b/docs/error-messages/compiler-errors-2/compiler-error-c3276.md index c4a52f85519..2acd2f43475 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3276.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3276.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3276" title: "Compiler Error C3276" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3276" +ms.date: 11/04/2016 f1_keywords: ["C3276"] helpviewer_keywords: ["C3276"] -ms.assetid: dd6b4fd2-094d-4d34-a467-a9afd59789f7 --- # Compiler Error C3276 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md index f9f327289e2..99686122c80 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3277" title: "Compiler Error C3277" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3277" +ms.date: 11/04/2016 f1_keywords: ["C3277"] helpviewer_keywords: ["C3277"] -ms.assetid: 8ac5f476-e30c-4879-92c6-f03cdbd74045 --- # Compiler Error C3277 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3278.md b/docs/error-messages/compiler-errors-2/compiler-error-c3278.md index fafb911d672..4fa4676b8f1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3278.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3278.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3278" title: "Compiler Error C3278" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3278" +ms.date: 11/04/2016 f1_keywords: ["C3278"] helpviewer_keywords: ["C3278"] -ms.assetid: 56f818f5-85a6-4792-843b-54fe16327658 --- # Compiler Error C3278 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md index b773fd93cb1..2c8c603fabc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3279" title: "Compiler Error C3279" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3279" +ms.date: 11/04/2016 f1_keywords: ["C3279"] helpviewer_keywords: ["C3279"] -ms.assetid: 639afc20-984c-4a95-be35-8bf9409f02d5 --- # Compiler Error C3279 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md index aabbacdd4f6..f0e23ff5668 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3280" title: "Compiler Error C3280" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3280" +ms.date: 11/04/2016 f1_keywords: ["C3280"] helpviewer_keywords: ["C3280"] -ms.assetid: 86dc5bbc-8818-4786-a728-9334268d308b --- # Compiler Error C3280 From 7727b998e07d276c390e33750f6a6cbafa7a3a17 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 00:22:04 +0800 Subject: [PATCH 0824/1799] Add backticks in "AddressSanitizer runtime" topic --- docs/sanitizers/asan-runtime.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 52fac2efa2a..7d588a4bd6b 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -11,13 +11,13 @@ The AddressSanitizer runtime library intercepts common memory allocation functio When compiling with `cl /fsanitize=address`, the compiler generates instructions to manage and check [shadow bytes](./asan-shadow-bytes.md). Your program uses this instrumentation to check memory accesses on the stack, in the heap, or in the global scope. The compiler also produces metadata describing stack and global variables. This metadata enables the runtime to generate precise error diagnostics: function names, lines, and columns in your source code. Combined, the compiler checks and runtime libraries can precisely diagnose many types of [memory safety bugs](./asan-error-examples.md) if they're encountered at run-time. -The list of runtime libraries for linking to the AddressSanitizer runtime, as of Visual Studio 17.7 Preview 3, follows. For more information about the `/MT` (statically link the runtime) and `/MD` (dynamically link the redist at runtime) options, see [/MD, /MT, /LD (Use Run-Time Library)](../build/reference/md-mt-ld-use-run-time-library.md). +The list of runtime libraries for linking to the AddressSanitizer runtime, as of Visual Studio 17.7 Preview 3, follows. For more information about the `/MT` (statically link the runtime) and `/MD` (dynamically link the redist at runtime) options, see [`/MD`, `/MT`, `/LD` (Use Run-Time Library)](../build/reference/md-mt-ld-use-run-time-library.md). > [!NOTE] > In the following table, *`{arch}`* is either *`i386`* or *`x86_64`*. > These libraries use Clang conventions for architecture names. MSVC conventions are normally `x86` and `x64` rather than `i386` and `x86_64`, but they refer to the same architectures. -| CRT option | AddressSanitizer runtime library (.lib) | Address runtime binary (.dll) +| CRT option | AddressSanitizer runtime library (`.lib`) | Address runtime binary (`.dll`) |--|--|--| | `/MT` or `/MTd` | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_static_runtime_thunk-{arch}`* | *`clang_rt.asan_dynamic-{arch}`* | `/MD` or `/MDd` | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_dynamic_runtime_thunk-{arch}`* | *`clang_rt.asan_dynamic-{arch}`* @@ -130,8 +130,8 @@ extern "C" const char* __asan_default_options() ### Unsupported AddressSanitizer options -- detect_container_overflow -- unmap_shadow_on_exit +- `detect_container_overflow` +- `unmap_shadow_on_exit` > [!NOTE] > The AddressSanitizer runtime option `halt_on_error` doesn't function the way you might expect. In both the Clang and the MSVC runtime libraries, many error types are considered **non-continuable**, including most memory corruption errors. @@ -152,9 +152,9 @@ For more information, see the [Differences with Clang 12.0](asan.md#differences) - If set to `"ignore"`, the runtime doesn't attempt to correct any overwritten functions and proceeds with execution. - `windows_fast_fail_on_error` -Boolean (false by default), set to `true` to enable the process to terminate with a __fastfail(71) after printing the error report. +Boolean (`false` by default), set to `true` to enable the process to terminate with a `__fastfail(71)` after printing the error report. >[!NOTE] ->When abort_on_error value is set to true, on Windows the program terminates with an exit(3). In order to not change current behavior we decided to introduce this new option instead. If both abort_on_error and windows_fast_fail_on_error are true, the program will exit with the __fastfail. +>When `abort_on_error` value is set to `true`, on Windows the program terminates with an `exit(3)`. In order to not change current behavior we decided to introduce this new option instead. If both `abort_on_error` and `windows_fast_fail_on_error` are `true`, the program will exit with the `__fastfail`. - `windows_hook_legacy_allocators` Boolean, set to `false` to disable interception of [`GlobalAlloc`](/windows/win32/api/winbase/nf-winbase-globalalloc) and [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-localalloc) allocators. From cb41768d114cd3682d31571dd3c38e33f71500ce Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 00:26:07 +0800 Subject: [PATCH 0825/1799] Fix some typos in "AddressSanitizer runtime" topic --- docs/sanitizers/asan-runtime.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 7d588a4bd6b..9512c30be20 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -31,7 +31,7 @@ The image shows three scenarios for linking the runtime library. The first is /M The following diagram shows how the ASan library is linked for various compiler options: :::image type="complex" source="media/asan-one-dll.png" alt-text="Diagram of how the ASan runtime dll is linked." -The image shows four scenarios for linking the ASan runtime library. The scenarios are for /MT (statically link the runtime), /MTd (statically link the debug runtime), /MD (dynamically link the redist at runtime), /MDd (dynamically link the debug redist at runtime). In all cases, my_exe.exe links and its associates my_dll.dll link to a single instance of clang-rt.asan-dynamix-x86_64.dll. +The image shows four scenarios for linking the ASan runtime library. The scenarios are for /MT (statically link the runtime), /MTd (statically link the debug runtime), /MD (dynamically link the redist at runtime), /MDd (dynamically link the debug redist at runtime). In all cases, my_exe.exe links and its associates my_dll.dll link to a single instance of clang_rt.asan_dynamic-x86_64.dll. :::image-end::: Even when statically linking, the ASan runtime DLL must be present at runtime--unlike other C Runtime components. @@ -101,7 +101,7 @@ For an illustration of the alignment requirement and potential issues, see the p ## Runtime options -The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most of clang's ASan runtime options available in MSVC as well. [A complete list of the public Clang runtime options is available here](https://github.com/google/sanitizers/wiki/SanitizerCommonFlags). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). +The MSVC AddressSanitizer is based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most of clang's ASan runtime options are available in MSVC as well. [A complete list of the public Clang runtime options is available here](https://github.com/google/sanitizers/wiki/SanitizerCommonFlags). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). ### Configure runtime options From fd42c86b732133228a34d8c97d2d1c5651f9f618 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 00:29:33 +0800 Subject: [PATCH 0826/1799] Add missing indent and format `windows_fast_fail_on_error` content in "AddressSanitizer runtime" topic --- docs/sanitizers/asan-runtime.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 9512c30be20..280f3d777ab 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -152,9 +152,10 @@ For more information, see the [Differences with Clang 12.0](asan.md#differences) - If set to `"ignore"`, the runtime doesn't attempt to correct any overwritten functions and proceeds with execution. - `windows_fast_fail_on_error` -Boolean (`false` by default), set to `true` to enable the process to terminate with a `__fastfail(71)` after printing the error report. ->[!NOTE] ->When `abort_on_error` value is set to `true`, on Windows the program terminates with an `exit(3)`. In order to not change current behavior we decided to introduce this new option instead. If both `abort_on_error` and `windows_fast_fail_on_error` are `true`, the program will exit with the `__fastfail`. + Boolean (`false` by default), set to `true` to enable the process to terminate with a `__fastfail(71)` after printing the error report. + + > [!NOTE] + > When `abort_on_error` value is set to `true`, on Windows the program terminates with an `exit(3)`. In order to not change current behavior we decided to introduce this new option instead. If both `abort_on_error` and `windows_fast_fail_on_error` are `true`, the program will exit with the `__fastfail`. - `windows_hook_legacy_allocators` Boolean, set to `false` to disable interception of [`GlobalAlloc`](/windows/win32/api/winbase/nf-winbase-globalalloc) and [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-localalloc) allocators. From 3e1df7d6edda353ac2917a2f5804d0950825d9b2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 00:31:15 +0800 Subject: [PATCH 0827/1799] Fix wrong link to `RtlDestroyHeap` in "AddressSanitizer runtime" topic --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 280f3d777ab..00df2bf65a1 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -218,7 +218,7 @@ The AddressSanitizer runtime hotpatches many functions to enable memory safety c - [`realloc`](../c-runtime-library/reference/realloc.md) - [`RtlAllocateHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtlallocateheap) - [`RtlCreateHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtlcreateheap) -- [`RtlDestroyHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtlcreateheap) +- [`RtlDestroyHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtldestroyheap) - [`RtlFreeHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtlfreeheap) - [`RtlRaiseException`](/windows/win32/api/rtlsupportapi/nf-rtlsupportapi-rtlraiseexception) - `RtlReAllocateHeap` (undocumented) From efde89e912403adebc1efe2b54fcaffbc52f6317 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 00:37:46 +0800 Subject: [PATCH 0828/1799] Clean up redundant `./` and normalize win32 links to lowercase in "AddressSanitizer runtime" topic --- docs/sanitizers/asan-runtime.md | 50 ++++++++++++++++----------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 00df2bf65a1..1c1e523ad3f 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -7,9 +7,9 @@ helpviewer_keywords: ["AddressSanitizer runtime", "Address Sanitizer runtime", " # AddressSanitizer runtime -The AddressSanitizer runtime library intercepts common memory allocation functions and operations to enable inspection of memory accesses. There are several different runtime libraries that support the various types of executables the compiler may generate. The compiler and linker automatically link the appropriate runtime libraries, as long as you pass the [`/fsanitize=address`](../build/reference/fsanitize.md) option at compile time. You can override the default behavior by using the **`/NODEFAULTLIB`** option at link time. For more information, see the section on [linking](./asan-building.md#linker) in the [AddressSanitizer language, build, and debugging reference](./asan-building.md). +The AddressSanitizer runtime library intercepts common memory allocation functions and operations to enable inspection of memory accesses. There are several different runtime libraries that support the various types of executables the compiler may generate. The compiler and linker automatically link the appropriate runtime libraries, as long as you pass the [`/fsanitize=address`](../build/reference/fsanitize.md) option at compile time. You can override the default behavior by using the **`/NODEFAULTLIB`** option at link time. For more information, see the section on [linking](asan-building.md#linker) in the [AddressSanitizer language, build, and debugging reference](asan-building.md). -When compiling with `cl /fsanitize=address`, the compiler generates instructions to manage and check [shadow bytes](./asan-shadow-bytes.md). Your program uses this instrumentation to check memory accesses on the stack, in the heap, or in the global scope. The compiler also produces metadata describing stack and global variables. This metadata enables the runtime to generate precise error diagnostics: function names, lines, and columns in your source code. Combined, the compiler checks and runtime libraries can precisely diagnose many types of [memory safety bugs](./asan-error-examples.md) if they're encountered at run-time. +When compiling with `cl /fsanitize=address`, the compiler generates instructions to manage and check [shadow bytes](asan-shadow-bytes.md). Your program uses this instrumentation to check memory accesses on the stack, in the heap, or in the global scope. The compiler also produces metadata describing stack and global variables. This metadata enables the runtime to generate precise error diagnostics: function names, lines, and columns in your source code. Combined, the compiler checks and runtime libraries can precisely diagnose many types of [memory safety bugs](asan-error-examples.md) if they're encountered at run-time. The list of runtime libraries for linking to the AddressSanitizer runtime, as of Visual Studio 17.7 Preview 3, follows. For more information about the `/MT` (statically link the runtime) and `/MD` (dynamically link the redist at runtime) options, see [`/MD`, `/MT`, `/LD` (Use Run-Time Library)](../build/reference/md-mt-ld-use-run-time-library.md). @@ -63,7 +63,7 @@ The image shows four scenarios for linking the ASan runtime library. The scenari The AddressSanitizer achieves function interception through many hotpatching techniques. These techniques are [best documented within the source code itself](https://github.com/llvm/llvm-project/blob/1a2eaebc09c6a200f93b8beb37130c8b8aab3934/compiler-rt/lib/interception/interception_win.cpp#L11). -The runtime libraries intercept many common memory management and memory manipulation functions. For a list, see [AddressSanitizer list of intercepted functions](#intercepted_functions). The allocation interceptors manage metadata and shadow bytes related to each allocation call. Every time a CRT function such as `malloc` or `delete` is called, the interceptors set specific values in the AddressSanitizer shadow-memory region to indicate whether those heap locations are currently accessible and what the bounds of the allocation are. These shadow bytes allow the compiler-generated checks of the [shadow bytes](./asan-shadow-bytes.md) to determine whether a load or store is valid. +The runtime libraries intercept many common memory management and memory manipulation functions. For a list, see [AddressSanitizer list of intercepted functions](#intercepted_functions). The allocation interceptors manage metadata and shadow bytes related to each allocation call. Every time a CRT function such as `malloc` or `delete` is called, the interceptors set specific values in the AddressSanitizer shadow-memory region to indicate whether those heap locations are currently accessible and what the bounds of the allocation are. These shadow bytes allow the compiler-generated checks of the [shadow bytes](asan-shadow-bytes.md) to determine whether a load or store is valid. Interception isn't guaranteed to succeed. If a function prologue is too short for a `jmp` to be written, interception can fail. If an interception failure occurs, the program throws a `debugbreak` and halts. If you attach a debugger, it makes the cause of the interception issue clear. If you have this problem, [report a bug](https://aka.ms/feedback/report?space=62). @@ -72,7 +72,7 @@ Interception isn't guaranteed to succeed. If a function prologue is too short fo ## Custom allocators and the AddressSanitizer runtime -The AddressSanitizer runtime provides interceptors for common allocator interfaces, `malloc`/`free`, `new`/`delete`, `HeapAlloc`/`HeapFree` (via `RtlAllocateHeap`/`RtlFreeHeap`). Many programs make use of custom allocators for one reason or another, an example would be any program using `dlmalloc` or a solution using the `std::allocator` interface and `VirtualAlloc()`. The compiler is unable to automatically add shadow-memory management calls to a custom allocator. It's the user's responsibility to use the [provided manual poisoning interface](#poisoning). This API enables these allocators to function properly with the existing AddressSanitizer runtime and [shadow byte](./asan-shadow-bytes.md) conventions. +The AddressSanitizer runtime provides interceptors for common allocator interfaces, `malloc`/`free`, `new`/`delete`, `HeapAlloc`/`HeapFree` (via `RtlAllocateHeap`/`RtlFreeHeap`). Many programs make use of custom allocators for one reason or another, an example would be any program using `dlmalloc` or a solution using the `std::allocator` interface and `VirtualAlloc()`. The compiler is unable to automatically add shadow-memory management calls to a custom allocator. It's the user's responsibility to use the [provided manual poisoning interface](#poisoning). This API enables these allocators to function properly with the existing AddressSanitizer runtime and [shadow byte](asan-shadow-bytes.md) conventions. ## Manual AddressSanitizer poisoning interface @@ -113,7 +113,7 @@ If the environment variable and the user function specify conflicting options, t Multiple options are specified by separating them with a colon (`:`). -The following example sets [`alloc_dealloc_mismatch`](./error-alloc-dealloc-mismatch.md) to one and `symbolize` to zero: +The following example sets [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md) to one and `symbolize` to zero: ```cmd set ASAN_OPTIONS=alloc_dealloc_mismatch=1:symbolize=0 @@ -249,26 +249,26 @@ The interceptors listed here are only installed when an AddressSanitizer runtime `set ASAN_OPTIONS=windows_hook_legacy_allocators=false` - [`GlobalAlloc`](/windows/win32/api/winbase/nf-winbase-globalalloc) -- [`GlobalFree`](/windows/win32/api/winbase/nf-winbase-GlobalFree) -- [`GlobalHandle`](/windows/win32/api/winbase/nf-winbase-GlobalHandle) -- [`GlobalLock`](/windows/win32/api/winbase/nf-winbase-GlobalLock) -- [`GlobalReAlloc`](/windows/win32/api/winbase/nf-winbase-GlobalReAlloc) -- [`GlobalSize`](/windows/win32/api/winbase/nf-winbase-GlobalSize) -- [`GlobalUnlock`](/windows/win32/api/winbase/nf-winbase-GlobalUnlock) -- [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-LocalAlloc) -- [`LocalFree`](/windows/win32/api/winbase/nf-winbase-LocalFree) -- [`LocalHandle`](/windows/win32/api/winbase/nf-winbase-LocalHandle) -- [`LocalLock`](/windows/win32/api/winbase/nf-winbase-LocalLock) -- [`LocalReAlloc`](/windows/win32/api/winbase/nf-winbase-LocalReAlloc) -- [`LocalSize`](/windows/win32/api/winbase/nf-winbase-LocalSize) -- [`LocalUnlock`](/windows/win32/api/winbase/nf-winbase-LocalUnlock) +- [`GlobalFree`](/windows/win32/api/winbase/nf-winbase-globalfree) +- [`GlobalHandle`](/windows/win32/api/winbase/nf-winbase-globalhandle) +- [`GlobalLock`](/windows/win32/api/winbase/nf-winbase-globallock) +- [`GlobalReAlloc`](/windows/win32/api/winbase/nf-winbase-globalrealloc) +- [`GlobalSize`](/windows/win32/api/winbase/nf-winbase-globalsize) +- [`GlobalUnlock`](/windows/win32/api/winbase/nf-winbase-globalunlock) +- [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-localalloc) +- [`LocalFree`](/windows/win32/api/winbase/nf-winbase-localfree) +- [`LocalHandle`](/windows/win32/api/winbase/nf-winbase-localhandle) +- [`LocalLock`](/windows/win32/api/winbase/nf-winbase-locallock) +- [`LocalReAlloc`](/windows/win32/api/winbase/nf-winbase-localrealloc) +- [`LocalSize`](/windows/win32/api/winbase/nf-winbase-localsize) +- [`LocalUnlock`](/windows/win32/api/winbase/nf-winbase-localunlock) ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) From 72e3d0cf0bc82bf0701f786834a3e989d9f8c63f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 00:58:25 +0800 Subject: [PATCH 0829/1799] Add missing C2554 `f1_keywords` and `helpviewer_keywords` in "Compiler errors C2500 Through C2599" --- .../compiler-errors-2/compiler-errors-c2500-through-c2599.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md index d6a27711af8..5340336b562 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md @@ -2,8 +2,8 @@ title: "Compiler errors C2500 Through C2599" description: "Learn more about: Compiler errors C2500 Through C2599" ms.date: 04/21/2019 -f1_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] -helpviewer_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] +f1_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2554", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] +helpviewer_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2554", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] --- # Compiler errors C2500 Through C2599 From de560920bcb1d5b3c1b671a39e4e7475d10ff48a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 01:12:10 +0800 Subject: [PATCH 0830/1799] Change code block language from `C++` to `cpp` in "AddressSanitizer runtime" topic --- docs/sanitizers/asan-runtime.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 1c1e523ad3f..3d862c6a0bc 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -121,7 +121,7 @@ set ASAN_OPTIONS=alloc_dealloc_mismatch=1:symbolize=0 Or add the following function to your code: -```C++ +```cpp extern "C" const char* __asan_default_options() { return "alloc_dealloc_mismatch=1:symbolize=0"; From 93d6acf76fa6f97cc62fb72aca63c4c2f460cabf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 01:24:05 +0800 Subject: [PATCH 0831/1799] Add blockquotes for error messages in range [C3281, C3350] --- docs/error-messages/compiler-errors-2/compiler-error-c3282.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3283.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3284.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3285.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3288.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3289.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3290.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3291.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3292.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3293.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3296.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3297.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3298.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3299.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3303.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3309.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3320.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3322.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3333.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3334.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3340.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3342.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3345.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3347.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3350.md | 2 +- 25 files changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md index f424b4ccf18..ac89d88cb31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md @@ -8,7 +8,7 @@ ms.assetid: bac2ac89-c360-4c24-bb81-c20c62ece9ba --- # Compiler Error C3282 -generic parameter lists can only appear on managed or WinRTclasses, structs, or functions +> generic parameter lists can only appear on managed or WinRTclasses, structs, or functions A generic parameter list was used incorrectly. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md index a21e84993f8..869dd0f2691 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md @@ -8,7 +8,7 @@ ms.assetid: c51d912c-cde3-4928-904e-26734c8954ce --- # Compiler Error C3283 -'type' : an interface cannot have an instance constructor +> 'type' : an interface cannot have an instance constructor A CLR [interface](../../extensions/interface-class-cpp-component-extensions.md) cannot have an instance constructor. A static constructor is allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md index c2e17582e38..87fb4ec27cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md @@ -8,7 +8,7 @@ ms.assetid: e582f316-e9db-4d27-9c70-fdfa737a9d5f --- # Compiler Error C3284 -the constraints for generic parameter 'parameter' of function 'function' must match the constraints for generic parameter 'parameter' of function 'function' +> the constraints for generic parameter 'parameter' of function 'function' must match the constraints for generic parameter 'parameter' of function 'function' A virtual generic function must use the same constraints as a virtual function with the same name and set of arguments in the base class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md index 59d5d68b7b2..7db5ea4b790 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md @@ -8,7 +8,7 @@ ms.assetid: 04e8f210-d67e-4810-b153-e1efe2986c8f --- # Compiler Error C3285 -for each statement cannot operate on variables of type 'type' +> for each statement cannot operate on variables of type 'type' The `for each` statement repeats a group of embedded statements for each element in an array or an object collection. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md index 4f9b011915a..3b85263cf16 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md @@ -8,7 +8,7 @@ ms.assetid: ed08a540-9751-46e1-9cbe-c51d6a49ffab --- # Compiler Error C3288 -'type' : illegal dereference of a handle type +> 'type' : illegal dereference of a handle type The compiler detected an illegal dereference of a handle type. You can dereference a handle type and assign it to a reference. For more information, see [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md index 9aec61ca772..1497dd8b8cb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md @@ -8,7 +8,7 @@ ms.assetid: 3c1c623b-7fcf-43ab-a89a-8722532a8d29 --- # Compiler Error C3289 -'property' : a trivial property cannot be indexed +> 'property' : a trivial property cannot be indexed A property was declared incorrectly. Accessors must be defined for an indexed property. See [property](../../extensions/property-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md index 0c418160ac2..88137986b5c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md @@ -8,7 +8,7 @@ ms.assetid: 0baf684b-1143-4953-ac99-a2fa267d8017 --- # Compiler Error C3290 -'type' : a trivial property cannot have reference type +> 'type' : a trivial property cannot have reference type A property was declared incorrectly. When you declare a trivial property, the compiler creates a variable that the property will update, and it is not possible to have a tracking reference variable in a class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md index 7786861b99d..ca5bb779572 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md @@ -8,7 +8,7 @@ ms.assetid: ed2e9f89-8dbc-4387-bc26-cc955e840858 --- # Compiler Error C3291 -'default' : cannot be the name of a trivial property +> 'default' : cannot be the name of a trivial property A trivial property cannot be named **`default`**. See [property](../../extensions/property-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md index 06b23f7f6fa..d859cb1b3a2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md @@ -8,7 +8,7 @@ ms.assetid: ead485cc-5471-4e10-b361-300589ff5b70 --- # Compiler Error C3292 -the cli namespace cannot be reopened +> the cli namespace cannot be reopened The cli namespace cannot be declared in your code. For more information, see [Platform, default, and cli Namespaces](../../extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md index 6ce9d649914..cdd09bb7906 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md @@ -8,7 +8,7 @@ ms.assetid: b772cf98-52e0-4e24-be23-1f5d87d999ac --- # Compiler Error C3293 -'accessor': use 'default' to access the default property (indexer) for class 'type' +> 'accessor': use 'default' to access the default property (indexer) for class 'type' An indexed property was accessed incorrectly. See [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md index 46a10a2ae6e..b72b43384e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md @@ -8,7 +8,7 @@ ms.assetid: fc4c9dcd-16cf-4eee-a1ac-c43e7c29e443 --- # Compiler Error C3296 -'property' : a property with this name already exists +> 'property' : a property with this name already exists The compiler encountered more than one property with the same name. Each property in a type must have a unique name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md index 569007694b7..5335d621067 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md @@ -8,7 +8,7 @@ ms.assetid: 2a718b4c-6cdb-4418-92c0-fc3a259431c4 --- # Compiler Error C3297 -'constraint_2' : cannot use 'constraint_1' as a constraint because 'constraint_1' has the value constraint +> 'constraint_2' : cannot use 'constraint_1' as a constraint because 'constraint_1' has the value constraint Value classes are sealed. If a constraint is a value class, another constraint can never derive from it. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md index 38cb9191d8c..87a309171ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md @@ -8,7 +8,7 @@ ms.assetid: 458c2680-95bb-4d5e-895f-ce4115844193 --- # Compiler Error C3298 -'constraint_1' : cannot use 'constraint_2' as a constraint because 'constraint_2' has the ref constraint and 'constraint_1' has the value constraint +> 'constraint_1' : cannot use 'constraint_2' as a constraint because 'constraint_2' has the ref constraint and 'constraint_1' has the value constraint You cannot specify mutually exclusive characteristics for a constraint. For example, a generic type parameter cannot be constrained to both a value type and a reference type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md index c9b8510b600..19c625dcad0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md @@ -8,7 +8,7 @@ ms.assetid: 7cabdf01-bceb-404f-9401-cdd9c7fc1641 --- # Compiler Error C3299 -'member_function' : cannot specify constraints, they are inherited from the base method +> 'member_function' : cannot specify constraints, they are inherited from the base method When overriding a generic member function, you cannot specify constraint clauses (repeating the constraints implies that the constraints are not inherited). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3303.md b/docs/error-messages/compiler-errors-2/compiler-error-c3303.md index 323f0832162..92706dadbd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3303.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3303.md @@ -8,6 +8,6 @@ ms.assetid: c6f6ea3d-f6b7-4401-8bbb-f283a2c05540 --- # Compiler Error C3303 -'attribute': attribute can only be used on 'usage' +> 'attribute': attribute can only be used on 'usage' An attempt was made to use an attribute where it is not valid. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md index 651e7c8c0f9..ae9be122126 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md @@ -8,7 +8,7 @@ ms.assetid: 75ee16e3-7d4e-4c41-b3cb-64e9849c3aab --- # Compiler Error C3309 -'macro_name': module name cannot be a macro or a keyword +> 'macro_name': module name cannot be a macro or a keyword The value that you pass to the name property of the module attribute cannot be a symbol for the preprocessor to expand; it must be a string literal. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md index 50975948b9a..cd5f139bd77 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md @@ -8,7 +8,7 @@ ms.assetid: 2ef72d9a-1f1d-4b2e-b244-9fd3f3e70cb6 --- # Compiler Error C3320 -'type': type cannot have the same name as the module 'name' property +> 'type': type cannot have the same name as the module 'name' property An exported user-defined type (UDT), which could be a struct, class, enum, or union, cannot have the same name as the parameter passed to the [module](../../windows/attributes/module-cpp.md) attribute's name property. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3322.md b/docs/error-messages/compiler-errors-2/compiler-error-c3322.md index 374af497ee7..aa510bad56f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3322.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3322.md @@ -8,6 +8,6 @@ ms.assetid: d8a0ad95-30df-4337-b0c8-4747de0bef50 --- # Compiler Error C3322 -'property': is not a valid property for attribute 'attribute' +> 'property': is not a valid property for attribute 'attribute' An invalid or unrecognized property (or parameter) was passed to an attribute. Check the documentation for the attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3333.md b/docs/error-messages/compiler-errors-2/compiler-error-c3333.md index 731607d8c59..cb7f69ae541 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3333.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3333.md @@ -8,6 +8,6 @@ ms.assetid: 51693978-fba6-435a-a696-74735cc875de --- # Compiler Error C3333 -'type library': cannot #import corrupt type library +> 'type library': cannot #import corrupt type library The type library specified in the `#import` statement is unreadable by the compiler. You may want to either regenerate the type library, if possible, or request a new type library from your supplier. You may want to use the OLE Viewer, supplied with Visual C++, to view the type library file to see what is the matter with it. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3334.md b/docs/error-messages/compiler-errors-2/compiler-error-c3334.md index 4710d310457..179144ab3fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3334.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3334.md @@ -8,7 +8,7 @@ ms.assetid: e972c625-77e7-4022-8aba-e1db01d7a0d7 --- # Compiler Error C3334 -cannot #import corrupt type library +> cannot #import corrupt type library The library file in a `#import` statement is corrupt and can't be consumed by the compiler. Corruption can come from bad generation of the module, disk corruption, or if the binary file was somehow edited and modified. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md index 8eea083c5d9..a1a1a45cfbd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md @@ -8,7 +8,7 @@ ms.assetid: 23b12298-b92a-4717-8380-f165c998cb8a --- # Compiler Error C3340 -'interface': interface cannot be both 'restricted' and 'default' in coclass 'class' +> 'interface': interface cannot be both 'restricted' and 'default' in coclass 'class' The [restricted](../../windows/attributes/restricted.md) attribute and the [default](../../windows/attributes/default-cpp.md) attribute are mutually exclusive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md index f14134d5da0..67d3a2922d9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md @@ -8,7 +8,7 @@ ms.assetid: 5c6d784f-bebe-4f7e-8615-44ca6f78bfba --- # Compiler Error C3342 -'attribute': ambiguous attribute +> 'attribute': ambiguous attribute The compiler found more than one definition of an attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3345.md b/docs/error-messages/compiler-errors-2/compiler-error-c3345.md index 7cbcbd255c2..9c729b446af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3345.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3345.md @@ -8,7 +8,7 @@ ms.assetid: 1dda4c79-73bb-441b-b939-746154c3afba --- # Compiler Error C3345 -'identifier': invalid identifier for module name +> 'identifier': invalid identifier for module name The *identifier* for a module contains one or more unacceptable characters. An identifier is valid if the first character is an alphabetical, underscore, or high ANSI (0x80-FF) character, and any subsequent character is an alphanumeric, underscore, or high ANSI character. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md index 4fe6b20eb35..4f2271f56b1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md @@ -8,7 +8,7 @@ ms.assetid: e939ad29-0b78-4681-9618-9bdae5675cee --- # Compiler Error C3347 -'arg': required argument is not specified in attribute idl_module +> 'arg': required argument is not specified in attribute idl_module A required argument was not passed to the [idl_module](../../windows/attributes/idl-module.md) attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md index 832d21b80ca..9a8cfa5687d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md @@ -8,7 +8,7 @@ ms.assetid: cfbbc338-92b5-4f34-999e-aa2d2376bc70 --- # Compiler Error C3350 -'delegate' : a delegate constructor expects number argument(s) +> 'delegate' : a delegate constructor expects number argument(s) When you create an instance of a delegate, you must pass two arguments, an instance of the type containing the delegate function, and the function. From 4dc1b841c63255dfcdf59312d391cd86436ebd20 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 01:29:57 +0800 Subject: [PATCH 0832/1799] Add "Remarks" and "Example" headings for error references in range [C3281, C3350] --- docs/error-messages/compiler-errors-2/compiler-error-c3282.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3283.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3284.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3285.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3286.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3288.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3289.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3290.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3291.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3292.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3293.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3296.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3297.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3298.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3299.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3303.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3309.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3320.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3322.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3333.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3334.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3340.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3342.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3345.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3347.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3350.md | 4 ++++ 26 files changed, 64 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md index ac89d88cb31..3c8f9f520b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md @@ -10,6 +10,8 @@ ms.assetid: bac2ac89-c360-4c24-bb81-c20c62ece9ba > generic parameter lists can only appear on managed or WinRTclasses, structs, or functions +## Remarks + A generic parameter list was used incorrectly. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md index 869dd0f2691..0d483630d4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md @@ -10,8 +10,12 @@ ms.assetid: c51d912c-cde3-4928-904e-26734c8954ce > 'type' : an interface cannot have an instance constructor +## Remarks + A CLR [interface](../../extensions/interface-class-cpp-component-extensions.md) cannot have an instance constructor. A static constructor is allowed. +## Example + The following sample generates C3283: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md index 87fb4ec27cf..a06a9ac4299 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md @@ -10,8 +10,12 @@ ms.assetid: e582f316-e9db-4d27-9c70-fdfa737a9d5f > the constraints for generic parameter 'parameter' of function 'function' must match the constraints for generic parameter 'parameter' of function 'function' +## Remarks + A virtual generic function must use the same constraints as a virtual function with the same name and set of arguments in the base class. +## Example + The following sample generates C3284: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md index 7db5ea4b790..e66553f7df4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md @@ -10,6 +10,8 @@ ms.assetid: 04e8f210-d67e-4810-b153-e1efe2986c8f > for each statement cannot operate on variables of type 'type' +## Remarks + The `for each` statement repeats a group of embedded statements for each element in an array or an object collection. See [for each, in](../../dotnet/for-each-in.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3286.md b/docs/error-messages/compiler-errors-2/compiler-error-c3286.md index 9efe53c1c97..a17e5e24922 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3286.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3286.md @@ -10,6 +10,8 @@ ms.assetid: 554328c8-cf44-4f7d-a8d2-def74d28ecdd > '*specifier*': an iteration variable cannot have any storage-class specifiers +## Remarks + A storage class can't be specified on an iteration variable. For more information, see [Storage classes (C++)](../../cpp/storage-classes-cpp.md) and [for each, in](../../dotnet/for-each-in.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md index 3b85263cf16..c7dde810d93 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md @@ -10,6 +10,8 @@ ms.assetid: ed08a540-9751-46e1-9cbe-c51d6a49ffab > 'type' : illegal dereference of a handle type +## Remarks + The compiler detected an illegal dereference of a handle type. You can dereference a handle type and assign it to a reference. For more information, see [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md index 1497dd8b8cb..bd9db63295d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md @@ -10,6 +10,8 @@ ms.assetid: 3c1c623b-7fcf-43ab-a89a-8722532a8d29 > 'property' : a trivial property cannot be indexed +## Remarks + A property was declared incorrectly. Accessors must be defined for an indexed property. See [property](../../extensions/property-cpp-component-extensions.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md index 88137986b5c..cd04bb16ad0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md @@ -10,6 +10,8 @@ ms.assetid: 0baf684b-1143-4953-ac99-a2fa267d8017 > 'type' : a trivial property cannot have reference type +## Remarks + A property was declared incorrectly. When you declare a trivial property, the compiler creates a variable that the property will update, and it is not possible to have a tracking reference variable in a class. See [property](../../extensions/property-cpp-component-extensions.md) and [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md index ca5bb779572..493f6f1eacd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md @@ -10,6 +10,8 @@ ms.assetid: ed2e9f89-8dbc-4387-bc26-cc955e840858 > 'default' : cannot be the name of a trivial property +## Remarks + A trivial property cannot be named **`default`**. See [property](../../extensions/property-cpp-component-extensions.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md index d859cb1b3a2..cccc8e2515b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md @@ -10,6 +10,8 @@ ms.assetid: ead485cc-5471-4e10-b361-300589ff5b70 > the cli namespace cannot be reopened +## Remarks + The cli namespace cannot be declared in your code. For more information, see [Platform, default, and cli Namespaces](../../extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md index cdd09bb7906..f0274e24775 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md @@ -10,6 +10,8 @@ ms.assetid: b772cf98-52e0-4e24-be23-1f5d87d999ac > 'accessor': use 'default' to access the default property (indexer) for class 'type' +## Remarks + An indexed property was accessed incorrectly. See [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md) for more information. **Visual Studio 2017 and later**: In Visual Studio 2015 and earlier, the compiler in some cases misidentified a default property as a default indexer. It was possible to work around the issue by using the identifier "default" to access the property. The workaround itself became problematic after default was introduced as a keyword in C++11. Therefore, in Visual Studio 2017 the bugs that required the workaround were fixed, and the compiler now raises an error when "default" is used to access the default property for a class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md index b72b43384e7..d24c70db0f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md @@ -10,6 +10,8 @@ ms.assetid: fc4c9dcd-16cf-4eee-a1ac-c43e7c29e443 > 'property' : a property with this name already exists +## Remarks + The compiler encountered more than one property with the same name. Each property in a type must have a unique name. For more information, see [property](../../extensions/property-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md index 5335d621067..2be74dc44f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md @@ -10,6 +10,8 @@ ms.assetid: 2a718b4c-6cdb-4418-92c0-fc3a259431c4 > 'constraint_2' : cannot use 'constraint_1' as a constraint because 'constraint_1' has the value constraint +## Remarks + Value classes are sealed. If a constraint is a value class, another constraint can never derive from it. For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md index 87a309171ef..6baf9d6a885 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md @@ -10,6 +10,8 @@ ms.assetid: 458c2680-95bb-4d5e-895f-ce4115844193 > 'constraint_1' : cannot use 'constraint_2' as a constraint because 'constraint_2' has the ref constraint and 'constraint_1' has the value constraint +## Remarks + You cannot specify mutually exclusive characteristics for a constraint. For example, a generic type parameter cannot be constrained to both a value type and a reference type. For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md index 19c625dcad0..03964b63895 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md @@ -10,6 +10,8 @@ ms.assetid: 7cabdf01-bceb-404f-9401-cdd9c7fc1641 > 'member_function' : cannot specify constraints, they are inherited from the base method +## Remarks + When overriding a generic member function, you cannot specify constraint clauses (repeating the constraints implies that the constraints are not inherited). The constraint clauses on the generic function you are overriding will be inherited. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3303.md b/docs/error-messages/compiler-errors-2/compiler-error-c3303.md index 92706dadbd4..03f65642d61 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3303.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3303.md @@ -10,4 +10,6 @@ ms.assetid: c6f6ea3d-f6b7-4401-8bbb-f283a2c05540 > 'attribute': attribute can only be used on 'usage' +## Remarks + An attempt was made to use an attribute where it is not valid. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md index ae9be122126..f62f6a5449d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md @@ -10,8 +10,12 @@ ms.assetid: 75ee16e3-7d4e-4c41-b3cb-64e9849c3aab > 'macro_name': module name cannot be a macro or a keyword +## Remarks + The value that you pass to the name property of the module attribute cannot be a symbol for the preprocessor to expand; it must be a string literal. +## Example + The following sample generates C3309: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md index cd5f139bd77..ad2da725eb3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md @@ -10,6 +10,8 @@ ms.assetid: 2ef72d9a-1f1d-4b2e-b244-9fd3f3e70cb6 > 'type': type cannot have the same name as the module 'name' property +## Remarks + An exported user-defined type (UDT), which could be a struct, class, enum, or union, cannot have the same name as the parameter passed to the [module](../../windows/attributes/module-cpp.md) attribute's name property. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3322.md b/docs/error-messages/compiler-errors-2/compiler-error-c3322.md index aa510bad56f..1abf6d3d455 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3322.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3322.md @@ -10,4 +10,6 @@ ms.assetid: d8a0ad95-30df-4337-b0c8-4747de0bef50 > 'property': is not a valid property for attribute 'attribute' +## Remarks + An invalid or unrecognized property (or parameter) was passed to an attribute. Check the documentation for the attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3333.md b/docs/error-messages/compiler-errors-2/compiler-error-c3333.md index cb7f69ae541..fbc53c1ec41 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3333.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3333.md @@ -10,4 +10,6 @@ ms.assetid: 51693978-fba6-435a-a696-74735cc875de > 'type library': cannot #import corrupt type library +## Remarks + The type library specified in the `#import` statement is unreadable by the compiler. You may want to either regenerate the type library, if possible, or request a new type library from your supplier. You may want to use the OLE Viewer, supplied with Visual C++, to view the type library file to see what is the matter with it. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3334.md b/docs/error-messages/compiler-errors-2/compiler-error-c3334.md index 179144ab3fd..7cf43b918e5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3334.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3334.md @@ -10,6 +10,8 @@ ms.assetid: e972c625-77e7-4022-8aba-e1db01d7a0d7 > cannot #import corrupt type library +## Remarks + The library file in a `#import` statement is corrupt and can't be consumed by the compiler. Corruption can come from bad generation of the module, disk corruption, or if the binary file was somehow edited and modified. For more information, see [#import Directive](../../preprocessor/hash-import-directive-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md index a1a1a45cfbd..5947afd04ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md @@ -10,8 +10,12 @@ ms.assetid: 23b12298-b92a-4717-8380-f165c998cb8a > 'interface': interface cannot be both 'restricted' and 'default' in coclass 'class' +## Remarks + The [restricted](../../windows/attributes/restricted.md) attribute and the [default](../../windows/attributes/default-cpp.md) attribute are mutually exclusive. +## Example + The following sample generates C3340: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md index 67d3a2922d9..b6e1ec96601 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md @@ -10,6 +10,8 @@ ms.assetid: 5c6d784f-bebe-4f7e-8615-44ca6f78bfba > 'attribute': ambiguous attribute +## Remarks + The compiler found more than one definition of an attribute. An attribute was defined more than once. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3345.md b/docs/error-messages/compiler-errors-2/compiler-error-c3345.md index 9c729b446af..b607d6d74c2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3345.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3345.md @@ -10,6 +10,8 @@ ms.assetid: 1dda4c79-73bb-441b-b939-746154c3afba > 'identifier': invalid identifier for module name +## Remarks + The *identifier* for a module contains one or more unacceptable characters. An identifier is valid if the first character is an alphabetical, underscore, or high ANSI (0x80-FF) character, and any subsequent character is an alphanumeric, underscore, or high ANSI character. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md index 4f2271f56b1..91a90d9e4ed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md @@ -10,8 +10,12 @@ ms.assetid: e939ad29-0b78-4681-9618-9bdae5675cee > 'arg': required argument is not specified in attribute idl_module +## Remarks + A required argument was not passed to the [idl_module](../../windows/attributes/idl-module.md) attribute. +## Example + The following sample generates C3347: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md index 9a8cfa5687d..2ef515a773a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md @@ -10,8 +10,12 @@ ms.assetid: cfbbc338-92b5-4f34-999e-aa2d2376bc70 > 'delegate' : a delegate constructor expects number argument(s) +## Remarks + When you create an instance of a delegate, you must pass two arguments, an instance of the type containing the delegate function, and the function. +## Example + The following sample generates C3350: ```cpp From a28f4df125a8ff4f1da1e4b8a621c64295993a5f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 01:31:28 +0800 Subject: [PATCH 0833/1799] Replace term "sample" with "example" for error references in range [C3281, C3350] --- docs/error-messages/compiler-errors-2/compiler-error-c3282.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3283.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3284.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3285.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3286.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3287.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3288.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3289.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3290.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3291.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3292.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3293.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3296.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3297.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3298.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3299.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3309.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3320.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3340.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3342.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3347.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3350.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md index 3c8f9f520b0..dbbbeb4afe4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md @@ -16,7 +16,7 @@ A generic parameter list was used incorrectly. For more information, see [Gener ## Example -The following sample generates C3282 and shows how to fix it. +The following example generates C3282 and shows how to fix it. ```cpp // C3282.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md index 0d483630d4b..5989fc71eba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md @@ -16,7 +16,7 @@ A CLR [interface](../../extensions/interface-class-cpp-component-extensions.md) ## Example -The following sample generates C3283: +The following example generates C3283: ```cpp // C3283.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md index a06a9ac4299..0ec077ca0c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md @@ -16,7 +16,7 @@ A virtual generic function must use the same constraints as a virtual function w ## Example -The following sample generates C3284: +The following example generates C3284: ```cpp // C3284.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md index e66553f7df4..995914e904f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md @@ -18,7 +18,7 @@ See [for each, in](../../dotnet/for-each-in.md) for more information. ## Example -The following sample generates C3285. +The following example generates C3285. ```cpp // C3285.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3286.md b/docs/error-messages/compiler-errors-2/compiler-error-c3286.md index a17e5e24922..561be373a90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3286.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3286.md @@ -16,7 +16,7 @@ A storage class can't be specified on an iteration variable. For more informatio ## Example -The following sample generates C3286, and also shows correct usage. +The following example generates C3286, and also shows correct usage. ```cpp // C3286.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3287.md b/docs/error-messages/compiler-errors-2/compiler-error-c3287.md index 787b4508cff..0a2988aa245 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3287.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3287.md @@ -18,7 +18,7 @@ For more information, see [for each, in](../../dotnet/for-each-in.md). ## Example -The following sample generates C3287. +The following example generates C3287. ```cpp // C3287.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md index c7dde810d93..36a02c61a31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md @@ -16,7 +16,7 @@ The compiler detected an illegal dereference of a handle type. You can dereferen ## Example -The following sample generates C3288. +The following example generates C3288. ```cpp // C3288.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md index bd9db63295d..c3493d65ff3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md @@ -16,7 +16,7 @@ A property was declared incorrectly. Accessors must be defined for an indexed pr ## Example -The following sample generates C3289. +The following example generates C3289. ```cpp // C3289.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md index cd04bb16ad0..b5aa1aa18dd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md @@ -18,7 +18,7 @@ See [property](../../extensions/property-cpp-component-extensions.md) and [Track ## Example -The following sample generates C3290. +The following example generates C3290. ```cpp // C3290.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md index 493f6f1eacd..ffd70d1e8f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md @@ -16,7 +16,7 @@ A trivial property cannot be named **`default`**. See [property](../../extension ## Example -The following sample generates C3291. +The following example generates C3291. ```cpp // C3291.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md index cccc8e2515b..014ce5c1612 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md @@ -16,7 +16,7 @@ The cli namespace cannot be declared in your code. For more information, see [P ## Example -The following sample generates C3292. +The following example generates C3292. ```cpp // C3292.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md index f0274e24775..f5ddd6fbc0a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md @@ -18,7 +18,7 @@ An indexed property was accessed incorrectly. See [How to: Use Properties in C+ ## Example -The following sample generates C3293 in Visual Studio 2015 and earlier. +The following example generates C3293 in Visual Studio 2015 and earlier. ```cpp // C3293.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md index d24c70db0f2..c0e6096f56f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md @@ -18,7 +18,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Example -The following sample generates C3296. +The following example generates C3296. ```cpp // C3296.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md index 2be74dc44f2..2585206622c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md @@ -18,7 +18,7 @@ For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../ ## Example -The following sample generates C3297. +The following example generates C3297. ```cpp // C3297.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md index 6baf9d6a885..bcb8a6808e0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md @@ -18,7 +18,7 @@ For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../ ## Example -The following sample generates C3298. +The following example generates C3298. ```cpp // C3298.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md index 03964b63895..e44f79c1f05 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md @@ -20,7 +20,7 @@ For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../ ## Example -The following sample generates C3299. +The following example generates C3299. ```cpp // C3299.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md index f62f6a5449d..b623a5ab6df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md @@ -16,7 +16,7 @@ The value that you pass to the name property of the module attribute cannot be a ## Example -The following sample generates C3309: +The following example generates C3309: ```cpp // C3309.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md index ad2da725eb3..e5bb9981eee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md @@ -16,7 +16,7 @@ An exported user-defined type (UDT), which could be a struct, class, enum, or un ## Example -The following sample generates C3320: +The following example generates C3320: ```cpp // C3320.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md index 5947afd04ca..935284678c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md @@ -16,7 +16,7 @@ The [restricted](../../windows/attributes/restricted.md) attribute and the [defa ## Example -The following sample generates C3340: +The following example generates C3340: ```cpp // C3340.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md index b6e1ec96601..7ccad0e0742 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md @@ -20,7 +20,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3342. +The following example generates C3342. ```cpp // C3342.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md index 91a90d9e4ed..2b6ebc7d637 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md @@ -16,7 +16,7 @@ A required argument was not passed to the [idl_module](../../windows/attributes/ ## Example -The following sample generates C3347: +The following example generates C3347: ```cpp // C3347.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md index 2ef515a773a..0855e81f1dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md @@ -16,7 +16,7 @@ When you create an instance of a delegate, you must pass two arguments, an insta ## Example -The following sample generates C3350: +The following example generates C3350: ```cpp // C3350.cpp From 9fee0c07862ceb2fc8f6753242e2d8d4dec57fd9 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 01:36:08 +0800 Subject: [PATCH 0834/1799] Update metadata for error references in range [C3281, C3350] --- .../error-messages/compiler-errors-2/compiler-error-c3282.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3283.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3284.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3285.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3286.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3287.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c3288.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3289.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3290.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3291.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3292.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3293.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3296.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3297.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3298.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3299.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3303.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3309.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3320.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3322.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3333.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3334.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3340.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3342.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3345.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3347.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3350.md | 5 ++--- 27 files changed, 52 insertions(+), 79 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md index dbbbeb4afe4..741de4d6c9f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3282" title: "Compiler Error C3282" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3282" +ms.date: 11/04/2016 f1_keywords: ["C3282"] helpviewer_keywords: ["C3282"] -ms.assetid: bac2ac89-c360-4c24-bb81-c20c62ece9ba --- # Compiler Error C3282 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md index 5989fc71eba..bdd801d2ffd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3283" title: "Compiler Error C3283" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3283" +ms.date: 11/04/2016 f1_keywords: ["C3283"] helpviewer_keywords: ["C3283"] -ms.assetid: c51d912c-cde3-4928-904e-26734c8954ce --- # Compiler Error C3283 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md index 0ec077ca0c1..20908966346 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3284" title: "Compiler Error C3284" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3284" +ms.date: 11/04/2016 f1_keywords: ["C3284"] helpviewer_keywords: ["C3284"] -ms.assetid: e582f316-e9db-4d27-9c70-fdfa737a9d5f --- # Compiler Error C3284 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md index 995914e904f..fdd60a3eda7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3285" title: "Compiler Error C3285" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3285" +ms.date: 11/04/2016 f1_keywords: ["C3285"] helpviewer_keywords: ["C3285"] -ms.assetid: 04e8f210-d67e-4810-b153-e1efe2986c8f --- # Compiler Error C3285 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3286.md b/docs/error-messages/compiler-errors-2/compiler-error-c3286.md index 561be373a90..7a93263d5ff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3286.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3286.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3286" title: "Compiler Error C3286" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3286" +ms.date: 11/04/2016 f1_keywords: ["C3286"] helpviewer_keywords: ["C3286"] -ms.assetid: 554328c8-cf44-4f7d-a8d2-def74d28ecdd --- # Compiler Error C3286 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3287.md b/docs/error-messages/compiler-errors-2/compiler-error-c3287.md index 0a2988aa245..f039ff49189 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3287.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3287.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C++ compiler error C3287." ms.date: 09/25/2020 f1_keywords: ["C3287"] helpviewer_keywords: ["C3287"] -ms.assetid: c1fa73d2-2c82-4136-a7da-0e75e3b420ad --- # Compiler Error C3287 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md index 36a02c61a31..6597067eb90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3288" title: "Compiler Error C3288" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3288" +ms.date: 11/04/2016 f1_keywords: ["C3288"] helpviewer_keywords: ["C3288"] -ms.assetid: ed08a540-9751-46e1-9cbe-c51d6a49ffab --- # Compiler Error C3288 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md index c3493d65ff3..d4823e99655 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3289" title: "Compiler Error C3289" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3289" +ms.date: 11/04/2016 f1_keywords: ["C3289"] helpviewer_keywords: ["C3289"] -ms.assetid: 3c1c623b-7fcf-43ab-a89a-8722532a8d29 --- # Compiler Error C3289 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md index b5aa1aa18dd..86166548898 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3290" title: "Compiler Error C3290" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3290" +ms.date: 11/04/2016 f1_keywords: ["C3290"] helpviewer_keywords: ["C3290"] -ms.assetid: 0baf684b-1143-4953-ac99-a2fa267d8017 --- # Compiler Error C3290 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md index ffd70d1e8f8..ae67efb8b3a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3291" title: "Compiler Error C3291" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3291" +ms.date: 11/04/2016 f1_keywords: ["C3291"] helpviewer_keywords: ["C3291"] -ms.assetid: ed2e9f89-8dbc-4387-bc26-cc955e840858 --- # Compiler Error C3291 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md index 014ce5c1612..6951f30c688 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3292" title: "Compiler Error C3292" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3292" +ms.date: 11/04/2016 f1_keywords: ["C3292"] helpviewer_keywords: ["C3292"] -ms.assetid: ead485cc-5471-4e10-b361-300589ff5b70 --- # Compiler Error C3292 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md index f5ddd6fbc0a..e62c1f37089 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3293" title: "Compiler Error C3293" -ms.date: "07/21/2017" +description: "Learn more about: Compiler Error C3293" +ms.date: 07/21/2017 f1_keywords: ["C3293"] helpviewer_keywords: ["C3293"] -ms.assetid: b772cf98-52e0-4e24-be23-1f5d87d999ac --- # Compiler Error C3293 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md index c0e6096f56f..cc62bb8e34a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3296" title: "Compiler Error C3296" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3296" +ms.date: 11/04/2016 f1_keywords: ["C3296"] helpviewer_keywords: ["C3296"] -ms.assetid: fc4c9dcd-16cf-4eee-a1ac-c43e7c29e443 --- # Compiler Error C3296 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md index 2585206622c..8a2ba2122a7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3297" title: "Compiler Error C3297" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3297" +ms.date: 11/04/2016 f1_keywords: ["C3297"] helpviewer_keywords: ["C3297"] -ms.assetid: 2a718b4c-6cdb-4418-92c0-fc3a259431c4 --- # Compiler Error C3297 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md index bcb8a6808e0..5b6d1155d9c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3298" title: "Compiler Error C3298" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3298" +ms.date: 11/04/2016 f1_keywords: ["C3298"] helpviewer_keywords: ["C3298"] -ms.assetid: 458c2680-95bb-4d5e-895f-ce4115844193 --- # Compiler Error C3298 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md index e44f79c1f05..2ddb3da5245 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3299" title: "Compiler Error C3299" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3299" +ms.date: 11/04/2016 f1_keywords: ["C3299"] helpviewer_keywords: ["C3299"] -ms.assetid: 7cabdf01-bceb-404f-9401-cdd9c7fc1641 --- # Compiler Error C3299 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3303.md b/docs/error-messages/compiler-errors-2/compiler-error-c3303.md index 03f65642d61..db42b47058e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3303.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3303.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3303" title: "Compiler Error C3303" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3303" +ms.date: 11/04/2016 f1_keywords: ["C3303"] helpviewer_keywords: ["C3303"] -ms.assetid: c6f6ea3d-f6b7-4401-8bbb-f283a2c05540 --- # Compiler Error C3303 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md index b623a5ab6df..779f2c44544 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3309" title: "Compiler Error C3309" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3309" +ms.date: 11/04/2016 f1_keywords: ["C3309"] helpviewer_keywords: ["C3309"] -ms.assetid: 75ee16e3-7d4e-4c41-b3cb-64e9849c3aab --- # Compiler Error C3309 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md index e5bb9981eee..54472b937f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3320" title: "Compiler Error C3320" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3320" +ms.date: 11/04/2016 f1_keywords: ["C3320"] helpviewer_keywords: ["C3320"] -ms.assetid: 2ef72d9a-1f1d-4b2e-b244-9fd3f3e70cb6 --- # Compiler Error C3320 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3322.md b/docs/error-messages/compiler-errors-2/compiler-error-c3322.md index 1abf6d3d455..b8a614d504e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3322.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3322.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3322" title: "Compiler Error C3322" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3322" +ms.date: 11/04/2016 f1_keywords: ["C3322"] helpviewer_keywords: ["C3322"] -ms.assetid: d8a0ad95-30df-4337-b0c8-4747de0bef50 --- # Compiler Error C3322 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3333.md b/docs/error-messages/compiler-errors-2/compiler-error-c3333.md index fbc53c1ec41..6279bcb307d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3333.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3333.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3333" title: "Compiler Error C3333" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3333" +ms.date: 11/04/2016 f1_keywords: ["C3333"] helpviewer_keywords: ["C3333"] -ms.assetid: 51693978-fba6-435a-a696-74735cc875de --- # Compiler Error C3333 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3334.md b/docs/error-messages/compiler-errors-2/compiler-error-c3334.md index 7cf43b918e5..017856ba7c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3334.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3334.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3334" title: "Compiler Error C3334" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3334" +ms.date: 11/04/2016 f1_keywords: ["C3334"] helpviewer_keywords: ["C3334"] -ms.assetid: e972c625-77e7-4022-8aba-e1db01d7a0d7 --- # Compiler Error C3334 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md index 935284678c4..0c76035b527 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3340" title: "Compiler Error C3340" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3340" +ms.date: 11/04/2016 f1_keywords: ["C3340"] helpviewer_keywords: ["C3340"] -ms.assetid: 23b12298-b92a-4717-8380-f165c998cb8a --- # Compiler Error C3340 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md index 7ccad0e0742..e4edbd8c142 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3342" title: "Compiler Error C3342" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3342" +ms.date: 11/04/2016 f1_keywords: ["C3342"] helpviewer_keywords: ["C3342"] -ms.assetid: 5c6d784f-bebe-4f7e-8615-44ca6f78bfba --- # Compiler Error C3342 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3345.md b/docs/error-messages/compiler-errors-2/compiler-error-c3345.md index b607d6d74c2..852653abaa3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3345.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3345.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3345" title: "Compiler Error C3345" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3345" +ms.date: 11/04/2016 f1_keywords: ["C3345"] helpviewer_keywords: ["C3345"] -ms.assetid: 1dda4c79-73bb-441b-b939-746154c3afba --- # Compiler Error C3345 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md index 2b6ebc7d637..3433ff4fd12 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3347" title: "Compiler Error C3347" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3347" +ms.date: 11/04/2016 f1_keywords: ["C3347"] helpviewer_keywords: ["C3347"] -ms.assetid: e939ad29-0b78-4681-9618-9bdae5675cee --- # Compiler Error C3347 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md index 0855e81f1dc..57907de24ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3350" title: "Compiler Error C3350" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3350" +ms.date: 11/04/2016 f1_keywords: ["C3350"] helpviewer_keywords: ["C3350"] -ms.assetid: cfbbc338-92b5-4f34-999e-aa2d2376bc70 --- # Compiler Error C3350 From 81c5efe35cf5cba9722bc1ca0d2654b99fb800ee Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 22:53:30 +0800 Subject: [PATCH 0835/1799] Add blockquotes for error messages in range [C3351, C3380] --- docs/error-messages/compiler-errors-2/compiler-error-c3351.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3352.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3353.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3354.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3356.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3358.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3360.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3363.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3364.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3365.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3366.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3367.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3368.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3369.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3370.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3371.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3372.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3373.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3374.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3375.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3379.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3380.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md index 3962af7b367..15afe71af77 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md @@ -8,7 +8,7 @@ ms.assetid: c021bbbe-1067-4f51-af4f-940d2b792eb5 --- # Compiler Error C3351 -'object' : delegate constructor: second argument must be address of a static member function or global function +> 'object' : delegate constructor: second argument must be address of a static member function or global function The compiler expected the address of a function declared **`static`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md index 60bf88d2fa8..0dd8a0344cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md @@ -8,7 +8,7 @@ ms.assetid: f233bed7-474e-425f-aad2-7801578169d4 --- # Compiler Error C3352 -'function' : the specified function does not match the delegate type 'type' +> 'function' : the specified function does not match the delegate type 'type' The parameter lists for `function` and the delegate do not match. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md index de559c94332..82847fb666e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md @@ -8,7 +8,7 @@ ms.assetid: 5699c04b-d504-46ce-bf71-c200318fed71 --- # Compiler Error C3353 -'delegate' : a delegate can only be created from a global function or a member function of a managed or WinRT type +> 'delegate' : a delegate can only be created from a global function or a member function of a managed or WinRT type Delegates, declared with the [delegate](../../extensions/delegate-cpp-component-extensions.md) keyword, can only be declared at global scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md index ba44cfdb382..ad1c6f92580 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md @@ -8,7 +8,7 @@ ms.assetid: 185de401-231e-4999-a149-172ee4c69d84 --- # Compiler Error C3354 -'function' : the function used to create a delegate cannot have return type 'type' +> 'function' : the function used to create a delegate cannot have return type 'type' The following types are invalid as return types for a **`delegate`**: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3356.md b/docs/error-messages/compiler-errors-2/compiler-error-c3356.md index 507aa851102..d492d01e2fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3356.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3356.md @@ -8,6 +8,6 @@ ms.assetid: 6c1094f6-ac85-480a-b78b-e92fcf38641a --- # Compiler Error C3356 -'attribute': cannot call a multicast attribute with a fully qualified name +> 'attribute': cannot call a multicast attribute with a fully qualified name An attribute that is processed by more than one process, for example, the compiler and ATL provider, was specified incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md index 44e865694af..001d718a04f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md @@ -8,7 +8,7 @@ ms.assetid: 180b93df-e78f-441a-91fb-1594c681f7f0 --- # Compiler Error C3358 -'symbol': symbol not found +> 'symbol': symbol not found The required symbol was not found. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md index f8f06342a45..abacc0bab42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md @@ -8,7 +8,7 @@ ms.assetid: 6acf983a-dbb6-422b-b045-a34bb4ba6761 --- # Compiler Error C3360 -'string': cannot create name +> 'string': cannot create name The value that was passed to the [uuid](../../windows/attributes/uuid-cpp-attributes.md) attribute was not valid. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md index d224e476b45..6812e4879c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md @@ -8,7 +8,7 @@ ms.assetid: 41aa922f-608e-4f7a-ba66-451fc1161935 --- # Compiler Error C3363 -'type' : 'typeid' can only be applied to a type +> 'type' : 'typeid' can only be applied to a type The [typeid](../../extensions/typeid-cpp-component-extensions.md) operator was used incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md index 252a5951662..f0e36b2face 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md @@ -8,7 +8,7 @@ ms.assetid: 98654741-60fe-4472-a6af-e580f8c0a6e1 --- # Compiler Error C3364 -'delegate': delegate constructor: argument must be pointer to member function of managed class or global function +> 'delegate': delegate constructor: argument must be pointer to member function of managed class or global function The second parameter of the delegate's constructor takes either the address of a member function or the address of a static member function of any class. Both are treated as simple addresses. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md index 2966274d70a..142da9423e0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md @@ -8,7 +8,7 @@ ms.assetid: 875ec3a4-522c-4e3d-9b67-48808b857f6d --- # Compiler Error C3365 -operator 'operator' : differing operands of type 'type1' and 'type2' +> operator 'operator' : differing operands of type 'type1' and 'type2' An attempt was made to compose delegates with different types. See [How to: Define and Use Delegates (C++/CLI)](../../dotnet/how-to-define-and-use-delegates-cpp-cli.md) for more information about delegates. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3366.md b/docs/error-messages/compiler-errors-2/compiler-error-c3366.md index e29cedffa30..0bad588f1a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3366.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3366.md @@ -8,7 +8,7 @@ ms.assetid: efc55bcf-c16d-43c1-a36f-87a6165fa2a8 --- # Compiler Error C3366 -'variable' : static data members of managed or WinRTtypes must be defined within the class definition +> 'variable' : static data members of managed or WinRTtypes must be defined within the class definition You attempted to reference a static member of a WinRT or .NET class or interface outside the definition of that class or interface. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md index c7b9e199930..bea8903dd32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md @@ -8,7 +8,7 @@ ms.assetid: e675d42b-f5b0-4d43-aab1-1f5024233102 --- # Compiler Error C3367 -'static_member_function' : cannot use static function to create an unbound delegate +> 'static_member_function' : cannot use static function to create an unbound delegate When you call an unbound delegate, you must pass an instance of an object. Since a static member function is called through the class name, you can only instantiate an unbound delegate with an instance member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md index 56c588043ec..1a5e2ced1ab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md @@ -8,7 +8,7 @@ ms.assetid: 5bfd5be4-dfa9-4b33-9612-010561b40955 --- # Compiler Error C3368 -'function declaration' : invalid calling convention for IDL +> 'function declaration' : invalid calling convention for IDL You can only use the [__stdcall](../../cpp/stdcall.md) or [__cdecl](../../cpp/cdecl.md) calling conventions in an .idl file. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md index 55cbcf23004..edca169b28a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md @@ -8,7 +8,7 @@ ms.assetid: c6ceb9cb-3df9-4334-9a5c-d16db351d476 --- # Compiler Error C3369 -'module name': idl_module already defined +> 'module name': idl_module already defined The [idl_module](../../windows/attributes/idl-module.md) usage where you define the DLL can only occur once in a program. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md index 519ed9ab92b..2671472ae01 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md @@ -8,7 +8,7 @@ ms.assetid: ee6d4c85-78fc-42b2-836e-5cc491a3b2ba --- # Compiler Error C3370 -'idl_module name': idl_module not yet defined +> 'idl_module name': idl_module not yet defined Before you can use [idl_module](../../windows/attributes/idl-module.md) to specify an entry point in a DLL, you must first use `idl_module` to specify the DLL name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md index 3eed2c81fba..7e6e671752a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md @@ -8,7 +8,7 @@ ms.assetid: f7ecf1aa-ed0a-4f73-81e5-62cf98f88ea1 --- # Compiler Error C3371 -'idl_module': only the 'name' property is allowed here +> 'idl_module': only the 'name' property is allowed here [idl_module](../../windows/attributes/idl-module.md) usage directly on a function declaration cannot have any parameters other than name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md index 52307011d61..18d4c689e85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md @@ -8,7 +8,7 @@ ms.assetid: 38ee39ed-03ff-4e6d-9104-f1977b96645d --- # Compiler Error C3372 -must specify at least 1 interface for attribute 'source' on a coclass +> must specify at least 1 interface for attribute 'source' on a coclass For certain attributes, you must pass an interface name as a parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md index 373f91ea803..6f9cc0a09e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md @@ -8,7 +8,7 @@ ms.assetid: 6e7586c3-1a15-4773-ad20-f90090a400dc --- # Compiler Error C3373 -attribute 'attribute' takes no arguments except on a coclass +> attribute 'attribute' takes no arguments except on a coclass Some attributes can be applied to more than one C++ construct, but arguments to the attribute may only be allowed on some constructs. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md index 5b1012f661c..678e67608d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md @@ -8,7 +8,7 @@ ms.assetid: 41431299-bd20-47d4-a0c8-1334dd79018b --- # Compiler Error C3374 -can't take address of 'function' unless creating delegate instance +> can't take address of 'function' unless creating delegate instance The address of a function was taken in a context other than the creation of a delegate instance. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md index 5e7405e0170..a8b6e273934 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md @@ -8,7 +8,7 @@ ms.assetid: f1df78c6-e6ca-48f3-8b29-4e1710002bf3 --- # Compiler Error C3375 -'function' : ambiguous delegate function +> 'function' : ambiguous delegate function A delegate instantiation could have been to a static member function, or as an unbound delegate to an instance function, so the compiler issued this error. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md index baacee8b4ed..70fb29ae35b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md @@ -8,7 +8,7 @@ ms.assetid: a66c2c4e-091c-4426-9cde-7c4cfb2ffce1 --- # Compiler Error C3379 -'class' : a nested class cannot have an assembly access specifier as part of its declaration +> 'class' : a nested class cannot have an assembly access specifier as part of its declaration When applied to a managed type, such as class or struct, the [public](../../cpp/public-cpp.md) and [private](../../cpp/private-cpp.md) keywords indicate whether the class will be exposed through assembly metadata. `public` or `private` cannot be applied to a nested class, which will inherit the assembly access of the enclosing class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md index a150009936f..327f951fce0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md @@ -8,7 +8,7 @@ ms.assetid: 86f1f4ec-4ad8-4a1a-9b6c-2d9b6129df6b --- # Compiler Error C3380 -'class' : invalid assembly access specifier - only 'public' or 'private' are allowed +> 'class' : invalid assembly access specifier - only 'public' or 'private' are allowed When applied to a managed class or struct, the [public](../../cpp/public-cpp.md) and [private](../../cpp/private-cpp.md) keywords indicate whether the class will be exposed through assembly metadata. Only `public` or `private` can be applied to a class in a program compiled with [/clr](../../build/reference/clr-common-language-runtime-compilation.md). From a950c523af515a4557affea134f9f679606c5606 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 22:58:18 +0800 Subject: [PATCH 0836/1799] Add "Remarks" and "Example" headings for error references in range [C3351, C3380] --- docs/error-messages/compiler-errors-2/compiler-error-c3351.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3352.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3353.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3354.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3356.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3358.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3360.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3363.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3364.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3365.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3366.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3367.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3368.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3369.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3370.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3371.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3372.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3373.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3374.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3375.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3379.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3380.md | 4 ++++ 22 files changed, 78 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md index 15afe71af77..42beedd511c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md @@ -10,8 +10,12 @@ ms.assetid: c021bbbe-1067-4f51-af4f-940d2b792eb5 > 'object' : delegate constructor: second argument must be address of a static member function or global function +## Remarks + The compiler expected the address of a function declared **`static`**. +## Example + The following sample generates C3351: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md index 0dd8a0344cf..75035f649b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md @@ -10,10 +10,14 @@ ms.assetid: f233bed7-474e-425f-aad2-7801578169d4 > 'function' : the specified function does not match the delegate type 'type' +## Remarks + The parameter lists for `function` and the delegate do not match. For more information, see [delegate (C++ Component Extensions)](../../extensions/delegate-cpp-component-extensions.md). +## Example + The following sample generates C3352: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md index 82847fb666e..139357669d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md @@ -10,8 +10,12 @@ ms.assetid: 5699c04b-d504-46ce-bf71-c200318fed71 > 'delegate' : a delegate can only be created from a global function or a member function of a managed or WinRT type +## Remarks + Delegates, declared with the [delegate](../../extensions/delegate-cpp-component-extensions.md) keyword, can only be declared at global scope. +## Example + The following sample generates C3353: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md index ad1c6f92580..aede715b387 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md @@ -10,6 +10,8 @@ ms.assetid: 185de401-231e-4999-a149-172ee4c69d84 > 'function' : the function used to create a delegate cannot have return type 'type' +## Remarks + The following types are invalid as return types for a **`delegate`**: - Pointer to function @@ -22,6 +24,8 @@ The following types are invalid as return types for a **`delegate`**: - Reference to member function +## Example + The following sample generates C3354: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3356.md b/docs/error-messages/compiler-errors-2/compiler-error-c3356.md index d492d01e2fd..7a3cec652f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3356.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3356.md @@ -10,4 +10,6 @@ ms.assetid: 6c1094f6-ac85-480a-b78b-e92fcf38641a > 'attribute': cannot call a multicast attribute with a fully qualified name +## Remarks + An attribute that is processed by more than one process, for example, the compiler and ATL provider, was specified incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md index 001d718a04f..63982232512 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md @@ -10,8 +10,12 @@ ms.assetid: 180b93df-e78f-441a-91fb-1594c681f7f0 > 'symbol': symbol not found +## Remarks + The required symbol was not found. +## Example + The following sample generates C3358: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md index abacc0bab42..df2709f2986 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md @@ -10,8 +10,12 @@ ms.assetid: 6acf983a-dbb6-422b-b045-a34bb4ba6761 > 'string': cannot create name +## Remarks + The value that was passed to the [uuid](../../windows/attributes/uuid-cpp-attributes.md) attribute was not valid. +## Example + The following sample generates C3360: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md index 6812e4879c5..7518bdfdc2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md @@ -10,6 +10,8 @@ ms.assetid: 41aa922f-608e-4f7a-ba66-451fc1161935 > 'type' : 'typeid' can only be applied to a type +## Remarks + The [typeid](../../extensions/typeid-cpp-component-extensions.md) operator was used incorrectly. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md index f0e36b2face..38c6170d199 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md @@ -10,8 +10,12 @@ ms.assetid: 98654741-60fe-4472-a6af-e580f8c0a6e1 > 'delegate': delegate constructor: argument must be pointer to member function of managed class or global function +## Remarks + The second parameter of the delegate's constructor takes either the address of a member function or the address of a static member function of any class. Both are treated as simple addresses. +## Example + The following sample generates C3364: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md index 142da9423e0..284e8d6dc9e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md @@ -10,6 +10,8 @@ ms.assetid: 875ec3a4-522c-4e3d-9b67-48808b857f6d > operator 'operator' : differing operands of type 'type1' and 'type2' +## Remarks + An attempt was made to compose delegates with different types. See [How to: Define and Use Delegates (C++/CLI)](../../dotnet/how-to-define-and-use-delegates-cpp-cli.md) for more information about delegates. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3366.md b/docs/error-messages/compiler-errors-2/compiler-error-c3366.md index 0bad588f1a4..3d48bc014b1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3366.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3366.md @@ -10,10 +10,14 @@ ms.assetid: efc55bcf-c16d-43c1-a36f-87a6165fa2a8 > 'variable' : static data members of managed or WinRTtypes must be defined within the class definition +## Remarks + You attempted to reference a static member of a WinRT or .NET class or interface outside the definition of that class or interface. The compiler needs to know the full definition of the class (to emit the meta-data after one pass) and requires static data members to be initialized within the class. +## Example + For example, the following example generates C3366 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md index bea8903dd32..1580a10fb58 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md @@ -10,6 +10,8 @@ ms.assetid: e675d42b-f5b0-4d43-aab1-1f5024233102 > 'static_member_function' : cannot use static function to create an unbound delegate +## Remarks + When you call an unbound delegate, you must pass an instance of an object. Since a static member function is called through the class name, you can only instantiate an unbound delegate with an instance member function. For more information about unbound delegates, see [How to: Define and Use Delegates (C++/CLI)](../../dotnet/how-to-define-and-use-delegates-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md index 1a5e2ced1ab..4d64b2dd87b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md @@ -10,8 +10,12 @@ ms.assetid: 5bfd5be4-dfa9-4b33-9612-010561b40955 > 'function declaration' : invalid calling convention for IDL +## Remarks + You can only use the [__stdcall](../../cpp/stdcall.md) or [__cdecl](../../cpp/cdecl.md) calling conventions in an .idl file. +## Example + The following sample generates C3368: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md index edca169b28a..79889bfb194 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md @@ -10,8 +10,12 @@ ms.assetid: c6ceb9cb-3df9-4334-9a5c-d16db351d476 > 'module name': idl_module already defined +## Remarks + The [idl_module](../../windows/attributes/idl-module.md) usage where you define the DLL can only occur once in a program. +## Example + The following sample generates C3369: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md index 2671472ae01..c4e27fb8972 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md @@ -10,8 +10,12 @@ ms.assetid: ee6d4c85-78fc-42b2-836e-5cc491a3b2ba > 'idl_module name': idl_module not yet defined +## Remarks + Before you can use [idl_module](../../windows/attributes/idl-module.md) to specify an entry point in a DLL, you must first use `idl_module` to specify the DLL name. +## Example + The following sample generates C3370: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md index 7e6e671752a..2ded708823d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md @@ -10,8 +10,12 @@ ms.assetid: f7ecf1aa-ed0a-4f73-81e5-62cf98f88ea1 > 'idl_module': only the 'name' property is allowed here +## Remarks + [idl_module](../../windows/attributes/idl-module.md) usage directly on a function declaration cannot have any parameters other than name. +## Example + The following sample generates C3371: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md index 18d4c689e85..67bcbfc4acc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md @@ -10,8 +10,12 @@ ms.assetid: 38ee39ed-03ff-4e6d-9104-f1977b96645d > must specify at least 1 interface for attribute 'source' on a coclass +## Remarks + For certain attributes, you must pass an interface name as a parameter. +## Example + The following sample generates C3372: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md index 6f9cc0a09e7..6f11d64290e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md @@ -10,8 +10,12 @@ ms.assetid: 6e7586c3-1a15-4773-ad20-f90090a400dc > attribute 'attribute' takes no arguments except on a coclass +## Remarks + Some attributes can be applied to more than one C++ construct, but arguments to the attribute may only be allowed on some constructs. +## Example + The following sample generates C3373: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md index 678e67608d5..4f09aa18329 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md @@ -10,8 +10,12 @@ ms.assetid: 41431299-bd20-47d4-a0c8-1334dd79018b > can't take address of 'function' unless creating delegate instance +## Remarks + The address of a function was taken in a context other than the creation of a delegate instance. +## Example + The following sample generates C3374: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md index a8b6e273934..4448554644a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md @@ -10,6 +10,8 @@ ms.assetid: f1df78c6-e6ca-48f3-8b29-4e1710002bf3 > 'function' : ambiguous delegate function +## Remarks + A delegate instantiation could have been to a static member function, or as an unbound delegate to an instance function, so the compiler issued this error. For more information, see [delegate (C++ Component Extensions)](../../extensions/delegate-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md index 70fb29ae35b..91ccf04ac3c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md @@ -10,10 +10,14 @@ ms.assetid: a66c2c4e-091c-4426-9cde-7c4cfb2ffce1 > 'class' : a nested class cannot have an assembly access specifier as part of its declaration +## Remarks + When applied to a managed type, such as class or struct, the [public](../../cpp/public-cpp.md) and [private](../../cpp/private-cpp.md) keywords indicate whether the class will be exposed through assembly metadata. `public` or `private` cannot be applied to a nested class, which will inherit the assembly access of the enclosing class. When used with [/clr](../../build/reference/clr-common-language-runtime-compilation.md), the `ref` and `value` keywords indicate that a class is managed (see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md)). +## Example + The following sample generates C3379: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md index 327f951fce0..8ef29bd8b96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md @@ -10,10 +10,14 @@ ms.assetid: 86f1f4ec-4ad8-4a1a-9b6c-2d9b6129df6b > 'class' : invalid assembly access specifier - only 'public' or 'private' are allowed +## Remarks + When applied to a managed class or struct, the [public](../../cpp/public-cpp.md) and [private](../../cpp/private-cpp.md) keywords indicate whether the class will be exposed through assembly metadata. Only `public` or `private` can be applied to a class in a program compiled with [/clr](../../build/reference/clr-common-language-runtime-compilation.md). The `ref` and `value` keywords, when used with [/clr](../../build/reference/clr-common-language-runtime-compilation.md), indicate that a class is managed (see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md)). +## Example + The following sample generates C3380: ```cpp From 49178dfbf3e5462d47f56ebe99ad606f1d0104b1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 22:59:44 +0800 Subject: [PATCH 0837/1799] Replace term "sample" with "example" for error references in range [C3351, C3380] --- docs/error-messages/compiler-errors-2/compiler-error-c3351.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3352.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3353.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3354.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3358.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3360.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3363.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3364.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3365.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3367.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3368.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3369.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3370.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3371.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3372.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3373.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3374.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3375.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3379.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3380.md | 2 +- 20 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md index 42beedd511c..079948a12b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md @@ -16,7 +16,7 @@ The compiler expected the address of a function declared **`static`**. ## Example -The following sample generates C3351: +The following example generates C3351: ```cpp // C3351a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md index 75035f649b6..91d5f99366b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md @@ -18,7 +18,7 @@ For more information, see [delegate (C++ Component Extensions)](../../extension ## Example -The following sample generates C3352: +The following example generates C3352: ```cpp // C3352.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md index 139357669d6..8a47cd563c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md @@ -16,7 +16,7 @@ Delegates, declared with the [delegate](../../extensions/delegate-cpp-component- ## Example -The following sample generates C3353: +The following example generates C3353: ```cpp // C3353.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md index aede715b387..09900981d9f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md @@ -26,7 +26,7 @@ The following types are invalid as return types for a **`delegate`**: ## Example -The following sample generates C3354: +The following example generates C3354: ```cpp // C3354_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md index 63982232512..6b2b3656c4a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md @@ -16,7 +16,7 @@ The required symbol was not found. ## Example -The following sample generates C3358: +The following example generates C3358: ```cpp // C3358.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md index df2709f2986..4fa91cab148 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md @@ -16,7 +16,7 @@ The value that was passed to the [uuid](../../windows/attributes/uuid-cpp-attrib ## Example -The following sample generates C3360: +The following example generates C3360: ```cpp // C3360.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md index 7518bdfdc2a..1ad704c43f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md @@ -16,7 +16,7 @@ The [typeid](../../extensions/typeid-cpp-component-extensions.md) operator was u ## Example -The following sample generates C3363. +The following example generates C3363. ```cpp // C3363.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md index 38c6170d199..214cf427df4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md @@ -16,7 +16,7 @@ The second parameter of the delegate's constructor takes either the address of a ## Example -The following sample generates C3364: +The following example generates C3364: ```cpp // C3364_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md index 284e8d6dc9e..222b51a2cd0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md @@ -16,7 +16,7 @@ An attempt was made to compose delegates with different types. See [How to: Def ## Example -The following sample generates C3365: +The following example generates C3365: ```cpp // C3365.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md index 1580a10fb58..327cd655784 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md @@ -18,7 +18,7 @@ For more information about unbound delegates, see [How to: Define and Use Delega ## Example -The following sample generates C3367. +The following example generates C3367. ```cpp // C3367.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md index 4d64b2dd87b..2382f3e91fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md @@ -16,7 +16,7 @@ You can only use the [__stdcall](../../cpp/stdcall.md) or [__cdecl](../../cpp/cd ## Example -The following sample generates C3368: +The following example generates C3368: ```cpp // C3368.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md index 79889bfb194..97b352ee4c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md @@ -16,7 +16,7 @@ The [idl_module](../../windows/attributes/idl-module.md) usage where you define ## Example -The following sample generates C3369: +The following example generates C3369: ```cpp // C3369.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md index c4e27fb8972..56d0852efc7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md @@ -16,7 +16,7 @@ Before you can use [idl_module](../../windows/attributes/idl-module.md) to speci ## Example -The following sample generates C3370: +The following example generates C3370: ```cpp // C3370.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md index 2ded708823d..1900015fb0e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md @@ -16,7 +16,7 @@ ms.assetid: f7ecf1aa-ed0a-4f73-81e5-62cf98f88ea1 ## Example -The following sample generates C3371: +The following example generates C3371: ```cpp // C3371.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md index 67bcbfc4acc..5073a30a455 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md @@ -16,7 +16,7 @@ For certain attributes, you must pass an interface name as a parameter. ## Example -The following sample generates C3372: +The following example generates C3372: ```cpp // C3372.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md index 6f11d64290e..d260eead253 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md @@ -16,7 +16,7 @@ Some attributes can be applied to more than one C++ construct, but arguments to ## Example -The following sample generates C3373: +The following example generates C3373: ```cpp // C3373.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md index 4f09aa18329..f48424178c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md @@ -16,7 +16,7 @@ The address of a function was taken in a context other than the creation of a de ## Example -The following sample generates C3374: +The following example generates C3374: ```cpp // C3374.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md index 4448554644a..9965fafd1f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md @@ -18,7 +18,7 @@ For more information, see [delegate (C++ Component Extensions)](../../extension ## Example -The following sample generates C3375. +The following example generates C3375. ```cpp // C3375.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md index 91ccf04ac3c..344ccf4dcfb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md @@ -18,7 +18,7 @@ When used with [/clr](../../build/reference/clr-common-language-runtime-compilat ## Example -The following sample generates C3379: +The following example generates C3379: ```cpp // C3379a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md index 8ef29bd8b96..f56a950de90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md @@ -18,7 +18,7 @@ The `ref` and `value` keywords, when used with [/clr](../../build/reference/clr- ## Example -The following sample generates C3380: +The following example generates C3380: ```cpp // C3380_2.cpp From 9eaca13e699207e5934b5f739d191132873df094 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 23:03:05 +0800 Subject: [PATCH 0838/1799] Update metadata for error references in range [C3351, C3380] --- .../error-messages/compiler-errors-2/compiler-error-c3351.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3352.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3353.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3354.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3356.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3358.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3360.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3363.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3364.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3365.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3366.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3367.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3368.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3369.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3370.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3371.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3372.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3373.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3374.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3375.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3379.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3380.md | 5 ++--- 22 files changed, 44 insertions(+), 66 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md index 079948a12b6..0734f32ab3f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3351" title: "Compiler Error C3351" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3351" +ms.date: 11/04/2016 f1_keywords: ["C3351"] helpviewer_keywords: ["C3351"] -ms.assetid: c021bbbe-1067-4f51-af4f-940d2b792eb5 --- # Compiler Error C3351 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md index 91d5f99366b..1268b23389d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3352" title: "Compiler Error C3352" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3352" +ms.date: 11/04/2016 f1_keywords: ["C3352"] helpviewer_keywords: ["C3352"] -ms.assetid: f233bed7-474e-425f-aad2-7801578169d4 --- # Compiler Error C3352 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md index 8a47cd563c5..1499d4c19ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3353" title: "Compiler Error C3353" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3353" +ms.date: 11/04/2016 f1_keywords: ["C3353"] helpviewer_keywords: ["C3353"] -ms.assetid: 5699c04b-d504-46ce-bf71-c200318fed71 --- # Compiler Error C3353 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md index 09900981d9f..a3f9b768b05 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3354" title: "Compiler Error C3354" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3354" +ms.date: 11/04/2016 f1_keywords: ["C3354"] helpviewer_keywords: ["C3354"] -ms.assetid: 185de401-231e-4999-a149-172ee4c69d84 --- # Compiler Error C3354 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3356.md b/docs/error-messages/compiler-errors-2/compiler-error-c3356.md index 7a3cec652f9..d4ead99fde5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3356.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3356.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3356" title: "Compiler Error C3356" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3356" +ms.date: 11/04/2016 f1_keywords: ["C3356"] helpviewer_keywords: ["C3356"] -ms.assetid: 6c1094f6-ac85-480a-b78b-e92fcf38641a --- # Compiler Error C3356 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md index 6b2b3656c4a..e433cbf1dce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3358" title: "Compiler Error C3358" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3358" +ms.date: 11/04/2016 f1_keywords: ["C3358"] helpviewer_keywords: ["C3358"] -ms.assetid: 180b93df-e78f-441a-91fb-1594c681f7f0 --- # Compiler Error C3358 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md index 4fa91cab148..312db01e736 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3360" title: "Compiler Error C3360" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3360" +ms.date: 11/04/2016 f1_keywords: ["C3360"] helpviewer_keywords: ["C3360"] -ms.assetid: 6acf983a-dbb6-422b-b045-a34bb4ba6761 --- # Compiler Error C3360 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md index 1ad704c43f7..11a8d33c1f1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3363" title: "Compiler Error C3363" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3363" +ms.date: 11/04/2016 f1_keywords: ["C3363"] helpviewer_keywords: ["C3363"] -ms.assetid: 41aa922f-608e-4f7a-ba66-451fc1161935 --- # Compiler Error C3363 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md index 214cf427df4..97e7ec74e88 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3364" title: "Compiler Error C3364" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3364" +ms.date: 11/04/2016 f1_keywords: ["C3364"] helpviewer_keywords: ["C3364"] -ms.assetid: 98654741-60fe-4472-a6af-e580f8c0a6e1 --- # Compiler Error C3364 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md index 222b51a2cd0..4d6ea4ed4f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3365" title: "Compiler Error C3365" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3365" +ms.date: 11/04/2016 f1_keywords: ["C3365"] helpviewer_keywords: ["C3365"] -ms.assetid: 875ec3a4-522c-4e3d-9b67-48808b857f6d --- # Compiler Error C3365 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3366.md b/docs/error-messages/compiler-errors-2/compiler-error-c3366.md index 3d48bc014b1..084e2ae3240 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3366.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3366.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3366" title: "Compiler Error C3366" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3366" +ms.date: 11/04/2016 f1_keywords: ["C3366"] helpviewer_keywords: ["C3366"] -ms.assetid: efc55bcf-c16d-43c1-a36f-87a6165fa2a8 --- # Compiler Error C3366 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md index 327cd655784..906b2d970b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3367" title: "Compiler Error C3367" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3367" +ms.date: 11/04/2016 f1_keywords: ["C3367"] helpviewer_keywords: ["C3367"] -ms.assetid: e675d42b-f5b0-4d43-aab1-1f5024233102 --- # Compiler Error C3367 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md index 2382f3e91fb..8b719026039 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3368" title: "Compiler Error C3368" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3368" +ms.date: 11/04/2016 f1_keywords: ["C3368"] helpviewer_keywords: ["C3368"] -ms.assetid: 5bfd5be4-dfa9-4b33-9612-010561b40955 --- # Compiler Error C3368 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md index 97b352ee4c7..fd633c461d1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3369" title: "Compiler Error C3369" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3369" +ms.date: 11/04/2016 f1_keywords: ["C3369"] helpviewer_keywords: ["C3369"] -ms.assetid: c6ceb9cb-3df9-4334-9a5c-d16db351d476 --- # Compiler Error C3369 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md index 56d0852efc7..c6771ad1148 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3370" title: "Compiler Error C3370" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3370" +ms.date: 11/04/2016 f1_keywords: ["C3370"] helpviewer_keywords: ["C3370"] -ms.assetid: ee6d4c85-78fc-42b2-836e-5cc491a3b2ba --- # Compiler Error C3370 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md index 1900015fb0e..d6003778a7f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3371" title: "Compiler Error C3371" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3371" +ms.date: 11/04/2016 f1_keywords: ["C3371"] helpviewer_keywords: ["C3371"] -ms.assetid: f7ecf1aa-ed0a-4f73-81e5-62cf98f88ea1 --- # Compiler Error C3371 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md index 5073a30a455..91cb56aa842 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3372" title: "Compiler Error C3372" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3372" +ms.date: 11/04/2016 f1_keywords: ["C3372"] helpviewer_keywords: ["C3372"] -ms.assetid: 38ee39ed-03ff-4e6d-9104-f1977b96645d --- # Compiler Error C3372 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md index d260eead253..5df76fc80d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3373" title: "Compiler Error C3373" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3373" +ms.date: 11/04/2016 f1_keywords: ["C3373"] helpviewer_keywords: ["C3373"] -ms.assetid: 6e7586c3-1a15-4773-ad20-f90090a400dc --- # Compiler Error C3373 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md index f48424178c8..3256f943241 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3374" title: "Compiler Error C3374" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3374" +ms.date: 11/04/2016 f1_keywords: ["C3374"] helpviewer_keywords: ["C3374"] -ms.assetid: 41431299-bd20-47d4-a0c8-1334dd79018b --- # Compiler Error C3374 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md index 9965fafd1f0..41c91468995 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3375" title: "Compiler Error C3375" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3375" +ms.date: 11/04/2016 f1_keywords: ["C3375"] helpviewer_keywords: ["C3375"] -ms.assetid: f1df78c6-e6ca-48f3-8b29-4e1710002bf3 --- # Compiler Error C3375 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md index 344ccf4dcfb..3d953bb8c7d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3379" title: "Compiler Error C3379" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3379" +ms.date: 11/04/2016 f1_keywords: ["C3379"] helpviewer_keywords: ["C3379"] -ms.assetid: a66c2c4e-091c-4426-9cde-7c4cfb2ffce1 --- # Compiler Error C3379 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md index f56a950de90..124b958b0d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3380" title: "Compiler Error C3380" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3380" +ms.date: 11/04/2016 f1_keywords: ["C3380"] helpviewer_keywords: ["C3380"] -ms.assetid: 86f1f4ec-4ad8-4a1a-9b6c-2d9b6129df6b --- # Compiler Error C3380 From 3d64461339e3fd13158e2f519094879b80039223 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 18 Aug 2025 23:57:27 +0800 Subject: [PATCH 0839/1799] Fix some typos in `` functions reference --- docs/standard-library/algorithm-functions.md | 36 ++++++++++---------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/standard-library/algorithm-functions.md b/docs/standard-library/algorithm-functions.md index b243d2c1ebb..7e55579a809 100644 --- a/docs/standard-library/algorithm-functions.md +++ b/docs/standard-library/algorithm-functions.md @@ -595,7 +595,7 @@ An output iterator addressing the position that is one past the final element in The source range must be valid and there must be sufficient space at the destination to hold all the elements being copied. -The `copy_backward` algorithm imposes more stringent requirements than that the `copy` algorithm. Both its input and output iterators must be bidirectional. +The `copy_backward` algorithm imposes more stringent requirements than the `copy` algorithm. Both its input and output iterators must be bidirectional. The `copy_backward` and [`move_backward`](algorithm-functions.md#move_backward) algorithms are the only C++ Standard Library algorithms designating the output range with an iterator pointing to the end of the destination range. @@ -908,13 +908,13 @@ int main() vector::iterator::difference_type result; result = count(v1.begin(), v1.end(), 10); - cout << "The number of 10s in v2 is: " << result << "." << endl; + cout << "The number of 10s in v1 is: " << result << "." << endl; } ``` ```Output v1 = ( 10 20 10 40 10 ) -The number of 10s in v2 is: 3. +The number of 10s in v1 is: 3. ``` ## `count_if` @@ -2149,7 +2149,7 @@ public: { } - // The function call to process the next elment + // The function call to process the next element void operator( ) ( int elem ) { num++; // Increment the element count @@ -2686,7 +2686,7 @@ int main() cout << *Iter3b << " "; cout << ")." << endl; - // To test for inclusion under an asscending order + // To test for inclusion under an ascending order // with the default binary predicate less( ) bool Result1; Result1 = includes ( v1a.begin( ), v1a.end( ), @@ -5933,7 +5933,7 @@ int main() cout << *Iter1 << " "; cout << ")." << endl; - // Partition the range with predicate greater10 + // Partition the range with predicate greater5 partition ( v1.begin( ), v1.end( ), greater5 ); cout << "The partitioned set of elements in v1 is: ( " ; for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ ) @@ -6694,7 +6694,7 @@ An input iterator addressing the position one past the final element in the rang An output iterator addressing the position of the first element in the destination range to which elements are being removed. *`pred`*\ -The unary predicate that must be satisfied is the value of an element is to be replaced. +The unary predicate that must be satisfied if the value of an element is to be replaced. ### Return value @@ -6751,7 +6751,7 @@ int main() new_end = remove_copy_if ( v1.begin( ), v1.end( ), v2.begin( ), greater6 ); - cout << "After the appliation of remove_copy_if to v1,\n " + cout << "After the application of remove_copy_if to v1,\n " << "vector v1 is left unchanged as ( " ; for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ ) cout << *Iter1 << " "; @@ -6767,7 +6767,7 @@ int main() ```Output The original vector v1 is: ( 4 7 7 7 0 5 7 1 6 9 3 7 8 2 ). -After the appliation of remove_copy_if to v1, +After the application of remove_copy_if to v1, vector v1 is left unchanged as ( 4 7 7 7 0 5 7 1 6 9 3 7 8 2 ). Vector v2 is a copy of v1 with values greater than 6 removed: ( 4 0 5 1 6 3 2 ). @@ -6804,7 +6804,7 @@ A forward iterator pointing to the position of the first element in the range fr A forward iterator pointing to the position one past the final element in the range from which elements are being removed. *`pred`*\ -The unary predicate that must be satisfied is the value of an element is to be replaced. +The unary predicate that must be satisfied if the value of an element is to be replaced. ### Return value @@ -7148,7 +7148,7 @@ An input iterator pointing to the position one past the final element in the ran An output iterator pointing to the position of the first element in the destination range to which elements are being copied. *`pred`*\ -The unary predicate that must be satisfied is the value of an element is to be replaced. +The unary predicate that must be satisfied if the value of an element is to be replaced. *`value`*\ The new value being assigned to the elements whose old value satisfies the predicate. @@ -7277,7 +7277,7 @@ A forward iterator pointing to the position of the first element in the range fr An iterator pointing to the position one past the final element in the range from which elements are being replaced. *`pred`*\ -The unary predicate that must be satisfied is the value of an element is to be replaced. +The unary predicate that must be satisfied if the value of an element is to be replaced. *`value`*\ The new value being assigned to the elements whose old value satisfies the predicate. @@ -8269,7 +8269,7 @@ int main() cout << *Iter3b << " "; cout << ")." << endl; - // To combine into a difference in asscending + // To combine into a difference in ascending // order with the default binary predicate less( ) Result1 = set_difference ( v1a.begin( ), v1a.end( ), v1b.begin( ), v1b.end( ), v1.begin( ) ); @@ -8488,7 +8488,7 @@ int main() cout << *Iter3b << " "; cout << ")." << endl; - // To combine into an intersection in asscending order with the + // To combine into an intersection in ascending order with the // default binary predicate less( ) Result1 = set_intersection ( v1a.begin( ), v1a.end( ), v1b.begin( ), v1b.end( ), v1.begin( ) ); @@ -9170,7 +9170,7 @@ Heaps have two properties: - Elements may be added or removed in logarithmic time. -After the application if this algorithm, the range it was applied to is no longer a heap. +After the application of this algorithm, the range it was applied to is no longer a heap. `sort_heap` isn't a stable sort because the relative order of equivalent elements isn't necessarily preserved. @@ -9585,7 +9585,7 @@ A forward iterator pointing to one past the final position of the second range w The ranges referenced must be valid; all pointers must be dereferenceable and within each sequence the last position is reachable from the first by incrementation. The second range has to be as large as the first range. -The complexity is linear with *last1* - *first1* swaps performed. If elements from containers of the same type are being swapped, them the `swap` member function from that container should be used, because the member function typically has constant complexity. +The complexity is linear with *last1* - *first1* swaps performed. If elements from containers of the same type are being swapped, then the `swap` member function from that container should be used, because the member function typically has constant complexity. ### Example @@ -9922,7 +9922,7 @@ int main() cout << *v1_Iter1 << " "; cout << ")." << endl; - // Remove consecutive duplicates under the binary prediate mod_equals + // Remove consecutive duplicates under the binary predicate mod_equals v1_NewEnd2 = unique ( v1.begin( ), v1_NewEnd1 , mod_equal ); cout << "Removing adjacent duplicates from vector v1 under the\n " @@ -10078,7 +10078,7 @@ int main() { for ( iv = 0 ; iv <= 7 ; iv++ ) v1.push_back( 10 ); - // Remove consecutive duplicates under the binary prediate mod_equals + // Remove consecutive duplicates under the binary predicate mod_equals v1_NewEnd2 = unique_copy ( v1.begin( ), v1.begin( ) + 14, v1.begin( ) + 14 , mod_equal ); From 03ace2f09fd358b6e1f6c42867b7b8b6ee2a3d0a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 00:00:34 +0800 Subject: [PATCH 0840/1799] Clean up duplicate semicolons in `` functions reference --- docs/standard-library/algorithm-functions.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/standard-library/algorithm-functions.md b/docs/standard-library/algorithm-functions.md index 7e55579a809..3865864df02 100644 --- a/docs/standard-library/algorithm-functions.md +++ b/docs/standard-library/algorithm-functions.md @@ -2892,7 +2892,7 @@ int main() // Applying a user defined (UD) binary predicate mod_lesser inplace_merge ( v3.begin( ), break3, v3.end( ), mod_lesser ); cout << "Merged inplace with binary predicate mod_lesser specified,\n " - << "vector v3mod = ( " ; ; + << "vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != v3.end( ) ; Iter3++ ) cout << *Iter3 << " "; cout << ")" << endl; @@ -4424,7 +4424,7 @@ int main() { merge ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Merged inplace with binary predicate mod_lesser specified,\n " - << "vector v3mod = ( " ; ; + << "vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != v3.end( ) ; Iter3++ ) cout << *Iter3 << " "; cout << ")." << endl; @@ -8294,7 +8294,7 @@ int main() Result3 = set_difference ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Set_difference of source ranges with binary " - << "predicate mod_lesser specified,\n vector v3mod = ( " ; ; + << "predicate mod_lesser specified,\n vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != Result3 ; Iter3++ ) cout << *Iter3 << " "; cout << ")." << endl; @@ -8513,7 +8513,7 @@ int main() Result3 = set_intersection ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Intersection of source ranges with binary predicate " - << "mod_lesser specified,\n vector v3mod = ( " ; ; + << "mod_lesser specified,\n vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != Result3 ; ++Iter3 ) cout << *Iter3 << " "; cout << ")." << endl; @@ -8736,7 +8736,7 @@ int main() Result3 = set_symmetric_difference ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Set_symmetric_difference of source ranges with binary " - << "predicate mod_lesser specified,\n vector v3mod = ( " ; ; + << "predicate mod_lesser specified,\n vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != Result3 ; Iter3++ ) cout << *Iter3 << " "; cout << ")." << endl; @@ -8959,7 +8959,7 @@ int main() Result3 = set_union ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Union of source ranges with binary predicate " - << "mod_lesser specified,\n vector v3mod = ( " ; ; + << "mod_lesser specified,\n vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != Result3 ; Iter3++ ) cout << *Iter3 << " "; cout << ")." << endl; From 24da214979feee1f2b850c8d2cea7d661bf61750 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 00:03:56 +0800 Subject: [PATCH 0841/1799] Remove 1 double and trailing space in `` functions reference --- docs/standard-library/algorithm-functions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/algorithm-functions.md b/docs/standard-library/algorithm-functions.md index 3865864df02..976e06b9fac 100644 --- a/docs/standard-library/algorithm-functions.md +++ b/docs/standard-library/algorithm-functions.md @@ -2292,7 +2292,7 @@ public: } }; -// Utility to display the contents of a vector +// Utility to display the contents of a vector template void print_vector(const std::vector &vec) { std::cout << "( "; @@ -6660,7 +6660,7 @@ Vector v2 is a copy of v1 with the value 7 removed: ## `remove_copy_if` -Copies elements from a source range to a destination range, except for elements that satisfy a predicate. Elements are copied without disturbing the order of the remaining elements. Returns the end of a new destination range. +Copies elements from a source range to a destination range, except for elements that satisfy a predicate. Elements are copied without disturbing the order of the remaining elements. Returns the end of a new destination range. ```cpp template From 613193555701587060c76b4585aa69b44c166f55 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 00:06:27 +0800 Subject: [PATCH 0842/1799] Fix extraneous `>` in `mismatch` syntax in `` functions reference --- docs/standard-library/algorithm-functions.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/algorithm-functions.md b/docs/standard-library/algorithm-functions.md index 976e06b9fac..65b150d64e8 100644 --- a/docs/standard-library/algorithm-functions.md +++ b/docs/standard-library/algorithm-functions.md @@ -4949,13 +4949,14 @@ Use the dual-range overloads in C++14 code because the overloads that only take ```cpp template -pair> +pair mismatch( InputIterator1 first1, InputIterator1 last1, InputIterator2 first2 ); -template pair> +template +pair mismatch( InputIterator1 first1, InputIterator1 last1, @@ -4964,14 +4965,15 @@ mismatch( //C++14 template -pair> +pair mismatch( InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2 ); -template pair> +template +pair mismatch( InputIterator1 first1, InputIterator1 last1, From 5ad0e1443b6c5878198e9294ba159d90cec8940a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 21:27:47 +0800 Subject: [PATCH 0843/1799] Add blockquotes for error messages in range [C3381, C3420] --- docs/error-messages/compiler-errors-2/compiler-error-c3382.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3383.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3384.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3385.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3387.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3388.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3391.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3392.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3393.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3394.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3395.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3396.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3397.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3398.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3399.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3400.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3408.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3412.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3413.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3414.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3415.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3417.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3418.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3420.md | 2 +- 24 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md index e66b793fc50..77340032716 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md @@ -8,7 +8,7 @@ ms.assetid: a7603abd-ac4e-4ae6-a02b-3bdc6d1908a6 --- # Compiler Error C3382 -'sizeof' is not supported with /clr:safe +> 'sizeof' is not supported with /clr:safe The output file of a **/clr:safe** compilation is a file that is verifiably type safe, and sizeof is not supported because the return value of the sizeof operator is size_t, whose size varies depending on the operating system. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md index 2c45ba4d14d..5d9e6c20f42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md @@ -8,7 +8,7 @@ ms.assetid: ceb7f725-f417-4dc3-8496-0f413bb76687 --- # Compiler Error C3383 -'operator new' is not supported with /clr:safe +> 'operator new' is not supported with /clr:safe The output file of a **/clr:safe** compilation is a file that is verifiably type safe, and pointers are not supported. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md index 29c4ae7a09f..f238ba68f8b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md @@ -8,7 +8,7 @@ ms.assetid: c9f92c6a-62a9-4333-b2b1-bc55c7f288b6 --- # Compiler Error C3384 -'type_parameter' : the value constraint and the ref constraint are mutually exclusive +> 'type_parameter' : the value constraint and the ref constraint are mutually exclusive You cannot constrain a generic type to both **`value class`** and **`ref class`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md index 84eb77cee46..a1c23f46074 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md @@ -8,7 +8,7 @@ ms.assetid: 5f1838c1-986e-47db-8dbc-e06976b83cf3 --- # Compiler Error C3385 -'class::function' : a function that has a DllImport Custom attribute cannot return an instance of a class +> 'class::function' : a function that has a DllImport Custom attribute cannot return an instance of a class A function defined as being in a .dll file specified with the `DllImport` attribute cannot return an instance of a class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md index e4ebc2bbf6b..999506120a7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md @@ -8,7 +8,7 @@ ms.assetid: c54d9925-ed14-4976-b8db-e8d4dc84e536 --- # Compiler Error C3387 -'member' : __declspec(dllexport)/\__declspec(dllimport) cannot be applied to a member of a managed or WinRT type +> 'member' : __declspec(dllexport)/\__declspec(dllimport) cannot be applied to a member of a managed or WinRT type The `dllimport` and [dllexport](../../cpp/dllexport-dllimport.md) **`__declspec`** modifiers are not valid on members of a managed or Windows Runtime type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md index 570db2843a3..d89ffdec8ad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md @@ -8,7 +8,7 @@ ms.assetid: 34336545-ed13-4d81-ab5f-f869799fe4c2 --- # Compiler Error C3388 -'type' : not allowed as a constraint, assuming 'ref class' to continue parsing +> 'type' : not allowed as a constraint, assuming 'ref class' to continue parsing A constraint was specified on a generic type, but the constraint was not specified correctly. See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md index 6960f3ffb04..fd5e5bd1d01 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md @@ -8,7 +8,7 @@ ms.assetid: c32532b9-7db4-4ccd-84b9-479e5a1a19d1 --- # Compiler Error C3391 -'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must be a non-nullable value type +> 'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must be a non-nullable value type A generic type was instantiated incorrectly. Check the type definition. For more information, see and [Generics](../../extensions/generics-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md index 79b2f3c2bb8..05f14ea67bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md @@ -8,7 +8,7 @@ ms.assetid: e4757596-e2aa-4314-b01e-5c4bfd2110e9 --- # Compiler Error C3392 -'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must have a public parameterless constructor +> 'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must have a public parameterless constructor A generic type was instantiated incorrectly. Check the type definition. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md index f302d672a06..d8e7782d2af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md @@ -8,7 +8,7 @@ ms.assetid: d57f7c69-0a02-4fe3-9e45-bc62644fd77c --- # Compiler Error C3393 -syntax error in constraint clause: 'identifier' is not a type +> syntax error in constraint clause: 'identifier' is not a type The identifier passed to a constraint, which must be a type, was not a type. For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md index 8586236b83c..61b7eac8d1a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md @@ -8,7 +8,7 @@ ms.assetid: 4e025d79-27ba-43c8-b0d9-839ecef98126 --- # Compiler Error C3394 -syntax error in constraint clause: found 'identifier' expected a type +> syntax error in constraint clause: found 'identifier' expected a type A constraint was ill formed. For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md index 932858dc94a..b89c15d59b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md @@ -8,7 +8,7 @@ ms.assetid: 26a9ebc9-ed97-47ce-b436-19aa2bcf6e50 --- # Compiler Error C3395 -'function' : __declspec(dllexport) cannot be applied to a function with the \__clrcall calling convention +> 'function' : __declspec(dllexport) cannot be applied to a function with the \__clrcall calling convention `__declspec(dllexport)` and [__clrcall](../../cpp/clrcall.md) are not compatible. For more information, see [dllexport, dllimport](../../cpp/dllexport-dllimport.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3396.md b/docs/error-messages/compiler-errors-2/compiler-error-c3396.md index 3d79f79eec6..33e7f9be5ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3396.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3396.md @@ -8,6 +8,6 @@ ms.assetid: e3580e32-72ec-4c3e-8afa-755603ffd25c --- # Compiler Error C3396 -'attribute' : custom attribute not found in 'namespace' +> 'attribute' : custom attribute not found in 'namespace' C3396 indicates that you are not using an up-to-date common language runtime. Reinstall your CLR to resolve. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md index 92b7b3b5ae7..92c44cc0626 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md @@ -8,7 +8,7 @@ ms.assetid: a8536e87-79c4-4ed7-bd96-42704d06391f --- # Compiler Error C3397 -Aggregate initialization is not allowed in default arguments +> Aggregate initialization is not allowed in default arguments An array was declared incorrectly. See [Arrays](../../extensions/arrays-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3398.md b/docs/error-messages/compiler-errors-2/compiler-error-c3398.md index 27441e24516..d4b864746a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3398.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3398.md @@ -8,7 +8,7 @@ ms.assetid: 26f8c8a4-526f-415b-8047-155c5cd4f180 --- # Compiler Error C3398 -'operator' : cannot convert from 'function_signature' to 'function_pointer'. Source expression must be a function symbol +> 'operator' : cannot convert from 'function_signature' to 'function_pointer'. Source expression must be a function symbol When the [__clrcall](../../cpp/clrcall.md) calling convention is not specified when compiling with **/clr**, the compiler generates two entry points (addresses) for each function, a native entry point and a managed entry point. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md index 55794507286..f530c7bb534 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md @@ -8,7 +8,7 @@ ms.assetid: 306ad199-d150-4f6c-bcf1-24a7948b93be --- # Compiler Error C3399 -'type' : cannot provide arguments when creating an instance of a generic parameter +> 'type' : cannot provide arguments when creating an instance of a generic parameter When you specify the `gcnew()` constraint, you specify that the constraint type will have a parameterless constructor. Therefore, it is an error to attempt to instantiate that type and pass a parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md index df57d95cb79..1d879b477d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md @@ -8,7 +8,7 @@ ms.assetid: d44169a8-73b6-4766-b406-b3a6c93f2a4d --- # Compiler Error C3400 -circular constraint dependency involving 'constraint_1' and 'constraint_2' +> circular constraint dependency involving 'constraint_1' and 'constraint_2' The compiler detected circular constraints. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md index 9774072606f..ba913331ff7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md @@ -8,7 +8,7 @@ ms.assetid: 1f5ea979-fb1e-4214-b310-6fd6ca8249b1 --- # Compiler Error C3408 -'attribute': attribute is not allowed on template definitions +> 'attribute': attribute is not allowed on template definitions Attributes cannot be applied to template definitions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md index f9aab8f46cd..a6b4decc28f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md @@ -8,7 +8,7 @@ ms.assetid: aa4dd43b-54ce-4cda-85c1-1a77dd6e34fa --- # Compiler Error C3412 -'template' : cannot specialize template in current scope +> 'template' : cannot specialize template in current scope A template cannot be specialized at class scope, only in global or namespace scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md index 6e569181037..b3c03f35591 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md @@ -8,7 +8,7 @@ ms.assetid: de6c9b05-c373-4bd8-8cb0-12c2cd2e5674 --- # Compiler Error C3413 -'name' : invalid explicit instantiation +> 'name' : invalid explicit instantiation The compiler detected an ill-formed explicit instantiation. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md index 44d295535b0..8f870b8d2cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md @@ -8,7 +8,7 @@ ms.assetid: 715f5432-b509-4f8f-84f5-e1463bac490f --- # Compiler Error C3414 -'member' : imported member function can't be defined +> 'member' : imported member function can't be defined A member was defined in code that is also defined in a referenced assembly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md index afda211990f..8d19338043f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md @@ -8,7 +8,7 @@ ms.assetid: fa2db8ab-2820-4ec3-a740-fb5e2adcfb29 --- # Compiler Error C3415 -multiple 'section_name' sections found with different attributes ('value') +> multiple 'section_name' sections found with different attributes ('value') Conflicting values were specified in [section](../../preprocessor/section.md) pragmas. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md index debcd0ffbc3..16b22f1419b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md @@ -8,7 +8,7 @@ ms.assetid: 3e7869ea-8948-42fb-ba30-6ccafe499c35 --- # Compiler Error C3417 -'member' : value types cannot contain user-defined special member functions +> 'member' : value types cannot contain user-defined special member functions Value types cannot contain functions such as a default instance constructor, destructor, or copy constructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md index e49e934d0bd..de25e7f0fd3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md @@ -8,7 +8,7 @@ ms.assetid: 54042c04-3c45-41c1-bad7-90f9ee05a21b --- # Compiler Error C3418 -access specifier 'specifier' is not supported +> access specifier 'specifier' is not supported A CLR access specifier was specified incorrectly. For more information, see Type visibility and Member visibility in [How to: Define and Consume Classes and Structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md index da90a0cbaa3..a97422f5d51 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md @@ -8,7 +8,7 @@ ms.assetid: 99b53c77-f36b-4574-9199-b53111becccb --- # Compiler Error C3420 -'finalizer' : a finalizer cannot be virtual +> 'finalizer' : a finalizer cannot be virtual A finalizer can only be called non-virtually from its enclosing type. Therefore, it is an error to declare a virtual finalizer. From f828f78f33d7d3da18bf3cc0cbb737206ce0eae6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 21:35:11 +0800 Subject: [PATCH 0844/1799] Add "Remarks" and "Example" headings for error references in range [C3381, C3420] --- docs/error-messages/compiler-errors-2/compiler-error-c3381.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3382.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3383.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3384.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3385.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3386.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3387.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3388.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3390.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3391.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3392.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3393.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3394.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3395.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3396.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3397.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3398.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3399.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3400.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3408.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3412.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3413.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3414.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3415.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3417.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3418.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3420.md | 2 ++ 27 files changed, 71 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3381.md b/docs/error-messages/compiler-errors-2/compiler-error-c3381.md index 36a5ded5ce2..3aabeabd31c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3381.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3381.md @@ -10,10 +10,10 @@ ms.assetid: d276c89f-8377-4cb6-a8d4-7770885f06c4 > '*identifier*' : assembly access specifiers are only available in code compiled with a /clr option -A type was declared or defined by using an access specifier, which is only permitted in code compiled by using **`/clr`**. - ## Remarks +A type was declared or defined by using an access specifier, which is only permitted in code compiled by using **`/clr`**. + This error may result from a misplaced **`public`**, **`protected`**, or **`private`** keyword, or a missing colon (**`:`**) after an access specifier within a **`class`** or **`struct`**. In C++/CLI, native types can be visible outside an assembly, but you can only specify assembly access for native types in a **`/clr`** compilation. For more information, see [Type visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Type_visibility) and [`/clr` (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md index 77340032716..fd12e1a459e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md @@ -10,6 +10,8 @@ ms.assetid: a7603abd-ac4e-4ae6-a02b-3bdc6d1908a6 > 'sizeof' is not supported with /clr:safe +## Remarks + The output file of a **/clr:safe** compilation is a file that is verifiably type safe, and sizeof is not supported because the return value of the sizeof operator is size_t, whose size varies depending on the operating system. For more information, see, diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md index 5d9e6c20f42..0559212a52d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md @@ -10,6 +10,8 @@ ms.assetid: ceb7f725-f417-4dc3-8496-0f413bb76687 > 'operator new' is not supported with /clr:safe +## Remarks + The output file of a **/clr:safe** compilation is a file that is verifiably type safe, and pointers are not supported. For more information, see, diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md index f238ba68f8b..10dae7bfb4c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md @@ -10,6 +10,8 @@ ms.assetid: c9f92c6a-62a9-4333-b2b1-bc55c7f288b6 > 'type_parameter' : the value constraint and the ref constraint are mutually exclusive +## Remarks + You cannot constrain a generic type to both **`value class`** and **`ref class`**. See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md index a1c23f46074..59ee623bcd0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md @@ -10,8 +10,12 @@ ms.assetid: 5f1838c1-986e-47db-8dbc-e06976b83cf3 > 'class::function' : a function that has a DllImport Custom attribute cannot return an instance of a class +## Remarks + A function defined as being in a .dll file specified with the `DllImport` attribute cannot return an instance of a class. +## Example + The following sample generates C3385: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3386.md b/docs/error-messages/compiler-errors-2/compiler-error-c3386.md index 0c91775a21d..925064727be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3386.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3386.md @@ -10,8 +10,12 @@ ms.assetid: 93fa8c33-0f10-402b-8eec-b0a217a1f8dc > '*type-name*' : `__declspec(dllexport)`/`__declspec(dllimport)` cannot be applied to a managed or WinRT type +## Remarks + The [`dllimport`](../../cpp/dllexport-dllimport.md) and [`dllexport`](../../cpp/dllexport-dllimport.md) **`__declspec`** modifiers aren't valid on a managed or Windows Runtime type. +## Example + The following sample generates C3386 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md index 999506120a7..b4c910db1a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md @@ -10,8 +10,12 @@ ms.assetid: c54d9925-ed14-4976-b8db-e8d4dc84e536 > 'member' : __declspec(dllexport)/\__declspec(dllimport) cannot be applied to a member of a managed or WinRT type +## Remarks + The `dllimport` and [dllexport](../../cpp/dllexport-dllimport.md) **`__declspec`** modifiers are not valid on members of a managed or Windows Runtime type. +## Example + The following sample generates C3387 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md index d89ffdec8ad..cc986a43c7e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md @@ -10,6 +10,8 @@ ms.assetid: 34336545-ed13-4d81-ab5f-f869799fe4c2 > 'type' : not allowed as a constraint, assuming 'ref class' to continue parsing +## Remarks + A constraint was specified on a generic type, but the constraint was not specified correctly. See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3390.md b/docs/error-messages/compiler-errors-2/compiler-error-c3390.md index ecd8d608dd0..2190730d109 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3390.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3390.md @@ -10,10 +10,10 @@ ms.assetid: 84800a87-c8e6-45aa-82ae-02f816dc8d97 > '*type_arg*' : invalid type argument for generic parameter '*param*' of generic '*generic_type*', must be a reference type -A generic type was instantiated incorrectly. Check the type definition. - ## Remarks +A generic type was instantiated incorrectly. Check the type definition. + For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md index fd5e5bd1d01..995a5b7aed1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md @@ -10,6 +10,8 @@ ms.assetid: c32532b9-7db4-4ccd-84b9-479e5a1a19d1 > 'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must be a non-nullable value type +## Remarks + A generic type was instantiated incorrectly. Check the type definition. For more information, see and [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md index 05f14ea67bd..1dccca4f5b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md @@ -10,6 +10,8 @@ ms.assetid: e4757596-e2aa-4314-b01e-5c4bfd2110e9 > 'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must have a public parameterless constructor +## Remarks + A generic type was instantiated incorrectly. Check the type definition. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md index d8e7782d2af..2243f8d790f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md @@ -10,6 +10,8 @@ ms.assetid: d57f7c69-0a02-4fe3-9e45-bc62644fd77c > syntax error in constraint clause: 'identifier' is not a type +## Remarks + The identifier passed to a constraint, which must be a type, was not a type. For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md index 61b7eac8d1a..90ffd5989fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md @@ -10,6 +10,8 @@ ms.assetid: 4e025d79-27ba-43c8-b0d9-839ecef98126 > syntax error in constraint clause: found 'identifier' expected a type +## Remarks + A constraint was ill formed. For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md index b89c15d59b4..514d3795f69 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md @@ -10,8 +10,12 @@ ms.assetid: 26a9ebc9-ed97-47ce-b436-19aa2bcf6e50 > 'function' : __declspec(dllexport) cannot be applied to a function with the \__clrcall calling convention +## Remarks + `__declspec(dllexport)` and [__clrcall](../../cpp/clrcall.md) are not compatible. For more information, see [dllexport, dllimport](../../cpp/dllexport-dllimport.md). +## Example + The following sample generates C3395: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3396.md b/docs/error-messages/compiler-errors-2/compiler-error-c3396.md index 33e7f9be5ce..f248a3b7854 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3396.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3396.md @@ -10,4 +10,6 @@ ms.assetid: e3580e32-72ec-4c3e-8afa-755603ffd25c > 'attribute' : custom attribute not found in 'namespace' +## Remarks + C3396 indicates that you are not using an up-to-date common language runtime. Reinstall your CLR to resolve. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md index 92c44cc0626..18796c7621d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md @@ -10,6 +10,8 @@ ms.assetid: a8536e87-79c4-4ed7-bd96-42704d06391f > Aggregate initialization is not allowed in default arguments +## Remarks + An array was declared incorrectly. See [Arrays](../../extensions/arrays-cpp-component-extensions.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3398.md b/docs/error-messages/compiler-errors-2/compiler-error-c3398.md index d4b864746a0..86dc04476c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3398.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3398.md @@ -10,6 +10,8 @@ ms.assetid: 26f8c8a4-526f-415b-8047-155c5cd4f180 > 'operator' : cannot convert from 'function_signature' to 'function_pointer'. Source expression must be a function symbol +## Remarks + When the [__clrcall](../../cpp/clrcall.md) calling convention is not specified when compiling with **/clr**, the compiler generates two entry points (addresses) for each function, a native entry point and a managed entry point. By default the compiler returns the native entry point, but there are some cases where the managed entry point is desired (for instance when assigning the address to a `__clrcall` function pointer). In order for the compiler to reliably choose the managed entry point in an assignment, the right hand side must be a function symbol. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md index f530c7bb534..78ff65b7a53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md @@ -10,6 +10,8 @@ ms.assetid: 306ad199-d150-4f6c-bcf1-24a7948b93be > 'type' : cannot provide arguments when creating an instance of a generic parameter +## Remarks + When you specify the `gcnew()` constraint, you specify that the constraint type will have a parameterless constructor. Therefore, it is an error to attempt to instantiate that type and pass a parameter. See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md index 1d879b477d2..7aad309d34e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md @@ -10,6 +10,8 @@ ms.assetid: d44169a8-73b6-4766-b406-b3a6c93f2a4d > circular constraint dependency involving 'constraint_1' and 'constraint_2' +## Remarks + The compiler detected circular constraints. For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md index ba913331ff7..cb0da0efa57 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md @@ -10,6 +10,8 @@ ms.assetid: 1f5ea979-fb1e-4214-b310-6fd6ca8249b1 > 'attribute': attribute is not allowed on template definitions +## Remarks + Attributes cannot be applied to template definitions. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md index a6b4decc28f..83df2e75689 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md @@ -10,9 +10,11 @@ ms.assetid: aa4dd43b-54ce-4cda-85c1-1a77dd6e34fa > 'template' : cannot specialize template in current scope +## Remarks + A template cannot be specialized at class scope, only in global or namespace scope. -## Examples +## Example The following sample generates C3412. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md index b3c03f35591..69f0965d252 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md @@ -10,8 +10,12 @@ ms.assetid: de6c9b05-c373-4bd8-8cb0-12c2cd2e5674 > 'name' : invalid explicit instantiation +## Remarks + The compiler detected an ill-formed explicit instantiation. +## Example + The following sample generates C3413: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md index 8f870b8d2cd..a2624afaf3c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md @@ -10,8 +10,12 @@ ms.assetid: 715f5432-b509-4f8f-84f5-e1463bac490f > 'member' : imported member function can't be defined +## Remarks + A member was defined in code that is also defined in a referenced assembly. +## Example + The following sample generates C3414: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md index 8d19338043f..f7cd1bd8638 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md @@ -10,6 +10,8 @@ ms.assetid: fa2db8ab-2820-4ec3-a740-fb5e2adcfb29 > multiple 'section_name' sections found with different attributes ('value') +## Remarks + Conflicting values were specified in [section](../../preprocessor/section.md) pragmas. `value` is the current setting for the section, as specified in ntimage.h. For example: @@ -33,6 +35,8 @@ Conflicting values were specified in [section](../../preprocessor/section.md) pr #define IMAGE_SCN_MEM_WRITE 0x80000000 ``` +## Example + The following sample generates C3415: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md index 16b22f1419b..42d6417a654 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md @@ -10,8 +10,12 @@ ms.assetid: 3e7869ea-8948-42fb-ba30-6ccafe499c35 > 'member' : value types cannot contain user-defined special member functions +## Remarks + Value types cannot contain functions such as a default instance constructor, destructor, or copy constructor. +## Example + The following sample generates C3517: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md index de25e7f0fd3..1faf84dd45f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md @@ -10,6 +10,8 @@ ms.assetid: 54042c04-3c45-41c1-bad7-90f9ee05a21b > access specifier 'specifier' is not supported +## Remarks + A CLR access specifier was specified incorrectly. For more information, see Type visibility and Member visibility in [How to: Define and Consume Classes and Structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md index a97422f5d51..439e38bd34c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md @@ -10,6 +10,8 @@ ms.assetid: 99b53c77-f36b-4574-9199-b53111becccb > 'finalizer' : a finalizer cannot be virtual +## Remarks + A finalizer can only be called non-virtually from its enclosing type. Therefore, it is an error to declare a virtual finalizer. For more information, see [Destructors and finalizers in How to: Define and consume classes and structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). From a79f52212727faddf87462dcbf2d6f63ae8c319c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 21:43:29 +0800 Subject: [PATCH 0845/1799] Replace term "sample" with "example" for error references in range [C3381, C3420] --- docs/error-messages/compiler-errors-2/compiler-error-c3381.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3382.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3383.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3384.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3385.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3386.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3387.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3388.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3389.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3390.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3391.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3392.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3393.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3394.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3395.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3397.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3399.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3400.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3408.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3412.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3413.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3414.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3415.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3417.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3418.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3420.md | 2 +- 26 files changed, 30 insertions(+), 30 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3381.md b/docs/error-messages/compiler-errors-2/compiler-error-c3381.md index 3aabeabd31c..b21357ca9b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3381.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3381.md @@ -20,7 +20,7 @@ In C++/CLI, native types can be visible outside an assembly, but you can only sp ## Example -The following sample generates C3381. To fix it, first either remove the **`public`** specifier from the `class A` definition, or compile by using the **`/clr`** option. Next, add a colon after **`private`** to specify access for `class B {} b;`. That's because a nested class can't have an assembly access specifier as part of its declaration. +The following example generates C3381. To fix it, first either remove the **`public`** specifier from the `class A` definition, or compile by using the **`/clr`** option. Next, add a colon after **`private`** to specify access for `class B {} b;`. That's because a nested class can't have an assembly access specifier as part of its declaration. ```cpp // C3381.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md index fd12e1a459e..667a0dc6a04 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md @@ -24,7 +24,7 @@ For more information, see, ## Example -The following sample generates C3382. +The following example generates C3382. ```cpp // C3382.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md index 0559212a52d..1cfde5a9bfe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md @@ -22,7 +22,7 @@ For more information, see, ## Example -The following sample generates C3383. +The following example generates C3383. ```cpp // C3383.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md index 10dae7bfb4c..71f60da426c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md @@ -18,7 +18,7 @@ See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constrai ## Example -The following sample generates C3384. +The following example generates C3384. ```cpp // C3384.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md index 59ee623bcd0..9ba07241af3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md @@ -16,7 +16,7 @@ A function defined as being in a .dll file specified with the `DllImport` attrib ## Example -The following sample generates C3385: +The following example generates C3385: ```cpp // C3385.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3386.md b/docs/error-messages/compiler-errors-2/compiler-error-c3386.md index 925064727be..9dd83b1cca5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3386.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3386.md @@ -16,7 +16,7 @@ The [`dllimport`](../../cpp/dllexport-dllimport.md) and [`dllexport`](../../cpp/ ## Example -The following sample generates C3386 and shows how to fix it: +The following example generates C3386 and shows how to fix it: ```cpp // C3386.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md index b4c910db1a4..3cdd54bb955 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md @@ -16,7 +16,7 @@ The `dllimport` and [dllexport](../../cpp/dllexport-dllimport.md) **`__declspec` ## Example -The following sample generates C3387 and shows how to fix it: +The following example generates C3387 and shows how to fix it: ```cpp // C3387a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md index cc986a43c7e..b4583819443 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md @@ -16,7 +16,7 @@ A constraint was specified on a generic type, but the constraint was not specifi ## Example -The following sample generates C3388. +The following example generates C3388. ```cpp // C3388.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3389.md b/docs/error-messages/compiler-errors-2/compiler-error-c3389.md index 01353be5e88..2f64dbb570c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3389.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3389.md @@ -18,7 +18,7 @@ A [`__declspec`](../../cpp/declspec.md) modifier used implies a per-process stat ## Example -The following sample generates C3389: +The following example generates C3389: ```cpp // C3389.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3390.md b/docs/error-messages/compiler-errors-2/compiler-error-c3390.md index 2190730d109..b861798d3ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3390.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3390.md @@ -18,7 +18,7 @@ For more information, see [Generics](../../extensions/generics-cpp-component-ext ## Example -The first sample uses C# to create a component that contains a generic type. This type has certain constraints that aren't supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). +The first example uses C# to create a component that contains a generic type. This type has certain constraints that aren't supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). ```csharp // C3390.cs @@ -30,7 +30,7 @@ where V : struct where N : new() {} ``` -When the C3390.dll component is available, the following sample generates C3390. +When the C3390.dll component is available, the following example generates C3390. ```cpp // C3390_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md index 995a5b7aed1..53de5acbc98 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md @@ -16,7 +16,7 @@ A generic type was instantiated incorrectly. Check the type definition. For more ## Example -The following sample uses C# to create a component that contains a generic type that has certain constraints that are not supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). +The following example uses C# to create a component that contains a generic type that has certain constraints that are not supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). ```csharp // C3391.cs @@ -26,7 +26,7 @@ public class GR where N : struct {} ``` -When the C3391.dll component is available, the following sample generates C3391. +When the C3391.dll component is available, the following example generates C3391. ```cpp // C3391_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md index 1dccca4f5b6..5b1dc6976c2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md @@ -16,7 +16,7 @@ A generic type was instantiated incorrectly. Check the type definition. For more ## Example -The following sample uses C# to create a component that contains a generic type that has certain constraints that are not supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). +The following example uses C# to create a component that contains a generic type that has certain constraints that are not supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). ```csharp // C3392.cs @@ -28,7 +28,7 @@ where V : struct where N : new() {} ``` -When the C3392.dll component is available, the following sample generates C3392. +When the C3392.dll component is available, the following example generates C3392. ```cpp // C3392_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md index 2243f8d790f..86b5047aa27 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md @@ -16,7 +16,7 @@ The identifier passed to a constraint, which must be a type, was not a type. Fo ## Example -The following sample generates C3393: +The following example generates C3393: ```cpp // C3393.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md index 90ffd5989fc..82aeacc6e68 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md @@ -16,7 +16,7 @@ A constraint was ill formed. For more information, see [Constraints on Generic ## Example -The following sample generates C3394: +The following example generates C3394: ```cpp // C3394.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md index 514d3795f69..32d7404f7b1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md @@ -16,7 +16,7 @@ ms.assetid: 26a9ebc9-ed97-47ce-b436-19aa2bcf6e50 ## Example -The following sample generates C3395: +The following example generates C3395: ```cpp // C3395.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md index 18796c7621d..96acca19de8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md @@ -16,7 +16,7 @@ An array was declared incorrectly. See [Arrays](../../extensions/arrays-cpp-com ## Example -The following sample generates C3397. +The following example generates C3397. ```cpp // C3397.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md index 78ff65b7a53..82d6757e9d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md @@ -18,7 +18,7 @@ See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constrai ## Example -The following sample generates C3399. +The following example generates C3399. ```cpp // C3399.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md index 7aad309d34e..92b40d2ecc8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md @@ -18,7 +18,7 @@ For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../ ## Example -The following sample generates C3400. +The following example generates C3400. ```cpp // C3400.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md index cb0da0efa57..8412fed5648 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md @@ -16,7 +16,7 @@ Attributes cannot be applied to template definitions. ## Example -The following sample generates C3408. +The following example generates C3408. ```cpp // C3408.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md index 83df2e75689..a3b19072766 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md @@ -16,7 +16,7 @@ A template cannot be specialized at class scope, only in global or namespace sco ## Example -The following sample generates C3412. +The following example generates C3412. ```cpp // C3412.cpp @@ -27,7 +27,7 @@ struct S { }; ``` -The following sample shows a possible resolution. +The following example shows a possible resolution. ```cpp // C3412b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md index 69f0965d252..458096ac137 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md @@ -16,7 +16,7 @@ The compiler detected an ill-formed explicit instantiation. ## Example -The following sample generates C3413: +The following example generates C3413: ```cpp // C3413.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md index a2624afaf3c..beb045df417 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md @@ -16,7 +16,7 @@ A member was defined in code that is also defined in a referenced assembly. ## Example -The following sample generates C3414: +The following example generates C3414: ```cpp // C3414a2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md index f7cd1bd8638..a5b7b1d444f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md @@ -37,7 +37,7 @@ Conflicting values were specified in [section](../../preprocessor/section.md) pr ## Example -The following sample generates C3415: +The following example generates C3415: ```cpp // C3415.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md index 42d6417a654..4c0d18694ee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md @@ -16,7 +16,7 @@ Value types cannot contain functions such as a default instance constructor, des ## Example -The following sample generates C3517: +The following example generates C3517: ```cpp // C3417.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md index 1faf84dd45f..68d5aff8173 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md @@ -16,7 +16,7 @@ A CLR access specifier was specified incorrectly. For more information, see Typ ## Example -The following sample generates C3418. +The following example generates C3418. ```cpp // C3418.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md index 439e38bd34c..01ff84f0407 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md @@ -18,7 +18,7 @@ For more information, see [Destructors and finalizers in How to: Define and cons ## Example -The following sample generates C3420. +The following example generates C3420. ```cpp // C3420.cpp From 80d3fdac0f26247ba36d978718a452a3234bf30d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 21:48:26 +0800 Subject: [PATCH 0846/1799] Update metadata for error references in range [C3381, C3420] --- .../error-messages/compiler-errors-2/compiler-error-c3381.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c3382.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3383.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3384.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3385.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3386.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3387.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3388.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3389.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3390.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c3391.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3392.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3393.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3394.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3395.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3396.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3397.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3398.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3399.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3400.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3408.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3409.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3412.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3413.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3414.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3415.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3417.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3418.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3420.md | 5 ++--- 29 files changed, 54 insertions(+), 83 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3381.md b/docs/error-messages/compiler-errors-2/compiler-error-c3381.md index b21357ca9b9..913b50fe2cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3381.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3381.md @@ -4,7 +4,6 @@ description: "Microsoft C++ compiler error C3381, its causes and how to resolve ms.date: 09/28/2020 f1_keywords: ["C3381"] helpviewer_keywords: ["C3381"] -ms.assetid: d276c89f-8377-4cb6-a8d4-7770885f06c4 --- # Compiler Error C3381 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md index 667a0dc6a04..1314e1265cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3382" title: "Compiler Error C3382" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3382" +ms.date: 11/04/2016 f1_keywords: ["C3382"] helpviewer_keywords: ["C3382"] -ms.assetid: a7603abd-ac4e-4ae6-a02b-3bdc6d1908a6 --- # Compiler Error C3382 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md index 1cfde5a9bfe..1a7f753626c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3383" title: "Compiler Error C3383" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3383" +ms.date: 11/04/2016 f1_keywords: ["C3383"] helpviewer_keywords: ["C3383"] -ms.assetid: ceb7f725-f417-4dc3-8496-0f413bb76687 --- # Compiler Error C3383 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md index 71f60da426c..b9652439d74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3384" title: "Compiler Error C3384" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3384" +ms.date: 11/04/2016 f1_keywords: ["C3384"] helpviewer_keywords: ["C3384"] -ms.assetid: c9f92c6a-62a9-4333-b2b1-bc55c7f288b6 --- # Compiler Error C3384 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md index 9ba07241af3..4bdd233dd9a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3385" title: "Compiler Error C3385" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3385" +ms.date: 11/04/2016 f1_keywords: ["C3385"] helpviewer_keywords: ["C3385"] -ms.assetid: 5f1838c1-986e-47db-8dbc-e06976b83cf3 --- # Compiler Error C3385 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3386.md b/docs/error-messages/compiler-errors-2/compiler-error-c3386.md index 9dd83b1cca5..b6e8bef3bad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3386.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3386.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3386" title: "Compiler Error C3386" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3386" +ms.date: 11/04/2016 f1_keywords: ["C3386"] helpviewer_keywords: ["C3386"] -ms.assetid: 93fa8c33-0f10-402b-8eec-b0a217a1f8dc --- # Compiler Error C3386 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md index 3cdd54bb955..1aa8d110eef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3387" title: "Compiler Error C3387" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3387" +ms.date: 11/04/2016 f1_keywords: ["C3387"] helpviewer_keywords: ["C3387"] -ms.assetid: c54d9925-ed14-4976-b8db-e8d4dc84e536 --- # Compiler Error C3387 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md index b4583819443..1b69e8c4669 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3388" title: "Compiler Error C3388" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3388" +ms.date: 11/04/2016 f1_keywords: ["C3388"] helpviewer_keywords: ["C3388"] -ms.assetid: 34336545-ed13-4d81-ab5f-f869799fe4c2 --- # Compiler Error C3388 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3389.md b/docs/error-messages/compiler-errors-2/compiler-error-c3389.md index 2f64dbb570c..4f662925f08 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3389.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3389.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3389" title: "Compiler Error C3389" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3389" +ms.date: 11/04/2016 f1_keywords: ["C3389"] helpviewer_keywords: ["C3389"] -ms.assetid: eaaffe17-23f2-413c-b1ad-f7220cfa1334 --- # Compiler Error C3389 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3390.md b/docs/error-messages/compiler-errors-2/compiler-error-c3390.md index b861798d3ce..ff243fdbd3e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3390.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3390.md @@ -4,7 +4,6 @@ description: "Microsoft C++ compiler error C3390, its causes and how to resolve ms.date: 09/26/2020 f1_keywords: ["C3390"] helpviewer_keywords: ["C3390"] -ms.assetid: 84800a87-c8e6-45aa-82ae-02f816dc8d97 --- # Compiler Error C3390 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md index 53de5acbc98..32d4d18f191 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3391" title: "Compiler Error C3391" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3391" +ms.date: 11/04/2016 f1_keywords: ["C3391"] helpviewer_keywords: ["C3391"] -ms.assetid: c32532b9-7db4-4ccd-84b9-479e5a1a19d1 --- # Compiler Error C3391 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md index 5b1dc6976c2..57b89416bf3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3392" title: "Compiler Error C3392" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3392" +ms.date: 11/04/2016 f1_keywords: ["C3392"] helpviewer_keywords: ["C3392"] -ms.assetid: e4757596-e2aa-4314-b01e-5c4bfd2110e9 --- # Compiler Error C3392 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md index 86b5047aa27..82ca666acc1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3393" title: "Compiler Error C3393" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3393" +ms.date: 11/04/2016 f1_keywords: ["C3393"] helpviewer_keywords: ["C3393"] -ms.assetid: d57f7c69-0a02-4fe3-9e45-bc62644fd77c --- # Compiler Error C3393 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md index 82aeacc6e68..a2866af1438 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3394" title: "Compiler Error C3394" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3394" +ms.date: 11/04/2016 f1_keywords: ["C3394"] helpviewer_keywords: ["C3394"] -ms.assetid: 4e025d79-27ba-43c8-b0d9-839ecef98126 --- # Compiler Error C3394 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md index 32d7404f7b1..5c14e3a6380 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3395" title: "Compiler Error C3395" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3395" +ms.date: 11/04/2016 f1_keywords: ["C3395"] helpviewer_keywords: ["C3395"] -ms.assetid: 26a9ebc9-ed97-47ce-b436-19aa2bcf6e50 --- # Compiler Error C3395 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3396.md b/docs/error-messages/compiler-errors-2/compiler-error-c3396.md index f248a3b7854..958845bb38e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3396.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3396.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3396" title: "Compiler Error C3396" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3396" +ms.date: 11/04/2016 f1_keywords: ["C3396"] helpviewer_keywords: ["C3396"] -ms.assetid: e3580e32-72ec-4c3e-8afa-755603ffd25c --- # Compiler Error C3396 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md index 96acca19de8..62ff9b28448 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3397" title: "Compiler Error C3397" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3397" +ms.date: 11/04/2016 f1_keywords: ["C3397"] helpviewer_keywords: ["C3397"] -ms.assetid: a8536e87-79c4-4ed7-bd96-42704d06391f --- # Compiler Error C3397 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3398.md b/docs/error-messages/compiler-errors-2/compiler-error-c3398.md index 86dc04476c4..12e80fd4613 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3398.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3398.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3398" title: "Compiler Error C3398" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3398" +ms.date: 11/04/2016 f1_keywords: ["C3398"] helpviewer_keywords: ["C3398"] -ms.assetid: 26f8c8a4-526f-415b-8047-155c5cd4f180 --- # Compiler Error C3398 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md index 82d6757e9d7..dd6950693e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3399" title: "Compiler Error C3399" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3399" +ms.date: 11/04/2016 f1_keywords: ["C3399"] helpviewer_keywords: ["C3399"] -ms.assetid: 306ad199-d150-4f6c-bcf1-24a7948b93be --- # Compiler Error C3399 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md index 92b40d2ecc8..68f42cc0a03 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3400" title: "Compiler Error C3400" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3400" +ms.date: 11/04/2016 f1_keywords: ["C3400"] helpviewer_keywords: ["C3400"] -ms.assetid: d44169a8-73b6-4766-b406-b3a6c93f2a4d --- # Compiler Error C3400 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md index 8412fed5648..b0239c3bd19 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3408" title: "Compiler Error C3408" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3408" +ms.date: 11/04/2016 f1_keywords: ["C3408"] helpviewer_keywords: ["C3408"] -ms.assetid: 1f5ea979-fb1e-4214-b310-6fd6ca8249b1 --- # Compiler Error C3408 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3409.md b/docs/error-messages/compiler-errors-2/compiler-error-c3409.md index 393e09c5d88..6603ef05435 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3409.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3409.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3409" title: "Compiler Error C3409" -ms.date: "11/06/2018" +description: "Learn more about: Compiler Error C3409" +ms.date: 11/06/2018 f1_keywords: ["C3409"] helpviewer_keywords: ["C3409"] -ms.assetid: e372d9fa-230c-4b28-b6d3-6ad81ccf9dbb --- # Compiler Error C3409 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md index a3b19072766..5209a9eca05 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3412" title: "Compiler Error C3412" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3412" +ms.date: 11/04/2016 f1_keywords: ["C3412"] helpviewer_keywords: ["C3412"] -ms.assetid: aa4dd43b-54ce-4cda-85c1-1a77dd6e34fa --- # Compiler Error C3412 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md index 458096ac137..d5c4e89b153 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3413" title: "Compiler Error C3413" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3413" +ms.date: 11/04/2016 f1_keywords: ["C3413"] helpviewer_keywords: ["C3413"] -ms.assetid: de6c9b05-c373-4bd8-8cb0-12c2cd2e5674 --- # Compiler Error C3413 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md index beb045df417..5ff2d2b3ae5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3414" title: "Compiler Error C3414" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3414" +ms.date: 11/04/2016 f1_keywords: ["C3414"] helpviewer_keywords: ["C3414"] -ms.assetid: 715f5432-b509-4f8f-84f5-e1463bac490f --- # Compiler Error C3414 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md index a5b7b1d444f..30450c07d51 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3415" title: "Compiler Error C3415" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3415" +ms.date: 11/04/2016 f1_keywords: ["C3415"] helpviewer_keywords: ["C3415"] -ms.assetid: fa2db8ab-2820-4ec3-a740-fb5e2adcfb29 --- # Compiler Error C3415 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md index 4c0d18694ee..6be953cb0e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3417" title: "Compiler Error C3417" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3417" +ms.date: 11/04/2016 f1_keywords: ["C3417"] helpviewer_keywords: ["C3417"] -ms.assetid: 3e7869ea-8948-42fb-ba30-6ccafe499c35 --- # Compiler Error C3417 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md index 68d5aff8173..2d7e3ab6a67 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3418" title: "Compiler Error C3418" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3418" +ms.date: 11/04/2016 f1_keywords: ["C3418"] helpviewer_keywords: ["C3418"] -ms.assetid: 54042c04-3c45-41c1-bad7-90f9ee05a21b --- # Compiler Error C3418 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md index 01ff84f0407..5ae784e3d77 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3420" title: "Compiler Error C3420" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3420" +ms.date: 11/04/2016 f1_keywords: ["C3420"] helpviewer_keywords: ["C3420"] -ms.assetid: 99b53c77-f36b-4574-9199-b53111becccb --- # Compiler Error C3420 From d39c2aa7f9a4fba62936d46ec6a98724f4c9b535 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 22:41:03 +0800 Subject: [PATCH 0847/1799] Add backtick in "Tutorial: Import the C++ standard library using modules from the command line" --- docs/cpp/tutorial-import-stl-named-module.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/tutorial-import-stl-named-module.md b/docs/cpp/tutorial-import-stl-named-module.md index b2c961353f2..67894b421ec 100644 --- a/docs/cpp/tutorial-import-stl-named-module.md +++ b/docs/cpp/tutorial-import-stl-named-module.md @@ -77,7 +77,7 @@ The statement `import std;` or `import std.compat;` imports the standard library |---|---| | [`/std:c++:latest`](../build/reference/std-specify-language-standard-version.md) | Use the latest version of the C++ language standard and library. Although module support is available under `/std:c++20`, you need the latest standard library to get support for standard library named modules. | | [`/EHsc`](../build/reference/eh-exception-handling-model.md) | Use C++ exception handling, except for functions marked `extern "C"`. | - | [`/W4`](../build/reference//compiler-option-warning-level.md) | Using /W4 is generally recommended, especially for new projects because it enables all level 1, level 2, level 3, and most level 4 (informational) warnings, which can help you catch potential issues early. It essentially provides lint-like warnings that can help ensure the fewest possible hard-to-find code defects. | + | [`/W4`](../build/reference//compiler-option-warning-level.md) | Using `/W4` is generally recommended, especially for new projects because it enables all level 1, level 2, level 3, and most level 4 (informational) warnings, which can help you catch potential issues early. It essentially provides lint-like warnings that can help ensure the fewest possible hard-to-find code defects. | | [`/c`](../build/reference/c-compile-without-linking.md) | Compile without linking, because we're just building the binary named module interface at this point. | You can control the object file name and the named module interface file name with the following switches: From 21fcb64157e3a5a571ab48a468dc3aa1826773d5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 22:50:24 +0800 Subject: [PATCH 0848/1799] Fix typos and tweak wording in "Tutorial: Import the C++ standard library using modules from the command line" --- docs/cpp/tutorial-import-stl-named-module.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/cpp/tutorial-import-stl-named-module.md b/docs/cpp/tutorial-import-stl-named-module.md index 67894b421ec..eab7cb403a8 100644 --- a/docs/cpp/tutorial-import-stl-named-module.md +++ b/docs/cpp/tutorial-import-stl-named-module.md @@ -26,7 +26,7 @@ This tutorial requires Visual Studio 2022 17.5 or later. Header file semantics can change depending on macro definitions, the order in which you include them, and they slow compilation. Modules solve these problems. -It's now possible to import the standard library as a module instead of as a tangle of header files. This is much faster and more robust than including header files or header units or precompiled headers (PCH). +It's now possible to import the standard library as a module instead of as a tangle of header files. This is much faster and more robust than including header files, header units, or precompiled headers (PCH). The C++23 standard library introduces two named modules: `std` and `std.compat`: @@ -75,7 +75,7 @@ The statement `import std;` or `import std.compat;` imports the standard library | Switch | Meaning | |---|---| - | [`/std:c++:latest`](../build/reference/std-specify-language-standard-version.md) | Use the latest version of the C++ language standard and library. Although module support is available under `/std:c++20`, you need the latest standard library to get support for standard library named modules. | + | [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) | Use the latest version of the C++ language standard and library. Although module support is available under `/std:c++20`, you need the latest standard library to get support for standard library named modules. | | [`/EHsc`](../build/reference/eh-exception-handling-model.md) | Use C++ exception handling, except for functions marked `extern "C"`. | | [`/W4`](../build/reference//compiler-option-warning-level.md) | Using `/W4` is generally recommended, especially for new projects because it enables all level 1, level 2, level 3, and most level 4 (informational) warnings, which can help you catch potential issues early. It essentially provides lint-like warnings that can help ensure the fewest possible hard-to-find code defects. | | [`/c`](../build/reference/c-compile-without-linking.md) | Compile without linking, because we're just building the binary named module interface at this point. | @@ -159,7 +159,7 @@ Before you can use `import std.compat;` you must compile the module interface fi - `std.compat.obj` contains implementation. However, most of the implementation is provided by `std.obj`. Add `std.obj` to the command line when you compile the sample app to statically link the functionality that you use from the standard library into your application. You can control the object file name and the named module interface file name with the following switches: - - [`/Fo`](../build/reference/fo-object-file-name.md) sets the name of the object file. For example, `/Fo:"somethingelse"`. By default, the compiler uses the same name for the object file as the module source file (`.ixx`) you're compiling. In the example, the object file names are `std.obj` and `std.compat.obj` by default because we're compiling the module files `std.ixx` and `std.compat.obj`. + - [`/Fo`](../build/reference/fo-object-file-name.md) sets the name of the object file. For example, `/Fo:"somethingelse"`. By default, the compiler uses the same name for the object file as the module source file (`.ixx`) you're compiling. In the example, the object file names are `std.obj` and `std.compat.obj` by default because we're compiling the module files `std.ixx` and `std.compat.ixx`. - [`/ifcOutput`](../build/reference/ifc-output.md) sets the name of the named module interface file (`.ifc`). For example, `/ifcOutput "somethingelse.ifc"`. By default, the compiler uses the same name for the module interface file (`.ifc`) as the module source file (`.ixx`) you're compiling. In the example, the generated `ifc` files are `std.ifc` and `std.compat.ifc` by default because we're compiling the module files `std.ixx` and `std.compat.ixx`. 1. Import the `std.compat` library by first creating a file named `stdCompatExample.cpp` with the following content: @@ -210,7 +210,7 @@ Before you can use `import std.compat;` you must compile the module interface fi ## Standard library named module considerations -Versioning for named modules is the same as for headers. The `.ixx` named module files are installed alongside the headers, for example: `"%VCToolsInstallDir%\modules\std.ixx`, which resolves to `C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.38.33130\modules\std.ixx` in the version of the tools used at the time of this writing. Select the version of the named module the same way you choose the version of the header file to use--by the directory you refer to them from. +Versioning for named modules is the same as for headers. The `.ixx` named module files are installed alongside the headers, for example: `"%VCToolsInstallDir%\modules\std.ixx"`, which resolves to `C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.38.33130\modules\std.ixx` in the version of the tools used at the time of this writing. Select the version of the named module the same way you choose the version of the header file to use--by the directory you refer to them from. Don't mix and match importing header units and named modules. For example, don't `import ;` and `import std;` in the same file. @@ -222,7 +222,7 @@ If you need to use the `assert()` macro, then `#include `. If you need to use the `errno` macro, `#include `. Because named modules don't expose macros, this is the workaround if you need to check for errors from ``, for example. -Macros such as `NAN`, `INFINITY`, and `INT_MIN` are defined by ``, which you can include. However, if you `import std;` you can use `numeric_limits::quiet_NaN()` and `numeric_limits::infinity()` instead of `NAN` and `INFINITY`, and `std::numeric_limits::min()` instead of `INT_MIN`. +Macros such as `NAN`, `INFINITY`, and `INT_MIN` are defined by ``, which you can include. However, if you `import std;` you can use `std::numeric_limits::quiet_NaN()` and `std::numeric_limits::infinity()` instead of `NAN` and `INFINITY`, and `std::numeric_limits::min()` instead of `INT_MIN`. ## Summary From 750161025eb595ebe9731810856b98bc7877ca04 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 22:52:58 +0800 Subject: [PATCH 0849/1799] Clean up links in "Tutorial: Import the C++ standard library using modules from the command line" --- docs/cpp/tutorial-import-stl-named-module.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/cpp/tutorial-import-stl-named-module.md b/docs/cpp/tutorial-import-stl-named-module.md index eab7cb403a8..7e665eb5bc7 100644 --- a/docs/cpp/tutorial-import-stl-named-module.md +++ b/docs/cpp/tutorial-import-stl-named-module.md @@ -49,7 +49,7 @@ This article demonstrates the new and best way to consume the standard library. ## Import the standard library with `std` -The following examples demonstrate how to consume the standard library as a module using the command line compiler. For information about how to do this in the Visual Studio IDE, see [Build ISO C++23 Standard Library Modules](..\build\reference\c-cpp-prop-page.md#build-iso-c23-standard-library-modules). +The following examples demonstrate how to consume the standard library as a module using the command line compiler. For information about how to do this in the Visual Studio IDE, see [Build ISO C++23 Standard Library Modules](../build/reference/c-cpp-prop-page.md#build-iso-c23-standard-library-modules). The statement `import std;` or `import std.compat;` imports the standard library into your application. But first, you must compile the standard library named modules into binary form. The following steps demonstrate how. @@ -77,7 +77,7 @@ The statement `import std;` or `import std.compat;` imports the standard library |---|---| | [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) | Use the latest version of the C++ language standard and library. Although module support is available under `/std:c++20`, you need the latest standard library to get support for standard library named modules. | | [`/EHsc`](../build/reference/eh-exception-handling-model.md) | Use C++ exception handling, except for functions marked `extern "C"`. | - | [`/W4`](../build/reference//compiler-option-warning-level.md) | Using `/W4` is generally recommended, especially for new projects because it enables all level 1, level 2, level 3, and most level 4 (informational) warnings, which can help you catch potential issues early. It essentially provides lint-like warnings that can help ensure the fewest possible hard-to-find code defects. | + | [`/W4`](../build/reference/compiler-option-warning-level.md) | Using `/W4` is generally recommended, especially for new projects because it enables all level 1, level 2, level 3, and most level 4 (informational) warnings, which can help you catch potential issues early. It essentially provides lint-like warnings that can help ensure the fewest possible hard-to-find code defects. | | [`/c`](../build/reference/c-compile-without-linking.md) | Compile without linking, because we're just building the binary named module interface at this point. | You can control the object file name and the named module interface file name with the following switches: From 0dc46705a879c62635860206a5d3a15c217c9f14 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 22:54:10 +0800 Subject: [PATCH 0850/1799] Elide duplicate "modules [C++]" `helpviewer_keywords` in "Tutorial: Import the C++ standard library using modules from the command line" --- docs/cpp/tutorial-import-stl-named-module.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/tutorial-import-stl-named-module.md b/docs/cpp/tutorial-import-stl-named-module.md index 7e665eb5bc7..ea8e886d277 100644 --- a/docs/cpp/tutorial-import-stl-named-module.md +++ b/docs/cpp/tutorial-import-stl-named-module.md @@ -4,7 +4,7 @@ ms.date: 01/29/2024 ms.topic: "tutorial" author: "tylermsft" ms.author: "twhitney" -helpviewer_keywords: ["modules [C++]", "modules [C++]", "named modules [C++], import standard library (STL) using named modules"] +helpviewer_keywords: ["modules [C++]", "named modules [C++], import standard library (STL) using named modules"] description: Learn how to import the C++ standard library (STL) using modules from the command line --- From 120b7b402a0836142940d78aa24ed723cd638abd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 22:54:41 +0800 Subject: [PATCH 0851/1799] Update metadata in "Tutorial: Import the C++ standard library using modules from the command line" --- docs/cpp/tutorial-import-stl-named-module.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/tutorial-import-stl-named-module.md b/docs/cpp/tutorial-import-stl-named-module.md index ea8e886d277..f90f02c7ff7 100644 --- a/docs/cpp/tutorial-import-stl-named-module.md +++ b/docs/cpp/tutorial-import-stl-named-module.md @@ -1,11 +1,11 @@ --- title: "Tutorial: Import the standard library (STL) using modules from the command line (C++)" +description: "Learn how to import the C++ standard library (STL) using modules from the command line" ms.date: 01/29/2024 ms.topic: "tutorial" author: "tylermsft" ms.author: "twhitney" helpviewer_keywords: ["modules [C++]", "named modules [C++], import standard library (STL) using named modules"] -description: Learn how to import the C++ standard library (STL) using modules from the command line --- # Tutorial: Import the C++ standard library using modules from the command line From 8d12f9b4b071226e11057154f13ce7b1c2f92d26 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 23:09:44 +0800 Subject: [PATCH 0852/1799] Clean up more empty "Remarks" headings --- docs/build/reference/help-compiler-command-line-help.md | 2 -- .../build/reference/nologo-suppress-startup-banner-c-cpp.md | 2 -- docs/c-runtime-library/cxxframehandler.md | 2 -- docs/c-runtime-library/internal-set-app-type.md | 2 -- docs/c-runtime-library/reference/uncaught-exception.md | 2 -- docs/c-runtime-library/setusermatherr.md | 2 -- docs/cppcx/platform-arrayreference-class.md | 2 -- docs/cppcx/platform-metadata-flagsattribute-attribute.md | 2 -- docs/cppcx/platform-stringreference-class.md | 6 ------ docs/parallel/concrt/reference/event-class.md | 2 -- 10 files changed, 24 deletions(-) diff --git a/docs/build/reference/help-compiler-command-line-help.md b/docs/build/reference/help-compiler-command-line-help.md index 8b03e638c82..7c30a3193cf 100644 --- a/docs/build/reference/help-compiler-command-line-help.md +++ b/docs/build/reference/help-compiler-command-line-help.md @@ -18,8 +18,6 @@ Displays a listing of compiler options to standard output. /? ``` -## Remarks - ### To set this compiler option in the Visual Studio development environment - This compiler option should only be accessed from the command line. diff --git a/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md b/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md index df6bf589671..493f51b6edb 100644 --- a/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md +++ b/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md @@ -16,8 +16,6 @@ Suppresses the display of the copyright banner when the compiler starts up and d /nologo ``` -## Remarks - ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). diff --git a/docs/c-runtime-library/cxxframehandler.md b/docs/c-runtime-library/cxxframehandler.md index 67d417b3f1c..6d430789f00 100644 --- a/docs/c-runtime-library/cxxframehandler.md +++ b/docs/c-runtime-library/cxxframehandler.md @@ -43,8 +43,6 @@ Additional information about the function entry and stack frame. One of the *filter expression* values used by the [try-except Statement](../cpp/try-except-statement.md). -## Remarks - ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/internal-set-app-type.md b/docs/c-runtime-library/internal-set-app-type.md index 9faaf4a49e3..286d8a41e39 100644 --- a/docs/c-runtime-library/internal-set-app-type.md +++ b/docs/c-runtime-library/internal-set-app-type.md @@ -33,8 +33,6 @@ A value that indicates the application type. The possible values are: | `_CONSOLE_APP` | Console (command-line) application. | | `_GUI_APP` | GUI (Windows) application. | -## Remarks - ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/reference/uncaught-exception.md b/docs/c-runtime-library/reference/uncaught-exception.md index 52c7a6c349b..7c560840fe4 100644 --- a/docs/c-runtime-library/reference/uncaught-exception.md +++ b/docs/c-runtime-library/reference/uncaught-exception.md @@ -24,8 +24,6 @@ bool __uncaught_exception(); **`true`** from the time an exception is thrown in a **`try`** block until the matching **`catch`** block is initialized; otherwise, **`false`**. -## Remarks - ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/setusermatherr.md b/docs/c-runtime-library/setusermatherr.md index 16a9bc0757f..8cdb716815f 100644 --- a/docs/c-runtime-library/setusermatherr.md +++ b/docs/c-runtime-library/setusermatherr.md @@ -29,8 +29,6 @@ Pointer to an implementation of `_matherr` that is supplied by the user. The type of the *`pf`* parameter is declared as `typedef int (__cdecl * _HANDLE_MATH_ERROR)(struct _exception *)`. -## Remarks - ## Requirements | Routine | Required header | diff --git a/docs/cppcx/platform-arrayreference-class.md b/docs/cppcx/platform-arrayreference-class.md index 4441c41afba..86f17861e57 100644 --- a/docs/cppcx/platform-arrayreference-class.md +++ b/docs/cppcx/platform-arrayreference-class.md @@ -70,8 +70,6 @@ The number of elements in the source array. *otherArg*
An `ArrayReference` object whose data will be moved to initialize the new instance. -### Remarks - ## ArrayReference::operator= Operator Assigns the specified object to the current [Platform::ArrayReference](../cppcx/platform-arrayreference-class.md) object by using move semantics. diff --git a/docs/cppcx/platform-metadata-flagsattribute-attribute.md b/docs/cppcx/platform-metadata-flagsattribute-attribute.md index b3f435aa5ad..b37eaadcc39 100644 --- a/docs/cppcx/platform-metadata-flagsattribute-attribute.md +++ b/docs/cppcx/platform-metadata-flagsattribute-attribute.md @@ -23,8 +23,6 @@ public ref class Flags abstract : Attribute [Platform::Metadata::Attribute](../cppcx/platform-metadata-attribute-attribute.md) -### Remarks - ### Requirements **Minimum supported client:** Windows 8 diff --git a/docs/cppcx/platform-stringreference-class.md b/docs/cppcx/platform-stringreference-class.md index 0ca0b227d9b..ca8ef3bcf09 100644 --- a/docs/cppcx/platform-stringreference-class.md +++ b/docs/cppcx/platform-stringreference-class.md @@ -15,8 +15,6 @@ An optimization type that you can use to pass string data from `Platform::String class StringReference ``` -### Remarks - ### Members ### Public Constructors @@ -79,8 +77,6 @@ __abi_HSTRING GetHSTRING() const; An `__abi_HSTRING` that contains the string data. -### Remarks - ## StringReference::GetString Method Returns the contents of the string as a `Platform::String^`. @@ -110,8 +106,6 @@ unsigned int Length() const; An unsigned integer that specifies the number of characters in the string. -### Remarks - ## StringReference::operator= Operator Assigns the specified object to the current `StringReference` object. diff --git a/docs/parallel/concrt/reference/event-class.md b/docs/parallel/concrt/reference/event-class.md index 699ecf71814..5e54b099272 100644 --- a/docs/parallel/concrt/reference/event-class.md +++ b/docs/parallel/concrt/reference/event-class.md @@ -61,8 +61,6 @@ Constructs a new event. _CRTIMP event(); ``` -### Remarks - ## ~event Destroys an event. From fb459ef06653d4cc47cd09b6b6abef9974a9b08d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 23:12:43 +0800 Subject: [PATCH 0853/1799] Update metadata in 9 topics --- docs/build/reference/help-compiler-command-line-help.md | 5 ++--- docs/build/reference/nologo-suppress-startup-banner-c-cpp.md | 5 ++--- docs/c-runtime-library/cxxframehandler.md | 5 ++--- docs/c-runtime-library/internal-set-app-type.md | 5 ++--- docs/c-runtime-library/reference/uncaught-exception.md | 5 ++--- docs/c-runtime-library/setusermatherr.md | 5 ++--- docs/cppcx/platform-arrayreference-class.md | 5 ++--- docs/cppcx/platform-metadata-flagsattribute-attribute.md | 5 ++--- docs/parallel/concrt/reference/event-class.md | 5 ++--- 9 files changed, 18 insertions(+), 27 deletions(-) diff --git a/docs/build/reference/help-compiler-command-line-help.md b/docs/build/reference/help-compiler-command-line-help.md index 7c30a3193cf..673fc125b1b 100644 --- a/docs/build/reference/help-compiler-command-line-help.md +++ b/docs/build/reference/help-compiler-command-line-help.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /HELP (Compiler Command-Line Help)" title: "/HELP (Compiler Command-Line Help)" -ms.date: "11/04/2016" +description: "Learn more about: /HELP (Compiler Command-Line Help)" +ms.date: 11/04/2016 f1_keywords: ["/help"] helpviewer_keywords: ["HELP compiler option [C++]", "Help, for compiler command line", "/HELP compiler option [C++]", "/? compiler option [C++]", "-HELP compiler option [C++]", "-? compiler option [C++]", "cl.exe compiler, command-line syntax"] -ms.assetid: 192533e7-86f2-48e0-a08f-b5e4e3a4e784 --- # /HELP (Compiler Command-Line Help) diff --git a/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md b/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md index 493f51b6edb..d4dce169d76 100644 --- a/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md +++ b/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /nologo (Suppress Startup Banner) (C/C++)" title: "/nologo (Suppress Startup Banner) (C/C++)" -ms.date: "11/04/2016" +description: "Learn more about: /nologo (Suppress Startup Banner) (C/C++)" +ms.date: 11/04/2016 f1_keywords: ["VC.Project.VCCLWCECompilerTool.SuppressStartupBanner", "VC.Project.VCCLCompilerTool.SuppressStartupBanner"] helpviewer_keywords: ["-nologo compiler option [C++]", "/nologo compiler option [C++]", "nologo compiler option [C++]", "banners, suppressing startup"] -ms.assetid: 75930d8b-b11c-4db8-99e5-b52f97da0693 --- # /nologo (Suppress Startup Banner) (C/C++) diff --git a/docs/c-runtime-library/cxxframehandler.md b/docs/c-runtime-library/cxxframehandler.md index 6d430789f00..7883ff1adac 100644 --- a/docs/c-runtime-library/cxxframehandler.md +++ b/docs/c-runtime-library/cxxframehandler.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: __CxxFrameHandler" title: "__CxxFrameHandler" -ms.date: "1/14/2021" +description: "Learn more about: __CxxFrameHandler" +ms.date: 1/14/2021 api_name: ["__CxxFrameHandler"] api_location: ["msvcr110.dll", "msvcrt.dll", "msvcr80.dll", "msvcr100.dll", "msvcr110_clr0400.dll", "msvcr90.dll", "msvcr120.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["__CxxFrameHandler"] helpviewer_keywords: ["__CxxFrameHandler"] -ms.assetid: b79ac97f-425a-42ae-9b91-8beaef935333 --- # `__CxxFrameHandler` diff --git a/docs/c-runtime-library/internal-set-app-type.md b/docs/c-runtime-library/internal-set-app-type.md index 286d8a41e39..bdf12cb0d35 100644 --- a/docs/c-runtime-library/internal-set-app-type.md +++ b/docs/c-runtime-library/internal-set-app-type.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: __set_app_type" title: "__set_app_type" -ms.date: "11/04/2016" +description: "Learn more about: __set_app_type" +ms.date: 11/04/2016 api_name: ["__set_app_type", "_set_app_type"] api_location: ["msvcr90.dll", "msvcr100.dll", "msvcr110.dll", "msvcr80.dll", "msvcrt.dll", "msvcr120.dll", "msvcr110_clr0400.dll", "api-ms-win-crt-runtime-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["__set_app_type"] helpviewer_keywords: ["__set_app_type"] -ms.assetid: f0ac0f4d-70e6-4e96-9e43-eb9d1515490c --- # `__set_app_type` diff --git a/docs/c-runtime-library/reference/uncaught-exception.md b/docs/c-runtime-library/reference/uncaught-exception.md index 7c560840fe4..9cb0108509d 100644 --- a/docs/c-runtime-library/reference/uncaught-exception.md +++ b/docs/c-runtime-library/reference/uncaught-exception.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: __uncaught_exception" title: "__uncaught_exception" -ms.date: "1/14/2021" +description: "Learn more about: __uncaught_exception" +ms.date: 1/14/2021 api_name: ["__uncaught_exception"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["EH/__uncaught_exception"] helpviewer_keywords: ["__uncaught_exception"] -ms.assetid: 4d9b75c6-c9c7-4876-b761-ea9ab1925e96 --- # `__uncaught_exception` diff --git a/docs/c-runtime-library/setusermatherr.md b/docs/c-runtime-library/setusermatherr.md index 8cdb716815f..b63946d98ec 100644 --- a/docs/c-runtime-library/setusermatherr.md +++ b/docs/c-runtime-library/setusermatherr.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: __setusermatherr" title: "__setusermatherr" -ms.date: "11/04/2016" +description: "Learn more about: __setusermatherr" +ms.date: 11/04/2016 api_name: ["__setusermatherr"] api_location: ["msvcr80.dll", "msvcr90.dll", "msvcrt.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr100.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["__setusermatherr"] helpviewer_keywords: ["__setusermatherr"] -ms.assetid: f306818d-381a-4d68-8739-71b92bacb5ea --- # `__setusermatherr` diff --git a/docs/cppcx/platform-arrayreference-class.md b/docs/cppcx/platform-arrayreference-class.md index 86f17861e57..7925842befc 100644 --- a/docs/cppcx/platform-arrayreference-class.md +++ b/docs/cppcx/platform-arrayreference-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::ArrayReference Class" title: "Platform::ArrayReference Class" -ms.date: "10/16/2019" +description: "Learn more about: Platform::ArrayReference Class" +ms.date: 10/16/2019 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::ArrayReference::ArrayReference"] helpviewer_keywords: ["Platform::ArrayReference Class"] -ms.assetid: 9ab3b15e-8a60-4600-8fcb-7d6c86284f4b --- # Platform::ArrayReference Class diff --git a/docs/cppcx/platform-metadata-flagsattribute-attribute.md b/docs/cppcx/platform-metadata-flagsattribute-attribute.md index b37eaadcc39..ec334277811 100644 --- a/docs/cppcx/platform-metadata-flagsattribute-attribute.md +++ b/docs/cppcx/platform-metadata-flagsattribute-attribute.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::Metadata::FlagsAttribute Attribute" title: "Platform::Metadata::FlagsAttribute Attribute" -ms.date: "12/30/2016" +description: "Learn more about: Platform::Metadata::FlagsAttribute Attribute" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::Metadata::FlagsAttribute"] helpviewer_keywords: ["Platform::Metadata::FlagsAttribute Attribute"] -ms.assetid: 56f4a191-cc81-4742-aff8-bd2219c0735c --- # Platform::Metadata::FlagsAttribute Attribute diff --git a/docs/parallel/concrt/reference/event-class.md b/docs/parallel/concrt/reference/event-class.md index 5e54b099272..0be9869316a 100644 --- a/docs/parallel/concrt/reference/event-class.md +++ b/docs/parallel/concrt/reference/event-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: event Class" title: "event Class" -ms.date: "11/04/2016" +description: "Learn more about: event Class" +ms.date: 11/04/2016 f1_keywords: ["CONCRT/concurrency::event", "CONCRT/concurrency::event::reset", "CONCRT/concurrency::event::set", "CONCRT/concurrency::event::wait", "CONCRT/concurrency::event::wait_for_multiple", "CONCRT/concurrency::event::timeout_infinite"] helpviewer_keywords: ["event class"] -ms.assetid: fba35a53-6568-4bfa-9aaf-07c0928cf73d --- # event Class From 9b148297b02e0924b942cd9e85234114a0fded7f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 23:31:14 +0800 Subject: [PATCH 0854/1799] Add blockquotes for error messages in range [C3421, C3480] --- docs/error-messages/compiler-errors-2/compiler-error-c3421.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3446.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3450.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3451.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3452.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3453.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3454.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3455.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3456.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3457.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3458.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3459.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3460.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3461.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3462.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3463.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3464.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3465.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3466.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3467.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3468.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3469.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3470.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3480.md | 2 +- 24 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md index f80f790e6b6..e20123508d9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md @@ -8,7 +8,7 @@ ms.assetid: b52050c6-17a4-424a-8894-337b0cec7010 --- # Compiler Error C3421 -'type' : you cannot call the finalizer for this class as it is either inaccessible or it does not exist +> 'type' : you cannot call the finalizer for this class as it is either inaccessible or it does not exist A finalizer is implicitly private, so it cannot be called from outside its enclosing type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md index 0a6ae8b11ee..d8d09f1ec60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md @@ -8,7 +8,7 @@ ms.assetid: 33064548-24e4-46f1-beb1-476e3c3b3fbf --- # Compiler Error C3446 ->'*class*': a default member initializer is not allowed for a member of a value class +> '*class*': a default member initializer is not allowed for a member of a value class In Visual Studio 2015 and earlier, the compiler permitted (but ignored) a default member initializer for a member of a value class. Default initialization of a value class always zero-initializes the members; a default constructor is not permitted. In Visual Studio 2017, default member initializers raise a compiler error, as shown in this example: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md index ffdbc286a20..594dd016376 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md @@ -8,7 +8,7 @@ ms.assetid: 78892cf7-0b82-4589-90d0-e06666247003 --- # Compiler Error C3450 -'type': not an attribute; cannot specify [System::AttributeUsageAttribute] or [Windows::Foundation::Metadata::AttributeUsageAttribute] +> 'type': not an attribute; cannot specify [System::AttributeUsageAttribute] or [Windows::Foundation::Metadata::AttributeUsageAttribute] A user-defined managed attribute must inherit from . A Windows Runtime attribute must be defined in the `Windows::Foundation::Metadata` namespace. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3451.md b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md index 6e7e9dbe75e..e69f0fbcf79 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3451.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md @@ -8,7 +8,7 @@ ms.assetid: a4897a69-e3e7-40bb-bb1c-598644904012 --- # Compiler Error C3451 -'attribute': cannot apply unmanaged attribute to 'type' +> 'attribute': cannot apply unmanaged attribute to 'type' A C++ attribute cannot be applied to a CLR type. See [C++ Attributes Reference](../../windows/attributes/attributes-alphabetical-reference.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3452.md b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md index b40ab656fc2..68161f69e8c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3452.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md @@ -8,7 +8,7 @@ ms.assetid: e5293dcf-cb70-4133-ae2a-0bb496950ba0 --- # Compiler Error C3452 -list argument member not constant +> list argument member not constant An argument was passed to an attribute that expected a constant, a value that can be evaluated at compile time. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md index edd640d730a..f22bddca964 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md @@ -8,7 +8,7 @@ ms.assetid: dbefdbcf-f697-4239-b7a5-1d99b85e9e7f --- # Compiler Error C3453 -'attribute': attribute not applied because qualifier 'assembly' did not match +> 'attribute': attribute not applied because qualifier 'assembly' did not match Assembly or module level attributes can only be specified as stand-alone instructions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md index f051c32753f..5812da5a58a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md @@ -8,7 +8,7 @@ ms.assetid: dc4e6d57-5b4d-4114-8d6f-22f9ae62925b --- # Compiler Error C3454 -[attribute] not allowed on class declaration +> [attribute] not allowed on class declaration A class must be defined for it to be an attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md index f32ad44b44c..55e237683c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md @@ -8,7 +8,7 @@ ms.assetid: 218e5cfe-5391-4eeb-81c2-85c47e3a6cd2 --- # Compiler Error C3455 -'attribute': none of the attribute constructors matched the arguments +> 'attribute': none of the attribute constructors matched the arguments An invalid value was used to declare an attribute. See [attribute](../../windows/attributes/attribute.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3456.md b/docs/error-messages/compiler-errors-2/compiler-error-c3456.md index 73d326827fd..613e6e3d74d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3456.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3456.md @@ -8,7 +8,7 @@ ms.assetid: 9f781919-aaf2-4725-94a4-44a0b80cc64a --- # Compiler Error C3456 -[source_annotation_attribute] not allowed on managed or WinRT class declaration +> [source_annotation_attribute] not allowed on managed or WinRT class declaration source_annotation_attribute is used to define custom attributes to be used by code analysis. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md index 4b97bea6db5..2c35ac62ecb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3457"] --- # Compiler Error C3457 -'attribute': attribute does not support unnamed arguments +> 'attribute': attribute does not support unnamed arguments Source annotation attributes, unlike CLR custom attribute or compiler attributes, only support named arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md index 345783c0e18..582fbd665bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md @@ -8,7 +8,7 @@ ms.assetid: 940202fd-8dcc-4042-9c96-3f9e9127d2f1 --- # Compiler Error C3458 -'attribute1': attribute 'attribute2' already specified for 'construct' +> 'attribute1': attribute 'attribute2' already specified for 'construct' Two attributes that are mutually exclusive were specified for the same construct. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md index 98298a38e28..ede887604c2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md @@ -8,7 +8,7 @@ ms.assetid: 3d290a20-d313-4c07-9bd8-c5c159cb169f --- # Compiler Error C3459 -'attribute': attribute allowed only on class indexer (default indexed property) +> 'attribute': attribute allowed only on class indexer (default indexed property) An attribute that is designed to be applied to a class indexer property was used incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md index 58c67af4f7f..4cda0e3dd32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md @@ -8,7 +8,7 @@ ms.assetid: adbf8775-10ca-4654-acdf-58dd765351cd --- # Compiler Error C3460 -'type': only a user-defined type can be forwarded +> 'type': only a user-defined type can be forwarded For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md index 4c45c0a6eac..8da9d17dda1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md @@ -8,7 +8,7 @@ ms.assetid: bd66833a-545d-445a-bdfe-dee771a450a4 --- # Compiler Error C3461 -'type': only a managed type can be forwarded +> 'type': only a managed type can be forwarded Type forwarding can only occur on CLR types. See [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md index 1711df90e85..91ce5a45bda 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md @@ -8,7 +8,7 @@ ms.assetid: 56b75f35-9fad-42d9-a969-eeca5d709bec --- # Compiler Error C3462 -'type': only an imported type can be forwarded +> 'type': only an imported type can be forwarded The TypeForwardedTo attribute must be applied to a type in referenced metadata. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md index 96fbcf90c51..f209848268b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md @@ -8,7 +8,7 @@ ms.assetid: 153efcc0-085c-4615-84ea-d22942618bdf --- # Compiler Error C3463 -'type': type not allowed in attribute 'implements' +> 'type': type not allowed in attribute 'implements' An invalid type was passed to the [implements](../../windows/attributes/implements-cpp.md) attribute. For example, you can pass an interface to `implements`, but you cannot pass a pointer to an interface. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md index 4def91d2596..663e5dca049 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md @@ -8,7 +8,7 @@ ms.assetid: 0ede05dc-4486-4921-8e8c-78ab5a2e09c5 --- # Compiler Error C3464 -'type' a nested type cannot be forwarded +> 'type' a nested type cannot be forwarded Type forwarding does not work on nested types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md index 453ced5d660..8e0d41e10a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md @@ -8,7 +8,7 @@ ms.assetid: aeb815e5-b3fc-4525-afe2-d738e9321df1 --- # Compiler Error C3465 -to use type 'type' you must reference the assembly 'assembly' +> to use type 'type' you must reference the assembly 'assembly' Type forwarding will work for a client application until you recompile the client. When you recompile, you will need a reference for every assembly containing the definition of a type used in your client application. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md index 2f1b223aa91..faf02207e27 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md @@ -8,7 +8,7 @@ ms.assetid: 69a877d9-a749-474b-bfc3-8d3fd53ba8fd --- # Compiler Error C3466 -'type' : a specialization of a generic class cannot be forwarded +> 'type' : a specialization of a generic class cannot be forwarded You cannot use type forwarding on a specialization of a generic class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md index 05af0ad696d..ab6612626f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md @@ -8,7 +8,7 @@ ms.assetid: e2b844d0-4920-412f-99fd-cd8051c4aa41 --- # Compiler Error C3467 -'type' : this type has already been forwarded +> 'type' : this type has already been forwarded The compiler found more than one forward type declaration for the same type. Only one declaration per type is allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md index 62e82fd9136..be90bee5ab1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md @@ -8,7 +8,7 @@ ms.assetid: cfd320db-2f6e-4e0d-ba02-e79ece87e1e0 --- # Compiler Error C3468 -'type' : you can only forward a type to an assembly: +> 'type' : you can only forward a type to an assembly: '`file`' is not an assembly diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md index e45fb32a382..790b564a839 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md @@ -8,7 +8,7 @@ ms.assetid: e23b0e5c-c704-4e67-a868-bf02c2055d85 --- # Compiler Error C3469 -'type' : a generic class cannot be forwarded +> 'type' : a generic class cannot be forwarded You cannot use type forwarding on a generic class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md index a487c4e889b..758f0fd8adc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md @@ -8,7 +8,7 @@ ms.assetid: 170c7a9d-214d-41b1-8f15-d4a4fc38aaa5 --- # Compiler Error C3470 -'type' : a class cannot have both an indexer (default indexed property) and an operator[] +> 'type' : a class cannot have both an indexer (default indexed property) and an operator[] A type cannot define both a default indexer and an operator[]. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3480.md b/docs/error-messages/compiler-errors-2/compiler-error-c3480.md index 261faca8ab3..c970a90b76f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3480.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3480.md @@ -8,7 +8,7 @@ ms.assetid: 7b2e055a-9604-4d13-861b-b38bda1a6940 --- # Compiler Error C3480 -'var': a lambda capture variable must be from an enclosing function scope +> 'var': a lambda capture variable must be from an enclosing function scope The lambda capture variable is not from an enclosing function scope. From ce25a975f76d73363cf6e924a32666b9b9f35ab3 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 23:37:34 +0800 Subject: [PATCH 0855/1799] Add "Remarks" and "Example" headings for error references in range [C3421, C3480] --- docs/error-messages/compiler-errors-2/compiler-error-c3421.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3445.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3446.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3450.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3451.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3452.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3453.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3454.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3455.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3456.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3457.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3458.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3459.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3460.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3461.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3462.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3463.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3464.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3465.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3466.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3467.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3468.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3469.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3470.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3480.md | 4 +++- 25 files changed, 60 insertions(+), 10 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md index e20123508d9..af2fef64384 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md @@ -10,6 +10,8 @@ ms.assetid: b52050c6-17a4-424a-8894-337b0cec7010 > 'type' : you cannot call the finalizer for this class as it is either inaccessible or it does not exist +## Remarks + A finalizer is implicitly private, so it cannot be called from outside its enclosing type. For more information, see [Destructors and finalizers in How to: Define and consume classes and structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3445.md b/docs/error-messages/compiler-errors-2/compiler-error-c3445.md index 3fc2bcb631b..4628a74f9f5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3445.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3445.md @@ -10,6 +10,8 @@ ms.assetid: 0d272bfc-136b-4025-a9ba-5e4eea5f8215 > copy-list-initialization of '*type*' cannot use an explicit constructor +## Remarks + According to the ISO C++17 standard, the compiler is required to consider an explicit constructor for overload resolution in copy-list-initialization, but must raise an error if that overload is actually chosen. Starting in Visual Studio 2017, the compiler finds errors related to object creation by using an initializer list that were not found by Visual Studio 2015. These errors could lead to crashes or undefined behavior at runtime. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md index d8d09f1ec60..0b2121841b3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md @@ -10,6 +10,8 @@ ms.assetid: 33064548-24e4-46f1-beb1-476e3c3b3fbf > '*class*': a default member initializer is not allowed for a member of a value class +## Remarks + In Visual Studio 2015 and earlier, the compiler permitted (but ignored) a default member initializer for a member of a value class. Default initialization of a value class always zero-initializes the members; a default constructor is not permitted. In Visual Studio 2017, default member initializers raise a compiler error, as shown in this example: ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md index 594dd016376..ac97c365ed1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md @@ -10,6 +10,8 @@ ms.assetid: 78892cf7-0b82-4589-90d0-e06666247003 > 'type': not an attribute; cannot specify [System::AttributeUsageAttribute] or [Windows::Foundation::Metadata::AttributeUsageAttribute] +## Remarks + A user-defined managed attribute must inherit from . A Windows Runtime attribute must be defined in the `Windows::Foundation::Metadata` namespace. 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-c3451.md b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md index e69f0fbcf79..82133356255 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3451.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md @@ -10,6 +10,8 @@ ms.assetid: a4897a69-e3e7-40bb-bb1c-598644904012 > 'attribute': cannot apply unmanaged attribute to 'type' +## Remarks + A C++ attribute cannot be applied to a CLR type. See [C++ Attributes Reference](../../windows/attributes/attributes-alphabetical-reference.md) for more information. 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-c3452.md b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md index 68161f69e8c..fadee495aa2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3452.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md @@ -10,6 +10,8 @@ ms.assetid: e5293dcf-cb70-4133-ae2a-0bb496950ba0 > list argument member not constant +## Remarks + An argument was passed to an attribute that expected a constant, a value that can be evaluated at compile time. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md index f22bddca964..a63ec871554 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md @@ -10,6 +10,8 @@ ms.assetid: dbefdbcf-f697-4239-b7a5-1d99b85e9e7f > 'attribute': attribute not applied because qualifier 'assembly' did not match +## Remarks + Assembly or module level attributes can only be specified as stand-alone instructions. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md index 5812da5a58a..f32b69c58e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md @@ -10,6 +10,8 @@ ms.assetid: dc4e6d57-5b4d-4114-8d6f-22f9ae62925b > [attribute] not allowed on class declaration +## Remarks + A class must be defined for it to be an attribute. For more information, see [attribute](../../windows/attributes/attribute.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md index 55e237683c3..47c3ef98d16 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md @@ -10,6 +10,8 @@ ms.assetid: 218e5cfe-5391-4eeb-81c2-85c47e3a6cd2 > 'attribute': none of the attribute constructors matched the arguments +## Remarks + An invalid value was used to declare an attribute. See [attribute](../../windows/attributes/attribute.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3456.md b/docs/error-messages/compiler-errors-2/compiler-error-c3456.md index 613e6e3d74d..98b8c04eb83 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3456.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3456.md @@ -10,6 +10,8 @@ ms.assetid: 9f781919-aaf2-4725-94a4-44a0b80cc64a > [source_annotation_attribute] not allowed on managed or WinRT class declaration +## Remarks + source_annotation_attribute is used to define custom attributes to be used by code analysis. These custom attributes are only useful if there is a corresponding plugin that understands the attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md index 2c35ac62ecb..fbf417ec4cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C3457"] > 'attribute': attribute does not support unnamed arguments +## Remarks + Source annotation attributes, unlike CLR custom attribute or compiler attributes, only support named arguments. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md index 582fbd665bc..4af142f2f4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md @@ -10,6 +10,8 @@ ms.assetid: 940202fd-8dcc-4042-9c96-3f9e9127d2f1 > 'attribute1': attribute 'attribute2' already specified for 'construct' +## Remarks + Two attributes that are mutually exclusive were specified for the same construct. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md index ede887604c2..628f9154393 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md @@ -10,6 +10,8 @@ ms.assetid: 3d290a20-d313-4c07-9bd8-c5c159cb169f > 'attribute': attribute allowed only on class indexer (default indexed property) +## Remarks + An attribute that is designed to be applied to a class indexer property was used incorrectly. For more information, see [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md index 4cda0e3dd32..9efb6ceb0d9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md @@ -10,9 +10,11 @@ ms.assetid: adbf8775-10ca-4654-acdf-58dd765351cd > 'type': only a user-defined type can be forwarded +## Remarks + For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example The following sample creates a component. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md index 8da9d17dda1..15a9db450f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md @@ -10,11 +10,13 @@ ms.assetid: bd66833a-545d-445a-bdfe-dee771a450a4 > 'type': only a managed type can be forwarded +## Remarks + Type forwarding can only occur on CLR types. See [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md) for more information. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example The following sample creates a component. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md index 91ce5a45bda..fc70d1b34cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md @@ -10,11 +10,13 @@ ms.assetid: 56b75f35-9fad-42d9-a969-eeca5d709bec > 'type': only an imported type can be forwarded +## Remarks + The TypeForwardedTo attribute must be applied to a type in referenced metadata. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example The following sample creates a component. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md index f209848268b..89e1cdb1475 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md @@ -10,6 +10,8 @@ ms.assetid: 153efcc0-085c-4615-84ea-d22942618bdf > 'type': type not allowed in attribute 'implements' +## Remarks + An invalid type was passed to the [implements](../../windows/attributes/implements-cpp.md) attribute. For example, you can pass an interface to `implements`, but you cannot pass a pointer to an interface. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md index 663e5dca049..2bbc916577c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md @@ -10,11 +10,13 @@ ms.assetid: 0ede05dc-4486-4921-8e8c-78ab5a2e09c5 > 'type' a nested type cannot be forwarded +## Remarks + Type forwarding does not work on nested types. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example The following sample creates a component. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md index 8e0d41e10a4..ee62fb46523 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md @@ -10,11 +10,13 @@ ms.assetid: aeb815e5-b3fc-4525-afe2-d738e9321df1 > to use type 'type' you must reference the assembly 'assembly' +## Remarks + Type forwarding will work for a client application until you recompile the client. When you recompile, you will need a reference for every assembly containing the definition of a type used in your client application. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example The following sample builds an assembly that contains the new location of a type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md index faf02207e27..388a253eb4a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md @@ -10,11 +10,13 @@ ms.assetid: 69a877d9-a749-474b-bfc3-8d3fd53ba8fd > 'type' : a specialization of a generic class cannot be forwarded +## Remarks + You cannot use type forwarding on a specialization of a generic class. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example The following sample creates a component. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md index ab6612626f7..4cb0758565d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md @@ -10,11 +10,13 @@ ms.assetid: e2b844d0-4920-412f-99fd-cd8051c4aa41 > 'type' : this type has already been forwarded +## Remarks + The compiler found more than one forward type declaration for the same type. Only one declaration per type is allowed. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example The following sample creates a component. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md index be90bee5ab1..0a53403737b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md @@ -10,13 +10,15 @@ ms.assetid: cfd320db-2f6e-4e0d-ba02-e79ece87e1e0 > 'type' : you can only forward a type to an assembly: +## Remarks + '`file`' is not an assembly Only types in an assembly can be forwarded. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example The following sample creates a module. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md index 790b564a839..7591100ec63 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md @@ -10,11 +10,13 @@ ms.assetid: e23b0e5c-c704-4e67-a868-bf02c2055d85 > 'type' : a generic class cannot be forwarded +## Remarks + You cannot use type forwarding on a generic class. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example The following sample creates a component. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md index 758f0fd8adc..fabcbfa4ea5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md @@ -10,6 +10,8 @@ ms.assetid: 170c7a9d-214d-41b1-8f15-d4a4fc38aaa5 > 'type' : a class cannot have both an indexer (default indexed property) and an operator[] +## Remarks + A type cannot define both a default indexer and an operator[]. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3480.md b/docs/error-messages/compiler-errors-2/compiler-error-c3480.md index c970a90b76f..08162d54dfe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3480.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3480.md @@ -10,13 +10,15 @@ ms.assetid: 7b2e055a-9604-4d13-861b-b38bda1a6940 > 'var': a lambda capture variable must be from an enclosing function scope +## Remarks + The lambda capture variable is not from an enclosing function scope. ### To correct this error - Remove the variable from the capture list of the lambda expression. -## Examples +## Example The following example generates C3480 because the variable `global` is not from an enclosing function scope: From 186328912abf9c58458d41584fc570b0eb8aac05 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 23:39:21 +0800 Subject: [PATCH 0856/1799] Replace term "sample" with "example" for error references in range [C3421, C3480] --- .../compiler-errors-2/compiler-error-c3421.md | 2 +- .../compiler-errors-2/compiler-error-c3445.md | 2 +- .../compiler-errors-2/compiler-error-c3446.md | 2 +- .../compiler-errors-2/compiler-error-c3450.md | 2 +- .../compiler-errors-2/compiler-error-c3451.md | 2 +- .../compiler-errors-2/compiler-error-c3452.md | 2 +- .../compiler-errors-2/compiler-error-c3453.md | 2 +- .../compiler-errors-2/compiler-error-c3454.md | 2 +- .../compiler-errors-2/compiler-error-c3455.md | 2 +- .../compiler-errors-2/compiler-error-c3457.md | 2 +- .../compiler-errors-2/compiler-error-c3458.md | 2 +- .../compiler-errors-2/compiler-error-c3459.md | 2 +- .../compiler-errors-2/compiler-error-c3460.md | 4 ++-- .../compiler-errors-2/compiler-error-c3461.md | 4 ++-- .../compiler-errors-2/compiler-error-c3462.md | 4 ++-- .../compiler-errors-2/compiler-error-c3463.md | 2 +- .../compiler-errors-2/compiler-error-c3464.md | 4 ++-- .../compiler-errors-2/compiler-error-c3465.md | 6 +++--- .../compiler-errors-2/compiler-error-c3466.md | 4 ++-- .../compiler-errors-2/compiler-error-c3467.md | 4 ++-- .../compiler-errors-2/compiler-error-c3468.md | 4 ++-- .../compiler-errors-2/compiler-error-c3469.md | 4 ++-- .../compiler-errors-2/compiler-error-c3470.md | 2 +- 23 files changed, 33 insertions(+), 33 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md index af2fef64384..cdc579a65fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md @@ -18,7 +18,7 @@ For more information, see [Destructors and finalizers in How to: Define and cons ## Example -The following sample generates C3421. +The following example generates C3421. ```cpp // C3421.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3445.md b/docs/error-messages/compiler-errors-2/compiler-error-c3445.md index 4628a74f9f5..c797df50683 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3445.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3445.md @@ -18,7 +18,7 @@ Starting in Visual Studio 2017, the compiler finds errors related to object crea ## Example -The following sample generates C3445. +The following example generates C3445. ```cpp // C3445.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md index 0b2121841b3..17008c480fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md @@ -16,7 +16,7 @@ In Visual Studio 2015 and earlier, the compiler permitted (but ignored) a defaul ## Example -The following sample generates C3446 in Visual Studio 2017 and later: +The following example generates C3446 in Visual Studio 2017 and later: ```cpp // C3446.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md index ac97c365ed1..3c845a45509 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md @@ -18,7 +18,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3450 and shows how to fix it. +The following example generates C3450 and shows how to fix it. ```cpp // C3450.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3451.md b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md index 82133356255..cf4730e1d1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3451.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md @@ -20,7 +20,7 @@ This error can be generated as a result of compiler conformance work that was do ## Example -The following sample generates C3451. +The following example generates C3451. ```cpp // C3451.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3452.md b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md index fadee495aa2..3a21f15cdd1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3452.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md @@ -16,7 +16,7 @@ An argument was passed to an attribute that expected a constant, a value that ca ## Example -The following sample generates C3452. +The following example generates C3452. ```cpp // C3452.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md index a63ec871554..db00cabe183 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md @@ -16,7 +16,7 @@ Assembly or module level attributes can only be specified as stand-alone instruc ## Example -The following sample generates C3453. +The following example generates C3453. ```cpp // C3453.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md index f32b69c58e6..d9d08cf5c56 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md @@ -18,7 +18,7 @@ For more information, see [attribute](../../windows/attributes/attribute.md). ## Example -The following sample generates C3454. +The following example generates C3454. ```cpp // C3454.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md index 47c3ef98d16..13b86851c1a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md @@ -16,7 +16,7 @@ An invalid value was used to declare an attribute. See [attribute](../../window ## Example -The following sample generates C3455. +The following example generates C3455. ```cpp // C3455.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md index fbf417ec4cd..dc7ffe0c88b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md @@ -15,7 +15,7 @@ Source annotation attributes, unlike CLR custom attribute or compiler attributes ## Example -The following sample generates C3457. +The following example generates C3457. ```cpp #include "SourceAnnotations.h" diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md index 4af142f2f4b..91cb6118b64 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md @@ -16,7 +16,7 @@ Two attributes that are mutually exclusive were specified for the same construct ## Example -The following sample generates C3458 +The following example generates C3458 ```cpp // C3458.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md index 628f9154393..d0110668862 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md @@ -18,7 +18,7 @@ For more information, see [How to: Use Properties in C++/CLI](../../dotnet/how-t ## Example -The following sample generates C3459. +The following example generates C3459. ```cpp // C3459.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md index 9efb6ceb0d9..1529a7c7650 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md @@ -16,7 +16,7 @@ For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forw ## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3460.cpp @@ -24,7 +24,7 @@ The following sample creates a component. public ref class R {}; ``` -The following sample generates C3460. +The following example generates C3460. ```cpp // C3460_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md index 15a9db450f2..3cfda7fc45a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md @@ -18,7 +18,7 @@ For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forw ## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3461.cpp @@ -26,7 +26,7 @@ The following sample creates a component. public ref class R {}; ``` -The following sample generates C3461. +The following example generates C3461. ```cpp // C3461b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md index fc70d1b34cd..342153306c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md @@ -18,7 +18,7 @@ For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forw ## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3462.cpp @@ -26,7 +26,7 @@ The following sample creates a component. public ref class R {}; ``` -The following sample generates C3462. +The following example generates C3462. ```cpp // C3462b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md index 89e1cdb1475..214d73195a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md @@ -16,7 +16,7 @@ An invalid type was passed to the [implements](../../windows/attributes/implemen ## Example -The following sample generates C3463. +The following example generates C3463. ```cpp // C3463.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md index 2bbc916577c..2c69155da23 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md @@ -18,7 +18,7 @@ For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forw ## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3464.cpp @@ -29,7 +29,7 @@ public: }; ``` -The following sample generates C3464. +The following example generates C3464. ```cpp // C3464_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md index ee62fb46523..bd0a3590330 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md @@ -18,7 +18,7 @@ For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forw ## Example -The following sample builds an assembly that contains the new location of a type. +The following example builds an assembly that contains the new location of a type. ```cpp // C3465.cpp @@ -29,7 +29,7 @@ public: }; ``` -The following sample builds an assembly that used to contain the definition of the type, but now contains forwarding syntax for the type. +The following example builds an assembly that used to contain the definition of the type, but now contains forwarding syntax for the type. ```cpp // C3465_b.cpp @@ -38,7 +38,7 @@ The following sample builds an assembly that used to contain the definition of t [ assembly:TypeForwardedTo(R::typeid) ]; ``` -The following sample generates C3465. +The following example generates C3465. ```cpp // C3465_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md index 388a253eb4a..a9bbb5a9d88 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md @@ -18,7 +18,7 @@ For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forw ## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3466.cpp @@ -29,7 +29,7 @@ public ref class GR {}; public ref class GR2 {}; ``` -The following sample generates C3466. +The following example generates C3466. ```cpp // C3466_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md index 4cb0758565d..adc2cec0ed5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md @@ -18,7 +18,7 @@ For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forw ## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3467.cpp @@ -26,7 +26,7 @@ The following sample creates a component. public ref class R {}; ``` -The following sample generates C3467. +The following example generates C3467. ```cpp // C3467_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md index 0a53403737b..2b842a0fb0c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md @@ -20,7 +20,7 @@ For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forw ## Example -The following sample creates a module. +The following example creates a module. ```cpp // C3468.cpp @@ -28,7 +28,7 @@ The following sample creates a module. public ref class R {}; ``` -The following sample generates C3468. +The following example generates C3468. ```cpp // C3468_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md index 7591100ec63..80e7a7bc068 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md @@ -18,7 +18,7 @@ For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forw ## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3469.cpp @@ -29,7 +29,7 @@ public ref class GR {}; public ref class GR2 {}; ``` -The following sample generates C3466. +The following example generates C3466. ```cpp // C3469_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md index fabcbfa4ea5..71f1d4cfed0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md @@ -16,7 +16,7 @@ A type cannot define both a default indexer and an operator[]. ## Example -The following sample generates C3470 +The following example generates C3470 ```cpp // C3470.cpp From 2b2b997f1934fec245fbb9b62c71d104dc7a16d4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 19 Aug 2025 23:43:31 +0800 Subject: [PATCH 0857/1799] Update metadata for error references in range [C3421, C3480] --- .../error-messages/compiler-errors-2/compiler-error-c3421.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3445.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3446.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3450.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3451.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3452.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3453.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3454.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3455.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3456.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3458.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3459.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3460.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3461.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3462.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3463.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3464.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3465.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3466.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3467.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3468.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3469.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3470.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3480.md | 5 ++--- 24 files changed, 48 insertions(+), 72 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md index cdc579a65fb..d3c41e7bdab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3421" title: "Compiler Error C3421" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3421" +ms.date: 11/04/2016 f1_keywords: ["C3421"] helpviewer_keywords: ["C3421"] -ms.assetid: b52050c6-17a4-424a-8894-337b0cec7010 --- # Compiler Error C3421 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3445.md b/docs/error-messages/compiler-errors-2/compiler-error-c3445.md index c797df50683..7add75b0312 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3445.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3445.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3445" title: "Compiler Error C3445" -ms.date: "04/10/2017" +description: "Learn more about: Compiler Error C3445" +ms.date: 04/10/2017 f1_keywords: ["C3445"] helpviewer_keywords: ["C3445"] -ms.assetid: 0d272bfc-136b-4025-a9ba-5e4eea5f8215 --- # Compiler Error C3445 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md index 17008c480fe..46fe4603c2f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3446" title: "Compiler Error C3446" -ms.date: "07/21/2017" +description: "Learn more about: Compiler Error C3446" +ms.date: 07/21/2017 f1_keywords: ["C3446"] helpviewer_keywords: ["C3446"] -ms.assetid: 33064548-24e4-46f1-beb1-476e3c3b3fbf --- # Compiler Error C3446 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md index 3c845a45509..1b8c1d6bf6f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3450" title: "Compiler Error C3450" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3450" +ms.date: 11/04/2016 f1_keywords: ["C3450"] helpviewer_keywords: ["C3450"] -ms.assetid: 78892cf7-0b82-4589-90d0-e06666247003 --- # Compiler Error C3450 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3451.md b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md index cf4730e1d1b..17b42bf6a51 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3451.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3451" title: "Compiler Error C3451" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3451" +ms.date: 11/04/2016 f1_keywords: ["C3451"] helpviewer_keywords: ["C3451"] -ms.assetid: a4897a69-e3e7-40bb-bb1c-598644904012 --- # Compiler Error C3451 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3452.md b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md index 3a21f15cdd1..4a112bc3935 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3452.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3452" title: "Compiler Error C3452" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3452" +ms.date: 11/04/2016 f1_keywords: ["C3452"] helpviewer_keywords: ["C3452"] -ms.assetid: e5293dcf-cb70-4133-ae2a-0bb496950ba0 --- # Compiler Error C3452 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md index db00cabe183..d04287ade5b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3453" title: "Compiler Error C3453" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3453" +ms.date: 11/04/2016 f1_keywords: ["C3453"] helpviewer_keywords: ["C3453"] -ms.assetid: dbefdbcf-f697-4239-b7a5-1d99b85e9e7f --- # Compiler Error C3453 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md index d9d08cf5c56..c7034d16637 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3454" title: "Compiler Error C3454" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3454" +ms.date: 11/04/2016 f1_keywords: ["C3454"] helpviewer_keywords: ["C3454"] -ms.assetid: dc4e6d57-5b4d-4114-8d6f-22f9ae62925b --- # Compiler Error C3454 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md index 13b86851c1a..5cdd85744c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3455" title: "Compiler Error C3455" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3455" +ms.date: 11/04/2016 f1_keywords: ["C3455"] helpviewer_keywords: ["C3455"] -ms.assetid: 218e5cfe-5391-4eeb-81c2-85c47e3a6cd2 --- # Compiler Error C3455 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3456.md b/docs/error-messages/compiler-errors-2/compiler-error-c3456.md index 98b8c04eb83..996bf27c057 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3456.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3456.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3456" title: "Compiler Error C3456" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3456" +ms.date: 11/04/2016 f1_keywords: ["C3456"] helpviewer_keywords: ["C3456"] -ms.assetid: 9f781919-aaf2-4725-94a4-44a0b80cc64a --- # Compiler Error C3456 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md index 91cb6118b64..a6d8238079d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3458" title: "Compiler Error C3458" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3458" +ms.date: 11/04/2016 f1_keywords: ["C3458"] helpviewer_keywords: ["C3458"] -ms.assetid: 940202fd-8dcc-4042-9c96-3f9e9127d2f1 --- # Compiler Error C3458 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md index d0110668862..4c8ad60d6f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3459" title: "Compiler Error C3459" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3459" +ms.date: 11/04/2016 f1_keywords: ["C3459"] helpviewer_keywords: ["C3459"] -ms.assetid: 3d290a20-d313-4c07-9bd8-c5c159cb169f --- # Compiler Error C3459 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md index 1529a7c7650..e002f487f9e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3460" title: "Compiler Error C3460" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3460" +ms.date: 11/04/2016 f1_keywords: ["C3460"] helpviewer_keywords: ["C3460"] -ms.assetid: adbf8775-10ca-4654-acdf-58dd765351cd --- # Compiler Error C3460 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md index 3cfda7fc45a..9c801ba167e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3461" title: "Compiler Error C3461" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3461" +ms.date: 11/04/2016 f1_keywords: ["C3461"] helpviewer_keywords: ["C3461"] -ms.assetid: bd66833a-545d-445a-bdfe-dee771a450a4 --- # Compiler Error C3461 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md index 342153306c5..1c48adb2f45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3462" title: "Compiler Error C3462" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3462" +ms.date: 11/04/2016 f1_keywords: ["C3462"] helpviewer_keywords: ["C3462"] -ms.assetid: 56b75f35-9fad-42d9-a969-eeca5d709bec --- # Compiler Error C3462 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md index 214d73195a0..e2b9d5fff23 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3463" title: "Compiler Error C3463" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3463" +ms.date: 11/04/2016 f1_keywords: ["C3463"] helpviewer_keywords: ["C3463"] -ms.assetid: 153efcc0-085c-4615-84ea-d22942618bdf --- # Compiler Error C3463 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md index 2c69155da23..684c143ea61 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3464" title: "Compiler Error C3464" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3464" +ms.date: 11/04/2016 f1_keywords: ["C3464"] helpviewer_keywords: ["C3464"] -ms.assetid: 0ede05dc-4486-4921-8e8c-78ab5a2e09c5 --- # Compiler Error C3464 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md index bd0a3590330..b49fc9e1f2e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3465" title: "Compiler Error C3465" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3465" +ms.date: 11/04/2016 f1_keywords: ["C3465"] helpviewer_keywords: ["C3465"] -ms.assetid: aeb815e5-b3fc-4525-afe2-d738e9321df1 --- # Compiler Error C3465 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md index a9bbb5a9d88..9183287145d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3466" title: "Compiler Error C3466" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3466" +ms.date: 11/04/2016 f1_keywords: ["C3466"] helpviewer_keywords: ["C3466"] -ms.assetid: 69a877d9-a749-474b-bfc3-8d3fd53ba8fd --- # Compiler Error C3466 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md index adc2cec0ed5..4b253247f2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3467" title: "Compiler Error C3467" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3467" +ms.date: 11/04/2016 f1_keywords: ["C3467"] helpviewer_keywords: ["C3467"] -ms.assetid: e2b844d0-4920-412f-99fd-cd8051c4aa41 --- # Compiler Error C3467 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md index 2b842a0fb0c..fcde4b999d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3468" title: "Compiler Error C3468" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3468" +ms.date: 11/04/2016 f1_keywords: ["C3468"] helpviewer_keywords: ["C3468"] -ms.assetid: cfd320db-2f6e-4e0d-ba02-e79ece87e1e0 --- # Compiler Error C3468 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md index 80e7a7bc068..3977e7f2c58 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3469" title: "Compiler Error C3469" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3469" +ms.date: 11/04/2016 f1_keywords: ["C3469"] helpviewer_keywords: ["C3469"] -ms.assetid: e23b0e5c-c704-4e67-a868-bf02c2055d85 --- # Compiler Error C3469 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md index 71f1d4cfed0..ebbbfbe2096 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3470" title: "Compiler Error C3470" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3470" +ms.date: 11/04/2016 f1_keywords: ["C3470"] helpviewer_keywords: ["C3470"] -ms.assetid: 170c7a9d-214d-41b1-8f15-d4a4fc38aaa5 --- # Compiler Error C3470 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3480.md b/docs/error-messages/compiler-errors-2/compiler-error-c3480.md index 08162d54dfe..a032ea4e1b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3480.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3480.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3480" title: "Compiler Error C3480" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3480" +ms.date: 11/04/2016 f1_keywords: ["C3480"] helpviewer_keywords: ["C3480"] -ms.assetid: 7b2e055a-9604-4d13-861b-b38bda1a6940 --- # Compiler Error C3480 From ac75298c1700358d71bfabb98993f2c8c97948ab Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 19 Aug 2025 18:09:05 -0700 Subject: [PATCH 0858/1799] add metdata to classify freshness tiers --- docs/docfx.json | 166 +++++++++++++++++++++++++++--------------------- 1 file changed, 92 insertions(+), 74 deletions(-) diff --git a/docs/docfx.json b/docs/docfx.json index 1621b18044d..1dd4d169a49 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -38,7 +38,7 @@ "externalReference": [], "globalMetadata": { "breadcrumb_path": "~/_breadcrumb/toc.yml", -  "uhfHeaderId": "MSDocsHeader-CPP", + "uhfHeaderId": "MSDocsHeader-CPP", "ROBOTS": "INDEX,FOLLOW", "manager": "coxford", "ms.date": "11/16/2016", @@ -116,9 +116,7 @@ "intrinsics/**.md": "reference", "mfc/reference/**.md": "reference", "overview/**.md": "overview", - "parallel/amp/reference/**.md": "reference", - "parallel/concrt/reference/**.md": "reference", - "parallel/openmp/reference/**.md": "reference", + "parallel/**.md": "reference", "preprocessor/**.md": "reference", "safeint/**.md": "reference", "sanitizers/**.md": "reference", @@ -151,8 +149,6 @@ "linux/**.md": "linux-development", "mfc/**.md": "mfc-library", "overview/**.md": "tools", - "parallel/amp/**.md": "parallel-programming", - "parallel/concrt/**.md": "parallel-programming", "parallel/**.md": "parallel-programming", "porting/**.md": "cpp-lang", "preprocessor/**.md": "cpp-lang", @@ -163,79 +159,101 @@ "text/**.md": "windows-development", "windows/**.md": "windows-development" }, + "ms.update-cycle": { + "assembler/**.{md,yml}": "3650-days", + "attributes/**.{md,yml}": "3650-days", + "atl/**.{md,yml}": "3650-days", + "atl-mfc-shared/**.{md,yml}": "3650-days", + "build/**.{md,yml}": "1825-days", + "c-language/**.{md,yml}": "3650-days", + "c-runtime-library/**.{md,yml}": "3650-days", + "cpp/**.md": "1095-days", + "cppcx/**.{md,yml}": "3650-days", + "cross-platform/**.{md,yml}": "1825-days", + "data/**.{md,yml}": "3650-days", + "dotnet/**.{md,yml}": "3650-days", + "embedded/**.{md,yml}": "3650-days", + "error-messages/**.{md,yml}": "3650-days", + "extensions/**.{md,yml}": "3650-days", + "intrinsics/**.{md,yml}": "3650-days", + "mfc/**.{md,yml}": "3650-days", + "parallel/**.{md,yml}": "3650-days", + "porting/**.{md,yml}": "1095-days", + "preprocessor/**.{md,yml}": "3650-days", + "safeint/**.{md,yml}": "3650-days", + "standard-library/**.{md,yml}": "3650-days", + "text/**.{md,yml}": "3650-days", + "windows/**.{md,yml}": "1825-days" + }, "author": { "index.md": "tylermsft", - "assembler/**.md": "tylermsft", - "attributes/**.md": "tylermsft", - "atl/**.md": "tylermsft", - "atl-mfc-shared/**.md": "tylermsft", - "build/**.md": "tylermsft", - "build-insights/**.md": "tylermsft", - "c-language/**.md": "tylermsft", - "c-runtime-library/**.md": "tylermsft", - "cloud/**.md": "tylermsft", - "code-quality/**.md": "tylermsft", - "cpp/**.md": "tylermsft", - "cppcx/**.md": "tylermsft", - "cross-platform/**.md": "tylermsft", - "data/**.md": "tylermsft", - "dotnet/**.md": "tylermsft", - "error-messages/**.md": "tylermsft", - "extensions/**.md": "tylermsft", - "get-started/**.md": "tylermsft", - "ide/**.md": "tylermsft", - "intrinsics/**.md": "tylermsft", - "linux/**.md": "tylermsft", - "mfc/**.md": "tylermsft", - "overview/**.md": "tylermsft", - "parallel/amp/**.md": "tylermsft", - "parallel/concrt/**.md": "tylermsft", - "parallel/**.md": "tylermsft", - "porting/**.md": "tylermsft", - "preprocessor/**.md": "tylermsft", - "safeint/**.md": "tylermsft", - "sanitizers/**.md": "tylermsft", - "security/**.md": "tylermsft", - "standard-library/**.md": "tylermsft", - "text/**.md": "tylermsft", - "windows/**.md": "tylermsft" + "assembler/**.{md,yml}": "tylermsft", + "attributes/**.{md,yml}": "tylermsft", + "atl/**.{md,yml}": "tylermsft", + "atl-mfc-shared/**.{md,yml}": "tylermsft", + "build/**.{md,yml}": "tylermsft", + "build-insights/**.{md,yml}": "tylermsft", + "c-language/**.{md,yml}": "tylermsft", + "c-runtime-library/**.{md,yml}": "tylermsft", + "cloud/**.{md,yml}": "tylermsft", + "code-quality/**.{md,yml}": "tylermsft", + "cpp/**.{md,yml}": "tylermsft", + "cppcx/**.{md,yml}": "tylermsft", + "cross-platform/**.{md,yml}": "tylermsft", + "data/**.{md,yml}": "tylermsft", + "dotnet/**.{md,yml}": "tylermsft", + "error-messages/**.{md,yml}": "tylermsft", + "extensions/**.{md,yml}": "tylermsft", + "get-started/**.{md,yml}": "tylermsft", + "ide/**.{md,yml}": "tylermsft", + "intrinsics/**.{md,yml}": "tylermsft", + "linux/**.{md,yml}": "tylermsft", + "mfc/**.{md,yml}": "tylermsft", + "overview/**.{md,yml}": "tylermsft", + "parallel/**.{md,yml}": "tylermsft", + "porting/**.{md,yml}": "tylermsft", + "preprocessor/**.{md,yml}": "tylermsft", + "safeint/**.{md,yml}": "tylermsft", + "sanitizers/**.{md,yml}": "tylermsft", + "security/**.{md,yml}": "tylermsft", + "standard-library/**.{md,yml}": "tylermsft", + "text/**.{md,yml}": "tylermsft", + "windows/**.{md,yml}": "tylermsft" }, "ms.author": { "index.md": "twhitney", - "assembler/**.md": "twhitney", - "atl/**.md": "twhitney", - "atl-mfc-shared/**.md": "twhitney", - "attributes/**.md": "twhitney", - "build/**.md": "twhitney", - "build-insights/**.md": "twhitney", - "c-language/**.md": "twhitney", - "c-runtime-library/**.md": "twhitney", - "cloud/**.md": "twhitney", - "code-quality/**.md": "twhitney", - "cpp/**.md": "twhitney", - "cppcx/**.md": "twhitney", - "cross-platform/**.md": "twhitney", - "data/**.md": "twhitney", - "dotnet/**.md": "twhitney", - "error-messages/**.md": "twhitney", - "extensions/**.md": "twhitney", - "get-started/**.md": "twhitney", - "ide/**.md": "twhitney", - "intrinsics/**.md": "twhitney", - "linux/**.md": "twhitney", - "mfc/**.md": "twhitney", - "overview/**.md": "twhitney", - "parallel/amp/**.md": "twhitney", - "parallel/concrt/**.md": "twhitney", - "parallel/**.md": "twhitney", - "porting/**.md": "twhitney", - "preprocessor/**.md": "twhitney", - "safeint/**.md": "twhitney", - "sanitizers/**.md": "twhitney", - "security/**.md": "twhitney", - "standard-library/**.md": "twhitney", - "text/**.md": "twhitney", - "windows/**.md": "twhitney" + "assembler/**.{md,yml}": "twhitney", + "atl/**.{md,yml}": "twhitney", + "atl-mfc-shared/**.{md,yml}": "twhitney", + "attributes/**.{md,yml}": "twhitney", + "build/**.{md,yml}": "twhitney", + "build-insights/**.{md,yml}": "twhitney", + "c-language/**.{md,yml}": "twhitney", + "c-runtime-library/**.{md,yml}": "twhitney", + "cloud/**.{md,yml}": "twhitney", + "code-quality/**.{md,yml}": "twhitney", + "cpp/**.{md,yml}": "twhitney", + "cppcx/**.{md,yml}": "twhitney", + "cross-platform/**.{md,yml}": "twhitney", + "data/**.{md,yml}": "twhitney", + "dotnet/**.{md,yml}": "twhitney", + "error-messages/**.{md,yml}": "twhitney", + "extensions/**.{md,yml}": "twhitney", + "get-started/**.{md,yml}": "twhitney", + "ide/**.{md,yml}": "twhitney", + "intrinsics/**.{md,yml}": "twhitney", + "linux/**.{md,yml}": "twhitney", + "mfc/**.{md,yml}": "twhitney", + "overview/**.{md,yml}": "twhitney", + "parallel/**.{md,yml}": "twhitney", + "porting/**.{md,yml}": "twhitney", + "preprocessor/**.{md,yml}": "twhitney", + "safeint/**.{md,yml}": "twhitney", + "sanitizers/**.{md,yml}": "twhitney", + "security/**.{md,yml}": "twhitney", + "standard-library/**.{md,yml}": "twhitney", + "text/**.{md,yml}": "twhitney", + "windows/**.{md,yml}": "twhitney" } }, "template": [], From 878f5e1d67080b1139af3578461126df0e87022c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 16:54:10 +0800 Subject: [PATCH 0859/1799] Add blockquotes for error messages in range [C3481, C3530] --- docs/error-messages/compiler-errors-2/compiler-error-c3481.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3482.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3483.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3484.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3487.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3488.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3489.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3490.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3491.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3492.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3493.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3495.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3496.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3498.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3499.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3500.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3501.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3506.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3507.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3508.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3509.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3510.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3519.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3530.md | 2 +- 24 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3481.md b/docs/error-messages/compiler-errors-2/compiler-error-c3481.md index 775cbc06826..aa9b813eaa3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3481.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3481.md @@ -8,7 +8,7 @@ ms.assetid: 5d09375a-5ed3-4b61-86ed-45e91fd734c7 --- # Compiler Error C3481 -'var': lambda capture variable not found +> 'var': lambda capture variable not found The compiler could not find the definition of a variable that you passed to the capture list of a lambda expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3482.md b/docs/error-messages/compiler-errors-2/compiler-error-c3482.md index 8e471aea04c..78f0f7ab9f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3482.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3482.md @@ -8,7 +8,7 @@ ms.assetid: bf99558e-bef4-421c-bb16-dcd9c54c1011 --- # Compiler Error C3482 -'this' can only be used as a lambda capture within a non-static member function +> 'this' can only be used as a lambda capture within a non-static member function You cannot pass **`this`** to the capture list of a lambda expression that is declared in a static method or a global function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3483.md b/docs/error-messages/compiler-errors-2/compiler-error-c3483.md index 0664764558f..9d9765a825b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3483.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3483.md @@ -8,7 +8,7 @@ ms.assetid: 18b3a2c5-dfc9-4661-9653-08a5798474cf --- # Compiler Error C3483 -'var' is already part of the lambda capture list +> 'var' is already part of the lambda capture list You passed the same variable to the capture list of a lambda expression more than one time. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3484.md b/docs/error-messages/compiler-errors-2/compiler-error-c3484.md index 43a0e771a38..cdba34b91a2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3484.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3484.md @@ -8,7 +8,7 @@ ms.assetid: 2fe847fa-f6ee-4978-bc1d-b6dc6ae906ac --- # Compiler Error C3484 -expected '->' before the return type +> expected '->' before the return type You must provide `->` before the return type of a lambda expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3487.md b/docs/error-messages/compiler-errors-2/compiler-error-c3487.md index 6af8420b559..5b298d5a39b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3487.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3487.md @@ -8,7 +8,7 @@ ms.assetid: 39bda474-4418-4a79-98bf-2b22fa92eaaa --- # Compiler Error C3487 -'return type': all return expressions must deduce to the same type: previously it was 'return type' +> 'return type': all return expressions must deduce to the same type: previously it was 'return type' A lambda must specify its return type unless it contains a single return statement. If a lambda contains multiple return statements, they must all have the same type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3488.md b/docs/error-messages/compiler-errors-2/compiler-error-c3488.md index 7a38d4c1158..661a69a759f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3488.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3488.md @@ -8,7 +8,7 @@ ms.assetid: 0a6fcd76-dd3b-48d7-abb3-22eccda96034 --- # Compiler Error C3488 -'var' is not allowed when the default capture mode is by-reference +> 'var' is not allowed when the default capture mode is by-reference When you specify that the default capture mode for a lambda expression is by-reference, you cannot pass a variable by reference to the capture clause of that expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3489.md b/docs/error-messages/compiler-errors-2/compiler-error-c3489.md index fbd175529d6..05d7dfe90e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3489.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3489.md @@ -8,7 +8,7 @@ ms.assetid: 47b58d69-459d-4499-abc7-5f0b9303d773 --- # Compiler Error C3489 -'var' is required when the default capture mode is by-value +> 'var' is required when the default capture mode is by-value When you specify that the default capture mode for a lambda expression is by-value, you cannot pass a variable by value to the capture clause of that expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3490.md b/docs/error-messages/compiler-errors-2/compiler-error-c3490.md index 55fda1bfc02..6d79b4922fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3490.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3490.md @@ -8,7 +8,7 @@ ms.assetid: 7638559a-fd06-4527-a9c1-0c8ae68b3123 --- # Compiler Error C3490 -'var' cannot be modified because it is being accessed through a const object +> 'var' cannot be modified because it is being accessed through a const object A lambda expression that is declared in a **`const`** method cannot modify non-mutable member data. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3491.md b/docs/error-messages/compiler-errors-2/compiler-error-c3491.md index f941d825ccb..b8bc287819c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3491.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3491.md @@ -8,7 +8,7 @@ ms.assetid: 7f0e71b2-46a0-4d25-bd09-6158a280f509 --- # Compiler Error C3491 -'var': a by-value capture cannot be modified in a non-mutable lambda +> 'var': a by-value capture cannot be modified in a non-mutable lambda A non-mutable lambda expression cannot modify the value of a variable that is captured by value. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3492.md b/docs/error-messages/compiler-errors-2/compiler-error-c3492.md index 3883b98b062..d1657f0eb13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3492.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3492.md @@ -8,7 +8,7 @@ ms.assetid: b1dc6342-9133-4b1f-a9c3-e8c65d20d121 --- # Compiler Error C3492 -'var': you cannot capture a member of an anonymous union +> 'var': you cannot capture a member of an anonymous union You cannot capture a member of an unnamed union. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3493.md b/docs/error-messages/compiler-errors-2/compiler-error-c3493.md index f711ca6cabf..d625026cef5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3493.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3493.md @@ -8,7 +8,7 @@ ms.assetid: 734b4257-12a3-436f-8488-c8c55ec81634 --- # Compiler Error C3493 -'var' cannot be implicitly captured because no default capture mode has been specified +> 'var' cannot be implicitly captured because no default capture mode has been specified The empty lambda expression capture, `[]`, specifies that the lambda expression does not explicitly or implicitly capture any variables. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3495.md b/docs/error-messages/compiler-errors-2/compiler-error-c3495.md index 361a6225925..5794a38b15e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3495.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3495.md @@ -8,7 +8,7 @@ ms.assetid: 1fd40cb8-8373-403d-b8a8-f08424a50807 --- # Compiler Error C3495 -'var': a lambda capture must have automatic storage duration +> 'var': a lambda capture must have automatic storage duration You cannot capture a variable that does not have automatic storage duration, such as a variable that is marked **`static`** or **`extern`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3496.md b/docs/error-messages/compiler-errors-2/compiler-error-c3496.md index b766b396aff..3dfb60e2594 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3496.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3496.md @@ -8,7 +8,7 @@ ms.assetid: e19885f2-677f-4c1e-bc69-e35852262dc3 --- # Compiler Error C3496 -'this' is always captured by value: '&' ignored +> 'this' is always captured by value: '&' ignored You cannot capture the **`this`** pointer by reference. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3498.md b/docs/error-messages/compiler-errors-2/compiler-error-c3498.md index 353b893e20b..a689df8d99c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3498.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3498.md @@ -8,7 +8,7 @@ ms.assetid: 0a5a7817-0872-4119-83bf-980a19113374 --- # Compiler Error C3498 -'var': you cannot capture a variable that has a managed or WinRTtype +> 'var': you cannot capture a variable that has a managed or WinRTtype You cannot capture a variable that has a managed type or a Windows Runtime type in a lambda. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3499.md b/docs/error-messages/compiler-errors-2/compiler-error-c3499.md index 0004f9b25bc..6595932f992 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3499.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3499.md @@ -8,7 +8,7 @@ ms.assetid: 6717de5c-ae0f-4024-bdf2-b5598009e7b6 --- # Compiler Error C3499 -a lambda that has been specified to have a void return type cannot return a value +> a lambda that has been specified to have a void return type cannot return a value The compiler generates this error when a lambda expression that specifies **`void`** as the return type returns a value; or when a lambda expression contains more than one statement and returns a value, but does not specify its return type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3500.md b/docs/error-messages/compiler-errors-2/compiler-error-c3500.md index 7498428d7d6..f937b49bbec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3500.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3500.md @@ -8,6 +8,6 @@ ms.assetid: 77336f16-04f5-4943-bfc0-faba4cd8bb51 --- # Compiler Error C3500 -invalid ProgID 'progid' +> invalid ProgID 'progid' An invalid progid was specified with the `#import` statement. Check the Windows registry to ensure that you are specifying a valid progid. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3501.md b/docs/error-messages/compiler-errors-2/compiler-error-c3501.md index 87053046e34..41effa0d06b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3501.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3501.md @@ -8,6 +8,6 @@ ms.assetid: cad69fab-2687-41ac-961f-25dc4c51b167 --- # Compiler Error C3501 -there is no typelib registered for ProgID 'progid' +> there is no typelib registered for ProgID 'progid' The class ID for a given progid does not have an associated type library. Therefore, you cannot pass this progid to the `#import` statement. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3506.md b/docs/error-messages/compiler-errors-2/compiler-error-c3506.md index 9ff1a9b7fda..f977c57fc55 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3506.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3506.md @@ -8,6 +8,6 @@ ms.assetid: d382c067-5fad-42ca-acf3-9e6d8cbdb2c5 --- # Compiler Error C3506 -there is no typelib registered for LIBID 'id' +> there is no typelib registered for LIBID 'id' A typelib was not registered correctly. Use regsvr32.exe to register a type library. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md index e28427a5e8b..6908d61214b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md @@ -8,7 +8,7 @@ ms.assetid: 75f89767-f6f9-40f6-9820-81a49e09abdf --- # Compiler Error C3507 -a ProgID can have no more than 39 characters 'id'; nor contain any punctuation apart from '.'; nor start with a digit +> a ProgID can have no more than 39 characters 'id'; nor contain any punctuation apart from '.'; nor start with a digit The [progid](../../windows/attributes/progid.md) attribute has restrictions on the values that it can take. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md index d179185e372..5833bcd9d2c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md @@ -8,7 +8,7 @@ ms.assetid: 16d08f89-2f32-44eb-9421-68acecddf49b --- # Compiler Error C3508 -'type': is not a valid Automation type +> 'type': is not a valid Automation type An invalid type was specified. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md index 2b68307157e..e6cb225ad76 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md @@ -8,7 +8,7 @@ ms.assetid: cc2db39a-2f98-4e40-b803-496e585494e6 --- # Compiler Error C3509 -'type': invalid Automation return type; when a parameter is marked 'retval', the return type must be 'void', 'HRESULT' or 'SCODE' +> 'type': invalid Automation return type; when a parameter is marked 'retval', the return type must be 'void', 'HRESULT' or 'SCODE' A method in a COM interface must return either void or an HRESULT. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md index 7149143be10..db44b090f01 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md @@ -8,7 +8,7 @@ ms.assetid: c48387bc-0300-4a4d-97f7-3fb90f82a451 --- # Compiler Error C3510 -cannot locate dependent type library 'type_lib' +> cannot locate dependent type library 'type_lib' [no_registry](../../preprocessor/no-registry.md) and [auto_search](../../preprocessor/auto-search.md) were passed to `#import` but the compiler was not able to find a referenced type library. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md index af93d7018e6..2e2989f0af8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md @@ -8,7 +8,7 @@ ms.assetid: ca24b2bc-7e90-4448-ae84-3fedddf9bca7 --- # Compiler Error C3519 -'invalid_param' : invalid parameter to embedded_idl attribute +> 'invalid_param' : invalid parameter to embedded_idl attribute A parameter was passed to the `embedded_idl` attribute of [#import](../../preprocessor/hash-import-directive-cpp.md), but the compiler did not recognize the parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3530.md b/docs/error-messages/compiler-errors-2/compiler-error-c3530.md index 9a1a7467a25..1a93c0495dd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3530.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3530.md @@ -8,7 +8,7 @@ ms.assetid: 21be81ce-b699-4c74-81bc-80a0c34d2d5a --- # Compiler Error C3530 -'auto' cannot be combined with any other type-specifier +> 'auto' cannot be combined with any other type-specifier A type specifier is used with the **`auto`** keyword. From 42595e1fbba7cbe779f0172ecf33fe540282dc32 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 17:01:43 +0800 Subject: [PATCH 0860/1799] Add "Remarks" and "Example" headings for error references in range [C3481, C3530] --- docs/error-messages/compiler-errors-2/compiler-error-c3481.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3482.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3483.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3484.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3487.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3488.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3489.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3490.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3491.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3492.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3493.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3495.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3496.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3498.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3499.md | 4 +++- docs/error-messages/compiler-errors-2/compiler-error-c3500.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3501.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3505.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3506.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3507.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3508.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3509.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3510.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3519.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3530.md | 2 ++ 25 files changed, 67 insertions(+), 9 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3481.md b/docs/error-messages/compiler-errors-2/compiler-error-c3481.md index aa9b813eaa3..6200ebf0ebe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3481.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3481.md @@ -10,6 +10,8 @@ ms.assetid: 5d09375a-5ed3-4b61-86ed-45e91fd734c7 > 'var': lambda capture variable not found +## Remarks + The compiler could not find the definition of a variable that you passed to the capture list of a lambda expression. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3482.md b/docs/error-messages/compiler-errors-2/compiler-error-c3482.md index 78f0f7ab9f9..20df94d456c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3482.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3482.md @@ -10,6 +10,8 @@ ms.assetid: bf99558e-bef4-421c-bb16-dcd9c54c1011 > 'this' can only be used as a lambda capture within a non-static member function +## Remarks + You cannot pass **`this`** to the capture list of a lambda expression that is declared in a static method or a global function. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3483.md b/docs/error-messages/compiler-errors-2/compiler-error-c3483.md index 9d9765a825b..243c71e0efd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3483.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3483.md @@ -10,6 +10,8 @@ ms.assetid: 18b3a2c5-dfc9-4661-9653-08a5798474cf > 'var' is already part of the lambda capture list +## Remarks + You passed the same variable to the capture list of a lambda expression more than one time. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3484.md b/docs/error-messages/compiler-errors-2/compiler-error-c3484.md index cdba34b91a2..f19635e8b89 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3484.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3484.md @@ -10,13 +10,15 @@ ms.assetid: 2fe847fa-f6ee-4978-bc1d-b6dc6ae906ac > expected '->' before the return type +## Remarks + You must provide `->` before the return type of a lambda expression. ### To correct this error - Provide `->` before the return type. -## Examples +## Example The following example generates C3484: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3487.md b/docs/error-messages/compiler-errors-2/compiler-error-c3487.md index 5b298d5a39b..468e5302d88 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3487.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3487.md @@ -10,6 +10,8 @@ ms.assetid: 39bda474-4418-4a79-98bf-2b22fa92eaaa > 'return type': all return expressions must deduce to the same type: previously it was 'return type' +## Remarks + A lambda must specify its return type unless it contains a single return statement. If a lambda contains multiple return statements, they must all have the same type. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3488.md b/docs/error-messages/compiler-errors-2/compiler-error-c3488.md index 661a69a759f..25072451679 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3488.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3488.md @@ -10,6 +10,8 @@ ms.assetid: 0a6fcd76-dd3b-48d7-abb3-22eccda96034 > 'var' is not allowed when the default capture mode is by-reference +## Remarks + When you specify that the default capture mode for a lambda expression is by-reference, you cannot pass a variable by reference to the capture clause of that expression. ### To correct this error @@ -22,7 +24,7 @@ When you specify that the default capture mode for a lambda expression is by-ref - Pass the variable by value to the capture clause. (This might change the behavior of the lambda expression.) -## Examples +## Example The following example generates C3488 because a reference to the variable `n` appears in the capture clause of a lambda expression whose default mode is by-reference: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3489.md b/docs/error-messages/compiler-errors-2/compiler-error-c3489.md index 05d7dfe90e2..f2800dcde48 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3489.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3489.md @@ -10,6 +10,8 @@ ms.assetid: 47b58d69-459d-4499-abc7-5f0b9303d773 > 'var' is required when the default capture mode is by-value +## Remarks + When you specify that the default capture mode for a lambda expression is by-value, you cannot pass a variable by value to the capture clause of that expression. ### To correct this error @@ -22,7 +24,7 @@ When you specify that the default capture mode for a lambda expression is by-val - Pass the variable by reference to the capture clause. (This might change the behavior of the lambda expression.) -## Examples +## Example The following example generates C3489 variable `n` appears by value in the capture clause of a lambda expression whose default mode is by-value: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3490.md b/docs/error-messages/compiler-errors-2/compiler-error-c3490.md index 6d79b4922fb..d0fac448f99 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3490.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3490.md @@ -10,13 +10,15 @@ ms.assetid: 7638559a-fd06-4527-a9c1-0c8ae68b3123 > 'var' cannot be modified because it is being accessed through a const object +## Remarks + A lambda expression that is declared in a **`const`** method cannot modify non-mutable member data. ### To correct this error - Remove the **`const`** modifier from your method declaration. -## Examples +## Example The following example generates C3490 because it modifies the member variable `_i` in a **`const`** method: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3491.md b/docs/error-messages/compiler-errors-2/compiler-error-c3491.md index b8bc287819c..de78bcf48cb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3491.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3491.md @@ -10,6 +10,8 @@ ms.assetid: 7f0e71b2-46a0-4d25-bd09-6158a280f509 > 'var': a by-value capture cannot be modified in a non-mutable lambda +## Remarks + A non-mutable lambda expression cannot modify the value of a variable that is captured by value. ### To correct this error @@ -18,7 +20,7 @@ A non-mutable lambda expression cannot modify the value of a variable that is ca - Pass the variable by reference to the capture list of the lambda expression. -## Examples +## Example The following example generates C3491 because the body of a non-mutable lambda expression modifies the capture variable `m`: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3492.md b/docs/error-messages/compiler-errors-2/compiler-error-c3492.md index d1657f0eb13..d4fddc0f7ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3492.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3492.md @@ -10,13 +10,15 @@ ms.assetid: b1dc6342-9133-4b1f-a9c3-e8c65d20d121 > 'var': you cannot capture a member of an anonymous union +## Remarks + You cannot capture a member of an unnamed union. ### To correct this error - Give the union a name and pass the complete union structure to the capture list of the lambda expression. -## Examples +## Example The following example generates C3492 because it captures a member of an anonymous union: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3493.md b/docs/error-messages/compiler-errors-2/compiler-error-c3493.md index d625026cef5..5bc937228d9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3493.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3493.md @@ -10,6 +10,8 @@ ms.assetid: 734b4257-12a3-436f-8488-c8c55ec81634 > 'var' cannot be implicitly captured because no default capture mode has been specified +## Remarks + The empty lambda expression capture, `[]`, specifies that the lambda expression does not explicitly or implicitly capture any variables. ### To correct this error @@ -18,7 +20,7 @@ The empty lambda expression capture, `[]`, specifies that the lambda expression - Explicitly capture one or more variables. -## Examples +## Example The following example generates C3493 because it modifies an external variable but specifies the empty capture clause: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3495.md b/docs/error-messages/compiler-errors-2/compiler-error-c3495.md index 5794a38b15e..683334c9ca3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3495.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3495.md @@ -10,6 +10,8 @@ ms.assetid: 1fd40cb8-8373-403d-b8a8-f08424a50807 > 'var': a lambda capture must have automatic storage duration +## Remarks + You cannot capture a variable that does not have automatic storage duration, such as a variable that is marked **`static`** or **`extern`**. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3496.md b/docs/error-messages/compiler-errors-2/compiler-error-c3496.md index 3dfb60e2594..58adf536824 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3496.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3496.md @@ -10,6 +10,8 @@ ms.assetid: e19885f2-677f-4c1e-bc69-e35852262dc3 > 'this' is always captured by value: '&' ignored +## Remarks + You cannot capture the **`this`** pointer by reference. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3498.md b/docs/error-messages/compiler-errors-2/compiler-error-c3498.md index a689df8d99c..64814957466 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3498.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3498.md @@ -10,13 +10,15 @@ ms.assetid: 0a5a7817-0872-4119-83bf-980a19113374 > 'var': you cannot capture a variable that has a managed or WinRTtype +## Remarks + You cannot capture a variable that has a managed type or a Windows Runtime type in a lambda. ### To correct this error - Pass the managed or Windows Runtime variable to the parameter list of the lambda expression. -## Examples +## Example The following example generates C3498 because a variable that has a managed type appears in the capture list of a lambda expression: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3499.md b/docs/error-messages/compiler-errors-2/compiler-error-c3499.md index 6595932f992..b6d5522124e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3499.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3499.md @@ -10,6 +10,8 @@ ms.assetid: 6717de5c-ae0f-4024-bdf2-b5598009e7b6 > a lambda that has been specified to have a void return type cannot return a value +## Remarks + The compiler generates this error when a lambda expression that specifies **`void`** as the return type returns a value; or when a lambda expression contains more than one statement and returns a value, but does not specify its return type. ### To correct this error @@ -20,7 +22,7 @@ The compiler generates this error when a lambda expression that specifies **`voi - Combine the statements that make up the body of the lambda expression into a single statement. -## Examples +## Example The following example generates C3499 because the body of a lambda expression contains multiple statements and returns a value, but the lambda expression does not specify the return type: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3500.md b/docs/error-messages/compiler-errors-2/compiler-error-c3500.md index f937b49bbec..f52788cf8d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3500.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3500.md @@ -10,4 +10,6 @@ ms.assetid: 77336f16-04f5-4943-bfc0-faba4cd8bb51 > invalid ProgID 'progid' +## Remarks + An invalid progid was specified with the `#import` statement. Check the Windows registry to ensure that you are specifying a valid progid. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3501.md b/docs/error-messages/compiler-errors-2/compiler-error-c3501.md index 41effa0d06b..f9cf873dbd7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3501.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3501.md @@ -10,4 +10,6 @@ ms.assetid: cad69fab-2687-41ac-961f-25dc4c51b167 > there is no typelib registered for ProgID 'progid' +## Remarks + The class ID for a given progid does not have an associated type library. Therefore, you cannot pass this progid to the `#import` statement. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3505.md b/docs/error-messages/compiler-errors-2/compiler-error-c3505.md index f3d6d67d2c2..add88cea303 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3505.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3505.md @@ -10,6 +10,8 @@ ms.assetid: ed73c99e-93a1-4f3a-bac7-ba7ed5d836e4 > cannot load type library '*guid*' +## Remarks + C3505 can be caused if you are running the 32-bit, x86-hosted cross-compiler for 64-bit, x64 targets on a 64-bit machine, because the compiler is running under WOW64 and can only read from the 32-bit registry hive. You can resolve this error by building both 32-bit and 64-bit versions of the type library you are trying to import, and then register them both. Or you can use the native 64-bit compiler, which requires you to change your **VC++ Directories** property in the IDE to point to the 64-bit compiler. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3506.md b/docs/error-messages/compiler-errors-2/compiler-error-c3506.md index f977c57fc55..09074ba24a1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3506.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3506.md @@ -10,4 +10,6 @@ ms.assetid: d382c067-5fad-42ca-acf3-9e6d8cbdb2c5 > there is no typelib registered for LIBID 'id' +## Remarks + A typelib was not registered correctly. Use regsvr32.exe to register a type library. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md index 6908d61214b..0a29515a505 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md @@ -10,8 +10,12 @@ ms.assetid: 75f89767-f6f9-40f6-9820-81a49e09abdf > a ProgID can have no more than 39 characters 'id'; nor contain any punctuation apart from '.'; nor start with a digit +## Remarks + The [progid](../../windows/attributes/progid.md) attribute has restrictions on the values that it can take. +## Example + The following sample generates C3507: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md index 5833bcd9d2c..b9f40f20446 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md @@ -10,6 +10,8 @@ ms.assetid: 16d08f89-2f32-44eb-9421-68acecddf49b > 'type': is not a valid Automation type +## Remarks + An invalid type was specified. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md index e6cb225ad76..c4506036df4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md @@ -10,8 +10,12 @@ ms.assetid: cc2db39a-2f98-4e40-b803-496e585494e6 > 'type': invalid Automation return type; when a parameter is marked 'retval', the return type must be 'void', 'HRESULT' or 'SCODE' +## Remarks + A method in a COM interface must return either void or an HRESULT. +## Example + The following sample generates C3509: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md index db44b090f01..00415d544cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md @@ -10,10 +10,14 @@ ms.assetid: c48387bc-0300-4a4d-97f7-3fb90f82a451 > cannot locate dependent type library 'type_lib' +## Remarks + [no_registry](../../preprocessor/no-registry.md) and [auto_search](../../preprocessor/auto-search.md) were passed to `#import` but the compiler was not able to find a referenced type library. To resolve this error, make sure that all type libraries and referenced type libraries are available to the compiler. +## Example + The following sample generates C3510: Assume that the following two type libraries were built, and that C3510a.tlb was deleted or not on the path. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md index 2e2989f0af8..1d1d5f0a8b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md @@ -10,10 +10,14 @@ ms.assetid: ca24b2bc-7e90-4448-ae84-3fedddf9bca7 > 'invalid_param' : invalid parameter to embedded_idl attribute +## Remarks + A parameter was passed to the `embedded_idl` attribute of [#import](../../preprocessor/hash-import-directive-cpp.md), but the compiler did not recognize the parameter. The only parameters that are allowed for `embedded_idl` are `emitidl` and `no_emitidl`. +## Example + The following sample generates C3519: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3530.md b/docs/error-messages/compiler-errors-2/compiler-error-c3530.md index 1a93c0495dd..962f6ebeef4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3530.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3530.md @@ -10,6 +10,8 @@ ms.assetid: 21be81ce-b699-4c74-81bc-80a0c34d2d5a > 'auto' cannot be combined with any other type-specifier +## Remarks + A type specifier is used with the **`auto`** keyword. ### To correct this error From 8c1309da8b9ebb5c9bb6009790e708b4bef26e30 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 17:02:29 +0800 Subject: [PATCH 0861/1799] Replace term "sample" with "example" for error references in range [C3481, C3530] --- docs/error-messages/compiler-errors-2/compiler-error-c3507.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3508.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3509.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3510.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3519.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md index 0a29515a505..838d1ed4a92 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md @@ -16,7 +16,7 @@ The [progid](../../windows/attributes/progid.md) attribute has restrictions on t ## Example -The following sample generates C3507: +The following example generates C3507: ```cpp // C3507.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md index b9f40f20446..88a6bf9681e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md @@ -16,7 +16,7 @@ An invalid type was specified. ## Example -The following sample generates C3508: +The following example generates C3508: ```cpp // C3508.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md index c4506036df4..a9afd150183 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md @@ -16,7 +16,7 @@ A method in a COM interface must return either void or an HRESULT. ## Example -The following sample generates C3509: +The following example generates C3509: ```cpp // C3509.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md index 00415d544cf..47667d598b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md @@ -18,7 +18,7 @@ To resolve this error, make sure that all type libraries and referenced type lib ## Example -The following sample generates C3510: +The following example generates C3510: Assume that the following two type libraries were built, and that C3510a.tlb was deleted or not on the path. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md index 1d1d5f0a8b5..744fcac1d8f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md @@ -18,7 +18,7 @@ The only parameters that are allowed for `embedded_idl` are `emitidl` and `no_em ## Example -The following sample generates C3519: +The following example generates C3519: ```cpp // C3519.cpp From 5a1f15d63538e09078dabeef8749df9b5d07943e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 17:07:15 +0800 Subject: [PATCH 0862/1799] Update metadata for error references in range [C3481, C3530] --- .../error-messages/compiler-errors-2/compiler-error-c3481.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3482.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3483.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3484.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3485.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c3487.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3488.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3489.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3490.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3491.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3492.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3493.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3495.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3496.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3498.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3499.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3500.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3501.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3505.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3506.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3507.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3508.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3509.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3510.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3519.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3530.md | 5 ++--- 26 files changed, 51 insertions(+), 77 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3481.md b/docs/error-messages/compiler-errors-2/compiler-error-c3481.md index 6200ebf0ebe..7e07537f533 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3481.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3481.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3481" title: "Compiler Error C3481" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3481" +ms.date: 11/04/2016 f1_keywords: ["C3481"] helpviewer_keywords: ["C3481"] -ms.assetid: 5d09375a-5ed3-4b61-86ed-45e91fd734c7 --- # Compiler Error C3481 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3482.md b/docs/error-messages/compiler-errors-2/compiler-error-c3482.md index 20df94d456c..3b396c9bedc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3482.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3482.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3482" title: "Compiler Error C3482" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3482" +ms.date: 11/04/2016 f1_keywords: ["C3482"] helpviewer_keywords: ["C3482"] -ms.assetid: bf99558e-bef4-421c-bb16-dcd9c54c1011 --- # Compiler Error C3482 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3483.md b/docs/error-messages/compiler-errors-2/compiler-error-c3483.md index 243c71e0efd..2fee0c0075b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3483.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3483.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3483" title: "Compiler Error C3483" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3483" +ms.date: 11/04/2016 f1_keywords: ["C3483"] helpviewer_keywords: ["C3483"] -ms.assetid: 18b3a2c5-dfc9-4661-9653-08a5798474cf --- # Compiler Error C3483 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3484.md b/docs/error-messages/compiler-errors-2/compiler-error-c3484.md index f19635e8b89..1da53a08ba9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3484.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3484.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3484" title: "Compiler Error C3484" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3484" +ms.date: 11/04/2016 f1_keywords: ["C3484"] helpviewer_keywords: ["C3484"] -ms.assetid: 2fe847fa-f6ee-4978-bc1d-b6dc6ae906ac --- # Compiler Error C3484 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3485.md b/docs/error-messages/compiler-errors-2/compiler-error-c3485.md index f1a62610292..30fa2541210 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3485.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3485.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3485" title: "Compiler Error C3485" +description: "Learn more about: Compiler Error C3485" ms.date: 06/01/2022 f1_keywords: ["C3485"] helpviewer_keywords: ["C3485"] -ms.assetid: d67536f9-67a1-4ad9-9a94-d8bbbca3d0dc --- # Compiler Error C3485 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3487.md b/docs/error-messages/compiler-errors-2/compiler-error-c3487.md index 468e5302d88..7a34600a5aa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3487.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3487.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3487" title: "Compiler Error C3487" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3487" +ms.date: 11/04/2016 f1_keywords: ["C3487"] helpviewer_keywords: ["C3487"] -ms.assetid: 39bda474-4418-4a79-98bf-2b22fa92eaaa --- # Compiler Error C3487 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3488.md b/docs/error-messages/compiler-errors-2/compiler-error-c3488.md index 25072451679..407a19b00e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3488.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3488.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3488" title: "Compiler Error C3488" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3488" +ms.date: 11/04/2016 f1_keywords: ["C3488"] helpviewer_keywords: ["C3488"] -ms.assetid: 0a6fcd76-dd3b-48d7-abb3-22eccda96034 --- # Compiler Error C3488 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3489.md b/docs/error-messages/compiler-errors-2/compiler-error-c3489.md index f2800dcde48..3aa45bc46d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3489.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3489.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3489" title: "Compiler Error C3489" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3489" +ms.date: 11/04/2016 f1_keywords: ["C3489"] helpviewer_keywords: ["C3489"] -ms.assetid: 47b58d69-459d-4499-abc7-5f0b9303d773 --- # Compiler Error C3489 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3490.md b/docs/error-messages/compiler-errors-2/compiler-error-c3490.md index d0fac448f99..191d54b3881 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3490.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3490.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3490" title: "Compiler Error C3490" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3490" +ms.date: 11/04/2016 f1_keywords: ["C3490"] helpviewer_keywords: ["C3490"] -ms.assetid: 7638559a-fd06-4527-a9c1-0c8ae68b3123 --- # Compiler Error C3490 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3491.md b/docs/error-messages/compiler-errors-2/compiler-error-c3491.md index de78bcf48cb..4183526cc84 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3491.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3491.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3491" title: "Compiler Error C3491" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3491" +ms.date: 11/04/2016 f1_keywords: ["C3491"] helpviewer_keywords: ["C3491"] -ms.assetid: 7f0e71b2-46a0-4d25-bd09-6158a280f509 --- # Compiler Error C3491 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3492.md b/docs/error-messages/compiler-errors-2/compiler-error-c3492.md index d4fddc0f7ac..6993760f29a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3492.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3492.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3492" title: "Compiler Error C3492" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3492" +ms.date: 11/04/2016 f1_keywords: ["C3492"] helpviewer_keywords: ["C3492"] -ms.assetid: b1dc6342-9133-4b1f-a9c3-e8c65d20d121 --- # Compiler Error C3492 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3493.md b/docs/error-messages/compiler-errors-2/compiler-error-c3493.md index 5bc937228d9..6101fd828c6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3493.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3493.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3493" title: "Compiler Error C3493" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3493" +ms.date: 11/04/2016 f1_keywords: ["C3493"] helpviewer_keywords: ["C3493"] -ms.assetid: 734b4257-12a3-436f-8488-c8c55ec81634 --- # Compiler Error C3493 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3495.md b/docs/error-messages/compiler-errors-2/compiler-error-c3495.md index 683334c9ca3..be74c020b84 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3495.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3495.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3495" title: "Compiler Error C3495" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3495" +ms.date: 11/04/2016 f1_keywords: ["C3495"] helpviewer_keywords: ["C3495"] -ms.assetid: 1fd40cb8-8373-403d-b8a8-f08424a50807 --- # Compiler Error C3495 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3496.md b/docs/error-messages/compiler-errors-2/compiler-error-c3496.md index 58adf536824..b859690dd96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3496.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3496.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3496" title: "Compiler Error C3496" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3496" +ms.date: 11/04/2016 f1_keywords: ["C3496"] helpviewer_keywords: ["C3496"] -ms.assetid: e19885f2-677f-4c1e-bc69-e35852262dc3 --- # Compiler Error C3496 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3498.md b/docs/error-messages/compiler-errors-2/compiler-error-c3498.md index 64814957466..71ba1c6542b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3498.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3498.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3498" title: "Compiler Error C3498" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3498" +ms.date: 11/04/2016 f1_keywords: ["C3498"] helpviewer_keywords: ["C3498"] -ms.assetid: 0a5a7817-0872-4119-83bf-980a19113374 --- # Compiler Error C3498 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3499.md b/docs/error-messages/compiler-errors-2/compiler-error-c3499.md index b6d5522124e..390975bf586 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3499.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3499.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3499" title: "Compiler Error C3499" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3499" +ms.date: 11/04/2016 f1_keywords: ["C3499"] helpviewer_keywords: ["C3499"] -ms.assetid: 6717de5c-ae0f-4024-bdf2-b5598009e7b6 --- # Compiler Error C3499 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3500.md b/docs/error-messages/compiler-errors-2/compiler-error-c3500.md index f52788cf8d8..7de809c495b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3500.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3500.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3500" title: "Compiler Error C3500" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3500" +ms.date: 11/04/2016 f1_keywords: ["C3500"] helpviewer_keywords: ["C3500"] -ms.assetid: 77336f16-04f5-4943-bfc0-faba4cd8bb51 --- # Compiler Error C3500 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3501.md b/docs/error-messages/compiler-errors-2/compiler-error-c3501.md index f9cf873dbd7..980a2f5a0bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3501.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3501.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3501" title: "Compiler Error C3501" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3501" +ms.date: 11/04/2016 f1_keywords: ["C3501"] helpviewer_keywords: ["C3501"] -ms.assetid: cad69fab-2687-41ac-961f-25dc4c51b167 --- # Compiler Error C3501 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3505.md b/docs/error-messages/compiler-errors-2/compiler-error-c3505.md index add88cea303..c383d2d03e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3505.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3505.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3505" title: "Compiler Error C3505" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3505" +ms.date: 11/04/2016 f1_keywords: ["C3505"] helpviewer_keywords: ["C3505"] -ms.assetid: ed73c99e-93a1-4f3a-bac7-ba7ed5d836e4 --- # Compiler Error C3505 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3506.md b/docs/error-messages/compiler-errors-2/compiler-error-c3506.md index 09074ba24a1..8a2a8d3b71c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3506.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3506.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3506" title: "Compiler Error C3506" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3506" +ms.date: 11/04/2016 f1_keywords: ["C3506"] helpviewer_keywords: ["C3506"] -ms.assetid: d382c067-5fad-42ca-acf3-9e6d8cbdb2c5 --- # Compiler Error C3506 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md index 838d1ed4a92..ed79db7afe0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3507" title: "Compiler Error C3507" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3507" +ms.date: 11/04/2016 f1_keywords: ["C3507"] helpviewer_keywords: ["C3507"] -ms.assetid: 75f89767-f6f9-40f6-9820-81a49e09abdf --- # Compiler Error C3507 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md index 88a6bf9681e..189788fc259 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3508" title: "Compiler Error C3508" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3508" +ms.date: 11/04/2016 f1_keywords: ["C3508"] helpviewer_keywords: ["C3508"] -ms.assetid: 16d08f89-2f32-44eb-9421-68acecddf49b --- # Compiler Error C3508 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md index a9afd150183..4504363ff30 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3509" title: "Compiler Error C3509" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3509" +ms.date: 11/04/2016 f1_keywords: ["C3509"] helpviewer_keywords: ["C3509"] -ms.assetid: cc2db39a-2f98-4e40-b803-496e585494e6 --- # Compiler Error C3509 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md index 47667d598b8..c992a78b251 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3510" title: "Compiler Error C3510" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3510" +ms.date: 11/04/2016 f1_keywords: ["C3510"] helpviewer_keywords: ["C3510"] -ms.assetid: c48387bc-0300-4a4d-97f7-3fb90f82a451 --- # Compiler Error C3510 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md index 744fcac1d8f..94e81b7cdbd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3519" title: "Compiler Error C3519" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3519" +ms.date: 11/04/2016 f1_keywords: ["C3519"] helpviewer_keywords: ["C3519"] -ms.assetid: ca24b2bc-7e90-4448-ae84-3fedddf9bca7 --- # Compiler Error C3519 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3530.md b/docs/error-messages/compiler-errors-2/compiler-error-c3530.md index 962f6ebeef4..bc8713e3bd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3530.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3530.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3530" title: "Compiler Error C3530" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3530" +ms.date: 11/04/2016 f1_keywords: ["C3530"] helpviewer_keywords: ["C3530"] -ms.assetid: 21be81ce-b699-4c74-81bc-80a0c34d2d5a --- # Compiler Error C3530 From f1f16e2e7a8ec2ba5b9f5bbf0f8a33e14254894b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 17:15:34 +0800 Subject: [PATCH 0863/1799] Merge wrongly split error message in C3468 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3468.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md index fcde4b999d6..e101a28857d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md @@ -7,12 +7,10 @@ helpviewer_keywords: ["C3468"] --- # Compiler Error C3468 -> 'type' : you can only forward a type to an assembly: +> '*type*': you can only forward a type to an assembly: '*identifier*' is not an assembly ## Remarks -'`file`' is not an assembly - Only types in an assembly can be forwarded. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). From 09c5a3236adf8ab2f4bdd7fabfc6e8b6d9395a75 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 18:02:35 +0800 Subject: [PATCH 0864/1799] Update `get` syntax in `` functions reference --- docs/standard-library/array-functions.md | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index 60e9c8027c5..a1fadf65b8c 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -14,14 +14,17 @@ The `` header includes two non-member functions, `get` and `swap`, that o Returns a reference to the specified element of the array. ```cpp -template -constexpr T& get(array& arr) noexcept; +template +constexpr T& get(std::array& arr) noexcept; -template -constexpr const T& get(const array& arr) noexcept; +template +constexpr const T& get(const std::array& arr) noexcept; -template -constexpr T&& get(array&& arr) noexcept; +template +constexpr T&& get(std::array&& arr) noexcept; + +template +constexpr const T&& get(const std::array&& arr) noexcept; ``` ### Parameters @@ -29,10 +32,10 @@ constexpr T&& get(array&& arr) noexcept; *`Index`*\ The element offset. -*`T`*\ +*`Type`*\ The type of an element. -*`N`*\ +*`Size`*\ The number of elements in the array. *`arr`*\ From b0d9bb4624e248765637fdfcb37f922b81838992 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 18:06:39 +0800 Subject: [PATCH 0865/1799] Update `swap` syntax in `` functions reference --- docs/standard-library/array-functions.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index a1fadf65b8c..4ffdc5b50b4 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -78,16 +78,16 @@ int main() A non-member template specialization of `std::swap` that swaps two **array** objects. ```cpp -template -void swap(array& left, array& right); +template +void swap(std::array& left, std::array& right); ``` ### Parameters -*`Ty`*\ +*`Type`*\ The type of an element. -*`N`*\ +*`Size`*\ The size of the array. *`left`*\ From e30b46e83f88f3f2fc1d38759a107a6df07d6a98 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 18:11:17 +0800 Subject: [PATCH 0866/1799] Add "Template parameters" headings in `` functions reference --- docs/standard-library/array-functions.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index 4ffdc5b50b4..c73093fd750 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -27,7 +27,7 @@ template constexpr const T&& get(const std::array&& arr) noexcept; ``` -### Parameters +### Template parameters *`Index`*\ The element offset. @@ -38,6 +38,8 @@ The type of an element. *`Size`*\ The number of elements in the array. +### Parameters + *`arr`*\ The array to select from. @@ -82,7 +84,7 @@ template void swap(std::array& left, std::array& right); ``` -### Parameters +### Template parameters *`Type`*\ The type of an element. @@ -90,6 +92,8 @@ The type of an element. *`Size`*\ The size of the array. +### Parameters + *`left`*\ The first array to swap. From 183ce44376e3e3e245e936ba5fca94e085386cc0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 18:47:55 +0800 Subject: [PATCH 0867/1799] Document C++20 `std::to_array` function --- docs/standard-library/array-functions.md | 74 +++++++++++++++++++++++- docs/standard-library/array.md | 1 + 2 files changed, 72 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index c73093fd750..d2e34dae34d 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -2,12 +2,12 @@ title: " functions" description: "Learn more about: functions" ms.date: 11/04/2016 -f1_keywords: ["array/std::array::get", "array/std::get", "array/std::swap"] -helpviewer_keywords: ["std::array [C++], get", "std::get [C++]", "std::swap [C++]"] +f1_keywords: ["array/std::array::get", "array/std::get", "array/std::swap", "array/std::to_array"] +helpviewer_keywords: ["std::array [C++], get", "std::get [C++]", "std::swap [C++]", "std::to_array [C++]"] --- # `` functions -The `` header includes two non-member functions, `get` and `swap`, that operate on **array** objects. +The `` header includes three non-member functions, `get`, `swap`, and `to_array` that operate on **array** objects. ## `get` @@ -150,6 +150,74 @@ int main() 0 1 2 3 ``` +## `to_array` + +Converts a built-in array to a `std::array` object. + +```cpp +// C++20 +template +constexpr std::array, Size> to_array(Type (&arr)[Size]); + +// C++20 +template +constexpr std::array, Size> to_array(Type (&&arr)[Size]); +``` + +### Template parameters + +*`Type`*\ +The type of an element. + +*`Size`*\ +The size of the input array. + +### Parameters + +*`arr`*\ +The input array used for conversion. + +### Example + +```cpp +// std_to_array.cpp +// Requires /std:c++20 or later + +#include +#include + +int main() +{ + int arr1[]{ 1, 2, 3 }; + std::array arr2 = std::to_array(arr1); + + std::cout << "std::to_array(arr1):\n"; + for (const auto& i : arr2) + { + std::cout << i << " "; + } + std::cout << std::endl; + + // The size is 7 as it includes the null terminator + std::array arr3 = std::to_array("string"); + + std::cout << "\nstd::to_array(\"string\"):\n"; + for (const auto& i : arr3) + { + std::cout << i << " "; + } + std::cout << std::endl; +} +``` + +```Output +std::to_array(arr1): +1 2 3 + +std::to_array("string"): +s t r i n g +``` + ## See also [``](../standard-library/array.md) diff --git a/docs/standard-library/array.md b/docs/standard-library/array.md index 85273440ba3..1bf0296e70b 100644 --- a/docs/standard-library/array.md +++ b/docs/standard-library/array.md @@ -45,6 +45,7 @@ Defines the container class template **array** and several supporting templates. |-|-| |[get](../standard-library/array-functions.md#get)|Get specified array element.| |[swap](../standard-library/array-functions.md#swap)|Exchanges the contents of one array with the contents of another array.| +| [`to_array`](array-functions.md#to_array) | Converts a built-in array to a `std::array` object. | ## See also From 99323ab1dc7aabbc3ed16af1bd1c03fc683d93e1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 18:49:18 +0800 Subject: [PATCH 0868/1799] Simplify single "See also" link in `` functions reference --- docs/standard-library/array-functions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index d2e34dae34d..a3924b24921 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -220,4 +220,4 @@ s t r i n g ## See also -[``](../standard-library/array.md) +[``](array.md) From d1f2f14af18e9b9aac6a18cf2ded9809e047f36b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 18:50:57 +0800 Subject: [PATCH 0869/1799] Update metadata in 2 standard library topics --- docs/standard-library/array-functions.md | 2 +- docs/standard-library/array.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index a3924b24921..709189a51eb 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -1,7 +1,7 @@ --- title: " functions" description: "Learn more about: functions" -ms.date: 11/04/2016 +ms.date: 08/20/2025 f1_keywords: ["array/std::array::get", "array/std::get", "array/std::swap", "array/std::to_array"] helpviewer_keywords: ["std::array [C++], get", "std::get [C++]", "std::swap [C++]", "std::to_array [C++]"] --- diff --git a/docs/standard-library/array.md b/docs/standard-library/array.md index 1bf0296e70b..331316ee9e2 100644 --- a/docs/standard-library/array.md +++ b/docs/standard-library/array.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["array header"] --- From 11b48f71bc4cca703dc881a95a07d4cf3243f329 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 23:03:45 +0800 Subject: [PATCH 0870/1799] Add blockquotes for error messages in range [C3531, C3620] --- docs/error-messages/compiler-errors-2/compiler-error-c3531.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3532.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3533.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3535.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3536.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3537.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3538.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3539.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3540.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3541.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3550.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3551.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3552.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3554.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3603.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3609.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3610.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3611.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3612.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3618.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3619.md | 2 +- 21 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3531.md b/docs/error-messages/compiler-errors-2/compiler-error-c3531.md index 5881579fcb1..58c3dc8d49c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3531.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3531.md @@ -8,7 +8,7 @@ ms.assetid: 2bdb9fdc-9ddf-403e-8b92-02763d434487 --- # Compiler Error C3531 -'symbol': a symbol whose type contains 'auto' must have an initializer +> 'symbol': a symbol whose type contains 'auto' must have an initializer The specified variable does not have an initializer expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3532.md b/docs/error-messages/compiler-errors-2/compiler-error-c3532.md index ab9dd8b31e9..53fdafe1e7f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3532.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3532.md @@ -8,7 +8,7 @@ ms.assetid: 51067853-eda8-4f59-86e8-8924e16d3a95 --- # Compiler Error C3532 -'type': incorrect usage of 'auto' +> 'type': incorrect usage of 'auto' The indicated type cannot be declared with the **`auto`** keyword. For example, you cannot use the **`auto`** keyword to declare an array or a method return type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3533.md b/docs/error-messages/compiler-errors-2/compiler-error-c3533.md index eea7dbe64db..ee12a62b293 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3533.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3533.md @@ -8,7 +8,7 @@ ms.assetid: a68b1ba5-466e-4190-a1a4-505ccfe548b7 --- # Compiler Error C3533 -'type': a parameter cannot have a type that contains 'auto' +> 'type': a parameter cannot have a type that contains 'auto' A method or template parameter cannot be declared with the **`auto`** keyword if the default [/Zc:auto](../../build/reference/zc-auto-deduce-variable-type.md) compiler option is in effect. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3535.md b/docs/error-messages/compiler-errors-2/compiler-error-c3535.md index 05d22de8d0a..4cda25aaa68 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3535.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3535.md @@ -8,7 +8,7 @@ ms.assetid: 24449c98-f681-484d-a00b-32533dca3a88 --- # Compiler Error C3535 -cannot deduce type for 'type1' from 'type2' +> cannot deduce type for 'type1' from 'type2' The type of the variable declared by the **`auto`** keyword cannot be deduced from the type of the initialization expression. For example, this error occurs if the initialization expression evaluates to **`void`**, which is not a type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3536.md b/docs/error-messages/compiler-errors-2/compiler-error-c3536.md index 0e13e6df597..5d35662dea1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3536.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3536.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3536"] --- # Compiler Error C3536 -'symbol': cannot be used before it is initialized +> 'symbol': cannot be used before it is initialized The indicated symbol cannot be used before it is initialized. In practice, this means that a variable cannot be used to initialize itself. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3537.md b/docs/error-messages/compiler-errors-2/compiler-error-c3537.md index d7562baaf89..3a693e88ef5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3537.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3537.md @@ -8,7 +8,7 @@ ms.assetid: f537ebd1-4fb0-4e09-a453-4f38db2c6881 --- # Compiler Error C3537 -'type': you cannot cast to a type that contains 'auto' +> 'type': you cannot cast to a type that contains 'auto' You cannot cast a variable to the indicated type because the type contains the **`auto`** keyword and the default [/Zc:auto](../../build/reference/zc-auto-deduce-variable-type.md) compiler option is in effect. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3538.md b/docs/error-messages/compiler-errors-2/compiler-error-c3538.md index 3f503e35509..a5979b516d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3538.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3538.md @@ -8,7 +8,7 @@ ms.assetid: ef3698a5-7356-4c62-b9af-5d3a4baed958 --- # Compiler Error C3538 -in a declarator-list 'auto' must always deduce to the same type +> in a declarator-list 'auto' must always deduce to the same type All the declared variables in a declaration list do not resolve to the same type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3539.md b/docs/error-messages/compiler-errors-2/compiler-error-c3539.md index c7235b2ddd4..8b0b62ba052 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3539.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3539.md @@ -8,7 +8,7 @@ ms.assetid: 34a33a0f-d1b6-498f-b312-ffad2d4799b3 --- # Compiler Error C3539 -'type': a template-argument cannot be a type that contains 'auto' +> 'type': a template-argument cannot be a type that contains 'auto' The indicated template argument type cannot contain a usage of the **`auto`** keyword. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3540.md b/docs/error-messages/compiler-errors-2/compiler-error-c3540.md index 38339db5a72..d6be84ee1f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3540.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3540.md @@ -8,7 +8,7 @@ ms.assetid: 3c0c959c-e3b7-40eb-b922-ccac44bd9d85 --- # Compiler Error C3540 -'type': sizeof cannot be applied to a type that contains 'auto' +> 'type': sizeof cannot be applied to a type that contains 'auto' The [sizeof](../../cpp/sizeof-operator.md) operator cannot be applied to the indicated type because it contains the **`auto`** specifier. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3541.md b/docs/error-messages/compiler-errors-2/compiler-error-c3541.md index 10701262c51..a9659ee56f5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3541.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3541.md @@ -8,7 +8,7 @@ ms.assetid: 252cfd4c-5fd2-415e-a17d-6b0c254350db --- # Compiler Error C3541 -'type': typeid cannot be applied to a type that contains 'auto' +> 'type': typeid cannot be applied to a type that contains 'auto' The [typeid](../../extensions/typeid-cpp-component-extensions.md) operator cannot be applied to the indicated type because it contains the **`auto`** specifier. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md index 01e5f185657..ba825ea8a39 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md @@ -8,7 +8,7 @@ ms.assetid: 9f2d5ffc-e429-41a1-89e3-7acc4fd47e14 --- # Compiler Error C3550 -only plain 'decltype(auto)' is allowed in this context +> only plain 'decltype(auto)' is allowed in this context If [`decltype(auto)`](../../cpp/decltype-cpp.md#decltype-and-auto) is used as a placeholder for the return type of a function, it must be used by itself. It cannot be used as part of a pointer declaration (`decltype(auto)*`), a reference declaration (`decltype(auto)&`), or any other such qualification. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md index 0423abf69ee..8af242406be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md @@ -8,7 +8,7 @@ ms.assetid: c8ee23da-6568-40db-93a6-3ddb7ac47712 --- # Compiler Error C3551 -if a trailing return type is used then the leading return type shall be the single type-specifier 'auto' (not 'type') +> if a trailing return type is used then the leading return type shall be the single type-specifier 'auto' (not 'type') The leading return type in [trailing return type](../../cpp/functions-cpp.md#trailing-return-types) syntax must contain only `auto`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3552.md b/docs/error-messages/compiler-errors-2/compiler-error-c3552.md index 6d6c214ea1c..42d5adfa92b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3552.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3552.md @@ -8,7 +8,7 @@ ms.assetid: 83401524-1bf1-44c0-8aca-a6eb35c4224c --- # Compiler Error C3552 -'typename': a late specified return type cannot contain 'auto' +> 'typename': a late specified return type cannot contain 'auto' If you use the **`auto`** keyword as a placeholder for the return type of a function, you must provide a late-specified return type. However, you cannot use another **`auto`** keyword to specify the late-specified return type. For example, the following code fragment yields error C3552. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md index 72f066bf8ed..91a13f0b637 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3554"] --- # Compiler Error C3554 -'decltype' cannot be combined with any other type-specifier +> 'decltype' cannot be combined with any other type-specifier You cannot qualify the `decltype()` keyword with any type specifier. For example, the following code fragment yields error C3554. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3603.md b/docs/error-messages/compiler-errors-2/compiler-error-c3603.md index 7e37da6a646..db71733dc21 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3603.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3603.md @@ -8,6 +8,6 @@ ms.assetid: d0cdc7d3-f25a-4242-9ee8-51fe044a9959 --- # Compiler Error C3603 -'Symbol' : type 'Type' not yet supported +> 'Symbol' : type 'Type' not yet supported You attempted to use a data type that is not yet supported by the .NET runtime in a managed object. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md index b667614aedd..0e6b0990a51 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md @@ -8,7 +8,7 @@ ms.assetid: 801e7f79-4ac6-4f8f-955f-703cdf095d00 --- # Compiler Error C3609 -'member': a sealed or final function must be virtual +> 'member': a sealed or final function must be virtual The [sealed](../../extensions/sealed-cpp-component-extensions.md) and [final](../../cpp/final-specifier.md) keywords are only allowed on a class, struct, or member function marked **`virtual`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3610.md b/docs/error-messages/compiler-errors-2/compiler-error-c3610.md index 81720af72c7..cf321769a85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3610.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3610.md @@ -8,7 +8,7 @@ ms.assetid: 9349a348-9d37-4a00-9eab-481039268d31 --- # Compiler Error C3610 -'valuetype': value type must be 'boxed' before method 'method' can be called +> 'valuetype': value type must be 'boxed' before method 'method' can be called By default, a value type is not on the managed heap. Before you can call methods from .NET runtime classes, such as `Object`, you need to move the value type to the managed heap. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md index 53a3ecfdb1d..0f21ffcc4d1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md @@ -8,7 +8,7 @@ ms.assetid: 42f3e320-41de-420a-bd05-8924cab765aa --- # Compiler Error C3611 -'function': a sealed function cannot have a pure-specifier +> 'function': a sealed function cannot have a pure-specifier A sealed function was declared incorrectly. For more information, see [sealed](../../extensions/sealed-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md index 133fdce7452..61d4df089f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md @@ -8,7 +8,7 @@ ms.assetid: aa6e3a2b-4afa-481c-98c1-1b6d1f82f869 --- # Compiler Error C3612 -'type': a sealed class cannot be abstract +> 'type': a sealed class cannot be abstract Types defined by using `value` are sealed by default, and a class is abstract unless it implements all methods of its base. A sealed abstract class can neither be a base class nor can it be instantiated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md index facaf056dbb..b3e51f15366 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md @@ -8,7 +8,7 @@ ms.assetid: cacc105d-4389-4cb8-ae6c-41a3622e9a86 --- # Compiler Error C3618 -'function': a method marked DllImport cannot be defined +> 'function': a method marked DllImport cannot be defined A method marked with is defined in the specified.DLL. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3619.md b/docs/error-messages/compiler-errors-2/compiler-error-c3619.md index 6867cad9b73..582102d43b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3619.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3619.md @@ -8,7 +8,7 @@ ms.assetid: 76ae80d0-9fbe-4297-a1ef-b1503377fdcf --- # Compiler Error C3619 -a template cannot be declared within a managed or WinRT type +> a template cannot be declared within a managed or WinRT type Class templates are not allowed in a managed or WinRT class or interface. From 2a8605c1870672f6540d40281429d13db1e54d58 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 23:10:12 +0800 Subject: [PATCH 0871/1799] Add "Remarks" and "Example" headings for error references in range [C3531, C3620] --- .../compiler-errors-2/compiler-error-c3531.md | 2 ++ .../compiler-errors-2/compiler-error-c3532.md | 2 ++ .../compiler-errors-2/compiler-error-c3533.md | 2 ++ .../compiler-errors-2/compiler-error-c3535.md | 2 ++ .../compiler-errors-2/compiler-error-c3536.md | 2 ++ .../compiler-errors-2/compiler-error-c3537.md | 2 ++ .../compiler-errors-2/compiler-error-c3538.md | 2 ++ .../compiler-errors-2/compiler-error-c3539.md | 2 ++ .../compiler-errors-2/compiler-error-c3540.md | 2 ++ .../compiler-errors-2/compiler-error-c3541.md | 2 ++ .../compiler-errors-2/compiler-error-c3550.md | 2 ++ .../compiler-errors-2/compiler-error-c3551.md | 4 ++++ .../compiler-errors-2/compiler-error-c3552.md | 8 +++++++- .../compiler-errors-2/compiler-error-c3553.md | 8 +++++++- .../compiler-errors-2/compiler-error-c3554.md | 8 +++++++- .../compiler-errors-2/compiler-error-c3555.md | 2 ++ .../compiler-errors-2/compiler-error-c3556.md | 2 ++ .../compiler-errors-2/compiler-error-c3603.md | 2 ++ .../compiler-errors-2/compiler-error-c3609.md | 4 ++++ .../compiler-errors-2/compiler-error-c3610.md | 2 ++ .../compiler-errors-2/compiler-error-c3611.md | 2 ++ .../compiler-errors-2/compiler-error-c3612.md | 2 ++ .../compiler-errors-2/compiler-error-c3615.md | 2 ++ .../compiler-errors-2/compiler-error-c3618.md | 2 ++ .../compiler-errors-2/compiler-error-c3619.md | 2 ++ 25 files changed, 69 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3531.md b/docs/error-messages/compiler-errors-2/compiler-error-c3531.md index 58c3dc8d49c..60fcd601caa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3531.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3531.md @@ -10,6 +10,8 @@ ms.assetid: 2bdb9fdc-9ddf-403e-8b92-02763d434487 > 'symbol': a symbol whose type contains 'auto' must have an initializer +## Remarks + The specified variable does not have an initializer expression. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3532.md b/docs/error-messages/compiler-errors-2/compiler-error-c3532.md index 53fdafe1e7f..7124d936bb6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3532.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3532.md @@ -10,6 +10,8 @@ ms.assetid: 51067853-eda8-4f59-86e8-8924e16d3a95 > 'type': incorrect usage of 'auto' +## Remarks + The indicated type cannot be declared with the **`auto`** keyword. For example, you cannot use the **`auto`** keyword to declare an array or a method return type. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3533.md b/docs/error-messages/compiler-errors-2/compiler-error-c3533.md index ee12a62b293..1ac5987d02a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3533.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3533.md @@ -10,6 +10,8 @@ ms.assetid: a68b1ba5-466e-4190-a1a4-505ccfe548b7 > 'type': a parameter cannot have a type that contains 'auto' +## Remarks + A method or template parameter cannot be declared with the **`auto`** keyword if the default [/Zc:auto](../../build/reference/zc-auto-deduce-variable-type.md) compiler option is in effect. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3535.md b/docs/error-messages/compiler-errors-2/compiler-error-c3535.md index 4cda25aaa68..536655f9591 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3535.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3535.md @@ -10,6 +10,8 @@ ms.assetid: 24449c98-f681-484d-a00b-32533dca3a88 > cannot deduce type for 'type1' from 'type2' +## Remarks + The type of the variable declared by the **`auto`** keyword cannot be deduced from the type of the initialization expression. For example, this error occurs if the initialization expression evaluates to **`void`**, which is not a type. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3536.md b/docs/error-messages/compiler-errors-2/compiler-error-c3536.md index 5d35662dea1..cb8018a28dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3536.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3536.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C3536"] > 'symbol': cannot be used before it is initialized +## Remarks + The indicated symbol cannot be used before it is initialized. In practice, this means that a variable cannot be used to initialize itself. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3537.md b/docs/error-messages/compiler-errors-2/compiler-error-c3537.md index 3a693e88ef5..a53f72df67b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3537.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3537.md @@ -10,6 +10,8 @@ ms.assetid: f537ebd1-4fb0-4e09-a453-4f38db2c6881 > 'type': you cannot cast to a type that contains 'auto' +## Remarks + You cannot cast a variable to the indicated type because the type contains the **`auto`** keyword and the default [/Zc:auto](../../build/reference/zc-auto-deduce-variable-type.md) compiler option is in effect. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3538.md b/docs/error-messages/compiler-errors-2/compiler-error-c3538.md index a5979b516d8..fa69e6d3e48 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3538.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3538.md @@ -10,6 +10,8 @@ ms.assetid: ef3698a5-7356-4c62-b9af-5d3a4baed958 > in a declarator-list 'auto' must always deduce to the same type +## Remarks + All the declared variables in a declaration list do not resolve to the same type. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3539.md b/docs/error-messages/compiler-errors-2/compiler-error-c3539.md index 8b0b62ba052..38de072b7ed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3539.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3539.md @@ -10,6 +10,8 @@ ms.assetid: 34a33a0f-d1b6-498f-b312-ffad2d4799b3 > 'type': a template-argument cannot be a type that contains 'auto' +## Remarks + The indicated template argument type cannot contain a usage of the **`auto`** keyword. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3540.md b/docs/error-messages/compiler-errors-2/compiler-error-c3540.md index d6be84ee1f7..62c474e99eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3540.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3540.md @@ -10,6 +10,8 @@ ms.assetid: 3c0c959c-e3b7-40eb-b922-ccac44bd9d85 > 'type': sizeof cannot be applied to a type that contains 'auto' +## Remarks + The [sizeof](../../cpp/sizeof-operator.md) operator cannot be applied to the indicated type because it contains the **`auto`** specifier. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3541.md b/docs/error-messages/compiler-errors-2/compiler-error-c3541.md index a9659ee56f5..222934ad8ee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3541.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3541.md @@ -10,6 +10,8 @@ ms.assetid: 252cfd4c-5fd2-415e-a17d-6b0c254350db > 'type': typeid cannot be applied to a type that contains 'auto' +## Remarks + The [typeid](../../extensions/typeid-cpp-component-extensions.md) operator cannot be applied to the indicated type because it contains the **`auto`** specifier. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md index ba825ea8a39..f2303dc5f3d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md @@ -10,6 +10,8 @@ ms.assetid: 9f2d5ffc-e429-41a1-89e3-7acc4fd47e14 > only plain 'decltype(auto)' is allowed in this context +## Remarks + If [`decltype(auto)`](../../cpp/decltype-cpp.md#decltype-and-auto) is used as a placeholder for the return type of a function, it must be used by itself. It cannot be used as part of a pointer declaration (`decltype(auto)*`), a reference declaration (`decltype(auto)&`), or any other such qualification. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md index 8af242406be..8cb2ae2bafe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md @@ -10,8 +10,12 @@ ms.assetid: c8ee23da-6568-40db-93a6-3ddb7ac47712 > if a trailing return type is used then the leading return type shall be the single type-specifier 'auto' (not 'type') +## Remarks + The leading return type in [trailing return type](../../cpp/functions-cpp.md#trailing-return-types) syntax must contain only `auto`. +## Example + ```cpp // C3551.cpp // compile with: /c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3552.md b/docs/error-messages/compiler-errors-2/compiler-error-c3552.md index 42d5adfa92b..e0635e49bb5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3552.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3552.md @@ -10,6 +10,12 @@ ms.assetid: 83401524-1bf1-44c0-8aca-a6eb35c4224c > 'typename': a late specified return type cannot contain 'auto' -If you use the **`auto`** keyword as a placeholder for the return type of a function, you must provide a late-specified return type. However, you cannot use another **`auto`** keyword to specify the late-specified return type. For example, the following code fragment yields error C3552. +## Remarks + +If you use the **`auto`** keyword as a placeholder for the return type of a function, you must provide a late-specified return type. However, you cannot use another **`auto`** keyword to specify the late-specified return type. + +## Example + +For example, the following code fragment yields error C3552. `auto myFunction->auto; // C3552` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3553.md b/docs/error-messages/compiler-errors-2/compiler-error-c3553.md index aa032de7ddc..0021183eb7f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3553.md @@ -10,7 +10,13 @@ ms.assetid: 7f84bf37-6419-4ad3-ab30-64266100b930 > decltype expects an expression not a type -The `decltype()` keyword requires an expression as an argument, not the name of a type. For example, the last statement in the following code fragment yields error C3553. +## Remarks + +The `decltype()` keyword requires an expression as an argument, not the name of a type. + +## Example + +For example, the last statement in the following code fragment yields error C3553. ```cpp int x = 0; diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md index 91a13f0b637..d05cfaf3689 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md @@ -9,7 +9,13 @@ helpviewer_keywords: ["C3554"] > 'decltype' cannot be combined with any other type-specifier -You cannot qualify the `decltype()` keyword with any type specifier. For example, the following code fragment yields error C3554. +## Remarks + +You cannot qualify the `decltype()` keyword with any type specifier. + +## Example + +For example, the following code fragment yields error C3554. ```cpp int x; diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3555.md b/docs/error-messages/compiler-errors-2/compiler-error-c3555.md index 20d3a809439..037af623f67 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3555.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3555.md @@ -10,6 +10,8 @@ ms.assetid: b4311bd3-851b-479a-9965-d03f39dd8fd4 > incorrect argument to 'decltype' +## Remarks + The argument to the `decltype(`*expression*`)` type specifier is not a valid expression. > [!NOTE] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3556.md b/docs/error-messages/compiler-errors-2/compiler-error-c3556.md index d6f25c1171d..552ca7578a9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3556.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3556.md @@ -10,6 +10,8 @@ ms.assetid: 9b002dcc-494e-414f-9587-20c2a0a39333 > '*expression*': incorrect argument to 'decltype' +## Remarks + The compiler cannot deduce the type of the expression that is the argument to the `decltype(`*expression*`)` type specifier. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3603.md b/docs/error-messages/compiler-errors-2/compiler-error-c3603.md index db71733dc21..1335f54e994 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3603.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3603.md @@ -10,4 +10,6 @@ ms.assetid: d0cdc7d3-f25a-4242-9ee8-51fe044a9959 > 'Symbol' : type 'Type' not yet supported +## Remarks + You attempted to use a data type that is not yet supported by the .NET runtime in a managed object. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md index 0e6b0990a51..4fe7566b6f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md @@ -10,8 +10,12 @@ ms.assetid: 801e7f79-4ac6-4f8f-955f-703cdf095d00 > 'member': a sealed or final function must be virtual +## Remarks + The [sealed](../../extensions/sealed-cpp-component-extensions.md) and [final](../../cpp/final-specifier.md) keywords are only allowed on a class, struct, or member function marked **`virtual`**. +## Example + The following sample generates C3609: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3610.md b/docs/error-messages/compiler-errors-2/compiler-error-c3610.md index cf321769a85..df4b2dbee8e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3610.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3610.md @@ -10,6 +10,8 @@ ms.assetid: 9349a348-9d37-4a00-9eab-481039268d31 > 'valuetype': value type must be 'boxed' before method 'method' can be called +## Remarks + By default, a value type is not on the managed heap. Before you can call methods from .NET runtime classes, such as `Object`, you need to move the value type to the managed heap. C3610 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md index 0f21ffcc4d1..2696281d4d3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md @@ -10,6 +10,8 @@ ms.assetid: 42f3e320-41de-420a-bd05-8924cab765aa > 'function': a sealed function cannot have a pure-specifier +## Remarks + A sealed function was declared incorrectly. For more information, see [sealed](../../extensions/sealed-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md index 61d4df089f2..66d056d3782 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md @@ -10,6 +10,8 @@ ms.assetid: aa6e3a2b-4afa-481c-98c1-1b6d1f82f869 > 'type': a sealed class cannot be abstract +## Remarks + Types defined by using `value` are sealed by default, and a class is abstract unless it implements all methods of its base. A sealed abstract class can neither be a base class nor can it be instantiated. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3615.md b/docs/error-messages/compiler-errors-2/compiler-error-c3615.md index a66992f97d8..a66ef770e65 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3615.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3615.md @@ -10,6 +10,8 @@ ms.assetid: 5ce96ba9-3d31-49f3-9aa8-24e5cdf6dcfc > constexpr function '*function*' cannot result in a constant expression +## Remarks + The function *function* could not be evaluated as **`constexpr`** at compile time. To be **`constexpr`**, a function can only call other **`constexpr`** functions. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md index b3e51f15366..a030833c230 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md @@ -10,6 +10,8 @@ ms.assetid: cacc105d-4389-4cb8-ae6c-41a3622e9a86 > 'function': a method marked DllImport cannot be defined +## Remarks + A method marked with is defined in the specified.DLL. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3619.md b/docs/error-messages/compiler-errors-2/compiler-error-c3619.md index 582102d43b8..b2395d7839b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3619.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3619.md @@ -10,6 +10,8 @@ ms.assetid: 76ae80d0-9fbe-4297-a1ef-b1503377fdcf > a template cannot be declared within a managed or WinRT type +## Remarks + Class templates are not allowed in a managed or WinRT class or interface. C3619 is only reachable using the obsolete compiler option **/clr:oldSyntax**. From 467aca311e1ceab7d6efe629def85bbedaf4d068 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 23:10:54 +0800 Subject: [PATCH 0872/1799] Replace term "sample" with "example" for error references in range [C3531, C3620] --- docs/error-messages/compiler-errors-2/compiler-error-c3550.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3609.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3611.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3612.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3618.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md index f2303dc5f3d..10a2a27041a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md @@ -16,7 +16,7 @@ If [`decltype(auto)`](../../cpp/decltype-cpp.md#decltype-and-auto) is used as a ## Example -The following sample generates C3550: +The following example generates C3550: ```cpp // C3550.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md index 4fe7566b6f2..45198695831 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md @@ -16,7 +16,7 @@ The [sealed](../../extensions/sealed-cpp-component-extensions.md) and [final](.. ## Example -The following sample generates C3609: +The following example generates C3609: ```cpp // C3609.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md index 2696281d4d3..15d0e0d278a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md @@ -16,7 +16,7 @@ A sealed function was declared incorrectly. For more information, see [sealed]( ## Example -The following sample generates C3611. +The following example generates C3611. ```cpp // C3611.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md index 66d056d3782..69464cbc724 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md @@ -18,7 +18,7 @@ For more information, see [Classes and Structs](../../extensions/classes-and-str ## Example -The following sample generates C3612: +The following example generates C3612: ```cpp // C3612.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md index a030833c230..fef9c5f8456 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md @@ -16,7 +16,7 @@ A method marked with is ## Example -The following sample generates C3618. +The following example generates C3618. ```cpp // C3618.cpp From a3bc89dc39cb09b33e8a5f7ea373b2916e49df1a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 23:14:36 +0800 Subject: [PATCH 0873/1799] Update metadata for error references in range [C3531, C3620] --- .../error-messages/compiler-errors-2/compiler-error-c3531.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3532.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3533.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3535.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3537.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3538.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3539.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3540.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3541.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3550.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3551.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3552.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3553.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3555.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3556.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3603.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3609.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3610.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3611.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3612.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3615.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3618.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3619.md | 5 ++--- 23 files changed, 46 insertions(+), 69 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3531.md b/docs/error-messages/compiler-errors-2/compiler-error-c3531.md index 60fcd601caa..af8e3c7faad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3531.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3531.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3531" title: "Compiler Error C3531" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3531" +ms.date: 11/04/2016 f1_keywords: ["C3531"] helpviewer_keywords: ["C3531"] -ms.assetid: 2bdb9fdc-9ddf-403e-8b92-02763d434487 --- # Compiler Error C3531 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3532.md b/docs/error-messages/compiler-errors-2/compiler-error-c3532.md index 7124d936bb6..ae31df7e246 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3532.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3532.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3532" title: "Compiler Error C3532" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3532" +ms.date: 11/04/2016 f1_keywords: ["C3532"] helpviewer_keywords: ["C3532"] -ms.assetid: 51067853-eda8-4f59-86e8-8924e16d3a95 --- # Compiler Error C3532 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3533.md b/docs/error-messages/compiler-errors-2/compiler-error-c3533.md index 1ac5987d02a..0b56398b7bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3533.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3533.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3533" title: "Compiler Error C3533" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3533" +ms.date: 11/04/2016 f1_keywords: ["C3533"] helpviewer_keywords: ["C3533"] -ms.assetid: a68b1ba5-466e-4190-a1a4-505ccfe548b7 --- # Compiler Error C3533 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3535.md b/docs/error-messages/compiler-errors-2/compiler-error-c3535.md index 536655f9591..7ea0627d720 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3535.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3535.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3535" title: "Compiler Error C3535" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3535" +ms.date: 11/04/2016 f1_keywords: ["C3535"] helpviewer_keywords: ["C3535"] -ms.assetid: 24449c98-f681-484d-a00b-32533dca3a88 --- # Compiler Error C3535 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3537.md b/docs/error-messages/compiler-errors-2/compiler-error-c3537.md index a53f72df67b..1daeb6d5e7a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3537.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3537.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3537" title: "Compiler Error C3537" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3537" +ms.date: 11/04/2016 f1_keywords: ["C3537"] helpviewer_keywords: ["C3537"] -ms.assetid: f537ebd1-4fb0-4e09-a453-4f38db2c6881 --- # Compiler Error C3537 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3538.md b/docs/error-messages/compiler-errors-2/compiler-error-c3538.md index fa69e6d3e48..58df9218dba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3538.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3538.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3538" title: "Compiler Error C3538" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3538" +ms.date: 11/04/2016 f1_keywords: ["C3538"] helpviewer_keywords: ["C3538"] -ms.assetid: ef3698a5-7356-4c62-b9af-5d3a4baed958 --- # Compiler Error C3538 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3539.md b/docs/error-messages/compiler-errors-2/compiler-error-c3539.md index 38de072b7ed..2ace0616df1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3539.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3539.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3539" title: "Compiler Error C3539" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3539" +ms.date: 11/04/2016 f1_keywords: ["C3539"] helpviewer_keywords: ["C3539"] -ms.assetid: 34a33a0f-d1b6-498f-b312-ffad2d4799b3 --- # Compiler Error C3539 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3540.md b/docs/error-messages/compiler-errors-2/compiler-error-c3540.md index 62c474e99eb..b1688781639 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3540.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3540.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3540" title: "Compiler Error C3540" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3540" +ms.date: 11/04/2016 f1_keywords: ["C3540"] helpviewer_keywords: ["C3540"] -ms.assetid: 3c0c959c-e3b7-40eb-b922-ccac44bd9d85 --- # Compiler Error C3540 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3541.md b/docs/error-messages/compiler-errors-2/compiler-error-c3541.md index 222934ad8ee..c29ca9eebf6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3541.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3541.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3541" title: "Compiler Error C3541" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3541" +ms.date: 11/04/2016 f1_keywords: ["C3541"] helpviewer_keywords: ["C3541"] -ms.assetid: 252cfd4c-5fd2-415e-a17d-6b0c254350db --- # Compiler Error C3541 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md index 10a2a27041a..c77d30507be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3550" title: "Compiler Error C3550" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3550" +ms.date: 11/04/2016 f1_keywords: ["C3550"] helpviewer_keywords: ["C3550"] -ms.assetid: 9f2d5ffc-e429-41a1-89e3-7acc4fd47e14 --- # Compiler Error C3550 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md index 8cb2ae2bafe..c0785b1132e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3551" title: "Compiler Error C3551" -ms.date: "10/07/2023" +description: "Learn more about: Compiler Error C3551" +ms.date: 10/07/2023 f1_keywords: ["C3551"] helpviewer_keywords: ["C3551"] -ms.assetid: c8ee23da-6568-40db-93a6-3ddb7ac47712 --- # Compiler Error C3551 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3552.md b/docs/error-messages/compiler-errors-2/compiler-error-c3552.md index e0635e49bb5..157c8b64b31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3552.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3552.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3552" title: "Compiler Error C3552" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3552" +ms.date: 11/04/2016 f1_keywords: ["C3552"] helpviewer_keywords: ["C3552"] -ms.assetid: 83401524-1bf1-44c0-8aca-a6eb35c4224c --- # Compiler Error C3552 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3553.md b/docs/error-messages/compiler-errors-2/compiler-error-c3553.md index 0021183eb7f..ad12e1f1f4c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3553.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3553" title: "Compiler Error C3553" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3553" +ms.date: 11/04/2016 f1_keywords: ["C3553"] helpviewer_keywords: ["C3553"] -ms.assetid: 7f84bf37-6419-4ad3-ab30-64266100b930 --- # Compiler Error C3553 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3555.md b/docs/error-messages/compiler-errors-2/compiler-error-c3555.md index 037af623f67..3f716381455 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3555.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3555.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3555" title: "Compiler Error C3555" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3555" +ms.date: 11/04/2016 f1_keywords: ["C3555"] helpviewer_keywords: ["C3555"] -ms.assetid: b4311bd3-851b-479a-9965-d03f39dd8fd4 --- # Compiler Error C3555 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3556.md b/docs/error-messages/compiler-errors-2/compiler-error-c3556.md index 552ca7578a9..dbfbe198704 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3556.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3556.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3556" title: "Compiler Error C3556" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3556" +ms.date: 11/04/2016 f1_keywords: ["C3556"] helpviewer_keywords: ["C3556"] -ms.assetid: 9b002dcc-494e-414f-9587-20c2a0a39333 --- # Compiler Error C3556 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3603.md b/docs/error-messages/compiler-errors-2/compiler-error-c3603.md index 1335f54e994..d3e6f9a8806 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3603.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3603.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3603" title: "Compiler Error C3603" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3603" +ms.date: 11/04/2016 f1_keywords: ["C3603"] helpviewer_keywords: ["C3603"] -ms.assetid: d0cdc7d3-f25a-4242-9ee8-51fe044a9959 --- # Compiler Error C3603 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md index 45198695831..e0a7eca6c11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3609" title: "Compiler Error C3609" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3609" +ms.date: 11/04/2016 f1_keywords: ["C3609"] helpviewer_keywords: ["C3609"] -ms.assetid: 801e7f79-4ac6-4f8f-955f-703cdf095d00 --- # Compiler Error C3609 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3610.md b/docs/error-messages/compiler-errors-2/compiler-error-c3610.md index df4b2dbee8e..8d7ddb5eeda 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3610.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3610.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3610" title: "Compiler Error C3610" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3610" +ms.date: 11/04/2016 f1_keywords: ["C3610"] helpviewer_keywords: ["C3610"] -ms.assetid: 9349a348-9d37-4a00-9eab-481039268d31 --- # Compiler Error C3610 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md index 15d0e0d278a..985c54d27e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3611" title: "Compiler Error C3611" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3611" +ms.date: 11/04/2016 f1_keywords: ["C3611"] helpviewer_keywords: ["C3611"] -ms.assetid: 42f3e320-41de-420a-bd05-8924cab765aa --- # Compiler Error C3611 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md index 69464cbc724..f8b2ed8dc3e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3612" title: "Compiler Error C3612" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3612" +ms.date: 11/04/2016 f1_keywords: ["C3612"] helpviewer_keywords: ["C3612"] -ms.assetid: aa6e3a2b-4afa-481c-98c1-1b6d1f82f869 --- # Compiler Error C3612 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3615.md b/docs/error-messages/compiler-errors-2/compiler-error-c3615.md index a66ef770e65..43d833dbcec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3615.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3615.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3615" title: "Compiler Error C3615" -ms.date: "10/24/2017" +description: "Learn more about: Compiler Error C3615" +ms.date: 10/24/2017 f1_keywords: ["C3615"] helpviewer_keywords: ["C3615"] -ms.assetid: 5ce96ba9-3d31-49f3-9aa8-24e5cdf6dcfc --- # Compiler Error C3615 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md index fef9c5f8456..0ee128a4473 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3618" title: "Compiler Error C3618" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3618" +ms.date: 11/04/2016 f1_keywords: ["C3618"] helpviewer_keywords: ["C3618"] -ms.assetid: cacc105d-4389-4cb8-ae6c-41a3622e9a86 --- # Compiler Error C3618 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3619.md b/docs/error-messages/compiler-errors-2/compiler-error-c3619.md index b2395d7839b..53c17536203 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3619.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3619.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3619" title: "Compiler Error C3619" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3619" +ms.date: 11/04/2016 f1_keywords: ["C3619"] helpviewer_keywords: ["C3619"] -ms.assetid: 76ae80d0-9fbe-4297-a1ef-b1503377fdcf --- # Compiler Error C3619 From ea3337e4af8117f5122a64ae2eaeb714c00d5b08 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 23:16:22 +0800 Subject: [PATCH 0874/1799] Add leading example sentence in C3551 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3551.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md index c0785b1132e..5496151097d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md @@ -15,6 +15,8 @@ The leading return type in [trailing return type](../../cpp/functions-cpp.md#tra ## Example +The following example generates C3551: + ```cpp // C3551.cpp // compile with: /c From e89f4e60f98fb4697cd10dfb131e2bd344952049 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 20 Aug 2025 23:48:26 +0800 Subject: [PATCH 0875/1799] Add missing commas in template parameter list --- docs/standard-library/chrono-functions.md | 2 +- docs/standard-library/istreambuf-iterator-class.md | 2 +- docs/standard-library/ostream-iterator-class.md | 2 +- docs/standard-library/ostreambuf-iterator-class.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/chrono-functions.md b/docs/standard-library/chrono-functions.md index e1812b1d349..ed9c593c99f 100644 --- a/docs/standard-library/chrono-functions.md +++ b/docs/standard-library/chrono-functions.md @@ -347,7 +347,7 @@ If the parse fails, `is.setstate`(`ios_base::failbit`) is called and the output ```cpp // 1) day - C++20 -template> +template> basic_istream& from_stream( basic_istream& is, const charT* fmt, diff --git a/docs/standard-library/istreambuf-iterator-class.md b/docs/standard-library/istreambuf-iterator-class.md index 9b05304ed12..78cc65c400e 100644 --- a/docs/standard-library/istreambuf-iterator-class.md +++ b/docs/standard-library/istreambuf-iterator-class.md @@ -15,7 +15,7 @@ The class template istreambuf_iterator describes an input iterator object that e ## Syntax ```cpp -template > +template > class istreambuf_iterator : public iterator ``` diff --git a/docs/standard-library/ostream-iterator-class.md b/docs/standard-library/ostream-iterator-class.md index de3f56cd39c..8f3ed11025d 100644 --- a/docs/standard-library/ostream-iterator-class.md +++ b/docs/standard-library/ostream-iterator-class.md @@ -15,7 +15,7 @@ The class template ostream_iterator describes an output iterator object that wri ## Syntax ```cpp -template > +template > class ostream_iterator ``` diff --git a/docs/standard-library/ostreambuf-iterator-class.md b/docs/standard-library/ostreambuf-iterator-class.md index dea0af412dd..ff57128a316 100644 --- a/docs/standard-library/ostreambuf-iterator-class.md +++ b/docs/standard-library/ostreambuf-iterator-class.md @@ -13,7 +13,7 @@ The class template ostreambuf_iterator describes an output iterator object that ## Syntax ```cpp -template > +template > ``` ### Parameters From 4a99dd577e37b35d6d523048a9b098c1055d1f42 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 20:59:39 +0800 Subject: [PATCH 0876/1799] Add blockquotes for error messages in range [C3621, C3660] --- docs/error-messages/compiler-errors-2/compiler-error-c3622.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3623.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3624.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3625.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3626.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3627.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3628.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3631.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3632.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3633.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3634.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3637.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3638.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3640.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3642.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3644.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3645.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3648.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3650.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3651.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3652.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3653.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3654.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3655.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3656.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3657.md | 2 +- 26 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md index 7301a8b96aa..5344395c283 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md @@ -8,7 +8,7 @@ ms.assetid: 02836f78-0cf2-4947-b87e-710187d81014 --- # Compiler Error C3622 -'class' : a class declared as 'keyword' cannot be instantiated +> 'class' : a class declared as 'keyword' cannot be instantiated An attempt was made to instantiate a class marked as [abstract](../../extensions/abstract-cpp-component-extensions.md). A class marked as **`abstract`** can be a base class, but it cannot be instantiated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md index 07627ca798e..70c99ece986 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md @@ -8,7 +8,7 @@ ms.assetid: a0341b45-062a-4f67-beb9-ba74201ed1ed --- # Compiler Error C3623 -'variable': bit fields are not supported in managed or WinRT types +> 'variable': bit fields are not supported in managed or WinRT types The use of bit fields is not permitted on variables in a managed or WinRT class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md index 8a9eba82beb..5797688efbc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md @@ -8,7 +8,7 @@ ms.assetid: eaac6a4f-eb11-4e4d-ab12-124ba995c5cf --- # Compiler Error C3624 -'type': use of this type requires a reference to assembly 'assembly' +> 'type': use of this type requires a reference to assembly 'assembly' An assembly (reference) needed to compile your code was not specified; pass the assembly to the [#using](../../preprocessor/hash-using-directive-cpp.md) directive. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md index eed0c1f02bf..fa4015b4853 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md @@ -8,7 +8,7 @@ ms.assetid: fdf49f21-d6b1-42f4-9eec-23b04ae8b4aa --- # Compiler Error C3625 -'native_type': a native type cannot derive from a managed or WinRT type 'type' +> 'native_type': a native type cannot derive from a managed or WinRT type 'type' A native class cannot inherit from a managed or WinRT class. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md index dd04cfe1a42..28a70c38461 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md @@ -8,7 +8,7 @@ ms.assetid: 43926e2b-1ba9-4a43-9343-c58449cbb336 --- # Compiler Error C3626 -'keyword': '__event' keyword can only be used on COM interfaces, member functions and data members that are pointers to delegates +> 'keyword': '__event' keyword can only be used on COM interfaces, member functions and data members that are pointers to delegates A keyword was used incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3627.md b/docs/error-messages/compiler-errors-2/compiler-error-c3627.md index cddb376d1bb..a2c6bd3a5c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3627.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3627.md @@ -8,6 +8,6 @@ ms.assetid: 905ad0a0-8c49-4187-b66e-b375f5a1fae5 --- # Compiler Error C3627 -Only a value type can be boxed +> Only a value type can be boxed Only value classes can be boxed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md index cd3c08937af..a6219b37961 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md @@ -8,7 +8,7 @@ ms.assetid: 0ff5a4a4-fcc9-47a0-a4d8-8af9cf2815f6 --- # Compiler Error C3628 -'base class' : managed or WinRTclasses only support public inheritance +> 'base class' : managed or WinRTclasses only support public inheritance An attempt was made to use a managed or WinRT class as a [private](../../cpp/private-cpp.md) or [protected](../../cpp/protected-cpp.md) base class. A managed or WinRT class can only be used as a base class with [public](../../cpp/public-cpp.md) access. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3631.md b/docs/error-messages/compiler-errors-2/compiler-error-c3631.md index 202b12ae211..2a5e40598f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3631.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3631.md @@ -8,7 +8,7 @@ ms.assetid: 88cbd2d5-6fef-4940-be34-d8cbe816d3da --- # Compiler Error C3631 -'function': cannot overload managed or WinRT events +> 'function': cannot overload managed or WinRT events A managed or WinRT event cannot be overloaded. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3632.md b/docs/error-messages/compiler-errors-2/compiler-error-c3632.md index c9151e571fa..3a668cbc40a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3632.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3632.md @@ -8,7 +8,7 @@ ms.assetid: a04e3217-f5a1-4461-a1db-d69fd096d468 --- # Compiler Error C3632 -'event': illegal style of event for construct +> 'event': illegal style of event for construct [__event](../../cpp/event.md) declarations are not valid in all constructs. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md index fb0ba09ac2e..d5de0178bf3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md @@ -8,7 +8,7 @@ ms.assetid: 7d65babf-2191-4d67-a69f-f5c4c2ddf946 --- # Compiler Error C3633 -cannot define 'member' as a member of managed 'type' +> cannot define 'member' as a member of managed 'type' CLR reference class data members cannot be of a non-POD C++ type. You can only instantiate a POD native type in a CLR type. For example, a POD type cannot contain a copy constructor or an assignment operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md index 390f9d9b044..bab9d179fe2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md @@ -8,7 +8,7 @@ ms.assetid: fd09f10c-f863-483b-9756-71c16b760b02 --- # Compiler Error C3634 -'function' : cannot define an abstract method of a managed or WinRTclass +> 'function' : cannot define an abstract method of a managed or WinRTclass An abstract method can be declared in a managed or WinRT class, but it cannot be defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md index b49fbc33968..088b7d1b62f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md @@ -8,7 +8,7 @@ ms.assetid: 72391377-8519-43d9-870a-73a6423deb74 --- # Compiler Error C3637 -'function' : a friend function definition cannot be a specialization of a function type +> 'function' : a friend function definition cannot be a specialization of a function type A friend function was defined incorrectly for a template or generic. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md index 2fcff4c27d4..66fbde51077 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md @@ -8,7 +8,7 @@ ms.assetid: 8d8bc5ca-75aa-480e-b6b6-3178fab51b1d --- # Compiler Error C3638 -'operator' : the standard boxing and unboxing conversion operators cannot be redefined +> 'operator' : the standard boxing and unboxing conversion operators cannot be redefined The compiler defines a conversion operator for each managed class to support implicit boxing. This operator cannot be redefined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md index 88cd60658d6..4649fc4e55a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md @@ -8,7 +8,7 @@ ms.assetid: fcc56894-0f98-48af-8561-3bf7c7b2b93f --- # Compiler Error C3640 -'member' : a referenced or virtual member function of a local class must be defined +> 'member' : a referenced or virtual member function of a local class must be defined The compiler requires certain functions to be defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md index 6408f3f41d4..eea469a9635 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md @@ -8,7 +8,7 @@ ms.assetid: 429790c2-9614-4d85-b31c-687c8d8f83ff --- # Compiler Error C3642 -'return_type/args' : cannot call a function with __clrcall calling convention from native code +> 'return_type/args' : cannot call a function with __clrcall calling convention from native code A function that is marked with the [__clrcall](../../cpp/clrcall.md) calling convention cannot be called from native (unmanaged) code. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md index 1798239f263..f9b30740448 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md @@ -8,7 +8,7 @@ ms.assetid: 2e3f6c41-3ec5-4a01-82bc-f11b61ebe68e --- # Compiler Error C3644 -'function' : cannot compile the function to generate managed code +> 'function' : cannot compile the function to generate managed code The presence of some keywords in a function will cause the function to be compiled to native. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md index b58af9dcfdb..927d386ebe6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md @@ -8,7 +8,7 @@ ms.assetid: 346da528-ae86-4cd0-9654-f41bee26ac0d --- # Compiler Error C3645 -'function' : __clrcall cannot be used on functions compiled to native code +> 'function' : __clrcall cannot be used on functions compiled to native code The presence of some keywords in a function will cause the function to be compiled to native. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md index 273693bbe46..97e5c7ef78c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md @@ -8,7 +8,7 @@ ms.assetid: 5d042989-41cb-4cd0-aa50-976b70146aaf --- # Compiler Error C3648 -this explicit override syntax requires /clr:oldSyntax +> this explicit override syntax requires /clr:oldSyntax When compiling for the latest managed syntax, the compiler found explicit override syntax for previous versions that is no longer supported. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md index e77e5ac394f..d0862ee7894 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md @@ -8,7 +8,7 @@ ms.assetid: ca4d8de4-b027-4d13-9b9f-03ca62905c33 --- # Compiler Error C3650 -'interface_method' : cannot be used as an explicit override, must be a virtual member function of a base class +> 'interface_method' : cannot be used as an explicit override, must be a virtual member function of a base class An attempt was made to perform an explicit override on a member that was not virtual. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md index f50b6090be8..d45f2f5ff4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md @@ -8,7 +8,7 @@ ms.assetid: a03e692e-c219-4654-9827-8415cfa5a22d --- # Compiler Error C3651 -'member' : cannot be used as an explicit override, must be a member of a base class +> 'member' : cannot be used as an explicit override, must be a member of a base class An explicit override was specified, but the function being overridden was in a type that is not a base type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md index 81541733938..eea3742c87c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md @@ -8,7 +8,7 @@ ms.assetid: 15d68737-177e-41f1-80e0-7c3e2afdf0fc --- # Compiler Error C3652 -'override' : a function that explicitly overrides must be virtual +> 'override' : a function that explicitly overrides must be virtual A function that does an explicit override must be virtual. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md index 4f6aeb2eeca..8e92aba881e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md @@ -8,7 +8,7 @@ ms.assetid: 316549d7-f7ef-4578-a2ba-57adc8aac527 --- # Compiler Error C3653 -'function' : cannot be used as a named override: a function being overridden not found; did you forget to name the function explicitly, using a :: operator? +> 'function' : cannot be used as a named override: a function being overridden not found; did you forget to name the function explicitly, using a :: operator? An explicit override specified a function that was not found in any interface. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md index 593ca9bd654..7bd4b889fd3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md @@ -8,7 +8,7 @@ ms.assetid: 57d96e3f-6bbb-4eaa-934b-26c23b4ceb2e --- # Compiler Error C3654 -'text' : syntax error in explicit override +> 'text' : syntax error in explicit override An unexpected string was in an explicit override. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md index e2b51a05bb3..ab81076fd9f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md @@ -8,7 +8,7 @@ ms.assetid: 724919ab-2915-4b61-8794-44648e162d62 --- # Compiler Error C3655 -'function' : function already explicitly overridden +> 'function' : function already explicitly overridden A function can only be explicitly overridden once. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md index 1825ce5c157..9c9ca2d6938 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md @@ -8,7 +8,7 @@ ms.assetid: 88965d85-73b0-4b35-8020-0650c9c94cd8 --- # Compiler Error C3656 -'override' : override specifier cannot be repeated +> 'override' : override specifier cannot be repeated An explicit override keyword can only be specified once. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md index a778329f3c9..319e5f044b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md @@ -8,7 +8,7 @@ ms.assetid: 89a28a18-4c17-43a1-bda6-deb52c32d203 --- # Compiler Error C3657 -destructors cannot explicitly override or be explicitly overridden +> destructors cannot explicitly override or be explicitly overridden Destructors or finalizers cannot be explicitly overridden. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). From aa5e410614ae925058a8c07685c3e3ddf89714fe Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 21:06:38 +0800 Subject: [PATCH 0877/1799] Add "Remarks" and "Example" headings for error references in range [C3621, C3660] --- docs/error-messages/compiler-errors-2/compiler-error-c3622.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3623.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3624.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3625.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3626.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3627.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3628.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3630.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3631.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3632.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3633.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3634.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3637.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3638.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3640.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3642.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3644.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3645.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3648.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3650.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3651.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3652.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3653.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3654.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3655.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3656.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3657.md | 2 ++ 27 files changed, 84 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md index 5344395c283..b3b2c187fe0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md @@ -10,6 +10,8 @@ ms.assetid: 02836f78-0cf2-4947-b87e-710187d81014 > 'class' : a class declared as 'keyword' cannot be instantiated +## Remarks + An attempt was made to instantiate a class marked as [abstract](../../extensions/abstract-cpp-component-extensions.md). A class marked as **`abstract`** can be a base class, but it cannot be instantiated. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md index 70c99ece986..4e4b3c53054 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md @@ -10,8 +10,12 @@ ms.assetid: a0341b45-062a-4f67-beb9-ba74201ed1ed > 'variable': bit fields are not supported in managed or WinRT types +## Remarks + The use of bit fields is not permitted on variables in a managed or WinRT class. +## Example + The following sample generates C3623: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md index 5797688efbc..d93c446fc01 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md @@ -10,6 +10,8 @@ ms.assetid: eaac6a4f-eb11-4e4d-ab12-124ba995c5cf > 'type': use of this type requires a reference to assembly 'assembly' +## Remarks + An assembly (reference) needed to compile your code was not specified; pass the assembly to the [#using](../../preprocessor/hash-using-directive-cpp.md) directive. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md index fa4015b4853..f7fe9d766fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md @@ -10,6 +10,8 @@ ms.assetid: fdf49f21-d6b1-42f4-9eec-23b04ae8b4aa > 'native_type': a native type cannot derive from a managed or WinRT type 'type' +## Remarks + A native class cannot inherit from a managed or WinRT class. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md index 28a70c38461..52dba53506b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md @@ -10,8 +10,12 @@ ms.assetid: 43926e2b-1ba9-4a43-9343-c58449cbb336 > 'keyword': '__event' keyword can only be used on COM interfaces, member functions and data members that are pointers to delegates +## Remarks + A keyword was used incorrectly. +## Example + The following sample generates C3626: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3627.md b/docs/error-messages/compiler-errors-2/compiler-error-c3627.md index a2c6bd3a5c3..0912c5d93fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3627.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3627.md @@ -10,4 +10,6 @@ ms.assetid: 905ad0a0-8c49-4187-b66e-b375f5a1fae5 > Only a value type can be boxed +## Remarks + Only value classes can be boxed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md index a6219b37961..b10c0713beb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md @@ -10,8 +10,12 @@ ms.assetid: 0ff5a4a4-fcc9-47a0-a4d8-8af9cf2815f6 > 'base class' : managed or WinRTclasses only support public inheritance +## Remarks + An attempt was made to use a managed or WinRT class as a [private](../../cpp/private-cpp.md) or [protected](../../cpp/protected-cpp.md) base class. A managed or WinRT class can only be used as a base class with [public](../../cpp/public-cpp.md) access. +## Example + The following sample generates C3628 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3630.md b/docs/error-messages/compiler-errors-2/compiler-error-c3630.md index d5fd6878985..bdf21ce943c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3630.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3630.md @@ -10,4 +10,6 @@ ms.assetid: 865626a9-98cc-465d-acde-44d4574c019a > error when processing the token '*token*' +## Remarks + A token in source code couldn't be processed. This error is obsolete in Visual Studio 2022. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3631.md b/docs/error-messages/compiler-errors-2/compiler-error-c3631.md index 2a5e40598f0..33edb019d62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3631.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3631.md @@ -10,6 +10,8 @@ ms.assetid: 88cbd2d5-6fef-4940-be34-d8cbe816d3da > 'function': cannot overload managed or WinRT events +## Remarks + A managed or WinRT event cannot be overloaded. C3631 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3632.md b/docs/error-messages/compiler-errors-2/compiler-error-c3632.md index 3a668cbc40a..c207383e3c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3632.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3632.md @@ -10,6 +10,8 @@ ms.assetid: a04e3217-f5a1-4461-a1db-d69fd096d468 > 'event': illegal style of event for construct +## Remarks + [__event](../../cpp/event.md) declarations are not valid in all constructs. C3632 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md index d5de0178bf3..76a7e89f50a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md @@ -10,6 +10,8 @@ ms.assetid: 7d65babf-2191-4d67-a69f-f5c4c2ddf946 > cannot define 'member' as a member of managed 'type' +## Remarks + CLR reference class data members cannot be of a non-POD C++ type. You can only instantiate a POD native type in a CLR type. For example, a POD type cannot contain a copy constructor or an assignment operator. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md index bab9d179fe2..40c22e81260 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md @@ -10,6 +10,8 @@ ms.assetid: fd09f10c-f863-483b-9756-71c16b760b02 > 'function' : cannot define an abstract method of a managed or WinRTclass +## Remarks + An abstract method can be declared in a managed or WinRT class, but it cannot be defined. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md index 088b7d1b62f..119cffd6104 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md @@ -10,8 +10,12 @@ ms.assetid: 72391377-8519-43d9-870a-73a6423deb74 > 'function' : a friend function definition cannot be a specialization of a function type +## Remarks + A friend function was defined incorrectly for a template or generic. +## Examples + The following sample generates C3637: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md index 66fbde51077..d84f91f08c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md @@ -10,10 +10,14 @@ ms.assetid: 8d8bc5ca-75aa-480e-b6b6-3178fab51b1d > 'operator' : the standard boxing and unboxing conversion operators cannot be redefined +## Remarks + The compiler defines a conversion operator for each managed class to support implicit boxing. This operator cannot be redefined. For more information, see [Implicit Boxing](../../extensions/boxing-cpp-component-extensions.md). +## Example + The following sample generates C3638: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md index 4649fc4e55a..4313d004db4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md @@ -10,8 +10,12 @@ ms.assetid: fcc56894-0f98-48af-8561-3bf7c7b2b93f > 'member' : a referenced or virtual member function of a local class must be defined +## Remarks + The compiler requires certain functions to be defined. +## Example + The following sample generates C3640: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md index eea469a9635..d7e6d038c32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md @@ -10,12 +10,16 @@ ms.assetid: 429790c2-9614-4d85-b31c-687c8d8f83ff > 'return_type/args' : cannot call a function with __clrcall calling convention from native code +## Remarks + A function that is marked with the [__clrcall](../../cpp/clrcall.md) calling convention cannot be called from native (unmanaged) code. *return_type/args* is either the name of the function or the type of the `__clrcall` function you are trying to call. A type is used when you're calling through a function-pointer. To call a managed function from a native context, you can add a "wrapper" function that will call the `__clrcall` function. Or, you can use the CLR marshalling mechanism; see [How to: Marshal Function Pointers Using PInvoke](../../dotnet/how-to-marshal-function-pointers-using-pinvoke.md) for more information. +## Example + The following sample generates C3642: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md index f9b30740448..1d98e0a3c0d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md @@ -10,8 +10,12 @@ ms.assetid: 2e3f6c41-3ec5-4a01-82bc-f11b61ebe68e > 'function' : cannot compile the function to generate managed code +## Remarks + The presence of some keywords in a function will cause the function to be compiled to native. +## Example + The following sample generates C3644: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md index 927d386ebe6..9680cb0c6a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md @@ -10,6 +10,8 @@ ms.assetid: 346da528-ae86-4cd0-9654-f41bee26ac0d > 'function' : __clrcall cannot be used on functions compiled to native code +## Remarks + The presence of some keywords in a function will cause the function to be compiled to native. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md index 97e5c7ef78c..00c21a02826 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md @@ -10,6 +10,8 @@ ms.assetid: 5d042989-41cb-4cd0-aa50-976b70146aaf > this explicit override syntax requires /clr:oldSyntax +## Remarks + When compiling for the latest managed syntax, the compiler found explicit override syntax for previous versions that is no longer supported. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md index d0862ee7894..7ceb8d21807 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md @@ -10,10 +10,14 @@ ms.assetid: ca4d8de4-b027-4d13-9b9f-03ca62905c33 > 'interface_method' : cannot be used as an explicit override, must be a virtual member function of a base class +## Remarks + An attempt was made to perform an explicit override on a member that was not virtual. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). +## Example + The following sample generates C3650: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md index d45f2f5ff4f..3e018e007a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md @@ -10,10 +10,14 @@ ms.assetid: a03e692e-c219-4654-9827-8415cfa5a22d > 'member' : cannot be used as an explicit override, must be a member of a base class +## Remarks + An explicit override was specified, but the function being overridden was in a type that is not a base type. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). +## Example + The following sample generates C3651: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md index eea3742c87c..d9af55aa9f3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md @@ -10,8 +10,12 @@ ms.assetid: 15d68737-177e-41f1-80e0-7c3e2afdf0fc > 'override' : a function that explicitly overrides must be virtual +## Remarks + A function that does an explicit override must be virtual. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). +## Example + The following sample generates C3652: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md index 8e92aba881e..07d707f73db 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md @@ -10,8 +10,12 @@ ms.assetid: 316549d7-f7ef-4578-a2ba-57adc8aac527 > 'function' : cannot be used as a named override: a function being overridden not found; did you forget to name the function explicitly, using a :: operator? +## Remarks + An explicit override specified a function that was not found in any interface. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). +## Example + The following sample generates C3653: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md index 7bd4b889fd3..0d479676826 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md @@ -10,8 +10,12 @@ ms.assetid: 57d96e3f-6bbb-4eaa-934b-26c23b4ceb2e > 'text' : syntax error in explicit override +## Remarks + An unexpected string was in an explicit override. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). +## Example + The following sample generates C3654: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md index ab81076fd9f..e4ca72aa278 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md @@ -10,8 +10,12 @@ ms.assetid: 724919ab-2915-4b61-8794-44648e162d62 > 'function' : function already explicitly overridden +## Remarks + A function can only be explicitly overridden once. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). +## Example + The following sample generates C3655: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md index 9c9ca2d6938..e646f7c3614 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md @@ -10,8 +10,12 @@ ms.assetid: 88965d85-73b0-4b35-8020-0650c9c94cd8 > 'override' : override specifier cannot be repeated +## Remarks + An explicit override keyword can only be specified once. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). +## Example + The following sample generates C3656: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md index 319e5f044b5..f660008455d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md @@ -10,6 +10,8 @@ ms.assetid: 89a28a18-4c17-43a1-bda6-deb52c32d203 > destructors cannot explicitly override or be explicitly overridden +## Remarks + Destructors or finalizers cannot be explicitly overridden. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). ## Example From 5125f6b1dfaf1bef8ce95d089fb19ce222cae9cf Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 21:08:15 +0800 Subject: [PATCH 0878/1799] Replace term "sample" with "example" for error references in range [C3621, C3660] --- docs/error-messages/compiler-errors-2/compiler-error-c3622.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3623.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3624.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3625.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3626.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3628.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3633.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3634.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3637.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3638.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3640.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3641.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3642.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3644.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3645.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3646.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3648.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3650.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3651.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3652.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3653.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3654.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3655.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3656.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3657.md | 2 +- 25 files changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md index b3b2c187fe0..e3b41ab5864 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md @@ -16,7 +16,7 @@ An attempt was made to instantiate a class marked as [abstract](../../extensions ## Example -The following sample generates C3622. +The following example generates C3622. ```cpp // C3622.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md index 4e4b3c53054..6ea6f15a551 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md @@ -16,7 +16,7 @@ The use of bit fields is not permitted on variables in a managed or WinRT class. ## Example -The following sample generates C3623: +The following example generates C3623: ```cpp // C3623.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md index d93c446fc01..537d9e64c13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md @@ -16,7 +16,7 @@ An assembly (reference) needed to compile your code was not specified; pass the ## Example -The following sample generates C3624: +The following example generates C3624: ```cpp // C3624.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md index f7fe9d766fa..f5b05cf770e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md @@ -16,7 +16,7 @@ A native class cannot inherit from a managed or WinRT class. For more informatio ## Example -The following sample generates C3625: +The following example generates C3625: ```cpp // C3625.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md index 52dba53506b..b38c1f7a20a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md @@ -16,7 +16,7 @@ A keyword was used incorrectly. ## Example -The following sample generates C3626: +The following example generates C3626: ```cpp // C3626.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md index b10c0713beb..9ca5a272937 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md @@ -16,7 +16,7 @@ An attempt was made to use a managed or WinRT class as a [private](../../cpp/pri ## Example -The following sample generates C3628 and shows how to fix it: +The following example generates C3628 and shows how to fix it: ```cpp // C3628a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md index 76a7e89f50a..e603b896c04 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md @@ -16,7 +16,7 @@ CLR reference class data members cannot be of a non-POD C++ type. You can only ## Example -The following sample generates C3633. +The following example generates C3633. ```cpp // C3633.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md index 40c22e81260..787b90ce290 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md @@ -16,7 +16,7 @@ An abstract method can be declared in a managed or WinRT class, but it cannot be ## Example -The following sample generates C3634: +The following example generates C3634: ```cpp // C3634.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md index 119cffd6104..52531f294ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md @@ -16,7 +16,7 @@ A friend function was defined incorrectly for a template or generic. ## Examples -The following sample generates C3637: +The following example generates C3637: ```cpp // C3637.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md index d84f91f08c9..0d18010512e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md @@ -18,7 +18,7 @@ For more information, see [Implicit Boxing](../../extensions/boxing-cpp-componen ## Example -The following sample generates C3638: +The following example generates C3638: ```cpp // C3638.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md index 4313d004db4..3f97c573b34 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md @@ -16,7 +16,7 @@ The compiler requires certain functions to be defined. ## Example -The following sample generates C3640: +The following example generates C3640: ```cpp // C3640.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3641.md b/docs/error-messages/compiler-errors-2/compiler-error-c3641.md index fbca71d1025..c9daf91e69c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3641.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3641.md @@ -18,7 +18,7 @@ Only [__clrcall](../../cpp/clrcall.md) calling convention is allowed with [/clr: ## Example -The following sample generates C3641: +The following example generates C3641: ```cpp // C3641.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md index d7e6d038c32..eafc89e4b96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md @@ -20,7 +20,7 @@ To call a managed function from a native context, you can add a "wrapper" functi ## Example -The following sample generates C3642: +The following example generates C3642: ```cpp // C3642.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md index 1d98e0a3c0d..5a0efecd1f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md @@ -16,7 +16,7 @@ The presence of some keywords in a function will cause the function to be compil ## Example -The following sample generates C3644: +The following example generates C3644: ```cpp // C3644.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md index 9680cb0c6a8..0381a70fb92 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md @@ -16,7 +16,7 @@ The presence of some keywords in a function will cause the function to be compil ## Example -The following sample generates C3645. +The following example generates C3645. ```cpp // C3645.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3646.md b/docs/error-messages/compiler-errors-2/compiler-error-c3646.md index 21c1177f7d6..1ba2376114f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3646.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3646.md @@ -20,7 +20,7 @@ For more information, see [Override Specifiers](../../extensions/override-specif ## Example -The following sample generates C3646 and shows a way to fix it: +The following example generates C3646 and shows a way to fix it: ```cpp // C3646.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md index 00c21a02826..6aa5dfeb866 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md @@ -18,7 +18,7 @@ For more information, see [Explicit Overrides](../../extensions/explicit-overrid ## Example -The following sample generates C3648: +The following example generates C3648: ```cpp // C3648.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md index 7ceb8d21807..ca61195a30a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md @@ -18,7 +18,7 @@ For more information, see [Explicit Overrides](../../extensions/explicit-overrid ## Example -The following sample generates C3650: +The following example generates C3650: ```cpp // C3650.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md index 3e018e007a0..f93be6dc7b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md @@ -18,7 +18,7 @@ For more information, see [Explicit Overrides](../../extensions/explicit-overrid ## Example -The following sample generates C3651: +The following example generates C3651: ```cpp // C3651.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md index d9af55aa9f3..fa022bb25d0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md @@ -16,7 +16,7 @@ A function that does an explicit override must be virtual. For more information, ## Example -The following sample generates C3652: +The following example generates C3652: ```cpp // C3652.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md index 07d707f73db..d1938913e45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md @@ -16,7 +16,7 @@ An explicit override specified a function that was not found in any interface. F ## Example -The following sample generates C3653: +The following example generates C3653: ```cpp // C3653.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md index 0d479676826..66e66547b50 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md @@ -16,7 +16,7 @@ An unexpected string was in an explicit override. For more information, see [Exp ## Example -The following sample generates C3654: +The following example generates C3654: ```cpp // C3654.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md index e4ca72aa278..de7e4ad5899 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md @@ -16,7 +16,7 @@ A function can only be explicitly overridden once. For more information, see [Ex ## Example -The following sample generates C3655: +The following example generates C3655: ```cpp // C3655.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md index e646f7c3614..986b5ff0382 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md @@ -16,7 +16,7 @@ An explicit override keyword can only be specified once. For more information, s ## Example -The following sample generates C3656: +The following example generates C3656: ```cpp // C3656.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md index f660008455d..ee168627ab8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md @@ -16,7 +16,7 @@ Destructors or finalizers cannot be explicitly overridden. For more information, ## Example -The following sample generates C3657. +The following example generates C3657. ```cpp // C3657.cpp From 9b5ce4687aedf6cd2c294fdd0101b32c2571e34b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 21:12:56 +0800 Subject: [PATCH 0879/1799] Update metadata for error references in range [C3621, C3660] --- .../error-messages/compiler-errors-2/compiler-error-c3622.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3623.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3624.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3625.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3626.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3627.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3628.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3630.md | 3 +-- .../error-messages/compiler-errors-2/compiler-error-c3631.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3632.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3633.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3634.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3637.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3638.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3640.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3641.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3642.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3644.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3645.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3646.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3648.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3650.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3651.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3652.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3653.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3654.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3655.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3656.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3657.md | 5 ++--- 29 files changed, 57 insertions(+), 86 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md index e3b41ab5864..60241213166 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3622" title: "Compiler Error C3622" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3622" +ms.date: 11/04/2016 f1_keywords: ["C3622"] helpviewer_keywords: ["C3622"] -ms.assetid: 02836f78-0cf2-4947-b87e-710187d81014 --- # Compiler Error C3622 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md index 6ea6f15a551..f19e798bd68 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3623" title: "Compiler Error C3623" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3623" +ms.date: 11/04/2016 f1_keywords: ["C3623"] helpviewer_keywords: ["C3623"] -ms.assetid: a0341b45-062a-4f67-beb9-ba74201ed1ed --- # Compiler Error C3623 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md index 537d9e64c13..81196f32bb3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3624" title: "Compiler Error C3624" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3624" +ms.date: 11/04/2016 f1_keywords: ["C3624"] helpviewer_keywords: ["C3624"] -ms.assetid: eaac6a4f-eb11-4e4d-ab12-124ba995c5cf --- # Compiler Error C3624 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md index f5b05cf770e..46ae1ba8349 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3625" title: "Compiler Error C3625" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3625" +ms.date: 11/04/2016 f1_keywords: ["C3625"] helpviewer_keywords: ["C3625"] -ms.assetid: fdf49f21-d6b1-42f4-9eec-23b04ae8b4aa --- # Compiler Error C3625 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md index b38c1f7a20a..b28d6ad76c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3626" title: "Compiler Error C3626" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3626" +ms.date: 11/04/2016 f1_keywords: ["C3626"] helpviewer_keywords: ["C3626"] -ms.assetid: 43926e2b-1ba9-4a43-9343-c58449cbb336 --- # Compiler Error C3626 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3627.md b/docs/error-messages/compiler-errors-2/compiler-error-c3627.md index 0912c5d93fe..1512ff7a55f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3627.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3627.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3627" title: "Compiler Error C3627" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3627" +ms.date: 11/04/2016 f1_keywords: ["C3627"] helpviewer_keywords: ["C3627"] -ms.assetid: 905ad0a0-8c49-4187-b66e-b375f5a1fae5 --- # Compiler Error C3627 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md index 9ca5a272937..9ee013b88bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3628" title: "Compiler Error C3628" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3628" +ms.date: 11/04/2016 f1_keywords: ["C3628"] helpviewer_keywords: ["C3628"] -ms.assetid: 0ff5a4a4-fcc9-47a0-a4d8-8af9cf2815f6 --- # Compiler Error C3628 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3630.md b/docs/error-messages/compiler-errors-2/compiler-error-c3630.md index bdf21ce943c..26adba75358 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3630.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3630.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3630" title: "Compiler Error C3630" +description: "Learn more about: Compiler Error C3630" ms.date: 05/25/2022 f1_keywords: ["C3630"] helpviewer_keywords: ["C3630"] -ms.assetid: 865626a9-98cc-465d-acde-44d4574c019a --- # Compiler Error C3630 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3631.md b/docs/error-messages/compiler-errors-2/compiler-error-c3631.md index 33edb019d62..2feb0d3e348 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3631.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3631.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3631" title: "Compiler Error C3631" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3631" +ms.date: 11/04/2016 f1_keywords: ["C3631"] helpviewer_keywords: ["C3631"] -ms.assetid: 88cbd2d5-6fef-4940-be34-d8cbe816d3da --- # Compiler Error C3631 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3632.md b/docs/error-messages/compiler-errors-2/compiler-error-c3632.md index c207383e3c8..337489011a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3632.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3632.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3632" title: "Compiler Error C3632" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3632" +ms.date: 11/04/2016 f1_keywords: ["C3632"] helpviewer_keywords: ["C3632"] -ms.assetid: a04e3217-f5a1-4461-a1db-d69fd096d468 --- # Compiler Error C3632 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md index e603b896c04..acefca20c78 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3633" title: "Compiler Error C3633" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3633" +ms.date: 11/04/2016 f1_keywords: ["C3633"] helpviewer_keywords: ["C3633"] -ms.assetid: 7d65babf-2191-4d67-a69f-f5c4c2ddf946 --- # Compiler Error C3633 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md index 787b90ce290..5a003e3be6d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3634" title: "Compiler Error C3634" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3634" +ms.date: 11/04/2016 f1_keywords: ["C3634"] helpviewer_keywords: ["C3634"] -ms.assetid: fd09f10c-f863-483b-9756-71c16b760b02 --- # Compiler Error C3634 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md index 52531f294ce..0ff30315570 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3637" title: "Compiler Error C3637" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3637" +ms.date: 11/04/2016 f1_keywords: ["C3637"] helpviewer_keywords: ["C3637"] -ms.assetid: 72391377-8519-43d9-870a-73a6423deb74 --- # Compiler Error C3637 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md index 0d18010512e..0f0c2e3c61a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3638" title: "Compiler Error C3638" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3638" +ms.date: 11/04/2016 f1_keywords: ["C3638"] helpviewer_keywords: ["C3638"] -ms.assetid: 8d8bc5ca-75aa-480e-b6b6-3178fab51b1d --- # Compiler Error C3638 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md index 3f97c573b34..dae63059c1e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3640" title: "Compiler Error C3640" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3640" +ms.date: 11/04/2016 f1_keywords: ["C3640"] helpviewer_keywords: ["C3640"] -ms.assetid: fcc56894-0f98-48af-8561-3bf7c7b2b93f --- # Compiler Error C3640 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3641.md b/docs/error-messages/compiler-errors-2/compiler-error-c3641.md index c9daf91e69c..46835413dba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3641.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3641.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3641" title: "Compiler Error C3641" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3641" +ms.date: 11/04/2016 f1_keywords: ["C3641"] helpviewer_keywords: ["C3641"] -ms.assetid: e8d3613e-5e8d-46fe-a516-eb7d1de7cd21 --- # Compiler Error C3641 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md index eafc89e4b96..9ad9ca91d3e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3642" title: "Compiler Error C3642" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3642" +ms.date: 11/04/2016 f1_keywords: ["C3642"] helpviewer_keywords: ["C3642"] -ms.assetid: 429790c2-9614-4d85-b31c-687c8d8f83ff --- # Compiler Error C3642 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md index 5a0efecd1f8..78613404658 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3644" title: "Compiler Error C3644" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3644" +ms.date: 11/04/2016 f1_keywords: ["C3644"] helpviewer_keywords: ["C3644"] -ms.assetid: 2e3f6c41-3ec5-4a01-82bc-f11b61ebe68e --- # Compiler Error C3644 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md index 0381a70fb92..4667e877425 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3645" title: "Compiler Error C3645" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3645" +ms.date: 11/04/2016 f1_keywords: ["C3645"] helpviewer_keywords: ["C3645"] -ms.assetid: 346da528-ae86-4cd0-9654-f41bee26ac0d --- # Compiler Error C3645 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3646.md b/docs/error-messages/compiler-errors-2/compiler-error-c3646.md index 1ba2376114f..330b23f3339 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3646.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3646.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3646" title: "Compiler Error C3646" -ms.date: "06/14/2018" +description: "Learn more about: Compiler Error C3646" +ms.date: 06/14/2018 f1_keywords: ["C3646"] helpviewer_keywords: ["C3646"] -ms.assetid: 4391ead2-9637-4ca3-aeda-5a991b18d66d --- # Compiler Error C3646 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md index 6aa5dfeb866..0eacdf8cfcf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3648" title: "Compiler Error C3648" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3648" +ms.date: 11/04/2016 f1_keywords: ["C3648"] helpviewer_keywords: ["C3648"] -ms.assetid: 5d042989-41cb-4cd0-aa50-976b70146aaf --- # Compiler Error C3648 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md index ca61195a30a..7687b504002 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3650" title: "Compiler Error C3650" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3650" +ms.date: 11/04/2016 f1_keywords: ["C3650"] helpviewer_keywords: ["C3650"] -ms.assetid: ca4d8de4-b027-4d13-9b9f-03ca62905c33 --- # Compiler Error C3650 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md index f93be6dc7b5..05a811b6625 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3651" title: "Compiler Error C3651" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3651" +ms.date: 11/04/2016 f1_keywords: ["C3651"] helpviewer_keywords: ["C3651"] -ms.assetid: a03e692e-c219-4654-9827-8415cfa5a22d --- # Compiler Error C3651 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md index fa022bb25d0..d4cff5ba850 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3652" title: "Compiler Error C3652" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3652" +ms.date: 11/04/2016 f1_keywords: ["C3652"] helpviewer_keywords: ["C3652"] -ms.assetid: 15d68737-177e-41f1-80e0-7c3e2afdf0fc --- # Compiler Error C3652 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md index d1938913e45..0dff663b5c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3653" title: "Compiler Error C3653" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3653" +ms.date: 11/04/2016 f1_keywords: ["C3653"] helpviewer_keywords: ["C3653"] -ms.assetid: 316549d7-f7ef-4578-a2ba-57adc8aac527 --- # Compiler Error C3653 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md index 66e66547b50..f3cb4716ef2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3654" title: "Compiler Error C3654" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3654" +ms.date: 11/04/2016 f1_keywords: ["C3654"] helpviewer_keywords: ["C3654"] -ms.assetid: 57d96e3f-6bbb-4eaa-934b-26c23b4ceb2e --- # Compiler Error C3654 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md index de7e4ad5899..cca99c6c609 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3655" title: "Compiler Error C3655" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3655" +ms.date: 11/04/2016 f1_keywords: ["C3655"] helpviewer_keywords: ["C3655"] -ms.assetid: 724919ab-2915-4b61-8794-44648e162d62 --- # Compiler Error C3655 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md index 986b5ff0382..da9a9fb22c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3656" title: "Compiler Error C3656" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3656" +ms.date: 11/04/2016 f1_keywords: ["C3656"] helpviewer_keywords: ["C3656"] -ms.assetid: 88965d85-73b0-4b35-8020-0650c9c94cd8 --- # Compiler Error C3656 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md index ee168627ab8..155f032d990 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3657" title: "Compiler Error C3657" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3657" +ms.date: 11/04/2016 f1_keywords: ["C3657"] helpviewer_keywords: ["C3657"] -ms.assetid: 89a28a18-4c17-43a1-bda6-deb52c32d203 --- # Compiler Error C3657 From a82987b1ba60abd4f5e507f606c54b4addf1e731 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 21:41:50 +0800 Subject: [PATCH 0880/1799] Convert "Class" in title to lowercase in `basic_string` class reference --- docs/standard-library/basic-string-class.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 4cfe39831e2..286d9bdd9e9 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -1,5 +1,5 @@ --- -title: "basic_string Class" +title: "basic_string class" description: "API reference for the Standard C++ string class, `basic_string`." ms.date: 07/11/2023 f1_keywords: ["xstring/std::basic_string", "xstring/std::basic_string::allocator_type", "xstring/std::basic_string::const_iterator", "xstring/std::basic_string::const_pointer", "xstring/std::basic_string::const_reference", "xstring/std::basic_string::const_reverse_iterator", "xstring/std::basic_string::difference_type", "xstring/std::basic_string::iterator", "xstring/std::basic_string::npos", "xstring/std::basic_string::pointer", "xstring/std::basic_string::reference", "xstring/std::basic_string::reverse_iterator", "xstring/std::basic_string::size_type", "xstring/std::basic_string::traits_type", "xstring/std::basic_string::value_type", "xstring/std::basic_string::append", "xstring/std::basic_string::assign", "xstring/std::basic_string::at", "xstring/std::basic_string::back", "xstring/std::basic_string::begin", "xstring/std::basic_string::c_str", "xstring/std::basic_string::capacity", "xstring/std::basic_string::cbegin", "xstring/std::basic_string::cend", "xstring/std::basic_string::clear", "xstring/std::basic_string::compare", "xstring/std::basic_string::copy", "xstring/std::basic_string::crbegin", "xstring/std::basic_string::crend", "xstring/std::basic_string::_Copy_s", "xstring/std::basic_string::data", "xstring/std::basic_string::empty", "xstring/std::basic_string::end", "xstring/std::basic_string::erase", "xstring/std::basic_string::find", "xstring/std::basic_string::find_first_not_of", "xstring/std::basic_string::find_first_of", "xstring/std::basic_string::find_last_not_of", "xstring/std::basic_string::find_last_of", "xstring/std::basic_string::front", "xstring/std::basic_string::get_allocator", "xstring/std::basic_string::insert", "xstring/std::basic_string::length", "xstring/std::basic_string::max_size", "xstring/std::basic_string::pop_back", "xstring/std::basic_string::push_back", "xstring/std::basic_string::rbegin", "xstring/std::basic_string::rend", "xstring/std::basic_string::replace", "xstring/std::basic_string::reserve", "xstring/std::basic_string::resize", "xstring/std::basic_string::rfind", "xstring/std::basic_string::shrink_to_fit", "xstring/std::basic_string::size", "xstring/std::basic_string::substr", "xstring/std::basic_string::ends_with", "xstring/std::basic_string::starts_with", "xstring/std::basic_string::swap", 'xstring/std::literals::string_literals', 'std::literals::string_literals', 'string_literals', 'xstring/std::literals::string_literals::operator "s', 'std::literals::string_literals::operator s'] @@ -7,7 +7,7 @@ helpviewer_keywords: ["std::basic_string [C++]", "std::basic_string [C++], alloc ms.custom: devdivchpfy22 --- -# `basic_string` Class +# `basic_string` class The sequences controlled by an object of type `basic_string` are the Standard C++ string class and are referred to as strings, but they shouldn't be confused with the null-terminated C-style strings used throughout the C++ Standard Library. The Standard C++ string is a container that enables the use of strings as normal types, such as comparison and concatenation operations, iterators, C++ Standard Library algorithms, and copying and assigning with class allocator-managed memory. If you need to convert a Standard C++ string to a null-terminated C-style string, use the [`basic_string::c_str`](#c_str) member. From d7a7af8b136a70050d6783edbf1039cdfcada46b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 21:51:26 +0800 Subject: [PATCH 0881/1799] Add some backticks in `basic_string` class reference --- docs/standard-library/basic-string-class.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 286d9bdd9e9..0df3318f603 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -24,7 +24,7 @@ class basic_string; The data type of a single character to be stored in the string. The C++ Standard Library provides specializations of this class template, with the type definitions [`string`](../standard-library/string-typedefs.md#string) for elements of type `char`, [`wstring`](../standard-library/string-typedefs.md#wstring), for `wchar_t`, [`u16string`](../standard-library/string-typedefs.md#u16string) for `char16_t`, and [`u32string`](../standard-library/string-typedefs.md#u32string) for `char32_t`. *`Traits`*\ -Various important properties of the `CharType` elements in a basic_string specialization are described by the class `Traits`. The default value is `char_traits`<`CharType`>. +Various important properties of the `CharType` elements in a `basic_string` specialization are described by the class `Traits`. The default value is `char_traits`<`CharType`>. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the string's allocation and deallocation of memory. The default value is `allocator`. @@ -130,9 +130,9 @@ References, pointers, and iterators that designate elements of the controlled se ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## `basic_string::allocator_type` @@ -379,10 +379,10 @@ The source string whose characters are to be assigned to the target string. The character value to be assigned. *`first`*\ -An input iterator, const_pointer, or const_iterator addressing the first character in the range of the source string to be assigned to the target range. +An input iterator, `const_pointer`, or `const_iterator` addressing the first character in the range of the source string to be assigned to the target range. *`last`*\ -An input iterator, const_pointer, or const_iterator addressing the one beyond the last character in the range of the source string to be assigned to the target range. +An input iterator, `const_pointer`, or `const_iterator` addressing the one beyond the last character in the range of the source string to be assigned to the target range. *`off`*\ The position at which new characters will start to be assigned. @@ -662,10 +662,10 @@ The index of a character in a string that is the first to be used to initialize The character value to be copied into the string being constructed. *`first`*\ -An input iterator, const_pointer, or const_iterator addressing the first element in the source range to be inserted. +An input iterator, `const_pointer`, or `const_iterator` addressing the first element in the source range to be inserted. *`last`*\ -An input iterator, const_pointer, or const_iterator addressing the position of the one beyond the last element in the source range to be inserted. +An input iterator, `const_pointer`, or `const_iterator` addressing the position of the one beyond the last element in the source range to be inserted. ### Return value @@ -3908,10 +3908,10 @@ An iterator addressing the first character to be removed in the operand string. An iterator addressing the last character to be removed in the operand string. *`first`*\ -An iterator, const_pointer, or const_iterator addressing the first character to be copied in the parameter string. +An iterator, `const_pointer`, or `const_iterator` addressing the first character to be copied in the parameter string. *`last`*\ -An iterator, const_pointer, or const_iterator addressing the last character to be copied in the parameter string. +An iterator, `const_pointer`, or `const_iterator` addressing the last character to be copied in the parameter string. *`count`*\ The number of times *`char_value`* is copied into the operand string. From b49ef085cb9ac08eee3c4461cf85b025ceb581a0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 21:53:41 +0800 Subject: [PATCH 0882/1799] Rename "Parameters" heading with "Template parameters" in `basic_string` class reference --- docs/standard-library/basic-string-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 0df3318f603..efd53e9ef04 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -18,7 +18,7 @@ template , class Allocator class basic_string; ``` -### Parameters +### Template parameters *`CharType`*\ The data type of a single character to be stored in the string. The C++ Standard Library provides specializations of this class template, with the type definitions [`string`](../standard-library/string-typedefs.md#string) for elements of type `char`, [`wstring`](../standard-library/string-typedefs.md#wstring), for `wchar_t`, [`u16string`](../standard-library/string-typedefs.md#u16string) for `char16_t`, and [`u32string`](../standard-library/string-typedefs.md#u32string) for `char32_t`. From ba3cf7a685ecb1c522680c22582363515dc5209e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 22:15:32 +0800 Subject: [PATCH 0883/1799] Fix some typos in `basic_string` class reference --- docs/standard-library/basic-string-class.md | 28 ++++++++++----------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index efd53e9ef04..62bae2185c2 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -279,7 +279,7 @@ int main( ) // appending one string to another in two ways, // comparing append and operator [ ] string str1d ( "Hello " ), str2d ( "Wide " ), str3d ( "World " ); - cout << "The string str2d is: " << str2d << endl; + cout << "The string str2d is: " << str2d << endl; str1d.append ( str2d ); cout << "The appended string str1d is: " << str1d << "." << endl; @@ -316,7 +316,7 @@ Appending the 1st part of the C-string cstr1b to string str1 gives: Hello Out. The string str2c is: Wide World The appended string str1 is: Hello World. -The string str2d is: Wide +The string str2d is: Wide The appended string str1d is: Hello Wide . The doubly appended string str1 is: Hello Wide World . @@ -417,7 +417,7 @@ int main( ) << str1a << "." << endl << endl; // The second member function assigning a specific - // number of the of characters a C-string to a string + // number of the characters of a C-string to a string string str1b; const char *cstr1b = "Out There"; cout << "The C-string cstr1b is: " << cstr1b << endl; @@ -452,7 +452,7 @@ int main( ) // number of characters of a certain value to a string string str1e ( "Hello " ); str1e.assign ( 4 , '!' ); - cout << "The string str1 assigned with eclamations is: " + cout << "The string str1 assigned with exclamations is: " << str1e << endl << endl; // The sixth member function assigning the value from @@ -481,7 +481,7 @@ The string str1 newly assigned with string str2d is: Wide. The string str3d is: World. The string str1 reassigned with string str3d is: World. -The string str1 assigned with eclamations is: !!!! +The string str1 assigned with exclamations is: !!!! The string str2f is: Wide World The string str1 assigned a range of string str2f is: World. @@ -512,7 +512,7 @@ The first element of the string has an index of zero and the following elements The member [`operator[]`](#op_at) is faster than the member function `at` for providing read and write access to the elements of a string. -The member `operator[]` doesn't check whether the index passed as a parameter is valid but the member function `at` does and so should be used if the validity isn't certain. An invalid index, which is an index less that zero or greater than or equal to the size of the string, passed to the member function `at` throws an [`out_of_range` Class](../standard-library/out-of-range-class.md) exception. An invalid index passed to the `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null-character when passed this index. +The member `operator[]` doesn't check whether the index passed as a parameter is valid but the member function `at` does and so should be used if the validity isn't certain. An invalid index, which is an index less than zero or greater than or equal to the size of the string, passed to the member function `at` throws an [`out_of_range` Class](../standard-library/out-of-range-class.md) exception. An invalid index passed to the `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null-character when passed this index. The reference returned may be invalidated by string reallocations or modifications for the non-`const` strings. @@ -1079,7 +1079,7 @@ A negative value if the operand string is less than the parameter string; zero i ### Remarks -The `compare` member functions compare either all, or part, of the parameter and operand strings depending on which in used. +The `compare` member functions compare either all, or part, of the parameter and operand strings depending on which is used. The comparison is case-sensitive. @@ -1778,7 +1778,7 @@ int main( ) if ( str2.begin( ) == str2.end ( ) ) cout << "The string str2 is empty." << endl; else - cout << "The stringstr2 is not empty." << endl; + cout << "The string str2 is not empty." << endl; } ``` @@ -2447,7 +2447,7 @@ int main( ) << "position is: " << indexCh3b << endl << endl; else cout << "Elements of the substring '5G' were not " - << "found in str3\n after the first occurrrence." + << "found in str3\n after the first occurrence." << endl << endl; // The fourth member function searches a string @@ -3479,7 +3479,7 @@ The first element of the string has an index of zero, and the following elements `operator[]` is faster than the member function [`at`](#at) for providing read and write access to the elements of a string. -`operator[]` doesn't check whether the index passed as a parameter is valid, but the member function `at` does and so should be used in the validity isn't certain. An invalid index (an index less that zero or greater than or equal to the size of the string) passed to the member function `at` throws an [`out_of_range` Class](../standard-library/out-of-range-class.md) exception. An invalid index passed to `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null character when passed this index. +`operator[]` doesn't check whether the index passed as a parameter is valid, but the member function `at` does and so should be used if the validity isn't certain. An invalid index (an index less than zero or greater than or equal to the size of the string) passed to the member function `at` throws an [`out_of_range` Class](../standard-library/out-of-range-class.md) exception. An invalid index passed to `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null character when passed this index. The reference returned may be invalidated by string reallocations or modifications for the non-`const` strings. @@ -3690,7 +3690,7 @@ int main( ) if ( str2.rbegin( ) == str2.rend ( ) ) cout << "The string str2 is empty." << endl; else - cout << "The stringstr2 is not empty." << endl; + cout << "The string str2 is not empty." << endl; } ``` @@ -3788,7 +3788,7 @@ int main( ) if ( str2.rbegin( ) == str2.rend ( ) ) cout << "The string str2 is empty." << endl; else - cout << "The stringstr2 is not empty." << endl; + cout << "The string str2 is not empty." << endl; } ``` @@ -4151,7 +4151,7 @@ int main( ) sizerStr1 = str1.size ( ); caprStr1 = str1.capacity ( ); - cout << "The string str1with augmented capacity is: " + cout << "The string str1 with augmented capacity is: " << str1 << endl; cout << "The current size of string str1 is: " << sizerStr1 << "." << endl; @@ -4180,7 +4180,7 @@ The original string str1 is: Hello world The current size of original string str1 is: 11. The capacity of original string str1 is: 15. -The string str1with augmented capacity is: Hello world +The string str1 with augmented capacity is: Hello world The current size of string str1 is: 11. The new capacity of string str1 is: 47. From 85624a1cd71bba30de6cc4d3e211ac7f5f89ec46 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 22:18:44 +0800 Subject: [PATCH 0884/1799] Fix literals and `compare` syntax in `basic_string` class reference --- docs/standard-library/basic-string-class.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 62bae2185c2..24e87722de5 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -117,7 +117,7 @@ The headers that define `basic_string` also define the following [user-defined l | Declaration | Description | |--|--| | `inline string operator"" s(const char* str, size_t len)` | Returns: `string(str, len)` | -| `inline string operator"" s(const wchar_t* str, size_t len)` | Returns: `wstring(str, len)` | +| `inline wstring operator"" s(const wchar_t* str, size_t len)` | Returns: `wstring(str, len)` | | `inline basic_string operator"" s(const char8_t* str, size_t len)` | Returns: `basic_string(str, len)` | | `inline u16string operator"" s(const char16_t* str, size_t len)` | Returns: `u16string(str, len)` | | `inline u32string operator"" s(const char32_t* str, size_t len)` | Returns: `u32string(str, len)` | @@ -1046,7 +1046,7 @@ int compare( int compare( size_type position_1, size_type number_1, - const value_type* ptr + const value_type* ptr, size_type number_2) const; ``` From a81ce6c70b19d61392d23c15b876615443ae8f16 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 22:22:13 +0800 Subject: [PATCH 0885/1799] Clean up redundant relative links in `basic_string` class reference --- docs/standard-library/basic-string-class.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 24e87722de5..bb063741d04 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -21,7 +21,7 @@ class basic_string; ### Template parameters *`CharType`*\ -The data type of a single character to be stored in the string. The C++ Standard Library provides specializations of this class template, with the type definitions [`string`](../standard-library/string-typedefs.md#string) for elements of type `char`, [`wstring`](../standard-library/string-typedefs.md#wstring), for `wchar_t`, [`u16string`](../standard-library/string-typedefs.md#u16string) for `char16_t`, and [`u32string`](../standard-library/string-typedefs.md#u32string) for `char32_t`. +The data type of a single character to be stored in the string. The C++ Standard Library provides specializations of this class template, with the type definitions [`string`](string-typedefs.md#string) for elements of type `char`, [`wstring`](string-typedefs.md#wstring), for `wchar_t`, [`u16string`](string-typedefs.md#u16string) for `char16_t`, and [`u32string`](string-typedefs.md#u32string) for `char32_t`. *`Traits`*\ Various important properties of the `CharType` elements in a `basic_string` specialization are described by the class `Traits`. The default value is `char_traits`<`CharType`>. @@ -124,7 +124,7 @@ The headers that define `basic_string` also define the following [user-defined l ## Remarks -If a function is asked to generate a sequence longer than [`max_size`](#max_size) elements, the function reports a length error by throwing an object of type [`length_error`](../standard-library/length-error-class.md). +If a function is asked to generate a sequence longer than [`max_size`](#max_size) elements, the function reports a length error by throwing an object of type [`length_error`](length-error-class.md). References, pointers, and iterators that designate elements of the controlled sequence can become invalid after any call to a function that alters the controlled sequence, or after the first call to a non-`const` member function. @@ -512,7 +512,7 @@ The first element of the string has an index of zero and the following elements The member [`operator[]`](#op_at) is faster than the member function `at` for providing read and write access to the elements of a string. -The member `operator[]` doesn't check whether the index passed as a parameter is valid but the member function `at` does and so should be used if the validity isn't certain. An invalid index, which is an index less than zero or greater than or equal to the size of the string, passed to the member function `at` throws an [`out_of_range` Class](../standard-library/out-of-range-class.md) exception. An invalid index passed to the `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null-character when passed this index. +The member `operator[]` doesn't check whether the index passed as a parameter is valid but the member function `at` does and so should be used if the validity isn't certain. An invalid index, which is an index less than zero or greater than or equal to the size of the string, passed to the member function `at` throws an [`out_of_range` Class](out-of-range-class.md) exception. An invalid index passed to the `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null-character when passed this index. The reference returned may be invalidated by string reallocations or modifications for the non-`const` strings. @@ -3200,7 +3200,7 @@ The maximum number of characters a string could contain. ### Remarks -An exception of type [`length_error` Class](../standard-library/length-error-class.md) is thrown when an operation produces a string with a length greater than the maximum size. +An exception of type [`length_error` Class](length-error-class.md) is thrown when an operation produces a string with a length greater than the maximum size. ### Example @@ -3479,11 +3479,11 @@ The first element of the string has an index of zero, and the following elements `operator[]` is faster than the member function [`at`](#at) for providing read and write access to the elements of a string. -`operator[]` doesn't check whether the index passed as a parameter is valid, but the member function `at` does and so should be used if the validity isn't certain. An invalid index (an index less than zero or greater than or equal to the size of the string) passed to the member function `at` throws an [`out_of_range` Class](../standard-library/out-of-range-class.md) exception. An invalid index passed to `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null character when passed this index. +`operator[]` doesn't check whether the index passed as a parameter is valid, but the member function `at` does and so should be used if the validity isn't certain. An invalid index (an index less than zero or greater than or equal to the size of the string) passed to the member function `at` throws an [`out_of_range` Class](out-of-range-class.md) exception. An invalid index passed to `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null character when passed this index. The reference returned may be invalidated by string reallocations or modifications for the non-`const` strings. -When compiling with [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md) set to 1 or 2, a runtime error will occur if you attempt to access an element outside the bounds of the string. For more information, see [Checked Iterators](../standard-library/checked-iterators.md). +When compiling with [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md) set to 1 or 2, a runtime error will occur if you attempt to access an element outside the bounds of the string. For more information, see [Checked Iterators](checked-iterators.md). ### Example @@ -4805,7 +4805,7 @@ For type `string`, it's equivalent to `char_traits`. ### Example -See the example for [`copy`](../standard-library/char-traits-struct.md#copy) for an example of how to declare and use `traits_type`. +See the example for [`copy`](char-traits-struct.md#copy) for an example of how to declare and use `traits_type`. ## `basic_string::value_type` @@ -4847,5 +4847,5 @@ The character ch2 is: H. ## See also -[``](../standard-library/string.md)\ -[Thread safety in the C++ standard library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[``](string.md)\ +[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md) From 7de1088101a79256c18430bbc1f04358a6ab9047 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 22:33:13 +0800 Subject: [PATCH 0886/1799] Add blockquotes for error messages in range [C3661, C3710] --- docs/error-messages/compiler-errors-2/compiler-error-c3661.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3662.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3665.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3666.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3668.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3669.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3670.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3671.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3672.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3673.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3675.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3697.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3698.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3699.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3701.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3702.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3703.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3704.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3705.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3706.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3707.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3708.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3709.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3710.md | 2 +- 24 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3661.md b/docs/error-messages/compiler-errors-2/compiler-error-c3661.md index 8f0e21753b5..c814fa42a67 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3661.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3661.md @@ -8,7 +8,7 @@ ms.assetid: 50793fd1-1829-4b29-ad0d-094ef2068b43 --- # Compiler Error C3661 -explicit override list did not find any methods to override +> explicit override list did not find any methods to override An explicit override specified one or more type names. However, there was no function with the necessary signature in the type(s) that matched the overriding function's signature. If you attempt to override based on type name, there must be one or more virtual functions in the specified type(s) that match the signature of the overriding function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md index 6ba37b24059..68824854ab6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md @@ -8,7 +8,7 @@ ms.assetid: 61bd3e41-a86b-42c0-be89-d992d3906ff1 --- # Compiler Error C3662 -'member' : override specifier 'specifier' only allowed on member functions of managed or WinRT classes +> 'member' : override specifier 'specifier' only allowed on member functions of managed or WinRT classes An override specifier was used on a member of native type, which is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md index 936a2255bf1..aba871e8bbb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md @@ -8,7 +8,7 @@ ms.assetid: 893bb47e-8de1-43aa-af7d-fa47ad149ee9 --- # Compiler Error C3665 -'destructor' : override specifier 'keyword' not allowed on a destructor/finalizer +> 'destructor' : override specifier 'keyword' not allowed on a destructor/finalizer A keyword was used that is not allowed on a destructor or finalizer. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md index c2aa130de78..de42346d9f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md @@ -8,7 +8,7 @@ ms.assetid: 459e51dd-cefb-4346-99b3-644f2d8b65b2 --- # Compiler Error C3666 -'constructor' : override specifier 'keyword' not allowed on a constructor +> 'constructor' : override specifier 'keyword' not allowed on a constructor An override specifier was used on a constructor, and that is not allowed. For more information, see [Override Specifiers](../../extensions/override-specifiers-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md index 079daf488b1..24dd6db8f32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md @@ -8,7 +8,7 @@ ms.assetid: 53a96698-bde4-4447-95b5-b5108291f60c --- # Compiler Error C3668 -'method' : method with override specifier 'override' did not override any base class methods +> 'method' : method with override specifier 'override' did not override any base class methods A function attempted to override a non-existent function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md index 4b1fcf62295..4c929833b3f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md @@ -8,7 +8,7 @@ ms.assetid: be9c7ae4-e96f-47ab-922a-39a3537d5ca6 --- # Compiler Error C3669 -'member' : override specifier 'override' not allowed on static member functions or constructors +> 'member' : override specifier 'override' not allowed on static member functions or constructors An override was specified incorrectly. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md index 6c0d1e1786d..54e1c0cde7e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md @@ -8,7 +8,7 @@ ms.assetid: d0fa9c6e-8f90-48c7-9066-31b4fa5942eb --- # Compiler Error C3670 -'override' : cannot override inaccessible base class method 'method' +> 'override' : cannot override inaccessible base class method 'method' An override can only take place on a function whose access level makes it available in a derived type. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md index 8a310719b59..7fa3f97c91a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md @@ -8,7 +8,7 @@ ms.assetid: d684e4ae-87e2-4424-80bb-6f346652c831 --- # Compiler Error C3671 -'function_1' : function does not override 'function_2' +> 'function_1' : function does not override 'function_2' When using explicit override syntax, the compiler generates an error if a function is not overridden. See [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3672.md b/docs/error-messages/compiler-errors-2/compiler-error-c3672.md index d217e41c36b..aefac392f9f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3672.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3672.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3672"] --- # Compiler Error C3672 -pseudo-destructor expression can only be used as part of a function call +> pseudo-destructor expression can only be used as part of a function call A destructor was called incorrectly. For more information, see [Destructors](../../cpp/destructors-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md index 80458100b76..9c9130ccba6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md @@ -8,7 +8,7 @@ ms.assetid: bb6d2079-05af-4e2c-be0e-75c892e6c590 --- # Compiler Error C3673 -'type' : class does not have a copy-constructor +> 'type' : class does not have a copy-constructor A user-defined constructor is needed to copy objects of CLR ref types. For more information, see [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md index 8ef0cbf41f7..9eb8ba63e49 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md @@ -8,7 +8,7 @@ ms.assetid: 87461613-6633-430b-b95d-c7cb1bb63776 --- # Compiler Error C3675 -'function' : is reserved because 'property' is defined +> 'function' : is reserved because 'property' is defined When you declare a simple property, the compiler generates the get and set accessor methods, and those names are present in the scope of your program. The compiler-generated names are formed by prepending get_ and set_ to the property name. Therefore, you cannot declare functions with the same name as the compiler-generated accessors. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md index aa3cb7f3396..c453a531835 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md @@ -8,7 +8,7 @@ ms.assetid: 2d3f63c4-b7f8-421d-a7a5-2bf17fd054f9 --- # Compiler Error C3697 -'qualifier' : cannot use this qualifier on '^' +> 'qualifier' : cannot use this qualifier on '^' The tracking handle (^) was applied to a qualifier for which it was not designed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md index f3be544edad..f8527b12388 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md @@ -8,7 +8,7 @@ ms.assetid: 3c02fb08-7ba4-4637-a06f-19926cb2b5f1 --- # Compiler Error C3698 -'type' : cannot use this type as argument of 'operator' +> 'type' : cannot use this type as argument of 'operator' A managed object was declared incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md index 98d2020bbf0..ccb0d4ebabd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md @@ -8,7 +8,7 @@ ms.assetid: 47c29afc-ab8b-4238-adfe-788dd6e00b3b --- # Compiler Error C3699 -'operator' : cannot use this indirection on type 'type' +> 'operator' : cannot use this indirection on type 'type' An attempt was made to use indirection that is not allowed on `type`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md index 5ddae9dc5cf..664bd89b8b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md @@ -8,7 +8,7 @@ ms.assetid: a7faaa87-d2f5-4d6a-9a2f-5cab2d24a648 --- # Compiler Error C3701 -'function' : event_source has no events +> 'function' : event_source has no events You attempted to use [event_source](../../windows/attributes/event-source.md) on a class that has no event methods. To fix this error, add one or more events to the class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md index c405d39324e..10662fdfd39 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md @@ -8,7 +8,7 @@ ms.assetid: 14fcc20e-4404-45d7-be54-e4f09332fa5a --- # Compiler Error C3702 -'function' : ATL is required for COM events +> 'function' : ATL is required for COM events You attempted to use COM events without including the necessary ATL header files. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md index 674971f02c2..08331599d6d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md @@ -8,7 +8,7 @@ ms.assetid: 7e3677d9-f2be-4c26-998f-423564e9023c --- # Compiler Error C3703 -'event handler': an event handler method must have the same storage class as the source 'event' +> 'event handler': an event handler method must have the same storage class as the source 'event' An [event](../../cpp/event-handling.md) has a different storage class than the event handler to which it is hooked. For example, this error occurs if the event handler is a static member function and the event is not static. To fix this error, give the event and the event handler the same storage class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md index 619885fc8a2..9865071ac3d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md @@ -8,7 +8,7 @@ ms.assetid: ee40ea35-a214-4dec-9489-d7f155dd0ac2 --- # Compiler Error C3704 -'function' : a vararg method cannot fire events +> 'function' : a vararg method cannot fire events You attempted to use [__event](../../cpp/event.md) on a vararg method. To fix this error, replace the `fireEvent(int i, ...)` call with the `fireEvent(int i)` call as shown in the following code sample. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md index d0aafaf4e3d..44622e50c94 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md @@ -8,7 +8,7 @@ ms.assetid: 8361017d-5782-4214-a9d7-e9825fd29bc8 --- # Compiler Error C3705 -'function' : cannot find eventing interface +> 'function' : cannot find eventing interface You must define an event interface to use COM events. Note that the `#include` lines of the ATL header files shown in the sample below are required for using COM events. To fix this error, uncomment the definition of the `IEvents` interface in the sample code. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md index 82e34020d09..2e6afef7b60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md @@ -8,7 +8,7 @@ ms.assetid: d20a33eb-d625-46c5-ac87-32075a590d07 --- # Compiler Error C3706 -'function' : must be a COM interface to fire COM events +> 'function' : must be a COM interface to fire COM events The event interface that you use to fire COM events must be a COM interface. In this situation, the interface should either be defined using a Visual C++ attribute, or imported using [#import](../../preprocessor/hash-import-directive-cpp.md) from a type library with #import's embedded_idl attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md index 66e76dcccbd..c0e67e907fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md @@ -8,7 +8,7 @@ ms.assetid: ac63a5dd-7a4b-48d2-9f2a-be9cb090134c --- # Compiler Error C3707 -'function' : dispinterface method must have a dispid +> 'function' : dispinterface method must have a dispid If you use a `dispinterface` method, you must assign it a `dispid`. To fix this error, assign a `dispid` to the `dispinterface` method, for example, by uncommenting the `id` attribute on the method in the sample below. For more information, see the attributes [dispinterface](../../windows/attributes/dispinterface.md) and [id](../../windows/attributes/id.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md index 4d171cc1b67..107e72c845d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md @@ -8,7 +8,7 @@ ms.assetid: 45e71564-9c7f-437f-98d8-a735ce162ed0 --- # Compiler Error C3708 -'interface': improper use of 'keyword'; must be a member of a compatible event source +> 'interface': improper use of 'keyword'; must be a member of a compatible event source To declare an interface as an event, the event declaration must be in an event source. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md index c357f96034f..33dd4d47f58 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md @@ -8,7 +8,7 @@ ms.assetid: d5576b04-2f93-420a-8f3e-8b8e987e8dab --- # Compiler Error C3709 -'function': improper syntax for specifying event in __hook/\__unhook +> 'function': improper syntax for specifying event in __hook/\__unhook When you specify an event source with [__hook](../../cpp/hook.md) or [__unhook](../../cpp/unhook.md), the first parameter must be a valid event method and the second parameter must be a valid event source object (not a method). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md index a3e0b13c6c7..9c9ff72fcf3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md @@ -8,7 +8,7 @@ ms.assetid: 18bec009-5b6f-464a-a21e-5d58a6936504 --- # Compiler Error C3710 -'function': improper syntax for specifying event handler in __hook/\__unhook +> 'function': improper syntax for specifying event handler in __hook/\__unhook When you specify an event handler with [__hook](../../cpp/hook.md) or [__unhook](../../cpp/unhook.md), the handler must be a valid method. From bcdee70f048094840ab2c14ecea1f6204aa3facd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 22:37:46 +0800 Subject: [PATCH 0887/1799] Add "Remarks" and "Example" headings for error references in range [C3661, C3710] --- docs/error-messages/compiler-errors-2/compiler-error-c3661.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3662.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3665.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3666.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3668.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3669.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3670.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3671.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3672.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3673.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3675.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3697.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3698.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3699.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3701.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3702.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3703.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3704.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3705.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3706.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3707.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3708.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3709.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3710.md | 2 ++ 24 files changed, 74 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3661.md b/docs/error-messages/compiler-errors-2/compiler-error-c3661.md index c814fa42a67..a17a5373a45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3661.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3661.md @@ -10,6 +10,8 @@ ms.assetid: 50793fd1-1829-4b29-ad0d-094ef2068b43 > explicit override list did not find any methods to override +## Remarks + An explicit override specified one or more type names. However, there was no function with the necessary signature in the type(s) that matched the overriding function's signature. If you attempt to override based on type name, there must be one or more virtual functions in the specified type(s) that match the signature of the overriding function. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md index 68824854ab6..83d66983951 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md @@ -10,6 +10,8 @@ ms.assetid: 61bd3e41-a86b-42c0-be89-d992d3906ff1 > 'member' : override specifier 'specifier' only allowed on member functions of managed or WinRT classes +## Remarks + An override specifier was used on a member of native type, which is not allowed. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md index aba871e8bbb..bf01a1b641a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md @@ -10,10 +10,14 @@ ms.assetid: 893bb47e-8de1-43aa-af7d-fa47ad149ee9 > 'destructor' : override specifier 'keyword' not allowed on a destructor/finalizer +## Remarks + A keyword was used that is not allowed on a destructor or finalizer. For example, a new slot cannot be requested on a destructor or finalizer. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md) and [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). +## Example + The following sample generates C3665: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md index de42346d9f8..11e8e88bde7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md @@ -10,6 +10,8 @@ ms.assetid: 459e51dd-cefb-4346-99b3-644f2d8b65b2 > 'constructor' : override specifier 'keyword' not allowed on a constructor +## Remarks + An override specifier was used on a constructor, and that is not allowed. For more information, see [Override Specifiers](../../extensions/override-specifiers-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md index 24dd6db8f32..a1a25fe02c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md @@ -10,6 +10,8 @@ ms.assetid: 53a96698-bde4-4447-95b5-b5108291f60c > 'method' : method with override specifier 'override' did not override any base class methods +## Remarks + A function attempted to override a non-existent function. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md index 4c929833b3f..2c6ad6f0222 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md @@ -10,6 +10,8 @@ ms.assetid: be9c7ae4-e96f-47ab-922a-39a3537d5ca6 > 'member' : override specifier 'override' not allowed on static member functions or constructors +## Remarks + An override was specified incorrectly. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md index 54e1c0cde7e..886c65a0eef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md @@ -10,8 +10,12 @@ ms.assetid: d0fa9c6e-8f90-48c7-9066-31b4fa5942eb > 'override' : cannot override inaccessible base class method 'method' +## Remarks + An override can only take place on a function whose access level makes it available in a derived type. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). +## Example + The following sample generates C3670: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md index 7fa3f97c91a..3be2133e593 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md @@ -10,6 +10,8 @@ ms.assetid: d684e4ae-87e2-4424-80bb-6f346652c831 > 'function_1' : function does not override 'function_2' +## Remarks + When using explicit override syntax, the compiler generates an error if a function is not overridden. See [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3672.md b/docs/error-messages/compiler-errors-2/compiler-error-c3672.md index aefac392f9f..7317008d9c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3672.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3672.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C3672"] > pseudo-destructor expression can only be used as part of a function call +## Remarks + A destructor was called incorrectly. For more information, see [Destructors](../../cpp/destructors-cpp.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md index 9c9130ccba6..a60df380165 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md @@ -10,6 +10,8 @@ ms.assetid: bb6d2079-05af-4e2c-be0e-75c892e6c590 > 'type' : class does not have a copy-constructor +## Remarks + A user-defined constructor is needed to copy objects of CLR ref types. For more information, see [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md index 9eb8ba63e49..a130f469ea4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md @@ -10,6 +10,8 @@ ms.assetid: 87461613-6633-430b-b95d-c7cb1bb63776 > 'function' : is reserved because 'property' is defined +## Remarks + When you declare a simple property, the compiler generates the get and set accessor methods, and those names are present in the scope of your program. The compiler-generated names are formed by prepending get_ and set_ to the property name. Therefore, you cannot declare functions with the same name as the compiler-generated accessors. See [property](../../extensions/property-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md index c453a531835..64a527be4f4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md @@ -10,8 +10,12 @@ ms.assetid: 2d3f63c4-b7f8-421d-a7a5-2bf17fd054f9 > 'qualifier' : cannot use this qualifier on '^' +## Remarks + The tracking handle (^) was applied to a qualifier for which it was not designed. +## Example + The following sample generates C3697: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md index f8527b12388..501ade0b1a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md @@ -10,8 +10,12 @@ ms.assetid: 3c02fb08-7ba4-4637-a06f-19926cb2b5f1 > 'type' : cannot use this type as argument of 'operator' +## Remarks + A managed object was declared incorrectly. +## Example + The following sample generates C3698: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md index ccb0d4ebabd..55f0f9676bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md @@ -10,6 +10,8 @@ ms.assetid: 47c29afc-ab8b-4238-adfe-788dd6e00b3b > 'operator' : cannot use this indirection on type 'type' +## Remarks + An attempt was made to use indirection that is not allowed on `type`. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md index 664bd89b8b8..227ec1555da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md @@ -10,8 +10,12 @@ ms.assetid: a7faaa87-d2f5-4d6a-9a2f-5cab2d24a648 > 'function' : event_source has no events +## Remarks + You attempted to use [event_source](../../windows/attributes/event-source.md) on a class that has no event methods. To fix this error, add one or more events to the class. +## Example + The following sample generates C3701: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md index 10662fdfd39..491ea07a1a2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md @@ -10,8 +10,12 @@ ms.assetid: 14fcc20e-4404-45d7-be54-e4f09332fa5a > 'function' : ATL is required for COM events +## Remarks + You attempted to use COM events without including the necessary ATL header files. +## Example + The following sample generates C3702: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md index 08331599d6d..58d60c6968b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md @@ -10,8 +10,12 @@ ms.assetid: 7e3677d9-f2be-4c26-998f-423564e9023c > 'event handler': an event handler method must have the same storage class as the source 'event' +## Remarks + An [event](../../cpp/event-handling.md) has a different storage class than the event handler to which it is hooked. For example, this error occurs if the event handler is a static member function and the event is not static. To fix this error, give the event and the event handler the same storage class. +## Example + The following sample generates C3703: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md index 9865071ac3d..21f4db6209f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md @@ -10,8 +10,12 @@ ms.assetid: ee40ea35-a214-4dec-9489-d7f155dd0ac2 > 'function' : a vararg method cannot fire events +## Remarks + You attempted to use [__event](../../cpp/event.md) on a vararg method. To fix this error, replace the `fireEvent(int i, ...)` call with the `fireEvent(int i)` call as shown in the following code sample. +## Example + The following sample generates C3704: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md index 44622e50c94..2ca9fb5dc4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md @@ -10,8 +10,12 @@ ms.assetid: 8361017d-5782-4214-a9d7-e9825fd29bc8 > 'function' : cannot find eventing interface +## Remarks + You must define an event interface to use COM events. Note that the `#include` lines of the ATL header files shown in the sample below are required for using COM events. To fix this error, uncomment the definition of the `IEvents` interface in the sample code. +## Example + The following sample generates C3705: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md index 2e6afef7b60..f79d2d62312 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md @@ -10,12 +10,16 @@ ms.assetid: d20a33eb-d625-46c5-ac87-32075a590d07 > 'function' : must be a COM interface to fire COM events +## Remarks + The event interface that you use to fire COM events must be a COM interface. In this situation, the interface should either be defined using a Visual C++ attribute, or imported using [#import](../../preprocessor/hash-import-directive-cpp.md) from a type library with #import's embedded_idl attribute. Note that the `#include` lines of the ATL header files shown in the sample below are required for using COM events. To fix this error, make `IEvents` (the eventing interface) a COM interface by applying one of the following attributes to the interface definition: [object](../../windows/attributes/object-cpp.md), [dual](../../windows/attributes/dual.md), or [dispinterface](../../windows/attributes/dispinterface.md). If an interface is from a header file generated by MIDL, the compiler will not recognize it as a COM interface. +## Example + The following sample generates C3706: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md index c0e67e907fe..0f851678ed2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md @@ -10,8 +10,12 @@ ms.assetid: ac63a5dd-7a4b-48d2-9f2a-be9cb090134c > 'function' : dispinterface method must have a dispid +## Remarks + If you use a `dispinterface` method, you must assign it a `dispid`. To fix this error, assign a `dispid` to the `dispinterface` method, for example, by uncommenting the `id` attribute on the method in the sample below. For more information, see the attributes [dispinterface](../../windows/attributes/dispinterface.md) and [id](../../windows/attributes/id.md). +## Example + The following sample generates C3707: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md index 107e72c845d..1b282e4ce1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md @@ -10,8 +10,12 @@ ms.assetid: 45e71564-9c7f-437f-98d8-a735ce162ed0 > 'interface': improper use of 'keyword'; must be a member of a compatible event source +## Remarks + To declare an interface as an event, the event declaration must be in an event source. +## Example + The following sample generates C3708: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md index 33dd4d47f58..4f05c8baa2c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md @@ -10,8 +10,12 @@ ms.assetid: d5576b04-2f93-420a-8f3e-8b8e987e8dab > 'function': improper syntax for specifying event in __hook/\__unhook +## Remarks + When you specify an event source with [__hook](../../cpp/hook.md) or [__unhook](../../cpp/unhook.md), the first parameter must be a valid event method and the second parameter must be a valid event source object (not a method). +## Example + The following sample generates C3709: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md index 9c9ff72fcf3..6c2ed21be0a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md @@ -10,6 +10,8 @@ ms.assetid: 18bec009-5b6f-464a-a21e-5d58a6936504 > 'function': improper syntax for specifying event handler in __hook/\__unhook +## Remarks + When you specify an event handler with [__hook](../../cpp/hook.md) or [__unhook](../../cpp/unhook.md), the handler must be a valid method. ## Example From af3f690155053d03373b754524c84e9cde72981d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 22:39:53 +0800 Subject: [PATCH 0888/1799] Replace term "sample" with "example" for error references in range [C3661, C3710] --- .../compiler-errors-2/compiler-error-c3662.md | 2 +- .../compiler-errors-2/compiler-error-c3665.md | 2 +- .../compiler-errors-2/compiler-error-c3666.md | 2 +- .../compiler-errors-2/compiler-error-c3668.md | 2 +- .../compiler-errors-2/compiler-error-c3669.md | 2 +- .../compiler-errors-2/compiler-error-c3670.md | 2 +- .../compiler-errors-2/compiler-error-c3671.md | 2 +- .../compiler-errors-2/compiler-error-c3672.md | 2 +- .../compiler-errors-2/compiler-error-c3673.md | 4 ++-- .../compiler-errors-2/compiler-error-c3675.md | 2 +- .../compiler-errors-2/compiler-error-c3697.md | 2 +- .../compiler-errors-2/compiler-error-c3698.md | 2 +- .../compiler-errors-2/compiler-error-c3699.md | 6 +++--- .../compiler-errors-2/compiler-error-c3701.md | 2 +- .../compiler-errors-2/compiler-error-c3702.md | 2 +- .../compiler-errors-2/compiler-error-c3703.md | 2 +- .../compiler-errors-2/compiler-error-c3704.md | 4 ++-- .../compiler-errors-2/compiler-error-c3705.md | 4 ++-- .../compiler-errors-2/compiler-error-c3706.md | 4 ++-- .../compiler-errors-2/compiler-error-c3707.md | 4 ++-- .../compiler-errors-2/compiler-error-c3708.md | 2 +- .../compiler-errors-2/compiler-error-c3709.md | 2 +- .../compiler-errors-2/compiler-error-c3710.md | 2 +- 23 files changed, 30 insertions(+), 30 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md index 83d66983951..40f8436e65d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md @@ -18,7 +18,7 @@ For more information, see [Explicit Overrides](../../extensions/explicit-overrid ## Example -The following sample generates C3662. +The following example generates C3662. ```cpp // C3662.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md index bf01a1b641a..dc5de5b4e3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md @@ -18,7 +18,7 @@ For example, a new slot cannot be requested on a destructor or finalizer. For m ## Example -The following sample generates C3665: +The following example generates C3665: ```cpp // C3665.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md index 11e8e88bde7..ac852269a1c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md @@ -16,7 +16,7 @@ An override specifier was used on a constructor, and that is not allowed. For mo ## Example -The following sample generates C3666. +The following example generates C3666. ```cpp // C3666.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md index a1a25fe02c7..e8051beffd1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md @@ -18,7 +18,7 @@ For more information, see [Explicit Overrides](../../extensions/explicit-overrid ## Example -The following sample generates C3668. +The following example generates C3668. ```cpp // C3668.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md index 2c6ad6f0222..5176e42c17a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md @@ -16,7 +16,7 @@ An override was specified incorrectly. For more information, see [Explicit Overr ## Example -The following sample generates C3669. +The following example generates C3669. ```cpp // C3669.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md index 886c65a0eef..e12017681b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md @@ -16,7 +16,7 @@ An override can only take place on a function whose access level makes it availa ## Example -The following sample generates C3670: +The following example generates C3670: ```cpp // C3670.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md index 3be2133e593..6c7c505fbd6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md @@ -16,7 +16,7 @@ When using explicit override syntax, the compiler generates an error if a functi ## Example -The following sample generates C3671. +The following example generates C3671. ```cpp // C3671.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3672.md b/docs/error-messages/compiler-errors-2/compiler-error-c3672.md index 7317008d9c4..6a013789552 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3672.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3672.md @@ -15,7 +15,7 @@ A destructor was called incorrectly. For more information, see [Destructors](.. ## Example -The following sample generates C3672. +The following example generates C3672. ```cpp // C3672.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md index a60df380165..0e8cb7ca84b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md @@ -16,7 +16,7 @@ A user-defined constructor is needed to copy objects of CLR ref types. For more ## Examples -The following sample generates C3673. +The following example generates C3673. ```cpp // C3673.cpp @@ -34,7 +34,7 @@ int main() { } ``` -The following sample generates C3673. +The following example generates C3673. ```cpp // C3673_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md index a130f469ea4..7a7494c1874 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md @@ -18,7 +18,7 @@ See [property](../../extensions/property-cpp-component-extensions.md) for more i ## Example -The following sample generates C3675. +The following example generates C3675. ```cpp // C3675.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md index 64a527be4f4..a0194ad58f3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md @@ -16,7 +16,7 @@ The tracking handle (^) was applied to a qualifier for which it was not designed ## Example -The following sample generates C3697: +The following example generates C3697: ```cpp // C3697.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md index 501ade0b1a0..76f75592af1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md @@ -16,7 +16,7 @@ A managed object was declared incorrectly. ## Example -The following sample generates C3698: +The following example generates C3698: ```cpp // C3698.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md index 55f0f9676bc..a43824ab864 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md @@ -16,7 +16,7 @@ An attempt was made to use indirection that is not allowed on `type`. ## Examples -The following sample generates C3699. +The following example generates C3699. ```cpp // C3699.cpp @@ -29,7 +29,7 @@ int main() { } ``` -A trivial property cannot have reference type. See [property](../../extensions/property-cpp-component-extensions.md) for more information. The following sample generates C3699. +A trivial property cannot have reference type. See [property](../../extensions/property-cpp-component-extensions.md) for more information. The following example generates C3699. ```cpp // C3699_b.cpp @@ -40,7 +40,7 @@ ref struct C { }; ``` -The equivalent of a "pointer to a pointer" syntax is a handle to a tracking reference. The following sample generates C3699. +The equivalent of a "pointer to a pointer" syntax is a handle to a tracking reference. The following example generates C3699. ```cpp // C3699_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md index 227ec1555da..1ede560f4ae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md @@ -16,7 +16,7 @@ You attempted to use [event_source](../../windows/attributes/event-source.md) on ## Example -The following sample generates C3701: +The following example generates C3701: ```cpp // C3701.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md index 491ea07a1a2..a8db95f5392 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md @@ -16,7 +16,7 @@ You attempted to use COM events without including the necessary ATL header files ## Example -The following sample generates C3702: +The following example generates C3702: ```cpp // C3702.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md index 58d60c6968b..a5c1c0a3ab6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md @@ -16,7 +16,7 @@ An [event](../../cpp/event-handling.md) has a different storage class than the e ## Example -The following sample generates C3703: +The following example generates C3703: ```cpp // C3703.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md index 21f4db6209f..52dd9cf298b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md @@ -12,11 +12,11 @@ ms.assetid: ee40ea35-a214-4dec-9489-d7f155dd0ac2 ## Remarks -You attempted to use [__event](../../cpp/event.md) on a vararg method. To fix this error, replace the `fireEvent(int i, ...)` call with the `fireEvent(int i)` call as shown in the following code sample. +You attempted to use [__event](../../cpp/event.md) on a vararg method. To fix this error, replace the `fireEvent(int i, ...)` call with the `fireEvent(int i)` call as shown in the following code example. ## Example -The following sample generates C3704: +The following example generates C3704: ```cpp // C3704.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md index 2ca9fb5dc4f..f441e25f2cb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md @@ -12,11 +12,11 @@ ms.assetid: 8361017d-5782-4214-a9d7-e9825fd29bc8 ## Remarks -You must define an event interface to use COM events. Note that the `#include` lines of the ATL header files shown in the sample below are required for using COM events. To fix this error, uncomment the definition of the `IEvents` interface in the sample code. +You must define an event interface to use COM events. Note that the `#include` lines of the ATL header files shown in the example below are required for using COM events. To fix this error, uncomment the definition of the `IEvents` interface in the example code. ## Example -The following sample generates C3705: +The following example generates C3705: ```cpp // C3705.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md index f79d2d62312..a24293016d0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md @@ -14,13 +14,13 @@ ms.assetid: d20a33eb-d625-46c5-ac87-32075a590d07 The event interface that you use to fire COM events must be a COM interface. In this situation, the interface should either be defined using a Visual C++ attribute, or imported using [#import](../../preprocessor/hash-import-directive-cpp.md) from a type library with #import's embedded_idl attribute. -Note that the `#include` lines of the ATL header files shown in the sample below are required for using COM events. To fix this error, make `IEvents` (the eventing interface) a COM interface by applying one of the following attributes to the interface definition: [object](../../windows/attributes/object-cpp.md), [dual](../../windows/attributes/dual.md), or [dispinterface](../../windows/attributes/dispinterface.md). +Note that the `#include` lines of the ATL header files shown in the example below are required for using COM events. To fix this error, make `IEvents` (the eventing interface) a COM interface by applying one of the following attributes to the interface definition: [object](../../windows/attributes/object-cpp.md), [dual](../../windows/attributes/dual.md), or [dispinterface](../../windows/attributes/dispinterface.md). If an interface is from a header file generated by MIDL, the compiler will not recognize it as a COM interface. ## Example -The following sample generates C3706: +The following example generates C3706: ```cpp // C3706.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md index 0f851678ed2..4e67ae6cc72 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md @@ -12,11 +12,11 @@ ms.assetid: ac63a5dd-7a4b-48d2-9f2a-be9cb090134c ## Remarks -If you use a `dispinterface` method, you must assign it a `dispid`. To fix this error, assign a `dispid` to the `dispinterface` method, for example, by uncommenting the `id` attribute on the method in the sample below. For more information, see the attributes [dispinterface](../../windows/attributes/dispinterface.md) and [id](../../windows/attributes/id.md). +If you use a `dispinterface` method, you must assign it a `dispid`. To fix this error, assign a `dispid` to the `dispinterface` method, for example, by uncommenting the `id` attribute on the method in the example below. For more information, see the attributes [dispinterface](../../windows/attributes/dispinterface.md) and [id](../../windows/attributes/id.md). ## Example -The following sample generates C3707: +The following example generates C3707: ```cpp // C3707.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md index 1b282e4ce1b..473c4b4259f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md @@ -16,7 +16,7 @@ To declare an interface as an event, the event declaration must be in an event s ## Example -The following sample generates C3708: +The following example generates C3708: ```cpp // C3708.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md index 4f05c8baa2c..affa34aa6a5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md @@ -16,7 +16,7 @@ When you specify an event source with [__hook](../../cpp/hook.md) or [__unhook]( ## Example -The following sample generates C3709: +The following example generates C3709: ```cpp // C3709.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md index 6c2ed21be0a..d0833b4b9c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md @@ -16,7 +16,7 @@ When you specify an event handler with [__hook](../../cpp/hook.md) or [__unhook] ## Example -The following sample generates C3710 +The following example generates C3710 ```cpp // C3710.cpp From e2172fdcafbf1c50282c78bf20af50d4b7bdc657 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 21 Aug 2025 22:43:30 +0800 Subject: [PATCH 0889/1799] Update metadata for error references in range [C3661, C3710] --- .../error-messages/compiler-errors-2/compiler-error-c3661.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3662.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3665.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3666.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3668.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3669.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3670.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3671.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3673.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3675.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3697.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3698.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3699.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3701.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3702.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3703.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3704.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3705.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3706.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3707.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3708.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3709.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3710.md | 5 ++--- 23 files changed, 46 insertions(+), 69 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3661.md b/docs/error-messages/compiler-errors-2/compiler-error-c3661.md index a17a5373a45..7429b9de5ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3661.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3661.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3661" title: "Compiler Error C3661" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3661" +ms.date: 11/04/2016 f1_keywords: ["C3661"] helpviewer_keywords: ["C3661"] -ms.assetid: 50793fd1-1829-4b29-ad0d-094ef2068b43 --- # Compiler Error C3661 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md index 40f8436e65d..e5edfda336a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3662" title: "Compiler Error C3662" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3662" +ms.date: 11/04/2016 f1_keywords: ["C3662"] helpviewer_keywords: ["C3662"] -ms.assetid: 61bd3e41-a86b-42c0-be89-d992d3906ff1 --- # Compiler Error C3662 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md index dc5de5b4e3b..969f276e9c6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3665" title: "Compiler Error C3665" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3665" +ms.date: 11/04/2016 f1_keywords: ["C3665"] helpviewer_keywords: ["C3665"] -ms.assetid: 893bb47e-8de1-43aa-af7d-fa47ad149ee9 --- # Compiler Error C3665 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md index ac852269a1c..b516ef72145 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3666" title: "Compiler Error C3666" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3666" +ms.date: 11/04/2016 f1_keywords: ["C3666"] helpviewer_keywords: ["C3666"] -ms.assetid: 459e51dd-cefb-4346-99b3-644f2d8b65b2 --- # Compiler Error C3666 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md index e8051beffd1..e8640f0b6b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3668" title: "Compiler Error C3668" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3668" +ms.date: 11/04/2016 f1_keywords: ["C3668"] helpviewer_keywords: ["C3668"] -ms.assetid: 53a96698-bde4-4447-95b5-b5108291f60c --- # Compiler Error C3668 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md index 5176e42c17a..c4e896e88fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3669" title: "Compiler Error C3669" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3669" +ms.date: 11/04/2016 f1_keywords: ["C3669"] helpviewer_keywords: ["C3669"] -ms.assetid: be9c7ae4-e96f-47ab-922a-39a3537d5ca6 --- # Compiler Error C3669 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md index e12017681b4..7db7a7f9bc4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3670" title: "Compiler Error C3670" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3670" +ms.date: 11/04/2016 f1_keywords: ["C3670"] helpviewer_keywords: ["C3670"] -ms.assetid: d0fa9c6e-8f90-48c7-9066-31b4fa5942eb --- # Compiler Error C3670 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md index 6c7c505fbd6..81d0cefecf9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3671" title: "Compiler Error C3671" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3671" +ms.date: 11/04/2016 f1_keywords: ["C3671"] helpviewer_keywords: ["C3671"] -ms.assetid: d684e4ae-87e2-4424-80bb-6f346652c831 --- # Compiler Error C3671 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md index 0e8cb7ca84b..5781848d703 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3673" title: "Compiler Error C3673" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3673" +ms.date: 11/04/2016 f1_keywords: ["C3673"] helpviewer_keywords: ["C3673"] -ms.assetid: bb6d2079-05af-4e2c-be0e-75c892e6c590 --- # Compiler Error C3673 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md index 7a7494c1874..437cd7bb1ae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3675" title: "Compiler Error C3675" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3675" +ms.date: 11/04/2016 f1_keywords: ["C3675"] helpviewer_keywords: ["C3675"] -ms.assetid: 87461613-6633-430b-b95d-c7cb1bb63776 --- # Compiler Error C3675 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md index a0194ad58f3..dbb5120276b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3697" title: "Compiler Error C3697" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3697" +ms.date: 11/04/2016 f1_keywords: ["C3697"] helpviewer_keywords: ["C3697"] -ms.assetid: 2d3f63c4-b7f8-421d-a7a5-2bf17fd054f9 --- # Compiler Error C3697 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md index 76f75592af1..76dac5ebdc7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3698" title: "Compiler Error C3698" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3698" +ms.date: 11/04/2016 f1_keywords: ["C3698"] helpviewer_keywords: ["C3698"] -ms.assetid: 3c02fb08-7ba4-4637-a06f-19926cb2b5f1 --- # Compiler Error C3698 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md index a43824ab864..962b767cd4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3699" title: "Compiler Error C3699" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3699" +ms.date: 11/04/2016 f1_keywords: ["C3699"] helpviewer_keywords: ["C3699"] -ms.assetid: 47c29afc-ab8b-4238-adfe-788dd6e00b3b --- # Compiler Error C3699 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md index 1ede560f4ae..4194641c39f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3701" title: "Compiler Error C3701" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3701" +ms.date: 11/04/2016 f1_keywords: ["C3701"] helpviewer_keywords: ["C3701"] -ms.assetid: a7faaa87-d2f5-4d6a-9a2f-5cab2d24a648 --- # Compiler Error C3701 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md index a8db95f5392..8c101ecfb71 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3702" title: "Compiler Error C3702" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3702" +ms.date: 11/04/2016 f1_keywords: ["C3702"] helpviewer_keywords: ["C3702"] -ms.assetid: 14fcc20e-4404-45d7-be54-e4f09332fa5a --- # Compiler Error C3702 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md index a5c1c0a3ab6..3061a7f300e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3703" title: "Compiler Error C3703" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3703" +ms.date: 11/04/2016 f1_keywords: ["C3703"] helpviewer_keywords: ["C3703"] -ms.assetid: 7e3677d9-f2be-4c26-998f-423564e9023c --- # Compiler Error C3703 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md index 52dd9cf298b..7b218f85226 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3704" title: "Compiler Error C3704" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3704" +ms.date: 11/04/2016 f1_keywords: ["C3704"] helpviewer_keywords: ["C3704"] -ms.assetid: ee40ea35-a214-4dec-9489-d7f155dd0ac2 --- # Compiler Error C3704 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md index f441e25f2cb..7408c255823 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3705" title: "Compiler Error C3705" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3705" +ms.date: 11/04/2016 f1_keywords: ["C3705"] helpviewer_keywords: ["C3705"] -ms.assetid: 8361017d-5782-4214-a9d7-e9825fd29bc8 --- # Compiler Error C3705 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md index a24293016d0..3a64b432952 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3706" title: "Compiler Error C3706" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3706" +ms.date: 11/04/2016 f1_keywords: ["C3706"] helpviewer_keywords: ["C3706"] -ms.assetid: d20a33eb-d625-46c5-ac87-32075a590d07 --- # Compiler Error C3706 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md index 4e67ae6cc72..1d3d66e45fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3707" title: "Compiler Error C3707" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3707" +ms.date: 11/04/2016 f1_keywords: ["C3707"] helpviewer_keywords: ["C3707"] -ms.assetid: ac63a5dd-7a4b-48d2-9f2a-be9cb090134c --- # Compiler Error C3707 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md index 473c4b4259f..a611b94ccf0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3708" title: "Compiler Error C3708" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3708" +ms.date: 11/04/2016 f1_keywords: ["C3708"] helpviewer_keywords: ["C3708"] -ms.assetid: 45e71564-9c7f-437f-98d8-a735ce162ed0 --- # Compiler Error C3708 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md index affa34aa6a5..9c0750d1cc0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3709" title: "Compiler Error C3709" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3709" +ms.date: 11/04/2016 f1_keywords: ["C3709"] helpviewer_keywords: ["C3709"] -ms.assetid: d5576b04-2f93-420a-8f3e-8b8e987e8dab --- # Compiler Error C3709 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md index d0833b4b9c0..7616ac9a947 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3710" title: "Compiler Error C3710" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3710" +ms.date: 11/04/2016 f1_keywords: ["C3710"] helpviewer_keywords: ["C3710"] -ms.assetid: 18bec009-5b6f-464a-a21e-5d58a6936504 --- # Compiler Error C3710 From daabc9de20d8c02cfe3d6a562547c91364964a83 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 16:44:21 +0800 Subject: [PATCH 0890/1799] Update C2182 error message --- docs/error-messages/compiler-errors-1/compiler-error-c2182.md | 2 +- .../compiler-errors-1/compiler-errors-c2100-through-c2199.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md index 86a4d0259c6..de843fe6d1b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2182"] --- # Compiler Error C2182 -> 'identifier' : illegal use of type 'void' +> '*identifier*': this use of 'void' is not valid ## Remarks diff --git a/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md b/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md index ef2e8e4b3f9..0db01eecb18 100644 --- a/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md +++ b/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md @@ -97,7 +97,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2179](compiler-error-c2179.md)|'*type*': an attribute argument cannot use type parameters| |[Compiler error C2180](compiler-error-c2180.md)|controlling expression has type '*type*'| |[Compiler error C2181](compiler-error-c2181.md)|illegal else without matching if| -|[Compiler error C2182](compiler-error-c2182.md)|'*identifier*': illegal use of type 'void'| +|[Compiler error C2182](compiler-error-c2182.md)|'*identifier*': this use of 'void' is not valid| |[Compiler error C2183](compiler-error-c2183.md)|syntax error: translation unit is empty| |[Compiler error C2184](compiler-error-c2184.md)|'*type*': illegal type for __except expression| |[Compiler error C2185](compiler-error-c2185.md)|'*identifier*': illegal based allocation| From 74481fdd780d0172a84804913eb9adeca3570f5a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 16:51:32 +0800 Subject: [PATCH 0891/1799] Augment remarks in C2182 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2182.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md index de843fe6d1b..6f8da74ca2c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C2182"] ## Remarks -A variable is declared type **`void`**. +You can't create a variable or array of type **`void`**. Only pointers to **`void`** are allowed. ## Example From b3f316e30a70ad76d964718dffeab8ccdc1883ea Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 16:58:49 +0800 Subject: [PATCH 0892/1799] Fix example in C2182 error reference --- .../compiler-errors-1/compiler-error-c2182.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md index 6f8da74ca2c..639aa303ec8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md @@ -20,9 +20,9 @@ The following example generates C2182: ```cpp // C2182.cpp // compile with: /c -int main() { - int i = 10; - void &ir = i; // C2182 cannot have a reference to type void - int &ir = i; // OK -} + +void var; // C2182 +void arr[5]; // C2182 + +void* ptr; // OK ``` From c55580a284bb35fecc0e18297c439291d9ed64a5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 17:00:07 +0800 Subject: [PATCH 0893/1799] Update metadata in 2 error reference topics --- docs/error-messages/compiler-errors-1/compiler-error-c2182.md | 2 +- .../compiler-errors-1/compiler-errors-c2100-through-c2199.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md index 639aa303ec8..cbe5f56228d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2182" description: "Learn more about: Compiler Error C2182" -ms.date: 11/04/2016 +ms.date: 08/22/2025 f1_keywords: ["C2182"] helpviewer_keywords: ["C2182"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md b/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md index 0db01eecb18..8d5db1ea8a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md +++ b/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md @@ -1,7 +1,7 @@ --- title: "Compiler errors C2100 through C2199" description: "Learn more about: Compiler errors C2100 through C2199" -ms.date: "04/21/2019" +ms.date: 04/21/2019 f1_keywords: ["C2119", "C2123", "C2125", "C2126", "C2127", "C2136", "C2176", "C2187", "C2189"] helpviewer_keywords: ["C2119", "C2123", "C2125", "C2126", "C2127", "C2136", "C2176", "C2187", "C2189"] --- From d3c98f84b4325698e0110d7a81650a4bbfff0ac5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 17:50:04 +0800 Subject: [PATCH 0894/1799] Add blockquotes for error messages in range [C3711, C3740] --- docs/error-messages/compiler-errors-2/compiler-error-c3711.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3712.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3713.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3714.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3715.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3717.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3719.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3721.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3722.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3724.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3727.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3728.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3731.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3732.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3733.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3734.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3736.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3737.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3738.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3739.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3740.md | 2 +- 21 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md index 16b395e4bfd..e2dfe7eb8ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md @@ -8,7 +8,7 @@ ms.assetid: 26d581cc-2153-4ee0-b814-a371184be3e1 --- # Compiler Error C3711 -'method': an non-managed event source method must return void or an integral type +> 'method': an non-managed event source method must return void or an integral type You defined a method in the event source that did not return void or an integral type. To fix this error, make the event and event handler have a return type of **`void`** or an integral type such as **`int`** or **`long`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md index 99094e6ddab..ea4ab48859b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md @@ -8,7 +8,7 @@ ms.assetid: 65b1fcaf-be89-4c55-9e40-25ec03457253 --- # Compiler Error C3712 -'method': an event handler method must return the same type as the source 'method' +> 'method': an event handler method must return the same type as the source 'method' You defined an event handler method that did not return the same type as the source event method. To fix this error, give the event handler method the same return type as that of the source event method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md index 9ab74b96bbc..4aad3559f08 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md @@ -8,7 +8,7 @@ ms.assetid: 75c6b9b6-955b-49bd-9bc8-ced88b496a1f --- # Compiler Error C3713 -'method': an event handler method must have the same function parameters as the source 'method' +> 'method': an event handler method must have the same function parameters as the source 'method' You defined an event handler method that did not use the same parameters as the source event method. To fix this error, give the event handler method the same parameters as those of the source event method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md index 2f230ab4060..66e0c07e29b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md @@ -8,7 +8,7 @@ ms.assetid: 17718f75-5a37-4e42-912b-487e91008a95 --- # Compiler Error C3714 -'method': an event handler method must have the same calling convention as the source 'method' +> 'method': an event handler method must have the same calling convention as the source 'method' You defined an event handler method that did not use the same calling convention as the source event method. To fix this error, give the event handler method the same calling conventions as those of the source event method. For example, in the code below, make the calling conventions of `handler1` and `event1` match ([__cdecl](../../cpp/cdecl.md) or [__stdcall](../../cpp/stdcall.md) or others). Removing calling convention keywords from both declarations will also solve the problem, and cause `event1` and `handler1` to default to the [thiscall](../../cpp/thiscall.md) calling convention. See [Calling Conventions](../../cpp/calling-conventions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3715.md b/docs/error-messages/compiler-errors-2/compiler-error-c3715.md index 3357231814a..3c1aa9f1ce1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3715.md @@ -8,6 +8,6 @@ ms.assetid: ee5dce88-ddc4-4bdb-9464-47467ce1674f --- # Compiler Error C3715 -'pointer': must be a pointer to 'class' +> 'pointer': must be a pointer to 'class' You specified a pointer in [`__hook`](../../cpp/hook.md) or [`__unhook`](../../cpp/unhook.md) that did not point to a valid class. To fix this error, ensure that your **`__hook`** and **`__unhook`** calls specify pointers to valid classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md index 6aead02f76c..91404445652 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md @@ -8,7 +8,7 @@ ms.assetid: ae4fceb1-2583-4577-b2f1-40971a017055 --- # Compiler Error C3717 -'method': a method that fires events cannot be defined +> 'method': a method that fires events cannot be defined You declared an event method that includes an implementation. An [__event](../../cpp/event.md) method declaration cannot have a definition. To fix this error, ensure that no event method declarations have definitions. For example, in the code below, remove the function body from the `event1` declaration as indicated by the comments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md index 777a99eabac..077edeaea1d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md @@ -8,7 +8,7 @@ ms.assetid: d0d59d4e-babb-4480-9ef7-70cf1a28165c --- # Compiler Error C3719 -'interface': an interface based event source can only be used for COM events +> 'interface': an interface based event source can only be used for COM events You declared an interface in a non-COM context. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3721.md b/docs/error-messages/compiler-errors-2/compiler-error-c3721.md index fbfee81eae7..dfcc8b8fc7f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3721.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3721.md @@ -8,7 +8,7 @@ ms.assetid: c696ca38-3e00-4875-abbe-7bce0f46930e --- # Compiler Error C3721 -'signature': incompatible signature for event +> 'signature': incompatible signature for event An event was declared incorrectly. For more information, see [__event](../../cpp/event.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md index c526c8d8924..42aa4369f33 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md @@ -8,7 +8,7 @@ ms.assetid: 3cb28363-5eff-4548-bd0d-d5c615846353 --- # Compiler Error C3722 -a generic event is not allowed +> a generic event is not allowed The compiler only allows generic classes, structs, and functions. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md index 227b770bdc2..39215765ebf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md @@ -8,7 +8,7 @@ ms.assetid: cab8aba7-14fc-406f-8cc6-32744c8f31c1 --- # Compiler Error C3724 -must #include \ to use multi-threading with events +> must #include \ to use multi-threading with events The windows.h file is required if you use multi-threading with events. To fix this error, add `#include ` to the top of the file in which event sources and event receivers are defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3727.md b/docs/error-messages/compiler-errors-2/compiler-error-c3727.md index 9bd6172470b..70882fd0e07 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3727.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3727.md @@ -8,6 +8,6 @@ ms.assetid: 17b9fe7b-ee9e-483f-9c27-1f709255a9e0 --- # Compiler Error C3727 -'event': a managed event must be a member function or a data member that is a pointer to a delegate +> 'event': a managed event must be a member function or a data member that is a pointer to a delegate .NET events must be a pointer to a delegate type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3728.md b/docs/error-messages/compiler-errors-2/compiler-error-c3728.md index a99650d9999..f330785119b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3728.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3728.md @@ -8,7 +8,7 @@ ms.assetid: 6b510cb1-887f-4fcd-9a1f-3bb720417ed1 --- # Compiler Error C3728 -'event': event does not have a raise method +> 'event': event does not have a raise method Metadata created with a language, such as C#, that does not allow an event to be raised from outside the class in which it was defined, was included with the [#using](../../preprocessor/hash-using-directive-cpp.md) directive, and a Visual C++ program using CLR programming attempted to raise the event. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md index 3336cfa957f..2c14202787a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md @@ -8,7 +8,7 @@ ms.assetid: 45f89fcd-464c-4bc8-8a42-edcb5416d26c --- # Compiler Error C3731 -incompatible event 'function1' and handler 'function2'; event source and event handler must be the same type +> incompatible event 'function1' and handler 'function2'; event source and event handler must be the same type The event source and event receiver must have the same type (for example `native` vs. `com` types). To fix this error, make the types of the event source and the event handler match. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3732.md b/docs/error-messages/compiler-errors-2/compiler-error-c3732.md index 5b02bbd1e22..7cfed9c144a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3732.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3732.md @@ -8,7 +8,7 @@ ms.assetid: 2d55a7e1-9c39-4379-a093-2f7beb27e2ca --- # Compiler Error C3732 -'interface': a custom interface that fires COM events cannot inherit from IDispatch +> 'interface': a custom interface that fires COM events cannot inherit from IDispatch An interface that supports COM events cannot inherit from `IDispatch`. For more information, see [Event Handling in COM](../../cpp/event-handling-in-com.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md index b1d20b40c50..8e67bd40ec6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3733"] --- # Compiler Error C3733 -'event': improper syntax for specifying a COM event; did you forget '__interface'? +> 'event': improper syntax for specifying a COM event; did you forget '__interface'? The wrong syntax was used for a COM event. To fix this error, change the event type or correct the syntax to comply with the COM event rules. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md index e324edba416..773978225cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md @@ -8,7 +8,7 @@ ms.assetid: 4e2afdcc-7da9-45a1-9c96-85f25e2986e8 --- # Compiler Error C3734 -'class': a managed or WinRT class cannot be a coclass +> 'class': a managed or WinRT class cannot be a coclass The [coclass](../../windows/attributes/coclass.md) attribute cannot be used with managed or WinRT classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md index fcd2b8d333d..d86cd87fdf6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md @@ -8,7 +8,7 @@ ms.assetid: 579b773c-41e7-40ea-8382-2e3ce2667f4c --- # Compiler Error C3736 -'event': must be a method or, in the case of managed events, optionally a data member +> 'event': must be a method or, in the case of managed events, optionally a data member Native and COM events must be methods. .NET events can also be data members. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md index b6b4efa9ffc..00b62674d40 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md @@ -8,7 +8,7 @@ ms.assetid: ca2aeb23-2491-4ccb-8838-884abf7065c8 --- # Compiler Error C3737 -'delegate': a delegate may not have an explicit calling convention +> 'delegate': a delegate may not have an explicit calling convention You cannot specify the [calling convention](../../cpp/calling-conventions.md) for a **`delegate`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md index 319585c5184..1cf62939cde 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md @@ -8,7 +8,7 @@ ms.assetid: dd3ee011-e204-4264-bf3a-da32c4ef7038 --- # Compiler Error C3738 -'calling_convention': the calling convention of the explicit instantiation must match that of the template being instantiated +> 'calling_convention': the calling convention of the explicit instantiation must match that of the template being instantiated It is recommended that you do not specify a calling convention on an explicit instantiation. If you must, though, the calling conventions must match. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md index 88b29cba22b..d7787987c0a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md @@ -8,7 +8,7 @@ ms.assetid: acffe894-08b8-4bf2-9249-9501e6e2bad3 --- # Compiler Error C3739 -'class': syntax is only supported when the 'layout_dependent' parameter of event_receiver is true +> 'class': syntax is only supported when the 'layout_dependent' parameter of event_receiver is true You tried to hook an entire interface of events but `layout_dependent` on [event_receiver](../../windows/attributes/event-receiver.md) attribute is not true; you must hook a single event at a time. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md index a660236cdf5..c3342147789 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md @@ -8,7 +8,7 @@ ms.assetid: edb17a90-2307-4df6-943d-580460d26d2b --- # Compiler Error C3740 -templates cannot source or receive events +> templates cannot source or receive events A templated class or struct cannot contain [events](../../cpp/event-handling.md). From e8f629f7a420047ada4551f2613ad7555d838ba4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 17:59:05 +0800 Subject: [PATCH 0895/1799] Add "Remarks" and "Example" headings for error references in range [C3711, C3740] --- docs/error-messages/compiler-errors-2/compiler-error-c3711.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3712.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3713.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3714.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3715.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3717.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3718.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3719.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3721.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3722.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3723.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3724.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3727.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3728.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3731.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3732.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3733.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3734.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3736.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3737.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3738.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3739.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3740.md | 4 ++++ 23 files changed, 78 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md index e2dfe7eb8ca..359b4e6eb88 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md @@ -10,8 +10,12 @@ ms.assetid: 26d581cc-2153-4ee0-b814-a371184be3e1 > 'method': an non-managed event source method must return void or an integral type +## Remarks + You defined a method in the event source that did not return void or an integral type. To fix this error, make the event and event handler have a return type of **`void`** or an integral type such as **`int`** or **`long`**. +## Example + The following sample generates C3711: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md index ea4ab48859b..2f2db371ba5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md @@ -10,8 +10,12 @@ ms.assetid: 65b1fcaf-be89-4c55-9e40-25ec03457253 > 'method': an event handler method must return the same type as the source 'method' +## Remarks + You defined an event handler method that did not return the same type as the source event method. To fix this error, give the event handler method the same return type as that of the source event method. +## Example + The following sample generates C3712: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md index 4aad3559f08..6ccf27f91f3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md @@ -10,8 +10,12 @@ ms.assetid: 75c6b9b6-955b-49bd-9bc8-ced88b496a1f > 'method': an event handler method must have the same function parameters as the source 'method' +## Remarks + You defined an event handler method that did not use the same parameters as the source event method. To fix this error, give the event handler method the same parameters as those of the source event method. +## Example + The following sample generates C3713: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md index 66e0c07e29b..e470fc586bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md @@ -10,8 +10,12 @@ ms.assetid: 17718f75-5a37-4e42-912b-487e91008a95 > 'method': an event handler method must have the same calling convention as the source 'method' +## Remarks + You defined an event handler method that did not use the same calling convention as the source event method. To fix this error, give the event handler method the same calling conventions as those of the source event method. For example, in the code below, make the calling conventions of `handler1` and `event1` match ([__cdecl](../../cpp/cdecl.md) or [__stdcall](../../cpp/stdcall.md) or others). Removing calling convention keywords from both declarations will also solve the problem, and cause `event1` and `handler1` to default to the [thiscall](../../cpp/thiscall.md) calling convention. See [Calling Conventions](../../cpp/calling-conventions.md) for more information. +## Example + The following sample generates C3714: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3715.md b/docs/error-messages/compiler-errors-2/compiler-error-c3715.md index 3c1aa9f1ce1..aa4c7e234ff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3715.md @@ -10,4 +10,6 @@ ms.assetid: ee5dce88-ddc4-4bdb-9464-47467ce1674f > 'pointer': must be a pointer to 'class' +## Remarks + You specified a pointer in [`__hook`](../../cpp/hook.md) or [`__unhook`](../../cpp/unhook.md) that did not point to a valid class. To fix this error, ensure that your **`__hook`** and **`__unhook`** calls specify pointers to valid classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md index 91404445652..e96ce1810ee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md @@ -10,8 +10,12 @@ ms.assetid: ae4fceb1-2583-4577-b2f1-40971a017055 > 'method': a method that fires events cannot be defined +## Remarks + You declared an event method that includes an implementation. An [__event](../../cpp/event.md) method declaration cannot have a definition. To fix this error, ensure that no event method declarations have definitions. For example, in the code below, remove the function body from the `event1` declaration as indicated by the comments. +## Example + The following sample generates C3717: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3718.md b/docs/error-messages/compiler-errors-2/compiler-error-c3718.md index ad3cb130088..921e4c0a9c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3718.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3718.md @@ -10,6 +10,8 @@ ms.assetid: 346b5205-c44d-49d3-b66a-96417d3d6986 > can only call '*event*' in the context of a member function of the receiving class +## Remarks + The event can only be called from the receiving class. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md index 077edeaea1d..462b60abc47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md @@ -10,8 +10,12 @@ ms.assetid: d0d59d4e-babb-4480-9ef7-70cf1a28165c > 'interface': an interface based event source can only be used for COM events +## Remarks + You declared an interface in a non-COM context. +## Example + The following sample generates C3719: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3721.md b/docs/error-messages/compiler-errors-2/compiler-error-c3721.md index dfcc8b8fc7f..c4dcc5589ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3721.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3721.md @@ -10,6 +10,8 @@ ms.assetid: c696ca38-3e00-4875-abbe-7bce0f46930e > 'signature': incompatible signature for event +## Remarks + An event was declared incorrectly. For more information, see [__event](../../cpp/event.md). C3721 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md index 42aa4369f33..f177fc2589d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md @@ -10,8 +10,12 @@ ms.assetid: 3cb28363-5eff-4548-bd0d-d5c615846353 > a generic event is not allowed +## Remarks + The compiler only allows generic classes, structs, and functions. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). +## Example + The following sample generates C3722: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3723.md b/docs/error-messages/compiler-errors-2/compiler-error-c3723.md index 1723435e049..490e2b9c050 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3723.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3723.md @@ -10,8 +10,12 @@ ms.assetid: ef0fb1ff-3f9a-4093-a6b6-894d1ab0c4b9 > 'function': could not resolve event +## Remarks + `function` could not resolve which event to call. +## Examples + The following sample generates C3723: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md index 39215765ebf..53c127e2ff9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md @@ -10,8 +10,12 @@ ms.assetid: cab8aba7-14fc-406f-8cc6-32744c8f31c1 > must #include \ to use multi-threading with events +## Remarks + The windows.h file is required if you use multi-threading with events. To fix this error, add `#include ` to the top of the file in which event sources and event receivers are defined. +## Example + ```cpp // C3724.cpp // uncomment the following line to resolve diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3727.md b/docs/error-messages/compiler-errors-2/compiler-error-c3727.md index 70882fd0e07..f784c7e475b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3727.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3727.md @@ -10,4 +10,6 @@ ms.assetid: 17b9fe7b-ee9e-483f-9c27-1f709255a9e0 > 'event': a managed event must be a member function or a data member that is a pointer to a delegate +## Remarks + .NET events must be a pointer to a delegate type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3728.md b/docs/error-messages/compiler-errors-2/compiler-error-c3728.md index f330785119b..495fb722ab7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3728.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3728.md @@ -10,6 +10,8 @@ ms.assetid: 6b510cb1-887f-4fcd-9a1f-3bb720417ed1 > 'event': event does not have a raise method +## Remarks + Metadata created with a language, such as C#, that does not allow an event to be raised from outside the class in which it was defined, was included with the [#using](../../preprocessor/hash-using-directive-cpp.md) directive, and a Visual C++ program using CLR programming attempted to raise the event. To raise an event in a program developed in a language such as C#, the class containing the event needs to also define a public method that raises the event. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md index 2c14202787a..1f20594d041 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md @@ -10,8 +10,12 @@ ms.assetid: 45f89fcd-464c-4bc8-8a42-edcb5416d26c > incompatible event 'function1' and handler 'function2'; event source and event handler must be the same type +## Remarks + The event source and event receiver must have the same type (for example `native` vs. `com` types). To fix this error, make the types of the event source and the event handler match. +## Example + The following sample generates C3731: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3732.md b/docs/error-messages/compiler-errors-2/compiler-error-c3732.md index 7cfed9c144a..e74127bf47e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3732.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3732.md @@ -10,8 +10,12 @@ ms.assetid: 2d55a7e1-9c39-4379-a093-2f7beb27e2ca > 'interface': a custom interface that fires COM events cannot inherit from IDispatch +## Remarks + An interface that supports COM events cannot inherit from `IDispatch`. For more information, see [Event Handling in COM](../../cpp/event-handling-in-com.md). +## Example + The following error generates C3732: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md index 8e67bd40ec6..d699028f0e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C3733"] > 'event': improper syntax for specifying a COM event; did you forget '__interface'? +## Remarks + The wrong syntax was used for a COM event. To fix this error, change the event type or correct the syntax to comply with the COM event rules. +## Example + The following sample generates C3733: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md index 773978225cc..91b30c4bd39 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md @@ -10,8 +10,12 @@ ms.assetid: 4e2afdcc-7da9-45a1-9c96-85f25e2986e8 > 'class': a managed or WinRT class cannot be a coclass +## Remarks + The [coclass](../../windows/attributes/coclass.md) attribute cannot be used with managed or WinRT classes. +## Example + The following sample generates C3734 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md index d86cd87fdf6..cc901d515b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md @@ -10,8 +10,12 @@ ms.assetid: 579b773c-41e7-40ea-8382-2e3ce2667f4c > 'event': must be a method or, in the case of managed events, optionally a data member +## Remarks + Native and COM events must be methods. .NET events can also be data members. +## Example + The following sample generates C3736: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md index 00b62674d40..1c0f052ab40 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md @@ -10,6 +10,8 @@ ms.assetid: ca2aeb23-2491-4ccb-8838-884abf7065c8 > 'delegate': a delegate may not have an explicit calling convention +## Remarks + You cannot specify the [calling convention](../../cpp/calling-conventions.md) for a **`delegate`**. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md index 1cf62939cde..1f57713a353 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md @@ -10,6 +10,8 @@ ms.assetid: dd3ee011-e204-4264-bf3a-da32c4ef7038 > 'calling_convention': the calling convention of the explicit instantiation must match that of the template being instantiated +## Remarks + It is recommended that you do not specify a calling convention on an explicit instantiation. If you must, though, the calling conventions must match. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md index d7787987c0a..015d54cbb3f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md @@ -10,8 +10,12 @@ ms.assetid: acffe894-08b8-4bf2-9249-9501e6e2bad3 > 'class': syntax is only supported when the 'layout_dependent' parameter of event_receiver is true +## Remarks + You tried to hook an entire interface of events but `layout_dependent` on [event_receiver](../../windows/attributes/event-receiver.md) attribute is not true; you must hook a single event at a time. +## Example + The following sample generates C3739: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md index c3342147789..92a3574332b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md @@ -10,8 +10,12 @@ ms.assetid: edb17a90-2307-4df6-943d-580460d26d2b > templates cannot source or receive events +## Remarks + A templated class or struct cannot contain [events](../../cpp/event-handling.md). +## Example + The following sample generates C3740: ```cpp From 832c5621abdff82c3533d6bb6041ef3d9d4843e7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 18:00:24 +0800 Subject: [PATCH 0896/1799] Replace term "sample" with "example" for error references in range [C3711, C3740] --- docs/error-messages/compiler-errors-2/compiler-error-c3711.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3712.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3713.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3714.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3717.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3718.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3719.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3722.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3723.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3731.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3733.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3734.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3736.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3737.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3738.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3739.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3740.md | 2 +- 17 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md index 359b4e6eb88..2191bc9560d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md @@ -16,7 +16,7 @@ You defined a method in the event source that did not return void or an integral ## Example -The following sample generates C3711: +The following example generates C3711: ```cpp // C3711.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md index 2f2db371ba5..949ab692876 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md @@ -16,7 +16,7 @@ You defined an event handler method that did not return the same type as the sou ## Example -The following sample generates C3712: +The following example generates C3712: ```cpp // C3712.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md index 6ccf27f91f3..d8206f47246 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md @@ -16,7 +16,7 @@ You defined an event handler method that did not use the same parameters as the ## Example -The following sample generates C3713: +The following example generates C3713: ```cpp // C3713.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md index e470fc586bb..4300d8bdc49 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md @@ -16,7 +16,7 @@ You defined an event handler method that did not use the same calling convention ## Example -The following sample generates C3714: +The following example generates C3714: ```cpp // C3714.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md index e96ce1810ee..a43bf44917f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md @@ -16,7 +16,7 @@ You declared an event method that includes an implementation. An [__event](../.. ## Example -The following sample generates C3717: +The following example generates C3717: ```cpp // C3717.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3718.md b/docs/error-messages/compiler-errors-2/compiler-error-c3718.md index 921e4c0a9c8..64d0d1fd412 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3718.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3718.md @@ -16,7 +16,7 @@ The event can only be called from the receiving class. ## Example -The following sample generates C3718: +The following example generates C3718: ```cpp // C3718.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md index 462b60abc47..b2b20d601e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md @@ -16,7 +16,7 @@ You declared an interface in a non-COM context. ## Example -The following sample generates C3719: +The following example generates C3719: ```cpp // C3719a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md index f177fc2589d..4cbe82691cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md @@ -16,7 +16,7 @@ The compiler only allows generic classes, structs, and functions. For more info ## Example -The following sample generates C3722: +The following example generates C3722: ```cpp // C3722.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3723.md b/docs/error-messages/compiler-errors-2/compiler-error-c3723.md index 490e2b9c050..4d176c074e5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3723.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3723.md @@ -16,7 +16,7 @@ ms.assetid: ef0fb1ff-3f9a-4093-a6b6-894d1ab0c4b9 ## Examples -The following sample generates C3723: +The following example generates C3723: ```cpp // C3723.cpp @@ -41,7 +41,7 @@ int main() { **`__hook`** and **`__unhook`** are not compatible with **`/clr`** programming. Use the += and -= operators instead. -The following sample generates C3723: +The following example generates C3723: ```cpp // C3723b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md index 1f20594d041..cd505c3421d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md @@ -16,7 +16,7 @@ The event source and event receiver must have the same type (for example `native ## Example -The following sample generates C3731: +The following example generates C3731: ```cpp // C3731.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md index d699028f0e2..e5fdcabd78d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md @@ -15,7 +15,7 @@ The wrong syntax was used for a COM event. To fix this error, change the event t ## Example -The following sample generates C3733: +The following example generates C3733: ```cpp #define _ATL_ATTRIBUTES 1 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md index 91b30c4bd39..35cd145b686 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md @@ -16,7 +16,7 @@ The [coclass](../../windows/attributes/coclass.md) attribute cannot be used with ## Example -The following sample generates C3734 and shows how to fix it: +The following example generates C3734 and shows how to fix it: ```cpp // C3734.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md index cc901d515b6..982599f9059 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md @@ -16,7 +16,7 @@ Native and COM events must be methods. .NET events can also be data members. ## Example -The following sample generates C3736: +The following example generates C3736: ```cpp // C3736.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md index 1c0f052ab40..267a2dea821 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md @@ -16,7 +16,7 @@ You cannot specify the [calling convention](../../cpp/calling-conventions.md) fo ## Example -The following sample generates C3737: +The following example generates C3737: ```cpp // C3737a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md index 1f57713a353..6cf996cae9b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md @@ -16,7 +16,7 @@ It is recommended that you do not specify a calling convention on an explicit in ## Example -The following sample generates C3738. +The following example generates C3738. ```cpp // C3738.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md index 015d54cbb3f..e7054231abc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md @@ -16,7 +16,7 @@ You tried to hook an entire interface of events but `layout_dependent` on [event ## Example -The following sample generates C3739: +The following example generates C3739: ```cpp // C3739.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md index 92a3574332b..dedab225728 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md @@ -16,7 +16,7 @@ A templated class or struct cannot contain [events](../../cpp/event-handling.md) ## Example -The following sample generates C3740: +The following example generates C3740: ```cpp // C3740.cpp From f01fa4a13e6aed51c7c8b69716521f2b1791651a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 18:04:36 +0800 Subject: [PATCH 0897/1799] Update metadata for error references in range [C3711, C3740] --- .../error-messages/compiler-errors-2/compiler-error-c3711.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3712.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3713.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3714.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3715.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3717.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3718.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3719.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3721.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3722.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3723.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3724.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3727.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3728.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3731.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3732.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3734.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3736.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3737.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3738.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3739.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3740.md | 5 ++--- 22 files changed, 44 insertions(+), 66 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md index 2191bc9560d..8b7399ff2e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3711" title: "Compiler Error C3711" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3711" +ms.date: 11/04/2016 f1_keywords: ["C3711"] helpviewer_keywords: ["C3711"] -ms.assetid: 26d581cc-2153-4ee0-b814-a371184be3e1 --- # Compiler Error C3711 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md index 949ab692876..d7ac31955f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3712" title: "Compiler Error C3712" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3712" +ms.date: 11/04/2016 f1_keywords: ["C3712"] helpviewer_keywords: ["C3712"] -ms.assetid: 65b1fcaf-be89-4c55-9e40-25ec03457253 --- # Compiler Error C3712 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md index d8206f47246..8949eafa8a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3713" title: "Compiler Error C3713" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3713" +ms.date: 11/04/2016 f1_keywords: ["C3713"] helpviewer_keywords: ["C3713"] -ms.assetid: 75c6b9b6-955b-49bd-9bc8-ced88b496a1f --- # Compiler Error C3713 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md index 4300d8bdc49..a623be6a03d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3714" title: "Compiler Error C3714" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3714" +ms.date: 11/04/2016 f1_keywords: ["C3714"] helpviewer_keywords: ["C3714"] -ms.assetid: 17718f75-5a37-4e42-912b-487e91008a95 --- # Compiler Error C3714 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3715.md b/docs/error-messages/compiler-errors-2/compiler-error-c3715.md index aa4c7e234ff..807db400d6b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3715.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3715" title: "Compiler Error C3715" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3715" +ms.date: 11/04/2016 f1_keywords: ["C3715"] helpviewer_keywords: ["C3715"] -ms.assetid: ee5dce88-ddc4-4bdb-9464-47467ce1674f --- # Compiler Error C3715 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md index a43bf44917f..26f54ec56c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3717" title: "Compiler Error C3717" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3717" +ms.date: 11/04/2016 f1_keywords: ["C3717"] helpviewer_keywords: ["C3717"] -ms.assetid: ae4fceb1-2583-4577-b2f1-40971a017055 --- # Compiler Error C3717 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3718.md b/docs/error-messages/compiler-errors-2/compiler-error-c3718.md index 64d0d1fd412..63b08e810fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3718.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3718.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3718" title: "Compiler Error C3718" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3718" +ms.date: 11/04/2016 f1_keywords: ["C3718"] helpviewer_keywords: ["C3718"] -ms.assetid: 346b5205-c44d-49d3-b66a-96417d3d6986 --- # Compiler Error C3718 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md index b2b20d601e7..7dad0a67d1c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3719" title: "Compiler Error C3719" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3719" +ms.date: 11/04/2016 f1_keywords: ["C3719"] helpviewer_keywords: ["C3719"] -ms.assetid: d0d59d4e-babb-4480-9ef7-70cf1a28165c --- # Compiler Error C3719 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3721.md b/docs/error-messages/compiler-errors-2/compiler-error-c3721.md index c4dcc5589ac..9b2aa843ac7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3721.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3721.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3721" title: "Compiler Error C3721" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3721" +ms.date: 11/04/2016 f1_keywords: ["C3721"] helpviewer_keywords: ["C3721"] -ms.assetid: c696ca38-3e00-4875-abbe-7bce0f46930e --- # Compiler Error C3721 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md index 4cbe82691cd..e852c92d29f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3722" title: "Compiler Error C3722" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3722" +ms.date: 11/04/2016 f1_keywords: ["C3722"] helpviewer_keywords: ["C3722"] -ms.assetid: 3cb28363-5eff-4548-bd0d-d5c615846353 --- # Compiler Error C3722 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3723.md b/docs/error-messages/compiler-errors-2/compiler-error-c3723.md index 4d176c074e5..c40274a831f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3723.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3723.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3723" title: "Compiler Error C3723" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3723" +ms.date: 11/04/2016 f1_keywords: ["C3723"] helpviewer_keywords: ["C3723"] -ms.assetid: ef0fb1ff-3f9a-4093-a6b6-894d1ab0c4b9 --- # Compiler Error C3723 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md index 53c127e2ff9..2acf3e2b8e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3724" title: "Compiler Error C3724" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3724" +ms.date: 11/04/2016 f1_keywords: ["C3724"] helpviewer_keywords: ["C3724"] -ms.assetid: cab8aba7-14fc-406f-8cc6-32744c8f31c1 --- # Compiler Error C3724 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3727.md b/docs/error-messages/compiler-errors-2/compiler-error-c3727.md index f784c7e475b..a431ad71bcc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3727.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3727.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3727" title: "Compiler Error C3727" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3727" +ms.date: 11/04/2016 f1_keywords: ["C3727"] helpviewer_keywords: ["C3727"] -ms.assetid: 17b9fe7b-ee9e-483f-9c27-1f709255a9e0 --- # Compiler Error C3727 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3728.md b/docs/error-messages/compiler-errors-2/compiler-error-c3728.md index 495fb722ab7..a67b6d6b90c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3728.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3728.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3728" title: "Compiler Error C3728" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3728" +ms.date: 11/04/2016 f1_keywords: ["C3728"] helpviewer_keywords: ["C3728"] -ms.assetid: 6b510cb1-887f-4fcd-9a1f-3bb720417ed1 --- # Compiler Error C3728 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md index cd505c3421d..7b8d9f51f09 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3731" title: "Compiler Error C3731" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3731" +ms.date: 11/04/2016 f1_keywords: ["C3731"] helpviewer_keywords: ["C3731"] -ms.assetid: 45f89fcd-464c-4bc8-8a42-edcb5416d26c --- # Compiler Error C3731 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3732.md b/docs/error-messages/compiler-errors-2/compiler-error-c3732.md index e74127bf47e..b8a783b4e74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3732.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3732.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3732" title: "Compiler Error C3732" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3732" +ms.date: 11/04/2016 f1_keywords: ["C3732"] helpviewer_keywords: ["C3732"] -ms.assetid: 2d55a7e1-9c39-4379-a093-2f7beb27e2ca --- # Compiler Error C3732 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md index 35cd145b686..3b4e5624503 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3734" title: "Compiler Error C3734" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3734" +ms.date: 11/04/2016 f1_keywords: ["C3734"] helpviewer_keywords: ["C3734"] -ms.assetid: 4e2afdcc-7da9-45a1-9c96-85f25e2986e8 --- # Compiler Error C3734 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md index 982599f9059..e95ba8acaf9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3736" title: "Compiler Error C3736" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3736" +ms.date: 11/04/2016 f1_keywords: ["C3736"] helpviewer_keywords: ["C3736"] -ms.assetid: 579b773c-41e7-40ea-8382-2e3ce2667f4c --- # Compiler Error C3736 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md index 267a2dea821..1ca3f1a46cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3737" title: "Compiler Error C3737" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3737" +ms.date: 11/04/2016 f1_keywords: ["C3737"] helpviewer_keywords: ["C3737"] -ms.assetid: ca2aeb23-2491-4ccb-8838-884abf7065c8 --- # Compiler Error C3737 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md index 6cf996cae9b..d31a1c9b75a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3738" title: "Compiler Error C3738" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3738" +ms.date: 11/04/2016 f1_keywords: ["C3738"] helpviewer_keywords: ["C3738"] -ms.assetid: dd3ee011-e204-4264-bf3a-da32c4ef7038 --- # Compiler Error C3738 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md index e7054231abc..f666f3bdc4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3739" title: "Compiler Error C3739" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3739" +ms.date: 11/04/2016 f1_keywords: ["C3739"] helpviewer_keywords: ["C3739"] -ms.assetid: acffe894-08b8-4bf2-9249-9501e6e2bad3 --- # Compiler Error C3739 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md index dedab225728..b71adc946a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3740" title: "Compiler Error C3740" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3740" +ms.date: 11/04/2016 f1_keywords: ["C3740"] helpviewer_keywords: ["C3740"] -ms.assetid: edb17a90-2307-4df6-943d-580460d26d2b --- # Compiler Error C3740 From b52a124167a11d918f41879e8ab7e3f9935ef255 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 18:06:15 +0800 Subject: [PATCH 0898/1799] Add leading example sentence in C3724 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3724.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md index 2acf3e2b8e6..78cc2f268c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md @@ -15,6 +15,8 @@ The windows.h file is required if you use multi-threading with events. To fix th ## Example +The following example generates C3724: + ```cpp // C3724.cpp // uncomment the following line to resolve From 9174ea421cfcf3c70e6671ed9e8b73a89545c4d7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 18:54:43 +0800 Subject: [PATCH 0899/1799] Augment remarks in C2190 and C2191 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2190.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2191.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md index b1b5022b249..0deb9451756 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C2190"] ## Remarks -A C function was declared a second time with a shorter parameter list. C does not support overloaded functions. +A C function was declared a second time with a shorter parameter list. C does not support overloaded functions. Without [`/Za`](../../build/reference/za-ze-disable-language-extensions.md), the compiler emits [Compiler Warning (level 1) C4030](../compiler-warnings/compiler-warning-level-1-c4030.md) instead. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md index 26511d59b3e..9e852064a0e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C2191"] ## Remarks -A C function was declared a second time with a longer parameter list. C does not support overloaded functions. +A C function was declared a second time with a longer parameter list. C does not support overloaded functions. Without [`/Za`](../../build/reference/za-ze-disable-language-extensions.md), the compiler emits [Compiler Warning (level 1) C4031](../compiler-warnings/compiler-warning-level-1-c4031.md) instead. ## Example From bc7633e9a6de13d8bff59bdef7e1b5dd9520d623 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 19:00:17 +0800 Subject: [PATCH 0900/1799] Tweak and format examples in C2190 and C2191 error reference --- .../compiler-errors-1/compiler-error-c2190.md | 8 +++++--- .../compiler-errors-1/compiler-error-c2191.md | 8 +++++--- 2 files changed, 10 insertions(+), 6 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md index 0deb9451756..1ccb66644bc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md @@ -20,7 +20,9 @@ The following example generates C2190: ```c // C2190.c // compile with: /Za /c -void func( int, float ); -void func( int ); // C2190, different parameter list -void func2( int ); // OK + +void func1(int, float); +void func1(int); // C2190, shorter parameter list + +void func2(int); // OK ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md index 9e852064a0e..16866c8a827 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md @@ -20,7 +20,9 @@ The following example generates C2191: ```c // C2191.c // compile with: /Za /c -void func( int ); -void func( int, float ); // C2191 different parameter list -void func2( int, float ); // OK + +void func1(int); +void func1(int, float); // C2191, longer parameter list + +void func2(int, float); // OK ``` From b740cb135d0413e0c090a6e5ab7354edc8e149a7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 19:04:16 +0800 Subject: [PATCH 0901/1799] Add each other as "See also" link in C2190 and C2191 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2190.md | 4 ++++ docs/error-messages/compiler-errors-1/compiler-error-c2191.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md index 1ccb66644bc..594841f7d9e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md @@ -26,3 +26,7 @@ void func1(int); // C2190, shorter parameter list void func2(int); // OK ``` + +## See also + +[Compiler Error C2191](compiler-error-c2191.md) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md index 16866c8a827..65f2337043a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md @@ -26,3 +26,7 @@ void func1(int, float); // C2191, longer parameter list void func2(int, float); // OK ``` + +## See also + +[Compiler Error C2190](compiler-error-c2190.md) From 34f705f5e5a6036b75d3e4c9203da58139692175 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 19:05:34 +0800 Subject: [PATCH 0902/1799] Update `ms.date` metadata in C2190 and C2191 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2190.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2191.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md index 594841f7d9e..8c9adb4ad4c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2190" description: "Learn more about: Compiler Error C2190" -ms.date: 11/04/2016 +ms.date: 08/22/2025 f1_keywords: ["C2190"] helpviewer_keywords: ["C2190"] --- diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md index 65f2337043a..9644cee4889 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2191" description: "Learn more about: Compiler Error C2191" -ms.date: 11/04/2016 +ms.date: 08/22/2025 f1_keywords: ["C2191"] helpviewer_keywords: ["C2191"] --- From b2868008f3602af784435b2f165285f2d2efa300 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 23:32:55 +0800 Subject: [PATCH 0903/1799] Add blockquotes for error messages in range [C3741, C3800] --- docs/error-messages/compiler-errors-2/compiler-error-c3741.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3743.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3744.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3745.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3747.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3748.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3749.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3752.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3753.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3754.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3755.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3761.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3762.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3763.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3764.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3765.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3766.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3767.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3769.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3771.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3772.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3797.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3798.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3799.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3800.md | 2 +- 25 files changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md index eda0e59dd9b..af13ca3a273 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md @@ -8,7 +8,7 @@ ms.assetid: ed311315-cc32-49c9-97fa-01b293d81526 --- # Compiler Error C3741 -'class': must be a coclass when the 'layout_dependent' parameter of event_receiver = true +> 'class': must be a coclass when the 'layout_dependent' parameter of event_receiver = true When `layout_dependent=true` for an [event_receiver](../../windows/attributes/event-receiver.md) class, then the class must also have the [coclass](../../windows/attributes/coclass.md) attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md index 6cabeee37af..229bcf359ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md @@ -8,7 +8,7 @@ ms.assetid: 7ca9a76e-7b60-46d1-ab8b-18600cf1a306 --- # Compiler Error C3743 -can only hook/unhook an entire interface when the 'layout_dependent' parameter of event_receiver is true +> can only hook/unhook an entire interface when the 'layout_dependent' parameter of event_receiver is true The [__unhook](../../cpp/unhook.md) function varies in the number of parameters that it takes based on the value passed to the `layout_dependent` parameter in the [event_receiver](../../windows/attributes/event-receiver.md) class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3744.md b/docs/error-messages/compiler-errors-2/compiler-error-c3744.md index 289ae4d140b..71f997878dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3744.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3744.md @@ -8,7 +8,7 @@ ms.assetid: a447d050-80d1-406a-9a6e-f15c527d717c --- # Compiler Error C3744 -__unhook must have at least 3 arguments for managed events +> __unhook must have at least 3 arguments for managed events The [`__unhook`](../../cpp/unhook.md) function must take three parameters when used in a program that is compiled for Managed Extensions for C++. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md index 1959d9bdeca..3a4dfeb7637 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md @@ -8,7 +8,7 @@ ms.assetid: 1e64aec5-7e53-47e5-bc7d-3905230cfc66 --- # Compiler Error C3745 -'function': only an event can be 'raised' +> 'function': only an event can be 'raised' Only a function defined with the [__event](../../cpp/event.md) keyword can be passed to the [__raise](../../cpp/raise.md) keyword. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md index 0b9fbeab007..748b86abb6b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md @@ -8,7 +8,7 @@ ms.assetid: a9a4be67-5d9c-4dcc-9ae9-baae46cbecde --- # Compiler Error C3747 -missing default type parameter : parameter param +> missing default type parameter : parameter param Generic or template parameters with default values cannot be followed in the parameter list by parameters that do not have default values. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md index f2f54266dfc..29ec78c8afe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md @@ -8,7 +8,7 @@ ms.assetid: 6fe71a0a-dd93-4ce6-9729-b9616360cf34 --- # Compiler Error C3748 -'interface': managed interfaces may not fire events +> 'interface': managed interfaces may not fire events The [__event](../../cpp/event.md) keyword cannot appear inside an interface. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md index d31c3c0c67a..57290d1dc7a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md @@ -8,7 +8,7 @@ ms.assetid: 3d26b468-4757-41b8-b5a2-78022a5295fb --- # Compiler Error C3749 -'attribute': a custom attribute may not be used inside a function +> 'attribute': a custom attribute may not be used inside a function A custom attribute cannot be used inside a function. For more information on custom attributes, see the topic [attribute](../../windows/attributes/attribute.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3752.md b/docs/error-messages/compiler-errors-2/compiler-error-c3752.md index 31df4234c49..5ae95779957 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3752.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3752.md @@ -8,6 +8,6 @@ ms.assetid: 1ac81d85-0f5a-4f39-95b6-42fd43cb18d5 --- # Compiler Error C3752 -'attribute class': cannot classify attribute; 'keyword' should not be used in this context +> 'attribute class': cannot classify attribute; 'keyword' should not be used in this context A user-defined attribute was applied incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md index 54464a9469b..9a1023d12e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md @@ -8,7 +8,7 @@ ms.assetid: a5b99e28-796c-4107-a673-97c2ae3bb2b9 --- # Compiler Error C3753 -a generic property is not allowed +> a generic property is not allowed Generic parameter lists can only appear on managed classes, structs, or functions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md index f35e3c280a1..71c4af19362 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md @@ -8,7 +8,7 @@ ms.assetid: 14b877bc-9277-40ec-af1c-196a58b45f10 --- # Compiler Error C3754 -delegate constructor: member function 'function' cannot be called on an instance of type 'type' +> delegate constructor: member function 'function' cannot be called on an instance of type 'type' A call was made to a function through a pointer to a type that does not contain the function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md index 0f31bab3a5a..d88b1aa2165 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md @@ -8,7 +8,7 @@ ms.assetid: 9317b55e-a52e-4b87-b915-5a208d6eda38 --- # Compiler Error C3755 -'delegate': a delegate may not be defined +> 'delegate': a delegate may not be defined A [delegate (C++ Component Extensions)](../../extensions/delegate-cpp-component-extensions.md) can be declared but not defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md index 3b30366f458..085866535b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md @@ -8,7 +8,7 @@ ms.assetid: 0c16f093-7a78-4838-b90b-0c67ef6e9270 --- # Compiler Error C3761 -'function': 'retval' can only appear on the last argument of a function +> 'function': 'retval' can only appear on the last argument of a function The [retval](../../windows/attributes/retval.md) attribute was used on a function argument that was not the last argument in the list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3762.md b/docs/error-messages/compiler-errors-2/compiler-error-c3762.md index 03925fb2115..72118d7fb02 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3762.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3762.md @@ -8,6 +8,6 @@ ms.assetid: b79b6506-2cea-44a0-855a-5fdcb9fd7ad9 --- # Compiler Error C3762 -unable to process attribute 'attribute' +> unable to process attribute 'attribute' A user-defined attribute that inherits from `System.Security.Permissions.SecurityAttribute` is being used to define a security attribute. Such an attribute cannot be used in the same assembly where it is defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md index 0166ca13a41..ac8e1e442eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md @@ -8,7 +8,7 @@ ms.assetid: 58b1f079-cd1d-46e0-9431-ea18210106b7 --- # Compiler Error C3763 -'type': 'retval' and 'out' can only appear on a data-pointer type +> 'type': 'retval' and 'out' can only appear on a data-pointer type The [out](../../windows/attributes/out-cpp.md) or [retval](../../windows/attributes/retval.md) attributes can only appear on parameters of type pointer. Either remove the attribute or make the parameter of type pointer. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md index ea866633a68..829cfb2662d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md @@ -8,7 +8,7 @@ ms.assetid: af5d254c-8d4a-4dda-aad9-3c5c1257c868 --- # Compiler Error C3764 -'override_function': cannot override base class method 'base_class_function' +> 'override_function': cannot override base class method 'base_class_function' The compiler detected an ill-formed override. For example, the base class function was not **`virtual`**. For more information, see [override](../../extensions/override-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md index 6091aaa1b07..284b489e00f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md @@ -8,7 +8,7 @@ ms.assetid: feadee7a-fcfb-402c-af2f-0e656f814a13 --- # Compiler Error C3765 -'event': cannot define an event in a class/struct 'type' marked as an event_receiver +> 'event': cannot define an event in a class/struct 'type' marked as an event_receiver If a class is marked with the [event_receiver](../../windows/attributes/event-receiver.md) attribute, the class cannot contain an [__event](../../cpp/event.md) declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md index 9e4127d7f5d..3f3ac7379c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md @@ -8,7 +8,7 @@ ms.assetid: b5af2089-2e1e-4e45-a41d-495b6c55656e --- # Compiler Error C3766 -'type' must provide an implementation for the interface method 'function' +> 'type' must provide an implementation for the interface method 'function' A class that inherits from an interface must implement the interface members. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md index 9a9ed09b2b3..dd99598ac7e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md @@ -8,7 +8,7 @@ ms.assetid: 5247cdcd-639c-4527-bd37-37e74c4e8fab --- # Compiler Error C3767 -'function' candidate function(s) not accessible +> 'function' candidate function(s) not accessible A friend function defined in a class is not supposed to be treated as if it were defined and declared in the global namespace scope. It can, however, be found by argument-dependent lookup. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md index 47aa0fda651..01478fdc482 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md @@ -8,7 +8,7 @@ ms.assetid: 341675e1-7428-4da6-8275-1b2f0a70dacc --- # Compiler Error C3769 -'type' : a nested class cannot have the same name as the immediately enclosing class +> 'type' : a nested class cannot have the same name as the immediately enclosing class A nested class cannot have the same name as the immediately enclosing class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md index bdcf2c8966d..a70b8c7564e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3771"] --- # Compiler Error C3771 -"identifier" : friend declaration cannot be found in the nearest namespace scope +> "identifier" : friend declaration cannot be found in the nearest namespace scope The class template declaration for the specified template *identifier* cannot be found within the current namespace. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3772.md b/docs/error-messages/compiler-errors-2/compiler-error-c3772.md index 042a708d93a..9b1ce1efe94 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3772.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3772.md @@ -8,7 +8,7 @@ ms.assetid: 63e938d4-088d-41cc-a562-5881a05b5710 --- # Compiler Error C3772 -"name" : invalid friend template declaration +> "name" : invalid friend template declaration It is invalid to declare a friend of a class template specialization. You cannot declare an explicit or partial specialization of a class template and in the same statement declare a friend of that specialization. The *name* placeholder identifies the invalid declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md index 22e95517bff..fa1d2efcf2e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md @@ -8,7 +8,7 @@ ms.assetid: ab27ff34-8c1d-4297-b004-9e39bd3a4f25 --- # Compiler Error C3797 -'override': event declaration cannot have override specifier (should be placed on event add/remove/raise methods instead) +> 'override': event declaration cannot have override specifier (should be placed on event add/remove/raise methods instead) You cannot override a trivial event (an event without explicitly defined accessor methods) with another trivial event. The overriding event must define its behavior with accessor functions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md index c0916d81b5b..5be85ea618b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md @@ -8,7 +8,7 @@ ms.assetid: b2f8b1d8-8812-49b8-a346-28e48f02ba5c --- # Compiler Error C3798 -'specifier': property declaration cannot have override specifier (should be placed on property get/set methods instead) +> 'specifier': property declaration cannot have override specifier (should be placed on property get/set methods instead) A property was declared incorrectly. For more information, see diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md index 7a9f3980f9e..11a50614ab0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md @@ -8,7 +8,7 @@ ms.assetid: 336a2811-9370-4e6e-b03b-325bda470805 --- # Compiler Error C3799 -indexed property cannot have an empty parameter list +> indexed property cannot have an empty parameter list 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). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3800.md b/docs/error-messages/compiler-errors-2/compiler-error-c3800.md index 4d21036576b..7da977bc6b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3800.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3800.md @@ -8,7 +8,7 @@ ms.assetid: c653240a-b6db-4437-8d65-fa58f0e6fcf4 --- # Compiler Error C3800 -'declaration': cannot mix properties and events +> 'declaration': cannot mix properties and events You cannot declare a construct to be both a property and an event. From 87b93d2d752da0df5252d7005c443f4c038c6a7a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 23:39:32 +0800 Subject: [PATCH 0904/1799] Add "Remarks" and "Example" headings for error references in range [C3741, C3800] --- .../compiler-errors-2/compiler-error-c3741.md | 4 ++++ .../compiler-errors-2/compiler-error-c3743.md | 4 ++++ .../compiler-errors-2/compiler-error-c3744.md | 2 ++ .../compiler-errors-2/compiler-error-c3745.md | 4 ++++ .../compiler-errors-2/compiler-error-c3747.md | 4 ++++ .../compiler-errors-2/compiler-error-c3748.md | 4 ++++ .../compiler-errors-2/compiler-error-c3749.md | 2 ++ .../compiler-errors-2/compiler-error-c3752.md | 2 ++ .../compiler-errors-2/compiler-error-c3753.md | 2 ++ .../compiler-errors-2/compiler-error-c3754.md | 2 ++ .../compiler-errors-2/compiler-error-c3755.md | 2 ++ .../compiler-errors-2/compiler-error-c3761.md | 4 ++++ .../compiler-errors-2/compiler-error-c3762.md | 2 ++ .../compiler-errors-2/compiler-error-c3763.md | 4 ++++ .../compiler-errors-2/compiler-error-c3764.md | 2 ++ .../compiler-errors-2/compiler-error-c3765.md | 4 ++++ .../compiler-errors-2/compiler-error-c3766.md | 2 ++ .../compiler-errors-2/compiler-error-c3767.md | 4 +++- .../compiler-errors-2/compiler-error-c3769.md | 2 ++ .../compiler-errors-2/compiler-error-c3771.md | 2 ++ .../compiler-errors-2/compiler-error-c3772.md | 2 ++ .../compiler-errors-2/compiler-error-c3779.md | 6 +++--- .../compiler-errors-2/compiler-error-c3797.md | 2 ++ .../compiler-errors-2/compiler-error-c3798.md | 2 ++ .../compiler-errors-2/compiler-error-c3799.md | 2 ++ .../compiler-errors-2/compiler-error-c3800.md | 2 ++ 26 files changed, 70 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md index af13ca3a273..48ce47753b3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md @@ -10,8 +10,12 @@ ms.assetid: ed311315-cc32-49c9-97fa-01b293d81526 > 'class': must be a coclass when the 'layout_dependent' parameter of event_receiver = true +## Remarks + When `layout_dependent=true` for an [event_receiver](../../windows/attributes/event-receiver.md) class, then the class must also have the [coclass](../../windows/attributes/coclass.md) attribute. +## Example + The following sample generates C3741 ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md index 229bcf359ef..b928fc739fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md @@ -10,8 +10,12 @@ ms.assetid: 7ca9a76e-7b60-46d1-ab8b-18600cf1a306 > can only hook/unhook an entire interface when the 'layout_dependent' parameter of event_receiver is true +## Remarks + The [__unhook](../../cpp/unhook.md) function varies in the number of parameters that it takes based on the value passed to the `layout_dependent` parameter in the [event_receiver](../../windows/attributes/event-receiver.md) class. +## Example + The following sample generates C3743: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3744.md b/docs/error-messages/compiler-errors-2/compiler-error-c3744.md index 71f997878dc..7975c574041 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3744.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3744.md @@ -10,6 +10,8 @@ ms.assetid: a447d050-80d1-406a-9a6e-f15c527d717c > __unhook must have at least 3 arguments for managed events +## Remarks + The [`__unhook`](../../cpp/unhook.md) function must take three parameters when used in a program that is compiled for Managed Extensions for C++. **`__hook`** and **`__unhook`** are not compatible with **`/clr`** programming. Use the += and -= operators instead. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md index 3a4dfeb7637..59a54f8fe91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md @@ -10,8 +10,12 @@ ms.assetid: 1e64aec5-7e53-47e5-bc7d-3905230cfc66 > 'function': only an event can be 'raised' +## Remarks + Only a function defined with the [__event](../../cpp/event.md) keyword can be passed to the [__raise](../../cpp/raise.md) keyword. +## Example + The following sample generates C3745: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md index 748b86abb6b..25303119b85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md @@ -10,8 +10,12 @@ ms.assetid: a9a4be67-5d9c-4dcc-9ae9-baae46cbecde > missing default type parameter : parameter param +## Remarks + Generic or template parameters with default values cannot be followed in the parameter list by parameters that do not have default values. +## Example + The following sample generates C3747: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md index 29ec78c8afe..9b3716597f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md @@ -10,8 +10,12 @@ ms.assetid: 6fe71a0a-dd93-4ce6-9729-b9616360cf34 > 'interface': managed interfaces may not fire events +## Remarks + The [__event](../../cpp/event.md) keyword cannot appear inside an interface. +## Example + The following sample generates C3748: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md index 57290d1dc7a..a0013bb6a36 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md @@ -10,6 +10,8 @@ ms.assetid: 3d26b468-4757-41b8-b5a2-78022a5295fb > 'attribute': a custom attribute may not be used inside a function +## Remarks + A custom attribute cannot be used inside a function. For more information on custom attributes, see the topic [attribute](../../windows/attributes/attribute.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3752.md b/docs/error-messages/compiler-errors-2/compiler-error-c3752.md index 5ae95779957..e06b3a748e3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3752.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3752.md @@ -10,4 +10,6 @@ ms.assetid: 1ac81d85-0f5a-4f39-95b6-42fd43cb18d5 > 'attribute class': cannot classify attribute; 'keyword' should not be used in this context +## Remarks + A user-defined attribute was applied incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md index 9a1023d12e2..c0a328eb0ae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md @@ -10,6 +10,8 @@ ms.assetid: a5b99e28-796c-4107-a673-97c2ae3bb2b9 > a generic property is not allowed +## Remarks + Generic parameter lists can only appear on managed classes, structs, or functions. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md) and [property](../../extensions/property-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md index 71c4af19362..317839d0dcb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md @@ -10,6 +10,8 @@ ms.assetid: 14b877bc-9277-40ec-af1c-196a58b45f10 > delegate constructor: member function 'function' cannot be called on an instance of type 'type' +## Remarks + A call was made to a function through a pointer to a type that does not contain the function. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md index d88b1aa2165..a8cdad05943 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md @@ -10,6 +10,8 @@ ms.assetid: 9317b55e-a52e-4b87-b915-5a208d6eda38 > 'delegate': a delegate may not be defined +## Remarks + A [delegate (C++ Component Extensions)](../../extensions/delegate-cpp-component-extensions.md) can be declared but not defined. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md index 085866535b0..68ecf0733a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md @@ -10,8 +10,12 @@ ms.assetid: 0c16f093-7a78-4838-b90b-0c67ef6e9270 > 'function': 'retval' can only appear on the last argument of a function +## Remarks + The [retval](../../windows/attributes/retval.md) attribute was used on a function argument that was not the last argument in the list. +## Example + The following sample generates C3761: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3762.md b/docs/error-messages/compiler-errors-2/compiler-error-c3762.md index 72118d7fb02..6ce364d55a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3762.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3762.md @@ -10,4 +10,6 @@ ms.assetid: b79b6506-2cea-44a0-855a-5fdcb9fd7ad9 > unable to process attribute 'attribute' +## Remarks + A user-defined attribute that inherits from `System.Security.Permissions.SecurityAttribute` is being used to define a security attribute. Such an attribute cannot be used in the same assembly where it is defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md index ac8e1e442eb..26a04d73f79 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md @@ -10,8 +10,12 @@ ms.assetid: 58b1f079-cd1d-46e0-9431-ea18210106b7 > 'type': 'retval' and 'out' can only appear on a data-pointer type +## Remarks + The [out](../../windows/attributes/out-cpp.md) or [retval](../../windows/attributes/retval.md) attributes can only appear on parameters of type pointer. Either remove the attribute or make the parameter of type pointer. +## Example + The following sample generates C3763: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md index 829cfb2662d..1fd62bbab8e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md @@ -10,6 +10,8 @@ ms.assetid: af5d254c-8d4a-4dda-aad9-3c5c1257c868 > 'override_function': cannot override base class method 'base_class_function' +## Remarks + The compiler detected an ill-formed override. For example, the base class function was not **`virtual`**. For more information, see [override](../../extensions/override-cpp-component-extensions.md). ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md index 284b489e00f..927fc3db609 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md @@ -10,8 +10,12 @@ ms.assetid: feadee7a-fcfb-402c-af2f-0e656f814a13 > 'event': cannot define an event in a class/struct 'type' marked as an event_receiver +## Remarks + If a class is marked with the [event_receiver](../../windows/attributes/event-receiver.md) attribute, the class cannot contain an [__event](../../cpp/event.md) declaration. +## Example + The following sample generates C3765: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md index 3f3ac7379c1..e4e6af879b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md @@ -10,6 +10,8 @@ ms.assetid: b5af2089-2e1e-4e45-a41d-495b6c55656e > 'type' must provide an implementation for the interface method 'function' +## Remarks + A class that inherits from an interface must implement the interface members. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md index dd99598ac7e..9366196e356 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md @@ -10,11 +10,13 @@ ms.assetid: 5247cdcd-639c-4527-bd37-37e74c4e8fab > 'function' candidate function(s) not accessible +## Remarks + A friend function defined in a class is not supposed to be treated as if it were defined and declared in the global namespace scope. It can, however, be found by argument-dependent lookup. C3767 may also be caused by a breaking change: native types are now private by default in a **/clr** compilation; see [Type visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Type_visibility) for more information. -## Example +## Examples The following sample generates C3767: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md index 01478fdc482..025be55a44b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md @@ -10,6 +10,8 @@ ms.assetid: 341675e1-7428-4da6-8275-1b2f0a70dacc > 'type' : a nested class cannot have the same name as the immediately enclosing class +## Remarks + A nested class cannot have the same name as the immediately enclosing class. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md index a70b8c7564e..3b950fed268 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C3771"] > "identifier" : friend declaration cannot be found in the nearest namespace scope +## Remarks + The class template declaration for the specified template *identifier* cannot be found within the current namespace. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3772.md b/docs/error-messages/compiler-errors-2/compiler-error-c3772.md index 9b1ce1efe94..6ae66fdfa07 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3772.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3772.md @@ -10,6 +10,8 @@ ms.assetid: 63e938d4-088d-41cc-a562-5881a05b5710 > "name" : invalid friend template declaration +## Remarks + It is invalid to declare a friend of a class template specialization. You cannot declare an explicit or partial specialization of a class template and in the same statement declare a friend of that specialization. The *name* placeholder identifies the invalid declaration. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3779.md b/docs/error-messages/compiler-errors-2/compiler-error-c3779.md index 1f113ff903b..68b51983ef6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3779.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3779.md @@ -9,13 +9,13 @@ helpviewer_keywords: ["C3779"] > '*function*': a function that returns '*auto or decltype(auto)*' cannot be used before it is defined -The **`auto`** return type of the specified function call couldn't be deduced. The compiler didn't have enough information at the call site. - ## Remarks +The **`auto`** return type of the specified function call couldn't be deduced. The compiler didn't have enough information at the call site. + This error can occur when you call a forward-declared member function that has an **`auto`** return type but no body or trailing return type. You can also get this error when the compiler can't find a candidate return type when it instantiates a template specialization. A common cause of this error is a missing interface header. The missing type can often be determined from the typename mentioned in a note that follows this error. To resolve this issue, for every type you use, include the header for the namespace the type is in. -## Examples +## Example The following C++/WinRT sample generates C3779: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md index fa1d2efcf2e..19c94bd52f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md @@ -10,6 +10,8 @@ ms.assetid: ab27ff34-8c1d-4297-b004-9e39bd3a4f25 > 'override': event declaration cannot have override specifier (should be placed on event add/remove/raise methods instead) +## Remarks + You cannot override a trivial event (an event without explicitly defined accessor methods) with another trivial event. The overriding event must define its behavior with accessor functions. For more information, see [event](../../extensions/event-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md index 5be85ea618b..1c534fab957 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md @@ -10,6 +10,8 @@ ms.assetid: b2f8b1d8-8812-49b8-a346-28e48f02ba5c > 'specifier': property declaration cannot have override specifier (should be placed on property get/set methods instead) +## Remarks + A property was declared incorrectly. For more information, see - [property](../../extensions/property-cpp-component-extensions.md) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md index 11a50614ab0..dd00d27ee50 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md @@ -10,6 +10,8 @@ ms.assetid: 336a2811-9370-4e6e-b03b-325bda470805 > indexed property cannot have an empty parameter list +## 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-c3800.md b/docs/error-messages/compiler-errors-2/compiler-error-c3800.md index 7da977bc6b0..1a9b710d999 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3800.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3800.md @@ -10,6 +10,8 @@ ms.assetid: c653240a-b6db-4437-8d65-fa58f0e6fcf4 > 'declaration': cannot mix properties and events +## Remarks + You cannot declare a construct to be both a property and an event. C3800 is only reachable using the obsolete compiler option **/clr:oldSyntax**. From 1f733b861afdfa6b297b658d166a52365a260512 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 23:41:09 +0800 Subject: [PATCH 0905/1799] Replace term "sample" with "example" for error references in range [C3741, C3800] --- docs/error-messages/compiler-errors-2/compiler-error-c3741.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3743.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3745.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3747.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3748.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3749.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3753.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3754.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3755.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3761.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3763.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3764.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3765.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3766.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3767.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3768.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3769.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3779.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3797.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3798.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3799.md | 2 +- 21 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md index 48ce47753b3..855eb1a529a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md @@ -16,7 +16,7 @@ When `layout_dependent=true` for an [event_receiver](../../windows/attributes/ev ## Example -The following sample generates C3741 +The following example generates C3741 ```cpp // C3741.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md index b928fc739fe..40bcf953785 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md @@ -16,7 +16,7 @@ The [__unhook](../../cpp/unhook.md) function varies in the number of parameters ## Example -The following sample generates C3743: +The following example generates C3743: ```cpp // C3743.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md index 59a54f8fe91..5353aeb550e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md @@ -16,7 +16,7 @@ Only a function defined with the [__event](../../cpp/event.md) keyword can be pa ## Example -The following sample generates C3745: +The following example generates C3745: ```cpp // C3745.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md index 25303119b85..713a79a4d10 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md @@ -16,7 +16,7 @@ Generic or template parameters with default values cannot be followed in the par ## Example -The following sample generates C3747: +The following example generates C3747: ```cpp // C3747.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md index 9b3716597f2..6d4b6af1af4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md @@ -16,7 +16,7 @@ The [__event](../../cpp/event.md) keyword cannot appear inside an interface. ## Example -The following sample generates C3748: +The following example generates C3748: ```cpp // C3748.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md index a0013bb6a36..41be1e97d24 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md @@ -16,7 +16,7 @@ A custom attribute cannot be used inside a function. For more information on cus ## Example -The following sample generates C3749: +The following example generates C3749: ```cpp // C3749a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md index c0a328eb0ae..163e20568a5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md @@ -18,7 +18,7 @@ For more information, see [Generics](../../extensions/generics-cpp-component-ext ## Example -The following sample generates C3753. +The following example generates C3753. ```cpp // C3753.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md index 317839d0dcb..9169bbfac6b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md @@ -16,7 +16,7 @@ A call was made to a function through a pointer to a type that does not contain ## Example -The following sample generates C3754: +The following example generates C3754: ```cpp // C3754a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md index a8cdad05943..69f36a326b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md @@ -16,7 +16,7 @@ A [delegate (C++ Component Extensions)](../../extensions/delegate-cpp-component ## Examples -The following sample generates C3755. +The following example generates C3755. ```cpp // C3755.cpp @@ -24,7 +24,7 @@ The following sample generates C3755. delegate void MyDel() {}; // C3755 ``` -C3755 can also occur if you attempt to create a delegate template. The following sample generates C3755. +C3755 can also occur if you attempt to create a delegate template. The following example generates C3755. ```cpp // C3755_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md index 68ecf0733a6..7bb40a8cddc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md @@ -16,7 +16,7 @@ The [retval](../../windows/attributes/retval.md) attribute was used on a functio ## Example -The following sample generates C3761: +The following example generates C3761: ```cpp // C3761.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md index 26a04d73f79..aec3ec8e35e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md @@ -16,7 +16,7 @@ The [out](../../windows/attributes/out-cpp.md) or [retval](../../windows/attribu ## Example -The following sample generates C3763: +The following example generates C3763: ```cpp // C3763.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md index 1fd62bbab8e..42f4dec37df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md @@ -16,7 +16,7 @@ The compiler detected an ill-formed override. For example, the base class functi ## Examples -The following sample generates C3764. +The following example generates C3764. ```cpp // C3764.cpp @@ -32,7 +32,7 @@ public ref struct B : A { }; ``` -C3764 can also occur when a base class method is both explicitly and named overridden. The following sample generates C3764. +C3764 can also occur when a base class method is both explicitly and named overridden. The following example generates C3764. ```cpp // C3764_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md index 927fc3db609..7ab855aadf4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md @@ -16,7 +16,7 @@ If a class is marked with the [event_receiver](../../windows/attributes/event-re ## Example -The following sample generates C3765: +The following example generates C3765: ```cpp // C3765.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md index e4e6af879b6..a7aee6fc1da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md @@ -16,7 +16,7 @@ A class that inherits from an interface must implement the interface members. ## Example -The following sample generates C3766. +The following example generates C3766. ```cpp // C3766.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md index 9366196e356..dbcd124e9ba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md @@ -18,7 +18,7 @@ C3767 may also be caused by a breaking change: native types are now private by d ## Examples -The following sample generates C3767: +The following example generates C3767: ```cpp // C3767a.cpp @@ -49,7 +49,7 @@ int main() { }; ``` -The following sample generates C3767: +The following example generates C3767: ```cpp // C3767c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3768.md b/docs/error-messages/compiler-errors-2/compiler-error-c3768.md index 8bf47793aea..3d7f24b19ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3768.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3768.md @@ -18,7 +18,7 @@ When compiling with **/clr:pure**, you cannot take the address of a virtual `var ## Example -The following sample generates C3768: +The following example generates C3768: ```cpp // C3768.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md index 025be55a44b..40297fde8d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md @@ -16,7 +16,7 @@ A nested class cannot have the same name as the immediately enclosing class. ## Example -The following sample generates C3769. +The following example generates C3769. ```cpp // C3769.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3779.md b/docs/error-messages/compiler-errors-2/compiler-error-c3779.md index 68b51983ef6..279ee4ee6e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3779.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3779.md @@ -17,7 +17,7 @@ This error can occur when you call a forward-declared member function that has a ## Example -The following C++/WinRT sample generates C3779: +The following C++/WinRT example generates C3779: ```cpp // C3779.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md index 19c94bd52f7..4dd46b23b0c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md @@ -18,7 +18,7 @@ For more information, see [event](../../extensions/event-cpp-component-extension ## Example -The following sample generates C3797. +The following example generates C3797. ```cpp // C3797.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md index 1c534fab957..0ec191fae94 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md @@ -22,7 +22,7 @@ A property was declared incorrectly. For more information, see ## Example -The following sample generates C3798 +The following example generates C3798 ```cpp // C3798.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md index dd00d27ee50..653d4657e6d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md @@ -16,7 +16,7 @@ An indexed property was declared incorrectly. For more information, see [How to: ## Example -The following sample generates C3799 and shows how to fix it. +The following example generates C3799 and shows how to fix it. ```cpp // C3799.cpp From e3b8abd890aae6cce08ba9f7a2126cadaf714b7f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Fri, 22 Aug 2025 23:45:27 +0800 Subject: [PATCH 0906/1799] Update metadata for error references in range [C3741, C3800] --- .../error-messages/compiler-errors-2/compiler-error-c3741.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3743.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3744.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3745.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3747.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3748.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3749.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3752.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3753.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3754.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3755.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3761.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3762.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3763.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3764.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3765.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3766.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3767.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3768.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3769.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3772.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3779.md | 2 +- .../error-messages/compiler-errors-2/compiler-error-c3797.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3798.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3799.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3800.md | 5 ++--- 26 files changed, 51 insertions(+), 76 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md index 855eb1a529a..9fabe12afba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3741" title: "Compiler Error C3741" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3741" +ms.date: 11/04/2016 f1_keywords: ["C3741"] helpviewer_keywords: ["C3741"] -ms.assetid: ed311315-cc32-49c9-97fa-01b293d81526 --- # Compiler Error C3741 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md index 40bcf953785..eeb1dc1a848 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3743" title: "Compiler Error C3743" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3743" +ms.date: 11/04/2016 f1_keywords: ["C3743"] helpviewer_keywords: ["C3743"] -ms.assetid: 7ca9a76e-7b60-46d1-ab8b-18600cf1a306 --- # Compiler Error C3743 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3744.md b/docs/error-messages/compiler-errors-2/compiler-error-c3744.md index 7975c574041..7edb6d976b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3744.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3744.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3744" title: "Compiler Error C3744" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3744" +ms.date: 11/04/2016 f1_keywords: ["C3744"] helpviewer_keywords: ["C3744"] -ms.assetid: a447d050-80d1-406a-9a6e-f15c527d717c --- # Compiler Error C3744 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md index 5353aeb550e..480fca90e6a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3745" title: "Compiler Error C3745" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3745" +ms.date: 11/04/2016 f1_keywords: ["C3745"] helpviewer_keywords: ["C3745"] -ms.assetid: 1e64aec5-7e53-47e5-bc7d-3905230cfc66 --- # Compiler Error C3745 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md index 713a79a4d10..deba5ccb381 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3747" title: "Compiler Error C3747" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3747" +ms.date: 11/04/2016 f1_keywords: ["C3747"] helpviewer_keywords: ["C3747"] -ms.assetid: a9a4be67-5d9c-4dcc-9ae9-baae46cbecde --- # Compiler Error C3747 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md index 6d4b6af1af4..ba2b46ba8f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3748" title: "Compiler Error C3748" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3748" +ms.date: 11/04/2016 f1_keywords: ["C3748"] helpviewer_keywords: ["C3748"] -ms.assetid: 6fe71a0a-dd93-4ce6-9729-b9616360cf34 --- # Compiler Error C3748 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md index 41be1e97d24..605a68c8fc6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3749" title: "Compiler Error C3749" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3749" +ms.date: 11/04/2016 f1_keywords: ["C3749"] helpviewer_keywords: ["C3749"] -ms.assetid: 3d26b468-4757-41b8-b5a2-78022a5295fb --- # Compiler Error C3749 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3752.md b/docs/error-messages/compiler-errors-2/compiler-error-c3752.md index e06b3a748e3..3e8f4de3350 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3752.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3752.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3752" title: "Compiler Error C3752" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3752" +ms.date: 11/04/2016 f1_keywords: ["C3752"] helpviewer_keywords: ["C3752"] -ms.assetid: 1ac81d85-0f5a-4f39-95b6-42fd43cb18d5 --- # Compiler Error C3752 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md index 163e20568a5..a455bba26fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3753" title: "Compiler Error C3753" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3753" +ms.date: 11/04/2016 f1_keywords: ["C3753"] helpviewer_keywords: ["C3753"] -ms.assetid: a5b99e28-796c-4107-a673-97c2ae3bb2b9 --- # Compiler Error C3753 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md index 9169bbfac6b..648b8bd64e0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3754" title: "Compiler Error C3754" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3754" +ms.date: 11/04/2016 f1_keywords: ["C3754"] helpviewer_keywords: ["C3754"] -ms.assetid: 14b877bc-9277-40ec-af1c-196a58b45f10 --- # Compiler Error C3754 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md index 69f36a326b4..2ef2709d235 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3755" title: "Compiler Error C3755" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3755" +ms.date: 11/04/2016 f1_keywords: ["C3755"] helpviewer_keywords: ["C3755"] -ms.assetid: 9317b55e-a52e-4b87-b915-5a208d6eda38 --- # Compiler Error C3755 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md index 7bb40a8cddc..7e0d0f90e8d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3761" title: "Compiler Error C3761" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3761" +ms.date: 11/04/2016 f1_keywords: ["C3761"] helpviewer_keywords: ["C3761"] -ms.assetid: 0c16f093-7a78-4838-b90b-0c67ef6e9270 --- # Compiler Error C3761 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3762.md b/docs/error-messages/compiler-errors-2/compiler-error-c3762.md index 6ce364d55a3..a732ee83512 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3762.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3762.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3762" title: "Compiler Error C3762" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3762" +ms.date: 11/04/2016 f1_keywords: ["C3762"] helpviewer_keywords: ["C3762"] -ms.assetid: b79b6506-2cea-44a0-855a-5fdcb9fd7ad9 --- # Compiler Error C3762 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md index aec3ec8e35e..f056026f670 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3763" title: "Compiler Error C3763" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3763" +ms.date: 11/04/2016 f1_keywords: ["C3763"] helpviewer_keywords: ["C3763"] -ms.assetid: 58b1f079-cd1d-46e0-9431-ea18210106b7 --- # Compiler Error C3763 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md index 42f4dec37df..aa4d0782cbc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3764" title: "Compiler Error C3764" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3764" +ms.date: 11/04/2016 f1_keywords: ["C3764"] helpviewer_keywords: ["C3764"] -ms.assetid: af5d254c-8d4a-4dda-aad9-3c5c1257c868 --- # Compiler Error C3764 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md index 7ab855aadf4..cba25055ecc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3765" title: "Compiler Error C3765" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3765" +ms.date: 11/04/2016 f1_keywords: ["C3765"] helpviewer_keywords: ["C3765"] -ms.assetid: feadee7a-fcfb-402c-af2f-0e656f814a13 --- # Compiler Error C3765 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md index a7aee6fc1da..996e2b80d35 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3766" title: "Compiler Error C3766" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3766" +ms.date: 11/04/2016 f1_keywords: ["C3766"] helpviewer_keywords: ["C3766"] -ms.assetid: b5af2089-2e1e-4e45-a41d-495b6c55656e --- # Compiler Error C3766 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md index dbcd124e9ba..c3019dc8a11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3767" title: "Compiler Error C3767" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3767" +ms.date: 11/04/2016 f1_keywords: ["C3767"] helpviewer_keywords: ["C3767"] -ms.assetid: 5247cdcd-639c-4527-bd37-37e74c4e8fab --- # Compiler Error C3767 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3768.md b/docs/error-messages/compiler-errors-2/compiler-error-c3768.md index 3d7f24b19ce..0d49df0bf52 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3768.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3768.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3768" title: "Compiler Error C3768" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3768" +ms.date: 11/04/2016 f1_keywords: ["C3768"] helpviewer_keywords: ["C3768"] -ms.assetid: 091f0d53-1dff-43fd-813d-5c43c85b6ab0 --- # Compiler Error C3768 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md index 40297fde8d6..1109fddfcde 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3769" title: "Compiler Error C3769" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3769" +ms.date: 11/04/2016 f1_keywords: ["C3769"] helpviewer_keywords: ["C3769"] -ms.assetid: 341675e1-7428-4da6-8275-1b2f0a70dacc --- # Compiler Error C3769 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3772.md b/docs/error-messages/compiler-errors-2/compiler-error-c3772.md index 6ae66fdfa07..1cf537711b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3772.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3772.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3772" title: "Compiler Error C3772" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3772" +ms.date: 11/04/2016 f1_keywords: ["C3772"] helpviewer_keywords: ["C3772"] -ms.assetid: 63e938d4-088d-41cc-a562-5881a05b5710 --- # Compiler Error C3772 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3779.md b/docs/error-messages/compiler-errors-2/compiler-error-c3779.md index 279ee4ee6e1..b1029535d73 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3779.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3779.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C3779" title: "Compiler Error C3779" +description: "Learn more about: Compiler Error C3779" ms.date: 05/19/2021 f1_keywords: ["C3779"] helpviewer_keywords: ["C3779"] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md index 4dd46b23b0c..fd98c9b12f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3797" title: "Compiler Error C3797" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3797" +ms.date: 11/04/2016 f1_keywords: ["C3797"] helpviewer_keywords: ["C3797"] -ms.assetid: ab27ff34-8c1d-4297-b004-9e39bd3a4f25 --- # Compiler Error C3797 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md index 0ec191fae94..40ce4ddd31b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3798" title: "Compiler Error C3798" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3798" +ms.date: 11/04/2016 f1_keywords: ["C3798"] helpviewer_keywords: ["C3798"] -ms.assetid: b2f8b1d8-8812-49b8-a346-28e48f02ba5c --- # Compiler Error C3798 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md index 653d4657e6d..7824ef85cb5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3799" title: "Compiler Error C3799" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3799" +ms.date: 11/04/2016 f1_keywords: ["C3799"] helpviewer_keywords: ["C3799"] -ms.assetid: 336a2811-9370-4e6e-b03b-325bda470805 --- # Compiler Error C3799 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3800.md b/docs/error-messages/compiler-errors-2/compiler-error-c3800.md index 1a9b710d999..c2bf14ce9aa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3800.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3800.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3800" title: "Compiler Error C3800" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3800" +ms.date: 11/04/2016 f1_keywords: ["C3800"] helpviewer_keywords: ["C3800"] -ms.assetid: c653240a-b6db-4437-8d65-fa58f0e6fcf4 --- # Compiler Error C3800 From 20ed867bcee116d3fc783d8000ce68863354672c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 01:41:56 +0800 Subject: [PATCH 0907/1799] Structure error references in range [C2291, C2320] (#5570) * Add blockquotes for error messages in range [C2291, C2320] * Add "Remarks" and "Example" headings for error references in range [C2291, C2320] * Replace term "sample" with "example" for error references in range [C2291, C2320] * Update metadata for error references in range [C2291, C2320] --- .../compiler-errors-1/compiler-error-c2292.md | 9 +++++---- .../compiler-errors-1/compiler-error-c2293.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2295.md | 9 +++++---- .../compiler-errors-1/compiler-error-c2296.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2297.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2298.md | 13 +++++++------ .../compiler-errors-1/compiler-error-c2299.md | 7 +++---- .../compiler-errors-1/compiler-error-c2300.md | 9 +++++---- .../compiler-errors-1/compiler-error-c2301.md | 9 +++++---- .../compiler-errors-1/compiler-error-c2302.md | 9 +++++---- .../compiler-errors-1/compiler-error-c2307.md | 9 +++++---- .../compiler-errors-1/compiler-error-c2308.md | 9 +++++---- .../compiler-errors-1/compiler-error-c2309.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2310.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2311.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2312.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2313.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2315.md | 9 +++++---- .../compiler-errors-1/compiler-error-c2316.md | 11 +++++------ .../compiler-errors-1/compiler-error-c2317.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2318.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2319.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2320.md | 7 ++++--- 23 files changed, 147 insertions(+), 106 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2292.md b/docs/error-messages/compiler-errors-1/compiler-error-c2292.md index 45784ec91f4..1b9d0e238de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2292.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2292.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2292" title: "Compiler Error C2292" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2292" +ms.date: 11/04/2016 f1_keywords: ["C2292"] helpviewer_keywords: ["C2292"] -ms.assetid: 256b392f-2b8f-4162-b578-e7633984e162 --- # Compiler Error C2292 -'identifier': best case inheritance representation: 'representation1' declared but 'representation2' required +> 'identifier': best case inheritance representation: 'representation1' declared but 'representation2' required + +## Example Compiling the following code with [/vmb](../../build/reference/vmb-vmg-representation-method.md) ("Best-case always" representation) causes C2292. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2293.md b/docs/error-messages/compiler-errors-1/compiler-error-c2293.md index 6e0833a07e3..d5eb84b0f59 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2293.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2293.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2293" title: "Compiler Error C2293" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2293" +ms.date: 11/04/2016 f1_keywords: ["C2293"] helpviewer_keywords: ["C2293"] -ms.assetid: 17e7b4e2-368b-4dd7-a01b-d82be60f8e56 --- # Compiler Error C2293 -'identifier': illegal to have a member variable as a __based specifier +> 'identifier': illegal to have a member variable as a __based specifier + +## Remarks Specifiers for **`__based`** modifier must be nonmember pointers. -The following sample generates C2293: +## Example + +The following example generates C2293: ```cpp // C2293.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2295.md b/docs/error-messages/compiler-errors-1/compiler-error-c2295.md index 484d1908b7d..f67e5222233 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2295.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2295.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2295" title: "Compiler Error C2295" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2295" +ms.date: 11/04/2016 f1_keywords: ["C2295"] helpviewer_keywords: ["C2295"] -ms.assetid: faddf446-5924-401e-b719-93390d5cd084 --- # Compiler Error C2295 -escaped 'character' : is illegal in macro definition +> escaped 'character' : is illegal in macro definition + +## Remarks A macro definition cannot contain an escape sequence with the specified character. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2296.md b/docs/error-messages/compiler-errors-1/compiler-error-c2296.md index bdd1b4b3d24..a37e7a959bf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2296.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2296.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2296" title: "Compiler Error C2296" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2296" +ms.date: 11/04/2016 f1_keywords: ["C2296"] helpviewer_keywords: ["C2296"] -ms.assetid: 47d270f4-13ce-4c16-81e2-7d67c6c4a540 --- # Compiler Error C2296 -'operator' : bad left operand +> 'operator' : bad left operand + +## Remarks The left operand used with `operator` is invalid. For example, the compiler may see a declaration where you intended a function call. -The following sample generates C2296: +## Example + +The following example generates C2296: ```cpp // C2296.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2297.md b/docs/error-messages/compiler-errors-1/compiler-error-c2297.md index 97ed907a34a..8ce344ccd8b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2297.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2297.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2297" title: "Compiler Error C2297" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2297" +ms.date: 11/04/2016 f1_keywords: ["C2297"] helpviewer_keywords: ["C2297"] -ms.assetid: 65849fe5-17e1-4b7e-b50c-f508b05ddaa4 --- # Compiler Error C2297 -'operator' : bad right operand +> 'operator' : bad right operand + +## Remarks The right operand used with `operator` is invalid. For example, the compiler may see a declaration where you intended a function call. -The following sample generates C2297: +## Example + +The following example generates C2297: ```cpp // C2297.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2298.md b/docs/error-messages/compiler-errors-1/compiler-error-c2298.md index 529c6f15ebc..cddce97fedd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2298.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2298.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2298" title: "Compiler Error C2298" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2298" +ms.date: 11/04/2016 f1_keywords: ["C2298"] helpviewer_keywords: ["C2298"] -ms.assetid: eb0120ad-c850-4bdd-911d-0361229cc859 --- # Compiler Error C2298 -'operation' : illegal operation on pointer to member function expression +> 'operation' : illegal operation on pointer to member function expression + +## Remarks A pointer to member-function expression must call the member function. ## Examples -The following sample generates C2298. +The following example generates C2298. ```cpp // C2298.cpp @@ -48,7 +49,7 @@ int main() { } ``` -The following sample generates C2298. +The following example generates C2298. ```cpp // C2298_b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2299.md b/docs/error-messages/compiler-errors-1/compiler-error-c2299.md index 16cf37d4d9a..ae1494b4035 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2299.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2299.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2299" title: "Compiler Error C2299" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2299" +ms.date: 11/04/2016 f1_keywords: ["C2299"] helpviewer_keywords: ["C2299"] -ms.assetid: d001c2bc-f6fd-47aa-8e42-0eb824d6441d --- # Compiler Error C2299 @@ -18,7 +17,7 @@ To resolve C2299, don't make the copy constructor or assignment operator a funct ## Example -The following sample generates C2299: +The following example generates C2299: ```cpp // C2299.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2300.md b/docs/error-messages/compiler-errors-1/compiler-error-c2300.md index 38fcc87e79f..5727f9ee377 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2300.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2300.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2300" title: "Compiler Error C2300" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2300" +ms.date: 11/04/2016 f1_keywords: ["C2300"] helpviewer_keywords: ["C2300"] -ms.assetid: bb8fed56-feb0-412b-ae7b-04d48b202b78 --- # Compiler Error C2300 -'identifier' : class does not have a destructor called '~identifier' +> 'identifier' : class does not have a destructor called '~identifier' + +## Remarks The class does not have a destructor with the required name. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2301.md b/docs/error-messages/compiler-errors-1/compiler-error-c2301.md index d95b81771a2..95225fd76a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2301.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2301.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2301" title: "Compiler Error C2301" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2301" +ms.date: 11/04/2016 f1_keywords: ["C2301"] helpviewer_keywords: ["C2301"] -ms.assetid: d294a1a2-dc7a-4e18-90b3-747e1a8c51ee --- # Compiler Error C2301 -left of '->~identifier' must point to class/struct/union +> left of '->~identifier' must point to class/struct/union + +## Remarks The expression to the left of the `->` operator does not evaluate to a pointer to a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2302.md b/docs/error-messages/compiler-errors-1/compiler-error-c2302.md index b496d9de753..18abffb5de1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2302.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2302.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2302" title: "Compiler Error C2302" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2302" +ms.date: 11/04/2016 f1_keywords: ["C2302"] helpviewer_keywords: ["C2302"] -ms.assetid: 74a54bab-9d5c-446e-9b1f-c92fb57090a8 --- # Compiler Error C2302 -left of '.~identifier' must have class/struct/union type +> left of '.~identifier' must have class/struct/union type + +## Remarks The expression to the left of the period (.) operator is not a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2307.md b/docs/error-messages/compiler-errors-1/compiler-error-c2307.md index 469a7facd99..69e3890ef35 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2307.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2307.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2307" title: "Compiler Error C2307" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2307" +ms.date: 11/04/2016 f1_keywords: ["C2307"] helpviewer_keywords: ["C2307"] -ms.assetid: ce6c8033-a673-4679-9883-bedec36ae385 --- # Compiler Error C2307 -pragma 'pragma' must be outside function if incremental compilation is enabled +> pragma 'pragma' must be outside function if incremental compilation is enabled + +## Remarks You must place the `data_seg` pragma between functions if you're using incremental compilation. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2308.md b/docs/error-messages/compiler-errors-1/compiler-error-c2308.md index 83af91881dc..60d5d48ec7c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2308.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2308.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2308" title: "Compiler Error C2308" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2308" +ms.date: 11/04/2016 f1_keywords: ["C2308"] helpviewer_keywords: ["C2308"] -ms.assetid: d1eaf101-077d-4c43-97ac-410efd5b6fc9 --- # Compiler Error C2308 -concatenating mismatched strings +> concatenating mismatched strings + +## Remarks Both wide and non-wide character strings were specified for concatenation. You cannot concatenate a wide character string and non-wide character string. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2309.md b/docs/error-messages/compiler-errors-1/compiler-error-c2309.md index 631119862e5..e2d392ca6a8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2309.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2309.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2309" title: "Compiler Error C2309" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2309" +ms.date: 11/04/2016 f1_keywords: ["C2309"] helpviewer_keywords: ["C2309"] -ms.assetid: 6303d5b5-72cf-42b8-92ce-b1eb48e80d48 --- # Compiler Error C2309 -catch handler expected a parenthesized exception declaration +> catch handler expected a parenthesized exception declaration + +## Remarks A catch handler has no parenthesized type. -The following sample generates C2309: +## Example + +The following example generates C2309: ```cpp // C2309.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2310.md b/docs/error-messages/compiler-errors-1/compiler-error-c2310.md index b66045af5f2..401f5456254 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2310.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2310.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2310" title: "Compiler Error C2310" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2310" +ms.date: 11/04/2016 f1_keywords: ["C2310"] helpviewer_keywords: ["C2310"] -ms.assetid: 1969c682-b97e-43fb-b9a9-f783e7ff1710 --- # Compiler Error C2310 -catch handlers must specify one type +> catch handlers must specify one type + +## Remarks A catch handler specified no type or multiple types. -The following sample generates C2310: +## Example + +The following example generates C2310: ```cpp // C2310.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2311.md b/docs/error-messages/compiler-errors-1/compiler-error-c2311.md index 1593deabd62..8b132322598 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2311.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2311.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2311" title: "Compiler Error C2311" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2311" +ms.date: 11/04/2016 f1_keywords: ["C2311"] helpviewer_keywords: ["C2311"] -ms.assetid: 1aff9bd5-ed0b-4db6-bbc0-01ac89850cf2 --- # Compiler Error C2311 -'exception' : is caught by '...' on line number +> 'exception' : is caught by '...' on line number + +## Remarks The catch handler for the ellipsis (...) must be the last handler for a throw. -The following sample generates C2311: +## Example + +The following example generates C2311: ```cpp // C2311.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2312.md b/docs/error-messages/compiler-errors-1/compiler-error-c2312.md index 39b2968286d..81b15ceb6ff 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2312.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2312.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2312" title: "Compiler Error C2312" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2312" +ms.date: 11/04/2016 f1_keywords: ["C2312"] helpviewer_keywords: ["C2312"] -ms.assetid: c8bcfd06-12c1-4323-bb53-ba392d36daa4 --- # Compiler Error C2312 -'exception1' : is caught by 'exception2' on line number +> 'exception1' : is caught by 'exception2' on line number + +## Remarks Two handlers catch the same exception type. -The following sample generates C2312: +## Example + +The following example generates C2312: ```cpp // C2312.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2313.md b/docs/error-messages/compiler-errors-1/compiler-error-c2313.md index 01c0b6c5737..2d71495167d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2313.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2313.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2313" title: "Compiler Error C2313" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2313" +ms.date: 11/04/2016 f1_keywords: ["C2313"] helpviewer_keywords: ["C2313"] -ms.assetid: f70eb19b-c0a3-4fb2-ade1-3890a589928d --- # Compiler Error C2313 -'type1' : is caught by reference ('type2') on line number +> 'type1' : is caught by reference ('type2') on line number + +## Remarks The exception type has two handlers. The type for the second catch is a reference to the type of the first. -The following sample generates C2313: +## Example + +The following example generates C2313: ```cpp // C2313.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2315.md b/docs/error-messages/compiler-errors-1/compiler-error-c2315.md index fc0b04c563f..d6ea11e2f93 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2315.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2315.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2315" title: "Compiler Error C2315" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2315" +ms.date: 11/04/2016 f1_keywords: ["C2315"] helpviewer_keywords: ["C2315"] -ms.assetid: a0d91b81-944c-4a69-9a24-fd484aabcc5c --- # Compiler Error C2315 -'type1' : reference is caught by 'type2' on line number +> 'type1' : reference is caught by 'type2' on line number + +## Remarks The exception type is handled by a previous handler. The reference for the second catch has the type of the first. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2316.md b/docs/error-messages/compiler-errors-1/compiler-error-c2316.md index 6163529aca2..4e208a5fc5b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2316.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2316.md @@ -1,24 +1,23 @@ --- -description: "Learn more about: Compiler Error C2316" title: "Compiler Error C2316" -ms.date: "07/08/2019" +description: "Learn more about: Compiler Error C2316" +ms.date: 07/08/2019 f1_keywords: ["C2316"] helpviewer_keywords: ["C2316"] -ms.assetid: 9ad08eb5-060b-4eb0-8d66-0dc134f7bf67 --- # Compiler Error C2316 > '*class_type*' : cannot be caught as the destructor and/or copy constructor are inaccessible or deleted -An exception was caught by value or by reference, but the copy constructor, the assignment operator, or both were inaccessible. - ## Remarks +An exception was caught by value or by reference, but the copy constructor, the assignment operator, or both were inaccessible. + Conformance changes in Visual Studio 2015 made this error apply to bad catch statements of MFC exceptions derived from `CException`. Because `CException` has an inherited private copy constructor, the class and its derivatives aren't copyable, and can't be passed by value, which also means they can't be caught by value. Catch statements that caught MFC exceptions by value previously led to uncaught exceptions at runtime. Now the compiler correctly identifies this situation and reports error C2316. To fix this issue, we recommend you use the MFC TRY/CATCH macros rather than write your own exception handlers. If that's not appropriate for your code, catch MFC exceptions by reference instead. ## Example -The following sample generates C2316, and shows a way to fix it: +The following example generates C2316, and shows a way to fix it: ```cpp // C2316.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2317.md b/docs/error-messages/compiler-errors-1/compiler-error-c2317.md index 79f823cb0e5..fc575b588a1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2317.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2317.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2317" title: "Compiler Error C2317" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2317" +ms.date: 11/04/2016 f1_keywords: ["C2317"] helpviewer_keywords: ["C2317"] -ms.assetid: e44d129b-8d3e-4ce9-9d79-6791ee77f25e --- # Compiler Error C2317 -'try' block starting on line 'number' has no catch handlers +> 'try' block starting on line 'number' has no catch handlers + +## Remarks A **`try`** block must have at least one catch handler. -The following sample generates C2317: +## Example + +The following example generates C2317: ```cpp // C2317.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2318.md b/docs/error-messages/compiler-errors-1/compiler-error-c2318.md index b5482c8358f..5a67e8cb5a3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2318.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2318.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2318" title: "Compiler Error C2318" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2318" +ms.date: 11/04/2016 f1_keywords: ["C2318"] helpviewer_keywords: ["C2318"] -ms.assetid: 169e30b9-df78-46cb-90bf-576ad3c32fd4 --- # Compiler Error C2318 -no try block associated with this catch handler +> no try block associated with this catch handler + +## Remarks A **`catch`** handler is defined but not preceded by a **`try`** block. -The following sample generates C2318: +## Example + +The following example generates C2318: ```cpp // C2318.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2319.md b/docs/error-messages/compiler-errors-1/compiler-error-c2319.md index 0a9d1381842..87a4c1537f5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2319.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2319.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2319" title: "Compiler Error C2319" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2319" +ms.date: 11/04/2016 f1_keywords: ["C2319"] helpviewer_keywords: ["C2319"] -ms.assetid: 25263e6e-f5ba-4d2c-8727-8c2d8ca2e5ce --- # Compiler Error C2319 -'try/catch' must be followed by a compound statement. Missing '{' +> 'try/catch' must be followed by a compound statement. Missing '{' + +## Remarks A **`try`** or **`catch`** block is not found following the **`try`** or **`catch`** statement. The block must be enclosed in curly braces. -The following sample generates C2319: +## Example + +The following example generates C2319: ```cpp // C2319.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2320.md b/docs/error-messages/compiler-errors-1/compiler-error-c2320.md index 1b9cf5a1050..ea08646bec4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2320.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2320.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2320" title: "Compiler Error C2320" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2320" +ms.date: 11/04/2016 f1_keywords: ["C2320"] helpviewer_keywords: ["C2320"] -ms.assetid: ae78ae1b-364f-4b65-bfb8-8809d5151ca5 --- # Compiler Error C2320 > expected ':' to follow access specifier '*specifier*' +## Remarks + The keyword **`public`**, **`protected`**, or **`private`** must be followed by a colon. From b3fb9c6330f286c9bb0600fa180ffd27b89c4387 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 01:42:27 +0800 Subject: [PATCH 0908/1799] Add `cmd` language for CL and LINK invocations (#5568) * Add `cmd` language for CL invocations * Add `cmd` language for LINK invocations * Update metadata in 13 topics --- docs/build/reference/c-compile-without-linking.md | 9 ++++----- docs/build/reference/cl-invokes-the-linker.md | 7 +++---- docs/build/reference/compiler-command-line-syntax.md | 7 +++---- docs/build/reference/e-preprocess-to-stdout.md | 9 ++++----- ...-preprocess-to-stdout-without-hash-line-directives.md | 7 +++---- docs/build/reference/fd-program-database-file-name.md | 7 +++---- docs/build/reference/fe-name-exe-file.md | 9 ++++----- docs/build/reference/p-preprocess-to-a-file.md | 7 +++---- docs/build/reference/specifying-the-pathname.md | 7 +++---- .../yd-place-debug-information-in-object-file.md | 9 ++++----- .../tool-errors/command-line-warning-d9027.md | 9 ++++----- .../tool-errors/linker-tools-error-lnk2011.md | 7 +++---- .../tool-errors/linker-tools-warning-lnk4105.md | 7 +++---- 13 files changed, 44 insertions(+), 57 deletions(-) diff --git a/docs/build/reference/c-compile-without-linking.md b/docs/build/reference/c-compile-without-linking.md index e552d6a30e2..e1d07952322 100644 --- a/docs/build/reference/c-compile-without-linking.md +++ b/docs/build/reference/c-compile-without-linking.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /c (Compile Without Linking)" title: "/c (Compile Without Linking)" -ms.date: "11/04/2016" +description: "Learn more about: /c (Compile Without Linking)" +ms.date: 11/04/2016 f1_keywords: ["/c"] helpviewer_keywords: ["suppress link", "cl.exe compiler, compiling without linking", "-c compiler option [C++]", "c compiler option [C++]", "/c compiler option [C++]"] -ms.assetid: 8017fc3d-e5dd-4668-a1f7-3120daa95d20 --- # /c (Compile Without Linking) @@ -34,13 +33,13 @@ Any internal project created in the development environment uses the **/c** opti The following command line creates the object files FIRST.obj and SECOND.obj. THIRD.obj is ignored. -``` +```cmd CL /c FIRST.C SECOND.C THIRD.OBJ ``` To create an executable file, you must invoke LINK: -``` +```cmd LINK first.obj second.obj third.obj /OUT:filename.exe ``` diff --git a/docs/build/reference/cl-invokes-the-linker.md b/docs/build/reference/cl-invokes-the-linker.md index 8f01f044f2d..df402a70150 100644 --- a/docs/build/reference/cl-invokes-the-linker.md +++ b/docs/build/reference/cl-invokes-the-linker.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: CL Invokes the Linker" title: "CL Invokes the Linker" -ms.date: "11/04/2016" +description: "Learn more about: CL Invokes the Linker" +ms.date: 11/04/2016 helpviewer_keywords: ["compiling source code [C++], without linking", "invoking linker from the compiler", "LINK tool [C++], invoking from CL compiler", "cl.exe compiler [C++], compiling without linking", "cl.exe compiler [C++], controlling linker"] -ms.assetid: eae47ef7-09eb-40c9-b318-7c714cd452fc --- # CL Invokes the Linker @@ -30,7 +29,7 @@ Assume that you are compiling three C source files: MAIN.c, MOD1.c, and MOD2.c. To build this program, compile with the following command line: -``` +```cmd CL MAIN.c MOD1.C MOD2.C MYGRAPH.lib ``` diff --git a/docs/build/reference/compiler-command-line-syntax.md b/docs/build/reference/compiler-command-line-syntax.md index 0f56baaed54..e34ddaab592 100644 --- a/docs/build/reference/compiler-command-line-syntax.md +++ b/docs/build/reference/compiler-command-line-syntax.md @@ -1,15 +1,14 @@ --- -description: "Learn more about: Compiler Command-Line Syntax" title: "MSVC Compiler Command-Line Syntax" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Command-Line Syntax" +ms.date: 11/04/2016 helpviewer_keywords: ["syntax, CL compiler command line", "cl.exe compiler, command-line syntax"] -ms.assetid: acba2c1c-0803-4a3a-af25-63e849b930a2 --- # Compiler Command-Line Syntax The CL command line uses the following syntax: -``` +```cmd CL [option...] file... [option | file]... [lib...] [@command-file] [/link link-opt...] ``` diff --git a/docs/build/reference/e-preprocess-to-stdout.md b/docs/build/reference/e-preprocess-to-stdout.md index c2e2f9d98f1..7426af03468 100644 --- a/docs/build/reference/e-preprocess-to-stdout.md +++ b/docs/build/reference/e-preprocess-to-stdout.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /E (Preprocess to stdout)" title: "/E (Preprocess to stdout)" -ms.date: "11/04/2016" +description: "Learn more about: /E (Preprocess to stdout)" +ms.date: 11/04/2016 f1_keywords: ["/e"] helpviewer_keywords: ["-E compiler option [C++]", "/E compiler option [C++]", "preprocessor output, copy to stdout", "preprocessor output"] -ms.assetid: ddbb1725-d950-4978-ab2f-30a5cd7b778c --- # /E (Preprocess to stdout) @@ -44,7 +43,7 @@ m(int)main( ) However, if you compile with: -``` +```cmd cl -E test.cpp > test2.cpp ``` @@ -66,7 +65,7 @@ cl -E test.cpp > test2.cpp The following command line preprocesses `ADD.C`, preserves comments, adds `#line` directives, and displays the result on the standard output device: -``` +```cmd CL /E /C ADD.C ``` diff --git a/docs/build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md b/docs/build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md index 0c1deff9db2..61d030c0814 100644 --- a/docs/build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md +++ b/docs/build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /EP (Preprocess to stdout Without #line Directives)" title: "/EP (Preprocess to stdout Without #line Directives)" -ms.date: "11/04/2016" +description: "Learn more about: /EP (Preprocess to stdout Without #line Directives)" +ms.date: 11/04/2016 f1_keywords: ["/ep", "VC.Project.VCCLCompilerTool.GeneratePreprocessedFileNoLines"] helpviewer_keywords: ["copy preprocessor output to stdout", "preprocessor output, copy to stdout", "-EP compiler option [C++]", "EP compiler option [C++]", "/EP compiler option [C++]"] -ms.assetid: 6ec411ae-e33d-4ef5-956e-0054635eabea --- # /EP (Preprocess to stdout Without #line Directives) @@ -46,7 +45,7 @@ You cannot use precompiled headers with the **/EP** option. The following command line preprocesses file `ADD.C`, preserves comments, and displays the result on the standard output device: -``` +```cmd CL /EP /C ADD.C ``` diff --git a/docs/build/reference/fd-program-database-file-name.md b/docs/build/reference/fd-program-database-file-name.md index 7bc387dcf56..c9027012f28 100644 --- a/docs/build/reference/fd-program-database-file-name.md +++ b/docs/build/reference/fd-program-database-file-name.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /Fd (Program Database File Name)" title: "/Fd (Program Database File Name)" -ms.date: "11/04/2016" +description: "Learn more about: /Fd (Program Database File Name)" +ms.date: 11/04/2016 f1_keywords: ["/FD", "VC.Project.VCCLWCECompilerTool.ProgramDataBaseFileName", "VC.Project.VCCLCompilerTool.ProgramDataBaseFileName"] helpviewer_keywords: ["/FD compiler option [C++]", "program database file name [C++]", "-FD compiler option [C++]", "PDB files, creating", "program database compiler option [C++]", ".pdb files, creating", "FD compiler option [C++]"] -ms.assetid: 3977a9ed-f0ac-45df-bf06-01cedd2ba85a --- # /Fd (Program Database File Name) @@ -42,7 +41,7 @@ This option also names the state (.idb) file used for minimal rebuild and increm This command line creates a .pdb file named PROG.pdb and an .idb file named PROG.idb: -``` +```cmd CL /DDEBUG /Zi /FdPROG.PDB PROG.CPP ``` diff --git a/docs/build/reference/fe-name-exe-file.md b/docs/build/reference/fe-name-exe-file.md index 3defab99e37..02c71317a58 100644 --- a/docs/build/reference/fe-name-exe-file.md +++ b/docs/build/reference/fe-name-exe-file.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /Fe (Name EXE File)" title: "/Fe (Name EXE File)" -ms.date: "11/04/2016" +description: "Learn more about: /Fe (Name EXE File)" +ms.date: 11/04/2016 f1_keywords: ["/fe"] helpviewer_keywords: ["-Fe compiler option [C++]", "executable files, renaming", "rename file compiler option [C++]", "/Fe compiler option [C++]", "Fe compiler option [C++]"] -ms.assetid: 49f594fd-5e94-45fe-a1bf-7c9f2abb6437 --- # /Fe (Name EXE File) @@ -44,13 +43,13 @@ If you specify the [/c (Compile Without Linking)](c-compile-without-linking.md) The following command line compiles and links all C source files in the current directory. The resulting executable file is named PROCESS.exe and is created in the directory "C:\Users\User Name\repos\My Project\bin". -``` +```cmd CL /Fe"C:\Users\User Name\repos\My Project\bin\PROCESS" *.C ``` The following command line creates an executable file in `C:\BIN` with the same base name as the first source file in the current directory: -``` +```cmd CL /FeC:\BIN\ *.C ``` diff --git a/docs/build/reference/p-preprocess-to-a-file.md b/docs/build/reference/p-preprocess-to-a-file.md index e65e5a00d03..3f8c51279bc 100644 --- a/docs/build/reference/p-preprocess-to-a-file.md +++ b/docs/build/reference/p-preprocess-to-a-file.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /P (Preprocess to a File)" title: "/P (Preprocess to a File)" -ms.date: "11/04/2016" +description: "Learn more about: /P (Preprocess to a File)" +ms.date: 11/04/2016 f1_keywords: ["VC.Project.VCCLCompilerTool.GeneratePreprocessedFile", "/p", "VC.Project.VCCLWCECompilerTool.GeneratePreprocessedFile"] helpviewer_keywords: ["/P compiler option [C++]", "-P compiler option [C++]", "P compiler option [C++]", "output files, preprocessor", "preprocessing output files"] -ms.assetid: 123ee54f-8219-4a6f-9876-4227023d83fc --- # /P (Preprocess to a File) @@ -40,7 +39,7 @@ The **/P** option suppresses compilation. It does not produce an .obj file, even The following command line preprocesses `ADD.C`, preserves comments, adds `#line` directives, and writes the result to a file, `ADD.I`: -``` +```cmd CL /P /C ADD.C ``` diff --git a/docs/build/reference/specifying-the-pathname.md b/docs/build/reference/specifying-the-pathname.md index 98293ee2a43..55be6dfec95 100644 --- a/docs/build/reference/specifying-the-pathname.md +++ b/docs/build/reference/specifying-the-pathname.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Specifying the Pathname" title: "Specifying the Pathname" -ms.date: "11/04/2016" +description: "Learn more about: Specifying the Pathname" +ms.date: 11/04/2016 helpviewer_keywords: ["names [C++], compiler output files", "cl.exe compiler, output files", "output files, specifying pathnames"] -ms.assetid: 7a6595ce-3383-44ae-957a-466bfa29c343 --- # Specifying the Pathname @@ -24,7 +23,7 @@ Alternatively, the *pathname* argument can be a device name (AUX, CON, PRN, or N The following command line sends a mapfile to the printer: -``` +```cmd CL /FmPRN HELLO.CPP ``` diff --git a/docs/build/reference/yd-place-debug-information-in-object-file.md b/docs/build/reference/yd-place-debug-information-in-object-file.md index b3e9699bb7c..ced560abe33 100644 --- a/docs/build/reference/yd-place-debug-information-in-object-file.md +++ b/docs/build/reference/yd-place-debug-information-in-object-file.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /Yd (Place Debug Information in Object File)" title: "/Yd (Place Debug Information in Object File)" -ms.date: "11/04/2016" +description: "Learn more about: /Yd (Place Debug Information in Object File)" +ms.date: 11/04/2016 f1_keywords: ["/yd"] helpviewer_keywords: ["/Yd compiler option [C++]", "-Yd compiler option [C++]", "debugging [C++], debug information files", "Yd compiler option [C++]"] -ms.assetid: c5a699fe-65ce-461e-964c-7f5eb2a8320a --- # /Yd (Place Debug Information in Object File) @@ -55,13 +54,13 @@ Suppose you have two base files, F.cpp and G.cpp, each containing these **#inclu The following command creates the precompiled header file ETC.pch and the object file F.obj: -``` +```cmd CL /YcETC.H /Z7 F.CPP ``` The object file F.obj includes type and symbol information for WINDOWS.h and ETC.h (and any other header files they include). Now you can use the precompiled header ETC.pch to compile the source file G.cpp: -``` +```cmd CL /YuETC.H /Z7 G.CPP ``` diff --git a/docs/error-messages/tool-errors/command-line-warning-d9027.md b/docs/error-messages/tool-errors/command-line-warning-d9027.md index a4eefa41805..a50befaedea 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9027.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9027.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9027" title: "Command-Line Warning D9027" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9027" +ms.date: 11/04/2016 f1_keywords: ["D9027"] helpviewer_keywords: ["D9027"] -ms.assetid: 2a29edc5-5649-48f2-9058-2057c747284c --- # Command-Line Warning D9027 @@ -14,12 +13,12 @@ CL.exe ignored the input source file. This warning can be caused by a space between the /Fo option and an output filename on a command line with the /c option. For example: -``` +```cmd cl /c /Fo output.obj input.c ``` Because there is a space between /Fo and `output.obj`, CL.exe takes `output.obj` as the name of the input file. To fix the problem, remove the space: -``` +```cmd cl /c /Fooutput.obj input.c ``` diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md index aee174c7840..d19042b921a 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2011" title: "Linker Tools Error LNK2011" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2011" +ms.date: 11/04/2016 f1_keywords: ["LNK2011"] helpviewer_keywords: ["LNK2011"] -ms.assetid: 04991ef5-49d5-46c7-8eee-a9d1d3fc541e --- # Linker Tools Error LNK2011 @@ -14,7 +13,7 @@ If you use precompiled headers, LINK requires that all of the object files creat For example, if you compile a file called STUB.cpp to create a precompiled header for use with other source files, you must link with STUB.obj or you will get this error. In the following command lines, line one is used to create a precompiled header, COMMON.pch, which is used with PROG1.cpp and PROG2.cpp in lines two and three. The file STUB.cpp contains only `#include` lines (the same `#include` lines as in PROG1.cpp and PROG2.cpp) and is used only to generate precompiled headers. In the last line, STUB.obj must be linked in to avoid LNK2011. -``` +```cmd cl /c /Yccommon.h stub.cpp cl /c /Yucommon.h prog1.cpp cl /c /Yucommon.h prog2.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md index eb82ea21e7c..260ed1245f6 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4105" title: "Linker Tools Warning LNK4105" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4105" +ms.date: 11/04/2016 f1_keywords: ["LNK4105"] helpviewer_keywords: ["LNK4105"] -ms.assetid: 6c7bebf4-4ea6-4533-a6ed-e563d43abbd7 --- # Linker Tools Warning LNK4105 @@ -16,7 +15,7 @@ If you do not need to override the existing environmental library settings, remo ## Example -``` +```cmd link /libpath:c:\filepath\lib bar.obj ``` From 8713c009c5e20544758f2232b6289dccdd5e149c Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 22 Aug 2025 17:50:05 +0000 Subject: [PATCH 0909/1799] fix syntax (#6055) --- docs/docfx.json | 174 ++++++++++++++++++++++++------------------------ 1 file changed, 87 insertions(+), 87 deletions(-) diff --git a/docs/docfx.json b/docs/docfx.json index 1dd4d169a49..23b40c4fd3a 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -160,100 +160,100 @@ "windows/**.md": "windows-development" }, "ms.update-cycle": { - "assembler/**.{md,yml}": "3650-days", - "attributes/**.{md,yml}": "3650-days", - "atl/**.{md,yml}": "3650-days", - "atl-mfc-shared/**.{md,yml}": "3650-days", - "build/**.{md,yml}": "1825-days", - "c-language/**.{md,yml}": "3650-days", - "c-runtime-library/**.{md,yml}": "3650-days", + "assembler/**/**.{md,yml}": "3650-days", + "attributes/**/**.{md,yml}": "3650-days", + "atl/**/**.{md,yml}": "3650-days", + "atl-mfc-shared/**/**.{md,yml}": "3650-days", + "build/**/**.{md,yml}": "1825-days", + "c-language/**/**.{md,yml}": "3650-days", + "c-runtime-library/**/**.{md,yml}": "3650-days", "cpp/**.md": "1095-days", - "cppcx/**.{md,yml}": "3650-days", - "cross-platform/**.{md,yml}": "1825-days", - "data/**.{md,yml}": "3650-days", - "dotnet/**.{md,yml}": "3650-days", - "embedded/**.{md,yml}": "3650-days", - "error-messages/**.{md,yml}": "3650-days", - "extensions/**.{md,yml}": "3650-days", - "intrinsics/**.{md,yml}": "3650-days", - "mfc/**.{md,yml}": "3650-days", - "parallel/**.{md,yml}": "3650-days", - "porting/**.{md,yml}": "1095-days", - "preprocessor/**.{md,yml}": "3650-days", - "safeint/**.{md,yml}": "3650-days", - "standard-library/**.{md,yml}": "3650-days", - "text/**.{md,yml}": "3650-days", - "windows/**.{md,yml}": "1825-days" + "cppcx/**/**.{md,yml}": "3650-days", + "cross-platform/**/**.{md,yml}": "1825-days", + "data/**/**.{md,yml}": "3650-days", + "dotnet/**/**.{md,yml}": "3650-days", + "embedded/**/**.{md,yml}": "3650-days", + "error-messages/**/**.{md,yml}": "3650-days", + "extensions/**/**.{md,yml}": "3650-days", + "intrinsics/**/**.{md,yml}": "3650-days", + "mfc/**/**.{md,yml}": "3650-days", + "parallel/**/**.{md,yml}": "3650-days", + "porting/**/**.{md,yml}": "1095-days", + "preprocessor/**/**.{md,yml}": "3650-days", + "safeint/**/**.{md,yml}": "3650-days", + "standard-library/**/**.{md,yml}": "3650-days", + "text/**/**.{md,yml}": "3650-days", + "windows/**/**.{md,yml}": "1825-days" }, "author": { "index.md": "tylermsft", - "assembler/**.{md,yml}": "tylermsft", - "attributes/**.{md,yml}": "tylermsft", - "atl/**.{md,yml}": "tylermsft", - "atl-mfc-shared/**.{md,yml}": "tylermsft", - "build/**.{md,yml}": "tylermsft", - "build-insights/**.{md,yml}": "tylermsft", - "c-language/**.{md,yml}": "tylermsft", - "c-runtime-library/**.{md,yml}": "tylermsft", - "cloud/**.{md,yml}": "tylermsft", - "code-quality/**.{md,yml}": "tylermsft", - "cpp/**.{md,yml}": "tylermsft", - "cppcx/**.{md,yml}": "tylermsft", - "cross-platform/**.{md,yml}": "tylermsft", - "data/**.{md,yml}": "tylermsft", - "dotnet/**.{md,yml}": "tylermsft", - "error-messages/**.{md,yml}": "tylermsft", - "extensions/**.{md,yml}": "tylermsft", - "get-started/**.{md,yml}": "tylermsft", - "ide/**.{md,yml}": "tylermsft", - "intrinsics/**.{md,yml}": "tylermsft", - "linux/**.{md,yml}": "tylermsft", - "mfc/**.{md,yml}": "tylermsft", - "overview/**.{md,yml}": "tylermsft", - "parallel/**.{md,yml}": "tylermsft", - "porting/**.{md,yml}": "tylermsft", - "preprocessor/**.{md,yml}": "tylermsft", - "safeint/**.{md,yml}": "tylermsft", - "sanitizers/**.{md,yml}": "tylermsft", - "security/**.{md,yml}": "tylermsft", - "standard-library/**.{md,yml}": "tylermsft", - "text/**.{md,yml}": "tylermsft", - "windows/**.{md,yml}": "tylermsft" + "assembler/**/**.{md,yml}": "tylermsft", + "attributes/**/**.{md,yml}": "tylermsft", + "atl/**/**.{md,yml}": "tylermsft", + "atl-mfc-shared/**/**.{md,yml}": "tylermsft", + "build/**/**.{md,yml}": "tylermsft", + "build-insights/**/**.{md,yml}": "tylermsft", + "c-language/**/**.{md,yml}": "tylermsft", + "c-runtime-library/**/**.{md,yml}": "tylermsft", + "cloud/**/**.{md,yml}": "tylermsft", + "code-quality/**/**.{md,yml}": "tylermsft", + "cpp/**/**.{md,yml}": "tylermsft", + "cppcx/**/**.{md,yml}": "tylermsft", + "cross-platform/**/**.{md,yml}": "tylermsft", + "data/**/**.{md,yml}": "tylermsft", + "dotnet/**/**.{md,yml}": "tylermsft", + "error-messages/**/**.{md,yml}": "tylermsft", + "extensions/**/**.{md,yml}": "tylermsft", + "get-started/**/**.{md,yml}": "tylermsft", + "ide/**/**.{md,yml}": "tylermsft", + "intrinsics/**/**.{md,yml}": "tylermsft", + "linux/**/**.{md,yml}": "tylermsft", + "mfc/**/**.{md,yml}": "tylermsft", + "overview/**/**.{md,yml}": "tylermsft", + "parallel/**/**.{md,yml}": "tylermsft", + "porting/**/**.{md,yml}": "tylermsft", + "preprocessor/**/**.{md,yml}": "tylermsft", + "safeint/**/**.{md,yml}": "tylermsft", + "sanitizers/**/**.{md,yml}": "tylermsft", + "security/**/**.{md,yml}": "tylermsft", + "standard-library/**/**.{md,yml}": "tylermsft", + "text/**/**.{md,yml}": "tylermsft", + "windows/**/**.{md,yml}": "tylermsft" }, "ms.author": { "index.md": "twhitney", - "assembler/**.{md,yml}": "twhitney", - "atl/**.{md,yml}": "twhitney", - "atl-mfc-shared/**.{md,yml}": "twhitney", - "attributes/**.{md,yml}": "twhitney", - "build/**.{md,yml}": "twhitney", - "build-insights/**.{md,yml}": "twhitney", - "c-language/**.{md,yml}": "twhitney", - "c-runtime-library/**.{md,yml}": "twhitney", - "cloud/**.{md,yml}": "twhitney", - "code-quality/**.{md,yml}": "twhitney", - "cpp/**.{md,yml}": "twhitney", - "cppcx/**.{md,yml}": "twhitney", - "cross-platform/**.{md,yml}": "twhitney", - "data/**.{md,yml}": "twhitney", - "dotnet/**.{md,yml}": "twhitney", - "error-messages/**.{md,yml}": "twhitney", - "extensions/**.{md,yml}": "twhitney", - "get-started/**.{md,yml}": "twhitney", - "ide/**.{md,yml}": "twhitney", - "intrinsics/**.{md,yml}": "twhitney", - "linux/**.{md,yml}": "twhitney", - "mfc/**.{md,yml}": "twhitney", - "overview/**.{md,yml}": "twhitney", - "parallel/**.{md,yml}": "twhitney", - "porting/**.{md,yml}": "twhitney", - "preprocessor/**.{md,yml}": "twhitney", - "safeint/**.{md,yml}": "twhitney", - "sanitizers/**.{md,yml}": "twhitney", - "security/**.{md,yml}": "twhitney", - "standard-library/**.{md,yml}": "twhitney", - "text/**.{md,yml}": "twhitney", - "windows/**.{md,yml}": "twhitney" + "assembler/**/**.{md,yml}": "twhitney", + "atl/**/**.{md,yml}": "twhitney", + "atl-mfc-shared/**/**.{md,yml}": "twhitney", + "attributes/**/**.{md,yml}": "twhitney", + "build/**/**.{md,yml}": "twhitney", + "build-insights/**/**.{md,yml}": "twhitney", + "c-language/**/**.{md,yml}": "twhitney", + "c-runtime-library/**/**.{md,yml}": "twhitney", + "cloud/**/**.{md,yml}": "twhitney", + "code-quality/**/**.{md,yml}": "twhitney", + "cpp/**/**.{md,yml}": "twhitney", + "cppcx/**/**.{md,yml}": "twhitney", + "cross-platform/**/**.{md,yml}": "twhitney", + "data/**/**.{md,yml}": "twhitney", + "dotnet/**/**.{md,yml}": "twhitney", + "error-messages/**/**.{md,yml}": "twhitney", + "extensions/**/**.{md,yml}": "twhitney", + "get-started/**/**.{md,yml}": "twhitney", + "ide/**/**.{md,yml}": "twhitney", + "intrinsics/**/**.{md,yml}": "twhitney", + "linux/**/**.{md,yml}": "twhitney", + "mfc/**/**.{md,yml}": "twhitney", + "overview/**/**.{md,yml}": "twhitney", + "parallel/**/**.{md,yml}": "twhitney", + "porting/**/**.{md,yml}": "twhitney", + "preprocessor/**/**.{md,yml}": "twhitney", + "safeint/**/**.{md,yml}": "twhitney", + "sanitizers/**/**.{md,yml}": "twhitney", + "security/**/**.{md,yml}": "twhitney", + "standard-library/**/**.{md,yml}": "twhitney", + "text/**/**.{md,yml}": "twhitney", + "windows/**/**.{md,yml}": "twhitney" } }, "template": [], From b963f1d07c0305fc9dd4922dd6219af7c70eaf40 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 22 Aug 2025 14:18:27 -0700 Subject: [PATCH 0910/1799] fix typos and remove bad example --- .../compiler-errors-1/compiler-error-c2274.md | 28 ++++--------------- .../compiler-errors-1/compiler-error-c2289.md | 13 +++++---- 2 files changed, 14 insertions(+), 27 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md index 52cd5d4fcaf..1724a0006e3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md @@ -1,32 +1,16 @@ --- -description: "Learn more about: Compiler Error C2274" title: "Compiler Error C2274" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2274" +ms.date: 11/04/2016 f1_keywords: ["C2274"] helpviewer_keywords: ["C2274"] -ms.assetid: 8e874903-f499-45ef-8291-f821eee4cc1c --- # Compiler Error C2274 -'type' : illegal as right side of '.' operator - -A type appears as the right operand of a member-access (.) operator. - -This error can be caused by trying to access a user-defined type conversion. Use the keyword **`operator`** between the period and `type`. +> 'type' : illegal as right side of '.' operator -The following sample generates C2286: +## Remarks -```cpp -// C2274.cpp -struct MyClass { - operator int() { - return 0; - } -}; +A type appears as the right operand of a member-access (.) operator. -int main() { - MyClass ClassName; - int i = ClassName.int(); // C2274 - int j = ClassName.operator int(); // OK -} -``` +This error can be caused by trying to access a user-defined type conversion. Use the keyword **`operator`** between the period and `type`. \ No newline at end of file diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md index 485af601948..25fe25f0f2f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2289" title: "Compiler Error C2289" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2289" +ms.date: 11/04/2016 f1_keywords: ["C2289"] helpviewer_keywords: ["C2289"] -ms.assetid: cb41a29e-1b06-47dc-bfce-8d73bd63a0df --- # Compiler Error C2289 -same type qualifier used more than once +> 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, causing an error under ANSI compatibility (**/Za**). -The following sample generates C2286: +## Example + +The following example generates C2289: ```cpp // C2289.cpp From 18f5fe84507c8006ee0f60cfb1aac8fc764fce3f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 21:03:21 +0800 Subject: [PATCH 0911/1799] Add blockquotes for error messages in range [C3801, C3850] --- docs/error-messages/compiler-errors-2/compiler-error-c3803.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3804.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3805.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3807.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3809.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3812.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3813.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3815.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3816.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3817.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3818.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3821.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3824.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3825.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3828.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3830.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3831.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3832.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3833.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3834.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3836.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3838.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3839.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3842.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3846.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3848.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3849.md | 2 +- 27 files changed, 27 insertions(+), 27 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md index af817ec77d1..875a2a7395f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md @@ -8,7 +8,7 @@ ms.assetid: bad5fb9a-ed9a-4c15-96e7-cf06e200a50d --- # Compiler Error C3803 -'property': property has a type that is incompatible with one of its accessors 'accessor' +> 'property': property has a type that is incompatible with one of its accessors 'accessor' The type of a property defined with [property](../../cpp/property-cpp.md) does not match the return type for one of its accessor functions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md index 78038af3c8d..418c7663ee2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md @@ -8,7 +8,7 @@ ms.assetid: 7c4cda28-ec96-4d04-937b-36dbd9944722 --- # Compiler Error C3804 -'property_accessor': the accessor methods for a property must either be all static or all non-static +> 'property_accessor': the accessor methods for a property must either be all static or all non-static When defining a non-trivial property, the accessor functions can be either static or instance, but not both. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3805.md b/docs/error-messages/compiler-errors-2/compiler-error-c3805.md index 405f04301ed..1de1a69cc01 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3805.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3805.md @@ -8,6 +8,6 @@ ms.assetid: 166bbc35-5488-46b4-8e4c-9cd26ee5644e --- # Compiler Error C3805 -'token' : unexpected token, expected either '}' or an identifier +> 'token' : unexpected token, expected either '}' or an identifier When defining a property, an invalid token was encountered. Remove the invalid token. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md index 836ea5b2fe2..0190e1c8ccd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md @@ -8,7 +8,7 @@ ms.assetid: 7e2b0aab-8c61-4e71-b9c1-fcaeb6a1b5ea --- # Compiler Error C3807 -'type' : a class with the ComImport attribute cannot derive from 'type2', only interface implementation is allowed +> 'type' : a class with the ComImport attribute cannot derive from 'type2', only interface implementation is allowed A type that derived from can only implement an interface. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3809.md b/docs/error-messages/compiler-errors-2/compiler-error-c3809.md index 33561ee925b..3ca0748c422 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3809.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3809.md @@ -8,7 +8,7 @@ ms.assetid: 37eca584-c20c-464e-8e45-a987214b7ce4 --- # Compiler Error C3809 -'class' : a managed or WinRT type cannot have any friend functions/classes/interfaces +> 'class' : a managed or WinRT type cannot have any friend functions/classes/interfaces Managed types and Windows Runtime types do not allow friends. To fix this error, do not declare friends inside managed or Windows Runtime types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3812.md b/docs/error-messages/compiler-errors-2/compiler-error-c3812.md index 01948fe0827..811edf75765 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3812.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3812.md @@ -8,7 +8,7 @@ ms.assetid: 326ac706-9a5f-4851-b9d2-b90c64c75532 --- # Compiler Error C3812 -'property' must be the first token in a property declaration +> 'property' must be the first token in a property declaration When declaring a property, the `__property` keyword must be the first token on the line. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3813.md b/docs/error-messages/compiler-errors-2/compiler-error-c3813.md index 191a711ea7f..17fbbf6db22 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3813.md @@ -8,7 +8,7 @@ ms.assetid: ffdbc489-71bf-4cd6-988c-f824c9ab3ceb --- # Compiler Error C3813 -a property declaration can only appear within the definition of a managed or WinRT type +> a property declaration can only appear within the definition of a managed or WinRT type A [property](../../dotnet/how-to-use-properties-in-cpp-cli.md) can only be declared within a managed or Windows Runtime type. Native types do not support the **`property`** keyword. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3815.md b/docs/error-messages/compiler-errors-2/compiler-error-c3815.md index 5ba2bf28ee5..820719086c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3815.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3815.md @@ -8,7 +8,7 @@ ms.assetid: c5a3b404-6341-4fd3-92af-152b404c4dde --- # Compiler Error C3815 -return type of method 'get_accessor' must match type of the last parameter of a setter +> return type of method 'get_accessor' must match type of the last parameter of a setter When declaring properties, the return value of the `get_accessor` method must match the last parameter in the declaration of the set accessor method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3816.md b/docs/error-messages/compiler-errors-2/compiler-error-c3816.md index 555ed517ecc..d8220f09d56 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3816.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3816.md @@ -8,7 +8,7 @@ ms.assetid: 2e52cc7f-e31c-41a3-8d6f-9f5fab3648c0 --- # Compiler Error C3816 -'declaration' was previously declared or defined with a different managed or WinRTmodifier +> 'declaration' was previously declared or defined with a different managed or WinRTmodifier A forward declaration and an actual declaration require that there be no conflicts or inconsistencies in the declaration of attributes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3817.md b/docs/error-messages/compiler-errors-2/compiler-error-c3817.md index 763d7fecb84..445593d98dd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3817.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3817.md @@ -8,7 +8,7 @@ ms.assetid: c6dbb57a-c65e-4040-8dd2-85bd9d4fd337 --- # Compiler Error C3817 -'declaration' : property can only be applied to a function +> 'declaration' : property can only be applied to a function The **`property`** keyword can only be a applied to a function definition. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3818.md b/docs/error-messages/compiler-errors-2/compiler-error-c3818.md index e89b0f982be..061521dfe68 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3818.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3818.md @@ -8,7 +8,7 @@ ms.assetid: f9502f6a-0690-4135-ab88-cc97cf490f5c --- # Compiler Error C3818 -array property declaration 'property1' shall not overload an index property 'property2' +> array property declaration 'property1' shall not overload an index property 'property2' An overload is not possible for properties when one is an indexer and the other is an array property. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3821.md b/docs/error-messages/compiler-errors-2/compiler-error-c3821.md index 40b92e5f159..1d3f560938a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3821.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3821.md @@ -8,7 +8,7 @@ ms.assetid: 2b327c7a-5faf-443c-ae82-944fae25b4df --- # Compiler Error C3821 -'function': managed type or function cannot be used in an unmanaged function +> 'function': managed type or function cannot be used in an unmanaged function Functions with inline assembly or [setjmp](../../c-runtime-library/reference/setjmp.md) cannot contain value types or managed classes. To fix this error, remove the inline assembly and `setjmp` or remove the managed objects. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3824.md b/docs/error-messages/compiler-errors-2/compiler-error-c3824.md index 9287340b195..ea9582511bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3824.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3824.md @@ -8,7 +8,7 @@ ms.assetid: b6c6adf1-0a29-401c-a06e-616fd50d4c37 --- # Compiler Error C3824 -'member': this type cannot appear in this context (function parameter, return type, or a static member) +> 'member': this type cannot appear in this context (function parameter, return type, or a static member) Pinning pointers cannot be function parameters, return types, or declared **`static`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3825.md b/docs/error-messages/compiler-errors-2/compiler-error-c3825.md index 9b05b9a696c..e8084b58774 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3825.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3825.md @@ -8,7 +8,7 @@ ms.assetid: 18e204a1-f26e-42c6-8d74-2b49cc95f940 --- # Compiler Error C3825 -'class': a managed or WinRTclass can only support managed or WinRTevents +> 'class': a managed or WinRTclass can only support managed or WinRTevents Only .NET events are supported in managed classes. Only Windows Runtime events are supported in Windows Runtime classes. To fix this error in managed code, change type parameter of `event_source` and `event_receiver` from `native` to `managed`. Alternatively, remove the attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3828.md b/docs/error-messages/compiler-errors-2/compiler-error-c3828.md index 42507113264..118743c6a19 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3828.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3828.md @@ -8,7 +8,7 @@ ms.assetid: 8d9cee75-9504-4bc8-88b6-2413618a3f45 --- # Compiler Error C3828 -'object type': placement arguments not allowed while creating instances of managed or WinRTclasses +> 'object type': placement arguments not allowed while creating instances of managed or WinRTclasses When creating an object of a managed type or Windows Runtime type, you cannot use the placement form of operator [ref new, gcnew](../../extensions/ref-new-gcnew-cpp-component-extensions.md) or [new](../../cpp/new-operator-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3830.md b/docs/error-messages/compiler-errors-2/compiler-error-c3830.md index 8ea57b4157b..a8e86bcc2b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3830.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3830.md @@ -8,7 +8,7 @@ ms.assetid: c9798f88-5001-4067-9fb1-09957ddc6fa8 --- # Compiler Error C3830 -'type1': cannot inherit from 'type2', value types can only inherit from interface classes +> 'type1': cannot inherit from 'type2', value types can only inherit from interface classes A value type cannot inherit a base class. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3831.md b/docs/error-messages/compiler-errors-2/compiler-error-c3831.md index 60e02f58a61..9226a0a4238 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3831.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3831.md @@ -8,7 +8,7 @@ ms.assetid: a125d8dc-b75a-4ea0-b6c7-fe7b119dba25 --- # Compiler Error C3831 -'member': 'class' cannot have a pinned data member or a member function returning a pinning pointer +> 'member': 'class' cannot have a pinned data member or a member function returning a pinning pointer [pin_ptr (C++/CLI)](../../extensions/pin-ptr-cpp-cli.md) was used incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3832.md b/docs/error-messages/compiler-errors-2/compiler-error-c3832.md index caeebc3ea94..ef5de607a6f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3832.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3832.md @@ -8,6 +8,6 @@ ms.assetid: 9a41df82-42e1-4908-958c-76cff9235de0 --- # Compiler Error C3832 -'type library': type library looks as if it was built for 32-bit pointers; please change the 'ptrsize' qualifier +> 'type library': type library looks as if it was built for 32-bit pointers; please change the 'ptrsize' qualifier Explicit information supplied with the `ptrsize` attribute of the [#import](../../preprocessor/hash-import-directive-cpp.md) directive did not agree with what the compiler found in the type library. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3833.md b/docs/error-messages/compiler-errors-2/compiler-error-c3833.md index a57735b84a7..e0d036b1f57 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3833.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3833.md @@ -8,7 +8,7 @@ ms.assetid: 8152be53-e01e-48cd-9eef-9de38723664c --- # Compiler Error C3833 -'type' : invalid target type for pointer_type +> 'type' : invalid target type for pointer_type An [interior_ptr](../../extensions/interior-ptr-cpp-cli.md) or [pin_ptr](../../extensions/pin-ptr-cpp-cli.md) was declared incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3834.md b/docs/error-messages/compiler-errors-2/compiler-error-c3834.md index 957ff8062bb..c2ed9b24ee9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3834.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3834.md @@ -8,7 +8,7 @@ ms.assetid: 059e0dc4-300b-4e74-b6c2-41a57831fe2a --- # Compiler Error C3834 -illegal explicit cast to a pinning pointer; use a pinned local variable instead +> illegal explicit cast to a pinning pointer; use a pinned local variable instead Explicit casts to a pinned pointer are not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3836.md b/docs/error-messages/compiler-errors-2/compiler-error-c3836.md index d033952fdc1..61fdbff8eaf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3836.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3836.md @@ -8,7 +8,7 @@ ms.assetid: 254f851b-7b7d-4c34-a740-fcf72f6a636a --- # Compiler Error C3836 -static constructor is not allowed to have a member initializer list +> static constructor is not allowed to have a member initializer list A managed class cannot have a static constructor that also has a member initialization list. Static class constructors are called by the common language runtime to do class initialization, initializing static data members. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3838.md b/docs/error-messages/compiler-errors-2/compiler-error-c3838.md index 88b0263bba7..88efc22895f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3838.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3838.md @@ -8,7 +8,7 @@ ms.assetid: d6f470c2-131a-4a8c-843a-254acd43da83 --- # Compiler Error C3838 -cannot explicitly inherit from 'type' +> cannot explicitly inherit from 'type' The specified `type` cannot act as a base class in any class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3839.md b/docs/error-messages/compiler-errors-2/compiler-error-c3839.md index 0979234a149..a206d720858 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3839.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3839.md @@ -8,7 +8,7 @@ ms.assetid: 0957faff-1e9f-439b-876b-85bd8d2c578d --- # Compiler Error C3839 -cannot change alignment in a managed or WinRT type +> cannot change alignment in a managed or WinRT type Alignment of variables in managed or Windows Runtime types is controlled by the CLR or Windows Runtime and cannot be modified with [align](../../cpp/align-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3842.md b/docs/error-messages/compiler-errors-2/compiler-error-c3842.md index 283392fcc7e..7954bf1ad00 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3842.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3842.md @@ -8,7 +8,7 @@ ms.assetid: 41a1a44a-c618-40a2-8d26-7da27d14095d --- # Compiler Error C3842 -'function': 'const' and 'volatile' qualifiers on member functions of WinRT or managed types are not supported +> 'function': 'const' and 'volatile' qualifiers on member functions of WinRT or managed types are not supported [const](../../cpp/const-cpp.md) and [volatile](../../cpp/volatile-cpp.md) are not supported on member functions of Windows Runtime or managed types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3846.md b/docs/error-messages/compiler-errors-2/compiler-error-c3846.md index 8196ca04b3f..479923a806e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3846.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3846.md @@ -8,7 +8,7 @@ ms.assetid: c470f8a5-106b-4efb-b8dc-e1319e04130f --- # Compiler Error C3846 -'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1' +> 'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1' A symbol could not be imported from a referenced assembly because it was previously imported from a referenced assembly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3848.md b/docs/error-messages/compiler-errors-2/compiler-error-c3848.md index c67ffd0065f..91ffb14e366 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3848.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3848.md @@ -8,7 +8,7 @@ ms.assetid: 32d3ccef-01ec-4f8b-bbff-fb9b1a76b4c4 --- # Compiler Error C3848 -expression having type 'type' would lose some const-volatile qualifiers in order to call 'function' +> expression having type 'type' would lose some const-volatile qualifiers in order to call 'function' A variable with a specified const-volatile type can only call member functions defined with same or greater const-volatile qualifications. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3849.md b/docs/error-messages/compiler-errors-2/compiler-error-c3849.md index 2945bd37e2b..cf36486df98 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3849.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3849.md @@ -8,7 +8,7 @@ ms.assetid: 5347140e-1a81-4841-98c0-b63d98264b64 --- # Compiler Error C3849 -function-style call on an expression of type 'type' would lose const and/or volatile qualifiers for all number available operator overloads +> function-style call on an expression of type 'type' would lose const and/or volatile qualifiers for all number available operator overloads A variable with a specified const-volatile type can only call member functions defined with same or greater const-volatile qualifications. From 31ce480d1fa50e548ab28a9809c6aa69ed624e66 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 21:08:50 +0800 Subject: [PATCH 0912/1799] Add "Remarks" and "Example" headings for error references in range [C3801, C3850] --- docs/error-messages/compiler-errors-2/compiler-error-c3803.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3804.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3805.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3807.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3809.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3812.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3813.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3815.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3816.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3817.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3818.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3821.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3824.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3825.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3828.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3830.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3831.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3832.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3833.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3834.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3836.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3838.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3839.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3842.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3846.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3848.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3849.md | 4 ++++ 27 files changed, 72 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md index 875a2a7395f..8a3b8a3e242 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md @@ -10,8 +10,12 @@ ms.assetid: bad5fb9a-ed9a-4c15-96e7-cf06e200a50d > 'property': property has a type that is incompatible with one of its accessors 'accessor' +## Remarks + The type of a property defined with [property](../../cpp/property-cpp.md) does not match the return type for one of its accessor functions. +## Example + The following sample generates C3803: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md index 418c7663ee2..41a89430c95 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md @@ -10,6 +10,8 @@ ms.assetid: 7c4cda28-ec96-4d04-937b-36dbd9944722 > 'property_accessor': the accessor methods for a property must either be all static or all non-static +## Remarks + When defining a non-trivial property, the accessor functions can be either static or instance, but not both. See [property](../../extensions/property-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3805.md b/docs/error-messages/compiler-errors-2/compiler-error-c3805.md index 1de1a69cc01..8eb2796d8b3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3805.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3805.md @@ -10,4 +10,6 @@ ms.assetid: 166bbc35-5488-46b4-8e4c-9cd26ee5644e > 'token' : unexpected token, expected either '}' or an identifier +## Remarks + When defining a property, an invalid token was encountered. Remove the invalid token. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md index 0190e1c8ccd..93c52b0b8ff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md @@ -10,6 +10,8 @@ ms.assetid: 7e2b0aab-8c61-4e71-b9c1-fcaeb6a1b5ea > 'type' : a class with the ComImport attribute cannot derive from 'type2', only interface implementation is allowed +## Remarks + A type that derived from can only implement an interface. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3809.md b/docs/error-messages/compiler-errors-2/compiler-error-c3809.md index 3ca0748c422..79998b39f2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3809.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3809.md @@ -10,8 +10,12 @@ ms.assetid: 37eca584-c20c-464e-8e45-a987214b7ce4 > 'class' : a managed or WinRT type cannot have any friend functions/classes/interfaces +## Remarks + Managed types and Windows Runtime types do not allow friends. To fix this error, do not declare friends inside managed or Windows Runtime types. +## Example + The following sample generates C3809: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3812.md b/docs/error-messages/compiler-errors-2/compiler-error-c3812.md index 811edf75765..1ee374e370b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3812.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3812.md @@ -10,6 +10,8 @@ ms.assetid: 326ac706-9a5f-4851-b9d2-b90c64c75532 > 'property' must be the first token in a property declaration +## Remarks + When declaring a property, the `__property` keyword must be the first token on the line. C3812 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3813.md b/docs/error-messages/compiler-errors-2/compiler-error-c3813.md index 17fbbf6db22..73eb71c4e53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3813.md @@ -10,6 +10,8 @@ ms.assetid: ffdbc489-71bf-4cd6-988c-f824c9ab3ceb > a property declaration can only appear within the definition of a managed or WinRT type +## Remarks + A [property](../../dotnet/how-to-use-properties-in-cpp-cli.md) can only be declared within a managed or Windows Runtime type. Native types do not support the **`property`** keyword. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3815.md b/docs/error-messages/compiler-errors-2/compiler-error-c3815.md index 820719086c9..cd52f38903d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3815.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3815.md @@ -10,6 +10,8 @@ ms.assetid: c5a3b404-6341-4fd3-92af-152b404c4dde > return type of method 'get_accessor' must match type of the last parameter of a setter +## Remarks + When declaring properties, the return value of the `get_accessor` method must match the last parameter in the declaration of the set accessor method. C3815 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3816.md b/docs/error-messages/compiler-errors-2/compiler-error-c3816.md index d8220f09d56..e4b23efc14a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3816.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3816.md @@ -10,8 +10,12 @@ ms.assetid: 2e52cc7f-e31c-41a3-8d6f-9f5fab3648c0 > 'declaration' was previously declared or defined with a different managed or WinRTmodifier +## Remarks + A forward declaration and an actual declaration require that there be no conflicts or inconsistencies in the declaration of attributes. +## Example + The following sample generates C3816 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3817.md b/docs/error-messages/compiler-errors-2/compiler-error-c3817.md index 445593d98dd..ceaad9df8bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3817.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3817.md @@ -10,6 +10,8 @@ ms.assetid: c6dbb57a-c65e-4040-8dd2-85bd9d4fd337 > 'declaration' : property can only be applied to a function +## Remarks + The **`property`** keyword can only be a applied to a function definition. C3817 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3818.md b/docs/error-messages/compiler-errors-2/compiler-error-c3818.md index 061521dfe68..427c2ee58b2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3818.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3818.md @@ -10,6 +10,8 @@ ms.assetid: f9502f6a-0690-4135-ab88-cc97cf490f5c > array property declaration 'property1' shall not overload an index property 'property2' +## Remarks + An overload is not possible for properties when one is an indexer and the other is an array property. C3818 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3821.md b/docs/error-messages/compiler-errors-2/compiler-error-c3821.md index 1d3f560938a..d4ec0937932 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3821.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3821.md @@ -10,6 +10,8 @@ ms.assetid: 2b327c7a-5faf-443c-ae82-944fae25b4df > 'function': managed type or function cannot be used in an unmanaged function +## Remarks + Functions with inline assembly or [setjmp](../../c-runtime-library/reference/setjmp.md) cannot contain value types or managed classes. To fix this error, remove the inline assembly and `setjmp` or remove the managed objects. C3821 can also occur if you try to use automatic storage in a vararg function. For more information, see [Variable Argument Lists (...) (C++/CLI)](../../extensions/variable-argument-lists-dot-dot-dot-cpp-cli.md) and [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3824.md b/docs/error-messages/compiler-errors-2/compiler-error-c3824.md index ea9582511bd..0c1a8744c0b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3824.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3824.md @@ -10,6 +10,8 @@ ms.assetid: b6c6adf1-0a29-401c-a06e-616fd50d4c37 > 'member': this type cannot appear in this context (function parameter, return type, or a static member) +## Remarks + Pinning pointers cannot be function parameters, return types, or declared **`static`**. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3825.md b/docs/error-messages/compiler-errors-2/compiler-error-c3825.md index e8084b58774..4080d8c7e53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3825.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3825.md @@ -10,6 +10,8 @@ ms.assetid: 18e204a1-f26e-42c6-8d74-2b49cc95f940 > 'class': a managed or WinRTclass can only support managed or WinRTevents +## Remarks + Only .NET events are supported in managed classes. Only Windows Runtime events are supported in Windows Runtime classes. To fix this error in managed code, change type parameter of `event_source` and `event_receiver` from `native` to `managed`. Alternatively, remove the attribute. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3828.md b/docs/error-messages/compiler-errors-2/compiler-error-c3828.md index 118743c6a19..4d6b752cb60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3828.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3828.md @@ -10,8 +10,12 @@ ms.assetid: 8d9cee75-9504-4bc8-88b6-2413618a3f45 > 'object type': placement arguments not allowed while creating instances of managed or WinRTclasses +## Remarks + When creating an object of a managed type or Windows Runtime type, you cannot use the placement form of operator [ref new, gcnew](../../extensions/ref-new-gcnew-cpp-component-extensions.md) or [new](../../cpp/new-operator-cpp.md). +## Example + The following sample generates C3828 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3830.md b/docs/error-messages/compiler-errors-2/compiler-error-c3830.md index a8e86bcc2b4..155b0b5375f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3830.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3830.md @@ -10,6 +10,8 @@ ms.assetid: c9798f88-5001-4067-9fb1-09957ddc6fa8 > 'type1': cannot inherit from 'type2', value types can only inherit from interface classes +## Remarks + A value type cannot inherit a base class. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3831.md b/docs/error-messages/compiler-errors-2/compiler-error-c3831.md index 9226a0a4238..5d2c9b545ff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3831.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3831.md @@ -10,6 +10,8 @@ ms.assetid: a125d8dc-b75a-4ea0-b6c7-fe7b119dba25 > 'member': 'class' cannot have a pinned data member or a member function returning a pinning pointer +## Remarks + [pin_ptr (C++/CLI)](../../extensions/pin-ptr-cpp-cli.md) was used incorrectly. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3832.md b/docs/error-messages/compiler-errors-2/compiler-error-c3832.md index ef5de607a6f..bedb86d16ab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3832.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3832.md @@ -10,4 +10,6 @@ ms.assetid: 9a41df82-42e1-4908-958c-76cff9235de0 > 'type library': type library looks as if it was built for 32-bit pointers; please change the 'ptrsize' qualifier +## Remarks + Explicit information supplied with the `ptrsize` attribute of the [#import](../../preprocessor/hash-import-directive-cpp.md) directive did not agree with what the compiler found in the type library. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3833.md b/docs/error-messages/compiler-errors-2/compiler-error-c3833.md index e0d036b1f57..b13d620479d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3833.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3833.md @@ -10,8 +10,12 @@ ms.assetid: 8152be53-e01e-48cd-9eef-9de38723664c > 'type' : invalid target type for pointer_type +## Remarks + An [interior_ptr](../../extensions/interior-ptr-cpp-cli.md) or [pin_ptr](../../extensions/pin-ptr-cpp-cli.md) was declared incorrectly. +## Examples + The following sample generates C3833: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3834.md b/docs/error-messages/compiler-errors-2/compiler-error-c3834.md index c2ed9b24ee9..e343e6d205f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3834.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3834.md @@ -10,6 +10,8 @@ ms.assetid: 059e0dc4-300b-4e74-b6c2-41a57831fe2a > illegal explicit cast to a pinning pointer; use a pinned local variable instead +## Remarks + Explicit casts to a pinned pointer are not allowed. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3836.md b/docs/error-messages/compiler-errors-2/compiler-error-c3836.md index 61fdbff8eaf..53e81e9d5d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3836.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3836.md @@ -10,6 +10,8 @@ ms.assetid: 254f851b-7b7d-4c34-a740-fcf72f6a636a > static constructor is not allowed to have a member initializer list +## Remarks + A managed class cannot have a static constructor that also has a member initialization list. Static class constructors are called by the common language runtime to do class initialization, initializing static data members. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3838.md b/docs/error-messages/compiler-errors-2/compiler-error-c3838.md index 88efc22895f..76d976bd33e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3838.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3838.md @@ -10,6 +10,8 @@ ms.assetid: d6f470c2-131a-4a8c-843a-254acd43da83 > cannot explicitly inherit from 'type' +## Remarks + The specified `type` cannot act as a base class in any class. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3839.md b/docs/error-messages/compiler-errors-2/compiler-error-c3839.md index a206d720858..2e8d30e53e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3839.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3839.md @@ -10,8 +10,12 @@ ms.assetid: 0957faff-1e9f-439b-876b-85bd8d2c578d > cannot change alignment in a managed or WinRT type +## Remarks + Alignment of variables in managed or Windows Runtime types is controlled by the CLR or Windows Runtime and cannot be modified with [align](../../cpp/align-cpp.md). +## Example + The following sample generates C3839: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3842.md b/docs/error-messages/compiler-errors-2/compiler-error-c3842.md index 7954bf1ad00..d3817b5e85e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3842.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3842.md @@ -10,8 +10,12 @@ ms.assetid: 41a1a44a-c618-40a2-8d26-7da27d14095d > 'function': 'const' and 'volatile' qualifiers on member functions of WinRT or managed types are not supported +## Remarks + [const](../../cpp/const-cpp.md) and [volatile](../../cpp/volatile-cpp.md) are not supported on member functions of Windows Runtime or managed types. +## Example + The following sample generates C3842: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3846.md b/docs/error-messages/compiler-errors-2/compiler-error-c3846.md index 479923a806e..1385b65f6da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3846.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3846.md @@ -10,6 +10,8 @@ ms.assetid: c470f8a5-106b-4efb-b8dc-e1319e04130f > 'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1' +## Remarks + A symbol could not be imported from a referenced assembly because it was previously imported from a referenced assembly. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3848.md b/docs/error-messages/compiler-errors-2/compiler-error-c3848.md index 91ffb14e366..fc483e0d74c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3848.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3848.md @@ -10,8 +10,12 @@ ms.assetid: 32d3ccef-01ec-4f8b-bbff-fb9b1a76b4c4 > expression having type 'type' would lose some const-volatile qualifiers in order to call 'function' +## Remarks + A variable with a specified const-volatile type can only call member functions defined with same or greater const-volatile qualifications. +## Example + The following samples generate C3848: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3849.md b/docs/error-messages/compiler-errors-2/compiler-error-c3849.md index cf36486df98..8d5c8926630 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3849.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3849.md @@ -10,10 +10,14 @@ ms.assetid: 5347140e-1a81-4841-98c0-b63d98264b64 > function-style call on an expression of type 'type' would lose const and/or volatile qualifiers for all number available operator overloads +## Remarks + A variable with a specified const-volatile type can only call member functions defined with same or greater const-volatile qualifications. To fix this error, provide an appropriate member function. You cannot execute a conversion on a const or volatile qualified object when the conversion causes loss of qualification. You can gain qualifiers but you cannot lose qualifiers in a conversion. +## Example + The following samples generate C3849: ```cpp From 5c69be181fce832d4452b087fb92f20e16d05a33 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 21:10:33 +0800 Subject: [PATCH 0913/1799] Replace term "sample" with "example" for error references in range [C3801, C3850] --- docs/error-messages/compiler-errors-2/compiler-error-c3803.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3804.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3807.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3808.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3809.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3813.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3816.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3821.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3824.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3825.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3828.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3830.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3831.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3833.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3834.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3836.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3838.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3839.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3842.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3846.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3848.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3849.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3850.md | 2 +- 23 files changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md index 8a3b8a3e242..1f13d62607b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md @@ -16,7 +16,7 @@ The type of a property defined with [property](../../cpp/property-cpp.md) does n ## Example -The following sample generates C3803: +The following example generates C3803: ```cpp // C3803.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md index 41a89430c95..e462fb25e74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md @@ -18,7 +18,7 @@ See [property](../../extensions/property-cpp-component-extensions.md) for more i ## Example -The following sample generates C3804. +The following example generates C3804. ```cpp // C3804.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md index 93c52b0b8ff..9f923067654 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md @@ -16,7 +16,7 @@ A type that derived from Date: Sat, 23 Aug 2025 21:14:57 +0800 Subject: [PATCH 0914/1799] Update metadata for error references in range [C3801, C3850] --- .../error-messages/compiler-errors-2/compiler-error-c3803.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3804.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3805.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3807.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3808.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3809.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3812.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3813.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3815.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3816.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3817.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3818.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3820.md | 1 - .../error-messages/compiler-errors-2/compiler-error-c3821.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3824.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3825.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3828.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3830.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3831.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3832.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3833.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3834.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3836.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3838.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3839.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3842.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3846.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3848.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3849.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3850.md | 5 ++--- 30 files changed, 58 insertions(+), 88 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md index 1f13d62607b..367696019e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3803" title: "Compiler Error C3803" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3803" +ms.date: 11/04/2016 f1_keywords: ["C3803"] helpviewer_keywords: ["C3803"] -ms.assetid: bad5fb9a-ed9a-4c15-96e7-cf06e200a50d --- # Compiler Error C3803 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md index e462fb25e74..243706cab93 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3804" title: "Compiler Error C3804" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3804" +ms.date: 11/04/2016 f1_keywords: ["C3804"] helpviewer_keywords: ["C3804"] -ms.assetid: 7c4cda28-ec96-4d04-937b-36dbd9944722 --- # Compiler Error C3804 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3805.md b/docs/error-messages/compiler-errors-2/compiler-error-c3805.md index 8eb2796d8b3..b889e2d7e73 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3805.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3805.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3805" title: "Compiler Error C3805" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3805" +ms.date: 11/04/2016 f1_keywords: ["C3805"] helpviewer_keywords: ["C3805"] -ms.assetid: 166bbc35-5488-46b4-8e4c-9cd26ee5644e --- # Compiler Error C3805 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md index 9f923067654..c951650c6d0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3807" title: "Compiler Error C3807" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3807" +ms.date: 11/04/2016 f1_keywords: ["C3807"] helpviewer_keywords: ["C3807"] -ms.assetid: 7e2b0aab-8c61-4e71-b9c1-fcaeb6a1b5ea --- # Compiler Error C3807 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3808.md b/docs/error-messages/compiler-errors-2/compiler-error-c3808.md index b82ca74638f..d55d364f37d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3808.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3808.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3808" title: "Compiler Error C3808" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3808" +ms.date: 11/04/2016 f1_keywords: ["C3808"] helpviewer_keywords: ["C3808"] -ms.assetid: 2ee8ac97-3ea4-417a-8710-be73a7f98cf4 --- # Compiler Error C3808 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3809.md b/docs/error-messages/compiler-errors-2/compiler-error-c3809.md index d70cbe9d8b5..90fdd8856ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3809.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3809.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3809" title: "Compiler Error C3809" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3809" +ms.date: 11/04/2016 f1_keywords: ["C3809"] helpviewer_keywords: ["C3809"] -ms.assetid: 37eca584-c20c-464e-8e45-a987214b7ce4 --- # Compiler Error C3809 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3812.md b/docs/error-messages/compiler-errors-2/compiler-error-c3812.md index 1ee374e370b..b2618d099ba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3812.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3812.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3812" title: "Compiler Error C3812" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3812" +ms.date: 11/04/2016 f1_keywords: ["C3812"] helpviewer_keywords: ["C3812"] -ms.assetid: 326ac706-9a5f-4851-b9d2-b90c64c75532 --- # Compiler Error C3812 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3813.md b/docs/error-messages/compiler-errors-2/compiler-error-c3813.md index e5bdb7665cb..4f384bab29a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3813.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3813" title: "Compiler Error C3813" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3813" +ms.date: 11/04/2016 f1_keywords: ["C3813"] helpviewer_keywords: ["C3813"] -ms.assetid: ffdbc489-71bf-4cd6-988c-f824c9ab3ceb --- # Compiler Error C3813 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3815.md b/docs/error-messages/compiler-errors-2/compiler-error-c3815.md index cd52f38903d..b60ddbf7dd0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3815.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3815.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3815" title: "Compiler Error C3815" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3815" +ms.date: 11/04/2016 f1_keywords: ["C3815"] helpviewer_keywords: ["C3815"] -ms.assetid: c5a3b404-6341-4fd3-92af-152b404c4dde --- # Compiler Error C3815 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3816.md b/docs/error-messages/compiler-errors-2/compiler-error-c3816.md index 157e38792d2..e489ee5545d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3816.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3816.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3816" title: "Compiler Error C3816" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3816" +ms.date: 11/04/2016 f1_keywords: ["C3816"] helpviewer_keywords: ["C3816"] -ms.assetid: 2e52cc7f-e31c-41a3-8d6f-9f5fab3648c0 --- # Compiler Error C3816 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3817.md b/docs/error-messages/compiler-errors-2/compiler-error-c3817.md index ceaad9df8bd..2485dc8edf8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3817.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3817.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3817" title: "Compiler Error C3817" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3817" +ms.date: 11/04/2016 f1_keywords: ["C3817"] helpviewer_keywords: ["C3817"] -ms.assetid: c6dbb57a-c65e-4040-8dd2-85bd9d4fd337 --- # Compiler Error C3817 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3818.md b/docs/error-messages/compiler-errors-2/compiler-error-c3818.md index 427c2ee58b2..142477f6753 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3818.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3818.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3818" title: "Compiler Error C3818" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3818" +ms.date: 11/04/2016 f1_keywords: ["C3818"] helpviewer_keywords: ["C3818"] -ms.assetid: f9502f6a-0690-4135-ab88-cc97cf490f5c --- # Compiler Error C3818 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3820.md b/docs/error-messages/compiler-errors-2/compiler-error-c3820.md index f9398c914e6..31f296f9bcd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3820.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3820.md @@ -4,7 +4,6 @@ description: "Microsoft C/C++ compiler error C3820 causes and remedies." ms.date: 09/26/2020 f1_keywords: ["C3820"] helpviewer_keywords: ["C3820"] -ms.assetid: 98638838-068f-4a62-b8d5-1068368a0ff1 --- # Compiler Error C3820 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3821.md b/docs/error-messages/compiler-errors-2/compiler-error-c3821.md index baf9a8bba03..408630cab82 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3821.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3821.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3821" title: "Compiler Error C3821" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3821" +ms.date: 11/04/2016 f1_keywords: ["C3821"] helpviewer_keywords: ["C3821"] -ms.assetid: 2b327c7a-5faf-443c-ae82-944fae25b4df --- # Compiler Error C3821 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3824.md b/docs/error-messages/compiler-errors-2/compiler-error-c3824.md index 8c639de04f7..37daec6fadf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3824.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3824.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3824" title: "Compiler Error C3824" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3824" +ms.date: 11/04/2016 f1_keywords: ["C3824"] helpviewer_keywords: ["C3824"] -ms.assetid: b6c6adf1-0a29-401c-a06e-616fd50d4c37 --- # Compiler Error C3824 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3825.md b/docs/error-messages/compiler-errors-2/compiler-error-c3825.md index 9e6dad45b17..40293c4ae53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3825.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3825.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3825" title: "Compiler Error C3825" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3825" +ms.date: 11/04/2016 f1_keywords: ["C3825"] helpviewer_keywords: ["C3825"] -ms.assetid: 18e204a1-f26e-42c6-8d74-2b49cc95f940 --- # Compiler Error C3825 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3828.md b/docs/error-messages/compiler-errors-2/compiler-error-c3828.md index 601d574dafe..9fe4e6f0102 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3828.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3828.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3828" title: "Compiler Error C3828" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3828" +ms.date: 11/04/2016 f1_keywords: ["C3828"] helpviewer_keywords: ["C3828"] -ms.assetid: 8d9cee75-9504-4bc8-88b6-2413618a3f45 --- # Compiler Error C3828 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3830.md b/docs/error-messages/compiler-errors-2/compiler-error-c3830.md index 937b2ac3259..cbcf4775975 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3830.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3830.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3830" title: "Compiler Error C3830" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3830" +ms.date: 11/04/2016 f1_keywords: ["C3830"] helpviewer_keywords: ["C3830"] -ms.assetid: c9798f88-5001-4067-9fb1-09957ddc6fa8 --- # Compiler Error C3830 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3831.md b/docs/error-messages/compiler-errors-2/compiler-error-c3831.md index 4d53433b406..2b861984944 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3831.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3831.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3831" title: "Compiler Error C3831" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3831" +ms.date: 11/04/2016 f1_keywords: ["C3831"] helpviewer_keywords: ["C3831"] -ms.assetid: a125d8dc-b75a-4ea0-b6c7-fe7b119dba25 --- # Compiler Error C3831 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3832.md b/docs/error-messages/compiler-errors-2/compiler-error-c3832.md index bedb86d16ab..e1e3bdfaa45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3832.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3832.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3832" title: "Compiler Error C3832" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3832" +ms.date: 11/04/2016 f1_keywords: ["C3832"] helpviewer_keywords: ["C3832"] -ms.assetid: 9a41df82-42e1-4908-958c-76cff9235de0 --- # Compiler Error C3832 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3833.md b/docs/error-messages/compiler-errors-2/compiler-error-c3833.md index 0dc5a6681f1..b129c53c0af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3833.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3833.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3833" title: "Compiler Error C3833" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3833" +ms.date: 11/04/2016 f1_keywords: ["C3833"] helpviewer_keywords: ["C3833"] -ms.assetid: 8152be53-e01e-48cd-9eef-9de38723664c --- # Compiler Error C3833 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3834.md b/docs/error-messages/compiler-errors-2/compiler-error-c3834.md index b8142020e88..f20bfc9b040 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3834.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3834.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3834" title: "Compiler Error C3834" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3834" +ms.date: 11/04/2016 f1_keywords: ["C3834"] helpviewer_keywords: ["C3834"] -ms.assetid: 059e0dc4-300b-4e74-b6c2-41a57831fe2a --- # Compiler Error C3834 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3836.md b/docs/error-messages/compiler-errors-2/compiler-error-c3836.md index 7b515d5f538..47bcc280d81 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3836.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3836.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3836" title: "Compiler Error C3836" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3836" +ms.date: 11/04/2016 f1_keywords: ["C3836"] helpviewer_keywords: ["C3836"] -ms.assetid: 254f851b-7b7d-4c34-a740-fcf72f6a636a --- # Compiler Error C3836 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3838.md b/docs/error-messages/compiler-errors-2/compiler-error-c3838.md index 99a7371d950..10518be7bfe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3838.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3838.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3838" title: "Compiler Error C3838" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3838" +ms.date: 11/04/2016 f1_keywords: ["C3838"] helpviewer_keywords: ["C3838"] -ms.assetid: d6f470c2-131a-4a8c-843a-254acd43da83 --- # Compiler Error C3838 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3839.md b/docs/error-messages/compiler-errors-2/compiler-error-c3839.md index 6c7f5facbd4..6cc03dfe858 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3839.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3839.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3839" title: "Compiler Error C3839" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3839" +ms.date: 11/04/2016 f1_keywords: ["C3839"] helpviewer_keywords: ["C3839"] -ms.assetid: 0957faff-1e9f-439b-876b-85bd8d2c578d --- # Compiler Error C3839 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3842.md b/docs/error-messages/compiler-errors-2/compiler-error-c3842.md index 4985c2edbb1..5149f7f4d13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3842.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3842.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3842" title: "Compiler Error C3842" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3842" +ms.date: 11/04/2016 f1_keywords: ["C3842"] helpviewer_keywords: ["C3842"] -ms.assetid: 41a1a44a-c618-40a2-8d26-7da27d14095d --- # Compiler Error C3842 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3846.md b/docs/error-messages/compiler-errors-2/compiler-error-c3846.md index 36a6041004f..4a9caf6f2d3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3846.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3846.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3846" title: "Compiler Error C3846" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3846" +ms.date: 11/04/2016 f1_keywords: ["C3846"] helpviewer_keywords: ["C3846"] -ms.assetid: c470f8a5-106b-4efb-b8dc-e1319e04130f --- # Compiler Error C3846 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3848.md b/docs/error-messages/compiler-errors-2/compiler-error-c3848.md index 790aca09cba..f9bd3b6ac87 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3848.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3848.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3848" title: "Compiler Error C3848" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3848" +ms.date: 11/04/2016 f1_keywords: ["C3848"] helpviewer_keywords: ["C3848"] -ms.assetid: 32d3ccef-01ec-4f8b-bbff-fb9b1a76b4c4 --- # Compiler Error C3848 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3849.md b/docs/error-messages/compiler-errors-2/compiler-error-c3849.md index 809a877a2f3..923c5269c4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3849.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3849.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3849" title: "Compiler Error C3849" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3849" +ms.date: 11/04/2016 f1_keywords: ["C3849"] helpviewer_keywords: ["C3849"] -ms.assetid: 5347140e-1a81-4841-98c0-b63d98264b64 --- # Compiler Error C3849 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3850.md b/docs/error-messages/compiler-errors-2/compiler-error-c3850.md index 48ecc453c04..e5ae957dc8f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3850.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3850.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3850" title: "Compiler Error C3850" -ms.date: "09/05/2018" +description: "Learn more about: Compiler Error C3850" +ms.date: 09/05/2018 f1_keywords: ["C3850"] helpviewer_keywords: ["C3850"] -ms.assetid: 028f3a37-f3ad-4ebc-9168-3cdea47524d4 --- # Compiler Error C3850 From 5707f06c3c71b705960390e7808c03f583abc887 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 21:46:52 +0800 Subject: [PATCH 0915/1799] Update error message in C2290 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2290.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md index 5742c5e234c..8d37369ecfd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2290"] --- # Compiler Error C2290 -> C++ asm syntax ignored. Use __asm. +> C++ 'asm' syntax ignored. Use __asm. ## Remarks From e2d64eaa5f89e9df52ae90514b65420bb33d59ab Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 21:53:17 +0800 Subject: [PATCH 0916/1799] Augment remarks in C2290 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2290.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md index 8d37369ecfd..935f49e3966 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md @@ -11,4 +11,4 @@ helpviewer_keywords: ["C2290"] ## Remarks -The **`asm`** syntax is reserved for future use. +The **`asm`** syntax is reserved for future use, try [`__asm`](../../assembler/inline/asm.md) instead. For more information, see [Inline Assembler](../../assembler/inline/inline-assembler.md). From 5ad86f60a341a05619a2efed3165c0bc7e73b643 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:01:09 +0800 Subject: [PATCH 0917/1799] Add example in C2290 error reference --- .../compiler-errors-1/compiler-error-c2290.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md index 935f49e3966..123770e9765 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md @@ -12,3 +12,18 @@ helpviewer_keywords: ["C2290"] ## Remarks The **`asm`** syntax is reserved for future use, try [`__asm`](../../assembler/inline/asm.md) instead. For more information, see [Inline Assembler](../../assembler/inline/inline-assembler.md). + +## Example + +The following example generates C2290: + +```cpp +// C2290.cpp +// processor: x86 + +int main() +{ + asm("nop"); // C2290 + __asm nop // OK +} +``` From b3e3f96bb27e544cb5fbb90b904f554badc5b984 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:02:26 +0800 Subject: [PATCH 0918/1799] Update `ms.date` metadata in C2290 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2290.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md index 123770e9765..66b814f4caf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2290" description: "Learn more about: Compiler Error C2290" -ms.date: 11/04/2016 +ms.date: 08/23/2025 f1_keywords: ["C2290"] helpviewer_keywords: ["C2290"] --- From 374f9a1352ec73c3c9f9bca8361e276d8eb851d2 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:19:07 +0800 Subject: [PATCH 0919/1799] Add bunch of backticks in "iostreams Conventions" topic --- .../standard-library/iostreams-conventions.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/standard-library/iostreams-conventions.md b/docs/standard-library/iostreams-conventions.md index bfc1b389ddd..0eb67e522b6 100644 --- a/docs/standard-library/iostreams-conventions.md +++ b/docs/standard-library/iostreams-conventions.md @@ -9,25 +9,25 @@ ms.assetid: 9fe5ded0-37a1-48d1-9671-c81ffc4760ad The iostreams headers support conversions between text and encoded forms, and input and output to external files: -[\](../standard-library/fstream.md)\ -[\](../standard-library/iomanip.md)\ -[\](../standard-library/ios.md)\ -[\](../standard-library/iosfwd.md)\ -[\](../standard-library/iostream.md)\ -[\](../standard-library/istream.md)\ -[\](../standard-library/ostream.md)\ -[\](../standard-library/sstream.md)\ -[\](../standard-library/streambuf.md)\ -[\](../standard-library/strstream.md) +[``](../standard-library/fstream.md)\ +[``](../standard-library/iomanip.md)\ +[``](../standard-library/ios.md)\ +[``](../standard-library/iosfwd.md)\ +[``](../standard-library/iostream.md)\ +[``](../standard-library/istream.md)\ +[``](../standard-library/ostream.md)\ +[``](../standard-library/sstream.md)\ +[``](../standard-library/streambuf.md)\ +[``](../standard-library/strstream.md) -The simplest use of iostreams requires only that you include the header [\](../standard-library/iostream.md). You can then extract values from [cin](../standard-library/iostream.md#cin) or [wcin](../standard-library/iostream.md#wcin) to read the standard input. The rules for doing so are outlined in the description of the class [basic_istream Class](../standard-library/basic-istream-class.md). You can also insert values to [cout](../standard-library/iostream.md#cout) or [wcout](../standard-library/iostream.md#wcout) to write the standard output. The rules for doing so are outlined in the description of the class [basic_ostream Class](../standard-library/basic-ostream-class.md). Format control common to both extractors and insertors is managed by the class [basic_ios Class](../standard-library/basic-ios-class.md). Manipulating this format information in the guise of extracting and inserting objects is the province of several manipulators. +The simplest use of iostreams requires only that you include the header [``](../standard-library/iostream.md). You can then extract values from [`cin`](../standard-library/iostream.md#cin) or [`wcin`](../standard-library/iostream.md#wcin) to read the standard input. The rules for doing so are outlined in the description of the class [`basic_istream` Class](../standard-library/basic-istream-class.md). You can also insert values to [`cout`](../standard-library/iostream.md#cout) or [`wcout`](../standard-library/iostream.md#wcout) to write the standard output. The rules for doing so are outlined in the description of the class [`basic_ostream` Class](../standard-library/basic-ostream-class.md). Format control common to both extractors and insertors is managed by the class [`basic_ios` Class](../standard-library/basic-ios-class.md). Manipulating this format information in the guise of extracting and inserting objects is the province of several manipulators. -You can perform the same iostreams operations on files that you open by name, using the classes declared in [\](../standard-library/fstream.md). To convert between iostreams and objects of class [basic_string Class](../standard-library/basic-string-class.md), use the classes declared in [\](../standard-library/sstream.md). To do the same with C strings, use the classes declared in [\](../standard-library/strstream.md). +You can perform the same iostreams operations on files that you open by name, using the classes declared in [``](../standard-library/fstream.md). To convert between iostreams and objects of class [`basic_string` Class](../standard-library/basic-string-class.md), use the classes declared in [``](../standard-library/sstream.md). To do the same with C strings, use the classes declared in [``](../standard-library/strstream.md). The remaining headers provide support services, typically of direct interest to only the most advanced users of the iostreams classes. ## See also [C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)\ -[iostream Programming](../standard-library/iostream-programming.md)\ +[`iostream` Programming](../standard-library/iostream-programming.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) From c2f9319a696805b1f4991ef5bfacd3468b93cba1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:24:55 +0800 Subject: [PATCH 0920/1799] Simplify redundant relative links in "iostreams Conventions" topic --- .../standard-library/iostreams-conventions.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/standard-library/iostreams-conventions.md b/docs/standard-library/iostreams-conventions.md index 0eb67e522b6..2bf6e1f6029 100644 --- a/docs/standard-library/iostreams-conventions.md +++ b/docs/standard-library/iostreams-conventions.md @@ -9,25 +9,25 @@ ms.assetid: 9fe5ded0-37a1-48d1-9671-c81ffc4760ad The iostreams headers support conversions between text and encoded forms, and input and output to external files: -[``](../standard-library/fstream.md)\ -[``](../standard-library/iomanip.md)\ -[``](../standard-library/ios.md)\ -[``](../standard-library/iosfwd.md)\ -[``](../standard-library/iostream.md)\ -[``](../standard-library/istream.md)\ -[``](../standard-library/ostream.md)\ -[``](../standard-library/sstream.md)\ -[``](../standard-library/streambuf.md)\ -[``](../standard-library/strstream.md) +[``](fstream.md)\ +[``](iomanip.md)\ +[``](ios.md)\ +[``](iosfwd.md)\ +[``](iostream.md)\ +[``](istream.md)\ +[``](ostream.md)\ +[``](sstream.md)\ +[``](streambuf.md)\ +[``](strstream.md) -The simplest use of iostreams requires only that you include the header [``](../standard-library/iostream.md). You can then extract values from [`cin`](../standard-library/iostream.md#cin) or [`wcin`](../standard-library/iostream.md#wcin) to read the standard input. The rules for doing so are outlined in the description of the class [`basic_istream` Class](../standard-library/basic-istream-class.md). You can also insert values to [`cout`](../standard-library/iostream.md#cout) or [`wcout`](../standard-library/iostream.md#wcout) to write the standard output. The rules for doing so are outlined in the description of the class [`basic_ostream` Class](../standard-library/basic-ostream-class.md). Format control common to both extractors and insertors is managed by the class [`basic_ios` Class](../standard-library/basic-ios-class.md). Manipulating this format information in the guise of extracting and inserting objects is the province of several manipulators. +The simplest use of iostreams requires only that you include the header [``](iostream.md). You can then extract values from [`cin`](iostream.md#cin) or [`wcin`](iostream.md#wcin) to read the standard input. The rules for doing so are outlined in the description of the class [`basic_istream` Class](basic-istream-class.md). You can also insert values to [`cout`](iostream.md#cout) or [`wcout`](iostream.md#wcout) to write the standard output. The rules for doing so are outlined in the description of the class [`basic_ostream` Class](basic-ostream-class.md). Format control common to both extractors and insertors is managed by the class [`basic_ios` Class](basic-ios-class.md). Manipulating this format information in the guise of extracting and inserting objects is the province of several manipulators. -You can perform the same iostreams operations on files that you open by name, using the classes declared in [``](../standard-library/fstream.md). To convert between iostreams and objects of class [`basic_string` Class](../standard-library/basic-string-class.md), use the classes declared in [``](../standard-library/sstream.md). To do the same with C strings, use the classes declared in [``](../standard-library/strstream.md). +You can perform the same iostreams operations on files that you open by name, using the classes declared in [``](fstream.md). To convert between iostreams and objects of class [`basic_string` Class](basic-string-class.md), use the classes declared in [``](sstream.md). To do the same with C strings, use the classes declared in [``](strstream.md). The remaining headers provide support services, typically of direct interest to only the most advanced users of the iostreams classes. ## See also -[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)\ -[`iostream` Programming](../standard-library/iostream-programming.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[C++ Standard Library Overview](cpp-standard-library-overview.md)\ +[`iostream` Programming](iostream-programming.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) From dbfcc8f356c39986a756d0b53f0a65a4e7e13b6f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:27:11 +0800 Subject: [PATCH 0921/1799] Remove duplicate "class" and convert "Class" to lowercase in "iostreams Conventions" topic --- docs/standard-library/iostreams-conventions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/iostreams-conventions.md b/docs/standard-library/iostreams-conventions.md index 2bf6e1f6029..a362c2a0a01 100644 --- a/docs/standard-library/iostreams-conventions.md +++ b/docs/standard-library/iostreams-conventions.md @@ -20,9 +20,9 @@ The iostreams headers support conversions between text and encoded forms, and in [``](streambuf.md)\ [``](strstream.md) -The simplest use of iostreams requires only that you include the header [``](iostream.md). You can then extract values from [`cin`](iostream.md#cin) or [`wcin`](iostream.md#wcin) to read the standard input. The rules for doing so are outlined in the description of the class [`basic_istream` Class](basic-istream-class.md). You can also insert values to [`cout`](iostream.md#cout) or [`wcout`](iostream.md#wcout) to write the standard output. The rules for doing so are outlined in the description of the class [`basic_ostream` Class](basic-ostream-class.md). Format control common to both extractors and insertors is managed by the class [`basic_ios` Class](basic-ios-class.md). Manipulating this format information in the guise of extracting and inserting objects is the province of several manipulators. +The simplest use of iostreams requires only that you include the header [``](iostream.md). You can then extract values from [`cin`](iostream.md#cin) or [`wcin`](iostream.md#wcin) to read the standard input. The rules for doing so are outlined in the description of the [`basic_istream` class](basic-istream-class.md). You can also insert values to [`cout`](iostream.md#cout) or [`wcout`](iostream.md#wcout) to write the standard output. The rules for doing so are outlined in the description of the [`basic_ostream` class](basic-ostream-class.md). Format control common to both extractors and insertors is managed by the [`basic_ios` class](basic-ios-class.md). Manipulating this format information in the guise of extracting and inserting objects is the province of several manipulators. -You can perform the same iostreams operations on files that you open by name, using the classes declared in [``](fstream.md). To convert between iostreams and objects of class [`basic_string` Class](basic-string-class.md), use the classes declared in [``](sstream.md). To do the same with C strings, use the classes declared in [``](strstream.md). +You can perform the same iostreams operations on files that you open by name, using the classes declared in [``](fstream.md). To convert between iostreams and objects of [`basic_string` class](basic-string-class.md), use the classes declared in [``](sstream.md). To do the same with C strings, use the classes declared in [``](strstream.md). The remaining headers provide support services, typically of direct interest to only the most advanced users of the iostreams classes. From 57ae987edb6c0b74cfbcc82240e287e17450df0a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:27:41 +0800 Subject: [PATCH 0922/1799] Update metadata in "iostreams Conventions" topic --- docs/standard-library/iostreams-conventions.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/iostreams-conventions.md b/docs/standard-library/iostreams-conventions.md index a362c2a0a01..33f3588d273 100644 --- a/docs/standard-library/iostreams-conventions.md +++ b/docs/standard-library/iostreams-conventions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: iostreams Conventions" title: "iostreams Conventions" -ms.date: "11/04/2016" +description: "Learn more about: iostreams Conventions" +ms.date: 11/04/2016 helpviewer_keywords: ["iostream header", "C++ Standard Library, iostreams"] -ms.assetid: 9fe5ded0-37a1-48d1-9671-c81ffc4760ad --- # iostreams Conventions From 0e4f92d45e44aedd84d430c99c9cd4aa903db867 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:36:50 +0800 Subject: [PATCH 0923/1799] Add blockquotes for error messages in range [C3851, C3890] --- docs/error-messages/compiler-errors-2/compiler-error-c3852.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3853.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3854.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3855.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3856.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3857.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3858.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3860.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3865.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3866.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3867.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3868.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3869.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3872.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3873.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3874.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3880.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3886.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3887.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3888.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3890.md | 2 +- 21 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md index af2bf00c9e5..f42c36ef6ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md @@ -8,7 +8,7 @@ ms.assetid: 194e5c5e-0dfb-414e-86db-791c11eb610c --- # Compiler Error C3852 -'member' having type 'type': aggregate initialization could not initialize this member +> 'member' having type 'type': aggregate initialization could not initialize this member An attempt was made to assign a default initialization as part of an aggregate initialization to a data member that cannot receive a default initialization in an aggregate initialization. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md index cc8cc07302f..59b458d988f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md @@ -8,7 +8,7 @@ ms.assetid: 5b71805d-52b4-44ec-80ae-37c68d876f6a --- # Compiler Error C3853 -'=': re-initializing a reference or assignment through a reference-to-function is illegal +> '=': re-initializing a reference or assignment through a reference-to-function is illegal Cannot assign to a reference through a function because functions are not lvalues. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md index 5726a0af135..6e226df550d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md @@ -8,7 +8,7 @@ ms.assetid: 32a9ead0-c6c7-485a-8802-c7b1fe921d3a --- # Compiler Error C3854 -expression to left of '=' evaluates to a function. Cannot assign to a function (a function is not an l-value) +> expression to left of '=' evaluates to a function. Cannot assign to a function (a function is not an l-value) A reference cannot be reinitialized. Dereferencing a reference to a function yields a function, which is an rvalue, to which you cannot assign. Therefore, you cannot assign through a reference to a function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md index 94133ecbfa7..d0e6e4068c8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md @@ -8,7 +8,7 @@ ms.assetid: ed90f8c0-4154-4243-b066-493913df5727 --- # Compiler Error C3855 -'class': type parameter 'param' is incompatible with the declaration +> 'class': type parameter 'param' is incompatible with the declaration The compiler found nontype template or generic parameters with different names. This can occur when a specified template parameter in the definition of a template specialization is incompatible with its declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md index 8ce44778f3f..cb09c2739fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md @@ -8,7 +8,7 @@ ms.assetid: 242d9322-c325-4f20-be58-b2be6da56d60 --- # Compiler Error C3856 -'type': class is not a class type +> 'type': class is not a class type The most common cause for this error is when there are more generic or template parameter lists at the point of definition than there were at the point of declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md index f1696e055f2..1bb21cef8ae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md @@ -8,7 +8,7 @@ ms.assetid: 9f746d1e-9708-4945-bc29-3150d5371d3c --- # Compiler Error C3857 -'type': multiple type parameter lists are not allowed +> 'type': multiple type parameter lists are not allowed More than one template or generic was specified for the same type, which is not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md index 00ac4027fa4..b0457cc4bae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md @@ -8,7 +8,7 @@ ms.assetid: 46e178d5-a55f-4ac6-a9dc-561fbcba5c1f --- # Compiler Error C3858 -'type': cannot be redeclared in current scope +> 'type': cannot be redeclared in current scope The type cannot be declared twice in the same scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md index 173f2736ae8..e384bb7ee2c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md @@ -8,7 +8,7 @@ ms.assetid: 1fb5110d-594e-4f1c-8773-888233af1313 --- # Compiler Error C3860 -type argument list following class type name must list parameters in the order used in type parameter list +> type argument list following class type name must list parameters in the order used in type parameter list A generic or template argument list was ill formed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md index 587ea10aba1..415b51f2808 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md @@ -8,7 +8,7 @@ ms.assetid: 9bc62bb0-4fb8-4856-a5cf-c7cb4029a596 --- # Compiler Error C3865 -'calling_convention' : can only be used on native member functions +> 'calling_convention' : can only be used on native member functions A calling convention was used on a function that was either a global function or on a managed member function. The calling convention can only be used on a native (not managed) member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md index 71d634a4b5e..66483934255 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md @@ -8,7 +8,7 @@ ms.assetid: 685870af-2440-4cdf-a6cb-284a5b96ef9d --- # Compiler Error C3866 -function call missing argument list +> function call missing argument list Inside a nonstatic member function, a destructor or finalizer call did not have an argument list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md index db31e6aef73..dff2bf406a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3867"] --- # Compiler Error C3867 -'func': function call missing argument list; use '&func' to create a pointer to member +> 'func': function call missing argument list; use '&func' to create a pointer to member You tried to take the address of a member function without qualifying the member function with its class name and the address-of operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md index d3eb1d2f2e4..162e820ff53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md @@ -8,7 +8,7 @@ ms.assetid: f0e45c2a-2149-4885-a03b-0d230069f03a --- # Compiler Error C3868 -'type': constraints on generic parameter 'parameter' differ from those on the declaration +> 'type': constraints on generic parameter 'parameter' differ from those on the declaration Multiple declarations must have the same generic constraints. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md index 6df2c9c037f..9cd9f1d5ee3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md @@ -8,7 +8,7 @@ ms.assetid: 85b2ad72-95c1-4ed6-9761-6ef66c3802b7 --- # Compiler Error C3869 -gcnew constraint is missing empty parameter list '()' +> gcnew constraint is missing empty parameter list '()' The **`gcnew`** special constraint was specified without the empty parameter list. See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md index 65ac7afb1f6..1a716c93c66 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md @@ -8,7 +8,7 @@ ms.assetid: 519e95be-5641-40cc-894c-da4819506604 --- # Compiler Error C3872 -'char': this character is not allowed in an identifier +> 'char': this character is not allowed in an identifier The C++ compiler follows the C++11 standard on characters allowed in an identifier. Only certain ranges of characters and universal character names are allowed in an identifier. Additional restrictions apply to the initial character of an identifier. For more information and a list of allowed characters and universal character name ranges, see [Identifiers](../../cpp/identifiers-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md index 90f0de0b051..3a95a6e9aa1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md @@ -8,7 +8,7 @@ ms.assetid: e68fd3be-2391-492b-ac3f-d2428901b2e9 --- # Compiler Error C3873 -'char': this character is not allowed as a first character of an identifier +> 'char': this character is not allowed as a first character of an identifier The C++ compiler follows the C++11 standard on characters allowed in an identifier. Only certain ranges of characters and universal character names are allowed in an identifier. Additional restrictions apply to the initial character of an identifier. For more information and a list of allowed characters and universal character name ranges, see [Identifiers](../../cpp/identifiers-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md index 596ca9d98d1..e9a72c4b376 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md @@ -8,7 +8,7 @@ ms.assetid: fd55fc05-69a7-4237-b3b7-dca1d5400b4f --- # Compiler Error C3874 -return type of 'function' should be 'int' instead of 'type' +> return type of 'function' should be 'int' instead of 'type' A function does not have the return type that was expected by the compiler. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md index 6a0ac4d45c6..6502030c5cb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md @@ -8,7 +8,7 @@ ms.assetid: b0e05d1e-32d0-4034-9246-f37d23573ea9 --- # Compiler Error C3880 -'var' : cannot be a literal data member +> 'var' : cannot be a literal data member The type of a [literal](../../extensions/literal-cpp-component-extensions.md) attribute must be, or compile-time convertible to, one of the following types: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md index e1973ceb117..9b832c51420 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md @@ -8,7 +8,7 @@ ms.assetid: 485f6c12-cc1b-4146-9034-409a0a5e615e --- # Compiler Error C3886 -'var' : a literal data member must be initialized +> 'var' : a literal data member must be initialized A [literal](../../extensions/literal-cpp-component-extensions.md) variable must be initialized when it is declaraed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md index 65c16cb61d9..38523d6a0ec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md @@ -8,7 +8,7 @@ ms.assetid: a7e82426-ef99-437b-9562-2822004e18fe --- # Compiler Error C3887 -'var' : the initializer for a literal data member must be a constant expression +> 'var' : the initializer for a literal data member must be a constant expression A [literal](../../extensions/literal-cpp-component-extensions.md) data member can only be initialized with a constant expresion. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3888.md b/docs/error-messages/compiler-errors-2/compiler-error-c3888.md index b7a9a19d216..e6080f5b8f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3888.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3888.md @@ -8,7 +8,7 @@ ms.assetid: 40820812-79c5-4dcd-a19d-b4164d25fc8a --- # Compiler Error C3888 -'name' : the const expression associated with this literal data member is not supported by C++/CLI +> 'name' : the const expression associated with this literal data member is not supported by C++/CLI The *name* data member that is declared with the [literal](../../extensions/literal-cpp-component-extensions.md) keyword is initialized with a value the compiler does not support. The compiler supports only constant integral, enum, or string types. The likely cause for the **C3888** error is that the data member is initialized with a byte array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md index 22c57edd6cd..a433dd204f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md @@ -8,7 +8,7 @@ ms.assetid: 2f22c2fd-c14e-45e1-b936-b739ffc0b135 --- # Compiler Error C3890 -'var' : you cannot take the address of a literal data member +> 'var' : you cannot take the address of a literal data member A literal data member exists on the garbage-collected heap. An object on the garbage-collected heap can be moved, so taking the address is not useful. From 24cb427093b27cb61af6353cc47d8586444ebdc4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:42:54 +0800 Subject: [PATCH 0924/1799] Add "Remarks" and "Example" headings for error references in range [C3851, C3890] --- docs/error-messages/compiler-errors-2/compiler-error-c3852.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3853.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3854.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3855.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3856.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3857.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3858.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3859.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3860.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3861.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c3865.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3866.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3867.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3868.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3869.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3872.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3873.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3874.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3880.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3883.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3886.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3887.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3888.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3890.md | 4 ++++ 24 files changed, 84 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md index f42c36ef6ce..5400c851d3c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md @@ -10,8 +10,12 @@ ms.assetid: 194e5c5e-0dfb-414e-86db-791c11eb610c > 'member' having type 'type': aggregate initialization could not initialize this member +## Remarks + An attempt was made to assign a default initialization as part of an aggregate initialization to a data member that cannot receive a default initialization in an aggregate initialization. +## Example + The following samples generate C3852: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md index 59b458d988f..4453ba4d736 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md @@ -10,8 +10,12 @@ ms.assetid: 5b71805d-52b4-44ec-80ae-37c68d876f6a > '=': re-initializing a reference or assignment through a reference-to-function is illegal +## Remarks + Cannot assign to a reference through a function because functions are not lvalues. +## Example + The following samples generate C3853: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md index 6e226df550d..ec413102911 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md @@ -10,8 +10,12 @@ ms.assetid: 32a9ead0-c6c7-485a-8802-c7b1fe921d3a > expression to left of '=' evaluates to a function. Cannot assign to a function (a function is not an l-value) +## Remarks + A reference cannot be reinitialized. Dereferencing a reference to a function yields a function, which is an rvalue, to which you cannot assign. Therefore, you cannot assign through a reference to a function. +## Example + The following sample generates C3854: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md index d0e6e4068c8..acb3dc1db70 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md @@ -10,8 +10,12 @@ ms.assetid: ed90f8c0-4154-4243-b066-493913df5727 > 'class': type parameter 'param' is incompatible with the declaration +## Remarks + The compiler found nontype template or generic parameters with different names. This can occur when a specified template parameter in the definition of a template specialization is incompatible with its declaration. +## Examples + The following sample generates C3855: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md index cb09c2739fc..fb363f99332 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md @@ -10,8 +10,12 @@ ms.assetid: 242d9322-c325-4f20-be58-b2be6da56d60 > 'type': class is not a class type +## Remarks + The most common cause for this error is when there are more generic or template parameter lists at the point of definition than there were at the point of declaration. +## Examples + The following sample generates C3856: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md index 1bb21cef8ae..13c89329af2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md @@ -10,8 +10,12 @@ ms.assetid: 9f746d1e-9708-4945-bc29-3150d5371d3c > 'type': multiple type parameter lists are not allowed +## Remarks + More than one template or generic was specified for the same type, which is not allowed. +## Examples + The following sample generates C3857: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md index b0457cc4bae..34588be0f7b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md @@ -10,8 +10,12 @@ ms.assetid: 46e178d5-a55f-4ac6-a9dc-561fbcba5c1f > 'type': cannot be redeclared in current scope +## Remarks + The type cannot be declared twice in the same scope. +## Example + The following sample generates C3858: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3859.md b/docs/error-messages/compiler-errors-2/compiler-error-c3859.md index f46601d6816..62ff29930a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3859.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3859.md @@ -25,6 +25,8 @@ The message has one of the following notes: >PCH: Unable to get the requested block of memory\ >Consider using /Fp to allow the compiler to reserve the memory early +## Remarks + There isn't enough virtual memory allocated for your [precompiled header (PCH)](../../build/creating-precompiled-header-files.md). If your precompiled header uses an explicit `#pragma hdrstop` directive, use the **`/Zm`** compiler flag to specify a larger value for the precompiled header file. Otherwise, consider reducing the number of parallel compilation processes in your build. For more information, see [`/Zm` (Specify precompiled header memory allocation limit)](../../build/reference/zm-specify-precompiled-header-memory-allocation-limit.md). This diagnostic shows up mostly in two scenarios: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md index e384bb7ee2c..5af9cff0916 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md @@ -10,8 +10,12 @@ ms.assetid: 1fb5110d-594e-4f1c-8773-888233af1313 > type argument list following class type name must list parameters in the order used in type parameter list +## Remarks + A generic or template argument list was ill formed. +## Examples + The following sample generates C3860: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3861.md b/docs/error-messages/compiler-errors-2/compiler-error-c3861.md index 738a3e76f44..5448f438ffa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3861.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3861.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C3861"] > '*identifier*': identifier not found -The compiler was unable to resolve a reference to an identifier, even using argument-dependent lookup. - ## Remarks +The compiler was unable to resolve a reference to an identifier, even using argument-dependent lookup. + To fix this error, compare use of *identifier* to the identifier declaration for case and spelling. Verify that [scope resolution operators](../../cpp/scope-resolution-operator.md) and namespace [`using` directives](../../cpp/namespaces-cpp.md#using_directives) are used correctly. If the identifier is declared in a header file, verify that the header is included before the identifier is referenced. If the identifier is meant to be externally visible, make sure that it's declared in any source file that uses it. Also check that the identifier declaration or definition isn't excluded by [conditional compilation directives](../../preprocessor/hash-if-hash-elif-hash-else-and-hash-endif-directives-c-cpp.md). Changes to remove obsolete functions from the C Runtime Library in Visual Studio 2015 can cause C3861. To resolve this error, remove references to these functions or replace them with their secure alternatives, if any. For more information, see [Obsolete functions](../../c-runtime-library/obsolete-functions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md index 415b51f2808..19361419ce4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md @@ -10,10 +10,14 @@ ms.assetid: 9bc62bb0-4fb8-4856-a5cf-c7cb4029a596 > 'calling_convention' : can only be used on native member functions +## Remarks + A calling convention was used on a function that was either a global function or on a managed member function. The calling convention can only be used on a native (not managed) member function. For more information, see [Calling Conventions](../../cpp/calling-conventions.md). +## Example + The following sample generates C3865: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md index 66483934255..a7446c26c6a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md @@ -10,8 +10,12 @@ ms.assetid: 685870af-2440-4cdf-a6cb-284a5b96ef9d > function call missing argument list +## Remarks + Inside a nonstatic member function, a destructor or finalizer call did not have an argument list. +## Example + The following sample generates C3866: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md index dff2bf406a6..81655e0f020 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C3867"] > 'func': function call missing argument list; use '&func' to create a pointer to member +## Remarks + You tried to take the address of a member function without qualifying the member function with its class name and the address-of operator. This error can also be generated as a result of compiler conformance work that was done for Visual Studio 2005: enhanced pointer-to-member conformance. Code that compiled prior to Visual Studio 2005 will now generate C3867. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md index 162e820ff53..433633643bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md @@ -10,6 +10,8 @@ ms.assetid: f0e45c2a-2149-4885-a03b-0d230069f03a > 'type': constraints on generic parameter 'parameter' differ from those on the declaration +## Remarks + Multiple declarations must have the same generic constraints. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md index 9cd9f1d5ee3..3a7eb0e8bec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md @@ -10,6 +10,8 @@ ms.assetid: 85b2ad72-95c1-4ed6-9761-6ef66c3802b7 > gcnew constraint is missing empty parameter list '()' +## Remarks + The **`gcnew`** special constraint was specified without the empty parameter list. See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md index 1a716c93c66..024b5134dce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md @@ -10,10 +10,14 @@ ms.assetid: 519e95be-5641-40cc-894c-da4819506604 > 'char': this character is not allowed in an identifier +## Remarks + The C++ compiler follows the C++11 standard on characters allowed in an identifier. Only certain ranges of characters and universal character names are allowed in an identifier. Additional restrictions apply to the initial character of an identifier. For more information and a list of allowed characters and universal character name ranges, see [Identifiers](../../cpp/identifiers-cpp.md). The range of characters allowed in an identifier is less restrictive when compiling C++/CLI code. Identifiers in code compiled by using /clr should follow [Standard ECMA-335: Common Language Infrastructure (CLI)](https://ecma-international.org/publications-and-standards/standards/ecma-335/). +## Example + The following sample generates C3872: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md index 3a95a6e9aa1..6a1aadf204a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md @@ -10,10 +10,14 @@ ms.assetid: e68fd3be-2391-492b-ac3f-d2428901b2e9 > 'char': this character is not allowed as a first character of an identifier +## Remarks + The C++ compiler follows the C++11 standard on characters allowed in an identifier. Only certain ranges of characters and universal character names are allowed in an identifier. Additional restrictions apply to the initial character of an identifier. For more information and a list of allowed characters and universal character name ranges, see [Identifiers](../../cpp/identifiers-cpp.md). The range of characters allowed in an identifier is less restrictive when compiling C++/CLI code. Identifiers in code compiled by using /clr should follow [Standard ECMA-335: Common Language Infrastructure (CLI)](https://ecma-international.org/publications-and-standards/standards/ecma-335/). +## Example + The following sample generates C3873: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md index e9a72c4b376..ad6251492f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md @@ -10,8 +10,12 @@ ms.assetid: fd55fc05-69a7-4237-b3b7-dca1d5400b4f > return type of 'function' should be 'int' instead of 'type' +## Remarks + A function does not have the return type that was expected by the compiler. +## Example + The following sample generates C3874: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md index 6502030c5cb..5725a00bddb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md @@ -10,6 +10,8 @@ ms.assetid: b0e05d1e-32d0-4034-9246-f37d23573ea9 > 'var' : cannot be a literal data member +## Remarks + The type of a [literal](../../extensions/literal-cpp-component-extensions.md) attribute must be, or compile-time convertible to, one of the following types: - integral type @@ -18,6 +20,8 @@ The type of a [literal](../../extensions/literal-cpp-component-extensions.md) at - enum with an integral or underlying type +## Example + The following sample generates C3880: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3883.md b/docs/error-messages/compiler-errors-2/compiler-error-c3883.md index 6ed6a89c19c..15209c21707 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3883.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3883.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C3883"] > '*member*': an initonly static data member must be initialized +## Remarks + A variable marked with [initonly](../../dotnet/initonly-cpp-cli.md) was not initialized correctly. +## Example + The following sample generates C3883: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md index 9b832c51420..de2ede07af7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md @@ -10,8 +10,12 @@ ms.assetid: 485f6c12-cc1b-4146-9034-409a0a5e615e > 'var' : a literal data member must be initialized +## Remarks + A [literal](../../extensions/literal-cpp-component-extensions.md) variable must be initialized when it is declaraed. +## Example + The following sample generates C3886: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md index 38523d6a0ec..3662ec80e31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md @@ -10,8 +10,12 @@ ms.assetid: a7e82426-ef99-437b-9562-2822004e18fe > 'var' : the initializer for a literal data member must be a constant expression +## Remarks + A [literal](../../extensions/literal-cpp-component-extensions.md) data member can only be initialized with a constant expresion. +## Example + The following sample generates C3887: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3888.md b/docs/error-messages/compiler-errors-2/compiler-error-c3888.md index e6080f5b8f9..507bce41e83 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3888.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3888.md @@ -10,6 +10,8 @@ ms.assetid: 40820812-79c5-4dcd-a19d-b4164d25fc8a > 'name' : the const expression associated with this literal data member is not supported by C++/CLI +## Remarks + The *name* data member that is declared with the [literal](../../extensions/literal-cpp-component-extensions.md) keyword is initialized with a value the compiler does not support. The compiler supports only constant integral, enum, or string types. The likely cause for the **C3888** error is that the data member is initialized with a byte array. ### To correct this error diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md index a433dd204f0..740a16535b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md @@ -10,8 +10,12 @@ ms.assetid: 2f22c2fd-c14e-45e1-b936-b739ffc0b135 > 'var' : you cannot take the address of a literal data member +## Remarks + A literal data member exists on the garbage-collected heap. An object on the garbage-collected heap can be moved, so taking the address is not useful. +## Example + The following sample generates C3890: ```cpp From cc1996b0c6afb5ac7938a04cd61dc1327f5d2d34 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:44:47 +0800 Subject: [PATCH 0925/1799] Replace term "sample" with "example" for error references in range [C3851, C3890] --- .../compiler-errors-2/compiler-error-c3851.md | 2 +- .../compiler-errors-2/compiler-error-c3852.md | 2 +- .../compiler-errors-2/compiler-error-c3853.md | 2 +- .../compiler-errors-2/compiler-error-c3854.md | 2 +- .../compiler-errors-2/compiler-error-c3855.md | 2 +- .../compiler-errors-2/compiler-error-c3856.md | 2 +- .../compiler-errors-2/compiler-error-c3857.md | 2 +- .../compiler-errors-2/compiler-error-c3858.md | 2 +- .../compiler-errors-2/compiler-error-c3860.md | 2 +- .../compiler-errors-2/compiler-error-c3861.md | 6 +++--- .../compiler-errors-2/compiler-error-c3862.md | 2 +- .../compiler-errors-2/compiler-error-c3865.md | 2 +- .../compiler-errors-2/compiler-error-c3866.md | 2 +- .../compiler-errors-2/compiler-error-c3867.md | 10 +++++----- .../compiler-errors-2/compiler-error-c3868.md | 2 +- .../compiler-errors-2/compiler-error-c3869.md | 2 +- .../compiler-errors-2/compiler-error-c3872.md | 2 +- .../compiler-errors-2/compiler-error-c3873.md | 2 +- .../compiler-errors-2/compiler-error-c3874.md | 2 +- .../compiler-errors-2/compiler-error-c3880.md | 2 +- .../compiler-errors-2/compiler-error-c3883.md | 6 +++--- .../compiler-errors-2/compiler-error-c3886.md | 2 +- .../compiler-errors-2/compiler-error-c3887.md | 2 +- .../compiler-errors-2/compiler-error-c3890.md | 2 +- 24 files changed, 32 insertions(+), 32 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3851.md b/docs/error-messages/compiler-errors-2/compiler-error-c3851.md index 50a7a94eabb..a32ffce02f4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3851.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3851.md @@ -16,7 +16,7 @@ In code compiled as C++, you cannot use a universal character name that represen ## Example -The following samples generate C3851, and show how to fix it: +The following example generate C3851, and show how to fix it: ```cpp // C3851.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md index 5400c851d3c..91946e5224a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md @@ -16,7 +16,7 @@ An attempt was made to assign a default initialization as part of an aggregate i ## Example -The following samples generate C3852: +The following example generate C3852: ```cpp // C3852.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md index 4453ba4d736..fce54e773fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md @@ -16,7 +16,7 @@ Cannot assign to a reference through a function because functions are not lvalue ## Example -The following samples generate C3853: +The following example generate C3853: ```cpp // C3853.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md index ec413102911..c2b673c3d05 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md @@ -16,7 +16,7 @@ A reference cannot be reinitialized. Dereferencing a reference to a function yie ## Example -The following sample generates C3854: +The following example generates C3854: ```cpp // C3854.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md index acb3dc1db70..55a923b34e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md @@ -16,7 +16,7 @@ The compiler found nontype template or generic parameters with different names. ## Examples -The following sample generates C3855: +The following example generates C3855: ```cpp // C3855.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md index fb363f99332..3b43873f65a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md @@ -16,7 +16,7 @@ The most common cause for this error is when there are more generic or template ## Examples -The following sample generates C3856: +The following example generates C3856: ```cpp // C3856.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md index 13c89329af2..48e1289cebf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md @@ -16,7 +16,7 @@ More than one template or generic was specified for the same type, which is not ## Examples -The following sample generates C3857: +The following example generates C3857: ```cpp // C3857.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md index 34588be0f7b..8ddc81e2837 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md @@ -16,7 +16,7 @@ The type cannot be declared twice in the same scope. ## Example -The following sample generates C3858: +The following example generates C3858: ```cpp // C3858.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md index 5af9cff0916..dba9271742b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md @@ -16,7 +16,7 @@ A generic or template argument list was ill formed. ## Examples -The following sample generates C3860: +The following example generates C3860: ```cpp // C3860.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3861.md b/docs/error-messages/compiler-errors-2/compiler-error-c3861.md index 5448f438ffa..b45f6623ab7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3861.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3861.md @@ -23,7 +23,7 @@ If error C3861 appears after project migration from older versions of the compil ### Undefined identifier -The following sample generates C3861 because the identifier isn't defined. +The following example generates C3861 because the identifier isn't defined. ```cpp // C3861.cpp @@ -36,7 +36,7 @@ int main() { ### Identifier not in scope -The following sample generates C3861, because an identifier is only visible in the file scope of its definition, unless it's declared in other source files that use it. +The following example generates C3861, because an identifier is only visible in the file scope of its definition, unless it's declared in other source files that use it. Source file `C3861_a1.cpp`: @@ -97,7 +97,7 @@ int main() { ### ADL and friend functions -The following sample generates C3861 because the compiler can't use argument dependent lookup for `FriendFunc`: +The following example generates C3861 because the compiler can't use argument dependent lookup for `FriendFunc`: ```cpp namespace N { diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3862.md b/docs/error-messages/compiler-errors-2/compiler-error-c3862.md index 583cd4c16f4..17e5b9ea878 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3862.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3862.md @@ -20,7 +20,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates C3862: +The following example generates C3862: ```cpp // C3862.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md index 19361419ce4..bea0de23ac6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md @@ -18,7 +18,7 @@ For more information, see [Calling Conventions](../../cpp/calling-conventions.md ## Example -The following sample generates C3865: +The following example generates C3865: ```cpp // C3865.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md index a7446c26c6a..8408f61c682 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md @@ -16,7 +16,7 @@ Inside a nonstatic member function, a destructor or finalizer call did not have ## Example -The following sample generates C3866: +The following example generates C3866: ```cpp // C3866.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md index 81655e0f020..d6f858a58b7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md @@ -19,7 +19,7 @@ This error can also be generated as a result of compiler conformance work that w C3867 can be issued from the compiler with a misleading suggested resolution. Whenever possible, use the most derived class. -The following sample generates C3867 and shows how to fix it. +The following example generates C3867 and shows how to fix it. ```cpp // C3867_1.cpp @@ -39,7 +39,7 @@ void Derived::Bar() { } ``` -The following sample generates C3867 and shows how to fix it. +The following example generates C3867 and shows how to fix it. ```cpp // C3867_2.cpp @@ -69,7 +69,7 @@ int main() { } ``` -The following sample generates C3867 and shows how to fix it. +The following example generates C3867 and shows how to fix it. ```cpp // C3867_3.cpp @@ -86,7 +86,7 @@ int main() { } ``` -The following sample generates C3867. +The following example generates C3867. ```cpp // C3867_4.cpp @@ -108,7 +108,7 @@ public: }; ``` -The following sample generates C3867. +The following example generates C3867. ```cpp // C3867_5.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md index 433633643bb..627e86cb79f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md @@ -16,7 +16,7 @@ Multiple declarations must have the same generic constraints. For more informat ## Example -The following sample generates C3868. +The following example generates C3868. ```cpp // C3868.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md index 3a7eb0e8bec..5b1fe936313 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md @@ -16,7 +16,7 @@ The **`gcnew`** special constraint was specified without the empty parameter lis ## Example -The following sample generates C3869. +The following example generates C3869. ```cpp // C3869.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md index 024b5134dce..adeb337f8c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md @@ -18,7 +18,7 @@ The range of characters allowed in an identifier is less restrictive when compil ## Example -The following sample generates C3872: +The following example generates C3872: ```cpp // C3872.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md index 6a1aadf204a..63b785626b6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md @@ -18,7 +18,7 @@ The range of characters allowed in an identifier is less restrictive when compil ## Example -The following sample generates C3873: +The following example generates C3873: ```cpp // C3873.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md index ad6251492f2..7cd3c8a34f4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md @@ -16,7 +16,7 @@ A function does not have the return type that was expected by the compiler. ## Example -The following sample generates C3874: +The following example generates C3874: ```cpp // C3874b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md index 5725a00bddb..fba6e98b908 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md @@ -22,7 +22,7 @@ The type of a [literal](../../extensions/literal-cpp-component-extensions.md) at ## Example -The following sample generates C3880: +The following example generates C3880: ```cpp // C3880.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3883.md b/docs/error-messages/compiler-errors-2/compiler-error-c3883.md index 15209c21707..9ccd906f326 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3883.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3883.md @@ -15,7 +15,7 @@ A variable marked with [initonly](../../dotnet/initonly-cpp-cli.md) was not init ## Example -The following sample generates C3883: +The following example generates C3883: ```cpp // C3883.cpp @@ -26,7 +26,7 @@ ref struct Y1 { }; ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3883b.cpp @@ -37,7 +37,7 @@ ref struct Y1 { }; ``` -The following sample shows how to initialize in a static constructor: +The following example shows how to initialize in a static constructor: ```cpp // C3883c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md index de2ede07af7..8fd5468890a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md @@ -16,7 +16,7 @@ A [literal](../../extensions/literal-cpp-component-extensions.md) variable must ## Example -The following sample generates C3886: +The following example generates C3886: ```cpp // C3886.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md index 3662ec80e31..bf45ea10cb5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md @@ -16,7 +16,7 @@ A [literal](../../extensions/literal-cpp-component-extensions.md) data member ca ## Example -The following sample generates C3887: +The following example generates C3887: ```cpp // C3887.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md index 740a16535b0..adc3a2d0671 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md @@ -16,7 +16,7 @@ A literal data member exists on the garbage-collected heap. An object on the ga ## Example -The following sample generates C3890: +The following example generates C3890: ```cpp // C3890.cpp From 4b1fbc70471425170c6c6ca81d5b4bd50b167079 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sat, 23 Aug 2025 22:49:23 +0800 Subject: [PATCH 0926/1799] Update metadata for error references in range [C3851, C3890] --- .../error-messages/compiler-errors-2/compiler-error-c3851.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3852.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3853.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3854.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3855.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3856.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3857.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3858.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3859.md | 2 +- .../error-messages/compiler-errors-2/compiler-error-c3860.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3862.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3865.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3866.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3867.md | 2 +- .../error-messages/compiler-errors-2/compiler-error-c3868.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3869.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3872.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3873.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3874.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3880.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3883.md | 2 +- .../error-messages/compiler-errors-2/compiler-error-c3886.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3887.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3888.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3890.md | 5 ++--- 25 files changed, 47 insertions(+), 69 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3851.md b/docs/error-messages/compiler-errors-2/compiler-error-c3851.md index a32ffce02f4..b711d0114d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3851.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3851.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3851" title: "Compiler Error C3851" -ms.date: "09/05/2018" +description: "Learn more about: Compiler Error C3851" +ms.date: 09/05/2018 f1_keywords: ["C3851"] helpviewer_keywords: ["C3851"] -ms.assetid: da30c21c-33aa-4439-8fb3-2f5021ea4985 --- # Compiler Error C3851 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md index 91946e5224a..79818b2719a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3852" title: "Compiler Error C3852" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3852" +ms.date: 11/04/2016 f1_keywords: ["C3852"] helpviewer_keywords: ["C3852"] -ms.assetid: 194e5c5e-0dfb-414e-86db-791c11eb610c --- # Compiler Error C3852 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md index fce54e773fe..935ffefaaa3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3853" title: "Compiler Error C3853" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3853" +ms.date: 11/04/2016 f1_keywords: ["C3853"] helpviewer_keywords: ["C3853"] -ms.assetid: 5b71805d-52b4-44ec-80ae-37c68d876f6a --- # Compiler Error C3853 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md index c2b673c3d05..1884381f47f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3854" title: "Compiler Error C3854" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3854" +ms.date: 11/04/2016 f1_keywords: ["C3854"] helpviewer_keywords: ["C3854"] -ms.assetid: 32a9ead0-c6c7-485a-8802-c7b1fe921d3a --- # Compiler Error C3854 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md index 55a923b34e1..070460053f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3855" title: "Compiler Error C3855" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3855" +ms.date: 11/04/2016 f1_keywords: ["C3855"] helpviewer_keywords: ["C3855"] -ms.assetid: ed90f8c0-4154-4243-b066-493913df5727 --- # Compiler Error C3855 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md index 3b43873f65a..e4241d6dcc0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3856" title: "Compiler Error C3856" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3856" +ms.date: 11/04/2016 f1_keywords: ["C3856"] helpviewer_keywords: ["C3856"] -ms.assetid: 242d9322-c325-4f20-be58-b2be6da56d60 --- # Compiler Error C3856 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md index 48e1289cebf..0a64becf2b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3857" title: "Compiler Error C3857" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3857" +ms.date: 11/04/2016 f1_keywords: ["C3857"] helpviewer_keywords: ["C3857"] -ms.assetid: 9f746d1e-9708-4945-bc29-3150d5371d3c --- # Compiler Error C3857 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md index 8ddc81e2837..249ac5979b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3858" title: "Compiler Error C3858" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3858" +ms.date: 11/04/2016 f1_keywords: ["C3858"] helpviewer_keywords: ["C3858"] -ms.assetid: 46e178d5-a55f-4ac6-a9dc-561fbcba5c1f --- # Compiler Error C3858 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3859.md b/docs/error-messages/compiler-errors-2/compiler-error-c3859.md index 62ff29930a4..b9c63f460ab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3859.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3859.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C3859" title: "Compiler Error C3859" +description: "Learn more about: Compiler Error C3859" ms.date: 02/22/2022 f1_keywords: ["C3859"] helpviewer_keywords: ["C3859"] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md index dba9271742b..b33bd7e9836 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3860" title: "Compiler Error C3860" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3860" +ms.date: 11/04/2016 f1_keywords: ["C3860"] helpviewer_keywords: ["C3860"] -ms.assetid: 1fb5110d-594e-4f1c-8773-888233af1313 --- # Compiler Error C3860 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3862.md b/docs/error-messages/compiler-errors-2/compiler-error-c3862.md index 17e5b9ea878..8bfa574489d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3862.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3862.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3862" title: "Compiler Error C3862" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3862" +ms.date: 11/04/2016 f1_keywords: ["C3862"] helpviewer_keywords: ["C3862"] -ms.assetid: ba547366-4189-4077-8c00-ab45e08a9533 --- # Compiler Error C3862 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md index bea0de23ac6..147494f98db 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3865" title: "Compiler Error C3865" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3865" +ms.date: 11/04/2016 f1_keywords: ["C3865"] helpviewer_keywords: ["C3865"] -ms.assetid: 9bc62bb0-4fb8-4856-a5cf-c7cb4029a596 --- # Compiler Error C3865 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md index 8408f61c682..655db97c3ad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3866" title: "Compiler Error C3866" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3866" +ms.date: 11/04/2016 f1_keywords: ["C3866"] helpviewer_keywords: ["C3866"] -ms.assetid: 685870af-2440-4cdf-a6cb-284a5b96ef9d --- # Compiler Error C3866 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md index d6f858a58b7..a3426c61f3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C3867" description: "Learn more about: Compiler Error C3867" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C3867"] helpviewer_keywords: ["C3867"] --- diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md index 627e86cb79f..3276521fff2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3868" title: "Compiler Error C3868" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3868" +ms.date: 11/04/2016 f1_keywords: ["C3868"] helpviewer_keywords: ["C3868"] -ms.assetid: f0e45c2a-2149-4885-a03b-0d230069f03a --- # Compiler Error C3868 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md index 5b1fe936313..6264bd6bdf2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3869" title: "Compiler Error C3869" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3869" +ms.date: 11/04/2016 f1_keywords: ["C3869"] helpviewer_keywords: ["C3869"] -ms.assetid: 85b2ad72-95c1-4ed6-9761-6ef66c3802b7 --- # Compiler Error C3869 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md index adeb337f8c5..3a5499f3518 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3872" title: "Compiler Error C3872" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3872" +ms.date: 11/04/2016 f1_keywords: ["C3872"] helpviewer_keywords: ["C3872"] -ms.assetid: 519e95be-5641-40cc-894c-da4819506604 --- # Compiler Error C3872 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md index 63b785626b6..829b2a9a342 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3873" title: "Compiler Error C3873" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3873" +ms.date: 11/04/2016 f1_keywords: ["C3873"] helpviewer_keywords: ["C3873"] -ms.assetid: e68fd3be-2391-492b-ac3f-d2428901b2e9 --- # Compiler Error C3873 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md index 7cd3c8a34f4..b6461f75e73 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3874" title: "Compiler Error C3874" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3874" +ms.date: 11/04/2016 f1_keywords: ["C3874"] helpviewer_keywords: ["C3874"] -ms.assetid: fd55fc05-69a7-4237-b3b7-dca1d5400b4f --- # Compiler Error C3874 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md index fba6e98b908..cb33548783f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3880" title: "Compiler Error C3880" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3880" +ms.date: 11/04/2016 f1_keywords: ["C3880"] helpviewer_keywords: ["C3880"] -ms.assetid: b0e05d1e-32d0-4034-9246-f37d23573ea9 --- # Compiler Error C3880 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3883.md b/docs/error-messages/compiler-errors-2/compiler-error-c3883.md index 9ccd906f326..12fcbf17f42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3883.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3883.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C3883" description: "Learn more about: Compiler Error C3883" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C3883"] helpviewer_keywords: ["C3883"] --- diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md index 8fd5468890a..5464660fa41 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3886" title: "Compiler Error C3886" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3886" +ms.date: 11/04/2016 f1_keywords: ["C3886"] helpviewer_keywords: ["C3886"] -ms.assetid: 485f6c12-cc1b-4146-9034-409a0a5e615e --- # Compiler Error C3886 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md index bf45ea10cb5..fae154f26b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3887" title: "Compiler Error C3887" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3887" +ms.date: 11/04/2016 f1_keywords: ["C3887"] helpviewer_keywords: ["C3887"] -ms.assetid: a7e82426-ef99-437b-9562-2822004e18fe --- # Compiler Error C3887 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3888.md b/docs/error-messages/compiler-errors-2/compiler-error-c3888.md index 507bce41e83..42306cab20a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3888.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3888.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3888" title: "Compiler Error C3888" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3888" +ms.date: 11/04/2016 f1_keywords: ["C3888"] helpviewer_keywords: ["C3888"] -ms.assetid: 40820812-79c5-4dcd-a19d-b4164d25fc8a --- # Compiler Error C3888 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md index adc3a2d0671..5034b0196cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3890" title: "Compiler Error C3890" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3890" +ms.date: 11/04/2016 f1_keywords: ["C3890"] helpviewer_keywords: ["C3890"] -ms.assetid: 2f22c2fd-c14e-45e1-b936-b739ffc0b135 --- # Compiler Error C3890 From c538d056974124d9d4ba8c1d205354c4419c19d7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 21:43:17 +0800 Subject: [PATCH 0927/1799] Add blockquotes for error messages in range [C3891, C3999] --- docs/error-messages/compiler-errors-2/compiler-error-c3891.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3892.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3893.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3894.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3895.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3896.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3898.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3899.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3900.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3901.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3902.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3903.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3904.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3908.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3909.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3910.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3911.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3912.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3913.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3914.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3915.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3917.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3918.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3919.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3920.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3923.md | 2 +- 26 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md index d21a7d8e696..06c3f16ef08 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md @@ -8,7 +8,7 @@ ms.assetid: 6e1a9458-97f5-4580-bc0f-aa97a1bfd20d --- # Compiler Error C3891 -'var' : a literal data member cannot be used as a l-value +> 'var' : a literal data member cannot be used as a l-value A [literal](../../extensions/literal-cpp-component-extensions.md) variable is const, and its value cannot be changed after it is initialized in the declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md index 283ef497cad..bbf680821a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md @@ -8,7 +8,7 @@ ms.assetid: 83fff42c-ea48-442f-bc2e-b33a6b99d890 --- # Compiler Error C3892 -'var' : you cannot assign to a variable that is const +> 'var' : you cannot assign to a variable that is const A const variable cannot be changed after it is declared and initialized. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md index b77022a2fd5..f589c2620c5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md @@ -8,7 +8,7 @@ ms.assetid: 90d52eae-6ef2-4db1-b7ad-92f9e8b140fb --- # Compiler Error C3893 -'var' : l-value use of initonly data member is only allowed in an instance constructor of class 'type_name' +> 'var' : l-value use of initonly data member is only allowed in an instance constructor of class 'type_name' Static [initonly](../../dotnet/initonly-cpp-cli.md) data members can only have their address taken in a static constructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md index 15508ee9ee6..e5c4e669db8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md @@ -8,7 +8,7 @@ ms.assetid: 6d5ac903-1dea-431d-8e3a-cebca4342983 --- # Compiler Error C3894 -'var' : l-value use of initonly static data member is only allowed in the class constructor of class 'class' +> 'var' : l-value use of initonly static data member is only allowed in the class constructor of class 'class' Static [initonly](../../dotnet/initonly-cpp-cli.md) data members can only be used as l-values at their point of declaration, or in a static constructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md index 1bdeb12441e..78da3a0fd72 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md @@ -8,7 +8,7 @@ ms.assetid: 771b9fe5-d6d4-4297-bf57-e2f857722155 --- # Compiler Error C3895 -'var' : type data members cannot be 'volatile' +> 'var' : type data members cannot be 'volatile' Certain kinds of data members, for example [literal](../../extensions/literal-cpp-component-extensions.md) or [initonly](../../dotnet/initonly-cpp-cli.md), cannot be [volatile](../../cpp/volatile-cpp.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md index fb207c3e781..87e978f6b86 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md @@ -8,7 +8,7 @@ ms.assetid: eb8be0f6-5b4e-4d71-8285-8a2a94f8ba29 --- # Compiler Error C3896 -'member' : improper initializer: this literal data member can only be initialized with 'nullptr' +> 'member' : improper initializer: this literal data member can only be initialized with 'nullptr' A [literal](../../extensions/literal-cpp-component-extensions.md) data member was initialized incorrectly. See [nullptr](../../extensions/nullptr-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md index 0665bbe6c7c..08cebae6f24 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md @@ -8,7 +8,7 @@ ms.assetid: d9a90df6-87e4-4fe7-ab01-c226ee86bf10 --- # Compiler Error C3898 -'var' : type data members can only be members of managed types +> 'var' : type data members can only be members of managed types An [initonly](../../dotnet/initonly-cpp-cli.md) data member was declared in a native class. An **`initonly`** data member can only be declared in a CLR class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md index b8e55730c7f..556722e603c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md @@ -8,7 +8,7 @@ ms.assetid: 14e07e4a-f7a7-4309-baaa-649d69e12e23 --- # Compiler Error C3899 -'var' : l-value use of initonly data member is not allowed directly within a parallel region in class 'class' +> 'var' : l-value use of initonly data member is not allowed directly within a parallel region in class 'class' An [initonly (C++/CLI)](../../dotnet/initonly-cpp-cli.md) data member cannot be initialized inside that part of a constructor that is in a [parallel](../../parallel/openmp/reference/openmp-directives.md#parallel) region. This is because the compiler does an internal relocation of that code, such that, it is effectively no longer part of the constructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md index 75f0af0b487..38baed0f1f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md @@ -8,7 +8,7 @@ ms.assetid: a94cc561-8fa8-4344-9e01-e81ff462fae5 --- # Compiler Error C3900 -'member': not allowed in current scope +> 'member': not allowed in current scope Property blocks can contain function declarations and inline function definitions only. No members other than functions are allowed in property blocks. No typedefs, operators, or friend functions are allowed. For more information, see [property](../../extensions/property-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md index 391b3327368..21652cbe7d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md @@ -8,7 +8,7 @@ ms.assetid: 19af4141-39ad-4c16-a68f-3ae76f648186 --- # Compiler Error C3901 -'accessor_function': must have return type 'type' +> 'accessor_function': must have return type 'type' At least one get method's return type must match the property type. For more information, see [property](../../extensions/property-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md index 0dd340d0e69..0d8b1610e37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md @@ -8,7 +8,7 @@ ms.assetid: feb3bb29-f836-4d77-ba71-3876f7f4f216 --- # Compiler Error C3902 -'accessor': type of last parameter must be 'type' +> 'accessor': type of last parameter must be 'type' The type of the last parameter of at least one set method must match the type of the property. For more information, see [property](../../extensions/property-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md index d64e3d81a8b..8ecae6d2e57 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md @@ -8,7 +8,7 @@ ms.assetid: cf47d7ad-a3bd-4f75-a253-71586e7a3be6 --- # Compiler Error C3903 -'property': does not have set or get method +> 'property': does not have set or get method A property must have at least a `get` or a `set` method. For more information, see [property](../../extensions/property-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md index 948b386d8d0..2e8f0179ed7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md @@ -8,7 +8,7 @@ ms.assetid: 08297605-e4f2-4c6c-b637-011f1fd40631 --- # Compiler Error C3904 -'property_accessor': must specify number parameter(s) +> 'property_accessor': must specify number parameter(s) Check the number of parameters in your `get` and `set` methods against property dimensions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md index dfbf987ce71..65e956857cb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md @@ -8,7 +8,7 @@ ms.assetid: 3c322482-c79e-4197-a578-2ad9bc379d1a --- # Compiler Error C3908 -access level less restrictive than 'construct' +> access level less restrictive than 'construct' A property accessor method (get or set) cannot have less restrictive access than the access specified on the property itself. Similarly, for event accessor methods. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md index 0ab76f3c406..465991ead15 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md @@ -8,7 +8,7 @@ ms.assetid: 0a443132-e53f-42dc-a58b-f086da3e7bfd --- # Compiler Error C3909 -aWinRT or managed event declaration must occur in a WinRT or managed type +> aWinRT or managed event declaration must occur in a WinRT or managed type A Windows Runtime event or managed event was declared in a native type. To fix this error, declare events in Windows Runtime types or managed types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md index 9b78fc9761a..3ee31678d33 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md @@ -8,7 +8,7 @@ ms.assetid: cfcbe620-b463-463b-95ea-2d60ad33ebb5 --- # Compiler Error C3910 -'event': must define member 'method' +> 'event': must define member 'method' An event was defined, but did not contain the specified, required accessor method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md index 06637b605a0..0eacce5659c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md @@ -8,7 +8,7 @@ ms.assetid: b786da59-0e99-479d-bc0d-551126e940f2 --- # Compiler Error C3911 -'event_accessor_method': function must have type 'signature' +> 'event_accessor_method': function must have type 'signature' An event's accessor method was not properly declared. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md index 60a7683cfe9..47fbe0bf4fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md @@ -8,7 +8,7 @@ ms.assetid: 674e050c-11fb-4db1-8bdf-a3e95b41161d --- # Compiler Error C3912 -'event': type of event must be a delegate type +> 'event': type of event must be a delegate type An event was declared but was not of the proper type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md index 29bf729fda1..1a9040358d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md @@ -8,7 +8,7 @@ ms.assetid: a678bfce-9524-470d-9f23-7d08ecb972c8 --- # Compiler Error C3913 -default property must be indexed +> default property must be indexed A default property was defined incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md index e50e306dc7e..31d2dcfbd6f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md @@ -8,7 +8,7 @@ ms.assetid: 8f3190e6-ee50-4916-9ecc-3b8748b2e1e7 --- # Compiler Error C3914 -a default property cannot be static +> a default property cannot be static A default property was declared incorrectly. For more information, see [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md index 8c882d38401..c7b6f304d19 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md @@ -8,7 +8,7 @@ ms.assetid: 2b0a5e5f-3aec-4a4b-9157-233031817084 --- # Compiler Error C3915 -'type' has no default indexed property (class indexer) +> 'type' has no default indexed property (class indexer) A type does not have a default, indexed property. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md index 1fceea56f9f..617446944c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md @@ -8,7 +8,7 @@ ms.assetid: a24cd0c9-262f-46e5-9488-1c01f945933d --- # Compiler Error C3917 -'*property*': obsolete construct declaration style +> '*property*': obsolete construct declaration style A property or event definition used syntax from a version before Visual Studio 2005. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md index 77d654ba213..a29ca45333b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md @@ -8,7 +8,7 @@ ms.assetid: a8b3a90a-3fe1-4244-a5ff-a31cdae97d98 --- # Compiler Error C3918 -usage requires 'member' to be a data member +> usage requires 'member' to be a data member C3918 can occur for several reasons related to events. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md index 97f0dacc47f..bae4a05a649 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md @@ -8,7 +8,7 @@ ms.assetid: 5f8eddda-d751-478b-930d-e18f7191ddfb --- # Compiler Error C3919 -'event_method': function must have type 'type' +> 'event_method': function must have type 'type' An event accessor method was not declared correctly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md index 0784fc24d37..a9260c3b93b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md @@ -8,7 +8,7 @@ ms.assetid: 66e91f28-ed82-4ce2-bf22-c0c74905b1ed --- # Compiler Error C3920 -'operator'' : cannot define a postfix increment/decrement WinRT or CLR operator Calling the postfix WinRT or CLR operator will call the corresponding prefix WinRT or CLR operator (op_Increment/op_Decrement), but with postfix semantics +> 'operator'' : cannot define a postfix increment/decrement WinRT or CLR operator Calling the postfix WinRT or CLR operator will call the corresponding prefix WinRT or CLR operator (op_Increment/op_Decrement), but with postfix semantics The Windows Runtime and CLR do not support the postfix operator and user-defined postfix operators are not allowed. You can define a prefix operator and the prefix operator will be used for both pre- and post-increment operations. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3923.md b/docs/error-messages/compiler-errors-2/compiler-error-c3923.md index 8b30a7fb64b..d908385add9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3923.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3923.md @@ -8,7 +8,7 @@ ms.assetid: db8838e9-6344-4cd6-83e0-a8abeb12c4c0 --- # Compiler Error C3923 -'member' : local class, struct, or union definitions are not allowed in a member function of a WinRT or managed class +> 'member' : local class, struct, or union definitions are not allowed in a member function of a WinRT or managed class ## Example From e573870f1671c8608c49e84e818a174a23e7ecb0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 21:49:55 +0800 Subject: [PATCH 0928/1799] Add "Remarks" and "Example" headings for error references in range [C3891, C3999] --- docs/error-messages/compiler-errors-2/compiler-error-c3891.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3892.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3893.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3894.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3895.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3896.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3898.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3899.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3900.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3901.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3902.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3903.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3904.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3908.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3909.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3910.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3911.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3912.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3913.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3914.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3915.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3917.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3918.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c3919.md | 4 ++++ docs/error-messages/compiler-errors-2/compiler-error-c3920.md | 4 ++++ 25 files changed, 88 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md index 06c3f16ef08..f2bf2101ec2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md @@ -10,8 +10,12 @@ ms.assetid: 6e1a9458-97f5-4580-bc0f-aa97a1bfd20d > 'var' : a literal data member cannot be used as a l-value +## Remarks + A [literal](../../extensions/literal-cpp-component-extensions.md) variable is const, and its value cannot be changed after it is initialized in the declaration. +## Example + The following sample generates C3891: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md index bbf680821a0..d09169c0231 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md @@ -10,8 +10,12 @@ ms.assetid: 83fff42c-ea48-442f-bc2e-b33a6b99d890 > 'var' : you cannot assign to a variable that is const +## Remarks + A const variable cannot be changed after it is declared and initialized. +## Example + The following sample generates C3892: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md index f589c2620c5..0ff70c81d68 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md @@ -10,10 +10,14 @@ ms.assetid: 90d52eae-6ef2-4db1-b7ad-92f9e8b140fb > 'var' : l-value use of initonly data member is only allowed in an instance constructor of class 'type_name' +## Remarks + Static [initonly](../../dotnet/initonly-cpp-cli.md) data members can only have their address taken in a static constructor. Instance (non-static) initonly data members can only have their address taken in instance (non-static) constructors. +## Example + The following sample generates C3893: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md index e5c4e669db8..5f918dd5a50 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md @@ -10,10 +10,14 @@ ms.assetid: 6d5ac903-1dea-431d-8e3a-cebca4342983 > 'var' : l-value use of initonly static data member is only allowed in the class constructor of class 'class' +## Remarks + Static [initonly](../../dotnet/initonly-cpp-cli.md) data members can only be used as l-values at their point of declaration, or in a static constructor. Instance (non-static) initonly data members can only be used as l-values at their point of declaration, or in instance (non-static) constructors. +## Example + The following sample generates C3894: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md index 78da3a0fd72..afbdc70faea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md @@ -10,8 +10,12 @@ ms.assetid: 771b9fe5-d6d4-4297-bf57-e2f857722155 > 'var' : type data members cannot be 'volatile' +## Remarks + Certain kinds of data members, for example [literal](../../extensions/literal-cpp-component-extensions.md) or [initonly](../../dotnet/initonly-cpp-cli.md), cannot be [volatile](../../cpp/volatile-cpp.md). +## Example + The following sample generates C3895: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md index 87e978f6b86..098ad863d8b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md @@ -10,8 +10,12 @@ ms.assetid: eb8be0f6-5b4e-4d71-8285-8a2a94f8ba29 > 'member' : improper initializer: this literal data member can only be initialized with 'nullptr' +## Remarks + A [literal](../../extensions/literal-cpp-component-extensions.md) data member was initialized incorrectly. See [nullptr](../../extensions/nullptr-cpp-component-extensions.md) for more information. +## Example + The following sample generates C3896: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md index 08cebae6f24..8043d31d70a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md @@ -10,8 +10,12 @@ ms.assetid: d9a90df6-87e4-4fe7-ab01-c226ee86bf10 > 'var' : type data members can only be members of managed types +## Remarks + An [initonly](../../dotnet/initonly-cpp-cli.md) data member was declared in a native class. An **`initonly`** data member can only be declared in a CLR class. +## Example + The following sample generates C3898: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md index 556722e603c..70136af15d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md @@ -10,6 +10,8 @@ ms.assetid: 14e07e4a-f7a7-4309-baaa-649d69e12e23 > 'var' : l-value use of initonly data member is not allowed directly within a parallel region in class 'class' +## Remarks + An [initonly (C++/CLI)](../../dotnet/initonly-cpp-cli.md) data member cannot be initialized inside that part of a constructor that is in a [parallel](../../parallel/openmp/reference/openmp-directives.md#parallel) region. This is because the compiler does an internal relocation of that code, such that, it is effectively no longer part of the constructor. To resolve, initialize the initonly data member in the constructor, but outside the parallel region. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md index 38baed0f1f0..70ee5e6e4ec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md @@ -10,10 +10,14 @@ ms.assetid: a94cc561-8fa8-4344-9e01-e81ff462fae5 > 'member': not allowed in current scope +## Remarks + Property blocks can contain function declarations and inline function definitions only. No members other than functions are allowed in property blocks. No typedefs, operators, or friend functions are allowed. For more information, see [property](../../extensions/property-cpp-component-extensions.md). Event definitions can only contain access methods and functions. +## Examples + The following sample generates C3900: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md index 21652cbe7d5..49aa2ac051e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md @@ -10,8 +10,12 @@ ms.assetid: 19af4141-39ad-4c16-a68f-3ae76f648186 > 'accessor_function': must have return type 'type' +## Remarks + At least one get method's return type must match the property type. For more information, see [property](../../extensions/property-cpp-component-extensions.md). +## Example + The following sample generates C3901: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md index 0d8b1610e37..e11bea7e01a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md @@ -10,8 +10,12 @@ ms.assetid: feb3bb29-f836-4d77-ba71-3876f7f4f216 > 'accessor': type of last parameter must be 'type' +## Remarks + The type of the last parameter of at least one set method must match the type of the property. For more information, see [property](../../extensions/property-cpp-component-extensions.md). +## Example + The following sample generates C3902: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md index 8ecae6d2e57..6a2de7bb3c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md @@ -10,8 +10,12 @@ ms.assetid: cf47d7ad-a3bd-4f75-a253-71586e7a3be6 > 'property': does not have set or get method +## Remarks + A property must have at least a `get` or a `set` method. For more information, see [property](../../extensions/property-cpp-component-extensions.md). +## Example + The following sample generates C3903: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md index 2e8f0179ed7..a0921041857 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md @@ -10,6 +10,8 @@ ms.assetid: 08297605-e4f2-4c6c-b637-011f1fd40631 > 'property_accessor': must specify number parameter(s) +## Remarks + Check the number of parameters in your `get` and `set` methods against property dimensions. - The number of parameters for the `get` method must equal the number of dimensions of the property or be zero for nonindexed properties. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md index 65e956857cb..cc0ad14a732 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md @@ -10,10 +10,14 @@ ms.assetid: 3c322482-c79e-4197-a578-2ad9bc379d1a > access level less restrictive than 'construct' +## Remarks + A property accessor method (get or set) cannot have less restrictive access than the access specified on the property itself. Similarly, for event accessor methods. For more information, see [property](../../extensions/property-cpp-component-extensions.md) and [event](../../extensions/event-cpp-component-extensions.md). +## Example + The following sample generates C3908: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md index 465991ead15..951c0dae8ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md @@ -10,10 +10,14 @@ ms.assetid: 0a443132-e53f-42dc-a58b-f086da3e7bfd > aWinRT or managed event declaration must occur in a WinRT or managed type +## Remarks + A Windows Runtime event or managed event was declared in a native type. To fix this error, declare events in Windows Runtime types or managed types. For more information, see [event](../../extensions/event-cpp-component-extensions.md). +## Example + The following sample generates C3909 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md index 3ee31678d33..8fb41259e2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md @@ -10,10 +10,14 @@ ms.assetid: cfcbe620-b463-463b-95ea-2d60ad33ebb5 > 'event': must define member 'method' +## Remarks + An event was defined, but did not contain the specified, required accessor method. For more information, see [event](../../extensions/event-cpp-component-extensions.md). +## Example + The following sample generates C3910: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md index 0eacce5659c..cec4404eb68 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md @@ -10,10 +10,14 @@ ms.assetid: b786da59-0e99-479d-bc0d-551126e940f2 > 'event_accessor_method': function must have type 'signature' +## Remarks + An event's accessor method was not properly declared. For more information, see [event](../../extensions/event-cpp-component-extensions.md). +## Example + The following sample generates C3911: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md index 47fbe0bf4fe..5c975cd2a96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md @@ -10,10 +10,14 @@ ms.assetid: 674e050c-11fb-4db1-8bdf-a3e95b41161d > 'event': type of event must be a delegate type +## Remarks + An event was declared but was not of the proper type. For more information, see [event](../../extensions/event-cpp-component-extensions.md). +## Example + The following sample generates C3912: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md index 1a9040358d8..76ef7f462fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md @@ -10,10 +10,14 @@ ms.assetid: a678bfce-9524-470d-9f23-7d08ecb972c8 > default property must be indexed +## Remarks + A default property was defined incorrectly. For more information, see [property](../../extensions/property-cpp-component-extensions.md). +## Example + The following sample generates C3913: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md index 31d2dcfbd6f..610277aea3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md @@ -10,6 +10,8 @@ ms.assetid: 8f3190e6-ee50-4916-9ecc-3b8748b2e1e7 > a default property cannot be static +## Remarks + A default 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-c3915.md b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md index c7b6f304d19..53678a23cab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md @@ -10,6 +10,8 @@ ms.assetid: 2b0a5e5f-3aec-4a4b-9157-233031817084 > 'type' has no default indexed property (class indexer) +## Remarks + A type does not have a default, indexed property. For more information, see [property](../../extensions/property-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md index 617446944c3..6ff96a88376 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md @@ -10,6 +10,8 @@ ms.assetid: a24cd0c9-262f-46e5-9488-1c01f945933d > '*property*': obsolete construct declaration style +## Remarks + A property or event definition used syntax from a version before Visual Studio 2005. For more information, see [property](../../extensions/property-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md index a29ca45333b..3d97e33bb08 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md @@ -10,6 +10,8 @@ ms.assetid: a8b3a90a-3fe1-4244-a5ff-a31cdae97d98 > usage requires 'member' to be a data member +## Remarks + C3918 can occur for several reasons related to events. ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md index bae4a05a649..4e773928034 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md @@ -10,10 +10,14 @@ ms.assetid: 5f8eddda-d751-478b-930d-e18f7191ddfb > 'event_method': function must have type 'type' +## Remarks + An event accessor method was not declared correctly. For more information about events, see [event](../../extensions/event-cpp-component-extensions.md). +## Example + The following sample generates C3919: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md index a9260c3b93b..417a26beff1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md @@ -10,8 +10,12 @@ ms.assetid: 66e91f28-ed82-4ce2-bf22-c0c74905b1ed > 'operator'' : cannot define a postfix increment/decrement WinRT or CLR operator Calling the postfix WinRT or CLR operator will call the corresponding prefix WinRT or CLR operator (op_Increment/op_Decrement), but with postfix semantics +## Remarks + The Windows Runtime and CLR do not support the postfix operator and user-defined postfix operators are not allowed. You can define a prefix operator and the prefix operator will be used for both pre- and post-increment operations. +## Example + The following sample generates C3920 and shows how to fix it: ```cpp From bebde86dda77e7a06237a0668c7a43f1d1c58263 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 21:52:39 +0800 Subject: [PATCH 0929/1799] Replace term "sample" with "example" for error references in range [C3891, C3999] --- .../compiler-errors-2/compiler-error-c3891.md | 2 +- .../compiler-errors-2/compiler-error-c3892.md | 2 +- .../compiler-errors-2/compiler-error-c3893.md | 2 +- .../compiler-errors-2/compiler-error-c3894.md | 2 +- .../compiler-errors-2/compiler-error-c3895.md | 2 +- .../compiler-errors-2/compiler-error-c3896.md | 2 +- .../compiler-errors-2/compiler-error-c3898.md | 2 +- .../compiler-errors-2/compiler-error-c3899.md | 2 +- .../compiler-errors-2/compiler-error-c3900.md | 4 ++-- .../compiler-errors-2/compiler-error-c3901.md | 2 +- .../compiler-errors-2/compiler-error-c3902.md | 2 +- .../compiler-errors-2/compiler-error-c3903.md | 2 +- .../compiler-errors-2/compiler-error-c3904.md | 4 ++-- .../compiler-errors-2/compiler-error-c3908.md | 2 +- .../compiler-errors-2/compiler-error-c3909.md | 2 +- .../compiler-errors-2/compiler-error-c3910.md | 2 +- .../compiler-errors-2/compiler-error-c3911.md | 2 +- .../compiler-errors-2/compiler-error-c3912.md | 2 +- .../compiler-errors-2/compiler-error-c3913.md | 2 +- .../compiler-errors-2/compiler-error-c3914.md | 2 +- .../compiler-errors-2/compiler-error-c3915.md | 4 ++-- .../compiler-errors-2/compiler-error-c3918.md | 6 +++--- .../compiler-errors-2/compiler-error-c3919.md | 2 +- .../compiler-errors-2/compiler-error-c3920.md | 2 +- .../compiler-errors-2/compiler-error-c3923.md | 2 +- 25 files changed, 30 insertions(+), 30 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md index f2bf2101ec2..aa96e297772 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md @@ -16,7 +16,7 @@ A [literal](../../extensions/literal-cpp-component-extensions.md) variable is co ## Example -The following sample generates C3891: +The following example generates C3891: ```cpp // C3891.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md index d09169c0231..b717b26cb7b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md @@ -16,7 +16,7 @@ A const variable cannot be changed after it is declared and initialized. ## Example -The following sample generates C3892: +The following example generates C3892: ```cpp // C3892.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md index 0ff70c81d68..d3e113dcc47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md @@ -18,7 +18,7 @@ Instance (non-static) initonly data members can only have their address taken in ## Example -The following sample generates C3893: +The following example generates C3893: ```cpp // C3893.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md index 5f918dd5a50..b3297a551af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md @@ -18,7 +18,7 @@ Instance (non-static) initonly data members can only be used as l-values at thei ## Example -The following sample generates C3894: +The following example generates C3894: ```cpp // C3894.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md index afbdc70faea..11798756a5e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md @@ -16,7 +16,7 @@ Certain kinds of data members, for example [literal](../../extensions/literal-cp ## Example -The following sample generates C3895: +The following example generates C3895: ```cpp // C3895.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md index 098ad863d8b..8071e247a19 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md @@ -16,7 +16,7 @@ A [literal](../../extensions/literal-cpp-component-extensions.md) data member wa ## Example -The following sample generates C3896: +The following example generates C3896: ```cpp // C3896.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md index 8043d31d70a..503fb8863cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md @@ -16,7 +16,7 @@ An [initonly](../../dotnet/initonly-cpp-cli.md) data member was declared in a na ## Example -The following sample generates C3898: +The following example generates C3898: ```cpp // C3898.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md index 70136af15d7..f61cae358a1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md @@ -18,7 +18,7 @@ To resolve, initialize the initonly data member in the constructor, but outside ## Example -The following sample generates C3899. +The following example generates C3899. ```cpp // C3899.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md index 70ee5e6e4ec..3d2ab1cda76 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md @@ -18,7 +18,7 @@ Event definitions can only contain access methods and functions. ## Examples -The following sample generates C3900: +The following example generates C3900: ```cpp // C3900.cpp @@ -31,7 +31,7 @@ ref class X { }; ``` -The following sample generates C3900: +The following example generates C3900: ```cpp // C3900b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md index 49aa2ac051e..3ca15e1e246 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md @@ -16,7 +16,7 @@ At least one get method's return type must match the property type. For more inf ## Example -The following sample generates C3901: +The following example generates C3901: ```cpp // C3901.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md index e11bea7e01a..6572ba36b53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md @@ -16,7 +16,7 @@ The type of the last parameter of at least one set method must match the type of ## Example -The following sample generates C3902: +The following example generates C3902: ```cpp // C3902.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md index 6a2de7bb3c0..da384581345 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md @@ -16,7 +16,7 @@ A property must have at least a `get` or a `set` method. For more information, s ## Example -The following sample generates C3903: +The following example generates C3903: ```cpp // C3903.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md index a0921041857..91ee3a3ed85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md @@ -22,7 +22,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Examples -The following sample generates C3904. +The following example generates C3904. ```cpp // C3904.cpp @@ -42,7 +42,7 @@ ref class X { }; ``` -The following sample generates C3904. +The following example generates C3904. ```cpp // C3904b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md index cc0ad14a732..605a54acace 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md @@ -18,7 +18,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Example -The following sample generates C3908: +The following example generates C3908: ```cpp // C3908.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md index 951c0dae8ac..db7bdb9ee12 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md @@ -18,7 +18,7 @@ For more information, see [event](../../extensions/event-cpp-component-extension ## Example -The following sample generates C3909 and shows how to fix it: +The following example generates C3909 and shows how to fix it: ```cpp // C3909.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md index 8fb41259e2d..4c04bf97184 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md @@ -18,7 +18,7 @@ For more information, see [event](../../extensions/event-cpp-component-extension ## Example -The following sample generates C3910: +The following example generates C3910: ```cpp // C3910.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md index cec4404eb68..10b0fe2fa41 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md @@ -18,7 +18,7 @@ For more information, see [event](../../extensions/event-cpp-component-extension ## Example -The following sample generates C3911: +The following example generates C3911: ```cpp // C3911.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md index 5c975cd2a96..3645174d18e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md @@ -18,7 +18,7 @@ For more information, see [event](../../extensions/event-cpp-component-extension ## Example -The following sample generates C3912: +The following example generates C3912: ```cpp // C3912.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md index 76ef7f462fa..bcb23704892 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md @@ -18,7 +18,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Example -The following sample generates C3913: +The following example generates C3913: ```cpp // C3913.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md index 610277aea3b..485a0cd992f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md @@ -16,7 +16,7 @@ A default property was declared incorrectly. For more information, see [How to: ## Example -The following sample generates C3914 and shows how to fix it. +The following example generates C3914 and shows how to fix it. ```cpp // C3914.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md index 53678a23cab..aa07c855db0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md @@ -18,7 +18,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Examples -The following sample generates C3915. +The following example generates C3915. ```cpp // C3915.cpp @@ -43,7 +43,7 @@ int main() { C3915 can also occur if you attempt to consume a default indexer in the same compiland where it was defined with . -The following sample generates C3915. +The following example generates C3915. ```cpp // C3915_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md index 3d97e33bb08..dc1dd795ee8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md @@ -16,7 +16,7 @@ C3918 can occur for several reasons related to events. ## Examples -C3918 can occur because a class member is required in the current context. The following sample generates C3918. +C3918 can occur because a class member is required in the current context. The following example generates C3918. ```cpp // C3918.cpp @@ -38,7 +38,7 @@ public: C3918 is also caused if you try to check a trivial event for null (the event name will no longer provide direct access to the backing store delegate for the event). -The following sample generates C3918. +The following example generates C3918. ```cpp // C3918_2.cpp @@ -59,7 +59,7 @@ ref struct EventSource : public IEFace { }; ``` -C3918 can also occur if you incorrectly subscribe to an event. The following sample generates C3918. +C3918 can also occur if you incorrectly subscribe to an event. The following example generates C3918. ```cpp // C3918_3.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md index 4e773928034..86eaf670716 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md @@ -18,7 +18,7 @@ For more information about events, see [event](../../extensions/event-cpp-compon ## Example -The following sample generates C3919: +The following example generates C3919: ```cpp // C3919.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md index 417a26beff1..7b2f9dbfb74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md @@ -16,7 +16,7 @@ The Windows Runtime and CLR do not support the postfix operator and user-defined ## Example -The following sample generates C3920 and shows how to fix it: +The following example generates C3920 and shows how to fix it: ```cpp // C3920.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3923.md b/docs/error-messages/compiler-errors-2/compiler-error-c3923.md index d908385add9..4018f2a2360 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3923.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3923.md @@ -12,7 +12,7 @@ ms.assetid: db8838e9-6344-4cd6-83e0-a8abeb12c4c0 ## Example -The following sample generates C3923. +The following example generates C3923. ```cpp // C3923.cpp From 61af7f4ceb42e12d2d3857903ac74e4218d719d8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 21:56:51 +0800 Subject: [PATCH 0930/1799] Update metadata for error references in range [C3891, C3999] --- .../error-messages/compiler-errors-2/compiler-error-c3891.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3892.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3893.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3894.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3895.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3896.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3898.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3899.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3900.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3901.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3902.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3903.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3904.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3908.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3909.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3910.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3911.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3912.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3913.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3914.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3915.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3917.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3918.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3919.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3920.md | 5 ++--- .../error-messages/compiler-errors-2/compiler-error-c3923.md | 5 ++--- 26 files changed, 52 insertions(+), 78 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md index aa96e297772..e59a0a50479 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3891" title: "Compiler Error C3891" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3891" +ms.date: 11/04/2016 f1_keywords: ["C3891"] helpviewer_keywords: ["C3891"] -ms.assetid: 6e1a9458-97f5-4580-bc0f-aa97a1bfd20d --- # Compiler Error C3891 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md index b717b26cb7b..a046e7e6d0e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3892" title: "Compiler Error C3892" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3892" +ms.date: 11/04/2016 f1_keywords: ["C3892"] helpviewer_keywords: ["C3892"] -ms.assetid: 83fff42c-ea48-442f-bc2e-b33a6b99d890 --- # Compiler Error C3892 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md index d3e113dcc47..3585d8de062 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3893" title: "Compiler Error C3893" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3893" +ms.date: 11/04/2016 f1_keywords: ["C3893"] helpviewer_keywords: ["C3893"] -ms.assetid: 90d52eae-6ef2-4db1-b7ad-92f9e8b140fb --- # Compiler Error C3893 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md index b3297a551af..72eeb3433d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3894" title: "Compiler Error C3894" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3894" +ms.date: 11/04/2016 f1_keywords: ["C3894"] helpviewer_keywords: ["C3894"] -ms.assetid: 6d5ac903-1dea-431d-8e3a-cebca4342983 --- # Compiler Error C3894 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md index 11798756a5e..3b970022dbf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3895" title: "Compiler Error C3895" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3895" +ms.date: 11/04/2016 f1_keywords: ["C3895"] helpviewer_keywords: ["C3895"] -ms.assetid: 771b9fe5-d6d4-4297-bf57-e2f857722155 --- # Compiler Error C3895 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md index 8071e247a19..99836883967 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3896" title: "Compiler Error C3896" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3896" +ms.date: 11/04/2016 f1_keywords: ["C3896"] helpviewer_keywords: ["C3896"] -ms.assetid: eb8be0f6-5b4e-4d71-8285-8a2a94f8ba29 --- # Compiler Error C3896 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md index 503fb8863cf..dd2fdddb61e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3898" title: "Compiler Error C3898" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3898" +ms.date: 11/04/2016 f1_keywords: ["C3898"] helpviewer_keywords: ["C3898"] -ms.assetid: d9a90df6-87e4-4fe7-ab01-c226ee86bf10 --- # Compiler Error C3898 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md index f61cae358a1..cd8558439ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3899" title: "Compiler Error C3899" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3899" +ms.date: 11/04/2016 f1_keywords: ["C3899"] helpviewer_keywords: ["C3899"] -ms.assetid: 14e07e4a-f7a7-4309-baaa-649d69e12e23 --- # Compiler Error C3899 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md index 3d2ab1cda76..197aefade42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3900" title: "Compiler Error C3900" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3900" +ms.date: 11/04/2016 f1_keywords: ["C3900"] helpviewer_keywords: ["C3900"] -ms.assetid: a94cc561-8fa8-4344-9e01-e81ff462fae5 --- # Compiler Error C3900 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md index 3ca15e1e246..65d317906bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3901" title: "Compiler Error C3901" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3901" +ms.date: 11/04/2016 f1_keywords: ["C3901"] helpviewer_keywords: ["C3901"] -ms.assetid: 19af4141-39ad-4c16-a68f-3ae76f648186 --- # Compiler Error C3901 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md index 6572ba36b53..baf0a90f30a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3902" title: "Compiler Error C3902" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3902" +ms.date: 11/04/2016 f1_keywords: ["C3902"] helpviewer_keywords: ["C3902"] -ms.assetid: feb3bb29-f836-4d77-ba71-3876f7f4f216 --- # Compiler Error C3902 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md index da384581345..98033fe2afd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3903" title: "Compiler Error C3903" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3903" +ms.date: 11/04/2016 f1_keywords: ["C3903"] helpviewer_keywords: ["C3903"] -ms.assetid: cf47d7ad-a3bd-4f75-a253-71586e7a3be6 --- # Compiler Error C3903 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md index 91ee3a3ed85..1da734c8c62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3904" title: "Compiler Error C3904" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3904" +ms.date: 11/04/2016 f1_keywords: ["C3904"] helpviewer_keywords: ["C3904"] -ms.assetid: 08297605-e4f2-4c6c-b637-011f1fd40631 --- # Compiler Error C3904 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md index 605a54acace..5c4f692b586 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3908" title: "Compiler Error C3908" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3908" +ms.date: 11/04/2016 f1_keywords: ["C3908"] helpviewer_keywords: ["C3908"] -ms.assetid: 3c322482-c79e-4197-a578-2ad9bc379d1a --- # Compiler Error C3908 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md index db7bdb9ee12..5e4bc912e93 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3909" title: "Compiler Error C3909" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3909" +ms.date: 11/04/2016 f1_keywords: ["C3909"] helpviewer_keywords: ["C3909"] -ms.assetid: 0a443132-e53f-42dc-a58b-f086da3e7bfd --- # Compiler Error C3909 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md index 4c04bf97184..ddd865d127d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3910" title: "Compiler Error C3910" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3910" +ms.date: 11/04/2016 f1_keywords: ["C3910"] helpviewer_keywords: ["C3910"] -ms.assetid: cfcbe620-b463-463b-95ea-2d60ad33ebb5 --- # Compiler Error C3910 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md index 10b0fe2fa41..57fa57784be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3911" title: "Compiler Error C3911" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3911" +ms.date: 11/04/2016 f1_keywords: ["C3911"] helpviewer_keywords: ["C3911"] -ms.assetid: b786da59-0e99-479d-bc0d-551126e940f2 --- # Compiler Error C3911 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md index 3645174d18e..57daf670a72 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3912" title: "Compiler Error C3912" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3912" +ms.date: 11/04/2016 f1_keywords: ["C3912"] helpviewer_keywords: ["C3912"] -ms.assetid: 674e050c-11fb-4db1-8bdf-a3e95b41161d --- # Compiler Error C3912 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md index bcb23704892..b9e510d71f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3913" title: "Compiler Error C3913" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3913" +ms.date: 11/04/2016 f1_keywords: ["C3913"] helpviewer_keywords: ["C3913"] -ms.assetid: a678bfce-9524-470d-9f23-7d08ecb972c8 --- # Compiler Error C3913 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md index 485a0cd992f..e97f908f234 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3914" title: "Compiler Error C3914" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3914" +ms.date: 11/04/2016 f1_keywords: ["C3914"] helpviewer_keywords: ["C3914"] -ms.assetid: 8f3190e6-ee50-4916-9ecc-3b8748b2e1e7 --- # Compiler Error C3914 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md index aa07c855db0..afda8542b14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3915" title: "Compiler Error C3915" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3915" +ms.date: 11/04/2016 f1_keywords: ["C3915"] helpviewer_keywords: ["C3915"] -ms.assetid: 2b0a5e5f-3aec-4a4b-9157-233031817084 --- # Compiler Error C3915 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md index 6ff96a88376..edcd439252d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3917" title: "Compiler Error C3917" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3917" +ms.date: 11/04/2016 f1_keywords: ["C3917"] helpviewer_keywords: ["C3917"] -ms.assetid: a24cd0c9-262f-46e5-9488-1c01f945933d --- # Compiler Error C3917 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md index dc1dd795ee8..b85f5c2b89c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3918" title: "Compiler Error C3918" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3918" +ms.date: 11/04/2016 f1_keywords: ["C3918"] helpviewer_keywords: ["C3918"] -ms.assetid: a8b3a90a-3fe1-4244-a5ff-a31cdae97d98 --- # Compiler Error C3918 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md index 86eaf670716..c81a7c540df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3919" title: "Compiler Error C3919" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3919" +ms.date: 11/04/2016 f1_keywords: ["C3919"] helpviewer_keywords: ["C3919"] -ms.assetid: 5f8eddda-d751-478b-930d-e18f7191ddfb --- # Compiler Error C3919 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md index 7b2f9dbfb74..47b2bb58c3a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3920" title: "Compiler Error C3920" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3920" +ms.date: 11/04/2016 f1_keywords: ["C3920"] helpviewer_keywords: ["C3920"] -ms.assetid: 66e91f28-ed82-4ce2-bf22-c0c74905b1ed --- # Compiler Error C3920 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3923.md b/docs/error-messages/compiler-errors-2/compiler-error-c3923.md index 4018f2a2360..5ab80466ed9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3923.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3923.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3923" title: "Compiler Error C3923" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3923" +ms.date: 11/04/2016 f1_keywords: ["C3923"] helpviewer_keywords: ["C3923"] -ms.assetid: db8838e9-6344-4cd6-83e0-a8abeb12c4c0 --- # Compiler Error C3923 From 84b084076850e7decde2f134f50ffc651afdbee8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 21:58:08 +0800 Subject: [PATCH 0931/1799] Add leading example sentence in C3917 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c3917.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md index edcd439252d..9ecc4cdf305 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md @@ -17,6 +17,8 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Example +The following example generates C3917: + ```cpp // C3917.cpp // compile with: /clr /c From 3976b9ed0ce57ca059410509492fb8e9d6f0626e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 22:16:46 +0800 Subject: [PATCH 0932/1799] Add blockquotes and update C4541 warning message --- .../compiler-warnings/compiler-warning-level-1-c4541.md | 2 +- .../compiler-warnings/compiler-warnings-c4400-through-c4599.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md index ed2547e029a..f63a6f6f258 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md @@ -8,6 +8,6 @@ ms.assetid: b57b8f3e-117d-4fc2-bba6-faec17e5fa9d --- # Compiler Warning (level 1) C4541 -'identifier' used on polymorphic type 'type' with /GR-; unpredictable behavior may result +> '*operator*' used on polymorphic type '*type*' with /GR-; unpredictable behavior may result You tried to use a feature that requires run-time type information without enabling run-time type information. Recompile with [/GR](../../build/reference/gr-enable-run-time-type-information.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md index 03b421b60ea..6bbc48d1b0a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md @@ -139,7 +139,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1) C4537](compiler-warning-level-1-c4537.md)|'*object*': '`.`' applied to non-UDT type| |[Compiler warning (level 3) C4538](compiler-warning-level-3-c4538.md)|'*type*': `const`/`volatile` qualifiers on this type are not supported| |[Compiler warning (level 1) C4540](compiler-warning-level-1-c4540.md)|`dynamic_cast` used to convert to inaccessible or ambiguous base; run-time test will fail ('*type1*' to '*type2*')| -|[Compiler warning (level 1) C4541](compiler-warning-level-1-c4541.md)|'*identifier*' used on polymorphic type '*type*' with `/GR-`; unpredictable behavior may result| +|[Compiler warning (level 1) C4541](compiler-warning-level-1-c4541.md)|'*operator*' used on polymorphic type '*type*' with /GR-; unpredictable behavior may result| |Compiler warning (level 1) C4542|Skipping generation of merged injected text file, cannot write *filetype* file: '*issue*': *message*| |[Compiler warning (level 3) C4543](compiler-warning-level-3-c4543.md)|Injected text suppressed by attribute '`no_injected_text`'| |[Compiler warning (level 1) C4544](compiler-warning-level-1-c4544.md)|the default template argument for '*declaration*' is ignored on this template declaration| From f6f9a038ce525caf8fb91df58415a6482c46f4ed Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 22:38:45 +0800 Subject: [PATCH 0933/1799] Add "Remarks" heading and augment remarks in C4541 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4541.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md index f63a6f6f258..07fdc9a7781 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md @@ -10,4 +10,6 @@ ms.assetid: b57b8f3e-117d-4fc2-bba6-faec17e5fa9d > '*operator*' used on polymorphic type '*type*' with /GR-; unpredictable behavior may result -You tried to use a feature that requires run-time type information without enabling run-time type information. Recompile with [/GR](../../build/reference/gr-enable-run-time-type-information.md). +## Remarks + +You tried to use the [`dynamic_cast` operator](../../cpp/dynamic-cast-operator.md) or [`typeid` operator](../../cpp/typeid-operator.md), which requires [Run-Time Type Information](../../cpp/run-time-type-information.md) (RTTI), without enabling it. To enable RTTI, recompile with [`/GR`](../../build/reference/gr-enable-run-time-type-information.md). From 5f5b299a555ad8486c8852a312cfd65a4ded7499 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 22:51:53 +0800 Subject: [PATCH 0934/1799] Add example in C4541 warning reference --- .../compiler-warning-level-1-c4541.md | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md index 07fdc9a7781..0d7d7b7df52 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md @@ -13,3 +13,32 @@ ms.assetid: b57b8f3e-117d-4fc2-bba6-faec17e5fa9d ## Remarks You tried to use the [`dynamic_cast` operator](../../cpp/dynamic-cast-operator.md) or [`typeid` operator](../../cpp/typeid-operator.md), which requires [Run-Time Type Information](../../cpp/run-time-type-information.md) (RTTI), without enabling it. To enable RTTI, recompile with [`/GR`](../../build/reference/gr-enable-run-time-type-information.md). + +## Example + +The following example generates C4541: + +```cpp +// C4541.cpp +// compile with: /W1 /GR- + +#include + +struct Base +{ + virtual ~Base() {} +}; + +struct Derived : Base {}; + +int main() +{ + Derived derived; + Base* pointer_to_base = &derived; + + dynamic_cast(pointer_to_base); // C4541 + + typeid(*pointer_to_base); // C4541 + typeid(pointer_to_base); // OK +} +``` From 04070b95593b5ee376e2d7fb52fba63ca61e67c1 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 22:53:33 +0800 Subject: [PATCH 0935/1799] Update metadata in 2 warning reference topics --- .../compiler-warnings/compiler-warning-level-1-c4541.md | 5 ++--- .../compiler-warnings-c4400-through-c4599.md | 2 +- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md index 0d7d7b7df52..5b5982d38a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4541" title: "Compiler Warning (level 1) C4541" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4541" +ms.date: 08/24/2025 f1_keywords: ["C4541"] helpviewer_keywords: ["C4541"] -ms.assetid: b57b8f3e-117d-4fc2-bba6-faec17e5fa9d --- # Compiler Warning (level 1) C4541 diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md index 6bbc48d1b0a..e0ce42c2539 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ compiler (MSVC) warnings C4400 through C4599" description: "Table of Microsoft C/C++ compiler (MSVC) warnings C4400 through C4599" -ms.date: "1/22/2025" +ms.date: 1/22/2025 f1_keywords: ["C4413", "C4415", "C4416", "C4417", "C4418", "C4419", "C4421", "C4423", "C4424", "C4425", "C4426", "C4427", "C4438", "C4442", "C4443", "C4444", "C4446", "C4447", "C4448", "C4449", "C4450", "C4451", "C4452", "C4453", "C4454", "C4455", "C4466", "C4467", "C4468", "C4472", "C4474", "C4475", "C4476", "C4478", "C4480", "C4482", "C4483", "C4491", "C4492", "C4493", "C4494", "C4495", "C4496", "C4497", "C4498", "C4499", "C4509", "C4519", "C4531", "C4542", "C4562", "C4568", "C4569", "C4573", "C4574", "C4575", "C4576", "C4578", "C4582", "C4583", "C4585", "C4586", "C4587", "C4588", "C4589", "C4591", "C4592", "C4593", "C4594", "C4595", "C4598", "C4599"] helpviewer_keywords: ["C4413", "C4415", "C4416", "C4417", "C4418", "C4419", "C4421", "C4423", "C4424", "C4425", "C4426", "C4427", "C4438", "C4442", "C4443", "C4444", "C4446", "C4447", "C4448", "C4449", "C4450", "C4451", "C4452", "C4453", "C4454", "C4455", "C4466", "C4467", "C4468", "C4472", "C4474", "C4475", "C4476", "C4478", "C4480", "C4482", "C4483", "C4491", "C4492", "C4493", "C4494", "C4495", "C4496", "C4497", "C4498", "C4499", "C4509", "C4519", "C4531", "C4542", "C4562", "C4568", "C4569", "C4573", "C4574", "C4575", "C4576", "C4578", "C4582", "C4583", "C4585", "C4586", "C4587", "C4588", "C4589", "C4591", "C4592", "C4593", "C4594", "C4595", "C4598", "C4599"] --- From 6300bc07505590ec445df7eacfde25c6dbf1b959 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 23:09:26 +0800 Subject: [PATCH 0936/1799] Add blockquotes for warning messages in range [C4000, C4040] --- .../compiler-warnings/compiler-warning-level-1-c4005.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4006.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4010.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4015.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4020.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4022.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4024.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4025.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4026.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4028.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4029.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4030.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4031.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4033.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4034.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4036.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4038.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4013.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4023.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4019.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4032.md | 2 +- .../compiler-warnings/compiler-warning-levels-2-and-3-c4008.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md index 53cbf804f6d..7bf368b7e6c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md @@ -8,7 +8,7 @@ ms.assetid: 7f2dc79a-9fcb-4d5b-be61-120d9cb487ad --- # Compiler Warning (level 1) C4005 -'identifier' : macro redefinition +> 'identifier' : macro redefinition The macro identifier is defined twice. The compiler uses the second macro definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md index fead77c55d7..103cec74d74 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md @@ -8,7 +8,7 @@ ms.assetid: f1a59819-0fd2-4361-8e3a-99e4b514b8e1 --- # Compiler Warning (level 1) C4006 -\#undef expected an identifier +> #undef expected an identifier The `#undef` directive did not specify an identifier to undefine. The directive is ignored. To resolve the warning, be sure to specify an identifier. The following sample generates C4006: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md index 4f3d6f55eb1..f5636df6048 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md @@ -8,7 +8,7 @@ ms.assetid: d607a9ff-8f8f-45c0-b07b-3b2f439e5485 --- # Compiler Warning (level 1) C4010 -single-line comment contains line-continuation character +> single-line comment contains line-continuation character A single-line comment, which is introduced by //, contains a backslash (\\) that serves as a line-continuation character. The compiler considers the next line to be a continuation and treats it as a comment. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md index 5ad3ccbb8cb..4a79d9de116 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md @@ -8,6 +8,6 @@ ms.assetid: 7242ab90-c869-482f-8152-46728575837e --- # Compiler Warning (level 1) C4015 -'identifier' : type of bit field must be integral +> 'identifier' : type of bit field must be integral The bit field is not declared as an integer type. The compiler assumes the base type of the bit field to be unsigned. Bit fields must be declared as unsigned integer types. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md index a5fb74a51a3..35c80411718 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md @@ -8,7 +8,7 @@ ms.assetid: 8c4cd6be-9371-4c8c-b0ff-a5ad367bbab0 --- # Compiler Warning (level 1) C4020 -'function' : too many actual parameters +> 'function' : too many actual parameters The number of actual parameters in a function call exceeds the number of formal parameters in the function prototype or definition. The compiler passes the extra actual parameters according to the calling convention of the function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md index 051feb44a3c..6afed16f7e6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md @@ -8,6 +8,6 @@ ms.assetid: 9586ca84-4b40-4602-91a4-2e2415b1ab63 --- # Compiler Warning (level 1) C4022 -'function' : pointer mismatch for actual parameter 'number' +> 'function' : pointer mismatch for actual parameter 'number' The pointer type of the actual parameter differs from the pointer type of the corresponding formal parameter. The actual parameter is passed without change. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md index eb23ea6c5f2..ca13786678f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md @@ -8,6 +8,6 @@ ms.assetid: f6cb1b70-686a-4747-a01c-de673208209a --- # Compiler Warning (level 1) C4024 -'function' : different types for formal and actual parameter 'number' +> 'function' : different types for formal and actual parameter 'number' Corresponding formal and actual parameters have different types. The compiler passes the actual parameter without change. The receiving function converts the parameter type to the type expected. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md index 505f3d85979..a4a9f72e871 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md @@ -8,6 +8,6 @@ ms.assetid: c4f6a651-0641-4446-973e-8290065e49ad --- # Compiler Warning (level 1) C4025 -'number' : based pointer passed to function with variable arguments: parameter number +> 'number' : based pointer passed to function with variable arguments: parameter number Passing a based pointer to a function with variable arguments causes the pointer to be normalized, with unpredictable results. Do not pass based pointers to functions with variable arguments. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md index 57b763bec5b..eb838c62666 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md @@ -8,6 +8,6 @@ ms.assetid: 2c8ff616-8d7f-4784-8037-77f8b6a67698 --- # Compiler Warning (level 1) C4026 -function declared with formal parameter list +> function declared with formal parameter list The function declaration has formal parameters, but the function definition does not. Subsequent calls to this function assume that the function takes no parameters. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md index abc7bff802b..2c219394619 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md @@ -8,7 +8,7 @@ ms.assetid: c3e8b70b-e870-416c-a285-bba5f71dbfc6 --- # Compiler Warning (level 1) C4028 -formal parameter 'number' different from declaration +> formal parameter 'number' different from declaration The type of the formal parameter does not agree with the corresponding parameter in the declaration. The type in the original declaration is used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md index d34c5ff797c..6a3129b3bc2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md @@ -8,6 +8,6 @@ ms.assetid: a5c50bab-a189-44c9-aa5c-4377c7c8443a --- # Compiler Warning (level 1) C4029 -declared formal parameter list different from definition +> declared formal parameter list different from definition Formal parameter types in the function declaration do not agree with those in the function definition. The compiler uses the parameter list from the definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md index 9440c168978..076df2dfbfc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md @@ -8,6 +8,6 @@ ms.assetid: 155b290e-4777-4704-ad35-02968b1e4c5e --- # Compiler Warning (level 1) C4030 -**first formal parameter list longer than the second list** +> first formal parameter list longer than the second list A function was redeclared with different formal parameters. The compiler uses the formal parameters given in the first declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md index d7291b5939d..1eeb66ef262 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md @@ -8,6 +8,6 @@ ms.assetid: 8ac4965d-75e2-42db-9763-3f6ae707e1e1 --- # Compiler Warning (level 1) C4031 -second formal parameter list longer than the first list +> second formal parameter list longer than the first list A function is redeclared with different formal parameters. The compiler uses the formal parameters given in the first declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md index 9e90e7cd31b..027a41483d8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md @@ -8,7 +8,7 @@ ms.assetid: 189a9ec3-ff6d-49dd-b9b2-530b28bbb7c9 --- # Compiler Warning (level 1) C4033 -'function' must return a value +> 'function' must return a value The function does not return a value. An undefined value is returned. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md index fa3394aaf44..9867be46f24 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md @@ -8,6 +8,6 @@ ms.assetid: 1d2f598d-bdfc-4a95-9617-424b591ed3e8 --- # Compiler Warning (level 1) C4034 -sizeof returns 0 +> sizeof returns 0 The **`sizeof`** operator is applied to an operand of size zero (an empty structure, union, class, or enumerated type, or type **`void`**). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md index 5741b71a91a..ed59cb0f7c2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md @@ -8,7 +8,7 @@ ms.assetid: f0b15359-4d62-48ec-8cb1-a7b36587a47f --- # Compiler Warning (level 1) C4036 -unnamed 'type' as actual parameter +> unnamed 'type' as actual parameter No type name is given for a structure, union, enumeration, or class used as an actual parameter. If you are using [/Zg](../../build/reference/zg-generate-function-prototypes.md) to generate function prototypes, the compiler issues this warning and comments out the formal parameter in the generated prototype. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md index 5fefad3f82d..b1bc41aa01d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md @@ -8,6 +8,6 @@ ms.assetid: 54c7f4ed-9386-436e-b4be-bf6c338ded64 --- # Compiler Warning (level 1) C4038 -'modifier' : illegal ambient class modifier +> 'modifier' : illegal ambient class modifier This modifier cannot be used for classes with **`dllimport`** or [dllexport](../../cpp/dllexport-dllimport.md) attributes. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md index 599a4caf8d4..ed95975f76c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md @@ -8,7 +8,7 @@ ms.assetid: 9f9afc71-6e78-463d-9d66-3012d6a3cd5d --- # Compiler Warning (level 3) C4013 -'function' undefined; assuming extern returning int +> 'function' undefined; assuming extern returning int The compiler encountered a call to an undefined function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md index af8177c4fa2..98d56364381 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md @@ -8,7 +8,7 @@ ms.assetid: 615d5374-d7c1-42eb-acfd-917c053270c8 --- # Compiler Warning (level 3) C4023 -'symbol' : based pointer passed to unprototyped function : parameter number +> 'symbol' : based pointer passed to unprototyped function : parameter number Passing a based pointer to an unprototyped function causes the pointer to be normalized, with unpredictable results. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md index 60b67551c28..031a44adaaf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md @@ -8,7 +8,7 @@ ms.assetid: 4ecfe85d-673f-4334-8154-36fe7f0b3444 --- # Compiler Warning (level 4) C4019 -empty statement at global scope +> empty statement at global scope A semicolon at global scope isn't preceded by a statement. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md index cfe32c9fdea..3d1ac36b41d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md @@ -8,7 +8,7 @@ ms.assetid: 70dd0c85-0239-43f9-bb06-507f6a57d206 --- # Compiler Warning (level 4) C4032 -formal parameter 'number' has different type when promoted +> formal parameter 'number' has different type when promoted The parameter type is not compatible, through default promotions, with the type in a previous declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md index fb62ce06ead..8f89ccb6137 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md @@ -8,7 +8,7 @@ ms.assetid: fb45e535-cb68-4743-80e9-a6e34cfffeca --- # Compiler Warning (levels 2 and 3) C4008 -'identifier' : 'attribute' attribute ignored +> 'identifier' : 'attribute' attribute ignored The compiler ignored the **`__fastcall`**, **`static`**, or **`inline`** attribute for a function (level 3 warning) or data (level 2 warning). From e9d94790b0c930af690303c642e8879120aaf1e4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 23:16:40 +0800 Subject: [PATCH 0937/1799] Add "Remarks" and "Example" headings for warning references in range [C4000, C4040] --- .../compiler-warnings/compiler-warning-level-1-c4002.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4003.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4005.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4006.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4010.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4015.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4020.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4022.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4024.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4025.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4026.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4027.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4028.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4029.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4030.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4031.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4033.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4034.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4036.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4038.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4007.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4013.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4018.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4023.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4001.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4019.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4032.md | 2 ++ .../compiler-warning-levels-2-and-3-c4008.md | 2 ++ 28 files changed, 73 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md index 18d513c7877..b3961663d4f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4002"] > too many arguments for function-like macro invocation '*identifier*' +## Remarks + The number of actual parameters in the macro exceeds the number of formal parameters in the macro definition. The preprocessor collects the extra parameters but ignores them during macro expansion. C4002 can occur when incorrectly using [variadic macros](../../preprocessor/variadic-macros.md). +## Examples + The following sample generates C4002: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md index 360f59e8949..b297c1e24d2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C4003"] > not enough arguments for function-like macro invocation '*identifier*' +## Remarks + The number of formal parameters in the macro definition exceeds the number of actual parameters in the macro. Macro expansion substitutes empty text for the missing parameters. +## Example + The following sample generates C4003: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md index 7bf368b7e6c..fee124bbfa4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md @@ -10,6 +10,8 @@ ms.assetid: 7f2dc79a-9fcb-4d5b-be61-120d9cb487ad > 'identifier' : macro redefinition +## Remarks + The macro identifier is defined twice. The compiler uses the second macro definition. ### To fix by checking the following possible causes @@ -24,6 +26,8 @@ The macro identifier is defined twice. The compiler uses the second macro defini 1. Use an [#undef](../../preprocessor/hash-undef-directive-c-cpp.md) directive before the second definition. +## Example + The following sample generates C4005: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md index 103cec74d74..451f3510159 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md @@ -10,7 +10,13 @@ ms.assetid: f1a59819-0fd2-4361-8e3a-99e4b514b8e1 > #undef expected an identifier -The `#undef` directive did not specify an identifier to undefine. The directive is ignored. To resolve the warning, be sure to specify an identifier. The following sample generates C4006: +## Remarks + +The `#undef` directive did not specify an identifier to undefine. The directive is ignored. To resolve the warning, be sure to specify an identifier. + +## Example + +The following sample generates C4006: ```cpp // C4006.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md index f5636df6048..bd55b1af0bb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md @@ -10,10 +10,14 @@ ms.assetid: d607a9ff-8f8f-45c0-b07b-3b2f439e5485 > single-line comment contains line-continuation character +## Remarks + A single-line comment, which is introduced by //, contains a backslash (\\) that serves as a line-continuation character. The compiler considers the next line to be a continuation and treats it as a comment. Some syntax-directed editors do not indicate the line following the continuation character as a comment. Ignore syntax coloring on any lines that cause this warning. +## Example + The following sample generates C4010: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md index 4a79d9de116..a0c9c858175 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md @@ -10,4 +10,6 @@ ms.assetid: 7242ab90-c869-482f-8152-46728575837e > 'identifier' : type of bit field must be integral +## Remarks + The bit field is not declared as an integer type. The compiler assumes the base type of the bit field to be unsigned. Bit fields must be declared as unsigned integer types. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md index 35c80411718..41c7063034d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md @@ -10,8 +10,12 @@ ms.assetid: 8c4cd6be-9371-4c8c-b0ff-a5ad367bbab0 > 'function' : too many actual parameters +## Remarks + The number of actual parameters in a function call exceeds the number of formal parameters in the function prototype or definition. The compiler passes the extra actual parameters according to the calling convention of the function. +## Example + The following sample generates C4020: ```c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md index 6afed16f7e6..0d780528bf7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md @@ -10,4 +10,6 @@ ms.assetid: 9586ca84-4b40-4602-91a4-2e2415b1ab63 > 'function' : pointer mismatch for actual parameter 'number' +## Remarks + The pointer type of the actual parameter differs from the pointer type of the corresponding formal parameter. The actual parameter is passed without change. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md index ca13786678f..4e1ee50e368 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md @@ -10,4 +10,6 @@ ms.assetid: f6cb1b70-686a-4747-a01c-de673208209a > 'function' : different types for formal and actual parameter 'number' +## Remarks + Corresponding formal and actual parameters have different types. The compiler passes the actual parameter without change. The receiving function converts the parameter type to the type expected. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md index a4a9f72e871..ca80e3b57bf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md @@ -10,4 +10,6 @@ ms.assetid: c4f6a651-0641-4446-973e-8290065e49ad > 'number' : based pointer passed to function with variable arguments: parameter number +## Remarks + Passing a based pointer to a function with variable arguments causes the pointer to be normalized, with unpredictable results. Do not pass based pointers to functions with variable arguments. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md index eb838c62666..a76d7abacf2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md @@ -10,4 +10,6 @@ ms.assetid: 2c8ff616-8d7f-4784-8037-77f8b6a67698 > function declared with formal parameter list +## Remarks + The function declaration has formal parameters, but the function definition does not. Subsequent calls to this function assume that the function takes no parameters. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md index c3a3de1492d..7800ebafbba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4027"] > function declared without formal parameter list +## Remarks + The function declaration had no formal parameters, but there are formal parameters in the function definition or actual parameters in a call. The compiler accepts, but warns, on an old C-style forward declaration of a function name without a parameter list. On later calls to this function, the compiler assumes that the function takes actual parameters of the types found in the function definition or call. We recommend you modify your function declaration diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md index 2c219394619..27a4dacee5f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md @@ -10,6 +10,8 @@ ms.assetid: c3e8b70b-e870-416c-a285-bba5f71dbfc6 > formal parameter 'number' different from declaration +## Remarks + The type of the formal parameter does not agree with the corresponding parameter in the declaration. The type in the original declaration is used. This warning is only valid for C source code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md index 6a3129b3bc2..bf13ffb9b4a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md @@ -10,4 +10,6 @@ ms.assetid: a5c50bab-a189-44c9-aa5c-4377c7c8443a > declared formal parameter list different from definition +## Remarks + Formal parameter types in the function declaration do not agree with those in the function definition. The compiler uses the parameter list from the definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md index 076df2dfbfc..9065e8c442f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md @@ -10,4 +10,6 @@ ms.assetid: 155b290e-4777-4704-ad35-02968b1e4c5e > first formal parameter list longer than the second list +## Remarks + A function was redeclared with different formal parameters. The compiler uses the formal parameters given in the first declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md index 1eeb66ef262..c0d2b536e12 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md @@ -10,4 +10,6 @@ ms.assetid: 8ac4965d-75e2-42db-9763-3f6ae707e1e1 > second formal parameter list longer than the first list +## Remarks + A function is redeclared with different formal parameters. The compiler uses the formal parameters given in the first declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md index 027a41483d8..0b6f89a97f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md @@ -10,12 +10,16 @@ ms.assetid: 189a9ec3-ff6d-49dd-b9b2-530b28bbb7c9 > 'function' must return a value +## Remarks + The function does not return a value. An undefined value is returned. Functions that use **`return`** without a return value must be declared as type **`void`**. This error is for C language code. +## Example + The following sample generates C4033: ```c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md index 9867be46f24..2d4c62cab43 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md @@ -10,4 +10,6 @@ ms.assetid: 1d2f598d-bdfc-4a95-9617-424b591ed3e8 > sizeof returns 0 +## Remarks + The **`sizeof`** operator is applied to an operand of size zero (an empty structure, union, class, or enumerated type, or type **`void`**). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md index ed59cb0f7c2..6319fcd0765 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md @@ -10,6 +10,8 @@ ms.assetid: f0b15359-4d62-48ec-8cb1-a7b36587a47f > unnamed 'type' as actual parameter +## Remarks + No type name is given for a structure, union, enumeration, or class used as an actual parameter. If you are using [/Zg](../../build/reference/zg-generate-function-prototypes.md) to generate function prototypes, the compiler issues this warning and comments out the formal parameter in the generated prototype. Specify a type name to resolve this warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md index b1bc41aa01d..740370bc2bc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md @@ -10,4 +10,6 @@ ms.assetid: 54c7f4ed-9386-436e-b4be-bf6c338ded64 > 'modifier' : illegal ambient class modifier +## Remarks + This modifier cannot be used for classes with **`dllimport`** or [dllexport](../../cpp/dllexport-dllimport.md) attributes. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md index 336918d5ce0..6050ea6e3ea 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C4007"] > '*function*': must be '*attribute*' +## Remarks + A required attribute for a function isn't explicitly stated. For example, the function `main` must have the `__cdecl` attribute. The compiler forces the attribute. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md index ed95975f76c..8e59b058eb8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md @@ -10,6 +10,8 @@ ms.assetid: 9f9afc71-6e78-463d-9d66-3012d6a3cd5d > 'function' undefined; assuming extern returning int +## Remarks + The compiler encountered a call to an undefined function. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md index 9dd5d2ec50a..8920c028739 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4018"] > '*token*' : signed/unsigned mismatch -Using the *token* operator to compare **`signed`** and **`unsigned`** numbers required the compiler to convert the **`signed`** value to **`unsigned`**. - ## Remarks +Using the *token* operator to compare **`signed`** and **`unsigned`** numbers required the compiler to convert the **`signed`** value to **`unsigned`**. + One way to fix this warning is if you cast one of the two types when you compare **`signed`** and **`unsigned`** types. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md index 98d56364381..b7b214cd673 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md @@ -10,6 +10,8 @@ ms.assetid: 615d5374-d7c1-42eb-acfd-917c053270c8 > 'symbol' : based pointer passed to unprototyped function : parameter number +## Remarks + Passing a based pointer to an unprototyped function causes the pointer to be normalized, with unpredictable results. This warning may be fixed if you use prototype functions that are passed based pointers. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md index 73499a45793..a0befc62655 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4001"] > nonstandard extension 'single line comment' was used +## Remarks + > [!NOTE] > This warning is removed in Visual Studio 2017 version 15.5 because single-line comments are standard in C99. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md index 031a44adaaf..4ae064031cf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md @@ -10,6 +10,8 @@ ms.assetid: 4ecfe85d-673f-4334-8154-36fe7f0b3444 > empty statement at global scope +## Remarks + A semicolon at global scope isn't preceded by a statement. This warning may be fixed if you remove the extra semicolon. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md index 3d1ac36b41d..399fa1131f3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md @@ -10,6 +10,8 @@ ms.assetid: 70dd0c85-0239-43f9-bb06-507f6a57d206 > formal parameter 'number' has different type when promoted +## Remarks + The parameter type is not compatible, through default promotions, with the type in a previous declaration. This is an error in ANSI C ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) and a warning under Microsoft extensions (/Ze). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md index 8f89ccb6137..9544329f18d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md @@ -10,6 +10,8 @@ ms.assetid: fb45e535-cb68-4743-80e9-a6e34cfffeca > 'identifier' : 'attribute' attribute ignored +## Remarks + The compiler ignored the **`__fastcall`**, **`static`**, or **`inline`** attribute for a function (level 3 warning) or data (level 2 warning). ### To fix by checking the following possible causes From 1b700502766cc9458185f6b1dff91d4d80a7c14f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 23:17:51 +0800 Subject: [PATCH 0938/1799] Replace term "sample" with "example" for warning references in range [C4000, C4040] --- .../compiler-warnings/compiler-warning-level-1-c4002.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4003.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4005.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4006.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4010.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4020.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4028.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4033.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4036.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4018.md | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md index b3961663d4f..62284bf3e6c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md @@ -17,7 +17,7 @@ C4002 can occur when incorrectly using [variadic macros](../../preprocessor/vari ## Examples -The following sample generates C4002: +The following example generates C4002: ```cpp // C4002.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md index b297c1e24d2..a5427f48ba2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md @@ -15,7 +15,7 @@ The number of formal parameters in the macro definition exceeds the number of ac ## Example -The following sample generates C4003: +The following example generates C4003: ```cpp // C4003.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md index fee124bbfa4..9e205787e3d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md @@ -28,7 +28,7 @@ The macro identifier is defined twice. The compiler uses the second macro defini ## Example -The following sample generates C4005: +The following example generates C4005: ```cpp // C4005.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md index 451f3510159..59df8f7fff2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md @@ -16,7 +16,7 @@ The `#undef` directive did not specify an identifier to undefine. The directive ## Example -The following sample generates C4006: +The following example generates C4006: ```cpp // C4006.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md index bd55b1af0bb..d45865d9778 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md @@ -18,7 +18,7 @@ Some syntax-directed editors do not indicate the line following the continuation ## Example -The following sample generates C4010: +The following example generates C4010: ```cpp // C4010.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md index 41c7063034d..5341ede6bc8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md @@ -16,7 +16,7 @@ The number of actual parameters in a function call exceeds the number of formal ## Example -The following sample generates C4020: +The following example generates C4020: ```c // C4020.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md index 27a4dacee5f..b5bba11ae05 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md @@ -18,7 +18,7 @@ This warning is only valid for C source code. ## Example -The following sample generates C4028. +The following example generates C4028. ```c // C4028.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md index 0b6f89a97f2..4afea1bd20d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md @@ -20,7 +20,7 @@ This error is for C language code. ## Example -The following sample generates C4033: +The following example generates C4033: ```c // C4033.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md index 6319fcd0765..8e61a8ca43e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md @@ -18,7 +18,7 @@ Specify a type name to resolve this warning. ## Example -The following sample generates C4036. +The following example generates C4036. ```c // C4036.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md index 8920c028739..83dab0c48c0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md @@ -17,7 +17,7 @@ One way to fix this warning is if you cast one of the two types when you compare ## Example -This sample generates C4018 and shows how to fix it: +This example generates C4018 and shows how to fix it: ```cpp // C4018.cpp From 48b44aeb21febad994c9351f00210633670d7f14 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 23:22:31 +0800 Subject: [PATCH 0939/1799] Update metadata for warning references in range [C4000, C4040] --- .../compiler-warnings/compiler-warning-level-1-c4002.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4003.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4005.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4006.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4010.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4015.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4020.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4022.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4024.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4025.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4026.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4027.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4028.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4029.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4030.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4031.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4033.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4034.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4036.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4038.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4007.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4013.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4023.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4001.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4019.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4032.md | 5 ++--- .../compiler-warning-levels-2-and-3-c4008.md | 5 ++--- 27 files changed, 53 insertions(+), 75 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md index 62284bf3e6c..be577e0b73b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4002" title: "Compiler Warning (level 1, Error) C4002" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4002" +ms.date: 11/04/2016 f1_keywords: ["C4002"] helpviewer_keywords: ["C4002"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md index a5427f48ba2..45a2adcf25c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4003" title: "Compiler Warning (level 1, Error) C4003" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4003" +ms.date: 11/04/2016 f1_keywords: ["C4003"] helpviewer_keywords: ["C4003"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md index 9e205787e3d..69a14d6e511 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4005" title: "Compiler Warning (level 1) C4005" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4005" +ms.date: 11/04/2016 f1_keywords: ["C4005"] helpviewer_keywords: ["C4005"] -ms.assetid: 7f2dc79a-9fcb-4d5b-be61-120d9cb487ad --- # Compiler Warning (level 1) C4005 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md index 59df8f7fff2..c39751f601c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4006" title: "Compiler Warning (level 1) C4006" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4006" +ms.date: 11/04/2016 f1_keywords: ["C4006"] helpviewer_keywords: ["C4006"] -ms.assetid: f1a59819-0fd2-4361-8e3a-99e4b514b8e1 --- # Compiler Warning (level 1) C4006 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md index d45865d9778..ae54258c558 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4010" title: "Compiler Warning (level 1) C4010" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4010" +ms.date: 11/04/2016 f1_keywords: ["C4010"] helpviewer_keywords: ["C4010"] -ms.assetid: d607a9ff-8f8f-45c0-b07b-3b2f439e5485 --- # Compiler Warning (level 1) C4010 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md index a0c9c858175..17fcd129fdb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4015" title: "Compiler Warning (level 1) C4015" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4015" +ms.date: 11/04/2016 f1_keywords: ["C4015"] helpviewer_keywords: ["C4015"] -ms.assetid: 7242ab90-c869-482f-8152-46728575837e --- # Compiler Warning (level 1) C4015 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md index 5341ede6bc8..587b65dc88e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4020" title: "Compiler Warning (level 1) C4020" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4020" +ms.date: 11/04/2016 f1_keywords: ["C4020"] helpviewer_keywords: ["C4020"] -ms.assetid: 8c4cd6be-9371-4c8c-b0ff-a5ad367bbab0 --- # Compiler Warning (level 1) C4020 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md index 0d780528bf7..ee13a0d21af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4022" title: "Compiler Warning (level 1) C4022" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4022" +ms.date: 11/04/2016 f1_keywords: ["C4022"] helpviewer_keywords: ["C4022"] -ms.assetid: 9586ca84-4b40-4602-91a4-2e2415b1ab63 --- # Compiler Warning (level 1) C4022 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md index 4e1ee50e368..f4fb400f3cf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4024" title: "Compiler Warning (level 1) C4024" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4024" +ms.date: 11/04/2016 f1_keywords: ["C4024"] helpviewer_keywords: ["C4024"] -ms.assetid: f6cb1b70-686a-4747-a01c-de673208209a --- # Compiler Warning (level 1) C4024 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md index ca80e3b57bf..d9c89fd4608 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4025" title: "Compiler Warning (level 1) C4025" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4025" +ms.date: 11/04/2016 f1_keywords: ["C4025"] helpviewer_keywords: ["C4025"] -ms.assetid: c4f6a651-0641-4446-973e-8290065e49ad --- # Compiler Warning (level 1) C4025 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md index a76d7abacf2..4aa8c4d8323 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4026" title: "Compiler Warning (level 1) C4026" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4026" +ms.date: 11/04/2016 f1_keywords: ["C4026"] helpviewer_keywords: ["C4026"] -ms.assetid: 2c8ff616-8d7f-4784-8037-77f8b6a67698 --- # Compiler Warning (level 1) C4026 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md index 7800ebafbba..cf626d581a8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md @@ -1,6 +1,6 @@ --- -description: "Learn more about compiler warning (level 1) C4027" title: "Compiler Warning (level 1) C4027" +description: "Learn more about compiler warning (level 1) C4027" ms.date: 12/16/2020 f1_keywords: ["C4027"] helpviewer_keywords: ["C4027"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md index b5bba11ae05..8b090d3b4ba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4028" title: "Compiler Warning (level 1) C4028" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4028" +ms.date: 11/04/2016 f1_keywords: ["C4028"] helpviewer_keywords: ["C4028"] -ms.assetid: c3e8b70b-e870-416c-a285-bba5f71dbfc6 --- # Compiler Warning (level 1) C4028 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md index bf13ffb9b4a..fc2983d339e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4029" title: "Compiler Warning (level 1) C4029" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4029" +ms.date: 11/04/2016 f1_keywords: ["C4029"] helpviewer_keywords: ["C4029"] -ms.assetid: a5c50bab-a189-44c9-aa5c-4377c7c8443a --- # Compiler Warning (level 1) C4029 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md index 9065e8c442f..c36e7b4667b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4030" title: "Compiler Warning (level 1) C4030" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4030" +ms.date: 11/04/2016 f1_keywords: ["C4030"] helpviewer_keywords: ["C4030"] -ms.assetid: 155b290e-4777-4704-ad35-02968b1e4c5e --- # Compiler Warning (level 1) C4030 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md index c0d2b536e12..f87f4f40fd2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4031" title: "Compiler Warning (level 1) C4031" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4031" +ms.date: 11/04/2016 f1_keywords: ["C4031"] helpviewer_keywords: ["C4031"] -ms.assetid: 8ac4965d-75e2-42db-9763-3f6ae707e1e1 --- # Compiler Warning (level 1) C4031 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md index 4afea1bd20d..0243da64091 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4033" title: "Compiler Warning (level 1) C4033" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4033" +ms.date: 11/04/2016 f1_keywords: ["C4033"] helpviewer_keywords: ["C4033"] -ms.assetid: 189a9ec3-ff6d-49dd-b9b2-530b28bbb7c9 --- # Compiler Warning (level 1) C4033 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md index 2d4c62cab43..b1f4596f19e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4034" title: "Compiler Warning (level 1) C4034" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4034" +ms.date: 11/04/2016 f1_keywords: ["C4034"] helpviewer_keywords: ["C4034"] -ms.assetid: 1d2f598d-bdfc-4a95-9617-424b591ed3e8 --- # Compiler Warning (level 1) C4034 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md index 8e61a8ca43e..aa7a3ae06af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4036" title: "Compiler Warning (level 1) C4036" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4036" +ms.date: 11/04/2016 f1_keywords: ["C4036"] helpviewer_keywords: ["C4036"] -ms.assetid: f0b15359-4d62-48ec-8cb1-a7b36587a47f --- # Compiler Warning (level 1) C4036 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md index 740370bc2bc..1ae8f389eee 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4038" title: "Compiler Warning (level 1) C4038" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4038" +ms.date: 11/04/2016 f1_keywords: ["C4038"] helpviewer_keywords: ["C4038"] -ms.assetid: 54c7f4ed-9386-436e-b4be-bf6c338ded64 --- # Compiler Warning (level 1) C4038 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md index 6050ea6e3ea..b9e5c6c8da4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4007" title: "Compiler Warning (level 3) C4007" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4007" +ms.date: 11/04/2016 f1_keywords: ["C4007"] helpviewer_keywords: ["C4007"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md index 8e59b058eb8..d31e60b7584 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4013" title: "Compiler Warning (level 3) C4013" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4013" +ms.date: 11/04/2016 f1_keywords: ["C4013"] helpviewer_keywords: ["C4013"] -ms.assetid: 9f9afc71-6e78-463d-9d66-3012d6a3cd5d --- # Compiler Warning (level 3) C4013 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md index b7b214cd673..f11f88a5ed2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4023" title: "Compiler Warning (level 3) C4023" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4023" +ms.date: 11/04/2016 f1_keywords: ["C4023"] helpviewer_keywords: ["C4023"] -ms.assetid: 615d5374-d7c1-42eb-acfd-917c053270c8 --- # Compiler Warning (level 3) C4023 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md index a0befc62655..f5c0cdd330b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, no longer emitted) C4001" title: "Compiler Warning (level 4, no longer emitted) C4001" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, no longer emitted) C4001" +ms.date: 11/04/2016 f1_keywords: ["C4001"] helpviewer_keywords: ["C4001"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md index 4ae064031cf..32cd66274e5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4019" title: "Compiler Warning (level 4) C4019" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4019" +ms.date: 11/04/2016 f1_keywords: ["C4019"] helpviewer_keywords: ["C4019"] -ms.assetid: 4ecfe85d-673f-4334-8154-36fe7f0b3444 --- # Compiler Warning (level 4) C4019 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md index 399fa1131f3..b5e045ee4f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4032" title: "Compiler Warning (level 4) C4032" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4032" +ms.date: 11/04/2016 f1_keywords: ["C4032"] helpviewer_keywords: ["C4032"] -ms.assetid: 70dd0c85-0239-43f9-bb06-507f6a57d206 --- # Compiler Warning (level 4) C4032 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md index 9544329f18d..0b0adbc8898 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (levels 2 and 3) C4008" title: "Compiler Warning (levels 2 and 3) C4008" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (levels 2 and 3) C4008" +ms.date: 11/04/2016 f1_keywords: ["C4008"] helpviewer_keywords: ["C4008"] -ms.assetid: fb45e535-cb68-4743-80e9-a6e34cfffeca --- # Compiler Warning (levels 2 and 3) C4008 From c82dc943253970d2adc9e295365e28659360461c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Sun, 24 Aug 2025 23:25:06 +0800 Subject: [PATCH 0940/1799] Add leading example sentence in C4019 warning reference --- .../compiler-warnings/compiler-warning-level-4-c4019.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md index 32cd66274e5..cdb8721b010 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md @@ -20,6 +20,8 @@ This warning may be fixed if you remove the extra semicolon. ## Example +The following example generates C4019: + ```c // C4019.c // compile with: /Za /W4 From 7f67950d3c61a559ccb4b841846825c0454c33dc Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 25 Aug 2025 22:46:38 +0800 Subject: [PATCH 0941/1799] Add blockquotes for warning messages in range [C4041, C4080] --- .../compiler-warnings/compiler-warning-level-1-c4041.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4042.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4045.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4047.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4048.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4049.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4068.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4074.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4075.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4077.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4079.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4080.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4051.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4056.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4066.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4073.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4053.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4057.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md index 1dc226cd33f..baa6a3dcdbe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md @@ -8,7 +8,7 @@ ms.assetid: 107ee9fd-4b88-4f22-a18f-a20726831095 --- # Compiler Warning (level 1) C4041 -compiler limit : terminating browser output +> compiler limit : terminating browser output Browser information exceeded the compiler limit. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md index 4ec209f86f8..37a8b702476 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md @@ -8,7 +8,7 @@ ms.assetid: e4bd861b-1194-426b-bf79-68c5b021eb0a --- # Compiler Warning (level 1) C4042 -'identifier' : has bad storage class +> 'identifier' : has bad storage class The specified storage class cannot be used with this identifier in this context. The compiler uses the default storage class instead: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md index 92468659928..bea1da1292e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md @@ -8,7 +8,7 @@ ms.assetid: 3c6f7373-da91-45cd-b224-f49f7d8b4df0 --- # Compiler Warning (level 1) C4045 -'array' : array bounds overflow +> 'array' : array bounds overflow The array has too many initializers. Extra initializers are ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md index 229da7ccbde..3e3ff94a06e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md @@ -8,7 +8,7 @@ ms.assetid: b75ad6fb-5c93-4434-a85f-c4083051a5de --- # Compiler Warning (level 1) C4047 -'operator' : 'identifier1' differs in levels of indirection from 'identifier2' +> 'operator' : 'identifier1' differs in levels of indirection from 'identifier2' A pointer can point to a variable (one level of indirection), to another pointer that points to a variable (two levels of indirection), and so on. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md index a3786cb575b..9a855f54e9a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md @@ -8,7 +8,7 @@ ms.assetid: 8429f513-4732-40f1-8e56-4c224e723bcb --- # Compiler Warning (level 1) C4048 -different declared array subscripts : 'identifier1' and 'identifier2' +> different declared array subscripts : 'identifier1' and 'identifier2' An expression involves pointers to arrays of different size. The pointers are used without conversion. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md index d13fb15e544..32af4838737 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md @@ -8,7 +8,7 @@ ms.assetid: d11c1870-bcfc-4d71-8945-b87ec6ec3514 --- # Compiler Warning (level 1) C4049 -compiler limit : terminating line number emission +> compiler limit : terminating line number emission The file contains more than 16,777,215 (224-1) source lines. The compiler stops numbering at 16,777,215. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md index f6f9cadd5f9..64a4747c007 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md @@ -8,7 +8,7 @@ ms.assetid: 96a7397a-4eab-44ab-b3bb-36747503f7e5 --- # Compiler Warning (level 1) C4068 -unknown pragma +> unknown pragma The compiler ignored an unrecognized [pragma](../../preprocessor/pragma-directives-and-the-pragma-keyword.md). Be sure the **pragma** is allowed by the compiler you are using. The following sample generates C4068: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md index 8d4fbe8f3a6..36504dee456 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md @@ -8,7 +8,7 @@ ms.assetid: cd510e66-c338-4a86-a4d7-bfa1df9b16c3 --- # Compiler Warning (level 1) C4074 -initializers put in compiler reserved initialization area +> initializers put in compiler reserved initialization area The compiler initialization area, which is specified by [#pragma init_seg](../../preprocessor/init-seg.md), is reserved by Microsoft. Code in this area may be executed before initialization of the C run-time library. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md index 4fe1b0c563a..37373a95762 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md @@ -8,7 +8,7 @@ ms.assetid: 19a700b6-f210-4b9d-a2f2-76cfe39ab178 --- # Compiler Warning (level 1) C4075 -initializers put in unrecognized initialization area +> initializers put in unrecognized initialization area A [#pragma init_seg](../../preprocessor/init-seg.md) uses an unrecognized section name. The compiler ignores the **pragma** command. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md index c6c140c75ae..a88f5393e66 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md @@ -8,7 +8,7 @@ ms.assetid: c2d28805-b33f-41ad-afba-33b3f788c649 --- # Compiler Warning (level 1) C4077 -unknown check_stack option +> unknown check_stack option The old form of the **check_stack** pragma is used with an unknown argument. The argument must be `+`, `-`, `(on)`, `(off)`, or empty. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md index aa3914ce05d..0d2c3b6c5eb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md @@ -8,7 +8,7 @@ ms.assetid: 549759f0-e168-47e9-8c9a-de93ac843689 --- # Compiler Warning (level 1) C4079 -unexpected token 'token' +> unexpected token 'token' An unexpected separator token occurs in a pragma argument list. The remainder of the pragma was ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md index 4c78d21774f..abb80b20d96 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md @@ -8,7 +8,7 @@ ms.assetid: 964fb3f4-b9fd-450b-aa23-35cece126172 --- # Compiler Warning (level 1) C4080 -expected identifier for segment name; found 'symbol' +> expected identifier for segment name; found 'symbol' The name of the segment in [#pragma alloc_text](../../preprocessor/alloc-text.md) must be a string or an identifier. The compiler ignores the pragma if a valid identifier is not found. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md index d512d8c5c57..4d3fe502e14 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md @@ -8,7 +8,7 @@ ms.assetid: 8c964e70-df12-45ff-93b9-496ad4271191 --- # Compiler Warning (level 2) C4051 -type conversion; possible loss of data +> type conversion; possible loss of data An expression contains two data items with different base types. Converting one type causes the data item to be truncated. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md index e619ad2ebb1..205da54329b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md @@ -8,7 +8,7 @@ ms.assetid: a3c3a9b8-ec30-452d-96cb-3694adcce789 --- # Compiler Warning (level 2) C4056 -overflow in floating point constant arithmetic +> overflow in floating point constant arithmetic Floating-point constant arithmetic generates a result that exceeds the maximum allowable value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md index 11ddd3399f2..18d193caebe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4066"] --- # Compiler Warning (level 3) C4066 -characters beyond first in wide-character constant ignored +> characters beyond first in wide-character constant ignored The compiler processes only the first character of a wide-character constant. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md index 18ebb50854c..29f4ff3ae7b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md @@ -8,7 +8,7 @@ ms.assetid: 50081a6e-6acd-45ff-8484-9b1ea926cc5c --- # Compiler Warning (level 3) C4073 -initializers put in library initialization area +> initializers put in library initialization area Only third-party library developers should use the library initialization area, which is specified by [#pragma init_seg](../../preprocessor/init-seg.md). The following sample generates C4073: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md index dec8704399d..3faf74f0a8b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md @@ -8,6 +8,6 @@ ms.assetid: e3b8c46e-e36d-412c-99b9-3db860b6e307 --- # Compiler Warning (level 4) C4053 -one void operand for '?:' +> one void operand for '?:' The `?:` operator is given an expression of type **`void`**. The value of the **`void`** operand is undefined. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md index d335a6fab05..bf4e73eba01 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md @@ -8,7 +8,7 @@ ms.assetid: e75d0645-84c9-4bef-a812-942ed9879aa3 --- # Compiler Warning (level 4) C4057 -'operator' : 'identifier1' indirection to slightly different base types from 'identifier2' +> 'operator' : 'identifier1' indirection to slightly different base types from 'identifier2' Two pointer expressions refer to different base types. The expressions are used without conversion. From 9710b3ffca20e4c05eca164c9e54096edb23687a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 25 Aug 2025 22:53:45 +0800 Subject: [PATCH 0942/1799] Add "Remarks" and "Example" headings for warning references in range [C4041, C4080] --- .../compiler-warnings/compiler-warning-level-1-c4041.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4042.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4045.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4047.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4048.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4049.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4052.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4068.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4074.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4075.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4077.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4079.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4080.md | 4 ++++ .../compiler-warnings/compiler-warning-level-2-c4051.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4056.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4066.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4073.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-4-c4053.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4057.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4061.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4062.md | 2 ++ 21 files changed, 68 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md index baa6a3dcdbe..cc3497f46fd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md @@ -10,6 +10,8 @@ ms.assetid: 107ee9fd-4b88-4f22-a18f-a20726831095 > compiler limit : terminating browser output +## Remarks + Browser information exceeded the compiler limit. This warning can be caused by compiling with [/FR](../../build/reference/fr-fr-create-dot-sbr-file.md) (browser information including local variables). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md index 37a8b702476..fe0c81806dd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md @@ -10,6 +10,8 @@ ms.assetid: e4bd861b-1194-426b-bf79-68c5b021eb0a > 'identifier' : has bad storage class +## Remarks + The specified storage class cannot be used with this identifier in this context. The compiler uses the default storage class instead: - **`extern`**, if *identifier* is a function. @@ -20,6 +22,8 @@ The specified storage class cannot be used with this identifier in this context. This warning can be caused by specifying a storage class other than **`register`** in a parameter declaration. +## Example + The following sample generates C4042 ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md index bea1da1292e..51538b4de45 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md @@ -10,6 +10,8 @@ ms.assetid: 3c6f7373-da91-45cd-b224-f49f7d8b4df0 > 'array' : array bounds overflow +## Remarks + The array has too many initializers. Extra initializers are ignored. Make sure that array elements and initializers match in size and quantity. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md index 3e3ff94a06e..81673c12421 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md @@ -10,6 +10,8 @@ ms.assetid: b75ad6fb-5c93-4434-a85f-c4083051a5de > 'operator' : 'identifier1' differs in levels of indirection from 'identifier2' +## Remarks + A pointer can point to a variable (one level of indirection), to another pointer that points to a variable (two levels of indirection), and so on. ## Examples diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md index 9a855f54e9a..ec2c0eb53fc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md @@ -10,6 +10,8 @@ ms.assetid: 8429f513-4732-40f1-8e56-4c224e723bcb > different declared array subscripts : 'identifier1' and 'identifier2' +## Remarks + An expression involves pointers to arrays of different size. The pointers are used without conversion. This warning may be fixed if you explicitly cast the arrays to the same or equivalent type. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md index 32af4838737..37c946ac959 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md @@ -10,6 +10,8 @@ ms.assetid: d11c1870-bcfc-4d71-8945-b87ec6ec3514 > compiler limit : terminating line number emission +## Remarks + The file contains more than 16,777,215 (224-1) source lines. The compiler stops numbering at 16,777,215. For code after line 16,777,215: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md index aaf4746a460..9cc1cbc5de8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C4052"] > function declarations different; one contains variable arguments +## Remarks + One declaration of the function doesn't contain variable arguments. The empty declaration is ignored. +## Example + The following sample generates C4052: ```c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md index 64a4747c007..b26863122b6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md @@ -10,7 +10,13 @@ ms.assetid: 96a7397a-4eab-44ab-b3bb-36747503f7e5 > unknown pragma -The compiler ignored an unrecognized [pragma](../../preprocessor/pragma-directives-and-the-pragma-keyword.md). Be sure the **pragma** is allowed by the compiler you are using. The following sample generates C4068: +## Remarks + +The compiler ignored an unrecognized [pragma](../../preprocessor/pragma-directives-and-the-pragma-keyword.md). Be sure the **pragma** is allowed by the compiler you are using. + +## Example + +The following sample generates C4068: ```cpp // C4068.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md index 36504dee456..42fe346055b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md @@ -10,8 +10,12 @@ ms.assetid: cd510e66-c338-4a86-a4d7-bfa1df9b16c3 > initializers put in compiler reserved initialization area +## Remarks + The compiler initialization area, which is specified by [#pragma init_seg](../../preprocessor/init-seg.md), is reserved by Microsoft. Code in this area may be executed before initialization of the C run-time library. +## Example + The following sample generates C4074: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md index 37373a95762..da50dae63e4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md @@ -10,8 +10,12 @@ ms.assetid: 19a700b6-f210-4b9d-a2f2-76cfe39ab178 > initializers put in unrecognized initialization area +## Remarks + A [#pragma init_seg](../../preprocessor/init-seg.md) uses an unrecognized section name. The compiler ignores the **pragma** command. +## Example + The following sample generates C4075: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md index a88f5393e66..a9367c599dd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md @@ -10,6 +10,8 @@ ms.assetid: c2d28805-b33f-41ad-afba-33b3f788c649 > unknown check_stack option +## Remarks + The old form of the **check_stack** pragma is used with an unknown argument. The argument must be `+`, `-`, `(on)`, `(off)`, or empty. The compiler ignores the pragma and leaves the stack checking unchanged. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md index 0d2c3b6c5eb..18909cac2cd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md @@ -10,8 +10,12 @@ ms.assetid: 549759f0-e168-47e9-8c9a-de93ac843689 > unexpected token 'token' +## Remarks + An unexpected separator token occurs in a pragma argument list. The remainder of the pragma was ignored. +## Example + The following sample generates C4079: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md index abb80b20d96..876ffe9ed85 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md @@ -10,8 +10,12 @@ ms.assetid: 964fb3f4-b9fd-450b-aa23-35cece126172 > expected identifier for segment name; found 'symbol' +## Remarks + The name of the segment in [#pragma alloc_text](../../preprocessor/alloc-text.md) must be a string or an identifier. The compiler ignores the pragma if a valid identifier is not found. +## Example + The following sample generates C4080: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md index 4d3fe502e14..80f85d1b9d2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md @@ -10,6 +10,8 @@ ms.assetid: 8c964e70-df12-45ff-93b9-496ad4271191 > type conversion; possible loss of data +## Remarks + An expression contains two data items with different base types. Converting one type causes the data item to be truncated. This warning may be fixed if you cast the data items to the appropriate type. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md index 205da54329b..72d12772a6e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md @@ -10,10 +10,14 @@ ms.assetid: a3c3a9b8-ec30-452d-96cb-3694adcce789 > overflow in floating point constant arithmetic +## Remarks + Floating-point constant arithmetic generates a result that exceeds the maximum allowable value. This warning can be caused by compiler optimizations performed during constant arithmetic. You can safely ignore this warning if it goes away when you turn off optimization ([/Od](../../build/reference/od-disable-debug.md)). +## Example + The following sample generates C4056: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md index 18d193caebe..bea8008dd04 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C4066"] > characters beyond first in wide-character constant ignored +## Remarks + The compiler processes only the first character of a wide-character constant. +## Example + ```cpp // C4066.cpp // compile with: /W3 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md index 29f4ff3ae7b..69afeb61b9e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md @@ -10,7 +10,13 @@ ms.assetid: 50081a6e-6acd-45ff-8484-9b1ea926cc5c > initializers put in library initialization area -Only third-party library developers should use the library initialization area, which is specified by [#pragma init_seg](../../preprocessor/init-seg.md). The following sample generates C4073: +## Remarks + +Only third-party library developers should use the library initialization area, which is specified by [#pragma init_seg](../../preprocessor/init-seg.md). + +## Example + +The following sample generates C4073: ```cpp // C4073.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md index 3faf74f0a8b..5c818f365d1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md @@ -10,4 +10,6 @@ ms.assetid: e3b8c46e-e36d-412c-99b9-3db860b6e307 > one void operand for '?:' +## Remarks + The `?:` operator is given an expression of type **`void`**. The value of the **`void`** operand is undefined. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md index bf4e73eba01..64bde557042 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md @@ -10,6 +10,8 @@ ms.assetid: e75d0645-84c9-4bef-a812-942ed9879aa3 > 'operator' : 'identifier1' indirection to slightly different base types from 'identifier2' +## Remarks + Two pointer expressions refer to different base types. The expressions are used without conversion. ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md index a3649649a1c..58a6b34fc45 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4061"] > enumerator '*identifier*' in switch of `enum` '*enumeration*' is not explicitly handled by a `case` label +## Remarks + The specified enumerator *identifier* has no associated handler in a `switch` statement that has a `default` case. The missing case might be an oversight, or it may not be an issue. Whether the missing `case` is an issue in practice depends on if the default case handles the enumerator. For a related warning on unused enumerators in `switch` statements that have no `default` case, see [C4062](compiler-warning-level-4-c4062.md). This warning is off by default. For more information about how to enable warnings that are off by default, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md index e6430b05b84..a0c79f1a353 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4062"] > enumerator '*identifier*' in switch of `enum` '*enumeration*' is not handled +## Remarks + The enumerator *identifier* doesn't have a `case` handler associated with it in a **`switch`** statement, and there's no **`default`** label that can catch it. The missing case may be an oversight, and is a potential error in your code. For a related warning on unused enumerators in **`switch`** statements that have a **`default`** case, see [C4061](compiler-warning-level-4-c4061.md). This warning is off by default. For more information about how to enable warnings that are off by default, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). From d8afdf5e05650c35b5efa864dc1926fc732943e0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 25 Aug 2025 22:54:59 +0800 Subject: [PATCH 0943/1799] Replace term "sample" with "example" for warning references in range [C4041, C4080] --- .../compiler-warnings/compiler-warning-level-1-c4042.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4047.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4052.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4055.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4068.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4074.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4075.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4076.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4079.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4080.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4056.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4073.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4061.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4062.md | 2 +- 14 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md index fe0c81806dd..64d5cf4765e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md @@ -24,7 +24,7 @@ This warning can be caused by specifying a storage class other than **`register` ## Example -The following sample generates C4042 +The following example generates C4042 ```cpp // C4042.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md index 81673c12421..2bb00d6e8be 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md @@ -16,7 +16,7 @@ A pointer can point to a variable (one level of indirection), to another pointer ## Examples -The following sample generates C4047: +The following example generates C4047: ```c // C4047.c @@ -34,7 +34,7 @@ int main() { } ``` -The following sample generates C4047: +The following example generates C4047: ```c // C4047b.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md index 9cc1cbc5de8..106e6813bb3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md @@ -15,7 +15,7 @@ One declaration of the function doesn't contain variable arguments. The empty de ## Example -The following sample generates C4052: +The following example generates C4052: ```c // C4052.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md index 29d27d3b0e8..a487ff40867 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md @@ -18,7 +18,7 @@ A data pointer is cast (possibly incorrectly) to a function pointer. This is a l ## Example -The following sample generates C4055: +The following example generates C4055: ```C // C4055.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md index b26863122b6..aa10e0e7bc0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md @@ -16,7 +16,7 @@ The compiler ignored an unrecognized [pragma](../../preprocessor/pragma-directiv ## Example -The following sample generates C4068: +The following example generates C4068: ```cpp // C4068.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md index 42fe346055b..5215bdd2e9d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md @@ -16,7 +16,7 @@ The compiler initialization area, which is specified by [#pragma init_seg](../.. ## Example -The following sample generates C4074: +The following example generates C4074: ```cpp // C4074.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md index da50dae63e4..bc4881b5b5e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md @@ -16,7 +16,7 @@ A [#pragma init_seg](../../preprocessor/init-seg.md) uses an unrecognized sectio ## Example -The following sample generates C4075: +The following example generates C4075: ```cpp // C4075.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md index ba24a51e7f3..344f01ef21a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md @@ -16,7 +16,7 @@ A type modifier, whether it is **`signed`** or **`unsigned`**, cannot be used wi ## Example -The following sample generates C4076; to fix it, remove the **`unsigned`** type modifier: +The following example generates C4076; to fix it, remove the **`unsigned`** type modifier: ```cpp // C4076.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md index 18909cac2cd..1af87abec76 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md @@ -16,7 +16,7 @@ An unexpected separator token occurs in a pragma argument list. The remainder of ## Example -The following sample generates C4079: +The following example generates C4079: ```cpp // C4079.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md index 876ffe9ed85..0cd532451e2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md @@ -16,7 +16,7 @@ The name of the segment in [#pragma alloc_text](../../preprocessor/alloc-text.md ## Example -The following sample generates C4080: +The following example generates C4080: ```cpp // C4080.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md index 72d12772a6e..f6aaadff02e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md @@ -18,7 +18,7 @@ This warning can be caused by compiler optimizations performed during constant a ## Example -The following sample generates C4056: +The following example generates C4056: ```cpp // C4056.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md index 69afeb61b9e..22d12fee6c5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md @@ -16,7 +16,7 @@ Only third-party library developers should use the library initialization area, ## Example -The following sample generates C4073: +The following example generates C4073: ```cpp // C4073.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md index 58a6b34fc45..764f9520993 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md @@ -17,7 +17,7 @@ This warning is off by default. For more information about how to enable warning ## Example -The following sample generates C4061; add a case for the missing enumerator to fix: +The following example generates C4061; add a case for the missing enumerator to fix: ```cpp // C4061.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md index a0c79f1a353..058bacf795a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md @@ -17,7 +17,7 @@ This warning is off by default. For more information about how to enable warning ## Example -The following sample generates C4062, and shows how to fix it: +The following example generates C4062, and shows how to fix it: ```cpp // C4062.cpp From 2421b03da34f0bb535c98b6461a2f11941f8cf8c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 25 Aug 2025 22:59:06 +0800 Subject: [PATCH 0944/1799] Update metadata for warning references in range [C4041, C4080] --- .../compiler-warnings/compiler-warning-level-1-c4041.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4042.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4045.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4047.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4048.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4049.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4052.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4055.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4067.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4068.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4074.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4075.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4076.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4077.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4079.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4080.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4051.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4056.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4066.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4073.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4053.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4057.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4061.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4062.md | 4 ++-- 24 files changed, 48 insertions(+), 68 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md index cc3497f46fd..522bdd17d0d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4041" title: "Compiler Warning (level 1) C4041" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4041" +ms.date: 11/04/2016 f1_keywords: ["C4041"] helpviewer_keywords: ["C4041"] -ms.assetid: 107ee9fd-4b88-4f22-a18f-a20726831095 --- # Compiler Warning (level 1) C4041 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md index 64d5cf4765e..2111f2a26b4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4042" title: "Compiler Warning (level 1) C4042" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4042" +ms.date: 11/04/2016 f1_keywords: ["C4042"] helpviewer_keywords: ["C4042"] -ms.assetid: e4bd861b-1194-426b-bf79-68c5b021eb0a --- # Compiler Warning (level 1) C4042 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md index 51538b4de45..3a866f8ae5f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4045" title: "Compiler Warning (level 1) C4045" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4045" +ms.date: 11/04/2016 f1_keywords: ["C4045"] helpviewer_keywords: ["C4045"] -ms.assetid: 3c6f7373-da91-45cd-b224-f49f7d8b4df0 --- # Compiler Warning (level 1) C4045 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md index 2bb00d6e8be..4a9b1b9a0ba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4047" title: "Compiler Warning (level 1) C4047" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4047" +ms.date: 11/04/2016 f1_keywords: ["C4047"] helpviewer_keywords: ["C4047"] -ms.assetid: b75ad6fb-5c93-4434-a85f-c4083051a5de --- # Compiler Warning (level 1) C4047 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md index ec2c0eb53fc..bf07d4838c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4048" title: "Compiler Warning (level 1) C4048" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4048" +ms.date: 11/04/2016 f1_keywords: ["C4048"] helpviewer_keywords: ["C4048"] -ms.assetid: 8429f513-4732-40f1-8e56-4c224e723bcb --- # Compiler Warning (level 1) C4048 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md index 37c946ac959..8e31d5fcc0e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4049" title: "Compiler Warning (level 1) C4049" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4049" +ms.date: 11/04/2016 f1_keywords: ["C4049"] helpviewer_keywords: ["C4049"] -ms.assetid: d11c1870-bcfc-4d71-8945-b87ec6ec3514 --- # Compiler Warning (level 1) C4049 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md index 106e6813bb3..d2c29d924f1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4052" title: "Compiler Warning (level 1 and level 4) C4052" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4052" +ms.date: 11/04/2016 f1_keywords: ["C4052"] helpviewer_keywords: ["C4052"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md index a487ff40867..766f8180af8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4055" title: "Compiler Warning (level 1) C4055" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4055" +ms.date: 11/04/2016 f1_keywords: ["C4055"] helpviewer_keywords: ["C4055"] -ms.assetid: f9955421-16ab-46e5-8f9d-bf1639a519ef --- # Compiler Warning (level 1) C4055 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md index 10e6a99d949..0feeb5308ac 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4067" title: "Compiler Warning (level 1) C4067" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4067" +ms.date: 11/04/2016 f1_keywords: ["C4067"] helpviewer_keywords: ["C4067"] -ms.assetid: 1d10353e-8cd5-4b01-9184-a06189b965a4 --- # Compiler Warning (level 1) C4067 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md index aa10e0e7bc0..138b6715dff 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4068" title: "Compiler Warning (level 1) C4068" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4068" +ms.date: 11/04/2016 f1_keywords: ["C4068"] helpviewer_keywords: ["C4068"] -ms.assetid: 96a7397a-4eab-44ab-b3bb-36747503f7e5 --- # Compiler Warning (level 1) C4068 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md index 5215bdd2e9d..ce3eb6ac36d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4074" title: "Compiler Warning (level 1) C4074" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4074" +ms.date: 11/04/2016 f1_keywords: ["C4074"] helpviewer_keywords: ["C4074"] -ms.assetid: cd510e66-c338-4a86-a4d7-bfa1df9b16c3 --- # Compiler Warning (level 1) C4074 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md index bc4881b5b5e..5e99eb14589 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4075" title: "Compiler Warning (level 1) C4075" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4075" +ms.date: 11/04/2016 f1_keywords: ["C4075"] helpviewer_keywords: ["C4075"] -ms.assetid: 19a700b6-f210-4b9d-a2f2-76cfe39ab178 --- # Compiler Warning (level 1) C4075 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md index 344f01ef21a..0361ba89332 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4076" title: "Compiler Warning (level 1) C4076" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4076" +ms.date: 11/04/2016 f1_keywords: ["C4076"] helpviewer_keywords: ["C4076"] -ms.assetid: 04581066-313a-4a11-bb60-721e6d038d75 --- # Compiler Warning (level 1) C4076 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md index a9367c599dd..8a7d3077cf3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4077" title: "Compiler Warning (level 1) C4077" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4077" +ms.date: 11/04/2016 f1_keywords: ["C4077"] helpviewer_keywords: ["C4077"] -ms.assetid: c2d28805-b33f-41ad-afba-33b3f788c649 --- # Compiler Warning (level 1) C4077 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md index 1af87abec76..89ec4207fdb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4079" title: "Compiler Warning (level 1) C4079" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4079" +ms.date: 11/04/2016 f1_keywords: ["C4079"] helpviewer_keywords: ["C4079"] -ms.assetid: 549759f0-e168-47e9-8c9a-de93ac843689 --- # Compiler Warning (level 1) C4079 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md index 0cd532451e2..60c2c69d85b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4080" title: "Compiler Warning (level 1) C4080" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4080" +ms.date: 11/04/2016 f1_keywords: ["C4080"] helpviewer_keywords: ["C4080"] -ms.assetid: 964fb3f4-b9fd-450b-aa23-35cece126172 --- # Compiler Warning (level 1) C4080 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md index 80f85d1b9d2..8d405b80739 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4051" title: "Compiler Warning (level 2) C4051" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4051" +ms.date: 11/04/2016 f1_keywords: ["C4051"] helpviewer_keywords: ["C4051"] -ms.assetid: 8c964e70-df12-45ff-93b9-496ad4271191 --- # Compiler Warning (level 2) C4051 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md index f6aaadff02e..f327965b82d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4056" title: "Compiler Warning (level 2) C4056" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4056" +ms.date: 11/04/2016 f1_keywords: ["C4056"] helpviewer_keywords: ["C4056"] -ms.assetid: a3c3a9b8-ec30-452d-96cb-3694adcce789 --- # Compiler Warning (level 2) C4056 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md index bea8008dd04..2fe850e6ee0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4066" title: "Compiler Warning (level 3) C4066" -ms.date: "03/06/2024" +description: "Learn more about: Compiler Warning (level 3) C4066" +ms.date: 03/06/2024 f1_keywords: ["C4066"] helpviewer_keywords: ["C4066"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md index 22d12fee6c5..eb4beeba089 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4073" title: "Compiler Warning (level 3) C4073" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4073" +ms.date: 11/04/2016 f1_keywords: ["C4073"] helpviewer_keywords: ["C4073"] -ms.assetid: 50081a6e-6acd-45ff-8484-9b1ea926cc5c --- # Compiler Warning (level 3) C4073 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md index 5c818f365d1..b18683f19f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4053" title: "Compiler Warning (level 4) C4053" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4053" +ms.date: 11/04/2016 f1_keywords: ["C4053"] helpviewer_keywords: ["C4053"] -ms.assetid: e3b8c46e-e36d-412c-99b9-3db860b6e307 --- # Compiler Warning (level 4) C4053 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md index 64bde557042..a7cac9d610c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4057" title: "Compiler Warning (level 4) C4057" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4057" +ms.date: 11/04/2016 f1_keywords: ["C4057"] helpviewer_keywords: ["C4057"] -ms.assetid: e75d0645-84c9-4bef-a812-942ed9879aa3 --- # Compiler Warning (level 4) C4057 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md index 764f9520993..828c339d2f7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4061" title: "Compiler Warning (level 4, off) C4061" -ms.date: "04/05/2019" +description: "Learn more about: Compiler Warning (level 4, off) C4061" +ms.date: 04/05/2019 f1_keywords: ["C4061"] helpviewer_keywords: ["C4061"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md index 058bacf795a..2862f25d899 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4062" title: "Compiler Warning (level 4, off) C4062" -ms.date: "04/05/2019" +description: "Learn more about: Compiler Warning (level 4, off) C4062" +ms.date: 04/05/2019 f1_keywords: ["C4062"] helpviewer_keywords: ["C4062"] --- From acfa37ccc2a30dfb2a7a10ac62768ead024dd1d0 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Mon, 25 Aug 2025 23:03:47 +0800 Subject: [PATCH 0945/1799] Add leading example sentence in C4066, C4067, and C4077 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4067.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4077.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4066.md | 2 ++ 3 files changed, 6 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md index 0feeb5308ac..6091facabd8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md @@ -15,6 +15,8 @@ The compiler found and ignored extra characters following a preprocessor directi ## Example +The following example generates C4067: + ```cpp // C4067a.cpp // compile with: cl /EHsc /DX /W1 /Za C4067a.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md index 8a7d3077cf3..de0009d557a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md @@ -17,6 +17,8 @@ The compiler ignores the pragma and leaves the stack checking unchanged. ## Example +The following example generates C4077: + ```cpp // C4077.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md index 2fe850e6ee0..3fcd48bfc7d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md @@ -15,6 +15,8 @@ The compiler processes only the first character of a wide-character constant. ## Example +The following example generates C4066: + ```cpp // C4066.cpp // compile with: /W3 From 2ac6d8f4776a33a4fec181467bcb358be2efed6c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 00:18:22 +0800 Subject: [PATCH 0946/1799] Add link and augment remarks in C2014 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2014.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md index 32eb37bf33e..4564ce87bd7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C2014"] ## Remarks -The `#` sign of a preprocessor directive must be the first character on a line that is not white space. +The `#` sign of a [preprocessor directive](../../preprocessor/preprocessor-directives.md) must be the first character on a line that is not white space. Ensure that the previous line doesn't contain a trailing escape. ## Example From fd253ecf49557c0888db4daa49b39d94c349d522 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 00:23:51 +0800 Subject: [PATCH 0947/1799] Merge and extend example in C2014 error reference --- .../compiler-errors-1/compiler-error-c2014.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md index 4564ce87bd7..d5e726b7030 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md @@ -19,14 +19,13 @@ The following example generates C2014: ```cpp // C2014.cpp -int k; #include // C2014 -``` +// compile with: /c -Possible resolution: +int a; #define A // C2014 -```cpp -// C2014b.cpp -// compile with: /c -int k; -#include +int b;\ +#define B // C2014 + +int c; +#define C // OK ``` From 8bbe1d3b8a9c3e3dc691c7668f444f78878416da Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 00:24:46 +0800 Subject: [PATCH 0948/1799] Update `ms.date` metadata in C2014 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2014.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md index d5e726b7030..0bbac771005 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2014" description: "Learn more about: Compiler Error C2014" -ms.date: 11/04/2016 +ms.date: 08/25/2025 f1_keywords: ["C2014"] helpviewer_keywords: ["C2014"] --- From 25e3e350f1bad2f93082585dc9e637c6af586d6e Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 09:33:22 -0700 Subject: [PATCH 0949/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 046c1e01f19..27b923fc138 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -25,7 +25,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If `1`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| -|`exitcode` | `1` | Override the program exit status with this value if the tool found an error.| +|`exitcode` | `1` | Override the program exit status with this value if ASan found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, the tool will search `$PATH` for the symbolizer.| |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| |`halt_on_error` | `true` | Not supported. Use `continue_on_error` for full support.| From 3294e871cc498093edd50c7a34a3b36c4963d75b Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 09:33:36 -0700 Subject: [PATCH 0950/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 27b923fc138..0769e6050fe 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -35,7 +35,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`help` | `false` | If `true`, ASan prints the flag options to console.| |`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include_if_exists` | `""` | Takes a path to a file, and reads options from the given file. ASan does not fail if file does not exist.| -|`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for strpbrk function to find more errors.| +|`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` function to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for strspn and strcspn function to find more errors.| |`intercept_strstr` | `true` | If `true`, uses custom wrappers for strstr and strcasestr functions to find more errors.| |`malloc_context_size` | `1` | Max number of stack frames kept for each allocation/deallocation.| From 9ffd68e1389f7cbf6a080d806fb8506c6d4b1134 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 09:33:45 -0700 Subject: [PATCH 0951/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 0769e6050fe..a848567ee26 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -26,7 +26,8 @@ The following is a list of actively supported options for the AddressSanitizer. |`detect_invalid_pointer_pairs` | `0` | If `1`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`exitcode` | `1` | Override the program exit status with this value if ASan found an error.| -|`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, the tool will search `$PATH` for the symbolizer.| +|`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, ASan will search `$PATH` for the symbolizer.| + |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| |`halt_on_error` | `true` | Not supported. Use `continue_on_error` for full support.| |`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.| From 0acef6185a48c9f2c5536024a255feb969477273 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 09:33:57 -0700 Subject: [PATCH 0952/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index a848567ee26..98321a6616c 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -43,7 +43,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`malloc_fill_byte` | `0xbe` | Value used to fill the newly allocated memory.| |`max_malloc_fill_size` | `4096` | ASan allocator flag. `max_malloc_fill_size` is the maximal amount of bytes that will be filled with `malloc_fill_byte` on `malloc`.| |`max_redzone` | `2048` | Maximal size (in bytes) of redzones around heap objects.| -|`new_delete_type_mismatch` | `true` | Report errors on mismatch betwen size of new and delete. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| +|`new_delete_type_mismatch` | `true` | Report errors on mismatch between size of `new` and `delete`. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| |`poison_heap` | `true` | Poison (or not) the heap memory on (de-)allocation. Zero value is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| From 042aa0d85e63aeea66bb47b9c46a9feede96a7cd Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 09:34:31 -0700 Subject: [PATCH 0953/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 98321a6616c..d0ab298dcf9 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -52,7 +52,8 @@ The following is a list of actively supported options for the AddressSanitizer. |`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| |`redzone` | `16` | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| -|`report_globals` | `1` | Controls the way to handle globals (`0` - don't detect buffer overflow on globals, `1` - detect buffer overflow, `2` - detect buffer overflow and print data about registered globals).| +|`report_globals` | `1` | Controls the way to handle globals: `0` - don't detect buffer overflow on globals, `1` - detect buffer overflow, `2` - detect buffer overflow and print data about registered globals.| + |`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.| |`stack_trace_format` | `DEFAULT` | Format string used to render stack frames.| |`strict_memcmp` | `true` | If `true`, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| From 7f917ebd81f6244e05aee86cb3e1d3786a250a01 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 09:50:07 -0700 Subject: [PATCH 0954/1799] Modify flag descriptions --- docs/sanitizers/asan-flags.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index d0ab298dcf9..cc7ffe6ba51 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -37,14 +37,14 @@ The following is a list of actively supported options for the AddressSanitizer. |`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include_if_exists` | `""` | Takes a path to a file, and reads options from the given file. ASan does not fail if file does not exist.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` function to find more errors.| -|`intercept_strspn` | `true` | If `true`, uses custom wrappers for strspn and strcspn function to find more errors.| -|`intercept_strstr` | `true` | If `true`, uses custom wrappers for strstr and strcasestr functions to find more errors.| +|`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` function to find more errors.| +|`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` functions to find more errors.| |`malloc_context_size` | `1` | Max number of stack frames kept for each allocation/deallocation.| |`malloc_fill_byte` | `0xbe` | Value used to fill the newly allocated memory.| |`max_malloc_fill_size` | `4096` | ASan allocator flag. `max_malloc_fill_size` is the maximal amount of bytes that will be filled with `malloc_fill_byte` on `malloc`.| |`max_redzone` | `2048` | Maximal size (in bytes) of redzones around heap objects.| |`new_delete_type_mismatch` | `true` | Report errors on mismatch between size of `new` and `delete`. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| -|`poison_heap` | `true` | Poison (or not) the heap memory on (de-)allocation. Zero value is useful for benchmarking the allocator or instrumentator.| +|`poison_heap` | `true` | If `true`, poison the heap memory on (de-)allocation. `false` is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| |`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| @@ -61,7 +61,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| |`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses to file or line locations.| |`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| -|`verbosity` | `0` | Verbosity level: `0` - default, `1` - more, `2+` - even more output.| +|`verbosity` | `0` | Verbosity level: `0` - default verbosity, `1` - more output, `2` - even more output.| |`windows_fast_fail_on_error`|`false`|If `true`, enable the process to terminate with a `__fastfail(71)` after printing the error report. See [windows_fast_fail_on_error](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`windows_hook_legacy_allocators`|`true`|If `true`, enable hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| From c4bd9a3e5df1c0ed5173011445d2c6bc61a6a4a3 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 09:51:09 -0700 Subject: [PATCH 0955/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index cc7ffe6ba51..635e52534bb 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -17,7 +17,7 @@ The following is a list of actively supported options for the AddressSanitizer. |------|---------------|-------------| |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| -|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| +|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - `realloc(p, 0)` is equivalent to `free(p)`. 0 - `realloc(p, 0)` will return a non-`NULL` value.| |`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](https://learn.microsoft.com/en-us/cpp/sanitizers/asan-runtime?view=msvc-170#poisoning) APIs.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| From 5c7030791541730b9bd0a7e92feed35634232f66 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 09:53:47 -0700 Subject: [PATCH 0956/1799] Remove absolute linking --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index cc7ffe6ba51..bb6f94c39ca 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -19,7 +19,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| |`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - realloc(p, 0) is equivalent to free(p). 0 - realloc(p, 0) will return a non-`NULL` value.| |`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| -|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](https://learn.microsoft.com/en-us/cpp/sanitizers/asan-runtime?view=msvc-170#poisoning) APIs.| +|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](./asan-runtime.md#poisoning) APIs.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| From de3ea57d0de7df6669624113c32546b910ba8077 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 09:54:32 -0700 Subject: [PATCH 0957/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index a67da1f42e1..bfe925c4a4a 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -23,7 +23,8 @@ The following is a list of actively supported options for the AddressSanitizer. |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| -|`detect_invalid_pointer_pairs` | `0` | If `1`, the tool detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| +|`detect_invalid_pointer_pairs` | `0` | If `1`, ASan detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| + |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`exitcode` | `1` | Override the program exit status with this value if ASan found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, ASan will search `$PATH` for the symbolizer.| From 5c30a895788b611bab6143e5fb5c42890889cc0a Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 10:03:30 -0700 Subject: [PATCH 0958/1799] Fix table formatting --- docs/sanitizers/asan-flags.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index bfe925c4a4a..b36740328ea 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -24,11 +24,9 @@ The following is a list of actively supported options for the AddressSanitizer. |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If `1`, ASan detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| - |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`exitcode` | `1` | Override the program exit status with this value if ASan found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, ASan will search `$PATH` for the symbolizer.| - |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| |`halt_on_error` | `true` | Not supported. Use `continue_on_error` for full support.| |`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.| @@ -54,7 +52,6 @@ The following is a list of actively supported options for the AddressSanitizer. |`redzone` | `16` | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| |`report_globals` | `1` | Controls the way to handle globals: `0` - don't detect buffer overflow on globals, `1` - detect buffer overflow, `2` - detect buffer overflow and print data about registered globals.| - |`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.| |`stack_trace_format` | `DEFAULT` | Format string used to render stack frames.| |`strict_memcmp` | `true` | If `true`, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| From 91cd5150cb15da12e086d2444469bd9fb21b8548 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 10:20:32 -0700 Subject: [PATCH 0959/1799] Removed deprecated flag --- docs/sanitizers/asan-flags.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index b36740328ea..4e78cfdc71c 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -47,7 +47,6 @@ The following is a list of actively supported options for the AddressSanitizer. |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| |`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| -|`quarantine_size` | `-1` | Deprecated, please use `quarantine_size_mb`.| |`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| |`redzone` | `16` | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| From 2c3c96a08bb3e7554464a77c147b002f5e2633a2 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 10:20:43 -0700 Subject: [PATCH 0960/1799] Incorporate Acrolinx suggestions --- docs/sanitizers/asan-flags.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 4e78cfdc71c..1a8b801a1b4 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -7,18 +7,18 @@ helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Add # AddressSanitizer Runtime Options -The following is a list of actively supported options for the AddressSanitizer. They can be enabled through the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function, as described [here](./asan-runtime.md#runtime-options). +The following table lists actively supported options for the AddressSanitizer. They can be enabled through the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function, as described [here](./asan-runtime.md#runtime-options). > [!NOTE] -> These descriptions may vary from those in Clang's ASan docs to account for MSVC specific behaviors. +> These descriptions may vary from the runtime options in Clang's ASan docs to account for MSVC specific behaviors. | Flag | Default value | Description | |------|---------------|-------------| |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| -|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - `realloc(p, 0)` is equivalent to `free(p)`. 0 - `realloc(p, 0)` will return a non-`NULL` value.| -|`allocator_may_return_null` | `false` | If `true`, the allocator will return `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| +|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - `realloc(p, 0)` is equivalent to `free(p)`. 0 - `realloc(p, 0)` returns a non-`NULL` value.| +|`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](./asan-runtime.md#poisoning) APIs.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| @@ -26,12 +26,12 @@ The following is a list of actively supported options for the AddressSanitizer. |`detect_invalid_pointer_pairs` | `0` | If `1`, ASan detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`exitcode` | `1` | Override the program exit status with this value if ASan found an error.| -|`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, ASan will search `$PATH` for the symbolizer.| +|`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| |`halt_on_error` | `true` | Not supported. Use `continue_on_error` for full support.| |`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.| -|`handle_sigfpe` | `true` | If `true`, ASan will handle `SIGFPE` errors.| -|`handle_sigill` | `true` | If `true`, ASan will handle `SIGILL` errors.| +|`handle_sigfpe` | `true` | If `true`, ASan handles `SIGFPE` errors.| +|`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to console.| |`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include_if_exists` | `""` | Takes a path to a file, and reads options from the given file. ASan does not fail if file does not exist.| @@ -40,7 +40,7 @@ The following is a list of actively supported options for the AddressSanitizer. |`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` functions to find more errors.| |`malloc_context_size` | `1` | Max number of stack frames kept for each allocation/deallocation.| |`malloc_fill_byte` | `0xbe` | Value used to fill the newly allocated memory.| -|`max_malloc_fill_size` | `4096` | ASan allocator flag. `max_malloc_fill_size` is the maximal amount of bytes that will be filled with `malloc_fill_byte` on `malloc`.| +|`max_malloc_fill_size` | `4096` | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.| |`max_redzone` | `2048` | Maximal size (in bytes) of redzones around heap objects.| |`new_delete_type_mismatch` | `true` | Report errors on mismatch between size of `new` and `delete`. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| |`poison_heap` | `true` | If `true`, poison the heap memory on (de-)allocation. `false` is useful for benchmarking the allocator or instrumentator.| From 342a008c1c883de895efb9eebc7f45faff2d1aad Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 10:22:32 -0700 Subject: [PATCH 0961/1799] More Acrolinx suggestions --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 1a8b801a1b4..48a0e4fa7e4 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -34,7 +34,7 @@ The following table lists actively supported options for the AddressSanitizer. T |`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to console.| |`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| -|`include_if_exists` | `""` | Takes a path to a file, and reads options from the given file. ASan does not fail if file does not exist.| +|`include_if_exists` | `""` | Takes a path to a file, and reads options from the given file. ASan doesn't fail if file doesn't exist.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` function to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` function to find more errors.| |`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` functions to find more errors.| From 809d8fa1b0f8b65d30196c66fb38215591576325 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 10:55:34 -0700 Subject: [PATCH 0962/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 48a0e4fa7e4..259cd0ab8e0 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -23,7 +23,7 @@ The following table lists actively supported options for the AddressSanitizer. T |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| -|`detect_invalid_pointer_pairs` | `0` | If `1`, ASan detects operations like <, <=, >, >=, and - on invalid pointer pairs, such as pointers that belong to different objects.| +|`detect_invalid_pointer_pairs` | `0` | If `1`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs, such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`exitcode` | `1` | Override the program exit status with this value if ASan found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| From 5e2feabdaee32587ca98d069561778b0a80ae812 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 10:55:48 -0700 Subject: [PATCH 0963/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 259cd0ab8e0..645481ed6ea 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -21,7 +21,7 @@ The following table lists actively supported options for the AddressSanitizer. T |`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](./asan-runtime.md#poisoning) APIs.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| -|`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - output to `stdout`, `2` - output to `stderr`. See [continue_on_error](asan-continue-on-error.md).| +|`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - enabled, and error output is sent to `stdout`, `2` - enabled, and error output is sent to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `0` | If `1`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs, such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| From 33c1648dc1499189758372229fbb8d71cc5846cf Mon Sep 17 00:00:00 2001 From: MacGyver Codilla <77024043+39otsu@users.noreply.github.com> Date: Mon, 25 Aug 2025 10:55:57 -0700 Subject: [PATCH 0964/1799] Update docs/sanitizers/asan-flags.md Co-authored-by: David Justo --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 645481ed6ea..dec02ba4fc0 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -17,7 +17,7 @@ The following table lists actively supported options for the AddressSanitizer. T |------|---------------|-------------| |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| -|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | 1 - `realloc(p, 0)` is equivalent to `free(p)`. 0 - `realloc(p, 0)` returns a non-`NULL` value.| +|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | If set to `1`, realloc(p, 0) is equivalent to free(p) by default (same as the POSIX standard). If set to `0`, realloc(p, 0) will return a pointer to an allocated space which can not be used. | |`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](./asan-runtime.md#poisoning) APIs.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| From a832613809720a5c6c80b9fefb594bab9b5252c0 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 11:35:12 -0700 Subject: [PATCH 0965/1799] Add values for stack_trace_format --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 48a0e4fa7e4..469014267cb 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -52,7 +52,7 @@ The following table lists actively supported options for the AddressSanitizer. T |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| |`report_globals` | `1` | Controls the way to handle globals: `0` - don't detect buffer overflow on globals, `1` - detect buffer overflow, `2` - detect buffer overflow and print data about registered globals.| |`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.| -|`stack_trace_format` | `DEFAULT` | Format string used to render stack frames.| +|`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders: `%%` - represents a `'%'` character; `%n` - frame number (copy of frame_no); `%p` - `PC`; `%m` - path to module; `%o` - offset in the module; `%f` - function name; `%q` - if available, offset in the function; `%s` - path to source file; `%l` - line in the source file; `%c` - column in the source file; `%F` - if function is known, ASan prints `in `, followed by the offset in this function if source is unknown; `%S` - ASan prints file/line/column information; `%L` - If file information is available, ASan prints file name, line, and column. If module information is available, ASan prints module name, offset, and architecture. If neither are available, ASan prints `()`; `%M` - If known, ASan prints module basename and offset, or `PC`.| |`strict_memcmp` | `true` | If `true`, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| |`strict_string_checks` | `false` | If `true` check that string arguments are properly null-terminated.| |`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| From a8d5cca93a89e40a726bb882d48a7bf4a3fb38e7 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 11:57:33 -0700 Subject: [PATCH 0966/1799] Fix description --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index e57b473c936..6c1ee72a31c 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -17,7 +17,7 @@ The following table lists actively supported options for the AddressSanitizer. T |------|---------------|-------------| |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| -|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | If set to `1`, realloc(p, 0) is equivalent to free(p) by default (same as the POSIX standard). If set to `0`, realloc(p, 0) will return a pointer to an allocated space which can not be used. | +|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | If set to `1`, `realloc(p, 0)` is equivalent to `free(p)` by default (same as the POSIX standard). If set to `0`, `realloc(p, 0)` returns a pointer to an allocated space that can't be used. | |`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](./asan-runtime.md#poisoning) APIs.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| From ec50c948b3cbb4704dfcdc29ead409c64593c176 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 12:08:49 -0700 Subject: [PATCH 0967/1799] Verbosity level --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 6c1ee72a31c..6fdedd4421e 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -58,7 +58,7 @@ The following table lists actively supported options for the AddressSanitizer. T |`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| |`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses to file or line locations.| |`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| -|`verbosity` | `0` | Verbosity level: `0` - default verbosity, `1` - more output, `2` - even more output.| +|`verbosity` | `0` | Verbosity level: `0` - default verbosity, `1` - more output, `2` - even more output, `3` - current upper limit verbosity level | |`windows_fast_fail_on_error`|`false`|If `true`, enable the process to terminate with a `__fastfail(71)` after printing the error report. See [windows_fast_fail_on_error](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`windows_hook_legacy_allocators`|`true`|If `true`, enable hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| From 25d96f1b909ed21c3f313353fce364c80026b450 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 14:16:23 -0700 Subject: [PATCH 0968/1799] Add line breaks in stack_trace_format description --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 6fdedd4421e..680567b8d19 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -52,7 +52,7 @@ The following table lists actively supported options for the AddressSanitizer. T |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| |`report_globals` | `1` | Controls the way to handle globals: `0` - don't detect buffer overflow on globals, `1` - detect buffer overflow, `2` - detect buffer overflow and print data about registered globals.| |`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.| -|`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders: `%%` - represents a `'%'` character; `%n` - frame number (copy of frame_no); `%p` - `PC`; `%m` - path to module; `%o` - offset in the module; `%f` - function name; `%q` - if available, offset in the function; `%s` - path to source file; `%l` - line in the source file; `%c` - column in the source file; `%F` - if function is known, ASan prints `in `, followed by the offset in this function if source is unknown; `%S` - ASan prints file/line/column information; `%L` - If file information is available, ASan prints file name, line, and column. If module information is available, ASan prints module name, offset, and architecture. If neither are available, ASan prints `()`; `%M` - If known, ASan prints module basename and offset, or `PC`.| +|`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders:
`%%` - represents a `'%'` character
`%n` - frame number (copy of `frame_no`)
`%p` - `PC`
`%m` - path to module
`%o` - offset in the module
`%f` - function name
`%q` - if available, offset in the function
`%s` - path to source file
`%l` - line in the source file
`%c` - column in the source file
`%F` - if function is known, ASan prints `in `, followed by the offset in this function if source is unknown
`%S` - ASan prints file/line/column information
`%L` - If file information is available, ASan prints file name, line, and column. If module information is available, ASan prints module name, offset, and architecture. If neither are available, ASan prints `()`
`%M` - If known, ASan prints module basename and offset, or `PC`| |`strict_memcmp` | `true` | If `true`, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| |`strict_string_checks` | `false` | If `true` check that string arguments are properly null-terminated.| |`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| From 5a3850c3f60bfc58a2b60998e7bd965bd24d47ee Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 25 Aug 2025 14:28:35 -0700 Subject: [PATCH 0969/1799] Change integer to boolean --- docs/sanitizers/asan-flags.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 680567b8d19..f809824908b 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -17,13 +17,13 @@ The following table lists actively supported options for the AddressSanitizer. T |------|---------------|-------------| |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| -|`allocator_frees_and_returns_null_on_realloc_zero` | `1` | If set to `1`, `realloc(p, 0)` is equivalent to `free(p)` by default (same as the POSIX standard). If set to `0`, `realloc(p, 0)` returns a pointer to an allocated space that can't be used. | +|`allocator_frees_and_returns_null_on_realloc_zero` | `true` | If set to `true`, `realloc(p, 0)` is equivalent to `free(p)` by default (same as the POSIX standard). If set to `false`, `realloc(p, 0)` returns a pointer to an allocated space that can't be used. | |`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](./asan-runtime.md#poisoning) APIs.| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - enabled, and error output is sent to `stdout`, `2` - enabled, and error output is sent to `stderr`. See [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| -|`detect_invalid_pointer_pairs` | `0` | If `1`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs, such as pointers that belong to different objects.| +|`detect_invalid_pointer_pairs` | `false` | If `true`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs, such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| |`exitcode` | `1` | Override the program exit status with this value if ASan found an error.| |`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| From 5704ddf30e28cc688d43fe9ec0b889f7c4ab8a34 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 22:44:33 +0800 Subject: [PATCH 0970/1799] Add blockquotes for warning messages in range [C4081, C4120] --- .../compiler-warnings/compiler-warning-level-1-c4081.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4083.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4085.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4086.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4087.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4088.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4089.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4090.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4096.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4097.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4098.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4103.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4109.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4113.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4114.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4116.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4117.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4119.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4120.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4094.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4102.md | 2 +- .../compiler-warnings/compiler-warning-levels-1-and-4-c4115.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) 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 index a266ad55b2d..d4c587e2cec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md @@ -8,7 +8,7 @@ ms.assetid: 6f656373-a080-4989-bbc9-e2f894b03293 --- # Compiler Warning (level 1) C4081 -expected 'token1'; found 'token2' +> expected 'token1'; found 'token2' The compiler expected a different token in this context. 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 index 87918fc4491..5625f529ff0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md @@ -8,7 +8,7 @@ ms.assetid: e7d3344e-5645-4d56-8460-d1acc9145ada --- # Compiler Warning (level 1) C4083 -expected 'token'; found identifier 'identifier' +> expected 'token'; found identifier 'identifier' An identifier occurs in the wrong place in a **#pragma** statement. 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 index af90990a225..3746d114a0e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md @@ -8,7 +8,7 @@ ms.assetid: 2bc6eb25-058f-4597-b351-fd69587b5170 --- # Compiler Warning (level 1) C4085 -expected pragma parameter to be 'on' or 'off' +> expected pragma parameter to be 'on' or 'off' The pragma requires an **on** or **off** parameter. The pragma is ignored. 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 index 1c8cf29e1b9..74176ede4fc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md @@ -8,7 +8,7 @@ ms.assetid: 9248831b-22bf-47af-8684-bfadb17e94fc --- # Compiler Warning (level 1) C4086 -expected pragma parameter to be '1', '2', '4', '8', or '16' +> expected pragma parameter to be '1', '2', '4', '8', or '16' The pragma parameter does not have the required value (1, 2, 4, 8, or 16). 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 index 631fbd9d8c8..1f998f10567 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md @@ -8,7 +8,7 @@ ms.assetid: 546e4d57-5c8e-422c-8ef1-92657336dad5 --- # Compiler Warning (level 1) C4087 -'function' : declared with 'void' parameter list +> 'function' : declared with 'void' parameter list 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. 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 index 743a55b292b..c73bb4b4c10 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md @@ -8,6 +8,6 @@ ms.assetid: 9bab817c-16b2-4324-be5e-f9cbb06b702e --- # Compiler Warning (level 1) C4088 -'function' : pointer mismatch in actual parameter 'number', formal parameter 'number' +> 'function' : pointer mismatch in actual parameter 'number', formal parameter 'number' 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 index c5a33f3524b..0b0e684b24d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md @@ -8,6 +8,6 @@ ms.assetid: 7c8f929b-9bf9-4063-9b7e-4affd98c1acc --- # Compiler Warning (level 1) C4089 -'function' : different types in actual parameter 'number', formal parameter 'number' +> 'function' : different types in actual parameter 'number', formal parameter 'number' 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 index 4bb401cbcb1..ab70f4744e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md @@ -8,7 +8,7 @@ ms.assetid: baad469d-23d4-45aa-ad9c-305b32d61e9a --- # Compiler Warning (level 1) C4090 -'operation' : different 'modifier' qualifiers +> 'operation' : different 'modifier' qualifiers 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. 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 index 1013ef52740..5f58ea1ef0e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md @@ -8,7 +8,7 @@ ms.assetid: abf3cca2-2f21-45d8-b025-6b513b00681e --- # Compiler Warning (level 1) C4096 -'a': interface is not a COM interface; will not be emitted to IDL +> 'a': interface is not a COM interface; will not be emitted to IDL 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. 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 index c9c9d9688d8..3d22355344d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md @@ -8,7 +8,7 @@ ms.assetid: 2525be51-fac2-43b2-b57c-3bbf1a2268f7 --- # Compiler Warning (level 1) C4097 -expected pragma parameter to be 'restore' or 'off' +> expected pragma parameter to be 'restore' or 'off' A pragma was passed an invalid value. 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 index 02da792a1f2..04d93012355 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md @@ -8,6 +8,6 @@ ms.assetid: 8c8aef1c-1639-44ec-a3dd-c0dfe9aa727d --- # Compiler Warning (level 1) C4098 -'function' : void function returning a value +> 'function' : void function returning a value 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 index a61f63ece8c..90cb25e4c3b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md @@ -8,7 +8,7 @@ ms.assetid: 9021b514-375e-4d62-b261-ccb06f299e8e --- # Compiler Warning (level 1) C4103 -'filename' : alignment changed after including header, may be due to missing #pragma pack(pop) +> 'filename' : alignment changed after including header, may be due to missing #pragma pack(pop) Packing affects the layout of classes, and commonly, if packing changes across header files, there can be problems. 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 index 3c6de78389d..d4598c03e1e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md @@ -8,7 +8,7 @@ ms.assetid: 9e8d95c6-e05d-47e0-bd87-78974b3cc06c --- # Compiler Warning (level 1) C4109 -unexpected identifier 'identifier' +> unexpected identifier 'identifier' The pragma containing the unexpected identifier is ignored. 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 index 7a93cc5ec61..7b4e47754c4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md @@ -8,6 +8,6 @@ ms.assetid: ec7a7c4a-d2ee-431c-89dc-31b0f9bfd975 --- # Compiler Warning (level 1) C4113 -'identifier1' differs in parameter lists from 'identifier2' +> 'identifier1' differs in parameter lists from 'identifier2' 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 index ef6514dddea..6f2457a9a04 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md @@ -8,7 +8,7 @@ ms.assetid: 3983e1c6-e8bb-46dc-8894-e1827db48797 --- # Compiler Warning (level 1) C4114 -same type qualifier used more than once +> same type qualifier used more than once 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). 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 index 4c64a7d9d08..eca6e35593d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md @@ -8,7 +8,7 @@ ms.assetid: 25434ef3-061e-4252-91a5-0fe2a4b2ffb3 --- # Compiler Warning (level 1) C4116 -unnamed type definition in parentheses +> unnamed type definition in parentheses A structure, union, or enumerated type with no name is defined in a parenthetical expression. The type definition is meaningless. 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 index 1b76610289e..747dd3f599e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md @@ -8,7 +8,7 @@ ms.assetid: c45aa281-4cc1-4dfd-bd32-bd7a60ddd577 --- # Compiler Warning (level 1) C4117 -macro name 'name' is reserved; 'Command' ignored +> macro name 'name' is reserved; 'Command' ignored ### To fix by checking the following possible causes 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 index 6734a6e402b..b6f9f4dd912 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md @@ -8,6 +8,6 @@ ms.assetid: 0052ce92-033a-4dce-a11e-b7388f4f5c2b --- # Compiler Warning (level 1) C4119 -different bases 'base1' and 'base2' specified +> different bases 'base1' and 'base2' specified 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 index 65f329119b9..5c4b0d539d2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md @@ -8,6 +8,6 @@ ms.assetid: 9faa9265-34b4-41dd-b7a2-e2f3969b1d91 --- # Compiler Warning (level 1) C4120 -based/unbased mismatch +> based/unbased mismatch 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 index fe8f42e4001..e4c6d4390d8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md @@ -8,7 +8,7 @@ ms.assetid: e68929fb-3a1c-4be7-920b-d5f79f534f99 --- # Compiler Warning (level 2) C4094 -untagged 'token' declared no symbols +> untagged 'token' declared no symbols The compiler detected an empty declaration using an untagged structure, union, or class. The declaration is ignored. 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 index 379c3a7b12b..30b56670f3d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md @@ -8,7 +8,7 @@ ms.assetid: 349f308a-daf3-48c6-bd53-6c38b73f8880 --- # Compiler Warning (level 3) C4102 -'label' : unreferenced label +> 'label' : unreferenced label The label is defined but never referenced. The compiler ignores the label. 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 index d881c7f2c15..85e5b1b3112 100644 --- 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 @@ -8,7 +8,7 @@ ms.assetid: f3f94e72-fc49-4d09-b3e7-23d68e61152f --- # Compiler Warning (levels 1 and 4) C4115 -'type' : named type definition in parentheses +> 'type' : named type definition in parentheses 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. From abf975297e53ec6eb86e17c4dba2c5b790fe7dbc Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 22:53:12 +0800 Subject: [PATCH 0971/1799] Add "Remarks" and "Example" headings for warning references in range [C4081, C4120] --- .../compiler-warnings/compiler-warning-level-1-c4081.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4083.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4085.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4086.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4087.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4088.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4089.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4090.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4091.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4096.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4097.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4098.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4103.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4109.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4113.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4114.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4116.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4117.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4119.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4120.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4094.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4099.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4101.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-3-c4102.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4092.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4100.md | 4 ++++ .../compiler-warning-levels-1-and-4-c4112.md | 4 ++++ .../compiler-warning-levels-1-and-4-c4115.md | 2 ++ 28 files changed, 81 insertions(+), 1 deletion(-) 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 index d4c587e2cec..de92314dbfe 100644 --- 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 index 5625f529ff0..c5e49710bd4 100644 --- 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 index 3746d114a0e..f17a20a5189 100644 --- 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 index 74176ede4fc..04bf02548e7 100644 --- 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 index 1f998f10567..19ddcad84b6 100644 --- 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 index c73bb4b4c10..e82ddea4a11 100644 --- 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 index 0b0e684b24d..6bf2a752212 100644 --- 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 index ab70f4744e3..6e64a0f7f50 100644 --- 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 index bd1e02649e1..8fbdcffdfa5 100644 --- 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 index 5f58ea1ef0e..b97215e735b 100644 --- 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 index 3d22355344d..881e56b5c6e 100644 --- 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 index 04d93012355..997c7116ce0 100644 --- 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 index 90cb25e4c3b..261419a39b6 100644 --- 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 index d4598c03e1e..a6b163924cd 100644 --- 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 index 7b4e47754c4..8d5faec1c9d 100644 --- 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 index 6f2457a9a04..9f10c9f3786 100644 --- 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 index eca6e35593d..c5c0f45cdc0 100644 --- 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 index 747dd3f599e..1fc3e21602e 100644 --- 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 index b6f9f4dd912..71a9ae34531 100644 --- 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 index 5c4b0d539d2..c59e9c70009 100644 --- 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 index e4c6d4390d8..fee43bff17e 100644 --- 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 index 813ec5943a9..3f454b16f3a 100644 --- 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 index 3199f6c3e53..c130cc04340 100644 --- 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 index 30b56670f3d..34e215ea283 100644 --- 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 index 5f3cc5c9b67..0dc09558b43 100644 --- 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 index b4b8cfae668..827db5ea9be 100644 --- 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 index 6dc4a888bef..0874b2de65a 100644 --- 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 index 85e5b1b3112..4700cd5d38c 100644 --- 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. From 06a3dcdb940d9a82fdcd8aae3a3cb1ded2d1541d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 22:54:28 +0800 Subject: [PATCH 0972/1799] Replace term "sample" with "example" for warning references in range [C4081, C4120] --- .../compiler-warnings/compiler-warning-level-1-c4085.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4090.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4091.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4096.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4097.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4103.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4114.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4117.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4099.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4102.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4100.md | 2 +- .../compiler-warning-levels-1-and-4-c4112.md | 2 +- 12 files changed, 14 insertions(+), 14 deletions(-) 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 index f17a20a5189..452ec6512f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md @@ -16,7 +16,7 @@ The pragma requires an **on** or **off** parameter. The pragma is ignored. ## Example -The following sample generates C4085: +The following example generates C4085: ```cpp // C4085.cpp 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 index 6e64a0f7f50..4e2fc9b581d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md @@ -20,7 +20,7 @@ This warning is issued for C programs. In a C++ program, the compiler issues an ## Example -The following sample generates C4090: +The following example generates C4090: ```c // 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 index 8fbdcffdfa5..9231fa328d4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md @@ -15,7 +15,7 @@ The compiler detected a situation where the user probably intended a variable to ## Examples -A **`__declspec`** attribute at the beginning of a user-defined type declaration applies to the variable of that type. C4091 indicates no variable is declared. The following sample generates C4091. +A **`__declspec`** attribute at the beginning of a user-defined type declaration applies to the variable of that type. C4091 indicates no variable is declared. The following example generates C4091. ```cpp // C4091.cpp @@ -30,7 +30,7 @@ __declspec(dllimport) class X2 {} varX; class __declspec(dllimport) X3 {}; ``` -If an identifier is a typedef, it can't also be a variable name. The following sample generates C4091. +If an identifier is a typedef, it can't also be a variable name. The following example generates C4091. ```cpp // C4091_b.cpp 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 index b97215e735b..4e096c9e622 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md @@ -18,7 +18,7 @@ See [Interface Attributes](../../windows/attributes/interface-attributes.md) for ## Example -The following sample generates C4096: +The following example generates C4096: ```cpp // 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 index 881e56b5c6e..a3dcd2dbed5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md @@ -16,7 +16,7 @@ A pragma was passed an invalid value. ## Example -The following sample generates C4097: +The following example generates C4097: ```cpp // C4097.cpp 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 index 261419a39b6..1d868640ab8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md @@ -18,7 +18,7 @@ Use #pragma [pack](../../preprocessor/pack.md)(pop) before exiting the header fi ## Example -The following sample generates C4103: +The following example generates C4103: ```cpp // C4103.h 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 index 9f10c9f3786..7709ec51ae9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md @@ -16,7 +16,7 @@ A type declaration or definition uses a type qualifier (**`const`**, **`volatile ## Examples -The following sample generates C4114: +The following example generates C4114: ```cpp // C4114.cpp @@ -24,7 +24,7 @@ The following sample generates C4114: volatile volatile int i; // C4114 ``` -The following sample generates C4114: +The following example generates C4114: ```cpp // C4114_b.cpp 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 index 1fc3e21602e..0c354aa3a46 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md @@ -20,7 +20,7 @@ ms.assetid: c45aa281-4cc1-4dfd-bd32-bd7a60ddd577 ## Example -The following sample generates C4117: +The following example generates C4117: ```cpp // C4117.cpp 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 index 3f454b16f3a..8b341870250 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md @@ -15,7 +15,7 @@ An object declared as a structure is defined as a class, or an object declared a ## Example -The following sample generates C4099. +The following example generates C4099. ```cpp // C4099.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 index 34e215ea283..2f6fe1daeec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md @@ -16,7 +16,7 @@ The label is defined but never referenced. The compiler ignores the label. ## Example -The following sample generates C4102: +The following example generates C4102: ```cpp // C4102.cpp 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 index 827db5ea9be..b79b1d58fab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md @@ -17,7 +17,7 @@ C4100 can also be issued when code calls a destructor on an otherwise unreferenc ## Example -The following sample generates C4100: +The following example generates C4100: ```cpp // 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 index 0874b2de65a..c7bd116218b 100644 --- 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 @@ -17,7 +17,7 @@ If the specified parameter is less than 1, the line counter is reset to 1. If th ## Example -The following sample generates C4112: +The following example generates C4112: ```cpp // C4112.cpp From f223e62480dffc876de2bd4218f9d986779f6379 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 22:58:55 +0800 Subject: [PATCH 0973/1799] Update metadata for warning references in range [C4081, C4120] --- .../compiler-warnings/compiler-warning-level-1-c4081.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4083.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4085.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4086.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4087.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4088.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4089.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4090.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4091.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4096.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4097.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4098.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4103.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4109.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4113.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4114.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4116.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4117.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4119.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4120.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4094.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4099.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4101.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4102.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4092.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4100.md | 2 +- .../compiler-warning-levels-1-and-4-c4112.md | 4 ++-- .../compiler-warning-levels-1-and-4-c4115.md | 5 ++--- 28 files changed, 54 insertions(+), 77 deletions(-) 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 index de92314dbfe..276a4dbbcb1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4081" title: "Compiler Warning (level 1) C4081" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4081" +ms.date: 11/04/2016 f1_keywords: ["C4081"] helpviewer_keywords: ["C4081"] -ms.assetid: 6f656373-a080-4989-bbc9-e2f894b03293 --- # Compiler Warning (level 1) C4081 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 index c5e49710bd4..6edffa8523a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4083" title: "Compiler Warning (level 1) C4083" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4083" +ms.date: 11/04/2016 f1_keywords: ["C4083"] helpviewer_keywords: ["C4083"] -ms.assetid: e7d3344e-5645-4d56-8460-d1acc9145ada --- # Compiler Warning (level 1) C4083 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 index 452ec6512f4..98a8afd3948 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4085" title: "Compiler Warning (level 1) C4085" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4085" +ms.date: 11/04/2016 f1_keywords: ["C4085"] helpviewer_keywords: ["C4085"] -ms.assetid: 2bc6eb25-058f-4597-b351-fd69587b5170 --- # Compiler Warning (level 1) C4085 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 index 04bf02548e7..130910254a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4086" title: "Compiler Warning (level 1) C4086" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4086" +ms.date: 11/04/2016 f1_keywords: ["C4086"] helpviewer_keywords: ["C4086"] -ms.assetid: 9248831b-22bf-47af-8684-bfadb17e94fc --- # Compiler Warning (level 1) C4086 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 index 19ddcad84b6..35566f44e69 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4087" title: "Compiler Warning (level 1) C4087" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4087" +ms.date: 11/04/2016 f1_keywords: ["C4087"] helpviewer_keywords: ["C4087"] -ms.assetid: 546e4d57-5c8e-422c-8ef1-92657336dad5 --- # Compiler Warning (level 1) C4087 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 index e82ddea4a11..24b6a432788 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4088" title: "Compiler Warning (level 1) C4088" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4088" +ms.date: 11/04/2016 f1_keywords: ["C4088"] helpviewer_keywords: ["C4088"] -ms.assetid: 9bab817c-16b2-4324-be5e-f9cbb06b702e --- # Compiler Warning (level 1) C4088 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 index 6bf2a752212..90895290376 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4089" title: "Compiler Warning (level 1) C4089" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4089" +ms.date: 11/04/2016 f1_keywords: ["C4089"] helpviewer_keywords: ["C4089"] -ms.assetid: 7c8f929b-9bf9-4063-9b7e-4affd98c1acc --- # Compiler Warning (level 1) C4089 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 index 4e2fc9b581d..716f99228f5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4090" title: "Compiler Warning (level 1) C4090" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4090" +ms.date: 11/04/2016 f1_keywords: ["C4090"] helpviewer_keywords: ["C4090"] -ms.assetid: baad469d-23d4-45aa-ad9c-305b32d61e9a --- # Compiler Warning (level 1) C4090 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 index 9231fa328d4..100e44a0e12 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 2) C4091" title: "Compiler Warning (level 1 and level 2) C4091" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 2) C4091" +ms.date: 11/04/2016 f1_keywords: ["C4091"] helpviewer_keywords: ["C4091"] --- 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 index 4e096c9e622..95738c23070 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4096" title: "Compiler Warning (level 1) C4096" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4096" +ms.date: 11/04/2016 f1_keywords: ["C4096"] helpviewer_keywords: ["C4096"] -ms.assetid: abf3cca2-2f21-45d8-b025-6b513b00681e --- # Compiler Warning (level 1) C4096 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 index a3dcd2dbed5..36cde34b27c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4097" title: "Compiler Warning (level 1) C4097" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4097" +ms.date: 11/04/2016 f1_keywords: ["C4097"] helpviewer_keywords: ["C4097"] -ms.assetid: 2525be51-fac2-43b2-b57c-3bbf1a2268f7 --- # Compiler Warning (level 1) C4097 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 index 997c7116ce0..c90d530b284 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4098" title: "Compiler Warning (level 1) C4098" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4098" +ms.date: 11/04/2016 f1_keywords: ["C4098"] helpviewer_keywords: ["C4098"] -ms.assetid: 8c8aef1c-1639-44ec-a3dd-c0dfe9aa727d --- # Compiler Warning (level 1) C4098 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 index 1d868640ab8..c9365e43be1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4103" title: "Compiler Warning (level 1) C4103" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4103" +ms.date: 11/04/2016 f1_keywords: ["C4103"] helpviewer_keywords: ["C4103"] -ms.assetid: 9021b514-375e-4d62-b261-ccb06f299e8e --- # Compiler Warning (level 1) C4103 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 index a6b163924cd..83ce14796f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4109" title: "Compiler Warning (level 1) C4109" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4109" +ms.date: 11/04/2016 f1_keywords: ["C4109"] helpviewer_keywords: ["C4109"] -ms.assetid: 9e8d95c6-e05d-47e0-bd87-78974b3cc06c --- # Compiler Warning (level 1) C4109 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 index 8d5faec1c9d..336d4c75cb1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4113" title: "Compiler Warning (level 1) C4113" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4113" +ms.date: 11/04/2016 f1_keywords: ["C4113"] helpviewer_keywords: ["C4113"] -ms.assetid: ec7a7c4a-d2ee-431c-89dc-31b0f9bfd975 --- # Compiler Warning (level 1) C4113 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 index 7709ec51ae9..57c02abc3a4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4114" title: "Compiler Warning (level 1) C4114" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4114" +ms.date: 11/04/2016 f1_keywords: ["C4114"] helpviewer_keywords: ["C4114"] -ms.assetid: 3983e1c6-e8bb-46dc-8894-e1827db48797 --- # Compiler Warning (level 1) C4114 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 index c5c0f45cdc0..b650d740844 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4116" title: "Compiler Warning (level 1) C4116" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4116" +ms.date: 11/04/2016 f1_keywords: ["C4116"] helpviewer_keywords: ["C4116"] -ms.assetid: 25434ef3-061e-4252-91a5-0fe2a4b2ffb3 --- # Compiler Warning (level 1) C4116 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 index 0c354aa3a46..8355fc6923a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4117" title: "Compiler Warning (level 1) C4117" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4117" +ms.date: 11/04/2016 f1_keywords: ["C4117"] helpviewer_keywords: ["C4117"] -ms.assetid: c45aa281-4cc1-4dfd-bd32-bd7a60ddd577 --- # Compiler Warning (level 1) C4117 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 index 71a9ae34531..4cdf1d4876f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4119" title: "Compiler Warning (level 1) C4119" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4119" +ms.date: 11/04/2016 f1_keywords: ["C4119"] helpviewer_keywords: ["C4119"] -ms.assetid: 0052ce92-033a-4dce-a11e-b7388f4f5c2b --- # Compiler Warning (level 1) C4119 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 index c59e9c70009..04227416fd6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4120" title: "Compiler Warning (level 1) C4120" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4120" +ms.date: 11/04/2016 f1_keywords: ["C4120"] helpviewer_keywords: ["C4120"] -ms.assetid: 9faa9265-34b4-41dd-b7a2-e2f3969b1d91 --- # Compiler Warning (level 1) C4120 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 index fee43bff17e..071e8808a8a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4094" title: "Compiler Warning (level 2) C4094" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4094" +ms.date: 11/04/2016 f1_keywords: ["C4094"] helpviewer_keywords: ["C4094"] -ms.assetid: e68929fb-3a1c-4be7-920b-d5f79f534f99 --- # Compiler Warning (level 2) C4094 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 index 8b341870250..1739a47480f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md @@ -1,7 +1,7 @@ --- title: "Compiler Warning (level 2) C4099" description: "Learn more about: Compiler Warning (level 2) C4099" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C4099"] helpviewer_keywords: ["C4099"] --- 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 index c130cc04340..bf61764db50 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3 and level 4) C4101" title: "Compiler Warning (level 3 and level 4) C4101" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3 and level 4) C4101" +ms.date: 11/04/2016 f1_keywords: ["C4101"] helpviewer_keywords: ["C4101"] --- 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 index 2f6fe1daeec..63b13fa15f5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4102" title: "Compiler Warning (level 3) C4102" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4102" +ms.date: 11/04/2016 f1_keywords: ["C4102"] helpviewer_keywords: ["C4102"] -ms.assetid: 349f308a-daf3-48c6-bd53-6c38b73f8880 --- # Compiler Warning (level 3) C4102 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 index 0dc09558b43..d926a41d768 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4092.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4092.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4092" title: "Compiler Warning (level 4) C4092" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4092" +ms.date: 11/04/2016 f1_keywords: ["C4092"] helpviewer_keywords: ["C4092"] -ms.assetid: 396ae826-a892-4327-bd66-f4762376d72b --- # Compiler Warning (level 4) C4092 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 index b79b1d58fab..c0b6b54f40f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4100" title: "Compiler Warning (level 4) C4100" +description: "Learn more about: Compiler Warning (level 4) C4100" ms.date: 04/22/2025 f1_keywords: ["C4100"] helpviewer_keywords: ["C4100"] 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 index c7bd116218b..96a81a8c9a0 100644 --- 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 @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4112" title: "Compiler Warning (level 1 and level 4) C4112" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4112" +ms.date: 11/04/2016 f1_keywords: ["C4112"] helpviewer_keywords: ["C4112"] --- 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 index 4700cd5d38c..34868cd3197 100644 --- 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 @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (levels 1 and 4) C4115" title: "Compiler Warning (levels 1 and 4) C4115" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (levels 1 and 4) C4115" +ms.date: 11/04/2016 f1_keywords: ["C4115"] helpviewer_keywords: ["C4115"] -ms.assetid: f3f94e72-fc49-4d09-b3e7-23d68e61152f --- # Compiler Warning (levels 1 and 4) C4115 From e4ab56a1f3610042e3e46cdc5f948029213b4f04 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:04:36 +0800 Subject: [PATCH 0974/1799] Add leading example sentence for warning references in range [C4081, C4120] --- .../compiler-warnings/compiler-warning-level-1-c4081.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4083.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4086.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4087.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4109.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4094.md | 2 ++ 6 files changed, 12 insertions(+) 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 index 276a4dbbcb1..fff7ef70eca 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md @@ -15,6 +15,8 @@ The compiler expected a different token in this context. ## Example +The following example generates C4081: + ```cpp // C4081.cpp // compile with: /W1 /LD 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 index 6edffa8523a..2796ab139eb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md @@ -15,6 +15,8 @@ An identifier occurs in the wrong place in a **#pragma** statement. ## Example +The following example generates C4083: + ```cpp // C4083.cpp // compile with: /W1 /LD 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 index 130910254a6..f64ee275649 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md @@ -15,6 +15,8 @@ The pragma parameter does not have the required value (1, 2, 4, 8, or 16). ## Example +The following example generates C4086: + ```cpp // C4086.cpp // compile with: /W1 /LD 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 index 35566f44e69..b8d7e4fa763 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md @@ -17,6 +17,8 @@ This warning is for the C compiler. ## Example +The following example generates C4087: + ```c // C4087.c // compile with: /W1 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 index 83ce14796f2..dfa71b61be9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md @@ -15,6 +15,8 @@ The pragma containing the unexpected identifier is ignored. ## Example +The following example generates C4109: + ```cpp // C4109.cpp // compile with: /W1 /LD 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 index 071e8808a8a..aa4ef8419c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md @@ -15,6 +15,8 @@ The compiler detected an empty declaration using an untagged structure, union, o ## Example +The following example generates C4094: + ```cpp // C4094.cpp // compile with: /W2 From 9d6cd2e20ee608c205566c00e673a1e345a9316d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:12:42 +0800 Subject: [PATCH 0975/1799] Add blockquotes for warning messages in range [C4121, C4160] --- .../compiler-warnings/compiler-warning-level-1-c4122.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4124.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4129.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4138.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4142.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4143.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4144.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4145.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4153.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4154.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4155.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4157.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4156.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4121.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4125.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4130.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4131.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4132.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4152.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md index 61cba8a38be..e733af6c4ba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md @@ -8,7 +8,7 @@ ms.assetid: 9a83eb0d-8708-42f7-988a-b0b6f2f646a0 --- # Compiler Warning (level 1) C4122 -'function' : alloc_text applicable only to functions with C linkage +> 'function' : alloc_text applicable only to functions with C linkage The **alloc_text** pragma applies only to functions declared with **extern c**. It cannot be used with external C++ functions. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md index 504d71c8ed4..3a825b416f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md @@ -8,7 +8,7 @@ ms.assetid: c08c3a65-9584-47a1-a147-44f00c4b230e --- # Compiler Warning (level 1) C4124 -__fastcall with stack checking is inefficient +> __fastcall with stack checking is inefficient The **`__fastcall`** keyword was used with stack checking enabled. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md index 1dc06732e56..453af27783f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md @@ -8,7 +8,7 @@ ms.assetid: a4190c64-4bfb-48fd-8e98-52720bc0d878 --- # Compiler Warning (level 1) C4129 -'character' : unrecognized character escape sequence +> 'character' : unrecognized character escape sequence The `character` following a backslash (\\) in a character or string constant is not recognized as a valid escape sequence. The backslash is ignored and not printed. The character following the backslash is printed. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md index 8a5d005a472..5647b37f82b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md @@ -8,7 +8,7 @@ ms.assetid: 65ebf929-bba0-4237-923b-c1b66adfe17d --- # Compiler Warning (level 1) C4138 -'*/' found outside of comment +> '*/' found outside of comment The closing-comment delimiter is not preceded by an opening-comment delimiter. The compiler assumes a space between the asterisk (\*) and the forward slash (/). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md index 202399a686d..f12f02f6e16 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md @@ -8,7 +8,7 @@ ms.assetid: 1fdfc3dc-60a2-4f00-b133-20e400f9b7a6 --- # Compiler Warning (level 1) C4142 -benign redefinition of type +> benign redefinition of type A type is redefined in a manner that has no effect on the generated code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md index 5ae6a8f9ad2..7459260d1ef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md @@ -8,6 +8,6 @@ ms.assetid: ef0bd19f-d169-4034-8710-b22971bd642d --- # Compiler Warning (level 1) C4143 -pragma 'same_seg' not supported; use __based allocation +> pragma 'same_seg' not supported; use __based allocation The **#pragma same_seg** is no longer supported. Use the [__based](../../cpp/based-pointers-cpp.md) keyword instead. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md index 9a5b1400ff6..bb47b225811 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md @@ -8,7 +8,7 @@ ms.assetid: a37b445d-dbc6-43b4-8d95-ffd0e4225464 --- # Compiler Warning (level 1) C4144 -'expression' : relational expression as switch expression +> 'expression' : relational expression as switch expression The specified relational expression was used as the control expression of a [switch](../../cpp/switch-statement-cpp.md) statement. The associated case statements will be offered Boolean values. The following sample generates C4144: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md index 5d2abaa9db8..19caf4b1448 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md @@ -8,7 +8,7 @@ ms.assetid: 0440777a-cca2-4159-aff5-e67a254ad64a --- # Compiler Warning (level 1) C4145 -'expression1' : relational expression as switch expression; possible confusion with 'expression2' +> 'expression1' : relational expression as switch expression; possible confusion with 'expression2' A **`switch`** statement uses a relational expression as its control expression, which results in a Boolean value for the **`case`** statements. Did you mean *expression2*? diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md index 452c1f40feb..88fd69beb1d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md @@ -8,6 +8,6 @@ ms.assetid: 37a15754-9dba-470b-adda-c4b888064b3e --- # Compiler Warning (level 1) C4153 -function/data pointer conversion in expression +> function/data pointer conversion in expression A function pointer is converted to or from a data pointer. This conversion is allowed under Microsoft extensions (/Ze) but not under ANSI C. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md index a46730e0c11..8e1a7ad44fb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md @@ -8,7 +8,7 @@ ms.assetid: 4511afeb-e893-4cc6-83b6-4c7a0477f76b --- # Compiler Warning (level 1) C4154 -deletion of an array expression; conversion to pointer supplied +> deletion of an array expression; conversion to pointer supplied You cannot use **`delete`** on an array, so the compiler converts the array to a pointer. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md index bb736d60391..7ef31e3d48a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md @@ -8,7 +8,7 @@ ms.assetid: ba233353-09e3-4195-8127-13a27ddd8d70 --- # Compiler Warning (level 1) C4155 -deletion of an array expression without using the array form of 'delete' +> deletion of an array expression without using the array form of 'delete' The array form of **`delete`** should be used to delete an array. This warning occurs only under ANSI-compatibility (/Za). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md index db705ad99ec..1cea93b4266 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md @@ -8,6 +8,6 @@ ms.assetid: 6dabc303-eba1-4a8e-a124-a6e1dc84f4bd --- # Compiler Warning (level 1) C4157 -pragma was ignored by C compiler +> pragma was ignored by C compiler Only the C++ compiler recognizes **init_seg()**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md index c2b9d9baa66..b7fb11a618f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md @@ -8,7 +8,7 @@ ms.assetid: 9adf3acb-c0fe-42a8-a4db-5822b1493f77 --- # Compiler Warning (level 2) C4156 -deletion of an array expression without using the array form of 'delete'; array form substituted +> deletion of an array expression without using the array form of 'delete'; array form substituted The non-array form of **`delete`** cannot delete an array. The compiler translated **`delete`** to the array form. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md index ab0179a1064..7b33b47a9d1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md @@ -8,7 +8,7 @@ ms.assetid: 8c5b85c9-2543-426b-88bc-319c50158c7e --- # Compiler Warning (level 4) C4121 -'symbol' : alignment of a member was sensitive to packing +> 'symbol' : alignment of a member was sensitive to packing The compiler added padding to align a structure member on the packing boundary but the packing value is less than the member's size. For example, the following code snippet produces C4121: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md index 8e5089b3f3d..3ae2a934729 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md @@ -8,7 +8,7 @@ ms.assetid: a081d1f4-0789-4915-91df-7ff0b28ca245 --- # Compiler Warning (level 4) C4125 -decimal digit terminates octal escape sequence +> decimal digit terminates octal escape sequence The compiler evaluates the octal number without the decimal digit and assumes the decimal digit is a character. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md index b50e7d32d72..cea0ead7d37 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md @@ -8,7 +8,7 @@ ms.assetid: 45e4c7b2-6b51-41c7-ba5e-941aa5c7d3dc --- # Compiler Warning (level 4) C4130 -'operator' : logical operation on address of string constant +> 'operator' : logical operation on address of string constant Using the operator with the address of a string literal produces unexpected code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md index 4104ac0109e..ba7b59e5503 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md @@ -8,7 +8,7 @@ ms.assetid: 7903b3e1-454f-4be2-aa9b-230992f96a2d --- # Compiler Warning (level 4) C4131 -'function' : uses old-style declarator +> 'function' : uses old-style declarator The specified function declaration is not in prototype form. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md index 29b10b01926..ceab9790c17 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md @@ -8,6 +8,6 @@ ms.assetid: b60e5b4a-53ac-4503-8456-235477f48afd --- # Compiler Warning (level 4) C4132 -'object' : const object should be initialized +> 'object' : const object should be initialized The constant is not initialized. The value of a symbol with the **`const`** attribute cannot be changed after its definition, it should be given an initialization value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md index 0209f54d2aa..8cf9b7aeeb9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md @@ -8,6 +8,6 @@ ms.assetid: 6025ab70-d7cf-4730-913a-3ca0b1186a3a --- # Compiler Warning (level 4) C4152 -non standard extension, function/data ptr conversion in expression +> non standard extension, function/data ptr conversion in expression A function pointer is converted to or from a data pointer. This conversion is allowed under Microsoft extensions (/Ze) but not under ANSI C. From 91296d78b74d8ac3a099f6aa2625749d100eb9a6 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:22:36 +0800 Subject: [PATCH 0976/1799] Add "Remarks" and "Example" headings for warning references in range [C4121, C4160] --- .../compiler-warnings/compiler-warning-level-1-c4122.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4124.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4129.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4138.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4142.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4143.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4144.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4145.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4153.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4154.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4155.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4157.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4158.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4146.md | 4 ++-- .../compiler-warnings/compiler-warning-level-2-c4150.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4156.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4133.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4121.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-4-c4125.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4127.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4130.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4131.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4132.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4152.md | 2 ++ 24 files changed, 65 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md index e733af6c4ba..710c616e063 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md @@ -10,6 +10,8 @@ ms.assetid: 9a83eb0d-8708-42f7-988a-b0b6f2f646a0 > 'function' : alloc_text applicable only to functions with C linkage +## Remarks + The **alloc_text** pragma applies only to functions declared with **extern c**. It cannot be used with external C++ functions. The pragma is ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md index 3a825b416f4..165c0d90359 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md @@ -10,6 +10,8 @@ ms.assetid: c08c3a65-9584-47a1-a147-44f00c4b230e > __fastcall with stack checking is inefficient +## Remarks + The **`__fastcall`** keyword was used with stack checking enabled. The **`__fastcall`** convention generates faster code, but stack checking causes slower code. When using **`__fastcall`**, turn off stack checking with the **check_stack** pragma or /Gs. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md index 453af27783f..6b0f583bd86 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md @@ -10,12 +10,16 @@ ms.assetid: a4190c64-4bfb-48fd-8e98-52720bc0d878 > 'character' : unrecognized character escape sequence +## Remarks + The `character` following a backslash (\\) in a character or string constant is not recognized as a valid escape sequence. The backslash is ignored and not printed. The character following the backslash is printed. To print a single backslash, specify a double backslash (\\\\). The C++ standard, in section 2.13.2 discusses escape sequences. +## Example + The following sample generates C4129: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md index 5647b37f82b..346349bd9d5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md @@ -10,6 +10,8 @@ ms.assetid: 65ebf929-bba0-4237-923b-c1b66adfe17d > '*/' found outside of comment +## Remarks + The closing-comment delimiter is not preceded by an opening-comment delimiter. The compiler assumes a space between the asterisk (\*) and the forward slash (/). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md index f12f02f6e16..9e464e58eb1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md @@ -10,6 +10,8 @@ ms.assetid: 1fdfc3dc-60a2-4f00-b133-20e400f9b7a6 > benign redefinition of type +## Remarks + A type is redefined in a manner that has no effect on the generated code. To fix by checking the following possible causes: @@ -18,6 +20,8 @@ To fix by checking the following possible causes: - A type defined with the **`typedef`** command is redefined using different syntax. +## Example + The following sample generates C4142: ```c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md index 7459260d1ef..ddbff1223f0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md @@ -10,4 +10,6 @@ ms.assetid: ef0bd19f-d169-4034-8710-b22971bd642d > pragma 'same_seg' not supported; use __based allocation +## Remarks + The **#pragma same_seg** is no longer supported. Use the [__based](../../cpp/based-pointers-cpp.md) keyword instead. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md index bb47b225811..e2c2e84157e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md @@ -10,7 +10,13 @@ ms.assetid: a37b445d-dbc6-43b4-8d95-ffd0e4225464 > 'expression' : relational expression as switch expression -The specified relational expression was used as the control expression of a [switch](../../cpp/switch-statement-cpp.md) statement. The associated case statements will be offered Boolean values. The following sample generates C4144: +## Remarks + +The specified relational expression was used as the control expression of a [switch](../../cpp/switch-statement-cpp.md) statement. The associated case statements will be offered Boolean values. + +## Example + +The following sample generates C4144: ```cpp // C4144.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md index 19caf4b1448..e7804a1caf9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md @@ -10,6 +10,8 @@ ms.assetid: 0440777a-cca2-4159-aff5-e67a254ad64a > 'expression1' : relational expression as switch expression; possible confusion with 'expression2' +## Remarks + A **`switch`** statement uses a relational expression as its control expression, which results in a Boolean value for the **`case`** statements. Did you mean *expression2*? ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md index 88fd69beb1d..5750044bffc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md @@ -10,4 +10,6 @@ ms.assetid: 37a15754-9dba-470b-adda-c4b888064b3e > function/data pointer conversion in expression +## Remarks + A function pointer is converted to or from a data pointer. This conversion is allowed under Microsoft extensions (/Ze) but not under ANSI C. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md index 8e1a7ad44fb..a73bab697c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md @@ -10,6 +10,8 @@ ms.assetid: 4511afeb-e893-4cc6-83b6-4c7a0477f76b > deletion of an array expression; conversion to pointer supplied +## Remarks + You cannot use **`delete`** on an array, so the compiler converts the array to a pointer. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md index 7ef31e3d48a..daf2f9b67f6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md @@ -10,6 +10,8 @@ ms.assetid: ba233353-09e3-4195-8127-13a27ddd8d70 > deletion of an array expression without using the array form of 'delete' +## Remarks + The array form of **`delete`** should be used to delete an array. This warning occurs only under ANSI-compatibility (/Za). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md index 1cea93b4266..4e38d3c717f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md @@ -10,4 +10,6 @@ ms.assetid: 6dabc303-eba1-4a8e-a124-a6e1dc84f4bd > pragma was ignored by C compiler +## Remarks + Only the C++ compiler recognizes **init_seg()**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md index 0c5e3fe14ca..c65e899dc9e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md @@ -10,4 +10,6 @@ ms.assetid: 6513c6b9-6772-4849-b96c-5bb093d54de6 > assuming #pragma pointers_to_members(full_generality, inheritance) +## Remarks + A `#pragma pointers_to_members( single | multiple | virtual )` was issued without an accompanying `#pragma pointers_to_members(full_generality)`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md index 5cf22844774..439b8dffbcc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4146"] > unary minus operator applied to unsigned type, result still unsigned -Unsigned types only hold non-negative values. So unary minus (negation) usually doesn't make sense when applied to an unsigned type. Both the operand and the result are non-negative. - ## Remarks +Unsigned types only hold non-negative values. So unary minus (negation) usually doesn't make sense when applied to an unsigned type. Both the operand and the result are non-negative. + When you express a negative integer literal, the **`-`** in front of the value is parsed as a [unary negation](../../cpp/unary-plus-and-negation-operators-plus-and.md) operator. The compiler applies the operator after it parses the numeric value. If the numeric value fits in the range of an unsigned integer type, but not the corresponding signed integer type, the compiler interprets the value as unsigned. This warning often occurs when you try to express the minimum **`int`** value, -2147483648, or the minimum **`long long`** value, -9223372036854775808. These values can't be written as -2147483648 or -9223372036854775808ll. The reason is because the compiler processes the expression in two stages: first, it parses the numeric value, then it applies the negation operator. For example, when the compiler parses -2147483648, it follows these steps: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md index 3fcab815220..6fb3505b141 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4150"] > deletion of pointer to incomplete type 'type'; no destructor called +## Remarks + The `delete` operator is called to delete a type that was declared but not defined. The compiler can't find the destructor to call because the definition isn't in the same translation unit as the `delete`. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md index b7fb11a618f..ecd8359f2f8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md @@ -10,6 +10,8 @@ ms.assetid: 9adf3acb-c0fe-42a8-a4db-5822b1493f77 > deletion of an array expression without using the array form of 'delete'; array form substituted +## Remarks + The non-array form of **`delete`** cannot delete an array. The compiler translated **`delete`** to the array form. This warning occurs only under Microsoft extensions (/Ze). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md index 48a818c0f07..63bb48405e0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4133"] > '*expression*': incompatible types - from '*type1*' to '*type2*' +## Remarks + This warning is emitted when incompatible types are used in an expression. For example, doing arithmetic operations such as subtraction with different pointer types. To avoid this warning, provide an appropriate type cast. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md index 7b33b47a9d1..8e6537c60a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md @@ -10,7 +10,13 @@ ms.assetid: 8c5b85c9-2543-426b-88bc-319c50158c7e > 'symbol' : alignment of a member was sensitive to packing -The compiler added padding to align a structure member on the packing boundary but the packing value is less than the member's size. For example, the following code snippet produces C4121: +## Remarks + +The compiler added padding to align a structure member on the packing boundary but the packing value is less than the member's size. + +## Example + +For example, the following code snippet produces C4121: ```cpp // C4121.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md index 3ae2a934729..77dfb9bf83d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md @@ -10,6 +10,8 @@ ms.assetid: a081d1f4-0789-4915-91df-7ff0b28ca245 > decimal digit terminates octal escape sequence +## Remarks + The compiler evaluates the octal number without the decimal digit and assumes the decimal digit is a character. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md index 6edd099df73..93d7372a5ff 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md @@ -16,7 +16,7 @@ The controlling expression of an **`if`** statement or **`while`** loop evaluate If the controlling expression of a **`while`** loop is a constant because the loop exits in the middle, consider replacing the **`while`** loop with a **`for`** loop. You can omit the initialization, termination test and loop increment of a **`for`** loop, which causes the loop to be infinite, just like `while(1)`, and you can exit the loop from the body of the **`for`** statement. -## Example +## Examples The following sample shows two ways C4127 is generated, and shows how to use a for loop to avoid the warning: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md index cea0ead7d37..2c6b92b46e0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md @@ -10,8 +10,12 @@ ms.assetid: 45e4c7b2-6b51-41c7-ba5e-941aa5c7d3dc > 'operator' : logical operation on address of string constant +## Remarks + Using the operator with the address of a string literal produces unexpected code. +## Example + The following sample generates C4130: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md index ba7b59e5503..3619a5c469e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md @@ -10,10 +10,14 @@ ms.assetid: 7903b3e1-454f-4be2-aa9b-230992f96a2d > 'function' : uses old-style declarator +## Remarks + The specified function declaration is not in prototype form. Old-style function declarations should be converted to prototype form. +## Example + The following example shows an old-style function declaration: ```c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md index ceab9790c17..91a32db6a6a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md @@ -10,4 +10,6 @@ ms.assetid: b60e5b4a-53ac-4503-8456-235477f48afd > 'object' : const object should be initialized +## Remarks + The constant is not initialized. The value of a symbol with the **`const`** attribute cannot be changed after its definition, it should be given an initialization value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md index 8cf9b7aeeb9..ff1cf0669ea 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md @@ -10,4 +10,6 @@ ms.assetid: 6025ab70-d7cf-4730-913a-3ca0b1186a3a > non standard extension, function/data ptr conversion in expression +## Remarks + A function pointer is converted to or from a data pointer. This conversion is allowed under Microsoft extensions (/Ze) but not under ANSI C. From b86736f6e8f07bf9fd2540c40685007142440a56 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:24:01 +0800 Subject: [PATCH 0977/1799] Replace term "sample" with "example" for warning references in range [C4121, C4160] --- .../compiler-warnings/compiler-warning-level-1-c4129.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4142.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4144.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4145.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4155.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4146.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4150.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4127.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4130.md | 2 +- 9 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md index 6b0f583bd86..326f98789e5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md @@ -20,7 +20,7 @@ The C++ standard, in section 2.13.2 discusses escape sequences. ## Example -The following sample generates C4129: +The following example generates C4129: ```cpp // C4129.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md index 9e464e58eb1..3adecd2d0b7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md @@ -22,7 +22,7 @@ To fix by checking the following possible causes: ## Example -The following sample generates C4142: +The following example generates C4142: ```c // C4142.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md index e2c2e84157e..431f47ec0a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md @@ -16,7 +16,7 @@ The specified relational expression was used as the control expression of a [swi ## Example -The following sample generates C4144: +The following example generates C4144: ```cpp // C4144.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md index e7804a1caf9..80952508179 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md @@ -16,7 +16,7 @@ A **`switch`** statement uses a relational expression as its control expression, ## Example -The following sample generates C4145: +The following example generates C4145: ```cpp // C4145.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md index daf2f9b67f6..0f7d6b75b35 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md @@ -16,7 +16,7 @@ The array form of **`delete`** should be used to delete an array. This warning o ## Example -The following sample generates C4155: +The following example generates C4155: ```cpp // C4155.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md index 439b8dffbcc..ec27d0f33ed 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md @@ -28,7 +28,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example -The following sample demonstrates the unexpected behavior that can happen when the compiler generates warning C4146: +The following example demonstrates the unexpected behavior that can happen when the compiler generates warning C4146: ```cpp // C4146.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md index 6fb3505b141..6f7148a40c2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md @@ -15,7 +15,7 @@ The `delete` operator is called to delete a type that was declared but not defin ## Example -The following sample generates C4150 by declaring but not defining `class IncClass`: +The following example generates C4150 by declaring but not defining `class IncClass`: ```cpp // compile with: /W2 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md index 93d7372a5ff..f7209eb1c00 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md @@ -18,7 +18,7 @@ If the controlling expression of a **`while`** loop is a constant because the lo ## Examples -The following sample shows two ways C4127 is generated, and shows how to use a for loop to avoid the warning: +The following example shows two ways C4127 is generated, and shows how to use a for loop to avoid the warning: ```cpp // C4127.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md index 2c6b92b46e0..5cb5302bb43 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md @@ -16,7 +16,7 @@ Using the operator with the address of a string literal produces unexpected code ## Example -The following sample generates C4130: +The following example generates C4130: ```cpp // C4130.cpp From 4c96416f02be3572d4b6bfcd92e3f2b69708d351 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:28:15 +0800 Subject: [PATCH 0978/1799] Update metadata for warning references in range [C4121, C4160] --- .../compiler-warnings/compiler-warning-level-1-c4122.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4124.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4129.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4138.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4141.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4142.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4143.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4144.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4145.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4153.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4154.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4155.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4157.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4158.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4160.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4146.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4150.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4156.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4133.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4159.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4121.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4125.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4127.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4130.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4131.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4132.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4152.md | 5 ++--- 27 files changed, 52 insertions(+), 75 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md index 710c616e063..bdb3071ce53 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4122" title: "Compiler Warning (level 1) C4122" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4122" +ms.date: 11/04/2016 f1_keywords: ["C4122"] helpviewer_keywords: ["C4122"] -ms.assetid: 9a83eb0d-8708-42f7-988a-b0b6f2f646a0 --- # Compiler Warning (level 1) C4122 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md index 165c0d90359..6e38358a92c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4124" title: "Compiler Warning (level 1) C4124" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4124" +ms.date: 11/04/2016 f1_keywords: ["C4124"] helpviewer_keywords: ["C4124"] -ms.assetid: c08c3a65-9584-47a1-a147-44f00c4b230e --- # Compiler Warning (level 1) C4124 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md index 326f98789e5..d75dddc8ccd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4129" title: "Compiler Warning (level 1) C4129" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4129" +ms.date: 11/04/2016 f1_keywords: ["C4129"] helpviewer_keywords: ["C4129"] -ms.assetid: a4190c64-4bfb-48fd-8e98-52720bc0d878 --- # Compiler Warning (level 1) C4129 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md index 346349bd9d5..803962499b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4138" title: "Compiler Warning (level 1) C4138" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4138" +ms.date: 11/04/2016 f1_keywords: ["C4138"] helpviewer_keywords: ["C4138"] -ms.assetid: 65ebf929-bba0-4237-923b-c1b66adfe17d --- # Compiler Warning (level 1) C4138 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md index e166131289d..47e29f63e3e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4141" title: "Compiler Warning (level 1, Error) C4141" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4141" +ms.date: 11/04/2016 f1_keywords: ["C4141"] helpviewer_keywords: ["C4141"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md index 3adecd2d0b7..90f6cc10a7b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4142" title: "Compiler Warning (level 1) C4142" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4142" +ms.date: 11/04/2016 f1_keywords: ["C4142"] helpviewer_keywords: ["C4142"] -ms.assetid: 1fdfc3dc-60a2-4f00-b133-20e400f9b7a6 --- # Compiler Warning (level 1) C4142 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md index ddbff1223f0..d4e1d6c8ab3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4143" title: "Compiler Warning (level 1) C4143" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4143" +ms.date: 11/04/2016 f1_keywords: ["C4143"] helpviewer_keywords: ["same_seg", "C4143"] -ms.assetid: ef0bd19f-d169-4034-8710-b22971bd642d --- # Compiler Warning (level 1) C4143 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md index 431f47ec0a6..19e46906093 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4144" title: "Compiler Warning (level 1) C4144" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4144" +ms.date: 11/04/2016 f1_keywords: ["C4144"] helpviewer_keywords: ["C4144"] -ms.assetid: a37b445d-dbc6-43b4-8d95-ffd0e4225464 --- # Compiler Warning (level 1) C4144 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md index 80952508179..4ef4b5f5e37 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4145" title: "Compiler Warning (level 1) C4145" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4145" +ms.date: 11/04/2016 f1_keywords: ["C4145"] helpviewer_keywords: ["C4145"] -ms.assetid: 0440777a-cca2-4159-aff5-e67a254ad64a --- # Compiler Warning (level 1) C4145 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md index 5750044bffc..0f80d1e4c9d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4153" title: "Compiler Warning (level 1) C4153" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4153" +ms.date: 11/04/2016 f1_keywords: ["C4153"] helpviewer_keywords: ["C4153"] -ms.assetid: 37a15754-9dba-470b-adda-c4b888064b3e --- # Compiler Warning (level 1) C4153 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md index a73bab697c3..b679ae6652a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4154" title: "Compiler Warning (level 1) C4154" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4154" +ms.date: 11/04/2016 f1_keywords: ["C4154"] helpviewer_keywords: ["C4154"] -ms.assetid: 4511afeb-e893-4cc6-83b6-4c7a0477f76b --- # Compiler Warning (level 1) C4154 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md index 0f7d6b75b35..8ae584b843a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4155" title: "Compiler Warning (level 1) C4155" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4155" +ms.date: 11/04/2016 f1_keywords: ["C4155"] helpviewer_keywords: ["C4155"] -ms.assetid: ba233353-09e3-4195-8127-13a27ddd8d70 --- # Compiler Warning (level 1) C4155 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md index 4e38d3c717f..1f1864aff51 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4157" title: "Compiler Warning (level 1) C4157" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4157" +ms.date: 11/04/2016 f1_keywords: ["C4157"] helpviewer_keywords: ["C4157"] -ms.assetid: 6dabc303-eba1-4a8e-a124-a6e1dc84f4bd --- # Compiler Warning (level 1) C4157 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md index c65e899dc9e..72fbc895e57 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4158" title: "Compiler Warning (level 1) C4158" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4158" +ms.date: 11/04/2016 f1_keywords: ["C4158"] helpviewer_keywords: ["C4158"] -ms.assetid: 6513c6b9-6772-4849-b96c-5bb093d54de6 --- # Compiler Warning (level 1) C4158 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4160.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4160.md index a0765747a33..6eea80c6c9e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4160.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4160.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4160" title: "Compiler Warning (level 1) C4160" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4160" +ms.date: 08/27/2018 f1_keywords: ["C4160"] helpviewer_keywords: ["C4160"] -ms.assetid: a9610cb7-cac4-4a74-8b4e-049030ebb92b --- # Compiler Warning (level 1) C4160 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md index ec27d0f33ed..42ff1e16f22 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler warning (level 2) C4146" title: "Compiler warning (level 2) C4146" +description: "Learn more about: Compiler warning (level 2) C4146" ms.date: 04/22/2025 f1_keywords: ["C4146"] helpviewer_keywords: ["C4146"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md index 6f7148a40c2..4e373271a61 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md @@ -1,5 +1,5 @@ --- -title: Compiler warning (level 2) C4150 +title: "Compiler warning (level 2) C4150" description: "Learn more about: Compiler Warning (level 2) C4150" ms.date: 11/04/2016 f1_keywords: ["C4150"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md index ecd8359f2f8..713a9e37f6b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4156" title: "Compiler Warning (level 2) C4156" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4156" +ms.date: 11/04/2016 f1_keywords: ["C4156"] helpviewer_keywords: ["C4156"] -ms.assetid: 9adf3acb-c0fe-42a8-a4db-5822b1493f77 --- # Compiler Warning (level 2) C4156 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md index 63bb48405e0..adfd70c3826 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 3) C4133" title: "Compiler Warning (level 1 and level 3) C4133" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 3) C4133" +ms.date: 11/04/2016 f1_keywords: ["C4133"] helpviewer_keywords: ["C4133"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4159.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4159.md index 6f6a163564f..74670b18999 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4159.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4159.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4159" title: "Compiler Warning (level 3) C4159" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4159" +ms.date: 11/04/2016 f1_keywords: ["C4159"] helpviewer_keywords: ["C4159"] -ms.assetid: e2cf964e-f4b8-4b2c-9569-1abb94307232 --- # Compiler Warning (level 3) C4159 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md index 8e6537c60a2..0d8b34944c4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4121" title: "Compiler Warning (level 4) C4121" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4121" +ms.date: 11/04/2016 f1_keywords: ["C4121"] helpviewer_keywords: ["C4121"] -ms.assetid: 8c5b85c9-2543-426b-88bc-319c50158c7e --- # Compiler Warning (level 4) C4121 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md index 77dfb9bf83d..abf6edcc81f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4125" title: "Compiler Warning (level 4) C4125" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4125" +ms.date: 11/04/2016 f1_keywords: ["C4125"] helpviewer_keywords: ["C4125"] -ms.assetid: a081d1f4-0789-4915-91df-7ff0b28ca245 --- # Compiler Warning (level 4) C4125 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md index f7209eb1c00..b1187b11e15 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4127" title: "Compiler Warning (level 4) C4127" -ms.date: "10/16/2019" +description: "Learn more about: Compiler Warning (level 4) C4127" +ms.date: 10/16/2019 f1_keywords: ["C4127"] helpviewer_keywords: ["C4127"] -ms.assetid: f59ded9e-5227-45bd-ac43-2aa861581363 --- # Compiler Warning (level 4) C4127 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md index 5cb5302bb43..ab33396c73f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4130" title: "Compiler Warning (level 4) C4130" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4130" +ms.date: 11/04/2016 f1_keywords: ["C4130"] helpviewer_keywords: ["C4130"] -ms.assetid: 45e4c7b2-6b51-41c7-ba5e-941aa5c7d3dc --- # Compiler Warning (level 4) C4130 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md index 3619a5c469e..d02d901579d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4131" title: "Compiler Warning (level 4) C4131" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4131" +ms.date: 11/04/2016 f1_keywords: ["C4131"] helpviewer_keywords: ["C4131"] -ms.assetid: 7903b3e1-454f-4be2-aa9b-230992f96a2d --- # Compiler Warning (level 4) C4131 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md index 91a32db6a6a..a5cb7d8a4c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4132" title: "Compiler Warning (level 4) C4132" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4132" +ms.date: 11/04/2016 f1_keywords: ["C4132"] helpviewer_keywords: ["C4132"] -ms.assetid: b60e5b4a-53ac-4503-8456-235477f48afd --- # Compiler Warning (level 4) C4132 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md index ff1cf0669ea..de346a27ecd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4152" title: "Compiler Warning (level 4) C4152" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4152" +ms.date: 11/04/2016 f1_keywords: ["C4152"] helpviewer_keywords: ["C4152"] -ms.assetid: 6025ab70-d7cf-4730-913a-3ca0b1186a3a --- # Compiler Warning (level 4) C4152 From 6e99ee2b83f58c312e8f8ba3cea8714116a9f119 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:31:35 +0800 Subject: [PATCH 0979/1799] Add leading example sentence for warning references in range [C4121, C4160] --- .../compiler-warnings/compiler-warning-level-1-c4138.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4141.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4154.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4156.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4125.md | 2 ++ 5 files changed, 10 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md index 803962499b8..e6971ba8739 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md @@ -15,6 +15,8 @@ The closing-comment delimiter is not preceded by an opening-comment delimiter. T ## Example +The following example generates C4138: + ```cpp // C4138a.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md index 47e29f63e3e..7a38f03c082 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md @@ -11,6 +11,8 @@ helpviewer_keywords: ["C4141"] ## Example +The following example generates C4141: + ```cpp // C4141.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md index b679ae6652a..bd590178ea3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md @@ -15,6 +15,8 @@ You cannot use **`delete`** on an array, so the compiler converts the array to a ## Example +The following example generates C4154: + ```cpp // C4154.cpp // compile with: /c /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md index 713a9e37f6b..c72e3d2f1da 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md @@ -17,6 +17,8 @@ This warning occurs only under Microsoft extensions (/Ze). ## Example +The following example generates C4156: + ```cpp // C4156.cpp // compile with: /W2 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md index abf6edcc81f..78acc7ec0f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md @@ -15,6 +15,8 @@ The compiler evaluates the octal number without the decimal digit and assumes th ## Example +The following example generates C4125: + ```cpp // C4125a.cpp // compile with: /W4 From 6f182248c915d2569f7ee9522474995ce5a57587 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:39:39 +0800 Subject: [PATCH 0980/1799] Add blockquotes for warning messages in range [C4161, C4200] --- .../compiler-warnings/compiler-warning-level-1-c4162.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4163.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4164.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4165.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4166.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4167.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4168.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4174.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4175.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4176.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4177.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4178.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4180.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4182.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4183.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4185.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4186.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4187.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4190.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4192.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4197.md | 2 +- 21 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md index 151a1a95050..d1b550f00ca 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md @@ -8,7 +8,7 @@ ms.assetid: 21ae3c92-501d-4689-ad7d-13753cb65eff --- # Compiler Warning (level 1) C4162 -'identifier' : no function with C linkage found +> 'identifier' : no function with C linkage found A function with C linkage is declared but cannot be found. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md index b49a2aed3ae..296504df7bf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md @@ -8,7 +8,7 @@ ms.assetid: b08413fd-03fc-4f41-9167-a98976ac12f2 --- # Compiler Warning (level 1) C4163 -'identifier' : not available as an intrinsic function +> 'identifier' : not available as an intrinsic function The specified function cannot be used as an [intrinsic](../../preprocessor/intrinsic.md) function. The compiler ignores the invalid function name. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md index 37bbf267a15..a11317b8cac 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md @@ -8,6 +8,6 @@ ms.assetid: 6d7e4a36-8227-4419-880f-44576033493e --- # Compiler Warning (level 1) C4164 -'identifier' : intrinsic function not declared +> 'identifier' : intrinsic function not declared The specified intrinsic function is not declared; you may need to #include the appropriate header file. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md index aa851b63b8c..55b7a672aa7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4165"] --- # Compiler Warning (level 3, off) C4165 -'`HRESULT`' is being converted to '`bool`'; are you sure this is what you want? +> '`HRESULT`' is being converted to '`bool`'; are you sure this is what you want? When an `HRESULT` is used in an [`if`](../../cpp/if-else-statement-cpp.md) statement, the `HRESULT` is converted to a [`bool`](../../cpp/bool-cpp.md) unless you explicitly test for the variable as an `HRESULT`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md index 081a79b459b..2e87939fbe7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md @@ -8,6 +8,6 @@ ms.assetid: 4e5398a1-d913-4791-a470-06fc99c36ac5 --- # Compiler Warning (level 1) C4166 -**illegal calling convention for constructor/destructor** +> illegal calling convention for constructor/destructor Constructors and destructors cannot have calling conventions other than the default for the platform (except when you explicitly specify **__clrcall**). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md index ba1b58c8861..28fce69b39f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md @@ -8,7 +8,7 @@ ms.assetid: 74a420bd-9371-4167-b1ee-74dd8680f97b --- # Compiler Warning (level 1) C4167 -function : only available as an intrinsic function +> function : only available as an intrinsic function The **#pragma function** tries to force the compiler to use a conventional call to a function that must be used in intrinsic form. The pragma is ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md index 18cc19630d2..139bdaeb3a5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md @@ -8,6 +8,6 @@ ms.assetid: 1feefa6c-37be-4f7d-856e-f4b648f2fff8 --- # Compiler Warning (level 1) C4168 -compiler limit : out of debugger types, delete program database 'database' and rebuild +> compiler limit : out of debugger types, delete program database 'database' and rebuild The program database file must be rebuilt to accommodate all types in the program. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md index 4f3fdd7da9b..c08fe558bb3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md @@ -8,7 +8,7 @@ ms.assetid: 63301e51-24bc-43c4-bb11-252f7d513e9e --- # Compiler Warning (level 1) C4174 -'name' : not available as a #pragma component +> 'name' : not available as a #pragma component ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md index 5840c607830..dd1b10eb9b6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md @@ -8,6 +8,6 @@ ms.assetid: 11407a07-127c-4d0d-b262-61f9f2b035ba --- # Compiler Warning (level 1) C4175 -\#pragma component(browser, on) : browser info must initially be specified on the command line +> #pragma component(browser, on) : browser info must initially be specified on the command line To use [component](../../preprocessor/component.md) pragma, you must generate browse information during compilation ([/FR](../../build/reference/fr-fr-create-dot-sbr-file.md)). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md index 209b15d9bfc..caeaf192ba8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md @@ -8,7 +8,7 @@ ms.assetid: cfffb934-219a-4a63-9df6-ba54405bf766 --- # Compiler Warning (level 1) C4176 -'subcomponent' : unknown subcomponent for #pragma component browser +> 'subcomponent' : unknown subcomponent for #pragma component browser The **component** pragma contains an invalid subcomponent. To exclude references to a particular name, you must use the **references** option before the name. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md index d01e1cdba15..ccf420eee07 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md @@ -8,7 +8,7 @@ ms.assetid: 2b05a5b3-696e-4f21-818e-227b9335e748 --- # Compiler Warning (level 1) C4177 -\#pragma pragma should be at global scope +> #pragma pragma should be at global scope The [pragma](../../preprocessor/pragma-directives-and-the-pragma-keyword.md) pragma should not be used within a local scope. The **pragma** will not be valid until global scope is encountered after the current scope. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md index c3cf0473250..1d705be5f70 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4178"] --- # Compiler Warning (level 1) C4178 -case constant 'constant' too big for the type of the switch expression +> case constant 'constant' too big for the type of the switch expression A case constant in a **`switch`** expression does not fit in the type to which it is assigned. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md index c1134d1c3d7..39d5349981a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md @@ -8,7 +8,7 @@ ms.assetid: 40c91bd4-37f1-4d59-a4f3-d5ddab68239b --- # Compiler Warning (level 1) C4180 -qualifier applied to function type has no meaning; ignored +> qualifier applied to function type has no meaning; ignored A qualifier, such as **`const`**, is applied to a function type defined by **`typedef`**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md index 0983b499fa9..e222616fd65 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md @@ -8,7 +8,7 @@ ms.assetid: 8970f3c6-e2dd-407e-b2ec-964360eb8b43 --- # Compiler Warning (level 1) C4182 -\#include nesting level is 'number' deep; possible infinite recursion +> #include nesting level is 'number' deep; possible infinite recursion The compiler ran out of space on the heap because of the number of nested include files. An include file is nested when it is included from another include file. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md index 036ad1f925d..8ed313e482d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4183"] --- # Compiler Warning (level 1) C4183 -'identifier': missing return type; assumed to be a member function returning 'int' +> 'identifier': missing return type; assumed to be a member function returning 'int' The inline definition of a member function in a class or a structure does not have a return type. This member function is assumed to have a default return type of **`int`**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md index 92f1ada3b6b..260b88bbe15 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md @@ -8,7 +8,7 @@ ms.assetid: 37e7063a-35b1-4e05-ae31-e811dced02b9 --- # Compiler Warning (level 1) C4185 -ignoring unknown #import attribute 'attribute' +> ignoring unknown #import attribute 'attribute' The attribute is not a valid attribute of `#import`. It is ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md index 5e4248063e1..3364f436256 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md @@ -8,7 +8,7 @@ ms.assetid: caf3f7d8-f305-426b-8d4e-2b96f5c269ea --- # Compiler Warning (level 1) C4186 -\#import attribute 'attribute' requires count arguments; ignored +> #import attribute 'attribute' requires count arguments; ignored A `#import` attribute has the wrong number of arguments. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md index 7690c5eca1f..00e850cb0b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md @@ -8,6 +8,6 @@ ms.assetid: 2443d948-ab7b-472c-af43-5d81e09af677 --- # Compiler Warning (level 1) C4187 -\#import attributes 'attribute1' and 'attribute2' are incompatible; both ignored +> #import attributes 'attribute1' and 'attribute2' are incompatible; both ignored A [#import](../../preprocessor/hash-import-directive-cpp.md) statement specified `no_implementation` and `implementation_only` attributes. Both are ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md index 7870bbed65c..f162d392f5f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md @@ -8,7 +8,7 @@ ms.assetid: a4d0ad93-a19a-4063-addd-36d605831567 --- # Compiler Warning (level 1) C4190 -'identifier1' has C-linkage specified, but returns UDT 'identifier2' which is incompatible with C +> 'identifier1' has C-linkage specified, but returns UDT 'identifier2' which is incompatible with C A function or pointer to function has a UDT (user-defined type, which is a class, structure, enum, or union) as return type and `extern "C"` linkage. This is legal if: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md index 83450512bc4..a46f875bad2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md @@ -8,7 +8,7 @@ ms.assetid: ea5f91fa-8c96-4f3f-ac42-0c8a86d4e5df --- # Compiler Warning (level 3) C4192 -automatically excluding 'name' while importing type library 'library' +> automatically excluding 'name' while importing type library 'library' A `#import` library contains an item, *name*, that is also defined in the Win32 system headers. Due to limitations of type libraries, names such as **IUnknown** or GUID are often defined in a type library, duplicating the definition from the system headers. `#import` will detect these items and refuse to incorporate them in the .tlh and .tli header files. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md index d6fb5bfb8b8..9364ade2efb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md @@ -8,7 +8,7 @@ ms.assetid: f766feef-82b0-4d81-8a65-33628c7db196 --- # Compiler Warning (level 3) C4197 -'type' : top-level volatile in cast is ignored +> 'type' : top-level volatile in cast is ignored The compiler detected a cast to an r-value type which is qualified with [volatile](../../cpp/volatile-cpp.md), or a cast of an r-value type to some type that is qualified with volatile. According to the C standard (6.5.3), properties associated with qualified types are meaningful only for l-value expressions. From 2f791fd5cbd4f04366da2c0437207d7209aa1725 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:49:11 +0800 Subject: [PATCH 0981/1799] Add "Remarks" and "Example" headings for warning references in range [C4161, C4200] --- .../compiler-warning-level-1-c4162.md | 4 ++++ .../compiler-warning-level-1-c4163.md | 4 ++++ .../compiler-warning-level-1-c4164.md | 2 ++ .../compiler-warning-level-1-c4165.md | 2 ++ .../compiler-warning-level-1-c4166.md | 2 ++ .../compiler-warning-level-1-c4167.md | 2 ++ .../compiler-warning-level-1-c4168.md | 2 ++ .../compiler-warning-level-1-c4175.md | 2 ++ .../compiler-warning-level-1-c4176.md | 2 ++ .../compiler-warning-level-1-c4177.md | 4 ++++ .../compiler-warning-level-1-c4178.md | 2 ++ .../compiler-warning-level-1-c4179.md | 6 ++++-- .../compiler-warning-level-1-c4180.md | 2 ++ .../compiler-warning-level-1-c4182.md | 2 ++ .../compiler-warning-level-1-c4183.md | 4 ++++ .../compiler-warning-level-1-c4185.md | 2 ++ .../compiler-warning-level-1-c4186.md | 2 ++ .../compiler-warning-level-1-c4187.md | 2 ++ .../compiler-warning-level-1-c4190.md | 2 ++ .../compiler-warning-level-3-c4191.md | 4 ++++ .../compiler-warning-level-3-c4192.md | 2 ++ .../compiler-warning-level-3-c4197.md | 4 ++++ .../compiler-warning-level-4-c4189.md | 2 ++ .../compiler-warning-levels-2-and-4-c4200.md | 12 ++++++++---- 24 files changed, 68 insertions(+), 6 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md index d1b550f00ca..b2a993a4c48 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md @@ -10,10 +10,14 @@ ms.assetid: 21ae3c92-501d-4689-ad7d-13753cb65eff > 'identifier' : no function with C linkage found +## Remarks + A function with C linkage is declared but cannot be found. To resolve this warning, compile in a .c file (invoke the C compiler). If you must invoke the C++ compiler, place extern "C" before the function declaration. +## Example + The following sample generates C4162 ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md index 296504df7bf..e3342d6c129 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md @@ -10,8 +10,12 @@ ms.assetid: b08413fd-03fc-4f41-9167-a98976ac12f2 > 'identifier' : not available as an intrinsic function +## Remarks + The specified function cannot be used as an [intrinsic](../../preprocessor/intrinsic.md) function. The compiler ignores the invalid function name. +## Example + The following sample generates C4163: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md index a11317b8cac..0da8bb72db0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md @@ -10,4 +10,6 @@ ms.assetid: 6d7e4a36-8227-4419-880f-44576033493e > 'identifier' : intrinsic function not declared +## Remarks + The specified intrinsic function is not declared; you may need to #include the appropriate header file. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md index 55b7a672aa7..87b42a9775e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4165"] > '`HRESULT`' is being converted to '`bool`'; are you sure this is what you want? +## Remarks + When an `HRESULT` is used in an [`if`](../../cpp/if-else-statement-cpp.md) statement, the `HRESULT` is converted to a [`bool`](../../cpp/bool-cpp.md) unless you explicitly test for the variable as an `HRESULT`. Warning C4165 is off by default. For more information, see [Compiler Warnings That Are Off By Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md index 2e87939fbe7..3a54b26fb21 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md @@ -10,4 +10,6 @@ ms.assetid: 4e5398a1-d913-4791-a470-06fc99c36ac5 > illegal calling convention for constructor/destructor +## Remarks + Constructors and destructors cannot have calling conventions other than the default for the platform (except when you explicitly specify **__clrcall**). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md index 28fce69b39f..516cf094020 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md @@ -10,6 +10,8 @@ ms.assetid: 74a420bd-9371-4167-b1ee-74dd8680f97b > function : only available as an intrinsic function +## Remarks + The **#pragma function** tries to force the compiler to use a conventional call to a function that must be used in intrinsic form. The pragma is ignored. To avoid this warning, remove the **#pragma function**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md index 139bdaeb3a5..68a45057ba4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md @@ -10,4 +10,6 @@ ms.assetid: 1feefa6c-37be-4f7d-856e-f4b648f2fff8 > compiler limit : out of debugger types, delete program database 'database' and rebuild +## Remarks + The program database file must be rebuilt to accommodate all types in the program. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md index dd1b10eb9b6..f43bbfadc3f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md @@ -10,4 +10,6 @@ ms.assetid: 11407a07-127c-4d0d-b262-61f9f2b035ba > #pragma component(browser, on) : browser info must initially be specified on the command line +## Remarks + To use [component](../../preprocessor/component.md) pragma, you must generate browse information during compilation ([/FR](../../build/reference/fr-fr-create-dot-sbr-file.md)). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md index caeaf192ba8..da22fa4ecb6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md @@ -10,6 +10,8 @@ ms.assetid: cfffb934-219a-4a63-9df6-ba54405bf766 > 'subcomponent' : unknown subcomponent for #pragma component browser +## Remarks + The **component** pragma contains an invalid subcomponent. To exclude references to a particular name, you must use the **references** option before the name. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md index ccf420eee07..76fe83b8a54 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md @@ -10,8 +10,12 @@ ms.assetid: 2b05a5b3-696e-4f21-818e-227b9335e748 > #pragma pragma should be at global scope +## Remarks + The [pragma](../../preprocessor/pragma-directives-and-the-pragma-keyword.md) pragma should not be used within a local scope. The **pragma** will not be valid until global scope is encountered after the current scope. +## Example + The following sample generates C4177: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md index 1d705be5f70..2ec9fc71cc8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4178"] > case constant 'constant' too big for the type of the switch expression +## Remarks + A case constant in a **`switch`** expression does not fit in the type to which it is assigned. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md index 79ed15e5d51..b9d8ae7288d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md @@ -9,14 +9,16 @@ helpviewer_keywords: ["C4179"] > '`//*`' : parsed as '`/`' and '`/*`': confusion with standard '`//`' comments -In standard C89, **`//*`** is an incorrect comment delimiter. Use **`/*`** under **`/Za`** instead. - ## Remarks +In standard C89, **`//*`** is an incorrect comment delimiter. Use **`/*`** under **`/Za`** instead. + Before Visual Studio 2017 version 15.5, under **`/Za`**, the C compiler emits C4179 for a non-standard comment delimiter. In Visual Studio 2017 version 15.5, the C compiler no longer emits warnings C4001 and C4179. The warnings aren't needed because single-line comments have been part of the C standard since C99. +## Example + ```C /* C only */ #pragma warning(disable:4001) // C4619 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md index 39d5349981a..a55406722f9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md @@ -10,6 +10,8 @@ ms.assetid: 40c91bd4-37f1-4d59-a4f3-d5ddab68239b > qualifier applied to function type has no meaning; ignored +## Remarks + A qualifier, such as **`const`**, is applied to a function type defined by **`typedef`**. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md index e222616fd65..bcdfb36b59c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md @@ -10,6 +10,8 @@ ms.assetid: 8970f3c6-e2dd-407e-b2ec-964360eb8b43 > #include nesting level is 'number' deep; possible infinite recursion +## Remarks + The compiler ran out of space on the heap because of the number of nested include files. An include file is nested when it is included from another include file. This message is informational and precedes error [C1076](../../error-messages/compiler-errors-1/fatal-error-c1076.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md index 8ed313e482d..f95807d892d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C4183"] > 'identifier': missing return type; assumed to be a member function returning 'int' +## Remarks + The inline definition of a member function in a class or a structure does not have a return type. This member function is assumed to have a default return type of **`int`**. +## Example + The following sample generates C4183: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md index 260b88bbe15..5a19e934981 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md @@ -10,6 +10,8 @@ ms.assetid: 37e7063a-35b1-4e05-ae31-e811dced02b9 > ignoring unknown #import attribute 'attribute' +## Remarks + The attribute is not a valid attribute of `#import`. It is ignored. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md index 3364f436256..c883ecc28fa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md @@ -10,6 +10,8 @@ ms.assetid: caf3f7d8-f305-426b-8d4e-2b96f5c269ea > #import attribute 'attribute' requires count arguments; ignored +## Remarks + A `#import` attribute has the wrong number of arguments. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md index 00e850cb0b1..e9065512d84 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md @@ -10,4 +10,6 @@ ms.assetid: 2443d948-ab7b-472c-af43-5d81e09af677 > #import attributes 'attribute1' and 'attribute2' are incompatible; both ignored +## Remarks + A [#import](../../preprocessor/hash-import-directive-cpp.md) statement specified `no_implementation` and `implementation_only` attributes. Both are ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md index f162d392f5f..e2ed5d5c006 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md @@ -10,6 +10,8 @@ ms.assetid: a4d0ad93-a19a-4063-addd-36d605831567 > 'identifier1' has C-linkage specified, but returns UDT 'identifier2' which is incompatible with C +## Remarks + A function or pointer to function has a UDT (user-defined type, which is a class, structure, enum, or union) as return type and `extern "C"` linkage. This is legal if: - All calls to this function occur from C++. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md index 46b90ba9e27..4b165e9a742 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4191"] > '*operation*': unsafe conversion from '*type_of_expression*' to '*type_required*'
Making a function call using the resulting pointer may cause your program to fail +## Remarks + Several operations involving function pointers are considered unsafe: - Function types with different calling conventions. @@ -27,6 +29,8 @@ Calling this function through the result pointer might cause your program to cra 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 + The following sample generates C4191: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md index a46f875bad2..9a985f673fc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md @@ -10,6 +10,8 @@ ms.assetid: ea5f91fa-8c96-4f3f-ac42-0c8a86d4e5df > automatically excluding 'name' while importing type library 'library' +## Remarks + A `#import` library contains an item, *name*, that is also defined in the Win32 system headers. Due to limitations of type libraries, names such as **IUnknown** or GUID are often defined in a type library, duplicating the definition from the system headers. `#import` will detect these items and refuse to incorporate them in the .tlh and .tli header files. To override this behavior, use `#import` attributes [no_auto_exclude](../../preprocessor/no-auto-exclude.md) and [include()](../../preprocessor/include-parens.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md index 9364ade2efb..fcb7b9a3102 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md @@ -10,8 +10,12 @@ ms.assetid: f766feef-82b0-4d81-8a65-33628c7db196 > 'type' : top-level volatile in cast is ignored +## Remarks + The compiler detected a cast to an r-value type which is qualified with [volatile](../../cpp/volatile-cpp.md), or a cast of an r-value type to some type that is qualified with volatile. According to the C standard (6.5.3), properties associated with qualified types are meaningful only for l-value expressions. +## Example + The following sample generates C4197: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md index 6376aebe9d6..eb4c9402f34 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4189"] > '*identifier*' : local variable is initialized but not referenced +## Remarks + A variable is declared and initialized but not used. ## Examples diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md index 309f2b0317e..d71805c10d6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md @@ -11,8 +11,14 @@ helpviewer_keywords: ["C4200"] C++ only: > This member will be ignored by a defaulted constructor or copy/move assignment operator - -This warning indicates that a structure or union contains an array that has zero size. Declaration of a zero-sized array is a nonstandard compiler extension. This causes a Level-2 warning when a C++ file is compiled and a Level-4 warning when a C file is compiled. This example generates warning C4200: + +## Remarks + +This warning indicates that a structure or union contains an array that has zero size. Declaration of a zero-sized array is a nonstandard compiler extension. This causes a Level-2 warning when a C++ file is compiled and a Level-4 warning when a C file is compiled. + +## Example + +This example generates warning C4200: ```cpp // C4200.cpp @@ -25,8 +31,6 @@ struct A { This nonstandard extension is often used to interface code with external data structures that have a variable length. If this scenario applies to your code, you can disable the warning: -## Example - ```cpp // C4200b.cpp // compile by using: cl /W4 c4200a.cpp From b31f1e7d33ead6392708094f0ac139316854f35c Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:50:03 +0800 Subject: [PATCH 0982/1799] Replace term "sample" with "example" for warning references in range [C4161, C4200] --- .../compiler-warnings/compiler-warning-level-1-c4162.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4163.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4165.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4177.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4183.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4191.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4197.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4189.md | 2 +- 8 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md index b2a993a4c48..c78a6d46ea1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md @@ -18,7 +18,7 @@ To resolve this warning, compile in a .c file (invoke the C compiler). If you m ## Example -The following sample generates C4162 +The following example generates C4162 ```cpp // C4162.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md index e3342d6c129..d838a3227e8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md @@ -16,7 +16,7 @@ The specified function cannot be used as an [intrinsic](../../preprocessor/intri ## Example -The following sample generates C4163: +The following example generates C4163: ```cpp // C4163.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md index 87b42a9775e..d37b9c43235 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md @@ -17,7 +17,7 @@ Warning C4165 is off by default. For more information, see [Compiler Warnings Th ## Example -The following sample generates C4165: +The following example generates C4165: ```cpp // C4165.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md index 76fe83b8a54..3bc3f0fc113 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md @@ -16,7 +16,7 @@ The [pragma](../../preprocessor/pragma-directives-and-the-pragma-keyword.md) pra ## Example -The following sample generates C4177: +The following example generates C4177: ```cpp // C4177.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md index f95807d892d..1b3233348c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md @@ -15,7 +15,7 @@ The inline definition of a member function in a class or a structure does not ha ## Example -The following sample generates C4183: +The following example generates C4183: ```cpp // C4183.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md index 4b165e9a742..db68e28e735 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md @@ -31,7 +31,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4191: +The following example generates C4191: ```cpp // C4191.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md index fcb7b9a3102..8d0971d968b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md @@ -16,7 +16,7 @@ The compiler detected a cast to an r-value type which is qualified with [volatil ## Example -The following sample generates C4197: +The following example generates C4197: ```cpp // C4197.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md index eb4c9402f34..ea93509e677 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md @@ -15,7 +15,7 @@ A variable is declared and initialized but not used. ## Examples -The following sample generates C4189: +The following example generates C4189: ```cpp // C4189.cpp From 12710cb4434d10abd988c78dfb7ecc28137d3ae7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:53:52 +0800 Subject: [PATCH 0983/1799] Update metadata for warning references in range [C4161, C4200] --- .../compiler-warnings/compiler-warning-level-1-c4162.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4163.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4164.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4165.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4166.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4167.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4168.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4174.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4175.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4176.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4177.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4178.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4179.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4180.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4182.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4185.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4186.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4187.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4190.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4161.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4192.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4197.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4189.md | 2 +- .../compiler-warning-levels-2-and-4-c4200.md | 4 ++-- 24 files changed, 46 insertions(+), 65 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md index c78a6d46ea1..e48b464d475 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4162" title: "Compiler Warning (level 1) C4162" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4162" +ms.date: 11/04/2016 f1_keywords: ["C4162"] helpviewer_keywords: ["C4162"] -ms.assetid: 21ae3c92-501d-4689-ad7d-13753cb65eff --- # Compiler Warning (level 1) C4162 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md index d838a3227e8..a66c5cf9508 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4163" title: "Compiler Warning (level 1) C4163" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4163" +ms.date: 11/04/2016 f1_keywords: ["C4163"] helpviewer_keywords: ["C4163"] -ms.assetid: b08413fd-03fc-4f41-9167-a98976ac12f2 --- # Compiler Warning (level 1) C4163 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md index 0da8bb72db0..ba0cc3fa68d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4164" title: "Compiler Warning (level 1) C4164" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4164" +ms.date: 11/04/2016 f1_keywords: ["C4164"] helpviewer_keywords: ["C4164"] -ms.assetid: 6d7e4a36-8227-4419-880f-44576033493e --- # Compiler Warning (level 1) C4164 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md index d37b9c43235..eb54234ee06 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4165" title: "Compiler Warning (level 3, off) C4165" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3, off) C4165" +ms.date: 11/04/2016 f1_keywords: ["C4165"] helpviewer_keywords: ["C4165"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md index 3a54b26fb21..b3b8268a78d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4166" title: "Compiler Warning (level 1) C4166" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4166" +ms.date: 11/04/2016 f1_keywords: ["C4166"] helpviewer_keywords: ["C4166"] -ms.assetid: 4e5398a1-d913-4791-a470-06fc99c36ac5 --- # Compiler Warning (level 1) C4166 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md index 516cf094020..9eaabdff17a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4167" title: "Compiler Warning (level 1) C4167" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4167" +ms.date: 11/04/2016 f1_keywords: ["C4167"] helpviewer_keywords: ["C4167"] -ms.assetid: 74a420bd-9371-4167-b1ee-74dd8680f97b --- # Compiler Warning (level 1) C4167 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md index 68a45057ba4..6c487ba5d60 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4168" title: "Compiler Warning (level 1) C4168" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4168" +ms.date: 11/04/2016 f1_keywords: ["C4168"] helpviewer_keywords: ["C4168"] -ms.assetid: 1feefa6c-37be-4f7d-856e-f4b648f2fff8 --- # Compiler Warning (level 1) C4168 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md index c08fe558bb3..98c2e64583a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4174" title: "Compiler Warning (level 1) C4174" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4174" +ms.date: 11/04/2016 f1_keywords: ["C4174"] helpviewer_keywords: ["C4174"] -ms.assetid: 63301e51-24bc-43c4-bb11-252f7d513e9e --- # Compiler Warning (level 1) C4174 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md index f43bbfadc3f..275c235f0b5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4175" title: "Compiler Warning (level 1) C4175" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4175" +ms.date: 11/04/2016 f1_keywords: ["C4175"] helpviewer_keywords: ["C4175"] -ms.assetid: 11407a07-127c-4d0d-b262-61f9f2b035ba --- # Compiler Warning (level 1) C4175 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md index da22fa4ecb6..806bd926e46 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4176" title: "Compiler Warning (level 1) C4176" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4176" +ms.date: 11/04/2016 f1_keywords: ["C4176"] helpviewer_keywords: ["C4176"] -ms.assetid: cfffb934-219a-4a63-9df6-ba54405bf766 --- # Compiler Warning (level 1) C4176 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md index 3bc3f0fc113..39115e3e153 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4177" title: "Compiler Warning (level 1) C4177" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4177" +ms.date: 11/04/2016 f1_keywords: ["C4177"] helpviewer_keywords: ["C4177"] -ms.assetid: 2b05a5b3-696e-4f21-818e-227b9335e748 --- # Compiler Warning (level 1) C4177 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md index 2ec9fc71cc8..fa906e4c307 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4178" title: "Compiler Warning (level 1) C4178" -ms.date: "03/06/2024" +description: "Learn more about: Compiler Warning (level 1) C4178" +ms.date: 03/06/2024 f1_keywords: ["C4178"] helpviewer_keywords: ["C4178"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md index b9d8ae7288d..0879a3954fb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4179" title: "Compiler Warning (level 1) C4179" +description: "Learn more about: Compiler Warning (level 1) C4179" ms.date: 05/03/2021 f1_keywords: ["C4179"] helpviewer_keywords: ["C4179"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md index a55406722f9..160f95493bb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4180" title: "Compiler Warning (level 1) C4180" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4180" +ms.date: 11/04/2016 f1_keywords: ["C4180"] helpviewer_keywords: ["C4180"] -ms.assetid: 40c91bd4-37f1-4d59-a4f3-d5ddab68239b --- # Compiler Warning (level 1) C4180 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md index bcdfb36b59c..c5097e114ba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4182" title: "Compiler Warning (level 1) C4182" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4182" +ms.date: 11/04/2016 f1_keywords: ["C4182"] helpviewer_keywords: ["C4182"] -ms.assetid: 8970f3c6-e2dd-407e-b2ec-964360eb8b43 --- # Compiler Warning (level 1) C4182 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md index 5a19e934981..4b01a193675 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4185" title: "Compiler Warning (level 1) C4185" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4185" +ms.date: 11/04/2016 f1_keywords: ["C4185"] helpviewer_keywords: ["C4185"] -ms.assetid: 37e7063a-35b1-4e05-ae31-e811dced02b9 --- # Compiler Warning (level 1) C4185 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md index c883ecc28fa..d7d6ac5575e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4186" title: "Compiler Warning (level 1) C4186" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4186" +ms.date: 11/04/2016 f1_keywords: ["C4186"] helpviewer_keywords: ["C4186"] -ms.assetid: caf3f7d8-f305-426b-8d4e-2b96f5c269ea --- # Compiler Warning (level 1) C4186 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md index e9065512d84..8ff6b94d85c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4187" title: "Compiler Warning (level 1) C4187" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4187" +ms.date: 11/04/2016 f1_keywords: ["C4187"] helpviewer_keywords: ["C4187"] -ms.assetid: 2443d948-ab7b-472c-af43-5d81e09af677 --- # Compiler Warning (level 1) C4187 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md index e2ed5d5c006..347bbbc607a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4190" title: "Compiler Warning (level 1) C4190" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4190" +ms.date: 11/04/2016 f1_keywords: ["C4190"] helpviewer_keywords: ["C4190"] -ms.assetid: a4d0ad93-a19a-4063-addd-36d605831567 --- # Compiler Warning (level 1) C4190 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4161.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4161.md index c38bf184951..672a08b13f6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4161.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4161.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4161" title: "Compiler Warning (level 3) C4161" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 3) C4161" +ms.date: 08/27/2018 f1_keywords: ["C4161"] helpviewer_keywords: ["C4161"] -ms.assetid: 03d3be61-83f1-4009-8310-8758ab67055f --- # Compiler Warning (level 3) C4161 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md index 9a985f673fc..c02e74aba58 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4192" title: "Compiler Warning (level 3) C4192" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4192" +ms.date: 11/04/2016 f1_keywords: ["C4192"] helpviewer_keywords: ["C4192"] -ms.assetid: ea5f91fa-8c96-4f3f-ac42-0c8a86d4e5df --- # Compiler Warning (level 3) C4192 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md index 8d0971d968b..4fabcf299da 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4197" title: "Compiler Warning (level 3) C4197" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4197" +ms.date: 11/04/2016 f1_keywords: ["C4197"] helpviewer_keywords: ["C4197"] -ms.assetid: f766feef-82b0-4d81-8a65-33628c7db196 --- # Compiler Warning (level 3) C4197 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md index ea93509e677..93423778f89 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 3 and level 4) C4189" title: "Compiler Warning (level 3 and level 4) C4189" +description: "Learn more about: Compiler Warning (level 3 and level 4) C4189" ms.date: 05/03/2021 f1_keywords: ["C4189"] helpviewer_keywords: ["C4189"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md index d71805c10d6..b02bcecf7c6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 2 and level 4) C4200" title: "Compiler Warning (level 2 and level 4) C4200" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2 and level 4) C4200" +ms.date: 11/04/2016 f1_keywords: ["C4200"] helpviewer_keywords: ["C4200"] --- From d8ab280e3b7da8b16beba86facbb129b555188a7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Tue, 26 Aug 2025 23:58:58 +0800 Subject: [PATCH 0984/1799] Add leading example sentence for warning references in range [C4161, C4200] --- .../compiler-warnings/compiler-warning-level-1-c4167.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4174.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4176.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4178.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4179.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4180.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4185.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4186.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4190.md | 2 ++ 9 files changed, 18 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md index 9eaabdff17a..4ab61233a5d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md @@ -17,6 +17,8 @@ To avoid this warning, remove the **#pragma function**. ## Example +The following example generates C4167: + ```cpp // C4167.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md index 98c2e64583a..7f02878573c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md @@ -11,6 +11,8 @@ helpviewer_keywords: ["C4174"] ## Example +The following example generates C4174: + ```cpp // C4174.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md index 806bd926e46..22aa2aa22bd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md @@ -15,6 +15,8 @@ The **component** pragma contains an invalid subcomponent. To exclude references ## Example +The following example generates C4176: + ```cpp // C4176.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md index fa906e4c307..9500322b58e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md @@ -15,6 +15,8 @@ A case constant in a **`switch`** expression does not fit in the type to which i ## Example +The following example generates C4178: + ```cpp // C4178.cpp // compile with: /W1 /permissive diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md index 0879a3954fb..7ee0442c813 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md @@ -19,6 +19,8 @@ In Visual Studio 2017 version 15.5, the C compiler no longer emits warnings C400 ## Example +The following example generates C4179: + ```C /* C only */ #pragma warning(disable:4001) // C4619 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md index 160f95493bb..e29467a8dea 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md @@ -15,6 +15,8 @@ A qualifier, such as **`const`**, is applied to a function type defined by **`ty ## Example +The following example generates C4180: + ```cpp // C4180.cpp // compile with: /W1 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md index 4b01a193675..d2bfec209ad 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md @@ -15,6 +15,8 @@ The attribute is not a valid attribute of `#import`. It is ignored. ## Example +The following example generates C4185: + ```cpp // C4185.cpp // compile with: /W1 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md index d7d6ac5575e..0f6985e5d1a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md @@ -15,6 +15,8 @@ A `#import` attribute has the wrong number of arguments. ## Example +The following example generates C4186: + ```cpp // C4186.cpp // compile with: /W1 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md index 347bbbc607a..57257424bda 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md @@ -19,6 +19,8 @@ A function or pointer to function has a UDT (user-defined type, which is a class ## Example +The following example generates C4190: + ```cpp // C4190.cpp // compile with: /W1 /LD From 0706b94de89cd3608528f0b3b3da5792d3004246 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 16:22:45 +0800 Subject: [PATCH 0985/1799] Add blockquotes for warning messages in range [C4201, C4230] --- .../compiler-warnings/compiler-warning-level-1-c4215.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4216.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4224.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4227.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4228.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4230.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4201.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4202.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4204.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4205.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4206.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4207.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4208.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4210.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4211.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4212.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4213.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4214.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4220.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4221.md | 2 +- 20 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md index ee07bacbca1..611ae2ea71f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md @@ -8,7 +8,7 @@ ms.assetid: f2aab64d-1bab-4f75-95ee-89e1263047b1 --- # Compiler Warning (level 1) C4215 -nonstandard extension used : long float +> nonstandard extension used : long float The default Microsoft extensions (/Ze) treat **long float** as **`double`**. ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) does not. Use **`double`** to maintain compatibility. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md index 26fd546e18b..6fb679b8158 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md @@ -8,7 +8,7 @@ ms.assetid: 211079dc-59d0-42a7-801c-2ddab21d7232 --- # Compiler Warning (level 1) C4216 -nonstandard extension used : float long +> nonstandard extension used : float long The default Microsoft extensions (/Ze) treat **float long** as **`double`**. ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) does not. Use **`double`** to maintain compatibility. The following sample generates C4216: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md index 58abd03fe9a..698a1f15405 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md @@ -8,7 +8,7 @@ ms.assetid: 1531cae0-5040-49fd-b149-005bb5085391 --- # Compiler Warning (level 1) C4224 -nonstandard extension used : formal parameter 'identifier' was previously defined as a type +> nonstandard extension used : formal parameter 'identifier' was previously defined as a type The identifier was previously used as a **`typedef`**. This causes a warning under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md index b07ac66855a..fc84a659e73 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md @@ -8,7 +8,7 @@ ms.assetid: 78f98374-c00b-4000-aefa-1b1c67b4666b --- # Compiler Warning (level 1) C4227 -anachronism used : qualifiers on reference are ignored +> anachronism used : qualifiers on reference are ignored Using qualifiers like **`const`** or **`volatile`** with C++ references is an outdated practice. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md index 9d10d770f9b..ade6ef74062 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md @@ -8,7 +8,7 @@ ms.assetid: 9301d660-d601-464e-83f5-7ed844a3c6dc --- # Compiler Warning (level 1) C4228 -nonstandard extension used : qualifiers after comma in declarator list are ignored +> nonstandard extension used : qualifiers after comma in declarator list are ignored Use of qualifiers like **`const`** or **`volatile`** after a comma when declaring variables is a Microsoft extension ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md index 0365bac51a4..17ee500a8ed 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md @@ -8,7 +8,7 @@ ms.assetid: a4be8729-74b6-44df-a5ea-e3f45aad0f8f --- # Compiler Warning (level 1) C4230 -anachronism used : modifiers/qualifiers interspersed; qualifier ignored +> anachronism used : modifiers/qualifiers interspersed; qualifier ignored Using a qualifier before a Microsoft modifier such as **`__cdecl`** is an outdated practice. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md index 1486e4023c5..cd6e7999f87 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md @@ -8,7 +8,7 @@ ms.assetid: 6156f508-9393-4d77-9e73-1ec3e1c32d0d --- # Compiler Warning (level 4) C4201 -nonstandard extension used : nameless struct/union +> nonstandard extension used : nameless struct/union Under Microsoft extensions (/Ze), you can specify a structure without a declarator as members of another structure or union. These structures generate an error under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md index 4e740e1cfd7..1baa24d0a74 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md @@ -8,7 +8,7 @@ ms.assetid: 253293aa-97a3-4878-a2e8-c6cc9e20b1cb --- # Compiler Warning (level 4) C4202 -nonstandard extension used : '...': prototype parameter in name list illegal +> nonstandard extension used : '...': prototype parameter in name list illegal An old-style function definition contains variable arguments. These definitions generate an error under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md index 6b59366825f..6d951bbf2e4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md @@ -8,7 +8,7 @@ ms.assetid: 298d2880-6737-448e-b711-15572d540200 --- # Compiler Warning (level 4) C4204 -nonstandard extension used : non-constant aggregate initializer +> nonstandard extension used : non-constant aggregate initializer With Microsoft extensions (/Ze), you can initialize aggregate types (arrays, structures, unions, and classes) with values that are not constants. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md index 2deee615616..6247f462fbd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4205"] --- # Compiler Warning (level 4) C4205 -nonstandard extension used : static function declaration in function scope +> nonstandard extension used : static function declaration in function scope With Microsoft extensions (/Ze), **`static`** functions can be declared inside another function. The function is given global scope. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md index 524ca3cc46d..5904b77adcd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md @@ -8,7 +8,7 @@ ms.assetid: 3df97812-3ed7-4003-9769-057acf97ce3c --- # Compiler Warning (level 4) C4206 -**nonstandard extension used : translation unit is empty** +> nonstandard extension used : translation unit is empty The file was empty after preprocessing. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md index 42e3e542084..d9c83956eff 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md @@ -8,7 +8,7 @@ ms.assetid: f4e09e3e-ac87-4489-8e3f-c8f76b82e721 --- # Compiler Warning (level 4) C4207 -nonstandard extension used : extended initializer form +> nonstandard extension used : extended initializer form With Microsoft extensions (/Ze), you can initialize an unsized array of **`char`** using a string within braces. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md index 401c638542e..ecb1acaa70f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md @@ -8,7 +8,7 @@ ms.assetid: 5cb0a36e-3fb5-422f-a5f9-e40b70776c27 --- # Compiler Warning (level 4) C4208 -nonstandard extension used : delete [exp] - exp evaluated but ignored +> nonstandard extension used : delete [exp] - exp evaluated but ignored With Microsoft extensions (/Ze), you can delete an array using a value within brackets with the [delete operator](../../cpp/delete-operator-cpp.md). The value is ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md index ba96a096f66..f51d8a00630 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md @@ -8,7 +8,7 @@ ms.assetid: f8600adf-dfe2-4022-a37a-3d4997641dfd --- # Compiler Warning (level 4) C4210 -nonstandard extension used : function given file scope +> nonstandard extension used : function given file scope With the default Microsoft extensions ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)), function declarations have file scope. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md index 59e1af613ce..fed09cd29fc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md @@ -8,7 +8,7 @@ ms.assetid: 3eea3455-6faa-4cdb-8730-73db7026bd1f --- # Compiler Warning (level 4) C4211 -nonstandard extension used : redefined extern to static +> nonstandard extension used : redefined extern to static With the default Microsoft extensions (/Ze), you can redefine an **`extern`** identifier as **`static`**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md index d780d7bba34..f29166fef62 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md @@ -8,7 +8,7 @@ ms.assetid: df781ea1-182d-4f9f-9a31-55b6ce80c711 --- # Compiler Warning (level 4) C4212 -nonstandard extension used : function declaration used ellipsis +> nonstandard extension used : function declaration used ellipsis The function prototype has a variable number of arguments. The function definition does not. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md index e36443c5d57..7957d269af4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md @@ -8,7 +8,7 @@ ms.assetid: 59fc3f61-ebd2-499e-99d7-f57bec11eda1 --- # Compiler Warning (level 4) C4213 -nonstandard extension used : cast on l-value +> nonstandard extension used : cast on l-value With the default Microsoft extensions (/Ze), you can use casts on the left side of an assignment statement. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md index 06fb277525e..5b1a37166d5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md @@ -8,7 +8,7 @@ ms.assetid: 9b8db279-1f12-4a6b-a923-2db22acd1947 --- # Compiler Warning (level 4) C4214 -nonstandard extension used : bit field types other than int +> nonstandard extension used : bit field types other than int With the default Microsoft extensions (/Ze), bitfield structure members can be of any integer type. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md index dd344270a6b..4733a5d89cc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4220"] --- # Compiler Warning (level 4) C4220 -varargs matches remaining parameters +> varargs matches remaining parameters Under the default Microsoft extensions (/Ze), a pointer to a function matches a pointer to a function with similar, but variable, arguments. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md index e88f2068aa2..c350cd2736f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md @@ -8,7 +8,7 @@ ms.assetid: 8532bd68-54dc-4526-8597-f61dcb0a0129 --- # Compiler Warning (level 4) C4221 -nonstandard extension used : 'identifier' : cannot be initialized using address of automatic variable +> nonstandard extension used : 'identifier' : cannot be initialized using address of automatic variable With the default Microsoft extensions (/Ze), you can initialize an aggregate type (**array**, **`struct`**, or **`union`**) with the address of a local (automatic) variable. From 7a6e4301979ed4d733fea1112441fce784d176c8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 16:29:17 +0800 Subject: [PATCH 0986/1799] Add "Remarks" and "Example" headings for warning references in range [C4201, C4230] --- .../compiler-warnings/compiler-warning-level-1-c4215.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4216.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4218.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4224.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4226.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4227.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4228.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4229.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4230.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4201.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4202.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4204.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4205.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4206.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4207.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4208.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4210.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4211.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4212.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4213.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4214.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4220.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4221.md | 2 ++ .../compiler-warning-levels-1-and-4-c4223.md | 2 ++ 24 files changed, 61 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md index 611ae2ea71f..2b08ace8092 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md @@ -10,8 +10,12 @@ ms.assetid: f2aab64d-1bab-4f75-95ee-89e1263047b1 > nonstandard extension used : long float +## Remarks + The default Microsoft extensions (/Ze) treat **long float** as **`double`**. ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) does not. Use **`double`** to maintain compatibility. +## Example + The following sample generates C4215: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md index 6fb679b8158..ff2d742ca42 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md @@ -10,7 +10,13 @@ ms.assetid: 211079dc-59d0-42a7-801c-2ddab21d7232 > nonstandard extension used : float long -The default Microsoft extensions (/Ze) treat **float long** as **`double`**. ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) does not. Use **`double`** to maintain compatibility. The following sample generates C4216: +## Remarks + +The default Microsoft extensions (/Ze) treat **float long** as **`double`**. ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) does not. Use **`double`** to maintain compatibility. + +## Example + +The following sample generates C4216: ```cpp // C4216.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md index 510c44d4b9f..35c46088620 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4218"] > nonstandard extension used: must specify at least a storage class or a type +## Remarks + With the default Microsoft extensions (`/Ze`), you can declare a variable without specifying a type or storage class. The default type is **`int`**. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md index 698a1f15405..64615700d5a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md @@ -10,6 +10,8 @@ ms.assetid: 1531cae0-5040-49fd-b149-005bb5085391 > nonstandard extension used : formal parameter 'identifier' was previously defined as a type +## Remarks + The identifier was previously used as a **`typedef`**. This causes a warning under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md index 8861456c970..137d08d0911 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md @@ -10,6 +10,8 @@ ms.assetid: 69d6bbde-1300-4e48-8a9c-3648c80ab441 > nonstandard extension used : '*keyword*' is an obsolete keyword +## Remarks + The current version of Visual C++ does not use this keyword. This warning is automatically promoted to an error. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md index fc84a659e73..89220690752 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md @@ -10,6 +10,8 @@ ms.assetid: 78f98374-c00b-4000-aefa-1b1c67b4666b > anachronism used : qualifiers on reference are ignored +## Remarks + Using qualifiers like **`const`** or **`volatile`** with C++ references is an outdated practice. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md index ade6ef74062..60822f04f80 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md @@ -10,6 +10,8 @@ ms.assetid: 9301d660-d601-464e-83f5-7ed844a3c6dc > nonstandard extension used : qualifiers after comma in declarator list are ignored +## Remarks + Use of qualifiers like **`const`** or **`volatile`** after a comma when declaring variables is a Microsoft extension ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md index d79edef4c85..9a0581bf9a9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4229"] > anachronism used: modifiers on data are ignored +## Remarks + Using a Microsoft modifier such as **`__cdecl`** on a data declaration is an outdated practice. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md index 17ee500a8ed..11d63a99713 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md @@ -10,6 +10,8 @@ ms.assetid: a4be8729-74b6-44df-a5ea-e3f45aad0f8f > anachronism used : modifiers/qualifiers interspersed; qualifier ignored +## Remarks + Using a qualifier before a Microsoft modifier such as **`__cdecl`** is an outdated practice. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md index cd6e7999f87..87fb3669b19 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md @@ -10,6 +10,8 @@ ms.assetid: 6156f508-9393-4d77-9e73-1ec3e1c32d0d > nonstandard extension used : nameless struct/union +## Remarks + Under Microsoft extensions (/Ze), you can specify a structure without a declarator as members of another structure or union. These structures generate an error under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md index 1baa24d0a74..7358e82d10d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md @@ -10,6 +10,8 @@ ms.assetid: 253293aa-97a3-4878-a2e8-c6cc9e20b1cb > nonstandard extension used : '...': prototype parameter in name list illegal +## Remarks + An old-style function definition contains variable arguments. These definitions generate an error under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md index 6d951bbf2e4..20e8ffda1d8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md @@ -10,6 +10,8 @@ ms.assetid: 298d2880-6737-448e-b711-15572d540200 > nonstandard extension used : non-constant aggregate initializer +## Remarks + With Microsoft extensions (/Ze), you can initialize aggregate types (arrays, structures, unions, and classes) with values that are not constants. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md index 6247f462fbd..43b39be6d8c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4205"] > nonstandard extension used : static function declaration in function scope +## Remarks + With Microsoft extensions (/Ze), **`static`** functions can be declared inside another function. The function is given global scope. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md index 5904b77adcd..1fa98e95fdb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md @@ -10,6 +10,8 @@ ms.assetid: 3df97812-3ed7-4003-9769-057acf97ce3c > nonstandard extension used : translation unit is empty +## Remarks + The file was empty after preprocessing. This extension can prevent your code from being portable to other compilers. It generates an error under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) and only applies to C source code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md index d9c83956eff..eb75b63b003 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md @@ -10,6 +10,8 @@ ms.assetid: f4e09e3e-ac87-4489-8e3f-c8f76b82e721 > nonstandard extension used : extended initializer form +## Remarks + With Microsoft extensions (/Ze), you can initialize an unsized array of **`char`** using a string within braces. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md index ecb1acaa70f..63bb80530b5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md @@ -10,8 +10,12 @@ ms.assetid: 5cb0a36e-3fb5-422f-a5f9-e40b70776c27 > nonstandard extension used : delete [exp] - exp evaluated but ignored +## Remarks + With Microsoft extensions (/Ze), you can delete an array using a value within brackets with the [delete operator](../../cpp/delete-operator-cpp.md). The value is ignored. +## Example + ```cpp // C4208.cpp // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md index f51d8a00630..3c3e2e765db 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md @@ -10,8 +10,12 @@ ms.assetid: f8600adf-dfe2-4022-a37a-3d4997641dfd > nonstandard extension used : function given file scope +## Remarks + With the default Microsoft extensions ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)), function declarations have file scope. +## Example + ```c // C4210.c // compile with: /W4 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md index fed09cd29fc..1ef53b5e5aa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md @@ -10,6 +10,8 @@ ms.assetid: 3eea3455-6faa-4cdb-8730-73db7026bd1f > nonstandard extension used : redefined extern to static +## Remarks + With the default Microsoft extensions (/Ze), you can redefine an **`extern`** identifier as **`static`**. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md index f29166fef62..725f7236d8e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md @@ -10,8 +10,12 @@ ms.assetid: df781ea1-182d-4f9f-9a31-55b6ce80c711 > nonstandard extension used : function declaration used ellipsis +## Remarks + The function prototype has a variable number of arguments. The function definition does not. +## Example + The following sample generates C4212: ```c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md index 7957d269af4..16d5148d500 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md @@ -10,6 +10,8 @@ ms.assetid: 59fc3f61-ebd2-499e-99d7-f57bec11eda1 > nonstandard extension used : cast on l-value +## Remarks + With the default Microsoft extensions (/Ze), you can use casts on the left side of an assignment statement. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md index 5b1a37166d5..9df5b76c9a8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md @@ -10,6 +10,8 @@ ms.assetid: 9b8db279-1f12-4a6b-a923-2db22acd1947 > nonstandard extension used : bit field types other than int +## Remarks + With the default Microsoft extensions (/Ze), bitfield structure members can be of any integer type. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md index 4733a5d89cc..a343d16b1d5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4220"] > varargs matches remaining parameters +## Remarks + Under the default Microsoft extensions (/Ze), a pointer to a function matches a pointer to a function with similar, but variable, arguments. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md index c350cd2736f..e97f23003c7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md @@ -10,6 +10,8 @@ ms.assetid: 8532bd68-54dc-4526-8597-f61dcb0a0129 > nonstandard extension used : 'identifier' : cannot be initialized using address of automatic variable +## Remarks + With the default Microsoft extensions (/Ze), you can initialize an aggregate type (**array**, **`struct`**, or **`union`**) with the address of a local (automatic) variable. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md index bc05a609f2f..982277e75ce 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md @@ -10,4 +10,6 @@ ms.assetid: 6fc44336-0250-4432-928b-fc5dbe7b7c1c > nonstandard extension used: non-lvalue array converted to pointer +## Remarks + In standard C, you can't convert a nonlvalue array to a pointer. With the default Microsoft extensions ([`/Ze`](../../build/reference/za-ze-disable-language-extensions.md)), you can. From 7f3951f7df01f33892a403dfe86c69f06d869a24 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 16:29:55 +0800 Subject: [PATCH 0987/1799] Replace term "sample" with "example" for warning references in range [C4201, C4230] --- .../compiler-warnings/compiler-warning-level-1-c4215.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4216.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4212.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md index 2b08ace8092..ee21034e170 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md @@ -16,7 +16,7 @@ The default Microsoft extensions (/Ze) treat **long float** as **`double`**. ANS ## Example -The following sample generates C4215: +The following example generates C4215: ```cpp // C4215.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md index ff2d742ca42..e55ea034ee1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md @@ -16,7 +16,7 @@ The default Microsoft extensions (/Ze) treat **float long** as **`double`**. ANS ## Example -The following sample generates C4216: +The following example generates C4216: ```cpp // C4216.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md index 725f7236d8e..165397d442d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md @@ -16,7 +16,7 @@ The function prototype has a variable number of arguments. The function definiti ## Example -The following sample generates C4212: +The following example generates C4212: ```c // C4212.c From 1d985187672b8f397172ad5847af1013755bae6f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 16:36:46 +0800 Subject: [PATCH 0988/1799] Update metadata for warning references in range [C4201, C4230] --- .../compiler-warnings/compiler-warning-level-1-c4215.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4216.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4218.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4224.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4226.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4227.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4228.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4229.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4230.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4201.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4202.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4204.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4206.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4207.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4208.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4210.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4211.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4212.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4213.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4214.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4221.md | 5 ++--- .../compiler-warning-levels-1-and-4-c4223.md | 5 ++--- 22 files changed, 44 insertions(+), 64 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md index ee21034e170..27a4c3ce647 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4215" title: "Compiler Warning (level 1) C4215" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4215" +ms.date: 11/04/2016 f1_keywords: ["C4215"] helpviewer_keywords: ["C4215"] -ms.assetid: f2aab64d-1bab-4f75-95ee-89e1263047b1 --- # Compiler Warning (level 1) C4215 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md index e55ea034ee1..aa54762a695 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4216" title: "Compiler Warning (level 1) C4216" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4216" +ms.date: 11/04/2016 f1_keywords: ["C4216"] helpviewer_keywords: ["C4216"] -ms.assetid: 211079dc-59d0-42a7-801c-2ddab21d7232 --- # Compiler Warning (level 1) C4216 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md index 35c46088620..d9567820d28 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4218" title: "Compiler Warning (level 4) C4218" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4218" +ms.date: 11/04/2016 f1_keywords: ["C4218"] helpviewer_keywords: ["C4218"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md index 64615700d5a..c0235738be4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4224" title: "Compiler Warning (level 1) C4224" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4224" +ms.date: 11/04/2016 f1_keywords: ["C4224"] helpviewer_keywords: ["C4224"] -ms.assetid: 1531cae0-5040-49fd-b149-005bb5085391 --- # Compiler Warning (level 1) C4224 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md index 137d08d0911..19124a35a03 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4226" title: "Compiler Warning (level 1) C4226" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning (level 1) C4226" +ms.date: 10/25/2017 f1_keywords: ["C4226"] helpviewer_keywords: ["C4226"] -ms.assetid: 69d6bbde-1300-4e48-8a9c-3648c80ab441 --- # Compiler Warning (level 1) C4226 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md index 89220690752..2410f0148a1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4227" title: "Compiler Warning (level 1) C4227" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4227" +ms.date: 11/04/2016 f1_keywords: ["C4227"] helpviewer_keywords: ["C4227"] -ms.assetid: 78f98374-c00b-4000-aefa-1b1c67b4666b --- # Compiler Warning (level 1) C4227 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md index 60822f04f80..3a48ee71723 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4228" title: "Compiler Warning (level 1) C4228" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4228" +ms.date: 11/04/2016 f1_keywords: ["C4228"] helpviewer_keywords: ["C4228"] -ms.assetid: 9301d660-d601-464e-83f5-7ed844a3c6dc --- # Compiler Warning (level 1) C4228 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md index 9a0581bf9a9..710792be5c5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4229" title: "Compiler Warning (level 1, Error) C4229" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4229" +ms.date: 11/04/2016 f1_keywords: ["C4229"] helpviewer_keywords: ["C4229"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md index 11d63a99713..f25b3038592 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4230" title: "Compiler Warning (level 1) C4230" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4230" +ms.date: 11/04/2016 f1_keywords: ["C4230"] helpviewer_keywords: ["C4230"] -ms.assetid: a4be8729-74b6-44df-a5ea-e3f45aad0f8f --- # Compiler Warning (level 1) C4230 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md index 87fb3669b19..3ca425c5665 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4201" title: "Compiler Warning (level 4) C4201" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4201" +ms.date: 11/04/2016 f1_keywords: ["C4201"] helpviewer_keywords: ["C4201"] -ms.assetid: 6156f508-9393-4d77-9e73-1ec3e1c32d0d --- # Compiler Warning (level 4) C4201 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md index 7358e82d10d..f10717fc4a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4202" title: "Compiler Warning (level 4) C4202" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4202" +ms.date: 11/04/2016 f1_keywords: ["C4202"] helpviewer_keywords: ["C4202"] -ms.assetid: 253293aa-97a3-4878-a2e8-c6cc9e20b1cb --- # Compiler Warning (level 4) C4202 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md index 20e8ffda1d8..fed176ace4c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4204" title: "Compiler Warning (level 4) C4204" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4204" +ms.date: 11/04/2016 f1_keywords: ["C4204"] helpviewer_keywords: ["C4204"] -ms.assetid: 298d2880-6737-448e-b711-15572d540200 --- # Compiler Warning (level 4) C4204 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md index 1fa98e95fdb..606a827b03a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4206" title: "Compiler Warning (level 4) C4206" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4206" +ms.date: 11/04/2016 f1_keywords: ["C4206"] helpviewer_keywords: ["C4206"] -ms.assetid: 3df97812-3ed7-4003-9769-057acf97ce3c --- # Compiler Warning (level 4) C4206 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md index eb75b63b003..c04f19d669c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4207" title: "Compiler Warning (level 4) C4207" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4207" +ms.date: 11/04/2016 f1_keywords: ["C4207"] helpviewer_keywords: ["C4207"] -ms.assetid: f4e09e3e-ac87-4489-8e3f-c8f76b82e721 --- # Compiler Warning (level 4) C4207 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md index 63bb80530b5..56b5102ba13 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4208" title: "Compiler Warning (level 4) C4208" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4208" +ms.date: 11/04/2016 f1_keywords: ["C4208"] helpviewer_keywords: ["C4208"] -ms.assetid: 5cb0a36e-3fb5-422f-a5f9-e40b70776c27 --- # Compiler Warning (level 4) C4208 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md index 3c3e2e765db..297250b52d3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4210" title: "Compiler Warning (level 4) C4210" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4210" +ms.date: 11/04/2016 f1_keywords: ["C4210"] helpviewer_keywords: ["C4210"] -ms.assetid: f8600adf-dfe2-4022-a37a-3d4997641dfd --- # Compiler Warning (level 4) C4210 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md index 1ef53b5e5aa..45eeba8fb21 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4211" title: "Compiler Warning (level 4) C4211" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4211" +ms.date: 11/04/2016 f1_keywords: ["C4211"] helpviewer_keywords: ["C4211"] -ms.assetid: 3eea3455-6faa-4cdb-8730-73db7026bd1f --- # Compiler Warning (level 4) C4211 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md index 165397d442d..4509562c90a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4212" title: "Compiler Warning (level 4) C4212" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4212" +ms.date: 11/04/2016 f1_keywords: ["C4212"] helpviewer_keywords: ["C4212"] -ms.assetid: df781ea1-182d-4f9f-9a31-55b6ce80c711 --- # Compiler Warning (level 4) C4212 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md index 16d5148d500..faacb095c86 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4213" title: "Compiler Warning (level 4) C4213" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4213" +ms.date: 11/04/2016 f1_keywords: ["C4213"] helpviewer_keywords: ["C4213"] -ms.assetid: 59fc3f61-ebd2-499e-99d7-f57bec11eda1 --- # Compiler Warning (level 4) C4213 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md index 9df5b76c9a8..6d4f078b7c7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4214" title: "Compiler Warning (level 4) C4214" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4214" +ms.date: 11/04/2016 f1_keywords: ["C4214"] helpviewer_keywords: ["C4214"] -ms.assetid: 9b8db279-1f12-4a6b-a923-2db22acd1947 --- # Compiler Warning (level 4) C4214 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md index e97f23003c7..79505b42b96 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4221" title: "Compiler Warning (level 4) C4221" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4221" +ms.date: 11/04/2016 f1_keywords: ["C4221"] helpviewer_keywords: ["C4221"] -ms.assetid: 8532bd68-54dc-4526-8597-f61dcb0a0129 --- # Compiler Warning (level 4) C4221 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md index 982277e75ce..e9f2a839c88 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4223" title: "Compiler Warning (level 1 and level 4) C4223" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4223" +ms.date: 11/04/2016 f1_keywords: ["C4223"] helpviewer_keywords: ["C4223"] -ms.assetid: 6fc44336-0250-4432-928b-fc5dbe7b7c1c --- # Compiler Warning (level 1 and level 4) C4223 From e04e6bd4e7dd4ae6d7d0102065c59ab4ea1f91e5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 16:43:47 +0800 Subject: [PATCH 0989/1799] Add leading example sentence for warning references in range [C4201, C4230] --- .../compiler-warnings/compiler-warning-level-1-c4218.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4224.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4227.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4228.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4229.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4230.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4201.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4202.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4204.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4205.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4207.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4208.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4210.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4211.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4213.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4214.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4220.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4221.md | 2 ++ 18 files changed, 36 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md index d9567820d28..21910d55dfc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md @@ -15,6 +15,8 @@ With the default Microsoft extensions (`/Ze`), you can declare a variable withou ## Example +The following example generates C4218: + ```cpp // C4218.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md index c0235738be4..9eea04e97ed 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md @@ -15,6 +15,8 @@ The identifier was previously used as a **`typedef`**. This causes a warning und ## Example +The following example generates C4224: + ```cpp // C4224.cpp // compile with: /Za /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md index 2410f0148a1..d59944fbccf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md @@ -15,6 +15,8 @@ Using qualifiers like **`const`** or **`volatile`** with C++ references is an ou ## Example +The following example generates C4227: + ```cpp // C4227.cpp // compile with: /W1 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md index 3a48ee71723..da9cdeefa90 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md @@ -15,6 +15,8 @@ Use of qualifiers like **`const`** or **`volatile`** after a comma when declarin ## Example +The following example generates C4228: + ```cpp // C4228.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md index 710792be5c5..cbc55d7f30d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md @@ -15,6 +15,8 @@ Using a Microsoft modifier such as **`__cdecl`** on a data declaration is an out ## Example +The following example generates C4229: + ```cpp // C4229.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md index f25b3038592..37dd1af4b1c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md @@ -15,6 +15,8 @@ Using a qualifier before a Microsoft modifier such as **`__cdecl`** is an outdat ## Example +The following example generates C4230: + ```cpp // C4230.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md index 3ca425c5665..ceebc5ca0a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md @@ -15,6 +15,8 @@ Under Microsoft extensions (/Ze), you can specify a structure without a declarat ## Example +The following example generates C4201: + ```cpp // C4201.cpp // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md index f10717fc4a2..a1ddd986de8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md @@ -15,6 +15,8 @@ An old-style function definition contains variable arguments. These definitions ## Example +The following example generates C4202: + ```c // C4202.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md index fed176ace4c..9ad06ae599c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md @@ -15,6 +15,8 @@ With Microsoft extensions (/Ze), you can initialize aggregate types (arrays, str ## Example +The following example generates C4204: + ```c // C4204.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md index 43b39be6d8c..0d25190bf0f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md @@ -15,6 +15,8 @@ With Microsoft extensions (/Ze), **`static`** functions can be declared inside a ## Example +The following example generates C4205: + ```c // C4205.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md index c04f19d669c..0d9439f1572 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md @@ -15,6 +15,8 @@ With Microsoft extensions (/Ze), you can initialize an unsized array of **`char` ## Example +The following example generates C4207: + ```c // C4207.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md index 56b5102ba13..2c0de261003 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md @@ -15,6 +15,8 @@ With Microsoft extensions (/Ze), you can delete an array using a value within br ## Example +The following example generates C4208: + ```cpp // C4208.cpp // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md index 297250b52d3..95522de60e4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md @@ -15,6 +15,8 @@ With the default Microsoft extensions ([/Ze](../../build/reference/za-ze-disable ## Example +The following example generates C4210: + ```c // C4210.c // compile with: /W4 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md index 45eeba8fb21..98e88e30c24 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md @@ -15,6 +15,8 @@ With the default Microsoft extensions (/Ze), you can redefine an **`extern`** id ## Example +The following example generates C4211: + ```c // C4211.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md index faacb095c86..eda0670bcba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md @@ -15,6 +15,8 @@ With the default Microsoft extensions (/Ze), you can use casts on the left side ## Example +The following example generates C4213: + ```c // C4213.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md index 6d4f078b7c7..26e6071374a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md @@ -15,6 +15,8 @@ With the default Microsoft extensions (/Ze), bitfield structure members can be o ## Example +The following example generates C4214: + ```c // C4214.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md index a343d16b1d5..2eba4fa6522 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md @@ -15,6 +15,8 @@ Under the default Microsoft extensions (/Ze), a pointer to a function matches a ## Example +The following example generates C4220: + ```c // C4220.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md index 79505b42b96..95c742a069a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md @@ -15,6 +15,8 @@ With the default Microsoft extensions (/Ze), you can initialize an aggregate typ ## Example +The following example generates C4221: + ```c // C4221.c // compile with: /W4 From 6b073ffd11ddf01d8fc1bac0540c32605b68d438 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 17:19:23 +0800 Subject: [PATCH 0990/1799] Update error message in C2277 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2277.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index 1f56b60b30e..374a9a0cfb3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2277"] --- # Compiler Error C2277 -> 'identifier' : cannot take address of this member function +> '*function*': cannot take address of this member function ## Remarks From 6ba724649644d3c436be3009bd8a0e80b8409e57 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 17:30:42 +0800 Subject: [PATCH 0991/1799] Augment remarks in C2277 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2277.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index 374a9a0cfb3..fc073f0fd2d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C2277"] ## Remarks -You cannot take the address of a member function. +You cannot take the address of a [constructor](../../cpp/constructors-cpp.md) or [destructor](../../cpp/destructors-cpp.md). For more information, see [Address-of operator: `&`](../../cpp/address-of-operator-amp.md) and [Pointers to Members](../../cpp/pointers-to-members.md). ## Example From 8c9b549f92f7b4f959ce3f8c8f476dbb4b589a7b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 17:39:14 +0800 Subject: [PATCH 0992/1799] Improve example in C2277 error reference --- .../compiler-errors-1/compiler-error-c2277.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index fc073f0fd2d..d021d0d397d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -19,9 +19,14 @@ The following example generates C2277: ```cpp // C2277.cpp -class A { -public: - A(); +// compile with: /c + +struct S +{ + S() {} + ~S() {} }; -(*pctor)() = &A::A; // C2277 + +void (S::* pointer_to_constructor)() = &S::S; // C2277 +void (S::* pointer_to_destructor)() = &S::~S; // C2277 ``` From 90148e799c06930b920b06d92f10fa66e2cdb5b4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 17:40:24 +0800 Subject: [PATCH 0993/1799] Update `ms.date` metadata in C2277 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2277.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index d021d0d397d..c5e73e52a40 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2277" description: "Learn more about: Compiler Error C2277" -ms.date: 11/04/2016 +ms.date: 08/27/2025 f1_keywords: ["C2277"] helpviewer_keywords: ["C2277"] --- From f98752adc256f45712d46def85c98b01739f0786 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 18:21:08 +0800 Subject: [PATCH 0994/1799] Trim spaces around metadata entries --- docs/build-insights/index.yml | 2 +- docs/build/cmake-projects-in-visual-studio.md | 2 +- docs/build/prolog-and-epilog.md | 2 +- docs/build/reference/force-interlocked-functions.md | 4 ++-- .../homeparams-copy-register-parameters-to-stack.md | 2 +- docs/build/reference/zp-struct-member-alignment.md | 2 +- docs/build/stack-usage.md | 2 +- docs/c-runtime-library/crt-debugging-techniques.md | 2 +- ...mat-specification-syntax-printf-and-wprintf-functions.md | 2 +- docs/c-runtime-library/global-state.md | 2 +- docs/c-runtime-library/reference/floor-floorf-floorl.md | 2 +- docs/c-runtime-library/tgmath.md | 2 +- docs/code-quality/c26132.md | 6 +++--- docs/code-quality/c26133.md | 6 +++--- docs/cpp/align-cpp.md | 2 +- docs/cpp/alignof-operator.md | 2 +- docs/cpp/argument-passing-and-naming-conventions.md | 2 +- docs/cpp/extension-restrict.md | 2 +- docs/cpp/unaligned.md | 2 +- docs/cpp/vectorcall.md | 2 +- docs/cross-platform/index.yml | 2 +- docs/get-started/index.yml | 4 ++-- docs/standard-library/list-functions.md | 2 +- docs/standard-library/string-view-operators.md | 2 +- 24 files changed, 30 insertions(+), 30 deletions(-) diff --git a/docs/build-insights/index.yml b/docs/build-insights/index.yml index 876c27600a8..5020326898f 100644 --- a/docs/build-insights/index.yml +++ b/docs/build-insights/index.yml @@ -17,7 +17,7 @@ landingContent: # Cards and links should be based on top customer tasks or top subjects # Start card title with a verb # Card (optional) - - title: Learn how your build performs + - title: Learn how your build performs linkLists: - linkListType: overview links: diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index b56efcce7e5..108e678c259 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -3,7 +3,7 @@ title: "CMake projects in Visual Studio" description: "Learn how to create and build C++ projects using CMake in Visual Studio." ms.date: 03/18/2025 ms.topic: concept-article -f1_keywords: ["VS.ToolsOptionsPages.CMake.General", "VS.ToolsOptionsPages.CMake.LanguageServices"] +f1_keywords: ["VS.ToolsOptionsPages.CMake.General", "VS.ToolsOptionsPages.CMake.LanguageServices"] ms.custom: sfi-image-nochange --- # CMake projects in Visual Studio diff --git a/docs/build/prolog-and-epilog.md b/docs/build/prolog-and-epilog.md index eb6f1ad9723..c3165119b56 100644 --- a/docs/build/prolog-and-epilog.md +++ b/docs/build/prolog-and-epilog.md @@ -1,7 +1,7 @@ --- description: "Learn more about: x64 prolog and epilog" title: "x64 prolog and epilog" -ms.date: "12/17/2018" +ms.date: "12/17/2018" ms.assetid: 0453ed1a-3ff1-4bee-9cc2-d6d3d6384984 --- # x64 prolog and epilog diff --git a/docs/build/reference/force-interlocked-functions.md b/docs/build/reference/force-interlocked-functions.md index b0fb4df6fa0..be8e5769db8 100644 --- a/docs/build/reference/force-interlocked-functions.md +++ b/docs/build/reference/force-interlocked-functions.md @@ -1,7 +1,7 @@ --- -title: "/forceInterlockedFunctions" +title: "/forceInterlockedFunctions" description: "Learn more about /forceInterlockedFunctions" -ms.date: 03/07/2025 +ms.date: 03/07/2025 --- # `/forceInterlockedFunctions` diff --git a/docs/build/reference/homeparams-copy-register-parameters-to-stack.md b/docs/build/reference/homeparams-copy-register-parameters-to-stack.md index bb498d1bfef..18aabbf63c8 100644 --- a/docs/build/reference/homeparams-copy-register-parameters-to-stack.md +++ b/docs/build/reference/homeparams-copy-register-parameters-to-stack.md @@ -1,7 +1,7 @@ --- description: "Learn more about: /homeparams (Copy Register Parameters to Stack)" title: "/homeparams (Copy Register Parameters to Stack)" -ms.date: "12/17/2018" +ms.date: "12/17/2018" f1_keywords: ["/homeparams"] helpviewer_keywords: ["/homeparams compiler option [C++]", "-homeparams compiler option [C++]"] ms.assetid: 51067de4-24f7-436b-b8d9-bc867a7d53aa diff --git a/docs/build/reference/zp-struct-member-alignment.md b/docs/build/reference/zp-struct-member-alignment.md index cfb89975b24..4a1962ff77b 100644 --- a/docs/build/reference/zp-struct-member-alignment.md +++ b/docs/build/reference/zp-struct-member-alignment.md @@ -1,7 +1,7 @@ --- description: "Learn more about: /Zp (Struct Member Alignment)" title: "/Zp (Struct Member Alignment)" -ms.date: "01/08/2021" +ms.date: "01/08/2021" f1_keywords: ["/zp", "VC.Project.VCCLCompilerTool.StructMemberAlignment", "VC.Project.VCCLWCECompilerTool.StructMemberAlignment"] helpviewer_keywords: ["Struct Member Alignment compiler option", "Zp compiler option", "/Zp compiler option [C++]", "-Zp compiler option [C++]"] ms.assetid: 5242f656-ed9b-48a3-bc73-cfcf3ed2520f diff --git a/docs/build/stack-usage.md b/docs/build/stack-usage.md index 8bbec4908e8..cb26ff19a9a 100644 --- a/docs/build/stack-usage.md +++ b/docs/build/stack-usage.md @@ -1,7 +1,7 @@ --- description: "Learn more about: x64 stack usage" title: "x64 stack usage" -ms.date: "12/17/2018" +ms.date: "12/17/2018" ms.assetid: 383f0072-0438-489f-8829-cca89582408c --- # x64 stack usage diff --git a/docs/c-runtime-library/crt-debugging-techniques.md b/docs/c-runtime-library/crt-debugging-techniques.md index 323c0d36b96..27507a84063 100644 --- a/docs/c-runtime-library/crt-debugging-techniques.md +++ b/docs/c-runtime-library/crt-debugging-techniques.md @@ -1,6 +1,6 @@ --- title: CRT debugging techniques -description: There are various techniques you can use to debug a program that uses the C run-time (CRT) library. Use this article and its links to learn about such techniques. +description: There are various techniques you can use to debug a program that uses the C run-time (CRT) library. Use this article and its links to learn about such techniques. ms.custom: SEO-VS-2020 ms.date: 02/03/2023 f1_keywords: diff --git a/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md b/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md index 7b8fe374953..fd0f57dc4c3 100644 --- a/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md +++ b/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md @@ -1,6 +1,6 @@ --- title: "Format Specification Syntax: `printf` and `wprintf` Functions" -description: "Describes the format specifier syntax for the Microsoft C runtime `printf` and `wprintf` functions" +description: "Describes the format specifier syntax for the Microsoft C runtime `printf` and `wprintf` functions" ms.date: "10/26/2020" helpviewer_keywords: ["format specification fields for printf function", "printf function format specification fields", "flag directives, printf function", "type fields, printf function", "width fields, printf function", "precision fields, printf function"] ms.assetid: 664b1717-2760-4c61-bd9c-22eee618d825 diff --git a/docs/c-runtime-library/global-state.md b/docs/c-runtime-library/global-state.md index 9a8a36b10de..4f350ffa384 100644 --- a/docs/c-runtime-library/global-state.md +++ b/docs/c-runtime-library/global-state.md @@ -1,6 +1,6 @@ --- title: "Global state in the CRT" -description: "Describes how shared global state is handled in the Microsoft Universal C Runtime." +description: "Describes how shared global state is handled in the Microsoft Universal C Runtime." ms.topic: "concept-article" ms.date: "10/02/2020" helpviewer_keywords: ["CRT global state"] diff --git a/docs/c-runtime-library/reference/floor-floorf-floorl.md b/docs/c-runtime-library/reference/floor-floorf-floorl.md index 6c5ae98469f..5e9997e6364 100644 --- a/docs/c-runtime-library/reference/floor-floorf-floorl.md +++ b/docs/c-runtime-library/reference/floor-floorf-floorl.md @@ -1,6 +1,6 @@ --- title: "floor, floorf, floorl" -description: "API reference for floor, floorf, and floorl; which calculates the floor of a value." +description: "API reference for floor, floorf, and floorl; which calculates the floor of a value." ms.date: 9/1/2020 api_name: ["floorf", "floorl", "floor", "_o_floor", "_o_floorf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] diff --git a/docs/c-runtime-library/tgmath.md b/docs/c-runtime-library/tgmath.md index 87240aaa4d0..455b97065d9 100644 --- a/docs/c-runtime-library/tgmath.md +++ b/docs/c-runtime-library/tgmath.md @@ -1,6 +1,6 @@ --- title: "Type-generic math" -description: "Describes macros in that make it easier to write C code that calls the correct math function, based on argument type." +description: "Describes macros in that make it easier to write C code that calls the correct math function, based on argument type." ms.topic: "concept-article" ms.date: "6/28/2021" helpviewer_keywords: ["CRT tgmath.h"] diff --git a/docs/code-quality/c26132.md b/docs/code-quality/c26132.md index 487cad505f3..624fcc54d2a 100644 --- a/docs/code-quality/c26132.md +++ b/docs/code-quality/c26132.md @@ -1,11 +1,11 @@ --- title: Warning C26132 description: Documentation on static analysis warning C26132 -author: Rastaban -ms.author: philc +author: Rastaban +ms.author: philc ms.service: visual-cpp ms.topic: concept-article -ms.date: 02/11/2025 +ms.date: 02/11/2025 --- # Warning C26132 diff --git a/docs/code-quality/c26133.md b/docs/code-quality/c26133.md index e1067f9c3a8..329d900ae6d 100644 --- a/docs/code-quality/c26133.md +++ b/docs/code-quality/c26133.md @@ -1,11 +1,11 @@ --- title: Warning C26133 description: Documentation on static analysis warning C26133 -author: Rastaban -ms.author: philc +author: Rastaban +ms.author: philc ms.service: visual-cpp ms.topic: concept-article -ms.date: 02/19/2025 +ms.date: 02/19/2025 --- # Warning C26133 diff --git a/docs/cpp/align-cpp.md b/docs/cpp/align-cpp.md index 480640779f9..14f9b6942ad 100644 --- a/docs/cpp/align-cpp.md +++ b/docs/cpp/align-cpp.md @@ -1,7 +1,7 @@ --- description: "Learn more about: align (C++)" title: "align (C++)" -ms.date: "12/17/2018" +ms.date: "12/17/2018" f1_keywords: ["align_cpp"] helpviewer_keywords: ["align __declspec keyword", "__declspec keyword [C++], align"] --- diff --git a/docs/cpp/alignof-operator.md b/docs/cpp/alignof-operator.md index 85de3668703..6d99ada651d 100644 --- a/docs/cpp/alignof-operator.md +++ b/docs/cpp/alignof-operator.md @@ -1,7 +1,7 @@ --- description: "Learn more about: alignof Operator" title: "alignof Operator" -ms.date: "12/17/2018" +ms.date: "12/17/2018" f1_keywords: ["__alignof_cpp", "alignof_cpp", "__alignof", "_alignof"] helpviewer_keywords: ["alignas [C++]", "alignment of structures", "__alignof keyword [C++]", "alignof [C++]", "types [C++], alignment requirements"] --- diff --git a/docs/cpp/argument-passing-and-naming-conventions.md b/docs/cpp/argument-passing-and-naming-conventions.md index b7ec0825474..b9693148a1d 100644 --- a/docs/cpp/argument-passing-and-naming-conventions.md +++ b/docs/cpp/argument-passing-and-naming-conventions.md @@ -1,7 +1,7 @@ --- description: "Learn more about: Argument Passing and Naming Conventions" title: "Argument Passing and Naming Conventions" -ms.date: "12/17/2018" +ms.date: "12/17/2018" helpviewer_keywords: ["argument passing [C++], conventions", "arguments [C++], widening", "coding conventions, arguments", "arguments [C++], passing", "registers, return values", "thiscall keyword [C++]", "naming conventions [C++], arguments", "arguments [C++], naming", "passing arguments [C++], conventions", "conventions [C++], argument names"] ms.assetid: de468979-eab8-4158-90c5-c198932f93b9 --- diff --git a/docs/cpp/extension-restrict.md b/docs/cpp/extension-restrict.md index ce69c439af6..eb809b13a91 100644 --- a/docs/cpp/extension-restrict.md +++ b/docs/cpp/extension-restrict.md @@ -1,6 +1,6 @@ --- title: "`__restrict`" -description: "Describes the Microsoft Visual C++ `__restrict` keyword." +description: "Describes the Microsoft Visual C++ `__restrict` keyword." ms.date: "11/6/2020" f1_keywords: ["__restrict_cpp", "__restrict", "_restrict"] helpviewer_keywords: ["__restrict keyword [C++]"] diff --git a/docs/cpp/unaligned.md b/docs/cpp/unaligned.md index ab25505fd0f..a9d7900d647 100644 --- a/docs/cpp/unaligned.md +++ b/docs/cpp/unaligned.md @@ -1,7 +1,7 @@ --- description: "Learn more about: __unaligned" title: "__unaligned" -ms.date: "12/17/2018" +ms.date: "12/17/2018" f1_keywords: ["__unaligned_cpp", "__unaligned", "_unaligned"] helpviewer_keywords: ["__unaligned keyword [C++]"] --- diff --git a/docs/cpp/vectorcall.md b/docs/cpp/vectorcall.md index 97bca68b082..c790e9e311d 100644 --- a/docs/cpp/vectorcall.md +++ b/docs/cpp/vectorcall.md @@ -1,7 +1,7 @@ --- description: "Learn more about: __vectorcall" title: "__vectorcall" -ms.date: "12/17/2018" +ms.date: "12/17/2018" f1_keywords: ["__vectorcall_cpp", "__vectorcall", "_vectorcall"] helpviewer_keywords: ["__vectorcall keyword", "__vectorcall"] ms.assetid: 1c95ed59-86c6-4857-b4ed-10519193f851 diff --git a/docs/cross-platform/index.yml b/docs/cross-platform/index.yml index 0fb5f94c593..789c7f8b022 100644 --- a/docs/cross-platform/index.yml +++ b/docs/cross-platform/index.yml @@ -17,7 +17,7 @@ landingContent: # Cards and links should be based on top customer tasks or top subjects # Start card title with a verb # Card (optional) - - title: Learn how to build cross-platform mobile apps + - title: Learn how to build cross-platform mobile apps linkLists: - linkListType: get-started links: diff --git a/docs/get-started/index.yml b/docs/get-started/index.yml index d338b6c128e..f179d269b5f 100644 --- a/docs/get-started/index.yml +++ b/docs/get-started/index.yml @@ -1,6 +1,6 @@ ### YamlMime:Landing -title: Visual Studio tutorials | C++ +title: Visual Studio tutorials | C++ summary: Create C++ apps with Visual Studio. metadata: @@ -10,7 +10,7 @@ metadata: ms.topic: landing-page ms.date: 12/06/2021 author: tylermsft - ms.author: twhitney + ms.author: twhitney manager: coxford ms.service: visual-cpp dev_langs: diff --git a/docs/standard-library/list-functions.md b/docs/standard-library/list-functions.md index 7047605aa77..e3dc0e53c31 100644 --- a/docs/standard-library/list-functions.md +++ b/docs/standard-library/list-functions.md @@ -1,6 +1,6 @@ --- description: "Learn more about: functions" -title: functions +title: functions ms.custom: "" ms.date: "11/04/2016" ms.topic: "reference" diff --git a/docs/standard-library/string-view-operators.md b/docs/standard-library/string-view-operators.md index a79ca556d75..1f3f4c44dec 100644 --- a/docs/standard-library/string-view-operators.md +++ b/docs/standard-library/string-view-operators.md @@ -1,6 +1,6 @@ --- title: " operators" -description: "API reference for the `string_view` operators, which are used to compare two `string_view` objects, or a `string_view` and some other string object" +description: "API reference for the `string_view` operators, which are used to compare two `string_view` objects, or a `string_view` and some other string object" ms.date: 01/15/2021 f1_keywords: ["xstring/basic_string_view::operator!=", "xstring/basic_string_view::operator>", "xstring/basic_string_view::operator>=", "xstring/basic_string_view::operator<", "xstring/basic_string_view::operator<<", "xstring/basic_string_view::operator<=", "xstring/basic_string_view::operator+", "xstring/basic_string_view::operator==", 'xstring/std::literals::string_view_literals::operator "sv', 'std::literals::string_view_literals::operator sv', 'std::literals::string_view_literals', 'string_view_literals'] helpviewer_keywords: ["std::basic_string_view::operator!=", "std::basic_string_view::operator>", "std::basic_string_view::operator>=", "std::basic_string_view::operator<", "std::basic_string_view::operator<<", "std::basic_string_view::operator<=, std::basic_string_view::operator=="] From feeb48729629a6d8ef41a2cef3179e1751e746f7 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 18:26:08 +0800 Subject: [PATCH 0995/1799] Update metadata in 17 topics --- docs/build/prolog-and-epilog.md | 5 ++--- .../homeparams-copy-register-parameters-to-stack.md | 5 ++--- docs/build/reference/zp-struct-member-alignment.md | 5 ++--- docs/build/stack-usage.md | 5 ++--- docs/c-runtime-library/crt-debugging-techniques.md | 4 ++-- ...mat-specification-syntax-printf-and-wprintf-functions.md | 3 +-- docs/c-runtime-library/global-state.md | 2 +- docs/c-runtime-library/tgmath.md | 2 +- docs/code-quality/c26132.md | 6 +++--- docs/code-quality/c26133.md | 6 +++--- docs/cpp/align-cpp.md | 4 ++-- docs/cpp/alignof-operator.md | 4 ++-- docs/cpp/argument-passing-and-naming-conventions.md | 5 ++--- docs/cpp/extension-restrict.md | 2 +- docs/cpp/unaligned.md | 4 ++-- docs/cpp/vectorcall.md | 5 ++--- docs/standard-library/list-functions.md | 4 ++-- 17 files changed, 32 insertions(+), 39 deletions(-) diff --git a/docs/build/prolog-and-epilog.md b/docs/build/prolog-and-epilog.md index c3165119b56..56b27b056b1 100644 --- a/docs/build/prolog-and-epilog.md +++ b/docs/build/prolog-and-epilog.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: x64 prolog and epilog" title: "x64 prolog and epilog" -ms.date: "12/17/2018" -ms.assetid: 0453ed1a-3ff1-4bee-9cc2-d6d3d6384984 +description: "Learn more about: x64 prolog and epilog" +ms.date: 12/17/2018 --- # x64 prolog and epilog diff --git a/docs/build/reference/homeparams-copy-register-parameters-to-stack.md b/docs/build/reference/homeparams-copy-register-parameters-to-stack.md index 18aabbf63c8..9a9b9b1119a 100644 --- a/docs/build/reference/homeparams-copy-register-parameters-to-stack.md +++ b/docs/build/reference/homeparams-copy-register-parameters-to-stack.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /homeparams (Copy Register Parameters to Stack)" title: "/homeparams (Copy Register Parameters to Stack)" -ms.date: "12/17/2018" +description: "Learn more about: /homeparams (Copy Register Parameters to Stack)" +ms.date: 12/17/2018 f1_keywords: ["/homeparams"] helpviewer_keywords: ["/homeparams compiler option [C++]", "-homeparams compiler option [C++]"] -ms.assetid: 51067de4-24f7-436b-b8d9-bc867a7d53aa --- # /homeparams (Copy Register Parameters to Stack) diff --git a/docs/build/reference/zp-struct-member-alignment.md b/docs/build/reference/zp-struct-member-alignment.md index 4a1962ff77b..f9bd480e318 100644 --- a/docs/build/reference/zp-struct-member-alignment.md +++ b/docs/build/reference/zp-struct-member-alignment.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /Zp (Struct Member Alignment)" title: "/Zp (Struct Member Alignment)" -ms.date: "01/08/2021" +description: "Learn more about: /Zp (Struct Member Alignment)" +ms.date: 01/08/2021 f1_keywords: ["/zp", "VC.Project.VCCLCompilerTool.StructMemberAlignment", "VC.Project.VCCLWCECompilerTool.StructMemberAlignment"] helpviewer_keywords: ["Struct Member Alignment compiler option", "Zp compiler option", "/Zp compiler option [C++]", "-Zp compiler option [C++]"] -ms.assetid: 5242f656-ed9b-48a3-bc73-cfcf3ed2520f --- # /Zp (Struct Member Alignment) diff --git a/docs/build/stack-usage.md b/docs/build/stack-usage.md index cb26ff19a9a..8a2a87b36dd 100644 --- a/docs/build/stack-usage.md +++ b/docs/build/stack-usage.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: x64 stack usage" title: "x64 stack usage" -ms.date: "12/17/2018" -ms.assetid: 383f0072-0438-489f-8829-cca89582408c +description: "Learn more about: x64 stack usage" +ms.date: 12/17/2018 --- # x64 stack usage diff --git a/docs/c-runtime-library/crt-debugging-techniques.md b/docs/c-runtime-library/crt-debugging-techniques.md index 27507a84063..625ca882af6 100644 --- a/docs/c-runtime-library/crt-debugging-techniques.md +++ b/docs/c-runtime-library/crt-debugging-techniques.md @@ -1,6 +1,6 @@ --- -title: CRT debugging techniques -description: There are various techniques you can use to debug a program that uses the C run-time (CRT) library. Use this article and its links to learn about such techniques. +title: "CRT debugging techniques" +description: "There are various techniques you can use to debug a program that uses the C run-time (CRT) library. Use this article and its links to learn about such techniques." ms.custom: SEO-VS-2020 ms.date: 02/03/2023 f1_keywords: diff --git a/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md b/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md index fd0f57dc4c3..c6b482f1f36 100644 --- a/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md +++ b/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md @@ -1,9 +1,8 @@ --- title: "Format Specification Syntax: `printf` and `wprintf` Functions" description: "Describes the format specifier syntax for the Microsoft C runtime `printf` and `wprintf` functions" -ms.date: "10/26/2020" +ms.date: 10/26/2020 helpviewer_keywords: ["format specification fields for printf function", "printf function format specification fields", "flag directives, printf function", "type fields, printf function", "width fields, printf function", "precision fields, printf function"] -ms.assetid: 664b1717-2760-4c61-bd9c-22eee618d825 --- # Format specification syntax: `printf` and `wprintf` functions diff --git a/docs/c-runtime-library/global-state.md b/docs/c-runtime-library/global-state.md index 4f350ffa384..e1bc2fd01b5 100644 --- a/docs/c-runtime-library/global-state.md +++ b/docs/c-runtime-library/global-state.md @@ -1,8 +1,8 @@ --- title: "Global state in the CRT" description: "Describes how shared global state is handled in the Microsoft Universal C Runtime." +ms.date: 10/02/2020 ms.topic: "concept-article" -ms.date: "10/02/2020" helpviewer_keywords: ["CRT global state"] --- diff --git a/docs/c-runtime-library/tgmath.md b/docs/c-runtime-library/tgmath.md index 455b97065d9..62e68f26eda 100644 --- a/docs/c-runtime-library/tgmath.md +++ b/docs/c-runtime-library/tgmath.md @@ -1,8 +1,8 @@ --- title: "Type-generic math" description: "Describes macros in that make it easier to write C code that calls the correct math function, based on argument type." +ms.date: 6/28/2021 ms.topic: "concept-article" -ms.date: "6/28/2021" helpviewer_keywords: ["CRT tgmath.h"] --- diff --git a/docs/code-quality/c26132.md b/docs/code-quality/c26132.md index 624fcc54d2a..aedc7e027ce 100644 --- a/docs/code-quality/c26132.md +++ b/docs/code-quality/c26132.md @@ -1,11 +1,11 @@ --- -title: Warning C26132 -description: Documentation on static analysis warning C26132 +title: "Warning C26132" +description: "Documentation on static analysis warning C26132" +ms.date: 02/11/2025 author: Rastaban ms.author: philc ms.service: visual-cpp ms.topic: concept-article -ms.date: 02/11/2025 --- # Warning C26132 diff --git a/docs/code-quality/c26133.md b/docs/code-quality/c26133.md index 329d900ae6d..e206e837948 100644 --- a/docs/code-quality/c26133.md +++ b/docs/code-quality/c26133.md @@ -1,11 +1,11 @@ --- -title: Warning C26133 -description: Documentation on static analysis warning C26133 +title: "Warning C26133" +description: "Documentation on static analysis warning C26133" +ms.date: 02/19/2025 author: Rastaban ms.author: philc ms.service: visual-cpp ms.topic: concept-article -ms.date: 02/19/2025 --- # Warning C26133 diff --git a/docs/cpp/align-cpp.md b/docs/cpp/align-cpp.md index 14f9b6942ad..939c0edb165 100644 --- a/docs/cpp/align-cpp.md +++ b/docs/cpp/align-cpp.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: align (C++)" title: "align (C++)" -ms.date: "12/17/2018" +description: "Learn more about: align (C++)" +ms.date: 12/17/2018 f1_keywords: ["align_cpp"] helpviewer_keywords: ["align __declspec keyword", "__declspec keyword [C++], align"] --- diff --git a/docs/cpp/alignof-operator.md b/docs/cpp/alignof-operator.md index 6d99ada651d..a30d84fe45d 100644 --- a/docs/cpp/alignof-operator.md +++ b/docs/cpp/alignof-operator.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: alignof Operator" title: "alignof Operator" -ms.date: "12/17/2018" +description: "Learn more about: alignof Operator" +ms.date: 12/17/2018 f1_keywords: ["__alignof_cpp", "alignof_cpp", "__alignof", "_alignof"] helpviewer_keywords: ["alignas [C++]", "alignment of structures", "__alignof keyword [C++]", "alignof [C++]", "types [C++], alignment requirements"] --- diff --git a/docs/cpp/argument-passing-and-naming-conventions.md b/docs/cpp/argument-passing-and-naming-conventions.md index b9693148a1d..aea3e8d3a15 100644 --- a/docs/cpp/argument-passing-and-naming-conventions.md +++ b/docs/cpp/argument-passing-and-naming-conventions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Argument Passing and Naming Conventions" title: "Argument Passing and Naming Conventions" -ms.date: "12/17/2018" +description: "Learn more about: Argument Passing and Naming Conventions" +ms.date: 12/17/2018 helpviewer_keywords: ["argument passing [C++], conventions", "arguments [C++], widening", "coding conventions, arguments", "arguments [C++], passing", "registers, return values", "thiscall keyword [C++]", "naming conventions [C++], arguments", "arguments [C++], naming", "passing arguments [C++], conventions", "conventions [C++], argument names"] -ms.assetid: de468979-eab8-4158-90c5-c198932f93b9 --- # Argument Passing and Naming Conventions diff --git a/docs/cpp/extension-restrict.md b/docs/cpp/extension-restrict.md index eb809b13a91..16c3231d0a3 100644 --- a/docs/cpp/extension-restrict.md +++ b/docs/cpp/extension-restrict.md @@ -1,7 +1,7 @@ --- title: "`__restrict`" description: "Describes the Microsoft Visual C++ `__restrict` keyword." -ms.date: "11/6/2020" +ms.date: 11/6/2020 f1_keywords: ["__restrict_cpp", "__restrict", "_restrict"] helpviewer_keywords: ["__restrict keyword [C++]"] --- diff --git a/docs/cpp/unaligned.md b/docs/cpp/unaligned.md index a9d7900d647..9892e057476 100644 --- a/docs/cpp/unaligned.md +++ b/docs/cpp/unaligned.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: __unaligned" title: "__unaligned" -ms.date: "12/17/2018" +description: "Learn more about: __unaligned" +ms.date: 12/17/2018 f1_keywords: ["__unaligned_cpp", "__unaligned", "_unaligned"] helpviewer_keywords: ["__unaligned keyword [C++]"] --- diff --git a/docs/cpp/vectorcall.md b/docs/cpp/vectorcall.md index c790e9e311d..54209c78efd 100644 --- a/docs/cpp/vectorcall.md +++ b/docs/cpp/vectorcall.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: __vectorcall" title: "__vectorcall" -ms.date: "12/17/2018" +description: "Learn more about: __vectorcall" +ms.date: 12/17/2018 f1_keywords: ["__vectorcall_cpp", "__vectorcall", "_vectorcall"] helpviewer_keywords: ["__vectorcall keyword", "__vectorcall"] -ms.assetid: 1c95ed59-86c6-4857-b4ed-10519193f851 --- # __vectorcall diff --git a/docs/standard-library/list-functions.md b/docs/standard-library/list-functions.md index e3dc0e53c31..3827916e5b6 100644 --- a/docs/standard-library/list-functions.md +++ b/docs/standard-library/list-functions.md @@ -1,8 +1,8 @@ --- +title: " functions" description: "Learn more about: functions" -title: functions +ms.date: 11/04/2016 ms.custom: "" -ms.date: "11/04/2016" ms.topic: "reference" f1_keywords: ["list/std::swap"] --- From 06e442d1843b58629704fb542fd5648eab7bba85 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 23:27:08 +0800 Subject: [PATCH 0996/1799] Add blockquotes for warning messages in range [C4231, C4270] --- .../compiler-warnings/compiler-warning-level-1-c4237.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4258.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4269.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4244.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4250.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4240.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4243.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4267.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4232.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4234.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4238.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4239.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4256.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4268.md | 2 +- .../compiler-warnings/compiler-warning-levels-3-and-4-c4244.md | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md index 30336fc8024..3f67549fb32 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md @@ -8,7 +8,7 @@ ms.assetid: f2e86c4b-80d8-460e-9429-83c5f3f5d7ca --- # Compiler Warning (level 1) C4237 -'keyword' keyword is not yet supported, but reserved for future use +> 'keyword' keyword is not yet supported, but reserved for future use A keyword in the C++ specification is not implemented in the Microsoft C++ compiler, but the keyword is not available as a user-defined symbol. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md index f2131c6a91c..3904ba4c66f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md @@ -8,7 +8,7 @@ ms.assetid: bbb75e6d-6693-4e62-8ed3-b006a0ec55e3 --- # Compiler Warning (level 1) C4258 -'variable' : definition from the for loop is ignored; the definition from the enclosing scope is used" +> 'variable' : definition from the for loop is ignored; the definition from the enclosing scope is used" Under [/Ze](../../build/reference/za-ze-disable-language-extensions.md) and [/Zc:forScope](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md), variables defined in a [for](../../cpp/for-statement-cpp.md) loop go out of scope after the **`for`** loop ends. This warning occurs if a variable with the same name as the loop variable, but defined in the enclosing loop, is used again in the scope containing the **`for`** loop. For example: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md index faa87378537..322895fb5fd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4269"] --- # Compiler Warning (level 1) C4269 -'identifier' : 'const' automatic data initialized with compiler generated default constructor produces unreliable results +> 'identifier' : 'const' automatic data initialized with compiler generated default constructor produces unreliable results A **`const`** automatic instance of a non-trivial class is initialized with a compiler-generated default constructor. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md index f1b15944392..c88d6b4d731 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md @@ -8,7 +8,7 @@ ms.assetid: 2c19d157-21d1-42c2-a6c0-3f30f2ce3813 --- # Compiler Warning (level 2) C4244 -'argument' : conversion from 'type1' to 'type2', possible loss of data +> 'argument' : conversion from 'type1' to 'type2', possible loss of data A floating point type was converted to an integer type. A possible loss of data may have occurred. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md index 3ec69fa0134..191ce3b1fea 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md @@ -8,7 +8,7 @@ ms.assetid: d47f7249-6b5a-414b-b2d4-56e5d246a782 --- # Compiler Warning (level 2) C4250 -'class1' : inherits 'class2::member' via dominance +> 'class1' : inherits 'class2::member' via dominance Two or more members have the same name. The one in `class2` is inherited because it is a base class for the other classes that contained this member. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md index 66fc798b058..aa98f67f45a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md @@ -8,7 +8,7 @@ ms.assetid: a2657cdb-18e1-493f-882b-4e10c0bca71d --- # Compiler Warning (level 3) C4240 -nonstandard extension used : access to 'classname' now defined to be 'access specifier', previously it was defined to be 'access specifier' +> nonstandard extension used : access to 'classname' now defined to be 'access specifier', previously it was defined to be 'access specifier' Under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)), you cannot change the access to a nested class. Under the default Microsoft extensions (/Ze), you can, with this warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md index 8fab32eef47..1979eaf6c3b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4243"] --- # Compiler Warning (level 3) C4243 -'conversion type' conversion exists from 'type1' to 'type2', but is inaccessible +> 'conversion type' conversion exists from 'type1' to 'type2', but is inaccessible A pointer to a derived class is converted to a pointer to a base class, but the derived class inherits the base class with private or protected access. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md index bca3c8da4a9..537027a3bb3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md @@ -8,7 +8,7 @@ ms.assetid: 2fa2f13f-fa4f-47bb-ad8f-6cb19cfc91e6 --- # Compiler Warning (level 3) C4267 -'var' : conversion from 'size_t' to 'type', possible loss of data +> 'var' : conversion from 'size_t' to 'type', possible loss of data The compiler detected a conversion from `size_t` to a smaller type. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md index 78d4e5ed200..47f53d3a3e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md @@ -8,7 +8,7 @@ ms.assetid: f92028a5-4ddd-43c1-97f5-4f724e5e14af --- # Compiler Warning (level 4) C4232 -nonstandard extension used : 'identifier' : address of dllimport 'dllimport' is not static, identity not guaranteed +> nonstandard extension used : 'identifier' : address of dllimport 'dllimport' is not static, identity not guaranteed Under Microsoft extensions (/Ze), you can give a nonstatic value as the address of a function declared with the **`dllimport`** modifier. Under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)), this causes an error. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md index 3b2bc5eacb5..b0fa52b4559 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md @@ -8,7 +8,7 @@ ms.assetid: f7fecd5c-8248-4fde-8446-502aedc357ca --- # Compiler Warning (level 4) C4234 -nonstandard extension used: 'keyword' keyword reserved for future use +> nonstandard extension used: 'keyword' keyword reserved for future use The compiler does not yet implement the keyword you used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md index 679d603ef69..ac680a5ac57 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md @@ -8,7 +8,7 @@ ms.assetid: 5d4051d3-7b0f-43ea-8c8d-d194bfdceb71 --- # Compiler Warning (level 4) C4238 -nonstandard extension used : class rvalue used as lvalue +> nonstandard extension used : class rvalue used as lvalue For compatibility with previous versions of Visual C++, Microsoft extensions (**/Ze**) allow you to use a class type as an rvalue in a context that implicitly or explicitly takes its address. In some cases, such as the example below, this can be dangerous. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md index c68de7e669a..3fd260094f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md @@ -8,7 +8,7 @@ ms.assetid: a23dc16a-649e-4870-9a24-275de1584fcd --- # Compiler Warning (level 4) C4239 -nonstandard extension used : 'token' : conversion from 'type' to 'type' +> nonstandard extension used : 'token' : conversion from 'type' to 'type' This type conversion is not allowed by the C++ standard, but it is permitted here as an extension. This warning is always followed by at least one line of explanation describing the language rule being violated. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md index 8ce1d40f266..fbde6eb7d74 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md @@ -8,7 +8,7 @@ ms.assetid: a755a32e-895a-4837-a2b5-4ea06b736798 --- # Compiler Warning (level 4) C4256 -'function' : constructor for class with virtual bases has '...'; calls may not be compatible with older versions of Visual C++ +> 'function' : constructor for class with virtual bases has '...'; calls may not be compatible with older versions of Visual C++ Possible incompatibility. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md index 7ec668928d4..20efbfd9a77 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md @@ -8,7 +8,7 @@ ms.assetid: d0511e80-904f-4ee1-b4d7-39b5c0bd8234 --- # Compiler Warning (level 4) C4268 -'identifier' : 'const' static/global data initialized with compiler generated default constructor fills the object with zeros +> 'identifier' : 'const' static/global data initialized with compiler generated default constructor fills the object with zeros A **`const`** global or static instance of a non-trivial class is initialized with a compiler-generated default constructor. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md index 75b41ea7dd5..2aff8e8df99 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md @@ -5,7 +5,7 @@ ms.date: "11/6/2023" --- # Compiler Warning (levels 3 and 4) C4244 -'conversion' conversion from 'type1' to 'type2', possible loss of data +> 'conversion' conversion from 'type1' to 'type2', possible loss of data An integer type is converted to a smaller integer type. - This is a level-4 warning if *type1* is a signed or unsigned **`int`** and *type2* is a smaller, such as a signed or unsigned **`short`**. From d312b4aa643cb79716efb18d390462a82f95754a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 23:34:16 +0800 Subject: [PATCH 0997/1799] Add "Remarks" and "Example" headings for warning references in range [C4231, C4270] --- .../compiler-warnings/compiler-warning-level-1-c4237.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4258.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4264.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4269.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4244.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4250.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4240.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4243.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4265.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4267.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4232.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4233.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4234.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4238.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4239.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4242.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4245.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4254.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4255.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4256.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4263.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4266.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4268.md | 2 ++ .../compiler-warning-levels-3-and-4-c4244.md | 4 ++++ 24 files changed, 77 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md index 3f67549fb32..1b96053d121 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md @@ -10,8 +10,12 @@ ms.assetid: f2e86c4b-80d8-460e-9429-83c5f3f5d7ca > 'keyword' keyword is not yet supported, but reserved for future use +## Remarks + A keyword in the C++ specification is not implemented in the Microsoft C++ compiler, but the keyword is not available as a user-defined symbol. +## Example + The following sample generates C4237: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md index 3904ba4c66f..e8617f23c76 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md @@ -10,7 +10,13 @@ ms.assetid: bbb75e6d-6693-4e62-8ed3-b006a0ec55e3 > 'variable' : definition from the for loop is ignored; the definition from the enclosing scope is used" -Under [/Ze](../../build/reference/za-ze-disable-language-extensions.md) and [/Zc:forScope](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md), variables defined in a [for](../../cpp/for-statement-cpp.md) loop go out of scope after the **`for`** loop ends. This warning occurs if a variable with the same name as the loop variable, but defined in the enclosing loop, is used again in the scope containing the **`for`** loop. For example: +## Remarks + +Under [/Ze](../../build/reference/za-ze-disable-language-extensions.md) and [/Zc:forScope](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md), variables defined in a [for](../../cpp/for-statement-cpp.md) loop go out of scope after the **`for`** loop ends. This warning occurs if a variable with the same name as the loop variable, but defined in the enclosing loop, is used again in the scope containing the **`for`** loop. + +## Example + +For example: ```cpp // C4258.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md index 4fe40000681..04ab31ecfd2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4264"] > 'virtual_function' : no override available for virtual member function from base 'class'; function is hidden +## Remarks + C4264 is always generated after [C4263](../../error-messages/compiler-warnings/compiler-warning-level-4-c4263.md). 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). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md index 322895fb5fd..d582ed2f126 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4269"] > 'identifier' : 'const' automatic data initialized with compiler generated default constructor produces unreliable results +## Remarks + A **`const`** automatic instance of a non-trivial class is initialized with a compiler-generated default constructor. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md index c88d6b4d731..0c15ba251c7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md @@ -10,6 +10,8 @@ ms.assetid: 2c19d157-21d1-42c2-a6c0-3f30f2ce3813 > 'argument' : conversion from 'type1' to 'type2', possible loss of data +## Remarks + A floating point type was converted to an integer type. A possible loss of data may have occurred. If you get C4244, you should either change your program to use compatible types, or add some logic to your code, to ensure that the range of possible values will always be compatible with the types you are using. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md index 191ce3b1fea..0006e0a026d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md @@ -10,6 +10,8 @@ ms.assetid: d47f7249-6b5a-414b-b2d4-56e5d246a782 > 'class1' : inherits 'class2::member' via dominance +## Remarks + Two or more members have the same name. The one in `class2` is inherited because it is a base class for the other classes that contained this member. To suppress C4250, use the [warning](../../preprocessor/warning.md) pragma. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md index aa98f67f45a..4c0d53e25f6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md @@ -10,6 +10,8 @@ ms.assetid: a2657cdb-18e1-493f-882b-4e10c0bca71d > nonstandard extension used : access to 'classname' now defined to be 'access specifier', previously it was defined to be 'access specifier' +## Remarks + Under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)), you cannot change the access to a nested class. Under the default Microsoft extensions (/Ze), you can, with this warning. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md index 1979eaf6c3b..5fd56759f10 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C4243"] > 'conversion type' conversion exists from 'type1' to 'type2', but is inaccessible +## Remarks + A pointer to a derived class is converted to a pointer to a base class, but the derived class inherits the base class with private or protected access. +## Example + The following sample generates C4243: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md index fa20cef8113..62edba89612 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4265"] > '*classname*': class has virtual functions, but its non-trivial destructor is not virtual; instances of this class may not be destructed correctly +## Remarks + 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. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). +## Example + The following sample generates C4265: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md index 537027a3bb3..8c2ae4bc824 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md @@ -10,6 +10,8 @@ ms.assetid: 2fa2f13f-fa4f-47bb-ad8f-6cb19cfc91e6 > 'var' : conversion from 'size_t' to 'type', possible loss of data +## Remarks + The compiler detected a conversion from `size_t` to a smaller type. To fix this warning, use `size_t` instead of `type`. Alternatively, use an integral type that is at least as large as `size_t`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md index 47f53d3a3e3..ccffc0d7e13 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md @@ -10,8 +10,12 @@ ms.assetid: f92028a5-4ddd-43c1-97f5-4f724e5e14af > nonstandard extension used : 'identifier' : address of dllimport 'dllimport' is not static, identity not guaranteed +## Remarks + Under Microsoft extensions (/Ze), you can give a nonstatic value as the address of a function declared with the **`dllimport`** modifier. Under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)), this causes an error. +## Example + The following sample generates C4232: ```c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md index 7987d2e583c..525dbd22fe2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4233"] > nonstandard extension used: '*keyword*' keyword only supported in C++, not C +## Remarks + The compiler compiled your source code as C rather than C++, and you used a keyword that is only valid in C++. The compiler compiles your source file as C if the extension of the source file is .c or you use [/Tc](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md). This warning is always issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md index b0fa52b4559..331027fbff8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md @@ -10,6 +10,8 @@ ms.assetid: f7fecd5c-8248-4fde-8446-502aedc357ca > nonstandard extension used: 'keyword' keyword reserved for future use +## Remarks + The compiler does not yet implement the keyword you used. This warning is automatically promoted to an error. If you wish to modify this behavior, use [#pragma warning](../../preprocessor/warning.md). For example, to make C4234 into a level 4 warning issue, diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md index ac680a5ac57..cf660112a55 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md @@ -10,6 +10,8 @@ ms.assetid: 5d4051d3-7b0f-43ea-8c8d-d194bfdceb71 > nonstandard extension used : class rvalue used as lvalue +## Remarks + For compatibility with previous versions of Visual C++, Microsoft extensions (**/Ze**) allow you to use a class type as an rvalue in a context that implicitly or explicitly takes its address. In some cases, such as the example below, this can be dangerous. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md index 3fd260094f2..98a76da2a7f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md @@ -10,6 +10,8 @@ ms.assetid: a23dc16a-649e-4870-9a24-275de1584fcd > nonstandard extension used : 'token' : conversion from 'type' to 'type' +## Remarks + This type conversion is not allowed by the C++ standard, but it is permitted here as an extension. This warning is always followed by at least one line of explanation describing the language rule being violated. ## Examples diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md index f0d4ccb1061..a4d2ad47bf7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md @@ -9,12 +9,16 @@ helpviewer_keywords: ["C4242"] > '*identifier*': conversion from '*type1*' to '*type2*', possible loss of data +## Remarks + The types are different. Type conversion may result in loss of data. The compiler makes the type conversion. 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). For more information on C4242, see [Common Compiler Errors](/windows/win32/WinProg64/common-compiler-errors). +## Example + The following sample generates C4242: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md index 45dd045a043..cf52daba9fd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md @@ -10,8 +10,12 @@ ms.assetid: 85083d53-9cc2-4d12-b58c-6dad28f15cbe > '*conversion*' : conversion from '*type1*' to '*type2*', signed/unsigned mismatch +## Remarks + You tried to convert a **`signed const`** type that has a negative value to an **`unsigned`** type. +## Example + The following sample generates C4245: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md index dbcbdcc801a..110f0188d73 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4254"] > '*operator*': conversion from '*type1*':'*field_bits*' to '*type2*':'*field_bits*', possible loss of data +## Remarks + A larger bit field was assigned to a smaller bit field. There could be a loss of data. 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 + The following sample generates C4254: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md index 4358f2e093d..32c2bcfecdd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4255"] > 'function' : no function prototype given: converting '()' to '(void)' +## Remarks + The compiler didn't find an explicit list of arguments to a function. This warning is for the C compiler only. 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 + The following sample generates C4255: ```c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md index fbde6eb7d74..8f8d9e2e8ed 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md @@ -10,6 +10,8 @@ ms.assetid: a755a32e-895a-4837-a2b5-4ea06b736798 > 'function' : constructor for class with virtual bases has '...'; calls may not be compatible with older versions of Visual C++ +## Remarks + Possible incompatibility. Consider the following code example. If the definition of the constructor S2::S2( int i, ... ) was compiled by using a version of the Microsoft C++ compiler before version 7, but the following example is compiled by using the current version, the call to the constructor for S3 would not work correctly because of a special-case calling-convention change. If both were compiled by using Visual C++ 6.0, the call would not work quite right either, unless no parameters were passed for the ellipsis. @@ -20,6 +22,8 @@ To fix this warning, 1. Make sure that all components in their project are built with the current version (including any libraries that may define or reference this class), then disable the warning using the [warning](../../preprocessor/warning.md) pragma. +## Example + The following sample generates C4256: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md index 7ea2676192a..283fb1d1377 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4263"] > 'function' : member function does not override any base class virtual member function +## Remarks + A class function definition has the same name as a virtual function in a base class but not the same number or type of arguments. This pattern effectively hides the virtual function in the base class. 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 + The following sample generates C4263: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md index 88e8e554dfd..00e053dd810 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4266"] > 'function' : no override available for virtual member function from base 'type'; function is hidden +## Remarks + A derived class didn't override all overloads of a virtual function. 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 + The following sample generates C4266: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md index 20efbfd9a77..b4148b5e6a8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md @@ -10,6 +10,8 @@ ms.assetid: d0511e80-904f-4ee1-b4d7-39b5c0bd8234 > 'identifier' : 'const' static/global data initialized with compiler generated default constructor fills the object with zeros +## Remarks + A **`const`** global or static instance of a non-trivial class is initialized with a compiler-generated default constructor. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md index 2aff8e8df99..3ead28e4280 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md @@ -7,6 +7,8 @@ ms.date: "11/6/2023" > 'conversion' conversion from 'type1' to 'type2', possible loss of data +## Remarks + An integer type is converted to a smaller integer type. - This is a level-4 warning if *type1* is a signed or unsigned **`int`** and *type2* is a smaller, such as a signed or unsigned **`short`**. - It's a level 3 warning if a value of type [`__int64`](../../cpp/int8-int16-int32-int64.md) or **`unsigned __int64`** is assigned to a signed or unsigned **`int`**. A possible loss of data may have occurred due to a narrowing conversion, which might lead to unexpected results. @@ -15,6 +17,8 @@ To fix this warning, either change your program to use compatible types, or add C4244 can also appear when the warning level is 2. For more information, see [Compiler Warning (level 2) C4244](../../error-messages/compiler-warnings/compiler-warning-level-2-c4244.md). +## Examples + The following sample generates C4244: ```cpp From 933dfe85b2015254e4e8619f4188edf9b1bded29 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 23:35:51 +0800 Subject: [PATCH 0998/1799] Replace term "sample" with "example" for warning references in range [C4231, C4270] --- .../compiler-warnings/compiler-warning-level-1-c4237.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4244.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4250.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4243.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4265.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4232.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4239.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4242.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4245.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4254.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4255.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4256.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4263.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4266.md | 2 +- .../compiler-warning-levels-3-and-4-c4244.md | 4 ++-- 15 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md index 1b96053d121..c9cb6149d88 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md @@ -16,7 +16,7 @@ A keyword in the C++ specification is not implemented in the Microsoft C++ compi ## Example -The following sample generates C4237: +The following example generates C4237: ```cpp // C4237.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md index 0c15ba251c7..16b7ef79e65 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md @@ -20,7 +20,7 @@ C4244 can also fire at level 3, and 4; see [Compiler Warning (levels 3 and 4) C4 ## Example -The following sample generates C4244: +The following example generates C4244: ```cpp // C4244_level2.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md index 0006e0a026d..d2752a821a4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md @@ -42,7 +42,7 @@ int main() { } ``` -The following sample generates C4250. +The following example generates C4250. ```cpp // C4250_b.cpp @@ -73,7 +73,7 @@ int main() { } ``` -This sample shows a more complex situation. The following sample generates C4250. +This example shows a more complex situation. The following example generates C4250. ```cpp // C4250_c.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md index 5fd56759f10..6b8dd2c801f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md @@ -15,7 +15,7 @@ A pointer to a derived class is converted to a pointer to a base class, but the ## Example -The following sample generates C4243: +The following example generates C4243: ```cpp // C4243.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md index 62edba89612..e8f511b5bf9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md @@ -17,7 +17,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4265: +The following example generates C4265: ```cpp // C4265.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md index ccffc0d7e13..e10bb222665 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md @@ -16,7 +16,7 @@ Under Microsoft extensions (/Ze), you can give a nonstatic value as the address ## Example -The following sample generates C4232: +The following example generates C4232: ```c // C4232.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md index 98a76da2a7f..6797b2db792 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md @@ -16,7 +16,7 @@ This type conversion is not allowed by the C++ standard, but it is permitted her ## Examples -The following sample generates C4239. +The following example generates C4239. ```cpp // C4239.cpp @@ -34,7 +34,7 @@ void func(void) { Conversion from integral type to enum type is not strictly allowed. -The following sample generates C4239. +The following example generates C4239. ```cpp // C4239b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md index a4d2ad47bf7..defc25de938 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md @@ -19,7 +19,7 @@ For more information on C4242, see [Common Compiler Errors](/windows/win32/WinPr ## Example -The following sample generates C4242: +The following example generates C4242: ```cpp // C4242.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md index cf52daba9fd..ed117fd1232 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md @@ -16,7 +16,7 @@ You tried to convert a **`signed const`** type that has a negative value to an * ## Example -The following sample generates C4245: +The following example generates C4245: ```cpp // C4245.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md index 110f0188d73..03aa6d9f421 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md @@ -17,7 +17,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4254: +The following example generates C4254: ```cpp // C4254.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md index 32c2bcfecdd..3cf27c00e00 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md @@ -17,7 +17,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4255: +The following example generates C4255: ```c // C4255.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md index 8f8d9e2e8ed..c3c017fabe4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md @@ -24,7 +24,7 @@ To fix this warning, ## Example -The following sample generates C4256: +The following example generates C4256: ```cpp // C4256.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md index 283fb1d1377..450639f9694 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md @@ -17,7 +17,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4263: +The following example generates C4263: ```cpp // C4263.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md index 00e053dd810..50751d8f383 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md @@ -17,7 +17,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4266: +The following example generates C4266: ```cpp // C4266.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md index 3ead28e4280..378fbc99270 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md @@ -19,7 +19,7 @@ C4244 can also appear when the warning level is 2. For more information, see [Co ## Examples -The following sample generates C4244: +The following example generates C4244: ```cpp // C4244_level4.cpp @@ -56,7 +56,7 @@ int main() { Warning C4244 can occur when building code for 64-bit targets that doesn't generate the warning when building for 32-bit targets. For example, pointer arithmetic results in a 32-bit quantity on 32-bit platforms, but a 64-bit quantity on 64-bit platforms. -The following sample generates C4244 when compiled for 64-bit targets: +The following example generates C4244 when compiled for 64-bit targets: ```cpp // C4244_level3_b.cpp From 21a2745ce5cb5192c786bfaee852e59664891b3a Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 23:39:52 +0800 Subject: [PATCH 0999/1799] Update metadata for warning references in range [C4231, C4270] --- .../compiler-warnings/compiler-warning-level-1-c4237.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4258.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4264.md | 4 ++-- .../compiler-warnings/compiler-warning-level-2-c4244.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4250.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4240.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4265.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4267.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4232.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4233.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4234.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4238.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4239.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4242.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4245.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4255.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4256.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4263.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4266.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4268.md | 5 ++--- .../compiler-warning-levels-3-and-4-c4244.md | 4 ++-- 21 files changed, 42 insertions(+), 55 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md index c9cb6149d88..122af024123 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4237" title: "Compiler Warning (level 1) C4237" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4237" +ms.date: 11/04/2016 f1_keywords: ["C4237"] helpviewer_keywords: ["C4237"] -ms.assetid: f2e86c4b-80d8-460e-9429-83c5f3f5d7ca --- # Compiler Warning (level 1) C4237 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md index e8617f23c76..a29bd856a5b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4258" title: "Compiler Warning (level 1) C4258" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4258" +ms.date: 11/04/2016 f1_keywords: ["C4258"] helpviewer_keywords: ["C4258"] -ms.assetid: bbb75e6d-6693-4e62-8ed3-b006a0ec55e3 --- # Compiler Warning (level 1) C4258 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md index 04ab31ecfd2..a781621f80a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4264" title: "Compiler Warning (level 4, off) C4264" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4264" +ms.date: 11/04/2016 f1_keywords: ["C4264"] helpviewer_keywords: ["C4264"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md index 16b7ef79e65..e2c76f5572e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4244" title: "Compiler Warning (level 2) C4244" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4244" +ms.date: 11/04/2016 f1_keywords: ["C4244"] helpviewer_keywords: ["C4244"] -ms.assetid: 2c19d157-21d1-42c2-a6c0-3f30f2ce3813 --- # Compiler Warning (level 2) C4244 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md index d2752a821a4..307af8f0eb9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4250" title: "Compiler Warning (level 2) C4250" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4250" +ms.date: 11/04/2016 f1_keywords: ["C4250"] helpviewer_keywords: ["C4250"] -ms.assetid: d47f7249-6b5a-414b-b2d4-56e5d246a782 --- # Compiler Warning (level 2) C4250 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md index 4c0d53e25f6..d7576d2dcae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4240" title: "Compiler Warning (level 3) C4240" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4240" +ms.date: 11/04/2016 f1_keywords: ["C4240"] helpviewer_keywords: ["C4240"] -ms.assetid: a2657cdb-18e1-493f-882b-4e10c0bca71d --- # Compiler Warning (level 3) C4240 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md index e8f511b5bf9..7fecde7c7ef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4265" title: "Compiler Warning (level 3, off) C4265" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3, off) C4265" +ms.date: 11/04/2016 f1_keywords: ["C4265"] helpviewer_keywords: ["C4265"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md index 8c2ae4bc824..3b6989d6744 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4267" title: "Compiler Warning (level 3) C4267" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4267" +ms.date: 11/04/2016 f1_keywords: ["C4267"] helpviewer_keywords: ["C4267"] -ms.assetid: 2fa2f13f-fa4f-47bb-ad8f-6cb19cfc91e6 --- # Compiler Warning (level 3) C4267 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md index e10bb222665..392aa103b9b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4232" title: "Compiler Warning (level 4) C4232" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4232" +ms.date: 11/04/2016 f1_keywords: ["C4232"] helpviewer_keywords: ["C4232"] -ms.assetid: f92028a5-4ddd-43c1-97f5-4f724e5e14af --- # Compiler Warning (level 4) C4232 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md index 525dbd22fe2..0ada63cf907 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4233" title: "Compiler Warning (level 1, Error) C4233" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning (level 1, Error) C4233" +ms.date: 10/25/2017 f1_keywords: ["C4233"] helpviewer_keywords: ["C4233"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md index 331027fbff8..65c487e016e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4234" title: "Compiler Warning (level 4) C4234" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4234" +ms.date: 11/04/2016 f1_keywords: ["C4234"] helpviewer_keywords: ["C4234"] -ms.assetid: f7fecd5c-8248-4fde-8446-502aedc357ca --- # Compiler Warning (level 4) C4234 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md index cf660112a55..cef575afd71 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4238" title: "Compiler Warning (level 4) C4238" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4238" +ms.date: 11/04/2016 f1_keywords: ["C4238"] helpviewer_keywords: ["C4238"] -ms.assetid: 5d4051d3-7b0f-43ea-8c8d-d194bfdceb71 --- # Compiler Warning (level 4) C4238 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md index 6797b2db792..ead032c4b05 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4239" title: "Compiler Warning (level 4) C4239" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4239" +ms.date: 11/04/2016 f1_keywords: ["C4239"] helpviewer_keywords: ["C4239"] -ms.assetid: a23dc16a-649e-4870-9a24-275de1584fcd --- # Compiler Warning (level 4) C4239 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md index defc25de938..e122d51b7c7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4242" title: "Compiler Warning (level 3, off) C4242" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3, off) C4242" +ms.date: 11/04/2016 f1_keywords: ["C4242"] helpviewer_keywords: ["C4242"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md index ed117fd1232..051b3240354 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4245" title: "Compiler Warning (level 4) C4245" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4245" +ms.date: 11/04/2016 f1_keywords: ["C4245"] helpviewer_keywords: ["C4245"] -ms.assetid: 85083d53-9cc2-4d12-b58c-6dad28f15cbe --- # Compiler Warning (level 4) C4245 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md index 3cf27c00e00..0627f04d951 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4255" title: "Compiler Warning (level 4, off) C4255" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4255" +ms.date: 11/04/2016 f1_keywords: ["C4255"] helpviewer_keywords: ["C4255"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md index c3c017fabe4..c7a310e4c0d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4256" title: "Compiler Warning (level 4) C4256" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4256" +ms.date: 11/04/2016 f1_keywords: ["C4256"] helpviewer_keywords: ["C4256"] -ms.assetid: a755a32e-895a-4837-a2b5-4ea06b736798 --- # Compiler Warning (level 4) C4256 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md index 450639f9694..a12a0c9846e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4263" title: "Compiler Warning (level 4, off) C4263" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4263" +ms.date: 11/04/2016 f1_keywords: ["C4263"] helpviewer_keywords: ["C4263"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md index 50751d8f383..9d1dcb0c856 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4266" title: "Compiler Warning (level 4, off) C4266" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4266" +ms.date: 11/04/2016 f1_keywords: ["C4266"] helpviewer_keywords: ["C4266"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md index b4148b5e6a8..f463e36ffa0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4268" title: "Compiler Warning (level 4) C4268" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4268" +ms.date: 11/04/2016 f1_keywords: ["C4268"] helpviewer_keywords: ["C4268"] -ms.assetid: d0511e80-904f-4ee1-b4d7-39b5c0bd8234 --- # Compiler Warning (level 4) C4268 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md index 378fbc99270..68800ee8c01 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (levels 3 and 4) C4244" title: "Compiler Warning (levels 3 and 4) C4244" -ms.date: "11/6/2023" +description: "Learn more about: Compiler Warning (levels 3 and 4) C4244" +ms.date: 11/6/2023 --- # Compiler Warning (levels 3 and 4) C4244 From f4f370d80c0335ae442a27867c5b1338b6d2c992 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 27 Aug 2025 23:43:33 +0800 Subject: [PATCH 1000/1799] Add leading example sentence for warning references in range [C4231, C4270] --- .../compiler-warnings/compiler-warning-level-1-c4251.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4269.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4250.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4240.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4238.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4268.md | 2 ++ 6 files changed, 12 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4251.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4251.md index 1056b7868cf..b0b11764a1c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4251.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4251.md @@ -32,6 +32,8 @@ Think carefully about adding `__declspec(dllexport)` or `__declspec(dllimport)` ## Example +The following example generates C4251: + ```cpp // C4251.cpp // Compile with /std:c++20 /EHsc /W2 /c C4251.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md index d582ed2f126..d5b610b7592 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md @@ -15,6 +15,8 @@ A **`const`** automatic instance of a non-trivial class is initialized with a co ## Example +The following example generates C4269: + ```cpp // C4269.cpp // compile with: /c /LD /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md index 307af8f0eb9..b42f61f058e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md @@ -19,6 +19,8 @@ Because a virtual base class is shared among multiple derived classes, a name in ## Examples +The following example generates C4250: + ```cpp // C4250.cpp // compile with: /c /W2 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md index d7576d2dcae..529f6f70f31 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md @@ -15,6 +15,8 @@ Under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-ext ## Example +The following example generates C4240: + ```cpp // C4240.cpp // compile with: /W3 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md index cef575afd71..686daa1f665 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md @@ -15,6 +15,8 @@ For compatibility with previous versions of Visual C++, Microsoft extensions (** ## Example +The following example generates C4238: + ```cpp // C4238.cpp // compile with: /W4 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md index f463e36ffa0..1ec1be39767 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md @@ -15,6 +15,8 @@ A **`const`** global or static instance of a non-trivial class is initialized wi ## Example +The following example generates C4268: + ```cpp // C4268.cpp // compile with: /c /LD /W4 From 99446fc50954eb52fba02accebad43a8d4097766 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 16:12:42 +0800 Subject: [PATCH 1001/1799] Add blockquotes for warning messages in range [C4271, C4310] --- .../compiler-warnings/compiler-warning-level-1-c4272.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4274.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4276.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4286.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4291.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4297.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4285.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4302.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4307.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4309.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4280.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4281.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4282.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4283.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4290.md | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md index 6ef913aa807..7b141449644 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md @@ -8,7 +8,7 @@ ms.assetid: 0d6c1de4-2eef-42c4-b861-c221f8b495ef --- # Compiler Warning (level 1) C4272 -'function' : is marked __declspec(dllimport); must specify native calling convention when importing a function. +> 'function' : is marked __declspec(dllimport); must specify native calling convention when importing a function. It is an error to export a function marked with the [__clrcall](../../cpp/clrcall.md) calling convention, and the compiler issues this warning if you attempt to import a function marked `__clrcall`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md index 2588a0e4a21..10ceebc0947 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md @@ -8,7 +8,7 @@ ms.assetid: 5a948680-7ed1-469f-978d-ae99d154e161 --- # Compiler Warning (level 1) C4274 -\#ident ignored; see documentation for #pragma comment(exestr, 'string') +> #ident ignored; see documentation for #pragma comment(exestr, 'string') The `#ident` directive, which inserts a user-specified string in the object or executable file, is deprecated. Consequently, the compiler ignores the directive. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md index 7e8473bae3d..ee1726b2235 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md @@ -8,6 +8,6 @@ ms.assetid: 9d738c2d-29e5-408a-b9ff-be1a850b2238 --- # Compiler Warning (level 1) C4276 -'function' : no prototype provided; assumed no parameters +> 'function' : no prototype provided; assumed no parameters When you take the address of a function with the [__stdcall](../../cpp/stdcall.md) calling convention, you must give a prototype so the compiler can create the function's decorated name. Since *function* has no prototype, the compiler, when creating the decorated name, assumes the function has no parameters. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md index a83f7124352..84576d99bd3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md @@ -8,7 +8,7 @@ ms.assetid: 93eadd6c-6f36-413b-ba91-c9aa2314685a --- # Compiler Warning (level 1) C4286 -'type1' : is caught by base class ('type2') on line number +> 'type1' : is caught by base class ('type2') on line number The specified exception type is handled by a previous handler. The type for the second catch is derived from the type of the first. Exceptions for a base class catch exceptions for a derived class. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md index e1e251737f2..91bb4eec20e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md @@ -8,7 +8,7 @@ ms.assetid: c2b95dea-38f2-4609-9104-707c30798da4 --- # Compiler Warning (level 1) C4291 -'declaration' : no matching operator delete found; memory will not be freed if initialization throws an exception +> 'declaration' : no matching operator delete found; memory will not be freed if initialization throws an exception A placement [new](../../cpp/new-operator-cpp.md) is used for which there is no placement [delete](../../cpp/delete-operator-cpp.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md index c300a5b4f1d..b5770e0ff29 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md @@ -8,7 +8,7 @@ ms.assetid: ba92fcdc-9f70-4f60-abe6-281f9582ca59 --- # Compiler Warning (level 1) C4297 -'function' : function assumed not to throw an exception but does +> 'function' : function assumed not to throw an exception but does A function declaration contains a (possibly implicit) **`noexcept`** specifier, an empty **`throw`** exception specifier, or a [__declspec(nothrow)](../../cpp/nothrow-cpp.md) attribute, and the definition contains one or more [throw](../../cpp/try-throw-and-catch-statements-cpp.md) statements. To resolve C4297, do not attempt to throw exceptions in functions that are declared `__declspec(nothrow)`, `noexcept(true)` or `throw()`. Alternatively, remove the **`noexcept`**, `throw()`, or `__declspec(nothrow)` specification. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md index 7b65391add0..0c474cb8be8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md @@ -8,7 +8,7 @@ ms.assetid: fa14de1f-fc19-4eec-8bea-81003636e12f --- # Compiler Warning (level 2) C4285 -return type for 'identifier::operator ->' is recursive if applied using infix notation +> return type for 'identifier::operator ->' is recursive if applied using infix notation The specified **operator->()** function cannot return the type for which it is defined or a reference to the type for which it is defined. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md index 92c0d2d4556..b5ea7f78b82 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md @@ -8,7 +8,7 @@ ms.assetid: f5e1c939-e134-4cca-ba1e-9b15a81549ae --- # Compiler Warning (level 2) C4302 -'conversion' : truncation from 'type 1' to 'type 2' +> 'conversion' : truncation from 'type 1' to 'type 2' The compiler detected a conversion from a larger type to a smaller type. Information may be lost. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md index c2561f469e3..5bb05c05d9a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md @@ -8,7 +8,7 @@ ms.assetid: 7cca11e9-be61-49e4-8b15-88b84f0cbf07 --- # Compiler Warning (level 2) C4307 -'operator' : signed integral constant overflow +> 'operator' : signed integral constant overflow The operator is used in an expression that results in an integer constant overflowing the space allocated for it. You may need to use a larger type for the constant. A **`signed int`** holds a smaller value than an **`unsigned int`** because the **`signed int`** uses one bit to represent the sign. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md index 5ae796582c4..65b174fbb5a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md @@ -8,7 +8,7 @@ ms.assetid: cb3f41ef-fd8a-4def-baa1-924e751fca68 --- # Compiler Warning (level 2) C4309 -'conversion' : truncation of constant value +> 'conversion' : truncation of constant value The type conversion causes a constant to exceed the space allocated for it. You may need to use a larger type for the constant. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md index 09130a82582..e50d7d4bb3b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md @@ -8,7 +8,7 @@ ms.assetid: 153fb639-3ee1-4fee-baf9-71420abcf3f6 --- # Compiler Warning (level 3) C4280 -'operator ->' was self recursive through type 'type' +> 'operator ->' was self recursive through type 'type' Your code incorrectly allows **operator->** to call itself. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md index 02df9c778a9..8b5da8a9fbe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md @@ -8,7 +8,7 @@ ms.assetid: a9771261-5725-4fc6-87b6-16cf92113a25 --- # Compiler Warning (level 3) C4281 -'operator ->' recursion occurred through type 'type' +> 'operator ->' recursion occurred through type 'type' Your code allows **operator->** to call itself. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md index 151121d5b21..d1297f9ef43 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md @@ -8,6 +8,6 @@ ms.assetid: 155bef24-7bd1-497b-a24b-4a0d784b44cd --- # Compiler Warning (level 3) C4282 -then through type 'type' +> then through type 'type' This continuation of warning C4281shows that **operator->** calls itself through `type`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md index 0e2d86ccf6e..ae61afb87be 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md @@ -8,6 +8,6 @@ ms.assetid: c8823f1f-e746-42e2-85ef-270745764c05 --- # Compiler Warning (level 3) C4283 -and through type 'type' +> and through type 'type' This continuation of warning [C4281](../../error-messages/compiler-warnings/compiler-warning-level-3-c4281.md) shows that **operator->** calls itself through `type`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md index aaa839fdef3..db8fd983902 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md @@ -8,7 +8,7 @@ ms.assetid: d1c6d85b-28e0-4a1f-9d48-23593337a6fb --- # Compiler Warning (level 3) C4290 -C++ exception specification ignored except to indicate a function is not __declspec(nothrow) +> C++ exception specification ignored except to indicate a function is not __declspec(nothrow) A function is declared using exception specification, which Visual C++ accepts but does not implement. Code with exception specifications that are ignored during compilation may need to be recompiled and linked to be reused in future versions supporting exception specifications. From 8e00f1689d10d654f813388c181c47a5f260b79e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 16:21:50 +0800 Subject: [PATCH 1002/1799] Add "Remarks" and "Example" headings for warning references in range [C4271, C4310] --- .../compiler-warnings/compiler-warning-level-1-c4272.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4273.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4274.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4276.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4286.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4288.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4291.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4293.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4297.md | 4 ++++ .../compiler-warnings/compiler-warning-level-2-c4275.md | 4 ++++ .../compiler-warnings/compiler-warning-level-2-c4285.md | 4 ++++ .../compiler-warnings/compiler-warning-level-2-c4302.md | 4 ++++ .../compiler-warnings/compiler-warning-level-2-c4307.md | 4 ++++ .../compiler-warnings/compiler-warning-level-2-c4309.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4278.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4280.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4281.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4282.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4283.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4287.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4290.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4306.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4310.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-4-c4289.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4295.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4296.md | 4 ++++ 26 files changed, 88 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md index 7b141449644..5f003c43a49 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md @@ -10,8 +10,12 @@ ms.assetid: 0d6c1de4-2eef-42c4-b861-c221f8b495ef > 'function' : is marked __declspec(dllimport); must specify native calling convention when importing a function. +## Remarks + It is an error to export a function marked with the [__clrcall](../../cpp/clrcall.md) calling convention, and the compiler issues this warning if you attempt to import a function marked `__clrcall`. +## Example + The following sample generates C4272: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md index 4bd91a8079a..51eb57dec39 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md @@ -10,6 +10,8 @@ ms.assetid: cc18611d-9454-40a4-ad73-69823d5888fb > '*function*' : inconsistent DLL linkage +## Remarks + Two definitions in a file differ in their use of [`dllimport`](../../cpp/dllexport-dllimport.md). ## Examples diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md index 10ceebc0947..84c0316692d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md @@ -10,6 +10,8 @@ ms.assetid: 5a948680-7ed1-469f-978d-ae99d154e161 > #ident ignored; see documentation for #pragma comment(exestr, 'string') +## Remarks + The `#ident` directive, which inserts a user-specified string in the object or executable file, is deprecated. Consequently, the compiler ignores the directive. > [!CAUTION] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md index ee1726b2235..a11868235f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md @@ -10,4 +10,6 @@ ms.assetid: 9d738c2d-29e5-408a-b9ff-be1a850b2238 > 'function' : no prototype provided; assumed no parameters +## Remarks + When you take the address of a function with the [__stdcall](../../cpp/stdcall.md) calling convention, you must give a prototype so the compiler can create the function's decorated name. Since *function* has no prototype, the compiler, when creating the decorated name, assumes the function has no parameters. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md index 84576d99bd3..e4c705b60d2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md @@ -10,6 +10,8 @@ ms.assetid: 93eadd6c-6f36-413b-ba91-c9aa2314685a > 'type1' : is caught by base class ('type2') on line number +## Remarks + The specified exception type is handled by a previous handler. The type for the second catch is derived from the type of the first. Exceptions for a base class catch exceptions for a derived class. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md index 67b2cfa8515..58281001bbb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md @@ -10,10 +10,14 @@ ms.assetid: 6aaeb139-90cd-457a-9d37-65687042736f > nonstandard extension used : 'var' : loop control variable declared in the for-loop is used outside the for-loop scope; it conflicts with the declaration in the outer scope +## Remarks + When compiling with [`/Ze`](../../build/reference/za-ze-disable-language-extensions.md) and **/Zc:forscope-**, a variable declared in a **`for`** loop was used after the [for](../../cpp/for-statement-cpp.md)-loop scope. A Microsoft extension to the C++ language allows this variable to remain in scope, and C4288 reminds you that the first declaration of the variable is not used. See [`/Zc:forScope`](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md) for information about how to specify the Microsoft extension in **`for`** loops with /Ze. +## Example + The following sample generates C4288: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md index 91bb4eec20e..2ae3d9d4e64 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md @@ -10,13 +10,19 @@ ms.assetid: c2b95dea-38f2-4609-9104-707c30798da4 > 'declaration' : no matching operator delete found; memory will not be freed if initialization throws an exception +## Remarks + A placement [new](../../cpp/new-operator-cpp.md) is used for which there is no placement [delete](../../cpp/delete-operator-cpp.md). When memory is allocated for an object with operator **`new`**, the object's constructor is called. If the constructor throws an exception, any memory that was allocated for the object should be deallocated. This cannot take place unless an operator **`delete`** function exists that matches the operator **`new`**. If you use the operator **`new`** without any extra arguments and compile with [/GX](../../build/reference/gx-enable-exception-handling.md), [/EHs](../../build/reference/eh-exception-handling-model.md), or /EHa options to enable exception handling, the compiler will generate code to call operator **`delete`** if the constructor throws an exception. -If you use the placement form of the **`new`** operator (the form with arguments in addition to the size of the allocation) and the object's constructor throws an exception, the compiler will still generate code to call operator **`delete`**; but it will only do so if a placement form of operator **`delete`** exists matching the placement form of the operator **`new`** that allocated the memory. For example: +If you use the placement form of the **`new`** operator (the form with arguments in addition to the size of the allocation) and the object's constructor throws an exception, the compiler will still generate code to call operator **`delete`**; but it will only do so if a placement form of operator **`delete`** exists matching the placement form of the operator **`new`** that allocated the memory. + +## Example + +For example: ```cpp // C4291.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md index 288d303e446..d632322b5d2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md @@ -10,10 +10,10 @@ ms.assetid: babecd96-eb51-41a5-9835-462c7a46dbad > '*operator*' : shift count negative or too big, undefined behavior -If a shift count is negative or too large, the behavior of the resulting image is undefined. - ## Remarks +If a shift count is negative or too large, the behavior of the resulting image is undefined. + To resolve this issue, you can use a cast on the first operand to expand it to the size of the result type. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md index b5770e0ff29..032746dab70 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md @@ -10,6 +10,8 @@ ms.assetid: ba92fcdc-9f70-4f60-abe6-281f9582ca59 > 'function' : function assumed not to throw an exception but does +## Remarks + A function declaration contains a (possibly implicit) **`noexcept`** specifier, an empty **`throw`** exception specifier, or a [__declspec(nothrow)](../../cpp/nothrow-cpp.md) attribute, and the definition contains one or more [throw](../../cpp/try-throw-and-catch-statements-cpp.md) statements. To resolve C4297, do not attempt to throw exceptions in functions that are declared `__declspec(nothrow)`, `noexcept(true)` or `throw()`. Alternatively, remove the **`noexcept`**, `throw()`, or `__declspec(nothrow)` specification. By default, the compiler generates implicit `noexcept(true)` specifiers for user-defined destructors and deallocator functions and compiler-generated special member functions. This conforms to the ISO C++11 standard. To prevent generation of implicit noexcept specifiers and revert the compiler to the non-standard behavior of Visual Studio 2013, use the **/Zc:implicitNoexcept-** compiler option. For more information, see [/Zc:implicitNoexcept (Implicit Exception Specifiers)](../../build/reference/zc-implicitnoexcept-implicit-exception-specifiers.md). @@ -18,6 +20,8 @@ For more information on exception specifications, see [Exception Specifications This warning is also generated for __declspec([dllexport](../../cpp/dllexport-dllimport.md)) functions marked extern "C", even if they are C++ functions. +## Example + The following sample generates C4297: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md index cd48f23132a..041b7ba7d17 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md @@ -10,6 +10,8 @@ ms.assetid: 18de967a-0a44-4dbc-a2e8-fc4c067ba909 > non - DLL-interface class '*class_1*' used as base for DLL-interface class '*class_2*' +## Remarks + An exported class was derived from a class that wasn't exported. To minimize the possibility of data corruption when exporting a class with [__declspec(dllexport)](../../cpp/dllexport-dllimport.md), make sure that: @@ -28,6 +30,8 @@ You can avoid exporting classes by defining a DLL that defines a class with virt C4275 can be ignored in Visual C++ if you are deriving from a type in the C++ Standard Library, compiling a debug release (**/MTd**) and where the compiler error message refers to `_Container_base`. +## Example + ```cpp // C4275.cpp // compile with: /EHsc /MTd /W2 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md index 0c474cb8be8..920bcfdda73 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md @@ -10,8 +10,12 @@ ms.assetid: fa14de1f-fc19-4eec-8bea-81003636e12f > return type for 'identifier::operator ->' is recursive if applied using infix notation +## Remarks + The specified **operator->()** function cannot return the type for which it is defined or a reference to the type for which it is defined. +## Example + The following sample generates C4285: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md index b5ea7f78b82..73cdc962df1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md @@ -10,10 +10,14 @@ ms.assetid: f5e1c939-e134-4cca-ba1e-9b15a81549ae > 'conversion' : truncation from 'type 1' to 'type 2' +## Remarks + The compiler detected a conversion from a larger type to a smaller type. Information may be lost. 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 C4302: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md index 5bb05c05d9a..01c3465ac68 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md @@ -10,8 +10,12 @@ ms.assetid: 7cca11e9-be61-49e4-8b15-88b84f0cbf07 > 'operator' : signed integral constant overflow +## Remarks + The operator is used in an expression that results in an integer constant overflowing the space allocated for it. You may need to use a larger type for the constant. A **`signed int`** holds a smaller value than an **`unsigned int`** because the **`signed int`** uses one bit to represent the sign. +## Example + The following sample generates C4307: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md index 65b174fbb5a..93099fe47ec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md @@ -10,8 +10,12 @@ ms.assetid: cb3f41ef-fd8a-4def-baa1-924e751fca68 > 'conversion' : truncation of constant value +## Remarks + The type conversion causes a constant to exceed the space allocated for it. You may need to use a larger type for the constant. +## Example + The following sample generates C4309: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md index 464d6497f33..2d402b98346 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C4278"] > '*identifier*': identifier in type library '*tlb*' is already a macro; use the 'rename' qualifier +## Remarks + 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. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md index e50d7d4bb3b..e16e47f4b0c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md @@ -10,8 +10,12 @@ ms.assetid: 153fb639-3ee1-4fee-baf9-71420abcf3f6 > 'operator ->' was self recursive through type 'type' +## Remarks + Your code incorrectly allows **operator->** to call itself. +## Example + The following sample generates C4280: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md index 8b5da8a9fbe..d24e3f97654 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md @@ -10,8 +10,12 @@ ms.assetid: a9771261-5725-4fc6-87b6-16cf92113a25 > 'operator ->' recursion occurred through type 'type' +## Remarks + Your code allows **operator->** to call itself. +## Example + The following sample generates C4281: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md index d1297f9ef43..99fad3992fb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md @@ -10,4 +10,6 @@ ms.assetid: 155bef24-7bd1-497b-a24b-4a0d784b44cd > then through type 'type' +## Remarks + This continuation of warning C4281shows that **operator->** calls itself through `type`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md index ae61afb87be..da1aeedcc4a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md @@ -10,4 +10,6 @@ ms.assetid: c8823f1f-e746-42e2-85ef-270745764c05 > and through type 'type' +## Remarks + This continuation of warning [C4281](../../error-messages/compiler-warnings/compiler-warning-level-3-c4281.md) shows that **operator->** calls itself through `type`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md index 989066bb6b0..6fd7397074f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4287"] > 'operator' : unsigned/negative constant mismatch +## Remarks + An unsigned variable was used in an operation with a negative number. 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). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md index db8fd983902..3f15adef8f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md @@ -10,6 +10,8 @@ ms.assetid: d1c6d85b-28e0-4a1f-9d48-23593337a6fb > C++ exception specification ignored except to indicate a function is not __declspec(nothrow) +## Remarks + A function is declared using exception specification, which Visual C++ accepts but does not implement. Code with exception specifications that are ignored during compilation may need to be recompiled and linked to be reused in future versions supporting exception specifications. For more information, see [Exception Specifications (throw)](../../cpp/exception-specifications-throw-cpp.md) . @@ -20,6 +22,8 @@ You can avoid this warning by using the [warning](../../preprocessor/warning.md) #pragma warning( disable : 4290 ) ``` +## Example + The following code sample generates C4290: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md index 0e334e644ec..3754905b0dc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4306"] > '*conversion*': conversion from '*type1*' to '*type2*' of greater size +## Remarks + The identifier is type cast to a larger pointer. The unfilled high bits of the new type are zero-filled. This warning may indicate an unwanted conversion. The resulting pointer may not be valid. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md index 97a146b5766..7b20196cbab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md @@ -9,7 +9,13 @@ helpviewer_keywords: ["C4310"] > cast truncates constant value -A constant value is cast to a smaller type. The compiler performs the cast, which truncates data. The following sample generates C4310: +## Remarks + +A constant value is cast to a smaller type. The compiler performs the cast, which truncates data. + +## Example + +The following sample generates C4310: ```cpp // C4310.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md index e12bb325ac9..50bf4b73e96 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md @@ -9,12 +9,16 @@ helpviewer_keywords: ["C4289"] > nonstandard extension used : 'var' : loop control variable declared in the `for`-loop is used outside the `for`-loop scope +## Remarks + When [/Ze](../../build/reference/za-ze-disable-language-extensions.md) and **/Zc:forScope-** are used in a build, a variable declared in a [`for`](../../cpp/for-statement-cpp.md) loop was used after the **`for`**-loop scope. See [/Zc:forScope](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md) for information about how to specify standard behavior in **`for`** loops with **/Ze**. 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 + The following sample generates C4289: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md index f14ac9570c2..4b8cae115a1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md @@ -10,6 +10,8 @@ ms.assetid: 20dbff85-9f62-4ca3-8fe9-079d4512006d > '*array*' : array is too small to include a terminating null character +## Remarks + An array was initialized but the last character in the array is not a null; accessing the array as a string may produce unexpected results. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md index 39cb0b6e93b..1e7c0c85a3d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4296"] > 'operator' : expression is always false +## Remarks + An unsigned variable was used in a comparison operation with zero. 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 + The following sample generates C4296: ```cpp From 38ab8847f58b072d062c394cae3776b13c144acd Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 16:23:19 +0800 Subject: [PATCH 1003/1799] Replace term "sample" with "example" for warning references in range [C4271, C4310] --- .../compiler-warnings/compiler-warning-level-1-c4272.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4273.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4288.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4293.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4297.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4305.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4285.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4302.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4307.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4309.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4280.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4281.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4287.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4290.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4310.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4289.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4295.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4296.md | 2 +- 18 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md index 5f003c43a49..cc4b95d6d62 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md @@ -16,7 +16,7 @@ It is an error to export a function marked with the [__clrcall](../../cpp/clrcal ## Example -The following sample generates C4272: +The following example generates C4272: ```cpp // C4272.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md index 51eb57dec39..dbbfd54bbaa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md @@ -16,7 +16,7 @@ Two definitions in a file differ in their use of [`dllimport`](../../cpp/dllexpo ## Examples -The following sample generates C4273, and shows how to fix it. +The following example generates C4273, and shows how to fix it. ```cpp // C4273.cpp @@ -25,7 +25,7 @@ char __declspec(dllimport) c; char c; // C4273, delete this line or the line above to resolve ``` -The following sample generates C4273. To fix it, delete the redeclaration of `printf_s`. +The following example generates C4273. To fix it, delete the redeclaration of `printf_s`. ```cpp // C4273_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md index 58281001bbb..6cda904d020 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md @@ -18,7 +18,7 @@ See [`/Zc:forScope`](../../build/reference/zc-forscope-force-conformance-in-for- ## Example -The following sample generates C4288: +The following example generates C4288: ```cpp // C4288.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md index d632322b5d2..ba93b738e3e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md @@ -18,7 +18,7 @@ To resolve this issue, you can use a cast on the first operand to expand it to t ## Example -The following sample generates C4293, and shows ways to fix it: +The following example generates C4293, and shows ways to fix it: ```cpp // C4293.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md index 032746dab70..cc2492855dd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md @@ -22,7 +22,7 @@ This warning is also generated for __declspec([dllexport](../../cpp/dllexport-dl ## Example -The following sample generates C4297: +The following example generates C4297: ```cpp // C4297.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md index ba2979d7c62..608e0d5fb43 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md @@ -15,7 +15,7 @@ This warning is issued when a value is converted to a smaller type in an initial ## Example -This sample shows two ways you might see this warning: +This example shows two ways you might see this warning: ```cpp // C4305.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md index 920bcfdda73..f07674b85c8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md @@ -16,7 +16,7 @@ The specified **operator->()** function cannot return the type for which it is d ## Example -The following sample generates C4285: +The following example generates C4285: ```cpp // C4285.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md index 73cdc962df1..27cd50d02a1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4302: +The following example generates C4302: ```cpp // C4302.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md index 01c3465ac68..b9aabb55566 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md @@ -16,7 +16,7 @@ The operator is used in an expression that results in an integer constant overfl ## Example -The following sample generates C4307: +The following example generates C4307: ```cpp // C4307.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md index 93099fe47ec..6de843038ec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md @@ -16,7 +16,7 @@ The type conversion causes a constant to exceed the space allocated for it. You ## Example -The following sample generates C4309: +The following example generates C4309: ```cpp // C4309.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md index e16e47f4b0c..24ea6b01858 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md @@ -16,7 +16,7 @@ Your code incorrectly allows **operator->** to call itself. ## Example -The following sample generates C4280: +The following example generates C4280: ```cpp // C4280.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md index d24e3f97654..795bfa533a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md @@ -16,7 +16,7 @@ Your code allows **operator->** to call itself. ## Example -The following sample generates C4281: +The following example generates C4281: ```cpp // C4281.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md index 6fd7397074f..7a0bf3849b6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md @@ -17,7 +17,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4287: +The following example generates C4287: ```cpp // C4287.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md index 3f15adef8f4..d3892d254a3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md @@ -24,7 +24,7 @@ You can avoid this warning by using the [warning](../../preprocessor/warning.md) ## Example -The following code sample generates C4290: +The following example generates C4290: ```cpp // C4290.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md index 7b20196cbab..fd4f3dd6c97 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md @@ -15,7 +15,7 @@ A constant value is cast to a smaller type. The compiler performs the cast, whic ## Example -The following sample generates C4310: +The following example generates C4310: ```cpp // C4310.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md index 50bf4b73e96..efa6bf7868a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md @@ -19,7 +19,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4289: +The following example generates C4289: ```cpp // C4289.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md index 4b8cae115a1..9afe1430d5f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md @@ -16,7 +16,7 @@ An array was initialized but the last character in the array is not a null; acce ## Example -The following sample generates C4295. To fix this issue, you could declare the array size larger, to hold a terminating null from the initializer string, or you could use an array initializer list to make the intent clear that this is an array of **`char`**, not a null-terminated string. +The following example generates C4295. To fix this issue, you could declare the array size larger, to hold a terminating null from the initializer string, or you could use an array initializer list to make the intent clear that this is an array of **`char`**, not a null-terminated string. ```C // C4295.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md index 1e7c0c85a3d..b43115dae2a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md @@ -17,7 +17,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4296: +The following example generates C4296: ```cpp // C4296.cpp From 758d00e3103ee191092a148a384f3d1d06f3175e Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 16:27:31 +0800 Subject: [PATCH 1004/1799] Update metadata for warning references in range [C4271, C4310] --- .../compiler-warnings/compiler-warning-level-1-c4272.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4273.md | 3 +-- .../compiler-warnings/compiler-warning-level-1-c4274.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4276.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4286.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4288.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4291.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4293.md | 1 - .../compiler-warnings/compiler-warning-level-1-c4297.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4305.md | 4 ++-- .../compiler-warnings/compiler-warning-level-2-c4275.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4285.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4302.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4307.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4308.md | 3 +-- .../compiler-warnings/compiler-warning-level-2-c4309.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4278.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4280.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4281.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4282.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4283.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4287.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4290.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4306.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4310.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4289.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4295.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4296.md | 4 ++-- 28 files changed, 51 insertions(+), 72 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md index cc4b95d6d62..d4f042ea5c1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4272" title: "Compiler Warning (level 1) C4272" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4272" +ms.date: 11/04/2016 f1_keywords: ["C4272"] helpviewer_keywords: ["C4272"] -ms.assetid: 0d6c1de4-2eef-42c4-b861-c221f8b495ef --- # Compiler Warning (level 1) C4272 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md index dbbfd54bbaa..d53d8ece27c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4273" title: "Compiler Warning (level 1) C4273" +description: "Learn more about: Compiler Warning (level 1) C4273" ms.date: 05/23/2022 f1_keywords: ["C4273"] helpviewer_keywords: ["C4273"] -ms.assetid: cc18611d-9454-40a4-ad73-69823d5888fb --- # Compiler Warning (level 1) C4273 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md index 84c0316692d..6e7ea2759ce 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4274" title: "Compiler Warning (level 1) C4274" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4274" +ms.date: 11/04/2016 f1_keywords: ["C4274"] helpviewer_keywords: ["C4274"] -ms.assetid: 5a948680-7ed1-469f-978d-ae99d154e161 --- # Compiler Warning (level 1) C4274 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md index a11868235f2..cd9812fc4e8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4276" title: "Compiler Warning (level 1) C4276" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4276" +ms.date: 11/04/2016 f1_keywords: ["C4276"] helpviewer_keywords: ["C4276"] -ms.assetid: 9d738c2d-29e5-408a-b9ff-be1a850b2238 --- # Compiler Warning (level 1) C4276 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md index e4c705b60d2..d2b4d0dd1be 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4286" title: "Compiler Warning (level 1) C4286" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4286" +ms.date: 11/04/2016 f1_keywords: ["C4286"] helpviewer_keywords: ["C4286"] -ms.assetid: 93eadd6c-6f36-413b-ba91-c9aa2314685a --- # Compiler Warning (level 1) C4286 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md index 6cda904d020..5a7b2f7bc3d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4288" title: "Compiler Warning (level 1) C4288" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4288" +ms.date: 11/04/2016 f1_keywords: ["C4288"] helpviewer_keywords: ["C4288"] -ms.assetid: 6aaeb139-90cd-457a-9d37-65687042736f --- # Compiler Warning (level 1) C4288 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md index 2ae3d9d4e64..fb8a23defbe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4291" title: "Compiler Warning (level 1) C4291" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4291" +ms.date: 11/04/2016 f1_keywords: ["C4291"] helpviewer_keywords: ["C4291"] -ms.assetid: c2b95dea-38f2-4609-9104-707c30798da4 --- # Compiler Warning (level 1) C4291 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md index ba93b738e3e..cb24eb825ba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md @@ -4,7 +4,6 @@ description: "Describes the causes of MSVC compiler warning C4293, and shows how ms.date: 07/15/2020 f1_keywords: ["C4293"] helpviewer_keywords: ["C4293"] -ms.assetid: babecd96-eb51-41a5-9835-462c7a46dbad --- # Compiler Warning (level 1) C4293 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md index cc2492855dd..25b6d26a536 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4297" title: "Compiler Warning (level 1) C4297" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4297" +ms.date: 11/04/2016 f1_keywords: ["C4297"] helpviewer_keywords: ["C4297"] -ms.assetid: ba92fcdc-9f70-4f60-abe6-281f9582ca59 --- # Compiler Warning (level 1) C4297 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md index 608e0d5fb43..b34e71b9984 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 2 and level 4) C4305" title: "Compiler Warning (level 1 and level 2 and level 4) C4305" -ms.date: "01/17/2018" +description: "Learn more about: Compiler Warning (level 1 and level 2 and level 4) C4305" +ms.date: 01/17/2018 f1_keywords: ["C4305"] helpviewer_keywords: ["C4305"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md index 041b7ba7d17..0ce93f51039 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4275" title: "Compiler Warning (level 2) C4275" -ms.date: "02/08/2019" +description: "Learn more about: Compiler Warning (level 2) C4275" +ms.date: 02/08/2019 f1_keywords: ["C4275"] helpviewer_keywords: ["C4275"] -ms.assetid: 18de967a-0a44-4dbc-a2e8-fc4c067ba909 --- # Compiler Warning (level 2) C4275 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md index f07674b85c8..dec38cac563 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4285" title: "Compiler Warning (level 2) C4285" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4285" +ms.date: 11/04/2016 f1_keywords: ["C4285"] helpviewer_keywords: ["C4285"] -ms.assetid: fa14de1f-fc19-4eec-8bea-81003636e12f --- # Compiler Warning (level 2) C4285 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md index 27cd50d02a1..9631ebfbff3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4302" title: "Compiler Warning (level 2) C4302" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4302" +ms.date: 11/04/2016 f1_keywords: ["C4302"] helpviewer_keywords: ["C4302"] -ms.assetid: f5e1c939-e134-4cca-ba1e-9b15a81549ae --- # Compiler Warning (level 2) C4302 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md index b9aabb55566..8dffb8c1508 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4307" title: "Compiler Warning (level 2) C4307" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4307" +ms.date: 11/04/2016 f1_keywords: ["C4307"] helpviewer_keywords: ["C4307"] -ms.assetid: 7cca11e9-be61-49e4-8b15-88b84f0cbf07 --- # Compiler Warning (level 2) C4307 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md index 0f1b82759f9..05654efd527 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4308" title: "Compiler Warning (level 2) C4308" +description: "Learn more about: Compiler Warning (level 2) C4308" ms.date: 08/30/2022 f1_keywords: ["C4308"] helpviewer_keywords: ["C4308"] -ms.assetid: d4e5c53c-71b2-4bbc-8a7c-3a2a3180d9d9 --- # Compiler Warning (level 2) C4308 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md index 6de843038ec..fecac92eab3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4309" title: "Compiler Warning (level 2) C4309" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4309" +ms.date: 11/04/2016 f1_keywords: ["C4309"] helpviewer_keywords: ["C4309"] -ms.assetid: cb3f41ef-fd8a-4def-baa1-924e751fca68 --- # Compiler Warning (level 2) C4309 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md index 2d402b98346..86dd293c9a9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md @@ -1,7 +1,7 @@ --- -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" +description: "Learn more about: Compiler Warning (level 3 and level 4) C4278" +ms.date: 08/27/2018 f1_keywords: ["C4278"] helpviewer_keywords: ["C4278"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md index 24ea6b01858..4ae40b56b8b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4280" title: "Compiler Warning (level 3) C4280" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4280" +ms.date: 11/04/2016 f1_keywords: ["C4280"] helpviewer_keywords: ["C4280"] -ms.assetid: 153fb639-3ee1-4fee-baf9-71420abcf3f6 --- # Compiler Warning (level 3) C4280 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md index 795bfa533a6..9426d177374 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4281" title: "Compiler Warning (level 3) C4281" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4281" +ms.date: 11/04/2016 f1_keywords: ["C4281"] helpviewer_keywords: ["C4281"] -ms.assetid: a9771261-5725-4fc6-87b6-16cf92113a25 --- # Compiler Warning (level 3) C4281 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md index 99fad3992fb..397b03cdf2a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4282" title: "Compiler Warning (level 3) C4282" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4282" +ms.date: 11/04/2016 f1_keywords: ["C4282"] helpviewer_keywords: ["C4282"] -ms.assetid: 155bef24-7bd1-497b-a24b-4a0d784b44cd --- # Compiler Warning (level 3) C4282 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md index da1aeedcc4a..98f9c84badd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4283" title: "Compiler Warning (level 3) C4283" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4283" +ms.date: 11/04/2016 f1_keywords: ["C4283"] helpviewer_keywords: ["C4283"] -ms.assetid: c8823f1f-e746-42e2-85ef-270745764c05 --- # Compiler Warning (level 3) C4283 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md index 7a0bf3849b6..99d48f7475c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4287" title: "Compiler Warning (level 3, off) C4287" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3, off) C4287" +ms.date: 11/04/2016 f1_keywords: ["C4287"] helpviewer_keywords: ["C4287"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md index d3892d254a3..ad2acf66d4e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4290" title: "Compiler Warning (level 3) C4290" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4290" +ms.date: 11/04/2016 f1_keywords: ["C4290"] helpviewer_keywords: ["C4290"] -ms.assetid: d1c6d85b-28e0-4a1f-9d48-23593337a6fb --- # Compiler Warning (level 3) C4290 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md index 3754905b0dc..aba692f1c11 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4306" title: "Compiler Warning (level 4) C4306" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 4) C4306" +ms.date: 08/27/2018 f1_keywords: ["C4306"] helpviewer_keywords: ["C4306"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md index fd4f3dd6c97..f929a873d2b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4310" title: "Compiler Warning (level 4) C4310" +description: "Learn more about: Compiler Warning (level 4) C4310" ms.date: 10/17/2023 f1_keywords: ["C4310"] helpviewer_keywords: ["C4310"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md index efa6bf7868a..62b99960d88 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4289" title: "Compiler Warning (level 4, off) C4289" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4289" +ms.date: 11/04/2016 f1_keywords: ["C4289"] helpviewer_keywords: ["C4289"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md index 9afe1430d5f..05a88c4b3b7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4295" title: "Compiler Warning (level 4) C4295" -ms.date: "01/09/2018" +description: "Learn more about: Compiler Warning (level 4) C4295" +ms.date: 01/09/2018 f1_keywords: ["C4295"] helpviewer_keywords: ["C4295"] -ms.assetid: 20dbff85-9f62-4ca3-8fe9-079d4512006d --- # Compiler Warning (level 4) C4295 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md index b43115dae2a..3f8d63d993a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4296" title: "Compiler Warning (level 4, off) C4296" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4296" +ms.date: 11/04/2016 f1_keywords: ["C4296"] helpviewer_keywords: ["C4296"] --- From aee3048f4fa8f829f081d869bedb8341f252b31f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 16:30:02 +0800 Subject: [PATCH 1005/1799] Add leading example sentence for warning references in range [C4271, C4310] --- .../compiler-warnings/compiler-warning-level-1-c4286.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4275.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4308.md | 2 ++ 3 files changed, 6 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md index d2b4d0dd1be..248b4040981 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md @@ -15,6 +15,8 @@ The specified exception type is handled by a previous handler. The type for the ## Example +The following example generates C4286: + ```cpp //C4286.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md index 0ce93f51039..1488b7a2b6d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md @@ -31,6 +31,8 @@ C4275 can be ignored in Visual C++ if you are deriving from a type in the C++ St ## Example +The following example generates C4275: + ```cpp // C4275.cpp // compile with: /EHsc /MTd /W2 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md index 05654efd527..10ca720e0fa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md @@ -17,6 +17,8 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example +The following example generates C4308: + ```cpp // C4308.cpp // compile with: /W2 From 00ac1d7110ee46a580dd6c5ece3722efcc9c32a5 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 17:18:24 +0800 Subject: [PATCH 1006/1799] Add backticks in `std::rank` reference --- docs/standard-library/rank-class.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/standard-library/rank-class.md b/docs/standard-library/rank-class.md index 7812e4b0417..1992e403c7e 100644 --- a/docs/standard-library/rank-class.md +++ b/docs/standard-library/rank-class.md @@ -6,7 +6,7 @@ f1_keywords: ["type_traits/std::rank"] helpviewer_keywords: ["rank class", "rank"] ms.assetid: bc9f1b8f-800f-46ca-b6f4-d8579ed5406a --- -# rank Class +# `rank` Class Gets number of array dimensions. @@ -19,12 +19,12 @@ struct rank; ### Parameters -*Ty*\ +*`Ty`*\ The type to query. ## Remarks -The type query holds the value of the number of dimensions of the array type *Ty*, or 0 if *Ty* is not an array type. +The type query holds the value of the number of dimensions of the array type *`Ty`*, or 0 if *`Ty`* is not an array type. ## Example @@ -55,11 +55,11 @@ rank == 2 ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[](../standard-library/type-traits.md)\ -[extent Class](../standard-library/extent-class.md) +[``](../standard-library/type-traits.md)\ +[`extent` Class](../standard-library/extent-class.md) From 373eca00277f34afa73982a7bef4b689226ff244 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 17:19:09 +0800 Subject: [PATCH 1007/1799] Convert "Class" to lowercase in `std::rank` reference --- docs/standard-library/rank-class.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/rank-class.md b/docs/standard-library/rank-class.md index 1992e403c7e..f5b6f450932 100644 --- a/docs/standard-library/rank-class.md +++ b/docs/standard-library/rank-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: rank Class" -title: "rank Class" +description: "Learn more about: rank class" +title: "rank class" ms.date: "11/04/2016" f1_keywords: ["type_traits/std::rank"] helpviewer_keywords: ["rank class", "rank"] ms.assetid: bc9f1b8f-800f-46ca-b6f4-d8579ed5406a --- -# `rank` Class +# `rank` class Gets number of array dimensions. @@ -62,4 +62,4 @@ rank == 2 ## See also [``](../standard-library/type-traits.md)\ -[`extent` Class](../standard-library/extent-class.md) +[`extent` class](../standard-library/extent-class.md) From 049f4df6cd49e9cf8d8b37dfc3aa62eaa90b6c3b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 17:20:57 +0800 Subject: [PATCH 1008/1799] Rename "Parameters" heading to "Template parameters" in `std::rank` reference --- docs/standard-library/rank-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/rank-class.md b/docs/standard-library/rank-class.md index f5b6f450932..ff7eb7dcc6e 100644 --- a/docs/standard-library/rank-class.md +++ b/docs/standard-library/rank-class.md @@ -17,7 +17,7 @@ template struct rank; ``` -### Parameters +### Template parameters *`Ty`*\ The type to query. From 5b2e9fd7e1c12573088977e70ee5e27d7993a956 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 17:23:16 +0800 Subject: [PATCH 1009/1799] Change `Ty` template parameter to `Type` in `std::rank` reference --- docs/standard-library/rank-class.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/rank-class.md b/docs/standard-library/rank-class.md index ff7eb7dcc6e..a8cd9863d87 100644 --- a/docs/standard-library/rank-class.md +++ b/docs/standard-library/rank-class.md @@ -13,18 +13,18 @@ Gets number of array dimensions. ## Syntax ```cpp -template +template struct rank; ``` ### Template parameters -*`Ty`*\ +*`Type`*\ The type to query. ## Remarks -The type query holds the value of the number of dimensions of the array type *`Ty`*, or 0 if *`Ty`* is not an array type. +The type query holds the value of the number of dimensions of the array type *`Type`*, or 0 if *`Type`* is not an array type. ## Example From 837eada6c2458062f96a6555e64bdfd5d09cac7b Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 17:34:20 +0800 Subject: [PATCH 1010/1799] Expand example in `std::rank` reference --- docs/standard-library/rank-class.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/rank-class.md b/docs/standard-library/rank-class.md index a8cd9863d87..386fbf155ed 100644 --- a/docs/standard-library/rank-class.md +++ b/docs/standard-library/rank-class.md @@ -31,11 +31,12 @@ The type query holds the value of the number of dimensions of the array type *`T ```cpp // std__type_traits__rank.cpp // compile with: /EHsc + #include #include int main() - { +{ std::cout << "rank == " << std::rank::value << std::endl; std::cout << "rank == " @@ -43,14 +44,23 @@ int main() std::cout << "rank == " << std::rank::value << std::endl; - return (0); - } + int single_dim_array[]{ 1, 2, 3 }; + int double_dim_array[2][1]{ { 4 }, { 5 } }; + + std::cout << "\nrank == " + << std::rank::value << std::endl; + std::cout << "rank == " + << std::rank::value << std::endl; +} ``` ```Output rank == 0 rank == 1 rank == 2 + +rank == 1 +rank == 2 ``` ## Requirements From aae06296244e128cb193c7f16edd7d68568f49d4 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 17:35:36 +0800 Subject: [PATCH 1011/1799] Clean up superfluous relative links in `std::rank` reference --- docs/standard-library/rank-class.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/rank-class.md b/docs/standard-library/rank-class.md index 386fbf155ed..632aa05eb59 100644 --- a/docs/standard-library/rank-class.md +++ b/docs/standard-library/rank-class.md @@ -71,5 +71,5 @@ rank == 2 ## See also -[``](../standard-library/type-traits.md)\ -[`extent` class](../standard-library/extent-class.md) +[``](type-traits.md)\ +[`extent` class](extent-class.md) From 344fa16f12fcac603bff6afd1ba20fbed4a6b13f Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 17:36:39 +0800 Subject: [PATCH 1012/1799] Update metadata in `std::rank` reference --- docs/standard-library/rank-class.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/rank-class.md b/docs/standard-library/rank-class.md index 632aa05eb59..f1c39092e5d 100644 --- a/docs/standard-library/rank-class.md +++ b/docs/standard-library/rank-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: rank class" title: "rank class" -ms.date: "11/04/2016" +description: "Learn more about: rank class" +ms.date: 08/28/2025 f1_keywords: ["type_traits/std::rank"] helpviewer_keywords: ["rank class", "rank"] -ms.assetid: bc9f1b8f-800f-46ca-b6f4-d8579ed5406a --- # `rank` class From 857da516dc5c8420e89ac18e7a6d18405fe6574d Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 17:54:17 +0800 Subject: [PATCH 1013/1799] Elide stray escapes in columns --- docs/assembler/masm/option-language-masm.md | 4 ++-- docs/c-runtime-library/ismbb-routines.md | 2 +- docs/dotnet/stl-clr-library-reference.md | 4 ++-- docs/standard-library/type-traits.md | 6 +++--- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/assembler/masm/option-language-masm.md b/docs/assembler/masm/option-language-masm.md index bc258e08f1b..af36fc17e8a 100644 --- a/docs/assembler/masm/option-language-masm.md +++ b/docs/assembler/masm/option-language-masm.md @@ -20,11 +20,11 @@ Available languages include: :::row::: :::column span=""::: **`C`**\ - **`SYSCALL`**\ + **`SYSCALL`** :::column-end::: :::column span=""::: **`STDCALL`**\ - **`PASCAL`**\ + **`PASCAL`** :::column-end::: :::column span=""::: **`FORTRAN`**\ diff --git a/docs/c-runtime-library/ismbb-routines.md b/docs/c-runtime-library/ismbb-routines.md index 2d24fedf48a..ae9c95abce9 100644 --- a/docs/c-runtime-library/ismbb-routines.md +++ b/docs/c-runtime-library/ismbb-routines.md @@ -21,7 +21,7 @@ Tests the given integer value `c` for a particular condition, by using the curre [`_ismbblead`, `_ismbblead_l`](./reference/ismbblead-ismbblead-l.md)\ [`_ismbbprint`, `_ismbbprint_l`](./reference/ismbbprint-ismbbprint-l.md)\ [`_ismbbpunct`, `_ismbbpunct_l`](./reference/ismbbpunct-ismbbpunct-l.md)\ - [`_ismbbtrail`, `_ismbbtrail_l`](./reference/ismbbtrail-ismbbtrail-l.md)\ + [`_ismbbtrail`, `_ismbbtrail_l`](./reference/ismbbtrail-ismbbtrail-l.md) :::column-end::: :::row-end::: diff --git a/docs/dotnet/stl-clr-library-reference.md b/docs/dotnet/stl-clr-library-reference.md index e38c1906036..d10c5f5609f 100644 --- a/docs/dotnet/stl-clr-library-reference.md +++ b/docs/dotnet/stl-clr-library-reference.md @@ -51,7 +51,7 @@ In addition, this section also describes the following components of STL/CLR: [`hash_multimap` (STL/CLR)](../dotnet/hash-multimap-stl-clr.md)\ [`hash_multiset` (STL/CLR)](../dotnet/hash-multiset-stl-clr.md)\ [`hash_set` (STL/CLR)](../dotnet/hash-set-stl-clr.md)\ - [`list` (STL/CLR)](../dotnet/list-stl-clr.md)\ + [`list` (STL/CLR)](../dotnet/list-stl-clr.md) :::column-end::: :::column span=""::: [`map` (STL/CLR)](../dotnet/map-stl-clr.md)\ @@ -63,7 +63,7 @@ In addition, this section also describes the following components of STL/CLR: [`set` (STL/CLR)](../dotnet/set-stl-clr.md)\ [`stack` (STL/CLR)](../dotnet/stack-stl-clr.md)\ [`utility` (STL/CLR)](../dotnet/utility-stl-clr.md)\ - [`vector` (STL/CLR)](../dotnet/vector-stl-clr.md)\ + [`vector` (STL/CLR)](../dotnet/vector-stl-clr.md) :::column-end::: :::row-end::: diff --git a/docs/standard-library/type-traits.md b/docs/standard-library/type-traits.md index 80f42ef05a1..d2a3bbe88e5 100644 --- a/docs/standard-library/type-traits.md +++ b/docs/standard-library/type-traits.md @@ -44,7 +44,7 @@ These are the provided aliases for the `type` members: `add_rvalue_reference_t`\ `add_volatile_t`\ `aligned_storage_t`\ - `aligned_union_t`\ + `aligned_union_t` :::column-end::: :::column::: `common_type_t`\ @@ -54,7 +54,7 @@ These are the provided aliases for the `type` members: `invoke_result_t`\ `make_signed_t`\ `make_unsigned_t`\ - `remove_all_extents_t`\ + `remove_all_extents_t` :::column-end::: :::column::: `remove_const_t`\ @@ -64,7 +64,7 @@ These are the provided aliases for the `type` members: `remove_reference_t`\ `remove_volatile_t`\ `result_of_t`\ - `underlying_type_t`\ + `underlying_type_t` :::column-end::: :::row-end::: From df9fd880b938904c386e8f212debaeac52d4cd54 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Thu, 28 Aug 2025 17:55:13 +0800 Subject: [PATCH 1014/1799] Update metadata in 4 topics --- docs/assembler/masm/option-language-masm.md | 2 +- docs/c-runtime-library/ismbb-routines.md | 2 +- docs/dotnet/stl-clr-library-reference.md | 3 +-- docs/standard-library/type-traits.md | 5 ++--- 4 files changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/assembler/masm/option-language-masm.md b/docs/assembler/masm/option-language-masm.md index af36fc17e8a..1ba3c6cd7d6 100644 --- a/docs/assembler/masm/option-language-masm.md +++ b/docs/assembler/masm/option-language-masm.md @@ -1,6 +1,6 @@ --- -description: Learn more about the alternatives for the OPTION LANGUAGE directive title: "OPTION LANGUAGE" +description: "Learn more about the alternatives for the OPTION LANGUAGE directive" ms.date: 09/21/2021 f1_keywords: ["language"] helpviewer_keywords: ["OPTION LANGUAGE directive"] diff --git a/docs/c-runtime-library/ismbb-routines.md b/docs/c-runtime-library/ismbb-routines.md index ae9c95abce9..328cb2d6977 100644 --- a/docs/c-runtime-library/ismbb-routines.md +++ b/docs/c-runtime-library/ismbb-routines.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _ismbb routines" title: "_ismbb routines" +description: "Learn more about: _ismbb routines" ms.date: 01/11/2022 helpviewer_keywords: ["ismbb routines", "_ismbb routines"] --- diff --git a/docs/dotnet/stl-clr-library-reference.md b/docs/dotnet/stl-clr-library-reference.md index d10c5f5609f..8b2cd934967 100644 --- a/docs/dotnet/stl-clr-library-reference.md +++ b/docs/dotnet/stl-clr-library-reference.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: STL/CLR Library Reference" title: "STL/CLR Library Reference" +description: "Learn more about: STL/CLR Library Reference" ms.date: 09/18/2018 ms.topic: "reference" helpviewer_keywords: ["STL/CLR Library", "STL/CLR, redistribution", "cliext directory"] -ms.assetid: a9d9ca00-7bf2-48c1-b205-3ae6f8c25f82 --- # STL/CLR Library Reference diff --git a/docs/standard-library/type-traits.md b/docs/standard-library/type-traits.md index d2a3bbe88e5..b91cd8884c6 100644 --- a/docs/standard-library/type-traits.md +++ b/docs/standard-library/type-traits.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "02/21/2019" +description: "Learn more about: " +ms.date: 02/21/2019 f1_keywords: [""] helpviewer_keywords: ["typetrait header", "type_traits"] -ms.assetid: 2260b51f-8160-4c66-a82f-00b534cb60d4 --- # `` From 95e81f5859a83df77971aa7d33301ca10a499968 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 28 Aug 2025 23:25:55 +0800 Subject: [PATCH 1015/1799] Add blockquotes for warning messages in range [C4311, C4360] --- .../compiler-warnings/compiler-warning-level-1-c4311.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4312.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4313.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4333.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4340.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4342.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4344.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4346.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4348.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4350.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4353.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4358.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4356.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4316.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4334.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4357.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4336.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4337.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4343.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md index 241e383b04a..a1c232b92c1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md @@ -8,7 +8,7 @@ ms.assetid: ddc579d0-d051-47bc-915d-71ffb32323c9 --- # Compiler Warning (level 1) C4311 -'variable' : pointer truncation from 'type' to 'type' +> 'variable' : pointer truncation from 'type' to 'type' This warning detects 64-bit pointer truncation issues. For example, if code is compiled for a 64-bit architecture, the value of a pointer (64 bits) will be truncated if it is assigned to an **`int`** (32 bits). For more information, see [Rules for Using Pointers](/windows/win32/WinProg64/rules-for-using-pointers). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md index 3bb9426aab6..8d8d72b2997 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md @@ -8,7 +8,7 @@ ms.assetid: 541906ed-4f62-4bcb-947f-cf9ae7411bcb --- # Compiler Warning (level 1) C4312 -'operation' : conversion from 'type1' to 'type2' of greater size +> 'operation' : conversion from 'type1' to 'type2' of greater size This warning detects an attempt to assign a 32-bit value to a 64-bit pointer type, for example, casting a 32-bit **`int`** or **`long`** to a 64-bit pointer. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md index 44d7f2e2556..5ca9684d276 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md @@ -8,7 +8,7 @@ ms.assetid: bcf64191-e2cf-452e-97b4-423fcec2d07c --- # Compiler Warning (level 1) C4313 -'function' : 'format specifier' in format string conflicts with argument number of type 'type' +> 'function' : 'format specifier' in format string conflicts with argument number of type 'type' There is a conflict between the format specified and the value that you are passing. For example, you passed a 64-bit parameter to an unqualified %d format specifier, which expects a 32-bit integer parameter. This warning is only in effect when the code is compiled for 64-bit targets. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md index 972196b570d..e638b64f65c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md @@ -8,7 +8,7 @@ ms.assetid: d3763c52-6110-4da0-84db-5264e3f3f166 --- # Compiler Warning (level 1) C4333 -'operator' : right shift by too large amount, data loss +> 'operator' : right shift by too large amount, data loss A right shift operation was too large an amount. All significant bits are shifted out and the result will always be zero. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md index 58981026e43..ed798bc0f02 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md @@ -8,6 +8,6 @@ ms.assetid: ddd5344b-5167-4c55-a318-20615052fd54 --- # Compiler Warning (level 1) C4340 -'value' : value wrapped from positive to negative value +> 'value' : value wrapped from positive to negative value The **`enum`** value is greater than the largest **`enum`** positive value wrapped around to a negative value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md index b16363c5117..1de1d050a06 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md @@ -8,7 +8,7 @@ ms.assetid: 47d4d5ab-069f-4cdc-98c3-10d649577a37 --- # Compiler Warning (level 1) C4342 -behavior change: '*function*' called, but a member operator was called in previous versions +> behavior change: '*function*' called, but a member operator was called in previous versions In versions of Visual C++ before Visual Studio 2002, a member was called, but this behavior has been changed and the compiler now finds the best match in namespace scope. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md index 24e2d0b749f..1c8e52c65d5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md @@ -8,6 +8,6 @@ ms.assetid: cd20859d-f07f-4c70-904b-cb756a53b1ed --- # Compiler Warning (level 1) C4344 -behavior change: use of explicit template arguments results in call to 'function' +> behavior change: use of explicit template arguments results in call to 'function' A call to a function using explicit template arguments calls a different function than it would if explicit arguments had not been specified diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md index a508a599219..80dd857b9d1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md @@ -8,7 +8,7 @@ ms.assetid: 68ee562d-cca9-4a2a-9a1b-14ad1a1e7396 --- # Compiler Warning (level 1) C4346 -'name' : dependent name is not a type +> 'name' : dependent name is not a type The [typename](../../cpp/typename.md) keyword is required if a dependent name is to be treated as a type. For code that works the same in all versions of Visual C++, add **`typename`** to the declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md index 9a691ded0a2..c71bbfcfd65 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md @@ -8,7 +8,7 @@ ms.assetid: 816010eb-6079-48d5-a41b-0fc4d67cfe4c --- # Compiler Warning (level 1) C4348 -'type' : redefinition of default parameter : parameter number +> 'type' : redefinition of default parameter : parameter number A template parameter was redefined. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md index 99f15243ebb..b8cb14ab924 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md @@ -8,7 +8,7 @@ ms.assetid: 4cc8ed67-64c4-4da5-a7a5-a639232baa23 --- # Compiler Warning (level 1) C4350 -behavior change: 'member1' called instead of 'member2' +> behavior change: 'member1' called instead of 'member2' An rvalue cannot be bound to a non-const reference. In versions of Visual C++ before Visual Studio 2003, it was possible to bind an rvalue to a non-const reference in a direct initialization. This code now gives a warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md index 3ca31ea006a..cbb864d5493 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4353"] --- # Compiler Warning (level 1) C4353 -nonstandard extension used: constant 0 as function expression. Use '__noop' function intrinsic instead +> nonstandard extension used: constant 0 as function expression. Use '__noop' function intrinsic instead You cannot use the constant zero (0) as a function expression. For more information, see [__noop](../../intrinsics/noop.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md index 02e7ffc810f..f46c87a7820 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md @@ -8,7 +8,7 @@ ms.assetid: a9848f84-14b3-405e-81bf-ee3e91a51511 --- # Compiler Warning (level 1) C4358 -'operator': return type of combined delegates is not 'void'; returned value is undefined +> 'operator': return type of combined delegates is not 'void'; returned value is undefined Two delegates were combined and the return value is not void. If two delegates with non-void return values are combined, the compiler will not be able to do a proper assignment if the return value of the delegate is used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md index 9134afc4376..6bd86758c14 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md @@ -8,7 +8,7 @@ ms.assetid: 3af3defe-de33-43b6-bd6c-2c2e09e34f3f --- # Compiler Warning (level 2) C4356 -'member' : static data member cannot be initialized via derived class +> 'member' : static data member cannot be initialized via derived class The initialization of a static data member was ill formed. The compiler accepted the initialization. To avoid the warning, initialize the member through the base class. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md index 5094e9de73e..e6851d61a9f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md @@ -8,7 +8,7 @@ ms.assetid: 10371f01-aeb8-40ac-a290-59e63efa5ad4 --- # Compiler Warning (level 3) C4316 -Object allocated on the heap may not be aligned for this type. +> Object allocated on the heap may not be aligned for this type. An over-aligned object allocated by using `operator new` may not have the specified alignment. Override [operator new](../../c-runtime-library/new-operator-crt.md) and [operator delete](../../c-runtime-library/delete-operator-crt.md) for over-aligned types so that they use the aligned allocation routines—for example, [_aligned_malloc](../../c-runtime-library/reference/aligned-malloc.md) and [_aligned_free](../../c-runtime-library/reference/aligned-free.md). The following sample generates C4316: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md index 7b3c4b482cf..cdd91e92464 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md @@ -8,7 +8,7 @@ ms.assetid: d845857f-bc95-4faf-a079-626a0cf935ba --- # Compiler Warning (level 3) C4334 -'operator': result of 32-bit shift implicitly converted to 64 bits (was 64-bit shift intended?) +> 'operator': result of 32-bit shift implicitly converted to 64 bits (was 64-bit shift intended?) The result of 32-bit shift was converted to 64-bit, and the compiler suspects that a 64-bit shift was intended. Resolve this warning by using a 64-bit shift. If a 32-bit shift is intentional, then cast the shift result to 32-bit to make it clear to the compiler. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md index 008ffaca3b8..02afa65eb3a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md @@ -8,7 +8,7 @@ ms.assetid: 9259c633-3c02-4900-b94a-2d8d366d61cd --- # Compiler Warning (level 3) C4357 -param array argument in formal argument list for delegate 'del' ignored when generating 'function' +> param array argument in formal argument list for delegate 'del' ignored when generating 'function' The `ParamArray` attribute was ignored, and `function` cannot be called with variable arguments. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md index 4a777866930..725ea6bab27 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md @@ -8,7 +8,7 @@ ms.assetid: 93f199dd-d6dd-42c0-82d8-c12d101a7235 --- # Compiler Warning (level 4) C4336 -import cross-referenced type library 'type_lib1' before importing 'type_lib2' +> import cross-referenced type library 'type_lib1' before importing 'type_lib2' A type library was referenced with the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. However, the type library contained a reference to another type library that was not referenced with `#import`. This other .tlb file was found by the compiler. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md index ada48dd852b..7a59a10e604 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md @@ -8,7 +8,7 @@ ms.assetid: 70bc72d9-aac5-45cd-abd3-ebe42a05897b --- # Compiler Warning (level 4) C4337 -cross-referenced type library 'typelib1' in 'typelib2' is being automatically imported +> cross-referenced type library 'typelib1' in 'typelib2' is being automatically imported The auto_search attribute of [the #import directive](../../preprocessor/hash-import-directive-cpp.md) caused a type library to be implicitly imported. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md index 57b03021c75..47d89124f24 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md @@ -8,7 +8,7 @@ ms.assetid: a721b710-e04f-4d15-b678-e4a2c8fd0181 --- # Compiler Warning (level 4) C4343 -\#pragma optimize("g",off) overrides /Og option +> #pragma optimize("g",off) overrides /Og option This warning, only valid in the Itanium Processor Family (IPF) compiler, reports that a pragma [optimize](../../preprocessor/optimize.md) overrode a [/Og](../../build/reference/og-global-optimizations.md) compiler option. From c2d6fc7edfcdd95387a16075baea1ab425345e3d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 28 Aug 2025 23:33:52 +0800 Subject: [PATCH 1016/1799] Add "Remarks" and "Example" headings for warning references in range [C4311, C4360] --- .../compiler-warnings/compiler-warning-c4355.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4311.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4312.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4313.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4319.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4325.md | 6 +++++- .../compiler-warnings/compiler-warning-level-1-c4329.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4333.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4340.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4342.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4344.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4346.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4348.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4350.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4353.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4358.md | 4 ++++ .../compiler-warnings/compiler-warning-level-2-c4356.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4316.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-3-c4334.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4357.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4359.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4336.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4337.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4339.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4343.md | 4 ++++ 25 files changed, 93 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md index 57d328a58fe..de6d088cd0e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md @@ -9,12 +9,16 @@ helpviewer_keywords: ["C4355"] > '`this`': used in base member initializer list +## Remarks + The `this` pointer is valid only within nonstatic member functions. It can't be used in the initializer list for a base class. The base-class constructors and class member constructors are called before `this` constructor. This pattern is the same as passing a pointer to an unconstructed object to another constructor. If those other constructors access any members or call member functions on `this`, the result is undefined. You shouldn't use the `this` pointer until all construction is complete. 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 + The following sample generates C4355: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md index a1c232b92c1..9cd9779fa7a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md @@ -10,10 +10,14 @@ ms.assetid: ddc579d0-d051-47bc-915d-71ffb32323c9 > 'variable' : pointer truncation from 'type' to 'type' +## Remarks + This warning detects 64-bit pointer truncation issues. For example, if code is compiled for a 64-bit architecture, the value of a pointer (64 bits) will be truncated if it is assigned to an **`int`** (32 bits). For more information, see [Rules for Using Pointers](/windows/win32/WinProg64/rules-for-using-pointers). For additional information about common causes of warning C4311, see [Common Compiler Errors](/windows/win32/WinProg64/common-compiler-errors). +## Example + The following code example generates C4311 when compiled for a 64-bit target, and then demonstrates how to fix it: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md index 8d8d72b2997..653ee40d387 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md @@ -10,12 +10,16 @@ ms.assetid: 541906ed-4f62-4bcb-947f-cf9ae7411bcb > 'operation' : conversion from 'type1' to 'type2' of greater size +## Remarks + This warning detects an attempt to assign a 32-bit value to a 64-bit pointer type, for example, casting a 32-bit **`int`** or **`long`** to a 64-bit pointer. This can be an unsafe conversion even for pointer values that fit in 32 bits when sign extension occurs. If a negative 32-bit integer is assigned to a 64-bit pointer type, sign extension causes the pointer value to reference a memory address different from the value of the integer. This warning is only issued for 64-bit compilation targets. For more information, see [Rules for Using Pointers](/windows/win32/WinProg64/rules-for-using-pointers). +## Example + The following code example generates C4312 when it is compiled for 64-bit targets: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md index 5ca9684d276..61292eb8520 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md @@ -10,6 +10,8 @@ ms.assetid: bcf64191-e2cf-452e-97b4-423fcec2d07c > 'function' : 'format specifier' in format string conflicts with argument number of type 'type' +## Remarks + There is a conflict between the format specified and the value that you are passing. For example, you passed a 64-bit parameter to an unqualified %d format specifier, which expects a 32-bit integer parameter. This warning is only in effect when the code is compiled for 64-bit targets. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md index af4e194b373..6c5688f28b4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md @@ -10,6 +10,8 @@ ms.assetid: 1fac8048-9bd6-4552-a21c-192c67772bb9 > '~' : zero extending '*type1*' to '*type2*' of greater size +## Remarks + The result of the **~** (bitwise complement) operator is unsigned and then zero-extended when it is converted to a larger type. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md index bb1233d0d72..de272173fec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md @@ -12,7 +12,11 @@ ms.assetid: 8127a08c-d626-481b-aa7b-04a3fdc9a9ec ## Remarks -You may not change the attributes of a standard section. For example: +You may not change the attributes of a standard section. + +## Example + +For example: ```cpp #pragma section(".sdata", long) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md index 2922e2c6250..81d34a5da58 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md @@ -9,7 +9,13 @@ helpviewer_keywords: ["C4329"] > alignment specifier is ignored on enum -Use of the alignment specifiers on `enum` isn't allowed. This pattern includes the use of the [`align`](../../cpp/align-cpp.md) [`__declspec`](../../cpp/declspec.md) modifier. The following sample generates C4329: +## Remarks + +Use of the alignment specifiers on `enum` isn't allowed. This pattern includes the use of the [`align`](../../cpp/align-cpp.md) [`__declspec`](../../cpp/declspec.md) modifier. + +## Example + +The following sample generates C4329: ```cpp // C4329.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md index e638b64f65c..cc64556ea71 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md @@ -10,6 +10,8 @@ ms.assetid: d3763c52-6110-4da0-84db-5264e3f3f166 > 'operator' : right shift by too large amount, data loss +## Remarks + A right shift operation was too large an amount. All significant bits are shifted out and the result will always be zero. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md index ed798bc0f02..8f5f3e5c898 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md @@ -10,4 +10,6 @@ ms.assetid: ddd5344b-5167-4c55-a318-20615052fd54 > 'value' : value wrapped from positive to negative value +## Remarks + The **`enum`** value is greater than the largest **`enum`** positive value wrapped around to a negative value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md index 1de1d050a06..806dc4266d1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md @@ -10,6 +10,8 @@ ms.assetid: 47d4d5ab-069f-4cdc-98c3-10d649577a37 > behavior change: '*function*' called, but a member operator was called in previous versions +## Remarks + In versions of Visual C++ before Visual Studio 2002, a member was called, but this behavior has been changed and the compiler now finds the best match in namespace scope. If a member operator was found, the compiler would previously not consider any namespace scope operators. If there is a better match at namespace scope, the current compiler correctly calls it, whereas previous compilers wouldn't consider it. @@ -18,6 +20,8 @@ This warning should be disabled after you successfully port your code to the cur 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 + The following sample generates C4342: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md index 1c8e52c65d5..3e1e32fcf10 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md @@ -10,4 +10,6 @@ ms.assetid: cd20859d-f07f-4c70-904b-cb756a53b1ed > behavior change: use of explicit template arguments results in call to 'function' +## Remarks + A call to a function using explicit template arguments calls a different function than it would if explicit arguments had not been specified diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md index 80dd857b9d1..5044649f082 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md @@ -10,8 +10,12 @@ ms.assetid: 68ee562d-cca9-4a2a-9a1b-14ad1a1e7396 > 'name' : dependent name is not a type +## Remarks + The [typename](../../cpp/typename.md) keyword is required if a dependent name is to be treated as a type. For code that works the same in all versions of Visual C++, add **`typename`** to the declaration. +## Examples + The following sample generates C4346: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md index c71bbfcfd65..daee11eaa92 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md @@ -10,8 +10,12 @@ ms.assetid: 816010eb-6079-48d5-a41b-0fc4d67cfe4c > 'type' : redefinition of default parameter : parameter number +## Remarks + A template parameter was redefined. +## Example + The following sample generates C4348: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md index b8cb14ab924..abd15d7e38c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md @@ -10,6 +10,8 @@ ms.assetid: 4cc8ed67-64c4-4da5-a7a5-a639232baa23 > behavior change: 'member1' called instead of 'member2' +## Remarks + An rvalue cannot be bound to a non-const reference. In versions of Visual C++ before Visual Studio 2003, it was possible to bind an rvalue to a non-const reference in a direct initialization. This code now gives a warning. For backward compatibility, it is still possible to bind rvalues to non-const references, but standard conversions are preferred wherever possible. @@ -20,6 +22,8 @@ If you get this warning, examine your code to see if it depends on binding rvalu 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 + The following sample generates C4350: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md index cbb864d5493..42f3a60374d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C4353"] > nonstandard extension used: constant 0 as function expression. Use '__noop' function intrinsic instead +## Remarks + You cannot use the constant zero (0) as a function expression. For more information, see [__noop](../../intrinsics/noop.md). +## Example + The following sample generates C4353: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md index f46c87a7820..9b1f4b411a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md @@ -10,8 +10,12 @@ ms.assetid: a9848f84-14b3-405e-81bf-ee3e91a51511 > 'operator': return type of combined delegates is not 'void'; returned value is undefined +## Remarks + Two delegates were combined and the return value is not void. If two delegates with non-void return values are combined, the compiler will not be able to do a proper assignment if the return value of the delegate is used. +## Example + The following sample generates C4358: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md index 6bd86758c14..f395df1c966 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md @@ -10,10 +10,14 @@ ms.assetid: 3af3defe-de33-43b6-bd6c-2c2e09e34f3f > 'member' : static data member cannot be initialized via derived class +## Remarks + The initialization of a static data member was ill formed. The compiler accepted the initialization. To avoid the warning, initialize the member through the base class. Use the [warning](../../preprocessor/warning.md) pragma to suppress this warning. +## Example + The following sample generates C4356: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md index e6851d61a9f..e7cf25cf3be 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md @@ -10,7 +10,13 @@ ms.assetid: 10371f01-aeb8-40ac-a290-59e63efa5ad4 > Object allocated on the heap may not be aligned for this type. -An over-aligned object allocated by using `operator new` may not have the specified alignment. Override [operator new](../../c-runtime-library/new-operator-crt.md) and [operator delete](../../c-runtime-library/delete-operator-crt.md) for over-aligned types so that they use the aligned allocation routines—for example, [_aligned_malloc](../../c-runtime-library/reference/aligned-malloc.md) and [_aligned_free](../../c-runtime-library/reference/aligned-free.md). The following sample generates C4316: +## Remarks + +An over-aligned object allocated by using `operator new` may not have the specified alignment. Override [operator new](../../c-runtime-library/new-operator-crt.md) and [operator delete](../../c-runtime-library/delete-operator-crt.md) for over-aligned types so that they use the aligned allocation routines—for example, [_aligned_malloc](../../c-runtime-library/reference/aligned-malloc.md) and [_aligned_free](../../c-runtime-library/reference/aligned-free.md). + +## Example + +The following sample generates C4316: ```cpp // C4316.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md index cdd91e92464..4f5458b77ee 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md @@ -10,6 +10,8 @@ ms.assetid: d845857f-bc95-4faf-a079-626a0cf935ba > 'operator': result of 32-bit shift implicitly converted to 64 bits (was 64-bit shift intended?) +## Remarks + The result of 32-bit shift was converted to 64-bit, and the compiler suspects that a 64-bit shift was intended. Resolve this warning by using a 64-bit shift. If a 32-bit shift is intentional, then cast the shift result to 32-bit to make it clear to the compiler. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md index 02afa65eb3a..21d60d90abe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md @@ -10,8 +10,12 @@ ms.assetid: 9259c633-3c02-4900-b94a-2d8d366d61cd > param array argument in formal argument list for delegate 'del' ignored when generating 'function' +## Remarks + The `ParamArray` attribute was ignored, and `function` cannot be called with variable arguments. +## Example + The following sample generates C4357: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md index 1323cb6fe50..2f23ada186c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4359"] > 'type': actual alignment (8) is greater than the value specified in __declspec(align()) +## Remarks + 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 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md index 725ea6bab27..c20fe09957d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md @@ -10,8 +10,12 @@ ms.assetid: 93f199dd-d6dd-42c0-82d8-c12d101a7235 > import cross-referenced type library 'type_lib1' before importing 'type_lib2' +## Remarks + A type library was referenced with the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. However, the type library contained a reference to another type library that was not referenced with `#import`. This other .tlb file was found by the compiler. +## Example + Given two type libraries on disk created from the following two files (compiled with midl.exe): ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md index 7a59a10e604..c0965a2c79d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md @@ -10,8 +10,12 @@ ms.assetid: 70bc72d9-aac5-45cd-abd3-ebe42a05897b > cross-referenced type library 'typelib1' in 'typelib2' is being automatically imported +## Remarks + The auto_search attribute of [the #import directive](../../preprocessor/hash-import-directive-cpp.md) caused a type library to be implicitly imported. +## Example + Given two type libraries on disk created from the following two files (compiled with midl.exe): ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md index 77a9a5a3e57..5d6d32b7b81 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4339"] > 'type' : use of undefined type detected in WinRT or CLR meta-data - use of this type may lead to a runtime exception +## Remarks + A type wasn't defined in code that was compiled for Windows Runtime or the common language runtime. Define the type to avoid a possible runtime exception. 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 + The following sample generates C4339 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md index 47d89124f24..ce065c88551 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md @@ -10,8 +10,12 @@ ms.assetid: a721b710-e04f-4d15-b678-e4a2c8fd0181 > #pragma optimize("g",off) overrides /Og option +## Remarks + This warning, only valid in the Itanium Processor Family (IPF) compiler, reports that a pragma [optimize](../../preprocessor/optimize.md) overrode a [/Og](../../build/reference/og-global-optimizations.md) compiler option. +## Example + The following sample generates C4343: ```cpp From bb69b5cf09efb46b20d845709234c041207779bf Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 28 Aug 2025 23:35:48 +0800 Subject: [PATCH 1017/1799] Replace term "sample" with "example" for warning references in range [C4311, C4360] --- .../compiler-warnings/compiler-warning-c4355.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4313.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4326.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4329.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4333.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4342.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4346.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4348.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4350.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4353.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4358.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4356.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4316.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4334.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4357.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4359.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4336.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4337.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4339.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4343.md | 2 +- 20 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md index de6d088cd0e..132a3ccf66b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md @@ -19,7 +19,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4355: +The following example generates C4355: ```cpp // C4355.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md index 61292eb8520..30f4c289a17 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md @@ -16,7 +16,7 @@ There is a conflict between the format specified and the value that you are pass ## Example -The following code sample generates C4313 when it is compiled for a 64-bit target. +The following code example generates C4313 when it is compiled for a 64-bit target. ```cpp // C4313.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md index 4cad0b88a46..fe0ccfe4e0e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md @@ -16,7 +16,7 @@ A function returned a type other than *type1*. For example, using [/Za](../../bu ## Example -The following sample generates C4326 and shows how to fix it: +The following example generates C4326 and shows how to fix it: ```cpp // C4326.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md index 81d34a5da58..522fc17b270 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md @@ -15,7 +15,7 @@ Use of the alignment specifiers on `enum` isn't allowed. This pattern includes t ## Example -The following sample generates C4329: +The following example generates C4329: ```cpp // C4329.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md index cc64556ea71..c1c88909f95 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md @@ -16,7 +16,7 @@ A right shift operation was too large an amount. All significant bits are shift ## Example -The following sample generates C4333. +The following example generates C4333. ```cpp // C4333.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md index 806dc4266d1..9390d92da3e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md @@ -22,7 +22,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4342: +The following example generates C4342: ```cpp // C4342.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md index 5044649f082..53811cf1448 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md @@ -16,7 +16,7 @@ The [typename](../../cpp/typename.md) keyword is required if a dependent name is ## Examples -The following sample generates C4346: +The following example generates C4346: ```cpp // C4346.cpp @@ -29,7 +29,7 @@ struct C { }; ``` -The following samples shows other examples where the **`typename`** keyword is required: +The following shows other examples where the **`typename`** keyword is required: ```cpp // C4346b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md index daee11eaa92..0fb1dd8c08b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md @@ -16,7 +16,7 @@ A template parameter was redefined. ## Example -The following sample generates C4348: +The following example generates C4348: ```cpp // C4348.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md index abd15d7e38c..def1b86a1e6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md @@ -24,7 +24,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4350: +The following example generates C4350: ```cpp // C4350.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md index 42f3a60374d..ced2c8a0687 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md @@ -15,7 +15,7 @@ You cannot use the constant zero (0) as a function expression. For more informat ## Example -The following sample generates C4353: +The following example generates C4353: ```cpp // C4353.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md index 9b1f4b411a2..36ac7abc3af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md @@ -16,7 +16,7 @@ Two delegates were combined and the return value is not void. If two delegates w ## Example -The following sample generates C4358: +The following example generates C4358: ```cpp // C4358.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md index f395df1c966..99ab15ae84d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md @@ -18,7 +18,7 @@ Use the [warning](../../preprocessor/warning.md) pragma to suppress this warning ## Example -The following sample generates C4356: +The following example generates C4356: ```cpp // C4356.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md index e7cf25cf3be..285cfda61db 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md @@ -16,7 +16,7 @@ An over-aligned object allocated by using `operator new` may not have the specif ## Example -The following sample generates C4316: +The following example generates C4316: ```cpp // C4316.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md index 4f5458b77ee..6ddba51b9d4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md @@ -16,7 +16,7 @@ The result of 32-bit shift was converted to 64-bit, and the compiler suspects th ## Example -The following sample generates C4334. +The following example generates C4334. ```cpp // C4334.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md index 21d60d90abe..bed43ed79fd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md @@ -16,7 +16,7 @@ The `ParamArray` attribute was ignored, and `function` cannot be called with var ## Example -The following sample generates C4357: +The following example generates C4357: ```cpp // C4357.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md index 2f23ada186c..591fcb5ecec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md @@ -15,7 +15,7 @@ The alignment specified for a type is less than the alignment of the type of one ## Example -The following sample generates C4359. +The following example generates C4359. ```cpp // C4359.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md index c20fe09957d..61ac385aeb2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md @@ -47,7 +47,7 @@ library C4336bLib }; ``` -The following sample generates C4336: +The following example generates C4336: ```cpp // C4336.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md index c0965a2c79d..852e85d8967 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md @@ -55,7 +55,7 @@ library C4337bLib }; ``` -The following sample generates C4337: +The following example generates C4337: ```cpp // C4337.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md index 5d6d32b7b81..3b42c4f639a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md @@ -17,7 +17,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4339 and shows how to fix it: +The following example generates C4339 and shows how to fix it: ```cpp // C4339.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md index ce065c88551..a44259783f0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md @@ -16,7 +16,7 @@ This warning, only valid in the Itanium Processor Family (IPF) compiler, reports ## Example -The following sample generates C4343: +The following example generates C4343: ```cpp // C4343.cpp From f5607c878efbb56772cdf0934c788b4b63582966 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 28 Aug 2025 23:39:40 +0800 Subject: [PATCH 1018/1799] Update metadata for warning references in range [C4311, C4360] --- .../compiler-warnings/compiler-warning-level-1-c4311.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4312.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4313.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4319.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4325.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4326.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4329.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4333.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4340.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4342.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4344.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4346.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4348.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4350.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4358.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4356.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4316.md | 3 +-- .../compiler-warnings/compiler-warning-level-3-c4334.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4357.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4359.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4336.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4337.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4339.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4343.md | 5 ++--- 24 files changed, 47 insertions(+), 68 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md index 9cd9779fa7a..f27b08010af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4311" title: "Compiler Warning (level 1) C4311" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4311" +ms.date: 11/04/2016 f1_keywords: ["C4311"] helpviewer_keywords: ["C4311"] -ms.assetid: ddc579d0-d051-47bc-915d-71ffb32323c9 --- # Compiler Warning (level 1) C4311 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md index 653ee40d387..4cbe2bf10b6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4312" title: "Compiler Warning (level 1) C4312" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4312" +ms.date: 11/04/2016 f1_keywords: ["C4312"] helpviewer_keywords: ["C4312"] -ms.assetid: 541906ed-4f62-4bcb-947f-cf9ae7411bcb --- # Compiler Warning (level 1) C4312 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md index 30f4c289a17..64050afef86 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4313" title: "Compiler Warning (level 1) C4313" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4313" +ms.date: 11/04/2016 f1_keywords: ["C4313"] helpviewer_keywords: ["C4313"] -ms.assetid: bcf64191-e2cf-452e-97b4-423fcec2d07c --- # Compiler Warning (level 1) C4313 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md index 6c5688f28b4..486da6781bd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4319" title: "Compiler Warning (level 1) C4319" -ms.date: "01/18/2018" +description: "Learn more about: Compiler Warning (level 1) C4319" +ms.date: 01/18/2018 f1_keywords: ["C4319"] helpviewer_keywords: ["C4319"] -ms.assetid: 1fac8048-9bd6-4552-a21c-192c67772bb9 --- # Compiler Warning (level 1) C4319 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md index de272173fec..7ac44c2fca2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4325" title: "Compiler Warning (level 1) C4325" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4325" +ms.date: 08/27/2018 f1_keywords: ["C4325"] helpviewer_keywords: ["C4325"] -ms.assetid: 8127a08c-d626-481b-aa7b-04a3fdc9a9ec --- # Compiler Warning (level 1) C4325 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md index fe0ccfe4e0e..53d3f74109a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4326" title: "Compiler Warning (level 1) C4326" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4326" +ms.date: 08/27/2018 f1_keywords: ["C4326"] helpviewer_keywords: ["C4326"] -ms.assetid: d44d2c4e-9456-42d3-b35b-4ba4b2d42ec7 --- # Compiler Warning (level 1) C4326 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md index 522fc17b270..63d963b4898 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4329" title: "Compiler Warning (level 1) C4329" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4329" +ms.date: 11/04/2016 f1_keywords: ["C4329"] helpviewer_keywords: ["C4329"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md index c1c88909f95..7f2ed906c9a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4333" title: "Compiler Warning (level 1) C4333" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4333" +ms.date: 11/04/2016 f1_keywords: ["C4333"] helpviewer_keywords: ["C4333"] -ms.assetid: d3763c52-6110-4da0-84db-5264e3f3f166 --- # Compiler Warning (level 1) C4333 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md index 8f5f3e5c898..004d0d3c45f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4340" title: "Compiler Warning (level 1) C4340" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4340" +ms.date: 11/04/2016 f1_keywords: ["C4340"] helpviewer_keywords: ["C4340"] -ms.assetid: ddd5344b-5167-4c55-a318-20615052fd54 --- # Compiler Warning (level 1) C4340 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md index 9390d92da3e..63ce40a82f9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4342" title: "Compiler Warning (level 1) C4342" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4342" +ms.date: 11/04/2016 f1_keywords: ["C4342"] helpviewer_keywords: ["C4342"] -ms.assetid: 47d4d5ab-069f-4cdc-98c3-10d649577a37 --- # Compiler Warning (level 1) C4342 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md index 3e1e32fcf10..49eccaec8b4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4344" title: "Compiler Warning (level 1) C4344" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4344" +ms.date: 11/04/2016 f1_keywords: ["C4344"] helpviewer_keywords: ["C4344"] -ms.assetid: cd20859d-f07f-4c70-904b-cb756a53b1ed --- # Compiler Warning (level 1) C4344 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md index 53811cf1448..568ad7cd845 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4346" title: "Compiler Warning (level 1) C4346" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4346" +ms.date: 11/04/2016 f1_keywords: ["C4346"] helpviewer_keywords: ["C4346"] -ms.assetid: 68ee562d-cca9-4a2a-9a1b-14ad1a1e7396 --- # Compiler Warning (level 1) C4346 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md index 0fb1dd8c08b..e123b095dc9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4348" title: "Compiler Warning (level 1) C4348" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4348" +ms.date: 11/04/2016 f1_keywords: ["C4348"] helpviewer_keywords: ["C4348"] -ms.assetid: 816010eb-6079-48d5-a41b-0fc4d67cfe4c --- # Compiler Warning (level 1) C4348 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md index def1b86a1e6..04e98691df3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4350" title: "Compiler Warning (level 1) C4350" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4350" +ms.date: 11/04/2016 f1_keywords: ["C4350"] helpviewer_keywords: ["C4350"] -ms.assetid: 4cc8ed67-64c4-4da5-a7a5-a639232baa23 --- # Compiler Warning (level 1) C4350 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md index 36ac7abc3af..4c4832aa51b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4358" title: "Compiler Warning (level 1) C4358" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4358" +ms.date: 11/04/2016 f1_keywords: ["C4358"] helpviewer_keywords: ["C4358"] -ms.assetid: a9848f84-14b3-405e-81bf-ee3e91a51511 --- # Compiler Warning (level 1) C4358 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md index 99ab15ae84d..1b77d903071 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4356" title: "Compiler Warning (level 2) C4356" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4356" +ms.date: 11/04/2016 f1_keywords: ["C4356"] helpviewer_keywords: ["C4356"] -ms.assetid: 3af3defe-de33-43b6-bd6c-2c2e09e34f3f --- # Compiler Warning (level 2) C4356 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md index 285cfda61db..984e7f71f21 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md @@ -1,10 +1,9 @@ --- title: "Compiler Warning (level 3) C4316" description: "Description of C++ compiler warning C4316" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C4316"] helpviewer_keywords: ["C4316"] -ms.assetid: 10371f01-aeb8-40ac-a290-59e63efa5ad4 --- # Compiler Warning (level 3) C4316 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md index 6ddba51b9d4..6c410d831f7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4334" title: "Compiler Warning (level 3) C4334" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4334" +ms.date: 11/04/2016 f1_keywords: ["C4334"] helpviewer_keywords: ["C4334"] -ms.assetid: d845857f-bc95-4faf-a079-626a0cf935ba --- # Compiler Warning (level 3) C4334 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md index bed43ed79fd..6e2208ff1fb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4357" title: "Compiler Warning (level 3) C4357" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4357" +ms.date: 11/04/2016 f1_keywords: ["C4357"] helpviewer_keywords: ["C4357"] -ms.assetid: 9259c633-3c02-4900-b94a-2d8d366d61cd --- # Compiler Warning (level 3) C4357 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md index 591fcb5ecec..7058b2598e2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md @@ -1,7 +1,7 @@ --- -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" +description: "Learn more about: Compiler Warning (level 1 and level 3) C4359" +ms.date: 11/04/2016 f1_keywords: ["C4359"] helpviewer_keywords: ["C4359"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md index 61ac385aeb2..2506a4b3f12 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4336" title: "Compiler Warning (level 4) C4336" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4336" +ms.date: 11/04/2016 f1_keywords: ["C4336"] helpviewer_keywords: ["C4336"] -ms.assetid: 93f199dd-d6dd-42c0-82d8-c12d101a7235 --- # Compiler Warning (level 4) C4336 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md index 852e85d8967..6d7bd6bc2d7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4337" title: "Compiler Warning (level 4) C4337" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4337" +ms.date: 11/04/2016 f1_keywords: ["C4337"] helpviewer_keywords: ["C4337"] -ms.assetid: 70bc72d9-aac5-45cd-abd3-ebe42a05897b --- # Compiler Warning (level 4) C4337 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md index 3b42c4f639a..5b6c4e3b290 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4339" title: "Compiler Warning (level 4, off) C4339" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4339" +ms.date: 11/04/2016 f1_keywords: ["C4339"] helpviewer_keywords: ["C4339"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md index a44259783f0..675978f9976 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4343" title: "Compiler Warning (level 4) C4343" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4343" +ms.date: 11/04/2016 f1_keywords: ["C4343"] helpviewer_keywords: ["C4343"] -ms.assetid: a721b710-e04f-4d15-b678-e4a2c8fd0181 --- # Compiler Warning (level 4) C4343 From 407ad80d0121dd49f90b48fde719161916c42595 Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Thu, 28 Aug 2025 09:45:18 -0600 Subject: [PATCH 1019/1799] code analysis: improvements to c6064 MORSE recently asked us to improve documentation for C6064 specifically asking us to go into detail explaining why this warning is cause for concern. This change explictly outlines possible outcomes of ignoring this warning. --- docs/code-quality/c6064.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/code-quality/c6064.md b/docs/code-quality/c6064.md index 645f77ff241..fe97e65dea7 100644 --- a/docs/code-quality/c6064.md +++ b/docs/code-quality/c6064.md @@ -13,7 +13,7 @@ This warning indicates that the code doesn't provide enough arguments to match a ## Remarks -This defect is likely to cause incorrect output and, in more dangerous cases, can lead to stack overflow. +Supplying too few arguments to a format function leads to undefined behavior, because the function attempts to read values that were never passed. Possible consequences include incorrect output, crashes, or even security vulnerabilities such as information leaks. To ensure stability and safety, always match the number and types of arguments to the format specifiers in the string. Code analysis name: `MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION` From b39e50877a949c56c4b61e1d46f2dbf7308f6c18 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 29 Aug 2025 23:12:06 +0800 Subject: [PATCH 1020/1799] Add blockquotes for warning messages in range [C4361, C4400] --- .../compiler-warnings/compiler-warning-level-1-c4364.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4369.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4374.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4375.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4376.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4377.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4378.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4379.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4381.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4383.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4391.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4393.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4395.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4397.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4396.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4390.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4366.md | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md index 3b84470325b..7e82f3a23b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md @@ -8,7 +8,7 @@ ms.assetid: 1477634c-d60f-4570-ad16-1aaeae24ac7f --- # Compiler Warning (level 1) C4364 -\#using for assembly 'file' previously seen at location(line_number) without as_friend attribute; as_friend not applied +> #using for assembly 'file' previously seen at location(line_number) without as_friend attribute; as_friend not applied A `#using` directive was repeated for a given metadata file, but the **`as_friend`** qualifier was not used in the first occurrence; the compiler will ignore the second **`as_friend`**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md index d3d741d7755..0825c5596f1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md @@ -8,7 +8,7 @@ ms.assetid: ade87e84-36be-4e00-be99-2930af848feb --- # Compiler Warning (level 1) C4369 -'enumerator' : enumerator value 'value' cannot be represented as 'type', value is 'new_value' +> 'enumerator' : enumerator value 'value' cannot be represented as 'type', value is 'new_value' An enumerator was calculated to be greater than the greatest value for the specified underlying type. This caused an overflow and the compiler wrapped the enumerator value to the lowest possible value for the type. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md index 836a46f41a8..279a7341c7f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md @@ -8,7 +8,7 @@ ms.assetid: 4ac9aaec-d815-4b6e-825f-fa872092dd3b --- # Compiler Warning (level 1) C4374 -'function1': interface method will not be implemented by non-virtual method 'function2' +> 'function1': interface method will not be implemented by non-virtual method 'function2' The compiler expected to find the [virtual](../../cpp/virtual-specifier.md) keyword on a method definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md index ccd68495cc6..0533ec63b75 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md @@ -8,6 +8,6 @@ ms.assetid: a19821b5-e9b6-4228-abe7-d812507d6a2a --- # Compiler Warning (level 1) C4375 -non-public method 'method2' does not override 'method1' +> non-public method 'method2' does not override 'method1' A type that implements another type defined an override method, but the override was not public. Therefore, the method does not override the base type method. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md index fd0d5d27dde..5b3a8c297ec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md @@ -8,7 +8,7 @@ ms.assetid: 5f202c74-9489-48fe-b36f-19cd882b1589 --- # Compiler Warning (level 1) C4376 -access specifier 'old_specifier:' is no longer supported: please use 'new_specifier:' instead +> access specifier 'old_specifier:' is no longer supported: please use 'new_specifier:' instead For more information on specifying type and member accessibility in metadata, 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) in [How to: Define and Consume Classes and Structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md index 2c5b708fa07..cc898797883 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md @@ -8,7 +8,7 @@ ms.assetid: a1c797b8-cd5e-4a56-b430-d07932e811cf --- # Compiler Warning (level 1) C4377 -native types are private by default; -d1PrivateNativeTypes is deprecated +> native types are private by default; -d1PrivateNativeTypes is deprecated In previous releases, native types in assemblies were public by default, and an internal, undocumented compiler option (**/d1PrivateNativeTypes**) was used to make them private. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md index d46842152e7..59fe1f2c2cc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md @@ -8,7 +8,7 @@ ms.assetid: d08e11ef-891a-4752-9a5e-360e7394acf7 --- # Compiler Warning (level 1) C4378 -Must obtain function pointers to run initializers; consider System::ModuleHandle::ResolveMethodHandle +> Must obtain function pointers to run initializers; consider System::ModuleHandle::ResolveMethodHandle Under **/clr**, initializer symbols contain function tokens, not functions pointers. You need to convert tokens to pointers using . diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md index 8f56e1419a0..b7f225d55cf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md @@ -8,6 +8,6 @@ ms.assetid: b23e8132-69aa-4649-9c1e-09813b9fb5b7 --- # Compiler Warning (level 1) C4379 -Version version of the common language runtime is not supported by this compiler. Using this version may cause unexpected results. +> Version version of the common language runtime is not supported by this compiler. Using this version may cause unexpected results. You have a previous version of the common language runtime on your machine, but not the current version. To resolve C4379, install the version of the common language runtime that shipped with your compiler. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md index 29e6cc6ddcc..9b030b19804 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md @@ -8,6 +8,6 @@ ms.assetid: f67a6db3-b334-4b2e-8182-b30c7a3c7c32 --- # Compiler Warning (level 1) C4381 -'function1': interface method will not be implemented by non-public method 'function2' +> 'function1': interface method will not be implemented by non-public method 'function2' A class must implement all function in an interface. A class can satisfy this condition if one of its base classes implements the function. However, the function must be implemented as a public function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md index bd6efac7c97..4b5af6d3732 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md @@ -8,7 +8,7 @@ ms.assetid: 96c0e52d-874e-4b57-a154-0e49b6a00fae --- # Compiler Warning (level 1) C4383 -'instance_dereference_operator' : the meaning of dereferencing a handle can change, when a user-defined 'operator' operator exists; write the operator as a static function to be explicit about the operand +> 'instance_dereference_operator' : the meaning of dereferencing a handle can change, when a user-defined 'operator' operator exists; write the operator as a static function to be explicit about the operand When you add a user-defined instance override of the dereference operator in a managed type, you potentially override the ability of the type's dereference operator to return the handle's object. Consider writing a static, user-defined dereference operator. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md index be45ba9d293..b3a69caec8b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md @@ -8,7 +8,7 @@ ms.assetid: 95c6182c-fae9-4174-8f7b-98aa352e68ca --- # Compiler Warning (level 1) C4391 -'signature' : incorrect return type for intrinsic function, expected 'type' +> 'signature' : incorrect return type for intrinsic function, expected 'type' A function declaration for a compiler intrinsic had the wrong return type. The resulting image may not run correctly. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md index 2e0d6b6e8e9..8fc7edb9d6e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md @@ -8,7 +8,7 @@ ms.assetid: 353a0539-d1ea-4c1b-8849-c9b321ec9842 --- # Compiler Warning (level 1) C4393 -'var' : const has no effect on literal data member; ignored +> 'var' : const has no effect on literal data member; ignored A [literal](../../extensions/literal-cpp-component-extensions.md) data member was also specified as const. Since a literal data member implies const, you do not need to add const to the declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md index 98523b30ba7..d33a3d07abc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md @@ -8,7 +8,7 @@ ms.assetid: 8051469a-3a39-4677-80f7-1300fbffe8ea --- # Compiler Warning (level 1) C4395 -'function' : member function will be invoked on a copy of the initonly data member 'member' +> 'function' : member function will be invoked on a copy of the initonly data member 'member' A member function was called on an [initonly (C++/CLI)](../../dotnet/initonly-cpp-cli.md) data member. C4395 warns that the **initonly** data member cannot be modified by the function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md index f957af30e6f..a7b491c41e6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md @@ -8,7 +8,7 @@ ms.assetid: 6346fdc2-dbbf-4fba-803a-32b0d0a707be --- # Compiler Warning (level 1) C4397 -DefaultCharSetAttribute is ignored +> DefaultCharSetAttribute is ignored is ignored by the Microsoft C++ compiler. To specify a character set for the DLL, use the CharSet option of DllImport. For more information, see [Using C++ Interop (Implicit PInvoke)](../../dotnet/using-cpp-interop-implicit-pinvoke.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md index e4306463bc4..d5bd5d97f67 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md @@ -8,7 +8,7 @@ ms.assetid: 7cd6b283-db17-4574-b299-03e0b913ad70 --- # Compiler Warning (level 2) C4396 -"name" : the inline specifier cannot be used when a friend declaration refers to a specialization of a function template +> "name" : the inline specifier cannot be used when a friend declaration refers to a specialization of a function template A specialization of a function template cannot specify any of the [inline](../../cpp/inline-functions-cpp.md) specifiers. The compiler issues warning C4396 and ignores the inline specifier. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md index 813df6cac74..489254df5f0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md @@ -8,7 +8,7 @@ ms.assetid: c95c2f1b-9bce-4b1f-a80c-565d4cde0b1e --- # Compiler Warning (level 3) C4390 -';' : empty controlled statement found; is this the intent? +> ';' : empty controlled statement found; is this the intent? A semicolon was found after a control statement that contains no instructions. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md index 8ffd8a63f5d..7396113555b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md @@ -8,7 +8,7 @@ ms.assetid: 65d2942f-3741-42f4-adf2-4920d5a055ca --- # Compiler Warning (level 4) C4366 -The result of the unary 'operator' operator may be unaligned +> The result of the unary 'operator' operator may be unaligned If a structure member could ever be unaligned because of packing, the compiler will warn when that member's address is assigned to an aligned pointer. By default, all pointers are aligned. From 0d7369083798e232c2f58490fbd7a4abf9a6ea47 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 29 Aug 2025 23:19:16 +0800 Subject: [PATCH 1021/1799] Add "Remarks" and "Example" headings for warning references in range [C4361, C4400] --- docs/error-messages/compiler-warnings/c4371.md | 2 ++ docs/error-messages/compiler-warnings/c4388.md | 4 ++-- .../compiler-warnings/compiler-warning-c4368.md | 2 ++ .../compiler-warnings/compiler-warning-c4394.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4364.md | 4 +++- .../compiler-warnings/compiler-warning-level-1-c4369.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4374.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4375.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4376.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4377.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4378.md | 4 +++- .../compiler-warnings/compiler-warning-level-1-c4379.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4381.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4383.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4384.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4391.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4392.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4393.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4395.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4397.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4396.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4390.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4365.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4366.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4389.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4400.md | 2 ++ 26 files changed, 66 insertions(+), 6 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4371.md b/docs/error-messages/compiler-warnings/c4371.md index aed32ad81b3..a10de784703 100644 --- a/docs/error-messages/compiler-warnings/c4371.md +++ b/docs/error-messages/compiler-warnings/c4371.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4371"] > '*classname*': layout of class may have changed from a previous version of the compiler due to better packing of member '*member*' +## Remarks + 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). diff --git a/docs/error-messages/compiler-warnings/c4388.md b/docs/error-messages/compiler-warnings/c4388.md index ee8b36db8d8..a94caa074b9 100644 --- a/docs/error-messages/compiler-warnings/c4388.md +++ b/docs/error-messages/compiler-warnings/c4388.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4388"] > '*token*' : signed/unsigned mismatch -Using the *token* operator to compare a **`signed`** and a larger **`unsigned`** number required the compiler to convert the **`signed`** value to the larger **`unsigned`** type. - ## Remarks +Using the *token* operator to compare a **`signed`** and a larger **`unsigned`** number required the compiler to convert the **`signed`** value to the larger **`unsigned`** type. + One way to fix this warning is if you cast one of the two types when you compare **`signed`** and larger **`unsigned`** types. This warning is off by default. You can use [/Wall](../../build/reference/compiler-option-warning-level.md) or **`/w44388`** to enable it on the command line as a level 4 warning. Or, use [`#pragma warning(default:4388)`](../../preprocessor/warning.md) in your source file. For more information, see [Compiler warnings that are off by default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4368.md b/docs/error-messages/compiler-warnings/compiler-warning-c4368.md index 0d5f9305326..c5c6af24bd1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4368.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4368.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4368"] > cannot define 'member' as a member of managed 'type': mixed types are not supported +## Remarks + 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). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4394.md b/docs/error-messages/compiler-warnings/compiler-warning-c4394.md index d49d391ea0b..1a2ce548a24 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4394.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4394.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4394"] > 'function' : per-appdomain symbol should not be marked with __declspec(dllexport) +## Remarks + 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). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md index 7e82f3a23b8..d56101ce1b6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md @@ -10,11 +10,13 @@ ms.assetid: 1477634c-d60f-4570-ad16-1aaeae24ac7f > #using for assembly 'file' previously seen at location(line_number) without as_friend attribute; as_friend not applied +## Remarks + A `#using` directive was repeated for a given metadata file, but the **`as_friend`** qualifier was not used in the first occurrence; the compiler will ignore the second **`as_friend`**. For more information, see [Friend Assemblies (C++)](../../dotnet/friend-assemblies-cpp.md). -## Examples +## Example The following sample creates a component. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md index 0825c5596f1..3b268fc76a5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md @@ -10,6 +10,8 @@ ms.assetid: ade87e84-36be-4e00-be99-2930af848feb > 'enumerator' : enumerator value 'value' cannot be represented as 'type', value is 'new_value' +## Remarks + An enumerator was calculated to be greater than the greatest value for the specified underlying type. This caused an overflow and the compiler wrapped the enumerator value to the lowest possible value for the type. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md index 279a7341c7f..6567f8f9ec7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md @@ -10,8 +10,12 @@ ms.assetid: 4ac9aaec-d815-4b6e-825f-fa872092dd3b > 'function1': interface method will not be implemented by non-virtual method 'function2' +## Remarks + The compiler expected to find the [virtual](../../cpp/virtual-specifier.md) keyword on a method definition. +## Example + The following sample generates C4374: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md index 0533ec63b75..cd21ad3c795 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md @@ -10,4 +10,6 @@ ms.assetid: a19821b5-e9b6-4228-abe7-d812507d6a2a > non-public method 'method2' does not override 'method1' +## Remarks + A type that implements another type defined an override method, but the override was not public. Therefore, the method does not override the base type method. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md index 5b3a8c297ec..a4353b2239f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md @@ -10,6 +10,8 @@ ms.assetid: 5f202c74-9489-48fe-b36f-19cd882b1589 > access specifier 'old_specifier:' is no longer supported: please use 'new_specifier:' instead +## Remarks + For more information on specifying type and member accessibility in metadata, 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) in [How to: Define and Consume Classes and Structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md index cc898797883..8547e4a44a3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md @@ -10,6 +10,8 @@ ms.assetid: a1c797b8-cd5e-4a56-b430-d07932e811cf > native types are private by default; -d1PrivateNativeTypes is deprecated +## Remarks + In previous releases, native types in assemblies were public by default, and an internal, undocumented compiler option (**/d1PrivateNativeTypes**) was used to make them private. All types, native and CLR, are now private by default in an assembly, so **/d1PrivateNativeTypes** is no longer needed. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md index 59fe1f2c2cc..4e0e0ab428a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md @@ -10,9 +10,11 @@ ms.assetid: d08e11ef-891a-4752-9a5e-360e7394acf7 > Must obtain function pointers to run initializers; consider System::ModuleHandle::ResolveMethodHandle +## Remarks + Under **/clr**, initializer symbols contain function tokens, not functions pointers. You need to convert tokens to pointers using . -## Examples +## Example The following sample generates C4378. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md index b7f225d55cf..73d527558fa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md @@ -10,4 +10,6 @@ ms.assetid: b23e8132-69aa-4649-9c1e-09813b9fb5b7 > Version version of the common language runtime is not supported by this compiler. Using this version may cause unexpected results. +## Remarks + You have a previous version of the common language runtime on your machine, but not the current version. To resolve C4379, install the version of the common language runtime that shipped with your compiler. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md index 9b030b19804..1b64fc30c0b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md @@ -10,4 +10,6 @@ ms.assetid: f67a6db3-b334-4b2e-8182-b30c7a3c7c32 > 'function1': interface method will not be implemented by non-public method 'function2' +## Remarks + A class must implement all function in an interface. A class can satisfy this condition if one of its base classes implements the function. However, the function must be implemented as a public function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md index 4b5af6d3732..a6f140360fd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md @@ -10,6 +10,8 @@ ms.assetid: 96c0e52d-874e-4b57-a154-0e49b6a00fae > 'instance_dereference_operator' : the meaning of dereferencing a handle can change, when a user-defined 'operator' operator exists; write the operator as a static function to be explicit about the operand +## Remarks + When you add a user-defined instance override of the dereference operator in a managed type, you potentially override the ability of the type's dereference operator to return the handle's object. Consider writing a static, user-defined dereference operator. For more information, see [Handle to Object Operator (^)](../../extensions/handle-to-object-operator-hat-cpp-component-extensions.md) and [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md index ee4ea781781..3229c928cef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4384"] > `#pragma` '*pragma_name*' should only be used at global scope +## Remarks + A `pragma` directive that must be applied at a global scope, was found in a different scope. The warning applies to the following `pragma` directives: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md index b3a69caec8b..649585a6082 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md @@ -10,10 +10,14 @@ ms.assetid: 95c6182c-fae9-4174-8f7b-98aa352e68ca > 'signature' : incorrect return type for intrinsic function, expected 'type' +## Remarks + A function declaration for a compiler intrinsic had the wrong return type. The resulting image may not run correctly. To fix this warning, either correct the declaration or delete the declaration and simply #include the appropriate header file. +## Example + The following sample generates C4391: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md index 79d7ebd0205..6d8157aefa5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4392"] > 'signature' : incorrect number of arguments for intrinsic function, expected 'number' arguments +## Remarks + 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. This warning is always issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable or change the warning level. +## Example + The following sample generates C4392: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md index 8fc7edb9d6e..7d8cd7f7077 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md @@ -10,8 +10,12 @@ ms.assetid: 353a0539-d1ea-4c1b-8849-c9b321ec9842 > 'var' : const has no effect on literal data member; ignored +## Remarks + A [literal](../../extensions/literal-cpp-component-extensions.md) data member was also specified as const. Since a literal data member implies const, you do not need to add const to the declaration. +## Example + The following sample generates C4393: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md index d33a3d07abc..aa1ae16d234 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md @@ -10,8 +10,12 @@ ms.assetid: 8051469a-3a39-4677-80f7-1300fbffe8ea > 'function' : member function will be invoked on a copy of the initonly data member 'member' +## Remarks + A member function was called on an [initonly (C++/CLI)](../../dotnet/initonly-cpp-cli.md) data member. C4395 warns that the **initonly** data member cannot be modified by the function. +## Example + The following sample generates C4395: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md index a7b491c41e6..2c25535f934 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md @@ -10,6 +10,8 @@ ms.assetid: 6346fdc2-dbbf-4fba-803a-32b0d0a707be > DefaultCharSetAttribute is ignored +## Remarks + is ignored by the Microsoft C++ compiler. To specify a character set for the DLL, use the CharSet option of DllImport. For more information, see [Using C++ Interop (Implicit PInvoke)](../../dotnet/using-cpp-interop-implicit-pinvoke.md). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md index d5bd5d97f67..c5f00c6b359 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md @@ -10,6 +10,8 @@ ms.assetid: 7cd6b283-db17-4574-b299-03e0b913ad70 > "name" : the inline specifier cannot be used when a friend declaration refers to a specialization of a function template +## Remarks + A specialization of a function template cannot specify any of the [inline](../../cpp/inline-functions-cpp.md) specifiers. The compiler issues warning C4396 and ignores the inline specifier. ### To correct this error diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md index 489254df5f0..c9240afdb9f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md @@ -10,10 +10,14 @@ ms.assetid: c95c2f1b-9bce-4b1f-a80c-565d4cde0b1e > ';' : empty controlled statement found; is this the intent? +## Remarks + A semicolon was found after a control statement that contains no instructions. If you get C4390 because of a macro, you should use the [warning](../../preprocessor/warning.md) pragma to disable C4390 in the module containing the macro. +## Example + The following sample generates C4390: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md index d26dec6ad77..eb187d31788 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4365"] > 'action' : conversion from 'type_1' to 'type_2', signed/unsigned mismatch +## Remarks + For example, you tried to convert an unsigned value to a signed value. This pattern can cause unexpected results when the source value at runtime in not in the range of the destination type. Such as a negative value being converted into a signed value. C4365 is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md index 7396113555b..2afebc273df 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md @@ -10,6 +10,8 @@ ms.assetid: 65d2942f-3741-42f4-adf2-4920d5a055ca > The result of the unary 'operator' operator may be unaligned +## Remarks + If a structure member could ever be unaligned because of packing, the compiler will warn when that member's address is assigned to an aligned pointer. By default, all pointers are aligned. To resolve C4366, either change the alignment of the structure or declare the pointer with the [__unaligned](../../cpp/unaligned.md) keyword. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md index ce2dce28c34..06aa65821bd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4389"] > '*equality-operator*' : signed/unsigned mismatch -An **`==`** or **`!=`** operation involved **`signed`** and **`unsigned`** variables. This could result in a loss of data. - ## Remarks +An **`==`** or **`!=`** operation involved **`signed`** and **`unsigned`** variables. This could result in a loss of data. + One way to fix this warning is if you cast one of the two types when you compare **`signed`** and **`unsigned`** types. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md index a97330018c7..848bb62c756 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4400"] > '*type*': `const`/`volatile` qualifiers on this type are not supported +## Remarks + The [`const`](../../cpp/const-cpp.md) and [`volatile`](../../cpp/volatile-cpp.md) qualifiers don't work with common language runtime typed variables. ## Example From da5a0fe8adece35ad60b93456acb780153a8d622 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 29 Aug 2025 23:21:00 +0800 Subject: [PATCH 1022/1799] Replace term "sample" with "example" for warning references in range [C4361, C4400] --- docs/error-messages/compiler-warnings/c4388.md | 2 +- .../compiler-warnings/compiler-warning-c4368.md | 2 +- .../compiler-warnings/compiler-warning-c4394.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4364.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4369.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4374.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4376.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4377.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4378.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4382.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4383.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4384.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4391.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4392.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4393.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4395.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4397.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4399.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4390.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4398.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4365.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4366.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4389.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4400.md | 2 +- 24 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4388.md b/docs/error-messages/compiler-warnings/c4388.md index a94caa074b9..5f4c698f08e 100644 --- a/docs/error-messages/compiler-warnings/c4388.md +++ b/docs/error-messages/compiler-warnings/c4388.md @@ -19,7 +19,7 @@ This warning is off by default. You can use [/Wall](../../build/reference/compil ## Example -This sample generates C4388 and shows how to fix it: +This example generates C4388 and shows how to fix it: ```cpp // C4388.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4368.md b/docs/error-messages/compiler-warnings/compiler-warning-c4368.md index c5c6af24bd1..3625d3ee7c4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4368.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4368.md @@ -19,7 +19,7 @@ This warning is always issued as an error. Use the [warning](../../preprocessor/ ## Example -The following sample generates C4368. +The following example generates C4368. ```cpp // C4368.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4394.md b/docs/error-messages/compiler-warnings/compiler-warning-c4394.md index 1a2ce548a24..867bfd8c1c1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4394.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4394.md @@ -19,7 +19,7 @@ C4394 is always issued as an error. You can turn off this warning or change its ## Example -The following sample generates C4394. +The following example generates C4394. ```cpp // C4394.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md index d56101ce1b6..43cdf678303 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md @@ -18,7 +18,7 @@ For more information, see [Friend Assemblies (C++)](../../dotnet/friend-assembli ## Example -The following sample creates a component. +The following example creates a component. ```cpp // C4364.cpp @@ -26,7 +26,7 @@ The following sample creates a component. ref class A {}; ``` -The following sample generates C4364. +The following example generates C4364. ```cpp // C4364_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md index 3b268fc76a5..22243859fa8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md @@ -16,7 +16,7 @@ An enumerator was calculated to be greater than the greatest value for the speci ## Example -The following sample generates C4369. +The following example generates C4369. ```cpp // C4369.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md index 6567f8f9ec7..ffea33b92f7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md @@ -16,7 +16,7 @@ The compiler expected to find the [virtual](../../cpp/virtual-specifier.md) keyw ## Example -The following sample generates C4374: +The following example generates C4374: ```cpp // C4374.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md index a4353b2239f..0967b4bbb9f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md @@ -16,7 +16,7 @@ For more information on specifying type and member accessibility in metadata, se ## Example -The following sample generates C4376. +The following example generates C4376. ```cpp // C4376.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md index 8547e4a44a3..d93e4371ccc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md @@ -18,7 +18,7 @@ All types, native and CLR, are now private by default in an assembly, so **/d1Pr ## Example -The following sample generates C4377. +The following example generates C4377. ```cpp // C4377.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md index 4e0e0ab428a..c9bbf93f6c0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md @@ -16,7 +16,7 @@ Under **/clr**, initializer symbols contain function tokens, not functions point ## Example -The following sample generates C4378. +The following example generates C4378. ```cpp // C4378.cpp @@ -58,7 +58,7 @@ int main () { } ``` -The following sample shows how to resolve C4378. +The following example shows how to resolve C4378. ```cpp // C4378_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md index a0ba7993101..1e1cfe77a5f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md @@ -22,7 +22,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates C4382. +The following example generates C4382. ```cpp // C4382.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md index a6f140360fd..cc30437e620 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md @@ -20,7 +20,7 @@ Also, an instance operator is not available to other language compilers via refe ## Example -The following sample generates C4383. +The following example generates C4383. ```cpp // C4383.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md index 3229c928cef..fceb62ec78c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md @@ -20,7 +20,7 @@ The warning applies to the following `pragma` directives: ## Example -The following sample generates C4384. +The following example generates C4384. ```cpp // C4384.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md index 649585a6082..a3817b8b2ec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md @@ -18,7 +18,7 @@ To fix this warning, either correct the declaration or delete the declaration an ## Example -The following sample generates C4391: +The following example generates C4391: ```cpp // C4391.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md index 6d8157aefa5..1dd595582ea 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md @@ -17,7 +17,7 @@ This warning is always issued as an error. Use the [warning](../../preprocessor/ ## Example -The following sample generates C4392: +The following example generates C4392: ```cpp // C4392.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md index 7d8cd7f7077..4b18bfd4699 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md @@ -16,7 +16,7 @@ A [literal](../../extensions/literal-cpp-component-extensions.md) data member wa ## Example -The following sample generates C4393: +The following example generates C4393: ```cpp // C4393.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md index aa1ae16d234..efa5dacc7ab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md @@ -16,7 +16,7 @@ A member function was called on an [initonly (C++/CLI)](../../dotnet/initonly-cp ## Example -The following sample generates C4395: +The following example generates C4395: ```cpp // C4395.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md index 2c25535f934..03e71659efa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md @@ -16,7 +16,7 @@ ms.assetid: 6346fdc2-dbbf-4fba-803a-32b0d0a707be ## Example -The following sample generates C4397. +The following example generates C4397. ```cpp // C4397.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md index 39947ec8180..cac1040a6d8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md @@ -20,7 +20,7 @@ This warning can be issued as an error. Use the [warning](../../preprocessor/war ## Example -The following sample generates C4399. +The following example generates C4399. ```cpp // C4399.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md index c9240afdb9f..a51f1ea1ecb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md @@ -18,7 +18,7 @@ If you get C4390 because of a macro, you should use the [warning](../../preproce ## Example -The following sample generates C4390: +The following example generates C4390: ```cpp // C4390.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md index 394219283d5..50605bc9561 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md @@ -20,7 +20,7 @@ For more information, see [appdomain](../../cpp/appdomain.md) and [Application D ## Example -The following sample generates C4398. +The following example generates C4398. ```cpp // C4398.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md index eb187d31788..40dacf08a34 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md @@ -17,7 +17,7 @@ C4365 is off by default. For more information, see [Compiler Warnings That Are O ## Example -The following sample generates C4365. +The following example generates C4365. ```cpp // C4365.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md index 2afebc273df..d618cf7b150 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md @@ -20,7 +20,7 @@ For more information, see __unaligned and [pack](../../preprocessor/pack.md). ## Example -The following sample generates C4366. +The following example generates C4366. ```cpp // C4366.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md index 06aa65821bd..0de7bed8b0d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md @@ -17,7 +17,7 @@ One way to fix this warning is if you cast one of the two types when you compare ## Example -The following sample generates C4389: +The following example generates C4389: ```cpp // C4389.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md index 848bb62c756..8b5dcb61792 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md @@ -15,7 +15,7 @@ The [`const`](../../cpp/const-cpp.md) and [`volatile`](../../cpp/volatile-cpp.md ## Example -The following sample generates C4400. +The following example generates C4400. ```cpp // C4400.cpp From 6fddd2dc18a08ec7838a3004c345aa54824238e3 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 29 Aug 2025 23:25:28 +0800 Subject: [PATCH 1023/1799] Update metadata for warning references in range [C4361, C4400] --- docs/error-messages/compiler-warnings/c4371.md | 4 ++-- .../compiler-warnings/compiler-warning-c4368.md | 4 ++-- .../compiler-warnings/compiler-warning-c4394.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4364.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4369.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4374.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4375.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4376.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4377.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4378.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4379.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4381.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4382.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4383.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4384.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4391.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4392.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4393.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4395.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4397.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4399.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4396.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4390.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4398.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4365.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4366.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4400.md | 4 ++-- 27 files changed, 54 insertions(+), 74 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4371.md b/docs/error-messages/compiler-warnings/c4371.md index a10de784703..44dfa2efae5 100644 --- a/docs/error-messages/compiler-warnings/c4371.md +++ b/docs/error-messages/compiler-warnings/c4371.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4371" title: "Compiler Warning (level 3, off) C4371" -ms.date: "01/31/2018" +description: "Learn more about: Compiler Warning (level 3, off) C4371" +ms.date: 01/31/2018 f1_keywords: ["C4371"] helpviewer_keywords: ["C4371"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4368.md b/docs/error-messages/compiler-warnings/compiler-warning-c4368.md index 3625d3ee7c4..94a975c3cd8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4368.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4368.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4368" title: "Compiler Warning (level 1, Error) C4368" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4368" +ms.date: 11/04/2016 f1_keywords: ["C4368"] helpviewer_keywords: ["C4368"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4394.md b/docs/error-messages/compiler-warnings/compiler-warning-c4394.md index 867bfd8c1c1..128be88cbc4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4394.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4394.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4394" title: "Compiler Warning (level 1, Error) C4394" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4394" +ms.date: 11/04/2016 f1_keywords: ["C4394"] helpviewer_keywords: ["C4394"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md index 43cdf678303..43cd2ffc11f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4364" title: "Compiler Warning (level 1) C4364" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4364" +ms.date: 11/04/2016 f1_keywords: ["C4364"] helpviewer_keywords: ["C4364"] -ms.assetid: 1477634c-d60f-4570-ad16-1aaeae24ac7f --- # Compiler Warning (level 1) C4364 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md index 22243859fa8..23fc40ea41b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4369" title: "Compiler Warning (level 1) C4369" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4369" +ms.date: 11/04/2016 f1_keywords: ["C4369"] helpviewer_keywords: ["C4369"] -ms.assetid: ade87e84-36be-4e00-be99-2930af848feb --- # Compiler Warning (level 1) C4369 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md index ffea33b92f7..4341cfc2032 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4374" title: "Compiler Warning (level 1) C4374" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4374" +ms.date: 11/04/2016 f1_keywords: ["C4374"] helpviewer_keywords: ["C4374"] -ms.assetid: 4ac9aaec-d815-4b6e-825f-fa872092dd3b --- # Compiler Warning (level 1) C4374 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md index cd21ad3c795..33fe16a7dfc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4375" title: "Compiler Warning (level 1) C4375" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4375" +ms.date: 11/04/2016 f1_keywords: ["C4375"] helpviewer_keywords: ["C4375"] -ms.assetid: a19821b5-e9b6-4228-abe7-d812507d6a2a --- # Compiler Warning (level 1) C4375 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md index 0967b4bbb9f..ad88d8b6893 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4376" title: "Compiler Warning (level 1) C4376" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4376" +ms.date: 11/04/2016 f1_keywords: ["C4376"] helpviewer_keywords: ["C4376"] -ms.assetid: 5f202c74-9489-48fe-b36f-19cd882b1589 --- # Compiler Warning (level 1) C4376 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md index d93e4371ccc..1c326f787a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4377" title: "Compiler Warning (level 1) C4377" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4377" +ms.date: 11/04/2016 f1_keywords: ["C4377"] helpviewer_keywords: ["C4377"] -ms.assetid: a1c797b8-cd5e-4a56-b430-d07932e811cf --- # Compiler Warning (level 1) C4377 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md index c9bbf93f6c0..2573597b3fc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4378" title: "Compiler Warning (level 1) C4378" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4378" +ms.date: 11/04/2016 f1_keywords: ["C4378"] helpviewer_keywords: ["C4378"] -ms.assetid: d08e11ef-891a-4752-9a5e-360e7394acf7 --- # Compiler Warning (level 1) C4378 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md index 73d527558fa..9ed0d1e208b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4379" title: "Compiler Warning (level 1) C4379" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4379" +ms.date: 11/04/2016 f1_keywords: ["C4379"] helpviewer_keywords: ["C4379"] -ms.assetid: b23e8132-69aa-4649-9c1e-09813b9fb5b7 --- # Compiler Warning (level 1) C4379 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md index 1b64fc30c0b..40eb33d0d75 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4381" title: "Compiler Warning (level 1) C4381" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4381" +ms.date: 11/04/2016 f1_keywords: ["C4381"] helpviewer_keywords: ["C4381"] -ms.assetid: f67a6db3-b334-4b2e-8182-b30c7a3c7c32 --- # Compiler Warning (level 1) C4381 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md index 1e1cfe77a5f..18d02708b01 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4382" title: "Compiler Warning (level 1) C4382" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4382" +ms.date: 11/04/2016 f1_keywords: ["C4382"] helpviewer_keywords: ["C4382"] -ms.assetid: 34be9ad3-bae6-411a-8f80-0c8fd0d2c092 --- # Compiler Warning (level 1) C4382 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md index cc30437e620..77526a9e69a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4383" title: "Compiler Warning (level 1) C4383" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4383" +ms.date: 11/04/2016 f1_keywords: ["C4383"] helpviewer_keywords: ["C4383"] -ms.assetid: 96c0e52d-874e-4b57-a154-0e49b6a00fae --- # Compiler Warning (level 1) C4383 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md index fceb62ec78c..bc7bcf67f1e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4384" title: "Compiler Warning (level 1) C4384" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4384" +ms.date: 11/04/2016 f1_keywords: ["C4384"] helpviewer_keywords: ["C4384"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md index a3817b8b2ec..fd71f025e23 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4391" title: "Compiler Warning (level 1) C4391" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4391" +ms.date: 11/04/2016 f1_keywords: ["C4391"] helpviewer_keywords: ["C4391"] -ms.assetid: 95c6182c-fae9-4174-8f7b-98aa352e68ca --- # Compiler Warning (level 1) C4391 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md index 1dd595582ea..01aadb254d1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4392" title: "Compiler Warning (level 1, Error) C4392" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4392" +ms.date: 11/04/2016 f1_keywords: ["C4392"] helpviewer_keywords: ["C4392"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md index 4b18bfd4699..82cf3e5048c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4393" title: "Compiler Warning (level 1) C4393" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4393" +ms.date: 11/04/2016 f1_keywords: ["C4393"] helpviewer_keywords: ["C4393"] -ms.assetid: 353a0539-d1ea-4c1b-8849-c9b321ec9842 --- # Compiler Warning (level 1) C4393 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md index efa5dacc7ab..eb6c4a27418 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4395" title: "Compiler Warning (level 1) C4395" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4395" +ms.date: 11/04/2016 f1_keywords: ["C4395"] helpviewer_keywords: ["C4395"] -ms.assetid: 8051469a-3a39-4677-80f7-1300fbffe8ea --- # Compiler Warning (level 1) C4395 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md index 03e71659efa..2e639136c27 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4397" title: "Compiler Warning (level 1) C4397" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4397" +ms.date: 11/04/2016 f1_keywords: ["C4397"] helpviewer_keywords: ["C4397"] -ms.assetid: 6346fdc2-dbbf-4fba-803a-32b0d0a707be --- # Compiler Warning (level 1) C4397 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md index cac1040a6d8..b3d523f9ed6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4399" title: "Compiler Warning (level 1, Error) C4399" -ms.date: "11/04/2016" +description: "Learn more about: 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, Error) C4399 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md index c5f00c6b359..5bb56d3be8f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4396" title: "Compiler Warning (level 2) C4396" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4396" +ms.date: 11/04/2016 f1_keywords: ["C4396"] helpviewer_keywords: ["C4396"] -ms.assetid: 7cd6b283-db17-4574-b299-03e0b913ad70 --- # Compiler Warning (level 2) C4396 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md index a51f1ea1ecb..6ed88b3ea82 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4390" title: "Compiler Warning (level 3) C4390" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4390" +ms.date: 11/04/2016 f1_keywords: ["C4390"] helpviewer_keywords: ["C4390"] -ms.assetid: c95c2f1b-9bce-4b1f-a80c-565d4cde0b1e --- # Compiler Warning (level 3) C4390 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md index 50605bc9561..fd2f161dca1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4398" title: "Compiler Warning (level 3) C4398" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4398" +ms.date: 11/04/2016 f1_keywords: ["C4398"] helpviewer_keywords: ["C4398"] -ms.assetid: b6221432-9fed-4272-a547-a73f587904e6 --- # Compiler Warning (level 3) C4398 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md index 40dacf08a34..25320e16d28 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4365" title: "Compiler Warning (level 4, off) C4365" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4365" +ms.date: 11/04/2016 f1_keywords: ["C4365"] helpviewer_keywords: ["C4365"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md index d618cf7b150..91679dc7baf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4366" title: "Compiler Warning (level 4) C4366" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4366" +ms.date: 11/04/2016 f1_keywords: ["C4366"] helpviewer_keywords: ["C4366"] -ms.assetid: 65d2942f-3741-42f4-adf2-4920d5a055ca --- # Compiler Warning (level 4) C4366 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md index 8b5dcb61792..75de9e5fcd0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, error) C4400" title: "Compiler warning (level 4, error) C4400" -ms.date: "1/22/2025" +description: "Learn more about: Compiler Warning (level 4, error) C4400" +ms.date: 1/22/2025 f1_keywords: ["C4400"] helpviewer_keywords: ["C4400"] --- From dca9ae960bebcdf5ef8c0bda0ece833232f05872 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 00:45:18 +0800 Subject: [PATCH 1024/1799] Add blockquotes for warning messages in range [C4401, C4460] --- .../compiler-warnings/compiler-warning-level-1-c4401.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4402.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4403.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4405.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4406.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4409.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4410.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4411.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4420.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4440.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4441.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4445.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4404.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4414.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4408.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4429.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4431.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4434.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4460.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md index 8bc6447524d..1bf00d11902 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md @@ -8,7 +8,7 @@ ms.assetid: 2e7ca136-f144-4b40-b847-82976e8643fc --- # Compiler Warning (level 1) C4401 -'bitfield' : member is bit field +> 'bitfield' : member is bit field Inline assembly code tries to access a bit-field member. Inline assembly cannot access bit-field members, so the last packing boundary before the bit-field member is used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md index 564054771a1..5682e2a4510 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md @@ -8,7 +8,7 @@ ms.assetid: 2aaecfae-1e79-4787-87e8-0973f7ec0efe --- # Compiler Warning (level 1) C4402 -must use PTR operator +> must use PTR operator A type is used on an operand without a PTR operator when referring to or casting to a type in inline assembly code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md index 1d3e599dcba..8c308f2148a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md @@ -8,7 +8,7 @@ ms.assetid: d95597c9-4762-4f33-86e4-1d98f0e80d52 --- # Compiler Warning (level 1) C4403 -illegal PTR operator +> illegal PTR operator A PTR operator is used inappropriately in inline assembler code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md index b2ad983ac70..9202ad1b259 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md @@ -8,7 +8,7 @@ ms.assetid: 155c64d6-58ae-4455-b61f-ccd711c5da96 --- # Compiler Warning (level 1) C4405 -'identifier' : identifier is reserved word +> 'identifier' : identifier is reserved word A word reserved for inline assembly is used as a variable name. This may cause unpredictable results. To fix this warning, avoid naming variables with words reserved for inline assembly. The following sample generates C4405: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md index 56566edc0fe..90624374b9f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md @@ -8,7 +8,7 @@ ms.assetid: a3204731-2285-401c-b73b-af98586a86fa --- # Compiler Warning (level 1) C4406 -operand on directive ignored +> operand on directive ignored The directive does not take any operands, but an operand was specified. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md index 66f2c9b2a9e..ace66e16870 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md @@ -8,6 +8,6 @@ ms.assetid: 2be63c86-d9c9-4073-ab71-e654dd9f450f --- # Compiler Warning (level 1) C4409 -illegal instruction size +> illegal instruction size The instruction did not have a form with the specified size. The smallest legal size was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md index 99784780d9a..40179d294f8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md @@ -8,6 +8,6 @@ ms.assetid: 7dcdb720-118a-4823-ba73-575f6ad79a71 --- # Compiler Warning (level 1) C4410 -illegal size for operand +> illegal size for operand One of the operands on the instruction had an incorrect size. The smallest legal size for the operand was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md index 3170200a5f5..ba94d9f79c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md @@ -8,6 +8,6 @@ ms.assetid: d209452c-83bd-4333-8d0b-759ca9b4864e --- # Compiler Warning (level 1) C4411 -'identifier' : symbol resolves to displacement register +> 'identifier' : symbol resolves to displacement register The identifier is a local symbol that resolves to a displacement register and therefore may be used on an operand with another symbol. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md index e506c3e258f..78a5c7b4b73 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md @@ -8,7 +8,7 @@ ms.assetid: 44a37754-7ddd-4764-a5f7-d33e05c20091 --- # Compiler Warning (level 1) C4420 -'operator' : operator not available, using 'operator' instead; run-time checking may be compromised +> 'operator' : operator not available, using 'operator' instead; run-time checking may be compromised This warning is generated when you use the [/RTCv](../../build/reference/rtc-run-time-error-checks.md) (vector new/delete checking) and when no vector form is found. In this case, the non-vector form is used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md index a85bcc3b98c..930be84995f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md @@ -8,7 +8,7 @@ ms.assetid: 78b9642a-a93e-401e-9d92-372f6451bc5d --- # Compiler Warning (level 1) C4440 -calling convention redefinition from 'calling_convention1' to 'calling_convention2' ignored +> calling convention redefinition from 'calling_convention1' to 'calling_convention2' ignored An attempt to change the calling convention was ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md index be07663a0d2..666e12c5e25 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md @@ -8,7 +8,7 @@ ms.assetid: 7fc540a5-e41f-47cf-aa37-b2b699c2685e --- # Compiler Warning (level 1) C4441 -calling convention of 'cc1' ignored; 'cc2' used instead +> calling convention of 'cc1' ignored; 'cc2' used instead Member functions in managed user-defined types and global function generics must use the [__clrcall](../../cpp/clrcall.md) calling convention. The compiler used `__clrcall`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md index 4312f592b2f..d6ceffd17c6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md @@ -8,6 +8,6 @@ ms.assetid: 535e92a0-ba08-4dfc-89b2-af2dcdd7caeb --- # Compiler Warning (level 1) C4445 -'function' : in a WinRT or managed type a virtual method cannot be private +> 'function' : in a WinRT or managed type a virtual method cannot be private If a virtual function is private, it cannot be accessed by a derived type. To fix this error, change the accessibility of the virtual member function to protected or public. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md index 27677fa9728..b6fe07460de 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md @@ -8,6 +8,6 @@ ms.assetid: 78ce9985-0ccd-4ec2-92bf-289475109cdd --- # Compiler Warning (level 3) C4404 -period on directive ignored +> period on directive ignored The optional period preceding the directive is ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md index 0a4b595c122..b4455077286 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md @@ -8,7 +8,7 @@ ms.assetid: bc81d3ad-55dc-4a6b-a6f2-ec0ef38347df --- # Compiler Warning (level 3) C4414 -'function' : short jump to function converted to near +> 'function' : short jump to function converted to near Short jumps generate compact instruction which branches to an address within a limited range from the instruction. The instruction includes a short offset that represents the distance between the jump and the target address, the function definition. During linking a function may be moved or subject to link-time optimizations that cause the function to be moved out of the range reachable from a short offset. The compiler must generate a special record for the jump, which requires the jmp instruction to be either NEAR or FAR. The compiler made the conversion. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md index b41f58b75a0..d988aeff4ac 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md @@ -8,7 +8,7 @@ ms.assetid: 8488a186-ed1d-425c-aaeb-c72472c1da68 --- # Compiler Warning (level 4) C4408 -anonymousstruct or union did not declare any data members +> anonymousstruct or union did not declare any data members An anonymous struct or union must have at least one data member. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md index 145ec9b1aa3..5850c916b56 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md @@ -8,7 +8,7 @@ ms.assetid: a3e4cf1f-a869-4e47-834a-850c21eb5297 --- # Compiler Warning (level 4) C4429 -possible incomplete or improperly formed universal-character-name +> possible incomplete or improperly formed universal-character-name The compiler detected a character sequence that may be a badly formed universal character name. A universal character name is `\u` followed by four hex digits, or `\U` followed by eight hex digits. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md index bba0bbce56a..ac3348b03fb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md @@ -8,7 +8,7 @@ ms.assetid: 58434ab6-dd8d-427b-953a-602fb7453ae6 --- # Compiler Warning (level 4) C4431 -missing type specifier - int assumed. Note: C no longer supports default-int +> missing type specifier - int assumed. Note: C no longer supports default-int This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: Visual C++ no longer creates untyped identifiers as int by default. The type of an identifier must be specified explicitly. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md index 0315bf031dc..dd437579361 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md @@ -8,7 +8,7 @@ ms.assetid: 24b8785e-353a-4c37-8bed-ed61001a871d --- # Compiler Warning (level 4) C4434 -a class constructor must have private accessibility; changing to private access +> a class constructor must have private accessibility; changing to private access C4434 indicates that the compiler changed the accessibility of a static constructor. Static constructors must have private accessibility, as they are only meant to be called by the common language runtime. For more information, see [Static constructors](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Static_constructors). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md index 6a990f6f678..42fd1538433 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md @@ -8,7 +8,7 @@ ms.assetid: c97ac1c9-598d-479e-bfff-c993690c4f3d --- # Compiler Warning (level 4) C4460 -WinRT or CLR operator 'operator', has parameter passed by reference. WinRT or CLR operator 'operator' has different semantics from C++ operator 'operator', did you intend to pass by value? +> WinRT or CLR operator 'operator', has parameter passed by reference. WinRT or CLR operator 'operator' has different semantics from C++ operator 'operator', did you intend to pass by value? You passed a value by reference to a user-defined Windows Runtime or CLR operator. If the value is changed inside the function, note that the value returned after the function call will be assigned the return value of the function. In standard C++, the changed value is reflected after the function call. From cdf14e13a39c7e9ca730c5c7c8801ccfbd3663e5 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 00:53:06 +0800 Subject: [PATCH 1025/1799] Add "Remarks" and "Example" headings for warning references in range [C4401, C4460] --- .../compiler-warnings/compiler-warning-c4430.md | 2 ++ .../compiler-warnings/compiler-warning-c4439.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4401.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4402.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4403.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4405.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4406.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4407.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4409.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4410.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4411.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4420.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4436.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4440.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4441.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4445.md | 2 ++ .../compiler-warnings/compiler-warning-level-2-c4412.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4404.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4414.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4408.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4429.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4431.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4434.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4435.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4437.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4456.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4457.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4458.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4459.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4460.md | 2 ++ 30 files changed, 77 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4430.md b/docs/error-messages/compiler-warnings/compiler-warning-c4430.md index 6814fb10c38..5accdb977f0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4430.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4430.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4430"] > missing type specifier - int assumed. Note: C++ does not support default-int +## Remarks + This warning is issued when a type specifier is missing in a declaration. The compiler used to assume the type was `int` in this case. But due to compiler conformance work done for Visual Studio 2005, all declarations must explicitly specify the type. C4430 is always issued as an error. You can turn off this warning with the `#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). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4439.md b/docs/error-messages/compiler-warnings/compiler-warning-c4439.md index 9608a6c02cc..2c070c9fb21 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4439.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4439.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4439"] > '*function name*': function definition with a managed type in the signature must have a `__clrcall` calling convention +## Remarks + The compiler implicitly replaced a calling convention with [`__clrcall`](../../cpp/clrcall.md). To resolve this warning, remove the **`__cdecl`** or **`__stdcall`** calling convention. C4439 is always issued as an error. You can turn off this warning with the `#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). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md index 1bf00d11902..6d7d15d317c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md @@ -10,9 +10,15 @@ ms.assetid: 2e7ca136-f144-4b40-b847-82976e8643fc > 'bitfield' : member is bit field +## Remarks + Inline assembly code tries to access a bit-field member. Inline assembly cannot access bit-field members, so the last packing boundary before the bit-field member is used. -To avoid this warning, cast the bit field to an appropriate type before making the reference in inline assembly code. The following sample generates C4401: +To avoid this warning, cast the bit field to an appropriate type before making the reference in inline assembly code. + +## Example + +The following sample generates C4401: ```cpp // C4401.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md index 5682e2a4510..8f701470502 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md @@ -10,6 +10,8 @@ ms.assetid: 2aaecfae-1e79-4787-87e8-0973f7ec0efe > must use PTR operator +## Remarks + A type is used on an operand without a PTR operator when referring to or casting to a type in inline assembly code. The compiler assumes the PTR operator. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md index 8c308f2148a..88ef55136de 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md @@ -10,6 +10,8 @@ ms.assetid: d95597c9-4762-4f33-86e4-1d98f0e80d52 > illegal PTR operator +## Remarks + A PTR operator is used inappropriately in inline assembler code. The compiler ignored the PTR operator. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md index 9202ad1b259..33071a99a00 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md @@ -10,7 +10,13 @@ ms.assetid: 155c64d6-58ae-4455-b61f-ccd711c5da96 > 'identifier' : identifier is reserved word -A word reserved for inline assembly is used as a variable name. This may cause unpredictable results. To fix this warning, avoid naming variables with words reserved for inline assembly. The following sample generates C4405: +## Remarks + +A word reserved for inline assembly is used as a variable name. This may cause unpredictable results. To fix this warning, avoid naming variables with words reserved for inline assembly. + +## Example + +The following sample generates C4405: ```cpp // C4405.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md index 90624374b9f..26517a1769e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md @@ -10,6 +10,8 @@ ms.assetid: a3204731-2285-401c-b73b-af98586a86fa > operand on directive ignored +## Remarks + The directive does not take any operands, but an operand was specified. The compiler ignored the given operand or operands. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md index c206a7b8cda..9477919dfb3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4407"] > cast between different pointer to member representations, compiler may generate incorrect code -An incorrect cast between pointer-to-member types was detected. - ## Remarks +An incorrect cast between pointer-to-member types was detected. + C4407 can be generated because of compiler conformance work that was done in Visual Studio 2005. Pointer-to-member now requires a qualified name and the address-of operator (&). C4407 can occur if you cast between a multiple inheritance pointer-to-member to a single inheritance pointer-to-member. Sometimes this can work, but sometimes it can't because the single inheritance pointer-to-member representation doesn't hold sufficient information. Compiling with the **`/vmm`** might help. For more information, see [`/vmm`, `/vms`, `/vmv` (General purpose representation)](../../build/reference/vmm-vms-vmv-general-purpose-representation.md). You can also try rearranging your base classes; the compiler is detecting a loss of information in the conversion because a base class is at a non-zero offset from the derived. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md index ace66e16870..d620204ca21 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md @@ -10,4 +10,6 @@ ms.assetid: 2be63c86-d9c9-4073-ab71-e654dd9f450f > illegal instruction size +## Remarks + The instruction did not have a form with the specified size. The smallest legal size was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md index 40179d294f8..030e92e775d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md @@ -10,4 +10,6 @@ ms.assetid: 7dcdb720-118a-4823-ba73-575f6ad79a71 > illegal size for operand +## Remarks + One of the operands on the instruction had an incorrect size. The smallest legal size for the operand was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md index ba94d9f79c9..3f495fa6f62 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md @@ -10,4 +10,6 @@ ms.assetid: d209452c-83bd-4333-8d0b-759ca9b4864e > 'identifier' : symbol resolves to displacement register +## Remarks + The identifier is a local symbol that resolves to a displacement register and therefore may be used on an operand with another symbol. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md index 78a5c7b4b73..1589247536a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md @@ -10,6 +10,8 @@ ms.assetid: 44a37754-7ddd-4764-a5f7-d33e05c20091 > 'operator' : operator not available, using 'operator' instead; run-time checking may be compromised +## Remarks + This warning is generated when you use the [/RTCv](../../build/reference/rtc-run-time-error-checks.md) (vector new/delete checking) and when no vector form is found. In this case, the non-vector form is used. In order for /RTCv to work correctly, the compiler should always call the vector form of [new](../../cpp/new-operator-cpp.md)/[delete](../../cpp/delete-operator-cpp.md) if the vector syntax was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md index 9b3e694ede6..5b4e97c55ef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4436"] > `dynamic_cast` from virtual base '*base_class*' to '*derived_class*' in constructor or destructor could fail with partially-constructed object +## Remarks + A `dynamic_cast` operation is used when: - The cast is from a base class pointer to a derived class pointer. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md index 930be84995f..ecd8c6d4517 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md @@ -10,8 +10,12 @@ ms.assetid: 78b9642a-a93e-401e-9d92-372f6451bc5d > calling convention redefinition from 'calling_convention1' to 'calling_convention2' ignored +## Remarks + An attempt to change the calling convention was ignored. +## Example + The following sample generates C4440: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md index 666e12c5e25..6a4d97d20ff 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md @@ -10,6 +10,8 @@ ms.assetid: 7fc540a5-e41f-47cf-aa37-b2b699c2685e > calling convention of 'cc1' ignored; 'cc2' used instead +## Remarks + Member functions in managed user-defined types and global function generics must use the [__clrcall](../../cpp/clrcall.md) calling convention. The compiler used `__clrcall`. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md index d6ceffd17c6..ed4eaf9f7cc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md @@ -10,4 +10,6 @@ ms.assetid: 535e92a0-ba08-4dfc-89b2-af2dcdd7caeb > 'function' : in a WinRT or managed type a virtual method cannot be private +## Remarks + If a virtual function is private, it cannot be accessed by a derived type. To fix this error, change the accessibility of the virtual member function to protected or public. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md index 3ef99e97094..3de6848d042 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md @@ -23,7 +23,7 @@ C4412 is off by default. For more information, see [Compiler Warnings That Are O To resolve this warning, remove all functions from the type. -## Example +## Examples The following sample generates C4412: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md index b6fe07460de..55181bde7d3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md @@ -10,4 +10,6 @@ ms.assetid: 78ce9985-0ccd-4ec2-92bf-289475109cdd > period on directive ignored +## Remarks + The optional period preceding the directive is ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md index b4455077286..9ef07b7acc5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md @@ -10,8 +10,12 @@ ms.assetid: bc81d3ad-55dc-4a6b-a6f2-ec0ef38347df > 'function' : short jump to function converted to near +## Remarks + Short jumps generate compact instruction which branches to an address within a limited range from the instruction. The instruction includes a short offset that represents the distance between the jump and the target address, the function definition. During linking a function may be moved or subject to link-time optimizations that cause the function to be moved out of the range reachable from a short offset. The compiler must generate a special record for the jump, which requires the jmp instruction to be either NEAR or FAR. The compiler made the conversion. +## Example + For example, the following code generates C4414: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md index d988aeff4ac..d551c2fe0e1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md @@ -10,8 +10,12 @@ ms.assetid: 8488a186-ed1d-425c-aaeb-c72472c1da68 > anonymousstruct or union did not declare any data members +## Remarks + An anonymous struct or union must have at least one data member. +## Example + The following sample generates C4408: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md index 5850c916b56..468a49010b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md @@ -10,8 +10,12 @@ ms.assetid: a3e4cf1f-a869-4e47-834a-850c21eb5297 > possible incomplete or improperly formed universal-character-name +## Remarks + The compiler detected a character sequence that may be a badly formed universal character name. A universal character name is `\u` followed by four hex digits, or `\U` followed by eight hex digits. +## Example + The following sample generates C4429: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md index ac3348b03fb..6a23cb7f952 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md @@ -10,6 +10,8 @@ ms.assetid: 58434ab6-dd8d-427b-953a-602fb7453ae6 > missing type specifier - int assumed. Note: C no longer supports default-int +## Remarks + This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: Visual C++ no longer creates untyped identifiers as int by default. The type of an identifier must be specified explicitly. 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-c4434.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md index dd437579361..90c0af0853c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md @@ -10,6 +10,8 @@ ms.assetid: 24b8785e-353a-4c37-8bed-ed61001a871d > a class constructor must have private accessibility; changing to private access +## Remarks + C4434 indicates that the compiler changed the accessibility of a static constructor. Static constructors must have private accessibility, as they are only meant to be called by the common language runtime. For more information, see [Static constructors](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Static_constructors). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md index 8b30d0111b7..0afbe860557 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4435"] > '*derived_class*': Object layout under `/vd2` will change due to virtual base '*base_class*' +## Remarks + 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). Under the default compile option of `/vd1`, the derived class doesn't have a `vtordisp` field for the indicated virtual base. If `/vd2` or `#pragma vtordisp(2)` is in effect, a `vtordisp` field is present, changing the object layout. This difference can lead to binary compatibility problems if interacting modules are compiled with different `vtordisp` settings. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md index 6a5a36565b7..ce0ddeb7278 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4437"] > `dynamic_cast` from virtual base '*base_class*' to '*derived_class*' could fail in some contexts +## Remarks + 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). A `dynamic_cast` operation is used when: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md index 3860789485b..0c509a8a4b3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md @@ -10,6 +10,8 @@ ms.assetid: 5ab39fc1-0e19-461b-842b-4da80560b044 > declaration of '*identifier*' hides previous local declaration +## Remarks + The declaration of *identifier* in the local scope hides the declaration of the previous local declaration of the same name. This warning lets you know that references to *identifier* in the local scope resolve to the locally declared version, not the previous local, which may or may not be your intent. To fix this issue, we recommend you give local variables names that do not conflict with other local names. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md index af7a117ea6a..38534d3b8f5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md @@ -10,6 +10,8 @@ ms.assetid: 02fd149a-917d-4f67-97a6-eb714572271f > declaration of '*identifier*' hides function parameter +## Remarks + The declaration of *identifier* in the local scope hides the declaration of the identically-named function parameter. This warning lets you know that references to *identifier* in the local scope resolve to the locally declared version, not the parameter, which may or may not be your intent. To fix this issue, we recommend you give local variables names that do not conflict with parameter names. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md index 0aaf058dd0c..2ec32b31272 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md @@ -10,6 +10,8 @@ ms.assetid: 7bdaa1b1-0caf-4d68-98c4-6bdd441c23fb > declaration of '*identifier*' hides class member +## Remarks + The declaration of *identifier* in the local scope hides the declaration of the identically-named *identifier* at class scope. This warning lets you know that references to *identifier* in this scope resolve to the locally declared version, not the class member version, which may or may not be your intent. To fix this issue, we recommend you give local variables names that do not conflict with class member names. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md index ec827f8b2f7..658e8997db6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md @@ -10,6 +10,8 @@ ms.assetid: ee9f6287-9c70-4b10-82a0-add82a13997f > declaration of '*identifier*' hides global declaration +## Remarks + The declaration of *identifier* in the local scope hides the declaration of the identically-named *identifier* in global scope. This warning lets you know that references to *identifier* in this scope resolve to the locally declared version, not the global version, which may or may not be your intent. Generally, we recommend you minimize the use of global variables as a good engineering practice. To minimize pollution of the global namespace, we recommend use of a named namespace for global variables. This warning was new in Visual Studio 2015, in Microsoft C++ compiler version 18.00. To suppress warnings from that version of the compiler or later while migrating your code, use the [/Wv:18](../../build/reference/compiler-option-warning-level.md) compiler option. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md index 42fd1538433..78107d5fb0a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md @@ -10,6 +10,8 @@ ms.assetid: c97ac1c9-598d-479e-bfff-c993690c4f3d > WinRT or CLR operator 'operator', has parameter passed by reference. WinRT or CLR operator 'operator' has different semantics from C++ operator 'operator', did you intend to pass by value? +## Remarks + You passed a value by reference to a user-defined Windows Runtime or CLR operator. If the value is changed inside the function, note that the value returned after the function call will be assigned the return value of the function. In standard C++, the changed value is reflected after the function call. ## Example From 5b1c5bf9637f7f6bb06496d37067037df4592f73 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 00:54:53 +0800 Subject: [PATCH 1026/1799] Replace term "sample" with "example" for warning references in range [C4401, C4460] --- .../compiler-warnings/compiler-warning-c4430.md | 2 +- .../compiler-warnings/compiler-warning-c4439.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4401.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4405.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4407.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4436.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4440.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4441.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4412.md | 8 ++++---- .../compiler-warnings/compiler-warning-level-4-c4408.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4429.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4431.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4434.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4435.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4437.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4456.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4457.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4458.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4459.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4460.md | 2 +- 20 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4430.md b/docs/error-messages/compiler-warnings/compiler-warning-c4430.md index 5accdb977f0..cca8a9f0921 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4430.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4430.md @@ -17,7 +17,7 @@ C4430 is always issued as an error. You can turn off this warning with the `#pra ## Example -The following sample generates C4430: +The following example generates C4430: ```cpp // compile with: /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4439.md b/docs/error-messages/compiler-warnings/compiler-warning-c4439.md index 2c070c9fb21..0665a22fd99 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4439.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4439.md @@ -17,7 +17,7 @@ C4439 is always issued as an error. You can turn off this warning with the `#pra ## Example -The following sample generates C4439: +The following example generates C4439: ```cpp // C4439.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md index 6d7d15d317c..0e1170bde08 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md @@ -18,7 +18,7 @@ To avoid this warning, cast the bit field to an appropriate type before making t ## Example -The following sample generates C4401: +The following example generates C4401: ```cpp // C4401.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md index 33071a99a00..3b68ff0ca0b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md @@ -16,7 +16,7 @@ A word reserved for inline assembly is used as a variable name. This may cause u ## Example -The following sample generates C4405: +The following example generates C4405: ```cpp // C4405.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md index 9477919dfb3..5ae0f1417ca 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md @@ -19,7 +19,7 @@ C4407 can occur if you cast between a multiple inheritance pointer-to-member to ## Example -The following sample generates C4407 and shows how to fix it: +The following example generates C4407 and shows how to fix it: ```cpp // C4407.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md index 5b4e97c55ef..97f5ccc89fc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md @@ -22,7 +22,7 @@ This warning indicates that the `dynamic_cast` might not perform correctly if it ## Example -The following sample generates C4436 and demonstrates the code generation issue due to the missing `vtordisp` field: +The following example generates C4436 and demonstrates the code generation issue due to the missing `vtordisp` field: ```cpp // C4436.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md index ecd8c6d4517..df3b85b08d4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md @@ -16,7 +16,7 @@ An attempt to change the calling convention was ignored. ## Example -The following sample generates C4440: +The following example generates C4440: ```cpp // C4440.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md index 6a4d97d20ff..6eafbb170ae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md @@ -16,7 +16,7 @@ Member functions in managed user-defined types and global function generics must ## Example -The following sample generates C4441. +The following example generates C4441. ```cpp // C4441.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md index 3de6848d042..d020f1b7fd6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md @@ -25,7 +25,7 @@ To resolve this warning, remove all functions from the type. ## Examples -The following sample generates C4412: +The following example generates C4412: ```cpp // compile with: /c /W2 /clr:pure @@ -50,7 +50,7 @@ int main() { } ``` -The following sample is a header file that declares two types. The `Unsafe` type is unsafe because it has a member function: +The following example is a header file that declares two types. The `Unsafe` type is unsafe because it has a member function: ```cpp // C4412.h @@ -68,7 +68,7 @@ struct Safe { }; ``` -This sample exports functions with the types defined in the header file: +This example exports functions with the types defined in the header file: ```cpp // C4412_2.cpp @@ -85,7 +85,7 @@ __declspec(dllexport) Safe * __cdecl func2() { return new Safe; } The default calling convention in a `/clr:pure` compilation is different from a native compilation. When `C4412.h` is included, `Test` defaults to `__clrcall`. -The following sample generates C4412 and throws an exception at runtime: +The following example generates C4412 and throws an exception at runtime: ```cpp // C4412_3.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md index d551c2fe0e1..6b58a85589f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md @@ -16,7 +16,7 @@ An anonymous struct or union must have at least one data member. ## Example -The following sample generates C4408: +The following example generates C4408: ```cpp // C4408.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md index 468a49010b1..5e9ee97063c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md @@ -16,7 +16,7 @@ The compiler detected a character sequence that may be a badly formed universal ## Example -The following sample generates C4429: +The following example generates C4429: ```cpp // C4429.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md index 6a23cb7f952..bd784076909 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4431. +The following example generates C4431. ```c // C4431.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md index 90c0af0853c..58611b4fa88 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md @@ -16,7 +16,7 @@ C4434 indicates that the compiler changed the accessibility of a static construc ## Example -The following sample generates C4434. +The following example generates C4434. ```cpp // C4434.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md index 0afbe860557..faedfa4a148 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md @@ -17,7 +17,7 @@ Under the default compile option of `/vd1`, the derived class doesn't have a `vt ## Example -The following sample generates C4435. +The following example generates C4435. ```cpp // C4435.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md index ce0ddeb7278..0a5e440a899 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md @@ -24,7 +24,7 @@ This warning indicates that the `dynamic_cast` might not perform correctly when ## Example -The following sample generates C4437 and demonstrates the code generation issue that arises from the missing `vtordisp` field: +The following example generates C4437 and demonstrates the code generation issue that arises from the missing `vtordisp` field: ```cpp // C4437.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md index 0c509a8a4b3..7cb3e2a00c8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md @@ -16,7 +16,7 @@ The declaration of *identifier* in the local scope hides the declaration of the ## Example -The following sample generates C4456 because the loop control variable `int x` and the local variable `double x` in `member_fn` have the same names. To fix this issue, use different names for the local variables. +The following example generates C4456 because the loop control variable `int x` and the local variable `double x` in `member_fn` have the same names. To fix this issue, use different names for the local variables. ```cpp // C4456_hide.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md index 38534d3b8f5..6ebf6854e54 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md @@ -16,7 +16,7 @@ The declaration of *identifier* in the local scope hides the declaration of the ## Example -The following sample generates C4457 because the parameter `x` and the local variable `x` in `member_fn` have the same names. To fix this issue, use different names for the parameters and local variables. +The following example generates C4457 because the parameter `x` and the local variable `x` in `member_fn` have the same names. To fix this issue, use different names for the parameters and local variables. ```cpp // C4457_hide.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md index 2ec32b31272..fd170700fad 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md @@ -16,7 +16,7 @@ The declaration of *identifier* in the local scope hides the declaration of the ## Example -The following sample generates C4458 because the parameter `x` and the local variable `y` in `member_fn` have the same names as data members in the class. To fix this issue, use different names for the parameters and local variables. +The following example generates C4458 because the parameter `x` and the local variable `y` in `member_fn` have the same names as data members in the class. To fix this issue, use different names for the parameters and local variables. ```cpp // C4458_hide.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md index 658e8997db6..7b403b39786 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md @@ -18,7 +18,7 @@ This warning was new in Visual Studio 2015, in Microsoft C++ compiler version 18 ## Example -The following sample generates C4459: +The following example generates C4459: ```cpp // C4459_hide.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md index 78107d5fb0a..b8b92dd0195 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md @@ -16,7 +16,7 @@ You passed a value by reference to a user-defined Windows Runtime or CLR operato ## Example -The following sample generates C4460 and shows how to fix it. +The following example generates C4460 and shows how to fix it. ```cpp // C4460.cpp From d7227c0091f641d62e693269e2965a9303e756c5 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 00:59:41 +0800 Subject: [PATCH 1027/1799] Update metadata for warning references in range [C4401, C4460] --- .../compiler-warnings/compiler-warning-c4430.md | 2 +- .../compiler-warnings/compiler-warning-c4439.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4401.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4402.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4403.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4405.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4406.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4407.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4409.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4410.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4411.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4420.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4436.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4440.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4441.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4445.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4412.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4404.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4414.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4408.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4429.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4431.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4434.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4435.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4437.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4456.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4457.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4458.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4459.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4460.md | 5 ++--- 30 files changed, 58 insertions(+), 81 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4430.md b/docs/error-messages/compiler-warnings/compiler-warning-c4430.md index cca8a9f0921..82777f11454 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4430.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4430.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 1, error) C4430" title: "Compiler warning (level 1, error) C4430" +description: "Learn more about: Compiler Warning (level 1, error) C4430" ms.date: 04/22/2025 f1_keywords: ["C4430"] helpviewer_keywords: ["C4430"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4439.md b/docs/error-messages/compiler-warnings/compiler-warning-c4439.md index 0665a22fd99..b4b5b4ffc3e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4439.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4439.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, error) C4439" title: "Compiler warning (level 1, error) C4439" -ms.date: "1/22/2025" +description: "Learn more about: Compiler Warning (level 1, error) C4439" +ms.date: 1/22/2025 f1_keywords: ["C4439"] helpviewer_keywords: ["C4439"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md index 0e1170bde08..0e77fd61c51 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4401" title: "Compiler Warning (level 1) C4401" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4401" +ms.date: 11/04/2016 f1_keywords: ["C4401"] helpviewer_keywords: ["C4401"] -ms.assetid: 2e7ca136-f144-4b40-b847-82976e8643fc --- # Compiler Warning (level 1) C4401 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md index 8f701470502..986cfddad83 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4402" title: "Compiler Warning (level 1) C4402" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4402" +ms.date: 11/04/2016 f1_keywords: ["C4402"] helpviewer_keywords: ["C4402"] -ms.assetid: 2aaecfae-1e79-4787-87e8-0973f7ec0efe --- # Compiler Warning (level 1) C4402 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md index 88ef55136de..afb02f7bd0b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4403" title: "Compiler Warning (level 1) C4403" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4403" +ms.date: 11/04/2016 f1_keywords: ["C4403"] helpviewer_keywords: ["C4403"] -ms.assetid: d95597c9-4762-4f33-86e4-1d98f0e80d52 --- # Compiler Warning (level 1) C4403 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md index 3b68ff0ca0b..92efb9f9abd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4405" title: "Compiler Warning (level 1) C4405" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4405" +ms.date: 11/04/2016 f1_keywords: ["C4405"] helpviewer_keywords: ["C4405"] -ms.assetid: 155c64d6-58ae-4455-b61f-ccd711c5da96 --- # Compiler Warning (level 1) C4405 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md index 26517a1769e..e600ed36ea4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4406" title: "Compiler Warning (level 1) C4406" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4406" +ms.date: 11/04/2016 f1_keywords: ["C4406"] helpviewer_keywords: ["C4406"] -ms.assetid: a3204731-2285-401c-b73b-af98586a86fa --- # Compiler Warning (level 1) C4406 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md index 5ae0f1417ca..88b9df38c30 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4407" title: "Compiler Warning (level 1) C4407" +description: "Learn more about: Compiler Warning (level 1) C4407" ms.date: 04/13/2021 f1_keywords: ["C4407"] helpviewer_keywords: ["C4407"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md index d620204ca21..6f4a121e0bc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4409" title: "Compiler Warning (level 1) C4409" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4409" +ms.date: 11/04/2016 f1_keywords: ["C4409"] helpviewer_keywords: ["C4409"] -ms.assetid: 2be63c86-d9c9-4073-ab71-e654dd9f450f --- # Compiler Warning (level 1) C4409 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md index 030e92e775d..391e7ca2304 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4410" title: "Compiler Warning (level 1) C4410" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4410" +ms.date: 11/04/2016 f1_keywords: ["C4410"] helpviewer_keywords: ["C4410"] -ms.assetid: 7dcdb720-118a-4823-ba73-575f6ad79a71 --- # Compiler Warning (level 1) C4410 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md index 3f495fa6f62..04ee68c961b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4411" title: "Compiler Warning (level 1) C4411" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4411" +ms.date: 11/04/2016 f1_keywords: ["C4411"] helpviewer_keywords: ["C4411"] -ms.assetid: d209452c-83bd-4333-8d0b-759ca9b4864e --- # Compiler Warning (level 1) C4411 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md index 1589247536a..912f91fef5e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4420" title: "Compiler Warning (level 1) C4420" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4420" +ms.date: 11/04/2016 f1_keywords: ["C4420"] helpviewer_keywords: ["C4420"] -ms.assetid: 44a37754-7ddd-4764-a5f7-d33e05c20091 --- # Compiler Warning (level 1) C4420 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md index 97f5ccc89fc..e2565cf0115 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4436" title: "Compiler warning (level 1 and level 4) C4436" -ms.date: "1/22/2025" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4436" +ms.date: 1/22/2025 f1_keywords: ["C4436"] helpviewer_keywords: ["C4436"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md index df3b85b08d4..27027d44236 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4440" title: "Compiler Warning (level 1) C4440" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4440" +ms.date: 11/04/2016 f1_keywords: ["C4440"] helpviewer_keywords: ["C4440"] -ms.assetid: 78b9642a-a93e-401e-9d92-372f6451bc5d --- # Compiler Warning (level 1) C4440 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md index 6eafbb170ae..d4c727635c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4441" title: "Compiler Warning (level 1) C4441" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4441" +ms.date: 11/04/2016 f1_keywords: ["C4441"] helpviewer_keywords: ["C4441"] -ms.assetid: 7fc540a5-e41f-47cf-aa37-b2b699c2685e --- # Compiler Warning (level 1) C4441 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md index ed4eaf9f7cc..d50740c4fd0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4445" title: "Compiler Warning (level 1) C4445" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4445" +ms.date: 11/04/2016 f1_keywords: ["C4445"] helpviewer_keywords: ["C4445"] -ms.assetid: 535e92a0-ba08-4dfc-89b2-af2dcdd7caeb --- # Compiler Warning (level 1) C4445 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md index d020f1b7fd6..a8072422312 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 2, off) C4412" title: "Compiler warning (level 2, off) C4412" -ms.date: "1/22/2025" +description: "Learn more about: Compiler Warning (level 2, off) C4412" +ms.date: 1/22/2025 f1_keywords: ["C4412"] helpviewer_keywords: ["C4412"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md index 55181bde7d3..9284eab853c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4404" title: "Compiler Warning (level 3) C4404" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4404" +ms.date: 11/04/2016 f1_keywords: ["C4404"] helpviewer_keywords: ["C4404"] -ms.assetid: 78ce9985-0ccd-4ec2-92bf-289475109cdd --- # Compiler Warning (level 3) C4404 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md index 9ef07b7acc5..e9002be53f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4414" title: "Compiler Warning (level 3) C4414" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4414" +ms.date: 11/04/2016 f1_keywords: ["C4414"] helpviewer_keywords: ["C4414"] -ms.assetid: bc81d3ad-55dc-4a6b-a6f2-ec0ef38347df --- # Compiler Warning (level 3) C4414 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md index 6b58a85589f..80c566c3d8a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4408" title: "Compiler Warning (level 4) C4408" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4408" +ms.date: 11/04/2016 f1_keywords: ["C4408"] helpviewer_keywords: ["C4408"] -ms.assetid: 8488a186-ed1d-425c-aaeb-c72472c1da68 --- # Compiler Warning (level 4) C4408 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md index 5e9ee97063c..f4fae6bd4dc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4429" title: "Compiler Warning (level 4) C4429" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4429" +ms.date: 11/04/2016 f1_keywords: ["C4429"] helpviewer_keywords: ["C4429"] -ms.assetid: a3e4cf1f-a869-4e47-834a-850c21eb5297 --- # Compiler Warning (level 4) C4429 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md index bd784076909..68660c09337 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4431" title: "Compiler Warning (level 4) C4431" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4431" +ms.date: 11/04/2016 f1_keywords: ["C4431"] helpviewer_keywords: ["C4431"] -ms.assetid: 58434ab6-dd8d-427b-953a-602fb7453ae6 --- # Compiler Warning (level 4) C4431 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md index 58611b4fa88..6b7e6b52ba9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4434" title: "Compiler Warning (level 4) C4434" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4434" +ms.date: 11/04/2016 f1_keywords: ["C4434"] helpviewer_keywords: ["C4434"] -ms.assetid: 24b8785e-353a-4c37-8bed-ed61001a871d --- # Compiler Warning (level 4) C4434 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md index faedfa4a148..aa094d91d24 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4435" title: "Compiler Warning (level 4, off) C4435" -ms.date: "1/22/2025" +description: "Learn more about: Compiler Warning (level 4, off) C4435" +ms.date: 1/22/2025 f1_keywords: ["C4435"] helpviewer_keywords: ["C4435"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md index 0a5e440a899..5e09076edc4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4, off) C4437" title: "Compiler warning (level 1 and level 4, off) C4437" -ms.date: "1/22/2025" +description: "Learn more about: Compiler Warning (level 1 and level 4, off) C4437" +ms.date: 1/22/2025 f1_keywords: ["C4437"] helpviewer_keywords: ["C4437"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md index 7cb3e2a00c8..a86eb36dd45 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4456" title: "Compiler Warning (level 4) C4456" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4456" +ms.date: 11/04/2016 f1_keywords: ["C4456"] helpviewer_keywords: ["C4456"] -ms.assetid: 5ab39fc1-0e19-461b-842b-4da80560b044 --- # Compiler Warning (level 4) C4456 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md index 6ebf6854e54..7f39af8da85 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4457" title: "Compiler Warning (level 4) C4457" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4457" +ms.date: 11/04/2016 f1_keywords: ["C4457"] helpviewer_keywords: ["C4457"] -ms.assetid: 02fd149a-917d-4f67-97a6-eb714572271f --- # Compiler Warning (level 4) C4457 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md index fd170700fad..c1189b04ffb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4458" title: "Compiler Warning (level 4) C4458" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4458" +ms.date: 11/04/2016 f1_keywords: ["C4458"] helpviewer_keywords: ["C4458"] -ms.assetid: 7bdaa1b1-0caf-4d68-98c4-6bdd441c23fb --- # Compiler Warning (level 4) C4458 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md index 7b403b39786..417dfe669c4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4459" title: "Compiler Warning (level 4) C4459" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4459" +ms.date: 11/04/2016 f1_keywords: ["C4459"] helpviewer_keywords: ["C4459"] -ms.assetid: ee9f6287-9c70-4b10-82a0-add82a13997f --- # Compiler Warning (level 4) C4459 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md index b8b92dd0195..df25079de59 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4460" title: "Compiler Warning (level 4) C4460" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4460" +ms.date: 11/04/2016 f1_keywords: ["C4460"] helpviewer_keywords: ["C4460"] -ms.assetid: c97ac1c9-598d-479e-bfff-c993690c4f3d --- # Compiler Warning (level 4) C4460 From e33cb2da900f32b6f6cb5291269998f654bf36dc Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 17:46:34 +0800 Subject: [PATCH 1028/1799] Add blockquotes for warning messages in range [C4461, C4520] --- docs/error-messages/compiler-warnings/compiler-warning-c4484.md | 2 +- docs/error-messages/compiler-warnings/compiler-warning-c4485.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4461.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4470.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4486.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4488.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4489.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4490.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4502.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4506.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4508.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4518.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4511.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4471.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4481.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4487.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4505.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4512.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4513.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4514.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4515.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4516.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4517.md | 2 +- 23 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md index fc6a823d68f..1254c188dc1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md @@ -8,7 +8,7 @@ ms.assetid: 3d30e5b3-2297-45b7-a37a-1360056fdd0e --- # Compiler Warning C4484 -'override_function' : matches base ref class method 'base_class_function', but is not marked 'virtual', 'new' or 'override'; 'new' (and not 'virtual') is assumed +> 'override_function' : matches base ref class method 'base_class_function', but is not marked 'virtual', 'new' or 'override'; 'new' (and not 'virtual') is assumed When compiling with **/clr**, the compiler will not implicitly override a base class function, which means the function will get a new slot in the vtable. To resolve, explicitly specify whether a function is an override. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md index 29ce3800cd3..b42aee5bc63 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md @@ -8,7 +8,7 @@ ms.assetid: a6f2b437-ca93-4dcd-b9cb-df415e10df86 --- # Compiler Warning C4485 -'override_function' : matches base ref class method 'base_class_function ', but is not marked 'new' or 'override'; 'new' (and 'virtual') is assumed +> 'override_function' : matches base ref class method 'base_class_function ', but is not marked 'new' or 'override'; 'new' (and 'virtual') is assumed An accessor overrides, with or without the **`virtual`** keyword, a base class accessor function, but the `override` or **`new`** specifier was not part of the overriding function signature. Add the **`new`** or `override` specifier to resolve this warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md index ec88b65c40d..f20665a9ca0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md @@ -8,7 +8,7 @@ ms.assetid: 104ffecc-3dd4-4cb1-89a8-81154fbe46d9 --- # Compiler Warning (level 1) C4461 -'type' : this class has a finalizer 'finalizer' but no destructor 'dtor' +> 'type' : this class has a finalizer 'finalizer' but no destructor 'dtor' The presence of a finalizer in a type implies resources to delete. Unless a finalizer is explicitly called from the type's destructor, the common language runtime determines when to run the finalizer, after your object goes out of scope. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md index 74f847fd992..486f613b7d6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md @@ -8,7 +8,7 @@ ms.assetid: f52a3eaa-a235-4747-a47d-9ec4ad4cb0ea --- # Compiler Warning (level 1) C4470 -floating-point control pragmas ignored under /clr +> floating-point control pragmas ignored under /clr The float-control pragmas: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md index 319dbc7c1d9..d2ceddcc148 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md @@ -8,7 +8,7 @@ ms.assetid: 2c0c59e3-d025-4d97-8da2-fa27df1402fc --- # Compiler Warning (level 1) C4486 -'function' : a private virtual method of a ref class or value class should be marked 'sealed' +> 'function' : a private virtual method of a ref class or value class should be marked 'sealed' Since a private virtual member function of a managed class or struct cannot be accessed or overridden, it should be marked [sealed](../../extensions/sealed-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md index 9faef2a3235..132a3a9c5f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md @@ -8,7 +8,7 @@ ms.assetid: 55625e46-ddb5-4c7c-99c7-cd4aa9f879bd --- # Compiler Warning (level 1) C4488 -'function' : requires 'keyword' keyword to implement the interface method 'interface_method' +> 'function' : requires 'keyword' keyword to implement the interface method 'interface_method' A class must implement all members of an interface from which it directly inherits. An implemented member must have public accessibility, and must be marked virtual. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md index e0882054020..6b40da891f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md @@ -8,7 +8,7 @@ ms.assetid: 43b51c8c-27b5-44c9-b974-fe4b48f4896f --- # Compiler Warning (level 1) C4489 -'specifier' : not allowed on interface method 'method'; override specifiers are only allowed on ref class and value class methods +> 'specifier' : not allowed on interface method 'method'; override specifiers are only allowed on ref class and value class methods A specifier keyword was incorrectly used on an interface method. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md index 533ee9f3bb5..8c5b9a9237c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md @@ -8,7 +8,7 @@ ms.assetid: f9b03ecf-41a1-4f4d-a74c-2c1e88234ccc --- # Compiler Warning (level 1) C4490 -'override' : incorrect use of override specifier; 'function' does not match a base ref class method +> 'override' : incorrect use of override specifier; 'function' does not match a base ref class method An override specifier was used incorrectly. For example, you do not override an interface function, you implement it. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md index 7ed4e44ea8e..772dc4d7d4e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md @@ -8,7 +8,7 @@ ms.assetid: d8d43153-a40c-4b96-bc11-64028a144d70 --- # Compiler Warning (level 1) C4502 -'linkage specification' requires use of keyword 'extern' and must precede all other specifiers +> 'linkage specification' requires use of keyword 'extern' and must precede all other specifiers A linkage was specified without the **`extern`** keyword. Linkage is not relevant to non-extern types. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md index 85662502e78..627245b01f1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md @@ -8,7 +8,7 @@ ms.assetid: aa682869-65d1-4dad-ba32-198f10b44f91 --- # Compiler Warning (level 1) C4506 -no definition for inline function 'function' +> no definition for inline function 'function' The given function was declared and marked for inlining but was not defined. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md index f4ce654e68a..8fda7164ee2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md @@ -8,7 +8,7 @@ ms.assetid: c05f113b-b789-4df0-a4ef-78bce4767021 --- # Compiler Warning (level 1) C4508 -'function' : function should return a value; 'void' return type assumed +> 'function' : function should return a value; 'void' return type assumed The function has no return type specified. In this case, C4430 should also fire and the compiler implements the fix reported by C4430 (default value is int). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md index 717e2457340..efe2b2d38a7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md @@ -8,7 +8,7 @@ ms.assetid: 4ad21004-f076-43fd-99f4-4bf1f9be4c0b --- # Compiler Warning (level 1) C4518 -'specifier' : storage-class or type specifier(s) unexpected here; ignored +> 'specifier' : storage-class or type specifier(s) unexpected here; ignored The following sample generates C4518: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md index 198c5895880..f74a45801c8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md @@ -8,6 +8,6 @@ ms.assetid: a01286b2-3dd9-4a97-a5ee-dd0e7b63ef8b --- # Compiler Warning (level 3) C4511 -'class' : copy constructor could not be generated +> 'class' : copy constructor could not be generated The compiler could not generate a default copy-constructor for a class; a base class may have a private copy-constructor. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md index 958561ae411..063b3fe045e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md @@ -8,7 +8,7 @@ ms.assetid: ccfd8bd5-bc1b-4be7-a6ea-0e3a7add6607 --- # Compiler Warning (level 4) C4471 -'*enumeration*': a forward declaration of an unscoped enumeration must have an underlying type (int assumed) +> '*enumeration*': a forward declaration of an unscoped enumeration must have an underlying type (int assumed) A forward declaration of an unscoped enumeration was found without a specifier for the underlying type. By default, Visual C++ assumes **`int`** is the underlying type for an enumeration. This can cause issues if a different type is used in the enumeration definition, for example, if a different explicit type is specified, or if a different type is implicitly set by an initializer. You may also have portability issues; other compilers do not assume **`int`** is the underlying type of an enumeration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md index 3320ac5730d..f9a333b2467 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md @@ -8,7 +8,7 @@ ms.assetid: 7bfd4e0c-b452-4e6c-b7c4-ac5cc93fe4ea --- # Compiler Warning (level 4) C4481 -nonstandard extension used: override specifier 'keyword' +> nonstandard extension used: override specifier 'keyword' A keyword was used that is not in the C++ standard, for example, one of the override specifiers that also works under /clr. For more information, see, diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md index 376ae3a09e2..e44eac046e8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md @@ -8,7 +8,7 @@ ms.assetid: 796144cf-cd3c-4edc-b6a4-96192b7eb4f0 --- # Compiler Warning (level 4) C4487 -'derived_class_function' : matches inherited non-virtual method 'base_class_function' but is not explicitly marked 'new' +> 'derived_class_function' : matches inherited non-virtual method 'base_class_function' but is not explicitly marked 'new' A function in a derived class has the same signature as a non-virtual base class function. C4487 reminds you that the derived class function does not override the base class function. Explicitly mark the derived class function as **`new`** to resolve this warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md index 018e89e157d..2fe46f92ce7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md @@ -8,7 +8,7 @@ ms.assetid: 068716a0-7dd2-40af-abf4-478f893b48c5 --- # Compiler Warning (level 4) C4505 -'function' : unreferenced local function has been removed +> 'function' : unreferenced local function has been removed The given function is local and not referenced in the body of the module; therefore, the function is dead code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md index 2a43b103223..ea3a02f0772 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md @@ -8,7 +8,7 @@ ms.assetid: afb68995-684a-4be5-a73a-38d7a16dc030 --- # Compiler Warning (level 4) C4512 -'class' : assignment operator could not be generated +> 'class' : assignment operator could not be generated The compiler cannot generate an assignment operator for the given class. No assignment operator was created. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md index ebc5ecc71f9..db7fe9c3c3b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md @@ -8,6 +8,6 @@ ms.assetid: 6877334a-f30a-4184-9483-dac3348737a4 --- # Compiler Warning (level 4) C4513 -'class' : destructor could not be generated +> 'class' : destructor could not be generated The compiler cannot generate a default destructor for the given class; no destructor was created. The destructor is in a base class that is not accessible to the derived class. If the base class has a private destructor, make it public or protected. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md index ea7cba7688b..4512701c913 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md @@ -8,7 +8,7 @@ ms.assetid: cdae966a-9cd4-4e31-af30-2a014e68f614 --- # Compiler Warning (level 4) C4514 -'function' : unreferenced inline function has been removed +> 'function' : unreferenced inline function has been removed The optimizer removed an inline function that is not called. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md index 525da292979..e707f1c80c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md @@ -8,7 +8,7 @@ ms.assetid: 167b5177-3f89-418b-b6c8-7de634f6b28f --- # Compiler Warning (level 4) C4515 -'namespace' : namespace uses itself +> 'namespace' : namespace uses itself A namespace is used recursively. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md index 95e905c9ac8..7e9cb6af507 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md @@ -8,7 +8,7 @@ ms.assetid: 6677bb1f-d26e-4ab9-8644-6b5a2a8f4ff8 --- # Compiler Warning (level 4) C4516 -'class::symbol' : access-declarations are deprecated; member using-declarations provide a better alternative +> 'class::symbol' : access-declarations are deprecated; member using-declarations provide a better alternative The ANSI C++ committee has declared access declarations (changing the access of a member in a derived class without the [using](../../cpp/using-declaration.md) keyword) to be outdated. Access declarations may not be supported by future versions of C++. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md index bcc52f94383..5d5b1e51930 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md @@ -8,6 +8,6 @@ ms.assetid: 87cc12b8-7331-4f3a-a863-d6a75d9599c3 --- # Compiler Warning (level 4) C4517 -access-declarations are deprecated; member using-declarations provide a better alternative +> access-declarations are deprecated; member using-declarations provide a better alternative The ANSI C++ committee has declared access declarations (changing the access of a member in a derived class without the [using](../../cpp/using-declaration.md) keyword) to be outdated. Access declarations may not be supported by future versions of C++. From 65225b02f00ea668f44f2f45e0f97e7c43f8cb8c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 17:57:00 +0800 Subject: [PATCH 1029/1799] Add "Remarks" and "Example" headings for warning references in range [C4461, C4520] --- docs/error-messages/compiler-warnings/c4477.md | 2 ++ .../compiler-warnings/compiler-warning-c4484.md | 2 ++ .../compiler-warnings/compiler-warning-c4485.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4461.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4462.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4470.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4486.md | 4 +++- .../compiler-warnings/compiler-warning-level-1-c4488.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4489.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4490.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4502.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4506.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4508.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4518.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4511.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4463.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4464.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4471.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4481.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4487.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4505.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4510.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4512.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4513.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4514.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4515.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4516.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4517.md | 2 ++ 28 files changed, 67 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4477.md b/docs/error-messages/compiler-warnings/c4477.md index 6a661707d9b..69a6c4913fc 100644 --- a/docs/error-messages/compiler-warnings/c4477.md +++ b/docs/error-messages/compiler-warnings/c4477.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4477"] > '*function*' : format string '*string*' requires an argument of type '*type*', but variadic argument *number* has type '*type*' +## Remarks + The compiler detected a mismatch between the type of argument required to satisfy the placeholder in a format string, and the type of argument supplied. Correct use of the printf and scanf families of variadic functions requires that you supply arguments of the types specified by the format string. A mismatch generally means there is a bug in your code. For information on the arguments associated with printf family format string placeholders, see [Format specification syntax: printf and wprintf functions](../../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md). See the documentation for information specific to function *function*. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md index 1254c188dc1..8ad8a517378 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md @@ -10,6 +10,8 @@ ms.assetid: 3d30e5b3-2297-45b7-a37a-1360056fdd0e > 'override_function' : matches base ref class method 'base_class_function', but is not marked 'virtual', 'new' or 'override'; 'new' (and not 'virtual') is assumed +## Remarks + When compiling with **/clr**, the compiler will not implicitly override a base class function, which means the function will get a new slot in the vtable. To resolve, explicitly specify whether a function is an override. For more information, see: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md index b42aee5bc63..ebcba1b66ce 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md @@ -10,6 +10,8 @@ ms.assetid: a6f2b437-ca93-4dcd-b9cb-df415e10df86 > 'override_function' : matches base ref class method 'base_class_function ', but is not marked 'new' or 'override'; 'new' (and 'virtual') is assumed +## Remarks + An accessor overrides, with or without the **`virtual`** keyword, a base class accessor function, but the `override` or **`new`** specifier was not part of the overriding function signature. Add the **`new`** or `override` specifier to resolve this warning. See [override](../../extensions/override-cpp-component-extensions.md) and [new (new slot in vtable)](../../extensions/new-new-slot-in-vtable-cpp-component-extensions.md) for more information. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md index f20665a9ca0..3db90c99f04 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md @@ -10,6 +10,8 @@ ms.assetid: 104ffecc-3dd4-4cb1-89a8-81154fbe46d9 > 'type' : this class has a finalizer 'finalizer' but no destructor 'dtor' +## Remarks + The presence of a finalizer in a type implies resources to delete. Unless a finalizer is explicitly called from the type's destructor, the common language runtime determines when to run the finalizer, after your object goes out of scope. If you define a destructor in the type and explicitly call the finalizer from the destructor, you can deterministically run your finalizer. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md index 63d4762be21..279e498aa80 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md @@ -10,6 +10,8 @@ ms.assetid: 4e20aca4-293e-4c75-a83d-961c27ab7840 > cannot determine the GUID of the type. Program may fail at runtime. +## Remarks + Warning C4462 occurs in a Windows Runtime app or component when a public `TypedEventHandler` has as one of its type parameters a reference to the enclosing class. This warning is automatically promoted to an error. If you wish to modify this behavior, use [#pragma warning](../../preprocessor/warning.md). For example, to make C4462 into a level 4 warning issue, add this line to your source code file: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md index 486f613b7d6..abbbab1ba4f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md @@ -10,6 +10,8 @@ ms.assetid: f52a3eaa-a235-4747-a47d-9ec4ad4cb0ea > floating-point control pragmas ignored under /clr +## Remarks + The float-control pragmas: - [fenv_access](../../preprocessor/fenv-access.md) @@ -20,6 +22,8 @@ The float-control pragmas: have no effect under [/clr](../../build/reference/clr-common-language-runtime-compilation.md). +## Example + The following sample generates C4470: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md index d2ceddcc148..2f6f20aa84d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md @@ -10,9 +10,11 @@ ms.assetid: 2c0c59e3-d025-4d97-8da2-fa27df1402fc > 'function' : a private virtual method of a ref class or value class should be marked 'sealed' +## Remarks + Since a private virtual member function of a managed class or struct cannot be accessed or overridden, it should be marked [sealed](../../extensions/sealed-cpp-component-extensions.md). -## Examples +## Example The following sample generates C4486. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md index 132a3a9c5f4..17a99b1636a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md @@ -10,6 +10,8 @@ ms.assetid: 55625e46-ddb5-4c7c-99c7-cd4aa9f879bd > 'function' : requires 'keyword' keyword to implement the interface method 'interface_method' +## Remarks + A class must implement all members of an interface from which it directly inherits. An implemented member must have public accessibility, and must be marked virtual. ## Examples diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md index 6b40da891f2..6b275b60d20 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md @@ -10,6 +10,8 @@ ms.assetid: 43b51c8c-27b5-44c9-b974-fe4b48f4896f > 'specifier' : not allowed on interface method 'method'; override specifiers are only allowed on ref class and value class methods +## Remarks + A specifier keyword was incorrectly used on an interface method. For more information, see [Override Specifiers](../../extensions/override-specifiers-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md index 8c5b9a9237c..d91fc17a2f7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md @@ -10,6 +10,8 @@ ms.assetid: f9b03ecf-41a1-4f4d-a74c-2c1e88234ccc > 'override' : incorrect use of override specifier; 'function' does not match a base ref class method +## Remarks + An override specifier was used incorrectly. For example, you do not override an interface function, you implement it. For more information, see [Override Specifiers](../../extensions/override-specifiers-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md index 772dc4d7d4e..273b48e6ebb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md @@ -10,6 +10,8 @@ ms.assetid: d8d43153-a40c-4b96-bc11-64028a144d70 > 'linkage specification' requires use of keyword 'extern' and must precede all other specifiers +## Remarks + A linkage was specified without the **`extern`** keyword. Linkage is not relevant to non-extern types. The compiler assumed the **`extern`** keyword. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md index 627245b01f1..d829b87e503 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md @@ -10,6 +10,8 @@ ms.assetid: aa682869-65d1-4dad-ba32-198f10b44f91 > no definition for inline function 'function' +## Remarks + The given function was declared and marked for inlining but was not defined. The compiler did not inline the function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md index 8fda7164ee2..81121151257 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md @@ -10,10 +10,14 @@ ms.assetid: c05f113b-b789-4df0-a4ef-78bce4767021 > 'function' : function should return a value; 'void' return type assumed +## Remarks + The function has no return type specified. In this case, C4430 should also fire and the compiler implements the fix reported by C4430 (default value is int). To resolve this warning, explicitly declare the return type of functions. +## Example + The following sample generates C4508: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md index efe2b2d38a7..d559ac8bee9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md @@ -10,6 +10,8 @@ ms.assetid: 4ad21004-f076-43fd-99f4-4bf1f9be4c0b > 'specifier' : storage-class or type specifier(s) unexpected here; ignored +## Example + The following sample generates C4518: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md index f74a45801c8..efce6d5d002 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md @@ -10,4 +10,6 @@ ms.assetid: a01286b2-3dd9-4a97-a5ee-dd0e7b63ef8b > 'class' : copy constructor could not be generated +## Remarks + The compiler could not generate a default copy-constructor for a class; a base class may have a private copy-constructor. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md index 11df8f1e4da..a83f287042c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md @@ -10,6 +10,8 @@ ms.assetid: a07ae70c-db4e-472b-8b58-9137d9997323 > overflow; assigning *value* to bit-field that can only hold values from *low_value* to *high_value* +## Remarks + The assigned *value* is outside the range of values that the bit-field can hold. Signed bit-field types use the high-order bit for the sign, so if *n* is the bit-field size, the range for signed bit-fields is -2n-1 to 2n-1-1, while unsigned bit-fields have a range from 0 to 2n-1. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md index ca3587adeaf..a2e848963a9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4464"] > relative include path contains '..' -A `#include` directive has a path that includes a parent directory specifier (a `..` path segment). - ## Remarks +A `#include` directive has a path that includes a parent directory specifier (a `..` path segment). + In Visual Studio 2015 Update 1 and later versions, if enabled, the compiler can detect and issue a warning for a `#include` directive that contains a parent directory path segment (`..`). Code is sometimes written that uses parent directory relative paths to include headers from external libraries. When these parent directory-relative header paths are specified in source files, it creates a risk: The program could be compiled by including a different header file than the programmer intends. These relative paths may not be portable to other developers' build environments. Instead, we recommend you specify the paths to such headers in the build environment, such as in the `INCLUDE` environment variable or in parameters to the [`/I` (Additional include directories)](../../build/reference/i-additional-include-directories.md) compiler option. In the Visual Studio IDE, you can set the paths in your project's **Configuration Properties** > **C/C++** > **General** property page, in the **Additional Include Directories** property. Although there's no specific warning for it, we also don't recommend use of parent directory path segments when you specify your project's include directories. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md index 063b3fe045e..b3d28946c36 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md @@ -10,6 +10,8 @@ ms.assetid: ccfd8bd5-bc1b-4be7-a6ea-0e3a7add6607 > '*enumeration*': a forward declaration of an unscoped enumeration must have an underlying type (int assumed) +## Remarks + A forward declaration of an unscoped enumeration was found without a specifier for the underlying type. By default, Visual C++ assumes **`int`** is the underlying type for an enumeration. This can cause issues if a different type is used in the enumeration definition, for example, if a different explicit type is specified, or if a different type is implicitly set by an initializer. You may also have portability issues; other compilers do not assume **`int`** is the underlying type of an enumeration. This warning is off by default; you can use /Wall or /w*N*4471 to enable it on the command line, or use #pragma [warning](../../preprocessor/warning.md) in your source file. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md index f9a333b2467..d7db7904d7e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md @@ -10,6 +10,8 @@ ms.assetid: 7bfd4e0c-b452-4e6c-b7c4-ac5cc93fe4ea > nonstandard extension used: override specifier 'keyword' +## Remarks + A keyword was used that is not in the C++ standard, for example, one of the override specifiers that also works under /clr. For more information, see, - [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md index e44eac046e8..c0b9e99082a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md @@ -10,6 +10,8 @@ ms.assetid: 796144cf-cd3c-4edc-b6a4-96192b7eb4f0 > 'derived_class_function' : matches inherited non-virtual method 'base_class_function' but is not explicitly marked 'new' +## Remarks + A function in a derived class has the same signature as a non-virtual base class function. C4487 reminds you that the derived class function does not override the base class function. Explicitly mark the derived class function as **`new`** to resolve this warning. For more information, see [new (new slot in vtable)](../../extensions/new-new-slot-in-vtable-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md index 2fe46f92ce7..2c714f0a99c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md @@ -10,6 +10,8 @@ ms.assetid: 068716a0-7dd2-40af-abf4-478f893b48c5 > 'function' : unreferenced local function has been removed +## Remarks + The given function is local and not referenced in the body of the module; therefore, the function is dead code. The compiler did not generate code for this dead function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md index 7026350d29e..41cf8e5f6b3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md @@ -10,6 +10,8 @@ ms.assetid: fd28d1d4-ad27-4dad-94c0-9dba46c93180 > '*class*' : default constructor could not be generated +## Remarks + The compiler can't generate a default constructor for the specified class, which has no user-defined constructors. Objects of this type can't be created. There are several situations that prevent the compiler from generating a default constructor, including: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md index ea3a02f0772..80f08d96c1c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md @@ -10,6 +10,8 @@ ms.assetid: afb68995-684a-4be5-a73a-38d7a16dc030 > 'class' : assignment operator could not be generated +## Remarks + The compiler cannot generate an assignment operator for the given class. No assignment operator was created. An assignment operator for the base class that is not accessible by the derived class can cause this warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md index db7fe9c3c3b..7844ee79afe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md @@ -10,4 +10,6 @@ ms.assetid: 6877334a-f30a-4184-9483-dac3348737a4 > 'class' : destructor could not be generated +## Remarks + The compiler cannot generate a default destructor for the given class; no destructor was created. The destructor is in a base class that is not accessible to the derived class. If the base class has a private destructor, make it public or protected. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md index 4512701c913..d04ee68a366 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md @@ -10,10 +10,14 @@ ms.assetid: cdae966a-9cd4-4e31-af30-2a014e68f614 > 'function' : unreferenced inline function has been removed +## Remarks + The optimizer removed an inline function that is not called. 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 C4514: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md index e707f1c80c9..0caa6cbca83 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md @@ -10,8 +10,12 @@ ms.assetid: 167b5177-3f89-418b-b6c8-7de634f6b28f > 'namespace' : namespace uses itself +## Remarks + A namespace is used recursively. +## Example + The following sample generates C4515: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md index 7e9cb6af507..7c2d612d420 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md @@ -10,8 +10,12 @@ ms.assetid: 6677bb1f-d26e-4ab9-8644-6b5a2a8f4ff8 > 'class::symbol' : access-declarations are deprecated; member using-declarations provide a better alternative +## Remarks + The ANSI C++ committee has declared access declarations (changing the access of a member in a derived class without the [using](../../cpp/using-declaration.md) keyword) to be outdated. Access declarations may not be supported by future versions of C++. +## Example + The following sample generates C4516: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md index 5d5b1e51930..64979fc9a84 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md @@ -10,4 +10,6 @@ ms.assetid: 87cc12b8-7331-4f3a-a863-d6a75d9599c3 > access-declarations are deprecated; member using-declarations provide a better alternative +## Remarks + The ANSI C++ committee has declared access declarations (changing the access of a member in a derived class without the [using](../../cpp/using-declaration.md) keyword) to be outdated. Access declarations may not be supported by future versions of C++. From 8932e82bd02ea9d53c7a50818c832af8c6b71497 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 17:58:38 +0800 Subject: [PATCH 1030/1799] Replace term "sample" with "example" for warning references in range [C4461, C4520] --- docs/error-messages/compiler-warnings/c4477.md | 2 +- .../compiler-warnings/compiler-warning-c4484.md | 2 +- .../compiler-warnings/compiler-warning-c4485.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4461.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4462.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4470.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4486.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4488.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4489.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4490.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4503.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4508.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4518.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4481.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4487.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4512.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4514.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4515.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4516.md | 2 +- 19 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4477.md b/docs/error-messages/compiler-warnings/c4477.md index 69a6c4913fc..d2110879d1b 100644 --- a/docs/error-messages/compiler-warnings/c4477.md +++ b/docs/error-messages/compiler-warnings/c4477.md @@ -19,7 +19,7 @@ This warning is new in Visual Studio 2015. ## Example -This sample shows two C4477 warnings for the first printf_s function, when two arguments are found to be of the wrong type, and also shows how to fix the issues. +This example shows two C4477 warnings for the first printf_s function, when two arguments are found to be of the wrong type, and also shows how to fix the issues. ```cpp // C4477p.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md index 8ad8a517378..759ecc6783e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md @@ -26,7 +26,7 @@ C4484 is always issued as an error. Use the [warning](../../preprocessor/warning ## Example -The following sample generates C4484. +The following example generates C4484. ```cpp // C4484.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md index ebcba1b66ce..0aa6cf47a9e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md @@ -20,7 +20,7 @@ C4485 is always issued as an error. Use the [warning](../../preprocessor/warning ## Example -The following sample generates C4485 +The following example generates C4485 ```cpp // C4485.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md index 3db90c99f04..38f9cedb814 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md @@ -20,7 +20,7 @@ For more information, see [Destructors and finalizers](../../dotnet/how-to-defin ## Example -The following sample generates C4461. +The following example generates C4461. ```cpp // C4461.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md index 279e498aa80..3f4efd4cd2e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md @@ -22,7 +22,7 @@ This warning is automatically promoted to an error. If you wish to modify this b ## Example -This sample generates warning C4462: +This example generates warning C4462: ```cpp namespace N diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md index abbbab1ba4f..fed27f37f93 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md @@ -24,7 +24,7 @@ have no effect under [/clr](../../build/reference/clr-common-language-runtime-co ## Example -The following sample generates C4470: +The following example generates C4470: ```cpp // C4470.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md index 2f6f20aa84d..ffcdb18f020 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md @@ -16,7 +16,7 @@ Since a private virtual member function of a managed class or struct cannot be a ## Example -The following sample generates C4486. +The following example generates C4486. ```cpp // C4486.cpp @@ -28,7 +28,7 @@ private: }; ``` -The following sample shows one possible use of a private sealed, virtual function. +The following example shows one possible use of a private sealed, virtual function. ```cpp // C4486_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md index 17a99b1636a..37061109824 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md @@ -16,7 +16,7 @@ A class must implement all members of an interface from which it directly inheri ## Examples -C4488 can occur if an implemented member is not public. The following sample generates C4488. +C4488 can occur if an implemented member is not public. The following example generates C4488. ```cpp // C4488.cpp @@ -35,7 +35,7 @@ public: }; ``` -C4488 can occur if an implemented member is not marked virtual. The following sample generates C4488. +C4488 can occur if an implemented member is not marked virtual. The following example generates C4488. ```cpp // C4488_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md index 6b275b60d20..cdd7df9b79b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md @@ -18,7 +18,7 @@ For more information, see [Override Specifiers](../../extensions/override-specif ## Example -The following sample generates C4489. +The following example generates C4489. ```cpp // C4489.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md index d91fc17a2f7..f2c3fe54c63 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md @@ -18,7 +18,7 @@ For more information, see [Override Specifiers](../../extensions/override-specif ## Example -The following sample generates C4490. +The following example generates C4490. ```cpp // C4490.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md index 866586d4ea8..93f8f7c85d8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md @@ -22,7 +22,7 @@ You might, however, decide to not restructure your code. It is possible to ship ## Example -The following sample generates C4503 in compilers before Visual Studio 2017: +The following example generates C4503 in compilers before Visual Studio 2017: ```cpp // C4503.cpp @@ -40,7 +40,7 @@ typedef std::map Hello; Hello MyWAT; ``` -This sample shows one way to rewrite your code to resolve C4503: +This example shows one way to rewrite your code to resolve C4503: ```cpp // C4503b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md index 81121151257..ea380ced71e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md @@ -18,7 +18,7 @@ To resolve this warning, explicitly declare the return type of functions. ## Example -The following sample generates C4508: +The following example generates C4508: ```cpp // C4508.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md index d559ac8bee9..d213cbd1662 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md @@ -12,7 +12,7 @@ ms.assetid: 4ad21004-f076-43fd-99f4-4bf1f9be4c0b ## Example -The following sample generates C4518: +The following example generates C4518: ```cpp // C4518.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md index d7db7904d7e..614c242c71c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md @@ -20,7 +20,7 @@ A keyword was used that is not in the C++ standard, for example, one of the over ## Example -The following sample generates C4481. +The following example generates C4481. ```cpp // C4481.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md index c0b9e99082a..0a929f820a3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md @@ -18,7 +18,7 @@ For more information, see [new (new slot in vtable)](../../extensions/new-new-sl ## Example -The following sample generates C4487. +The following example generates C4487. ```cpp // C4487.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md index 80f08d96c1c..30cdb713180 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md @@ -30,7 +30,7 @@ You can resolve the C4512 warning for your code in one of three ways: ## Example -The following sample generates C4512. +The following example generates C4512. ```cpp // C4512.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md index d04ee68a366..a89c72d53be 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4514: +The following example generates C4514: ```cpp // C4514.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md index 0caa6cbca83..0330b8fd352 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md @@ -16,7 +16,7 @@ A namespace is used recursively. ## Example -The following sample generates C4515: +The following example generates C4515: ```cpp // C4515.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md index 7c2d612d420..070e908eac0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md @@ -16,7 +16,7 @@ The ANSI C++ committee has declared access declarations (changing the access of ## Example -The following sample generates C4516: +The following example generates C4516: ```cpp // C4516.cpp From 746d17ab42ee55643c5303dd471420e9525629ba Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 18:03:40 +0800 Subject: [PATCH 1031/1799] Update metadata for warning references in range [C4461, C4520] --- docs/error-messages/compiler-warnings/c4477.md | 4 ++-- .../compiler-warnings/compiler-warning-c4484.md | 5 ++--- .../compiler-warnings/compiler-warning-c4485.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4461.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4462.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4470.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4486.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4488.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4489.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4490.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4502.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4503.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4506.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4508.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4518.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4511.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4463.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4464.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4471.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4481.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4487.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4505.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4510.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4512.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4513.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4514.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4515.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4516.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4517.md | 5 ++--- 29 files changed, 57 insertions(+), 84 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4477.md b/docs/error-messages/compiler-warnings/c4477.md index d2110879d1b..e9d25f97453 100644 --- a/docs/error-messages/compiler-warnings/c4477.md +++ b/docs/error-messages/compiler-warnings/c4477.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4477" title: "Compiler Warning C4477" -ms.date: "02/16/2018" +description: "Learn more about: Compiler Warning (level 1) C4477" +ms.date: 02/16/2018 f1_keywords: ["C4477"] helpviewer_keywords: ["C4477"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md index 759ecc6783e..72034be28b7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4484" title: "Compiler Warning C4484" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4484" +ms.date: 11/04/2016 f1_keywords: ["C4484"] helpviewer_keywords: ["C4484"] -ms.assetid: 3d30e5b3-2297-45b7-a37a-1360056fdd0e --- # Compiler Warning C4484 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md index 0aa6cf47a9e..6711406f3e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4485" title: "Compiler Warning C4485" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4485" +ms.date: 11/04/2016 f1_keywords: ["C4485"] helpviewer_keywords: ["C4485"] -ms.assetid: a6f2b437-ca93-4dcd-b9cb-df415e10df86 --- # Compiler Warning C4485 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md index 38f9cedb814..62fa36aa89a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4461" title: "Compiler Warning (level 1) C4461" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4461" +ms.date: 11/04/2016 f1_keywords: ["C4461"] helpviewer_keywords: ["C4461"] -ms.assetid: 104ffecc-3dd4-4cb1-89a8-81154fbe46d9 --- # Compiler Warning (level 1) C4461 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md index 3f4efd4cd2e..ce4fe63e11b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4462" title: "Compiler Warning (level 1) C4462" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning (level 1) C4462" +ms.date: 10/25/2017 f1_keywords: ["C4462"] helpviewer_keywords: ["C4462"] -ms.assetid: 4e20aca4-293e-4c75-a83d-961c27ab7840 --- # Compiler Warning (level 1) C4462 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md index fed27f37f93..8cc35e1f593 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4470" title: "Compiler Warning (level 1) C4470" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4470" +ms.date: 11/04/2016 f1_keywords: ["C4470"] helpviewer_keywords: ["C4470"] -ms.assetid: f52a3eaa-a235-4747-a47d-9ec4ad4cb0ea --- # Compiler Warning (level 1) C4470 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md index ffcdb18f020..0d0fc68d539 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4486" title: "Compiler Warning (level 1) C4486" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4486" +ms.date: 11/04/2016 f1_keywords: ["C4486"] helpviewer_keywords: ["C4486"] -ms.assetid: 2c0c59e3-d025-4d97-8da2-fa27df1402fc --- # Compiler Warning (level 1) C4486 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md index 37061109824..972d534a5a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4488" title: "Compiler Warning (level 1) C4488" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4488" +ms.date: 11/04/2016 f1_keywords: ["C4488"] helpviewer_keywords: ["C4488"] -ms.assetid: 55625e46-ddb5-4c7c-99c7-cd4aa9f879bd --- # Compiler Warning (level 1) C4488 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md index cdd7df9b79b..a5709ed8687 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4489" title: "Compiler Warning (level 1) C4489" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4489" +ms.date: 11/04/2016 f1_keywords: ["C4489"] helpviewer_keywords: ["C4489"] -ms.assetid: 43b51c8c-27b5-44c9-b974-fe4b48f4896f --- # Compiler Warning (level 1) C4489 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md index f2c3fe54c63..cf731a936b9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4490" title: "Compiler Warning (level 1) C4490" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4490" +ms.date: 11/04/2016 f1_keywords: ["C4490"] helpviewer_keywords: ["C4490"] -ms.assetid: f9b03ecf-41a1-4f4d-a74c-2c1e88234ccc --- # Compiler Warning (level 1) C4490 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md index 273b48e6ebb..febc9be3e3b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4502" title: "Compiler Warning (level 1) C4502" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4502" +ms.date: 11/04/2016 f1_keywords: ["C4502"] helpviewer_keywords: ["C4502"] -ms.assetid: d8d43153-a40c-4b96-bc11-64028a144d70 --- # Compiler Warning (level 1) C4502 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md index 93f8f7c85d8..bd1f2733869 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4503" title: "Compiler Warning (level 1) C4503" -ms.date: "05/14/2018" +description: "Learn more about: Compiler Warning (level 1) C4503" +ms.date: 05/14/2018 f1_keywords: ["C4503"] helpviewer_keywords: ["C4503"] -ms.assetid: 7c5a98ae-5b6d-41d8-b881-12d3ffd5e392 --- # Compiler Warning (level 1) C4503 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md index d829b87e503..d2960d7acf3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4506" title: "Compiler Warning (level 1) C4506" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4506" +ms.date: 11/04/2016 f1_keywords: ["C4506"] helpviewer_keywords: ["C4506"] -ms.assetid: aa682869-65d1-4dad-ba32-198f10b44f91 --- # Compiler Warning (level 1) C4506 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md index ea380ced71e..34c87bb27a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4508" title: "Compiler Warning (level 1) C4508" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4508" +ms.date: 11/04/2016 f1_keywords: ["C4508"] helpviewer_keywords: ["C4508"] -ms.assetid: c05f113b-b789-4df0-a4ef-78bce4767021 --- # Compiler Warning (level 1) C4508 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md index d213cbd1662..d63e8b14aaf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4518" title: "Compiler Warning (level 1) C4518" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4518" +ms.date: 11/04/2016 f1_keywords: ["C4518"] helpviewer_keywords: ["C4518"] -ms.assetid: 4ad21004-f076-43fd-99f4-4bf1f9be4c0b --- # Compiler Warning (level 1) C4518 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md index efce6d5d002..609b70accec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4511" title: "Compiler Warning (level 3) C4511" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4511" +ms.date: 11/04/2016 f1_keywords: ["C4511"] helpviewer_keywords: ["C4511"] -ms.assetid: a01286b2-3dd9-4a97-a5ee-dd0e7b63ef8b --- # Compiler Warning (level 3) C4511 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md index a83f287042c..ea4619ef50c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4463" title: "Compiler Warning (level 4) C4463" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4463" +ms.date: 11/04/2016 f1_keywords: ["C4463"] helpviewer_keywords: ["C4463"] -ms.assetid: a07ae70c-db4e-472b-8b58-9137d9997323 --- # Compiler Warning (level 4) C4463 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md index a2e848963a9..ed8362ff037 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4464" title: "Compiler Warning (level 4) C4464" +description: "Learn more about: Compiler Warning (level 4, off) C4464" ms.date: 09/14/2022 f1_keywords: ["C4464"] helpviewer_keywords: ["C4464"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md index b3d28946c36..fdba3fbfe5b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4471" title: "Compiler Warning (level 4) C4471" -ms.date: "04/24/2017" +description: "Learn more about: Compiler Warning (level 4) C4471" +ms.date: 04/24/2017 f1_keywords: ["C4471"] helpviewer_keywords: ["C4471"] -ms.assetid: ccfd8bd5-bc1b-4be7-a6ea-0e3a7add6607 --- # Compiler Warning (level 4) C4471 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md index 614c242c71c..adcda6aff5f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4481" title: "Compiler Warning (level 4) C4481" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4481" +ms.date: 11/04/2016 f1_keywords: ["C4481"] helpviewer_keywords: ["C4481"] -ms.assetid: 7bfd4e0c-b452-4e6c-b7c4-ac5cc93fe4ea --- # Compiler Warning (level 4) C4481 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md index 0a929f820a3..d51cec97ca6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4487" title: "Compiler Warning (level 4) C4487" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4487" +ms.date: 11/04/2016 f1_keywords: ["C4487"] helpviewer_keywords: ["C4487"] -ms.assetid: 796144cf-cd3c-4edc-b6a4-96192b7eb4f0 --- # Compiler Warning (level 4) C4487 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md index 2c714f0a99c..9c7d9989148 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4505" title: "Compiler Warning (level 4) C4505" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4505" +ms.date: 11/04/2016 f1_keywords: ["C4505"] helpviewer_keywords: ["C4505"] -ms.assetid: 068716a0-7dd2-40af-abf4-478f893b48c5 --- # Compiler Warning (level 4) C4505 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md index 41cf8e5f6b3..3ed173e3f0a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md @@ -1,10 +1,9 @@ --- title: "Compiler Warning (level 4) C4510" -description: Compiler warning C4510 description and solution. -ms.date: "09/22/2019" +description: "Compiler warning C4510 description and solution." +ms.date: 09/22/2019 f1_keywords: ["C4510"] helpviewer_keywords: ["C4510"] -ms.assetid: fd28d1d4-ad27-4dad-94c0-9dba46c93180 --- # Compiler Warning (level 4) C4510 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md index 30cdb713180..ab781a65058 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4512" title: "Compiler Warning (level 4) C4512" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4512" +ms.date: 11/04/2016 f1_keywords: ["C4512"] helpviewer_keywords: ["C4512"] -ms.assetid: afb68995-684a-4be5-a73a-38d7a16dc030 --- # Compiler Warning (level 4) C4512 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md index 7844ee79afe..9261d6c13dd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4513" title: "Compiler Warning (level 4) C4513" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4513" +ms.date: 11/04/2016 f1_keywords: ["C4513"] helpviewer_keywords: ["C4513"] -ms.assetid: 6877334a-f30a-4184-9483-dac3348737a4 --- # Compiler Warning (level 4) C4513 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md index a89c72d53be..f0098802be9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4514" title: "Compiler Warning (level 4) C4514" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4514" +ms.date: 11/04/2016 f1_keywords: ["C4514"] helpviewer_keywords: ["C4514"] -ms.assetid: cdae966a-9cd4-4e31-af30-2a014e68f614 --- # Compiler Warning (level 4) C4514 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md index 0330b8fd352..b6633afa237 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4515" title: "Compiler Warning (level 4) C4515" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4515" +ms.date: 11/04/2016 f1_keywords: ["C4515"] helpviewer_keywords: ["C4515"] -ms.assetid: 167b5177-3f89-418b-b6c8-7de634f6b28f --- # Compiler Warning (level 4) C4515 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md index 070e908eac0..0ac56deda3b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4516" title: "Compiler Warning (level 4) C4516" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4516" +ms.date: 11/04/2016 f1_keywords: ["C4516"] helpviewer_keywords: ["C4516"] -ms.assetid: 6677bb1f-d26e-4ab9-8644-6b5a2a8f4ff8 --- # Compiler Warning (level 4) C4516 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md index 64979fc9a84..b64a35c0020 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4517" title: "Compiler Warning (level 4) C4517" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4517" +ms.date: 11/04/2016 f1_keywords: ["C4517"] helpviewer_keywords: ["C4517"] -ms.assetid: 87cc12b8-7331-4f3a-a863-d6a75d9599c3 --- # Compiler Warning (level 4) C4517 From 5c4d5dad1d29378a9050915fa394cc00754024bd Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 21:30:15 +0800 Subject: [PATCH 1032/1799] Fix wrong `-fsanitizer=address` flag in "Walkthrough: Use Address Sanitizer Continue On Error to find memory safety issues" --- docs/sanitizers/asan-continue-on-error.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-continue-on-error.md b/docs/sanitizers/asan-continue-on-error.md index 9d820f863e8..9c322d9b189 100644 --- a/docs/sanitizers/asan-continue-on-error.md +++ b/docs/sanitizers/asan-continue-on-error.md @@ -12,7 +12,7 @@ In this walkthrough, create checked builds that find and report memory safety er Memory safety errors like out-of-bounds memory reads and writes, using memory after it has been freed, `NULL` pointer dereferences, and so on, are a top concern for C/C++ code. Address Sanitizer (ASAN) is a compiler and runtime technology that exposes these kinds of hard-to-find bugs, and does it with zero false positives. For an overview of ASAN, see [AddressSanitizer](asan.md). -Continue On Error (COE) is a new ASAN feature that automatically diagnoses and reports memory safety errors as your app runs. When your program exits, a summary of unique memory safety errors is output to `stdout`, `stderr`, or to a log file of your choice. When you create a standard C++ checked build with `-fsanitizer=address`, calls to allocators, deallocators such as `free`, `memcpy`, `memset`, and so on, are forwarded to the ASAN runtime. The ASAN runtime provides the same semantics for these functions, but monitors what happens with the memory. ASAN diagnoses and reports hidden memory safety errors, with zero false positives, as your app runs. +Continue On Error (COE) is a new ASAN feature that automatically diagnoses and reports memory safety errors as your app runs. When your program exits, a summary of unique memory safety errors is output to `stdout`, `stderr`, or to a log file of your choice. When you create a standard C++ checked build with `-fsanitize=address`, calls to allocators, deallocators such as `free`, `memcpy`, `memset`, and so on, are forwarded to the ASAN runtime. The ASAN runtime provides the same semantics for these functions, but monitors what happens with the memory. ASAN diagnoses and reports hidden memory safety errors, with zero false positives, as your app runs. A significant advantage of COE is that, unlike the previous ASAN behavior, your program doesn't stop running when the first memory error is found. Instead, ASAN notes the error, and your app continues to run. After your app exits, a summary of all the memory issues is output. From 960182794e5bd836a313d613c2c11978a773d944 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 21:35:41 +0800 Subject: [PATCH 1033/1799] Remove trailing spaces for examples in "Walkthrough: Use Address Sanitizer Continue On Error to find memory safety issues" --- docs/sanitizers/asan-continue-on-error.md | 36 +++++++++++------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/sanitizers/asan-continue-on-error.md b/docs/sanitizers/asan-continue-on-error.md index 9c322d9b189..fe0ac9d406b 100644 --- a/docs/sanitizers/asan-continue-on-error.md +++ b/docs/sanitizers/asan-continue-on-error.md @@ -44,21 +44,21 @@ Create the example: ```cpp #include #include - + void BadFunction(int *pointer) { free(pointer); free(pointer); // double-free! } - + int main(int argc, const char *argv[]) { int *pointer = static_cast(malloc(4)); BadFunction(pointer); - + // Normally we'd crash before this, but with COE we can see heap-use-after-free error as well printf("\n\n******* Pointer value: %d\n", *pointer); - + return 1; } ``` @@ -181,24 +181,24 @@ Create the example: 1. In that directory, create a source file, for example, `coe.cpp`, and paste the following code: ```cpp - #include - + #include + char* func(char* buf, size_t sz) - { - char* local = (char*)malloc(sz); - for (auto ii = 0; ii <= sz; ii++) // bad loop exit test + { + char* local = (char*)malloc(sz); + for (auto ii = 0; ii <= sz; ii++) // bad loop exit test { - local[ii] = ~buf[ii]; // Two memory safety errors + local[ii] = ~buf[ii]; // Two memory safety errors } - - return local; - } - - char buffer[10] = {0,1,2,3,4,5,6,7,8,9}; - + + return local; + } + + char buffer[10] = {0,1,2,3,4,5,6,7,8,9}; + int main() - { - char* inverted_buf= func(buffer, 10); + { + char* inverted_buf= func(buffer, 10); } ``` From 8f9c7346c493eaaf37134214b59b83061ae0c19c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 22:11:37 +0800 Subject: [PATCH 1034/1799] Fix a few typos in "Regular expressions (C++)" --- docs/standard-library/regular-expressions-cpp.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/regular-expressions-cpp.md b/docs/standard-library/regular-expressions-cpp.md index 8b4505025ce..cdbebab579e 100644 --- a/docs/standard-library/regular-expressions-cpp.md +++ b/docs/standard-library/regular-expressions-cpp.md @@ -12,7 +12,7 @@ The C++ standard library supports multiple regular expression grammars. This top ## Regular expression grammar -The regular expression grammar to use is by specified by the use of one of the `std::regex_constants::syntax_option_type` enumeration values. These regular expression grammars are defined in `std::regex_constants`: +The regular expression grammar to use is specified by the use of one of the `std::regex_constants::syntax_option_type` enumeration values. These regular expression grammars are defined in `std::regex_constants`: - ECMAScript: This is closest to the grammar used by JavaScript and the .NET languages. - basic: The POSIX basic regular expressions or BRE. @@ -56,7 +56,7 @@ An element can be one of the following: - An *anchor*. Anchor `^` matches the beginning of the target sequence. Anchor `$` matches the end of the target sequence. -A *capture group* of the form (*subexpression*), or \\(*subexpression*\\) in basic and grep, which matches the sequence of characters in the target sequence that is matched by the pattern between the delimiters. +- A *capture group* of the form (*subexpression*), or \\(*subexpression*\\) in basic and grep, which matches the sequence of characters in the target sequence that is matched by the pattern between the delimiters. - An *identity escape* of the form `\k`, which matches the character `k` in the target sequence. @@ -92,7 +92,7 @@ In ECMAScript, an element can also be one of the following: - A *control escape sequence* of the form `\ck`. Matches the control character that is named by the character `k`. -- A *word boundary assert* of the form`\b`. Matches when the current position in the target sequence is immediately after a *word boundary*. +- A *word boundary assert* of the form `\b`. Matches when the current position in the target sequence is immediately after a *word boundary*. - A *negative word boundary assert* of the form `\B`. Matches when the current position in the target sequence isn't immediately after a *word boundary*. From abdc8a3f88324830973ccaf547a3d1fa1230cbbb Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 22:12:19 +0800 Subject: [PATCH 1035/1799] Move `title` metadata above `description` in "Regular expressions (C++)" --- docs/standard-library/regular-expressions-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/regular-expressions-cpp.md b/docs/standard-library/regular-expressions-cpp.md index cdbebab579e..4704305fde6 100644 --- a/docs/standard-library/regular-expressions-cpp.md +++ b/docs/standard-library/regular-expressions-cpp.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Regular Expressions (C++)" title: "Regular Expressions (C++)" +description: "Learn more about: Regular Expressions (C++)" ms.date: 07/15/2021 helpviewer_keywords: ["regular expressions [C++]"] no-loc: [ECMAScript, basic, extended, awk, grep, egrep] From 8ccf0ccccc46835bcbf5e9978c136925f49f8cbe Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 22:21:40 +0800 Subject: [PATCH 1036/1799] Add blockquotes for warning messages in range [C4521, C4560] --- .../compiler-warnings/compiler-warning-level-1-c4526.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4540.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4544.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4545.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4546.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4547.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4548.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4549.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4550.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4551.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4552.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4553.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4555.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4558.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4521.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4522.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4523.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4534.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4535.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4538.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4543.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4554.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4557.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4536.md | 2 +- 24 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md index f3b0427593c..5db1a40fb4a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md @@ -8,7 +8,7 @@ ms.assetid: 490f8916-5fdc-4cad-b412-76c3382a5976 --- # Compiler Warning (level 1) C4526 -'function' : static member function cannot override virtual function 'virtual function'override ignored, virtual function will be hidden +> 'function' : static member function cannot override virtual function 'virtual function'override ignored, virtual function will be hidden The static member function meets the criteria to override the virtual function, which makes the member function both virtual and static. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md index cdbd4967530..36c84c4c7e1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md @@ -8,7 +8,7 @@ ms.assetid: 8085e748-5f4d-43c2-b06d-eaf794edbf72 --- # Compiler Warning (level 1) C4540 -dynamic_cast used to convert to inaccessible or ambiguous base; run-time test will fail ('type1' to 'type2') +> dynamic_cast used to convert to inaccessible or ambiguous base; run-time test will fail ('type1' to 'type2') You used **`dynamic_cast`** to convert from one type to another. The compiler determined that the cast would always fail (return **NULL**) because a base class is inaccessible (**`private`**, for instance) or ambiguous (appears more than once in the class hierarchy, for instance). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md index 8d72e0375aa..94502d0ab0f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md @@ -8,7 +8,7 @@ ms.assetid: 11ee04df-41ae-435f-af44-881e801315a8 --- # Compiler Warning (level 1) C4544 -'declaration': Default template argument ignored on this template declaration +> 'declaration': Default template argument ignored on this template declaration A default template argument was specified in an incorrect location and was ignored. A default template argument for a class template can only be specified in the declaration or definition of the class template and not on a member of the class template. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md index 747aeba94f2..ea9e2f0e7b4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md @@ -8,7 +8,7 @@ ms.assetid: 43f8f34f-ed46-4661-95c0-c588c577ff73 --- # Compiler Warning (level 1) C4545 -expression before comma evaluates to a function which is missing an argument list +> expression before comma evaluates to a function which is missing an argument list The compiler detected an ill-formed comma expression. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md index e79fac645f6..59183efd3b2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md @@ -8,7 +8,7 @@ ms.assetid: 071e1709-3841-46c1-8e71-96109cd22041 --- # Compiler Warning (level 1) C4546 -function call before comma missing argument list +> function call before comma missing argument list The compiler detected an ill-formed comma expression. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md index 8f29a08438b..d36613a1880 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md @@ -8,7 +8,7 @@ ms.assetid: 3edf1c2e-c0d5-444d-ae83-44a7cce24bb2 --- # Compiler Warning (level 1) C4547 -'operator' : operator before comma has no effect; expected operator with side-effect +> 'operator' : operator before comma has no effect; expected operator with side-effect The compiler detected an ill-formed comma expression. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md index c5ca0459485..8ded9143006 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md @@ -8,7 +8,7 @@ ms.assetid: 2cee817e-e463-4d90-bbd2-de120d48c101 --- # Compiler Warning (level 1) C4548 -expression before comma has no effect; expected expression with side-effect +> expression before comma has no effect; expected expression with side-effect The compiler detected an ill-formed comma expression. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md index fd330c52a08..fc8bb961710 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md @@ -8,7 +8,7 @@ ms.assetid: 81a07676-625b-4f58-9b0c-3ee22830b04a --- # Compiler Warning (level 1) C4549 -'operator' : operator before comma has no effect; did you intend 'operator'? +> 'operator' : operator before comma has no effect; did you intend 'operator'? The compiler detected an ill-formed comma expression. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md index 11dd28ec1b2..becf3959641 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md @@ -8,7 +8,7 @@ ms.assetid: f902b4ed-5f17-48ea-b693-92f4fb8c8054 --- # Compiler Warning (level 1) C4550 -expression evaluates to a function which is missing an argument list +> expression evaluates to a function which is missing an argument list A dereferenced pointer to a function is missing an argument list. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md index 2ac75c88a32..5f67c2314f5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md @@ -8,7 +8,7 @@ ms.assetid: 458b59bd-e2d7-425f-9ba6-268ff200424f --- # Compiler Warning (level 1) C4551 -function call missing argument list +> function call missing argument list A function call must include the open and close parentheses after the function name even if the function takes no parameters. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md index a48817856db..bd29fb2290a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md @@ -8,7 +8,7 @@ ms.assetid: ebbbb5ee-1c19-45bd-b386-41a19630fc76 --- # Compiler Warning (level 1) C4552 -'operator' : operator has no effect; expected operator with side-effect +> 'operator' : operator has no effect; expected operator with side-effect If an expression statement has an operator with no side effect as the top of the expression, it's probably a mistake. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md index d8ded153113..c82bc0cd99a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md @@ -8,7 +8,7 @@ ms.assetid: d8aacbe0-3cb5-4367-a6e5-fd7e28f0ff9d --- # Compiler Warning (level 1) C4553 -'operator' : operator has no effect; did you intend 'operator'? +> 'operator' : operator has no effect; did you intend 'operator'? If an expression statement has an operator with no side effect as the top of the expression, it's probably a mistake. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md index f00425ae350..d7282ca22ea 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md @@ -8,7 +8,7 @@ ms.assetid: 50b286c1-f7bf-4292-b1fa-baaac9538611 --- # Compiler Warning (level 1) C4555 -expression has no effect; expected expression with side-effect +> expression has no effect; expected expression with side-effect This warning informs you when an expression has no effect. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md index 33ca5b15716..611984f103b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md @@ -8,7 +8,7 @@ ms.assetid: 52bb0324-7bec-468c-b35b-13a08d38e578 --- # Compiler Warning (level 1) C4558 -value of operand 'value' is out of range 'lowerbound - upperbound' +> value of operand 'value' is out of range 'lowerbound - upperbound' The value passed to an assembly language instruction is out of the range specified for the parameter. The value will be truncated. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md index fc0524f6646..dad7a954ae3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md @@ -8,7 +8,7 @@ ms.assetid: 057d770c-ebcf-44cd-b943-1b1bb1ceaa8c --- # Compiler Warning (level 3) C4521 -'class' : multiple copy constructors specified +> 'class' : multiple copy constructors specified The class has multiple copy constructors of a single type. This warning is informational; the constructors are callable in your program. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md index 3930d4347d2..608d3ed3cc6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md @@ -8,7 +8,7 @@ ms.assetid: 7065dc27-0b6c-4e68-a345-c51cdb99a20b --- # Compiler Warning (level 3) C4522 -'class' : multiple assignment operators specified +> 'class' : multiple assignment operators specified The class has multiple assignment operators of a single type. This warning is informational; the constructors are callable in your program. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md index 1054bb6008c..95220d4dde5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md @@ -8,6 +8,6 @@ ms.assetid: 0f28761d-999f-43fe-9481-d02afd9b4f60 --- # Compiler Warning (level 3) C4523 -'class' : multiple destructors specified +> 'class' : multiple destructors specified The class has multiple destructors. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md index 9e5841e73a5..8067a30e099 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4534"] --- # Compiler Warning (level 3) C4534 -'constructor' will not be a default constructor for class 'class' due to the default argument +> 'constructor' will not be a default constructor for class 'class' due to the default argument An unmanaged class can have a constructor with parameters that have default values and the compiler will use this as the default constructor. A class marked with the `value` keyword will not use a constructor with default values for its parameters as a default constructor. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md index 254257c0bab..50de9792810 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md @@ -8,7 +8,7 @@ ms.assetid: 2c5ad1aa-2558-41d1-8f06-47fef74c8d9b --- # Compiler Warning (level 3) C4535 -calling _set_se_translator() requires /EHa +> calling _set_se_translator() requires /EHa The use of [_set_se_translator](../../c-runtime-library/reference/set-se-translator.md) requires the [/EHa](../../build/reference/eh-exception-handling-model.md) compiler option and not **/EHs**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md index 255ed1ba17c..cd0b432e554 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md @@ -8,7 +8,7 @@ ms.assetid: 747e3d51-b6d0-41c1-a726-7af3253b59d7 --- # Compiler Warning (level 3) C4538 -'type' : const/volatile qualifiers on this type are not supported +> 'type' : const/volatile qualifiers on this type are not supported A qualifier keyword was applied to an array incorrectly. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md index 56157264165..1b5b6fc5f0e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md @@ -8,7 +8,7 @@ ms.assetid: a09b39a7-d3b8-435c-86a3-2233c512f24b --- # Compiler Warning (level 3) C4543 -Injected text suppressed by attribute 'no_injected_text' +> Injected text suppressed by attribute 'no_injected_text' The [no_injected_text](../../windows/attributes/no-injected-text.md) attribute appeared in source code, which means the compiler will prevent attributes from injecting code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md index 47742011a04..0467351aa82 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md @@ -8,7 +8,7 @@ ms.assetid: 55bb68f0-2e80-4330-8921-51083c4f8d53 --- # Compiler Warning (level 3) C4554 -'operator' : check operator precedence for possible error; use parentheses to clarify precedence +> 'operator' : check operator precedence for possible error; use parentheses to clarify precedence The following sample generates C4554: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md index 45a74eb0f47..72de17e6164 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md @@ -8,7 +8,7 @@ ms.assetid: 7d9db716-03b2-4ee5-9b09-ba8aa5aa7e4c --- # Compiler Warning (level 3) C4557 -'__assume' contains effect 'effect' +> '__assume' contains effect 'effect' The value passed to an [__assume](../../intrinsics/assume.md) statement2 was modified. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md index 68bd5482f94..5eedcd1252a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md @@ -8,7 +8,7 @@ ms.assetid: ab4d0686-f813-4e88-a264-b40d3630ed6c --- # Compiler Warning (level 4) C4536 -'type name' : type-name exceeds meta-data limit of 'limit' characters +> 'type name' : type-name exceeds meta-data limit of 'limit' characters A type name would be truncated in metadata if it was a managed type. See [C3180](../../error-messages/compiler-errors-2/compiler-error-c3180.md) for more information. From 4057a7b674d0ddeb2c62c1ece8fca3d2a3dd3b40 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 22:28:31 +0800 Subject: [PATCH 1037/1799] Add "Remarks" and "Example" headings for warning references in range [C4521, C4560] --- .../compiler-warnings/compiler-warning-level-1-c4526.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4530.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4540.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4544.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4545.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4546.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4547.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4548.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4549.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4550.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4551.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4552.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4553.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4555.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4558.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4521.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4522.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4523.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4534.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4535.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4538.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4543.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4554.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4557.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4536.md | 2 ++ 25 files changed, 80 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md index 5db1a40fb4a..64c4b01310e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md @@ -10,8 +10,12 @@ ms.assetid: 490f8916-5fdc-4cad-b412-76c3382a5976 > 'function' : static member function cannot override virtual function 'virtual function'override ignored, virtual function will be hidden +## Remarks + The static member function meets the criteria to override the virtual function, which makes the member function both virtual and static. +## Example + The following code generates C4526: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md index 0575689ff83..c55730c0fdc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md @@ -10,10 +10,10 @@ ms.assetid: a04dcdb2-84db-459d-9e5e-4e743887465f > C++ exception handler used, but unwind semantics are not enabled. Specify /EHsc -The code uses C++ exception handling, but [/EHsc](../../build/reference/eh-exception-handling-model.md) wasn't included in the compiler options. - ## Remarks +The code uses C++ exception handling, but [/EHsc](../../build/reference/eh-exception-handling-model.md) wasn't included in the compiler options. + The compiler requires the **`/EHsc`** option to build C++ code that follows the C++ standard for exception handling. Standard C++ *unwind semantics* specifies that objects and stack frames constructed between where an exception is thrown and where it's caught must be destroyed and their resources recovered. This process is known as *unwinding the stack*. The **`/EHsc`** option tells the compiler to generate code that calls the destructors on automatic storage objects when an exception passes through the containing stack frame. *Automatic storage* objects are objects allocated on the stack, such as local variables. It's called automatic storage because it's allocated automatically when functions are called, and released automatically when they return. A *stack frame* is the data placed on the stack when a function is called, along with its automatic storage. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md index 36c84c4c7e1..c86925a81a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md @@ -10,8 +10,12 @@ ms.assetid: 8085e748-5f4d-43c2-b06d-eaf794edbf72 > dynamic_cast used to convert to inaccessible or ambiguous base; run-time test will fail ('type1' to 'type2') +## Remarks + You used **`dynamic_cast`** to convert from one type to another. The compiler determined that the cast would always fail (return **NULL**) because a base class is inaccessible (**`private`**, for instance) or ambiguous (appears more than once in the class hierarchy, for instance). +## Example + The following shows an example of this warning. Class **B** is derived from class **A**. The program uses **`dynamic_cast`** to cast from class **B** (the derived class) to class **A**, which will always fail because class **B** is **`private`** and thus inaccessible. Changing the access of **A** to **`public`** will resolve the warning. ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md index 94502d0ab0f..15fd2a8eac8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md @@ -10,8 +10,12 @@ ms.assetid: 11ee04df-41ae-435f-af44-881e801315a8 > 'declaration': Default template argument ignored on this template declaration +## Remarks + A default template argument was specified in an incorrect location and was ignored. A default template argument for a class template can only be specified in the declaration or definition of the class template and not on a member of the class template. +## Example + This sample generates C4545, and the next sample shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md index ea9e2f0e7b4..3dd1227362b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md @@ -10,10 +10,14 @@ ms.assetid: 43f8f34f-ed46-4661-95c0-c588c577ff73 > expression before comma evaluates to a function which is missing an argument list +## Remarks + The compiler detected an ill-formed comma expression. 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 + The following sample generates C4545: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md index 59183efd3b2..4deead90523 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md @@ -10,6 +10,8 @@ ms.assetid: 071e1709-3841-46c1-8e71-96109cd22041 > function call before comma missing argument list +## Remarks + The compiler detected an ill-formed comma expression. 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). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md index d36613a1880..4bf6d9b4320 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md @@ -10,10 +10,14 @@ ms.assetid: 3edf1c2e-c0d5-444d-ae83-44a7cce24bb2 > 'operator' : operator before comma has no effect; expected operator with side-effect +## Remarks + The compiler detected an ill-formed comma expression. 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 + The following sample generates C4547: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md index 8ded9143006..1cb99ffd6c7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md @@ -10,10 +10,14 @@ ms.assetid: 2cee817e-e463-4d90-bbd2-de120d48c101 > expression before comma has no effect; expected expression with side-effect +## Remarks + The compiler detected an ill-formed comma expression. 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 + The following sample generates C4548: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md index fc8bb961710..b56a512b9e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md @@ -10,10 +10,14 @@ ms.assetid: 81a07676-625b-4f58-9b0c-3ee22830b04a > 'operator' : operator before comma has no effect; did you intend 'operator'? +## Remarks + The compiler detected an ill-formed comma expression. 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 + The following sample generates C4549: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md index becf3959641..8792d6253f8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md @@ -10,6 +10,8 @@ ms.assetid: f902b4ed-5f17-48ea-b693-92f4fb8c8054 > expression evaluates to a function which is missing an argument list +## Remarks + A dereferenced pointer to a function is missing an argument list. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md index 5f67c2314f5..4ff6fa1c7c1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md @@ -10,8 +10,12 @@ ms.assetid: 458b59bd-e2d7-425f-9ba6-268ff200424f > function call missing argument list +## Remarks + A function call must include the open and close parentheses after the function name even if the function takes no parameters. +## Example + The following sample generates C4551: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md index bd29fb2290a..39ef2a220ef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md @@ -10,10 +10,14 @@ ms.assetid: ebbbb5ee-1c19-45bd-b386-41a19630fc76 > 'operator' : operator has no effect; expected operator with side-effect +## Remarks + If an expression statement has an operator with no side effect as the top of the expression, it's probably a mistake. To override this warning, put the expression in parentheses. +## Example + The following sample generates C4552: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md index c82bc0cd99a..3dc75cc8aa7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md @@ -10,8 +10,12 @@ ms.assetid: d8aacbe0-3cb5-4367-a6e5-fd7e28f0ff9d > 'operator' : operator has no effect; did you intend 'operator'? +## Remarks + If an expression statement has an operator with no side effect as the top of the expression, it's probably a mistake. +## Example + The following sample generates C4553: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md index d7282ca22ea..0d0764247be 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md @@ -10,10 +10,14 @@ ms.assetid: 50b286c1-f7bf-4292-b1fa-baaac9538611 > expression has no effect; expected expression with side-effect +## Remarks + This warning informs you when an expression has no effect. 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 + For example: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md index 611984f103b..59f90cb7917 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md @@ -10,8 +10,12 @@ ms.assetid: 52bb0324-7bec-468c-b35b-13a08d38e578 > value of operand 'value' is out of range 'lowerbound - upperbound' +## Remarks + The value passed to an assembly language instruction is out of the range specified for the parameter. The value will be truncated. +## Example + The following sample generates C4558: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md index dad7a954ae3..0d67d7caa89 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md @@ -10,6 +10,8 @@ ms.assetid: 057d770c-ebcf-44cd-b943-1b1bb1ceaa8c > 'class' : multiple copy constructors specified +## Remarks + The class has multiple copy constructors of a single type. This warning is informational; the constructors are callable in your program. Use the [warning](../../preprocessor/warning.md) pragma to suppress this warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md index 608d3ed3cc6..a255d4f7ce0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md @@ -10,6 +10,8 @@ ms.assetid: 7065dc27-0b6c-4e68-a345-c51cdb99a20b > 'class' : multiple assignment operators specified +## Remarks + The class has multiple assignment operators of a single type. This warning is informational; the constructors are callable in your program. Use the [warning](../../preprocessor/warning.md) pragma to suppress this warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md index 95220d4dde5..e0772f83245 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md @@ -10,4 +10,6 @@ ms.assetid: 0f28761d-999f-43fe-9481-d02afd9b4f60 > 'class' : multiple destructors specified +## Remarks + The class has multiple destructors. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md index 8067a30e099..217022d92f8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4534"] > 'constructor' will not be a default constructor for class 'class' due to the default argument +## Remarks + An unmanaged class can have a constructor with parameters that have default values and the compiler will use this as the default constructor. A class marked with the `value` keyword will not use a constructor with default values for its parameters as a default constructor. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). +## Example + The following sample generates C4534: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md index 50de9792810..04d4926f808 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md @@ -10,6 +10,8 @@ ms.assetid: 2c5ad1aa-2558-41d1-8f06-47fef74c8d9b > calling _set_se_translator() requires /EHa +## Remarks + The use of [_set_se_translator](../../c-runtime-library/reference/set-se-translator.md) requires the [/EHa](../../build/reference/eh-exception-handling-model.md) compiler option and not **/EHs**. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md index cd0b432e554..463d0b9d6a1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md @@ -10,8 +10,12 @@ ms.assetid: 747e3d51-b6d0-41c1-a726-7af3253b59d7 > 'type' : const/volatile qualifiers on this type are not supported +## Remarks + A qualifier keyword was applied to an array incorrectly. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). +## Example + The following sample generates C4538: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md index 1b5b6fc5f0e..8262f0ba6db 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md @@ -10,6 +10,8 @@ ms.assetid: a09b39a7-d3b8-435c-86a3-2233c512f24b > Injected text suppressed by attribute 'no_injected_text' +## Remarks + The [no_injected_text](../../windows/attributes/no-injected-text.md) attribute appeared in source code, which means the compiler will prevent attributes from injecting code. This warning is to remind you that attributes will not be able to inject code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md index 0467351aa82..41d19d1d47d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md @@ -10,6 +10,8 @@ ms.assetid: 55bb68f0-2e80-4330-8921-51083c4f8d53 > 'operator' : check operator precedence for possible error; use parentheses to clarify precedence +## Example + The following sample generates C4554: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md index 72de17e6164..0c7060d5c9f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md @@ -10,10 +10,14 @@ ms.assetid: 7d9db716-03b2-4ee5-9b09-ba8aa5aa7e4c > '__assume' contains effect 'effect' +## Remarks + The value passed to an [__assume](../../intrinsics/assume.md) statement2 was modified. 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 C4557: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md index 5eedcd1252a..6286781633b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md @@ -10,6 +10,8 @@ ms.assetid: ab4d0686-f813-4e88-a264-b40d3630ed6c > 'type name' : type-name exceeds meta-data limit of 'limit' characters +## Remarks + A type name would be truncated in metadata if it was a managed type. See [C3180](../../error-messages/compiler-errors-2/compiler-error-c3180.md) for more information. 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. From a411fc1a69915c9f1df273e69ecf143cf2de9289 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 22:30:14 +0800 Subject: [PATCH 1038/1799] Replace term "sample" with "example" for warning references in range [C4521, C4560] --- .../compiler-warnings/compiler-warning-level-1-c4530.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4532.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4533.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4537.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4544.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4545.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4546.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4547.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4548.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4549.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4551.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4552.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4553.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4558.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4521.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4522.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4534.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4535.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4538.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4554.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4557.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4559.md | 2 +- 22 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md index c55730c0fdc..6dec2a4d9c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md @@ -26,7 +26,7 @@ If no exceptions can possibly be thrown in your executable, you may safely ignor ## Example -The following sample generates C4530: +The following example generates C4530: ```cpp // C4530.cpp @@ -36,4 +36,4 @@ int main() { } ``` -Compile the sample with **`/EHsc`** to resolve the warning. +Compile the example with **`/EHsc`** to resolve the warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md index 000e2059c5b..298b32792e5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md @@ -30,7 +30,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example -The following sample generates C4532; delete or comment out the jump statements to resolve the warnings. +The following example generates C4532; delete or comment out the jump statements to resolve the warnings. ```cpp // C4532.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md index 11ebe5d5943..371a119dc04 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md @@ -18,7 +18,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example -The following sample generates C4533. To resolve the issue, move the initialization before the jump instruction or after the target of the jump. +The following example generates C4533. To resolve the issue, move the initialization before the jump instruction or after the target of the jump. ```cpp // C4533.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md index 36bf23c975a..221cac585c0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md @@ -16,7 +16,7 @@ A reference was passed where an object (user-defined type) was expected. A refer ## Example -The following sample generates C4537 and shows how to fix it: +The following example generates C4537 and shows how to fix it: ```cpp // C4537.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md index 15fd2a8eac8..7767563874e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md @@ -16,7 +16,7 @@ A default template argument was specified in an incorrect location and was ignor ## Example -This sample generates C4545, and the next sample shows how to fix it: +This example generates C4545, and the next example shows how to fix it: ```cpp // C4544.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md index 3dd1227362b..c252a8be6a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md @@ -18,7 +18,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4545: +The following example generates C4545: ```cpp // C4545.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md index 4deead90523..d96b60360f1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md @@ -18,7 +18,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4546: +The following example generates C4546: ```cpp // C4546.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md index 4bf6d9b4320..05313513cf0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md @@ -18,7 +18,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4547: +The following example generates C4547: ```cpp // C4547.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md index 1cb99ffd6c7..d999fa243a9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md @@ -18,7 +18,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4548: +The following example generates C4548: ```cpp // C4548.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md index b56a512b9e3..c6a12e0bcd8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md @@ -18,7 +18,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4549: +The following example generates C4549: ```cpp // C4549.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md index 4ff6fa1c7c1..7df51dc698c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md @@ -16,7 +16,7 @@ A function call must include the open and close parentheses after the function n ## Example -The following sample generates C4551: +The following example generates C4551: ```cpp // C4551.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md index 39ef2a220ef..02d6e54c730 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md @@ -18,7 +18,7 @@ To override this warning, put the expression in parentheses. ## Example -The following sample generates C4552: +The following example generates C4552: ```cpp // C4552.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md index 3dc75cc8aa7..b5ed0ea47ae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md @@ -16,7 +16,7 @@ If an expression statement has an operator with no side effect as the top of the ## Example -The following sample generates C4553: +The following example generates C4553: ```cpp // C4553.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md index 59f90cb7917..99170c858ef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md @@ -16,7 +16,7 @@ The value passed to an assembly language instruction is out of the range specifi ## Example -The following sample generates C4558: +The following example generates C4558: ```cpp // C4558.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md index 0d67d7caa89..3cc4a7fe622 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md @@ -18,7 +18,7 @@ Use the [warning](../../preprocessor/warning.md) pragma to suppress this warning ## Example -The following sample generates C4521. +The following example generates C4521. ```cpp // C4521.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md index a255d4f7ce0..bd65de2606e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md @@ -18,7 +18,7 @@ Use the [warning](../../preprocessor/warning.md) pragma to suppress this warning ## Example -The following sample generates C4522. +The following example generates C4522. ```cpp // C4522.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md index 217022d92f8..c2d45451173 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md @@ -17,7 +17,7 @@ For more information, see [Classes and Structs](../../extensions/classes-and-str ## Example -The following sample generates C4534: +The following example generates C4534: ```cpp // C4534.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md index 04d4926f808..d81e4f42699 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md @@ -16,7 +16,7 @@ The use of [_set_se_translator](../../c-runtime-library/reference/set-se-transla ## Example -The following sample generates C4535. +The following example generates C4535. ```cpp // C4535.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md index 463d0b9d6a1..9956f92f8b7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md @@ -16,7 +16,7 @@ A qualifier keyword was applied to an array incorrectly. For more information, s ## Example -The following sample generates C4538: +The following example generates C4538: ```cpp // C4538.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md index 41d19d1d47d..7a953ddd5a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md @@ -12,7 +12,7 @@ ms.assetid: 55bb68f0-2e80-4330-8921-51083c4f8d53 ## Example -The following sample generates C4554: +The following example generates C4554: ```cpp // C4554.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md index 0c7060d5c9f..4351a0a59d2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4557: +The following example generates C4557: ```cpp // C4557.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md index 0a41fa8b052..86ba8c79f7d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md @@ -16,7 +16,7 @@ A function was redefined or redeclared and the second definition or declaration ## Example -The following sample generates C4559: +The following example generates C4559: ```cpp // C4559.cpp From 33ae241c244c1088eaa40fc305f883629c21e1f2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 22:35:16 +0800 Subject: [PATCH 1039/1799] Update metadata for warning references in range [C4521, C4560] --- .../compiler-warnings/compiler-warning-level-1-c4526.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4530.md | 3 +-- .../compiler-warnings/compiler-warning-level-1-c4532.md | 3 +-- .../compiler-warnings/compiler-warning-level-1-c4533.md | 3 +-- .../compiler-warnings/compiler-warning-level-1-c4537.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4540.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4544.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4545.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4546.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4547.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4548.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4549.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4550.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4551.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4552.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4553.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4555.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4556.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4558.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4521.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4522.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4523.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4534.md | 4 ++-- .../compiler-warnings/compiler-warning-level-3-c4535.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4538.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4543.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4554.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4557.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4536.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4559.md | 5 ++--- 30 files changed, 56 insertions(+), 84 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md index 64c4b01310e..ea7f5d89922 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4526" title: "Compiler Warning (level 1) C4526" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4526" +ms.date: 11/04/2016 f1_keywords: ["C4526"] helpviewer_keywords: ["C4526"] -ms.assetid: 490f8916-5fdc-4cad-b412-76c3382a5976 --- # Compiler Warning (level 1) C4526 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md index 6dec2a4d9c9..a1b5e544b17 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md @@ -1,10 +1,9 @@ --- title: "Compiler Warning (level 1) C4530" description: "Reference guide to Microsoft C++ compiler warning C4530." -ms.date: "04/02/2020" +ms.date: 04/02/2020 f1_keywords: ["C4530"] helpviewer_keywords: ["C4530"] -ms.assetid: a04dcdb2-84db-459d-9e5e-4e743887465f --- # Compiler Warning (level 1) C4530 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md index 298b32792e5..ec19e1c3051 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4532" title: "Compiler Warning (level 1) C4532" +description: "Learn more about: Compiler Warning (level 1) C4532" ms.date: 08/30/2022 f1_keywords: ["C4532"] helpviewer_keywords: ["C4532"] -ms.assetid: 4e2a286a-d233-4106-9f65-29be1a94ca02 --- # Compiler Warning (level 1) C4532 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md index 371a119dc04..9a446f09372 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4533" title: "Compiler Warning (level 1) C4533" +description: "Learn more about: Compiler Warning (level 1) C4533" ms.date: 08/30/2022 f1_keywords: ["C4533"] helpviewer_keywords: ["C4533"] -ms.assetid: 359fecda-d540-46e5-b214-dbabe9ef50d2 --- # Compiler Warning (level 1) C4533 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md index 221cac585c0..9c20b0c8ca1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4537" title: "Compiler Warning (level 1) C4537" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4537" +ms.date: 08/27/2018 f1_keywords: ["C4537"] helpviewer_keywords: ["C4537"] -ms.assetid: 9454493c-d419-475e-8f35-9c00233c9329 --- # Compiler Warning (level 1) C4537 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md index c86925a81a2..d14b6b6e38a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4540" title: "Compiler Warning (level 1) C4540" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4540" +ms.date: 11/04/2016 f1_keywords: ["C4540"] helpviewer_keywords: ["C4540"] -ms.assetid: 8085e748-5f4d-43c2-b06d-eaf794edbf72 --- # Compiler Warning (level 1) C4540 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md index 7767563874e..0ba1ee5249a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4544" title: "Compiler Warning (level 1) C4544" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4544" +ms.date: 11/04/2016 f1_keywords: ["C4544"] helpviewer_keywords: ["C4544"] -ms.assetid: 11ee04df-41ae-435f-af44-881e801315a8 --- # Compiler Warning (level 1) C4544 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md index c252a8be6a6..6add8aa635e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4545" title: "Compiler Warning (level 1) C4545" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4545" +ms.date: 11/04/2016 f1_keywords: ["C4545"] helpviewer_keywords: ["C4545"] -ms.assetid: 43f8f34f-ed46-4661-95c0-c588c577ff73 --- # Compiler Warning (level 1) C4545 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md index d96b60360f1..bb9d1835428 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4546" title: "Compiler Warning (level 1) C4546" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4546" +ms.date: 11/04/2016 f1_keywords: ["C4546"] helpviewer_keywords: ["C4546"] -ms.assetid: 071e1709-3841-46c1-8e71-96109cd22041 --- # Compiler Warning (level 1) C4546 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md index 05313513cf0..fcf23c66dda 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4547" title: "Compiler Warning (level 1) C4547" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4547" +ms.date: 11/04/2016 f1_keywords: ["C4547"] helpviewer_keywords: ["C4547"] -ms.assetid: 3edf1c2e-c0d5-444d-ae83-44a7cce24bb2 --- # Compiler Warning (level 1) C4547 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md index d999fa243a9..62d604feaa4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4548" title: "Compiler Warning (level 1) C4548" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4548" +ms.date: 11/04/2016 f1_keywords: ["C4548"] helpviewer_keywords: ["C4548"] -ms.assetid: 2cee817e-e463-4d90-bbd2-de120d48c101 --- # Compiler Warning (level 1) C4548 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md index c6a12e0bcd8..fb6610064fa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4549" title: "Compiler Warning (level 1) C4549" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4549" +ms.date: 11/04/2016 f1_keywords: ["C4549"] helpviewer_keywords: ["C4549"] -ms.assetid: 81a07676-625b-4f58-9b0c-3ee22830b04a --- # Compiler Warning (level 1) C4549 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md index 8792d6253f8..f1569447021 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4550" title: "Compiler Warning (level 1) C4550" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4550" +ms.date: 11/04/2016 f1_keywords: ["C4550"] helpviewer_keywords: ["C4550"] -ms.assetid: f902b4ed-5f17-48ea-b693-92f4fb8c8054 --- # Compiler Warning (level 1) C4550 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md index 7df51dc698c..a7e1b9fe013 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4551" title: "Compiler Warning (level 1) C4551" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4551" +ms.date: 11/04/2016 f1_keywords: ["C4551"] helpviewer_keywords: ["C4551"] -ms.assetid: 458b59bd-e2d7-425f-9ba6-268ff200424f --- # Compiler Warning (level 1) C4551 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md index 02d6e54c730..6cea7cc2d46 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4552" title: "Compiler Warning (level 1) C4552" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4552" +ms.date: 11/04/2016 f1_keywords: ["C4552"] helpviewer_keywords: ["C4552"] -ms.assetid: ebbbb5ee-1c19-45bd-b386-41a19630fc76 --- # Compiler Warning (level 1) C4552 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md index b5ed0ea47ae..c8c357eb293 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4553" title: "Compiler Warning (level 1) C4553" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4553" +ms.date: 11/04/2016 f1_keywords: ["C4553"] helpviewer_keywords: ["C4553"] -ms.assetid: d8aacbe0-3cb5-4367-a6e5-fd7e28f0ff9d --- # Compiler Warning (level 1) C4553 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md index 0d0764247be..f98f2f75afb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4555" title: "Compiler Warning (level 1) C4555" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4555" +ms.date: 11/04/2016 f1_keywords: ["C4555"] helpviewer_keywords: ["C4555"] -ms.assetid: 50b286c1-f7bf-4292-b1fa-baaac9538611 --- # Compiler Warning (level 1) C4555 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4556.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4556.md index 1d14bf8eb5c..361ee46a496 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4556.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4556.md @@ -1,7 +1,7 @@ --- title: "Compiler Warning (level 1) C4556" description: "Learn more about: Compiler Warning (level 1) C4556" -ms.date: "03/28/2025" +ms.date: 03/28/2025 f1_keywords: ["C4556"] helpviewer_keywords: ["C4556"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md index 99170c858ef..730b37887ab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4558" title: "Compiler Warning (level 1) C4558" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4558" +ms.date: 11/04/2016 f1_keywords: ["C4558"] helpviewer_keywords: ["C4558"] -ms.assetid: 52bb0324-7bec-468c-b35b-13a08d38e578 --- # Compiler Warning (level 1) C4558 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md index 3cc4a7fe622..835726ea232 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4521" title: "Compiler Warning (level 3) C4521" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4521" +ms.date: 11/04/2016 f1_keywords: ["C4521"] helpviewer_keywords: ["C4521"] -ms.assetid: 057d770c-ebcf-44cd-b943-1b1bb1ceaa8c --- # Compiler Warning (level 3) C4521 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md index bd65de2606e..51cad339419 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4522" title: "Compiler Warning (level 3) C4522" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4522" +ms.date: 11/04/2016 f1_keywords: ["C4522"] helpviewer_keywords: ["C4522"] -ms.assetid: 7065dc27-0b6c-4e68-a345-c51cdb99a20b --- # Compiler Warning (level 3) C4522 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md index e0772f83245..1f9497e7f01 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4523" title: "Compiler Warning (level 3) C4523" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4523" +ms.date: 11/04/2016 f1_keywords: ["C4523"] helpviewer_keywords: ["C4523"] -ms.assetid: 0f28761d-999f-43fe-9481-d02afd9b4f60 --- # Compiler Warning (level 3) C4523 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md index c2d45451173..02b4492a1fd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4534" title: "Compiler Warning (level 3) C4534" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4534" +ms.date: 11/04/2016 f1_keywords: ["C4534"] helpviewer_keywords: ["C4534"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md index d81e4f42699..a98e2fb5ec1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4535" title: "Compiler Warning (level 3) C4535" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4535" +ms.date: 11/04/2016 f1_keywords: ["C4535"] helpviewer_keywords: ["C4535"] -ms.assetid: 2c5ad1aa-2558-41d1-8f06-47fef74c8d9b --- # Compiler Warning (level 3) C4535 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md index 9956f92f8b7..6bfa7556556 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4538" title: "Compiler Warning (level 3) C4538" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4538" +ms.date: 11/04/2016 f1_keywords: ["C4538"] helpviewer_keywords: ["C4538"] -ms.assetid: 747e3d51-b6d0-41c1-a726-7af3253b59d7 --- # Compiler Warning (level 3) C4538 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md index 8262f0ba6db..a36b2bff456 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4543" title: "Compiler Warning (level 3) C4543" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4543" +ms.date: 11/04/2016 f1_keywords: ["C4543"] helpviewer_keywords: ["C4543"] -ms.assetid: a09b39a7-d3b8-435c-86a3-2233c512f24b --- # Compiler Warning (level 3) C4543 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md index 7a953ddd5a6..46786ef9159 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4554" title: "Compiler Warning (level 3) C4554" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4554" +ms.date: 11/04/2016 f1_keywords: ["C4554"] helpviewer_keywords: ["C4554"] -ms.assetid: 55bb68f0-2e80-4330-8921-51083c4f8d53 --- # Compiler Warning (level 3) C4554 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md index 4351a0a59d2..b6495e22283 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4557" title: "Compiler Warning (level 3) C4557" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4557" +ms.date: 11/04/2016 f1_keywords: ["C4557"] helpviewer_keywords: ["C4557"] -ms.assetid: 7d9db716-03b2-4ee5-9b09-ba8aa5aa7e4c --- # Compiler Warning (level 3) C4557 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md index 6286781633b..666741bf888 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4536" title: "Compiler Warning (level 4) C4536" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4536" +ms.date: 11/04/2016 f1_keywords: ["C4536"] helpviewer_keywords: ["C4536"] -ms.assetid: ab4d0686-f813-4e88-a264-b40d3630ed6c --- # Compiler Warning (level 4) C4536 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md index 86ba8c79f7d..342ceb0c727 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4559" title: "Compiler Warning (level 4) C4559" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 4) C4559" +ms.date: 08/27/2018 f1_keywords: ["C4559"] helpviewer_keywords: ["C4559"] -ms.assetid: ed542f60-454d-45cb-85da-987ede61b1ab --- # Compiler Warning (level 4) C4559 From 543b05e7f41f2fda3e9eb0df055ba842e5ccc334 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 30 Aug 2025 22:37:28 +0800 Subject: [PATCH 1040/1799] Add leading example sentence in C4550 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4550.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md index f1569447021..f9c004fec9c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md @@ -15,6 +15,8 @@ A dereferenced pointer to a function is missing an argument list. ## Example +The following example generates C4550: + ```cpp // C4550.cpp // compile with: /W1 From 3acfbb31704f9c9cce38f2e1ca3f404b72ac4e38 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 18:37:19 +0800 Subject: [PATCH 1041/1799] Add blockquotes for warning messages in range [C4561, C4620] --- .../compiler-warnings/compiler-warning-level-1-c4561.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4566.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4572.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4581.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4584.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4600.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4602.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4603.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4606.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4613.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4615.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4616.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4618.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4620.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4570.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4580.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4608.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4619.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4564.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4610.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4611.md | 2 +- 21 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md index 5b0d3ae7272..65435832d38 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md @@ -8,7 +8,7 @@ ms.assetid: 3a10c12c-601b-4b6c-9861-331fd022e021 --- # Compiler Warning (level 1) C4561 -'__fastcall' incompatible with the '/clr' option: converting to '\__stdcall' +> '__fastcall' incompatible with the '/clr' option: converting to '\__stdcall' The [__fastcall](../../cpp/fastcall.md) function-calling convention cannot be used with the [/clr](../../build/reference/clr-common-language-runtime-compilation.md) compiler option. The compiler ignores the calls to **`__fastcall`**. To fix this warning, either remove the calls to **`__fastcall`** or compile without **/clr**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md index 425026f9603..ef7cff8797b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md @@ -8,7 +8,7 @@ ms.assetid: 65f40730-e86f-447c-b37b-16caadcfe311 --- # Compiler Warning (level 1) C4566 -character represented by universal-character-name 'char' cannot be represented in the current code page (page) +> character represented by universal-character-name 'char' cannot be represented in the current code page (page) Not every Unicode character can be represented in your current ANSI code page. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md index 2ecaa73a316..914b0128025 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md @@ -8,7 +8,7 @@ ms.assetid: 482dee5a-29bd-4fc3-b769-9dfd4cd2a964 --- # Compiler Warning (level 1) C4572 -[ParamArray] attribute is deprecated under /clr, use '...' instead +> [ParamArray] attribute is deprecated under /clr, use '...' instead An obsolete style for specifying a variable argument list was used. When compiling for the CLR, use ellipsis syntax instead of . 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-warnings/compiler-warning-level-1-c4581.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md index acdece26660..bf0e61d9825 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md @@ -8,7 +8,7 @@ ms.assetid: 598bcd87-257d-4eb3-94e4-15bb31aadc99 --- # Compiler Warning (level 1) C4581 -deprecated behavior: '"string1"' replaced with 'string2' to process attribute +> deprecated behavior: '"string1"' replaced with 'string2' to process attribute This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: parameter checking for Visual C++ attributes. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md index 4db3442c590..daf6c2cff73 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md @@ -8,7 +8,7 @@ ms.assetid: ad86582f-cb8c-4d21-8c4c-a6c800059e25 --- # Compiler Warning (level 1) C4584 -'class1' : base-class 'class2' is already a base-class of 'class3' +> 'class1' : base-class 'class2' is already a base-class of 'class3' The class you defined inherits from two classes, one of which inherits from the other. For example: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md index 446ec164f35..46ebb500dfc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md @@ -8,7 +8,7 @@ ms.assetid: f023a2a1-7fc4-463f-a434-dc93fcd3f4e9 --- # Compiler Warning (level 1) C4600 -\#pragma 'macro name' : expected a valid non-empty string +> #pragma 'macro name' : expected a valid non-empty string You cannot specify an empty string when you push or pop a macro name with either the [pop_macro](../../preprocessor/pop-macro.md) or [push_macro](../../preprocessor/push-macro.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md index a8a3b121f42..ea6e86a87a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md @@ -8,7 +8,7 @@ ms.assetid: c1f0300f-e2a2-4c9e-a7c3-4c7318d10509 --- # Compiler Warning (level 1) C4602 -\#pragma pop_macro : 'macro name' no previous #pragma push_macro for this identifier +> #pragma pop_macro : 'macro name' no previous #pragma push_macro for this identifier If you use [pop_macro](../../preprocessor/pop-macro.md) for a particular macro, you must first have passed that macro name to [push_macro](../../preprocessor/push-macro.md). For example, the following sample generates C4602: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md index a8b8f597828..206a324a5de 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md @@ -8,7 +8,7 @@ ms.assetid: f065994e-e3e5-4694-b868-c124472b3342 --- # Compiler Warning (level 1) C4603 -'\' : macro is not defined or definition is different after precompiled header use +> '\' : macro is not defined or definition is different after precompiled header use The macro specified by the *identifier* placeholder is either different or no longer defined after the precompiler header is used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md index 1eeecf2f663..e565d4cb0c0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md @@ -8,7 +8,7 @@ ms.assetid: c1b45fb6-672b-42eb-9e1c-c67b3e4150d3 --- # Compiler Warning (level 1) C4606 -\#pragma warning : 'warning_number' ignored; Code Analysis warnings are not associated with warning levels +> #pragma warning : 'warning_number' ignored; Code Analysis warnings are not associated with warning levels For Code Analysis warnings, only `error`, `once`, and `default` are supported with the [warning](../../preprocessor/warning.md) pragma. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md index a1d1ba5b233..a0d1f2077ac 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md @@ -8,6 +8,6 @@ ms.assetid: 399f521b-651c-4997-bc91-f40198e9a4d4 --- # Compiler Warning (level 1) C4613 -'segment' : class of segment cannot be changed +> 'segment' : class of segment cannot be changed You tried to create a segment with the same class name as a segment used by the compiler. No new segment class was created. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md index 8f4b9c9c1c2..0688d3337e7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md @@ -8,7 +8,7 @@ ms.assetid: 7b107c01-0da2-4e01-8b40-93813e30b94c --- # Compiler Warning (level 1) C4615 -\#pragma warning : unknown user warning type +> #pragma warning : unknown user warning type An invalid warning specifier was used with **pragma** [warning](../../preprocessor/warning.md). To resolve the error, use a valid warning specifier. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md index b3228cd32c3..186cfecc8ab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md @@ -8,7 +8,7 @@ ms.assetid: 71e15265-c5bc-42ce-a6a9-4879892472b1 --- # Compiler Warning (level 1) C4616 -\#pragma warning : warning number 'number' not a valid compiler warning +> #pragma warning : warning number 'number' not a valid compiler warning The warning number specified in the [warning](../../preprocessor/warning.md) pragma cannot be reassigned. The pragma was ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md index 577c7875f91..86fd1b5b7b0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md @@ -8,7 +8,7 @@ ms.assetid: 6ff10d0a-6d5b-4373-8196-1d57bb6b1611 --- # Compiler Warning (level 1) C4618 -pragma parameters included an empty string; pragma ignored +> pragma parameters included an empty string; pragma ignored A null string was given as an argument to a **#pragma**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md index c70c10ef526..ad06013865d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md @@ -8,7 +8,7 @@ ms.assetid: fed29934-b797-47e8-bbea-c7e5f8dd6e93 --- # Compiler Warning (level 1) C4620 -no postfix form of 'operator ++' found for type 'type', using prefix form +> no postfix form of 'operator ++' found for type 'type', using prefix form There is no postfix increment operator defined for the given type. The compiler used the overloaded prefix operator. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md index a3090361bf4..fa02f09289c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md @@ -8,7 +8,7 @@ ms.assetid: feec1225-e6ad-4995-8d96-c22e864a77bd --- # Compiler Warning (level 3) C4570 -'type' : is not explicitly declared as abstract but has abstract functions +> 'type' : is not explicitly declared as abstract but has abstract functions A type that contains [abstract](../../extensions/abstract-cpp-component-extensions.md) functions should itself be marked as abstract. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md index 5be25424956..cfaa9eebd65 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md @@ -8,7 +8,7 @@ ms.assetid: fef6e8e0-0d6a-44fa-b22a-2fe7ba2ef379 --- # Compiler Warning (level 3) C4580 -[attribute] is deprecated; instead specify System::Attribute or Platform::Metadata as a base class +> [attribute] is deprecated; instead specify System::Attribute or Platform::Metadata as a base class [[attribute](../../windows/attributes/attribute.md)] is no longer the preferred syntax for creating user-defined attributes. For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md). For CLR code, derive attributes from `System::Attribute`. For Windows Runtime code, derive attributes from `Platform::Metadata`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md index 40bb5d55bdb..1296440209d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md @@ -8,7 +8,7 @@ ms.assetid: 8b8f5f28-8ce9-457e-9d3d-a8c0efce9b6a --- # Compiler Warning (level 3) C4608 -'union_member' has already been initialized by another union member in the initializer list, 'union_member' +> 'union_member' has already been initialized by another union member in the initializer list, 'union_member' Two members of the same union were initialized in an initialization list. You can only access one member of the union. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md index d088f9e025e..fd0e3612f8f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md @@ -8,7 +8,7 @@ ms.assetid: 701fea21-01aa-4bea-93d4-1cb8824170b0 --- # Compiler Warning (level 3) C4619 -\#pragma warning : there is no warning number 'number' +> #pragma warning : there is no warning number 'number' An attempt was made to disable a warning that does not exist. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md index 629202c137e..0f896f97a51 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md @@ -8,7 +8,7 @@ ms.assetid: 555b301b-313e-4262-9f81-eb878674be60 --- # Compiler Warning (level 4) C4564 -method 'method' of class 'class' defines unsupported default parameter 'parameter' +> method 'method' of class 'class' defines unsupported default parameter 'parameter' The compiler detected a method with one or more parameters with default values. The default value(s) for the parameters will be ignored when the method is invoked; explicitly specify values for those parameters. If you do not explicitly specify values for those parameters, the C++ compiler will generate an error. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md index 4786d9b171f..54f04013156 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md @@ -8,7 +8,7 @@ ms.assetid: 23c1a16c-9ca9-4bf6-9911-a72b785560c2 --- # Compiler Warning (level 4) C4610 -object 'class' can never be instantiated - user-defined constructor required +> object 'class' can never be instantiated - user-defined constructor required The class has no user-defined or default constructors. No instantiation is performed. The following sample generates C4610: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md index f584d23463c..153348b95c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md @@ -8,7 +8,7 @@ ms.assetid: bd90d0a6-75f9-4e97-968d-dda6773e9fd8 --- # Compiler Warning (level 4) C4611 -interaction between 'function' and C++ object destruction is non-portable +> interaction between 'function' and C++ object destruction is non-portable On some platforms, functions that include **`catch`** may not support C++ object semantics of destruction when out of scope. From 802eedce464489a15cbe4acc17070ec06f866092 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 18:45:02 +0800 Subject: [PATCH 1042/1799] Add "Remarks" and "Example" headings for warning references in range [C4561, C4620] --- docs/error-messages/compiler-warnings/c4597.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4561.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4566.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4572.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4577.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4581.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4584.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4600.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4602.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4603.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4606.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4613.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4615.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4616.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4618.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4620.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4570.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4580.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4608.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4619.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4564.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4571.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4610.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-4-c4611.md | 2 ++ 24 files changed, 83 insertions(+), 7 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4597.md b/docs/error-messages/compiler-warnings/c4597.md index 9d3a66071fa..321aab2edd3 100644 --- a/docs/error-messages/compiler-warnings/c4597.md +++ b/docs/error-messages/compiler-warnings/c4597.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4597"] > undefined behavior: `offsetof` applied to a member of a virtual base -Using `offsetof(T, m)` where *`m`* refers to a static data member or a member function results in C4597. - ## Remarks +Using `offsetof(T, m)` where *`m`* refers to a static data member or a member function results in C4597. + This warning is new in Visual Studio 2017 version 15.3. It's reported as an error by default. For information on how to disable warnings by compiler version, see [Compiler warnings by compiler version](compiler-warnings-by-compiler-version.md). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md index 65435832d38..f030cdc31ec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md @@ -10,8 +10,12 @@ ms.assetid: 3a10c12c-601b-4b6c-9861-331fd022e021 > '__fastcall' incompatible with the '/clr' option: converting to '\__stdcall' +## Remarks + The [__fastcall](../../cpp/fastcall.md) function-calling convention cannot be used with the [/clr](../../build/reference/clr-common-language-runtime-compilation.md) compiler option. The compiler ignores the calls to **`__fastcall`**. To fix this warning, either remove the calls to **`__fastcall`** or compile without **/clr**. +## Example + The following sample generates C4561: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md index ef7cff8797b..aa51117dad2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md @@ -10,10 +10,14 @@ ms.assetid: 65f40730-e86f-447c-b37b-16caadcfe311 > character represented by universal-character-name 'char' cannot be represented in the current code page (page) +## Remarks + Not every Unicode character can be represented in your current ANSI code page. Narrow strings (one-byte characters) are converted to multi-byte characters whereas wide strings (two-byte characters) are not. +## Example + The following sample generates C4566: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md index 914b0128025..4c1198fa668 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md @@ -10,6 +10,8 @@ ms.assetid: 482dee5a-29bd-4fc3-b769-9dfd4cd2a964 > [ParamArray] attribute is deprecated under /clr, use '...' instead +## Remarks + An obsolete style for specifying a variable argument list was used. When compiling for the CLR, use ellipsis syntax instead of . For more information, see [Variable Argument Lists (...) (C++/CLI)](../../extensions/variable-argument-lists-dot-dot-dot-cpp-cli.md). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md index f6b51626645..184f42ce9b9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4577"] > 'noexcept' used with no exception handling mode specified; termination on exception is not guaranteed. Specify /EHsc +## Remarks + The compiler detected a **`noexcept`** specification, but standard C++ exception handling wasn't specified. The compiler doesn't fully support exception handling according to the C++ standard unless the [/EHsc](../../build/reference/eh-exception-handling-model.md) compiler option is specified. To resolve this issue, set the **/EHsc** compiler option. This warning is new in Visual Studio 2015, and is off by default. For more information, see [Compiler warnings that are off by default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md index bf0e61d9825..a0a54df35bf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md @@ -10,6 +10,8 @@ ms.assetid: 598bcd87-257d-4eb3-94e4-15bb31aadc99 > deprecated behavior: '"string1"' replaced with 'string2' to process attribute +## Remarks + This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: parameter checking for Visual C++ attributes. In previous versions, attribute values were accepted whether or not they were enclosed in quotation marks. If the value is an enumeration, it must not be enclosed in quotation marks. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md index daf6c2cff73..d1871239836 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md @@ -10,7 +10,13 @@ ms.assetid: ad86582f-cb8c-4d21-8c4c-a6c800059e25 > 'class1' : base-class 'class2' is already a base-class of 'class3' -The class you defined inherits from two classes, one of which inherits from the other. For example: +## Remarks + +The class you defined inherits from two classes, one of which inherits from the other. + +## Example + +For example: ```cpp // C4584.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md index 46ebb500dfc..60cf01cea68 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md @@ -10,8 +10,12 @@ ms.assetid: f023a2a1-7fc4-463f-a434-dc93fcd3f4e9 > #pragma 'macro name' : expected a valid non-empty string +## Remarks + You cannot specify an empty string when you push or pop a macro name with either the [pop_macro](../../preprocessor/pop-macro.md) or [push_macro](../../preprocessor/push-macro.md). +## Example + The following sample generates C4600: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md index ea6e86a87a6..aa653a202db 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md @@ -10,7 +10,13 @@ ms.assetid: c1f0300f-e2a2-4c9e-a7c3-4c7318d10509 > #pragma pop_macro : 'macro name' no previous #pragma push_macro for this identifier -If you use [pop_macro](../../preprocessor/pop-macro.md) for a particular macro, you must first have passed that macro name to [push_macro](../../preprocessor/push-macro.md). For example, the following sample generates C4602: +## Remarks + +If you use [pop_macro](../../preprocessor/pop-macro.md) for a particular macro, you must first have passed that macro name to [push_macro](../../preprocessor/push-macro.md). + +## Example + +For example, the following sample generates C4602: ```cpp // C4602.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md index 206a324a5de..6e6fa2665c2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md @@ -10,6 +10,8 @@ ms.assetid: f065994e-e3e5-4694-b868-c124472b3342 > '\' : macro is not defined or definition is different after precompiled header use +## Remarks + The macro specified by the *identifier* placeholder is either different or no longer defined after the precompiler header is used. ## See also diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md index e565d4cb0c0..29f1dca4909 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md @@ -10,6 +10,8 @@ ms.assetid: c1b45fb6-672b-42eb-9e1c-c67b3e4150d3 > #pragma warning : 'warning_number' ignored; Code Analysis warnings are not associated with warning levels +## Remarks + For Code Analysis warnings, only `error`, `once`, and `default` are supported with the [warning](../../preprocessor/warning.md) pragma. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md index a0d1f2077ac..9cc0272de6e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md @@ -10,4 +10,6 @@ ms.assetid: 399f521b-651c-4997-bc91-f40198e9a4d4 > 'segment' : class of segment cannot be changed +## Remarks + You tried to create a segment with the same class name as a segment used by the compiler. No new segment class was created. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md index 0688d3337e7..590c9240149 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md @@ -10,8 +10,12 @@ ms.assetid: 7b107c01-0da2-4e01-8b40-93813e30b94c > #pragma warning : unknown user warning type +## Remarks + An invalid warning specifier was used with **pragma** [warning](../../preprocessor/warning.md). To resolve the error, use a valid warning specifier. +## Example + The following sample generates C4615: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md index 186cfecc8ab..f82a5f0344e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md @@ -10,8 +10,12 @@ ms.assetid: 71e15265-c5bc-42ce-a6a9-4879892472b1 > #pragma warning : warning number 'number' not a valid compiler warning +## Remarks + The warning number specified in the [warning](../../preprocessor/warning.md) pragma cannot be reassigned. The pragma was ignored. +## Example + The following sample generates C4616: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md index 86fd1b5b7b0..dc5891650a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md @@ -10,10 +10,14 @@ ms.assetid: 6ff10d0a-6d5b-4373-8196-1d57bb6b1611 > pragma parameters included an empty string; pragma ignored +## Remarks + A null string was given as an argument to a **#pragma**. The pragma was processed without the argument. +## Example + The following sample generates C4618: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md index ad06013865d..dfd025f2a1c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md @@ -10,8 +10,12 @@ ms.assetid: fed29934-b797-47e8-bbea-c7e5f8dd6e93 > no postfix form of 'operator ++' found for type 'type', using prefix form +## Remarks + There is no postfix increment operator defined for the given type. The compiler used the overloaded prefix operator. +## Example + This warning can be avoided by defining a postfix `++` operator. Create a two-argument version of the `++` operator as shown here: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md index fa02f09289c..5ed5fb32dfe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md @@ -10,6 +10,8 @@ ms.assetid: feec1225-e6ad-4995-8d96-c22e864a77bd > 'type' : is not explicitly declared as abstract but has abstract functions +## Remarks + A type that contains [abstract](../../extensions/abstract-cpp-component-extensions.md) functions should itself be marked as abstract. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md index cfaa9eebd65..01c6e8912e2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md @@ -10,6 +10,8 @@ ms.assetid: fef6e8e0-0d6a-44fa-b22a-2fe7ba2ef379 > [attribute] is deprecated; instead specify System::Attribute or Platform::Metadata as a base class +## Remarks + [[attribute](../../windows/attributes/attribute.md)] is no longer the preferred syntax for creating user-defined attributes. For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md). For CLR code, derive attributes from `System::Attribute`. For Windows Runtime code, derive attributes from `Platform::Metadata`. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md index 1296440209d..97361c08ad0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md @@ -10,8 +10,12 @@ ms.assetid: 8b8f5f28-8ce9-457e-9d3d-a8c0efce9b6a > 'union_member' has already been initialized by another union member in the initializer list, 'union_member' +## Remarks + Two members of the same union were initialized in an initialization list. You can only access one member of the union. +## Example + The following sample generates C4608: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md index fd0e3612f8f..4478f468147 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md @@ -10,10 +10,14 @@ ms.assetid: 701fea21-01aa-4bea-93d4-1cb8824170b0 > #pragma warning : there is no warning number 'number' +## Remarks + An attempt was made to disable a warning that does not exist. 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 C4619: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md index 0f896f97a51..78340d61c40 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md @@ -10,8 +10,12 @@ ms.assetid: 555b301b-313e-4262-9f81-eb878674be60 > method 'method' of class 'class' defines unsupported default parameter 'parameter' +## Remarks + The compiler detected a method with one or more parameters with default values. The default value(s) for the parameters will be ignored when the method is invoked; explicitly specify values for those parameters. If you do not explicitly specify values for those parameters, the C++ compiler will generate an error. +## Example + Given the following .dll created with Visual Basic, which allows default parameters on method arguments: ```vb diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md index 54845383a3c..c995c2afe9e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md @@ -10,10 +10,10 @@ ms.assetid: 07aa17bd-b15c-4266-824c-57cc445e8edd > Informational: `catch(...)` semantics changed since Visual C++ 7.1; structured exceptions (SEH) are no longer caught -C4571 is generated for every `catch(...)` block when you specify the **`/EHs`** compiler option. - ## Remarks +C4571 is generated for every `catch(...)` block when you specify the **`/EHs`** compiler option. + When you specify the **`/EHs`** compiler option, `catch(...)` blocks don't catch structured exceptions. (Divide by zero, or null pointer exceptions, for example.) A `catch(...)` block only catches explicitly thrown C++ exceptions. For more information, see [Exception Handling](../../cpp/exception-handling-in-visual-cpp.md). This warning is off by default. Turn this warning on to ensure that when you compile with **`/EHs`** your `catch (...)` blocks don't catch structured exceptions. For more information, see [Compiler warnings that are off by default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md index 54f04013156..7fb4975f297 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md @@ -10,7 +10,13 @@ ms.assetid: 23c1a16c-9ca9-4bf6-9911-a72b785560c2 > object 'class' can never be instantiated - user-defined constructor required -The class has no user-defined or default constructors. No instantiation is performed. The following sample generates C4610: +## Remarks + +The class has no user-defined or default constructors. No instantiation is performed. + +## Example + +The following sample generates C4610: ```cpp // C4610.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md index 153348b95c9..802ff39b78a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md @@ -10,6 +10,8 @@ ms.assetid: bd90d0a6-75f9-4e97-968d-dda6773e9fd8 > interaction between 'function' and C++ object destruction is non-portable +## Remarks + On some platforms, functions that include **`catch`** may not support C++ object semantics of destruction when out of scope. To avoid unexpected behavior, avoid using **`catch`** in functions that have constructors and destructors. From 602587308864a8b3d393d62e76cbaa20df859e0c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 18:46:39 +0800 Subject: [PATCH 1043/1799] Replace term "sample" with "example" for warning references in range [C4561, C4620] --- docs/error-messages/compiler-warnings/c4596.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4561.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4566.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4572.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4581.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4600.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4602.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4606.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4615.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4616.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4618.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4570.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4580.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4608.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4619.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4564.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4565.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4571.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4610.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4596.md b/docs/error-messages/compiler-warnings/c4596.md index 9c7afed4d11..2f75d68a92f 100644 --- a/docs/error-messages/compiler-warnings/c4596.md +++ b/docs/error-messages/compiler-warnings/c4596.md @@ -19,7 +19,7 @@ This warning is available starting in Visual Studio 2015 Update 3. Code that com ## Example -This sample generates C4596, and shows a way to fix it: +This example generates C4596, and shows a way to fix it: ```cpp // C4596.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md index f030cdc31ec..625e053c84a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md @@ -16,7 +16,7 @@ The [__fastcall](../../cpp/fastcall.md) function-calling convention cannot be us ## Example -The following sample generates C4561: +The following example generates C4561: ```cpp // C4561.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md index aa51117dad2..0c1451b42a4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md @@ -18,7 +18,7 @@ Narrow strings (one-byte characters) are converted to multi-byte characters wher ## Example -The following sample generates C4566: +The following example generates C4566: ```cpp // C4566.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md index 4c1198fa668..6bce2dd093e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md @@ -16,7 +16,7 @@ An obsolete style for specifying a variable argument list was used. When compili ## Example -The following sample generates C4572. +The following example generates C4572. ```cpp // C4572.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md index a0a54df35bf..8363bfefc5d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md @@ -18,7 +18,7 @@ In previous versions, attribute values were accepted whether or not they were en ## Example -The following sample generates C4581. +The following example generates C4581. ```cpp // C4581.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md index 60cf01cea68..e6becded226 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md @@ -16,7 +16,7 @@ You cannot specify an empty string when you push or pop a macro name with either ## Example -The following sample generates C4600: +The following example generates C4600: ```cpp // C4600.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md index aa653a202db..104ca62e71b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md @@ -16,7 +16,7 @@ If you use [pop_macro](../../preprocessor/pop-macro.md) for a particular macro, ## Example -For example, the following sample generates C4602: +For example, the following example generates C4602: ```cpp // C4602.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md index 29f1dca4909..1ae23caf9cc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md @@ -16,7 +16,7 @@ For Code Analysis warnings, only `error`, `once`, and `default` are supported wi ## Example -The following sample generates C4606. +The following example generates C4606. ```cpp // C4606.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md index 590c9240149..ab8a21388b6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md @@ -16,7 +16,7 @@ An invalid warning specifier was used with **pragma** [warning](../../preprocess ## Example -The following sample generates C4615: +The following example generates C4615: ```cpp // C4615.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md index f82a5f0344e..40cef13d645 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md @@ -16,7 +16,7 @@ The warning number specified in the [warning](../../preprocessor/warning.md) pra ## Example -The following sample generates C4616: +The following example generates C4616: ```cpp // C4616.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md index dc5891650a6..a75eeeec515 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md @@ -18,7 +18,7 @@ The pragma was processed without the argument. ## Example -The following sample generates C4618: +The following example generates C4618: ```cpp // C4618.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md index 5ed5fb32dfe..c0c464ee809 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md @@ -16,7 +16,7 @@ A type that contains [abstract](../../extensions/abstract-cpp-component-extensio ## Example -The following sample generates C4570. +The following example generates C4570. ```cpp // C4570.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md index 01c6e8912e2..874bda8e856 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md @@ -16,7 +16,7 @@ ms.assetid: fef6e8e0-0d6a-44fa-b22a-2fe7ba2ef379 ## Example -The following sample generates C3454 and shows how to fix it. +The following example generates C3454 and shows how to fix it. ```cpp // C4580.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md index 97361c08ad0..aa1db03d331 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md @@ -16,7 +16,7 @@ Two members of the same union were initialized in an initialization list. You ca ## Example -The following sample generates C4608: +The following example generates C4608: ```cpp // C4608.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md index 4478f468147..3715c0dc957 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4619: +The following example generates C4619: ```cpp // C4619.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md index 78340d61c40..e2bd7a2c0e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md @@ -28,7 +28,7 @@ Public class TestClass End class ``` -And the following C++ sample that uses the .dll created with Visual Basic, +And the following C++ example that uses the .dll created with Visual Basic, ```cpp // C4564.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md index 293f34c42c8..c1ba82d1b8d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md @@ -16,7 +16,7 @@ A symbol was redefined or redeclared and the second definition or declaration, u ## Example -The following sample generates C4565: +The following example generates C4565: ```cpp // C4565.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md index c995c2afe9e..59d362c87da 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md @@ -28,7 +28,7 @@ You can resolve C4571 in one of the following ways: ## Example -The following sample generates C4571. +The following example generates C4571. ```cpp // C4571.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md index 7fb4975f297..c1905a4b9a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md @@ -16,7 +16,7 @@ The class has no user-defined or default constructors. No instantiation is perfo ## Example -The following sample generates C4610: +The following example generates C4610: ```cpp // C4610.cpp From 9844555e0fa0e5ee7f5efa159d9be26d52a08a6e Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 18:51:24 +0800 Subject: [PATCH 1044/1799] Update metadata for warning references in range [C4561, C4620] --- docs/error-messages/compiler-warnings/c4596.md | 4 ++-- docs/error-messages/compiler-warnings/c4597.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4561.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4566.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4572.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4577.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4581.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4584.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4600.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4602.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4603.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4606.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4612.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4613.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4615.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4616.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4618.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4620.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4570.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4580.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4608.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4619.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4564.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4565.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4571.md | 1 - .../compiler-warnings/compiler-warning-level-4-c4610.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4611.md | 5 ++--- 27 files changed, 51 insertions(+), 75 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4596.md b/docs/error-messages/compiler-warnings/c4596.md index 2f75d68a92f..1f2156b3c89 100644 --- a/docs/error-messages/compiler-warnings/c4596.md +++ b/docs/error-messages/compiler-warnings/c4596.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4596" title: "Compiler Warning (Level 4) C4596" -ms.date: "08/15/2019" +description: "Learn more about: Compiler Warning (level 4) C4596" +ms.date: 08/15/2019 f1_keywords: ["C4596"] helpviewer_keywords: ["C4596"] --- diff --git a/docs/error-messages/compiler-warnings/c4597.md b/docs/error-messages/compiler-warnings/c4597.md index 321aab2edd3..55790a29b4f 100644 --- a/docs/error-messages/compiler-warnings/c4597.md +++ b/docs/error-messages/compiler-warnings/c4597.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (error) C4597" title: "Compiler Warning (error) C4597" +description: "Learn more about: Compiler Warning (error) C4597" ms.date: 05/03/2021 f1_keywords: ["C4597"] helpviewer_keywords: ["C4597"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md index 625e053c84a..9c92d5ffb96 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4561" title: "Compiler Warning (level 1) C4561" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4561" +ms.date: 11/04/2016 f1_keywords: ["C4561"] helpviewer_keywords: ["C4561"] -ms.assetid: 3a10c12c-601b-4b6c-9861-331fd022e021 --- # Compiler Warning (level 1) C4561 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md index 0c1451b42a4..b20a4c38cdb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4566" title: "Compiler Warning (level 1) C4566" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4566" +ms.date: 11/04/2016 f1_keywords: ["C4566"] helpviewer_keywords: ["C4566"] -ms.assetid: 65f40730-e86f-447c-b37b-16caadcfe311 --- # Compiler Warning (level 1) C4566 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md index 6bce2dd093e..6e42a081081 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4572" title: "Compiler Warning (level 1) C4572" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4572" +ms.date: 11/04/2016 f1_keywords: ["C4572"] helpviewer_keywords: ["C4572"] -ms.assetid: 482dee5a-29bd-4fc3-b769-9dfd4cd2a964 --- # Compiler Warning (level 1) C4572 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md index 184f42ce9b9..9ba3d67ccb1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md @@ -1,7 +1,7 @@ --- title: "Compiler Warning C4577" -description: Compiler warning C4577 description and solution. -ms.date: "09/18/2019" +description: "Compiler warning C4577 description and solution." +ms.date: 09/18/2019 f1_keywords: ["C4577"] helpviewer_keywords: ["C4577"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md index 8363bfefc5d..f68c67ae615 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4581" title: "Compiler Warning (level 1) C4581" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4581" +ms.date: 11/04/2016 f1_keywords: ["C4581"] helpviewer_keywords: ["C4581"] -ms.assetid: 598bcd87-257d-4eb3-94e4-15bb31aadc99 --- # Compiler Warning (level 1) C4581 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md index d1871239836..92ff0980142 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4584" title: "Compiler Warning (level 1) C4584" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4584" +ms.date: 11/04/2016 f1_keywords: ["C4584"] helpviewer_keywords: ["C4584"] -ms.assetid: ad86582f-cb8c-4d21-8c4c-a6c800059e25 --- # Compiler Warning (level 1) C4584 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md index e6becded226..187cda9ee3e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4600" title: "Compiler Warning (level 1) C4600" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4600" +ms.date: 11/04/2016 f1_keywords: ["C4600"] helpviewer_keywords: ["C4600"] -ms.assetid: f023a2a1-7fc4-463f-a434-dc93fcd3f4e9 --- # Compiler Warning (level 1) C4600 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md index 104ca62e71b..215e76f9799 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4602" title: "Compiler Warning (level 1) C4602" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4602" +ms.date: 11/04/2016 f1_keywords: ["C4602"] helpviewer_keywords: ["C4602"] -ms.assetid: c1f0300f-e2a2-4c9e-a7c3-4c7318d10509 --- # Compiler Warning (level 1) C4602 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md index 6e6fa2665c2..56bb27c36d7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4603" title: "Compiler Warning (level 1) C4603" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4603" +ms.date: 11/04/2016 f1_keywords: ["C4603"] helpviewer_keywords: ["C4603"] -ms.assetid: f065994e-e3e5-4694-b868-c124472b3342 --- # Compiler Warning (level 1) C4603 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md index 1ae23caf9cc..acfb5694aae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4606" title: "Compiler Warning (level 1) C4606" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4606" +ms.date: 11/04/2016 f1_keywords: ["C4606"] helpviewer_keywords: ["C4606"] -ms.assetid: c1b45fb6-672b-42eb-9e1c-c67b3e4150d3 --- # Compiler Warning (level 1) C4606 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md index 49a8294c0ff..d2adf572c5c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4612" title: "Compiler Warning (level 1) C4612" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4612" +ms.date: 08/27/2018 f1_keywords: ["C4612"] helpviewer_keywords: ["C4612"] -ms.assetid: 21ac02b2-51cd-4aff-9b70-d543511d5962 --- # Compiler Warning (level 1) C4612 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md index 9cc0272de6e..b38c95c4b13 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4613" title: "Compiler Warning (level 1) C4613" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4613" +ms.date: 11/04/2016 f1_keywords: ["C4613"] helpviewer_keywords: ["C4613"] -ms.assetid: 399f521b-651c-4997-bc91-f40198e9a4d4 --- # Compiler Warning (level 1) C4613 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md index ab8a21388b6..9fa4a67263d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4615" title: "Compiler Warning (level 1) C4615" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4615" +ms.date: 11/04/2016 f1_keywords: ["C4615"] helpviewer_keywords: ["C4615"] -ms.assetid: 7b107c01-0da2-4e01-8b40-93813e30b94c --- # Compiler Warning (level 1) C4615 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md index 40cef13d645..1fb7f99a29e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4616" title: "Compiler Warning (level 1) C4616" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4616" +ms.date: 11/04/2016 f1_keywords: ["C4616"] helpviewer_keywords: ["C4616"] -ms.assetid: 71e15265-c5bc-42ce-a6a9-4879892472b1 --- # Compiler Warning (level 1) C4616 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md index a75eeeec515..ef7b1fba645 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4618" title: "Compiler Warning (level 1) C4618" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4618" +ms.date: 11/04/2016 f1_keywords: ["C4618"] helpviewer_keywords: ["C4618"] -ms.assetid: 6ff10d0a-6d5b-4373-8196-1d57bb6b1611 --- # Compiler Warning (level 1) C4618 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md index dfd025f2a1c..76b04214dec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4620" title: "Compiler Warning (level 1) C4620" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4620" +ms.date: 11/04/2016 f1_keywords: ["C4620"] helpviewer_keywords: ["C4620"] -ms.assetid: fed29934-b797-47e8-bbea-c7e5f8dd6e93 --- # Compiler Warning (level 1) C4620 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md index c0c464ee809..6ae41dad8d9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4570" title: "Compiler Warning (level 3) C4570" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4570" +ms.date: 11/04/2016 f1_keywords: ["C4570"] helpviewer_keywords: ["C4570"] -ms.assetid: feec1225-e6ad-4995-8d96-c22e864a77bd --- # Compiler Warning (level 3) C4570 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md index 874bda8e856..479016f20c6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4580" title: "Compiler Warning (level 3) C4580" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4580" +ms.date: 11/04/2016 f1_keywords: ["C4580"] helpviewer_keywords: ["C4580"] -ms.assetid: fef6e8e0-0d6a-44fa-b22a-2fe7ba2ef379 --- # Compiler Warning (level 3) C4580 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md index aa1db03d331..f924e7ab0e4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4608" title: "Compiler Warning (level 3) C4608" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4608" +ms.date: 11/04/2016 f1_keywords: ["C4608"] helpviewer_keywords: ["C4608"] -ms.assetid: 8b8f5f28-8ce9-457e-9d3d-a8c0efce9b6a --- # Compiler Warning (level 3) C4608 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md index 3715c0dc957..fb98a1c9d61 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4619" title: "Compiler Warning (level 3) C4619" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4619" +ms.date: 11/04/2016 f1_keywords: ["C4619"] helpviewer_keywords: ["C4619"] -ms.assetid: 701fea21-01aa-4bea-93d4-1cb8824170b0 --- # Compiler Warning (level 3) C4619 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md index e2bd7a2c0e3..92a33b38705 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4564" title: "Compiler Warning (level 4) C4564" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4564" +ms.date: 11/04/2016 f1_keywords: ["C4564"] helpviewer_keywords: ["C4564"] -ms.assetid: 555b301b-313e-4262-9f81-eb878674be60 --- # Compiler Warning (level 4) C4564 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md index c1ba82d1b8d..c1f9e7d3e2b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4565" title: "Compiler Warning (level 4) C4565" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 4) C4565" +ms.date: 08/27/2018 f1_keywords: ["C4565"] helpviewer_keywords: ["C4565"] -ms.assetid: a71f1341-a4a1-4060-ad1e-9322531883ed --- # Compiler Warning (level 4) C4565 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md index 59d362c87da..a45338491c2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md @@ -4,7 +4,6 @@ description: "Documents the Microsoft C++ compiler warning C4571." ms.date: 08/24/2020 f1_keywords: ["C4571"] helpviewer_keywords: ["C4571"] -ms.assetid: 07aa17bd-b15c-4266-824c-57cc445e8edd --- # Compiler Warning (level 4) C4571 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md index c1905a4b9a6..7f3a940728a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4610" title: "Compiler Warning (level 4) C4610" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4610" +ms.date: 11/04/2016 f1_keywords: ["C4610"] helpviewer_keywords: ["C4610"] -ms.assetid: 23c1a16c-9ca9-4bf6-9911-a72b785560c2 --- # Compiler Warning (level 4) C4610 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md index 802ff39b78a..0a08bc7d430 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4611" title: "Compiler Warning (level 4) C4611" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4611" +ms.date: 11/04/2016 f1_keywords: ["C4611"] helpviewer_keywords: ["C4611"] -ms.assetid: bd90d0a6-75f9-4e97-968d-dda6773e9fd8 --- # Compiler Warning (level 4) C4611 From 08f9f265caf71f3768fc0aba8337ba6d85eff492 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 18:52:34 +0800 Subject: [PATCH 1045/1799] Add leading example sentence in C4612 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4612.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md index d2adf572c5c..461fe57021d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md @@ -17,6 +17,8 @@ The arguments to the **#pragma include_alias** statement can use the quote form ## Example +The following example generates C4612: + ```cpp // C4612.cpp // compile with: /W1 /LD From 9b806299226b5c9c457c8a63685311146152ea0d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 21:22:44 +0800 Subject: [PATCH 1046/1799] Fix miscellaneous spacing issues --- docs/build/reference/fpcvt.md | 2 +- docs/build/reference/ln-create-msil-module.md | 6 +++--- docs/build/reference/midl-property-pages.md | 2 +- ...pgd-specify-database-for-profile-guided-optimizations.md | 2 +- .../tool-errors/linker-tools-error-lnk2022.md | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/build/reference/fpcvt.md b/docs/build/reference/fpcvt.md index 8661d649c92..5e644c5c7da 100644 --- a/docs/build/reference/fpcvt.md +++ b/docs/build/reference/fpcvt.md @@ -40,7 +40,7 @@ The **`/fpcvt`** options are new in Visual Studio 2019 version 16.8. If you spec ### Intrinsic functions for conversions -You can specify the behavior of a specific conversion independently of the **`/fpcvt `** option, which applies globally. The compiler provides intrinsic sentinel conversion functions for conversions compatible with **`/fpcvt:IA`**. For more information, see [Sentinel conversion functions](../../intrinsics/sentinel-conversion-functions.md). The compiler also provides saturation conversion functions compatible with conversions on ARM or ARM64 target architectures. For more information, see [Saturation conversion functions](../../intrinsics/saturation-conversion-functions.md). +You can specify the behavior of a specific conversion independently of the **`/fpcvt`** option, which applies globally. The compiler provides intrinsic sentinel conversion functions for conversions compatible with **`/fpcvt:IA`**. For more information, see [Sentinel conversion functions](../../intrinsics/sentinel-conversion-functions.md). The compiler also provides saturation conversion functions compatible with conversions on ARM or ARM64 target architectures. For more information, see [Saturation conversion functions](../../intrinsics/saturation-conversion-functions.md). The compiler also supports intrinsic conversion functions that execute as quickly as possible for valid conversions. These functions may generate any value or throw an exception for an invalid conversion. The results depend on the target platform, compiler options, and context. They're useful for handling values that have already been range-checked, or values generated in a way that can't cause an invalid conversion. For more information, see [Fast conversion functions](../../intrinsics/fast-conversion-functions.md). diff --git a/docs/build/reference/ln-create-msil-module.md b/docs/build/reference/ln-create-msil-module.md index b5cd351176f..b8a545e5546 100644 --- a/docs/build/reference/ln-create-msil-module.md +++ b/docs/build/reference/ln-create-msil-module.md @@ -21,15 +21,15 @@ By default, `/LN` isn't in effect, and the compiler inserts an assembly manifest When you use `/LN`, you must also use one of the [/clr (Common Language Runtime Compilation)](clr-common-language-runtime-compilation.md) options. -A managed program that doesn't have assembly metadata in the manifest is called a module. If you compile with [/c (Compile Without Linking)](c-compile-without-linking.md) and `/LN`, specify [`/NOASSEMBLY `(Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. +A managed program that doesn't have assembly metadata in the manifest is called a module. If you compile with [/c (Compile Without Linking)](c-compile-without-linking.md) and `/LN`, specify [`/NOASSEMBLY` (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. -Create modules if you want to take a component-based approach to building assemblies. You can author types and compile them into modules. Then, you can generate an assembly from one or more modules. For more information on creating assemblies from modules, see [`.netmodule` Files as Linker Input](netmodule-files-as-linker-input.md) or [`Al.exe `(Assembly Linker)](/dotnet/framework/tools/al-exe-assembly-linker). +Create modules if you want to take a component-based approach to building assemblies. You can author types and compile them into modules. Then, you can generate an assembly from one or more modules. For more information on creating assemblies from modules, see [`.netmodule` Files as Linker Input](netmodule-files-as-linker-input.md) or [`Al.exe` (Assembly Linker)](/dotnet/framework/tools/al-exe-assembly-linker). The default file extension for a module is `.netmodule`. In releases before Visual Studio 2005, you created a module with `/clr:noAssembly`. -The MSVC linker accepts `.netmodule` files as input. The output file produced by the linker is an assembly or `.netmodule` with no run-time dependence on any of the `.netmodule`s that you input to the linker. For more information, see [`.netmodule `Files as Linker Input](netmodule-files-as-linker-input.md). +The MSVC linker accepts `.netmodule` files as input. The output file produced by the linker is an assembly or `.netmodule` with no run-time dependence on any of the `.netmodule`s that you input to the linker. For more information, see [`.netmodule` Files as Linker Input](netmodule-files-as-linker-input.md). ### To set this compiler option in the Visual Studio development environment diff --git a/docs/build/reference/midl-property-pages.md b/docs/build/reference/midl-property-pages.md index 66c3955c39a..5c7d64e42e7 100644 --- a/docs/build/reference/midl-property-pages.md +++ b/docs/build/reference/midl-property-pages.md @@ -123,7 +123,7 @@ Specifies which environment to target ([/env](/windows/win32/midl/-env) arm32|wi ### Generate Stubless Proxies -Generate fully interpreted stubs with extensions and stubless proxies for object interfaces ([/Oicf](/windows/win32/midl/-oi), [/Oif](/windows/win32/midl/-oi) ). +Generate fully interpreted stubs with extensions and stubless proxies for object interfaces ([/Oicf](/windows/win32/midl/-oi), [/Oif](/windows/win32/midl/-oi)). ### Suppress Compiler Warnings diff --git a/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md b/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md index 77539e99b0c..d8461ded773 100644 --- a/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md +++ b/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["-PGD linker option", "/PGD linker option"] --- # /PGD (Specify Database for Profile-Guided Optimizations) -**The /PGD option is deprecated.** Starting in Visual Studio 2015, prefer the [`/GENPROFILE`or `/FASTGENPROFILE`](genprofile-fastgenprofile-generate-profiling-instrumented-build.md) linker options instead. This option is used to specify the name of the .pgd file used by the profile-guided optimization process. +**The /PGD option is deprecated.** Starting in Visual Studio 2015, prefer the [`/GENPROFILE` or `/FASTGENPROFILE`](genprofile-fastgenprofile-generate-profiling-instrumented-build.md) linker options instead. This option is used to specify the name of the .pgd file used by the profile-guided optimization process. ## Syntax diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md index eee9aa2821e..477002d9070 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md @@ -16,7 +16,7 @@ One way to diagnose this problem is to run **ildasm -tokens** on the object file One reason for LNK2022 is when a type (such as a struct) exists in multiple compilands with the same name, but with conflicting definitions, and when you compile with [/clr](../../build/reference/clr-common-language-runtime-compilation.md). In this case, make sure that the type has an identical definition in all compilands. The type name is listed in `error_message`. -Another possible cause for LNK2022 is when the linker finds a metadata file in a different location than was specified to the compiler (with [#using](../../preprocessor/hash-using-directive-cpp.md) ). Make sure that the metadata file (.dll or .netmodule) is in the same location when passed to the linker, as it was when it was passed to the compiler. +Another possible cause for LNK2022 is when the linker finds a metadata file in a different location than was specified to the compiler (with [#using](../../preprocessor/hash-using-directive-cpp.md)). Make sure that the metadata file (.dll or .netmodule) is in the same location when passed to the linker, as it was when it was passed to the compiler. When building an ATL application, the use of the macro `_ATL_MIXED` is required in all compilands, if it is used in at least one. From 036f251ffd0e583f2b2473374eca99ca9660e47d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 21:24:00 +0800 Subject: [PATCH 1047/1799] Update metadata in 5 topics --- docs/build/reference/fpcvt.md | 2 +- docs/build/reference/ln-create-msil-module.md | 4 ++-- docs/build/reference/midl-property-pages.md | 5 ++--- .../pgd-specify-database-for-profile-guided-optimizations.md | 2 +- .../error-messages/tool-errors/linker-tools-error-lnk2022.md | 5 ++--- 5 files changed, 8 insertions(+), 10 deletions(-) diff --git a/docs/build/reference/fpcvt.md b/docs/build/reference/fpcvt.md index 5e644c5c7da..85446ad72e1 100644 --- a/docs/build/reference/fpcvt.md +++ b/docs/build/reference/fpcvt.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: /fpcvt (Floating-point to integer conversion compatibility)" title: "/fpcvt (Floating-point to unsigned integer conversion compatibility)" +description: "Learn more about: /fpcvt (Floating-point to integer conversion compatibility)" ms.date: 11/03/2021 f1_keywords: ["/fpcvt", "-fpcvt"] helpviewer_keywords: ["-fpcvt compiler option [C++]", "/fpcvt compiler option [C++]"] diff --git a/docs/build/reference/ln-create-msil-module.md b/docs/build/reference/ln-create-msil-module.md index b8a545e5546..4ec40b38bd7 100644 --- a/docs/build/reference/ln-create-msil-module.md +++ b/docs/build/reference/ln-create-msil-module.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: /LN (Create MSIL Module)" title: "/LN (Create MSIL Module)" -ms.date: "11/04/2016" +description: "Learn more about: /LN (Create MSIL Module)" +ms.date: 11/04/2016 f1_keywords: ["/LN"] helpviewer_keywords: ["-LN compiler option [C++]", "/LN compiler option [C++]"] --- diff --git a/docs/build/reference/midl-property-pages.md b/docs/build/reference/midl-property-pages.md index 5c7d64e42e7..73d39a260e2 100644 --- a/docs/build/reference/midl-property-pages.md +++ b/docs/build/reference/midl-property-pages.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: MIDL Property Pages" title: "MIDL Compiler Property Pages" -ms.date: "07/24/2019" +description: "Learn more about: MIDL Property Pages" +ms.date: 07/24/2019 ms.topic: "article" -ms.assetid: 57498a01-fccc-4a0e-a036-6ff702f83126 f1_keywords: - VC.Project.VCMidlTool.PreprocessorDefinitions - VC.Project.VCMidlTool.AdditionalIncludeDirectories diff --git a/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md b/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md index d8461ded773..746755ec18f 100644 --- a/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md +++ b/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: /PGD (Specify Database for Profile-Guided Optimizations)" title: "/PGD (Specify Database for Profile-Guided Optimizations)" +description: "Learn more about: /PGD (Specify Database for Profile-Guided Optimizations)" ms.date: 03/24/2025 f1_keywords: ["VC.Project.VCLinkerTool.ProfileGuidedDatabase"] helpviewer_keywords: ["-PGD linker option", "/PGD linker option"] diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md index 477002d9070..56c9f16627b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2022" title: "Linker Tools Error LNK2022" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2022" +ms.date: 11/04/2016 f1_keywords: ["LNK2022"] helpviewer_keywords: ["LNK2022"] -ms.assetid: d2128c73-dde3-4b8e-a9b2-0a153acefb3b --- # Linker Tools Error LNK2022 From fbf2609c3fc5189153b3e129e3567b60015b9c8f Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 21:36:40 +0800 Subject: [PATCH 1048/1799] Add blockquotes for warning messages in range [C4621, C4660] --- .../compiler-warnings/compiler-warning-level-1-c4621.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4624.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4628.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4630.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4631.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4632.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4650.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4651.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4652.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4656.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4657.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4659.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4653.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4622.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4633.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4635.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4636.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4637.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4640.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4641.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4645.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4646.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4625.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4626.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4629.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4634.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4639.md | 2 +- 27 files changed, 27 insertions(+), 27 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md index 575f6c2d426..e255746972e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md @@ -8,7 +8,7 @@ ms.assetid: 40931bd9-cb89-497e-86f0-cec9f016c63c --- # Compiler Warning (level 1) C4621 -no postfix form of 'operator --' found for type 'type', using prefix form +> no postfix form of 'operator --' found for type 'type', using prefix form There was no postfix decrement operator defined for the given type. The compiler used the overloaded prefix operator. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md index 977cd630768..a6613e703bc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md @@ -8,7 +8,7 @@ ms.assetid: 14f61769-d92e-482b-9515-debd87b30a66 --- # Compiler Warning (level 1) C4624 -'derived class' : destructor was implicitly defined as deleted because a base class destructor is inaccessible or deleted +> 'derived class' : destructor was implicitly defined as deleted because a base class destructor is inaccessible or deleted A destructor was not accessible or deleted in a base class and was therefore not generated for a derived class. Any attempt to create an object of this type on the stack will cause a compiler error. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md index 98acc3132b9..022b3e5759a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md @@ -8,7 +8,7 @@ ms.assetid: 20fdc6f8-5f6a-40cc-aff8-c7ccf3d8ec26 --- # Compiler Warning (level 1) C4628 -digraphs not supported with -Ze. Character sequence 'digraph' not interpreted as alternate token for 'char' +> digraphs not supported with -Ze. Character sequence 'digraph' not interpreted as alternate token for 'char' Digraphs are not supported under [/Ze](../../build/reference/za-ze-disable-language-extensions.md). This warning will be followed by an error. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md index 3f80c7b419e..7933ab13cfa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md @@ -8,7 +8,7 @@ ms.assetid: d8926376-7acc-4fc7-8438-6f0de3468870 --- # Compiler Warning (level 1) C4630 -'symbol' : 'extern' storage class specifier illegal on member definition +> 'symbol' : 'extern' storage class specifier illegal on member definition A data member or member function is defined as **`extern`**. Members cannot be external, although entire objects can. The compiler ignores the **`extern`** keyword. The following sample generates C4630: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md index 63815b39c47..77af3a4476c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md @@ -8,6 +8,6 @@ ms.assetid: d8636ff6-29a7-4fec-b9a6-e201d121c3ca --- # Compiler Warning (level 1) C4631 -MSXML or XPath unavailable, XML document comments will not be processed. reason +> MSXML or XPath unavailable, XML document comments will not be processed. reason Your common language runtime installation did not have the necessary files to support processing doc comment. Reinstall the common language runtime. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md index eb92db81390..43a730a9963 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md @@ -8,7 +8,7 @@ ms.assetid: 9e35d205-cf21-4e34-8bd5-e1e7b0e2cdd3 --- # Compiler Warning (level 1) C4632 -XML document comment: file - access denied: reason +> XML document comment: file - access denied: reason The path to .xdc file (`file`) was not valid, and no .xdc file created. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md index 6eb867c876c..0067049701d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md @@ -8,7 +8,7 @@ ms.assetid: 3190b3e3-dcd6-4846-939b-f900ab652b2a --- # Compiler Warning (level 1) C4650 -debugging information not in precompiled header; only global symbols from the header will be available +> debugging information not in precompiled header; only global symbols from the header will be available The precompiled header file was not compiled with Microsoft symbolic debugging information. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md index ad0334aba73..6d8c55a2514 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md @@ -8,7 +8,7 @@ ms.assetid: f1ea82aa-4dc1-4972-b55a-57fdb962f0dd --- # Compiler Warning (level 1) C4651 -'definition' specified for precompiled header but not for current compile +> 'definition' specified for precompiled header but not for current compile The definition was specified when the precompiled header was generated, but not in this compilation. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md index b8130b1bd48..086cfb47fdc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md @@ -8,7 +8,7 @@ ms.assetid: 2cf2c666-8cdd-4dd9-bda0-662921498b03 --- # Compiler Warning (level 1) C4652 -compiler option 'option' inconsistent with precompiled header; current command-line option will override that defined in the precompiled header +> compiler option 'option' inconsistent with precompiled header; current command-line option will override that defined in the precompiled header The given command-line option differed from that given when the precompiled header (.pch) was created. The option specified in the current command line was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md index 4d7a41a0736..1c9a80362ee 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md @@ -8,7 +8,7 @@ ms.assetid: b5aaef74-2320-4345-a6ae-b813881a491c --- # Compiler Warning (level 1) C4656 -'symbol' : data type is new or has changed since the last build, or is defined differently elsewhere +> 'symbol' : data type is new or has changed since the last build, or is defined differently elsewhere You added or changed a data type, making it new to your source code since the last successful build. Edit and Continue does not support changes to existing data types. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md index 2fe16f7f35d..9d6c51bb979 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md @@ -8,7 +8,7 @@ ms.assetid: eb750050-cea6-4ead-b80c-d5dcd4971cfc --- # Compiler Warning (level 1) C4657 -expression involves a data type that is new since the last build +> expression involves a data type that is new since the last build You added or changed a data type, making it new to your source code since the last successful build. Edit and Continue does not support changes to existing data types. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md index 88e61092e69..53316d9adb0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md @@ -8,7 +8,7 @@ ms.assetid: e29ba8db-7917-43f6-8e34-868b752279ae --- # Compiler Warning (level 1) C4659 -\#pragma 'pragma' : use of reserved segment 'segment' has undefined behavior, use #pragma comment(linker, ...) +> #pragma 'pragma' : use of reserved segment 'segment' has undefined behavior, use #pragma comment(linker, ...) The .drectve option was used to pass an option to the linker. Instead use pragma [comment](../../preprocessor/comment-c-cpp.md) for passing a linker option. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md index f731d8824bb..5f667b2d121 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md @@ -8,7 +8,7 @@ ms.assetid: 90ec3317-3d39-4b4c-bcd1-97e7c799e1b6 --- # Compiler Warning (level 2) C4653 -compiler option 'option' inconsistent with precompiled header; current command-line option ignored +> compiler option 'option' inconsistent with precompiled header; current command-line option ignored An option specified with the Use Precompiled Headers ([/Yu](../../build/reference/yu-use-precompiled-header-file.md)) option was inconsistent with the options specified when the precompiled header was created. This compilation used the option specified when the precompiled header was created. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md index 2a33076a976..b91ef08b4f9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md @@ -8,7 +8,7 @@ ms.assetid: d3c879f0-4492-4f4b-b26d-230993f3a933 --- # Compiler Warning (level 3) C4622 -Overwriting debug information formed during creation of the precompiled header in object file: 'file' +> Overwriting debug information formed during creation of the precompiled header in object file: 'file' CodeView information in the specified file was lost when it was compiled with the [/Yu](../../build/reference/yu-use-precompiled-header-file.md) (Use Precompiled Headers) option. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md index 8a008df2686..9e59d51e989 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md @@ -8,7 +8,7 @@ ms.assetid: 6d76f268-ba8c-448b-8e83-b903a18b583b --- # Compiler Warning (level 3) C4633 -XML document comment target: error: reason +> XML document comment target: error: reason A name passed to the [\](../../build/reference/param-visual-cpp.md) tag was not found by the compiler. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md index dec16024a92..a4b7510ed82 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md @@ -8,7 +8,7 @@ ms.assetid: b2ba90de-c093-4a76-8076-b65878467574 --- # Compiler Warning (level 3) C4635 -XML document comment target: badly-formed XML: reason +> XML document comment target: badly-formed XML: reason The compiler found some problem with the XML tags. Fix the problem and recompile diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md index 4591d9dcc8a..493eb8082e1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md @@ -8,7 +8,7 @@ ms.assetid: 59112a0f-850f-41c6-bd84-8ae8dc84706a --- # Compiler Warning (level 3) C4636 -XML document comment applied to 'construct': tag requires non-empty '' attribute. +> XML document comment applied to 'construct': tag requires non-empty '' attribute. A tag, such as `cref`, did not have a value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md index 3617d5b4ace..09a7b5cd8de 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md @@ -8,7 +8,7 @@ ms.assetid: 5fd347c1-2de9-408f-9136-1bf1ff273622 --- # Compiler Warning (level 3) C4637 -XML document comment target: \ tag discarded. reason +> XML document comment target: \ tag discarded. reason The syntax of an [\](../../build/reference/include-visual-cpp.md) tag was not correct. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md index 99e0026cb1a..302706dac17 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md @@ -8,7 +8,7 @@ ms.assetid: f76871f6-e436-4c35-9793-d2f22f7e1c7f --- # Compiler Warning (level 3) C4640 -'instance' : construction of local static object is not thread-safe +> 'instance' : construction of local static object is not thread-safe A static instance of an object is not thread safe. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md index 86cf77948f0..2b14a15fbca 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md @@ -8,7 +8,7 @@ ms.assetid: 28fe5c3e-6039-42da-9100-1312b5b15aea --- # Compiler Warning (level 3) C4641 -XML document comment has an ambiguous cross reference +> XML document comment has an ambiguous cross reference The compiler was unable to unambiguously resolve a reference. To resolve this warning, specify the parameter information necessary to make the reference unambiguous. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md index 278a1ffe4c4..233c1231248 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md @@ -8,7 +8,7 @@ ms.assetid: fd7c1ddf-f0d0-4e10-bab9-ccb4c3476298 --- # Compiler Warning (level 3) C4645 -function declared with __declspec(noreturn) has a return statement +> function declared with __declspec(noreturn) has a return statement A [return](../../cpp/program-termination.md) statement was found in a function that is marked with the [noreturn](../../cpp/noreturn.md) **`__declspec`** modifier. The **`return`** statement was ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md index 427f282b514..b6e22f876da 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md @@ -8,7 +8,7 @@ ms.assetid: 23677e8e-603e-40e0-b99a-2e4894a1278e --- # Compiler Warning (level 3) C4646 -function declared with __declspec(noreturn) has non-void return type +> function declared with __declspec(noreturn) has non-void return type A function marked with the [noreturn](../../cpp/noreturn.md) **`__declspec`** modifier should have a [void](../../cpp/void-cpp.md) return type. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md index 769736cbd7b..25126e27485 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md @@ -8,7 +8,7 @@ ms.assetid: 4cc99e50-846c-4784-97da-48b977067851 --- # Compiler Warning (level 4) C4625 -'derived class' : copy constructor was implicitly defined as deleted because a base class copy constructor is inaccessible or deleted +> 'derived class' : copy constructor was implicitly defined as deleted because a base class copy constructor is inaccessible or deleted A copy constructor was deleted or not accessible in a base class and was therefore not generated for a derived class. Any attempt to copy an object of this type will cause a compiler error. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md index 277e3e6f834..2f9a47e324c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4626"] --- # Compiler Warning (level 4) C4626 -'derived class' : assignment operator was implicitly defined as deleted because a base class assignment operator is inaccessible or deleted +> 'derived class' : assignment operator was implicitly defined as deleted because a base class assignment operator is inaccessible or deleted An assignment operator was deleted or not accessible in a base class and was therefore not generated for a derived class. Any attempt to assign objects of this type will cause a compiler error. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md index 31618dd3700..9df628c91c1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md @@ -8,7 +8,7 @@ ms.assetid: 158cde12-bae5-4d43-b575-b52b35aaa0b9 --- # Compiler Warning (level 4) C4629 -digraph used, character sequence 'digraph' interpreted as token 'char' (insert a space between the two characters if this is not what you intended) +> digraph used, character sequence 'digraph' interpreted as token 'char' (insert a space between the two characters if this is not what you intended) Under [/Za](../../build/reference/za-ze-disable-language-extensions.md), the compiler warns when it detects a digraph. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md index 9b1ac75158a..7a5ffd8074a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md @@ -8,7 +8,7 @@ ms.assetid: 3e3496ce-2ac7-43d0-a48a-f514c950e81d --- # Compiler Warning (level 4) C4634 -XML document comment: cannot be applied: reason +> XML document comment: cannot be applied: reason XML documentation tags can not be applied to all C++ constructs. For example, you cannot add a documentation comment to a namespace or template. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md index 8d5ddea0f74..87bb7983ddb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md @@ -8,7 +8,7 @@ ms.assetid: f94f7392-cdbb-4bf4-8a00-20dc90d3efe9 --- # Compiler Warning (level 4) C4639 -MSXML error, XML document comments will not be processed. reason +> MSXML error, XML document comments will not be processed. reason This warning can occur for any number of reasons. From 04a77701c22870f622deaac93cb6a76ded69b516 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 21:43:19 +0800 Subject: [PATCH 1049/1799] Add "Remarks" and "Example" headings for warning references in range [C4621, C4660] --- .../compiler-warnings/compiler-warning-level-1-c4621.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4624.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4627.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4628.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4630.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4631.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4632.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4650.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4651.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4652.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4656.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4657.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4659.md | 4 ++++ .../compiler-warnings/compiler-warning-level-2-c4653.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4622.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4633.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4635.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4636.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4637.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4640.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4641.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4645.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4646.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4623.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4625.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4626.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4629.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4634.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4639.md | 2 ++ 29 files changed, 89 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md index e255746972e..3b5ea0bb3c2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md @@ -10,8 +10,12 @@ ms.assetid: 40931bd9-cb89-497e-86f0-cec9f016c63c > no postfix form of 'operator --' found for type 'type', using prefix form +## Remarks + There was no postfix decrement operator defined for the given type. The compiler used the overloaded prefix operator. +## Example + This warning can be avoided by defining a postfix `--` operator. Create a two-argument version of the `--` operator as shown below: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md index a6613e703bc..96a98649128 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md @@ -10,8 +10,12 @@ ms.assetid: 14f61769-d92e-482b-9515-debd87b30a66 > 'derived class' : destructor was implicitly defined as deleted because a base class destructor is inaccessible or deleted +## Remarks + A destructor was not accessible or deleted in a base class and was therefore not generated for a derived class. Any attempt to create an object of this type on the stack will cause a compiler error. +## Example + The following sample generates C4624 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md index d8e7bfaf5d0..113514595f9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md @@ -10,6 +10,8 @@ ms.assetid: 8840f3e6-b496-423a-8635-eb55d5f854a2 > '*header_file*': skipped when looking for precompiled header use +## Remarks + If the current source file has the [/Yu \(Use precompiled header file)](../../build/reference/yu-use-precompiled-header-file.md) option set, then the compiler ignores everything in the file before the precompiled header is included. Warning **C4627** is generated in Visual Studio 2015 and earlier versions if *header_file* is included before the precompiled header file, and if the precompiled header does not also include *header_file*. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md index 022b3e5759a..9bc3b0e82d0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md @@ -10,10 +10,14 @@ ms.assetid: 20fdc6f8-5f6a-40cc-aff8-c7ccf3d8ec26 > digraphs not supported with -Ze. Character sequence 'digraph' not interpreted as alternate token for 'char' +## Remarks + Digraphs are not supported under [/Ze](../../build/reference/za-ze-disable-language-extensions.md). This warning will be followed by an error. 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 C4628: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md index 7933ab13cfa..e505afb847c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md @@ -10,7 +10,13 @@ ms.assetid: d8926376-7acc-4fc7-8438-6f0de3468870 > 'symbol' : 'extern' storage class specifier illegal on member definition -A data member or member function is defined as **`extern`**. Members cannot be external, although entire objects can. The compiler ignores the **`extern`** keyword. The following sample generates C4630: +## Remarks + +A data member or member function is defined as **`extern`**. Members cannot be external, although entire objects can. The compiler ignores the **`extern`** keyword. + +## Example + +The following sample generates C4630: ```cpp // C4630.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md index 77af3a4476c..917ed8abc8a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md @@ -10,4 +10,6 @@ ms.assetid: d8636ff6-29a7-4fec-b9a6-e201d121c3ca > MSXML or XPath unavailable, XML document comments will not be processed. reason +## Remarks + Your common language runtime installation did not have the necessary files to support processing doc comment. Reinstall the common language runtime. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md index 43a730a9963..fdafb4e829a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md @@ -10,8 +10,12 @@ ms.assetid: 9e35d205-cf21-4e34-8bd5-e1e7b0e2cdd3 > XML document comment: file - access denied: reason +## Remarks + The path to .xdc file (`file`) was not valid, and no .xdc file created. +## Example + The following sample generates C4632: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md index 0067049701d..a1c6fb2726b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md @@ -10,6 +10,8 @@ ms.assetid: 3190b3e3-dcd6-4846-939b-f900ab652b2a > debugging information not in precompiled header; only global symbols from the header will be available +## Remarks + The precompiled header file was not compiled with Microsoft symbolic debugging information. When linked, the resulting executable or dynamic-link library file will not include debugging information for local symbols contained in the precompiled header. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md index 6d8c55a2514..0805b2bc904 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md @@ -10,6 +10,8 @@ ms.assetid: f1ea82aa-4dc1-4972-b55a-57fdb962f0dd > 'definition' specified for precompiled header but not for current compile +## Remarks + The definition was specified when the precompiled header was generated, but not in this compilation. The definition will be in effect inside the precompiled header, but not in the rest of the code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md index 086cfb47fdc..75bceeb458b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md @@ -10,6 +10,8 @@ ms.assetid: 2cf2c666-8cdd-4dd9-bda0-662921498b03 > compiler option 'option' inconsistent with precompiled header; current command-line option will override that defined in the precompiled header +## Remarks + The given command-line option differed from that given when the precompiled header (.pch) was created. The option specified in the current command line was used. This warning can be avoided by regenerating the precompiled header with the given command-line option. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md index 1c9a80362ee..e21fd07f60a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md @@ -10,6 +10,8 @@ ms.assetid: b5aaef74-2320-4345-a6ae-b813881a491c > 'symbol' : data type is new or has changed since the last build, or is defined differently elsewhere +## Remarks + You added or changed a data type, making it new to your source code since the last successful build. Edit and Continue does not support changes to existing data types. This warning will always be followed by [Fatal Error C1092](../../error-messages/compiler-errors-1/fatal-error-c1092.md). For further information, see the [Supported Code Changes](/visualstudio/debugger/supported-code-changes-cpp). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md index 9d6c51bb979..6056fb6201f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md @@ -10,6 +10,8 @@ ms.assetid: eb750050-cea6-4ead-b80c-d5dcd4971cfc > expression involves a data type that is new since the last build +## Remarks + You added or changed a data type, making it new to your source code since the last successful build. Edit and Continue does not support changes to existing data types. This warning will always be followed by [Fatal Error C1092](../../error-messages/compiler-errors-1/fatal-error-c1092.md). For further information, see the [Supported Code Changes](/visualstudio/debugger/supported-code-changes-cpp). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md index 53316d9adb0..61dcf3e945d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md @@ -10,8 +10,12 @@ ms.assetid: e29ba8db-7917-43f6-8e34-868b752279ae > #pragma 'pragma' : use of reserved segment 'segment' has undefined behavior, use #pragma comment(linker, ...) +## Remarks + The .drectve option was used to pass an option to the linker. Instead use pragma [comment](../../preprocessor/comment-c-cpp.md) for passing a linker option. +## Example + ```cpp // C4659.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md index 5f667b2d121..ec238dc0aca 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md @@ -10,6 +10,8 @@ ms.assetid: 90ec3317-3d39-4b4c-bcd1-97e7c799e1b6 > compiler option 'option' inconsistent with precompiled header; current command-line option ignored +## Remarks + An option specified with the Use Precompiled Headers ([/Yu](../../build/reference/yu-use-precompiled-header-file.md)) option was inconsistent with the options specified when the precompiled header was created. This compilation used the option specified when the precompiled header was created. This warning can occur when a different value for the Pack Structures option ([/Zp](../../build/reference/zp-struct-member-alignment.md)) was specified during compilation of the precompiled header. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md index b91ef08b4f9..e91c002bd56 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md @@ -10,6 +10,8 @@ ms.assetid: d3c879f0-4492-4f4b-b26d-230993f3a933 > Overwriting debug information formed during creation of the precompiled header in object file: 'file' +## Remarks + CodeView information in the specified file was lost when it was compiled with the [/Yu](../../build/reference/yu-use-precompiled-header-file.md) (Use Precompiled Headers) option. Rename the object file (using [/Fo](../../build/reference/fo-object-file-name.md)) when creating or using the precompiled header file, and link using the new object file. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md index 9e59d51e989..ccf058bb19a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md @@ -10,8 +10,12 @@ ms.assetid: 6d76f268-ba8c-448b-8e83-b903a18b583b > XML document comment target: error: reason +## Remarks + A name passed to the [\](../../build/reference/param-visual-cpp.md) tag was not found by the compiler. +## Example + The following sample generates C4633: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md index a4b7510ed82..b68413cfba2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md @@ -10,8 +10,12 @@ ms.assetid: b2ba90de-c093-4a76-8076-b65878467574 > XML document comment target: badly-formed XML: reason +## Remarks + The compiler found some problem with the XML tags. Fix the problem and recompile +## Example + The following sample generates C4635: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md index 493eb8082e1..6f400e9a093 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md @@ -10,6 +10,8 @@ ms.assetid: 59112a0f-850f-41c6-bd84-8ae8dc84706a > XML document comment applied to 'construct': tag requires non-empty '' attribute. +## Remarks + A tag, such as `cref`, did not have a value. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md index 09a7b5cd8de..57aa3445964 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md @@ -10,8 +10,12 @@ ms.assetid: 5fd347c1-2de9-408f-9136-1bf1ff273622 > XML document comment target: \ tag discarded. reason +## Remarks + The syntax of an [\](../../build/reference/include-visual-cpp.md) tag was not correct. +## Example + The following sample generates C4637: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md index 302706dac17..8cf28a2327f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md @@ -10,10 +10,14 @@ ms.assetid: f76871f6-e436-4c35-9793-d2f22f7e1c7f > 'instance' : construction of local static object is not thread-safe +## Remarks + A static instance of an object is not thread safe. 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 C4640: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md index 2b14a15fbca..ecb11aed7b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md @@ -10,6 +10,8 @@ ms.assetid: 28fe5c3e-6039-42da-9100-1312b5b15aea > XML document comment has an ambiguous cross reference +## Remarks + The compiler was unable to unambiguously resolve a reference. To resolve this warning, specify the parameter information necessary to make the reference unambiguous. For more information, see [XML Documentation](../../build/reference/xml-documentation-visual-cpp.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md index 233c1231248..3e7eca026d2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md @@ -10,8 +10,12 @@ ms.assetid: fd7c1ddf-f0d0-4e10-bab9-ccb4c3476298 > function declared with __declspec(noreturn) has a return statement +## Remarks + A [return](../../cpp/program-termination.md) statement was found in a function that is marked with the [noreturn](../../cpp/noreturn.md) **`__declspec`** modifier. The **`return`** statement was ignored. +## Example + The following sample generates C4645: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md index b6e22f876da..309fc321a63 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md @@ -10,8 +10,12 @@ ms.assetid: 23677e8e-603e-40e0-b99a-2e4894a1278e > function declared with __declspec(noreturn) has non-void return type +## Remarks + A function marked with the [noreturn](../../cpp/noreturn.md) **`__declspec`** modifier should have a [void](../../cpp/void-cpp.md) return type. +## Example + The following sample generates C4646: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md index 012e0513849..5e823215a80 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md @@ -10,6 +10,8 @@ ms.assetid: e630d8d0-f6ea-469c-a74f-07b027587225 > '`derived class`' : default constructor was implicitly defined as deleted +## Remarks + Because the default constructor is deleted or inaccessible in a base class, the compiler can't generate a default constructor for the derived class. Attempts to create an object of this type by using the default constructor (for example, in an array) cause a compiler error. 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). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md index 25126e27485..0ebadcaf880 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md @@ -10,6 +10,8 @@ ms.assetid: 4cc99e50-846c-4784-97da-48b977067851 > 'derived class' : copy constructor was implicitly defined as deleted because a base class copy constructor is inaccessible or deleted +## Remarks + A copy constructor was deleted or not accessible in a base class and was therefore not generated for a derived class. Any attempt to copy an object of this type will cause a compiler error. 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-c4626.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md index 2f9a47e324c..a15f46c4c6c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4626"] > 'derived class' : assignment operator was implicitly defined as deleted because a base class assignment operator is inaccessible or deleted +## Remarks + An assignment operator was deleted or not accessible in a base class and was therefore not generated for a derived class. Any attempt to assign objects of this type will cause a compiler error. 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 C4626 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md index 9df628c91c1..047e01368db 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md @@ -10,8 +10,12 @@ ms.assetid: 158cde12-bae5-4d43-b575-b52b35aaa0b9 > digraph used, character sequence 'digraph' interpreted as token 'char' (insert a space between the two characters if this is not what you intended) +## Remarks + Under [/Za](../../build/reference/za-ze-disable-language-extensions.md), the compiler warns when it detects a digraph. +## Example + The following sample generates C4629: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md index 7a5ffd8074a..9d8fa237b40 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md @@ -10,6 +10,8 @@ ms.assetid: 3e3496ce-2ac7-43d0-a48a-f514c950e81d > XML document comment: cannot be applied: reason +## Remarks + XML documentation tags can not be applied to all C++ constructs. For example, you cannot add a documentation comment to a namespace or template. For more information, see [XML Documentation](../../build/reference/xml-documentation-visual-cpp.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md index 87bb7983ddb..95e01172ac2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md @@ -10,6 +10,8 @@ ms.assetid: f94f7392-cdbb-4bf4-8a00-20dc90d3efe9 > MSXML error, XML document comments will not be processed. reason +## Remarks + This warning can occur for any number of reasons. To resolve this warning: From 8a22f62d2c61625b3ca42426ccfe10612cc4593d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 21:44:55 +0800 Subject: [PATCH 1050/1799] Replace term "sample" with "example" for warning references in range [C4621, C4660] --- .../compiler-warnings/compiler-warning-level-1-c4624.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4627.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4628.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4630.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4632.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4633.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4635.md | 6 +++--- .../compiler-warnings/compiler-warning-level-3-c4636.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4637.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4638.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4640.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4641.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4645.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4646.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4623.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4625.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4626.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4629.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4634.md | 4 ++-- 19 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md index 96a98649128..6aafd0ec335 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md @@ -16,7 +16,7 @@ A destructor was not accessible or deleted in a base class and was therefore not ## Example -The following sample generates C4624 and shows how to fix it: +The following example generates C4624 and shows how to fix it: ```cpp // C4624.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md index 113514595f9..00f27e72632 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md @@ -16,7 +16,7 @@ If the current source file has the [/Yu \(Use precompiled header file)](../../bu ## Example -This sample demonstrates how the error can occur, and shows how to fix it: +This example demonstrates how the error can occur, and shows how to fix it: ```cpp // c4627.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md index 9bc3b0e82d0..20fc41a8db3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4628: +The following example generates C4628: ```cpp // C4628.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md index e505afb847c..0131b12b787 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md @@ -16,7 +16,7 @@ A data member or member function is defined as **`extern`**. Members cannot be e ## Example -The following sample generates C4630: +The following example generates C4630: ```cpp // C4630.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md index fdafb4e829a..9513c7ec5ee 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md @@ -16,7 +16,7 @@ The path to .xdc file (`file`) was not valid, and no .xdc file created. ## Example -The following sample generates C4632: +The following example generates C4632: ```cpp // C4632.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md index ccf058bb19a..7a982a390b0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md @@ -16,7 +16,7 @@ A name passed to the [\](../../build/reference/param-visual-cpp.md) tag w ## Example -The following sample generates C4633: +The following example generates C4633: ```cpp // C4633.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md index b68413cfba2..98c13db6004 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md @@ -16,7 +16,7 @@ The compiler found some problem with the XML tags. Fix the problem and recompil ## Example -The following sample generates C4635: +The following example generates C4635: ```cpp // C4635.cpp @@ -30,6 +30,6 @@ The following sample generates C4635: public ref class Test {}; ``` -Notice that the output for this sample says: **End tag 'member' does not match the start tag 'summary'.** +Notice that the output for this example says: **End tag 'member' does not match the start tag 'summary'.** -The problem with this sample is that the end tag for \

is poorly formed, and the compiler does not recognize it as the \ end tag. The \ tag is embedded in the .xdc file by the compiler in every /doc compilation. So, the problem here is that the end tag \, does not match the previous start tag that the compiler processed (\. +The problem with this example is that the end tag for \ is poorly formed, and the compiler does not recognize it as the \ end tag. The \ tag is embedded in the .xdc file by the compiler in every /doc compilation. So, the problem here is that the end tag \, does not match the previous start tag that the compiler processed (\. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md index 6f400e9a093..ffc0af62e07 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md @@ -16,7 +16,7 @@ A tag, such as `cref`, did not have a value. ## Example -The following sample generates C4636. +The following example generates C4636. ```cpp // C4636.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md index 57aa3445964..c0f18b75d4c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md @@ -16,7 +16,7 @@ The syntax of an [\](../../build/reference/include-visual-cpp.md) tag w ## Example -The following sample generates C4637: +The following example generates C4637: ```cpp // C4637.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md index cbe5cbcc601..65e395aa583 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md @@ -16,7 +16,7 @@ The compiler was unable to resolve a symbol (*symbol*). The symbol must be valid ## Example -The following sample generates C4638: +The following example generates C4638: ```cpp // C4638.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md index 8cf28a2327f..a5088512b80 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4640: +The following example generates C4640: ```cpp // C4640.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md index ecb11aed7b8..3c5ac9f5038 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md @@ -18,7 +18,7 @@ For more information, see [XML Documentation](../../build/reference/xml-document ## Example -The following sample generates C4641. +The following example generates C4641. ```cpp // C4641.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md index 3e7eca026d2..6c61c73bbc4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md @@ -16,7 +16,7 @@ A [return](../../cpp/program-termination.md) statement was found in a function t ## Example -The following sample generates C4645: +The following example generates C4645: ```cpp // C4645.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md index 309fc321a63..08538b4d9ed 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md @@ -16,7 +16,7 @@ A function marked with the [noreturn](../../cpp/noreturn.md) **`__declspec`** mo ## Example -The following sample generates C4646: +The following example generates C4646: ```cpp // C4646.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md index 5e823215a80..eff490bde6e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md @@ -18,7 +18,7 @@ This warning is off by default. For more information, see [Compiler warnings tha ## Example -The following sample generates C4623. +The following example generates C4623. ```cpp // C4623.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md index 0ebadcaf880..4bf21870b75 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4625 and shows how to fix it. +The following example generates C4625 and shows how to fix it. ```cpp // C4625.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md index a15f46c4c6c..7115d1f328a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md @@ -17,7 +17,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4626 and shows how to fix it: +The following example generates C4626 and shows how to fix it: ```cpp // C4626 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md index 047e01368db..a6257f70ce9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md @@ -16,7 +16,7 @@ Under [/Za](../../build/reference/za-ze-disable-language-extensions.md), the com ## Example -The following sample generates C4629: +The following example generates C4629: ```cpp // C4629.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md index 9d8fa237b40..be8b53e9d55 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md @@ -18,7 +18,7 @@ For more information, see [XML Documentation](../../build/reference/xml-document ## Examples -The following sample generates C4634. +The following example generates C4634. ```cpp // C4634.cpp @@ -29,7 +29,7 @@ namespace hello { }; ``` -The following sample generates C4634. +The following example generates C4634. ```cpp // C4634_b.cpp From e9677260f82fd86ae4b1cad7989225c5e7389967 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 21:49:38 +0800 Subject: [PATCH 1051/1799] Update metadata for warning references in range [C4621, C4660] --- .../compiler-warnings/compiler-warning-level-1-c4621.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4624.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4627.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4628.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4630.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4631.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4632.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4650.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4651.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4652.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4655.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4656.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4657.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4659.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4653.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4622.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4633.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4635.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4636.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4637.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4638.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4640.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4641.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4645.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4646.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4623.md | 3 +-- .../compiler-warnings/compiler-warning-level-4-c4625.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4629.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4634.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4639.md | 5 ++--- 30 files changed, 59 insertions(+), 89 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md index 3b5ea0bb3c2..f32fce06aad 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4621" title: "Compiler Warning (level 1) C4621" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4621" +ms.date: 11/04/2016 f1_keywords: ["C4621"] helpviewer_keywords: ["C4621"] -ms.assetid: 40931bd9-cb89-497e-86f0-cec9f016c63c --- # Compiler Warning (level 1) C4621 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md index 6aafd0ec335..d3bb234530d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4624" title: "Compiler Warning (level 1) C4624" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4624" +ms.date: 11/04/2016 f1_keywords: ["C4624"] helpviewer_keywords: ["C4624"] -ms.assetid: 14f61769-d92e-482b-9515-debd87b30a66 --- # Compiler Warning (level 1) C4624 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md index 00f27e72632..6689bdba0b9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4627" title: "Compiler Warning (level 1) C4627" -ms.date: "09/09/2018" +description: "Learn more about: Compiler Warning (level 1) C4627" +ms.date: 09/09/2018 f1_keywords: ["C4627"] helpviewer_keywords: ["C4627"] -ms.assetid: 8840f3e6-b496-423a-8635-eb55d5f854a2 --- # Compiler Warning (level 1) C4627 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md index 20fc41a8db3..e66578e986d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4628" title: "Compiler Warning (level 1) C4628" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4628" +ms.date: 11/04/2016 f1_keywords: ["C4628"] helpviewer_keywords: ["C4628"] -ms.assetid: 20fdc6f8-5f6a-40cc-aff8-c7ccf3d8ec26 --- # Compiler Warning (level 1) C4628 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md index 0131b12b787..43df3fea625 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4630" title: "Compiler Warning (level 1) C4630" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4630" +ms.date: 11/04/2016 f1_keywords: ["C4630"] helpviewer_keywords: ["C4630"] -ms.assetid: d8926376-7acc-4fc7-8438-6f0de3468870 --- # Compiler Warning (level 1) C4630 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md index 917ed8abc8a..894e783d2c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4631" title: "Compiler Warning (level 1) C4631" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4631" +ms.date: 11/04/2016 f1_keywords: ["C4631"] helpviewer_keywords: ["C4631"] -ms.assetid: d8636ff6-29a7-4fec-b9a6-e201d121c3ca --- # Compiler Warning (level 1) C4631 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md index 9513c7ec5ee..7d4b05da68b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4632" title: "Compiler Warning (level 1) C4632" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4632" +ms.date: 11/04/2016 f1_keywords: ["C4632"] helpviewer_keywords: ["C4632"] -ms.assetid: 9e35d205-cf21-4e34-8bd5-e1e7b0e2cdd3 --- # Compiler Warning (level 1) C4632 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md index a1c6fb2726b..ded99d3b702 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4650" title: "Compiler Warning (level 1) C4650" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4650" +ms.date: 11/04/2016 f1_keywords: ["C4650"] helpviewer_keywords: ["C4650"] -ms.assetid: 3190b3e3-dcd6-4846-939b-f900ab652b2a --- # Compiler Warning (level 1) C4650 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md index 0805b2bc904..34a4d06f1e6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4651" title: "Compiler Warning (level 1) C4651" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4651" +ms.date: 11/04/2016 f1_keywords: ["C4651"] helpviewer_keywords: ["C4651"] -ms.assetid: f1ea82aa-4dc1-4972-b55a-57fdb962f0dd --- # Compiler Warning (level 1) C4651 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md index 75bceeb458b..a70abbd28b7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4652" title: "Compiler Warning (level 1) C4652" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4652" +ms.date: 11/04/2016 f1_keywords: ["C4652"] helpviewer_keywords: ["C4652"] -ms.assetid: 2cf2c666-8cdd-4dd9-bda0-662921498b03 --- # Compiler Warning (level 1) C4652 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4655.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4655.md index 7a3e26979a8..f8d307ae981 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4655.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4655.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4655" title: "Compiler Warning (level 1) C4655" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4655" +ms.date: 08/27/2018 f1_keywords: ["C4655"] helpviewer_keywords: ["C4655"] -ms.assetid: 540f2c7a-e4a1-49af-84b4-03eeea1bbf41 --- # Compiler Warning (level 1) C4655 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md index e21fd07f60a..cf56b54f864 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4656" title: "Compiler Warning (level 1) C4656" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4656" +ms.date: 11/04/2016 f1_keywords: ["C4656"] helpviewer_keywords: ["C4656"] -ms.assetid: b5aaef74-2320-4345-a6ae-b813881a491c --- # Compiler Warning (level 1) C4656 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md index 6056fb6201f..2122b6d551a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4657" title: "Compiler Warning (level 1) C4657" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4657" +ms.date: 11/04/2016 f1_keywords: ["C4657"] helpviewer_keywords: ["C4657"] -ms.assetid: eb750050-cea6-4ead-b80c-d5dcd4971cfc --- # Compiler Warning (level 1) C4657 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md index 61dcf3e945d..8b865284082 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4659" title: "Compiler Warning (level 1) C4659" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4659" +ms.date: 11/04/2016 f1_keywords: ["C4659"] helpviewer_keywords: ["C4659"] -ms.assetid: e29ba8db-7917-43f6-8e34-868b752279ae --- # Compiler Warning (level 1) C4659 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md index ec238dc0aca..45fc49654bb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4653" title: "Compiler Warning (level 2) C4653" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4653" +ms.date: 11/04/2016 f1_keywords: ["C4653"] helpviewer_keywords: ["C4653"] -ms.assetid: 90ec3317-3d39-4b4c-bcd1-97e7c799e1b6 --- # Compiler Warning (level 2) C4653 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md index e91c002bd56..ba45d4c3827 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4622" title: "Compiler Warning (level 3) C4622" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4622" +ms.date: 11/04/2016 f1_keywords: ["C4622"] helpviewer_keywords: ["C4622"] -ms.assetid: d3c879f0-4492-4f4b-b26d-230993f3a933 --- # Compiler Warning (level 3) C4622 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md index 7a982a390b0..5767c5613aa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4633" title: "Compiler Warning (level 3) C4633" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4633" +ms.date: 11/04/2016 f1_keywords: ["C4633"] helpviewer_keywords: ["C4633"] -ms.assetid: 6d76f268-ba8c-448b-8e83-b903a18b583b --- # Compiler Warning (level 3) C4633 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md index 98c13db6004..ea7c5b80a03 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4635" title: "Compiler Warning (level 3) C4635" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4635" +ms.date: 11/04/2016 f1_keywords: ["C4635"] helpviewer_keywords: ["C4635"] -ms.assetid: b2ba90de-c093-4a76-8076-b65878467574 --- # Compiler Warning (level 3) C4635 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md index ffc0af62e07..ee0b25a5f6b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4636" title: "Compiler Warning (level 3) C4636" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4636" +ms.date: 11/04/2016 f1_keywords: ["C4636"] helpviewer_keywords: ["C4636"] -ms.assetid: 59112a0f-850f-41c6-bd84-8ae8dc84706a --- # Compiler Warning (level 3) C4636 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md index c0f18b75d4c..4426328632f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4637" title: "Compiler Warning (level 3) C4637" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4637" +ms.date: 11/04/2016 f1_keywords: ["C4637"] helpviewer_keywords: ["C4637"] -ms.assetid: 5fd347c1-2de9-408f-9136-1bf1ff273622 --- # Compiler Warning (level 3) C4637 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md index 65e395aa583..1ac1da97a49 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4638" title: "Compiler Warning (level 3) C4638" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 3) C4638" +ms.date: 08/27/2018 f1_keywords: ["C4638"] helpviewer_keywords: ["C4638"] -ms.assetid: 2c07923a-e103-4e40-bd11-fdfed428a5ec --- # Compiler Warning (level 3) C4638 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md index a5088512b80..f66a7e4ebda 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4640" title: "Compiler Warning (level 3) C4640" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4640" +ms.date: 11/04/2016 f1_keywords: ["C4640"] helpviewer_keywords: ["C4640"] -ms.assetid: f76871f6-e436-4c35-9793-d2f22f7e1c7f --- # Compiler Warning (level 3) C4640 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md index 3c5ac9f5038..5f110fcce54 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4641" title: "Compiler Warning (level 3) C4641" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4641" +ms.date: 11/04/2016 f1_keywords: ["C4641"] helpviewer_keywords: ["C4641"] -ms.assetid: 28fe5c3e-6039-42da-9100-1312b5b15aea --- # Compiler Warning (level 3) C4641 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md index 6c61c73bbc4..84ffd10a7f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4645" title: "Compiler Warning (level 3) C4645" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4645" +ms.date: 11/04/2016 f1_keywords: ["C4645"] helpviewer_keywords: ["C4645"] -ms.assetid: fd7c1ddf-f0d0-4e10-bab9-ccb4c3476298 --- # Compiler Warning (level 3) C4645 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md index 08538b4d9ed..84233c3a05e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4646" title: "Compiler Warning (level 3) C4646" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4646" +ms.date: 11/04/2016 f1_keywords: ["C4646"] helpviewer_keywords: ["C4646"] -ms.assetid: 23677e8e-603e-40e0-b99a-2e4894a1278e --- # Compiler Warning (level 3) C4646 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md index eff490bde6e..6cc61710058 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4623" title: "Compiler Warning (level 4) C4623" +description: "Learn more about: Compiler Warning (level 4) C4623" ms.date: 10/27/2022 f1_keywords: ["C4623"] helpviewer_keywords: ["C4623"] -ms.assetid: e630d8d0-f6ea-469c-a74f-07b027587225 --- # Compiler Warning (level 4) C4623 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md index 4bf21870b75..c066dbcd982 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4625" title: "Compiler Warning (level 4) C4625" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4625" +ms.date: 11/04/2016 f1_keywords: ["C4625"] helpviewer_keywords: ["C4625"] -ms.assetid: 4cc99e50-846c-4784-97da-48b977067851 --- # Compiler Warning (level 4) C4625 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md index a6257f70ce9..39e76d38d59 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4629" title: "Compiler Warning (level 4) C4629" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4629" +ms.date: 11/04/2016 f1_keywords: ["C4629"] helpviewer_keywords: ["C4629"] -ms.assetid: 158cde12-bae5-4d43-b575-b52b35aaa0b9 --- # Compiler Warning (level 4) C4629 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md index be8b53e9d55..b0eb31c8844 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4634" title: "Compiler Warning (level 4) C4634" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4634" +ms.date: 11/04/2016 f1_keywords: ["C4634"] helpviewer_keywords: ["C4634"] -ms.assetid: 3e3496ce-2ac7-43d0-a48a-f514c950e81d --- # Compiler Warning (level 4) C4634 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md index 95e01172ac2..0f952a6f795 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4639" title: "Compiler Warning (level 4) C4639" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4639" +ms.date: 11/04/2016 f1_keywords: ["C4639"] helpviewer_keywords: ["C4639"] -ms.assetid: f94f7392-cdbb-4bf4-8a00-20dc90d3efe9 --- # Compiler Warning (level 4) C4639 From 8dd6174922a353b94feedb24e27071b324705cf0 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 31 Aug 2025 21:51:01 +0800 Subject: [PATCH 1052/1799] Add leading example sentence in C4659 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4659.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md index 8b865284082..a38cf4cf7ae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md @@ -15,6 +15,8 @@ The .drectve option was used to pass an option to the linker. Instead use pragma ## Example +The following example generates C4659: + ```cpp // C4659.cpp // compile with: /W1 /LD From e0f7543706a4c97e57a523151f29ffdcb0aa6f6a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 1 Sep 2025 23:32:39 +0800 Subject: [PATCH 1053/1799] Add blockquotes for warning messages in range [C4661, C4700] --- .../compiler-warnings/compiler-warning-level-1-c4661.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4662.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4667.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4669.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4674.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4677.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4678.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4684.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4685.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4688.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4691.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4692.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4668.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4670.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4672.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4673.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4680.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4681.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4682.md | 2 +- 19 files changed, 19 insertions(+), 19 deletions(-) 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 index e3f0cbbf69d..de85315b9d0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md @@ -8,7 +8,7 @@ ms.assetid: 603bb8b7-356d-4eef-924b-64d769bac5bd --- # Compiler Warning (level 1) C4661 -'identifier' : no suitable definition provided for explicit template instantiation request +> 'identifier' : no suitable definition provided for explicit template instantiation request A member of the template class is not defined. 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 index 3d92cd2b859..43802f3881d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md @@ -8,7 +8,7 @@ ms.assetid: 7efda273-d04a-47b7-ad65-ff1ff94b5ffc --- # Compiler Warning (level 1) C4662 -explicit instantiation; template-class 'identifier1' has no definition from which to specialize 'identifier2' +> explicit instantiation; template-class 'identifier1' has no definition from which to specialize 'identifier2' The specified template-class was declared, but not defined. 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 index 2170e220116..e029beedb5e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md @@ -8,7 +8,7 @@ ms.assetid: 5d2b7fe0-4f0e-4cd6-b432-ca02c3d194ab --- # Compiler Warning (level 1) C4667 -'function' : no function template defined that matches forced instantiation +> 'function' : no function template defined that matches forced instantiation You cannot instantiate a function template that has not been declared. 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 index ff9b92c50a9..b246ffd982b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md @@ -8,7 +8,7 @@ ms.assetid: 97730679-e3dc-44d4-b2a8-aa65badc17f2 --- # Compiler Warning (level 1) C4669 -'cast' : unsafe conversion: 'class' is a managed or WinRT type object +> 'cast' : unsafe conversion: 'class' is a managed or WinRT type object 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. 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 index 5bdc7b61cab..0a0f8351e7b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md @@ -8,7 +8,7 @@ ms.assetid: 638dae0b-b82c-4865-9599-72630827ca09 --- # Compiler Warning (level 1) C4674 -'method' should be declared 'static' and have exactly one parameter +> 'method' should be declared 'static' and have exactly one parameter 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). 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 index 40eb235d544..35b05f6013f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md @@ -8,7 +8,7 @@ ms.assetid: a8d656a1-e2ff-4f8b-9028-201765131026 --- # Compiler Warning (level 1) C4677 -'function': signature of non-private member contains assembly private type 'private_type' +> 'function': signature of non-private member contains assembly private type 'private_type' 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. 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 index ef63fce96f9..f99698d1e82 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md @@ -8,7 +8,7 @@ ms.assetid: 0c588f34-595d-4e5c-9470-8723fca2cc06 --- # Compiler Warning (level 1) C4678 -base class 'base_type' is less accessible than 'derived_type' +> base class 'base_type' is less accessible than 'derived_type' 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. 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 index d48b01c07b8..202c1737f2e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md @@ -8,7 +8,7 @@ ms.assetid: e95f1a83-2784-4b05-ae94-12148e056e26 --- # Compiler Warning (level 1) C4684 -'attribute' : WARNING!! attribute may cause invalid code generation: use with caution +> 'attribute' : WARNING!! attribute may cause invalid code generation: use with caution You used an attribute that should not commonly be used. 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 index 484436b8714..283981e6476 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md @@ -8,6 +8,6 @@ ms.assetid: 16e859b8-a8e8-4a0d-a1d0-37ec4e59a9d7 --- # Compiler Warning (level 1) C4685 -expecting '> >' found '>>' when parsing template parameters +> expecting '> >' found '>>' when parsing template parameters 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 index 59bedf3f0fb..0111e685578 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md @@ -8,7 +8,7 @@ ms.assetid: a027df3c-b2b8-4c49-8539-c2bc42db74e8 --- # Compiler Warning (level 1) C4688 -'constraint': constraint list contains assembly private type 'type' +> 'constraint': constraint list contains assembly private type 'type' 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). 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 index 16750c821ca..22bfb9d2c5b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md @@ -8,7 +8,7 @@ ms.assetid: 722133d9-87f6-46c1-9e86-9825453d6999 --- # Compiler Warning (level 1) C4691 -'type' : type referenced was expected in unreferenced assembly 'file', type defined in current translation unit used instead +> 'type' : type referenced was expected in unreferenced assembly 'file', type defined in current translation unit used instead The metadata file containing the original type definition is not referenced, and the compiler is using a local 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 index d9421493012..dd13ce2177a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md @@ -8,7 +8,7 @@ ms.assetid: f6fb3acc-8228-491a-9c30-ce302d8a9c75 --- # Compiler Warning (level 1) C4692 -'function': signature of non-private member contains assembly private native type 'native_type' +> 'function': signature of non-private member contains assembly private native type 'native_type' 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. 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 index 691fe7a8f4b..cb786b71dc7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md @@ -8,7 +8,7 @@ ms.assetid: c6585460-bc4a-4a15-9242-4cbfce53c961 --- # Compiler Warning (level 4) C4668 -'symbol' is not defined as a preprocessor macro, replacing with '0' for 'directives' +> 'symbol' is not defined as a preprocessor macro, replacing with '0' for 'directives' 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. 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 index 16a09cd423c..169030f9249 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md @@ -8,7 +8,7 @@ ms.assetid: e172b134-b1fb-4dfe-8e9d-209ea08b73c7 --- # Compiler Warning (level 4) C4670 -'identifier' : this base class is inaccessible +> 'identifier' : this base class is inaccessible 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. 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 index 71c8c6eabdb..e9706d55195 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md @@ -8,6 +8,6 @@ ms.assetid: 3ae1b9cd-e53e-41e7-a330-7238b7aa0679 --- # Compiler Warning (level 4) C4672 -'identifier1' : ambiguous. First seen as 'identifier2' +> 'identifier1' : ambiguous. First seen as 'identifier2' 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 index 72d0d3c2645..226dd6b0331 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md @@ -8,7 +8,7 @@ ms.assetid: 95626ec6-f05b-43c7-8b9a-a60a6f98dd30 --- # Compiler Warning (level 4) C4673 -throwing 'identifier' the following types will not be considered at the catch site +> throwing 'identifier' the following types will not be considered at the catch site 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. 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 index 84991356ab2..2519f285ed3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md @@ -8,7 +8,7 @@ ms.assetid: 6e043f4c-c601-4b77-8130-920cff1d912e --- # Compiler Warning (level 4) C4680 -'class' : coclass does not specify a default interface +> 'class' : coclass does not specify a default interface 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. 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 index 111c36c8bba..d93ed4f5cf3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md @@ -8,7 +8,7 @@ ms.assetid: a4e6d85f-3e21-4b45-a551-c23d3c554d3f --- # Compiler Warning (level 4) C4681 -'class' : coclass does not specify a default interface that is an event source +> 'class' : coclass does not specify a default interface that is an event source A [source](../../windows/attributes/source-cpp.md) interface was not specified for a class. 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 index b0ca72b2f48..a5ea062b435 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md @@ -8,7 +8,7 @@ ms.assetid: 858ea157-1244-4a61-85df-97b3de43d418 --- # Compiler Warning (level 4) C4682 -'parameter' : no directional parameter attribute specified, defaulting to [in] +> 'parameter' : no directional parameter attribute specified, defaulting to [in] 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. From df6e56d1dbbe3b8740d6a5974d1bf3de741a0dc4 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 1 Sep 2025 23:54:39 +0800 Subject: [PATCH 1054/1799] Add "Remarks" and "Example" headings for warning references in range [C4661, C4700] --- .../compiler-warnings/compiler-warning-c4693.md | 2 ++ .../compiler-warnings/compiler-warning-c4694.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4661.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4662.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4667.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4669.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4674.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4677.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4678.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4679.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4684.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4685.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4688.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4691.md | 4 +++- .../compiler-warnings/compiler-warning-level-1-c4692.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4668.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4670.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4672.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4673.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4680.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4681.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4682.md | 4 ++++ 22 files changed, 61 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4693.md b/docs/error-messages/compiler-warnings/compiler-warning-c4693.md index 9603aea04d9..7c328c2093a 100644 --- 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 index 69a3a53382e..132c4b76467 100644 --- 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 index de85315b9d0..28728b01376 100644 --- 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 index 43802f3881d..c6906e512ba 100644 --- 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 index e029beedb5e..910671f0407 100644 --- 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 index b246ffd982b..55612475306 100644 --- 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 index 0a0f8351e7b..783b46e7c4c 100644 --- 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 index 35b05f6013f..2428e6a7a94 100644 --- 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 index f99698d1e82..8206aab6a3b 100644 --- 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 index 60432e84ec0..e7bb42f3fee 100644 --- 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 index 202c1737f2e..f41042e25fa 100644 --- 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 index 283981e6476..5e159dad6da 100644 --- 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 index 0111e685578..4a4056018e3 100644 --- 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 index 22bfb9d2c5b..bcd7a7059fc 100644 --- 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 index dd13ce2177a..43ca7a29748 100644 --- 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 index cb786b71dc7..e884005dfe9 100644 --- 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 index 169030f9249..30443e661f9 100644 --- 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 index e9706d55195..45b5647623f 100644 --- 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 index 226dd6b0331..f3487702323 100644 --- 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 index 2519f285ed3..e4685fdb518 100644 --- 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 index d93ed4f5cf3..d6ef24e2170 100644 --- 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 index a5ea062b435..0beb5c808d0 100644 --- 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 From df988d3d5066545fc1a4575da2b44db76f9e23bd Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 1 Sep 2025 23:57:18 +0800 Subject: [PATCH 1055/1799] Replace term "sample" with "example" for warning references in range [C4661, C4700] --- .../compiler-warnings/compiler-warning-c4687.md | 2 +- .../compiler-warnings/compiler-warning-c4693.md | 2 +- .../compiler-warnings/compiler-warning-c4694.md | 2 +- .../compiler-warning-level-1-and-level-4-c4700.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4667.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4669.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4674.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4677.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4683.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4684.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4688.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4691.md | 6 +++--- .../compiler-warnings/compiler-warning-level-1-c4692.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4668.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4670.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4673.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4680.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4681.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4682.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4690.md | 2 +- 20 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4687.md b/docs/error-messages/compiler-warnings/compiler-warning-c4687.md index 6414748bd3f..416b7b3b00a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4687.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4687.md @@ -20,7 +20,7 @@ C4687 is issued as an error by default. You can suppress C4687 with the [warning ## Example -The following sample generates C4687. +The following example generates C4687. ```cpp // C4687.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4693.md b/docs/error-messages/compiler-warnings/compiler-warning-c4693.md index 7c328c2093a..2034b8583e5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4693.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4693.md @@ -18,7 +18,7 @@ This warning is automatically promoted to an error. If you wish to modify this b ## Example -The following sample generates C4693. +The following example generates C4693. ```cpp // C4693.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4694.md b/docs/error-messages/compiler-warnings/compiler-warning-c4694.md index 132c4b76467..7a3e710ee3e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4694.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4694.md @@ -20,7 +20,7 @@ This warning is automatically promoted to an error. If you wish to modify this b ## Example -The following sample generates C4694. +The following example generates C4694. ```cpp // C4694.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md index db6a5e55dca..f19553a6238 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md @@ -20,7 +20,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example -This sample generates C4700 when variables `t`, `u`, and `v` are used before they're initialized, and shows the kind of garbage value that can result. Variables `x`, `y`, and `z` don't cause the warning, because they're initialized before use: +This example generates C4700 when variables `t`, `u`, and `v` are used before they're initialized, and shows the kind of garbage value that can result. Variables `x`, `y`, and `z` don't cause the warning, because they're initialized before use: ```cpp // c4700.cpp 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 index 910671f0407..afae4170f58 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md @@ -16,7 +16,7 @@ You cannot instantiate a function template that has not been declared. ## Example -The following sample will cause C4667: +The following example will cause C4667: ```cpp // C4667a.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 index 55612475306..bef4d1e7a68 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md @@ -16,7 +16,7 @@ A cast contains a Windows Runtime or managed type. The compiler completes the ca ## Example -The following sample generates C4669 and shows how to fix it: +The following example generates C4669 and shows how to fix it: ```cpp // C4669.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 index 783b46e7c4c..d8349c5dd90 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md @@ -16,7 +16,7 @@ The signature of a conversion operator was not correct. The method is not consid ## Example -The following sample generates C4674. +The following example generates C4674. ```cpp // C4674.cpp 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 index 2428e6a7a94..76997ca299f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md @@ -16,7 +16,7 @@ A type that has public accessibility outside the assembly uses a type that has p ## Example -The following sample generates C4677. +The following example generates C4677. ```cpp // C4677.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md index 4e49d32e524..624abcb2ed0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md @@ -24,7 +24,7 @@ The reason for the leak is that the out parameter will be set by more than one h ## Example -The following sample generates C4683 and shows how to fix it: +The following example generates C4683 and shows how to fix it: ```cpp // C4683.cpp 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 index f41042e25fa..673027f0b75 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md @@ -16,7 +16,7 @@ You used an attribute that should not commonly be used. ## Example -The following sample generates C4684: +The following example generates C4684: ```cpp // C4684.cpp 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 index 4a4056018e3..974fed9627b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md @@ -16,7 +16,7 @@ A constraint list has an assembly private type, meaning it will not be available ## Example -The following sample generates C4688. +The following example generates C4688. ```cpp // C4688.cpp 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 index bcd7a7059fc..0788da3076f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md @@ -20,7 +20,7 @@ However, unexpected behavior can occur if the compiler uses a definition that is ## Example -This sample contains the original type definition. +This example contains the original type definition. ```cpp // C4691_a.cpp @@ -28,7 +28,7 @@ This sample contains the original type definition. public ref class Original_Type {}; ``` -This sample references C4691_a.dll and declares a field of type Original_Type. +This example references C4691_a.dll and declares a field of type Original_Type. ```cpp // C4691_b.cpp @@ -40,7 +40,7 @@ public: }; ``` -The following sample generates C4691. Notice this sample contains a definition for Original_Type and does not reference C4691a.dll. +The following example generates C4691. Notice this example contains a definition for Original_Type and does not reference C4691a.dll. To resolve, reference the metadata file that contains the original type definition and remove the local declaration and 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 index 43ca7a29748..21461aaeb35 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md @@ -20,7 +20,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4692. +The following example generates C4692. ```cpp // C4692.cpp 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 index e884005dfe9..c4c27324a93 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4668: +The following example generates C4668: ```cpp // C4668.cpp 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 index 30443e661f9..7a77dd343aa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md @@ -16,7 +16,7 @@ The specified base class of an object to be thrown in a **`try`** block is not a ## Example -The following sample generates C4670: +The following example generates C4670: ```cpp // C4670.cpp 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 index f3487702323..824aed2e75b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md @@ -16,7 +16,7 @@ A throw object cannot be handled in the **`catch`** block. Each type that cannot ## Example -The following sample generates C4673: +The following example generates C4673: ```cpp // 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 index e4685fdb518..6e63f74cebb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md @@ -16,7 +16,7 @@ A [default](../../windows/attributes/default-cpp.md) interface was not specified ## Example -The following sample generates C4680: +The following example generates C4680: ```cpp // 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 index d6ef24e2170..60164b44740 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md @@ -16,7 +16,7 @@ A [source](../../windows/attributes/source-cpp.md) interface was not specified f ## Example -The following sample generates C4681: +The following example generates C4681: ```cpp // 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 index 0beb5c808d0..f529efb8d3e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4682: +The following example generates C4682: ```cpp // C4682.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md index 13c663986aa..dc694bd8833 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md @@ -16,7 +16,7 @@ The [emitidl](../../windows/attributes/emitidl.md) attribute was popped one more ## Example -The following sample generates C4690. To fix this issue, make sure the attribute is popped exactly as many times as it is pushed. +The following example generates C4690. To fix this issue, make sure the attribute is popped exactly as many times as it is pushed. ```cpp // C4690.cpp From da5cee6daa296a2eff513c086e5861f8f801172a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 00:05:30 +0800 Subject: [PATCH 1056/1799] Update metadata for warning references in range [C4661, C4700] --- docs/error-messages/compiler-warnings/c4698.md | 2 +- .../compiler-warnings/compiler-warning-c4687.md | 5 ++--- .../compiler-warnings/compiler-warning-c4693.md | 5 ++--- .../compiler-warnings/compiler-warning-c4694.md | 5 ++--- .../compiler-warning-level-1-and-level-4-c4700.md | 3 +-- .../compiler-warnings/compiler-warning-level-1-c4661.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4662.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4667.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4669.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4674.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4677.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4678.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4679.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4683.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4684.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4685.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4688.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4691.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4692.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4686.md | 1 - .../compiler-warnings/compiler-warning-level-4-c4668.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4670.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4672.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4673.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4680.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4681.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4682.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4690.md | 5 ++--- 28 files changed, 52 insertions(+), 79 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4698.md b/docs/error-messages/compiler-warnings/c4698.md index cc66fdd20a6..91fb47a5c74 100644 --- a/docs/error-messages/compiler-warnings/c4698.md +++ b/docs/error-messages/compiler-warnings/c4698.md @@ -1,6 +1,6 @@ --- -description: "Learn about the cause and fixes for Compiler warning (level 3) C4698." title: "Compiler warning (Level 4) C4698" +description: "Learn about the cause and fixes for Compiler warning (level 3) C4698." ms.date: 04/18/2021 f1_keywords: ["C4698"] helpviewer_keywords: ["C4698"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4687.md b/docs/error-messages/compiler-warnings/compiler-warning-c4687.md index 416b7b3b00a..c4d55b15351 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4687.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4687.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4687" title: "Compiler Warning C4687" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4687" +ms.date: 11/04/2016 f1_keywords: ["C4687"] helpviewer_keywords: ["C4687"] -ms.assetid: 2f28e0b1-7358-4c88-bd70-aad8f0aa004c --- # Compiler Warning C4687 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4693.md b/docs/error-messages/compiler-warnings/compiler-warning-c4693.md index 2034b8583e5..cd9461c3e9a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4693.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4693.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4693" title: "Compiler Warning C4693" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning C4693" +ms.date: 10/25/2017 f1_keywords: ["C4693"] helpviewer_keywords: ["C4693"] -ms.assetid: 72d8db01-5e6f-4794-8731-76107e8f064a --- # Compiler Warning C4693 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4694.md b/docs/error-messages/compiler-warnings/compiler-warning-c4694.md index 7a3e710ee3e..42b5c6af3af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4694.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4694.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4694" title: "Compiler Warning C4694" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning C4694" +ms.date: 10/25/2017 f1_keywords: ["C4694"] helpviewer_keywords: ["C4694"] -ms.assetid: 5ca122bb-34f3-43ee-a21f-95802cd515f7 --- # Compiler Warning C4694 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md index f19553a6238..17e3df14c6b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4700" title: "Compiler Warning (level 1 and level 4) C4700" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4700" ms.date: 08/30/2022 f1_keywords: ["C4700"] helpviewer_keywords: ["C4700"] -ms.assetid: 2da0deb4-77dd-4b05-98d3-b78d74ac4ca7 --- # Compiler Warning (level 1 and level 4) C4700 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 index 28728b01376..ebb21a82fc7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4661" title: "Compiler Warning (level 1) C4661" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4661" +ms.date: 11/04/2016 f1_keywords: ["C4661"] helpviewer_keywords: ["C4661"] -ms.assetid: 603bb8b7-356d-4eef-924b-64d769bac5bd --- # Compiler Warning (level 1) C4661 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 index c6906e512ba..dd5d74293e4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4662" title: "Compiler Warning (level 1) C4662" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4662" +ms.date: 11/04/2016 f1_keywords: ["C4662"] helpviewer_keywords: ["C4662"] -ms.assetid: 7efda273-d04a-47b7-ad65-ff1ff94b5ffc --- # Compiler Warning (level 1) C4662 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 index afae4170f58..6de3394c5d8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4667" title: "Compiler Warning (level 1) C4667" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4667" +ms.date: 11/04/2016 f1_keywords: ["C4667"] helpviewer_keywords: ["C4667"] -ms.assetid: 5d2b7fe0-4f0e-4cd6-b432-ca02c3d194ab --- # Compiler Warning (level 1) C4667 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 index bef4d1e7a68..3d19bad6cd0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4669" title: "Compiler Warning (level 1) C4669" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4669" +ms.date: 11/04/2016 f1_keywords: ["C4669"] helpviewer_keywords: ["C4669"] -ms.assetid: 97730679-e3dc-44d4-b2a8-aa65badc17f2 --- # Compiler Warning (level 1) C4669 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 index d8349c5dd90..37e020cd33e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4674" title: "Compiler Warning (level 1) C4674" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4674" +ms.date: 11/04/2016 f1_keywords: ["C4674"] helpviewer_keywords: ["C4674"] -ms.assetid: 638dae0b-b82c-4865-9599-72630827ca09 --- # Compiler Warning (level 1) C4674 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 index 76997ca299f..1a86bd31b69 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4677" title: "Compiler Warning (level 1) C4677" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4677" +ms.date: 11/04/2016 f1_keywords: ["C4677"] helpviewer_keywords: ["C4677"] -ms.assetid: a8d656a1-e2ff-4f8b-9028-201765131026 --- # Compiler Warning (level 1) C4677 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 index 8206aab6a3b..cfe99eaf282 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4678" title: "Compiler Warning (level 1) C4678" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4678" +ms.date: 11/04/2016 f1_keywords: ["C4678"] helpviewer_keywords: ["C4678"] -ms.assetid: 0c588f34-595d-4e5c-9470-8723fca2cc06 --- # Compiler Warning (level 1) C4678 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 index e7bb42f3fee..ada9e31dc9c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4679.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4679.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4679" title: "Compiler Warning (level 1) C4679" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4679" +ms.date: 08/27/2018 f1_keywords: ["C4679"] helpviewer_keywords: ["C4679"] -ms.assetid: 3cc74150-42a8-4116-94cd-4ef0fd6dcf32 --- # Compiler Warning (level 1) C4679 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md index 624abcb2ed0..f403e48f03d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4683" title: "Compiler Warning (level 1) C4683" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4683" +ms.date: 08/27/2018 f1_keywords: ["C4683"] helpviewer_keywords: ["C4683"] -ms.assetid: e6e77364-dba1-46dd-ae1d-03da23070bce --- # Compiler Warning (level 1) C4683 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 index 673027f0b75..ab66c25bf43 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4684" title: "Compiler Warning (level 1) C4684" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4684" +ms.date: 11/04/2016 f1_keywords: ["C4684"] helpviewer_keywords: ["C4684"] -ms.assetid: e95f1a83-2784-4b05-ae94-12148e056e26 --- # Compiler Warning (level 1) C4684 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 index 5e159dad6da..a9fdc182960 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4685" title: "Compiler Warning (level 1) C4685" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4685" +ms.date: 11/04/2016 f1_keywords: ["C4685"] helpviewer_keywords: ["C4685"] -ms.assetid: 16e859b8-a8e8-4a0d-a1d0-37ec4e59a9d7 --- # Compiler Warning (level 1) C4685 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 index 974fed9627b..d257f2f4acc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4688" title: "Compiler Warning (level 1) C4688" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4688" +ms.date: 11/04/2016 f1_keywords: ["C4688"] helpviewer_keywords: ["C4688"] -ms.assetid: a027df3c-b2b8-4c49-8539-c2bc42db74e8 --- # Compiler Warning (level 1) C4688 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 index 0788da3076f..ae062d85d15 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4691" title: "Compiler Warning (level 1) C4691" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4691" +ms.date: 11/04/2016 f1_keywords: ["C4691"] helpviewer_keywords: ["C4691"] -ms.assetid: 722133d9-87f6-46c1-9e86-9825453d6999 --- # Compiler Warning (level 1) C4691 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 index 21461aaeb35..44cc03e03b4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4692" title: "Compiler Warning (level 1) C4692" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4692" +ms.date: 11/04/2016 f1_keywords: ["C4692"] helpviewer_keywords: ["C4692"] -ms.assetid: f6fb3acc-8228-491a-9c30-ce302d8a9c75 --- # Compiler Warning (level 1) C4692 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4686.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4686.md index 28ac87a590c..eeda17ff133 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4686.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4686.md @@ -4,7 +4,6 @@ description: "Microsoft C++ compiler warning C4686." ms.date: 08/29/2020 f1_keywords: ["C4686"] helpviewer_keywords: ["C4686"] -ms.assetid: 767c83c2-9e4b-4f9e-88c8-02128ba563f4 --- # Compiler Warning (level 3) C4686 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 index c4c27324a93..ac3527c10fa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4668" title: "Compiler Warning (level 4) C4668" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4668" +ms.date: 11/04/2016 f1_keywords: ["C4668"] helpviewer_keywords: ["C4668"] -ms.assetid: c6585460-bc4a-4a15-9242-4cbfce53c961 --- # Compiler Warning (level 4) C4668 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 index 7a77dd343aa..0fe80da2049 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4670" title: "Compiler Warning (level 4) C4670" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4670" +ms.date: 11/04/2016 f1_keywords: ["C4670"] helpviewer_keywords: ["C4670"] -ms.assetid: e172b134-b1fb-4dfe-8e9d-209ea08b73c7 --- # Compiler Warning (level 4) C4670 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 index 45b5647623f..79592299553 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4672" title: "Compiler Warning (level 4) C4672" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4672" +ms.date: 11/04/2016 f1_keywords: ["C4672"] helpviewer_keywords: ["C4672"] -ms.assetid: 3ae1b9cd-e53e-41e7-a330-7238b7aa0679 --- # Compiler Warning (level 4) C4672 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 index 824aed2e75b..e78645787d5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4673" title: "Compiler Warning (level 4) C4673" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4673" +ms.date: 11/04/2016 f1_keywords: ["C4673"] helpviewer_keywords: ["C4673"] -ms.assetid: 95626ec6-f05b-43c7-8b9a-a60a6f98dd30 --- # Compiler Warning (level 4) C4673 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 index 6e63f74cebb..b1c2f47d90a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4680" title: "Compiler Warning (level 4) C4680" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4680" +ms.date: 11/04/2016 f1_keywords: ["C4680"] helpviewer_keywords: ["C4680"] -ms.assetid: 6e043f4c-c601-4b77-8130-920cff1d912e --- # Compiler Warning (level 4) C4680 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 index 60164b44740..361aa89790a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4681" title: "Compiler Warning (level 4) C4681" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4681" +ms.date: 11/04/2016 f1_keywords: ["C4681"] helpviewer_keywords: ["C4681"] -ms.assetid: a4e6d85f-3e21-4b45-a551-c23d3c554d3f --- # Compiler Warning (level 4) C4681 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 index f529efb8d3e..24a2e74a7f7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4682" title: "Compiler Warning (level 4) C4682" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4682" +ms.date: 11/04/2016 f1_keywords: ["C4682"] helpviewer_keywords: ["C4682"] -ms.assetid: 858ea157-1244-4a61-85df-97b3de43d418 --- # Compiler Warning (level 4) C4682 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md index dc694bd8833..2b60bad381f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4690" title: "Compiler Warning (level 4) C4690" -ms.date: "07/03/2018" +description: "Learn more about: Compiler Warning (level 4) C4690" +ms.date: 07/03/2018 f1_keywords: ["C4690"] helpviewer_keywords: ["C4690"] -ms.assetid: 080a0ea1-458b-477b-a37a-4a34c94709ff --- # Compiler Warning (level 4) C4690 From acea0a30d0aa7bbd2ae0f4df1b9fd441730dabf0 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 00:10:30 +0800 Subject: [PATCH 1057/1799] Add leading example sentence in C4661 and C4662 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4661.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4662.md | 2 ++ 2 files changed, 4 insertions(+) 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 index ebb21a82fc7..b4d9e92a60c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md @@ -15,6 +15,8 @@ A member of the template class is not defined. ## Example +The following example generates C4661: + ```cpp // C4661.cpp // compile with: /W1 /LD 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 index dd5d74293e4..68beca85087 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md @@ -15,6 +15,8 @@ The specified template-class was declared, but not defined. ## Example +The following example generates C4662: + ```cpp // C4662.cpp // compile with: /W1 /LD From 8dd0050d1685cef570c4046ae5574a1842aed3d9 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 17:01:12 +0800 Subject: [PATCH 1058/1799] Add blockquotes for warning messages in range [C4701, C4750] --- docs/error-messages/compiler-warnings/compiler-warning-c4746.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4711.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4715.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4716.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4717.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4722.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4727.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4729.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4730.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4731.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4733.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4739.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4744.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4747.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4723.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4724.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4738.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4701.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4709.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4718.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4725.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4740.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4746.md b/docs/error-messages/compiler-warnings/compiler-warning-c4746.md index 04491bb8f18..3d814bad58e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4746.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4746.md @@ -8,7 +8,7 @@ ms.assetid: 5e79ab46-6031-499a-a986-716c866b6c0e --- # Compiler Warning C4746 -volatile access of '\' is subject to /volatile:[iso\|ms] setting; consider using __iso_volatile_load/store intrinsic functions. +> volatile access of '\' is subject to /volatile:[iso\|ms] setting; consider using __iso_volatile_load/store intrinsic functions. C4746 is emitted whenever a volatile variable is accessed directly. It's intended to help developers identify code locations that are affected by the specific volatile model currently specified (which can be controlled with the [`/volatile`](../../build/reference/volatile-volatile-keyword-interpretation.md) compiler option). In particular, it can be useful in locating compiler-generated hardware memory barriers when `/volatile:ms` is used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md index 264ef9afb52..27ee9041ce5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md @@ -8,7 +8,7 @@ ms.assetid: 270506ab-fead-4328-b714-2978113be238 --- # Compiler Warning (level 1) C4711 -function 'function' selected for inline expansion +> function 'function' selected for inline expansion The compiler performed inlining on the given function, although it was not marked for inlining. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md index c4f1d16eda7..f2172394b6a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md @@ -8,7 +8,7 @@ ms.assetid: 1c819bf7-0d8b-4f5e-b338-9cc292870439 --- # Compiler Warning (level 1) C4715 -'function' : not all control paths return a value +> 'function' : not all control paths return a value The specified function can potentially not return a value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md index a01e32efc2c..8e0563e1498 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md @@ -8,7 +8,7 @@ ms.assetid: d95ecfe5-870f-461f-a746-7913af98414b --- # Compiler Warning (level 1) C4716 -'function' must return a value +> 'function' must return a value The given function did not return a value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md index 3a0de8742fd..551e469bcdc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md @@ -8,7 +8,7 @@ ms.assetid: 5ef3c6c7-8599-4714-a973-0f5b69cdab3c --- # Compiler Warning (level 1) C4717 -'function' : recursive on all control paths, function will cause runtime stack overflow +> 'function' : recursive on all control paths, function will cause runtime stack overflow Every path through a function contains a call to the function. Since there is no way to exit the function without first calling itself recursively, the function will never exit. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md index 30659c1bb75..7cc2cc00517 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4722"] --- # Compiler Warning (level 1) C4722 -'function' : destructor never returns, potential memory leak +> 'function' : destructor never returns, potential memory leak The flow of control terminates in a destructor. The thread or the entire program will terminate and allocated resources may not be released. Furthermore, if a destructor will be called for stack unwinding during exception processing, the behavior of executable is undefined. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md index 821b7447a7f..8250351a53f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md @@ -8,7 +8,7 @@ ms.assetid: 991b0087-3a50-40f5-9cdb-cdc367cd472c --- # Compiler Warning (level 1) C4727 -"PCH named pch_file with same timestamp found in obj_file_1 and obj_file_2. Using first PCH. +> "PCH named pch_file with same timestamp found in obj_file_1 and obj_file_2. Using first PCH. > [!NOTE] > In Visual Studio 2017 and earlier, the precompiled header is called *stdafx.h* by default, and in Visual Studio 2019 and later, it is called *pch.h* by default. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md index 5bb7c836a4f..300e11f87e9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md @@ -8,7 +8,7 @@ ms.assetid: 36a0151f-f258-48d9-9444-ae6d41ff70a4 --- # Compiler Warning (Level 1) C4729 -function too big for flow graph based warnings +> function too big for flow graph based warnings This warning is generated when a function is too big to be compiled with reliable checking for situations that would generate a warning. This warning is only generated when the [/Od](../../build/reference/od-disable-debug.md) compiler option used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md index 69e3190a359..37614be163d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md @@ -8,7 +8,7 @@ ms.assetid: 11303e3f-162b-4b19-970a-479686123a68 --- # Compiler Warning (Level 1) C4730 -'main' : mixing _m64 and floating point expressions may result in incorrect code +> 'main' : mixing _m64 and floating point expressions may result in incorrect code A function uses [__m64](../../cpp/m64.md) and **`float`**/**`double`** types. Because the MMX and floating-point registers share the same physical register space (cannot be used simultaneously), using **`__m64`** and **`float`**/**`double`** types in the same function can result in data corruption, possibly causing an exception. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md index 4e758090b5a..69c35278e13 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md @@ -8,7 +8,7 @@ ms.assetid: 5658c24c-3e6f-4505-835b-1fb92d47cab0 --- # Compiler Warning (Level 1) C4731 -'pointer' : frame pointer register 'register' modified by inline assembly code +> 'pointer' : frame pointer register 'register' modified by inline assembly code A frame pointer register was modified. You must save and restore the register in your inline assembly block or frame variable (local or parameter, depending on the register modified), or your code may not work properly. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md index 1c64dd7cbb5..51f7ae0a5ae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md @@ -8,7 +8,7 @@ ms.assetid: 7ef4f577-772d-4b66-a7bf-8958a6b250bc --- # Compiler Warning (Level 1) C4733 -Inline asm assigning to 'FS:0' : handler not registered as safe handler +> Inline asm assigning to 'FS:0' : handler not registered as safe handler A function modifying the value at FS:0 to add a new exception handler may not work with Safe Exceptions, because the handler may not be registered as a valid exception handler (see [/SAFESEH](../../build/reference/safeseh-image-has-safe-exception-handlers.md)). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md index 83340c734c5..1bbb4af6af6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md @@ -8,7 +8,7 @@ ms.assetid: 600873b3-7c85-4cd4-944e-cd8e01bfcbb0 --- # Compiler Warning (Level 1) C4739 -reference to variable 'var' exceeds its storage space +> reference to variable 'var' exceeds its storage space A value was assigned to a variable, but the value is greater than the size of the variable. Memory will be written beyond the variable's memory location, and data loss is possible. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md index d8c6e56aafc..53e4aa7b149 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4744"] --- # Compiler Warning (Level 1) C4744 -'var' has different type in 'file1' and 'file2': 'type1' and 'type2' +> 'var' has different type in 'file1' and 'file2': 'type1' and 'type2' An external variable referenced or defined in two files has different types in those files. To resolve, either make the type definitions the same, or change variable name in one of the files. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md index 4c6c42a9a48..9f8d0b8b59a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C4747"] --- # Compiler Warning (level 1) C4747 -Calling managed 'entrypoint': Managed code may not be run under loader lock, including the DLL entrypoint and calls reached from the DLL entrypoint +> Calling managed 'entrypoint': Managed code may not be run under loader lock, including the DLL entrypoint and calls reached from the DLL entrypoint The compiler found a (probable) DLL entry point compiled to MSIL. Because of potential problems with loading a DLL whose entry point has been compiled to MSIL, you are strongly discouraged from compiling a DLL entry point function to MSIL. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md index 7893ae678ed..24373b9de9f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md @@ -8,7 +8,7 @@ ms.assetid: 07669d14-3fd8-4a43-94bc-b61c50e58460 --- # Compiler Warning (level 3) C4723 -> `potential divide by 0` +> potential divide by 0 The second operand in a divide operation evaluated to zero at compile time, giving undefined results. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md index e9bb992d3ad..9126dffa753 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md @@ -8,6 +8,6 @@ ms.assetid: 3be4305b-e8fe-49a9-abbf-b20dfbd71a19 --- # Compiler Warning (level 3) C4724 -potential mod by 0 +> potential mod by 0 The second operand in a remainder operation evaluated to zero at compile time, giving undefined results. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md index b8ef08780a1..3908211c704 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md @@ -8,7 +8,7 @@ ms.assetid: 9094895f-7eec-46c2-83d3-249b761d585e --- # Compiler Warning (Level 3) C4738 -storing 32-bit float result in memory, possible loss of performance +> storing 32-bit float result in memory, possible loss of performance C4738 warns that the result of an assignment, cast, passed argument, or other operation may need to be rounded or that the operation ran out of registers and needed to use memory (spilling). This can result in performance loss. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md index 9ebcdda802f..9eb660e5662 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md @@ -8,7 +8,7 @@ ms.assetid: d7c76c66-1f3f-4d3c-abe4-5d94c84a5a1f --- # Compiler Warning (level 4) C4701 -Potentially uninitialized local variable 'name' used +> Potentially uninitialized local variable 'name' used The local variable *name* might have been used without being assigned a value. This could lead to unpredictable results. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md index ce1711cf545..8f3689ced54 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md @@ -8,7 +8,7 @@ ms.assetid: 8abfdd45-8c70-4c27-b0fb-ca0c3f0fccf9 --- # Compiler Warning (level 4) C4709 -comma operator within array index expression +> comma operator within array index expression When a comma occurs in an array index expression, the compiler uses the value after the last comma. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md index f5f3e29ecc3..25256b8812c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md @@ -8,6 +8,6 @@ ms.assetid: 29507f8a-b024-42c1-a3b8-f35d1f2641f3 --- # Compiler Warning (level 4) C4718 -'function call' : recursive call has no side effects, deleting +> 'function call' : recursive call has no side effects, deleting A function contains a recursive call, but otherwise has no side effects. A call to this function is being deleted. The correctness of the program is not affected, but the behavior is. Whereas leaving the call in could result in a runtime stack overflow exception, deleting the call removes that possibility. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md index 33d4ee8068d..4381680f5c5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md @@ -8,7 +8,7 @@ ms.assetid: effa0335-71c3-4b3b-8618-da4b9b46a95d --- # Compiler Warning (level 4) C4725 -instruction may be inaccurate on some Pentiums +> instruction may be inaccurate on some Pentiums Your code contains an inline assembly instruction that may not produce accurate results on some Pentium microprocessors. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md index dbd34c62da4..78368f584f7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md @@ -8,7 +8,7 @@ ms.assetid: 85528969-966a-44b4-8a2f-971704c64477 --- # Compiler Warning (Level 4) C4740 -flow in or out of inline asm code suppresses global optimization +> flow in or out of inline asm code suppresses global optimization When there is a jump in to or out of an **`asm`** block, global optimizations are disabled for that function. From cea02c8a9a4586d88840251c0016dce8d85c2bfd Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 17:08:54 +0800 Subject: [PATCH 1059/1799] Add "Remarks" and "Example" headings for warning references in range [C4701, C4750] --- .../compiler-warnings/compiler-warning-c4746.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4711.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4715.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4716.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4717.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4722.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4727.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4729.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4730.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4731.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4733.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4739.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4742.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4743.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4744.md | 4 +++- .../compiler-warnings/compiler-warning-level-1-c4747.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4723.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4724.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4738.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4701.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4702.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4706.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4709.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4710.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4714.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4718.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4725.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4740.md | 4 ++++ 28 files changed, 79 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4746.md b/docs/error-messages/compiler-warnings/compiler-warning-c4746.md index 3d814bad58e..0fdd3e41e56 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4746.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4746.md @@ -10,6 +10,8 @@ ms.assetid: 5e79ab46-6031-499a-a986-716c866b6c0e > volatile access of '\' is subject to /volatile:[iso\|ms] setting; consider using __iso_volatile_load/store intrinsic functions. +## Remarks + C4746 is emitted whenever a volatile variable is accessed directly. It's intended to help developers identify code locations that are affected by the specific volatile model currently specified (which can be controlled with the [`/volatile`](../../build/reference/volatile-volatile-keyword-interpretation.md) compiler option). In particular, it can be useful in locating compiler-generated hardware memory barriers when `/volatile:ms` is used. The __iso_volatile_load/store intrinsics can be used to explicitly access volatile memory without being affected by the volatile model. Using these intrinsics will not trigger C4746. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md index 27ee9041ce5..27aacc37133 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md @@ -10,6 +10,8 @@ ms.assetid: 270506ab-fead-4328-b714-2978113be238 > function 'function' selected for inline expansion +## Remarks + The compiler performed inlining on the given function, although it was not marked for inlining. C4711 is enabled if [/Ob2](../../build/reference/ob-inline-function-expansion.md) is specified. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md index f2172394b6a..038477736a4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md @@ -10,6 +10,8 @@ ms.assetid: 1c819bf7-0d8b-4f5e-b338-9cc292870439 > 'function' : not all control paths return a value +## Remarks + The specified function can potentially not return a value. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md index 8e0563e1498..75500ed62ea 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md @@ -10,6 +10,8 @@ ms.assetid: d95ecfe5-870f-461f-a746-7913af98414b > 'function' must return a value +## Remarks + The given function did not return a value. Only functions with a return type of void can use the return command without an accompanying return value. @@ -18,6 +20,8 @@ An undefined value will be returned when this function is called. This warning is automatically promoted to an error. If you wish to modify this behavior, use [#pragma warning](../../preprocessor/warning.md). +## Example + The following sample generates C4716: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md index 551e469bcdc..5480542c57f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md @@ -10,8 +10,12 @@ ms.assetid: 5ef3c6c7-8599-4714-a973-0f5b69cdab3c > 'function' : recursive on all control paths, function will cause runtime stack overflow +## Remarks + Every path through a function contains a call to the function. Since there is no way to exit the function without first calling itself recursively, the function will never exit. +## Example + The following sample generates C4717: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md index 7cc2cc00517..079fe6e9f75 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4722"] > 'function' : destructor never returns, potential memory leak +## Remarks + The flow of control terminates in a destructor. The thread or the entire program will terminate and allocated resources may not be released. Furthermore, if a destructor will be called for stack unwinding during exception processing, the behavior of executable is undefined. To resolve, remove the function call that causes the destructor to not return. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md index 8250351a53f..060c9e8811c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md @@ -10,6 +10,8 @@ ms.assetid: 991b0087-3a50-40f5-9cdb-cdc367cd472c > "PCH named pch_file with same timestamp found in obj_file_1 and obj_file_2. Using first PCH. +## Remarks + > [!NOTE] > In Visual Studio 2017 and earlier, the precompiled header is called *stdafx.h* by default, and in Visual Studio 2019 and later, it is called *pch.h* by default. @@ -17,6 +19,8 @@ C4727 occurs when compiling multiple compilands with **/Yc**, and where the comp To resolve, compile one source file with **/Yc /c** (creates pch), and the others compile separately with **/Yu /c** (uses pch), then link them together. +## Example + So, if you did the following and it generates C4727: ::: moniker range="<=msvc-150" diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md index 300e11f87e9..4a3a4145f7a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md @@ -10,6 +10,8 @@ ms.assetid: 36a0151f-f258-48d9-9444-ae6d41ff70a4 > function too big for flow graph based warnings +## Remarks + This warning is generated when a function is too big to be compiled with reliable checking for situations that would generate a warning. This warning is only generated when the [/Od](../../build/reference/od-disable-debug.md) compiler option used. To resolve this warning, break the function into smaller functions. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md index 37614be163d..c191aa60e41 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md @@ -10,10 +10,14 @@ ms.assetid: 11303e3f-162b-4b19-970a-479686123a68 > 'main' : mixing _m64 and floating point expressions may result in incorrect code +## Remarks + A function uses [__m64](../../cpp/m64.md) and **`float`**/**`double`** types. Because the MMX and floating-point registers share the same physical register space (cannot be used simultaneously), using **`__m64`** and **`float`**/**`double`** types in the same function can result in data corruption, possibly causing an exception. To safely use **`__m64`** types and floating-point types in the same function, each instruction that uses one of the types should be separated by the **_m_empty()** (for MMX) or **_m_femms()** (for 3DNow!) intrinsic. +## Example + The following sample generates C4730: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md index 69c35278e13..3694df752f8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md @@ -10,8 +10,12 @@ ms.assetid: 5658c24c-3e6f-4505-835b-1fb92d47cab0 > 'pointer' : frame pointer register 'register' modified by inline assembly code +## Remarks + A frame pointer register was modified. You must save and restore the register in your inline assembly block or frame variable (local or parameter, depending on the register modified), or your code may not work properly. +## Example + The following sample generates C4731: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md index 51f7ae0a5ae..194ff6940f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md @@ -10,10 +10,14 @@ ms.assetid: 7ef4f577-772d-4b66-a7bf-8958a6b250bc > Inline asm assigning to 'FS:0' : handler not registered as safe handler +## Remarks + A function modifying the value at FS:0 to add a new exception handler may not work with Safe Exceptions, because the handler may not be registered as a valid exception handler (see [/SAFESEH](../../build/reference/safeseh-image-has-safe-exception-handlers.md)). To resolve this warning, either remove the FS:0 definition or turn off this warning and use [.SAFESEH](../../assembler/masm/dot-safeseh.md) to specify the safe exception handlers. +## Example + The following sample generates C4733: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md index 1bbb4af6af6..ba2621a9665 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md @@ -10,10 +10,14 @@ ms.assetid: 600873b3-7c85-4cd4-944e-cd8e01bfcbb0 > reference to variable 'var' exceeds its storage space +## Remarks + A value was assigned to a variable, but the value is greater than the size of the variable. Memory will be written beyond the variable's memory location, and data loss is possible. To resolve this warning, only assign a value to a variable whose size can accommodate the value. +## Example + The following sample generates C4739: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md index c25caf63912..19f09d5f77c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md @@ -10,10 +10,10 @@ ms.assetid: e520881d-1eeb-48b1-9df0-8017ee8ba076 > '*variable*' has different alignment in '*file1*' and '*file2*': *number1* and *number2* -An external variable that was referenced or defined in two files has different alignment in those files. - ## Remarks +An external variable that was referenced or defined in two files has different alignment in those files. + This warning is emitted when compiler finds that **`alignof`** for the variable in *file1* differs from **`alignof`** for the variable in *file2*. This can be caused by using incompatible types when declaring variable in different files, or by using non-matching `#pragma pack` in different files. To resolve this warning, either use the same type definition or use different names for the variables. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md index 7587043b9dc..3663a249cff 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md @@ -10,10 +10,10 @@ ms.assetid: 2ee76ea3-77f3-4c2f-9a57-0751823c89fd > '*type*' has different size in '*file1*' and '*file2*': *size_1* and *size_2* bytes -An external variable referenced or defined in two files has different types in those files, and the compiler determined that the size of the variable in *file1* differs from the size of the variable in *file2*. - ## Remarks +An external variable referenced or defined in two files has different types in those files, and the compiler determined that the size of the variable in *file1* differs from the size of the variable in *file2*. + There's an important case when this warning can be emitted for C++. If you declare class types with the same name in two different files, if those declarations contain virtual functions, and if the declarations aren't the same, then the compiler can emit warning C4744 for the virtual function tables. The warning occurs because there are two different-sized virtual function tables for the same type, and the linker must choose one of them to incorporate into the executable. It's possible that it can result in your program calling the wrong virtual function. To resolve this warning, either use the same type definition or use different names for the types or variables. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md index 53e4aa7b149..b0eb87ddc3f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4744"] > 'var' has different type in 'file1' and 'file2': 'type1' and 'type2' +## Remarks + An external variable referenced or defined in two files has different types in those files. To resolve, either make the type definitions the same, or change variable name in one of the files. C4744 is emitted only when files are compiled with /GL. For more information, see [/GL (Whole Program Optimization)](../../build/reference/gl-whole-program-optimization.md). @@ -16,7 +18,7 @@ C4744 is emitted only when files are compiled with /GL. For more information, s > [!NOTE] > C4744 usually occurs in C (not C++) files, because in C++ a variable name is decorated with type information. When the sample (below) is compiles as C++, you'll get linker error LNK2019. -## Examples +## Example This sample contains the first definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md index 9f8d0b8b59a..26cfa5b6e09 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4747"] > Calling managed 'entrypoint': Managed code may not be run under loader lock, including the DLL entrypoint and calls reached from the DLL entrypoint +## Remarks + The compiler found a (probable) DLL entry point compiled to MSIL. Because of potential problems with loading a DLL whose entry point has been compiled to MSIL, you are strongly discouraged from compiling a DLL entry point function to MSIL. For more information, see [Initialization of Mixed Assemblies](../../dotnet/initialization-of-mixed-assemblies.md) and [Linker Tools Error LNK1306](../../error-messages/tool-errors/linker-tools-error-lnk1306.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md index 24373b9de9f..e7d06ecd2a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md @@ -10,6 +10,8 @@ ms.assetid: 07669d14-3fd8-4a43-94bc-b61c50e58460 > potential divide by 0 +## Remarks + The second operand in a divide operation evaluated to zero at compile time, giving undefined results. This warning is issued only when optimizations are enabled. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md index 9126dffa753..81b9329525d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md @@ -10,4 +10,6 @@ ms.assetid: 3be4305b-e8fe-49a9-abbf-b20dfbd71a19 > potential mod by 0 +## Remarks + The second operand in a remainder operation evaluated to zero at compile time, giving undefined results. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md index 3908211c704..01c54150135 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md @@ -10,6 +10,8 @@ ms.assetid: 9094895f-7eec-46c2-83d3-249b761d585e > storing 32-bit float result in memory, possible loss of performance +## Remarks + C4738 warns that the result of an assignment, cast, passed argument, or other operation may need to be rounded or that the operation ran out of registers and needed to use memory (spilling). This can result in performance loss. To resolve this warning and avoid rounding, compile with [/fp:fast](../../build/reference/fp-specify-floating-point-behavior.md) or use **`double`** instead of **`float`**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md index 9eb660e5662..de8b137f7ef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md @@ -10,6 +10,8 @@ ms.assetid: d7c76c66-1f3f-4d3c-abe4-5d94c84a5a1f > Potentially uninitialized local variable 'name' used +## Remarks + The local variable *name* might have been used without being assigned a value. This could lead to unpredictable results. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md index c87a88e66cb..701b03facf1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md @@ -10,6 +10,8 @@ ms.assetid: d8198c1e-8762-42a6-9e6b-cb568b7a1686 > unreachable code +## Remarks + When the compiler back end detects unreachable code, it generates C4702 as a level 4 warning. To address this warning, remove the unreachable code or assure that all source code is reachable by some flow of execution. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md index d31d01fd410..04183c4e86b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4706"] > assignment used as a condition +## Remarks + The test value in a conditional expression is the result of an assignment. An assignment has a value (the value on the left side of the assignment) that can be used legally in another expression, including a test expression. +## Example + The following sample generates C4706: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md index 8f3689ced54..957d27824b0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md @@ -10,6 +10,8 @@ ms.assetid: 8abfdd45-8c70-4c27-b0fb-ca0c3f0fccf9 > comma operator within array index expression +## Remarks + When a comma occurs in an array index expression, the compiler uses the value after the last comma. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md index d2cc5e90759..80c1d4217ce 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md @@ -10,6 +10,8 @@ ms.assetid: 76381ec7-3fc1-4bee-9a0a-c2c8307b92e2 > '*function*' : function not inlined +## Remarks + The specified function was marked for inline expansion, but the compiler didn't inline the function. Inlining is done at the compiler's discretion. The **`inline`** keyword, like the deprecated (and, in C++17 and later standards, removed) **`register`** keyword, is used as a hint for the compiler. The compiler uses heuristics to determine if it should inline a particular function to speed up the code when it optimizes for speed, or if it should inline a particular function to make the code smaller when it optimizes for space. The compiler inlines only the smallest functions when compiling for space. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md index 4742aa9d22e..6661b1b1569 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md @@ -10,6 +10,8 @@ ms.assetid: 22c7fd0c-899d-4e9b-95f3-725b2c49fb46 > function 'function' marked as __forceinline not inlined +## Remarks + The given function was selected for inline expansion, but the compiler did not perform the inlining. Although **`__forceinline`** is a stronger indication to the compiler than **`__inline`**, inlining is still performed at the compiler's discretion, but no heuristics are used to determine the benefits from inlining this function. @@ -28,6 +30,8 @@ In some cases, the compiler will not inline a particular function for mechanical - A function with a **`try`** (C++ exception handling) statement. +## Example + The following sample generates C4714: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md index 25256b8812c..534705501ee 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md @@ -10,4 +10,6 @@ ms.assetid: 29507f8a-b024-42c1-a3b8-f35d1f2641f3 > 'function call' : recursive call has no side effects, deleting +## Remarks + A function contains a recursive call, but otherwise has no side effects. A call to this function is being deleted. The correctness of the program is not affected, but the behavior is. Whereas leaving the call in could result in a runtime stack overflow exception, deleting the call removes that possibility. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md index 4381680f5c5..a342806d519 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md @@ -10,8 +10,12 @@ ms.assetid: effa0335-71c3-4b3b-8618-da4b9b46a95d > instruction may be inaccurate on some Pentiums +## Remarks + Your code contains an inline assembly instruction that may not produce accurate results on some Pentium microprocessors. +## Example + The following sample generates C4725: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md index 78368f584f7..2b19c7d9341 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md @@ -10,8 +10,12 @@ ms.assetid: 85528969-966a-44b4-8a2f-971704c64477 > flow in or out of inline asm code suppresses global optimization +## Remarks + When there is a jump in to or out of an **`asm`** block, global optimizations are disabled for that function. +## Example + The following sample generates C4740: ```cpp From 52c448f825bf50fecfb74a31b7f7d84017d456f2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 17:11:30 +0800 Subject: [PATCH 1060/1799] Replace term "sample" with "example" for warning references in range [C4701, C4750] --- .../compiler-warnings/compiler-warning-level-1-c4716.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4717.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4722.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4730.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4731.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4733.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4739.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4742.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4743.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4744.md | 6 +++--- .../compiler-warnings/compiler-warning-level-1-c4747.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4738.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4702.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4706.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4709.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4714.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4725.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4740.md | 2 +- 18 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md index 75500ed62ea..7a2c54bf0dc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md @@ -22,7 +22,7 @@ This warning is automatically promoted to an error. If you wish to modify this b ## Example -The following sample generates C4716: +The following example generates C4716: ```cpp // C4716.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md index 5480542c57f..acab0594192 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md @@ -16,7 +16,7 @@ Every path through a function contains a call to the function. Since there is no ## Example -The following sample generates C4717: +The following example generates C4717: ```cpp // C4717.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md index 079fe6e9f75..badb5a14db1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md @@ -17,7 +17,7 @@ To resolve, remove the function call that causes the destructor to not return. ## Example -The following sample generates C4722: +The following example generates C4722: ```cpp // C4722.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md index c191aa60e41..b0493e30ede 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md @@ -18,7 +18,7 @@ To safely use **`__m64`** types and floating-point types in the same function, e ## Example -The following sample generates C4730: +The following example generates C4730: ```cpp // C4730.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md index 3694df752f8..107a659a8e0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md @@ -16,7 +16,7 @@ A frame pointer register was modified. You must save and restore the register in ## Example -The following sample generates C4731: +The following example generates C4731: ```cpp // C4731.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md index 194ff6940f2..87c92038cfb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md @@ -18,7 +18,7 @@ To resolve this warning, either remove the FS:0 definition or turn off this warn ## Example -The following sample generates C4733: +The following example generates C4733: ```cpp // C4733.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md index ba2621a9665..f581ce400bb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md @@ -18,7 +18,7 @@ To resolve this warning, only assign a value to a variable whose size can accomm ## Example -The following sample generates C4739: +The following example generates C4739: ```cpp // C4739.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md index 19f09d5f77c..3071ad16ad6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md @@ -32,7 +32,7 @@ struct X { } global; ``` -The following sample generates C4742. +The following example generates C4742. ```c // C4742b.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md index 3663a249cff..4bb1217c9df 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md @@ -20,7 +20,7 @@ To resolve this warning, either use the same type definition or use different na ## Example -The following sample generates C4743. To compile it, place both files in the same folder, then run this command in a developer command prompt: +The following example generates C4743. To compile it, place both files in the same folder, then run this command in a developer command prompt: ```cmd cl /EHsc /W1 /GL /O2 C4743a.cpp C4743b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md index b0eb87ddc3f..df60c3ad08e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md @@ -16,11 +16,11 @@ An external variable referenced or defined in two files has different types in t C4744 is emitted only when files are compiled with /GL. For more information, see [/GL (Whole Program Optimization)](../../build/reference/gl-whole-program-optimization.md). > [!NOTE] -> C4744 usually occurs in C (not C++) files, because in C++ a variable name is decorated with type information. When the sample (below) is compiles as C++, you'll get linker error LNK2019. +> C4744 usually occurs in C (not C++) files, because in C++ a variable name is decorated with type information. When the example (below) is compiles as C++, you'll get linker error LNK2019. ## Example -This sample contains the first definition. +This example contains the first definition. ```c // C4744.c @@ -28,7 +28,7 @@ This sample contains the first definition. int global; ``` -The following sample generates C4744. +The following example generates C4744. ```c // C4744b.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md index 26cfa5b6e09..4354ddd8827 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md @@ -23,7 +23,7 @@ For more information, see [Initialization of Mixed Assemblies](../../dotnet/init ## Example -The following sample generates C4747. +The following example generates C4747. ```cpp // C4747.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md index 01c54150135..05a62944e0f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md @@ -22,7 +22,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4738: +The following example generates C4738: ```cpp // C4738.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md index 701b03facf1..b1c60fba344 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md @@ -18,7 +18,7 @@ To address this warning, remove the unreachable code or assure that all source c ## Examples -The following sample generates C4702. To fix it, remove the unreachable code. +The following example generates C4702. To fix it, remove the unreachable code. ```cpp // C4702.cpp @@ -35,7 +35,7 @@ Error C4702 can occur in some versions of the compiler when you compile using th For more information, see [`/EH` (Exception Handling Model)](../../build/reference/eh-exception-handling-model.md). -The following sample generates C4702: +The following example generates C4702: ```cpp // C4702b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md index 04183c4e86b..cb34db902d3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md @@ -17,7 +17,7 @@ An assignment has a value (the value on the left side of the assignment) that ca ## Example -The following sample generates C4706: +The following example generates C4706: ```cpp // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md index 957d27824b0..a73aeda5d78 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md @@ -16,7 +16,7 @@ When a comma occurs in an array index expression, the compiler uses the value af ## Example -The following sample generates C4709: +The following example generates C4709: ```cpp // C4709.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md index 6661b1b1569..3f4761478cb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md @@ -32,7 +32,7 @@ In some cases, the compiler will not inline a particular function for mechanical ## Example -The following sample generates C4714: +The following example generates C4714: ```cpp // C4714.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md index a342806d519..63e3daed710 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md @@ -16,7 +16,7 @@ Your code contains an inline assembly instruction that may not produce accurate ## Example -The following sample generates C4725: +The following example generates C4725: ```cpp // C4725.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md index 2b19c7d9341..ccdf31df98a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md @@ -16,7 +16,7 @@ When there is a jump in to or out of an **`asm`** block, global optimizations ar ## Example -The following sample generates C4740: +The following example generates C4740: ```cpp // C4740.cpp From 60c0a43d861012d2ebb6a6e76b0a9ecf0ab146aa Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 17:18:54 +0800 Subject: [PATCH 1061/1799] Update metadata for warning references in range [C4701, C4750] --- .../compiler-warnings/compiler-warning-c4746.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4711.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4715.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4716.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4717.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4727.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4729.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4730.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4731.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4733.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4739.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4742.md | 3 +-- .../compiler-warnings/compiler-warning-level-1-c4743.md | 3 +-- .../compiler-warnings/compiler-warning-level-1-c4750.md | 1 - .../compiler-warnings/compiler-warning-level-3-c4723.md | 1 - .../compiler-warnings/compiler-warning-level-3-c4724.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4738.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4701.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4702.md | 3 +-- .../compiler-warnings/compiler-warning-level-4-c4703.md | 3 +-- .../compiler-warnings/compiler-warning-level-4-c4706.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4709.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4710.md | 3 +-- .../compiler-warnings/compiler-warning-level-4-c4714.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4718.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4725.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4740.md | 5 ++--- 27 files changed, 45 insertions(+), 71 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4746.md b/docs/error-messages/compiler-warnings/compiler-warning-c4746.md index 0fdd3e41e56..529e25e81c6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4746.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4746.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4746" title: "Compiler Warning C4746" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4746" +ms.date: 11/04/2016 f1_keywords: ["C4746"] helpviewer_keywords: ["C4746"] -ms.assetid: 5e79ab46-6031-499a-a986-716c866b6c0e --- # Compiler Warning C4746 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md index 27aacc37133..1f8acf57625 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4711" title: "Compiler Warning (level 1) C4711" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4711" +ms.date: 11/04/2016 f1_keywords: ["C4711"] helpviewer_keywords: ["C4711"] -ms.assetid: 270506ab-fead-4328-b714-2978113be238 --- # Compiler Warning (level 1) C4711 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md index 038477736a4..25d7aa33e25 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4715" title: "Compiler Warning (level 1) C4715" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4715" +ms.date: 11/04/2016 f1_keywords: ["C4715"] helpviewer_keywords: ["C4715"] -ms.assetid: 1c819bf7-0d8b-4f5e-b338-9cc292870439 --- # Compiler Warning (level 1) C4715 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md index 7a2c54bf0dc..ed6196b2104 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4716" title: "Compiler Warning (level 1) C4716" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4716" +ms.date: 11/04/2016 f1_keywords: ["C4716"] helpviewer_keywords: ["C4716"] -ms.assetid: d95ecfe5-870f-461f-a746-7913af98414b --- # Compiler Warning (level 1) C4716 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md index acab0594192..a546f804471 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4717" title: "Compiler Warning (level 1) C4717" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4717" +ms.date: 11/04/2016 f1_keywords: ["C4717"] helpviewer_keywords: ["C4717"] -ms.assetid: 5ef3c6c7-8599-4714-a973-0f5b69cdab3c --- # Compiler Warning (level 1) C4717 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md index 060c9e8811c..d791c9190ce 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4727" title: "Compiler Warning (level 1) C4727" -ms.date: "08/19/2019" +description: "Learn more about: Compiler Warning (level 1) C4727" +ms.date: 08/19/2019 f1_keywords: ["C4727"] helpviewer_keywords: ["C4727"] -ms.assetid: 991b0087-3a50-40f5-9cdb-cdc367cd472c --- # Compiler Warning (level 1) C4727 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md index 4a3a4145f7a..d8b24fc3922 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4729" title: "Compiler Warning (Level 1) C4729" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4729" +ms.date: 11/04/2016 f1_keywords: ["C4729"] helpviewer_keywords: ["C4729"] -ms.assetid: 36a0151f-f258-48d9-9444-ae6d41ff70a4 --- # Compiler Warning (Level 1) C4729 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md index b0493e30ede..3856100db3a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4730" title: "Compiler Warning (Level 1) C4730" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4730" +ms.date: 11/04/2016 f1_keywords: ["C4730"] helpviewer_keywords: ["C4730"] -ms.assetid: 11303e3f-162b-4b19-970a-479686123a68 --- # Compiler Warning (Level 1) C4730 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md index 107a659a8e0..cdefa78d6b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4731" title: "Compiler Warning (Level 1) C4731" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4731" +ms.date: 11/04/2016 f1_keywords: ["C4731"] helpviewer_keywords: ["C4731"] -ms.assetid: 5658c24c-3e6f-4505-835b-1fb92d47cab0 --- # Compiler Warning (Level 1) C4731 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md index 87c92038cfb..d4e0f431ea3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4733" title: "Compiler Warning (Level 1) C4733" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4733" +ms.date: 11/04/2016 f1_keywords: ["C4733"] helpviewer_keywords: ["C4733"] -ms.assetid: 7ef4f577-772d-4b66-a7bf-8958a6b250bc --- # Compiler Warning (Level 1) C4733 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md index f581ce400bb..d9fb0cb42b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4739" title: "Compiler Warning (Level 1) C4739" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4739" +ms.date: 11/04/2016 f1_keywords: ["C4739"] helpviewer_keywords: ["C4739"] -ms.assetid: 600873b3-7c85-4cd4-944e-cd8e01bfcbb0 --- # Compiler Warning (Level 1) C4739 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md index 3071ad16ad6..65aee758f44 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4742" title: "Compiler Warning (Level 1) C4742" +description: "Learn more about: Compiler Warning (Level 1) C4742" ms.date: 07/22/2020 f1_keywords: ["C4742"] helpviewer_keywords: ["C4742"] -ms.assetid: e520881d-1eeb-48b1-9df0-8017ee8ba076 --- # Compiler Warning (Level 1) C4742 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md index 4bb1217c9df..3eb845751b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4743" title: "Compiler Warning (Level 1) C4743" +description: "Learn more about: Compiler Warning (Level 1) C4743" ms.date: 06/16/2022 f1_keywords: ["C4743"] helpviewer_keywords: ["C4743"] -ms.assetid: 2ee76ea3-77f3-4c2f-9a57-0751823c89fd --- # Compiler Warning (Level 1) C4743 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4750.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4750.md index da0b7a82489..8739b355309 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4750.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4750.md @@ -4,7 +4,6 @@ description: "Describes MSVC compiler warning C4750 about a possible stack overf ms.date: 07/08/2020 f1_keywords: ["C4750"] helpviewer_keywords: ["C4750"] -ms.assetid: b0b2c938-7d2a-4c36-8270-7daee15ffee3 --- # Compiler Warning (level 1) C4750 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md index e7d06ecd2a6..d41de92232c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md @@ -4,7 +4,6 @@ description: "Describes the MSVC compiler warning C4723 for potential divide by ms.date: 07/08/2020 f1_keywords: ["C4723"] helpviewer_keywords: ["C4723"] -ms.assetid: 07669d14-3fd8-4a43-94bc-b61c50e58460 --- # Compiler Warning (level 3) C4723 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md index 81b9329525d..d1cdf080f8a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4724" title: "Compiler Warning (level 3) C4724" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4724" +ms.date: 11/04/2016 f1_keywords: ["C4724"] helpviewer_keywords: ["C4724"] -ms.assetid: 3be4305b-e8fe-49a9-abbf-b20dfbd71a19 --- # Compiler Warning (level 3) C4724 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md index 05a62944e0f..418c5042309 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 3) C4738" title: "Compiler Warning (Level 3) C4738" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 3) C4738" +ms.date: 11/04/2016 f1_keywords: ["C4738"] helpviewer_keywords: ["C4738"] -ms.assetid: 9094895f-7eec-46c2-83d3-249b761d585e --- # Compiler Warning (Level 3) C4738 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md index de8b137f7ef..9200e630f18 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4701" title: "Compiler Warning (level 4) C4701" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4701" +ms.date: 11/04/2016 f1_keywords: ["C4701"] helpviewer_keywords: ["C4701"] -ms.assetid: d7c76c66-1f3f-4d3c-abe4-5d94c84a5a1f --- # Compiler Warning (level 4) C4701 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md index b1c60fba344..04cc02f7efe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4702" title: "Compiler Warning (level 4) C4702" +description: "Learn more about: Compiler Warning (level 4) C4702" ms.date: 09/20/2021 f1_keywords: ["C4702"] helpviewer_keywords: ["C4702"] -ms.assetid: d8198c1e-8762-42a6-9e6b-cb568b7a1686 --- # Compiler Warning (level 4) C4702 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4703.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4703.md index af2e4d53e94..b15a4cd6a68 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4703.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4703.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4703" title: "Compiler Warning (level 4) C4703" +description: "Learn more about: Compiler Warning (level 4) C4703" ms.date: 08/30/2022 f1_keywords: ["C4703"] helpviewer_keywords: ["C4703"] -ms.assetid: 5dad454e-69e3-4931-9168-050a861c05f8 --- # Compiler Warning (level 4) C4703 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md index cb34db902d3..314f98a8a40 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4706" title: "Compiler Warning (level 4) C4706" -ms.date: "3/5/2025" +description: "Learn more about: Compiler Warning (level 4) C4706" +ms.date: 3/5/2025 f1_keywords: ["C4706"] helpviewer_keywords: ["C4706"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md index a73aeda5d78..4061b8eaabb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4709" title: "Compiler Warning (level 4) C4709" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4709" +ms.date: 11/04/2016 f1_keywords: ["C4709"] helpviewer_keywords: ["C4709"] -ms.assetid: 8abfdd45-8c70-4c27-b0fb-ca0c3f0fccf9 --- # Compiler Warning (level 4) C4709 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md index 80c1d4217ce..7e6ab51b762 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4710" title: "Compiler Warning (level 4) C4710" +description: "Learn more about: Compiler Warning (level 4) C4710" ms.date: 10/19/2021 f1_keywords: ["C4710"] helpviewer_keywords: ["C4710"] -ms.assetid: 76381ec7-3fc1-4bee-9a0a-c2c8307b92e2 --- # Compiler Warning (level 4) C4710 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md index 3f4761478cb..1e8cb117833 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4714" title: "Compiler Warning (level 4) C4714" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4714" +ms.date: 11/04/2016 f1_keywords: ["C4714"] helpviewer_keywords: ["C4714"] -ms.assetid: 22c7fd0c-899d-4e9b-95f3-725b2c49fb46 --- # Compiler Warning (level 4) C4714 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md index 534705501ee..0d1e87cd79d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4718" title: "Compiler Warning (level 4) C4718" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4718" +ms.date: 11/04/2016 f1_keywords: ["C4718"] helpviewer_keywords: ["C4718"] -ms.assetid: 29507f8a-b024-42c1-a3b8-f35d1f2641f3 --- # Compiler Warning (level 4) C4718 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md index 63e3daed710..e758e619545 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4725" title: "Compiler Warning (level 4) C4725" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4725" +ms.date: 11/04/2016 f1_keywords: ["C4725"] helpviewer_keywords: ["C4725"] -ms.assetid: effa0335-71c3-4b3b-8618-da4b9b46a95d --- # Compiler Warning (level 4) C4725 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md index ccdf31df98a..9caf86e10b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 4) C4740" title: "Compiler Warning (Level 4) C4740" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 4) C4740" +ms.date: 11/04/2016 f1_keywords: ["C4740"] helpviewer_keywords: ["C4740"] -ms.assetid: 85528969-966a-44b4-8a2f-971704c64477 --- # Compiler Warning (Level 4) C4740 From 8e31443d2634e646f1fba03e4219fce0f6ee1e08 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 17:21:02 +0800 Subject: [PATCH 1062/1799] Add leading example sentence in C4715 warning reference --- .../compiler-warnings/compiler-warning-level-1-c4715.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md index 25d7aa33e25..7350b2edfe6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md @@ -15,6 +15,8 @@ The specified function can potentially not return a value. ## Example +The following example generates C4715: + ```cpp // C4715a.cpp // compile with: /W1 /LD From 55088aecfe477b359dd22bc532e49bc0257d05de Mon Sep 17 00:00:00 2001 From: Carsten Rudolph <18394207+crud89@users.noreply.github.com> Date: Tue, 2 Sep 2025 14:53:03 +0200 Subject: [PATCH 1063/1799] Use environment variables to specify compiler preferences. The cache variables `CMAKE_C_COMPILER` and `CMAKE_CXX_COMPILER` must only be set during the initial cache creation. Specifying them in a preset will cause them to be reset during subsequent cache configurations, resulting in a cache invalidation, which can break the build. Using the `CC` and `CXX` environment variables to initialize those cache variables is the proper way to avoid this issue. --- docs/build/cmake-presets-vs.md | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index 87d3fd71461..1706bdbbe17 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -205,29 +205,33 @@ The official [CMake documentation](https://cmake.org/cmake/help/latest/manual/cm ### Select your compilers -You can set C and C++ compilers by using `cacheVariables.CMAKE_C_COMPILER` and `cacheVariables.CMAKE_CXX_COMPILER` in a Configure Preset. It's equivalent to passing `-D CMAKE_C_COMPILER=` and `-D CMAKE_CXX_COMPILER=` to CMake from the command line. For more information, see [`CMAKE__COMPILER`](https://cmake.org/cmake/help/latest/variable/CMAKE_LANG_COMPILER.html#cmake-lang-compiler). +You can set C and C++ compilers by using `environmentVariables.CC` and `environmentVariables.CXX` in a Configure Preset. For more information, see [`CC`](https://cmake.org/cmake/help/latest/envvar/CC.html)/[`CXX`](https://cmake.org/cmake/help/latest/envvar/CXX.html). Use the following examples to build with `cl.exe` and `clang-cl.exe` from Visual Studio. The C++ Clang tools for Windows components must be installed for you to build with `clang-cl`. Build with `cl.exe`: ```json +"environmentVariables": { + "CC": "cl", + "CXX": "cl" +}, "cacheVariables": { "CMAKE_BUILD_TYPE": "Debug", - "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}", - "CMAKE_C_COMPILER": "cl", - "CMAKE_CXX_COMPILER": "cl" + "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}" }, ``` Build with `clang`: ```json +"environmentVariables": { + "CC": "clang-cl", + "CXX": "clang-cl" +}, "cacheVariables": { "CMAKE_BUILD_TYPE": "Debug", "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}", - "CMAKE_C_COMPILER": "clang-cl", - "CMAKE_CXX_COMPILER": "clang-cl" }, "vendor": { @@ -264,11 +268,13 @@ To reproduce these builds outside Visual Studio, see [Run CMake from the command To build on Linux or without the Visual C++ toolset, specify the name of a compiler on your `PATH` instance, or an environment variable that evaluates to the full path of a compiler. Full paths are discouraged so that the file can remain shareable. A preset that builds with GCC version 8 might look like this: ```json +"environmentVariables": { + "CC": "gcc-8", + "CXX": "g++-8" +}, "cacheVariables": { "CMAKE_BUILD_TYPE": "Debug", - "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}", - "CMAKE_C_COMPILER": "gcc-8", - "CMAKE_CXX_COMPILER": "g++-8" + "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}" }, ``` From a3f18e6b7d5e6ca317dc47c6cf7ed0937928cc9b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 23:16:06 +0800 Subject: [PATCH 1064/1799] Add blockquotes for warning messages in range [C4751, C4830] --- .../compiler-warnings/compiler-warning-level-1-c4772.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4788.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4794.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4803.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4804.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4805.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4806.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4807.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4810.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4811.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4812.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4813.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4817.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4822.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4829.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4756.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4792.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4823.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4754.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4764.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4816.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4820.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md index efe45fc03e2..7ea34f352f9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md @@ -8,7 +8,7 @@ ms.assetid: dafe6fd8-9faf-41f5-9d66-a55838742c14 --- # Compiler Warning (level 1) C4772 -> \#import referenced a type from a missing type library; '*missing-type*' used as a placeholder +> #import referenced a type from a missing type library; '*missing-type*' used as a placeholder A type library was referenced with the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. However, the type library contained a reference to another type library that was not referenced with `#import`. This other .tlb file was not found by the compiler. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md index 4d871d446c9..2041d800067 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md @@ -8,7 +8,7 @@ ms.assetid: 47d75bda-f833-4bdd-93a0-a134df0cd303 --- # Compiler Warning (Level 1) C4788 -'identifier' : identifier was truncated to 'number' characters +> 'identifier' : identifier was truncated to 'number' characters The compiler limits the maximum length allowed for a function name. When the compiler generates funclets for EH/SEH code, it forms the funclet name by prepending the function name with some text, for example "__catch", "\__unwind", or another string. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md index 909387c2dc9..0431e748acf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md @@ -8,7 +8,7 @@ ms.assetid: badc9c36-fa1a-4fec-929b-7bfda7a7b79f --- # Compiler Warning (level 1) C4794 -segment of thread local storage variable 'variable' changed from 'section name' to '.tls$' +> segment of thread local storage variable 'variable' changed from 'section name' to '.tls$' You used [#pragma data_seg](../../preprocessor/data-seg.md) to put a tls variable in a section not starting with .tls$. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md index 8a242d9c74d..31db90c0f81 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md @@ -8,7 +8,7 @@ ms.assetid: 2552f3a6-c418-49f4-98a2-a929857be658 --- # Compiler Warning (level 1) C4803 -'method' : the raise method has a different storage class from that of the event, 'event' +> 'method' : the raise method has a different storage class from that of the event, 'event' Event methods must have the same storage class as the event declaration. The compiler adjusts the event's methods so that the storage classes are the same. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md index 3d6298288d6..16b83d4f166 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md @@ -8,7 +8,7 @@ ms.assetid: 069e8f44-3ef6-43bb-8524-4116fc6eea83 --- # Compiler Warning (level 1) C4804 -'operation' : unsafe use of type 'bool' in operation +> 'operation' : unsafe use of type 'bool' in operation This warning is for when you used a **`bool`** variable or value in an unexpected way. For example, C4804 is generated if you use operators such as the negative unary operator (**-**) or the complement operator (`~`). The compiler evaluates the expression. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md index 02304303c4f..f6f1b6922b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md @@ -8,7 +8,7 @@ ms.assetid: 99c7b7e2-272e-4ab5-8580-17c42e62e2ef --- # Compiler Warning (level 1) C4805 -'operation' : unsafe mix of type 'type' and type 'type' in operation +> 'operation' : unsafe mix of type 'type' and type 'type' in operation This warning is generated for comparison operations between [bool](../../cpp/bool-cpp.md) and [int](../../c-language/integer-types.md). The following sample generates C4805: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md index 276e5adc69e..0dc589a940a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md @@ -8,7 +8,7 @@ ms.assetid: 79eb74cd-b925-4b5b-84e1-8ae6f33e38b3 --- # Compiler Warning (level 1) C4806 -'operation' : unsafe operation: no value of type 'type' promoted to type 'type' can equal the given constant +> 'operation' : unsafe operation: no value of type 'type' promoted to type 'type' can equal the given constant This message warns against code such as `b == 3`, where `b` has type **`bool`**. The promotion rules cause **`bool`** to be promoted to **`int`**. This is legal, but it can never be **`true`**. The following sample generates C4806: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md index 1bfb761d9af..88df85d9540 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md @@ -8,7 +8,7 @@ ms.assetid: 089c9f87-fd81-402e-9826-66a8ef1ef1fe --- # Compiler Warning (level 1) C4807 -'operation' : unsafe mix of type 'type' and signed bitfield of type 'type' +> 'operation' : unsafe mix of type 'type' and signed bitfield of type 'type' This warning is generated when comparing a one-bit signed bit field to a **`bool`** variable. Because a one-bit, signed bit field can only contain the values -1 or 0, it is dangerous to compare it to **`bool`**. No warnings are generated about mixing **`bool`** and one-bit, unsigned bitfields since they are identical to **`bool`** and can only hold 0 or 1. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md index 50bdb9be685..56cf1c3e16c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md @@ -8,7 +8,7 @@ ms.assetid: 39e2cae0-9c1c-4ac1-aaa0-5f661d06085b --- # Compiler Warning (level 1) C4810 -value of pragma pack(show) == n +> value of pragma pack(show) == n This warning is issued when you use the **show** option of the [pack](../../preprocessor/pack.md) pragma. *n* is the current pack value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md index 5a5797e5809..cc0165ea39c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md @@ -8,6 +8,6 @@ ms.assetid: fbd79351-3dc1-45cf-b5b3-411f48c1590f --- # Compiler Warning (level 1) C4811 -value of pragma conform(forScope, show) == value +> value of pragma conform(forScope, show) == value This warning is issued when you use the **show** option of the [conform](../../preprocessor/conform.md) pragma. *value* is the current conform value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md index 07221f45109..26ad7348041 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md @@ -8,7 +8,7 @@ ms.assetid: a7f5721f-2019-44de-ad62-ed30bac8b1f3 --- # Compiler Warning (level 1) C4812 -obsolete declaration style: please use 'new_syntax' instead +> obsolete declaration style: please use 'new_syntax' instead In the current release of Visual C++, the explicit constructor specialization is still supported, but it may not be supported in a future release. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md index 532b62c42aa..e7426d3f1c2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md @@ -8,7 +8,7 @@ ms.assetid: c30bf877-ab04-4fe4-897e-8162092426f0 --- # Compiler Warning (level 1) C4813 -'function' : a friend function of a local class must have been previously declared +> 'function' : a friend function of a local class must have been previously declared A friend function in an inner class was not declared in the outer class. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md index 1bd7d8b68af..5c12a6d5ff3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md @@ -8,7 +8,7 @@ ms.assetid: a68f5486-6940-4934-9f93-bfd4d71f92a9 --- # Compiler Warning (level 1) C4817 -'member' : illegal use of '.' to access this member; compiler replaced with '->' +> 'member' : illegal use of '.' to access this member; compiler replaced with '->' The wrong member access operator was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md index 51968a971dc..4320b22cc5c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md @@ -8,7 +8,7 @@ ms.assetid: 0f231a30-2eb0-4722-aaa0-e2d19d3e7eea --- # Compiler Warning (level 1) C4822 -'member' : local class member function does not have a body +> 'member' : local class member function does not have a body ## Remarks diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md index 42a6d4cced6..20dec7a0f66 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md @@ -8,7 +8,7 @@ ms.assetid: 4ffabe2b-2ddc-4c52-8564-d1355c93cfa6 --- # Compiler Warning (level 1) C4829 -Possibly incorrect parameters to function main. Consider 'intmain(Platform::Array\^ argv)' +> Possibly incorrect parameters to function main. Consider 'intmain(Platform::Array\^ argv)' Certain functions, such as main, cannot take reference type parameters. While compilation will succeed, the resulting image will probably not run. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md index 41c25723109..38f368cb2b2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md @@ -8,7 +8,7 @@ ms.assetid: 5a16df83-6b82-4619-83bd-319af4ef1d1d --- # Compiler Warning (level 2) C4756 -overflow in constant arithmetic +> overflow in constant arithmetic The compiler generated an exception while doing constant arithmetic during compilation. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md index a4e6e483aea..ab2ff6b8469 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md @@ -8,7 +8,7 @@ ms.assetid: c047ce69-a622-44e1-9425-d41aa9261c61 --- # Compiler Warning (level 3) C4792 -function 'function' declared using sysimport and referenced from native code; import library required to link +> function 'function' declared using sysimport and referenced from native code; import library required to link A native function that was imported into the program with DllImport was called from an unmanaged function. Therefore, you must link to the import library for the DLL. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md index 3a8f659d426..13972b205c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md @@ -8,7 +8,7 @@ ms.assetid: 8a77560d-dcea-4cae-aebb-8ebf1b4cef85 --- # Compiler Warning (level 3) C4823 -'function' : uses pinning pointers but unwind semantics are not enabled. Consider using /EHa +> 'function' : uses pinning pointers but unwind semantics are not enabled. Consider using /EHa To unpin an object on the managed heap pointed to by a pinning pointer declared in a block scope, the compiler simulates the behavior of destructors of local classes, "pretending" the pinning pointer has a destructor that nullifies the pointer. To enable a call to a destructor after throwing an exception, you must enable object unwinding, which you can do by using [/EHsc](../../build/reference/eh-exception-handling-model.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md index b5fcf28fe24..3f47a73b361 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md @@ -8,7 +8,7 @@ ms.assetid: e0e4606a-754a-4f42-a274-21a34978d21d --- # Compiler Warning (level 4) C4754 -Conversion rules for arithmetic operations in a comparison mean that one branch cannot be executed. +> Conversion rules for arithmetic operations in a comparison mean that one branch cannot be executed. The C4754 warning is issued because the result of the comparison is always the same. This indicates that one of the branches of the condition is never executed, most likely because the associated integer expression is incorrect. This code defect often occurs in incorrect integer overflow checks on 64-bit architectures. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md index d1767d47506..a11948ef358 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md @@ -8,7 +8,7 @@ ms.assetid: 7bd4296f-966b-484c-bf73-8dbc8e85b4a9 --- # Compiler Warning (level 4) C4764 -Cannot align catch objects to greater than 16 bytes +> Cannot align catch objects to greater than 16 bytes An alignment greater than 16 was specified, but on some platforms, if the function throws an exception, the stack will force an alignment of not greater than 16. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md index 2adb8e107e5..4365a42356c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md @@ -8,7 +8,7 @@ ms.assetid: 60f730ae-d942-4db9-ab97-41d4a874d8da --- # Compiler Warning (level 4) C4816 -'param' : parameter has a zero-sized array which will be truncated (unless the object is passed by reference) +> 'param' : parameter has a zero-sized array which will be truncated (unless the object is passed by reference) A parameter to an object with a zero-size array was not passed by reference. The array will not get copied when the object is passed. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md index 4a2288a609d..2a30c930c2c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md @@ -8,7 +8,7 @@ ms.assetid: 17aa29f4-c287-49b8-bc43-8ed82ffed5ea --- # Compiler Warning (level 4) C4820 -'bytes' bytes padding added after construct 'member_name' +> 'bytes' bytes padding added after construct 'member_name' The type and order of elements caused the compiler to add padding to the end of a struct. See [align](../../cpp/align-cpp.md) for more information on padding in a struct. From 652ab07f063f122084c25e99b0ec2c9daf28db3b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 23:24:43 +0800 Subject: [PATCH 1065/1799] Add "Remarks" and "Example" headings for warning references in range [C4751, C4830] --- docs/error-messages/compiler-warnings/c4768.md | 4 ++-- docs/error-messages/compiler-warnings/c4770.md | 4 ++-- .../compiler-warning-level-1-and-3-c4793.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4772.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4788.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4794.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4799.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4803.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4804.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4805.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4806.md | 8 +++++++- .../compiler-warnings/compiler-warning-level-1-c4807.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4810.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4811.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4812.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4813.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4817.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4819.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4821.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4829.md | 4 ++++ .../compiler-warnings/compiler-warning-level-2-c4756.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4792.md | 4 ++++ .../compiler-warnings/compiler-warning-level-3-c4800.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4823.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4754.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4764.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4816.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4820.md | 4 ++++ 28 files changed, 84 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4768.md b/docs/error-messages/compiler-warnings/c4768.md index ac07f56f108..2e6da6eec85 100644 --- a/docs/error-messages/compiler-warnings/c4768.md +++ b/docs/error-messages/compiler-warnings/c4768.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4768"] > `__declspec` attributes before linkage specification are ignored -The compiler warns if `__declspec(...)` is applied before the `extern "C"` linkage specification. Previously, the compiler would ignore the attribute, which could have runtime implications. - ## Remarks +The compiler warns if `__declspec(...)` is applied before the `extern "C"` linkage specification. Previously, the compiler would ignore the attribute, which could have runtime implications. + This warning is new in Visual Studio 2017 version 15.3, which left it off by default. It's enabled by default as a level 3 warning starting in Visual Studio 2017 version 15.5. For information on how to disable warnings by compiler version, see [Compiler warnings by compiler version](compiler-warnings-by-compiler-version.md). ## Example diff --git a/docs/error-messages/compiler-warnings/c4770.md b/docs/error-messages/compiler-warnings/c4770.md index 3acd9eddc4f..5afbc067883 100644 --- a/docs/error-messages/compiler-warnings/c4770.md +++ b/docs/error-messages/compiler-warnings/c4770.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4770"] > partially validated enum '*symbol*' used as index -The compiler warns if an enum value is cast or aliased to an integer type, but the result isn't checked for non-negative or excessive values. - ## Remarks +The compiler warns if an enum value is cast or aliased to an integer type, but the result isn't checked for non-negative or excessive values. + This warning is new in Visual Studio 2013. It's not enabled by default. To enable it as a level 1 warning, use `/w14770`. For information on how to disable warnings by compiler version, see [Compiler warnings by compiler version](compiler-warnings-by-compiler-version.md). ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md index ae937e3ff24..fae4a118757 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md @@ -30,7 +30,7 @@ The following table lists all possible continuation messages. |A non-__clrcall virtual function thunk must be compiled as native|A non-[__clrcall](../../cpp/clrcall.md) virtual function thunk must use an unmanaged address.| |A function using '_setjmp' must be compiled as native|The CLR must be able to control program execution. However, the [setjmp](../../cpp/using-setjmp-longjmp.md) function bypasses regular program execution by saving and restoring low-level information such as registers and execution state.| -## Example +## Examples The following sample generates C4793. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md index 7ea34f352f9..22d80dab0e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md @@ -10,6 +10,8 @@ ms.assetid: dafe6fd8-9faf-41f5-9d66-a55838742c14 > #import referenced a type from a missing type library; '*missing-type*' used as a placeholder +## Remarks + A type library was referenced with the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. However, the type library contained a reference to another type library that was not referenced with `#import`. This other .tlb file was not found by the compiler. Note that the compiler will not find type libraries in different directories if you use the [/I (Additional Include Directories)](../../build/reference/i-additional-include-directories.md) compiler option to specify those directories. If you want the compiler to find type libraries in different directories, add those directories to the PATH environment variable. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md index 2041d800067..7318f3f079a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md @@ -10,11 +10,17 @@ ms.assetid: 47d75bda-f833-4bdd-93a0-a134df0cd303 > 'identifier' : identifier was truncated to 'number' characters +## Remarks + The compiler limits the maximum length allowed for a function name. When the compiler generates funclets for EH/SEH code, it forms the funclet name by prepending the function name with some text, for example "__catch", "\__unwind", or another string. The resulting funclet name can be too long, and the compiler will truncate it and generate C4788. -To resolve this warning, shorten the original function name. If the function is a C++ function template or method, use a typedef for part of the name. For example: +To resolve this warning, shorten the original function name. If the function is a C++ function template or method, use a typedef for part of the name. + +## Example + +For example: ```cpp C1>::C2::f diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md index 0431e748acf..5c3af428901 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md @@ -10,6 +10,8 @@ ms.assetid: badc9c36-fa1a-4fec-929b-7bfda7a7b79f > segment of thread local storage variable 'variable' changed from 'section name' to '.tls$' +## Remarks + You used [#pragma data_seg](../../preprocessor/data-seg.md) to put a tls variable in a section not starting with .tls$. The .tls$*x* section will exist in the object file where [__declspec(thread)](../../cpp/thread.md) variables are defined. A .tls section in the EXE or DLL will result from these sections. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md index a5c280ad860..20dc701fdd5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4799"] > function '*function*' has no EMMS instruction +## Remarks + The function has at least one MMX instruction, but does not have an `EMMS` instruction. When a multimedia instruction is used, an `EMMS` instruction or [`_mm_empty`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm_empty) intrinsic should also be used to clear the multimedia tag word at the end of the MMX code. You may get C4799 when using `ivec.h`, indicating that the code does not properly execute the `EMMS` instruction before returning. This is a false warning for these headers. You may turn these off by defining `_SILENCE_IVEC_C4799` in `ivec.h`. However, be aware that this will also keep the compiler from giving correct warnings of this type. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md index 31db90c0f81..110767c0c8d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md @@ -10,6 +10,8 @@ ms.assetid: 2552f3a6-c418-49f4-98a2-a929857be658 > 'method' : the raise method has a different storage class from that of the event, 'event' +## Remarks + Event methods must have the same storage class as the event declaration. The compiler adjusts the event's methods so that the storage classes are the same. This warning can occur if you have a class that implements an event from an interface. The compiler does not implicitly generate a raise method for an event in an interface. When you implement that interface in a class, the compiler does implicitly generate a raise method and that method will not be virtual, hence the warning. For more information on events, see [event](../../extensions/event-cpp-component-extensions.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md index 16b83d4f166..508baa97d3c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md @@ -10,6 +10,8 @@ ms.assetid: 069e8f44-3ef6-43bb-8524-4116fc6eea83 > 'operation' : unsafe use of type 'bool' in operation +## Remarks + This warning is for when you used a **`bool`** variable or value in an unexpected way. For example, C4804 is generated if you use operators such as the negative unary operator (**-**) or the complement operator (`~`). The compiler evaluates the expression. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md index f6f1b6922b8..d0fbed526f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md @@ -10,7 +10,13 @@ ms.assetid: 99c7b7e2-272e-4ab5-8580-17c42e62e2ef > 'operation' : unsafe mix of type 'type' and type 'type' in operation -This warning is generated for comparison operations between [bool](../../cpp/bool-cpp.md) and [int](../../c-language/integer-types.md). The following sample generates C4805: +## Remarks + +This warning is generated for comparison operations between [bool](../../cpp/bool-cpp.md) and [int](../../c-language/integer-types.md). + +## Example + +The following sample generates C4805: ```cpp // C4805.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md index 0dc589a940a..2a797ed808c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md @@ -10,7 +10,13 @@ ms.assetid: 79eb74cd-b925-4b5b-84e1-8ae6f33e38b3 > 'operation' : unsafe operation: no value of type 'type' promoted to type 'type' can equal the given constant -This message warns against code such as `b == 3`, where `b` has type **`bool`**. The promotion rules cause **`bool`** to be promoted to **`int`**. This is legal, but it can never be **`true`**. The following sample generates C4806: +## Remarks + +This message warns against code such as `b == 3`, where `b` has type **`bool`**. The promotion rules cause **`bool`** to be promoted to **`int`**. This is legal, but it can never be **`true`**. + +## Example + +The following sample generates C4806: ```cpp // C4806.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md index 88df85d9540..b33dc17c937 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md @@ -10,6 +10,8 @@ ms.assetid: 089c9f87-fd81-402e-9826-66a8ef1ef1fe > 'operation' : unsafe mix of type 'type' and signed bitfield of type 'type' +## Remarks + This warning is generated when comparing a one-bit signed bit field to a **`bool`** variable. Because a one-bit, signed bit field can only contain the values -1 or 0, it is dangerous to compare it to **`bool`**. No warnings are generated about mixing **`bool`** and one-bit, unsigned bitfields since they are identical to **`bool`** and can only hold 0 or 1. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md index 56cf1c3e16c..e047f841d5f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md @@ -10,8 +10,12 @@ ms.assetid: 39e2cae0-9c1c-4ac1-aaa0-5f661d06085b > value of pragma pack(show) == n +## Remarks + This warning is issued when you use the **show** option of the [pack](../../preprocessor/pack.md) pragma. *n* is the current pack value. +## Example + For example, the following code shows how the C4810 warning works with the pack pragma: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md index cc0165ea39c..cce815a0cba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md @@ -10,4 +10,6 @@ ms.assetid: fbd79351-3dc1-45cf-b5b3-411f48c1590f > value of pragma conform(forScope, show) == value +## Remarks + This warning is issued when you use the **show** option of the [conform](../../preprocessor/conform.md) pragma. *value* is the current conform value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md index 26ad7348041..5bc64cdaaac 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md @@ -10,8 +10,12 @@ ms.assetid: a7f5721f-2019-44de-ad62-ed30bac8b1f3 > obsolete declaration style: please use 'new_syntax' instead +## Remarks + In the current release of Visual C++, the explicit constructor specialization is still supported, but it may not be supported in a future release. +## Example + The following sample generates C4812: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md index e7426d3f1c2..9635478c179 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md @@ -10,8 +10,12 @@ ms.assetid: c30bf877-ab04-4fe4-897e-8162092426f0 > 'function' : a friend function of a local class must have been previously declared +## Remarks + A friend function in an inner class was not declared in the outer class. +## Example + The following sample generates C4813: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md index 5c12a6d5ff3..7110ac64e9a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md @@ -10,6 +10,8 @@ ms.assetid: a68f5486-6940-4934-9f93-bfd4d71f92a9 > 'member' : illegal use of '.' to access this member; compiler replaced with '->' +## Remarks + The wrong member access operator was used. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md index 46f611babf6..a08b5f304b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md @@ -10,6 +10,8 @@ ms.assetid: c0316e85-249c-414d-9df0-622d077c6bc2 > The file contains a character that cannot be represented in the current code page (*number*). Save the file in Unicode format to prevent data loss. +## Remarks + C4819 occurs when you compile an ANSI source file on a system using a codepage that can't represent all characters in the file. There are several ways to resolve C4819. One simple way is to remove the offending character, if you don't need it, for example, if it's in a comment. You can set the system codepage in the Control Panel to one that supports the character set used by your source code. You can use Unicode [escape sequences](../../c-language/escape-sequences.md) to create characters or strings that use only the basic ANSI character set in your source code. Finally, you can save the file in a Unicode format with a signature, also known as a byte-order mark (BOM). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md index 0cb5746cef3..c92c4d56899 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md @@ -10,4 +10,6 @@ ms.assetid: c7768e77-0ee5-491e-8aa4-3915bf5bcbdf > Unable to determine Unicode encoding type, please save the file with signature (BOM) +## Remarks + The compiler could not determine the encoding type for a file. To resolve this warning, save the file with a byte order marker. See [Manage Files with Encoding](/sql/ssms/solution/manage-files-with-encoding) for more information. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md index 20dec7a0f66..4889a7a450e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md @@ -10,8 +10,12 @@ ms.assetid: 4ffabe2b-2ddc-4c52-8564-d1355c93cfa6 > Possibly incorrect parameters to function main. Consider 'intmain(Platform::Array\^ argv)' +## Remarks + Certain functions, such as main, cannot take reference type parameters. While compilation will succeed, the resulting image will probably not run. +## Example + The following sample generates C4829: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md index 38f368cb2b2..a714aca0e9c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md @@ -10,8 +10,12 @@ ms.assetid: 5a16df83-6b82-4619-83bd-319af4ef1d1d > overflow in constant arithmetic +## Remarks + The compiler generated an exception while doing constant arithmetic during compilation. +## Example + The following sample generates C4756: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md index ab2ff6b8469..282a2762119 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md @@ -10,10 +10,14 @@ ms.assetid: c047ce69-a622-44e1-9425-d41aa9261c61 > function 'function' declared using sysimport and referenced from native code; import library required to link +## Remarks + A native function that was imported into the program with DllImport was called from an unmanaged function. Therefore, you must link to the import library for the DLL. This warning cannot be resolved in code or by changing the way you compile. Use the [warning](../../preprocessor/warning.md) pragma to disable this warning. +## Example + The following sample generates C4792: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md index 128c92c9bb6..e3e0c8a0ccc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md @@ -16,6 +16,8 @@ Visual Studio 2019 and later: C4800 is a level 3 warning in Visual Studio 2015 and earlier: > '*type*' : forcing value to bool 'true' or 'false' (performance warning) +## Remarks + This warning is generated when a value is implicitly converted into type **`bool`**. Typically, this message is caused by assigning **`int`** variables to **`bool`** variables where the **`int`** variable contains only values **`true`** and **`false`**, and could be redeclared as type **`bool`**. If you can't rewrite the expression to use type **`bool`**, then you can add "`!=0`" to the expression, which gives the expression type **`bool`**. Casting the expression to type **`bool`** doesn't disable the warning, which is by design. ::: moniker range=">= msvc-150" diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md index 13972b205c3..44aad2d7360 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md @@ -10,6 +10,8 @@ ms.assetid: 8a77560d-dcea-4cae-aebb-8ebf1b4cef85 > 'function' : uses pinning pointers but unwind semantics are not enabled. Consider using /EHa +## Remarks + To unpin an object on the managed heap pointed to by a pinning pointer declared in a block scope, the compiler simulates the behavior of destructors of local classes, "pretending" the pinning pointer has a destructor that nullifies the pointer. To enable a call to a destructor after throwing an exception, you must enable object unwinding, which you can do by using [/EHsc](../../build/reference/eh-exception-handling-model.md). You can also manually unpin the object and ignore the warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md index 3f47a73b361..e2e5e442cf4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md @@ -10,6 +10,8 @@ ms.assetid: e0e4606a-754a-4f42-a274-21a34978d21d > Conversion rules for arithmetic operations in a comparison mean that one branch cannot be executed. +## Remarks + The C4754 warning is issued because the result of the comparison is always the same. This indicates that one of the branches of the condition is never executed, most likely because the associated integer expression is incorrect. This code defect often occurs in incorrect integer overflow checks on 64-bit architectures. Integer conversion rules are complex and there are many subtle pitfalls. As an alternative to fixing each C4754 warning, you can update the code to use the [SafeInt Library](../../safeint/safeint-library.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md index a11948ef358..df98f8cbafc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md @@ -10,6 +10,8 @@ ms.assetid: 7bd4296f-966b-484c-bf73-8dbc8e85b4a9 > Cannot align catch objects to greater than 16 bytes +## Remarks + An alignment greater than 16 was specified, but on some platforms, if the function throws an exception, the stack will force an alignment of not greater than 16. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md index 4365a42356c..bc689d514b7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md @@ -10,6 +10,8 @@ ms.assetid: 60f730ae-d942-4db9-ab97-41d4a874d8da > 'param' : parameter has a zero-sized array which will be truncated (unless the object is passed by reference) +## Remarks + A parameter to an object with a zero-size array was not passed by reference. The array will not get copied when the object is passed. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md index 2a30c930c2c..a6df159f0df 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md @@ -10,10 +10,14 @@ ms.assetid: 17aa29f4-c287-49b8-bc43-8ed82ffed5ea > 'bytes' bytes padding added after construct 'member_name' +## Remarks + The type and order of elements caused the compiler to add padding to the end of a struct. See [align](../../cpp/align-cpp.md) for more information on padding in a struct. 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 C4820: ```cpp From 46209f2920c552f294593481629d3d6766ab1c73 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 23:26:30 +0800 Subject: [PATCH 1066/1799] Replace term "sample" with "example" for warning references in range [C4751, C4830] --- .../compiler-warnings/compiler-warning-level-1-and-3-c4793.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4772.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4789.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4794.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4803.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4804.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4805.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4806.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4807.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4812.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4813.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4817.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4822.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4829.md | 2 +- .../compiler-warnings/compiler-warning-level-2-c4756.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4792.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4800.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4823.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4754.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4764.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4816.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4820.md | 2 +- 22 files changed, 25 insertions(+), 25 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md index fae4a118757..0278f38c700 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md @@ -32,7 +32,7 @@ The following table lists all possible continuation messages. ## Examples -The following sample generates C4793. +The following example generates C4793. ```cpp // C4793.cpp @@ -50,7 +50,7 @@ warning C4793: 'asmfunc' : function is compiled as native code: Inline native assembly ('__asm') is not supported in managed code ``` -The following sample generates C4793. +The following example generates C4793. ```cpp // C4793_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md index 22d80dab0e3..8c1671bb837 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md @@ -53,7 +53,7 @@ library C4772bLib }; ``` -The following sample generates C4772: +The following example generates C4772: ```cpp // C4772.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md index 696cc4eacdf..504b06f47e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md @@ -38,7 +38,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Examples -The following sample generates C4789: +The following example generates C4789: ```cpp // C4789.cpp @@ -60,7 +60,7 @@ int main() } ``` -The following sample also generates C4789: +The following example also generates C4789: ```cpp // C4789b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md index 5c3af428901..5eba3349663 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md @@ -18,7 +18,7 @@ The .tls$*x* section will exist in the object file where [__declspec(thread)](.. ## Example -The following sample generates C4794: +The following example generates C4794: ```cpp // C4794.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md index 110767c0c8d..f9781701761 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md @@ -20,7 +20,7 @@ See [warning](../../preprocessor/warning.md) pragma for information on how to tu ## Example -The following sample generates C4803. +The following example generates C4803. ```cpp // C4803.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md index 508baa97d3c..48fd9ffd8e9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md @@ -16,7 +16,7 @@ This warning is for when you used a **`bool`** variable or value in an unexpecte ## Example -The following sample generates C4804: +The following example generates C4804: ```cpp // C4804.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md index d0fbed526f4..7711dbe3e97 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md @@ -16,7 +16,7 @@ This warning is generated for comparison operations between [bool](../../cpp/boo ## Example -The following sample generates C4805: +The following example generates C4805: ```cpp // C4805.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md index 2a797ed808c..4674dd22234 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md @@ -16,7 +16,7 @@ This message warns against code such as `b == 3`, where `b` has type **`bool`**. ## Example -The following sample generates C4806: +The following example generates C4806: ```cpp // C4806.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md index b33dc17c937..9c6a61b659c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md @@ -16,7 +16,7 @@ This warning is generated when comparing a one-bit signed bit field to a **`bool ## Example -The following sample generates C4807: +The following example generates C4807: ```cpp // C4807.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md index 5bc64cdaaac..ec4b6f9f8a9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md @@ -16,7 +16,7 @@ In the current release of Visual C++, the explicit constructor specialization is ## Example -The following sample generates C4812: +The following example generates C4812: ```cpp // C4812.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md index 9635478c179..94fa833ebd9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md @@ -16,7 +16,7 @@ A friend function in an inner class was not declared in the outer class. ## Example -The following sample generates C4813: +The following example generates C4813: ```cpp // C4813.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md index 7110ac64e9a..86ba5cfb487 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md @@ -16,7 +16,7 @@ The wrong member access operator was used. ## Example -The following sample generates C4817. +The following example generates C4817. ```cpp // C4817.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md index 4320b22cc5c..9a0904ec622 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md @@ -20,7 +20,7 @@ In Visual Studio 2019 and later, C4822 is an [off-by-default](../../preprocessor ## Example -The following sample generates C4822: +The following example generates C4822: ```cpp // C4822.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md index 4889a7a450e..1e8c12861c4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md @@ -16,7 +16,7 @@ Certain functions, such as main, cannot take reference type parameters. While co ## Example -The following sample generates C4829: +The following example generates C4829: ```cpp // C4829.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md index a714aca0e9c..e0b37b00240 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md @@ -16,7 +16,7 @@ The compiler generated an exception while doing constant arithmetic during compi ## Example -The following sample generates C4756: +The following example generates C4756: ```cpp // C4756.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md index 282a2762119..6bf4dd59267 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md @@ -18,7 +18,7 @@ This warning cannot be resolved in code or by changing the way you compile. Use ## Example -The following sample generates C4792: +The following example generates C4792: ```cpp // C4792.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md index e3e0c8a0ccc..a2815e0f2cc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md @@ -30,7 +30,7 @@ This warning is off by default starting in Visual Studio 2019. Use __/w__*n*__48 ## Example -The following sample generates C4800 and shows how to fix it: +The following example generates C4800 and shows how to fix it: ```cpp // C4800.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md index 44aad2d7360..b89ece22d76 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md @@ -18,7 +18,7 @@ You can also manually unpin the object and ignore the warning. ## Example -The following sample generates C4823. +The following example generates C4823. ```cpp // C4823.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md index e2e5e442cf4..97c290348cc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md @@ -18,7 +18,7 @@ Integer conversion rules are complex and there are many subtle pitfalls. As an a ## Examples -This sample generates C4754: +This example generates C4754: ```cpp // C4754a.cpp @@ -54,7 +54,7 @@ unsigned long long x = (unsigned long long)a + (unsigned long long)b; ``` -The next sample also generates C4754. +The next example also generates C4754. ```cpp // C4754b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md index df98f8cbafc..1a95399b6df 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md @@ -16,7 +16,7 @@ An alignment greater than 16 was specified, but on some platforms, if the functi ## Example -The following sample generates C4764: +The following example generates C4764: ```cpp // C4764.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md index bc689d514b7..0ca0e6f1702 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md @@ -16,7 +16,7 @@ A parameter to an object with a zero-size array was not passed by reference. The ## Example -The following sample generates C4816: +The following example generates C4816: ```cpp // C4816.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md index a6df159f0df..c66d4c2b885 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4820: +The following example generates C4820: ```cpp // C4820.cpp From b6229c809767788574f042edaedfaa9878508d37 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 2 Sep 2025 23:31:28 +0800 Subject: [PATCH 1067/1799] Update metadata for warning references in range [C4751, C4830] --- docs/error-messages/compiler-warnings/c4768.md | 2 +- docs/error-messages/compiler-warnings/c4770.md | 2 +- .../compiler-warning-level-1-and-3-c4793.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4772.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4788.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4794.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4799.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4803.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4804.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4805.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4806.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4807.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4810.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4811.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4812.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4813.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4817.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4819.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4821.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4822.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4829.md | 5 ++--- .../compiler-warnings/compiler-warning-level-2-c4756.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4792.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4800.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4823.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4754.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4764.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4816.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4820.md | 5 ++--- 29 files changed, 55 insertions(+), 81 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4768.md b/docs/error-messages/compiler-warnings/c4768.md index 2e6da6eec85..d2338975995 100644 --- a/docs/error-messages/compiler-warnings/c4768.md +++ b/docs/error-messages/compiler-warnings/c4768.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4768" title: "Compiler Warning (level 3) C4768" +description: "Learn more about: Compiler Warning (level 3) C4768" ms.date: 05/03/2021 f1_keywords: ["C4768"] helpviewer_keywords: ["C4768"] diff --git a/docs/error-messages/compiler-warnings/c4770.md b/docs/error-messages/compiler-warnings/c4770.md index 5afbc067883..f82f6915475 100644 --- a/docs/error-messages/compiler-warnings/c4770.md +++ b/docs/error-messages/compiler-warnings/c4770.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4770" title: "Compiler Warning (level 4) C4770" +description: "Learn more about: Compiler Warning (level 4) C4770" ms.date: 11/02/2022 f1_keywords: ["C4770"] helpviewer_keywords: ["C4770"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md index 0278f38c700..fadac33d1d3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1 and 3) C4793" title: "Compiler Warning (level 1 and 3) C4793" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and 3) C4793" +ms.date: 11/04/2016 f1_keywords: ["C4793"] helpviewer_keywords: ["C6634", "C6635", "C6640", "C6630", "C6639", "C6636", "C6638", "C6631", "C6637", "C4793"] -ms.assetid: 819ada53-1d9c-49b8-a629-baf8c12314e6 --- # Compiler Warning (level 1 and 3) C4793 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md index 8c1671bb837..4f8fba1457b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4772" title: "Compiler Warning (level 1) C4772" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4772" +ms.date: 11/04/2016 f1_keywords: ["C4772"] helpviewer_keywords: ["C4772"] -ms.assetid: dafe6fd8-9faf-41f5-9d66-a55838742c14 --- # Compiler Warning (level 1) C4772 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md index 7318f3f079a..a9c8bdd271a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4788" title: "Compiler Warning (Level 1) C4788" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4788" +ms.date: 11/04/2016 f1_keywords: ["C4788"] helpviewer_keywords: ["C4788"] -ms.assetid: 47d75bda-f833-4bdd-93a0-a134df0cd303 --- # Compiler Warning (Level 1) C4788 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md index 5eba3349663..fec3c297b94 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4794" title: "Compiler Warning (level 1) C4794" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4794" +ms.date: 11/04/2016 f1_keywords: ["C4794"] helpviewer_keywords: ["C4794"] -ms.assetid: badc9c36-fa1a-4fec-929b-7bfda7a7b79f --- # Compiler Warning (level 1) C4794 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md index 20dc701fdd5..4de2401b823 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md @@ -1,7 +1,7 @@ --- title: "Compiler Warning (level 1) C4799" description: "Learn more about: Compiler Warning (level 1) C4799" -ms.date: "03/28/2025" +ms.date: 03/28/2025 f1_keywords: ["C4799"] helpviewer_keywords: ["C4799"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md index f9781701761..160cd494ab1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4803" title: "Compiler Warning (level 1) C4803" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4803" +ms.date: 11/04/2016 f1_keywords: ["C4803"] helpviewer_keywords: ["C4803"] -ms.assetid: 2552f3a6-c418-49f4-98a2-a929857be658 --- # Compiler Warning (level 1) C4803 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md index 48fd9ffd8e9..a8d9c239b19 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4804" title: "Compiler Warning (level 1) C4804" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4804" +ms.date: 11/04/2016 f1_keywords: ["C4804"] helpviewer_keywords: ["C4804"] -ms.assetid: 069e8f44-3ef6-43bb-8524-4116fc6eea83 --- # Compiler Warning (level 1) C4804 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md index 7711dbe3e97..e85756333b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4805" title: "Compiler Warning (level 1) C4805" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4805" +ms.date: 11/04/2016 f1_keywords: ["C4805"] helpviewer_keywords: ["C4805"] -ms.assetid: 99c7b7e2-272e-4ab5-8580-17c42e62e2ef --- # Compiler Warning (level 1) C4805 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md index 4674dd22234..a86050abde4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4806" title: "Compiler Warning (level 1) C4806" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4806" +ms.date: 11/04/2016 f1_keywords: ["C4806"] helpviewer_keywords: ["C4806"] -ms.assetid: 79eb74cd-b925-4b5b-84e1-8ae6f33e38b3 --- # Compiler Warning (level 1) C4806 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md index 9c6a61b659c..9696970dd32 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4807" title: "Compiler Warning (level 1) C4807" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4807" +ms.date: 11/04/2016 f1_keywords: ["C4807"] helpviewer_keywords: ["C4807"] -ms.assetid: 089c9f87-fd81-402e-9826-66a8ef1ef1fe --- # Compiler Warning (level 1) C4807 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md index e047f841d5f..81d413dedb2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4810" title: "Compiler Warning (level 1) C4810" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4810" +ms.date: 11/04/2016 f1_keywords: ["C4810"] helpviewer_keywords: ["C4810"] -ms.assetid: 39e2cae0-9c1c-4ac1-aaa0-5f661d06085b --- # Compiler Warning (level 1) C4810 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md index cce815a0cba..dc0f0521926 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4811" title: "Compiler Warning (level 1) C4811" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4811" +ms.date: 11/04/2016 f1_keywords: ["C4811"] helpviewer_keywords: ["C4811"] -ms.assetid: fbd79351-3dc1-45cf-b5b3-411f48c1590f --- # Compiler Warning (level 1) C4811 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md index ec4b6f9f8a9..5c5d3d2394d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4812" title: "Compiler Warning (level 1) C4812" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4812" +ms.date: 11/04/2016 f1_keywords: ["C4812"] helpviewer_keywords: ["C4812"] -ms.assetid: a7f5721f-2019-44de-ad62-ed30bac8b1f3 --- # Compiler Warning (level 1) C4812 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md index 94fa833ebd9..a2d30e711ae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4813" title: "Compiler Warning (level 1) C4813" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4813" +ms.date: 11/04/2016 f1_keywords: ["C4813"] helpviewer_keywords: ["C4813"] -ms.assetid: c30bf877-ab04-4fe4-897e-8162092426f0 --- # Compiler Warning (level 1) C4813 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md index 86ba5cfb487..9273163849b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4817" title: "Compiler Warning (level 1) C4817" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4817" +ms.date: 11/04/2016 f1_keywords: ["C4817"] helpviewer_keywords: ["C4817"] -ms.assetid: a68f5486-6940-4934-9f93-bfd4d71f92a9 --- # Compiler Warning (level 1) C4817 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md index a08b5f304b1..a55bf43ca8c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4819" title: "Compiler Warning (level 1) C4819" -ms.date: "04/08/2019" +description: "Learn more about: Compiler Warning (level 1) C4819" +ms.date: 04/08/2019 f1_keywords: ["C4819"] helpviewer_keywords: ["C4819"] -ms.assetid: c0316e85-249c-414d-9df0-622d077c6bc2 --- # Compiler Warning (level 1) C4819 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md index c92c4d56899..fbd1d0e8f17 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4821" title: "Compiler Warning (level 1) C4821" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4821" +ms.date: 11/04/2016 f1_keywords: ["C4821"] helpviewer_keywords: ["C4821"] -ms.assetid: c7768e77-0ee5-491e-8aa4-3915bf5bcbdf --- # Compiler Warning (level 1) C4821 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md index 9a0904ec622..47a396a2d93 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4822" title: "Compiler Warning (level 1) C4822" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4822" +ms.date: 11/04/2016 f1_keywords: ["C4822"] helpviewer_keywords: ["C4822"] -ms.assetid: 0f231a30-2eb0-4722-aaa0-e2d19d3e7eea --- # Compiler Warning (level 1) C4822 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md index 1e8c12861c4..7b3a1ffe750 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4829" title: "Compiler Warning (level 1) C4829" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4829" +ms.date: 11/04/2016 f1_keywords: ["C4829"] helpviewer_keywords: ["C4829"] -ms.assetid: 4ffabe2b-2ddc-4c52-8564-d1355c93cfa6 --- # Compiler Warning (level 1) C4829 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md index e0b37b00240..1e61db8e9b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4756" title: "Compiler Warning (level 2) C4756" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4756" +ms.date: 11/04/2016 f1_keywords: ["C4756"] helpviewer_keywords: ["C4756"] -ms.assetid: 5a16df83-6b82-4619-83bd-319af4ef1d1d --- # Compiler Warning (level 2) C4756 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md index 6bf4dd59267..ab042b9b95a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4792" title: "Compiler Warning (level 3) C4792" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4792" +ms.date: 11/04/2016 f1_keywords: ["C4792"] helpviewer_keywords: ["C4792"] -ms.assetid: c047ce69-a622-44e1-9425-d41aa9261c61 --- # Compiler Warning (level 3) C4792 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md index a2815e0f2cc..7d0eaddd3ac 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4800" title: "Compiler Warning (level 4) C4800" -ms.date: "03/14/2019" +description: "Learn more about: Compiler Warning (level 4) C4800" +ms.date: 03/14/2019 f1_keywords: ["C4800"] helpviewer_keywords: ["C4800"] -ms.assetid: 4f409799-a250-45ed-bb5f-657691b0d9f7 --- # Compiler Warning (level 4) C4800 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md index b89ece22d76..0e5cbf011de 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4823" title: "Compiler Warning (level 3) C4823" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4823" +ms.date: 11/04/2016 f1_keywords: ["C4823"] helpviewer_keywords: ["C4823"] -ms.assetid: 8a77560d-dcea-4cae-aebb-8ebf1b4cef85 --- # Compiler Warning (level 3) C4823 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md index 97c290348cc..25e27f20145 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4754" title: "Compiler Warning (level 4) C4754" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4754" +ms.date: 11/04/2016 f1_keywords: ["C4754"] helpviewer_keywords: ["C4754"] -ms.assetid: e0e4606a-754a-4f42-a274-21a34978d21d --- # Compiler Warning (level 4) C4754 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md index 1a95399b6df..7886044e2ab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4764" title: "Compiler Warning (level 4) C4764" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4764" +ms.date: 11/04/2016 f1_keywords: ["C4764"] helpviewer_keywords: ["C4764"] -ms.assetid: 7bd4296f-966b-484c-bf73-8dbc8e85b4a9 --- # Compiler Warning (level 4) C4764 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md index 0ca0e6f1702..f7046a8be89 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4816" title: "Compiler Warning (level 4) C4816" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4816" +ms.date: 11/04/2016 f1_keywords: ["C4816"] helpviewer_keywords: ["C4816"] -ms.assetid: 60f730ae-d942-4db9-ab97-41d4a874d8da --- # Compiler Warning (level 4) C4816 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md index c66d4c2b885..18f9f82fb36 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4820" title: "Compiler Warning (level 4) C4820" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4820" +ms.date: 11/04/2016 f1_keywords: ["C4820"] helpviewer_keywords: ["C4820"] -ms.assetid: 17aa29f4-c287-49b8-bc43-8ed82ffed5ea --- # Compiler Warning (level 4) C4820 From 5287df9e843301a5b97a76cbd98a5574b327ac52 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 3 Sep 2025 00:05:24 +0800 Subject: [PATCH 1068/1799] Add missing semicolon after `struct`/`class` definitions --- docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2698.md | 2 +- docs/sanitizers/error-new-delete-type-mismatch.md | 2 +- docs/standard-library/gslice-array-class.md | 2 +- docs/standard-library/ratio.md | 2 +- docs/standard-library/scoped-lock-class.md | 2 +- docs/standard-library/slice-array-class.md | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md b/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md index bea45e7ed94..ebcb7bcf0af 100644 --- a/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md +++ b/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md @@ -74,7 +74,7 @@ public: . . . -} +}; ``` You can either allocate these storage buffers manually or have the framework do the allocation. To allocate the buffers yourself, you must specify the `CRecordset::userAllocMultiRowBuffers` option of the *dwOptions* parameter in the `Open` member function. Be sure to set the sizes of the arrays at least equal to the rowset size. If you want to have the framework do the allocation, you should initialize your pointers to NULL. This is typically done in the recordset object's constructor: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md index 464373f1458..dbc7eef8618 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md @@ -30,5 +30,5 @@ struct B { struct C : A, B { using A::x; using B::x; // C2698 -} +}; ``` diff --git a/docs/sanitizers/error-new-delete-type-mismatch.md b/docs/sanitizers/error-new-delete-type-mismatch.md index 2c19b710af7..097bc08c959 100644 --- a/docs/sanitizers/error-new-delete-type-mismatch.md +++ b/docs/sanitizers/error-new-delete-type-mismatch.md @@ -48,7 +48,7 @@ To fix the example, add: ```cpp struct Base { virtual ~Base() = default; -} +}; ``` To build and test this example, run these commands in a Visual Studio 2019 version 16.9 or later [developer command prompt](../build/building-on-the-command-line.md#developer_command_prompt_shortcuts): diff --git a/docs/standard-library/gslice-array-class.md b/docs/standard-library/gslice-array-class.md index 727afddc3f6..0e3cd70c81e 100644 --- a/docs/standard-library/gslice-array-class.md +++ b/docs/standard-library/gslice-array-class.md @@ -42,7 +42,7 @@ public: void operator>>=(const valarray& x) const; // The rest is private or implementation defined -} +}; ``` ## Remarks diff --git a/docs/standard-library/ratio.md b/docs/standard-library/ratio.md index 05922b7ff4b..b70a7fddfcf 100644 --- a/docs/standard-library/ratio.md +++ b/docs/standard-library/ratio.md @@ -24,7 +24,7 @@ struct ratio // holds the ratio of Numerator to Denominator static constexpr std::intmax_t num; static constexpr std::intmax_t den; typedef ratio type; -} +}; ``` The template `ratio` defines the static constants `num` and `den` such that `num` / `den` == Numerator / Denominator and `num` and `den` have no common factors. `num` / `den` is the value that is represented by the class template. Therefore, `type` designates the instantiation `ratio`. diff --git a/docs/standard-library/scoped-lock-class.md b/docs/standard-library/scoped-lock-class.md index 1cb8e0504b8..436a7359987 100644 --- a/docs/standard-library/scoped-lock-class.md +++ b/docs/standard-library/scoped-lock-class.md @@ -17,5 +17,5 @@ class scoped_lock { ~scoped_lock(); scoped_lock(const scoped_lock&) = delete; scoped_lock& operator=(const scoped_lock&) = delete; -} +}; ``` diff --git a/docs/standard-library/slice-array-class.md b/docs/standard-library/slice-array-class.md index 6bcfaec534d..385f84bdbfc 100644 --- a/docs/standard-library/slice-array-class.md +++ b/docs/standard-library/slice-array-class.md @@ -30,7 +30,7 @@ public: void operator<<=(const valarray& x) const; void operator>>=(const valarray& x) const; // The rest is private or implementation defined -} +}; ``` ## Remarks From 08147a0b3c6fde2e948224a21f02ba1bddbd6a20 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 3 Sep 2025 00:06:35 +0800 Subject: [PATCH 1069/1799] Update metadata in 5 topics --- docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md | 5 ++--- docs/standard-library/gslice-array-class.md | 3 +-- docs/standard-library/ratio.md | 5 ++--- docs/standard-library/scoped-lock-class.md | 4 ++-- docs/standard-library/slice-array-class.md | 3 +-- 5 files changed, 8 insertions(+), 12 deletions(-) diff --git a/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md b/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md index ebcb7bcf0af..83ad1f4bc73 100644 --- a/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md +++ b/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Recordset: Fetching Records in Bulk (ODBC)" title: "Recordset: Fetching Records in Bulk (ODBC)" -ms.date: "11/04/2016" +description: "Learn more about: Recordset: Fetching Records in Bulk (ODBC)" +ms.date: 11/04/2016 helpviewer_keywords: ["bulk row fetching, implementing", "ODBC recordsets, bulk row fetching", "bulk record field exchange", "bulk row fetching", "bulk RFX functions", "recordsets, bulk row fetching", "DoBulkFieldExchange method", "fetching ODBC records in bulk", "RFX (ODBC), bulk", "rowsets, bulk row fetching", "RFX (ODBC), bulk row fetching"] -ms.assetid: 20d10fe9-c58a-414a-b675-cdf9aa283e4f --- # Recordset: Fetching Records in Bulk (ODBC) diff --git a/docs/standard-library/gslice-array-class.md b/docs/standard-library/gslice-array-class.md index 0e3cd70c81e..22e90f11d0b 100644 --- a/docs/standard-library/gslice-array-class.md +++ b/docs/standard-library/gslice-array-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: gslice_array class" title: "gslice_array class" +description: "Learn more about: gslice_array class" ms.date: 01/12/2022 f1_keywords: ["valarray/std::gslice_array"] helpviewer_keywords: ["gslice_array class"] -ms.assetid: ad1b4514-b14a-4baf-a293-d5a8e8674c75 --- # `gslice_array` class diff --git a/docs/standard-library/ratio.md b/docs/standard-library/ratio.md index b70a7fddfcf..1df9000050b 100644 --- a/docs/standard-library/ratio.md +++ b/docs/standard-library/ratio.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: ["", "ratio/std::mega", "ratio/std::peta", "ratio/std::ratio_greater", "ratio/std::micro", "ratio/std::ratio_add", "ratio/std::ratio_not_equal", "ratio/std::hecto", "ratio/std::nano", "ratio/std::ratio_less_equal", "ratio/std::ratio_less", "ratio/std::centi", "ratio/std::ratio_greater_equal", "ratio/std::ratio_subtract", "ratio/std::atto", "ratio/std::tera", "ratio/std::milli", "ratio/std::ratio_multiply", "ratio/std::kilo", "ratio/std::ratio_divide", "ratio/std::giga", "ratio/std::pico", "ratio/std::femto", "ratio/std::ratio_equal", "ratio/std::ratio", "ratio/std::exa", "ratio/std::deci", "ratio/std::deca"] -ms.assetid: 8543e912-2d84-45ea-b3c0-bd7bfacee405 --- # `` diff --git a/docs/standard-library/scoped-lock-class.md b/docs/standard-library/scoped-lock-class.md index 436a7359987..42b35183393 100644 --- a/docs/standard-library/scoped-lock-class.md +++ b/docs/standard-library/scoped-lock-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: scoped_lock Class" title: "scoped_lock Class" -ms.date: "11/04/2016" +description: "Learn more about: scoped_lock Class" +ms.date: 11/04/2016 f1_keywords: ["mutex/std::scoped_lock"] --- # scoped_lock Class diff --git a/docs/standard-library/slice-array-class.md b/docs/standard-library/slice-array-class.md index 385f84bdbfc..f8520ffb2b5 100644 --- a/docs/standard-library/slice-array-class.md +++ b/docs/standard-library/slice-array-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: slice_array class" title: "slice_array class" +description: "Learn more about: slice_array class" ms.date: 01/12/2022 f1_keywords: ["valarray/std::slice_array"] helpviewer_keywords: ["slice_array class"] -ms.assetid: a182d5f7-f35c-4e76-86f2-b5ac64ddc846 --- # `slice_array` class From ebfa74bbf2ff4a9d19b7e8ea29ea94b8a31eb92c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 3 Sep 2025 22:33:35 +0800 Subject: [PATCH 1070/1799] Add blockquotes for warning messages in range [C4831, C4940] --- docs/error-messages/compiler-warnings/compiler-warning-c4867.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4835.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4838.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4900.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4905.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4906.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4910.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4912.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4917.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4920.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4925.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4926.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4927.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4928.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4929.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4930.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4935.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4939.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4913.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4918.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4937.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4938.md | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md index 2d3ddc1217c..7f2f8443b43 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md @@ -8,7 +8,7 @@ ms.assetid: 8a257d70-c3a7-462d-b285-e57c952a8bf7 --- # Compiler Warning C4867 -'function': function call missing argument list; use 'call' to create a pointer to member +> 'function': function call missing argument list; use 'call' to create a pointer to member A pointer to member function was initialized incorrectly. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md index 220089e424e..b3afb357344 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md @@ -8,7 +8,7 @@ ms.assetid: d2e44c62-7b0e-4a45-943d-97903e27ed9d --- # Compiler Warning (level 1) C4835 -'variable' : the initializer for exported data will not be run until managed code is first executed in the host assembly +> 'variable' : the initializer for exported data will not be run until managed code is first executed in the host assembly When accessing data between managed components, it is recommended that you not use native C++ import and export mechanisms. Instead, declare your data members inside a managed type and reference the metadata with `#using` in the client. For more information, see [#using Directive](../../preprocessor/hash-using-directive-cpp.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md index 0c5faf751c8..66ac24dc278 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md @@ -8,7 +8,7 @@ ms.assetid: fea07924-5feb-4ed4-99b5-1a8c41d28db6 --- # Compiler Warning (level 1) C4838 -conversion from 'type_1' to 'type_2' requires a narrowing conversion +> conversion from 'type_1' to 'type_2' requires a narrowing conversion An implicit narrowing conversion was found when using aggregate or list initialization. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md index 7ab98d4f470..3c7c1930148 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md @@ -8,6 +8,6 @@ ms.assetid: 826997ec-0803-4794-ad35-bb463f679658 --- # Compiler Warning (level 1) C4900 -intermediate language mismatch between 'tool1' version 'version1' and 'tool2' version 'version2' +> intermediate language mismatch between 'tool1' version 'version1' and 'tool2' version 'version2' The intermediate language used in *tool1* and *tool2* did not match. Check that the most current version of each tool has been installed. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md index c8dd24cadec..6b7f1d0637a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md @@ -8,7 +8,7 @@ ms.assetid: 40240bf4-b14e-4c22-aeb2-52f2851532f6 --- # Compiler Warning (level 1) C4905 -wide string literal cast to 'LPSTR' +> wide string literal cast to 'LPSTR' The compiler detected an unsafe cast. The cast did succeed, but you should use a conversion routine. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md index 395fe28c5d5..cc9ec4ece27 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md @@ -8,7 +8,7 @@ ms.assetid: 05318e74-799b-412a-9dce-f02b8161d762 --- # Compiler Warning (level 1) C4906 -string literal cast to 'LPWSTR' +> string literal cast to 'LPWSTR' The compiler detected an unsafe cast. The cast did succeed, but you should use a conversion routine. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md index b923b43d27e..5fdd2128b83 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md @@ -8,7 +8,7 @@ ms.assetid: 67963560-fbca-4ca7-93db-06beaf7055f0 --- # Compiler Warning (level 1) C4910 -'\' : '__declspec(dllexport)' and 'extern' are incompatible on an explicit instantiation +> '\' : '__declspec(dllexport)' and 'extern' are incompatible on an explicit instantiation The explicit template instantiation named *\* is modified by both the `__declspec(dllexport)` and **`extern`** keywords. However, these keywords are mutually exclusive. The `__declspec(dllexport)` keyword means instantiate the template class, while the **`extern`** keyword means do not automatically instantiate the template class. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md index fbaf6ce0afc..91aeef58787 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md @@ -8,7 +8,7 @@ ms.assetid: ba1f1a66-8c20-4792-9ac8-43e49f729ae2 --- # Compiler Warning (level 1) C4912 -'attribute': attribute has undefined behavior on a nested UDT +> 'attribute': attribute has undefined behavior on a nested UDT Attributes that apply to nested UDTs (user-defined type, which could be a typedef, union, or struct) may be ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md index e0be915a7cf..78832b435dc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md @@ -8,7 +8,7 @@ ms.assetid: c05e2610-4a5d-4f4b-a99b-c15fd7f1d5f1 --- # Compiler Warning (level 1) C4917 -'declarator' : a GUID can only be associated with a class, interface or namespace +> 'declarator' : a GUID can only be associated with a class, interface or namespace A user-defined structure other than [class](../../cpp/class-cpp.md), [interface](../../cpp/interface.md), or [namespace](../../cpp/namespaces-cpp.md) cannot have a GUID. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md index dc1fc90aba8..4df78b82747 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md @@ -8,7 +8,7 @@ ms.assetid: 1e501f2e-93c1-4d27-a4fa-54fc86271ae7 --- # Compiler Warning (level 1) C4920 -enum enum member member=value already seen in enum enum as member=value +> enum enum member member=value already seen in enum enum as member=value If a .tlb that you pass to #import has the same symbol defined in two or more enums, this warning indicates that subsequent identical symbols are ignored and will be commented out in the .tlh file. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md index fefc0eea093..b3a9a0848c1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md @@ -8,7 +8,7 @@ ms.assetid: a4b206c0-016a-4f28-873a-bb8bb41bad50 --- # Compiler Warning (level 1) C4925 -'method': dispinterface method cannot be called from script +> 'method': dispinterface method cannot be called from script Scripting languages cannot create a VT_BYREF 'in' parameter, it can only create VT_BYREF 'out' parameters. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md index e1b980f6b58..6b9b474675a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md @@ -8,7 +8,7 @@ ms.assetid: 5717fce0-146f-4ef2-bde0-e9a01c0922d1 --- # Compiler Warning (level 1) C4926 -'identifier': symbol is already defined: attributes ignored +> 'identifier': symbol is already defined: attributes ignored A forward declaration was found but an attributed construct with the same name already exists. The attributes for the forward declaration are ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md index 1edc84ab0e3..166093eb863 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md @@ -8,7 +8,7 @@ ms.assetid: 7009e740-a2ef-4130-96ba-482e092f717a --- # Compiler Warning (level 1) C4927 -illegal conversion; more than one user-defined conversion has been implicitly applied +> illegal conversion; more than one user-defined conversion has been implicitly applied More than one user-defined conversion is implicitly applied to a single value -- the compiler did not find an explicit conversion but did find a conversion, which it used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md index 2842251ec40..057e38cdf75 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md @@ -8,7 +8,7 @@ ms.assetid: 77235d7f-9360-45cb-8348-d148c605c4a3 --- # Compiler Warning (level 1) C4928 -illegal copy-initialization; more than one user-defined conversion has been implicitly applied +> illegal copy-initialization; more than one user-defined conversion has been implicitly applied More than one user-defined conversion routine was found. The compiler executed the code in all such routines. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md index 96e3168e904..58cf0371291 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md @@ -8,7 +8,7 @@ ms.assetid: 95f8ab4f-4468-4caa-acd5-8f4592f03b3c --- # Compiler Warning (level 1) C4929 -'file': typelibrary contains a union; ignoring the 'embedded_idl' qualifier +> 'file': typelibrary contains a union; ignoring the 'embedded_idl' qualifier The embedded_idl attribute of [#import](../../preprocessor/hash-import-directive-cpp.md) could not be applied to the type library because a union is present in the type library. To resolve this warning, don't use embedded_idl. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md index 7d708e9b826..d31fba734b4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md @@ -8,7 +8,7 @@ ms.assetid: 89a206c9-c536-4186-8e81-1cde3e7f4f5b --- # Compiler Warning (level 1) C4930 -'prototype': prototyped function not called (was a variable definition intended?) +> 'prototype': prototyped function not called (was a variable definition intended?) The compiler detected an unused function prototype. If the prototype was intended as a variable declaration, remove the open/close parentheses. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md index 09fadd7e4d9..569955ce026 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md @@ -8,7 +8,7 @@ ms.assetid: a36c56d3-571a-44dd-bb0f-bcc6b020e134 --- # Compiler Warning (level 1) C4935 -assembly access specifier modified from 'access' +> assembly access specifier modified from 'access' The assembly visibility of a type was modified. The compiler uses the last specifier that it encounters. For example, the assembly visibility of a forward declaration may be different from the assembly visibility of the class definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md index 97fffd379e0..1e11d9cedab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md @@ -8,7 +8,7 @@ ms.assetid: 07096008-ba47-436c-a84c-2b03ad90d0b3 --- # Compiler Warning (level 1) C4939 -\#pragma vtordisp is deprecated and will be removed in a future release of Visual C++ +> #pragma vtordisp is deprecated and will be removed in a future release of Visual C++ The [vtordisp](../../preprocessor/vtordisp.md) pragma will be removed in a future release of Visual C++. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md index 4c7e6651a22..4faed32e0dd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md @@ -8,7 +8,7 @@ ms.assetid: b94aa52e-6029-4170-9134-017714931546 --- # Compiler Warning (level 4) C4913 -**user defined binary operator ',' exists but no overload could convert all operands, default built-in binary operator ',' used** +> user defined binary operator ',' exists but no overload could convert all operands, default built-in binary operator ',' used A call to the built-in comma operator occurred in a program that also had an overloaded comma operator; a conversion that you thought may have occurred did not. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md index 1954636c04d..179dfc3b515 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md @@ -8,7 +8,7 @@ ms.assetid: 1bcf6d35-3467-4aa8-b2ef-cb33f4e70238 --- # Compiler Warning (level 4) C4918 -'character' : invalid character in pragma optimization list +> 'character' : invalid character in pragma optimization list An unknown character was found in the optimization list of an [optimize](../../preprocessor/optimize.md) pragma statement. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md index f6f28b3469d..3454d9d611d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md @@ -8,7 +8,7 @@ ms.assetid: 2bb9f0e7-bbd6-4697-84de-95955e32ae29 --- # Compiler Warning (level 4) C4937 -'text1' and 'text2' are indistinguishable as arguments to 'directive' +> 'text1' and 'text2' are indistinguishable as arguments to 'directive' Because of the way the compiler processes arguments to directives, names that have meaning to the compiler, such as keywords with multiple text representations (single and double underscore forms), cannot be distinguished. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md index 86361dc2f44..79e3c81c756 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md @@ -8,7 +8,7 @@ ms.assetid: 6acac81a-9d23-465e-b700-ed4b6e8edcd0 --- # Compiler Warning (level 4) C4938 -'var' : Floating point reduction variable may cause inconsistent results under /fp:strict or #pragma fenv_access +> 'var' : Floating point reduction variable may cause inconsistent results under /fp:strict or #pragma fenv_access You should not use [/fp:strict](../../build/reference/fp-specify-floating-point-behavior.md) or [fenv_access](../../preprocessor/fenv-access.md) with OpenMP floating-point reductions, because the sum is computed in a different order. Thus, results can differ from the results without /openmp. From 14e0b60dc29beac570708cdcbc5a8cce935f6bd5 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 3 Sep 2025 22:40:46 +0800 Subject: [PATCH 1071/1799] Add "Remarks" and "Example" headings for warning references in range [C4831, C4940] --- .../compiler-warnings/compiler-warning-c4867.md | 2 ++ .../compiler-warnings/compiler-warning-c4868.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4835.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4838.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4900.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4905.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4906.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4910.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4912.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4917.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4920.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4925.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4926.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4927.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4928.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4929.md | 4 +++- .../compiler-warnings/compiler-warning-level-1-c4930.md | 4 ++++ .../compiler-warnings/compiler-warning-level-1-c4935.md | 2 ++ .../compiler-warnings/compiler-warning-level-1-c4939.md | 2 ++ .../compiler-warnings/compiler-warning-level-3-c4839.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4913.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4918.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4931.md | 2 ++ .../compiler-warnings/compiler-warning-level-4-c4932.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4937.md | 4 ++++ .../compiler-warnings/compiler-warning-level-4-c4938.md | 4 ++++ 26 files changed, 79 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md index 7f2f8443b43..0b8ea6ea24b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md @@ -10,6 +10,8 @@ ms.assetid: 8a257d70-c3a7-462d-b285-e57c952a8bf7 > 'function': function call missing argument list; use 'call' to create a pointer to member +## Remarks + A pointer to member function was initialized incorrectly. This warning can be generated as a result of compiler conformance work that was done for Visual Studio 2005: enhanced pointer-to-member conformance. Code that compiled prior to Visual Studio 2005 will now generate C4867. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4868.md b/docs/error-messages/compiler-warnings/compiler-warning-c4868.md index 8857a084f10..fd3b6d4cdb6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4868.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4868.md @@ -10,6 +10,8 @@ ms.assetid: fc6aa7e5-34dd-4ec2-88bd-16e430361dc7 > '_file_(*line_number*)' compiler may not enforce left-to-right evaluation order in braced initializer list +## Remarks + The elements of a braced initializer list are to be evaluated in left-to-right order. There are two cases in which the compiler is unable to guarantee this order: the first is when some of the elements are objects passed by value; the second is when compiling with `/clr` and some of the elements are fields of objects or are array elements. When the compiler can't guarantee left-to-right evaluation it emits warning C4868. This warning can be generated as a result of compiler conformance work that was done for Visual Studio 2015 Update 2. Code that compiled prior to Visual Studio 2015 Update 2 can now generate C4868. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md index b3afb357344..2db18b82868 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md @@ -10,6 +10,8 @@ ms.assetid: d2e44c62-7b0e-4a45-943d-97903e27ed9d > 'variable' : the initializer for exported data will not be run until managed code is first executed in the host assembly +## Remarks + When accessing data between managed components, it is recommended that you not use native C++ import and export mechanisms. Instead, declare your data members inside a managed type and reference the metadata with `#using` in the client. For more information, see [#using Directive](../../preprocessor/hash-using-directive-cpp.md). ## Examples diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md index 66ac24dc278..19b394f9f46 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md @@ -10,12 +10,16 @@ ms.assetid: fea07924-5feb-4ed4-99b5-1a8c41d28db6 > conversion from 'type_1' to 'type_2' requires a narrowing conversion +## Remarks + An implicit narrowing conversion was found when using aggregate or list initialization. The C language allows implicit narrowing conversions in assignments and initialization, and C++ follows suit, even though unexpected narrowing is a cause of many code errors. To make code safer, the C++ standard requires a diagnostic message when a narrowing conversion occurs in an initialization list. In Visual C++, the diagnostic is [Compiler Error C2397](../../error-messages/compiler-errors-1/compiler-error-c2397.md) when using the uniform initialization syntax supported beginning in Visual Studio 2015. The compiler generates warning C4838 when using the list or aggregate initialization syntax supported by Visual Studio 2013. A narrowing conversion can be okay when you know the possible range of converted values can fit in the target. In this case, you know more than the compiler does. If you make a narrowing conversion intentionally, make your intentions explicit by using a static cast. Otherwise, this warning message almost always indicates that you have a bug in your code. You can fix it by making sure the objects you initialize have types that are large enough to handle the inputs. +## Example + The following sample generates C4838 and shows one way to fix it: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md index 3c7c1930148..56a59d00efe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md @@ -10,4 +10,6 @@ ms.assetid: 826997ec-0803-4794-ad35-bb463f679658 > intermediate language mismatch between 'tool1' version 'version1' and 'tool2' version 'version2' +## Remarks + The intermediate language used in *tool1* and *tool2* did not match. Check that the most current version of each tool has been installed. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md index 6b7f1d0637a..9a1ba2135ec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md @@ -10,6 +10,8 @@ ms.assetid: 40240bf4-b14e-4c22-aeb2-52f2851532f6 > wide string literal cast to 'LPSTR' +## Remarks + The compiler detected an unsafe cast. The cast did succeed, but you should use a conversion routine. 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-1-c4906.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md index cc9ec4ece27..a56a77722a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md @@ -10,6 +10,8 @@ ms.assetid: 05318e74-799b-412a-9dce-f02b8161d762 > string literal cast to 'LPWSTR' +## Remarks + The compiler detected an unsafe cast. The cast did succeed, but you should use a conversion routine. 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-1-c4910.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md index 5fdd2128b83..65f5bef7f26 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md @@ -10,6 +10,8 @@ ms.assetid: 67963560-fbca-4ca7-93db-06beaf7055f0 > '\' : '__declspec(dllexport)' and 'extern' are incompatible on an explicit instantiation +## Remarks + The explicit template instantiation named *\* is modified by both the `__declspec(dllexport)` and **`extern`** keywords. However, these keywords are mutually exclusive. The `__declspec(dllexport)` keyword means instantiate the template class, while the **`extern`** keyword means do not automatically instantiate the template class. ## See also diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md index 91aeef58787..f05c737356a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md @@ -10,8 +10,12 @@ ms.assetid: ba1f1a66-8c20-4792-9ac8-43e49f729ae2 > 'attribute': attribute has undefined behavior on a nested UDT +## Remarks + Attributes that apply to nested UDTs (user-defined type, which could be a typedef, union, or struct) may be ignored. +## Example + The following code shows how this warning would be generated: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md index 78832b435dc..3f6010a2a7f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md @@ -10,6 +10,8 @@ ms.assetid: c05e2610-4a5d-4f4b-a99b-c15fd7f1d5f1 > 'declarator' : a GUID can only be associated with a class, interface or namespace +## Remarks + A user-defined structure other than [class](../../cpp/class-cpp.md), [interface](../../cpp/interface.md), or [namespace](../../cpp/namespaces-cpp.md) cannot have a GUID. 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-1-c4920.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md index 4df78b82747..c4810e098e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md @@ -10,8 +10,12 @@ ms.assetid: 1e501f2e-93c1-4d27-a4fa-54fc86271ae7 > enum enum member member=value already seen in enum enum as member=value +## Remarks + If a .tlb that you pass to #import has the same symbol defined in two or more enums, this warning indicates that subsequent identical symbols are ignored and will be commented out in the .tlh file. +## Example + Assuming a .tlb that contains: ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md index b3a9a0848c1..189c703a85c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md @@ -10,10 +10,14 @@ ms.assetid: a4b206c0-016a-4f28-873a-bb8bb41bad50 > 'method': dispinterface method cannot be called from script +## Remarks + Scripting languages cannot create a VT_BYREF 'in' parameter, it can only create VT_BYREF 'out' parameters. Another way to resolve this warning is not make the parameter (in the definition and implementation) a pointer type. +## Example + The following sample generates C4925: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md index 6b9b474675a..7d3af66acf1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md @@ -10,8 +10,12 @@ ms.assetid: 5717fce0-146f-4ef2-bde0-e9a01c0922d1 > 'identifier': symbol is already defined: attributes ignored +## Remarks + A forward declaration was found but an attributed construct with the same name already exists. The attributes for the forward declaration are ignored. +## Example + The following sample generates C4926: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md index 166093eb863..befcfdbf86a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md @@ -10,8 +10,12 @@ ms.assetid: 7009e740-a2ef-4130-96ba-482e092f717a > illegal conversion; more than one user-defined conversion has been implicitly applied +## Remarks + More than one user-defined conversion is implicitly applied to a single value -- the compiler did not find an explicit conversion but did find a conversion, which it used. +## Example + The following sample generates C4927: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md index 057e38cdf75..97f975333e8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md @@ -10,10 +10,14 @@ ms.assetid: 77235d7f-9360-45cb-8348-d148c605c4a3 > illegal copy-initialization; more than one user-defined conversion has been implicitly applied +## Remarks + More than one user-defined conversion routine was found. The compiler executed the code in all such routines. 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 C4928: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md index 58cf0371291..762b8aacf74 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md @@ -10,9 +10,11 @@ ms.assetid: 95f8ab4f-4468-4caa-acd5-8f4592f03b3c > 'file': typelibrary contains a union; ignoring the 'embedded_idl' qualifier +## Remarks + The embedded_idl attribute of [#import](../../preprocessor/hash-import-directive-cpp.md) could not be applied to the type library because a union is present in the type library. To resolve this warning, don't use embedded_idl. -## Examples +## Example The following sample defines a component. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md index d31fba734b4..aba3ef6d51c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md @@ -10,8 +10,12 @@ ms.assetid: 89a206c9-c536-4186-8e81-1cde3e7f4f5b > 'prototype': prototyped function not called (was a variable definition intended?) +## Remarks + The compiler detected an unused function prototype. If the prototype was intended as a variable declaration, remove the open/close parentheses. +## Examples + The following sample generates C4930: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md index 569955ce026..94b8359ac57 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md @@ -10,6 +10,8 @@ ms.assetid: a36c56d3-571a-44dd-bb0f-bcc6b020e134 > assembly access specifier modified from 'access' +## Remarks + The assembly visibility of a type was modified. The compiler uses the last specifier that it encounters. For example, the assembly visibility of a forward declaration may be different from the assembly visibility of the class definition. C4935 is only reachable using the obsolete compiler option **/clr:oldSyntax**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md index 1e11d9cedab..5f4861e1b29 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md @@ -10,6 +10,8 @@ ms.assetid: 07096008-ba47-436c-a84c-2b03ad90d0b3 > #pragma vtordisp is deprecated and will be removed in a future release of Visual C++ +## Remarks + The [vtordisp](../../preprocessor/vtordisp.md) pragma will be removed in a future release of Visual C++. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md index 93f5ae72111..b747bed4706 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md @@ -10,6 +10,8 @@ ms.assetid: f4f99066-9258-4330-81a8-f4a75a1d95ee > non-standard use of class '*type*' as an argument to a variadic function +## Remarks + Classes or structs that are passed to a variadic function such as `printf` must be trivially copyable. When passing such objects, the compiler simply makes a bitwise copy and does not call the constructor or destructor. This warning is available beginning in Visual Studio 2017. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md index 4faed32e0dd..013124d7ed2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md @@ -10,8 +10,12 @@ ms.assetid: b94aa52e-6029-4170-9134-017714931546 > user defined binary operator ',' exists but no overload could convert all operands, default built-in binary operator ',' used +## Remarks + A call to the built-in comma operator occurred in a program that also had an overloaded comma operator; a conversion that you thought may have occurred did not. +## Example + The following code sample generates C4913: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md index 179dfc3b515..a68e1a728b0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md @@ -10,8 +10,12 @@ ms.assetid: 1bcf6d35-3467-4aa8-b2ef-cb33f4e70238 > 'character' : invalid character in pragma optimization list +## Remarks + An unknown character was found in the optimization list of an [optimize](../../preprocessor/optimize.md) pragma statement. +## Example + For example, the following statement generates C4918: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md index a6312926814..5d6cd63bec0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md @@ -10,6 +10,8 @@ ms.assetid: cfbf08c7-94e4-4a91-a691-479d1dbe527a > we are assuming the type library was built for *number*-bit pointers +## Remarks + Explicit information was not supplied with the **ptrsize** attribute of the [#import](../../preprocessor/hash-import-directive-cpp.md) directive; the compiler concluded that pointer size of the type library is *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. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md index 873855d305f..554852afef4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md @@ -10,8 +10,12 @@ ms.assetid: 0b8d88cc-21f6-45cb-a9f5-1795b7db0dfa > `__identifier(identifier_1)` and `__identifier(identifier_2)` are indistinguishable +## Remarks + The compiler is unable to distinguish between **`_finally`** and **`__finally`** or **`__try`** and **`_try`** as a parameter passed to [`__identifier`](../../extensions/identifier-cpp-cli.md). You should not attempt to use them both as identifiers in the same program, as it will result in a [C2374](../../error-messages/compiler-errors-1/compiler-error-c2374.md) error. +## Example + The following sample generates C4932: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md index 3454d9d611d..7adac3e241d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md @@ -10,10 +10,14 @@ ms.assetid: 2bb9f0e7-bbd6-4697-84de-95955e32ae29 > 'text1' and 'text2' are indistinguishable as arguments to 'directive' +## Remarks + Because of the way the compiler processes arguments to directives, names that have meaning to the compiler, such as keywords with multiple text representations (single and double underscore forms), cannot be distinguished. Examples of such strings are __cdecl and \__forceinline. Note, under /Za, only the double underscore forms are enabled. +## Example + The following sample generates C4937: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md index 79e3c81c756..7cbb57204d0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md @@ -10,8 +10,12 @@ ms.assetid: 6acac81a-9d23-465e-b700-ed4b6e8edcd0 > 'var' : Floating point reduction variable may cause inconsistent results under /fp:strict or #pragma fenv_access +## Remarks + You should not use [/fp:strict](../../build/reference/fp-specify-floating-point-behavior.md) or [fenv_access](../../preprocessor/fenv-access.md) with OpenMP floating-point reductions, because the sum is computed in a different order. Thus, results can differ from the results without /openmp. +## Example + The following sample generates C4938: ```cpp From 61b3cee7a9054704246c9d203bd309ed1ca573b8 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 3 Sep 2025 22:43:06 +0800 Subject: [PATCH 1072/1799] Replace term "sample" with "example" for warning references in range [C4831, C4940] --- docs/error-messages/compiler-warnings/c4834.md | 2 +- docs/error-messages/compiler-warnings/c4843.md | 2 +- docs/error-messages/compiler-warnings/c4866.md | 4 ++-- .../compiler-warnings/compiler-warning-c4867.md | 2 +- .../compiler-warnings/compiler-warning-c4868.md | 4 ++-- .../compiler-warnings/compiler-warning-c4936.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4835.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4838.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4905.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4906.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4917.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4920.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4925.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4926.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4927.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4928.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4929.md | 4 ++-- .../compiler-warnings/compiler-warning-level-1-c4930.md | 6 +++--- .../compiler-warnings/compiler-warning-level-1-c4939.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4839.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4840.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4913.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4932.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4937.md | 2 +- .../compiler-warnings/compiler-warning-level-4-c4938.md | 2 +- 25 files changed, 31 insertions(+), 31 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4834.md b/docs/error-messages/compiler-warnings/c4834.md index 62746b0fce4..aca33a0eb14 100644 --- a/docs/error-messages/compiler-warnings/c4834.md +++ b/docs/error-messages/compiler-warnings/c4834.md @@ -30,7 +30,7 @@ To turn off the warning for an entire project in the Visual Studio IDE: ## Example -This sample generates C4834, and shows four ways to fix it: +This example generates C4834, and shows four ways to fix it: ```cpp // C4834.cpp diff --git a/docs/error-messages/compiler-warnings/c4843.md b/docs/error-messages/compiler-warnings/c4843.md index f867eaa11b6..34fe3329bac 100644 --- a/docs/error-messages/compiler-warnings/c4843.md +++ b/docs/error-messages/compiler-warnings/c4843.md @@ -17,7 +17,7 @@ This warning is new in Visual Studio 2017 version 15.5. For information on how t ## Example -This sample shows several **`catch`** statements that cause C4843: +This example shows several **`catch`** statements that cause C4843: ```cpp // C4843_warning.cpp diff --git a/docs/error-messages/compiler-warnings/c4866.md b/docs/error-messages/compiler-warnings/c4866.md index 66c73becda2..36dba1e4867 100644 --- a/docs/error-messages/compiler-warnings/c4866.md +++ b/docs/error-messages/compiler-warnings/c4866.md @@ -25,11 +25,11 @@ This warning was introduced in Visual Studio 2017 version 15.9 as a result of co To resolve this warning, first consider whether left-to-right evaluation of the operator elements is necessary, such as when evaluation of the elements might produce order-dependent side-effects. In many cases, the order in which elements are evaluated does not have an observable effect. -If the order of evaluation must be left-to-right, consider whether you can pass the elements by **`const`** reference instead. This change eliminates the warning in the following code sample. +If the order of evaluation must be left-to-right, consider whether you can pass the elements by **`const`** reference instead. This change eliminates the warning in the following code example. ## Example -This sample generates C4866, and shows a way to fix it: +This example generates C4866, and shows a way to fix it: ```cpp // C4866.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md index 0b8ea6ea24b..89a191c1361 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md @@ -20,7 +20,7 @@ This warning is always issued as an error. Use the [warning](../../preprocessor/ ## Example -The following sample generates C4867. +The following example generates C4867. ```cpp // C4867.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4868.md b/docs/error-messages/compiler-warnings/compiler-warning-c4868.md index fd3b6d4cdb6..f371c961f45 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4868.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4868.md @@ -20,11 +20,11 @@ This warning is off by default. Use `/Wall` to activate this warning. To resolve this warning, first consider whether left-to-right evaluation of the initializer list elements is necessary, such as when evaluation of the elements might produce order-dependent side-effects. In many cases, the order in which elements are evaluated does not have an observable effect. -If the order of evaluation must be left-to-right, consider if it's possible to pass the elements by **`const`** reference instead. A change such as this eliminates the warning in the following code sample. +If the order of evaluation must be left-to-right, consider if it's possible to pass the elements by **`const`** reference instead. A change such as this eliminates the warning in the following code example. ## Example -This sample generates C4868, and shows a way to fix it: +This example generates C4868, and shows a way to fix it: ```cpp // C4868.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4936.md b/docs/error-messages/compiler-warnings/compiler-warning-c4936.md index bd5d2d26f79..dedc93eda39 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4936.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4936.md @@ -22,7 +22,7 @@ C4936 is always issued as an error. You can disable C4936 with the [warning](.. ## Example -The following sample generates C4936: +The following example generates C4936: ```cpp // C4936.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md index 2db18b82868..c78fce7be72 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md @@ -16,7 +16,7 @@ When accessing data between managed components, it is recommended that you not u ## Examples -The following sample generates C4835. +The following example generates C4835. ```cpp // C4835.cpp @@ -28,7 +28,7 @@ __declspec(dllexport) int m = f(); // C4835 __declspec(dllexport) int *p = &n; // C4835 ``` -The following sample consumes the component built in the previous sample, showing that the value of the variables is not as expected. +The following example consumes the component built in the previous example, showing that the value of the variables is not as expected. ```cpp // C4835_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md index 19b394f9f46..64628e86b20 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md @@ -20,7 +20,7 @@ A narrowing conversion can be okay when you know the possible range of converted ## Example -The following sample generates C4838 and shows one way to fix it: +The following example generates C4838 and shows one way to fix it: ```cpp // C4838.cpp -- C++ narrowing conversion diagnostics diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md index 9a1ba2135ec..8e12058e449 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4905. +The following example generates C4905. ```cpp // C4905.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md index a56a77722a6..93593b92914 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4906: +The following example generates C4906: ```cpp // C4906.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md index 3f6010a2a7f..00b5fa25f9c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following code sample generates C4917: +The following code example generates C4917: ```cpp // C4917.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md index c4810e098e3..aa83d30ac0c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md @@ -31,7 +31,7 @@ library MyLib }; ``` -the following samples generates C4920, +the following example generates C4920, ```cpp // C4920.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md index 189c703a85c..4c2342f2d8d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md @@ -18,7 +18,7 @@ Another way to resolve this warning is not make the parameter (in the definition ## Example -The following sample generates C4925: +The following example generates C4925: ```cpp // C4925.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md index 7d3af66acf1..128a354d77a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md @@ -16,7 +16,7 @@ A forward declaration was found but an attributed construct with the same name a ## Example -The following sample generates C4926: +The following example generates C4926: ```cpp // C4926.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md index befcfdbf86a..c7cb2b6ed0f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md @@ -16,7 +16,7 @@ More than one user-defined conversion is implicitly applied to a single value -- ## Example -The following sample generates C4927: +The following example generates C4927: ```cpp // C4927.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md index 97f975333e8..964db62dbd0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md @@ -18,7 +18,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4928: +The following example generates C4928: ```cpp // C4928.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md index 762b8aacf74..d137c163c33 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md @@ -16,7 +16,7 @@ The embedded_idl attribute of [#import](../../preprocessor/hash-import-directive ## Example -The following sample defines a component. +The following example defines a component. ```cpp // C4929a.cpp @@ -48,7 +48,7 @@ struct C : I { }; ``` -The following sample generates C4929. +The following example generates C4929. ```cpp // C4929b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md index aba3ef6d51c..60bc64dce71 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md @@ -16,7 +16,7 @@ The compiler detected an unused function prototype. If the prototype was intende ## Examples -The following sample generates C4930: +The following example generates C4930: ```cpp // C4930.cpp @@ -38,7 +38,7 @@ int main() { C4930 can also occur when the compiler cannot distinguish between a function prototype declaration and a function call. -The following sample generates C4930: +The following example generates C4930: ```cpp // C4930b.cpp @@ -109,4 +109,4 @@ int main() } ``` -In the above sample, the result of a method that takes zero arguments is passed as an argument to the constructor of an unnamed local class variable. The call can be disambiguated by either naming the local variable or prefixing the method call with an object instance along with the appropriate pointer-to-member operator. +In the above example, the result of a method that takes zero arguments is passed as an argument to the constructor of an unnamed local class variable. The call can be disambiguated by either naming the local variable or prefixing the method call with an object instance along with the appropriate pointer-to-member operator. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md index 5f4861e1b29..c6fcf1d6af1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md @@ -16,7 +16,7 @@ The [vtordisp](../../preprocessor/vtordisp.md) pragma will be removed in a futur ## Example -The following sample generates C4939. +The following example generates C4939. ```cpp // C4939.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md index b747bed4706..675e7cb18d0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md @@ -18,7 +18,7 @@ This warning is available beginning in Visual Studio 2017. ## Example -The following sample generates C4839: +The following example generates C4839: ```cpp // C4839.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md index 417cd684ad3..2317907a9bb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md @@ -17,7 +17,7 @@ This warning is available beginning in Visual Studio 2017. ## Example -The following sample generates C4840 and shows how to fix it: +The following example generates C4840 and shows how to fix it: ```cpp // C4840.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md index 013124d7ed2..e8d1322f658 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md @@ -16,7 +16,7 @@ A call to the built-in comma operator occurred in a program that also had an ove ## Example -The following code sample generates C4913: +The following code example generates C4913: ```cpp // C4913.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md index 554852afef4..d1cd6504e40 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md @@ -16,7 +16,7 @@ The compiler is unable to distinguish between **`_finally`** and **`__finally`** ## Example -The following sample generates C4932: +The following example generates C4932: ```cpp // C4932.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md index 7adac3e241d..9b0a2c27619 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md @@ -18,7 +18,7 @@ Examples of such strings are __cdecl and \__forceinline. Note, under /Za, only ## Example -The following sample generates C4937: +The following example generates C4937: ```cpp // C4937.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md index 7cbb57204d0..0707e02af28 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md @@ -16,7 +16,7 @@ You should not use [/fp:strict](../../build/reference/fp-specify-floating-point- ## Example -The following sample generates C4938: +The following example generates C4938: ```cpp // C4938.cpp From 1f16d648278dc1005e4439fcf2642f2254fc6a14 Mon Sep 17 00:00:00 2001 From: Zack Johnson Date: Wed, 3 Sep 2025 10:43:14 -0400 Subject: [PATCH 1073/1799] Update ASan known issues regarding operator overrides Clarified the impact of MFC's custom operator overrides on ASan's error detection capabilities. --- docs/sanitizers/asan-known-issues.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 41d1292a402..5d0bcd92f1a 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -59,8 +59,12 @@ int main() { AddressSanitizer (ASan) uses a custom version of `operator new` and `operator delete` to find allocation errors like [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md). Running the linker with [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) ensures that ASan's `new`/`delete` override has low precedence, so that the linker chooses any `operator new` or `operator delete` overrides in other libraries over ASan's custom versions. When this happens, ASan may not be able to catch some errors that rely on its custom `operator new` and `operator delete`. -[MFC](../mfc/mfc-concepts.md) includes custom overrides for `operator new` and `operator delete` and might miss errors like [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md). - +[MFC](../mfc/mfc-concepts.md) includes custom overrides for `operator new` and `operator delete`. Any operation that utilizes these provided operators instead of the ASan provided `operator new` and `operator delete` might miss errors entirely or classify them incorrectly as a result: + - [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md) + - [`double-free`](error-double-free.md) + - [`heap-use-after-free`](error-heap-use-after-free.md) + - [`heap-buffer-overflow`](error-heap-buffer-overflow.md) + - [`new-delete-type-mismatch`](error-new-delete-type-mismatch.md) ## Memory usage From 9d1b13dd981fb972d8bc9338556b27329f872bdd Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 3 Sep 2025 22:48:14 +0800 Subject: [PATCH 1074/1799] Update metadata for warning references in range [C4831, C4940] --- docs/error-messages/compiler-warnings/c4841.md | 2 +- docs/error-messages/compiler-warnings/c4843.md | 2 +- docs/error-messages/compiler-warnings/c4866.md | 4 ++-- .../compiler-warnings/compiler-warning-c4867.md | 5 ++--- .../compiler-warnings/compiler-warning-c4868.md | 5 ++--- .../compiler-warnings/compiler-warning-c4936.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4835.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4838.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4900.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4905.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4906.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4910.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4912.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4917.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4920.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4925.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4926.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4927.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4928.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4929.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4930.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4935.md | 5 ++--- .../compiler-warnings/compiler-warning-level-1-c4939.md | 5 ++--- .../compiler-warnings/compiler-warning-level-3-c4839.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4840.md | 4 ++-- .../compiler-warnings/compiler-warning-level-4-c4913.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4918.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4931.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4932.md | 1 - .../compiler-warnings/compiler-warning-level-4-c4937.md | 5 ++--- .../compiler-warnings/compiler-warning-level-4-c4938.md | 5 ++--- 31 files changed, 58 insertions(+), 85 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c4841.md b/docs/error-messages/compiler-warnings/c4841.md index 89b7db20d63..d4b9c5b80f3 100644 --- a/docs/error-messages/compiler-warnings/c4841.md +++ b/docs/error-messages/compiler-warnings/c4841.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4841" title: "Compiler Warning (level 4) C4841" +description: "Learn more about: Compiler Warning (level 4) C4841" ms.date: 05/03/2021 f1_keywords: ["C4841"] helpviewer_keywords: ["C4841"] diff --git a/docs/error-messages/compiler-warnings/c4843.md b/docs/error-messages/compiler-warnings/c4843.md index 34fe3329bac..857df4af62d 100644 --- a/docs/error-messages/compiler-warnings/c4843.md +++ b/docs/error-messages/compiler-warnings/c4843.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4843" title: "Compiler Warning (level 4) C4843" +description: "Learn more about: Compiler Warning (level 4) C4843" ms.date: 05/03/2021 f1_keywords: ["C4843"] helpviewer_keywords: ["C4843"] diff --git a/docs/error-messages/compiler-warnings/c4866.md b/docs/error-messages/compiler-warnings/c4866.md index 36dba1e4867..5a5400220b3 100644 --- a/docs/error-messages/compiler-warnings/c4866.md +++ b/docs/error-messages/compiler-warnings/c4866.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4866" title: "Compiler Warning (Level 4) C4866" -ms.date: "09/30/2018" +description: "Learn more about: Compiler Warning (level 4) C4866" +ms.date: 09/30/2018 f1_keywords: ["C4866"] helpviewer_keywords: ["C4866"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md index 89a191c1361..3826e9e0ecc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4867" title: "Compiler Warning C4867" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4867" +ms.date: 11/04/2016 f1_keywords: ["C4867"] helpviewer_keywords: ["C4867"] -ms.assetid: 8a257d70-c3a7-462d-b285-e57c952a8bf7 --- # Compiler Warning C4867 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4868.md b/docs/error-messages/compiler-warnings/compiler-warning-c4868.md index f371c961f45..d863beaad53 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4868.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4868.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4868" title: "Compiler Warning C4868" -ms.date: "10/26/2017" +description: "Learn more about: Compiler Warning (level 4) C4868" +ms.date: 10/26/2017 f1_keywords: ["C4868"] helpviewer_keywords: ["C4868"] -ms.assetid: fc6aa7e5-34dd-4ec2-88bd-16e430361dc7 --- # Compiler Warning (level 4) C4868 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4936.md b/docs/error-messages/compiler-warnings/compiler-warning-c4936.md index dedc93eda39..73342f7523e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4936.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4936.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4936" title: "Compiler Warning C4936" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4936" +ms.date: 11/04/2016 f1_keywords: ["C4936"] helpviewer_keywords: ["C4936"] -ms.assetid: 6676de35-bf1b-4d0b-a70f-b5734130336c --- # Compiler Warning C4936 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md index c78fce7be72..f3b67e23a05 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4835" title: "Compiler Warning (level 1) C4835" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4835" +ms.date: 11/04/2016 f1_keywords: ["C4835"] helpviewer_keywords: ["C4835"] -ms.assetid: d2e44c62-7b0e-4a45-943d-97903e27ed9d --- # Compiler Warning (level 1) C4835 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md index 64628e86b20..ed58e4bc6ab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4838" title: "Compiler Warning (level 1) C4838" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4838" +ms.date: 11/04/2016 f1_keywords: ["C4838"] helpviewer_keywords: ["C4838"] -ms.assetid: fea07924-5feb-4ed4-99b5-1a8c41d28db6 --- # Compiler Warning (level 1) C4838 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md index 56a59d00efe..9d0a5cc4187 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4900" title: "Compiler Warning (level 1) C4900" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4900" +ms.date: 11/04/2016 f1_keywords: ["C4900"] helpviewer_keywords: ["C4900"] -ms.assetid: 826997ec-0803-4794-ad35-bb463f679658 --- # Compiler Warning (level 1) C4900 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md index 8e12058e449..43a136c259d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4905" title: "Compiler Warning (level 1) C4905" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4905" +ms.date: 11/04/2016 f1_keywords: ["C4905"] helpviewer_keywords: ["C4905"] -ms.assetid: 40240bf4-b14e-4c22-aeb2-52f2851532f6 --- # Compiler Warning (level 1) C4905 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md index 93593b92914..8e2c92d2274 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4906" title: "Compiler Warning (level 1) C4906" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4906" +ms.date: 11/04/2016 f1_keywords: ["C4906"] helpviewer_keywords: ["C4906"] -ms.assetid: 05318e74-799b-412a-9dce-f02b8161d762 --- # Compiler Warning (level 1) C4906 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md index 65f5bef7f26..588f5372c28 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4910" title: "Compiler Warning (level 1) C4910" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4910" +ms.date: 11/04/2016 f1_keywords: ["C4910"] helpviewer_keywords: ["C4910"] -ms.assetid: 67963560-fbca-4ca7-93db-06beaf7055f0 --- # Compiler Warning (level 1) C4910 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md index f05c737356a..1bfd258713c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4912" title: "Compiler Warning (level 1) C4912" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4912" +ms.date: 11/04/2016 f1_keywords: ["C4912"] helpviewer_keywords: ["C4912"] -ms.assetid: ba1f1a66-8c20-4792-9ac8-43e49f729ae2 --- # Compiler Warning (level 1) C4912 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md index 00b5fa25f9c..5174941c517 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4917" title: "Compiler Warning (level 1) C4917" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4917" +ms.date: 11/04/2016 f1_keywords: ["C4917"] helpviewer_keywords: ["C4917"] -ms.assetid: c05e2610-4a5d-4f4b-a99b-c15fd7f1d5f1 --- # Compiler Warning (level 1) C4917 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md index aa83d30ac0c..cd04ce20506 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4920" title: "Compiler Warning (level 1) C4920" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4920" +ms.date: 11/04/2016 f1_keywords: ["C4920"] helpviewer_keywords: ["C4920"] -ms.assetid: 1e501f2e-93c1-4d27-a4fa-54fc86271ae7 --- # Compiler Warning (level 1) C4920 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md index 4c2342f2d8d..70e1c27766b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4925" title: "Compiler Warning (level 1) C4925" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4925" +ms.date: 11/04/2016 f1_keywords: ["C4925"] helpviewer_keywords: ["C4925"] -ms.assetid: a4b206c0-016a-4f28-873a-bb8bb41bad50 --- # Compiler Warning (level 1) C4925 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md index 128a354d77a..2ef1c363482 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4926" title: "Compiler Warning (level 1) C4926" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4926" +ms.date: 11/04/2016 f1_keywords: ["C4926"] helpviewer_keywords: ["C4926"] -ms.assetid: 5717fce0-146f-4ef2-bde0-e9a01c0922d1 --- # Compiler Warning (level 1) C4926 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md index c7cb2b6ed0f..97680f685f0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4927" title: "Compiler Warning (level 1) C4927" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4927" +ms.date: 11/04/2016 f1_keywords: ["C4927"] helpviewer_keywords: ["C4927"] -ms.assetid: 7009e740-a2ef-4130-96ba-482e092f717a --- # Compiler Warning (level 1) C4927 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md index 964db62dbd0..7ad37a31713 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4928" title: "Compiler Warning (level 1) C4928" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4928" +ms.date: 11/04/2016 f1_keywords: ["C4928"] helpviewer_keywords: ["C4928"] -ms.assetid: 77235d7f-9360-45cb-8348-d148c605c4a3 --- # Compiler Warning (level 1) C4928 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md index d137c163c33..0914856a997 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4929" title: "Compiler Warning (level 1) C4929" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4929" +ms.date: 11/04/2016 f1_keywords: ["C4929"] helpviewer_keywords: ["C4929"] -ms.assetid: 95f8ab4f-4468-4caa-acd5-8f4592f03b3c --- # Compiler Warning (level 1) C4929 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md index 60bc64dce71..261fff84ad3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4930" title: "Compiler Warning (level 1) C4930" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4930" +ms.date: 11/04/2016 f1_keywords: ["C4930"] helpviewer_keywords: ["C4930"] -ms.assetid: 89a206c9-c536-4186-8e81-1cde3e7f4f5b --- # Compiler Warning (level 1) C4930 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md index 94b8359ac57..a37cde7e6c5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4935" title: "Compiler Warning (level 1) C4935" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4935" +ms.date: 11/04/2016 f1_keywords: ["C4935"] helpviewer_keywords: ["C4935"] -ms.assetid: a36c56d3-571a-44dd-bb0f-bcc6b020e134 --- # Compiler Warning (level 1) C4935 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md index c6fcf1d6af1..4568b2300b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4939" title: "Compiler Warning (level 1) C4939" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4939" +ms.date: 11/04/2016 f1_keywords: ["C4939"] helpviewer_keywords: ["C4939"] -ms.assetid: 07096008-ba47-436c-a84c-2b03ad90d0b3 --- # Compiler Warning (level 1) C4939 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md index 675e7cb18d0..0179dad250c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4839" title: "Compiler Warning (level 3) C4839" -ms.date: "09/13/2018" +description: "Learn more about: Compiler Warning (level 3) C4839" +ms.date: 09/13/2018 f1_keywords: ["C4839"] helpviewer_keywords: ["C4839"] -ms.assetid: f4f99066-9258-4330-81a8-f4a75a1d95ee --- # Compiler Warning (level 3) C4839 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md index 2317907a9bb..0c10fc635b5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4840" title: "Compiler Warning (level 4) C4840" -ms.date: "09/13/2018" +description: "Learn more about: Compiler Warning (level 4) C4840" +ms.date: 09/13/2018 f1_keywords: ["C4840"] helpviewer_keywords: ["C4840"] --- diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md index e8d1322f658..15d4c3e2211 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4913" title: "Compiler Warning (level 4) C4913" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4913" +ms.date: 11/04/2016 f1_keywords: ["C4913"] helpviewer_keywords: ["C4913"] -ms.assetid: b94aa52e-6029-4170-9134-017714931546 --- # Compiler Warning (level 4) C4913 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md index a68e1a728b0..2b0b70e3636 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4918" title: "Compiler Warning (level 4) C4918" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4918" +ms.date: 11/04/2016 f1_keywords: ["C4918"] helpviewer_keywords: ["C4918"] -ms.assetid: 1bcf6d35-3467-4aa8-b2ef-cb33f4e70238 --- # Compiler Warning (level 4) C4918 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md index 5d6cd63bec0..26f191977ec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4931" title: "Compiler Warning (level 4) C4931" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 4) C4931" +ms.date: 08/27/2018 f1_keywords: ["C4931"] helpviewer_keywords: ["C4931"] -ms.assetid: cfbf08c7-94e4-4a91-a691-479d1dbe527a --- # Compiler Warning (level 4) C4931 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md index d1cd6504e40..db065cb5d56 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler warning C4932." ms.date: 08/25/2020 f1_keywords: ["C4932"] helpviewer_keywords: ["C4932"] -ms.assetid: 0b8d88cc-21f6-45cb-a9f5-1795b7db0dfa --- # Compiler Warning (level 4) C4932 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md index 9b0a2c27619..5789faac8d6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4937" title: "Compiler Warning (level 4) C4937" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4937" +ms.date: 11/04/2016 f1_keywords: ["C4937"] helpviewer_keywords: ["C4937"] -ms.assetid: 2bb9f0e7-bbd6-4697-84de-95955e32ae29 --- # Compiler Warning (level 4) C4937 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md index 0707e02af28..d2fe0f2e961 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4938" title: "Compiler Warning (level 4) C4938" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4938" +ms.date: 11/04/2016 f1_keywords: ["C4938"] helpviewer_keywords: ["C4938"] -ms.assetid: 6acac81a-9d23-465e-b700-ed4b6e8edcd0 --- # Compiler Warning (level 4) C4938 From a47c401cae7beebb10bd3398a4764624123d64f6 Mon Sep 17 00:00:00 2001 From: Zack Johnson Date: Wed, 3 Sep 2025 11:39:42 -0400 Subject: [PATCH 1075/1799] Clarify MFC operator overrides impact on ASan --- docs/sanitizers/asan-known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 5d0bcd92f1a..5cd2dfd6d0b 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -59,7 +59,7 @@ int main() { AddressSanitizer (ASan) uses a custom version of `operator new` and `operator delete` to find allocation errors like [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md). Running the linker with [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) ensures that ASan's `new`/`delete` override has low precedence, so that the linker chooses any `operator new` or `operator delete` overrides in other libraries over ASan's custom versions. When this happens, ASan may not be able to catch some errors that rely on its custom `operator new` and `operator delete`. -[MFC](../mfc/mfc-concepts.md) includes custom overrides for `operator new` and `operator delete`. Any operation that utilizes these provided operators instead of the ASan provided `operator new` and `operator delete` might miss errors entirely or classify them incorrectly as a result: +[MFC](../mfc/mfc-concepts.md) includes custom overrides for `operator new` and `operator delete`. When `MFC` overrides are used instead of the ASan provided `operator new` and `operator delete`, ASan might miss errors entirely or classify them incorrectly as a result. The following errors may be missed or incorrectly classified: - [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md) - [`double-free`](error-double-free.md) - [`heap-use-after-free`](error-heap-use-after-free.md) From d3f8b32cb31b81d53c5e2cb027dfa8806c4a473d Mon Sep 17 00:00:00 2001 From: David Justo Date: Wed, 3 Sep 2025 09:43:41 -0700 Subject: [PATCH 1076/1799] clarify that `/hotpatch` is only available in x86 targets --- .../reference/hotpatch-create-hotpatchable-image.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index ecd2b6467e5..b33cbddb12e 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -16,13 +16,18 @@ Prepares an image for hot patching. /hotpatch ``` +> [!NOTE] +> This option is only available for x86 + ## Remarks -When **/hotpatch** is used in a compilation, the compiler ensures that the first instruction of each function is at least two bytes, and no jump within the function goes to the first instruction. These conditions are required for hot patching. +When **/hotpatch** is used in compilation, the compiler ensures that the first instruction of each function is at least two bytes, and no jump within the function goes to the first instruction. These conditions are required for hot patching. To complete the preparation for making an image hotpatchable, after you use **/hotpatch** to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, **/hotpatch** implies **/functionpadmin**. -Because instructions are always two bytes or larger on the ARM architecture, and because x64 compilation is always treated as if **/hotpatch** has been specified, you don't have to specify **/hotpatch** when you compile for these targets; however, you must still link by using **/functionpadmin** to create hotpatchable images for them. The **/hotpatch** compiler option only affects x86 compilation. + +> [!TIP] +> ARM and x64 architechtures are always treated as hotpatchable; however, you must still link by using **/functionpadmin** to create hotpatchable images for them. ### To set this compiler option in the Visual Studio development environment From d0b13a3d5a8985197efd88ed8d57ea06d37a270e Mon Sep 17 00:00:00 2001 From: David Justo Date: Wed, 3 Sep 2025 09:46:12 -0700 Subject: [PATCH 1077/1799] remove newline --- docs/build/reference/hotpatch-create-hotpatchable-image.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index b33cbddb12e..f05f69d538b 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -25,7 +25,6 @@ When **/hotpatch** is used in compilation, the compiler ensures that the first i To complete the preparation for making an image hotpatchable, after you use **/hotpatch** to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, **/hotpatch** implies **/functionpadmin**. - > [!TIP] > ARM and x64 architechtures are always treated as hotpatchable; however, you must still link by using **/functionpadmin** to create hotpatchable images for them. From 368beecc3630b801ecc82b2aa3aaaf5a2597016b Mon Sep 17 00:00:00 2001 From: David Justo Date: Wed, 3 Sep 2025 09:53:30 -0700 Subject: [PATCH 1078/1799] fix minor acrolynx issues --- docs/build/reference/hotpatch-create-hotpatchable-image.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index f05f69d538b..9534978de74 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -21,12 +21,12 @@ Prepares an image for hot patching. ## Remarks -When **/hotpatch** is used in compilation, the compiler ensures that the first instruction of each function is at least two bytes, and no jump within the function goes to the first instruction. These conditions are required for hot patching. +When **/hotpatch** is used in compilation, the compiler ensures that the first instruction of each function is at least 2 bytes, and no jump within the function goes to the first instruction. These conditions are required for hot patching. To complete the preparation for making an image hotpatchable, after you use **/hotpatch** to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, **/hotpatch** implies **/functionpadmin**. > [!TIP] -> ARM and x64 architechtures are always treated as hotpatchable; however, you must still link by using **/functionpadmin** to create hotpatchable images for them. +> ARM and x64 architectures are always treated as hotpatchable; however, you must still link by using **/functionpadmin** to create hotpatchable images for them. ### To set this compiler option in the Visual Studio development environment From 0ba02536cc7cb365a5f0c62b302d768dee55d91e Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 3 Sep 2025 15:29:54 -0700 Subject: [PATCH 1079/1799] Update AddressSanitizer options descriptions Minor edit pass. Removed code escape where it isn't necessary (we primarily use it to avoid machine translation errors when the page renders). --- docs/sanitizers/asan-flags.md | 76 +++++++++++++++++------------------ 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index f809824908b..ae5996a75d2 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -7,60 +7,60 @@ helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Add # AddressSanitizer Runtime Options -The following table lists actively supported options for the AddressSanitizer. They can be enabled through the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function, as described [here](./asan-runtime.md#runtime-options). +The following table lists the options for the AddressSanitizer. Enable them via the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function described [here](./asan-runtime.md#runtime-options). > [!NOTE] -> These descriptions may vary from the runtime options in Clang's ASan docs to account for MSVC specific behaviors. +> These descriptions account for MSVC specific behaviors which may vary from Clang's runtime options. | Flag | Default value | Description | |------|---------------|-------------| |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| -|`alloc_dealloc_mismatch` | `false` | Enables detection of mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, etc.| -|`allocator_frees_and_returns_null_on_realloc_zero` | `true` | If set to `true`, `realloc(p, 0)` is equivalent to `free(p)` by default (same as the POSIX standard). If set to `false`, `realloc(p, 0)` returns a pointer to an allocated space that can't be used. | +|`alloc_dealloc_mismatch` | `false` | Detects mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, and so on.| +|`allocator_frees_and_returns_null_on_realloc_zero` | `true` | If set to `true`, `realloc(p, 0)` is the same as `free(p)` by default (which is the same as the POSIX standard). If set to `false`, `realloc(p, 0)` returns a pointer to an allocated space that can't be used. | |`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| -|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using [these](./asan-runtime.md#poisoning) APIs.| +|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using the [Manual AddressSanitizer poising interface](./asan-runtime.md#poisoning).| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| -|`continue_on_error` | `0` | Allows an application to continue running while reporting unique memory safety errors. `0` - disabled, `1` - enabled, and error output is sent to `stdout`, `2` - enabled, and error output is sent to `stderr`. See [continue_on_error](asan-continue-on-error.md).| -|`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. See [ContainerOverflow](./error-container-overflow.md).| -|`detect_invalid_pointer_pairs` | `false` | If `true`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs, such as pointers that belong to different objects.| -|`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. See [stack-use-after-return](./error-stack-use-after-return.md).| -|`exitcode` | `1` | Override the program exit status with this value if ASan found an error.| -|`external_symbolizer_path` | `""` | Path to external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| +|`continue_on_error` | 0 | Allows an application to continue running while reporting memory safety errors. 0-disabled, 1-enabled and error output is sent to `stdout`, 2-enabled and error output is sent to `stderr`. For more information, see [continue_on_error](asan-continue-on-error.md).| +|`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. For more information, see [ContainerOverflow](./error-container-overflow.md).| +|`detect_invalid_pointer_pairs` | `false` | If `true`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs such as pointers that belong to different objects.| +|`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. For more information, see [stack-use-after-return](./error-stack-use-after-return.md).| +|`exitcode` | 1 | Overrides the program exit status with this value if ASan finds an error.| +|`external_symbolizer_path` | "" | Path to the external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| -|`halt_on_error` | `true` | Not supported. Use `continue_on_error` for full support.| +|`halt_on_error` | `true` | Not supported. Use `continue_on_error` instead.| |`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.| |`handle_sigfpe` | `true` | If `true`, ASan handles `SIGFPE` errors.| |`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to console.| -|`iat_overwrite`|`error`|`error` - report an error whenever an overwrite is detected, `protect` - attempt to avoid using the overwritten definition, `ignore` - never attempt to correct any overwritten functions. See [iat_overwrite](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| -|`include_if_exists` | `""` | Takes a path to a file, and reads options from the given file. ASan doesn't fail if file doesn't exist.| +|`iat_overwrite`|`error`|`error`-report an error whenever an overwrite is detected.
`protect`-attempt to avoid using the overwritten definition.
`ignore` - don't attempt to correct any overwritten functions. For more information, see [`iat_overwrite`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| +|`include_if_exists` | "" | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` function to find more errors.| -|`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` function to find more errors.| -|`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` functions to find more errors.| -|`malloc_context_size` | `1` | Max number of stack frames kept for each allocation/deallocation.| -|`malloc_fill_byte` | `0xbe` | Value used to fill the newly allocated memory.| -|`max_malloc_fill_size` | `4096` | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.| -|`max_redzone` | `2048` | Maximal size (in bytes) of redzones around heap objects.| -|`new_delete_type_mismatch` | `true` | Report errors on mismatch between size of `new` and `delete`. See [new-delete-type-mismatch](./error-new-delete-type-mismatch.md).| -|`poison_heap` | `true` | If `true`, poison the heap memory on (de-)allocation. `false` is useful for benchmarking the allocator or instrumentator.| +|`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` to find more errors.| +|`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` to find more errors.| +|`malloc_context_size` | 1 | Maximum number of stack frames to keep for each allocation/deallocation.| +|`malloc_fill_byte` | `0xbe` | Value used to fill newly allocated memory.| +|`max_malloc_fill_size` | 4096 | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.| +|`max_redzone` | 2048 | Maximum size (in bytes) of redzones around heap objects.| +|`new_delete_type_mismatch` | `true` | Report errors on mismatch between the size of `new` and `delete`. For more information, see [`new-delete-type-mismatch`](./error-new-delete-type-mismatch.md).| +|`poison_heap` | `true` | If `true`, poison the heap memory on allocation and deallocation. `false` is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| -|`print_cmdline` | `false` | Print command line on crash. With `continue_on_error` set >= `1`, print current working directory as `UTF-16` aware.| -|`print_summary` | `true` | If `false`, disable printing error summaries in addition to error reports.| -|`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. Lower value may increase the chance of false negatives.| -|`redzone` | `16` | Minimal size (in bytes) of redzones around heap objects. Requirement: `redzone` >= 16, is a power of two.| -|`replace_str` | `true` | If `true`, uses custom wrappers and replacements for libc string functions to find more errors.| -|`report_globals` | `1` | Controls the way to handle globals: `0` - don't detect buffer overflow on globals, `1` - detect buffer overflow, `2` - detect buffer overflow and print data about registered globals.| -|`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.| -|`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders:
`%%` - represents a `'%'` character
`%n` - frame number (copy of `frame_no`)
`%p` - `PC`
`%m` - path to module
`%o` - offset in the module
`%f` - function name
`%q` - if available, offset in the function
`%s` - path to source file
`%l` - line in the source file
`%c` - column in the source file
`%F` - if function is known, ASan prints `in `, followed by the offset in this function if source is unknown
`%S` - ASan prints file/line/column information
`%L` - If file information is available, ASan prints file name, line, and column. If module information is available, ASan prints module name, offset, and architecture. If neither are available, ASan prints `()`
`%M` - If known, ASan prints module basename and offset, or `PC`| -|`strict_memcmp` | `true` | If `true`, assume that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| -|`strict_string_checks` | `false` | If `true` check that string arguments are properly null-terminated.| -|`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| -|`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses to file or line locations.| +|`print_cmdline` | `false` | Print the command line on crash. With `continue_on_error` set >= 1, prints the current working directory and is `UTF-16` aware.| +|`print_summary` | `true` | If `false`, disables showing error summaries that accompany error reports.| +|`quarantine_size_mb` | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| +|`redzone` | 16 | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.| +|`replace_str` | `true` | If `true`, uses custom wrappers and replacements for `libc` string functions to find more errors.| +|`report_globals` | 1 | How to respond to buffer overflow for globals: 0-don't detect buffer overflow on globals, 1-detect buffer overflow, 2-detect buffer overflow and print data about registered globals.| +|`sleep_before_dying` | 0 | Number of seconds to sleep between printing an error report and terminating the program.| +|`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders:
`%%` - represents a `'%'` character
`%n` - frame number (copy of `frame_no`)
`%p` - `PC`
`%m` - path to module
`%o` - offset in the module
`%f` - function name
`%q` - if available, offset in the function
`%s` - path to source file
`%l` - line in the source file
`%c` - column in the source file
`%F` - if the function is known, ASan prints `in ` followed by the offset in this function if source is unknown
`%S` - ASan prints file/line/column information
`%L` - If file information is available, ASan prints the file name, line, and column. If module information is available, ASan prints the module name, offset, and architecture. If neither are available, ASan prints `()`
`%M` - If known, ASan prints module basename and offset, or `PC`| +|`strict_memcmp` | `true` | If `true`, assumes that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| +|`strict_string_checks` | `false` | If `true` checks that string arguments are properly null-terminated.| +|`strip_path_prefix` | "" | Strips this prefix from file paths in error reports.| +|`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses into file or line locations.| |`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| -|`verbosity` | `0` | Verbosity level: `0` - default verbosity, `1` - more output, `2` - even more output, `3` - current upper limit verbosity level | -|`windows_fast_fail_on_error`|`false`|If `true`, enable the process to terminate with a `__fastfail(71)` after printing the error report. See [windows_fast_fail_on_error](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| -|`windows_hook_legacy_allocators`|`true`|If `true`, enable hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| +|`verbosity` | 0 | Verbosity level: 0-default verbosity, 1-more output, 2-even more output, 3-maximum verbosity. | +|`windows_fast_fail_on_error`| `false` | If `true`, the process can terminate with a `__fastfail(71)` after printing the error report. For more information, see [`windows_fast_fail_on_error`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| +|`windows_hook_legacy_allocators`| `true` |If `true`, enables hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| ## See also @@ -70,4 +70,4 @@ The following table lists actively supported options for the AddressSanitizer. T [AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ [AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ [AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) \ No newline at end of file +[AddressSanitizer error examples](./asan-error-examples.md) From e56d2dfee781f29670e2cb838e38d4a16a78bf0d Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 3 Sep 2025 15:31:31 -0700 Subject: [PATCH 1080/1799] Reorder runtime reference in table of contents alphabetical (though the entire TOC isn't alphabetical) and knowing what the options are seems to come before wanting the reference. --- docs/sanitizers/toc.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/toc.yml b/docs/sanitizers/toc.yml index 66b72750b80..ac16359f797 100644 --- a/docs/sanitizers/toc.yml +++ b/docs/sanitizers/toc.yml @@ -10,10 +10,10 @@ items: href: ../sanitizers/asan-continue-on-error.md - name: "Build and language reference" href: ../sanitizers/asan-building.md - - name: "Runtime reference" - href: ../sanitizers/asan-runtime.md - name: "Runtime options" href: ../sanitizers/asan-flags.md + - name: "Runtime reference" + href: ../sanitizers/asan-runtime.md - name: "Debugger integration" href: ../sanitizers/asan-debugger-integration.md - name: "Shadow bytes" From 7a1207f69de3136c0191b0e3882091ed38087cf1 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 3 Sep 2025 15:42:07 -0700 Subject: [PATCH 1081/1799] Update ASAN_OPTIONS descriptions for clarity acrolinx --- docs/sanitizers/asan-flags.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index ae5996a75d2..6e9b8d62978 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Add The following table lists the options for the AddressSanitizer. Enable them via the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function described [here](./asan-runtime.md#runtime-options). > [!NOTE] -> These descriptions account for MSVC specific behaviors which may vary from Clang's runtime options. +> These descriptions account for Microsoft Visual C++ (MSVC) specific behaviors, which may vary from Clang's runtime options. | Flag | Default value | Description | @@ -21,7 +21,7 @@ The following table lists the options for the AddressSanitizer. Enable them via |`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using the [Manual AddressSanitizer poising interface](./asan-runtime.md#poisoning).| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| -|`continue_on_error` | 0 | Allows an application to continue running while reporting memory safety errors. 0-disabled, 1-enabled and error output is sent to `stdout`, 2-enabled and error output is sent to `stderr`. For more information, see [continue_on_error](asan-continue-on-error.md).| +|`continue_on_error` | 0 | Allows an application to continue running while reporting memory safety errors.
0-disabled.
1-enabled; errors are sent to `stdout`.
2-enabled; errors are sent to `stderr`.
For more information, see [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. For more information, see [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `false` | If `true`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. For more information, see [stack-use-after-return](./error-stack-use-after-return.md).| From c77b36b0f45a3367ba91e2538aeb4d2afd66833e Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 3 Sep 2025 16:01:00 -0700 Subject: [PATCH 1082/1799] Fix formatting and descriptions in asan-flags.md little fixes --- docs/sanitizers/asan-flags.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 6e9b8d62978..87cc4ecc0ee 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -33,9 +33,9 @@ The following table lists the options for the AddressSanitizer. Enable them via |`handle_sigfpe` | `true` | If `true`, ASan handles `SIGFPE` errors.| |`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to console.| -|`iat_overwrite`|`error`|`error`-report an error whenever an overwrite is detected.
`protect`-attempt to avoid using the overwritten definition.
`ignore` - don't attempt to correct any overwritten functions. For more information, see [`iat_overwrite`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| +|`iat_overwrite`|`error`|`error` - reports an error whenever an overwrite is detected.
`protect` - trys to avoid using the overwritten definition.
`ignore` - doesn't try to correct any overwritten functions. For more information, see [`iat_overwrite`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include_if_exists` | "" | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.| -|`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` function to find more errors.| +|`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` to find more errors.| |`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` to find more errors.| |`malloc_context_size` | 1 | Maximum number of stack frames to keep for each allocation/deallocation.| @@ -50,7 +50,7 @@ The following table lists the options for the AddressSanitizer. Enable them via |`quarantine_size_mb` | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| |`redzone` | 16 | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.| |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for `libc` string functions to find more errors.| -|`report_globals` | 1 | How to respond to buffer overflow for globals: 0-don't detect buffer overflow on globals, 1-detect buffer overflow, 2-detect buffer overflow and print data about registered globals.| +|`report_globals` | 1 | How to respond to buffer overflow for globals:
0-don't detect buffer overflow on globals.
1 - detect buffer overflow.
2 - detect buffer overflow and print registered globals data.| |`sleep_before_dying` | 0 | Number of seconds to sleep between printing an error report and terminating the program.| |`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders:
`%%` - represents a `'%'` character
`%n` - frame number (copy of `frame_no`)
`%p` - `PC`
`%m` - path to module
`%o` - offset in the module
`%f` - function name
`%q` - if available, offset in the function
`%s` - path to source file
`%l` - line in the source file
`%c` - column in the source file
`%F` - if the function is known, ASan prints `in ` followed by the offset in this function if source is unknown
`%S` - ASan prints file/line/column information
`%L` - If file information is available, ASan prints the file name, line, and column. If module information is available, ASan prints the module name, offset, and architecture. If neither are available, ASan prints `()`
`%M` - If known, ASan prints module basename and offset, or `PC`| |`strict_memcmp` | `true` | If `true`, assumes that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| @@ -58,7 +58,7 @@ The following table lists the options for the AddressSanitizer. Enable them via |`strip_path_prefix` | "" | Strips this prefix from file paths in error reports.| |`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses into file or line locations.| |`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| -|`verbosity` | 0 | Verbosity level: 0-default verbosity, 1-more output, 2-even more output, 3-maximum verbosity. | +|`verbosity` | 0 | Verbosity level:
0 - default verbosity.
1 - more output.
2 - even more output.
3 - maximum verbosity. | |`windows_fast_fail_on_error`| `false` | If `true`, the process can terminate with a `__fastfail(71)` after printing the error report. For more information, see [`windows_fast_fail_on_error`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`windows_hook_legacy_allocators`| `true` |If `true`, enables hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| From 7a8a30b62313e993d128cca22be6747b29b0b6c0 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 3 Sep 2025 16:05:20 -0700 Subject: [PATCH 1083/1799] Very small edit. Should have got it earlier. --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 87cc4ecc0ee..02799d0c66b 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -32,7 +32,7 @@ The following table lists the options for the AddressSanitizer. Enable them via |`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.| |`handle_sigfpe` | `true` | If `true`, ASan handles `SIGFPE` errors.| |`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.| -|`help` | `false` | If `true`, ASan prints the flag options to console.| +|`help` | `false` | If `true`, ASan prints the flag options to the console.| |`iat_overwrite`|`error`|`error` - reports an error whenever an overwrite is detected.
`protect` - trys to avoid using the overwritten definition.
`ignore` - doesn't try to correct any overwritten functions. For more information, see [`iat_overwrite`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include_if_exists` | "" | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` to find more errors.| From 2922a7e46e664bacc9ea3ec83087f431b7cce5dc Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 3 Sep 2025 16:06:51 -0700 Subject: [PATCH 1084/1799] Code escape values --- docs/sanitizers/asan-flags.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 87cc4ecc0ee..3a7438eb8ab 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -21,12 +21,12 @@ The following table lists the options for the AddressSanitizer. Enable them via |`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using the [Manual AddressSanitizer poising interface](./asan-runtime.md#poisoning).| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| -|`continue_on_error` | 0 | Allows an application to continue running while reporting memory safety errors.
0-disabled.
1-enabled; errors are sent to `stdout`.
2-enabled; errors are sent to `stderr`.
For more information, see [continue_on_error](asan-continue-on-error.md).| +|`continue_on_error` | `0` | Allows an application to continue running while reporting memory safety errors.
`0` - disabled.
`1` - enabled. errors are sent to `stdout`.
`2` - enabled. errors are sent to `stderr`.
For more information, see [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. For more information, see [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `false` | If `true`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. For more information, see [stack-use-after-return](./error-stack-use-after-return.md).| -|`exitcode` | 1 | Overrides the program exit status with this value if ASan finds an error.| -|`external_symbolizer_path` | "" | Path to the external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| +|`exitcode` | `1` | Overrides the program exit status with this value if ASan finds an error.| +|`external_symbolizer_path` | `""` | Path to the external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| |`halt_on_error` | `true` | Not supported. Use `continue_on_error` instead.| |`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.| @@ -34,31 +34,31 @@ The following table lists the options for the AddressSanitizer. Enable them via |`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to console.| |`iat_overwrite`|`error`|`error` - reports an error whenever an overwrite is detected.
`protect` - trys to avoid using the overwritten definition.
`ignore` - doesn't try to correct any overwritten functions. For more information, see [`iat_overwrite`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| -|`include_if_exists` | "" | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.| +|`include_if_exists` | `""` | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` to find more errors.| |`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` to find more errors.| -|`malloc_context_size` | 1 | Maximum number of stack frames to keep for each allocation/deallocation.| +|`malloc_context_size` | `1` | Maximum number of stack frames to keep for each allocation/deallocation.| |`malloc_fill_byte` | `0xbe` | Value used to fill newly allocated memory.| -|`max_malloc_fill_size` | 4096 | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.| -|`max_redzone` | 2048 | Maximum size (in bytes) of redzones around heap objects.| +|`max_malloc_fill_size` | `4096` | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.| +|`max_redzone` | `2048` | Maximum size (in bytes) of redzones around heap objects.| |`new_delete_type_mismatch` | `true` | Report errors on mismatch between the size of `new` and `delete`. For more information, see [`new-delete-type-mismatch`](./error-new-delete-type-mismatch.md).| |`poison_heap` | `true` | If `true`, poison the heap memory on allocation and deallocation. `false` is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print the command line on crash. With `continue_on_error` set >= 1, prints the current working directory and is `UTF-16` aware.| |`print_summary` | `true` | If `false`, disables showing error summaries that accompany error reports.| -|`quarantine_size_mb` | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| -|`redzone` | 16 | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.| +|`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| +|`redzone` | `16` | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.| |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for `libc` string functions to find more errors.| -|`report_globals` | 1 | How to respond to buffer overflow for globals:
0-don't detect buffer overflow on globals.
1 - detect buffer overflow.
2 - detect buffer overflow and print registered globals data.| -|`sleep_before_dying` | 0 | Number of seconds to sleep between printing an error report and terminating the program.| +|`report_globals` | `1` | How to respond to buffer overflow for globals:
`0` - don't detect buffer overflow on globals.
`1` - detect buffer overflow.
`2` - detect buffer overflow and print registered globals data.| +|`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.| |`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders:
`%%` - represents a `'%'` character
`%n` - frame number (copy of `frame_no`)
`%p` - `PC`
`%m` - path to module
`%o` - offset in the module
`%f` - function name
`%q` - if available, offset in the function
`%s` - path to source file
`%l` - line in the source file
`%c` - column in the source file
`%F` - if the function is known, ASan prints `in ` followed by the offset in this function if source is unknown
`%S` - ASan prints file/line/column information
`%L` - If file information is available, ASan prints the file name, line, and column. If module information is available, ASan prints the module name, offset, and architecture. If neither are available, ASan prints `()`
`%M` - If known, ASan prints module basename and offset, or `PC`| |`strict_memcmp` | `true` | If `true`, assumes that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| |`strict_string_checks` | `false` | If `true` checks that string arguments are properly null-terminated.| -|`strip_path_prefix` | "" | Strips this prefix from file paths in error reports.| +|`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| |`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses into file or line locations.| |`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| -|`verbosity` | 0 | Verbosity level:
0 - default verbosity.
1 - more output.
2 - even more output.
3 - maximum verbosity. | +|`verbosity` | `0` | Verbosity level:
`0` - default verbosity.
`1` - more output.
`2` - even more output.
`3` - maximum verbosity. | |`windows_fast_fail_on_error`| `false` | If `true`, the process can terminate with a `__fastfail(71)` after printing the error report. For more information, see [`windows_fast_fail_on_error`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`windows_hook_legacy_allocators`| `true` |If `true`, enables hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| From cdcc4a506dbd1a3c518b1595c1d9e7d660b0dd2e Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 3 Sep 2025 16:15:18 -0700 Subject: [PATCH 1085/1799] Revert "Code escape values" This reverts commit 2922a7e46e664bacc9ea3ec83087f431b7cce5dc. --- docs/sanitizers/asan-flags.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index abc7ab81db1..02799d0c66b 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -21,12 +21,12 @@ The following table lists the options for the AddressSanitizer. Enable them via |`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| |`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using the [Manual AddressSanitizer poising interface](./asan-runtime.md#poisoning).| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| -|`continue_on_error` | `0` | Allows an application to continue running while reporting memory safety errors.
`0` - disabled.
`1` - enabled. errors are sent to `stdout`.
`2` - enabled. errors are sent to `stderr`.
For more information, see [continue_on_error](asan-continue-on-error.md).| +|`continue_on_error` | 0 | Allows an application to continue running while reporting memory safety errors.
0-disabled.
1-enabled; errors are sent to `stdout`.
2-enabled; errors are sent to `stderr`.
For more information, see [continue_on_error](asan-continue-on-error.md).| |`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. For more information, see [ContainerOverflow](./error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `false` | If `true`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs such as pointers that belong to different objects.| |`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. For more information, see [stack-use-after-return](./error-stack-use-after-return.md).| -|`exitcode` | `1` | Overrides the program exit status with this value if ASan finds an error.| -|`external_symbolizer_path` | `""` | Path to the external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| +|`exitcode` | 1 | Overrides the program exit status with this value if ASan finds an error.| +|`external_symbolizer_path` | "" | Path to the external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| |`halt_on_error` | `true` | Not supported. Use `continue_on_error` instead.| |`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.| @@ -34,31 +34,31 @@ The following table lists the options for the AddressSanitizer. Enable them via |`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to the console.| |`iat_overwrite`|`error`|`error` - reports an error whenever an overwrite is detected.
`protect` - trys to avoid using the overwritten definition.
`ignore` - doesn't try to correct any overwritten functions. For more information, see [`iat_overwrite`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| -|`include_if_exists` | `""` | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.| +|`include_if_exists` | "" | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` to find more errors.| |`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` to find more errors.| -|`malloc_context_size` | `1` | Maximum number of stack frames to keep for each allocation/deallocation.| +|`malloc_context_size` | 1 | Maximum number of stack frames to keep for each allocation/deallocation.| |`malloc_fill_byte` | `0xbe` | Value used to fill newly allocated memory.| -|`max_malloc_fill_size` | `4096` | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.| -|`max_redzone` | `2048` | Maximum size (in bytes) of redzones around heap objects.| +|`max_malloc_fill_size` | 4096 | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.| +|`max_redzone` | 2048 | Maximum size (in bytes) of redzones around heap objects.| |`new_delete_type_mismatch` | `true` | Report errors on mismatch between the size of `new` and `delete`. For more information, see [`new-delete-type-mismatch`](./error-new-delete-type-mismatch.md).| |`poison_heap` | `true` | If `true`, poison the heap memory on allocation and deallocation. `false` is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print the command line on crash. With `continue_on_error` set >= 1, prints the current working directory and is `UTF-16` aware.| |`print_summary` | `true` | If `false`, disables showing error summaries that accompany error reports.| -|`quarantine_size_mb` | `-1` | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| -|`redzone` | `16` | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.| +|`quarantine_size_mb` | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| +|`redzone` | 16 | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.| |`replace_str` | `true` | If `true`, uses custom wrappers and replacements for `libc` string functions to find more errors.| -|`report_globals` | `1` | How to respond to buffer overflow for globals:
`0` - don't detect buffer overflow on globals.
`1` - detect buffer overflow.
`2` - detect buffer overflow and print registered globals data.| -|`sleep_before_dying` | `0` | Number of seconds to sleep between printing an error report and terminating the program.| +|`report_globals` | 1 | How to respond to buffer overflow for globals:
0-don't detect buffer overflow on globals.
1 - detect buffer overflow.
2 - detect buffer overflow and print registered globals data.| +|`sleep_before_dying` | 0 | Number of seconds to sleep between printing an error report and terminating the program.| |`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders:
`%%` - represents a `'%'` character
`%n` - frame number (copy of `frame_no`)
`%p` - `PC`
`%m` - path to module
`%o` - offset in the module
`%f` - function name
`%q` - if available, offset in the function
`%s` - path to source file
`%l` - line in the source file
`%c` - column in the source file
`%F` - if the function is known, ASan prints `in ` followed by the offset in this function if source is unknown
`%S` - ASan prints file/line/column information
`%L` - If file information is available, ASan prints the file name, line, and column. If module information is available, ASan prints the module name, offset, and architecture. If neither are available, ASan prints `()`
`%M` - If known, ASan prints module basename and offset, or `PC`| |`strict_memcmp` | `true` | If `true`, assumes that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| |`strict_string_checks` | `false` | If `true` checks that string arguments are properly null-terminated.| -|`strip_path_prefix` | `""` | Strips this prefix from file paths in error reports.| +|`strip_path_prefix` | "" | Strips this prefix from file paths in error reports.| |`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses into file or line locations.| |`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| -|`verbosity` | `0` | Verbosity level:
`0` - default verbosity.
`1` - more output.
`2` - even more output.
`3` - maximum verbosity. | +|`verbosity` | 0 | Verbosity level:
0 - default verbosity.
1 - more output.
2 - even more output.
3 - maximum verbosity. | |`windows_fast_fail_on_error`| `false` | If `true`, the process can terminate with a `__fastfail(71)` after printing the error report. For more information, see [`windows_fast_fail_on_error`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`windows_hook_legacy_allocators`| `true` |If `true`, enables hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| From 7da07f6f9578c1b3a0d877b6947832c6dd3f95a7 Mon Sep 17 00:00:00 2001 From: David Justo Date: Thu, 4 Sep 2025 09:09:28 -0700 Subject: [PATCH 1086/1799] ARM -> arm64 --- docs/build/reference/hotpatch-create-hotpatchable-image.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index 9534978de74..fa395bdbdb9 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -26,7 +26,7 @@ When **/hotpatch** is used in compilation, the compiler ensures that the first i To complete the preparation for making an image hotpatchable, after you use **/hotpatch** to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, **/hotpatch** implies **/functionpadmin**. > [!TIP] -> ARM and x64 architectures are always treated as hotpatchable; however, you must still link by using **/functionpadmin** to create hotpatchable images for them. +> Arm64 and x64 architectures are always treated as hotpatchable; however, you must still link by using **/functionpadmin** to create hotpatchable images for them. ### To set this compiler option in the Visual Studio development environment From 502b3494c03a5d756ff6b4e958f9a2f4b4cfec63 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 5 Sep 2025 02:28:23 +0800 Subject: [PATCH 1087/1799] Tweak "Walkthrough: Create a traditional Windows desktop application (C++)" (#5576) * Fix "does" typo in "Walkthrough: Create a traditional Windows desktop application (C++)" * Replace "length" with "height" in "Walkthrough: Create a traditional Windows desktop application (C++)" * Fix outdated mentions of `CreateWindow` in "Walkthrough: Create a traditional Windows desktop application (C++)" --- ...reating-windows-desktop-applications-cpp.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md b/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md index e156b5e7b47..fb86016e1c0 100644 --- a/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md +++ b/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md @@ -216,7 +216,7 @@ Next, learn how to create the code for a Windows desktop application in Visual S // szTitle: the text that appears in the title bar // WS_OVERLAPPEDWINDOW: the type of window to create // CW_USEDEFAULT, CW_USEDEFAULT: initial position (x, y) - // 500, 100: initial size (width, length) + // 500, 100: initial size (width, height) // NULL: the parent of this window // NULL: this application does not have a menu bar // hInstance: the first parameter from WinMain @@ -250,7 +250,7 @@ Next, learn how to create the code for a Windows desktop application in Visual S ```cpp // The parameters to ShowWindow explained: - // hWnd: the value returned from CreateWindow + // hWnd: the value returned from CreateWindowEx // nCmdShow: the fourth parameter from WinMain ShowWindow(hWnd, nCmdShow); @@ -316,9 +316,9 @@ Next, learn how to create the code for a Windows desktop application in Visual S // szTitle: the text that appears in the title bar // WS_OVERLAPPEDWINDOW: the type of window to create // CW_USEDEFAULT, CW_USEDEFAULT: initial position (x, y) - // 500, 100: initial size (width, length) + // 500, 100: initial size (width, height) // NULL: the parent of this window - // NULL: this application dows not have a menu bar + // NULL: this application does not have a menu bar // hInstance: the first parameter from WinMain // NULL: not used in this application HWND hWnd = CreateWindowEx( @@ -337,7 +337,7 @@ Next, learn how to create the code for a Windows desktop application in Visual S if (!hWnd) { MessageBox(NULL, - _T("Call to CreateWindow failed!"), + _T("Call to CreateWindowEx failed!"), _T("Windows Desktop Guided Tour"), NULL); @@ -345,7 +345,7 @@ Next, learn how to create the code for a Windows desktop application in Visual S } // The parameters to ShowWindow explained: - // hWnd: the value returned from CreateWindow + // hWnd: the value returned from CreateWindowEx // nCmdShow: the fourth parameter from WinMain ShowWindow(hWnd, nCmdShow); UpdateWindow(hWnd); @@ -503,7 +503,7 @@ As promised, the complete code for the working application follows. // szTitle: the text that appears in the title bar // WS_OVERLAPPEDWINDOW: the type of window to create // CW_USEDEFAULT, CW_USEDEFAULT: initial position (x, y) - // 500, 100: initial size (width, length) + // 500, 100: initial size (width, height) // NULL: the parent of this window // NULL: this application does not have a menu bar // hInstance: the first parameter from WinMain @@ -524,7 +524,7 @@ As promised, the complete code for the working application follows. if (!hWnd) { MessageBox(NULL, - _T("Call to CreateWindow failed!"), + _T("Call to CreateWindowEx failed!"), _T("Windows Desktop Guided Tour"), NULL); @@ -532,7 +532,7 @@ As promised, the complete code for the working application follows. } // The parameters to ShowWindow explained: - // hWnd: the value returned from CreateWindow + // hWnd: the value returned from CreateWindowEx // nCmdShow: the fourth parameter from WinMain ShowWindow(hWnd, nCmdShow); From 303c32ff13c0b80a9e32bed4c76288ee33d54112 Mon Sep 17 00:00:00 2001 From: David Justo Date: Thu, 4 Sep 2025 12:09:14 -0700 Subject: [PATCH 1088/1799] incorporate feedback --- docs/build/reference/hotpatch-create-hotpatchable-image.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index fa395bdbdb9..585b718aac8 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -21,13 +21,12 @@ Prepares an image for hot patching. ## Remarks -When **/hotpatch** is used in compilation, the compiler ensures that the first instruction of each function is at least 2 bytes, and no jump within the function goes to the first instruction. These conditions are required for hot patching. +When **/hotpatch** is used in compilation, the compiler ensures that the first instruction of each function is at least 2 bytes long, and no jump within the function goes to the first instruction. These conditions are required for hot patching. -To complete the preparation for making an image hotpatchable, after you use **/hotpatch** to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, **/hotpatch** implies **/functionpadmin**. +To complete the preparation for making an image hotpatchable, after you use **/hotpatch** to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, `/hotpatch` implies `/functionpadmin`. > [!TIP] -> Arm64 and x64 architectures are always treated as hotpatchable; however, you must still link by using **/functionpadmin** to create hotpatchable images for them. - +> Arm64 and x64 architectures are always treated as hotpatchable. But you must still link by using `/functionpadmin` to create hotpatchable images for them. ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). From 141b0e2d79f9276f781f16daabbfd31e5e43da36 Mon Sep 17 00:00:00 2001 From: David Justo Date: Thu, 4 Sep 2025 12:11:20 -0700 Subject: [PATCH 1089/1799] use backticks --- docs/build/reference/hotpatch-create-hotpatchable-image.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index 585b718aac8..489835421aa 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -21,9 +21,9 @@ Prepares an image for hot patching. ## Remarks -When **/hotpatch** is used in compilation, the compiler ensures that the first instruction of each function is at least 2 bytes long, and no jump within the function goes to the first instruction. These conditions are required for hot patching. +When `/hotpatch` is used in compilation, the compiler ensures that the first instruction of each function is at least 2 bytes long, and no jump within the function goes to the first instruction. These conditions are required for hot patching. -To complete the preparation for making an image hotpatchable, after you use **/hotpatch** to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, `/hotpatch` implies `/functionpadmin`. +To complete the preparation for making an image hotpatchable, after you use `/hotpatch` to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, `/hotpatch` implies `/functionpadmin`. > [!TIP] > Arm64 and x64 architectures are always treated as hotpatchable. But you must still link by using `/functionpadmin` to create hotpatchable images for them. From 22b4ad7baac8837fbcee826920cd4ddb77b9ca04 Mon Sep 17 00:00:00 2001 From: David Justo Date: Thu, 4 Sep 2025 12:14:06 -0700 Subject: [PATCH 1090/1799] use backticks everywhere --- docs/build/reference/hotpatch-create-hotpatchable-image.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index 489835421aa..f5ed264bbc8 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -23,7 +23,7 @@ Prepares an image for hot patching. When `/hotpatch` is used in compilation, the compiler ensures that the first instruction of each function is at least 2 bytes long, and no jump within the function goes to the first instruction. These conditions are required for hot patching. -To complete the preparation for making an image hotpatchable, after you use `/hotpatch` to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, `/hotpatch` implies `/functionpadmin`. +To complete the preparation for making an image hotpatchable, after you use `/hotpatch` to compile, you must use [`functionpadmin`](functionpadmin-create-hotpatchable-image.md) (Create Hotpatchable Image)]to link. When you compile and link an image by using one invocation of cl.exe, `/hotpatch` implies `/functionpadmin`. > [!TIP] > Arm64 and x64 architectures are always treated as hotpatchable. But you must still link by using `/functionpadmin` to create hotpatchable images for them. From 7421eb3ac90d5037064357392ee1dbd367d6b694 Mon Sep 17 00:00:00 2001 From: David Justo Date: Thu, 4 Sep 2025 12:14:26 -0700 Subject: [PATCH 1091/1799] add dropped backslash --- docs/build/reference/hotpatch-create-hotpatchable-image.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index f5ed264bbc8..4753a819348 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -23,7 +23,7 @@ Prepares an image for hot patching. When `/hotpatch` is used in compilation, the compiler ensures that the first instruction of each function is at least 2 bytes long, and no jump within the function goes to the first instruction. These conditions are required for hot patching. -To complete the preparation for making an image hotpatchable, after you use `/hotpatch` to compile, you must use [`functionpadmin`](functionpadmin-create-hotpatchable-image.md) (Create Hotpatchable Image)]to link. When you compile and link an image by using one invocation of cl.exe, `/hotpatch` implies `/functionpadmin`. +To complete the preparation for making an image hotpatchable, after you use `/hotpatch` to compile, you must use [`/functionpadmin`](functionpadmin-create-hotpatchable-image.md) (Create Hotpatchable Image)]to link. When you compile and link an image by using one invocation of cl.exe, `/hotpatch` implies `/functionpadmin`. > [!TIP] > Arm64 and x64 architectures are always treated as hotpatchable. But you must still link by using `/functionpadmin` to create hotpatchable images for them. From 26bf721faf120c88601d630ac20fd1ea171e00fb Mon Sep 17 00:00:00 2001 From: Aaron Robinson Date: Thu, 4 Sep 2025 13:15:34 -0700 Subject: [PATCH 1092/1799] Update C++/CLI section with compatibility notes (#5735) * Update C++/CLI section with compatibility notes * Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Co-authored-by: Rageking8 --------- Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Co-authored-by: Rageking8 --- docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md b/docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md index 5306b90a11b..359bef6d31e 100644 --- a/docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md +++ b/docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md @@ -6,6 +6,13 @@ helpviewer_keywords: ["programming [C++], .NET programming", ".NET Framework [C+ --- # .NET programming with C++/CLI +> [!IMPORTANT] +> C++/CLI is a technology designed during the early years of .NET (2003–2010) and remains supported for compatibility purposes. It's best suited for existing codebases, particularly those being brought forward from .NET Framework to .NET Core, or for maintaining large legacy systems that are unlikely to evolve beyond .NET Framework. +> +> While C++/CLI is reliable and robust, no new feature work is planned beyond what's necessary to ensure continued functionality. Developers should be aware that using C++/CLI pessimizes both C++ and .NET languages, as it's constrained by the language features and APIs available at the time of its design—that is, prior to ISO C++11 and .NET Core. C++/CLI was designed based on C++98, and its [ECMA standard](https://ecma-international.org/publications-and-standards/standards/ecma-372) hasn't been updated to keep up with newer C++ standards since C++11. While some features in C++11 were incorporated, many features from more recent standards, like C++20 and C++23, have no direct support in C++/CLI for compilation to managed code. For more information, see [C++20 Support Comes To C++/CLI](https://devblogs.microsoft.com/cppblog/cpp20-support-comes-to-cpp-cli/). +> +> For new projects, we recommend exploring modern third-party alternatives such as or , which offer more flexibility and better alignment with current language and runtime capabilities. + C++/CLI supplanted Managed C++. C++/CLI is a language specification created by Microsoft that extends C++ to support .NET. It's only supported on Windows. It's not for writing [WinUI](/windows/apps/winui) or Universal Windows Platform [UWP](/windows/uwp/get-started/universal-application-platform-guide) Windows Runtime (WinRT) apps. It's for writing .NET applications and components that run on .NET. C++/CLI is a bridge between native C++ code and managed code. It allows you to use existing C++ libraries in .NET applications and to write new .NET applications in C++. Microsoft provides C++/WinRT for writing WinUI and WinRT apps. It's an entirely standard modern C++17 language projection for Windows Runtime (WinRT) APIs. For more information about using C++ with the Windows Runtime (WinRT), see [C++/WinRT](/windows/uwp/cpp-and-winrt-apis/). From 273d6ad58958fb8aa0b5a6f1ed15bbdd49bfb266 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 4 Sep 2025 19:11:36 -0700 Subject: [PATCH 1093/1799] Revise hotpatch documentation and update date Some acrolinx and other misc fixes. --- .../hotpatch-create-hotpatchable-image.md | 22 +++++++++---------- 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index 4753a819348..011a1b31280 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: /hotpatch (Create Hotpatchable Image)" -title: "/hotpatch (Create Hotpatchable Image)" -ms.date: "12/7/2021" +description: "Learn more about: /hotpatch (Create hotpatchable image)" +title: "/hotpatch (Create hotpatchable image)" +ms.date: "9/4/2025" f1_keywords: ["/hotpatch", "VC.Project.VCCLCompilerTool.CreateHotpatchableImage"] -helpviewer_keywords: ["hot patching", "-hotpatch compiler option [C++]", "/hotpatch compiler option [C++]", "hotpatching"] -ms.assetid: aad539b6-c053-4c78-8682-853d98327798 +helpviewer_keywords: ["hot patching", "hotpatching", "-hotpatch compiler option [C++]", "/hotpatch compiler option [C++]"] --- -# /hotpatch (Create Hotpatchable Image) +# /hotpatch (Create hotpatchable image) -Prepares an image for hot patching. +Prepares an image for hotpatching. ## Syntax @@ -21,18 +20,17 @@ Prepares an image for hot patching. ## Remarks -When `/hotpatch` is used in compilation, the compiler ensures that the first instruction of each function is at least 2 bytes long, and no jump within the function goes to the first instruction. These conditions are required for hot patching. +When `/hotpatch` is used during compilation, the compiler ensures that the first instruction of each function is at least 2 bytes long and that no jump within the function goes to the first instruction. These conditions are required for hotpatching. -To complete the preparation for making an image hotpatchable, after you use `/hotpatch` to compile, you must use [`/functionpadmin`](functionpadmin-create-hotpatchable-image.md) (Create Hotpatchable Image)]to link. When you compile and link an image by using one invocation of cl.exe, `/hotpatch` implies `/functionpadmin`. +To complete the preparation for making an image hotpatchable, after you compile with `/hotpatch`, use [`/functionpadmin`](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image using one invocation of `cl.exe`, `/hotpatch` implies `/functionpadmin`. > [!TIP] > Arm64 and x64 architectures are always treated as hotpatchable. But you must still link by using `/functionpadmin` to create hotpatchable images for them. + ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page. - 1. Add the compiler option to the **Additional Options** box. ### To set this compiler option programmatically @@ -41,5 +39,5 @@ To complete the preparation for making an image hotpatchable, after you use `/ho ## See also -[MSVC Compiler Options](compiler-options.md)
+[MSVC Compiler Options](compiler-options.md)\ [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md) From 796105db345fa9ac870fecc29f93bcd67af701f9 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 5 Sep 2025 23:13:18 +0800 Subject: [PATCH 1094/1799] Add "Remarks" headings for warning references in range [C6000, C6250] --- docs/code-quality/c6011.md | 2 +- docs/code-quality/c6014.md | 4 ++-- docs/code-quality/c6029.md | 4 ++-- docs/code-quality/c6031.md | 2 +- docs/code-quality/c6053.md | 2 +- docs/code-quality/c6064.md | 4 ++-- docs/code-quality/c6067.md | 2 +- docs/code-quality/c6101.md | 4 ++-- docs/code-quality/c6102.md | 2 ++ docs/code-quality/c6103.md | 2 ++ docs/code-quality/c6200.md | 4 ++-- docs/code-quality/c6201.md | 4 ++-- docs/code-quality/c6211.md | 4 ++-- docs/code-quality/c6214.md | 4 ++-- docs/code-quality/c6215.md | 4 ++-- docs/code-quality/c6216.md | 4 ++-- docs/code-quality/c6220.md | 4 ++-- docs/code-quality/c6221.md | 4 ++-- docs/code-quality/c6225.md | 4 ++-- docs/code-quality/c6226.md | 4 ++-- docs/code-quality/c6235.md | 4 ++-- docs/code-quality/c6236.md | 4 ++-- docs/code-quality/c6237.md | 4 ++-- docs/code-quality/c6239.md | 4 ++-- docs/code-quality/c6240.md | 4 ++-- docs/code-quality/c6242.md | 4 ++-- docs/code-quality/c6250.md | 4 ++-- 27 files changed, 50 insertions(+), 46 deletions(-) diff --git a/docs/code-quality/c6011.md b/docs/code-quality/c6011.md index 2094f73796a..7b5dd898802 100644 --- a/docs/code-quality/c6011.md +++ b/docs/code-quality/c6011.md @@ -16,7 +16,7 @@ This warning indicates that your code dereferences a potentially null pointer. I Code analysis name: `DEREF_NULL_PTR` -## Example +## Examples The following code generates this warning because a call to `malloc` might return null if insufficient memory is available: diff --git a/docs/code-quality/c6014.md b/docs/code-quality/c6014.md index 9806124fb84..f954a159de5 100644 --- a/docs/code-quality/c6014.md +++ b/docs/code-quality/c6014.md @@ -10,10 +10,10 @@ ms.assetid: ef76ec88-74d2-4a3b-b6fe-4b0851ab3372 > Leaking memory '*pointer-name*'. -This warning indicates that the specified pointer points to allocated memory or some other allocated resource that hasn't been freed. - ## Remarks +This warning indicates that the specified pointer points to allocated memory or some other allocated resource that hasn't been freed. + The analyzer checks for this condition only when the `_Analysis_mode_(_Analysis_local_leak_checks_)` SAL annotation is specified. By default, this annotation is specified for Windows kernel mode (driver) code. For more information about SAL annotations, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). This warning is reported for both memory and resource leaks when the resource is commonly *aliased* to another location. Memory is aliased when a pointer to the memory escapes the function by using an `_Out_` parameter annotation, global variable, or return value. This warning can be reported on function exit if the argument is annotated that its release is expected. diff --git a/docs/code-quality/c6029.md b/docs/code-quality/c6029.md index 729f39ab08c..7fa2fb56c07 100644 --- a/docs/code-quality/c6029.md +++ b/docs/code-quality/c6029.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6029"] > Possible buffer overrun in call to '*function*' -Possible buffer overrun in called function due to an unchecked buffer length/size parameter. - ## Remarks +Possible buffer overrun in called function due to an unchecked buffer length/size parameter. + This warning indicates that code passes an unchecked size to a function that takes a buffer and a size. The code doesn't verify that the data read from some external source is smaller than the buffer size. An attacker might intentionally specify a larger than expected value for the size, which can lead to a buffer overrun. Generally, whenever you read data from an untrusted external source, make sure to verify it for validity. It's appropriate to verify the size to make sure it's in the expected range. Code analysis name: `USING_TAINTED_DATA` diff --git a/docs/code-quality/c6031.md b/docs/code-quality/c6031.md index 541fca4ba56..7431e743474 100644 --- a/docs/code-quality/c6031.md +++ b/docs/code-quality/c6031.md @@ -19,7 +19,7 @@ This warning applies to both C and C++ code. Code analysis name: `RETVAL_IGNORED_FUNC_COULD_FAIL` -## Example +## Examples The following code generates warning C6031: diff --git a/docs/code-quality/c6053.md b/docs/code-quality/c6053.md index 426980c7878..d8511f645c3 100644 --- a/docs/code-quality/c6053.md +++ b/docs/code-quality/c6053.md @@ -18,7 +18,7 @@ Most C standard library and Win32 string handling functions require and produce Code analysis name: `MISSING_ZERO_TERMINATION1` -## Examples +## Example The following sample code generates this warning: diff --git a/docs/code-quality/c6064.md b/docs/code-quality/c6064.md index 645f77ff241..57de5c63e64 100644 --- a/docs/code-quality/c6064.md +++ b/docs/code-quality/c6064.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6064"] > Missing integer argument to '*function-name*' corresponding to conversion specifier '*number*' -This warning indicates that the code doesn't provide enough arguments to match a format string and one of the missing arguments is an integer. - ## Remarks +This warning indicates that the code doesn't provide enough arguments to match a format string and one of the missing arguments is an integer. + This defect is likely to cause incorrect output and, in more dangerous cases, can lead to stack overflow. Code analysis name: `MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION` diff --git a/docs/code-quality/c6067.md b/docs/code-quality/c6067.md index 0a181ff13ab..31e868af661 100644 --- a/docs/code-quality/c6067.md +++ b/docs/code-quality/c6067.md @@ -17,7 +17,7 @@ This defect is likely to cause a crash or corruption of some form. Code analysis name: `NON_STRING_ARGUMENT_TO_FORMAT_FUNCTION` -## Example +## Examples The following code generates this warning because an integer is passed instead of a string: diff --git a/docs/code-quality/c6101.md b/docs/code-quality/c6101.md index ee653b08a8f..0c0f39907df 100644 --- a/docs/code-quality/c6101.md +++ b/docs/code-quality/c6101.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6101"] > Returning uninitialized memory '*parameter-name*'. -A successful path through the function doesn't set the `_Out_` annotated parameter. - ## Remarks +A successful path through the function doesn't set the `_Out_` annotated parameter. + The purpose of this warning is to avoid the use of uninitialized values by callers of the function. The analyzer assumes callers don't initialize any parameters annotated with `_Out_` before the function call, and checks that the function initializes them. The analyzer doesn't emit this warning if the function returns a value that indicates it had an error or wasn't successful. To fix this issue, make sure to initialize the `_Out_` parameter under all successful return paths. The error message contains the line numbers of an example path that doesn't initialize the parameter. If the initialization behavior is by design, then incorrect or missing SAL annotations are a likely cause for the warning. You can typically resolve these cases in one of two ways: Either change `_Out_` to a more appropriate annotation, or use the `_Success_()` annotation to help define the success/error states of the function. It's important for the static analysis tools to have correct annotations on the function when analyzing the call sites of the function. diff --git a/docs/code-quality/c6102.md b/docs/code-quality/c6102.md index 9c35f2bc5a7..1f38ea8f591 100644 --- a/docs/code-quality/c6102.md +++ b/docs/code-quality/c6102.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C6102"] > Using '*variable*' from failed function call at line '*location*'. +## Remarks + This warning is reported instead of [C6001](../code-quality/c6001.md) when a variable isn't set because it was marked as an `_Out_` parameter on a prior function call that failed. The problem might be that the prior called function isn't fully annotated. It may require `_Always_`, `_Outptr_result_nullonfailure_` (`_COM_Outptr_` for COM code), or a related annotation. diff --git a/docs/code-quality/c6103.md b/docs/code-quality/c6103.md index 6c9dfdcfcd8..d371d3f178f 100644 --- a/docs/code-quality/c6103.md +++ b/docs/code-quality/c6103.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C6103"] > Returning '*variable*' from failed function call at line '*location*'. +## Remarks + A successful path through the function is returning a variable that was used as an `_Out_` parameter to an internal function call that failed. The problem might be that the called function and the calling function aren't fully annotated. The called function may require `_Always_`, `_Outptr_result_nullonfailure_` (`_COM_Outptr_` for COM code), or a related annotation, and the calling function may require a `_Success_` annotation. Another possible cause for this warning is that the `_Success_` annotation on the called function is incorrect. diff --git a/docs/code-quality/c6200.md b/docs/code-quality/c6200.md index 2106582d1af..d4e40ffe109 100644 --- a/docs/code-quality/c6200.md +++ b/docs/code-quality/c6200.md @@ -10,10 +10,10 @@ ms.assetid: bbeb159b-4e97-4317-9a07-bb83cd03069a > Index '*index*' is out of valid index range '*min*' to '*max*' for nonstack buffer '*parameter-name*' -This warning indicates that an integer offset into the specified nonstack array exceeds the maximum bounds of that array, causing undefined behavior and potentially crashes. - ## Remarks +This warning indicates that an integer offset into the specified nonstack array exceeds the maximum bounds of that array, causing undefined behavior and potentially crashes. + One common cause of this defect is using the size of an array as an index into the array. Because C/C++ array indexing is zero-based, the maximum legal index into an array is one less than the number of array elements. Code analysis name: `INDEX_EXCEEDS_MAX_NONSTACK` diff --git a/docs/code-quality/c6201.md b/docs/code-quality/c6201.md index 85118a0503d..ea7ccab82ac 100644 --- a/docs/code-quality/c6201.md +++ b/docs/code-quality/c6201.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6201"] > Index '*index-name*' is out of valid index range '*minimum*' to '*maximum*' for possibly stack allocated buffer '*variable*' -This warning indicates that an integer offset into the specified stack array exceeds the maximum bounds of that array. It might potentially cause stack overflow errors, undefined behavior, or crashes. - ## Remarks +This warning indicates that an integer offset into the specified stack array exceeds the maximum bounds of that array. It might potentially cause stack overflow errors, undefined behavior, or crashes. + One common cause of this defect is using an array's size as an index into the array. Because C/C++ array indexing is zero-based, the maximum legal index into an array is one less than the number of array elements. Code analysis name: `INDEX_EXCEEDS_MAX` diff --git a/docs/code-quality/c6211.md b/docs/code-quality/c6211.md index 10fe4fad3bb..42bc52405aa 100644 --- a/docs/code-quality/c6211.md +++ b/docs/code-quality/c6211.md @@ -10,10 +10,10 @@ ms.assetid: 9b68243b-534c-4a05-b789-bb155dfcba1e > Leaking memory '*pointer*' due to an exception. Consider using a local catch block to clean up memory -This warning indicates that allocated memory isn't freed when an exception is thrown. The statement at the end of the path could throw an exception. - ## Remarks +This warning indicates that allocated memory isn't freed when an exception is thrown. The statement at the end of the path could throw an exception. + The analyzer checks for this condition only when the `_Analysis_mode_(_Analysis_local_leak_checks_)` SAL annotation is specified. By default, this annotation is specified for Windows kernel mode (driver) code. For more information about SAL annotations, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). Code analysis name: `MEMORY_LEAK_EXCEPTION` diff --git a/docs/code-quality/c6214.md b/docs/code-quality/c6214.md index 81284cb8b74..a7b35974469 100644 --- a/docs/code-quality/c6214.md +++ b/docs/code-quality/c6214.md @@ -10,10 +10,10 @@ ms.assetid: 233e2395-61c1-4a3b-a54b-f19a9ffc31a8 > Cast between semantically different integer types: HRESULT to a Boolean type -This warning indicates that an `HRESULT` is being cast to a Boolean type. The success value (`S_OK`) of an `HRESULT` equals 0. However, 0 indicates failure for a Boolean type. Casting an `HRESULT` to a Boolean type and then using it in a test expression will yield an incorrect result. - ## Remarks +This warning indicates that an `HRESULT` is being cast to a Boolean type. The success value (`S_OK`) of an `HRESULT` equals 0. However, 0 indicates failure for a Boolean type. Casting an `HRESULT` to a Boolean type and then using it in a test expression will yield an incorrect result. + Sometimes, this warning occurs if an `HRESULT` is being stored in a Boolean variable. Any comparison that uses the Boolean variable to test for `HRESULT` success or failure could lead to incorrect results. Code analysis name: `CAST_HRESULT_TO_BOOL` diff --git a/docs/code-quality/c6215.md b/docs/code-quality/c6215.md index 9e58ca0e1fa..391c1d0d90e 100644 --- a/docs/code-quality/c6215.md +++ b/docs/code-quality/c6215.md @@ -10,10 +10,10 @@ ms.assetid: f20cc258-9c0f-4eaa-828d-74f76580ca78 > Cast between semantically different integer types: a Boolean type to HRESULT -This warning indicates that a Boolean is being cast to an `HRESULT`. Boolean types indicate success by a non-zero value, whereas success (`S_OK`) in `HRESULT` is indicated by a value of 0. Casting a Boolean type to an `HRESULT` and then using it in a test expression will yield an incorrect result. - ## Remarks +This warning indicates that a Boolean is being cast to an `HRESULT`. Boolean types indicate success by a non-zero value, whereas success (`S_OK`) in `HRESULT` is indicated by a value of 0. Casting a Boolean type to an `HRESULT` and then using it in a test expression will yield an incorrect result. + This warning frequently occurs when a Boolean is used as an argument to `SUCCEEDED` or `FAILED` macro, which explicitly casts their arguments to an `HRESULT`. Code analysis name: `CAST_BOOL_TO_HRESULT` diff --git a/docs/code-quality/c6216.md b/docs/code-quality/c6216.md index 4f7cb22742b..10102a8948c 100644 --- a/docs/code-quality/c6216.md +++ b/docs/code-quality/c6216.md @@ -10,10 +10,10 @@ ms.assetid: d5c4dcf9-bfd7-4604-804f-9cc41b08d060 > Compiler-inserted cast between semantically different integral types: a Boolean type to HRESULT -A Boolean type is being used as an `HRESULT` without being explicitly cast. - ## Remarks +A Boolean type is being used as an `HRESULT` without being explicitly cast. + Boolean types indicate success by a non-zero value; success (`S_OK`) in `HRESULT` is indicated by a value of 0. A Boolean `false` value used as an `HRESULT` would indicate `S_OK`, which is frequently a mistake. Code analysis name: `COMPILER_INSERTED_CAST_BOOL_TO_HRESULT` diff --git a/docs/code-quality/c6220.md b/docs/code-quality/c6220.md index aa09af7c416..1d8a9fb470d 100644 --- a/docs/code-quality/c6220.md +++ b/docs/code-quality/c6220.md @@ -10,10 +10,10 @@ ms.assetid: a13524f4-0a1f-4670-b830-70b06e4d39d2 > Implicit cast between semantically different integer types: comparing HRESULT to -1. Consider using `SUCCEEDED` or `FAILED` macro instead -This warning indicates that an `HRESULT` is being compared with an explicit, non-`HRESULT` value of -1, which isn't a well-formed `HRESULT`. - ## Remarks +This warning indicates that an `HRESULT` is being compared with an explicit, non-`HRESULT` value of -1, which isn't a well-formed `HRESULT`. + A failure in `HRESULT` (`E_FAIL`) isn't represented by a -1. Therefore, an implicit cast of an `HRESULT` to an integer will generate an incorrect value and is likely to lead to the wrong result. Code analysis name: `COMPARING_HRESULT_TO_MINUS_ONE` diff --git a/docs/code-quality/c6221.md b/docs/code-quality/c6221.md index 4a6dc472a44..bc42f233547 100644 --- a/docs/code-quality/c6221.md +++ b/docs/code-quality/c6221.md @@ -10,10 +10,10 @@ ms.assetid: b07989b7-f50f-46e0-8ed8-d9269b3d3580 > Implicit cast between semantically different integer types: comparing HRESULT to an integer. Consider using `SUCCEEDED` or `FAILED` macros instead -This warning indicates that an `HRESULT` is being compared to an integer other than zero. - ## Remarks +This warning indicates that an `HRESULT` is being compared to an integer other than zero. + A success in an `HRESULT` (`S_OK`) is represented by a 0. Therefore, an implicit cast of an `HRESULT` to an integer generates an incorrect value and is likely to lead to the wrong result. The error is often caused by mistakenly expecting a function to return an integer when it actually returns an `HRESULT`. Code analysis name: `COMPARING_HRESULT_TO_INT` diff --git a/docs/code-quality/c6225.md b/docs/code-quality/c6225.md index 67997f7decd..db351285ad8 100644 --- a/docs/code-quality/c6225.md +++ b/docs/code-quality/c6225.md @@ -10,10 +10,10 @@ ms.assetid: 2d98ffec-9842-4cd1-b1a9-9ac9d1d2a136 > Implicit cast between semantically different integer types: assigning 1 or `TRUE` to `HRESULT`. Consider using `S_FALSE` instead -This warning indicates that an `HRESULT` is being assigned or initialized with a value of an explicit 1. Boolean types indicate success by a non-zero value; success (`S_OK`) in `HRESULT` is indicated by a value of 0. - ## Remarks +This warning indicates that an `HRESULT` is being assigned or initialized with a value of an explicit 1. Boolean types indicate success by a non-zero value; success (`S_OK`) in `HRESULT` is indicated by a value of 0. + This warning is frequently caused by accidental confusion of Boolean and `HRESULT` types. To indicate success, the symbolic constant `S_OK` should be used. Code analysis name: `ASSIGNING_ONE_TO_HRESULT` diff --git a/docs/code-quality/c6226.md b/docs/code-quality/c6226.md index 2a7ed4d40a3..19e7ac5e7ab 100644 --- a/docs/code-quality/c6226.md +++ b/docs/code-quality/c6226.md @@ -10,10 +10,10 @@ ms.assetid: c18aa576-b316-4f11-b48f-f5183fa49c7c > Implicit cast between semantically different integer types: assigning -1 to HRESULT. Consider using E_FAIL instead. -This warning indicates that an `HRESULT` is assigned or initialized to an explicit value of -1. - ## Remarks +This warning indicates that an `HRESULT` is assigned or initialized to an explicit value of -1. + This warning is frequently caused by accidental confusion of integer and `HRESULT` types. To indicate success, use the symbolic constant `S_OK` instead. To indicate failure, use the symbolic constants that start with E_*constant*, such as `E_FAIL`. For more information, see the [`SUCCEEDED`](/windows/desktop/api/winerror/nf-winerror-succeeded) and [`FAILED`](/windows/desktop/api/winerror/nf-winerror-failed) macros. diff --git a/docs/code-quality/c6235.md b/docs/code-quality/c6235.md index 3259ac77f37..2a4ae4498e0 100644 --- a/docs/code-quality/c6235.md +++ b/docs/code-quality/c6235.md @@ -10,10 +10,10 @@ ms.assetid: e225955e-0bb5-43a4-a83d-83290e209df4 > ('*non-zero constant*' \|\| '*expression*') is always a non-zero constant -This warning indicates that a non-zero constant value, other than one, was detected on the left side of a logical-or operation that occurs in a test context. The right side of the logical-or operation isn't evaluated because the resulting expression always evaluates to true. This language feature is referred to as "short-circuit evaluation." - ## Remarks +This warning indicates that a non-zero constant value, other than one, was detected on the left side of a logical-or operation that occurs in a test context. The right side of the logical-or operation isn't evaluated because the resulting expression always evaluates to true. This language feature is referred to as "short-circuit evaluation." + A non-zero constant value, other than one, suggests that the bitwise-AND operator (`&`) may have been intended. This warning isn't generated for the common idiom when the non-zero constant is 1, because of its use for selectively enabling code paths. However, it's generated if the non-zero constant evaluates to 1, for example `1+0`. Code analysis name: `NONZEROLOGICALOR` diff --git a/docs/code-quality/c6236.md b/docs/code-quality/c6236.md index b75a4c19048..55d7ceea6c5 100644 --- a/docs/code-quality/c6236.md +++ b/docs/code-quality/c6236.md @@ -10,10 +10,10 @@ ms.assetid: 3d5ae268-6f40-4c45-a483-b5b0e6a808fc > ('*expression*' \|\| '*non-zero constant*') is always a non-zero constant -This warning indicates that a non-zero constant value, other than one, was detected on the right side of a logical OR operation that occurs in a test context. Logically, it implies that the test is redundant and can be removed safely. Alternatively, it suggests that the programmer may have intended to use a different operator, for example, the equality (`==`), bitwise-AND (`&`) or bitwise-XOR (`^`) operator, to test for a specific value or flag. - ## Remarks +This warning indicates that a non-zero constant value, other than one, was detected on the right side of a logical OR operation that occurs in a test context. Logically, it implies that the test is redundant and can be removed safely. Alternatively, it suggests that the programmer may have intended to use a different operator, for example, the equality (`==`), bitwise-AND (`&`) or bitwise-XOR (`^`) operator, to test for a specific value or flag. + This warning isn't generated for the common idiom when the non-zero constant is 1, because of its use for selectively enabling code paths at compile time. However, the warning is generated if the non-zero constant is formed by an expression that evaluates to 1, for example, 1 + 0. Code analysis name: `LOGICALORNONZERO` diff --git a/docs/code-quality/c6237.md b/docs/code-quality/c6237.md index e80bb7c8e2c..0f296fb97ea 100644 --- a/docs/code-quality/c6237.md +++ b/docs/code-quality/c6237.md @@ -10,10 +10,10 @@ ms.assetid: a18d8630-e4d6-4132-b976-c1f3e7c5c3f0 > ('*zero*' && '*expression*') is always zero. '*expression*' is never evaluated and may have side effects -This warning indicates that a constant value of zero was detected on the left side of a logical-and operation that occurs in a test context. The resulting expression always evaluates to false. Therefore, the right side of the logical-AND operation isn't evaluated. This language feature is referred to as "short-circuit evaluation." - ## Remarks +This warning indicates that a constant value of zero was detected on the left side of a logical-and operation that occurs in a test context. The resulting expression always evaluates to false. Therefore, the right side of the logical-AND operation isn't evaluated. This language feature is referred to as "short-circuit evaluation." + You should examine the right side of the expression carefully: Ensure that any side effects such as assignment, function call, increment, and decrement operations needed for proper functionality aren't affected by the short-circuit evaluation. The expression (`0 && n`) produces no side effects and is commonly used to selectively choose code paths. diff --git a/docs/code-quality/c6239.md b/docs/code-quality/c6239.md index de5189b9b33..8c4ac68cc57 100644 --- a/docs/code-quality/c6239.md +++ b/docs/code-quality/c6239.md @@ -10,10 +10,10 @@ ms.assetid: c80e02bc-ff54-4fde-8c1c-5852853bed24 > ('*non-zero constant*' && '*expression*') always evaluates to the result of '*expression*'. Did you intend to use the bitwise-and operator? -This warning indicates that a non-zero constant value, other than one, was detected on the left side of a logical-AND operation that occurs in a test context. For example, the expression `( 2 && n )` is reduced to `(!!n)`, which is the Boolean value of `n`. - ## Remarks +This warning indicates that a non-zero constant value, other than one, was detected on the left side of a logical-AND operation that occurs in a test context. For example, the expression `( 2 && n )` is reduced to `(!!n)`, which is the Boolean value of `n`. + This warning typically indicates an attempt to check a bit mask in which the bitwise-AND (`&`) operator should be used, and isn't generated if the non-zero constant evaluates to 1 because of its use for selectively choosing code paths. Code analysis name: `NONZEROLOGICALAND` diff --git a/docs/code-quality/c6240.md b/docs/code-quality/c6240.md index 1e44d46db25..4732da3260b 100644 --- a/docs/code-quality/c6240.md +++ b/docs/code-quality/c6240.md @@ -10,10 +10,10 @@ ms.assetid: b9412ae4-622d-4aed-8c34-b67db1ccd48a > ('*expression*' && '*non-zero constant*') always evaluates to the result of '*expression*'. Did you intend to use the bitwise-and operator? -This warning indicates that a non-zero constant value, other than one, was detected on the right side of a logical-and operation that occurs in a test context. For example, the expression `(n && 3)` reduces to `(!!n)`, which is the Boolean value of `n`. - ## Remarks +This warning indicates that a non-zero constant value, other than one, was detected on the right side of a logical-and operation that occurs in a test context. For example, the expression `(n && 3)` reduces to `(!!n)`, which is the Boolean value of `n`. + This warning typically indicates an attempt to check a bit mask in which the bitwise-AND (`&`) operator should be used. It isn't generated if the non-zero constant evaluates to 1 because of its use for selectively choosing code paths. Code analysis name: `LOGICALANDNONZERO` diff --git a/docs/code-quality/c6242.md b/docs/code-quality/c6242.md index cdb9a7534ca..b5a47d7d4c3 100644 --- a/docs/code-quality/c6242.md +++ b/docs/code-quality/c6242.md @@ -10,10 +10,10 @@ ms.assetid: 523d46ce-8370-434c-a752-2e3a18cca9a5 > A jump out of this try-block forces local unwind. Incurs severe performance penalty -This warning indicates that a jump statement causes control-flow to leave the protected block of a `try-finally` other than by fall-through. - ## Remarks +This warning indicates that a jump statement causes control-flow to leave the protected block of a `try-finally` other than by fall-through. + Leaving the protected block of a `try-finally` other than by falling through from the last statement requires local unwind to occur. Local unwind typically requires approximately 1000 machine instructions, so it's detrimental to performance. Use **`__leave`** to exit the protected block of a try-finally. diff --git a/docs/code-quality/c6250.md b/docs/code-quality/c6250.md index c57c22512c1..629d78c9498 100644 --- a/docs/code-quality/c6250.md +++ b/docs/code-quality/c6250.md @@ -10,10 +10,10 @@ ms.assetid: 6949c9c5-e8bd-4f95-bc80-42073a293357 > Calling 'VirtualFree' without the MEM_RELEASE flag may free memory but not address descriptors (VADs); results in address space leaks -This warning indicates that a call to `VirtualFree` without the `MEM_RELEASE` flag only decommits the pages, and doesn't release them. To both decommit and release pages, use the `MEM_RELEASE` flag in the call to `VirtualFree`. If any pages in the region are committed, the function first decommits and then releases them. After this operation, the pages are in the free state. If you specify this flag, `dwSize` must be zero, and `lpAddress` must point to the base address returned by the `VirtualAlloc` function when the region was reserved. The function fails if either of these conditions isn't met. - ## Remarks +This warning indicates that a call to `VirtualFree` without the `MEM_RELEASE` flag only decommits the pages, and doesn't release them. To both decommit and release pages, use the `MEM_RELEASE` flag in the call to `VirtualFree`. If any pages in the region are committed, the function first decommits and then releases them. After this operation, the pages are in the free state. If you specify this flag, `dwSize` must be zero, and `lpAddress` must point to the base address returned by the `VirtualAlloc` function when the region was reserved. The function fails if either of these conditions isn't met. + You can ignore this warning if your code later frees the address space by calling `VirtualFree` with the `MEM_RELEASE` flag. For more information, see [`VirtualAlloc`](/windows/win32/api/memoryapi/nf-memoryapi-virtualalloc) and [`VirtualFree`](/windows/win32/api/memoryapi/nf-memoryapi-virtualfree). From f50aad3ac7ebeed038841d589a5944ade6833147 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 5 Sep 2025 23:14:31 +0800 Subject: [PATCH 1095/1799] Replace term "sample" with "example" for warning references in range [C6000, C6250] --- docs/code-quality/c6053.md | 6 +++--- docs/code-quality/c6054.md | 2 +- docs/code-quality/c6220.md | 2 +- docs/code-quality/c6237.md | 2 +- docs/code-quality/c6244.md | 2 +- docs/code-quality/c6250.md | 4 ++-- 6 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/code-quality/c6053.md b/docs/code-quality/c6053.md index d8511f645c3..32d1aa049c7 100644 --- a/docs/code-quality/c6053.md +++ b/docs/code-quality/c6053.md @@ -20,7 +20,7 @@ Code analysis name: `MISSING_ZERO_TERMINATION1` ## Example -The following sample code generates this warning: +The following example code generates this warning: ```cpp #include @@ -36,7 +36,7 @@ size_t f( ) } ``` -To correct this warning, zero-terminate the string as shown in the following sample code: +To correct this warning, zero-terminate the string as shown in the following example code: ```cpp #include @@ -53,7 +53,7 @@ size_t f( ) } ``` -The following sample code corrects this warning using safe string manipulation `strncpy_s` function: +The following example code corrects this warning using safe string manipulation `strncpy_s` function: ```cpp #include diff --git a/docs/code-quality/c6054.md b/docs/code-quality/c6054.md index 511c7f6bfae..7adc5cdcf15 100644 --- a/docs/code-quality/c6054.md +++ b/docs/code-quality/c6054.md @@ -34,7 +34,7 @@ void g ( ) } ``` -To correct this warning, null-terminate `wcArray` before calling function `func()` as shown in the following sample code: +To correct this warning, null-terminate `wcArray` before calling function `func()` as shown in the following example code: ```cpp // C6054_good.cpp diff --git a/docs/code-quality/c6220.md b/docs/code-quality/c6220.md index 1d8a9fb470d..d28f2aa7218 100644 --- a/docs/code-quality/c6220.md +++ b/docs/code-quality/c6220.md @@ -20,7 +20,7 @@ Code analysis name: `COMPARING_HRESULT_TO_MINUS_ONE` ## Example -In most cases, warning C6220 is caused by code that mistakenly expects a function to return an integer, and to use -1 as a failure value, but instead the function returns an `HRESULT`. The following code sample generates this warning: +In most cases, warning C6220 is caused by code that mistakenly expects a function to return an integer, and to use -1 as a failure value, but instead the function returns an `HRESULT`. The following code example generates this warning: ```cpp #include diff --git a/docs/code-quality/c6237.md b/docs/code-quality/c6237.md index 0f296fb97ea..1b2f9b8858a 100644 --- a/docs/code-quality/c6237.md +++ b/docs/code-quality/c6237.md @@ -22,7 +22,7 @@ Code analysis name: `ZEROLOGICALANDLOSINGSIDEEFFECTS` ## Example -The following code shows various code samples that generate this warning: +The following code shows various code examples that generate this warning: ```cpp #include diff --git a/docs/code-quality/c6244.md b/docs/code-quality/c6244.md index b37d7c116d0..49fa103905a 100644 --- a/docs/code-quality/c6244.md +++ b/docs/code-quality/c6244.md @@ -42,7 +42,7 @@ void test() #pragma warning(pop) ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp #include diff --git a/docs/code-quality/c6250.md b/docs/code-quality/c6250.md index 629d78c9498..1d47aafd12a 100644 --- a/docs/code-quality/c6250.md +++ b/docs/code-quality/c6250.md @@ -24,7 +24,7 @@ Code analysis name: `WIN32UNRELEASEDVADS` ## Example -The following sample code generates warning C6250: +The following example code generates warning C6250: ```cpp #include @@ -70,7 +70,7 @@ VOID f( ) } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp #include From 777885975bc21bc689328a93629c6c68ceb297e8 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 5 Sep 2025 23:20:04 +0800 Subject: [PATCH 1096/1799] Update metadata for warning references in range [C6000, C6250] --- docs/code-quality/c6001.md | 2 +- docs/code-quality/c6011.md | 3 +-- docs/code-quality/c6014.md | 3 +-- docs/code-quality/c6029.md | 2 +- docs/code-quality/c6030.md | 2 +- docs/code-quality/c6031.md | 2 +- docs/code-quality/c6053.md | 3 +-- docs/code-quality/c6054.md | 3 +-- docs/code-quality/c6059.md | 3 +-- docs/code-quality/c6063.md | 2 +- docs/code-quality/c6064.md | 2 +- docs/code-quality/c6065.md | 2 +- docs/code-quality/c6066.md | 2 +- docs/code-quality/c6067.md | 2 +- docs/code-quality/c6101.md | 2 +- docs/code-quality/c6102.md | 2 +- docs/code-quality/c6103.md | 2 +- docs/code-quality/c6200.md | 3 +-- docs/code-quality/c6201.md | 2 +- docs/code-quality/c6211.md | 3 +-- docs/code-quality/c6214.md | 3 +-- docs/code-quality/c6215.md | 3 +-- docs/code-quality/c6216.md | 3 +-- docs/code-quality/c6217.md | 2 +- docs/code-quality/c6219.md | 3 +-- docs/code-quality/c6220.md | 3 +-- docs/code-quality/c6221.md | 3 +-- docs/code-quality/c6225.md | 3 +-- docs/code-quality/c6226.md | 3 +-- docs/code-quality/c6230.md | 3 +-- docs/code-quality/c6235.md | 3 +-- docs/code-quality/c6236.md | 3 +-- docs/code-quality/c6237.md | 3 +-- docs/code-quality/c6239.md | 3 +-- docs/code-quality/c6240.md | 3 +-- docs/code-quality/c6242.md | 3 +-- docs/code-quality/c6244.md | 3 +-- docs/code-quality/c6246.md | 3 +-- docs/code-quality/c6248.md | 3 +-- docs/code-quality/c6250.md | 3 +-- 40 files changed, 40 insertions(+), 66 deletions(-) diff --git a/docs/code-quality/c6001.md b/docs/code-quality/c6001.md index 755bb88cb32..8d57dd9cc84 100644 --- a/docs/code-quality/c6001.md +++ b/docs/code-quality/c6001.md @@ -1,6 +1,6 @@ --- +title: "Warning C6001" description: "Learn more about: Warning C6001" -title: Warning C6001 ms.date: 10/04/2022 f1_keywords: ["C6001", "USING_UNINIT_VAR", "__WARNING_USING_UNINIT_VAR"] helpviewer_keywords: ["C6001"] diff --git a/docs/code-quality/c6011.md b/docs/code-quality/c6011.md index 7b5dd898802..2255b15e363 100644 --- a/docs/code-quality/c6011.md +++ b/docs/code-quality/c6011.md @@ -1,10 +1,9 @@ --- -title: Warning C6011 +title: "Warning C6011" description: "Reference for Visual Studio C++ code analysis warning C6011." ms.date: 10/04/2022 f1_keywords: ["C6011", "DEREF_NULL_PTR", "__WARNING_DEREF_NULL_PTR"] helpviewer_keywords: ["C6011"] -ms.assetid: 54b7bc2b-b8f5-43fc-a9a3-8189b03f249a --- # Warning C6011 diff --git a/docs/code-quality/c6014.md b/docs/code-quality/c6014.md index f954a159de5..6065a8b16c3 100644 --- a/docs/code-quality/c6014.md +++ b/docs/code-quality/c6014.md @@ -1,10 +1,9 @@ --- +title: "Warning C6014" description: "Learn more about: Warning C6014" -title: Warning C6014 ms.date: 10/03/2022 f1_keywords: ["C6014", "MEMORY_LEAK", "__WARNING_MEMORY_LEAK"] helpviewer_keywords: ["C6014"] -ms.assetid: ef76ec88-74d2-4a3b-b6fe-4b0851ab3372 --- # Warning C6014 diff --git a/docs/code-quality/c6029.md b/docs/code-quality/c6029.md index 7fa2fb56c07..2fd6c711b0a 100644 --- a/docs/code-quality/c6029.md +++ b/docs/code-quality/c6029.md @@ -1,5 +1,5 @@ --- -title: Warning C6029 +title: "Warning C6029" description: "Learn more about: Warning C6029" ms.date: 2/07/2023 f1_keywords: ["C6029", "USING_TAINTED_DATA", "__WARNING_USING_TAINTED_DATA"] diff --git a/docs/code-quality/c6030.md b/docs/code-quality/c6030.md index d839858cfaf..ab0f26a88e8 100644 --- a/docs/code-quality/c6030.md +++ b/docs/code-quality/c6030.md @@ -1,5 +1,5 @@ --- -title: Warning C6030 +title: "Warning C6030" description: "Describes C++ Code Analysis warning C6030 and how to resolve it." ms.date: 03/10/2023 f1_keywords: ["C6030", "USE_ATTRIBUTE_NORETURN", "__WARNING_USE_ATTRIBUTE_NORETURN"] diff --git a/docs/code-quality/c6031.md b/docs/code-quality/c6031.md index 7431e743474..f134bddcc00 100644 --- a/docs/code-quality/c6031.md +++ b/docs/code-quality/c6031.md @@ -1,5 +1,5 @@ --- -title: Warning C6031 +title: "Warning C6031" description: "Describes C++ Code Analysis warning C6031 and how to resolve it." ms.date: 4/5/2024 f1_keywords: ["C6031", "RETVAL_IGNORED_FUNC_COULD_FAIL", "__WARNING_RETVAL_IGNORED_FUNC_COULD_FAIL"] diff --git a/docs/code-quality/c6053.md b/docs/code-quality/c6053.md index 32d1aa049c7..80c15b91dd2 100644 --- a/docs/code-quality/c6053.md +++ b/docs/code-quality/c6053.md @@ -1,10 +1,9 @@ --- +title: "Warning C6053" description: "Learn more about: Warning C6053" -title: Warning C6053 ms.date: 10/04/2022 f1_keywords: ["C6053", "MISSING_ZERO_TERMINATION1", "__WARNING_MISSING_ZERO_TERMINATION1"] helpviewer_keywords: ["C6053"] -ms.assetid: 8e25566a-e3b9-470a-820d-64221a877c53 --- # Warning C6053 diff --git a/docs/code-quality/c6054.md b/docs/code-quality/c6054.md index 7adc5cdcf15..32962f45ea6 100644 --- a/docs/code-quality/c6054.md +++ b/docs/code-quality/c6054.md @@ -1,10 +1,9 @@ --- -title: Warning C6054 +title: "Warning C6054" description: "Reference guide to Microsoft C++ code analysis warning C6054." ms.date: 10/04/2022 f1_keywords: ["C6054", "MISSING_ZERO_TERMINATION2", "__WARNING_MISSING_ZERO_TERMINATION2"] helpviewer_keywords: ["C6054"] -ms.assetid: d573a5c1-7e74-402b-92e6-8085f967aa50 --- # Warning C6054 diff --git a/docs/code-quality/c6059.md b/docs/code-quality/c6059.md index d78c0f3f74b..2678b0fd252 100644 --- a/docs/code-quality/c6059.md +++ b/docs/code-quality/c6059.md @@ -1,10 +1,9 @@ --- +title: "Warning C6059" description: "Learn more about: Warning C6059" -title: Warning C6059 ms.date: 12/14/2023 f1_keywords: ["C6059", "BAD_CONCATENATION", "__WARNING_BAD_CONCATENATION"] helpviewer_keywords: ["C6059"] -ms.assetid: 343a4cd1-048a-4edf-bb4b-187097bb6093 --- # Warning C6059 diff --git a/docs/code-quality/c6063.md b/docs/code-quality/c6063.md index e84940d4b23..23882eb5492 100644 --- a/docs/code-quality/c6063.md +++ b/docs/code-quality/c6063.md @@ -1,6 +1,6 @@ --- +title: "Warning C6063" description: "Learn more about: Warning C6063" -title: Warning C6063 ms.date: 2/22/2023 f1_keywords: ["C6063", "MISSING_STRING_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_MISSING_STRING_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6063"] diff --git a/docs/code-quality/c6064.md b/docs/code-quality/c6064.md index 57de5c63e64..12cf98e9efe 100644 --- a/docs/code-quality/c6064.md +++ b/docs/code-quality/c6064.md @@ -1,6 +1,6 @@ --- +title: "Warning C6064" description: "Learn more about: Warning C6064" -title: Warning C6064 ms.date: 2/07/2023 f1_keywords: ["C6064", "MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6064"] diff --git a/docs/code-quality/c6065.md b/docs/code-quality/c6065.md index 20ea8e81454..915ba25f3e1 100644 --- a/docs/code-quality/c6065.md +++ b/docs/code-quality/c6065.md @@ -1,6 +1,6 @@ --- +title: "Warning C6065" description: "Learn more about: Warning C6065" -title: Warning C6065 ms.date: 2/22/2023 f1_keywords: ["C6065", "MISSING_COUNTED_STRING_ARGUMENT_TO_FORMAT_FUNCTION", "__MISSING_COUNTED_STRING_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6065"] diff --git a/docs/code-quality/c6066.md b/docs/code-quality/c6066.md index 8ae5f799022..8bdd672541d 100644 --- a/docs/code-quality/c6066.md +++ b/docs/code-quality/c6066.md @@ -1,6 +1,6 @@ --- +title: "Warning C6066" description: "Learn more about: Warning C6066" -title: Warning C6066 ms.date: 3/02/2023 f1_keywords: ["C6066", "NON_POINTER_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_POINTER_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6066"] diff --git a/docs/code-quality/c6067.md b/docs/code-quality/c6067.md index 31e868af661..e2546bfb680 100644 --- a/docs/code-quality/c6067.md +++ b/docs/code-quality/c6067.md @@ -1,6 +1,6 @@ --- +title: "Warning C6067" description: "Learn more about: Warning C6067" -title: Warning C6067 ms.date: 3/02/2023 f1_keywords: ["C6067", "NON_STRING_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_STRING_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6067"] diff --git a/docs/code-quality/c6101.md b/docs/code-quality/c6101.md index 0c0f39907df..11dd9b17a78 100644 --- a/docs/code-quality/c6101.md +++ b/docs/code-quality/c6101.md @@ -1,6 +1,6 @@ --- +title: "Warning C6101" description: "Learn more about: Warning C6101" -title: Warning C6101 ms.date: 02/7/2023 f1_keywords: ["C6101", "RETURN_UNINIT_VAR", "__WARNING_RETURN_UNINIT_VAR"] helpviewer_keywords: ["C6101"] diff --git a/docs/code-quality/c6102.md b/docs/code-quality/c6102.md index 1f38ea8f591..e003c84636b 100644 --- a/docs/code-quality/c6102.md +++ b/docs/code-quality/c6102.md @@ -1,5 +1,5 @@ --- -title: Warning C6102 +title: "Warning C6102" description: "Learn more about: Warning C6102" ms.date: 11/04/2016 f1_keywords: ["C6102"] diff --git a/docs/code-quality/c6103.md b/docs/code-quality/c6103.md index d371d3f178f..4ab5fd62efe 100644 --- a/docs/code-quality/c6103.md +++ b/docs/code-quality/c6103.md @@ -1,5 +1,5 @@ --- -title: Warning C6103 +title: "Warning C6103" description: "Learn more about: Warning C6103" ms.date: 11/04/2016 f1_keywords: ["C6103"] diff --git a/docs/code-quality/c6200.md b/docs/code-quality/c6200.md index d4e40ffe109..0003197a5fd 100644 --- a/docs/code-quality/c6200.md +++ b/docs/code-quality/c6200.md @@ -1,10 +1,9 @@ --- +title: "Warning C6200" description: "Learn more about: Warning C6200" -title: Warning C6200 ms.date: 08/16/2022 f1_keywords: ["C6200", "INDEX_EXCEEDS_MAX_NONSTACK", "__WARNING_INDEX_EXCEEDS_MAX_NONSTACK"] helpviewer_keywords: ["C6200"] -ms.assetid: bbeb159b-4e97-4317-9a07-bb83cd03069a --- # Warning C6200 diff --git a/docs/code-quality/c6201.md b/docs/code-quality/c6201.md index ea7ccab82ac..c1ec04f38cc 100644 --- a/docs/code-quality/c6201.md +++ b/docs/code-quality/c6201.md @@ -1,6 +1,6 @@ --- +title: "Warning C6201" description: "Learn more about: Warning C6201" -title: Warning C6201 ms.date: 11/17/2023 f1_keywords: ["C6201", "INDEX_EXCEEDS_MAX", "__WARNING_INDEX_EXCEEDS_MAX"] helpviewer_keywords: ["C6201"] diff --git a/docs/code-quality/c6211.md b/docs/code-quality/c6211.md index 42bc52405aa..015ad0081c3 100644 --- a/docs/code-quality/c6211.md +++ b/docs/code-quality/c6211.md @@ -1,10 +1,9 @@ --- +title: "Warning C6211" description: "Learn more about: Warning C6211" -title: Warning C6211 ms.date: 10/03/2022 f1_keywords: ["C6211", "MEMORY_LEAK_EXCEPTION", "__WARNING_MEMORY_LEAK_EXCEPTION"] helpviewer_keywords: ["C6211"] -ms.assetid: 9b68243b-534c-4a05-b789-bb155dfcba1e --- # Warning C6211 diff --git a/docs/code-quality/c6214.md b/docs/code-quality/c6214.md index a7b35974469..719f5333c2d 100644 --- a/docs/code-quality/c6214.md +++ b/docs/code-quality/c6214.md @@ -1,10 +1,9 @@ --- +title: "Warning C6214" description: "Learn more about: Warning C6214" -title: Warning C6214 ms.date: 10/03/2022 f1_keywords: ["C6214", "CAST_HRESULT_TO_BOOL", "__WARNING_CAST_HRESULT_TO_BOOL"] helpviewer_keywords: ["C6214"] -ms.assetid: 233e2395-61c1-4a3b-a54b-f19a9ffc31a8 --- # Warning C6214 diff --git a/docs/code-quality/c6215.md b/docs/code-quality/c6215.md index 391c1d0d90e..ef513041b8b 100644 --- a/docs/code-quality/c6215.md +++ b/docs/code-quality/c6215.md @@ -1,10 +1,9 @@ --- +title: "Warning C6215" description: "Learn more about: Warning C6215" -title: Warning C6215 ms.date: 11/04/2016 f1_keywords: ["C6215", "CAST_BOOL_TO_HRESULT", "__WARNING_CAST_BOOL_TO_HRESULT"] helpviewer_keywords: ["C6215"] -ms.assetid: f20cc258-9c0f-4eaa-828d-74f76580ca78 --- # Warning C6215 diff --git a/docs/code-quality/c6216.md b/docs/code-quality/c6216.md index 10102a8948c..b796a0da137 100644 --- a/docs/code-quality/c6216.md +++ b/docs/code-quality/c6216.md @@ -1,10 +1,9 @@ --- +title: "Warning C6216" description: "Learn more about: Warning C6216" -title: Warning C6216 ms.date: 11/04/2016 f1_keywords: ["C6216", "COMPILER_INSERTED_CAST_BOOL_TO_HRESULT", "__WARNING_COMPILER_INSERTED_CAST_BOOL_TO_HRESULT"] helpviewer_keywords: ["C6216"] -ms.assetid: d5c4dcf9-bfd7-4604-804f-9cc41b08d060 --- # Warning C6216 diff --git a/docs/code-quality/c6217.md b/docs/code-quality/c6217.md index 410cfb0fa56..042364717e6 100644 --- a/docs/code-quality/c6217.md +++ b/docs/code-quality/c6217.md @@ -1,6 +1,6 @@ --- +title: "Warning C6217" description: "Learn more about: Warning C6217" -title: Warning C6217 ms.date: 2/07/2023 f1_keywords: ["C6217", "TESTING_HRESULT_WITH_NOT", "__WARNING_TESTING_HRESULT_WITH_NOT"] helpviewer_keywords: ["C6217"] diff --git a/docs/code-quality/c6219.md b/docs/code-quality/c6219.md index 0533f905121..3dabeed9296 100644 --- a/docs/code-quality/c6219.md +++ b/docs/code-quality/c6219.md @@ -1,10 +1,9 @@ --- +title: "Warning C6219" description: "Learn more about: Warning C6219" -title: Warning C6219 ms.date: 11/04/2016 f1_keywords: ["C6219", "COMPARING_HRESULT_TO_ONE", "__WARNING_COMPARING_HRESULT_TO_ONE"] helpviewer_keywords: ["C6219"] -ms.assetid: 889a2de8-c0dc-4e8e-a46b-735384202675 --- # Warning C6219 diff --git a/docs/code-quality/c6220.md b/docs/code-quality/c6220.md index d28f2aa7218..b0ad41d021d 100644 --- a/docs/code-quality/c6220.md +++ b/docs/code-quality/c6220.md @@ -1,10 +1,9 @@ --- +title: "Warning C6220" description: "Learn more about: Warning C6220" -title: Warning C6220 ms.date: 10/03/2022 f1_keywords: ["C6220", "COMPARING_HRESULT_TO_MINUS_ONE", "__WARNING_COMPARING_HRESULT_TO_MINUS_ONE"] helpviewer_keywords: ["C6220"] -ms.assetid: a13524f4-0a1f-4670-b830-70b06e4d39d2 --- # Warning C6220 diff --git a/docs/code-quality/c6221.md b/docs/code-quality/c6221.md index bc42f233547..c4c2e80c8d5 100644 --- a/docs/code-quality/c6221.md +++ b/docs/code-quality/c6221.md @@ -1,10 +1,9 @@ --- +title: "Warning C6221" description: "Learn more about: Warning C6221" -title: Warning C6221 ms.date: 10/03/2022 f1_keywords: ["C6221", "COMPARING_HRESULT_TO_INT", "__WARNING_COMPARING_HRESULT_TO_INT"] helpviewer_keywords: ["C6221"] -ms.assetid: b07989b7-f50f-46e0-8ed8-d9269b3d3580 --- # Warning C6221 diff --git a/docs/code-quality/c6225.md b/docs/code-quality/c6225.md index db351285ad8..9e792a74553 100644 --- a/docs/code-quality/c6225.md +++ b/docs/code-quality/c6225.md @@ -1,10 +1,9 @@ --- +title: "Warning C6225" description: "Learn more about: Warning C6225" -title: Warning C6225 ms.date: 10/03/2022 f1_keywords: ["C6225", "ASSIGNING_ONE_TO_HRESULT", "__WARNING_ASSIGNING_ONE_TO_HRESULT"] helpviewer_keywords: ["C6225"] -ms.assetid: 2d98ffec-9842-4cd1-b1a9-9ac9d1d2a136 --- # Warning C6225 diff --git a/docs/code-quality/c6226.md b/docs/code-quality/c6226.md index 19e7ac5e7ab..48fcb9f1f07 100644 --- a/docs/code-quality/c6226.md +++ b/docs/code-quality/c6226.md @@ -1,10 +1,9 @@ --- +title: "Warning C6226" description: "Learn more about: Warning C6226" -title: Warning C6226 ms.date: 11/04/2016 f1_keywords: ["C6226", "ASSIGNING_MINUS_ONE_TO_HRESULT", "__WARNING_ASSIGNING_MINUS_ONE_TO_HRESULT"] helpviewer_keywords: ["C6226"] -ms.assetid: c18aa576-b316-4f11-b48f-f5183fa49c7c --- # Warning C6226 diff --git a/docs/code-quality/c6230.md b/docs/code-quality/c6230.md index 69c8b130482..ae8a8308813 100644 --- a/docs/code-quality/c6230.md +++ b/docs/code-quality/c6230.md @@ -1,10 +1,9 @@ --- +title: "Warning C6230" description: "Learn more about: Warning C6230" -title: Warning C6230 ms.date: 11/04/2016 f1_keywords: ["C6230", "USING_HRESULT_IN_BOOLEAN_CONTEXT", "__WARNING_USING_HRESULT_IN_BOOLEAN_CONTEXT"] helpviewer_keywords: ["C6230"] -ms.assetid: aa91291d-cdc5-4720-89d4-194ce0557e99 --- # Warning C6230 diff --git a/docs/code-quality/c6235.md b/docs/code-quality/c6235.md index 2a4ae4498e0..b94279a6979 100644 --- a/docs/code-quality/c6235.md +++ b/docs/code-quality/c6235.md @@ -1,10 +1,9 @@ --- +title: "Warning C6235" description: "Learn more about: Warning C6235" -title: Warning C6235 ms.date: 11/04/2016 f1_keywords: ["C6235", "NONZEROLOGICALOR", "__WARNING_NONZEROLOGICALOR"] helpviewer_keywords: ["C6235"] -ms.assetid: e225955e-0bb5-43a4-a83d-83290e209df4 --- # Warning C6235 diff --git a/docs/code-quality/c6236.md b/docs/code-quality/c6236.md index 55d7ceea6c5..fd1b5c35e91 100644 --- a/docs/code-quality/c6236.md +++ b/docs/code-quality/c6236.md @@ -1,10 +1,9 @@ --- +title: "Warning C6236" description: "Learn more about: Warning C6236" -title: Warning C6236 ms.date: 11/04/2016 f1_keywords: ["C6236", "LOGICALORNONZERO", "__WARNING_LOGICALORNONZERO"] helpviewer_keywords: ["C6236"] -ms.assetid: 3d5ae268-6f40-4c45-a483-b5b0e6a808fc --- # Warning C6236 diff --git a/docs/code-quality/c6237.md b/docs/code-quality/c6237.md index 1b2f9b8858a..8518bd67ad8 100644 --- a/docs/code-quality/c6237.md +++ b/docs/code-quality/c6237.md @@ -1,10 +1,9 @@ --- +title: "Warning C6237" description: "Learn more about: Warning C6237" -title: Warning C6237 ms.date: 11/04/2016 f1_keywords: ["C6237", "ZEROLOGICALANDLOSINGSIDEEFFECTS", "__WARNING_ZEROLOGICALANDLOSINGSIDEEFFECTS"] helpviewer_keywords: ["C6237"] -ms.assetid: a18d8630-e4d6-4132-b976-c1f3e7c5c3f0 --- # Warning C6237 diff --git a/docs/code-quality/c6239.md b/docs/code-quality/c6239.md index 8c4ac68cc57..0bf4cc1cb50 100644 --- a/docs/code-quality/c6239.md +++ b/docs/code-quality/c6239.md @@ -1,10 +1,9 @@ --- +title: "Warning C6239" description: "Learn more about: Warning C6239" -title: Warning C6239 ms.date: 11/04/2016 f1_keywords: ["C6239", "NONZEROLOGICALAND", "__WARNING_NONZEROLOGICALAND"] helpviewer_keywords: ["C6239"] -ms.assetid: c80e02bc-ff54-4fde-8c1c-5852853bed24 --- # Warning C6239 diff --git a/docs/code-quality/c6240.md b/docs/code-quality/c6240.md index 4732da3260b..7ed90bcdd6a 100644 --- a/docs/code-quality/c6240.md +++ b/docs/code-quality/c6240.md @@ -1,10 +1,9 @@ --- +title: "Warning C6240" description: "Learn more about: Warning C6240" -title: Warning C6240 ms.date: 11/04/2016 f1_keywords: ["C6240", "LOGICALANDNONZERO", "__WARNING_LOGICALANDNONZERO"] helpviewer_keywords: ["C6240"] -ms.assetid: b9412ae4-622d-4aed-8c34-b67db1ccd48a --- # Warning C6240 diff --git a/docs/code-quality/c6242.md b/docs/code-quality/c6242.md index b5a47d7d4c3..783981a099c 100644 --- a/docs/code-quality/c6242.md +++ b/docs/code-quality/c6242.md @@ -1,10 +1,9 @@ --- -title: Warning C6242 +title: "Warning C6242" description: "Describes Microsoft C/C++ compiler warning C6242." ms.date: 08/24/2020 f1_keywords: ["C6242", "LOCALUNWINDFORCED", "__WARNING_LOCALUNWINDFORCED"] helpviewer_keywords: ["C6242"] -ms.assetid: 523d46ce-8370-434c-a752-2e3a18cca9a5 --- # Warning C6242 diff --git a/docs/code-quality/c6244.md b/docs/code-quality/c6244.md index 49fa103905a..fa539eeac6c 100644 --- a/docs/code-quality/c6244.md +++ b/docs/code-quality/c6244.md @@ -1,10 +1,9 @@ --- +title: "Warning C6244" description: "Learn more about: Warning C6244" -title: Warning C6244 ms.date: 11/04/2016 f1_keywords: ["C6244", "LOCALDECLHIDESGLOBAL", "__WARNING_LOCALDECLHIDESGLOBAL"] helpviewer_keywords: ["C6244"] -ms.assetid: ce2c853d-3354-40f2-a8c5-569f6e4bfc0a --- # Warning C6244 diff --git a/docs/code-quality/c6246.md b/docs/code-quality/c6246.md index 7e4e33f786d..611da41b47e 100644 --- a/docs/code-quality/c6246.md +++ b/docs/code-quality/c6246.md @@ -1,10 +1,9 @@ --- +title: "Warning C6246" description: "Learn more about: Warning C6246" -title: Warning C6246 ms.date: 11/04/2016 f1_keywords: ["C6246", "LOCALDECLHIDESLOCAL", "__WARNING_LOCALDECLHIDESLOCAL"] helpviewer_keywords: ["C6246"] -ms.assetid: cd895cdb-ab3b-4671-ab43-419228fbf980 --- # Warning C6246 diff --git a/docs/code-quality/c6248.md b/docs/code-quality/c6248.md index f91fd895f45..6b85cdf3699 100644 --- a/docs/code-quality/c6248.md +++ b/docs/code-quality/c6248.md @@ -1,10 +1,9 @@ --- +title: "Warning C6248" description: "Learn more about: Warning C6248" -title: Warning C6248 ms.date: 08/16/2022 f1_keywords: ["C6248", "__WARNING_CREATINGNULLDACL", "CREATINGNULLDACL"] helpviewer_keywords: ["C6248"] -ms.assetid: 75743622-7a79-4fe8-81b9-dbdfa1a12f3d --- # Warning C6248 diff --git a/docs/code-quality/c6250.md b/docs/code-quality/c6250.md index 1d47aafd12a..aab691615a8 100644 --- a/docs/code-quality/c6250.md +++ b/docs/code-quality/c6250.md @@ -1,10 +1,9 @@ --- +title: "Warning C6250" description: "Learn more about: Warning C6250" -title: Warning C6250 ms.date: 10/03/2022 f1_keywords: ["C6250", "WIN32UNRELEASEDVADS", "__WARNING_WIN32UNRELEASEDVADS"] helpviewer_keywords: ["C6250"] -ms.assetid: 6949c9c5-e8bd-4f95-bc80-42073a293357 --- # Warning C6250 From 98365de6786da5694aca5809bfa3b2584d2cba74 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 5 Sep 2025 23:52:36 +0800 Subject: [PATCH 1097/1799] Fix `title` mix-up in "Math errors (M6101 through M6205)" --- .../tool-errors/math-errors-m6101-through-m6205.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md index b8e002612ab..f376b2a389d 100644 --- a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md +++ b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md @@ -1,5 +1,5 @@ --- -title: "Learn about math errors M6101 through M6205" +title: "Math errors (M6101 through M6205)" description: "Learn more about: Math errors (Mxxxx)" ms.date: 04/16/2019 --- From e185317fcab4ce54f0a6d8eb0c7e494ae607250b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 00:13:20 +0800 Subject: [PATCH 1098/1799] Structure error references in range [C2321, C2350] (#5575) * Add blockquotes for error messages in range [C2321, C2350] * Add "Remarks" and "Example" headings for error references in range [C2321, C2350] * Replace term "sample" with "example" for error references in range [C2321, C2350] * Update metadata for error references in range [C2321, C2350] --- .../compiler-errors-1/compiler-error-c2322.md | 9 +++++---- .../compiler-errors-1/compiler-error-c2323.md | 8 ++++++-- .../compiler-errors-1/compiler-error-c2324.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2325.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2326.md | 11 ++++++----- .../compiler-errors-1/compiler-error-c2327.md | 17 ++++++++++------- .../compiler-errors-1/compiler-error-c2332.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2333.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2334.md | 11 ++++++----- .../compiler-errors-1/compiler-error-c2337.md | 11 +++++++---- .../compiler-errors-1/compiler-error-c2338.md | 7 +++++-- .../compiler-errors-1/compiler-error-c2341.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2344.md | 11 +++++++---- .../compiler-errors-1/compiler-error-c2345.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2346.md | 11 ++++++----- .../compiler-errors-1/compiler-error-c2348.md | 13 ++++++++----- .../compiler-errors-1/compiler-error-c2350.md | 9 +++++---- 17 files changed, 119 insertions(+), 77 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2322.md b/docs/error-messages/compiler-errors-1/compiler-error-c2322.md index 3118e5213b8..fb2482086a5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2322.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2322.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2322" title: "Compiler Error C2322" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2322" +ms.date: 11/04/2016 f1_keywords: ["C2322"] helpviewer_keywords: ["C2322"] -ms.assetid: f9b92005-618a-42d8-80e9-67ce769a9f3b --- # Compiler Error C2322 -'identifier' : address of dllimport 'dllimport' is not static +> 'identifier' : address of dllimport 'dllimport' is not static + +## Remarks A nonstatic value is given as the address of a function declared with `dllimport`. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2323.md b/docs/error-messages/compiler-errors-1/compiler-error-c2323.md index d17cf401d94..1c00da83503 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2323.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2323.md @@ -1,16 +1,20 @@ --- title: "Compiler Error C2323" description: "Learn more about: Compiler Error C2323" -ms.date: "03/20/2024" +ms.date: 03/20/2024 f1_keywords: ["C2323"] helpviewer_keywords: ["C2323"] --- # Compiler Error C2323 -'identifier': non-member operator `new` or `delete` functions may not be declared `static` or in a namespace other than the global namespace. +> 'identifier': non-member operator `new` or `delete` functions may not be declared `static` or in a namespace other than the global namespace. + +## Remarks The `new` and `delete` overload operators must be non-static, defined in the global namespace or as class members. +## Example + The following generates C2323: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2324.md b/docs/error-messages/compiler-errors-1/compiler-error-c2324.md index d1ef4836f5e..fcb0fd61a1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2324.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2324.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2324" title: "Compiler Error C2324" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2324" +ms.date: 11/04/2016 f1_keywords: ["C2324"] helpviewer_keywords: ["C2324"] -ms.assetid: 215f0544-85b0-452d-825f-17a388b6a61c --- # Compiler Error C2324 -'identifier' : unexpected to the right of 'name' +> 'identifier' : unexpected to the right of 'name' + +## Remarks A destructor is called using an incorrect identifier. -The following sample generates C2324: +## Example + +The following example generates C2324: ```cpp // C2324.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2325.md b/docs/error-messages/compiler-errors-1/compiler-error-c2325.md index 4085db3ee9c..4864fe0c516 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2325.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2325.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2325" title: "Compiler Error C2325" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2325" +ms.date: 11/04/2016 f1_keywords: ["C2325"] helpviewer_keywords: ["C2325"] -ms.assetid: e6b0a186-3f2a-4adf-beae-fadd75492bf7 --- # Compiler Error C2325 -'type' : unexpected type to the right of 'name' +> 'type' : unexpected type to the right of 'name' + +## Remarks A call is made to a destructor of incorrect type. -The following sample generates C2325: +## Example + +The following example generates C2325: ```cpp // C2325.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2326.md b/docs/error-messages/compiler-errors-1/compiler-error-c2326.md index ba0c0c01128..5168287dacd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2326.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2326.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2326" title: "Compiler Error C2326" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2326" +ms.date: 11/04/2016 f1_keywords: ["C2326"] helpviewer_keywords: ["C2326"] -ms.assetid: 01a5ea40-de83-4e6f-a4e8-469f441258e0 --- # Compiler Error C2326 -'declarator' : function cannot access 'name' +> 'declarator' : function cannot access 'name' + +## Remarks The code tries to modify a member variable, which is not possible. ## Example -The following sample generates C2326: +The following example generates C2326: ```cpp // C2326.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2327.md b/docs/error-messages/compiler-errors-1/compiler-error-c2327.md index 1a2c9cb18a9..204783d6cb6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2327.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2327.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2327" title: "Compiler Error C2327" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2327" +ms.date: 11/04/2016 f1_keywords: ["C2327"] helpviewer_keywords: ["C2327"] -ms.assetid: 95278c95-d1f9-4487-ad27-53311f5e8112 --- # Compiler Error C2327 -'symbol' : is not a type name, static, or enumerator +> 'symbol' : is not a type name, static, or enumerator + +## Remarks Code within a nested class attempts to access a member of the enclosing class that is not a type name, a static member, or an enumerator. When compiling with **/clr**, a common cause for C2327 is a property with the same name as the property type. -The following sample generates C2327: +## Examples + +The following example generates C2327: ```cpp // C2327.cpp @@ -62,7 +65,7 @@ struct B { }; ``` -The following sample generates C2327: +The following example generates C2327: ```cpp // C2327d.cpp @@ -96,7 +99,7 @@ namespace NA { } ``` -The following sample shows C2327 when a property has the same name as the property type: +The following example shows C2327 when a property has the same name as the property type: ```cpp // C2327f.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2332.md b/docs/error-messages/compiler-errors-1/compiler-error-c2332.md index 90d950d5461..8ff2d139da5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2332.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2332.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2332" title: "Compiler Error C2332" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2332" +ms.date: 11/04/2016 f1_keywords: ["C2332"] helpviewer_keywords: ["C2332"] -ms.assetid: fb05cd68-e271-4bea-9fb7-ef4edb0a26ac --- # Compiler Error C2332 -'typedef' : missing tag name +> 'typedef' : missing tag name + +## Remarks The compiler found an incomplete type definition. -The following sample generates C2332: +## Example + +The following example generates C2332: ```cpp // C2332.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2333.md b/docs/error-messages/compiler-errors-1/compiler-error-c2333.md index b1be3f36fc8..ef87be83dac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2333.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2333.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2333" title: "Compiler Error C2333" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2333" +ms.date: 11/04/2016 f1_keywords: ["C2333"] helpviewer_keywords: ["C2333"] -ms.assetid: 2636fc1e-d3e7-4e68-8628-3c81a99ba813 --- # Compiler Error C2333 -'function' : error in function declaration; skipping function body +> 'function' : error in function declaration; skipping function body + +## Remarks This error occurs after another error, for member functions defined inside their class. -The following sample generates C2333: +## Example + +The following example generates C2333: ```cpp // C2333.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2334.md b/docs/error-messages/compiler-errors-1/compiler-error-c2334.md index 0ba710e94ac..83f01fe91e8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2334.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2334.md @@ -1,16 +1,17 @@ --- -description: "Learn more about: Compiler Error C2334" title: "Compiler Error C2334" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2334" +ms.date: 11/04/2016 f1_keywords: ["C2334"] helpviewer_keywords: ["C2334"] -ms.assetid: 36142855-e00b-4bbf-80f5-a301edeff46e --- # Compiler Error C2334 -unexpected token(s) preceding ': or {'; skipping apparent function body +> unexpected token(s) preceding ': or {'; skipping apparent function body + +## Example -The following sample generates C2334. This error occurs after error C2059: +The following example generates C2334. This error occurs after error C2059: ```cpp // C2334.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2337.md b/docs/error-messages/compiler-errors-1/compiler-error-c2337.md index ca4fe6be894..9f5f6c91490 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2337.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2337.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2337" title: "Compiler Error C2337" -ms.date: "09/19/2019" +description: "Learn more about: Compiler Error C2337" +ms.date: 09/19/2019 f1_keywords: ["C2337"] helpviewer_keywords: ["C2337"] -ms.assetid: eccc9178-a15e-42cd-bbd0-3cea7cf2d55b --- # Compiler Error C2337 > '*attribute-name*' : attribute not found +## Remarks + Your code uses an attribute that isn't supported in this context. Or, the attribute isn't available in this version of the compiler. To resolve this issue, remove the unsupported attribute. -The following sample generates C2337: +## Example + +The following example generates C2337: ```cpp // C2337.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2338.md b/docs/error-messages/compiler-errors-1/compiler-error-c2338.md index 1ab34e8a9b8..db9b460f461 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2338.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2338.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2338" title: "Compiler Error C2338" +description: "Learn more about: Compiler Error C2338" ms.date: 02/22/2022 f1_keywords: ["C2338"] helpviewer_keywords: ["C2338"] -ms.assetid: 49bba575-1de4-4963-86c6-ce3226a2ba51 --- # Compiler Error C2338 > *Error message* +## Remarks + Error C2338 can be caused by a **`static_assert`** error during compilation. The message is supplied by the **`static_assert`** parameters. Error C2338 can also be generated by external providers to the compiler. In most cases, these errors are reported by an attribute provider DLL, such as ATLPROV. Some common forms of this message include: @@ -24,6 +25,8 @@ These errors are often unrecoverable, and may be followed by a fatal compiler er To fix these issues, correct the attribute usage. For example, in some cases, attribute parameters must be declared before they can be used. If an ATL error number is provided, check the documentation for that error for more specific information. +## Example + In Standard C++11 and later, **`constexpr`** functions are no longer considered **`noexcept`** by default when used in a constant expression. This behavior change comes from the resolution of Core Working Group (CWG) [CWG 1351](https://wg21.link/cwg1351) and is enabled in [`/permissive-`](../../build/reference/permissive-standards-conformance.md) mode. The following example compiles in Visual Studio 2019 version 16.1 and earlier, but produces C2338 in Visual Studio 2019 version 16.2: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2341.md b/docs/error-messages/compiler-errors-1/compiler-error-c2341.md index 74f459a7bf2..3fe4850bb8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2341.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2341.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2341" title: "Compiler Error C2341" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2341" +ms.date: 11/04/2016 f1_keywords: ["C2341"] helpviewer_keywords: ["C2341"] -ms.assetid: aa2a7da5-e1c8-4225-9939-5bdc50158f31 --- # Compiler Error C2341 -'section name' : segment must be defined using #pragma data_seg, code_seg or section prior to use +> 'section name' : segment must be defined using #pragma data_seg, code_seg or section prior to use + +## Remarks An [allocate](../../cpp/allocate.md) statement refers to a segment not yet defined by [code_seg](../../preprocessor/code-seg.md), [data_seg](../../preprocessor/data-seg.md), or [section](../../preprocessor/section.md) pragmas. -The following sample generates C2341: +## Example + +The following example generates C2341: ```cpp // C2341.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2344.md b/docs/error-messages/compiler-errors-1/compiler-error-c2344.md index 4fb3b3f2f7b..978a21fe0fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2344.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2344.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C2344" title: "Compiler Error C2344" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2344" +ms.date: 11/04/2016 f1_keywords: ["C2344"] helpviewer_keywords: ["C2344"] -ms.assetid: a84c7b37-c84e-4345-8691-c23abb2dc193 --- # Compiler Error C2344 -align(#) : alignment must be power of two +> align(#) : alignment must be power of two + +## Remarks When using the [align](../../cpp/align-cpp.md) keyword, the value you pass must be a power of two. +## Example + For example, the following code generates C2344 because 3 is not a power of two: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2345.md b/docs/error-messages/compiler-errors-1/compiler-error-c2345.md index 4044e32b0e7..6d621a6d8c2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2345.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2345.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2345" title: "Compiler Error C2345" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2345" +ms.date: 11/04/2016 f1_keywords: ["C2345"] helpviewer_keywords: ["C2345"] -ms.assetid: e1cc88b0-0223-4d07-975b-fa99956a82bd --- # Compiler Error C2345 -align(value) : illegal alignment value +> align(value) : illegal alignment value + +## Remarks You passed a value to the [align](../../cpp/align-cpp.md) keyword that is outside the allowable range. -The following sample generates C2345: +## Example + +The following example generates C2345: ```cpp // C2345.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2346.md b/docs/error-messages/compiler-errors-1/compiler-error-c2346.md index 6c26eabe752..b4a03aaf133 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2346.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2346.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2346" title: "Compiler Error C2346" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2346" +ms.date: 11/04/2016 f1_keywords: ["C2346"] helpviewer_keywords: ["C2346"] -ms.assetid: 246145be-5645-4cd6-867c-e3bc39e33dca --- # Compiler Error C2346 -'function' cannot be compiled as native: reason +> 'function' cannot be compiled as native: reason + +## Remarks The compiler was unable to compile a function to MSIL. @@ -22,7 +23,7 @@ For more information, see [managed, unmanaged](../../preprocessor/managed-unmana ## Example -The following sample generates C2346. +The following example generates C2346. ```cpp // C2346.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2348.md b/docs/error-messages/compiler-errors-1/compiler-error-c2348.md index 66e3378836a..f2d45f255de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2348.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2348.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2348" title: "Compiler Error C2348" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2348" +ms.date: 11/04/2016 f1_keywords: ["C2348"] helpviewer_keywords: ["C2348"] -ms.assetid: 4c4d701f-ccf1-46fe-9ddb-3f341684f269 --- # Compiler Error C2348 -'type name' : is not a C-style aggregate, cannot be exported in embedded-IDL +> 'type name' : is not a C-style aggregate, cannot be exported in embedded-IDL + +## Remarks To place a **`struct`** in a .idl file with the [export](../../windows/attributes/export.md) attribute, the **`struct`** must contain only data. -The following sample generates C2348: +## Example + +The following example generates C2348: ```cpp // C2348.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2350.md b/docs/error-messages/compiler-errors-1/compiler-error-c2350.md index f4ba948e013..8d4160dde22 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2350.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2350.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2350" title: "Compiler Error C2350" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2350" +ms.date: 11/04/2016 f1_keywords: ["C2350"] helpviewer_keywords: ["C2350"] -ms.assetid: 3a50cb94-8ced-4df4-b602-c48916fa957d --- # Compiler Error C2350 -'identifier' is not a static member +> 'identifier' is not a static member + +## Remarks Nonstatic members of a class or structure cannot be defined. From 1b91fa610e252ce686964b104dcd424009955252 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 5 Sep 2025 09:24:18 -0700 Subject: [PATCH 1099/1799] code escape and acrolinx updates --- docs/sanitizers/asan-known-issues.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 5cd2dfd6d0b..b5d899dabc0 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -27,7 +27,7 @@ The following options and functionality are incompatible with [`/fsanitize=addre ## Standard library support -The MSVC standard library (STL) makes partial use of the AddressSanitizer and provides other code safety checks. For more information, see [container-overflow error](./error-container-overflow.md). +The Microsoft Visual C++ (MSVC) standard library (STL) makes partial use of the AddressSanitizer and provides other code safety checks. For more information, see [`container-overflow` error](./error-container-overflow.md). When annotations are disabled, or in versions of the Standard Library that don't support them, AddressSanitizer exceptions raised in STL code still identify real bugs. However, they're more precise if annotations are enabled and you use a version of the Standard Library that supports them. @@ -37,7 +37,8 @@ This example demonstrates the lack of precision and the benefits of enabling ann // Compile with: cl /fsanitize=address /Zi #include -int main() { +int main() +{ // Create a vector of size 10, but with a capacity of 20. std::vector v(10); v.reserve(20); @@ -55,11 +56,11 @@ int main() { } ``` -## Overriding operator new and delete +## Overriding `operator new` and `delete` -AddressSanitizer (ASan) uses a custom version of `operator new` and `operator delete` to find allocation errors like [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md). Running the linker with [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) ensures that ASan's `new`/`delete` override has low precedence, so that the linker chooses any `operator new` or `operator delete` overrides in other libraries over ASan's custom versions. When this happens, ASan may not be able to catch some errors that rely on its custom `operator new` and `operator delete`. +AddressSanitizer (ASan) uses a custom version of `operator new` and `operator delete` to find allocation errors like [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md). Run the linker with [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) to ensure that ASan's `new`/`delete` override has lower precedence, so that the linker chooses `operator new` or `operator delete` overrides in other libraries over ASan's custom versions. When this happens, ASan might not catch some errors that rely on its custom `operator new` and `operator delete`. -[MFC](../mfc/mfc-concepts.md) includes custom overrides for `operator new` and `operator delete`. When `MFC` overrides are used instead of the ASan provided `operator new` and `operator delete`, ASan might miss errors entirely or classify them incorrectly as a result. The following errors may be missed or incorrectly classified: +[MFC](../mfc/mfc-concepts.md) includes custom overrides for `operator new` and `operator delete`. When Microsoft Foundation Classes (MFC) overrides are used instead of the ASan provided `operator new` and `operator delete`, ASan might miss errors entirely or classify them incorrectly as a result. The following errors may be missed or incorrectly classified: - [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md) - [`double-free`](error-double-free.md) - [`heap-use-after-free`](error-heap-use-after-free.md) From 08c41c9140bf2b0e1a5e629586fb58b08a092d2e Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 00:35:41 +0800 Subject: [PATCH 1100/1799] Fix mistakes and update "AddressSanitizer Runtime Options" topic (#5738) * Fix mistakes in "AddressSanitizer Runtime Options" topic * Clean up superfluous `./` link prefix and remove empty line in "AddressSanitizer Runtime Options" topic --- docs/sanitizers/asan-flags.md | 31 +++++++++++++++---------------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 02799d0c66b..1431a0094b5 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -7,24 +7,23 @@ helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Add # AddressSanitizer Runtime Options -The following table lists the options for the AddressSanitizer. Enable them via the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function described [here](./asan-runtime.md#runtime-options). +The following table lists the options for the AddressSanitizer. Enable them via the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function described [here](asan-runtime.md#runtime-options). > [!NOTE] > These descriptions account for Microsoft Visual C++ (MSVC) specific behaviors, which may vary from Clang's runtime options. - | Flag | Default value | Description | |------|---------------|-------------| |`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| |`alloc_dealloc_mismatch` | `false` | Detects mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, and so on.| |`allocator_frees_and_returns_null_on_realloc_zero` | `true` | If set to `true`, `realloc(p, 0)` is the same as `free(p)` by default (which is the same as the POSIX standard). If set to `false`, `realloc(p, 0)` returns a pointer to an allocated space that can't be used. | |`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| -|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using the [Manual AddressSanitizer poising interface](./asan-runtime.md#poisoning).| +|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using the [Manual AddressSanitizer poisoning interface](asan-runtime.md#poisoning).| |`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| |`continue_on_error` | 0 | Allows an application to continue running while reporting memory safety errors.
0-disabled.
1-enabled; errors are sent to `stdout`.
2-enabled; errors are sent to `stderr`.
For more information, see [continue_on_error](asan-continue-on-error.md).| -|`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. For more information, see [ContainerOverflow](./error-container-overflow.md).| +|`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. For more information, see [ContainerOverflow](error-container-overflow.md).| |`detect_invalid_pointer_pairs` | `false` | If `true`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs such as pointers that belong to different objects.| -|`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. For more information, see [stack-use-after-return](./error-stack-use-after-return.md).| +|`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. For more information, see [stack-use-after-return](error-stack-use-after-return.md).| |`exitcode` | 1 | Overrides the program exit status with this value if ASan finds an error.| |`external_symbolizer_path` | "" | Path to the external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| |`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| @@ -33,7 +32,7 @@ The following table lists the options for the AddressSanitizer. Enable them via |`handle_sigfpe` | `true` | If `true`, ASan handles `SIGFPE` errors.| |`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.| |`help` | `false` | If `true`, ASan prints the flag options to the console.| -|`iat_overwrite`|`error`|`error` - reports an error whenever an overwrite is detected.
`protect` - trys to avoid using the overwritten definition.
`ignore` - doesn't try to correct any overwritten functions. For more information, see [`iat_overwrite`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| +|`iat_overwrite`|`error`|`error` - reports an error whenever an overwrite is detected.
`protect` - tries to avoid using the overwritten definition.
`ignore` - doesn't try to correct any overwritten functions. For more information, see [`iat_overwrite`](asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`include_if_exists` | "" | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.| |`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` to find more errors.| |`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` to find more errors.| @@ -42,7 +41,7 @@ The following table lists the options for the AddressSanitizer. Enable them via |`malloc_fill_byte` | `0xbe` | Value used to fill newly allocated memory.| |`max_malloc_fill_size` | 4096 | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.| |`max_redzone` | 2048 | Maximum size (in bytes) of redzones around heap objects.| -|`new_delete_type_mismatch` | `true` | Report errors on mismatch between the size of `new` and `delete`. For more information, see [`new-delete-type-mismatch`](./error-new-delete-type-mismatch.md).| +|`new_delete_type_mismatch` | `true` | Report errors on mismatch between the size of `new` and `delete`. For more information, see [`new-delete-type-mismatch`](error-new-delete-type-mismatch.md).| |`poison_heap` | `true` | If `true`, poison the heap memory on allocation and deallocation. `false` is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print the command line on crash. With `continue_on_error` set >= 1, prints the current working directory and is `UTF-16` aware.| @@ -54,20 +53,20 @@ The following table lists the options for the AddressSanitizer. Enable them via |`sleep_before_dying` | 0 | Number of seconds to sleep between printing an error report and terminating the program.| |`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders:
`%%` - represents a `'%'` character
`%n` - frame number (copy of `frame_no`)
`%p` - `PC`
`%m` - path to module
`%o` - offset in the module
`%f` - function name
`%q` - if available, offset in the function
`%s` - path to source file
`%l` - line in the source file
`%c` - column in the source file
`%F` - if the function is known, ASan prints `in ` followed by the offset in this function if source is unknown
`%S` - ASan prints file/line/column information
`%L` - If file information is available, ASan prints the file name, line, and column. If module information is available, ASan prints the module name, offset, and architecture. If neither are available, ASan prints `()`
`%M` - If known, ASan prints module basename and offset, or `PC`| |`strict_memcmp` | `true` | If `true`, assumes that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| -|`strict_string_checks` | `false` | If `true` checks that string arguments are properly null-terminated.| +|`strict_string_checks` | `false` | If `true`, checks that string arguments are properly null-terminated.| |`strip_path_prefix` | "" | Strips this prefix from file paths in error reports.| |`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses into file or line locations.| |`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| |`verbosity` | 0 | Verbosity level:
0 - default verbosity.
1 - more output.
2 - even more output.
3 - maximum verbosity. | -|`windows_fast_fail_on_error`| `false` | If `true`, the process can terminate with a `__fastfail(71)` after printing the error report. For more information, see [`windows_fast_fail_on_error`](./asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| +|`windows_fast_fail_on_error`| `false` | If `true`, the process can terminate with a `__fastfail(71)` after printing the error report. For more information, see [`windows_fast_fail_on_error`](asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| |`windows_hook_legacy_allocators`| `true` |If `true`, enables hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) From 4e014ebdc92c27cfd8d4d56b3f2d45e82b2959a1 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 00:50:35 +0800 Subject: [PATCH 1101/1799] Structure warning references in range [C5051, C5999] (#5739) * Add "Remarks" headings for warning references in range [C5051, C5999] * Replace term "sample" with "example" for warning references in range [C5051, C5999] * Update metadata for warning references in range [C5051, C5999] --- docs/error-messages/compiler-warnings/c5054.md | 2 +- docs/error-messages/compiler-warnings/c5055.md | 2 +- docs/error-messages/compiler-warnings/c5056.md | 2 +- docs/error-messages/compiler-warnings/c5105.md | 6 +++--- docs/error-messages/compiler-warnings/c5208.md | 4 ++-- docs/error-messages/compiler-warnings/c5240.md | 2 +- docs/error-messages/compiler-warnings/c5243.md | 4 ++-- docs/error-messages/compiler-warnings/c5247.md | 2 +- docs/error-messages/compiler-warnings/c5248.md | 2 +- docs/error-messages/compiler-warnings/c5262.md | 4 ++-- docs/error-messages/compiler-warnings/c5267.md | 2 +- docs/error-messages/compiler-warnings/c5301-c5302.md | 4 ++-- .../compiler-warnings/compiler-warning-c5072.md | 4 +++- .../compiler-warnings/compiler-warning-level-4-c5266.md | 6 ++++-- 14 files changed, 25 insertions(+), 21 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c5054.md b/docs/error-messages/compiler-warnings/c5054.md index ba2e219746f..669dbdd5b40 100644 --- a/docs/error-messages/compiler-warnings/c5054.md +++ b/docs/error-messages/compiler-warnings/c5054.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5054" -description: Compiler warning C5054 description and solution. +description: "Compiler warning C5054 description and solution." ms.date: 02/22/2022 f1_keywords: ["C5054"] helpviewer_keywords: ["C5054"] diff --git a/docs/error-messages/compiler-warnings/c5055.md b/docs/error-messages/compiler-warnings/c5055.md index 4cca582e6c3..4a469b06fd3 100644 --- a/docs/error-messages/compiler-warnings/c5055.md +++ b/docs/error-messages/compiler-warnings/c5055.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5055" -description: Compiler warning C5055 description and solution. +description: "Compiler warning C5055 description and solution." ms.date: 02/22/2022 f1_keywords: ["C5055"] helpviewer_keywords: ["C5055"] diff --git a/docs/error-messages/compiler-warnings/c5056.md b/docs/error-messages/compiler-warnings/c5056.md index cb757f7ad98..8d775f210eb 100644 --- a/docs/error-messages/compiler-warnings/c5056.md +++ b/docs/error-messages/compiler-warnings/c5056.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5056" -description: Compiler warning C5056 description and solution. +description: "Compiler warning C5056 description and solution." ms.date: 02/22/2022 f1_keywords: ["C5056"] helpviewer_keywords: ["C5056"] diff --git a/docs/error-messages/compiler-warnings/c5105.md b/docs/error-messages/compiler-warnings/c5105.md index e7167acca07..e1f17302e9a 100644 --- a/docs/error-messages/compiler-warnings/c5105.md +++ b/docs/error-messages/compiler-warnings/c5105.md @@ -1,7 +1,7 @@ --- title: "Compiler Warning C5105" -description: Compiler warning C5105 description and solution. -ms.date: "09/22/2019" +description: "Compiler warning C5105 description and solution." +ms.date: 09/22/2019 f1_keywords: ["C5105"] helpviewer_keywords: ["C5105"] --- @@ -29,7 +29,7 @@ To turn off the warning for an entire project in the Visual Studio IDE: ## Example -This sample program shows how to generate warning C5105, and how to fix it. +This example program shows how to generate warning C5105, and how to fix it. ```cpp // C5105.cpp diff --git a/docs/error-messages/compiler-warnings/c5208.md b/docs/error-messages/compiler-warnings/c5208.md index 53a7f3b9eaf..a1369dcd380 100644 --- a/docs/error-messages/compiler-warnings/c5208.md +++ b/docs/error-messages/compiler-warnings/c5208.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5208, Error C7626" -description: Compiler warning C5208 and error C7626 description and solution. +description: "Compiler warning C5208 and error C7626 description and solution." ms.date: 04/18/2021 f1_keywords: ["C5208", "C7626"] helpviewer_keywords: ["C5208", "C7626"] @@ -33,7 +33,7 @@ To turn off the warning for an entire project in the Visual Studio IDE: ## Example -The following sample shows the constructs that are no longer allowed in unnamed structs. Depending on the standards mode specified, C5208 or C7626 errors or warnings are emitted: +The following example shows the constructs that are no longer allowed in unnamed structs. Depending on the standards mode specified, C5208 or C7626 errors or warnings are emitted: ```cpp struct Base { }; diff --git a/docs/error-messages/compiler-warnings/c5240.md b/docs/error-messages/compiler-warnings/c5240.md index 8389182d68d..942056d2bcd 100644 --- a/docs/error-messages/compiler-warnings/c5240.md +++ b/docs/error-messages/compiler-warnings/c5240.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5240" -description: Compiler warning C5240 description and solution. +description: "Compiler warning C5240 description and solution." ms.date: 02/22/2022 f1_keywords: ["C5240"] helpviewer_keywords: ["C5240"] diff --git a/docs/error-messages/compiler-warnings/c5243.md b/docs/error-messages/compiler-warnings/c5243.md index 0679327d677..3a14cbf8fee 100644 --- a/docs/error-messages/compiler-warnings/c5243.md +++ b/docs/error-messages/compiler-warnings/c5243.md @@ -1,6 +1,6 @@ --- -title: Compiler warning C5243 -description: Compiler warning C5243 description and solution. +title: "Compiler warning C5243" +description: "Compiler warning C5243 description and solution." ms.date: 08/09/2021 f1_keywords: ["C5243"] helpviewer_keywords: ["C5243"] diff --git a/docs/error-messages/compiler-warnings/c5247.md b/docs/error-messages/compiler-warnings/c5247.md index 6ac55f629e1..f3d1101d2c1 100644 --- a/docs/error-messages/compiler-warnings/c5247.md +++ b/docs/error-messages/compiler-warnings/c5247.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5247" -description: Compiler warning C5247 description and solution. +description: "Compiler warning C5247 description and solution." ms.date: 08/02/2021 f1_keywords: ["C5247"] helpviewer_keywords: ["C5247"] diff --git a/docs/error-messages/compiler-warnings/c5248.md b/docs/error-messages/compiler-warnings/c5248.md index 255771462ec..ea45b79264c 100644 --- a/docs/error-messages/compiler-warnings/c5248.md +++ b/docs/error-messages/compiler-warnings/c5248.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5248" -description: Compiler warning C5248 description and solution. +description: "Compiler warning C5248 description and solution." ms.date: 08/02/2021 f1_keywords: ["C5248"] helpviewer_keywords: ["C5248"] diff --git a/docs/error-messages/compiler-warnings/c5262.md b/docs/error-messages/compiler-warnings/c5262.md index d51098ead1a..48fcd340ecc 100644 --- a/docs/error-messages/compiler-warnings/c5262.md +++ b/docs/error-messages/compiler-warnings/c5262.md @@ -1,6 +1,6 @@ --- title: "Compiler warning (level 1, error, off) C5262" -description: Compiler warning C5262 description and solution. +description: "Compiler warning C5262 description and solution." ms.date: 03/01/2023 f1_keywords: ["C5262"] helpviewer_keywords: ["C5262"] @@ -17,7 +17,7 @@ Compiler warning C5262 is new in Visual Studio 2022 version 17.4, and is both of ## Example -The sample code shows diagnostics for `switch` cases that fall through without `break` or `return` statements or the `[[fallthrough]]` attribute. +The example code shows diagnostics for `switch` cases that fall through without `break` or `return` statements or the `[[fallthrough]]` attribute. ```cpp // C5262.cpp diff --git a/docs/error-messages/compiler-warnings/c5267.md b/docs/error-messages/compiler-warnings/c5267.md index 23b1a7a5db6..a43a8ec9824 100644 --- a/docs/error-messages/compiler-warnings/c5267.md +++ b/docs/error-messages/compiler-warnings/c5267.md @@ -1,6 +1,6 @@ --- title: "Compiler warning C5267" -description: Learn about compiler warning C5267 +description: "Learn about compiler warning C5267" ms.date: 11/08/2023 f1_keywords: ["C5267"] helpviewer_keywords: ["C5267"] diff --git a/docs/error-messages/compiler-warnings/c5301-c5302.md b/docs/error-messages/compiler-warnings/c5301-c5302.md index 0283c7f2f6d..4bc84869d81 100644 --- a/docs/error-messages/compiler-warnings/c5301-c5302.md +++ b/docs/error-messages/compiler-warnings/c5301-c5302.md @@ -1,6 +1,6 @@ --- title: "Compiler warnings (level 1) C5301 and C5302" -description: Compiler warnings C5301 and C5302 description and solution. +description: "Compiler warnings C5301 and C5302 description and solution." ms.date: 03/01/2023 f1_keywords: ["C5301", "C5302"] helpviewer_keywords: ["C5301", "C5302"] @@ -19,7 +19,7 @@ These compiler warnings are new in Visual Studio 2022 version 17.4. ## Example -The sample code shows a diagnostic for a `for` loop that decrements the index, but it uses a `<=` comparison that tests whether the index is less than a value higher than the starting value. +The example code shows a diagnostic for a `for` loop that decrements the index, but it uses a `<=` comparison that tests whether the index is less than a value higher than the starting value. ```C // C5302.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md index b3216cb81bb..481bbadd2a5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 1) C5072" title: "Compiler Warning (level 1) C5072" +description: "Learn more about: Compiler Warning (level 1) C5072" ms.date: 02/09/2024 f1_keywords: ["C5072"] helpviewer_keywords: ["C5072"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C5072"] > ASAN enabled without debug information emission. Enable debug info for better ASAN error reporting +## Remarks + This warning occurs when you compile with [Address Sanitizer](/cpp/sanitizers/asan) (ASAN) turned on, but you don't also instruct the compiler to emit debug info. ASAN uses debug info to provide better diagnostics. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c5266.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c5266.md index f4e794516d5..840a8a254bb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c5266.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c5266.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C5266" title: "Compiler Warning (level 4) C5266" +description: "Learn more about: Compiler Warning (level 4) C5266" ms.date: 01/18/2024 f1_keywords: ["C5266"] helpviewer_keywords: ["C5266"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C5266"] > 'const' qualifier on return type has no effect +## Remarks + The C++ Standard specifies that a top-level const (or volatile) qualification on a function return type is ignored. This warning is off by default.\ @@ -16,7 +18,7 @@ This warning was introduced in Visual Studio 17.6 ## Example -The following sample generates C5266: +The following example generates C5266: ```cpp // compile with: /W4 /c From cab0bee583f177a658c82c9665abcc170316f60d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 5 Sep 2025 10:16:24 -0700 Subject: [PATCH 1102/1799] make user name case match --- docs/docfx.json | 66 ++++++++++++++++++++++++------------------------- 1 file changed, 33 insertions(+), 33 deletions(-) diff --git a/docs/docfx.json b/docs/docfx.json index 23b40c4fd3a..871ff2d1351 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -186,39 +186,39 @@ "windows/**/**.{md,yml}": "1825-days" }, "author": { - "index.md": "tylermsft", - "assembler/**/**.{md,yml}": "tylermsft", - "attributes/**/**.{md,yml}": "tylermsft", - "atl/**/**.{md,yml}": "tylermsft", - "atl-mfc-shared/**/**.{md,yml}": "tylermsft", - "build/**/**.{md,yml}": "tylermsft", - "build-insights/**/**.{md,yml}": "tylermsft", - "c-language/**/**.{md,yml}": "tylermsft", - "c-runtime-library/**/**.{md,yml}": "tylermsft", - "cloud/**/**.{md,yml}": "tylermsft", - "code-quality/**/**.{md,yml}": "tylermsft", - "cpp/**/**.{md,yml}": "tylermsft", - "cppcx/**/**.{md,yml}": "tylermsft", - "cross-platform/**/**.{md,yml}": "tylermsft", - "data/**/**.{md,yml}": "tylermsft", - "dotnet/**/**.{md,yml}": "tylermsft", - "error-messages/**/**.{md,yml}": "tylermsft", - "extensions/**/**.{md,yml}": "tylermsft", - "get-started/**/**.{md,yml}": "tylermsft", - "ide/**/**.{md,yml}": "tylermsft", - "intrinsics/**/**.{md,yml}": "tylermsft", - "linux/**/**.{md,yml}": "tylermsft", - "mfc/**/**.{md,yml}": "tylermsft", - "overview/**/**.{md,yml}": "tylermsft", - "parallel/**/**.{md,yml}": "tylermsft", - "porting/**/**.{md,yml}": "tylermsft", - "preprocessor/**/**.{md,yml}": "tylermsft", - "safeint/**/**.{md,yml}": "tylermsft", - "sanitizers/**/**.{md,yml}": "tylermsft", - "security/**/**.{md,yml}": "tylermsft", - "standard-library/**/**.{md,yml}": "tylermsft", - "text/**/**.{md,yml}": "tylermsft", - "windows/**/**.{md,yml}": "tylermsft" + "index.md": "TylerMSFT", + "assembler/**/**.{md,yml}": "TylerMSFT", + "attributes/**/**.{md,yml}": "TylerMSFT", + "atl/**/**.{md,yml}": "TylerMSFT", + "atl-mfc-shared/**/**.{md,yml}": "TylerMSFT", + "build/**/**.{md,yml}": "TylerMSFT", + "build-insights/**/**.{md,yml}": "TylerMSFT", + "c-language/**/**.{md,yml}": "TylerMSFT", + "c-runtime-library/**/**.{md,yml}": "TylerMSFT", + "cloud/**/**.{md,yml}": "TylerMSFT", + "code-quality/**/**.{md,yml}": "TylerMSFT", + "cpp/**/**.{md,yml}": "TylerMSFT", + "cppcx/**/**.{md,yml}": "TylerMSFT", + "cross-platform/**/**.{md,yml}": "TylerMSFT", + "data/**/**.{md,yml}": "TylerMSFT", + "dotnet/**/**.{md,yml}": "TylerMSFT", + "error-messages/**/**.{md,yml}": "TylerMSFT", + "extensions/**/**.{md,yml}": "TylerMSFT", + "get-started/**/**.{md,yml}": "TylerMSFT", + "ide/**/**.{md,yml}": "TylerMSFT", + "intrinsics/**/**.{md,yml}": "TylerMSFT", + "linux/**/**.{md,yml}": "TylerMSFT", + "mfc/**/**.{md,yml}": "TylerMSFT", + "overview/**/**.{md,yml}": "TylerMSFT", + "parallel/**/**.{md,yml}": "TylerMSFT", + "porting/**/**.{md,yml}": "TylerMSFT", + "preprocessor/**/**.{md,yml}": "TylerMSFT", + "safeint/**/**.{md,yml}": "TylerMSFT", + "sanitizers/**/**.{md,yml}": "TylerMSFT", + "security/**/**.{md,yml}": "TylerMSFT", + "standard-library/**/**.{md,yml}": "TylerMSFT", + "text/**/**.{md,yml}": "TylerMSFT", + "windows/**/**.{md,yml}": "TylerMSFT" }, "ms.author": { "index.md": "twhitney", From 3e1559290a5fc0badd6a66a0ed981483edc9e471 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 02:00:12 +0800 Subject: [PATCH 1103/1799] Structure warning references in range [C4941, C5050] (#5737) * Add blockquotes for warning messages in range [C4941, C5050] * Add "Remarks" and "Example" headings for warning references in range [C4941, C5050] * Replace term "sample" with "example" for warning references in range [C4941, C5050] * Update metadata for warning references in range [C4941, C5050] --- docs/error-messages/compiler-warnings/c5033.md | 6 +++--- docs/error-messages/compiler-warnings/c5037.md | 2 +- docs/error-messages/compiler-warnings/c5038.md | 2 +- docs/error-messages/compiler-warnings/c5045.md | 4 ++-- docs/error-messages/compiler-warnings/c5046.md | 6 +++--- docs/error-messages/compiler-warnings/c5050.md | 2 +- .../compiler-warnings/compiler-warning-c4950.md | 11 ++++++----- .../compiler-warnings/compiler-warning-c4956.md | 7 +++---- .../compiler-warnings/compiler-warning-c4957.md | 7 +++---- .../compiler-warnings/compiler-warning-c4958.md | 11 +++++------ .../compiler-warnings/compiler-warning-c4959.md | 7 +++---- .../compiler-warnings/compiler-warning-c4961.md | 9 +++++---- .../compiler-warnings/compiler-warning-c4962.md | 9 +++++---- .../compiler-warnings/compiler-warning-c4972.md | 11 ++++++----- .../compiler-warnings/compiler-warning-c4984.md | 6 +++--- .../compiler-warnings/compiler-warning-c4986.md | 15 ++++++++------- .../compiler-warning-level-1-and-level-4-c4949.md | 15 +++++++++------ .../compiler-warning-level-1-c4944.md | 15 ++++++++------- .../compiler-warning-level-1-c4945.md | 13 ++++++++----- .../compiler-warning-level-1-c4946.md | 11 +++++++---- .../compiler-warning-level-1-c4947.md | 11 ++++++----- .../compiler-warning-level-1-c4951.md | 7 ++++--- .../compiler-warning-level-1-c4952.md | 7 ++++--- .../compiler-warning-level-1-c4953.md | 7 ++++--- .../compiler-warning-level-1-c4964.md | 13 ++++++++----- .../compiler-warning-level-1-c4965.md | 11 ++++++----- .../compiler-warning-level-1-c4997.md | 13 ++++++++----- .../compiler-warning-level-2-c4948.md | 9 +++++---- .../compiler-warning-level-3-c4995.md | 5 ++--- .../compiler-warning-level-3-c4996.md | 9 ++++----- .../compiler-warning-level-4-c4960.md | 9 +++++---- .../compiler-warning-level-4-c4985.md | 7 ++++--- 32 files changed, 150 insertions(+), 127 deletions(-) diff --git a/docs/error-messages/compiler-warnings/c5033.md b/docs/error-messages/compiler-warnings/c5033.md index d60b67afabf..c816d98078c 100644 --- a/docs/error-messages/compiler-warnings/c5033.md +++ b/docs/error-messages/compiler-warnings/c5033.md @@ -1,6 +1,6 @@ --- title: "Compiler warning C5033" -description: Describes the causes and fixes for compiler warning C5033. +description: "Describes the causes and fixes for compiler warning C5033." ms.date: 05/03/2021 f1_keywords: ["C5033"] helpviewer_keywords: ["C5033"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C5033"] > '*storage-class-keyword*' is no longer a supported storage class -The **`auto`** and **`register`** storage class keywords have been deprecated or removed from the C++ language. - ## Remarks +The **`auto`** and **`register`** storage class keywords have been deprecated or removed from the C++ language. + **Visual Studio 2010 and later:** In C++11, the **`auto`** keyword is no longer a C++ storage-class specifier, and the **`register`** keyword is deprecated. **Visual Studio 2017 version 15.7 and later:** (available in [`/std:c++17`](../../build/reference/std-specify-language-standard-version.md) mode and later): The **`register`** keyword is removed from the C++ language in C++17 and later standards. diff --git a/docs/error-messages/compiler-warnings/c5037.md b/docs/error-messages/compiler-warnings/c5037.md index 95c12967f23..d55293db78a 100644 --- a/docs/error-messages/compiler-warnings/c5037.md +++ b/docs/error-messages/compiler-warnings/c5037.md @@ -1,6 +1,6 @@ --- title: "Compiler warning C5037" -description: Describes the causes and fixes for compiler warning C5037. +description: "Describes the causes and fixes for compiler warning C5037." ms.date: 04/18/2021 f1_keywords: ["C5037"] helpviewer_keywords: ["C5037"] diff --git a/docs/error-messages/compiler-warnings/c5038.md b/docs/error-messages/compiler-warnings/c5038.md index a5ecba20d56..9046d2792d6 100644 --- a/docs/error-messages/compiler-warnings/c5038.md +++ b/docs/error-messages/compiler-warnings/c5038.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5038" -description: Describes the causes and fixes for compiler warning C5038. +description: "Describes the causes and fixes for compiler warning C5038." ms.date: 05/03/2021 f1_keywords: ["C5038"] helpviewer_keywords: ["C5038"] diff --git a/docs/error-messages/compiler-warnings/c5045.md b/docs/error-messages/compiler-warnings/c5045.md index 13e3406a604..d9d9bc3aea7 100644 --- a/docs/error-messages/compiler-warnings/c5045.md +++ b/docs/error-messages/compiler-warnings/c5045.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning C5045" title: "Compiler Warning C5045" -ms.date: "06/21/2018" +description: "Learn more about: Compiler Warning C5045" +ms.date: 06/21/2018 f1_keywords: ["C5045"] helpviewer_keywords: ["C5045"] --- diff --git a/docs/error-messages/compiler-warnings/c5046.md b/docs/error-messages/compiler-warnings/c5046.md index 83c0ba4b116..2cfd74a6498 100644 --- a/docs/error-messages/compiler-warnings/c5046.md +++ b/docs/error-messages/compiler-warnings/c5046.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 2) C5046" title: "Compiler Warning C5046" -ms.date: "03/21/2019" +description: "Learn more about: Compiler Warning (level 2) C5046" +ms.date: 03/21/2019 f1_keywords: ["C5046"] helpviewer_keywords: ["C5046"] --- @@ -25,7 +25,7 @@ This warning is new in Visual Studio 2017 version 15.8. ## Example -This sample shows two C5046 warnings: +This example shows two C5046 warnings: ```cpp // C5046p.cpp diff --git a/docs/error-messages/compiler-warnings/c5050.md b/docs/error-messages/compiler-warnings/c5050.md index 37158601358..7df6abc376f 100644 --- a/docs/error-messages/compiler-warnings/c5050.md +++ b/docs/error-messages/compiler-warnings/c5050.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5050" -description: Compiler warning C5050 description and solution. +description: "Compiler warning C5050 description and solution." ms.date: 05/03/2021 f1_keywords: ["C5050"] helpviewer_keywords: ["C5050"] diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4950.md b/docs/error-messages/compiler-warnings/compiler-warning-c4950.md index e4ca8421480..e7fef9ffffd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4950.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4950.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4950" title: "Compiler Warning C4950" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4950" +ms.date: 11/04/2016 f1_keywords: ["C4950"] helpviewer_keywords: ["C4950"] -ms.assetid: 50226a5c-c664-4d09-ac59-e9e874ca244f --- # Compiler Warning C4950 -'type_or_member' : marked as obsolete +> 'type_or_member' : marked as obsolete + +## Remarks A member or type was marked as obsolete with the attribute. @@ -16,7 +17,7 @@ C4950 is always issued as an error. You can turn off this warning by using the [ ## Example -The following sample generates C4950: +The following example generates C4950: ```cpp // C4950.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4956.md b/docs/error-messages/compiler-warnings/compiler-warning-c4956.md index cd8382e9920..d2be88d6b50 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4956.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4956.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4956" title: "Compiler Warning C4956" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4956" +ms.date: 11/04/2016 f1_keywords: ["C4956"] helpviewer_keywords: ["C4956"] -ms.assetid: 9154f2d1-d49f-4e07-90d2-0e9bc028011a --- # Compiler Warning C4956 @@ -20,7 +19,7 @@ This warning is issued as an error and can be disabled with the [warning](../../ ## Example -The following sample generates C4956: +The following example generates C4956: ```cpp // C4956.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4957.md b/docs/error-messages/compiler-warnings/compiler-warning-c4957.md index 762111b68af..cf4900c21d3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4957.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4957.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4957" title: "Compiler Warning C4957" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4957" +ms.date: 11/04/2016 f1_keywords: ["C4957"] helpviewer_keywords: ["C4957"] -ms.assetid: a18c52d4-23e2-44f1-b4b5-f7fa5a7f3987 --- # Compiler Warning C4957 @@ -24,7 +23,7 @@ This warning is issued as an error and can be disabled with the [warning](../../ ## Example -The following sample generates C4957: +The following example generates C4957: ```cpp // C4957.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4958.md b/docs/error-messages/compiler-warnings/compiler-warning-c4958.md index dffd446ceec..5f8f2fd50c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4958.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4958.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4958" title: "Compiler Warning C4958" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4958" +ms.date: 11/04/2016 f1_keywords: ["C4958"] helpviewer_keywords: ["C4958"] -ms.assetid: e79b9e9c-d572-4a3a-a3b6-60962b70864a --- # Compiler Warning C4958 @@ -20,9 +19,9 @@ The **/clr:safe** compiler option is deprecated in Visual Studio 2015 and unsupp This warning is issued as an error and can be disabled with the [warning](../../preprocessor/warning.md) pragma or the [/wd](../../build/reference/compiler-option-warning-level.md) compiler option. -## Example +## Examples -The following sample generates C4958: +The following example generates C4958: ```cpp // C4958.cpp @@ -39,7 +38,7 @@ int main( ) { The compiler implements array operations with pointer arithmetic. Therefore, native arrays are not verifiable; use a CLR array instead. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). -The following sample generates C4958: +The following example generates C4958: ```cpp // C4958b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4959.md b/docs/error-messages/compiler-warnings/compiler-warning-c4959.md index f1ac31d8d2e..98be05f3e47 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4959.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4959.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4959" title: "Compiler Warning C4959" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4959" +ms.date: 11/04/2016 f1_keywords: ["C4959"] helpviewer_keywords: ["C4959"] -ms.assetid: 3a128f3e-4d8a-4565-ba1a-5d32fdeb5982 --- # Compiler Warning C4959 @@ -22,7 +21,7 @@ This warning is issued as an error and can be disabled with the [warning](../../ ## Example -The following sample generates C4959: +The following example generates C4959: ```cpp // C4959.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4961.md b/docs/error-messages/compiler-warnings/compiler-warning-c4961.md index 59298487148..19f28ac5064 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4961.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4961.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning C4961" title: "Compiler Warning C4961" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4961" +ms.date: 11/04/2016 f1_keywords: ["C4961"] helpviewer_keywords: ["C4961"] -ms.assetid: fe22d99f-5a12-45d3-a7cf-867773a71e16 --- # Compiler Warning C4961 -No profile data was merged into '.pgd file', profile-guided optimizations disabled +> No profile data was merged into '.pgd file', profile-guided optimizations disabled + +## Remarks No profile data (.pgc files) were available, so profile-guided optimizations cannot take place. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4962.md b/docs/error-messages/compiler-warnings/compiler-warning-c4962.md index 3a1468d7299..68e7379ebe0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4962.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4962.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4962" title: "Compiler Warning C4962" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4962" +ms.date: 11/04/2016 f1_keywords: ["C4962"] helpviewer_keywords: ["C4962"] -ms.assetid: 62b156fe-04e5-4a6e-9339-6ab148185f87 --- # Compiler Warning C4962 -'function' : Profile-guided optimizations disabled because optimizations caused profile data to become inconsistent" +> 'function' : Profile-guided optimizations disabled because optimizations caused profile data to become inconsistent" + +## Remarks A function was not compiled with /LTCG:PGO, because count (profile) data for the function was unreliable. Redo profiling to regenerate the .pgc file that contains the unreliable profile data for that function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4972.md b/docs/error-messages/compiler-warnings/compiler-warning-c4972.md index 95e783ed6a2..b115d03e149 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4972.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4972.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4972" title: "Compiler Warning C4972" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4972" +ms.date: 11/04/2016 f1_keywords: ["C4972"] helpviewer_keywords: ["C4972"] -ms.assetid: d18e8e65-b2ef-4d75-a207-fbd0c17c9060 --- # Compiler Warning C4972 -Directly modifying or treating the result of an unbox operation as an lvalue is unverifiable +> Directly modifying or treating the result of an unbox operation as an lvalue is unverifiable + +## Remarks Dereferencing a handle to a value type, also known as unboxing, and then assigning to it is not verifiable. @@ -16,7 +17,7 @@ For more information, see [Boxing](../../extensions/boxing-cpp-component-extensi ## Example -The following sample generates C4972. +The following example generates C4972. ```cpp // C4972.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4984.md b/docs/error-messages/compiler-warnings/compiler-warning-c4984.md index 6fb4984b33d..c30dbf85bd3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4984.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4984.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning C4984" title: "Compiler Warning C4984" -ms.date: "08/19/2019" +description: "Learn more about: Compiler Warning C4984" +ms.date: 08/19/2019 f1_keywords: ["C4984"] helpviewer_keywords: ["C4984"] --- @@ -19,7 +19,7 @@ This warning is available starting in Visual Studio 2017 version 15.3. For infor ## Example -This sample generates C4984, and shows ways to fix it: +This example generates C4984, and shows ways to fix it: ```cpp // C4984.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4986.md b/docs/error-messages/compiler-warnings/compiler-warning-c4986.md index 7cb4e24c1de..975f37ff915 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4986.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4986.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning C4986" title: "Compiler Warning C4986" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4986" +ms.date: 11/04/2016 f1_keywords: ["C4986"] helpviewer_keywords: ["C4986"] -ms.assetid: a3a7b008-29dd-4203-85f3-7740ab6790bb --- # Compiler Warning C4986 -'function': exception specification does not match previous declaration +> 'function': exception specification does not match previous declaration + +## Remarks This warning can be generated when there is an exception specification in one declaration and not the other. By default, C4986 is off. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -## Examples +## Example -The following sample generates C4986. +The following example generates C4986. ```cpp class X { }; @@ -28,7 +29,7 @@ void f1() } ``` -The following sample eliminates this warning. +The following example eliminates this warning. ```cpp class X { }; diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4949.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4949.md index 896988405d4..e4dd9831b20 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4949.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4949.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4949" title: "Compiler Warning (level 1 and level 4) C4949" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4949" +ms.date: 11/04/2016 f1_keywords: ["C4949"] helpviewer_keywords: ["C4949"] -ms.assetid: 34f45a05-c115-49cb-9f67-0bd4f0735d9b --- # Compiler Warning (level 1 and level 4) C4949 -pragmas 'managed' and 'unmanaged' are meaningful only when compiled with '/clr[:option]' +> pragmas 'managed' and 'unmanaged' are meaningful only when compiled with '/clr[:option]' + +## Remarks The compiler ignores the [managed](../../preprocessor/managed-unmanaged.md) and unmanaged pragmas if the source code is not compiled with [/clr](../../build/reference/clr-common-language-runtime-compilation.md). This warning is informational. -The following sample generates C4949: +## Example + +The following example generates C4949: ```cpp // C4949.cpp @@ -22,7 +25,7 @@ The following sample generates C4949: When **#pragma unmanaged** is used without **/clr**, C4949 is a level 4 warning. -The following sample generates C4949: +The following example generates C4949: ```cpp // C4949b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4944.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4944.md index ab27de2d54f..6d314e924af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4944.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4944.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4944" title: "Compiler Warning (level 1) C4944" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4944" +ms.date: 11/04/2016 f1_keywords: ["C4944"] helpviewer_keywords: ["C4944"] -ms.assetid: e2905eb1-2e3b-4fab-a48b-c0cae0fd997f --- # Compiler Warning (level 1) C4944 -'symbol' : cannot import symbol from 'assembly1': as 'symbol' already exists in the current scope +> 'symbol' : cannot import symbol from 'assembly1': as 'symbol' already exists in the current scope + +## Remarks A symbol was defined in a source code file and then a #using statement referenced an assembly that also defined the symbol. The symbol in the assembly is ignored. -## Examples +## Example -The following sample creates a component with a type called ClassA. +The following example creates a component with a type called ClassA. ```csharp // C4944.cs @@ -25,7 +26,7 @@ public class ClassA { } ``` -The following samples generate C4944. +The following example generate C4944. ```cpp // C4944b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4945.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4945.md index 501700a2582..8b96288228f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4945.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4945.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4945" title: "Compiler Warning (level 1) C4945" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4945" +ms.date: 11/04/2016 f1_keywords: ["C4945"] helpviewer_keywords: ["C4945"] -ms.assetid: 6d2079ea-dc59-4611-bc68-9a22c06f7587 --- # Compiler Warning (level 1) C4945 -'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1' +> 'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1' + +## Remarks A symbol was imported from a referenced assembly but that symbol was already imported from another referenced assembly. Either do not reference one of the assemblies or get the symbol name changed in one of the assemblies. -The following samples generate C4945. +## Example + +The following example generate C4945. ```csharp // C4945a.cs diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4946.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4946.md index 2ef397abc1c..284b2424ac7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4946.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4946.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4946" title: "Compiler Warning (level 1) C4946" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4946" +ms.date: 11/04/2016 f1_keywords: ["C4946"] helpviewer_keywords: ["C4946"] -ms.assetid: b85cbef0-e053-4de6-9b14-7b0f82d40495 --- # Compiler Warning (level 1) C4946 -reinterpret_cast used between related classes: 'class1' and 'class2' +> reinterpret_cast used between related classes: 'class1' and 'class2' + +## Remarks Do not use [reinterpret_cast](../../cpp/reinterpret-cast-operator.md) to cast between related types. Use [static_cast](../../cpp/static-cast-operator.md) instead, or for polymorphic types, use [dynamic_cast](../../cpp/dynamic-cast-operator.md). By default, this warning is off. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). +## Example + The following code example generates C4946: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4947.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4947.md index 84cfafa4c9c..db09f0cf6ad 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4947.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4947.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4947" title: "Compiler Warning (level 1) C4947" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4947" +ms.date: 11/04/2016 f1_keywords: ["C4947"] helpviewer_keywords: ["C4947"] -ms.assetid: 5a1d484e-b4c7-4de2-a145-d8dcfc2fc1d2 --- # Compiler Warning (level 1) C4947 -'type_or_member' : marked as obsolete +> 'type_or_member' : marked as obsolete + +## Remarks A member or type was marked as obsolete with the class. ## Example -The following sample generates C4947: +The following example generates C4947: ```cpp // C4947.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4951.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4951.md index ed00316f198..a9b0be26170 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4951.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4951.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4951" title: "Compiler Warning (level 1) C4951" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4951" +ms.date: 08/27/2018 f1_keywords: ["C4951"] helpviewer_keywords: ["C4951"] -ms.assetid: 669d8bb7-5efa-4ba9-99db-4e65addbf054 --- # Compiler Warning (level 1) C4951 > '*function*' has been edited since profile data was collected, function profile data not used +## Remarks + A function has been edited in an input module to [/LTCG:PGUPDATE](../../build/reference/ltcg-link-time-code-generation.md), so that the profile data is now not valid. The input module was recompiled after **/LTCG:PGINSTRUMENT** and has a function (*function*) with a different flow of control than was in the module at the time of the **/LTCG:PGINSTRUMENT** operation. This warning is informational. To resolve this warning, run **/LTCG:PGINSTRUMENT**, redo all test runs, and run **/LTCG:PGOPTIMIZE**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4952.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4952.md index 5ad02204e02..fbf7a1a79f8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4952.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4952.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4952" title: "Compiler Warning (level 1) C4952" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4952" +ms.date: 08/27/2018 f1_keywords: ["C4952"] helpviewer_keywords: ["C4952"] -ms.assetid: 593324f0-5cfe-42fb-b221-2f71308765dd --- # Compiler Warning (level 1) C4952 > '*function*' : no profile data found in program database '*pgd_file*' +## Remarks + When using [/LTCG:PGUPDATE](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected an input module that was recompiled after `/LTCG:PGINSTRUMENT` and has a new function (*function*) present. This warning is informational. To resolve this warning, run `/LTCG:PGINSTRUMENT`, redo all test runs, and run `/LTCG:PGOPTIMIZE`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4953.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4953.md index 4f6f49e7184..4fb025030e8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4953.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4953.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4953" title: "Compiler Warning (level 1) C4953" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4953" +ms.date: 08/27/2018 f1_keywords: ["C4953"] helpviewer_keywords: ["C4953"] -ms.assetid: 3c4f6ac6-3976-41ab-8a27-3c41d7472ea7 --- # Compiler Warning (level 1) C4953 > Inlinee '*function*' has been edited since profile data was collected, profile data not used +## Remarks + When using [/LTCG:PGUPDATE](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected an input module that was recompiled after `/LTCG:PGINSTRUMENT` and has a function (*function*) that was edited and where existing test runs identified the function as a candidate for inlining. However, as a result of recompiling the module, the function will no longer be a candidate for inlining. This warning is informational. To resolve this warning, run `/LTCG:PGINSTRUMENT`, redo all test runs, and run `/LTCG:PGOPTIMIZE`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4964.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4964.md index e97a33d9184..9eb7097fa26 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4964.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4964.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4964" title: "Compiler Warning (level 1) C4964" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4964" +ms.date: 11/04/2016 f1_keywords: ["C4964"] helpviewer_keywords: ["C4964"] -ms.assetid: b89c9274-8a92-4b7c-aa30-3fbb1b68ac73 --- # Compiler Warning (level 1) C4964 -No optimization options were specified; profile info will not be collected +> No optimization options were specified; profile info will not be collected + +## Remarks [/GL](../../build/reference/gl-whole-program-optimization.md) and [/LTCG](../../build/reference/ltcg-link-time-code-generation.md) were specified, but no optimizations were requested, so no .pgc files will be generated and, therefore, no profile-guided optimizations will be possible. If you want .pgc files to be generated when you run your application, specify one of the [/O](../../build/reference/o-options-optimize-code.md) compiler options. -The following sample generates C4964: +## Example + +The following example generates C4964: ```cpp // C4964.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4965.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4965.md index b7f9f1365af..384ae158bc3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4965.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4965.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4965" title: "Compiler Warning (level 1) C4965" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4965" +ms.date: 11/04/2016 f1_keywords: ["C4965"] helpviewer_keywords: ["C4965"] -ms.assetid: 47f3f6dc-459b-4a25-9947-f394c8966cb5 --- # Compiler Warning (level 1) C4965 -implicit box of integer 0; use nullptr or explicit cast +> implicit box of integer 0; use nullptr or explicit cast + +## Remarks Visual C++ features implicit boxing of value types. An instruction that resulted in a null assignment using Managed Extensions for C++ now becomes an assignment to a boxed int. @@ -16,7 +17,7 @@ For more information, see [Boxing](../../extensions/boxing-cpp-component-extensi ## Example -The following sample generates C4965. +The following example generates C4965. ```cpp // C4965.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4997.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4997.md index 22694be7d30..2741b6f61ef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4997.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4997.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4997" title: "Compiler Warning (level 1) C4997" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4997" +ms.date: 11/04/2016 f1_keywords: ["C4997"] helpviewer_keywords: ["C4997"] -ms.assetid: d39678fd-0c1a-4104-8a45-9e3f20de0407 --- # Compiler Warning (level 1) C4997 -'class': coclass does not implement a COM interface or pseudo-interface +> 'class': coclass does not implement a COM interface or pseudo-interface + +## Remarks A class marked with the [coclass](../../windows/attributes/coclass.md) attribute did not implement an interface. -The following sample generates C4997: +## Example + +The following example generates C4997: ```cpp // C4997.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4948.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4948.md index 26347529fbf..0fb05310069 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4948.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4948.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4948" title: "Compiler Warning (level 2) C4948" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4948" +ms.date: 11/04/2016 f1_keywords: ["C4948"] helpviewer_keywords: ["C4948"] -ms.assetid: d006cb17-754a-4c70-ba7f-c3200e2cd8fa --- # Compiler Warning (level 2) C4948 -return type of 'accessor' does not match the last parameter type of the corresponding setter +> return type of 'accessor' does not match the last parameter type of the corresponding setter + +## Remarks The compiler found a mismatch between what data type is being get and set for an indexed property. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4995.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4995.md index a753799357c..76e0eb019a0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4995.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4995.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4995" title: "Compiler Warning (level 3) C4995" +description: "Learn more about: Compiler Warning (level 3) C4995" ms.date: 08/30/2022 f1_keywords: ["C4995"] helpviewer_keywords: ["C4995"] -ms.assetid: c6b61755-4730-4947-ad4d-d1c2bc82585a --- # Compiler Warning (level 3) C4995 @@ -18,7 +17,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example -The following sample generates C4995. Uncomment the `#pragma warning` line to disable the warning. +The following example generates C4995. Uncomment the `#pragma warning` line to disable the warning. ```cpp // C4995.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4996.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4996.md index db12f3841f9..2180d283941 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4996.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4996.md @@ -4,7 +4,6 @@ description: "Explains why Compiler warning C4996 happens, and describes what to ms.date: 08/30/2022 f1_keywords: ["C4996"] helpviewer_keywords: ["C4996"] -ms.assetid: 926c7cc2-921d-43ed-ae75-634f560dd317 --- # Compiler Warning (level 3) C4996 @@ -63,7 +62,7 @@ Here are some of the common sources of C4996 warnings and errors: ## POSIX function names -**`The POSIX name for this item is deprecated. Instead, use the ISO C and C++ conformant name:`** _`new-name.`_ **`See online help for details.`** +> The POSIX name for this item is deprecated. Instead, use the ISO C and C++ conformant name: *`new-name`*. See online help for details. Microsoft renamed some POSIX and Microsoft-specific library functions in the CRT to conform with C99 and C++03 constraints on reserved and global implementation-defined names. *Only the names are deprecated, not the functions themselves*. In most cases, a leading underscore was added to the function name to create a conforming name. The compiler issues a deprecation warning for the original function name, and suggests the preferred name. @@ -73,7 +72,7 @@ To turn off deprecation warnings for these functions, define the preprocessor ma ## Unsafe CRT Library functions -**`This function or variable may be unsafe. Consider using`** _`safe-version`_ **`instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. See online help for details.`** +> This function or variable may be unsafe. Consider using *`safe-version`* instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. See online help for details. Microsoft deprecated some CRT and C++ Standard Library functions and globals because more secure versions are available. Most of the deprecated functions allow unchecked read or write access to buffers. Their misuse can lead to serious security issues. The compiler issues a deprecation warning for these functions, and suggests the preferred function. @@ -87,7 +86,7 @@ For more information about these deprecated functions and globals, see [Security ## Unsafe Standard Library functions -**`'std::`** *`function_name`* **`::_Unchecked_iterators::_Deprecate' Call to std::`** *`function_name`* **`with parameters that may be unsafe - this call relies on the caller to check that the passed values are correct. To disable this warning, use -D_SCL_SECURE_NO_WARNINGS. See documentation on how to use Visual C++ 'Checked Iterators'`** +> 'std:: *`function_name`* ::_Unchecked_iterators::_Deprecate' Call to std:: *`function_name`* with parameters that may be unsafe - this call relies on the caller to check that the passed values are correct. To disable this warning, use -D_SCL_SECURE_NO_WARNINGS. See documentation on how to use Visual C++ 'Checked Iterators' In Visual Studio 2015, this warning appears in debug builds because certain C++ Standard Library function templates don't check parameters for correctness. Often it's because not enough information is available to the function to check container bounds. Or, because iterators may be used incorrectly with the function. This warning helps you identify these functions, because they may be a source of serious security holes in your program. For more information, see [Checked iterators](../../standard-library/checked-iterators.md). @@ -248,7 +247,7 @@ For information on how to suppress these warnings, see [`_AFX_SECURE_NO_WARNINGS ## Obsolete CRT functions and variables -**`This function or variable has been superseded by newer library or operating system functionality. Consider using`** *`new_item`* **`instead. See online help for details.`** +> This function or variable has been superseded by newer library or operating system functionality. Consider using *`new_item`* instead. See online help for details. Some library functions and global variables are deprecated as obsolete. These functions and variables may be removed in a future version of the library. The compiler issues a deprecation warning for these items, and suggests the preferred alternative. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4960.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4960.md index b2cef66503f..fb44b5e555c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4960.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4960.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4960" title: "Compiler Warning (level 4) C4960" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4960" +ms.date: 11/04/2016 f1_keywords: ["C4960"] helpviewer_keywords: ["C4960"] -ms.assetid: 3b4ed286-9e8d-46f1-af0c-00ba669693a9 --- # Compiler Warning (level 4) C4960 -'function' is too big to be profiled +> 'function' is too big to be profiled + +## Remarks When using [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected an input module with a function larger than 65,535 instructions. Such a large function is not available for profile-guided optimizations. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4985.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4985.md index c073d5dd2cd..4be7325fba3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4985.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4985.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4985" title: "Compiler Warning (level 4) C4985" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4985" +ms.date: 11/04/2016 f1_keywords: ["C4985"] helpviewer_keywords: ["C4985"] -ms.assetid: 832f001c-afe7-403d-a8b4-02334724c79e --- # Compiler Warning (level 4) C4985 > '*symbol-name*': attributes not present on previous declaration. +## Remarks + The Microsoft source code annotation language (SAL) annotations on the current method declaration or definition differ from the annotations on an earlier declaration. The same SAL annotations must be used in the definition and declarations of a method. The SAL provides a set of annotations that you can use to describe how a function uses its parameters, the assumptions it makes about them, and the guarantees it makes on finishing. The annotations are defined in the sal.h header file. From 69451a230e2dc903735f043a185d6072524de7fe Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 5 Sep 2025 14:52:56 -0700 Subject: [PATCH 1104/1799] simplify glob pattern syntax --- docs/docfx.json | 262 ++++++++++++++++++++++++++++++++---------------- 1 file changed, 175 insertions(+), 87 deletions(-) diff --git a/docs/docfx.json b/docs/docfx.json index 871ff2d1351..6e115ab361d 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -160,100 +160,188 @@ "windows/**.md": "windows-development" }, "ms.update-cycle": { - "assembler/**/**.{md,yml}": "3650-days", - "attributes/**/**.{md,yml}": "3650-days", - "atl/**/**.{md,yml}": "3650-days", - "atl-mfc-shared/**/**.{md,yml}": "3650-days", - "build/**/**.{md,yml}": "1825-days", - "c-language/**/**.{md,yml}": "3650-days", - "c-runtime-library/**/**.{md,yml}": "3650-days", + "assembler/**.md": "3650-days", + "assembler/**.yml": "3650-days", + "attributes/**.md": "3650-days", + "attributes/**.yml": "3650-days", + "atl/**.md": "3650-days", + "atl/**.yml": "3650-days", + "atl-mfc-shared/**.md": "3650-days", + "atl-mfc-shared/**.yml": "3650-days", + "build/**.md": "1825-days", + "build/**.yml": "1825-days", + "c-language/**.md": "3650-days", + "c-language/**.yml": "3650-days", + "c-runtime-library/**.md": "3650-days", + "c-runtime-library/**.yml": "3650-days", "cpp/**.md": "1095-days", - "cppcx/**/**.{md,yml}": "3650-days", - "cross-platform/**/**.{md,yml}": "1825-days", - "data/**/**.{md,yml}": "3650-days", - "dotnet/**/**.{md,yml}": "3650-days", - "embedded/**/**.{md,yml}": "3650-days", - "error-messages/**/**.{md,yml}": "3650-days", - "extensions/**/**.{md,yml}": "3650-days", - "intrinsics/**/**.{md,yml}": "3650-days", - "mfc/**/**.{md,yml}": "3650-days", - "parallel/**/**.{md,yml}": "3650-days", - "porting/**/**.{md,yml}": "1095-days", - "preprocessor/**/**.{md,yml}": "3650-days", - "safeint/**/**.{md,yml}": "3650-days", - "standard-library/**/**.{md,yml}": "3650-days", - "text/**/**.{md,yml}": "3650-days", - "windows/**/**.{md,yml}": "1825-days" + "cpp/**.yml": "1095-days", + "cppcx/**.md": "3650-days", + "cppcx/**.yml": "3650-days", + "cross-platform/**.md": "1825-days", + "cross-platform/**.yml": "1825-days", + "data/**.md": "3650-days", + "data/**.yml": "3650-days", + "dotnet/**.md": "3650-days", + "dotnet/**.yml": "3650-days", + "embedded/**.md": "3650-days", + "embedded/**.yml": "3650-days", + "error-messages/**.md": "3650-days", + "error-messages/**.yml": "3650-days", + "extensions/**.md": "3650-days", + "extensions/**.yml": "3650-days", + "intrinsics/**.md": "3650-days", + "intrinsics/**.yml": "3650-days", + "mfc/**.md": "3650-days", + "mfc/**.yml": "3650-days", + "parallel/**.md": "3650-days", + "parallel/**.yml": "3650-days", + "porting/**.md": "1095-days", + "porting/**.yml": "1095-days", + "preprocessor/**.md": "3650-days", + "preprocessor/**.yml": "3650-days", + "safeint/**.md": "3650-days", + "safeint/**.yml": "3650-days", + "standard-library/**.md": "3650-days", + "standard-library/**.yml": "3650-days", + "text/**.md": "3650-days", + "text/**.yml": "3650-days", + "windows/**.md": "1825-days" + "windows/**.yml": "1825-days" }, "author": { "index.md": "TylerMSFT", - "assembler/**/**.{md,yml}": "TylerMSFT", - "attributes/**/**.{md,yml}": "TylerMSFT", - "atl/**/**.{md,yml}": "TylerMSFT", - "atl-mfc-shared/**/**.{md,yml}": "TylerMSFT", - "build/**/**.{md,yml}": "TylerMSFT", - "build-insights/**/**.{md,yml}": "TylerMSFT", - "c-language/**/**.{md,yml}": "TylerMSFT", - "c-runtime-library/**/**.{md,yml}": "TylerMSFT", - "cloud/**/**.{md,yml}": "TylerMSFT", - "code-quality/**/**.{md,yml}": "TylerMSFT", - "cpp/**/**.{md,yml}": "TylerMSFT", - "cppcx/**/**.{md,yml}": "TylerMSFT", - "cross-platform/**/**.{md,yml}": "TylerMSFT", - "data/**/**.{md,yml}": "TylerMSFT", - "dotnet/**/**.{md,yml}": "TylerMSFT", - "error-messages/**/**.{md,yml}": "TylerMSFT", - "extensions/**/**.{md,yml}": "TylerMSFT", - "get-started/**/**.{md,yml}": "TylerMSFT", - "ide/**/**.{md,yml}": "TylerMSFT", - "intrinsics/**/**.{md,yml}": "TylerMSFT", - "linux/**/**.{md,yml}": "TylerMSFT", - "mfc/**/**.{md,yml}": "TylerMSFT", - "overview/**/**.{md,yml}": "TylerMSFT", - "parallel/**/**.{md,yml}": "TylerMSFT", - "porting/**/**.{md,yml}": "TylerMSFT", - "preprocessor/**/**.{md,yml}": "TylerMSFT", - "safeint/**/**.{md,yml}": "TylerMSFT", - "sanitizers/**/**.{md,yml}": "TylerMSFT", - "security/**/**.{md,yml}": "TylerMSFT", - "standard-library/**/**.{md,yml}": "TylerMSFT", - "text/**/**.{md,yml}": "TylerMSFT", - "windows/**/**.{md,yml}": "TylerMSFT" + "assembler/**.md": "TylerMSFT", + "assembler/**.yml": "TylerMSFT", + "attributes/**.md": "TylerMSFT", + "attributes/**.yml": "TylerMSFT", + "atl/**.md": "TylerMSFT", + "atl/**.yml": "TylerMSFT", + "atl-mfc-shared/**.md": "TylerMSFT", + "atl-mfc-shared/**.yml": "TylerMSFT", + "build/**.md": "TylerMSFT", + "build/**.yml": "TylerMSFT", + "build-insights/**.md": "TylerMSFT", + "build-insights/**.yml": "TylerMSFT", + "c-language/**.md": "TylerMSFT", + "c-language/**.yml": "TylerMSFT", + "c-runtime-library/**.md": "TylerMSFT", + "c-runtime-library/**.yml": "TylerMSFT", + "cloud/**.md": "TylerMSFT", + "cloud/**.yml": "TylerMSFT", + "code-quality/**.md": "TylerMSFT", + "code-quality/**.yml": "TylerMSFT", + "cpp/**.md": "TylerMSFT", + "cpp/**.yml": "TylerMSFT", + "cppcx/**.md": "TylerMSFT", + "cppcx/**.yml": "TylerMSFT", + "cross-platform/**.md": "TylerMSFT", + "cross-platform/**.yml": "TylerMSFT", + "data/**.md": "TylerMSFT", + "data/**.yml": "TylerMSFT", + "dotnet/**.md": "TylerMSFT", + "dotnet/**.yml": "TylerMSFT", + "error-messages/**.md": "TylerMSFT", + "error-messages/**.yml": "TylerMSFT", + "extensions/**.md": "TylerMSFT", + "extensions/**.yml": "TylerMSFT", + "get-started/**.md": "TylerMSFT", + "get-started/**.yml": "TylerMSFT", + "ide/**.md": "TylerMSFT", + "ide/**.yml": "TylerMSFT", + "intrinsics/**.md": "TylerMSFT", + "intrinsics/**.yml": "TylerMSFT", + "linux/**.md": "TylerMSFT", + "linux/**.yml": "TylerMSFT", + "mfc/**.md": "TylerMSFT", + "mfc/**.yml": "TylerMSFT", + "overview/**.md": "TylerMSFT", + "overview/**.yml": "TylerMSFT", + "parallel/**.md": "TylerMSFT", + "parallel/**.yml": "TylerMSFT", + "porting/**.md": "TylerMSFT", + "porting/**.yml": "TylerMSFT", + "preprocessor/**.md": "TylerMSFT", + "preprocessor/**.yml": "TylerMSFT", + "safeint/**.md": "TylerMSFT", + "safeint/**.yml": "TylerMSFT", + "sanitizers/**.md": "TylerMSFT", + "sanitizers/**.yml": "TylerMSFT", + "security/**.md": "TylerMSFT", + "security/**.yml": "TylerMSFT", + "standard-library/**.md": "TylerMSFT", + "standard-library/**.yml": "TylerMSFT", + "text/**.md": "TylerMSFT", + "text/**.yml": "TylerMSFT", + "windows/**.md": "TylerMSFT" + "windows/**.yml": "TylerMSFT" }, "ms.author": { "index.md": "twhitney", - "assembler/**/**.{md,yml}": "twhitney", - "atl/**/**.{md,yml}": "twhitney", - "atl-mfc-shared/**/**.{md,yml}": "twhitney", - "attributes/**/**.{md,yml}": "twhitney", - "build/**/**.{md,yml}": "twhitney", - "build-insights/**/**.{md,yml}": "twhitney", - "c-language/**/**.{md,yml}": "twhitney", - "c-runtime-library/**/**.{md,yml}": "twhitney", - "cloud/**/**.{md,yml}": "twhitney", - "code-quality/**/**.{md,yml}": "twhitney", - "cpp/**/**.{md,yml}": "twhitney", - "cppcx/**/**.{md,yml}": "twhitney", - "cross-platform/**/**.{md,yml}": "twhitney", - "data/**/**.{md,yml}": "twhitney", - "dotnet/**/**.{md,yml}": "twhitney", - "error-messages/**/**.{md,yml}": "twhitney", - "extensions/**/**.{md,yml}": "twhitney", - "get-started/**/**.{md,yml}": "twhitney", - "ide/**/**.{md,yml}": "twhitney", - "intrinsics/**/**.{md,yml}": "twhitney", - "linux/**/**.{md,yml}": "twhitney", - "mfc/**/**.{md,yml}": "twhitney", - "overview/**/**.{md,yml}": "twhitney", - "parallel/**/**.{md,yml}": "twhitney", - "porting/**/**.{md,yml}": "twhitney", - "preprocessor/**/**.{md,yml}": "twhitney", - "safeint/**/**.{md,yml}": "twhitney", - "sanitizers/**/**.{md,yml}": "twhitney", - "security/**/**.{md,yml}": "twhitney", - "standard-library/**/**.{md,yml}": "twhitney", - "text/**/**.{md,yml}": "twhitney", - "windows/**/**.{md,yml}": "twhitney" + "assembler/**.md": "twhitney", + "assembler/**.yml": "twhitney", + "atl/**.md": "twhitney", + "atl/**.yml": "twhitney", + "atl-mfc-shared/**.md": "twhitney", + "atl-mfc-shared/**.yml": "twhitney", + "attributes/**.md": "twhitney", + "attributes/**.yml": "twhitney", + "build/**.md": "twhitney", + "build/**.yml": "twhitney", + "build-insights/**.md": "twhitney", + "build-insights/**.yml": "twhitney", + "c-language/**.md": "twhitney", + "c-language/**.yml": "twhitney", + "c-runtime-library/**.md": "twhitney", + "c-runtime-library/**.yml": "twhitney", + "cloud/**.md": "twhitney", + "cloud/**.yml": "twhitney", + "code-quality/**.md": "twhitney", + "code-quality/**.yml": "twhitney", + "cpp/**.md": "twhitney", + "cpp/**.yml": "twhitney", + "cppcx/**.md": "twhitney", + "cppcx/**.yml": "twhitney", + "cross-platform/**.md": "twhitney", + "cross-platform/**.yml": "twhitney", + "data/**.md": "twhitney", + "data/**.yml": "twhitney", + "dotnet/**.md": "twhitney", + "dotnet/**.yml": "twhitney", + "error-messages/**.md": "twhitney", + "error-messages/**.yml": "twhitney", + "extensions/**.md": "twhitney", + "extensions/**.yml": "twhitney", + "get-started/**.md": "twhitney", + "get-started/**.yml": "twhitney", + "ide/**.md": "twhitney", + "ide/**.yml": "twhitney", + "intrinsics/**.md": "twhitney", + "intrinsics/**.yml": "twhitney", + "linux/**.md": "twhitney", + "linux/**.yml": "twhitney", + "mfc/**.md": "twhitney", + "mfc/**.yml": "twhitney", + "overview/**.md": "twhitney", + "overview/**.yml": "twhitney", + "parallel/**.md": "twhitney", + "parallel/**.yml": "twhitney", + "porting/**.md": "twhitney", + "porting/**.yml": "twhitney", + "preprocessor/**.md": "twhitney", + "preprocessor/**.yml": "twhitney", + "safeint/**.md": "twhitney", + "safeint/**.yml": "twhitney", + "sanitizers/**.md": "twhitney", + "sanitizers/**.yml": "twhitney", + "security/**.md": "twhitney", + "security/**.yml": "twhitney", + "standard-library/**.md": "twhitney", + "standard-library/**.yml": "twhitney", + "text/**.md": "twhitney", + "text/**.yml": "twhitney", + "windows/**.md": "twhitney" + "windows/**.yml": "twhitney" } }, "template": [], From 867f69bf19e2b8b3f10ed3422a54172e5bfccaa0 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 5 Sep 2025 15:07:42 -0700 Subject: [PATCH 1105/1799] fix syntax error --- docs/docfx.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docfx.json b/docs/docfx.json index 6e115ab361d..5fa9b75f885 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -206,7 +206,7 @@ "standard-library/**.yml": "3650-days", "text/**.md": "3650-days", "text/**.yml": "3650-days", - "windows/**.md": "1825-days" + "windows/**.md": "1825-days", "windows/**.yml": "1825-days" }, "author": { From 4898b03cf7ed33d4c41583e8555dac33327b8057 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 5 Sep 2025 15:40:41 -0700 Subject: [PATCH 1106/1799] fix syntax --- docs/docfx.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docfx.json b/docs/docfx.json index 5fa9b75f885..654d0bf2f11 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -273,7 +273,7 @@ "standard-library/**.yml": "TylerMSFT", "text/**.md": "TylerMSFT", "text/**.yml": "TylerMSFT", - "windows/**.md": "TylerMSFT" + "windows/**.md": "TylerMSFT", "windows/**.yml": "TylerMSFT" }, "ms.author": { From 3c75a0216022a1c3b882868c051212136c945b02 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 5 Sep 2025 15:50:23 -0700 Subject: [PATCH 1107/1799] syntax --- docs/docfx.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/docfx.json b/docs/docfx.json index 654d0bf2f11..e3765f2f722 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -175,7 +175,7 @@ "c-runtime-library/**.md": "3650-days", "c-runtime-library/**.yml": "3650-days", "cpp/**.md": "1095-days", - "cpp/**.yml": "1095-days", + "cpp/**.yml": "1095-days", "cppcx/**.md": "3650-days", "cppcx/**.yml": "3650-days", "cross-platform/**.md": "1825-days", @@ -340,7 +340,7 @@ "standard-library/**.yml": "twhitney", "text/**.md": "twhitney", "text/**.yml": "twhitney", - "windows/**.md": "twhitney" + "windows/**.md": "twhitney", "windows/**.yml": "twhitney" } }, From bb2e2e9824ae6929df1476903ffbe71e5852a2e9 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 18:25:49 +0800 Subject: [PATCH 1108/1799] Convert `(/cpp` links to relative --- docs/build/arm64-windows-abi-conventions.md | 2 +- docs/c-runtime-library/crt-debugging-techniques.md | 2 +- docs/cpp/char-wchar-t-char16-t-char32-t.md | 4 ++-- docs/cpp/transporting-exceptions-between-threads.md | 2 +- .../compiler-warnings/compiler-warning-c5072.md | 6 +++--- docs/windows/attributes/cpp-attributes-com-net.md | 4 ++-- docs/windows/redist-version-auditing.md | 2 +- 7 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/build/arm64-windows-abi-conventions.md b/docs/build/arm64-windows-abi-conventions.md index db01bfefe2b..0b6f68bea01 100644 --- a/docs/build/arm64-windows-abi-conventions.md +++ b/docs/build/arm64-windows-abi-conventions.md @@ -123,7 +123,7 @@ To determine if an ARM CPU supports exceptions, write a value that enables excep On ARM64, Windows delivers exceptions for processors that support hardware floating-point exceptions. -The [`_set_controlfp`](/cpp/c-runtime-library/reference/controlfp-s) function on ARM platforms correctly changes the FPCR register when unmasking floating-point exceptions. However, instead of raising an unmasked exception, Windows resets the FPCR register to its defaults every time an FP exception is about to be raised. +The [`_set_controlfp`](../c-runtime-library/reference/controlfp-s.md) function on ARM platforms correctly changes the FPCR register when unmasking floating-point exceptions. However, instead of raising an unmasked exception, Windows resets the FPCR register to its defaults every time an FP exception is about to be raised. ## Parameter passing diff --git a/docs/c-runtime-library/crt-debugging-techniques.md b/docs/c-runtime-library/crt-debugging-techniques.md index 323c0d36b96..df4124e24eb 100644 --- a/docs/c-runtime-library/crt-debugging-techniques.md +++ b/docs/c-runtime-library/crt-debugging-techniques.md @@ -16,7 +16,7 @@ When you debug a program that uses the C run-time library, these debugging techn ## CRT debug library use -The C runtime (CRT) library provides extensive debugging support. To use one of the CRT debug libraries, you must link with [`/DEBUG`](/cpp/build/reference/debug-generate-debug-info) and compile with [`/MDd`, `/MTd`, or `/LDd`](../build/reference/md-mt-ld-use-run-time-library.md). +The C runtime (CRT) library provides extensive debugging support. To use one of the CRT debug libraries, you must link with [`/DEBUG`](../build/reference/debug-generate-debug-info.md) and compile with [`/MDd`, `/MTd`, or `/LDd`](../build/reference/md-mt-ld-use-run-time-library.md). The main definitions and macros for CRT debugging can be found in the `` header file. diff --git a/docs/cpp/char-wchar-t-char16-t-char32-t.md b/docs/cpp/char-wchar-t-char16-t-char32-t.md index 5df11da2668..87e22b70234 100644 --- a/docs/cpp/char-wchar-t-char16-t-char32-t.md +++ b/docs/cpp/char-wchar-t-char16-t-char32-t.md @@ -26,6 +26,6 @@ The **`wchar_t`** type is an implementation-defined wide character type. In the The **`char8_t`**, **`char16_t`**, and **`char32_t`** types represent 8-bit, 16-bit, and 32-bit wide characters, respectively. (**`char8_t`** is new in C++20 and requires the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or **`/std:c++latest`** compiler option.) Unicode encoded as UTF-8 can be stored in the **`char8_t`** type. Strings of **`char8_t`** and **`char`** type are referred to as *narrow* strings, even when used to encode Unicode or multi-byte characters. Unicode encoded as UTF-16 can be stored in the **`char16_t`** type, and Unicode encoded as UTF-32 can be stored in the **`char32_t`** type. Strings of these types and **`wchar_t`** are all referred to as *wide* strings, though the term often refers specifically to strings of **`wchar_t`** type. -In the C++ standard library, the [`basic_string`](/cpp/standard-library/basic-string-class) type is specialized for both narrow and wide strings. Use `std::string` when the characters are of type **`char`**, `std::u8string` when the characters are of type **`char8_t`**, `std::u16string` when the characters are of type **`char16_t`**, `std::u32string` when the characters are of type **`char32_t`**, and `std::wstring` when the characters are of type **`wchar_t`**. +In the C++ standard library, the [`basic_string`](../standard-library/basic-string-class.md) type is specialized for both narrow and wide strings. Use `std::string` when the characters are of type **`char`**, `std::u8string` when the characters are of type **`char8_t`**, `std::u16string` when the characters are of type **`char16_t`**, `std::u32string` when the characters are of type **`char32_t`**, and `std::wstring` when the characters are of type **`wchar_t`**. -Other types that represent text, including [`std::stringstream`](/cpp/standard-library/sstream-typedefs/#stringstream) and [`std::cout`](/cpp/standard-library/iostream#cout) have specializations for narrow and wide strings. +Other types that represent text, including [`std::stringstream`](../standard-library/sstream-typedefs.md#stringstream) and [`std::cout`](../standard-library/iostream.md#cout) have specializations for narrow and wide strings. diff --git a/docs/cpp/transporting-exceptions-between-threads.md b/docs/cpp/transporting-exceptions-between-threads.md index bddcb01e69c..b05544d78bc 100644 --- a/docs/cpp/transporting-exceptions-between-threads.md +++ b/docs/cpp/transporting-exceptions-between-threads.md @@ -65,7 +65,7 @@ For more information about the C++ Standards committee proposal, search the Inte ### Exception-handling models and compiler options -Your application's exception-handling model determines whether it can catch and transport an exception. Visual C++ supports three models for handling C++ exceptions: [ISO-standard C++ exception handling](/cpp/cpp/errors-and-exception-handling-modern-cpp), [structured exception handling (SEH)](/windows/win32/debug/structured-exception-handling), and [common language runtime (CLR) exceptions](/cpp/extensions/exception-handling-cpp-component-extensions). Use the [`/EH`](../build/reference/eh-exception-handling-model.md) and [`/clr`](../build/reference/clr-common-language-runtime-compilation.md) compiler options to specify your application's exception-handling model. +Your application's exception-handling model determines whether it can catch and transport an exception. Visual C++ supports three models for handling C++ exceptions: [ISO-standard C++ exception handling](errors-and-exception-handling-modern-cpp.md), [structured exception handling (SEH)](/windows/win32/debug/structured-exception-handling), and [common language runtime (CLR) exceptions](../extensions/exception-handling-cpp-component-extensions.md). Use the [`/EH`](../build/reference/eh-exception-handling-model.md) and [`/clr`](../build/reference/clr-common-language-runtime-compilation.md) compiler options to specify your application's exception-handling model. Only the following combination of compiler options and programming statements can transport an exception. Other combinations either can't catch exceptions, or can catch but can't transport exceptions. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md index 481bbadd2a5..0ae2c93e6f6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C5072"] ## Remarks -This warning occurs when you compile with [Address Sanitizer](/cpp/sanitizers/asan) (ASAN) turned on, but you don't also instruct the compiler to emit debug info. ASAN uses debug info to provide better diagnostics. +This warning occurs when you compile with [Address Sanitizer](../../sanitizers/asan.md) (ASAN) turned on, but you don't also instruct the compiler to emit debug info. ASAN uses debug info to provide better diagnostics. ## Example @@ -21,8 +21,8 @@ The following command line generates warning `C5072`: cl /fsanitize=address /EHsc test.cpp ``` -To fix it, have the compiler generate debug information by using a switch like [`/Zi`](/cpp/build/reference/z7-zi-zi-debug-information-format#zi) or [`/Z7`](/cpp/build/reference/z7-zi-zi-debug-information-format#z7), like this: `cl /fsanitize=address /EHsc /Zi test.cpp` +To fix it, have the compiler generate debug information by using a switch like [`/Zi`](../../build/reference/z7-zi-zi-debug-information-format.md#zi) or [`/Z7`](../../build/reference/z7-zi-zi-debug-information-format.md#z7), like this: `cl /fsanitize=address /EHsc /Zi test.cpp` ## See also -[Address Sanitizer (ASAN)](/cpp/sanitizers/asan) +[Address Sanitizer (ASAN)](../../sanitizers/asan.md) diff --git a/docs/windows/attributes/cpp-attributes-com-net.md b/docs/windows/attributes/cpp-attributes-com-net.md index 20de95ef00e..d17f7e34554 100644 --- a/docs/windows/attributes/cpp-attributes-com-net.md +++ b/docs/windows/attributes/cpp-attributes-com-net.md @@ -96,11 +96,11 @@ This field lists other attributes that are incompatible with the specified attri ## Debug injected code -Using attributes can greatly simplify C++ programming. For more information, see [Concepts](/cpp/windows/attributed-programming-concepts). Some attributes are interpreted directly by the compiler. Other attributes inject code into the program source, which the compiler then compiles. This injected code makes programming easier by reducing the amount of code you have to write. Sometimes, however, a bug may cause your application to fail while it is executing injected code. When this happens, you will probably want to look at the injected code. Visual Studio provides two ways for you to see injected code: +Using attributes can greatly simplify C++ programming. Some attributes are interpreted directly by the compiler. Other attributes inject code into the program source, which the compiler then compiles. This injected code makes programming easier by reducing the amount of code you have to write. Sometimes, however, a bug may cause your application to fail while it is executing injected code. When this happens, you will probably want to look at the injected code. Visual Studio provides two ways for you to see injected code: - You can view injected code in the **Disassembly** window. -- Using [/Fx](/cpp/build/reference/fx-merge-injected-code), you can create a merged source file that contains original and injected code. +- Using [/Fx](../../build/reference/fx-merge-injected-code.md), you can create a merged source file that contains original and injected code. The **Disassembly** window shows assembly-language instructions that correspond to the source code and the code injected by attributes. In addition, the **Disassembly** window can show the source-code annotation. diff --git a/docs/windows/redist-version-auditing.md b/docs/windows/redist-version-auditing.md index a457bcc5f5e..a2cc229117a 100644 --- a/docs/windows/redist-version-auditing.md +++ b/docs/windows/redist-version-auditing.md @@ -16,7 +16,7 @@ ms.topic: how-to The Microsoft Visual C++ Redistributable and the Visual Studio C++ Runtime (collectively, "VC Runtime") are critical components of many applications. Across your network, machines may still be running applications that install and use an out-of-support version of the VC Runtime. You can use NTFS file auditing to identify such usage as a step towards replacing those applications with ones that use a supported version of the VC Runtime. This guide walks you through setting up NTFS file auditing, provides troubleshooting tips, and highlights the benefits of regular audits. -For more information about the versions of VC Runtime that are no longer supported, see [Microsoft Visual C++ Redistributable latest supported downloads](/cpp/windows/latest-supported-vc-redist). +For more information about the versions of VC Runtime that are no longer supported, see [Microsoft Visual C++ Redistributable latest supported downloads](latest-supported-vc-redist.md). ## Enable NTFS file auditing to determine VC Runtime usage From 0d4dc23708504d5fbf906f01a7fe29c26f9f950d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 18:27:34 +0800 Subject: [PATCH 1109/1799] Update metadata in 3 topics --- docs/build/arm64-windows-abi-conventions.md | 2 +- docs/cpp/char-wchar-t-char16-t-char32-t.md | 2 +- docs/windows/attributes/cpp-attributes-com-net.md | 5 ++--- 3 files changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/build/arm64-windows-abi-conventions.md b/docs/build/arm64-windows-abi-conventions.md index 0b6f68bea01..b5357e9bf3f 100644 --- a/docs/build/arm64-windows-abi-conventions.md +++ b/docs/build/arm64-windows-abi-conventions.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Overview of ARM64 ABI conventions" title: "Overview of ARM64 ABI conventions" +description: "Learn more about: Overview of ARM64 ABI conventions" ms.date: 04/08/2025 --- # Overview of ARM64 ABI conventions diff --git a/docs/cpp/char-wchar-t-char16-t-char32-t.md b/docs/cpp/char-wchar-t-char16-t-char32-t.md index 87e22b70234..4a4e7703852 100644 --- a/docs/cpp/char-wchar-t-char16-t-char32-t.md +++ b/docs/cpp/char-wchar-t-char16-t-char32-t.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: char, wchar_t, char8_t, char16_t, char32_t" title: "char, wchar_t, char8_t, char16_t, char32_t" +description: "Learn more about: char, wchar_t, char8_t, char16_t, char32_t" ms.date: 04/23/2021 --- # char, wchar_t, char8_t, char16_t, char32_t diff --git a/docs/windows/attributes/cpp-attributes-com-net.md b/docs/windows/attributes/cpp-attributes-com-net.md index d17f7e34554..3ca2ca8b5b9 100644 --- a/docs/windows/attributes/cpp-attributes-com-net.md +++ b/docs/windows/attributes/cpp-attributes-com-net.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: C++ Attributes for COM and .NET" title: "C++ Attributes for COM and .NET" +description: "Learn more about: C++ Attributes for COM and .NET" +ms.date: 11/19/2018 ms.custom: "index-page" -ms.date: "11/19/2018" ms.topic: "concept-article" helpviewer_keywords: ["attributes [C++/CLI], reference topics"] -ms.assetid: 613a3611-b3eb-4347-aa38-99b654600e1c --- # C++ Attributes for COM and .NET From b50636761b04707c4b234286def143461932a62e Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 22:15:08 +0800 Subject: [PATCH 1110/1799] Add "Remarks" headings for warning references in range [C6251, C6310] --- docs/code-quality/c6255.md | 4 ++-- docs/code-quality/c6258.md | 4 ++-- docs/code-quality/c6260.md | 4 ++-- docs/code-quality/c6268.md | 4 ++-- docs/code-quality/c6269.md | 4 ++-- docs/code-quality/c6276.md | 4 ++-- docs/code-quality/c6277.md | 4 ++-- docs/code-quality/c6279.md | 4 ++-- docs/code-quality/c6280.md | 4 ++-- docs/code-quality/c6283.md | 4 ++-- docs/code-quality/c6285.md | 4 ++-- docs/code-quality/c6290.md | 4 ++-- docs/code-quality/c6291.md | 2 ++ 13 files changed, 26 insertions(+), 24 deletions(-) diff --git a/docs/code-quality/c6255.md b/docs/code-quality/c6255.md index 43f53740cee..8c79c955c8f 100644 --- a/docs/code-quality/c6255.md +++ b/docs/code-quality/c6255.md @@ -10,10 +10,10 @@ ms.assetid: bb6430b2-782a-4410-a8e1-609df06007de > _alloca indicates failure by raising a stack overflow exception. Consider using _malloca instead -This warning indicates that a call to `_alloca` has been detected outside of local exception handling. - ## Remarks +This warning indicates that a call to `_alloca` has been detected outside of local exception handling. + `_alloca` should always be called from within the protected range of an exception handler because it can raise a stack overflow exception on failure. If possible, instead of using `_alloca`, consider using `_malloca`, which is a more secure version of `_alloca`. Code analysis name: `UNPROTECTEDUSEOFALLOCA` diff --git a/docs/code-quality/c6258.md b/docs/code-quality/c6258.md index c6c0716a6d0..833dd35e708 100644 --- a/docs/code-quality/c6258.md +++ b/docs/code-quality/c6258.md @@ -10,10 +10,10 @@ ms.assetid: 62f3eed7-d9cd-46eb-8c38-0bc4f647941f > Using `TerminateThread` does not allow proper thread clean up. -This warning indicates that a call to `TerminateThread` has been detected. - ## Remarks +This warning indicates that a call to `TerminateThread` has been detected. + `TerminateThread` is a dangerous function that should only be used in the most extreme cases. For more information about problems associated with TerminateThread call, see [`TerminateThread` function](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-terminatethread). Code analysis name: `USINGTERMINATETHREAD` diff --git a/docs/code-quality/c6260.md b/docs/code-quality/c6260.md index ed765072581..5def9c1bcb9 100644 --- a/docs/code-quality/c6260.md +++ b/docs/code-quality/c6260.md @@ -10,10 +10,10 @@ ms.assetid: 9cbedfcb-32b2-4fe4-99f7-a2d4a7f4422a > `sizeof` * `sizeof` is almost always wrong, did you intend to use a character count or a byte count? -This warning indicates that the results of two **`sizeof`** operations have been multiplied together. - ## Remarks +This warning indicates that the results of two **`sizeof`** operations have been multiplied together. + The C/C++ **`sizeof`** operator returns the number of bytes of storage an object uses. It's typically incorrect to multiply it by another **`sizeof`** operation. Usually, you're interested in the number of bytes in an object or the number of elements in an array (for example, the number of wide-characters in an array). There's some unintuitive behavior associated with **`sizeof`** operator. For example, in C, `sizeof ('\0') == 4`, because a character is of an integral type. In C++, the type of a character literal is **`char`**, so `sizeof ('\0') == 1`. However, in both C and C++, the following relation is true: diff --git a/docs/code-quality/c6268.md b/docs/code-quality/c6268.md index 49ae372e517..a45953a8c6d 100644 --- a/docs/code-quality/c6268.md +++ b/docs/code-quality/c6268.md @@ -10,10 +10,10 @@ ms.assetid: fd81e00a-de2f-498b-b3fe-53ce056042d7 > Incorrect order of operations: ('*TYPE1*')('*TYPE2*')x + y. Possible missing parentheses in ('*TYPE1*')(('*TYPE2*')x + y) -This warning indicates that a complex cast expression might involve a precedence problem when performing pointer arithmetic. Because casts group more closely than binary operators, the result might not be what the programmer intended. In some cases, this defect causes incorrect behavior or a program crash. - ## Remarks +This warning indicates that a complex cast expression might involve a precedence problem when performing pointer arithmetic. Because casts group more closely than binary operators, the result might not be what the programmer intended. In some cases, this defect causes incorrect behavior or a program crash. + In an expression such as: ```cpp diff --git a/docs/code-quality/c6269.md b/docs/code-quality/c6269.md index d910880ed70..91d890e7ac6 100644 --- a/docs/code-quality/c6269.md +++ b/docs/code-quality/c6269.md @@ -10,10 +10,10 @@ ms.assetid: a01fa7fa-fc6c-4af7-ac8c-585e44e60cca > Possible incorrect order of operations: dereference ignored -This warning indicates that the result of a pointer dereference is being ignored, which raises the question of why the pointer is being dereferenced in the first place. - ## Remarks +This warning indicates that the result of a pointer dereference is being ignored, which raises the question of why the pointer is being dereferenced in the first place. + The compiler will correctly optimize away the gratuitous dereference. In some cases, however, this defect may reflect a precedence or logic error. One common cause for this defect is an expression statement of the form: diff --git a/docs/code-quality/c6276.md b/docs/code-quality/c6276.md index 88eb047af53..b116e8871a1 100644 --- a/docs/code-quality/c6276.md +++ b/docs/code-quality/c6276.md @@ -10,10 +10,10 @@ ms.assetid: 88f288da-da81-4d32-ab0f-be9d01a2606a > Cast between semantically different string types. Use of invalid string can lead to undefined behavior. -This warning indicates a potentially incorrect cast from a narrow character string (`char*`) to a wide character string (`wchar_t*`). - ## Remarks +This warning indicates a potentially incorrect cast from a narrow character string (`char*`) to a wide character string (`wchar_t*`). + Because the Microsoft compiler implements wide strings with a character size of 2 bytes, casting from a narrow string might produce strings that aren't correctly terminated. If you use such strings with the `wcs*` functions in the runtime library, they could cause buffer overruns and access violations. Code analysis name: `CHAR_TO_WCHAR_CAST` diff --git a/docs/code-quality/c6277.md b/docs/code-quality/c6277.md index c01fd781f8a..30dfabbba6e 100644 --- a/docs/code-quality/c6277.md +++ b/docs/code-quality/c6277.md @@ -10,10 +10,10 @@ ms.assetid: 2b41252a-68c2-4e92-b005-0458db5f4430 > NULL application name with an unquoted path in call to '*function-name*': results in a security vulnerability if the path contains spaces -This warning indicates that the application name parameter is null and that there might be spaces in the executable path name. - ## Remarks +This warning indicates that the application name parameter is null and that there might be spaces in the executable path name. + Unless the executable name is fully qualified, there's likely to be a security problem. A malicious user could insert a rogue executable with the same name earlier in the path. To correct this warning, you can specify the application name instead of passing null. Alternatively, if you do pass null for the application name, use quotation marks around the executable path. Code analysis name: `CREATEPROCESS_ESCAPE` diff --git a/docs/code-quality/c6279.md b/docs/code-quality/c6279.md index ab28f2ecd13..398e1a0bc76 100644 --- a/docs/code-quality/c6279.md +++ b/docs/code-quality/c6279.md @@ -10,10 +10,10 @@ ms.assetid: 0af88b58-35df-456f-8c02-e8eeffe3b7de > '*variable-name*' is allocated with scalar new, deleted with array delete [] -This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the scalar `new` operator, but freed it with the array `delete[]` operator. If memory is allocated with scalar `new`, it should typically be freed with scalar `delete`. - ## Remarks +This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the scalar `new` operator, but freed it with the array `delete[]` operator. If memory is allocated with scalar `new`, it should typically be freed with scalar `delete`. + The exact ramifications of this defect are difficult to predict. It might cause random behavior or crashes due to usage of uninitialized memory as constructors aren't invoked. Or, it might cause memory allocations and crashes in situations where operators have been overridden. The analysis tool doesn't currently distinguish between these situations. To avoid these kinds of allocation problems altogether, use the mechanisms that are provided by the C++ Standard Library (STL). These include [`shared_ptr`](../standard-library/shared-ptr-class.md), [`unique_ptr`](../standard-library/unique-ptr-class.md), and containers such as [`vector`](../standard-library/vector.md). For more information, see [Smart pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md). diff --git a/docs/code-quality/c6280.md b/docs/code-quality/c6280.md index f03214777df..046e53583a4 100644 --- a/docs/code-quality/c6280.md +++ b/docs/code-quality/c6280.md @@ -10,10 +10,10 @@ ms.assetid: b91f2966-0876-4c9b-843a-e142f35be864 > '*variable-name*' is allocated with '*function-name-1*', but deleted with '*function-name-2*' -This warning indicates that the calling function has inconsistently allocated memory by using a function from one family and freed it by using a function from another. - ## Remarks +This warning indicates that the calling function has inconsistently allocated memory by using a function from one family and freed it by using a function from another. + The analyzer checks for this condition only when the `_Analysis_mode_(_Analysis_local_leak_checks_)` SAL annotation is specified. By default, this annotation is specified for Windows kernel mode (driver) code. For more information about SAL annotations, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). For example, this warning would be produced if memory is allocated by using `malloc` but freed by using `GlobalFree` or `delete`. In the specific cases of mismatches between array `new[]` and scalar `delete`, more precise warnings are reported instead of this one. diff --git a/docs/code-quality/c6283.md b/docs/code-quality/c6283.md index 436a46f1f52..12cb8a4095b 100644 --- a/docs/code-quality/c6283.md +++ b/docs/code-quality/c6283.md @@ -10,10 +10,10 @@ ms.assetid: 7760d32e-6d71-4c81-a6d2-719c9c76c2bb > '*variable-name*' is allocated with array new [], but deleted with scalar delete -This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the array `new []` operator, but freed it with the scalar `delete` operator. - ## Remarks +This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the array `new []` operator, but freed it with the scalar `delete` operator. + This defect might cause leaks, memory corruptions, and, in situations where operators have been overridden, crashes. If memory is allocated with array `new []`, it should typically be freed with array `delete[]`. Warning C6283 only applies to arrays of primitive types such as integers or characters. If elements of the array are objects of class type then warning [C6278](../code-quality/c6278.md) is issued. diff --git a/docs/code-quality/c6285.md b/docs/code-quality/c6285.md index 44221b6a57e..c867f27ea19 100644 --- a/docs/code-quality/c6285.md +++ b/docs/code-quality/c6285.md @@ -10,10 +10,10 @@ ms.assetid: f5bc6d3d-d33b-42c8-98d2-92ec8ab17193 > ('*non-zero constant*' \|\| '*non-zero constant*') is always a non-zero constant. Did you intend to use the bitwise-and operator? -This warning indicates that two constant values, both greater than one, were detected as arguments to a logical-or operation that occurs in a test context. This expression is always TRUE. - ## Remarks +This warning indicates that two constant values, both greater than one, were detected as arguments to a logical-or operation that occurs in a test context. This expression is always TRUE. + Constant values greater than one suggest that the arguments to logical-or could be bit fields. Consider whether a bitwise operator might be a more appropriate operator in this case. Code analysis name: `LOGICALOROFCONSTANTS` diff --git a/docs/code-quality/c6290.md b/docs/code-quality/c6290.md index 2557e2d286a..df7afb644e7 100644 --- a/docs/code-quality/c6290.md +++ b/docs/code-quality/c6290.md @@ -10,10 +10,10 @@ ms.assetid: 96a1acc4-724b-4b56-b091-661ddcc03884 > Bitwise operation on logical result: ! has higher precedence than &. Use && or (!(x & y)) instead -This warning indicates possible confusion in the use of an operator or an operator precedence. - ## Remarks +This warning indicates possible confusion in the use of an operator or an operator precedence. + The `!` operator yields a Boolean result, and it has higher precedence than the `&`. The bitwise-and (&) operator takes two arithmetic arguments. Therefore, one of the following errors has been detected: - The expression is mis-parenthesized: diff --git a/docs/code-quality/c6291.md b/docs/code-quality/c6291.md index 9e2421a92b6..28e40de030f 100644 --- a/docs/code-quality/c6291.md +++ b/docs/code-quality/c6291.md @@ -10,6 +10,8 @@ ms.assetid: d0457386-e403-43fa-b959-5b6a495fab42 > Bitwise operation on logical result: ! has higher precedence than \|. Use \|\| or (!(x \| y)) instead +## Remarks + The `!` operator yields a Boolean result, and the `|` (bitwise-or) operator takes two arithmetic arguments. The `!` operator also has higher precedence than `|`. Therefore, one of the following errors has been detected: From a1c5af69f07a1bef74085664dc304fa3b19eca6b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 22:16:30 +0800 Subject: [PATCH 1111/1799] Replace term "sample" with "example" for warning references in range [C6251, C6310] --- docs/code-quality/c6259.md | 2 +- docs/code-quality/c6271.md | 4 ++-- docs/code-quality/c6277.md | 2 +- docs/code-quality/c6278.md | 4 ++-- docs/code-quality/c6280.md | 2 +- docs/code-quality/c6290.md | 2 +- docs/code-quality/c6293.md | 2 +- docs/code-quality/c6294.md | 4 ++-- docs/code-quality/c6298.md | 4 ++-- docs/code-quality/c6302.md | 2 +- docs/code-quality/c6303.md | 4 ++-- docs/code-quality/c6308.md | 2 +- 12 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/code-quality/c6259.md b/docs/code-quality/c6259.md index 6819a938cdc..70153b87448 100644 --- a/docs/code-quality/c6259.md +++ b/docs/code-quality/c6259.md @@ -18,7 +18,7 @@ Code analysis name: `DEADCODEINBITORLIMITEDSWITCH` ## Example -The following sample code generates this warning because the 'switch' expression `(rand() & 3)` can't evaluate to case label (`case 4`): +The following example code generates this warning because the 'switch' expression `(rand() & 3)` can't evaluate to case label (`case 4`): ```cpp #include diff --git a/docs/code-quality/c6271.md b/docs/code-quality/c6271.md index 29c26267883..8f3a327731b 100644 --- a/docs/code-quality/c6271.md +++ b/docs/code-quality/c6271.md @@ -17,7 +17,7 @@ Code analysis name: `EXTRA_ARGUMENT_TO_FORMAT_FUNCTION` ## Example -The following sample code generates this warning: +The following example code generates this warning: ```cpp #include @@ -43,7 +43,7 @@ void f() } ``` -The following sample code calls the safe string manipulation function, `sprintf_s`, to correct this warning: +The following example code calls the safe string manipulation function, `sprintf_s`, to correct this warning: ```cpp #include diff --git a/docs/code-quality/c6277.md b/docs/code-quality/c6277.md index 30dfabbba6e..2af6a6c2da0 100644 --- a/docs/code-quality/c6277.md +++ b/docs/code-quality/c6277.md @@ -20,7 +20,7 @@ Code analysis name: `CREATEPROCESS_ESCAPE` ## Example -The following sample code generates warning C6277. The warning is caused by the NULL application name and from the executable path name having a space. Due to how the function parses spaces, there's a risk that a different executable could be run. For more information, see [`CreateProcessA`](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-createprocessa). +The following example code generates warning C6277. The warning is caused by the NULL application name and from the executable path name having a space. Due to how the function parses spaces, there's a risk that a different executable could be run. For more information, see [`CreateProcessA`](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-createprocessa). ```cpp #include diff --git a/docs/code-quality/c6278.md b/docs/code-quality/c6278.md index 8ae400a83c7..80e6343773c 100644 --- a/docs/code-quality/c6278.md +++ b/docs/code-quality/c6278.md @@ -30,7 +30,7 @@ Code analysis name: `ARRAY_NEW_DELETE_MISMATCH` ## Example -The following sample code generates warning C6278: +The following example code generates warning C6278: ```cpp class A @@ -46,7 +46,7 @@ void f( ) } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp void f( ) diff --git a/docs/code-quality/c6280.md b/docs/code-quality/c6280.md index 046e53583a4..0d70a20e38e 100644 --- a/docs/code-quality/c6280.md +++ b/docs/code-quality/c6280.md @@ -22,7 +22,7 @@ Code analysis name: `MEMORY_ALLOCATION_MISMATCH` ## Example -The following sample code generates this warning. `pInt` is allocated using `calloc` but is freed using the mismatched function `delete`: +The following example code generates this warning. `pInt` is allocated using `calloc` but is freed using the mismatched function `delete`: ```cpp // C6280a_warning.cpp diff --git a/docs/code-quality/c6290.md b/docs/code-quality/c6290.md index df7afb644e7..b68eea38c13 100644 --- a/docs/code-quality/c6290.md +++ b/docs/code-quality/c6290.md @@ -46,7 +46,7 @@ void f(int x, int y) } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp void f(int x, int y) diff --git a/docs/code-quality/c6293.md b/docs/code-quality/c6293.md index ae4618266c7..aab3bd7008b 100644 --- a/docs/code-quality/c6293.md +++ b/docs/code-quality/c6293.md @@ -20,7 +20,7 @@ Code analysis name: `LOOP_INDEX_GOES_NEGATIVE` ## Example -The following sample code generates this warning: +The following example code generates this warning: ```cpp void f( ) diff --git a/docs/code-quality/c6294.md b/docs/code-quality/c6294.md index c67163e3f5f..feea1e9fd8a 100644 --- a/docs/code-quality/c6294.md +++ b/docs/code-quality/c6294.md @@ -18,7 +18,7 @@ Code analysis name: `LOOP_BODY_NEVER_EXECUTED` ## Example -The following sample code generates this warning because MAX_VALUE is 0: +The following example code generates this warning because MAX_VALUE is 0: ```cpp #define MAX_VALUE 0 @@ -32,7 +32,7 @@ void f() } ``` -The following sample code corrects this warning by changing the value of MAX_VALUE to 25 +The following example code corrects this warning by changing the value of MAX_VALUE to 25 ```cpp #define MAX_VALUE 25 diff --git a/docs/code-quality/c6298.md b/docs/code-quality/c6298.md index 7887a8ee7c9..c77350238ff 100644 --- a/docs/code-quality/c6298.md +++ b/docs/code-quality/c6298.md @@ -20,7 +20,7 @@ Code analysis name: `CONST_STRING_TO_WRITABLE_STRING` ## Example -The following sample code generates this warning: +The following example code generates this warning: ```cpp #include @@ -58,7 +58,7 @@ void f() } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp #include diff --git a/docs/code-quality/c6302.md b/docs/code-quality/c6302.md index e7e9a30709a..1c03b1fe8e5 100644 --- a/docs/code-quality/c6302.md +++ b/docs/code-quality/c6302.md @@ -27,7 +27,7 @@ void f() } ``` -The following sample code remediates this issue by using `%hs` to specify a single-byte character string. Alternatively it could have switched to `%S`, which is a narrow string when used with `wprintf` like functions. See [Format specification syntax: `printf` and `wprintf` functions](../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md#type-field-characters) for more options. +The following example code remediates this issue by using `%hs` to specify a single-byte character string. Alternatively it could have switched to `%S`, which is a narrow string when used with `wprintf` like functions. See [Format specification syntax: `printf` and `wprintf` functions](../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md#type-field-characters) for more options. ```cpp void f() diff --git a/docs/code-quality/c6303.md b/docs/code-quality/c6303.md index bb481fe624c..65391970ea7 100644 --- a/docs/code-quality/c6303.md +++ b/docs/code-quality/c6303.md @@ -17,7 +17,7 @@ Code analysis name: `WCHAR_CHAR_ARGUMENT_TO_FORMAT_FUNCTION` ## Example -The following sample code generates this warning. `buff` is a wide character string, but the `printf_s` call expects a short string as denoted by `%s`: +The following example code generates this warning. `buff` is a wide character string, but the `printf_s` call expects a short string as denoted by `%s`: ```cpp #include @@ -29,7 +29,7 @@ void f() } ``` -The following sample code remediates this issue by using `%ls` to specify a wide character string. Alternatively it could have switched to `%S`, which is a wide string when used with `printf` like functions. See [Format specification syntax: `printf` and `wprintf` functions](../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md#type-field-characters) for more options. +The following example code remediates this issue by using `%ls` to specify a wide character string. Alternatively it could have switched to `%S`, which is a wide string when used with `printf` like functions. See [Format specification syntax: `printf` and `wprintf` functions](../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md#type-field-characters) for more options. ```cpp #include diff --git a/docs/code-quality/c6308.md b/docs/code-quality/c6308.md index 07cba3b71f4..bfcdecf06d3 100644 --- a/docs/code-quality/c6308.md +++ b/docs/code-quality/c6308.md @@ -18,7 +18,7 @@ Code analysis name: `REALLOCLEAK` ## Example -The following sample code generates warning C6308. This issue stems from the assignment of the return value from `realloc` to `x`. If `realloc` fails and returns a null pointer, then the original memory pointed to by `x` won't be freed: +The following example code generates warning C6308. This issue stems from the assignment of the return value from `realloc` to `x`. If `realloc` fails and returns a null pointer, then the original memory pointed to by `x` won't be freed: ```cpp #include From 02fda7c1658d9fd387ba895eccad9f99e07c0e0b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 22:23:19 +0800 Subject: [PATCH 1112/1799] Update metadata for warning references in range [C6251, C6310] --- docs/code-quality/c6255.md | 3 +-- docs/code-quality/c6258.md | 3 +-- docs/code-quality/c6259.md | 3 +-- docs/code-quality/c6260.md | 3 +-- docs/code-quality/c6262.md | 2 +- docs/code-quality/c6263.md | 3 +-- docs/code-quality/c6268.md | 3 +-- docs/code-quality/c6269.md | 3 +-- docs/code-quality/c6270.md | 2 +- docs/code-quality/c6271.md | 2 +- docs/code-quality/c6272.md | 2 +- docs/code-quality/c6273.md | 2 +- docs/code-quality/c6274.md | 2 +- docs/code-quality/c6276.md | 3 +-- docs/code-quality/c6277.md | 3 +-- docs/code-quality/c6278.md | 3 +-- docs/code-quality/c6279.md | 3 +-- docs/code-quality/c6280.md | 3 +-- docs/code-quality/c6281.md | 3 +-- docs/code-quality/c6282.md | 3 +-- docs/code-quality/c6283.md | 3 +-- docs/code-quality/c6284.md | 2 +- docs/code-quality/c6285.md | 3 +-- docs/code-quality/c6286.md | 3 +-- docs/code-quality/c6287.md | 3 +-- docs/code-quality/c6288.md | 3 +-- docs/code-quality/c6289.md | 3 +-- docs/code-quality/c6290.md | 3 +-- docs/code-quality/c6291.md | 3 +-- docs/code-quality/c6292.md | 3 +-- docs/code-quality/c6293.md | 3 +-- docs/code-quality/c6294.md | 3 +-- docs/code-quality/c6295.md | 3 +-- docs/code-quality/c6296.md | 2 +- docs/code-quality/c6297.md | 3 +-- docs/code-quality/c6298.md | 3 +-- docs/code-quality/c6299.md | 3 +-- docs/code-quality/c6302.md | 2 +- docs/code-quality/c6303.md | 2 +- docs/code-quality/c6305.md | 3 +-- docs/code-quality/c6306.md | 3 +-- docs/code-quality/c6308.md | 3 +-- docs/code-quality/c6310.md | 3 +-- 43 files changed, 43 insertions(+), 76 deletions(-) diff --git a/docs/code-quality/c6255.md b/docs/code-quality/c6255.md index 8c79c955c8f..c8859f60aea 100644 --- a/docs/code-quality/c6255.md +++ b/docs/code-quality/c6255.md @@ -1,10 +1,9 @@ --- +title: "Warning C6255" description: "Learn more about: Warning C6255" -title: Warning C6255 ms.date: 11/04/2016 f1_keywords: ["C6255", "UNPROTECTEDUSEOFALLOCA", "__WARNING_UNPROTECTEDUSEOFALLOCA"] helpviewer_keywords: ["C6255"] -ms.assetid: bb6430b2-782a-4410-a8e1-609df06007de --- # Warning C6255 diff --git a/docs/code-quality/c6258.md b/docs/code-quality/c6258.md index 833dd35e708..e9efa609a9d 100644 --- a/docs/code-quality/c6258.md +++ b/docs/code-quality/c6258.md @@ -1,10 +1,9 @@ --- +title: "Warning C6258" description: "Learn more about: Warning C6258" -title: Warning C6258 ms.date: 11/04/2016 f1_keywords: ["C6258", "USINGTERMINATETHREAD", "__WARNING_USINGTERMINATETHREAD"] helpviewer_keywords: ["C6258"] -ms.assetid: 62f3eed7-d9cd-46eb-8c38-0bc4f647941f --- # Warning C6258 diff --git a/docs/code-quality/c6259.md b/docs/code-quality/c6259.md index 70153b87448..07203450c55 100644 --- a/docs/code-quality/c6259.md +++ b/docs/code-quality/c6259.md @@ -1,10 +1,9 @@ --- +title: "Warning C6259" description: "Learn more about: Warning C6259" -title: Warning C6259 ms.date: 11/04/2016 f1_keywords: ["C6259", "DEADCODEINBITORLIMITEDSWITCH", "__WARNING_DEADCODEINBITORLIMITEDSWITCH"] helpviewer_keywords: ["C6259"] -ms.assetid: a370bfd2-6634-402c-84c7-3d83fa0009b7 --- # Warning C6259 diff --git a/docs/code-quality/c6260.md b/docs/code-quality/c6260.md index 5def9c1bcb9..41c4541cf36 100644 --- a/docs/code-quality/c6260.md +++ b/docs/code-quality/c6260.md @@ -1,10 +1,9 @@ --- +title: "Warning C6260" description: "Learn more about: Warning C6260" -title: Warning C6260 ms.date: 11/04/2016 f1_keywords: ["C6260", "USEOFBYTEAREA", "__WARNING_USEOFBYTEAREA"] helpviewer_keywords: ["C6260"] -ms.assetid: 9cbedfcb-32b2-4fe4-99f7-a2d4a7f4422a --- # Warning C6260 diff --git a/docs/code-quality/c6262.md b/docs/code-quality/c6262.md index 775784567c4..1280eed743c 100644 --- a/docs/code-quality/c6262.md +++ b/docs/code-quality/c6262.md @@ -1,5 +1,5 @@ --- -title: Warning C6262 +title: "Warning C6262" description: "Visual Studio C++ Code Analysis warning C6262 description and resolution." ms.date: 10/14/2020 f1_keywords: ["C6262", "EXCESSIVESTACKUSAGE", "__WARNING_EXCESSIVESTACKUSAGE"] diff --git a/docs/code-quality/c6263.md b/docs/code-quality/c6263.md index a232723446f..3d8b854aa72 100644 --- a/docs/code-quality/c6263.md +++ b/docs/code-quality/c6263.md @@ -1,10 +1,9 @@ --- +title: "Warning C6263" description: "Learn more about: Warning C6263" -title: Warning C6263 ms.date: 11/04/2016 f1_keywords: ["C6263", "USINGALLOCAINLOOP", "__WARNING_USINGALLOCAINLOOP"] helpviewer_keywords: ["C6263"] -ms.assetid: bc360ad7-5f59-4480-a642-6c7e6beeb5f6 --- # Warning C6263 diff --git a/docs/code-quality/c6268.md b/docs/code-quality/c6268.md index a45953a8c6d..758c5b3a36b 100644 --- a/docs/code-quality/c6268.md +++ b/docs/code-quality/c6268.md @@ -1,10 +1,9 @@ --- +title: "Warning C6268" description: "Learn more about: Warning C6268" -title: Warning C6268 ms.date: 11/04/2016 f1_keywords: ["C6268", "MISPARENTHESIZED_CASTS", "__WARNING_MISPARENTHESIZED_CASTS"] helpviewer_keywords: ["C6268"] -ms.assetid: fd81e00a-de2f-498b-b3fe-53ce056042d7 --- # Warning C6268 diff --git a/docs/code-quality/c6269.md b/docs/code-quality/c6269.md index 91d890e7ac6..d7b26922a15 100644 --- a/docs/code-quality/c6269.md +++ b/docs/code-quality/c6269.md @@ -1,10 +1,9 @@ --- +title: "Warning C6269" description: "Learn more about: Warning C6269" -title: Warning C6269 ms.date: 11/04/2016 f1_keywords: ["C6269", "POINTER_DEREF_DISCARDED", "__WARNING_POINTER_DEREF_DISCARDED"] helpviewer_keywords: ["C6269"] -ms.assetid: a01fa7fa-fc6c-4af7-ac8c-585e44e60cca --- # Warning C6269 diff --git a/docs/code-quality/c6270.md b/docs/code-quality/c6270.md index 6a23a7f3057..ce3f1f68a54 100644 --- a/docs/code-quality/c6270.md +++ b/docs/code-quality/c6270.md @@ -1,6 +1,6 @@ --- +title: "Warning C6270" description: "Learn more about: Warning C6270" -title: Warning C6270 ms.date: 3/03/2023 f1_keywords: ["C6270", "MISSING_FLOAT_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_MISSING_FLOAT_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6270"] diff --git a/docs/code-quality/c6271.md b/docs/code-quality/c6271.md index 8f3a327731b..059c2c969f0 100644 --- a/docs/code-quality/c6271.md +++ b/docs/code-quality/c6271.md @@ -1,6 +1,6 @@ --- +title: "Warning C6271" description: "Learn more about: Warning C6271" -title: Warning C6271 ms.date: 3/06/2023 f1_keywords: ["C6271", "EXTRA_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_EXTRA_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6271"] diff --git a/docs/code-quality/c6272.md b/docs/code-quality/c6272.md index 5a25de9b994..98cc4975756 100644 --- a/docs/code-quality/c6272.md +++ b/docs/code-quality/c6272.md @@ -1,6 +1,6 @@ --- +title: "Warning C6272" description: "Learn more about: Warning C6272" -title: Warning C6272 ms.date: 03/07/2023 f1_keywords: ["C6272", "NON_FLOAT_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_FLOAT_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6272"] diff --git a/docs/code-quality/c6273.md b/docs/code-quality/c6273.md index 7bf741fbf4b..4a84e4345b0 100644 --- a/docs/code-quality/c6273.md +++ b/docs/code-quality/c6273.md @@ -1,6 +1,6 @@ --- +title: "Warning C6273" description: "Learn more about: Warning C6273" -title: Warning C6273 ms.date: 03/07/2023 f1_keywords: ["C6273", "NON_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6273"] diff --git a/docs/code-quality/c6274.md b/docs/code-quality/c6274.md index 79412891722..8a324e84008 100644 --- a/docs/code-quality/c6274.md +++ b/docs/code-quality/c6274.md @@ -1,6 +1,6 @@ --- +title: "Warning C6274" description: "Learn more about: Warning C6274" -title: Warning C6274 ms.date: 03/07/2023 f1_keywords: ["C6274", "NON_CHAR_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_CHAR_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6274"] diff --git a/docs/code-quality/c6276.md b/docs/code-quality/c6276.md index b116e8871a1..e31ce0bf0a4 100644 --- a/docs/code-quality/c6276.md +++ b/docs/code-quality/c6276.md @@ -1,10 +1,9 @@ --- +title: "Warning C6276" description: "Learn more about: Warning C6276" -title: Warning C6276 ms.date: 09/28/2022 f1_keywords: ["C6276", "CHAR_TO_WCHAR_CAST", "__WARNING_CHAR_TO_WCHAR_CAST"] helpviewer_keywords: ["C6276"] -ms.assetid: 88f288da-da81-4d32-ab0f-be9d01a2606a --- # Warning C6276 diff --git a/docs/code-quality/c6277.md b/docs/code-quality/c6277.md index 2af6a6c2da0..9b80fad0fba 100644 --- a/docs/code-quality/c6277.md +++ b/docs/code-quality/c6277.md @@ -1,10 +1,9 @@ --- +title: "Warning C6277" description: "Learn more about: Warning C6277" -title: Warning C6277 ms.date: 09/28/2022 f1_keywords: ["C6277", "CREATEPROCESS_ESCAPE", "__WARNING_CREATEPROCESS_ESCAPE"] helpviewer_keywords: ["C6277"] -ms.assetid: 2b41252a-68c2-4e92-b005-0458db5f4430 --- # Warning C6277 diff --git a/docs/code-quality/c6278.md b/docs/code-quality/c6278.md index 80e6343773c..55e0ddb1a28 100644 --- a/docs/code-quality/c6278.md +++ b/docs/code-quality/c6278.md @@ -1,10 +1,9 @@ --- +title: "Warning C6278" description: "Learn more about: Warning C6278" -title: Warning C6278 ms.date: 10/03/2022 f1_keywords: ["C6278", "ARRAY_NEW_DELETE_MISMATCH", "__WARNING_ARRAY_NEW_DELETE_MISMATCH"] helpviewer_keywords: ["C6278"] -ms.assetid: 5cc3c393-c48a-4f91-9f38-03d7868be5e5 --- # Warning C6278 diff --git a/docs/code-quality/c6279.md b/docs/code-quality/c6279.md index 398e1a0bc76..8c9b92fc129 100644 --- a/docs/code-quality/c6279.md +++ b/docs/code-quality/c6279.md @@ -1,10 +1,9 @@ --- +title: "Warning C6279" description: "Learn more about: Warning C6279" -title: Warning C6279 ms.date: 10/03/2022 f1_keywords: ["C6279", "NEW_ARRAY_DELETE_MISMATCH", "__WARNING_NEW_ARRAY_DELETE_MISMATCH"] helpviewer_keywords: ["C6279"] -ms.assetid: 0af88b58-35df-456f-8c02-e8eeffe3b7de --- # Warning C6279 diff --git a/docs/code-quality/c6280.md b/docs/code-quality/c6280.md index 0d70a20e38e..0fa6146b704 100644 --- a/docs/code-quality/c6280.md +++ b/docs/code-quality/c6280.md @@ -1,10 +1,9 @@ --- +title: "Warning C6280" description: "Learn more about: Warning C6280" -title: Warning C6280 ms.date: 10/03/2022 f1_keywords: ["C6280", "MEMORY_ALLOCATION_MISMATCH", "__WARNING_MEMORY_ALLOCATION_MISMATCH"] helpviewer_keywords: ["C6280"] -ms.assetid: b91f2966-0876-4c9b-843a-e142f35be864 --- # Warning C6280 diff --git a/docs/code-quality/c6281.md b/docs/code-quality/c6281.md index f16c015ee52..4481fe9fc2e 100644 --- a/docs/code-quality/c6281.md +++ b/docs/code-quality/c6281.md @@ -1,10 +1,9 @@ --- +title: "Warning C6281" description: "Learn more about: Warning C6281" -title: Warning C6281 ms.date: 11/04/2016 f1_keywords: ["C6281", "BITWISERELATIONPRECEDENCEERROR", "__WARNING_BITWISERELATIONPRECEDENCEERROR"] helpviewer_keywords: ["C6281"] -ms.assetid: d0182269-8403-486b-ac3f-325522871bb1 --- # Warning C6281 diff --git a/docs/code-quality/c6282.md b/docs/code-quality/c6282.md index c48e6166325..c068864b18e 100644 --- a/docs/code-quality/c6282.md +++ b/docs/code-quality/c6282.md @@ -1,10 +1,9 @@ --- +title: "Warning C6282" description: "Learn more about: Warning C6282" -title: Warning C6282 ms.date: 11/04/2016 f1_keywords: ["C6282", "ASSIGNMENTREPLACESTEST", "__WARNING_ASSIGNMENTREPLACESTEST"] helpviewer_keywords: ["C6282"] -ms.assetid: 7dc153d5-fb9f-424a-8afa-4e2661efa51c --- # Warning C6282 diff --git a/docs/code-quality/c6283.md b/docs/code-quality/c6283.md index 12cb8a4095b..4607e25d0ce 100644 --- a/docs/code-quality/c6283.md +++ b/docs/code-quality/c6283.md @@ -1,10 +1,9 @@ --- +title: "Warning C6283" description: "Learn more about: Warning C6283" -title: Warning C6283 ms.date: 10/03/2022 f1_keywords: ["C6283", "PRIMITIVE_ARRAY_NEW_DELETE_MISMATCH", "__WARNING_PRIMITIVE_ARRAY_NEW_DELETE_MISMATCH"] helpviewer_keywords: ["C6283"] -ms.assetid: 7760d32e-6d71-4c81-a6d2-719c9c76c2bb --- # Warning C6283 diff --git a/docs/code-quality/c6284.md b/docs/code-quality/c6284.md index 4c29d20e333..7bb131248f1 100644 --- a/docs/code-quality/c6284.md +++ b/docs/code-quality/c6284.md @@ -1,6 +1,6 @@ --- +title: "Warning C6284" description: "Learn more about: Warning C6284" -title: Warning C6284 ms.date: 03/07/2023 f1_keywords: ["C6284", "OBJECT_AS_STRING_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_OBJECT_AS_STRING_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6284"] diff --git a/docs/code-quality/c6285.md b/docs/code-quality/c6285.md index c867f27ea19..d7b4077b96d 100644 --- a/docs/code-quality/c6285.md +++ b/docs/code-quality/c6285.md @@ -1,10 +1,9 @@ --- +title: "Warning C6285" description: "Learn more about: Warning C6285" -title: Warning C6285 ms.date: 11/04/2016 f1_keywords: ["C6285", "LOGICALOROFCONSTANTS", "__WARNING_LOGICALOROFCONSTANTS"] helpviewer_keywords: ["C6285"] -ms.assetid: f5bc6d3d-d33b-42c8-98d2-92ec8ab17193 --- # Warning C6285 diff --git a/docs/code-quality/c6286.md b/docs/code-quality/c6286.md index aeedbe05d59..5c850b5e3c2 100644 --- a/docs/code-quality/c6286.md +++ b/docs/code-quality/c6286.md @@ -1,10 +1,9 @@ --- +title: "Warning C6286" description: "Learn more about: Warning C6286" -title: Warning C6286 ms.date: 11/04/2016 f1_keywords: ["C6286", "NONZEROLOGICALORLOSINGSIDEEFFECTS", "__WARNING_NONZEROLOGICALORLOSINGSIDEEFFECTS"] helpviewer_keywords: ["C6286"] -ms.assetid: c79c5d4a-c02b-4b98-891a-d79e471f9da7 --- # Warning C6286 diff --git a/docs/code-quality/c6287.md b/docs/code-quality/c6287.md index 2847f5e85ec..ecf799346b7 100644 --- a/docs/code-quality/c6287.md +++ b/docs/code-quality/c6287.md @@ -1,10 +1,9 @@ --- +title: "Warning C6287" description: "Learn more about: Warning C6287" -title: Warning C6287 ms.date: 12/17/2019 f1_keywords: ["C6287", "REDUNDANTTEST", "__WARNING_REDUNDANTTEST"] helpviewer_keywords: ["C6287"] -ms.assetid: 9cb12641-8853-413a-b89e-f8b32c8dc5d3 --- # Warning C6287 diff --git a/docs/code-quality/c6288.md b/docs/code-quality/c6288.md index ffa9ae3b713..0057b6c8fea 100644 --- a/docs/code-quality/c6288.md +++ b/docs/code-quality/c6288.md @@ -1,10 +1,9 @@ --- +title: "Warning C6288" description: "Learn more about: Warning C6288" -title: Warning C6288 ms.date: 11/04/2016 f1_keywords: ["C6288", "MUTUALINCLUSIONOVERANDISFALSE", "__WARNING_MUTUALINCLUSIONOVERANDISFALSE"] helpviewer_keywords: ["C6288"] -ms.assetid: 3856b80a-c9f2-4e86-97fc-c913b0186788 --- # Warning C6288 diff --git a/docs/code-quality/c6289.md b/docs/code-quality/c6289.md index c5d8c1e205a..500153072b2 100644 --- a/docs/code-quality/c6289.md +++ b/docs/code-quality/c6289.md @@ -1,10 +1,9 @@ --- +title: "Warning C6289" description: "Learn more about: Warning C6289" -title: Warning C6289 ms.date: 11/04/2016 f1_keywords: ["C6289", "MUTUALEXCLUSIONOVERORISTRUE", "__WARNING_MUTUALEXCLUSIONOVERORISTRUE"] helpviewer_keywords: ["C6289"] -ms.assetid: 0fe09974-7577-468b-91a0-62dbe915443e --- # Warning C6289 diff --git a/docs/code-quality/c6290.md b/docs/code-quality/c6290.md index b68eea38c13..61854f30eed 100644 --- a/docs/code-quality/c6290.md +++ b/docs/code-quality/c6290.md @@ -1,10 +1,9 @@ --- +title: "Warning C6290" description: "Learn more about: Warning C6290" -title: Warning C6290 ms.date: 11/04/2016 f1_keywords: ["C6290", "LOGICALNOTBITWISEAND", "__WARNING_LOGICALNOTBITWISEAND"] helpviewer_keywords: ["C6290"] -ms.assetid: 96a1acc4-724b-4b56-b091-661ddcc03884 --- # Warning C6290 diff --git a/docs/code-quality/c6291.md b/docs/code-quality/c6291.md index 28e40de030f..cfdb0e86e6f 100644 --- a/docs/code-quality/c6291.md +++ b/docs/code-quality/c6291.md @@ -1,10 +1,9 @@ --- +title: "Warning C6291" description: "Learn more about: Warning C6291" -title: Warning C6291 ms.date: 11/04/2016 f1_keywords: ["C6291", "LOGICALNOTBITWISEOR", "__WARNING_LOGICALNOTBITWISEOR"] helpviewer_keywords: ["C6291"] -ms.assetid: d0457386-e403-43fa-b959-5b6a495fab42 --- # Warning C6291 diff --git a/docs/code-quality/c6292.md b/docs/code-quality/c6292.md index 9b1926a741c..d3f8731f944 100644 --- a/docs/code-quality/c6292.md +++ b/docs/code-quality/c6292.md @@ -1,10 +1,9 @@ --- +title: "Warning C6292" description: "Learn more about: Warning C6292" -title: Warning C6292 ms.date: 11/04/2016 f1_keywords: ["C6292", "LOOP_COUNTS_UP_FROM_MAX", "__WARNING_LOOP_COUNTS_UP_FROM_MAX"] helpviewer_keywords: ["C6292"] -ms.assetid: 23998c78-ebd7-4ba1-a391-7b31b170f8fe --- # Warning C6292 diff --git a/docs/code-quality/c6293.md b/docs/code-quality/c6293.md index aab3bd7008b..1624ad4ff61 100644 --- a/docs/code-quality/c6293.md +++ b/docs/code-quality/c6293.md @@ -1,10 +1,9 @@ --- +title: "Warning C6293" description: "Learn more about: Warning C6293" -title: Warning C6293 ms.date: 11/04/2016 f1_keywords: ["C6293", "LOOP_INDEX_GOES_NEGATIVE", "__WARNING_LOOP_INDEX_GOES_NEGATIVE"] helpviewer_keywords: ["C6293"] -ms.assetid: 24a475f6-fd93-4778-856a-9dd7941f7520 --- # Warning C6293 diff --git a/docs/code-quality/c6294.md b/docs/code-quality/c6294.md index feea1e9fd8a..d747530e5a5 100644 --- a/docs/code-quality/c6294.md +++ b/docs/code-quality/c6294.md @@ -1,10 +1,9 @@ --- +title: "Warning C6294" description: "Learn more about: Warning C6294" -title: Warning C6294 ms.date: 11/04/2016 f1_keywords: ["C6294", "LOOP_BODY_NEVER_EXECUTED", "__WARNING_LOOP_BODY_NEVER_EXECUTED"] helpviewer_keywords: ["C6294"] -ms.assetid: 1171d76f-b862-416d-b7c0-7a29be5c132d --- # Warning C6294 diff --git a/docs/code-quality/c6295.md b/docs/code-quality/c6295.md index f0c587ef8ed..80b75b427cb 100644 --- a/docs/code-quality/c6295.md +++ b/docs/code-quality/c6295.md @@ -1,10 +1,9 @@ --- +title: "Warning C6295" description: "Learn more about: Warning C6295" -title: Warning C6295 ms.date: 11/04/2016 f1_keywords: ["C6295", "INFINITE_LOOP", "__WARNING_INFINITE_LOOP"] helpviewer_keywords: ["C6295"] -ms.assetid: 64e890ee-b688-4487-938d-3928762b83a4 --- # Warning C6295 diff --git a/docs/code-quality/c6296.md b/docs/code-quality/c6296.md index e6f7da03400..a12e1eaafb5 100644 --- a/docs/code-quality/c6296.md +++ b/docs/code-quality/c6296.md @@ -1,5 +1,5 @@ --- -title: Warning C6296 +title: "Warning C6296" description: "Learn more about: Warning C6296" ms.date: 03/30/2025 f1_keywords: ["C6296", "LOOP_ONLY_EXECUTED_ONCE", "__WARNING_LOOP_ONLY_EXECUTED_ONCE"] diff --git a/docs/code-quality/c6297.md b/docs/code-quality/c6297.md index 2bbd49a68b4..d048cd48b79 100644 --- a/docs/code-quality/c6297.md +++ b/docs/code-quality/c6297.md @@ -1,10 +1,9 @@ --- -title: Warning C6297 +title: "Warning C6297" description: "Describes causes of MSVC Code analysis warning C6297, and how to fix the issue." ms.date: 07/15/2020 f1_keywords: ["C6297", "RESULTOFSHIFTCASTTOLARGERSIZE", "__WARNING_RESULTOFSHIFTCASTTOLARGERSIZE"] helpviewer_keywords: ["C6297"] -ms.assetid: 17b585f0-75e5-4fc0-935a-143ec67659f4 --- # Warning C6297 diff --git a/docs/code-quality/c6298.md b/docs/code-quality/c6298.md index c77350238ff..e86e5e4b260 100644 --- a/docs/code-quality/c6298.md +++ b/docs/code-quality/c6298.md @@ -1,10 +1,9 @@ --- +title: "Warning C6298" description: "Learn more about: Warning C6298" -title: Warning C6298 ms.date: 11/04/2016 f1_keywords: ["C6298", "CONST_STRING_TO_WRITABLE_STRING", "__WARNING_CONST_STRING_TO_WRITABLE_STRING"] helpviewer_keywords: ["C6298"] -ms.assetid: 986dc8e7-8596-4223-a66f-8616357d4399 --- # Warning C6298 diff --git a/docs/code-quality/c6299.md b/docs/code-quality/c6299.md index 43c347fecea..2a56ce73b7b 100644 --- a/docs/code-quality/c6299.md +++ b/docs/code-quality/c6299.md @@ -1,10 +1,9 @@ --- +title: "Warning C6299" description: "Learn more about: Warning C6299" -title: Warning C6299 ms.date: 11/04/2016 f1_keywords: ["C6299", "BITFIELD_TO_BOOL_COMPARISON", "__WARNING_BITFIELD_TO_BOOL_COMPARISON"] helpviewer_keywords: ["C6299"] -ms.assetid: 5129ac34-0d4f-4056-aea2-b0df2127dead --- # Warning C6299 diff --git a/docs/code-quality/c6302.md b/docs/code-quality/c6302.md index 1c03b1fe8e5..1de8b8f8611 100644 --- a/docs/code-quality/c6302.md +++ b/docs/code-quality/c6302.md @@ -1,6 +1,6 @@ --- +title: "Warning C6302" description: "Learn more about: Warning C6302" -title: Warning C6302 ms.date: 03/07/2023 f1_keywords: ["C6302", "CHAR_WCHAR_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_CHAR_WCHAR_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6302"] diff --git a/docs/code-quality/c6303.md b/docs/code-quality/c6303.md index 65391970ea7..003309b49f4 100644 --- a/docs/code-quality/c6303.md +++ b/docs/code-quality/c6303.md @@ -1,6 +1,6 @@ --- +title: "Warning C6303" description: "Learn more about: Warning C6303" -title: Warning C6303 ms.date: 03/07/2023 f1_keywords: ["C6303", "WCHAR_CHAR_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_WCHAR_CHAR_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6303"] diff --git a/docs/code-quality/c6305.md b/docs/code-quality/c6305.md index 72f3f0ec9d7..9ffba3948ee 100644 --- a/docs/code-quality/c6305.md +++ b/docs/code-quality/c6305.md @@ -1,10 +1,9 @@ --- +title: "Warning C6305" description: "Learn more about: Warning C6305" -title: Warning C6305 ms.date: 11/04/2016 f1_keywords: ["C6305", "SIZEOF_COUNTOF_MISMATCH", "__WARNING_SIZEOF_COUNTOF_MISMATCH"] helpviewer_keywords: ["C6305"] -ms.assetid: 4b3bdf86-b593-425e-89cb-9282878b21bd --- # Warning C6305 diff --git a/docs/code-quality/c6306.md b/docs/code-quality/c6306.md index 7235deeb6eb..c4d0f81a096 100644 --- a/docs/code-quality/c6306.md +++ b/docs/code-quality/c6306.md @@ -1,10 +1,9 @@ --- +title: "Warning C6306" description: "Learn more about: Warning C6306" -title: Warning C6306 ms.date: 11/04/2016 f1_keywords: ["C6306", "INCORRECT_VARARG_FUNCTIONCALL", "__WARNING_INCORRECT_VARARG_FUNCTIONCALL"] helpviewer_keywords: ["C6306"] -ms.assetid: 7502710c-7e0e-4412-aecc-b6821cb8c182 --- # Warning C6306 diff --git a/docs/code-quality/c6308.md b/docs/code-quality/c6308.md index bfcdecf06d3..0a92764dc8b 100644 --- a/docs/code-quality/c6308.md +++ b/docs/code-quality/c6308.md @@ -1,10 +1,9 @@ --- -title: Warning C6308 +title: "Warning C6308" description: "Understand the causes of Microsoft C/C++ code analysis warning C6308, and learn how to fix them." ms.date: 09/28/2022 f1_keywords: ["C6308", "REALLOCLEAK", "__WARNING_REALLOCLEAK"] helpviewer_keywords: ["C6308"] -ms.assetid: 1162cd96-9037-4576-9858-0c8361a12559 --- # Warning C6308 diff --git a/docs/code-quality/c6310.md b/docs/code-quality/c6310.md index 88dd7cb3800..30516b4684d 100644 --- a/docs/code-quality/c6310.md +++ b/docs/code-quality/c6310.md @@ -1,10 +1,9 @@ --- +title: "Warning C6310" description: "Learn more about: Warning C6310" -title: Warning C6310 ms.date: 11/04/2016 f1_keywords: ["C6310", "ILLEGALEXCEPTEXPRCONST", "__WARNING_ILLEGALEXCEPTEXPRCONST"] helpviewer_keywords: ["C6310"] -ms.assetid: e759eb63-883f-4c3e-bf2f-b924ff511405 --- # Warning C6310 From 08758007a8c80a3f6fa4861719bf4baec891d5f0 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 6 Sep 2025 22:25:04 +0800 Subject: [PATCH 1113/1799] Add leading example sentence in C6284 warning reference --- docs/code-quality/c6284.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/code-quality/c6284.md b/docs/code-quality/c6284.md index 7bb131248f1..81aeb042c5f 100644 --- a/docs/code-quality/c6284.md +++ b/docs/code-quality/c6284.md @@ -19,6 +19,8 @@ Code analysis name: `OBJECT_AS_STRING_ARGUMENT_TO_FORMAT_FUNCTION` ## Example +The following example generates C6284: + ```cpp #include #include From 2b974057a80efce075fa8c02e58418af6fd1a613 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 18:46:09 +0800 Subject: [PATCH 1114/1799] Add "Remarks" headings for warning references in range [C6311, C6400] --- docs/code-quality/c6329.md | 2 +- docs/code-quality/c6330.md | 2 ++ docs/code-quality/c6331.md | 4 ++-- docs/code-quality/c6332.md | 4 ++-- docs/code-quality/c6383.md | 4 ++-- docs/code-quality/c6384.md | 4 ++-- docs/code-quality/c6392.md | 4 ++-- docs/code-quality/c6393.md | 4 ++-- docs/code-quality/c6394.md | 4 ++-- 9 files changed, 17 insertions(+), 15 deletions(-) diff --git a/docs/code-quality/c6329.md b/docs/code-quality/c6329.md index b34263a856d..6a190440063 100644 --- a/docs/code-quality/c6329.md +++ b/docs/code-quality/c6329.md @@ -16,7 +16,7 @@ The program is comparing a number against the return value from a call to `Creat Code analysis name: `POTENTIAL_INCORRECT_RETVAL_CHECK` -## Examples +## Example This code could cause the warning: diff --git a/docs/code-quality/c6330.md b/docs/code-quality/c6330.md index d94d00c081e..a7c0499a438 100644 --- a/docs/code-quality/c6330.md +++ b/docs/code-quality/c6330.md @@ -10,4 +10,6 @@ ms.assetid: 48594e1c-0a4b-4848-8598-ae6d7e08b4e9 > '*type1*' passed as Parameter('*number*') when '*type2*' is required in call to '*function*' +## Remarks + Code analysis name: `POTENTIAL_ARGUMENT_TYPE_MISMATCH` diff --git a/docs/code-quality/c6331.md b/docs/code-quality/c6331.md index b0e322a1d49..b0ba127fcf7 100644 --- a/docs/code-quality/c6331.md +++ b/docs/code-quality/c6331.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6331"] > Invalid parameter: passing MEM_RELEASE and MEM_DECOMMIT in conjunction to *`function`* is not allowed. This results in the failure of this call -This message indicates that an invalid parameter is passed to `VirtualFree` or `VirtualFreeEx`. `VirtualFree` and `VirtualFreeEx` both reject the flags (`MEM_RELEASE | MEM_DECOMMIT`) in combination. Therefore, the values `MEM_DECOMMIT` and `MEM_RELEASE` may not be used together in the same call. - ## Remarks +This message indicates that an invalid parameter is passed to `VirtualFree` or `VirtualFreeEx`. `VirtualFree` and `VirtualFreeEx` both reject the flags (`MEM_RELEASE | MEM_DECOMMIT`) in combination. Therefore, the values `MEM_DECOMMIT` and `MEM_RELEASE` may not be used together in the same call. + It's not required for decommit and release to occur as independent steps. Releasing committed memory will decommit the pages as well. Also, ensure the return value of this function isn't ignored. Code analysis name: `VirtualFreeInvalidParam1` diff --git a/docs/code-quality/c6332.md b/docs/code-quality/c6332.md index acf5ef2d951..2e6ec8cae69 100644 --- a/docs/code-quality/c6332.md +++ b/docs/code-quality/c6332.md @@ -10,10 +10,10 @@ ms.assetid: 93d74b3f-4070-4b48-807e-52b1dfee1330 > Invalid parameter: passing zero as the dwFreeType parameter to '*function*' is not allowed. This results in the failure of this call -This warning indicates that an invalid parameter is being passed to `VirtualFree` or `VirtualFreeEx`. - ## Remarks +This warning indicates that an invalid parameter is being passed to `VirtualFree` or `VirtualFreeEx`. + `VirtualFree` and `VirtualFreeEx` both reject a `dwFreeType` parameter of zero. The `dwFreeType` parameter can be either `MEM_DECOMMIT` or `MEM_RELEASE`. However, the values `MEM_DECOMMIT` and `MEM_RELEASE` may not be used together in the same call. Also, make sure that the return value of the `VirtualFree` function isn't ignored. Code analysis name: `VirtualFreeInvalidParam2` diff --git a/docs/code-quality/c6383.md b/docs/code-quality/c6383.md index 72d0ef8b4fb..61df5f99552 100644 --- a/docs/code-quality/c6383.md +++ b/docs/code-quality/c6383.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6383"] > Buffer overrun due to conversion of an element count into a byte count: an element count is expected for parameter *`parameter_name`* in call to *`function_name`* -This warning indicates that a non-constant byte count is being passed when an element count is instead required. - ## Remarks +This warning indicates that a non-constant byte count is being passed when an element count is instead required. + Typically, this warning occurs when a variable is multiplied by the `sizeof` a type. This issue will likely result in more bytes being copied to the buffer than it can hold. Code analysis name: `ELEMENTS_TO_BYTES` diff --git a/docs/code-quality/c6384.md b/docs/code-quality/c6384.md index 75067282fa5..178e82c949e 100644 --- a/docs/code-quality/c6384.md +++ b/docs/code-quality/c6384.md @@ -10,10 +10,10 @@ ms.assetid: 9c605b61-1485-49a8-847b-41170193dbf4 > Dividing sizeof a pointer by another value -This warning indicates that a size calculation might be incorrect. To calculate the number of elements in an array, you sometimes divide the size of the array by the size of the first element. However, when the array is actually a pointer, the result is typically different than intended. - ## Remarks +This warning indicates that a size calculation might be incorrect. To calculate the number of elements in an array, you sometimes divide the size of the array by the size of the first element. However, when the array is actually a pointer, the result is typically different than intended. + If the pointer is a function parameter and the size of the buffer wasn't passed, it isn't possible to calculate the maximum buffer available. When the pointer is allocated locally, the size used in the allocation should be used. Code analysis name: `DIVIDING_SIZEOF_POINTER` diff --git a/docs/code-quality/c6392.md b/docs/code-quality/c6392.md index b8dc3b2ff4f..882d844c5be 100644 --- a/docs/code-quality/c6392.md +++ b/docs/code-quality/c6392.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6392"] > This expression writes the value of the pointer to the stream. If this is intentional, add an explicit cast to 'void *' -This rule was added in Visual Studio 2022 17.8. - ## Remarks +This rule was added in Visual Studio 2022 17.8. + C++ supports wide character streams such as `std::wostringstream`, and nonwide character streams such as `std::ostringstream`. Trying to print a wide string to a nonwide stream calls the `void*` overload of `operator<<`. This overload prints the address of the wide string instead of the value. Code analysis name: `STREAM_OUTPUT_VOID_PTR` diff --git a/docs/code-quality/c6393.md b/docs/code-quality/c6393.md index a905c012a25..2dc859f2b73 100644 --- a/docs/code-quality/c6393.md +++ b/docs/code-quality/c6393.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6393"] > A lookup table of size 365 isn't sufficient to handle leap years -This rule was added in Visual Studio 2022 17.8. - ## Remarks +This rule was added in Visual Studio 2022 17.8. + In the Gregorian calendar, every year exactly divisible by four is a leap year--except for years that are exactly divisible by 100. The centurial years are also leap years if they're exactly divisible by 400. A leap year bug occurs when software doesn't account for this leap year logic, or uses flawed logic. The can affect reliability, availability, or even the security of the affected system. diff --git a/docs/code-quality/c6394.md b/docs/code-quality/c6394.md index d4a4fe66689..6235fc87555 100644 --- a/docs/code-quality/c6394.md +++ b/docs/code-quality/c6394.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6394"] > A lookup table of size 365 isn't sufficient to handle leap years -This rule was added in Visual Studio 2022 17.8. - ## Remarks +This rule was added in Visual Studio 2022 17.8. + In the Gregorian calendar, every year exactly divisible by four is a leap year--except for years that are exactly divisible by 100. The centurial years are also leap years if they're exactly divisible by 400. A leap year bug occurs when software doesn't account for this leap year logic, or uses flawed logic. The can affect reliability, availability, or even the security of the affected system. From 907d7a720886685977fd8bdb91842410dcefc88e Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 18:46:44 +0800 Subject: [PATCH 1115/1799] Replace term "sample" with "example" for warning references in range [C6311, C6400] --- docs/code-quality/c6331.md | 2 +- docs/code-quality/c6333.md | 2 +- docs/code-quality/c6388.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/code-quality/c6331.md b/docs/code-quality/c6331.md index b0ba127fcf7..cac738ebf89 100644 --- a/docs/code-quality/c6331.md +++ b/docs/code-quality/c6331.md @@ -19,7 +19,7 @@ Code analysis name: `VirtualFreeInvalidParam1` ## Example -The following sample code generates warning C6331: +The following example code generates warning C6331: ```cpp #include diff --git a/docs/code-quality/c6333.md b/docs/code-quality/c6333.md index 3f917962eda..de17123196b 100644 --- a/docs/code-quality/c6333.md +++ b/docs/code-quality/c6333.md @@ -18,7 +18,7 @@ Code analysis name: `VIRTUALFREEINVALIDPARAM3` ## Example -The following code sample generates this warning: +The following code example generates this warning: ```cpp #include diff --git a/docs/code-quality/c6388.md b/docs/code-quality/c6388.md index 540db622f9a..bcc5cf9deb0 100644 --- a/docs/code-quality/c6388.md +++ b/docs/code-quality/c6388.md @@ -37,7 +37,7 @@ void f() } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp // C6388_no_warning.cpp From 5173b8b616e048eb7c6183e9112b6e53212e1716 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 18:52:04 +0800 Subject: [PATCH 1116/1799] Update metadata for warning references in range [C6311, C6400] --- docs/code-quality/c6312.md | 3 +-- docs/code-quality/c6313.md | 3 +-- docs/code-quality/c6314.md | 3 +-- docs/code-quality/c6315.md | 3 +-- docs/code-quality/c6316.md | 3 +-- docs/code-quality/c6317.md | 3 +-- docs/code-quality/c6318.md | 3 +-- docs/code-quality/c6319.md | 3 +-- docs/code-quality/c6320.md | 3 +-- docs/code-quality/c6322.md | 3 +-- docs/code-quality/c6323.md | 3 +-- docs/code-quality/c6324.md | 3 +-- docs/code-quality/c6326.md | 3 +-- docs/code-quality/c6328.md | 3 +-- docs/code-quality/c6329.md | 3 +-- docs/code-quality/c6330.md | 3 +-- docs/code-quality/c6331.md | 2 +- docs/code-quality/c6332.md | 3 +-- docs/code-quality/c6333.md | 3 +-- docs/code-quality/c6334.md | 3 +-- docs/code-quality/c6335.md | 2 +- docs/code-quality/c6336.md | 3 +-- docs/code-quality/c6340.md | 3 +-- docs/code-quality/c6381.md | 3 +-- docs/code-quality/c6383.md | 2 +- docs/code-quality/c6384.md | 3 +-- docs/code-quality/c6385.md | 3 +-- docs/code-quality/c6386.md | 2 +- docs/code-quality/c6387.md | 2 +- docs/code-quality/c6388.md | 3 +-- docs/code-quality/c6389.md | 2 +- docs/code-quality/c6390.md | 2 +- docs/code-quality/c6392.md | 2 +- docs/code-quality/c6393.md | 2 +- docs/code-quality/c6394.md | 2 +- docs/code-quality/c6395.md | 2 +- docs/code-quality/c6396.md | 2 +- docs/code-quality/c6397.md | 2 +- docs/code-quality/c6398.md | 2 +- docs/code-quality/c6400.md | 3 +-- 40 files changed, 40 insertions(+), 66 deletions(-) diff --git a/docs/code-quality/c6312.md b/docs/code-quality/c6312.md index eada1991cc4..c63f31ea716 100644 --- a/docs/code-quality/c6312.md +++ b/docs/code-quality/c6312.md @@ -1,10 +1,9 @@ --- +title: "Warning C6312" description: "Learn more about: Warning C6312" -title: Warning C6312 ms.date: 11/04/2016 f1_keywords: ["C6312", "EXCEPTIONCONTINUEEXECUTION", "__WARNING_EXCEPTIONCONTINUEEXECUTION"] helpviewer_keywords: ["C6312"] -ms.assetid: 1fc8b9a1-e6ba-4799-84c3-31f289576cca --- # Warning C6312 diff --git a/docs/code-quality/c6313.md b/docs/code-quality/c6313.md index b8b7bc12968..c57dfc2e09e 100644 --- a/docs/code-quality/c6313.md +++ b/docs/code-quality/c6313.md @@ -1,10 +1,9 @@ --- +title: "Warning C6313" description: "Learn more about: Warning C6313" -title: Warning C6313 ms.date: 11/04/2016 f1_keywords: ["C6313", "BITANDVSZEROVALUEDFLAG", "__WARNING_BITANDVSZEROVALUEDFLAG"] helpviewer_keywords: ["C6313"] -ms.assetid: 2fb95c62-d81e-4525-9ec7-7723844c806c --- # Warning C6313 diff --git a/docs/code-quality/c6314.md b/docs/code-quality/c6314.md index a0f47a7fee6..8f7303162c3 100644 --- a/docs/code-quality/c6314.md +++ b/docs/code-quality/c6314.md @@ -1,10 +1,9 @@ --- +title: "Warning C6314" description: "Learn more about: Warning C6314" -title: Warning C6314 ms.date: 11/04/2016 f1_keywords: ["C6314", "BITORVSQUESTION", "__WARNING_BITORVSQUESTION"] helpviewer_keywords: ["C6314"] -ms.assetid: 2145ca62-967c-4223-b582-f1481b74f181 --- # Warning C6314 diff --git a/docs/code-quality/c6315.md b/docs/code-quality/c6315.md index e367214b1d6..edb8a62c4c9 100644 --- a/docs/code-quality/c6315.md +++ b/docs/code-quality/c6315.md @@ -1,10 +1,9 @@ --- +title: "Warning C6315" description: "Learn more about: Warning C6315" -title: Warning C6315 ms.date: 11/04/2016 f1_keywords: ["C6315", "BITORVSBITAND", "__WARNING_BITORVSBITAND"] helpviewer_keywords: ["C6315"] -ms.assetid: 4bc932d5-04fd-440d-b3af-e32a8bbc0618 --- # Warning C6315 diff --git a/docs/code-quality/c6316.md b/docs/code-quality/c6316.md index b5c33835081..11ff13efa2d 100644 --- a/docs/code-quality/c6316.md +++ b/docs/code-quality/c6316.md @@ -1,10 +1,9 @@ --- +title: "Warning C6316" description: "Learn more about: Warning C6316" -title: Warning C6316 ms.date: 11/04/2016 f1_keywords: ["C6316", "INAPPROPRIATEUSEOFBITOR", "__WARNING_INAPPROPRIATEUSEOFBITOR"] helpviewer_keywords: ["C6316"] -ms.assetid: ddd6a928-76b1-4d1b-9a9d-af1efcf02e3a --- # Warning C6316 diff --git a/docs/code-quality/c6317.md b/docs/code-quality/c6317.md index 62319ef781f..04b7fef3f49 100644 --- a/docs/code-quality/c6317.md +++ b/docs/code-quality/c6317.md @@ -1,10 +1,9 @@ --- +title: "Warning C6317" description: "Learn more about: Warning C6317" -title: Warning C6317 ms.date: 11/04/2016 f1_keywords: ["C6317", "NOTNOTCOMPLEMENT", "__WARNING_NOTNOTCOMPLEMENT"] helpviewer_keywords: ["C6317"] -ms.assetid: dc771bb8-f596-4514-af0f-4b39658af365 --- # Warning C6317 diff --git a/docs/code-quality/c6318.md b/docs/code-quality/c6318.md index 07cb2c8ccf6..420919c91b0 100644 --- a/docs/code-quality/c6318.md +++ b/docs/code-quality/c6318.md @@ -1,10 +1,9 @@ --- +title: "Warning C6318" description: "Learn more about: Warning C6318" -title: Warning C6318 ms.date: 11/04/2016 f1_keywords: ["C6318", "EXCEPTIONCONTINUESEARCH", "__WARNING_EXCEPTIONCONTINUESEARCH"] helpviewer_keywords: ["C6318"] -ms.assetid: 3284a83e-bb8e-461c-adcc-cfc66ceea05e --- # Warning C6318 diff --git a/docs/code-quality/c6319.md b/docs/code-quality/c6319.md index 4d6642ab6fc..22249d73224 100644 --- a/docs/code-quality/c6319.md +++ b/docs/code-quality/c6319.md @@ -1,10 +1,9 @@ --- +title: "Warning C6319" description: "Learn more about: Warning C6319" -title: Warning C6319 ms.date: 11/04/2016 f1_keywords: ["C6319", "IGNOREDBYCOMMA", "__WARNING_IGNOREDBYCOMMA"] helpviewer_keywords: ["C6319"] -ms.assetid: 3ccfc1d4-820d-48f0-8ff0-8fcfc87c45d6 --- # Warning C6319 diff --git a/docs/code-quality/c6320.md b/docs/code-quality/c6320.md index 9229dc3c398..2f566ee530c 100644 --- a/docs/code-quality/c6320.md +++ b/docs/code-quality/c6320.md @@ -1,10 +1,9 @@ --- +title: "Warning C6320" description: "Learn more about: Warning C6320" -title: Warning C6320 ms.date: 11/04/2016 f1_keywords: ["C6320", "EXCEPTIONEXECUTEHANDLER", "__WARNING_EXCEPTIONEXECUTEHANDLER"] helpviewer_keywords: ["C6320"] -ms.assetid: fb9e568e-b3d4-4ce2-a276-a64ad74d7b1e --- # Warning C6320 diff --git a/docs/code-quality/c6322.md b/docs/code-quality/c6322.md index cd3a8ac4329..e555f1801bd 100644 --- a/docs/code-quality/c6322.md +++ b/docs/code-quality/c6322.md @@ -1,10 +1,9 @@ --- +title: "Warning C6322" description: "Learn more about: Warning C6322" -title: Warning C6322 ms.date: 11/04/2016 f1_keywords: ["C6322", "EXCEPT_BLOCK_EMPTY", "__WARNING_EXCEPT_BLOCK_EMPTY"] helpviewer_keywords: ["C6322"] -ms.assetid: fb23d2b1-b2a0-465c-8bf5-ec039c6c7757 --- # Warning C6322 diff --git a/docs/code-quality/c6323.md b/docs/code-quality/c6323.md index ad59ba354e2..cca253b079b 100644 --- a/docs/code-quality/c6323.md +++ b/docs/code-quality/c6323.md @@ -1,10 +1,9 @@ --- +title: "Warning C6323" description: "Learn more about: Warning C6323" -title: Warning C6323 ms.date: 11/04/2016 f1_keywords: ["C6323", "ARITH_OP_ON_BOOL", "__WARNING_ARITH_OP_ON_BOOL"] helpviewer_keywords: ["C6323"] -ms.assetid: e9ab47d7-21e1-4204-8dad-ed7ec6127647 --- # Warning C6323 diff --git a/docs/code-quality/c6324.md b/docs/code-quality/c6324.md index 063ee638a82..89539cd2214 100644 --- a/docs/code-quality/c6324.md +++ b/docs/code-quality/c6324.md @@ -1,10 +1,9 @@ --- +title: "Warning C6324" description: "Learn more about: Warning C6324" -title: Warning C6324 ms.date: 11/04/2016 f1_keywords: ["C6324", "STRCPY_INSTEAD_OF_STRCMP", "__WARNING_STRCPY_INSTEAD_OF_STRCMP"] helpviewer_keywords: ["C6324"] -ms.assetid: 08675af3-8957-4640-9bd6-01de71ea1042 --- # Warning C6324 diff --git a/docs/code-quality/c6326.md b/docs/code-quality/c6326.md index ed317497b11..9d023afa3ed 100644 --- a/docs/code-quality/c6326.md +++ b/docs/code-quality/c6326.md @@ -1,10 +1,9 @@ --- +title: "Warning C6326" description: "Learn more about: Warning C6326" -title: Warning C6326 ms.date: 11/04/2016 f1_keywords: ["C6326", "CONST_CONST_COMP", "__WARNING_CONST_CONST_COMP"] helpviewer_keywords: ["C6326"] -ms.assetid: 0b606d29-e3c2-48b5-b520-b71b670c19a1 --- # Warning C6326 diff --git a/docs/code-quality/c6328.md b/docs/code-quality/c6328.md index 87bb1426d81..ddaaa046cbe 100644 --- a/docs/code-quality/c6328.md +++ b/docs/code-quality/c6328.md @@ -1,10 +1,9 @@ --- +title: "Warning C6328" description: "Learn more about: Warning C6328" -title: Warning C6328 ms.date: 02/14/2024 f1_keywords: ["C6328", "FORMAT_SIZE_MISMATCH", "__WARNING_FORMAT_SIZE_MISMATCH"] helpviewer_keywords: ["C6328"] -ms.assetid: e25b00fa-d344-4dc9-b322-b4f1ae06f315 --- # Warning C6328 diff --git a/docs/code-quality/c6329.md b/docs/code-quality/c6329.md index 6a190440063..6f3223f7f8b 100644 --- a/docs/code-quality/c6329.md +++ b/docs/code-quality/c6329.md @@ -1,10 +1,9 @@ --- +title: "Warning C6329" description: "Learn more about: Warning C6329" -title: Warning C6329 ms.date: 11/04/2016 f1_keywords: ["C6329", "POTENTIAL_INCORRECT_RETVAL_CHECK", "__WARNING_POTENTIAL_INCORRECT_RETVAL_CHECK"] helpviewer_keywords: ["C6329"] -ms.assetid: 5765bd4d-5fa1-4e51-82d6-c1837b4743db --- # Warning C6329 diff --git a/docs/code-quality/c6330.md b/docs/code-quality/c6330.md index a7c0499a438..2bd84f26fb1 100644 --- a/docs/code-quality/c6330.md +++ b/docs/code-quality/c6330.md @@ -1,10 +1,9 @@ --- +title: "Warning C6330" description: "Learn more about: Warning C6330" -title: Warning C6330 ms.date: 11/04/2016 f1_keywords: ["C6330", "POTENTIAL_ARGUMENT_TYPE_MISMATCH", "__WARNING_POTENTIAL_ARGUMENT_TYPE_MISMATCH"] helpviewer_keywords: ["C6330"] -ms.assetid: 48594e1c-0a4b-4848-8598-ae6d7e08b4e9 --- # Warning C6330 diff --git a/docs/code-quality/c6331.md b/docs/code-quality/c6331.md index cac738ebf89..0b7c6f2ee12 100644 --- a/docs/code-quality/c6331.md +++ b/docs/code-quality/c6331.md @@ -1,5 +1,5 @@ --- -title: Warning C6331 +title: "Warning C6331" description: "Learn more about: Warning C6331" ms.date: 10/03/2022 f1_keywords: ["C6331", "VirtualFreeInvalidParam1", "__WARNING_VIRTUALFREEINVALIDPARAM1"] diff --git a/docs/code-quality/c6332.md b/docs/code-quality/c6332.md index 2e6ec8cae69..392d45b1f78 100644 --- a/docs/code-quality/c6332.md +++ b/docs/code-quality/c6332.md @@ -1,10 +1,9 @@ --- +title: "Warning C6332" description: "Learn more about: Warning C6332" -title: Warning C6332 ms.date: 10/03/2022 f1_keywords: ["C6332", "VirtualFreeInvalidParam2", "__WARNING_VIRTUALFREEINVALIDPARAM2"] helpviewer_keywords: ["C6332"] -ms.assetid: 93d74b3f-4070-4b48-807e-52b1dfee1330 --- # Warning C6332 diff --git a/docs/code-quality/c6333.md b/docs/code-quality/c6333.md index de17123196b..2a8dac30c9c 100644 --- a/docs/code-quality/c6333.md +++ b/docs/code-quality/c6333.md @@ -1,10 +1,9 @@ --- +title: "Warning C6333" description: "Learn more about: Warning C6333" -title: Warning C6333 ms.date: 08/25/2022 f1_keywords: ["C6333", "VIRTUALFREEINVALIDPARAM3", "__WARNING_VIRTUALFREEINVALIDPARAM3"] helpviewer_keywords: ["C6333"] -ms.assetid: 4b8fa4b2-a3a0-4d00-bec7-76686b66fcf9 --- # Warning C6333 diff --git a/docs/code-quality/c6334.md b/docs/code-quality/c6334.md index 5499f3ab135..96de5d6dbbe 100644 --- a/docs/code-quality/c6334.md +++ b/docs/code-quality/c6334.md @@ -1,10 +1,9 @@ --- +title: "Warning C6334" description: "Learn more about: Warning C6334" -title: Warning C6334 ms.date: 08/25/2022 f1_keywords: ["C6334", "SIZEOFEXPR", "__WARNING_SIZEOFEXPR"] helpviewer_keywords: ["C6334"] -ms.assetid: 83c8abfb-b11e-4573-8c6f-95b205d32137 --- # Warning C6334 diff --git a/docs/code-quality/c6335.md b/docs/code-quality/c6335.md index a5f62fe5fe6..662ee5f946e 100644 --- a/docs/code-quality/c6335.md +++ b/docs/code-quality/c6335.md @@ -1,5 +1,5 @@ --- -title: Warning C6335 +title: "Warning C6335" description: "Learn more about: Warning C6335" ms.date: 11/04/2016 f1_keywords: ["C6335", "LEAKING_PROCESS_HANDLE", "__WARNING_LEAKING_PROCESS_HANDLE"] diff --git a/docs/code-quality/c6336.md b/docs/code-quality/c6336.md index a2264c13e82..1f3cc67146d 100644 --- a/docs/code-quality/c6336.md +++ b/docs/code-quality/c6336.md @@ -1,10 +1,9 @@ --- +title: "Warning C6336" description: "Learn more about: Warning C6336" -title: Warning C6336 ms.date: 11/04/2016 f1_keywords: ["C6336", "QUESTIONPRECEDENCE", "__WARNING_QUESTIONPRECEDENCE"] helpviewer_keywords: ["C6336"] -ms.assetid: cf402433-9940-4466-ac15-f94288f51f74 --- # Warning C6336 diff --git a/docs/code-quality/c6340.md b/docs/code-quality/c6340.md index baf564d0267..0e44b1d3988 100644 --- a/docs/code-quality/c6340.md +++ b/docs/code-quality/c6340.md @@ -1,10 +1,9 @@ --- +title: "Warning C6340" description: "Learn more about: Warning C6340" -title: Warning C6340 ms.date: 02/14/2024 f1_keywords: ["C6340", "FORMAT_SIGN_MISMATCH"] helpviewer_keywords: ["C6340"] -ms.assetid: c4fe474f-5a27-4148-ba35-1ef021371e13 --- # Warning C6340 diff --git a/docs/code-quality/c6381.md b/docs/code-quality/c6381.md index 1a753fdbdea..b374965fd48 100644 --- a/docs/code-quality/c6381.md +++ b/docs/code-quality/c6381.md @@ -1,10 +1,9 @@ --- +title: "Warning C6381" description: "Learn more about: Warning C6381" -title: Warning C6381 ms.date: 11/04/2016 f1_keywords: ["C6381", "SHUTDOWN_API", "__WARNING_SHUTDOWN_API"] helpviewer_keywords: ["C6381"] -ms.assetid: c01a3040-26d4-47ac-b72d-7e1292ca435f --- # Warning C6381 diff --git a/docs/code-quality/c6383.md b/docs/code-quality/c6383.md index 61df5f99552..ee46f686092 100644 --- a/docs/code-quality/c6383.md +++ b/docs/code-quality/c6383.md @@ -1,5 +1,5 @@ --- -title: Warning C6383 +title: "Warning C6383" description: "Learn more about: Warning C6383" ms.date: 09/07/2022 f1_keywords: ["C6383", "ELEMENTS_TO_BYTES", "__WARNING_ELEMENTS_TO_BYTES"] diff --git a/docs/code-quality/c6384.md b/docs/code-quality/c6384.md index 178e82c949e..23a603be8b1 100644 --- a/docs/code-quality/c6384.md +++ b/docs/code-quality/c6384.md @@ -1,10 +1,9 @@ --- +title: "Warning C6384" description: "Learn more about: Warning C6384" -title: Warning C6384 ms.date: 10/03/2022 f1_keywords: ["C6384", "DIVIDING_SIZEOF_POINTER", "__WARNING_DIVIDING_SIZEOF_POINTER"] helpviewer_keywords: ["C6384"] -ms.assetid: 9c605b61-1485-49a8-847b-41170193dbf4 --- # Warning C6384 diff --git a/docs/code-quality/c6385.md b/docs/code-quality/c6385.md index ef43fb923b0..8e6446f76b7 100644 --- a/docs/code-quality/c6385.md +++ b/docs/code-quality/c6385.md @@ -1,10 +1,9 @@ --- -title: Warning C6385 +title: "Warning C6385" description: "Describes C++ Code Analysis warning C6385 and how to resolve it." ms.date: 03/16/2020 f1_keywords: ["C6385", "READ_OVERRUN", "__WARNING_READ_OVERRUN"] helpviewer_keywords: ["C6385"] -ms.assetid: 3e4961e7-0f09-42a8-8cc2-151109dfdbda --- # Warning C6385 diff --git a/docs/code-quality/c6386.md b/docs/code-quality/c6386.md index 7aa56f9f9f8..1b08ddf6bdf 100644 --- a/docs/code-quality/c6386.md +++ b/docs/code-quality/c6386.md @@ -1,6 +1,6 @@ --- +title: "Warning C6386" description: "Learn more about: Warning C6386" -title: Warning C6386 ms.date: 4/30/2025 f1_keywords: ["C6386", "WRITE_OVERRUN", "__WARNING_WRITE_OVERRUN"] helpviewer_keywords: ["C6386"] diff --git a/docs/code-quality/c6387.md b/docs/code-quality/c6387.md index a925d0b3977..fc082680d9d 100644 --- a/docs/code-quality/c6387.md +++ b/docs/code-quality/c6387.md @@ -1,5 +1,5 @@ --- -title: Warning C6387 +title: "Warning C6387" description: "Learn more about: Warning C6387" ms.date: 11/04/2016 f1_keywords: ["C6387", "INVALID_PARAM_VALUE_1", "__WARNING_INVALID_PARAM_VALUE_1"] diff --git a/docs/code-quality/c6388.md b/docs/code-quality/c6388.md index bcc5cf9deb0..229efeee446 100644 --- a/docs/code-quality/c6388.md +++ b/docs/code-quality/c6388.md @@ -1,10 +1,9 @@ --- +title: "Warning C6388" description: "Learn more about: Warning C6388" -title: Warning C6388 ms.date: 11/04/2016 f1_keywords: ["C6388", "INVALID_PARAM_VALUE_2", "__WARNING_INVALID_PARAM_VALUE_2"] helpviewer_keywords: ["C6388"] -ms.assetid: 667fe9cf-cc53-49f9-b6c0-6ee87c397568 --- # Warning C6388 diff --git a/docs/code-quality/c6389.md b/docs/code-quality/c6389.md index 5838f22f32a..8c786b91f4b 100644 --- a/docs/code-quality/c6389.md +++ b/docs/code-quality/c6389.md @@ -1,5 +1,5 @@ --- -title: Warning C6389 +title: "Warning C6389" description: "Describes the Microsoft C/C++ code analysis warning C6389, its causes, and how to address it." ms.date: 06/09/2021 f1_keywords: ["C6389", "MARK_INTERNAL_OR_MISSING_COMMON_DECL"] diff --git a/docs/code-quality/c6390.md b/docs/code-quality/c6390.md index f5895dc43fc..d0ea5f23556 100644 --- a/docs/code-quality/c6390.md +++ b/docs/code-quality/c6390.md @@ -1,5 +1,5 @@ --- -title: Warning C6390 +title: "Warning C6390" description: "Describes the Microsoft C/C++ code analysis warning C6390, its causes, and how to address it." ms.date: 06/17/2022 f1_keywords: ["C6390", "NO_NULLCHECK_FOR_THIS"] diff --git a/docs/code-quality/c6392.md b/docs/code-quality/c6392.md index 882d844c5be..63f9a7c3139 100644 --- a/docs/code-quality/c6392.md +++ b/docs/code-quality/c6392.md @@ -1,6 +1,6 @@ --- +title: "Warning C6392" description: "Learn more about: Warning C6392" -title: Warning C6392 ms.date: 03/06/2024 f1_keywords: ["C6392", "STREAM_OUTPUT_VOID_PTR", "__STREAM_OUTPUT_VOID_PTR"] helpviewer_keywords: ["C6392"] diff --git a/docs/code-quality/c6393.md b/docs/code-quality/c6393.md index 2dc859f2b73..2de6638f3ab 100644 --- a/docs/code-quality/c6393.md +++ b/docs/code-quality/c6393.md @@ -1,5 +1,5 @@ --- -title: Warning C6393 +title: "Warning C6393" description: "Learn more about: Warning C6393" ms.date: 11/29/2023 f1_keywords: ["C6393", "LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP", "__WARNING_LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP"] diff --git a/docs/code-quality/c6394.md b/docs/code-quality/c6394.md index 6235fc87555..913accff0e0 100644 --- a/docs/code-quality/c6394.md +++ b/docs/code-quality/c6394.md @@ -1,5 +1,5 @@ --- -title: Warning C6394 +title: "Warning C6394" description: "Learn more about: Warning C6394" ms.date: 11/29/2023 f1_keywords: ["C6394", "LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP_MUTABLE", "__WARNING_LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP_MUTABLE"] diff --git a/docs/code-quality/c6395.md b/docs/code-quality/c6395.md index fba3e04720f..9c39bf5d499 100644 --- a/docs/code-quality/c6395.md +++ b/docs/code-quality/c6395.md @@ -1,5 +1,5 @@ --- -title: Warning C6395 +title: "Warning C6395" description: "Describes the Microsoft C/C++ code analysis warning C6395, its causes, and how to address it." ms.date: 10/12/2023 f1_keywords: ["C6395", "EVAL_ORDER_CHANGE"] diff --git a/docs/code-quality/c6396.md b/docs/code-quality/c6396.md index 6bd3b0952bf..3e7a8dfb0c5 100644 --- a/docs/code-quality/c6396.md +++ b/docs/code-quality/c6396.md @@ -1,6 +1,6 @@ --- +title: "Warning C6396" description: "Learn more about: Warning C6396: sizeof('integerConstant') always returns the size of the underlying integer type" -title: Warning C6396 ms.date: 02/05/2024 f1_keywords: ["C6396", "SIZEOF_CONSTANT"] helpviewer_keywords: ["C6396"] diff --git a/docs/code-quality/c6397.md b/docs/code-quality/c6397.md index 4247b431616..4b0da9bc420 100644 --- a/docs/code-quality/c6397.md +++ b/docs/code-quality/c6397.md @@ -1,6 +1,6 @@ --- +title: "Warning C6397" description: "Learn more about: Warning C6397: The address-of operator cannot return null pointer in well-defined code" -title: Warning C6397 ms.date: 02/05/2024 f1_keywords: ["C6397", "DUBIOUS_NULL_CHECK"] helpviewer_keywords: ["C6397"] diff --git a/docs/code-quality/c6398.md b/docs/code-quality/c6398.md index 5ee996202d7..6acd592bc83 100644 --- a/docs/code-quality/c6398.md +++ b/docs/code-quality/c6398.md @@ -1,6 +1,6 @@ --- +title: "Warning C6398" description: "Learn more about: Warning C6398: The address-of a field cannot be null in well-defined code" -title: Warning C6398 ms.date: 02/05/2024 f1_keywords: ["C6398", "DUBIOUS_NULL_CHECK_FIELD"] helpviewer_keywords: ["C6398"] diff --git a/docs/code-quality/c6400.md b/docs/code-quality/c6400.md index 2d2d4ac5590..ed5d187c376 100644 --- a/docs/code-quality/c6400.md +++ b/docs/code-quality/c6400.md @@ -1,10 +1,9 @@ --- +title: "Warning C6400" description: "Learn more about: Warning C6400" -title: Warning C6400 ms.date: 11/04/2016 f1_keywords: ["C6400", "LOCALE_DEPENDENT_CONSTANT_STRING_COMPARISON", "__WARNING_LOCALE_DEPENDENT_CONSTANT_STRING_COMPARISON"] helpviewer_keywords: ["C6400"] -ms.assetid: 35808969-1d43-41e8-bcda-33635637fb26 --- # Warning C6400 From 0c2f3c810bbf7893279d69488d83c98e49153a8e Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 18:58:56 +0800 Subject: [PATCH 1117/1799] Add leading example sentence for warning references in range [C6311, C6400] --- docs/code-quality/c6328.md | 2 ++ docs/code-quality/c6340.md | 2 ++ docs/code-quality/c6389.md | 2 ++ docs/code-quality/c6390.md | 2 ++ docs/code-quality/c6395.md | 2 ++ docs/code-quality/c6396.md | 2 ++ docs/code-quality/c6397.md | 2 ++ docs/code-quality/c6398.md | 2 ++ 8 files changed, 16 insertions(+) diff --git a/docs/code-quality/c6328.md b/docs/code-quality/c6328.md index ddaaa046cbe..6c6c6dd36a0 100644 --- a/docs/code-quality/c6328.md +++ b/docs/code-quality/c6328.md @@ -18,6 +18,8 @@ Code analysis name: `FORMAT_SIZE_MISMATCH` ## Example +The following example generates C6328: + ```cpp #include diff --git a/docs/code-quality/c6340.md b/docs/code-quality/c6340.md index 0e44b1d3988..7733f30f873 100644 --- a/docs/code-quality/c6340.md +++ b/docs/code-quality/c6340.md @@ -18,6 +18,8 @@ Code analysis name: `FORMAT_SIGN_MISMATCH` ## Example +The following example generates C6340: + ```cpp #include diff --git a/docs/code-quality/c6389.md b/docs/code-quality/c6389.md index 8c786b91f4b..0b4fb2a1d54 100644 --- a/docs/code-quality/c6389.md +++ b/docs/code-quality/c6389.md @@ -21,6 +21,8 @@ Code analysis name: `MARK_INTERNAL_OR_MISSING_COMMON_DECL` ## Example +The following example generates C6389: + ```cpp // A.h struct X; diff --git a/docs/code-quality/c6390.md b/docs/code-quality/c6390.md index d0ea5f23556..225bfd16e4f 100644 --- a/docs/code-quality/c6390.md +++ b/docs/code-quality/c6390.md @@ -17,6 +17,8 @@ Code analysis name: `NO_NULLCHECK_FOR_THIS` ## Example +The following example generates C6390: + ```cpp struct X { diff --git a/docs/code-quality/c6395.md b/docs/code-quality/c6395.md index 9c39bf5d499..52a0feeb35a 100644 --- a/docs/code-quality/c6395.md +++ b/docs/code-quality/c6395.md @@ -17,6 +17,8 @@ Code analysis name: `EVAL_ORDER_CHANGE` ## Example +The following example generates C6395: + ```cpp void foo(int* a, int i) { diff --git a/docs/code-quality/c6396.md b/docs/code-quality/c6396.md index 3e7a8dfb0c5..210935d9f60 100644 --- a/docs/code-quality/c6396.md +++ b/docs/code-quality/c6396.md @@ -17,6 +17,8 @@ This check ignores character literals because `buffer_size += sizeof(UNICODE_NUL ## Example +The following example generates C6396: + ```cpp void f() { diff --git a/docs/code-quality/c6397.md b/docs/code-quality/c6397.md index 4b0da9bc420..a45d0582c08 100644 --- a/docs/code-quality/c6397.md +++ b/docs/code-quality/c6397.md @@ -17,6 +17,8 @@ The address-of operator returns the address of its operand. This value should ne ## Example +The following example generates C6397: + ```cpp bool isNull(int *a) { diff --git a/docs/code-quality/c6398.md b/docs/code-quality/c6398.md index 6acd592bc83..072a3669b65 100644 --- a/docs/code-quality/c6398.md +++ b/docs/code-quality/c6398.md @@ -17,6 +17,8 @@ The address-of operator returns the address of its operand. This value should ne ## Example +The following example generates C6398: + ```cpp struct A { int* x; }; From ee62f20b2d557b4fb17bc34fa0406dcd5bc4741c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 22:14:19 +0800 Subject: [PATCH 1118/1799] Fix some typos in "Troubleshoot function inlining impact on build time" --- .../tutorials/build-insights-function-view.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/build-insights/tutorials/build-insights-function-view.md b/docs/build-insights/tutorials/build-insights-function-view.md index bd0ccd9e319..162df2e6c9e 100644 --- a/docs/build-insights/tutorials/build-insights-function-view.md +++ b/docs/build-insights/tutorials/build-insights-function-view.md @@ -53,7 +53,7 @@ Set the optimization level to maximum optimizations: ## Run Build Insights -On a project of your choosing, and using the **Release** build options set in the previous section, run Build Insights by choosing from the main menu **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project and not for just the few files may be dirty right now. +On a project of your choosing, and using the **Release** build options set in the previous section, run Build Insights by choosing from the main menu **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project and not for just the few files that may be dirty right now. :::image type="content" source="./media/build-insights-rebuild-project.png" alt-text="Screenshot of the main menu with Run Build Insights on Selection > Rebuild selected."::: @@ -69,9 +69,9 @@ In the Function Name column, performPhysicsCalculations() is highlighted and mar The **Time [sec, %]** column shows how long it took to compile each function in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among functions based on their use of parallel compiler threads. For example, if two different threads are compiling two different functions simultaneously within a one-second period, each function's WCTR is recorded as 0.5 seconds. This reflects each function's proportional share of the total compilation time, taking into account the resources each consumed during parallel execution. Thus, WCTR provides a better measure of the impact each function has on the overall build time in environments where multiple compilation activities occur simultaneously. -The **Forceinline Size** column shows roughly how many instructions were generated for the function. Click the chevron before the function name to see the individual inlined functions that were expanded in that function how roughly how many instructions were generated for each. +The **Forceinline Size** column shows roughly how many instructions were generated for the function. Click the chevron before the function name to see the individual inlined functions that were expanded in that function and roughly how many instructions were generated for each. -You can sort the list by clicking on the **Time** column to see which functions are taking the most time to compile. A 'fire' icon indicates that cost of generating that function is high and is worth investigating. Excessive use of `__forceinline` functions can significantly slow compilation. +You can sort the list by clicking on the **Time** column to see which functions are taking the most time to compile. A 'fire' icon indicates that the cost of generating that function is high and is worth investigating. Excessive use of `__forceinline` functions can significantly slow compilation. You can search for a specific function by using the **Filter Functions** box. If a function's code generation time is too small, it doesn't appear in the **Functions** View. @@ -89,7 +89,7 @@ By selecting the chevron before that function, and then sorting the **Forceinlin performPhysicsCalculations() is expanded and shows a long list of functions that were inlined inside it. There are multiple instances of functions such as complexOperation(), recursiveHelper(), and sin() shown. The Forceinline Size column shows that complexOperation() is the largest inlined function at 315 instructions. recursiveHelper() has 119 instructions. Sin() has 75 instructions, but there are many more instances of it than the other functions. :::image-end::: -There are some larger inlined functions, such as `Vector2D::complexOperation()` and `Vector2D::recursiveHelper()` that are contributing to the problem. But there are many more instances (not all shown here) of `Vector2d::sin(float)`, `Vector2d::cos(float)`, `Vector2D::power(float,int)`, and `Vector2D::factorial(int)`. When you add those up, the total number of generated instructions quickly exceeds the few larger generated functions. +There are some larger inlined functions, such as `Vector2D::complexOperation()` and `Vector2D::recursiveHelper()` that are contributing to the problem. But there are many more instances (not all shown here) of `Vector2D::sin(float)`, `Vector2D::cos(float)`, `Vector2D::power(float,int)`, and `Vector2D::factorial(int)`. When you add those up, the total number of generated instructions quickly exceeds the few larger generated functions. Looking at those functions in the source code, we see that execution time is going to be spent inside loops. For example, here's the code for `factorial()`: @@ -108,7 +108,7 @@ static __forceinline T factorial(int n) Perhaps the overall cost of calling this function is insignificant compared to the cost of the function itself. Making a function inline is most beneficial when the time it takes to call the function (pushing arguments on the stack, jumping to the function, popping return arguments, and returning from the function) is roughly similar to the time it takes to execute the function, and when the function is called a lot. When that's not the case, there may be diminishing returns on making it inline. We can try removing the `__forceinline` directive from it to see if it helps the build time. The code for `power`, `sin()`, and `cos()` is similar in that the code consists of a loop that executes many times. We can try removing the `__forceinline` directive from those functions as well. -We rerun Build Insights from the main menu by choosing **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. We choose **Rebuild** instead of **Build** to measure the build time for the entire project, as before, and not for just the few files may be dirty right now. +We rerun Build Insights from the main menu by choosing **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. We choose **Rebuild** instead of **Build** to measure the build time for the entire project, as before, and not for just the few files that may be dirty right now. The build time goes from 25.181 seconds to 13.376 seconds and the `performPhysicsCalculations` function doesn't show up anymore in the **Functions** view because it doesn't contribute enough to the build time to be counted. @@ -116,7 +116,7 @@ The build time goes from 25.181 seconds to 13.376 seconds and the `performPhysic In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon. :::image-end::: -The Diagnostics Session time is the overall time it took do the build plus any overhead for gathering the Build Insights data. +The Diagnostics Session time is the overall time it took to do the build plus any overhead for gathering the Build Insights data. The next step would be to profile the application to see if the performance of the application is negatively impacted by the change. If it is, we can selectively add `__forceinline` back as needed. From 5dfea9110e4e705578807a4e717bb7e6e5f2ad3f Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 22:20:35 +0800 Subject: [PATCH 1119/1799] Fix wrong link target for `/O2` in "Troubleshoot function inlining impact on build time" --- docs/build-insights/tutorials/build-insights-function-view.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/tutorials/build-insights-function-view.md b/docs/build-insights/tutorials/build-insights-function-view.md index 162df2e6c9e..621e3344928 100644 --- a/docs/build-insights/tutorials/build-insights-function-view.md +++ b/docs/build-insights/tutorials/build-insights-function-view.md @@ -45,7 +45,7 @@ Set the optimization level to maximum optimizations: 1. In the **Solution Explorer**, right-click the project name and select **Properties**. 1. In the project properties, navigate to **C/C++** > **Optimization**. -1. Set the **Optimization** dropdown to **Maximum Optimization (Favor Speed) ([`/O2`](../../build/reference/ob-inline-function-expansion.md))**. +1. Set the **Optimization** dropdown to **Maximum Optimization (Favor Speed) ([`/O2`](../../build/reference/o1-o2-minimize-size-maximize-speed.md))**. :::image type="content" source="./media/max-optimization-setting.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Configuration Properties > C/C++ > Optimization. The Optimization dropdown is set to Maximum Optimization (Favor Speed) (/O2)."::: From 508659d6cdf450a2e8aa053902661f068ceb158d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 22:40:39 +0800 Subject: [PATCH 1120/1799] Add missing leading underscore for `_MBCS` and `_mbsrev` in "Using generic-text mappings" topic --- docs/c-runtime-library/using-generic-text-mappings.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/using-generic-text-mappings.md b/docs/c-runtime-library/using-generic-text-mappings.md index 388ffd33974..5b2ef0c7e67 100644 --- a/docs/c-runtime-library/using-generic-text-mappings.md +++ b/docs/c-runtime-library/using-generic-text-mappings.md @@ -21,7 +21,7 @@ To simplify code development for various international markets, the Microsoft ru | `_MBCS` | Multibyte-character | `_tcsrev` maps to `_mbsrev` | | None (the default: both `_UNICODE` and `_MBCS` not defined) | SBCS (ASCII) | `_tcsrev` maps to `strrev` | -For example, the generic-text function `_tcsrev`, defined in TCHAR.H, maps to `mbsrev` if `MBCS` has been defined in your program, or to `_wcsrev` if `_UNICODE` has been defined. Otherwise `_tcsrev` maps to `strrev`. +For example, the generic-text function `_tcsrev`, defined in TCHAR.H, maps to `_mbsrev` if `_MBCS` has been defined in your program, or to `_wcsrev` if `_UNICODE` has been defined. Otherwise `_tcsrev` maps to `strrev`. The generic-text data type `_TCHAR`, also defined in TCHAR.H, maps to type **`char`** if `_MBCS` is defined, to type **`wchar_t`** if `_UNICODE` is defined, and to type **`char`** if neither constant is defined. Other data type mappings are provided in TCHAR.H for programming convenience, but `_TCHAR` is the type that is most useful. @@ -45,7 +45,7 @@ _TCHAR *RetVal, *szString; RetVal = _tcsrev(szString); ``` -If `MBCS` has been defined, the preprocessor maps the preceding fragment to the following code: +If `_MBCS` has been defined, the preprocessor maps the preceding fragment to the following code: ```C char *RetVal, *szString; From fa38646ce5f8badf1904999dfe48ef0034c3df8a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 22:43:22 +0800 Subject: [PATCH 1121/1799] Add backticks in "Using generic-text mappings" topic --- docs/c-runtime-library/using-generic-text-mappings.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/c-runtime-library/using-generic-text-mappings.md b/docs/c-runtime-library/using-generic-text-mappings.md index 5b2ef0c7e67..c55c47f89e8 100644 --- a/docs/c-runtime-library/using-generic-text-mappings.md +++ b/docs/c-runtime-library/using-generic-text-mappings.md @@ -11,7 +11,7 @@ ms.assetid: 2848121c-e51f-4b9b-a2e6-833ece4b0cb3 **Microsoft Specific** -To simplify code development for various international markets, the Microsoft run-time library provides Microsoft-specific "generic-text" mappings for many data types, routines, and other objects. These mappings are defined in TCHAR.H. You can use these name mappings to write generic code that can be compiled for any of the three kinds of character sets: ASCII (SBCS), MBCS, or Unicode, depending on a manifest constant you define using a `#define` statement. Generic-text mappings are Microsoft extensions that aren't ANSI compatible. +To simplify code development for various international markets, the Microsoft run-time library provides Microsoft-specific "generic-text" mappings for many data types, routines, and other objects. These mappings are defined in `TCHAR.H`. You can use these name mappings to write generic code that can be compiled for any of the three kinds of character sets: ASCII (SBCS), MBCS, or Unicode, depending on a manifest constant you define using a `#define` statement. Generic-text mappings are Microsoft extensions that aren't ANSI compatible. ### Preprocessor directives for generic-text mappings @@ -21,13 +21,13 @@ To simplify code development for various international markets, the Microsoft ru | `_MBCS` | Multibyte-character | `_tcsrev` maps to `_mbsrev` | | None (the default: both `_UNICODE` and `_MBCS` not defined) | SBCS (ASCII) | `_tcsrev` maps to `strrev` | -For example, the generic-text function `_tcsrev`, defined in TCHAR.H, maps to `_mbsrev` if `_MBCS` has been defined in your program, or to `_wcsrev` if `_UNICODE` has been defined. Otherwise `_tcsrev` maps to `strrev`. +For example, the generic-text function `_tcsrev`, defined in `TCHAR.H`, maps to `_mbsrev` if `_MBCS` has been defined in your program, or to `_wcsrev` if `_UNICODE` has been defined. Otherwise `_tcsrev` maps to `strrev`. -The generic-text data type `_TCHAR`, also defined in TCHAR.H, maps to type **`char`** if `_MBCS` is defined, to type **`wchar_t`** if `_UNICODE` is defined, and to type **`char`** if neither constant is defined. Other data type mappings are provided in TCHAR.H for programming convenience, but `_TCHAR` is the type that is most useful. +The generic-text data type `_TCHAR`, also defined in `TCHAR.H`, maps to type **`char`** if `_MBCS` is defined, to type **`wchar_t`** if `_UNICODE` is defined, and to type **`char`** if neither constant is defined. Other data type mappings are provided in `TCHAR.H` for programming convenience, but `_TCHAR` is the type that is most useful. ### Generic-Text Data Type Mappings -| Generic-text data type name | SBCS (_UNICODE, _MBCS not defined) | _MBCS defined | _UNICODE defined | +| Generic-text data type name | SBCS (`_UNICODE`, `_MBCS` not defined) | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| | `_TCHAR` | **`char`** | **`char`** | **`wchar_t`** | | `_TINT` | **`int`** | **`int`** | `wint_t` | From e05522ca4a62cd5973699514f3a51d2fea2e5555 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 22:44:41 +0800 Subject: [PATCH 1122/1799] Clean up unneeded `./` link prefix in "Using generic-text mappings" topic --- .../c-runtime-library/using-generic-text-mappings.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/c-runtime-library/using-generic-text-mappings.md b/docs/c-runtime-library/using-generic-text-mappings.md index c55c47f89e8..d2d9e78c71b 100644 --- a/docs/c-runtime-library/using-generic-text-mappings.md +++ b/docs/c-runtime-library/using-generic-text-mappings.md @@ -36,7 +36,7 @@ The generic-text data type `_TCHAR`, also defined in `TCHAR.H`, maps to type **` | `_TXCHAR` | **`char`** | **`unsigned char`** | **`wchar_t`** | | `_T` or `_TEXT` | No effect (removed by preprocessor) | No effect (removed by preprocessor) | `L` (converts following character or string to its Unicode counterpart) | -For a complete list of generic-text mappings of routines, variables, and other objects, see [Generic-text mappings](./generic-text-mappings.md). +For a complete list of generic-text mappings of routines, variables, and other objects, see [Generic-text mappings](generic-text-mappings.md). The following code fragments illustrate the use of `_TCHAR` and `_tcsrev` for mapping to the MBCS, Unicode, and SBCS models. @@ -72,8 +72,8 @@ These macros let you write, maintain, and compile a single source code file usin ## See also -[Generic-text mappings](./generic-text-mappings.md)\ -[Data type mappings](./data-type-mappings.md)\ -[Constant and global variable mappings](./constant-and-global-variable-mappings.md)\ -[Routine mappings](./routine-mappings.md)\ -[A sample generic-text program](./a-sample-generic-text-program.md) +[Generic-text mappings](generic-text-mappings.md)\ +[Data type mappings](data-type-mappings.md)\ +[Constant and global variable mappings](constant-and-global-variable-mappings.md)\ +[Routine mappings](routine-mappings.md)\ +[A sample generic-text program](a-sample-generic-text-program.md) From 2270f667375f337301093040e2c8c2d9aa66eade Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 22:45:44 +0800 Subject: [PATCH 1123/1799] Update metadata in "Using generic-text mappings" topic --- docs/c-runtime-library/using-generic-text-mappings.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/c-runtime-library/using-generic-text-mappings.md b/docs/c-runtime-library/using-generic-text-mappings.md index d2d9e78c71b..c40da0e91c3 100644 --- a/docs/c-runtime-library/using-generic-text-mappings.md +++ b/docs/c-runtime-library/using-generic-text-mappings.md @@ -1,11 +1,10 @@ --- title: "Using Generic-Text Mappings" description: "An introduction to Microsoft-specific mappings for data types, routines, and other objects in the C runtime." +ms.date: 11/04/2016 ms.topic: "concept-article" -ms.date: "11/04/2016" f1_keywords: ["_UNICODE"] helpviewer_keywords: ["_TXCHAR type", "TINT type", "_TCHAR type", "TSCHAR type", "TEXT type", "TCHAR type", "TCHAR.H data types, mappings defined in", "generic-text data types", "_TINT type", "TUCHAR type", "_UNICODE constant", "TXCHAR type", "generic-text mappings", "_TSCHAR type", "T type", "mappings, generic-text", "_TUCHAR type", "MBCS data type", "_MBCS data type", "_TEXT type", "UNICODE constant", "_T type"] -ms.assetid: 2848121c-e51f-4b9b-a2e6-833ece4b0cb3 --- # Using generic-text mappings From 028ba9aeb6edca52936adafaadbb28621b3ba917 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 23:00:36 +0800 Subject: [PATCH 1124/1799] Add "Remarks" headings for warning references in range [C6401, C6999] --- docs/code-quality/c6500.md | 4 ++-- docs/code-quality/c6501.md | 4 ++-- docs/code-quality/c6503.md | 4 ++-- docs/code-quality/c6504.md | 4 ++-- docs/code-quality/c6508.md | 4 ++-- docs/code-quality/c6511.md | 4 ++-- docs/code-quality/c6513.md | 4 ++-- docs/code-quality/c6516.md | 4 ++-- docs/code-quality/c6517.md | 4 ++-- docs/code-quality/c6522.md | 4 ++-- docs/code-quality/c6525.md | 4 ++-- docs/code-quality/c6530.md | 4 ++-- docs/code-quality/c6551.md | 2 ++ docs/code-quality/c6552.md | 2 ++ docs/code-quality/c6701.md | 2 ++ docs/code-quality/c6702.md | 2 ++ docs/code-quality/c6703.md | 2 ++ docs/code-quality/c6704.md | 2 ++ docs/code-quality/c6705.md | 2 ++ docs/code-quality/c6706.md | 2 ++ docs/code-quality/c6993.md | 2 ++ docs/code-quality/c6995.md | 2 ++ 22 files changed, 44 insertions(+), 24 deletions(-) diff --git a/docs/code-quality/c6500.md b/docs/code-quality/c6500.md index db2024951ba..1c98588c2c6 100644 --- a/docs/code-quality/c6500.md +++ b/docs/code-quality/c6500.md @@ -10,11 +10,11 @@ ms.assetid: bfc61ec1-8ac5-4465-a23c-91418fbc4552 > Invalid annotation: value for '*name*' property is invalid +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that a property value used in the annotation isn't valid. For example, it can occur if an incorrect level of dereference is used in the `Deref` property, or if you use a constant value that is larger than `size_t` for properties like `ElementSize`. Code analysis name: `INVALID_ATTRIBUTE_PROPERTY` diff --git a/docs/code-quality/c6501.md b/docs/code-quality/c6501.md index 437e4e78f41..1c8d91a6e82 100644 --- a/docs/code-quality/c6501.md +++ b/docs/code-quality/c6501.md @@ -10,11 +10,11 @@ ms.assetid: f9e8b847-2516-4bbb-bb1c-c87cfbacf254 > Annotation conflict: '*name*' property conflicts with previously specified property +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates the presence of conflicting properties in the annotation. The warning typically occurs when multiple properties that serve similar purpose are used to annotate a parameter or return value. To correct the warning, you must choose the property that best addresses your need. Code analysis name: `CONFLICTING_ATTRIBUTE_PROPERTY_VALUES` diff --git a/docs/code-quality/c6503.md b/docs/code-quality/c6503.md index 919cad1a16e..7f5f7797d87 100644 --- a/docs/code-quality/c6503.md +++ b/docs/code-quality/c6503.md @@ -10,11 +10,11 @@ ms.assetid: a6212938-bef9-4830-becb-6baa70b53e97 > Invalid annotation: references and arrays may not be marked `Null=Yes` or `Null=Maybe` +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that `Null` property is incorrectly used on a reference or array type. A reference or array type holds the address of an object and must point to a valid object. Because reference and array types can't be null, you must correct the error by either removing the `Null` property or by setting the `Null` property value to `No`. Code analysis name: `REFERENCES_CANT_BE_NULL` diff --git a/docs/code-quality/c6504.md b/docs/code-quality/c6504.md index d7683b709d0..2039768ccea 100644 --- a/docs/code-quality/c6504.md +++ b/docs/code-quality/c6504.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6504"] > Invalid annotation: property may only be used on values of pointer, pointer-to-member, or array type -This warning indicates the use of a pointer-specific SAL annotation on a non-pointer data type. - ## Remarks +This warning indicates the use of a pointer-specific SAL annotation on a non-pointer data type. + For more information about what data types are supported by properties, see [Annotation Properties](using-sal-annotations-to-reduce-c-cpp-code-defects.md). Code analysis name: `NULL_ON_NON_POINTER` diff --git a/docs/code-quality/c6508.md b/docs/code-quality/c6508.md index 3915b736ae7..7a834ab3fef 100644 --- a/docs/code-quality/c6508.md +++ b/docs/code-quality/c6508.md @@ -10,11 +10,11 @@ ms.assetid: ac5b23c8-ab9e-481b-bc97-8404f0b63100 > Invalid annotation: write access is not allowed on const values +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that the Access property specified on a const parameter implies that it can be written to. For constant values, Access=Read is the only valid setting. Code analysis name: `WRITE_ACCESS_ON_CONST` diff --git a/docs/code-quality/c6511.md b/docs/code-quality/c6511.md index 262a03838f3..41553d3024e 100644 --- a/docs/code-quality/c6511.md +++ b/docs/code-quality/c6511.md @@ -10,11 +10,11 @@ ms.assetid: 1a0ac213-c205-4fb1-9bc3-3dc7885329fa > Invalid annotation: MustCheck property must be Yes or No +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates an invalid value for `MustCheck` property was specified. The only valid values for this property are: Yes and No. Code analysis name: `MUSTCHECK_MAYBE` diff --git a/docs/code-quality/c6513.md b/docs/code-quality/c6513.md index be19005461a..7127c046f3c 100644 --- a/docs/code-quality/c6513.md +++ b/docs/code-quality/c6513.md @@ -10,11 +10,11 @@ ms.assetid: b27780ac-b237-4b26-a796-68a920da73a3 > Invalid annotation: ElementSizeConst requires additional size properties +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that `ElementSizeConst` requires other properties that are missing from the annotation. Specifying `ElementSizeConst` alone doesn't provide any benefit to the analysis process. In addition to specifying `ElementSize`, other properties such as `ValidElementsConst` or `WritableElementsConst` must also be specified. Code analysis name: `ELEMENT_SIZE_WITHOUT_BUFFER_SIZE` diff --git a/docs/code-quality/c6516.md b/docs/code-quality/c6516.md index 7bb9fb56826..02f2456b7bd 100644 --- a/docs/code-quality/c6516.md +++ b/docs/code-quality/c6516.md @@ -10,11 +10,11 @@ ms.assetid: 461078c8-18d4-49ca-80a2-a15736f429a0 > Invalid annotation: no properties specified for '*name*' attribute +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that either no property was specified in the attribute or the property that was specified is invalid; therefore, the attribute can't be considered complete. Code analysis name: `NO_PROPERTIES_ON_ATTRIBUTE` diff --git a/docs/code-quality/c6517.md b/docs/code-quality/c6517.md index b7ce49aa83f..7cefd9e4e01 100644 --- a/docs/code-quality/c6517.md +++ b/docs/code-quality/c6517.md @@ -10,11 +10,11 @@ ms.assetid: 96822155-8b2a-4699-980f-744afff84ca8 > Invalid annotation: 'SAL_readableTo' property may not be specified on buffers that are not readable: '*Parameter*'. +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that `SAL_readableTo` property doesn't have the required read access. You can't use this property to annotate a parameter without providing read access. Code analysis name: `VALID_SIZE_ON_NON_READABLE_BUFFER` diff --git a/docs/code-quality/c6522.md b/docs/code-quality/c6522.md index 3f7b9cbb6d4..5b4630bd8a8 100644 --- a/docs/code-quality/c6522.md +++ b/docs/code-quality/c6522.md @@ -10,11 +10,11 @@ ms.assetid: ac482f63-b27f-4807-968a-1c449033d2dd > Invalid size specification: expression must be of integral type: annotation '*annotation*' on function '*function*' '*parameter*' +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that an integral type was expected, but an incorrect data type was used. You can use annotation properties that accept the size of a parameter in terms of another parameter, but you must use correct data type. For a list of annotation properties, see [Using SAL Annotations to reduce code defects](using-sal-annotations-to-reduce-c-cpp-code-defects.md). Code analysis name: `INVALID_SIZE_STRING_TYPE` diff --git a/docs/code-quality/c6525.md b/docs/code-quality/c6525.md index 360aa708d94..3faa9a9a2ae 100644 --- a/docs/code-quality/c6525.md +++ b/docs/code-quality/c6525.md @@ -10,11 +10,11 @@ ms.assetid: a7af4dc7-d5a4-455f-a414-0c389ffd9aa9 > Invalid size specification: property value may not be valid +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that the property value used to specify the size isn't valid. The warning occurs if the size parameter is annotated using `Valid=No`. Code analysis name: `INVALID_SIZE_STRING_UNREACHABLE_LOCATION` diff --git a/docs/code-quality/c6530.md b/docs/code-quality/c6530.md index 4bf05cf3e30..56131370ca0 100644 --- a/docs/code-quality/c6530.md +++ b/docs/code-quality/c6530.md @@ -10,11 +10,11 @@ ms.assetid: 60e9dc58-e0f1-4a34-8c75-efebaa6cadd2 > Unrecognized format string style '*name*' +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that the `FormatString` property is using a value other than `scanf` or `printf`. To correct this warning, review your code and use a valid value for the `Style` property. Code analysis name: `UNRECOGNIZED_FORMAT_STRING_STYLE` diff --git a/docs/code-quality/c6551.md b/docs/code-quality/c6551.md index d6b47b6f155..38d0907d739 100644 --- a/docs/code-quality/c6551.md +++ b/docs/code-quality/c6551.md @@ -10,5 +10,7 @@ ms.assetid: cfd02698-7ba7-4564-841d-208999b1561d > Invalid size specification: expression not parsable +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). diff --git a/docs/code-quality/c6552.md b/docs/code-quality/c6552.md index 9ccb714199a..7ca29467875 100644 --- a/docs/code-quality/c6552.md +++ b/docs/code-quality/c6552.md @@ -10,5 +10,7 @@ ms.assetid: 6c6f17d8-4ddd-4fad-b81f-e32285e7afa8 > Invalid `Deref=` or `Notref=`: expression not parsable +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). diff --git a/docs/code-quality/c6701.md b/docs/code-quality/c6701.md index 386d29a099b..7def9d2a483 100644 --- a/docs/code-quality/c6701.md +++ b/docs/code-quality/c6701.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C6701"] > The value is not a valid Yes/No/Maybe value: '*string*' +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6702.md b/docs/code-quality/c6702.md index 6fb0c5520df..06c1b8bd82b 100644 --- a/docs/code-quality/c6702.md +++ b/docs/code-quality/c6702.md @@ -10,4 +10,6 @@ ms.assetid: 6d373843-4ab4-4a94-bb83-5fec9214c625 > The value is not a string value: '*string*' +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6703.md b/docs/code-quality/c6703.md index f8b5ad7669f..dbeda03fcdd 100644 --- a/docs/code-quality/c6703.md +++ b/docs/code-quality/c6703.md @@ -10,4 +10,6 @@ ms.assetid: 8ec4f403-e63e-4930-8266-569c9cd263b4 > The value is not a number: '*string*' +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6704.md b/docs/code-quality/c6704.md index c15266ab7fe..c681b0887da 100644 --- a/docs/code-quality/c6704.md +++ b/docs/code-quality/c6704.md @@ -10,4 +10,6 @@ ms.assetid: fc25543d-746e-415e-b0a8-d5134461af41 > Unexpected Annotation Expression Error: '*annotation*' ['*why*'] +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6705.md b/docs/code-quality/c6705.md index 6d6c84dcc51..e107a8cd2d5 100644 --- a/docs/code-quality/c6705.md +++ b/docs/code-quality/c6705.md @@ -10,4 +10,6 @@ ms.assetid: 5d81e7ac-0c51-4cca-aaa8-df1aa599f175 > Annotation error expected arguments for annotation '*parameter*' found . +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6706.md b/docs/code-quality/c6706.md index 317a1bb989d..7fbc597ad4e 100644 --- a/docs/code-quality/c6706.md +++ b/docs/code-quality/c6706.md @@ -10,4 +10,6 @@ ms.assetid: 20f3fd01-4993-4f7f-bd3f-57706356cf1d > Unexpected Annotation Error for annotation '*annotation*': '*why*' +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6993.md b/docs/code-quality/c6993.md index 54f78c56c90..95695fe832a 100644 --- a/docs/code-quality/c6993.md +++ b/docs/code-quality/c6993.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C6993"] > Code analysis ignores OpenMP constructs; analyzing single-threaded code +## Remarks + This warning indicates that the static analysis tools don't support Open MP pragmas. The static analysis tools could generate incorrect results because they assume the code is single-threaded, not multi-threaded. Your code doesn't necessarily need to be 'fixed' to resolve this diagnostic because this warning indicates what the toolset supports and not an issue with your code. \ No newline at end of file diff --git a/docs/code-quality/c6995.md b/docs/code-quality/c6995.md index 4ca022014e5..1aeadbee3e9 100644 --- a/docs/code-quality/c6995.md +++ b/docs/code-quality/c6995.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C6995"] > Failed to save XML Log file +## Remarks + This warning indicates that the Code Analysis tool can't create the defect log, which is the output of the code analysis. This error might indicate a disk error or indicate that you don't have permission to create a file in the specified directory. From ba620320638561ffcef759fc9eddbefbb2a7fd39 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 23:01:21 +0800 Subject: [PATCH 1125/1799] Replace term "sample" with "example" for warning references in range [C6401, C6999] --- docs/code-quality/c6500.md | 2 +- docs/code-quality/c6506.md | 2 +- docs/code-quality/c6514.md | 2 +- docs/code-quality/c6522.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/code-quality/c6500.md b/docs/code-quality/c6500.md index 1c98588c2c6..4a577730a0e 100644 --- a/docs/code-quality/c6500.md +++ b/docs/code-quality/c6500.md @@ -35,7 +35,7 @@ using namespace vc_attributes; void f( [Pre( Deref=2, Access=Read )] char buffer[] ); ``` -To correct this warning, specify the correct level of dereference, as shown in the following sample code: +To correct this warning, specify the correct level of dereference, as shown in the following example code: ```cpp // C diff --git a/docs/code-quality/c6506.md b/docs/code-quality/c6506.md index 377aef78138..a2ce79eeed9 100644 --- a/docs/code-quality/c6506.md +++ b/docs/code-quality/c6506.md @@ -27,7 +27,7 @@ void f(_Out_ char c) } ``` -To correct this warning, use a pointer or an array type, as shown in the following sample code: +To correct this warning, use a pointer or an array type, as shown in the following example code: ```cpp #include diff --git a/docs/code-quality/c6514.md b/docs/code-quality/c6514.md index cad312ecf26..aefc536fd2b 100644 --- a/docs/code-quality/c6514.md +++ b/docs/code-quality/c6514.md @@ -31,7 +31,7 @@ using namespace vc_attributes; void f( [Pre(Deref=1, ValidElementsConst=8)] char(*matrix) [6] ); ``` -To correct this warning, make sure the size of specified in ValidElementsConst is less than or equal to the size of the array, as shown in the following sample code: +To correct this warning, make sure the size of specified in ValidElementsConst is less than or equal to the size of the array, as shown in the following example code: ```cpp // C diff --git a/docs/code-quality/c6522.md b/docs/code-quality/c6522.md index 5b4630bd8a8..89db830412b 100644 --- a/docs/code-quality/c6522.md +++ b/docs/code-quality/c6522.md @@ -34,7 +34,7 @@ using namespace vc_attributes; void f ([Pre(ValidBytes="c")] char *pc, double c); ``` -To correct this warning, use `size_t` for the `ValidBytesParam` parameter data type, as shown in the following sample code: +To correct this warning, use `size_t` for the `ValidBytesParam` parameter data type, as shown in the following example code: ```cpp // C From 869f17c8c8c11f603d3f75bd1f55649b7d6fffd3 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 7 Sep 2025 23:06:25 +0800 Subject: [PATCH 1126/1799] Update metadata for warning references in range [C6401, C6999] --- docs/code-quality/c6401.md | 3 +-- docs/code-quality/c6411.md | 2 +- docs/code-quality/c6412.md | 2 +- docs/code-quality/c6500.md | 3 +-- docs/code-quality/c6501.md | 3 +-- docs/code-quality/c6503.md | 3 +-- docs/code-quality/c6504.md | 2 +- docs/code-quality/c6505.md | 3 +-- docs/code-quality/c6506.md | 2 +- docs/code-quality/c6508.md | 3 +-- docs/code-quality/c6509.md | 3 +-- docs/code-quality/c6510.md | 3 +-- docs/code-quality/c6511.md | 3 +-- docs/code-quality/c6513.md | 3 +-- docs/code-quality/c6514.md | 3 +-- docs/code-quality/c6515.md | 3 +-- docs/code-quality/c6516.md | 3 +-- docs/code-quality/c6517.md | 3 +-- docs/code-quality/c6518.md | 3 +-- docs/code-quality/c6522.md | 3 +-- docs/code-quality/c6525.md | 3 +-- docs/code-quality/c6527.md | 3 +-- docs/code-quality/c6530.md | 3 +-- docs/code-quality/c6540.md | 3 +-- docs/code-quality/c6551.md | 3 +-- docs/code-quality/c6552.md | 3 +-- docs/code-quality/c6701.md | 2 +- docs/code-quality/c6702.md | 3 +-- docs/code-quality/c6703.md | 3 +-- docs/code-quality/c6704.md | 3 +-- docs/code-quality/c6705.md | 3 +-- docs/code-quality/c6706.md | 3 +-- docs/code-quality/c6707.md | 3 +-- docs/code-quality/c6993.md | 2 +- docs/code-quality/c6995.md | 2 +- docs/code-quality/c6997.md | 2 +- 36 files changed, 36 insertions(+), 64 deletions(-) diff --git a/docs/code-quality/c6401.md b/docs/code-quality/c6401.md index 954dbdddef9..071f30b46bc 100644 --- a/docs/code-quality/c6401.md +++ b/docs/code-quality/c6401.md @@ -1,10 +1,9 @@ --- +title: "Warning C6401" description: "Learn more about: Warning C6401" -title: Warning C6401 ms.date: 11/04/2016 f1_keywords: ["C6401", "DEFAULT_LOCALE_CONSTANT_STRING_COMPARISON", "__WARNING_DEFAULT_LOCALE_CONSTANT_STRING_COMPARISON"] helpviewer_keywords: ["C6401"] -ms.assetid: d57b1c94-57a3-4d4b-a7de-8b9ffbac3ebe --- # Warning C6401 diff --git a/docs/code-quality/c6411.md b/docs/code-quality/c6411.md index a4a99565a83..4e1627384d3 100644 --- a/docs/code-quality/c6411.md +++ b/docs/code-quality/c6411.md @@ -1,5 +1,5 @@ --- -title: Warning C6411 +title: "Warning C6411" description: "Learn more about: Warning C6411" ms.date: 11/04/2016 f1_keywords: ["C6411", "POTENTIAL_READ_OVERRUN"] diff --git a/docs/code-quality/c6412.md b/docs/code-quality/c6412.md index 230011ec6ec..cd387c66074 100644 --- a/docs/code-quality/c6412.md +++ b/docs/code-quality/c6412.md @@ -1,5 +1,5 @@ --- -title: Warning C6412 +title: "Warning C6412" description: "Learn more about: Warning C6412" ms.date: 11/04/2016 f1_keywords: ["C6412", "POTENTIAL_WRITE_OVERRUN"] diff --git a/docs/code-quality/c6500.md b/docs/code-quality/c6500.md index 4a577730a0e..4b2373b63d5 100644 --- a/docs/code-quality/c6500.md +++ b/docs/code-quality/c6500.md @@ -1,10 +1,9 @@ --- +title: "Warning C6500" description: "Learn more about: Warning C6500" -title: Warning C6500 ms.date: 11/04/2016 f1_keywords: ["C6500", "INVALID_ATTRIBUTE_PROPERTY", "__WARNING_INVALID_ATTRIBUTE_PROPERTY"] helpviewer_keywords: ["C6500"] -ms.assetid: bfc61ec1-8ac5-4465-a23c-91418fbc4552 --- # Warning C6500 diff --git a/docs/code-quality/c6501.md b/docs/code-quality/c6501.md index 1c8d91a6e82..6b552356726 100644 --- a/docs/code-quality/c6501.md +++ b/docs/code-quality/c6501.md @@ -1,10 +1,9 @@ --- +title: "Warning C6501" description: "Learn more about: Warning C6501" -title: Warning C6501 ms.date: 11/04/2016 f1_keywords: ["C6501", "CONFLICTING_ATTRIBUTE_PROPERTY_VALUES", "__WARNING_CONFLICTING_ATTRIBUTE_PROPERTY_VALUES"] helpviewer_keywords: ["C6501"] -ms.assetid: f9e8b847-2516-4bbb-bb1c-c87cfbacf254 --- # Warning C6501 diff --git a/docs/code-quality/c6503.md b/docs/code-quality/c6503.md index 7f5f7797d87..5c320d0eaed 100644 --- a/docs/code-quality/c6503.md +++ b/docs/code-quality/c6503.md @@ -1,10 +1,9 @@ --- +title: "Warning C6503" description: "Learn more about: Warning C6503" -title: Warning C6503 ms.date: 11/04/2016 f1_keywords: ["C6503", "REFERENCES_CANT_BE_NULL", "__WARNING_REFERENCES_CANT_BE_NULL"] helpviewer_keywords: ["C6503"] -ms.assetid: a6212938-bef9-4830-becb-6baa70b53e97 --- # Warning C6503 diff --git a/docs/code-quality/c6504.md b/docs/code-quality/c6504.md index 2039768ccea..eb9d24fa536 100644 --- a/docs/code-quality/c6504.md +++ b/docs/code-quality/c6504.md @@ -1,5 +1,5 @@ --- -title: Warning C6504 +title: "Warning C6504" description: "Learn more about: Warning C6504" ms.date: 10/03/2022 f1_keywords: ["C6504", "NULL_ON_NON_POINTER", "__WARNING_NULL_ON_NON_POINTER"] diff --git a/docs/code-quality/c6505.md b/docs/code-quality/c6505.md index 3edfe826bbf..317778e442c 100644 --- a/docs/code-quality/c6505.md +++ b/docs/code-quality/c6505.md @@ -1,10 +1,9 @@ --- +title: "Warning C6505" description: "Learn more about: Warning C6505" -title: Warning C6505 ms.date: 11/04/2016 f1_keywords: ["C6505", "MUSTCHECK_ON_VOID", "__WARNING_MUSTCHECK_ON_VOID"] helpviewer_keywords: ["C6505"] -ms.assetid: 1883ce60-48d7-41c8-add8-814e4b8b908b --- # Warning C6505 diff --git a/docs/code-quality/c6506.md b/docs/code-quality/c6506.md index a2ce79eeed9..6cd1cf750b2 100644 --- a/docs/code-quality/c6506.md +++ b/docs/code-quality/c6506.md @@ -1,5 +1,5 @@ --- -title: Warning C6506 +title: "Warning C6506" description: "Learn more about: Warning C6506" ms.date: 11/04/2016 f1_keywords: ["C6506", "BUFFER_SIZE_ON_NON_POINTER_OR_ARRAY", "__WARNING_BUFFER_SIZE_ON_NON_POINTER_OR_ARRAY"] diff --git a/docs/code-quality/c6508.md b/docs/code-quality/c6508.md index 7a834ab3fef..f48ec901cc3 100644 --- a/docs/code-quality/c6508.md +++ b/docs/code-quality/c6508.md @@ -1,10 +1,9 @@ --- +title: "Warning C6508" description: "Learn more about: Warning C6508" -title: Warning C6508 ms.date: 11/04/2016 f1_keywords: ["C6508", "WRITE_ACCESS_ON_CONST", "__WARNING_WRITE_ACCESS_ON_CONST"] helpviewer_keywords: ["C6508"] -ms.assetid: ac5b23c8-ab9e-481b-bc97-8404f0b63100 --- # Warning C6508 diff --git a/docs/code-quality/c6509.md b/docs/code-quality/c6509.md index 5266f53e763..e969a7c5d47 100644 --- a/docs/code-quality/c6509.md +++ b/docs/code-quality/c6509.md @@ -1,10 +1,9 @@ --- +title: "Warning C6509" description: "Learn more about: Warning C6509" -title: Warning C6509 ms.date: 11/04/2016 f1_keywords: ["C6509", "RETURN_USED_ON_PRECONDITION", "__WARNING_RETURN_USED_ON_PRECONDITION"] helpviewer_keywords: ["C6509"] -ms.assetid: 6311bfd9-8372-48da-b01b-1c8775c38449 --- # Warning C6509 diff --git a/docs/code-quality/c6510.md b/docs/code-quality/c6510.md index e6d2366a4cf..b390495e5f6 100644 --- a/docs/code-quality/c6510.md +++ b/docs/code-quality/c6510.md @@ -1,10 +1,9 @@ --- +title: "Warning C6510" description: "Learn more about: Warning C6510" -title: Warning C6510 ms.date: 11/04/2016 f1_keywords: ["C6510", "NULLTERMINATED_ON_NON_POINTER", "__WARNING_NULLTERMINATED_ON_NON_POINTER"] helpviewer_keywords: ["C6510"] -ms.assetid: b7fc5eb4-3311-442c-ac79-401e88ef2129 --- # Warning C6510 diff --git a/docs/code-quality/c6511.md b/docs/code-quality/c6511.md index 41553d3024e..37d75c8a480 100644 --- a/docs/code-quality/c6511.md +++ b/docs/code-quality/c6511.md @@ -1,10 +1,9 @@ --- +title: "Warning C6511" description: "Learn more about: Warning C6511" -title: Warning C6511 ms.date: 11/04/2016 f1_keywords: ["C6511", "MUSTCHECK_MAYBE", "__WARNING_MUSTCHECK_MAYBE"] helpviewer_keywords: ["C6511"] -ms.assetid: 1a0ac213-c205-4fb1-9bc3-3dc7885329fa --- # Warning C6511 diff --git a/docs/code-quality/c6513.md b/docs/code-quality/c6513.md index 7127c046f3c..7f4d110c621 100644 --- a/docs/code-quality/c6513.md +++ b/docs/code-quality/c6513.md @@ -1,10 +1,9 @@ --- +title: "Warning C6513" description: "Learn more about: Warning C6513" -title: Warning C6513 ms.date: 11/04/2016 f1_keywords: ["C6513", "ELEMENT_SIZE_WITHOUT_BUFFER_SIZE", "__WARNING_ELEMENT_SIZE_WITHOUT_BUFFER_SIZE"] helpviewer_keywords: ["C6513"] -ms.assetid: b27780ac-b237-4b26-a796-68a920da73a3 --- # Warning C6513 diff --git a/docs/code-quality/c6514.md b/docs/code-quality/c6514.md index aefc536fd2b..b0826ee86ce 100644 --- a/docs/code-quality/c6514.md +++ b/docs/code-quality/c6514.md @@ -1,10 +1,9 @@ --- +title: "Warning C6514" description: "Learn more about: Warning C6514" -title: Warning C6514 ms.date: 11/04/2016 f1_keywords: ["C6514", "BUFFER_SIZE_EXCEEDS_ARRAY_SIZE", "__WARNING_BUFFER_SIZE_EXCEEDS_ARRAY_SIZE"] helpviewer_keywords: ["C6514"] -ms.assetid: 4930a9f9-c721-437f-8754-cf39b30ea2db --- # Warning C6514 diff --git a/docs/code-quality/c6515.md b/docs/code-quality/c6515.md index 1f329099e64..b8d51042420 100644 --- a/docs/code-quality/c6515.md +++ b/docs/code-quality/c6515.md @@ -1,10 +1,9 @@ --- +title: "Warning C6515" description: "Learn more about: Warning C6515" -title: Warning C6515 ms.date: 11/04/2016 f1_keywords: ["C6515", "BUFFER_SIZE_ON_NON_POINTER", "__WARNING_BUFFER_SIZE_ON_NON_POINTER"] helpviewer_keywords: ["C6515"] -ms.assetid: e0f21858-0fea-427b-965a-a7eff62e1371 --- # Warning C6515 diff --git a/docs/code-quality/c6516.md b/docs/code-quality/c6516.md index 02f2456b7bd..128900e3e6b 100644 --- a/docs/code-quality/c6516.md +++ b/docs/code-quality/c6516.md @@ -1,10 +1,9 @@ --- +title: "Warning C6516" description: "Learn more about: Warning C6516" -title: Warning C6516 ms.date: 11/04/2016 f1_keywords: ["C6516", "NO_PROPERTIES_ON_ATTRIBUTE", "__WARNING_NO_PROPERTIES_ON_ATTRIBUTE"] helpviewer_keywords: ["C6516"] -ms.assetid: 461078c8-18d4-49ca-80a2-a15736f429a0 --- # Warning C6516 diff --git a/docs/code-quality/c6517.md b/docs/code-quality/c6517.md index 7cefd9e4e01..45b7ea115d8 100644 --- a/docs/code-quality/c6517.md +++ b/docs/code-quality/c6517.md @@ -1,10 +1,9 @@ --- +title: "Warning C6517" description: "Learn more about: Warning C6517" -title: Warning C6517 ms.date: 11/04/2016 f1_keywords: ["C6517", "VALID_SIZE_ON_NON_READABLE_BUFFER", "__WARNING_VALID_SIZE_ON_NON_READABLE_BUFFER"] helpviewer_keywords: ["C6517"] -ms.assetid: 96822155-8b2a-4699-980f-744afff84ca8 --- # Warning C6517 diff --git a/docs/code-quality/c6518.md b/docs/code-quality/c6518.md index 179ef86f930..de6c364ac96 100644 --- a/docs/code-quality/c6518.md +++ b/docs/code-quality/c6518.md @@ -1,10 +1,9 @@ --- +title: "Warning C6518" description: "Learn more about: Warning C6518" -title: Warning C6518 ms.date: 11/04/2016 f1_keywords: ["C6518", "WRITABLE_SIZE_ON_NON_WRITABLE_BUFFER", "__WARNING_WRITABLE_SIZE_ON_NON_WRITABLE_BUFFER"] helpviewer_keywords: ["C6518"] -ms.assetid: c391a75b-9f16-43a5-a7cd-c5a233002850 --- # Warning C6518 diff --git a/docs/code-quality/c6522.md b/docs/code-quality/c6522.md index 89db830412b..b4d4d9f5bc2 100644 --- a/docs/code-quality/c6522.md +++ b/docs/code-quality/c6522.md @@ -1,10 +1,9 @@ --- +title: "Warning C6522" description: "Learn more about: Warning C6522" -title: Warning C6522 ms.date: 11/04/2016 f1_keywords: ["C6522", "INVALID_SIZE_STRING_TYPE", "__WARNING_INVALID_SIZE_STRING_TYPE"] helpviewer_keywords: ["C6522"] -ms.assetid: ac482f63-b27f-4807-968a-1c449033d2dd --- # Warning C6522 diff --git a/docs/code-quality/c6525.md b/docs/code-quality/c6525.md index 3faa9a9a2ae..36a6e2cd5e0 100644 --- a/docs/code-quality/c6525.md +++ b/docs/code-quality/c6525.md @@ -1,10 +1,9 @@ --- +title: "Warning C6525" description: "Learn more about: Warning C6525" -title: Warning C6525 ms.date: 11/04/2016 f1_keywords: ["C6525", "INVALID_SIZE_STRING_UNREACHABLE_LOCATION", "__WARNING_INVALID_SIZE_STRING_UNREACHABLE_LOCATION"] helpviewer_keywords: ["C6525"] -ms.assetid: a7af4dc7-d5a4-455f-a414-0c389ffd9aa9 --- # Warning C6525 diff --git a/docs/code-quality/c6527.md b/docs/code-quality/c6527.md index 4c6c08810c6..0df3ea2dd62 100644 --- a/docs/code-quality/c6527.md +++ b/docs/code-quality/c6527.md @@ -1,10 +1,9 @@ --- +title: "Warning C6527" description: "Learn more about: Warning C6527" -title: Warning C6527 ms.date: 11/04/2016 f1_keywords: ["C6527"] helpviewer_keywords: ["C6527"] -ms.assetid: 5ebb6279-0f75-4566-a5f3-a47834de9625 --- # Warning C6527 diff --git a/docs/code-quality/c6530.md b/docs/code-quality/c6530.md index 56131370ca0..fcaaaee3b72 100644 --- a/docs/code-quality/c6530.md +++ b/docs/code-quality/c6530.md @@ -1,10 +1,9 @@ --- +title: "Warning C6530" description: "Learn more about: Warning C6530" -title: Warning C6530 ms.date: 11/04/2016 f1_keywords: ["C6530", "UNRECOGNIZED_FORMAT_STRING_STYLE", "__WARNING_UNRECOGNIZED_FORMAT_STRING_STYLE"] helpviewer_keywords: ["C6530"] -ms.assetid: 60e9dc58-e0f1-4a34-8c75-efebaa6cadd2 --- # Warning C6530 diff --git a/docs/code-quality/c6540.md b/docs/code-quality/c6540.md index 77790ec3ea0..65e63f09ada 100644 --- a/docs/code-quality/c6540.md +++ b/docs/code-quality/c6540.md @@ -1,10 +1,9 @@ --- +title: "Warning C6540" description: "Learn more about: Warning C6540" -title: Warning C6540 ms.date: 11/04/2016 f1_keywords: ["C6540"] helpviewer_keywords: ["C6540"] -ms.assetid: b047084c-9187-443e-8bcd-8f42064003f7 --- # Warning C6540 diff --git a/docs/code-quality/c6551.md b/docs/code-quality/c6551.md index 38d0907d739..6a4e0b3c4a9 100644 --- a/docs/code-quality/c6551.md +++ b/docs/code-quality/c6551.md @@ -1,10 +1,9 @@ --- +title: "Warning C6551" description: "Learn more about: Warning C6551" -title: Warning C6551 ms.date: 11/04/2016 f1_keywords: ["C6551"] helpviewer_keywords: ["C6551"] -ms.assetid: cfd02698-7ba7-4564-841d-208999b1561d --- # Warning C6551 diff --git a/docs/code-quality/c6552.md b/docs/code-quality/c6552.md index 7ca29467875..ebdf48ef39d 100644 --- a/docs/code-quality/c6552.md +++ b/docs/code-quality/c6552.md @@ -1,10 +1,9 @@ --- +title: "Warning C6552" description: "Learn more about: Warning C6552" -title: Warning C6552 ms.date: 11/04/2016 f1_keywords: ["C6552"] helpviewer_keywords: ["C6552"] -ms.assetid: 6c6f17d8-4ddd-4fad-b81f-e32285e7afa8 --- # Warning C6552 diff --git a/docs/code-quality/c6701.md b/docs/code-quality/c6701.md index 7def9d2a483..35aa86ba49d 100644 --- a/docs/code-quality/c6701.md +++ b/docs/code-quality/c6701.md @@ -1,5 +1,5 @@ --- -title: Warning C6701 +title: "Warning C6701" description: "Learn more about: Warning C6701" ms.date: 11/04/2016 f1_keywords: ["C6701"] diff --git a/docs/code-quality/c6702.md b/docs/code-quality/c6702.md index 06c1b8bd82b..ecb9a87a5dc 100644 --- a/docs/code-quality/c6702.md +++ b/docs/code-quality/c6702.md @@ -1,10 +1,9 @@ --- +title: "Warning C6702" description: "Learn more about: Warning C6702" -title: Warning C6702 ms.date: 11/04/2016 f1_keywords: ["C6702"] helpviewer_keywords: ["C6702"] -ms.assetid: 6d373843-4ab4-4a94-bb83-5fec9214c625 --- # Warning C6702 diff --git a/docs/code-quality/c6703.md b/docs/code-quality/c6703.md index dbeda03fcdd..40f198dc2e5 100644 --- a/docs/code-quality/c6703.md +++ b/docs/code-quality/c6703.md @@ -1,10 +1,9 @@ --- +title: "Warning C6703" description: "Learn more about: Warning C6703" -title: Warning C6703 ms.date: 11/04/2016 f1_keywords: ["C6703"] helpviewer_keywords: ["C6703"] -ms.assetid: 8ec4f403-e63e-4930-8266-569c9cd263b4 --- # Warning C6703 diff --git a/docs/code-quality/c6704.md b/docs/code-quality/c6704.md index c681b0887da..5a68ddfee58 100644 --- a/docs/code-quality/c6704.md +++ b/docs/code-quality/c6704.md @@ -1,10 +1,9 @@ --- +title: "Warning C6704" description: "Learn more about: Warning C6704" -title: Warning C6704 ms.date: 11/04/2016 f1_keywords: ["C6704"] helpviewer_keywords: ["C6704"] -ms.assetid: fc25543d-746e-415e-b0a8-d5134461af41 --- # Warning C6704 diff --git a/docs/code-quality/c6705.md b/docs/code-quality/c6705.md index e107a8cd2d5..17a2222150d 100644 --- a/docs/code-quality/c6705.md +++ b/docs/code-quality/c6705.md @@ -1,10 +1,9 @@ --- +title: "Warning C6705" description: "Learn more about: Warning C6705" -title: Warning C6705 ms.date: 11/04/2016 f1_keywords: ["C6705"] helpviewer_keywords: ["C6705"] -ms.assetid: 5d81e7ac-0c51-4cca-aaa8-df1aa599f175 --- # Warning C6705 diff --git a/docs/code-quality/c6706.md b/docs/code-quality/c6706.md index 7fbc597ad4e..7f430a9c48b 100644 --- a/docs/code-quality/c6706.md +++ b/docs/code-quality/c6706.md @@ -1,10 +1,9 @@ --- +title: "Warning C6706" description: "Learn more about: Warning C6706" -title: Warning C6706 ms.date: 11/04/2016 f1_keywords: ["C6706"] helpviewer_keywords: ["C6706"] -ms.assetid: 20f3fd01-4993-4f7f-bd3f-57706356cf1d --- # Warning C6706 diff --git a/docs/code-quality/c6707.md b/docs/code-quality/c6707.md index 8a12d79df99..24441240b1d 100644 --- a/docs/code-quality/c6707.md +++ b/docs/code-quality/c6707.md @@ -1,10 +1,9 @@ --- +title: "Warning C6707" description: "Learn more about: Warning C6707" -title: Warning C6707 ms.date: 11/04/2016 f1_keywords: ["C6707"] helpviewer_keywords: ["C6707"] -ms.assetid: a6610464-9bc5-4f24-b0a5-7fa29581874d --- # Warning C6707 diff --git a/docs/code-quality/c6993.md b/docs/code-quality/c6993.md index 95695fe832a..a2b72c3ae86 100644 --- a/docs/code-quality/c6993.md +++ b/docs/code-quality/c6993.md @@ -1,5 +1,5 @@ --- -title: Warning C6993 +title: "Warning C6993" description: "Learn more about: Warning C6993" ms.date: 2/25/2025 f1_keywords: ["C6993"] diff --git a/docs/code-quality/c6995.md b/docs/code-quality/c6995.md index 1aeadbee3e9..a7183235967 100644 --- a/docs/code-quality/c6995.md +++ b/docs/code-quality/c6995.md @@ -1,5 +1,5 @@ --- -title: Warning C6995 +title: "Warning C6995" description: "Learn more about: Warning C6995" ms.date: 11/04/2016 f1_keywords: ["C6995"] diff --git a/docs/code-quality/c6997.md b/docs/code-quality/c6997.md index 8cbfc9bd5ed..693cd3ffb47 100644 --- a/docs/code-quality/c6997.md +++ b/docs/code-quality/c6997.md @@ -1,5 +1,5 @@ --- -title: Warning C6997 +title: "Warning C6997" description: "Learn more about: Warning C6997" ms.date: 11/04/2016 f1_keywords: ["C6997", "IGNORED_ANNOTATIONS"] From ac703ef66d0ce141205cc55f7aa9cc70727e9cf7 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 8 Sep 2025 23:20:11 +0800 Subject: [PATCH 1127/1799] Add "Remarks" and "Example" headings for error references in range [C7000, C7999] --- docs/error-messages/compiler-errors-2/compiler-error-c7510.md | 4 ++-- docs/error-messages/compiler-errors-2/compiler-error-c7536.md | 2 ++ docs/error-messages/compiler-errors-2/compiler-error-c7742.md | 4 ++++ 3 files changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7510.md b/docs/error-messages/compiler-errors-2/compiler-error-c7510.md index 4d310b7a6f2..507edb548f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7510.md @@ -10,10 +10,10 @@ helpviewer_keywords: ["C7510"] > '*type-name*': use of dependent template name must be prefixed with 'template'\ > '*type-name*': use of dependent type name must be prefixed with 'typename' -In [`/permissive-`](../../build/reference/permissive-standards-conformance.md) mode, the compiler requires the **`template`** keyword to precede a template name when it comes after a dependent [`nested-name-specifier`](../../cpp/scope-resolution-operator.md). Similar rules hold for types qualified by **`typename`**. - ## Remarks +In [`/permissive-`](../../build/reference/permissive-standards-conformance.md) mode, the compiler requires the **`template`** keyword to precede a template name when it comes after a dependent [`nested-name-specifier`](../../cpp/scope-resolution-operator.md). Similar rules hold for types qualified by **`typename`**. + Compiler behavior has changed starting in Visual Studio 2017 version 15.8 under [`/permissive-`](../../build/reference/permissive-standards-conformance.md) mode. The compiler requires the **`template`** or **`typename`** keyword to precede a template or type name when it comes after a dependent *`nested-name-specifier`*. For more information, see [Name resolution for dependent types](../../cpp/name-resolution-for-dependent-types.md) and [Templates and name resolution](../../cpp/templates-and-name-resolution.md). ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7536.md b/docs/error-messages/compiler-errors-2/compiler-error-c7536.md index a2f4751a33a..bc23be1abd2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7536.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7536.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C7536"] > ifc failed integrity checks. Expected SHA2: '*hash-value*' +## Remarks + The compiler raises C7536 whenever the *`.ifc`* file has been tampered with. The header of the module interface contains an SHA2 hash of the contents below it. On import, the *`.ifc`* file is hashed, then checked against the hash provided in the header. If these don't match, error C7536 is raised: ```Output diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7742.md b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md index 32847771dd2..2ee6ceb6a8f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7742.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md @@ -10,8 +10,12 @@ helpviewer_keywords: ["C7742"] > *Identifier*: a forward declaration of an enum can only use a simple identifier +## Remarks + The C++ Standard doesn't allow declaring an opaque enumeration using a qualified-id. An opaque enum declaration specifies the name and the underlying type, but doesn't list the enumerators or their values. +## Example + The following example generates C7742: ```cpp From 54f9308d2f7af278835d50a30b69d1077a81cbf2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 8 Sep 2025 23:20:50 +0800 Subject: [PATCH 1128/1799] Replace term "sample" with "example" for error references in range [C7000, C7999] --- docs/error-messages/compiler-errors-2/compiler-error-c7688.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7688.md b/docs/error-messages/compiler-errors-2/compiler-error-c7688.md index 8716a20d4fe..5f5097d138c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7688.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7688.md @@ -17,7 +17,7 @@ Compiler error C7688 is new in Visual Studio 2022 version 17.4. In previous comp ## Example -The sample code shows diagnostics generated for non-scalar types in `#pragma omp atomic` constructs. +The example code shows diagnostics generated for non-scalar types in `#pragma omp atomic` constructs. ```cpp // C7688.cpp From 02c9098548125ff870d484e8a9308b76b11f3ca9 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 8 Sep 2025 23:23:19 +0800 Subject: [PATCH 1129/1799] Update metadata for error references in range [C7000, C7999] --- docs/error-messages/compiler-errors-2/compiler-error-c7510.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c7536.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c7553.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c7688.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c7742.md | 4 ++-- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7510.md b/docs/error-messages/compiler-errors-2/compiler-error-c7510.md index 507edb548f8..b22fad3bdd3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7510.md @@ -1,6 +1,6 @@ --- -description: "Learn about the causes of Compiler error C7510 and how to fix it." title: "Compiler Error C7510" +description: "Learn about the causes of Compiler error C7510 and how to fix it." ms.date: 04/21/2021 f1_keywords: ["C7510"] helpviewer_keywords: ["C7510"] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7536.md b/docs/error-messages/compiler-errors-2/compiler-error-c7536.md index bc23be1abd2..dad516b4b11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7536.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7536.md @@ -1,6 +1,6 @@ --- -description: "Learn about the causes of Compiler error C7536 and how to fix it." title: "Compiler Error C7536" +description: "Learn about the causes of Compiler error C7536 and how to fix it." ms.date: 05/03/2021 f1_keywords: ["C7536"] helpviewer_keywords: ["C7536"] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7553.md b/docs/error-messages/compiler-errors-2/compiler-error-c7553.md index 63cd4464c52..c0f40017200 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7553.md @@ -1,6 +1,6 @@ --- title: "Compiler Error C7553" -description: Compiler Error C7553 description and solution. +description: "Compiler Error C7553 description and solution." ms.date: 02/22/2022 f1_keywords: ["C7553"] helpviewer_keywords: ["C7553"] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7688.md b/docs/error-messages/compiler-errors-2/compiler-error-c7688.md index 5f5097d138c..bad39dc8ab9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7688.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7688.md @@ -1,6 +1,6 @@ --- title: "Compiler error C7688" -description: Compiler error C7688 description and solution. +description: "Compiler error C7688 description and solution." ms.date: 03/01/2023 f1_keywords: ["C7688"] helpviewer_keywords: ["C7688"] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7742.md b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md index 2ee6ceb6a8f..dd7fd0b64fd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7742.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C7742" title: "Compiler Error C7742" -ms.date: "07/02/2025" +description: "Learn more about: Compiler Error C7742" +ms.date: 07/02/2025 ai-usage: ai-assisted f1_keywords: ["C7742"] helpviewer_keywords: ["C7742"] From 33b65bf956cc2f3d430261838043f16cf294e6f0 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 00:50:01 +0800 Subject: [PATCH 1130/1799] Add blockquotes for error messages in range [CXX0000, CXX0034] --- .../tool-errors/expression-evaluator-error-cxx0000.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0001.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0002.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0004.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0005.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0006.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0007.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0008.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0009.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0010.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0011.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0012.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0013.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0014.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0015.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0016.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0017.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0018.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0019.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0020.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0021.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0022.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0023.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0024.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0025.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0026.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0027.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0028.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0029.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0030.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0031.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0032.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0033.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0034.md | 2 +- 34 files changed, 34 insertions(+), 34 deletions(-) diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md index cfc74ee7552..e34b4fe80f9 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md @@ -8,7 +8,7 @@ ms.assetid: 95a7f17d-88ea-4a6c-a3af-2289bf0529fe --- # Expression Evaluator Error CXX0000 -no error condition +> no error condition No error has occurred. You can continue debugging normally. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md index 73944dbf0b0..2e94bc6345c 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md @@ -8,6 +8,6 @@ ms.assetid: 39cdf175-e4b8-49c1-bf84-ed41e0fd8600 --- # Expression Evaluator Error CXX0001 -exception executing user function +> exception executing user function The code being executed caused a general protection fault. This error is identical to CAN0001. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md index 8070e98c160..cbb52adabb7 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md @@ -8,7 +8,7 @@ ms.assetid: 5f136470-505f-4224-a29a-2d34e896d78b --- # Expression Evaluator Error CXX0002 -error accessing user memory +> error accessing user memory The expression attempts to reference memory that is not allocated to the program being debugged. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md index 1bac7f4b77c..ca0b51ca494 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md @@ -8,7 +8,7 @@ ms.assetid: a4063eda-0335-4ae7-9595-29cf10669376 --- # Expression Evaluator Error CXX0004 -syntax error +> syntax error The syntax of the expression is incorrect. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md index b7c786053a7..176963b62d6 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md @@ -8,7 +8,7 @@ ms.assetid: b88e83e4-10aa-4e9c-94d3-92aa8c688748 --- # Expression Evaluator Error CXX0005 -operator not supported +> operator not supported An unsupported C operator was specified in an expression. Write an equivalent expression using the supported C operators. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md index bd78c131518..f89cdfdce72 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md @@ -8,7 +8,7 @@ ms.assetid: 34a8e21c-5443-4817-aad9-bb3143cfcaa6 --- # Expression Evaluator Error CXX0006 -missing left parenthesis +> missing left parenthesis Unbalanced parentheses were found in the expression. Retype the expression with balanced parentheses. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md index 27956d6b228..1096674637f 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md @@ -8,7 +8,7 @@ ms.assetid: 270a6d2d-ea6b-4a94-9871-841a6a133292 --- # Expression Evaluator Error CXX0007 -missing right parenthesis +> missing right parenthesis Unbalanced parentheses were found in the expression. Retype the expression with balanced parentheses. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md index bca96bf5fa0..cf817b8ecfb 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md @@ -8,7 +8,7 @@ ms.assetid: 49e0968c-a6ce-4ba9-9762-02a55c08124e --- # Expression Evaluator Error CXX0008 -**missing " at end of string** +> missing " at end of string The double quote expected at the end of the string literal was missing. Retype the expression, enclosing the string literal in double quotation marks. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md index 74dc99854fd..7ddcb08e12d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md @@ -8,7 +8,7 @@ ms.assetid: b6f26a46-56f3-430f-a6db-b42934ddf331 --- # Expression Evaluator Error CXX0009 -missing ' after character constant +> missing ' after character constant The single quote expected at the end of the character constant was missing. Retype the expression, enclosing the character constant in single quotation marks. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md index 9412b3c4c7b..9b437aadece 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md @@ -8,7 +8,7 @@ ms.assetid: 8bd474b0-da12-4990-8569-6392f09f05f6 --- # Expression Evaluator Error CXX0010 -missing left bracket +> missing left bracket The expression contains unbalanced square brackets. Retype the expression with balanced square brackets. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md index f2eda30c029..079a24fc844 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md @@ -8,7 +8,7 @@ ms.assetid: c2252e89-ad66-43fc-93e4-b886dcbd3f19 --- # Expression Evaluator Error CXX0011 -missing right bracket +> missing right bracket The expression contains unbalanced square brackets. Retype the expression with balanced square brackets. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md index f35e2ee2907..9fcbd43516e 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md @@ -8,7 +8,7 @@ ms.assetid: bf547e21-6708-4854-ad23-2ae5a889fd82 --- # Expression Evaluator Error CXX0012 -missing left curly brace +> missing left curly brace The expression contains an unbalanced curly brace. Retype the expression with balanced curly braces. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md index 0b88ec11273..6f6b87b3165 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md @@ -8,7 +8,7 @@ ms.assetid: cf571e37-008d-47cd-80fa-59e96b1146e1 --- # Expression Evaluator Error CXX0013 -missing operator +> missing operator An operator was expected in the expression but was not found. Check the syntax of the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md index 640a86da34f..42876228154 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md @@ -8,7 +8,7 @@ ms.assetid: 3bb0278d-3dd6-4626-9945-3cf29afbbacb --- # Expression Evaluator Error CXX0014 -missing operand +> missing operand An operator was specified without a required operand. Check the syntax of the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md index 31160b46a72..dc87286f579 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md @@ -8,7 +8,7 @@ ms.assetid: 35efaf77-d578-48d8-bfc5-fdeb2a46a8b5 --- # Expression Evaluator Error CXX0015 -expression too complex (stack overflow) +> expression too complex (stack overflow) The expression entered was too complex or nested too deeply for the amount of storage available to the C expression evaluator. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md index 4feb05578b6..959aa65d9f0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md @@ -8,7 +8,7 @@ ms.assetid: af94a2ae-e835-4da6-8d2f-5c879f72eda2 --- # Expression Evaluator Error CXX0016 -constant too big +> constant too big The C expression evaluator cannot accept an unsigned integer constant larger than 4,294,967,295 (0FFFFFFFF hexadecimal), or a floating-point constant whose magnitude is larger than approximately 1.8E+308. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md index f6c81de30cc..6dba3c0c4d0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md @@ -8,7 +8,7 @@ ms.assetid: af74db02-a64d-49ca-8363-3e044a107580 --- # Expression Evaluator Error CXX0017 -symbol not found +> symbol not found A symbol specified in an expression could not be found. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md index 9f7e92345ca..3eddc4847e7 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md @@ -8,7 +8,7 @@ ms.assetid: d3d115d6-8981-4651-b615-566de867a263 --- # Expression Evaluator Error CXX0018 -bad register name +> bad register name A specified register does not exist or cannot be displayed. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md index 680e0ee45f5..2b20fd17abf 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md @@ -8,7 +8,7 @@ ms.assetid: 4c6431fd-3310-4a61-934d-58b070b330fe --- # Expression Evaluator Error CXX0019 -bad type cast +> bad type cast The C expression evaluator cannot perform the type cast as written. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md index c34f0f55823..dcc86dd4985 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md @@ -8,7 +8,7 @@ ms.assetid: 9dc57c25-e976-44e8-9a4e-db5a79e35bd7 --- # Expression Evaluator Error CXX0020 -operand types bad for this operation +> operand types bad for this operation An operator was applied to an expression with an invalid type for that operator. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md index 162380237e5..01eb11f86d0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md @@ -8,7 +8,7 @@ ms.assetid: d6c0c35a-16c2-42c0-a7d2-e910350a47f0 --- # Expression Evaluator Error CXX0021 -struct or union used as scalar +> struct or union used as scalar A structure or union was used in an expression, but no element was specified. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md index 1c06fe8c2a0..aa455ac80b5 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md @@ -8,7 +8,7 @@ ms.assetid: f6b299ac-a4ee-492c-bd9f-6fff005bc537 --- # Expression Evaluator Error CXX0022 -function call before _main +> function call before _main The C expression evaluator cannot evaluate a function before the debugger has entered the function **_main**. The program is not properly initialized until **_main** has been called. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md index d71fb7f9703..fb0d22e6577 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md @@ -8,7 +8,7 @@ ms.assetid: 2de27692-dfb5-433f-82b3-80f118756eec --- # Expression Evaluator Error CXX0023 -bad radix +> bad radix The C expression evaluator does not recognize the radix specified. Only decimal, hexadecimal, and octal radixes are valid. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md index 92cf0e9e802..be0da678a54 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md @@ -8,7 +8,7 @@ ms.assetid: eca6adbd-8ff2-4f51-a1cc-a2e9d5d0a47d --- # Expression Evaluator Error CXX0024 -operation needs l-value +> operation needs l-value An expression that does not evaluate to an l-value was specified for an operation that requires an l-value. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md index 10467f5b2ab..d28aa8c9818 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md @@ -8,7 +8,7 @@ ms.assetid: 3e2fb541-63b3-46ac-9f93-3dadb253bcf6 --- # Expression Evaluator Error CXX0025 -operator needs struct/union +> operator needs struct/union An operator that takes an expression of **`struct`** or **`union`** type was applied to an expression that is not a **`struct`** or **`union`**. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md index ed489fd094c..96f86472a1f 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md @@ -8,7 +8,7 @@ ms.assetid: b5bc15f2-f179-4b87-ae88-a57e08e43bfa --- # Expression Evaluator Error CXX0026 -bad format string +> bad format string A format string was improperly specified. Check the syntax of the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md index 20755a40dbe..9c8e6b54cc4 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md @@ -8,7 +8,7 @@ ms.assetid: 0127cfc0-c292-4923-a58b-25542343cdad --- # Expression Evaluator Error CXX0027 -tp addr not l-value +> tp addr not l-value Check the syntax of the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md index 78d2a0aa519..82fedc18d3f 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md @@ -8,7 +8,7 @@ ms.assetid: 172eb81f-c0b0-43b1-b418-766f35f1a561 --- # Expression Evaluator Error CXX0028 -not struct/union element +> not struct/union element An expression of the form 'Struct.Member' or 'pStruct->Member' was specified, but \ is not an element of the structure. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md index 2e7ea0170bb..be063af8445 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md @@ -8,7 +8,7 @@ ms.assetid: 562b2132-e9cb-4591-a5bf-bc7179a7f40e --- # Expression Evaluator Error CXX0029 -not struct pointer +> not struct pointer The member-selection operator (**->**) was applied to an expression that is not a pointer to a structure. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md index 64a58f4ddbf..89f85232bd4 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md @@ -8,7 +8,7 @@ ms.assetid: ada8b48c-09c8-49bf-ae23-313ed663c4fe --- # Expression Evaluator Error CXX0030 -expression not evaluatable +> expression not evaluatable The debugger's expression evaluator could not obtain a value for the expression as written. One likely cause is that the expression refers to memory that is outside the program's address space (dereferencing a null pointer is one example). Windows does not allow access to memory that is outside of the program's address space. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md index 255307a8bbf..ba3e1312144 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md @@ -8,7 +8,7 @@ ms.assetid: adafbcb7-982f-495f-a34d-72e95d7e54c7 --- # Expression Evaluator Error CXX0031 -expression not expandable +> expression not expandable The expression evaluator encountered an internal error. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md index a9902fe416c..a24b7142d3e 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md @@ -8,7 +8,7 @@ ms.assetid: 78f56977-6b6d-42e2-b71d-c392525bb18b --- # Expression Evaluator Error CXX0032 -divide by 0 +> divide by 0 The expression contains a divisor of zero, which is illegal. This divisor may be the literal number zero, or it may be an expression that evaluates to zero. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md index 198a6def252..9e9f10c2aed 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md @@ -8,7 +8,7 @@ ms.assetid: 0bd62c5b-de89-481f-9b12-88fe84805afe --- # Expression Evaluator Error CXX0033 -error in OMF type information +> error in OMF type information The executable file did not have a valid object module format (OMF) for debugging. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md index 829dacf515a..e91335a6193 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md @@ -8,7 +8,7 @@ ms.assetid: afcee5f1-beff-489f-aea6-04f55e76364f --- # Expression Evaluator Error CXX0034 -**types incompatible with operator** +> types incompatible with operator The operand types specified are not legal for the operation. From 2da7f7dc07e64ff28521c50b5c80ae2bb07a5507 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 00:53:59 +0800 Subject: [PATCH 1131/1799] Add "Remarks" headings for error references in range [CXX0000, CXX0034] --- .../tool-errors/expression-evaluator-error-cxx0000.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0001.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0002.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0004.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0005.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0006.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0007.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0008.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0009.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0010.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0011.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0012.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0013.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0014.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0015.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0016.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0017.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0018.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0019.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0020.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0021.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0022.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0023.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0024.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0025.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0026.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0027.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0028.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0029.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0030.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0031.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0032.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0033.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0034.md | 2 ++ 34 files changed, 68 insertions(+) diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md index e34b4fe80f9..7e7c2799c9a 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md @@ -10,6 +10,8 @@ ms.assetid: 95a7f17d-88ea-4a6c-a3af-2289bf0529fe > no error condition +## Remarks + No error has occurred. You can continue debugging normally. Note the circumstances and notify Microsoft Product Support Services. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md index 2e94bc6345c..cb6dcceee1d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md @@ -10,4 +10,6 @@ ms.assetid: 39cdf175-e4b8-49c1-bf84-ed41e0fd8600 > exception executing user function +## Remarks + The code being executed caused a general protection fault. This error is identical to CAN0001. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md index cbb52adabb7..7869e915dd8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md @@ -10,6 +10,8 @@ ms.assetid: 5f136470-505f-4224-a29a-2d34e896d78b > error accessing user memory +## Remarks + The expression attempts to reference memory that is not allocated to the program being debugged. This error is identical to CAN0002. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md index ca0b51ca494..3c775433ed7 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md @@ -10,6 +10,8 @@ ms.assetid: a4063eda-0335-4ae7-9595-29cf10669376 > syntax error +## Remarks + The syntax of the expression is incorrect. Retype the expression with the correct syntax. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md index 176963b62d6..8ef8f2b3416 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md @@ -10,6 +10,8 @@ ms.assetid: b88e83e4-10aa-4e9c-94d3-92aa8c688748 > operator not supported +## Remarks + An unsupported C operator was specified in an expression. Write an equivalent expression using the supported C operators. This error is identical to CAN0005. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md index f89cdfdce72..5cae50aae1e 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md @@ -10,6 +10,8 @@ ms.assetid: 34a8e21c-5443-4817-aad9-bb3143cfcaa6 > missing left parenthesis +## Remarks + Unbalanced parentheses were found in the expression. Retype the expression with balanced parentheses. This error is identical to CAN0006. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md index 1096674637f..f62a80d0154 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md @@ -10,6 +10,8 @@ ms.assetid: 270a6d2d-ea6b-4a94-9871-841a6a133292 > missing right parenthesis +## Remarks + Unbalanced parentheses were found in the expression. Retype the expression with balanced parentheses. This error is identical to CAN0007. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md index cf817b8ecfb..c800cc756b0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md @@ -10,6 +10,8 @@ ms.assetid: 49e0968c-a6ce-4ba9-9762-02a55c08124e > missing " at end of string +## Remarks + The double quote expected at the end of the string literal was missing. Retype the expression, enclosing the string literal in double quotation marks. This error is identical to CAN0008. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md index 7ddcb08e12d..f3357c696f8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md @@ -10,6 +10,8 @@ ms.assetid: b6f26a46-56f3-430f-a6db-b42934ddf331 > missing ' after character constant +## Remarks + The single quote expected at the end of the character constant was missing. Retype the expression, enclosing the character constant in single quotation marks. This error is identical to CAN0009. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md index 9b437aadece..427a1e77b44 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md @@ -10,6 +10,8 @@ ms.assetid: 8bd474b0-da12-4990-8569-6392f09f05f6 > missing left bracket +## Remarks + The expression contains unbalanced square brackets. Retype the expression with balanced square brackets. This error is identical to CAN0010. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md index 079a24fc844..7606a2393bf 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md @@ -10,6 +10,8 @@ ms.assetid: c2252e89-ad66-43fc-93e4-b886dcbd3f19 > missing right bracket +## Remarks + The expression contains unbalanced square brackets. Retype the expression with balanced square brackets. This error is identical to CAN0011. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md index 9fcbd43516e..879fdb0e553 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md @@ -10,6 +10,8 @@ ms.assetid: bf547e21-6708-4854-ad23-2ae5a889fd82 > missing left curly brace +## Remarks + The expression contains an unbalanced curly brace. Retype the expression with balanced curly braces. This error is identical to CAN0012. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md index 6f6b87b3165..5f1227500c8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md @@ -10,6 +10,8 @@ ms.assetid: cf571e37-008d-47cd-80fa-59e96b1146e1 > missing operator +## Remarks + An operator was expected in the expression but was not found. Check the syntax of the expression. This error is identical to CAN0013. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md index 42876228154..e445338e9e0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md @@ -10,6 +10,8 @@ ms.assetid: 3bb0278d-3dd6-4626-9945-3cf29afbbacb > missing operand +## Remarks + An operator was specified without a required operand. Check the syntax of the expression. This error is identical to CAN0014. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md index dc87286f579..52e014037fe 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md @@ -10,6 +10,8 @@ ms.assetid: 35efaf77-d578-48d8-bfc5-fdeb2a46a8b5 > expression too complex (stack overflow) +## Remarks + The expression entered was too complex or nested too deeply for the amount of storage available to the C expression evaluator. Overflow usually occurs because of too many pending calculations. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md index 959aa65d9f0..fb491fc71ae 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md @@ -10,6 +10,8 @@ ms.assetid: af94a2ae-e835-4da6-8d2f-5c879f72eda2 > constant too big +## Remarks + The C expression evaluator cannot accept an unsigned integer constant larger than 4,294,967,295 (0FFFFFFFF hexadecimal), or a floating-point constant whose magnitude is larger than approximately 1.8E+308. This error is identical to CAN0016. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md index 6dba3c0c4d0..c0243c04360 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md @@ -10,6 +10,8 @@ ms.assetid: af74db02-a64d-49ca-8363-3e044a107580 > symbol not found +## Remarks + A symbol specified in an expression could not be found. One possible cause of this error is a case mismatch in the symbol name. Because C and C++ are case-sensitive languages, a symbol name must be given in the exact case in which it is defined in the source. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md index 3eddc4847e7..d8d13712359 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md @@ -10,6 +10,8 @@ ms.assetid: d3d115d6-8981-4651-b615-566de867a263 > bad register name +## Remarks + A specified register does not exist or cannot be displayed. The Watch window can display the following registers: diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md index 2b20fd17abf..2d6455f48a6 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md @@ -10,6 +10,8 @@ ms.assetid: 4c6431fd-3310-4a61-934d-58b070b330fe > bad type cast +## Remarks + The C expression evaluator cannot perform the type cast as written. This error is identical to CAN0019. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md index dcc86dd4985..29032f0ce51 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md @@ -10,6 +10,8 @@ ms.assetid: 9dc57c25-e976-44e8-9a4e-db5a79e35bd7 > operand types bad for this operation +## Remarks + An operator was applied to an expression with an invalid type for that operator. For example, it is not valid to take the address of a register or subscript an array with a floating-point expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md index 01eb11f86d0..2d860fbae11 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md @@ -10,6 +10,8 @@ ms.assetid: d6c0c35a-16c2-42c0-a7d2-e910350a47f0 > struct or union used as scalar +## Remarks + A structure or union was used in an expression, but no element was specified. When manipulating a structure or union variable, the name of the variable may appear by itself, without a field qualifier. If a structure or union is used in an expression, it must be qualified with the specific element desired. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md index aa455ac80b5..ff3d1aa6d27 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md @@ -10,6 +10,8 @@ ms.assetid: f6b299ac-a4ee-492c-bd9f-6fff005bc537 > function call before _main +## Remarks + The C expression evaluator cannot evaluate a function before the debugger has entered the function **_main**. The program is not properly initialized until **_main** has been called. This error is identical to CAN0022. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md index fb0d22e6577..a9024dcd116 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md @@ -10,6 +10,8 @@ ms.assetid: 2de27692-dfb5-433f-82b3-80f118756eec > bad radix +## Remarks + The C expression evaluator does not recognize the radix specified. Only decimal, hexadecimal, and octal radixes are valid. This error is identical to CAN0023. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md index be0da678a54..b6de68fc800 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md @@ -10,6 +10,8 @@ ms.assetid: eca6adbd-8ff2-4f51-a1cc-a2e9d5d0a47d > operation needs l-value +## Remarks + An expression that does not evaluate to an l-value was specified for an operation that requires an l-value. An l-value (so called because it appears on the left side of an assignment statement) is an expression that refers to a memory location. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md index d28aa8c9818..155304e0595 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md @@ -10,6 +10,8 @@ ms.assetid: 3e2fb541-63b3-46ac-9f93-3dadb253bcf6 > operator needs struct/union +## Remarks + An operator that takes an expression of **`struct`** or **`union`** type was applied to an expression that is not a **`struct`** or **`union`**. Components of class, structure, or union variables must have a fully qualified name. Components cannot be entered without full specification. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md index 96f86472a1f..c2a18088295 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md @@ -10,6 +10,8 @@ ms.assetid: b5bc15f2-f179-4b87-ae88-a57e08e43bfa > bad format string +## Remarks + A format string was improperly specified. Check the syntax of the expression. This error is identical to CAN0026. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md index 9c8e6b54cc4..6c6c8830647 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md @@ -10,6 +10,8 @@ ms.assetid: 0127cfc0-c292-4923-a58b-25542343cdad > tp addr not l-value +## Remarks + Check the syntax of the expression. This error is identical to CAN0027. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md index 82fedc18d3f..cdecf73f118 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md @@ -10,6 +10,8 @@ ms.assetid: 172eb81f-c0b0-43b1-b418-766f35f1a561 > not struct/union element +## Remarks + An expression of the form 'Struct.Member' or 'pStruct->Member' was specified, but \ is not an element of the structure. The expression may not be parenthesized correctly. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md index be063af8445..c888e70820b 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md @@ -10,6 +10,8 @@ ms.assetid: 562b2132-e9cb-4591-a5bf-bc7179a7f40e > not struct pointer +## Remarks + The member-selection operator (**->**) was applied to an expression that is not a pointer to a structure. Check that the entire expression is parenthesized correctly, or type cast the address expression to the appropriate structure pointer type. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md index 89f85232bd4..c5b68d59e49 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md @@ -10,6 +10,8 @@ ms.assetid: ada8b48c-09c8-49bf-ae23-313ed663c4fe > expression not evaluatable +## Remarks + The debugger's expression evaluator could not obtain a value for the expression as written. One likely cause is that the expression refers to memory that is outside the program's address space (dereferencing a null pointer is one example). Windows does not allow access to memory that is outside of the program's address space. You may want to rewrite your expression using parentheses to control the order of evaluation. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md index ba3e1312144..efe7dc7b4aa 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md @@ -10,6 +10,8 @@ ms.assetid: adafbcb7-982f-495f-a34d-72e95d7e54c7 > expression not expandable +## Remarks + The expression evaluator encountered an internal error. You may be able to write an equivalent expression that can be evaluated correctly. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md index a24b7142d3e..b6366d55d12 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md @@ -10,6 +10,8 @@ ms.assetid: 78f56977-6b6d-42e2-b71d-c392525bb18b > divide by 0 +## Remarks + The expression contains a divisor of zero, which is illegal. This divisor may be the literal number zero, or it may be an expression that evaluates to zero. This error is identical to CAN0032. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md index 9e9f10c2aed..8f42f3539c1 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md @@ -10,6 +10,8 @@ ms.assetid: 0bd62c5b-de89-481f-9b12-88fe84805afe > error in OMF type information +## Remarks + The executable file did not have a valid object module format (OMF) for debugging. This error is identical to CAN0033. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md index e91335a6193..dedf3a6ee43 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md @@ -10,6 +10,8 @@ ms.assetid: afcee5f1-beff-489f-aea6-04f55e76364f > types incompatible with operator +## Remarks + The operand types specified are not legal for the operation. For example, a pointer cannot be multiplied by any value. From e8ef4a4f50a7a3fc486697b1dba9870fd5f1cafa Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 00:59:43 +0800 Subject: [PATCH 1132/1799] Update metadata for error references in range [CXX0000, CXX0034] --- .../tool-errors/expression-evaluator-error-cxx0000.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0001.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0002.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0004.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0005.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0006.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0007.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0008.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0009.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0010.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0011.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0012.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0013.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0014.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0015.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0016.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0017.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0018.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0019.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0020.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0021.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0022.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0023.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0024.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0025.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0026.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0027.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0028.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0029.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0030.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0031.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0032.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0033.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0034.md | 5 ++--- 34 files changed, 68 insertions(+), 102 deletions(-) diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md index 7e7c2799c9a..36257d65814 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0000" title: "Expression Evaluator Error CXX0000" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0000" +ms.date: 11/04/2016 f1_keywords: ["CXX0000"] helpviewer_keywords: ["CAN0000", "CXX0000"] -ms.assetid: 95a7f17d-88ea-4a6c-a3af-2289bf0529fe --- # Expression Evaluator Error CXX0000 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md index cb6dcceee1d..6eaffca2052 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0001" title: "Expression Evaluator Error CXX0001" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0001" +ms.date: 11/04/2016 f1_keywords: ["CXX0001"] helpviewer_keywords: ["CXX0001", "CAN0001"] -ms.assetid: 39cdf175-e4b8-49c1-bf84-ed41e0fd8600 --- # Expression Evaluator Error CXX0001 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md index 7869e915dd8..5cdf941c8d9 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0002" title: "Expression Evaluator Error CXX0002" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0002" +ms.date: 11/04/2016 f1_keywords: ["CXX0002"] helpviewer_keywords: ["CXX0002", "CAN0002"] -ms.assetid: 5f136470-505f-4224-a29a-2d34e896d78b --- # Expression Evaluator Error CXX0002 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md index 3c775433ed7..dbf174f51fe 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0004" title: "Expression Evaluator Error CXX0004" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0004" +ms.date: 11/04/2016 f1_keywords: ["CXX0004"] helpviewer_keywords: ["CAN0004", "CXX0004"] -ms.assetid: a4063eda-0335-4ae7-9595-29cf10669376 --- # Expression Evaluator Error CXX0004 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md index 8ef8f2b3416..9aac32814d1 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0005" title: "Expression Evaluator Error CXX0005" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0005" +ms.date: 11/04/2016 f1_keywords: ["CXX0005"] helpviewer_keywords: ["CXX0005", "CAN0005"] -ms.assetid: b88e83e4-10aa-4e9c-94d3-92aa8c688748 --- # Expression Evaluator Error CXX0005 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md index 5cae50aae1e..2a172e02f87 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0006" title: "Expression Evaluator Error CXX0006" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0006" +ms.date: 11/04/2016 f1_keywords: ["CXX0006"] helpviewer_keywords: ["CAN0006", "CXX0006"] -ms.assetid: 34a8e21c-5443-4817-aad9-bb3143cfcaa6 --- # Expression Evaluator Error CXX0006 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md index f62a80d0154..886c1987ad8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0007" title: "Expression Evaluator Error CXX0007" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0007" +ms.date: 11/04/2016 f1_keywords: ["CXX0007"] helpviewer_keywords: ["CXX0007", "CAN0007"] -ms.assetid: 270a6d2d-ea6b-4a94-9871-841a6a133292 --- # Expression Evaluator Error CXX0007 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md index c800cc756b0..201553ebca2 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0008" title: "Expression Evaluator Error CXX0008" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0008" +ms.date: 11/04/2016 f1_keywords: ["CXX0008"] helpviewer_keywords: ["CXX0008", "CAN0008"] -ms.assetid: 49e0968c-a6ce-4ba9-9762-02a55c08124e --- # Expression Evaluator Error CXX0008 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md index f3357c696f8..22cebf0aa8c 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0009" title: "Expression Evaluator Error CXX0009" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0009" +ms.date: 11/04/2016 f1_keywords: ["CXX0009"] helpviewer_keywords: ["CXX0009", "CAN0009"] -ms.assetid: b6f26a46-56f3-430f-a6db-b42934ddf331 --- # Expression Evaluator Error CXX0009 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md index 427a1e77b44..d3eb52bb8cc 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0010" title: "Expression Evaluator Error CXX0010" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0010" +ms.date: 11/04/2016 f1_keywords: ["CXX0010"] helpviewer_keywords: ["CAN0010", "CXX0010"] -ms.assetid: 8bd474b0-da12-4990-8569-6392f09f05f6 --- # Expression Evaluator Error CXX0010 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md index 7606a2393bf..73e96763e91 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0011" title: "Expression Evaluator Error CXX0011" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0011" +ms.date: 11/04/2016 f1_keywords: ["CXX0011"] helpviewer_keywords: ["CAN0011", "CXX0011"] -ms.assetid: c2252e89-ad66-43fc-93e4-b886dcbd3f19 --- # Expression Evaluator Error CXX0011 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md index 879fdb0e553..367224bbc98 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0012" title: "Expression Evaluator Error CXX0012" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0012" +ms.date: 11/04/2016 f1_keywords: ["CXX0012"] helpviewer_keywords: ["CXX0012", "CAN0012"] -ms.assetid: bf547e21-6708-4854-ad23-2ae5a889fd82 --- # Expression Evaluator Error CXX0012 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md index 5f1227500c8..91bcbb1a834 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0013" title: "Expression Evaluator Error CXX0013" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0013" +ms.date: 11/04/2016 f1_keywords: ["CXX0013"] helpviewer_keywords: ["CAN0013", "CXX0013"] -ms.assetid: cf571e37-008d-47cd-80fa-59e96b1146e1 --- # Expression Evaluator Error CXX0013 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md index e445338e9e0..9876536b5c0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0014" title: "Expression Evaluator Error CXX0014" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0014" +ms.date: 11/04/2016 f1_keywords: ["CXX0014"] helpviewer_keywords: ["CAN0014", "CXX0014"] -ms.assetid: 3bb0278d-3dd6-4626-9945-3cf29afbbacb --- # Expression Evaluator Error CXX0014 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md index 52e014037fe..bb5d1ed5373 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0015" title: "Expression Evaluator Error CXX0015" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0015" +ms.date: 11/04/2016 f1_keywords: ["CXX0015"] helpviewer_keywords: ["CXX0015", "CAN0015"] -ms.assetid: 35efaf77-d578-48d8-bfc5-fdeb2a46a8b5 --- # Expression Evaluator Error CXX0015 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md index fb491fc71ae..b1707a48dd8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0016" title: "Expression Evaluator Error CXX0016" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0016" +ms.date: 11/04/2016 f1_keywords: ["CXX0016"] helpviewer_keywords: ["CAN0016", "CXX0016"] -ms.assetid: af94a2ae-e835-4da6-8d2f-5c879f72eda2 --- # Expression Evaluator Error CXX0016 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md index c0243c04360..6c938f71ef0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0017" title: "Expression Evaluator Error CXX0017" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0017" +ms.date: 11/04/2016 f1_keywords: ["CXX0017"] helpviewer_keywords: ["CAN0017", "CXX0017"] -ms.assetid: af74db02-a64d-49ca-8363-3e044a107580 --- # Expression Evaluator Error CXX0017 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md index d8d13712359..dac98b60f4d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0018" title: "Expression Evaluator Error CXX0018" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0018" +ms.date: 11/04/2016 f1_keywords: ["CXX0018"] helpviewer_keywords: ["CAN0018", "CXX0018"] -ms.assetid: d3d115d6-8981-4651-b615-566de867a263 --- # Expression Evaluator Error CXX0018 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md index 2d6455f48a6..80ad76d78e5 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0019" title: "Expression Evaluator Error CXX0019" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0019" +ms.date: 11/04/2016 f1_keywords: ["CXX0019"] helpviewer_keywords: ["CXX0019", "CAN0019"] -ms.assetid: 4c6431fd-3310-4a61-934d-58b070b330fe --- # Expression Evaluator Error CXX0019 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md index 29032f0ce51..2b553478ee1 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0020" title: "Expression Evaluator Error CXX0020" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0020" +ms.date: 11/04/2016 f1_keywords: ["CXX0020"] helpviewer_keywords: ["CXX0020", "CAN0020"] -ms.assetid: 9dc57c25-e976-44e8-9a4e-db5a79e35bd7 --- # Expression Evaluator Error CXX0020 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md index 2d860fbae11..1b1bbf92e52 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0021" title: "Expression Evaluator Error CXX0021" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0021" +ms.date: 11/04/2016 f1_keywords: ["CXX0021"] helpviewer_keywords: ["CXX0021", "CAN0021"] -ms.assetid: d6c0c35a-16c2-42c0-a7d2-e910350a47f0 --- # Expression Evaluator Error CXX0021 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md index ff3d1aa6d27..9e22b714a45 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0022" title: "Expression Evaluator Error CXX0022" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0022" +ms.date: 11/04/2016 f1_keywords: ["CXX0022"] helpviewer_keywords: ["CXX0022", "CAN0022"] -ms.assetid: f6b299ac-a4ee-492c-bd9f-6fff005bc537 --- # Expression Evaluator Error CXX0022 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md index a9024dcd116..b052cd60af5 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0023" title: "Expression Evaluator Error CXX0023" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0023" +ms.date: 11/04/2016 f1_keywords: ["CXX0023"] helpviewer_keywords: ["CXX0023", "CAN0023"] -ms.assetid: 2de27692-dfb5-433f-82b3-80f118756eec --- # Expression Evaluator Error CXX0023 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md index b6de68fc800..e43cd889199 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0024" title: "Expression Evaluator Error CXX0024" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0024" +ms.date: 11/04/2016 f1_keywords: ["CXX0024"] helpviewer_keywords: ["CXX0024", "CAN0024"] -ms.assetid: eca6adbd-8ff2-4f51-a1cc-a2e9d5d0a47d --- # Expression Evaluator Error CXX0024 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md index 155304e0595..ed2c8ec0b45 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0025" title: "Expression Evaluator Error CXX0025" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0025" +ms.date: 11/04/2016 f1_keywords: ["CXX0025"] helpviewer_keywords: ["CAN0025", "CXX0025"] -ms.assetid: 3e2fb541-63b3-46ac-9f93-3dadb253bcf6 --- # Expression Evaluator Error CXX0025 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md index c2a18088295..2cc930c9869 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0026" title: "Expression Evaluator Error CXX0026" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0026" +ms.date: 11/04/2016 f1_keywords: ["CXX0026"] helpviewer_keywords: ["CXX0026", "CAN0026"] -ms.assetid: b5bc15f2-f179-4b87-ae88-a57e08e43bfa --- # Expression Evaluator Error CXX0026 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md index 6c6c8830647..d69c9d7659d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0027" title: "Expression Evaluator Error CXX0027" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0027" +ms.date: 11/04/2016 f1_keywords: ["CXX0027"] helpviewer_keywords: ["CAN0027", "CXX0027"] -ms.assetid: 0127cfc0-c292-4923-a58b-25542343cdad --- # Expression Evaluator Error CXX0027 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md index cdecf73f118..8cfb6900d31 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0028" title: "Expression Evaluator Error CXX0028" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0028" +ms.date: 11/04/2016 f1_keywords: ["CXX0028"] helpviewer_keywords: ["CAN0028", "CXX0028"] -ms.assetid: 172eb81f-c0b0-43b1-b418-766f35f1a561 --- # Expression Evaluator Error CXX0028 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md index c888e70820b..6ca03e1d0e0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0029" title: "Expression Evaluator Error CXX0029" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0029" +ms.date: 11/04/2016 f1_keywords: ["CXX0029"] helpviewer_keywords: ["CXX0029", "CAN0029"] -ms.assetid: 562b2132-e9cb-4591-a5bf-bc7179a7f40e --- # Expression Evaluator Error CXX0029 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md index c5b68d59e49..8c980d87cca 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0030" title: "Expression Evaluator Error CXX0030" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0030" +ms.date: 11/04/2016 f1_keywords: ["CXX0030"] helpviewer_keywords: ["CAN0030", "CXX0030"] -ms.assetid: ada8b48c-09c8-49bf-ae23-313ed663c4fe --- # Expression Evaluator Error CXX0030 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md index efe7dc7b4aa..6b95122dad0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0031" title: "Expression Evaluator Error CXX0031" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0031" +ms.date: 11/04/2016 f1_keywords: ["CXX0031"] helpviewer_keywords: ["CAN0031", "CXX0031"] -ms.assetid: adafbcb7-982f-495f-a34d-72e95d7e54c7 --- # Expression Evaluator Error CXX0031 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md index b6366d55d12..505f99fbb2b 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0032" title: "Expression Evaluator Error CXX0032" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0032" +ms.date: 11/04/2016 f1_keywords: ["CXX0032"] helpviewer_keywords: ["CXX0032", "CAN0032"] -ms.assetid: 78f56977-6b6d-42e2-b71d-c392525bb18b --- # Expression Evaluator Error CXX0032 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md index 8f42f3539c1..759e150bbef 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0033" title: "Expression Evaluator Error CXX0033" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0033" +ms.date: 11/04/2016 f1_keywords: ["CXX0033"] helpviewer_keywords: ["CAN0033", "CXX0033"] -ms.assetid: 0bd62c5b-de89-481f-9b12-88fe84805afe --- # Expression Evaluator Error CXX0033 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md index dedf3a6ee43..ef6ccecab13 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0034" title: "Expression Evaluator Error CXX0034" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0034" +ms.date: 11/04/2016 f1_keywords: ["CXX0034"] helpviewer_keywords: ["CAN0034", "CXX0034"] -ms.assetid: afcee5f1-beff-489f-aea6-04f55e76364f --- # Expression Evaluator Error CXX0034 From 8cdb0e37b76322a7cd4426a8ffd227b819c84798 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 01:06:25 +0800 Subject: [PATCH 1133/1799] Add blockquotes for error messages in range [CXX0035, CXX0072] --- .../tool-errors/expression-evaluator-error-cxx0036.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0037.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0038.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0039.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0040.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0041.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0043.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0044.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0045.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0046.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0047.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0048.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0049.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0050.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0051.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0052.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0053.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0054.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0055.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0056.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0057.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0058.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0059.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0060.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0061.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0062.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0063.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0064.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0065.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0066.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0067.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0069.md | 2 +- .../tool-errors/expression-evaluator-error-cxx0072.md | 2 +- 33 files changed, 33 insertions(+), 33 deletions(-) diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md index 6c86cd2b0b7..d63434e3e68 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md @@ -8,7 +8,7 @@ ms.assetid: 383404be-df5b-4eec-b113-df21bb5d269d --- # Expression Evaluator Error CXX0036 -bad context {...} specification +> bad context {...} specification This message can be generated by any of several errors in the use of the context operator (**{}**). diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md index 48e93579abb..b2176e3b020 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md @@ -8,7 +8,7 @@ ms.assetid: 8059ad65-78b7-465a-98fa-387fd5873ea6 --- # Expression Evaluator Error CXX0037 -out of memory +> out of memory The C expression evaluator ran out of memory evaluating the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md index 51969d57d34..c9db043cc13 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md @@ -8,7 +8,7 @@ ms.assetid: 3327dc4e-1726-4924-a519-6ffd766a389c --- # Expression Evaluator Error CXX0038 -function argument count and/or type mismatch +> function argument count and/or type mismatch The function call as specified does not match the prototype for the function. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md index 8b0274bd435..54a3d5b7d59 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md @@ -8,7 +8,7 @@ ms.assetid: 8bf698d2-e015-4595-944f-72b81aa43d22 --- # Expression Evaluator Error CXX0039 -symbol is ambiguous +> symbol is ambiguous The C expression evaluator cannot determine which instance of a symbol to use in an expression. The symbol occurs more than once in the inheritance tree. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md index b1cb02f95b6..fc8dd2fa3cd 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md @@ -8,7 +8,7 @@ ms.assetid: 1914e605-d80b-4abc-9e8f-dbcbefec095b --- # Expression Evaluator Error CXX0040 -function requires implicit conversion +> function requires implicit conversion The C expression evaluator does not support implicit conversions involving constructor calls. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md index cd956d21484..21959b1c2fb 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md @@ -8,7 +8,7 @@ ms.assetid: ce8a2366-758f-481b-8c03-ed7d779091b2 --- # Expression Evaluator Error CXX0041 -class element must be static member or member function +> class element must be static member or member function A nonstatic member of a class (or structure or union) was used without specifying which instantiation of the class to use. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md index 9ee2d06229f..5af4e5e1621 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md @@ -8,7 +8,7 @@ ms.assetid: 5e5d55bb-0f3e-40e6-b3c3-d0dfb701a65c --- # Expression Evaluator Error CXX0043 -this pointer used outside member function +> this pointer used outside member function The **`this`** pointer can only be used for nonstatic member functions. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md index b71528aecc9..8ef40fa35b0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md @@ -8,7 +8,7 @@ ms.assetid: d59868b5-c1ec-46ac-91d6-5d575a4d6b49 --- # Expression Evaluator Error CXX0044 -use of _based(void) pointer requires :> operator +> use of _based(void) pointer requires :> operator A pointer based on **`void`** cannot be used directly. You must form a complete pointer using the **:>** operator. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md index b6e4004e883..01067595a10 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md @@ -8,7 +8,7 @@ ms.assetid: 32181bc8-e79c-4ad7-a82f-47c62ec06d7d --- # Expression Evaluator Error CXX0045 -not a function +> not a function An argument list was supplied for a symbol in the program that is not the name of a function. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md index cd6e216b644..3df7f9dac49 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md @@ -8,7 +8,7 @@ ms.assetid: a76e657b-c018-415b-b426-ce9e72eb645d --- # Expression Evaluator Error CXX0046 -argument list required for member function +> argument list required for member function An expression called a member function but did not specify any actual parameters. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md index 09112a2f074..a205dc40cb2 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md @@ -8,7 +8,7 @@ ms.assetid: db23d0db-fce2-4d86-b391-6e1d6ad13fd4 --- # Expression Evaluator Error CXX0047 -argument list does not match a function +> argument list does not match a function An expression called a function with an actual parameter list that did not match the formal parameter list of any function with the same name defined in the program. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md index 5effef18e61..53b46ff8915 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md @@ -8,7 +8,7 @@ ms.assetid: 294416f9-5e38-4450-8713-c13bcbaaf615 --- # Expression Evaluator Error CXX0048 -calling sequence not supported +> calling sequence not supported A function specified in the expression uses a calling sequence not supported by the C expression evaluator. You cannot call this function in a Watch window expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md index 621a8825611..76632478896 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md @@ -8,7 +8,7 @@ ms.assetid: 6dcfece4-39ed-489d-b7be-2a17c7b94656 --- # Expression Evaluator Error CXX0049 -obsolete OMF - please relink program +> obsolete OMF - please relink program The program used an old OMF (Object Module Format). diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md index e096ec70438..bf67b72b6b3 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md @@ -8,7 +8,7 @@ ms.assetid: 214cd193-c6dc-41b9-9ebe-5a4b1689d3ab --- # Expression Evaluator Error CXX0050 -left side of :: must be class/struct/union +> left side of :: must be class/struct/union The symbol on the left side of the scope-resolution operator (`::`) was not a class, structure, or union. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md index 5b1d1ec0327..5d55ddcd237 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md @@ -8,7 +8,7 @@ ms.assetid: 031cd2ed-d9bb-4aa5-9858-71581bcca49c --- # Expression Evaluator Error CXX0051 -more than one overloaded symbol specified in breakpoint +> more than one overloaded symbol specified in breakpoint The expression evaluator could not determine which of more than one overloaded symbol to use as a breakpoint. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md index d8b78b97660..9f16d0e5700 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md @@ -8,7 +8,7 @@ ms.assetid: 5060d479-d0a4-4682-b858-c8b9a4f324e6 --- # Expression Evaluator Error CXX0052 -member function not present +> member function not present A member function was specified as a breakpoint but could not be found. Setting a breakpoint at a function that has been inlined can cause this error. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md index 7760402f7fc..03f42933f02 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md @@ -8,7 +8,7 @@ ms.assetid: fe74ed9e-9241-4df1-881f-104348e296c6 --- # Expression Evaluator Error CXX0053 -nonfunction symbol match while binding breakpoints +> nonfunction symbol match while binding breakpoints A symbol used as a breakpoint was not a function. Specifying a data member as a breakpoint can cause this error. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md index 2e504742e30..8dee786cd44 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md @@ -8,7 +8,7 @@ ms.assetid: d5d4a093-6a7a-45c0-8aa7-e555023353ef --- # Expression Evaluator Error CXX0054 -register in breakpoint expression illegal +> register in breakpoint expression illegal A register cannot be used in a breakpoint expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md index 3a625d08968..4566389abda 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md @@ -8,7 +8,7 @@ ms.assetid: bb2a81f9-35ea-4b02-a49e-6b2c7023aebd --- # Expression Evaluator Error CXX0055 -ambiguous symbol in context operator +> ambiguous symbol in context operator A symbol in the context operator (**{}**) referred to more than one symbol in the program. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md index 5c0937c856a..0ff346c7f6a 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md @@ -8,7 +8,7 @@ ms.assetid: a67c90e0-933c-43f2-a548-0ba272920331 --- # Expression Evaluator Error CXX0056 -error in line number +> error in line number An invalid line number was specified. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md index b3fec54b4e8..13af4b1b29a 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md @@ -8,7 +8,7 @@ ms.assetid: b1a86998-c642-4061-9f37-9c493f3852cc --- # Expression Evaluator Error CXX0057 -no code at line number +> no code at line number No code was generated for the specified line number. It cannot be used as a breakpoint. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md index 01b1de640fd..fddcd2927c7 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md @@ -8,7 +8,7 @@ ms.assetid: b6246c6e-5845-4ad5-ac2a-e6c4faf8f3f9 --- # Expression Evaluator Error CXX0058 -overloaded operator not found +> overloaded operator not found A class type was specified as the left operand in an expression, but an overloaded operator was not defined for the class. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md index bf9ea31ecda..c7b074e6873 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md @@ -8,7 +8,7 @@ ms.assetid: e8bdcb74-1315-4083-b24d-e47eac7d1ec0 --- # Expression Evaluator Error CXX0059 -left operand is class not a function name +> left operand is class not a function name The left operand of a function call was a class name and could not be resolved to a function call. Omitting the name of a member function in an expression can cause this error. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md index d4796731c77..068aee4fc13 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md @@ -8,7 +8,7 @@ ms.assetid: 40c0ff02-ca6b-4232-b1e3-1f3a213ee2a3 --- # Expression Evaluator Error CXX0060 -register is not available +> register is not available An expression specified a register that cannot be used. This error can be caused by trying to access a register that does not exist on the machine running. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md index 7afc6294ae4..6d5e6dc49db 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md @@ -8,7 +8,7 @@ ms.assetid: fa84dcca-87ef-4546-9dce-636ed39e0713 --- # Expression Evaluator Error CXX0061 -function nesting depth exceeded +> function nesting depth exceeded The expression contains a function nesting depth greater than the limit. Modify the expression to reduce the nesting depth. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md index 72ec432ce17..93a15834081 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md @@ -8,7 +8,7 @@ ms.assetid: 8e4165c4-7753-4f45-90e9-4542cbb9fc7a --- # Expression Evaluator Error CXX0062 -constructor calls not supported +> constructor calls not supported An expression made a call to a constructor. Expressions cannot make explicit calls to constructors or make conversions that require a call to a constructor. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md index 34e824c32bd..62ed2824402 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md @@ -8,7 +8,7 @@ ms.assetid: 2e131b7a-9c8f-4aa1-acac-8d87f602c24c --- # Expression Evaluator Error CXX0063 -overloaded operator -> not supported +> overloaded operator -> not supported The expression used an overloaded class member access operator (**->**). diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md index 74c67df4ac8..f6d9e630c13 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md @@ -8,7 +8,7 @@ ms.assetid: aa509e71-0616-41ca-a94e-6c376b041e57 --- # Expression Evaluator Error CXX0064 -can't set breakpoint on bound virtual member function +> can't set breakpoint on bound virtual member function A breakpoint was set on a virtual member function through a pointer to an object, such as: diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md index f768cdc47b6..7eea5413b94 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md @@ -8,7 +8,7 @@ ms.assetid: aac68f87-0b90-4c19-afa6-1c587625a5fd --- # Expression Evaluator Error CXX0065 -variable needs stack frame +> variable needs stack frame An expression contained a variable that exists within the current scope but hasn't been created yet. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md index 0ef4bf1d8c0..0bec4bde65f 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md @@ -8,7 +8,7 @@ ms.assetid: 1321e4e1-b441-424b-9e76-c208d4a6f6ea --- # Expression Evaluator Error CXX0066 -static member not present +> static member not present A static member of a class could not be found or was not defined. This error can result from a static class member that is declared but not defined, or is only defined and referenced in modules that do not contain debug information. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md index daa7e12991d..adfef37dc35 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md @@ -8,7 +8,7 @@ ms.assetid: 9a3e642b-4746-41ac-b665-bd98a6fa0cb3 --- # Expression Evaluator Error CXX0067 -function evaluation not supported +> function evaluation not supported The expression contained a function call. Some expression evaluators do not support function calls. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md index 70808d356e4..153e183ef87 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md @@ -8,6 +8,6 @@ ms.assetid: cf334b23-1e17-4d37-acc5-18597ee84164 --- # Expression Evaluator Error CXX0069 -variable needs stack frame +> variable needs stack frame The expression evaluator cannot evaluate the variable because it does not occur in a stack frame. This may be caused by variables declared as part of an inline function. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md index b731c03e1db..0d8aa7c2c46 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md @@ -8,7 +8,7 @@ ms.assetid: fd04e197-cfa9-4097-a070-8fa2111e876d --- # Expression Evaluator Error CXX0072 -Error: type information missing or unknown +> Error: type information missing or unknown The .pch file did not get linked in, or the code has a reference to a type that is in a module not compiled with /Zi. From 22fad926f43abbdea47fb8f8fa29906b2a452df0 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 01:11:54 +0800 Subject: [PATCH 1134/1799] Add "Remarks" and "Example" headings for error references in range [CXX0035, CXX0072] --- .../tool-errors/expression-evaluator-error-cxx0036.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0037.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0038.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0039.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0040.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0041.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0043.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0044.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0045.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0046.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0047.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0048.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0049.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0050.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0051.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0052.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0053.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0054.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0055.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0056.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0057.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0058.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0059.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0060.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0061.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0062.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0063.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0064.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0065.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0066.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0067.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0069.md | 2 ++ .../tool-errors/expression-evaluator-error-cxx0072.md | 2 ++ 33 files changed, 66 insertions(+) diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md index d63434e3e68..cf4ab72f2e0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md @@ -10,6 +10,8 @@ ms.assetid: 383404be-df5b-4eec-b113-df21bb5d269d > bad context {...} specification +## Remarks + This message can be generated by any of several errors in the use of the context operator (**{}**). - The syntax of the context operator (**{}**) was given incorrectly. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md index b2176e3b020..02bb07d5f4d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md @@ -10,6 +10,8 @@ ms.assetid: 8059ad65-78b7-465a-98fa-387fd5873ea6 > out of memory +## Remarks + The C expression evaluator ran out of memory evaluating the expression. This error is identical to CAN0037. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md index c9db043cc13..823128b2f46 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md @@ -10,6 +10,8 @@ ms.assetid: 3327dc4e-1726-4924-a519-6ffd766a389c > function argument count and/or type mismatch +## Remarks + The function call as specified does not match the prototype for the function. Retype the call with the correct number of arguments. Type cast each argument to match the prototype, as necessary. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md index 54a3d5b7d59..16f5c992f33 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md @@ -10,6 +10,8 @@ ms.assetid: 8bf698d2-e015-4595-944f-72b81aa43d22 > symbol is ambiguous +## Remarks + The C expression evaluator cannot determine which instance of a symbol to use in an expression. The symbol occurs more than once in the inheritance tree. You must use the scope resolution operator (`::`) to explicitly specify the instance to use in the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md index fc8dd2fa3cd..1d7d86afb9e 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md @@ -10,6 +10,8 @@ ms.assetid: 1914e605-d80b-4abc-9e8f-dbcbefec095b > function requires implicit conversion +## Remarks + The C expression evaluator does not support implicit conversions involving constructor calls. This error is identical to CAN0040. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md index 21959b1c2fb..6d23ee2c700 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md @@ -10,6 +10,8 @@ ms.assetid: ce8a2366-758f-481b-8c03-ed7d779091b2 > class element must be static member or member function +## Remarks + A nonstatic member of a class (or structure or union) was used without specifying which instantiation of the class to use. Only static data members or member functions can be used without specifying an instantiation. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md index 5af4e5e1621..c2cb481141d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md @@ -10,6 +10,8 @@ ms.assetid: 5e5d55bb-0f3e-40e6-b3c3-d0dfb701a65c > this pointer used outside member function +## Remarks + The **`this`** pointer can only be used for nonstatic member functions. This error is identical to CAN0043. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md index 8ef40fa35b0..7d3afba1dd8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md @@ -10,6 +10,8 @@ ms.assetid: d59868b5-c1ec-46ac-91d6-5d575a4d6b49 > use of _based(void) pointer requires :> operator +## Remarks + A pointer based on **`void`** cannot be used directly. You must form a complete pointer using the **:>** operator. This error is identical to CAN0044. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md index 01067595a10..a4230c53897 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md @@ -10,6 +10,8 @@ ms.assetid: 32181bc8-e79c-4ad7-a82f-47c62ec06d7d > not a function +## Remarks + An argument list was supplied for a symbol in the program that is not the name of a function. ## Example diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md index 3df7f9dac49..79f16aa7e61 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md @@ -10,6 +10,8 @@ ms.assetid: a76e657b-c018-415b-b426-ce9e72eb645d > argument list required for member function +## Remarks + An expression called a member function but did not specify any actual parameters. This error is identical to CAN0046. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md index a205dc40cb2..8b9820d1fcf 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md @@ -10,6 +10,8 @@ ms.assetid: db23d0db-fce2-4d86-b391-6e1d6ad13fd4 > argument list does not match a function +## Remarks + An expression called a function with an actual parameter list that did not match the formal parameter list of any function with the same name defined in the program. Overloaded functions can be called only if there is an exact parameter match or a match that does not require the construction of an object. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md index 53b46ff8915..5e740cc54ee 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md @@ -10,6 +10,8 @@ ms.assetid: 294416f9-5e38-4450-8713-c13bcbaaf615 > calling sequence not supported +## Remarks + A function specified in the expression uses a calling sequence not supported by the C expression evaluator. You cannot call this function in a Watch window expression. This error is identical to CAN0048. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md index 76632478896..353545e736f 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md @@ -10,6 +10,8 @@ ms.assetid: 6dcfece4-39ed-489d-b7be-2a17c7b94656 > obsolete OMF - please relink program +## Remarks + The program used an old OMF (Object Module Format). Relink the program using the current linker version. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md index bf67b72b6b3..a04eb67bbeb 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md @@ -10,6 +10,8 @@ ms.assetid: 214cd193-c6dc-41b9-9ebe-5a4b1689d3ab > left side of :: must be class/struct/union +## Remarks + The symbol on the left side of the scope-resolution operator (`::`) was not a class, structure, or union. This error is identical to CAN0050. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md index 5d55ddcd237..4038a36aa14 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md @@ -10,6 +10,8 @@ ms.assetid: 031cd2ed-d9bb-4aa5-9858-71581bcca49c > more than one overloaded symbol specified in breakpoint +## Remarks + The expression evaluator could not determine which of more than one overloaded symbol to use as a breakpoint. This error is identical to CAN0051. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md index 9f16d0e5700..68560cbaf06 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md @@ -10,6 +10,8 @@ ms.assetid: 5060d479-d0a4-4682-b858-c8b9a4f324e6 > member function not present +## Remarks + A member function was specified as a breakpoint but could not be found. Setting a breakpoint at a function that has been inlined can cause this error. Recompile the file with inlining forced off (/Ob0) to set a breakpoint in this function. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md index 03f42933f02..857f6f1d024 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md @@ -10,6 +10,8 @@ ms.assetid: fe74ed9e-9241-4df1-881f-104348e296c6 > nonfunction symbol match while binding breakpoints +## Remarks + A symbol used as a breakpoint was not a function. Specifying a data member as a breakpoint can cause this error. This error is identical to CAN0053. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md index 8dee786cd44..d794c5b267f 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md @@ -10,6 +10,8 @@ ms.assetid: d5d4a093-6a7a-45c0-8aa7-e555023353ef > register in breakpoint expression illegal +## Remarks + A register cannot be used in a breakpoint expression. This error is identical to CAN0054. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md index 4566389abda..20b6a9b4de6 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md @@ -10,6 +10,8 @@ ms.assetid: bb2a81f9-35ea-4b02-a49e-6b2c7023aebd > ambiguous symbol in context operator +## Remarks + A symbol in the context operator (**{}**) referred to more than one symbol in the program. The scope resolution operator (`::`) may be able to resolve the ambiguity. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md index 0ff346c7f6a..853d62a5cd8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md @@ -10,6 +10,8 @@ ms.assetid: a67c90e0-933c-43f2-a548-0ba272920331 > error in line number +## Remarks + An invalid line number was specified. This error is identical to CAN0056. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md index 13af4b1b29a..9b63f8643e9 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md @@ -10,6 +10,8 @@ ms.assetid: b1a86998-c642-4061-9f37-9c493f3852cc > no code at line number +## Remarks + No code was generated for the specified line number. It cannot be used as a breakpoint. This error is identical to CAN0057. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md index fddcd2927c7..53866dbe0dd 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md @@ -10,6 +10,8 @@ ms.assetid: b6246c6e-5845-4ad5-ac2a-e6c4faf8f3f9 > overloaded operator not found +## Remarks + A class type was specified as the left operand in an expression, but an overloaded operator was not defined for the class. This error is identical to CAN0058. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md index c7b074e6873..53da2c611aa 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md @@ -10,6 +10,8 @@ ms.assetid: e8bdcb74-1315-4083-b24d-e47eac7d1ec0 > left operand is class not a function name +## Remarks + The left operand of a function call was a class name and could not be resolved to a function call. Omitting the name of a member function in an expression can cause this error. This error is identical to CAN0059. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md index 068aee4fc13..00c18c9ef18 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md @@ -10,6 +10,8 @@ ms.assetid: 40c0ff02-ca6b-4232-b1e3-1f3a213ee2a3 > register is not available +## Remarks + An expression specified a register that cannot be used. This error can be caused by trying to access a register that does not exist on the machine running. This error is identical to CAN0060. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md index 6d5e6dc49db..da09df79e34 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md @@ -10,6 +10,8 @@ ms.assetid: fa84dcca-87ef-4546-9dce-636ed39e0713 > function nesting depth exceeded +## Remarks + The expression contains a function nesting depth greater than the limit. Modify the expression to reduce the nesting depth. This error is identical to CAN0061. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md index 93a15834081..a91c8cab401 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md @@ -10,6 +10,8 @@ ms.assetid: 8e4165c4-7753-4f45-90e9-4542cbb9fc7a > constructor calls not supported +## Remarks + An expression made a call to a constructor. Expressions cannot make explicit calls to constructors or make conversions that require a call to a constructor. This error is identical to CAN0062. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md index 62ed2824402..b931d856259 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md @@ -10,6 +10,8 @@ ms.assetid: 2e131b7a-9c8f-4aa1-acac-8d87f602c24c > overloaded operator -> not supported +## Remarks + The expression used an overloaded class member access operator (**->**). This error is identical to CAN0063. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md index f6d9e630c13..321f7d3cf7a 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md @@ -10,6 +10,8 @@ ms.assetid: aa509e71-0616-41ca-a94e-6c376b041e57 > can't set breakpoint on bound virtual member function +## Example + A breakpoint was set on a virtual member function through a pointer to an object, such as: ``` diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md index 7eea5413b94..43bb69b19e7 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md @@ -10,6 +10,8 @@ ms.assetid: aac68f87-0b90-4c19-afa6-1c587625a5fd > variable needs stack frame +## Remarks + An expression contained a variable that exists within the current scope but hasn't been created yet. This error can occur when you have stepped into the prolog of a function but not yet set up the stack frame for the function, or if you have stepped into the exit code for the function. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md index 0bec4bde65f..3fc027592b8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md @@ -10,6 +10,8 @@ ms.assetid: 1321e4e1-b441-424b-9e76-c208d4a6f6ea > static member not present +## Remarks + A static member of a class could not be found or was not defined. This error can result from a static class member that is declared but not defined, or is only defined and referenced in modules that do not contain debug information. This error is identical to CAN0066. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md index adfef37dc35..d95be75387a 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md @@ -10,6 +10,8 @@ ms.assetid: 9a3e642b-4746-41ac-b665-bd98a6fa0cb3 > function evaluation not supported +## Remarks + The expression contained a function call. Some expression evaluators do not support function calls. This error is identical to CAN0067. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md index 153e183ef87..d1c67ddc974 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md @@ -10,4 +10,6 @@ ms.assetid: cf334b23-1e17-4d37-acc5-18597ee84164 > variable needs stack frame +## Remarks + The expression evaluator cannot evaluate the variable because it does not occur in a stack frame. This may be caused by variables declared as part of an inline function. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md index 0d8aa7c2c46..61166349bac 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md @@ -10,6 +10,8 @@ ms.assetid: fd04e197-cfa9-4097-a070-8fa2111e876d > Error: type information missing or unknown +## Remarks + The .pch file did not get linked in, or the code has a reference to a type that is in a module not compiled with /Zi. This error is identical to CAN0067. From 3f46b4b6897cd93263382bc608b1a9e2a8d1e7b3 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 01:16:20 +0800 Subject: [PATCH 1135/1799] Update metadata for error references in range [CXX0035, CXX0072] --- .../tool-errors/expression-evaluator-error-cxx0036.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0037.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0038.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0039.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0040.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0041.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0043.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0044.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0045.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0046.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0047.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0048.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0049.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0050.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0051.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0052.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0053.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0054.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0055.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0056.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0057.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0058.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0059.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0060.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0061.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0062.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0063.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0064.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0065.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0066.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0067.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0069.md | 5 ++--- .../tool-errors/expression-evaluator-error-cxx0072.md | 5 ++--- 33 files changed, 66 insertions(+), 99 deletions(-) diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md index cf4ab72f2e0..d9f203ab553 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0036" title: "Expression Evaluator Error CXX0036" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0036" +ms.date: 11/04/2016 f1_keywords: ["CXX0036"] helpviewer_keywords: ["CXX0036", "CAN0036"] -ms.assetid: 383404be-df5b-4eec-b113-df21bb5d269d --- # Expression Evaluator Error CXX0036 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md index 02bb07d5f4d..f09a73432f8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0037" title: "Expression Evaluator Error CXX0037" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0037" +ms.date: 11/04/2016 f1_keywords: ["CXX0037"] helpviewer_keywords: ["CAN0037", "CXX0037"] -ms.assetid: 8059ad65-78b7-465a-98fa-387fd5873ea6 --- # Expression Evaluator Error CXX0037 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md index 823128b2f46..e1dfdca5443 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0038" title: "Expression Evaluator Error CXX0038" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0038" +ms.date: 11/04/2016 f1_keywords: ["CXX0038"] helpviewer_keywords: ["CXX0038", "CAN0038"] -ms.assetid: 3327dc4e-1726-4924-a519-6ffd766a389c --- # Expression Evaluator Error CXX0038 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md index 16f5c992f33..b6aeebdb00f 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0039" title: "Expression Evaluator Error CXX0039" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0039" +ms.date: 11/04/2016 f1_keywords: ["CXX0039"] helpviewer_keywords: ["CXX0039", "CAN0039"] -ms.assetid: 8bf698d2-e015-4595-944f-72b81aa43d22 --- # Expression Evaluator Error CXX0039 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md index 1d7d86afb9e..448fd76bc9e 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0040" title: "Expression Evaluator Error CXX0040" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0040" +ms.date: 11/04/2016 f1_keywords: ["CXX0040"] helpviewer_keywords: ["CXX0040", "CAN0040"] -ms.assetid: 1914e605-d80b-4abc-9e8f-dbcbefec095b --- # Expression Evaluator Error CXX0040 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md index 6d23ee2c700..37a50b38381 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0041" title: "Expression Evaluator Error CXX0041" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0041" +ms.date: 11/04/2016 f1_keywords: ["CXX0041"] helpviewer_keywords: ["CAN0041", "CXX0041"] -ms.assetid: ce8a2366-758f-481b-8c03-ed7d779091b2 --- # Expression Evaluator Error CXX0041 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md index c2cb481141d..97a455ab4d8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0043" title: "Expression Evaluator Error CXX0043" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0043" +ms.date: 11/04/2016 f1_keywords: ["CXX0043"] helpviewer_keywords: ["CXX0043", "CAN0043"] -ms.assetid: 5e5d55bb-0f3e-40e6-b3c3-d0dfb701a65c --- # Expression Evaluator Error CXX0043 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md index 7d3afba1dd8..ebb048927d8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0044" title: "Expression Evaluator Error CXX0044" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0044" +ms.date: 11/04/2016 f1_keywords: ["CXX0044"] helpviewer_keywords: ["CXX0044", "CAN0044"] -ms.assetid: d59868b5-c1ec-46ac-91d6-5d575a4d6b49 --- # Expression Evaluator Error CXX0044 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md index a4230c53897..1bf5578f642 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0045" title: "Expression Evaluator Error CXX0045" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0045" +ms.date: 11/04/2016 f1_keywords: ["CXX0045"] helpviewer_keywords: ["CXX0045", "CAN0045"] -ms.assetid: 32181bc8-e79c-4ad7-a82f-47c62ec06d7d --- # Expression Evaluator Error CXX0045 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md index 79f16aa7e61..e3d1398c1d7 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0046" title: "Expression Evaluator Error CXX0046" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0046" +ms.date: 11/04/2016 f1_keywords: ["CXX0046"] helpviewer_keywords: ["CXX0046", "CAN0046"] -ms.assetid: a76e657b-c018-415b-b426-ce9e72eb645d --- # Expression Evaluator Error CXX0046 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md index 8b9820d1fcf..ac89429f3cf 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0047" title: "Expression Evaluator Error CXX0047" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0047" +ms.date: 11/04/2016 f1_keywords: ["CXX0047"] helpviewer_keywords: ["CAN0047", "CXX0047"] -ms.assetid: db23d0db-fce2-4d86-b391-6e1d6ad13fd4 --- # Expression Evaluator Error CXX0047 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md index 5e740cc54ee..c081babcfb8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0048" title: "Expression Evaluator Error CXX0048" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0048" +ms.date: 11/04/2016 f1_keywords: ["CXX0048"] helpviewer_keywords: ["CAN0048", "CXX0048"] -ms.assetid: 294416f9-5e38-4450-8713-c13bcbaaf615 --- # Expression Evaluator Error CXX0048 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md index 353545e736f..a064fa348cd 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0049" title: "Expression Evaluator Error CXX0049" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0049" +ms.date: 11/04/2016 f1_keywords: ["CXX0049"] helpviewer_keywords: ["CXX0049", "CAN0049"] -ms.assetid: 6dcfece4-39ed-489d-b7be-2a17c7b94656 --- # Expression Evaluator Error CXX0049 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md index a04eb67bbeb..689436e2b00 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0050" title: "Expression Evaluator Error CXX0050" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0050" +ms.date: 11/04/2016 f1_keywords: ["CXX0050"] helpviewer_keywords: ["CAN0050", "CXX0050"] -ms.assetid: 214cd193-c6dc-41b9-9ebe-5a4b1689d3ab --- # Expression Evaluator Error CXX0050 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md index 4038a36aa14..fc6eec58a37 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0051" title: "Expression Evaluator Error CXX0051" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0051" +ms.date: 11/04/2016 f1_keywords: ["CXX0051"] helpviewer_keywords: ["CAN0051", "CXX0051"] -ms.assetid: 031cd2ed-d9bb-4aa5-9858-71581bcca49c --- # Expression Evaluator Error CXX0051 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md index 68560cbaf06..dc68472dc00 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0052" title: "Expression Evaluator Error CXX0052" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0052" +ms.date: 11/04/2016 f1_keywords: ["CXX0052"] helpviewer_keywords: ["CXX0052", "CAN0052"] -ms.assetid: 5060d479-d0a4-4682-b858-c8b9a4f324e6 --- # Expression Evaluator Error CXX0052 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md index 857f6f1d024..377bf54a6d7 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0053" title: "Expression Evaluator Error CXX0053" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0053" +ms.date: 11/04/2016 f1_keywords: ["CXX0053"] helpviewer_keywords: ["CAN0053", "CXX0053"] -ms.assetid: fe74ed9e-9241-4df1-881f-104348e296c6 --- # Expression Evaluator Error CXX0053 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md index d794c5b267f..d8c42073585 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0054" title: "Expression Evaluator Error CXX0054" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0054" +ms.date: 11/04/2016 f1_keywords: ["CXX0054"] helpviewer_keywords: ["CXX0054", "CAN0054"] -ms.assetid: d5d4a093-6a7a-45c0-8aa7-e555023353ef --- # Expression Evaluator Error CXX0054 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md index 20b6a9b4de6..c0539bf5118 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0055" title: "Expression Evaluator Error CXX0055" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0055" +ms.date: 11/04/2016 f1_keywords: ["CXX0055"] helpviewer_keywords: ["CAN0055", "CXX0055"] -ms.assetid: bb2a81f9-35ea-4b02-a49e-6b2c7023aebd --- # Expression Evaluator Error CXX0055 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md index 853d62a5cd8..2c5f48a2a20 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0056" title: "Expression Evaluator Error CXX0056" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0056" +ms.date: 11/04/2016 f1_keywords: ["CXX0056"] helpviewer_keywords: ["CXX0056", "CAN0056"] -ms.assetid: a67c90e0-933c-43f2-a548-0ba272920331 --- # Expression Evaluator Error CXX0056 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md index 9b63f8643e9..5b31455260d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0057" title: "Expression Evaluator Error CXX0057" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0057" +ms.date: 11/04/2016 f1_keywords: ["CXX0057"] helpviewer_keywords: ["CAN0057", "CXX0057"] -ms.assetid: b1a86998-c642-4061-9f37-9c493f3852cc --- # Expression Evaluator Error CXX0057 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md index 53866dbe0dd..e96576696fb 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0058" title: "Expression Evaluator Error CXX0058" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0058" +ms.date: 11/04/2016 f1_keywords: ["CXX0058"] helpviewer_keywords: ["CXX0058", "CAN0058"] -ms.assetid: b6246c6e-5845-4ad5-ac2a-e6c4faf8f3f9 --- # Expression Evaluator Error CXX0058 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md index 53da2c611aa..67c0a953c68 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0059" title: "Expression Evaluator Error CXX0059" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0059" +ms.date: 11/04/2016 f1_keywords: ["CXX0059"] helpviewer_keywords: ["CXX0059", "CAN0059"] -ms.assetid: e8bdcb74-1315-4083-b24d-e47eac7d1ec0 --- # Expression Evaluator Error CXX0059 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md index 00c18c9ef18..e3daf580ae6 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0060" title: "Expression Evaluator Error CXX0060" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0060" +ms.date: 11/04/2016 f1_keywords: ["CXX0060"] helpviewer_keywords: ["CAN0060", "CXX0060"] -ms.assetid: 40c0ff02-ca6b-4232-b1e3-1f3a213ee2a3 --- # Expression Evaluator Error CXX0060 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md index da09df79e34..35275227563 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0061" title: "Expression Evaluator Error CXX0061" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0061" +ms.date: 11/04/2016 f1_keywords: ["CXX0061"] helpviewer_keywords: ["CXX0061", "CAN0061"] -ms.assetid: fa84dcca-87ef-4546-9dce-636ed39e0713 --- # Expression Evaluator Error CXX0061 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md index a91c8cab401..3265d6746bc 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0062" title: "Expression Evaluator Error CXX0062" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0062" +ms.date: 11/04/2016 f1_keywords: ["CXX0062"] helpviewer_keywords: ["CAN0062", "CGopherFile class, operations"] -ms.assetid: 8e4165c4-7753-4f45-90e9-4542cbb9fc7a --- # Expression Evaluator Error CXX0062 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md index b931d856259..4e753d841e6 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0063" title: "Expression Evaluator Error CXX0063" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0063" +ms.date: 11/04/2016 f1_keywords: ["CXX0063"] helpviewer_keywords: ["CXX0063", "CAN0063"] -ms.assetid: 2e131b7a-9c8f-4aa1-acac-8d87f602c24c --- # Expression Evaluator Error CXX0063 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md index 321f7d3cf7a..ceebc4c6727 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0064" title: "Expression Evaluator Error CXX0064" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0064" +ms.date: 11/04/2016 f1_keywords: ["CXX0064"] helpviewer_keywords: ["CAN0064", "CXX0064"] -ms.assetid: aa509e71-0616-41ca-a94e-6c376b041e57 --- # Expression Evaluator Error CXX0064 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md index 43bb69b19e7..494f6ff1bfc 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0065" title: "Expression Evaluator Error CXX0065" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0065" +ms.date: 11/04/2016 f1_keywords: ["CXX0065"] helpviewer_keywords: ["CAN0065", "CXX0065"] -ms.assetid: aac68f87-0b90-4c19-afa6-1c587625a5fd --- # Expression Evaluator Error CXX0065 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md index 3fc027592b8..e31743fe4a9 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0066" title: "Expression Evaluator Error CXX0066" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0066" +ms.date: 11/04/2016 f1_keywords: ["CXX0066"] helpviewer_keywords: ["CXX0066", "CAN0066"] -ms.assetid: 1321e4e1-b441-424b-9e76-c208d4a6f6ea --- # Expression Evaluator Error CXX0066 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md index d95be75387a..27d75853cce 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0067" title: "Expression Evaluator Error CXX0067" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0067" +ms.date: 11/04/2016 f1_keywords: ["CXX0067"] helpviewer_keywords: ["CXX0067", "CAN0067"] -ms.assetid: 9a3e642b-4746-41ac-b665-bd98a6fa0cb3 --- # Expression Evaluator Error CXX0067 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md index d1c67ddc974..0fefde08dbf 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0069" title: "Expression Evaluator Error CXX0069" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0069" +ms.date: 11/04/2016 f1_keywords: ["CXX0069"] helpviewer_keywords: ["CXX0069"] -ms.assetid: cf334b23-1e17-4d37-acc5-18597ee84164 --- # Expression Evaluator Error CXX0069 diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md index 61166349bac..e7abb58a2dd 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0072" title: "Expression Evaluator Error CXX0072" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0072" +ms.date: 11/04/2016 f1_keywords: ["CXX0072"] helpviewer_keywords: ["CAN0072", "CXX0072"] -ms.assetid: fd04e197-cfa9-4097-a070-8fa2111e876d --- # Expression Evaluator Error CXX0072 From ff361a7530163011f26f966f3fbc0d3e60521633 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 8 Sep 2025 10:50:38 -0700 Subject: [PATCH 1136/1799] Update docs/error-messages/compiler-errors-1/compiler-error-c2390.md Co-authored-by: Courtney Wales <62625502+Court72@users.noreply.github.com> --- docs/error-messages/compiler-errors-1/compiler-error-c2390.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md index 8754be37546..8cb77912ec8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md @@ -23,7 +23,7 @@ Possible resolutions: ## Example -- The following example generates C2390: +The following example generates C2390: ```cpp // C2390.cpp From 06eab07b8f7950b89b70287bda9cd24bec482c77 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 8 Sep 2025 14:29:21 -0700 Subject: [PATCH 1137/1799] Add print_legend and print_stats to table --- docs/sanitizers/asan-flags.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 1431a0094b5..0fdee43acae 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -45,6 +45,8 @@ The following table lists the options for the AddressSanitizer. Enable them via |`poison_heap` | `true` | If `true`, poison the heap memory on allocation and deallocation. `false` is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print the command line on crash. With `continue_on_error` set >= 1, prints the current working directory and is `UTF-16` aware.| +|`print_legend` | `true` | If `true`, print the shadow memory map legend. | +|`print_stats`| `true` | If `true`, print allocator stats on exit. | |`print_summary` | `true` | If `false`, disables showing error summaries that accompany error reports.| |`quarantine_size_mb` | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| |`redzone` | 16 | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.| From d68366d0fed0880091d78c14f2801f74dd9b9d33 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 8 Sep 2025 14:41:12 -0700 Subject: [PATCH 1138/1799] Enter more specific description for print_stats --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 0fdee43acae..beea79ff296 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -46,7 +46,7 @@ The following table lists the options for the AddressSanitizer. Enable them via |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print the command line on crash. With `continue_on_error` set >= 1, prints the current working directory and is `UTF-16` aware.| |`print_legend` | `true` | If `true`, print the shadow memory map legend. | -|`print_stats`| `true` | If `true`, print allocator stats on exit. | +|`print_stats`| `false` | If `true`, print allocator stats after printing ASan report. | |`print_summary` | `true` | If `false`, disables showing error summaries that accompany error reports.| |`quarantine_size_mb` | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| |`redzone` | 16 | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.| From 9050e03cd7dae1d6723d6afc3a9fb6be7a0ab01d Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 8 Sep 2025 14:47:45 -0700 Subject: [PATCH 1139/1799] State that the legend will only get printed when the ASan report gets printed --- docs/sanitizers/asan-flags.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index beea79ff296..63633fa5e46 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -45,7 +45,7 @@ The following table lists the options for the AddressSanitizer. Enable them via |`poison_heap` | `true` | If `true`, poison the heap memory on allocation and deallocation. `false` is useful for benchmarking the allocator or instrumentator.| |`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| |`print_cmdline` | `false` | Print the command line on crash. With `continue_on_error` set >= 1, prints the current working directory and is `UTF-16` aware.| -|`print_legend` | `true` | If `true`, print the shadow memory map legend. | +|`print_legend` | `true` | If `true`, print the shadow memory map legend to accompany the ASan report. | |`print_stats`| `false` | If `true`, print allocator stats after printing ASan report. | |`print_summary` | `true` | If `false`, disables showing error summaries that accompany error reports.| |`quarantine_size_mb` | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| From 0768c37c2a782b4f5e25222eb681265abdfd5817 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 8 Sep 2025 17:18:17 -0700 Subject: [PATCH 1140/1799] add alt-text --- docs/cpp/cpp-type-system-modern-cpp.md | 3 +-- ...he-windows-10-sdk-in-a-windows-desktop-application.md | 9 ++++----- docs/windows/windows-desktop-wizard.md | 2 ++ 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/cpp/cpp-type-system-modern-cpp.md b/docs/cpp/cpp-type-system-modern-cpp.md index a6245411472..67772c31a07 100644 --- a/docs/cpp/cpp-type-system-modern-cpp.md +++ b/docs/cpp/cpp-type-system-modern-cpp.md @@ -3,7 +3,6 @@ description: "Learn more about: C++ type system" title: "C++ type system" ms.date: 11/04/2022 ms.topic: "concept-article" -ms.assetid: 553c0ed6-77c4-43e9-87b1-c903eec53e80 --- # C++ type system @@ -56,7 +55,7 @@ The compiler recognizes these built-in types, and it has built-in rules that gov The following illustration shows the relative sizes of the built-in types in the Microsoft C++ implementation: -![Diagram of the relative size in bytes of several built in types.](../cpp/media/built-intypesizes.png) +:::image type="content" source="../cpp/media/built-intypesizes.png" alt-text="Diagram showing the relative sizes in bytes of C++ built-in types: bool and char (1 byte), short (2 bytes), int, long, and float (4 bytes), double and long long (8 bytes)"::: The following table lists the most frequently used fundamental types, and their sizes in the Microsoft C++ implementation: diff --git a/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md b/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md index 80c51d392a9..8998b1d37b4 100644 --- a/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md +++ b/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md @@ -3,7 +3,6 @@ title: "How to: Use the Windows SDK in a Windows Desktop application" description: "How to set the target SDK version in a Windows Desktop application project to use the latest Windows SDK." ms.custom: "get-started-article" ms.date: "01/22/2020" -ms.assetid: eed6421e-9355-44a6-9582-3f1d453a6d44 --- # How to: Use the Windows SDK in a Windows Desktop application @@ -25,7 +24,7 @@ To retarget your projects to use the latest Windows SDK when you upgrade from a 1. Open the shortcut menu for the project node, and choose **Retarget projects**. (In earlier versions of Visual Studio, choose **Retarget SDK Version**.) The **Review Solution Actions** dialog appears. - ![Review Solution Actions.](../windows/media/retargetingwindowssdk2.PNG "RetargetingWindowsSDK2") + :::image type="content" source="../windows/media/retargetingwindowssdk2.PNG" alt-text="Screenshot of the Review Solution Actions dialog. Target Platform Versions is set to 10.0.10156.0"::: 1. In the **Target Platform Version** dropdown list, choose the version of the Windows SDK you want to target. Generally speaking, we recommend you choose the latest installed version. Choose the **OK** button to apply the change. @@ -37,15 +36,15 @@ To retarget your projects to use the latest Windows SDK when you upgrade from a 1. Open the project properties dialog. In the **Configuration Properties** > **General** section, notice the values of **Windows Target Platform Version**. Changing the value here has the same effect as following this procedure. For more information, see [General Property Page (Project)](../build/reference/general-property-page-project.md). - ![Target Platform property in the Property Pages dialog.](../windows/media/retargetingwindowssdk3.PNG "RetargetingWindowsSDK3") + :::image type="content" source="../windows/media/retargetingwindowssdk3.PNG" alt-text="Screenshot of the Property Pages dialog. Target Platform Version is set to 8.1." lightbox="../windows/media/retargetingwindowssdk3.PNG"::: This action changes the values of project macros that include paths to header files and library files. To see what changed, open the **Visual C++ Directories** section of the **Project Properties** dialog. Select one of the properties, such as **Include Directories**. Then, open the property value's dropdown list, and choose **\**. The **Include Directories** dialog appears. - ![Include Directories dialog box.](../windows/media/retargetingwindowssdk4.PNG "RetargetingWindowsSDK4") + :::image type="content" source="../windows/media/retargetingwindowssdk4.PNG" alt-text="Screenshot of the Include Directories dialog showing paths to Windows SDK includes such as C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/Include." lightbox="../windows/media/retargetingwindowssdk4.PNG"::: Choose the **Macros >>** button, and scroll down the list of macros to the Windows SDK macros to see all the new values. - ![List of Windows SDK Macros.](../windows/media/retargetingwindowssdk5.PNG "RetargetingWindowsSDK5") + :::image type="content" source="../windows/media/retargetingwindowssdk5.PNG" alt-text="Screenshot of the macros dialog showing Windows SDK-related macros and their values. For example, $(windir) is c:/Windows." lightbox="../windows/media/retargetingwindowssdk5.PNG"::: 1. Repeat the retargeting procedure for other solution projects, as needed, and rebuild the solution. diff --git a/docs/windows/windows-desktop-wizard.md b/docs/windows/windows-desktop-wizard.md index f16945a7412..6b57672f3df 100644 --- a/docs/windows/windows-desktop-wizard.md +++ b/docs/windows/windows-desktop-wizard.md @@ -12,6 +12,8 @@ The Windows Desktop Wizard replaces the Win32 Application Wizard in Visual Studi ![Screenshot of the Windows Desktop Project wizard.](media/windows-desktop-wizard.png) +:::image type="content" source="media/windows-desktop-wizard.png" alt-text="Screenshot of the Windows Desktop Project wizard. Application type is set to Console Application (.exe) Precompiled Header and Security Development Lifecycle (SDL) checks are selected."::: + The following table indicates which options are available for each application type. |Type of support|Console application|Executable (Windows) application|Dynamic-link library|Static library| From d6366d7483ac2a7fbceb83ac45bde7ac9d77b1fa Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 8 Sep 2025 18:38:56 -0700 Subject: [PATCH 1141/1799] deprecation notes for 2026 (#6077) * deprecation notes for 2026 * edits * acrolinx * edits --- docs/build/overview-of-arm-abi-conventions.md | 14 ++++++++------ .../reference/await-enable-coroutine-support.md | 10 ++++++---- docs/build/reference/debug-generate-debug-info.md | 10 +++++----- docs/build/reference/midl-property-pages.md | 4 +++- 4 files changed, 22 insertions(+), 16 deletions(-) diff --git a/docs/build/overview-of-arm-abi-conventions.md b/docs/build/overview-of-arm-abi-conventions.md index 3e61981e84e..5ab221541eb 100644 --- a/docs/build/overview-of-arm-abi-conventions.md +++ b/docs/build/overview-of-arm-abi-conventions.md @@ -2,12 +2,14 @@ description: "Learn more about: Overview of ARM32 ABI Conventions" title: "Overview of ARM ABI Conventions" ms.date: "07/11/2018" -ms.assetid: 23f4ae8c-3148-4657-8c47-e933a9f387de --- # Overview of ARM32 ABI Conventions The application binary interface (ABI) for code compiled for Windows on ARM processors is based on the standard ARM EABI. This article highlights key differences between Windows on ARM and the standard. This document covers the ARM32 ABI. For information about the ARM64 ABI, see [Overview of ARM64 ABI conventions](arm64-windows-abi-conventions.md). For more information about the standard ARM EABI, see [Application Binary Interface (ABI) for the ARM Architecture](https://github.com/ARM-software/abi-aa) (external link). +> [!NOTE] +> Using the Microsoft Visual C++ (MSVC) build tools to target ARM32 is deprecated starting with Visual Studio 2026. If you need to target ARM32, use the Visual Studio 2022 v143 build tools. + ## Base Requirements Windows on ARM always presumes that it's running on an ARMv7 architecture. Floating-point support in the form of VFPv3-D32 or later must be present in hardware. The VFP must support both single-precision and double-precision floating-point in hardware. The Windows runtime doesn't support emulation of floating-point to enable running on non-VFP hardware. @@ -124,7 +126,7 @@ Initialization is performed exactly once, before argument processing begins: For each argument in the list, the first matching rule from the following list is applied: -1. If the argument is a composite type whose size cannot be statically determined by both the caller and the callee, the argument is copied to memory and replaced by a pointer to the copy. +1. If the argument is a composite type whose size can't be statically determined by both the caller and the callee, the argument is copied to memory and replaced by a pointer to the copy. 1. If the argument is a byte or 16-bit half-word, then it is zero-extended or sign-extended to a 32-bit full word and treated as a 4-byte argument. @@ -136,11 +138,11 @@ For each argument in the list, the following rules are applied in turn until the 1. If the argument is a VFP type and there are enough consecutive unallocated VFP registers of the appropriate type, then the argument is allocated to the lowest-numbered sequence of such registers. -1. If the argument is a VFP type, all remaining unallocated registers are marked as unavailable. The NSAA is adjusted upwards until it is correctly aligned for the argument type and the argument is copied to the stack at the adjusted NSAA. The NSAA is then incremented by the size of the argument. +1. If the argument is a VFP type, all remaining unallocated registers are marked as unavailable. The NSAA is adjusted upwards until it's correctly aligned for the argument type and the argument is copied to the stack at the adjusted NSAA. The NSAA is then incremented by the size of the argument. 1. If the argument requires 8-byte alignment, the NCRN is rounded up to the next even register number. -1. If the size of the argument in 32-bit words is not more than r4 minus NCRN, the argument is copied into core registers, starting at the NCRN, with the least significant bits occupying the lower-numbered registers. The NCRN is incremented by the number of registers used. +1. If the size of the argument in 32-bit words isn't more than r4 minus NCRN, the argument is copied into core registers, starting at the NCRN, with the least significant bits occupying the lower-numbered registers. The NCRN is incremented by the number of registers used. 1. If the NCRN is less than r4 and the NSAA is equal to the SP, the argument is split between core registers and the stack. The first part of the argument is copied into the core registers, starting at the NCRN, up to and including r3. The rest of the argument is copied onto the stack, starting at the NSAA. The NCRN is set to r4 and the NSAA is incremented by the size of the argument minus the amount passed in registers. @@ -148,7 +150,7 @@ For each argument in the list, the following rules are applied in turn until the 1. The argument is copied into memory at the NSAA. The NSAA is incremented by the size of the argument. -The VFP registers aren't used for variadic functions, and Stage C rules 1 and 2 are ignored. It means that a variadic function can begin with an optional push {r0-r3} to prepend the register arguments to any additional arguments passed by the caller, and then access the entire argument list directly from the stack. +The VFP registers aren't used for variadic functions, and Stage C rules 1 and 2 are ignored. It means that a variadic function can begin with an optional push {r0-r3} to prepend the register arguments to any other arguments passed by the caller, and then access the entire argument list directly from the stack. Integer type values are returned in r0, optionally extended to r1 for 64-bit return values. VFP/NEON floating-point or SIMD type values are returned in s0, d0, or q0, as appropriate. @@ -158,7 +160,7 @@ The stack must always remain 4-byte aligned, and must be 8-byte aligned at any f Functions that have to use a frame pointer—for example, functions that call `alloca` or that change the stack pointer dynamically—must set up the frame pointer in r11 in the function prologue and leave it unchanged until the epilogue. Functions that don't require a frame pointer must perform all stack updates in the prologue and leave the stack pointer unchanged until the epilogue. -Functions that allocate 4 KB or more on the stack must ensure that each page prior to the final page is touched in order. This order ensures that no code can "leap over" the guard pages that Windows uses to expand the stack. Typically, the expansion is done by the `__chkstk` helper, which is passed the total stack allocation in bytes divided by 4 in r4, and which returns the final stack allocation amount in bytes back in r4. +Functions that allocate 4 KB or more on the stack must ensure that each page before the final page is touched in order. This order ensures that no code can "leap over" the guard pages that Windows uses to expand the stack. Typically, the expansion is done by the `__chkstk` helper, which is passed the total stack allocation in bytes divided by 4 in r4, and which returns the final stack allocation amount in bytes back in r4. ### Red zone diff --git a/docs/build/reference/await-enable-coroutine-support.md b/docs/build/reference/await-enable-coroutine-support.md index 9595a434ffc..6ce254876f8 100644 --- a/docs/build/reference/await-enable-coroutine-support.md +++ b/docs/build/reference/await-enable-coroutine-support.md @@ -1,15 +1,17 @@ --- description: "Learn more about: /await (Enable coroutine support)" title: "/await (Enable coroutine support)" -ms.date: "08/15/2017" +ms.date: 09/08/2025 f1_keywords: ["/await", "-await"] helpviewer_keywords: ["/await enable coroutine support [C++]", "-await enable coroutine support [C++]", "await enable coroutine support [C++]"] -ms.assetid: 302c8e69-09b6-4c58-bcdd-0a6a8713a8df --- -# `/await` (Enable coroutine support) +# `/await` (Enable coroutine support) Deprecated. Use the **`/await`** compiler option to enable compiler support for coroutines. +> [!NOTE] +> The **`/await`** option is deprecated starting with Visual Studio 2026 and will be removed in a future release. Standard C++ coroutines are available by default in C++20 or later. Or use **`/await:strict`** option when using earlier versions of the C++ language. + ## Syntax > **`/await`**\ @@ -19,7 +21,7 @@ Use the **`/await`** compiler option to enable compiler support for coroutines. The **`/await`** compiler option enables compiler support for C++ coroutines and the keywords **`co_await`**, **`co_yield`**, and **`co_return`**. This option is off by default. For information about support for coroutines in Visual Studio, see the [Visual Studio Team Blog](https://devblogs.microsoft.com/cppblog/category/coroutine/). For more information about the coroutines standard proposal, see [N4628 Working Draft, Technical Specification for C++ Extensions for Coroutines](https://wg21.link/n4628). -The **`/await`** option is available beginning in Visual Studio 2015. +The **`/await`** option is available beginning in Visual Studio 2015 and is deprecated starting with Visual Studio 2026. Starting in Visual Studio 2019 version 16.10, the **`/await:strict`** option can be used in place of **`/await`**. The option provides C++20-compatible coroutine support in projects that build in C++14 or C++17 mode. In **`/await:strict`** mode, library support is provided in \ and in the `std` namespace. diff --git a/docs/build/reference/debug-generate-debug-info.md b/docs/build/reference/debug-generate-debug-info.md index 85a515debab..9716f477b56 100644 --- a/docs/build/reference/debug-generate-debug-info.md +++ b/docs/build/reference/debug-generate-debug-info.md @@ -1,7 +1,7 @@ --- description: "Learn more about: /DEBUG (Generate debug info)" title: "/DEBUG (Generate Debug Info)" -ms.date: 10/26/2023 +ms.date: 09/08/2025 f1_keywords: ["VC.Project.VCLinkerTool.GenerateDebugInformation", "/debug"] helpviewer_keywords: ["DEBUG linker option", "/DEBUG linker option", "-DEBUG linker option", "PDB files", "debugging [C++], debug information files", "generate debug info linker option", "pdb files, generating debug info", ".pdb files, generating debug info", "debugging [C++], linker option", "program databases [C++]"] ms.assetid: 1af389ae-3f8b-4d76-a087-1cdf861e9103 @@ -20,7 +20,10 @@ The **`/DEBUG`** option puts the debugging information from linked object and li An executable (an EXE or DLL file) created for debugging contains the name and path of the corresponding PDB. The debugger reads the embedded name and uses the PDB when you debug the program. The linker uses the base name of the program and the extension *`.pdb`* to name the program database, and embeds the path where it was created. To override this default, set the [`/PDB`](pdb-use-program-database.md) option and specify a different file name. -The **`/DEBUG:FASTLINK`** option is available in Visual Studio 2017 and later. This option generates a limited PDB that indexes into the debug information in the object files and libraries used to build the executable instead of making a full copy. You can only use this limited PDB to debug from the computer where the binary and its libraries were built. If you deploy the binary elsewhere, you may debug it remotely from the build computer, but not directly on the test computer. Since Visual Studio 2019, **`/DEBUG:FULL`** linking times have improved significantly, and **`/DEBUG:FASTLINK`** isn't always faster than **`/DEBUG:FULL`**. Since **`/DEBUG:FASTLINK`** no longer provides large build time improvements and results in a slower debugging experience versus **`/DEBUG:FULL`**, this option is no longer recommended. +> [!Note] +> The **`/DEBUG:FASTLINK`** option is **deprecated and removed** starting in Visual Studio 2026. It was available in Visual Studio 2017 through Visual Studio 2022. + +**`/DEBUG:FASTLINK`** generated a limited PDB that indexes into the debug information in the object files and libraries used to build the executable instead of making a full copy. You can only use this limited PDB to debug from the computer where the binary and its libraries were built. If you deploy the binary elsewhere, you may debug it remotely from the build computer, but not directly on the test computer. Since Visual Studio 2019, **`/DEBUG:FULL`** linking times have improved significantly, and **`/DEBUG:FASTLINK`** isn't always faster than **`/DEBUG:FULL`**. Since **`/DEBUG:FASTLINK`** no longer provides large build time improvements and results in a slower debugging experience versus **`/DEBUG:FULL`**, this option is no longer recommended, and is removed in Visual Studio 2026. Prefer using **`/DEBUG:FULL`**. A **`/DEBUG:FASTLINK`** PDB can be converted to a full PDB that you can deploy to a test machine for local debugging. In Visual Studio, use the **Property Pages** dialog as described below to create a full PDB for the project or solution. In a developer command prompt, you can use the `mspdbcmf.exe` tool to create a full PDB. @@ -41,11 +44,8 @@ It isn't possible to create an EXE or DLL that contains debug information. Debug ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Linker** > **Debugging** property page. - 1. Modify the **Generate Debug Info** property to enable or disable PDB generation. This property enables **`/DEBUG:FASTLINK`** by default in Visual Studio 2017 and later. - 1. Modify the **Generate Full Program Database File** property to enable **`/DEBUG:FULL`** for full PDB generation for every incremental build. ### To set this linker option programmatically diff --git a/docs/build/reference/midl-property-pages.md b/docs/build/reference/midl-property-pages.md index 66c3955c39a..8d68b2e9f03 100644 --- a/docs/build/reference/midl-property-pages.md +++ b/docs/build/reference/midl-property-pages.md @@ -3,7 +3,6 @@ description: "Learn more about: MIDL Property Pages" title: "MIDL Compiler Property Pages" ms.date: "07/24/2019" ms.topic: "article" -ms.assetid: 57498a01-fccc-4a0e-a036-6ff702f83126 f1_keywords: - VC.Project.VCMidlTool.PreprocessorDefinitions - VC.Project.VCMidlTool.AdditionalIncludeDirectories @@ -112,6 +111,9 @@ Specifies the default character type of the C compiler that will be used to comp Specifies which environment to target ([/env](/windows/win32/midl/-env) arm32|win32|ia64|x64). +> [!NOTE] +> Starting with Visual Studio 2026, the **`/env:arm32`** option is deprecated and removed. If you need to target ARM32, use the Visual Studio 2022 v143 build tools. + **Choices** - **Not Set** - Win32 From bc6285ca61cc63a904ad5e3c6845f20d8c295e40 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 8 Sep 2025 18:45:32 -0700 Subject: [PATCH 1142/1799] fix alt+text and old image format --- docs/build/clang-support-cmake.md | 14 +++++++------- ...ual-cpp-application-by-using-a-setup-project.md | 11 +++++------ 2 files changed, 12 insertions(+), 13 deletions(-) diff --git a/docs/build/clang-support-cmake.md b/docs/build/clang-support-cmake.md index 157c3259d95..8a2eadec580 100644 --- a/docs/build/clang-support-cmake.md +++ b/docs/build/clang-support-cmake.md @@ -26,14 +26,14 @@ You can use Visual Studio with Clang to edit and debug C++ CMake projects that t For the best IDE support in Visual Studio, we recommend using the latest Clang compiler tools for Windows. If you don't already have those, you can install them by opening the Visual Studio Installer and choosing **C++ Clang compiler for Windows** under **Desktop development with C++** optional components. You may prefer to use an existing Clang installation on your machine; if so, choose the **C++ Clang-cl for v142 build tools** or **C++ Clang-cl for v143 build tools** component. -![Screenshot of the Visual Studio Installer Individual Components page that shows Clang components available for installation.](media/clang-install-vs2019.png) +:::image type="content" source="media/clang-install-vs2019.png" alt-text="Screenshot of the Visual Studio Installer Individual Components page. C++ Clang Compiler For Windows and C++ Clang-cl for v142 build tools are selected."::: ::: moniker-end ::: moniker range="msvc-170" For the best IDE support in Visual Studio, we recommend using the latest Clang compiler tools for Windows. If you don't already have those, you can install them by opening the Visual Studio Installer and choosing **C++ Clang compiler for Windows** under **Desktop development with C++** optional components. You may prefer to use an existing Clang installation on your machine; if so, choose the **MSBuild support for LLVM (clang-cl) toolset** component. -![Screenshot of the Visual Studio Installer Individual Components page that shows Clang components available for installation.](media/clang-install-vs2022.png) +:::image type="content" source="media/clang-install-vs2022.png" alt-text="Screenshot of the Visual Studio Installer Individual Components page. C++ Clang Compiler For Windows and MSBuild support for LLVM are selected."::: ::: moniker-end ::: moniker range=">=msvc-160" @@ -47,11 +47,11 @@ To add a new Clang configuration to a CMake project: 1. Under **Configurations**, press the **Add Configuration** button: - ![Screenshot of the controls at the top of the C Make Settings dialog, with the Add Configuration control highlighted.](media/cmake-add-config-icon.png) + :::image type="content" source="media/cmake-add-config-icon.png" alt-text="Screenshot of the controls at the top of the C Make Settings dialog, with the Add Configuration button highlighted."::: 1. Choose the desired Clang configuration (note that separate Clang configurations are provided for Windows and Linux), then press **Select**: - ![Screenshot of the Add Configuration to C Make Settings dialog for Clang configuration.](media/cmake-clang-configuration.png) + :::image type="content" source="media/cmake-clang-configuration.png" alt-text="Screenshot of the Add Configuration to C Make Settings dialog for Clang configuration. Contains entries such as Mingw64-Release, x86-Debug/Release, x64-Debug/Release, x86-Clang Debug/Release."::: 1. To make modifications to this configuration, use the **CMake Settings Editor**. For more information, see [Customize CMake build settings in Visual Studio](customize-cmake-settings.md). @@ -63,7 +63,7 @@ To modify an existing configuration to use Clang, follow these steps: 1. Under **General** select the **Toolset** dropdown and choose the desired Clang toolset: - ![Screenshot of the General dialog box showing that the Toolset is selected and clang cl x 86 is highlighted.](media/cmake-clang-toolset.png) + ![Screenshot of the General dialog box showing the Toolset drop-down and clang cl x 86 is highlighted.](media/cmake-clang-toolset.png) ## Custom Clang locations @@ -74,7 +74,7 @@ By default, Visual Studio looks for Clang in two places: You can specify another location by setting the **CMAKE_C_COMPILER** and **CMAKE_CXX_COMPILER** CMake variables in **CMake Settings**: -![Screenshot of the C Make Settings dialog box with the C Make C X X Compiler highlighted.](media/clang-location-cmake.png) +:::image type="content" source="media/clang-location-cmake.png" alt-text="Screenshot of the C Make Settings dialog box with the C Make C X X Compiler highlighted. C Make configurations are listed such as x64-Clang-Debug, Linx-Clang-Release, and so on." Lightbox="media/clang-location-cmake.png"::: ## Clang compatibility modes @@ -88,6 +88,6 @@ After you have set up a Clang configuration, you can build and debug the project When debugging, you can use breakpoints, memory and data visualization, and most other debugging features. Some compiler-dependent features such as Edit and Continue aren't available for Clang configurations. -![Screenshot of the Visual Studio debugger debugging a CMake Clang project.](media/clang-debug-visualize.png) +:::image type="content" source="media/clang-debug-visualize.png" alt-text="Screenshot of the Visual Studio debugger debugging a CMake Clang project. The Autos window is visible, showing variables and their values."::: ::: moniker-end diff --git a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md index 5878dda4372..99e286e2a67 100644 --- a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md +++ b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md @@ -3,7 +3,6 @@ description: "Learn more about: Walkthrough: Deploy a Visual C++ application by title: "Deploy a Visual C++ application by using a setup project" ms.date: 06/28/2022 helpviewer_keywords: ["deployment for Visual C++"] -ms.assetid: 66735cda-8fe3-4211-a19a-2cf717a12a3f ms.custom: intro-deployment ms.topic: install-set-up-deploy --- @@ -45,7 +44,7 @@ If you have Visual Studio installed, but you don't have the C++ or MFC component 1. In the Manage Extensions dialog, expand **Online** > **Visual Studio Marketplace** > **Tools** and select **Setup & Deployment**. - ![The Manage Extensions dialog showing the Visual Studio setup project extension.](media/vs2019-extension-dialog-installer-project.png "Name the client project") + :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected."::: 1. In the list of extensions, select **Microsoft Visual Studio Installer Projects 2022**. Choose the **Download** button. @@ -85,7 +84,7 @@ If you have Visual Studio installed, but you don't have the C++ or MFC component 1. In the Manage Extensions dialog, expand **Online** > **Visual Studio Marketplace** > **Tools** and select **Setup & Deployment**. - ![The Manage Extensions dialog showing the Visual Studio setup project extension.](media/vs2019-extension-dialog-installer-project.png "Name the client project") + :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected."::: 1. In the list of extensions, select **Microsoft Visual Studio Installer Projects**. Choose the **Download** button. @@ -125,7 +124,7 @@ If you have Visual Studio 2017 installed, but you don't have the C++ or MFC comp 1. In the Extensions and Updates dialog, expand **Online** > **Visual Studio Marketplace** > **Tools** and select **Setup & Deployment**. Set the **Sort by** dropdown to **Most Downloads**. - ![The Manage Extensions dialog showing the Visual Studio setup project extension.](media/vs2019-extension-dialog-installer-project.png "Name the client project") + :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected."::: 1. In the list of extensions, select **Microsoft Visual Studio Installer Projects**. Choose the **Download** button. @@ -183,7 +182,7 @@ To create a deployable application setup, first you'll create a sample app to de 1. Launch Visual Studio. By default, it opens the **Create a New Project** dialog box. If Visual Studio is already open, on the menu bar, choose **File** > **New** > **Project** to open the **Create a New Project** dialog box. - ![Screenshot of the Create a new project dialog showing an MFC App project template.](media/vs2019-mfc-app-new-project.png "New MFC app") + :::image type="content" source="media/vs2019-mfc-app-new-project.png" alt-text="Screenshot of the Create a new project dialog in Visual Studio with MFC entered in the search box and the MFC App project template selected." lightbox="media/vs2019-mfc-app-new-project.png"::: 1. At the top of the dialog, type `MFC` in the search box and then choose **MFC App** from the results list. (If the MFC App template is missing, see [To install C++ and MFC in Visual Studio 2022](#install-mfc-2022).) Choose the **Next** button to continue. @@ -203,7 +202,7 @@ To create a deployable application setup, first you'll create a sample app to de 1. On the menu bar, choose **File** > **New** > **Project** to open the **Create a New Project** dialog box. - ![Screenshot of the Create a new project dialog showing an MFC App project template.](media/vs2019-mfc-app-new-project.png "New MFC app") + :::image type="content" source="media/vs2019-mfc-app-new-project.png" alt-text="Screenshot of the Create a new project dialog in Visual Studio with MFC entered in the search box and the MFC App project template selected." lightbox="media/vs2019-mfc-app-new-project.png"::: 1. At the top of the dialog, type `MFC` in the search box and then choose **MFC App** from the results list. (If the MFC App template is missing, see [To install C++ and MFC in Visual Studio 2019](#install-mfc-2019).) Choose the **Next** button to continue. From 88ef5185fbd0484e199da761db26935b2f9b100e Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 8 Sep 2025 19:05:48 -0700 Subject: [PATCH 1143/1799] fixes --- docs/build/clang-support-cmake.md | 5 ++--- ...the-windows-10-sdk-in-a-windows-desktop-application.md | 8 ++++---- 2 files changed, 6 insertions(+), 7 deletions(-) diff --git a/docs/build/clang-support-cmake.md b/docs/build/clang-support-cmake.md index 8a2eadec580..f0b27f2a3d7 100644 --- a/docs/build/clang-support-cmake.md +++ b/docs/build/clang-support-cmake.md @@ -38,7 +38,6 @@ For the best IDE support in Visual Studio, we recommend using the latest Clang c ::: moniker-end ::: moniker range=">=msvc-160" - ## Create a new configuration To add a new Clang configuration to a CMake project: @@ -47,11 +46,11 @@ To add a new Clang configuration to a CMake project: 1. Under **Configurations**, press the **Add Configuration** button: - :::image type="content" source="media/cmake-add-config-icon.png" alt-text="Screenshot of the controls at the top of the C Make Settings dialog, with the Add Configuration button highlighted."::: + :::image type="content" source="media/cmake-add-config-icon.png" alt-text="Screenshot of the controls at the top of the C Make Settings dialog. The Add Configuration button is highlighted."::: 1. Choose the desired Clang configuration (note that separate Clang configurations are provided for Windows and Linux), then press **Select**: - :::image type="content" source="media/cmake-clang-configuration.png" alt-text="Screenshot of the Add Configuration to C Make Settings dialog for Clang configuration. Contains entries such as Mingw64-Release, x86-Debug/Release, x64-Debug/Release, x86-Clang Debug/Release."::: + :::image type="content" source="media/cmake-clang-configuration.png" alt-text="Screenshot of the Add Configuration to C Make Settings dialog for Clang configuration. Contains entries such as Mingw64-Release, x86-Debug, x64-Debug, x86-Clang Debug/Release, and so on."::: 1. To make modifications to this configuration, use the **CMake Settings Editor**. For more information, see [Customize CMake build settings in Visual Studio](customize-cmake-settings.md). diff --git a/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md b/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md index 8998b1d37b4..5fab4c2c2aa 100644 --- a/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md +++ b/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md @@ -24,7 +24,7 @@ To retarget your projects to use the latest Windows SDK when you upgrade from a 1. Open the shortcut menu for the project node, and choose **Retarget projects**. (In earlier versions of Visual Studio, choose **Retarget SDK Version**.) The **Review Solution Actions** dialog appears. - :::image type="content" source="../windows/media/retargetingwindowssdk2.PNG" alt-text="Screenshot of the Review Solution Actions dialog. Target Platform Versions is set to 10.0.10156.0"::: + :::image type="content" source="media/retargetingwindowssdk2.PNG" alt-text="Screenshot of the Review Solution Actions dialog. Target Platform Versions is set to 10.0.10156.0"::: 1. In the **Target Platform Version** dropdown list, choose the version of the Windows SDK you want to target. Generally speaking, we recommend you choose the latest installed version. Choose the **OK** button to apply the change. @@ -36,15 +36,15 @@ To retarget your projects to use the latest Windows SDK when you upgrade from a 1. Open the project properties dialog. In the **Configuration Properties** > **General** section, notice the values of **Windows Target Platform Version**. Changing the value here has the same effect as following this procedure. For more information, see [General Property Page (Project)](../build/reference/general-property-page-project.md). - :::image type="content" source="../windows/media/retargetingwindowssdk3.PNG" alt-text="Screenshot of the Property Pages dialog. Target Platform Version is set to 8.1." lightbox="../windows/media/retargetingwindowssdk3.PNG"::: + :::image type="content" source="media/retargetingwindowssdk3.PNG" alt-text="Screenshot of the Property Pages dialog. Target Platform Version is set to 8.1." lightbox="media/retargetingwindowssdk3.PNG"::: This action changes the values of project macros that include paths to header files and library files. To see what changed, open the **Visual C++ Directories** section of the **Project Properties** dialog. Select one of the properties, such as **Include Directories**. Then, open the property value's dropdown list, and choose **\**. The **Include Directories** dialog appears. - :::image type="content" source="../windows/media/retargetingwindowssdk4.PNG" alt-text="Screenshot of the Include Directories dialog showing paths to Windows SDK includes such as C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/Include." lightbox="../windows/media/retargetingwindowssdk4.PNG"::: + :::image type="content" source="media/retargetingwindowssdk4.PNG" alt-text="Screenshot of the Include Directories dialog showing paths to Windows SDK includes such as C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/Include." lightbox="media/retargetingwindowssdk4.PNG"::: Choose the **Macros >>** button, and scroll down the list of macros to the Windows SDK macros to see all the new values. - :::image type="content" source="../windows/media/retargetingwindowssdk5.PNG" alt-text="Screenshot of the macros dialog showing Windows SDK-related macros and their values. For example, $(windir) is c:/Windows." lightbox="../windows/media/retargetingwindowssdk5.PNG"::: + :::image type="content" source="media/retargetingwindowssdk5.PNG" alt-text="Screenshot of the macros dialog showing Windows SDK-related macros and their values. For example, $(windir) is c:/Windows." lightbox="media/retargetingwindowssdk5.PNG"::: 1. Repeat the retargeting procedure for other solution projects, as needed, and rebuild the solution. From 757992564713049bde553f3b14e5b081ec169b95 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 8 Sep 2025 19:30:19 -0700 Subject: [PATCH 1144/1799] lightbox --- ...ing-a-visual-cpp-application-by-using-a-setup-project.md | 6 +++--- docs/windows/windows-desktop-wizard.md | 4 +--- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md index 99e286e2a67..ace07229458 100644 --- a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md +++ b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md @@ -44,7 +44,7 @@ If you have Visual Studio installed, but you don't have the C++ or MFC component 1. In the Manage Extensions dialog, expand **Online** > **Visual Studio Marketplace** > **Tools** and select **Setup & Deployment**. - :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected."::: + :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected." Lightbox="media/vs2019-extension-dialog-installer-project.png"::: 1. In the list of extensions, select **Microsoft Visual Studio Installer Projects 2022**. Choose the **Download** button. @@ -84,7 +84,7 @@ If you have Visual Studio installed, but you don't have the C++ or MFC component 1. In the Manage Extensions dialog, expand **Online** > **Visual Studio Marketplace** > **Tools** and select **Setup & Deployment**. - :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected."::: + :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected." Lightbox="media/vs2019-extension-dialog-installer-project.png"::: 1. In the list of extensions, select **Microsoft Visual Studio Installer Projects**. Choose the **Download** button. @@ -124,7 +124,7 @@ If you have Visual Studio 2017 installed, but you don't have the C++ or MFC comp 1. In the Extensions and Updates dialog, expand **Online** > **Visual Studio Marketplace** > **Tools** and select **Setup & Deployment**. Set the **Sort by** dropdown to **Most Downloads**. - :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected."::: + :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected." Lightbox="media/vs2019-extension-dialog-installer-project.png"::: 1. In the list of extensions, select **Microsoft Visual Studio Installer Projects**. Choose the **Download** button. diff --git a/docs/windows/windows-desktop-wizard.md b/docs/windows/windows-desktop-wizard.md index 6b57672f3df..3509d67f7a4 100644 --- a/docs/windows/windows-desktop-wizard.md +++ b/docs/windows/windows-desktop-wizard.md @@ -10,9 +10,7 @@ ms.assetid: 5d7b3a5e-8461-479a-969a-67b7883725b9 The Windows Desktop Wizard replaces the Win32 Application Wizard in Visual Studio 2017 and later. The wizard allows you to create any of four types of C++ projects (listed in the heading in the table below). In each case, you can specify additional options that are appropriate for the type of project you open. - ![Screenshot of the Windows Desktop Project wizard.](media/windows-desktop-wizard.png) - -:::image type="content" source="media/windows-desktop-wizard.png" alt-text="Screenshot of the Windows Desktop Project wizard. Application type is set to Console Application (.exe) Precompiled Header and Security Development Lifecycle (SDL) checks are selected."::: +:::image type="content" source="media/windows-desktop-wizard.png" alt-text="Screenshot of the Windows Desktop Project wizard. Application type is set to Console Application (.exe) Precompiled Header and Security Development Lifecycle (SDL) checks are selected." Lightbox="media/windows-desktop-wizard.png"::: The following table indicates which options are available for each application type. From ad753654275b28a527843219cbf8271f93e198e3 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 8 Sep 2025 19:40:04 -0700 Subject: [PATCH 1145/1799] edits --- docs/build/clang-support-cmake.md | 6 +++--- ...e-the-windows-10-sdk-in-a-windows-desktop-application.md | 2 +- ...ing-a-visual-cpp-application-by-using-a-setup-project.md | 6 +++--- docs/windows/windows-desktop-wizard.md | 2 +- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/build/clang-support-cmake.md b/docs/build/clang-support-cmake.md index f0b27f2a3d7..4b74bd679fc 100644 --- a/docs/build/clang-support-cmake.md +++ b/docs/build/clang-support-cmake.md @@ -50,7 +50,7 @@ To add a new Clang configuration to a CMake project: 1. Choose the desired Clang configuration (note that separate Clang configurations are provided for Windows and Linux), then press **Select**: - :::image type="content" source="media/cmake-clang-configuration.png" alt-text="Screenshot of the Add Configuration to C Make Settings dialog for Clang configuration. Contains entries such as Mingw64-Release, x86-Debug, x64-Debug, x86-Clang Debug/Release, and so on."::: + :::image type="content" source="media/cmake-clang-configuration.png" alt-text="Screenshot of the Add Configuration to C Make Settings dialog for Clang configuration. Contains entries such as Mingw64-Release, x86-Debug, x64-Debug, x86-Clang Debug, and so on."::: 1. To make modifications to this configuration, use the **CMake Settings Editor**. For more information, see [Customize CMake build settings in Visual Studio](customize-cmake-settings.md). @@ -73,7 +73,7 @@ By default, Visual Studio looks for Clang in two places: You can specify another location by setting the **CMAKE_C_COMPILER** and **CMAKE_CXX_COMPILER** CMake variables in **CMake Settings**: -:::image type="content" source="media/clang-location-cmake.png" alt-text="Screenshot of the C Make Settings dialog box with the C Make C X X Compiler highlighted. C Make configurations are listed such as x64-Clang-Debug, Linx-Clang-Release, and so on." Lightbox="media/clang-location-cmake.png"::: +:::image type="content" source="media/clang-location-cmake.png" alt-text="Screenshot of the C Make Settings dialog box with the C Make C X X Compiler highlighted. C Make configurations are listed such as x64-Clang-Debug, Linux-Clang-Release, and so on." Lightbox="media/clang-location-cmake.png"::: ## Clang compatibility modes @@ -87,6 +87,6 @@ After you have set up a Clang configuration, you can build and debug the project When debugging, you can use breakpoints, memory and data visualization, and most other debugging features. Some compiler-dependent features such as Edit and Continue aren't available for Clang configurations. -:::image type="content" source="media/clang-debug-visualize.png" alt-text="Screenshot of the Visual Studio debugger debugging a CMake Clang project. The Autos window is visible, showing variables and their values."::: +:::image type="content" source="media/clang-debug-visualize.png" alt-text="Screenshot of the Visual Studio debugger debugging a CMake Clang project."::: ::: moniker-end diff --git a/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md b/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md index 5fab4c2c2aa..d9158b617c8 100644 --- a/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md +++ b/docs/windows/how-to-use-the-windows-10-sdk-in-a-windows-desktop-application.md @@ -40,7 +40,7 @@ To retarget your projects to use the latest Windows SDK when you upgrade from a This action changes the values of project macros that include paths to header files and library files. To see what changed, open the **Visual C++ Directories** section of the **Project Properties** dialog. Select one of the properties, such as **Include Directories**. Then, open the property value's dropdown list, and choose **\**. The **Include Directories** dialog appears. - :::image type="content" source="media/retargetingwindowssdk4.PNG" alt-text="Screenshot of the Include Directories dialog showing paths to Windows SDK includes such as C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/Include." lightbox="media/retargetingwindowssdk4.PNG"::: + :::image type="content" source="media/retargetingwindowssdk4.PNG" alt-text="Screenshot of the Include Directories dialog showing paths to Windows SDK includes such as C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/Include, and so on." lightbox="media/retargetingwindowssdk4.PNG"::: Choose the **Macros >>** button, and scroll down the list of macros to the Windows SDK macros to see all the new values. diff --git a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md index ace07229458..5b2af3d9365 100644 --- a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md +++ b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md @@ -44,7 +44,7 @@ If you have Visual Studio installed, but you don't have the C++ or MFC component 1. In the Manage Extensions dialog, expand **Online** > **Visual Studio Marketplace** > **Tools** and select **Setup & Deployment**. - :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected." Lightbox="media/vs2019-extension-dialog-installer-project.png"::: + :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog with Microsoft Visual Studio Installer Projects selected." Lightbox="media/vs2019-extension-dialog-installer-project.png"::: 1. In the list of extensions, select **Microsoft Visual Studio Installer Projects 2022**. Choose the **Download** button. @@ -84,7 +84,7 @@ If you have Visual Studio installed, but you don't have the C++ or MFC component 1. In the Manage Extensions dialog, expand **Online** > **Visual Studio Marketplace** > **Tools** and select **Setup & Deployment**. - :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected." Lightbox="media/vs2019-extension-dialog-installer-project.png"::: + :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog with Microsoft Visual Studio Installer Projects selected." Lightbox="media/vs2019-extension-dialog-installer-project.png"::: 1. In the list of extensions, select **Microsoft Visual Studio Installer Projects**. Choose the **Download** button. @@ -124,7 +124,7 @@ If you have Visual Studio 2017 installed, but you don't have the C++ or MFC comp 1. In the Extensions and Updates dialog, expand **Online** > **Visual Studio Marketplace** > **Tools** and select **Setup & Deployment**. Set the **Sort by** dropdown to **Most Downloads**. - :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog Microsoft Visual Studio Installer Projects item selected." Lightbox="media/vs2019-extension-dialog-installer-project.png"::: + :::image type="content" source="media/vs2019-extension-dialog-installer-project.png" alt-text="Screenshot of the Manage Extensions dialog with Microsoft Visual Studio Installer Projects selected." Lightbox="media/vs2019-extension-dialog-installer-project.png"::: 1. In the list of extensions, select **Microsoft Visual Studio Installer Projects**. Choose the **Download** button. diff --git a/docs/windows/windows-desktop-wizard.md b/docs/windows/windows-desktop-wizard.md index 3509d67f7a4..ff53b068d36 100644 --- a/docs/windows/windows-desktop-wizard.md +++ b/docs/windows/windows-desktop-wizard.md @@ -10,7 +10,7 @@ ms.assetid: 5d7b3a5e-8461-479a-969a-67b7883725b9 The Windows Desktop Wizard replaces the Win32 Application Wizard in Visual Studio 2017 and later. The wizard allows you to create any of four types of C++ projects (listed in the heading in the table below). In each case, you can specify additional options that are appropriate for the type of project you open. -:::image type="content" source="media/windows-desktop-wizard.png" alt-text="Screenshot of the Windows Desktop Project wizard. Application type is set to Console Application (.exe) Precompiled Header and Security Development Lifecycle (SDL) checks are selected." Lightbox="media/windows-desktop-wizard.png"::: +:::image type="content" source="media/windows-desktop-wizard.png" alt-text="Screenshot of the Windows Desktop Project wizard. Application type is set to Console Application (.exe). The Precompiled Header and the Security Development Lifecycle (SDL) checkboxes are selected." Lightbox="media/windows-desktop-wizard.png"::: The following table indicates which options are available for each application type. From c4876849411d7a91b14a9ecb7deec040ec125c52 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 21:14:14 +0800 Subject: [PATCH 1146/1799] Tweak wording in "C/C++ projects and build systems in Visual Studio" topic --- docs/build/projects-and-build-systems-cpp.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/build/projects-and-build-systems-cpp.md b/docs/build/projects-and-build-systems-cpp.md index 156cd4acfd8..e66f186177e 100644 --- a/docs/build/projects-and-build-systems-cpp.md +++ b/docs/build/projects-and-build-systems-cpp.md @@ -13,7 +13,7 @@ You can use Visual Studio to edit, compile, and build any C++ code base with ful ## C++ compilation -To *build* a C++ program means to compile source code from one or more files and then link those files into an executable file (.exe), a dynamic-load library (.dll) or a static library (.lib). +To *build* a C++ program means to compile source code from one or more files and then link those files into an executable file (.exe), a dynamic-link library (.dll) or a static library (.lib). Basic C++ compilation involves three main steps: @@ -39,13 +39,13 @@ Most real-world programs use some kind of *build system* to manage complexities The following list shows various options for Visual Studio Projects - C++: -- create a Visual Studio project by using the Visual Studio IDE and configure it by using property pages. Visual Studio projects produce programs that run on Windows. For an overview, see [Compiling and Building](/visualstudio/ide/compiling-and-building-in-visual-studio) in the Visual Studio documentation. +- Create a Visual Studio project by using the Visual Studio IDE and configure it by using property pages. Visual Studio projects produce programs that run on Windows. For an overview, see [Compiling and Building](/visualstudio/ide/compiling-and-building-in-visual-studio) in the Visual Studio documentation. -- open a folder that contains a CMakeLists.txt file. CMake support is integrated into Visual Studio. You can use the IDE to edit, test, and debug without modifying the CMake files in any way. This enables you to work in the same CMake project as others who might be using different editors. CMake is the recommended approach for cross-platform development. For more information, see [CMake projects](cmake-projects-in-visual-studio.md). +- Open a folder that contains a CMakeLists.txt file. CMake support is integrated into Visual Studio. You can use the IDE to edit, test, and debug without modifying the CMake files in any way. This enables you to work in the same CMake project as others who might be using different editors. CMake is the recommended approach for cross-platform development. For more information, see [CMake projects](cmake-projects-in-visual-studio.md). -- open a loose folder of source files with no project file. Visual Studio will use heuristics to build the files. This is an easy way to compile and run small console applications. For more information, see [Open Folder projects](open-folder-projects-cpp.md). +- Open a loose folder of source files with no project file. Visual Studio will use heuristics to build the files. This is an easy way to compile and run small console applications. For more information, see [Open Folder projects](open-folder-projects-cpp.md). -- open a folder that contains a makefile, or any other build system configuration file. You can configure Visual Studio to invoke any arbitrary build commands by adding JSON files to the folder. For more information, see [Open Folder projects](open-folder-projects-cpp.md). +- Open a folder that contains a makefile, or any other build system configuration file. You can configure Visual Studio to invoke any arbitrary build commands by adding JSON files to the folder. For more information, see [Open Folder projects](open-folder-projects-cpp.md). - Open a Windows makefile in Visual Studio. For more information, see [NMAKE Reference](reference/nmake-reference.md). @@ -86,7 +86,7 @@ How to target 64-bit x64 hardware with the MSVC build tools. How to use the MSVC build tools to target ARM hardware. [Optimizing Your Code](optimizing-your-code.md)\ -How to optimize your code in various ways including program guided optimizations. +How to optimize your code in various ways including profile-guided optimization (PGO). [Configuring Programs for Windows XP](configuring-programs-for-windows-xp.md)\ How to target Windows XP with the MSVC build tools. From 439ffbd982fe3b9e5093a3a6faabcb78910989b6 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 21:18:13 +0800 Subject: [PATCH 1147/1799] Add backticks in "C/C++ projects and build systems in Visual Studio" topic --- docs/build/projects-and-build-systems-cpp.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/build/projects-and-build-systems-cpp.md b/docs/build/projects-and-build-systems-cpp.md index e66f186177e..901d969c248 100644 --- a/docs/build/projects-and-build-systems-cpp.md +++ b/docs/build/projects-and-build-systems-cpp.md @@ -13,25 +13,25 @@ You can use Visual Studio to edit, compile, and build any C++ code base with ful ## C++ compilation -To *build* a C++ program means to compile source code from one or more files and then link those files into an executable file (.exe), a dynamic-link library (.dll) or a static library (.lib). +To *build* a C++ program means to compile source code from one or more files and then link those files into an executable file (`.exe`), a dynamic-link library (`.dll`) or a static library (`.lib`). Basic C++ compilation involves three main steps: - The C++ preprocessor transforms all the #directives and macro definitions in each source file. This creates a *translation unit*. -- The C++ compiler compiles each translation unit into object files (.obj), applying whatever compiler options have been set. +- The C++ compiler compiles each translation unit into object files (`.obj`), applying whatever compiler options have been set. - The *linker* merges the object files into a single executable, applying the linker options that have been set. ## The MSVC toolset The Microsoft C++ compiler, linker, standard libraries, and related utilities make up the MSVC compiler toolset (also called a toolchain or "build tools"). These are included in Visual Studio. You can also download and use the command-line toolset as a free standalone package. For more information, see [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) on the Visual Studio Downloads page. -You can build simple programs by invoking the MSVC compiler (cl.exe) directly from the command line. The following command accepts a single source code file, and invokes cl.exe to build an executable called *hello.exe*: +You can build simple programs by invoking the MSVC compiler (`cl.exe`) directly from the command line. The following command accepts a single source code file, and invokes `cl.exe` to build an executable called *`hello.exe`*: ```cmd cl /EHsc hello.cpp ``` -Here the compiler (cl.exe) automatically invokes the C++ preprocessor and the linker to produce the final output file. For more information, see [Building on the command line](building-on-the-command-line.md). +Here the compiler (`cl.exe`) automatically invokes the C++ preprocessor and the linker to produce the final output file. For more information, see [Building on the command line](building-on-the-command-line.md). ## Build systems and projects @@ -41,7 +41,7 @@ The following list shows various options for Visual Studio Projects - C++: - Create a Visual Studio project by using the Visual Studio IDE and configure it by using property pages. Visual Studio projects produce programs that run on Windows. For an overview, see [Compiling and Building](/visualstudio/ide/compiling-and-building-in-visual-studio) in the Visual Studio documentation. -- Open a folder that contains a CMakeLists.txt file. CMake support is integrated into Visual Studio. You can use the IDE to edit, test, and debug without modifying the CMake files in any way. This enables you to work in the same CMake project as others who might be using different editors. CMake is the recommended approach for cross-platform development. For more information, see [CMake projects](cmake-projects-in-visual-studio.md). +- Open a folder that contains a `CMakeLists.txt` file. CMake support is integrated into Visual Studio. You can use the IDE to edit, test, and debug without modifying the CMake files in any way. This enables you to work in the same CMake project as others who might be using different editors. CMake is the recommended approach for cross-platform development. For more information, see [CMake projects](cmake-projects-in-visual-studio.md). - Open a loose folder of source files with no project file. Visual Studio will use heuristics to build the files. This is an easy way to compile and run small console applications. For more information, see [Open Folder projects](open-folder-projects-cpp.md). @@ -51,7 +51,7 @@ The following list shows various options for Visual Studio Projects - C++: ## MSBuild from the command line -You can invoke MSBuild from the command line by passing it a .vcxproj file along with command-line options. This approach requires a good understanding of MSBuild, and is recommended only when necessary. For more information, see [MSBuild](msbuild-visual-cpp.md). +You can invoke MSBuild from the command line by passing it a `.vcxproj` file along with command-line options. This approach requires a good understanding of MSBuild, and is recommended only when necessary. For more information, see [MSBuild](msbuild-visual-cpp.md). ## In This Section @@ -74,7 +74,7 @@ Discusses how to use the C/C++ compiler and build tools directly from the comman How to create, debug, and deploy C/C++ DLLs (shared libraries) in Visual Studio. [Walkthrough: Creating and Using a Static Library](walkthrough-creating-and-using-a-static-library-cpp.md)\ -How to create a **.lib** binary file. +How to create a `.lib` binary file. [Building C/C++ Isolated Applications and Side-by-side Assemblies](building-c-cpp-isolated-applications-and-side-by-side-assemblies.md)\ Describes the deployment model for Windows Desktop applications, based on the idea of isolated applications and side-by-side assemblies. From 9bd711021949917f395f384a5a77df4b63499d30 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 21:19:22 +0800 Subject: [PATCH 1148/1799] Update metadata in "C/C++ projects and build systems in Visual Studio" topic --- docs/build/projects-and-build-systems-cpp.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/build/projects-and-build-systems-cpp.md b/docs/build/projects-and-build-systems-cpp.md index 901d969c248..0b2403238fb 100644 --- a/docs/build/projects-and-build-systems-cpp.md +++ b/docs/build/projects-and-build-systems-cpp.md @@ -1,11 +1,10 @@ --- title: "C/C++ projects and build systems in Visual Studio" description: "Use Visual Studio to compile and build C++ projects for Windows, ARM, or Linux based on any project system." -ms.date: "07/17/2019" -helpviewer_keywords: ["builds [C++]", "C++ projects, building", "projects [C++], building", "builds [C++], options", "C++, build options"] -ms.assetid: fa6ed4ff-334a-4d99-b5e2-a1f83d2b3008 +ms.date: 07/17/2019 ms.topic: "overview" ms.custom: intro-overview +helpviewer_keywords: ["builds [C++]", "C++ projects, building", "projects [C++], building", "builds [C++], options", "C++, build options"] --- # C/C++ projects and build systems in Visual Studio From 4bd66dbdb98c4ee053b98a720fef86dc1532fc47 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 21:38:51 +0800 Subject: [PATCH 1149/1799] Add "Remarks" heading in AddressSanitizer error references --- docs/sanitizers/error-alloc-dealloc-mismatch.md | 2 ++ docs/sanitizers/error-allocation-size-too-big.md | 2 ++ docs/sanitizers/error-calloc-overflow.md | 2 ++ docs/sanitizers/error-container-overflow.md | 2 ++ docs/sanitizers/error-double-free.md | 2 ++ docs/sanitizers/error-dynamic-stack-buffer-overflow.md | 2 ++ docs/sanitizers/error-global-buffer-overflow.md | 2 ++ docs/sanitizers/error-heap-buffer-overflow.md | 2 ++ docs/sanitizers/error-heap-use-after-free.md | 2 ++ docs/sanitizers/error-invalid-allocation-alignment.md | 2 ++ docs/sanitizers/error-memcpy-param-overlap.md | 2 ++ docs/sanitizers/error-new-delete-type-mismatch.md | 2 ++ docs/sanitizers/error-stack-buffer-overflow.md | 2 ++ docs/sanitizers/error-stack-buffer-underflow.md | 2 ++ docs/sanitizers/error-stack-use-after-return.md | 2 ++ docs/sanitizers/error-stack-use-after-scope.md | 2 ++ docs/sanitizers/error-strncat-param-overlap.md | 2 ++ docs/sanitizers/error-use-after-poison.md | 2 ++ 18 files changed, 36 insertions(+) diff --git a/docs/sanitizers/error-alloc-dealloc-mismatch.md b/docs/sanitizers/error-alloc-dealloc-mismatch.md index 22cf7f620f0..ad48d631fc4 100644 --- a/docs/sanitizers/error-alloc-dealloc-mismatch.md +++ b/docs/sanitizers/error-alloc-dealloc-mismatch.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["alloc-dealloc-mismatch error", "AddressSanitizer error al > Address Sanitizer Error: Mismatch between allocation and deallocation APIs +## Remarks + Enables runtime detection of mismatched memory operations that may lead to undefined behavior, such as: - `malloc` must be paired with `free`, not `delete` or `delete[]`. - `new` must be paired with `delete`, not `free` or `delete[]`. diff --git a/docs/sanitizers/error-allocation-size-too-big.md b/docs/sanitizers/error-allocation-size-too-big.md index 80638c6880a..0a7d7a95820 100644 --- a/docs/sanitizers/error-allocation-size-too-big.md +++ b/docs/sanitizers/error-allocation-size-too-big.md @@ -10,6 +10,8 @@ helpviewer_keywords: ["allocation-size-too-big error", "AddressSanitizer error a > Address Sanitizer Error: allocation-size-too-big +## Remarks + This example shows the error found when an allocation is too large for the heap. Example sourced from [LLVM compiler-rt test suite](https://github.com/llvm/llvm-project/tree/main/compiler-rt/test/asan/TestCases). ## Example diff --git a/docs/sanitizers/error-calloc-overflow.md b/docs/sanitizers/error-calloc-overflow.md index 5b944307d82..ba5e6c01ace 100644 --- a/docs/sanitizers/error-calloc-overflow.md +++ b/docs/sanitizers/error-calloc-overflow.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["calloc-overflow error", "AddressSanitizer error calloc-ov > Address Sanitizer Error: calloc-overflow +## Remarks + The CRT function [`calloc`](../c-runtime-library/reference/calloc.md) creates an array in memory with elements initialized to 0. The arguments can create an internal error that leads to a NULL pointer as the return value. ## Example diff --git a/docs/sanitizers/error-container-overflow.md b/docs/sanitizers/error-container-overflow.md index b4c1e4c7832..13a4d0a88dd 100644 --- a/docs/sanitizers/error-container-overflow.md +++ b/docs/sanitizers/error-container-overflow.md @@ -10,6 +10,8 @@ helpviewer_keywords: ["container-overflow error", "AddressSanitizer error contai > Address Sanitizer Error: Container overflow +## Remarks + In Visual Studio 2022 version 17.2 and later, the Microsoft Visual C++ standard library (STL) is partially enlightened to work with the AddressSanitizer. The following container types have annotations to detect memory access issues: | Standard container type | Disable annotations macro | Supported in version | diff --git a/docs/sanitizers/error-double-free.md b/docs/sanitizers/error-double-free.md index 84b4dd42741..2e51fd7df25 100644 --- a/docs/sanitizers/error-double-free.md +++ b/docs/sanitizers/error-double-free.md @@ -11,6 +11,8 @@ ms.custom: sfi-image-nochange > Address Sanitizer Error: Deallocation of freed memory +## Remarks + In C, you can call `free` erroneously. In C++, you can call `delete` more than once. In these examples, we show errors with `delete`, `free`, and `HeapCreate`. ## Example C++ - double `operator delete` diff --git a/docs/sanitizers/error-dynamic-stack-buffer-overflow.md b/docs/sanitizers/error-dynamic-stack-buffer-overflow.md index 4b0da9350d6..24ea4bc8e64 100644 --- a/docs/sanitizers/error-dynamic-stack-buffer-overflow.md +++ b/docs/sanitizers/error-dynamic-stack-buffer-overflow.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["dynamic-stack-buffer-overflow error", "AddressSanitizer e > Address Sanitizer Error: dynamic-stack-buffer-overflow +## Remarks + This example shows the error that results from a buffer access outside the bounds of a stack-allocated object. ## Example - `alloca` overflow (right) diff --git a/docs/sanitizers/error-global-buffer-overflow.md b/docs/sanitizers/error-global-buffer-overflow.md index 1f7885ddf8a..fe184786721 100644 --- a/docs/sanitizers/error-global-buffer-overflow.md +++ b/docs/sanitizers/error-global-buffer-overflow.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["global-buffer-overflow error", "AddressSanitizer error gl > Address Sanitizer Error: Global buffer overflow +## Remarks + The compiler generates metadata for any variable in the `.data` or `.bss` sections. These variables have language scope of global or file static. They're allocated in memory before `main()` starts. Global variables in C are treated much differently than in C++. This difference is because of the complex rules for linking C. In C, a global variable can be declared in several source files, and each definition can have different types. The compiler can't see all the possible definitions at once, but the linker can. For C, the linker defaults to selecting the largest-sized variable out of all the different declarations. diff --git a/docs/sanitizers/error-heap-buffer-overflow.md b/docs/sanitizers/error-heap-buffer-overflow.md index 497f9847db7..9366c9d6507 100644 --- a/docs/sanitizers/error-heap-buffer-overflow.md +++ b/docs/sanitizers/error-heap-buffer-overflow.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["heap-buffer-overflow error", "AddressSanitizer error heap > Address Sanitizer Error: Heap buffer overflow +## Remarks + This example demonstrates the error that results when a memory access occurs outside the bounds of a heap-allocated object. ## Example - classic heap buffer overflow diff --git a/docs/sanitizers/error-heap-use-after-free.md b/docs/sanitizers/error-heap-use-after-free.md index f0c827d5d28..ddbbc72ce85 100644 --- a/docs/sanitizers/error-heap-use-after-free.md +++ b/docs/sanitizers/error-heap-use-after-free.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["heap-use-after-free error", "AddressSanitizer error heap- > Address Sanitizer Error: Use of deallocated memory +## Remarks + We show three examples where storage in the heap can be allocated via `malloc`, `realloc` (C), and `new` (C++), along with a mistaken use of `volatile`. ## Example - `malloc` diff --git a/docs/sanitizers/error-invalid-allocation-alignment.md b/docs/sanitizers/error-invalid-allocation-alignment.md index 87b091b869d..7202890640e 100644 --- a/docs/sanitizers/error-invalid-allocation-alignment.md +++ b/docs/sanitizers/error-invalid-allocation-alignment.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["invalid-allocation-alignment error", "AddressSanitizer er > Address Sanitizer Error: invalid-allocation-alignment +## Remarks + The [`_aligned_malloc`](../c-runtime-library/reference/aligned-malloc.md) function requires a power of 2 for expressing the alignment. We simulate the "external" calculation of some alignment factor using an unoptimized global variable. ## Example diff --git a/docs/sanitizers/error-memcpy-param-overlap.md b/docs/sanitizers/error-memcpy-param-overlap.md index 5c5c46173de..c3151c02a52 100644 --- a/docs/sanitizers/error-memcpy-param-overlap.md +++ b/docs/sanitizers/error-memcpy-param-overlap.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["memcpy-param-overlap error", "AddressSanitizer error memc > Address Sanitizer Error: memcpy-param-overlap +## Remarks + > [!NOTE] > The `/Oi` flag is required to reliably detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and other functions as intrinsics, which is necessary because some versions of the standard library implement them as such. Since ASan is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Note that when `/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions isn't guaranteed to be used. For more information, see [`/Oi` docs](../build/reference/oi-generate-intrinsic-functions.md). diff --git a/docs/sanitizers/error-new-delete-type-mismatch.md b/docs/sanitizers/error-new-delete-type-mismatch.md index 2c19b710af7..3ba02bb4cb6 100644 --- a/docs/sanitizers/error-new-delete-type-mismatch.md +++ b/docs/sanitizers/error-new-delete-type-mismatch.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["new-delete-type-mismatch error", "AddressSanitizer error > Address Sanitizer Error: Deallocation size different from allocation size +## Remarks + In this example, only `~Base`, and not `~Derived`, is called. The compiler generates a call to `~Base()` because the `Base` destructor isn't **`virtual`**. When we call `delete b`, the object's destructor is bound to the default definition. The code deletes an empty base class (or 1 byte on Windows). A missing **`virtual`** keyword on the destructor declaration is a common C++ error when using inheritance. ## Example - virtual destructor diff --git a/docs/sanitizers/error-stack-buffer-overflow.md b/docs/sanitizers/error-stack-buffer-overflow.md index c02011aaef5..ebac5b87faa 100644 --- a/docs/sanitizers/error-stack-buffer-overflow.md +++ b/docs/sanitizers/error-stack-buffer-overflow.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["stack-buffer-overflow error", "AddressSanitizer error sta > Address Sanitizer Error: Stack buffer overflow +## Remarks + A stack buffer overflow can happen many ways in C or C++. We provide several examples for this category of error that you can catch by a simple recompile. ## Example - stack buffer overflow diff --git a/docs/sanitizers/error-stack-buffer-underflow.md b/docs/sanitizers/error-stack-buffer-underflow.md index a780be1f668..32dcce7df39 100644 --- a/docs/sanitizers/error-stack-buffer-underflow.md +++ b/docs/sanitizers/error-stack-buffer-underflow.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["stack-buffer-underflow error", "AddressSanitizer error st > Address Sanitizer Error: Stack buffer underflow +## Remarks + These error messages indicate a memory access to somewhere before the beginning of a stack variable. ## Example - local array underflow diff --git a/docs/sanitizers/error-stack-use-after-return.md b/docs/sanitizers/error-stack-use-after-return.md index 5f6154e217b..e2e05d22498 100644 --- a/docs/sanitizers/error-stack-use-after-return.md +++ b/docs/sanitizers/error-stack-use-after-return.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["stack-use-after-return error", "AddressSanitizer error st > Address Sanitizer Error: Use of stack memory after return +## Remarks + This check requires code generation that's activated by an extra compiler option, [`/fsanitize-address-use-after-return`](../build/reference/fsanitize.md), and by setting the environment variable `ASAN_OPTIONS=detect_stack_use_after_return=1`. This check can slow your application down substantially. Consider the [Clang summary](https://github.com/google/sanitizers/wiki/AddressSanitizerUseAfterReturn) of the algorithm that supports use after return, and the larger performance costs. diff --git a/docs/sanitizers/error-stack-use-after-scope.md b/docs/sanitizers/error-stack-use-after-scope.md index fb2ff6df9c9..86c5f3f546e 100644 --- a/docs/sanitizers/error-stack-use-after-scope.md +++ b/docs/sanitizers/error-stack-use-after-scope.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["stack-use-after-scope error", "AddressSanitizer error sta > Address Sanitizer Error: Use of out-of-scope stack memory +## Remarks + The use of a stack address outside the lexical scope of a variable's lifetime can happen many ways in C or C++. ## Example 1 - simple nested local diff --git a/docs/sanitizers/error-strncat-param-overlap.md b/docs/sanitizers/error-strncat-param-overlap.md index 52c5f31142c..7b488eaa132 100644 --- a/docs/sanitizers/error-strncat-param-overlap.md +++ b/docs/sanitizers/error-strncat-param-overlap.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["strncat-param-overlap error", "AddressSanitizer error str > Address Sanitizer Error: strncat-param-overlap +## Remarks + Code that moves memory in overlapping buffer can cause hard-to-diagnose errors. ## Example diff --git a/docs/sanitizers/error-use-after-poison.md b/docs/sanitizers/error-use-after-poison.md index f6c58a86017..e38a24c55e7 100644 --- a/docs/sanitizers/error-use-after-poison.md +++ b/docs/sanitizers/error-use-after-poison.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["use-after-poison error", "AddressSanitizer error use-afte > Address Sanitizer Error: Use of poisoned memory +## Remarks + A developer can manually poison memory to customize debugging. ## Example From 764ef4ed78db55a75b9f9aad20ae5544f5c820da Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 21:48:37 +0800 Subject: [PATCH 1150/1799] Clean up superfluous `./` link prefix in AddressSanitizer error references --- docs/sanitizers/error-allocation-size-too-big.md | 16 ++++++++-------- docs/sanitizers/error-calloc-overflow.md | 16 ++++++++-------- docs/sanitizers/error-container-overflow.md | 16 ++++++++-------- docs/sanitizers/error-double-free.md | 16 ++++++++-------- .../error-dynamic-stack-buffer-overflow.md | 16 ++++++++-------- docs/sanitizers/error-global-buffer-overflow.md | 16 ++++++++-------- docs/sanitizers/error-heap-buffer-overflow.md | 16 ++++++++-------- docs/sanitizers/error-heap-use-after-free.md | 16 ++++++++-------- .../error-invalid-allocation-alignment.md | 16 ++++++++-------- docs/sanitizers/error-memcpy-param-overlap.md | 16 ++++++++-------- .../sanitizers/error-new-delete-type-mismatch.md | 16 ++++++++-------- docs/sanitizers/error-stack-buffer-overflow.md | 16 ++++++++-------- docs/sanitizers/error-stack-buffer-underflow.md | 16 ++++++++-------- docs/sanitizers/error-stack-use-after-return.md | 16 ++++++++-------- docs/sanitizers/error-stack-use-after-scope.md | 16 ++++++++-------- docs/sanitizers/error-strncat-param-overlap.md | 16 ++++++++-------- docs/sanitizers/error-use-after-poison.md | 16 ++++++++-------- 17 files changed, 136 insertions(+), 136 deletions(-) diff --git a/docs/sanitizers/error-allocation-size-too-big.md b/docs/sanitizers/error-allocation-size-too-big.md index 0a7d7a95820..8cfe9d85383 100644 --- a/docs/sanitizers/error-allocation-size-too-big.md +++ b/docs/sanitizers/error-allocation-size-too-big.md @@ -52,11 +52,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-calloc-overflow.md b/docs/sanitizers/error-calloc-overflow.md index ba5e6c01ace..eff22183f37 100644 --- a/docs/sanitizers/error-calloc-overflow.md +++ b/docs/sanitizers/error-calloc-overflow.md @@ -47,11 +47,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-container-overflow.md b/docs/sanitizers/error-container-overflow.md index 13a4d0a88dd..39b471251df 100644 --- a/docs/sanitizers/error-container-overflow.md +++ b/docs/sanitizers/error-container-overflow.md @@ -92,11 +92,11 @@ If you want the implementation to trust that your custom allocator is handling t ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-double-free.md b/docs/sanitizers/error-double-free.md index 2e51fd7df25..7623468b3fe 100644 --- a/docs/sanitizers/error-double-free.md +++ b/docs/sanitizers/error-double-free.md @@ -108,11 +108,11 @@ devenv /debugexe example3.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-dynamic-stack-buffer-overflow.md b/docs/sanitizers/error-dynamic-stack-buffer-overflow.md index 24ea4bc8e64..3ff4780ae61 100644 --- a/docs/sanitizers/error-dynamic-stack-buffer-overflow.md +++ b/docs/sanitizers/error-dynamic-stack-buffer-overflow.md @@ -172,11 +172,11 @@ devenv /debugexe example3.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-global-buffer-overflow.md b/docs/sanitizers/error-global-buffer-overflow.md index fe184786721..68f2fbb17d9 100644 --- a/docs/sanitizers/error-global-buffer-overflow.md +++ b/docs/sanitizers/error-global-buffer-overflow.md @@ -154,11 +154,11 @@ devenv /debugexe example3.exe -l ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-heap-buffer-overflow.md b/docs/sanitizers/error-heap-buffer-overflow.md index 9366c9d6507..728edfe0575 100644 --- a/docs/sanitizers/error-heap-buffer-overflow.md +++ b/docs/sanitizers/error-heap-buffer-overflow.md @@ -111,11 +111,11 @@ devenv /debugexe example3.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-heap-use-after-free.md b/docs/sanitizers/error-heap-use-after-free.md index ddbbc72ce85..6ddd65cbb5e 100644 --- a/docs/sanitizers/error-heap-use-after-free.md +++ b/docs/sanitizers/error-heap-use-after-free.md @@ -146,11 +146,11 @@ The exception thrown dialog points to line 12, *x = 42, and says: Address Saniti ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-invalid-allocation-alignment.md b/docs/sanitizers/error-invalid-allocation-alignment.md index 7202890640e..bb3a05c022f 100644 --- a/docs/sanitizers/error-invalid-allocation-alignment.md +++ b/docs/sanitizers/error-invalid-allocation-alignment.md @@ -44,11 +44,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-memcpy-param-overlap.md b/docs/sanitizers/error-memcpy-param-overlap.md index c3151c02a52..419cbeb8037 100644 --- a/docs/sanitizers/error-memcpy-param-overlap.md +++ b/docs/sanitizers/error-memcpy-param-overlap.md @@ -50,11 +50,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-new-delete-type-mismatch.md b/docs/sanitizers/error-new-delete-type-mismatch.md index 3ba02bb4cb6..708b39a76c6 100644 --- a/docs/sanitizers/error-new-delete-type-mismatch.md +++ b/docs/sanitizers/error-new-delete-type-mismatch.md @@ -66,11 +66,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-stack-buffer-overflow.md b/docs/sanitizers/error-stack-buffer-overflow.md index ebac5b87faa..403ee7b16bb 100644 --- a/docs/sanitizers/error-stack-buffer-overflow.md +++ b/docs/sanitizers/error-stack-buffer-overflow.md @@ -114,11 +114,11 @@ devenv /debugexe example3.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-stack-buffer-underflow.md b/docs/sanitizers/error-stack-buffer-underflow.md index 32dcce7df39..c8cf463ff24 100644 --- a/docs/sanitizers/error-stack-buffer-underflow.md +++ b/docs/sanitizers/error-stack-buffer-underflow.md @@ -82,11 +82,11 @@ devenv /debugexe example2.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-stack-use-after-return.md b/docs/sanitizers/error-stack-use-after-return.md index e2e05d22498..f3ee909411e 100644 --- a/docs/sanitizers/error-stack-use-after-return.md +++ b/docs/sanitizers/error-stack-use-after-return.md @@ -111,11 +111,11 @@ ASAN is a form of dynamic analysis, which means it can only detect bad code that ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-stack-use-after-scope.md b/docs/sanitizers/error-stack-use-after-scope.md index 86c5f3f546e..951ca39bb4c 100644 --- a/docs/sanitizers/error-stack-use-after-scope.md +++ b/docs/sanitizers/error-stack-use-after-scope.md @@ -161,11 +161,11 @@ ASAN is a form of dynamic analysis, which means it can only detect bad code that ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-strncat-param-overlap.md b/docs/sanitizers/error-strncat-param-overlap.md index 7b488eaa132..e5569f4faba 100644 --- a/docs/sanitizers/error-strncat-param-overlap.md +++ b/docs/sanitizers/error-strncat-param-overlap.md @@ -49,11 +49,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-use-after-poison.md b/docs/sanitizers/error-use-after-poison.md index e38a24c55e7..d8347318d35 100644 --- a/docs/sanitizers/error-use-after-poison.md +++ b/docs/sanitizers/error-use-after-poison.md @@ -47,11 +47,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) From cdbe99c03a327260094ecbf108d13134248a98cf Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 22:02:57 +0800 Subject: [PATCH 1151/1799] Add blockquotes for error messages in range [U1000, U1100] --- docs/error-messages/tool-errors/nmake-fatal-error-u1001.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1007.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1023.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1033.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1034.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1035.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1036.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1050.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1051.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1055.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1056.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1064.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1065.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1070.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1071.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1073.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1076.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1077.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1078.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1083.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1086.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1087.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1088.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1095.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1097.md | 2 +- docs/error-messages/tool-errors/nmake-fatal-error-u1099.md | 2 +- 26 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md index 2b0e13a756c..4e79c1e3c92 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md @@ -8,7 +8,7 @@ ms.assetid: 5d7da559-6cbd-44d6-848c-aaf54cae0d1a --- # NMAKE Fatal Error U1001 -syntax error : illegal character 'character' in macro +> syntax error : illegal character 'character' in macro The given character appears in a macro but is not a letter, number, or underscore. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md index 2b2e8d222f2..1e322fcabfa 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md @@ -8,7 +8,7 @@ ms.assetid: 64fd78a6-5b27-4aa8-92ea-f1c55e6e5edd --- # NMAKE Fatal Error U1007 -double quotation mark not allowed in name +> double quotation mark not allowed in name The specified target name or filename contained a double quotation mark (**"**). diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md index a3bbd00e45e..4bda99b584f 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md @@ -8,7 +8,7 @@ ms.assetid: 22d4c469-85da-43ee-86d1-171b1b99217d --- # NMAKE Fatal Error U1023 -syntax error in expression +> syntax error in expression An expression is invalid. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md index 5eff0091be8..8f0a817c631 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md @@ -8,7 +8,7 @@ ms.assetid: c146f7b5-7d5c-4329-a522-28a648546016 --- # NMAKE Fatal Error U1033 -syntax error : 'string' unexpected +> syntax error : 'string' unexpected The string is not part of the valid syntax for a makefile. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md index 5388c11124a..136eb30cb0e 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md @@ -8,6 +8,6 @@ ms.assetid: 27e678c2-23e2-4247-87f7-66493784af33 --- # NMAKE Fatal Error U1034 -syntax error : separator missing +> syntax error : separator missing The colon (**:**) that separates targets and dependents is missing. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md index 88c3fedee2d..2b662d24788 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md @@ -8,7 +8,7 @@ ms.assetid: 68f0cc59-007e-4109-ac30-7ac4ac447e6d --- # NMAKE Fatal Error U1035 -syntax error : expected ':' or '=' separator +> syntax error : expected ':' or '=' separator Either a colon (**:**) or an equal sign (**=**) was expected. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md index 4d738221c3b..b29875997a8 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md @@ -8,6 +8,6 @@ ms.assetid: b1d03b6b-ce82-4bbb-9904-d392ba72b437 --- # NMAKE Fatal Error U1036 -syntax error : too many names to left of '=' +> syntax error : too many names to left of '=' Only one string is allowed to the left of a macro definition. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md index a8872865701..f327bf54b18 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md @@ -8,6 +8,6 @@ ms.assetid: 3bb2937e-a804-4592-a9e6-afb63360f554 --- # NMAKE Fatal Error U1050 -message +> message The message specified with the **!ERROR** directive was displayed. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md index 4d4aa782c14..e8b5e45b571 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md @@ -8,7 +8,7 @@ ms.assetid: fede5cd5-dac3-47b7-b86d-e1acfb78699f --- # NMAKE Fatal Error U1051 -out of memory +> out of memory NMAKE ran out of memory, including virtual memory, because the makefile was too large or complex. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md index 2d6990c1b7d..500264d37ce 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md @@ -8,7 +8,7 @@ ms.assetid: 1d453922-ba7e-497f-a795-d8d959c40555 --- # NMAKE Fatal Error U1055 -out of environment space +> out of environment space The operating system ran out of room for environment variables. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md index 21829ca80bb..a1cf15fa454 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md @@ -8,7 +8,7 @@ ms.assetid: da855728-b69e-413c-83ed-df912126215e --- # NMAKE Fatal Error U1056 -cannot find command processor +> cannot find command processor The command processor was not in the path specified in the **COMSPEC** or **PATH** environment variables. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md index cd17c2018a2..4a137e7868c 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md @@ -8,7 +8,7 @@ ms.assetid: 7141e66e-cde6-4173-84df-a391f3ebcdd1 --- # NMAKE Fatal Error U1064 -MAKEFILE not found and no target specified +> MAKEFILE not found and no target specified The NMAKE command line did not specify a makefile or a target, and the current directory did not contain a file named MAKEFILE. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md index be07276b6aa..1f86e98aee4 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md @@ -8,6 +8,6 @@ ms.assetid: bc890f20-ff46-4073-ab3b-4a5db879f9bd --- # NMAKE Fatal Error U1065 -invalid option 'option' +> invalid option 'option' The option is not valid for NMAKE. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md index 3636b2a3f10..b97d51f8eb0 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md @@ -8,7 +8,7 @@ ms.assetid: 8639fc39-b4b1-48f5-ac91-0e9fb61680fd --- # NMAKE Fatal Error U1070 -cycle in macro definition 'macroname' +> cycle in macro definition 'macroname' The given macro definition contained a macro whose definition contained the given macro. Circular macro definitions are invalid. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md index fd851f84ff0..ffafe6a5c6c 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md @@ -8,6 +8,6 @@ ms.assetid: 328a0c1f-a867-410e-943d-7b6b75a975ab --- # NMAKE Fatal Error U1071 -cycle in dependency tree for target 'targetname' +> cycle in dependency tree for target 'targetname' A circular dependency exists in the dependency tree for the given target. The given target is a dependent of one of the dependents of the given target. Circular dependencies are invalid. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md index 572d421d61a..3167e22b994 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md @@ -8,7 +8,7 @@ ms.assetid: d46bf2dd-400a-4802-9db2-f832e1c97f02 --- # NMAKE Fatal Error U1073 -don't know how to make 'targetname' +> don't know how to make 'targetname' The specified target does not exist, and there is no command to execute or inference rule to apply. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md index 8c95ad3f7dd..bcd0170c191 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md @@ -8,7 +8,7 @@ ms.assetid: f8a6c646-0c49-4ee3-bb74-ab916a7aa6ff --- # NMAKE Fatal Error U1076 -name too long +> name too long A string exceeded one of the following limits: diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md index 57120c5e205..c95d8ad0497 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md @@ -8,7 +8,7 @@ ms.assetid: 70d989f8-ef34-4ad7-8fe0-5b800556b2a1 --- # NMAKE Fatal Error U1077 -'program' : return code 'value' +> 'program' : return code 'value' The given command or program called by NMAKE failed and returned the given exit code. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md index efcae0f8b0d..970cac7825a 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md @@ -8,7 +8,7 @@ ms.assetid: 24087955-9362-4ddf-9966-e0de43ea4647 --- # NMAKE Fatal Error U1078 -constant overflow at 'expression' +> constant overflow at 'expression' The given expression contained a constant that exceeded the range - 2,147,483,648 to 2,147,483,647. The constant appeared in one of the following situations: diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md index 2b42dcbecf5..22b8b100ad1 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md @@ -8,6 +8,6 @@ ms.assetid: b09bc34d-35d5-4676-b000-fd7d434400d9 --- # NMAKE Fatal Error U1083 -target macro 'target' expands to nothing +> target macro 'target' expands to nothing The given target is an invocation of a macro that has not been defined or has a null value. NMAKE cannot process a null target. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md index 6143eaf3d76..ed6b67e1575 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md @@ -8,7 +8,7 @@ ms.assetid: 6d3cd68a-ead6-4a6d-a205-01324785de7e --- # NMAKE Fatal Error U1086 -**inference rule cannot have dependents** +> inference rule cannot have dependents The colon (**:**) in an inference rule must be followed by one of these: diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md index 6f5406a2315..012818bf9df 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md @@ -8,7 +8,7 @@ ms.assetid: 5236ab54-e117-484d-99c3-852b061fd3d0 --- # NMAKE Fatal Error U1087 -cannot have : and :: dependents for same target +> cannot have : and :: dependents for same target A target cannot be specified in both a single-colon (**:**) and a double-colon (`::`) dependency. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md index 6ed23ef6eef..c81d1443aff 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md @@ -8,6 +8,6 @@ ms.assetid: 75f3527b-9923-408b-a66e-701322c63803 --- # NMAKE Fatal Error U1088 -invalid separator '::' on inference rule +> invalid separator '::' on inference rule An inference rule must be followed by a single colon (**:**). diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md index 012f7e0d104..e4963638ab0 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md @@ -8,7 +8,7 @@ ms.assetid: a392582b-06db-4568-9c13-450293a4fbda --- # NMAKE Fatal Error U1095 -expanded command line 'commandline' too long +> expanded command line 'commandline' too long After macro expansion, the given command line exceeded the limit on length of command lines for the operating system. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md index 1dd82ea7b90..7af6662b8df 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md @@ -8,6 +8,6 @@ ms.assetid: dc6868b3-8425-4920-858a-774ad0c4c5f1 --- # NMAKE Fatal Error U1097 -filename-parts syntax requires dependent +> filename-parts syntax requires dependent The current dependency does not have either an explicit dependent or an implicit dependent. Filename-parts syntax, which uses the percent (`%`) specifier, represents components of the first dependent of the current target. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md index bd672f6cf98..285e21816b2 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md @@ -8,7 +8,7 @@ ms.assetid: 6688a805-43e6-4247-a2d0-14be082f0b13 --- # NMAKE Fatal Error U1099 -stack overflow +> stack overflow The makefile being processed was too complex for the current stack allocation in NMAKE. NMAKE has an allocation of 0x3000 (12K). From cced98c5342cf5893bcbada1758b734789aed635 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 22:06:43 +0800 Subject: [PATCH 1152/1799] Add "Remarks" headings for error references in range [U1000, U1100] --- docs/error-messages/tool-errors/nmake-fatal-error-u1000.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1001.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1007.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1023.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1033.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1034.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1035.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1036.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1045.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1050.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1051.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1052.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1055.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1056.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1059.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1064.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1065.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1070.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1071.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1073.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1076.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1077.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1078.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1083.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1086.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1087.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1088.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1095.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1097.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1099.md | 2 ++ docs/error-messages/tool-errors/nmake-fatal-error-u1100.md | 2 ++ 31 files changed, 62 insertions(+) diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md index f30b782f076..039dc8dfd0b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md @@ -10,4 +10,6 @@ ms.assetid: 49b9bd9e-f1bc-4b55-a171-c748e40b195e > syntax error : ')' missing in macro invocation +## Remarks + A left parenthesis, **(**, appeared without a matching right parenthesis, **)**, in a macro invocation. The correct form is **$(**name**)**; **$**n is allowed for one-character names. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md index 4e79c1e3c92..cedf6501e14 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md @@ -10,6 +10,8 @@ ms.assetid: 5d7da559-6cbd-44d6-848c-aaf54cae0d1a > syntax error : illegal character 'character' in macro +## Remarks + The given character appears in a macro but is not a letter, number, or underscore. This error can be caused by a missing colon in a macro expansion: diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md index 1e322fcabfa..68f56dd474e 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md @@ -10,6 +10,8 @@ ms.assetid: 64fd78a6-5b27-4aa8-92ea-f1c55e6e5edd > double quotation mark not allowed in name +## Remarks + The specified target name or filename contained a double quotation mark (**"**). Double quotation marks can surround a filename but cannot be contained within it. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md index 4bda99b584f..8fff6bd8570 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md @@ -10,6 +10,8 @@ ms.assetid: 22d4c469-85da-43ee-86d1-171b1b99217d > syntax error in expression +## Remarks + An expression is invalid. Check the allowed operators and operator precedence. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md index 8f0a817c631..2a0678fb12d 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md @@ -10,6 +10,8 @@ ms.assetid: c146f7b5-7d5c-4329-a522-28a648546016 > syntax error : 'string' unexpected +## Remarks + The string is not part of the valid syntax for a makefile. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md index 136eb30cb0e..c85a0f8320b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md @@ -10,4 +10,6 @@ ms.assetid: 27e678c2-23e2-4247-87f7-66493784af33 > syntax error : separator missing +## Remarks + The colon (**:**) that separates targets and dependents is missing. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md index 2b662d24788..c1326ab739f 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md @@ -10,6 +10,8 @@ ms.assetid: 68f0cc59-007e-4109-ac30-7ac4ac447e6d > syntax error : expected ':' or '=' separator +## Remarks + Either a colon (**:**) or an equal sign (**=**) was expected. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md index b29875997a8..144869996d7 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md @@ -10,4 +10,6 @@ ms.assetid: b1d03b6b-ce82-4bbb-9904-d392ba72b437 > syntax error : too many names to left of '=' +## Remarks + Only one string is allowed to the left of a macro definition. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md index 06ea660ec4e..3ff98d9c40b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md @@ -10,6 +10,8 @@ ms.assetid: dc70d162-14b9-4107-9237-7514044d72e3 > spawn failed : *message* +## Remarks + A program or command called by NMAKE failed for reason in *message*. When NMAKE calls another program, for example, the compiler or linker, the call may fail. Or, an error may be returned by the called program. This message is used to report the error. To fix this issue, first determine the cause of the error. You can use the commands reported by the NMAKE [/N](../../build/reference/running-nmake.md#nmake-options) option to verify the environment settings and to repeat the actions done by NMAKE on the command line. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md index f327bf54b18..6eec314e28b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md @@ -10,4 +10,6 @@ ms.assetid: 3bb2937e-a804-4592-a9e6-afb63360f554 > message +## Remarks + The message specified with the **!ERROR** directive was displayed. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md index e8b5e45b571..0b211637712 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md @@ -10,6 +10,8 @@ ms.assetid: fede5cd5-dac3-47b7-b86d-e1acfb78699f > out of memory +## Remarks + NMAKE ran out of memory, including virtual memory, because the makefile was too large or complex. ### To fix by using the following possible solutions diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md index 2db5efd3c49..8d026e4dbe5 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md @@ -10,6 +10,8 @@ ms.assetid: b19b3691-e60b-46bd-8822-8426740a9bc7 > file '*filename*' not found +## Remarks + NMAKE could not find the file specified with one of the following: - **/F** option diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md index 500264d37ce..a13aa238130 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md @@ -10,6 +10,8 @@ ms.assetid: 1d453922-ba7e-497f-a795-d8d959c40555 > out of environment space +## Remarks + The operating system ran out of room for environment variables. Either increase the environment space or set fewer environment variables. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md index a1cf15fa454..3f3dac64535 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md @@ -10,6 +10,8 @@ ms.assetid: da855728-b69e-413c-83ed-df912126215e > cannot find command processor +## Remarks + The command processor was not in the path specified in the **COMSPEC** or **PATH** environment variables. NMAKE uses COMMAND.COM or CMD.EXE as a command processor when executing commands. It looks for the command processor first in the path set in **COMSPEC**. If **COMSPEC** does not exist, NMAKE searches the directories specified in **PATH**. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md index b6492fff8af..9e8697a85ff 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md @@ -10,6 +10,8 @@ ms.assetid: b21d9198-9c63-40d0-b589-80e17294ce24 > syntax error : '}' missing in dependent +## Remarks + A search path for a dependent was incorrectly specified. Either a space existed in the path or the closing brace (**}**) was omitted. The syntax for a directory specification for a dependent is diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md index 4a137e7868c..96ddd1ae9dc 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md @@ -10,6 +10,8 @@ ms.assetid: 7141e66e-cde6-4173-84df-a391f3ebcdd1 > MAKEFILE not found and no target specified +## Remarks + The NMAKE command line did not specify a makefile or a target, and the current directory did not contain a file named MAKEFILE. NMAKE requires either a makefile or a command-line target (or both). To make a makefile available to NMAKE, either specify the /F option or place a file named MAKEFILE in the current directory. NMAKE can create a command-line target by using an inference rule if a makefile is not provided. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md index 1f86e98aee4..2fd0d897d65 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md @@ -10,4 +10,6 @@ ms.assetid: bc890f20-ff46-4073-ab3b-4a5db879f9bd > invalid option 'option' +## Remarks + The option is not valid for NMAKE. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md index b97d51f8eb0..2103f050f93 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md @@ -10,6 +10,8 @@ ms.assetid: 8639fc39-b4b1-48f5-ac91-0e9fb61680fd > cycle in macro definition 'macroname' +## Remarks + The given macro definition contained a macro whose definition contained the given macro. Circular macro definitions are invalid. ## Example diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md index ffafe6a5c6c..f78bba9d4fa 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md @@ -10,4 +10,6 @@ ms.assetid: 328a0c1f-a867-410e-943d-7b6b75a975ab > cycle in dependency tree for target 'targetname' +## Remarks + A circular dependency exists in the dependency tree for the given target. The given target is a dependent of one of the dependents of the given target. Circular dependencies are invalid. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md index 3167e22b994..5dba7d8011f 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md @@ -10,6 +10,8 @@ ms.assetid: d46bf2dd-400a-4802-9db2-f832e1c97f02 > don't know how to make 'targetname' +## Remarks + The specified target does not exist, and there is no command to execute or inference rule to apply. ### To fix by using the following possible solutions diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md index bcd0170c191..21e4b315505 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md @@ -10,6 +10,8 @@ ms.assetid: f8a6c646-0c49-4ee3-bb74-ab916a7aa6ff > name too long +## Remarks + A string exceeded one of the following limits: - 1024 characters for a macro name. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md index c95d8ad0497..c3a0719f1ff 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md @@ -10,6 +10,8 @@ ms.assetid: 70d989f8-ef34-4ad7-8fe0-5b800556b2a1 > 'program' : return code 'value' +## Remarks + The given command or program called by NMAKE failed and returned the given exit code. To suppress this error and continue the NMAKE session, use the /I option, the **.IGNORE** dot directive, or the dash (**-**) command modifier. To continue the NMAKE session for unrelated parts of the dependency tree, use the /K option. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md index 970cac7825a..f4ccb2efd93 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md @@ -10,6 +10,8 @@ ms.assetid: 24087955-9362-4ddf-9966-e0de43ea4647 > constant overflow at 'expression' +## Remarks + The given expression contained a constant that exceeded the range - 2,147,483,648 to 2,147,483,647. The constant appeared in one of the following situations: - An expression specified with a preprocessing directive diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md index 22b8b100ad1..29469713349 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md @@ -10,4 +10,6 @@ ms.assetid: b09bc34d-35d5-4676-b000-fd7d434400d9 > target macro 'target' expands to nothing +## Remarks + The given target is an invocation of a macro that has not been defined or has a null value. NMAKE cannot process a null target. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md index ed6b67e1575..c961700326b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md @@ -10,6 +10,8 @@ ms.assetid: 6d3cd68a-ead6-4a6d-a205-01324785de7e > inference rule cannot have dependents +## Remarks + The colon (**:**) in an inference rule must be followed by one of these: - Newline character diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md index 012818bf9df..b4c31811b99 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md @@ -10,6 +10,8 @@ ms.assetid: 5236ab54-e117-484d-99c3-852b061fd3d0 > cannot have : and :: dependents for same target +## Remarks + A target cannot be specified in both a single-colon (**:**) and a double-colon (`::`) dependency. To specify a target in multiple description blocks, use `::` in each dependency line. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md index c81d1443aff..0039978c5f4 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md @@ -10,4 +10,6 @@ ms.assetid: 75f3527b-9923-408b-a66e-701322c63803 > invalid separator '::' on inference rule +## Remarks + An inference rule must be followed by a single colon (**:**). diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md index e4963638ab0..6074ec8c661 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md @@ -10,6 +10,8 @@ ms.assetid: a392582b-06db-4568-9c13-450293a4fbda > expanded command line 'commandline' too long +## Remarks + After macro expansion, the given command line exceeded the limit on length of command lines for the operating system. MS-DOS permits up to 128 characters on a command line. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md index 7af6662b8df..bef2695a84b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md @@ -10,4 +10,6 @@ ms.assetid: dc6868b3-8425-4920-858a-774ad0c4c5f1 > filename-parts syntax requires dependent +## Remarks + The current dependency does not have either an explicit dependent or an implicit dependent. Filename-parts syntax, which uses the percent (`%`) specifier, represents components of the first dependent of the current target. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md index 285e21816b2..0ea73b2e524 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md @@ -10,6 +10,8 @@ ms.assetid: 6688a805-43e6-4247-a2d0-14be082f0b13 > stack overflow +## Remarks + The makefile being processed was too complex for the current stack allocation in NMAKE. NMAKE has an allocation of 0x3000 (12K). To increase NMAKE's stack allocation, run the [editbin /stack](../../build/reference/stack.md) utility with a larger stack option: diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md index 497a02ea3dc..e1a552be313 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md @@ -10,6 +10,8 @@ ms.assetid: c71910a7-c581-4d9c-a38c-d2d557d56289 > macro '*macro-name*' is illegal in the context of batch rule '*rule-name*' +## Remarks + NMAKE generates this error when the command block of a batch-mode rule directly or indirectly references a special file macro that isn't `$<`. `$<` is the only allowed macro for batch-mode rules. From 7db853e75234590c0c98e4d79c832014d83649c0 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 9 Sep 2025 22:12:20 +0800 Subject: [PATCH 1153/1799] Update metadata for error references in range [U1000, U1100] --- docs/error-messages/tool-errors/nmake-fatal-error-u1000.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1001.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1007.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1023.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1033.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1034.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1035.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1036.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1045.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1050.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1051.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1052.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1055.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1056.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1059.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1064.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1065.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1070.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1071.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1073.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1076.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1077.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1078.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1083.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1086.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1087.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1088.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1095.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1097.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1099.md | 5 ++--- docs/error-messages/tool-errors/nmake-fatal-error-u1100.md | 1 - 31 files changed, 60 insertions(+), 91 deletions(-) diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md index 039dc8dfd0b..24a842f48bd 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1000" title: "NMAKE Fatal Error U1000" -ms.date: "08/27/2018" +description: "Learn more about: NMAKE Fatal Error U1000" +ms.date: 08/27/2018 f1_keywords: ["U1000"] helpviewer_keywords: ["U1000"] -ms.assetid: 49b9bd9e-f1bc-4b55-a171-c748e40b195e --- # NMAKE Fatal Error U1000 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md index cedf6501e14..08ea984cff1 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1001" title: "NMAKE Fatal Error U1001" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1001" +ms.date: 11/04/2016 f1_keywords: ["U1001"] helpviewer_keywords: ["U1001"] -ms.assetid: 5d7da559-6cbd-44d6-848c-aaf54cae0d1a --- # NMAKE Fatal Error U1001 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md index 68f56dd474e..60ea2b957f9 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1007" title: "NMAKE Fatal Error U1007" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1007" +ms.date: 11/04/2016 f1_keywords: ["U1007"] helpviewer_keywords: ["U1007"] -ms.assetid: 64fd78a6-5b27-4aa8-92ea-f1c55e6e5edd --- # NMAKE Fatal Error U1007 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md index 8fff6bd8570..9588301e045 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1023" title: "NMAKE Fatal Error U1023" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1023" +ms.date: 11/04/2016 f1_keywords: ["U1023"] helpviewer_keywords: ["U1023"] -ms.assetid: 22d4c469-85da-43ee-86d1-171b1b99217d --- # NMAKE Fatal Error U1023 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md index 2a0678fb12d..ddb90f3b15f 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1033" title: "NMAKE Fatal Error U1033" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1033" +ms.date: 11/04/2016 f1_keywords: ["U1033"] helpviewer_keywords: ["U1033"] -ms.assetid: c146f7b5-7d5c-4329-a522-28a648546016 --- # NMAKE Fatal Error U1033 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md index c85a0f8320b..038db41936b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1034" title: "NMAKE Fatal Error U1034" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1034" +ms.date: 11/04/2016 f1_keywords: ["U1034"] helpviewer_keywords: ["U1034"] -ms.assetid: 27e678c2-23e2-4247-87f7-66493784af33 --- # NMAKE Fatal Error U1034 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md index c1326ab739f..3b552b7199a 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1035" title: "NMAKE Fatal Error U1035" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1035" +ms.date: 11/04/2016 f1_keywords: ["U1035"] helpviewer_keywords: ["U1035"] -ms.assetid: 68f0cc59-007e-4109-ac30-7ac4ac447e6d --- # NMAKE Fatal Error U1035 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md index 144869996d7..23cb6149762 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1036" title: "NMAKE Fatal Error U1036" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1036" +ms.date: 11/04/2016 f1_keywords: ["U1036"] helpviewer_keywords: ["U1036"] -ms.assetid: b1d03b6b-ce82-4bbb-9904-d392ba72b437 --- # NMAKE Fatal Error U1036 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md index 3ff98d9c40b..28278195d4d 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1045" title: "NMAKE Fatal Error U1045" -ms.date: "08/11/2019" +description: "Learn more about: NMAKE Fatal Error U1045" +ms.date: 08/11/2019 f1_keywords: ["U1045"] helpviewer_keywords: ["U1045"] -ms.assetid: dc70d162-14b9-4107-9237-7514044d72e3 --- # NMAKE Fatal Error U1045 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md index 6eec314e28b..a1e59028650 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1050" title: "NMAKE Fatal Error U1050" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1050" +ms.date: 11/04/2016 f1_keywords: ["U1050"] helpviewer_keywords: ["U1050"] -ms.assetid: 3bb2937e-a804-4592-a9e6-afb63360f554 --- # NMAKE Fatal Error U1050 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md index 0b211637712..14d5188d58a 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1051" title: "NMAKE Fatal Error U1051" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1051" +ms.date: 11/04/2016 f1_keywords: ["U1051"] helpviewer_keywords: ["U1051"] -ms.assetid: fede5cd5-dac3-47b7-b86d-e1acfb78699f --- # NMAKE Fatal Error U1051 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md index 8d026e4dbe5..3a75ff6737c 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1052" title: "NMAKE Fatal Error U1052" -ms.date: "09/05/2018" +description: "Learn more about: NMAKE Fatal Error U1052" +ms.date: 09/05/2018 f1_keywords: ["U1052"] helpviewer_keywords: ["U1052"] -ms.assetid: b19b3691-e60b-46bd-8822-8426740a9bc7 --- # NMAKE Fatal Error U1052 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md index a13aa238130..de37ff89129 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1055" title: "NMAKE Fatal Error U1055" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1055" +ms.date: 11/04/2016 f1_keywords: ["U1055"] helpviewer_keywords: ["U1055"] -ms.assetid: 1d453922-ba7e-497f-a795-d8d959c40555 --- # NMAKE Fatal Error U1055 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md index 3f3dac64535..06285d3dc4d 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1056" title: "NMAKE Fatal Error U1056" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1056" +ms.date: 11/04/2016 f1_keywords: ["U1056"] helpviewer_keywords: ["U1056"] -ms.assetid: da855728-b69e-413c-83ed-df912126215e --- # NMAKE Fatal Error U1056 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md index 9e8697a85ff..2918a3f6507 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1059" title: "NMAKE Fatal Error U1059" -ms.date: "08/27/2018" +description: "Learn more about: NMAKE Fatal Error U1059" +ms.date: 08/27/2018 f1_keywords: ["U1059"] helpviewer_keywords: ["U1059"] -ms.assetid: b21d9198-9c63-40d0-b589-80e17294ce24 --- # NMAKE Fatal Error U1059 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md index 96ddd1ae9dc..79fe444306d 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1064" title: "NMAKE Fatal Error U1064" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1064" +ms.date: 11/04/2016 f1_keywords: ["U1064"] helpviewer_keywords: ["U1064"] -ms.assetid: 7141e66e-cde6-4173-84df-a391f3ebcdd1 --- # NMAKE Fatal Error U1064 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md index 2fd0d897d65..77762393f2b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1065" title: "NMAKE Fatal Error U1065" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1065" +ms.date: 11/04/2016 f1_keywords: ["U1065"] helpviewer_keywords: ["U1065"] -ms.assetid: bc890f20-ff46-4073-ab3b-4a5db879f9bd --- # NMAKE Fatal Error U1065 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md index 2103f050f93..b2691ac1dfa 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1070" title: "NMAKE Fatal Error U1070" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1070" +ms.date: 11/04/2016 f1_keywords: ["U1070"] helpviewer_keywords: ["U1070"] -ms.assetid: 8639fc39-b4b1-48f5-ac91-0e9fb61680fd --- # NMAKE Fatal Error U1070 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md index f78bba9d4fa..1f2a4cedcee 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1071" title: "NMAKE Fatal Error U1071" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1071" +ms.date: 11/04/2016 f1_keywords: ["U1071"] helpviewer_keywords: ["U1071"] -ms.assetid: 328a0c1f-a867-410e-943d-7b6b75a975ab --- # NMAKE Fatal Error U1071 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md index 5dba7d8011f..84cb579e0ce 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1073" title: "NMAKE Fatal Error U1073" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1073" +ms.date: 11/04/2016 f1_keywords: ["U1073"] helpviewer_keywords: ["U1073"] -ms.assetid: d46bf2dd-400a-4802-9db2-f832e1c97f02 --- # NMAKE Fatal Error U1073 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md index 21e4b315505..5015af36911 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1076" title: "NMAKE Fatal Error U1076" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1076" +ms.date: 11/04/2016 f1_keywords: ["U1076"] helpviewer_keywords: ["U1076"] -ms.assetid: f8a6c646-0c49-4ee3-bb74-ab916a7aa6ff --- # NMAKE Fatal Error U1076 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md index c3a0719f1ff..cf389cf8dd7 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1077" title: "NMAKE Fatal Error U1077" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1077" +ms.date: 11/04/2016 f1_keywords: ["U1077"] helpviewer_keywords: ["U1077"] -ms.assetid: 70d989f8-ef34-4ad7-8fe0-5b800556b2a1 --- # NMAKE Fatal Error U1077 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md index f4ccb2efd93..ee1e637a341 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1078" title: "NMAKE Fatal Error U1078" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1078" +ms.date: 11/04/2016 f1_keywords: ["U1078"] helpviewer_keywords: ["U1078"] -ms.assetid: 24087955-9362-4ddf-9966-e0de43ea4647 --- # NMAKE Fatal Error U1078 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md index 29469713349..22be01d0e95 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1083" title: "NMAKE Fatal Error U1083" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1083" +ms.date: 11/04/2016 f1_keywords: ["U1083"] helpviewer_keywords: ["U1083"] -ms.assetid: b09bc34d-35d5-4676-b000-fd7d434400d9 --- # NMAKE Fatal Error U1083 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md index c961700326b..4705fc28e11 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1086" title: "NMAKE Fatal Error U1086" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1086" +ms.date: 11/04/2016 f1_keywords: ["U1086"] helpviewer_keywords: ["U1086"] -ms.assetid: 6d3cd68a-ead6-4a6d-a205-01324785de7e --- # NMAKE Fatal Error U1086 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md index b4c31811b99..7082f6c6d19 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1087" title: "NMAKE Fatal Error U1087" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1087" +ms.date: 11/04/2016 f1_keywords: ["U1087"] helpviewer_keywords: ["U1087"] -ms.assetid: 5236ab54-e117-484d-99c3-852b061fd3d0 --- # NMAKE Fatal Error U1087 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md index 0039978c5f4..5f62fb6e7af 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1088" title: "NMAKE Fatal Error U1088" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1088" +ms.date: 11/04/2016 f1_keywords: ["U1088"] helpviewer_keywords: ["U1088"] -ms.assetid: 75f3527b-9923-408b-a66e-701322c63803 --- # NMAKE Fatal Error U1088 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md index 6074ec8c661..87e702a9d06 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1095" title: "NMAKE Fatal Error U1095" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1095" +ms.date: 11/04/2016 f1_keywords: ["U1095"] helpviewer_keywords: ["U1095"] -ms.assetid: a392582b-06db-4568-9c13-450293a4fbda --- # NMAKE Fatal Error U1095 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md index bef2695a84b..7c9958d77e2 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1097" title: "NMAKE Fatal Error U1097" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1097" +ms.date: 11/04/2016 f1_keywords: ["U1097"] helpviewer_keywords: ["U1097"] -ms.assetid: dc6868b3-8425-4920-858a-774ad0c4c5f1 --- # NMAKE Fatal Error U1097 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md index 0ea73b2e524..d2645925c72 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Fatal Error U1099" title: "NMAKE Fatal Error U1099" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1099" +ms.date: 11/04/2016 f1_keywords: ["U1099"] helpviewer_keywords: ["U1099"] -ms.assetid: 6688a805-43e6-4247-a2d0-14be082f0b13 --- # NMAKE Fatal Error U1099 diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md index e1a552be313..4ae01cd7b7e 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md @@ -4,7 +4,6 @@ description: "A description of the causes of Microsoft NMAKE fatal error U1100." ms.date: 07/17/2020 f1_keywords: ["U1100"] helpviewer_keywords: ["U1100"] -ms.assetid: c71910a7-c581-4d9c-a38c-d2d557d56289 --- # NMAKE Fatal Error U1100 From 453dc40afd8602834b44741cdf173a50919bbff6 Mon Sep 17 00:00:00 2001 From: Carsten Rudolph <18394207+crud89@users.noreply.github.com> Date: Tue, 9 Sep 2025 17:42:48 +0200 Subject: [PATCH 1154/1799] Fix `environment` name. --- docs/build/cmake-presets-vs.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index 1706bdbbe17..5d99333e4c8 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -205,14 +205,14 @@ The official [CMake documentation](https://cmake.org/cmake/help/latest/manual/cm ### Select your compilers -You can set C and C++ compilers by using `environmentVariables.CC` and `environmentVariables.CXX` in a Configure Preset. For more information, see [`CC`](https://cmake.org/cmake/help/latest/envvar/CC.html)/[`CXX`](https://cmake.org/cmake/help/latest/envvar/CXX.html). +You can set C and C++ compilers by using `environment.CC` and `environment.CXX` in a Configure Preset. For more information, see [`CC`](https://cmake.org/cmake/help/latest/envvar/CC.html)/[`CXX`](https://cmake.org/cmake/help/latest/envvar/CXX.html). Use the following examples to build with `cl.exe` and `clang-cl.exe` from Visual Studio. The C++ Clang tools for Windows components must be installed for you to build with `clang-cl`. Build with `cl.exe`: ```json -"environmentVariables": { +"environment": { "CC": "cl", "CXX": "cl" }, @@ -225,7 +225,7 @@ Build with `cl.exe`: Build with `clang`: ```json -"environmentVariables": { +"environment": { "CC": "clang-cl", "CXX": "clang-cl" }, @@ -268,7 +268,7 @@ To reproduce these builds outside Visual Studio, see [Run CMake from the command To build on Linux or without the Visual C++ toolset, specify the name of a compiler on your `PATH` instance, or an environment variable that evaluates to the full path of a compiler. Full paths are discouraged so that the file can remain shareable. A preset that builds with GCC version 8 might look like this: ```json -"environmentVariables": { +"environment": { "CC": "gcc-8", "CXX": "g++-8" }, From d94e023b0f8e6603c51f6a0ffbb7dd1e6f3956f4 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 9 Sep 2025 17:47:42 -0700 Subject: [PATCH 1155/1799] intro github copilot --- docs/build/vscpp-step-0-installation.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/docs/build/vscpp-step-0-installation.md b/docs/build/vscpp-step-0-installation.md index 5ce61195dc8..b5751335727 100644 --- a/docs/build/vscpp-step-0-installation.md +++ b/docs/build/vscpp-step-0-installation.md @@ -1,13 +1,14 @@ --- title: Install C and C++ support in Visual Studio description: "Learn how to install Visual Studio with support for Microsoft C and C++ and related workloads." -ms.date: 03/18/2025 +ms.date: 09/09/2025 ms.topic: tutorial ms.devlang: "cpp" ms.custom: - vs-acquisition - intro-installation - sfi-image-nochange + - copilot-scenario-highlight --- # Install C and C++ support in Visual Studio @@ -114,6 +115,21 @@ You can reduce the installation footprint of Visual Studio on your system drive. 1. Visual Studio opens your new project, and you're ready to code! +### Step 9 - Learn how to use GitHub Copilot + +You can use GitHub Copilot in Visual Studio to help with your C++ development. Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. + +Some benefits of using Copilot for your C++ coding scenarios: +- Generate entire C++ functions or classes as you type. +- Suggest code completions based on plain-language comments or prompts. +- Get help with complex algorithms, data structures, and standard library usage. +- Learn new APIs and modern C++ patterns through in-context examples. +- Receive context-aware suggestions based on your comments or code. +- Debug errors in your code. +- Simplify and refactor existing code. + +To get started, see [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states). + ::: moniker-end ::: moniker range="msvc-160" From de4b076175bc621e53848d250a3d4312cd3b66fc Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 9 Sep 2025 18:07:11 -0700 Subject: [PATCH 1156/1799] edit --- docs/build/vscpp-step-0-installation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/vscpp-step-0-installation.md b/docs/build/vscpp-step-0-installation.md index b5751335727..0a5311c1fd1 100644 --- a/docs/build/vscpp-step-0-installation.md +++ b/docs/build/vscpp-step-0-installation.md @@ -115,7 +115,7 @@ You can reduce the installation footprint of Visual Studio on your system drive. 1. Visual Studio opens your new project, and you're ready to code! -### Step 9 - Learn how to use GitHub Copilot +### Step 9 - Install GitHub Copilot You can use GitHub Copilot in Visual Studio to help with your C++ development. Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. @@ -128,7 +128,7 @@ Some benefits of using Copilot for your C++ coding scenarios: - Debug errors in your code. - Simplify and refactor existing code. -To get started, see [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states). +To install GitHub Copilot, see [Manage GitHub Copilot installation and state](/visualstudio/ide/visual-studio-github-copilot-install-and-states). ::: moniker-end From 8d8aa5a4e6e47a726a3154a1c76c4585fba514d9 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 17:13:49 +0800 Subject: [PATCH 1157/1799] Tweak C5072 "Example" section --- .../compiler-warnings/compiler-warning-c5072.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md index 0ae2c93e6f6..a58a4df49f8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md @@ -15,13 +15,17 @@ This warning occurs when you compile with [Address Sanitizer](../../sanitizers/a ## Example -The following command line generates warning `C5072`: +The following command line generates warning C5072: -```cpp - cl /fsanitize=address /EHsc test.cpp +```cmd +cl /fsanitize=address /EHsc test.cpp ``` -To fix it, have the compiler generate debug information by using a switch like [`/Zi`](../../build/reference/z7-zi-zi-debug-information-format.md#zi) or [`/Z7`](../../build/reference/z7-zi-zi-debug-information-format.md#z7), like this: `cl /fsanitize=address /EHsc /Zi test.cpp` +To fix it, have the compiler generate debug information by using a switch like [`/Zi`](../../build/reference/z7-zi-zi-debug-information-format.md#zi) or [`/Z7`](../../build/reference/z7-zi-zi-debug-information-format.md#z7), like this: + +```cmd +cl /fsanitize=address /EHsc /Zi test.cpp +``` ## See also From ac5ba4887004cba6311788cfe6f56c5ec1e73c2d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 17:15:43 +0800 Subject: [PATCH 1158/1799] Update `ms.date` metadata in C5072 warning reference --- docs/error-messages/compiler-warnings/compiler-warning-c5072.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md index a58a4df49f8..ad186122f61 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md @@ -1,7 +1,7 @@ --- title: "Compiler Warning (level 1) C5072" description: "Learn more about: Compiler Warning (level 1) C5072" -ms.date: 02/09/2024 +ms.date: 09/10/2025 f1_keywords: ["C5072"] helpviewer_keywords: ["C5072"] --- From d9cfa54d118f44ea6c7027499b8bde301d896ec1 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 17:32:27 +0800 Subject: [PATCH 1159/1799] Add blockquotes for warning messages in range [U4001, U4011] --- docs/error-messages/tool-errors/nmake-warning-u4004.md | 2 +- docs/error-messages/tool-errors/nmake-warning-u4006.md | 2 +- docs/error-messages/tool-errors/nmake-warning-u4007.md | 2 +- docs/error-messages/tool-errors/nmake-warning-u4010.md | 2 +- docs/error-messages/tool-errors/nmake-warning-u4011.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/error-messages/tool-errors/nmake-warning-u4004.md b/docs/error-messages/tool-errors/nmake-warning-u4004.md index 4ab084062d1..00b4b886686 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4004.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4004.md @@ -8,7 +8,7 @@ ms.assetid: 5086bbcb-42d7-4677-a877-1a02202a86a2 --- # NMAKE Warning U4004 -too many rules for target 'targetname' +> too many rules for target 'targetname' More than one description block was specified for the given target using single colons (**:**) as separators. NMAKE executed the commands in the first description block and ignored later blocks. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4006.md b/docs/error-messages/tool-errors/nmake-warning-u4006.md index 8ed54357ead..728ac53b418 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4006.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4006.md @@ -8,6 +8,6 @@ ms.assetid: 830ad63c-d454-47a3-840c-c272f29ef3d2 --- # NMAKE Warning U4006 -special macro undefined : 'macroname' +> special macro undefined : 'macroname' The given special macro name is undefined and expands to nothing. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4007.md b/docs/error-messages/tool-errors/nmake-warning-u4007.md index 15e4b79e462..092e8369650 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4007.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4007.md @@ -8,7 +8,7 @@ ms.assetid: 61ec0417-6961-43c1-ade8-f9d6e93289e9 --- # NMAKE Warning U4007 -filename 'filename' too long; truncating to 8.3 +> filename 'filename' too long; truncating to 8.3 The base name of the given file has more than eight characters, or the extension has more than three characters. NMAKE truncated the name to an eight-character base and a three-character extension. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4010.md b/docs/error-messages/tool-errors/nmake-warning-u4010.md index 99cc38a56ff..205a12ff706 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4010.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4010.md @@ -8,7 +8,7 @@ ms.assetid: 99d8eb9a-ae31-40d1-b8c5-8c66732127d3 --- # NMAKE Warning U4010 -'target' : build failed; /K specified, continuing ... +> 'target' : build failed; /K specified, continuing ... A command in the commands block for the given target returned a nonzero exit code. The /K option told NMAKE to continue processing unrelated parts of the build and to issue an exit code 1 when the NMAKE session is finished. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4011.md b/docs/error-messages/tool-errors/nmake-warning-u4011.md index cde7c27e7d4..9aca4474910 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4011.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4011.md @@ -8,7 +8,7 @@ ms.assetid: e8244514-eba6-4285-8853-7baeefdcd8a4 --- # NMAKE Warning U4011 -'target' : not all dependents available; target not built +> 'target' : not all dependents available; target not built A dependent of the given target either did not exist or was out-of-date, and a command for updating the dependent returned a nonzero exit code. The /K option told NMAKE to continue processing unrelated parts of the build and to issue an exit code 1 when the NMAKE session is finished. From 5103e112f52ae0bcffcc65780aecf2002b9a8387 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 17:33:58 +0800 Subject: [PATCH 1160/1799] Add "Remarks" headings for warning references in range [U4001, U4011] --- docs/error-messages/tool-errors/nmake-warning-u4001.md | 2 ++ docs/error-messages/tool-errors/nmake-warning-u4004.md | 2 ++ docs/error-messages/tool-errors/nmake-warning-u4006.md | 2 ++ docs/error-messages/tool-errors/nmake-warning-u4007.md | 2 ++ docs/error-messages/tool-errors/nmake-warning-u4010.md | 2 ++ docs/error-messages/tool-errors/nmake-warning-u4011.md | 2 ++ 6 files changed, 12 insertions(+) diff --git a/docs/error-messages/tool-errors/nmake-warning-u4001.md b/docs/error-messages/tool-errors/nmake-warning-u4001.md index 950ef74f800..fa9c66d5b0c 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4001.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4001.md @@ -10,4 +10,6 @@ ms.assetid: ed3b4068-2ad8-4ffc-b7c7-33897d2a55d7 > command file can be invoked only from command line +## Remarks + A command file, which is invoked by the at sign (**\@**) specifier, cannot contain a specification for another command file. Such nesting is not allowed. The specification was ignored. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4004.md b/docs/error-messages/tool-errors/nmake-warning-u4004.md index 00b4b886686..a90e24f5671 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4004.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4004.md @@ -10,6 +10,8 @@ ms.assetid: 5086bbcb-42d7-4677-a877-1a02202a86a2 > too many rules for target 'targetname' +## Remarks + More than one description block was specified for the given target using single colons (**:**) as separators. NMAKE executed the commands in the first description block and ignored later blocks. To specify the same target in multiple dependencies, use double colons (`::`) as the separator in each dependency line. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4006.md b/docs/error-messages/tool-errors/nmake-warning-u4006.md index 728ac53b418..5c84c82f4dc 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4006.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4006.md @@ -10,4 +10,6 @@ ms.assetid: 830ad63c-d454-47a3-840c-c272f29ef3d2 > special macro undefined : 'macroname' +## Remarks + The given special macro name is undefined and expands to nothing. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4007.md b/docs/error-messages/tool-errors/nmake-warning-u4007.md index 092e8369650..82e200adc37 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4007.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4007.md @@ -10,6 +10,8 @@ ms.assetid: 61ec0417-6961-43c1-ade8-f9d6e93289e9 > filename 'filename' too long; truncating to 8.3 +## Remarks + The base name of the given file has more than eight characters, or the extension has more than three characters. NMAKE truncated the name to an eight-character base and a three-character extension. If long filenames are supported by your file system, enclose the name in double quotation marks (**"**). diff --git a/docs/error-messages/tool-errors/nmake-warning-u4010.md b/docs/error-messages/tool-errors/nmake-warning-u4010.md index 205a12ff706..906908cba0a 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4010.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4010.md @@ -10,6 +10,8 @@ ms.assetid: 99d8eb9a-ae31-40d1-b8c5-8c66732127d3 > 'target' : build failed; /K specified, continuing ... +## Remarks + A command in the commands block for the given target returned a nonzero exit code. The /K option told NMAKE to continue processing unrelated parts of the build and to issue an exit code 1 when the NMAKE session is finished. If the given target is, itself, a dependent for another target, NMAKE issues warning [U4011](../../error-messages/tool-errors/nmake-warning-u4011.md) after this warning. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4011.md b/docs/error-messages/tool-errors/nmake-warning-u4011.md index 9aca4474910..65164253c36 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4011.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4011.md @@ -10,6 +10,8 @@ ms.assetid: e8244514-eba6-4285-8853-7baeefdcd8a4 > 'target' : not all dependents available; target not built +## Remarks + A dependent of the given target either did not exist or was out-of-date, and a command for updating the dependent returned a nonzero exit code. The /K option told NMAKE to continue processing unrelated parts of the build and to issue an exit code 1 when the NMAKE session is finished. This warning is preceded by warning [U4010](../../error-messages/tool-errors/nmake-warning-u4010.md) for each dependent that failed to be created or updated. From 093c1037001553ee7e051929ce422a11b4bf42fc Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 17:35:41 +0800 Subject: [PATCH 1161/1799] Update metadata for warning references in range [U4001, U4011] --- docs/error-messages/tool-errors/nmake-warning-u4001.md | 5 ++--- docs/error-messages/tool-errors/nmake-warning-u4004.md | 5 ++--- docs/error-messages/tool-errors/nmake-warning-u4006.md | 5 ++--- docs/error-messages/tool-errors/nmake-warning-u4007.md | 5 ++--- docs/error-messages/tool-errors/nmake-warning-u4010.md | 5 ++--- docs/error-messages/tool-errors/nmake-warning-u4011.md | 5 ++--- 6 files changed, 12 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/tool-errors/nmake-warning-u4001.md b/docs/error-messages/tool-errors/nmake-warning-u4001.md index fa9c66d5b0c..a23091484ad 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4001.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Warning U4001" title: "NMAKE Warning U4001" -ms.date: "09/05/2018" +description: "Learn more about: NMAKE Warning U4001" +ms.date: 09/05/2018 f1_keywords: ["U4001"] helpviewer_keywords: ["U4001"] -ms.assetid: ed3b4068-2ad8-4ffc-b7c7-33897d2a55d7 --- # NMAKE Warning U4001 diff --git a/docs/error-messages/tool-errors/nmake-warning-u4004.md b/docs/error-messages/tool-errors/nmake-warning-u4004.md index a90e24f5671..93f0ea200fe 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4004.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Warning U4004" title: "NMAKE Warning U4004" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4004" +ms.date: 11/04/2016 f1_keywords: ["U4004"] helpviewer_keywords: ["U4004"] -ms.assetid: 5086bbcb-42d7-4677-a877-1a02202a86a2 --- # NMAKE Warning U4004 diff --git a/docs/error-messages/tool-errors/nmake-warning-u4006.md b/docs/error-messages/tool-errors/nmake-warning-u4006.md index 5c84c82f4dc..7a0b31901f0 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4006.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4006.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Warning U4006" title: "NMAKE Warning U4006" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4006" +ms.date: 11/04/2016 f1_keywords: ["U4006"] helpviewer_keywords: ["U4006"] -ms.assetid: 830ad63c-d454-47a3-840c-c272f29ef3d2 --- # NMAKE Warning U4006 diff --git a/docs/error-messages/tool-errors/nmake-warning-u4007.md b/docs/error-messages/tool-errors/nmake-warning-u4007.md index 82e200adc37..392d4529ecd 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4007.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4007.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Warning U4007" title: "NMAKE Warning U4007" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4007" +ms.date: 11/04/2016 f1_keywords: ["U4007"] helpviewer_keywords: ["U4007"] -ms.assetid: 61ec0417-6961-43c1-ade8-f9d6e93289e9 --- # NMAKE Warning U4007 diff --git a/docs/error-messages/tool-errors/nmake-warning-u4010.md b/docs/error-messages/tool-errors/nmake-warning-u4010.md index 906908cba0a..44fa515eee6 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4010.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4010.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Warning U4010" title: "NMAKE Warning U4010" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4010" +ms.date: 11/04/2016 f1_keywords: ["U4010"] helpviewer_keywords: ["U4010"] -ms.assetid: 99d8eb9a-ae31-40d1-b8c5-8c66732127d3 --- # NMAKE Warning U4010 diff --git a/docs/error-messages/tool-errors/nmake-warning-u4011.md b/docs/error-messages/tool-errors/nmake-warning-u4011.md index 65164253c36..9e8040a5f54 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4011.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4011.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: NMAKE Warning U4011" title: "NMAKE Warning U4011" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4011" +ms.date: 11/04/2016 f1_keywords: ["U4011"] helpviewer_keywords: ["U4011"] -ms.assetid: e8244514-eba6-4285-8853-7baeefdcd8a4 --- # NMAKE Warning U4011 From 4e492ee18f6b28ff92f695d966bc34b77d341bb2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 18:30:42 +0800 Subject: [PATCH 1162/1799] Update error message in C2033 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2033.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 87aaa08b7b5..5c6ac01b365 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2033"] --- # Compiler Error C2033 -> 'identifier' : bit field cannot have indirection +> '*identifier*': bit field cannot have indirection ## Remarks From 9be0d114b3b8d71d1399daf8f3009c2ed3039705 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 18:34:41 +0800 Subject: [PATCH 1163/1799] Augment remarks in C2033 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2033.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 5c6ac01b365..8f8642d5691 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C2033"] ## Remarks -The bit field was declared as a pointer, which is not allowed. +Bit fields can't be declared as a pointer, reference, or array. For more information, see [C++ Bit Fields](../../cpp/cpp-bit-fields.md). ## Example From cdaacdd0ebcd7c0c21f501826e402fcbdbf063f3 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 18:42:55 +0800 Subject: [PATCH 1164/1799] Overhaul example in C2033 error reference --- .../compiler-errors-1/compiler-error-c2033.md | 17 ++++++----------- 1 file changed, 6 insertions(+), 11 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 8f8642d5691..4114819b531 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -19,17 +19,12 @@ The following example generates C2033: ```cpp // C2033.cpp -struct S { - int *b : 1; // C2033 -}; -``` - -Possible resolution: - -```cpp -// C2033b.cpp // compile with: /c -struct S { - int b : 1; + +struct S +{ + int* ptr : 1; // C2033 + int& ref : 1; // C2033 + int arr[3] : 1; // C2033 }; ``` From 98d1599b872de4fd420d1776bec9fa9a2836707b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 18:45:47 +0800 Subject: [PATCH 1165/1799] Add C2531 "See also" link in C2033 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2033.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 4114819b531..f9dde57a5ea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -28,3 +28,7 @@ struct S int arr[3] : 1; // C2033 }; ``` + +## See also + +[Compiler Error C2531](../compiler-errors-2/compiler-error-c2531.md) From 297acdfbf0c2524e122c0b4ea10cf2f7f5a260e1 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 18:46:30 +0800 Subject: [PATCH 1166/1799] Update `ms.date` metadata in C2033 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2033.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index f9dde57a5ea..3af050bc1ef 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2033" description: "Learn more about: Compiler Error C2033" -ms.date: 11/04/2016 +ms.date: 09/10/2025 f1_keywords: ["C2033"] helpviewer_keywords: ["C2033"] --- From 9ef1f17614e3a0d587dd210e58137c55666fed9e Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 22:28:37 +0800 Subject: [PATCH 1167/1799] Add blockquotes for error messages in range [BK1503, BK1517] --- docs/error-messages/tool-errors/bscmake-error-bk1503.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1504.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1505.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1506.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1507.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1508.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1509.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1510.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1512.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1513.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1514.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1515.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1516.md | 2 +- docs/error-messages/tool-errors/bscmake-error-bk1517.md | 2 +- 14 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1503.md b/docs/error-messages/tool-errors/bscmake-error-bk1503.md index 64c12bd2413..b0b10522aee 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1503.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1503.md @@ -8,7 +8,7 @@ ms.assetid: e6582344-b91e-486f-baf3-4f9028d83c3b --- # BSCMAKE Error BK1503 -cannot write to file 'filename' [: reason] +> cannot write to file 'filename' [: reason] BSCMAKE combines the .sbr files generated during compilation into one browser database. If the resulting browser database exceeds 64 MB, or if the number of input (.sbr) files exceeds 4092, this error will be emitted. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1504.md b/docs/error-messages/tool-errors/bscmake-error-bk1504.md index ec37c7671e0..87fbd11e80e 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1504.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1504.md @@ -8,7 +8,7 @@ ms.assetid: e6d1a171-1472-4b7e-a04b-1a68a561675f --- # BSCMAKE Error BK1504 -cannot position in file 'filename' [: reason] +> cannot position in file 'filename' [: reason] BSCMAKE could not move to a location in the file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1505.md b/docs/error-messages/tool-errors/bscmake-error-bk1505.md index 5d63471bec0..7d13d03fd06 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1505.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1505.md @@ -8,7 +8,7 @@ ms.assetid: a25765f8-e950-4ca8-9f16-419d779e2744 --- # BSCMAKE Error BK1505 -cannot read from file 'filename' [: reason] +> cannot read from file 'filename' [: reason] BSCMAKE cannot read from the file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1506.md b/docs/error-messages/tool-errors/bscmake-error-bk1506.md index 158a93e679f..cd5e7f6469d 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1506.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1506.md @@ -8,7 +8,7 @@ ms.assetid: f51f8cea-f8fc-4323-bcf2-b7bd119792ee --- # BSCMAKE Error BK1506 -cannot open file 'filename' [: reason] +> cannot open file 'filename' [: reason] BSCMAKE cannot open the file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1507.md b/docs/error-messages/tool-errors/bscmake-error-bk1507.md index 6ad648f99d8..f6a9c98c8bc 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1507.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1507.md @@ -8,7 +8,7 @@ ms.assetid: 3c5220d7-ccb3-45b4-9da0-cb06147311f6 --- # BSCMAKE Error BK1507 -cannot open temporary file 'filename' [: reason] +> cannot open temporary file 'filename' [: reason] BSCMAKE cannot open a temporary file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1508.md b/docs/error-messages/tool-errors/bscmake-error-bk1508.md index 1e278052eca..6ea5ca37af8 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1508.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1508.md @@ -8,7 +8,7 @@ ms.assetid: 03ea22b8-c7b4-4e73-8553-35b41112e066 --- # BSCMAKE Error BK1508 -cannot delete temporary file 'filename' [: reason] +> cannot delete temporary file 'filename' [: reason] BSCMAKE cannot delete one of its temporary files. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1509.md b/docs/error-messages/tool-errors/bscmake-error-bk1509.md index c998612a2ef..a2152631863 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1509.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1509.md @@ -8,7 +8,7 @@ ms.assetid: 53df7037-1913-4b63-b425-c0bf44081792 --- # BSCMAKE Error BK1509 -out of heap space +> out of heap space BSCMAKE ran out of memory, including virtual memory. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1510.md b/docs/error-messages/tool-errors/bscmake-error-bk1510.md index c4ec735b4ff..0c1fb6ae61a 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1510.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1510.md @@ -8,6 +8,6 @@ ms.assetid: e67290c0-58cf-44da-ad01-f8dffc34ea2d --- # BSCMAKE Error BK1510 -corrupt .SBR file filename +> corrupt .SBR file filename The given .sbr file does not have the expected format. Recompile to create a new .sbr. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1512.md b/docs/error-messages/tool-errors/bscmake-error-bk1512.md index 0b701544058..bd67fa388c9 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1512.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1512.md @@ -8,7 +8,7 @@ ms.assetid: 0a626ff3-63db-4797-abe4-31545ce2c2c1 --- # BSCMAKE Error BK1512 -filename: capacity exceeded +> filename: capacity exceeded BSCMAKE cannot build a browse information file because the number of definitions, references, modules, or other information exceeds the limit. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1513.md b/docs/error-messages/tool-errors/bscmake-error-bk1513.md index 0ebe59771f8..bfa7be4b8b6 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1513.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1513.md @@ -8,7 +8,7 @@ ms.assetid: 9ba87c09-8d82-4c80-b0cf-a8de63dcf9da --- # BSCMAKE Error BK1513 -nonincremental update requires all .SBR files +> nonincremental update requires all .SBR files BSCMAKE cannot build a new browse information (.bsc) file because one or more .sbr files are truncated. To find the names of the truncated .sbr files, read the [BK4502](../../error-messages/tool-errors/bscmake-warning-bk4502.md) warnings that accompany this error. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1514.md b/docs/error-messages/tool-errors/bscmake-error-bk1514.md index ab008394b13..87d76815d0d 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1514.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1514.md @@ -8,7 +8,7 @@ ms.assetid: 7c7e2504-a490-44ab-bb1f-47385ee2f4b0 --- # BSCMAKE Error BK1514 -all .SBR files truncated, none found in filename +> all .SBR files truncated, none found in filename None of the .sbr files specified for an update were part of the original browse information (.bsc) file. To find the names of the .sbr files that caused this error, read the [BK4502](../../error-messages/tool-errors/bscmake-warning-bk4502.md) warnings that precede it. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1515.md b/docs/error-messages/tool-errors/bscmake-error-bk1515.md index 23050c88db7..6ab9ef2fe3e 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1515.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1515.md @@ -8,6 +8,6 @@ ms.assetid: 4cf2aedb-10c4-4ae8-abe6-c681fd4d617d --- # BSCMAKE Error BK1515 -bscfile: incompatible version: cannot incrementally update +> bscfile: incompatible version: cannot incrementally update The .bsc file was created with another version of BSCMAKE. Recreate the .bsc file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1516.md b/docs/error-messages/tool-errors/bscmake-error-bk1516.md index a21e9704718..b0d58aa5c70 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1516.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1516.md @@ -8,6 +8,6 @@ ms.assetid: 7f4a8391-f857-4ee8-8e26-34868ca84e29 --- # BSCMAKE Error BK1516 -bscfile corrupt; cannot incrementally update +> bscfile corrupt; cannot incrementally update The .bsc file was corrupted, possibly due to a system failure during the build. Delete the .bsc file, rebuild all .sbr files, then rebuild the .bsc file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1517.md b/docs/error-messages/tool-errors/bscmake-error-bk1517.md index a8d301b2354..a5a42368437 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1517.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1517.md @@ -8,6 +8,6 @@ ms.assetid: 24391f42-0a3e-40a9-9991-c8b9a6a7b1c7 --- # BSCMAKE Error BK1517 -source file for sbrfile compiled with both /Yc and /Yu +> source file for sbrfile compiled with both /Yc and /Yu The .sbr file refers to itself. It was probably recompiled with /Yu after compiling with /Yc. Reset the compiler option for the source file to /Yc, then select **Rebuild** to generate new .sbr files. Do not recompile the source file with /Yu. From 3bc1c39aa449a51662b1cd6c4dd394060dea8d1e Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 22:31:17 +0800 Subject: [PATCH 1168/1799] Add "Remarks" headings for error references in range [BK1503, BK1517] --- docs/error-messages/tool-errors/bscmake-error-bk1503.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1504.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1505.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1506.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1507.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1508.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1509.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1510.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1512.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1513.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1514.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1515.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1516.md | 2 ++ docs/error-messages/tool-errors/bscmake-error-bk1517.md | 2 ++ 14 files changed, 28 insertions(+) diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1503.md b/docs/error-messages/tool-errors/bscmake-error-bk1503.md index b0b10522aee..fa4de8926db 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1503.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1503.md @@ -10,6 +10,8 @@ ms.assetid: e6582344-b91e-486f-baf3-4f9028d83c3b > cannot write to file 'filename' [: reason] +## Remarks + BSCMAKE combines the .sbr files generated during compilation into one browser database. If the resulting browser database exceeds 64 MB, or if the number of input (.sbr) files exceeds 4092, this error will be emitted. If the problem is caused by more than 4092 .sbr files, you must reduce the number of input files. From within Visual Studio, this can be accomplished by [/FR](../../build/reference/fr-fr-create-dot-sbr-file.md) your entire project, then recheck on a file by file basis. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1504.md b/docs/error-messages/tool-errors/bscmake-error-bk1504.md index 87fbd11e80e..18258e2f1fb 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1504.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1504.md @@ -10,6 +10,8 @@ ms.assetid: e6d1a171-1472-4b7e-a04b-1a68a561675f > cannot position in file 'filename' [: reason] +## Remarks + BSCMAKE could not move to a location in the file. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1505.md b/docs/error-messages/tool-errors/bscmake-error-bk1505.md index 7d13d03fd06..ff367451d40 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1505.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1505.md @@ -10,6 +10,8 @@ ms.assetid: a25765f8-e950-4ca8-9f16-419d779e2744 > cannot read from file 'filename' [: reason] +## Remarks + BSCMAKE cannot read from the file. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1506.md b/docs/error-messages/tool-errors/bscmake-error-bk1506.md index cd5e7f6469d..e1bd1941972 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1506.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1506.md @@ -10,6 +10,8 @@ ms.assetid: f51f8cea-f8fc-4323-bcf2-b7bd119792ee > cannot open file 'filename' [: reason] +## Remarks + BSCMAKE cannot open the file. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1507.md b/docs/error-messages/tool-errors/bscmake-error-bk1507.md index f6a9c98c8bc..bdd78507677 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1507.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1507.md @@ -10,6 +10,8 @@ ms.assetid: 3c5220d7-ccb3-45b4-9da0-cb06147311f6 > cannot open temporary file 'filename' [: reason] +## Remarks + BSCMAKE cannot open a temporary file. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1508.md b/docs/error-messages/tool-errors/bscmake-error-bk1508.md index 6ea5ca37af8..e37f52dd6e5 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1508.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1508.md @@ -10,6 +10,8 @@ ms.assetid: 03ea22b8-c7b4-4e73-8553-35b41112e066 > cannot delete temporary file 'filename' [: reason] +## Remarks + BSCMAKE cannot delete one of its temporary files. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1509.md b/docs/error-messages/tool-errors/bscmake-error-bk1509.md index a2152631863..7a1a95c6779 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1509.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1509.md @@ -10,6 +10,8 @@ ms.assetid: 53df7037-1913-4b63-b425-c0bf44081792 > out of heap space +## Remarks + BSCMAKE ran out of memory, including virtual memory. ### To fix by using the following possible solutions diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1510.md b/docs/error-messages/tool-errors/bscmake-error-bk1510.md index 0c1fb6ae61a..4156ccee474 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1510.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1510.md @@ -10,4 +10,6 @@ ms.assetid: e67290c0-58cf-44da-ad01-f8dffc34ea2d > corrupt .SBR file filename +## Remarks + The given .sbr file does not have the expected format. Recompile to create a new .sbr. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1512.md b/docs/error-messages/tool-errors/bscmake-error-bk1512.md index bd67fa388c9..23518ac2de8 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1512.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1512.md @@ -10,6 +10,8 @@ ms.assetid: 0a626ff3-63db-4797-abe4-31545ce2c2c1 > filename: capacity exceeded +## Remarks + BSCMAKE cannot build a browse information file because the number of definitions, references, modules, or other information exceeds the limit. ### To fix by using the following possible solutions diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1513.md b/docs/error-messages/tool-errors/bscmake-error-bk1513.md index bfa7be4b8b6..a2229119de8 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1513.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1513.md @@ -10,6 +10,8 @@ ms.assetid: 9ba87c09-8d82-4c80-b0cf-a8de63dcf9da > nonincremental update requires all .SBR files +## Remarks + BSCMAKE cannot build a new browse information (.bsc) file because one or more .sbr files are truncated. To find the names of the truncated .sbr files, read the [BK4502](../../error-messages/tool-errors/bscmake-warning-bk4502.md) warnings that accompany this error. BSCMAKE can update a .bsc file with a truncated .sbr file but cannot build a new one. BSCMAKE may build a new .bsc file for the following reasons: diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1514.md b/docs/error-messages/tool-errors/bscmake-error-bk1514.md index 87d76815d0d..b4bb71e3a82 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1514.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1514.md @@ -10,6 +10,8 @@ ms.assetid: 7c7e2504-a490-44ab-bb1f-47385ee2f4b0 > all .SBR files truncated, none found in filename +## Remarks + None of the .sbr files specified for an update were part of the original browse information (.bsc) file. To find the names of the .sbr files that caused this error, read the [BK4502](../../error-messages/tool-errors/bscmake-warning-bk4502.md) warnings that precede it. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1515.md b/docs/error-messages/tool-errors/bscmake-error-bk1515.md index 6ab9ef2fe3e..09b9c770804 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1515.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1515.md @@ -10,4 +10,6 @@ ms.assetid: 4cf2aedb-10c4-4ae8-abe6-c681fd4d617d > bscfile: incompatible version: cannot incrementally update +## Remarks + The .bsc file was created with another version of BSCMAKE. Recreate the .bsc file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1516.md b/docs/error-messages/tool-errors/bscmake-error-bk1516.md index b0d58aa5c70..1e0d4bb2db5 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1516.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1516.md @@ -10,4 +10,6 @@ ms.assetid: 7f4a8391-f857-4ee8-8e26-34868ca84e29 > bscfile corrupt; cannot incrementally update +## Remarks + The .bsc file was corrupted, possibly due to a system failure during the build. Delete the .bsc file, rebuild all .sbr files, then rebuild the .bsc file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1517.md b/docs/error-messages/tool-errors/bscmake-error-bk1517.md index a5a42368437..6e40aa445da 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1517.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1517.md @@ -10,4 +10,6 @@ ms.assetid: 24391f42-0a3e-40a9-9991-c8b9a6a7b1c7 > source file for sbrfile compiled with both /Yc and /Yu +## Remarks + The .sbr file refers to itself. It was probably recompiled with /Yu after compiling with /Yc. Reset the compiler option for the source file to /Yc, then select **Rebuild** to generate new .sbr files. Do not recompile the source file with /Yu. From e697cc38cb9cbb0be7cfb9fafae56d4da87ee1b1 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 10 Sep 2025 22:34:27 +0800 Subject: [PATCH 1169/1799] Update metadata for error references in range [BK1503, BK1517] --- docs/error-messages/tool-errors/bscmake-error-bk1503.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1504.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1505.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1506.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1507.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1508.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1509.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1510.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1512.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1513.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1514.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1515.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1516.md | 5 ++--- docs/error-messages/tool-errors/bscmake-error-bk1517.md | 5 ++--- 14 files changed, 28 insertions(+), 42 deletions(-) diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1503.md b/docs/error-messages/tool-errors/bscmake-error-bk1503.md index fa4de8926db..2a3e2f43d4e 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1503.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1503.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1503" title: "BSCMAKE Error BK1503" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1503" +ms.date: 11/04/2016 f1_keywords: ["BK1503"] helpviewer_keywords: ["BK1503"] -ms.assetid: e6582344-b91e-486f-baf3-4f9028d83c3b --- # BSCMAKE Error BK1503 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1504.md b/docs/error-messages/tool-errors/bscmake-error-bk1504.md index 18258e2f1fb..80c657373fe 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1504.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1504.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1504" title: "BSCMAKE Error BK1504" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1504" +ms.date: 11/04/2016 f1_keywords: ["BK1504"] helpviewer_keywords: ["BK1504"] -ms.assetid: e6d1a171-1472-4b7e-a04b-1a68a561675f --- # BSCMAKE Error BK1504 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1505.md b/docs/error-messages/tool-errors/bscmake-error-bk1505.md index ff367451d40..2b06a6fcb9b 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1505.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1505.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1505" title: "BSCMAKE Error BK1505" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1505" +ms.date: 11/04/2016 f1_keywords: ["BK1505"] helpviewer_keywords: ["BK1505"] -ms.assetid: a25765f8-e950-4ca8-9f16-419d779e2744 --- # BSCMAKE Error BK1505 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1506.md b/docs/error-messages/tool-errors/bscmake-error-bk1506.md index e1bd1941972..b95c897bc0a 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1506.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1506.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1506" title: "BSCMAKE Error BK1506" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1506" +ms.date: 11/04/2016 f1_keywords: ["BK1506"] helpviewer_keywords: ["BK1506"] -ms.assetid: f51f8cea-f8fc-4323-bcf2-b7bd119792ee --- # BSCMAKE Error BK1506 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1507.md b/docs/error-messages/tool-errors/bscmake-error-bk1507.md index bdd78507677..520aed46343 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1507.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1507.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1507" title: "BSCMAKE Error BK1507" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1507" +ms.date: 11/04/2016 f1_keywords: ["BK1507"] helpviewer_keywords: ["BK1507"] -ms.assetid: 3c5220d7-ccb3-45b4-9da0-cb06147311f6 --- # BSCMAKE Error BK1507 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1508.md b/docs/error-messages/tool-errors/bscmake-error-bk1508.md index e37f52dd6e5..123e73b57ce 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1508.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1508.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1508" title: "BSCMAKE Error BK1508" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1508" +ms.date: 11/04/2016 f1_keywords: ["BK1508"] helpviewer_keywords: ["BK1508"] -ms.assetid: 03ea22b8-c7b4-4e73-8553-35b41112e066 --- # BSCMAKE Error BK1508 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1509.md b/docs/error-messages/tool-errors/bscmake-error-bk1509.md index 7a1a95c6779..b25c7cf5d4a 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1509.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1509.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1509" title: "BSCMAKE Error BK1509" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1509" +ms.date: 11/04/2016 f1_keywords: ["BK1509"] helpviewer_keywords: ["BK1509"] -ms.assetid: 53df7037-1913-4b63-b425-c0bf44081792 --- # BSCMAKE Error BK1509 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1510.md b/docs/error-messages/tool-errors/bscmake-error-bk1510.md index 4156ccee474..59159959d58 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1510.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1510.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1510" title: "BSCMAKE Error BK1510" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1510" +ms.date: 11/04/2016 f1_keywords: ["BK1510"] helpviewer_keywords: ["BK1510"] -ms.assetid: e67290c0-58cf-44da-ad01-f8dffc34ea2d --- # BSCMAKE Error BK1510 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1512.md b/docs/error-messages/tool-errors/bscmake-error-bk1512.md index 23518ac2de8..912758c02a0 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1512.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1512.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1512" title: "BSCMAKE Error BK1512" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1512" +ms.date: 11/04/2016 f1_keywords: ["BK1512"] helpviewer_keywords: ["BK1512"] -ms.assetid: 0a626ff3-63db-4797-abe4-31545ce2c2c1 --- # BSCMAKE Error BK1512 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1513.md b/docs/error-messages/tool-errors/bscmake-error-bk1513.md index a2229119de8..c08f45b6cce 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1513.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1513.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1513" title: "BSCMAKE Error BK1513" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1513" +ms.date: 11/04/2016 f1_keywords: ["BK1513"] helpviewer_keywords: ["BK1513"] -ms.assetid: 9ba87c09-8d82-4c80-b0cf-a8de63dcf9da --- # BSCMAKE Error BK1513 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1514.md b/docs/error-messages/tool-errors/bscmake-error-bk1514.md index b4bb71e3a82..4ee5c208140 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1514.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1514.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1514" title: "BSCMAKE Error BK1514" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1514" +ms.date: 11/04/2016 f1_keywords: ["BK1514"] helpviewer_keywords: ["BK1514"] -ms.assetid: 7c7e2504-a490-44ab-bb1f-47385ee2f4b0 --- # BSCMAKE Error BK1514 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1515.md b/docs/error-messages/tool-errors/bscmake-error-bk1515.md index 09b9c770804..d0a082d2e7a 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1515.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1515.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1515" title: "BSCMAKE Error BK1515" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1515" +ms.date: 11/04/2016 f1_keywords: ["BK1515"] helpviewer_keywords: ["BK1515"] -ms.assetid: 4cf2aedb-10c4-4ae8-abe6-c681fd4d617d --- # BSCMAKE Error BK1515 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1516.md b/docs/error-messages/tool-errors/bscmake-error-bk1516.md index 1e0d4bb2db5..2b9fce5d192 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1516.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1516.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1516" title: "BSCMAKE Error BK1516" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1516" +ms.date: 11/04/2016 f1_keywords: ["BK1516"] helpviewer_keywords: ["BK1516"] -ms.assetid: 7f4a8391-f857-4ee8-8e26-34868ca84e29 --- # BSCMAKE Error BK1516 diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1517.md b/docs/error-messages/tool-errors/bscmake-error-bk1517.md index 6e40aa445da..e4a4b9fa70f 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1517.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1517.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Error BK1517" title: "BSCMAKE Error BK1517" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1517" +ms.date: 11/04/2016 f1_keywords: ["BK1517"] helpviewer_keywords: ["BK1517"] -ms.assetid: 24391f42-0a3e-40a9-9991-c8b9a6a7b1c7 --- # BSCMAKE Error BK1517 From 302ada0520472d6fcd33a5cfbebc8b58208c784d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 11 Sep 2025 00:40:23 +0800 Subject: [PATCH 1170/1799] Convert Linker tools errors and warnings list into a table --- .../linker-tools-errors-and-warnings.md | 252 +++++++++--------- 1 file changed, 128 insertions(+), 124 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md index 2e90c8b062a..ae8a5f2791e 100644 --- a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md @@ -13,133 +13,137 @@ The linker tools LINK, LIB, DUMPBIN, and EDITBIN share a common executable that ## Linker tools errors -[Linker Tools Error LNK1000](../../error-messages/tool-errors/linker-tools-error-lnk1000.md) \ -[Linker Tools Error LNK1103](../../error-messages/tool-errors/linker-tools-error-lnk1103.md) \ -[Linker Tools Error LNK1104](../../error-messages/tool-errors/linker-tools-error-lnk1104.md) \ -[Linker Tools Error LNK1106](../../error-messages/tool-errors/linker-tools-error-lnk1106.md) \ -[Linker Tools Error LNK1107](../../error-messages/tool-errors/linker-tools-error-lnk1107.md) \ -[Linker Tools Error LNK1112](../../error-messages/tool-errors/linker-tools-error-lnk1112.md) \ -[Linker Tools Error LNK1113](../../error-messages/tool-errors/linker-tools-error-lnk1113.md) \ -[Linker Tools Error LNK1120](../../error-messages/tool-errors/linker-tools-error-lnk1120.md) \ -[Linker Tools Error LNK1123](../../error-messages/tool-errors/linker-tools-error-lnk1123.md) \ -[Linker Tools Error LNK1127](../../error-messages/tool-errors/linker-tools-error-lnk1127.md) \ -[Linker Tools Error LNK1136](../../error-messages/tool-errors/linker-tools-error-lnk1136.md) \ -[Linker Tools Error LNK1140](../../error-messages/tool-errors/linker-tools-error-lnk1140.md) \ -[Linker Tools Error LNK1141](../../error-messages/tool-errors/linker-tools-error-lnk1141.md) \ -[Linker Tools Error LNK1143](../../error-messages/tool-errors/linker-tools-error-lnk1143.md) \ -[Linker Tools Error LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md) \ -[Linker Tools Error LNK1158](../../error-messages/tool-errors/linker-tools-error-lnk1158.md) \ -[Linker Tools Error LNK1164](../../error-messages/tool-errors/linker-tools-error-lnk1164.md) \ -[Linker Tools Error LNK1166](../../error-messages/tool-errors/linker-tools-error-lnk1166.md) \ -[Linker Tools Error LNK1168](../../error-messages/tool-errors/linker-tools-error-lnk1168.md) \ -[Linker Tools Error LNK1169](../../error-messages/tool-errors/linker-tools-error-lnk1169.md) \ -[Linker Tools Error LNK1170](../../error-messages/tool-errors/linker-tools-error-lnk1170.md) \ -[Linker Tools Error LNK1179](../../error-messages/tool-errors/linker-tools-error-lnk1179.md) \ -[Linker Tools Error LNK1181](../../error-messages/tool-errors/linker-tools-error-lnk1181.md) \ -[Linker Tools Error LNK1188](../../error-messages/tool-errors/linker-tools-error-lnk1188.md) \ -[Linker Tools Error LNK1189](../../error-messages/tool-errors/linker-tools-error-lnk1189.md) \ -[Linker Tools Error LNK1196](../../error-messages/tool-errors/linker-tools-error-lnk1196.md) \ -[Linker Tools Error LNK1200](../../error-messages/tool-errors/linker-tools-error-lnk1200.md) \ -[Linker Tools Error LNK1201](../../error-messages/tool-errors/linker-tools-error-lnk1201.md) \ -[Linker Tools Error LNK1211](../../error-messages/tool-errors/linker-tools-error-lnk1211.md) \ -[Linker Tools Error LNK1215](../../error-messages/tool-errors/linker-tools-error-lnk1215.md) \ -[Linker Tools Error LNK1218](../../error-messages/tool-errors/linker-tools-error-lnk1218.md) \ -[Linker Tools Error LNK1221](../../error-messages/tool-errors/linker-tools-error-lnk1221.md) \ -[Linker Tools Error LNK1223](../../error-messages/tool-errors/linker-tools-error-lnk1223.md) \ -[Linker Tools Error LNK1224](../../error-messages/tool-errors/linker-tools-error-lnk1224.md) \ -[Linker Tools Error LNK1237](../../error-messages/tool-errors/linker-tools-error-lnk1237.md) \ -[Linker Tools Error LNK1240](../../error-messages/tool-errors/linker-tools-error-lnk1240.md) \ -[Linker Tools Error LNK1241](../../error-messages/tool-errors/linker-tools-error-lnk1241.md) \ -[Linker Tools Error LNK1245](../../error-messages/tool-errors/linker-tools-error-lnk1245.md) \ -[Linker Tools Error LNK1248](../../error-messages/tool-errors/linker-tools-error-lnk1248.md) \ -[Linker Tools Error LNK1256](../../error-messages/tool-errors/linker-tools-error-lnk1256.md) \ -[Linker Tools Error LNK1264](../../error-messages/tool-errors/linker-tools-error-lnk1264.md) \ -[Linker Tools Error LNK1277](../../error-messages/tool-errors/linker-tools-error-lnk1277.md) \ -[Linker Tools Error LNK1282](../../error-messages/tool-errors/linker-tools-error-lnk1282.md) \ -[Linker Tools Error LNK1287](../../error-messages/tool-errors/linker-tools-error-lnk1287.md) \ -[Linker Tools Error LNK1296](../../error-messages/tool-errors/linker-tools-error-lnk1296.md) \ -[Linker Tools Error LNK1301](../../error-messages/tool-errors/linker-tools-error-lnk1301.md) \ -[Linker Tools Error LNK1302](../../error-messages/tool-errors/linker-tools-error-lnk1302.md) \ -[Linker Tools Error LNK1306](../../error-messages/tool-errors/linker-tools-error-lnk1306.md) \ -[Linker Tools Error LNK1309](../../error-messages/tool-errors/linker-tools-error-lnk1309.md) \ -[Linker Tools Error LNK1312](../../error-messages/tool-errors/linker-tools-error-lnk1312.md) \ -[Linker Tools Error LNK1313](../../error-messages/tool-errors/linker-tools-error-lnk1313.md) \ -[Linker Tools Error LNK1314](../../error-messages/tool-errors/linker-tools-error-lnk1314.md) \ -[Linker Tools Error LNK1318](../../error-messages/tool-errors/linker-tools-error-lnk1318.md) \ -[Linker Tools Error LNK1332](../../error-messages/tool-errors/linker-tools-error-lnk1332.md) \ -[Linker Tools Error LNK1352](../../error-messages/tool-errors/linker-tools-error-lnk1352.md) \ -[Linker Tools Error LNK1561](../../error-messages/tool-errors/linker-tools-error-lnk1561.md) \ -[Linker Tools Error LNK2001](../../error-messages/tool-errors/linker-tools-error-lnk2001.md) \ -[Linker Tools Error LNK2004](../../error-messages/tool-errors/linker-tools-error-lnk2004.md) \ -[Linker Tools Error LNK2005](../../error-messages/tool-errors/linker-tools-error-lnk2005.md) \ -[Linker Tools Error LNK2008](../../error-messages/tool-errors/linker-tools-error-lnk2008.md) \ -[Linker Tools Error LNK2011](../../error-messages/tool-errors/linker-tools-error-lnk2011.md) \ -[Linker Tools Error LNK2013](../../error-messages/tool-errors/linker-tools-error-lnk2013.md) \ -[Linker Tools Error LNK2017](../../error-messages/tool-errors/linker-tools-error-lnk2017.md) \ -[Linker Tools Error LNK2019](../../error-messages/tool-errors/linker-tools-error-lnk2019.md) \ -[Linker Tools Error LNK2020](../../error-messages/tool-errors/linker-tools-error-lnk2020.md) \ -[Linker Tools Error LNK2022](../../error-messages/tool-errors/linker-tools-error-lnk2022.md) \ -[Linker Tools Error LNK2023](../../error-messages/tool-errors/linker-tools-error-lnk2023.md) \ -[Linker Tools Error LNK2026](../../error-messages/tool-errors/linker-tools-error-lnk2026.md) \ -[Linker Tools Error LNK2027](../../error-messages/tool-errors/linker-tools-error-lnk2027.md) \ -[Linker Tools Error LNK2028](../../error-messages/tool-errors/linker-tools-error-lnk2028.md) \ -[Linker Tools Error LNK2031](../../error-messages/tool-errors/linker-tools-error-lnk2031.md) \ -[Linker Tools Error LNK2033](../../error-messages/tool-errors/linker-tools-error-lnk2033.md) \ -[Linker Tools Error LNK2038](../../error-messages/tool-errors/linker-tools-error-lnk2038.md) \ -[Linker Tools Error LNK2039](../../error-messages/tool-errors/linker-tools-error-lnk2039.md) +| Error | Message | +|--|--| +| [Linker Tools Error LNK1000](../../error-messages/tool-errors/linker-tools-error-lnk1000.md) | unknown error; consult documentation for technical support options | +| [Linker Tools Error LNK1103](../../error-messages/tool-errors/linker-tools-error-lnk1103.md) | debugging information corrupt; recompile module | +| [Linker Tools Error LNK1104](../../error-messages/tool-errors/linker-tools-error-lnk1104.md) | cannot open file '*filename*' | +| [Linker Tools Error LNK1106](../../error-messages/tool-errors/linker-tools-error-lnk1106.md) | invalid file or disk full: cannot seek to location | +| [Linker Tools Error LNK1107](../../error-messages/tool-errors/linker-tools-error-lnk1107.md) | invalid or corrupt file: cannot read at location *address* | +| [Linker Tools Error LNK1112](../../error-messages/tool-errors/linker-tools-error-lnk1112.md) | module machine type '*type1*' conflicts with target machine type '*type2*' | +| [Linker Tools Error LNK1113](../../error-messages/tool-errors/linker-tools-error-lnk1113.md) | invalid machine type type | +| [Linker Tools Error LNK1120](../../error-messages/tool-errors/linker-tools-error-lnk1120.md) | *number* unresolved externals | +| [Linker Tools Error LNK1123](../../error-messages/tool-errors/linker-tools-error-lnk1123.md) | failure during conversion to COFF: file invalid or corrupt | +| [Linker Tools Error LNK1127](../../error-messages/tool-errors/linker-tools-error-lnk1127.md) | library is corrupt | +| [Linker Tools Error LNK1136](../../error-messages/tool-errors/linker-tools-error-lnk1136.md) | invalid or corrupt file | +| [Linker Tools Error LNK1140](../../error-messages/tool-errors/linker-tools-error-lnk1140.md) | too many modules for program database; link with /PDB:NONE | +| [Linker Tools Error LNK1141](../../error-messages/tool-errors/linker-tools-error-lnk1141.md) | failure during build of exports file | +| [Linker Tools Error LNK1143](../../error-messages/tool-errors/linker-tools-error-lnk1143.md) | invalid or corrupt file: no symbol for COMDAT section number | +| [Linker Tools Error LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md) | cannot resolve one or more undecorated symbols | +| [Linker Tools Error LNK1158](../../error-messages/tool-errors/linker-tools-error-lnk1158.md) | cannot run 'filename' | +| [Linker Tools Error LNK1164](../../error-messages/tool-errors/linker-tools-error-lnk1164.md) | section section alignment (number) greater than /ALIGN value | +| [Linker Tools Error LNK1166](../../error-messages/tool-errors/linker-tools-error-lnk1166.md) | cannot adjust code at offset=offset, va=value | +| [Linker Tools Error LNK1168](../../error-messages/tool-errors/linker-tools-error-lnk1168.md) | cannot open filename for writing | +| [Linker Tools Error LNK1169](../../error-messages/tool-errors/linker-tools-error-lnk1169.md) | one or more multiply defined symbols found | +| [Linker Tools Error LNK1170](../../error-messages/tool-errors/linker-tools-error-lnk1170.md) | line in command file contains *maximum-length* or more characters | +| [Linker Tools Error LNK1179](../../error-messages/tool-errors/linker-tools-error-lnk1179.md) | invalid or corrupt file: duplicate COMDAT 'filename' | +| [Linker Tools Error LNK1181](../../error-messages/tool-errors/linker-tools-error-lnk1181.md) | cannot open input file 'filename' | +| [Linker Tools Error LNK1188](../../error-messages/tool-errors/linker-tools-error-lnk1188.md) | BADFIXUPSECTION:: invalid fixup target 'symbol'; possible zero length section | +| [Linker Tools Error LNK1189](../../error-messages/tool-errors/linker-tools-error-lnk1189.md) | LIBTOOMANYMEMBERS:: library limit of number objects exceeded | +| [Linker Tools Error LNK1196](../../error-messages/tool-errors/linker-tools-error-lnk1196.md) | invalid or corrupt import object: unknown version | +| [Linker Tools Error LNK1200](../../error-messages/tool-errors/linker-tools-error-lnk1200.md) | error reading program database 'filename' | +| [Linker Tools Error LNK1201](../../error-messages/tool-errors/linker-tools-error-lnk1201.md) | error writing to program database 'filename'; check for insufficient disk space, invalid path, or insufficient privilege | +| [Linker Tools Error LNK1211](../../error-messages/tool-errors/linker-tools-error-lnk1211.md) | precompiled type information not found; '*filename*' not linked or overwritten | +| [Linker Tools Error LNK1215](../../error-messages/tool-errors/linker-tools-error-lnk1215.md) | metadata operation failed (HRESULT) : error | +| [Linker Tools Error LNK1218](../../error-messages/tool-errors/linker-tools-error-lnk1218.md) | warning treated as error; no output file generated | +| [Linker Tools Error LNK1221](../../error-messages/tool-errors/linker-tools-error-lnk1221.md) | a subsystem can't be inferred and must be defined | +| [Linker Tools Error LNK1223](../../error-messages/tool-errors/linker-tools-error-lnk1223.md) | invalid or corrupt file: file contains invalid .pdata contributions | +| [Linker Tools Error LNK1224](../../error-messages/tool-errors/linker-tools-error-lnk1224.md) | invalid image base address | +| [Linker Tools Error LNK1237](../../error-messages/tool-errors/linker-tools-error-lnk1237.md) | during code generation, compiler introduced reference to symbol 'symbol' defined in module 'module' compiled with /GL | +| [Linker Tools Error LNK1240](../../error-messages/tool-errors/linker-tools-error-lnk1240.md) | failed to compile IDL content | +| [Linker Tools Error LNK1241](../../error-messages/tool-errors/linker-tools-error-lnk1241.md) | resource file 'resource file' already specified | +| [Linker Tools Error LNK1245](../../error-messages/tool-errors/linker-tools-error-lnk1245.md) | invalid subsystem 'subsystem' specified; /SUBSYSTEM must be WINDOWS, WINDOWSCE, or CONSOLE | +| [Linker Tools Error LNK1248](../../error-messages/tool-errors/linker-tools-error-lnk1248.md) | image size ('*output_size*') exceeds maximum allowable size (*maximum_size*) | +| [Linker Tools Error LNK1256](../../error-messages/tool-errors/linker-tools-error-lnk1256.md) | ALINK operation failed : reason | +| [Linker Tools Error LNK1264](../../error-messages/tool-errors/linker-tools-error-lnk1264.md) | /LTCG:PGINSTRUMENT specified but no code generation required; instrumentation failed | +| [Linker Tools Error LNK1277](../../error-messages/tool-errors/linker-tools-error-lnk1277.md) | object record not found in pgd (filename) | +| [Linker Tools Error LNK1282](../../error-messages/tool-errors/linker-tools-error-lnk1282.md) | unable to /REBASE file; it has been signed | +| [Linker Tools Error LNK1287](../../error-messages/tool-errors/linker-tools-error-lnk1287.md) | invalid managed entry point function | +| [Linker Tools Error LNK1296](../../error-messages/tool-errors/linker-tools-error-lnk1296.md) | unable to load filename | +| [Linker Tools Error LNK1301](../../error-messages/tool-errors/linker-tools-error-lnk1301.md) | LTCG clr modules found, incompatible with /LTCG:parameter | +| [Linker Tools Error LNK1302](../../error-messages/tool-errors/linker-tools-error-lnk1302.md) | only support linking safe .netmodules; unable to link file .netmodule | +| [Linker Tools Error LNK1306](../../error-messages/tool-errors/linker-tools-error-lnk1306.md) | DLL entry point function cannot be managed; compile to native | +| [Linker Tools Error LNK1309](../../error-messages/tool-errors/linker-tools-error-lnk1309.md) | *type1* module detected; invalid with switch /CLRIMAGETYPE:*type2* | +| [Linker Tools Error LNK1312](../../error-messages/tool-errors/linker-tools-error-lnk1312.md) | invalid or corrupt file: unable to import assembly | +| [Linker Tools Error LNK1313](../../error-messages/tool-errors/linker-tools-error-lnk1313.md) | ijw/native module detected; cannot link with pure modules | +| [Linker Tools Error LNK1314](../../error-messages/tool-errors/linker-tools-error-lnk1314.md) | corrupt or invalid COFF symbol table (undefined static or label symbol) | +| [Linker Tools Error LNK1318](../../error-messages/tool-errors/linker-tools-error-lnk1318.md) | Unexpected PDB error; *cause* '*details*' | +| [Linker Tools Error LNK1332](../../error-messages/tool-errors/linker-tools-error-lnk1332.md) | detected\ Windows Runtime types imported in one module and defined in another module | +| [Linker Tools Error LNK1352](../../error-messages/tool-errors/linker-tools-error-lnk1352.md) | '*section_name_1*' and '*section_name_2*' cannot be merged into different sections | +| [Linker Tools Error LNK1561](../../error-messages/tool-errors/linker-tools-error-lnk1561.md) | entry point must be defined | +| [Linker Tools Error LNK2001](../../error-messages/tool-errors/linker-tools-error-lnk2001.md) | unresolved external symbol "*symbol*" | +| [Linker Tools Error LNK2004](../../error-messages/tool-errors/linker-tools-error-lnk2004.md) | gp relative fixup overflow to 'target'; short section 'section' is too large or out of range. | +| [Linker Tools Error LNK2005](../../error-messages/tool-errors/linker-tools-error-lnk2005.md) | *symbol* already defined in object | +| [Linker Tools Error LNK2008](../../error-messages/tool-errors/linker-tools-error-lnk2008.md) | Fixup target is not aligned 'symbol_name' | +| [Linker Tools Error LNK2011](../../error-messages/tool-errors/linker-tools-error-lnk2011.md) | precompiled object not linked in; image may not run | +| [Linker Tools Error LNK2013](../../error-messages/tool-errors/linker-tools-error-lnk2013.md) | fixup type fixup overflow. Target 'symbol name' is out of range | +| [Linker Tools Error LNK2017](../../error-messages/tool-errors/linker-tools-error-lnk2017.md) | 'symbol' relocation to 'segment' invalid without /LARGEADDRESSAWARE:NO | +| [Linker Tools Error LNK2019](../../error-messages/tool-errors/linker-tools-error-lnk2019.md) | unresolved external symbol '*symbol*' referenced in function '*function*' | +| [Linker Tools Error LNK2020](../../error-messages/tool-errors/linker-tools-error-lnk2020.md) | unresolved token 'token' | +| [Linker Tools Error LNK2022](../../error-messages/tool-errors/linker-tools-error-lnk2022.md) | metadata operation failed (*HRESULT*) : *error_message* | +| [Linker Tools Error LNK2023](../../error-messages/tool-errors/linker-tools-error-lnk2023.md) | bad dll or entry point \ | +| [Linker Tools Error LNK2026](../../error-messages/tool-errors/linker-tools-error-lnk2026.md) | module unsafe for SAFESEH image | +| [Linker Tools Error LNK2027](../../error-messages/tool-errors/linker-tools-error-lnk2027.md) | unresolved module reference 'module' | +| [Linker Tools Error LNK2028](../../error-messages/tool-errors/linker-tools-error-lnk2028.md) | "*exported_function*" (*decorated_name*) referenced in function "*function_containing_function_call*" (*decorated_name*) | +| [Linker Tools Error LNK2031](../../error-messages/tool-errors/linker-tools-error-lnk2031.md) | unable to generate p/invoke for "*function_declaration*" *decorated_name*; calling convention missing in metadata | +| [Linker Tools Error LNK2033](../../error-messages/tool-errors/linker-tools-error-lnk2033.md) | unresolved typeref token (token) for 'type' | +| [Linker Tools Error LNK2038](../../error-messages/tool-errors/linker-tools-error-lnk2038.md) | mismatch detected for '*name*': value '*value_1*' doesn't match value '*value_2*' in *filename.obj* | +| [Linker Tools Error LNK2039](../../error-messages/tool-errors/linker-tools-error-lnk2039.md) | importing ref class '\' that is defined in another.obj; it should be either imported or defined, but not both | ## Linker tools warnings -[Linker Tools Warning LNK4001](../../error-messages/tool-errors/linker-tools-warning-lnk4001.md) \ -[Linker Tools Warning LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) \ -[Linker Tools Warning LNK4006](../../error-messages/tool-errors/linker-tools-warning-lnk4006.md) \ -[Linker Tools Warning LNK4010](../../error-messages/tool-errors/linker-tools-warning-lnk4010.md) \ -[Linker Tools Warning LNK4014](../../error-messages/tool-errors/linker-tools-warning-lnk4014.md) \ -[Linker Tools Warning LNK4020](../../error-messages/tool-errors/linker-tools-warning-lnk4020.md) \ -[Linker Tools Warning LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) \ -[Linker Tools Warning LNK4039](../../error-messages/tool-errors/linker-tools-warning-lnk4039.md) \ -[Linker Tools Warning LNK4044](../../error-messages/tool-errors/linker-tools-warning-lnk4044.md) \ -[Linker Tools Warning LNK4049](../../error-messages/tool-errors/linker-tools-warning-lnk4049.md) \ -[Linker Tools Warning LNK4065](../../error-messages/tool-errors/linker-tools-warning-lnk4065.md) \ -[Linker Tools Warning LNK4070](../../error-messages/tool-errors/linker-tools-warning-lnk4070.md) \ -[Linker Tools Warning LNK4071](../../error-messages/tool-errors/linker-tools-warning-lnk4071.md) \ -[Linker Tools Warning LNK4073](../../error-messages/tool-errors/linker-tools-warning-lnk4073.md) \ -[Linker Tools Warning LNK4075](../../error-messages/tool-errors/linker-tools-warning-lnk4075.md) \ -[Linker Tools Warning LNK4076](../../error-messages/tool-errors/linker-tools-warning-lnk4076.md) \ -[Linker Tools Warning LNK4078](../../error-messages/tool-errors/linker-tools-warning-lnk4078.md) \ -[Linker Tools Warning LNK4086](../../error-messages/tool-errors/linker-tools-warning-lnk4086.md) \ -[Linker Tools Warning LNK4092](../../error-messages/tool-errors/linker-tools-warning-lnk4092.md) \ -[Linker Tools Warning LNK4096](../../error-messages/tool-errors/linker-tools-warning-lnk4096.md) \ -[Linker Tools Warning LNK4098](../../error-messages/tool-errors/linker-tools-warning-lnk4098.md) \ -[Linker Tools Warning LNK4099](../../error-messages/tool-errors/linker-tools-warning-lnk4099.md) \ -[Linker Tools Warning LNK4102](../../error-messages/tool-errors/linker-tools-warning-lnk4102.md) \ -[Linker Tools Warning LNK4104](../../error-messages/tool-errors/linker-tools-warning-lnk4104.md) \ -[Linker Tools Warning LNK4105](../../error-messages/tool-errors/linker-tools-warning-lnk4105.md) \ -[Linker Tools Warning LNK4194](../../error-messages/tool-errors/linker-tools-warning-lnk4194.md) \ -[Linker Tools Warning LNK4197](../../error-messages/tool-errors/linker-tools-warning-lnk4197.md) \ -[Linker Tools Warning LNK4199](../../error-messages/tool-errors/linker-tools-warning-lnk4199.md) \ -[Linker Tools Warning LNK4200](../../error-messages/tool-errors/linker-tools-warning-lnk4200.md) \ -[Linker Tools Warning LNK4204](../../error-messages/tool-errors/linker-tools-warning-lnk4204.md) \ -[Linker Tools Warning LNK4205](../../error-messages/tool-errors/linker-tools-warning-lnk4205.md) \ -[Linker Tools Warning LNK4206](../../error-messages/tool-errors/linker-tools-warning-lnk4206.md) \ -[Linker Tools Warning LNK4210](../../error-messages/tool-errors/linker-tools-warning-lnk4210.md) \ -[Linker Tools Warning LNK4216](../../error-messages/tool-errors/linker-tools-warning-lnk4216.md) \ -[Linker Tools Warning LNK4217](../../error-messages/tool-errors/linker-tools-warning-lnk4217.md) \ -[Linker Tools Warning LNK4219](../../error-messages/tool-errors/linker-tools-warning-lnk4219.md) \ -[Linker Tools Warning LNK4220](../../error-messages/tool-errors/linker-tools-warning-lnk4220.md) \ -[Linker Tools Warning LNK4221](../../error-messages/tool-errors/linker-tools-warning-lnk4221.md) \ -[Linker Tools Warning LNK4222](../../error-messages/tool-errors/linker-tools-warning-lnk4222.md) \ -[Linker Tools Warning LNK4224](../../error-messages/tool-errors/linker-tools-warning-lnk4224.md) \ -[Linker Tools Warning LNK4227](../../error-messages/tool-errors/linker-tools-warning-lnk4227.md) \ -[Linker Tools Warning LNK4229](../../error-messages/tool-errors/linker-tools-warning-lnk4229.md) \ -[Linker Tools Warning LNK4237](../../error-messages/tool-errors/linker-tools-warning-lnk4237.md) \ -[Linker Tools Warning LNK4247](../../error-messages/tool-errors/linker-tools-warning-lnk4247.md) \ -[Linker Tools Warning LNK4248](../../error-messages/tool-errors/linker-tools-warning-lnk4248.md) \ -[Linker Tools Warning LNK4253](../../error-messages/tool-errors/linker-tools-warning-lnk4253.md) \ -[Linker Tools Warning LNK4254](../../error-messages/tool-errors/linker-tools-warning-lnk4254.md) \ -[Linker Tools Warning LNK4286](../../error-messages/tool-errors/linker-tools-warning-lnk4286.md) \ -[Linker Tools Warning LNK4306](../../error-messages/tool-errors/linker-tools-warning-lnk4306.md) \ -[Linker Tools Warning LNK4307](../../error-messages/tool-errors/linker-tools-warning-lnk4307.md) +| Warning | Message | +|--|--| +| [Linker Tools Warning LNK4001](../../error-messages/tool-errors/linker-tools-warning-lnk4001.md) | no object files specified; libraries used | +| [Linker Tools Warning LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) | symbol defined in object | +| [Linker Tools Warning LNK4006](../../error-messages/tool-errors/linker-tools-warning-lnk4006.md) | symbol already defined in object; second definition ignored | +| [Linker Tools Warning LNK4010](../../error-messages/tool-errors/linker-tools-warning-lnk4010.md) | invalid subsystem version number number; default subsystem version assumed | +| [Linker Tools Warning LNK4014](../../error-messages/tool-errors/linker-tools-warning-lnk4014.md) | cannot find member object "objectname" | +| [Linker Tools Warning LNK4020](../../error-messages/tool-errors/linker-tools-warning-lnk4020.md) | a type record in '*filename*' is corrupted; some symbols and types may not be accessible from the debugger | +| [Linker Tools Warning LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) | cannot find unique match for symbol 'symbol' | +| [Linker Tools Warning LNK4039](../../error-messages/tool-errors/linker-tools-warning-lnk4039.md) | section 'name' specified with /SECTION option does not exist | +| [Linker Tools Warning LNK4044](../../error-messages/tool-errors/linker-tools-warning-lnk4044.md) | unrecognized option 'option'; ignored | +| [Linker Tools Warning LNK4049](../../error-messages/tool-errors/linker-tools-warning-lnk4049.md) | symbol '*symbol*' defined in '*filename.obj*' is imported | +| [Linker Tools Warning LNK4065](../../error-messages/tool-errors/linker-tools-warning-lnk4065.md) | 'function' cannot be ordered; ignored | +| [Linker Tools Warning LNK4070](../../error-messages/tool-errors/linker-tools-warning-lnk4070.md) | /OUT:filename directive in .EXP differs from output filename 'filename'; ignoring directive | +| [Linker Tools Warning LNK4071](../../error-messages/tool-errors/linker-tools-warning-lnk4071.md) | cannot be incrementally linked on subsequent links | +| [Linker Tools Warning LNK4073](../../error-messages/tool-errors/linker-tools-warning-lnk4073.md) | cannot create map for .ilk file; linking nonincrementally | +| [Linker Tools Warning LNK4075](../../error-messages/tool-errors/linker-tools-warning-lnk4075.md) | ignoring "option1" due to "option2" specification | +| [Linker Tools Warning LNK4076](../../error-messages/tool-errors/linker-tools-warning-lnk4076.md) | invalid incremental status file 'filename'; linking nonincrementally | +| [Linker Tools Warning LNK4078](../../error-messages/tool-errors/linker-tools-warning-lnk4078.md) | multiple 'section name' sections found with different attributes | +| [Linker Tools Warning LNK4086](../../error-messages/tool-errors/linker-tools-warning-lnk4086.md) | entrypoint 'function' is not __stdcall with 'number' bytes of arguments; image may not run | +| [Linker Tools Warning LNK4092](../../error-messages/tool-errors/linker-tools-warning-lnk4092.md) | shared writable section 'section' contains relocations; image may not run correctly | +| [Linker Tools Warning LNK4096](../../error-messages/tool-errors/linker-tools-warning-lnk4096.md) | /BASE value "number" is invalid for Windows 95 and Windows 98; image may not run | +| [Linker Tools Warning LNK4098](../../error-messages/tool-errors/linker-tools-warning-lnk4098.md) | defaultlib '*library*' conflicts with use of other libs; use /NODEFAULTLIB:*library* | +| [Linker Tools Warning LNK4099](../../error-messages/tool-errors/linker-tools-warning-lnk4099.md) | PDB 'filename' was not found with 'object/library' or at 'path'; linking object as if no debug info | +| [Linker Tools Warning LNK4102](../../error-messages/tool-errors/linker-tools-warning-lnk4102.md) | export of deleting destructor 'name'; image may not run correctly | +| [Linker Tools Warning LNK4104](../../error-messages/tool-errors/linker-tools-warning-lnk4104.md) | export of symbol 'symbol' should be PRIVATE | +| [Linker Tools Warning LNK4105](../../error-messages/tool-errors/linker-tools-warning-lnk4105.md) | no argument specified with option 'option'; ignoring option | +| [Linker Tools Warning LNK4194](../../error-messages/tool-errors/linker-tools-warning-lnk4194.md) | /DELAYLOAD:dll name ignored | +| [Linker Tools Warning LNK4197](../../error-messages/tool-errors/linker-tools-warning-lnk4197.md) | export '*exportname*' specified multiple times; using first specification | +| [Linker Tools Warning LNK4199](../../error-messages/tool-errors/linker-tools-warning-lnk4199.md) | /DELAYLOAD:dllname ignored; no imports found from dllname | +| [Linker Tools Warning LNK4200](../../error-messages/tool-errors/linker-tools-warning-lnk4200.md) | corrupt line number information in object file; ignored | +| [Linker Tools Warning LNK4204](../../error-messages/tool-errors/linker-tools-warning-lnk4204.md) | 'filename' is missing debugging information for referencing module; linking object as if no debug info | +| [Linker Tools Warning LNK4205](../../error-messages/tool-errors/linker-tools-warning-lnk4205.md) | 'filename' is missing current debugging information for referencing module; linking object as if no debug info | +| [Linker Tools Warning LNK4206](../../error-messages/tool-errors/linker-tools-warning-lnk4206.md) | precompiled type information not found; '*filename*' not linked or overwritten; linking object as if no debug info | +| [Linker Tools Warning LNK4210](../../error-messages/tool-errors/linker-tools-warning-lnk4210.md) | section *section* exists; there may be unhandled static initializers or terminators | +| [Linker Tools Warning LNK4216](../../error-messages/tool-errors/linker-tools-warning-lnk4216.md) | Exported entry point entry | +| [Linker Tools Warning LNK4217](../../error-messages/tool-errors/linker-tools-warning-lnk4217.md) | symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' in function '*function*' | +| [Linker Tools Warning LNK4219](../../error-messages/tool-errors/linker-tools-warning-lnk4219.md) | fixup name fixup overflow. Target 'target symbol name' is out of range, inserting thunk | +| [Linker Tools Warning LNK4220](../../error-messages/tool-errors/linker-tools-warning-lnk4220.md) | invalid 'linker option' value 'value'; assumed default | +| [Linker Tools Warning LNK4221](../../error-messages/tool-errors/linker-tools-warning-lnk4221.md) | This object file does not define any previously undefined public symbols, so it will not be used by any link operation that consumes this library | +| [Linker Tools Warning LNK4222](../../error-messages/tool-errors/linker-tools-warning-lnk4222.md) | exported symbol 'symbol' should not be assigned an ordinal | +| [Linker Tools Warning LNK4224](../../error-messages/tool-errors/linker-tools-warning-lnk4224.md) | *option* is no longer supported; ignored | +| [Linker Tools Warning LNK4227](../../error-messages/tool-errors/linker-tools-warning-lnk4227.md) | metadata operation warning (*HRESULT*) : *warning_message* | +| [Linker Tools Warning LNK4229](../../error-messages/tool-errors/linker-tools-warning-lnk4229.md) | invalid directive /directive found; ignored | +| [Linker Tools Warning LNK4237](../../error-messages/tool-errors/linker-tools-warning-lnk4237.md) | /SUBSYSTEM:NATIVE specified when importing from 'dll'; Use /SUBSYSTEM:CONSOLE or /SUBSYSTEM:WINDOWS. | +| [Linker Tools Warning LNK4247](../../error-messages/tool-errors/linker-tools-warning-lnk4247.md) | entry point 'decorated_function_name' already has a thread attribute; 'attribute' ignored | +| [Linker Tools Warning LNK4248](../../error-messages/tool-errors/linker-tools-warning-lnk4248.md) | unresolved typeref token (token) for 'type'; image may not run | +| [Linker Tools Warning LNK4253](../../error-messages/tool-errors/linker-tools-warning-lnk4253.md) | section 'section1' not merged into 'section2'; already merged into 'section3' | +| [Linker Tools Warning LNK4254](../../error-messages/tool-errors/linker-tools-warning-lnk4254.md) | section 'section1' (offset) merged into 'section2' (offset) with different attributes | +| [Linker Tools Warning LNK4286](../../error-messages/tool-errors/linker-tools-warning-lnk4286.md) | symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' | +| [Linker Tools Warning LNK4306](../../error-messages/tool-errors/linker-tools-warning-lnk4306.md) | The auxiliary delayload import address table is not properly aligned with the primary delayload import address table. This may have negative perf impact. | +| [Linker Tools Warning LNK4307](../../error-messages/tool-errors/linker-tools-warning-lnk4307.md) | The auxiliary delayload import address table copy is not properly aligned with the auxiliary delayload import address table. This may have negative perf impact. | ## See also From b21bf5eb49d68df7225522fae2a069d463be87c6 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 11 Sep 2025 00:45:04 +0800 Subject: [PATCH 1171/1799] Simplify superfluous relative links in "Linker tools errors and warnings (LNKxxxx)" --- .../linker-tools-errors-and-warnings.md | 250 +++++++++--------- 1 file changed, 125 insertions(+), 125 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md index ae8a5f2791e..cec2c86b223 100644 --- a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md @@ -9,141 +9,141 @@ helpviewer_keywords: ["errors [C++]", "linker [C++], errors and warnings", "erro The linker tools LINK, LIB, DUMPBIN, and EDITBIN share a common executable that generates these errors and warnings. The tools generate warnings of the form LNK*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Linker tools errors | Error | Message | |--|--| -| [Linker Tools Error LNK1000](../../error-messages/tool-errors/linker-tools-error-lnk1000.md) | unknown error; consult documentation for technical support options | -| [Linker Tools Error LNK1103](../../error-messages/tool-errors/linker-tools-error-lnk1103.md) | debugging information corrupt; recompile module | -| [Linker Tools Error LNK1104](../../error-messages/tool-errors/linker-tools-error-lnk1104.md) | cannot open file '*filename*' | -| [Linker Tools Error LNK1106](../../error-messages/tool-errors/linker-tools-error-lnk1106.md) | invalid file or disk full: cannot seek to location | -| [Linker Tools Error LNK1107](../../error-messages/tool-errors/linker-tools-error-lnk1107.md) | invalid or corrupt file: cannot read at location *address* | -| [Linker Tools Error LNK1112](../../error-messages/tool-errors/linker-tools-error-lnk1112.md) | module machine type '*type1*' conflicts with target machine type '*type2*' | -| [Linker Tools Error LNK1113](../../error-messages/tool-errors/linker-tools-error-lnk1113.md) | invalid machine type type | -| [Linker Tools Error LNK1120](../../error-messages/tool-errors/linker-tools-error-lnk1120.md) | *number* unresolved externals | -| [Linker Tools Error LNK1123](../../error-messages/tool-errors/linker-tools-error-lnk1123.md) | failure during conversion to COFF: file invalid or corrupt | -| [Linker Tools Error LNK1127](../../error-messages/tool-errors/linker-tools-error-lnk1127.md) | library is corrupt | -| [Linker Tools Error LNK1136](../../error-messages/tool-errors/linker-tools-error-lnk1136.md) | invalid or corrupt file | -| [Linker Tools Error LNK1140](../../error-messages/tool-errors/linker-tools-error-lnk1140.md) | too many modules for program database; link with /PDB:NONE | -| [Linker Tools Error LNK1141](../../error-messages/tool-errors/linker-tools-error-lnk1141.md) | failure during build of exports file | -| [Linker Tools Error LNK1143](../../error-messages/tool-errors/linker-tools-error-lnk1143.md) | invalid or corrupt file: no symbol for COMDAT section number | -| [Linker Tools Error LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md) | cannot resolve one or more undecorated symbols | -| [Linker Tools Error LNK1158](../../error-messages/tool-errors/linker-tools-error-lnk1158.md) | cannot run 'filename' | -| [Linker Tools Error LNK1164](../../error-messages/tool-errors/linker-tools-error-lnk1164.md) | section section alignment (number) greater than /ALIGN value | -| [Linker Tools Error LNK1166](../../error-messages/tool-errors/linker-tools-error-lnk1166.md) | cannot adjust code at offset=offset, va=value | -| [Linker Tools Error LNK1168](../../error-messages/tool-errors/linker-tools-error-lnk1168.md) | cannot open filename for writing | -| [Linker Tools Error LNK1169](../../error-messages/tool-errors/linker-tools-error-lnk1169.md) | one or more multiply defined symbols found | -| [Linker Tools Error LNK1170](../../error-messages/tool-errors/linker-tools-error-lnk1170.md) | line in command file contains *maximum-length* or more characters | -| [Linker Tools Error LNK1179](../../error-messages/tool-errors/linker-tools-error-lnk1179.md) | invalid or corrupt file: duplicate COMDAT 'filename' | -| [Linker Tools Error LNK1181](../../error-messages/tool-errors/linker-tools-error-lnk1181.md) | cannot open input file 'filename' | -| [Linker Tools Error LNK1188](../../error-messages/tool-errors/linker-tools-error-lnk1188.md) | BADFIXUPSECTION:: invalid fixup target 'symbol'; possible zero length section | -| [Linker Tools Error LNK1189](../../error-messages/tool-errors/linker-tools-error-lnk1189.md) | LIBTOOMANYMEMBERS:: library limit of number objects exceeded | -| [Linker Tools Error LNK1196](../../error-messages/tool-errors/linker-tools-error-lnk1196.md) | invalid or corrupt import object: unknown version | -| [Linker Tools Error LNK1200](../../error-messages/tool-errors/linker-tools-error-lnk1200.md) | error reading program database 'filename' | -| [Linker Tools Error LNK1201](../../error-messages/tool-errors/linker-tools-error-lnk1201.md) | error writing to program database 'filename'; check for insufficient disk space, invalid path, or insufficient privilege | -| [Linker Tools Error LNK1211](../../error-messages/tool-errors/linker-tools-error-lnk1211.md) | precompiled type information not found; '*filename*' not linked or overwritten | -| [Linker Tools Error LNK1215](../../error-messages/tool-errors/linker-tools-error-lnk1215.md) | metadata operation failed (HRESULT) : error | -| [Linker Tools Error LNK1218](../../error-messages/tool-errors/linker-tools-error-lnk1218.md) | warning treated as error; no output file generated | -| [Linker Tools Error LNK1221](../../error-messages/tool-errors/linker-tools-error-lnk1221.md) | a subsystem can't be inferred and must be defined | -| [Linker Tools Error LNK1223](../../error-messages/tool-errors/linker-tools-error-lnk1223.md) | invalid or corrupt file: file contains invalid .pdata contributions | -| [Linker Tools Error LNK1224](../../error-messages/tool-errors/linker-tools-error-lnk1224.md) | invalid image base address | -| [Linker Tools Error LNK1237](../../error-messages/tool-errors/linker-tools-error-lnk1237.md) | during code generation, compiler introduced reference to symbol 'symbol' defined in module 'module' compiled with /GL | -| [Linker Tools Error LNK1240](../../error-messages/tool-errors/linker-tools-error-lnk1240.md) | failed to compile IDL content | -| [Linker Tools Error LNK1241](../../error-messages/tool-errors/linker-tools-error-lnk1241.md) | resource file 'resource file' already specified | -| [Linker Tools Error LNK1245](../../error-messages/tool-errors/linker-tools-error-lnk1245.md) | invalid subsystem 'subsystem' specified; /SUBSYSTEM must be WINDOWS, WINDOWSCE, or CONSOLE | -| [Linker Tools Error LNK1248](../../error-messages/tool-errors/linker-tools-error-lnk1248.md) | image size ('*output_size*') exceeds maximum allowable size (*maximum_size*) | -| [Linker Tools Error LNK1256](../../error-messages/tool-errors/linker-tools-error-lnk1256.md) | ALINK operation failed : reason | -| [Linker Tools Error LNK1264](../../error-messages/tool-errors/linker-tools-error-lnk1264.md) | /LTCG:PGINSTRUMENT specified but no code generation required; instrumentation failed | -| [Linker Tools Error LNK1277](../../error-messages/tool-errors/linker-tools-error-lnk1277.md) | object record not found in pgd (filename) | -| [Linker Tools Error LNK1282](../../error-messages/tool-errors/linker-tools-error-lnk1282.md) | unable to /REBASE file; it has been signed | -| [Linker Tools Error LNK1287](../../error-messages/tool-errors/linker-tools-error-lnk1287.md) | invalid managed entry point function | -| [Linker Tools Error LNK1296](../../error-messages/tool-errors/linker-tools-error-lnk1296.md) | unable to load filename | -| [Linker Tools Error LNK1301](../../error-messages/tool-errors/linker-tools-error-lnk1301.md) | LTCG clr modules found, incompatible with /LTCG:parameter | -| [Linker Tools Error LNK1302](../../error-messages/tool-errors/linker-tools-error-lnk1302.md) | only support linking safe .netmodules; unable to link file .netmodule | -| [Linker Tools Error LNK1306](../../error-messages/tool-errors/linker-tools-error-lnk1306.md) | DLL entry point function cannot be managed; compile to native | -| [Linker Tools Error LNK1309](../../error-messages/tool-errors/linker-tools-error-lnk1309.md) | *type1* module detected; invalid with switch /CLRIMAGETYPE:*type2* | -| [Linker Tools Error LNK1312](../../error-messages/tool-errors/linker-tools-error-lnk1312.md) | invalid or corrupt file: unable to import assembly | -| [Linker Tools Error LNK1313](../../error-messages/tool-errors/linker-tools-error-lnk1313.md) | ijw/native module detected; cannot link with pure modules | -| [Linker Tools Error LNK1314](../../error-messages/tool-errors/linker-tools-error-lnk1314.md) | corrupt or invalid COFF symbol table (undefined static or label symbol) | -| [Linker Tools Error LNK1318](../../error-messages/tool-errors/linker-tools-error-lnk1318.md) | Unexpected PDB error; *cause* '*details*' | -| [Linker Tools Error LNK1332](../../error-messages/tool-errors/linker-tools-error-lnk1332.md) | detected\ Windows Runtime types imported in one module and defined in another module | -| [Linker Tools Error LNK1352](../../error-messages/tool-errors/linker-tools-error-lnk1352.md) | '*section_name_1*' and '*section_name_2*' cannot be merged into different sections | -| [Linker Tools Error LNK1561](../../error-messages/tool-errors/linker-tools-error-lnk1561.md) | entry point must be defined | -| [Linker Tools Error LNK2001](../../error-messages/tool-errors/linker-tools-error-lnk2001.md) | unresolved external symbol "*symbol*" | -| [Linker Tools Error LNK2004](../../error-messages/tool-errors/linker-tools-error-lnk2004.md) | gp relative fixup overflow to 'target'; short section 'section' is too large or out of range. | -| [Linker Tools Error LNK2005](../../error-messages/tool-errors/linker-tools-error-lnk2005.md) | *symbol* already defined in object | -| [Linker Tools Error LNK2008](../../error-messages/tool-errors/linker-tools-error-lnk2008.md) | Fixup target is not aligned 'symbol_name' | -| [Linker Tools Error LNK2011](../../error-messages/tool-errors/linker-tools-error-lnk2011.md) | precompiled object not linked in; image may not run | -| [Linker Tools Error LNK2013](../../error-messages/tool-errors/linker-tools-error-lnk2013.md) | fixup type fixup overflow. Target 'symbol name' is out of range | -| [Linker Tools Error LNK2017](../../error-messages/tool-errors/linker-tools-error-lnk2017.md) | 'symbol' relocation to 'segment' invalid without /LARGEADDRESSAWARE:NO | -| [Linker Tools Error LNK2019](../../error-messages/tool-errors/linker-tools-error-lnk2019.md) | unresolved external symbol '*symbol*' referenced in function '*function*' | -| [Linker Tools Error LNK2020](../../error-messages/tool-errors/linker-tools-error-lnk2020.md) | unresolved token 'token' | -| [Linker Tools Error LNK2022](../../error-messages/tool-errors/linker-tools-error-lnk2022.md) | metadata operation failed (*HRESULT*) : *error_message* | -| [Linker Tools Error LNK2023](../../error-messages/tool-errors/linker-tools-error-lnk2023.md) | bad dll or entry point \ | -| [Linker Tools Error LNK2026](../../error-messages/tool-errors/linker-tools-error-lnk2026.md) | module unsafe for SAFESEH image | -| [Linker Tools Error LNK2027](../../error-messages/tool-errors/linker-tools-error-lnk2027.md) | unresolved module reference 'module' | -| [Linker Tools Error LNK2028](../../error-messages/tool-errors/linker-tools-error-lnk2028.md) | "*exported_function*" (*decorated_name*) referenced in function "*function_containing_function_call*" (*decorated_name*) | -| [Linker Tools Error LNK2031](../../error-messages/tool-errors/linker-tools-error-lnk2031.md) | unable to generate p/invoke for "*function_declaration*" *decorated_name*; calling convention missing in metadata | -| [Linker Tools Error LNK2033](../../error-messages/tool-errors/linker-tools-error-lnk2033.md) | unresolved typeref token (token) for 'type' | -| [Linker Tools Error LNK2038](../../error-messages/tool-errors/linker-tools-error-lnk2038.md) | mismatch detected for '*name*': value '*value_1*' doesn't match value '*value_2*' in *filename.obj* | -| [Linker Tools Error LNK2039](../../error-messages/tool-errors/linker-tools-error-lnk2039.md) | importing ref class '\' that is defined in another.obj; it should be either imported or defined, but not both | +| [Linker Tools Error LNK1000](linker-tools-error-lnk1000.md) | unknown error; consult documentation for technical support options | +| [Linker Tools Error LNK1103](linker-tools-error-lnk1103.md) | debugging information corrupt; recompile module | +| [Linker Tools Error LNK1104](linker-tools-error-lnk1104.md) | cannot open file '*filename*' | +| [Linker Tools Error LNK1106](linker-tools-error-lnk1106.md) | invalid file or disk full: cannot seek to location | +| [Linker Tools Error LNK1107](linker-tools-error-lnk1107.md) | invalid or corrupt file: cannot read at location *address* | +| [Linker Tools Error LNK1112](linker-tools-error-lnk1112.md) | module machine type '*type1*' conflicts with target machine type '*type2*' | +| [Linker Tools Error LNK1113](linker-tools-error-lnk1113.md) | invalid machine type type | +| [Linker Tools Error LNK1120](linker-tools-error-lnk1120.md) | *number* unresolved externals | +| [Linker Tools Error LNK1123](linker-tools-error-lnk1123.md) | failure during conversion to COFF: file invalid or corrupt | +| [Linker Tools Error LNK1127](linker-tools-error-lnk1127.md) | library is corrupt | +| [Linker Tools Error LNK1136](linker-tools-error-lnk1136.md) | invalid or corrupt file | +| [Linker Tools Error LNK1140](linker-tools-error-lnk1140.md) | too many modules for program database; link with /PDB:NONE | +| [Linker Tools Error LNK1141](linker-tools-error-lnk1141.md) | failure during build of exports file | +| [Linker Tools Error LNK1143](linker-tools-error-lnk1143.md) | invalid or corrupt file: no symbol for COMDAT section number | +| [Linker Tools Error LNK1152](linker-tools-error-lnk1152.md) | cannot resolve one or more undecorated symbols | +| [Linker Tools Error LNK1158](linker-tools-error-lnk1158.md) | cannot run 'filename' | +| [Linker Tools Error LNK1164](linker-tools-error-lnk1164.md) | section section alignment (number) greater than /ALIGN value | +| [Linker Tools Error LNK1166](linker-tools-error-lnk1166.md) | cannot adjust code at offset=offset, va=value | +| [Linker Tools Error LNK1168](linker-tools-error-lnk1168.md) | cannot open filename for writing | +| [Linker Tools Error LNK1169](linker-tools-error-lnk1169.md) | one or more multiply defined symbols found | +| [Linker Tools Error LNK1170](linker-tools-error-lnk1170.md) | line in command file contains *maximum-length* or more characters | +| [Linker Tools Error LNK1179](linker-tools-error-lnk1179.md) | invalid or corrupt file: duplicate COMDAT 'filename' | +| [Linker Tools Error LNK1181](linker-tools-error-lnk1181.md) | cannot open input file 'filename' | +| [Linker Tools Error LNK1188](linker-tools-error-lnk1188.md) | BADFIXUPSECTION:: invalid fixup target 'symbol'; possible zero length section | +| [Linker Tools Error LNK1189](linker-tools-error-lnk1189.md) | LIBTOOMANYMEMBERS:: library limit of number objects exceeded | +| [Linker Tools Error LNK1196](linker-tools-error-lnk1196.md) | invalid or corrupt import object: unknown version | +| [Linker Tools Error LNK1200](linker-tools-error-lnk1200.md) | error reading program database 'filename' | +| [Linker Tools Error LNK1201](linker-tools-error-lnk1201.md) | error writing to program database 'filename'; check for insufficient disk space, invalid path, or insufficient privilege | +| [Linker Tools Error LNK1211](linker-tools-error-lnk1211.md) | precompiled type information not found; '*filename*' not linked or overwritten | +| [Linker Tools Error LNK1215](linker-tools-error-lnk1215.md) | metadata operation failed (HRESULT) : error | +| [Linker Tools Error LNK1218](linker-tools-error-lnk1218.md) | warning treated as error; no output file generated | +| [Linker Tools Error LNK1221](linker-tools-error-lnk1221.md) | a subsystem can't be inferred and must be defined | +| [Linker Tools Error LNK1223](linker-tools-error-lnk1223.md) | invalid or corrupt file: file contains invalid .pdata contributions | +| [Linker Tools Error LNK1224](linker-tools-error-lnk1224.md) | invalid image base address | +| [Linker Tools Error LNK1237](linker-tools-error-lnk1237.md) | during code generation, compiler introduced reference to symbol 'symbol' defined in module 'module' compiled with /GL | +| [Linker Tools Error LNK1240](linker-tools-error-lnk1240.md) | failed to compile IDL content | +| [Linker Tools Error LNK1241](linker-tools-error-lnk1241.md) | resource file 'resource file' already specified | +| [Linker Tools Error LNK1245](linker-tools-error-lnk1245.md) | invalid subsystem 'subsystem' specified; /SUBSYSTEM must be WINDOWS, WINDOWSCE, or CONSOLE | +| [Linker Tools Error LNK1248](linker-tools-error-lnk1248.md) | image size ('*output_size*') exceeds maximum allowable size (*maximum_size*) | +| [Linker Tools Error LNK1256](linker-tools-error-lnk1256.md) | ALINK operation failed : reason | +| [Linker Tools Error LNK1264](linker-tools-error-lnk1264.md) | /LTCG:PGINSTRUMENT specified but no code generation required; instrumentation failed | +| [Linker Tools Error LNK1277](linker-tools-error-lnk1277.md) | object record not found in pgd (filename) | +| [Linker Tools Error LNK1282](linker-tools-error-lnk1282.md) | unable to /REBASE file; it has been signed | +| [Linker Tools Error LNK1287](linker-tools-error-lnk1287.md) | invalid managed entry point function | +| [Linker Tools Error LNK1296](linker-tools-error-lnk1296.md) | unable to load filename | +| [Linker Tools Error LNK1301](linker-tools-error-lnk1301.md) | LTCG clr modules found, incompatible with /LTCG:parameter | +| [Linker Tools Error LNK1302](linker-tools-error-lnk1302.md) | only support linking safe .netmodules; unable to link file .netmodule | +| [Linker Tools Error LNK1306](linker-tools-error-lnk1306.md) | DLL entry point function cannot be managed; compile to native | +| [Linker Tools Error LNK1309](linker-tools-error-lnk1309.md) | *type1* module detected; invalid with switch /CLRIMAGETYPE:*type2* | +| [Linker Tools Error LNK1312](linker-tools-error-lnk1312.md) | invalid or corrupt file: unable to import assembly | +| [Linker Tools Error LNK1313](linker-tools-error-lnk1313.md) | ijw/native module detected; cannot link with pure modules | +| [Linker Tools Error LNK1314](linker-tools-error-lnk1314.md) | corrupt or invalid COFF symbol table (undefined static or label symbol) | +| [Linker Tools Error LNK1318](linker-tools-error-lnk1318.md) | Unexpected PDB error; *cause* '*details*' | +| [Linker Tools Error LNK1332](linker-tools-error-lnk1332.md) | detected\ Windows Runtime types imported in one module and defined in another module | +| [Linker Tools Error LNK1352](linker-tools-error-lnk1352.md) | '*section_name_1*' and '*section_name_2*' cannot be merged into different sections | +| [Linker Tools Error LNK1561](linker-tools-error-lnk1561.md) | entry point must be defined | +| [Linker Tools Error LNK2001](linker-tools-error-lnk2001.md) | unresolved external symbol "*symbol*" | +| [Linker Tools Error LNK2004](linker-tools-error-lnk2004.md) | gp relative fixup overflow to 'target'; short section 'section' is too large or out of range. | +| [Linker Tools Error LNK2005](linker-tools-error-lnk2005.md) | *symbol* already defined in object | +| [Linker Tools Error LNK2008](linker-tools-error-lnk2008.md) | Fixup target is not aligned 'symbol_name' | +| [Linker Tools Error LNK2011](linker-tools-error-lnk2011.md) | precompiled object not linked in; image may not run | +| [Linker Tools Error LNK2013](linker-tools-error-lnk2013.md) | fixup type fixup overflow. Target 'symbol name' is out of range | +| [Linker Tools Error LNK2017](linker-tools-error-lnk2017.md) | 'symbol' relocation to 'segment' invalid without /LARGEADDRESSAWARE:NO | +| [Linker Tools Error LNK2019](linker-tools-error-lnk2019.md) | unresolved external symbol '*symbol*' referenced in function '*function*' | +| [Linker Tools Error LNK2020](linker-tools-error-lnk2020.md) | unresolved token 'token' | +| [Linker Tools Error LNK2022](linker-tools-error-lnk2022.md) | metadata operation failed (*HRESULT*) : *error_message* | +| [Linker Tools Error LNK2023](linker-tools-error-lnk2023.md) | bad dll or entry point \ | +| [Linker Tools Error LNK2026](linker-tools-error-lnk2026.md) | module unsafe for SAFESEH image | +| [Linker Tools Error LNK2027](linker-tools-error-lnk2027.md) | unresolved module reference 'module' | +| [Linker Tools Error LNK2028](linker-tools-error-lnk2028.md) | "*exported_function*" (*decorated_name*) referenced in function "*function_containing_function_call*" (*decorated_name*) | +| [Linker Tools Error LNK2031](linker-tools-error-lnk2031.md) | unable to generate p/invoke for "*function_declaration*" *decorated_name*; calling convention missing in metadata | +| [Linker Tools Error LNK2033](linker-tools-error-lnk2033.md) | unresolved typeref token (token) for 'type' | +| [Linker Tools Error LNK2038](linker-tools-error-lnk2038.md) | mismatch detected for '*name*': value '*value_1*' doesn't match value '*value_2*' in *filename.obj* | +| [Linker Tools Error LNK2039](linker-tools-error-lnk2039.md) | importing ref class '\' that is defined in another.obj; it should be either imported or defined, but not both | ## Linker tools warnings | Warning | Message | |--|--| -| [Linker Tools Warning LNK4001](../../error-messages/tool-errors/linker-tools-warning-lnk4001.md) | no object files specified; libraries used | -| [Linker Tools Warning LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) | symbol defined in object | -| [Linker Tools Warning LNK4006](../../error-messages/tool-errors/linker-tools-warning-lnk4006.md) | symbol already defined in object; second definition ignored | -| [Linker Tools Warning LNK4010](../../error-messages/tool-errors/linker-tools-warning-lnk4010.md) | invalid subsystem version number number; default subsystem version assumed | -| [Linker Tools Warning LNK4014](../../error-messages/tool-errors/linker-tools-warning-lnk4014.md) | cannot find member object "objectname" | -| [Linker Tools Warning LNK4020](../../error-messages/tool-errors/linker-tools-warning-lnk4020.md) | a type record in '*filename*' is corrupted; some symbols and types may not be accessible from the debugger | -| [Linker Tools Warning LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) | cannot find unique match for symbol 'symbol' | -| [Linker Tools Warning LNK4039](../../error-messages/tool-errors/linker-tools-warning-lnk4039.md) | section 'name' specified with /SECTION option does not exist | -| [Linker Tools Warning LNK4044](../../error-messages/tool-errors/linker-tools-warning-lnk4044.md) | unrecognized option 'option'; ignored | -| [Linker Tools Warning LNK4049](../../error-messages/tool-errors/linker-tools-warning-lnk4049.md) | symbol '*symbol*' defined in '*filename.obj*' is imported | -| [Linker Tools Warning LNK4065](../../error-messages/tool-errors/linker-tools-warning-lnk4065.md) | 'function' cannot be ordered; ignored | -| [Linker Tools Warning LNK4070](../../error-messages/tool-errors/linker-tools-warning-lnk4070.md) | /OUT:filename directive in .EXP differs from output filename 'filename'; ignoring directive | -| [Linker Tools Warning LNK4071](../../error-messages/tool-errors/linker-tools-warning-lnk4071.md) | cannot be incrementally linked on subsequent links | -| [Linker Tools Warning LNK4073](../../error-messages/tool-errors/linker-tools-warning-lnk4073.md) | cannot create map for .ilk file; linking nonincrementally | -| [Linker Tools Warning LNK4075](../../error-messages/tool-errors/linker-tools-warning-lnk4075.md) | ignoring "option1" due to "option2" specification | -| [Linker Tools Warning LNK4076](../../error-messages/tool-errors/linker-tools-warning-lnk4076.md) | invalid incremental status file 'filename'; linking nonincrementally | -| [Linker Tools Warning LNK4078](../../error-messages/tool-errors/linker-tools-warning-lnk4078.md) | multiple 'section name' sections found with different attributes | -| [Linker Tools Warning LNK4086](../../error-messages/tool-errors/linker-tools-warning-lnk4086.md) | entrypoint 'function' is not __stdcall with 'number' bytes of arguments; image may not run | -| [Linker Tools Warning LNK4092](../../error-messages/tool-errors/linker-tools-warning-lnk4092.md) | shared writable section 'section' contains relocations; image may not run correctly | -| [Linker Tools Warning LNK4096](../../error-messages/tool-errors/linker-tools-warning-lnk4096.md) | /BASE value "number" is invalid for Windows 95 and Windows 98; image may not run | -| [Linker Tools Warning LNK4098](../../error-messages/tool-errors/linker-tools-warning-lnk4098.md) | defaultlib '*library*' conflicts with use of other libs; use /NODEFAULTLIB:*library* | -| [Linker Tools Warning LNK4099](../../error-messages/tool-errors/linker-tools-warning-lnk4099.md) | PDB 'filename' was not found with 'object/library' or at 'path'; linking object as if no debug info | -| [Linker Tools Warning LNK4102](../../error-messages/tool-errors/linker-tools-warning-lnk4102.md) | export of deleting destructor 'name'; image may not run correctly | -| [Linker Tools Warning LNK4104](../../error-messages/tool-errors/linker-tools-warning-lnk4104.md) | export of symbol 'symbol' should be PRIVATE | -| [Linker Tools Warning LNK4105](../../error-messages/tool-errors/linker-tools-warning-lnk4105.md) | no argument specified with option 'option'; ignoring option | -| [Linker Tools Warning LNK4194](../../error-messages/tool-errors/linker-tools-warning-lnk4194.md) | /DELAYLOAD:dll name ignored | -| [Linker Tools Warning LNK4197](../../error-messages/tool-errors/linker-tools-warning-lnk4197.md) | export '*exportname*' specified multiple times; using first specification | -| [Linker Tools Warning LNK4199](../../error-messages/tool-errors/linker-tools-warning-lnk4199.md) | /DELAYLOAD:dllname ignored; no imports found from dllname | -| [Linker Tools Warning LNK4200](../../error-messages/tool-errors/linker-tools-warning-lnk4200.md) | corrupt line number information in object file; ignored | -| [Linker Tools Warning LNK4204](../../error-messages/tool-errors/linker-tools-warning-lnk4204.md) | 'filename' is missing debugging information for referencing module; linking object as if no debug info | -| [Linker Tools Warning LNK4205](../../error-messages/tool-errors/linker-tools-warning-lnk4205.md) | 'filename' is missing current debugging information for referencing module; linking object as if no debug info | -| [Linker Tools Warning LNK4206](../../error-messages/tool-errors/linker-tools-warning-lnk4206.md) | precompiled type information not found; '*filename*' not linked or overwritten; linking object as if no debug info | -| [Linker Tools Warning LNK4210](../../error-messages/tool-errors/linker-tools-warning-lnk4210.md) | section *section* exists; there may be unhandled static initializers or terminators | -| [Linker Tools Warning LNK4216](../../error-messages/tool-errors/linker-tools-warning-lnk4216.md) | Exported entry point entry | -| [Linker Tools Warning LNK4217](../../error-messages/tool-errors/linker-tools-warning-lnk4217.md) | symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' in function '*function*' | -| [Linker Tools Warning LNK4219](../../error-messages/tool-errors/linker-tools-warning-lnk4219.md) | fixup name fixup overflow. Target 'target symbol name' is out of range, inserting thunk | -| [Linker Tools Warning LNK4220](../../error-messages/tool-errors/linker-tools-warning-lnk4220.md) | invalid 'linker option' value 'value'; assumed default | -| [Linker Tools Warning LNK4221](../../error-messages/tool-errors/linker-tools-warning-lnk4221.md) | This object file does not define any previously undefined public symbols, so it will not be used by any link operation that consumes this library | -| [Linker Tools Warning LNK4222](../../error-messages/tool-errors/linker-tools-warning-lnk4222.md) | exported symbol 'symbol' should not be assigned an ordinal | -| [Linker Tools Warning LNK4224](../../error-messages/tool-errors/linker-tools-warning-lnk4224.md) | *option* is no longer supported; ignored | -| [Linker Tools Warning LNK4227](../../error-messages/tool-errors/linker-tools-warning-lnk4227.md) | metadata operation warning (*HRESULT*) : *warning_message* | -| [Linker Tools Warning LNK4229](../../error-messages/tool-errors/linker-tools-warning-lnk4229.md) | invalid directive /directive found; ignored | -| [Linker Tools Warning LNK4237](../../error-messages/tool-errors/linker-tools-warning-lnk4237.md) | /SUBSYSTEM:NATIVE specified when importing from 'dll'; Use /SUBSYSTEM:CONSOLE or /SUBSYSTEM:WINDOWS. | -| [Linker Tools Warning LNK4247](../../error-messages/tool-errors/linker-tools-warning-lnk4247.md) | entry point 'decorated_function_name' already has a thread attribute; 'attribute' ignored | -| [Linker Tools Warning LNK4248](../../error-messages/tool-errors/linker-tools-warning-lnk4248.md) | unresolved typeref token (token) for 'type'; image may not run | -| [Linker Tools Warning LNK4253](../../error-messages/tool-errors/linker-tools-warning-lnk4253.md) | section 'section1' not merged into 'section2'; already merged into 'section3' | -| [Linker Tools Warning LNK4254](../../error-messages/tool-errors/linker-tools-warning-lnk4254.md) | section 'section1' (offset) merged into 'section2' (offset) with different attributes | -| [Linker Tools Warning LNK4286](../../error-messages/tool-errors/linker-tools-warning-lnk4286.md) | symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' | -| [Linker Tools Warning LNK4306](../../error-messages/tool-errors/linker-tools-warning-lnk4306.md) | The auxiliary delayload import address table is not properly aligned with the primary delayload import address table. This may have negative perf impact. | -| [Linker Tools Warning LNK4307](../../error-messages/tool-errors/linker-tools-warning-lnk4307.md) | The auxiliary delayload import address table copy is not properly aligned with the auxiliary delayload import address table. This may have negative perf impact. | +| [Linker Tools Warning LNK4001](linker-tools-warning-lnk4001.md) | no object files specified; libraries used | +| [Linker Tools Warning LNK4002](linker-tools-warning-lnk4002.md) | symbol defined in object | +| [Linker Tools Warning LNK4006](linker-tools-warning-lnk4006.md) | symbol already defined in object; second definition ignored | +| [Linker Tools Warning LNK4010](linker-tools-warning-lnk4010.md) | invalid subsystem version number number; default subsystem version assumed | +| [Linker Tools Warning LNK4014](linker-tools-warning-lnk4014.md) | cannot find member object "objectname" | +| [Linker Tools Warning LNK4020](linker-tools-warning-lnk4020.md) | a type record in '*filename*' is corrupted; some symbols and types may not be accessible from the debugger | +| [Linker Tools Warning LNK4022](linker-tools-warning-lnk4022.md) | cannot find unique match for symbol 'symbol' | +| [Linker Tools Warning LNK4039](linker-tools-warning-lnk4039.md) | section 'name' specified with /SECTION option does not exist | +| [Linker Tools Warning LNK4044](linker-tools-warning-lnk4044.md) | unrecognized option 'option'; ignored | +| [Linker Tools Warning LNK4049](linker-tools-warning-lnk4049.md) | symbol '*symbol*' defined in '*filename.obj*' is imported | +| [Linker Tools Warning LNK4065](linker-tools-warning-lnk4065.md) | 'function' cannot be ordered; ignored | +| [Linker Tools Warning LNK4070](linker-tools-warning-lnk4070.md) | /OUT:filename directive in .EXP differs from output filename 'filename'; ignoring directive | +| [Linker Tools Warning LNK4071](linker-tools-warning-lnk4071.md) | cannot be incrementally linked on subsequent links | +| [Linker Tools Warning LNK4073](linker-tools-warning-lnk4073.md) | cannot create map for .ilk file; linking nonincrementally | +| [Linker Tools Warning LNK4075](linker-tools-warning-lnk4075.md) | ignoring "option1" due to "option2" specification | +| [Linker Tools Warning LNK4076](linker-tools-warning-lnk4076.md) | invalid incremental status file 'filename'; linking nonincrementally | +| [Linker Tools Warning LNK4078](linker-tools-warning-lnk4078.md) | multiple 'section name' sections found with different attributes | +| [Linker Tools Warning LNK4086](linker-tools-warning-lnk4086.md) | entrypoint 'function' is not __stdcall with 'number' bytes of arguments; image may not run | +| [Linker Tools Warning LNK4092](linker-tools-warning-lnk4092.md) | shared writable section 'section' contains relocations; image may not run correctly | +| [Linker Tools Warning LNK4096](linker-tools-warning-lnk4096.md) | /BASE value "number" is invalid for Windows 95 and Windows 98; image may not run | +| [Linker Tools Warning LNK4098](linker-tools-warning-lnk4098.md) | defaultlib '*library*' conflicts with use of other libs; use /NODEFAULTLIB:*library* | +| [Linker Tools Warning LNK4099](linker-tools-warning-lnk4099.md) | PDB 'filename' was not found with 'object/library' or at 'path'; linking object as if no debug info | +| [Linker Tools Warning LNK4102](linker-tools-warning-lnk4102.md) | export of deleting destructor 'name'; image may not run correctly | +| [Linker Tools Warning LNK4104](linker-tools-warning-lnk4104.md) | export of symbol 'symbol' should be PRIVATE | +| [Linker Tools Warning LNK4105](linker-tools-warning-lnk4105.md) | no argument specified with option 'option'; ignoring option | +| [Linker Tools Warning LNK4194](linker-tools-warning-lnk4194.md) | /DELAYLOAD:dll name ignored | +| [Linker Tools Warning LNK4197](linker-tools-warning-lnk4197.md) | export '*exportname*' specified multiple times; using first specification | +| [Linker Tools Warning LNK4199](linker-tools-warning-lnk4199.md) | /DELAYLOAD:dllname ignored; no imports found from dllname | +| [Linker Tools Warning LNK4200](linker-tools-warning-lnk4200.md) | corrupt line number information in object file; ignored | +| [Linker Tools Warning LNK4204](linker-tools-warning-lnk4204.md) | 'filename' is missing debugging information for referencing module; linking object as if no debug info | +| [Linker Tools Warning LNK4205](linker-tools-warning-lnk4205.md) | 'filename' is missing current debugging information for referencing module; linking object as if no debug info | +| [Linker Tools Warning LNK4206](linker-tools-warning-lnk4206.md) | precompiled type information not found; '*filename*' not linked or overwritten; linking object as if no debug info | +| [Linker Tools Warning LNK4210](linker-tools-warning-lnk4210.md) | section *section* exists; there may be unhandled static initializers or terminators | +| [Linker Tools Warning LNK4216](linker-tools-warning-lnk4216.md) | Exported entry point entry | +| [Linker Tools Warning LNK4217](linker-tools-warning-lnk4217.md) | symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' in function '*function*' | +| [Linker Tools Warning LNK4219](linker-tools-warning-lnk4219.md) | fixup name fixup overflow. Target 'target symbol name' is out of range, inserting thunk | +| [Linker Tools Warning LNK4220](linker-tools-warning-lnk4220.md) | invalid 'linker option' value 'value'; assumed default | +| [Linker Tools Warning LNK4221](linker-tools-warning-lnk4221.md) | This object file does not define any previously undefined public symbols, so it will not be used by any link operation that consumes this library | +| [Linker Tools Warning LNK4222](linker-tools-warning-lnk4222.md) | exported symbol 'symbol' should not be assigned an ordinal | +| [Linker Tools Warning LNK4224](linker-tools-warning-lnk4224.md) | *option* is no longer supported; ignored | +| [Linker Tools Warning LNK4227](linker-tools-warning-lnk4227.md) | metadata operation warning (*HRESULT*) : *warning_message* | +| [Linker Tools Warning LNK4229](linker-tools-warning-lnk4229.md) | invalid directive /directive found; ignored | +| [Linker Tools Warning LNK4237](linker-tools-warning-lnk4237.md) | /SUBSYSTEM:NATIVE specified when importing from 'dll'; Use /SUBSYSTEM:CONSOLE or /SUBSYSTEM:WINDOWS. | +| [Linker Tools Warning LNK4247](linker-tools-warning-lnk4247.md) | entry point 'decorated_function_name' already has a thread attribute; 'attribute' ignored | +| [Linker Tools Warning LNK4248](linker-tools-warning-lnk4248.md) | unresolved typeref token (token) for 'type'; image may not run | +| [Linker Tools Warning LNK4253](linker-tools-warning-lnk4253.md) | section 'section1' not merged into 'section2'; already merged into 'section3' | +| [Linker Tools Warning LNK4254](linker-tools-warning-lnk4254.md) | section 'section1' (offset) merged into 'section2' (offset) with different attributes | +| [Linker Tools Warning LNK4286](linker-tools-warning-lnk4286.md) | symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' | +| [Linker Tools Warning LNK4306](linker-tools-warning-lnk4306.md) | The auxiliary delayload import address table is not properly aligned with the primary delayload import address table. This may have negative perf impact. | +| [Linker Tools Warning LNK4307](linker-tools-warning-lnk4307.md) | The auxiliary delayload import address table copy is not properly aligned with the auxiliary delayload import address table. This may have negative perf impact. | ## See also From 8d4e032ad0fe0d3be6f465565ae5a1e3286eb6d9 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 11 Sep 2025 22:52:21 +0800 Subject: [PATCH 1172/1799] Fix more typos --- .../strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md | 2 +- docs/code-quality/c26402.md | 2 +- docs/cppcx/platform-collections-vector-class.md | 2 +- docs/cppcx/platform-comexception-class.md | 2 +- docs/cppcx/platform-exception-class.md | 2 +- docs/cppcx/wrl/hstring-class.md | 2 +- docs/dotnet/deque-stl-clr.md | 2 +- docs/dotnet/priority-queue-stl-clr.md | 6 +++--- docs/dotnet/vector-stl-clr.md | 2 +- .../concrt/reference/concurrency-namespace-functions.md | 4 ++-- docs/sanitizers/error-alloc-dealloc-mismatch.md | 2 +- docs/standard-library/file-status-class.md | 2 +- docs/standard-library/regex-constants-class.md | 2 +- 13 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md b/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md index 00ad10086c7..f71886451f9 100644 --- a/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md +++ b/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md @@ -74,7 +74,7 @@ Returns a pointer to the next token found in *`strToken`*. The functions return ## Remarks -The **`strtok`** function finds the next token in *`strToken`*. The set of characters in *`strDelimit`* specifies possible delimiters of the token to be found in *`strToken`* on the current call. **`wcstok`** and **`_mbstok`** are wide-character and multibyte-character versions of **`strtok`**. The arguments and return value of **`wcstok`** are wide-character strings. The argumets and return value of **`_mbstok`** are multibyte-character strings. These three functions behave identically otherwise. +The **`strtok`** function finds the next token in *`strToken`*. The set of characters in *`strDelimit`* specifies possible delimiters of the token to be found in *`strToken`* on the current call. **`wcstok`** and **`_mbstok`** are wide-character and multibyte-character versions of **`strtok`**. The arguments and return value of **`wcstok`** are wide-character strings. The arguments and return value of **`_mbstok`** are multibyte-character strings. These three functions behave identically otherwise. The two argument version of **`wcstok`** isn't standard. If you need to use that version, you'll need to define `_CRT_NON_CONFORMING_WCSTOK` before you `#include ` (or `#include `). diff --git a/docs/code-quality/c26402.md b/docs/code-quality/c26402.md index 16f0f248d2b..4b7a5f3daee 100644 --- a/docs/code-quality/c26402.md +++ b/docs/code-quality/c26402.md @@ -34,7 +34,7 @@ S* bad_example() return s; // C26402 } -// Prefer returning objects with move contructors by value instead of unnecessarily heap-allocating the object. +// Prefer returning objects with move constructors by value instead of unnecessarily heap-allocating the object. S good_example() noexcept { S s; diff --git a/docs/cppcx/platform-collections-vector-class.md b/docs/cppcx/platform-collections-vector-class.md index 56d9181e80a..47c1c014d54 100644 --- a/docs/cppcx/platform-collections-vector-class.md +++ b/docs/cppcx/platform-collections-vector-class.md @@ -176,7 +176,7 @@ The number of items retrieved. ### Remarks -This function is not intended for use directly by client code. It is used internally in the [to_vector Function](../cppcx/to-vector-function.md) to enable efficient conversion of Platform::Vector intances to std::vector instances. +This function is not intended for use directly by client code. It is used internally in the [to_vector Function](../cppcx/to-vector-function.md) to enable efficient conversion of Platform::Vector instances to std::vector instances. ## Vector::GetView Method diff --git a/docs/cppcx/platform-comexception-class.md b/docs/cppcx/platform-comexception-class.md index e76f69daed7..2c1311c0c18 100644 --- a/docs/cppcx/platform-comexception-class.md +++ b/docs/cppcx/platform-comexception-class.md @@ -73,7 +73,7 @@ The following predefined exceptions are derived from COMException. They differ f ## COMException::COMException Constructor -Intializes a new instance of the COMException class. +Initializes a new instance of the COMException class. ### Syntax diff --git a/docs/cppcx/platform-exception-class.md b/docs/cppcx/platform-exception-class.md index 4eb7e70d3dd..492cb3e3246 100644 --- a/docs/cppcx/platform-exception-class.md +++ b/docs/cppcx/platform-exception-class.md @@ -86,7 +86,7 @@ It is strongly recommended to use CreateException to create a strongly-typed exc ## Exception::Exception Constructor -Intializes a new instance of the Exception class. +Initializes a new instance of the Exception class. ### Syntax diff --git a/docs/cppcx/wrl/hstring-class.md b/docs/cppcx/wrl/hstring-class.md index c29a4a6cff1..e806bcc18c3 100644 --- a/docs/cppcx/wrl/hstring-class.md +++ b/docs/cppcx/wrl/hstring-class.md @@ -340,7 +340,7 @@ The second parameter to compare. *rhs* can be a reference to an `HString`. ## HString::Release -Deletes the underlying string value and intializes the current `HString` object to an empty value. +Deletes the underlying string value and initializes the current `HString` object to an empty value. ```cpp void Release() throw() diff --git a/docs/dotnet/deque-stl-clr.md b/docs/dotnet/deque-stl-clr.md index 9961dd1c212..75526331ca5 100644 --- a/docs/dotnet/deque-stl-clr.md +++ b/docs/dotnet/deque-stl-clr.md @@ -1567,7 +1567,7 @@ Position of element to access. ### Remarks -The member operator returns a referene to the element at position *pos*. You use it to access an element whose position you know. +The member operator returns a reference to the element at position *pos*. You use it to access an element whose position you know. ### Example diff --git a/docs/dotnet/priority-queue-stl-clr.md b/docs/dotnet/priority-queue-stl-clr.md index 3dc4e67eb65..2ce9a39c28c 100644 --- a/docs/dotnet/priority-queue-stl-clr.md +++ b/docs/dotnet/priority-queue-stl-clr.md @@ -701,19 +701,19 @@ The constructor: `template priority_queue(InIt first, InIt last);` -creates an empty wrapped container, with the default ordering predicate, then pushes the sequence [`first`, `last`). You use it to specify an initial controlled sequence from a specified eqeuence, with the specified ordering predicate. +creates an empty wrapped container, with the default ordering predicate, then pushes the sequence [`first`, `last`). You use it to specify an initial controlled sequence from a specified sequence, with the specified ordering predicate. The constructor: `template priority_queue(InIt first, InIt last, value_compare^ pred);` -creates an empty wrapped container, with the ordering predicate *pred*, then pushes the sequence [`first`, `last`). You use it to specify an initial controlled sequence from a specified seqeuence, with the specified ordering predicate. +creates an empty wrapped container, with the ordering predicate *pred*, then pushes the sequence [`first`, `last`). You use it to specify an initial controlled sequence from a specified sequence, with the specified ordering predicate. The constructor: `template priority_queue(InIt first, InIt last, value_compare^ pred, container_type% cont);` -creates an empty wrapped container, with the ordering predicate *pred*, then pushes all the elements of *cont* plus the sequence [`first`, `last`). You use it to specify an initial controlled sequence from an existing container and a specified seqeuence, with the specified ordering predicate. +creates an empty wrapped container, with the ordering predicate *pred*, then pushes all the elements of *cont* plus the sequence [`first`, `last`). You use it to specify an initial controlled sequence from an existing container and a specified sequence, with the specified ordering predicate. ### Example diff --git a/docs/dotnet/vector-stl-clr.md b/docs/dotnet/vector-stl-clr.md index c6c3fd953cd..975c260d850 100644 --- a/docs/dotnet/vector-stl-clr.md +++ b/docs/dotnet/vector-stl-clr.md @@ -1454,7 +1454,7 @@ Position of element to access. ### Remarks -The member operator returns a referene to the element at position *pos*. You use it to access an element whose position you know. +The member operator returns a reference to the element at position *pos*. You use it to access an element whose position you know. ### Example diff --git a/docs/parallel/concrt/reference/concurrency-namespace-functions.md b/docs/parallel/concrt/reference/concurrency-namespace-functions.md index 10f4a1627f6..76ea97d01de 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-functions.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-functions.md @@ -168,11 +168,11 @@ The return type of the lambda determines whether the construct is an action or a Lambdas that return void cause the creation of actions. Lambdas that return a result of type `TResult` cause the creation of operations of TResult. -The lambda may also return a `task` which encapsulates the aysnchronous work within itself or is the continuation of a chain of tasks that represent the asynchronous work. In this case, the lambda itself is executed inline, since the tasks are the ones that execute asynchronously, and the return type of the lambda is unwrapped to produce the asynchronous construct returned by `create_async`. This implies that a lambda that returns a task\ will cause the creation of actions, and a lambda that returns a task\ will cause the creation of operations of TResult. +The lambda may also return a `task` which encapsulates the asynchronous work within itself or is the continuation of a chain of tasks that represent the asynchronous work. In this case, the lambda itself is executed inline, since the tasks are the ones that execute asynchronously, and the return type of the lambda is unwrapped to produce the asynchronous construct returned by `create_async`. This implies that a lambda that returns a task\ will cause the creation of actions, and a lambda that returns a task\ will cause the creation of operations of TResult. The lambda may take either zero, one or two arguments. The valid arguments are `progress_reporter` and `cancellation_token`, in that order if both are used. A lambda without arguments causes the creation of an asynchronous construct without the capability for progress reporting. A lambda that takes a progress_reporter\ will cause `create_async` to return an asynchronous construct which reports progress of type TProgress each time the `report` method of the progress_reporter object is called. A lambda that takes a cancellation_token may use that token to check for cancellation, or pass it to tasks that it creates so that cancellation of the asynchronous construct causes cancellation of those tasks. -If the body of the lambda or function object returns a result (and not a task\), the lamdba will be executed asynchronously within the process MTA in the context of a task the Runtime implicitly creates for it. The `IAsyncInfo::Cancel` method will cause cancellation of the implicit task. +If the body of the lambda or function object returns a result (and not a task\), the lambda will be executed asynchronously within the process MTA in the context of a task the Runtime implicitly creates for it. The `IAsyncInfo::Cancel` method will cause cancellation of the implicit task. If the body of the lambda returns a task, the lambda executes inline, and by declaring the lambda to take an argument of type `cancellation_token` you can trigger cancellation of any tasks you create within the lambda by passing that token in when you create them. You may also use the `register_callback` method on the token to cause the Runtime to invoke a callback when you call `IAsyncInfo::Cancel` on the async operation or action produced. diff --git a/docs/sanitizers/error-alloc-dealloc-mismatch.md b/docs/sanitizers/error-alloc-dealloc-mismatch.md index 22cf7f620f0..b68efaf0413 100644 --- a/docs/sanitizers/error-alloc-dealloc-mismatch.md +++ b/docs/sanitizers/error-alloc-dealloc-mismatch.md @@ -44,7 +44,7 @@ int main(int argc, char* argv[]) } ``` -In a Visual Studio 2019 version 16.9 or later [developer command prompt](../build/building-on-the-command-line.md#developer_command_prompt_shortcuts), run the following commands to see an exampe of `alloc_dealloc_mismatch`: +In a Visual Studio 2019 version 16.9 or later [developer command prompt](../build/building-on-the-command-line.md#developer_command_prompt_shortcuts), run the following commands to see an example of `alloc_dealloc_mismatch`: ```cmd cl example1.cpp /fsanitize=address /Zi diff --git a/docs/standard-library/file-status-class.md b/docs/standard-library/file-status-class.md index 1dbed5fb4bb..916449263c2 100644 --- a/docs/standard-library/file-status-class.md +++ b/docs/standard-library/file-status-class.md @@ -74,7 +74,7 @@ The defaulted member assignment operators behave as expected. ```cpp file_status& operator=(const file_status&) noexcept = default; -file_status& operator=(file_status&&) nexcept = default; +file_status& operator=(file_status&&) noexcept = default; ``` ### Parameters diff --git a/docs/standard-library/regex-constants-class.md b/docs/standard-library/regex-constants-class.md index 63ef9ea01f1..9dc501614ad 100644 --- a/docs/standard-library/regex-constants-class.md +++ b/docs/standard-library/regex-constants-class.md @@ -199,7 +199,7 @@ The syntax modifiers are: `icase` -- make matches case-insensitive -`nosubs` -- the implementaton need not keep track of the contents of capture groups +`nosubs` -- the implementation need not keep track of the contents of capture groups `optimize` -- the implementation should emphasize speed of matching rather than speed of regular expression compilation From cb5ccb99fcae5e412254dbf4ef2b0abd83602419 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 11 Sep 2025 22:58:44 +0800 Subject: [PATCH 1173/1799] Update metadata in 11 topics --- .../strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md | 5 ++--- docs/code-quality/c26402.md | 3 +-- docs/cppcx/platform-collections-vector-class.md | 5 ++--- docs/cppcx/platform-comexception-class.md | 2 +- docs/cppcx/platform-exception-class.md | 2 +- docs/cppcx/wrl/hstring-class.md | 5 ++--- docs/dotnet/deque-stl-clr.md | 2 +- docs/dotnet/priority-queue-stl-clr.md | 5 ++--- docs/dotnet/vector-stl-clr.md | 2 +- docs/standard-library/file-status-class.md | 5 ++--- docs/standard-library/regex-constants-class.md | 5 ++--- 11 files changed, 17 insertions(+), 24 deletions(-) diff --git a/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md b/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md index f71886451f9..d257087249c 100644 --- a/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md +++ b/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l" title: "strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l" -ms.date: "6/24/2020" +description: "Learn more about: strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l" +ms.date: 6/24/2020 api_name: ["_mbstok_l", "_mbstok", "wcstok", "_mbstok", "strtok", "_wcstok_l", "_o__mbstok", "_o__mbstok_l", "_o_strtok", "_o_wcstok"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-multibyte-l1-1-0.dll", "api-ms-win-crt-string-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["STRING/strtok", "TCHAR/_strtok_l", "MBSTRING/_mbstok", "MBSTRING/_mbstok_l", "CORECRT_WSTRING/wcstok", "TCHAR/_wcstok_l", "TCHAR/_tcstok", "TCHAR/_tcstok_l", "strtok", "strtok_l", "_mbstok", "_mbstok_l", "wcstok", "_wcstok_l", "_tcstok", "_tcstok_l"] helpviewer_keywords: ["mbstok_l function", "strings [C++], searching", "tcstok function", "_tcstok function", "_strtok_l function", "strtok function", "mbstok function", "wcstok_l function", "_mbstok function", "tcstok_l function", "tokens, finding in strings", "_mbstok_l function", "wcstok function", "_wcstok_l function", "_tcstok_l function", "strtok_l function"] -ms.assetid: 904cb734-f0d7-4d77-ba81-4791ddf461ae --- # `strtok`, `_strtok_l`, `wcstok`, `_wcstok_l`, `_mbstok`, `_mbstok_l` diff --git a/docs/code-quality/c26402.md b/docs/code-quality/c26402.md index 4b7a5f3daee..d375a3128c5 100644 --- a/docs/code-quality/c26402.md +++ b/docs/code-quality/c26402.md @@ -1,10 +1,9 @@ --- +title: "Warning C26402" description: "Learn more about: Warning C26402 DONT_HEAP_ALLOCATE_MOVABLE_RESULT" -title: Warning C26402 ms.date: 08/20/2020 f1_keywords: ["C26402", "DONT_HEAP_ALLOCATE_MOVABLE_RESULT"] helpviewer_keywords: ["C26402"] -ms.assetid: b9d3d398-697a-4a5d-8bfe-9c667dffb90b --- # Warning C26402 diff --git a/docs/cppcx/platform-collections-vector-class.md b/docs/cppcx/platform-collections-vector-class.md index 47c1c014d54..4bb382e37ef 100644 --- a/docs/cppcx/platform-collections-vector-class.md +++ b/docs/cppcx/platform-collections-vector-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::Collections::Vector Class" title: "Platform::Collections::Vector Class" -ms.date: "12/04/2019" +description: "Learn more about: Platform::Collections::Vector Class" +ms.date: 12/04/2019 ms.topic: "reference" f1_keywords: ["COLLECTION/Platform::Collections::Vector::Vector", "COLLECTION/Platform::Collections::Vector::Append", "COLLECTION/Platform::Collections::Vector::Clear", "COLLECTION/Platform::Collections::Vector::First", "COLLECTION/Platform::Collections::Vector::GetAt", "COLLECTION/Platform::Collections::Vector::GetMany", "COLLECTION/Platform::Collections::Vector::GetView", "COLLECTION/Platform::Collections::Vector::IndexOf", "COLLECTION/Platform::Collections::Vector::InsertAt", "COLLECTION/Platform::Collections::Vector::ReplaceAll", "COLLECTION/Platform::Collections::Vector::RemoveAt", "COLLECTION/Platform::Collections::Vector::RemoveAtEnd", "COLLECTION/Platform::Collections::Vector::SetAt", "COLLECTION/Platform::Collections::Vector::Size", "COLLECTION/Platform::Collections::Vector::VectorChanged"] helpviewer_keywords: ["Vector Class (C++/Cx)"] -ms.assetid: aee8c076-9700-47c3-99b6-799fd3edb0ca --- # Platform::Collections::Vector Class diff --git a/docs/cppcx/platform-comexception-class.md b/docs/cppcx/platform-comexception-class.md index 2c1311c0c18..42aaeb78ad9 100644 --- a/docs/cppcx/platform-comexception-class.md +++ b/docs/cppcx/platform-comexception-class.md @@ -1,7 +1,7 @@ --- title: "Platform::COMException Class" description: "Learn more about: Platform::COMException Class" -ms.date: "12/30/2016" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::COMException", "VCCORLIB/Platform::COMException::HResult", "VCCORLIB/Platform::COMException::Message"] helpviewer_keywords: ["Platform::COMException Class"] diff --git a/docs/cppcx/platform-exception-class.md b/docs/cppcx/platform-exception-class.md index 492cb3e3246..32f89702c67 100644 --- a/docs/cppcx/platform-exception-class.md +++ b/docs/cppcx/platform-exception-class.md @@ -1,7 +1,7 @@ --- title: "Platform::Exception Class" description: "Learn more about: Platform::Exception Class" -ms.date: "12/30/2016" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::Exception::Exception", "VCCORLIB/Platform::Exception::CreateException", "VCCORLIB/Platform::Exception::HResult", "VCCORLIB/Platform::Exception::Message"] helpviewer_keywords: ["Platform::Exception Class"] diff --git a/docs/cppcx/wrl/hstring-class.md b/docs/cppcx/wrl/hstring-class.md index e806bcc18c3..1d9df0ceedf 100644 --- a/docs/cppcx/wrl/hstring-class.md +++ b/docs/cppcx/wrl/hstring-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: HString Class" title: "HString Class" -ms.date: "07/15/2019" +description: "Learn more about: HString Class" +ms.date: 07/15/2019 ms.topic: "reference" f1_keywords: ["corewrappers/Microsoft::WRL::Wrappers::HString", "corewrappers/Microsoft::WRL::Wrappers::HString::Attach", "corewrappers/Microsoft::WRL::Wrappers::HString::CopyTo", "corewrappers/Microsoft::WRL::Wrappers::HString::Detach", "corewrappers/Microsoft::WRL::Wrappers::HString::Get", "corewrappers/Microsoft::WRL::Wrappers::HString::GetRawBuffer","corewrappers/Microsoft::WRL::Wrappers::HString::GetAddressOf", "corewrappers/Microsoft::WRL::Wrappers::HString::HString", "corewrappers/Microsoft::WRL::Wrappers::HString::IsValid", "corewrappers/Microsoft::WRL::Wrappers::HString::MakeReference", "corewrappers/Microsoft::WRL::Wrappers::HString::operator=", "corewrappers/Microsoft::WRL::Wrappers::HString::operator==", "corewrappers/Microsoft::WRL::Wrappers::HString::operator!=", "corewrappers/Microsoft::WRL::Wrappers::HString::operator<", "corewrappers/Microsoft::WRL::Wrappers::HString::Release", "corewrappers/Microsoft::WRL::Wrappers::HString::Set", "corewrappers/Microsoft::WRL::Wrappers::HString::~HString"] helpviewer_keywords: ["Microsoft::WRL::Wrappers::HString class", "Microsoft::WRL::Wrappers::HString::Attach method", "Microsoft::WRL::Wrappers::HString::CopyTo method", "Microsoft::WRL::Wrappers::HString::Detach method", "Microsoft::WRL::Wrappers::HString::Get method", "Microsoft::WRL::Wrappers::HString::GetAddressOf method", "Microsoft::WRL::Wrappers::HString::HString, constructor", "Microsoft::WRL::Wrappers::HString::IsValid method", "Microsoft::WRL::Wrappers::HString::MakeReference method", "Microsoft::WRL::Wrappers::HString::operator= operator", "Microsoft::WRL::Wrappers::HString::operator== operator", "Microsoft::WRL::Wrappers::HString::operator!= operator", "Microsoft::WRL::Wrappers::HString::operator< operator", "Microsoft::WRL::Wrappers::HString::Release method", "Microsoft::WRL::Wrappers::HString::Set method", "Microsoft::WRL::Wrappers::HString::~HString, destructor"] -ms.assetid: 6709dd2e-8d72-4675-8ec7-1baa7d71854d --- # HString Class diff --git a/docs/dotnet/deque-stl-clr.md b/docs/dotnet/deque-stl-clr.md index 75526331ca5..8a4ef045094 100644 --- a/docs/dotnet/deque-stl-clr.md +++ b/docs/dotnet/deque-stl-clr.md @@ -1,7 +1,7 @@ --- title: "deque (STL/CLR)" description: "Learn more about: deque (STL/CLR)" -ms.date: "11/04/2016" +ms.date: 11/04/2016 ms.topic: "reference" f1_keywords: ["cliext::deque", "cliext::deque::assign", "cliext::deque::at", "cliext::deque::back", "cliext::deque::back_item", "cliext::deque::begin", "cliext::deque::clear", "cliext::deque::const_iterator", "cliext::deque::const_reference", "cliext::deque::const_reverse_iterator", "cliext::deque::deque", "cliext::deque::difference_type", "cliext::deque::empty", "cliext::deque::end", "cliext::deque::erase", "cliext::deque::front", "cliext::deque::front_item", "cliext::deque::generic_container", "cliext::deque::generic_iterator", "cliext::deque::generic_reverse_iterator", "cliext::deque::generic_value", "cliext::deque::insert", "cliext::deque::iterator", "cliext::deque::operator!=", "cliext::deque::operator[]", "cliext::deque::pop_back", "cliext::deque::pop_front", "cliext::deque::push_back", "cliext::deque::push_front", "cliext::deque::rbegin", "cliext::deque::reference", "cliext::deque::rend", "cliext::deque::resize", "cliext::deque::reverse_iterator", "cliext::deque::size", "cliext::deque::size_type", "cliext::deque::swap", "cliext::deque::to_array", "cliext::deque::value_type", "cliext::deque::operator<", "cliext::deque::operator<=", "cliext::deque::operator=", "cliext::deque::operator==", "cliext::deque::operator>", "cliext::deque::operator>="] helpviewer_keywords: ["deque class [STL/CLR]", " header [STL/CLR]", " header [STL/CLR]", "assign member [STL/CLR]", "assign member [STL/CLR]", "at member [STL/CLR]", "back member [STL/CLR]", "back_item member [STL/CLR]", "begin member [STL/CLR]", "clear member [STL/CLR]", "const_iterator member [STL/CLR]", "const_reference member [STL/CLR]", "const_reverse_iterator member [STL/CLR]", "deque member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "end member [STL/CLR]", "erase member [STL/CLR]", "front member [STL/CLR]", "front_item member [STL/CLR]", "generic_container member [STL/CLR]", "generic_iterator member [STL/CLR]", "generic_reverse_iterator member [STL/CLR]", "generic_value member [STL/CLR]", "insert member [STL/CLR]", "iterator member [STL/CLR]", "operator!= member [STL/CLR]", "operator member [] [STL/CLR]", "pop_back member [STL/CLR]", "pop_front member [STL/CLR]", "push_back member [STL/CLR]", "push_front member [STL/CLR]", "rbegin member [STL/CLR]", "reference member [STL/CLR]", "rend member [STL/CLR]", "resize member [STL/CLR]", "reverse_iterator member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "swap member [STL/CLR]", "to_array member [STL/CLR]", "value_type member [STL/CLR]", "operator< member [STL/CLR]", "operator<= member [STL/CLR]", "operator= member [STL/CLR]", "operator== member [STL/CLR]", "operator> member [STL/CLR]", "operator>= member [STL/CLR]"] diff --git a/docs/dotnet/priority-queue-stl-clr.md b/docs/dotnet/priority-queue-stl-clr.md index 2ce9a39c28c..220f5b91d1b 100644 --- a/docs/dotnet/priority-queue-stl-clr.md +++ b/docs/dotnet/priority-queue-stl-clr.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: priority_queue (STL/CLR)" title: "priority_queue (STL/CLR)" -ms.date: "11/04/2016" +description: "Learn more about: priority_queue (STL/CLR)" +ms.date: 11/04/2016 ms.topic: "reference" f1_keywords: ["cliext::priority_queue", "cliext::priority_queue::assign", "cliext::priority_queue::const_reference", "cliext::priority_queue::container_type", "cliext::priority_queue::difference_type", "cliext::priority_queue::empty", "cliext::priority_queue::generic_container", "cliext::priority_queue::generic_value", "cliext::priority_queue::get_container", "cliext::priority_queue::operator=", "cliext::priority_queue::pop", "cliext::priority_queue::priority_queue", "cliext::priority_queue::push", "cliext::priority_queue::reference", "cliext::priority_queue::size", "cliext::priority_queue::size_type", "cliext::priority_queue::to_array", "cliext::priority_queue::top", "cliext::priority_queue::top_item", "cliext::priority_queue::value_comp", "cliext::priority_queue::value_compare", "cliext::priority_queue::value_type"] helpviewer_keywords: ["priority_queue class [STL/CLR]", " header [STL/CLR]", " header [STL/CLR]", "assign member [STL/CLR]", "const_reference member [STL/CLR]", "container_type member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "generic_container member [STL/CLR]", "generic_value member [STL/CLR]", "get_container member [STL/CLR]", "operator= member [STL/CLR]", "pop member [STL/CLR]", "priority_queue member [STL/CLR]", "push member [STL/CLR]", "reference member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "to_array member [STL/CLR]", "top member [STL/CLR]", "top_item member [STL/CLR]", "value_comp member [STL/CLR]", "value_compare member [STL/CLR]", "value_type member [STL/CLR]"] -ms.assetid: 4d0000d3-68ff-4c4b-8157-7060540136f5 --- # priority_queue (STL/CLR) diff --git a/docs/dotnet/vector-stl-clr.md b/docs/dotnet/vector-stl-clr.md index 975c260d850..c9469c0b712 100644 --- a/docs/dotnet/vector-stl-clr.md +++ b/docs/dotnet/vector-stl-clr.md @@ -1,7 +1,7 @@ --- title: "vector (STL/CLR)" description: "Learn more about: vector (STL/CLR)" -ms.date: "11/04/2016" +ms.date: 11/04/2016 ms.topic: "reference" f1_keywords: ["cliext::vector", "cliext::vector::assign", "cliext::vector::at", "cliext::vector::back", "cliext::vector::back_item", "cliext::vector::begin", "cliext::vector::capacity", "cliext::vector::clear", "cliext::vector::const_iterator", "cliext::vector::const_reference", "cliext::vector::const_reverse_iterator", "cliext::vector::difference_type", "cliext::vector::empty", "cliext::vector::end", "cliext::vector::erase", "cliext::vector::front", "cliext::vector::front_item", "cliext::vector::generic_container", "cliext::vector::generic_iterator", "cliext::vector::generic_reverse_iterator", "cliext::vector::generic_value", "cliext::vector::insert", "cliext::vector::iterator", "cliext::vector::operator=", "cliext::vector::operator", "cliext::vector::pop_back", "cliext::vector::push_back", "cliext::vector::rbegin", "cliext::vector::reference", "cliext::vector::rend", "cliext::vector::reserve", "cliext::vector::resize", "cliext::vector::reverse_iterator", "cliext::vector::size", "cliext::vector::size_type", "cliext::vector::swap", "cliext::vector::to_array", "cliext::vector::value_type", "cliext::vector::vector"] helpviewer_keywords: ["vector class [STL/CLR]", " header [STL/CLR]", " header [STL/CLR]", "operator!= member [STL/CLR]", "operator< member [STL/CLR]", "operator<= member [STL/CLR]", "operator== member [STL/CLR]", "operator> (vector) member [STL/CLR]", "operator>= member [STL/CLR]", "assign member [STL/CLR]", "at member [STL/CLR]", "back member [STL/CLR]", "back_item member [STL/CLR]", "begin member [STL/CLR]", "capacity member [STL/CLR]", "clear member [STL/CLR]", "const_iterator member [STL/CLR]", "const_reference member [STL/CLR]", "const_reverse_iterator member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "end member [STL/CLR]", "erase member [STL/CLR]", "front member [STL/CLR]", "front_item member [STL/CLR]", "generic_container member [STL/CLR]", "generic_iterator member [STL/CLR]", "generic_reverse_iterator member [STL/CLR]", "generic_value member [STL/CLR]", "insert member [STL/CLR]", "iterator member [STL/CLR]", "operator= member [STL/CLR]", "operator member [STL/CLR]", "pop_back member [STL/CLR]", "push_back member [STL/CLR]", "rbegin member [STL/CLR]", "reference member [STL/CLR]", "rend member [STL/CLR]", "reserve member [STL/CLR]", "resize member [STL/CLR]", "reverse_iterator member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "swap member [STL/CLR]", "to_array member [STL/CLR]", "value_type member [STL/CLR]", "vector member [STL/CLR]"] diff --git a/docs/standard-library/file-status-class.md b/docs/standard-library/file-status-class.md index 916449263c2..02d399d3cd9 100644 --- a/docs/standard-library/file-status-class.md +++ b/docs/standard-library/file-status-class.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: file_status Class" title: "file_status Class" -ms.date: "09/10/2018" +description: "Learn more about: file_status Class" +ms.date: 09/10/2018 f1_keywords: ["filesystem/std::experimental::filesystem::file_status", "filesystem/std::experimental::filesystem::file_status::operator=", "filesystem/std::experimental::filesystem::file_status::type", "filesystem/std::experimental::filesystem::file_status::permissions"] -ms.assetid: 9781840e-ad22-44dd-ad79-0fabaa94bac4 helpviewer_keywords: ["std::experimental::filesystem::file_status", "std::experimental::filesystem::file_status::operator=", "std::experimental::filesystem::file_status::type", "std::experimental::filesystem::file_status::permissions"] --- # file_status Class diff --git a/docs/standard-library/regex-constants-class.md b/docs/standard-library/regex-constants-class.md index 9dc501614ad..df849bdbf67 100644 --- a/docs/standard-library/regex-constants-class.md +++ b/docs/standard-library/regex-constants-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: regex_constants namespace" title: "regex_constants Class" -ms.date: "09/10/2018" +description: "Learn more about: regex_constants namespace" +ms.date: 09/10/2018 f1_keywords: ["regex/std::regex_constants", "regex/std::regex_constants::error_collate", "regex/std::regex_constants::error_ctype", "regex/std::regex_constants::error_escape", "regex/std::regex_constants::error_backref", "regex/std::regex_constants::error_brack", "regex/std::regex_constants::error_paren", "regex/std::regex_constants::error_brace", "regex/std::regex_constants::error_badbrace", "regex/std::regex_constants::error_range", "regex/std::regex_constants::error_space", "regex/std::regex_constants::error_badrepeat", "regex/std::regex_constants::error_complexity", "regex/std::regex_constants::error_stack", "regex/std::regex_constants::error_parse", "regex/std::regex_constants::error_syntax", "regex/std::regex_constants::match_default", "regex/std::regex_constants::match_not_bol", "regex/std::regex_constants::match_not_eol", "regex/std::regex_constants::match_not_bow", "regex/std::regex_constants::match_not_eow", "regex/std::regex_constants::match_any", "regex/std::regex_constants::match_not_null", "regex/std::regex_constants::match_continuous", "regex/std::regex_constants::match_prev_avail", "regex/std::regex_constants::format_default", "regex/std::regex_constants::format_sed", "regex/std::regex_constants::format_no_copy", "regex/std::regex_constants::format_first_only", "regex/std::regex_constants::ECMAScript", "regex/std::regex_constants::basic", "regex/std::regex_constants::extended", "regex/std::regex_constants::awk", "regex/std::regex_constants::grep", "regex/std::regex_constants::egrep", "regex/std::regex_constants::icase", "regex/std::regex_constants::nosubs", "regex/std::regex_constants::optimize", "regex/std::regex_constants::collate"] helpviewer_keywords: ["std::regex_constants [C++]", "std::regex_constants [C++], error_collate", "std::regex_constants [C++], error_ctype", "std::regex_constants [C++], error_escape", "std::regex_constants [C++], error_backref", "std::regex_constants [C++], error_brack", "std::regex_constants [C++], error_paren", "std::regex_constants [C++], error_brace", "std::regex_constants [C++], error_badbrace", "std::regex_constants [C++], error_range", "std::regex_constants [C++], error_space", "std::regex_constants [C++], error_badrepeat", "std::regex_constants [C++], error_complexity", "std::regex_constants [C++], error_stack", "std::regex_constants [C++], error_parse", "std::regex_constants [C++], error_syntax", "std::regex_constants [C++], match_default", "std::regex_constants [C++], match_not_bol", "std::regex_constants [C++], match_not_eol", "std::regex_constants [C++], match_not_bow", "std::regex_constants [C++], match_not_eow", "std::regex_constants [C++], match_any", "std::regex_constants [C++], match_not_null", "std::regex_constants [C++], match_continuous", "std::regex_constants [C++], match_prev_avail", "std::regex_constants [C++], format_default", "std::regex_constants [C++], format_sed", "std::regex_constants [C++], format_no_copy", "std::regex_constants [C++], format_first_only", "std::regex_constants [C++], ECMAScript", "std::regex_constants [C++], basic", "std::regex_constants [C++], extended", "std::regex_constants [C++], awk", "std::regex_constants [C++], grep", "std::regex_constants [C++], egrep", "std::regex_constants [C++], icase", "std::regex_constants [C++], nosubs", "std::regex_constants [C++], optimize", "std::regex_constants [C++], collate"] -ms.assetid: 4a69c0ba-c46d-46e4-bd29-6f4efb805f26 --- # regex_constants namespace From 06f02a3b822ce70a3c282aef3d5a324660c4aadc Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 11 Sep 2025 23:08:27 +0800 Subject: [PATCH 1174/1799] Add blockquotes for warning messages in range [BK4502, BK4504] --- docs/error-messages/tool-errors/bscmake-warning-bk4502.md | 2 +- docs/error-messages/tool-errors/bscmake-warning-bk4503.md | 2 +- docs/error-messages/tool-errors/bscmake-warning-bk4504.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4502.md b/docs/error-messages/tool-errors/bscmake-warning-bk4502.md index 3833aaf85e3..ca60292fbc3 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4502.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4502.md @@ -8,7 +8,7 @@ ms.assetid: ee412ec8-df03-4cdb-91ee-5d609ded8691 --- # BSCMAKE Warning BK4502 -truncated .SBR file 'filename' not in filename +> truncated .SBR file 'filename' not in filename A zero-length .sbr file that was not originally part of the .bsc file was specified during an update. diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4503.md b/docs/error-messages/tool-errors/bscmake-warning-bk4503.md index cf38c46292b..dbe8ccf97b0 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4503.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4503.md @@ -8,6 +8,6 @@ ms.assetid: 68abcf23-6987-4bc5-9745-8b65d2578bbc --- # BSCMAKE Warning BK4503 -minor error in .SBR file filename ignored +> minor error in .SBR file filename ignored The .sbr file contained an error that did not halt the build, but the resulting .bsc file may be incorrect. To fix this issue, recompile to create a new .sbr. diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4504.md b/docs/error-messages/tool-errors/bscmake-warning-bk4504.md index 7bb4fbdd2d2..c78f7baa5f7 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4504.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4504.md @@ -8,7 +8,7 @@ ms.assetid: b56ee2d4-ad44-40f4-98c0-75934ea44a6c --- # BSCMAKE Warning BK4504 -file contains too many references; ignoring further references from this source +> file contains too many references; ignoring further references from this source The .cpp file contains more than 64,000 symbol references. When BSCMAKE has encountered 64,000 references in a file, it ignores all further references. From 8f1816ccde840929b783d71e591da2adf7b32409 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 11 Sep 2025 23:09:18 +0800 Subject: [PATCH 1175/1799] Add "Remarks" headings for warning references in range [BK4502, BK4504] --- docs/error-messages/tool-errors/bscmake-warning-bk4502.md | 2 ++ docs/error-messages/tool-errors/bscmake-warning-bk4503.md | 2 ++ docs/error-messages/tool-errors/bscmake-warning-bk4504.md | 2 ++ 3 files changed, 6 insertions(+) diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4502.md b/docs/error-messages/tool-errors/bscmake-warning-bk4502.md index ca60292fbc3..8ef2e3cb875 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4502.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4502.md @@ -10,6 +10,8 @@ ms.assetid: ee412ec8-df03-4cdb-91ee-5d609ded8691 > truncated .SBR file 'filename' not in filename +## Remarks + A zero-length .sbr file that was not originally part of the .bsc file was specified during an update. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4503.md b/docs/error-messages/tool-errors/bscmake-warning-bk4503.md index dbe8ccf97b0..8af2a1b3ac8 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4503.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4503.md @@ -10,4 +10,6 @@ ms.assetid: 68abcf23-6987-4bc5-9745-8b65d2578bbc > minor error in .SBR file filename ignored +## Remarks + The .sbr file contained an error that did not halt the build, but the resulting .bsc file may be incorrect. To fix this issue, recompile to create a new .sbr. diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4504.md b/docs/error-messages/tool-errors/bscmake-warning-bk4504.md index c78f7baa5f7..edf755b5631 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4504.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4504.md @@ -10,6 +10,8 @@ ms.assetid: b56ee2d4-ad44-40f4-98c0-75934ea44a6c > file contains too many references; ignoring further references from this source +## Remarks + The .cpp file contains more than 64,000 symbol references. When BSCMAKE has encountered 64,000 references in a file, it ignores all further references. To correct the problem, either split the file into two or more files, each of which has fewer than 64,000 symbol references, or use the `#pragma component(browser)` preprocessor directive to limit symbols that are generated for particular references. For more information, see [component](../../preprocessor/component.md). From 30510df0cf838821ebd5b9781999e6bd8eb83d19 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 11 Sep 2025 23:13:19 +0800 Subject: [PATCH 1176/1799] Update metadata for warning references in range [BK4502, BK4504] --- docs/error-messages/tool-errors/bscmake-warning-bk4502.md | 5 ++--- docs/error-messages/tool-errors/bscmake-warning-bk4503.md | 5 ++--- docs/error-messages/tool-errors/bscmake-warning-bk4504.md | 5 ++--- 3 files changed, 6 insertions(+), 9 deletions(-) diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4502.md b/docs/error-messages/tool-errors/bscmake-warning-bk4502.md index 8ef2e3cb875..611b37bdcf7 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4502.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4502.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Warning BK4502" title: "BSCMAKE Warning BK4502" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Warning BK4502" +ms.date: 11/04/2016 f1_keywords: ["BK4502"] helpviewer_keywords: ["BK4502"] -ms.assetid: ee412ec8-df03-4cdb-91ee-5d609ded8691 --- # BSCMAKE Warning BK4502 diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4503.md b/docs/error-messages/tool-errors/bscmake-warning-bk4503.md index 8af2a1b3ac8..3baa637cf37 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4503.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4503.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Warning BK4503" title: "BSCMAKE Warning BK4503" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Warning BK4503" +ms.date: 11/04/2016 f1_keywords: ["BK4503"] helpviewer_keywords: ["BK4503"] -ms.assetid: 68abcf23-6987-4bc5-9745-8b65d2578bbc --- # BSCMAKE Warning BK4503 diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4504.md b/docs/error-messages/tool-errors/bscmake-warning-bk4504.md index edf755b5631..de69a7e2c05 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4504.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4504.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: BSCMAKE Warning BK4504" title: "BSCMAKE Warning BK4504" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Warning BK4504" +ms.date: 11/04/2016 f1_keywords: ["BK4504"] helpviewer_keywords: ["BK4504"] -ms.assetid: b56ee2d4-ad44-40f4-98c0-75934ea44a6c --- # BSCMAKE Warning BK4504 From e55daff3ffc578d225af3c793796cd90d12b054b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 16:33:27 +0800 Subject: [PATCH 1177/1799] Add blockquotes for error messages in range [PRJ0002, PRJ0050] --- docs/error-messages/tool-errors/project-build-error-prj0005.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0006.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0007.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0008.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0009.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0013.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0014.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0015.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0016.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0017.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0019.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0027.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0028.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0030.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0031.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0032.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0033.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0034.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0036.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0040.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0044.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0046.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0047.md | 2 +- docs/error-messages/tool-errors/project-build-error-prj0050.md | 2 +- 24 files changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/error-messages/tool-errors/project-build-error-prj0005.md b/docs/error-messages/tool-errors/project-build-error-prj0005.md index 8e2e34587c2..395c314ef98 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0005.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0005.md @@ -8,7 +8,7 @@ ms.assetid: 00c1821b-16aa-4bd9-9cf6-a778e5ed4ad9 --- # Project Build Error PRJ0005 -Unable to create a temporary file in directory 'directory'. +> Unable to create a temporary file in directory 'directory'. The call to create a temporary file failed. Reasons for failure include: diff --git a/docs/error-messages/tool-errors/project-build-error-prj0006.md b/docs/error-messages/tool-errors/project-build-error-prj0006.md index 9a98972aba4..1570fd3604f 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0006.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0006.md @@ -8,7 +8,7 @@ ms.assetid: ce092be4-1652-414f-8cb5-b97ef5841f89 --- # Project Build Error PRJ0006 -Could not open the temporary file 'file'. Make sure the file exists and that the directory is not write-protected. +> Could not open the temporary file 'file'. Make sure the file exists and that the directory is not write-protected. Visual C++ could not create a temporary file during the build process. Reasons for this include: diff --git a/docs/error-messages/tool-errors/project-build-error-prj0007.md b/docs/error-messages/tool-errors/project-build-error-prj0007.md index 5c661e392d1..1da3fba3bbc 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0007.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0007.md @@ -8,7 +8,7 @@ ms.assetid: d923948b-acc9-498f-bf3b-f14e41bed61a --- # Project Build Error PRJ0007 -Could not create output directory 'directory'. +> Could not create output directory 'directory'. Visual C++ failed to create an output directory. Possible reasons include: diff --git a/docs/error-messages/tool-errors/project-build-error-prj0008.md b/docs/error-messages/tool-errors/project-build-error-prj0008.md index 9371e7b0056..d08e664a1b6 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0008.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0008.md @@ -8,7 +8,7 @@ ms.assetid: 6bf7f17a-d2a8-4826-99c7-d600d846952f --- # Project Build Error PRJ0008 -Could not delete file 'file'. +> Could not delete file 'file'. **Make sure that the file is not open by another process and is not write-protected.** diff --git a/docs/error-messages/tool-errors/project-build-error-prj0009.md b/docs/error-messages/tool-errors/project-build-error-prj0009.md index e2ba86e6546..912ac4ecee3 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0009.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0009.md @@ -8,7 +8,7 @@ ms.assetid: 89291778-cda4-495d-983f-ddcc06dfc98b --- # Project Build Error PRJ0009 -Build log could not be opened for writing. +> Build log could not be opened for writing. **Make sure that the file is not open by another process and is not write-protected.** diff --git a/docs/error-messages/tool-errors/project-build-error-prj0013.md b/docs/error-messages/tool-errors/project-build-error-prj0013.md index 9c83ecf9f8b..e38672d39bc 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0013.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0013.md @@ -8,7 +8,7 @@ ms.assetid: 95e7bafd-63c8-4b2d-b778-f19cdf9ba36c --- # Project Build Error PRJ0013 -System resource could be critically low. Unable to create a pipe required to launch a build. +> System resource could be critically low. Unable to create a pipe required to launch a build. This error indicates that system resources are low. To resolve this error, decrease system resource usage by other processes/applications. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0014.md b/docs/error-messages/tool-errors/project-build-error-prj0014.md index c865d37ae13..81835d0933f 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0014.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0014.md @@ -8,7 +8,7 @@ ms.assetid: b08c6df1-1df1-4573-9fca-49de6c5a0c17 --- # Project Build Error PRJ0014 -The job object used to control the spawned processes has failed. The build cannot continue. +> The job object used to control the spawned processes has failed. The build cannot continue. An error occurred in the development environment. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0015.md b/docs/error-messages/tool-errors/project-build-error-prj0015.md index 06083644403..190df47757e 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0015.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0015.md @@ -8,7 +8,7 @@ ms.assetid: 2096c8f1-e96c-49a4-a690-1cb893a8bf6f --- # Project Build Error PRJ0015 -The NULL device is missing from your system. We are unable to launch a build. +> The NULL device is missing from your system. We are unable to launch a build. This error can be caused by low system resources. Close some applications or reboot. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0016.md b/docs/error-messages/tool-errors/project-build-error-prj0016.md index d187b7b7db7..40660b33fd7 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0016.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0016.md @@ -8,7 +8,7 @@ ms.assetid: e9745336-883a-4c70-9c40-7753e02f0325 --- # Project Build Error PRJ0016 -The user's security settings prevent the process from being created. These settings are required for building. +> The user's security settings prevent the process from being created. These settings are required for building. You are logged in as a user who does not have permissions to create processes using a process. You must change the permission levels for this user account, or contact your account administrator. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0017.md b/docs/error-messages/tool-errors/project-build-error-prj0017.md index 58cc800c983..6b4c22420dc 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0017.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0017.md @@ -8,6 +8,6 @@ ms.assetid: a192729f-bb10-486a-bfda-a7843fa259b2 --- # Project Build Error PRJ0017 -The current working directory is invalid. +> The current working directory is invalid. The path to the current working directory is longer than _MAXPATH. To resolve this error, do not create your project at such a deep level. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0019.md b/docs/error-messages/tool-errors/project-build-error-prj0019.md index 1945c29a55c..c10b46b2221 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0019.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0019.md @@ -8,7 +8,7 @@ ms.assetid: 5390a62b-aacf-4bc8-b9d7-08f1e0233423 --- # Project Build Error PRJ0019 -A tool returned an error code from +> A tool returned an error code from An error level was nonzero for a custom build step or build event. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0027.md b/docs/error-messages/tool-errors/project-build-error-prj0027.md index 36d7d27b448..9e3f140af84 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0027.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0027.md @@ -8,7 +8,7 @@ ms.assetid: 85d73a78-4b9e-4553-9f5d-2d76c48a790a --- # Project Build Error PRJ0027 -Unicode log message 'contents' contains content that could not be translated to the user's ANSI code page. +> Unicode log message 'contents' contains content that could not be translated to the user's ANSI code page. You will typically only see this warning in conjunction with errors in creating batch and/or response files. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0028.md b/docs/error-messages/tool-errors/project-build-error-prj0028.md index f6beac1e882..f9e6775ce12 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0028.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0028.md @@ -8,7 +8,7 @@ ms.assetid: 0a6e0da7-cb3d-40b6-81a6-6196a9c2526b --- # Project Build Error PRJ0028 -Temporary file 'file' contains Unicode contents that could not be translated to user's ANSI code page. +> Temporary file 'file' contains Unicode contents that could not be translated to user's ANSI code page. A value was specified with the [/MIDL (Specify MIDL Command Line Options)](../../build/reference/midl-specify-midl-command-line-options.md) linker option that could not be resolved by the system code page. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0030.md b/docs/error-messages/tool-errors/project-build-error-prj0030.md index 74d695229ae..fbb4b869c60 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0030.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0030.md @@ -8,7 +8,7 @@ ms.assetid: c48b3727-e166-46e7-bcd7-3e5b2ac5c1d4 --- # Project Build Error PRJ0030 -Macro expansion error. Evaluate recursion exceeded 32 levels for $(macro). +> Macro expansion error. Evaluate recursion exceeded 32 levels for $(macro). This error is caused by recursion in your macros. For example, if you set the **Intermediate Directory** property (see [General Property Page (Project)](../../build/reference/general-property-page-project.md)) to $(IntDir), you will have recursion. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0031.md b/docs/error-messages/tool-errors/project-build-error-prj0031.md index 5b40281db8b..b7c058732d4 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0031.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0031.md @@ -8,7 +8,7 @@ ms.assetid: b42435c6-e570-4f8e-9ad5-12a7ea69ccb2 --- # Project Build Error PRJ0031 -The 'Outputs' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. +> The 'Outputs' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. A custom build step on a file had bad output probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0032.md b/docs/error-messages/tool-errors/project-build-error-prj0032.md index 2659dca6ce3..d7943c348f2 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0032.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0032.md @@ -8,7 +8,7 @@ ms.assetid: bc6acbea-4041-4237-8b5a-f0434705d89f --- # Project Build Error PRJ0032 -The 'Outputs' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. +> The 'Outputs' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. A custom build step on a project had bad output probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0033.md b/docs/error-messages/tool-errors/project-build-error-prj0033.md index 445a667d8d8..1605749acee 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0033.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0033.md @@ -8,7 +8,7 @@ ms.assetid: 84d4a052-0586-4b78-9315-81c1e8386c1e --- # Project Build Error PRJ0033 -The 'Additional Dependencies' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. +> The 'Additional Dependencies' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. A custom build step on a file contained an error in its additional dependency probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0034.md b/docs/error-messages/tool-errors/project-build-error-prj0034.md index dcfc2b8fb53..3894bcb87d1 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0034.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0034.md @@ -8,7 +8,7 @@ ms.assetid: 1da4a55b-231b-4476-8545-6997628fbc00 --- # Project Build Error PRJ0034 -The 'Additional Dependencies' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. +> The 'Additional Dependencies' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. A custom build step on a project contained an error in its additional dependency probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0036.md b/docs/error-messages/tool-errors/project-build-error-prj0036.md index 078ae4b5220..3af0e4b078d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0036.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0036.md @@ -8,7 +8,7 @@ ms.assetid: ee215cd1-2d66-474d-9a63-b9096f1c4923 --- # Project Build Error PRJ0036 -The 'Additional Files' property for the Web Deployment Tool contained an invalid entry. +> The 'Additional Files' property for the Web Deployment Tool contained an invalid entry. The Additional Files property on the Web Deployment property page contained an error, possibly due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0040.md b/docs/error-messages/tool-errors/project-build-error-prj0040.md index c9d2860e395..ebfcb509da2 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0040.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0040.md @@ -8,7 +8,7 @@ ms.assetid: 6549ac62-c87b-4edf-b541-32221abe97ec --- # Project Build Error PRJ0040 -Internal error on build. Cannot continue. Please reload project and try again. +> Internal error on build. Cannot continue. Please reload project and try again. The project system was unable to process your project. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0044.md b/docs/error-messages/tool-errors/project-build-error-prj0044.md index 0168bd57f8d..faf3d219b20 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0044.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0044.md @@ -8,7 +8,7 @@ ms.assetid: 5d78c45a-f9e9-4d2b-a3b6-5a5d1421ab84 --- # Project Build Error PRJ0044 -The 'Additional Dependencies' property for custom build rule 'rule' assigned to file 'file' is invalid. The property contained 'string' which evaluates to 'value'. +> The 'Additional Dependencies' property for custom build rule 'rule' assigned to file 'file' is invalid. The property contained 'string' which evaluates to 'value'. The **Additional Dependencies** property evaluated to an empty string, or to a string that contained invalid characters (any character that could not be in a file or directory name). Custom build rules need the output of the build action. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0046.md b/docs/error-messages/tool-errors/project-build-error-prj0046.md index 4c773d14331..c9e9e87831d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0046.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0046.md @@ -8,6 +8,6 @@ ms.assetid: 59442319-4481-4b97-a4a5-16f52fc718e7 --- # Project Build Error PRJ0046 -Could not spawn command line because the one specified was empty. +> Could not spawn command line because the one specified was empty. An empty command line was specified for a makefile configuration; the command line is required. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0047.md b/docs/error-messages/tool-errors/project-build-error-prj0047.md index 77037f5823a..48281839c8a 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0047.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0047.md @@ -8,7 +8,7 @@ ms.assetid: 7c79149d-4b7c-4a24-830e-904d92c1f0b4 --- # Project Build Error PRJ0047 -Could not resume the suspended process. The build has failed. +> Could not resume the suspended process. The build has failed. An error occurred in the development environment. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0050.md b/docs/error-messages/tool-errors/project-build-error-prj0050.md index 1d7c06e4027..5ac4ac7572b 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0050.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0050.md @@ -8,7 +8,7 @@ ms.assetid: ceef3b37-0acf-4abd-ac62-aa830b4fa145 --- # Project Build Error PRJ0050 -Failed to register output. Please ensure you have the appropriate permissions to modify the registry. +> Failed to register output. Please ensure you have the appropriate permissions to modify the registry. The Visual C++ build system was not able to register the output of the build (dll or .exe). You need to be logged on as an administrator to modify the registry. From d621c69576fc7b351d721eda066fbc5d9f54774f Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 16:38:04 +0800 Subject: [PATCH 1178/1799] Add "Remarks" headings for error references in range [PRJ0002, PRJ0050] --- docs/error-messages/tool-errors/project-build-error-prj0002.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0003.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0004.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0005.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0006.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0007.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0008.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0009.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0013.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0014.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0015.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0016.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0017.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0019.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0020.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0021.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0022.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0023.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0024.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0025.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0026.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0027.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0028.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0030.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0031.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0032.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0033.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0034.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0035.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0036.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0040.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0044.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0046.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0047.md | 2 ++ docs/error-messages/tool-errors/project-build-error-prj0050.md | 2 ++ 35 files changed, 70 insertions(+) diff --git a/docs/error-messages/tool-errors/project-build-error-prj0002.md b/docs/error-messages/tool-errors/project-build-error-prj0002.md index b61c38b32bb..ad2545f54a0 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0002.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0002.md @@ -10,6 +10,8 @@ ms.assetid: 1c820b1f-9a24-4681-80ed-4fcbfd7caa00 > error result returned from '*command line*'. +## Remarks + A command, *command line*, which was formed from user input in the **Property Pages** dialog box, returned an error code but no information will appear in the **Output** window. The resolution to this error depends on which tool generated the error. For MIDL, you will get an idea of what went wrong if /o (Redirect Output) is defined. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0003.md b/docs/error-messages/tool-errors/project-build-error-prj0003.md index 0ae0473610d..5c6b667ba41 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0003.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0003.md @@ -10,6 +10,8 @@ ms.assetid: fc5a84bb-c6d3-41d6-8dd6-475455820778 > Error spawning '*command line*'. +## Remarks + The *command line* command formed from input in the **Property Pages** dialog box returned an error code, but no information appears in the **Output** window. Possible reasons for this error include: diff --git a/docs/error-messages/tool-errors/project-build-error-prj0004.md b/docs/error-messages/tool-errors/project-build-error-prj0004.md index 387c00e6be2..6756e9fb299 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0004.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0004.md @@ -10,6 +10,8 @@ ms.assetid: 1858769f-0be4-40ed-ab70-2cee550488c7 > Could not generate command line for the '*tool*' tool. +## Remarks + One or more properties were specified in such a way as to make the syntax of the call to *tool* illegal: - You may have specified badly formed or unknown macros. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0005.md b/docs/error-messages/tool-errors/project-build-error-prj0005.md index 395c314ef98..9ca2cc8f1b8 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0005.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0005.md @@ -10,6 +10,8 @@ ms.assetid: 00c1821b-16aa-4bd9-9cf6-a778e5ed4ad9 > Unable to create a temporary file in directory 'directory'. +## Remarks + The call to create a temporary file failed. Reasons for failure include: - Ran out of temporary file names. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0006.md b/docs/error-messages/tool-errors/project-build-error-prj0006.md index 1570fd3604f..1154ec5dff9 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0006.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0006.md @@ -10,6 +10,8 @@ ms.assetid: ce092be4-1652-414f-8cb5-b97ef5841f89 > Could not open the temporary file 'file'. Make sure the file exists and that the directory is not write-protected. +## Remarks + Visual C++ could not create a temporary file during the build process. Reasons for this include: - No temp directory. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0007.md b/docs/error-messages/tool-errors/project-build-error-prj0007.md index 1da3fba3bbc..75062a8faa2 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0007.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0007.md @@ -10,6 +10,8 @@ ms.assetid: d923948b-acc9-498f-bf3b-f14e41bed61a > Could not create output directory 'directory'. +## Remarks + Visual C++ failed to create an output directory. Possible reasons include: - The directory in which the output directory was to be created is read-only. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0008.md b/docs/error-messages/tool-errors/project-build-error-prj0008.md index d08e664a1b6..4d45d277b25 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0008.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0008.md @@ -10,6 +10,8 @@ ms.assetid: 6bf7f17a-d2a8-4826-99c7-d600d846952f > Could not delete file 'file'. +## Remarks + **Make sure that the file is not open by another process and is not write-protected.** During a rebuild or clean, Visual C++ deletes all known intermediate and output files for the build, as well as any files that meet the wildcard specifications in the **Extensions to Delete on Clean** property in the [General Configuration Settings Property Page](../../build/reference/general-property-page-project.md). diff --git a/docs/error-messages/tool-errors/project-build-error-prj0009.md b/docs/error-messages/tool-errors/project-build-error-prj0009.md index 912ac4ecee3..5d8b5b4bdcf 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0009.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0009.md @@ -10,6 +10,8 @@ ms.assetid: 89291778-cda4-495d-983f-ddcc06dfc98b > Build log could not be opened for writing. +## Remarks + **Make sure that the file is not open by another process and is not write-protected.** After setting the **Build Logging** property to **Yes** and performing a build or rebuild, Visual C++ was unable to open the build log in exclusive mode. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0013.md b/docs/error-messages/tool-errors/project-build-error-prj0013.md index e38672d39bc..977365694ae 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0013.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0013.md @@ -10,6 +10,8 @@ ms.assetid: 95e7bafd-63c8-4b2d-b778-f19cdf9ba36c > System resource could be critically low. Unable to create a pipe required to launch a build. +## Remarks + This error indicates that system resources are low. To resolve this error, decrease system resource usage by other processes/applications. This error can also occur if your security level is insufficient to create pipes (see [CreatePipe](/windows/win32/api/namedpipeapi/nf-namedpipeapi-createpipe)). diff --git a/docs/error-messages/tool-errors/project-build-error-prj0014.md b/docs/error-messages/tool-errors/project-build-error-prj0014.md index 81835d0933f..fd220d03603 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0014.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0014.md @@ -10,6 +10,8 @@ ms.assetid: b08c6df1-1df1-4573-9fca-49de6c5a0c17 > The job object used to control the spawned processes has failed. The build cannot continue. +## Remarks + An error occurred in the development environment. To resolve this error, close and reload the project. If necessary, exit and restart Visual Studio. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0015.md b/docs/error-messages/tool-errors/project-build-error-prj0015.md index 190df47757e..096f0c87df0 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0015.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0015.md @@ -10,6 +10,8 @@ ms.assetid: 2096c8f1-e96c-49a4-a690-1cb893a8bf6f > The NULL device is missing from your system. We are unable to launch a build. +## Remarks + This error can be caused by low system resources. Close some applications or reboot. It can also be caused if you do not have sufficient privileges to the NULL device on the computer. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0016.md b/docs/error-messages/tool-errors/project-build-error-prj0016.md index 40660b33fd7..f92fcc13dcf 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0016.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0016.md @@ -10,6 +10,8 @@ ms.assetid: e9745336-883a-4c70-9c40-7753e02f0325 > The user's security settings prevent the process from being created. These settings are required for building. +## Remarks + You are logged in as a user who does not have permissions to create processes using a process. You must change the permission levels for this user account, or contact your account administrator. This error can also occur if the following registry key is set: diff --git a/docs/error-messages/tool-errors/project-build-error-prj0017.md b/docs/error-messages/tool-errors/project-build-error-prj0017.md index 6b4c22420dc..d00ba56d612 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0017.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0017.md @@ -10,4 +10,6 @@ ms.assetid: a192729f-bb10-486a-bfda-a7843fa259b2 > The current working directory is invalid. +## Remarks + The path to the current working directory is longer than _MAXPATH. To resolve this error, do not create your project at such a deep level. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0019.md b/docs/error-messages/tool-errors/project-build-error-prj0019.md index c10b46b2221..d0fb68f6092 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0019.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0019.md @@ -10,6 +10,8 @@ ms.assetid: 5390a62b-aacf-4bc8-b9d7-08f1e0233423 > A tool returned an error code from +## Remarks + An error level was nonzero for a custom build step or build event. You will also see PRJ0019 when a tool returned an error code but no error message. This can happen, for example, if you redirect the output of MIDL to NUL. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0020.md b/docs/error-messages/tool-errors/project-build-error-prj0020.md index f853411257b..30feb757ebd 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0020.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0020.md @@ -10,6 +10,8 @@ ms.assetid: 54bb8cd4-af7c-4d62-8125-3ab5ff5f2cc4 > Tool '*tool*', Property '*property*' contains invalid file name '*file*'. +## Remarks + The file name *file*, specified in the property *property* for the tool *tool*, was invalid. You may have used an unknown or invalid macro. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0021.md b/docs/error-messages/tool-errors/project-build-error-prj0021.md index 335cba2b63a..14b45137f7f 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0021.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0021.md @@ -10,6 +10,8 @@ ms.assetid: bcab794d-4a6d-4b4d-aaca-73676c0cec75 > Tool '*tool*', Property '*property*' contains invalid file name. +## Remarks + The file name specified in the property *property* for the tool *tool* was invalid. You may have used an unknown or invalid macro. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0022.md b/docs/error-messages/tool-errors/project-build-error-prj0022.md index 7d1cf48c185..a72042988ea 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0022.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0022.md @@ -10,6 +10,8 @@ ms.assetid: 691344a8-fc70-4aeb-9372-dde72f4588a4 > Unknown Tool, Property '*property*' contains invalid file name '*file*'. +## Remarks + The file name *file* specified in the property *property* was invalid. You may have used an unknown or invalid macro. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0023.md b/docs/error-messages/tool-errors/project-build-error-prj0023.md index 377423e3135..76f31dd63de 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0023.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0023.md @@ -10,6 +10,8 @@ ms.assetid: ed55a320-e7c8-489f-886e-825feee0d576 > Tool '*tool*', Unknown Property contains invalid file name '*file*'. +## Remarks + The file name *file* specified for the tool *tool* was invalid. You may have used an unknown or invalid macro. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0024.md b/docs/error-messages/tool-errors/project-build-error-prj0024.md index 600cb4212a7..6673bd9968d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0024.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0024.md @@ -10,6 +10,8 @@ ms.assetid: 8bde6368-6c1b-4e04-bc5e-3c6d0b8fa1d7 > Unicode path '*path*' could not be translated to user's ANSI code page. +## Remarks + *path* is the original Unicode version of the path string. This error can occur in cases where there is a Unicode path that cannot be directly translated to ANSI for the current system code page. This error may occur if you are working with a project that was developed on a system using a code page that is not on your computer. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0025.md b/docs/error-messages/tool-errors/project-build-error-prj0025.md index 835df947fff..9da11d804ee 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0025.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0025.md @@ -12,6 +12,8 @@ ms.assetid: 57725c78-bc63-44f3-9667-2969b2d7c41d > > *UNICODE contents of file* +## Remarks + The project system found Unicode contents in a custom build rule or build event that cannot be translated properly to the user's current ANSI code page. The resolution for this error is to update the contents of the build rule or build event to use ANSI or to install the code page on your computer and set it as the system default. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0026.md b/docs/error-messages/tool-errors/project-build-error-prj0026.md index b839afbf8bf..01f60793977 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0026.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0026.md @@ -12,6 +12,8 @@ ms.assetid: c52bc9b5-8b22-4015-b477-8645ae56c489 > > *UNICODE contents of file* +## Remarks + The project system found Unicode contents in a response file that cannot be translated properly to the user's current ANSI code page. The resolution for this error is to update the contents of the response file to use ANSI or to install the code page on your computer and set it as the system default. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0027.md b/docs/error-messages/tool-errors/project-build-error-prj0027.md index 9e3f140af84..ba78685c8a1 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0027.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0027.md @@ -10,6 +10,8 @@ ms.assetid: 85d73a78-4b9e-4553-9f5d-2d76c48a790a > Unicode log message 'contents' contains content that could not be translated to the user's ANSI code page. +## Remarks + You will typically only see this warning in conjunction with errors in creating batch and/or response files. The resolution for this error is to update the contents of the build log to use ANSI or to install the code page on your computer and set it as the system default. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0028.md b/docs/error-messages/tool-errors/project-build-error-prj0028.md index f9e6775ce12..aca6ed3549b 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0028.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0028.md @@ -10,6 +10,8 @@ ms.assetid: 0a6e0da7-cb3d-40b6-81a6-6196a9c2526b > Temporary file 'file' contains Unicode contents that could not be translated to user's ANSI code page. +## Remarks + A value was specified with the [/MIDL (Specify MIDL Command Line Options)](../../build/reference/midl-specify-midl-command-line-options.md) linker option that could not be resolved by the system code page. The code page used when you specify the MIDL command (the input code page) must be the same as the system code page. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0030.md b/docs/error-messages/tool-errors/project-build-error-prj0030.md index fbb4b869c60..56d9e5340ee 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0030.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0030.md @@ -10,6 +10,8 @@ ms.assetid: c48b3727-e166-46e7-bcd7-3e5b2ac5c1d4 > Macro expansion error. Evaluate recursion exceeded 32 levels for $(macro). +## Remarks + This error is caused by recursion in your macros. For example, if you set the **Intermediate Directory** property (see [General Property Page (Project)](../../build/reference/general-property-page-project.md)) to $(IntDir), you will have recursion. To resolve this error, do not define macros or properties in terms of macros they are used to define. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0031.md b/docs/error-messages/tool-errors/project-build-error-prj0031.md index b7c058732d4..27599412ef8 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0031.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0031.md @@ -10,6 +10,8 @@ ms.assetid: b42435c6-e570-4f8e-9ad5-12a7ea69ccb2 > The 'Outputs' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. +## Remarks + A custom build step on a file had bad output probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. To resolve this error, fix the macro or fix the path specification. The evaluated path is an absolute path from the project directory. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0032.md b/docs/error-messages/tool-errors/project-build-error-prj0032.md index d7943c348f2..5ec07057e40 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0032.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0032.md @@ -10,6 +10,8 @@ ms.assetid: bc6acbea-4041-4237-8b5a-f0434705d89f > The 'Outputs' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. +## Remarks + A custom build step on a project had bad output probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. To resolve this error, fix the macro or fix the path specification. The evaluated path is an absolute path from the project directory. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0033.md b/docs/error-messages/tool-errors/project-build-error-prj0033.md index 1605749acee..1704e69a604 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0033.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0033.md @@ -10,6 +10,8 @@ ms.assetid: 84d4a052-0586-4b78-9315-81c1e8386c1e > The 'Additional Dependencies' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. +## Remarks + A custom build step on a file contained an error in its additional dependency probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. To resolve this error, fix the macro or fix the path specification. The evaluated path is an absolute path from the project directory. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0034.md b/docs/error-messages/tool-errors/project-build-error-prj0034.md index 3894bcb87d1..1551c6a5197 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0034.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0034.md @@ -10,6 +10,8 @@ ms.assetid: 1da4a55b-231b-4476-8545-6997628fbc00 > The 'Additional Dependencies' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. +## Remarks + A custom build step on a project contained an error in its additional dependency probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. To resolve this error, fix the macro or fix the path specification. The evaluated path is an absolute path from the project directory. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0035.md b/docs/error-messages/tool-errors/project-build-error-prj0035.md index ecfd160c80a..3c2e46ab62d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0035.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0035.md @@ -12,6 +12,8 @@ ms.assetid: 0667116d-338c-40a4-972c-da875f778cb5 > > *UNICODE contents of file* +## Remarks + *file* is the XML file created as the command line to the Web Deployment tool. The project system found Unicode characters in some property on the Web Deployment property page that can't properly be translated to ANSI. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0036.md b/docs/error-messages/tool-errors/project-build-error-prj0036.md index 3af0e4b078d..1da78f0d908 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0036.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0036.md @@ -10,6 +10,8 @@ ms.assetid: ee215cd1-2d66-474d-9a63-b9096f1c4923 > The 'Additional Files' property for the Web Deployment Tool contained an invalid entry. +## Remarks + The Additional Files property on the Web Deployment property page contained an error, possibly due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. To resolve this error, fix the macro or fix the path specification. The evaluated path is an absolute path from the project directory. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0040.md b/docs/error-messages/tool-errors/project-build-error-prj0040.md index ebfcb509da2..c3b1bc277bb 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0040.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0040.md @@ -10,6 +10,8 @@ ms.assetid: 6549ac62-c87b-4edf-b541-32221abe97ec > Internal error on build. Cannot continue. Please reload project and try again. +## Remarks + The project system was unable to process your project. Try reloading the project. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0044.md b/docs/error-messages/tool-errors/project-build-error-prj0044.md index faf3d219b20..da32f43c1f1 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0044.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0044.md @@ -10,6 +10,8 @@ ms.assetid: 5d78c45a-f9e9-4d2b-a3b6-5a5d1421ab84 > The 'Additional Dependencies' property for custom build rule 'rule' assigned to file 'file' is invalid. The property contained 'string' which evaluates to 'value'. +## Remarks + The **Additional Dependencies** property evaluated to an empty string, or to a string that contained invalid characters (any character that could not be in a file or directory name). Custom build rules need the output of the build action. For more information, see [Specifying Custom Build Tools](../../build/specifying-custom-build-tools.md). diff --git a/docs/error-messages/tool-errors/project-build-error-prj0046.md b/docs/error-messages/tool-errors/project-build-error-prj0046.md index c9e9e87831d..01281149b3a 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0046.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0046.md @@ -10,4 +10,6 @@ ms.assetid: 59442319-4481-4b97-a4a5-16f52fc718e7 > Could not spawn command line because the one specified was empty. +## Remarks + An empty command line was specified for a makefile configuration; the command line is required. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0047.md b/docs/error-messages/tool-errors/project-build-error-prj0047.md index 48281839c8a..ef71f29d1a8 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0047.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0047.md @@ -10,6 +10,8 @@ ms.assetid: 7c79149d-4b7c-4a24-830e-904d92c1f0b4 > Could not resume the suspended process. The build has failed. +## Remarks + An error occurred in the development environment. To resolve this error, close and reload the project. If necessary, exit and restart Visual Studio. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0050.md b/docs/error-messages/tool-errors/project-build-error-prj0050.md index 5ac4ac7572b..e7de4e0423d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0050.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0050.md @@ -10,6 +10,8 @@ ms.assetid: ceef3b37-0acf-4abd-ac62-aa830b4fa145 > Failed to register output. Please ensure you have the appropriate permissions to modify the registry. +## Remarks + The Visual C++ build system was not able to register the output of the build (dll or .exe). You need to be logged on as an administrator to modify the registry. If you are building a .dll, you can try to register the .dll manually using regsvr32.exe, this should display information about why the build failed. From 030288ea71458367582f944bb9ce779a2934cc39 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 16:45:14 +0800 Subject: [PATCH 1179/1799] Update metadata for error references in range [PRJ0002, PRJ0050] --- .../tool-errors/project-build-error-prj0002.md | 5 ++--- .../tool-errors/project-build-error-prj0003.md | 5 ++--- .../tool-errors/project-build-error-prj0004.md | 5 ++--- .../tool-errors/project-build-error-prj0005.md | 5 ++--- .../tool-errors/project-build-error-prj0006.md | 5 ++--- .../tool-errors/project-build-error-prj0007.md | 5 ++--- .../tool-errors/project-build-error-prj0008.md | 5 ++--- .../tool-errors/project-build-error-prj0009.md | 5 ++--- .../tool-errors/project-build-error-prj0013.md | 5 ++--- .../tool-errors/project-build-error-prj0014.md | 5 ++--- .../tool-errors/project-build-error-prj0015.md | 5 ++--- .../tool-errors/project-build-error-prj0016.md | 5 ++--- .../tool-errors/project-build-error-prj0017.md | 5 ++--- .../tool-errors/project-build-error-prj0019.md | 5 ++--- .../tool-errors/project-build-error-prj0020.md | 5 ++--- .../tool-errors/project-build-error-prj0021.md | 5 ++--- .../tool-errors/project-build-error-prj0022.md | 5 ++--- .../tool-errors/project-build-error-prj0023.md | 5 ++--- .../tool-errors/project-build-error-prj0024.md | 5 ++--- .../tool-errors/project-build-error-prj0025.md | 5 ++--- .../tool-errors/project-build-error-prj0026.md | 5 ++--- .../tool-errors/project-build-error-prj0027.md | 5 ++--- .../tool-errors/project-build-error-prj0028.md | 5 ++--- .../tool-errors/project-build-error-prj0030.md | 5 ++--- .../tool-errors/project-build-error-prj0031.md | 5 ++--- .../tool-errors/project-build-error-prj0032.md | 5 ++--- .../tool-errors/project-build-error-prj0033.md | 5 ++--- .../tool-errors/project-build-error-prj0034.md | 5 ++--- .../tool-errors/project-build-error-prj0035.md | 5 ++--- .../tool-errors/project-build-error-prj0036.md | 5 ++--- .../tool-errors/project-build-error-prj0040.md | 5 ++--- .../tool-errors/project-build-error-prj0044.md | 5 ++--- .../tool-errors/project-build-error-prj0046.md | 5 ++--- .../tool-errors/project-build-error-prj0047.md | 5 ++--- .../tool-errors/project-build-error-prj0050.md | 5 ++--- 35 files changed, 70 insertions(+), 105 deletions(-) diff --git a/docs/error-messages/tool-errors/project-build-error-prj0002.md b/docs/error-messages/tool-errors/project-build-error-prj0002.md index ad2545f54a0..25cdd328c58 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0002.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0002" title: "Project Build Error PRJ0002" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0002" +ms.date: 08/27/2018 f1_keywords: ["PRJ0002"] helpviewer_keywords: ["PRJ0002"] -ms.assetid: 1c820b1f-9a24-4681-80ed-4fcbfd7caa00 --- # Project Build Error PRJ0002 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0003.md b/docs/error-messages/tool-errors/project-build-error-prj0003.md index 5c6b667ba41..3a8e09419da 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0003.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0003.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0003" title: "Project Build Error PRJ0003" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0003" +ms.date: 11/04/2016 f1_keywords: ["PRJ0003"] helpviewer_keywords: ["PRJ0003"] -ms.assetid: fc5a84bb-c6d3-41d6-8dd6-475455820778 --- # Project Build Error PRJ0003 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0004.md b/docs/error-messages/tool-errors/project-build-error-prj0004.md index 6756e9fb299..07cfd3b1d1c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0004.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0004" title: "Project Build Error PRJ0004" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0004" +ms.date: 08/27/2018 f1_keywords: ["PRJ0004"] helpviewer_keywords: ["PRJ0004"] -ms.assetid: 1858769f-0be4-40ed-ab70-2cee550488c7 --- # Project Build Error PRJ0004 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0005.md b/docs/error-messages/tool-errors/project-build-error-prj0005.md index 9ca2cc8f1b8..1daca41960c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0005.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0005.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0005" title: "Project Build Error PRJ0005" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0005" +ms.date: 11/04/2016 f1_keywords: ["PRJ0005"] helpviewer_keywords: ["PRJ0005"] -ms.assetid: 00c1821b-16aa-4bd9-9cf6-a778e5ed4ad9 --- # Project Build Error PRJ0005 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0006.md b/docs/error-messages/tool-errors/project-build-error-prj0006.md index 1154ec5dff9..c5ddbebb489 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0006.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0006.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0006" title: "Project Build Error PRJ0006" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0006" +ms.date: 11/04/2016 f1_keywords: ["PRJ0006"] helpviewer_keywords: ["PRJ0006"] -ms.assetid: ce092be4-1652-414f-8cb5-b97ef5841f89 --- # Project Build Error PRJ0006 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0007.md b/docs/error-messages/tool-errors/project-build-error-prj0007.md index 75062a8faa2..315b84e1a2e 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0007.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0007.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0007" title: "Project Build Error PRJ0007" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0007" +ms.date: 11/04/2016 f1_keywords: ["PRJ0007"] helpviewer_keywords: ["PRJ0007"] -ms.assetid: d923948b-acc9-498f-bf3b-f14e41bed61a --- # Project Build Error PRJ0007 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0008.md b/docs/error-messages/tool-errors/project-build-error-prj0008.md index 4d45d277b25..ab916e188be 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0008.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0008.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0008" title: "Project Build Error PRJ0008" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0008" +ms.date: 11/04/2016 f1_keywords: ["PRJ0008"] helpviewer_keywords: ["PRJ0008"] -ms.assetid: 6bf7f17a-d2a8-4826-99c7-d600d846952f --- # Project Build Error PRJ0008 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0009.md b/docs/error-messages/tool-errors/project-build-error-prj0009.md index 5d8b5b4bdcf..cb3d58ba79c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0009.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0009.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0009" title: "Project Build Error PRJ0009" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0009" +ms.date: 11/04/2016 f1_keywords: ["PRJ0009"] helpviewer_keywords: ["PRJ0009"] -ms.assetid: 89291778-cda4-495d-983f-ddcc06dfc98b --- # Project Build Error PRJ0009 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0013.md b/docs/error-messages/tool-errors/project-build-error-prj0013.md index 977365694ae..004cd1fa41c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0013.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0013.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0013" title: "Project Build Error PRJ0013" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0013" +ms.date: 11/04/2016 f1_keywords: ["PRJ0013"] helpviewer_keywords: ["PRJ0013"] -ms.assetid: 95e7bafd-63c8-4b2d-b778-f19cdf9ba36c --- # Project Build Error PRJ0013 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0014.md b/docs/error-messages/tool-errors/project-build-error-prj0014.md index fd220d03603..e2a69bf636d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0014.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0014.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0014" title: "Project Build Error PRJ0014" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0014" +ms.date: 11/04/2016 f1_keywords: ["PRJ0014"] helpviewer_keywords: ["PRJ0014"] -ms.assetid: b08c6df1-1df1-4573-9fca-49de6c5a0c17 --- # Project Build Error PRJ0014 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0015.md b/docs/error-messages/tool-errors/project-build-error-prj0015.md index 096f0c87df0..7cf85655166 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0015.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0015.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0015" title: "Project Build Error PRJ0015" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0015" +ms.date: 11/04/2016 f1_keywords: ["PRJ0015"] helpviewer_keywords: ["PRJ0015"] -ms.assetid: 2096c8f1-e96c-49a4-a690-1cb893a8bf6f --- # Project Build Error PRJ0015 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0016.md b/docs/error-messages/tool-errors/project-build-error-prj0016.md index f92fcc13dcf..a4432287490 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0016.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0016.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0016" title: "Project Build Error PRJ0016" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0016" +ms.date: 11/04/2016 f1_keywords: ["PRJ0016"] helpviewer_keywords: ["PRJ0016"] -ms.assetid: e9745336-883a-4c70-9c40-7753e02f0325 --- # Project Build Error PRJ0016 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0017.md b/docs/error-messages/tool-errors/project-build-error-prj0017.md index d00ba56d612..4f5d3e8d954 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0017.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0017" title: "Project Build Error PRJ0017" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0017" +ms.date: 11/04/2016 f1_keywords: ["PRJ0017"] helpviewer_keywords: ["PRJ0017"] -ms.assetid: a192729f-bb10-486a-bfda-a7843fa259b2 --- # Project Build Error PRJ0017 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0019.md b/docs/error-messages/tool-errors/project-build-error-prj0019.md index d0fb68f6092..5780072ddec 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0019.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0019.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0019" title: "Project Build Error PRJ0019" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0019" +ms.date: 11/04/2016 f1_keywords: ["PRJ0019"] helpviewer_keywords: ["PRJ0019"] -ms.assetid: 5390a62b-aacf-4bc8-b9d7-08f1e0233423 --- # Project Build Error PRJ0019 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0020.md b/docs/error-messages/tool-errors/project-build-error-prj0020.md index 30feb757ebd..2dbf934ea7d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0020.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0020.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0020" title: "Project Build Error PRJ0020" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0020" +ms.date: 08/27/2018 f1_keywords: ["PRJ0020"] helpviewer_keywords: ["PRJ0020"] -ms.assetid: 54bb8cd4-af7c-4d62-8125-3ab5ff5f2cc4 --- # Project Build Error PRJ0020 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0021.md b/docs/error-messages/tool-errors/project-build-error-prj0021.md index 14b45137f7f..ca4900c35c4 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0021.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0021.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0021" title: "Project Build Error PRJ0021" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0021" +ms.date: 08/27/2018 f1_keywords: ["PRJ0021"] helpviewer_keywords: ["PRJ0021"] -ms.assetid: bcab794d-4a6d-4b4d-aaca-73676c0cec75 --- # Project Build Error PRJ0021 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0022.md b/docs/error-messages/tool-errors/project-build-error-prj0022.md index a72042988ea..2dd36de88b6 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0022.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0022" title: "Project Build Error PRJ0022" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0022" +ms.date: 08/27/2018 f1_keywords: ["PRJ0022"] helpviewer_keywords: ["PRJ0022"] -ms.assetid: 691344a8-fc70-4aeb-9372-dde72f4588a4 --- # Project Build Error PRJ0022 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0023.md b/docs/error-messages/tool-errors/project-build-error-prj0023.md index 76f31dd63de..a0604f9e768 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0023.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0023.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0023" title: "Project Build Error PRJ0023" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0023" +ms.date: 08/27/2018 f1_keywords: ["PRJ0023"] helpviewer_keywords: ["PRJ0023"] -ms.assetid: ed55a320-e7c8-489f-886e-825feee0d576 --- # Project Build Error PRJ0023 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0024.md b/docs/error-messages/tool-errors/project-build-error-prj0024.md index 6673bd9968d..0511d1e1f07 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0024.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0024.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0024" title: "Project Build Error PRJ0024" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0024" +ms.date: 08/27/2018 f1_keywords: ["PRJ0024"] helpviewer_keywords: ["PRJ0024"] -ms.assetid: 8bde6368-6c1b-4e04-bc5e-3c6d0b8fa1d7 --- # Project Build Error PRJ0024 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0025.md b/docs/error-messages/tool-errors/project-build-error-prj0025.md index 9da11d804ee..44c275ba9e7 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0025.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0025.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0025" title: "Project Build Error PRJ0025" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0025" +ms.date: 08/27/2018 f1_keywords: ["PRJ0025"] helpviewer_keywords: ["PRJ0025"] -ms.assetid: 57725c78-bc63-44f3-9667-2969b2d7c41d --- # Project Build Error PRJ0025 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0026.md b/docs/error-messages/tool-errors/project-build-error-prj0026.md index 01f60793977..3e31ffebaf3 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0026.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0026.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0026" title: "Project Build Error PRJ0026" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0026" +ms.date: 08/27/2018 f1_keywords: ["PRJ0026"] helpviewer_keywords: ["PRJ0026"] -ms.assetid: c52bc9b5-8b22-4015-b477-8645ae56c489 --- # Project Build Error PRJ0026 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0027.md b/docs/error-messages/tool-errors/project-build-error-prj0027.md index ba78685c8a1..d6a3617908f 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0027.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0027.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0027" title: "Project Build Error PRJ0027" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0027" +ms.date: 11/04/2016 f1_keywords: ["PRJ0027"] helpviewer_keywords: ["PRJ0027"] -ms.assetid: 85d73a78-4b9e-4553-9f5d-2d76c48a790a --- # Project Build Error PRJ0027 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0028.md b/docs/error-messages/tool-errors/project-build-error-prj0028.md index aca6ed3549b..a161469f323 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0028.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0028.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0028" title: "Project Build Error PRJ0028" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0028" +ms.date: 11/04/2016 f1_keywords: ["PRJ0028"] helpviewer_keywords: ["PRJ0028"] -ms.assetid: 0a6e0da7-cb3d-40b6-81a6-6196a9c2526b --- # Project Build Error PRJ0028 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0030.md b/docs/error-messages/tool-errors/project-build-error-prj0030.md index 56d9e5340ee..0484a509b7f 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0030.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0030.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0030" title: "Project Build Error PRJ0030" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0030" +ms.date: 11/04/2016 f1_keywords: ["PRJ0030"] helpviewer_keywords: ["PRJ0030"] -ms.assetid: c48b3727-e166-46e7-bcd7-3e5b2ac5c1d4 --- # Project Build Error PRJ0030 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0031.md b/docs/error-messages/tool-errors/project-build-error-prj0031.md index 27599412ef8..7584eabdb47 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0031.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0031.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0031" title: "Project Build Error PRJ0031" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0031" +ms.date: 11/04/2016 f1_keywords: ["PRJ0031"] helpviewer_keywords: ["PRJ0031"] -ms.assetid: b42435c6-e570-4f8e-9ad5-12a7ea69ccb2 --- # Project Build Error PRJ0031 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0032.md b/docs/error-messages/tool-errors/project-build-error-prj0032.md index 5ec07057e40..d324d45d78c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0032.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0032.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0032" title: "Project Build Error PRJ0032" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0032" +ms.date: 11/04/2016 f1_keywords: ["PRJ0032"] helpviewer_keywords: ["PRJ0032"] -ms.assetid: bc6acbea-4041-4237-8b5a-f0434705d89f --- # Project Build Error PRJ0032 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0033.md b/docs/error-messages/tool-errors/project-build-error-prj0033.md index 1704e69a604..66b3196d043 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0033.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0033.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0033" title: "Project Build Error PRJ0033" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0033" +ms.date: 11/04/2016 f1_keywords: ["PRJ0033"] helpviewer_keywords: ["PRJ0033"] -ms.assetid: 84d4a052-0586-4b78-9315-81c1e8386c1e --- # Project Build Error PRJ0033 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0034.md b/docs/error-messages/tool-errors/project-build-error-prj0034.md index 1551c6a5197..00b59e0ae24 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0034.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0034.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0034" title: "Project Build Error PRJ0034" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0034" +ms.date: 11/04/2016 f1_keywords: ["PRJ0034"] helpviewer_keywords: ["PRJ0034"] -ms.assetid: 1da4a55b-231b-4476-8545-6997628fbc00 --- # Project Build Error PRJ0034 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0035.md b/docs/error-messages/tool-errors/project-build-error-prj0035.md index 3c2e46ab62d..0bfd95e4b65 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0035.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0035.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0035" title: "Project Build Error PRJ0035" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0035" +ms.date: 08/27/2018 f1_keywords: ["PRJ0035"] helpviewer_keywords: ["PRJ0035"] -ms.assetid: 0667116d-338c-40a4-972c-da875f778cb5 --- # Project Build Error PRJ0035 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0036.md b/docs/error-messages/tool-errors/project-build-error-prj0036.md index 1da78f0d908..51622101d0b 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0036.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0036" title: "Project Build Error PRJ0036" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0036" +ms.date: 11/04/2016 f1_keywords: ["PRJ0036"] helpviewer_keywords: ["PRJ0036"] -ms.assetid: ee215cd1-2d66-474d-9a63-b9096f1c4923 --- # Project Build Error PRJ0036 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0040.md b/docs/error-messages/tool-errors/project-build-error-prj0040.md index c3b1bc277bb..5007bb30d4d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0040.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0040.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0040" title: "Project Build Error PRJ0040" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0040" +ms.date: 11/04/2016 f1_keywords: ["PRJ0040"] helpviewer_keywords: ["PRJ0040"] -ms.assetid: 6549ac62-c87b-4edf-b541-32221abe97ec --- # Project Build Error PRJ0040 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0044.md b/docs/error-messages/tool-errors/project-build-error-prj0044.md index da32f43c1f1..1521e028e80 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0044.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0044.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0044" title: "Project Build Error PRJ0044" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0044" +ms.date: 11/04/2016 f1_keywords: ["PRJ0044"] helpviewer_keywords: ["PRJ0044"] -ms.assetid: 5d78c45a-f9e9-4d2b-a3b6-5a5d1421ab84 --- # Project Build Error PRJ0044 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0046.md b/docs/error-messages/tool-errors/project-build-error-prj0046.md index 01281149b3a..85972cd2536 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0046.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0046.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0046" title: "Project Build Error PRJ0046" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0046" +ms.date: 11/04/2016 f1_keywords: ["PRJ0046"] helpviewer_keywords: ["PRJ0046"] -ms.assetid: 59442319-4481-4b97-a4a5-16f52fc718e7 --- # Project Build Error PRJ0046 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0047.md b/docs/error-messages/tool-errors/project-build-error-prj0047.md index ef71f29d1a8..74eeb76498a 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0047.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0047.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0047" title: "Project Build Error PRJ0047" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0047" +ms.date: 11/04/2016 f1_keywords: ["PRJ0047"] helpviewer_keywords: ["PRJ0047"] -ms.assetid: 7c79149d-4b7c-4a24-830e-904d92c1f0b4 --- # Project Build Error PRJ0047 diff --git a/docs/error-messages/tool-errors/project-build-error-prj0050.md b/docs/error-messages/tool-errors/project-build-error-prj0050.md index e7de4e0423d..842578f2ae6 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0050.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0050.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0050" title: "Project Build Error PRJ0050" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0050" +ms.date: 11/04/2016 f1_keywords: ["PRJ0050"] helpviewer_keywords: ["PRJ0050"] -ms.assetid: ceef3b37-0acf-4abd-ac62-aa830b4fa145 --- # Project Build Error PRJ0050 From 86e85c2af04c83a094c60859d0b3357ea8d269c9 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 17:45:39 +0800 Subject: [PATCH 1180/1799] Update error message in C2735 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c2735.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md index 91def172aa9..329da9634b7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2735"] --- # Compiler Error C2735 -> 'keyword' keyword is not permitted in formal parameter type specifier +> '*keyword*' keyword is not permitted in formal parameter type specifier ## Remarks From 57144f5bb7d1a3401c4f26f5eac36ac242a3a1c5 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 17:49:35 +0800 Subject: [PATCH 1181/1799] Fix defunct example in C2735 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c2735.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md index 329da9634b7..b9983716347 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md @@ -19,5 +19,7 @@ The following example generates C2735: ```cpp // C2735.cpp -void f(inline int){} // C2735 +// compile with: /c + +void func(virtual int) {} // C2735 ``` From 5bdc1c781a1f2c2903a0ead3f3c00eafc6f5b402 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 17:50:27 +0800 Subject: [PATCH 1182/1799] Update `ms.date` metadata in C2735 error reference --- docs/error-messages/compiler-errors-2/compiler-error-c2735.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md index b9983716347..8f363b12b84 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2735" description: "Learn more about: Compiler Error C2735" -ms.date: 11/04/2016 +ms.date: 09/12/2025 f1_keywords: ["C2735"] helpviewer_keywords: ["C2735"] --- From 8fedaa916ef4d7845eec65f541747f13d6da892d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 23:00:33 +0800 Subject: [PATCH 1183/1799] Add blockquotes for warning messages in range [PRJ0018, PRJ0049] --- .../error-messages/tool-errors/project-build-warning-prj0018.md | 2 +- .../error-messages/tool-errors/project-build-warning-prj0029.md | 2 +- .../error-messages/tool-errors/project-build-warning-prj0041.md | 2 +- .../error-messages/tool-errors/project-build-warning-prj0049.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0018.md b/docs/error-messages/tool-errors/project-build-warning-prj0018.md index e02b3c1b322..2484e029cff 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0018.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0018.md @@ -8,7 +8,7 @@ ms.assetid: 1a3d9e40-6a35-4a74-b6ba-8079f7a82217 --- # Project Build Warning PRJ0018 -The following environment variables were not found: +> The following environment variables were not found: An environment variable is not defined. This error lists the environment variables that were not defined. diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0029.md b/docs/error-messages/tool-errors/project-build-warning-prj0029.md index cebf87396e8..682d2e3b3a6 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0029.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0029.md @@ -8,7 +8,7 @@ ms.assetid: f02c09c6-09f3-4d44-8cd4-9a25336be1ea --- # Project Build Warning PRJ0029 -The 'Outputs' property for the project-level custom build step is not set. The custom build step will be skipped. +> The 'Outputs' property for the project-level custom build step is not set. The custom build step will be skipped. A custom build step was not executed because no output was specified. diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0041.md b/docs/error-messages/tool-errors/project-build-warning-prj0041.md index 7241c771d4a..d9f4e3fb1b9 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0041.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0041.md @@ -8,7 +8,7 @@ ms.assetid: dc9f4cf9-6bd5-4222-89e8-7802a59bb96b --- # Project Build Warning PRJ0041 -Cannot find missing dependency 'dependency' for file 'file'. Your project may still build, but may continue to appear out of date until this file is found. +> Cannot find missing dependency 'dependency' for file 'file'. Your project may still build, but may continue to appear out of date until this file is found. A file (resource file or .idl/.odl file, for example, contained an include statement that the project system could not resolve. diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0049.md b/docs/error-messages/tool-errors/project-build-warning-prj0049.md index ee21f0e2b2a..b94d307392b 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0049.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0049.md @@ -7,7 +7,7 @@ ms.assetid: 8b38afa1-e080-4efd-ae89-776cfd044413 --- # Project Build Warning PRJ0049 -Referenced target '\' requires .NET Framework \ and will fail to run on this project's target framework +> Referenced target '\' requires .NET Framework \ and will fail to run on this project's target framework Applications created by using Visual Studio 2008 can specify which version of the .NET Framework they should target. If you add a reference to an assembly or project that depends on a version of the .NET Framework that is later than the targeted version, you will get this warning at compile time. From c586ebb9dd90c6bdaaa6cf94fc7704e828c5b9d6 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 23:01:52 +0800 Subject: [PATCH 1184/1799] Add "Remarks" headings for warning references in range [PRJ0018, PRJ0049] --- .../error-messages/tool-errors/project-build-warning-prj0018.md | 2 ++ .../error-messages/tool-errors/project-build-warning-prj0029.md | 2 ++ .../error-messages/tool-errors/project-build-warning-prj0041.md | 2 ++ .../error-messages/tool-errors/project-build-warning-prj0042.md | 2 ++ .../error-messages/tool-errors/project-build-warning-prj0049.md | 2 ++ 5 files changed, 10 insertions(+) diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0018.md b/docs/error-messages/tool-errors/project-build-warning-prj0018.md index 2484e029cff..20a63acad9a 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0018.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0018.md @@ -10,6 +10,8 @@ ms.assetid: 1a3d9e40-6a35-4a74-b6ba-8079f7a82217 > The following environment variables were not found: +## Remarks + An environment variable is not defined. This error lists the environment variables that were not defined. See [Macros for Custom Build Commands](../../build/reference/common-macros-for-build-commands-and-properties.md) for information on macros in the build process. diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0029.md b/docs/error-messages/tool-errors/project-build-warning-prj0029.md index 682d2e3b3a6..5eed81946f8 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0029.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0029.md @@ -10,6 +10,8 @@ ms.assetid: f02c09c6-09f3-4d44-8cd4-9a25336be1ea > The 'Outputs' property for the project-level custom build step is not set. The custom build step will be skipped. +## Remarks + A custom build step was not executed because no output was specified. To resolve this error, do one the following: diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0041.md b/docs/error-messages/tool-errors/project-build-warning-prj0041.md index d9f4e3fb1b9..2366186e611 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0041.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0041.md @@ -10,6 +10,8 @@ ms.assetid: dc9f4cf9-6bd5-4222-89e8-7802a59bb96b > Cannot find missing dependency 'dependency' for file 'file'. Your project may still build, but may continue to appear out of date until this file is found. +## Remarks + A file (resource file or .idl/.odl file, for example, contained an include statement that the project system could not resolve. Because the project system does not process preprocessor statements (#if, for example), the offending statement may not actually be part of the build. diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0042.md b/docs/error-messages/tool-errors/project-build-warning-prj0042.md index 3951812d71c..4827a8768ee 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0042.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0042.md @@ -10,6 +10,8 @@ ms.assetid: 682c9999-6f85-409f-b102-00c93243f74f > The 'Outputs' property for the custom build step for file '*file*' is not set. The custom build step will be skipped. +## Remarks + A custom build step was not executed because no output was specified. To resolve this error, do one the following: diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0049.md b/docs/error-messages/tool-errors/project-build-warning-prj0049.md index b94d307392b..97f9b481b2b 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0049.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0049.md @@ -9,6 +9,8 @@ ms.assetid: 8b38afa1-e080-4efd-ae89-776cfd044413 > Referenced target '\' requires .NET Framework \ and will fail to run on this project's target framework +## Remarks + Applications created by using Visual Studio 2008 can specify which version of the .NET Framework they should target. If you add a reference to an assembly or project that depends on a version of the .NET Framework that is later than the targeted version, you will get this warning at compile time. ### To correct this warning From eee2cc1e48d62d8a24858a8d98e4145f5ee57ebd Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 23:05:00 +0800 Subject: [PATCH 1185/1799] Update metadata for warning references in range [PRJ0018, PRJ0049] --- .../tool-errors/project-build-warning-prj0018.md | 5 ++--- .../tool-errors/project-build-warning-prj0029.md | 5 ++--- .../tool-errors/project-build-warning-prj0041.md | 5 ++--- .../tool-errors/project-build-warning-prj0042.md | 5 ++--- .../tool-errors/project-build-warning-prj0049.md | 5 ++--- 5 files changed, 10 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0018.md b/docs/error-messages/tool-errors/project-build-warning-prj0018.md index 20a63acad9a..a5ec336c93a 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0018.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0018.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Warning PRJ0018" title: "Project Build Warning PRJ0018" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Warning PRJ0018" +ms.date: 11/04/2016 f1_keywords: ["PRJ0018"] helpviewer_keywords: ["PRJ0018"] -ms.assetid: 1a3d9e40-6a35-4a74-b6ba-8079f7a82217 --- # Project Build Warning PRJ0018 diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0029.md b/docs/error-messages/tool-errors/project-build-warning-prj0029.md index 5eed81946f8..78a22ac3bac 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0029.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0029.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Warning PRJ0029" title: "Project Build Warning PRJ0029" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Warning PRJ0029" +ms.date: 11/04/2016 f1_keywords: ["PRJ0029"] helpviewer_keywords: ["PRJ0029"] -ms.assetid: f02c09c6-09f3-4d44-8cd4-9a25336be1ea --- # Project Build Warning PRJ0029 diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0041.md b/docs/error-messages/tool-errors/project-build-warning-prj0041.md index 2366186e611..4a500c4ce83 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0041.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0041.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Warning PRJ0041" title: "Project Build Warning PRJ0041" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Warning PRJ0041" +ms.date: 11/04/2016 f1_keywords: ["PRJ0041"] helpviewer_keywords: ["PRJ0041"] -ms.assetid: dc9f4cf9-6bd5-4222-89e8-7802a59bb96b --- # Project Build Warning PRJ0041 diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0042.md b/docs/error-messages/tool-errors/project-build-warning-prj0042.md index 4827a8768ee..a85189952fa 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0042.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0042.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Warning PRJ0042" title: "Project Build Warning PRJ0042" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Warning PRJ0042" +ms.date: 08/27/2018 f1_keywords: ["PRJ0042"] helpviewer_keywords: ["PRJ0042"] -ms.assetid: 682c9999-6f85-409f-b102-00c93243f74f --- # Project Build Warning PRJ0042 diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0049.md b/docs/error-messages/tool-errors/project-build-warning-prj0049.md index 97f9b481b2b..64d660a8f08 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0049.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0049.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Project Build Warning PRJ0049" title: "Project Build Warning PRJ0049" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Warning PRJ0049" +ms.date: 11/04/2016 helpviewer_keywords: ["PRJ0049"] -ms.assetid: 8b38afa1-e080-4efd-ae89-776cfd044413 --- # Project Build Warning PRJ0049 From e1d055995e777970d00b6cf9b3cb899880a9fe17 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 12 Sep 2025 23:07:29 +0800 Subject: [PATCH 1186/1799] Add missing `f1_keywords` metadata in PRJ0049 warning reference --- docs/error-messages/tool-errors/project-build-warning-prj0049.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0049.md b/docs/error-messages/tool-errors/project-build-warning-prj0049.md index 64d660a8f08..0073df2310b 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0049.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0049.md @@ -2,6 +2,7 @@ title: "Project Build Warning PRJ0049" description: "Learn more about: Project Build Warning PRJ0049" ms.date: 11/04/2016 +f1_keywords: ["PRJ0049"] helpviewer_keywords: ["PRJ0049"] --- # Project Build Warning PRJ0049 From e94dda38cb0ae1c3cc4e9f84b72ea843b46e2161 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:16:29 +0800 Subject: [PATCH 1187/1799] Add blockquotes for error messages in range [D8016, D8049] --- docs/error-messages/tool-errors/command-line-error-d8016.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8021.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8022.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8027.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8036.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8037.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8045.md | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-error-d8016.md b/docs/error-messages/tool-errors/command-line-error-d8016.md index e71b3d6cd07..c9d4ad5b508 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8016.md +++ b/docs/error-messages/tool-errors/command-line-error-d8016.md @@ -8,7 +8,7 @@ ms.assetid: eec51312-7471-4f92-94b2-d517cafc8ef5 --- # Command-Line Error D8016 -'option1' and 'option2' command-line options are incompatible +> 'option1' and 'option2' command-line options are incompatible The command-line options cannot be specified together. diff --git a/docs/error-messages/tool-errors/command-line-error-d8021.md b/docs/error-messages/tool-errors/command-line-error-d8021.md index 5daada8340c..4623eb4eedc 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8021.md +++ b/docs/error-messages/tool-errors/command-line-error-d8021.md @@ -8,6 +8,6 @@ ms.assetid: 8ec85441-d0d8-42d8-b777-1e4636ea9878 --- # Command-Line Error D8021 -invalid numeric argument 'number' +> invalid numeric argument 'number' A number greater than 65,534 was specified as a numeric argument. diff --git a/docs/error-messages/tool-errors/command-line-error-d8022.md b/docs/error-messages/tool-errors/command-line-error-d8022.md index 0fde42f9251..a96fc7f0267 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8022.md +++ b/docs/error-messages/tool-errors/command-line-error-d8022.md @@ -8,7 +8,7 @@ ms.assetid: eb18ec34-d32d-4636-a852-abf2063e886b --- # Command-Line Error D8022 -cannot open 'messagefile' +> cannot open 'messagefile' The given file was not in the current directory or in a directory specified in the PATH environment variable. The message file contains a brief summary of compiler command-line syntax and options. diff --git a/docs/error-messages/tool-errors/command-line-error-d8027.md b/docs/error-messages/tool-errors/command-line-error-d8027.md index 9fb55846634..2c3ddadf48d 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8027.md +++ b/docs/error-messages/tool-errors/command-line-error-d8027.md @@ -8,7 +8,7 @@ ms.assetid: f228220f-0c7f-49a6-a6e0-1f7bd4745aa6 --- # Command-Line Error D8027 -cannot execute 'component' +> cannot execute 'component' The compiler could not run the given compiler component or linker. diff --git a/docs/error-messages/tool-errors/command-line-error-d8036.md b/docs/error-messages/tool-errors/command-line-error-d8036.md index 86973440583..3e3a1c40d2d 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8036.md +++ b/docs/error-messages/tool-errors/command-line-error-d8036.md @@ -8,7 +8,7 @@ ms.assetid: 420a8daf-1873-49cd-95ea-a603d77b9410 --- # Command-Line Error D8036 -'/option' not allowed with multiple source files +> '/option' not allowed with multiple source files These compiler options cannot be used with multiple source files: diff --git a/docs/error-messages/tool-errors/command-line-error-d8037.md b/docs/error-messages/tool-errors/command-line-error-d8037.md index d85b75168da..a1481b4c3b0 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8037.md +++ b/docs/error-messages/tool-errors/command-line-error-d8037.md @@ -8,7 +8,7 @@ ms.assetid: acddaaa0-bd84-426f-a37b-8f680b379c9d --- # Command-Line Error D8037 -cannot create temporary il file; clean temp directory of old il files +> cannot create temporary il file; clean temp directory of old il files There is not enough space to create temporary compiler intermediate files. To remedy this error, remove any old MSIL files in the directory specified by the **TMP** environment variable. These files will be of the form _CL_hhhhhhhh.ss, where h represents a random hexadecimal digit and ss represents the type of IL file. Also, be sure to update your machine with the latest operating system patches. diff --git a/docs/error-messages/tool-errors/command-line-error-d8045.md b/docs/error-messages/tool-errors/command-line-error-d8045.md index fad1a656cf8..9eeb050064f 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8045.md +++ b/docs/error-messages/tool-errors/command-line-error-d8045.md @@ -8,7 +8,7 @@ ms.assetid: 01c8808c-bac1-4b4d-8a90-b595f95e9318 --- # Command-Line Error D8045 -cannot compile C file 'file' with the /clr option +> cannot compile C file 'file' with the /clr option Only C++ source code files can be passed to a compilation that uses **/clr**. Use **/TP** to compile a .c file as a .cpp file; see [/Tc, /Tp, /TC, /TP (Specify Source File Type)](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) for more information. From 489e93eb6063f42dd97dea0d64ff9172ca92eff2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:18:21 +0800 Subject: [PATCH 1188/1799] Add "Remarks" headings for error references in range [D8016, D8049] --- docs/error-messages/tool-errors/command-line-error-d8016.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8021.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8022.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8027.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8036.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8037.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8045.md | 2 ++ docs/error-messages/tool-errors/command-line-error-d8048.md | 4 ++-- docs/error-messages/tool-errors/command-line-error-d8049.md | 4 ++-- 9 files changed, 18 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-error-d8016.md b/docs/error-messages/tool-errors/command-line-error-d8016.md index c9d4ad5b508..1fe996958e8 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8016.md +++ b/docs/error-messages/tool-errors/command-line-error-d8016.md @@ -10,6 +10,8 @@ ms.assetid: eec51312-7471-4f92-94b2-d517cafc8ef5 > 'option1' and 'option2' command-line options are incompatible +## Remarks + The command-line options cannot be specified together. Check environment variables, such as CL, for option specifications. diff --git a/docs/error-messages/tool-errors/command-line-error-d8021.md b/docs/error-messages/tool-errors/command-line-error-d8021.md index 4623eb4eedc..2e0b943bf5e 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8021.md +++ b/docs/error-messages/tool-errors/command-line-error-d8021.md @@ -10,4 +10,6 @@ ms.assetid: 8ec85441-d0d8-42d8-b777-1e4636ea9878 > invalid numeric argument 'number' +## Remarks + A number greater than 65,534 was specified as a numeric argument. diff --git a/docs/error-messages/tool-errors/command-line-error-d8022.md b/docs/error-messages/tool-errors/command-line-error-d8022.md index a96fc7f0267..e4528f28403 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8022.md +++ b/docs/error-messages/tool-errors/command-line-error-d8022.md @@ -10,6 +10,8 @@ ms.assetid: eb18ec34-d32d-4636-a852-abf2063e886b > cannot open 'messagefile' +## Remarks + The given file was not in the current directory or in a directory specified in the PATH environment variable. The message file contains a brief summary of compiler command-line syntax and options. Move this file to the current directory or a directory in the current path. If this file cannot be found, run the SETUP program to copy it from the distribution disks. diff --git a/docs/error-messages/tool-errors/command-line-error-d8027.md b/docs/error-messages/tool-errors/command-line-error-d8027.md index 2c3ddadf48d..a59a6e4acb4 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8027.md +++ b/docs/error-messages/tool-errors/command-line-error-d8027.md @@ -10,6 +10,8 @@ ms.assetid: f228220f-0c7f-49a6-a6e0-1f7bd4745aa6 > cannot execute 'component' +## Remarks + The compiler could not run the given compiler component or linker. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/command-line-error-d8036.md b/docs/error-messages/tool-errors/command-line-error-d8036.md index 3e3a1c40d2d..3fc557944f4 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8036.md +++ b/docs/error-messages/tool-errors/command-line-error-d8036.md @@ -10,6 +10,8 @@ ms.assetid: 420a8daf-1873-49cd-95ea-a603d77b9410 > '/option' not allowed with multiple source files +## Remarks + These compiler options cannot be used with multiple source files: - Name assembly file listing (/Fa) diff --git a/docs/error-messages/tool-errors/command-line-error-d8037.md b/docs/error-messages/tool-errors/command-line-error-d8037.md index a1481b4c3b0..48cb2eeff43 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8037.md +++ b/docs/error-messages/tool-errors/command-line-error-d8037.md @@ -10,6 +10,8 @@ ms.assetid: acddaaa0-bd84-426f-a37b-8f680b379c9d > cannot create temporary il file; clean temp directory of old il files +## Remarks + There is not enough space to create temporary compiler intermediate files. To remedy this error, remove any old MSIL files in the directory specified by the **TMP** environment variable. These files will be of the form _CL_hhhhhhhh.ss, where h represents a random hexadecimal digit and ss represents the type of IL file. Also, be sure to update your machine with the latest operating system patches. ## See also diff --git a/docs/error-messages/tool-errors/command-line-error-d8045.md b/docs/error-messages/tool-errors/command-line-error-d8045.md index 9eeb050064f..03fda0dd403 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8045.md +++ b/docs/error-messages/tool-errors/command-line-error-d8045.md @@ -10,6 +10,8 @@ ms.assetid: 01c8808c-bac1-4b4d-8a90-b595f95e9318 > cannot compile C file 'file' with the /clr option +## Remarks + Only C++ source code files can be passed to a compilation that uses **/clr**. Use **/TP** to compile a .c file as a .cpp file; see [/Tc, /Tp, /TC, /TP (Specify Source File Type)](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) for more information. For more information, see [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md). diff --git a/docs/error-messages/tool-errors/command-line-error-d8048.md b/docs/error-messages/tool-errors/command-line-error-d8048.md index 65fa5514cab..9f126105634 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8048.md +++ b/docs/error-messages/tool-errors/command-line-error-d8048.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["D8048"] > cannot compile C file '*file-name*' with /ZW option -Only C++ source code files can be passed to the compiler when you use the [`/ZW` (Windows Runtime compilation)](../../build/reference/zw-windows-runtime-compilation.md) compiler option. - ## Remarks +Only C++ source code files can be passed to the compiler when you use the [`/ZW` (Windows Runtime compilation)](../../build/reference/zw-windows-runtime-compilation.md) compiler option. + By default, all files in a C++ Universal Windows platform (UWP) project are compiled by using the **`/ZW`** compiler option. The **`/ZW`** option enables the Windows Runtime compiler extensions, or C++/CX. Unfortunately, **`/ZW`** doesn't work on C source files. You can disable C++/CX compilation selectively for C files in Visual Studio projects. Select your C file in Solution Explorer, then right-click to choose **Properties** from the shortcut menu. In the **Property Pages** dialog, select the **Configuration Properties** > **C/C++** -> **General** property page. Set the **Consume Windows Runtime Extension** property to *`No`*. Choose **OK** to save your changes. diff --git a/docs/error-messages/tool-errors/command-line-error-d8049.md b/docs/error-messages/tool-errors/command-line-error-d8049.md index ec848363813..a4322d5ba1b 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8049.md +++ b/docs/error-messages/tool-errors/command-line-error-d8049.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["D8049"] > cannot execute '*compiler-component*': command line is too long to fit in debug record -An internal length limit on debug record include paths was exceeded. - ## Remarks +An internal length limit on debug record include paths was exceeded. + When the compiler creates debug records in an object file, it uses the full path for each included file. Absolute paths are recorded as specified. For relative include paths, the debug record prepends the build's current working directory to the relative path. If your build runs in a relatively deep path, the corresponding path records get longer. The total length of too many long paths can exceed the internal limits of the compiler. ## To resolve this issue From da0ebf9968271ef6dcac8562326f0a99cfe1a198 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:20:37 +0800 Subject: [PATCH 1189/1799] Update metadata for error references in range [D8016, D8049] --- docs/error-messages/tool-errors/command-line-error-d8016.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8021.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8022.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8027.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8036.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8037.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8045.md | 5 ++--- docs/error-messages/tool-errors/command-line-error-d8048.md | 2 +- docs/error-messages/tool-errors/command-line-error-d8049.md | 2 +- 9 files changed, 16 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-error-d8016.md b/docs/error-messages/tool-errors/command-line-error-d8016.md index 1fe996958e8..6378c6f5ad7 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8016.md +++ b/docs/error-messages/tool-errors/command-line-error-d8016.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8016" title: "Command-Line Error D8016" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8016" +ms.date: 11/04/2016 f1_keywords: ["D8016"] helpviewer_keywords: ["D8016"] -ms.assetid: eec51312-7471-4f92-94b2-d517cafc8ef5 --- # Command-Line Error D8016 diff --git a/docs/error-messages/tool-errors/command-line-error-d8021.md b/docs/error-messages/tool-errors/command-line-error-d8021.md index 2e0b943bf5e..67f23270441 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8021.md +++ b/docs/error-messages/tool-errors/command-line-error-d8021.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8021" title: "Command-Line Error D8021" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8021" +ms.date: 11/04/2016 f1_keywords: ["D8021"] helpviewer_keywords: ["D8021"] -ms.assetid: 8ec85441-d0d8-42d8-b777-1e4636ea9878 --- # Command-Line Error D8021 diff --git a/docs/error-messages/tool-errors/command-line-error-d8022.md b/docs/error-messages/tool-errors/command-line-error-d8022.md index e4528f28403..430d8c3d87a 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8022.md +++ b/docs/error-messages/tool-errors/command-line-error-d8022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8022" title: "Command-Line Error D8022" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8022" +ms.date: 11/04/2016 f1_keywords: ["D8022"] helpviewer_keywords: ["D8022"] -ms.assetid: eb18ec34-d32d-4636-a852-abf2063e886b --- # Command-Line Error D8022 diff --git a/docs/error-messages/tool-errors/command-line-error-d8027.md b/docs/error-messages/tool-errors/command-line-error-d8027.md index a59a6e4acb4..886b134653b 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8027.md +++ b/docs/error-messages/tool-errors/command-line-error-d8027.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8027" title: "Command-Line Error D8027" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8027" +ms.date: 11/04/2016 f1_keywords: ["D8027"] helpviewer_keywords: ["D8027"] -ms.assetid: f228220f-0c7f-49a6-a6e0-1f7bd4745aa6 --- # Command-Line Error D8027 diff --git a/docs/error-messages/tool-errors/command-line-error-d8036.md b/docs/error-messages/tool-errors/command-line-error-d8036.md index 3fc557944f4..986134ce3d3 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8036.md +++ b/docs/error-messages/tool-errors/command-line-error-d8036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8036" title: "Command-Line Error D8036" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8036" +ms.date: 11/04/2016 f1_keywords: ["D8036"] helpviewer_keywords: ["D8036"] -ms.assetid: 420a8daf-1873-49cd-95ea-a603d77b9410 --- # Command-Line Error D8036 diff --git a/docs/error-messages/tool-errors/command-line-error-d8037.md b/docs/error-messages/tool-errors/command-line-error-d8037.md index 48cb2eeff43..be3f25d3a85 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8037.md +++ b/docs/error-messages/tool-errors/command-line-error-d8037.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8037" title: "Command-Line Error D8037" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8037" +ms.date: 11/04/2016 f1_keywords: ["D8037"] helpviewer_keywords: ["D8037"] -ms.assetid: acddaaa0-bd84-426f-a37b-8f680b379c9d --- # Command-Line Error D8037 diff --git a/docs/error-messages/tool-errors/command-line-error-d8045.md b/docs/error-messages/tool-errors/command-line-error-d8045.md index 03fda0dd403..0297b0dbfcc 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8045.md +++ b/docs/error-messages/tool-errors/command-line-error-d8045.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Error D8045" title: "Command-Line Error D8045" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8045" +ms.date: 11/04/2016 f1_keywords: ["D8045"] helpviewer_keywords: ["D8045"] -ms.assetid: 01c8808c-bac1-4b4d-8a90-b595f95e9318 --- # Command-Line Error D8045 diff --git a/docs/error-messages/tool-errors/command-line-error-d8048.md b/docs/error-messages/tool-errors/command-line-error-d8048.md index 9f126105634..39dcd944558 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8048.md +++ b/docs/error-messages/tool-errors/command-line-error-d8048.md @@ -1,6 +1,6 @@ --- -description: "Learn about causes and solutions for command-line error D8048" title: "Command-Line Error D8048" +description: "Learn about causes and solutions for command-line error D8048" ms.date: 04/18/2021 f1_keywords: ["D8048"] helpviewer_keywords: ["D8048"] diff --git a/docs/error-messages/tool-errors/command-line-error-d8049.md b/docs/error-messages/tool-errors/command-line-error-d8049.md index a4322d5ba1b..24c359f7583 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8049.md +++ b/docs/error-messages/tool-errors/command-line-error-d8049.md @@ -1,6 +1,6 @@ --- -description: "Learn about the cause and solutions for command-line error D8049" title: "Command-Line Error D8049" +description: "Learn about the cause and solutions for command-line error D8049" ms.date: 10/28/2021 f1_keywords: ["D8049"] helpviewer_keywords: ["D8049"] From d07aceae9da213e392820e89a1dc75df90a4f644 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:26:50 +0800 Subject: [PATCH 1190/1799] Add blockquotes for warning messages in range [D9024, D9043] --- docs/error-messages/tool-errors/command-line-warning-d9024.md | 2 +- docs/error-messages/tool-errors/command-line-warning-d9025.md | 2 +- docs/error-messages/tool-errors/command-line-warning-d9027.md | 2 +- docs/error-messages/tool-errors/command-line-warning-d9043.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-warning-d9024.md b/docs/error-messages/tool-errors/command-line-warning-d9024.md index e161eb89438..2018e8843c3 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9024.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9024.md @@ -8,7 +8,7 @@ ms.assetid: daf4896d-223d-4af0-9b6d-89109cf3d1bb --- # Command-Line Warning D9024 -unrecognized source file type 'filename', object file assumed +> unrecognized source file type 'filename', object file assumed The extension of the specified file was not recognized. The file was assumed to be an object file and was passed to the linker. diff --git a/docs/error-messages/tool-errors/command-line-warning-d9025.md b/docs/error-messages/tool-errors/command-line-warning-d9025.md index 156400af5db..ecd77b9feef 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9025.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9025.md @@ -8,7 +8,7 @@ ms.assetid: 6edff72c-1508-46c2-99f4-0e4b3c5e60c9 --- # Command-Line Warning D9025 -overriding 'option1' with 'option2' +> overriding 'option1' with 'option2' The *option1* option was specified but was then overridden by *option2*. The *option2* option was used. diff --git a/docs/error-messages/tool-errors/command-line-warning-d9027.md b/docs/error-messages/tool-errors/command-line-warning-d9027.md index a50befaedea..718599bd182 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9027.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9027.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["D9027"] --- # Command-Line Warning D9027 -source file '\' ignored +> source file '\' ignored CL.exe ignored the input source file. diff --git a/docs/error-messages/tool-errors/command-line-warning-d9043.md b/docs/error-messages/tool-errors/command-line-warning-d9043.md index 44bc3eb9b8f..664bfc3b802 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9043.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9043.md @@ -8,7 +8,7 @@ ms.assetid: 9263e28d-217b-414c-bfb6-86efd3c27a77 --- # Command-Line Warning D9043 -invalid value 'warning_level' for 'compiler_option'; assuming '4999'; Code Analysis warnings are not associated with warning levels +> invalid value 'warning_level' for 'compiler_option'; assuming '4999'; Code Analysis warnings are not associated with warning levels ## Example From 7d86ccfce17686ba8ff75898e6022b83412820e5 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:30:54 +0800 Subject: [PATCH 1191/1799] Add "Remarks" and "Example" headings for warning references in range [D9024, D9043] --- .../tool-errors/command-line-warning-d9024.md | 2 ++ .../tool-errors/command-line-warning-d9025.md | 2 ++ .../tool-errors/command-line-warning-d9026.md | 4 ++++ .../tool-errors/command-line-warning-d9027.md | 8 +++++++- .../tool-errors/command-line-warning-d9028.md | 2 ++ .../tool-errors/command-line-warning-d9040.md | 2 ++ .../tool-errors/command-line-warning-d9041.md | 2 ++ 7 files changed, 21 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/command-line-warning-d9024.md b/docs/error-messages/tool-errors/command-line-warning-d9024.md index 2018e8843c3..c24383473b1 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9024.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9024.md @@ -10,6 +10,8 @@ ms.assetid: daf4896d-223d-4af0-9b6d-89109cf3d1bb > unrecognized source file type 'filename', object file assumed +## Remarks + The extension of the specified file was not recognized. The file was assumed to be an object file and was passed to the linker. The following extensions are recognized: diff --git a/docs/error-messages/tool-errors/command-line-warning-d9025.md b/docs/error-messages/tool-errors/command-line-warning-d9025.md index ecd77b9feef..3d4789046e7 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9025.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9025.md @@ -10,6 +10,8 @@ ms.assetid: 6edff72c-1508-46c2-99f4-0e4b3c5e60c9 > overriding 'option1' with 'option2' +## Remarks + The *option1* option was specified but was then overridden by *option2*. The *option2* option was used. If two options specify contradictory or incompatible directives, the directive specified or implied in the option farthest to the right on the command line is used. diff --git a/docs/error-messages/tool-errors/command-line-warning-d9026.md b/docs/error-messages/tool-errors/command-line-warning-d9026.md index 1b28c6a30e2..92dc69cb428 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9026.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9026.md @@ -10,8 +10,12 @@ ms.assetid: 149fe5e3-5329-4be8-b871-49dfd423aaba > options apply to entire command line +## Remarks + A global option was specified after one or more filenames were specified. The option was also applied to the files that preceded it. +## Example + For example, consider this command line: `CL verdi.c /O2 puccini.c` diff --git a/docs/error-messages/tool-errors/command-line-warning-d9027.md b/docs/error-messages/tool-errors/command-line-warning-d9027.md index 718599bd182..89064f31aa7 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9027.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9027.md @@ -9,9 +9,15 @@ helpviewer_keywords: ["D9027"] > source file '\' ignored +## Remarks + CL.exe ignored the input source file. -This warning can be caused by a space between the /Fo option and an output filename on a command line with the /c option. For example: +This warning can be caused by a space between the /Fo option and an output filename on a command line with the /c option. + +## Example + +For example: ```cmd cl /c /Fo output.obj input.c diff --git a/docs/error-messages/tool-errors/command-line-warning-d9028.md b/docs/error-messages/tool-errors/command-line-warning-d9028.md index 0c538f76ea5..8511f7691ff 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9028.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9028.md @@ -10,6 +10,8 @@ ms.assetid: 03852b51-fa59-4114-ab1f-2af0509119af > minimal rebuild failure, reverting to normal build +## Remarks + The project .idb file is corrupt. Delete the file and rebuild. For more information on minimal rebuilds and the .idb file, see the deprecated [/Gm compiler option](../../build/reference/gm-enable-minimal-rebuild.md). diff --git a/docs/error-messages/tool-errors/command-line-warning-d9040.md b/docs/error-messages/tool-errors/command-line-warning-d9040.md index 3f9c925fb41..c18ecb3f41d 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9040.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9040.md @@ -10,6 +10,8 @@ ms.assetid: 415e7f04-c1bd-4ac1-924a-03efa4645140 > ignoring option '/analyze'; Code Analysis warnings are not available in this edition of the compiler +## Remarks + The **`/analyze`** command line option is not available in all editions of Visual Studio. To remedy this warning, either switch to a supported edition of Visual Studio, or remove the command line option. ## See also diff --git a/docs/error-messages/tool-errors/command-line-warning-d9041.md b/docs/error-messages/tool-errors/command-line-warning-d9041.md index b477d13c8c7..15acde80990 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9041.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9041.md @@ -10,6 +10,8 @@ ms.assetid: ada8815f-4246-4e25-b57d-a7f16fa107cc > invalid value '*option-value*' for '/*option-name*'; assuming '*assumed-value*'; add '/analyze' to command-line options when specifying this warning +## Remarks + A Code Analysis warning number was added to the **`/wd`**, **`/we`**, **`/wo`**, or **`/wl`** command line option without also specifying the **`/analyze`** command line option. To remedy this error, either add the **`/analyze`** command line option, or remove the invalid warning number from the appropriate **`/w`** command line option. ## Example From b7aa19946ccbe8aa73f366b7d2bf8c6619e8856f Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:31:25 +0800 Subject: [PATCH 1192/1799] Replace term "sample" with "example" for warning references in range [D9024, D9043] --- docs/error-messages/tool-errors/command-line-warning-d9043.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/command-line-warning-d9043.md b/docs/error-messages/tool-errors/command-line-warning-d9043.md index 664bfc3b802..df407747d65 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9043.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9043.md @@ -12,7 +12,7 @@ ms.assetid: 9263e28d-217b-414c-bfb6-86efd3c27a77 ## Example -The following sample generates C9043. +The following example generates C9043. ```cpp // D9043.cpp From 1cff297dace1339dc534aa2fd1d5361a8e73cf43 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 13 Sep 2025 22:33:39 +0800 Subject: [PATCH 1193/1799] Update metadata for warning references in range [D9024, D9043] --- .../error-messages/tool-errors/command-line-warning-d9024.md | 5 ++--- .../error-messages/tool-errors/command-line-warning-d9025.md | 5 ++--- .../error-messages/tool-errors/command-line-warning-d9026.md | 3 +-- .../error-messages/tool-errors/command-line-warning-d9028.md | 5 ++--- .../error-messages/tool-errors/command-line-warning-d9035.md | 5 ++--- .../error-messages/tool-errors/command-line-warning-d9036.md | 5 ++--- .../error-messages/tool-errors/command-line-warning-d9040.md | 5 ++--- .../error-messages/tool-errors/command-line-warning-d9041.md | 5 ++--- .../error-messages/tool-errors/command-line-warning-d9043.md | 5 ++--- 9 files changed, 17 insertions(+), 26 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-warning-d9024.md b/docs/error-messages/tool-errors/command-line-warning-d9024.md index c24383473b1..5af7073689e 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9024.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9024.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9024" title: "Command-Line Warning D9024" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9024" +ms.date: 11/04/2016 f1_keywords: ["D9024"] helpviewer_keywords: ["D9024"] -ms.assetid: daf4896d-223d-4af0-9b6d-89109cf3d1bb --- # Command-Line Warning D9024 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9025.md b/docs/error-messages/tool-errors/command-line-warning-d9025.md index 3d4789046e7..43d872d40fc 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9025.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9025.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9025" title: "Command-Line Warning D9025" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9025" +ms.date: 11/04/2016 f1_keywords: ["D9025"] helpviewer_keywords: ["D9025"] -ms.assetid: 6edff72c-1508-46c2-99f4-0e4b3c5e60c9 --- # Command-Line Warning D9025 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9026.md b/docs/error-messages/tool-errors/command-line-warning-d9026.md index 92dc69cb428..ec76878b14d 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9026.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9026.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-line warning D9026" title: "Command-line warning D9026" +description: "Learn more about: Command-line warning D9026" ms.date: 12/09/2021 f1_keywords: ["D9026"] helpviewer_keywords: ["D9026"] -ms.assetid: 149fe5e3-5329-4be8-b871-49dfd423aaba --- # Command-line warning D9026 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9028.md b/docs/error-messages/tool-errors/command-line-warning-d9028.md index 8511f7691ff..35b38a28518 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9028.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9028.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9028" title: "Command-Line Warning D9028" -ms.date: "04/08/2019" +description: "Learn more about: Command-Line Warning D9028" +ms.date: 04/08/2019 f1_keywords: ["D9028"] helpviewer_keywords: ["D9028"] -ms.assetid: 03852b51-fa59-4114-ab1f-2af0509119af --- # Command-Line Warning D9028 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9035.md b/docs/error-messages/tool-errors/command-line-warning-d9035.md index d7d3262869e..eb8cf111ac6 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9035.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9035.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9035" title: "Command-Line Warning D9035" -ms.date: "12/10/2018" +description: "Learn more about: Command-Line Warning D9035" +ms.date: 12/10/2018 f1_keywords: ["D9035"] helpviewer_keywords: ["D9035"] -ms.assetid: 6254f933-e37a-45ba-b860-1a870d1bc8e8 --- # Command-Line Warning D9035 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9036.md b/docs/error-messages/tool-errors/command-line-warning-d9036.md index d26818460c1..6f1363ee3b9 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9036.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9036" title: "Command-Line Warning D9036" -ms.date: "12/10/2018" +description: "Learn more about: Command-Line Warning D9036" +ms.date: 12/10/2018 f1_keywords: ["D9036"] helpviewer_keywords: ["D9036"] -ms.assetid: 68276e84-8d4e-4d4a-a9db-2874c81dfe66 --- # Command-Line Warning D9036 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9040.md b/docs/error-messages/tool-errors/command-line-warning-d9040.md index c18ecb3f41d..900922a82cd 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9040.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9040.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9040" title: "Command-Line Warning D9040" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9040" +ms.date: 11/04/2016 f1_keywords: ["D9040"] helpviewer_keywords: ["D9040"] -ms.assetid: 415e7f04-c1bd-4ac1-924a-03efa4645140 --- # Command-Line Warning D9040 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9041.md b/docs/error-messages/tool-errors/command-line-warning-d9041.md index 15acde80990..80f0bb4e6da 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9041.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9041.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9041" title: "Command-Line Warning D9041" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9041" +ms.date: 11/04/2016 f1_keywords: ["D9041"] helpviewer_keywords: ["D9041"] -ms.assetid: ada8815f-4246-4e25-b57d-a7f16fa107cc --- # Command-Line Warning D9041 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9043.md b/docs/error-messages/tool-errors/command-line-warning-d9043.md index df407747d65..73931bcab16 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9043.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9043.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9043" title: "Command-Line Warning D9043" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9043" +ms.date: 11/04/2016 f1_keywords: ["D9043"] helpviewer_keywords: ["D9043"] -ms.assetid: 9263e28d-217b-414c-bfb6-86efd3c27a77 --- # Command-Line Warning D9043 From 5a6d620c42b7e28b32850d7f0552778aa3ccc80a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 14 Sep 2025 20:49:14 +0800 Subject: [PATCH 1194/1799] Add blockquotes for error messages in range [R6002, R6035] --- docs/error-messages/tool-errors/c-runtime-error-r6002.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6008.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6009.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6016.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6017.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6018.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6019.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6024.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6025.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6026.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6027.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6028.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6030.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6031.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6032.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6033.md | 2 +- docs/error-messages/tool-errors/c-runtime-error-r6035.md | 2 +- 17 files changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6002.md b/docs/error-messages/tool-errors/c-runtime-error-r6002.md index c6ecb60c462..b412fdfc17f 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6002.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6002.md @@ -8,7 +8,7 @@ ms.assetid: 8fbbe65a-9c43-459e-8342-e1f6d1cef7d0 --- # C Runtime Error R6002 -floating-point support not loaded +> floating-point support not loaded The necessary floating-point library was not linked. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6008.md b/docs/error-messages/tool-errors/c-runtime-error-r6008.md index 16ca16630ab..e0c7ec558e4 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6008.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6008.md @@ -8,7 +8,7 @@ ms.assetid: f0f304fc-709a-4843-bc7e-bad1ae0d1649 --- # C Runtime Error R6008 -not enough space for arguments +> not enough space for arguments > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but often it's caused by an extremely low memory condition, too much memory taken by environment variables, or a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6009.md b/docs/error-messages/tool-errors/c-runtime-error-r6009.md index 9b67d996f5f..563943aae96 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6009.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6009.md @@ -8,7 +8,7 @@ ms.assetid: edfb1f8b-3807-48f4-a994-318923b747ae --- # C Runtime Error R6009 -not enough space for environment +> not enough space for environment > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but often it's caused by an extremely low memory condition, too much memory taken by environment variables, or a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6016.md b/docs/error-messages/tool-errors/c-runtime-error-r6016.md index 245c9bae9df..f06834755b1 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6016.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6016.md @@ -8,7 +8,7 @@ ms.assetid: 7bd3f274-d9c4-4bc4-8252-80bf168c4c3a --- # C Runtime Error R6016 -not enough space for thread data +> not enough space for thread data > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are many possible reasons for this error, but often it's caused by an extremely low memory condition, a bug in the app, or by a bug in an add-in or extension used by the app. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6017.md b/docs/error-messages/tool-errors/c-runtime-error-r6017.md index b6c878e78a5..d3fa3b21c91 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6017.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6017.md @@ -8,7 +8,7 @@ ms.assetid: df3ec5f5-6771-4648-ba06-0e26c6a1cc6a --- # C Runtime Error R6017 -unexpected multithread lock error +> unexpected multithread lock error > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. There are several possible reasons for this error, but often it's caused by a defect in the app's code. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6018.md b/docs/error-messages/tool-errors/c-runtime-error-r6018.md index 97361514101..3423f76fae5 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6018.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6018.md @@ -8,7 +8,7 @@ ms.assetid: f6dd40d1-a119-4d8b-b39e-97350ea23349 --- # C Runtime Error R6018 -unexpected heap error +> unexpected heap error > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. There are several possible reasons for this error, but often it's caused by a defect in the app's code. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6019.md b/docs/error-messages/tool-errors/c-runtime-error-r6019.md index 5c5bd53c170..3896be0b1b1 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6019.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6019.md @@ -8,7 +8,7 @@ ms.assetid: 8129923e-7db2-40ee-9602-def9365f8d28 --- # C Runtime Error R6019 -unable to open console device +> unable to open console device > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it attempted to access the console, but it didn't have sufficient permission. There are several possible reasons for this error, but it's usually because the program must be run as an administrator, or there is a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6024.md b/docs/error-messages/tool-errors/c-runtime-error-r6024.md index 7df58f0607f..2528619186b 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6024.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6024.md @@ -8,7 +8,7 @@ ms.assetid: 0fb11c0f-9b81-4cab-81bd-4785742946a5 --- # C Runtime Error R6024 -not enough space for _onexit/atexit table +> not enough space for _onexit/atexit table > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. This error is usually caused by an extremely low memory condition, or rarely, by a bug in the program or by corruption of the Visual C++ libraries that it uses. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6025.md b/docs/error-messages/tool-errors/c-runtime-error-r6025.md index 42a2c6f4a3a..cf17845f25a 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6025.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6025.md @@ -8,7 +8,7 @@ ms.assetid: afa06d98-9c36-445b-b3e7-b6409bc8e779 --- # C Runtime Error R6025 -pure virtual function call +> pure virtual function call > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. The most common reason for this error is a bug in the app, or a corrupted installation. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6026.md b/docs/error-messages/tool-errors/c-runtime-error-r6026.md index b1074266a4b..799307880b8 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6026.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6026.md @@ -8,7 +8,7 @@ ms.assetid: 7ea751f8-fc20-46ab-99ef-84c95ca0b6b4 --- # C Runtime Error R6026 -not enough space for stdio initialization +> not enough space for stdio initialization > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but usually it's caused by an extremely low memory condition. It can also be caused by a bug in the app, by corruption of the Visual C++ libraries that it uses, or by a driver. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6027.md b/docs/error-messages/tool-errors/c-runtime-error-r6027.md index 69dae0ca617..eb378f6279a 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6027.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6027.md @@ -8,7 +8,7 @@ ms.assetid: c06a62b3-08d9-4bf5-bcad-8340ec552f69 --- # C Runtime Error R6027 -not enough space for lowio initialization +> not enough space for lowio initialization > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but usually it's caused by an extremely low memory condition. It can also be caused by a bug in the app, by corruption of the Visual C++ libraries that it uses, or by a driver. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6028.md b/docs/error-messages/tool-errors/c-runtime-error-r6028.md index 1f93ef783ed..71a8fec4cbf 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6028.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6028.md @@ -8,7 +8,7 @@ ms.assetid: 81e99079-4388-4244-a4f7-4641c508871c --- # C Runtime Error R6028 -unable to initialize heap +> unable to initialize heap > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are many possible reasons for this error, but often it's caused by an extremely low memory condition, a bug in the program, or by defective hardware drivers. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6030.md b/docs/error-messages/tool-errors/c-runtime-error-r6030.md index f190792505a..b3a5443d50f 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6030.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6030.md @@ -8,7 +8,7 @@ ms.assetid: 0238a6c3-a033-4046-8adc-f8f99d961153 --- # C Runtime Error R6030 -CRT not initialized +> CRT not initialized > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. This problem is most often caused by certain security software programs, or rarely, by a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6031.md b/docs/error-messages/tool-errors/c-runtime-error-r6031.md index 94855e80c82..f7af78e8e9a 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6031.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6031.md @@ -8,7 +8,7 @@ ms.assetid: 805d4cd1-cb2f-43fe-87e6-e7bd5b7329c5 --- # C Runtime Error R6031 -Attempt to initialize the CRT more than once. This indicates a bug in your application. +> Attempt to initialize the CRT more than once. This indicates a bug in your application. > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. This may be caused bug in the app, or by a bug in an add-on or extension that the app uses. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6032.md b/docs/error-messages/tool-errors/c-runtime-error-r6032.md index 85bf96da8f0..d2a326cc74c 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6032.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6032.md @@ -8,7 +8,7 @@ ms.assetid: 52092a63-cc51-444a-bfc3-fad965a3558e --- # C Runtime Error R6032 -Not enough space for locale information +> Not enough space for locale information > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but often it's caused by an extremely low memory condition, or by a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6033.md b/docs/error-messages/tool-errors/c-runtime-error-r6033.md index fd113c60325..7463dbaa5e3 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6033.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6033.md @@ -8,7 +8,7 @@ ms.assetid: f9cffdc9-81bd-4a64-a698-02762cbd82c9 --- # C Runtime Error R6033 -Attempt to use MSIL code from this assembly during native code initialization. This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. +> Attempt to use MSIL code from this assembly during native code initialization. This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. This error can be caused by a bug in the app, or by a bug in an add-in or extension that it uses. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6035.md b/docs/error-messages/tool-errors/c-runtime-error-r6035.md index 7fba797b1e2..36d803b50ae 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6035.md @@ -8,7 +8,7 @@ ms.assetid: f8fb50b8-18bf-4258-b96a-b0a9de468d16 --- # C Runtime Error R6035 -Microsoft Visual C++ Runtime Library, Error R6035 - A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. +> Microsoft Visual C++ Runtime Library, Error R6035 - A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. [__security_init_cookie](../../c-runtime-library/reference/security-init-cookie.md) must be called before the first use of the global security cookie. From 28d668f720634e948e59466c0376fb6286577c3b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 14 Sep 2025 20:52:48 +0800 Subject: [PATCH 1195/1799] Add "Remarks" and "Example" headings for error references in range [R6002, R6035] --- docs/error-messages/tool-errors/c-runtime-error-r6002.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6008.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6009.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6016.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6017.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6018.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6019.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6024.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6025.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6026.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6027.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6028.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6030.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6031.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6032.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6033.md | 2 ++ docs/error-messages/tool-errors/c-runtime-error-r6035.md | 4 ++++ 17 files changed, 36 insertions(+) diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6002.md b/docs/error-messages/tool-errors/c-runtime-error-r6002.md index b412fdfc17f..8b21825dec0 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6002.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6002.md @@ -10,6 +10,8 @@ ms.assetid: 8fbbe65a-9c43-459e-8342-e1f6d1cef7d0 > floating-point support not loaded +## Remarks + The necessary floating-point library was not linked. > [!NOTE] diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6008.md b/docs/error-messages/tool-errors/c-runtime-error-r6008.md index e0c7ec558e4..4dc549ffdb8 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6008.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6008.md @@ -10,6 +10,8 @@ ms.assetid: f0f304fc-709a-4843-bc7e-bad1ae0d1649 > not enough space for arguments +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but often it's caused by an extremely low memory condition, too much memory taken by environment variables, or a bug in the program. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6009.md b/docs/error-messages/tool-errors/c-runtime-error-r6009.md index 563943aae96..c506353c267 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6009.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6009.md @@ -10,6 +10,8 @@ ms.assetid: edfb1f8b-3807-48f4-a994-318923b747ae > not enough space for environment +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but often it's caused by an extremely low memory condition, too much memory taken by environment variables, or a bug in the program. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6016.md b/docs/error-messages/tool-errors/c-runtime-error-r6016.md index f06834755b1..e51eda4c951 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6016.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6016.md @@ -10,6 +10,8 @@ ms.assetid: 7bd3f274-d9c4-4bc4-8252-80bf168c4c3a > not enough space for thread data +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are many possible reasons for this error, but often it's caused by an extremely low memory condition, a bug in the app, or by a bug in an add-in or extension used by the app. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6017.md b/docs/error-messages/tool-errors/c-runtime-error-r6017.md index d3fa3b21c91..5828863fad3 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6017.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6017.md @@ -10,6 +10,8 @@ ms.assetid: df3ec5f5-6771-4648-ba06-0e26c6a1cc6a > unexpected multithread lock error +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. There are several possible reasons for this error, but often it's caused by a defect in the app's code. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6018.md b/docs/error-messages/tool-errors/c-runtime-error-r6018.md index 3423f76fae5..b6203ce3083 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6018.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6018.md @@ -10,6 +10,8 @@ ms.assetid: f6dd40d1-a119-4d8b-b39e-97350ea23349 > unexpected heap error +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. There are several possible reasons for this error, but often it's caused by a defect in the app's code. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6019.md b/docs/error-messages/tool-errors/c-runtime-error-r6019.md index 3896be0b1b1..f2bb7953e7d 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6019.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6019.md @@ -10,6 +10,8 @@ ms.assetid: 8129923e-7db2-40ee-9602-def9365f8d28 > unable to open console device +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it attempted to access the console, but it didn't have sufficient permission. There are several possible reasons for this error, but it's usually because the program must be run as an administrator, or there is a bug in the program. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6024.md b/docs/error-messages/tool-errors/c-runtime-error-r6024.md index 2528619186b..7f9334ff89f 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6024.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6024.md @@ -10,6 +10,8 @@ ms.assetid: 0fb11c0f-9b81-4cab-81bd-4785742946a5 > not enough space for _onexit/atexit table +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. This error is usually caused by an extremely low memory condition, or rarely, by a bug in the program or by corruption of the Visual C++ libraries that it uses. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6025.md b/docs/error-messages/tool-errors/c-runtime-error-r6025.md index cf17845f25a..d340ed8041a 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6025.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6025.md @@ -10,6 +10,8 @@ ms.assetid: afa06d98-9c36-445b-b3e7-b6409bc8e779 > pure virtual function call +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. The most common reason for this error is a bug in the app, or a corrupted installation. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6026.md b/docs/error-messages/tool-errors/c-runtime-error-r6026.md index 799307880b8..3f9f67e505e 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6026.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6026.md @@ -10,6 +10,8 @@ ms.assetid: 7ea751f8-fc20-46ab-99ef-84c95ca0b6b4 > not enough space for stdio initialization +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but usually it's caused by an extremely low memory condition. It can also be caused by a bug in the app, by corruption of the Visual C++ libraries that it uses, or by a driver. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6027.md b/docs/error-messages/tool-errors/c-runtime-error-r6027.md index eb378f6279a..62d57f46655 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6027.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6027.md @@ -10,6 +10,8 @@ ms.assetid: c06a62b3-08d9-4bf5-bcad-8340ec552f69 > not enough space for lowio initialization +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but usually it's caused by an extremely low memory condition. It can also be caused by a bug in the app, by corruption of the Visual C++ libraries that it uses, or by a driver. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6028.md b/docs/error-messages/tool-errors/c-runtime-error-r6028.md index 71a8fec4cbf..cfa2d993c66 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6028.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6028.md @@ -10,6 +10,8 @@ ms.assetid: 81e99079-4388-4244-a4f7-4641c508871c > unable to initialize heap +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are many possible reasons for this error, but often it's caused by an extremely low memory condition, a bug in the program, or by defective hardware drivers. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6030.md b/docs/error-messages/tool-errors/c-runtime-error-r6030.md index b3a5443d50f..b07c71f5b57 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6030.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6030.md @@ -10,6 +10,8 @@ ms.assetid: 0238a6c3-a033-4046-8adc-f8f99d961153 > CRT not initialized +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. This problem is most often caused by certain security software programs, or rarely, by a bug in the program. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6031.md b/docs/error-messages/tool-errors/c-runtime-error-r6031.md index f7af78e8e9a..819d8b623fb 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6031.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6031.md @@ -10,6 +10,8 @@ ms.assetid: 805d4cd1-cb2f-43fe-87e6-e7bd5b7329c5 > Attempt to initialize the CRT more than once. This indicates a bug in your application. +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. This may be caused bug in the app, or by a bug in an add-on or extension that the app uses. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6032.md b/docs/error-messages/tool-errors/c-runtime-error-r6032.md index d2a326cc74c..253d07fe610 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6032.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6032.md @@ -10,6 +10,8 @@ ms.assetid: 52092a63-cc51-444a-bfc3-fad965a3558e > Not enough space for locale information +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but often it's caused by an extremely low memory condition, or by a bug in the program. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6033.md b/docs/error-messages/tool-errors/c-runtime-error-r6033.md index 7463dbaa5e3..9ace30a6ef1 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6033.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6033.md @@ -10,6 +10,8 @@ ms.assetid: f9cffdc9-81bd-4a64-a698-02762cbd82c9 > Attempt to use MSIL code from this assembly during native code initialization. This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. +## Remarks + > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. This error can be caused by a bug in the app, or by a bug in an add-in or extension that it uses. > diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6035.md b/docs/error-messages/tool-errors/c-runtime-error-r6035.md index 36d803b50ae..146e097b506 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6035.md @@ -10,12 +10,16 @@ ms.assetid: f8fb50b8-18bf-4258-b96a-b0a9de468d16 > Microsoft Visual C++ Runtime Library, Error R6035 - A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. +## Remarks + [__security_init_cookie](../../c-runtime-library/reference/security-init-cookie.md) must be called before the first use of the global security cookie. The global security cookie is used for buffer overrun protection in code compiled with [/GS (Buffer Security Check)](../../build/reference/gs-buffer-security-check.md) and in code that uses structured exception handling. Essentially, on entry to an overrun-protected function, the cookie is put on the stack, and on exit, the value on the stack is compared against the global cookie. Any difference between them indicates that a buffer overrun has occurred and results in immediate termination of the program. Error R6035 indicates that a call to `__security_init_cookie` was made after a protected function was entered. If execution were to continue, a spurious buffer overrun would be detected because the cookie on the stack would no longer match the global cookie. +## Example + Consider the following DLL example. The DLL entry point is set to DllEntryPoint through the linker [/ENTRY (Entry-Point Symbol)](../../build/reference/entry-entry-point-symbol.md) option. This bypasses the CRT's initialization which would ordinarily initialize the global security cookie, so the DLL itself must call `__security_init_cookie`. ``` From 842ee186a14b1b55eb28e90cd80a97bcc204795c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 14 Sep 2025 20:56:08 +0800 Subject: [PATCH 1196/1799] Update metadata for error references in range [R6002, R6035] --- docs/error-messages/tool-errors/c-runtime-error-r6002.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6008.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6009.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6016.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6017.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6018.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6019.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6024.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6025.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6026.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6027.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6028.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6030.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6031.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6032.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6033.md | 5 ++--- docs/error-messages/tool-errors/c-runtime-error-r6035.md | 5 ++--- 17 files changed, 34 insertions(+), 51 deletions(-) diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6002.md b/docs/error-messages/tool-errors/c-runtime-error-r6002.md index 8b21825dec0..99e8028297a 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6002.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6002" title: "C Runtime Error R6002" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6002" +ms.date: 11/04/2016 f1_keywords: ["R6002"] helpviewer_keywords: ["R6002"] -ms.assetid: 8fbbe65a-9c43-459e-8342-e1f6d1cef7d0 --- # C Runtime Error R6002 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6008.md b/docs/error-messages/tool-errors/c-runtime-error-r6008.md index 4dc549ffdb8..d2cd9fc478a 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6008.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6008.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6008" title: "C Runtime Error R6008" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6008" +ms.date: 11/04/2016 f1_keywords: ["R6008"] helpviewer_keywords: ["R6008"] -ms.assetid: f0f304fc-709a-4843-bc7e-bad1ae0d1649 --- # C Runtime Error R6008 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6009.md b/docs/error-messages/tool-errors/c-runtime-error-r6009.md index c506353c267..e064cc34025 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6009.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6009.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6009" title: "C Runtime Error R6009" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6009" +ms.date: 11/04/2016 f1_keywords: ["R6009"] helpviewer_keywords: ["R6009"] -ms.assetid: edfb1f8b-3807-48f4-a994-318923b747ae --- # C Runtime Error R6009 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6016.md b/docs/error-messages/tool-errors/c-runtime-error-r6016.md index e51eda4c951..2398a1e6028 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6016.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6016.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6016" title: "C Runtime Error R6016" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6016" +ms.date: 11/04/2016 f1_keywords: ["R6016"] helpviewer_keywords: ["R6016"] -ms.assetid: 7bd3f274-d9c4-4bc4-8252-80bf168c4c3a --- # C Runtime Error R6016 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6017.md b/docs/error-messages/tool-errors/c-runtime-error-r6017.md index 5828863fad3..737bf6e90f6 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6017.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6017" title: "C Runtime Error R6017" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6017" +ms.date: 11/04/2016 f1_keywords: ["R6017"] helpviewer_keywords: ["R6017"] -ms.assetid: df3ec5f5-6771-4648-ba06-0e26c6a1cc6a --- # C Runtime Error R6017 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6018.md b/docs/error-messages/tool-errors/c-runtime-error-r6018.md index b6203ce3083..e2010a13a18 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6018.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6018.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6018" title: "C Runtime Error R6018" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6018" +ms.date: 11/04/2016 f1_keywords: ["R6018"] helpviewer_keywords: ["R6018"] -ms.assetid: f6dd40d1-a119-4d8b-b39e-97350ea23349 --- # C Runtime Error R6018 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6019.md b/docs/error-messages/tool-errors/c-runtime-error-r6019.md index f2bb7953e7d..51987fa5a60 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6019.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6019.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6019" title: "C Runtime Error R6019" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6019" +ms.date: 11/04/2016 f1_keywords: ["R6019"] helpviewer_keywords: ["R6019"] -ms.assetid: 8129923e-7db2-40ee-9602-def9365f8d28 --- # C Runtime Error R6019 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6024.md b/docs/error-messages/tool-errors/c-runtime-error-r6024.md index 7f9334ff89f..d9657a8a397 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6024.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6024.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6024" title: "C Runtime Error R6024" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6024" +ms.date: 11/04/2016 f1_keywords: ["R6024"] helpviewer_keywords: ["R6024"] -ms.assetid: 0fb11c0f-9b81-4cab-81bd-4785742946a5 --- # C Runtime Error R6024 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6025.md b/docs/error-messages/tool-errors/c-runtime-error-r6025.md index d340ed8041a..c081ab74720 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6025.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6025.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6025" title: "C Runtime Error R6025" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6025" +ms.date: 11/04/2016 f1_keywords: ["R6025"] helpviewer_keywords: ["R6025"] -ms.assetid: afa06d98-9c36-445b-b3e7-b6409bc8e779 --- # C Runtime Error R6025 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6026.md b/docs/error-messages/tool-errors/c-runtime-error-r6026.md index 3f9f67e505e..f54bf8f33ba 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6026.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6026.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6026" title: "C Runtime Error R6026" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6026" +ms.date: 11/04/2016 f1_keywords: ["R6026"] helpviewer_keywords: ["R6026"] -ms.assetid: 7ea751f8-fc20-46ab-99ef-84c95ca0b6b4 --- # C Runtime Error R6026 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6027.md b/docs/error-messages/tool-errors/c-runtime-error-r6027.md index 62d57f46655..f399ec1a9ad 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6027.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6027.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6027" title: "C Runtime Error R6027" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6027" +ms.date: 11/04/2016 f1_keywords: ["R6027"] helpviewer_keywords: ["R6027"] -ms.assetid: c06a62b3-08d9-4bf5-bcad-8340ec552f69 --- # C Runtime Error R6027 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6028.md b/docs/error-messages/tool-errors/c-runtime-error-r6028.md index cfa2d993c66..cb4c0697bf0 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6028.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6028.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6028" title: "C Runtime Error R6028" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6028" +ms.date: 11/04/2016 f1_keywords: ["R6028"] helpviewer_keywords: ["R6028"] -ms.assetid: 81e99079-4388-4244-a4f7-4641c508871c --- # C Runtime Error R6028 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6030.md b/docs/error-messages/tool-errors/c-runtime-error-r6030.md index b07c71f5b57..ad7dc5bd756 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6030.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6030.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6030" title: "C Runtime Error R6030" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6030" +ms.date: 11/04/2016 f1_keywords: ["R6030"] helpviewer_keywords: ["R6030"] -ms.assetid: 0238a6c3-a033-4046-8adc-f8f99d961153 --- # C Runtime Error R6030 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6031.md b/docs/error-messages/tool-errors/c-runtime-error-r6031.md index 819d8b623fb..2a362dcdfad 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6031.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6031.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6031" title: "C Runtime Error R6031" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6031" +ms.date: 11/04/2016 f1_keywords: ["R6031"] helpviewer_keywords: ["R6031"] -ms.assetid: 805d4cd1-cb2f-43fe-87e6-e7bd5b7329c5 --- # C Runtime Error R6031 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6032.md b/docs/error-messages/tool-errors/c-runtime-error-r6032.md index 253d07fe610..e50b73b5f87 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6032.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6032.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6032" title: "C Runtime Error R6032" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6032" +ms.date: 11/04/2016 f1_keywords: ["R6032"] helpviewer_keywords: ["R6032"] -ms.assetid: 52092a63-cc51-444a-bfc3-fad965a3558e --- # C Runtime Error R6032 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6033.md b/docs/error-messages/tool-errors/c-runtime-error-r6033.md index 9ace30a6ef1..b308f6db468 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6033.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6033.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6033" title: "C Runtime Error R6033" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6033" +ms.date: 11/04/2016 f1_keywords: ["R6033"] helpviewer_keywords: ["R6033"] -ms.assetid: f9cffdc9-81bd-4a64-a698-02762cbd82c9 --- # C Runtime Error R6033 diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6035.md b/docs/error-messages/tool-errors/c-runtime-error-r6035.md index 146e097b506..7ba41e73eab 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6035.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C Runtime Error R6035" title: "C Runtime Error R6035" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6035" +ms.date: 11/04/2016 f1_keywords: ["R6035"] helpviewer_keywords: ["R6035"] -ms.assetid: f8fb50b8-18bf-4258-b96a-b0a9de468d16 --- # C Runtime Error R6035 From 21f004c046ba76daab37e0961b98798eec05c886 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 14 Sep 2025 20:57:44 +0800 Subject: [PATCH 1197/1799] Trim error message in R6035 error reference --- docs/error-messages/tool-errors/c-runtime-error-r6035.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6035.md b/docs/error-messages/tool-errors/c-runtime-error-r6035.md index 7ba41e73eab..4dd704a367b 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6035.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["R6035"] --- # C Runtime Error R6035 -> Microsoft Visual C++ Runtime Library, Error R6035 - A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. +> A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. ## Remarks From 2667a3ba18bc755d4ee081a2a56b920a88ed268a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 14 Sep 2025 21:10:11 +0800 Subject: [PATCH 1198/1799] Add missing R6026 and R6027 in C Runtime errors index topic --- .../tool-errors/c-runtime-errors-r6002-through-r6035.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md index cbac9569743..8eac48f7d14 100644 --- a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md @@ -23,6 +23,8 @@ The C Runtime library (CRT) may report a runtime error when your app is loaded o | [C Runtime Error R6019](c-runtime-error-r6019.md) | unable to open console device | | [C Runtime Error R6024](c-runtime-error-r6024.md) | not enough space for _onexit/atexit table | | [C Runtime Error R6025](c-runtime-error-r6025.md) | pure virtual function call | +| [C Runtime Error R6026](c-runtime-error-r6026.md) | not enough space for stdio initialization | +| [C Runtime Error R6027](c-runtime-error-r6027.md) | not enough space for lowio initialization | | [C Runtime Error R6028](c-runtime-error-r6028.md) | unable to initialize heap | | [C Runtime Error R6030](c-runtime-error-r6030.md) | CRT not initialized | | [C Runtime Error R6031](c-runtime-error-r6031.md) | Attempt to initialize the CRT more than once. This indicates a bug in your application. | From 29400ddaae5239215bfd3491f0e8d562b01652c2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 14 Sep 2025 21:26:40 +0800 Subject: [PATCH 1199/1799] Add blockquotes for error messages in range [RW1004, RW2003] --- .../tool-errors/resource-compiler-error-rw2001.md | 2 +- .../tool-errors/resource-compiler-error-rw2002.md | 2 +- .../tool-errors/resource-compiler-error-rw2003.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rw1004.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rw1009.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rw1016.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rw1022.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rw1023.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rw1025.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rw1030.md | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md index 197696abe86..8d6b30ba3e8 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md @@ -8,7 +8,7 @@ ms.assetid: 963bdc7d-6ebe-4378-8bbc-47dfcf5d330c --- # Resource Compiler Error RW2001 -Invalid directive in preprocessed RC file +> Invalid directive in preprocessed RC file The RC file contains a **#pragma** directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md index c2e99143b32..b129e7a266e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md @@ -8,7 +8,7 @@ ms.assetid: b1d1a49b-b50b-4b0b-9f09-c7762e2dbe8f --- # Resource Compiler Error RW2002 -Parsing error +> Parsing error ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md index 13968d07395..52c26140026 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md @@ -8,7 +8,7 @@ ms.assetid: 9dc0ba70-6776-4aef-b316-5f1711d8e42e --- # Resource Compiler Error RW2003 -Generation Error +> Generation Error ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md index 9c5b2e88282..2549881b64b 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md @@ -8,6 +8,6 @@ ms.assetid: 89cfcb02-a5d3-4271-be4f-df2ec3f94f3e --- # Resource Compiler Fatal Error RW1004 -Unexpected end of file +> Unexpected end of file This error can be caused by missing line feed and carriage-return characters on the last line of a text file. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md index b67063c43d9..9eba47f7701 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md @@ -8,6 +8,6 @@ ms.assetid: c11aceaf-3527-4509-867d-e7b22254e276 --- # Resource Compiler Fatal Error RW1009 -Error creating resource-name +> Error creating resource-name Could not create specified .res file. Make sure it is not being created on a read-only drive. Use /V to find out whether the file is being created. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md index a7267fa6023..91f81cb1933 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md @@ -8,6 +8,6 @@ ms.assetid: 7c93b6b6-3684-4b09-b71d-160c400f75a5 --- # Resource Compiler Fatal Error RW1016 -RC terminating after preprocessor errors +> RC terminating after preprocessor errors The Resource Compiler halted due to other errors. Fix the other errors and recompile. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md index 1831781a0d5..a67767aa9a2 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md @@ -8,7 +8,7 @@ ms.assetid: 6747c8a9-9c9b-4422-b414-0645d22092d0 --- # Resource Compiler Fatal Error RW1022 -**I/O error writing file** +> I/O error writing file The Resource Compiler could not write to a file. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md index 6a5c84c99e7..7e43fea9c59 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md @@ -8,6 +8,6 @@ ms.assetid: 1fe0964a-a8cc-4ffa-a427-dbce39f23173 --- # Resource Compiler Fatal Error RW1023 -I/O error writing file, drive full +> I/O error writing file, drive full Free space must equal at least twice the size of the executable file you are creating. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md index 4e3a45b966d..3890c3fb567 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md @@ -8,7 +8,7 @@ ms.assetid: 561a02af-e7e0-442a-8ad3-a00b2ca1b62e --- # Resource Compiler Fatal Error RW1025 -Out of far heap memory +> Out of far heap memory Check for memory-resident software that might be taking up too much space. Use the CHKDSK program to find out how much memory you have. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md index b737df8c45d..43a0b97f782 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md @@ -8,6 +8,6 @@ ms.assetid: 10727997-9ded-4afc-93b3-58fb435c3da8 --- # Resource Compiler Fatal Error RW1030 -Output Error +> Output Error This error can be caused if the Resource Compiler was not able to create the destination file. Make sure that there is enough disk space and that you have write permission on the volume. From 9947d9cd078a4dcb8be4e087aadf353236fc5f1c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 14 Sep 2025 21:29:30 +0800 Subject: [PATCH 1200/1799] Add "Remarks" headings for error references in range [RW1004, RW2003] --- .../tool-errors/resource-compiler-error-rw2001.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rw1004.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rw1009.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rw1016.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rw1022.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rw1023.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rw1025.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rw1030.md | 2 ++ 8 files changed, 16 insertions(+) diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md index 8d6b30ba3e8..bb164dd72b5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md @@ -10,6 +10,8 @@ ms.assetid: 963bdc7d-6ebe-4378-8bbc-47dfcf5d330c > Invalid directive in preprocessed RC file +## Remarks + The RC file contains a **#pragma** directive. Use the **#ifndef** preprocessor directive with the **RC_INVOKED** constant that the Resource Compiler defines when it processes an include file. Place the **#pragma** directive inside a block of code that is not processed when the **RC_INVOKED** constant is defined. Code in the block is processed only by the C/C++ compiler and not by the Resource Compiler. The following sample code demonstrates this technique: diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md index 2549881b64b..b6176580e8d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md @@ -10,4 +10,6 @@ ms.assetid: 89cfcb02-a5d3-4271-be4f-df2ec3f94f3e > Unexpected end of file +## Remarks + This error can be caused by missing line feed and carriage-return characters on the last line of a text file. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md index 9eba47f7701..bce51133b10 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md @@ -10,4 +10,6 @@ ms.assetid: c11aceaf-3527-4509-867d-e7b22254e276 > Error creating resource-name +## Remarks + Could not create specified .res file. Make sure it is not being created on a read-only drive. Use /V to find out whether the file is being created. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md index 91f81cb1933..fdfd84f572f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md @@ -10,4 +10,6 @@ ms.assetid: 7c93b6b6-3684-4b09-b71d-160c400f75a5 > RC terminating after preprocessor errors +## Remarks + The Resource Compiler halted due to other errors. Fix the other errors and recompile. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md index a67767aa9a2..f543436d203 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md @@ -10,6 +10,8 @@ ms.assetid: 6747c8a9-9c9b-4422-b414-0645d22092d0 > I/O error writing file +## Remarks + The Resource Compiler could not write to a file. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md index 7e43fea9c59..5548b0d4d6e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md @@ -10,4 +10,6 @@ ms.assetid: 1fe0964a-a8cc-4ffa-a427-dbce39f23173 > I/O error writing file, drive full +## Remarks + Free space must equal at least twice the size of the executable file you are creating. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md index 3890c3fb567..feab4d74eb1 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md @@ -10,6 +10,8 @@ ms.assetid: 561a02af-e7e0-442a-8ad3-a00b2ca1b62e > Out of far heap memory +## Remarks + Check for memory-resident software that might be taking up too much space. Use the CHKDSK program to find out how much memory you have. If you are creating a large resource file, split the resource script into two files. After creating two .res files, use the MS-DOS command line to join them together: diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md index 43a0b97f782..be393b0a414 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md @@ -10,4 +10,6 @@ ms.assetid: 10727997-9ded-4afc-93b3-58fb435c3da8 > Output Error +## Remarks + This error can be caused if the Resource Compiler was not able to create the destination file. Make sure that there is enough disk space and that you have write permission on the volume. From dc1bda36f845269d8be2481433f82200dc0aa59e Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 14 Sep 2025 21:34:05 +0800 Subject: [PATCH 1201/1799] Update metadata for error references in range [RW1004, RW2003] --- .../tool-errors/resource-compiler-error-rw2001.md | 5 ++--- .../tool-errors/resource-compiler-error-rw2002.md | 5 ++--- .../tool-errors/resource-compiler-error-rw2003.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rw1004.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rw1009.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rw1016.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rw1022.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rw1023.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rw1025.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rw1030.md | 5 ++--- 10 files changed, 20 insertions(+), 30 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md index bb164dd72b5..c4ae99cc7aa 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RW2001" title: "Resource Compiler Error RW2001" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RW2001" +ms.date: 11/04/2016 f1_keywords: ["RW2001"] helpviewer_keywords: ["RW2001"] -ms.assetid: 963bdc7d-6ebe-4378-8bbc-47dfcf5d330c --- # Resource Compiler Error RW2001 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md index b129e7a266e..f840e80f4ea 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RW2002" title: "Resource Compiler Error RW2002" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RW2002" +ms.date: 11/04/2016 f1_keywords: ["RW2002"] helpviewer_keywords: ["RW2002"] -ms.assetid: b1d1a49b-b50b-4b0b-9f09-c7762e2dbe8f --- # Resource Compiler Error RW2002 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md index 52c26140026..22346f8261c 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RW2003" title: "Resource Compiler Error RW2003" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RW2003" +ms.date: 11/04/2016 f1_keywords: ["RW2003"] helpviewer_keywords: ["RW2003"] -ms.assetid: 9dc0ba70-6776-4aef-b316-5f1711d8e42e --- # Resource Compiler Error RW2003 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md index b6176580e8d..be2236c6d44 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1004" title: "Resource Compiler Fatal Error RW1004" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1004" +ms.date: 11/04/2016 f1_keywords: ["RW1004"] helpviewer_keywords: ["RW1004"] -ms.assetid: 89cfcb02-a5d3-4271-be4f-df2ec3f94f3e --- # Resource Compiler Fatal Error RW1004 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md index bce51133b10..c3865536102 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1009" title: "Resource Compiler Fatal Error RW1009" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1009" +ms.date: 11/04/2016 f1_keywords: ["RW1009"] helpviewer_keywords: ["RW1009"] -ms.assetid: c11aceaf-3527-4509-867d-e7b22254e276 --- # Resource Compiler Fatal Error RW1009 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md index fdfd84f572f..1475a9c5de5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1016" title: "Resource Compiler Fatal Error RW1016" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1016" +ms.date: 11/04/2016 f1_keywords: ["RW1016"] helpviewer_keywords: ["RW1016"] -ms.assetid: 7c93b6b6-3684-4b09-b71d-160c400f75a5 --- # Resource Compiler Fatal Error RW1016 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md index f543436d203..c30a6760206 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1022" title: "Resource Compiler Fatal Error RW1022" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1022" +ms.date: 11/04/2016 f1_keywords: ["RW1022"] helpviewer_keywords: ["RW1022"] -ms.assetid: 6747c8a9-9c9b-4422-b414-0645d22092d0 --- # Resource Compiler Fatal Error RW1022 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md index 5548b0d4d6e..1d72a674995 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1023" title: "Resource Compiler Fatal Error RW1023" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1023" +ms.date: 11/04/2016 f1_keywords: ["RW1023"] helpviewer_keywords: ["RW1023"] -ms.assetid: 1fe0964a-a8cc-4ffa-a427-dbce39f23173 --- # Resource Compiler Fatal Error RW1023 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md index feab4d74eb1..036bafa0f34 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1025" title: "Resource Compiler Fatal Error RW1025" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1025" +ms.date: 11/04/2016 f1_keywords: ["RW1025"] helpviewer_keywords: ["RW1025"] -ms.assetid: 561a02af-e7e0-442a-8ad3-a00b2ca1b62e --- # Resource Compiler Fatal Error RW1025 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md index be393b0a414..35842f821ab 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1030" title: "Resource Compiler Fatal Error RW1030" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1030" +ms.date: 11/04/2016 f1_keywords: ["RW1030"] helpviewer_keywords: ["RW1030"] -ms.assetid: 10727997-9ded-4afc-93b3-58fb435c3da8 --- # Resource Compiler Fatal Error RW1030 From 60aeb126f40d7c63c73128c07358ab302af8320c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 15 Sep 2025 23:26:16 +0800 Subject: [PATCH 1202/1799] Add blockquotes for error messages in range [RC1002, RC1208] --- .../tool-errors/resource-compiler-fatal-error-rc1002.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1004.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1009.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1011.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1015.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1017.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1018.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1019.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1020.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1021.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1022.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1047.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1052.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1067.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1102.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1105.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1109.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1116.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1120.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1121.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1203.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1205.md | 2 +- .../tool-errors/resource-compiler-fatal-error-rc1208.md | 2 +- 23 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md index fbff190aed7..3d045dc2827 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md @@ -8,7 +8,7 @@ ms.assetid: b43dfece-0dc3-4d0b-9d8f-509699b9ae80 --- # Resource Compiler Fatal Error RC1002 -out of heap space +> out of heap space ### To fix by using the following possible solutions diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md index 22db02bbda8..06594310e94 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md @@ -8,6 +8,6 @@ ms.assetid: f9b703d4-6767-4721-9450-37079bcc7152 --- # Resource Compiler Fatal Error RC1004 -unexpected end of file found +> unexpected end of file found This error can be caused by missing line feed and carriage return characters on the last line of a text file. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md index 2f39079e129..8ca37af2efd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md @@ -8,6 +8,6 @@ ms.assetid: c377a068-bcc3-4ec4-b725-eb6927e10128 --- # Resource Compiler Fatal Error RC1009 -compiler limit : macros too deeply nested 'macro' +> compiler limit : macros too deeply nested 'macro' The file exceeds the Resource Compiler limit for macro nesting. Revise the specified source file to decrease the nesting depth of its macros. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md index b734e138b82..6abbf5b97ab 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md @@ -8,6 +8,6 @@ ms.assetid: ae0b89ec-0a31-4f8e-b9d0-f974152c185e --- # Resource Compiler Fatal Error RC1011 -compiler limit : 'identifier' : macro definition too big +> compiler limit : 'identifier' : macro definition too big Try to split the definition into shorter definitions. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md index b7031ac9c68..550820dfe4a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md @@ -8,7 +8,7 @@ ms.assetid: 23f187e1-5538-40b5-9042-edd2888f55c2 --- # Resource Compiler Fatal Error RC1015 -cannot open include file 'filename' +> cannot open include file 'filename' The given include file does not exist, could not be opened, or was not found. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md index d27bdb374da..ab3f37bb22a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md @@ -8,6 +8,6 @@ ms.assetid: 62ac1356-4481-49a0-8873-36daf42ffdcd --- # Resource Compiler Fatal Error RC1017 -invalid integer constant expression +> invalid integer constant expression The expression in an `#if` directive either did not exist or does not evaluate to a constant. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md index 0917185e27d..f6a466ff323 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md @@ -8,7 +8,7 @@ ms.assetid: bb1d2efd-6898-412f-bb03-9ff94c54e4dc --- # Resource Compiler Fatal Error RC1018 -unexpected '#elif' +> unexpected '#elif' The `#elif` directive did not appear within an `#if`, **#ifdef**, or **#ifndef** construct. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md index b6056dd12f1..5c392fc4190 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md @@ -8,7 +8,7 @@ ms.assetid: 432fff44-04a9-4e13-91c6-870df6f0b4e4 --- # Resource Compiler Fatal Error RC1019 -unexpected '#else' +> unexpected '#else' The `#else` directive did not appear within an `#if`, **#ifdef**, or **#ifndef** construct. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md index bc34220daff..b444a89b50c 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md @@ -8,7 +8,7 @@ ms.assetid: 3e073ebf-9136-4bf8-ac6a-3c642ed64594 --- # Resource Compiler Fatal Error RC1020 -unexpected '#endif' +> unexpected '#endif' An `#endif` directive appeared without a matching `#if`, **#ifdef**, or **#ifndef** directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md index 1a2f34d860e..67b31864a49 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md @@ -8,7 +8,7 @@ ms.assetid: 9bc8858c-aa50-4b94-b60e-daf75ab45d77 --- # Resource Compiler Fatal Error RC1021 -invalid preprocessor command 'string' +> invalid preprocessor command 'string' The characters following the number sign (**#**) did not form a valid preprocessor directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md index dc3ef2c2b15..2c297f4fcae 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md @@ -8,7 +8,7 @@ ms.assetid: 30a0f3c7-08a8-4c40-b0de-46ee5feb789d --- # Resource Compiler Fatal Error RC1022 -expected '#endif' +> expected '#endif' An `#if`, **#ifdef**, or **#ifndef** directive was not terminated with an `#endif` directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md index 08e433d25b4..4588843a8a6 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md @@ -8,6 +8,6 @@ ms.assetid: cd794a87-2634-4d25-9fd3-8c934e3c4d1e --- # Resource Compiler Fatal Error RC1047 -"too many option options, 'string'" +> "too many option options, 'string'" The given option was specified too many times. The given string is the argument to the option that caused the error. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md index c537dcb4165..489eb0b52e4 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md @@ -8,7 +8,7 @@ ms.assetid: 59803673-492b-44fa-80fa-df93b8aaf9fb --- # Resource Compiler Fatal Error RC1052 -compiler limit : #if or #ifdef blocks nested too deeply +> compiler limit : #if or #ifdef blocks nested too deeply The program exceeded the maximum allowable nesting levels for `#if` and `#ifdef` directives. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md index 56528097fbf..271a552c37d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md @@ -8,6 +8,6 @@ ms.assetid: 6b23677d-428d-47c6-9207-8b85f7718e03 --- # Resource Compiler Fatal Error RC1067 -compiler limit : identifier overflowed internal buffer +> compiler limit : identifier overflowed internal buffer An internal compiler limit was exceeded. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md index ff54132abfa..16df41d0010 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md @@ -8,6 +8,6 @@ ms.assetid: bd2091f8-ef5e-4151-a8d6-98043e9422b6 --- # Resource Compiler Fatal Error RC1102 -internal error : too many arguments to RCPP +> internal error : too many arguments to RCPP Too many arguments were passed to the Resource Compiler preprocessor. Reduce the number of symbols defined with the Define Symbols (/d) option by defining them in your source. This error can also be caused by specifying too many include file search paths using the Include Search Path option (/i). diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md index 1bdddf86718..7d4d31cc215 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md @@ -8,6 +8,6 @@ ms.assetid: 80ce18e7-44ee-4844-bede-321fe0844d56 --- # Resource Compiler Fatal Error RC1105 -invalid switch, option: too many /d switches +> invalid switch, option: too many /d switches Too many symbols were defined using the Define Symbols (/d) option. Define some symbols in your source and recompile. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md index 37e4d29ac92..f6f4be10592 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md @@ -8,6 +8,6 @@ ms.assetid: 2d3ec1c9-86fd-4d53-aa52-840c310b8328 --- # Resource Compiler Fatal Error RC1109 -error creating resource-name +> error creating resource-name Could not create specified .res file. Make sure it is not being created on a read-only drive. Use the /V option to find out whether the file is being created. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md index a2799212719..59444297f7e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md @@ -8,6 +8,6 @@ ms.assetid: 1eacc5c3-d946-4615-83e4-1b8ebd472139 --- # Resource Compiler Fatal Error RC1116 -RC terminating after preprocessor errors +> RC terminating after preprocessor errors The Resource Compiler halted due to other errors. Fix the other errors and recompile. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md index 383bf936aee..3a34d56b0cc 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md @@ -8,7 +8,7 @@ ms.assetid: 4e462931-e42e-42e3-8bfc-847677194286 --- # Resource Compiler Fatal Error RC1120 -out of memory, needed number bytes +> out of memory, needed number bytes The Resource Compiler ran out of storage for items that it stores in its heap. Usually this is the result of having too many symbols. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md index e8530fad72c..961d4d97e6d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md @@ -8,6 +8,6 @@ ms.assetid: 19ed8c71-d63a-4ff4-8652-a3ef52318a55 --- # Resource Compiler Fatal Error RC1121 -I/O error reading file +> I/O error reading file The Resource Compiler was not able to read a file. Check that the drive containing the file is available and that the file is valid. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md index 963dc534d54..156a1d7ccd8 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md @@ -8,6 +8,6 @@ ms.assetid: 60d08fb1-6a51-407c-854e-9a68080cfe2d --- # Resource Compiler Fatal Error RC1203 -invalid hexadecimal default language ID specified. +> invalid hexadecimal default language ID specified. The Specify Default Language (/l) option was followed by an invalid hexadecimal language ID. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for a list of valid language IDs. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md index abdce3697b0..a31245cbf14 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md @@ -8,6 +8,6 @@ ms.assetid: 6cfbe019-ad8a-4267-b4b9-0d675bb3819a --- # Resource Compiler Fatal Error RC1205 -invalid code page +> invalid code page The Specify Code Page (/c) option was followed by an invalid code page. See [Code Pages](../../c-runtime-library/code-pages.md) in the *Run-Time Library Reference* for more information. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md index 1ceb943027e..53bf726d2ac 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md @@ -8,6 +8,6 @@ ms.assetid: 7dacc4ec-3ebd-49b3-ba4c-1a2982bac720 --- # Resource Compiler Fatal Error RC1208 -input file has .RES extension +> input file has .RES extension The .RES extension is used for Resource Compiler output. The .RC extension should be used for Resource Compiler scripts. From 98c80402da7ba93575bebee7c1f66231e7d7db0b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 15 Sep 2025 23:28:55 +0800 Subject: [PATCH 1203/1799] Add "Remarks" headings for error references in range [RC1002, RC1208] --- .../tool-errors/resource-compiler-fatal-error-rc1004.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1009.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1011.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1015.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1017.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1018.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1019.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1020.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1021.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1022.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1047.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1052.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1067.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1101.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1102.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1105.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1109.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1116.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1120.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1121.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1203.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1205.md | 2 ++ .../tool-errors/resource-compiler-fatal-error-rc1208.md | 2 ++ 23 files changed, 46 insertions(+) diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md index 06594310e94..b50184d65c6 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md @@ -10,4 +10,6 @@ ms.assetid: f9b703d4-6767-4721-9450-37079bcc7152 > unexpected end of file found +## Remarks + This error can be caused by missing line feed and carriage return characters on the last line of a text file. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md index 8ca37af2efd..15a813b4f2c 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md @@ -10,4 +10,6 @@ ms.assetid: c377a068-bcc3-4ec4-b725-eb6927e10128 > compiler limit : macros too deeply nested 'macro' +## Remarks + The file exceeds the Resource Compiler limit for macro nesting. Revise the specified source file to decrease the nesting depth of its macros. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md index 6abbf5b97ab..abf231dc8b1 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md @@ -10,4 +10,6 @@ ms.assetid: ae0b89ec-0a31-4f8e-b9d0-f974152c185e > compiler limit : 'identifier' : macro definition too big +## Remarks + Try to split the definition into shorter definitions. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md index 550820dfe4a..444ac9dfc0f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md @@ -10,6 +10,8 @@ ms.assetid: 23f187e1-5538-40b5-9042-edd2888f55c2 > cannot open include file 'filename' +## Remarks + The given include file does not exist, could not be opened, or was not found. Make sure that the environment settings are valid and that the correct path for the file is specified. Ensure that sufficient file handles are available to the Resource Compiler. If the file is on a network drive, make sure that you have permissions to open the file. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md index ab3f37bb22a..f23905beb01 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md @@ -10,4 +10,6 @@ ms.assetid: 62ac1356-4481-49a0-8873-36daf42ffdcd > invalid integer constant expression +## Remarks + The expression in an `#if` directive either did not exist or does not evaluate to a constant. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md index f6a466ff323..22cd9d010c9 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md @@ -10,6 +10,8 @@ ms.assetid: bb1d2efd-6898-412f-bb03-9ff94c54e4dc > unexpected '#elif' +## Remarks + The `#elif` directive did not appear within an `#if`, **#ifdef**, or **#ifndef** construct. Make sure that there is an `#if`, **#ifdef**, or **#ifndef** statement in effect before this statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md index 5c392fc4190..bade3a6bea7 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md @@ -10,6 +10,8 @@ ms.assetid: 432fff44-04a9-4e13-91c6-870df6f0b4e4 > unexpected '#else' +## Remarks + The `#else` directive did not appear within an `#if`, **#ifdef**, or **#ifndef** construct. Make sure that there is an `#if`, **#ifdef**, or **#ifndef** statement in effect before this statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md index b444a89b50c..69c83089073 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md @@ -10,6 +10,8 @@ ms.assetid: 3e073ebf-9136-4bf8-ac6a-3c642ed64594 > unexpected '#endif' +## Remarks + An `#endif` directive appeared without a matching `#if`, **#ifdef**, or **#ifndef** directive. Make sure that there is a matching `#endif` for each `#if`, **#ifdef**, and **#ifndef** statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md index 67b31864a49..7835a489e3e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md @@ -10,6 +10,8 @@ ms.assetid: 9bc8858c-aa50-4b94-b60e-daf75ab45d77 > invalid preprocessor command 'string' +## Remarks + The characters following the number sign (**#**) did not form a valid preprocessor directive. The number sign cannot be used as the first character in an identifier. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md index 2c297f4fcae..42a1ecd4aa3 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md @@ -10,6 +10,8 @@ ms.assetid: 30a0f3c7-08a8-4c40-b0de-46ee5feb789d > expected '#endif' +## Remarks + An `#if`, **#ifdef**, or **#ifndef** directive was not terminated with an `#endif` directive. Make sure that there is an `#if`, **#ifdef**, or **#ifndef** statement in effect before this statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md index 4588843a8a6..50527be0f8d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md @@ -10,4 +10,6 @@ ms.assetid: cd794a87-2634-4d25-9fd3-8c934e3c4d1e > "too many option options, 'string'" +## Remarks + The given option was specified too many times. The given string is the argument to the option that caused the error. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md index 489eb0b52e4..8f45b429a50 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md @@ -10,6 +10,8 @@ ms.assetid: 59803673-492b-44fa-80fa-df93b8aaf9fb > compiler limit : #if or #ifdef blocks nested too deeply +## Remarks + The program exceeded the maximum allowable nesting levels for `#if` and `#ifdef` directives. This error can be caused by include files that use these preprocessor directives. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md index 271a552c37d..deee3f379b3 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md @@ -10,4 +10,6 @@ ms.assetid: 6b23677d-428d-47c6-9207-8b85f7718e03 > compiler limit : identifier overflowed internal buffer +## Remarks + An internal compiler limit was exceeded. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md index df4bef463ad..bb2141703ff 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md @@ -10,6 +10,8 @@ ms.assetid: ff273384-b819-464a-8c0e-d5951e4a28b4 > no resource binary filename specified +## Remarks + The Rename Output (/fo) option was not followed by a filename. Use the following syntax for the /fo option: diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md index 16df41d0010..42301f8d21e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md @@ -10,4 +10,6 @@ ms.assetid: bd2091f8-ef5e-4151-a8d6-98043e9422b6 > internal error : too many arguments to RCPP +## Remarks + Too many arguments were passed to the Resource Compiler preprocessor. Reduce the number of symbols defined with the Define Symbols (/d) option by defining them in your source. This error can also be caused by specifying too many include file search paths using the Include Search Path option (/i). diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md index 7d4d31cc215..c4733e28ab7 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md @@ -10,4 +10,6 @@ ms.assetid: 80ce18e7-44ee-4844-bede-321fe0844d56 > invalid switch, option: too many /d switches +## Remarks + Too many symbols were defined using the Define Symbols (/d) option. Define some symbols in your source and recompile. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md index f6f4be10592..3a4d869b2ba 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md @@ -10,4 +10,6 @@ ms.assetid: 2d3ec1c9-86fd-4d53-aa52-840c310b8328 > error creating resource-name +## Remarks + Could not create specified .res file. Make sure it is not being created on a read-only drive. Use the /V option to find out whether the file is being created. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md index 59444297f7e..1f39f6b23e0 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md @@ -10,4 +10,6 @@ ms.assetid: 1eacc5c3-d946-4615-83e4-1b8ebd472139 > RC terminating after preprocessor errors +## Remarks + The Resource Compiler halted due to other errors. Fix the other errors and recompile. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md index 3a34d56b0cc..1e8df7b33c8 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md @@ -10,6 +10,8 @@ ms.assetid: 4e462931-e42e-42e3-8bfc-847677194286 > out of memory, needed number bytes +## Remarks + The Resource Compiler ran out of storage for items that it stores in its heap. Usually this is the result of having too many symbols. ### To fix by using the following possible solutions diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md index 961d4d97e6d..bb55dfa220e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md @@ -10,4 +10,6 @@ ms.assetid: 19ed8c71-d63a-4ff4-8652-a3ef52318a55 > I/O error reading file +## Remarks + The Resource Compiler was not able to read a file. Check that the drive containing the file is available and that the file is valid. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md index 156a1d7ccd8..1798bbe8161 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md @@ -10,4 +10,6 @@ ms.assetid: 60d08fb1-6a51-407c-854e-9a68080cfe2d > invalid hexadecimal default language ID specified. +## Remarks + The Specify Default Language (/l) option was followed by an invalid hexadecimal language ID. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for a list of valid language IDs. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md index a31245cbf14..a36c83307f0 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md @@ -10,4 +10,6 @@ ms.assetid: 6cfbe019-ad8a-4267-b4b9-0d675bb3819a > invalid code page +## Remarks + The Specify Code Page (/c) option was followed by an invalid code page. See [Code Pages](../../c-runtime-library/code-pages.md) in the *Run-Time Library Reference* for more information. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md index 53bf726d2ac..47c88f3ad85 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md @@ -10,4 +10,6 @@ ms.assetid: 7dacc4ec-3ebd-49b3-ba4c-1a2982bac720 > input file has .RES extension +## Remarks + The .RES extension is used for Resource Compiler output. The .RC extension should be used for Resource Compiler scripts. From dfa547f589161aba5ac6890d9b1d30a586542cd3 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 15 Sep 2025 23:33:05 +0800 Subject: [PATCH 1204/1799] Update metadata for error references in range [RC1002, RC1208] --- .../tool-errors/resource-compiler-fatal-error-rc1002.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1004.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1009.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1011.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1015.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1017.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1018.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1019.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1020.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1021.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1022.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1047.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1052.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1067.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1101.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1102.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1105.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1109.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1116.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1120.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1121.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1203.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1205.md | 5 ++--- .../tool-errors/resource-compiler-fatal-error-rc1208.md | 5 ++--- 24 files changed, 48 insertions(+), 72 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md index 3d045dc2827..7c7a2f888cc 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1002" title: "Resource Compiler Fatal Error RC1002" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1002" +ms.date: 11/04/2016 f1_keywords: ["RC1002"] helpviewer_keywords: ["RC1002"] -ms.assetid: b43dfece-0dc3-4d0b-9d8f-509699b9ae80 --- # Resource Compiler Fatal Error RC1002 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md index b50184d65c6..ad47b438b10 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1004" title: "Resource Compiler Fatal Error RC1004" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1004" +ms.date: 11/04/2016 f1_keywords: ["RC1004"] helpviewer_keywords: ["RC1004"] -ms.assetid: f9b703d4-6767-4721-9450-37079bcc7152 --- # Resource Compiler Fatal Error RC1004 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md index 15a813b4f2c..edebbfee426 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1009" title: "Resource Compiler Fatal Error RC1009" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1009" +ms.date: 11/04/2016 f1_keywords: ["RC1009"] helpviewer_keywords: ["RC1009"] -ms.assetid: c377a068-bcc3-4ec4-b725-eb6927e10128 --- # Resource Compiler Fatal Error RC1009 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md index abf231dc8b1..bcfe253dd25 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1011" title: "Resource Compiler Fatal Error RC1011" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1011" +ms.date: 11/04/2016 f1_keywords: ["RC1011"] helpviewer_keywords: ["RC1011"] -ms.assetid: ae0b89ec-0a31-4f8e-b9d0-f974152c185e --- # Resource Compiler Fatal Error RC1011 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md index 444ac9dfc0f..71057ea62f5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1015" title: "Resource Compiler Fatal Error RC1015" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1015" +ms.date: 11/04/2016 f1_keywords: ["RC1015"] helpviewer_keywords: ["RC1015"] -ms.assetid: 23f187e1-5538-40b5-9042-edd2888f55c2 --- # Resource Compiler Fatal Error RC1015 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md index f23905beb01..361883e2bc9 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1017" title: "Resource Compiler Fatal Error RC1017" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1017" +ms.date: 11/04/2016 f1_keywords: ["RC1017"] helpviewer_keywords: ["RC1017"] -ms.assetid: 62ac1356-4481-49a0-8873-36daf42ffdcd --- # Resource Compiler Fatal Error RC1017 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md index 22cd9d010c9..1f3808ee3ee 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1018" title: "Resource Compiler Fatal Error RC1018" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1018" +ms.date: 11/04/2016 f1_keywords: ["RC1018"] helpviewer_keywords: ["RC1018"] -ms.assetid: bb1d2efd-6898-412f-bb03-9ff94c54e4dc --- # Resource Compiler Fatal Error RC1018 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md index bade3a6bea7..2ce46126549 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1019" title: "Resource Compiler Fatal Error RC1019" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1019" +ms.date: 11/04/2016 f1_keywords: ["RC1019"] helpviewer_keywords: ["RC1019"] -ms.assetid: 432fff44-04a9-4e13-91c6-870df6f0b4e4 --- # Resource Compiler Fatal Error RC1019 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md index 69c83089073..5454a1ef52e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1020" title: "Resource Compiler Fatal Error RC1020" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1020" +ms.date: 11/04/2016 f1_keywords: ["RC1020"] helpviewer_keywords: ["RC1020"] -ms.assetid: 3e073ebf-9136-4bf8-ac6a-3c642ed64594 --- # Resource Compiler Fatal Error RC1020 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md index 7835a489e3e..ccaa3ab1152 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1021" title: "Resource Compiler Fatal Error RC1021" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1021" +ms.date: 11/04/2016 f1_keywords: ["RC1021"] helpviewer_keywords: ["RC1021"] -ms.assetid: 9bc8858c-aa50-4b94-b60e-daf75ab45d77 --- # Resource Compiler Fatal Error RC1021 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md index 42a1ecd4aa3..b85384b0a86 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1022" title: "Resource Compiler Fatal Error RC1022" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1022" +ms.date: 11/04/2016 f1_keywords: ["RC1022"] helpviewer_keywords: ["RC1022"] -ms.assetid: 30a0f3c7-08a8-4c40-b0de-46ee5feb789d --- # Resource Compiler Fatal Error RC1022 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md index 50527be0f8d..a3b544b8fb5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1047" title: "Resource Compiler Fatal Error RC1047" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1047" +ms.date: 11/04/2016 f1_keywords: ["RC1047"] helpviewer_keywords: ["RC1047"] -ms.assetid: cd794a87-2634-4d25-9fd3-8c934e3c4d1e --- # Resource Compiler Fatal Error RC1047 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md index 8f45b429a50..ddda49f8d46 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1052" title: "Resource Compiler Fatal Error RC1052" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1052" +ms.date: 11/04/2016 f1_keywords: ["RC1052"] helpviewer_keywords: ["RC1052"] -ms.assetid: 59803673-492b-44fa-80fa-df93b8aaf9fb --- # Resource Compiler Fatal Error RC1052 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md index deee3f379b3..a8a87351368 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1067" title: "Resource Compiler Fatal Error RC1067" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1067" +ms.date: 11/04/2016 f1_keywords: ["RC1067"] helpviewer_keywords: ["RC1067"] -ms.assetid: 6b23677d-428d-47c6-9207-8b85f7718e03 --- # Resource Compiler Fatal Error RC1067 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md index bb2141703ff..889f6601ddd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1101" title: "Resource Compiler Fatal Error RC1101" -ms.date: "08/27/2018" +description: "Learn more about: Resource Compiler Fatal Error RC1101" +ms.date: 08/27/2018 f1_keywords: ["RC1101"] helpviewer_keywords: ["RC1101"] -ms.assetid: ff273384-b819-464a-8c0e-d5951e4a28b4 --- # Resource Compiler Fatal Error RC1101 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md index 42301f8d21e..9074d14d03f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1102" title: "Resource Compiler Fatal Error RC1102" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1102" +ms.date: 11/04/2016 f1_keywords: ["RC1102"] helpviewer_keywords: ["RC1102"] -ms.assetid: bd2091f8-ef5e-4151-a8d6-98043e9422b6 --- # Resource Compiler Fatal Error RC1102 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md index c4733e28ab7..0e0c81d1668 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1105" title: "Resource Compiler Fatal Error RC1105" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1105" +ms.date: 11/04/2016 f1_keywords: ["RC1105"] helpviewer_keywords: ["RC1105"] -ms.assetid: 80ce18e7-44ee-4844-bede-321fe0844d56 --- # Resource Compiler Fatal Error RC1105 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md index 3a4d869b2ba..0e23c8176dd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1109" title: "Resource Compiler Fatal Error RC1109" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1109" +ms.date: 11/04/2016 f1_keywords: ["RC1109"] helpviewer_keywords: ["RC1109"] -ms.assetid: 2d3ec1c9-86fd-4d53-aa52-840c310b8328 --- # Resource Compiler Fatal Error RC1109 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md index 1f39f6b23e0..50acf9d9525 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1116" title: "Resource Compiler Fatal Error RC1116" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1116" +ms.date: 11/04/2016 f1_keywords: ["RC1116"] helpviewer_keywords: ["RC1116"] -ms.assetid: 1eacc5c3-d946-4615-83e4-1b8ebd472139 --- # Resource Compiler Fatal Error RC1116 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md index 1e8df7b33c8..cda7bd1fa63 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1120" title: "Resource Compiler Fatal Error RC1120" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1120" +ms.date: 11/04/2016 f1_keywords: ["RC1120"] helpviewer_keywords: ["RC1120"] -ms.assetid: 4e462931-e42e-42e3-8bfc-847677194286 --- # Resource Compiler Fatal Error RC1120 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md index bb55dfa220e..c9fc4d8f16a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1121" title: "Resource Compiler Fatal Error RC1121" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1121" +ms.date: 11/04/2016 f1_keywords: ["RC1121"] helpviewer_keywords: ["RC1121"] -ms.assetid: 19ed8c71-d63a-4ff4-8652-a3ef52318a55 --- # Resource Compiler Fatal Error RC1121 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md index 1798bbe8161..405a2606b77 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1203" title: "Resource Compiler Fatal Error RC1203" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1203" +ms.date: 11/04/2016 f1_keywords: ["RC1203"] helpviewer_keywords: ["RC1203"] -ms.assetid: 60d08fb1-6a51-407c-854e-9a68080cfe2d --- # Resource Compiler Fatal Error RC1203 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md index a36c83307f0..445ae2739e7 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1205" title: "Resource Compiler Fatal Error RC1205" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1205" +ms.date: 11/04/2016 f1_keywords: ["RC1205"] helpviewer_keywords: ["RC1205"] -ms.assetid: 6cfbe019-ad8a-4267-b4b9-0d675bb3819a --- # Resource Compiler Fatal Error RC1205 diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md index 47c88f3ad85..4e98e6ab616 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1208" title: "Resource Compiler Fatal Error RC1208" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1208" +ms.date: 11/04/2016 f1_keywords: ["RC1208"] helpviewer_keywords: ["RC1208"] -ms.assetid: 7dacc4ec-3ebd-49b3-ba4c-1a2982bac720 --- # Resource Compiler Fatal Error RC1208 From 114088f53ccace67ee7fad8cfe4f0c21b3ceaad1 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 15 Sep 2025 23:42:46 +0800 Subject: [PATCH 1205/1799] Add blockquotes for error messages in range [RC2001, RC2175] --- .../tool-errors/resource-compiler-error-rc2001.md | 2 +- .../tool-errors/resource-compiler-error-rc2007.md | 2 +- .../tool-errors/resource-compiler-error-rc2015.md | 2 +- .../tool-errors/resource-compiler-error-rc2017.md | 2 +- .../tool-errors/resource-compiler-error-rc2101.md | 2 +- .../tool-errors/resource-compiler-error-rc2103.md | 2 +- .../tool-errors/resource-compiler-error-rc2104.md | 2 +- .../tool-errors/resource-compiler-error-rc2107.md | 2 +- .../tool-errors/resource-compiler-error-rc2109.md | 2 +- .../tool-errors/resource-compiler-error-rc2111.md | 2 +- .../tool-errors/resource-compiler-error-rc2112.md | 2 +- .../tool-errors/resource-compiler-error-rc2113.md | 2 +- .../tool-errors/resource-compiler-error-rc2114.md | 2 +- .../tool-errors/resource-compiler-error-rc2116.md | 2 +- .../tool-errors/resource-compiler-error-rc2122.md | 2 +- .../tool-errors/resource-compiler-error-rc2124.md | 2 +- .../tool-errors/resource-compiler-error-rc2127.md | 2 +- .../tool-errors/resource-compiler-error-rc2135.md | 2 +- .../tool-errors/resource-compiler-error-rc2144.md | 2 +- .../tool-errors/resource-compiler-error-rc2147.md | 2 +- .../tool-errors/resource-compiler-error-rc2148.md | 2 +- .../tool-errors/resource-compiler-error-rc2151.md | 2 +- .../tool-errors/resource-compiler-error-rc2152.md | 2 +- .../tool-errors/resource-compiler-error-rc2162.md | 2 +- .../tool-errors/resource-compiler-error-rc2163.md | 2 +- .../tool-errors/resource-compiler-error-rc2164.md | 2 +- .../tool-errors/resource-compiler-error-rc2165.md | 2 +- .../tool-errors/resource-compiler-error-rc2167.md | 2 +- .../tool-errors/resource-compiler-error-rc2169.md | 2 +- .../tool-errors/resource-compiler-error-rc2170.md | 2 +- .../tool-errors/resource-compiler-error-rc2171.md | 2 +- .../tool-errors/resource-compiler-error-rc2175.md | 2 +- 32 files changed, 32 insertions(+), 32 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md index a6dc03c0ac6..f098bd563cc 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md @@ -8,7 +8,7 @@ ms.assetid: 92bfb4c0-1879-4606-bb9f-ef7368707b4a --- # Resource Compiler Error RC2001 -newline in constant +> newline in constant A string constant was continued on a second line without either a backslash (**\\**) or closing and opening double quotation marks (**"**). diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md index 7273ed71fdf..e0845bcb88f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md @@ -8,6 +8,6 @@ ms.assetid: a616e506-bef2-4155-9fe0-dbccac8954d3 --- # Resource Compiler Error RC2007 -\#define syntax +> #define syntax An identifier was expected following `#define` in a preprocessing directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md index 5b717ab7cbc..7e91ea37264 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md @@ -8,7 +8,7 @@ ms.assetid: 99691683-fb9e-4e61-beb1-12e484858570 --- # Resource Compiler Error RC2015 -too many chars in constant +> too many chars in constant A character constant contained more than two characters. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md index abba418bcbe..353df868297 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md @@ -8,7 +8,7 @@ ms.assetid: 5fcc0135-cd60-4b1d-a7dd-8a4f2312697b --- # Resource Compiler Error RC2017 -illegal escape sequence +> illegal escape sequence An escape sequence appeared where one was not expected. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md index 90d7026affd..7d96582cbea 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md @@ -8,7 +8,7 @@ ms.assetid: 580f9d74-162f-41e9-9438-ddbe3457c359 --- # Resource Compiler Error RC2101 -Invalid directive in preprocessed RC file +> Invalid directive in preprocessed RC file The Resource Compiler file contains a **#pragma** directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md index c49524f2c12..99df8f5159b 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md @@ -8,6 +8,6 @@ ms.assetid: eedf2366-d1c3-4e7e-815c-d367d976b3f6 --- # Resource Compiler Error RC2103 -unexpected end of file in string literal +> unexpected end of file in string literal An end of file was found before the end of a string. The string is probably missing a closing double quotation mark (**"**). diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md index eb9bbcda543..60f6f2c94dd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md @@ -8,7 +8,7 @@ ms.assetid: 792a3bd8-cb4c-4817-b288-4ce37082b582 --- # Resource Compiler Error RC2104 -undefined keyword or key name: key +> undefined keyword or key name: key The specified keyword or key name is not defined. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md index 329977b1988..204cfbbb3dd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md @@ -8,6 +8,6 @@ ms.assetid: f1786128-aa86-4cdb-a095-05a0b66b5608 --- # Resource Compiler Error RC2107 -**expected numeric command value** +> expected numeric command value The Resource Compiler was expecting a numeric *idvalue* field in the **ACCELERATORS** statement. Make sure that you have used a `#define` constant to specify the value and that the constant is spelled correctly. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md index f94aac2e868..c6c95200bba 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md @@ -8,6 +8,6 @@ ms.assetid: b800aa67-33c0-42f5-81a2-7a64a3b6b824 --- # Resource Compiler Error RC2109 -expected numerical dialog constant +> expected numerical dialog constant A **DIALOG** statement requires integer values for the *x, y, width*, and *height* fields. Make sure these values are included after the **DIALOG** keyword and that they are not negative. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md index 20b4cc9b36d..2a69bda3471 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md @@ -8,7 +8,7 @@ ms.assetid: 118cba57-82a4-4199-acf4-9d9561946218 --- # Resource Compiler Error RC2111 -invalid control type +> invalid control type Each CONTROL statement in a **DIALOG** statement must be one of the following: 3STATE, AUTO3, AUTOCHECK, AUTORADIO, BEDIT, CHECKBOX, COMBOBOX, CONTROL, CTEXT, DEFPUSHBUTTON, EDITTEXT, GROUPBOX, HEDIT, ICON, IEDIT, LISTBOX, LTEXT, PUSHBOX, PUSHBUTTON, RADIOBUTTON, RTEXT, SCROLLBAR, USERBUTTON. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md index 452c0280680..c1e6baa8343 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md @@ -8,6 +8,6 @@ ms.assetid: e9f29540-a90d-4989-a6e8-5f8f32015bd9 --- # Resource Compiler Error RC2112 -BEGIN expected in dialog +> BEGIN expected in dialog The **BEGIN** keyword must immediately follow the **DIALOG** keyword. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md index c62fc7fcbf1..f34891360a5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md @@ -8,6 +8,6 @@ ms.assetid: cbf52e93-ab14-49b7-9ce8-fb55877602ec --- # Resource Compiler Error RC2113 -END expected in dialog +> END expected in dialog The **END** keyword must occur at the end of a **DIALOG** statement. Make sure there are no open quotes left from the preceding statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md index 87705494bec..6a8edae5751 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md @@ -8,6 +8,6 @@ ms.assetid: abdfdc46-6601-451f-8e81-81e92bcd2208 --- # Resource Compiler Error RC2114 -expected control class name +> expected control class name The `class` field of a CONTROL statement in the **DIALOG** statement must be one of the following types: BUTTON, COMBOBOX, EDIT, LISTBOX, SCROLLBAR, STATIC, or user-defined. Make sure the class is spelled correctly. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md index c43b2deabbb..e43f5b77f66 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md @@ -8,6 +8,6 @@ ms.assetid: d9203ddf-798d-490b-be41-0dd3f7d53653 --- # Resource Compiler Error RC2116 -expecting number for ID +> expecting number for ID Expecting a number for the `id` field of a control statement in the **DIALOG** statement. Make sure you have a number or `#define` statement for the control ID. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md index 7a8d7e682d3..c1aca269209 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md @@ -8,6 +8,6 @@ ms.assetid: c2f02ec1-1ce8-4a13-b35e-7cd416fa9f41 --- # Resource Compiler Error RC2122 -unknown menu subtype +> unknown menu subtype The *item-definition* field of the **MENU** statement can contain only **MENUITEM** and **POPUP** statements. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md index a7b4b921d33..4b0e82b97ed 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md @@ -8,6 +8,6 @@ ms.assetid: 4eb5c4ec-ca9b-46a0-805b-35e040e9ed41 --- # Resource Compiler Error RC2124 -empty menus not allowed +> empty menus not allowed An **END** keyword appears before any menu items are defined in the **MENU** statement. The Resource Compiler does not permit empty menus. Make sure you do not have any open quotation marks within the **MENU** statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md index c3a1a1018d4..57591cd1a7a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md @@ -8,6 +8,6 @@ ms.assetid: 13c1599d-ac4c-4044-a59a-48e69511ef7e --- # Resource Compiler Error RC2127 -version WORDs separated by commas expected +> version WORDs separated by commas expected Version numbers in a version resource should be of type **WORD**, and separated by commas. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md index 81091b335fb..54c923b5494 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md @@ -8,7 +8,7 @@ ms.assetid: 1509a0fa-1cb7-4654-bcb3-ad5ac973e659 --- # Resource Compiler Error RC2135 -file not found: filename +> file not found: filename The file specified in the Resource Compiler command line was not found. Check to see whether the file has been moved to another directory and whether the file name and path are typed correctly. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md index 18382c57438..b5e2a50a7e1 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md @@ -8,7 +8,7 @@ ms.assetid: 1b3ff39a-92cd-4a04-b1a3-b1fa6a805813 --- # Resource Compiler Error RC2144 -PRIMARY LANGUAGE ID not a number +> PRIMARY LANGUAGE ID not a number The PRIMARY LANGUAGE ID must be a hexadecimal language ID. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for a list of valid Language IDs. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md index 6e29e0a636e..c455734931c 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md @@ -8,7 +8,7 @@ ms.assetid: 09974f06-1731-4e70-b373-f9218e0ee8d9 --- # Resource Compiler Error RC2147 -SUBLANGUAGE ID not a number +> SUBLANGUAGE ID not a number The SUBLANGUAGE ID value must be a number. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md index a5db826be2f..91afdc072f7 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md @@ -8,7 +8,7 @@ ms.assetid: 0290065c-35d3-4815-80c5-40bf7132ae1d --- # Resource Compiler Error RC2148 -SUBLANGUAGE ID too large +> SUBLANGUAGE ID too large The SUBLANGUAGE ID value was out of range. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md index 5f5b597acdd..cd4bedbcba6 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md @@ -8,7 +8,7 @@ ms.assetid: 3c47e535-c78d-4338-aab9-9b47e2c34728 --- # Resource Compiler Error RC2151 -cannot re-use string constants +> cannot re-use string constants You are using the same value twice in a **STRINGTABLE** statement. Make sure you are not mixing overlapping decimal and hexadecimal values. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md index 543e1ca9945..22e682d2e22 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md @@ -8,6 +8,6 @@ ms.assetid: 8efcba8f-9971-43cc-a1cd-8d7c9aec133c --- # Resource Compiler Error RC2152 -invalid control character +> invalid control character A control character in the **ACCELERATORS** statement is invalid. A valid control character consists of one letter (only) following a caret (**^**). diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md index b88dac5c06d..58b4b2b50fa 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md @@ -8,6 +8,6 @@ ms.assetid: 4ac713b7-3067-436c-83fd-4180438c4f2c --- # Resource Compiler Error RC2162 -expected macro formal parameter +> expected macro formal parameter The token following a stringizing operator (**#**) was not a formal parameter name. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md index 236af060128..d3e0b36192f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md @@ -8,6 +8,6 @@ ms.assetid: a7e95939-9267-4262-9b49-90dc4157a7da --- # Resource Compiler Error RC2163 -accelerator type required [ASCII or VIRTKEY] +> accelerator type required [ASCII or VIRTKEY] The `type` field in the **ACCELERATORS** statement must contain either the ASCII or VIRTKEY value. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md index b6ea0321840..19595c375cf 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md @@ -8,6 +8,6 @@ ms.assetid: 23d7691d-80f3-4979-a519-378e5498d2d1 --- # Resource Compiler Error RC2164 -unexpected value in RCDATA +> unexpected value in RCDATA The *raw-data* values in the **RCDATA** statement must be integers or strings, each separated by a comma. Make sure you did not leave out a comma or leave out a quotation mark around a string. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md index d0fc2be2f2b..960753d8b03 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md @@ -8,7 +8,7 @@ ms.assetid: bf7d4630-9355-47e3-87fa-6693fcf0ef0d --- # Resource Compiler Error RC2165 -string not found in DLGINCLUDE statement +> string not found in DLGINCLUDE statement The statement did not specify a valid include file. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md index 930bd48228a..9f4a3a105dc 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md @@ -8,6 +8,6 @@ ms.assetid: 9b24a8eb-367b-4ff6-8266-b0c215f32d6a --- # Resource Compiler Error RC2167 -unrecognized VERSIONINFO field; BEGIN or comma expected +> unrecognized VERSIONINFO field; BEGIN or comma expected An unrecognized field was found in the **FIXED** part of a **VERSIONINFO** structure declaration. A **VERSIONINFO** field must be DWORDS separated by a comma. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md index 361c09d9706..f5fc11164e0 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md @@ -8,6 +8,6 @@ ms.assetid: 832c19ad-a2e2-4f50-b493-26b791877600 --- # Resource Compiler Error RC2169 -resource file filename is not in 2.03 format +> resource file filename is not in 2.03 format The specified resource used a format earlier than version 2.03. The resource file must be converted or recreated using the format for version 3.00 or later. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md index 4aba900e450..64a9e6d1155 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md @@ -8,7 +8,7 @@ ms.assetid: 6ea80c98-0942-41a8-b0b2-2c16c255adf5 --- # Resource Compiler Error RC2170 -bitmap file filename is not in 3.00 format +> bitmap file filename is not in 3.00 format Bitmaps using the Windows version 2.x format cannot be used in version 3.x resource files. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md index 13e76b8e9c9..2140f4e345f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md @@ -8,6 +8,6 @@ ms.assetid: 0c959938-e744-43f3-b460-f05547ffea2a --- # Resource Compiler Error RC2171 -unknown DIB header format +> unknown DIB header format The bitmap header is not a **BITMAPCOREHEADER** or **BITMAPINFOHEADER** structure. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md index 41d4e56fa14..3004d85368e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md @@ -8,6 +8,6 @@ ms.assetid: 3864a371-dba8-41a7-962c-e792709774f1 --- # Resource Compiler Error RC2175 -resource file filename is not in 3.00 format +> resource file filename is not in 3.00 format The specified resource used a format earlier than version 3.00. The resource file must be converted or recreated using the format for version 3.00 or later. From 82f8ef25ca3d682f358127b95fa1a60e8b3f85fc Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 15 Sep 2025 23:45:52 +0800 Subject: [PATCH 1206/1799] Add "Remarks" headings for error references in range [RC2001, RC2175] --- .../tool-errors/resource-compiler-error-rc2001.md | 2 ++ .../tool-errors/resource-compiler-error-rc2007.md | 2 ++ .../tool-errors/resource-compiler-error-rc2015.md | 2 ++ .../tool-errors/resource-compiler-error-rc2017.md | 2 ++ .../tool-errors/resource-compiler-error-rc2101.md | 2 ++ .../tool-errors/resource-compiler-error-rc2103.md | 2 ++ .../tool-errors/resource-compiler-error-rc2104.md | 2 ++ .../tool-errors/resource-compiler-error-rc2107.md | 2 ++ .../tool-errors/resource-compiler-error-rc2109.md | 2 ++ .../tool-errors/resource-compiler-error-rc2111.md | 2 ++ .../tool-errors/resource-compiler-error-rc2112.md | 2 ++ .../tool-errors/resource-compiler-error-rc2113.md | 2 ++ .../tool-errors/resource-compiler-error-rc2114.md | 2 ++ .../tool-errors/resource-compiler-error-rc2116.md | 2 ++ .../tool-errors/resource-compiler-error-rc2122.md | 2 ++ .../tool-errors/resource-compiler-error-rc2124.md | 2 ++ .../tool-errors/resource-compiler-error-rc2127.md | 2 ++ .../tool-errors/resource-compiler-error-rc2135.md | 2 ++ .../tool-errors/resource-compiler-error-rc2144.md | 2 ++ .../tool-errors/resource-compiler-error-rc2147.md | 2 ++ .../tool-errors/resource-compiler-error-rc2148.md | 2 ++ .../tool-errors/resource-compiler-error-rc2151.md | 2 ++ .../tool-errors/resource-compiler-error-rc2152.md | 2 ++ .../tool-errors/resource-compiler-error-rc2162.md | 2 ++ .../tool-errors/resource-compiler-error-rc2163.md | 2 ++ .../tool-errors/resource-compiler-error-rc2164.md | 2 ++ .../tool-errors/resource-compiler-error-rc2165.md | 2 ++ .../tool-errors/resource-compiler-error-rc2167.md | 2 ++ .../tool-errors/resource-compiler-error-rc2169.md | 2 ++ .../tool-errors/resource-compiler-error-rc2170.md | 2 ++ .../tool-errors/resource-compiler-error-rc2171.md | 2 ++ .../tool-errors/resource-compiler-error-rc2175.md | 2 ++ 32 files changed, 64 insertions(+) diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md index f098bd563cc..333581fbeb3 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md @@ -10,6 +10,8 @@ ms.assetid: 92bfb4c0-1879-4606-bb9f-ef7368707b4a > newline in constant +## Remarks + A string constant was continued on a second line without either a backslash (**\\**) or closing and opening double quotation marks (**"**). To break a string constant that is on two lines in the source file, do one of the following: diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md index e0845bcb88f..e142ab41fd5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md @@ -10,4 +10,6 @@ ms.assetid: a616e506-bef2-4155-9fe0-dbccac8954d3 > #define syntax +## Remarks + An identifier was expected following `#define` in a preprocessing directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md index 7e91ea37264..38c4b02a859 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md @@ -10,6 +10,8 @@ ms.assetid: 99691683-fb9e-4e61-beb1-12e484858570 > too many chars in constant +## Remarks + A character constant contained more than two characters. Character constants are limited to one character (standard character constants) or two characters (long character constants). diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md index 353df868297..b4248abc322 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md @@ -10,6 +10,8 @@ ms.assetid: 5fcc0135-cd60-4b1d-a7dd-8a4f2312697b > illegal escape sequence +## Remarks + An escape sequence appeared where one was not expected. An escape sequence — a backslash ( **\\** ) followed by a number or letter — may occur only in a character or string constant. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md index 7d96582cbea..1d160c15ffd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md @@ -10,6 +10,8 @@ ms.assetid: 580f9d74-162f-41e9-9438-ddbe3457c359 > Invalid directive in preprocessed RC file +## Remarks + The Resource Compiler file contains a **#pragma** directive. Use the **#ifndef** preprocessor directive with the RC_INVOKED constant that the Resource Compiler defines when it processes an include file. Place the **#pragma** directive inside a block of code that is not processed when the RC_INVOKED constant is defined. Code in the block is processed only by the C/C++ compiler and not by the Resource Compiler. The following sample code demonstrates this technique: diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md index 99df8f5159b..3cb9c5d9dd4 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md @@ -10,4 +10,6 @@ ms.assetid: eedf2366-d1c3-4e7e-815c-d367d976b3f6 > unexpected end of file in string literal +## Remarks + An end of file was found before the end of a string. The string is probably missing a closing double quotation mark (**"**). diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md index 60f6f2c94dd..be773d79419 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md @@ -10,6 +10,8 @@ ms.assetid: 792a3bd8-cb4c-4817-b288-4ce37082b582 > undefined keyword or key name: key +## Remarks + The specified keyword or key name is not defined. This error is often caused by a typo in the resource definition, or in the included header file. It can also be caused by a missing header file. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md index 204cfbbb3dd..3e7774c2ae6 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md @@ -10,4 +10,6 @@ ms.assetid: f1786128-aa86-4cdb-a095-05a0b66b5608 > expected numeric command value +## Remarks + The Resource Compiler was expecting a numeric *idvalue* field in the **ACCELERATORS** statement. Make sure that you have used a `#define` constant to specify the value and that the constant is spelled correctly. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md index c6c95200bba..c6bf457bb64 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md @@ -10,4 +10,6 @@ ms.assetid: b800aa67-33c0-42f5-81a2-7a64a3b6b824 > expected numerical dialog constant +## Remarks + A **DIALOG** statement requires integer values for the *x, y, width*, and *height* fields. Make sure these values are included after the **DIALOG** keyword and that they are not negative. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md index 2a69bda3471..d7f2218019b 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md @@ -10,6 +10,8 @@ ms.assetid: 118cba57-82a4-4199-acf4-9d9561946218 > invalid control type +## Remarks + Each CONTROL statement in a **DIALOG** statement must be one of the following: 3STATE, AUTO3, AUTOCHECK, AUTORADIO, BEDIT, CHECKBOX, COMBOBOX, CONTROL, CTEXT, DEFPUSHBUTTON, EDITTEXT, GROUPBOX, HEDIT, ICON, IEDIT, LISTBOX, LTEXT, PUSHBOX, PUSHBUTTON, RADIOBUTTON, RTEXT, SCROLLBAR, USERBUTTON. Make sure these CONTROL statements are spelled correctly. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md index c1e6baa8343..024b2b6ca03 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md @@ -10,4 +10,6 @@ ms.assetid: e9f29540-a90d-4989-a6e8-5f8f32015bd9 > BEGIN expected in dialog +## Remarks + The **BEGIN** keyword must immediately follow the **DIALOG** keyword. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md index f34891360a5..a14e73b2fa5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md @@ -10,4 +10,6 @@ ms.assetid: cbf52e93-ab14-49b7-9ce8-fb55877602ec > END expected in dialog +## Remarks + The **END** keyword must occur at the end of a **DIALOG** statement. Make sure there are no open quotes left from the preceding statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md index 6a8edae5751..ded2dcefa15 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md @@ -10,4 +10,6 @@ ms.assetid: abdfdc46-6601-451f-8e81-81e92bcd2208 > expected control class name +## Remarks + The `class` field of a CONTROL statement in the **DIALOG** statement must be one of the following types: BUTTON, COMBOBOX, EDIT, LISTBOX, SCROLLBAR, STATIC, or user-defined. Make sure the class is spelled correctly. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md index e43f5b77f66..be11e81688b 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md @@ -10,4 +10,6 @@ ms.assetid: d9203ddf-798d-490b-be41-0dd3f7d53653 > expecting number for ID +## Remarks + Expecting a number for the `id` field of a control statement in the **DIALOG** statement. Make sure you have a number or `#define` statement for the control ID. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md index c1aca269209..e15e32699ae 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md @@ -10,4 +10,6 @@ ms.assetid: c2f02ec1-1ce8-4a13-b35e-7cd416fa9f41 > unknown menu subtype +## Remarks + The *item-definition* field of the **MENU** statement can contain only **MENUITEM** and **POPUP** statements. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md index 4b0e82b97ed..933ec01d478 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md @@ -10,4 +10,6 @@ ms.assetid: 4eb5c4ec-ca9b-46a0-805b-35e040e9ed41 > empty menus not allowed +## Remarks + An **END** keyword appears before any menu items are defined in the **MENU** statement. The Resource Compiler does not permit empty menus. Make sure you do not have any open quotation marks within the **MENU** statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md index 57591cd1a7a..c1483b512de 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md @@ -10,4 +10,6 @@ ms.assetid: 13c1599d-ac4c-4044-a59a-48e69511ef7e > version WORDs separated by commas expected +## Remarks + Version numbers in a version resource should be of type **WORD**, and separated by commas. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md index 54c923b5494..86caa57a5fe 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md @@ -10,6 +10,8 @@ ms.assetid: 1509a0fa-1cb7-4654-bcb3-ad5ac973e659 > file not found: filename +## Remarks + The file specified in the Resource Compiler command line was not found. Check to see whether the file has been moved to another directory and whether the file name and path are typed correctly. Files are searched for using the **INCLUDE** environment variable or the Visual C++ **INCLUDE** setting. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md index b5e2a50a7e1..509c798322c 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md @@ -10,6 +10,8 @@ ms.assetid: 1b3ff39a-92cd-4a04-b1a3-b1fa6a805813 > PRIMARY LANGUAGE ID not a number +## Remarks + The PRIMARY LANGUAGE ID must be a hexadecimal language ID. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for a list of valid Language IDs. This error can also occur if resources have been added and deleted from the .RC file using a tool. To fix this issue, open the .RC file in a text editor and clean up any unused resources manually. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md index c455734931c..28a307b8719 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md @@ -10,6 +10,8 @@ ms.assetid: 09974f06-1731-4e70-b373-f9218e0ee8d9 > SUBLANGUAGE ID not a number +## Remarks + The SUBLANGUAGE ID value must be a number. The **LANGUAGE** statement must use the following syntax: diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md index 91afdc072f7..55ba52219ca 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md @@ -10,6 +10,8 @@ ms.assetid: 0290065c-35d3-4815-80c5-40bf7132ae1d > SUBLANGUAGE ID too large +## Remarks + The SUBLANGUAGE ID value was out of range. The **LANGUAGE** statement must use the following syntax: diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md index cd4bedbcba6..db1ea9893fe 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md @@ -10,6 +10,8 @@ ms.assetid: 3c47e535-c78d-4338-aab9-9b47e2c34728 > cannot re-use string constants +## Remarks + You are using the same value twice in a **STRINGTABLE** statement. Make sure you are not mixing overlapping decimal and hexadecimal values. Each ID in a **STRINGTABLE** must be unique. For maximum efficiency use contiguous constants that start on a multiple of 16. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md index 22e682d2e22..c4231e10a6a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md @@ -10,4 +10,6 @@ ms.assetid: 8efcba8f-9971-43cc-a1cd-8d7c9aec133c > invalid control character +## Remarks + A control character in the **ACCELERATORS** statement is invalid. A valid control character consists of one letter (only) following a caret (**^**). diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md index 58b4b2b50fa..4522edffc51 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md @@ -10,4 +10,6 @@ ms.assetid: 4ac713b7-3067-436c-83fd-4180438c4f2c > expected macro formal parameter +## Remarks + The token following a stringizing operator (**#**) was not a formal parameter name. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md index d3e0b36192f..8242b24f00e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md @@ -10,4 +10,6 @@ ms.assetid: a7e95939-9267-4262-9b49-90dc4157a7da > accelerator type required [ASCII or VIRTKEY] +## Remarks + The `type` field in the **ACCELERATORS** statement must contain either the ASCII or VIRTKEY value. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md index 19595c375cf..2a93f8532f5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md @@ -10,4 +10,6 @@ ms.assetid: 23d7691d-80f3-4979-a519-378e5498d2d1 > unexpected value in RCDATA +## Remarks + The *raw-data* values in the **RCDATA** statement must be integers or strings, each separated by a comma. Make sure you did not leave out a comma or leave out a quotation mark around a string. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md index 960753d8b03..815d3657294 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md @@ -10,6 +10,8 @@ ms.assetid: bf7d4630-9355-47e3-87fa-6693fcf0ef0d > string not found in DLGINCLUDE statement +## Remarks + The statement did not specify a valid include file. The **DLGINCLUDE** statement must use the following syntax: diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md index 9f4a3a105dc..d2df5e714c8 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md @@ -10,4 +10,6 @@ ms.assetid: 9b24a8eb-367b-4ff6-8266-b0c215f32d6a > unrecognized VERSIONINFO field; BEGIN or comma expected +## Remarks + An unrecognized field was found in the **FIXED** part of a **VERSIONINFO** structure declaration. A **VERSIONINFO** field must be DWORDS separated by a comma. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md index f5fc11164e0..584ebbfed1a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md @@ -10,4 +10,6 @@ ms.assetid: 832c19ad-a2e2-4f50-b493-26b791877600 > resource file filename is not in 2.03 format +## Remarks + The specified resource used a format earlier than version 2.03. The resource file must be converted or recreated using the format for version 3.00 or later. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md index 64a9e6d1155..176b9291984 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md @@ -10,6 +10,8 @@ ms.assetid: 6ea80c98-0942-41a8-b0b2-2c16c255adf5 > bitmap file filename is not in 3.00 format +## Remarks + Bitmaps using the Windows version 2.x format cannot be used in version 3.x resource files. To fix this issue, redraw or convert the bitmap to 3.x format. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md index 2140f4e345f..4871e1cc9c7 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md @@ -10,4 +10,6 @@ ms.assetid: 0c959938-e744-43f3-b460-f05547ffea2a > unknown DIB header format +## Remarks + The bitmap header is not a **BITMAPCOREHEADER** or **BITMAPINFOHEADER** structure. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md index 3004d85368e..690b53ef92a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md @@ -10,4 +10,6 @@ ms.assetid: 3864a371-dba8-41a7-962c-e792709774f1 > resource file filename is not in 3.00 format +## Remarks + The specified resource used a format earlier than version 3.00. The resource file must be converted or recreated using the format for version 3.00 or later. From 50a0dc369acb3e3aaa83caaba4746fdeaa925ae9 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 15 Sep 2025 23:51:41 +0800 Subject: [PATCH 1207/1799] Update metadata for error references in range [RC2001, RC2175] --- .../tool-errors/resource-compiler-error-rc2001.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2007.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2015.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2017.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2101.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2103.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2104.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2107.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2109.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2111.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2112.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2113.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2114.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2116.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2122.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2124.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2127.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2135.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2144.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2147.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2148.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2151.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2152.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2162.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2163.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2164.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2165.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2167.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2169.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2170.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2171.md | 5 ++--- .../tool-errors/resource-compiler-error-rc2175.md | 5 ++--- 32 files changed, 64 insertions(+), 96 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md index 333581fbeb3..b807eea4e4a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2001" title: "Resource Compiler Error RC2001" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2001" +ms.date: 11/04/2016 f1_keywords: ["RC2001"] helpviewer_keywords: ["RC2001"] -ms.assetid: 92bfb4c0-1879-4606-bb9f-ef7368707b4a --- # Resource Compiler Error RC2001 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md index e142ab41fd5..dbfac5c5bfb 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2007" title: "Resource Compiler Error RC2007" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2007" +ms.date: 11/04/2016 f1_keywords: ["RC2007"] helpviewer_keywords: ["RC2007"] -ms.assetid: a616e506-bef2-4155-9fe0-dbccac8954d3 --- # Resource Compiler Error RC2007 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md index 38c4b02a859..035bfd9f4fd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2015" title: "Resource Compiler Error RC2015" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2015" +ms.date: 11/04/2016 f1_keywords: ["RC2015"] helpviewer_keywords: ["RC2015"] -ms.assetid: 99691683-fb9e-4e61-beb1-12e484858570 --- # Resource Compiler Error RC2015 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md index b4248abc322..f0ea17ecac3 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2017" title: "Resource Compiler Error RC2017" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2017" +ms.date: 11/04/2016 f1_keywords: ["RC2017"] helpviewer_keywords: ["RC2017"] -ms.assetid: 5fcc0135-cd60-4b1d-a7dd-8a4f2312697b --- # Resource Compiler Error RC2017 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md index 1d160c15ffd..95a520dc668 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2101" title: "Resource Compiler Error RC2101" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2101" +ms.date: 11/04/2016 f1_keywords: ["RC2101"] helpviewer_keywords: ["RC2101"] -ms.assetid: 580f9d74-162f-41e9-9438-ddbe3457c359 --- # Resource Compiler Error RC2101 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md index 3cb9c5d9dd4..2399c255c57 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2103" title: "Resource Compiler Error RC2103" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2103" +ms.date: 11/04/2016 f1_keywords: ["RC2103"] helpviewer_keywords: ["RC2103"] -ms.assetid: eedf2366-d1c3-4e7e-815c-d367d976b3f6 --- # Resource Compiler Error RC2103 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md index be773d79419..1ce67b04525 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2104" title: "Resource Compiler Error RC2104" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2104" +ms.date: 11/04/2016 f1_keywords: ["RC2104"] helpviewer_keywords: ["RC2104"] -ms.assetid: 792a3bd8-cb4c-4817-b288-4ce37082b582 --- # Resource Compiler Error RC2104 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md index 3e7774c2ae6..9258f3d82c9 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2107" title: "Resource Compiler Error RC2107" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2107" +ms.date: 11/04/2016 f1_keywords: ["RC2107"] helpviewer_keywords: ["RC2107"] -ms.assetid: f1786128-aa86-4cdb-a095-05a0b66b5608 --- # Resource Compiler Error RC2107 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md index c6bf457bb64..28eaffebead 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2109" title: "Resource Compiler Error RC2109" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2109" +ms.date: 11/04/2016 f1_keywords: ["RC2109"] helpviewer_keywords: ["RC2109"] -ms.assetid: b800aa67-33c0-42f5-81a2-7a64a3b6b824 --- # Resource Compiler Error RC2109 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md index d7f2218019b..159bd5e1ed8 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2111" title: "Resource Compiler Error RC2111" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2111" +ms.date: 11/04/2016 f1_keywords: ["RC2111"] helpviewer_keywords: ["RC2111"] -ms.assetid: 118cba57-82a4-4199-acf4-9d9561946218 --- # Resource Compiler Error RC2111 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md index 024b2b6ca03..e03480d20e3 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2112" title: "Resource Compiler Error RC2112" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2112" +ms.date: 11/04/2016 f1_keywords: ["RC2112"] helpviewer_keywords: ["RC2112"] -ms.assetid: e9f29540-a90d-4989-a6e8-5f8f32015bd9 --- # Resource Compiler Error RC2112 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md index a14e73b2fa5..d33a9cd82ca 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2113" title: "Resource Compiler Error RC2113" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2113" +ms.date: 11/04/2016 f1_keywords: ["RC2113"] helpviewer_keywords: ["RC2113"] -ms.assetid: cbf52e93-ab14-49b7-9ce8-fb55877602ec --- # Resource Compiler Error RC2113 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md index ded2dcefa15..d43e41ab86f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2114" title: "Resource Compiler Error RC2114" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2114" +ms.date: 11/04/2016 f1_keywords: ["RC2114"] helpviewer_keywords: ["RC2114"] -ms.assetid: abdfdc46-6601-451f-8e81-81e92bcd2208 --- # Resource Compiler Error RC2114 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md index be11e81688b..1b227079bfe 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2116" title: "Resource Compiler Error RC2116" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2116" +ms.date: 11/04/2016 f1_keywords: ["RC2116"] helpviewer_keywords: ["RC2116"] -ms.assetid: d9203ddf-798d-490b-be41-0dd3f7d53653 --- # Resource Compiler Error RC2116 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md index e15e32699ae..d275f06f2a9 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2122" title: "Resource Compiler Error RC2122" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2122" +ms.date: 11/04/2016 f1_keywords: ["RC2122"] helpviewer_keywords: ["RC2122"] -ms.assetid: c2f02ec1-1ce8-4a13-b35e-7cd416fa9f41 --- # Resource Compiler Error RC2122 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md index 933ec01d478..eb59025dd5f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2124" title: "Resource Compiler Error RC2124" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2124" +ms.date: 11/04/2016 f1_keywords: ["RC2124"] helpviewer_keywords: ["RC2124"] -ms.assetid: 4eb5c4ec-ca9b-46a0-805b-35e040e9ed41 --- # Resource Compiler Error RC2124 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md index c1483b512de..a82cf52c6db 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2127" title: "Resource Compiler Error RC2127" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2127" +ms.date: 11/04/2016 f1_keywords: ["RC2127"] helpviewer_keywords: ["RC2127"] -ms.assetid: 13c1599d-ac4c-4044-a59a-48e69511ef7e --- # Resource Compiler Error RC2127 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md index 86caa57a5fe..e4a11942710 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2135" title: "Resource Compiler Error RC2135" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2135" +ms.date: 11/04/2016 f1_keywords: ["RC2135"] helpviewer_keywords: ["RC2135"] -ms.assetid: 1509a0fa-1cb7-4654-bcb3-ad5ac973e659 --- # Resource Compiler Error RC2135 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md index 509c798322c..7fe5c107fca 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2144" title: "Resource Compiler Error RC2144" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2144" +ms.date: 11/04/2016 f1_keywords: ["RC2144"] helpviewer_keywords: ["RC2144"] -ms.assetid: 1b3ff39a-92cd-4a04-b1a3-b1fa6a805813 --- # Resource Compiler Error RC2144 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md index 28a307b8719..09009bcb002 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2147" title: "Resource Compiler Error RC2147" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2147" +ms.date: 11/04/2016 f1_keywords: ["RC2147"] helpviewer_keywords: ["RC2147"] -ms.assetid: 09974f06-1731-4e70-b373-f9218e0ee8d9 --- # Resource Compiler Error RC2147 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md index 55ba52219ca..40d6110c5cc 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2148" title: "Resource Compiler Error RC2148" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2148" +ms.date: 11/04/2016 f1_keywords: ["RC2148"] helpviewer_keywords: ["RC2148"] -ms.assetid: 0290065c-35d3-4815-80c5-40bf7132ae1d --- # Resource Compiler Error RC2148 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md index db1ea9893fe..3ed804bfabf 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2151" title: "Resource Compiler Error RC2151" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2151" +ms.date: 11/04/2016 f1_keywords: ["RC2151"] helpviewer_keywords: ["RC2151"] -ms.assetid: 3c47e535-c78d-4338-aab9-9b47e2c34728 --- # Resource Compiler Error RC2151 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md index c4231e10a6a..ff275d02746 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2152" title: "Resource Compiler Error RC2152" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2152" +ms.date: 11/04/2016 f1_keywords: ["RC2152"] helpviewer_keywords: ["RC2152"] -ms.assetid: 8efcba8f-9971-43cc-a1cd-8d7c9aec133c --- # Resource Compiler Error RC2152 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md index 4522edffc51..9a45dc6be3e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2162" title: "Resource Compiler Error RC2162" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2162" +ms.date: 11/04/2016 f1_keywords: ["RC2162"] helpviewer_keywords: ["RC2162"] -ms.assetid: 4ac713b7-3067-436c-83fd-4180438c4f2c --- # Resource Compiler Error RC2162 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md index 8242b24f00e..6db89f5ffed 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2163" title: "Resource Compiler Error RC2163" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2163" +ms.date: 11/04/2016 f1_keywords: ["RC2163"] helpviewer_keywords: ["RC2163"] -ms.assetid: a7e95939-9267-4262-9b49-90dc4157a7da --- # Resource Compiler Error RC2163 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md index 2a93f8532f5..532f85db497 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2164" title: "Resource Compiler Error RC2164" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2164" +ms.date: 11/04/2016 f1_keywords: ["RC2164"] helpviewer_keywords: ["RC2164"] -ms.assetid: 23d7691d-80f3-4979-a519-378e5498d2d1 --- # Resource Compiler Error RC2164 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md index 815d3657294..f18cebc686b 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2165" title: "Resource Compiler Error RC2165" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2165" +ms.date: 11/04/2016 f1_keywords: ["RC2165"] helpviewer_keywords: ["RC2165"] -ms.assetid: bf7d4630-9355-47e3-87fa-6693fcf0ef0d --- # Resource Compiler Error RC2165 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md index d2df5e714c8..ac84004be8e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2167" title: "Resource Compiler Error RC2167" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2167" +ms.date: 11/04/2016 f1_keywords: ["RC2167"] helpviewer_keywords: ["RC2167"] -ms.assetid: 9b24a8eb-367b-4ff6-8266-b0c215f32d6a --- # Resource Compiler Error RC2167 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md index 584ebbfed1a..78767f39494 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2169" title: "Resource Compiler Error RC2169" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2169" +ms.date: 11/04/2016 f1_keywords: ["RC2169"] helpviewer_keywords: ["RC2169"] -ms.assetid: 832c19ad-a2e2-4f50-b493-26b791877600 --- # Resource Compiler Error RC2169 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md index 176b9291984..c0ed41f444d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2170" title: "Resource Compiler Error RC2170" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2170" +ms.date: 11/04/2016 f1_keywords: ["RC2170"] helpviewer_keywords: ["RC2170"] -ms.assetid: 6ea80c98-0942-41a8-b0b2-2c16c255adf5 --- # Resource Compiler Error RC2170 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md index 4871e1cc9c7..c8b1c0605d8 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2171" title: "Resource Compiler Error RC2171" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2171" +ms.date: 11/04/2016 f1_keywords: ["RC2171"] helpviewer_keywords: ["RC2171"] -ms.assetid: 0c959938-e744-43f3-b460-f05547ffea2a --- # Resource Compiler Error RC2171 diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md index 690b53ef92a..3c74a7ea3c4 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Error RC2175" title: "Resource Compiler Error RC2175" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2175" +ms.date: 11/04/2016 f1_keywords: ["RC2175"] helpviewer_keywords: ["RC2175"] -ms.assetid: 3864a371-dba8-41a7-962c-e792709774f1 --- # Resource Compiler Error RC2175 From bb3908d2a4e4293da328cd2955d5e5845044560e Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 21:01:44 +0800 Subject: [PATCH 1208/1799] Fix `countr_one` link in `` header reference --- docs/standard-library/bit.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/bit.md b/docs/standard-library/bit.md index ed42bc8ac34..eb98ce2a93f 100644 --- a/docs/standard-library/bit.md +++ b/docs/standard-library/bit.md @@ -38,7 +38,7 @@ For example, there are functions to rotate bits, find the number of consecutive |[countl_zero](bit-functions.md#countl_zero) | Count the number of consecutive bits set to zero, starting from the most significant bit. | |[countl_one](bit-functions.md#countl_one) | Count the number of consecutive bits set to one, starting from the most significant bit. | |[countr_zero](bit-functions.md#countr_zero) | Count the number of consecutive bits set to zero, starting from the least significant bit. | -|[countr_one](bit-functions.md#countl_one) | Count the number of consecutive bits set to one, starting from the least significant bit. | +|[countr_one](bit-functions.md#countr_one) | Count the number of consecutive bits set to one, starting from the least significant bit. | |[has_single_bit](bit-functions.md#has_single_bit) | Check if a value has only a single bit set to one. This is the same as testing whether a value is a power of two. | |[popcount](bit-functions.md#popcount) | Count the number of bits set to one. | |[rotl](bit-functions.md#rotl) | Compute the result of a bitwise left-rotation. | From bbb60d0e6bb8582bdff713f4757c584f9091e364 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 21:05:09 +0800 Subject: [PATCH 1209/1799] Add backticks in `` header reference --- docs/standard-library/bit.md | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/standard-library/bit.md b/docs/standard-library/bit.md index eb98ce2a93f..f9412edb405 100644 --- a/docs/standard-library/bit.md +++ b/docs/standard-library/bit.md @@ -13,9 +13,9 @@ For example, there are functions to rotate bits, find the number of consecutive ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later is required. @@ -25,24 +25,24 @@ For example, there are functions to rotate bits, find the number of consecutive | Type | Description | |--------|----------| -| [endian](bit-enum.md) | Specifies the endianness of scalar types. | +| [`endian`](bit-enum.md) | Specifies the endianness of scalar types. | ### Functions | Function | Description | |-----|-----| -|[bit_cast](bit-functions.md#bit_cast) | Reinterpret the object representation from one type to another. | -|[bit_ceil](bit-functions.md#bit_ceil) | Find the smallest power of two greater than or equal to a value. | -|[bit_floor](bit-functions.md#bit_floor) | Find the largest integral power of two not greater than a value. | -|[bit_width](bit-functions.md#bit_width) | Find the smallest number of bits needed to represent a value. | -|[countl_zero](bit-functions.md#countl_zero) | Count the number of consecutive bits set to zero, starting from the most significant bit. | -|[countl_one](bit-functions.md#countl_one) | Count the number of consecutive bits set to one, starting from the most significant bit. | -|[countr_zero](bit-functions.md#countr_zero) | Count the number of consecutive bits set to zero, starting from the least significant bit. | -|[countr_one](bit-functions.md#countr_one) | Count the number of consecutive bits set to one, starting from the least significant bit. | -|[has_single_bit](bit-functions.md#has_single_bit) | Check if a value has only a single bit set to one. This is the same as testing whether a value is a power of two. | -|[popcount](bit-functions.md#popcount) | Count the number of bits set to one. | -|[rotl](bit-functions.md#rotl) | Compute the result of a bitwise left-rotation. | -|[rotr](bit-functions.md#rotr) | Compute the result of a bitwise right-rotation. | +|[`bit_cast`](bit-functions.md#bit_cast) | Reinterpret the object representation from one type to another. | +|[`bit_ceil`](bit-functions.md#bit_ceil) | Find the smallest power of two greater than or equal to a value. | +|[`bit_floor`](bit-functions.md#bit_floor) | Find the largest integral power of two not greater than a value. | +|[`bit_width`](bit-functions.md#bit_width) | Find the smallest number of bits needed to represent a value. | +|[`countl_zero`](bit-functions.md#countl_zero) | Count the number of consecutive bits set to zero, starting from the most significant bit. | +|[`countl_one`](bit-functions.md#countl_one) | Count the number of consecutive bits set to one, starting from the most significant bit. | +|[`countr_zero`](bit-functions.md#countr_zero) | Count the number of consecutive bits set to zero, starting from the least significant bit. | +|[`countr_one`](bit-functions.md#countr_one) | Count the number of consecutive bits set to one, starting from the least significant bit. | +|[`has_single_bit`](bit-functions.md#has_single_bit) | Check if a value has only a single bit set to one. This is the same as testing whether a value is a power of two. | +|[`popcount`](bit-functions.md#popcount) | Count the number of bits set to one. | +|[`rotl`](bit-functions.md#rotl) | Compute the result of a bitwise left-rotation. | +|[`rotr`](bit-functions.md#rotr) | Compute the result of a bitwise right-rotation. | ## See also From 27bc14da03aa22213e8fb2d0f43442fc55d5743a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 21:06:18 +0800 Subject: [PATCH 1210/1799] Remove double quotes for `ms.date` in `` header reference --- docs/standard-library/bit.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/bit.md b/docs/standard-library/bit.md index f9412edb405..5f6ca69bb1f 100644 --- a/docs/standard-library/bit.md +++ b/docs/standard-library/bit.md @@ -1,7 +1,7 @@ --- title: "" description: "Functions to access, manipulate, and process individual bits and sequences of bits." -ms.date: "08/28/2020" +ms.date: 08/28/2020 f1_keywords: [""] helpviewer_keywords: ["bit header"] --- From 2aec683c08eb9da3b4ebf6f32bee8bc74d3ef3bb Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 22:02:29 +0800 Subject: [PATCH 1211/1799] Fix a couple of errors in `` concepts --- docs/standard-library/range-concepts.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/range-concepts.md b/docs/standard-library/range-concepts.md index a00aec4ef20..65151dd31bf 100644 --- a/docs/standard-library/range-concepts.md +++ b/docs/standard-library/range-concepts.md @@ -43,7 +43,7 @@ int main() DivideEmUp dividerOfInts; std::cout << dividerOfInts.Divide(6, 3); // outputs 2 // The following line will not compile because the template can't be instantiated - // with char* because char* can be divided + // with char* because char* can't be divided DivideEmUp dividerOfCharPtrs; // compiler error: cannot deduce template arguments } ``` @@ -163,7 +163,7 @@ The type to test to see if it's a `contiguous_range`. ### Remarks -A `contiguous_range` can be accessed by pointer arithmetic because the elements are laid out sequentially in memory and are the same size. This kind of range supports [`continguous_iterator`](iterator-concepts.md#contiguous_iterator), which is the most flexible of all the iterators. +A `contiguous_range` can be accessed by pointer arithmetic because the elements are laid out sequentially in memory and are the same size. This kind of range supports [`contiguous_iterator`](iterator-concepts.md#contiguous_iterator), which is the most flexible of all the iterators. Some examples of a `contiguous_range` are `std::array`, `std::vector`, and `std::string`. @@ -270,7 +270,7 @@ bidirectional_range && random_access_iterator>; ### Parameters *`T`*\ -The type to test to see if it's a `sized_range`. +The type to test to see if it's a `random_access_range`. ### Remarks From 96e99f951e95cdd88b6971fa12a6744feba2b926 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 22:03:23 +0800 Subject: [PATCH 1212/1799] Move `title` metadata above `description` in `` concepts --- docs/standard-library/range-concepts.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/range-concepts.md b/docs/standard-library/range-concepts.md index 65151dd31bf..dc21a897949 100644 --- a/docs/standard-library/range-concepts.md +++ b/docs/standard-library/range-concepts.md @@ -1,6 +1,6 @@ --- -description: "Learn more about range concepts." title: " concepts" +description: "Learn more about range concepts." ms.date: 12/16/2022 f1_keywords: ["ranges/std::ranges::range", "ranges/std::ranges::bidirectional_range", "ranges/std::ranges::borrowed_range", "ranges/std::ranges::common_range", "ranges/std::ranges::contiguous_range", "ranges/std::ranges::forward_range", "ranges/std::ranges::input_range", "ranges/std::ranges::output_range", "ranges/std::ranges::random_access_range", "ranges/std::ranges::simple_view", "ranges/std::ranges::sized_range", "ranges/std::ranges::view", "ranges/std::ranges::viewable_range"] helpviewer_keywords: ["std::ranges [C++], ranges::range", "std::ranges [C++], ranges::bidirectional_range", "std::ranges [C++], ranges::borrowed_range", "std::ranges [C++], ranges::common_range", "std::ranges [C++], ranges::contiguous_range", "std::ranges [C++], ranges::forward_range", "std::ranges [C++], ranges::input_range", "std::ranges [C++], ranges::output_range", "std::ranges [C++], ranges::random_access_range", "std::ranges [C++], ranges::simple_view", "std::ranges [C++], ranges::sized_range", "std::ranges [C++], ranges::view", "std::ranges [C++], ranges::viewable_range"] From e018ae3f4a073e88fecbe14e1416be84b0c5ab2f Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 22:10:11 +0800 Subject: [PATCH 1213/1799] Add blockquotes for warning messages in range [RC4002, RC4214] --- .../tool-errors/resource-compiler-warning-rc4002.md | 2 +- .../tool-errors/resource-compiler-warning-rc4005.md | 2 +- .../tool-errors/resource-compiler-warning-rc4093.md | 2 +- .../tool-errors/resource-compiler-warning-rc4214.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md index 7c41643dbe8..68b100c38f6 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md @@ -8,7 +8,7 @@ ms.assetid: a157bc55-1a75-4337-aee4-e2ba61ff8cfa --- # Resource Compiler Warning RC4002 -too many actual parameters for macro 'identifier' +> too many actual parameters for macro 'identifier' The number of actual parameters specified with the given identifier was greater than the number of formal parameters given in the macro definition of the identifier. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md index 15f614c9056..0fcb0b73fca 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md @@ -8,7 +8,7 @@ ms.assetid: 71f03b4a-c9a9-415d-920f-bf2e58507f93 --- # Resource Compiler Warning RC4005 -'identifier' : macro redefinition +> 'identifier' : macro redefinition The identifier is defined twice. The compiler used the second macro definition. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md index ac1b20c66e7..3beb38c11c7 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md @@ -8,7 +8,7 @@ ms.assetid: 3c61b4a4-b418-465b-a4fd-cb1ff0adb8dd --- # Resource Compiler Warning RC4093 -unescaped newline in character constant in inactive code +> unescaped newline in character constant in inactive code The constant expression of an `#if`, `#elif`, **#ifdef**, or **#ifndef** preprocessor directive evaluated to zero, making the code that follows inactive. Within that inactive code, a newline character appeared within a set of single or double quotation marks. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md index d1ba52ccd48..79e44d6d782 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md @@ -8,6 +8,6 @@ ms.assetid: 79a8bf0d-8cc7-4159-a6a2-d0e543749069 --- # Resource Compiler Warning RC4214 -Codepage not valid : ignored +> Codepage not valid : ignored The .rc file contained a codepage argument and the codepage specified is invalid. See [IsValidCodePage](/windows/win32/api/winnls/nf-winnls-isvalidcodepage) for more information. From 915ec8ea5090413b399a33b78e2af0583225145b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 22:11:38 +0800 Subject: [PATCH 1214/1799] Add "Remarks" headings for warning references in range [RC4002, RC4214] --- .../tool-errors/resource-compiler-warning-rc4002.md | 2 ++ .../tool-errors/resource-compiler-warning-rc4005.md | 2 ++ .../tool-errors/resource-compiler-warning-rc4093.md | 2 ++ .../tool-errors/resource-compiler-warning-rc4214.md | 2 ++ 4 files changed, 8 insertions(+) diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md index 68b100c38f6..05c0e9d7fe2 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md @@ -10,6 +10,8 @@ ms.assetid: a157bc55-1a75-4337-aee4-e2ba61ff8cfa > too many actual parameters for macro 'identifier' +## Remarks + The number of actual parameters specified with the given identifier was greater than the number of formal parameters given in the macro definition of the identifier. The additional actual parameters were collected but ignored during expansion of the macro. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md index 0fcb0b73fca..db2b29364a9 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md @@ -10,6 +10,8 @@ ms.assetid: 71f03b4a-c9a9-415d-920f-bf2e58507f93 > 'identifier' : macro redefinition +## Remarks + The identifier is defined twice. The compiler used the second macro definition. This warning can be caused by defining a macro on the command line and in the code with a `#define` directive. It also can be caused by macros imported from include files. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md index 3beb38c11c7..5a18bbfc430 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md @@ -10,6 +10,8 @@ ms.assetid: 3c61b4a4-b418-465b-a4fd-cb1ff0adb8dd > unescaped newline in character constant in inactive code +## Remarks + The constant expression of an `#if`, `#elif`, **#ifdef**, or **#ifndef** preprocessor directive evaluated to zero, making the code that follows inactive. Within that inactive code, a newline character appeared within a set of single or double quotation marks. All text until the next double quotation mark was considered to be within a character constant. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md index 79e44d6d782..9695f81a2b3 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md @@ -10,4 +10,6 @@ ms.assetid: 79a8bf0d-8cc7-4159-a6a2-d0e543749069 > Codepage not valid : ignored +## Remarks + The .rc file contained a codepage argument and the codepage specified is invalid. See [IsValidCodePage](/windows/win32/api/winnls/nf-winnls-isvalidcodepage) for more information. From 6c0357fe3a84fa3dce7d04c09e514fb52b67c916 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 22:13:35 +0800 Subject: [PATCH 1215/1799] Update metadata for warning references in range [RC4002, RC4214] --- .../tool-errors/resource-compiler-warning-rc4002.md | 5 ++--- .../tool-errors/resource-compiler-warning-rc4005.md | 5 ++--- .../tool-errors/resource-compiler-warning-rc4093.md | 5 ++--- .../tool-errors/resource-compiler-warning-rc4214.md | 5 ++--- 4 files changed, 8 insertions(+), 12 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md index 05c0e9d7fe2..e85fed2d962 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Warning RC4002" title: "Resource Compiler Warning RC4002" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RC4002" +ms.date: 11/04/2016 f1_keywords: ["RC4002"] helpviewer_keywords: ["RC4002"] -ms.assetid: a157bc55-1a75-4337-aee4-e2ba61ff8cfa --- # Resource Compiler Warning RC4002 diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md index db2b29364a9..fba7a496464 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Warning RC4005" title: "Resource Compiler Warning RC4005" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RC4005" +ms.date: 11/04/2016 f1_keywords: ["RC4005"] helpviewer_keywords: ["RC4005"] -ms.assetid: 71f03b4a-c9a9-415d-920f-bf2e58507f93 --- # Resource Compiler Warning RC4005 diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md index 5a18bbfc430..a5729c8a6bf 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Warning RC4093" title: "Resource Compiler Warning RC4093" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RC4093" +ms.date: 11/04/2016 f1_keywords: ["RC4093"] helpviewer_keywords: ["RC4093"] -ms.assetid: 3c61b4a4-b418-465b-a4fd-cb1ff0adb8dd --- # Resource Compiler Warning RC4093 diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md index 9695f81a2b3..e8612428191 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Warning RC4214" title: "Resource Compiler Warning RC4214" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RC4214" +ms.date: 11/04/2016 f1_keywords: ["RC4214"] helpviewer_keywords: ["RC4214"] -ms.assetid: 79a8bf0d-8cc7-4159-a6a2-d0e543749069 --- # Resource Compiler Warning RC4214 From 285b4cbb776764ba8420be8a633e76120196c1c3 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 22:17:45 +0800 Subject: [PATCH 1216/1799] Add blockquotes for warning messages in range [RW4001, RW4004] --- .../tool-errors/resource-compiler-warning-rw4001.md | 2 +- .../tool-errors/resource-compiler-warning-rw4003.md | 2 +- .../tool-errors/resource-compiler-warning-rw4004.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md index 1218c5f7b8a..72251fa375f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md @@ -8,6 +8,6 @@ ms.assetid: 7c2d35eb-9899-46f5-848d-7ef49c39d706 --- # Resource Compiler Warning RW4001 -.EXE processing options (/L /M /P /T /K /E /31 or /30) +> .EXE processing options (/L /M /P /T /K /E /31 or /30) You specified EXE processing options, but there was no executable file to process. Don't use these options with a .res file. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md index 2ff11e08bfe..9a0c856ab43 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md @@ -8,6 +8,6 @@ ms.assetid: e9c289f2-c065-4f26-bc24-991953742abc --- # Resource Compiler Warning RW4003 -SHIFT or CONTROL used without VIRTKEY +> SHIFT or CONTROL used without VIRTKEY In an accelerator table resource, SHIFT or CONTROL requires VIRTKEY. Because SHIFT and CONTROL are indicated as flag bits in a VIRTKEY type accelerator, they cannot exist independent from a VIRTKEY. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md index 16d53e49d0d..f889e2a0453 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md @@ -8,7 +8,7 @@ ms.assetid: 596b6a89-9ce7-4ba7-bdcb-e8054c7efafa --- # Resource Compiler Warning RW4004 -ASCII character not equivalent to virtual key code +> ASCII character not equivalent to virtual key code A string literal was used for the virtual key code in a VIRTKEY type accelerator. From 177feb6d33e959372a971eb00dba89a0ba935970 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 22:19:04 +0800 Subject: [PATCH 1217/1799] Add "Remarks" headings for warning references in range [RW4001, RW4004] --- .../tool-errors/resource-compiler-warning-rw4001.md | 2 ++ .../tool-errors/resource-compiler-warning-rw4003.md | 2 ++ .../tool-errors/resource-compiler-warning-rw4004.md | 2 ++ 3 files changed, 6 insertions(+) diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md index 72251fa375f..1f330099575 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md @@ -10,4 +10,6 @@ ms.assetid: 7c2d35eb-9899-46f5-848d-7ef49c39d706 > .EXE processing options (/L /M /P /T /K /E /31 or /30) +## Remarks + You specified EXE processing options, but there was no executable file to process. Don't use these options with a .res file. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md index 9a0c856ab43..28f060bcadf 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md @@ -10,4 +10,6 @@ ms.assetid: e9c289f2-c065-4f26-bc24-991953742abc > SHIFT or CONTROL used without VIRTKEY +## Remarks + In an accelerator table resource, SHIFT or CONTROL requires VIRTKEY. Because SHIFT and CONTROL are indicated as flag bits in a VIRTKEY type accelerator, they cannot exist independent from a VIRTKEY. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md index f889e2a0453..b8cee421676 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md @@ -10,6 +10,8 @@ ms.assetid: 596b6a89-9ce7-4ba7-bdcb-e8054c7efafa > ASCII character not equivalent to virtual key code +## Remarks + A string literal was used for the virtual key code in a VIRTKEY type accelerator. This warning allows you to continue, but be aware that the accelerator keys generated may not match the string you indicated. (VIRTKEYs use different key codes than ASCII accelerators.) From 405cb1353035256ae6888c47a7167f4da9e08e57 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 16 Sep 2025 22:19:53 +0800 Subject: [PATCH 1218/1799] Update metadata for warning references in range [RW4001, RW4004] --- .../tool-errors/resource-compiler-warning-rw4001.md | 5 ++--- .../tool-errors/resource-compiler-warning-rw4003.md | 5 ++--- .../tool-errors/resource-compiler-warning-rw4004.md | 5 ++--- 3 files changed, 6 insertions(+), 9 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md index 1f330099575..e800d8c2c8b 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Warning RW4001" title: "Resource Compiler Warning RW4001" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RW4001" +ms.date: 11/04/2016 f1_keywords: ["RW4001"] helpviewer_keywords: ["RW4001"] -ms.assetid: 7c2d35eb-9899-46f5-848d-7ef49c39d706 --- # Resource Compiler Warning RW4001 diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md index 28f060bcadf..5d5c68ffcc1 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Warning RW4003" title: "Resource Compiler Warning RW4003" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RW4003" +ms.date: 11/04/2016 f1_keywords: ["RW4003"] helpviewer_keywords: ["RW4003"] -ms.assetid: e9c289f2-c065-4f26-bc24-991953742abc --- # Resource Compiler Warning RW4003 diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md index b8cee421676..e54b5ee855d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Resource Compiler Warning RW4004" title: "Resource Compiler Warning RW4004" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RW4004" +ms.date: 11/04/2016 f1_keywords: ["RW4004"] helpviewer_keywords: ["RW4004"] -ms.assetid: 596b6a89-9ce7-4ba7-bdcb-e8054c7efafa --- # Resource Compiler Warning RW4004 From 4171a71cbc8ea66b1ee99ab31f4e804f50633a0c Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 16 Sep 2025 12:03:51 -0700 Subject: [PATCH 1219/1799] Note that the state of ASan shadow bytes is 'addressable' (#6084) * Note that the state of ASan shadow bytes is 'addressable' * typo: populate -> populated --- docs/sanitizers/asan-shadow-bytes.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/sanitizers/asan-shadow-bytes.md b/docs/sanitizers/asan-shadow-bytes.md index a4d57f7c9f0..a59597629b8 100644 --- a/docs/sanitizers/asan-shadow-bytes.md +++ b/docs/sanitizers/asan-shadow-bytes.md @@ -19,6 +19,9 @@ One shadow byte describes how many bytes are currently accessible as follows: - 1-7 means one to seven bytes - Negative numbers encode context for the runtime to use for reporting diagnostics. +> [!NOTE] +> By default, entries in the shadow memory are zero-initialized. Therefore, ASan assumes that the memory is _addressable_ by default, i.e. valid to read and write. The shadow bytes will be populated with non-zero values as the program executes and the lifetime of variables and other allocations come to an end. + ### Shadow byte legend Consider this shadow byte legend where all negative numbers are defined: From 478f714c40df8368104c0ec786bcfe556f994b92 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 16:28:16 +0800 Subject: [PATCH 1220/1799] Add blockquotes for error messages in range [CVT1100, CVT1105] --- docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md | 2 +- docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md | 2 +- docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md index d4f1ee842da..fc18b169b5e 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md @@ -8,7 +8,7 @@ ms.assetid: 886e88dd-5818-4b5f-84f2-d2a3d75f0aaf --- # CVTRES Fatal Error CVT1100 -duplicate resource — type:type, name:name, language:language, flags:flags, size:size +> duplicate resource — type:type, name:name, language:language, flags:flags, size:size The given resource was specified more than once. diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md index 5ca0766f957..e2e3d80586c 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md @@ -8,7 +8,7 @@ ms.assetid: 5ba5f44c-c3c3-4861-92c5-13c51ee667ef --- # CVTRES Fatal Error CVT1103 -cannot read filename +> cannot read filename An unrecoverable error occurred when CVTRES attempted to read the given file. diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md index bc43ec10d2a..36135ce39a3 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md @@ -8,7 +8,7 @@ ms.assetid: 6fb98e2b-836e-4e1e-9bd8-4e1465ad4e85 --- # CVTRES Fatal Error CVT1105 -cannot seek in file +> cannot seek in file CVTRES could not go to a location in the file. From 8b3b6ee8c08ba6c1f3ddf12b95befc2cd8d5af52 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 16:29:19 +0800 Subject: [PATCH 1221/1799] Add "Remarks" headings for error references in range [CVT1100, CVT1105] --- docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md | 2 ++ docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md | 2 ++ docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md | 2 ++ 3 files changed, 6 insertions(+) diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md index fc18b169b5e..2e538d4365b 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md @@ -10,6 +10,8 @@ ms.assetid: 886e88dd-5818-4b5f-84f2-d2a3d75f0aaf > duplicate resource — type:type, name:name, language:language, flags:flags, size:size +## Remarks + The given resource was specified more than once. You can get this error if the linker is creating a type library and you did not specify [/TLBID](../../build/reference/tlbid-specify-resource-id-for-typelib.md) and a resource in your project already uses 1. In this case, specify /TLBID and specify another number up to 65535. diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md index e2e3d80586c..3e2c0498233 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md @@ -10,6 +10,8 @@ ms.assetid: 5ba5f44c-c3c3-4861-92c5-13c51ee667ef > cannot read filename +## Remarks + An unrecoverable error occurred when CVTRES attempted to read the given file. This error can be caused by file corruption. diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md index 36135ce39a3..b6972c69657 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md @@ -10,6 +10,8 @@ ms.assetid: 6fb98e2b-836e-4e1e-9bd8-4e1465ad4e85 > cannot seek in file +## Remarks + CVTRES could not go to a location in the file. This error can be caused by file corruption. From d692a428b7e109768a36b59a0c735319ff641d39 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 16:30:40 +0800 Subject: [PATCH 1222/1799] Update metadata for error references in range [CVT1100, CVT1105] --- .../error-messages/tool-errors/cvtres-fatal-error-cvt1100.md | 5 ++--- .../error-messages/tool-errors/cvtres-fatal-error-cvt1103.md | 5 ++--- .../error-messages/tool-errors/cvtres-fatal-error-cvt1105.md | 5 ++--- 3 files changed, 6 insertions(+), 9 deletions(-) diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md index 2e538d4365b..29fd15d3c3d 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CVTRES Fatal Error CVT1100" title: "CVTRES Fatal Error CVT1100" -ms.date: "11/04/2016" +description: "Learn more about: CVTRES Fatal Error CVT1100" +ms.date: 11/04/2016 f1_keywords: ["CVT1100"] helpviewer_keywords: ["CVT1100"] -ms.assetid: 886e88dd-5818-4b5f-84f2-d2a3d75f0aaf --- # CVTRES Fatal Error CVT1100 diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md index 3e2c0498233..b73038b1032 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CVTRES Fatal Error CVT1103" title: "CVTRES Fatal Error CVT1103" -ms.date: "11/04/2016" +description: "Learn more about: CVTRES Fatal Error CVT1103" +ms.date: 11/04/2016 f1_keywords: ["CVT1103"] helpviewer_keywords: ["CVT1103"] -ms.assetid: 5ba5f44c-c3c3-4861-92c5-13c51ee667ef --- # CVTRES Fatal Error CVT1103 diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md index b6972c69657..8bedfeeb3eb 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CVTRES Fatal Error CVT1105" title: "CVTRES Fatal Error CVT1105" -ms.date: "11/04/2016" +description: "Learn more about: CVTRES Fatal Error CVT1105" +ms.date: 11/04/2016 f1_keywords: ["CVT1105"] helpviewer_keywords: ["CVT1105"] -ms.assetid: 6fb98e2b-836e-4e1e-9bd8-4e1465ad4e85 --- # CVTRES Fatal Error CVT1105 From 04c64c1c636469e3f6e6c7cbf96c1351d443f499 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 17:11:47 +0800 Subject: [PATCH 1223/1799] Add missing word "by" in `` header reference --- docs/standard-library/stdexcept.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/stdexcept.md b/docs/standard-library/stdexcept.md index 6ad13bbc2dd..72b7568ba35 100644 --- a/docs/standard-library/stdexcept.md +++ b/docs/standard-library/stdexcept.md @@ -8,7 +8,7 @@ ms.assetid: 495c10b1-1e60-4514-9f8f-7fda11a2f522 --- # `` -Defines several standard classes used for reporting exceptions. The classes form a derivation hierarchy all derived from class [exception](../standard-library/exception-class.md) and include two general types of exceptions: logical errors and run-time errors. The logical errors are caused programmer mistakes. They derive from the base class logic_error and include: +Defines several standard classes used for reporting exceptions. The classes form a derivation hierarchy all derived from class [exception](../standard-library/exception-class.md) and include two general types of exceptions: logical errors and run-time errors. The logical errors are caused by programmer mistakes. They derive from the base class logic_error and include: - `domain_error` From 7760f6f365ac3200056888ceaa11f8514942d1f2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 17:14:10 +0800 Subject: [PATCH 1224/1799] Add backticks in `` header reference --- docs/standard-library/stdexcept.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/standard-library/stdexcept.md b/docs/standard-library/stdexcept.md index 72b7568ba35..df927d32130 100644 --- a/docs/standard-library/stdexcept.md +++ b/docs/standard-library/stdexcept.md @@ -8,7 +8,7 @@ ms.assetid: 495c10b1-1e60-4514-9f8f-7fda11a2f522 --- # `` -Defines several standard classes used for reporting exceptions. The classes form a derivation hierarchy all derived from class [exception](../standard-library/exception-class.md) and include two general types of exceptions: logical errors and run-time errors. The logical errors are caused by programmer mistakes. They derive from the base class logic_error and include: +Defines several standard classes used for reporting exceptions. The classes form a derivation hierarchy all derived from class [`exception`](../standard-library/exception-class.md) and include two general types of exceptions: logical errors and run-time errors. The logical errors are caused by programmer mistakes. They derive from the base class `logic_error` and include: - `domain_error` @@ -18,7 +18,7 @@ Defines several standard classes used for reporting exceptions. The classes form - `out_of_range` -The run-time errors occur because of mistakes in either the library functions or in the run-time system. They derive from the base class runtime_error and include: +The run-time errors occur because of mistakes in either the library functions or in the run-time system. They derive from the base class `runtime_error` and include: - `overflow_error` @@ -30,15 +30,15 @@ The run-time errors occur because of mistakes in either the library functions or |Class|Description| |-|-| -|[domain_error Class](../standard-library/domain-error-class.md)|The class serves as the base class for all exceptions thrown to report a domain error.| -|[invalid_argument Class](../standard-library/invalid-argument-class.md)|The class serves as the base class for all exceptions thrown to report an invalid argument.| -|[length_error Class](../standard-library/length-error-class.md)|The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified.| -|[logic_error Class](../standard-library/logic-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions.| -|[out_of_range Class](../standard-library/out-of-range-class.md)|The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range.| -|[overflow_error Class](../standard-library/overflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic overflow.| -|[range_error Class](../standard-library/range-error-class.md)|The class serves as the base class for all exceptions thrown to report a range error.| -|[runtime_error Class](../standard-library/runtime-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes.| -|[underflow_error Class](../standard-library/underflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic underflow.| +|[`domain_error` Class](../standard-library/domain-error-class.md)|The class serves as the base class for all exceptions thrown to report a domain error.| +|[`invalid_argument` Class](../standard-library/invalid-argument-class.md)|The class serves as the base class for all exceptions thrown to report an invalid argument.| +|[`length_error` Class](../standard-library/length-error-class.md)|The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified.| +|[`logic_error` Class](../standard-library/logic-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions.| +|[`out_of_range` Class](../standard-library/out-of-range-class.md)|The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range.| +|[`overflow_error` Class](../standard-library/overflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic overflow.| +|[`range_error` Class](../standard-library/range-error-class.md)|The class serves as the base class for all exceptions thrown to report a range error.| +|[`runtime_error` Class](../standard-library/runtime-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes.| +|[`underflow_error` Class](../standard-library/underflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic underflow.| ## See also From 87e714a6225c798689b033462fb0835e8940fc3a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 17:17:12 +0800 Subject: [PATCH 1225/1799] Compact unordered lists and remove capitalization of "Class" in `` header reference --- docs/standard-library/stdexcept.md | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/docs/standard-library/stdexcept.md b/docs/standard-library/stdexcept.md index df927d32130..6189de4fdb9 100644 --- a/docs/standard-library/stdexcept.md +++ b/docs/standard-library/stdexcept.md @@ -11,34 +11,29 @@ ms.assetid: 495c10b1-1e60-4514-9f8f-7fda11a2f522 Defines several standard classes used for reporting exceptions. The classes form a derivation hierarchy all derived from class [`exception`](../standard-library/exception-class.md) and include two general types of exceptions: logical errors and run-time errors. The logical errors are caused by programmer mistakes. They derive from the base class `logic_error` and include: - `domain_error` - - `invalid_argument` - - `length_error` - - `out_of_range` The run-time errors occur because of mistakes in either the library functions or in the run-time system. They derive from the base class `runtime_error` and include: - `overflow_error` - - `range_error` - - `underflow_error` ### Classes |Class|Description| |-|-| -|[`domain_error` Class](../standard-library/domain-error-class.md)|The class serves as the base class for all exceptions thrown to report a domain error.| -|[`invalid_argument` Class](../standard-library/invalid-argument-class.md)|The class serves as the base class for all exceptions thrown to report an invalid argument.| -|[`length_error` Class](../standard-library/length-error-class.md)|The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified.| -|[`logic_error` Class](../standard-library/logic-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions.| -|[`out_of_range` Class](../standard-library/out-of-range-class.md)|The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range.| -|[`overflow_error` Class](../standard-library/overflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic overflow.| -|[`range_error` Class](../standard-library/range-error-class.md)|The class serves as the base class for all exceptions thrown to report a range error.| -|[`runtime_error` Class](../standard-library/runtime-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes.| -|[`underflow_error` Class](../standard-library/underflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic underflow.| +|[`domain_error` class](../standard-library/domain-error-class.md)|The class serves as the base class for all exceptions thrown to report a domain error.| +|[`invalid_argument` class](../standard-library/invalid-argument-class.md)|The class serves as the base class for all exceptions thrown to report an invalid argument.| +|[`length_error` class](../standard-library/length-error-class.md)|The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified.| +|[`logic_error` class](../standard-library/logic-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions.| +|[`out_of_range` class](../standard-library/out-of-range-class.md)|The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range.| +|[`overflow_error` class](../standard-library/overflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic overflow.| +|[`range_error` class](../standard-library/range-error-class.md)|The class serves as the base class for all exceptions thrown to report a range error.| +|[`runtime_error` class](../standard-library/runtime-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes.| +|[`underflow_error` class](../standard-library/underflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic underflow.| ## See also From cefc1539da297e7a8269014324dbbf167d0799c3 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 17:23:02 +0800 Subject: [PATCH 1226/1799] Simplify redundant relative links in `` header reference --- docs/standard-library/stdexcept.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/standard-library/stdexcept.md b/docs/standard-library/stdexcept.md index 6189de4fdb9..52f34560afc 100644 --- a/docs/standard-library/stdexcept.md +++ b/docs/standard-library/stdexcept.md @@ -8,7 +8,7 @@ ms.assetid: 495c10b1-1e60-4514-9f8f-7fda11a2f522 --- # `` -Defines several standard classes used for reporting exceptions. The classes form a derivation hierarchy all derived from class [`exception`](../standard-library/exception-class.md) and include two general types of exceptions: logical errors and run-time errors. The logical errors are caused by programmer mistakes. They derive from the base class `logic_error` and include: +Defines several standard classes used for reporting exceptions. The classes form a derivation hierarchy all derived from class [`exception`](exception-class.md) and include two general types of exceptions: logical errors and run-time errors. The logical errors are caused by programmer mistakes. They derive from the base class `logic_error` and include: - `domain_error` - `invalid_argument` @@ -25,17 +25,17 @@ The run-time errors occur because of mistakes in either the library functions or |Class|Description| |-|-| -|[`domain_error` class](../standard-library/domain-error-class.md)|The class serves as the base class for all exceptions thrown to report a domain error.| -|[`invalid_argument` class](../standard-library/invalid-argument-class.md)|The class serves as the base class for all exceptions thrown to report an invalid argument.| -|[`length_error` class](../standard-library/length-error-class.md)|The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified.| -|[`logic_error` class](../standard-library/logic-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions.| -|[`out_of_range` class](../standard-library/out-of-range-class.md)|The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range.| -|[`overflow_error` class](../standard-library/overflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic overflow.| -|[`range_error` class](../standard-library/range-error-class.md)|The class serves as the base class for all exceptions thrown to report a range error.| -|[`runtime_error` class](../standard-library/runtime-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes.| -|[`underflow_error` class](../standard-library/underflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic underflow.| +|[`domain_error` class](domain-error-class.md)|The class serves as the base class for all exceptions thrown to report a domain error.| +|[`invalid_argument` class](invalid-argument-class.md)|The class serves as the base class for all exceptions thrown to report an invalid argument.| +|[`length_error` class](length-error-class.md)|The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified.| +|[`logic_error` class](logic-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions.| +|[`out_of_range` class](out-of-range-class.md)|The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range.| +|[`overflow_error` class](overflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic overflow.| +|[`range_error` class](range-error-class.md)|The class serves as the base class for all exceptions thrown to report a range error.| +|[`runtime_error` class](runtime-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes.| +|[`underflow_error` class](underflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic underflow.| ## See also -[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[Header Files Reference](cpp-standard-library-header-files.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) From 974ceb7001286f9b25f2fb33d1f2651e8c2abd43 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 17:23:56 +0800 Subject: [PATCH 1227/1799] Update metadata in `` header reference --- docs/standard-library/stdexcept.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/stdexcept.md b/docs/standard-library/stdexcept.md index 52f34560afc..ac7cf23aeb6 100644 --- a/docs/standard-library/stdexcept.md +++ b/docs/standard-library/stdexcept.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["stdexcept header"] -ms.assetid: 495c10b1-1e60-4514-9f8f-7fda11a2f522 --- # `` From deab1743de33abfd718c4e47e80e7d0336a33b1a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 17:45:20 +0800 Subject: [PATCH 1228/1799] Add backticks in all `` class references --- docs/standard-library/domain-error-class.md | 8 ++++---- docs/standard-library/invalid-argument-class.md | 8 ++++---- docs/standard-library/length-error-class.md | 8 ++++---- docs/standard-library/logic-error-class.md | 8 ++++---- docs/standard-library/out-of-range-class.md | 8 ++++---- docs/standard-library/overflow-error-class.md | 8 ++++---- docs/standard-library/range-error-class.md | 10 +++++----- docs/standard-library/runtime-error-class.md | 8 ++++---- docs/standard-library/underflow-error-class.md | 8 ++++---- 9 files changed, 37 insertions(+), 37 deletions(-) diff --git a/docs/standard-library/domain-error-class.md b/docs/standard-library/domain-error-class.md index fe6bc72dfe1..18a25cccfcf 100644 --- a/docs/standard-library/domain-error-class.md +++ b/docs/standard-library/domain-error-class.md @@ -6,7 +6,7 @@ f1_keywords: ["stdexcept/std::domain_error"] helpviewer_keywords: ["domain_error class"] ms.assetid: a1d8245d-61c2-4d1e-973f-073bd5dd5fa3 --- -# domain_error Class +# `domain_error` Class The class serves as the base class for all exceptions thrown to report a domain error (as in mathematics, not networking). @@ -59,11 +59,11 @@ Type: class std::domain_error ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[logic_error Class](../standard-library/logic-error-class.md)\ +[`logic_error` Class](../standard-library/logic-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/invalid-argument-class.md b/docs/standard-library/invalid-argument-class.md index 9a3babf927a..e6034d84aef 100644 --- a/docs/standard-library/invalid-argument-class.md +++ b/docs/standard-library/invalid-argument-class.md @@ -6,7 +6,7 @@ f1_keywords: ["stdexcept/std::invalid_argument"] helpviewer_keywords: ["invalid_argument class"] ms.assetid: af6c227d-ad7c-4e63-9dee-67af81d83506 --- -# invalid_argument Class +# `invalid_argument` Class The class serves as the base class for all exceptions thrown to report an invalid argument. @@ -57,11 +57,11 @@ Type: class std::invalid_argument ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[logic_error Class](../standard-library/logic-error-class.md)\ +[`logic_error` Class](../standard-library/logic-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/length-error-class.md b/docs/standard-library/length-error-class.md index 7df63ed20bc..30721427a42 100644 --- a/docs/standard-library/length-error-class.md +++ b/docs/standard-library/length-error-class.md @@ -6,7 +6,7 @@ f1_keywords: ["stdexcept/std::length_error"] helpviewer_keywords: ["length_error class"] ms.assetid: d53c46c5-4626-400d-bd76-bf3e1e0f64ae --- -# length_error Class +# `length_error` Class The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified. @@ -58,11 +58,11 @@ Type: class std::length_error ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[logic_error Class](../standard-library/logic-error-class.md)\ +[`logic_error` Class](../standard-library/logic-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/logic-error-class.md b/docs/standard-library/logic-error-class.md index 63f9e82219b..eafaee25958 100644 --- a/docs/standard-library/logic-error-class.md +++ b/docs/standard-library/logic-error-class.md @@ -6,7 +6,7 @@ f1_keywords: ["stdexcept/std::logic_error"] helpviewer_keywords: ["logic_error class"] ms.assetid: b290d73d-94e1-4288-af86-2bb5d71f677a --- -# logic_error Class +# `logic_error` Class The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions. @@ -57,11 +57,11 @@ Type: class std::logic_error ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[exception Class](../standard-library/exception-class.md)\ +[`exception` Class](../standard-library/exception-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/out-of-range-class.md b/docs/standard-library/out-of-range-class.md index 0fb2d3cb673..6558b9baffe 100644 --- a/docs/standard-library/out-of-range-class.md +++ b/docs/standard-library/out-of-range-class.md @@ -6,7 +6,7 @@ f1_keywords: ["stdexcept/std::out_of_range"] helpviewer_keywords: ["out_of_range class"] ms.assetid: d0e14dc0-065e-4666-9ac9-51e52223c503 --- -# out_of_range Class +# `out_of_range` Class The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range. @@ -60,11 +60,11 @@ Type: class std::out_of_range ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[logic_error Class](../standard-library/logic-error-class.md)\ +[`logic_error` Class](../standard-library/logic-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/overflow-error-class.md b/docs/standard-library/overflow-error-class.md index 0ba3c520d48..6744f7ab4de 100644 --- a/docs/standard-library/overflow-error-class.md +++ b/docs/standard-library/overflow-error-class.md @@ -6,7 +6,7 @@ f1_keywords: ["stdexcept/std::overflow_error"] helpviewer_keywords: ["overflow_error class"] ms.assetid: bae7128d-e36b-4a45-84f1-2f89da441d20 --- -# overflow_error Class +# `overflow_error` Class The class serves as the base class for all exceptions thrown to report an arithmetic overflow. @@ -60,11 +60,11 @@ Type: class std::overflow_error ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[runtime_error Class](../standard-library/runtime-error-class.md)\ +[`runtime_error` Class](../standard-library/runtime-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/range-error-class.md b/docs/standard-library/range-error-class.md index a8b6485bcf3..51632bec296 100644 --- a/docs/standard-library/range-error-class.md +++ b/docs/standard-library/range-error-class.md @@ -6,7 +6,7 @@ f1_keywords: ["stdexcept/std::range_error"] helpviewer_keywords: ["range_error class"] ms.assetid: 8afb3e88-fc49-4213-b096-ed63d7aea37c --- -# range_error Class +# `range_error` Class The class serves as the base class for all exceptions thrown to report a range error (as in mathematics, not iterators). @@ -22,7 +22,7 @@ public: ## Remarks -The value returned by [what](../standard-library/exception-class.md) is a copy of `message.data()`. For more information, see [basic_string::data](../standard-library/basic-string-class.md#data). +The value returned by [`what`](../standard-library/exception-class.md) is a copy of `message.data()`. For more information, see [`basic_string::data`](../standard-library/basic-string-class.md#data). ## Example @@ -55,11 +55,11 @@ Type: class std::range_error ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[runtime_error Class](../standard-library/runtime-error-class.md)\ +[`runtime_error` Class](../standard-library/runtime-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/runtime-error-class.md b/docs/standard-library/runtime-error-class.md index e71e28e5ddf..e3281edc1df 100644 --- a/docs/standard-library/runtime-error-class.md +++ b/docs/standard-library/runtime-error-class.md @@ -6,7 +6,7 @@ f1_keywords: ["stdexcept/std::runtime_error"] helpviewer_keywords: ["runtime_error class"] ms.assetid: 4d0227bf-847b-45a2-a320-2351ebf98368 --- -# runtime_error Class +# `runtime_error` Class The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes. @@ -57,11 +57,11 @@ Type: class std::runtime_error ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[exception Class](../standard-library/exception-class.md)\ +[`exception` Class](../standard-library/exception-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/underflow-error-class.md b/docs/standard-library/underflow-error-class.md index eee569a3f7b..fb27348ae17 100644 --- a/docs/standard-library/underflow-error-class.md +++ b/docs/standard-library/underflow-error-class.md @@ -6,7 +6,7 @@ f1_keywords: ["stdexcept/std::underflow_error"] helpviewer_keywords: ["underflow_error class"] ms.assetid: d632f1f9-9c6c-4954-b96b-03041bfab22d --- -# underflow_error Class +# `underflow_error` Class The class serves as the base class for all exceptions thrown to report an arithmetic underflow. @@ -59,11 +59,11 @@ Type: class std::underflow_error ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[runtime_error Class](../standard-library/runtime-error-class.md)\ +[`runtime_error` Class](../standard-library/runtime-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) From af365e4c78cf6b18a20e381f9c8f7aa200126809 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 17:54:04 +0800 Subject: [PATCH 1229/1799] Split output into another code block for all `` class references --- docs/standard-library/domain-error-class.md | 5 +++-- docs/standard-library/invalid-argument-class.md | 5 +++-- docs/standard-library/length-error-class.md | 5 +++-- docs/standard-library/logic-error-class.md | 5 +++-- docs/standard-library/out-of-range-class.md | 5 +++-- docs/standard-library/overflow-error-class.md | 5 +++-- docs/standard-library/range-error-class.md | 5 +++-- docs/standard-library/runtime-error-class.md | 5 +++-- docs/standard-library/underflow-error-class.md | 5 +++-- 9 files changed, 27 insertions(+), 18 deletions(-) diff --git a/docs/standard-library/domain-error-class.md b/docs/standard-library/domain-error-class.md index 18a25cccfcf..1affd02c32a 100644 --- a/docs/standard-library/domain-error-class.md +++ b/docs/standard-library/domain-error-class.md @@ -51,10 +51,11 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: Your domain is in error! Type: class std::domain_error -*/ ``` ## Requirements diff --git a/docs/standard-library/invalid-argument-class.md b/docs/standard-library/invalid-argument-class.md index e6034d84aef..6cfa99b7da6 100644 --- a/docs/standard-library/invalid-argument-class.md +++ b/docs/standard-library/invalid-argument-class.md @@ -49,10 +49,11 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: invalid bitset char Type: class std::invalid_argument -*/ ``` ## Requirements diff --git a/docs/standard-library/length-error-class.md b/docs/standard-library/length-error-class.md index 30721427a42..f340c17be62 100644 --- a/docs/standard-library/length-error-class.md +++ b/docs/standard-library/length-error-class.md @@ -50,10 +50,11 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: vector too long Type: class std::length_error -*/ ``` ## Requirements diff --git a/docs/standard-library/logic-error-class.md b/docs/standard-library/logic-error-class.md index eafaee25958..032ba515aba 100644 --- a/docs/standard-library/logic-error-class.md +++ b/docs/standard-library/logic-error-class.md @@ -49,10 +49,11 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: Does not compute! Type: class std::logic_error -*/ ``` ## Requirements diff --git a/docs/standard-library/out-of-range-class.md b/docs/standard-library/out-of-range-class.md index 6558b9baffe..4094107ab89 100644 --- a/docs/standard-library/out-of-range-class.md +++ b/docs/standard-library/out-of-range-class.md @@ -52,10 +52,11 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: invalid string position Type: class std::out_of_range -*/ ``` ## Requirements diff --git a/docs/standard-library/overflow-error-class.md b/docs/standard-library/overflow-error-class.md index 6744f7ab4de..d5193d7df92 100644 --- a/docs/standard-library/overflow-error-class.md +++ b/docs/standard-library/overflow-error-class.md @@ -52,10 +52,11 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: bitset overflow Type: class std::overflow_error -*/ ``` ## Requirements diff --git a/docs/standard-library/range-error-class.md b/docs/standard-library/range-error-class.md index 51632bec296..c7471ab1571 100644 --- a/docs/standard-library/range-error-class.md +++ b/docs/standard-library/range-error-class.md @@ -47,10 +47,11 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: The range is in error! Type: class std::range_error -*/ ``` ## Requirements diff --git a/docs/standard-library/runtime-error-class.md b/docs/standard-library/runtime-error-class.md index e3281edc1df..a5367a1a939 100644 --- a/docs/standard-library/runtime-error-class.md +++ b/docs/standard-library/runtime-error-class.md @@ -49,10 +49,11 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: bad locale name Type: class std::runtime_error -*/ ``` ## Requirements diff --git a/docs/standard-library/underflow-error-class.md b/docs/standard-library/underflow-error-class.md index fb27348ae17..9f5e9ae9bfb 100644 --- a/docs/standard-library/underflow-error-class.md +++ b/docs/standard-library/underflow-error-class.md @@ -51,10 +51,11 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: The number's a bit small, captain! Type: class std::underflow_error -*/ ``` ## Requirements From 78718da229b64ee12a8d05c0e4805ef4d75cad93 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 17:56:48 +0800 Subject: [PATCH 1230/1799] Change "Class" to "class" in all `` class references --- docs/standard-library/domain-error-class.md | 8 ++++---- docs/standard-library/invalid-argument-class.md | 8 ++++---- docs/standard-library/length-error-class.md | 8 ++++---- docs/standard-library/logic-error-class.md | 8 ++++---- docs/standard-library/out-of-range-class.md | 8 ++++---- docs/standard-library/overflow-error-class.md | 8 ++++---- docs/standard-library/range-error-class.md | 8 ++++---- docs/standard-library/runtime-error-class.md | 8 ++++---- docs/standard-library/underflow-error-class.md | 8 ++++---- 9 files changed, 36 insertions(+), 36 deletions(-) diff --git a/docs/standard-library/domain-error-class.md b/docs/standard-library/domain-error-class.md index 1affd02c32a..deecb530dd2 100644 --- a/docs/standard-library/domain-error-class.md +++ b/docs/standard-library/domain-error-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: domain_error Class" -title: "domain_error Class" +description: "Learn more about: domain_error class" +title: "domain_error class" ms.date: "09/09/2021" f1_keywords: ["stdexcept/std::domain_error"] helpviewer_keywords: ["domain_error class"] ms.assetid: a1d8245d-61c2-4d1e-973f-073bd5dd5fa3 --- -# `domain_error` Class +# `domain_error` class The class serves as the base class for all exceptions thrown to report a domain error (as in mathematics, not networking). @@ -66,5 +66,5 @@ Type: class std::domain_error ## See also -[`logic_error` Class](../standard-library/logic-error-class.md)\ +[`logic_error` class](../standard-library/logic-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/invalid-argument-class.md b/docs/standard-library/invalid-argument-class.md index 6cfa99b7da6..4243101510d 100644 --- a/docs/standard-library/invalid-argument-class.md +++ b/docs/standard-library/invalid-argument-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: invalid_argument Class" -title: "invalid_argument Class" +description: "Learn more about: invalid_argument class" +title: "invalid_argument class" ms.date: "09/09/2021" f1_keywords: ["stdexcept/std::invalid_argument"] helpviewer_keywords: ["invalid_argument class"] ms.assetid: af6c227d-ad7c-4e63-9dee-67af81d83506 --- -# `invalid_argument` Class +# `invalid_argument` class The class serves as the base class for all exceptions thrown to report an invalid argument. @@ -64,5 +64,5 @@ Type: class std::invalid_argument ## See also -[`logic_error` Class](../standard-library/logic-error-class.md)\ +[`logic_error` class](../standard-library/logic-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/length-error-class.md b/docs/standard-library/length-error-class.md index f340c17be62..93a9ea92de4 100644 --- a/docs/standard-library/length-error-class.md +++ b/docs/standard-library/length-error-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: length_error Class" -title: "length_error Class" +description: "Learn more about: length_error class" +title: "length_error class" ms.date: "09/09/2021" f1_keywords: ["stdexcept/std::length_error"] helpviewer_keywords: ["length_error class"] ms.assetid: d53c46c5-4626-400d-bd76-bf3e1e0f64ae --- -# `length_error` Class +# `length_error` class The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified. @@ -65,5 +65,5 @@ Type: class std::length_error ## See also -[`logic_error` Class](../standard-library/logic-error-class.md)\ +[`logic_error` class](../standard-library/logic-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/logic-error-class.md b/docs/standard-library/logic-error-class.md index 032ba515aba..957f80c7b2b 100644 --- a/docs/standard-library/logic-error-class.md +++ b/docs/standard-library/logic-error-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: logic_error Class" -title: "logic_error Class" +description: "Learn more about: logic_error class" +title: "logic_error class" ms.date: "09/09/2021" f1_keywords: ["stdexcept/std::logic_error"] helpviewer_keywords: ["logic_error class"] ms.assetid: b290d73d-94e1-4288-af86-2bb5d71f677a --- -# `logic_error` Class +# `logic_error` class The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions. @@ -64,5 +64,5 @@ Type: class std::logic_error ## See also -[`exception` Class](../standard-library/exception-class.md)\ +[`exception` class](../standard-library/exception-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/out-of-range-class.md b/docs/standard-library/out-of-range-class.md index 4094107ab89..98f8ffd101d 100644 --- a/docs/standard-library/out-of-range-class.md +++ b/docs/standard-library/out-of-range-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: out_of_range Class" -title: "out_of_range Class" +description: "Learn more about: out_of_range class" +title: "out_of_range class" ms.date: "09/09/2021" f1_keywords: ["stdexcept/std::out_of_range"] helpviewer_keywords: ["out_of_range class"] ms.assetid: d0e14dc0-065e-4666-9ac9-51e52223c503 --- -# `out_of_range` Class +# `out_of_range` class The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range. @@ -67,5 +67,5 @@ Type: class std::out_of_range ## See also -[`logic_error` Class](../standard-library/logic-error-class.md)\ +[`logic_error` class](../standard-library/logic-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/overflow-error-class.md b/docs/standard-library/overflow-error-class.md index d5193d7df92..13b8da626c7 100644 --- a/docs/standard-library/overflow-error-class.md +++ b/docs/standard-library/overflow-error-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: overflow_error Class" -title: "overflow_error Class" +description: "Learn more about: overflow_error class" +title: "overflow_error class" ms.date: "09/09/2021" f1_keywords: ["stdexcept/std::overflow_error"] helpviewer_keywords: ["overflow_error class"] ms.assetid: bae7128d-e36b-4a45-84f1-2f89da441d20 --- -# `overflow_error` Class +# `overflow_error` class The class serves as the base class for all exceptions thrown to report an arithmetic overflow. @@ -67,5 +67,5 @@ Type: class std::overflow_error ## See also -[`runtime_error` Class](../standard-library/runtime-error-class.md)\ +[`runtime_error` class](../standard-library/runtime-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/range-error-class.md b/docs/standard-library/range-error-class.md index c7471ab1571..b4f54c2087d 100644 --- a/docs/standard-library/range-error-class.md +++ b/docs/standard-library/range-error-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: range_error Class" -title: "range_error Class" +description: "Learn more about: range_error class" +title: "range_error class" ms.date: "09/09/2021" f1_keywords: ["stdexcept/std::range_error"] helpviewer_keywords: ["range_error class"] ms.assetid: 8afb3e88-fc49-4213-b096-ed63d7aea37c --- -# `range_error` Class +# `range_error` class The class serves as the base class for all exceptions thrown to report a range error (as in mathematics, not iterators). @@ -62,5 +62,5 @@ Type: class std::range_error ## See also -[`runtime_error` Class](../standard-library/runtime-error-class.md)\ +[`runtime_error` class](../standard-library/runtime-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/runtime-error-class.md b/docs/standard-library/runtime-error-class.md index a5367a1a939..108070bf791 100644 --- a/docs/standard-library/runtime-error-class.md +++ b/docs/standard-library/runtime-error-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: runtime_error Class" -title: "runtime_error Class" +description: "Learn more about: runtime_error class" +title: "runtime_error class" ms.date: "09/09/2021" f1_keywords: ["stdexcept/std::runtime_error"] helpviewer_keywords: ["runtime_error class"] ms.assetid: 4d0227bf-847b-45a2-a320-2351ebf98368 --- -# `runtime_error` Class +# `runtime_error` class The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes. @@ -64,5 +64,5 @@ Type: class std::runtime_error ## See also -[`exception` Class](../standard-library/exception-class.md)\ +[`exception` class](../standard-library/exception-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/underflow-error-class.md b/docs/standard-library/underflow-error-class.md index 9f5e9ae9bfb..87098ec04dc 100644 --- a/docs/standard-library/underflow-error-class.md +++ b/docs/standard-library/underflow-error-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: underflow_error Class" -title: "underflow_error Class" +description: "Learn more about: underflow_error class" +title: "underflow_error class" ms.date: "09/09/2021" f1_keywords: ["stdexcept/std::underflow_error"] helpviewer_keywords: ["underflow_error class"] ms.assetid: d632f1f9-9c6c-4954-b96b-03041bfab22d --- -# `underflow_error` Class +# `underflow_error` class The class serves as the base class for all exceptions thrown to report an arithmetic underflow. @@ -66,5 +66,5 @@ Type: class std::underflow_error ## See also -[`runtime_error` Class](../standard-library/runtime-error-class.md)\ +[`runtime_error` class](../standard-library/runtime-error-class.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) From b53ea75d4bc62344e71d730263c0c9e2678be78d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 18:05:04 +0800 Subject: [PATCH 1231/1799] Simplify redundant relative links in all `` class references --- docs/standard-library/domain-error-class.md | 6 +++--- docs/standard-library/invalid-argument-class.md | 6 +++--- docs/standard-library/length-error-class.md | 6 +++--- docs/standard-library/logic-error-class.md | 6 +++--- docs/standard-library/out-of-range-class.md | 6 +++--- docs/standard-library/overflow-error-class.md | 6 +++--- docs/standard-library/range-error-class.md | 6 +++--- docs/standard-library/runtime-error-class.md | 6 +++--- docs/standard-library/underflow-error-class.md | 6 +++--- 9 files changed, 27 insertions(+), 27 deletions(-) diff --git a/docs/standard-library/domain-error-class.md b/docs/standard-library/domain-error-class.md index deecb530dd2..ae2ee7468d3 100644 --- a/docs/standard-library/domain-error-class.md +++ b/docs/standard-library/domain-error-class.md @@ -24,7 +24,7 @@ public: ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). `domain_error` isn't thrown by any functions in the Microsoft implementation of the C++ Standard Library, but it might be thrown by third-party libraries or user code. @@ -66,5 +66,5 @@ Type: class std::domain_error ## See also -[`logic_error` class](../standard-library/logic-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`logic_error` class](logic-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/invalid-argument-class.md b/docs/standard-library/invalid-argument-class.md index 4243101510d..61fec61895c 100644 --- a/docs/standard-library/invalid-argument-class.md +++ b/docs/standard-library/invalid-argument-class.md @@ -24,7 +24,7 @@ public: ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -64,5 +64,5 @@ Type: class std::invalid_argument ## See also -[`logic_error` class](../standard-library/logic-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`logic_error` class](logic-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/length-error-class.md b/docs/standard-library/length-error-class.md index 93a9ea92de4..6cfb2bd9640 100644 --- a/docs/standard-library/length-error-class.md +++ b/docs/standard-library/length-error-class.md @@ -24,7 +24,7 @@ public: ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -65,5 +65,5 @@ Type: class std::length_error ## See also -[`logic_error` class](../standard-library/logic-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`logic_error` class](logic-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/logic-error-class.md b/docs/standard-library/logic-error-class.md index 957f80c7b2b..6dfedeed2df 100644 --- a/docs/standard-library/logic-error-class.md +++ b/docs/standard-library/logic-error-class.md @@ -24,7 +24,7 @@ public: ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -64,5 +64,5 @@ Type: class std::logic_error ## See also -[`exception` class](../standard-library/exception-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`exception` class](exception-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/out-of-range-class.md b/docs/standard-library/out-of-range-class.md index 98f8ffd101d..11c837e5500 100644 --- a/docs/standard-library/out-of-range-class.md +++ b/docs/standard-library/out-of-range-class.md @@ -24,7 +24,7 @@ public: ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -67,5 +67,5 @@ Type: class std::out_of_range ## See also -[`logic_error` class](../standard-library/logic-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`logic_error` class](logic-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/overflow-error-class.md b/docs/standard-library/overflow-error-class.md index 13b8da626c7..32ddd799899 100644 --- a/docs/standard-library/overflow-error-class.md +++ b/docs/standard-library/overflow-error-class.md @@ -24,7 +24,7 @@ public: ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -67,5 +67,5 @@ Type: class std::overflow_error ## See also -[`runtime_error` class](../standard-library/runtime-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`runtime_error` class](runtime-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/range-error-class.md b/docs/standard-library/range-error-class.md index b4f54c2087d..a9fd6135bc2 100644 --- a/docs/standard-library/range-error-class.md +++ b/docs/standard-library/range-error-class.md @@ -22,7 +22,7 @@ public: ## Remarks -The value returned by [`what`](../standard-library/exception-class.md) is a copy of `message.data()`. For more information, see [`basic_string::data`](../standard-library/basic-string-class.md#data). +The value returned by [`what`](exception-class.md) is a copy of `message.data()`. For more information, see [`basic_string::data`](basic-string-class.md#data). ## Example @@ -62,5 +62,5 @@ Type: class std::range_error ## See also -[`runtime_error` class](../standard-library/runtime-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`runtime_error` class](runtime-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/runtime-error-class.md b/docs/standard-library/runtime-error-class.md index 108070bf791..2ffcb27f3ff 100644 --- a/docs/standard-library/runtime-error-class.md +++ b/docs/standard-library/runtime-error-class.md @@ -24,7 +24,7 @@ public: ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -64,5 +64,5 @@ Type: class std::runtime_error ## See also -[`exception` class](../standard-library/exception-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`exception` class](exception-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/underflow-error-class.md b/docs/standard-library/underflow-error-class.md index 87098ec04dc..a07486f555d 100644 --- a/docs/standard-library/underflow-error-class.md +++ b/docs/standard-library/underflow-error-class.md @@ -24,7 +24,7 @@ public: ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). `underflow_error` isn't thrown by any functions in the Microsoft implementation of the C++ Standard Library, but it might be thrown by third-party libraries or user code. @@ -66,5 +66,5 @@ Type: class std::underflow_error ## See also -[`runtime_error` class](../standard-library/runtime-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`runtime_error` class](runtime-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) From b292e17de66f0d0101d2a16c5055c2d37ee8ee39 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 18:11:08 +0800 Subject: [PATCH 1232/1799] Remove trailing empty syntax lines in all `` class references --- docs/standard-library/domain-error-class.md | 1 - docs/standard-library/invalid-argument-class.md | 1 - docs/standard-library/length-error-class.md | 1 - docs/standard-library/logic-error-class.md | 1 - docs/standard-library/out-of-range-class.md | 1 - docs/standard-library/overflow-error-class.md | 1 - docs/standard-library/runtime-error-class.md | 1 - docs/standard-library/underflow-error-class.md | 1 - 8 files changed, 8 deletions(-) diff --git a/docs/standard-library/domain-error-class.md b/docs/standard-library/domain-error-class.md index ae2ee7468d3..a7ec04a0b5a 100644 --- a/docs/standard-library/domain-error-class.md +++ b/docs/standard-library/domain-error-class.md @@ -18,7 +18,6 @@ public: explicit domain_error(const string& message); explicit domain_error(const char *message); - }; ``` diff --git a/docs/standard-library/invalid-argument-class.md b/docs/standard-library/invalid-argument-class.md index 61fec61895c..9eb24629250 100644 --- a/docs/standard-library/invalid-argument-class.md +++ b/docs/standard-library/invalid-argument-class.md @@ -18,7 +18,6 @@ public: explicit invalid_argument(const string& message); explicit invalid_argument(const char *message); - }; ``` diff --git a/docs/standard-library/length-error-class.md b/docs/standard-library/length-error-class.md index 6cfb2bd9640..aa7963f1c21 100644 --- a/docs/standard-library/length-error-class.md +++ b/docs/standard-library/length-error-class.md @@ -18,7 +18,6 @@ public: explicit length_error(const string& message); explicit length_error(const char *message); - }; ``` diff --git a/docs/standard-library/logic-error-class.md b/docs/standard-library/logic-error-class.md index 6dfedeed2df..a3f6de0ad30 100644 --- a/docs/standard-library/logic-error-class.md +++ b/docs/standard-library/logic-error-class.md @@ -18,7 +18,6 @@ public: explicit logic_error(const string& message); explicit logic_error(const char *message); - }; ``` diff --git a/docs/standard-library/out-of-range-class.md b/docs/standard-library/out-of-range-class.md index 11c837e5500..8781b499f7e 100644 --- a/docs/standard-library/out-of-range-class.md +++ b/docs/standard-library/out-of-range-class.md @@ -18,7 +18,6 @@ public: explicit out_of_range(const string& message); explicit out_of_range(const char *message); - }; ``` diff --git a/docs/standard-library/overflow-error-class.md b/docs/standard-library/overflow-error-class.md index 32ddd799899..30373fb33d3 100644 --- a/docs/standard-library/overflow-error-class.md +++ b/docs/standard-library/overflow-error-class.md @@ -18,7 +18,6 @@ public: explicit overflow_error(const string& message); explicit overflow_error(const char *message); - }; ``` diff --git a/docs/standard-library/runtime-error-class.md b/docs/standard-library/runtime-error-class.md index 2ffcb27f3ff..575a981066a 100644 --- a/docs/standard-library/runtime-error-class.md +++ b/docs/standard-library/runtime-error-class.md @@ -18,7 +18,6 @@ public: explicit runtime_error(const string& message); explicit runtime_error(const char *message); - }; ``` diff --git a/docs/standard-library/underflow-error-class.md b/docs/standard-library/underflow-error-class.md index a07486f555d..f0db72e1561 100644 --- a/docs/standard-library/underflow-error-class.md +++ b/docs/standard-library/underflow-error-class.md @@ -18,7 +18,6 @@ public: explicit underflow_error(const string& message); explicit underflow_error(const char *message); - }; ``` From cad9532de44db0dcce74437d88bf020fcdd5bf76 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 18:13:16 +0800 Subject: [PATCH 1233/1799] Update metadata in all `` class references --- docs/standard-library/domain-error-class.md | 5 ++--- docs/standard-library/invalid-argument-class.md | 5 ++--- docs/standard-library/length-error-class.md | 5 ++--- docs/standard-library/logic-error-class.md | 5 ++--- docs/standard-library/out-of-range-class.md | 5 ++--- docs/standard-library/overflow-error-class.md | 5 ++--- docs/standard-library/range-error-class.md | 5 ++--- docs/standard-library/runtime-error-class.md | 5 ++--- docs/standard-library/underflow-error-class.md | 5 ++--- 9 files changed, 18 insertions(+), 27 deletions(-) diff --git a/docs/standard-library/domain-error-class.md b/docs/standard-library/domain-error-class.md index a7ec04a0b5a..c976e9d9d67 100644 --- a/docs/standard-library/domain-error-class.md +++ b/docs/standard-library/domain-error-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: domain_error class" title: "domain_error class" -ms.date: "09/09/2021" +description: "Learn more about: domain_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::domain_error"] helpviewer_keywords: ["domain_error class"] -ms.assetid: a1d8245d-61c2-4d1e-973f-073bd5dd5fa3 --- # `domain_error` class diff --git a/docs/standard-library/invalid-argument-class.md b/docs/standard-library/invalid-argument-class.md index 9eb24629250..f2a22f505cb 100644 --- a/docs/standard-library/invalid-argument-class.md +++ b/docs/standard-library/invalid-argument-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: invalid_argument class" title: "invalid_argument class" -ms.date: "09/09/2021" +description: "Learn more about: invalid_argument class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::invalid_argument"] helpviewer_keywords: ["invalid_argument class"] -ms.assetid: af6c227d-ad7c-4e63-9dee-67af81d83506 --- # `invalid_argument` class diff --git a/docs/standard-library/length-error-class.md b/docs/standard-library/length-error-class.md index aa7963f1c21..7230d8b628f 100644 --- a/docs/standard-library/length-error-class.md +++ b/docs/standard-library/length-error-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: length_error class" title: "length_error class" -ms.date: "09/09/2021" +description: "Learn more about: length_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::length_error"] helpviewer_keywords: ["length_error class"] -ms.assetid: d53c46c5-4626-400d-bd76-bf3e1e0f64ae --- # `length_error` class diff --git a/docs/standard-library/logic-error-class.md b/docs/standard-library/logic-error-class.md index a3f6de0ad30..6d096245bda 100644 --- a/docs/standard-library/logic-error-class.md +++ b/docs/standard-library/logic-error-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: logic_error class" title: "logic_error class" -ms.date: "09/09/2021" +description: "Learn more about: logic_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::logic_error"] helpviewer_keywords: ["logic_error class"] -ms.assetid: b290d73d-94e1-4288-af86-2bb5d71f677a --- # `logic_error` class diff --git a/docs/standard-library/out-of-range-class.md b/docs/standard-library/out-of-range-class.md index 8781b499f7e..cf5e79dfc81 100644 --- a/docs/standard-library/out-of-range-class.md +++ b/docs/standard-library/out-of-range-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: out_of_range class" title: "out_of_range class" -ms.date: "09/09/2021" +description: "Learn more about: out_of_range class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::out_of_range"] helpviewer_keywords: ["out_of_range class"] -ms.assetid: d0e14dc0-065e-4666-9ac9-51e52223c503 --- # `out_of_range` class diff --git a/docs/standard-library/overflow-error-class.md b/docs/standard-library/overflow-error-class.md index 30373fb33d3..b4291d01a31 100644 --- a/docs/standard-library/overflow-error-class.md +++ b/docs/standard-library/overflow-error-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: overflow_error class" title: "overflow_error class" -ms.date: "09/09/2021" +description: "Learn more about: overflow_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::overflow_error"] helpviewer_keywords: ["overflow_error class"] -ms.assetid: bae7128d-e36b-4a45-84f1-2f89da441d20 --- # `overflow_error` class diff --git a/docs/standard-library/range-error-class.md b/docs/standard-library/range-error-class.md index a9fd6135bc2..35559c39d45 100644 --- a/docs/standard-library/range-error-class.md +++ b/docs/standard-library/range-error-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: range_error class" title: "range_error class" -ms.date: "09/09/2021" +description: "Learn more about: range_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::range_error"] helpviewer_keywords: ["range_error class"] -ms.assetid: 8afb3e88-fc49-4213-b096-ed63d7aea37c --- # `range_error` class diff --git a/docs/standard-library/runtime-error-class.md b/docs/standard-library/runtime-error-class.md index 575a981066a..9ae07afd607 100644 --- a/docs/standard-library/runtime-error-class.md +++ b/docs/standard-library/runtime-error-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: runtime_error class" title: "runtime_error class" -ms.date: "09/09/2021" +description: "Learn more about: runtime_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::runtime_error"] helpviewer_keywords: ["runtime_error class"] -ms.assetid: 4d0227bf-847b-45a2-a320-2351ebf98368 --- # `runtime_error` class diff --git a/docs/standard-library/underflow-error-class.md b/docs/standard-library/underflow-error-class.md index f0db72e1561..3b1d405babc 100644 --- a/docs/standard-library/underflow-error-class.md +++ b/docs/standard-library/underflow-error-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: underflow_error class" title: "underflow_error class" -ms.date: "09/09/2021" +description: "Learn more about: underflow_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::underflow_error"] helpviewer_keywords: ["underflow_error class"] -ms.assetid: d632f1f9-9c6c-4954-b96b-03041bfab22d --- # `underflow_error` class From 3abb2c479c67800f5a843644643abd0f1aa93868 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 22:50:39 +0800 Subject: [PATCH 1234/1799] Add "Remarks" headings for warning references in range [CVT4001, CVT4001] --- docs/error-messages/tool-errors/cvtres-warning-cvt4001.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md b/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md index c5a1257e706..c4fb0fbe573 100644 --- a/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md +++ b/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md @@ -10,4 +10,6 @@ ms.assetid: 39c13bc2-92fa-4d79-8171-039b27329dcc > machine type not specified; assumed *type* +## Remarks + CVTRES did not find a machine specification. It assumed the given machine type. If the default is incorrect, rerun CVTRES using the /MACHINE option. From ae6b52f11b4404cc1d3625612311a9b84b637ed2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 17 Sep 2025 22:51:17 +0800 Subject: [PATCH 1235/1799] Update metadata for warning references in range [CVT4001, CVT4001] --- docs/error-messages/tool-errors/cvtres-warning-cvt4001.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md b/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md index c4fb0fbe573..31ce4a14981 100644 --- a/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md +++ b/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CVTRES Warning CVT4001" title: "CVTRES Warning CVT4001" -ms.date: "08/27/2018" +description: "Learn more about: CVTRES Warning CVT4001" +ms.date: 08/27/2018 f1_keywords: ["CVT4001"] helpviewer_keywords: ["CVT4001"] -ms.assetid: 39c13bc2-92fa-4d79-8171-039b27329dcc --- # CVTRES Warning CVT4001 From 6082833aa07ebc40cbacdd12679021f9958e7b42 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 18 Sep 2025 22:06:52 +0800 Subject: [PATCH 1236/1799] Add blockquotes for error messages in range [M6101, M6205] --- docs/error-messages/tool-errors/math-error-m6101.md | 2 +- docs/error-messages/tool-errors/math-error-m6102.md | 2 +- docs/error-messages/tool-errors/math-error-m6107.md | 2 +- docs/error-messages/tool-errors/math-error-m6108.md | 2 +- docs/error-messages/tool-errors/math-error-m6110.md | 2 +- docs/error-messages/tool-errors/math-error-m6111.md | 2 +- docs/error-messages/tool-errors/math-error-m6201.md | 2 +- docs/error-messages/tool-errors/math-error-m6202.md | 2 +- docs/error-messages/tool-errors/math-error-m6203.md | 2 +- docs/error-messages/tool-errors/math-error-m6205.md | 2 +- 10 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/error-messages/tool-errors/math-error-m6101.md b/docs/error-messages/tool-errors/math-error-m6101.md index 2a134c383a9..16f02b39134 100644 --- a/docs/error-messages/tool-errors/math-error-m6101.md +++ b/docs/error-messages/tool-errors/math-error-m6101.md @@ -8,7 +8,7 @@ ms.assetid: 8c8d5097-d725-4a2c-92e9-fcf28c871d74 --- # Math Error M6101 -invalid +> invalid Invalid operation. diff --git a/docs/error-messages/tool-errors/math-error-m6102.md b/docs/error-messages/tool-errors/math-error-m6102.md index 0500853cac0..1f13bafccca 100644 --- a/docs/error-messages/tool-errors/math-error-m6102.md +++ b/docs/error-messages/tool-errors/math-error-m6102.md @@ -8,7 +8,7 @@ ms.assetid: dbd2241f-6595-431e-9597-d9dbdb3a0ca2 --- # Math Error M6102 -denormal +> denormal An operation generated a very small floating-point number, which be invalid due loss of significance. Denormal floating-point exceptions are usually masked, causing them to be trapped and operated upon. diff --git a/docs/error-messages/tool-errors/math-error-m6107.md b/docs/error-messages/tool-errors/math-error-m6107.md index bf01ca4d03e..d1ab7b75aff 100644 --- a/docs/error-messages/tool-errors/math-error-m6107.md +++ b/docs/error-messages/tool-errors/math-error-m6107.md @@ -8,7 +8,7 @@ ms.assetid: a827a2a4-40b7-4e28-8e8d-530c6ffcf0c9 --- # Math Error M6107 -unemulated +> unemulated An attempt was made to execute a coprocessor instruction that is invalid or is not supported by the emulator. diff --git a/docs/error-messages/tool-errors/math-error-m6108.md b/docs/error-messages/tool-errors/math-error-m6108.md index 7155419b33d..052216baf72 100644 --- a/docs/error-messages/tool-errors/math-error-m6108.md +++ b/docs/error-messages/tool-errors/math-error-m6108.md @@ -8,7 +8,7 @@ ms.assetid: 054893b4-49bc-45d9-882f-7cb50ba387c0 --- # Math Error M6108 -square root +> square root The operand in a square-root operation was negative. diff --git a/docs/error-messages/tool-errors/math-error-m6110.md b/docs/error-messages/tool-errors/math-error-m6110.md index cbc7337ca7b..06257b2b615 100644 --- a/docs/error-messages/tool-errors/math-error-m6110.md +++ b/docs/error-messages/tool-errors/math-error-m6110.md @@ -8,7 +8,7 @@ ms.assetid: aac9ae37-6a6d-46e9-85d4-dfe03f1c3e11 --- # Math Error M6110 -stack overflow +> stack overflow A floating-point expression caused a floating-point stack overflow. diff --git a/docs/error-messages/tool-errors/math-error-m6111.md b/docs/error-messages/tool-errors/math-error-m6111.md index 1c1196f7cdb..f64dd11d51b 100644 --- a/docs/error-messages/tool-errors/math-error-m6111.md +++ b/docs/error-messages/tool-errors/math-error-m6111.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["M6111"] --- # Math Error M6111 -stack underflow +> stack underflow A floating-point operation resulted in a stack underflow on the 8087/287/387 coprocessor or the emulator. diff --git a/docs/error-messages/tool-errors/math-error-m6201.md b/docs/error-messages/tool-errors/math-error-m6201.md index 5bc92535e0e..59c559cf487 100644 --- a/docs/error-messages/tool-errors/math-error-m6201.md +++ b/docs/error-messages/tool-errors/math-error-m6201.md @@ -8,7 +8,7 @@ ms.assetid: 4041c331-d9aa-4dd4-b565-7dbe0218538c --- # Math Error M6201 -'function' : _DOMAIN error +> 'function' : _DOMAIN error An argument to the given function was outside the domain of legal input values for that function. diff --git a/docs/error-messages/tool-errors/math-error-m6202.md b/docs/error-messages/tool-errors/math-error-m6202.md index 1f9514fda1c..74dbbd4373b 100644 --- a/docs/error-messages/tool-errors/math-error-m6202.md +++ b/docs/error-messages/tool-errors/math-error-m6202.md @@ -8,7 +8,7 @@ ms.assetid: 4d17045f-c6dc-4705-9512-e9af12c35fb4 --- # Math Error M6202 -'function' : _SING error +> 'function' : _SING error An argument to the given function was a singularity value for this function. The function is not defined for that argument. diff --git a/docs/error-messages/tool-errors/math-error-m6203.md b/docs/error-messages/tool-errors/math-error-m6203.md index 7677ddc0174..e6d25d1e37f 100644 --- a/docs/error-messages/tool-errors/math-error-m6203.md +++ b/docs/error-messages/tool-errors/math-error-m6203.md @@ -8,7 +8,7 @@ ms.assetid: bd7fdd1c-83e4-4d6a-901e-10a0308bf5be --- # Math Error M6203 -'function' : _OVERFLOW error +> 'function' : _OVERFLOW error The given function result was too large to be represented. diff --git a/docs/error-messages/tool-errors/math-error-m6205.md b/docs/error-messages/tool-errors/math-error-m6205.md index a65999a49ef..ce76b474e47 100644 --- a/docs/error-messages/tool-errors/math-error-m6205.md +++ b/docs/error-messages/tool-errors/math-error-m6205.md @@ -8,7 +8,7 @@ ms.assetid: fd28e7c9-a463-4a9c-a863-cc9e75315550 --- # Math Error M6205 -'function' : _TLOSS error +> 'function' : _TLOSS error A total loss of significance (precision) occurred. From fefad8af9e2dcf7f2c83a114c851f944822f68b2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 18 Sep 2025 22:09:24 +0800 Subject: [PATCH 1237/1799] Add "Remarks" and "Example" headings for error references in range [M6101, M6205] --- docs/error-messages/tool-errors/math-error-m6101.md | 2 ++ docs/error-messages/tool-errors/math-error-m6102.md | 2 ++ docs/error-messages/tool-errors/math-error-m6107.md | 2 ++ docs/error-messages/tool-errors/math-error-m6108.md | 2 ++ docs/error-messages/tool-errors/math-error-m6110.md | 2 ++ docs/error-messages/tool-errors/math-error-m6111.md | 8 +++++++- docs/error-messages/tool-errors/math-error-m6201.md | 2 ++ docs/error-messages/tool-errors/math-error-m6202.md | 2 ++ docs/error-messages/tool-errors/math-error-m6203.md | 2 ++ docs/error-messages/tool-errors/math-error-m6205.md | 2 ++ 10 files changed, 25 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/math-error-m6101.md b/docs/error-messages/tool-errors/math-error-m6101.md index 16f02b39134..768404f9982 100644 --- a/docs/error-messages/tool-errors/math-error-m6101.md +++ b/docs/error-messages/tool-errors/math-error-m6101.md @@ -10,6 +10,8 @@ ms.assetid: 8c8d5097-d725-4a2c-92e9-fcf28c871d74 > invalid +## Remarks + Invalid operation. This error can be caused when an operand is NaN (not a number) or infinity. diff --git a/docs/error-messages/tool-errors/math-error-m6102.md b/docs/error-messages/tool-errors/math-error-m6102.md index 1f13bafccca..03ca2198b64 100644 --- a/docs/error-messages/tool-errors/math-error-m6102.md +++ b/docs/error-messages/tool-errors/math-error-m6102.md @@ -10,6 +10,8 @@ ms.assetid: dbd2241f-6595-431e-9597-d9dbdb3a0ca2 > denormal +## Remarks + An operation generated a very small floating-point number, which be invalid due loss of significance. Denormal floating-point exceptions are usually masked, causing them to be trapped and operated upon. Program terminates with exit code 130. diff --git a/docs/error-messages/tool-errors/math-error-m6107.md b/docs/error-messages/tool-errors/math-error-m6107.md index d1ab7b75aff..bcd5ede617a 100644 --- a/docs/error-messages/tool-errors/math-error-m6107.md +++ b/docs/error-messages/tool-errors/math-error-m6107.md @@ -10,6 +10,8 @@ ms.assetid: a827a2a4-40b7-4e28-8e8d-530c6ffcf0c9 > unemulated +## Remarks + An attempt was made to execute a coprocessor instruction that is invalid or is not supported by the emulator. Program terminates with exit code 135. diff --git a/docs/error-messages/tool-errors/math-error-m6108.md b/docs/error-messages/tool-errors/math-error-m6108.md index 052216baf72..dfadc04c651 100644 --- a/docs/error-messages/tool-errors/math-error-m6108.md +++ b/docs/error-messages/tool-errors/math-error-m6108.md @@ -10,6 +10,8 @@ ms.assetid: 054893b4-49bc-45d9-882f-7cb50ba387c0 > square root +## Remarks + The operand in a square-root operation was negative. Program terminates with exit code 136. diff --git a/docs/error-messages/tool-errors/math-error-m6110.md b/docs/error-messages/tool-errors/math-error-m6110.md index 06257b2b615..0d4d4b171ec 100644 --- a/docs/error-messages/tool-errors/math-error-m6110.md +++ b/docs/error-messages/tool-errors/math-error-m6110.md @@ -10,6 +10,8 @@ ms.assetid: aac9ae37-6a6d-46e9-85d4-dfe03f1c3e11 > stack overflow +## Remarks + A floating-point expression caused a floating-point stack overflow. Stack-overflow floating-point exceptions are trapped up to a limit of seven levels in addition to the eight levels usually supported by the 8087/287/387 coprocessor. diff --git a/docs/error-messages/tool-errors/math-error-m6111.md b/docs/error-messages/tool-errors/math-error-m6111.md index f64dd11d51b..a63eb57ba48 100644 --- a/docs/error-messages/tool-errors/math-error-m6111.md +++ b/docs/error-messages/tool-errors/math-error-m6111.md @@ -9,9 +9,15 @@ helpviewer_keywords: ["M6111"] > stack underflow +## Remarks + A floating-point operation resulted in a stack underflow on the 8087/287/387 coprocessor or the emulator. -This error is often caused by a call to a **`long double`** function that does not return a value. For example, the following generates this error when compiled and run: +This error is often caused by a call to a **`long double`** function that does not return a value. + +## Example + +For example, the following generates this error when compiled and run: ```c long double ld() {} diff --git a/docs/error-messages/tool-errors/math-error-m6201.md b/docs/error-messages/tool-errors/math-error-m6201.md index 59c559cf487..39795d497f4 100644 --- a/docs/error-messages/tool-errors/math-error-m6201.md +++ b/docs/error-messages/tool-errors/math-error-m6201.md @@ -10,6 +10,8 @@ ms.assetid: 4041c331-d9aa-4dd4-b565-7dbe0218538c > 'function' : _DOMAIN error +## Remarks + An argument to the given function was outside the domain of legal input values for that function. ## Example diff --git a/docs/error-messages/tool-errors/math-error-m6202.md b/docs/error-messages/tool-errors/math-error-m6202.md index 74dbbd4373b..1008fdb1c2d 100644 --- a/docs/error-messages/tool-errors/math-error-m6202.md +++ b/docs/error-messages/tool-errors/math-error-m6202.md @@ -10,6 +10,8 @@ ms.assetid: 4d17045f-c6dc-4705-9512-e9af12c35fb4 > 'function' : _SING error +## Remarks + An argument to the given function was a singularity value for this function. The function is not defined for that argument. This error calls the `_matherr` function with the function name, its arguments, and the error type. You can rewrite the `_matherr` function to customize the handling of certain run-time floating-point math errors. diff --git a/docs/error-messages/tool-errors/math-error-m6203.md b/docs/error-messages/tool-errors/math-error-m6203.md index e6d25d1e37f..7adc0cb5816 100644 --- a/docs/error-messages/tool-errors/math-error-m6203.md +++ b/docs/error-messages/tool-errors/math-error-m6203.md @@ -10,6 +10,8 @@ ms.assetid: bd7fdd1c-83e4-4d6a-901e-10a0308bf5be > 'function' : _OVERFLOW error +## Remarks + The given function result was too large to be represented. This error calls the `_matherr` function with the function name, its arguments, and the error type. You can rewrite the `_matherr` function to customize the handling of certain run-time floating-point math errors. diff --git a/docs/error-messages/tool-errors/math-error-m6205.md b/docs/error-messages/tool-errors/math-error-m6205.md index ce76b474e47..376653e3467 100644 --- a/docs/error-messages/tool-errors/math-error-m6205.md +++ b/docs/error-messages/tool-errors/math-error-m6205.md @@ -10,6 +10,8 @@ ms.assetid: fd28e7c9-a463-4a9c-a863-cc9e75315550 > 'function' : _TLOSS error +## Remarks + A total loss of significance (precision) occurred. This error may be caused by giving a very large number as the operand of sin, cos, or tan because the operand must be reduced to a number between 0 and 2*pi. From c81a8cae657ad3f1a2b0115d85172302787a5a33 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 18 Sep 2025 22:13:00 +0800 Subject: [PATCH 1238/1799] Update metadata for error references in range [M6101, M6205] --- docs/error-messages/tool-errors/math-error-m6101.md | 5 ++--- docs/error-messages/tool-errors/math-error-m6102.md | 5 ++--- docs/error-messages/tool-errors/math-error-m6107.md | 5 ++--- docs/error-messages/tool-errors/math-error-m6108.md | 5 ++--- docs/error-messages/tool-errors/math-error-m6110.md | 5 ++--- docs/error-messages/tool-errors/math-error-m6201.md | 5 ++--- docs/error-messages/tool-errors/math-error-m6202.md | 5 ++--- docs/error-messages/tool-errors/math-error-m6203.md | 5 ++--- docs/error-messages/tool-errors/math-error-m6205.md | 5 ++--- 9 files changed, 18 insertions(+), 27 deletions(-) diff --git a/docs/error-messages/tool-errors/math-error-m6101.md b/docs/error-messages/tool-errors/math-error-m6101.md index 768404f9982..97393e3598c 100644 --- a/docs/error-messages/tool-errors/math-error-m6101.md +++ b/docs/error-messages/tool-errors/math-error-m6101.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6101" title: "Math Error M6101" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6101" +ms.date: 11/04/2016 f1_keywords: ["M6101"] helpviewer_keywords: ["M6101"] -ms.assetid: 8c8d5097-d725-4a2c-92e9-fcf28c871d74 --- # Math Error M6101 diff --git a/docs/error-messages/tool-errors/math-error-m6102.md b/docs/error-messages/tool-errors/math-error-m6102.md index 03ca2198b64..fe151670999 100644 --- a/docs/error-messages/tool-errors/math-error-m6102.md +++ b/docs/error-messages/tool-errors/math-error-m6102.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6102" title: "Math Error M6102" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6102" +ms.date: 11/04/2016 f1_keywords: ["M6102"] helpviewer_keywords: ["M6102"] -ms.assetid: dbd2241f-6595-431e-9597-d9dbdb3a0ca2 --- # Math Error M6102 diff --git a/docs/error-messages/tool-errors/math-error-m6107.md b/docs/error-messages/tool-errors/math-error-m6107.md index bcd5ede617a..96e69ec23ae 100644 --- a/docs/error-messages/tool-errors/math-error-m6107.md +++ b/docs/error-messages/tool-errors/math-error-m6107.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6107" title: "Math Error M6107" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6107" +ms.date: 11/04/2016 f1_keywords: ["M6107"] helpviewer_keywords: ["M6107"] -ms.assetid: a827a2a4-40b7-4e28-8e8d-530c6ffcf0c9 --- # Math Error M6107 diff --git a/docs/error-messages/tool-errors/math-error-m6108.md b/docs/error-messages/tool-errors/math-error-m6108.md index dfadc04c651..c0fd950f914 100644 --- a/docs/error-messages/tool-errors/math-error-m6108.md +++ b/docs/error-messages/tool-errors/math-error-m6108.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6108" title: "Math Error M6108" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6108" +ms.date: 11/04/2016 f1_keywords: ["M6108"] helpviewer_keywords: ["M6108"] -ms.assetid: 054893b4-49bc-45d9-882f-7cb50ba387c0 --- # Math Error M6108 diff --git a/docs/error-messages/tool-errors/math-error-m6110.md b/docs/error-messages/tool-errors/math-error-m6110.md index 0d4d4b171ec..6d6b24e2d75 100644 --- a/docs/error-messages/tool-errors/math-error-m6110.md +++ b/docs/error-messages/tool-errors/math-error-m6110.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6110" title: "Math Error M6110" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6110" +ms.date: 11/04/2016 f1_keywords: ["M6110"] helpviewer_keywords: ["M6110"] -ms.assetid: aac9ae37-6a6d-46e9-85d4-dfe03f1c3e11 --- # Math Error M6110 diff --git a/docs/error-messages/tool-errors/math-error-m6201.md b/docs/error-messages/tool-errors/math-error-m6201.md index 39795d497f4..02fe9b07f20 100644 --- a/docs/error-messages/tool-errors/math-error-m6201.md +++ b/docs/error-messages/tool-errors/math-error-m6201.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6201" title: "Math Error M6201" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6201" +ms.date: 11/04/2016 f1_keywords: ["M6201"] helpviewer_keywords: ["M6201"] -ms.assetid: 4041c331-d9aa-4dd4-b565-7dbe0218538c --- # Math Error M6201 diff --git a/docs/error-messages/tool-errors/math-error-m6202.md b/docs/error-messages/tool-errors/math-error-m6202.md index 1008fdb1c2d..b26b2653ddc 100644 --- a/docs/error-messages/tool-errors/math-error-m6202.md +++ b/docs/error-messages/tool-errors/math-error-m6202.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6202" title: "Math Error M6202" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6202" +ms.date: 11/04/2016 f1_keywords: ["M6202"] helpviewer_keywords: ["M6202"] -ms.assetid: 4d17045f-c6dc-4705-9512-e9af12c35fb4 --- # Math Error M6202 diff --git a/docs/error-messages/tool-errors/math-error-m6203.md b/docs/error-messages/tool-errors/math-error-m6203.md index 7adc0cb5816..d2d66863f38 100644 --- a/docs/error-messages/tool-errors/math-error-m6203.md +++ b/docs/error-messages/tool-errors/math-error-m6203.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6203" title: "Math Error M6203" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6203" +ms.date: 11/04/2016 f1_keywords: ["M6203"] helpviewer_keywords: ["M6203"] -ms.assetid: bd7fdd1c-83e4-4d6a-901e-10a0308bf5be --- # Math Error M6203 diff --git a/docs/error-messages/tool-errors/math-error-m6205.md b/docs/error-messages/tool-errors/math-error-m6205.md index 376653e3467..2b92bda1950 100644 --- a/docs/error-messages/tool-errors/math-error-m6205.md +++ b/docs/error-messages/tool-errors/math-error-m6205.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Math Error M6205" title: "Math Error M6205" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6205" +ms.date: 11/04/2016 f1_keywords: ["M6205"] helpviewer_keywords: ["M6205"] -ms.assetid: fd28e7c9-a463-4a9c-a863-cc9e75315550 --- # Math Error M6205 From 3b8a3e78da7148d5d68bbd71c07cd1bd93762de7 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 18 Sep 2025 16:05:26 -0700 Subject: [PATCH 1239/1799] Update docs/error-messages/compiler-errors-2/compiler-error-c3417.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/error-messages/compiler-errors-2/compiler-error-c3417.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md index 6be953cb0e6..e7fdaddf9e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md @@ -15,7 +15,7 @@ Value types cannot contain functions such as a default instance constructor, des ## Example -The following example generates C3517: +The following example generates C3417: ```cpp // C3417.cpp From c2ad252d39aff6ee325efcb1f4c634f81e393855 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 18 Sep 2025 17:20:47 -0700 Subject: [PATCH 1240/1799] Update docs/error-messages/compiler-errors-2/compiler-error-c3851.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/error-messages/compiler-errors-2/compiler-error-c3851.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3851.md b/docs/error-messages/compiler-errors-2/compiler-error-c3851.md index b711d0114d7..a505013ce14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3851.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3851.md @@ -15,7 +15,7 @@ In code compiled as C++, you cannot use a universal character name that represen ## Example -The following example generate C3851, and show how to fix it: +The following example generates C3851, and show how to fix it: ```cpp // C3851.cpp From 6ab213b7df23f29cb19eb5f4aa284ba7d95b105f Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 18 Sep 2025 17:21:04 -0700 Subject: [PATCH 1241/1799] Update docs/error-messages/compiler-errors-2/compiler-error-c3853.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/error-messages/compiler-errors-2/compiler-error-c3853.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md index 935ffefaaa3..49307be38a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md @@ -15,7 +15,7 @@ Cannot assign to a reference through a function because functions are not lvalue ## Example -The following example generate C3853: +The following example generates C3853: ```cpp // C3853.cpp From 3745eb47d60819107f188f656025bba0e7b152d4 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 18 Sep 2025 17:25:02 -0700 Subject: [PATCH 1242/1799] Update docs/error-messages/compiler-errors-2/compiler-error-c3909.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/error-messages/compiler-errors-2/compiler-error-c3909.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md index 5e4bc912e93..205c07d12ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C3909"] --- # Compiler Error C3909 -> aWinRT or managed event declaration must occur in a WinRT or managed type +> a WinRT or managed event declaration must occur in a WinRT or managed type ## Remarks From 6639ae8375105d87e4ace171a200d7babb574b83 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 18 Sep 2025 17:28:22 -0700 Subject: [PATCH 1243/1799] Fix header title in compiler warning documentation Corrected the section header from 'Examples' to 'Example' for consistency. --- .../compiler-warnings/compiler-warning-level-1-c4002.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md index be577e0b73b..c97bb7d1227 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md @@ -15,7 +15,7 @@ The number of actual parameters in the macro exceeds the number of formal parame C4002 can occur when incorrectly using [variadic macros](../../preprocessor/variadic-macros.md). -## Examples +## Example The following example generates C4002: From 0e7d9bf00195f933b8872096dfe3e39374238e7a Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 18 Sep 2025 17:31:07 -0700 Subject: [PATCH 1244/1799] Enhance C4036 warning example explanation Clarify example for C4036 warning resolution. --- .../compiler-warnings/compiler-warning-level-1-c4036.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md index aa7a3ae06af..6cd5d9f50a5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md @@ -17,7 +17,7 @@ Specify a type name to resolve this warning. ## Example -The following example generates C4036. +The following example generates C4036 and shows how to fix it by providing a type name. ```c // C4036.c From c20eee1ceea9fea2601d59e87e4ae76935625940 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 18 Sep 2025 17:37:41 -0700 Subject: [PATCH 1245/1799] Update docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../compiler-warnings/compiler-warning-level-1-c4042.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md index 2111f2a26b4..aad89002ff8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md @@ -23,7 +23,7 @@ This warning can be caused by specifying a storage class other than **`register` ## Example -The following example generates C4042 +The following example generates C4042: ```cpp // C4042.cpp From 0c5741f84d5de4cf70824957bc4e580f3ac9627c Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 18 Sep 2025 17:42:37 -0700 Subject: [PATCH 1246/1799] Fix formatting in C4162 warning documentation Added a colon to the example generation statement for clarity. --- .../compiler-warnings/compiler-warning-level-1-c4162.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md index e48b464d475..41936b10c1f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md @@ -17,7 +17,7 @@ To resolve this warning, compile in a .c file (invoke the C compiler). If you m ## Example -The following example generates C4162 +The following example generates C4162: ```cpp // C4162.cpp From 484d71b715b773329608f46b43486f353cd45d1c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 19 Sep 2025 23:30:20 +0800 Subject: [PATCH 1247/1799] Add blockquotes for warning messages in range [PG1039, PG1087] --- .../tool-errors/profile-guided-optimization-warning-pg1039.md | 2 +- .../tool-errors/profile-guided-optimization-warning-pg1087.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md index 1bab31de79d..96924083dd1 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md @@ -8,6 +8,6 @@ ms.assetid: a67dfd66-b610-4d78-9658-2bcf7a506b9f --- # Profile-Guided Optimization Warning PG1039 -Failed waiting for quiet time to sweep. +> Failed waiting for quiet time to sweep. The application did not allow [pgosweep](../../build/pgosweep.md) to run. If possible, run pgosweep when the application is in an idle state. diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md index 873b38173a2..8ea3fc3b407 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md @@ -8,6 +8,6 @@ ms.assetid: 50785d68-17a2-4d82-bee2-8c514faf61c6 --- # Profile-Guided Optimization Warning PG1087 -The PGC file 'file' is not valid. +> The PGC file 'file' is not valid. A .pgc file is corrupt, possibly due to an abnormal end to a profiling session. Rerun the profiling scenario and terminate normally. From 88e6724e6f42f0ca4c36057f66f12955f32c16ad Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 19 Sep 2025 23:31:10 +0800 Subject: [PATCH 1248/1799] Add "Remarks" headings for warning references in range [PG1039, PG1087] --- .../tool-errors/profile-guided-optimization-warning-pg1039.md | 2 ++ .../tool-errors/profile-guided-optimization-warning-pg1087.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md index 96924083dd1..636ddc20239 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md @@ -10,4 +10,6 @@ ms.assetid: a67dfd66-b610-4d78-9658-2bcf7a506b9f > Failed waiting for quiet time to sweep. +## Remarks + The application did not allow [pgosweep](../../build/pgosweep.md) to run. If possible, run pgosweep when the application is in an idle state. diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md index 8ea3fc3b407..ca40a52823c 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md @@ -10,4 +10,6 @@ ms.assetid: 50785d68-17a2-4d82-bee2-8c514faf61c6 > The PGC file 'file' is not valid. +## Remarks + A .pgc file is corrupt, possibly due to an abnormal end to a profiling session. Rerun the profiling scenario and terminate normally. From 8644d4951a3c23e63edfa6f917756a5310c5f7db Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 19 Sep 2025 23:32:07 +0800 Subject: [PATCH 1249/1799] Update metadata for warning references in range [PG1039, PG1087] --- .../profile-guided-optimization-warning-pg1039.md | 5 ++--- .../profile-guided-optimization-warning-pg1087.md | 5 ++--- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md index 636ddc20239..1205a811698 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Profile-Guided Optimization Warning PG1039" title: "Profile-Guided Optimization Warning PG1039" -ms.date: "11/04/2016" +description: "Learn more about: Profile-Guided Optimization Warning PG1039" +ms.date: 11/04/2016 f1_keywords: ["PG1039"] helpviewer_keywords: ["PG1039"] -ms.assetid: a67dfd66-b610-4d78-9658-2bcf7a506b9f --- # Profile-Guided Optimization Warning PG1039 diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md index ca40a52823c..d68d8413ca6 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Profile-Guided Optimization Warning PG1087" title: "Profile-Guided Optimization Warning PG1087" -ms.date: "11/04/2016" +description: "Learn more about: Profile-Guided Optimization Warning PG1087" +ms.date: 11/04/2016 f1_keywords: ["PG1087"] helpviewer_keywords: ["PG1087"] -ms.assetid: 50785d68-17a2-4d82-bee2-8c514faf61c6 --- # Profile-Guided Optimization Warning PG1087 From 814cd8f511ec0b3e3961800ce71cd46a3d4eb8a7 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Fri, 19 Sep 2025 20:21:42 +0300 Subject: [PATCH 1250/1799] Document vectorized STL algorithms --- docs/standard-library/toc.yml | 3 + .../vectorized-stl-algoritms.md | 86 +++++++++++++++++++ 2 files changed, 89 insertions(+) create mode 100644 docs/standard-library/vectorized-stl-algoritms.md diff --git a/docs/standard-library/toc.yml b/docs/standard-library/toc.yml index ce3cb76ff56..b05a170940f 100644 --- a/docs/standard-library/toc.yml +++ b/docs/standard-library/toc.yml @@ -1588,6 +1588,9 @@ items: href: iterators.md - name: Algorithms href: algorithms.md + expanded: false + - name: Vectorized STL Algorithms + href: vectorized-stl-algorithms.md - name: Allocators href: allocators.md - name: Function objects in the C++ Standard Library diff --git a/docs/standard-library/vectorized-stl-algoritms.md b/docs/standard-library/vectorized-stl-algoritms.md new file mode 100644 index 00000000000..5bb6cd68f3d --- /dev/null +++ b/docs/standard-library/vectorized-stl-algoritms.md @@ -0,0 +1,86 @@ +--- +title: "Vectorized STL Algorithms" +ms.date: "09/19/2025" +helpviewer_keywords: ["Vector Algorithms", "Vectorization", "SIMD"] +--- +# Vectorized STL Algorithms + +Under certain conditions, STL algorithms execute not element-wise, but multiple element at once on a single CPU core. This is possible due to SIMD (single instruction, multiple data). The use of such approach instead of +element-wise approach is called vectorization. The implementation that is not vectorized is called scalar. + +The conditions for vectorization are: + - The container or range is contigous. `array`, `vector`, and `basic_string` are contigous containers, `span` and `basic_string_view` provide conditions ranges. + - There are such SIMD insstructions available for the target platform that implement the particular algorithm on particular element types efficiently. Usually this is true for plain types (like built-in integers) and simple operations. + - Either of the following: + - The compiler is capable emiting vectorized machine code for an implementation written as scalar code (auto-vectorization) + - The implementation itself is written as vectorized code (manual vectorization) + +## Auto-vectorization in STL + +See [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer). It applies to the STL implementation code the same way as to user code. + +Algorithms like `transform`, `reduce`, `accumulate` heavily benefit from auto-vectorization. + +## Manual vectorization in STL + +For x64 and x86 targets, certain algorithms have manual vectorization implemented. This implementation is pre-compiled, and uses runtime CPU dispatch, so it is engaged on suitable CPUs only. + +The manually vectorized algorithms use template meta-programming to detect the suitable element types, so they only vectorized for simple types, like standard integer types. + +Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. In case of any problem, you can disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS` macro set to 0. + +The following algorithms have manual vectorization controlled via `_USE_STD_VECTOR_ALGORITHMS` macro: + - `contains` + - `contains_subrange` + - `find` + - `find_last` + - `find_end` + - `find_first_of` + - `adjacent_find` + - `count` + - `mismatch` + - `search` + - `search_n` + - `swap_ranges` + - `replace` + - `remove` + - `remove_copy` + - `unique` + - `unique_copy` + - `reverse` + - `rotate` + - `is_sorted` + - `is_sorted_until` + - `minmax_element` + - `minmax` + - `lexicographical_compare` + - `lexicographical_compare_three_way` + +In addition to algorithms, the macro controls the manual vectorization of: + - `basic_string` and `basic_string_view` members: + - `find` + - `rfind` + - `find_first_of` + - `find_first_not_of` + - `find_last_of` + - `find_last_not_of` + - `bitset` constructors from string and `bitset::to_string` + +## Manually vectorized algorithms for floating point types + +Vectorization of floating point types is connected with extra difficulties: + - For floating point results, the order of operations may matter. Some reordering may yield a different result, whether more precise, or less precise. Vecotization may need operations reordering, so it may affect that. + - Floating point types may contain NaN values, which don't behave transitively while comparing. + - Floating point operations may raise exceptions. + +The STL deals with the first two difficulties safely. Only `minmax_element`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: + - Do not compute new floating point values, only compare the existing values, so different order does not affect precision. + - As sorting algorithms, require elements transitivity, so NaNs are not allowed as elements. + +There's `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating point types. Set it to 0 to disable the vectorization. The macro has no effect if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. + +`_USE_STD_VECTOR_FLOATING_ALGORITHMS` defaults to 0 when `/fp:except` option is set. This is to avoid problems with exceptions. + +## See also + +[Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) From 4272d7e48c4e459057854ea43a6790ac528fea09 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Fri, 19 Sep 2025 20:31:06 +0300 Subject: [PATCH 1251/1799] validation errors fix --- docs/standard-library/toc.yml | 1 + docs/standard-library/vectorized-stl-algoritms.md | 1 + 2 files changed, 2 insertions(+) diff --git a/docs/standard-library/toc.yml b/docs/standard-library/toc.yml index b05a170940f..e85567f4724 100644 --- a/docs/standard-library/toc.yml +++ b/docs/standard-library/toc.yml @@ -1589,6 +1589,7 @@ items: - name: Algorithms href: algorithms.md expanded: false + items: - name: Vectorized STL Algorithms href: vectorized-stl-algorithms.md - name: Allocators diff --git a/docs/standard-library/vectorized-stl-algoritms.md b/docs/standard-library/vectorized-stl-algoritms.md index 5bb6cd68f3d..e8e0b6a136e 100644 --- a/docs/standard-library/vectorized-stl-algoritms.md +++ b/docs/standard-library/vectorized-stl-algoritms.md @@ -1,4 +1,5 @@ --- +description: "Vectorized STL Algorithms" title: "Vectorized STL Algorithms" ms.date: "09/19/2025" helpviewer_keywords: ["Vector Algorithms", "Vectorization", "SIMD"] From cc385c5f0dcf78ffeafd16af30cc2cb75efbb8ca Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Fri, 19 Sep 2025 20:36:47 +0300 Subject: [PATCH 1252/1799] Un-nest to make that work --- docs/standard-library/toc.yml | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/toc.yml b/docs/standard-library/toc.yml index e85567f4724..a9a033ccd84 100644 --- a/docs/standard-library/toc.yml +++ b/docs/standard-library/toc.yml @@ -1588,10 +1588,8 @@ items: href: iterators.md - name: Algorithms href: algorithms.md - expanded: false - items: - - name: Vectorized STL Algorithms - href: vectorized-stl-algorithms.md +- name: Vectorized STL Algorithms + href: vectorized-stl-algorithms.md - name: Allocators href: allocators.md - name: Function objects in the C++ Standard Library From 86a3e29eff5f0cff3c8c2fa91c02e931a3bb3069 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Fri, 19 Sep 2025 20:42:50 +0300 Subject: [PATCH 1253/1799] Typo in file name --- ...vectorized-stl-algoritms.md => vectorized-stl-algorithms.md} | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) rename docs/standard-library/{vectorized-stl-algoritms.md => vectorized-stl-algorithms.md} (96%) diff --git a/docs/standard-library/vectorized-stl-algoritms.md b/docs/standard-library/vectorized-stl-algorithms.md similarity index 96% rename from docs/standard-library/vectorized-stl-algoritms.md rename to docs/standard-library/vectorized-stl-algorithms.md index e8e0b6a136e..dbe8f30073d 100644 --- a/docs/standard-library/vectorized-stl-algoritms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -28,7 +28,7 @@ For x64 and x86 targets, certain algorithms have manual vectorization implemente The manually vectorized algorithms use template meta-programming to detect the suitable element types, so they only vectorized for simple types, like standard integer types. -Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. In case of any problem, you can disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS` macro set to 0. +Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. In case of any problem, you can disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS` macro set to 0. It defaults to 1 on x64 and x86, which means that manually vectorized algorithms are enabled by default. The following algorithms have manual vectorization controlled via `_USE_STD_VECTOR_ALGORITHMS` macro: - `contains` From 53ae06f3ccc8576df13079077758633c2543e4d5 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Fri, 19 Sep 2025 20:52:14 +0300 Subject: [PATCH 1254/1799] Typoes --- docs/standard-library/vectorized-stl-algorithms.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index dbe8f30073d..f42e7065a94 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -7,13 +7,13 @@ helpviewer_keywords: ["Vector Algorithms", "Vectorization", "SIMD"] # Vectorized STL Algorithms Under certain conditions, STL algorithms execute not element-wise, but multiple element at once on a single CPU core. This is possible due to SIMD (single instruction, multiple data). The use of such approach instead of -element-wise approach is called vectorization. The implementation that is not vectorized is called scalar. +element-wise approach is called vectorization. An implementation that is not vectorized is called scalar. The conditions for vectorization are: - - The container or range is contigous. `array`, `vector`, and `basic_string` are contigous containers, `span` and `basic_string_view` provide conditions ranges. - - There are such SIMD insstructions available for the target platform that implement the particular algorithm on particular element types efficiently. Usually this is true for plain types (like built-in integers) and simple operations. + - The container or range is contigous. `array`, `vector`, and `basic_string` are contigous containers, `span` and `basic_string_view` provide contiguous ranges. + - There are such SIMD instructions available for the target platform that implement the particular algorithm on particular element types efficiently. Often this is true for plain types (like built-in integers) and simple operations. - Either of the following: - - The compiler is capable emiting vectorized machine code for an implementation written as scalar code (auto-vectorization) + - The compiler is capable of emitting vectorized machine code for an implementation written as scalar code (auto-vectorization) - The implementation itself is written as vectorized code (manual vectorization) ## Auto-vectorization in STL @@ -76,7 +76,7 @@ Vectorization of floating point types is connected with extra difficulties: The STL deals with the first two difficulties safely. Only `minmax_element`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: - Do not compute new floating point values, only compare the existing values, so different order does not affect precision. - - As sorting algorithms, require elements transitivity, so NaNs are not allowed as elements. + - As sorting algorithms, require transitivity of comparisons, so NaNs are not allowed as elements. There's `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating point types. Set it to 0 to disable the vectorization. The macro has no effect if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. From 7c4f6c6db78677fcd5936fe19fecca229531751c Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 19 Sep 2025 15:10:15 -0700 Subject: [PATCH 1255/1799] Update docs/error-messages/tool-errors/math-error-m6102.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/error-messages/tool-errors/math-error-m6102.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/math-error-m6102.md b/docs/error-messages/tool-errors/math-error-m6102.md index fe151670999..d9503b18f96 100644 --- a/docs/error-messages/tool-errors/math-error-m6102.md +++ b/docs/error-messages/tool-errors/math-error-m6102.md @@ -11,6 +11,6 @@ helpviewer_keywords: ["M6102"] ## Remarks -An operation generated a very small floating-point number, which be invalid due loss of significance. Denormal floating-point exceptions are usually masked, causing them to be trapped and operated upon. +An operation generated a very small floating-point number, which may be invalid due to loss of significance. Denormal floating-point exceptions are usually masked, causing them to be trapped and operated upon. Program terminates with exit code 130. From de8f2e447b34cfa2bf0256f628e1fc257bc56198 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 19 Sep 2025 16:25:04 -0700 Subject: [PATCH 1256/1799] Fix formatting in linker tools error messages --- .../tool-errors/linker-tools-errors-and-warnings.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md index cec2c86b223..102d426b6e8 100644 --- a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md @@ -68,7 +68,7 @@ The linker tools LINK, LIB, DUMPBIN, and EDITBIN share a common executable that | [Linker Tools Error LNK1313](linker-tools-error-lnk1313.md) | ijw/native module detected; cannot link with pure modules | | [Linker Tools Error LNK1314](linker-tools-error-lnk1314.md) | corrupt or invalid COFF symbol table (undefined static or label symbol) | | [Linker Tools Error LNK1318](linker-tools-error-lnk1318.md) | Unexpected PDB error; *cause* '*details*' | -| [Linker Tools Error LNK1332](linker-tools-error-lnk1332.md) | detected\ Windows Runtime types imported in one module and defined in another module | +| [Linker Tools Error LNK1332](linker-tools-error-lnk1332.md) | detected \ Windows Runtime types imported in one module and defined in another module | | [Linker Tools Error LNK1352](linker-tools-error-lnk1352.md) | '*section_name_1*' and '*section_name_2*' cannot be merged into different sections | | [Linker Tools Error LNK1561](linker-tools-error-lnk1561.md) | entry point must be defined | | [Linker Tools Error LNK2001](linker-tools-error-lnk2001.md) | unresolved external symbol "*symbol*" | @@ -88,7 +88,7 @@ The linker tools LINK, LIB, DUMPBIN, and EDITBIN share a common executable that | [Linker Tools Error LNK2031](linker-tools-error-lnk2031.md) | unable to generate p/invoke for "*function_declaration*" *decorated_name*; calling convention missing in metadata | | [Linker Tools Error LNK2033](linker-tools-error-lnk2033.md) | unresolved typeref token (token) for 'type' | | [Linker Tools Error LNK2038](linker-tools-error-lnk2038.md) | mismatch detected for '*name*': value '*value_1*' doesn't match value '*value_2*' in *filename.obj* | -| [Linker Tools Error LNK2039](linker-tools-error-lnk2039.md) | importing ref class '\' that is defined in another.obj; it should be either imported or defined, but not both | +| [Linker Tools Error LNK2039](linker-tools-error-lnk2039.md) | importing ref class \ that is defined in another.obj; it should be either imported or defined, but not both | ## Linker tools warnings From 09237930c5c9a743f4dcf8b1921ffa08fde55b87 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 20 Sep 2025 18:42:09 +0800 Subject: [PATCH 1257/1799] Fix mismatched error/warning code in example leading sentences --- docs/error-messages/compiler-errors-1/compiler-error-c2201.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2250.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2380.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2391.md | 2 +- docs/error-messages/compiler-errors-1/compiler-error-c2449.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2652.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3239.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3469.md | 2 +- .../compiler-warnings/compiler-warning-level-1-c4544.md | 2 +- .../compiler-warnings/compiler-warning-level-3-c4580.md | 2 +- docs/error-messages/tool-errors/command-line-warning-d9043.md | 2 +- 11 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md index 01983a4cf4a..4be33f800de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md @@ -15,7 +15,7 @@ The exported identifier is **`static`**. ## Example -The following example generates C2286, and shows how to fix it: +The following example generates C2201, and shows how to fix it: ```cpp // C2201.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md index 90762d9a529..5e30d649e82 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md @@ -15,7 +15,7 @@ The derived class inherits more than one override of a virtual function of a vir ## Example -The following example generates C2286: +The following example generates C2250: ```cpp // C2250.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md index 9b317bd13db..a0745e12c88 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md @@ -15,7 +15,7 @@ A constructor returns a value or redefines the class name. ## Example -The following example generates C2326: +The following example generates C2380: ```cpp // C2380.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md index dcf10dedd8e..283aeb7e762 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md @@ -15,7 +15,7 @@ The **`friend`** declaration includes a complete class declaration. A **`friend` ## Example -The following example generates C2326: +The following example generates C2391: ```cpp // C2391.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md index aee2034191e..b99392c66d8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md @@ -17,7 +17,7 @@ This error can be caused by a semicolon between a function header and the openin ## Example -The following example generates C2499: +The following example generates C2449: ```c // C2449.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md index 062e00a09ed..5e7e2f0ee85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md @@ -15,7 +15,7 @@ The first parameter in the copy constructor has the same type as the class, stru ## Example -The following example generates C2651: +The following example generates C2652: ```cpp // C2652.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md index 58302dfdb41..c214f06fe32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md @@ -15,7 +15,7 @@ The compiler encountered an invalid type. ## Example -The following example generates C3229: +The following example generates C3239: ```cpp // C3239.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md index 3977e7f2c58..e835ecfbecf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md @@ -28,7 +28,7 @@ public ref class GR {}; public ref class GR2 {}; ``` -The following example generates C3466. +The following example generates C3469. ```cpp // C3469_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md index 0ba1ee5249a..d8c3396c024 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md @@ -15,7 +15,7 @@ A default template argument was specified in an incorrect location and was ignor ## Example -This example generates C4545, and the next example shows how to fix it: +This example generates C4544, and the next example shows how to fix it: ```cpp // C4544.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md index 479016f20c6..f8d07e1f61a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md @@ -15,7 +15,7 @@ helpviewer_keywords: ["C4580"] ## Example -The following example generates C3454 and shows how to fix it. +The following example generates C4580 and shows how to fix it. ```cpp // C4580.cpp diff --git a/docs/error-messages/tool-errors/command-line-warning-d9043.md b/docs/error-messages/tool-errors/command-line-warning-d9043.md index 73931bcab16..099489e25ac 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9043.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9043.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["D9043"] ## Example -The following example generates C9043. +The following example generates D9043. ```cpp // D9043.cpp From a36c5a8ef181ee51c34b7124930b329d5df075f9 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Sat, 20 Sep 2025 16:14:12 +0300 Subject: [PATCH 1258/1799] Spelling --- docs/standard-library/vectorized-stl-algorithms.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index f42e7065a94..01cf8e48e2c 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -10,7 +10,7 @@ Under certain conditions, STL algorithms execute not element-wise, but multiple element-wise approach is called vectorization. An implementation that is not vectorized is called scalar. The conditions for vectorization are: - - The container or range is contigous. `array`, `vector`, and `basic_string` are contigous containers, `span` and `basic_string_view` provide contiguous ranges. + - The container or range is contiguous. `array`, `vector`, and `basic_string` are contiguous containers, `span` and `basic_string_view` provide contiguous ranges. - There are such SIMD instructions available for the target platform that implement the particular algorithm on particular element types efficiently. Often this is true for plain types (like built-in integers) and simple operations. - Either of the following: - The compiler is capable of emitting vectorized machine code for an implementation written as scalar code (auto-vectorization) @@ -70,7 +70,7 @@ In addition to algorithms, the macro controls the manual vectorization of: ## Manually vectorized algorithms for floating point types Vectorization of floating point types is connected with extra difficulties: - - For floating point results, the order of operations may matter. Some reordering may yield a different result, whether more precise, or less precise. Vecotization may need operations reordering, so it may affect that. + - For floating point results, the order of operations may matter. Some reordering may yield a different result, whether more precise, or less precise. Vectotization may need operations reordering, so it may affect that. - Floating point types may contain NaN values, which don't behave transitively while comparing. - Floating point operations may raise exceptions. From 6c10dc3d959d1c4fba7a4334cc3be332d0fe2001 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Sat, 20 Sep 2025 16:20:38 +0300 Subject: [PATCH 1259/1799] Complete the lists --- docs/standard-library/vectorized-stl-algorithms.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 01cf8e48e2c..b2266592808 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -49,10 +49,15 @@ The following algorithms have manual vectorization controlled via `_USE_STD_VECT - `unique` - `unique_copy` - `reverse` + - `reverse_copy` - `rotate` - `is_sorted` - `is_sorted_until` + - `max_element` + - `min_element` - `minmax_element` + - `max` + - `min` - `minmax` - `lexicographical_compare` - `lexicographical_compare_three_way` @@ -74,7 +79,7 @@ Vectorization of floating point types is connected with extra difficulties: - Floating point types may contain NaN values, which don't behave transitively while comparing. - Floating point operations may raise exceptions. -The STL deals with the first two difficulties safely. Only `minmax_element`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: +The STL deals with the first two difficulties safely. Only `max_element`, `min_element`, `minmax_element`, `max`, `min`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: - Do not compute new floating point values, only compare the existing values, so different order does not affect precision. - As sorting algorithms, require transitivity of comparisons, so NaNs are not allowed as elements. From b1600d8e3cf80cfa66563faa548ba8b14bf8fbcf Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Sat, 20 Sep 2025 17:27:07 +0300 Subject: [PATCH 1260/1799] Update docs/standard-library/vectorized-stl-algorithms.md Co-authored-by: Rageking8 --- docs/standard-library/vectorized-stl-algorithms.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index b2266592808..eb94e128209 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -1,8 +1,9 @@ --- -description: "Vectorized STL Algorithms" title: "Vectorized STL Algorithms" -ms.date: "09/19/2025" -helpviewer_keywords: ["Vector Algorithms", "Vectorization", "SIMD"] +description: "Learn more about: Vectorized STL Algorithms" +ms.date: 09/19/2025 +f1_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS"] +helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS", "Vector Algorithms", "Vectorization", "SIMD"] --- # Vectorized STL Algorithms From becc300baab1cdf3dae36f50ba33c1380ac7f4f4 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Sat, 20 Sep 2025 17:31:10 +0300 Subject: [PATCH 1261/1799] Review comments Co-authored-by: Rageking8 --- docs/standard-library/vectorized-stl-algorithms.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index eb94e128209..05ecd40526a 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -7,8 +7,7 @@ helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_AL --- # Vectorized STL Algorithms -Under certain conditions, STL algorithms execute not element-wise, but multiple element at once on a single CPU core. This is possible due to SIMD (single instruction, multiple data). The use of such approach instead of -element-wise approach is called vectorization. An implementation that is not vectorized is called scalar. +Under certain conditions, STL algorithms execute not element-wise, but multiple element at once on a single CPU core. This is possible due to SIMD (single instruction, multiple data). The use of such approach instead of element-wise approach is called vectorization. An implementation that is not vectorized is called scalar. The conditions for vectorization are: - The container or range is contiguous. `array`, `vector`, and `basic_string` are contiguous containers, `span` and `basic_string_view` provide contiguous ranges. @@ -52,7 +51,7 @@ The following algorithms have manual vectorization controlled via `_USE_STD_VECT - `reverse` - `reverse_copy` - `rotate` - - `is_sorted` + - `is_sorted` - `is_sorted_until` - `max_element` - `min_element` @@ -76,7 +75,7 @@ In addition to algorithms, the macro controls the manual vectorization of: ## Manually vectorized algorithms for floating point types Vectorization of floating point types is connected with extra difficulties: - - For floating point results, the order of operations may matter. Some reordering may yield a different result, whether more precise, or less precise. Vectotization may need operations reordering, so it may affect that. + - For floating point results, the order of operations may matter. Some reordering may yield a different result, whether more precise, or less precise. Vectorization may need operations reordering, so it may affect that. - Floating point types may contain NaN values, which don't behave transitively while comparing. - Floating point operations may raise exceptions. @@ -86,7 +85,7 @@ The STL deals with the first two difficulties safely. Only `max_element`, `min_e There's `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating point types. Set it to 0 to disable the vectorization. The macro has no effect if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. -`_USE_STD_VECTOR_FLOATING_ALGORITHMS` defaults to 0 when `/fp:except` option is set. This is to avoid problems with exceptions. +`_USE_STD_VECTOR_FLOATING_ALGORITHMS` defaults to 0 when [`/fp:except`](../build/reference/fp-specify-floating-point-behavior.md#except) option is set. This is to avoid problems with exceptions. ## See also From 6436e1e6ef3c5ab64a15557e05221240ea7374f7 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 20 Sep 2025 22:32:42 +0800 Subject: [PATCH 1262/1799] Add blockquotes for error messages in range [LNK1000, LNK1220] --- docs/error-messages/tool-errors/linker-tools-error-lnk1103.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1106.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1113.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1127.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1136.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1140.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1141.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1143.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1152.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1158.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1164.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1166.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1168.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1169.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1179.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1181.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1188.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1189.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1196.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1200.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1201.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1215.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1218.md | 2 +- 23 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md index 69a19334cb3..b8df816904d 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md @@ -8,7 +8,7 @@ ms.assetid: c8e9bc54-6a71-471c-899e-6f98122ee3c4 --- # Linker Tools Error LNK1103 -debugging information corrupt; recompile module +> debugging information corrupt; recompile module This error can be caused because the compilation was terminated before a valid object file was created. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md index f1227a53aa8..442b06e4ddb 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md @@ -8,7 +8,7 @@ ms.assetid: 528f7e65-04be-4966-b8af-9276837c7cda --- # Linker Tools Error LNK1106 -invalid file or disk full: cannot seek to location +> invalid file or disk full: cannot seek to location The tool could not read or write to `location` in a memory-mapped file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md index aaafcbbcded..67b37c07638 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md @@ -8,7 +8,7 @@ ms.assetid: 269ff166-b143-48e9-bdf7-db6a0db59fe4 --- # Linker Tools Error LNK1113 -invalid machine type type +> invalid machine type type The machine type specified in the object header is not valid. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md index 85695de1e0c..a5116e4e93c 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md @@ -8,6 +8,6 @@ ms.assetid: 45404700-1420-4f24-97e1-efb7252ffd8f --- # Linker Tools Error LNK1127 -library is corrupt +> library is corrupt The library file is corrupt. Rebuild the library. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md index 3178558c899..1e3c1d44aa9 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md @@ -8,7 +8,7 @@ ms.assetid: 40c6d909-eb3f-4045-a0fc-4caa2f6db506 --- # Linker Tools Error LNK1136 -invalid or corrupt file +> invalid or corrupt file The input file either has a corrupt header or is zero size or abnormally small. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md index 122f869f78d..726796e4357 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md @@ -8,7 +8,7 @@ ms.assetid: 468d7651-a7cd-47b9-aead-5bb2fab56121 --- # Linker Tools Error LNK1140 -too many modules for program database; link with /PDB:NONE +> too many modules for program database; link with /PDB:NONE The project contains more than 4096 modules. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md index 6f75fcc90a4..f8c40c36e25 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md @@ -8,7 +8,7 @@ ms.assetid: 83b78606-6dd3-43a7-88e2-152f5359cbd8 --- # Linker Tools Error LNK1141 -failure during build of exports file +> failure during build of exports file [LINK](../../build/reference/linking.md) could not build the exports (.exp) file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md index 0e06f04ee32..8ed3e0b10e8 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md @@ -8,7 +8,7 @@ ms.assetid: 5dc6b634-d142-4448-b5ea-48e8fb10c10a --- # Linker Tools Error LNK1143 -invalid or corrupt file: no symbol for COMDAT section number +> invalid or corrupt file: no symbol for COMDAT section number This error can be caused if the object file is corrupt. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md index 5929d7abbf6..ff27052c79e 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md @@ -8,6 +8,6 @@ ms.assetid: 2523b61a-1359-4612-9c16-7d1f705f32e6 --- # Linker Tools Error LNK1152 -cannot resolve one or more undecorated symbols +> cannot resolve one or more undecorated symbols This error is preceded by one warning [LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) for each undecorated symbol that could not be resolved and by at least two warnings [LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) for the duplicate symbols found for the undecorated symbol. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md index f2350017bc0..ebbd8261824 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md @@ -8,7 +8,7 @@ ms.assetid: 45febf16-d9e1-42db-af91-532e2717fd6a --- # Linker Tools Error LNK1158 -cannot run 'filename' +> cannot run 'filename' The given executable file called by [LINK](../../build/reference/linking.md) is not in the directory that contains LINK nor in a directory specified in the PATH environment variable. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md index dbcffd442ea..a0ceb437276 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md @@ -8,7 +8,7 @@ ms.assetid: da89765c-affa-4f88-b170-6d6b19a577cf --- # Linker Tools Error LNK1164 -section section alignment (number) greater than /ALIGN value +> section section alignment (number) greater than /ALIGN value The alignment size for the given section in the object file exceeds the value specified with the [/ALIGN](../../build/reference/align-section-alignment.md) option. The **/ALIGN** value must be a power of 2 and must equal or exceed the section alignment given in the object file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md index b67c5fb58e5..736756fce51 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md @@ -8,7 +8,7 @@ ms.assetid: d69548a8-0efb-44e1-90b7-b27636a4b575 --- # Linker Tools Error LNK1166 -cannot adjust code at offset=offset, va=value +> cannot adjust code at offset=offset, va=value LINK was unable to pad the code as required. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md index 78fddef3f0a..273d662b5d7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md @@ -8,7 +8,7 @@ ms.assetid: 97ead151-fd99-46fe-9a1d-7e84dc0b8cc8 --- # Linker Tools Error LNK1168 -cannot open filename for writing +> cannot open filename for writing The linker can't write to `filename`. The file may be in use and its file handle locked by another process, or you may not have write permission for the file, or for the directory or network share it is located in. This error is often caused by a transient condition—for example, a lock held by an anti-virus program, a file search indexing process, or a delay in releasing a lock held by the Visual Studio build system. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md index f3355d082cd..f06dabc9782 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md @@ -8,7 +8,7 @@ ms.assetid: e079d518-f184-48cd-8b38-969bf137af54 --- # Linker Tools Error LNK1169 -one or more multiply defined symbols found +> one or more multiply defined symbols found The build failed due to multiple definitions of one or more symbols. This error is preceded by error [LNK2005](../../error-messages/tool-errors/linker-tools-error-lnk2005.md). diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md index 6b95e3bc95d..e131b61f1f5 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md @@ -8,7 +8,7 @@ ms.assetid: 4b1536d7-0d3d-4f29-a9c1-6fa5cf6cb665 --- # Linker Tools Error LNK1179 -invalid or corrupt file: duplicate COMDAT 'filename' +> invalid or corrupt file: duplicate COMDAT 'filename' An object module contains two or more COMDATs with the same name. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md index 0a8bdc45693..9308870843a 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md @@ -8,7 +8,7 @@ ms.assetid: 984b0db6-e331-4284-b2a7-a212fe96c486 --- # Linker Tools Error LNK1181 -cannot open input file 'filename' +> cannot open input file 'filename' The linker could not find `filename` because it does not exist or the path was not found. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md index f5800616ee0..6ff1bc26fc8 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md @@ -8,6 +8,6 @@ ms.assetid: 4af574b0-5b41-4580-9a37-52a634add995 --- # Linker Tools Error LNK1188 -BADFIXUPSECTION:: invalid fixup target 'symbol'; possible zero length section +> BADFIXUPSECTION:: invalid fixup target 'symbol'; possible zero length section During a VxD link, the target of a relocation did not have a section. With LINK386 (an older version), an OMF GROUP record (generated by a MASM GROUP directive) may have been used to combine the zero length section with another non-zero length section. COFF format does not support the GROUP directive and zero-length sections. When LINK automatically converts this type of OMF objects to COFF, this error may occur. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md index fc1bfb4f8d4..7bd85921eb5 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md @@ -8,7 +8,7 @@ ms.assetid: 40c45302-6967-497e-9a6e-c2ca039fc1ed --- # Linker Tools Error LNK1189 -LIBTOOMANYMEMBERS:: library limit of number objects exceeded +> LIBTOOMANYMEMBERS:: library limit of number objects exceeded The limit of 65535 objects or members in a library has been exceeded. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md index 050af899a89..425506541af 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md @@ -8,6 +8,6 @@ ms.assetid: d0c6859b-85aa-45cc-9f5f-fc1f7070ab5a --- # Linker Tools Error LNK1196 -invalid or corrupt import object: unknown version +> invalid or corrupt import object: unknown version The import library is corrupted. Rebuild the library. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md index c07c0b16e83..cda3198afdf 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md @@ -8,7 +8,7 @@ ms.assetid: 55771145-915e-4006-ac6c-ac702041eb2f --- # Linker Tools Error LNK1200 -error reading program database 'filename' +> error reading program database 'filename' The program database (PDB) could not be read. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md index 8e8f1888c04..31f25970faf 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md @@ -8,7 +8,7 @@ ms.assetid: 64c3f496-a428-4b54-981e-faa82ef9c8a1 --- # Linker Tools Error LNK1201 -error writing to program database 'filename'; check for insufficient disk space, invalid path, or insufficient privilege +> error writing to program database 'filename'; check for insufficient disk space, invalid path, or insufficient privilege LINK could not write to the program database (PDB) for the output file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md index 2323a27f564..35901c0c6e7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md @@ -8,7 +8,7 @@ ms.assetid: 0774d8e6-f0c1-4efb-8723-7e1be6863d81 --- # Linker Tools Error LNK1215 -metadata operation failed (HRESULT) : error +> metadata operation failed (HRESULT) : error The linker received an error from the .NET runtime while attempting to do a metadata update through the .NET runtime. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md index 624fcb6ca33..7f35a629126 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md @@ -8,7 +8,7 @@ ms.assetid: bf599350-be03-4344-be43-91e29c4f1556 --- # Linker Tools Error LNK1218 -warning treated as error; no output file generated +> warning treated as error; no output file generated When you link with **/WX**, any linker warnings will be treated as errors, and no output file will be created. From 1a601e97054e13865f2b074b9b881d4bd005e1e9 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 20 Sep 2025 22:36:51 +0800 Subject: [PATCH 1263/1799] Add "Remarks" headings for error references in range [LNK1000, LNK1220] --- docs/error-messages/tool-errors/linker-tools-error-lnk1000.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1103.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1104.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1106.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1107.md | 4 ++-- docs/error-messages/tool-errors/linker-tools-error-lnk1113.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1120.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1123.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1127.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1136.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1140.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1141.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1143.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1152.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1158.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1164.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1166.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1168.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1169.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1170.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1179.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1181.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1188.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1189.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1196.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1200.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1201.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1211.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1215.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1218.md | 2 ++ 30 files changed, 60 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md index 31e9114a632..12800cd9829 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md @@ -10,6 +10,8 @@ ms.assetid: 86421b9a-460a-4285-8dce-9b8257d78122 > unknown error; consult documentation for technical support options +## Remarks + Note the circumstances of the error, then try to isolate the problem and create a reproducible test case. For information on how to investigate and report these errors, see [How to report a problem with the Visual C++ toolset or documentation](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md). You may get this error if you mix standard header files (for example, Windows.h) and your own files. Include a precompiled header, if any, first, then the standard headers, followed by your own header files. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md index b8df816904d..5e0b787a210 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md @@ -10,6 +10,8 @@ ms.assetid: c8e9bc54-6a71-471c-899e-6f98122ee3c4 > debugging information corrupt; recompile module +## Remarks + This error can be caused because the compilation was terminated before a valid object file was created. Recompile the given object file. If recompiling does not correct the problem, note the circumstances of the error, try to isolate the problem, and create a reproducible test case. Then consult the technical-support help file, or the technical-support section in one of your manuals. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md index dd6c44187f2..408a3424262 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md @@ -10,6 +10,8 @@ ms.assetid: 9ca6f929-0efc-4055-8354-3cf5b4e636dc > cannot open file '*filename*' +## Remarks + This error is reported when the linker fails to open a file, either for reading or for writing. The two most common causes of the issue are: - your program is already running or is loaded in the debugger, and diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md index 442b06e4ddb..8609fb21f4e 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md @@ -10,6 +10,8 @@ ms.assetid: 528f7e65-04be-4966-b8af-9276837c7cda > invalid file or disk full: cannot seek to location +## Remarks + The tool could not read or write to `location` in a memory-mapped file. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md index af391885733..4933bd196f4 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["LNK1107"] > invalid or corrupt file: cannot read at location *address* -The tool couldn't read the file. The file may be corrupt, or have an unexpected file type. - ## Remarks +The tool couldn't read the file. The file may be corrupt, or have an unexpected file type. + LNK1107 can occur if a file passed to the linker or related tools is corrupt. To resolve this issue, rebuild the file. LNK1107 can also occur if your build process puts an unexpected file type in the list of files passed to the tool. The linker and related tools expect to work on specific file types. For example, the linker can use object files, library files, compiled resources, and manifests to create an executable. It can't create an executable by using source files or DLLs. To resolve this issue, verify that your build process passes only the expected file types to the tool. For example, pass *`.obj`*, *`.lib`*, and *`.res`* files, not *`.cpp`*, *`.h`*, *`.dll`*, or *`.rc`* files. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md index 67b37c07638..44a0f634a12 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md @@ -10,6 +10,8 @@ ms.assetid: 269ff166-b143-48e9-bdf7-db6a0db59fe4 > invalid machine type type +## Remarks + The machine type specified in the object header is not valid. This error can be caused if the file is corrupt. Rebuild the object. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md index 62a290603e5..614cc9034c1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md @@ -10,6 +10,8 @@ ms.assetid: 56aa7d36-921f-4daf-b44d-cca0d4fb1b51 > *number* unresolved externals +## Remarks + Error LNK1120 reports the number of [unresolved external symbol](linker-tools-error-lnk2001.md#what-is-an-unresolved-external-symbol) errors in the current link. Each unresolved external symbol first gets reported by a [LNK2001](linker-tools-error-lnk2001.md) or [LNK2019](linker-tools-error-lnk2019.md) error. The LNK1120 message comes last, and shows the unresolved symbol error count. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md index 07bfa2d8cc8..1d4d923ecf8 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK1123"] > failure during conversion to COFF: file invalid or corrupt +## Remarks + Input files must have the Common Object File Format (COFF) format. If an input file is not COFF, the linker automatically tries to convert 32-bit OMF objects to COFF, or runs CVTRES.EXE to convert resource files. This message indicates that the linker could not convert the file. This can also occur when using an incompatible version of CVTRES.EXE from another installation of Visual Studio, the Windows Development Kit, or .NET Framework. > [!NOTE] diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md index a5116e4e93c..0c57c055ea7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md @@ -10,4 +10,6 @@ ms.assetid: 45404700-1420-4f24-97e1-efb7252ffd8f > library is corrupt +## Remarks + The library file is corrupt. Rebuild the library. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md index 1e3c1d44aa9..65bfc5c2499 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md @@ -10,6 +10,8 @@ ms.assetid: 40c6d909-eb3f-4045-a0fc-4caa2f6db506 > invalid or corrupt file +## Remarks + The input file either has a corrupt header or is zero size or abnormally small. LNK1136 may also be caused if the file was incorrectly specified as an additional dependency. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md index 726796e4357..8410c19e59e 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md @@ -10,6 +10,8 @@ ms.assetid: 468d7651-a7cd-47b9-aead-5bb2fab56121 > too many modules for program database; link with /PDB:NONE +## Remarks + The project contains more than 4096 modules. ### To fix by using the following possible solutions diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md index f8c40c36e25..0db826ead4e 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md @@ -10,6 +10,8 @@ ms.assetid: 83b78606-6dd3-43a7-88e2-152f5359cbd8 > failure during build of exports file +## Remarks + [LINK](../../build/reference/linking.md) could not build the exports (.exp) file. Causes of this error include system problems such as insufficient memory and syntax errors in options or module-definition statements. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md index 8ed3e0b10e8..55c29d4569d 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md @@ -10,6 +10,8 @@ ms.assetid: 5dc6b634-d142-4448-b5ea-48e8fb10c10a > invalid or corrupt file: no symbol for COMDAT section number +## Remarks + This error can be caused if the object file is corrupt. Rebuild the file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md index ff27052c79e..d4297c40e50 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md @@ -10,4 +10,6 @@ ms.assetid: 2523b61a-1359-4612-9c16-7d1f705f32e6 > cannot resolve one or more undecorated symbols +## Remarks + This error is preceded by one warning [LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) for each undecorated symbol that could not be resolved and by at least two warnings [LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) for the duplicate symbols found for the undecorated symbol. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md index ebbd8261824..10a01aaccbb 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md @@ -10,6 +10,8 @@ ms.assetid: 45febf16-d9e1-42db-af91-532e2717fd6a > cannot run 'filename' +## Remarks + The given executable file called by [LINK](../../build/reference/linking.md) is not in the directory that contains LINK nor in a directory specified in the PATH environment variable. For example, you will get this error if you try to use the PGOPTIMIZE parameter to the [/LTCG](../../build/reference/ltcg-link-time-code-generation.md) linker option on a machine with a 32-bit operating system. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md index a0ceb437276..4946654a889 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md @@ -10,6 +10,8 @@ ms.assetid: da89765c-affa-4f88-b170-6d6b19a577cf > section section alignment (number) greater than /ALIGN value +## Remarks + The alignment size for the given section in the object file exceeds the value specified with the [/ALIGN](../../build/reference/align-section-alignment.md) option. The **/ALIGN** value must be a power of 2 and must equal or exceed the section alignment given in the object file. Either recompile with a smaller section alignment or increase the **/ALIGN** value. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md index 736756fce51..4c829eadb87 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md @@ -10,6 +10,8 @@ ms.assetid: d69548a8-0efb-44e1-90b7-b27636a4b575 > cannot adjust code at offset=offset, va=value +## Remarks + LINK was unable to pad the code as required. Certain instructions are not allowed to cross page boundaries on some processors. LINK attempts to add pads to correct this situation. In this case, LINK could not work around the problem. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md index 273d662b5d7..32fb85103cf 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md @@ -10,6 +10,8 @@ ms.assetid: 97ead151-fd99-46fe-9a1d-7e84dc0b8cc8 > cannot open filename for writing +## Remarks + The linker can't write to `filename`. The file may be in use and its file handle locked by another process, or you may not have write permission for the file, or for the directory or network share it is located in. This error is often caused by a transient condition—for example, a lock held by an anti-virus program, a file search indexing process, or a delay in releasing a lock held by the Visual Studio build system. To fix this issue, verify that the `filename` file handle is not locked, and that you have write permission for the file. If it is an executable, verify that it is not already running. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md index f06dabc9782..b2ae304069c 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md @@ -10,6 +10,8 @@ ms.assetid: e079d518-f184-48cd-8b38-969bf137af54 > one or more multiply defined symbols found +## Remarks + The build failed due to multiple definitions of one or more symbols. This error is preceded by error [LNK2005](../../error-messages/tool-errors/linker-tools-error-lnk2005.md). The [/FORCE](../../build/reference/force-force-file-output.md) or **/FORCE:MULTIPLE** option overrides this error. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md index 7b4979f8e5b..0de2b0a6e32 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md @@ -10,6 +10,8 @@ ms.assetid: e079d518-f184-48cd-8b38-969bf137af54 > line in command file contains *maximum-length* or more characters +## Remarks + The build failed because a line in a command response file was too long. A line in an automatically generated response file may be too long for many reasons. For example, this error may occur if the number of object file names is too high. Or, if the combined lengths of the paths included in object file names is too long. The appropriate fix for this issue depends on the cause. For example, if it's caused by long paths in object file names, you may try to shorten the directory names in the path. Or, move the project tree into a directory closer to the root of the drive. You may want to break up how response files are generated and consumed by your build system, for instance, by generating some code as static libraries. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md index e131b61f1f5..f1b8d37e0d4 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md @@ -10,6 +10,8 @@ ms.assetid: 4b1536d7-0d3d-4f29-a9c1-6fa5cf6cb665 > invalid or corrupt file: duplicate COMDAT 'filename' +## Remarks + An object module contains two or more COMDATs with the same name. This error can be caused by using [/H](../../build/reference/h-restrict-length-of-external-names.md), which limits the length of external names, and [/Gy](../../build/reference/gy-enable-function-level-linking.md), which packages functions in COMDATs. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md index 9308870843a..cc641ba3823 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md @@ -10,6 +10,8 @@ ms.assetid: 984b0db6-e331-4284-b2a7-a212fe96c486 > cannot open input file 'filename' +## Remarks + The linker could not find `filename` because it does not exist or the path was not found. Some common causes for error LNK1181 include: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md index 6ff1bc26fc8..3702c3efd3b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md @@ -10,4 +10,6 @@ ms.assetid: 4af574b0-5b41-4580-9a37-52a634add995 > BADFIXUPSECTION:: invalid fixup target 'symbol'; possible zero length section +## Remarks + During a VxD link, the target of a relocation did not have a section. With LINK386 (an older version), an OMF GROUP record (generated by a MASM GROUP directive) may have been used to combine the zero length section with another non-zero length section. COFF format does not support the GROUP directive and zero-length sections. When LINK automatically converts this type of OMF objects to COFF, this error may occur. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md index 7bd85921eb5..ba74f99ed08 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md @@ -10,6 +10,8 @@ ms.assetid: 40c45302-6967-497e-9a6e-c2ca039fc1ed > LIBTOOMANYMEMBERS:: library limit of number objects exceeded +## Remarks + The limit of 65535 objects or members in a library has been exceeded. To fix this issue, split your library into two or more libraries with fewer objects or members. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md index 425506541af..4974338f5ac 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md @@ -10,4 +10,6 @@ ms.assetid: d0c6859b-85aa-45cc-9f5f-fc1f7070ab5a > invalid or corrupt import object: unknown version +## Remarks + The import library is corrupted. Rebuild the library. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md index cda3198afdf..1be547f32a2 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md @@ -10,6 +10,8 @@ ms.assetid: 55771145-915e-4006-ac6c-ac702041eb2f > error reading program database 'filename' +## Remarks + The program database (PDB) could not be read. This error can be caused by file corruption. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md index 31f25970faf..bab142fed66 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md @@ -10,6 +10,8 @@ ms.assetid: 64c3f496-a428-4b54-981e-faa82ef9c8a1 > error writing to program database 'filename'; check for insufficient disk space, invalid path, or insufficient privilege +## Remarks + LINK could not write to the program database (PDB) for the output file. ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md index 0cdaf996a71..5a939ce270f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md @@ -10,6 +10,8 @@ ms.assetid: 607400eb-4180-4892-817f-eedfa628af61 > precompiled type information not found; '*filename*' not linked or overwritten +## Remarks + The *filename* object file, compiled by using [/Yc](../../build/reference/yc-create-precompiled-header-file.md), was not specified in the LINK command or was overwritten. If you are creating a debug library that uses precompiled headers and if you specify **/Yc** and [/Z7](../../build/reference/z7-zi-zi-debug-information-format.md), Visual C++ generates a precompiled object file that contains debug information. The error occurs only when you store the precompiled object file in a library, use the library to build an executable image, and the object files that are referenced have no transitive references to any of the functions the precompiled object file defines. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md index 35901c0c6e7..0a591c7454a 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md @@ -10,6 +10,8 @@ ms.assetid: 0774d8e6-f0c1-4efb-8723-7e1be6863d81 > metadata operation failed (HRESULT) : error +## Remarks + The linker received an error from the .NET runtime while attempting to do a metadata update through the .NET runtime. `HRESULT` is the HRESULT from the .NET runtime method. `error` is the .NET-supplied text. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md index 7f35a629126..254d5fc21fa 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md @@ -10,6 +10,8 @@ ms.assetid: bf599350-be03-4344-be43-91e29c4f1556 > warning treated as error; no output file generated +## Remarks + When you link with **/WX**, any linker warnings will be treated as errors, and no output file will be created. See [/WX (Treat Linker Warnings as Errors)](../../build/reference/wx-treat-linker-warnings-as-errors.md) for more information. From a90437ce598ff978ddf82b5fce9446089fd3f39a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 20 Sep 2025 22:42:14 +0800 Subject: [PATCH 1264/1799] Update metadata for error references in range [LNK1000, LNK1220] --- .../error-messages/tool-errors/linker-tools-error-lnk1000.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1103.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1104.md | 3 +-- .../error-messages/tool-errors/linker-tools-error-lnk1106.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1107.md | 2 +- .../error-messages/tool-errors/linker-tools-error-lnk1112.md | 3 +-- .../error-messages/tool-errors/linker-tools-error-lnk1113.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1120.md | 3 +-- .../error-messages/tool-errors/linker-tools-error-lnk1123.md | 4 ++-- .../error-messages/tool-errors/linker-tools-error-lnk1127.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1136.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1140.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1141.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1143.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1152.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1158.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1164.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1166.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1168.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1169.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1170.md | 3 +-- .../error-messages/tool-errors/linker-tools-error-lnk1179.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1181.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1188.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1189.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1196.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1200.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1201.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1211.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1215.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1218.md | 5 ++--- 31 files changed, 57 insertions(+), 86 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md index 12800cd9829..d769aac9547 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1000" title: "Linker Tools Error LNK1000" -ms.date: "06/18/2018" +description: "Learn more about: Linker Tools Error LNK1000" +ms.date: 06/18/2018 f1_keywords: ["LNK1000"] helpviewer_keywords: ["LNK1000"] -ms.assetid: 86421b9a-460a-4285-8dce-9b8257d78122 --- # Linker Tools Error LNK1000 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md index 5e0b787a210..f49a578deee 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1103" title: "Linker Tools Error LNK1103" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1103" +ms.date: 11/04/2016 f1_keywords: ["LNK1103"] helpviewer_keywords: ["LNK1103"] -ms.assetid: c8e9bc54-6a71-471c-899e-6f98122ee3c4 --- # Linker Tools Error LNK1103 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md index 408a3424262..cade1e6b606 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md @@ -1,10 +1,9 @@ --- title: "Linker Tools Error LNK1104" description: "Describes the Microsoft C and C++ (MSVC) linker error LNK1104, its causes, and possible solutions." -ms.date: "12/13/2019" +ms.date: 12/13/2019 f1_keywords: ["LNK1104"] helpviewer_keywords: ["LNK1104"] -ms.assetid: 9ca6f929-0efc-4055-8354-3cf5b4e636dc --- # Linker Tools Error LNK1104 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md index 8609fb21f4e..662214bd59b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1106" title: "Linker Tools Error LNK1106" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1106" +ms.date: 11/04/2016 f1_keywords: ["LNK1106"] helpviewer_keywords: ["LNK1106"] -ms.assetid: 528f7e65-04be-4966-b8af-9276837c7cda --- # Linker Tools Error LNK1106 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md index 4933bd196f4..75ae3cc8c30 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Linker tools error LNK1107" title: "Linker tools error LNK1107" +description: "Learn more about: Linker tools error LNK1107" ms.date: 12/10/2021 f1_keywords: ["LNK1107"] helpviewer_keywords: ["LNK1107"] diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1112.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1112.md index 0e62d587977..67286e66572 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1112.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1112.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1112" title: "Linker Tools Error LNK1112" +description: "Learn more about: Linker Tools Error LNK1112" ms.date: 05/23/2022 f1_keywords: ["LNK1112"] helpviewer_keywords: ["LNK1112"] -ms.assetid: 425793d8-37e6-4072-9b6e-c3d4e9c12562 --- # Linker Tools Error LNK1112 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md index 44a0f634a12..feb9df5031f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1113" title: "Linker Tools Error LNK1113" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1113" +ms.date: 11/04/2016 f1_keywords: ["LNK1113"] helpviewer_keywords: ["LNK1113"] -ms.assetid: 269ff166-b143-48e9-bdf7-db6a0db59fe4 --- # Linker Tools Error LNK1113 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md index 614cc9034c1..852a5668232 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md @@ -1,10 +1,9 @@ --- title: "Linker tools error LNK1120" description: "Describes the LNK1120 linker error, which reports the number of unresolved external symbol errors in the link." -ms.date: "10/31/2019" +ms.date: 10/31/2019 f1_keywords: ["LNK1120"] helpviewer_keywords: ["LNK1120"] -ms.assetid: 56aa7d36-921f-4daf-b44d-cca0d4fb1b51 --- # Linker tools error LNK1120 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md index 1d4d923ecf8..3059a757de8 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Error LNK1123" title: "Linker Tools Error LNK1123" -ms.date: "12/29/2017" +description: "Learn more about: Linker Tools Error LNK1123" +ms.date: 12/29/2017 f1_keywords: ["LNK1123"] helpviewer_keywords: ["LNK1123"] --- diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md index 0c57c055ea7..d2acd271220 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1127" title: "Linker Tools Error LNK1127" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1127" +ms.date: 11/04/2016 f1_keywords: ["LNK1127"] helpviewer_keywords: ["LNK1127"] -ms.assetid: 45404700-1420-4f24-97e1-efb7252ffd8f --- # Linker Tools Error LNK1127 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md index 65bfc5c2499..0c4dee8bb92 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1136" title: "Linker Tools Error LNK1136" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1136" +ms.date: 11/04/2016 f1_keywords: ["LNK1136"] helpviewer_keywords: ["LNK1136"] -ms.assetid: 40c6d909-eb3f-4045-a0fc-4caa2f6db506 --- # Linker Tools Error LNK1136 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md index 8410c19e59e..32776a589dc 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1140" title: "Linker Tools Error LNK1140" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1140" +ms.date: 11/04/2016 f1_keywords: ["LNK1140"] helpviewer_keywords: ["LNK1140"] -ms.assetid: 468d7651-a7cd-47b9-aead-5bb2fab56121 --- # Linker Tools Error LNK1140 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md index 0db826ead4e..11f1c42106c 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1141" title: "Linker Tools Error LNK1141" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1141" +ms.date: 11/04/2016 f1_keywords: ["LNK1141"] helpviewer_keywords: ["LNK1141"] -ms.assetid: 83b78606-6dd3-43a7-88e2-152f5359cbd8 --- # Linker Tools Error LNK1141 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md index 55c29d4569d..3d852635bb1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1143" title: "Linker Tools Error LNK1143" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1143" +ms.date: 11/04/2016 f1_keywords: ["LNK1143"] helpviewer_keywords: ["LNK1143"] -ms.assetid: 5dc6b634-d142-4448-b5ea-48e8fb10c10a --- # Linker Tools Error LNK1143 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md index d4297c40e50..94733880e80 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1152" title: "Linker Tools Error LNK1152" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1152" +ms.date: 11/04/2016 f1_keywords: ["LNK1152"] helpviewer_keywords: ["LNK1152"] -ms.assetid: 2523b61a-1359-4612-9c16-7d1f705f32e6 --- # Linker Tools Error LNK1152 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md index 10a01aaccbb..c439b181dde 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1158" title: "Linker Tools Error LNK1158" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1158" +ms.date: 11/04/2016 f1_keywords: ["LNK1158"] helpviewer_keywords: ["LNK1158"] -ms.assetid: 45febf16-d9e1-42db-af91-532e2717fd6a --- # Linker Tools Error LNK1158 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md index 4946654a889..065ff3d8f75 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1164" title: "Linker Tools Error LNK1164" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1164" +ms.date: 11/04/2016 f1_keywords: ["LNK1164"] helpviewer_keywords: ["LNK1164"] -ms.assetid: da89765c-affa-4f88-b170-6d6b19a577cf --- # Linker Tools Error LNK1164 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md index 4c829eadb87..e9afdd5624e 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1166" title: "Linker Tools Error LNK1166" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1166" +ms.date: 11/04/2016 f1_keywords: ["LNK1166"] helpviewer_keywords: ["LNK1166"] -ms.assetid: d69548a8-0efb-44e1-90b7-b27636a4b575 --- # Linker Tools Error LNK1166 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md index 32fb85103cf..fd72aa34b40 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1168" title: "Linker Tools Error LNK1168" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1168" +ms.date: 11/04/2016 f1_keywords: ["LNK1168"] helpviewer_keywords: ["LNK1168"] -ms.assetid: 97ead151-fd99-46fe-9a1d-7e84dc0b8cc8 --- # Linker Tools Error LNK1168 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md index b2ae304069c..20e35c0d767 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1169" title: "Linker Tools Error LNK1169" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1169" +ms.date: 11/04/2016 f1_keywords: ["LNK1169"] helpviewer_keywords: ["LNK1169"] -ms.assetid: e079d518-f184-48cd-8b38-969bf137af54 --- # Linker Tools Error LNK1169 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md index 0de2b0a6e32..1bfdd6a7cb1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker tools Error LNK1170" title: "Linker tools Error LNK1170" +description: "Learn more about: Linker tools Error LNK1170" ms.date: 05/17/2022 f1_keywords: ["LNK1170"] helpviewer_keywords: ["LNK1170"] -ms.assetid: e079d518-f184-48cd-8b38-969bf137af54 --- # Linker tools Error LNK1170 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md index f1b8d37e0d4..9007d33d95c 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1179" title: "Linker Tools Error LNK1179" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1179" +ms.date: 11/04/2016 f1_keywords: ["LNK1179"] helpviewer_keywords: ["LNK1179"] -ms.assetid: 4b1536d7-0d3d-4f29-a9c1-6fa5cf6cb665 --- # Linker Tools Error LNK1179 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md index cc641ba3823..3212fbf52a1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1181" title: "Linker Tools Error LNK1181" -ms.date: "08/22/2018" +description: "Learn more about: Linker Tools Error LNK1181" +ms.date: 08/22/2018 f1_keywords: ["LNK1181"] helpviewer_keywords: ["LNK1181"] -ms.assetid: 984b0db6-e331-4284-b2a7-a212fe96c486 --- # Linker Tools Error LNK1181 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md index 3702c3efd3b..fa68aa2479c 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1188" title: "Linker Tools Error LNK1188" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1188" +ms.date: 11/04/2016 f1_keywords: ["LNK1188"] helpviewer_keywords: ["LNK1188"] -ms.assetid: 4af574b0-5b41-4580-9a37-52a634add995 --- # Linker Tools Error LNK1188 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md index ba74f99ed08..3638265d0cc 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1189" title: "Linker Tools Error LNK1189" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1189" +ms.date: 11/04/2016 f1_keywords: ["LNK1189"] helpviewer_keywords: ["LNK1189"] -ms.assetid: 40c45302-6967-497e-9a6e-c2ca039fc1ed --- # Linker Tools Error LNK1189 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md index 4974338f5ac..8b9f7cff7de 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1196" title: "Linker Tools Error LNK1196" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1196" +ms.date: 11/04/2016 f1_keywords: ["LNK1196"] helpviewer_keywords: ["LNK1196"] -ms.assetid: d0c6859b-85aa-45cc-9f5f-fc1f7070ab5a --- # Linker Tools Error LNK1196 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md index 1be547f32a2..cbf43a2a49b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1200" title: "Linker Tools Error LNK1200" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1200" +ms.date: 11/04/2016 f1_keywords: ["LNK1200"] helpviewer_keywords: ["LNK1200"] -ms.assetid: 55771145-915e-4006-ac6c-ac702041eb2f --- # Linker Tools Error LNK1200 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md index bab142fed66..4dc5e1a5bce 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1201" title: "Linker Tools Error LNK1201" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1201" +ms.date: 11/04/2016 f1_keywords: ["LNK1201"] helpviewer_keywords: ["LNK1201"] -ms.assetid: 64c3f496-a428-4b54-981e-faa82ef9c8a1 --- # Linker Tools Error LNK1201 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md index 5a939ce270f..dffce63c093 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1211" title: "Linker Tools Error LNK1211" -ms.date: "12/05/2017" +description: "Learn more about: Linker Tools Error LNK1211" +ms.date: 12/05/2017 f1_keywords: ["LNK1211"] helpviewer_keywords: ["LNK1211"] -ms.assetid: 607400eb-4180-4892-817f-eedfa628af61 --- # Linker Tools Error LNK1211 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md index 0a591c7454a..96a368bdc10 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1215" title: "Linker Tools Error LNK1215" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1215" +ms.date: 11/04/2016 f1_keywords: ["LNK1215"] helpviewer_keywords: ["LNK1215"] -ms.assetid: 0774d8e6-f0c1-4efb-8723-7e1be6863d81 --- # Linker Tools Error LNK1215 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md index 254d5fc21fa..cd40d43678a 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1218" title: "Linker Tools Error LNK1218" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1218" +ms.date: 11/04/2016 f1_keywords: ["LNK1218"] helpviewer_keywords: ["LNK1218"] -ms.assetid: bf599350-be03-4344-be43-91e29c4f1556 --- # Linker Tools Error LNK1218 From 1ff225f2f7e14d5dabff033353b21980049f2dae Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 17:45:20 +0800 Subject: [PATCH 1265/1799] Add blockquotes for error messages in range [LNK1221, LNK2000] --- docs/error-messages/tool-errors/linker-tools-error-lnk1221.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1223.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1224.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1240.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1241.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1245.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1256.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1264.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1277.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1282.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1287.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1296.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1301.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1302.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1312.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1314.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1332.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1561.md | 2 +- 18 files changed, 18 insertions(+), 18 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md index f200e10465f..fcd29355272 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md @@ -8,7 +8,7 @@ ms.assetid: 70654bf9-1520-4fa3-a063-1219dd88abf7 --- # Linker Tools Error LNK1221 -a subsystem can't be inferred and must be defined +> a subsystem can't be inferred and must be defined The linker does not have enough information to infer which subsystem you want to target. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md index 54a615674d0..0490467d55d 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md @@ -8,7 +8,7 @@ ms.assetid: c4728c36-daee-462f-a1c7-8733dcdec88e --- # Linker Tools Error LNK1223 -invalid or corrupt file: file contains invalid .pdata contributions +> invalid or corrupt file: file contains invalid .pdata contributions For RISC platforms that use pdata, this error will occur if the compiler emitted a .pdata section with unsorted entries. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md index 36dd5b331dc..9d440957782 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md @@ -8,6 +8,6 @@ ms.assetid: e190b5d0-ce0c-4f65-8cc0-753f1cc9758a --- # Linker Tools Error LNK1224 -invalid image base address +> invalid image base address You specified an invalid base address for the image. Base addresses must be 64KB aligned (the last four hex digits must be zero) and image base must fit within a 32-bit signed or unsigned value. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md index d899064a26b..9a3762702cb 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md @@ -8,6 +8,6 @@ ms.assetid: 7d0e065d-1015-4df0-8370-79c3cf045e1c --- # Linker Tools Error LNK1240 -failed to compile IDL content +> failed to compile IDL content The linker spawned MIDL to compile embedded IDL but there was a problem. Check the errors specified by MIDL. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md index 2b423a6bec7..b7c99b8b1bf 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md @@ -8,7 +8,7 @@ ms.assetid: 7b8b52eb-0231-4521-b52a-2bce8d3e8956 --- # Linker Tools Error LNK1241 -resource file 'resource file' already specified +> resource file 'resource file' already specified This error is generated if you run **cvtres** manually from the command line and if you then pass the resulting .obj file to the linker in addition to other .res files. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md index 4622d688ed5..7f289001952 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md @@ -8,7 +8,7 @@ ms.assetid: 179c8165-ffbb-44cd-9f24-5250f29577cc --- # Linker Tools Error LNK1245 -invalid subsystem 'subsystem' specified; /SUBSYSTEM must be WINDOWS, WINDOWSCE, or CONSOLE +> invalid subsystem 'subsystem' specified; /SUBSYSTEM must be WINDOWS, WINDOWSCE, or CONSOLE [/clr](../../build/reference/clr-common-language-runtime-compilation.md) was used to compile the object and one of the following conditions was true: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md index 8d1a5d87b2d..d4b8e0529f7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md @@ -8,7 +8,7 @@ ms.assetid: 55b64b2b-a56b-436c-a55e-ec9c6dcb050e --- # Linker Tools Error LNK1256 -ALINK operation failed : reason +> ALINK operation failed : reason A common reason for LNK1256 is an incorrect version number for an assembly. The value 65535 is not allowed for any part of the assembly version number. The valid range for assembly versions is 0 - 65534. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md index 56602f576dc..96c142c292b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md @@ -8,7 +8,7 @@ ms.assetid: 23b1aad7-d382-42c1-bae8-db68575c57a8 --- # Linker Tools Error LNK1264 -/LTCG:PGINSTRUMENT specified but no code generation required; instrumentation failed +> /LTCG:PGINSTRUMENT specified but no code generation required; instrumentation failed **/LTCG:PGINSTRUMENT** was specified but no .obj files were found that were compiled with [/GL](../../build/reference/gl-whole-program-optimization.md). Instrumentation cannot take place and the link failed. There must be at least one .obj file on the command line that is compiled with **/GL** so that the instrumentation can occur. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md index b7b4ad87f8b..0d9fa0fe973 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md @@ -8,7 +8,7 @@ ms.assetid: afca3de0-50cc-4140-af7a-13493a170835 --- # Linker Tools Error LNK1277 -object record not found in pgd (filename) +> object record not found in pgd (filename) When using [/LTCG:PGOPTIMZE](../../build/reference/ltcg-link-time-code-generation.md), the path of one of the input .lib, def, or .obj files was different from the path on which they were found during /LTCG:PGINSTRUMENT. This may be explained by a change in the LIB environment variable after /LTCG:PGINSTRUMENT. The full path to the input files is stored in the .pgd file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md index f5a4ef3c70b..964e33d0022 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md @@ -8,6 +8,6 @@ ms.assetid: 99c13f52-eb80-46ce-a5b9-4537583e32a9 --- # Linker Tools Error LNK1282 -unable to /REBASE file; it has been signed +> unable to /REBASE file; it has been signed You attempted to change the base address of a signed assembly with the /REBASE option for [editbin](../../build/reference/editbin-reference.md). To do this, first change the base address and then sign the assembly. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md index 0e007f7611e..60b127d93f6 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md @@ -8,6 +8,6 @@ ms.assetid: 48dc379d-370c-42f6-8028-5bbcf1cc88bd --- # Linker Tools Error LNK1287 -invalid managed entry point function +> invalid managed entry point function The entry point is not valid for a managed image. The return type of a managed entry point function can only be **`void`** or **`int`**. The type of the parameter of a managed entry point function can only be **`void`** or `String []`. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md index ae48da8e2e0..30ed2a4af50 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md @@ -8,7 +8,7 @@ ms.assetid: f94a3d18-5411-456b-966f-89810fdcfe60 --- # Linker Tools Error LNK1296 -unable to load filename +> unable to load filename The given DLL was unavailable. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md index 32ddbeb1ea6..25a5312b3fd 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md @@ -8,7 +8,7 @@ ms.assetid: 760da428-7182-4b25-b20a-de90d4b9a9cd --- # Linker Tools Error LNK1301 -LTCG clr modules found, incompatible with /LTCG:parameter +> LTCG clr modules found, incompatible with /LTCG:parameter A module compiled with /clr and /GL was passed to the linker along with one of the profile guided optimizations (PGO) parameters of /LTCG. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md index 575fa0381d0..c78404ae92b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md @@ -8,7 +8,7 @@ ms.assetid: aea3c753-c2c4-4249-bbc3-f2d4f0164b5e --- # Linker Tools Error LNK1302 -only support linking safe .netmodules; unable to link file .netmodule +> only support linking safe .netmodules; unable to link file .netmodule A .netmodule (compiled with **/LN**) was passed to the linker in a user attempt to invoke MSIL linking. A C++ module is valid for MSIL linking if it is compiled with **/clr:safe**. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md index c4a7b56c971..bf749a129a4 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md @@ -8,7 +8,7 @@ ms.assetid: 48284abb-d849-43fc-ab53-45aded14fd8a --- # Linker Tools Error LNK1312 -invalid or corrupt file: unable to import assembly +> invalid or corrupt file: unable to import assembly When building an assembly, a file other than a module or assembly compiled with **/clr** was passed to the **/ASSEMBLYMODULE** linker option. If you passed an object file to **/ASSEMBLYMODULE**, just pass the object directly to the linker, instead of to **/ASSEMBLYMODULE**. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md index 91bcd50de0c..63b7ec94775 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md @@ -8,7 +8,7 @@ ms.assetid: 0b5cd599-61ea-4ac7-8f25-c6d3a8b14655 --- # Linker Tools Error LNK1314 -corrupt or invalid COFF symbol table (undefined static or label symbol) +> corrupt or invalid COFF symbol table (undefined static or label symbol) The compiler-generated content for a section in the given object appears to be corrupt. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md index ff537294c8d..76daff2a88e 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md @@ -8,7 +8,7 @@ ms.assetid: b31d5ca0-c27f-4177-896b-2637dccbde24 --- # Linker Tools Error LNK1332 -detected\ Windows Runtime types imported in one module and defined in another module +> detected\ Windows Runtime types imported in one module and defined in another module When it produced the current target, the linker detected <`count`> Windows Runtime types, each of which is imported in one module and also defined in another module. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md index 02cda93ab58..cd063749af0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md @@ -8,7 +8,7 @@ ms.assetid: cb0b709b-7c9c-4496-8a4e-9e1e4aefe447 --- # Linker Tools Error LNK1561 -entry point must be defined +> entry point must be defined The linker did not find an *entry point*, the initial function to call in your executable. By default, the linker looks for a `main` or `wmain` function for a console app, a `WinMain` or `wWinMain` function for a Windows app, or `DllMain` for a DLL that requires initialization. You can specify another function by using the [/ENTRY](../../build/reference/entry-entry-point-symbol.md) linker option. From 9f000cf993b94d3e7d8515d6965bfeb93c925b46 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 17:52:00 +0800 Subject: [PATCH 1266/1799] Add "Remarks" and "Example" headings for error references in range [LNK1221, LNK2000] --- docs/error-messages/tool-errors/linker-tools-error-lnk1221.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1223.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1224.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1240.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1241.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1245.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1256.md | 4 ++++ docs/error-messages/tool-errors/linker-tools-error-lnk1264.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1277.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1282.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1287.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1296.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1301.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1302.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1306.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1312.md | 4 +++- docs/error-messages/tool-errors/linker-tools-error-lnk1313.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1314.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1318.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1332.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk1561.md | 2 ++ 21 files changed, 44 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md index fcd29355272..93a42689582 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md @@ -10,6 +10,8 @@ ms.assetid: 70654bf9-1520-4fa3-a063-1219dd88abf7 > a subsystem can't be inferred and must be defined +## Remarks + The linker does not have enough information to infer which subsystem you want to target. To fix this error, use [/SUBSYSTEM](../../build/reference/subsystem-specify-subsystem.md). diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md index 0490467d55d..86a2b0958ec 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md @@ -10,6 +10,8 @@ ms.assetid: c4728c36-daee-462f-a1c7-8733dcdec88e > invalid or corrupt file: file contains invalid .pdata contributions +## Remarks + For RISC platforms that use pdata, this error will occur if the compiler emitted a .pdata section with unsorted entries. To fix this issue, try compiling without [/GL (Whole Program Optimization)](../../error-messages/tool-errors/linker-tools-error-lnk1223.md) enabled. Empty function bodies can also cause this error in some cases. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md index 9d440957782..a66d18efd78 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md @@ -10,4 +10,6 @@ ms.assetid: e190b5d0-ce0c-4f65-8cc0-753f1cc9758a > invalid image base address +## Remarks + You specified an invalid base address for the image. Base addresses must be 64KB aligned (the last four hex digits must be zero) and image base must fit within a 32-bit signed or unsigned value. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md index 9a3762702cb..943a77844f5 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md @@ -10,4 +10,6 @@ ms.assetid: 7d0e065d-1015-4df0-8370-79c3cf045e1c > failed to compile IDL content +## Remarks + The linker spawned MIDL to compile embedded IDL but there was a problem. Check the errors specified by MIDL. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md index b7c99b8b1bf..3e05f713541 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md @@ -10,6 +10,8 @@ ms.assetid: 7b8b52eb-0231-4521-b52a-2bce8d3e8956 > resource file 'resource file' already specified +## Remarks + This error is generated if you run **cvtres** manually from the command line and if you then pass the resulting .obj file to the linker in addition to other .res files. To specify multiple .res files, pass them all to the linker as .res files, not from within .obj files created by **cvtres**. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md index 7f289001952..4e2841b6659 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md @@ -10,6 +10,8 @@ ms.assetid: 179c8165-ffbb-44cd-9f24-5250f29577cc > invalid subsystem 'subsystem' specified; /SUBSYSTEM must be WINDOWS, WINDOWSCE, or CONSOLE +## Remarks + [/clr](../../build/reference/clr-common-language-runtime-compilation.md) was used to compile the object and one of the following conditions was true: - A custom entry point was defined ([/ENTRY](../../build/reference/entry-entry-point-symbol.md)), such that, the linker could not infer a subsystem. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md index d4b8e0529f7..f6f8c4463bb 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md @@ -10,12 +10,16 @@ ms.assetid: 55b64b2b-a56b-436c-a55e-ec9c6dcb050e > ALINK operation failed : reason +## Remarks + A common reason for LNK1256 is an incorrect version number for an assembly. The value 65535 is not allowed for any part of the assembly version number. The valid range for assembly versions is 0 - 65534. LNK1256 can also be caused if ALINK could not find the named key container. Delete the key container and add it again to the strong name CSP by using [Sn.exe (Strong Name Tool)](/dotnet/framework/tools/sn-exe-strong-name-tool). Another reason for LNK1256 is a version mismatch between the linker and Alink.dll. This can be caused by a corrupted Visual Studio installation. Use **Programs and Features** in the Windows Control Panel to repair or reinstall Visual Studio. +## Example + The following sample generates LNK1256: ```cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md index 96c142c292b..c1d08ff641f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md @@ -10,6 +10,8 @@ ms.assetid: 23b1aad7-d382-42c1-bae8-db68575c57a8 > /LTCG:PGINSTRUMENT specified but no code generation required; instrumentation failed +## Remarks + **/LTCG:PGINSTRUMENT** was specified but no .obj files were found that were compiled with [/GL](../../build/reference/gl-whole-program-optimization.md). Instrumentation cannot take place and the link failed. There must be at least one .obj file on the command line that is compiled with **/GL** so that the instrumentation can occur. Profile guided optimization (PGO) is only available in 64-bit compilers. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md index 0d9fa0fe973..e9260876f57 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md @@ -10,6 +10,8 @@ ms.assetid: afca3de0-50cc-4140-af7a-13493a170835 > object record not found in pgd (filename) +## Remarks + When using [/LTCG:PGOPTIMZE](../../build/reference/ltcg-link-time-code-generation.md), the path of one of the input .lib, def, or .obj files was different from the path on which they were found during /LTCG:PGINSTRUMENT. This may be explained by a change in the LIB environment variable after /LTCG:PGINSTRUMENT. The full path to the input files is stored in the .pgd file. /LTCG:PGOPTIMIZE requires that the inputs be identical to the /LTCG:PGINSTRUMENT phase. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md index 964e33d0022..5ce594e5525 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md @@ -10,4 +10,6 @@ ms.assetid: 99c13f52-eb80-46ce-a5b9-4537583e32a9 > unable to /REBASE file; it has been signed +## Remarks + You attempted to change the base address of a signed assembly with the /REBASE option for [editbin](../../build/reference/editbin-reference.md). To do this, first change the base address and then sign the assembly. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md index 60b127d93f6..66cd6aea56d 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md @@ -10,4 +10,6 @@ ms.assetid: 48dc379d-370c-42f6-8028-5bbcf1cc88bd > invalid managed entry point function +## Remarks + The entry point is not valid for a managed image. The return type of a managed entry point function can only be **`void`** or **`int`**. The type of the parameter of a managed entry point function can only be **`void`** or `String []`. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md index 30ed2a4af50..1a26baf7a70 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md @@ -10,6 +10,8 @@ ms.assetid: f94a3d18-5411-456b-966f-89810fdcfe60 > unable to load filename +## Remarks + The given DLL was unavailable. The possible locations for the DLL are the current directory, the system directory, the Windows directory, and the directories specified in the PATH environment variable. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md index 25a5312b3fd..d9d55788f58 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md @@ -10,6 +10,8 @@ ms.assetid: 760da428-7182-4b25-b20a-de90d4b9a9cd > LTCG clr modules found, incompatible with /LTCG:parameter +## Remarks + A module compiled with /clr and /GL was passed to the linker along with one of the profile guided optimizations (PGO) parameters of /LTCG. Profile guided optimizations are not supported for /clr modules. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md index c78404ae92b..d7b00366943 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md @@ -10,6 +10,8 @@ ms.assetid: aea3c753-c2c4-4249-bbc3-f2d4f0164b5e > only support linking safe .netmodules; unable to link file .netmodule +## Remarks + A .netmodule (compiled with **/LN**) was passed to the linker in a user attempt to invoke MSIL linking. A C++ module is valid for MSIL linking if it is compiled with **/clr:safe**. To correct this error, compile with **/clr:safe** to enable MSIL linking, or pass the **/clr** or **/clr:pure** .obj file to the linker instead of the module. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md index 81531f6bc3c..10e0be78b35 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md @@ -10,6 +10,8 @@ ms.assetid: fad1df6a-0bd9-412f-b0d1-7c9bc749c584 > DLL entry point function cannot be managed; compile to native +## Remarks + `DllMain` cannot be compiled to MSIL; it must be compiled to native. To resolve this issue, diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md index bf749a129a4..6fc3c67a2e0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md @@ -10,9 +10,11 @@ ms.assetid: 48284abb-d849-43fc-ab53-45aded14fd8a > invalid or corrupt file: unable to import assembly +## Remarks + When building an assembly, a file other than a module or assembly compiled with **/clr** was passed to the **/ASSEMBLYMODULE** linker option. If you passed an object file to **/ASSEMBLYMODULE**, just pass the object directly to the linker, instead of to **/ASSEMBLYMODULE**. -## Examples +## Example The following sample created the .obj file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md index 0028bd2e487..0c2d50dc575 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md @@ -16,7 +16,7 @@ The current version of Visual C++ does not support linking native or mixed manag The **`/clr:pure`** compiler option is deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017 and later. -## Examples +## Example Source file `LNK1313.cpp`: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md index 63b7ec94775..e58a071dbe5 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md @@ -10,6 +10,8 @@ ms.assetid: 0b5cd599-61ea-4ac7-8f25-c6d3a8b14655 > corrupt or invalid COFF symbol table (undefined static or label symbol) +## Remarks + The compiler-generated content for a section in the given object appears to be corrupt. This error may represent a failure of the compiler. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md index 8724382c59b..ff326cfc8c0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK1318"] > Unexpected PDB error; *cause* '*details*' +## Remarks + The linker encountered an unexpected error when opening, reading, or writing to a PDB file. This error message is produced for uncommon issues in PDB files. The *cause* and *details* represent the information available to the linker when the failure occurred. This may not be very useful, as common errors when dealing with PDB files have separate, more informative error messages. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md index 76daff2a88e..98df94d79a2 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md @@ -10,6 +10,8 @@ ms.assetid: b31d5ca0-c27f-4177-896b-2637dccbde24 > detected\ Windows Runtime types imported in one module and defined in another module +## Remarks + When it produced the current target, the linker detected <`count`> Windows Runtime types, each of which is imported in one module and also defined in another module. ### To correct this error diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md index cd063749af0..1f4d21b8799 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md @@ -10,6 +10,8 @@ ms.assetid: cb0b709b-7c9c-4496-8a4e-9e1e4aefe447 > entry point must be defined +## Remarks + The linker did not find an *entry point*, the initial function to call in your executable. By default, the linker looks for a `main` or `wmain` function for a console app, a `WinMain` or `wWinMain` function for a Windows app, or `DllMain` for a DLL that requires initialization. You can specify another function by using the [/ENTRY](../../build/reference/entry-entry-point-symbol.md) linker option. This error can have several causes: From 6eac69aa7d7f3826f3a4e377c74b085efdc78e38 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 17:53:16 +0800 Subject: [PATCH 1267/1799] Replace term "sample" with "example" for error references in range [LNK1221, LNK2000] --- docs/error-messages/tool-errors/linker-tools-error-lnk1237.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1256.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1301.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1306.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1312.md | 4 ++-- docs/error-messages/tool-errors/linker-tools-error-lnk1313.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk1561.md | 2 +- 7 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md index 46248f9a0b2..513b0c9d844 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md @@ -20,7 +20,7 @@ To resolve LNK1237, don't use **`/GL`** to compile the symbol, or use [`/INCLUDE ## Example -The following sample generates LNK1237. To resolve this error, don't initialize the array in `LNK1237_a.cpp` and add **`/include:__chkstk`** to the link command. +The following example generates LNK1237. To resolve this error, don't initialize the array in `LNK1237_a.cpp` and add **`/include:__chkstk`** to the link command. Source file `LNK1237_a.cpp`: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md index f6f8c4463bb..a5c596f4890 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md @@ -20,7 +20,7 @@ Another reason for LNK1256 is a version mismatch between the linker and Alink.dl ## Example -The following sample generates LNK1256: +The following example generates LNK1256: ```cpp // LNK1256.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md index d9d55788f58..1127206f9e1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md @@ -32,7 +32,7 @@ For more information, see: ## Example -The following sample generates LNK1301: +The following example generates LNK1301: ```cpp // LNK1301.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md index 10e0be78b35..680e223b3d4 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md @@ -32,7 +32,7 @@ For more information, see: ## Example -The following sample generates LNK1306. +The following example generates LNK1306. ```cpp // LNK1306.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md index 6fc3c67a2e0..cb0e7b1bc13 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md @@ -16,7 +16,7 @@ When building an assembly, a file other than a module or assembly compiled with ## Example -The following sample created the .obj file. +The following example created the .obj file. ```cpp // LNK1312.cpp @@ -27,7 +27,7 @@ public: }; ``` -The following sample generates LNK1312. +The following example generates LNK1312. ```cpp // LNK1312_b.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md index 0c2d50dc575..bd33db8a61f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md @@ -36,7 +36,7 @@ Source file `LNK1313_b.cpp`: void test(){} ``` -The following sample will generate LNK1313. +The following example will generate LNK1313. ```cpp // LNK1313_c.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md index 1f4d21b8799..85854ae8bfc 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md @@ -26,7 +26,7 @@ When building an app, the linker looks for an entry point function to call to st ## Example -The following sample generates LNK1561: +The following example generates LNK1561: ```cpp // LNK1561.cpp From 7870efa150a3e28a807a5dce399573975e3a6c59 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 17:58:19 +0800 Subject: [PATCH 1268/1799] Update metadata for error references in range [LNK1221, LNK2000] --- .../error-messages/tool-errors/linker-tools-error-lnk1221.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1223.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1224.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1237.md | 3 +-- .../error-messages/tool-errors/linker-tools-error-lnk1240.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1241.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1245.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1248.md | 2 +- .../error-messages/tool-errors/linker-tools-error-lnk1256.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1264.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1277.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1282.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1287.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1296.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1301.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1302.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1306.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1309.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1312.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1313.md | 3 +-- .../error-messages/tool-errors/linker-tools-error-lnk1314.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1318.md | 4 ++-- .../error-messages/tool-errors/linker-tools-error-lnk1332.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk1352.md | 4 ++-- .../error-messages/tool-errors/linker-tools-error-lnk1561.md | 5 ++--- 25 files changed, 47 insertions(+), 69 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md index 93a42689582..cf0e8c002f1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1221" title: "Linker Tools Error LNK1221" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1221" +ms.date: 11/04/2016 f1_keywords: ["LNK1221"] helpviewer_keywords: ["LNK1221"] -ms.assetid: 70654bf9-1520-4fa3-a063-1219dd88abf7 --- # Linker Tools Error LNK1221 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md index 86a2b0958ec..5f13930590d 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1223" title: "Linker Tools Error LNK1223" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1223" +ms.date: 11/04/2016 f1_keywords: ["LNK1223"] helpviewer_keywords: ["LNK1223"] -ms.assetid: c4728c36-daee-462f-a1c7-8733dcdec88e --- # Linker Tools Error LNK1223 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md index a66d18efd78..49e0c86b868 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1224" title: "Linker Tools Error LNK1224" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1224" +ms.date: 11/04/2016 f1_keywords: ["LNK1224"] helpviewer_keywords: ["LNK1224"] -ms.assetid: e190b5d0-ce0c-4f65-8cc0-753f1cc9758a --- # Linker Tools Error LNK1224 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md index 513b0c9d844..153938e7ce3 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1237" title: "Linker Tools Error LNK1237" +description: "Learn more about: Linker Tools Error LNK1237" ms.date: 06/29/2022 f1_keywords: ["LNK1237"] helpviewer_keywords: ["LNK1237"] -ms.assetid: 8722ffa8-096a-4bb0-85f9-f3aa0e10872a --- # Linker Tools Error LNK1237 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md index 943a77844f5..74f3f8900d1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1240" title: "Linker Tools Error LNK1240" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1240" +ms.date: 11/04/2016 f1_keywords: ["LNK1240"] helpviewer_keywords: ["LNK1240"] -ms.assetid: 7d0e065d-1015-4df0-8370-79c3cf045e1c --- # Linker Tools Error LNK1240 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md index 3e05f713541..1c3975105b1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1241" title: "Linker Tools Error LNK1241" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1241" +ms.date: 11/04/2016 f1_keywords: ["LNK1241"] helpviewer_keywords: ["LNK1241"] -ms.assetid: 7b8b52eb-0231-4521-b52a-2bce8d3e8956 --- # Linker Tools Error LNK1241 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md index 4e2841b6659..5ef7756cbed 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1245" title: "Linker Tools Error LNK1245" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1245" +ms.date: 11/04/2016 f1_keywords: ["LNK1245"] helpviewer_keywords: ["LNK1245"] -ms.assetid: 179c8165-ffbb-44cd-9f24-5250f29577cc --- # Linker Tools Error LNK1245 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1248.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1248.md index dcdb91e7292..f0beb0694ef 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1248.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1248.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Linker Tools Error LNK1248" title: "Linker Tools Error LNK1248" +description: "Learn more about: Linker Tools Error LNK1248" ms.date: 08/31/2022 f1_keywords: ["LNK1248"] helpviewer_keywords: ["LNK1248"] diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md index a5c596f4890..f2b1838e570 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1256" title: "Linker Tools Error LNK1256" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1256" +ms.date: 11/04/2016 f1_keywords: ["LNK1256"] helpviewer_keywords: ["LNK1256"] -ms.assetid: 55b64b2b-a56b-436c-a55e-ec9c6dcb050e --- # Linker Tools Error LNK1256 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md index c1d08ff641f..b95262a2d15 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1264" title: "Linker Tools Error LNK1264" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1264" +ms.date: 11/04/2016 f1_keywords: ["LNK1264"] helpviewer_keywords: ["LNK1264"] -ms.assetid: 23b1aad7-d382-42c1-bae8-db68575c57a8 --- # Linker Tools Error LNK1264 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md index e9260876f57..79b41ded64f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1277" title: "Linker Tools Error LNK1277" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1277" +ms.date: 11/04/2016 f1_keywords: ["LNK1277"] helpviewer_keywords: ["LNK1277"] -ms.assetid: afca3de0-50cc-4140-af7a-13493a170835 --- # Linker Tools Error LNK1277 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md index 5ce594e5525..2b61b724474 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1282" title: "Linker Tools Error LNK1282" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1282" +ms.date: 11/04/2016 f1_keywords: ["LNK1282"] helpviewer_keywords: ["LNK1282"] -ms.assetid: 99c13f52-eb80-46ce-a5b9-4537583e32a9 --- # Linker Tools Error LNK1282 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md index 66cd6aea56d..00f78ebdfb7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1287" title: "Linker Tools Error LNK1287" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1287" +ms.date: 11/04/2016 f1_keywords: ["LNK1287"] helpviewer_keywords: ["LNK1287"] -ms.assetid: 48dc379d-370c-42f6-8028-5bbcf1cc88bd --- # Linker Tools Error LNK1287 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md index 1a26baf7a70..608d27548f6 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1296" title: "Linker Tools Error LNK1296" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1296" +ms.date: 11/04/2016 f1_keywords: ["LNK1296"] helpviewer_keywords: ["LNK1296"] -ms.assetid: f94a3d18-5411-456b-966f-89810fdcfe60 --- # Linker Tools Error LNK1296 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md index 1127206f9e1..7cb0c945cef 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1301" title: "Linker Tools Error LNK1301" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1301" +ms.date: 11/04/2016 f1_keywords: ["LNK1301"] helpviewer_keywords: ["LNK1301"] -ms.assetid: 760da428-7182-4b25-b20a-de90d4b9a9cd --- # Linker Tools Error LNK1301 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md index d7b00366943..8a3ef7ae5a2 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1302" title: "Linker Tools Error LNK1302" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1302" +ms.date: 11/04/2016 f1_keywords: ["LNK1302"] helpviewer_keywords: ["LNK1302"] -ms.assetid: aea3c753-c2c4-4249-bbc3-f2d4f0164b5e --- # Linker Tools Error LNK1302 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md index 680e223b3d4..eb8fec1dbf8 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1306" title: "Linker Tools Error LNK1306" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1306" +ms.date: 11/04/2016 f1_keywords: ["LNK1306"] helpviewer_keywords: ["LNK1306"] -ms.assetid: fad1df6a-0bd9-412f-b0d1-7c9bc749c584 --- # Linker Tools Error LNK1306 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1309.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1309.md index 3d4c3acd986..821728c7960 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1309.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1309.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1309" title: "Linker Tools Error LNK1309" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1309" +ms.date: 11/04/2016 f1_keywords: ["LNK1309"] helpviewer_keywords: ["LNK1309"] -ms.assetid: 10146071-883f-4849-97d1-c7468f90efbb --- # Linker Tools Error LNK1309 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md index cb0e7b1bc13..06fc1cabccd 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1312" title: "Linker Tools Error LNK1312" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1312" +ms.date: 11/04/2016 f1_keywords: ["LNK1312"] helpviewer_keywords: ["LNK1312"] -ms.assetid: 48284abb-d849-43fc-ab53-45aded14fd8a --- # Linker Tools Error LNK1312 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md index bd33db8a61f..d32e1e04cdd 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1313" title: "Linker Tools Error LNK1313" +description: "Learn more about: Linker Tools Error LNK1313" ms.date: 06/29/2022 f1_keywords: ["LNK1313"] helpviewer_keywords: ["LNK1313"] -ms.assetid: 5df0b72e-bb3f-428c-8d84-6084238f9827 --- # Linker Tools Error LNK1313 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md index e58a071dbe5..aaa27458f30 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1314" title: "Linker Tools Error LNK1314" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1314" +ms.date: 11/04/2016 f1_keywords: ["LNK1314"] helpviewer_keywords: ["LNK1314"] -ms.assetid: 0b5cd599-61ea-4ac7-8f25-c6d3a8b14655 --- # Linker Tools Error LNK1314 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md index ff326cfc8c0..cf8a6f59de0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Error LNK1318" title: "Linker Tools Error LNK1318" -ms.date: "05/29/2018" +description: "Learn more about: Linker Tools Error LNK1318" +ms.date: 05/29/2018 f1_keywords: ["LNK1318"] helpviewer_keywords: ["LNK1318"] --- diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md index 98df94d79a2..1c650843fc0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1332" title: "Linker Tools Error LNK1332" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1332" +ms.date: 11/04/2016 f1_keywords: ["LNK1332"] helpviewer_keywords: ["LNK1332"] -ms.assetid: b31d5ca0-c27f-4177-896b-2637dccbde24 --- # Linker Tools Error LNK1332 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1352.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1352.md index c3d83f4fe6f..387d5699946 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1352.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1352.md @@ -1,7 +1,7 @@ --- title: "Linker Tools Error LNK1352" -description: Linker Tools Error LNK1352 occurs when an unsupported section merge is attempted. -ms.date: "09/10/2019" +description: "Linker Tools Error LNK1352 occurs when an unsupported section merge is attempted." +ms.date: 09/10/2019 f1_keywords: ["LNK1352"] helpviewer_keywords: ["LNK1352"] --- diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md index 85854ae8bfc..38e2cf273a2 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1561" title: "Linker Tools Error LNK1561" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1561" +ms.date: 11/04/2016 f1_keywords: ["LNK1561"] helpviewer_keywords: ["LNK1561"] -ms.assetid: cb0b709b-7c9c-4496-8a4e-9e1e4aefe447 --- # Linker Tools Error LNK1561 From 9a341508b0a5c6180280281be661fcfe38172ba0 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 21:20:55 +0800 Subject: [PATCH 1269/1799] Update C2154 error message --- docs/error-messages/compiler-errors-1/compiler-error-c2154.md | 2 +- .../compiler-errors-1/compiler-errors-c2100-through-c2199.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md index 021703b64ec..857a965dae8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C2154"] --- # Compiler Error C2154 -> 'type' : only enumeration type is allowed as an argument to compiler intrinsic type trait '__underlying_type' +> '*type*': only enumeration type is allowed as an argument to compiler intrinsic type trait '__underlying_type' ## Remarks diff --git a/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md b/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md index ef2e8e4b3f9..676b397bbbf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md +++ b/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md @@ -69,7 +69,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2151](compiler-error-c2151.md)|more than one language attribute| |[Compiler error C2152](compiler-error-c2152.md)|'*identifier*': pointers to functions with different attributes| |[Compiler error C2153](compiler-error-c2153.md)|integer literals must have at least one digit| -|[Compiler error C2154](compiler-error-c2154.md)|'*type*': only enumeration type is allowed as an argument to compiler intrinsic type trait '*trait*'| +|[Compiler error C2154](compiler-error-c2154.md)|'*type*': only enumeration type is allowed as an argument to compiler intrinsic type trait '__underlying_type'| |[Compiler error C2155](compiler-error-c2155.md)|'?': invalid left operand, expected arithmetic or pointer type| |[Compiler error C2156](compiler-error-c2156.md)|pragma must be outside function| |[Compiler error C2157](compiler-error-c2157.md)|'*identifier*': must be declared before use in pragma list| From adb67a2fb7ff743e3933477b3480cf7f1b77016d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 21:26:21 +0800 Subject: [PATCH 1270/1799] Update remarks in C2154 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2154.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md index 857a965dae8..095171b4ea2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md @@ -11,6 +11,4 @@ helpviewer_keywords: ["C2154"] ## Remarks -You can only get the underlying type of an enumeration type. - -For more information, see [Compiler Support for Type Traits](../../extensions/compiler-support-for-type-traits-cpp-component-extensions.md). +You can only get the underlying type of an [enumeration](../../cpp/enumerations-cpp.md) type. From 99d7aee2fcd94b09b366123f12f91b747b108207 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 21:35:30 +0800 Subject: [PATCH 1271/1799] Add example in C2154 error reference --- .../compiler-errors-1/compiler-error-c2154.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md index 095171b4ea2..635b2dc2d6d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md @@ -12,3 +12,21 @@ helpviewer_keywords: ["C2154"] ## Remarks You can only get the underlying type of an [enumeration](../../cpp/enumerations-cpp.md) type. + +## Example + +The following example generates C2154: + +```cpp +// C2154.cpp +// compile with: /c + +struct S {}; +enum E {}; +enum class EC {}; + +__underlying_type(S) s; // C2154 +__underlying_type(int) i; // C2154 +__underlying_type(E) e; // OK +__underlying_type(EC) ec; // OK +``` From fade1318e60a192bb7d25d812f097a6cd84789cd Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 21:38:27 +0800 Subject: [PATCH 1272/1799] Add `std::underlying_type` "See also" link in C2154 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2154.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md index 635b2dc2d6d..2140d751a01 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md @@ -30,3 +30,7 @@ __underlying_type(int) i; // C2154 __underlying_type(E) e; // OK __underlying_type(EC) ec; // OK ``` + +## See also + +[`underlying_type` class](../../standard-library/underlying-type-class.md) From 72be0ba0133af9f56815ec74c83d0e35edeb89ea Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 21:39:26 +0800 Subject: [PATCH 1273/1799] Update `ms.date` metadata in C2154 error reference --- docs/error-messages/compiler-errors-1/compiler-error-c2154.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md index 2140d751a01..38192df4ca8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2154" description: "Learn more about: Compiler Error C2154" -ms.date: 11/04/2016 +ms.date: 09/21/2025 f1_keywords: ["C2154"] helpviewer_keywords: ["C2154"] --- From e73699551d98dfe10518d4417e1e12009804a76a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 22:15:29 +0800 Subject: [PATCH 1274/1799] Add blockquotes for error messages in range [LNK2001, LNK2039] --- docs/error-messages/tool-errors/linker-tools-error-lnk2004.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2008.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2011.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2013.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2017.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2020.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2023.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2026.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2027.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2028.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2033.md | 2 +- docs/error-messages/tool-errors/linker-tools-error-lnk2039.md | 2 +- 12 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md index 79d704a0dc4..4d276ff8208 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md @@ -8,7 +8,7 @@ ms.assetid: 07645371-e67b-4a2c-b0e0-dde24c94ef7e --- # Linker Tools Error LNK2004 -gp relative fixup overflow to 'target'; short section 'section' is too large or out of range. +> gp relative fixup overflow to 'target'; short section 'section' is too large or out of range. The section was too large. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md index 1d56c3f3aaf..b97dab486bf 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md @@ -8,7 +8,7 @@ ms.assetid: bbcd83c5-c8ae-439e-a033-63643a5bb373 --- # Linker Tools Error LNK2008 -Fixup target is not aligned 'symbol_name' +> Fixup target is not aligned 'symbol_name' LINK found a fixup target in your object file that was not aligned properly. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md index d19042b921a..08bfb04d65c 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["LNK2011"] --- # Linker Tools Error LNK2011 -precompiled object not linked in; image may not run +> precompiled object not linked in; image may not run If you use precompiled headers, LINK requires that all of the object files created with precompiled headers must be linked in. If you have a source file that you use to generate a precompiled header for use with other source files, you now must include the object file created along with the precompiled header. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md index c977734a5a8..16964e9ff53 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md @@ -8,7 +8,7 @@ ms.assetid: 21408e2d-3f56-4d1f-a031-00df70785ed4 --- # Linker Tools Error LNK2013 -fixup type fixup overflow. Target 'symbol name' is out of range +> fixup type fixup overflow. Target 'symbol name' is out of range The linker cannot fit the necessary address or offset into the given instruction because the target symbol is too far away from the instruction's location. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md index b0b30a605a4..e27fe6cc63b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md @@ -8,7 +8,7 @@ ms.assetid: f7c21733-b0fb-4888-a295-9b453ba6ee77 --- # Linker Tools Error LNK2017 -'symbol' relocation to 'segment' invalid without /LARGEADDRESSAWARE:NO +> 'symbol' relocation to 'segment' invalid without /LARGEADDRESSAWARE:NO You are trying to build a 64-bit image with 32-bit addresses. To do this, you must: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md index e9711b9f715..b46c8fca6e0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["LNK2020"] --- # Linker Tools Error LNK2020 -unresolved token 'token' +> unresolved token 'token' Similar to an undefined external error, except that the reference is via metadata. In metadata, all functions and data must be defined. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md index 3294c30bff2..ac647624419 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md @@ -8,7 +8,7 @@ ms.assetid: c99e35a8-739a-4a20-a715-29b8c3744703 --- # Linker Tools Error LNK2023 -bad dll or entry point \ +> bad dll or entry point \ The linker is loading an incorrect version of msobj90.dll. Ensure that link.exe and msobj90.dll in your path have the same version. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md index f1018137f86..d1280af2d02 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md @@ -8,6 +8,6 @@ ms.assetid: 9955bf7c-59b5-4fa1-8481-147db0d7df45 --- # Linker Tools Error LNK2026 -module unsafe for SAFESEH image +> module unsafe for SAFESEH image [/SAFESEH](../../build/reference/safeseh-image-has-safe-exception-handlers.md) was specified, but a module was not compatible with the safe exception handling feature. If you want to use this module with **/SAFESEH**, then you will need to recompile the module. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md index 7b2c24ce08e..f70a1bd5ad9 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md @@ -8,7 +8,7 @@ ms.assetid: e2f857a8-8e8a-4697-bbff-12ccb84a35c1 --- # Linker Tools Error LNK2027 -unresolved module reference 'module' +> unresolved module reference 'module' A file passed to the linker has a dependency on a module that was neither specified with **/ASSEMBLYMODULE** nor passed directly to the linker. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md index a43928ba548..9205379e804 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md @@ -8,7 +8,7 @@ ms.assetid: e2b03293-6066-464d-a050-ce747bcf7f0e --- # Linker Tools Error LNK2028 -"*exported_function*" (*decorated_name*) referenced in function "*function_containing_function_call*" (*decorated_name*) +> "*exported_function*" (*decorated_name*) referenced in function "*function_containing_function_call*" (*decorated_name*) ## Remarks diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md index ca0deb3ce26..c42a45c5741 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["LNK2033"] --- # Linker Tools Error LNK2033 -unresolved typeref token (token) for 'type' +> unresolved typeref token (token) for 'type' A type doesn't have a definition in MSIL metadata. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md index 1f0ffa47935..1146fca23f0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md @@ -8,7 +8,7 @@ ms.assetid: eaa296bd-4901-41f6-8410-6d03ee827144 --- # Linker Tools Error LNK2039 -importing ref class '\' that is defined in another.obj; it should be either imported or defined, but not both +> importing ref class '\' that is defined in another.obj; it should be either imported or defined, but not both The ref class '<`type`>' is imported in the specified .obj file but is also defined in another .obj file. This condition can cause runtime failure or other unexpected behavior. From 6fbee14a917b793ce368bb1986c5345d03f885ef Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 22:21:22 +0800 Subject: [PATCH 1275/1799] Add "Remarks" and "Example" headings for error references in range [LNK2001, LNK2039] --- docs/error-messages/tool-errors/linker-tools-error-lnk2001.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2004.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2005.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2008.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2011.md | 4 ++++ docs/error-messages/tool-errors/linker-tools-error-lnk2013.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2017.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2019.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2020.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2023.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2026.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2027.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2033.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2038.md | 2 ++ docs/error-messages/tool-errors/linker-tools-error-lnk2039.md | 2 ++ 15 files changed, 32 insertions(+) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md index 4b3626bc8fe..55c731e83c2 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md @@ -10,6 +10,8 @@ ms.assetid: dc1cf267-c984-486c-abd2-fd07c799f7ef > unresolved external symbol "*symbol*" +## Remarks + The compiled code makes a reference or call to *symbol*. The symbol isn't defined in any libraries or object files searched by the linker. This error message is followed by fatal error [LNK1120](../../error-messages/tool-errors/linker-tools-error-lnk1120.md). To fix error LNK1120, first fix all LNK2001 and LNK2019 errors. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md index 4d276ff8208..e3d53eb5455 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md @@ -10,6 +10,8 @@ ms.assetid: 07645371-e67b-4a2c-b0e0-dde24c94ef7e > gp relative fixup overflow to 'target'; short section 'section' is too large or out of range. +## Remarks + The section was too large. To resolve this error, reduce the size of the short section, either by explicitly putting data in the long sections via #pragma section(".sectionname", read, write, long) and using `__declspec(allocate(".sectionname"))` on data definitions and declarations. For example, diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md index 68ddf0e345b..136f527eb13 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md @@ -10,6 +10,8 @@ ms.assetid: d9587adc-68be-425c-8a30-15dbc86717a4 > *symbol* already defined in object +## Remarks + The symbol *symbol* was defined more than once. This error is followed by fatal error [LNK1169](../../error-messages/tool-errors/linker-tools-error-lnk1169.md). diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md index b97dab486bf..d2356d8a669 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md @@ -10,6 +10,8 @@ ms.assetid: bbcd83c5-c8ae-439e-a033-63643a5bb373 > Fixup target is not aligned 'symbol_name' +## Remarks + LINK found a fixup target in your object file that was not aligned properly. This error can be caused by custom secton alignment (for example, #pragma [pack](../../preprocessor/pack.md)), [align](../../cpp/align-cpp.md) modifier, or by using assembly language code that modifies secton alignment. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md index 08bfb04d65c..1e4c6ffb5ee 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["LNK2011"] > precompiled object not linked in; image may not run +## Remarks + If you use precompiled headers, LINK requires that all of the object files created with precompiled headers must be linked in. If you have a source file that you use to generate a precompiled header for use with other source files, you now must include the object file created along with the precompiled header. +## Example + For example, if you compile a file called STUB.cpp to create a precompiled header for use with other source files, you must link with STUB.obj or you will get this error. In the following command lines, line one is used to create a precompiled header, COMMON.pch, which is used with PROG1.cpp and PROG2.cpp in lines two and three. The file STUB.cpp contains only `#include` lines (the same `#include` lines as in PROG1.cpp and PROG2.cpp) and is used only to generate precompiled headers. In the last line, STUB.obj must be linked in to avoid LNK2011. ```cmd diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md index 16964e9ff53..033ebcd3ec3 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md @@ -10,6 +10,8 @@ ms.assetid: 21408e2d-3f56-4d1f-a031-00df70785ed4 > fixup type fixup overflow. Target 'symbol name' is out of range +## Remarks + The linker cannot fit the necessary address or offset into the given instruction because the target symbol is too far away from the instruction's location. You can resolve this problem by creating multiple images or by using the [/ORDER](../../build/reference/order-put-functions-in-order.md) option so the instruction and target are closer together. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md index e27fe6cc63b..553dd780069 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md @@ -10,6 +10,8 @@ ms.assetid: f7c21733-b0fb-4888-a295-9b453ba6ee77 > 'symbol' relocation to 'segment' invalid without /LARGEADDRESSAWARE:NO +## Remarks + You are trying to build a 64-bit image with 32-bit addresses. To do this, you must: - Use a fixed load address. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md index a12ad9a170c..127ed81886f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md @@ -10,6 +10,8 @@ no-loc: [main, WinMain, wmain, wWinMain, __cdecl, __stdcall, __fastcall, __vecto > unresolved external symbol '*symbol*' referenced in function '*function*' +## Remarks + The compiled code for *function* makes a reference or call to *symbol*, but the linker can't find the symbol definition in any of the libraries or object files. This error message is followed by fatal error [LNK1120](../../error-messages/tool-errors/linker-tools-error-lnk1120.md). To fix error LNK1120, you must fix all LNK2001 and LNK2019 errors first. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md index b46c8fca6e0..2ab4cf04ce0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK2020"] > unresolved token 'token' +## Remarks + Similar to an undefined external error, except that the reference is via metadata. In metadata, all functions and data must be defined. To resolve: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md index ac647624419..6c61d5141db 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md @@ -10,6 +10,8 @@ ms.assetid: c99e35a8-739a-4a20-a715-29b8c3744703 > bad dll or entry point \ +## Remarks + The linker is loading an incorrect version of msobj90.dll. Ensure that link.exe and msobj90.dll in your path have the same version. A dependency of msobj90.dll may not be present. The dependency list for msobj90.dll is: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md index d1280af2d02..43ca5a14f3f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md @@ -10,4 +10,6 @@ ms.assetid: 9955bf7c-59b5-4fa1-8481-147db0d7df45 > module unsafe for SAFESEH image +## Remarks + [/SAFESEH](../../build/reference/safeseh-image-has-safe-exception-handlers.md) was specified, but a module was not compatible with the safe exception handling feature. If you want to use this module with **/SAFESEH**, then you will need to recompile the module. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md index f70a1bd5ad9..46178544ba1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md @@ -10,6 +10,8 @@ ms.assetid: e2f857a8-8e8a-4697-bbff-12ccb84a35c1 > unresolved module reference 'module' +## Remarks + A file passed to the linker has a dependency on a module that was neither specified with **/ASSEMBLYMODULE** nor passed directly to the linker. To resolve LNK2027, do one of the following: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md index c42a45c5741..61b6bf7d427 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK2033"] > unresolved typeref token (token) for 'type' +## Remarks + A type doesn't have a definition in MSIL metadata. LNK2033 can occur when compiling with **/clr:safe** and where there is only a forward declaration for a type in an MSIL module, where the type is referenced in the MSIL module. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md index 8162a57997d..d57b2b4cbcd 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK2038"] > mismatch detected for '*name*': value '*value_1*' doesn't match value '*value_2*' in *filename.obj* +## Remarks + A symbol mismatch has been detected by the linker. This error indicates that different parts of an app, including libraries or other object code that the app links to, use conflicting definitions of the symbol. The [detect mismatch](../../preprocessor/detect-mismatch.md) pragma is used to define such symbols and detect their conflicting values. ## Possible causes and solutions diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md index 1146fca23f0..5b565e432dd 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md @@ -10,6 +10,8 @@ ms.assetid: eaa296bd-4901-41f6-8410-6d03ee827144 > importing ref class '\' that is defined in another.obj; it should be either imported or defined, but not both +## Remarks + The ref class '<`type`>' is imported in the specified .obj file but is also defined in another .obj file. This condition can cause runtime failure or other unexpected behavior. ### To correct this error From 14631c5b3cbf628bdc46499de8dbb6e4e7a592f7 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 22:23:29 +0800 Subject: [PATCH 1276/1799] Replace term "sample" with "example" for error references in range [LNK2001, LNK2039] --- .../tool-errors/linker-tools-error-lnk2019.md | 8 ++++---- .../tool-errors/linker-tools-error-lnk2020.md | 4 ++-- .../tool-errors/linker-tools-error-lnk2028.md | 4 ++-- .../tool-errors/linker-tools-error-lnk2031.md | 6 +++--- .../tool-errors/linker-tools-error-lnk2033.md | 2 +- 5 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md index 127ed81886f..8c07ef83d0f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md @@ -145,7 +145,7 @@ Unless `i` and `g` are defined in one of the files included in the build, the li ### A static data member is declared but not defined -LNK2019 can also occur when a static data member is declared but not defined. The following sample generates LNK2019, and shows how to fix it. +LNK2019 can also occur when a static data member is declared but not defined. The following example generates LNK2019, and shows how to fix it. ```cpp // LNK2019b.cpp @@ -166,7 +166,7 @@ int main() { ### Declaration parameters don't match the definition -Code that invokes function templates must have matching function template declarations. Declarations must include the same template parameters as the definition. The following sample generates LNK2019 on a user-defined operator, and shows how to fix it. +Code that invokes function templates must have matching function template declarations. Declarations must include the same template parameters as the definition. The following example generates LNK2019 on a user-defined operator, and shows how to fix it. ```cpp // LNK2019e.cpp @@ -196,7 +196,7 @@ int main() { ### Inconsistent wchar_t type definitions -This sample creates a DLL that has an export that uses `WCHAR`, which resolves to **`wchar_t`**. +This example creates a DLL that has an export that uses `WCHAR`, which resolves to **`wchar_t`**. ```cpp // LNK2019g.cpp @@ -206,7 +206,7 @@ This sample creates a DLL that has an export that uses `WCHAR`, which resolves t __declspec(dllexport) void func(WCHAR*) {} ``` -The next sample uses the DLL in the previous sample, and generates LNK2019 because the types `unsigned short*` and `WCHAR*` aren't the same. +The next example uses the DLL in the previous example, and generates LNK2019 because the types `unsigned short*` and `WCHAR*` aren't the same. ```cpp // LNK2019h.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md index 2ab4cf04ce0..67a107c88ec 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md @@ -21,7 +21,7 @@ To resolve: ## Examples -The following sample generates LNK2020. +The following example generates LNK2020. ```cpp // LNK2020.cpp @@ -40,7 +40,7 @@ ref struct B { LNK2020 will also occur if you create a variable of a managed template type, but do not also instantiate the type. -The following sample generates LNK2020. +The following example generates LNK2020. ```cpp // LNK2020_b.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md index 9205379e804..a38c878f50f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md @@ -18,7 +18,7 @@ The **/clr:pure** compiler option is deprecated in Visual Studio 2015 and unsupp ## Examples -This code sample generates a component with an exported, native, function whose calling convention is implicitly [__cdecl](../../cpp/cdecl.md). +This code example generates a component with an exported, native, function whose calling convention is implicitly [__cdecl](../../cpp/cdecl.md). ```cpp // LNK2028.cpp @@ -28,7 +28,7 @@ __declspec(dllexport) int func() { } ``` -The following sample creates a pure client that consumes the native function. However, the calling convention under **/clr:pure** is [__clrcall](../../cpp/clrcall.md). The following sample generates LNK2028. +The following example creates a pure client that consumes the native function. However, the calling convention under **/clr:pure** is [__clrcall](../../cpp/clrcall.md). The following example generates LNK2028. ```cpp // LNK2028_b.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md index f95b8cc24b0..4a4c562eee3 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md @@ -18,7 +18,7 @@ The **/clr:pure** compiler option is deprecated in Visual Studio 2015 and unsupp ## Examples -This code sample generates a component with an exported, native, function whose calling convention is implicitly [__cdecl](../../cpp/cdecl.md). +This code example generates a component with an exported, native, function whose calling convention is implicitly [__cdecl](../../cpp/cdecl.md). ```cpp // LNK2031.cpp @@ -28,7 +28,7 @@ extern "C" { }; ``` -The following sample creates a pure client that consumes the native function. However, the calling convention under **/clr:pure** is [__clrcall](../../cpp/clrcall.md). The following sample generates LNK2031. +The following example creates a pure client that consumes the native function. However, the calling convention under **/clr:pure** is [__clrcall](../../cpp/clrcall.md). The following example generates LNK2031. ```cpp // LNK2031_b.cpp @@ -41,7 +41,7 @@ int main() { } ``` -The following sample shows how to consume the native function from a pure image. Note the explicit **`__cdecl`** calling convention specifier. +The following example shows how to consume the native function from a pure image. Note the explicit **`__cdecl`** calling convention specifier. ```cpp // LNK2031_c.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md index 61b6bf7d427..2e84c4cfbc7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md @@ -21,7 +21,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates LNK2033. +The following example generates LNK2033. ```cpp // LNK2033.cpp From 4c42cd4f16607a0551311d5074340585a6eeae60 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 21 Sep 2025 22:26:38 +0800 Subject: [PATCH 1277/1799] Update metadata for error references in range [LNK2001, LNK2039] --- .../error-messages/tool-errors/linker-tools-error-lnk2001.md | 3 +-- .../error-messages/tool-errors/linker-tools-error-lnk2004.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2005.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2008.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2013.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2017.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2023.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2026.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2027.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2028.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2031.md | 5 ++--- .../error-messages/tool-errors/linker-tools-error-lnk2038.md | 4 ++-- .../error-messages/tool-errors/linker-tools-error-lnk2039.md | 5 ++--- 13 files changed, 25 insertions(+), 37 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md index 55c731e83c2..15a53502f97 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2001" title: "Linker Tools Error LNK2001" +description: "Learn more about: Linker Tools Error LNK2001" ms.date: 10/22/2021 f1_keywords: ["LNK2001"] helpviewer_keywords: ["LNK2001"] -ms.assetid: dc1cf267-c984-486c-abd2-fd07c799f7ef --- # Linker Tools Error LNK2001 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md index e3d53eb5455..2d6d59c7ec4 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2004" title: "Linker Tools Error LNK2004" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2004" +ms.date: 11/04/2016 f1_keywords: ["LNK2004"] helpviewer_keywords: ["LNK2004"] -ms.assetid: 07645371-e67b-4a2c-b0e0-dde24c94ef7e --- # Linker Tools Error LNK2004 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md index 136f527eb13..32354e573ea 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2005" title: "Linker Tools Error LNK2005" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2005" +ms.date: 11/04/2016 f1_keywords: ["LNK2005"] helpviewer_keywords: ["LNK2005"] -ms.assetid: d9587adc-68be-425c-8a30-15dbc86717a4 --- # Linker Tools Error LNK2005 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md index d2356d8a669..e5cf01c5917 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2008" title: "Linker Tools Error LNK2008" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2008" +ms.date: 11/04/2016 f1_keywords: ["LNK2008"] helpviewer_keywords: ["LNK2008"] -ms.assetid: bbcd83c5-c8ae-439e-a033-63643a5bb373 --- # Linker Tools Error LNK2008 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md index 033ebcd3ec3..c45fba1baeb 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2013" title: "Linker Tools Error LNK2013" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2013" +ms.date: 11/04/2016 f1_keywords: ["LNK2013"] helpviewer_keywords: ["LNK2013"] -ms.assetid: 21408e2d-3f56-4d1f-a031-00df70785ed4 --- # Linker Tools Error LNK2013 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md index 553dd780069..8ec341849b6 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2017" title: "Linker Tools Error LNK2017" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2017" +ms.date: 11/04/2016 f1_keywords: ["LNK2017"] helpviewer_keywords: ["LNK2017"] -ms.assetid: f7c21733-b0fb-4888-a295-9b453ba6ee77 --- # Linker Tools Error LNK2017 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md index 6c61d5141db..9cafc696e3a 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2023" title: "Linker Tools Error LNK2023" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2023" +ms.date: 11/04/2016 f1_keywords: ["LNK2023"] helpviewer_keywords: ["LNK2023"] -ms.assetid: c99e35a8-739a-4a20-a715-29b8c3744703 --- # Linker Tools Error LNK2023 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md index 43ca5a14f3f..13bf2776bd7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2026" title: "Linker Tools Error LNK2026" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2026" +ms.date: 11/04/2016 f1_keywords: ["LNK2026"] helpviewer_keywords: ["LNK2026"] -ms.assetid: 9955bf7c-59b5-4fa1-8481-147db0d7df45 --- # Linker Tools Error LNK2026 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md index 46178544ba1..c95f4d0ad62 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2027" title: "Linker Tools Error LNK2027" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2027" +ms.date: 11/04/2016 f1_keywords: ["LNK2027"] helpviewer_keywords: ["LNK2027"] -ms.assetid: e2f857a8-8e8a-4697-bbff-12ccb84a35c1 --- # Linker Tools Error LNK2027 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md index a38c878f50f..82760815f9d 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2028" title: "Linker Tools Error LNK2028" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2028" +ms.date: 11/04/2016 f1_keywords: ["LNK2028"] helpviewer_keywords: ["LNK2028"] -ms.assetid: e2b03293-6066-464d-a050-ce747bcf7f0e --- # Linker Tools Error LNK2028 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md index 4a4c562eee3..69581fa9667 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2031" title: "Linker Tools Error LNK2031" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2031" +ms.date: 11/04/2016 f1_keywords: ["LNK2031"] helpviewer_keywords: ["LNK2031"] -ms.assetid: 18ed4b6e-3e75-443c-bbd8-2f6030dc89ee --- # Linker Tools Error LNK2031 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md index d57b2b4cbcd..64c8c87a92e 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Error LNK2038" title: "Linker Tools Error LNK2038" -ms.date: "12/15/2017" +description: "Learn more about: Linker Tools Error LNK2038" +ms.date: 12/15/2017 f1_keywords: ["LNK2038"] helpviewer_keywords: ["LNK2038"] --- diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md index 5b565e432dd..6f441c91161 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2039" title: "Linker Tools Error LNK2039" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2039" +ms.date: 11/04/2016 f1_keywords: ["LNK2039"] helpviewer_keywords: ["LNK2039"] -ms.assetid: eaa296bd-4901-41f6-8410-6d03ee827144 --- # Linker Tools Error LNK2039 From 94eff3456d3374d388d6be95f786dca941a2feb3 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 22 Sep 2025 22:39:41 +0800 Subject: [PATCH 1278/1799] Add blockquotes for warning messages in range [LNK4001, LNK4105] --- docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md | 2 +- 23 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md index acead2979da..06cf586b281 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md @@ -8,7 +8,7 @@ ms.assetid: 0a8b1c3a-64ce-4311-b7c0-065995059246 --- # Linker Tools Warning LNK4001 -no object files specified; libraries used +> no object files specified; libraries used The linker was passed one or more .lib files, but no .obj files. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md index ac15b1573cc..27ad399e6be 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md @@ -8,6 +8,6 @@ ms.assetid: 09f81af5-e51c-496c-a6eb-2863e85375c3 --- # Linker Tools Warning LNK4002 -symbol defined in object +> symbol defined in object The symbol, displayed in its decorated form, was specified in its undecorated form in `object`, but a unique match to a decorated symbol could not be found. This warning is always preceded by warning [LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) and followed by fatal error [LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md index b53d91f7c4a..33284094cde 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md @@ -8,7 +8,7 @@ ms.assetid: 3a637d17-1676-4ea6-bd8b-290137d28d3b --- # Linker Tools Warning LNK4006 -symbol already defined in object; second definition ignored +> symbol already defined in object; second definition ignored The given `symbol`, displayed in its decorated form, was multiply defined. When this warning is encountered, `symbol` will be added twice, but only its first form will be used. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md index 64f217c9de3..64839f0e4fe 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md @@ -8,6 +8,6 @@ ms.assetid: 2824cf99-4174-4b60-a6e2-c01e9f1ee52d --- # Linker Tools Warning LNK4010 -invalid subsystem version number number; default subsystem version assumed +> invalid subsystem version number number; default subsystem version assumed You can specify a version for the image's subsystem ([/SUBSYSTEM](../../build/reference/subsystem-specify-subsystem.md)). Each subsystem has a minimum version requirement. If the specified version is lower than the minimum, this warning will occur and the linker will just use the default subsystem. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md index fed59984e71..d547f50a91b 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md @@ -8,7 +8,7 @@ ms.assetid: 394903e9-3ded-4ea4-b7c0-a3535d4b4da4 --- # Linker Tools Warning LNK4014 -cannot find member object "objectname" +> cannot find member object "objectname" LIB could not find `objectname` in the library. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md index 49b2a8b1866..472f2a6f56e 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md @@ -8,7 +8,7 @@ ms.assetid: 890f487e-db98-45dd-a226-c7ccead82b1e --- # Linker Tools Warning LNK4022 -cannot find unique match for symbol 'symbol' +> cannot find unique match for symbol 'symbol' LINK or LIB found multiple matches for the given undecorated symbol and it could not resolve the ambiguity. No output file (.exe, .dll, .exp, or .lib) is produced. This warning is followed by one warning [LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) for each duplicate symbol and is finally followed by fatal error [LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md index 271d321252a..e9351139923 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md @@ -8,7 +8,7 @@ ms.assetid: 9ba02fd3-b04f-4679-bab9-26fa82cf09bb --- # Linker Tools Warning LNK4037 ->'*symbol*' does not exist; ignored +> '*symbol*' does not exist; ignored The decorated name *symbol* could not be ordered by using the [/ORDER](../../build/reference/order-put-functions-in-order.md) option because it could not be found in the program. Check the specification of *symbol* in the order response file. For more information, see the [/ORDER (Put functions in order)](../../build/reference/order-put-functions-in-order.md) linker option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md index 408939d9f3f..b60c604ec91 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md @@ -8,7 +8,7 @@ ms.assetid: ed7b1783-a7b2-4d3e-8afb-ca1648dae2c2 --- # Linker Tools Warning LNK4039 -section 'name' specified with /SECTION option does not exist +> section 'name' specified with /SECTION option does not exist [DUMPBIN](../../build/reference/dumpbin-reference.md) or [EDITBIN](../../build/reference/editbin-reference.md) could not find a section called `name` in the input file. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md index 6f46ad0a097..dbf17074b7c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md @@ -8,7 +8,7 @@ ms.assetid: f3a67a15-98c0-42ed-afcb-f5f9540e2671 --- # Linker Tools Warning LNK4044 -unrecognized option 'option'; ignored +> unrecognized option 'option'; ignored The given option is not a valid option for this tool. The tool ignored the option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md index 0313df14016..c08cf9e68ad 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md @@ -8,6 +8,6 @@ ms.assetid: aa5c9e2c-9ad3-4460-8605-4c12bbc6d423 --- # Linker Tools Warning LNK4065 -'function' cannot be ordered; ignored +> 'function' cannot be ordered; ignored The given function was not compiled as a packaged function. Recompile using [/Gy](../../build/reference/gy-enable-function-level-linking.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md index 2d4a8c774ae..965dcc80f53 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md @@ -8,7 +8,7 @@ ms.assetid: f95f179a-fff9-427e-bd51-466b3934517f --- # Linker Tools Warning LNK4070 -/OUT:filename directive in .EXP differs from output filename 'filename'; ignoring directive +> /OUT:filename directive in .EXP differs from output filename 'filename'; ignoring directive The `filename` specified in the [NAME](../../build/reference/name-c-cpp.md) or [LIBRARY](../../build/reference/library.md) statement when the .exp file was created differs from the output `filename` that was either assumed by default or specified with the [/OUT](../../build/reference/out-output-file-name.md) option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md index 83437b5126a..b488f5dedf4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md @@ -8,6 +8,6 @@ ms.assetid: 803f8c34-8219-4f55-a4ae-7133ceff2ba3 --- # Linker Tools Warning LNK4071 -cannot be incrementally linked on subsequent links +> cannot be incrementally linked on subsequent links LINK found multiple definitions for one or more symbols, but [/FORCE](../../build/reference/force-force-file-output.md) or **/FORCE:MULTIPLE** was used to create an output file regardless of errors. LINK deleted the incremental status (.ilk) file. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md index 121c6eaadbc..ac2193be713 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md @@ -8,6 +8,6 @@ ms.assetid: a0c80242-3395-45bd-bbe7-4f31d7ac9e3a --- # Linker Tools Warning LNK4073 -cannot create map for .ilk file; linking nonincrementally +> cannot create map for .ilk file; linking nonincrementally There was not a large enough contiguous space in shared memory for LINK to create the incremental status (.ilk) file. LINK performed a nonincremental build. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md index d68c11580e0..30f0cac408f 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md @@ -8,7 +8,7 @@ ms.assetid: f39ad3f9-c263-4cf0-9d70-259fc56ac96d --- # Linker Tools Warning LNK4075 -ignoring "option1" due to "option2" specification +> ignoring "option1" due to "option2" specification The second option overrides the first. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md index 34b7ca35901..b2d7adb6578 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md @@ -8,6 +8,6 @@ ms.assetid: c424d43b-abb3-4df4-be66-8907b859a555 --- # Linker Tools Warning LNK4076 -invalid incremental status file 'filename'; linking nonincrementally +> invalid incremental status file 'filename'; linking nonincrementally LINK cannot write to the incremental status (.ilk) file. Either `filename` is corrupt or it is not an incremental linking database. Remove the file and relink. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md index 407078f7750..7b2a90535da 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md @@ -8,7 +8,7 @@ ms.assetid: 5a16796d-6caf-42d9-8f65-b042843eafb8 --- # Linker Tools Warning LNK4078 -multiple 'section name' sections found with different attributes +> multiple 'section name' sections found with different attributes LINK found two or more sections that have the same name but different attributes. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md index c41c539e819..e8e1018f2ea 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md @@ -8,6 +8,6 @@ ms.assetid: ea1eecbb-ba2c-41bb-9a4f-fa0808a4b92d --- # Linker Tools Warning LNK4086 -entrypoint 'function' is not __stdcall with 'number' bytes of arguments; image may not run +> entrypoint 'function' is not __stdcall with 'number' bytes of arguments; image may not run The entry point for a DLL must be **`__stdcall`**. Either recompile the function with the [/Gz](../../build/reference/gd-gr-gv-gz-calling-convention.md) option or specify **`__stdcall`** or WINAPI when you define the function. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md index 952fb421cd8..096ed29b875 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md @@ -8,7 +8,7 @@ ms.assetid: d569ec47-a338-40e1-940b-8a8061459acb --- # Linker Tools Warning LNK4092 -shared writable section 'section' contains relocations; image may not run correctly +> shared writable section 'section' contains relocations; image may not run correctly The linker emits this warning whenever you have a shared section to warn you of a potentially serious problem. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md index 51afe7b4cf2..e42a95d3bd6 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md @@ -8,6 +8,6 @@ ms.assetid: ef6fba38-59a1-4d86-bcac-cadf44d87a36 --- # Linker Tools Warning LNK4096 -/BASE value "number" is invalid for Windows 95 and Windows 98; image may not run +> /BASE value "number" is invalid for Windows 95 and Windows 98; image may not run The base address you specified is invalid. Windows 95 and Windows 98 executable files must have a base address greater than 0x400000. For more information on base addresses, see the [/BASE](../../build/reference/base-base-address.md) linker option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md index 1883d934dfa..73c42ce6f4a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md @@ -8,7 +8,7 @@ ms.assetid: 358170a4-07cd-43fe-918f-82c32757ffc5 --- # Linker Tools Warning LNK4099 -PDB 'filename' was not found with 'object/library' or at 'path'; linking object as if no debug info +> PDB 'filename' was not found with 'object/library' or at 'path'; linking object as if no debug info The linker was unable to find your .pdb file. Copy it into the directory that contains `object/library`. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md index 126e92d5743..6979bf753e0 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md @@ -8,7 +8,7 @@ ms.assetid: bfd1b17e-05c7-4bc2-80d6-2888b1a425b2 --- # Linker Tools Warning LNK4102 -export of deleting destructor 'name'; image may not run correctly +> export of deleting destructor 'name'; image may not run correctly The program has attempted to export a deleting destructor. The resulting delete may occur across a DLL boundary such that a process can free memory that it does not own. Make sure that the given symbol is not listed in your .def file, and that the symbol is not listed as an argument of the **/IMPORT** or **/EXPORT** option in the linker command line. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md index 3b3226b097e..b6729975052 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md @@ -8,7 +8,7 @@ ms.assetid: ca6728db-d616-419a-a570-65e8445c6079 --- # Linker Tools Warning LNK4104 -export of symbol 'symbol' should be PRIVATE +> export of symbol 'symbol' should be PRIVATE The `symbol` can be one of the following: diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md index 260ed1245f6..b08a98299bb 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["LNK4105"] --- # Linker Tools Warning LNK4105 -no argument specified with option 'option'; ignoring option +> no argument specified with option 'option'; ignoring option This warning occurs only when the [/LIBPATH](../../build/reference/libpath-additional-libpath.md) option is set. If no directory is specified with this option, then the linker ignores the option and generates this warning message. From 6db3e20542dad84b95c28b03048fee9b613bdaad Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 22 Sep 2025 22:43:29 +0800 Subject: [PATCH 1279/1799] Add "Remarks" headings for warning references in range [LNK4001, LNK4105] --- .../tool-errors/linker-tools-warning-lnk4001.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4002.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4006.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4010.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4014.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4020.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4022.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4037.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4039.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4044.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4049.md | 4 ++-- .../tool-errors/linker-tools-warning-lnk4065.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4070.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4071.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4073.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4075.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4076.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4078.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4086.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4092.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4096.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4098.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4099.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4102.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4104.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4105.md | 2 ++ 26 files changed, 52 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md index 06cf586b281..48e1299152e 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md @@ -10,6 +10,8 @@ ms.assetid: 0a8b1c3a-64ce-4311-b7c0-065995059246 > no object files specified; libraries used +## Remarks + The linker was passed one or more .lib files, but no .obj files. Because the linker is not able to access information in a .lib file that it is able to access in an .obj file, this warning indicates that you will have to explicitly specify other linker options. For example, you may have to specify the [/MACHINE](../../build/reference/machine-specify-target-platform.md), [/OUT](../../build/reference/out-output-file-name.md), or [/ENTRY](../../build/reference/entry-entry-point-symbol.md) options. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md index 27ad399e6be..53a1575a327 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md @@ -10,4 +10,6 @@ ms.assetid: 09f81af5-e51c-496c-a6eb-2863e85375c3 > symbol defined in object +## Remarks + The symbol, displayed in its decorated form, was specified in its undecorated form in `object`, but a unique match to a decorated symbol could not be found. This warning is always preceded by warning [LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) and followed by fatal error [LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md index 33284094cde..5f620a003ba 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md @@ -10,6 +10,8 @@ ms.assetid: 3a637d17-1676-4ea6-bd8b-290137d28d3b > symbol already defined in object; second definition ignored +## Remarks + The given `symbol`, displayed in its decorated form, was multiply defined. When this warning is encountered, `symbol` will be added twice, but only its first form will be used. You can get this warning if you try to merge two import libs into one. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md index 64839f0e4fe..49270a282f4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md @@ -10,4 +10,6 @@ ms.assetid: 2824cf99-4174-4b60-a6e2-c01e9f1ee52d > invalid subsystem version number number; default subsystem version assumed +## Remarks + You can specify a version for the image's subsystem ([/SUBSYSTEM](../../build/reference/subsystem-specify-subsystem.md)). Each subsystem has a minimum version requirement. If the specified version is lower than the minimum, this warning will occur and the linker will just use the default subsystem. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md index d547f50a91b..9e24ac64a00 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md @@ -10,6 +10,8 @@ ms.assetid: 394903e9-3ded-4ea4-b7c0-a3535d4b4da4 > cannot find member object "objectname" +## Remarks + LIB could not find `objectname` in the library. The **/REMOVE** and **/EXTRACT** options require the full name of the member object that is to be deleted or copied to a file. The full name includes the path of the original object file. To see the full names of member objects in a library, use DUMPBIN [/ARCHIVEMEMBERS](../../build/reference/archivemembers.md) or LIB [/LIST](../../build/reference/managing-a-library.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md index 264bda4b079..b8527b4e8f8 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK4020"] > a type record in '*filename*' is corrupted; some symbols and types may not be accessible from the debugger +## Remarks + The PDB file *filename* has a corrupted type record. This issue is often secondary to other build issues; unless this is the first reported build issue, deal with the other errors and warnings first. If this is the first reported issue, you may need to clean your build directories and rebuild your project. If you use parallel build processes, see if the error persists when you serialize your build. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md index 472f2a6f56e..9efbb357bf4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md @@ -10,6 +10,8 @@ ms.assetid: 890f487e-db98-45dd-a226-c7ccead82b1e > cannot find unique match for symbol 'symbol' +## Remarks + LINK or LIB found multiple matches for the given undecorated symbol and it could not resolve the ambiguity. No output file (.exe, .dll, .exp, or .lib) is produced. This warning is followed by one warning [LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) for each duplicate symbol and is finally followed by fatal error [LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md). To prevent this warning, specify the symbol in its decorated form. Run [DUMPBIN](../../build/reference/dumpbin-options.md) on the object to see decorated names. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md index e9351139923..54e082e4a34 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md @@ -10,6 +10,8 @@ ms.assetid: 9ba02fd3-b04f-4679-bab9-26fa82cf09bb > '*symbol*' does not exist; ignored +## Remarks + The decorated name *symbol* could not be ordered by using the [/ORDER](../../build/reference/order-put-functions-in-order.md) option because it could not be found in the program. Check the specification of *symbol* in the order response file. For more information, see the [/ORDER (Put functions in order)](../../build/reference/order-put-functions-in-order.md) linker option. > [!NOTE] diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md index b60c604ec91..ab1f8f0eee6 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md @@ -10,6 +10,8 @@ ms.assetid: ed7b1783-a7b2-4d3e-8afb-ca1648dae2c2 > section 'name' specified with /SECTION option does not exist +## Remarks + [DUMPBIN](../../build/reference/dumpbin-reference.md) or [EDITBIN](../../build/reference/editbin-reference.md) could not find a section called `name` in the input file. To see the sections in a file, run DUMPBIN with the [/HEADERS](../../build/reference/headers.md) option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md index dbf17074b7c..1df4cd87c6b 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md @@ -10,6 +10,8 @@ ms.assetid: f3a67a15-98c0-42ed-afcb-f5f9540e2671 > unrecognized option 'option'; ignored +## Remarks + The given option is not a valid option for this tool. The tool ignored the option. To see a list of valid options, run the tool with no arguments or options. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md index 2a99ccb7648..1345c6e964a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md @@ -10,10 +10,10 @@ ms.assetid: 5fd5fb24-c860-4149-a557-0ac26a65d97c > symbol '*symbol*' defined in '*filename.obj*' is imported -[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for *symbol* even though the symbol is defined in object file *filename.obj* in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. - ## Remarks +[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for *symbol* even though the symbol is defined in object file *filename.obj* in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. + This warning is generated by the linker when you define a symbol in one object file and reference it by using the `__declspec(dllimport)` declaration modifier in another. Warning LNK4049 is a more general version of [Linker Tools Warning LNK4217](linker-tools-warning-lnk4217.md). The linker generates warning LNK4049 when it can't determine which function or object file referenced the imported symbol. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md index c08cf9e68ad..ce47348437a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md @@ -10,4 +10,6 @@ ms.assetid: aa5c9e2c-9ad3-4460-8605-4c12bbc6d423 > 'function' cannot be ordered; ignored +## Remarks + The given function was not compiled as a packaged function. Recompile using [/Gy](../../build/reference/gy-enable-function-level-linking.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md index 965dcc80f53..87cadb8db1f 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md @@ -10,6 +10,8 @@ ms.assetid: f95f179a-fff9-427e-bd51-466b3934517f > /OUT:filename directive in .EXP differs from output filename 'filename'; ignoring directive +## Remarks + The `filename` specified in the [NAME](../../build/reference/name-c-cpp.md) or [LIBRARY](../../build/reference/library.md) statement when the .exp file was created differs from the output `filename` that was either assumed by default or specified with the [/OUT](../../build/reference/out-output-file-name.md) option. You will see this warning if you change the name of an output file in the development environment and where the project's .def file was not updated. Manually update the .def file to resolve this warning. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md index b488f5dedf4..23ec8476710 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md @@ -10,4 +10,6 @@ ms.assetid: 803f8c34-8219-4f55-a4ae-7133ceff2ba3 > cannot be incrementally linked on subsequent links +## Remarks + LINK found multiple definitions for one or more symbols, but [/FORCE](../../build/reference/force-force-file-output.md) or **/FORCE:MULTIPLE** was used to create an output file regardless of errors. LINK deleted the incremental status (.ilk) file. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md index ac2193be713..2bac04906cb 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md @@ -10,4 +10,6 @@ ms.assetid: a0c80242-3395-45bd-bbe7-4f31d7ac9e3a > cannot create map for .ilk file; linking nonincrementally +## Remarks + There was not a large enough contiguous space in shared memory for LINK to create the incremental status (.ilk) file. LINK performed a nonincremental build. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md index 30f0cac408f..a63142f5a3a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md @@ -10,6 +10,8 @@ ms.assetid: f39ad3f9-c263-4cf0-9d70-259fc56ac96d > ignoring "option1" due to "option2" specification +## Remarks + The second option overrides the first. Mutually exclusive linker options are being specified. Examine your linker options. Where linker options are specified depends on how you are building your project. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md index b2d7adb6578..cf26698b1ff 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md @@ -10,4 +10,6 @@ ms.assetid: c424d43b-abb3-4df4-be66-8907b859a555 > invalid incremental status file 'filename'; linking nonincrementally +## Remarks + LINK cannot write to the incremental status (.ilk) file. Either `filename` is corrupt or it is not an incremental linking database. Remove the file and relink. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md index 7b2a90535da..8235ed6716e 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md @@ -10,6 +10,8 @@ ms.assetid: 5a16796d-6caf-42d9-8f65-b042843eafb8 > multiple 'section name' sections found with different attributes +## Remarks + LINK found two or more sections that have the same name but different attributes. This warning can be caused by an import library or exports file that was created by a previous version of LINK or LIB. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md index e8e1018f2ea..20a14d19d2f 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md @@ -10,4 +10,6 @@ ms.assetid: ea1eecbb-ba2c-41bb-9a4f-fa0808a4b92d > entrypoint 'function' is not __stdcall with 'number' bytes of arguments; image may not run +## Remarks + The entry point for a DLL must be **`__stdcall`**. Either recompile the function with the [/Gz](../../build/reference/gd-gr-gv-gz-calling-convention.md) option or specify **`__stdcall`** or WINAPI when you define the function. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md index 096ed29b875..c536d05d2d4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md @@ -10,6 +10,8 @@ ms.assetid: d569ec47-a338-40e1-940b-8a8061459acb > shared writable section 'section' contains relocations; image may not run correctly +## Remarks + The linker emits this warning whenever you have a shared section to warn you of a potentially serious problem. One way to share data between multiple processes is to mark a section as "shared." However, marking a section as shared can cause problems. For example, you have a DLL that contains declarations like this in a shared data section: diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md index e42a95d3bd6..f176fbb3991 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md @@ -10,4 +10,6 @@ ms.assetid: ef6fba38-59a1-4d86-bcac-cadf44d87a36 > /BASE value "number" is invalid for Windows 95 and Windows 98; image may not run +## Remarks + The base address you specified is invalid. Windows 95 and Windows 98 executable files must have a base address greater than 0x400000. For more information on base addresses, see the [/BASE](../../build/reference/base-base-address.md) linker option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md index 114be4256bc..023f069ac8e 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md @@ -10,6 +10,8 @@ ms.assetid: 1f1b1408-1316-4e34-80f5-6a02f2db0ac1 > defaultlib '*library*' conflicts with use of other libs; use /NODEFAULTLIB:*library* +## Remarks + You're trying to link with incompatible libraries. > [!NOTE] diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md index 73c42ce6f4a..b185f6de11b 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md @@ -10,6 +10,8 @@ ms.assetid: 358170a4-07cd-43fe-918f-82c32757ffc5 > PDB 'filename' was not found with 'object/library' or at 'path'; linking object as if no debug info +## Remarks + The linker was unable to find your .pdb file. Copy it into the directory that contains `object/library`. To find the name of the .pdb file associated with the object file: diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md index 6979bf753e0..bb4934c900a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md @@ -10,6 +10,8 @@ ms.assetid: bfd1b17e-05c7-4bc2-80d6-2888b1a425b2 > export of deleting destructor 'name'; image may not run correctly +## Remarks + The program has attempted to export a deleting destructor. The resulting delete may occur across a DLL boundary such that a process can free memory that it does not own. Make sure that the given symbol is not listed in your .def file, and that the symbol is not listed as an argument of the **/IMPORT** or **/EXPORT** option in the linker command line. If you are rebuilding the C run-time library, you can ignore this message. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md index b6729975052..90d6643bfad 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md @@ -10,6 +10,8 @@ ms.assetid: ca6728db-d616-419a-a570-65e8445c6079 > export of symbol 'symbol' should be PRIVATE +## Remarks + The `symbol` can be one of the following: - `DllCanUnloadNow` diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md index b08a98299bb..aebda983258 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK4105"] > no argument specified with option 'option'; ignoring option +## Remarks + This warning occurs only when the [/LIBPATH](../../build/reference/libpath-additional-libpath.md) option is set. If no directory is specified with this option, then the linker ignores the option and generates this warning message. If you do not need to override the existing environmental library settings, remove the /LIBPATH option from the linker command line. If you want to use an alternate search path for libraries, specify the alternate path following the /LIBPATH option. From 89501900f8f919910aa3c2d8d660cec1399e90b1 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 22 Sep 2025 22:44:14 +0800 Subject: [PATCH 1280/1799] Replace term "sample" with "example" for warning references in range [LNK4001, LNK4105] --- docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md index 8235ed6716e..d4da251c384 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md @@ -22,7 +22,7 @@ Recreate the file and relink. LNK4078 can also be caused by a breaking change: the section named by [init_seg](../../preprocessor/init-seg.md) on x86 was read/write, it is now read only. -The following sample generates LNK4078. +The following example generates LNK4078. ```cpp // LNK4078.cpp From 6a773d63f6ec8d4908a4584f2fb041237fec3f36 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 22 Sep 2025 22:49:20 +0800 Subject: [PATCH 1281/1799] Update metadata for warning references in range [LNK4001, LNK4105] --- .../tool-errors/linker-tools-warning-lnk4001.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4002.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4006.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4010.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4014.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4020.md | 4 ++-- .../tool-errors/linker-tools-warning-lnk4022.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4037.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4039.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4044.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4049.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4065.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4070.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4071.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4073.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4075.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4076.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4078.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4086.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4092.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4096.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4098.md | 3 +-- .../tool-errors/linker-tools-warning-lnk4099.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4102.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4104.md | 5 ++--- 25 files changed, 49 insertions(+), 73 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md index 48e1299152e..5a3f63068cc 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4001" title: "Linker Tools Warning LNK4001" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4001" +ms.date: 11/04/2016 f1_keywords: ["LNK4001"] helpviewer_keywords: ["LNK4001"] -ms.assetid: 0a8b1c3a-64ce-4311-b7c0-065995059246 --- # Linker Tools Warning LNK4001 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md index 53a1575a327..71cff124cea 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4002" title: "Linker Tools Warning LNK4002" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4002" +ms.date: 11/04/2016 f1_keywords: ["LNK4002"] helpviewer_keywords: ["LNK4002"] -ms.assetid: 09f81af5-e51c-496c-a6eb-2863e85375c3 --- # Linker Tools Warning LNK4002 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md index 5f620a003ba..8fd9e721fe0 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4006" title: "Linker Tools Warning LNK4006" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4006" +ms.date: 11/04/2016 f1_keywords: ["LNK4006"] helpviewer_keywords: ["LNK4006"] -ms.assetid: 3a637d17-1676-4ea6-bd8b-290137d28d3b --- # Linker Tools Warning LNK4006 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md index 49270a282f4..a586214ca26 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4010" title: "Linker Tools Warning LNK4010" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4010" +ms.date: 11/04/2016 f1_keywords: ["LNK4010"] helpviewer_keywords: ["LNK4010"] -ms.assetid: 2824cf99-4174-4b60-a6e2-c01e9f1ee52d --- # Linker Tools Warning LNK4010 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md index 9e24ac64a00..d073124ac8c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4014" title: "Linker Tools Warning LNK4014" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4014" +ms.date: 11/04/2016 f1_keywords: ["LNK4014"] helpviewer_keywords: ["LNK4014"] -ms.assetid: 394903e9-3ded-4ea4-b7c0-a3535d4b4da4 --- # Linker Tools Warning LNK4014 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md index b8527b4e8f8..913227f12fa 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Warning LNK4020" title: "Linker Tools Warning LNK4020" -ms.date: "05/29/2018" +description: "Learn more about: Linker Tools Warning LNK4020" +ms.date: 05/29/2018 f1_keywords: ["LNK4020"] helpviewer_keywords: ["LNK4020"] --- diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md index 9efbb357bf4..b8629ec6796 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4022" title: "Linker Tools Warning LNK4022" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4022" +ms.date: 11/04/2016 f1_keywords: ["LNK4022"] helpviewer_keywords: ["LNK4022"] -ms.assetid: 890f487e-db98-45dd-a226-c7ccead82b1e --- # Linker Tools Warning LNK4022 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md index 54e082e4a34..2eafbb1026b 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4037" title: "Linker Tools Warning LNK4037" -ms.date: "10/04/2017" +description: "Learn more about: Linker Tools Warning LNK4037" +ms.date: 10/04/2017 f1_keywords: ["LNK4037"] helpviewer_keywords: ["LNK4037"] -ms.assetid: 9ba02fd3-b04f-4679-bab9-26fa82cf09bb --- # Linker Tools Warning LNK4037 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md index ab1f8f0eee6..c86c2783939 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4039" title: "Linker Tools Warning LNK4039" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4039" +ms.date: 11/04/2016 f1_keywords: ["LNK4039"] helpviewer_keywords: ["LNK4039"] -ms.assetid: ed7b1783-a7b2-4d3e-8afb-ca1648dae2c2 --- # Linker Tools Warning LNK4039 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md index 1df4cd87c6b..3852e8bb3b7 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4044" title: "Linker Tools Warning LNK4044" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4044" +ms.date: 11/04/2016 f1_keywords: ["LNK4044"] helpviewer_keywords: ["LNK4044"] -ms.assetid: f3a67a15-98c0-42ed-afcb-f5f9540e2671 --- # Linker Tools Warning LNK4044 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md index 1345c6e964a..7f6c8738fa3 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4049" title: "Linker Tools Warning LNK4049" -ms.date: "04/15/2019" +description: "Learn more about: Linker Tools Warning LNK4049" +ms.date: 04/15/2019 f1_keywords: ["LNK4049"] helpviewer_keywords: ["LNK4049"] -ms.assetid: 5fd5fb24-c860-4149-a557-0ac26a65d97c --- # Linker Tools Warning LNK4049 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md index ce47348437a..866c8e515fb 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4065" title: "Linker Tools Warning LNK4065" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4065" +ms.date: 11/04/2016 f1_keywords: ["LNK4065"] helpviewer_keywords: ["LNK4065"] -ms.assetid: aa5c9e2c-9ad3-4460-8605-4c12bbc6d423 --- # Linker Tools Warning LNK4065 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md index 87cadb8db1f..73002b55e0a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4070" title: "Linker Tools Warning LNK4070" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4070" +ms.date: 11/04/2016 f1_keywords: ["LNK4070"] helpviewer_keywords: ["LNK4070"] -ms.assetid: f95f179a-fff9-427e-bd51-466b3934517f --- # Linker Tools Warning LNK4070 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md index 23ec8476710..f11ad7b9b8f 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4071" title: "Linker Tools Warning LNK4071" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4071" +ms.date: 11/04/2016 f1_keywords: ["LNK4071"] helpviewer_keywords: ["LNK4071"] -ms.assetid: 803f8c34-8219-4f55-a4ae-7133ceff2ba3 --- # Linker Tools Warning LNK4071 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md index 2bac04906cb..0347c6cd330 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4073" title: "Linker Tools Warning LNK4073" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4073" +ms.date: 11/04/2016 f1_keywords: ["LNK4073"] helpviewer_keywords: ["LNK4073"] -ms.assetid: a0c80242-3395-45bd-bbe7-4f31d7ac9e3a --- # Linker Tools Warning LNK4073 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md index a63142f5a3a..30c7c247f9c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4075" title: "Linker Tools Warning LNK4075" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4075" +ms.date: 11/04/2016 f1_keywords: ["LNK4075"] helpviewer_keywords: ["LNK4075"] -ms.assetid: f39ad3f9-c263-4cf0-9d70-259fc56ac96d --- # Linker Tools Warning LNK4075 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md index cf26698b1ff..2f5ab3ac799 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4076" title: "Linker Tools Warning LNK4076" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4076" +ms.date: 11/04/2016 f1_keywords: ["LNK4076"] helpviewer_keywords: ["LNK4076"] -ms.assetid: c424d43b-abb3-4df4-be66-8907b859a555 --- # Linker Tools Warning LNK4076 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md index d4da251c384..977fec14c67 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4078" title: "Linker Tools Warning LNK4078" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4078" +ms.date: 11/04/2016 f1_keywords: ["LNK4078"] helpviewer_keywords: ["LNK4078"] -ms.assetid: 5a16796d-6caf-42d9-8f65-b042843eafb8 --- # Linker Tools Warning LNK4078 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md index 20a14d19d2f..3e04f4741cd 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4086" title: "Linker Tools Warning LNK4086" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4086" +ms.date: 11/04/2016 f1_keywords: ["LNK4086"] helpviewer_keywords: ["LNK4086"] -ms.assetid: ea1eecbb-ba2c-41bb-9a4f-fa0808a4b92d --- # Linker Tools Warning LNK4086 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md index c536d05d2d4..8db800d129a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4092" title: "Linker Tools Warning LNK4092" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4092" +ms.date: 11/04/2016 f1_keywords: ["LNK4092"] helpviewer_keywords: ["LNK4092"] -ms.assetid: d569ec47-a338-40e1-940b-8a8061459acb --- # Linker Tools Warning LNK4092 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md index f176fbb3991..239b7d127b1 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4096" title: "Linker Tools Warning LNK4096" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4096" +ms.date: 11/04/2016 f1_keywords: ["LNK4096"] helpviewer_keywords: ["LNK4096"] -ms.assetid: ef6fba38-59a1-4d86-bcac-cadf44d87a36 --- # Linker Tools Warning LNK4096 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md index 023f069ac8e..d978b129442 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md @@ -1,10 +1,9 @@ --- title: "Linker Tools Warning LNK4098" description: "Describes how incompatible libraries cause linker tools warning LNK4098, and how to use /NODEFAULTLIB to fix it." -ms.date: "12/02/2019" +ms.date: 12/02/2019 f1_keywords: ["LNK4098"] helpviewer_keywords: ["LNK4098"] -ms.assetid: 1f1b1408-1316-4e34-80f5-6a02f2db0ac1 --- # Linker Tools Warning LNK4098 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md index b185f6de11b..658a4303a78 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4099" title: "Linker Tools Warning LNK4099" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4099" +ms.date: 11/04/2016 f1_keywords: ["LNK4099"] helpviewer_keywords: ["LNK4099"] -ms.assetid: 358170a4-07cd-43fe-918f-82c32757ffc5 --- # Linker Tools Warning LNK4099 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md index bb4934c900a..946bbf5a630 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4102" title: "Linker Tools Warning LNK4102" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4102" +ms.date: 11/04/2016 f1_keywords: ["LNK4102"] helpviewer_keywords: ["LNK4102"] -ms.assetid: bfd1b17e-05c7-4bc2-80d6-2888b1a425b2 --- # Linker Tools Warning LNK4102 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md index 90d6643bfad..f606c690933 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4104" title: "Linker Tools Warning LNK4104" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4104" +ms.date: 11/04/2016 f1_keywords: ["LNK4104"] helpviewer_keywords: ["LNK4104"] -ms.assetid: ca6728db-d616-419a-a570-65e8445c6079 --- # Linker Tools Warning LNK4104 From 2cd99bef82b3ef8f1fd131300b422e1608c926bb Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 22 Sep 2025 22:58:21 +0800 Subject: [PATCH 1282/1799] Add blockquotes for warning messages in range [LNK4106, LNK4307] --- docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md | 2 +- docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md | 2 +- 15 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md index f22bd2a4fc2..2639e0769ee 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md @@ -8,6 +8,6 @@ ms.assetid: a45f437e-33b5-487e-b3cd-ff1560041e7e --- # Linker Tools Warning LNK4194 -/DELAYLOAD:dll name ignored +> /DELAYLOAD:dll name ignored The linker cannot [delay load](../../build/reference/delayload-delay-load-import.md) the requested DLL. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md index 04a8983c778..b81309940eb 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md @@ -8,6 +8,6 @@ ms.assetid: 724f1ca8-ee9a-4ca3-b5c6-c0284a5195e7 --- # Linker Tools Warning LNK4199 -/DELAYLOAD:dllname ignored; no imports found from dllname +> /DELAYLOAD:dllname ignored; no imports found from dllname The linker ignores `dllname` because it does not need any of the functions that `dllname` exports. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md index 558e5ec0f5e..05864bf7b98 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md @@ -8,6 +8,6 @@ ms.assetid: 0d335e69-8766-455b-beb5-a3ba6247274e --- # Linker Tools Warning LNK4200 -corrupt line number information in object file; ignored +> corrupt line number information in object file; ignored The line number information in the object file is corrupt. Rebuild. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md index f9949c94b46..6ee94836b30 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md @@ -8,7 +8,7 @@ ms.assetid: 14adda20-0cbe-407b-90f6-9f81c93530e2 --- # Linker Tools Warning LNK4204 -'filename' is missing debugging information for referencing module; linking object as if no debug info +> 'filename' is missing debugging information for referencing module; linking object as if no debug info The .pdb file has an erroneous signature. The linker will continue to link the object without debug information. You may want to recompile the object file using the [/Zi](../../build/reference/z7-zi-zi-debug-information-format.md) option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md index 6f77534f6fc..dba0f80639e 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md @@ -8,6 +8,6 @@ ms.assetid: d63b9d18-ef3c-4081-9d8d-93077dad13c2 --- # Linker Tools Warning LNK4205 -'filename' is missing current debugging information for referencing module; linking object as if no debug info +> 'filename' is missing current debugging information for referencing module; linking object as if no debug info The .pdb file has out-of-date information. The linker will continue to link object without debug information. You may want to recompile the object file using the [/Zi](../../build/reference/z7-zi-zi-debug-information-format.md) option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md index 167ab652430..1c62a118f25 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md @@ -8,6 +8,6 @@ ms.assetid: 68512095-acbc-47aa-96bf-9eb0e73b24a3 --- # Linker Tools Warning LNK4216 -Exported entry point entry +> Exported entry point entry An entry point was exported from a DLL. The entry point of a DLL does not need to be exported. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md index ca1f30a8c38..40f03e4a4af 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md @@ -8,7 +8,7 @@ ms.assetid: 363fedf4-b10c-4985-811a-55a9fba688d6 --- # Linker Tools Warning LNK4219 -fixup name fixup overflow. Target 'target symbol name' is out of range, inserting thunk +> fixup name fixup overflow. Target 'target symbol name' is out of range, inserting thunk The linker inserted a thunk in a situation where the address or offset was unable to fit in the given instruction because the target symbol is too far away from the instruction's location. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md index 3bd2a43b6ec..45c6d870014 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md @@ -8,6 +8,6 @@ ms.assetid: ba0cddfc-9c56-4a09-8207-f7b840a24b4d --- # Linker Tools Warning LNK4220 -invalid 'linker option' value 'value'; assumed default +> invalid 'linker option' value 'value'; assumed default An out-of-range value was specified with the [/TLBID](../../build/reference/tlbid-specify-resource-id-for-typelib.md) option. The default value for **/TLBID** is 1. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md index e55acea5515..281e31106a5 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md @@ -8,7 +8,7 @@ ms.assetid: b7bb1794-41fb-4c83-b9b0-59c0d786a7da --- # Linker Tools Warning LNK4222 -exported symbol 'symbol' should not be assigned an ordinal +> exported symbol 'symbol' should not be assigned an ordinal The following symbols should not be exported by ordinal: diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md index 1000e70de37..b81cfead1d4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md @@ -8,6 +8,6 @@ ms.assetid: 00e70d09-efd8-4e4e-8d48-6ba282c32ec1 --- # Linker Tools Warning LNK4229 -invalid directive /directive found; ignored +> invalid directive /directive found; ignored A directive passed via the [comment](../../preprocessor/comment-c-cpp.md) pragma was not valid. The linker ignores `/directive`. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md index 412f1348d52..4f914ec0c62 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md @@ -8,7 +8,7 @@ ms.assetid: 87bfec39-5241-464f-9feb-517b49f352ea --- # Linker Tools Warning LNK4237 -/SUBSYSTEM:NATIVE specified when importing from 'dll'; Use /SUBSYSTEM:CONSOLE or /SUBSYSTEM:WINDOWS. +> /SUBSYSTEM:NATIVE specified when importing from 'dll'; Use /SUBSYSTEM:CONSOLE or /SUBSYSTEM:WINDOWS. [/SUBSYSTEM:NATIVE](../../build/reference/subsystem-specify-subsystem.md) was specified when building a windows (Win32) application that directly uses one or more of the following: diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md index f0f4ec5f2ce..ff11db96da9 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md @@ -8,7 +8,7 @@ ms.assetid: 085d7fdf-9eaf-4641-8473-6eaadd073c7b --- # Linker Tools Warning LNK4247 -entry point 'decorated_function_name' already has a thread attribute; 'attribute' ignored +> entry point 'decorated_function_name' already has a thread attribute; 'attribute' ignored An entry point, specified with [/ENTRY (Entry-Point Symbol)](../../build/reference/entry-entry-point-symbol.md), had a threading attribute, but [/CLRTHREADATTRIBUTE (Set CLR Thread Attribute)](../../build/reference/clrthreadattribute-set-clr-thread-attribute.md) was also specified, with a different threading model. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md index 17b02f0c4fd..9f4b5191b15 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md @@ -8,7 +8,7 @@ ms.assetid: e40523ff-e3cb-4ba6-ab79-23f0f339f6cf --- # Linker Tools Warning LNK4248 -unresolved typeref token (token) for 'type'; image may not run +> unresolved typeref token (token) for 'type'; image may not run A type doesn't have a definition in MSIL metadata. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md index 38406cb0aca..9168f8d3e69 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md @@ -8,7 +8,7 @@ ms.assetid: ec7433a9-aa9c-495a-a9f2-075e7bc3e7bc --- # Linker Tools Warning LNK4253 -section 'section1' not merged into 'section2'; already merged into 'section3' +> section 'section1' not merged into 'section2'; already merged into 'section3' The linker detected multiple, conflicting merge requests. The linker will ignore one of the requests. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md index cad2b204d0a..8bb5c356aa4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md @@ -8,7 +8,7 @@ ms.assetid: 6f41dfb3-ca21-40d3-bac7-b637e578efa4 --- # Linker Tools Warning LNK4254 -section 'section1' (offset) merged into 'section2' (offset) with different attributes +> section 'section1' (offset) merged into 'section2' (offset) with different attributes The contents of one section were merged into another, but the attributes of the two sections are different. Your program may give unexpected results. For example, data you wanted to be read only may now be in a writable section. From 754cc5ebbd0a4943f950f505b7790877f9b600b0 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 22 Sep 2025 23:04:41 +0800 Subject: [PATCH 1283/1799] Add "Remarks" and "Example" headings for warning references in range [LNK4106, LNK4307] --- .../tool-errors/linker-tools-warning-lnk4194.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4197.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4199.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4200.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4204.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4205.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4206.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4216.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4217.md | 6 ++++-- .../tool-errors/linker-tools-warning-lnk4219.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4220.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4221.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4222.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4227.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4229.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4237.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4247.md | 4 ++++ .../tool-errors/linker-tools-warning-lnk4248.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4253.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4254.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4286.md | 4 ++-- .../tool-errors/linker-tools-warning-lnk4306.md | 2 ++ .../tool-errors/linker-tools-warning-lnk4307.md | 2 ++ 23 files changed, 50 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md index 2639e0769ee..7cacdbadb5c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md @@ -10,4 +10,6 @@ ms.assetid: a45f437e-33b5-487e-b3cd-ff1560041e7e > /DELAYLOAD:dll name ignored +## Remarks + The linker cannot [delay load](../../build/reference/delayload-delay-load-import.md) the requested DLL. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md index 2bddca715ac..91ab7e20fd4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md @@ -10,6 +10,8 @@ ms.assetid: 8a976fd7-a74b-4c83-ab66-a9e7d7073c4a > export '*exportname*' specified multiple times; using first specification +## Remarks + An export is specified in multiple and different ways. The linker uses the first specification and ignores the rest. If you are rebuilding the C run-time library, you can ignore this message. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md index b81309940eb..fbf791879e5 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md @@ -10,4 +10,6 @@ ms.assetid: 724f1ca8-ee9a-4ca3-b5c6-c0284a5195e7 > /DELAYLOAD:dllname ignored; no imports found from dllname +## Remarks + The linker ignores `dllname` because it does not need any of the functions that `dllname` exports. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md index 05864bf7b98..293230e906c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md @@ -10,4 +10,6 @@ ms.assetid: 0d335e69-8766-455b-beb5-a3ba6247274e > corrupt line number information in object file; ignored +## Remarks + The line number information in the object file is corrupt. Rebuild. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md index 6ee94836b30..5dcc96f82b6 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md @@ -10,6 +10,8 @@ ms.assetid: 14adda20-0cbe-407b-90f6-9f81c93530e2 > 'filename' is missing debugging information for referencing module; linking object as if no debug info +## Remarks + The .pdb file has an erroneous signature. The linker will continue to link the object without debug information. You may want to recompile the object file using the [/Zi](../../build/reference/z7-zi-zi-debug-information-format.md) option. LNK4204 can occur if some of the objects in the library refer to a file that no longer exists. This could happen when rebuilding the solution, for example; an object file might be deleted and not rebuilt because of a compilation error. In this case, either compile with **/Z7**, or **/Fd**, to update the objects to refer to a single file per-library (that is not the default .pdb file name). For more information, see [/Fd (Program Database File Name)](../../build/reference/fd-program-database-file-name.md). Ensure that the .pdb is saved with the library every time it is updated in the source control system. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md index dba0f80639e..9e0d8450655 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md @@ -10,4 +10,6 @@ ms.assetid: d63b9d18-ef3c-4081-9d8d-93077dad13c2 > 'filename' is missing current debugging information for referencing module; linking object as if no debug info +## Remarks + The .pdb file has out-of-date information. The linker will continue to link object without debug information. You may want to recompile the object file using the [/Zi](../../build/reference/z7-zi-zi-debug-information-format.md) option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md index 6d954982e46..3a4e7dc3c9c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md @@ -10,6 +10,8 @@ ms.assetid: 6c108e33-00cf-4c5a-830d-d65d470930a7 > precompiled type information not found; '*filename*' not linked or overwritten; linking object as if no debug info +## Remarks + The *filename* object file, compiled by using [/Yc](../../build/reference/yc-create-precompiled-header-file.md), was either not specified in the LINK command or was overwritten. A common scenario for this warning is when the .obj that was compiled with /Yc is in a library, and where there are no symbol references to that .obj from your code. In that case, the linker will not use (or even see) the .obj file. In this situation, you should recompile your code and use [/Yl](../../build/reference/yl-inject-pch-reference-for-debug-library.md) for the objects compiled by using [/Yu](../../build/reference/yu-use-precompiled-header-file.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md index 1c62a118f25..8fe1b5873b4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md @@ -10,4 +10,6 @@ ms.assetid: 68512095-acbc-47aa-96bf-9eb0e73b24a3 > Exported entry point entry +## Remarks + An entry point was exported from a DLL. The entry point of a DLL does not need to be exported. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md index 94497411316..134c5b993f3 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md @@ -10,14 +10,16 @@ ms.assetid: 280dc03e-5933-4e8d-bb8c-891fbe788738 > symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' in function '*function*' -[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for a symbol even though the symbol is defined in an object file in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. - ## Remarks +[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for a symbol even though the symbol is defined in an object file in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. + *symbol* is the symbol name that's defined within the image. *function* is the function that's importing the symbol. This warning doesn't appear when you compile by using the [/clr](../../build/reference/clr-common-language-runtime-compilation.md) option. +## Example + LNK4217 can also occur if you attempt to link two modules together, when instead you should compile the second module with the import library of the first module. ```cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md index 40f03e4a4af..78d3c8b8711 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md @@ -10,6 +10,8 @@ ms.assetid: 363fedf4-b10c-4985-811a-55a9fba688d6 > fixup name fixup overflow. Target 'target symbol name' is out of range, inserting thunk +## Remarks + The linker inserted a thunk in a situation where the address or offset was unable to fit in the given instruction because the target symbol is too far away from the instruction's location. You may want to reorder the image (using the [/ORDER](../../build/reference/order-put-functions-in-order.md) option, for example) to avoid the extra level of indirection. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md index 45c6d870014..34c3b7e524c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md @@ -10,4 +10,6 @@ ms.assetid: ba0cddfc-9c56-4a09-8207-f7b840a24b4d > invalid 'linker option' value 'value'; assumed default +## Remarks + An out-of-range value was specified with the [/TLBID](../../build/reference/tlbid-specify-resource-id-for-typelib.md) option. The default value for **/TLBID** is 1. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md index 9fae0c56fd9..894d302cb07 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md @@ -10,6 +10,8 @@ ms.assetid: 8e2eb2de-9532-4b85-908a-8c9ff5c4cccb > This object file does not define any previously undefined public symbols, so it will not be used by any link operation that consumes this library +## Example + Consider the following two code snippets, `a.cpp`: ```cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md index 281e31106a5..c17b20efad3 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md @@ -10,6 +10,8 @@ ms.assetid: b7bb1794-41fb-4c83-b9b0-59c0d786a7da > exported symbol 'symbol' should not be assigned an ordinal +## Remarks + The following symbols should not be exported by ordinal: - `DllCanUnloadNow` diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md index 4437621ee75..90a6e07eff6 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md @@ -10,6 +10,8 @@ ms.assetid: 941a0414-9964-4e02-8487-f9daa42ef7f9 > metadata operation warning (*HRESULT*) : *warning_message* +## Remarks + The linker detected metadata differences when merging: - One or more referenced assemblies with the assembly currently being built. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md index b81cfead1d4..fc77eed7aeb 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md @@ -10,4 +10,6 @@ ms.assetid: 00e70d09-efd8-4e4e-8d48-6ba282c32ec1 > invalid directive /directive found; ignored +## Remarks + A directive passed via the [comment](../../preprocessor/comment-c-cpp.md) pragma was not valid. The linker ignores `/directive`. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md index 4f914ec0c62..b46559f5001 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md @@ -10,6 +10,8 @@ ms.assetid: 87bfec39-5241-464f-9feb-517b49f352ea > /SUBSYSTEM:NATIVE specified when importing from 'dll'; Use /SUBSYSTEM:CONSOLE or /SUBSYSTEM:WINDOWS. +## Remarks + [/SUBSYSTEM:NATIVE](../../build/reference/subsystem-specify-subsystem.md) was specified when building a windows (Win32) application that directly uses one or more of the following: - kernel32.dll diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md index ff11db96da9..dc36d49adee 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md @@ -10,6 +10,8 @@ ms.assetid: 085d7fdf-9eaf-4641-8473-6eaadd073c7b > entry point 'decorated_function_name' already has a thread attribute; 'attribute' ignored +## Remarks + An entry point, specified with [/ENTRY (Entry-Point Symbol)](../../build/reference/entry-entry-point-symbol.md), had a threading attribute, but [/CLRTHREADATTRIBUTE (Set CLR Thread Attribute)](../../build/reference/clrthreadattribute-set-clr-thread-attribute.md) was also specified, with a different threading model. The linker ignored the value specified with /CLRTHREADATTRIBUTE. @@ -26,6 +28,8 @@ To resolve this warning: - Change the attribute in source, such that, it agrees with the value passed to /CLRTHREADATTRIBUTE. +## Example + The following sample generates LNK4247 ```cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md index 9f4b5191b15..4f33ecd759a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md @@ -10,6 +10,8 @@ ms.assetid: e40523ff-e3cb-4ba6-ab79-23f0f339f6cf > unresolved typeref token (token) for 'type'; image may not run +## Remarks + A type doesn't have a definition in MSIL metadata. LNK4248 can occur when there is only a forward declaration for a type in an MSIL module (compiled with **/clr**), where the type is referenced in the MSIL module, and where the MSIL module is linked with a native module that has a definition for the type. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md index 9168f8d3e69..49e9afcdf66 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md @@ -10,6 +10,8 @@ ms.assetid: ec7433a9-aa9c-495a-a9f2-075e7bc3e7bc > section 'section1' not merged into 'section2'; already merged into 'section3' +## Remarks + The linker detected multiple, conflicting merge requests. The linker will ignore one of the requests. A **/MERGE** option or directive is encountered and the `from` section has already been merged into a different section due to a previous **/MERGE** option or directive (or due to an implicit merge from the linker). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md index 8bb5c356aa4..e8b7a01ceff 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md @@ -10,6 +10,8 @@ ms.assetid: 6f41dfb3-ca21-40d3-bac7-b637e578efa4 > section 'section1' (offset) merged into 'section2' (offset) with different attributes +## Remarks + The contents of one section were merged into another, but the attributes of the two sections are different. Your program may give unexpected results. For example, data you wanted to be read only may now be in a writable section. To resolve LNK4254, modify or remove the merge request. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md index 7ba15860964..708f7418026 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["LNK4286"] > symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' -[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for *symbol* even though the symbol is defined in object file *filename_1.obj* in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. - ## Remarks +[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for *symbol* even though the symbol is defined in object file *filename_1.obj* in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. + Warning LNK4286 is a more general version of [Linker Tools Warning LNK4217](linker-tools-warning-lnk4217.md). The linker generates Warning LNK4286 when it can tell which object file referenced the symbol, but not which function. To resolve LNK4286, remove the `__declspec(dllimport)` declaration modifier from the forward declaration of *symbol* referenced in *filename_2.obj*. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md index 585f5078112..fea9a5abab9 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK4306"] > The auxiliary delayload import address table is not properly aligned with the primary delayload import address table. This may have negative perf impact. +## Remarks + This warning indicates a problem has occurred within the linker. Please report the issue and how you ran into it in the [C++ Developer Community channel](https://developercommunity.visualstudio.com/cpp). Add the tag `ARM64EC` to your issue to help us find the issue. \ No newline at end of file diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md index 97bf46196a6..d6aa7c99683 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK4307"] > The auxiliary delayload import address table copy is not properly aligned with the auxiliary delayload import address table. This may have negative perf impact. +## Remarks + This warning indicates a problem has occurred within the linker. Please report the issue and how you ran into it in the [C++ Developer Community channel](https://developercommunity.visualstudio.com/cpp). Add the tag `ARM64EC` to your issue to help us find the issue. \ No newline at end of file From c15104990bf275c1e7b771d004bc13e8fa50827d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 22 Sep 2025 23:05:39 +0800 Subject: [PATCH 1284/1799] Replace term "sample" with "example" for warning references in range [LNK4106, LNK4307] --- .../tool-errors/linker-tools-warning-lnk4224.md | 2 +- .../tool-errors/linker-tools-warning-lnk4227.md | 4 ++-- .../tool-errors/linker-tools-warning-lnk4247.md | 2 +- .../tool-errors/linker-tools-warning-lnk4248.md | 6 +++--- .../tool-errors/linker-tools-warning-lnk4253.md | 2 +- .../tool-errors/linker-tools-warning-lnk4254.md | 2 +- 6 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md index 0c52b3130a7..7cafda88288 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md @@ -20,7 +20,7 @@ If possible, modify the source for the .obj and remove the pragma. If you do ign ## Example -The following sample generates LNK4224. +The following example generates LNK4224. ```cpp // LNK4224.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md index 90a6e07eff6..55595308a94 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md @@ -28,7 +28,7 @@ The metadata problems must be fixed to resolve the warning. LNK4227 is generated when a referenced assembly was signed differently than the assembly that references it. -The following sample generates LNK4227: +The following example generates LNK4227: ```cpp // LNK4227.cpp @@ -59,7 +59,7 @@ ref class MyClass LNK4227 can also be generated when version numbers in the wrong format are passed to assembly attributes. The '*' notation is specific to the `AssemblyVersionAttribute`. To resolve this warning, use only numbers in the version attributes other than `AssemblyVersionAttribute`. -The following sample generates LNK4227: +The following example generates LNK4227: ```cpp // LNK4227e.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md index dc36d49adee..72cde3c4ef7 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md @@ -30,7 +30,7 @@ To resolve this warning: ## Example -The following sample generates LNK4247 +The following example generates LNK4247 ```cpp // LNK4247.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md index 4f33ecd759a..7f425183e6b 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md @@ -28,7 +28,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Examples -The following sample generates LNK4248. Define struct A to resolve. +The following example generates LNK4248. Define struct A to resolve. ```cpp // LNK4248.cpp @@ -42,7 +42,7 @@ int main() { } ``` -The following sample has a forward definition of a type. +The following example has a forward definition of a type. ```cpp // LNK4248_2.cpp @@ -57,7 +57,7 @@ int main() { } ``` -The following sample generates LNK4248. +The following example generates LNK4248. ```cpp // LNK4248_3.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md index 49e9afcdf66..5a689902df5 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md @@ -28,7 +28,7 @@ For more information, see, ## Example -In the following sample, the linker is instructed to merge the `.rdata` section twice, but into different sections. The following sample generates LNK4253. +In the following example, the linker is instructed to merge the `.rdata` section twice, but into different sections. The following example generates LNK4253. ```cpp // LNK4253.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md index e8b7a01ceff..135662e1d8a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md @@ -26,7 +26,7 @@ For more information, see, ## Example -The following sample generates LNK4254. +The following example generates LNK4254. ```cpp // LNK4254.cpp From 0be27937518642bb9979bde1fe25a2d6b5dd4627 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 22 Sep 2025 23:10:40 +0800 Subject: [PATCH 1285/1799] Update metadata for warning references in range [LNK4106, LNK4307] --- .../tool-errors/linker-tools-warning-lnk4194.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4197.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4199.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4200.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4204.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4205.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4206.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4210.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4216.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4217.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4219.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4220.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4221.md | 3 +-- .../tool-errors/linker-tools-warning-lnk4222.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4224.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4227.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4229.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4237.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4247.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4248.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4253.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4254.md | 5 ++--- .../tool-errors/linker-tools-warning-lnk4286.md | 4 ++-- .../tool-errors/linker-tools-warning-lnk4306.md | 2 +- .../tool-errors/linker-tools-warning-lnk4307.md | 2 +- 25 files changed, 47 insertions(+), 69 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md index 7cacdbadb5c..c9c5896215b 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4194" title: "Linker Tools Warning LNK4194" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4194" +ms.date: 11/04/2016 f1_keywords: ["LNK4194"] helpviewer_keywords: ["LNK4194"] -ms.assetid: a45f437e-33b5-487e-b3cd-ff1560041e7e --- # Linker Tools Warning LNK4194 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md index 91ab7e20fd4..9bbeb584794 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4197" title: "Linker Tools Warning LNK4197" -ms.date: "09/05/2018" +description: "Learn more about: Linker Tools Warning LNK4197" +ms.date: 09/05/2018 f1_keywords: ["LNK4197"] helpviewer_keywords: ["LNK4197"] -ms.assetid: 8a976fd7-a74b-4c83-ab66-a9e7d7073c4a --- # Linker Tools Warning LNK4197 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md index fbf791879e5..e4656fa2516 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4199" title: "Linker Tools Warning LNK4199" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4199" +ms.date: 11/04/2016 f1_keywords: ["LNK4199"] helpviewer_keywords: ["LNK4199"] -ms.assetid: 724f1ca8-ee9a-4ca3-b5c6-c0284a5195e7 --- # Linker Tools Warning LNK4199 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md index 293230e906c..d9c40abaeb2 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4200" title: "Linker Tools Warning LNK4200" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4200" +ms.date: 11/04/2016 f1_keywords: ["LNK4200"] helpviewer_keywords: ["LNK4200"] -ms.assetid: 0d335e69-8766-455b-beb5-a3ba6247274e --- # Linker Tools Warning LNK4200 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md index 5dcc96f82b6..96f393a24fa 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4204" title: "Linker Tools Warning LNK4204" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4204" +ms.date: 11/04/2016 f1_keywords: ["LNK4204"] helpviewer_keywords: ["LNK4204"] -ms.assetid: 14adda20-0cbe-407b-90f6-9f81c93530e2 --- # Linker Tools Warning LNK4204 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md index 9e0d8450655..f693330b8d4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4205" title: "Linker Tools Warning LNK4205" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4205" +ms.date: 11/04/2016 f1_keywords: ["LNK4205"] helpviewer_keywords: ["LNK4205"] -ms.assetid: d63b9d18-ef3c-4081-9d8d-93077dad13c2 --- # Linker Tools Warning LNK4205 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md index 3a4e7dc3c9c..61b490f8294 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4206" title: "Linker Tools Warning LNK4206" -ms.date: "12/05/2017" +description: "Learn more about: Linker Tools Warning LNK4206" +ms.date: 12/05/2017 f1_keywords: ["LNK4206"] helpviewer_keywords: ["LNK4206"] -ms.assetid: 6c108e33-00cf-4c5a-830d-d65d470930a7 --- # Linker Tools Warning LNK4206 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4210.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4210.md index 437489e9ad0..56405b00d56 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4210.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4210.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4210" title: "Linker Tools Warning LNK4210" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4210" +ms.date: 11/04/2016 f1_keywords: ["LNK4210"] helpviewer_keywords: ["LNK4210"] -ms.assetid: db48cff8-a2be-4a77-8d03-552b42c228fa --- # Linker Tools Warning LNK4210 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md index 8fe1b5873b4..4b1dddb3f23 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4216" title: "Linker Tools Warning LNK4216" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4216" +ms.date: 11/04/2016 f1_keywords: ["LNK4216"] helpviewer_keywords: ["LNK4216"] -ms.assetid: 68512095-acbc-47aa-96bf-9eb0e73b24a3 --- # Linker Tools Warning LNK4216 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md index 134c5b993f3..b1dfa793fb4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4217" title: "Linker Tools Warning LNK4217" -ms.date: "07/23/2019" +description: "Learn more about: Linker Tools Warning LNK4217" +ms.date: 07/23/2019 f1_keywords: ["LNK4217"] helpviewer_keywords: ["LNK4217"] -ms.assetid: 280dc03e-5933-4e8d-bb8c-891fbe788738 --- # Linker Tools Warning LNK4217 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md index 78d3c8b8711..1088a47bd68 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4219" title: "Linker Tools Warning LNK4219" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4219" +ms.date: 11/04/2016 f1_keywords: ["LNK4219"] helpviewer_keywords: ["LNK4219"] -ms.assetid: 363fedf4-b10c-4985-811a-55a9fba688d6 --- # Linker Tools Warning LNK4219 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md index 34c3b7e524c..11b83b45f5e 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4220" title: "Linker Tools Warning LNK4220" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4220" +ms.date: 11/04/2016 f1_keywords: ["LNK4220"] helpviewer_keywords: ["LNK4220"] -ms.assetid: ba0cddfc-9c56-4a09-8207-f7b840a24b4d --- # Linker Tools Warning LNK4220 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md index 894d302cb07..e137bfa2f46 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4221" title: "Linker Tools Warning LNK4221" +description: "Learn more about: Linker Tools Warning LNK4221" ms.date: 06/29/2022 f1_keywords: ["LNK4221"] helpviewer_keywords: ["LNK4221"] -ms.assetid: 8e2eb2de-9532-4b85-908a-8c9ff5c4cccb --- # Linker Tools Warning LNK4221 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md index c17b20efad3..3f20f3c7ae0 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4222" title: "Linker Tools Warning LNK4222" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4222" +ms.date: 11/04/2016 f1_keywords: ["LNK4222"] helpviewer_keywords: ["LNK4222"] -ms.assetid: b7bb1794-41fb-4c83-b9b0-59c0d786a7da --- # Linker Tools Warning LNK4222 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md index 7cafda88288..a9794db869a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4224" title: "Linker Tools Warning LNK4224" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4224" +ms.date: 11/04/2016 f1_keywords: ["LNK4224"] helpviewer_keywords: ["LNK4224"] -ms.assetid: 8624b70e-0b93-43cf-b457-834d38632d0b --- # Linker Tools Warning LNK4224 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md index 55595308a94..6cab69aeb42 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4227" title: "Linker Tools Warning LNK4227" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4227" +ms.date: 11/04/2016 f1_keywords: ["LNK4227"] helpviewer_keywords: ["LNK4227"] -ms.assetid: 941a0414-9964-4e02-8487-f9daa42ef7f9 --- # Linker Tools Warning LNK4227 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md index fc77eed7aeb..7452fa173e5 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4229" title: "Linker Tools Warning LNK4229" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4229" +ms.date: 11/04/2016 f1_keywords: ["LNK4229"] helpviewer_keywords: ["LNK4229"] -ms.assetid: 00e70d09-efd8-4e4e-8d48-6ba282c32ec1 --- # Linker Tools Warning LNK4229 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md index b46559f5001..3cc9490ee77 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4237" title: "Linker Tools Warning LNK4237" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4237" +ms.date: 11/04/2016 f1_keywords: ["LNK4237"] helpviewer_keywords: ["LNK4237"] -ms.assetid: 87bfec39-5241-464f-9feb-517b49f352ea --- # Linker Tools Warning LNK4237 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md index 72cde3c4ef7..c72d8eb71d3 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4247" title: "Linker Tools Warning LNK4247" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4247" +ms.date: 11/04/2016 f1_keywords: ["LNK4247"] helpviewer_keywords: ["LNK4247"] -ms.assetid: 085d7fdf-9eaf-4641-8473-6eaadd073c7b --- # Linker Tools Warning LNK4247 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md index 7f425183e6b..6cf871ff31f 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4248" title: "Linker Tools Warning LNK4248" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4248" +ms.date: 11/04/2016 f1_keywords: ["LNK4248"] helpviewer_keywords: ["LNK4248"] -ms.assetid: e40523ff-e3cb-4ba6-ab79-23f0f339f6cf --- # Linker Tools Warning LNK4248 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md index 5a689902df5..5ccccd7822f 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4253" title: "Linker Tools Warning LNK4253" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4253" +ms.date: 11/04/2016 f1_keywords: ["LNK4253"] helpviewer_keywords: ["LNK4253"] -ms.assetid: ec7433a9-aa9c-495a-a9f2-075e7bc3e7bc --- # Linker Tools Warning LNK4253 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md index 135662e1d8a..a43282f7879 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4254" title: "Linker Tools Warning LNK4254" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4254" +ms.date: 11/04/2016 f1_keywords: ["LNK4254"] helpviewer_keywords: ["LNK4254"] -ms.assetid: 6f41dfb3-ca21-40d3-bac7-b637e578efa4 --- # Linker Tools Warning LNK4254 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md index 708f7418026..41cd2a2ed46 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Warning LNK4286" title: "Linker Tools Warning LNK4286" -ms.date: "04/15/2019" +description: "Learn more about: Linker Tools Warning LNK4286" +ms.date: 04/15/2019 f1_keywords: ["LNK4286"] helpviewer_keywords: ["LNK4286"] --- diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md index fea9a5abab9..399ff2c7d4c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Linker tools warning LNK4306" title: "Linker tools warning LNK4306" +description: "Learn more about: Linker tools warning LNK4306" ms.date: 01/30/2024 f1_keywords: ["LNK4306"] helpviewer_keywords: ["LNK4306"] diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md index d6aa7c99683..3c9e72ff11c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Linker Tools warning LNK4307" title: "Linker Tools warning LNK4307" +description: "Learn more about: Linker Tools warning LNK4307" ms.date: 01/30/2024 f1_keywords: ["LNK4307"] helpviewer_keywords: ["LNK4307"] From 053dac29f43d62d3a44725d708a738bbb0f6acf6 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Mon, 22 Sep 2025 20:20:02 +0300 Subject: [PATCH 1286/1799] Update docs/standard-library/vectorized-stl-algorithms.md Co-authored-by: David Justo --- docs/standard-library/vectorized-stl-algorithms.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 05ecd40526a..549e8119296 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -75,7 +75,7 @@ In addition to algorithms, the macro controls the manual vectorization of: ## Manually vectorized algorithms for floating point types Vectorization of floating point types is connected with extra difficulties: - - For floating point results, the order of operations may matter. Some reordering may yield a different result, whether more precise, or less precise. Vectorization may need operations reordering, so it may affect that. + - Vectorization may reorder operations, which can affect the precision of floating point results. - Floating point types may contain NaN values, which don't behave transitively while comparing. - Floating point operations may raise exceptions. From 8f4b39fd0f00554174452af43f67e469d76127c1 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Mon, 22 Sep 2025 20:23:29 +0300 Subject: [PATCH 1287/1799] Review feedback Co-authored-by: David Justo --- docs/standard-library/vectorized-stl-algorithms.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 549e8119296..3425add3bcc 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -74,14 +74,14 @@ In addition to algorithms, the macro controls the manual vectorization of: ## Manually vectorized algorithms for floating point types -Vectorization of floating point types is connected with extra difficulties: +Vectorization of floating point types comes with extra difficulties: - Vectorization may reorder operations, which can affect the precision of floating point results. - - Floating point types may contain NaN values, which don't behave transitively while comparing. + - Floating point types may contain `NaN` values, which don't behave transitively on comparisons. - Floating point operations may raise exceptions. The STL deals with the first two difficulties safely. Only `max_element`, `min_element`, `minmax_element`, `max`, `min`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: - Do not compute new floating point values, only compare the existing values, so different order does not affect precision. - - As sorting algorithms, require transitivity of comparisons, so NaNs are not allowed as elements. + - Because they are sorting algorithms, `NaNs` are not allowed amongst the operands. There's `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating point types. Set it to 0 to disable the vectorization. The macro has no effect if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. From 06faaec1ac920c8f4a133aa18a954e39cf1f25a4 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 24 Sep 2025 16:29:37 +0800 Subject: [PATCH 1288/1799] Move leading underscore into the link text --- docs/c-runtime-library/reference/expand-dbg.md | 2 +- docs/c-runtime-library/reference/msize-dbg.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/reference/expand-dbg.md b/docs/c-runtime-library/reference/expand-dbg.md index 5998a4195c7..e389be30708 100644 --- a/docs/c-runtime-library/reference/expand-dbg.md +++ b/docs/c-runtime-library/reference/expand-dbg.md @@ -51,7 +51,7 @@ On successful completion, **`_expand_dbg`** returns a pointer to the resized mem ## Remarks -The **`_expand_dbg`** function is a debug version of the _[`expand`](expand.md) function. When [`_DEBUG`](../debug.md) isn't defined, each call to **`_expand_dbg`** is reduced to a call to `_expand`. Both `_expand` and **`_expand_dbg`** resize a memory block in the base heap, but **`_expand_dbg`** accommodates several debugging features: buffers on either side of the user portion of the block to test for leaks, a block type parameter to track specific allocation types, and *`filename`*/*`lineNumber`* information to determine the origin of allocation requests. +The **`_expand_dbg`** function is a debug version of the [`_expand`](expand.md) function. When [`_DEBUG`](../debug.md) isn't defined, each call to **`_expand_dbg`** is reduced to a call to `_expand`. Both `_expand` and **`_expand_dbg`** resize a memory block in the base heap, but **`_expand_dbg`** accommodates several debugging features: buffers on either side of the user portion of the block to test for leaks, a block type parameter to track specific allocation types, and *`filename`*/*`lineNumber`* information to determine the origin of allocation requests. **`_expand_dbg`** resizes the specified memory block with slightly more space than the requested *`newSize`*. *`newSize`* might be greater or less than the size of the originally allocated memory block. The extra space is used by the debug heap manager to link the debug memory blocks and to provide the application with debug header information and overwrite buffers. The resize is accomplished by either expanding or contracting the original memory block. **`_expand_dbg`** doesn't move the memory block, as does the [`_realloc_dbg`](realloc-dbg.md) function. diff --git a/docs/c-runtime-library/reference/msize-dbg.md b/docs/c-runtime-library/reference/msize-dbg.md index 01ea05ea499..cbb39bcb58e 100644 --- a/docs/c-runtime-library/reference/msize-dbg.md +++ b/docs/c-runtime-library/reference/msize-dbg.md @@ -36,7 +36,7 @@ On successful completion, **`_msize_dbg`** returns the size (in bytes) of the sp ## Remarks -**`_msize_dbg`** is a debug version of the _[`msize`](msize.md) function. When [`_DEBUG`](../debug.md) isn't defined, each call to **`_msize_dbg`** is reduced to a call to `_msize`. Both `_msize` and **`_msize_dbg`** calculate the size of a memory block in the base heap, but **`_msize_dbg`** adds two debugging features: It includes the buffers on either side of the user portion of the memory block in the returned size and it allows size calculations for specific block types. +**`_msize_dbg`** is a debug version of the [`_msize`](msize.md) function. When [`_DEBUG`](../debug.md) isn't defined, each call to **`_msize_dbg`** is reduced to a call to `_msize`. Both `_msize` and **`_msize_dbg`** calculate the size of a memory block in the base heap, but **`_msize_dbg`** adds two debugging features: It includes the buffers on either side of the user portion of the memory block in the returned size and it allows size calculations for specific block types. For information about how memory blocks are allocated, initialized, and managed in the debug version of the base heap, see [CRT debug heap details](../crt-debug-heap-details.md). For information about the allocation block types and how they're used, see [Types of blocks on the debug heap](../crt-debug-heap-details.md#types-of-blocks-on-the-debug-heap). For information about the differences between standard heap functions and the debug versions, see [Debug versions of heap allocation functions](../debug-versions-of-heap-allocation-functions.md). From 9a7c645d0ea7b143ea0c8a8a3c3b10c473490e71 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 24 Sep 2025 16:31:29 +0800 Subject: [PATCH 1289/1799] Update metadata in 2 C runtime topics --- docs/c-runtime-library/reference/expand-dbg.md | 5 ++--- docs/c-runtime-library/reference/msize-dbg.md | 4 ++-- 2 files changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/c-runtime-library/reference/expand-dbg.md b/docs/c-runtime-library/reference/expand-dbg.md index e389be30708..04f87e4d632 100644 --- a/docs/c-runtime-library/reference/expand-dbg.md +++ b/docs/c-runtime-library/reference/expand-dbg.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _expand_dbg" title: "_expand_dbg" -ms.date: "11/04/2016" +description: "Learn more about: _expand_dbg" +ms.date: 11/04/2016 api_name: ["_expand_dbg"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["expand_dbg", "_expand_dbg"] helpviewer_keywords: ["memory blocks, changing size", "expand_dbg function", "_expand_dbg function"] -ms.assetid: dc58c91f-72a8-48c6-b643-fe130fb6c1fd --- # `_expand_dbg` diff --git a/docs/c-runtime-library/reference/msize-dbg.md b/docs/c-runtime-library/reference/msize-dbg.md index cbb39bcb58e..14b02c921cb 100644 --- a/docs/c-runtime-library/reference/msize-dbg.md +++ b/docs/c-runtime-library/reference/msize-dbg.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _msize_dbg" title: "_msize_dbg" -ms.date: "11/04/2016" +description: "Learn more about: _msize_dbg" +ms.date: 11/04/2016 api_name: ["_msize_dbg"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] From 69cbdd1305dd9671bd69c32913ad0bf9436c716d Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 24 Sep 2025 16:54:03 +0800 Subject: [PATCH 1290/1799] Add missing space around links --- docs/c-runtime-library/reference/alloca.md | 2 +- docs/data/oledb/cdatasource-class.md | 2 +- docs/dotnet/multimap-stl-clr.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c2813.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/c-runtime-library/reference/alloca.md b/docs/c-runtime-library/reference/alloca.md index 693bcebda9f..dc7f6cd543d 100644 --- a/docs/c-runtime-library/reference/alloca.md +++ b/docs/c-runtime-library/reference/alloca.md @@ -49,7 +49,7 @@ However, **`_alloca`** can be called directly from within an EH routine or from > [!IMPORTANT] > If **`_alloca`** is called inside a try block, you must call [`_resetstkoflw`](resetstkoflw.md) in the catch block. -In addition to the above restrictions, when using the[`/clr` (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) option, **`_alloca`** can't be used in **`__except`** blocks. For more information, see [`/clr` Restrictions](../../build/reference/clr-restrictions.md). +In addition to the above restrictions, when using the [`/clr` (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) option, **`_alloca`** can't be used in **`__except`** blocks. For more information, see [`/clr` Restrictions](../../build/reference/clr-restrictions.md). ## Requirements diff --git a/docs/data/oledb/cdatasource-class.md b/docs/data/oledb/cdatasource-class.md index befd0149817..a79a4fccc33 100644 --- a/docs/data/oledb/cdatasource-class.md +++ b/docs/data/oledb/cdatasource-class.md @@ -201,7 +201,7 @@ HRESULT Open(LPCSTR szProgID, [in] The user's password. *nInitMode*
-[in] Database initialization mode. See [Initialization Properties](/previous-versions/windows/desktop/ms723127(v=vs.85))in the *OLE DB Programmer's Reference* in the Windows SDK for a list of valid initialization modes. If *nInitMode* is zero, no initialization mode is included in the property set used to open the connection. +[in] Database initialization mode. See [Initialization Properties](/previous-versions/windows/desktop/ms723127(v=vs.85)) in the *OLE DB Programmer's Reference* in the Windows SDK for a list of valid initialization modes. If *nInitMode* is zero, no initialization mode is included in the property set used to open the connection. *szProgID*
[in] A program identifier. diff --git a/docs/dotnet/multimap-stl-clr.md b/docs/dotnet/multimap-stl-clr.md index 5579077cd35..d3fcda8bd0b 100644 --- a/docs/dotnet/multimap-stl-clr.md +++ b/docs/dotnet/multimap-stl-clr.md @@ -770,7 +770,7 @@ Key value to search for. ### Remarks -If at least one element in the controlled sequence has equivalent ordering with *`key`*, the member function returns an iterator designating one of those elements; otherwise it returns[`end()`](#end). You use it to locate an element currently in the controlled sequence that matches a specified key. +If at least one element in the controlled sequence has equivalent ordering with *`key`*, the member function returns an iterator designating one of those elements; otherwise it returns [`end()`](#end). You use it to locate an element currently in the controlled sequence that matches a specified key. ### Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md index ac5acab6159..d2c6623c52b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C2813"] ## Remarks -C2813 is emitted if in a compiler command you specify the **/MP** compiler option and two or more files to compile, and one or more of the files contains the[#import](../../preprocessor/hash-import-directive-cpp.md) preprocessor directive. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive generates C++ classes from the types in the specified type library, and then writes those classes to two header files. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive is not supported because if multiple compilation units import the same type library, those units conflict when they try to write the same header files at the same time. +C2813 is emitted if in a compiler command you specify the **/MP** compiler option and two or more files to compile, and one or more of the files contains the [#import](../../preprocessor/hash-import-directive-cpp.md) preprocessor directive. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive generates C++ classes from the types in the specified type library, and then writes those classes to two header files. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive is not supported because if multiple compilation units import the same type library, those units conflict when they try to write the same header files at the same time. This compiler error and the **/MP** compiler option are new in Visual Studio 2008. From db45945588d1b5108b56c704787b1d4902e031c5 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 24 Sep 2025 16:55:41 +0800 Subject: [PATCH 1291/1799] Update metadata in 3 topics --- docs/c-runtime-library/reference/alloca.md | 2 +- docs/data/oledb/cdatasource-class.md | 5 ++--- docs/dotnet/multimap-stl-clr.md | 5 ++--- 3 files changed, 5 insertions(+), 7 deletions(-) diff --git a/docs/c-runtime-library/reference/alloca.md b/docs/c-runtime-library/reference/alloca.md index dc7f6cd543d..7c78844e4d9 100644 --- a/docs/c-runtime-library/reference/alloca.md +++ b/docs/c-runtime-library/reference/alloca.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _alloca" title: "_alloca" +description: "Learn more about: _alloca" ms.date: 01/05/2022 api_name: ["_alloca"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] diff --git a/docs/data/oledb/cdatasource-class.md b/docs/data/oledb/cdatasource-class.md index a79a4fccc33..d85b974a3cb 100644 --- a/docs/data/oledb/cdatasource-class.md +++ b/docs/data/oledb/cdatasource-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CDataSource Class" title: "CDataSource Class" -ms.date: "11/04/2016" +description: "Learn more about: CDataSource Class" +ms.date: 11/04/2016 f1_keywords: ["ATL.CDataSource", "ATL::CDataSource", "CDataSource", "ATL::CDataSource::Close", "ATL.CDataSource.Close", "CDataSource::Close", "CDataSource.Close", "ATL::CDataSource::GetInitializationString", "CDataSource.GetInitializationString", "GetInitializationString", "CDataSource::GetInitializationString", "ATL.CDataSource.GetInitializationString", "CDataSource::GetProperties", "ATL.CDataSource.GetProperties", "CDataSource.GetProperties", "ATL::CDataSource::GetProperties", "ATL::CDataSource::GetProperty", "ATL.CDataSource.GetProperty", "CDataSource.GetProperty", "CDataSource::GetProperty", "ATL::CDataSource::Open", "ATL.CDataSource.Open", "CDataSource::Open", "CDataSource.Open", "CDataSource::OpenFromFileName", "ATL::CDataSource::OpenFromFileName", "OpenFromFileName", "CDataSource.OpenFromFileName", "ATL.CDataSource.OpenFromFileName", "CDataSource.OpenFromInitializationString", "OpenFromInitializationString", "CDataSource::OpenFromInitializationString", "ATL::CDataSource::OpenFromInitializationString", "ATL.CDataSource.OpenFromInitializationString", "CDataSource.OpenWithPromptFileName", "OpenWithPromptFileName", "ATL::CDataSource::OpenWithPromptFileName", "ATL.CDataSource.OpenWithPromptFileName", "CDataSource::OpenWithPromptFileName", "CDataSource::OpenWithServiceComponents", "OpenWithServiceComponents", "CDataSource.OpenWithServiceComponents"] helpviewer_keywords: ["CDataSource class", "Close method", "GetInitializationString method", "GetProperties method", "GetProperty method", "Open method", "OpenFromFileName method", "OpenFromInitializationString method", "OpenWithPromptFileName method", "OpenWithServiceComponents method"] -ms.assetid: 99bf862c-9d5c-4117-9501-aa0e2672085c --- # CDataSource Class diff --git a/docs/dotnet/multimap-stl-clr.md b/docs/dotnet/multimap-stl-clr.md index d3fcda8bd0b..16acca22db6 100644 --- a/docs/dotnet/multimap-stl-clr.md +++ b/docs/dotnet/multimap-stl-clr.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: multimap (STL/CLR)" title: "multimap (STL/CLR)" -ms.date: "11/04/2016" +description: "Learn more about: multimap (STL/CLR)" +ms.date: 11/04/2016 ms.topic: "reference" f1_keywords: ["cliext::multimap", "cliext::multimap::begin", "cliext::multimap::clear", "cliext::multimap::const_iterator", "cliext::multimap::const_reference", "cliext::multimap::const_reverse_iterator", "cliext::multimap::count", "cliext::multimap::difference_type", "cliext::multimap::empty", "cliext::multimap::end", "cliext::multimap::equal_range", "cliext::multimap::erase", "cliext::multimap::find", "cliext::multimap::generic_container", "cliext::multimap::generic_iterator", "cliext::multimap::generic_reverse_iterator", "cliext::multimap::generic_value", "cliext::multimap::insert", "cliext::multimap::iterator", "cliext::multimap::key_comp", "cliext::multimap::key_compare", "cliext::multimap::key_type", "cliext::multimap::lower_bound", "cliext::multimap::make_value", "cliext::multimap::mapped_type", "cliext::multimap::multimap", "cliext::multimap::operator=", "cliext::multimap::rbegin", "cliext::multimap::reference", "cliext::multimap::rend", "cliext::multimap::reverse_iterator", "cliext::multimap::size", "cliext::multimap::size_type", "cliext::multimap::swap", "cliext::multimap::to_array", "cliext::multimap::upper_bound", "cliext::multimap::value_comp", "cliext::multimap::value_compare", "cliext::multimap::value_type", "cliext::mutlimap::operator!=", "cliext::mutlimap::operator<", "cliext::mutlimap::operator<=", "cliext::mutlimap::operator==", "cliext::mutlimap::operator>", "cliext::mutlimap::operator>="] helpviewer_keywords: [" header [STL/CLR]", " header [STL/CLR]", "multimap class [STL/CLR]", "begin member [STL/CLR]", "clear member [STL/CLR]", "const_iterator member [STL/CLR]", "const_reference member [STL/CLR]", "const_reverse_iterator member [STL/CLR]", "count member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "end member [STL/CLR]", "equal_range member [STL/CLR]", "erase member [STL/CLR]", "find member [STL/CLR]", "generic_container member [STL/CLR]", "generic_iterator member [STL/CLR]", "generic_reverse_iterator member [STL/CLR]", "generic_value member [STL/CLR]", "insert member [STL/CLR]", "iterator member [STL/CLR]", "key_comp member [STL/CLR]", "key_compare member [STL/CLR]", "key_type member [STL/CLR]", "lower_bound member [STL/CLR]", "make_value member [STL/CLR]", "mapped_type member [STL/CLR]", "multimap member [STL/CLR]", "operator= member [STL/CLR]", "rbegin member [STL/CLR]", "reference member [STL/CLR]", "rend member [STL/CLR]", "reverse_iterator member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "swap member [STL/CLR]", "to_array member [STL/CLR]", "upper_bound member [STL/CLR]", "value_comp member [STL/CLR]", "value_compare member [STL/CLR]", "value_type member [STL/CLR]", "operator!= member [STL/CLR]", "operator< member [STL/CLR]", "operator<= member [STL/CLR]", "operator== member [STL/CLR]", "operator> member [STL/CLR]", "operator>= member [STL/CLR]"] -ms.assetid: 3dfe329d-a078-462a-b050-7999ce6110ad --- # `multimap` (STL/CLR) From 6d98a0e94135c1d34a7f6b5ba5eb1a209035a229 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Wed, 24 Sep 2025 20:36:51 +0300 Subject: [PATCH 1292/1799] STL review feedback Co-authored-by: StephanTLavavej --- docs/standard-library/vectorized-stl-algorithms.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 3425add3bcc..9a02386a275 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_AL Under certain conditions, STL algorithms execute not element-wise, but multiple element at once on a single CPU core. This is possible due to SIMD (single instruction, multiple data). The use of such approach instead of element-wise approach is called vectorization. An implementation that is not vectorized is called scalar. The conditions for vectorization are: - - The container or range is contiguous. `array`, `vector`, and `basic_string` are contiguous containers, `span` and `basic_string_view` provide contiguous ranges. + - The container or range is contiguous. `array`, `vector`, and `basic_string` are contiguous containers, `span` and `basic_string_view` provide contiguous ranges. Built-in array elements also form contiguous range. In contrast, `list` and `map` are not contiguous containers. - There are such SIMD instructions available for the target platform that implement the particular algorithm on particular element types efficiently. Often this is true for plain types (like built-in integers) and simple operations. - Either of the following: - The compiler is capable of emitting vectorized machine code for an implementation written as scalar code (auto-vectorization) @@ -18,15 +18,15 @@ The conditions for vectorization are: ## Auto-vectorization in STL -See [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer). It applies to the STL implementation code the same way as to user code. +See [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion of [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch there. It applies to the STL implementation code the same way as to user code. Algorithms like `transform`, `reduce`, `accumulate` heavily benefit from auto-vectorization. ## Manual vectorization in STL -For x64 and x86 targets, certain algorithms have manual vectorization implemented. This implementation is pre-compiled, and uses runtime CPU dispatch, so it is engaged on suitable CPUs only. +For x64 and x86 targets, certain algorithms have manual vectorization implemented. This implementation is separately compiled, and uses runtime CPU dispatch, so it is engaged on suitable CPUs only. -The manually vectorized algorithms use template meta-programming to detect the suitable element types, so they only vectorized for simple types, like standard integer types. +The manually vectorized algorithms use template meta-programming to detect the suitable element types, so they are only vectorized for simple types, like standard integer types. Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. In case of any problem, you can disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS` macro set to 0. It defaults to 1 on x64 and x86, which means that manually vectorized algorithms are enabled by default. From 59f997725c8db06fee2bfeaf7d0b0c5efd31afb4 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Wed, 24 Sep 2025 21:01:49 +0300 Subject: [PATCH 1293/1799] Spelling --- docs/standard-library/vectorized-stl-algorithms.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 9a02386a275..ad709792fb1 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -7,10 +7,10 @@ helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_AL --- # Vectorized STL Algorithms -Under certain conditions, STL algorithms execute not element-wise, but multiple element at once on a single CPU core. This is possible due to SIMD (single instruction, multiple data). The use of such approach instead of element-wise approach is called vectorization. An implementation that is not vectorized is called scalar. +Under certain conditions, STL algorithms execute not element-wise, but multiple elements at once on a single CPU core. This is possible due to SIMD (single instruction, multiple data). The use of such an approach instead of element-wise approach is called vectorization. An implementation that is not vectorized is called scalar. The conditions for vectorization are: - - The container or range is contiguous. `array`, `vector`, and `basic_string` are contiguous containers, `span` and `basic_string_view` provide contiguous ranges. Built-in array elements also form contiguous range. In contrast, `list` and `map` are not contiguous containers. + - The container or range is contiguous. `array`, `vector`, and `basic_string` are contiguous containers, `span` and `basic_string_view` provide contiguous ranges. Built-in array elements also form contiguous ranges. In contrast, `list` and `map` are not contiguous containers. - There are such SIMD instructions available for the target platform that implement the particular algorithm on particular element types efficiently. Often this is true for plain types (like built-in integers) and simple operations. - Either of the following: - The compiler is capable of emitting vectorized machine code for an implementation written as scalar code (auto-vectorization) @@ -28,7 +28,7 @@ For x64 and x86 targets, certain algorithms have manual vectorization implemente The manually vectorized algorithms use template meta-programming to detect the suitable element types, so they are only vectorized for simple types, like standard integer types. -Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. In case of any problem, you can disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS` macro set to 0. It defaults to 1 on x64 and x86, which means that manually vectorized algorithms are enabled by default. +Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. In case of any problem, you can disable manual vectorization by defining the `_USE_STD_VECTOR_ALGORITHMS` macro set to 0. It defaults to 1 on x64 and x86, which means that manually vectorized algorithms are enabled by default. The following algorithms have manual vectorization controlled via `_USE_STD_VECTOR_ALGORITHMS` macro: - `contains` From ce5dca49a827caa3abbf4d7a85f096f9fa1e6f71 Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Thu, 25 Sep 2025 14:58:08 +0300 Subject: [PATCH 1294/1799] Global macro --- docs/standard-library/vectorized-stl-algorithms.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index ad709792fb1..65e7d3b6659 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -30,6 +30,8 @@ The manually vectorized algorithms use template meta-programming to detect the s Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. In case of any problem, you can disable manual vectorization by defining the `_USE_STD_VECTOR_ALGORITHMS` macro set to 0. It defaults to 1 on x64 and x86, which means that manually vectorized algorithms are enabled by default. +When overriding `_USE_STD_VECTOR_ALGORITHMS` make sure to set the same value for all linked translation units that use algorithms. Reliable way to achieve that is using project properties rather than defining it in the source. + The following algorithms have manual vectorization controlled via `_USE_STD_VECTOR_ALGORITHMS` macro: - `contains` - `contains_subrange` @@ -87,6 +89,8 @@ There's `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vector `_USE_STD_VECTOR_FLOATING_ALGORITHMS` defaults to 0 when [`/fp:except`](../build/reference/fp-specify-floating-point-behavior.md#except) option is set. This is to avoid problems with exceptions. +When overriding `_USE_STD_VECTOR_FLOATING_ALGORITHMS` make sure to set the same value for all linked translation units that use algorithms. Reliable way to achieve that is using project properties rather than defining it in the source. + ## See also [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) From b281ff0a6556d413c6c76ce698b304db5e89ed39 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 25 Sep 2025 22:40:23 +0800 Subject: [PATCH 1295/1799] Adjust spacing around commas --- docs/build/arm64-exception-handling.md | 2 +- docs/build/reference/guard-enable-control-flow-guard.md | 2 +- docs/build/reference/module-exportheader.md | 2 +- docs/build/reference/property-page-xml-files.md | 2 +- docs/build/reference/translateinclude.md | 2 +- docs/c-language/generic-selection.md | 2 +- docs/c-runtime-library/cgets-cgetws.md | 2 +- docs/c-runtime-library/gets-getws.md | 2 +- docs/c-runtime-library/global-state.md | 2 +- docs/c-runtime-library/parameter-validation.md | 2 +- .../reference/assert-asserte-assert-expr-macros.md | 2 +- docs/c-runtime-library/reference/ctan-ctanf-ctanl.md | 2 +- docs/c-runtime-library/reference/exit-exit-exit.md | 2 +- docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md | 2 +- docs/c-runtime-library/reference/nextafter-functions.md | 2 +- .../snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md | 2 +- .../reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md | 2 +- docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md | 2 +- ...s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md | 2 +- .../using-rule-sets-to-specify-the-cpp-rules-to-run.md | 2 +- docs/cpp/floating-limits.md | 2 +- docs/cpp/restrict-cpp-amp.md | 2 +- docs/cpp/templates-cpp.md | 2 +- docs/cppcx/attributes-c-cx.md | 2 +- docs/cppcx/platform-collections-unorderedmap-class.md | 2 +- docs/extensions/partial-cpp-component-extensions.md | 2 +- docs/extensions/typeid-cpp-component-extensions.md | 2 +- docs/get-started/tutorial-console-cpp.md | 2 +- docs/parallel/amp/cpp-amp-overview.md | 2 +- docs/porting/visual-cpp-change-history-2003-2015.md | 2 +- docs/porting/visual-cpp-what-s-new-2003-through-2015.md | 2 +- docs/preprocessor/pack.md | 2 +- docs/standard-library/ambiguous-local-time.md | 2 +- docs/standard-library/basic-string-class.md | 2 +- docs/standard-library/basic-string-view-class.md | 2 +- docs/standard-library/chrono-functions.md | 2 +- docs/standard-library/chrono-operators.md | 4 ++-- docs/standard-library/duration-class.md | 2 +- docs/standard-library/file-clock-class.md | 2 +- docs/standard-library/filter-view-class.md | 2 +- docs/standard-library/subrange-class.md | 2 +- docs/standard-library/time-point-class.md | 2 +- docs/standard-library/view-interface.md | 2 +- 43 files changed, 44 insertions(+), 44 deletions(-) diff --git a/docs/build/arm64-exception-handling.md b/docs/build/arm64-exception-handling.md index 9bad5d2883f..ed0f9cc58ae 100644 --- a/docs/build/arm64-exception-handling.md +++ b/docs/build/arm64-exception-handling.md @@ -287,7 +287,7 @@ The unwind codes are encoded according to the table below. All unwind codes are |--|--| | `alloc_s` | 000xxxxx: allocate small stack with size \< 512 (2^5 * 16). | | `save_r19r20_x` | 001zzzzz: save `` pair at `[sp-#Z*8]!`, pre-indexed offset >= -248 | -| `save_fplr` | 01zzzzzz: save `` pair at `[sp+#Z*8]`, offset \<= 504. | +| `save_fplr` | 01zzzzzz: save `` pair at `[sp+#Z*8]`, offset \<= 504. | | `save_fplr_x` | 10zzzzzz: save `` pair at `[sp-(#Z+1)*8]!`, pre-indexed offset >= -512 | | `alloc_m` | 11000xxx'xxxxxxxx: allocate large stack with size \< 32K (2^11 * 16). | | `save_regp` | 110010xx'xxzzzzzz: save `x(19+#X)` pair at `[sp+#Z*8]`, offset \<= 504 | diff --git a/docs/build/reference/guard-enable-control-flow-guard.md b/docs/build/reference/guard-enable-control-flow-guard.md index 61a24b9f5aa..1b51ece0e96 100644 --- a/docs/build/reference/guard-enable-control-flow-guard.md +++ b/docs/build/reference/guard-enable-control-flow-guard.md @@ -21,7 +21,7 @@ The **`/guard:cf`** option causes the compiler to analyze control flow for indir When the **`/guard:cf`** Control Flow Guard (CFG) option is specified, the compiler and linker insert extra runtime security checks to detect attempts to compromise your code. During compiling and linking, all indirect calls in your code are analyzed to find every location that the code can reach when it runs correctly. This information is stored in extra structures in the headers of your binaries. The compiler also injects a check before every indirect call in your code that ensures the target is one of the verified locations. If the check fails at runtime on a CFG-aware operating system, the operating system closes the program. -A common attack on software takes advantage of bugs in handling extreme or unexpected inputs. Carefully crafted input to the application may overwrite a location that contains a pointer to executable code. This technique can be used to redirect control flow to code controlled by the attacker. The CFG runtime checks don't fix the data corruption bugs in your executable. They instead make it more difficult for an attacker to use them to execute arbitrary code. CFG is a mitigation tool that prevents calls to locations other than function entry points in your code. It's similar to how Data Execution Prevention (DEP), [/GS](gs-buffer-security-check.md) stack checks, and [`/DYNAMICBASE`](dynamicbase-use-address-space-layout-randomization.md) and [/HIGHENTROPYVA](highentropyva-support-64-bit-aslr.md) address space layout randomization (ASLR) lower the chances that your code becomes an exploit vector. +A common attack on software takes advantage of bugs in handling extreme or unexpected inputs. Carefully crafted input to the application may overwrite a location that contains a pointer to executable code. This technique can be used to redirect control flow to code controlled by the attacker. The CFG runtime checks don't fix the data corruption bugs in your executable. They instead make it more difficult for an attacker to use them to execute arbitrary code. CFG is a mitigation tool that prevents calls to locations other than function entry points in your code. It's similar to how Data Execution Prevention (DEP), [/GS](gs-buffer-security-check.md) stack checks, and [`/DYNAMICBASE`](dynamicbase-use-address-space-layout-randomization.md) and [/HIGHENTROPYVA](highentropyva-support-64-bit-aslr.md) address space layout randomization (ASLR) lower the chances that your code becomes an exploit vector. To use the CFG exploit mitigation technique, pass **`/guard:cf`** to the compiler and **`/GUARD:CF`** to the linker. diff --git a/docs/build/reference/module-exportheader.md b/docs/build/reference/module-exportheader.md index 5c1b8a839c3..f4f558ca283 100644 --- a/docs/build/reference/module-exportheader.md +++ b/docs/build/reference/module-exportheader.md @@ -19,7 +19,7 @@ Tells the compiler to create the header units specified by the input arguments. ### Arguments -The argument to `/exportHeader` is a `/headerName` command-line option that specifies the name, *`header-name`*, of the header file to export. +The argument to `/exportHeader` is a `/headerName` command-line option that specifies the name, *`header-name`*, of the header file to export. ## Remarks diff --git a/docs/build/reference/property-page-xml-files.md b/docs/build/reference/property-page-xml-files.md index b7d32df9fbf..7ed46f8cc98 100644 --- a/docs/build/reference/property-page-xml-files.md +++ b/docs/build/reference/property-page-xml-files.md @@ -128,7 +128,7 @@ A **``** element is the root node in the XML file. It can have many attrib - `Label=""` indicates that when the properties are written as `ItemDefinition` metadata, the label of the parent ItemDefinitionGroup will be empty (every MSBuild element can have a Label). Visual Studio 2017 and later use labeled groups to navigate the .vcxproj project file. The groups that contain most `Rule` properties have an empty string as a label. - - `HasConfigurationCondition="true"` tells the project system to affix a configuration condition to the value so that it takes effect only for the current project configuration (the condition could be affixed to the parent group or the value itself). For example, open the property pages off the project node and set the value of the property **Treat Warnings As Error** under **Configuration Properties > C/C++ General** to "Yes". The following value is written to the project file. Notice the configuration condition attached to the parent ItemDefinitionGroup. + - `HasConfigurationCondition="true"` tells the project system to affix a configuration condition to the value so that it takes effect only for the current project configuration (the condition could be affixed to the parent group or the value itself). For example, open the property pages off the project node and set the value of the property **Treat Warnings As Error** under **Configuration Properties > C/C++ General** to "Yes". The following value is written to the project file. Notice the configuration condition attached to the parent ItemDefinitionGroup. ```xml diff --git a/docs/build/reference/translateinclude.md b/docs/build/reference/translateinclude.md index fa5cadac9e8..814d97b06fc 100644 --- a/docs/build/reference/translateinclude.md +++ b/docs/build/reference/translateinclude.md @@ -13,7 +13,7 @@ This switch instructs the compiler to treat `#include` as `import` for header fi When used with [`/scanDependencies`](scandependencies.md) or [`/sourceDependencies-directives`](sourcedependencies-directives.md), the compiler lists as imported header units in the generated dependency file those headers that are both included in the source and have a corresponding entry in a `header-units.json` file. This dependency info is used by the build system to generate compiled header unit `.ifc` files. Once the header units are built, they're treated by the compiler as an `import` instead of an `#include`. -The `header-units.json` file is only consulted when `/translateInclude` is specified. For more information about the format and purpose of the `header-units.json` file, see [`header-units.json`](header-unit-json-reference.md). +The `header-units.json` file is only consulted when `/translateInclude` is specified. For more information about the format and purpose of the `header-units.json` file, see [`header-units.json`](header-unit-json-reference.md). If an `#include` file isn't listed in the `header-units.json` file, it's treated as a normal `#include`. diff --git a/docs/c-language/generic-selection.md b/docs/c-language/generic-selection.md index 2e9872209a6..15a8a2cbf78 100644 --- a/docs/c-language/generic-selection.md +++ b/docs/c-language/generic-selection.md @@ -26,7 +26,7 @@ For example, the expression `_Generic(42, int: "integer", char: "character", def The first *`assignment-expression`* is called the controlling expression. The type of the controlling expression is determined at compile time and matched against the *`assoc-list`* to find which expression to evaluate and return. The controlling expression isn't evaluated. For example, `_Generic(intFunc(), int: "integer", default: "error");` doesn't result in a call at runtime to `intFunc`. -When the type of the controlling expression is determined, `const`, `volatile`, and `restrict` are removed before matching against *`assoc-list`*. +When the type of the controlling expression is determined, `const`, `volatile`, and `restrict` are removed before matching against *`assoc-list`*. Entries in the `assoc-list` that aren't chosen aren't evaluated. diff --git a/docs/c-runtime-library/cgets-cgetws.md b/docs/c-runtime-library/cgets-cgetws.md index 3869e4230ca..875efdfdd5d 100644 --- a/docs/c-runtime-library/cgets-cgetws.md +++ b/docs/c-runtime-library/cgets-cgetws.md @@ -15,7 +15,7 @@ ms.assetid: 4d5e134a-58c3-4f62-befd-5d235b0212f4 Gets a character string from the console. More secure versions of these functions are available; see [`_cgets_s`, `_cgetws_s`](./reference/cgets-s-cgetws-s.md). > [!IMPORTANT] -> These functions are obsolete. Beginning in Visual Studio 2015, they are not available in the CRT. The secure versions of these functions, _cgets_s and _cgetws_s, are still available. For information on these alternative functions, see [`_cgets_s`, `_cgetws_s`](./reference/cgets-s-cgetws-s.md). +> These functions are obsolete. Beginning in Visual Studio 2015, they are not available in the CRT. The secure versions of these functions, _cgets_s and _cgetws_s, are still available. For information on these alternative functions, see [`_cgets_s`, `_cgetws_s`](./reference/cgets-s-cgetws-s.md). > [!IMPORTANT] > This API cannot be used in applications that execute in the Windows Runtime. For more information, see [CRT functions not supported in Universal Windows Platform apps](../cppcx/crt-functions-not-supported-in-universal-windows-platform-apps.md). diff --git a/docs/c-runtime-library/gets-getws.md b/docs/c-runtime-library/gets-getws.md index f3da079669f..f3df496be63 100644 --- a/docs/c-runtime-library/gets-getws.md +++ b/docs/c-runtime-library/gets-getws.md @@ -14,7 +14,7 @@ helpviewer_keywords: ["getws function", "getts function", "_getws function", "li Gets a line from the **`stdin`** stream. More secure versions of these functions are available; see [`gets_s`, `_getws_s`](./reference/gets-s-getws-s.md). > [!IMPORTANT] -> These functions are obsolete. Beginning in Visual Studio 2015, they are not available in the CRT. The secure versions of these functions, `gets_s` and `_getws_s`, are still available. For information on these alternative functions, see [`gets_s`, `_getws_s`](./reference/gets-s-getws-s.md). +> These functions are obsolete. Beginning in Visual Studio 2015, they are not available in the CRT. The secure versions of these functions, `gets_s` and `_getws_s`, are still available. For information on these alternative functions, see [`gets_s`, `_getws_s`](./reference/gets-s-getws-s.md). > [!IMPORTANT] > This API cannot be used in applications that execute in the Windows Runtime. For more information, see [CRT functions not supported in Universal Windows Platform apps](../cppcx/crt-functions-not-supported-in-universal-windows-platform-apps.md). diff --git a/docs/c-runtime-library/global-state.md b/docs/c-runtime-library/global-state.md index 9a8a36b10de..a34a614e1a4 100644 --- a/docs/c-runtime-library/global-state.md +++ b/docs/c-runtime-library/global-state.md @@ -29,7 +29,7 @@ There are two ways to isolate your component's CRT state from an app's CRT state - Starting in Windows versions beginning with Windows 10 version 2004, dynamically link to the CRT but call the OS-mode exports (the functions that begin with _o_). To call the OS-mode exports, statically link as before, but ignore the static UCRT by using linker option `/NODEFAULTLIB:libucrt.lib` (release) or `/NODEFAULTLIB:libucrtd.lib` (debug). And add `ucrt.osmode.lib` to the linker input. See [`/NODEFAULTLIB` (Ignore Libraries)](../build/reference/nodefaultlib-ignore-libraries.md) for details. > [!NOTE] -> In source code, write `setlocale()`, not `_o_setlocale()`. When you link against `ucrt.osmode.lib`, the linker will automatically substitute the OS-specific version of the function. That is, `setlocale()` will be substituted with `_o_setlocale()`. +> In source code, write `setlocale()`, not `_o_setlocale()`. When you link against `ucrt.osmode.lib`, the linker will automatically substitute the OS-specific version of the function. That is, `setlocale()` will be substituted with `_o_setlocale()`. Linking against `ucrt.osmode.lib` disables some UCRT calls that are only available in app mode. Attempting to call these functions will result in a link error. diff --git a/docs/c-runtime-library/parameter-validation.md b/docs/c-runtime-library/parameter-validation.md index f63a50cc02c..46053fc1e57 100644 --- a/docs/c-runtime-library/parameter-validation.md +++ b/docs/c-runtime-library/parameter-validation.md @@ -8,7 +8,7 @@ ms.assetid: 019dd5f0-dc61-4d2e-b4e9-b66409ddf1f2 --- # Parameter validation -Most of the security-enhanced CRT functions, and many that aren't, validate their parameters for things like checking pointers for `NULL`, that integers fall into a valid range, or that enumeration values are valid. If an invalid parameter is found, the invalid parameter handler is called. +Most of the security-enhanced CRT functions, and many that aren't, validate their parameters for things like checking pointers for `NULL`, that integers fall into a valid range, or that enumeration values are valid. If an invalid parameter is found, the invalid parameter handler is called. ## Invalid parameter handler routine diff --git a/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md b/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md index d2d73958108..407364ac2a3 100644 --- a/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md +++ b/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md @@ -33,7 +33,7 @@ A wide string to display as part of the report. The `_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` macros provide an application with a clean and simple mechanism for checking assumptions during the debugging process. They're flexible because they don't need to be enclosed in `#ifdef` statements to prevent them from being called in a retail build of an application. This flexibility is achieved by using the [`_DEBUG`](../debug.md) macro. `_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` are only available when `_DEBUG` is defined at compile time. When `_DEBUG` isn't defined, calls to these macros are removed during preprocessing. -`_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` evaluate their *`booleanExpression`* argument and when the result is **`false`** (0), they print a diagnostic message and call [`_CrtDbgReportW`](crtdbgreport-crtdbgreportw.md) to generate a debug report. The `_ASSERT` macro prints a simple diagnostic message, `_ASSERTE` includes a string representation of the failed expression in the message, and `_ASSERT_EXPR` includes the *`message`* string in the diagnostic message. These macros do nothing when *`booleanExpression`* evaluates to nonzero. +`_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` evaluate their *`booleanExpression`* argument and when the result is **`false`** (0), they print a diagnostic message and call [`_CrtDbgReportW`](crtdbgreport-crtdbgreportw.md) to generate a debug report. The `_ASSERT` macro prints a simple diagnostic message, `_ASSERTE` includes a string representation of the failed expression in the message, and `_ASSERT_EXPR` includes the *`message`* string in the diagnostic message. These macros do nothing when *`booleanExpression`* evaluates to nonzero. `_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` invoke `_CrtDbgReportW`, which causes all output to be in wide characters. `_ASSERTE` properly prints Unicode characters in *`booleanExpression`* and `_ASSERT_EXPR` prints Unicode characters in *`message`*. diff --git a/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md b/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md index a88bd27f839..cbb5fa5b176 100644 --- a/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md +++ b/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md @@ -56,7 +56,7 @@ Because C++ allows overloading, you can call overloads of **`ctan`** that take a | Routine | C header | C++ header | |---|---|---| -| **`ctan`**, **`ctanf`**, **`ctanl`** | \ | \ | +| **`ctan`**, **`ctanf`**, **`ctanl`** | \ | \ | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/exit-exit-exit.md b/docs/c-runtime-library/reference/exit-exit-exit.md index bcec154714b..304f2ce76f0 100644 --- a/docs/c-runtime-library/reference/exit-exit-exit.md +++ b/docs/c-runtime-library/reference/exit-exit-exit.md @@ -52,7 +52,7 @@ The **`exit`**, **`_Exit`**, **`_exit`**, **`quick_exit`**, **`_cexit`**, and ** | **`_cexit`** | Performs complete C library termination procedures and returns to the caller. Doesn't terminate the process. | | **`_c_exit`** | Performs minimal C library termination procedures and returns to the caller. Doesn't terminate the process. | -When you call the **`exit`**, **`_Exit`** or **`_exit`** function, the destructors for any temporary or automatic objects that exist at the time of the call aren't called. An automatic object is a non-static local object defined in a function. A temporary object is an object that's created by the compiler, such as a value returned by a function call. To destroy an automatic object before you call **`exit`**, **`_Exit`**, or **`_exit`**, explicitly call the destructor for the object, as shown here: +When you call the **`exit`**, **`_Exit`** or **`_exit`** function, the destructors for any temporary or automatic objects that exist at the time of the call aren't called. An automatic object is a non-static local object defined in a function. A temporary object is an object that's created by the compiler, such as a value returned by a function call. To destroy an automatic object before you call **`exit`**, **`_Exit`**, or **`_exit`**, explicitly call the destructor for the object, as shown here: ```cpp void last_fn() {} diff --git a/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md b/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md index f30c701ea5f..9b812930430 100644 --- a/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md +++ b/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md @@ -62,7 +62,7 @@ On success, returns the value of the first of these conditions that applies, giv The **`mbrtoc16`** function reads up to *`max_bytes`* bytes from *`source`* to find the first complete, valid UTF-8 multibyte character, and then stores the equivalent UTF-16 character in *`destination`*. If the character requires more than one UTF-16 output character, such as a surrogate pair, then the *`state`* value is set to store the next UTF-16 character in *`destination`* on the next call to **`mbrtoc16`**. The **`mbrtoc32`** function is identical, but output is stored as a UTF-32 character. -If *`source`* is null, these functions return the equivalent of a call made using arguments of `NULL` for *`destination`*, `""` (an empty, null-terminated string) for *`source`*, and 1 for *`max_bytes`*. The passed values of *`destination`* and *`max_bytes`* are ignored. +If *`source`* is null, these functions return the equivalent of a call made using arguments of `NULL` for *`destination`*, `""` (an empty, null-terminated string) for *`source`*, and 1 for *`max_bytes`*. The passed values of *`destination`* and *`max_bytes`* are ignored. If *`source`* isn't null, the function starts at the beginning of the string and inspects up to *`max_bytes`* bytes to determine the number of bytes required to complete the next UTF-8 multibyte character, including any shift sequences. If the examined bytes contain a valid and complete UTF-8 multibyte character, the function converts the character into the equivalent 16-bit or 32-bit wide character or characters. If *`destination`* isn't null, the function stores the first (and possibly only) result character in destination. If extra output characters are required, a value is set in *`state`*, so that subsequent calls to the function output the extra characters and return the value -3. If no more output characters are required, then *`state`* is set to the initial shift state. diff --git a/docs/c-runtime-library/reference/nextafter-functions.md b/docs/c-runtime-library/reference/nextafter-functions.md index e2b6758121d..1e4d8da31d0 100644 --- a/docs/c-runtime-library/reference/nextafter-functions.md +++ b/docs/c-runtime-library/reference/nextafter-functions.md @@ -68,7 +68,7 @@ By default, this function's global state is scoped to the application. To change |---|---|---| | **`nextafter`**, **`nextafterf`**, **`nextafterl`**, **`_nextafterf`**, **`nexttoward`**, **`nexttowardf`**, **`nexttowardl`** | `` | `` or `` | | **`_nextafter`** | `` | `` or `` | -| **`nextafter`** macro, **`nexttoward`** macro | `` | | +| **`nextafter`** macro, **`nexttoward`** macro | `` | | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md b/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md index 6043ec459e8..a9ceb9d7a60 100644 --- a/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md +++ b/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md @@ -175,7 +175,7 @@ In C++, these functions have template overloads that invoke the newer, more secu | Routine | Required header | |---|---| -| **`snprintf`**, **`_snprintf`**, **`_snprintf_l`** | `` | +| **`snprintf`**, **`_snprintf`**, **`_snprintf_l`** | `` | | **`_snwprintf`**, **`_snwprintf_l`** | `` or `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md b/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md index 39b89feffc5..620cdd63710 100644 --- a/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md +++ b/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md @@ -88,7 +88,7 @@ A *`whitespace`* may consist of space and tab characters, which are ignored. *`d | Routine | Required header | |---|---| -| **`strtoumax`**, **`wcstoumax`**, **`_strtoumax_l`**, **`_wcstoumax_l`** | \ | +| **`strtoumax`**, **`wcstoumax`**, **`_strtoumax_l`**, **`_wcstoumax_l`** | \ | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md b/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md index 820761ba8b9..a8bb3f757de 100644 --- a/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md +++ b/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md @@ -78,7 +78,7 @@ By default, this function's global state is scoped to the application. To change | Function | C header | C++ header | |---|---|---| -| **`tgamma`**, **`tgammaf`**, **`tgammal`** | \ | \ | +| **`tgamma`**, **`tgammaf`**, **`tgammal`** | \ | \ | | **`tgamma`** macro | \ | | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md b/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md index 341e63eaa5e..0cdb13f915d 100644 --- a/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md @@ -6,7 +6,7 @@ api_name: ["_vsnwprintf_s", "_vsnwprintf_s_l", "_vsnprintf_s", "vsnprintf_s", "_ api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ntdll.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] topic_type: ["apiref"] -f1_keywords: ["STDIO/vsnprintf_s", "STDIO/_vsnprintf_s", "CORECRT_WSTDIO/_vsnwprintf_s", "TCHAR/_vsntprintf_s", "STDIO/_vsnprintf_s_l", "CORECRT_WSTDIO/_vsnwprintf_s_l", "TCHAR/_vsntprintf_s_l", "vsnprintf_s", "_vsnprintf_s", "_vsnwprintf_s", "_vsntprintf_s", "_vsnprintf_s_l", "_vsnwprintf_s_l", "_vsntprintf_s_l"] +f1_keywords: ["STDIO/vsnprintf_s", "STDIO/_vsnprintf_s", "CORECRT_WSTDIO/_vsnwprintf_s", "TCHAR/_vsntprintf_s", "STDIO/_vsnprintf_s_l", "CORECRT_WSTDIO/_vsnwprintf_s_l", "TCHAR/_vsntprintf_s_l", "vsnprintf_s", "_vsnprintf_s", "_vsnwprintf_s", "_vsntprintf_s", "_vsnprintf_s_l", "_vsnwprintf_s_l", "_vsntprintf_s_l"] helpviewer_keywords: ["vsnwprintf_s function", "_vsntprintf_s function", "_vsntprintf_s_l function", "vsntprintf_s function", "vsnwprintf_s_l function", "vsnprintf_s_l function", "vsntprintf_s_l function", "_vsnwprintf_s_l function", "_vsnprintf_s function", "vsnprintf_s function", "_vsnprintf_s_l function", "_vsnwprintf_s function", "formatted text [C++]"] --- # `vsnprintf_s`, `_vsnprintf_s`, `_vsnprintf_s_l`, `_vsnwprintf_s`, `_vsnwprintf_s_l` diff --git a/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md b/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md index 363cce16f68..e98971d9707 100644 --- a/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md +++ b/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md @@ -243,7 +243,7 @@ Schema element details: | `TIncludeAll` | Rule action for all rules | | `TRule` | Rule ID with rule action | | `TRules` | Collection of one or more rules | -| `TRuleSet` | Ruleset file format consisting of localization information, rule hint paths, include all information, include information, rules information, name, description, and tools version information | +| `TRuleSet` | Ruleset file format consisting of localization information, rule hint paths, include all information, include information, rules information, name, description, and tools version information | | `TRuleAction` | Enumeration describing a rule action such as an error, warning, info, hidden, or none | | `TIncludeAction` | Enumeration describing a rule action such as an error, warning, info, hidden, none, or default | | `TIncludeAllAction` | Enumeration describing a rule action such as an error, warning, info, or hidden | diff --git a/docs/cpp/floating-limits.md b/docs/cpp/floating-limits.md index 475ad5b18ba..10b244a46dc 100644 --- a/docs/cpp/floating-limits.md +++ b/docs/cpp/floating-limits.md @@ -15,7 +15,7 @@ The following table lists the limits on the values of floating-point constants. |Constant|Meaning|Value| |--------------|-------------|-----------| -|`FLT_DIG`
`DBL_DIG`
`LDBL_DIG`|Number of digits, q, such that a floating-point number with q decimal digits can be rounded into a floating-point representation and back without loss of precision.|6
15
15| +|`FLT_DIG`
`DBL_DIG`
`LDBL_DIG`|Number of digits, q, such that a floating-point number with q decimal digits can be rounded into a floating-point representation and back without loss of precision.|6
15
15| |`FLT_EPSILON`
`DBL_EPSILON`
`LDBL_EPSILON`|Smallest positive number x, such that x + 1.0 is not equal to 1.0.|1.192092896e-07F
2.2204460492503131e-016
2.2204460492503131e-016| |`FLT_GUARD`||0| |`FLT_MANT_DIG`
`DBL_MANT_DIG`
`LDBL_MANT_DIG`|Number of digits in the radix specified by `FLT_RADIX` in the floating-point significand. The radix is 2; hence these values specify bits.|24
53
53| diff --git a/docs/cpp/restrict-cpp-amp.md b/docs/cpp/restrict-cpp-amp.md index 5255fa72ffd..bd1b63c3b1f 100644 --- a/docs/cpp/restrict-cpp-amp.md +++ b/docs/cpp/restrict-cpp-amp.md @@ -19,7 +19,7 @@ The **`restrict`** clause takes the following forms: |------------|-----------------| |`restrict(cpu)`|The function can use the full C++ language. Only other functions that are declared by using restrict(cpu) functions can call the function.| |`restrict(amp)`|The function can only use the subset of the C++ language that C++ AMP can accelerate.| -|A sequence of `restrict(cpu)` and `restrict(amp)`.|The function must adhere to the limitations of both `restrict(cpu)` and `restrict(amp)`. The function can be called by functions that are declared by using `restrict(cpu)`, `restrict(amp)`, `restrict(cpu, amp)`, or `restrict(amp, cpu)`.

The form `restrict(A) restrict(B)` can be written as `restrict(A,B)`.| +|A sequence of `restrict(cpu)` and `restrict(amp)`.|The function must adhere to the limitations of both `restrict(cpu)` and `restrict(amp)`. The function can be called by functions that are declared by using `restrict(cpu)`, `restrict(amp)`, `restrict(cpu, amp)`, or `restrict(amp, cpu)`.

The form `restrict(A) restrict(B)` can be written as `restrict(A,B)`.| ## Remarks diff --git a/docs/cpp/templates-cpp.md b/docs/cpp/templates-cpp.md index 93e8ddb0948..aa7e68bec68 100644 --- a/docs/cpp/templates-cpp.md +++ b/docs/cpp/templates-cpp.md @@ -157,7 +157,7 @@ class MyClass2 }; ``` -Because the *Arr* parameter itself has no body, its parameter names are not needed. In fact, it is an error to refer to *Arr*'s typename or class parameter names from within the body of `MyClass2`. For this reason, *Arr*'s type parameter names can be omitted, as shown in this example: +Because the *Arr* parameter itself has no body, its parameter names are not needed. In fact, it is an error to refer to *Arr*'s typename or class parameter names from within the body of `MyClass2`. For this reason, *Arr*'s type parameter names can be omitted, as shown in this example: ```cpp template class Arr> diff --git a/docs/cppcx/attributes-c-cx.md b/docs/cppcx/attributes-c-cx.md index 38b2c2a6ec3..0fbe7a494e0 100644 --- a/docs/cppcx/attributes-c-cx.md +++ b/docs/cppcx/attributes-c-cx.md @@ -6,7 +6,7 @@ ms.assetid: 4438e03c-4de3-433d-abcc-31aa863bc0e0 --- # Attributes (C++/CX) -An attribute is a special kind of ref class that can be prepended in square brackets to Windows Runtime types and methods to specify certain behaviors in metadata creation. Several predefined attributes—for example, [Windows::Foundation::Metadata::WebHostHidden](/uwp/api/windows.foundation.metadata.webhosthiddenattribute)—are commonly used in C++/CX code. This example shows how the attribute is applied to a class: +An attribute is a special kind of ref class that can be prepended in square brackets to Windows Runtime types and methods to specify certain behaviors in metadata creation. Several predefined attributes—for example, [Windows::Foundation::Metadata::WebHostHidden](/uwp/api/windows.foundation.metadata.webhosthiddenattribute)—are commonly used in C++/CX code. This example shows how the attribute is applied to a class: [!code-cpp[cx_attributes#01](../cppcx/codesnippet/CPP/cx_attributes/class1.h#01)] diff --git a/docs/cppcx/platform-collections-unorderedmap-class.md b/docs/cppcx/platform-collections-unorderedmap-class.md index a2a55e71329..056468abaca 100644 --- a/docs/cppcx/platform-collections-unorderedmap-class.md +++ b/docs/cppcx/platform-collections-unorderedmap-class.md @@ -30,7 +30,7 @@ The type of the key in the key-value pair. The type of the value in the key-value pair. *C*
-A type that provides a function object that can compare two element values as sort keys to determine their relative order in the Map. By default, [std::equal_to\](../standard-library/equal-to-struct.md). +A type that provides a function object that can compare two element values as sort keys to determine their relative order in the Map. By default, [std::equal_to\](../standard-library/equal-to-struct.md). ### Remarks diff --git a/docs/extensions/partial-cpp-component-extensions.md b/docs/extensions/partial-cpp-component-extensions.md index 495d65b25cd..4a133fd0ded 100644 --- a/docs/extensions/partial-cpp-component-extensions.md +++ b/docs/extensions/partial-cpp-component-extensions.md @@ -44,7 +44,7 @@ The name of the defined type. A partial class supports scenarios where you modify one part of a class definition in one file, and automatic code-generating software—for example, the XAML designer—modifies code in the same class in another file. By using a partial class, you can prevent the automatic code generator from overwriting your code. In a Visual Studio project, the **partial** modifier is applied automatically to the generated file. -Contents: With two exceptions, a partial class definition can contain anything that the full class definition could contain if the **partial** keyword was omitted. However, you can't specify class accessibility (for example, `public partial class X { ... };`), or a **declspec**. +Contents: With two exceptions, a partial class definition can contain anything that the full class definition could contain if the **partial** keyword was omitted. However, you can't specify class accessibility (for example, `public partial class X { ... };`), or a **declspec**. Access specifiers used in a partial class definition for *identifier* do not affect the default accessibility in a subsequent partial or full class definition for *identifier*. Inline definitions of static data members are allowed. diff --git a/docs/extensions/typeid-cpp-component-extensions.md b/docs/extensions/typeid-cpp-component-extensions.md index 33c7d5fe5d0..fe3b1ffcb1e 100644 --- a/docs/extensions/typeid-cpp-component-extensions.md +++ b/docs/extensions/typeid-cpp-component-extensions.md @@ -40,7 +40,7 @@ A type name. ### Remarks -In C++/CX, typeid returns a [Platform::Type](../cppcx/platform-type-class.md) that is constructed from runtime type information. +In C++/CX, typeid returns a [Platform::Type](../cppcx/platform-type-class.md) that is constructed from runtime type information. ### Requirements diff --git a/docs/get-started/tutorial-console-cpp.md b/docs/get-started/tutorial-console-cpp.md index 5a251dca67d..db968eefaa5 100644 --- a/docs/get-started/tutorial-console-cpp.md +++ b/docs/get-started/tutorial-console-cpp.md @@ -27,7 +27,7 @@ Visual Studio uses *projects* to organize the code for an app, and *solutions* t The dialog has options to clone a repository, open a project or solution, open a local folder, and create a new project." :::image-end::: -1. In the **Create a new project** dialog, set the language dropdown to **C++**, set the platform dropdown to **Windows**, select **Console App** from the list of project types, then select **Next**. +1. In the **Create a new project** dialog, set the language dropdown to **C++**, set the platform dropdown to **Windows**, select **Console App** from the list of project types, then select **Next**. :::image type="complex" source="./media/calc-vs2022-choose-console-app.png" alt-text="Screenshot of the Visual Studio Create a new project dialog."::: The language dropdown is set to C++, the platform dropdown is set to Windows, and project types like Empty Project, Console App, CMake Project, Windows Desktop Wizard, and so on, appear in the list of project types." diff --git a/docs/parallel/amp/cpp-amp-overview.md b/docs/parallel/amp/cpp-amp-overview.md index 3fdac7ec564..452f22396fd 100644 --- a/docs/parallel/amp/cpp-amp-overview.md +++ b/docs/parallel/amp/cpp-amp-overview.md @@ -425,7 +425,7 @@ for (int i = 0; i <4; i++) { ## Math Libraries -C++ AMP includes two math libraries. The double-precision library in the [Concurrency::precise_math Namespace](../../parallel/amp/reference/concurrency-precise-math-namespace.md) provides support for double-precision functions. It also provides support for single-precision functions, although double-precision support on the hardware is still required. It conforms to the [C99 Specification (ISO/IEC 9899)](https://go.microsoft.com/fwlink/p/?linkid=225887). The accelerator must support full double precision. You can determine whether it does by checking the value of the [accelerator::supports_double_precision Data Member](reference/accelerator-class.md#supports_double_precision). The fast math library, in the [Concurrency::fast_math Namespace](../../parallel/amp/reference/concurrency-fast-math-namespace.md), contains another set of math functions. These functions, which support only **`float`** operands, execute more quickly but aren't as precise as those in the double-precision math library. The functions are contained in the \ header file and all are declared with `restrict(amp)`. The functions in the \ header file are imported into both the `fast_math` and `precise_math` namespaces. The **`restrict`** keyword is used to distinguish the \ version and the C++ AMP version. The following code calculates the base-10 logarithm, using the fast method, of each value that is in the compute domain. +C++ AMP includes two math libraries. The double-precision library in the [Concurrency::precise_math Namespace](../../parallel/amp/reference/concurrency-precise-math-namespace.md) provides support for double-precision functions. It also provides support for single-precision functions, although double-precision support on the hardware is still required. It conforms to the [C99 Specification (ISO/IEC 9899)](https://go.microsoft.com/fwlink/p/?linkid=225887). The accelerator must support full double precision. You can determine whether it does by checking the value of the [accelerator::supports_double_precision Data Member](reference/accelerator-class.md#supports_double_precision). The fast math library, in the [Concurrency::fast_math Namespace](../../parallel/amp/reference/concurrency-fast-math-namespace.md), contains another set of math functions. These functions, which support only **`float`** operands, execute more quickly but aren't as precise as those in the double-precision math library. The functions are contained in the \ header file and all are declared with `restrict(amp)`. The functions in the \ header file are imported into both the `fast_math` and `precise_math` namespaces. The **`restrict`** keyword is used to distinguish the \ version and the C++ AMP version. The following code calculates the base-10 logarithm, using the fast method, of each value that is in the compute domain. ```cpp #include diff --git a/docs/porting/visual-cpp-change-history-2003-2015.md b/docs/porting/visual-cpp-change-history-2003-2015.md index 456a327ecc7..83f15d02849 100644 --- a/docs/porting/visual-cpp-change-history-2003-2015.md +++ b/docs/porting/visual-cpp-change-history-2003-2015.md @@ -404,7 +404,7 @@ When upgrading code from previous versions, you might also encounter compiler er In Visual Studio 2015, ongoing improvements to compiler conformance can sometimes change how the compiler understands your existing source code. As a result, you might encounter new or different errors during your build, or even behavioral differences in code that previously built and seemed to run correctly. -Fortunately, these differences have little or no impact on most of your source code. When source code or other changes are needed to address these differences, the fixes tend to be small and straight-forward. We've included many examples of previously acceptable source code that might need to be changed *(before)* and the fixes to correct them *(after)*. +Fortunately, these differences have little or no impact on most of your source code. When source code or other changes are needed to address these differences, the fixes tend to be small and straight-forward. We've included many examples of previously acceptable source code that might need to be changed *(before)* and the fixes to correct them *(after)*. Although these differences can affect your source code or other build artifacts, they don't affect binary compatibility between updates to Visual Studio versions. A *breaking change* is more severe, and can affect binary compatibility, but these kinds of binary compatibility breaks only occur between major versions of Visual Studio, for example, between Visual Studio 2013 and Visual Studio 2015. For information on the breaking changes that occurred between Visual Studio 2013 and Visual Studio 2015, see [Visual Studio 2015 Conformance Changes](#VC_2015). diff --git a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md index 711377d790e..039c2b627c3 100644 --- a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md +++ b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md @@ -15,7 +15,7 @@ This page gathers all the "What's New" pages for all versions of Visual C++ from In Visual Studio 2015 and later, ongoing improvements to compiler conformance can sometimes change how the compiler understands your existing source code. When this happens, you might encounter new or different errors during your build, or even behavioral differences in code that previously built and seemed to run correctly. -Fortunately, these differences have little or no impact on most of your source code and when source code or other changes are needed to address these differences, fixes are usually small and straight-forward. We've included many examples of previously-acceptable source code that might need to be changed *(before)* and the fixes to correct them *(after)*. +Fortunately, these differences have little or no impact on most of your source code and when source code or other changes are needed to address these differences, fixes are usually small and straight-forward. We've included many examples of previously-acceptable source code that might need to be changed *(before)* and the fixes to correct them *(after)*. Although these differences can affect your source code or other build artifacts, they don't affect binary compatibility between updates to Visual C++ versions. A more-severe kind of change, the *breaking change* can affect binary compatibility, but these kinds of binary compatibility breaks only occur between major versions of Visual C++. For example, between Visual C++ 2013 and Visual C++ 2015. For information on the breaking changes that occurred between Visual C++ 2013 and Visual C++ 2015, see [Visual C++ change history 2003 - 2015](../porting/visual-cpp-change-history-2003-2015.md). diff --git a/docs/preprocessor/pack.md b/docs/preprocessor/pack.md index 6c153a81912..c15e48f89c1 100644 --- a/docs/preprocessor/pack.md +++ b/docs/preprocessor/pack.md @@ -107,7 +107,7 @@ The following sample shows how to use the *push*, *pop*, and *show* syntax. // pop to the identifier and then set // the value of the current packing alignment: -#pragma pack(pop, r1, 2) // n = 2 , stack popped +#pragma pack(pop, r1, 2) // n = 2, stack popped #pragma pack(show) // C4810 ``` diff --git a/docs/standard-library/ambiguous-local-time.md b/docs/standard-library/ambiguous-local-time.md index 72dba2eb717..69d255b0ab3 100644 --- a/docs/standard-library/ambiguous-local-time.md +++ b/docs/standard-library/ambiguous-local-time.md @@ -3,7 +3,7 @@ description: "Learn more about: ambiguous_local_time class" title: "ambiguous_local_time class" ms.date: 10/08/2021 f1_keywords: ["chrono/std::chrono::ambiguous_local_time", "chrono/std::chrono::ambiguous_local_time::what"] -helpviewer_keywords: ["std::chrono [C++], ambiguous_local_time"] +helpviewer_keywords: ["std::chrono [C++], ambiguous_local_time"] dev_langs: ["C++"] --- diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 4cfe39831e2..a449f52bf78 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -675,7 +675,7 @@ A reference to the string object that is being constructed by the constructors. All constructors store a [`basic_string::allocator_type`](#allocator_type) and initialize the controlled sequence. The allocator object is the argument `al`, if present. For the copy constructor, it's `right.get_allocator()`, a call to [`basic_string::get_allocator`](#get_allocator). Otherwise, the allocator is `Alloc()`. -The controlled sequence is initialized to a copy of the operand sequence specified by the remaining operands. A constructor without an operand sequence specifies an empty initial controlled sequence. If `InputIterator` is an integer type in a template constructor, the operand sequence `first, last` behaves the same as `(size_type) first, (value_type) last`. +The controlled sequence is initialized to a copy of the operand sequence specified by the remaining operands. A constructor without an operand sequence specifies an empty initial controlled sequence. If `InputIterator` is an integer type in a template constructor, the operand sequence `first, last` behaves the same as `(size_type) first, (value_type) last`. ### Example diff --git a/docs/standard-library/basic-string-view-class.md b/docs/standard-library/basic-string-view-class.md index d1b682c1a90..c92f5cb34cf 100644 --- a/docs/standard-library/basic-string-view-class.md +++ b/docs/standard-library/basic-string-view-class.md @@ -3,7 +3,7 @@ title: "basic_string_view Class" description: "API reference for `basic_string_view`, which refers to a constant contiguous sequence of char-like objects." ms.date: 9/8/2020 f1_keywords: ["xstring/std::basic_string_view", "xstring/std::basic_string_view::allocator_type", "xstring/std::basic_string_view::const_iterator", "xstring/std::basic_string_view::const_pointer", "xstring/std::basic_string_view::const_reference", "xstring/std::basic_string_view::const_reverse_iterator", "xstring/std::basic_string_view::difference_type", "xstring/std::basic_string_view::ends_with", "xstring/std::basic_string_view::starts_with", "xstring/std::basic_string_view::iterator", "xstring/std::basic_string_view::npos", "xstring/std::basic_string_view::pointer", "xstring/std::basic_string_view::reference", "xstring/std::basic_string_view::reverse_iterator", "xstring/std::basic_string_view::size_type", "xstring/std::basic_string_view::traits_type", "xstring/std::basic_string_view::value_type", "xstring/std::basic_string_view::append", "xstring/std::basic_string_view::assign", "xstring/std::basic_string_view::at", "xstring/std::basic_string_view::back", "xstring/std::basic_string_view::begin", "xstring/std::basic_string_view::c_str", "xstring/std::basic_string_view::capacity", "xstring/std::basic_string_view::cbegin", "xstring/std::basic_string_view::cend", "xstring/std::basic_string_view::clear", "xstring/std::basic_string_view::compare", "xstring/std::basic_string_view::copy", "xstring/std::basic_string_view::_Copy_s", "xstring/std::basic_string_view::crbegin", "xstring/std::basic_string_view::crend", "xstring/std::basic_string_view::data", "xstring/std::basic_string_view::empty", "xstring/std::basic_string_view::end", "xstring/std::basic_string_view::erase", "xstring/std::basic_string_view::find", "xstring/std::basic_string_view::find_first_not_of", "xstring/std::basic_string_view::find_first_of", "xstring/std::basic_string_view::find_last_not_of", "xstring/std::basic_string_view::find_last_of", "xstring/std::basic_string_view::front", "xstring/std::basic_string_view::get_allocator", "xstring/std::basic_string_view::insert", "xstring/std::basic_string_view::length", "xstring/std::basic_string_view::max_size", "xstring/std::basic_string_view::pop_back", "xstring/std::basic_string_view::push_back", "xstring/std::basic_string_view::rbegin", "xstring/std::basic_string_view::rend", "xstring/std::basic_string_view::remove_prefix","xstring/std::basic_string_view::remove_suffix", "xstring/std::basic_string_view::replace", "xstring/std::basic_string_view::reserve", "xstring/std::basic_string_view::resize", "xstring/std::basic_string_view::rfind", "xstring/std::basic_string_view::shrink_to_fit", "xstring/std::basic_string_view::size", "xstring/std::basic_string_view::substr", "xstring/std::basic_string_view::swap"] -helpviewer_keywords: ["std::basic_string_view", "std::basic_string_view, allocator_type", "std::basic_string_view, const_iterator", "std::basic_string_view, const_pointer", "std::basic_string_view, const_reference", "std::basic_string_view, const_reverse_iterator", "std::basic_string_view, difference_type", "std::basic_string_view, iterator", "std::basic_string_view, npos", "std::basic_string_view, pointer", "std::basic_string_view, reference", "std::basic_string_view, reverse_iterator", "std::basic_string_view, size_type", "std::basic_string_view, traits_type", "std::basic_string_view, value_type", "std::basic_string_view, append", "std::basic_string_view, assign", "std::basic_string_view, at", "std::basic_string_view, back", "std::basic_string_view, begin", "std::basic_string_view, c_str", "std::basic_string_view, capacity", "std::basic_string_view, cbegin", "std::basic_string_view, cend", "std::basic_string_view, clear", "std::basic_string_view, compare", "std::basic_string_view, copy", "std::basic_string_view, crbegin", "std::basic_string_view, crend", "std::basic_string_view, data", "std::basic_string_view, empty", "std::basic_string_view, end", "std::basic_string_view, ends_with", "std::basic_string_view, erase", "std::basic_string_view, find", "std::basic_string_view, find_first_not_of", "std::basic_string_view, find_first_of", "std::basic_string_view, find_last_not_of", "std::basic_string_view, find_last_of", "std::basic_string_view, front", "std::basic_string_view, get_allocator", "std::basic_string_view, insert", "std::basic_string_view, length", "std::basic_string_view, max_size", "std::basic_string_view, pop_back", "std::basic_string_view, push_back", "std::basic_string_view, rbegin", "std::basic_string_view, rend", "std::basic_string_view, remove_prefix","std::basic_string_view, remove_suffix","std::basic_string_view, replace", "std::basic_string_view, reserve", "std::basic_string_view, resize", "std::basic_string_view, rfind", "std::basic_string_view, shrink_to_fit", "std::basic_string_view, size", "std::basic_string_view, starts_with", "std::basic_string_view, substr", "std::basic_string_view, swap"] +helpviewer_keywords: ["std::basic_string_view", "std::basic_string_view, allocator_type", "std::basic_string_view, const_iterator", "std::basic_string_view, const_pointer", "std::basic_string_view, const_reference", "std::basic_string_view, const_reverse_iterator", "std::basic_string_view, difference_type", "std::basic_string_view, iterator", "std::basic_string_view, npos", "std::basic_string_view, pointer", "std::basic_string_view, reference", "std::basic_string_view, reverse_iterator", "std::basic_string_view, size_type", "std::basic_string_view, traits_type", "std::basic_string_view, value_type", "std::basic_string_view, append", "std::basic_string_view, assign", "std::basic_string_view, at", "std::basic_string_view, back", "std::basic_string_view, begin", "std::basic_string_view, c_str", "std::basic_string_view, capacity", "std::basic_string_view, cbegin", "std::basic_string_view, cend", "std::basic_string_view, clear", "std::basic_string_view, compare", "std::basic_string_view, copy", "std::basic_string_view, crbegin", "std::basic_string_view, crend", "std::basic_string_view, data", "std::basic_string_view, empty", "std::basic_string_view, end", "std::basic_string_view, ends_with", "std::basic_string_view, erase", "std::basic_string_view, find", "std::basic_string_view, find_first_not_of", "std::basic_string_view, find_first_of", "std::basic_string_view, find_last_not_of", "std::basic_string_view, find_last_of", "std::basic_string_view, front", "std::basic_string_view, get_allocator", "std::basic_string_view, insert", "std::basic_string_view, length", "std::basic_string_view, max_size", "std::basic_string_view, pop_back", "std::basic_string_view, push_back", "std::basic_string_view, rbegin", "std::basic_string_view, rend", "std::basic_string_view, remove_prefix","std::basic_string_view, remove_suffix","std::basic_string_view, replace", "std::basic_string_view, reserve", "std::basic_string_view, resize", "std::basic_string_view, rfind", "std::basic_string_view, shrink_to_fit", "std::basic_string_view, size", "std::basic_string_view, starts_with", "std::basic_string_view, substr", "std::basic_string_view, swap"] --- # `basic_string_view` class diff --git a/docs/standard-library/chrono-functions.md b/docs/standard-library/chrono-functions.md index e1812b1d349..d8131672ac2 100644 --- a/docs/standard-library/chrono-functions.md +++ b/docs/standard-library/chrono-functions.md @@ -3,7 +3,7 @@ title: " functions" description: "Learn more about: functions" ms.date: 10/15/2021 f1_keywords: ["chrono/std::duration_cast", "chrono/std::time_point_cast", "chrono/std::chrono::clock_cast", "chrono/std::chrono::duration_cast", "chrono/std::chrono::time_point_cast", "chrono/std::chrono::from_stream", "chrono/std::chrono::abs", "chrono/std::chrono::floor", "chrono/std::chrono::ceil", "chrono/std::chrono::round", "chrono/std::chrono::is_am", "chrono/std::chrono::is_pm", "chrono/std::chrono::make12", "chrono/std::chrono::make24", "chrono/std::chrono::get_leap_second_info", "chrono/std::chrono::get_tzdb", "chrono/std::chrono::get_tzdb_list", "chrono/std::chrono::locate_zone", "chrono/std::chrono::current_zone", "chrono/std::chrono::reload_tzdb", "chrono/std::chrono::remote_version"] -helpviewer_keywords: ["std::duration_cast function", "std::time_point_cast function", "std::chrono::clock_cast", "std::chrono::duration_cast function", "std::chrono::time_point_cast function", "std::chrono::from_stream function", "std::chrono::floor function", "std::chrono::ceil function", "std::chrono::round function", "std::chrono::is_am function", "std::chrono::is_pm function", "std::chrono::make12 function", "std::chrono::make24 function", "std::chrono::get_leap_second_info function", "std::chrono::get_tzdb function", "std::chrono::get_tzdb_list function", "std::chrono::locate_zone function", "std::chrono::current_zone function", "std::chrono::reload_tzdb function", "std::chrono::remote_version function"] +helpviewer_keywords: ["std::duration_cast function", "std::time_point_cast function", "std::chrono::clock_cast", "std::chrono::duration_cast function", "std::chrono::time_point_cast function", "std::chrono::from_stream function", "std::chrono::floor function", "std::chrono::ceil function", "std::chrono::round function", "std::chrono::is_am function", "std::chrono::is_pm function", "std::chrono::make12 function", "std::chrono::make24 function", "std::chrono::get_leap_second_info function", "std::chrono::get_tzdb function", "std::chrono::get_tzdb_list function", "std::chrono::locate_zone function", "std::chrono::current_zone function", "std::chrono::reload_tzdb function", "std::chrono::remote_version function"] --- # `` functions diff --git a/docs/standard-library/chrono-operators.md b/docs/standard-library/chrono-operators.md index 64931b76072..1d07f765074 100644 --- a/docs/standard-library/chrono-operators.md +++ b/docs/standard-library/chrono-operators.md @@ -2,7 +2,7 @@ title: " operators" description: "Learn more about: operators" ms.date: 09/17/2021 -f1_keywords: ["chrono/std::operator modulo", "chrono/std::operator+", "chrono/std::chrono::day::operator+", "chrono/std::chrono::duration::operator+", "chrono/std::chrono::month::operator+", "chrono/std::chrono::time_point::operator+", "chrono/std::chrono::weekday::operator+", "chrono/std::chrono::year_month::operator+", "chrono/std::chrono::year::operator+", "chrono/std::chrono::year_month_day::operator+", "chrono/std::chrono::year_month_day_last::operator+", "chrono/std::chrono::year_month_weekday::operator+", "chrono/std::chrono::year_month_weekday_last::operator+", "chrono/std::operator!=", "chrono/std::operator*", "chrono/std::operator/", "chrono/std::operator-", "chrono/std::operator<", "chrono/std::operator<=", "chrono/std::operator<", "chrono/std::operator==", "chrono/std::operator>>", "chrono/std::operator<=>", "chrono/std::chrono::day::operator<=>", "chrono/std::chrono::month::operator<=>", "chrono/std::chrono::year::operator<=>", "chrono/std::chrono::year_month::operator<=>", "chrono/std::chrono::time_point::operator<=>", "chrono/std::chrono::time_zone_link::operator<=>", "chrono/std::chrono::time_zone_link::operator==", "chrono/std::chrono::duration::operator<=>", "chrono/std::chrono::month_day_last::operator<=>", "chrono/std::chrono::year_month_day_last::operator<=>", "chrono/std::operator==", "chrono/std::chrono::year::operator<==>", "chrono/std::chrono::day::operator==", "chrono/std::chrono::duration::operator==", "chrono/std::chrono::month::operator==", "chrono/std::chrono::month_day::operator==", "chrono/std::chrono::month_day_last::operator==", "chrono/std::chrono::month_weekday::operator==", "chrono/std::chrono::month_weekday_last::operator==", "chrono/std::chrono::time_point::operator==", "chrono/std::chrono::weekday::operator==", "chrono/std::chrono::year_month::operator==", "chrono/std::chrono::year::operator==", "chrono/std::chrono::year_month_day::operator==", "chrono/std::chrono::year_month_day_last::operator==", "chrono/std::chrono::year_month_weekday_last::operator==", "chrono/std::chrono::year_month_weekday::operator==", "chrono/std::chrono::month_weekday_last::operator==", "chrono/std::chrono::weekday::operator==", "chrono/std::chrono::weekday_last::operator==", "chrono/std::chrono::year_month_weekday_indexed::operator==", "chrono/std::chrono::year_month_weekday_last::operator==", "chrono/std::chrono::year::operator==", "chrono/std::chrono::year_month::operator==", "chrono/std::chrono::year_month_day::operator==", "chrono/std::chrono::year_month_day_last::operator==", "chrono/std::chrono::zoned_time::operator==", "chrono/std::operator-", "chrono/std::chrono::day::operator-", "chrono/std::chrono::duration::operator-", "chrono/std::chrono::month::operator-", "chrono/std::chrono::time_point::operator-", "chrono/std::chrono::weekday::operator-", "chrono/std::chrono::year_month::operator-", "chrono/std::chrono::year::operator-", "chrono/std::chrono::year_month_day::operator-", "chrono/std::chrono::year_month_day_last::operator-", "chrono/std::chrono::year_month_weekday::operator-", "chrono/std::chrono::year_month_weekday_last::operator-", "chrono/std::chrono::day::operator<<", "chrono/std::chrono::hh_mm_ss::operator<<", "chrono/std::chrono::month_day::operator<<", "chrono/std::chrono::month_day_last::operator<<", "chrono/std::chrono::month_weekday::operator<<", "chrono/std::chrono::month_weekday_last::operator<<", "chrono/std::chrono::weekday::operator<<", "chrono/std::chrono::weekday_indexed::operator<<", "chrono/std::chrono::weekday_last::operator<<", "chrono/std::chrono::year::operator<<", "chrono/std::chrono::year_month_day::operator<<", "chrono/std::chrono::year_month_day_last::operator<<", "chrono/std::chrono::year_month_weekday::operator<<", "chrono/std::chrono::utc_time::operator<<", "chrono/std::chrono::tai_time::operator<<", "chrono/std::chrono::gps_time::operator<<", "chrono/std::chrono::local_time::operator<<", "chrono/std::chrono::file_time::operator<<", "chrono/std::chrono::sys_info::operator<<", "chrono/std::chrono::local_info::operator<<", "chrono/std::chrono::zoned_time::operator<<"] +f1_keywords: ["chrono/std::operator modulo", "chrono/std::operator+", "chrono/std::chrono::day::operator+", "chrono/std::chrono::duration::operator+", "chrono/std::chrono::month::operator+", "chrono/std::chrono::time_point::operator+", "chrono/std::chrono::weekday::operator+", "chrono/std::chrono::year_month::operator+", "chrono/std::chrono::year::operator+", "chrono/std::chrono::year_month_day::operator+", "chrono/std::chrono::year_month_day_last::operator+", "chrono/std::chrono::year_month_weekday::operator+", "chrono/std::chrono::year_month_weekday_last::operator+", "chrono/std::operator!=", "chrono/std::operator*", "chrono/std::operator/", "chrono/std::operator-", "chrono/std::operator<", "chrono/std::operator<=", "chrono/std::operator<", "chrono/std::operator==", "chrono/std::operator>>", "chrono/std::operator<=>", "chrono/std::chrono::day::operator<=>", "chrono/std::chrono::month::operator<=>", "chrono/std::chrono::year::operator<=>", "chrono/std::chrono::year_month::operator<=>", "chrono/std::chrono::time_point::operator<=>", "chrono/std::chrono::time_zone_link::operator<=>", "chrono/std::chrono::time_zone_link::operator==", "chrono/std::chrono::duration::operator<=>", "chrono/std::chrono::month_day_last::operator<=>", "chrono/std::chrono::year_month_day_last::operator<=>", "chrono/std::operator==", "chrono/std::chrono::year::operator<==>", "chrono/std::chrono::day::operator==", "chrono/std::chrono::duration::operator==", "chrono/std::chrono::month::operator==", "chrono/std::chrono::month_day::operator==", "chrono/std::chrono::month_day_last::operator==", "chrono/std::chrono::month_weekday::operator==", "chrono/std::chrono::month_weekday_last::operator==", "chrono/std::chrono::time_point::operator==", "chrono/std::chrono::weekday::operator==", "chrono/std::chrono::year_month::operator==", "chrono/std::chrono::year::operator==", "chrono/std::chrono::year_month_day::operator==", "chrono/std::chrono::year_month_day_last::operator==", "chrono/std::chrono::year_month_weekday_last::operator==", "chrono/std::chrono::year_month_weekday::operator==", "chrono/std::chrono::month_weekday_last::operator==", "chrono/std::chrono::weekday::operator==", "chrono/std::chrono::weekday_last::operator==", "chrono/std::chrono::year_month_weekday_indexed::operator==", "chrono/std::chrono::year_month_weekday_last::operator==", "chrono/std::chrono::year::operator==", "chrono/std::chrono::year_month::operator==", "chrono/std::chrono::year_month_day::operator==", "chrono/std::chrono::year_month_day_last::operator==", "chrono/std::chrono::zoned_time::operator==", "chrono/std::operator-", "chrono/std::chrono::day::operator-", "chrono/std::chrono::duration::operator-", "chrono/std::chrono::month::operator-", "chrono/std::chrono::time_point::operator-", "chrono/std::chrono::weekday::operator-", "chrono/std::chrono::year_month::operator-", "chrono/std::chrono::year::operator-", "chrono/std::chrono::year_month_day::operator-", "chrono/std::chrono::year_month_day_last::operator-", "chrono/std::chrono::year_month_weekday::operator-", "chrono/std::chrono::year_month_weekday_last::operator-", "chrono/std::chrono::day::operator<<", "chrono/std::chrono::hh_mm_ss::operator<<", "chrono/std::chrono::month_day::operator<<", "chrono/std::chrono::month_day_last::operator<<", "chrono/std::chrono::month_weekday::operator<<", "chrono/std::chrono::month_weekday_last::operator<<", "chrono/std::chrono::weekday::operator<<", "chrono/std::chrono::weekday_indexed::operator<<", "chrono/std::chrono::weekday_last::operator<<", "chrono/std::chrono::year::operator<<", "chrono/std::chrono::year_month_day::operator<<", "chrono/std::chrono::year_month_day_last::operator<<", "chrono/std::chrono::year_month_weekday::operator<<", "chrono/std::chrono::utc_time::operator<<", "chrono/std::chrono::tai_time::operator<<", "chrono/std::chrono::gps_time::operator<<", "chrono/std::chrono::local_time::operator<<", "chrono/std::chrono::file_time::operator<<", "chrono/std::chrono::sys_info::operator<<", "chrono/std::chrono::local_info::operator<<", "chrono/std::chrono::zoned_time::operator<<"] --- # `` operators @@ -786,7 +786,7 @@ strong_ordering operator<=>(const time_zone_link& Left, const time_zone_link& Ri ### Parameters *`Left`, `Right`*\ -The [`day`](day-class.md), [`duration`](duration-class.md), [`month`](month-class.md), [`month_day`](month-day-class.md), [`month_day_last`](month-day-last-class.md), [`time_point`](time-point-class.md), [`time_zone_link`](time-zone-link-class.md), [`year`](year-class.md), [`year_month`](year-month-class.md), [`year_month_day`](year-month-day-class.md), [`year_month_day_last`](year-month-day-last-class.md) to compare. +The [`day`](day-class.md), [`duration`](duration-class.md), [`month`](month-class.md), [`month_day`](month-day-class.md), [`month_day_last`](month-day-last-class.md), [`time_point`](time-point-class.md), [`time_zone_link`](time-zone-link-class.md), [`year`](year-class.md), [`year_month`](year-month-class.md), [`year_month_day`](year-month-day-class.md), [`year_month_day_last`](year-month-day-last-class.md) to compare. ### Return value diff --git a/docs/standard-library/duration-class.md b/docs/standard-library/duration-class.md index d0fa6d8e030..706491c042e 100644 --- a/docs/standard-library/duration-class.md +++ b/docs/standard-library/duration-class.md @@ -156,7 +156,7 @@ A duration type `D1` is *incommensurable* with another duration type `D2` if `D2 Unless *`Rep2`* is implicitly convertible to `rep` and either `treat_as_floating_point`*holds true* or `treat_as_floating_point`*holds false*, the second constructor doesn't participate in overload resolution. For more information, see [](type-traits.md). -Unless no overflow is induced in the conversion and `treat_as_floating_point`*holds true*, or both `ratio_divide::den` equals 1 and `treat_as_floating_point`*holds false*, the third constructor doesn't participate in overload resolution. For more information, see [](type-traits.md). +Unless no overflow is induced in the conversion and `treat_as_floating_point`*holds true*, or both `ratio_divide::den` equals 1 and `treat_as_floating_point`*holds false*, the third constructor doesn't participate in overload resolution. For more information, see [](type-traits.md). ## Example: Create a `duration` diff --git a/docs/standard-library/file-clock-class.md b/docs/standard-library/file-clock-class.md index fe87f0ce9ea..289bcce89bf 100644 --- a/docs/standard-library/file-clock-class.md +++ b/docs/standard-library/file-clock-class.md @@ -17,7 +17,7 @@ using file_clock = std::filesystem::_File_time_clock; // C++20 ## Remarks -In the Microsoft implementation, the epoch, or the time from which the `file_clock` starts measuring time, is 1/1/1601 00:00:00. +In the Microsoft implementation, the epoch, or the time from which the `file_clock` starts measuring time, is 1/1/1601 00:00:00. The ISO C++ Standard provides a choice between providing `to_sys()` and `from_sys()`, or `to_utc()` and `from_utc()`. The Microsoft implementation chose [to_utc](#to_utc) and [from_utc](#from_utc). diff --git a/docs/standard-library/filter-view-class.md b/docs/standard-library/filter-view-class.md index f99b3791bb5..c0bd7389f52 100644 --- a/docs/standard-library/filter-view-class.md +++ b/docs/standard-library/filter-view-class.md @@ -2,7 +2,7 @@ title: filter_view class (C++ Standard Library) description: "API reference for the Standard Template Library (STL) filter_view class, which is a view that filters out elements of a range that don't match a predicate." ms.date: 09/27/2022 -f1_keywords: ["ranges/std::filter_view", "ranges/std::filter_view::base", "ranges/std::filter_view::begin", "ranges/std::filter_view::empty", "ranges/std::filter_view::end", "ranges/std::filter_view::operator bool", "ranges/std::filter_view::pred", "ranges/std::filter_view::back", "ranges/std::filter_view::front"] +f1_keywords: ["ranges/std::filter_view", "ranges/std::filter_view::base", "ranges/std::filter_view::begin", "ranges/std::filter_view::empty", "ranges/std::filter_view::end", "ranges/std::filter_view::operator bool", "ranges/std::filter_view::pred", "ranges/std::filter_view::back", "ranges/std::filter_view::front"] helpviewer_keywords: ["std::ranges::filter_view [C++]", "std::ranges::filter_view::base [C++]", "std::ranges::filter_view::begin [C++]", "std::ranges::filter_view::empty [C++]", "std::ranges::filter_view::end [C++]", "std::ranges::filter_view::pred [C++]", "std::ranges::filter_view::back [C++]", "std::ranges::filter_view::front [C++]", "std::ranges::filter_view::operator bool [C++]"] dev_langs: ["C++"] --- diff --git a/docs/standard-library/subrange-class.md b/docs/standard-library/subrange-class.md index 7f269483d0e..1a38bf37d1d 100644 --- a/docs/standard-library/subrange-class.md +++ b/docs/standard-library/subrange-class.md @@ -3,7 +3,7 @@ title: subrange class (C++ Standard Library) description: "API reference for the Standard Template Library (STL) subrange class, which is a view of the elements of a range as defined by a begin iterator and a sentinel." ms.date: 10/05/2022 f1_keywords: ["ranges/std::subrange", "ranges/std::subrange::begin", "ranges/std::subrange::data", "ranges/std::subrange::empty", "ranges/std::subrange::end", "ranges/std::subrange::get", "ranges/std::subrange::size", "ranges/std::subrange::operator bool", "ranges/std::subrange::operator PairLike", "ranges/std::subrange::back", "ranges/std::subrange::front", "ranges/std::subrange::operator[]", "ranges/std::subrange::advance", "ranges/std::subrange::prev", "ranges/std::subrange::next"] -helpviewer_keywords: ["std::ranges::subrange [C++]", "std::ranges::subrange::begin [C++]", "std::ranges::subrange::data [C++]", "std::ranges::subrange::empty [C++]", "std::ranges::subrange::end [C++]", "std::ranges::subrange::size [C++]", "std::ranges::subrange::back [C++]", "std::ranges::subrange::front [C++]", "std::ranges::subrange::advance [C++]", "std::ranges::subrange::prev [C++]", "std::ranges::subrange::next [C++]", "std::ranges::subrange::get [C++]", "std::ranges::subrange::operator[] [C++]", "std::ranges::subrange::operator bool [C++]", "std::ranges::subrange::operator PairLike [C++]"] +helpviewer_keywords: ["std::ranges::subrange [C++]", "std::ranges::subrange::begin [C++]", "std::ranges::subrange::data [C++]", "std::ranges::subrange::empty [C++]", "std::ranges::subrange::end [C++]", "std::ranges::subrange::size [C++]", "std::ranges::subrange::back [C++]", "std::ranges::subrange::front [C++]", "std::ranges::subrange::advance [C++]", "std::ranges::subrange::prev [C++]", "std::ranges::subrange::next [C++]", "std::ranges::subrange::get [C++]", "std::ranges::subrange::operator[] [C++]", "std::ranges::subrange::operator bool [C++]", "std::ranges::subrange::operator PairLike [C++]"] dev_langs: ["C++"] --- # `subrange` class (C++ Standard Library) diff --git a/docs/standard-library/time-point-class.md b/docs/standard-library/time-point-class.md index b5b9baf42b6..24818d11dcd 100644 --- a/docs/standard-library/time-point-class.md +++ b/docs/standard-library/time-point-class.md @@ -2,7 +2,7 @@ description: "Learn more about: time_point Class" title: "time_point Class" ms.date: 01/05/2022 -f1_keywords: ["chrono/std::chrono::time_point", "chrono/std::chrono::time_point::operator +=", "chrono/std::chrono::time_point::operator -=", "chrono/std::chrono::time_point::max", "chrono/std::chrono::time_point::min", "chrono/std::chrono::time_point::time_since_epoch"] +f1_keywords: ["chrono/std::chrono::time_point", "chrono/std::chrono::time_point::operator +=", "chrono/std::chrono::time_point::operator -=", "chrono/std::chrono::time_point::max", "chrono/std::chrono::time_point::min", "chrono/std::chrono::time_point::time_since_epoch"] helpviewer_keywords: ["std::chrono [C++], time_point"] dev_langs: ["C++"] --- diff --git a/docs/standard-library/view-interface.md b/docs/standard-library/view-interface.md index 67bf457cb5f..b042f9f80cd 100644 --- a/docs/standard-library/view-interface.md +++ b/docs/standard-library/view-interface.md @@ -3,7 +3,7 @@ title: view_interface class (C++ Standard Library) description: "API reference for the Standard Template Library (STL) view_interface class, which is the base class for the ranges view classes." ms.date: 10/07/2022 f1_keywords: ["ranges/std::view_interface::back", "ranges/std::view_interface::data","ranges/std::view_interface::empty", "ranges/std::view_interface::front", "ranges/std::view_interface::size", "ranges/std::view_interface::operator[]", "ranges/std::view_interface::operator bool"] -helpviewer_keywords: ["std::ranges::view_interface [C++]", "std::ranges::view_interface [C++], back", "std::ranges::view_interface [C++], data", "std::ranges::view_interface [C++], empty", "std::ranges::view_interface [C++], front", "std::ranges::view_interface [C++], size", "std::ranges::view_interface [C++], operator[]", "std::ranges::view_interface [C++], operator bool"] +helpviewer_keywords: ["std::ranges::view_interface [C++]", "std::ranges::view_interface [C++], back", "std::ranges::view_interface [C++], data", "std::ranges::view_interface [C++], empty", "std::ranges::view_interface [C++], front", "std::ranges::view_interface [C++], size", "std::ranges::view_interface [C++], operator[]", "std::ranges::view_interface [C++], operator bool"] dev_langs: ["C++"] --- # `view_interface` class (C++ Standard Library) From b96b32beb7ec33569a43045c93e14e267b791c15 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Thu, 25 Sep 2025 22:46:32 +0800 Subject: [PATCH 1296/1799] Update metadata in 26 topics --- docs/build/arm64-exception-handling.md | 2 +- docs/build/reference/guard-enable-control-flow-guard.md | 2 +- docs/c-language/generic-selection.md | 2 +- docs/c-runtime-library/cgets-cgetws.md | 5 ++--- docs/c-runtime-library/gets-getws.md | 4 ++-- docs/c-runtime-library/parameter-validation.md | 3 +-- .../reference/assert-asserte-assert-expr-macros.md | 4 ++-- docs/c-runtime-library/reference/ctan-ctanf-ctanl.md | 3 +-- docs/c-runtime-library/reference/exit-exit-exit.md | 4 ++-- docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md | 5 ++--- .../strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md | 5 ++--- .../using-rule-sets-to-specify-the-cpp-rules-to-run.md | 2 +- docs/cpp/floating-limits.md | 5 ++--- docs/cpp/restrict-cpp-amp.md | 5 ++--- docs/cpp/templates-cpp.md | 5 ++--- docs/cppcx/attributes-c-cx.md | 5 ++--- docs/cppcx/platform-collections-unorderedmap-class.md | 5 ++--- docs/parallel/amp/cpp-amp-overview.md | 6 +++--- docs/preprocessor/pack.md | 2 +- docs/standard-library/ambiguous-local-time.md | 2 +- docs/standard-library/duration-class.md | 2 +- docs/standard-library/file-clock-class.md | 2 +- docs/standard-library/filter-view-class.md | 2 +- docs/standard-library/subrange-class.md | 2 +- docs/standard-library/time-point-class.md | 2 +- docs/standard-library/view-interface.md | 2 +- 26 files changed, 39 insertions(+), 49 deletions(-) diff --git a/docs/build/arm64-exception-handling.md b/docs/build/arm64-exception-handling.md index ed0f9cc58ae..d459965ede4 100644 --- a/docs/build/arm64-exception-handling.md +++ b/docs/build/arm64-exception-handling.md @@ -1,6 +1,6 @@ --- title: "ARM64 exception handling" -description: Describes the exception handling conventions and data used by windows on ARM64. +description: "Describes the exception handling conventions and data used by windows on ARM64." ms.date: 01/13/2023 --- # ARM64 exception handling diff --git a/docs/build/reference/guard-enable-control-flow-guard.md b/docs/build/reference/guard-enable-control-flow-guard.md index 1b51ece0e96..1da0931bd13 100644 --- a/docs/build/reference/guard-enable-control-flow-guard.md +++ b/docs/build/reference/guard-enable-control-flow-guard.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: /guard (Enable Control Flow Guard)" title: "/guard (Enable Control Flow Guard)" +description: "Learn more about: /guard (Enable Control Flow Guard)" ms.date: 2/24/2025 f1_keywords: ["/guard", "VC.Project.VCCLCompilerTool.ControlFlowGuard"] --- diff --git a/docs/c-language/generic-selection.md b/docs/c-language/generic-selection.md index 15a8a2cbf78..0eba6388e33 100644 --- a/docs/c-language/generic-selection.md +++ b/docs/c-language/generic-selection.md @@ -1,7 +1,7 @@ --- title: "Generic selection (C11)" description: "Describes the C11 _Generic keyword used in the Microsoft Visual C compiler" -ms.date: "6/29/2021" +ms.date: 6/29/2021 helpviewer_keywords: ["_Generic keyword [C]"] --- diff --git a/docs/c-runtime-library/cgets-cgetws.md b/docs/c-runtime-library/cgets-cgetws.md index 875efdfdd5d..04390142f6d 100644 --- a/docs/c-runtime-library/cgets-cgetws.md +++ b/docs/c-runtime-library/cgets-cgetws.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _cgets, _cgetws" title: "_cgets, _cgetws" -ms.date: "4/2/2020" +description: "Learn more about: _cgets, _cgetws" +ms.date: 4/2/2020 api_name: ["_cgetws", "_cgets", "_o__cgets", "_o__cgetws"] api_location: ["msvcr100.dll", "msvcr110.dll", "msvcr80.dll", "msvcr120.dll", "msvcr90.dll", "msvcrt.dll", "msvcr110_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cgetws", "_cgetws", "_cgets"] helpviewer_keywords: ["_cgetws function", "strings [C++], getting from console", "console, getting strings from", "_cgets function", "cgetws function", "cgets function"] -ms.assetid: 4d5e134a-58c3-4f62-befd-5d235b0212f4 --- # `_cgets`, `_cgetws` diff --git a/docs/c-runtime-library/gets-getws.md b/docs/c-runtime-library/gets-getws.md index f3df496be63..d688cef1fbf 100644 --- a/docs/c-runtime-library/gets-getws.md +++ b/docs/c-runtime-library/gets-getws.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: gets, _getws" title: "gets, _getws" -ms.date: "4/2/2020" +description: "Learn more about: gets, _getws" +ms.date: 4/2/2020 api_name: ["_getws", "gets", "_o__getws", "_o_gets"] api_location: ["msvcr80.dll", "msvcr90.dll", "msvcr120.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcrt.dll", "msvcr100.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/parameter-validation.md b/docs/c-runtime-library/parameter-validation.md index 46053fc1e57..c16c5b84dd5 100644 --- a/docs/c-runtime-library/parameter-validation.md +++ b/docs/c-runtime-library/parameter-validation.md @@ -1,10 +1,9 @@ --- title: "Parameter Validation" description: "A description of parameter validation in the Microsoft C runtime library." -ms.date: "11/04/2016" +ms.date: 11/04/2016 ms.topic: "concept-article" helpviewer_keywords: ["parameters, validation"] -ms.assetid: 019dd5f0-dc61-4d2e-b4e9-b66409ddf1f2 --- # Parameter validation diff --git a/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md b/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md index 407364ac2a3..b728bbd517c 100644 --- a/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md +++ b/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _ASSERT, _ASSERTE, _ASSERT_EXPR Macros" title: "_ASSERT, _ASSERTE, _ASSERT_EXPR Macros" -ms.date: "11/04/2016" +description: "Learn more about: _ASSERT, _ASSERTE, _ASSERT_EXPR Macros" +ms.date: 11/04/2016 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] diff --git a/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md b/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md index cbb5fa5b176..8272c80111f 100644 --- a/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md +++ b/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md @@ -1,14 +1,13 @@ --- title: "ctan, ctanf, ctanl" description: "API reference for ctan, ctanf, and ctanl; which retrieve the tangent of a complex number." -ms.date: "11/04/2016" +ms.date: 11/04/2016 api_name: ["ctan", "ctanf", "ctanl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ctan", "ctanf", "ctanl", "complex/ctan", "complex/ctanf", "complex/ctanl"] helpviewer_keywords: ["ctan function", "ctanf function", "ctanl function"] -ms.assetid: d3cbd25c-1e93-4a6d-8154-da42921f7223 --- # `ctan`, `ctanf`, `ctanl` diff --git a/docs/c-runtime-library/reference/exit-exit-exit.md b/docs/c-runtime-library/reference/exit-exit-exit.md index 304f2ce76f0..1736f05b272 100644 --- a/docs/c-runtime-library/reference/exit-exit-exit.md +++ b/docs/c-runtime-library/reference/exit-exit-exit.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: exit, _Exit, _exit" title: "exit, _Exit, _exit" -ms.date: "4/2/2020" +description: "Learn more about: exit, _Exit, _exit" +ms.date: 4/2/2020 api_name: ["_exit", "exit", "_o__exit", "_o_exit"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-runtime-l1-1-0.dll"] api_type: ["DLLExport"] diff --git a/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md b/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md index 9b812930430..f8f8f24a703 100644 --- a/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md +++ b/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: mbrtoc16, mbrtoc32" title: "mbrtoc16, mbrtoc323" -ms.date: "4/2/2020" +description: "Learn more about: mbrtoc16, mbrtoc32" +ms.date: 4/2/2020 api_name: ["mbrtoc16", "mbrtoc32", "_o_mbrtoc16", "_o_mbrtoc32"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["mbrtoc16", "mbrtoc32", "uchar/mbrtoc16", "uchar/mbrtoc32"] helpviewer_keywords: ["mbrtoc16 function", "mbrtoc32 function"] -ms.assetid: 099ade4d-56f7-4e61-8b45-493f1d7a64bd --- # `mbrtoc16`, `mbrtoc32` diff --git a/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md b/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md index 620cdd63710..e43cfdbd12d 100644 --- a/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md +++ b/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: strtoumax, _strtoumax_l, wcstoumax, _wcstoumax_l" title: "strtoumax, _strtoumax_l, wcstoumax, _wcstoumax_l" -ms.date: "11/04/2016" +description: "Learn more about: strtoumax, _strtoumax_l, wcstoumax, _wcstoumax_l" +ms.date: 11/04/2016 api_name: ["_wcstoumax_l", "_strtoumax_l", "wcstoumax", "strtoumax"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["INTTYPES/strtoumax", "INTTYPES/_strtoumax_l", "INTTYPES/wcstoumax", "INTTYPES/_wcstoumax_l", "TCHAR/_tcstoumax", "TCHAR/_tcstoumax_l", "strtoumax", "_strtoumax_l", "wcstoumax", "_wcstoumax_l", "_tcstoumax", "_tcstoumax_l"] helpviewer_keywords: ["_strtoumax_l function", "conversion functions", "wcstoumax function", "_wcstoumax_l function", "strtoumax function"] -ms.assetid: 566769f9-495b-4508-b9c6-02217a578897 --- # `strtoumax`, `_strtoumax_l`, `wcstoumax`, `_wcstoumax_l` diff --git a/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md b/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md index e98971d9707..a9884d1794c 100644 --- a/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md +++ b/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md @@ -1,6 +1,6 @@ --- +title: "Using Rule Sets to Specify the C++ Rules to Run" description: "Learn more about: Use Rule Sets to Specify the C++ Rules to Run" -title: Using Rule Sets to Specify the C++ Rules to Run ms.date: 07/27/2020 ms.topic: "how-to" f1_keywords: diff --git a/docs/cpp/floating-limits.md b/docs/cpp/floating-limits.md index 10b244a46dc..60762ecfb15 100644 --- a/docs/cpp/floating-limits.md +++ b/docs/cpp/floating-limits.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Floating Limits" title: "Floating Limits" -ms.date: "08/03/2018" +description: "Learn more about: Floating Limits" +ms.date: 08/03/2018 helpviewer_keywords: ["ranges, floating-point constants", "floating-point constants, limits", "float.h header file", "limits, floating-point constants", "floating-point numbers [C++]", "floating limits"] -ms.assetid: fc718652-1f4c-4ed8-af60-0e769637459c --- # Floating Limits diff --git a/docs/cpp/restrict-cpp-amp.md b/docs/cpp/restrict-cpp-amp.md index bd1b63c3b1f..97dcc8e1286 100644 --- a/docs/cpp/restrict-cpp-amp.md +++ b/docs/cpp/restrict-cpp-amp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: restrict (C++ AMP)" title: "restrict (C++ AMP)" -ms.date: "11/04/2016" +description: "Learn more about: restrict (C++ AMP)" +ms.date: 11/04/2016 f1_keywords: ["cpu_CPP", "amp_CPP"] helpviewer_keywords: ["restrict clause (C++ AMP)"] -ms.assetid: 07d3291f-7edf-456b-8828-283ac8673661 --- # restrict (C++ AMP) diff --git a/docs/cpp/templates-cpp.md b/docs/cpp/templates-cpp.md index aa7e68bec68..bc964932988 100644 --- a/docs/cpp/templates-cpp.md +++ b/docs/cpp/templates-cpp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Templates (C++)" title: "Templates (C++)" -ms.date: "12/27/2019" +description: "Learn more about: Templates (C++)" +ms.date: 12/27/2019 f1_keywords: ["template_cpp"] helpviewer_keywords: ["templates, C++", "templates [C++]"] -ms.assetid: 90fcc14a-2092-47af-9d2e-dba26d25b872 --- # Templates (C++) diff --git a/docs/cppcx/attributes-c-cx.md b/docs/cppcx/attributes-c-cx.md index 0fbe7a494e0..f7c87dca2b2 100644 --- a/docs/cppcx/attributes-c-cx.md +++ b/docs/cppcx/attributes-c-cx.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: Attributes (C++/CX)" title: "Attributes (C++/CX)" -ms.date: "12/30/2016" -ms.assetid: 4438e03c-4de3-433d-abcc-31aa863bc0e0 +description: "Learn more about: Attributes (C++/CX)" +ms.date: 12/30/2016 --- # Attributes (C++/CX) diff --git a/docs/cppcx/platform-collections-unorderedmap-class.md b/docs/cppcx/platform-collections-unorderedmap-class.md index 056468abaca..a65c9b4d548 100644 --- a/docs/cppcx/platform-collections-unorderedmap-class.md +++ b/docs/cppcx/platform-collections-unorderedmap-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Platform::Collections::UnorderedMap Class" title: "Platform::Collections::UnorderedMap Class" -ms.date: "12/30/2016" +description: "Learn more about: Platform::Collections::UnorderedMap Class" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["collection/Platform::Collections::UnorderedMap"] -ms.assetid: dc84f261-b13c-4c0a-9b57-30dcb9e3065e --- # Platform::Collections::UnorderedMap Class diff --git a/docs/parallel/amp/cpp-amp-overview.md b/docs/parallel/amp/cpp-amp-overview.md index 452f22396fd..71492d2b0f3 100644 --- a/docs/parallel/amp/cpp-amp-overview.md +++ b/docs/parallel/amp/cpp-amp-overview.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: C++ AMP Overview" title: "C++ AMP Overview" -ms.date: "11/19/2018" -helpviewer_keywords: ["C++ Accelerated Massive Parallelism, requirements", "C++ Accelerated Massive Parallelism, architecture", "C++ AMP", "C++ Accelerated Massive Parallelism, overview", "C++ Accelerated Massive Parallelism"] +description: "Learn more about: C++ AMP Overview" +ms.date: 11/19/2018 ms.topic: concept-article +helpviewer_keywords: ["C++ Accelerated Massive Parallelism, requirements", "C++ Accelerated Massive Parallelism, architecture", "C++ AMP", "C++ Accelerated Massive Parallelism, overview", "C++ Accelerated Massive Parallelism"] --- # C++ AMP Overview diff --git a/docs/preprocessor/pack.md b/docs/preprocessor/pack.md index c15e48f89c1..9941cdcd092 100644 --- a/docs/preprocessor/pack.md +++ b/docs/preprocessor/pack.md @@ -1,6 +1,6 @@ --- -description: "Learn more about the pack pragma directive in Microsoft C/C++" title: "pack pragma" +description: "Learn more about the pack pragma directive in Microsoft C/C++" ms.date: 01/22/2021 f1_keywords: ["pack_CPP", "vc-pragma.pack"] helpviewer_keywords: ["pragma, pack", "pack pragma"] diff --git a/docs/standard-library/ambiguous-local-time.md b/docs/standard-library/ambiguous-local-time.md index 69d255b0ab3..d90b87dcedc 100644 --- a/docs/standard-library/ambiguous-local-time.md +++ b/docs/standard-library/ambiguous-local-time.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: ambiguous_local_time class" title: "ambiguous_local_time class" +description: "Learn more about: ambiguous_local_time class" ms.date: 10/08/2021 f1_keywords: ["chrono/std::chrono::ambiguous_local_time", "chrono/std::chrono::ambiguous_local_time::what"] helpviewer_keywords: ["std::chrono [C++], ambiguous_local_time"] diff --git a/docs/standard-library/duration-class.md b/docs/standard-library/duration-class.md index 706491c042e..e3269876783 100644 --- a/docs/standard-library/duration-class.md +++ b/docs/standard-library/duration-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: duration class" title: "duration Class" +description: "Learn more about: duration class" ms.date: 01/05/2022 f1_keywords: ["chrono/std::chrono::duration", "chrono/std::chrono::duration::duration", "chrono/std::chrono::duration::count", "chrono/std::chrono::duration::max", "chrono/std::chrono::duration::min", "chrono/std::chrono::duration::zero","chrono/std::chrono::duration::operator-", "chrono/std::chrono::duration::operator--", "chrono/std::chrono::duration::operator%=", "chrono/std::chrono::duration::operator*=", "chrono/std::chrono::duration::operator+", "chrono/std::chrono::duration::operator++", "chrono/std::chrono::duration::operator+=", "chrono/std::chrono::duration::operator-=", "chrono/std::chrono::duration::operator="] helpviewer_keywords: ["std::chrono [C++], duration"] diff --git a/docs/standard-library/file-clock-class.md b/docs/standard-library/file-clock-class.md index 289bcce89bf..6f9b2251cec 100644 --- a/docs/standard-library/file-clock-class.md +++ b/docs/standard-library/file-clock-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: file_clock class" title: "file_clock class" +description: "Learn more about: file_clock class" ms.date: 3/8/2024 f1_keywords: ["chrono/std::chrono::file_clock", "chrono/std::chrono::file_clock::now", "chrono/std::chrono::file_clock::to_utc", "chrono/std::chrono::file_clock::from_utc", "chrono/std::chrono::file_clock::is_steady Constant"] --- diff --git a/docs/standard-library/filter-view-class.md b/docs/standard-library/filter-view-class.md index c0bd7389f52..2e36ae8a983 100644 --- a/docs/standard-library/filter-view-class.md +++ b/docs/standard-library/filter-view-class.md @@ -1,5 +1,5 @@ --- -title: filter_view class (C++ Standard Library) +title: "filter_view class (C++ Standard Library)" description: "API reference for the Standard Template Library (STL) filter_view class, which is a view that filters out elements of a range that don't match a predicate." ms.date: 09/27/2022 f1_keywords: ["ranges/std::filter_view", "ranges/std::filter_view::base", "ranges/std::filter_view::begin", "ranges/std::filter_view::empty", "ranges/std::filter_view::end", "ranges/std::filter_view::operator bool", "ranges/std::filter_view::pred", "ranges/std::filter_view::back", "ranges/std::filter_view::front"] diff --git a/docs/standard-library/subrange-class.md b/docs/standard-library/subrange-class.md index 1a38bf37d1d..98576c1de55 100644 --- a/docs/standard-library/subrange-class.md +++ b/docs/standard-library/subrange-class.md @@ -1,5 +1,5 @@ --- -title: subrange class (C++ Standard Library) +title: "subrange class (C++ Standard Library)" description: "API reference for the Standard Template Library (STL) subrange class, which is a view of the elements of a range as defined by a begin iterator and a sentinel." ms.date: 10/05/2022 f1_keywords: ["ranges/std::subrange", "ranges/std::subrange::begin", "ranges/std::subrange::data", "ranges/std::subrange::empty", "ranges/std::subrange::end", "ranges/std::subrange::get", "ranges/std::subrange::size", "ranges/std::subrange::operator bool", "ranges/std::subrange::operator PairLike", "ranges/std::subrange::back", "ranges/std::subrange::front", "ranges/std::subrange::operator[]", "ranges/std::subrange::advance", "ranges/std::subrange::prev", "ranges/std::subrange::next"] diff --git a/docs/standard-library/time-point-class.md b/docs/standard-library/time-point-class.md index 24818d11dcd..5535d23dd92 100644 --- a/docs/standard-library/time-point-class.md +++ b/docs/standard-library/time-point-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: time_point Class" title: "time_point Class" +description: "Learn more about: time_point Class" ms.date: 01/05/2022 f1_keywords: ["chrono/std::chrono::time_point", "chrono/std::chrono::time_point::operator +=", "chrono/std::chrono::time_point::operator -=", "chrono/std::chrono::time_point::max", "chrono/std::chrono::time_point::min", "chrono/std::chrono::time_point::time_since_epoch"] helpviewer_keywords: ["std::chrono [C++], time_point"] diff --git a/docs/standard-library/view-interface.md b/docs/standard-library/view-interface.md index b042f9f80cd..2b77da6fd37 100644 --- a/docs/standard-library/view-interface.md +++ b/docs/standard-library/view-interface.md @@ -1,5 +1,5 @@ --- -title: view_interface class (C++ Standard Library) +title: "view_interface class (C++ Standard Library)" description: "API reference for the Standard Template Library (STL) view_interface class, which is the base class for the ranges view classes." ms.date: 10/07/2022 f1_keywords: ["ranges/std::view_interface::back", "ranges/std::view_interface::data","ranges/std::view_interface::empty", "ranges/std::view_interface::front", "ranges/std::view_interface::size", "ranges/std::view_interface::operator[]", "ranges/std::view_interface::operator bool"] From a6028b5432887020e2f12a2237ed0c9d7321d11b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 25 Sep 2025 18:09:10 -0700 Subject: [PATCH 1297/1799] make redist topic easier to navigate --- docs/windows/latest-supported-vc-redist.md | 54 +++++++++++-------- .../redistributing-visual-cpp-files.md | 3 ++ 2 files changed, 34 insertions(+), 23 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 974db314854..aaea9cfce78 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -1,7 +1,7 @@ --- title: "Latest supported Visual C++ Redistributable downloads" -description: "This article lists the download links for the latest versions of Visual C++ Redistributable packages." -ms.date: 5/28/2025 +description: "This article provides download links for the latest Visual C++ Redistributable packages." +ms.date: 09/23/2025 helpviewer_keywords: [ "redist", @@ -9,7 +9,7 @@ helpviewer_keywords: "Visual [C++] redistributable", "Visual [C++] downloads", "MSVC downloads", - "[C++] downloads", + "[C++] downloads" ] author: MahmoudGSaleh ms.author: msaleh @@ -17,23 +17,33 @@ ms.author: msaleh # Microsoft Visual C++ Redistributable latest supported downloads -The Visual C++ Redistributable installs Microsoft C and C++ (MSVC) runtime libraries. Many applications built using Microsoft C and C++ tools require these libraries. If your app uses those libraries, a Microsoft Visual C++ Redistributable package must be installed on the target system before you install your app. The Redistributable package architecture must match your app's target architecture. The Redistributable version must be at least as recent as the MSVC build toolset used to build your app. We recommend you use the latest Redistributable available for your version of Visual Studio, with some exceptions noted later in this article. +> [!NOTE] +> Are you here to download Visual Studio? Go to [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/). -Distribution of the Visual C++ Runtime Redistributable package, merge modules, and individual binaries is limited to licensed Visual Studio users and is subject to such License Terms. +This topic is for developers who need to install the Visual C++ runtime libraries on the system that their apps runs on. If you're an end user trying to fix an app by updating the Visual C++ runtime libraries, contact the app vendor for instructions. -For details on how to install and redistribute Visual Studio components, see [Redistributing Visual C++ Files](redistributing-visual-cpp-files.md). +To quickly find the download you need, choose your version of Visual Studio from the table below. Each link takes you to the appropriate download section. -## Visual Studio 2015, 2017, 2019, and 2022 +| Visual Studio version | Download section | +|--|--| +| Latest supported (2015–2022) | [Latest supported Redistributable version](#latest-supported-redistributable-version) | +| Visual Studio 2013 | [Visual Studio 2013 (VC++ 12.0)](#visual-studio-2013-vc-120-no-longer-supported) | +| Visual Studio 2012 | [Visual Studio 2012 (VC++ 11.0)](#visual-studio-2012-vc-110-update-4-no-longer-supported) | +| Visual Studio 2010 | [Visual Studio 2010 (VC++ 10.0)](#visual-studio-2010-vc-100-sp1-no-longer-supported) | +| Visual Studio 2008 | [Visual Studio 2008 (VC++ 9.0)](#visual-studio-2008-vc-90-sp1-no-longer-supported) | +| Visual Studio 2005 | [Visual Studio 2005 (VC++ 8.0)](#visual-studio-2005-vc-80-sp1-no-longer-supported) | -This table lists the latest supported English (en-US) Microsoft Visual C++ Redistributable packages for Visual Studio 2015, 2017, 2019, and 2022. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created using Visual Studio 2015, 2017, 2019, or 2022. +Redistribution is permitted only for licensed Visual Studio users, as described in the [Visual Studio license terms](https://visualstudio.microsoft.com/license-terms/). For details on redistributing Visual C++ files, see [Redistributing Visual C++ Files](redistributing-visual-cpp-files.md). -Unlike older versions of Visual Studio, which have infrequent redist updates, the version number isn't listed in the following table for Visual Studio 2015-2022 because the redist is updated frequently. To find the version number of the latest redist, download the redist you're interested in using one of the following links. Then, look at its properties using Windows File Explorer. In the **Details** pane, the **File version** contains the version of the redist. +A Visual C++ Redistributable installs Microsoft C and C++ (MSVC) runtime libraries. Many applications built using Microsoft C and C++ tools require these libraries. If your app is built using those libraries, a Microsoft Visual C++ Redistributable package at least as recent as the MSVC build toolset used to build your app must be installed on the target system along with the app. The Redistributable package architecture must match your app's target architecture (you can't install an ARM redistributable on an x86 system, or an x64 redistributable on an x86 system, for example). We recommend you use the latest Redistributable available for your version of Visual Studio, with some exceptions noted in this article. -## Latest Microsoft Visual C++ Redistributable version +## Visual Studio 2015-2022 -The latest version is `v14.44.35211.0` +This table lists the latest supported English (en-US) Microsoft Visual C++ Redistributable packages for Visual Studio 2015, 2017, 2019, and 2022. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created using Visual Studio 2015, 2017, 2019, or 2022. -Use the following links to download this version for each supported architecture: +Unlike older versions of Visual Studio that have infrequent redist updates, the version number isn't listed in the following table for Visual Studio 2015-2022 because the redist is updated frequently. To find the version number of the latest redist, download the redist you're interested in using one of the following links. Then, look at its properties using Windows File Explorer. In the **Details** pane, the **File version** contains the version of the redist. + +### Latest supported Redistributable version: | Architecture | Link | Notes | |--|--|--| @@ -46,31 +56,29 @@ Download other versions, including long term servicing release channel (LTSC) ve ### Notes - The Visual C++ Redistributable for Visual Studio 2015-2022 doesn't have separate packages for different languages. It contains EULAs for all supported languages. - - Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Log in using a Visual Studio Subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or, create a free account by choosing the **No account? Create one!** link. - - Visual Studio versions since Visual Studio 2015 share the same Redistributable files. For example, any apps built by the Visual Studio 2015, 2017, 2019, or 2022 toolsets can use the latest Microsoft Visual C++ Redistributable. However, the version of the Microsoft Visual C++ Redistributable installed on the machine must be the same or higher than the version of the Visual C++ toolset used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). - - **Windows XP Support**: Microsoft ended support for Windows XP on April 8, 2014. Current versions of the Visual C++ Redistributable for Visual Studio 2015-2022 only support Windows 7, 8.1, 10, and 11. The last version of the Visual C++ Redistributable that works on Windows XP shipped in Visual Studio 2019 version 16.7 (file versions starting with **14.27**). The Redistributable is available in the [my.visualstudio.com Downloads](https://my.visualstudio.com/Downloads/) section as **Visual C++ Redistributable for Visual Studio 2019 (version 16.7)**. Use the Search box to find this version. To download the files, select the platform and language you need, and then choose the **Download** button. - - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). -## Visual Studio 2013 (VC++ 12.0) (no longer supported) +## Unsupported legacy versions + +### Visual Studio 2013 (VC++ 12.0) (no longer supported) These links download the latest available en-US Microsoft Visual C++ Redistributable packages for Visual Studio 2013. You can download other versions and languages from [Update for Visual C++ 2013 Redistributable Package](https://support.microsoft.com/topic/update-for-visual-c-2013-redistributable-package-d8ccd6a5-4e26-c290-517b-8da6cfdf4f10) or from [my.visualstudio.com](https://my.visualstudio.com/). -| Architecture | Version | Link | +| Architecture | Version | Link | | ------------ | :----------: | ------------------------------------------------------: | | X86 | 12.0.40664.0 | [vcredist_x86.exe](https://aka.ms/highdpimfc2013x86enu) | | X64 | 12.0.40664.0 | [vcredist_x64.exe](https://aka.ms/highdpimfc2013x64enu) | -### Other versions +### Other 2013 versions - [Multibyte MFC Library for Visual Studio 2013](https://my.visualstudio.com/Downloads?pid=1430). This MFC add-on for Visual Studio 2013 contains the multibyte character set (MBCS) version of the Microsoft Foundation Class (MFC) Library. - [Visual C++ 2013 Runtime for Sideloaded Windows 8.1 apps](https://download.microsoft.com/download/5/f/0/5f0f8404-9329-44a9-8176-ed6f7f746f25/vclibs_redist_packages.zip). For more information, see [C++ Runtime for Sideloaded Windows 8.1 apps](https://devblogs.microsoft.com/cppblog/c-runtime-for-sideloaded-windows-8-1-apps/) on the C++ Team Blog. -## Visual Studio 2012 (VC++ 11.0) Update 4 (no longer supported) +### Visual Studio 2012 (VC++ 11.0) Update 4 (no longer supported) > [!NOTE] > Visual Studio 2012 [reached end of extended support on Jan 10, 2023](/lifecycle/products/visual-studio-2012) @@ -82,7 +90,7 @@ These links download the latest available en-US Microsoft Visual C++ Redistribut | X86 | 11.0.61030.0 | [en_visual_cpp_redistributable_for_visual_studio_2012_update_4_x86_3161523.exe](https://download.microsoft.com/download/1/6/B/16B06F60-3B20-4FF2-B699-5E9B7962F9AE/VSU_4/vcredist_x86.exe) | | X64 | 11.0.61030.0 | [en_visual_cpp_redistributable_for_visual_studio_2012_update_4_x64_3161523.exe](https://download.microsoft.com/download/1/6/B/16B06F60-3B20-4FF2-B699-5E9B7962F9AE/VSU_4/vcredist_x64.exe) | -## Visual Studio 2010 (VC++ 10.0) SP1 (no longer supported) +### Visual Studio 2010 (VC++ 10.0) SP1 (no longer supported) > [!NOTE] > Visual Studio 2010 Service Pack 1 [reached end of extended support on July 14, 2020](/lifecycle/products/visual-studio-2010) @@ -96,7 +104,7 @@ Download Redistributable files for other languages and architectures from: - [Microsoft Visual C++ 2010 SP1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26999) -## Visual Studio 2008 (VC++ 9.0) SP1 (no longer supported) +### Visual Studio 2008 (VC++ 9.0) SP1 (no longer supported) > [!NOTE] > Visual Studio 2008 Service Pack 1 [reached end of extended support on April 10, 2018](/lifecycle/products/visual-studio-2008) @@ -110,7 +118,7 @@ Download Redistributable files for other languages and architectures from: - [Microsoft Visual C++ 2008 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26368) -## Visual Studio 2005 (VC++ 8.0) SP1 (no longer supported) +### Visual Studio 2005 (VC++ 8.0) SP1 (no longer supported) > [!NOTE] > Visual Studio 2005 [reached end of extended support on April 12, 2016](/lifecycle/products/microsoft-visual-studio-2005) diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 97ba8cbcdd9..f96f06bd799 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -102,3 +102,6 @@ Links to examples that demonstrate how to deploy Visual C++ applications. [Deploying Desktop Applications](deploying-native-desktop-applications-visual-cpp.md)\ Introduces Visual C++ deployment concepts and technologies. + +[Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md)\ +Links to the latest supported Visual C++ Redistributable downloads. \ No newline at end of file From 7557e30c42598c90c517691d9a9a0a9fafecb020 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 25 Sep 2025 18:46:21 -0700 Subject: [PATCH 1298/1799] tweaks --- docs/windows/latest-supported-vc-redist.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index aaea9cfce78..d557a38efb2 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -20,11 +20,11 @@ ms.author: msaleh > [!NOTE] > Are you here to download Visual Studio? Go to [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/). -This topic is for developers who need to install the Visual C++ runtime libraries on the system that their apps runs on. If you're an end user trying to fix an app by updating the Visual C++ runtime libraries, contact the app vendor for instructions. +This topic is for developers who need to install the Visual C++ runtime libraries with their app. If you're an end user trying to fix an app by updating the Visual C++ runtime libraries, contact the app vendor for instructions. -To quickly find the download you need, choose your version of Visual Studio from the table below. Each link takes you to the appropriate download section. +To find the download you need, choose your version of Visual Studio from the table below. Each link takes you to the appropriate download section. -| Visual Studio version | Download section | +| Visual Studio version | Section | |--|--| | Latest supported (2015–2022) | [Latest supported Redistributable version](#latest-supported-redistributable-version) | | Visual Studio 2013 | [Visual Studio 2013 (VC++ 12.0)](#visual-studio-2013-vc-120-no-longer-supported) | From 8deb7d7579501895f82ec93b7fd26747bdbdcb3b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 25 Sep 2025 19:44:33 -0700 Subject: [PATCH 1299/1799] add note for vs 2022 --- docs/build/reference/fpcvt.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/build/reference/fpcvt.md b/docs/build/reference/fpcvt.md index 8661d649c92..30d2b7361b2 100644 --- a/docs/build/reference/fpcvt.md +++ b/docs/build/reference/fpcvt.md @@ -1,7 +1,7 @@ --- description: "Learn more about: /fpcvt (Floating-point to integer conversion compatibility)" title: "/fpcvt (Floating-point to unsigned integer conversion compatibility)" -ms.date: 11/03/2021 +ms.date: 09/25/2025 f1_keywords: ["/fpcvt", "-fpcvt"] helpviewer_keywords: ["-fpcvt compiler option [C++]", "/fpcvt compiler option [C++]"] --- @@ -30,6 +30,8 @@ In Visual Studio 2019 version 16.8 and later versions, the **`/fpcvt`** compiler For Visual Studio 2019, the default behavior for x64 targets is consistent with **`/fpcvt:BC`** unless **`/arch:AVX512`** is specified. Usually, the behavior for x86 targets is consistent with **`/fpcvt:IA`**, except under **`/arch:IA32`**, **`/arch:SSE`**, or sometimes where the result of a function call is directly converted to an unsigned integer. Use of **`/fpcvt`** overrides the default, so all conversions are handled consistently on either target. The behavior of conversions for ARM and ARM64 targets isn't consistent with either **`/fpcvt:BC`** or **`/fpcvt:IA`**. +Starting with Visual Studio 2022, the default behavior for x64 targets is consistent with `/fpcvt:BC` even when `/arch:AVX512` is specified. To use AVX512 conversion behavior with `/arch:AVX512`, specify `/fpcvt:IA`. + Standard C++ specifies that if a truncated floating-point value is exactly representable in an integer type, it must have that value when converted to that type. Otherwise, any behavior at all is allowed. Both **`/fpcvt`** options conform with Standard C++. The only difference is in what values are returned for invalid source values. The **`/fpcvt:IA`** option causes any invalid conversion to return a single *sentinel* value, which is the destination value farthest from zero. For conversion to signed types, the sentinel is the minimum value for that type. Unsigned types use the maximum value. Floating-point operations may return a Not-a-Number (NaN) value to indicate an invalid operation. That indicator isn't an option for conversion to integer types, which don't have NaN values. The sentinel is used as a proxy for a NaN value, although it can also be the result of a valid conversion. From 57d157830d8a117d053552d9b815205aab0d3b47 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 26 Sep 2025 18:14:21 +0800 Subject: [PATCH 1300/1799] Add "Remarks" headings for warning references in range [C26100, C26167] --- docs/code-quality/c26101.md | 2 ++ docs/code-quality/c26105.md | 2 ++ docs/code-quality/c26110.md | 2 ++ docs/code-quality/c26111.md | 2 ++ docs/code-quality/c26112.md | 2 ++ docs/code-quality/c26115.md | 2 ++ docs/code-quality/c26117.md | 2 ++ docs/code-quality/c26130.md | 2 ++ docs/code-quality/c26135.md | 2 ++ docs/code-quality/c26160.md | 2 ++ docs/code-quality/c26165.md | 2 ++ docs/code-quality/c26166.md | 2 ++ docs/code-quality/c26167.md | 2 ++ 13 files changed, 26 insertions(+) diff --git a/docs/code-quality/c26101.md b/docs/code-quality/c26101.md index aefe6357eb3..73572cf80f8 100644 --- a/docs/code-quality/c26101.md +++ b/docs/code-quality/c26101.md @@ -10,6 +10,8 @@ ms.assetid: 86046553-09ec-40ce-82b3-fd641928f0b0 > Failing to use interlocked operation properly for variable '*var*'. +## Remarks + Windows APIs offer various interlocked operations. Annotation `_Interlocked_` specifies that a variable should only be accessed through an interlocked operation. Warning C26101 is issued when a variable access isn't consistent with the `_Interlocked_` annotation. ## Example diff --git a/docs/code-quality/c26105.md b/docs/code-quality/c26105.md index 72dbc32d32a..e99176a6169 100644 --- a/docs/code-quality/c26105.md +++ b/docs/code-quality/c26105.md @@ -10,6 +10,8 @@ ms.assetid: 5558a3db-0513-43b4-8579-ccdc17e2b92f > Lock order violation. Acquiring lock '*lock*' with level '*level*' causes order inversion. +## Remarks + Concurrency SAL supports *lock levels*. To declare a lock level, which is denoted by a string literal without double quotes, use `_Create_lock_level_`. You can impose an order of acquisition between two lock levels by using the annotation `_Set_lock_level_order_(A,B)`, which states that locks that have level `A` must be acquired before locks that have level `B`. To establish a lock order hierarchy (a partial order among lock levels), use multiple `_Set_lock_level_order_` annotations. To associate a lock with a lock level, use the `_Set_lock_level_` annotation when you declare the lock. Warning C26105 is issued when a lock ordering violation is detected. ## Example diff --git a/docs/code-quality/c26110.md b/docs/code-quality/c26110.md index d1981b15768..ff34b83e1f4 100644 --- a/docs/code-quality/c26110.md +++ b/docs/code-quality/c26110.md @@ -10,6 +10,8 @@ ms.assetid: d82b79ec-6d7f-438b-bd6a-da874a3e08e5 > Caller failing to hold lock '*lock*' before calling function '*func*'. +## Remarks + When a lock is required, make sure to clarify whether the function itself, or its caller, should acquire the lock. Warning C26110 is issued when there's a violation of the `_Requires_lock_held_` annotation, or other lock-related annotations. For more information, see [Annotating Locking Behavior](annotating-locking-behavior.md) ## Example diff --git a/docs/code-quality/c26111.md b/docs/code-quality/c26111.md index 5fdbec7c476..326529c0428 100644 --- a/docs/code-quality/c26111.md +++ b/docs/code-quality/c26111.md @@ -10,6 +10,8 @@ ms.assetid: 85fc740a-3bbb-41b8-a848-95e243a08da9 > Caller failing to release lock '*lock*' before calling function '*func*'. +## Remarks + The annotation `_Requires_lock_not_held_` imposes a precondition that the lock count for the specified lock can't be greater than zero when the function is called. Warning C26111 is issued when a function fails to release the lock before it calls another function. ## Example diff --git a/docs/code-quality/c26112.md b/docs/code-quality/c26112.md index 7794bf4ef5b..683cc6eeee3 100644 --- a/docs/code-quality/c26112.md +++ b/docs/code-quality/c26112.md @@ -10,6 +10,8 @@ ms.assetid: 926de738-b9b0-43d7-9137-ab2daa44ad4d > Caller cannot hold any lock before calling '*func*'. +## Remarks + The annotation `_Requires_no_locks_held_` imposes a precondition that the caller must not hold any lock while it calls the function. Warning C26112 is issued when a function fails to release all locks before it calls another function. ## Example diff --git a/docs/code-quality/c26115.md b/docs/code-quality/c26115.md index 402dd0aea97..1fd85a631f5 100644 --- a/docs/code-quality/c26115.md +++ b/docs/code-quality/c26115.md @@ -10,6 +10,8 @@ ms.assetid: 3977a2bb-d1fe-4510-89dd-07fdc69e911c > Failing to release lock '*lock*' in function '*func*'. +## Remarks + Enforcement of syntactically scoped lock *acquire* and lock *release* pairs in C/C++ programs isn't performed by the language. A function may introduce a locking side effect by making an observable modification to the concurrency state. For example, a lock wrapper function increments the number of lock acquisitions, or lock count, for a given lock. You can annotate a function that has a side effect from a lock acquire or lock release by using `_Acquires_lock_` or `_Releases_lock_`, respectively. Without such annotations, a function is expected not to change any lock count after it returns. If acquires and releases aren't balanced, they're considered to be *orphaned*. Warning C26115 is issued when a function introduces an orphaned lock. diff --git a/docs/code-quality/c26117.md b/docs/code-quality/c26117.md index 235b47f14f4..7678d030ee7 100644 --- a/docs/code-quality/c26117.md +++ b/docs/code-quality/c26117.md @@ -10,6 +10,8 @@ ms.assetid: cc7ebc8d-9826-4cad-a4d5-2d3ad5896734 > Releasing unheld lock '*lock*' in function '*func*'. +## Remarks + Enforcement of syntactically scoped lock *acquire* and lock *release* pairs in C/C++ programs isn't performed by the language. A function may introduce a locking side effect by making an observable modification to the concurrency state. For example, a lock wrapper function increments the number of lock acquisitions, or lock count, for a given lock. You can annotate a function that has a side effect from a lock acquire or lock release by using `_Acquires_lock_` or `_Releases_lock_`, respectively. Without such annotations, a function is expected not to change any lock count after it returns. If acquires and releases aren't balanced, they're considered to be *orphaned*. Warning C26117 is issued when a function that hasn't been annotated with `_Releases_lock_` releases a lock that it doesn't hold, because the function must own the lock before it releases it. ## Examples diff --git a/docs/code-quality/c26130.md b/docs/code-quality/c26130.md index fb1912520c6..2f17638b274 100644 --- a/docs/code-quality/c26130.md +++ b/docs/code-quality/c26130.md @@ -10,6 +10,8 @@ ms.assetid: 535e2356-bc84-4549-983d-7d29aee2249c > Missing annotation \_Requires\_lock\_held\_('*lock*') or \_No\_competing\_thread\_ at function '*func*'. Otherwise it could be a race condition. Variable '*var*' should be protected by lock '*lock*'. +## Remarks + Warning C26130 is issued when the analyzer detects a potential race condition but infers that the function is likely to be run in a single threaded mode. For example, when the function is in the initialization stage, based on certain heuristics. ## Examples diff --git a/docs/code-quality/c26135.md b/docs/code-quality/c26135.md index 96db147d013..4f9b9f55578 100644 --- a/docs/code-quality/c26135.md +++ b/docs/code-quality/c26135.md @@ -10,6 +10,8 @@ ms.assetid: e9515189-8d21-473b-89f4-8b92ebd3a4f1 > Missing annotation '*annotation*' at function '*func*'. +## Remarks + Warning C26135 is issued when the analyzer infers that a function is a lock wrapper function that has a "lock acquire" or "lock release" side effect. If the code isn't intended to be a wrapper function, then either the lock is leaking (if it's being acquired), or it's being released incorrectly (if the lock is being released). ## Examples diff --git a/docs/code-quality/c26160.md b/docs/code-quality/c26160.md index 2d8df17126b..92fe961b146 100644 --- a/docs/code-quality/c26160.md +++ b/docs/code-quality/c26160.md @@ -10,6 +10,8 @@ ms.assetid: e6518687-36b4-4eae-a732-758881638295 > Caller possibly failing to hold lock '*lock*' before calling function '*func*'. +## Remarks + Warning C26160 resembles warning [C26110](../code-quality/c26110.md) except that the confidence level is lower. For example, the function may contain annotation errors. ## Examples diff --git a/docs/code-quality/c26165.md b/docs/code-quality/c26165.md index 973b4745d96..684a10f0e43 100644 --- a/docs/code-quality/c26165.md +++ b/docs/code-quality/c26165.md @@ -10,6 +10,8 @@ ms.assetid: a1d89bd6-08f3-4215-8a0c-b8ecfeb0cffc > Possibly failing to release lock '*lock*' in function '*func*'. +## Remarks + Warning C26165 resembles warning [C26115](../code-quality/c26115.md) except that the confidence level is lower. For example, the function may contain annotation errors. ## Examples diff --git a/docs/code-quality/c26166.md b/docs/code-quality/c26166.md index 04809e0a941..139f22bf559 100644 --- a/docs/code-quality/c26166.md +++ b/docs/code-quality/c26166.md @@ -10,6 +10,8 @@ ms.assetid: a3d21838-07da-40f6-8d2e-1ada72765af2 > Possibly failing to acquire or to hold lock '*lock*' in function '*func*'. +## Remarks + Warning C26166 resembles warning [C26116](../code-quality/c26116.md) except that the confidence level is lower. For example, the function may contain annotation errors. ## Example diff --git a/docs/code-quality/c26167.md b/docs/code-quality/c26167.md index 8e7eea235ba..24c07fc7e1e 100644 --- a/docs/code-quality/c26167.md +++ b/docs/code-quality/c26167.md @@ -10,6 +10,8 @@ ms.assetid: 5a3d767f-31fa-45e0-8c9b-1aa776acaa45 > Possibly releasing unheld lock '*lock*' in function '*func*'. +## Remarks + Warning C26167 resembles warning [C26117](../code-quality/c26117.md) except that the confidence level is lower. For example, the function may contain annotation errors. ## Examples From 1e38532b82816a2e5b4c2f1ddd627b9311c8ba33 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Fri, 26 Sep 2025 18:19:28 +0800 Subject: [PATCH 1301/1799] Update metadata for warning references in range [C26100, C26167] --- docs/code-quality/c26100.md | 3 +-- docs/code-quality/c26101.md | 3 +-- docs/code-quality/c26105.md | 3 +-- docs/code-quality/c26110.md | 3 +-- docs/code-quality/c26111.md | 3 +-- docs/code-quality/c26112.md | 3 +-- docs/code-quality/c26115.md | 3 +-- docs/code-quality/c26117.md | 3 +-- docs/code-quality/c26130.md | 3 +-- docs/code-quality/c26135.md | 3 +-- docs/code-quality/c26138.md | 2 +- docs/code-quality/c26140.md | 3 +-- docs/code-quality/c26160.md | 3 +-- docs/code-quality/c26165.md | 3 +-- docs/code-quality/c26166.md | 3 +-- docs/code-quality/c26167.md | 3 +-- 16 files changed, 16 insertions(+), 31 deletions(-) diff --git a/docs/code-quality/c26100.md b/docs/code-quality/c26100.md index f3ab41f0209..c0a64ac0408 100644 --- a/docs/code-quality/c26100.md +++ b/docs/code-quality/c26100.md @@ -1,10 +1,9 @@ --- +title: "Warning C26100" description: "Learn more about: Warning C26100" -title: Warning C26100 ms.date: 11/04/2016 f1_keywords: ["C26100", "RACE_CONDITION", "__WARNING_RACE_CONDITION"] helpviewer_keywords: ["C26100"] -ms.assetid: 470ab2b2-5b55-424f-b192-3863a773c892 --- # Warning C26100 diff --git a/docs/code-quality/c26101.md b/docs/code-quality/c26101.md index 73572cf80f8..c89fbe4543c 100644 --- a/docs/code-quality/c26101.md +++ b/docs/code-quality/c26101.md @@ -1,10 +1,9 @@ --- +title: "Warning C26101" description: "Learn more about: Warning C26101" -title: Warning C26101 ms.date: 11/04/2016 f1_keywords: ["C26101"] helpviewer_keywords: ["C26101"] -ms.assetid: 86046553-09ec-40ce-82b3-fd641928f0b0 --- # Warning C26101 diff --git a/docs/code-quality/c26105.md b/docs/code-quality/c26105.md index e99176a6169..0381c3feec2 100644 --- a/docs/code-quality/c26105.md +++ b/docs/code-quality/c26105.md @@ -1,10 +1,9 @@ --- +title: "Warning C26105" description: "Learn more about: Warning C26105" -title: Warning C26105 ms.date: 11/04/2016 f1_keywords: ["C26105"] helpviewer_keywords: ["C26105"] -ms.assetid: 5558a3db-0513-43b4-8579-ccdc17e2b92f --- # Warning C26105 diff --git a/docs/code-quality/c26110.md b/docs/code-quality/c26110.md index ff34b83e1f4..67d89e3cefe 100644 --- a/docs/code-quality/c26110.md +++ b/docs/code-quality/c26110.md @@ -1,10 +1,9 @@ --- +title: "Warning C26110" description: "Learn more about: Warning C26110" -title: Warning C26110 ms.date: 10/01/2019 f1_keywords: ["C26110"] helpviewer_keywords: ["C26110"] -ms.assetid: d82b79ec-6d7f-438b-bd6a-da874a3e08e5 --- # Warning C26110 diff --git a/docs/code-quality/c26111.md b/docs/code-quality/c26111.md index 326529c0428..c7bf8bee694 100644 --- a/docs/code-quality/c26111.md +++ b/docs/code-quality/c26111.md @@ -1,10 +1,9 @@ --- +title: "Warning C26111" description: "Learn more about: Warning C26111" -title: Warning C26111 ms.date: 11/04/2016 f1_keywords: ["C26111"] helpviewer_keywords: ["C26111"] -ms.assetid: 85fc740a-3bbb-41b8-a848-95e243a08da9 --- # Warning C26111 diff --git a/docs/code-quality/c26112.md b/docs/code-quality/c26112.md index 683cc6eeee3..58554638b08 100644 --- a/docs/code-quality/c26112.md +++ b/docs/code-quality/c26112.md @@ -1,10 +1,9 @@ --- +title: "Warning C26112" description: "Learn more about: Warning C26112" -title: Warning C26112 ms.date: 11/04/2016 f1_keywords: ["C26112"] helpviewer_keywords: ["C26112"] -ms.assetid: 926de738-b9b0-43d7-9137-ab2daa44ad4d --- # Warning C26112 diff --git a/docs/code-quality/c26115.md b/docs/code-quality/c26115.md index 1fd85a631f5..3c634459d07 100644 --- a/docs/code-quality/c26115.md +++ b/docs/code-quality/c26115.md @@ -1,10 +1,9 @@ --- +title: "Warning C26115" description: "Learn more about: Warning C26115" -title: Warning C26115 ms.date: 11/04/2016 f1_keywords: ["C26115"] helpviewer_keywords: ["C26115"] -ms.assetid: 3977a2bb-d1fe-4510-89dd-07fdc69e911c --- # Warning C26115 diff --git a/docs/code-quality/c26117.md b/docs/code-quality/c26117.md index 7678d030ee7..16ebb6bff74 100644 --- a/docs/code-quality/c26117.md +++ b/docs/code-quality/c26117.md @@ -1,10 +1,9 @@ --- +title: "Warning C26117" description: "Learn more about: Warning C26117" -title: Warning C26117 ms.date: 11/04/2016 f1_keywords: ["C26117"] helpviewer_keywords: ["C26117"] -ms.assetid: cc7ebc8d-9826-4cad-a4d5-2d3ad5896734 --- # Warning C26117 diff --git a/docs/code-quality/c26130.md b/docs/code-quality/c26130.md index 2f17638b274..990d87c2b3e 100644 --- a/docs/code-quality/c26130.md +++ b/docs/code-quality/c26130.md @@ -1,10 +1,9 @@ --- +title: "Warning C26130" description: "Learn more about: Warning C26130" -title: Warning C26130 ms.date: 11/04/2016 f1_keywords: ["C26130"] helpviewer_keywords: ["C26130"] -ms.assetid: 535e2356-bc84-4549-983d-7d29aee2249c --- # Warning C26130 diff --git a/docs/code-quality/c26135.md b/docs/code-quality/c26135.md index 4f9b9f55578..aee06179d65 100644 --- a/docs/code-quality/c26135.md +++ b/docs/code-quality/c26135.md @@ -1,10 +1,9 @@ --- +title: "Warning C26135" description: "Learn more about: Warning C26135" -title: Warning C26135 ms.date: 11/04/2016 f1_keywords: ["C26135"] helpviewer_keywords: ["C26135"] -ms.assetid: e9515189-8d21-473b-89f4-8b92ebd3a4f1 --- # Warning C26135 diff --git a/docs/code-quality/c26138.md b/docs/code-quality/c26138.md index 08c847a5b02..12838bac4d8 100644 --- a/docs/code-quality/c26138.md +++ b/docs/code-quality/c26138.md @@ -1,6 +1,6 @@ --- +title: "Warning C26138" description: "Learn more about: Warning C26138" -title: Warning C26138 ms.date: 01/14/2019 f1_keywords: ["C26138", "SUSPENDED_WITH_LOCK"] helpviewer_keywords: ["C26138"] diff --git a/docs/code-quality/c26140.md b/docs/code-quality/c26140.md index dd11953d3e0..33e63f3b518 100644 --- a/docs/code-quality/c26140.md +++ b/docs/code-quality/c26140.md @@ -1,10 +1,9 @@ --- +title: "Warning C26140" description: "Learn more about: Warning C26140" -title: Warning C26140 ms.date: 11/04/2016 f1_keywords: ["C26140"] helpviewer_keywords: ["C26140"] -ms.assetid: a0b521b4-0c2f-470a-8904-f7bbb8014536 --- # Warning C26140 diff --git a/docs/code-quality/c26160.md b/docs/code-quality/c26160.md index 92fe961b146..9fb21be939c 100644 --- a/docs/code-quality/c26160.md +++ b/docs/code-quality/c26160.md @@ -1,10 +1,9 @@ --- +title: "Warning C26160" description: "Learn more about: Warning C26160" -title: Warning C26160 ms.date: 11/04/2016 f1_keywords: ["C26160"] helpviewer_keywords: ["C26160"] -ms.assetid: e6518687-36b4-4eae-a732-758881638295 --- # Warning C26160 diff --git a/docs/code-quality/c26165.md b/docs/code-quality/c26165.md index 684a10f0e43..a87f5b15e94 100644 --- a/docs/code-quality/c26165.md +++ b/docs/code-quality/c26165.md @@ -1,10 +1,9 @@ --- +title: "Warning C26165" description: "Learn more about: Warning C26165" -title: Warning C26165 ms.date: 11/04/2016 f1_keywords: ["C26165"] helpviewer_keywords: ["C26165"] -ms.assetid: a1d89bd6-08f3-4215-8a0c-b8ecfeb0cffc --- # Warning C26165 diff --git a/docs/code-quality/c26166.md b/docs/code-quality/c26166.md index 139f22bf559..93176e6a086 100644 --- a/docs/code-quality/c26166.md +++ b/docs/code-quality/c26166.md @@ -1,10 +1,9 @@ --- +title: "Warning C26166" description: "Learn more about: Warning C26166" -title: Warning C26166 ms.date: 11/04/2016 f1_keywords: ["C26166"] helpviewer_keywords: ["C26166"] -ms.assetid: a3d21838-07da-40f6-8d2e-1ada72765af2 --- # Warning C26166 diff --git a/docs/code-quality/c26167.md b/docs/code-quality/c26167.md index 24c07fc7e1e..24c4e950d2e 100644 --- a/docs/code-quality/c26167.md +++ b/docs/code-quality/c26167.md @@ -1,10 +1,9 @@ --- +title: "Warning C26167" description: "Learn more about: Warning C26167" -title: Warning C26167 ms.date: 11/04/2016 f1_keywords: ["C26167"] helpviewer_keywords: ["C26167"] -ms.assetid: 5a3d767f-31fa-45e0-8c9b-1aa776acaa45 --- # Warning C26167 From 4032d5af0cb4818ffd4372e38a62d562cfbc39ee Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 27 Sep 2025 00:06:48 +0800 Subject: [PATCH 1302/1799] Remove stray backslash in "Multiple Base Classes" topic --- docs/cpp/multiple-base-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/multiple-base-classes.md b/docs/cpp/multiple-base-classes.md index 2ed89233621..1308afc2695 100644 --- a/docs/cpp/multiple-base-classes.md +++ b/docs/cpp/multiple-base-classes.md @@ -96,7 +96,7 @@ The `/vd` compiler option affects an entire compilation module. Use the `vtordis ```cpp #pragma vtordisp( off ) class GetReal : virtual public { ... }; -\#pragma vtordisp( on ) +#pragma vtordisp( on ) ``` ## Name ambiguities From c98f946a4baa910d6b347c797d82fcb2c43e1690 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 27 Sep 2025 00:09:11 +0800 Subject: [PATCH 1303/1799] Nits for "Multiple Base Classes" topic --- docs/cpp/multiple-base-classes.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/cpp/multiple-base-classes.md b/docs/cpp/multiple-base-classes.md index 1308afc2695..54565970f28 100644 --- a/docs/cpp/multiple-base-classes.md +++ b/docs/cpp/multiple-base-classes.md @@ -11,8 +11,7 @@ A class can be derived from more than one base class. In a multiple-inheritance ```cpp // deriv_MultipleBaseClasses.cpp // compile with: /LD -class Collection { -}; +class Collection {}; class Book {}; class CollectionOfBook : public Book, public Collection { // New members @@ -26,7 +25,7 @@ The order in which base classes are specified isn't significant except in certai - The order in which destructors are invoked to clean up. Again, if a particular "part" of the class must be present when the other part is being destroyed, the order is significant. Destructors are called in the reverse order of the classes specified in the *base-list*. > [!NOTE] - > The order of specification of base classes can affect the memory layout of the class. Do not make any programming decisions based on the order of base members in memory. + > The order of specification of base classes can affect the memory layout of the class. Do not make any programming decisions based on the order of base members in memory. When specifying the *base-list*, you can't specify the same class name more than once. However, it's possible for a class to be an indirect base to a derived class more than once. @@ -188,7 +187,7 @@ Explicit and implicit conversions from pointers or references to class types can - The declaration of an object of type `D`. -- The effect of applying the address-of operator (**&**) to that object. The address-of operator always supplies the base address of the object. +- The effect of applying the address-of operator (`&`) to that object. The address-of operator always supplies the base address of the object. - The effect of explicitly converting the pointer obtained using the address-of operator to the base-class type `A`. Coercing the address of the object to type `A*` doesn't always provide the compiler with enough information as to which subobject of type `A` to select; in this case, two subobjects exist. From 2c564280ac2d03c8e52be0bfe19688b371b1373a Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 27 Sep 2025 00:11:25 +0800 Subject: [PATCH 1304/1799] Simplify redundant relative links in "Multiple Base Classes" topic --- docs/cpp/multiple-base-classes.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/cpp/multiple-base-classes.md b/docs/cpp/multiple-base-classes.md index 54565970f28..55314b726c7 100644 --- a/docs/cpp/multiple-base-classes.md +++ b/docs/cpp/multiple-base-classes.md @@ -41,14 +41,14 @@ When declaring a virtual base class, the **`virtual`** keyword appears in the ba Consider the class hierarchy in the following figure, which illustrates a simulated lunch line: -:::image type="complex" source="../cpp/media/vc38xp1.gif" alt-text="Diagram of a simulated lunch line." border="false"::: +:::image type="complex" source="media/vc38xp1.gif" alt-text="Diagram of a simulated lunch line." border="false"::: The base class is Queue. Cashier Queue and Lunch Queue both inherit from Queue. Finally, Lunch Cashier Queue inherits from both Cashier Queue and Lunch Queue. :::image-end::: *Simulated lunch-line graph* In the figure, `Queue` is the base class for both `CashierQueue` and `LunchQueue`. However, when both classes are combined to form `LunchCashierQueue`, the following problem arises: the new class contains two subobjects of type `Queue`, one from `CashierQueue` and the other from `LunchQueue`. The following figure shows the conceptual memory layout (the actual memory layout might be optimized): -:::image type="complex" source="../cpp/media/vc38xp2.gif" alt-text="Diagram of a simulated lunch line object." border="false"::: +:::image type="complex" source="media/vc38xp2.gif" alt-text="Diagram of a simulated lunch line object." border="false"::: The figure shows a Lunch Cashier Queue object with two subobjects in it: Cashier Queue and Lunch Queue. Both Cashier Queue and Lunch Queue contain a Queue subobject." :::image-end::: *Simulated lunch-line object* @@ -66,21 +66,21 @@ class LunchCashierQueue : public LunchQueue, public CashierQueue {}; The **`virtual`** keyword ensures that only one copy of the subobject `Queue` is included (see the following figure). -:::image type="complex" source="../cpp/media/vc38xp3.gif" alt-text="Diagram of a simulated lunch line object, with virtual base classes depicted." border="false"::: +:::image type="complex" source="media/vc38xp3.gif" alt-text="Diagram of a simulated lunch line object, with virtual base classes depicted." border="false"::: The diagram shows a Lunch Cashier Queue object, which contains a Cashier Queue subobject and a Lunch Queue subobject. Both Cashier Queue and Lunch Queue share the same Queue subobject. :::image-end::: *Simulated lunch-line object with virtual base classes* A class can have both a virtual component and a nonvirtual component of a given type. This happens in the conditions illustrated in the following figure: -:::image type="complex" source="../cpp/media/vc38xp4.gif" alt-text="Diagram of virtual and non virtual components of a class." border="false"::: +:::image type="complex" source="media/vc38xp4.gif" alt-text="Diagram of virtual and non virtual components of a class." border="false"::: The diagram shows a queue base class. A Cashier Queue class and Lunch Queue class inherit virtually from Queue. A third class, Takeout Queue, inherits non virtually from queue. Lunch Cashier Queue inherits from both Cashier Queue and Lunch Queue. Lunch Takeout Cashier Queue inherits from both Lunch Cashier Queue and Takeout Queue. :::image-end::: *Virtual and nonvirtual components of the same class* In the figure, `CashierQueue` and `LunchQueue` use `Queue` as a virtual base class. However, `TakeoutQueue` specifies `Queue` as a base class, not a virtual base class. Therefore, `LunchTakeoutCashierQueue` has two subobjects of type `Queue`: one from the inheritance path that includes `LunchCashierQueue` and one from the path that includes `TakeoutQueue`. This is illustrated in the following figure. -:::image type="complex" source="../cpp/media/vc38xp5.gif" alt-text="Diagram of the object layout for virtual and non virtual inheritance." border="false"::: +:::image type="complex" source="media/vc38xp5.gif" alt-text="Diagram of the object layout for virtual and non virtual inheritance." border="false"::: A Lunch Takeout Cashier Queue object is shown that contains two subobjects: a Takeout Queue (which contains a Queue subobject) and a Lunch Cashier Queue. The Lunch Cashier Queue subobject contains a Cashier Queue subobject and a Lunch Queue subobject, both of which share a Queue sub object. :::image-end::: *Object layout with virtual and nonvirtual inheritance* @@ -141,7 +141,7 @@ The compiler detects ambiguities by performing tests in this order: 1. If overloaded functions are unambiguous, they're resolved. -1. If access to the name violates member-access permission, an error message is generated. For more information, see [Member-Access Control](../cpp/member-access-control-cpp.md). +1. If access to the name violates member-access permission, an error message is generated. For more information, see [Member-Access Control](member-access-control-cpp.md). When an expression produces an ambiguity through inheritance, you can manually resolve it by qualifying the name in question with its class name. To make the preceding example compile properly with no ambiguities, use code such as: @@ -191,7 +191,7 @@ Explicit and implicit conversions from pointers or references to class types can - The effect of explicitly converting the pointer obtained using the address-of operator to the base-class type `A`. Coercing the address of the object to type `A*` doesn't always provide the compiler with enough information as to which subobject of type `A` to select; in this case, two subobjects exist. -:::image type="complex" source="../cpp/media/vc38xt1.gif" alt-text="Diagram showing how the conversion of pointers to base classes can be ambiguous." border="false"::: +:::image type="complex" source="media/vc38xt1.gif" alt-text="Diagram showing how the conversion of pointers to base classes can be ambiguous." border="false"::: The diagram first shows an inheritance hierarchy: A is the base class. B and C inherit from A. D inherits from B and C. Then, the memory layout is shown for object D. There are three subobjects in D: B (which includes a subobject A) and C (which includes a subobject A). The code & d points to the A in subobject B. The code ( * A ) & d points to both subobject B and subobject C. :::image-end::: *Ambiguous conversion of pointers to base classes* @@ -209,7 +209,7 @@ If virtual base classes are used, functions, objects, types, and enumerators can The following figure shows how objects are composed using virtual and nonvirtual inheritance. -:::image type="complex" source="../cpp/media/vc38xr1.gif" alt-text="Diagram showing virtual derivation and nonvirtual derivation." border="false"::: +:::image type="complex" source="media/vc38xr1.gif" alt-text="Diagram showing virtual derivation and nonvirtual derivation." border="false"::: The diagram first shows an inheritance hierarchy: A is the base class. B and C virtually inherit from A. D virtually inherits from B and C. Then, the layout of D is shown. D contains subobjects B and C, which share subobject A. Then the layout is shown as though the same hierarchy had been derived using nonvirtual inheritance. In that case, D contains the subobjects B and C. Both B and C contain their own copy of subobject A. :::image-end::: *Virtual and nonvirtual derivation* @@ -218,4 +218,4 @@ In the figure, accessing any member of class `A` through nonvirtual base classes ## See also -[Inheritance](../cpp/inheritance-cpp.md) +[Inheritance](inheritance-cpp.md) From 5b953218f68c79b5ae47d01948a289303a9430cd Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 27 Sep 2025 00:39:57 +0800 Subject: [PATCH 1305/1799] Add "Remarks" headings for warning references in range [C26800, C26830] --- docs/code-quality/c26817.md | 2 ++ docs/code-quality/c26820.md | 4 ++-- docs/code-quality/c26826.md | 4 ++-- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/code-quality/c26817.md b/docs/code-quality/c26817.md index 470b699dd2e..616e4876f1f 100644 --- a/docs/code-quality/c26817.md +++ b/docs/code-quality/c26817.md @@ -9,6 +9,8 @@ helpviewer_keywords: ["C26817"] > Potentially expensive copy of variable *name* in range-for loop. Consider making it a const reference (es.71). +## Remarks + For more information, see [ES.71: Prefer a range-`for`-statement to a `for`-statement when there is a choice](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-for-range) in the C++ Core Guidelines. ## Example diff --git a/docs/code-quality/c26820.md b/docs/code-quality/c26820.md index 291f3abc21c..db7807cbf4c 100644 --- a/docs/code-quality/c26820.md +++ b/docs/code-quality/c26820.md @@ -9,12 +9,12 @@ helpviewer_keywords: ["C26820"] > This is a potentially expensive copy operation. Consider using a reference unless a copy is required (p.9) +## Remarks + For more information, see [P.9: Don't waste time or space](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rp-waste) in the C++ Core Guidelines. This check covers nonobvious and easy-to-miss behavior when assigning a reference to a variable marked **`auto`**. The type of the **`auto`** variable is resolved to a value rather than a reference, and an implicit copy is made. -## Remarks - - This warning isn't raised for scalars, smart pointers, or views. It's also not raised for types whose size isn't more than twice the platform-dependent pointer size. - This warning isn't raised when the variable gets mutated, as marking it `auto&` would introduce side-effects to the mutation. - This warning isn't raised when the reference comes from a temporary object, because that results in a dangling reference. For example: diff --git a/docs/code-quality/c26826.md b/docs/code-quality/c26826.md index 8c0f827e9d5..4015cf675e4 100644 --- a/docs/code-quality/c26826.md +++ b/docs/code-quality/c26826.md @@ -9,10 +9,10 @@ helpviewer_keywords: ["C26826"] > Don't use C-style variable arguments (f.55). -For more information, see [F.55: Don't use `va_arg` arguments](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#F-varargs) in the C++ Core Guidelines. - ## Remarks +For more information, see [F.55: Don't use `va_arg` arguments](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#F-varargs) in the C++ Core Guidelines. + This check warns on all usages of `va_list`, `va_start`, `va_arg`, and `va_end`, discouraging the use of C-style variable arguments. C-style variable arguments are unsafe because they require the programmer to assume that the arguments are all passed and read with the correct types. Warning C26826 is available starting in Visual Studio 2022 version 17.1. From a8a8761acd51224b938a55b709922813488940b4 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 27 Sep 2025 00:42:35 +0800 Subject: [PATCH 1306/1799] Update metadata for warning references in range [C26800, C26830] --- docs/code-quality/c26800.md | 2 +- docs/code-quality/c26810.md | 2 +- docs/code-quality/c26811.md | 2 +- docs/code-quality/c26812.md | 2 +- docs/code-quality/c26813.md | 2 +- docs/code-quality/c26814.md | 2 +- docs/code-quality/c26815.md | 4 ++-- docs/code-quality/c26816.md | 4 ++-- docs/code-quality/c26817.md | 2 +- docs/code-quality/c26818.md | 2 +- docs/code-quality/c26819.md | 2 +- docs/code-quality/c26820.md | 2 +- docs/code-quality/c26822.md | 2 +- docs/code-quality/c26823.md | 2 +- docs/code-quality/c26824.md | 2 +- docs/code-quality/c26825.md | 2 +- docs/code-quality/c26826.md | 2 +- docs/code-quality/c26827.md | 2 +- docs/code-quality/c26828.md | 2 +- docs/code-quality/c26829.md | 2 +- docs/code-quality/c26830.md | 2 +- 21 files changed, 23 insertions(+), 23 deletions(-) diff --git a/docs/code-quality/c26800.md b/docs/code-quality/c26800.md index 1052f0f0db6..81d9a17805f 100644 --- a/docs/code-quality/c26800.md +++ b/docs/code-quality/c26800.md @@ -1,5 +1,5 @@ --- -title: Warning C26800 +title: "Warning C26800" description: "Learn more about: Warning C26800" ms.date: 01/14/2019 f1_keywords: ["C26800", "USE_OF_A_MOVED_FROM_OBJECT"] diff --git a/docs/code-quality/c26810.md b/docs/code-quality/c26810.md index 95c9c836440..027f55e32eb 100644 --- a/docs/code-quality/c26810.md +++ b/docs/code-quality/c26810.md @@ -1,5 +1,5 @@ --- -title: Warning C26810 +title: "Warning C26810" description: "Learn more about: Warning C26810." ms.date: 05/11/2023 f1_keywords: ["C26810", "COROUTINES_USE_AFTER_FREE_CAPTURE"] diff --git a/docs/code-quality/c26811.md b/docs/code-quality/c26811.md index ebdc5bcc40c..7651fbbf469 100644 --- a/docs/code-quality/c26811.md +++ b/docs/code-quality/c26811.md @@ -1,5 +1,5 @@ --- -title: Warning C26811 +title: "Warning C26811" description: "Learn more about: Warning C26811." ms.date: 05/11/2023 f1_keywords: ["C26811", "COROUTINES_USE_AFTER_FREE_PARAM"] diff --git a/docs/code-quality/c26812.md b/docs/code-quality/c26812.md index d7a3ef1038b..3ea3543dc18 100644 --- a/docs/code-quality/c26812.md +++ b/docs/code-quality/c26812.md @@ -1,6 +1,6 @@ --- +title: "Warning C26812" description: "Learn more about: Warning C26812" -title: Warning C26812 ms.date: 02/14/2022 f1_keywords: ["C26812", "PreferScopedEnum"] helpviewer_keywords: ["C26812"] diff --git a/docs/code-quality/c26813.md b/docs/code-quality/c26813.md index eabce1bfec4..cbaa14e3863 100644 --- a/docs/code-quality/c26813.md +++ b/docs/code-quality/c26813.md @@ -1,5 +1,5 @@ --- -title: Warning C26813 +title: "Warning C26813" description: "Learn more about: Warning C26813" ms.date: 05/17/2022 f1_keywords: ["C26813", "USE_BITWISE_AND_TO_CHEK_ENUM_FLAGS", "USE_BITWISE_AND_TO_CHECK_ENUM_FLAGS"] diff --git a/docs/code-quality/c26814.md b/docs/code-quality/c26814.md index f446f2644b0..363b3c50732 100644 --- a/docs/code-quality/c26814.md +++ b/docs/code-quality/c26814.md @@ -1,6 +1,6 @@ --- +title: "Warning C26814" description: "Learn more about: Warning C26814" -title: Warning C26814 ms.date: 07/15/2019 f1_keywords: ["C26814", "USE_CONSTEXPR_RATHER_THAN_CONST"] helpviewer_keywords: ["C26814"] diff --git a/docs/code-quality/c26815.md b/docs/code-quality/c26815.md index 8778703ae41..bab51260def 100644 --- a/docs/code-quality/c26815.md +++ b/docs/code-quality/c26815.md @@ -1,9 +1,9 @@ --- -title: Warning C26815 +title: "Warning C26815" description: "Learn more about: Warning C26815." +ms.date: 01/27/2020 author: Rastaban ms.author: philc -ms.date: 01/27/2020 f1_keywords: ["C26815", "LIFETIME_LOCAL_USE_AFTER_FREE_TEMP"] helpviewer_keywords: ["C26815"] --- diff --git a/docs/code-quality/c26816.md b/docs/code-quality/c26816.md index f01ea3bc00d..0dd97234962 100644 --- a/docs/code-quality/c26816.md +++ b/docs/code-quality/c26816.md @@ -1,9 +1,9 @@ --- -title: Warning C26816 +title: "Warning C26816" description: "Learn more about: Warning C26816." +ms.date: 01/27/2020 author: Rastaban ms.author: philc -ms.date: 01/27/2020 f1_keywords: ["C26816", "LIFETIME_LOCAL_USE_AFTER_FREE_STACK"] helpviewer_keywords: ["C26816"] --- diff --git a/docs/code-quality/c26817.md b/docs/code-quality/c26817.md index 616e4876f1f..9e8bcb7a9b2 100644 --- a/docs/code-quality/c26817.md +++ b/docs/code-quality/c26817.md @@ -1,5 +1,5 @@ --- -title: Warning C26817 +title: "Warning C26817" description: "Reference for Microsoft C++ Code Analysis warning C26817 in Visual Studio." ms.date: 10/12/2023 f1_keywords: ["C26817"] diff --git a/docs/code-quality/c26818.md b/docs/code-quality/c26818.md index 52adf70f5b6..46d89915db4 100644 --- a/docs/code-quality/c26818.md +++ b/docs/code-quality/c26818.md @@ -1,5 +1,5 @@ --- -title: Warning C26818 +title: "Warning C26818" description: "Reference for Microsoft C++ Code Analysis warning C26818 in Visual Studio." ms.date: 04/22/2020 f1_keywords: ["C26818"] diff --git a/docs/code-quality/c26819.md b/docs/code-quality/c26819.md index 2e2007c9ff0..19dd7513510 100644 --- a/docs/code-quality/c26819.md +++ b/docs/code-quality/c26819.md @@ -1,5 +1,5 @@ --- -title: Warning C26819 +title: "Warning C26819" description: "Reference for Microsoft C++ Code Analysis warning C26819 in Visual Studio." ms.date: 04/22/2020 f1_keywords: ["C26819"] diff --git a/docs/code-quality/c26820.md b/docs/code-quality/c26820.md index db7807cbf4c..bec99f63c72 100644 --- a/docs/code-quality/c26820.md +++ b/docs/code-quality/c26820.md @@ -1,5 +1,5 @@ --- -title: Warning C26820 +title: "Warning C26820" description: "Reference for Microsoft C++ Code Analysis warning C26820 in Visual Studio." ms.date: 10/12/2023 f1_keywords: ["C26820"] diff --git a/docs/code-quality/c26822.md b/docs/code-quality/c26822.md index fd661eafff1..15e355ba209 100644 --- a/docs/code-quality/c26822.md +++ b/docs/code-quality/c26822.md @@ -1,5 +1,5 @@ --- -title: Warning C26822 +title: "Warning C26822" description: "Describes the Microsoft C/C++ code analysis warning C26822, its causes, and how to address it." ms.date: 06/27/2022 f1_keywords: ["C26822", "NULLPTR_DEREFERENCE"] diff --git a/docs/code-quality/c26823.md b/docs/code-quality/c26823.md index 0ac7318a8a6..e89b46c2e42 100644 --- a/docs/code-quality/c26823.md +++ b/docs/code-quality/c26823.md @@ -1,5 +1,5 @@ --- -title: Warning C26823 +title: "Warning C26823" description: "Describes the Microsoft C/C++ code analysis warning C26823, its causes, and how to address it." ms.date: 06/27/2022 f1_keywords: ["C26823", "NULLPTR_DEREFERENCE_MAYBE"] diff --git a/docs/code-quality/c26824.md b/docs/code-quality/c26824.md index 0513c2c3f27..c2e9cea848d 100644 --- a/docs/code-quality/c26824.md +++ b/docs/code-quality/c26824.md @@ -1,5 +1,5 @@ --- -title: Warning C26824 +title: "Warning C26824" description: "Describes the Microsoft C/C++ code analysis warning C26824, its causes, and how to address it." ms.date: 06/27/2022 f1_keywords: ["C26824", "NULLPTR_POSTCONDITION_VIOLATION"] diff --git a/docs/code-quality/c26825.md b/docs/code-quality/c26825.md index 7945aeb3d0d..0c438deafb8 100644 --- a/docs/code-quality/c26825.md +++ b/docs/code-quality/c26825.md @@ -1,5 +1,5 @@ --- -title: Warning C26825 +title: "Warning C26825" description: "Describes the Microsoft C/C++ code analysis warning C26825, its causes, and how to address it." ms.date: 06/27/2022 f1_keywords: ["C26825", "NULLPTR_POSTCONDITION_VIOLATION_MAYBE"] diff --git a/docs/code-quality/c26826.md b/docs/code-quality/c26826.md index 4015cf675e4..d1da079af20 100644 --- a/docs/code-quality/c26826.md +++ b/docs/code-quality/c26826.md @@ -1,5 +1,5 @@ --- -title: Warning C26826 +title: "Warning C26826" description: "Reference for Microsoft C++ Code Analysis warning C26826 in Visual Studio." ms.date: 10/25/2021 f1_keywords: ["C26826"] diff --git a/docs/code-quality/c26827.md b/docs/code-quality/c26827.md index 7f80abb5325..6f806ba3939 100644 --- a/docs/code-quality/c26827.md +++ b/docs/code-quality/c26827.md @@ -1,5 +1,5 @@ --- -title: Warning C26827 +title: "Warning C26827" description: "Learn more about: Warning C26827" ms.date: 05/17/2023 f1_keywords: ["C26827", "ALMOST_BITWISE_ENUM"] diff --git a/docs/code-quality/c26828.md b/docs/code-quality/c26828.md index 5c0a9d474d4..ad057d7aa97 100644 --- a/docs/code-quality/c26828.md +++ b/docs/code-quality/c26828.md @@ -1,5 +1,5 @@ --- -title: Warning C26828 +title: "Warning C26828" description: "Learn more about: Warning C26828" ms.date: 05/17/2023 f1_keywords: ["C26828", "MIXING_OVERLAPPING_ENUMS"] diff --git a/docs/code-quality/c26829.md b/docs/code-quality/c26829.md index a19bd224a37..9eb04b47e84 100644 --- a/docs/code-quality/c26829.md +++ b/docs/code-quality/c26829.md @@ -1,5 +1,5 @@ --- -title: Warning C26829 +title: "Warning C26829" description: "Describes the Microsoft C/C++ code analysis warning C26829, its causes, and how to address it." ms.date: 06/23/2022 f1_keywords: ["C26829", "UNWRAP_EMPTY_OPTIONAL"] diff --git a/docs/code-quality/c26830.md b/docs/code-quality/c26830.md index 686b4b17127..513cf97632c 100644 --- a/docs/code-quality/c26830.md +++ b/docs/code-quality/c26830.md @@ -1,5 +1,5 @@ --- -title: Warning C26830 +title: "Warning C26830" description: "Describes the Microsoft C/C++ code analysis warning C26830, its causes, and how to address it." ms.date: 06/23/2022 f1_keywords: ["C26830", "UNWRAP_EMPTY_OPTIONAL_MAYBE"] From 82d723e20227603fdbf5d8cfce45c06972831913 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 26 Sep 2025 14:39:30 -0700 Subject: [PATCH 1307/1799] minor edit --- docs/sanitizers/asan-building.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-building.md b/docs/sanitizers/asan-building.md index cbeba6747dc..b04ac105607 100644 --- a/docs/sanitizers/asan-building.md +++ b/docs/sanitizers/asan-building.md @@ -131,7 +131,7 @@ The **`/fsanitize=address`** compiler option marks objects to specify which Addr | `/MT` or `/MTd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_static_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* | `/MD` or `/MDd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_dynamic_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* -The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) prevents the linker from linking a *`clang_rt.asan*`* library file from the default location. Add the library path in your build scripts if you use this option. Otherwise, the linker reports an unresolved external symbol error. Note that the runtime thunk libraries **must** be linked with `/wholearchive` option applied. +The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) prevents the linker from linking a *`clang_rt.asan*`* library file from the default location. Add the library path in your build scripts if you use this option. Otherwise, the linker reports an unresolved external symbol error. The runtime thunk libraries **must** be linked with the `/wholearchive` option applied. **Previous Versions** From e397c593e2629bfbe010680f8e8f4c9ce53a8f16 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 27 Sep 2025 21:46:24 +0800 Subject: [PATCH 1308/1799] Capitalize first letter of "Dominance" section in "Multiple Base Classes" topic --- docs/cpp/multiple-base-classes.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/multiple-base-classes.md b/docs/cpp/multiple-base-classes.md index 55314b726c7..26bdbee6881 100644 --- a/docs/cpp/multiple-base-classes.md +++ b/docs/cpp/multiple-base-classes.md @@ -156,7 +156,7 @@ pc->B::a(); ### Dominance -it's possible for more than one name (function, object, or enumerator) to be reached through an inheritance graph. Such cases are considered ambiguous with nonvirtual base classes. They're also ambiguous with virtual base classes, unless one of the names "dominates" the others. +It's possible for more than one name (function, object, or enumerator) to be reached through an inheritance graph. Such cases are considered ambiguous with nonvirtual base classes. They're also ambiguous with virtual base classes, unless one of the names "dominates" the others. A name dominates another name if it's defined in both classes and one class is derived from the other. The dominant name is the name in the derived class; this name is used when an ambiguity would otherwise have arisen, as shown in the following example: From e4a205eaaba1ba2401ab96cae01a4f26f1cd41dc Mon Sep 17 00:00:00 2001 From: v-ccolin <72402153+v-ccolin@users.noreply.github.com> Date: Sun, 28 Sep 2025 08:25:52 +0100 Subject: [PATCH 1309/1799] Update docs/windows/latest-supported-vc-redist.md --- docs/windows/latest-supported-vc-redist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index d557a38efb2..9217788e655 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -43,7 +43,7 @@ This table lists the latest supported English (en-US) Microsoft Visual C++ Redis Unlike older versions of Visual Studio that have infrequent redist updates, the version number isn't listed in the following table for Visual Studio 2015-2022 because the redist is updated frequently. To find the version number of the latest redist, download the redist you're interested in using one of the following links. Then, look at its properties using Windows File Explorer. In the **Details** pane, the **File version** contains the version of the redist. -### Latest supported Redistributable version: +### Latest supported redistributable version | Architecture | Link | Notes | |--|--|--| From fd38dab57c533751d0dccee5abce9a149fe8e479 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sun, 28 Sep 2025 21:55:13 +0800 Subject: [PATCH 1310/1799] Tweak "`launch.vs.json` schema reference (C++)" topic --- docs/build/launch-vs-schema-reference-cpp.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/build/launch-vs-schema-reference-cpp.md b/docs/build/launch-vs-schema-reference-cpp.md index 290cc1a1ce6..e7d4f24ef18 100644 --- a/docs/build/launch-vs-schema-reference-cpp.md +++ b/docs/build/launch-vs-schema-reference-cpp.md @@ -17,7 +17,7 @@ To create the file, right-click on an executable file in **Solution Explorer** a | `args` | array | Specifies the command-line arguments passed to the launched program. | | `buildConfigurations` | array | A key-value pair that specifies the name of the build mode to apply the configurations. For example, `Debug` or `Release` and the configurations to use according to the selected build mode. | | `currentDir` | string | Specifies the full directory path to the Build Target. The directory is detected automatically unless this parameter is set. | -| `cwd` | string | Full path to the directory on the remote system where the program will run. Defaults to `"${debugInfo.defaultWorkingDirectory}"` | +| `cwd` | string | Full path to the directory on the remote system where the program will run. Defaults to `"${debugInfo.defaultWorkingDirectory}"`. | | `debugType` | string | Specifies the debugging mode according to the type of code (native, managed, or mixed). The mode is automatically detected unless this parameter is set. Allowed values: `"native"`, `"managed"`, `"mixed"`. | | `env` | array | Specifies a key-value list of custom environment variables. For example: `env:{"myEnv":"myVal"}`. | | `inheritEnvironments` | array | Specifies a set of environment variables inherited from multiple sources. You can define some variables in files like *`CMakeSettings.json`* or *`CppProperties.json`* and make them available to debug context. **Visual Studio 16.4:** Specify environment variables on a per-target basis using the `env.VARIABLE_NAME` syntax. To unset a variable, set it to `"null"`. | @@ -27,9 +27,9 @@ To create the file, right-click on an executable file in **Solution Explorer** a | `program` | string | The debug command to execute. Defaults to `"${debugInfo.fullTargetPath}"`. | | `project` | string | Specifies the relative path to the project file. Normally, you don't need to change this value when debugging a CMake project. | | `projectTarget` | string | Specifies the optional target invoked when building `project`. The target must match the name in the **Startup Item** dropdown. | -| `stopOnEntry` | boolean | Specifies whether to break a soon as the process is launched and the debugger attaches. The default value for this parameter is **`false`**. | +| `stopOnEntry` | boolean | Specifies whether to break as soon as the process is launched and the debugger attaches. The default value for this parameter is **`false`**. | | `remoteMachine` | string | Specifies the name of the remote machine where the program is launched. | -| `type` | string | Specifies whether the project is a `dll` or `exe` Defaults to .exe | +| `type` | string | Specifies whether the project is a `dll` or `exe`. Defaults to `"exe"`. | ## C++ Linux properties @@ -64,7 +64,7 @@ The following macros provide information about the debugging environment. They'r | Macro | Description | Example | |--|--|--| -| `addressSanitizerRuntimeFlags` | Runtime flags used to customize behavior of the address sanitizer. Used to set the environment variable `"ASAN_OPTIONS"`. | `"env": {"ASAN_OPTIONS": "${addressSanitizerRuntimeFlags}:anotherFlag=true"`} | +| `addressSanitizerRuntimeFlags` | Runtime flags used to customize behavior of the address sanitizer. Used to set the environment variable `"ASAN_OPTIONS"`. | `"env": {"ASAN_OPTIONS": "${addressSanitizerRuntimeFlags}:anotherFlag=true"}` | | `defaultWorkingDirectory` | Set to the directory part of `"fullTargetPath"`. If the CMake variable `VS_DEBUGGER_WORKING_DIRECTORY` is defined, then `defaultWorkingDirectory` is set to that value, instead. | `"cwd":"${debugInfo.defaultWorkingDirectory}"` | | `fullTargetPath` | The full path to the binary being debugged. | `"program": "${debugInfo.fullTargetPath}"` | | `linuxNatvisPath` | The full windows path to the VS linux `.natvis` file. Usually appears as the value `"visualizerFile"`. | | @@ -98,7 +98,7 @@ The pipeTransport example below shows how to use some of the `debugInfo` macros "/c", "${debuggerCommand}" ] - } +} ``` ## C++ Windows remote debug and deploy properties @@ -109,8 +109,8 @@ Used when debugging and deploying an app on a remote machine. |--|--|--| | `cwd` | string | The working directory of the target on the remote machine. When using CMake, the macro `${debugInfo.defaultWorkingDirectory}` can be used as the value of this field. The default value is the directory of the debug program/command. | | `deploy` | string | Specifies extra files or directories to deploy. For example:
`"deploy": {"sourcePath":"", "targetPath":""}` | -| `deployDirectory` | string | The location on the remote machine where project outputs are automatically deployed to. Defaults to "`C:\Windows Default Deploy Directory\` | -| `deployDebugRuntimeLibraries` | string | Specifies whether to deploy the debug runtime libraries for the active platform. Defaults to `"true"` if the active configurationType is `"Debug"` | +| `deployDirectory` | string | The location on the remote machine where project outputs are automatically deployed to. Defaults to `"C:\Windows Default Deploy Directory\"`. | +| `deployDebugRuntimeLibraries` | string | Specifies whether to deploy the debug runtime libraries for the active platform. Defaults to `"true"` if the active configurationType is `"Debug"`. | | `deployRuntimeLibraries` | string | Specifies whether to deploy the runtime libraries for the active platform. Defaults to `"true"` if the active configurationType is `"MinSizeRel"`, `"RelWithDebInfo"`, or `"Release"`. | | `disableDeploy` | boolean | Specifies whether files should be deployed. | | `remoteMachineName` | string | Specifies the name of the remote ARM64 Windows machine where the program is launched. May be the server name or the remote machine's IP address. | From 99a4e277270d531342050307ffb5f555ab4b0dd2 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 29 Sep 2025 23:12:26 +0800 Subject: [PATCH 1311/1799] Fix erroneous `_dlog` triplicate heading in "Floating-point primitives" topic --- docs/c-runtime-library/reference/floating-point-primitives.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/floating-point-primitives.md b/docs/c-runtime-library/reference/floating-point-primitives.md index 27f5ef5e1fa..f2ca3b89eae 100644 --- a/docs/c-runtime-library/reference/floating-point-primitives.md +++ b/docs/c-runtime-library/reference/floating-point-primitives.md @@ -253,7 +253,7 @@ Order of the polynomial to evaluate. These floating-point primitives return the evaluation of *`x`* in the polynomial of order *`n`* whose coefficients are represented by the corresponding constant values in *`table`*. For example, if *`table[0]`* = 3.0, *`table[1]`* = 4.0, *`table[2]`* = 5.0, and *`n`* = 2, it represents the polynomial 5.0x2 + 4.0x + 3.0. If this polynomial is evaluated for *`x`* of 2.0, the result is 31.0. These functions aren't used internally. -## _dlog, _dlog, _dlog +## _dlog, _ldlog, _fdlog ### Syntax From 9f22b12b1b0d85e6e5634f51be0a6aa65477c4c3 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 29 Sep 2025 23:16:26 +0800 Subject: [PATCH 1312/1799] Fix invalid `_float` type for `_fdpoly` syntax in "Floating-point primitives" topic --- docs/c-runtime-library/reference/floating-point-primitives.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/floating-point-primitives.md b/docs/c-runtime-library/reference/floating-point-primitives.md index f2ca3b89eae..8a023d0dfd2 100644 --- a/docs/c-runtime-library/reference/floating-point-primitives.md +++ b/docs/c-runtime-library/reference/floating-point-primitives.md @@ -235,7 +235,7 @@ These floating-point primitives normalize the fractional part of an underflowed ```C double __cdecl _dpoly(double x, double const* table, int n); long double __cdecl _ldpoly(long double x, long double const* table, int n); -float __cdecl _fdpoly(float x, _float const* table, int n); +float __cdecl _fdpoly(float x, float const* table, int n); ``` ### Parameters From ec006189ade2dcbcbd767c29ba6b4d9078197e19 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 29 Sep 2025 23:28:41 +0800 Subject: [PATCH 1313/1799] Add backticks in "Floating-point primitives" topic --- .../reference/floating-point-primitives.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/c-runtime-library/reference/floating-point-primitives.md b/docs/c-runtime-library/reference/floating-point-primitives.md index 8a023d0dfd2..9310bfe846a 100644 --- a/docs/c-runtime-library/reference/floating-point-primitives.md +++ b/docs/c-runtime-library/reference/floating-point-primitives.md @@ -32,7 +32,7 @@ Floating-point function argument. ### Remarks -These floating-point primitives implement the C versions of the CRT macro [`fpclassify`](fpclassify.md) for floating-point types. The classification of the argument *`x`* is returned as one of these constants, defined in math.h: +These floating-point primitives implement the C versions of the CRT macro [`fpclassify`](fpclassify.md) for floating-point types. The classification of the argument *`x`* is returned as one of these constants, defined in `math.h`: | Value | Description | |---|---| @@ -63,7 +63,7 @@ Floating-point function argument. These floating-point primitives implement the [`signbit`](signbit.md) macro or function in the CRT. They return a non-zero value if the sign bit is set in the significand (mantissa) of the argument *`x`*. Otherwise, they return 0 if the sign bit isn't set. -## _dpcomp, _ldpcomp, _fdpcomp +## `_dpcomp`, `_ldpcomp`, `_fdpcomp` ### Syntax @@ -80,7 +80,7 @@ Floating-point function arguments. ### Remarks -These floating-point primitives take two arguments, *`x`* and *`y`*, and return a value that shows their ordering relationship, expressed as the bitwise or of these constants, defined in math.h: +These floating-point primitives take two arguments, *`x`* and *`y`*, and return a value that shows their ordering relationship, expressed as the bitwise or of these constants, defined in `math.h`: | Value | Description | |------------|-----------------| @@ -90,7 +90,7 @@ These floating-point primitives take two arguments, *`x`* and *`y`*, and return These primitives implement the [`isgreater`, `isgreaterequal`, `isless`, `islessequal`, `islessgreater`, and `isunordered`](floating-point-ordering.md) macros and functions in the CRT. -## _dtest, _ldtest, _fdtest +## `_dtest`, `_ldtest`, `_fdtest` ### Syntax @@ -107,7 +107,7 @@ Pointer to a floating-point argument. ### Remarks -These floating-point primitives implement the C++ versions of the CRT function [`fpclassify`](fpclassify.md) for floating-point types. The argument *`x`* is evaluated and the classification is returned as one of these constants, defined in math.h: +These floating-point primitives implement the C++ versions of the CRT function [`fpclassify`](fpclassify.md) for floating-point types. The argument *`x`* is evaluated and the classification is returned as one of these constants, defined in `math.h`: | Value | Description | |---|---| @@ -119,7 +119,7 @@ These floating-point primitives implement the C++ versions of the CRT function [ For more detail, you can use the Microsoft-specific [`_fpclass`, `_fpclassf`](fpclass-fpclassf.md) functions. Use the [`fpclassify`](fpclassify.md) function for portability. -## _d_int, _ld_int, _fd_int +## `_d_int`, `_ld_int`, `_fd_int` ### Syntax @@ -141,7 +141,7 @@ An exponent as an integral type. These floating-point primitives take a pointer to a floating-point value *`px`* and an exponent value *`exp`*, and remove the fractional part of the floating-point value below the given exponent, if possible. The value returned is the result of `fpclassify` on the input value in *`px`* if it's a NaN or infinity, and on the output value in *`px`* otherwise. -## _dscale, _ldscale, _fdscale +## `_dscale`, `_ldscale`, `_fdscale` ### Syntax @@ -163,7 +163,7 @@ An exponent as an integral type. These floating-point primitives take a pointer to a floating-point value *`px`* and an exponent value *`exp`*, and scale the value in *`px`* by 2*`exp`*, if possible. The value returned is the result of `fpclassify` on the input value in *`px`* if it's a NaN or infinity, and on the output value in *`px`* otherwise. For portability, prefer the [`ldexp`, `ldexpf`, `ldexpl`](ldexp.md) functions. -## _dunscale, _ldunscale, _fdunscale +## `_dunscale`, `_ldunscale`, `_fdunscale` ### Syntax @@ -185,7 +185,7 @@ Pointer to a floating-point argument. These floating-point primitives break down the floating-point value pointed at by *`px`* into a significand (mantissa) and an exponent, if possible. The significand is scaled such that the absolute value is greater than or equal to 0.5 and less than 1.0. The exponent is the value *`n`*, where the original floating-point value is equal to the scaled significand times 2n. This integer exponent *`n`* is stored at the location pointed to by *`pexp`*. The value returned is the result of `fpclassify` on the input value in *`px`* if it's a NaN or infinity, and on the output value otherwise. For portability, prefer the [`frexp`, `frexpf`, `frexpl`](frexp.md) functions. -## _dexp, _ldexp, _fdexp +## `_dexp`, `_ldexp`, `_fdexp` ### Syntax @@ -210,7 +210,7 @@ An exponent as an integral type. These floating-point primitives construct a floating-point value in the location pointed at by *`px`* equal to *`y`* * 2exp. The value returned is the result of `fpclassify` on the input value in *`y`* if it's a NaN or infinity, and on the output value in *`px`* otherwise. For portability, prefer the [`ldexp`, `ldexpf`, `ldexpl`](ldexp.md) functions. -## _dnorm, _fdnorm +## `_dnorm`, `_fdnorm` ### Syntax @@ -226,9 +226,9 @@ Pointer to the bitwise representation of a floating-point value expressed as an ### Remarks -These floating-point primitives normalize the fractional part of an underflowed floating-point value and adjust the *characteristic*, or biased exponent, to match. The value is passed as the bitwise representation of the floating-point type converted to an array of **`unsigned short`** through the `_double_val`, `_ldouble_val`, or `_float_val` type-punning union declared in math.h. The return value is the result of `fpclassify` on the input floating-point value if it's a NaN or infinity, and on the output value otherwise. +These floating-point primitives normalize the fractional part of an underflowed floating-point value and adjust the *characteristic*, or biased exponent, to match. The value is passed as the bitwise representation of the floating-point type converted to an array of **`unsigned short`** through the `_double_val`, `_ldouble_val`, or `_float_val` type-punning union declared in `math.h`. The return value is the result of `fpclassify` on the input floating-point value if it's a NaN or infinity, and on the output value otherwise. -## _dpoly, _ldpoly, _fdpoly +## `_dpoly`, `_ldpoly`, `_fdpoly` ### Syntax @@ -253,7 +253,7 @@ Order of the polynomial to evaluate. These floating-point primitives return the evaluation of *`x`* in the polynomial of order *`n`* whose coefficients are represented by the corresponding constant values in *`table`*. For example, if *`table[0]`* = 3.0, *`table[1]`* = 4.0, *`table[2]`* = 5.0, and *`n`* = 2, it represents the polynomial 5.0x2 + 4.0x + 3.0. If this polynomial is evaluated for *`x`* of 2.0, the result is 31.0. These functions aren't used internally. -## _dlog, _ldlog, _fdlog +## `_dlog`, `_ldlog`, `_fdlog` ### Syntax @@ -275,7 +275,7 @@ Flag that controls the base to use, 0 for base *e* and non-zero for base 10. These floating-point primitives return the natural log of *`x`* (ln(x) or log*e*(x)), when *`base_flag`* is 0. They return the log base 10 of *`x`*, or log10(x), when *`base_flag`* is non-zero. These functions aren't used internally. For portability, prefer the functions [`log`, `logf`, `logl`, `log10`, `log10f`, and `log10l`](log-logf-log10-log10f.md). -## _dsin, _ldsin, _fdsin +## `_dsin`, `_ldsin`, `_fdsin` ### Syntax @@ -299,7 +299,7 @@ These floating-point primitives return the sine of *`x`* offset by the *`quadran ## Requirements -Header: \ +Header: `` For more compatibility information, see [Compatibility](../compatibility.md). From 6b8aaa126eae26912a13134103dc9b5876ea043c Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Mon, 29 Sep 2025 23:29:25 +0800 Subject: [PATCH 1314/1799] Update metadata in "Floating-point primitives" topic --- docs/c-runtime-library/reference/floating-point-primitives.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/reference/floating-point-primitives.md b/docs/c-runtime-library/reference/floating-point-primitives.md index 9310bfe846a..965ac7ec2db 100644 --- a/docs/c-runtime-library/reference/floating-point-primitives.md +++ b/docs/c-runtime-library/reference/floating-point-primitives.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Floating-point primitives" title: "Floating-point primitives" -ms.date: "4/2/2020" +description: "Learn more about: Floating-point primitives" +ms.date: 4/2/2020 api_name: ["_dclass", "_ldclass", "_fdclass", "_dsign", "_ldsign", "_fdsign", "_dpcomp", "_ldpcomp", "_fdpcomp", "_dtest", "_ldtest", "_fdtest", "_d_int", "_ld_int", "_fd_int", "_dscale", "_ldscale", "_fdscale", "_dunscale", "_ldunscale", "_fdunscale", "_dexp", "_ldexp", "_fdexp", "_dnorm", "_fdnorm", "_dpoly", "_ldpoly", "_fdpoly", "_dlog", "_ldlog", "_fdlog", "_dsin", "_ldsin", "_fdsin", "_o__d_int", "_o__dclass", "_o__dlog", "_o__dnorm", "_o__dpcomp", "_o__dpoly", "_o__dscale", "_o__dsign", "_o__dsin", "_o__dtest", "_o__dunscale", "_o__fd_int", "_o__fdclass", "_o__fdexp", "_o__fdlog", "_o__fdpcomp", "_o__fdpoly", "_o__fdscale", "_o__fdsign", "_o__fdsin", "_o__ld_int", "_o__ldclass", "_o__ldexp", "_o__ldlog", "_o__ldpcomp", "_o__ldpoly", "_o__ldscale", "_o__ldsign", "_o__ldsin", "_o__ldtest", "_o__ldunscale"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] From 5f82740f3043d0ba313350cc430362a4043721cd Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Tue, 30 Sep 2025 00:53:35 +0800 Subject: [PATCH 1315/1799] Update some `http` links to `https` --- docs/code-quality/using-the-cpp-core-guidelines-checkers.md | 2 +- docs/error-messages/compiler-errors-2/compiler-error-c3066.md | 2 +- docs/overview/cpp-conformance-improvements-2017.md | 2 +- docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md index 0010cfda987..a463b7bb77a 100644 --- a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md +++ b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md @@ -305,7 +305,7 @@ The Guideline Support Library (GSL) is designed to help you follow the Core Guid ## Use the C++ Core Check guidelines in Visual Studio 2015 projects -If you use Visual Studio 2015, the C++ Core Check code analysis rule sets aren't installed by default. Other steps are needed before you can enable the C++ Core Check code analysis tools in Visual Studio 2015. Microsoft provides support for Visual Studio 2015 projects by using a NuGet package. The package is named Microsoft.CppCoreCheck, and it's available at [http://www.nuget.org/packages/Microsoft.CppCoreCheck](https://www.nuget.org/packages/Microsoft.CppCoreCheck). This package requires you have at least Visual Studio 2015 with Update 1 installed. +If you use Visual Studio 2015, the C++ Core Check code analysis rule sets aren't installed by default. Other steps are needed before you can enable the C++ Core Check code analysis tools in Visual Studio 2015. Microsoft provides support for Visual Studio 2015 projects by using a NuGet package. The package is named Microsoft.CppCoreCheck, and it's available at [https://www.nuget.org/packages/Microsoft.CppCoreCheck](https://www.nuget.org/packages/Microsoft.CppCoreCheck). This package requires you have at least Visual Studio 2015 with Update 1 installed. The package also installs another package as a dependency, the header-only Guideline Support Library (GSL). The GSL is also available on GitHub at [https://github.com/Microsoft/GSL](https://github.com/Microsoft/GSL). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md index abba7aee354..2829acc296f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md @@ -54,7 +54,7 @@ int main() { In Visual Studio 2015, the compiler erroneously treated copy-list-initialization in the same way as regular copy-initialization; it considered only converting constructors for overload resolution. In the following example, Visual Studio 2015 chooses MyInt(23) but Visual Studio 2017 correctly raises the error. ``` -// From http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_closed.html#1228 +// From https://www.open-std.org/jtc1/sc22/wg21/docs/cwg_closed.html#1228 struct MyList { explicit MyStore(int initialCapacity); }; diff --git a/docs/overview/cpp-conformance-improvements-2017.md b/docs/overview/cpp-conformance-improvements-2017.md index af33b89fb3f..84382c2a25b 100644 --- a/docs/overview/cpp-conformance-improvements-2017.md +++ b/docs/overview/cpp-conformance-improvements-2017.md @@ -70,7 +70,7 @@ const A& a2{ 1 }; In Visual Studio 2015, the compiler erroneously treated copy-list-initialization in the same way as regular copy-initialization: it considered only converting constructors for overload resolution. In the following example, Visual Studio 2015 chooses `MyInt(23)`. Visual Studio 2017 correctly raises the error. ```cpp -// From http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_closed.html#1228 +// From https://www.open-std.org/jtc1/sc22/wg21/docs/cwg_closed.html#1228 struct MyStore { explicit MyStore(int initialCapacity); }; diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index 8d0e875857f..4f546d1d8c0 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -519,7 +519,7 @@ The responsiveness of **Go To All** is improved. Previously, results appeared af A partial list of new features in 17.2: - Added compiler support for C++23 feature [deducing `this`](https://wg21.link/p0847), available under the **`/std:c++latest`** option. -- Added IntelliSense support for C++23 features [deducing `this`](https://wg21.link/p0847) and [`if consteval`](http://wg21.link/p1938). +- Added IntelliSense support for C++23 features [deducing `this`](https://wg21.link/p0847) and [`if consteval`](https://wg21.link/p1938). - Added inline parameter name and type hint support, toggled by pressing **Alt+F1** or double-tapping **Ctrl**. This behavior can be customized under **Tools > Options > Text Editors > C/C++ > IntelliSense**. - Added experimental support for C++20 modules in CMake projects. This support is currently only available with the Visual Studio (MSBuild) generator. - In 17.1, we introduced peripheral register and RTOS views for embedded developers. We continue to improve the capabilities of those views with usability improvements in 17.2: From 26510c1bb47118a1f626bfdc6552d36c67715d99 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 29 Sep 2025 14:54:35 -0700 Subject: [PATCH 1316/1799] Revise Warning C6064 documentation Updated the date and improved wording for clarity. --- docs/code-quality/c6064.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/code-quality/c6064.md b/docs/code-quality/c6064.md index fe97e65dea7..9b9da081f91 100644 --- a/docs/code-quality/c6064.md +++ b/docs/code-quality/c6064.md @@ -1,7 +1,7 @@ --- description: "Learn more about: Warning C6064" title: Warning C6064 -ms.date: 2/07/2023 +ms.date: 9/29/2025 f1_keywords: ["C6064", "MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6064"] --- @@ -13,13 +13,13 @@ This warning indicates that the code doesn't provide enough arguments to match a ## Remarks -Supplying too few arguments to a format function leads to undefined behavior, because the function attempts to read values that were never passed. Possible consequences include incorrect output, crashes, or even security vulnerabilities such as information leaks. To ensure stability and safety, always match the number and types of arguments to the format specifiers in the string. +Supplying too few arguments to a format function leads to undefined behavior because the function attempts to read values that aren't passed. Possible consequences include incorrect output, crashes, or even security vulnerabilities such as information leaks. To ensure stability and safety, always match the number and types of arguments to the format specifiers in the string. Code analysis name: `MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION` ## Example -The following code generates this warning because it uses an incorrect number of arguments in the call to `sprintf_s` and the missing argument is an integer. If the unsafe function `sprintf` was used instead of the safer variant `sprintf_s`, this code would likely cause a stack overflow instead of just an unexpected output: +The following code generates this warning by using an incorrect number of arguments in the call to `sprintf_s` and the missing argument is an integer. If the unsafe function `sprintf` was used instead of the safer variant `sprintf_s`, this code would likely cause a stack overflow instead of just unexpected output: ```cpp void f() @@ -34,7 +34,7 @@ void f() } ``` -To correct this warning, specify missing arguments or adjust the format string. In this example, we add the missing integer value. +To correct this warning, specify the missing arguments or adjust the format string. In this example, we add the missing integer value. ```cpp void f() From 03ac7e24cde3c8bf7af61b53fb78b4b0881d48eb Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 29 Sep 2025 15:06:08 -0700 Subject: [PATCH 1317/1799] Update C6064 warning message for clarity Clarified the warning message about missing integer arguments and emphasized the importance of matching argument types. --- docs/code-quality/c6064.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/code-quality/c6064.md b/docs/code-quality/c6064.md index 6f91224977d..48f04cb99aa 100644 --- a/docs/code-quality/c6064.md +++ b/docs/code-quality/c6064.md @@ -9,11 +9,11 @@ helpviewer_keywords: ["C6064"] > Missing integer argument to '*function-name*' corresponding to conversion specifier '*number*' -This warning indicates that the code doesn't provide enough arguments to match a format string and one of the missing arguments is an integer. - ## Remarks -Supplying too few arguments to a format function leads to undefined behavior because the function attempts to read values that aren't passed. Possible consequences include incorrect output, crashes, or even security vulnerabilities such as information leaks. +This warning indicates that the code doesn't provide enough arguments to match a format string and one of the missing arguments is an integer. + +Providing too few arguments to a format function leads to undefined behavior because the function attempts to read values that aren't passed. Possible consequences include incorrect output, crashes, or even security vulnerabilities such as information leaks. To ensure stability and safety, always match the number and types of arguments to the format specifiers in the string. From d083529d0ef691c259517dad8b27949db82ceaf2 Mon Sep 17 00:00:00 2001 From: Sinem Akinci <99284450+sinemakinci1@users.noreply.github.com> Date: Tue, 30 Sep 2025 13:25:36 -0700 Subject: [PATCH 1318/1799] Delete docs/build/media/cmake-projects-in-visual-studio directory --- .../screenshot-2023-07-14-153155.png | Bin 58875 -> 0 bytes 1 file changed, 0 insertions(+), 0 deletions(-) delete mode 100644 docs/build/media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png diff --git a/docs/build/media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png b/docs/build/media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png deleted file mode 100644 index 781528af193dde831cddd6a35542f447c9bc7bcb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 58875 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 Date: Tue, 30 Sep 2025 13:26:07 -0700 Subject: [PATCH 1319/1799] Add files via upload --- .../media/screenshot-2023-07-14-153155.png | Bin 0 -> 58875 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/build/media/screenshot-2023-07-14-153155.png diff --git a/docs/build/media/screenshot-2023-07-14-153155.png b/docs/build/media/screenshot-2023-07-14-153155.png new file mode 100644 index 0000000000000000000000000000000000000000..781528af193dde831cddd6a35542f447c9bc7bcb GIT binary patch literal 58875 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 Date: Tue, 30 Sep 2025 13:26:52 -0700 Subject: [PATCH 1320/1799] Rename screenshot-2023-07-14-153155.png to visual-studio-switch-cmake-targets-view.png --- ... => visual-studio-switch-cmake-targets-view.png} | Bin 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/build/media/{screenshot-2023-07-14-153155.png => visual-studio-switch-cmake-targets-view.png} (100%) diff --git a/docs/build/media/screenshot-2023-07-14-153155.png b/docs/build/media/visual-studio-switch-cmake-targets-view.png similarity index 100% rename from docs/build/media/screenshot-2023-07-14-153155.png rename to docs/build/media/visual-studio-switch-cmake-targets-view.png From 3b67b3a70e28a311902f3d2dd8f7908e7b6f6fcb Mon Sep 17 00:00:00 2001 From: Sinem Akinci <99284450+sinemakinci1@users.noreply.github.com> Date: Tue, 30 Sep 2025 13:27:45 -0700 Subject: [PATCH 1321/1799] Update cmake-projects-in-visual-studio.md --- docs/build/cmake-projects-in-visual-studio.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index 0f090058efe..6372d15cbdf 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -53,7 +53,7 @@ Once CMake cache generation has succeeded, you can also view your projects organ You can also switch views by right-clicking on any file or folder in your Solution Explorer and selecting **Switch to CMake Targets View**. -![A screenshot of right-clicking a file or folder in the Solution explorer. The context menu item to Switch to CMake Targets View is visible](media/cmake-projects-in-visual-studio/screenshot-2023-07-14-153155.png) +![A screenshot of right-clicking a file or folder in the Solution explorer. The context menu item to Switch to CMake Targets View is visible](media/visual-studio-switch-cmake-targets-view.png) Choose the **Show All Files** button at the top of **Solution Explorer** to see all the CMake-generated output in the *`out/build/`* folders. @@ -447,4 +447,4 @@ In Visual Studio 2015, Visual Studio users can use a [CMake generator](https://c - [Deploy, run, and debug your Linux project](../linux/deploy-run-and-debug-your-linux-project.md) - [CMake predefined configuration reference](cmake-predefined-configuration-reference.md) - [vcpkg in CMake projects](/vcpkg/users/buildsystems/cmake-integration) -- [Install and use packages with CMake in Visual Studio](/vcpkg/get_started/get-started-vs) \ No newline at end of file +- [Install and use packages with CMake in Visual Studio](/vcpkg/get_started/get-started-vs) From c72cacd4b57a60664fb262b54c0f7ad62ae68df1 Mon Sep 17 00:00:00 2001 From: Dennis Rea Date: Tue, 30 Sep 2025 14:06:30 -0700 Subject: [PATCH 1322/1799] Add end period to metadata description so screen readers know where to stop. --- docs/build/cmake-projects-in-visual-studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index 6372d15cbdf..c0c295243c4 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -53,7 +53,7 @@ Once CMake cache generation has succeeded, you can also view your projects organ You can also switch views by right-clicking on any file or folder in your Solution Explorer and selecting **Switch to CMake Targets View**. -![A screenshot of right-clicking a file or folder in the Solution explorer. The context menu item to Switch to CMake Targets View is visible](media/visual-studio-switch-cmake-targets-view.png) +![A screenshot of right-clicking a file or folder in the Solution explorer. The context menu item to Switch to CMake Targets View is visible.](media/visual-studio-switch-cmake-targets-view.png) Choose the **Show All Files** button at the top of **Solution Explorer** to see all the CMake-generated output in the *`out/build/`* folders. From 5cd85428b20dba21ed3298dc69df2e4812d66486 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 1 Oct 2025 07:09:22 +0800 Subject: [PATCH 1323/1799] Set CMake code block language to `txt` as a fallback --- docs/build/cmake-presets-vs.md | 2 +- docs/build/cmake-projects-in-visual-studio.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index 63055d93fb2..b5f46cac1be 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -443,7 +443,7 @@ Instead, enable and disable AddressSanitizer by setting the required compiler an You can add the following sample to *`CMakeLists.txt`* to enable or disable AddressSanitizer for a target: -```cmd +```txt option(ASAN_ENABLED "Build this target with AddressSanitizer" ON) if(ASAN_ENABLED) diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index b56efcce7e5..78e64870018 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -148,7 +148,7 @@ When you build for Windows using the MSVC compiler, CMake projects have support When you build for Windows with the MSVC compiler, CMake projects have support for Edit and Continue. Add the following code to your *`CMakeLists.txt`* file to enable Edit and Continue. -``` +```txt if(MSVC) target_compile_options( PUBLIC "/ZI") target_link_options( PUBLIC "/INCREMENTAL") From 10ba6a7ccd5c66672d508818ee6afc282d4bc212 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 1 Oct 2025 07:39:27 +0800 Subject: [PATCH 1324/1799] Elide trailing colon in headings --- docs/build/cmake-predefined-configuration-reference.md | 2 +- docs/c-runtime-library/reference/strdate-s-wstrdate-s.md | 2 +- .../using-the-cpp-core-guidelines-checkers.md | 2 +- ...o-sink-windows-forms-events-from-native-cpp-classes.md | 2 +- docs/ide/adding-a-generic-cpp-class.md | 2 +- docs/standard-library/indirect-array-class.md | 2 +- docs/windows/windows-desktop-wizard.md | 2 +- styleguide/voice-tone.md | 8 ++++---- 8 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/build/cmake-predefined-configuration-reference.md b/docs/build/cmake-predefined-configuration-reference.md index d9597573d8d..702bb64d066 100644 --- a/docs/build/cmake-predefined-configuration-reference.md +++ b/docs/build/cmake-predefined-configuration-reference.md @@ -30,7 +30,7 @@ In a CMake project, build configurations are stored in a *`CMakeSettings.json`* When you choose a configuration, it's added to the *`CMakeSettings.json`* file in the project's root folder. You can then use it to build your project. For information about the configuration properties, see [CMakeSettings reference](cmakesettings-reference.md). -## Linux predefined build configurations: +## Linux predefined build configurations ```json { diff --git a/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md b/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md index 765db826128..6cea74da858 100644 --- a/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md +++ b/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md @@ -76,7 +76,7 @@ The debug library versions of these functions first fill the buffer with 0xFE. T By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). -### Generic-text routine mapping: +### Generic-text routine mapping | TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| diff --git a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md index a463b7bb77a..fefa3144ce2 100644 --- a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md +++ b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md @@ -39,7 +39,7 @@ To enable more Core Check rules, open the dropdown list and choose which rule se A subset of C++ Core Check rules is included in the Microsoft Native Recommended rule set. It's the ruleset that runs by default when Microsoft code analysis is enabled. -### To enable code analysis on your project: +### To enable code analysis on your project 1. Open the **Property Pages** dialog for your project. diff --git a/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md b/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md index 07a8fd3dcc9..af52b7b7635 100644 --- a/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md +++ b/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md @@ -20,7 +20,7 @@ This sample continues the work you did in [How to: Do DDX/DDV Data Binding with Now, you will associate your MFC control (`m_MyControl`) with a managed event handler delegate called `OnClick` for the managed event. -### To attach the OnClick event handler: +### To attach the OnClick event handler 1. Add the following code to the implementation of BOOL CMFC01Dlg::OnInitDialog: diff --git a/docs/ide/adding-a-generic-cpp-class.md b/docs/ide/adding-a-generic-cpp-class.md index aa08041e151..6d7a33e4c9e 100644 --- a/docs/ide/adding-a-generic-cpp-class.md +++ b/docs/ide/adding-a-generic-cpp-class.md @@ -13,7 +13,7 @@ You can add a generic C++ class by using **Class View**. A generic C++ class is ::: moniker range="msvc-140" -## To add a generic C++ class to a project: +## To add a generic C++ class to a project 1. In **Class View**, right-click the project to which you want to add the new class, choose **Add**, and then choose **Class**. diff --git a/docs/standard-library/indirect-array-class.md b/docs/standard-library/indirect-array-class.md index 90054b40f03..f123ae4e00b 100644 --- a/docs/standard-library/indirect-array-class.md +++ b/docs/standard-library/indirect-array-class.md @@ -20,7 +20,7 @@ You construct an `indirect_array` object only by writing an expression of The sequence consists of [`xa.size`](../standard-library/valarray-class.md#size) elements, where element `I` becomes the index `xa[I]` within `va`. -## Example: +## Example ```cpp // indirect_array.cpp diff --git a/docs/windows/windows-desktop-wizard.md b/docs/windows/windows-desktop-wizard.md index ff53b068d36..8a68d0885af 100644 --- a/docs/windows/windows-desktop-wizard.md +++ b/docs/windows/windows-desktop-wizard.md @@ -58,7 +58,7 @@ Defines the support and options for the application, depending on its type. |**Precompiled header**|Specifies that the static library project uses a pre-compiled header.| |**Security Development Lifecycle (SDL) checks**|For more information about SDL, see [Microsoft Security Development Lifecycle (SDL) Process Guidance](../build/reference/sdl-enable-additional-security-checks.md)| -## Add common headers for: +## Add common headers for Add support for one of the libraries supplied in Visual C++. diff --git a/styleguide/voice-tone.md b/styleguide/voice-tone.md index aa691c592e6..60fa9ce7626 100644 --- a/styleguide/voice-tone.md +++ b/styleguide/voice-tone.md @@ -19,14 +19,14 @@ like when you don't follow our guidelines. Here are the details on what we recom ## Use a conversational tone -### Appropriate style: +### Appropriate style We want our documentation to have a conversational tone. Hopefully, you'll feel as though you're having a conversation with the author as you read any of our tutorials or explanations. For you, the experience ought to be informal, conversational, and informative. Readers should feel as though they're listening to the author explain the concepts to them. -### Inappropriate style: +### Inappropriate style One might see the contrast between a conversational style, and the style one finds with more academic treatments of technical subjects. Those resources are useful, but the authors @@ -39,14 +39,14 @@ is a more academic style. You can see the difference immediately. ## Write in second person -### Appropriate style: +### Appropriate style Write your articles as though you're speaking directly to the reader. Use the second person often as you write (as I just have in these two sentences). Second person doesn't always mean using the word 'you'. Write directly to the reader. Write imperative sentences. Tell your reader what you want them to learn. -### Inappropriate style: +### Inappropriate style An author could also choose to write in third person. In that model, an author must find some pronoun or noun to use when referring to the reader. A reader might often find this third From 1ab87b8ebbf7b31303253d3fe608eec5bdeb02a8 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 1 Oct 2025 07:41:29 +0800 Subject: [PATCH 1325/1799] Update metadata in 6 topics --- docs/build/cmake-predefined-configuration-reference.md | 2 +- docs/c-runtime-library/reference/strdate-s-wstrdate-s.md | 3 +-- ...to-sink-windows-forms-events-from-native-cpp-classes.md | 5 ++--- docs/ide/adding-a-generic-cpp-class.md | 7 +++---- docs/standard-library/indirect-array-class.md | 3 +-- docs/windows/windows-desktop-wizard.md | 5 ++--- 6 files changed, 10 insertions(+), 15 deletions(-) diff --git a/docs/build/cmake-predefined-configuration-reference.md b/docs/build/cmake-predefined-configuration-reference.md index 702bb64d066..36e2fa06ee1 100644 --- a/docs/build/cmake-predefined-configuration-reference.md +++ b/docs/build/cmake-predefined-configuration-reference.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: CMake predefined build configurations" title: "CMake predefined configuration reference" +description: "Learn more about: CMake predefined build configurations" ms.description: "Visual Studio provides several predefined build configurations for CMake projects on Linux, Windows, ARM, and IoT." ms.date: 08/03/2021 helpviewer_keywords: ["CMake redefined configurations"] diff --git a/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md b/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md index 6cea74da858..78db9567430 100644 --- a/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md +++ b/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md @@ -1,14 +1,13 @@ --- title: "_strdate_s, _wstrdate_s" description: "_strdate_s and _wstrdate_s are secure CRT versions of the _strdate and _wstrdate functions that put the current date in a buffer." -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_strdate_s", "_wstrdate_s", "_o__strdate_s", "_o__wstrdate_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-time-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_strdate_s", "wstrdate_s", "_wstrdate_s", "strdate_s", "_tstrdate_s"] helpviewer_keywords: ["dates, copying", "tstrdate_s function", "wstrdate_s function", "_tstrdate_s function", "strdate_s function", "copying dates", "_strdate_s function", "_wstrdate_s function"] -ms.assetid: d41d8ea9-e5ce-40d4-864e-1ac29b455991 --- # `_strdate_s`, `_wstrdate_s` diff --git a/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md b/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md index af52b7b7635..71f5f0f5e8c 100644 --- a/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md +++ b/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: How to: Sink Windows Forms Events from Native C++ Classes" title: "How to: Sink Windows Forms Events from Native C++ Classes" +description: "Learn more about: How to: Sink Windows Forms Events from Native C++ Classes" +ms.date: 11/04/2016 ms.custom: "get-started-article" -ms.date: "11/04/2016" helpviewer_keywords: ["event handling, managed/native interop", "event handling, sinking .NET in C++", "event handling, .NET/native interop", "event handling, Windows Forms in C++"] -ms.assetid: 6e30ddee-d058-4c8d-9956-2a43d86f19d5 --- # How to: Sink Windows Forms Events from Native C++ Classes diff --git a/docs/ide/adding-a-generic-cpp-class.md b/docs/ide/adding-a-generic-cpp-class.md index 6d7a33e4c9e..48e95baf99b 100644 --- a/docs/ide/adding-a-generic-cpp-class.md +++ b/docs/ide/adding-a-generic-cpp-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Add a generic C++ class" title: "Add a generic C++ class" -ms.date: "11/09/2018" +description: "Learn more about: Add a generic C++ class" +ms.date: 11/09/2018 +ms.topic: how-to f1_keywords: ["vc.codewiz.classes.adding.generic", "vc.codewiz.class.generic"] helpviewer_keywords: ["Visual C++, classes", "generic classes, adding", "generic classes", "generic C++ class wizard [C++]"] -ms.assetid: e95a5a14-dbed-4edc-8551-344fe48613cb -ms.topic: how-to --- # Add a generic C++ class diff --git a/docs/standard-library/indirect-array-class.md b/docs/standard-library/indirect-array-class.md index f123ae4e00b..8b49ff5f8fe 100644 --- a/docs/standard-library/indirect-array-class.md +++ b/docs/standard-library/indirect-array-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: indirect_array class" title: "indirect_array class" +description: "Learn more about: indirect_array class" ms.date: 01/12/2022 f1_keywords: ["valarray/std::indirect_array"] helpviewer_keywords: ["indirect_array class"] -ms.assetid: 10e1eaea-ba5a-405c-a25e-7bdd3eee7fc7 --- # `indirect_array` class diff --git a/docs/windows/windows-desktop-wizard.md b/docs/windows/windows-desktop-wizard.md index 8a68d0885af..7a46ed9de10 100644 --- a/docs/windows/windows-desktop-wizard.md +++ b/docs/windows/windows-desktop-wizard.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Windows Desktop Wizard" title: "Windows Desktop Wizard" -ms.date: "03/29/2019" +description: "Learn more about: Windows Desktop Wizard" +ms.date: 03/29/2019 f1_keywords: ["vc.appwiz.win32.overview", "vc.appwiz.win32.appset"] helpviewer_keywords: ["Windows Desktop Wizard", "Win32 Project Wizard"] -ms.assetid: 5d7b3a5e-8461-479a-969a-67b7883725b9 --- # Windows Desktop Wizard From 55f0210cfa00b5e2f6423f4f005615b049502c75 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 30 Sep 2025 16:48:51 -0700 Subject: [PATCH 1326/1799] annotate new linkage info --- .../ctime-ctime32-ctime64-wctime-wctime32-wctime64.md | 10 ++++++++-- ...me32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md | 10 ++++++++-- .../reference/difftime-difftime32-difftime64.md | 9 ++++++++- ...-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md | 8 +++++++- .../reference/ftime-ftime32-ftime64.md | 8 +++++++- .../reference/futime-futime32-futime64.md | 8 +++++++- .../reference/gmtime-gmtime32-gmtime64.md | 9 ++++++++- .../reference/gmtime-s-gmtime32-s-gmtime64-s.md | 9 ++++++++- .../reference/localtime-localtime32-localtime64.md | 9 ++++++++- .../localtime-s-localtime32-s-localtime64-s.md | 9 ++++++++- .../reference/mkgmtime-mkgmtime32-mkgmtime64.md | 9 ++++++++- .../reference/mktime-mktime32-mktime64.md | 9 ++++++++- docs/c-runtime-library/reference/stat-functions.md | 8 +++++++- docs/c-runtime-library/reference/strnlen-strnlen-s.md | 10 ++++++++-- .../c-runtime-library/reference/time-time32-time64.md | 9 ++++++++- .../timespec-get-timespec32-get-timespec64-get1.md | 9 ++++++++- .../utime-utime32-utime64-wutime-wutime32-wutime64.md | 11 +++++++++-- 17 files changed, 133 insertions(+), 21 deletions(-) diff --git a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md index 0b2cc7c948b..f14ab2c8924 100644 --- a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md +++ b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md @@ -17,10 +17,10 @@ Convert a time value to a string and adjust for local time zone settings. More s ## Syntax ```C -char *ctime( const time_t *sourceTime ); +char *ctime( const time_t *sourceTime ); // See note in remarks section about linkage char *_ctime32( const __time32_t *sourceTime ); char *_ctime64( const __time64_t *sourceTime ); -wchar_t *_wctime( const time_t *sourceTime ); +wchar_t *_wctime( const time_t *sourceTime ); // See note in remarks section about linkage wchar_t *_wctime32( const __time32_t *sourceTime ); wchar_t *_wctime64( const __time64_t *sourceTime ); ``` @@ -62,6 +62,12 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ +> This applies to the following functions: ctime, _wctime + ### Generic-text routine mappings | TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index fcf23eb2ceb..669ca4102de 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -16,7 +16,7 @@ Convert a time value to a string and adjust for local time zone settings. These ## Syntax ```C -errno_t ctime_s( +errno_t ctime_s( // See note in remarks section about linkage char* buffer, size_t numberOfElements, const time_t *sourceTime @@ -31,7 +31,7 @@ errno_t _ctime64_s( size_t numberOfElements, const __time64_t *sourceTime ); -errno_t _wctime_s( +errno_t _wctime_s( // See note in remarks section about linkage wchar_t* buffer, size_t numberOfElements, const time_t *sourceTime @@ -124,6 +124,12 @@ The debug library versions of these functions first fill the buffer with 0xFE. T By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ +> This applies to the following functions: ctime_s, _wctime_s + ### Generic-text routine mappings | TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | diff --git a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md index b5825758e25..ef234072630 100644 --- a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md +++ b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md @@ -17,7 +17,7 @@ Finds the difference between two times. ## Syntax ```C -double difftime( time_t timeEnd, time_t timeStart ); +double difftime( time_t timeEnd, time_t timeStart ); // See note in remarks section about linkage double _difftime32( __time32_t timeEnd, __time32_t timeStart ); double _difftime64( __time64_t timeEnd, __time64_t timeStart ); ``` @@ -46,6 +46,13 @@ These functions validate their parameters. If either of the parameters is zero o By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: difftime + ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md b/docs/c-runtime-library/reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md index 41ce094bccc..1d9c6e67532 100644 --- a/docs/c-runtime-library/reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md +++ b/docs/c-runtime-library/reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md @@ -16,7 +16,7 @@ Gets information about an open file. ## Syntax ```C -int _fstat( +int _fstat( // See note in remarks section about linkage int fd, struct _stat *buffer ); @@ -81,6 +81,12 @@ Unless `_USE_32BIT_TIME_T` is defined, **`_fstat`** is equivalent to **`_fstat64 By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ +> This applies to the following functions: _fstat + ### Time type and file length type variations of `_stat` | Functions | `_USE_32BIT_TIME_T` defined? | Time type | File length type | diff --git a/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md b/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md index 7cb0247f80a..692dfa3aa2a 100644 --- a/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md +++ b/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md @@ -17,7 +17,7 @@ Get the current time. More secure versions of these functions are available; see ## Syntax ```C -void _ftime( struct _timeb *timeptr ); +void _ftime( struct _timeb *timeptr ); // See note in remarks section about linkage void _ftime32( struct __timeb32 *timeptr ); void _ftime64( struct __timeb64 *timeptr ); ``` @@ -46,6 +46,12 @@ The **`_ftime`** function is equivalent to **`_ftime64`**, and `_timeb` contains By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ +> This applies to the following functions: _ftime + ## Requirements | Function | Required header | diff --git a/docs/c-runtime-library/reference/futime-futime32-futime64.md b/docs/c-runtime-library/reference/futime-futime32-futime64.md index a8b38058097..d43295df933 100644 --- a/docs/c-runtime-library/reference/futime-futime32-futime64.md +++ b/docs/c-runtime-library/reference/futime-futime32-futime64.md @@ -17,7 +17,7 @@ Sets the modification time on an open file. ## Syntax ```C -int _futime( +int _futime( // See note in remarks section about linkage int fd, struct _utimbuf *filetime ); @@ -51,6 +51,12 @@ The **`_futime`** routine sets the modification date and the access time on the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ +> This applies to the following functions: _futime + ## Requirements | Function | Required header | Optional header | diff --git a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md index 1d0656b3f72..331aee5237a 100644 --- a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md +++ b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md @@ -16,7 +16,7 @@ Converts a `time_t` time value to a `tm` structure. More secure versions of thes ## Syntax ```C -struct tm *gmtime( const time_t *sourceTime ); +struct tm *gmtime( const time_t *sourceTime ); // See note in remarks section about linkage struct tm *_gmtime32( const __time32_t *sourceTime ); struct tm *_gmtime64( const __time64_t *sourceTime ); ``` @@ -56,6 +56,13 @@ The **`_gmtime32`** function breaks down the *`sourceTime`* value and stores it By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: gmtime + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md index 91517017143..4510a2090bf 100644 --- a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md +++ b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md @@ -16,7 +16,7 @@ Converts a time value to a `tm` structure. These functions are versions of [`_gm ## Syntax ```C -errno_t gmtime_s( +errno_t gmtime_s( // See note in remarks section about linkage struct tm* tmDest, const __time_t* sourceTime ); @@ -76,6 +76,13 @@ Each of the structure fields is of type **`int`**, as shown in the following tab By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: gmtime_s + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md index 746082c2ad8..c3c19a20dcc 100644 --- a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md +++ b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md @@ -17,7 +17,7 @@ Converts a time value and corrects for the local time zone. More secure versions ## Syntax ```C -struct tm *localtime( const time_t *sourceTime ); +struct tm *localtime( const time_t *sourceTime ); // See note in remarks section about linkage struct tm *_localtime32( const __time32_t *sourceTime ); struct tm *_localtime64( const __time64_t *sourceTime ); ``` @@ -72,6 +72,13 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: localtime + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index 64aebc449d6..943d9fa96db 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -17,7 +17,7 @@ Converts a **`time_t`** time value to a **`tm`** structure, and corrects for the ## Syntax ```C -errno_t localtime_s( +errno_t localtime_s( // See note in remarks section about linkage struct tm* const tmDest, time_t const* const sourceTime ); @@ -84,6 +84,13 @@ If the **`TZ`** environment variable is set, the C run-time library assumes rule By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: localtime_s + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md index c692db99002..d7970373b52 100644 --- a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md +++ b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md @@ -16,7 +16,7 @@ Converts a UTC time represented by a **`struct tm`** to a UTC time represented b ## Syntax ```C -time_t _mkgmtime( +time_t _mkgmtime( // See note in remarks section about linkage struct tm* timeptr ); __time32_t _mkgmtime32( @@ -48,6 +48,13 @@ The range of the **`_mkgmtime32`** function is from midnight, January 1, 1970, U Both **`gmtime`** and **`localtime`** use a common static buffer for the conversion. If you supply this buffer to **`_mkgmtime`**, the previous contents are destroyed. +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: _mkgmtime + ## Examples ```C diff --git a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md index 51d9a4265a6..13214c3d9f4 100644 --- a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md +++ b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md @@ -16,7 +16,7 @@ Convert the local time to a calendar value. ## Syntax ```C -time_t mktime( +time_t mktime( // See note in remarks section about linkage struct tm *timeptr ); __time32_t _mktime32( @@ -62,6 +62,13 @@ These functions validate their parameter. If *`timeptr`* is a null pointer, the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: mktime + ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/reference/stat-functions.md b/docs/c-runtime-library/reference/stat-functions.md index b1a5efc58ff..cf2f96d442f 100644 --- a/docs/c-runtime-library/reference/stat-functions.md +++ b/docs/c-runtime-library/reference/stat-functions.md @@ -16,7 +16,7 @@ Get status information on a file. ## Syntax ```C -int _stat( +int _stat( // See note in remarks section about linkage const char *path, struct _stat *buffer ); @@ -100,6 +100,12 @@ This function validates its parameters. If either *`path`* or *`buffer`* is `NUL By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ +> This applies to the following functions: _stat + ### Time type and file length type variations of `_stat` | Functions | `_USE_32BIT_TIME_T` defined | Time type | File length type | diff --git a/docs/c-runtime-library/reference/strnlen-strnlen-s.md b/docs/c-runtime-library/reference/strnlen-strnlen-s.md index d74f2d71dc1..9be6378f434 100644 --- a/docs/c-runtime-library/reference/strnlen-strnlen-s.md +++ b/docs/c-runtime-library/reference/strnlen-strnlen-s.md @@ -24,7 +24,7 @@ size_t strnlen( const char *str, size_t numberOfElements ); -size_t strnlen_s( +size_t strnlen_s( // See note in remarks section about linkage const char *str, size_t numberOfElements ); @@ -32,7 +32,7 @@ size_t wcsnlen( const wchar_t *str, size_t numberOfElements ); -size_t wcsnlen_s( +size_t wcsnlen_s( // See note in remarks section about linkage const wchar_t *str, size_t numberOfElements ); @@ -88,6 +88,12 @@ Each of these functions returns the number of characters in *`str`*, not includi By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ +> This applies to the following functions: strnlen_s, wcsnlen_s + ### Generic-text routine mappings | `TCHAR.H` routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | diff --git a/docs/c-runtime-library/reference/time-time32-time64.md b/docs/c-runtime-library/reference/time-time32-time64.md index 782e7aa8359..e6618981943 100644 --- a/docs/c-runtime-library/reference/time-time32-time64.md +++ b/docs/c-runtime-library/reference/time-time32-time64.md @@ -17,7 +17,7 @@ Gets the system time. ## Syntax ```C -time_t time( time_t *destTime ); +time_t time( time_t *destTime ); // See note in remarks section about linkage __time32_t _time32( __time32_t *destTime ); __time64_t _time64( __time64_t *destTime ); ``` @@ -37,6 +37,13 @@ The **`time`** function returns the number of seconds elapsed since midnight (00 **`time`** is a wrapper for **`_time64`** and **`time_t`** is, by default, equivalent to **`__time64_t`**. If you need to force the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, you can define `_USE_32BIT_TIME_T`. We don't recommend `_USE_32BIT_TIME_T`, because your application may fail after January 18, 2038; the use of this macro isn't allowed on 64-bit platforms. +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: time + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md index e14e404ae67..7f77bc722ea 100644 --- a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md +++ b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md @@ -17,7 +17,7 @@ Sets the interval pointed to by the first argument to the current calendar time, ## Syntax ```C -int timespec_get( +int timespec_get( // See note in remarks section about linkage struct timespec* const time_spec, int const base ); @@ -55,6 +55,13 @@ These functions support only `TIME_UTC` as the *`base`* value. `TIME_UTC` sets t By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: timespec_get + ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md index d5a82ee0b63..7f57cbfe0bb 100644 --- a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md +++ b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md @@ -17,7 +17,7 @@ Set the file modification time. ## Syntax ```C -int _utime( +int _utime( // See note in remarks section about linkage const char *filename, struct _utimbuf *times ); @@ -29,7 +29,7 @@ int _utime64( const char *filename, struct __utimbuf64 *times ); -int _wutime( +int _wutime( // See note in remarks section about linkage const wchar_t *filename, struct _utimbuf *times ); @@ -85,6 +85,13 @@ Specific versions of the `_utimbuf` structure (`__utimbuf32` and `__utimbuf64`) By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ +> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ +> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ +> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> This applies to the following functions: _utime, _wutime + ### Generic-text routine mappings | TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | From 6fb63f0aeb97a32332b6f7509346bed36a566604 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 1 Oct 2025 09:39:09 +0800 Subject: [PATCH 1327/1799] Remove bunch of stray characters in "`` operators" reference --- docs/standard-library/chrono-operators.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/standard-library/chrono-operators.md b/docs/standard-library/chrono-operators.md index 64931b76072..f5effbda16a 100644 --- a/docs/standard-library/chrono-operators.md +++ b/docs/standard-library/chrono-operators.md @@ -303,7 +303,7 @@ constexpr year_month_weekday_last operator-(const year_month_weekday_last& ymwdl 8\) Returns the number of days between two weekdays. -9\) Returns `year(int(y)-ys.count)())` +9\) Returns `year(int(y)-ys.count())` 10\) Returns `years(int(y) - int(y2))`. Subtracting two `year` values results in a `std::chrono::years`, which represents the difference in years between `y` and `y2`. For example, `2021y-2000y` produces `years(21)`. @@ -669,7 +669,7 @@ The right object to compare. 2\) Returns **`true`** if *`Left`* and *`Right`* represent the same point in time. Otherwise, returns **`false`**.\ 3-17\) Returns **`true`** if *`Left`* and *`Right`* have the same value. Otherwise, returns **`false`**.\ 18\) Returns **`true`** if `Left.name() == Right.name()`. Otherwise, returns **`false`**.\ -19\) Returns **`true`** if `Left.get_time_zone() == _Right.get_time_zone() && Left.get_sys_time() == Right.get_sys_time();` +19\) Returns **`true`** if `Left.get_time_zone() == Right.get_time_zone() && Left.get_sys_time() == Right.get_sys_time();` ## `operator>` @@ -1118,7 +1118,7 @@ The output stream you passed in, `os` 21\) In Microsoft's implementation, a `sys_info` is output as its `begin`, `end`, `offset`, `save`, and `abbrev` fields. For example: `begin: 2021-03-14 10:00:00, end: 2021-11-07 09:00:00, offset: -25200s, save: 60min, abbrev: PDT` -22\) In Microsoft's implementation, a `local_info` is output as yyyy-mm-dd hh:mm::ss.ssssss. For example, `2021-09-17 13:55:59.6590120` +22\) In Microsoft's implementation, a `local_info` is output as yyyy-mm-dd hh:mm:ss.ssssss. For example, `2021-09-17 13:55:59.6590120` 23\) The local time in the `zoned_time` (obtained as `zt.get_local_time()`) is output using the format yyyy-mm-dd hh:mm:ss timezone. For example, `2021-09-15 10:45:00 GMT-6` @@ -1160,7 +1160,7 @@ constexpr duration::type 2) template -constexpr typename common_type, duration>::type +constexpr typename common_type, duration>::type operator%( const duration& Left, const duration& Right); @@ -1214,7 +1214,7 @@ A `duration` object. *`Div`*\ An integral value. -*`Left`*\w +*`Left`*\ The left `duration` object. *`Right`*\ From dd8311c691ea0f4326b31de62c276096f47db5d8 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 1 Oct 2025 09:42:16 +0800 Subject: [PATCH 1328/1799] Fix comment in `operator-` example in "`` operators" reference --- docs/standard-library/chrono-operators.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/chrono-operators.md b/docs/standard-library/chrono-operators.md index f5effbda16a..2744ff09e22 100644 --- a/docs/standard-library/chrono-operators.md +++ b/docs/standard-library/chrono-operators.md @@ -362,7 +362,7 @@ int main() // year_month_day_last year_month_day_last ymdl = June / last / 2021; - std::cout << ymdl - years{1} - months{1} << '\n'; // 2022/Jul/last + std::cout << ymdl - years{1} - months{1} << '\n'; // 2020/May/last // year_month_weekday year_month_weekday ymw{ year(1997) / January / Wednesday[1] }; From aab742ad1cbd3aee01a5076d5b9b824989762f54 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 1 Oct 2025 09:42:43 +0800 Subject: [PATCH 1329/1799] Fix "a" typo in "`` operators" reference --- docs/standard-library/chrono-operators.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/chrono-operators.md b/docs/standard-library/chrono-operators.md index 2744ff09e22..5314f3aefcb 100644 --- a/docs/standard-library/chrono-operators.md +++ b/docs/standard-library/chrono-operators.md @@ -1438,7 +1438,7 @@ operator/(const month_weekday_last& mwdl, int y) noexcept; // C++20 The day. Provided either as an integer in the range [1,31], or as a [`day`](day-class.md). *`lastspec`*\ -An empty tag type that indicates the last item in s sequence. For example, `2021y/May/last` is the last day of May 2021. +An empty tag type that indicates the last item in a sequence. For example, `2021y/May/last` is the last day of May 2021. *`m`*\ The month. Provided either as an integer in the range [1,12], or as a [`month`](month-class.md). From da0761be656f232a55ce8d3e2bf3f7b028b53e38 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 1 Oct 2025 09:50:24 +0800 Subject: [PATCH 1330/1799] Fix wrong `operator<=>` example output in "`` operators" reference --- docs/standard-library/chrono-operators.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/chrono-operators.md b/docs/standard-library/chrono-operators.md index 5314f3aefcb..cd24d6622b6 100644 --- a/docs/standard-library/chrono-operators.md +++ b/docs/standard-library/chrono-operators.md @@ -846,8 +846,8 @@ int main() ``` ```output -d1 < d2 -true true false +d1 > d2 +true true false ``` ## `operator<<` From abc900884e9b4334ce60ef02a87c4d445df56a3b Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 1 Oct 2025 09:54:28 +0800 Subject: [PATCH 1331/1799] Trim unnecessary spaces in "`` operators" reference --- docs/standard-library/chrono-operators.md | 32 +++++++++++------------ 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/standard-library/chrono-operators.md b/docs/standard-library/chrono-operators.md index cd24d6622b6..f8621ffba27 100644 --- a/docs/standard-library/chrono-operators.md +++ b/docs/standard-library/chrono-operators.md @@ -23,7 +23,7 @@ Addition operator for the following types: - [`year_month_weekday_last`](year-month-weekday-last-class.md) ```cpp -1) +1) template constexpr typename common_type, duration>::type operator+( @@ -46,7 +46,7 @@ time_point, Durati 4) constexpr day operator+(const day& d, const days& ds) noexcept; // C++20 -constexpr day operator+(const days& ds, const day& d) noexcept; // C++20 +constexpr day operator+(const days& ds, const day& d) noexcept; // C++20 5) constexpr month operator+(const month& m, const months& ms) noexcept; // C++20 @@ -107,7 +107,7 @@ constexpr year_month_weekday_last operator+(const years& dy, const year_month_we 2-3\) Return a `time_point` object that represents a point in time that is displaced by the interval *`Dur`* from the point in time *`Time`*. -4\) Returns the result of `d+ds.count()`. If the result is out of the range [0, 255], then the result is unspecified. +4\) Returns the result of `d+ds.count()`. If the result is out of the range [0, 255], then the result is unspecified. 5\) Returns the result of `m+ms.count()`. If the result is out of the range [1, 12], it's reduced modulo 12 and then +1. @@ -117,13 +117,13 @@ constexpr year_month_weekday_last operator+(const years& dy, const year_month_we 8\) Returns the result of adding the number of months and years to the specified month and year. -9\) Returns the result of adding months or years to a `year_month_day`. If `ymd.month()` is `February` and `ymd.day()` is not in the range [1d, 28d], `ok()` may return `false` for the result of the addition. +9\) Returns the result of adding months or years to a `year_month_day`. If `ymd.month()` is `February` and `ymd.day()` is not in the range [1d, 28d], `ok()` may return `false` for the result of the addition. 10\) Returns `(ymdl.year() / ymdl.month() + dm) / last`. Note: The `/` used here isn't a division operator. It's the date operator. 11\) Returns `ymdl + dm`. -12\) Returns `{ymdl.year()+dy, ymdl.month_day_last()}` +12\) Returns `{ymdl.year()+dy, ymdl.month_day_last()}` 13\) Returns `ymwd + dm.count()`. @@ -163,12 +163,12 @@ int main() // year_month_weekday year_month_weekday ymw{ year(1997) / January / Wednesday[1] }; std::cout << ymw + months{1} << '\n'; // 1997/Feb/Wed[1] - std::cout << ymw + years{1} << '\n'; // 1998/Jan/Wed[1] + std::cout << ymw + years{1} << '\n'; // 1998/Jan/Wed[1] // year_month_weekday_last year_month_weekday_last ymwl{ year(1997) / January / Wednesday[last] }; std::cout << ymwl + months{ 1 } << '\n'; // 1997/Feb/Wed[last] - std::cout << ymwl + years{ 1 } << '\n'; // 1998/Jan/Wed[last] + std::cout << ymwl + years{ 1 } << '\n'; // 1998/Jan/Wed[last] return 0; } @@ -295,7 +295,7 @@ constexpr year_month_weekday_last operator-(const year_month_weekday_last& ymwdl 4\) Returns the result of `d-ds.count()`. If the result is out of the range [0, 255], then the result is unspecified. -5\) If `m.ok() == true` and `ms.ok() == true`, returns the result of subtracting the two month values, or subtracting the number of months. The result will be in the range [1, 12]. If the result is negative, it wraps around. For example, subtracting one month from January (`month m1{1} - months{1};` results in 12 (December). +5\) If `m.ok() == true` and `ms.ok() == true`, returns the result of subtracting the two month values, or subtracting the number of months. The result will be in the range [1, 12]. If the result is negative, it wraps around. For example, subtracting one month from January (`month m1{1} - months{1};` results in 12 (December). 6\) Returns the difference in months between *`Left`* and *`Right`* @@ -336,10 +336,10 @@ int main() { // day day d{10}; - d = d - days(5); + d = d - days(5); std::cout << d << '\n'; // 05 - // month + // month month m{2}; m = m - months{1}; std::cout << m << '\n'; // Jan @@ -367,13 +367,13 @@ int main() // year_month_weekday year_month_weekday ymw{ year(1997) / January / Wednesday[1] }; std::cout << ymw - months{1} << '\n'; // 1996/Dec/Wed[1] - std::cout << ymw - years{1} << '\n'; // 1996/Jan/Wed[1] + std::cout << ymw - years{1} << '\n'; // 1996/Jan/Wed[1] // year_month_weekday_last year_month_weekday_last ymwl{ year(1997) / January / Wednesday[last] }; std::cout << ymwl - months{ 1 } << '\n'; // 1996/Dec/Wed[last] std::cout << ymwl - years{ 1 } << '\n'; // 1996/Jan/Wed[last] - + return 0; } ``` @@ -458,7 +458,7 @@ The right `duration` or `time_point` object. ### Return value 1\) Returns **`true`** if the number of ticks for the type common to *`Left`* and *`Right`* aren't equal. Otherwise, returns **`false`**.\ -2\) Returns **`true`** if the two [`time_point`](time-point-class.md) objects don't represent the same point in time. Otherwise, returns **`false`**. +2\) Returns **`true`** if the two [`time_point`](time-point-class.md) objects don't represent the same point in time. Otherwise, returns **`false`**. ## `operator*` @@ -644,7 +644,7 @@ constexpr bool operator==(const year_month_day_last& Left, const year_month_day_ // 16) year_month_weekday constexpr bool operator==(const year_month_weekday& Left, const year_month_weekday& Right) noexcept; // C++20 -// 17) year_month_weekday_last +// 17) year_month_weekday_last constexpr bool operator==(const year_month_weekday_last& Left, const year_month_weekday_last& Right) noexcept; // C++20 // 18) time_zone_link @@ -678,7 +678,7 @@ The right object to compare. 2\) Determines if the point in time since the epoch of the `Left`[`time_point`](../standard-library/time-point-class.md) is greater than the time since the epoch of the `time_point` in `Right`. ```cpp -1) +1) template constexpr bool operator>( const duration& Left, @@ -1262,7 +1262,7 @@ operator/(const year& y, const month& m) noexcept; // C++20 // 2 constexpr year_month operator/(const year& y, int m) noexcept; // C++20 - + ///////// returns month_day // 3 From eff4d936720032e6e8cbb20a7b0b5b24a85e16da Mon Sep 17 00:00:00 2001 From: Alex Guteniev Date: Wed, 1 Oct 2025 16:59:02 +0300 Subject: [PATCH 1332/1799] Link to documentation on how to set macro globally --- docs/standard-library/vectorized-stl-algorithms.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 65e7d3b6659..df6b030e196 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -30,7 +30,7 @@ The manually vectorized algorithms use template meta-programming to detect the s Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. In case of any problem, you can disable manual vectorization by defining the `_USE_STD_VECTOR_ALGORITHMS` macro set to 0. It defaults to 1 on x64 and x86, which means that manually vectorized algorithms are enabled by default. -When overriding `_USE_STD_VECTOR_ALGORITHMS` make sure to set the same value for all linked translation units that use algorithms. Reliable way to achieve that is using project properties rather than defining it in the source. +When overriding `_USE_STD_VECTOR_ALGORITHMS` make sure to set the same value for all linked translation units that use algorithms. Reliable way to achieve that is using project properties rather than defining it in the source. See [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md) compiler option. The following algorithms have manual vectorization controlled via `_USE_STD_VECTOR_ALGORITHMS` macro: - `contains` From 3bea6da38e00cdbedcc24fb0a1f675a9ce6f7322 Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 27 Aug 2025 10:25:48 -0600 Subject: [PATCH 1333/1799] [dev18] new docs for new alloc/dealloc mismatch warning ADO feature PR: https://devdiv.visualstudio.com/DevDiv/_git/msvc/pullrequest/641019 Dev18 introduced a new C26840 warning that encompasses what was previously warned by C6278, C6279, C6280, and C6283. This new warning uses the more precise path-sensitive analysis and should be preferred over the C6XXX family of warnings. --- docs/code-quality/c26840.md | 52 +++++++++++++++++++++++++++++++++++++ docs/code-quality/c6278.md | 4 +++ docs/code-quality/c6279.md | 6 +++++ docs/code-quality/c6280.md | 6 +++++ docs/code-quality/c6283.md | 6 +++++ 5 files changed, 74 insertions(+) create mode 100644 docs/code-quality/c26840.md diff --git a/docs/code-quality/c26840.md b/docs/code-quality/c26840.md new file mode 100644 index 00000000000..7175588d5c2 --- /dev/null +++ b/docs/code-quality/c26840.md @@ -0,0 +1,52 @@ +--- +description: "Learn more about: Warning C26840" +title: Warning C26840 +ms.date: 10/03/2022 +f1_keywords: ["C26840", "ALLOCATION_DEALLOCATION_MISMATCH", "__WARNING_ALLOCATION_DEALLOCATION_MISMATCH"] +helpviewer_keywords: ["C26840"] +ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 # TODO (@carsonradtke): I generated this with `PS > (New-Guid).ToString()`. Is that OK? +--- +# Warning C26840 + +> Memory allocated with '' is being deallocated with ''. Use '' instead. + +## Remarks + +This warning indicates that the calling function has inconsistently allocated memory with one family of allocation functions, but freed it was a deallocation function from a different family. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. + +The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory de-allocation. It could cause inconsistent behavior for classes with destructors that perform some semantically significant operation, or memory corruptions and crashes when operators have been overridden. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools can't always distinguish between these situations. + +If memory is allocated with one family of allocation functions, it should be freed with a matching deallocation function. + +C26840 covers the following allocation/deallocation pairs: + +- C++ scalar new (`new`) must be deallocated with scalar delete (`delete`). +- C++ array new (`new[]`) must be deallocated with array delete (`delete[]`). +- C/C++ `malloc`/`calloc`/`realloc` must be deallocated with `free` (or `realloc`). +- Windows `HeapAlloc` must be deallocated with `HeapFree`. +- Windows `GlobalAlloc` must be deallocated with `GlobalFree`. +- Windows `LocalAlloc` must be deallocated with `LocalFree`. +- Windows `MIDL_user_allocate` must be deallocated with `MIDL_user_free`. +- COM `CoTaskMemAlloc` must be deallocated with `CoTaskMemFree`. + +Code analysis name: `ALLOCATION_DEALLOCATION_MISMATCH` + +## Example + +The following sample code generates warning C6278: + +```cpp +void f() { + int *pInt = (int *)calloc(10, sizeof(int)); + // code ... + delete pInt; // C26840: Memory allocated with 'calloc' is being deallocated with 'delete'. Use 'free' instead. +} + +void g() { + char * str = new char[50]; + // code ... + delete str; // C26840: Memory allocated with 'new[]' is being deallocated with 'delete'. Use 'delete[]' instead. +} +``` + +Manual memory management has many pitfalls in terms of memory leaks and exceptions. To avoid these kinds of potential leaks altogether, use the mechanisms that are provided by the C++ Standard Library (STL). These include [`shared_ptr`](../standard-library/shared-ptr-class.md), [`unique_ptr`](../standard-library/unique-ptr-class.md), and containers such as [`vector`](../standard-library/vector.md). For more information, see [Smart pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md). diff --git a/docs/code-quality/c6278.md b/docs/code-quality/c6278.md index 55e0ddb1a28..28732c2803b 100644 --- a/docs/code-quality/c6278.md +++ b/docs/code-quality/c6278.md @@ -9,6 +9,10 @@ helpviewer_keywords: ["C6278"] > '*variable*' is allocated with array new [], but deleted with scalar delete. Destructors will not be called. +## Notice + +Warning C6278 was removed in Visual Studio 18. Use the more generic warning [`C26840`](../code-quality/c26840.md) instead. + ## Remarks This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the array **`new []`** operator, but freed it with the scalar **`delete`** operator. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. diff --git a/docs/code-quality/c6279.md b/docs/code-quality/c6279.md index 8c9b92fc129..1bc960b991b 100644 --- a/docs/code-quality/c6279.md +++ b/docs/code-quality/c6279.md @@ -9,6 +9,12 @@ helpviewer_keywords: ["C6279"] > '*variable-name*' is allocated with scalar new, deleted with array delete [] +This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the scalar `new` operator, but freed it with the array `delete[]` operator. If memory is allocated with scalar `new`, it should typically be freed with scalar `delete`. + +## Notice + +Warning C6279 was removed in Visual Studio 18. Use the more generic warning [`C26840`](../code-quality/c26840.md) instead. + ## Remarks This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the scalar `new` operator, but freed it with the array `delete[]` operator. If memory is allocated with scalar `new`, it should typically be freed with scalar `delete`. diff --git a/docs/code-quality/c6280.md b/docs/code-quality/c6280.md index 0fa6146b704..65436df2366 100644 --- a/docs/code-quality/c6280.md +++ b/docs/code-quality/c6280.md @@ -9,6 +9,12 @@ helpviewer_keywords: ["C6280"] > '*variable-name*' is allocated with '*function-name-1*', but deleted with '*function-name-2*' +This warning indicates that the calling function has inconsistently allocated memory by using a function from one family and freed it by using a function from another. + +## Notice + +Warning C6280 was removed in Visual Studio 18. Use the more generic warning [`C26840`](../code-quality/c26840.md) instead. + ## Remarks This warning indicates that the calling function has inconsistently allocated memory by using a function from one family and freed it by using a function from another. diff --git a/docs/code-quality/c6283.md b/docs/code-quality/c6283.md index 4607e25d0ce..f4642ecb76c 100644 --- a/docs/code-quality/c6283.md +++ b/docs/code-quality/c6283.md @@ -9,6 +9,12 @@ helpviewer_keywords: ["C6283"] > '*variable-name*' is allocated with array new [], but deleted with scalar delete +This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the array `new []` operator, but freed it with the scalar `delete` operator. + +## Notice + +Warning C6283 was removed in Visual Studio 18. Use the more generic warning [`C26840`](../code-quality/c26840.md) instead. + ## Remarks This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the array `new []` operator, but freed it with the scalar `delete` operator. From 414dd27f9c1c53eeb64cb9728aa425f42d8b7788 Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 27 Aug 2025 10:41:23 -0600 Subject: [PATCH 1334/1799] address warnings from validation bot --- docs/code-quality/c26840.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/code-quality/c26840.md b/docs/code-quality/c26840.md index 7175588d5c2..b1ef90a944d 100644 --- a/docs/code-quality/c26840.md +++ b/docs/code-quality/c26840.md @@ -8,7 +8,7 @@ ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 # TODO (@carsonradtke): I gener --- # Warning C26840 -> Memory allocated with '' is being deallocated with ''. Use '' instead. +> Memory allocated with '\' is being deallocated with '\'. Use '\' instead. ## Remarks From b5ebc65a7296f0063eae353dd5d878b1cf55178f Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 27 Aug 2025 10:46:44 -0600 Subject: [PATCH 1335/1799] modifications a higher acrolinx score --- docs/code-quality/c26840.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/code-quality/c26840.md b/docs/code-quality/c26840.md index b1ef90a944d..aaa020904d8 100644 --- a/docs/code-quality/c26840.md +++ b/docs/code-quality/c26840.md @@ -12,9 +12,9 @@ ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 # TODO (@carsonradtke): I gener ## Remarks -This warning indicates that the calling function has inconsistently allocated memory with one family of allocation functions, but freed it was a deallocation function from a different family. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. +This warning indicates that the memory was allocated with one family of allocation functions, but was freed with a deallocation function from a different family. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. -The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory de-allocation. It could cause inconsistent behavior for classes with destructors that perform some semantically significant operation, or memory corruptions and crashes when operators have been overridden. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools can't always distinguish between these situations. +The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory deallocation. It could cause inconsistent behavior for classes with destructors that perform semantically significant operations, or memory corruptions and crashes. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools can not always distinguish between these situations. If memory is allocated with one family of allocation functions, it should be freed with a matching deallocation function. @@ -49,4 +49,4 @@ void g() { } ``` -Manual memory management has many pitfalls in terms of memory leaks and exceptions. To avoid these kinds of potential leaks altogether, use the mechanisms that are provided by the C++ Standard Library (STL). These include [`shared_ptr`](../standard-library/shared-ptr-class.md), [`unique_ptr`](../standard-library/unique-ptr-class.md), and containers such as [`vector`](../standard-library/vector.md). For more information, see [Smart pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md). +Manual memory management has many pitfalls in terms of memory leaks and exceptions. To avoid these kinds of potential leaks altogether, use the mechanisms that are provided by the C++ Standard Library (STL). These mechanisms include [`shared_ptr`](../standard-library/shared-ptr-class.md), [`unique_ptr`](../standard-library/unique-ptr-class.md), and containers such as [`vector`](../standard-library/vector.md). For more information, see [Smart pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md). From 98d4d95e77d676ab88a49e3432564ba261613642 Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 27 Aug 2025 10:52:34 -0600 Subject: [PATCH 1336/1799] fix last couple warning from bots --- docs/code-quality/c26840.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/code-quality/c26840.md b/docs/code-quality/c26840.md index aaa020904d8..bf20f3d5bf8 100644 --- a/docs/code-quality/c26840.md +++ b/docs/code-quality/c26840.md @@ -14,7 +14,7 @@ ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 # TODO (@carsonradtke): I gener This warning indicates that the memory was allocated with one family of allocation functions, but was freed with a deallocation function from a different family. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. -The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory deallocation. It could cause inconsistent behavior for classes with destructors that perform semantically significant operations, or memory corruptions and crashes. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools can not always distinguish between these situations. +The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory deallocation. It could cause inconsistent behavior for classes with destructors that perform semantically significant operations, or memory corruptions and crashes. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools cannot always distinguish between these situations. If memory is allocated with one family of allocation functions, it should be freed with a matching deallocation function. @@ -27,7 +27,7 @@ C26840 covers the following allocation/deallocation pairs: - Windows `GlobalAlloc` must be deallocated with `GlobalFree`. - Windows `LocalAlloc` must be deallocated with `LocalFree`. - Windows `MIDL_user_allocate` must be deallocated with `MIDL_user_free`. -- COM `CoTaskMemAlloc` must be deallocated with `CoTaskMemFree`. +- Component Object Model (COM) `CoTaskMemAlloc` must be deallocated with `CoTaskMemFree`. Code analysis name: `ALLOCATION_DEALLOCATION_MISMATCH` From 1c0e97d26e13e24ed0b546de8799645cad98278e Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 27 Aug 2025 10:56:10 -0600 Subject: [PATCH 1337/1799] fix last warnin from bots --- docs/code-quality/c26840.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/code-quality/c26840.md b/docs/code-quality/c26840.md index bf20f3d5bf8..1ac16e5cb4d 100644 --- a/docs/code-quality/c26840.md +++ b/docs/code-quality/c26840.md @@ -14,7 +14,7 @@ ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 # TODO (@carsonradtke): I gener This warning indicates that the memory was allocated with one family of allocation functions, but was freed with a deallocation function from a different family. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. -The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory deallocation. It could cause inconsistent behavior for classes with destructors that perform semantically significant operations, or memory corruptions and crashes. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools cannot always distinguish between these situations. +The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory deallocation. It could cause inconsistent behavior for classes with destructors that perform semantically significant operations, or memory corruptions and crashes. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools can't always distinguish between these situations. If memory is allocated with one family of allocation functions, it should be freed with a matching deallocation function. From 201a05153bd6b42a8bb8bd6e274dd3d5b650c090 Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 27 Aug 2025 11:01:40 -0600 Subject: [PATCH 1338/1799] warning is C26865, not C26840. oops --- docs/code-quality/c26840.md | 52 ------------------------------------- docs/code-quality/c6278.md | 2 +- docs/code-quality/c6279.md | 2 +- docs/code-quality/c6280.md | 2 +- docs/code-quality/c6283.md | 2 +- 5 files changed, 4 insertions(+), 56 deletions(-) delete mode 100644 docs/code-quality/c26840.md diff --git a/docs/code-quality/c26840.md b/docs/code-quality/c26840.md deleted file mode 100644 index 1ac16e5cb4d..00000000000 --- a/docs/code-quality/c26840.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -description: "Learn more about: Warning C26840" -title: Warning C26840 -ms.date: 10/03/2022 -f1_keywords: ["C26840", "ALLOCATION_DEALLOCATION_MISMATCH", "__WARNING_ALLOCATION_DEALLOCATION_MISMATCH"] -helpviewer_keywords: ["C26840"] -ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 # TODO (@carsonradtke): I generated this with `PS > (New-Guid).ToString()`. Is that OK? ---- -# Warning C26840 - -> Memory allocated with '\' is being deallocated with '\'. Use '\' instead. - -## Remarks - -This warning indicates that the memory was allocated with one family of allocation functions, but was freed with a deallocation function from a different family. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. - -The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory deallocation. It could cause inconsistent behavior for classes with destructors that perform semantically significant operations, or memory corruptions and crashes. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools can't always distinguish between these situations. - -If memory is allocated with one family of allocation functions, it should be freed with a matching deallocation function. - -C26840 covers the following allocation/deallocation pairs: - -- C++ scalar new (`new`) must be deallocated with scalar delete (`delete`). -- C++ array new (`new[]`) must be deallocated with array delete (`delete[]`). -- C/C++ `malloc`/`calloc`/`realloc` must be deallocated with `free` (or `realloc`). -- Windows `HeapAlloc` must be deallocated with `HeapFree`. -- Windows `GlobalAlloc` must be deallocated with `GlobalFree`. -- Windows `LocalAlloc` must be deallocated with `LocalFree`. -- Windows `MIDL_user_allocate` must be deallocated with `MIDL_user_free`. -- Component Object Model (COM) `CoTaskMemAlloc` must be deallocated with `CoTaskMemFree`. - -Code analysis name: `ALLOCATION_DEALLOCATION_MISMATCH` - -## Example - -The following sample code generates warning C6278: - -```cpp -void f() { - int *pInt = (int *)calloc(10, sizeof(int)); - // code ... - delete pInt; // C26840: Memory allocated with 'calloc' is being deallocated with 'delete'. Use 'free' instead. -} - -void g() { - char * str = new char[50]; - // code ... - delete str; // C26840: Memory allocated with 'new[]' is being deallocated with 'delete'. Use 'delete[]' instead. -} -``` - -Manual memory management has many pitfalls in terms of memory leaks and exceptions. To avoid these kinds of potential leaks altogether, use the mechanisms that are provided by the C++ Standard Library (STL). These mechanisms include [`shared_ptr`](../standard-library/shared-ptr-class.md), [`unique_ptr`](../standard-library/unique-ptr-class.md), and containers such as [`vector`](../standard-library/vector.md). For more information, see [Smart pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md). diff --git a/docs/code-quality/c6278.md b/docs/code-quality/c6278.md index 28732c2803b..0ca2e0f711e 100644 --- a/docs/code-quality/c6278.md +++ b/docs/code-quality/c6278.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C6278"] ## Notice -Warning C6278 was removed in Visual Studio 18. Use the more generic warning [`C26840`](../code-quality/c26840.md) instead. +Warning C6278 was removed in Visual Studio 18. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. ## Remarks diff --git a/docs/code-quality/c6279.md b/docs/code-quality/c6279.md index 1bc960b991b..14e351303b0 100644 --- a/docs/code-quality/c6279.md +++ b/docs/code-quality/c6279.md @@ -13,7 +13,7 @@ This warning appears only in C++ code and indicates that the calling function ha ## Notice -Warning C6279 was removed in Visual Studio 18. Use the more generic warning [`C26840`](../code-quality/c26840.md) instead. +Warning C6279 was removed in Visual Studio 18. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. ## Remarks diff --git a/docs/code-quality/c6280.md b/docs/code-quality/c6280.md index 65436df2366..24563a216c3 100644 --- a/docs/code-quality/c6280.md +++ b/docs/code-quality/c6280.md @@ -13,7 +13,7 @@ This warning indicates that the calling function has inconsistently allocated me ## Notice -Warning C6280 was removed in Visual Studio 18. Use the more generic warning [`C26840`](../code-quality/c26840.md) instead. +Warning C6280 was removed in Visual Studio 18. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. ## Remarks diff --git a/docs/code-quality/c6283.md b/docs/code-quality/c6283.md index f4642ecb76c..b6df584e4ff 100644 --- a/docs/code-quality/c6283.md +++ b/docs/code-quality/c6283.md @@ -13,7 +13,7 @@ This warning appears only in C++ code and indicates that the calling function ha ## Notice -Warning C6283 was removed in Visual Studio 18. Use the more generic warning [`C26840`](../code-quality/c26840.md) instead. +Warning C6283 was removed in Visual Studio 18. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. ## Remarks From 96269665565f6822ac4d58300d028090915927e1 Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 27 Aug 2025 11:20:20 -0600 Subject: [PATCH 1339/1799] forgot to git add c26865.md --- docs/code-quality/c26865.md | 52 +++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 docs/code-quality/c26865.md diff --git a/docs/code-quality/c26865.md b/docs/code-quality/c26865.md new file mode 100644 index 00000000000..0e2c4f6268a --- /dev/null +++ b/docs/code-quality/c26865.md @@ -0,0 +1,52 @@ +--- +description: "Learn more about: Warning C26865" +title: Warning C26865 +ms.date: 10/03/2022 +f1_keywords: ["C26865", "ALLOCATION_DEALLOCATION_MISMATCH", "__WARNING_ALLOCATION_DEALLOCATION_MISMATCH"] +helpviewer_keywords: ["C26865"] +ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 # TODO (@carsonradtke): I generated this with `PS > (New-Guid).ToString()`. Is that OK? +--- +# Warning C26865 + +> Memory allocated with '\' is being deallocated with '\'. Use '\' instead. + +## Remarks + +This warning indicates that the memory was allocated with one family of allocation functions, but was freed with a deallocation function from a different family. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. + +The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory deallocation. It could cause inconsistent behavior for classes with destructors that perform semantically significant operations, or memory corruptions and crashes. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools can't always distinguish between these situations. + +If memory is allocated with one family of allocation functions, it should be freed with a matching deallocation function. + +C26865 covers the following allocation/deallocation pairs: + +- C++ scalar new (`new`) must be deallocated with scalar delete (`delete`). +- C++ array new (`new[]`) must be deallocated with array delete (`delete[]`). +- C/C++ `malloc`/`calloc`/`realloc` must be deallocated with `free` (or `realloc`). +- Windows `HeapAlloc` must be deallocated with `HeapFree`. +- Windows `GlobalAlloc` must be deallocated with `GlobalFree`. +- Windows `LocalAlloc` must be deallocated with `LocalFree`. +- Windows `MIDL_user_allocate` must be deallocated with `MIDL_user_free`. +- Component Object Model (COM) `CoTaskMemAlloc` must be deallocated with `CoTaskMemFree`. + +Code analysis name: `ALLOCATION_DEALLOCATION_MISMATCH` + +## Example + +The following sample code generates warning C26865: + +```cpp +void f() { + int *pInt = (int *)calloc(10, sizeof(int)); + // code ... + delete pInt; // C26865: Memory allocated with 'calloc' is being deallocated with 'delete'. Use 'free' instead. +} + +void g() { + char * str = new char[50]; + // code ... + delete str; // C26865: Memory allocated with 'new[]' is being deallocated with 'delete'. Use 'delete[]' instead. +} +``` + +Manual memory management has many pitfalls in terms of memory leaks and exceptions. To avoid these kinds of potential leaks altogether, use the mechanisms that are provided by the C++ Standard Library (STL). These mechanisms include [`shared_ptr`](../standard-library/shared-ptr-class.md), [`unique_ptr`](../standard-library/unique-ptr-class.md), and containers such as [`vector`](../standard-library/vector.md). For more information, see [Smart pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md). From 0a7a10333b6fdcc189c1d0a40037deac99c8e22b Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 1 Oct 2025 10:41:34 -0600 Subject: [PATCH 1340/1799] VS18 -> 2026 --- docs/code-quality/c6278.md | 2 +- docs/code-quality/c6279.md | 2 +- docs/code-quality/c6280.md | 2 +- docs/code-quality/c6283.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/code-quality/c6278.md b/docs/code-quality/c6278.md index 0ca2e0f711e..44f9604a392 100644 --- a/docs/code-quality/c6278.md +++ b/docs/code-quality/c6278.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C6278"] ## Notice -Warning C6278 was removed in Visual Studio 18. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. +Warning C6278 was removed in Visual Studio 2026. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. ## Remarks diff --git a/docs/code-quality/c6279.md b/docs/code-quality/c6279.md index 14e351303b0..4107dd19b22 100644 --- a/docs/code-quality/c6279.md +++ b/docs/code-quality/c6279.md @@ -13,7 +13,7 @@ This warning appears only in C++ code and indicates that the calling function ha ## Notice -Warning C6279 was removed in Visual Studio 18. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. +Warning C6279 was removed in Visual Studio 2026. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. ## Remarks diff --git a/docs/code-quality/c6280.md b/docs/code-quality/c6280.md index 24563a216c3..8d30cbf344f 100644 --- a/docs/code-quality/c6280.md +++ b/docs/code-quality/c6280.md @@ -13,7 +13,7 @@ This warning indicates that the calling function has inconsistently allocated me ## Notice -Warning C6280 was removed in Visual Studio 18. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. +Warning C6280 was removed in Visual Studio 2026. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. ## Remarks diff --git a/docs/code-quality/c6283.md b/docs/code-quality/c6283.md index b6df584e4ff..5ae2a64d214 100644 --- a/docs/code-quality/c6283.md +++ b/docs/code-quality/c6283.md @@ -13,7 +13,7 @@ This warning appears only in C++ code and indicates that the calling function ha ## Notice -Warning C6283 was removed in Visual Studio 18. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. +Warning C6283 was removed in Visual Studio 2026. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. ## Remarks From 5dce96608911459b90dffb749fffda551b70c191 Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 1 Oct 2025 10:46:56 -0600 Subject: [PATCH 1341/1799] address various PR feedback --- docs/code-quality/c26865.md | 4 ++-- docs/code-quality/toc.yml | 2 ++ 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/code-quality/c26865.md b/docs/code-quality/c26865.md index 0e2c4f6268a..172a0f79d29 100644 --- a/docs/code-quality/c26865.md +++ b/docs/code-quality/c26865.md @@ -4,7 +4,7 @@ title: Warning C26865 ms.date: 10/03/2022 f1_keywords: ["C26865", "ALLOCATION_DEALLOCATION_MISMATCH", "__WARNING_ALLOCATION_DEALLOCATION_MISMATCH"] helpviewer_keywords: ["C26865"] -ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 # TODO (@carsonradtke): I generated this with `PS > (New-Guid).ToString()`. Is that OK? +ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 --- # Warning C26865 @@ -12,7 +12,7 @@ ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 # TODO (@carsonradtke): I gener ## Remarks -This warning indicates that the memory was allocated with one family of allocation functions, but was freed with a deallocation function from a different family. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. +This warning indicates that the memory was allocated with one family of allocation functions, but was freed with a deallocation function from a different family. This usage results in undefined behavior according to C/C++ and the Microsoft MSVC implementation. The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory deallocation. It could cause inconsistent behavior for classes with destructors that perform semantically significant operations, or memory corruptions and crashes. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools can't always distinguish between these situations. diff --git a/docs/code-quality/toc.yml b/docs/code-quality/toc.yml index 61bafc57ca1..477bb054caa 100644 --- a/docs/code-quality/toc.yml +++ b/docs/code-quality/toc.yml @@ -661,6 +661,8 @@ items: href: ../code-quality/c26863.md - name: Warning C26864 href: ../code-quality/c26864.md + - name: Warning C26864 + href: ../code-quality/c26865.md - name: Warning C28020 href: ../code-quality/c28020.md - name: Warning C28021 From 76c6ddec0dd1804f21539f183cf3bf039cdfe1be Mon Sep 17 00:00:00 2001 From: Carson Radtke Date: Wed, 1 Oct 2025 10:48:47 -0600 Subject: [PATCH 1342/1799] mention when c26865 was added to VS --- docs/code-quality/c26865.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/code-quality/c26865.md b/docs/code-quality/c26865.md index 172a0f79d29..0e9bd9d213a 100644 --- a/docs/code-quality/c26865.md +++ b/docs/code-quality/c26865.md @@ -10,6 +10,8 @@ ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 > Memory allocated with '\' is being deallocated with '\'. Use '\' instead. +This rule was added in Visual Studio 2026 18.0. + ## Remarks This warning indicates that the memory was allocated with one family of allocation functions, but was freed with a deallocation function from a different family. This usage results in undefined behavior according to C/C++ and the Microsoft MSVC implementation. From d6f6bd92d63a4abc3aa48972ea2f7dd5cb860070 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 1 Oct 2025 16:13:57 -0700 Subject: [PATCH 1343/1799] touch --- docs/standard-library/vectorized-stl-algorithms.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index df6b030e196..a71b3813405 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -1,7 +1,7 @@ --- title: "Vectorized STL Algorithms" description: "Learn more about: Vectorized STL Algorithms" -ms.date: 09/19/2025 +ms.date: 10/1/2025 f1_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS"] helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS", "Vector Algorithms", "Vectorization", "SIMD"] --- From f8904208ab97b59070fe9c2aeb64adc5bf1ab9bd Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 1 Oct 2025 17:11:57 -0700 Subject: [PATCH 1344/1799] edit pass --- .../vectorized-stl-algorithms.md | 90 ++++++++----------- 1 file changed, 37 insertions(+), 53 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index a71b3813405..6f5110236f7 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -7,89 +7,73 @@ helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_AL --- # Vectorized STL Algorithms -Under certain conditions, STL algorithms execute not element-wise, but multiple elements at once on a single CPU core. This is possible due to SIMD (single instruction, multiple data). The use of such an approach instead of element-wise approach is called vectorization. An implementation that is not vectorized is called scalar. +Under specific conditions, algorithms in the C++ Standard Template Library (STL) can process multiple elements simultaneously on a single CPU core, rather than handling each element individually. This optimization leverages single instruction, multiple data (SIMD) instructions provided by the CPU, a technique known as vectorization. When this optimization isn't applied, the implementation is referred to as scalar. -The conditions for vectorization are: - - The container or range is contiguous. `array`, `vector`, and `basic_string` are contiguous containers, `span` and `basic_string_view` provide contiguous ranges. Built-in array elements also form contiguous ranges. In contrast, `list` and `map` are not contiguous containers. - - There are such SIMD instructions available for the target platform that implement the particular algorithm on particular element types efficiently. Often this is true for plain types (like built-in integers) and simple operations. - - Either of the following: - - The compiler is capable of emitting vectorized machine code for an implementation written as scalar code (auto-vectorization) - - The implementation itself is written as vectorized code (manual vectorization) +The conditions required for vectorization are: + - The container or range must be contiguous. Examples of contiguous containers include `array`, `vector`, and `basic_string`. Contiguous ranges are provided by types like `span` and `basic_string_view`. Built-in arrays also form contiguous ranges. In contrast, containers like `list` and `map` aren't contiguous. + - The target platform must support the necessary SIMD instructions to implement the algorithm for the element types. This is typically true for intrinsic types (like built-in integers) and simple operations. + - One of the following conditions must be met: + - The compiler can emit vectorized machine code for an implementation written as scalar code (auto-vectorization). + - The algorithm's implementation is explicitly written to use vectorized code (manual vectorization). -## Auto-vectorization in STL +## Auto-vectorization in the STL -See [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion of [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch there. It applies to the STL implementation code the same way as to user code. +For more information about automatic vectorization, see [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion about in that article about the [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch. This applies to the STL implementation code the same way as to user code. Algorithms like `transform`, `reduce`, `accumulate` heavily benefit from auto-vectorization. -## Manual vectorization in STL +## Manual vectorization in the STL -For x64 and x86 targets, certain algorithms have manual vectorization implemented. This implementation is separately compiled, and uses runtime CPU dispatch, so it is engaged on suitable CPUs only. +For x64 and x86, certain algorithms include manual vectorization. This implementation is separately compiled, and uses runtime CPU dispatch, so it's only used on suitable CPUs. -The manually vectorized algorithms use template meta-programming to detect the suitable element types, so they are only vectorized for simple types, like standard integer types. +Manually vectorized algorithms use template meta-programming to detect whether the element type is suitable for vectorization. As a result, they're only vectorized for simple types such as standard integer types. -Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. In case of any problem, you can disable manual vectorization by defining the `_USE_STD_VECTOR_ALGORITHMS` macro set to 0. It defaults to 1 on x64 and x86, which means that manually vectorized algorithms are enabled by default. +Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. You can disable manual vectorization with `#define _USE_STD_VECTOR_ALGORITHMS=0'. Manually vectorized algorithms are enabled by default on x64 and x86 because it defaults to 1 on those platforms. -When overriding `_USE_STD_VECTOR_ALGORITHMS` make sure to set the same value for all linked translation units that use algorithms. Reliable way to achieve that is using project properties rather than defining it in the source. See [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md) compiler option. +To set `_USE_STD_VECTOR_ALGORITHMS` ensure that it's set to the same value for all linked translation units that use algorithms. A reliable way to achieve this to set it using in the project properties instead of in source. For more information about how to do that, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). -The following algorithms have manual vectorization controlled via `_USE_STD_VECTOR_ALGORITHMS` macro: - - `contains` - - `contains_subrange` - - `find` - - `find_last` - - `find_end` - - `find_first_of` - - `adjacent_find` +The following algorithms are manually vectorized and their behavior is controlled by the `_USE_STD_VECTOR_ALGORITHMS` macro: + - `contains`, `contains_subrange` + - `find`, `find_last`, `find_end`, `find_first_of`, `adjacent_find` - `count` - `mismatch` - - `search` - - `search_n` + - `search`, `search_n` - `swap_ranges` - `replace` - - `remove` - - `remove_copy` - - `unique` - - `unique_copy` - - `reverse` - - `reverse_copy` + - `remove`, `remove_copy` + - `unique`, `unique_copy` + - `reverse`, `reverse_copy` - `rotate` - - `is_sorted` - - `is_sorted_until` - - `max_element` - - `min_element` - - `minmax_element` - - `max` - - `min` - - `minmax` - - `lexicographical_compare` - - `lexicographical_compare_three_way` - -In addition to algorithms, the macro controls the manual vectorization of: + - `is_sorted`, `is_sorted_until` + - `lexicographical_compare`, `lexicographical_compare_three_way` + - `max`, `min`, `minmax` + - `max_element`, `min_element`, `minmax_element` + +In addition to algorithms, the `_USE_STD_VECTOR_ALGORITHMS` macro controls the manual vectorization of: + - `basic_string` and `basic_string_view` members: - `find` - `rfind` - - `find_first_of` - - `find_first_not_of` - - `find_last_of` - - `find_last_not_of` + - `find_first_of`, `find_first_not_of` + - `find_last_of`, `find_last_not_of` - `bitset` constructors from string and `bitset::to_string` ## Manually vectorized algorithms for floating point types -Vectorization of floating point types comes with extra difficulties: +Vectorization of floating point types requires additional considerations: - Vectorization may reorder operations, which can affect the precision of floating point results. - Floating point types may contain `NaN` values, which don't behave transitively on comparisons. - Floating point operations may raise exceptions. -The STL deals with the first two difficulties safely. Only `max_element`, `min_element`, `minmax_element`, `max`, `min`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: - - Do not compute new floating point values, only compare the existing values, so different order does not affect precision. - - Because they are sorting algorithms, `NaNs` are not allowed amongst the operands. +The STL deals with the first two considerations safely. Only `max_element`, `min_element`, `minmax_element`, `max`, `min`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: + - Don't compute new floating point values, only compare the existing values, so different order does not affect precision. + - Because they're sorting algorithms, `NaNs` isn't an allowed operand. -There's `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating point types. Set it to 0 to disable the vectorization. The macro has no effect if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. +Use `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating point types. Set it to 0 to disable vectorization. `_USE_STD_VECTOR_FLOATING_ALGORITHMS` has no effect if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. -`_USE_STD_VECTOR_FLOATING_ALGORITHMS` defaults to 0 when [`/fp:except`](../build/reference/fp-specify-floating-point-behavior.md#except) option is set. This is to avoid problems with exceptions. +`_USE_STD_VECTOR_FLOATING_ALGORITHMS` defaults to 0 when [`/fp:except`](../build/reference/fp-specify-floating-point-behavior.md#except) is set. -When overriding `_USE_STD_VECTOR_FLOATING_ALGORITHMS` make sure to set the same value for all linked translation units that use algorithms. Reliable way to achieve that is using project properties rather than defining it in the source. +To set `_USE_STD_VECTOR_FLOATING_ALGORITHMS` ensure that it's set to the same value for all linked translation units that use algorithms. A reliable way to achieve this to set it using in the project properties instead of in source. For more information about how to do that, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). ## See also From bc3d9cf59086304f7b68802b3d66537b55139726 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 1 Oct 2025 17:39:24 -0700 Subject: [PATCH 1345/1799] edits --- docs/standard-library/vectorized-stl-algorithms.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 6f5110236f7..cbfe7078965 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_AL --- # Vectorized STL Algorithms -Under specific conditions, algorithms in the C++ Standard Template Library (STL) can process multiple elements simultaneously on a single CPU core, rather than handling each element individually. This optimization leverages single instruction, multiple data (SIMD) instructions provided by the CPU, a technique known as vectorization. When this optimization isn't applied, the implementation is referred to as scalar. +Under specific conditions, algorithms in the C++ Standard Template Library (STL) can process multiple elements simultaneously on a single CPU core, rather than handling each element individually. This optimization uses single instruction, multiple data (SIMD) instructions provided by the CPU, a technique known as vectorization. When this optimization isn't applied, the implementation is referred to as scalar. The conditions required for vectorization are: - The container or range must be contiguous. Examples of contiguous containers include `array`, `vector`, and `basic_string`. Contiguous ranges are provided by types like `span` and `basic_string_view`. Built-in arrays also form contiguous ranges. In contrast, containers like `list` and `map` aren't contiguous. @@ -24,15 +24,16 @@ Algorithms like `transform`, `reduce`, `accumulate` heavily benefit from auto-ve ## Manual vectorization in the STL -For x64 and x86, certain algorithms include manual vectorization. This implementation is separately compiled, and uses runtime CPU dispatch, so it's only used on suitable CPUs. +For x64 and x86, certain algorithms include manual vectorization. This implementation is separately compiled and relies on runtime CPU dispatch, so it applies only to suitable CPUs. Manually vectorized algorithms use template meta-programming to detect whether the element type is suitable for vectorization. As a result, they're only vectorized for simple types such as standard integer types. Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. You can disable manual vectorization with `#define _USE_STD_VECTOR_ALGORITHMS=0'. Manually vectorized algorithms are enabled by default on x64 and x86 because it defaults to 1 on those platforms. -To set `_USE_STD_VECTOR_ALGORITHMS` ensure that it's set to the same value for all linked translation units that use algorithms. A reliable way to achieve this to set it using in the project properties instead of in source. For more information about how to do that, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). +Ensure that you assign the same value to `_USE_STD_VECTOR_ALGORITHMS` for all linked translation units that use algorithms. A reliable way to do this is by configuring it in the project properties instead of in the source code. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). -The following algorithms are manually vectorized and their behavior is controlled by the `_USE_STD_VECTOR_ALGORITHMS` macro: + +The `_USE_STD_VECTOR_ALGORITHMS` macro determines the behavior of the following manually vectorized algorithms: - `contains`, `contains_subrange` - `find`, `find_last`, `find_end`, `find_first_of`, `adjacent_find` - `count` @@ -60,7 +61,7 @@ In addition to algorithms, the `_USE_STD_VECTOR_ALGORITHMS` macro controls the m ## Manually vectorized algorithms for floating point types -Vectorization of floating point types requires additional considerations: +Vectorization of floating-point types involves specific considerations: - Vectorization may reorder operations, which can affect the precision of floating point results. - Floating point types may contain `NaN` values, which don't behave transitively on comparisons. - Floating point operations may raise exceptions. @@ -73,7 +74,7 @@ Use `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized `_USE_STD_VECTOR_FLOATING_ALGORITHMS` defaults to 0 when [`/fp:except`](../build/reference/fp-specify-floating-point-behavior.md#except) is set. -To set `_USE_STD_VECTOR_FLOATING_ALGORITHMS` ensure that it's set to the same value for all linked translation units that use algorithms. A reliable way to achieve this to set it using in the project properties instead of in source. For more information about how to do that, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). +Ensure that you assign the same value to `_USE_STD_VECTOR_FLOATING_ALGORITHMS` for all linked translation units that use algorithms. A reliable way to do this is by configuring it in the project properties instead of in the source code. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). ## See also From a5604957090df3838bdfaae137d785137b336816 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 1 Oct 2025 18:32:53 -0700 Subject: [PATCH 1346/1799] edits --- ...ctime32-ctime64-wctime-wctime32-wctime64.md | 18 +++++++++--------- ...ctime64-s-wctime-s-wctime32-s-wctime64-s.md | 4 ++-- .../difftime-difftime32-difftime64.md | 9 ++++----- .../reference/ftime-ftime32-ftime64.md | 4 ++-- .../reference/futime-futime32-futime64.md | 4 ++-- .../reference/gmtime-gmtime32-gmtime64.md | 2 +- .../gmtime-s-gmtime32-s-gmtime64-s.md | 2 +- .../localtime-localtime32-localtime64.md | 2 +- .../localtime-s-localtime32-s-localtime64-s.md | 2 +- .../mkgmtime-mkgmtime32-mkgmtime64.md | 2 +- .../reference/mktime-mktime32-mktime64.md | 2 +- .../reference/strnlen-strnlen-s.md | 4 ++-- .../reference/time-time32-time64.md | 2 +- ...espec-get-timespec32-get-timespec64-get1.md | 2 +- ...utime32-utime64-wutime-wutime32-wutime64.md | 2 +- 15 files changed, 30 insertions(+), 31 deletions(-) diff --git a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md index f14ab2c8924..afaf3eb46b8 100644 --- a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md +++ b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md @@ -64,13 +64,13 @@ By default, this function's global state is scoped to the application. To change > [!Note] > Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ -> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: ctime, _wctime +> This applies to the following functions: `ctime`, `_wctime` ### Generic-text routine mappings -| TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | +| `TCHAR.H` routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| | `_tctime` | **`ctime`** | **`ctime`** | **`_wctime`** | | `_tctime32` | **`_ctime32`** | **`_ctime32`** | **`_wctime32`** | @@ -80,12 +80,12 @@ By default, this function's global state is scoped to the application. To change | Routine | Required header | |---|---| -| **`ctime`** | \ | -| **`_ctime32`** | \ | -| **`_ctime64`** | \ | -| **`_wctime`** | \ or \ | -| **`_wctime32`** | \ or \ | -| **`_wctime64`** | \ or \ | +| **`ctime`** | `` | +| **`_ctime32`** | `` | +| **`_ctime64`** | `` | +| **`_wctime`** | `` or `` | +| **`_wctime32`** | `` or `` | +| **`_wctime64`** | `` or `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index 669ca4102de..4f2921f1d44 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -126,9 +126,9 @@ By default, this function's global state is scoped to the application. To change > [!Note] > Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ -> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: ctime_s, _wctime_s +> This applies to the following functions: `ctime_s`, `_wctime_s` ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md index ef234072630..3748e01284f 100644 --- a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md +++ b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_difftime64", "difftime", "difftime64", "_difftime32", "difftime32"] helpviewer_keywords: ["_difftime32 function", "difftime function", "time, finding the difference", "difftime64 function", "_difftime64 function", "difftime32 function"] -ms.assetid: 4cc0ac2b-fc7b-42c0-8283-8c9d10c566d0 --- # `difftime`, `_difftime32`, `_difftime64` @@ -51,15 +50,15 @@ By default, this function's global state is scoped to the application. To change > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: difftime +> This applies to the following function: `difftime` ## Requirements | Routine | Required header | |---|---| -| **`difftime`** | \ | -| **`_difftime32`** | \ | -| **`_difftime64`** | \ | +| **`difftime`** | `` | +| **`_difftime32`** | `` | +| **`_difftime64`** | `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md b/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md index 692dfa3aa2a..49ff94a5f59 100644 --- a/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md +++ b/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md @@ -48,9 +48,9 @@ By default, this function's global state is scoped to the application. To change > [!Note] > Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ -> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: _ftime +> This applies to the following function: _ftime ## Requirements diff --git a/docs/c-runtime-library/reference/futime-futime32-futime64.md b/docs/c-runtime-library/reference/futime-futime32-futime64.md index d43295df933..516c5d29ed3 100644 --- a/docs/c-runtime-library/reference/futime-futime32-futime64.md +++ b/docs/c-runtime-library/reference/futime-futime32-futime64.md @@ -53,9 +53,9 @@ By default, this function's global state is scoped to the application. To change > [!Note] > Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ -> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: _futime +> This applies to the following function: `_futime` ## Requirements diff --git a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md index 331aee5237a..e20714f43fc 100644 --- a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md +++ b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md @@ -61,7 +61,7 @@ By default, this function's global state is scoped to the application. To change > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: gmtime +> This applies to the following function: `gmtime` ## Requirements diff --git a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md index 4510a2090bf..08e47287e5a 100644 --- a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md +++ b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md @@ -81,7 +81,7 @@ By default, this function's global state is scoped to the application. To change > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: gmtime_s +> This applies to the following function: `gmtime_s` ## Requirements diff --git a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md index c3c19a20dcc..bdc4a3d545b 100644 --- a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md +++ b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md @@ -77,7 +77,7 @@ By default, this function's global state is scoped to the application. To change > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: localtime +> This applies to the following function: `localtime` ## Requirements diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index 943d9fa96db..0ed83432d92 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -89,7 +89,7 @@ By default, this function's global state is scoped to the application. To change > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: localtime_s +> This applies to the following function: `localtime_s` ## Requirements diff --git a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md index d7970373b52..01a0c7f841e 100644 --- a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md +++ b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md @@ -53,7 +53,7 @@ Both **`gmtime`** and **`localtime`** use a common static buffer for the convers > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: _mkgmtime +> This applies to the following function: `_mkgmtime` ## Examples diff --git a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md index 13214c3d9f4..e59f3af154e 100644 --- a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md +++ b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md @@ -67,7 +67,7 @@ By default, this function's global state is scoped to the application. To change > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: mktime +> This applies to the following function: `mktime` ## Requirements diff --git a/docs/c-runtime-library/reference/strnlen-strnlen-s.md b/docs/c-runtime-library/reference/strnlen-strnlen-s.md index 9be6378f434..aaed1512438 100644 --- a/docs/c-runtime-library/reference/strnlen-strnlen-s.md +++ b/docs/c-runtime-library/reference/strnlen-strnlen-s.md @@ -90,9 +90,9 @@ By default, this function's global state is scoped to the application. To change > [!Note] > Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ -> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: strnlen_s, wcsnlen_s +> This applies to the following functions: `strnlen_s`, `wcsnlen_s` ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/time-time32-time64.md b/docs/c-runtime-library/reference/time-time32-time64.md index e6618981943..039dd0766a0 100644 --- a/docs/c-runtime-library/reference/time-time32-time64.md +++ b/docs/c-runtime-library/reference/time-time32-time64.md @@ -42,7 +42,7 @@ The **`time`** function returns the number of seconds elapsed since midnight (00 > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: time +> This applies to the following function: `time` ## Requirements diff --git a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md index 7f77bc722ea..101fb52c6b9 100644 --- a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md +++ b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md @@ -60,7 +60,7 @@ By default, this function's global state is scoped to the application. To change > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: timespec_get +> This applies to the following function: `timespec_get` ## Requirements diff --git a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md index 7f57cbfe0bb..f12ecd9a9dd 100644 --- a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md +++ b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md @@ -90,7 +90,7 @@ By default, this function's global state is scoped to the application. To change > You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ > You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ > This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following functions: _utime, _wutime +> This applies to the following functions: `_utime`, `_wutime` ### Generic-text routine mappings From cffe2080657d7f058f9564f119ac50c738d84739 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 1 Oct 2025 18:57:35 -0700 Subject: [PATCH 1347/1799] remove changes from _fstat and _stat --- ...stat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md | 8 +------- docs/c-runtime-library/reference/stat-functions.md | 8 +------- 2 files changed, 2 insertions(+), 14 deletions(-) diff --git a/docs/c-runtime-library/reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md b/docs/c-runtime-library/reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md index 1d9c6e67532..41ce094bccc 100644 --- a/docs/c-runtime-library/reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md +++ b/docs/c-runtime-library/reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md @@ -16,7 +16,7 @@ Gets information about an open file. ## Syntax ```C -int _fstat( // See note in remarks section about linkage +int _fstat( int fd, struct _stat *buffer ); @@ -81,12 +81,6 @@ Unless `_USE_32BIT_TIME_T` is defined, **`_fstat`** is equivalent to **`_fstat64 By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). -> [!Note] -> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ -> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: _fstat - ### Time type and file length type variations of `_stat` | Functions | `_USE_32BIT_TIME_T` defined? | Time type | File length type | diff --git a/docs/c-runtime-library/reference/stat-functions.md b/docs/c-runtime-library/reference/stat-functions.md index cf2f96d442f..b1a5efc58ff 100644 --- a/docs/c-runtime-library/reference/stat-functions.md +++ b/docs/c-runtime-library/reference/stat-functions.md @@ -16,7 +16,7 @@ Get status information on a file. ## Syntax ```C -int _stat( // See note in remarks section about linkage +int _stat( const char *path, struct _stat *buffer ); @@ -100,12 +100,6 @@ This function validates its parameters. If either *`path`* or *`buffer`* is `NUL By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). -> [!Note] -> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ -> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1`before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: _stat - ### Time type and file length type variations of `_stat` | Functions | `_USE_32BIT_TIME_T` defined | Time type | File length type | From 09cc7d71af0dc5f64a18586ee9b1d67f1ab93251 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 1 Oct 2025 19:21:17 -0700 Subject: [PATCH 1348/1799] remove another --- docs/c-runtime-library/reference/ftime-ftime32-ftime64.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md b/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md index 49ff94a5f59..7cb0247f80a 100644 --- a/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md +++ b/docs/c-runtime-library/reference/ftime-ftime32-ftime64.md @@ -17,7 +17,7 @@ Get the current time. More secure versions of these functions are available; see ## Syntax ```C -void _ftime( struct _timeb *timeptr ); // See note in remarks section about linkage +void _ftime( struct _timeb *timeptr ); void _ftime32( struct __timeb32 *timeptr ); void _ftime64( struct __timeb64 *timeptr ); ``` @@ -46,12 +46,6 @@ The **`_ftime`** function is equivalent to **`_ftime64`**, and `_timeb` contains By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). -> [!Note] -> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ -> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: _ftime - ## Requirements | Function | Required header | From 279a1dc0830a2454e2b86c17d8ef0a8da345815b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 3 Oct 2025 10:30:33 -0700 Subject: [PATCH 1349/1799] tech review --- docs/standard-library/vectorized-stl-algorithms.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index cbfe7078965..9e2ce9826a4 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -1,7 +1,7 @@ --- title: "Vectorized STL Algorithms" description: "Learn more about: Vectorized STL Algorithms" -ms.date: 10/1/2025 +ms.date: 10/03/2025 f1_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS"] helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS", "Vector Algorithms", "Vectorization", "SIMD"] --- @@ -11,14 +11,14 @@ Under specific conditions, algorithms in the C++ Standard Template Library (STL) The conditions required for vectorization are: - The container or range must be contiguous. Examples of contiguous containers include `array`, `vector`, and `basic_string`. Contiguous ranges are provided by types like `span` and `basic_string_view`. Built-in arrays also form contiguous ranges. In contrast, containers like `list` and `map` aren't contiguous. - - The target platform must support the necessary SIMD instructions to implement the algorithm for the element types. This is typically true for intrinsic types (like built-in integers) and simple operations. + - The target platform must support the necessary SIMD instructions to implement the algorithm for the element types. This is typically true for arithmetic types and simple operations. - One of the following conditions must be met: - The compiler can emit vectorized machine code for an implementation written as scalar code (auto-vectorization). - The algorithm's implementation is explicitly written to use vectorized code (manual vectorization). ## Auto-vectorization in the STL -For more information about automatic vectorization, see [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion about in that article about the [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch. This applies to the STL implementation code the same way as to user code. +For more information about automatic vectorization, see [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion in that article about the [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch. This applies to the STL implementation code the same way it does to user code. Algorithms like `transform`, `reduce`, `accumulate` heavily benefit from auto-vectorization. @@ -28,7 +28,7 @@ For x64 and x86, certain algorithms include manual vectorization. This implement Manually vectorized algorithms use template meta-programming to detect whether the element type is suitable for vectorization. As a result, they're only vectorized for simple types such as standard integer types. -Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. You can disable manual vectorization with `#define _USE_STD_VECTOR_ALGORITHMS=0'. Manually vectorized algorithms are enabled by default on x64 and x86 because it defaults to 1 on those platforms. +Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. You can disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS=0` in your project. Manually vectorized algorithms are enabled by default on x64 and x86 because it defaults to 1 on those platforms. Ensure that you assign the same value to `_USE_STD_VECTOR_ALGORITHMS` for all linked translation units that use algorithms. A reliable way to do this is by configuring it in the project properties instead of in the source code. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). @@ -67,8 +67,8 @@ Vectorization of floating-point types involves specific considerations: - Floating point operations may raise exceptions. The STL deals with the first two considerations safely. Only `max_element`, `min_element`, `minmax_element`, `max`, `min`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: - - Don't compute new floating point values, only compare the existing values, so different order does not affect precision. - - Because they're sorting algorithms, `NaNs` isn't an allowed operand. +- Avoid computing new floating-point values; instead, they compare existing values to ensure that differences in operation order don't impact precision. +- Since these are sorting algorithms, `NaN` values aren't allowed inputs. Use `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating point types. Set it to 0 to disable vectorization. `_USE_STD_VECTOR_FLOATING_ALGORITHMS` has no effect if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. From 27b7e12a1fb239c83d845c68979b3e86f65f7c00 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 3 Oct 2025 10:33:06 -0700 Subject: [PATCH 1350/1799] edit --- docs/standard-library/vectorized-stl-algorithms.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 9e2ce9826a4..47356b389ff 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -67,7 +67,7 @@ Vectorization of floating-point types involves specific considerations: - Floating point operations may raise exceptions. The STL deals with the first two considerations safely. Only `max_element`, `min_element`, `minmax_element`, `max`, `min`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: -- Avoid computing new floating-point values; instead, they compare existing values to ensure that differences in operation order don't impact precision. +- Don’t compute new floating-point values. Instead, they only compare existing values to ensure that differences in operation order don't impact precision. - Since these are sorting algorithms, `NaN` values aren't allowed inputs. Use `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating point types. Set it to 0 to disable vectorization. `_USE_STD_VECTOR_FLOATING_ALGORITHMS` has no effect if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. From 70e0fe5f1be98ba9d1fdf412cd383dbb785e01a3 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 3 Oct 2025 10:56:48 -0700 Subject: [PATCH 1351/1799] edit pass --- .../vectorized-stl-algorithms.md | 40 +++++++++---------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 47356b389ff..ff4bceb6546 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -7,33 +7,33 @@ helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_AL --- # Vectorized STL Algorithms -Under specific conditions, algorithms in the C++ Standard Template Library (STL) can process multiple elements simultaneously on a single CPU core, rather than handling each element individually. This optimization uses single instruction, multiple data (SIMD) instructions provided by the CPU, a technique known as vectorization. When this optimization isn't applied, the implementation is referred to as scalar. +Under specific conditions, algorithms in the C++ Standard Template Library (STL) can process multiple elements simultaneously on a single CPU core, rather than handling each element individually. This optimization uses single instruction, multiple data (SIMD) instructions provided by the CPU, a technique called vectorization. When this optimization isn't applied, the implementation is referred to as scalar. The conditions required for vectorization are: - - The container or range must be contiguous. Examples of contiguous containers include `array`, `vector`, and `basic_string`. Contiguous ranges are provided by types like `span` and `basic_string_view`. Built-in arrays also form contiguous ranges. In contrast, containers like `list` and `map` aren't contiguous. + - The container or range must be contiguous. Examples include `array`, `vector`, and `basic_string`. Types like `span` and `basic_string_view` provide contiguous ranges. Built-in arrays also form contiguous ranges. Containers like `list` and `map` aren't contiguous. - The target platform must support the necessary SIMD instructions to implement the algorithm for the element types. This is typically true for arithmetic types and simple operations. - - One of the following conditions must be met: + - One of these conditions must be met: - The compiler can emit vectorized machine code for an implementation written as scalar code (auto-vectorization). - - The algorithm's implementation is explicitly written to use vectorized code (manual vectorization). + - The algorithm's implementation explicitly uses vectorized code (manual vectorization). ## Auto-vectorization in the STL -For more information about automatic vectorization, see [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion in that article about the [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch. This applies to the STL implementation code the same way it does to user code. +For more information about automatic vectorization, see [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion in that article about the [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch. This applies to the STL implementation code the same way it applies to user code. -Algorithms like `transform`, `reduce`, `accumulate` heavily benefit from auto-vectorization. +Algorithms like `transform`, `reduce`, and `accumulate` heavily benefit from auto-vectorization. ## Manual vectorization in the STL -For x64 and x86, certain algorithms include manual vectorization. This implementation is separately compiled and relies on runtime CPU dispatch, so it applies only to suitable CPUs. +Certain algorithms for x64 and x86 include manual vectorization. This implementation is separately compiled and relies on runtime CPU dispatch, so it applies only to suitable CPUs. -Manually vectorized algorithms use template meta-programming to detect whether the element type is suitable for vectorization. As a result, they're only vectorized for simple types such as standard integer types. +Manually vectorized algorithms use template metaprogramming to detect if the element type is suitable for vectorization. As a result, they're only vectorized for simple types such as standard integer types. -Generally, programs either benefit in performance from this manual vectorization or are unaffected by it. You can disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS=0` in your project. Manually vectorized algorithms are enabled by default on x64 and x86 because it defaults to 1 on those platforms. +Programs generally either benefit in performance from manual vectorization or remain unaffected by it. Disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS=0` in your project. Manually vectorized algorithms are enabled by default on x64 and x86 because it defaults to 1 on those platforms. -Ensure that you assign the same value to `_USE_STD_VECTOR_ALGORITHMS` for all linked translation units that use algorithms. A reliable way to do this is by configuring it in the project properties instead of in the source code. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). +Assign the same value to `_USE_STD_VECTOR_ALGORITHMS` for all linked translation units that use algorithms. Configure it in the project properties instead of in the source code for consistency. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). -The `_USE_STD_VECTOR_ALGORITHMS` macro determines the behavior of the following manually vectorized algorithms: +The `_USE_STD_VECTOR_ALGORITHMS` macro controls the behavior of these manually vectorized algorithms: - `contains`, `contains_subrange` - `find`, `find_last`, `find_end`, `find_first_of`, `adjacent_find` - `count` @@ -50,7 +50,7 @@ The `_USE_STD_VECTOR_ALGORITHMS` macro determines the behavior of the following - `max`, `min`, `minmax` - `max_element`, `min_element`, `minmax_element` -In addition to algorithms, the `_USE_STD_VECTOR_ALGORITHMS` macro controls the manual vectorization of: +The `_USE_STD_VECTOR_ALGORITHMS` macro also controls the manual vectorization of: - `basic_string` and `basic_string_view` members: - `find` @@ -62,19 +62,19 @@ In addition to algorithms, the `_USE_STD_VECTOR_ALGORITHMS` macro controls the m ## Manually vectorized algorithms for floating point types Vectorization of floating-point types involves specific considerations: - - Vectorization may reorder operations, which can affect the precision of floating point results. - - Floating point types may contain `NaN` values, which don't behave transitively on comparisons. - - Floating point operations may raise exceptions. + - Vectorization might reorder operations, which can affect the precision of floating-point results. + - Floating-point types might contain `NaN` values, which don't behave transitively in comparisons. + - Floating-point operations might raise exceptions. -The STL deals with the first two considerations safely. Only `max_element`, `min_element`, `minmax_element`, `max`, `min`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: -- Don’t compute new floating-point values. Instead, they only compare existing values to ensure that differences in operation order don't impact precision. -- Since these are sorting algorithms, `NaN` values aren't allowed inputs. +The STL addresses the first two considerations safely. Only `max_element`, `min_element`, `minmax_element`, `max`, `min`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: +- Don’t compute new floating-point values. Instead, they compare existing values to ensure that differences in operation order don't impact precision. +- Because these are sorting algorithms, `NaN` values aren't allowed as inputs. -Use `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating point types. Set it to 0 to disable vectorization. `_USE_STD_VECTOR_FLOATING_ALGORITHMS` has no effect if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. +Use `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating-point types. Set it to 0 to disable vectorization. `_USE_STD_VECTOR_FLOATING_ALGORITHMS` doesn't affect anything if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. `_USE_STD_VECTOR_FLOATING_ALGORITHMS` defaults to 0 when [`/fp:except`](../build/reference/fp-specify-floating-point-behavior.md#except) is set. -Ensure that you assign the same value to `_USE_STD_VECTOR_FLOATING_ALGORITHMS` for all linked translation units that use algorithms. A reliable way to do this is by configuring it in the project properties instead of in the source code. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). +Assign the same value to `_USE_STD_VECTOR_FLOATING_ALGORITHMS` for all linked translation units that use algorithms. Configure it in the project properties instead of in the source code for consistency. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). ## See also From 3b81dc015a69fb2279169bc0b48ef1c3411685b1 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 3 Oct 2025 11:11:56 -0700 Subject: [PATCH 1352/1799] last small edits --- docs/standard-library/vectorized-stl-algorithms.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index ff4bceb6546..958b852db64 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -7,20 +7,20 @@ helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_AL --- # Vectorized STL Algorithms -Under specific conditions, algorithms in the C++ Standard Template Library (STL) can process multiple elements simultaneously on a single CPU core, rather than handling each element individually. This optimization uses single instruction, multiple data (SIMD) instructions provided by the CPU, a technique called vectorization. When this optimization isn't applied, the implementation is referred to as scalar. +Under specific conditions, algorithms in the MSVC Standard Template Library (STL) can process multiple elements simultaneously on a single CPU core, rather than handling each element individually. This optimization uses single instruction, multiple data (SIMD) instructions provided by the CPU, a technique called vectorization. When this optimization isn't applied, the implementation is referred to as scalar. The conditions required for vectorization are: - The container or range must be contiguous. Examples include `array`, `vector`, and `basic_string`. Types like `span` and `basic_string_view` provide contiguous ranges. Built-in arrays also form contiguous ranges. Containers like `list` and `map` aren't contiguous. - The target platform must support the necessary SIMD instructions to implement the algorithm for the element types. This is typically true for arithmetic types and simple operations. - One of these conditions must be met: - - The compiler can emit vectorized machine code for an implementation written as scalar code (auto-vectorization). - - The algorithm's implementation explicitly uses vectorized code (manual vectorization). + - The compiler can emit vectorized machine code for an implementation written as scalar code (auto-vectorization). + - The algorithm's implementation explicitly uses vectorized code (manual vectorization). ## Auto-vectorization in the STL For more information about automatic vectorization, see [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion in that article about the [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch. This applies to the STL implementation code the same way it applies to user code. -Algorithms like `transform`, `reduce`, and `accumulate` heavily benefit from auto-vectorization. +Algorithms like `transform`, `reduce`, and `accumulate` benefit heavily from auto-vectorization. ## Manual vectorization in the STL @@ -28,7 +28,7 @@ Certain algorithms for x64 and x86 include manual vectorization. This implementa Manually vectorized algorithms use template metaprogramming to detect if the element type is suitable for vectorization. As a result, they're only vectorized for simple types such as standard integer types. -Programs generally either benefit in performance from manual vectorization or remain unaffected by it. Disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS=0` in your project. Manually vectorized algorithms are enabled by default on x64 and x86 because it defaults to 1 on those platforms. +Programs either benefit in performance from manual vectorization or remain unaffected by it. Disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS=0` in your project. Manually vectorized algorithms are enabled by default on x64 and x86 because `_USE_STD_VECTOR_ALGORITHMS` defaults to 1 on those platforms. Assign the same value to `_USE_STD_VECTOR_ALGORITHMS` for all linked translation units that use algorithms. Configure it in the project properties instead of in the source code for consistency. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). @@ -72,7 +72,7 @@ The STL addresses the first two considerations safely. Only `max_element`, `min_ Use `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating-point types. Set it to 0 to disable vectorization. `_USE_STD_VECTOR_FLOATING_ALGORITHMS` doesn't affect anything if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. -`_USE_STD_VECTOR_FLOATING_ALGORITHMS` defaults to 0 when [`/fp:except`](../build/reference/fp-specify-floating-point-behavior.md#except) is set. +The `_USE_STD_VECTOR_FLOATING_ALGORITHMS` macro defaults to 0 when [`/fp:except`](../build/reference/fp-specify-floating-point-behavior.md#except) is set. Assign the same value to `_USE_STD_VECTOR_FLOATING_ALGORITHMS` for all linked translation units that use algorithms. Configure it in the project properties instead of in the source code for consistency. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). From fd1aa69a9ad8d391590ce855a105a9cec829a63b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 3 Oct 2025 11:33:58 -0700 Subject: [PATCH 1353/1799] add branding --- docs/standard-library/vectorized-stl-algorithms.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md index 958b852db64..13cad087a01 100644 --- a/docs/standard-library/vectorized-stl-algorithms.md +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -1,11 +1,11 @@ --- -title: "Vectorized STL Algorithms" +title: "Vectorized MSVC STL Algorithms" description: "Learn more about: Vectorized STL Algorithms" ms.date: 10/03/2025 f1_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS"] helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS", "Vector Algorithms", "Vectorization", "SIMD"] --- -# Vectorized STL Algorithms +# Vectorized MSVC STL Algorithms Under specific conditions, algorithms in the MSVC Standard Template Library (STL) can process multiple elements simultaneously on a single CPU core, rather than handling each element individually. This optimization uses single instruction, multiple data (SIMD) instructions provided by the CPU, a technique called vectorization. When this optimization isn't applied, the implementation is referred to as scalar. @@ -16,13 +16,13 @@ The conditions required for vectorization are: - The compiler can emit vectorized machine code for an implementation written as scalar code (auto-vectorization). - The algorithm's implementation explicitly uses vectorized code (manual vectorization). -## Auto-vectorization in the STL +## Auto-vectorization in the MSVC STL For more information about automatic vectorization, see [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion in that article about the [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch. This applies to the STL implementation code the same way it applies to user code. Algorithms like `transform`, `reduce`, and `accumulate` benefit heavily from auto-vectorization. -## Manual vectorization in the STL +## Manual vectorization in the MSVC STL Certain algorithms for x64 and x86 include manual vectorization. This implementation is separately compiled and relies on runtime CPU dispatch, so it applies only to suitable CPUs. From c67cfc80a9782e6dc35bae0782af5fa1a83ebe25 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 7 Oct 2025 14:25:20 -0700 Subject: [PATCH 1354/1799] more uniform wording --- .../ctime-ctime32-ctime64-wctime-wctime32-wctime64.md | 4 ++-- ...-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md | 2 +- .../reference/difftime-difftime32-difftime64.md | 7 +++---- .../reference/futime-futime32-futime64.md | 2 +- .../reference/gmtime-gmtime32-gmtime64.md | 7 +++---- .../reference/gmtime-s-gmtime32-s-gmtime64-s.md | 7 +++---- .../reference/localtime-localtime32-localtime64.md | 7 +++---- .../reference/localtime-s-localtime32-s-localtime64-s.md | 7 +++---- .../reference/mkgmtime-mkgmtime32-mkgmtime64.md | 8 +++----- .../reference/mktime-mktime32-mktime64.md | 7 +++---- docs/c-runtime-library/reference/strnlen-strnlen-s.md | 4 ++-- docs/c-runtime-library/reference/time-time32-time64.md | 7 +++---- .../timespec-get-timespec32-get-timespec64-get1.md | 7 +++---- .../utime-utime32-utime64-wutime-wutime32-wutime64.md | 7 +++---- 14 files changed, 36 insertions(+), 47 deletions(-) diff --git a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md index afaf3eb46b8..a01f93a70b2 100644 --- a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md +++ b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md @@ -62,8 +62,8 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). -> [!Note] -> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +>> [!Note] +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following functions: `ctime`, `_wctime` diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index 4f2921f1d44..503448e71d6 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -125,7 +125,7 @@ The debug library versions of these functions first fill the buffer with 0xFE. T By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following functions: `ctime_s`, `_wctime_s` diff --git a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md index 3748e01284f..c6967a50310 100644 --- a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md +++ b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md @@ -46,10 +46,9 @@ These functions validate their parameters. If either of the parameters is zero o By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following function: `difftime` ## Requirements diff --git a/docs/c-runtime-library/reference/futime-futime32-futime64.md b/docs/c-runtime-library/reference/futime-futime32-futime64.md index 516c5d29ed3..900ff0928b5 100644 --- a/docs/c-runtime-library/reference/futime-futime32-futime64.md +++ b/docs/c-runtime-library/reference/futime-futime32-futime64.md @@ -52,7 +52,7 @@ The **`_futime`** routine sets the modification date and the access time on the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following function: `_futime` diff --git a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md index e20714f43fc..0cfc741f854 100644 --- a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md +++ b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md @@ -57,10 +57,9 @@ The **`_gmtime32`** function breaks down the *`sourceTime`* value and stores it By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following function: `gmtime` ## Requirements diff --git a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md index 08e47287e5a..32875956867 100644 --- a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md +++ b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md @@ -77,10 +77,9 @@ Each of the structure fields is of type **`int`**, as shown in the following tab By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following function: `gmtime_s` ## Requirements diff --git a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md index bdc4a3d545b..2d3dbc27eb4 100644 --- a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md +++ b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md @@ -73,10 +73,9 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following function: `localtime` ## Requirements diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index 0ed83432d92..581c2ca842b 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -85,10 +85,9 @@ If the **`TZ`** environment variable is set, the C run-time library assumes rule By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following function: `localtime_s` ## Requirements diff --git a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md index 01a0c7f841e..84451aaddbe 100644 --- a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md +++ b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md @@ -49,11 +49,9 @@ The range of the **`_mkgmtime32`** function is from midnight, January 1, 1970, U Both **`gmtime`** and **`localtime`** use a common static buffer for the conversion. If you supply this buffer to **`_mkgmtime`**, the previous contents are destroyed. > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ -> This applies to the following function: `_mkgmtime` +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\> This applies to the following function: `_mkgmtime` ## Examples diff --git a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md index e59f3af154e..330bd1b43e7 100644 --- a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md +++ b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md @@ -63,10 +63,9 @@ These functions validate their parameter. If *`timeptr`* is a null pointer, the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following function: `mktime` ## Requirements diff --git a/docs/c-runtime-library/reference/strnlen-strnlen-s.md b/docs/c-runtime-library/reference/strnlen-strnlen-s.md index aaed1512438..12bc64a65c6 100644 --- a/docs/c-runtime-library/reference/strnlen-strnlen-s.md +++ b/docs/c-runtime-library/reference/strnlen-strnlen-s.md @@ -89,9 +89,9 @@ Each of these functions returns the number of characters in *`str`*, not includi By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting with Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are now declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\> This applies to the following functions: `strnlen_s`, `wcsnlen_s` > This applies to the following functions: `strnlen_s`, `wcsnlen_s` ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/time-time32-time64.md b/docs/c-runtime-library/reference/time-time32-time64.md index 039dd0766a0..ca0e2ca4f54 100644 --- a/docs/c-runtime-library/reference/time-time32-time64.md +++ b/docs/c-runtime-library/reference/time-time32-time64.md @@ -38,10 +38,9 @@ The **`time`** function returns the number of seconds elapsed since midnight (00 **`time`** is a wrapper for **`_time64`** and **`time_t`** is, by default, equivalent to **`__time64_t`**. If you need to force the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, you can define `_USE_32BIT_TIME_T`. We don't recommend `_USE_32BIT_TIME_T`, because your application may fail after January 18, 2038; the use of this macro isn't allowed on 64-bit platforms. > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following function: `time` ## Requirements diff --git a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md index 101fb52c6b9..65d4234deff 100644 --- a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md +++ b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md @@ -56,10 +56,9 @@ These functions support only `TIME_UTC` as the *`base`* value. `TIME_UTC` sets t By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following function: `timespec_get` ## Requirements diff --git a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md index f12ecd9a9dd..4b032490d1d 100644 --- a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md +++ b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md @@ -86,10 +86,9 @@ Specific versions of the `_utimbuf` structure (`__utimbuf32` and `__utimbuf64`) By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> Starting in Visual Studio 2025 and the Windows SDK 26000, this function changes from declaring the function (or functions for multi-function pages) with `static inline` to `inline`.\ -> You can opt-out of the change for your project by defining `_STATIC_INLINE_UCRT_FUNCTIONS=1`.\ -> You can adopt the change early by defining `_STATIC_INLINE_UCRT_FUNCTIONS=0`.\ -> This change improves conformance and helps avoid One Definition Rule (ODR) violations, especially when using modules.\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ > This applies to the following functions: `_utime`, `_wutime` ### Generic-text routine mappings From 6b125cbc4823dfb12acb935dc042e43a86253030 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 7 Oct 2025 14:50:27 -0700 Subject: [PATCH 1355/1799] more finesse --- .../ctime-ctime32-ctime64-wctime-wctime32-wctime64.md | 6 ++---- ...-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md | 5 ++--- .../reference/difftime-difftime32-difftime64.md | 5 ++--- .../c-runtime-library/reference/futime-futime32-futime64.md | 5 ++--- .../c-runtime-library/reference/gmtime-gmtime32-gmtime64.md | 5 ++--- .../reference/gmtime-s-gmtime32-s-gmtime64-s.md | 5 ++--- .../reference/localtime-localtime32-localtime64.md | 5 ++--- .../reference/localtime-s-localtime32-s-localtime64-s.md | 5 ++--- .../reference/mkgmtime-mkgmtime32-mkgmtime64.md | 4 ++-- .../c-runtime-library/reference/mktime-mktime32-mktime64.md | 5 ++--- docs/c-runtime-library/reference/strnlen-strnlen-s.md | 5 ++--- docs/c-runtime-library/reference/time-time32-time64.md | 6 ++---- .../timespec-get-timespec32-get-timespec64-get1.md | 5 ++--- .../utime-utime32-utime64-wutime-wutime32-wutime64.md | 6 ++---- 14 files changed, 28 insertions(+), 44 deletions(-) diff --git a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md index a01f93a70b2..2d49bc3a153 100644 --- a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md +++ b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_wctime64", "_ctime32", "_tctime", "_wctime", "_wctime32", "_tctime64", "_ctime64", "ctime"] helpviewer_keywords: ["tctime64 function", "_ctime32 function", "ctime32 function", "_wctime function", "wctime64 function", "_tctime64 function", "_tctime32 function", "_ctime64 function", "_wctime64 function", "ctime function", "wctime32 function", "ctime64 function", "_wctime32 function", "_tctime function", "tctime32 function", "tctime function", "wctime function", "time, converting"] -ms.assetid: 2423de37-a35c-4f0a-a378-3116bc120a9d --- # `ctime`, `_ctime32`, `_ctime64`, `_wctime`, `_wctime32`, `_wctime64` @@ -63,10 +62,9 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). >> [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `ctime` and `_wctime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: `ctime`, `_wctime` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index 503448e71d6..00f36630373 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -125,10 +125,9 @@ The debug library versions of these functions first fill the buffer with 0xFE. T By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `ctime_s` and `_wctime_s` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: `ctime_s`, `_wctime_s` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md index c6967a50310..4abb115de76 100644 --- a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md +++ b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md @@ -46,10 +46,9 @@ These functions validate their parameters. If either of the parameters is zero o By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `difftime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: `difftime` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/futime-futime32-futime64.md b/docs/c-runtime-library/reference/futime-futime32-futime64.md index 900ff0928b5..24adf3ac898 100644 --- a/docs/c-runtime-library/reference/futime-futime32-futime64.md +++ b/docs/c-runtime-library/reference/futime-futime32-futime64.md @@ -52,10 +52,9 @@ The **`_futime`** routine sets the modification date and the access time on the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_futime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: `_futime` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md index 0cfc741f854..f180708ab73 100644 --- a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md +++ b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md @@ -57,10 +57,9 @@ The **`_gmtime32`** function breaks down the *`sourceTime`* value and stores it By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `gmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: `gmtime` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md index 32875956867..5fa95ab1bdb 100644 --- a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md +++ b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md @@ -77,10 +77,9 @@ Each of the structure fields is of type **`int`**, as shown in the following tab By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `gmtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: `gmtime_s` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md index 2d3dbc27eb4..7c94fbd8479 100644 --- a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md +++ b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md @@ -73,10 +73,9 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `localtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: `localtime` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index 581c2ca842b..81137b6dbd7 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -85,10 +85,9 @@ If the **`TZ`** environment variable is set, the C run-time library assumes rule By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `localtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: `localtime_s` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md index 84451aaddbe..098f806f2a5 100644 --- a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md +++ b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md @@ -49,9 +49,9 @@ The range of the **`_mkgmtime32`** function is from midnight, January 1, 1970, U Both **`gmtime`** and **`localtime`** use a common static buffer for the conversion. If you supply this buffer to **`_mkgmtime`**, the previous contents are destroyed. > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_mkgmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\> This applies to the following function: `_mkgmtime` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Examples diff --git a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md index 330bd1b43e7..4c0571ac8a6 100644 --- a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md +++ b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md @@ -63,10 +63,9 @@ These functions validate their parameter. If *`timeptr`* is a null pointer, the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `mktime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: `mktime` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/strnlen-strnlen-s.md b/docs/c-runtime-library/reference/strnlen-strnlen-s.md index 12bc64a65c6..c4da83ce486 100644 --- a/docs/c-runtime-library/reference/strnlen-strnlen-s.md +++ b/docs/c-runtime-library/reference/strnlen-strnlen-s.md @@ -89,10 +89,9 @@ Each of these functions returns the number of characters in *`str`*, not includi By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `strnlen_s` and `wcsnlen_s` are no longer `static inline` (internal linkage). Instead, they are `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\> This applies to the following functions: `strnlen_s`, `wcsnlen_s` -> This applies to the following functions: `strnlen_s`, `wcsnlen_s` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/time-time32-time64.md b/docs/c-runtime-library/reference/time-time32-time64.md index ca0e2ca4f54..a017ab031aa 100644 --- a/docs/c-runtime-library/reference/time-time32-time64.md +++ b/docs/c-runtime-library/reference/time-time32-time64.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["TIME/time", "TIME/_time32", "TIME/_time64", "time", "_time32", "_time64"] helpviewer_keywords: ["time32 function", "_time32 function", "_time64 function", "time functions", "system time", "time64 function"] -ms.assetid: 280e00f2-2b93-4ece-94cd-e048484c6cc7 --- # `time`, `_time32`, `_time64` @@ -38,10 +37,9 @@ The **`time`** function returns the number of seconds elapsed since midnight (00 **`time`** is a wrapper for **`_time64`** and **`time_t`** is, by default, equivalent to **`__time64_t`**. If you need to force the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, you can define `_USE_32BIT_TIME_T`. We don't recommend `_USE_32BIT_TIME_T`, because your application may fail after January 18, 2038; the use of this macro isn't allowed on 64-bit platforms. > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `time` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: `time` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md index 65d4234deff..1bb336cebac 100644 --- a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md +++ b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md @@ -56,10 +56,9 @@ These functions support only `TIME_UTC` as the *`base`* value. `TIME_UTC` sets t By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `timespec_get` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following function: `timespec_get` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md index 4b032490d1d..d451db3be4b 100644 --- a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md +++ b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["UTIME/_utime", "UTIME/_utime32", "UTIME/_utime64", "UTIME/_wutime", "UTIME/_wutime32", "UTIME/_wutime64", "TCHAR/_tutime", "TCHAR/_tutime32", "TCHAR/_tutime64", "_utime", "_utime32", "_utime64", "_wutime", "_wutime32", "_wutime64", "_tutime", "_tutime32", "_tutime64"] helpviewer_keywords: ["tutime function", "utime32 function", "utime64 function", "_utime function", "_tutime32 function", "time [C++], file modification", "wutime function", "_wutime function", "_wutime32 function", "_tutime64 function", "_tutime function", "files [C++], modification time", "_wutime64 function", "_utime32 function", "utime function", "_utime64 function", "wutime64 function", "wutime32 function", "tutime64 function", "tutime32 function"] -ms.assetid: 8d482d40-19b9-4591-bfee-5d7f601d1a9e --- # `_utime`, `_utime32`, `_utime64`, `_wutime`, `_wutime32`, `_wutime64` @@ -86,10 +85,9 @@ Specific versions of the `_utimbuf` structure (`__utimbuf32` and `__utimbuf64`) By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, the following functions are no longer declared as `static inline` (internal linkage). Instead, they are declared as `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_utime` and `_wutime` are no longer `static inline` (internal linkage). Instead, they are `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules.\ -> This applies to the following functions: `_utime`, `_wutime` +> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. ### Generic-text routine mappings From c575f428325a83b9cf9e647011dc2949f155933f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 7 Oct 2025 15:00:00 -0700 Subject: [PATCH 1356/1799] edit --- .../reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md | 2 +- ...time-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md | 2 +- .../reference/difftime-difftime32-difftime64.md | 2 +- docs/c-runtime-library/reference/futime-futime32-futime64.md | 2 +- docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md | 2 +- .../reference/gmtime-s-gmtime32-s-gmtime64-s.md | 2 +- .../reference/localtime-localtime32-localtime64.md | 2 +- .../reference/localtime-s-localtime32-s-localtime64-s.md | 2 +- .../reference/mkgmtime-mkgmtime32-mkgmtime64.md | 2 +- docs/c-runtime-library/reference/mktime-mktime32-mktime64.md | 2 +- docs/c-runtime-library/reference/strnlen-strnlen-s.md | 2 +- docs/c-runtime-library/reference/time-time32-time64.md | 2 +- .../reference/timespec-get-timespec32-get-timespec64-get1.md | 2 +- .../reference/utime-utime32-utime64-wutime-wutime32-wutime64.md | 2 +- 14 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md index 2d49bc3a153..94fb51c5db2 100644 --- a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md +++ b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md @@ -64,7 +64,7 @@ By default, this function's global state is scoped to the application. To change >> [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `ctime` and `_wctime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index 00f36630373..344332fb27b 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -127,7 +127,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `ctime_s` and `_wctime_s` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md index 4abb115de76..1eb22965f30 100644 --- a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md +++ b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md @@ -48,7 +48,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `difftime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/futime-futime32-futime64.md b/docs/c-runtime-library/reference/futime-futime32-futime64.md index 24adf3ac898..71e48e02fdc 100644 --- a/docs/c-runtime-library/reference/futime-futime32-futime64.md +++ b/docs/c-runtime-library/reference/futime-futime32-futime64.md @@ -54,7 +54,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_futime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md index f180708ab73..aaf84a4d8cc 100644 --- a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md +++ b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md @@ -59,7 +59,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `gmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md index 5fa95ab1bdb..dd7a15de33e 100644 --- a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md +++ b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md @@ -79,7 +79,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `gmtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md index 7c94fbd8479..fbd9bbc8ae2 100644 --- a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md +++ b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md @@ -75,7 +75,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `localtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index 81137b6dbd7..4907ef32f45 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -87,7 +87,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `localtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md index 098f806f2a5..63e68cc2503 100644 --- a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md +++ b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md @@ -51,7 +51,7 @@ Both **`gmtime`** and **`localtime`** use a common static buffer for the convers > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_mkgmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Examples diff --git a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md index 4c0571ac8a6..eb4af0a38fc 100644 --- a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md +++ b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md @@ -65,7 +65,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `mktime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/strnlen-strnlen-s.md b/docs/c-runtime-library/reference/strnlen-strnlen-s.md index c4da83ce486..12b2cedae88 100644 --- a/docs/c-runtime-library/reference/strnlen-strnlen-s.md +++ b/docs/c-runtime-library/reference/strnlen-strnlen-s.md @@ -91,7 +91,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `strnlen_s` and `wcsnlen_s` are no longer `static inline` (internal linkage). Instead, they are `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/time-time32-time64.md b/docs/c-runtime-library/reference/time-time32-time64.md index a017ab031aa..049d5450138 100644 --- a/docs/c-runtime-library/reference/time-time32-time64.md +++ b/docs/c-runtime-library/reference/time-time32-time64.md @@ -39,7 +39,7 @@ The **`time`** function returns the number of seconds elapsed since midnight (00 > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `time` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md index 1bb336cebac..ebc60ea0b92 100644 --- a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md +++ b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md @@ -58,7 +58,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `timespec_get` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ## Requirements diff --git a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md index d451db3be4b..5b00d4e1d83 100644 --- a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md +++ b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md @@ -87,7 +87,7 @@ By default, this function's global state is scoped to the application. To change > [!Note] > When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_utime` and `_wutime` are no longer `static inline` (internal linkage). Instead, they are `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ -> This change increases UCRT conformance with the C++ standard, while also improving compatibility with C++ modules. +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. ### Generic-text routine mappings From d4bc3177059431a376dadde8d231e06c15f08674 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 7 Oct 2025 15:29:32 -0700 Subject: [PATCH 1357/1799] edits --- ...time-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md | 2 +- .../reference/utime-utime32-utime64-wutime-wutime32-wutime64.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index 344332fb27b..af343d723c7 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -125,7 +125,7 @@ The debug library versions of these functions first fill the buffer with 0xFE. T By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `ctime_s` and `_wctime_s` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `ctime_s` and `_wctime_s` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md index 5b00d4e1d83..07641eeece6 100644 --- a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md +++ b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md @@ -85,7 +85,7 @@ Specific versions of the `_utimbuf` structure (`__utimbuf32` and `__utimbuf64`) By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_utime` and `_wutime` are no longer `static inline` (internal linkage). Instead, they are `inline` (external linkage).\ +> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_utime` and `_wutime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. From e1cc89bb1c59a2c4ed7c841d6d334012ad4e4bf7 Mon Sep 17 00:00:00 2001 From: David Ringo Date: Wed, 8 Oct 2025 14:39:51 -0400 Subject: [PATCH 1358/1799] Tweak example in configuration combinations Swaps the platform for one project configuration in the Configuration X Platform matrix example, so it's clearer why the first set requires the existence of the second set. Otherwise, it's not obvious why three Win32 configurations require three x64 configurations (but not three ARM configurations). --- docs/build/reference/vcxproj-file-structure.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/vcxproj-file-structure.md b/docs/build/reference/vcxproj-file-structure.md index 0ce1e28fb50..9bc67d8b8d9 100644 --- a/docs/build/reference/vcxproj-file-structure.md +++ b/docs/build/reference/vcxproj-file-structure.md @@ -126,7 +126,7 @@ The IDE expects to find a project configuration for any combination of `Configur - Debug|Win32 -- Retail|Win32 +- Retail|x64 - Special 32-bit Optimization|Win32 @@ -134,7 +134,7 @@ then it must also have these configurations, even though "Special 32-bit Optimiz - Debug|x64 -- Retail|x64 +- Retail|Win32 - Special 32-bit Optimization|x64 From 6f66c4fc452dfe2b25e9359835dbb9d8c79878a2 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 8 Oct 2025 20:05:14 -0700 Subject: [PATCH 1359/1799] Update vcxproj file structure documentation Updated per conversation with dev owner. --- docs/build/reference/vcxproj-file-structure.md | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/docs/build/reference/vcxproj-file-structure.md b/docs/build/reference/vcxproj-file-structure.md index 9bc67d8b8d9..d2ba07e23ff 100644 --- a/docs/build/reference/vcxproj-file-structure.md +++ b/docs/build/reference/vcxproj-file-structure.md @@ -125,18 +125,11 @@ The following snippet shows a project configuration. In this example, 'Debug|x64 The IDE expects to find a project configuration for any combination of `Configuration` and `Platform` values used in all `ProjectConfiguration` items. Often, it means that a project might have meaningless project configurations to fulfill this requirement. For instance, if a project has these configurations: - Debug|Win32 - - Retail|x64 - -- Special 32-bit Optimization|Win32 - -then it must also have these configurations, even though "Special 32-bit Optimization" is meaningless for x64: - - Debug|x64 - - Retail|Win32 -- Special 32-bit Optimization|x64 +Then if you add a new configuration to the project, say "Special 32-bit Optimization|Win32", then you must also add the configuration "Special 32-bit Optimization|x64", even though "Special 32-bit Optimization" is meaningless for x64. You can disable the build and deploy commands for any configuration in the **Solution Configuration Manager**. From 9abe04906e519895a675802cf91edc090d4d02ac Mon Sep 17 00:00:00 2001 From: Alcaro Date: Thu, 9 Oct 2025 20:40:16 +0200 Subject: [PATCH 1360/1799] Update zc-conformance.md --- docs/build/reference/zc-conformance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/zc-conformance.md b/docs/build/reference/zc-conformance.md index efa980dbb7f..e63eb3d9269 100644 --- a/docs/build/reference/zc-conformance.md +++ b/docs/build/reference/zc-conformance.md @@ -30,7 +30,7 @@ Here are the **`/Zc`** compiler options: | [`/Zc:checkGwOdr[-]`](zc-check-gwodr.md) | Enforce Standard C++ ODR violations under `/Gw`. | | [`/Zc:enumTypes[-]`](zc-enumtypes.md) | Enable Standard C++ rules for `enum` type deduction. Off by default. | | [`/Zc:externC[-]`](zc-externc.md) | Enforce Standard C++ rules for `extern "C"` functions. Off by default unless **`/permissive-`** is specified. | -| [`/Zc:externConstexpr[-]`](zc-externconstexpr.md) | Enable external linkage for **`constexpr`** variables. Off by default. | +| [`/Zc:externConstexpr[-]`](zc-externconstexpr.md) | Enable external linkage for **`constexpr`** variables. Off by default unless **`/permissive-`** is specified. | | [`/Zc:forScope[-]`](zc-forscope-force-conformance-in-for-loop-scope.md) | Enforce Standard C++ **`for`** scoping rules. On by default. | | [`/Zc:gotoScope[-]`](zc-gotoscope.md) | Enforce Standard C++ **`goto`** rules around local variable initialization. Off by default unless **`/permissive-`** is specified. | | [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules. Off by default unless **`/permissive-`** is specified. | From 62d5ffb0ebe43d36643ee37a9ac9ede0bbece4d5 Mon Sep 17 00:00:00 2001 From: integerbang Date: Thu, 9 Oct 2025 15:32:45 -0400 Subject: [PATCH 1361/1799] Update zc-conformance.md --- docs/build/reference/zc-conformance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/zc-conformance.md b/docs/build/reference/zc-conformance.md index efa980dbb7f..7c3d4f27a88 100644 --- a/docs/build/reference/zc-conformance.md +++ b/docs/build/reference/zc-conformance.md @@ -36,7 +36,7 @@ Here are the **`/Zc`** compiler options: | [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules. Off by default unless **`/permissive-`** is specified. | | [`/Zc:implicitNoexcept[-]`](zc-implicitnoexcept-implicit-exception-specifiers.md) | Enable implicit **`noexcept`** on required functions. On by default. | | [`/Zc:inline[-]`](zc-inline-remove-unreferenced-comdat.md) | Remove unreferenced functions or data if they're COMDAT or have internal linkage only. Off by default. | -| [`/Zc:lambda[-]`](zc-lambda.md) | Enable new lambda processor for conformance-mode syntactic checks in generic lambdas. Off by default unless **`/std:c++20`** or later is specified. | +| [`/Zc:lambda[-]`](zc-lambda.md) | Enable new lambda processor for conformance-mode syntactic checks in generic lambdas. Off by default unless **`/permissive-`** or **`/std:c++20`** or later is specified. | | [`/Zc:noexceptTypes[-]`](zc-noexcepttypes.md) | Enforce C++17 **`noexcept`** rules. Off by default unless **`/std:c++17`** or later is specified. | | [`/Zc:nrvo[-]`](zc-nrvo.md) | Enable optional copy and move elisions. Off by default unless **`/O2`**, **`/permissive-`**, or **`/std:c++20`** or later is specified. | | [`/Zc:preprocessor[-]`](zc-preprocessor.md) | Use the new conforming preprocessor. Off by default unless **`/std:c11`** or later is specified. | From 433c15dd0b156e9b784fea9fe322533a55fbb5a7 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 9 Oct 2025 16:03:15 -0700 Subject: [PATCH 1362/1799] draft support update --- .../supported-platforms-visual-cpp.md | 6 ++- docs/overview/toc.yml | 4 +- docs/overview/what-s-new-for-msvc.md | 38 +++++++++++++++++++ ...t-s-new-for-visual-cpp-in-visual-studio.md | 10 ++++- 4 files changed, 54 insertions(+), 4 deletions(-) create mode 100644 docs/overview/what-s-new-for-msvc.md diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 8c6f293023c..89a8064adf1 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -1,7 +1,7 @@ --- description: "Learn more about: Supported Platforms (Visual C++)" title: "Supported Platforms (Visual C++)" -ms.date: 11/09/2021 +ms.date: 10/09/2025 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] @@ -16,7 +16,7 @@ Apps built by using Visual Studio can be targeted to various platforms. |--|--|--|--|--| | Windows XP b | X | X | | | | Windows Vista | X | X | | | -| Windows 7 | X | X | | | +| Windows 7 | Xe | Xe | | | | Windows 8 | X | X | X | | | Windows 8.1 | X | X | X | | | Windows 10 | X | X | X | X | @@ -39,6 +39,8 @@ Apps built by using Visual Studio can be targeted to various platforms. d You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. +e Visual Studio 2026 18.0 and later no longer support targeting Windows 7 and Windows Server 2008 R2, which have stopped receiving security updates. + For information about how to set the target platform configuration, see [How to: Configure Visual C++ projects to target 64-bit, x64 platforms](../build/how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). ## See also diff --git a/docs/overview/toc.yml b/docs/overview/toc.yml index 66d418921eb..792c8638e27 100644 --- a/docs/overview/toc.yml +++ b/docs/overview/toc.yml @@ -6,7 +6,9 @@ items: href: ../overview/visual-cpp-in-visual-studio.md - name: Overview of C++ development in Visual Studio href: ../overview/overview-of-cpp-development.md - - name: What's new for C++ in Visual Studio 2022 + - name: What's new for MSVC + href: ../overview/what-s-new-for-msvc.md + - name: What's new for C++ in Visual Studio href: ../overview/what-s-new-for-visual-cpp-in-visual-studio.md - name: What's new for C++ in Visual Studio 2019 href: ../overview/what-s-new-for-cpp-2019.md diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md new file mode 100644 index 00000000000..ee0ff78b78e --- /dev/null +++ b/docs/overview/what-s-new-for-msvc.md @@ -0,0 +1,38 @@ +--- +title: "What's new for MSVC" +description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." +ms.date: 10/09/2025 +ms.service: "visual-cpp" +ms.subservice: "compiler" +ms.custom: intro-whats-new +--- + +# What's new for MSVC + +Microsoft C++ (MSVC) brings many updates and fixes to the Microsoft C++ compiler and tools. + +- For more information on what's new in all of Visual Studio, see [What's new in Visual Studio 2022](/visualstudio/ide/whats-new-visual-studio-2022). +- For information about version build dates, see [Visual Studio 2022 Release History](/visualstudio/releases/2022/release-history). + +## What's new for MSVC version x.y + +*Released November 2025* + +| For more information about | See | +|---|---| +| What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.14](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-14/) | +| Standard Library (STL) merged C++26 and C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.14](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1714) | +| C++ language updates | [C++ Language Updates in MSVC in Visual Studio 2022 17.14](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-in-visual-studio-2022-17-14/) | +| C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.14](cpp-conformance-improvements.md#improvements_1714) | + +A quick highlight of some of the new features: + +TBD + +## Feedback and suggestions + +We'd love to hear from you! You can [Report a Problem or Suggest a Feature](/visualstudio/ide/how-to-report-a-problem-with-visual-studio) by using the Send Feedback icon in the upper right-hand corner of either the installer or the Visual Studio IDE, or from **Help** > **Send Feedback**. You can track your issues by using [Visual Studio Developer Community](https://developercommunity.visualstudio.com/), where you add comments or find solutions. You can also get free installation help through our [Live Chat support](https://visualstudio.microsoft.com/vs/support/#talktous). + +## Blogs + +Take advantage of the insights and recommendations available in the [Microsoft Developer Blogs](https://devblogs.microsoft.com/) site to stay up to date on all new releases. The blogs include deep dive posts on a broad range of features. The [C++ Team Blog](https://devblogs.microsoft.com/cppblog) and the [Visual Studio Blog](https://devblogs.microsoft.com/visualstudio) are of particular interest. \ No newline at end of file diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index 4f546d1d8c0..92546434fb0 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -1,13 +1,21 @@ --- title: "What's new for C++ in Visual Studio" description: "The new features and fixes in the Microsoft C/C++ compiler and tools in Visual Studio." -ms.date: 05/13/2025 +ms.date: 10/09/2025 ms.service: "visual-cpp" ms.subservice: "ide" ms.custom: intro-whats-new ai-usage: ai-assisted --- +# What's new for C++ in Visual Studio + +MSVC now ships on it's own cadence, independent of Visual Studio. For the latest updates to MSVC, see [What's new for MSVC](/cpp/overview/what-s-new-for-msvc.md). + +# What's new for C++ in Visual Studio 2026 + +VS 2026 18.0 and later no longer support targeting Windows 7 and Windows Server 2008 R2, which have stopped receiving security updates. + # What's new for C++ in Visual Studio 2022 Visual Studio 2022 brings many updates and fixes to the Microsoft C++ compiler and tools. The Visual Studio IDE also offers significant improvements in performance and productivity, and now runs natively as a 64-bit application. From e95b76ce43db8b11334d05e7848d7320920a6258 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 9 Oct 2025 16:14:11 -0700 Subject: [PATCH 1363/1799] update --- docs/overview/supported-platforms-visual-cpp.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 89a8064adf1..e7fce871079 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -17,13 +17,13 @@ Apps built by using Visual Studio can be targeted to various platforms. | Windows XP b | X | X | | | | Windows Vista | X | X | | | | Windows 7 | Xe | Xe | | | -| Windows 8 | X | X | X | | -| Windows 8.1 | X | X | X | | +| Windows 8 | Xe | Xe | Xe | | +| Windows 8.1 | Xe | Xe | Xe | | | Windows 10 | X | X | X | X | | Windows 11 | X | X | X | X | | Windows Server 2003 b | X | X | | | -| Windows Server 2008 R2 | X | X | | | -| Windows Server 2012 R2 | X | X | | | +| Windows Server 2008 R2 | Xe | Xe | | | +| Windows Server 2012 R2 | Xe | Xe | | | | Windows Server 2016 | X | X | | | | Windows Server 2019 | X | X | | | | Windows Server 2022 | X | X | | | @@ -39,7 +39,7 @@ Apps built by using Visual Studio can be targeted to various platforms. d You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. -e Visual Studio 2026 18.0 and later no longer support targeting Windows 7 and Windows Server 2008 R2, which have stopped receiving security updates. +e Visual Studio 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2. The minimum OS version that Visual Studio 2026 and later can target is Windows 10 or later and Windows Server 2016 or later. For information about how to set the target platform configuration, see [How to: Configure Visual C++ projects to target 64-bit, x64 platforms](../build/how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). From 4423a0b9b23f56285790ba925a198e422e539a2a Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 9 Oct 2025 16:28:10 -0700 Subject: [PATCH 1364/1799] small edit --- docs/overview/supported-platforms-visual-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index e7fce871079..3ceead7215b 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -39,7 +39,7 @@ Apps built by using Visual Studio can be targeted to various platforms. d You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. -e Visual Studio 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2. The minimum OS version that Visual Studio 2026 and later can target is Windows 10 or later and Windows Server 2016 or later. +e Visual Studio 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2. Visual Studio 2026 and later target Windows 10 or later and Windows Server 2016 or later. For information about how to set the target platform configuration, see [How to: Configure Visual C++ projects to target 64-bit, x64 platforms](../build/how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). From 5a77f0cb555f504e127229bd5770af122c37c05e Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 14 Oct 2025 12:44:20 -0700 Subject: [PATCH 1365/1799] show '#ifdef' pattern for `__declspec(no_sanitize_address)` --- docs/sanitizers/asan-building.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/sanitizers/asan-building.md b/docs/sanitizers/asan-building.md index b04ac105607..383eb40b291 100644 --- a/docs/sanitizers/asan-building.md +++ b/docs/sanitizers/asan-building.md @@ -35,18 +35,24 @@ int main() { The [`__declspec(no_sanitize_address)`](../cpp/no-sanitize-address.md) specifier can be used to selectively disable the sanitizer on functions, local variables, or global variables. This `__declspec` affects _compiler_ behavior, not _runtime_ behavior. ```cpp -__declspec(no_sanitize_address) +#ifdef __SANITIZE_ADDRESS__ +#define NO_SANITIZE_ADDRESS __declspec(no_sanitize_address) +#else +#define NO_SANITIZE_ADDRESS +#endif + +NO_SANITIZE_ADDRESS void test1() { int x[100]; x[100] = 5; // ASan exception not caught } void test2() { - __declspec(no_sanitize_address) int x[100]; + NO_SANITIZE_ADDRESS int x[100]; x[100] = 5; // ASan exception not caught } -__declspec(no_sanitize_address) int g[100]; +NO_SANITIZE_ADDRESS int g[100]; void test3() { g[100] = 5; // ASan exception not caught } From 8575d50d970c7fc05633052c30e33e74287ba6ad Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 14 Oct 2025 17:36:06 -0700 Subject: [PATCH 1366/1799] add more context to sample --- docs/sanitizers/asan-building.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/sanitizers/asan-building.md b/docs/sanitizers/asan-building.md index 383eb40b291..67def513490 100644 --- a/docs/sanitizers/asan-building.md +++ b/docs/sanitizers/asan-building.md @@ -36,6 +36,9 @@ The [`__declspec(no_sanitize_address)`](../cpp/no-sanitize-address.md) specifier ```cpp #ifdef __SANITIZE_ADDRESS__ +// `no_sanitize_address` is only defined when compiling with ASan. +// You can guard against this by checking if `__SANITIZE_ADDRESS__` +// is defined. #define NO_SANITIZE_ADDRESS __declspec(no_sanitize_address) #else #define NO_SANITIZE_ADDRESS From 4aab6801c102ac440abcc23b8d70ec2d8458ff92 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 14 Oct 2025 19:55:52 -0700 Subject: [PATCH 1367/1799] Change AddressSanitizer references to MSVC AddressSanitizer Getting a head start on the new branding. --- docs/sanitizers/asan-building.md | 65 +++++++++++++++++--------------- 1 file changed, 34 insertions(+), 31 deletions(-) diff --git a/docs/sanitizers/asan-building.md b/docs/sanitizers/asan-building.md index 67def513490..09140d51c92 100644 --- a/docs/sanitizers/asan-building.md +++ b/docs/sanitizers/asan-building.md @@ -1,30 +1,31 @@ --- -title: "AddressSanitizer language, build, and debugging reference" -description: "Technical description of building for the AddressSanitizer" +title: "MSVC AddressSanitizer language, build, and debugging reference" +description: "Technical description of building for the MSVC AddressSanitizer" ms.date: 02/05/2024 f1_keywords: ["__SANITIZE_ADDRESS__", "ASAN_VCASAN_DEBUGGING"] -helpviewer_keywords: ["ASan reference", "AddressSanitizer reference", "Address Sanitizer reference"] +helpviewer_keywords: ["ASan reference", "MSVC AddressSanitizer reference", "MSVC Address Sanitizer reference"] --- -# AddressSanitizer language, build, and debugging reference +# MSVC AddressSanitizer language, build, and debugging reference -This article describes the AddressSanitizer language specification, compiler options, linker options, and the options that control Visual Studio debugger integration specific to the AddressSanitizer. +This article describes the MSVC AddressSanitizer language specification, compiler options, linker options, and the options that control Visual Studio debugger integration specific to the MSVC AddressSanitizer. -For more information on the AddressSanitizer runtime, see the [runtime reference](asan-runtime.md). It includes information on intercepted functions and how to hook custom allocators. For more information on saving crash dumps from AddressSanitizer failures, see the [crash dump reference](asan-offline-crash-dumps.md). +For more information on the MSVC AddressSanitizer runtime, see the [runtime reference](asan-runtime.md). It includes information on intercepted functions and how to hook custom allocators. For more information on saving crash dumps from MSVC AddressSanitizer failures, see the [crash dump reference](asan-offline-crash-dumps.md). ## Language specification ### `__SANITIZE_ADDRESS__` -The `__SANITIZE_ADDRESS__` preprocessor macro is defined as `1` when [`/fsanitize=address`](../build/reference/fsanitize.md) is set. This macro is useful for advanced users to conditionally specify source code for the presence of the AddressSanitizer runtime. +The `__SANITIZE_ADDRESS__` preprocessor macro is defined as `1` when [`/fsanitize=address`](../build/reference/fsanitize.md) is set. This macro is useful to conditionally specify source code for the presence of the MSVC AddressSanitizer runtime. ```cpp #include -int main() { +int main() +{ #ifdef __SANITIZE_ADDRESS__ - printf("Address sanitizer enabled"); + printf("MSVC AddressSanitizer enabled"); #else - printf("Address sanitizer not enabled"); + printf("MSVC AddressSanitizer not enabled"); #endif return 1; } @@ -36,27 +37,29 @@ The [`__declspec(no_sanitize_address)`](../cpp/no-sanitize-address.md) specifier ```cpp #ifdef __SANITIZE_ADDRESS__ -// `no_sanitize_address` is only defined when compiling with ASan. -// You can guard against this by checking if `__SANITIZE_ADDRESS__` -// is defined. +// no_sanitize_address is only defined when compiling with MSVC AddressSanitizer. +// Guard against this by checking if `__SANITIZE_ADDRESS__` is defined. #define NO_SANITIZE_ADDRESS __declspec(no_sanitize_address) #else #define NO_SANITIZE_ADDRESS #endif NO_SANITIZE_ADDRESS -void test1() { +void test1() +{ int x[100]; x[100] = 5; // ASan exception not caught } -void test2() { +void test2() +{ NO_SANITIZE_ADDRESS int x[100]; x[100] = 5; // ASan exception not caught } NO_SANITIZE_ADDRESS int g[100]; -void test3() { +void test3() +{ g[100] = 5; // ASan exception not caught } ``` @@ -65,11 +68,11 @@ void test3() { ### `/fsanitize=address` compiler option -The [**`/fsanitize=address`**](../build/reference/fsanitize.md) compiler option instruments memory references in your code to catch memory safety errors at runtime. The instrumentation hooks loads, stores, scopes, `alloca`, and CRT functions. It can detect hidden bugs such as out-of-bounds, use-after-free, use-after-scope, and so on. For a nonexhaustive list of errors detected at runtime, see [AddressSanitizer error examples](asan-error-examples.md). +The [**`/fsanitize=address`**](../build/reference/fsanitize.md) compiler option instruments memory references in your code to catch memory safety errors at runtime. The instrumentation hooks loads, stores, scopes, `alloca`, and CRT functions. It can detect hidden bugs such as out-of-bounds, use-after-free, use-after-scope, and so on. For a nonexhaustive list of errors detected at runtime, see [MSVC AddressSanitizer error examples](asan-error-examples.md). **`/fsanitize=address`** is compatible with all existing C++ or C optimization levels (for example, **`/Od`**, **`/O1`**, **`/O2`**, and **`/O2 /GL`**). The code produced with this option works with static and dynamic CRTs (for example, **`/MD`**, **`/MDd`**, **`/MT`**, and **`/MTd`**). This compiler option can be used to create an .EXE or .DLL targeting x86 or x64. Debug information is required for optimal formatting of call stacks. This compiler option isn't supported with profile guided optimization. -For examples of code that demonstrates several kinds of error detection, see [AddressSanitizer error examples](asan-error-examples.md). +For examples of code that demonstrates several kinds of error detection, see [MSVC AddressSanitizer error examples](asan-error-examples.md). ### `/fsanitize=fuzzer` compiler option (experimental) @@ -104,7 +107,7 @@ If you specify **`/NODEFAULTLIB`** and you don't specify one of these libraries, ### `/fsanitize-address-use-after-return` compiler option (experimental) -By default, the MSVC compiler (unlike Clang) doesn't generate code to allocate frames in the heap to catch use-after-return errors. To catch these errors using AddressSanitizer, you must: +By default, the MSVC compiler (unlike Clang) doesn't generate code to allocate frames in the heap to catch use-after-return errors. To catch these errors using MSVC AddressSanitizer, you must: 1. Compile using the [`/fsanitize-address-use-after-return`](../build/reference/fsanitize.md) option. 2. Before executing your program, run `set ASAN_OPTIONS=detect_stack_use_after_return=1` to set the runtime check option. @@ -129,13 +132,13 @@ Using **`/fsanitize-address-asan-compat-lib`** to link a newer compiler with an ### `/INFERASANLIBS[:NO]` linker option -The **`/fsanitize=address`** compiler option marks objects to specify which AddressSanitizer library to link into your executable. The libraries have names that begin with *`clang_rt.asan*`*. The [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) linker option (on by default) links these libraries from their default locations automatically. Here are the libraries chosen and automatically linked in. +The **`/fsanitize=address`** compiler option marks objects to specify which MSVC AddressSanitizer library to link into your executable. The libraries have names that begin with *`clang_rt.asan*`*. The [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) linker option (on by default) links these libraries from their default locations automatically. Here are the libraries chosen and automatically linked in. > [!NOTE] > In the following table, *`{arch}`* is either *`i386`* or *`x86_64`*. > These libraries use Clang conventions for architecture names. MSVC conventions are normally `x86` and `x64` rather than `i386` and `x86_64`. They refer to the same architectures. -| CRT option | AddressSanitizer runtime library (.lib) | Address runtime binary (.dll) +| CRT option | MSVC AddressSanitizer runtime library (.lib) | Address runtime binary (.dll) |--|--|--| | `/MT` or `/MTd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_static_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* | `/MD` or `/MDd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_dynamic_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* @@ -144,10 +147,10 @@ The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) pre **Previous Versions** -Prior to Visual Studio 17.7 Preview 3, statically linked (**`/MT`** or **`/MTd`**) builds didn't use a DLL dependency. Instead, the AddressSanitizer runtime was statically linked into the user's EXE. DLL projects would then load exports from the user's EXE to access ASan functionality. Also, dynamically linked projects (**`/MD`** or **`/MTd`**) used different libraries and DLLs depending on whether the project was configured for debug or release. For more information about these changes and their motivations, see [MSVC Address Sanitizer – One DLL for all Runtime Configurations](https://devblogs.microsoft.com/cppblog/msvc-address-sanitizer-one-dll-for-all-runtime-configurations/). +Prior to Visual Studio 17.7 Preview 3, statically linked (**`/MT`** or **`/MTd`**) builds didn't use a DLL dependency. Instead, the MSVC AddressSanitizer runtime was statically linked into the user's EXE. DLL projects would then load exports from the user's EXE to access ASan functionality. Also, dynamically linked projects (**`/MD`** or **`/MTd`**) used different libraries and DLLs depending on whether the project was configured for debug or release. For more information about these changes and their motivations, see [MSVC AddressSanitizer – One DLL for all Runtime Configurations](https://devblogs.microsoft.com/cppblog/msvc-address-sanitizer-one-dll-for-all-runtime-configurations/). -| CRT runtime option | DLL or EXE | AddressSanitizer runtime libraries | +| CRT runtime option | DLL or EXE | MSVC AddressSanitizer runtime libraries | |--|--|--| | **`/MT`** | EXE | *`/wholearchive:clang_rt.asan-{arch}.lib`*, *`clang_rt.asan_cxx-{arch}.lib`* | | **`/MT`** | DLL | *`/wholearchive:clang_rt.asan_dll_thunk-{arch}.lib`* | @@ -160,7 +163,7 @@ Prior to Visual Studio 17.7 Preview 3, statically linked (**`/MT`** or **`/MTd`* ### `/fno-sanitize-address-vcasan-lib` compiler option -The **`/fsanitize=address`** option links in extra libraries for an improved Visual Studio debugging experience when an AddressSanitizer exception is thrown. These libraries are called **VCAsan**. The libraries enable Visual Studio to display AddressSanitizer errors on your source code. They also enable the executable to generate crash dumps when an AddressSanitizer error report is created. For more information, see [Visual Studio AddressSanitizer extended functionality library](asan-debugger-integration.md). +The **`/fsanitize=address`** option links in extra libraries for an improved Visual Studio debugging experience when an MSVC AddressSanitizer exception is thrown. These libraries are called **VCAsan**. The libraries enable Visual Studio to display MSVC AddressSanitizer errors on your source code. They also enable the executable to generate crash dumps when an MSVC AddressSanitizer error report is created. For more information, see [Visual Studio MSVC AddressSanitizer extended functionality library](asan-debugger-integration.md). The library chosen depends on the compiler options, and is automatically linked in. @@ -188,10 +191,10 @@ To enable this behavior, run the command `set ASAN_VCASAN_DEBUGGING=1` before yo ## See also -[AddressSanitizer overview](asan.md)\ -[AddressSanitizer known issues](asan-known-issues.md)\ -[AddressSanitizer runtime reference](asan-runtime.md)\ -[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](asan-debugger-integration.md)\ -[AddressSanitizer error examples](asan-error-examples.md) +[MSVC AddressSanitizer overview](asan.md)\ +[MSVC AddressSanitizer known issues](asan-known-issues.md)\ +[MSVC AddressSanitizer runtime reference](asan-runtime.md)\ +[MSVC AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[MSVC AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[MSVC AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[MSVC AddressSanitizer error examples](asan-error-examples.md) From 7d0c3bf5c610b8c91285616a124026d0acf0e508 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 15 Oct 2025 10:15:59 -0700 Subject: [PATCH 1368/1799] new article for #warning --- .../hash-error-directive-c-cpp.md | 6 ++-- .../hash-warning-directive-c-cpp.md | 29 +++++++++++++++++++ docs/preprocessor/preprocessor-directives.md | 8 ++--- docs/preprocessor/toc.yml | 2 ++ 4 files changed, 38 insertions(+), 7 deletions(-) create mode 100644 docs/preprocessor/hash-warning-directive-c-cpp.md diff --git a/docs/preprocessor/hash-error-directive-c-cpp.md b/docs/preprocessor/hash-error-directive-c-cpp.md index 2a5ec7bfe95..f98fd41b1fd 100644 --- a/docs/preprocessor/hash-error-directive-c-cpp.md +++ b/docs/preprocessor/hash-error-directive-c-cpp.md @@ -4,11 +4,10 @@ title: "#error directive (C/C++)" ms.date: "08/29/2019" f1_keywords: ["#error"] helpviewer_keywords: ["#error directive", "preprocessor, directives", "error directive (#error directive)"] -ms.assetid: d550a802-ff19-4347-9597-688935d23b2b --- # #error directive (C/C++) -The **#error** directive emits a user-specified error message at compile time, and then terminates the compilation. +The `#error` directive emits a user-specified error message at compile time. Then it terminates the compilation. ## Syntax @@ -26,4 +25,5 @@ The error message that this directive emits includes the *token-string* paramete ## See also -[Preprocessor directives](../preprocessor/preprocessor-directives.md) +[Preprocessor directives](../preprocessor/preprocessor-directives.md)\ +[#warning directive](../preprocessor/hash-warning-directive-c-cpp.md) diff --git a/docs/preprocessor/hash-warning-directive-c-cpp.md b/docs/preprocessor/hash-warning-directive-c-cpp.md new file mode 100644 index 00000000000..0f2763c0172 --- /dev/null +++ b/docs/preprocessor/hash-warning-directive-c-cpp.md @@ -0,0 +1,29 @@ +--- +description: "Learn more about: #warning directive (C/C++)" +title: "#warning directive (C/C++)" +ms.date: "11/08/2023" +f1_keywords: ["#warning"] +helpviewer_keywords: ["#warning directive", "preprocessor, directives", "warning directive (#warning directive)"] +--- +# #warning directive (C/C++) + +The **#warning** directive emits a user-specified warning message at compile time, and does not stop the compilation. This directive is a standard feature since C23 and C++23. + +## Syntax + +> **#warning** *token-string* + +## Remarks + +The warning message that this directive emits includes the *token-string* parameter. The *token-string* parameter is not subject to macro expansion and can be optionally enclosed in quotes. This directive is used to inform the developer of a non-fatal issue that may have occured, or to disseminate important information. The following example shows how the **#warning** directive is used: + +```cpp +#if defined(_LEGACY_FEATURE_FLAG) +#warning "_LEGACY_FEATURE is deprecated and should not be used." +#endif +``` + +## See also + +[Preprocessor directives](../preprocessor/preprocessor-directives.md)\ +[#error directive](../preprocessor/hash-error-directive-c-cpp.md) \ No newline at end of file diff --git a/docs/preprocessor/preprocessor-directives.md b/docs/preprocessor/preprocessor-directives.md index 38d13833a81..f3c11dd326f 100644 --- a/docs/preprocessor/preprocessor-directives.md +++ b/docs/preprocessor/preprocessor-directives.md @@ -1,13 +1,12 @@ --- description: "Learn more about: Preprocessor directives" title: "Preprocessor directives" -ms.date: "08/29/2019" +ms.date: 10/15/2025 helpviewer_keywords: ["directives, preprocessor", "preprocessor, directives"] -ms.assetid: e0fc4564-b6cf-4a36-bf51-6ccd7abd0a94 --- # Preprocessor directives -Preprocessor directives, such as `#define` and `#ifdef`, are typically used to make source programs easy to change and easy to compile in different execution environments. Directives in the source file tell the preprocessor to take specific actions. For example, the preprocessor can replace tokens in the text, insert the contents of other files into the source file, or suppress compilation of part of the file by removing sections of text. Preprocessor lines are recognized and carried out before macro expansion. Therefore, if a macro expands into something that looks like a preprocessor command, it isn't recognized by the preprocessor. +Preprocessor directives, such as `#define` and `#ifdef`, are used to make source programs easy to change and compile in different execution environments. Directives in the source file tell the preprocessor to take specific actions. For example, the preprocessor can replace tokens in the text, insert the contents of other files into the source file, or suppress compilation of part of the file by removing sections of text. Preprocessor directives are processed before macro expansion. Therefore, if a macro expands into something that looks like a preprocessor command, it isn't recognized by the preprocessor. Preprocessor statements use the same character set as source file statements, with the exception that escape sequences aren't supported. The character set used in preprocessor statements is the same as the execution character set. The preprocessor also recognizes negative character values. @@ -29,7 +28,8 @@ The preprocessor recognizes the following directives: :::column span=""::: [`#import`](../preprocessor/hash-import-directive-cpp.md)\ [`#include`](../preprocessor/hash-include-directive-c-cpp.md)\ - [`#line`](../preprocessor/hash-line-directive-c-cpp.md) + [`#line`](../preprocessor/hash-line-directive-c-cpp.md)\ + [`#warning`](../preprocessor/hash-warning-directive-c-cpp.md) :::column-end::: :::column span=""::: [`#pragma`](../preprocessor/pragma-directives-and-the-pragma-keyword.md)\ diff --git a/docs/preprocessor/toc.yml b/docs/preprocessor/toc.yml index 4535a25eb64..aa4066ec4e0 100644 --- a/docs/preprocessor/toc.yml +++ b/docs/preprocessor/toc.yml @@ -92,6 +92,8 @@ items: href: ../preprocessor/hash-undef-directive-c-cpp.md - name: "#using directive (C++/CLI)" href: ../preprocessor/hash-using-directive-cpp.md + - name: "#warning directive (C/C++)" + href: ../preprocessor/hash-warning-directive-c-cpp.md - name: Preprocessor operators expanded: false items: From 895556a39467595fc1d8c987516a351d3bc474a2 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 15 Oct 2025 10:36:56 -0700 Subject: [PATCH 1369/1799] acrolinx --- docs/preprocessor/hash-warning-directive-c-cpp.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/preprocessor/hash-warning-directive-c-cpp.md b/docs/preprocessor/hash-warning-directive-c-cpp.md index 0f2763c0172..108d3518e93 100644 --- a/docs/preprocessor/hash-warning-directive-c-cpp.md +++ b/docs/preprocessor/hash-warning-directive-c-cpp.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["#warning directive", "preprocessor, directives", "warning --- # #warning directive (C/C++) -The **#warning** directive emits a user-specified warning message at compile time, and does not stop the compilation. This directive is a standard feature since C23 and C++23. +The **#warning** directive emits a user-specified warning message at compile time, and doesn't stop compilation. This directive is available starting in C23 and C++23. ## Syntax @@ -15,7 +15,7 @@ The **#warning** directive emits a user-specified warning message at compile tim ## Remarks -The warning message that this directive emits includes the *token-string* parameter. The *token-string* parameter is not subject to macro expansion and can be optionally enclosed in quotes. This directive is used to inform the developer of a non-fatal issue that may have occured, or to disseminate important information. The following example shows how the **#warning** directive is used: +The warning message that this directive emits includes the *token-string* parameter. The *token-string* parameter isn't subject to macro expansion and can be optionally enclosed in quotes. This directive is used to inform the developer of a nonfatal issue that may occur, or to disseminate important information. The following example shows how to use the **#warning** directive: ```cpp #if defined(_LEGACY_FEATURE_FLAG) From e771bbc32e6e1b8553cbf05a8d70e835c0f8990d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 15 Oct 2025 10:46:07 -0700 Subject: [PATCH 1370/1799] wording --- docs/preprocessor/hash-warning-directive-c-cpp.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/preprocessor/hash-warning-directive-c-cpp.md b/docs/preprocessor/hash-warning-directive-c-cpp.md index 108d3518e93..a8475612c57 100644 --- a/docs/preprocessor/hash-warning-directive-c-cpp.md +++ b/docs/preprocessor/hash-warning-directive-c-cpp.md @@ -1,13 +1,13 @@ --- description: "Learn more about: #warning directive (C/C++)" title: "#warning directive (C/C++)" -ms.date: "11/08/2023" +ms.date: 10/15/2025 f1_keywords: ["#warning"] helpviewer_keywords: ["#warning directive", "preprocessor, directives", "warning directive (#warning directive)"] --- # #warning directive (C/C++) -The **#warning** directive emits a user-specified warning message at compile time, and doesn't stop compilation. This directive is available starting in C23 and C++23. +The **#warning** directive emits a user-specified warning message at compile time. It doesn't stop compilation. This directive is available starting in C23 and C++23. ## Syntax @@ -15,7 +15,10 @@ The **#warning** directive emits a user-specified warning message at compile tim ## Remarks -The warning message that this directive emits includes the *token-string* parameter. The *token-string* parameter isn't subject to macro expansion and can be optionally enclosed in quotes. This directive is used to inform the developer of a nonfatal issue that may occur, or to disseminate important information. The following example shows how to use the **#warning** directive: +The warning message is the *token-string* parameter. The *token-string* parameter isn't subject to macro expansion and can be optionally enclosed in quotes.\ +Use this directive to inform the developer of a nonfatal issue or to communicate other important information during compilation. + +The following example shows how to use the **#warning** directive: ```cpp #if defined(_LEGACY_FEATURE_FLAG) From ed81a241ce9e6ad251d475e873a5a8a521045412 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 15 Oct 2025 11:05:01 -0700 Subject: [PATCH 1371/1799] small edit --- docs/preprocessor/hash-warning-directive-c-cpp.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/preprocessor/hash-warning-directive-c-cpp.md b/docs/preprocessor/hash-warning-directive-c-cpp.md index a8475612c57..83c36ab7418 100644 --- a/docs/preprocessor/hash-warning-directive-c-cpp.md +++ b/docs/preprocessor/hash-warning-directive-c-cpp.md @@ -15,7 +15,8 @@ The **#warning** directive emits a user-specified warning message at compile tim ## Remarks -The warning message is the *token-string* parameter. The *token-string* parameter isn't subject to macro expansion and can be optionally enclosed in quotes.\ +The warning message is the *token-string* parameter. The *token-string* parameter isn't subject to macro expansion and can be optionally enclosed in quotes. + Use this directive to inform the developer of a nonfatal issue or to communicate other important information during compilation. The following example shows how to use the **#warning** directive: From e50b998580831209857e086e92f6122a156fd1d0 Mon Sep 17 00:00:00 2001 From: Avasam Date: Sun, 19 Oct 2025 00:36:06 -0400 Subject: [PATCH 1372/1799] Removed mention of inexistant `CSliderCtrl::VerifyPos` --- docs/mfc/slider-control-member-functions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/mfc/slider-control-member-functions.md b/docs/mfc/slider-control-member-functions.md index 10e1c674727..2e0e2228d90 100644 --- a/docs/mfc/slider-control-member-functions.md +++ b/docs/mfc/slider-control-member-functions.md @@ -9,7 +9,7 @@ ms.assetid: dbde49ee-7306-4d14-a6ce-d09aa198178f An application can call the slider control's member functions to retrieve information about the slider control ([CSliderCtrl](../mfc/reference/csliderctrl-class.md)) and to change its characteristics. -To retrieve the position of the slider (that is, the value the user has chosen), use the [GetPos](../mfc/reference/csliderctrl-class.md#getpos) member function. To set the position of the slider, use the [SetPos](../mfc/reference/csliderctrl-class.md#setpos) member function. At any time you can use the `VerifyPos` member function to make sure that the slider is between the minimum and maximum values. +To retrieve the position of the slider (that is, the value the user has chosen), use the [GetPos](../mfc/reference/csliderctrl-class.md#getpos) member function. To set the position of the slider, use the [SetPos](../mfc/reference/csliderctrl-class.md#setpos) member function. The range of a slider control is the set of contiguous values that the slider control can represent. Most applications use the [SetRange](../mfc/reference/csliderctrl-class.md#setrange) member function to set the range of a slider control when it is first created. Applications can dynamically alter the range after the slider control has been created by using the [SetRangeMax](../mfc/reference/csliderctrl-class.md#setrangemax) and [SetRangeMin](../mfc/reference/csliderctrl-class.md#setrangemin) member functions. An application that allows the range to be changed dynamically typically retrieves the final range settings when the user has finished working with the slider control. To retrieve these settings, use the [GetRange](../mfc/reference/csliderctrl-class.md#getrange), [GetRangeMax](../mfc/reference/csliderctrl-class.md#getrangemax), and [GetRangeMin](../mfc/reference/csliderctrl-class.md#getrangemin) member functions. From a074e1ab25e56c88a94001586b11b9902d4eb453 Mon Sep 17 00:00:00 2001 From: Mahmoud Saleh <12202790+MahmoudGSaleh@users.noreply.github.com> Date: Mon, 20 Oct 2025 13:57:13 -0700 Subject: [PATCH 1373/1799] Revise Visual C++ Redistributable support details Updated Windows XP support information and added note on Visual Studio 2015 support lifecycle. --- docs/windows/latest-supported-vc-redist.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 9217788e655..7a1405a5465 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -58,8 +58,9 @@ Download other versions, including long term servicing release channel (LTSC) ve - The Visual C++ Redistributable for Visual Studio 2015-2022 doesn't have separate packages for different languages. It contains EULAs for all supported languages. - Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Log in using a Visual Studio Subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or, create a free account by choosing the **No account? Create one!** link. - Visual Studio versions since Visual Studio 2015 share the same Redistributable files. For example, any apps built by the Visual Studio 2015, 2017, 2019, or 2022 toolsets can use the latest Microsoft Visual C++ Redistributable. However, the version of the Microsoft Visual C++ Redistributable installed on the machine must be the same or higher than the version of the Visual C++ toolset used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). -- **Windows XP Support**: Microsoft ended support for Windows XP on April 8, 2014. Current versions of the Visual C++ Redistributable for Visual Studio 2015-2022 only support Windows 7, 8.1, 10, and 11. The last version of the Visual C++ Redistributable that works on Windows XP shipped in Visual Studio 2019 version 16.7 (file versions starting with **14.27**). The Redistributable is available in the [my.visualstudio.com Downloads](https://my.visualstudio.com/Downloads/) section as **Visual C++ Redistributable for Visual Studio 2019 (version 16.7)**. Use the Search box to find this version. To download the files, select the platform and language you need, and then choose the **Download** button. -- The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). +- **Windows XP Support**: Microsoft ended support for Windows XP on April 8, 2014. Current versions of the Visual C++ Redistributable for Visual Studio 2015-2022 only support Windows 7, 8.1, 10, and 11. +- Support for Visual Studio 2015 has ended on October 15, 2025. Since the support lifecycle of Visual C++ Redistributable follows the version of Visual Studio in which they first ship, support for Visual C++ Redistributable 2015 (version 14.0.24212) has also ended on the same date. +- The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions From 7eb1ddd8e5a3b0721ca9bd58b62f81331450d9d2 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 21 Oct 2025 13:00:31 -0700 Subject: [PATCH 1374/1799] edit --- docs/windows/latest-supported-vc-redist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 7a1405a5465..878325159a6 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -59,7 +59,7 @@ Download other versions, including long term servicing release channel (LTSC) ve - Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Log in using a Visual Studio Subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or, create a free account by choosing the **No account? Create one!** link. - Visual Studio versions since Visual Studio 2015 share the same Redistributable files. For example, any apps built by the Visual Studio 2015, 2017, 2019, or 2022 toolsets can use the latest Microsoft Visual C++ Redistributable. However, the version of the Microsoft Visual C++ Redistributable installed on the machine must be the same or higher than the version of the Visual C++ toolset used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). - **Windows XP Support**: Microsoft ended support for Windows XP on April 8, 2014. Current versions of the Visual C++ Redistributable for Visual Studio 2015-2022 only support Windows 7, 8.1, 10, and 11. -- Support for Visual Studio 2015 has ended on October 15, 2025. Since the support lifecycle of Visual C++ Redistributable follows the version of Visual Studio in which they first ship, support for Visual C++ Redistributable 2015 (version 14.0.24212) has also ended on the same date. +- Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which they first ship, support for Visual C++ Redistributable 2015 (version 14.0.24212) also ended October 15, 2025. - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions From c867a5e49cc45a909acf6ce794b147c76fabd551 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 21 Oct 2025 14:35:31 -0700 Subject: [PATCH 1375/1799] edits --- docs/overview/supported-platforms-visual-cpp.md | 2 +- docs/overview/what-s-new-for-msvc.md | 4 ++-- docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 3ceead7215b..17c444bd70b 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -1,7 +1,7 @@ --- description: "Learn more about: Supported Platforms (Visual C++)" title: "Supported Platforms (Visual C++)" -ms.date: 10/09/2025 +ms.date: 10/17/2025 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index ee0ff78b78e..bd24a7c88a3 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -9,7 +9,7 @@ ms.custom: intro-whats-new # What's new for MSVC -Microsoft C++ (MSVC) brings many updates and fixes to the Microsoft C++ compiler and tools. +Version x.y.z. brings many updates and fixes to the Microsoft C++ compiler and tools. - For more information on what's new in all of Visual Studio, see [What's new in Visual Studio 2022](/visualstudio/ide/whats-new-visual-studio-2022). - For information about version build dates, see [Visual Studio 2022 Release History](/visualstudio/releases/2022/release-history). @@ -21,7 +21,7 @@ Microsoft C++ (MSVC) brings many updates and fixes to the Microsoft C++ compiler | For more information about | See | |---|---| | What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.14](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-14/) | -| Standard Library (STL) merged C++26 and C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.14](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1714) | +| Standard Library (STL) merged C++26 and C++23 features, Language Working Group (CWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.14](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1714) | | C++ language updates | [C++ Language Updates in MSVC in Visual Studio 2022 17.14](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-in-visual-studio-2022-17-14/) | | C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.14](cpp-conformance-improvements.md#improvements_1714) | diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index 92546434fb0..68de088af23 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -10,11 +10,11 @@ ai-usage: ai-assisted # What's new for C++ in Visual Studio -MSVC now ships on it's own cadence, independent of Visual Studio. For the latest updates to MSVC, see [What's new for MSVC](/cpp/overview/what-s-new-for-msvc.md). +MSVC now ships on its own cadence, independent of Visual Studio. For the latest updates to MSVC, see [What's new for MSVC](/cpp/overview/what-s-new-for-msvc.md). # What's new for C++ in Visual Studio 2026 -VS 2026 18.0 and later no longer support targeting Windows 7 and Windows Server 2008 R2, which have stopped receiving security updates. +VS 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2, which have stopped receiving security updates. # What's new for C++ in Visual Studio 2022 From 776a2042c67b08de2e1a2991012f99c02116270e Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 21 Oct 2025 14:57:38 -0700 Subject: [PATCH 1376/1799] new avx10.2 flag --- docs/build/reference/arch-x64.md | 16 +++++++++++----- docs/build/reference/arch-x86.md | 16 +++++++++++----- docs/build/reference/vlen.md | 9 ++++++--- docs/preprocessor/predefined-macros.md | 20 +++++++++----------- 4 files changed, 37 insertions(+), 24 deletions(-) diff --git a/docs/build/reference/arch-x64.md b/docs/build/reference/arch-x64.md index 0bcf4ff2022..625ee1411f8 100644 --- a/docs/build/reference/arch-x64.md +++ b/docs/build/reference/arch-x64.md @@ -1,9 +1,9 @@ --- description: "Learn more about: /arch (x64)" title: "/arch (x64)" -ms.date: 06/30/2022 -f1_keywords: ["/arch:SSE2", "/arch:SSE4.2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1"] -helpviewer_keywords: ["/arch:SSE2 compiler option [C++]", "/arch:SSE4.2 compiler option [C++]", "/arch:AVX compiler option [C++]", "/arch:AVX2 compiler option [C++]", "/arch:AVX512 compiler option [C++]", "/arch:AVX10.1 compiler option [C++]"] +ms.date: 10/21/2025 +f1_keywords: ["/arch:SSE2", "/arch:SSE4.2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1", /arch:AVX10.2"] +helpviewer_keywords: ["/arch:SSE2 compiler option [C++]", "/arch:SSE4.2 compiler option [C++]", "/arch:AVX compiler option [C++]", "/arch:AVX2 compiler option [C++]", "/arch:AVX512 compiler option [C++]", "/arch:AVX10.1 compiler option [C++]", "/arch:AVX10.2 compiler option [C++]"] --- # `/arch` (x64) @@ -11,7 +11,7 @@ Specifies the architecture for code generation on x64. These switches apply to t ## Syntax -> **`/arch:`**\[**`SSE2`**|**`SSE4.2`**|**`AVX`**|**`AVX2`**|**`AVX512`**|**`AVX10.1`**] +> **`/arch:`**\[**`SSE2`**|**`SSE4.2`**|**`AVX`**|**`AVX2`**|**`AVX512`**|**`AVX10.1`**|**`AVX10.2`**] ## Arguments @@ -33,6 +33,9 @@ Enables Intel Advanced Vector Extensions 512. **`/arch:AVX10.1`**\ Enables Intel Advanced Vector Extensions 10 version 1. +**`/arch:AVX10.2`**\ +Enables Intel Advanced Vector Extensions 10 version 2. + ## Remarks The **`/arch`** option enables the use of certain instruction set extensions, particularly for vector calculation, available in processors from Intel and AMD. In general, more recently introduced processors may support extensions beyond the ones supported by older processors, although you should consult the documentation for a particular processor or test for instruction set extension support using [`__cpuid`](../../intrinsics/cpuid-cpuidex.md) before executing code using an instruction set extension. You can also use the [`__check_isa_support`](../../intrinsics/check-isa-arch-support.md) intrinsic to check for more frequently used CPU features. @@ -51,7 +54,10 @@ The processor extensions have the following characteristics: - **`AVX-512`** introduced another instruction encoding form that allows 512-bit vectors, masking, embedded rounding/broadcast, and new instructions. The default vector length for **`AVX-512`** is 512 bits and can be changed to 256 bits using the [`/vlen`](vlen.md) flag. -- **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. +- **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. This option was introduced in Visual Studio 2022 17.13. + +- **`AVX10.2`** expands the instruction set introduced in `AVX10.1`. The default vector length for **`AVX10.2`** is 256 bits and can be increased to 512 bits using the [`/vlen`](vlen.md) flag. +`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html) The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because their data types aren’t supported by MSVC. This compiler option was introduced in Visual Studio 2026. Each **`/arch`** option may also enable the use of other non-vector instructions that are associated with that option. An example is the use of certain BMI instructions when **`/arch:AVX2`** is specified. diff --git a/docs/build/reference/arch-x86.md b/docs/build/reference/arch-x86.md index cb71ce0716b..d03ab298b42 100644 --- a/docs/build/reference/arch-x86.md +++ b/docs/build/reference/arch-x86.md @@ -1,9 +1,9 @@ --- description: "Learn more about: /arch (x86)" title: "/arch (x86)" -ms.date: 06/30/2022 -f1_keywords: ["/arch:IA32", "/arch:SSE", "/arch:SSE2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1"] -helpviewer_keywords: ["/arch:IA32 compiler option [C++]", "/arch:SSE compiler option [C++]", "/arch:SSE2 compiler option [C++]", "/arch:AVX compiler option [C++]", "/arch:AVX2 compiler option [C++]", "/arch:AVX512 compiler option [C++]", "/arch:AVX10.1 compiler option [C++]"] +ms.date: 10/21/2025 +f1_keywords: ["/arch:IA32", "/arch:SSE", "/arch:SSE2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1", /arch:AVX10.2"] +helpviewer_keywords: ["/arch:IA32 compiler option [C++]", "/arch:SSE compiler option [C++]", "/arch:SSE2 compiler option [C++]", "/arch:AVX compiler option [C++]", "/arch:AVX2 compiler option [C++]", "/arch:AVX512 compiler option [C++]", "/arch:AVX10.1 compiler option [C++]", "/arch:AVX10.2 compiler option [C++]"] --- # `/arch` (x86) @@ -11,7 +11,7 @@ Specifies the architecture for code generation on x86. These switches apply to t ## Syntax -> **`/arch:`**\[**`IA32`**|**`SSE`**|**`SSE2`**|**`AVX`**|**`AVX2`**|**`AVX512`**|**`AVX10.1`**] +> **`/arch:`**\[**`IA32`**|**`SSE`**|**`SSE2`**|**`AVX`**|**`AVX2`**|**`AVX512`**|**`AVX10.1`**|**`AVX10.2`**] ## Arguments @@ -36,6 +36,9 @@ Enables Intel Advanced Vector Extensions 512. **`/arch:AVX10.1`**\ Enables Intel Advanced Vector Extensions 10 version 1. +**`/arch:AVX10.2`**\ +Enables Intel Advanced Vector Extensions 10 version 2. + ## Remarks The **`/arch`** option enables or disables the use of certain instruction set extensions, particularly for vector calculation, available in processors from Intel and AMD. In general, more recently introduced processors may support extensions beyond the ones supported by older processors. You should consult the documentation for a particular processor or test for instruction set extension support using [`__cpuid`](../../intrinsics/cpuid-cpuidex.md) before executing code using an instruction set extension. You can also use the [`__check_isa_support`](../../intrinsics/check-isa-arch-support.md) intrinsic to check for more frequently used CPU features. @@ -56,7 +59,10 @@ The **`/arch`** options refer to instruction set extensions with the following c - **`AVX512`** introduced another instruction encoding form that allows 512-bit vectors, masking, embedded rounding/broadcast, and new instructions. The default vector length for **`AVX512`** is 512 bits and can be changed to 256 bits using the [`/vlen`](vlen.md) flag. -- **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. +- **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. This option was introduced in Visual Studio 2022 17.13. + +- **`AVX10.2`** expands the instruction set introduced in `AVX10.1`. The default vector length for **`AVX10.2`** is 256 bits and can be increased to 512 bits using the [`/vlen`](vlen.md) flag. +`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html) The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because their data types aren’t supported by MSVC. This compiler option was introduced in Visual Studio 2026. The optimizer chooses when and how to use vector instructions depending on which **`/arch`** is specified. Scalar floating-point computations are usually performed with SSE or AVX instructions when available. Some calling conventions specify passing floating-point arguments on the x87 stack, and as a result, your code may use a mixture of both x87 and SSE/AVX instructions for floating-point computations. Integer vector instructions can also be used for some 64-bit integer operations when available. diff --git a/docs/build/reference/vlen.md b/docs/build/reference/vlen.md index 6557c219ef9..cc9030c1b32 100644 --- a/docs/build/reference/vlen.md +++ b/docs/build/reference/vlen.md @@ -9,6 +9,7 @@ helpviewer_keywords: ["specify vector length", "-vlen compiler option [C++]", "v Specifies the vector length for code generation on x86 and x64. For more information about **`/arch`** for x86 and x64, see [`/arch` (x86)](arch-x86.md) and [`/arch` (x64)](arch-x64.md). + ## Syntax > **`/vlen=`**\[**`256`**|**`512`**] @@ -28,14 +29,16 @@ Specify the default vector length for the selected **`/arch`** setting. ## Remarks -If a specific **`/vlen`** value isn't specified, the default vector length depends on the **`/arch`** flag setting. The **`/vlen`** flag can override the default vector length specified by **`/arch:AVX512`** or **`/arch:AVX10.1`** flag. For example: +This compiler option was introduced in Visual Studio 2022 17.13. + +If a specific **`/vlen`** value isn't specified, the default vector length depends on the **`/arch`** compiler option setting. The **`/vlen`** compiler option can override the default vector length specified by **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option. For example: - **`/arch:AVX512 /vlen=256`** overrides the default vector length of 512 bits specified by **`/arch:AVX512`** to be 256 bits. - **`/arch:AVX10.1 /vlen=512`** overrides the default vector length of 256 bits specified by **`/arch:AVX10.1`** to be 512 bits. -When the specified **`/vlen`** value is incompatible with specified **`/arch`** flag, a warning is generated and default vector length for the **`/arch`** setting is used. For example: +When the specified **`/vlen`** value is incompatible with specified **`/arch`** compiler option, a warning is generated and default vector length for the **`/arch`** setting is used. For example: -- **`/arch:AVX2 /vlen=512`** generates a warning because AVX2 doesn't support 512-bit vectors. Vector length of 256 bits is used in this case. +- **`/arch:AVX2 /vlen=512`** generates a warning because AVX2 doesn't support 512-bit vectors. A 256-bit vector length is used in this case. ### To set the `/vlen=256` or `/vlen=512` compiler option in Visual Studio diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index 501dfdd2bed..6eb0a48ee0f 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -69,21 +69,21 @@ MSVC supports other predefined macros: - `__ATOM__` Defined as 1 when the [`/favor:ATOM`](../build/reference/favor-optimize-for-architecture-specifics.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX__` Defined as 1 when the [`/arch:AVX`](../build/reference/arch-x86.md), [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler options are set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX__` Defined as 1 when the [`/arch:AVX`](../build/reference/arch-x86.md), [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md) or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler options are set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX2__` Defined as 1 when the [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX2__` Defined as 1 when the [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512BW__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512BW__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512CD__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512CD__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512DQ__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512DQ__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512F__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512F__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512VL__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512VL__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX10_VER__` Defined as an integer that represents version of AVX10 when the [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX10_VER__` Defined as an integer that represents version of AVX10 when the [`/arch:AVX10.1`](../build/reference/arch-x86.md) or or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. - `_CHAR_UNSIGNED` Defined as 1 if the default **`char`** type is unsigned. This value is defined when the [**`/J`** (Default char type is unsigned)](../build/reference/j-default-char-type-is-unsigned.md) compiler option is set. Otherwise, undefined. @@ -234,10 +234,8 @@ MSVC supports other predefined macros: - `_M_IX86_FP` Defined as an integer literal value that indicates the [`/arch`](../build/reference/arch-arm.md) compiler option that was set, or the default. This macro is always defined when the compilation target is an x86 processor. Otherwise, undefined. When defined, the value is: - 0 if the `/arch:IA32` compiler option was set. - - 1 if the `/arch:SSE` compiler option was set. - - - 2 if the `/arch:SSE2`, `/arch:AVX`, `/arch:AVX2`, `/arch:AVX512` or `/arch:AVX10.1` compiler option was set. This value is the default if an `/arch` compiler option wasn't specified. When `/arch:AVX` is specified, the macro `__AVX__` is also defined. When `/arch:AVX2` is specified, both `__AVX__` and `__AVX2__` are also defined. When `/arch:AVX512` is specified, `__AVX__`, `__AVX2__`, `__AVX512BW__`, `__AVX512CD__`, `__AVX512DQ__`, `__AVX512F__`, and `__AVX512VL__` are also defined. When `/arch:AVX10.1` is specified, `__AVX__`, `__AVX2__`, `__AVX512BW__`, `__AVX512CD__`, `__AVX512DQ__`, `__AVX512F__`, `__AVX512VL__` and `__AVX10_VER__` are also defined. + - 2 if the `/arch:SSE2`, `/arch:AVX`, `/arch:AVX2`, `/arch:AVX512`, `/arch:AVX10.1`, or `/arch:AVX10.2` compiler option was set. This value is the default if an `/arch` compiler option wasn't specified. When `/arch:AVX` is specified, the macro `__AVX__` is also defined. When `/arch:AVX2` is specified, both `__AVX__` and `__AVX2__` are also defined. When `/arch:AVX512` is specified, `__AVX__`, `__AVX2__`, `__AVX512BW__`, `__AVX512CD__`, `__AVX512DQ__`, `__AVX512F__`, and `__AVX512VL__` are also defined. When `/arch:AVX10.1` or `/arch:AVX10.2` is specified, `__AVX__`, `__AVX2__`, `__AVX512BW__`, `__AVX512CD__`, `__AVX512DQ__`, `__AVX512F__`, `__AVX512VL__` and `__AVX10_VER__` are also defined. - For more information, see [**`/arch`** (x86)](../build/reference/arch-x86.md). From 5a75b32f751dea47441617305f7f6baaeff3ba05 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 21 Oct 2025 16:07:46 -0700 Subject: [PATCH 1377/1799] typo --- docs/build/reference/arch-x64.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/build/reference/arch-x64.md b/docs/build/reference/arch-x64.md index 625ee1411f8..d720f0ecb98 100644 --- a/docs/build/reference/arch-x64.md +++ b/docs/build/reference/arch-x64.md @@ -2,7 +2,7 @@ description: "Learn more about: /arch (x64)" title: "/arch (x64)" ms.date: 10/21/2025 -f1_keywords: ["/arch:SSE2", "/arch:SSE4.2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1", /arch:AVX10.2"] +f1_keywords: ["/arch:SSE2", "/arch:SSE4.2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1", "/arch:AVX10.2"] helpviewer_keywords: ["/arch:SSE2 compiler option [C++]", "/arch:SSE4.2 compiler option [C++]", "/arch:AVX compiler option [C++]", "/arch:AVX2 compiler option [C++]", "/arch:AVX512 compiler option [C++]", "/arch:AVX10.1 compiler option [C++]", "/arch:AVX10.2 compiler option [C++]"] --- # `/arch` (x64) @@ -61,13 +61,13 @@ The processor extensions have the following characteristics: Each **`/arch`** option may also enable the use of other non-vector instructions that are associated with that option. An example is the use of certain BMI instructions when **`/arch:AVX2`** is specified. -The `__AVX__` preprocessor symbol is defined when the **`/arch:AVX`**, **`/arch:AVX2`**, **`/arch:AVX512`**, or **`/arch:AVX10.1`** compiler option is specified. -The `__AVX2__` preprocessor symbol is defined when the **`/arch:AVX2`**, **`/arch:AVX512`**, or **`/arch:AVX10.1`** compiler option is specified. -The `__AVX512F__`, `__AVX512CD__`, `__AVX512BW__`, `__AVX512DQ__`, and `__AVX512VL__` preprocessor symbols are defined when the **`/arch:AVX512`**, or **`/arch:AVX10.1`** compiler option is specified. -The `__AVX10_VER__` preprocessor symbol is defined when the **`/arch:AVX10.1`** compiler option is specified. It indicates the AVX10 version the compiler is targeting. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md). +The `__AVX__` preprocessor symbol is defined when the **`/arch:AVX`**, **`/arch:AVX2`**, **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option is specified. +The `__AVX2__` preprocessor symbol is defined when the **`/arch:AVX2`**, **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option is specified. +The `__AVX512F__`, `__AVX512CD__`, `__AVX512BW__`, `__AVX512DQ__`, and `__AVX512VL__` preprocessor symbols are defined when the **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option is specified. +The `__AVX10_VER__` preprocessor symbol is defined when the **`/arch:AVX10.1`** or **`/arch:AVX10.2`** compiler option is specified. It indicates the AVX10 version the compiler is targeting. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md). The **`/arch:AVX2`** option was introduced in Visual Studio 2013 Update 2, version 12.0.34567.1. Limited support for **`/arch:AVX512`** was added in Visual Studio 2017, and expanded in Visual Studio 2019. -Support for **`/arch:AVX10.1`** was added in Visual Studio 2022. +Support for **`/arch:AVX10.1`** was added in Visual Studio 2022. Support for **`/arch:AVX10.2`** was added in Visual Studio 2026. ### To set the `/arch` compiler option in Visual Studio From b2a72acc0167593a6e62e89cb033878021812a37 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 21 Oct 2025 16:42:59 -0700 Subject: [PATCH 1378/1799] Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/cpp/tutorial-import-stl-named-module.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/tutorial-import-stl-named-module.md b/docs/cpp/tutorial-import-stl-named-module.md index f90f02c7ff7..717ad7e3d43 100644 --- a/docs/cpp/tutorial-import-stl-named-module.md +++ b/docs/cpp/tutorial-import-stl-named-module.md @@ -1,6 +1,6 @@ --- title: "Tutorial: Import the standard library (STL) using modules from the command line (C++)" -description: "Learn how to import the C++ standard library (STL) using modules from the command line" +description: "Learn how to import the C++ standard library (STL) using modules from the command line." ms.date: 01/29/2024 ms.topic: "tutorial" author: "tylermsft" From f63fe29c28fd6246a8071831b31135178aee86b1 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 21 Oct 2025 18:23:32 -0700 Subject: [PATCH 1379/1799] edit --- docs/build/reference/arch-x64.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/arch-x64.md b/docs/build/reference/arch-x64.md index d720f0ecb98..6f9e2f857ba 100644 --- a/docs/build/reference/arch-x64.md +++ b/docs/build/reference/arch-x64.md @@ -57,7 +57,7 @@ The processor extensions have the following characteristics: - **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. This option was introduced in Visual Studio 2022 17.13. - **`AVX10.2`** expands the instruction set introduced in `AVX10.1`. The default vector length for **`AVX10.2`** is 256 bits and can be increased to 512 bits using the [`/vlen`](vlen.md) flag. -`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html) The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because their data types aren’t supported by MSVC. This compiler option was introduced in Visual Studio 2026. +`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html). The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because their data types aren’t supported by MSVC. This compiler option was introduced in Visual Studio 2026. Each **`/arch`** option may also enable the use of other non-vector instructions that are associated with that option. An example is the use of certain BMI instructions when **`/arch:AVX2`** is specified. From 1a38410889152df1dda6fddf6ff1d2911ea556f8 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 21 Oct 2025 18:33:15 -0700 Subject: [PATCH 1380/1799] remove other files --- docs/overview/toc.yml | 4 +- docs/overview/what-s-new-for-msvc.md | 38 ------------------- ...t-s-new-for-visual-cpp-in-visual-studio.md | 10 +---- 3 files changed, 2 insertions(+), 50 deletions(-) delete mode 100644 docs/overview/what-s-new-for-msvc.md diff --git a/docs/overview/toc.yml b/docs/overview/toc.yml index 792c8638e27..66d418921eb 100644 --- a/docs/overview/toc.yml +++ b/docs/overview/toc.yml @@ -6,9 +6,7 @@ items: href: ../overview/visual-cpp-in-visual-studio.md - name: Overview of C++ development in Visual Studio href: ../overview/overview-of-cpp-development.md - - name: What's new for MSVC - href: ../overview/what-s-new-for-msvc.md - - name: What's new for C++ in Visual Studio + - name: What's new for C++ in Visual Studio 2022 href: ../overview/what-s-new-for-visual-cpp-in-visual-studio.md - name: What's new for C++ in Visual Studio 2019 href: ../overview/what-s-new-for-cpp-2019.md diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md deleted file mode 100644 index bd24a7c88a3..00000000000 --- a/docs/overview/what-s-new-for-msvc.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: "What's new for MSVC" -description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 10/09/2025 -ms.service: "visual-cpp" -ms.subservice: "compiler" -ms.custom: intro-whats-new ---- - -# What's new for MSVC - -Version x.y.z. brings many updates and fixes to the Microsoft C++ compiler and tools. - -- For more information on what's new in all of Visual Studio, see [What's new in Visual Studio 2022](/visualstudio/ide/whats-new-visual-studio-2022). -- For information about version build dates, see [Visual Studio 2022 Release History](/visualstudio/releases/2022/release-history). - -## What's new for MSVC version x.y - -*Released November 2025* - -| For more information about | See | -|---|---| -| What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.14](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-14/) | -| Standard Library (STL) merged C++26 and C++23 features, Language Working Group (CWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.14](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1714) | -| C++ language updates | [C++ Language Updates in MSVC in Visual Studio 2022 17.14](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-in-visual-studio-2022-17-14/) | -| C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.14](cpp-conformance-improvements.md#improvements_1714) | - -A quick highlight of some of the new features: - -TBD - -## Feedback and suggestions - -We'd love to hear from you! You can [Report a Problem or Suggest a Feature](/visualstudio/ide/how-to-report-a-problem-with-visual-studio) by using the Send Feedback icon in the upper right-hand corner of either the installer or the Visual Studio IDE, or from **Help** > **Send Feedback**. You can track your issues by using [Visual Studio Developer Community](https://developercommunity.visualstudio.com/), where you add comments or find solutions. You can also get free installation help through our [Live Chat support](https://visualstudio.microsoft.com/vs/support/#talktous). - -## Blogs - -Take advantage of the insights and recommendations available in the [Microsoft Developer Blogs](https://devblogs.microsoft.com/) site to stay up to date on all new releases. The blogs include deep dive posts on a broad range of features. The [C++ Team Blog](https://devblogs.microsoft.com/cppblog) and the [Visual Studio Blog](https://devblogs.microsoft.com/visualstudio) are of particular interest. \ No newline at end of file diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index 68de088af23..4f546d1d8c0 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -1,21 +1,13 @@ --- title: "What's new for C++ in Visual Studio" description: "The new features and fixes in the Microsoft C/C++ compiler and tools in Visual Studio." -ms.date: 10/09/2025 +ms.date: 05/13/2025 ms.service: "visual-cpp" ms.subservice: "ide" ms.custom: intro-whats-new ai-usage: ai-assisted --- -# What's new for C++ in Visual Studio - -MSVC now ships on its own cadence, independent of Visual Studio. For the latest updates to MSVC, see [What's new for MSVC](/cpp/overview/what-s-new-for-msvc.md). - -# What's new for C++ in Visual Studio 2026 - -VS 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2, which have stopped receiving security updates. - # What's new for C++ in Visual Studio 2022 Visual Studio 2022 brings many updates and fixes to the Microsoft C++ compiler and tools. The Visual Studio IDE also offers significant improvements in performance and productivity, and now runs natively as a 64-bit application. From a639ee46f5ec34455b8d8d5c1e6dd5f0bc07451f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 21 Oct 2025 18:43:03 -0700 Subject: [PATCH 1381/1799] acrolinx --- docs/build/reference/arch-x64.md | 4 ++-- docs/build/reference/arch-x86.md | 4 ++-- docs/build/reference/vlen.md | 4 ++-- docs/preprocessor/predefined-macros.md | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/build/reference/arch-x64.md b/docs/build/reference/arch-x64.md index 6f9e2f857ba..696f055f190 100644 --- a/docs/build/reference/arch-x64.md +++ b/docs/build/reference/arch-x64.md @@ -57,9 +57,9 @@ The processor extensions have the following characteristics: - **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. This option was introduced in Visual Studio 2022 17.13. - **`AVX10.2`** expands the instruction set introduced in `AVX10.1`. The default vector length for **`AVX10.2`** is 256 bits and can be increased to 512 bits using the [`/vlen`](vlen.md) flag. -`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html). The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because their data types aren’t supported by MSVC. This compiler option was introduced in Visual Studio 2026. +`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html). The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because MSVC doesn't support their data types. This compiler option was introduced in Visual Studio 2026. -Each **`/arch`** option may also enable the use of other non-vector instructions that are associated with that option. An example is the use of certain BMI instructions when **`/arch:AVX2`** is specified. +Each **`/arch`** option may also enable the use of other nonvector instructions that are associated with that option. An example is the use of certain BMI instructions when **`/arch:AVX2`** is specified. The `__AVX__` preprocessor symbol is defined when the **`/arch:AVX`**, **`/arch:AVX2`**, **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option is specified. The `__AVX2__` preprocessor symbol is defined when the **`/arch:AVX2`**, **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option is specified. diff --git a/docs/build/reference/arch-x86.md b/docs/build/reference/arch-x86.md index d03ab298b42..a133eda92db 100644 --- a/docs/build/reference/arch-x86.md +++ b/docs/build/reference/arch-x86.md @@ -62,11 +62,11 @@ The **`/arch`** options refer to instruction set extensions with the following c - **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. This option was introduced in Visual Studio 2022 17.13. - **`AVX10.2`** expands the instruction set introduced in `AVX10.1`. The default vector length for **`AVX10.2`** is 256 bits and can be increased to 512 bits using the [`/vlen`](vlen.md) flag. -`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html) The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because their data types aren’t supported by MSVC. This compiler option was introduced in Visual Studio 2026. +`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html) The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because MSVC doesn't support their data types. This compiler option was introduced in Visual Studio 2026. The optimizer chooses when and how to use vector instructions depending on which **`/arch`** is specified. Scalar floating-point computations are usually performed with SSE or AVX instructions when available. Some calling conventions specify passing floating-point arguments on the x87 stack, and as a result, your code may use a mixture of both x87 and SSE/AVX instructions for floating-point computations. Integer vector instructions can also be used for some 64-bit integer operations when available. -In addition to the vector and floating-point scalar instructions, each **`/arch`** option may also enable the use of other non-vector instructions that are associated with that option. An example is the CMOVcc instruction family that first appeared on the Intel Pentium Pro processors. Because SSE instructions were introduced with the subsequent Intel Pentium III processor, CMOVcc instructions may be generated except when **`/arch:IA32`** is specified. +In addition to the vector and floating-point scalar instructions, each **`/arch`** option may also enable the use of other nonvector instructions that are associated with that option. An example is the CMOVcc instruction family that first appeared on the Intel Pentium Pro processors. Because SSE instructions were introduced with the subsequent Intel Pentium III processor, CMOVcc instructions may be generated except when **`/arch:IA32`** is specified. Floating-point operations are normally rounded to double-precision (64-bit) in x87 code, but you can use `_controlfp` to modify the FP control word, including setting the precision control to extended precision (80-bit) or single-precision (32-bit). For more information, see [`_control87`, `_controlfp`, `__control87_2`](../../c-runtime-library/reference/control87-controlfp-control87-2.md). SSE and AVX have separate single-precision and double-precision instructions for each operation, so there's no equivalent for SSE/AVX code. It can change how results are rounded when the result of a floating-point operation is used directly in further calculation instead of assigning it to a user variable. Consider the following operations: diff --git a/docs/build/reference/vlen.md b/docs/build/reference/vlen.md index cc9030c1b32..fbc7abdf60e 100644 --- a/docs/build/reference/vlen.md +++ b/docs/build/reference/vlen.md @@ -19,10 +19,10 @@ Specifies the vector length for code generation on x86 and x64. For more informa ## Arguments **`/vlen=256`**\ -Specify a vector length of 256 bits for auto-vectorization and other optimizations. +Specify a vector length of 256 bits for autovectorization and other optimizations. **`/vlen=512`**\ -Specify a vector length of 512 bits for auto-vectorization and other optimizations. +Specify a vector length of 512 bits for autovectorization and other optimizations. **`/vlen`**\ Specify the default vector length for the selected **`/arch`** setting. diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index 6eb0a48ee0f..f7a79ba86cc 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -69,7 +69,7 @@ MSVC supports other predefined macros: - `__ATOM__` Defined as 1 when the [`/favor:ATOM`](../build/reference/favor-optimize-for-architecture-specifics.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX__` Defined as 1 when the [`/arch:AVX`](../build/reference/arch-x86.md), [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md) or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler options are set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX__` Defined as 1 when the [`/arch:AVX`](../build/reference/arch-x86.md), [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler options are set and the compiler target is x86 or x64. Otherwise, undefined. - `__AVX2__` Defined as 1 when the [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. @@ -179,7 +179,7 @@ MSVC supports other predefined macros: - `__FUNCTION__` Defined as a string literal that contains the undecorated name of the enclosing function. The macro is defined only within a function. The `__FUNCTION__` macro isn't expanded if you use the [`/EP`](../build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md) or [`/P`](../build/reference/p-preprocess-to-a-file.md) compiler option. For an example of usage, see the `__FUNCDNAME__` macro. -- `_INTEGRAL_MAX_BITS` Defined as the integer literal value 64, the maximum size (in bits) for a non-vector integral type. This macro is always defined. +- `_INTEGRAL_MAX_BITS` Defined as the integer literal value 64, the maximum size (in bits) for a nonvector integral type. This macro is always defined. ```cpp // integral_max_bits.cpp From 5f93c02555eedba6b8a24e250f0fbfddd5220d56 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 21 Oct 2025 19:16:18 -0700 Subject: [PATCH 1382/1799] review --- .../supported-platforms-visual-cpp.md | 49 +++++++++++-------- 1 file changed, 28 insertions(+), 21 deletions(-) diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 17c444bd70b..5fd557438e2 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -1,7 +1,7 @@ --- description: "Learn more about: Supported Platforms (Visual C++)" title: "Supported Platforms (Visual C++)" -ms.date: 10/17/2025 +ms.date: 10/21/2025 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] @@ -10,36 +10,43 @@ helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] Apps built by using Visual Studio can be targeted to various platforms. +Support for targeting 32-bit ARM was permanently removed in VS 2026 18.0. + ## Visual Studio target OS and architecture support -| Operating System | x86 | x64 | ARM | ARM64a | -|--|--|--|--|--| -| Windows XP b | X | X | | | -| Windows Vista | X | X | | | -| Windows 7 | Xe | Xe | | | -| Windows 8 | Xe | Xe | Xe | | -| Windows 8.1 | Xe | Xe | Xe | | -| Windows 10 | X | X | X | X | -| Windows 11 | X | X | X | X | -| Windows Server 2003 b | X | X | | | -| Windows Server 2008 R2 | Xe | Xe | | | -| Windows Server 2012 R2 | Xe | Xe | | | -| Windows Server 2016 | X | X | | | -| Windows Server 2019 | X | X | | | -| Windows Server 2022 | X | X | | | -| Android c | X | X | X | X | -| iOS c | X | X | X | X | -| Linux d | X | X | X | X | +| Operating System | x86 | x64 | ARM64a | +|--|--|--|--| +| Windows XP b | X | X | | +| Windows Vistaf | X | X | | +| Windows 7e | X | X | | +| Windows 8e | X | X | | +| Windows 8.1e | X | X | | +| Windows 10 | X | X | X | +| Windows 11 | X | X | X | +| Windows Server 2003 b | X | X | | +| Windows Server 2008e | X | X | | +| Windows Server 2008 R2e | X | X | | +| Windows Server 2012e | X | X | | +| Windows Server 2012 R2e | X | X | | +| Windows Server 2016 | X | X | | +| Windows Server 2019 | X | X | | +| Windows Server 2022 | X | X | | +| Windows Server 2025 | X | X | | +| Android c | X | X | X | +| iOS c | X | X | X | +| Linux d | X | X | X | a ARM64 support is available in Visual Studio 2017 and later. -b You can use the Windows XP platform toolsets included in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012 Update 1 to build Windows XP and Windows Server 2003 projects. For information on how to use these platform toolsets, see [Configuring Programs for Windows XP](../build/configuring-programs-for-windows-xp.md). For more information on changing the platform toolset, see [How to: Modify the Target Framework and Platform Toolset](../build/how-to-modify-the-target-framework-and-platform-toolset.md). +b Visual Studio no longer supports targeting Windows XP. If you must target Windows XP, use the Windows XP platform toolsets included in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012 Update 1 to build Windows XP and Windows Server 2003 projects. c You can install the **Mobile development with C++** workload in the installer for Visual Studio 2017 and later. In Visual Studio 2015 setup, choose the optional **Visual C++ for Cross Platform Mobile Development** component to target iOS or Android platforms. For instructions, see [Install Visual C++ for Cross-Platform Mobile Development](/visualstudio/cross-platform/install-visual-cpp-for-cross-platform-mobile-development). To build iOS code, you must have a Mac computer and meet other requirements. For a list of prerequisites and installation instructions, see [Install And Configure Tools to Build using iOS](/visualstudio/cross-platform/install-and-configure-tools-to-build-using-ios). You can build x86 or ARM code to match the target hardware. Use x86 configurations to build for some Android devices. Use ARM configurations to build for iOS devices and most Android devices. d You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. -e Visual Studio 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2. Visual Studio 2026 and later target Windows 10 or later and Windows Server 2016 or later. +e Visual Studio 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008/2008 R2/2012/2012 R2. Visual Studio 2026 and later target Windows 10 or later and Windows Server 2016 or later. + +f Visual Studio 2022 17.0 and later no longer support targeting Windows Vista or Windows Server 2008. For information about how to set the target platform configuration, see [How to: Configure Visual C++ projects to target 64-bit, x64 platforms](../build/how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). From 5edf6e3df0c5f576db92ab389502f136a777da31 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 22 Oct 2025 10:24:14 -0700 Subject: [PATCH 1383/1799] review --- .../supported-platforms-visual-cpp.md | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 5fd557438e2..080b26fe693 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -1,7 +1,7 @@ --- description: "Learn more about: Supported Platforms (Visual C++)" title: "Supported Platforms (Visual C++)" -ms.date: 10/21/2025 +ms.date: 10/22/2025 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] @@ -17,36 +17,36 @@ Support for targeting 32-bit ARM was permanently removed in VS 2026 18.0. | Operating System | x86 | x64 | ARM64a | |--|--|--|--| | Windows XP b | X | X | | -| Windows Vistaf | X | X | | -| Windows 7e | X | X | | -| Windows 8e | X | X | | -| Windows 8.1e | X | X | | +| Windows Vistac | X | X | | +| Windows 7d | X | X | | +| Windows 8d | X | X | | +| Windows 8.1d | X | X | | | Windows 10 | X | X | X | | Windows 11 | X | X | X | | Windows Server 2003 b | X | X | | -| Windows Server 2008e | X | X | | -| Windows Server 2008 R2e | X | X | | -| Windows Server 2012e | X | X | | -| Windows Server 2012 R2e | X | X | | +| Windows Server 2008d | X | X | | +| Windows Server 2008 R2d | X | X | | +| Windows Server 2012d | X | X | | +| Windows Server 2012 R2d | X | X | | | Windows Server 2016 | X | X | | | Windows Server 2019 | X | X | | | Windows Server 2022 | X | X | | | Windows Server 2025 | X | X | | -| Android c | X | X | X | -| iOS c | X | X | X | -| Linux d | X | X | X | +| Android e | X | X | X | +| iOS e | | | X | +| Linux f | X | X | X | a ARM64 support is available in Visual Studio 2017 and later. b Visual Studio no longer supports targeting Windows XP. If you must target Windows XP, use the Windows XP platform toolsets included in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012 Update 1 to build Windows XP and Windows Server 2003 projects. -c You can install the **Mobile development with C++** workload in the installer for Visual Studio 2017 and later. In Visual Studio 2015 setup, choose the optional **Visual C++ for Cross Platform Mobile Development** component to target iOS or Android platforms. For instructions, see [Install Visual C++ for Cross-Platform Mobile Development](/visualstudio/cross-platform/install-visual-cpp-for-cross-platform-mobile-development). To build iOS code, you must have a Mac computer and meet other requirements. For a list of prerequisites and installation instructions, see [Install And Configure Tools to Build using iOS](/visualstudio/cross-platform/install-and-configure-tools-to-build-using-ios). You can build x86 or ARM code to match the target hardware. Use x86 configurations to build for some Android devices. Use ARM configurations to build for iOS devices and most Android devices. +c Visual Studio 2022 17.0 and later no longer support targeting Windows Vista or Windows Server 2008. -d You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. +d Visual Studio 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2. Visual Studio 2026 and later target Windows 10 or later and Windows Server 2016 or later. -e Visual Studio 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008/2008 R2/2012/2012 R2. Visual Studio 2026 and later target Windows 10 or later and Windows Server 2016 or later. +e You can install the **Mobile development with C++** workload in the installer for Visual Studio 2017 and later. In Visual Studio 2015 setup, choose the optional **Visual C++ for Cross Platform Mobile Development** component to target iOS or Android platforms. For instructions, see [Install Visual C++ for Cross-Platform Mobile Development](/visualstudio/cross-platform/install-visual-cpp-for-cross-platform-mobile-development). To build iOS code, you must have a Mac computer and meet other requirements. For a list of prerequisites and installation instructions, see [Install And Configure Tools to Build using iOS](/visualstudio/cross-platform/install-and-configure-tools-to-build-using-ios). You can build x86 or ARM code to match the target hardware. Use x86 configurations to build for some Android devices. Use ARM configurations to build for iOS devices and most Android devices. -f Visual Studio 2022 17.0 and later no longer support targeting Windows Vista or Windows Server 2008. +f You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. For information about how to set the target platform configuration, see [How to: Configure Visual C++ projects to target 64-bit, x64 platforms](../build/how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). From 0da78075479e8517a01bd209237b14365039c407 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 22 Oct 2025 10:28:23 -0700 Subject: [PATCH 1384/1799] Fix duplicate 'or' in AVX10_VER definition --- docs/preprocessor/predefined-macros.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index f7a79ba86cc..f76713d42fa 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -83,7 +83,7 @@ MSVC supports other predefined macros: - `__AVX512VL__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX10_VER__` Defined as an integer that represents version of AVX10 when the [`/arch:AVX10.1`](../build/reference/arch-x86.md) or or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX10_VER__` Defined as an integer that represents version of AVX10 when the [`/arch:AVX10.1`](../build/reference/arch-x86.md) or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. - `_CHAR_UNSIGNED` Defined as 1 if the default **`char`** type is unsigned. This value is defined when the [**`/J`** (Default char type is unsigned)](../build/reference/j-default-char-type-is-unsigned.md) compiler option is set. Otherwise, undefined. From ee1bb71b835213f652c2b0f3f7ebb00d8373622e Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 22 Oct 2025 15:24:57 -0700 Subject: [PATCH 1385/1799] clarify --- docs/overview/supported-platforms-visual-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 080b26fe693..73baebad113 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -38,7 +38,7 @@ Support for targeting 32-bit ARM was permanently removed in VS 2026 18.0. a ARM64 support is available in Visual Studio 2017 and later. -b Visual Studio no longer supports targeting Windows XP. If you must target Windows XP, use the Windows XP platform toolsets included in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012 Update 1 to build Windows XP and Windows Server 2003 projects. +b Visual Studio no longer supports targeting Windows XP or Windows Server 2003. Use the Windows XP platform toolsets included in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012 Update 1 to build Windows XP and Windows Server 2003 projects. c Visual Studio 2022 17.0 and later no longer support targeting Windows Vista or Windows Server 2008. From 76a4ec23a70e2056ad87c9211c4fec92df1e8e0c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 22 Oct 2025 15:35:59 -0700 Subject: [PATCH 1386/1799] edit --- docs/overview/supported-platforms-visual-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 73baebad113..1e369fd7e73 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -38,7 +38,7 @@ Support for targeting 32-bit ARM was permanently removed in VS 2026 18.0. a ARM64 support is available in Visual Studio 2017 and later. -b Visual Studio no longer supports targeting Windows XP or Windows Server 2003. Use the Windows XP platform toolsets included in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012 Update 1 to build Windows XP and Windows Server 2003 projects. +b Visual Studio no longer supports targeting Windows XP. Use the Windows XP platform toolsets included in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012 Update 1 to build Windows XP and Windows Server 2003 projects. c Visual Studio 2022 17.0 and later no longer support targeting Windows Vista or Windows Server 2008. From b33610859ded8295e5e36b48fefdca2a8c44e42e Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 22 Oct 2025 19:31:50 -0700 Subject: [PATCH 1387/1799] stubs --- .../create-cpp-app-with-github-copilot.md | 190 ++++++++++++++++++ docs/get-started/toc.yml | 2 + 2 files changed, 192 insertions(+) create mode 100644 docs/build/create-cpp-app-with-github-copilot.md diff --git a/docs/build/create-cpp-app-with-github-copilot.md b/docs/build/create-cpp-app-with-github-copilot.md new file mode 100644 index 00000000000..8ad4b6af3ff --- /dev/null +++ b/docs/build/create-cpp-app-with-github-copilot.md @@ -0,0 +1,190 @@ +--- +title: Create a C++ app with Copilot +description: "Learn how to use Copilot to create your first C++ app using Microsoft C++ in Visual Studio." +ms.date: 10/22/2025 +ms.topic: "tutorial" +ms.custom: + - "mvc" + - copilot-scenario-highlight +--- +# Create a C++ app with Copilot + +The usual starting point for a C++ programmer is a "Hello, world!" application that runs on the command line. That's what you create in Visual Studio in this step. + +## Prerequisites + +- The **Desktop development with C++** workload must be installed to make the **Console App (C++)** project type available. If it's not installed, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). + +## Create your project + +Visual Studio uses *projects* to organize the code for an app, and *solutions* to organize your projects. A project contains all the options, configurations, and rules used to build your apps. It manages the relationship between all the project's files and any external files. To create your app, first, create a new project and solution. + +1. In Visual Studio, open the **File** menu and choose **New > Project** to open the **Create a new Project** dialog. Select the **Console App** template that has **C++**, **Windows**, and **Console** tags, and then choose **Next**. + + :::image type="complex" source="media/vs2019-choose-console-app.png" alt-text="Screenshot of the create a new project dialog."::: + The create a new project dialog with the Console App template selected. That template says: Run code in a windows terminal. Prints hello world by default. Has the tags c++, Windows, and Console. + :::image-end::: + + The **Desktop development with C++** workload must be installed for the C++ Console App template to show up. See [Install C++ support in Visual Studio](vscpp-step-0-installation.md) if you haven't already installed it. + +1. In the **Configure your new project** dialog, enter *HelloCopilot* in the **Project name** edit box. Choose **Create** to create the project. + + :::image type="complex" source="media/vs2019-configure-new-project-hello-world.png" alt-text="Screenshot of Configure your new project dialog."::: + The Configure your new project dialog with HelloWorld entered into the Project name field. + :::image-end::: + + Visual Studio creates a new project. It's ready for you to add and edit your source code. By default, the Console App template provides source code for a "Hello World" app, like this: + + :::image type="complex" source="media/vs2019-hello-world-code.png" alt-text="Screenshot of the NEW Hello World project."::: + Shows the new project. The HelloWorld.cpp file is open, showing the default code that is included with this template. That code consists of #include iostream and a main() function that contains the line: std::cout << quote hello world!\n quote; + :::image-end::: + + When the code looks like this in the editor, you're ready to go on to the next step and use Copilot top build an app. + +You can use GitHub Copilot in Visual Studio to help with your C++ development. Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. + +Some benefits of using Copilot when coding in C++: +- Generate entire C++ functions or classes as you type. +- Suggest code completions based on plain-language comments or prompts. +- Get help with complex algorithms, data structures, and standard library usage. +- Learn new APIs and modern C++ patterns through in-context examples. +- Receive context-aware suggestions based on your comments or code. +- Debug errors in your code. +- Simplify and refactor existing code. + +To install GitHub Copilot, see [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states). + +## Use Copilot to create a Conway Life app + + +## Prompting + +Replace the default "Hello, World!" code with a simple implementation of Conway's Game of Life. You can do this by prompting Copilot with comments that describe the functionality you want. Here's an example of how to prompt Copilot to generate the code: + + +```cpp +// Code generated by GitHub Copilot +#include +#include +#include +#include // for _kbhit and _getch + +using namespace std; + +int step = 0; +const int rows = 20; +const int cols = 40; + +void printGrid(int grid[rows][cols]) +{ + cout << "Step: " << step << endl; + for (int i = 0; i < rows; ++i) + { + for (int j = 0; j < cols; ++j) + { + cout << (grid[i][j] ? '*' : ' '); + } + cout << endl; + } +} + +int countNeighbors(int grid[rows][cols], int x, int y) +{ + int count = 0; + for (int i = -1; i <= 1; ++i) + { + for (int j = -1; j <= 1; ++j) + { + if (i == 0 && j == 0) + { + continue; + } + + int ni = x + i; + int nj = y + j; + if (ni >= 0 && ni < rows && nj >= 0 && nj < cols) + { + count += grid[ni][nj]; + } + } + } + return count; +} + +void updateGrid(int grid[rows][cols]) +{ + int newGrid[rows][cols] = { 0 }; + for (int i = 0; i < rows; ++i) + { + for (int j = 0; j < cols; ++j) + { + int neighbors = countNeighbors(grid, i, j); + if (grid[i][j] == 1) + { + newGrid[i][j] = (neighbors < 2 || neighbors > 3) ? 0 : 1; + } + else + { + newGrid[i][j] = (neighbors == 3) ? 1 : 0; + } + } + } + // Copy newGrid back to grid + for (int i = 0; i < rows; ++i) + { + for (int j = 0; j < cols; ++j) + { + grid[i][j] = newGrid[i][j]; + } + } +} + +int main() +{ + int grid[rows][cols] = { 0 }; + + // Initial configuration (a simple glider) + grid[1][2] = 1; + grid[2][3] = 1; + grid[3][1] = 1; + grid[3][2] = 1; + grid[3][3] = 1; + + while (true) + { + if (_kbhit()) // Check if a key has been pressed + { + _getch(); // Consume the key + break; // Exit the loop + } + printGrid(grid); + updateGrid(grid); + std::this_thread::sleep_for(std::chrono::milliseconds(100)); + cout << "\033[H\033[J"; // Clear the screen + step++; + } + + return 0; +} +``` + + +## Next steps + +> [!div class="nextstepaction"] +> [Build and run a C++ project](vscpp-step-2-build.md) + +## Troubleshooting guide + +Come here for solutions to common issues when you create your first C++ project. + +### Create your app project: issues + +The **New Project** dialog should show a **Console App** template that has **C++**, **Windows**, and **Console** tags. If you don't see it, there are two possible causes. It might be filtered out of the list, or it might not be installed. First, check the filter dropdowns at the top of the list of templates. Set them to **C++**, **Windows**, and **Console**. The C++ **Console App** template should appear; otherwise, the **Desktop development with C++** workload isn't installed. + +To install **Desktop development with C++**, you can run the installer right from the **New Project** dialog. Choose the **Install more tools and features** link at the bottom of the template list to start the installer. If the **User Account Control** dialog requests permissions, choose **Yes**. In the installer, make sure the **Desktop development with C++** workload is checked. Then choose **Modify** to update your Visual Studio installation. + +If another project with the same name already exists, choose another name for your project. Or, delete the existing project and try again. To delete an existing project, delete the solution folder (the folder that contains the `helloworld.sln` file) in File Explorer. + +[Go back](#create-your-app-project). + diff --git a/docs/get-started/toc.yml b/docs/get-started/toc.yml index 49961e13203..2944683f36f 100644 --- a/docs/get-started/toc.yml +++ b/docs/get-started/toc.yml @@ -6,6 +6,8 @@ items: href: ../build/vscpp-step-0-installation.md - name: Visual Studio guided tour href: /visualstudio/get-started/visual-studio-ide + - name: Create a C++ app with Copilot + href: ../build/create-cpp-app-with-github-copilot.md - name: Create and edit a C++ console app project href: ../build/vscpp-step-1-create.md - name: Build and run a C++ console app project From f4ca46e7f6fefaa804248625f13eac7a3e05255c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 23 Oct 2025 16:28:06 -0700 Subject: [PATCH 1388/1799] new topic --- .../create-cpp-app-with-github-copilot.md | 190 -------------- docs/build/image.png | Bin 0 -> 27687 bytes docs/build/media/Conway-Life-exe.png | Bin 0 -> 5189 bytes .../github-copilot-fix-warning-accept.png | Bin 0 -> 16661 bytes .../media/github-copilot-fix-warning.png | Bin 0 -> 22327 bytes docs/build/media/github-copilot-open-chat.png | Bin 0 -> 11248 bytes ...e-github-copilot-create-cpp-console-app.md | 247 ++++++++++++++++++ docs/get-started/toc.yml | 4 +- 8 files changed, 249 insertions(+), 192 deletions(-) delete mode 100644 docs/build/create-cpp-app-with-github-copilot.md create mode 100644 docs/build/image.png create mode 100644 docs/build/media/Conway-Life-exe.png create mode 100644 docs/build/media/github-copilot-fix-warning-accept.png create mode 100644 docs/build/media/github-copilot-fix-warning.png create mode 100644 docs/build/media/github-copilot-open-chat.png create mode 100644 docs/build/use-github-copilot-create-cpp-console-app.md diff --git a/docs/build/create-cpp-app-with-github-copilot.md b/docs/build/create-cpp-app-with-github-copilot.md deleted file mode 100644 index 8ad4b6af3ff..00000000000 --- a/docs/build/create-cpp-app-with-github-copilot.md +++ /dev/null @@ -1,190 +0,0 @@ ---- -title: Create a C++ app with Copilot -description: "Learn how to use Copilot to create your first C++ app using Microsoft C++ in Visual Studio." -ms.date: 10/22/2025 -ms.topic: "tutorial" -ms.custom: - - "mvc" - - copilot-scenario-highlight ---- -# Create a C++ app with Copilot - -The usual starting point for a C++ programmer is a "Hello, world!" application that runs on the command line. That's what you create in Visual Studio in this step. - -## Prerequisites - -- The **Desktop development with C++** workload must be installed to make the **Console App (C++)** project type available. If it's not installed, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). - -## Create your project - -Visual Studio uses *projects* to organize the code for an app, and *solutions* to organize your projects. A project contains all the options, configurations, and rules used to build your apps. It manages the relationship between all the project's files and any external files. To create your app, first, create a new project and solution. - -1. In Visual Studio, open the **File** menu and choose **New > Project** to open the **Create a new Project** dialog. Select the **Console App** template that has **C++**, **Windows**, and **Console** tags, and then choose **Next**. - - :::image type="complex" source="media/vs2019-choose-console-app.png" alt-text="Screenshot of the create a new project dialog."::: - The create a new project dialog with the Console App template selected. That template says: Run code in a windows terminal. Prints hello world by default. Has the tags c++, Windows, and Console. - :::image-end::: - - The **Desktop development with C++** workload must be installed for the C++ Console App template to show up. See [Install C++ support in Visual Studio](vscpp-step-0-installation.md) if you haven't already installed it. - -1. In the **Configure your new project** dialog, enter *HelloCopilot* in the **Project name** edit box. Choose **Create** to create the project. - - :::image type="complex" source="media/vs2019-configure-new-project-hello-world.png" alt-text="Screenshot of Configure your new project dialog."::: - The Configure your new project dialog with HelloWorld entered into the Project name field. - :::image-end::: - - Visual Studio creates a new project. It's ready for you to add and edit your source code. By default, the Console App template provides source code for a "Hello World" app, like this: - - :::image type="complex" source="media/vs2019-hello-world-code.png" alt-text="Screenshot of the NEW Hello World project."::: - Shows the new project. The HelloWorld.cpp file is open, showing the default code that is included with this template. That code consists of #include iostream and a main() function that contains the line: std::cout << quote hello world!\n quote; - :::image-end::: - - When the code looks like this in the editor, you're ready to go on to the next step and use Copilot top build an app. - -You can use GitHub Copilot in Visual Studio to help with your C++ development. Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. - -Some benefits of using Copilot when coding in C++: -- Generate entire C++ functions or classes as you type. -- Suggest code completions based on plain-language comments or prompts. -- Get help with complex algorithms, data structures, and standard library usage. -- Learn new APIs and modern C++ patterns through in-context examples. -- Receive context-aware suggestions based on your comments or code. -- Debug errors in your code. -- Simplify and refactor existing code. - -To install GitHub Copilot, see [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states). - -## Use Copilot to create a Conway Life app - - -## Prompting - -Replace the default "Hello, World!" code with a simple implementation of Conway's Game of Life. You can do this by prompting Copilot with comments that describe the functionality you want. Here's an example of how to prompt Copilot to generate the code: - - -```cpp -// Code generated by GitHub Copilot -#include -#include -#include -#include // for _kbhit and _getch - -using namespace std; - -int step = 0; -const int rows = 20; -const int cols = 40; - -void printGrid(int grid[rows][cols]) -{ - cout << "Step: " << step << endl; - for (int i = 0; i < rows; ++i) - { - for (int j = 0; j < cols; ++j) - { - cout << (grid[i][j] ? '*' : ' '); - } - cout << endl; - } -} - -int countNeighbors(int grid[rows][cols], int x, int y) -{ - int count = 0; - for (int i = -1; i <= 1; ++i) - { - for (int j = -1; j <= 1; ++j) - { - if (i == 0 && j == 0) - { - continue; - } - - int ni = x + i; - int nj = y + j; - if (ni >= 0 && ni < rows && nj >= 0 && nj < cols) - { - count += grid[ni][nj]; - } - } - } - return count; -} - -void updateGrid(int grid[rows][cols]) -{ - int newGrid[rows][cols] = { 0 }; - for (int i = 0; i < rows; ++i) - { - for (int j = 0; j < cols; ++j) - { - int neighbors = countNeighbors(grid, i, j); - if (grid[i][j] == 1) - { - newGrid[i][j] = (neighbors < 2 || neighbors > 3) ? 0 : 1; - } - else - { - newGrid[i][j] = (neighbors == 3) ? 1 : 0; - } - } - } - // Copy newGrid back to grid - for (int i = 0; i < rows; ++i) - { - for (int j = 0; j < cols; ++j) - { - grid[i][j] = newGrid[i][j]; - } - } -} - -int main() -{ - int grid[rows][cols] = { 0 }; - - // Initial configuration (a simple glider) - grid[1][2] = 1; - grid[2][3] = 1; - grid[3][1] = 1; - grid[3][2] = 1; - grid[3][3] = 1; - - while (true) - { - if (_kbhit()) // Check if a key has been pressed - { - _getch(); // Consume the key - break; // Exit the loop - } - printGrid(grid); - updateGrid(grid); - std::this_thread::sleep_for(std::chrono::milliseconds(100)); - cout << "\033[H\033[J"; // Clear the screen - step++; - } - - return 0; -} -``` - - -## Next steps - -> [!div class="nextstepaction"] -> [Build and run a C++ project](vscpp-step-2-build.md) - -## Troubleshooting guide - -Come here for solutions to common issues when you create your first C++ project. - -### Create your app project: issues - -The **New Project** dialog should show a **Console App** template that has **C++**, **Windows**, and **Console** tags. If you don't see it, there are two possible causes. It might be filtered out of the list, or it might not be installed. First, check the filter dropdowns at the top of the list of templates. Set them to **C++**, **Windows**, and **Console**. The C++ **Console App** template should appear; otherwise, the **Desktop development with C++** workload isn't installed. - -To install **Desktop development with C++**, you can run the installer right from the **New Project** dialog. Choose the **Install more tools and features** link at the bottom of the template list to start the installer. If the **User Account Control** dialog requests permissions, choose **Yes**. In the installer, make sure the **Desktop development with C++** workload is checked. Then choose **Modify** to update your Visual Studio installation. - -If another project with the same name already exists, choose another name for your project. Or, delete the existing project and try again. To delete an existing project, delete the solution folder (the folder that contains the `helloworld.sln` file) in File Explorer. - -[Go back](#create-your-app-project). - diff --git a/docs/build/image.png b/docs/build/image.png new file mode 100644 index 0000000000000000000000000000000000000000..f892839fa3f9ea0082189b31a12fa82c2e223b3b GIT binary patch literal 27687 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 literal 0 HcmV?d00001 diff --git a/docs/build/media/Conway-Life-exe.png b/docs/build/media/Conway-Life-exe.png new file mode 100644 index 0000000000000000000000000000000000000000..94bad16e7d632701d1446043694e08bc0c931935 GIT binary patch literal 5189 zcmaKwc|6qH|HnVF#*DR?#+GDBmQjYHDArEB? zScnqN7d&HfXYdJ_?-)%qi?DO;cwA(7>w@MX!liP}xRaLeG_Hv9i|`&3u@>eQ*?uF* z+sT$!k$EuRKdbsd<=nQ}Mwy_I#p;9EuQ9XLhBD*zlkK{bpYLbBr^}8u2{g!Lh0ea6 ze=xGn130(3MIPFEJzpYJq<#eebR7HFY8!S&kUjiSoWQGvHg(!&SRZ-m6AlUhE&FRj zUVq}p0f32I?NiLWkt==bBWhvn?dXs{1)8jA$#0j+@u7a@NId1`N;rmA+QLsUaGoa# z1&*9iK5`ekwv59GNZ|AG@*1K1h>Y^`@)%0^w}Ysy%?+HV9KyFB#|eRBmTBAP!Y2<4 zXv@DsFV6-y9HxD)t(>>u;_*0YH2&&3XG&JWfTZvjw|SgKxDka%Dwo#C(a|09_09>% zeL$&5CxLYNQC;ejN20bP8@=HqVMH;h6 z?XU=bKN|9B^2ui1DD|Y&gYY@bh<()$z)DfVDcmoFIdNZr(mJYj(TI~rrPg_qWQ=-w z-!W`od1a-clN`JsclOymUrn6aY0RMv?1_?$gu%Q!7pw|QAzrp5KC)IDgeuo zJ{+_o>rRs;)%kI|`VJ((v-dbPWa?Qyzk9SC8qu>I-sIMtuxm70cHNmM1*=mqPmK{! zuiBj;Ye;^fmKwQSmJRj63=Z-S^6WoOt(tmXaC=%(>IRRzLlCMmM^h?jc4$`wqjm&` z$K%^p3EIOjM=brL@ck9%!XhClI|!Vj&$yVTj|pmcAu{)bKK&_n@M^7EKv0nQvZN}@ zHH|fEX&yqK*gUO_avnZa^~SJa?em=Y6oD(zU==+9UpjhcdTNTlJymVmer{%_D1g}8 z%gK|cbp;aGdUHw_eWjoD#9AxK+qaGsFD|vA50_U%zey5_K3-P=Q+GLablv~4po!Ez z^oP}rxk%aGLc1kAJxad4sTs@oERhwl`a=%7%SNAS*Mbh`}t(_@|Ggw+kVF<0Ns3xLNBH9FEwD8dH8B|y^>dl60XrX=m8&d5Y zxz^aZ_qqb=;3^do4XzBW~l(MwdLr+=Hyfo6Uok+D; z(T@>2GJiD902_u{ThJNK5t-|TsTS8Qwi%qsx05KxYpTuwfmRabTu8{VQ4a(Gf9Ym0Dks`4}9W<@?fwr%`rC^?>5hlKjJHXXm1n5`gWRB9EG1=AY~?bwbgzscwtPc)R#@)?#2ni<&X(U}q0 zxBXGeR7iC5=)ot48ov@p zisZ~n&MiV1jehgGBAzg1Y9OOAn@kaUSE67w+kt_OnaKNeBr2f4>WjWKpV5q18yx99 zzc1$I5yZLsAJv^!d+zf`-naHyO!8ZsskFtL8!)OV=kPZ816Mv^s5cj1h+r@=5UZFP z0eGpOK@asL1m>rknj<1P9ZJs>FG&1C9SWeA|)8ei7LdN3882#%fsrw<8ngJj1@vx}pO3}@+7cRPFt}x`$uUw|C!YUI;%<4}sWHVZ{{ljd$vH zIVU)sci$FA;@f?>p|Gd4o?J*KZKR=LQRe2r1LzmGa=&rYt-G;CZR+}M4~)humB;pD zy?nHylDq2}!}g)-y$1WQ%eQZSL+HaxmE?ylrazSk&CJZ;z`02GwtFuwz0Ye~vZ3%m zEELdhG|88zdy52uhx}rbIIQLIgq1;+1>JPRgX2kU@19p|L|sV9vBAi50Fb!$nmKjx zZ2$z=!370&?=s>9%)XJBH+X=gn>if7UU@VCyyJrdM-PBq9TVXHHfvtO zw|-eZ*Eyy~D`^+b8+dinBgZJW^n;Y*kySIDrK7q5sY1AYYhfmXx%MVayCSfO2wT?9g)qOIc(h@)Jz^mEI%k%y)8yL z#AI5ch6X;P8rx*?U0K73qDg011In}YkGXvp2ltIM9JH7TJ(N(rFxpt5eK*@{9bYfk zu6VAk+08C(wWo~eJu_>J1)P(3M3IkHG`4PMMH7F-3(;{mF8f_IrHP;;*Gs8320Jdy zGEche!w;@4Vd;MeX$W|x3gH)~D`HbIoAo`>h@x-=@-yiXN#AE(Y3>KqXJGX-x_T0W z8gp%U{_{Y2@qnWa<4wv)30LYjjIBiRrQKEz^d>4fUmKYfY2sc#QDbiGSv{GS$P1ih z&I8e=?>o8>Oq_R$X+75V6q>BRy!#$M{kB%XU50r1<`gbMA0};|#pj(kGi9G>l#3lH zklT+fKP`?iQuGc%K7_ZE%vYrkUiDfp>uWy^G2|4P%u3jLt=*WuhEd7(?#bE`=nURm z`D?pD4jzKCU`qM$W-!rpZTXMfBdE3ORD}Q42E7vka7#OJz4lrGll?XZXYcS522dFx zLnkLph^SRMZd@j@r^%@RQeR%wH@_-H2=r?Dnq_P9-ZoW&eIn9wY>MddwzhcK1>2eL zwgyQ#n#;V?O=KDrLP z(yV&4HtRA9yg7<+Z+VY9nH;(s9llkB!;Vqk-IJ({Ig>RkLFyTmT#y&cJW?Ij8f(?; zsCSTchGR;F^t(%r@DQ3Z1pwIN>s$nwu;N^V!9A@jLTV$cHY36&p3IlVK1a5O(D7mrNp4OIhCMysvB4bv-0N`=hhX{(F-vHmK0j_M7YE(NC- zpgG>bBf@#)y2_H-l}?RV)wN{uOwm?|_xHX{mnTMvgZVNcY6;A#$mPuaTAN~7bK9R} zuj~ByWS^_^?j^QqH9~`S*}huW?MWH`UzL;C92f9dmsRG{H7;bZ?)QLoAMO^z4F#Nc zRFA<%ayfu`{BK0u3I$2fx^rn(l}(XEm>vgkn)#G9_wk~Qi4t&Bg$;}ra7s!drJ;b$ z7>{%aKk)cKtvwY0MAO~Ba{*@Vz2V7598t#%M(x2_*=fNiN`(PuWj1tVwF9;RkJ-lj zf>1(9<+i_>L>}e`_U4{oG0QXreb2bdjat$kMn2}HShP$XE7V?RM(I>cG8XMZ_h z`s<@&)`j)2f%F2lu?01$;sP81{>H!gmrXmcYX@NVHTfTxPX%sg1#FM4BQ>CM^{NBKDLI+U}aycUr&fK<_NXuGj9V002qm4um5!MzrMvX#G2zRl{D8 z9K%BFl)XPo!tk>Pa0hFC!9)1Pi z13Y5?k=2fO!pLTI9gPI1GCAbKvZpVgfZ2C9KDf8JXYB1oA~obkCM#G+jdNKRd)Vn< zr_T@r-zF33c?zRHujwK)BTdq(u3DlUs*9{;0W;@KWh{5-``TeCMg3ZZfaRa~u0^83 z8KFAyX8lrmw|+Yu7KoD5x)5zz{G%uzx9@P}IpgLP0>(JCQ~3i2AiArQEoXWa-jEqg zm`VFxdlOH}Cbc5Svz63k>;UY(-YxZC!?G8V5pDXx`m&&%_y)1?tO|S48P@THnX>Dm zu6paNDi;9b2U`jMK529r)(`j8sSj6n>!-21I%QuQ zxmrL(z0TuGM;y;7XP0}~!!TQIh*_trd}2;2vES^>jo0u>O?|O4bGDUCQkn6k&Q*lR zYX{soClJ?}efXMF-^Vm})Z)^EMwT|NrX<$W3aO>o6W>)EdgqkBZv79o z{$#j%#_pTQqK16b=5OHzL?z>lT!-r8n;ulq1TD+Ra7Dug-STxee{}6u7nST4j7}q0 zl{hXj53H$7fb zX{GW|jFrE=JcNZ2dvTUdQ%frM=y^|Gr|JaTJ+T56Es$~BdZ5CvT&@04Kq{uGZ$fgv zVU9S)*lMs!ot5h4!N?1g*S>Aqr{$IxOfOdFHIlh9xZsHv{viWncf7a1-(aY|{#D^ifmx&RG)+T3F?r3=e2TxXyLvNBQYc}}r~ zKeHNHL_a2;@X9Cijjp(ut(uUx*Le7?t~SKGUA4jZyb@K75Bhi83^c9?Sei#V+WFYm zAS}XBPUtkuc^PmSiL0j_%soR01Tfa)I1Jnd|pwgNCpk*TZ ztSB6C@V}}CDj7H1zv5qj0(I@~k45@R5K>^=mOIauq`#VqH&VVNUW#L6NaK{jC-T%XzUrYSH?E4pQwt$8SuSAwJ X=a(3EYx%67{(zImt&SBNJKy*p0g6FD literal 0 HcmV?d00001 diff --git a/docs/build/media/github-copilot-fix-warning-accept.png b/docs/build/media/github-copilot-fix-warning-accept.png new file mode 100644 index 0000000000000000000000000000000000000000..bb8f3ded8765e3cdfdc9b23d5fd86eaf0b05c42d GIT binary patch literal 16661 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 literal 0 HcmV?d00001 diff --git a/docs/build/media/github-copilot-open-chat.png b/docs/build/media/github-copilot-open-chat.png new file mode 100644 index 0000000000000000000000000000000000000000..c89019f9abcc81ebc04b57df1a05b2a6cf47f28f GIT binary patch literal 11248 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 literal 0 HcmV?d00001 diff --git a/docs/build/use-github-copilot-create-cpp-console-app.md b/docs/build/use-github-copilot-create-cpp-console-app.md new file mode 100644 index 00000000000..5cce63448bb --- /dev/null +++ b/docs/build/use-github-copilot-create-cpp-console-app.md @@ -0,0 +1,247 @@ +--- +title: Use GitHub Copilot to create a C++ console application in Visual Studio +description: "Learn how to use GitHub Copilot to create a C++ app using Microsoft C++ in Visual Studio." +ms.date: 10/23/2025 +ms.topic: "tutorial" +ms.custom: + - ai-assisted + - copilot-scenario-highlight +--- + +# Use GitHub Copilot to create a C++ console application in Visual Studio + +This tutorial shows you how to use GitHub Copilot to quickly create a C++ console application in Visual Studio. You'll create a console based version of Conway's Game of Life, a classic cellular automaton. + +Github Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. Some benefits of using Copilot when coding in C++: +- Generate entire C++ functions or classes as you type. +- Suggest code completions based on plain-language comments or prompts. +- Get help with complex algorithms, data structures, and standard library usage. +- Learn new APIs and modern C++ patterns through in-context examples. +- Receive context-aware suggestions based on your comments or code. +- Debug errors in your code. +- Simplify and refactor existing code. + +## Prerequisites + +- Visual Studio 2022 or later with the **Desktop development with C++** workload installed. +- GitHub Copilot subscription and extension enabled in Visual Studio. + +To verify you have the C++ workload installed: +1. Open Visual Studio Installer +1. Select **Modify** next to your Visual Studio installation +1. Ensure **Desktop development with C++** is checked + +:::image type="complex" source="media/vs2019-choose-console-app.png" alt-text="Screenshot of the create a new project dialog."::: +The create a new project dialog with the Console App template selected. That template says: Run code in a windows terminal. Prints hello world by default. Has the tags c++, Windows, and Console. +:::image-end::: + +1. If not installed, select it and Select **Modify** + +- You'll need to install GitHub Copilot and have a GitHub copilot license. For more information, see [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states). + +## Create a project + +1. Open Visual Studio and select **Create a new project**. +1. Search for "Console App" and select the **Console App** template for C++. + +:::image type="complex" source="media/vs2019-choose-console-app.png" alt-text="Screenshot of the create a new project dialog."::: +The create a new project dialog with the Console App template selected. That template says: Run code in a windows terminal. Prints hello world by default. Has the tags c++, Windows, and Console. +:::image-end::: + +1. Select **Next**. +1. Set the project name to **ConwayLife** and choose your desired location. +1. Select **Create**. +1. Once the project opens, locate the `ConwayLife.cpp` file in Solution Explorer. +1. Open `ConwayLife.cpp` and delete all the existing code to start with a clean slate. + +## Use Copilot to create an app + +Now you'll use GitHub Copilot to generate the Conway's Game of Life implementation. + +1. Open the Copilot Chat window by selecting the Copilot icon in the toolbar: + +:::image type="content" source="./media/github-copilot-open-chat.png" alt-text="Screenshot of the Github icon dropdown. Open Chat Window is selected."::: + +1. In the chat window, enter the following prompt: + +``` +Create a C++ console application that implements Conway's Game of Life. The program should: +- Use a 40x20 grid displayed with asterisks (*) for live cells and spaces for dead cells +- Start with a random initial pattern +- Display each generation for 500ms before showing the next +- Allow the user to press any key to exit the program +- Include proper headers and use standard C++ practices +- Clear the console between generations to provide an animation effect +``` + +3. Copilot generates C++ code for Conway's Game of Life. +4. Copy the generated code and paste it into your empty `life.cpp` file. +5. Build the project by pressing **F6** or selecting **Build > Build Solution**. +6. Run the program by pressing **F5** or **Ctrl+F5**. + +> [!NOTE] +> The exact code generated by Copilot may vary slightly from run to run and model to model, but the core functionality should be consistent. If the generated code doesn't compile immediately, you can ask Copilot to fix any compilation errors. GitHub Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot FAQs](https://aka.ms/copilot-general-use-faqs). + +### Example of typical generated code structure + +Your generated code will likely include these components: + +- Headers for console manipulation, random number generation, and timing +- A 2D array or vector to represent the game grid +- Functions to initialize the grid, apply Conway's rules, and display the current state +- A main loop that continues until a key is pressed + +Here is an example of the code that GitHub Copilot generated given the previous prompt: + +```cpp +// Code generated by GitHub Copilot +#include +#include +#include +#include // for _kbhit and _getch + +using namespace std; + +int step = 0; +const int rows = 20; +const int cols = 40; + +void printGrid(int grid[rows][cols]) +{ + cout << "Step: " << step << endl; + for (int i = 0; i < rows; ++i) + { + for (int j = 0; j < cols; ++j) + { + cout << (grid[i][j] ? '*' : ' '); + } + cout << endl; + } +} + +int countNeighbors(int grid[rows][cols], int x, int y) +{ + int count = 0; + for (int i = -1; i <= 1; ++i) + { + for (int j = -1; j <= 1; ++j) + { + if (i == 0 && j == 0) + { + continue; + } + + int ni = x + i; + int nj = y + j; + if (ni >= 0 && ni < rows && nj >= 0 && nj < cols) + { + count += grid[ni][nj]; + } + } + } + return count; +} + +void updateGrid(int grid[rows][cols]) +{ + int newGrid[rows][cols] = { 0 }; + for (int i = 0; i < rows; ++i) + { + for (int j = 0; j < cols; ++j) + { + int neighbors = countNeighbors(grid, i, j); + if (grid[i][j] == 1) + { + newGrid[i][j] = (neighbors < 2 || neighbors > 3) ? 0 : 1; + } + else + { + newGrid[i][j] = (neighbors == 3) ? 1 : 0; + } + } + } + // Copy newGrid back to grid + for (int i = 0; i < rows; ++i) + { + for (int j = 0; j < cols; ++j) + { + grid[i][j] = newGrid[i][j]; + } + } +} + +int main() +{ + int grid[rows][cols] = { 0 }; + + // Initial configuration (a simple glider) + grid[1][2] = 1; + grid[2][3] = 1; + grid[3][1] = 1; + grid[3][2] = 1; + grid[3][3] = 1; + + while (true) + { + if (_kbhit()) // Check if a key has been pressed + { + _getch(); // Consume the key + break; // Exit the loop + } + printGrid(grid); + updateGrid(grid); + std::this_thread::sleep_for(std::chrono::milliseconds(100)); + cout << "\033[H\033[J"; // Clear the screen + step++; + } + + return 0; +} +``` +When you run the application, you should see an animated display of Conway's Game of Life with patterns evolving over time. Press a key to exit the program. + +:::image type="content" source="./media/conway-life-exe.png" alt-text="Screenshot of Conway Life running in a command window, displaying the evolving grid of cells."::: + +In the code example, the code generates a warning: `Return value ignored: '_getch'`. You can ask GitHub Copilot to fix it. Select the code editor and press **Alt+/** (Windows) to open the Copilot chat, then enter: + +:::image type="content" source="./media/github-copilot-fix-warning.png" alt-text="Screenshot of the GitHub Copilot chat window. The text: Fix warning C6031 is in the chat window."::: + +GitHub Copilot will suggest a fix to handle the return value properly. Press Tab to accept the changes: + +:::image type="content" source="./media/github-copilot-fix-warning-accept.png" alt-text="Screenshot of the GitHub Copilot proposed changes. Tab to accept. Alt+Del to discard."::: + +Congratulations! You've successfully used GitHub Copilot to create a fully functional Conway's Game of Life console application in C++. You've learned how to: + +- Craft an effective prompt to generate C++ code +- Use Copilot's chat interface to create an entire application from scratch +- Fix compilation warnings with AI assistance + +## Improve your prompting skills + +For better results with GitHub Copilot, consider these prompting resources: + +- [GitHub Copilot documentation](https://docs.github.com/en/copilot) - Official best practices and tips +- [OpenAI's GPT best practices](https://platform.openai.com/docs/guides/prompt-engineering) - General AI prompting techniques +- [Copilot prompting guide](https://github.blog/2023-06-20-how-to-write-better-prompts-for-github-copilot/) - Specific guidance for code generation + +## Troubleshooting + +### Missing C++ desktop workload +If you can't find the Console App template: +1. Install the **Desktop development with C++** workload through Visual Studio Installer +2. Restart Visual Studio after installation + +### Copilot not responding +- Ensure you have an active GitHub Copilot subscription +- Check that the GitHub Copilot extension is enabled in Visual Studio +- Try signing out and back into your GitHub account in Visual Studio + +### Generated code won't compile +- Ask Copilot to fix specific compilation errors by pasting the error message +- Try refining your prompt to be more specific about C++ standards or requirements +- Ensure all necessary headers are included (Copilot usually handles this automatically) + +## Next steps + +- [GitHub Copilot documentation](https://docs.github.com/en/copilot) - Dive deeper into AI-assisted development +- [Awesome ChatGPT Prompts](https://github.com/f/awesome-chatgpt-prompts) - Community-driven prompting examples for inspiration \ No newline at end of file diff --git a/docs/get-started/toc.yml b/docs/get-started/toc.yml index 2944683f36f..382c539cf83 100644 --- a/docs/get-started/toc.yml +++ b/docs/get-started/toc.yml @@ -6,8 +6,8 @@ items: href: ../build/vscpp-step-0-installation.md - name: Visual Studio guided tour href: /visualstudio/get-started/visual-studio-ide - - name: Create a C++ app with Copilot - href: ../build/create-cpp-app-with-github-copilot.md + - name: Use GitHub Copilot to create a C++ console application in Visual Studio + href: ../build/use-github-copilot-create-cpp-console-app.md - name: Create and edit a C++ console app project href: ../build/vscpp-step-1-create.md - name: Build and run a C++ console app project From f011312104479e01fac3534fcb8886c7c8f4a42a Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 23 Oct 2025 16:49:16 -0700 Subject: [PATCH 1389/1799] formatting --- .../desktop-development-cpp-workload.png | Bin 0 -> 7316 bytes ...e-github-copilot-create-cpp-console-app.md | 38 +++++++++--------- 2 files changed, 18 insertions(+), 20 deletions(-) create mode 100644 docs/build/media/desktop-development-cpp-workload.png diff --git a/docs/build/media/desktop-development-cpp-workload.png b/docs/build/media/desktop-development-cpp-workload.png new file mode 100644 index 0000000000000000000000000000000000000000..a321200feb51a93b0febf1a84503e2e99d000159 GIT binary patch literal 7316 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

-EIr>$2_gy&-?;KK;AamKY|fhmq3tG;ww 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�hG5+LzL};{S!zS3UOeY9 zNg)WKTp_`N*M!o>`)X-#Pwi1q$WTlTYd2S;zA^$MdZiF!o-L6o ziJ)`nNFM5c!N%C8wgyPFsHED^CTV3uPDescR7=Z??OOXY7Lg(tR3Hb)>sJ~Xq17nj zPZ}^Xx}DC1m6BBe`)YJd7vS+@zmPaG`;k`zp|h4ay&9o8>SV-P6gd$MyxurhbYZ$! z>>KFQkje9b1`WPWGO$&G?Y1nZq6@{KJ8uakF z+9PQ49iI!q!x|96+7zg8SWTA{bVYl{cr2z$7+A8CavVdRaZO@gKoKRU=-?3TPUP(>3fXlcfNrNY(Ou+EVE&wZT4naKJV> zh7@mCkVcdd={Mac8>)t+6_j%ds1#?^^cUI^C;8q(R@0H944>6*zNQ858XjJJ0< zc=Z?H;Nu>`bn^yfRgObcW>F+1@>b2OoYHEio=HbX&ZaoCPnYH7%>ffoAaDInhfn%Z zeK@Gh!u{e*cZa9Mi5!&#^ZueUrd1-70=1Pm0gMV=q|b&tqqz zEQm*)6^7udu*5(N*=`B97+7moE4Qt{u$0Z>d1O9n1OpvEQi$X1NS-xJN%g-Om$wfG z(l`lvCwbmTml6qoiYY`C(o$`>JvU{pYwycj6@u-%QNhiW8`Li`t!Ffbq)>-85QKy> z^h}*5Et~JkJHk<*7{tR&;YrY>?l-{>F!ORa;8&iyjowOuX*+83378ZjaS7Wkw#5zdJpH2#T8Q4Ir>UE=Y)g7gM`pT^oIfiW zaMmCbGR&lEGpyC=bOBSC4dHl2Q#&MZ^w8(QP2^#i8!~7c1x0CsLa1mCF%@zbc7z;{ zs?{o~H!T9<%32dsa%Dy-1;awhuqjl*ZGS=z7wJ#M$iJ+;=y0jdOf@}_qp6N5W-=NS zQ)U7=1>hAk7Hz`M4M5or6|o$qq$9*JN|q!;bSkx<4agIeSLu(S!UyCCAy`zWHaKW~ z?464CjX+sjik$jL{E*#|l=$?I9n4aYQK@IdyL^{}mm48ks4X!-B580ze&zG}s81S< z1+d+s?62VBSA7FEkG+Kj&pDD`yt1xn`m$4TUndMK~{Fsnj^BYuLT{nJhq4 zTa^`OaATg7{zKt@I_(M-CieZQ*YwqaNwfJkJ^Gd-pkoa-bU9*W^!X_PFQn}%&(AaMbVV6V|T(* z#S7Ef35LUmaOn%b5SVT^eGfSi6{;^2eAIPzvWy$TRlpeqPPJKv$QOXfPu*-r6#)_Af z#P(>1Y3R#HSsSCx6GNve1FdixR<^-N62e1hyg8d^rvf6p01FI}&UEx>2I&Z`!ygV7 ziM__QX!PyAxG33*wkaI^I3v>{pVZ^r)0v#6CDr;-hn z>X(yFe$Wok4#q+b{)|?2zZliQ;iDW))9icC=4#!m_-wdASJJd6)2=D&wJ`q)-W94~#%yyt{7m>1G8H2cs%>|t8mu{s(>o8ZzyZVkY zpdBCq9!rrbg7=3Y3x6rViS#B)E<$brQpk6Rpfg>Wxk=Q%0Vz4N?K;ibjs_a#P4thD zGh3}`okaprN6m^}%HZ+TT}4A#x#|jR zmkdKsIgr4)75?{Me+JJ!bBxt`(O@?l8hfQVR7Ss6HUX``cDtK!*ZBqhr*C>CzTlA! z#%H$}7h=8ySwx;W8L>}G1e~%bOSod+o-?GJ7~K$`^q;wh!fsn}{^}{d?<-z_pZwOx z@Wi>m?)na+@JKJ8N|8e$9RkD?{|7R)c4>9`Ijfb3@X{O#I%168q*$x~LIwqz>ko7V zX1od~0VycKl$Gz6qDV{W{)$eUuDBS9Pm`t+J)ST#vpw>WQs60vx)hxaT2O|8`!6LO z1{RK++~QLodaJq!8VxDaq@kM)jGv&B+_D#B9*KwLICz9WFvZP|i6c%C_AJ2=JU7Tw zWUxpp+e5nWz{X5w(;OJU(Q^d1K@bno(1-)>z<=}r;6KtC`dfjXtd_GMGg$|n08Gj< zVWv}z*N{pPE;-e1j%>vMde+gs^+vMKn(~_E)I3*L`n#NyF&1I&VyJ?Kq;D$M}H%W!1e<9@rNCWEKW=EtnwQ{G((P0Fk zzKE_i#FS2MbE$ToDpxNcz#V}L6%Q7`Z(KdYKmWyNFbqpEqT8imfDb1%v8XC!wKXn% zw%Z*ZdfqwwFaO1>@#cp&n4a8X7d&VXv!$f~aY$h&TvCftX3CBf_IwNX@m@km6HC$@w{3>EBE)ho7`M(^+Ib*N@5JHT_S!4>z1711a*kG6>G5s0bD|(9*~1fv_Zk*-V8AS`FyD{U*U7;x&bP{t))(!ggaXW}){k>lZ}c#$*RWXDDhV+t1E zM>Du=z%omn&8s2(kTscMGJHuL05;KfAZ(!{7XI#AmbPDjCGSNTq&Dx&5^RzmK{R)7$+4ogd87-mFsS#{W;3>6BxS|qPbm9s6?A19#_G93A_16G+}fMqqoo!-EfP@DKjVr{G&3zYnXA9btd6!=x#; z4wsa)goj5Em`qk$680IXP%Cl(_DJlW-QraT1Ah4HUyeWX#~#6cx5sw7#fx5e7k=QI zJ^`P3Sh2sh<)Q{TT8JWM<2Z<~nR12j>Tw30G%Mv4FY><~-;7LqMggk#nSabN=7&)G z8ZjVz(#aK(0*d0GdIesbl<6ZHZS-98LgPrdD;0nuJvU2UkWvxi>y%Uo&G9hY6jD2X zbY9tgNlqc8#u9{NS7aqEFoJ@p6W#gcC@(vP%rlg({BRZkJPjhv0PqC}O zG!)X`nKOvsX;P5oooYAzN}&Nh%f$A|2{zB1;V-=E9{j|&J%%rM;(qM5J4TfmINR>< z(ifk@55Db{__V{o+07lWT+mtM;Dt{PWWHLXDK<)eN>54^>1FNeJ|zftc1+XxztDS?t zj7h_{j9TLz;Wyo>XqM7>cA#Wv*#~C&OYd2i@nPWf6lMPm?)mcn90!km8OAGDRbynl z3PS>fiyB(%1X+BNnV9CQW6X;a9qt5qAPT328Y}SzQ6L7)v>p()l5{mr8SzV(HIz{I zF$@XugLr1Fm?ocAZ+pS_$P0Ww!SnL`iJ;@*E0kRuMClLj?E<5g-^1flM+s$%G|o&; zN3pqRGUp&7Y&&3{=5#lw-gUBiAxt%?2cRQv2)m5%jE@>F1*T=A1UImpj75_Ue$LUMj)jkLdj7z#v=1d@)1enZcj_lmILJvkumBlc$R zK#ELJmla=_h*DZ9Z5t3L%b=T*{?d$s|3Zg~CZB0bV5zX%hEOp>v|cT)h6fqDAhd@H zorBPPDpx-cZq`R=>7n2ujmaR(DNyfP;&1<}kKn0~o#0@-&|~b>x_PdwssT!ly*orQ zQ~*v+C+w#^zWOaM#7}+ur{W!-_Xr+6*Bv+kCuS|cBf}}>5K2e5B=p=;Wg{T z_SzY8;L`0-O_7C>(G^!nv|5rWRX^2*mCv#RIy^vX)dO)vM1+b%T?=Hk4dKS$`IiVb z?j{Q|mSDQ*sLs4oG0lSBGdMMaY8D4htO3f;e%ZFvr+w?x>9Y5eHQ} zpSp%Z%?Uof9mYfFz?RLZRV#{M<*Y3cB!UsD`3Na|s{+F!CCOq};-7X~4zolIUgg)E zTj@H<2^BR9djm>$hq78JVf4Qg{MvcF2T;A{rG1aNJ_^db6{+ae|7y?>e4%NHBwrFK zGrdz&FlFEM!;Cg>H^ehGq`_smBt#&0XTW$17ryN4aQMkzhI;h|GPR?vc}V;Y)3pMj z2*1`=als*ixQ?U@71iqaUGrNAJ=Ro|9c3(!bV!O9cKK#%L|lkN=>7A#T4semCY5sQ}tdn zn97PJ`N49}U^ZI481 zzQf=9Cw~Bx0gC}Nzyzl?%0H=kk2!|yDMMqU6Elv9?RJMpUvP+b{rOM8|MiYf#dp5p zdHAfm3hq5Q!*t^eyK86I9__Kcy~p<@n@zSVx>nrcU zKl=+W$B+EAPsSTR=RRbP*q)AnPX7ja3NkU^>~zG-UwRLI;9DNUt5=D$n`emSqVo?S z=a*)Wq-fg(`s@Kk8DcTli~|%RsQbA?4b)zhK3}9**X>D^8(q?{HaDJ9c@zB zSlhMP>2HYEwb4Saf(DEZ8D@i(p4aL;B>P4%L*m*m%SnSoiaz9cH_4vMPfNqMCfSCJ zA1bo~cIq;PKl7527NiLkl^j$rfj3T7Sf4P?q=Sp7nh zH#1c?#zwnA7D6Hni!ZC9Pk6CTXfGuBsk%Qo2>cH6YhxGEo2JZqzSE7o;68}oP@qFp z5^>_7-edr0H*VwL6`zd@FMl!e& ze$1cgmjGQ0dUn!YQcg~@b;7onX^qsbm6kYV#_asAzA;mZ4epKrQHt-5JH(|&FueHn zz}YD%s%)2@Ar)@|h~oZ1V`z^SBD{=f04&l~l*1^DbLQTkfg|Tp6?Hk_eZO}TpZ@SU zy!3_lVBB$Pk4z%Lf>O#ILg8NsXx}+5zc(uVegC}&_}ovsAAjOC_v5uMxrA5Ve}EU9 zU*Y1AxNjAB-fD%1Hv=Bt40yr8fX{gN0>1oJ_u?Dh@G#!~CC|s#e9^;r>Bn6_$%?Z* zjei?^kVi}oXRxMe#Dfo>$LGBKF8tE3K8rs(su&IzT*?Www7!M7fDu`>qHu&)=sc2% z)vE-YLerhiF@cK}_@*~Jgv0X-ES7=AvS6{~zBzaP3k*xnJtG$QnfF}BzkTu;>-9oY zk#i@uXFEvlZWQ?2q>xeyMxIXRQ{Sb=%Qh3iJ&V*#_36uVQBtNwEwc~N`gE6g^l-pi zKkGhh)(b3_;JB6=Tl?PsMG34*!9V`hYk2?75$hF$f>1#<`CNN;Sw^bsLb}my@F4;5 zGgrFlyg3`gx$hCZgf--JWy1&03X3uTyDK<*?=K?jl1pWb_r~9aIzxen`2cvX;{xgl z8Tdw|c#eMHm);Mpny>bELe5UuA9E41V#dgRV00?;0LTF*{<4Jj`MHXVfAZ^b@JU~a z>H2kMpcT!hj8qi9V_nB=1!XPq=w;%I zH#h<*5~1Y|$3!17#T_3@ZENQ_PLVy^mcEsuYe-SL0ND-b=?yGC{xw*B;a^AIx`|r% zjB<;;;hErtVNlIN)n;Ly(g9&1G`cpi(j8_!Gk?&~2e<-gcXWowFD&un@AyKo076@Je7(*}g>p|L7N<#y|h? z5e_#?!X+U>?anP7AMtSVH>6Nf2E|bk`y*b69#7-3$&f>kkl;hdg*Y{>wGZ+pY6HgN(TU?vPddh8ZtRdd7slt5gG{FGt0P#r% zr)?q%rpnc+6syGGXdj}XNSHDen8|7c^>GV2d@t$11$qXDT8Y_p$RP~LGVEl`@Wlbl z6ip*fqYQB}+xEgV;J61Y?nylPz2A=8@BIS|cVFc5&eW8FQ^7MEzz$S{8Zr0SX3sP0 z!IF>eIMHT;wnGRDsP?o0*I{Svk&A~(U^-M_otbT~KOVbnh2W;XR9i(h)qPbtD|KR> zPqXC^VR=?qrly&7*&wGfr5Fb7F*G2-G7LJO#GiQ`$(^eM_kOx{T&D`T;*RL3-KWLU zK+DXzxsxz_9{NxFp|3Wge$K>e!{M_KCx;|3A;-r3fW=vfne!v32jKVgKLFe77(V`S zEWhBt0gi72NFmyaWUgQh0zKZ8zes0?x2p_#it(fH6!ZW$>mrz5Z8mV2Q=%?_@!B3= z_euBQ|MRv_0frH~GbsnB=w=`w$%xfnwCXjC2I>lTC}FKY6`o5eSd<j-4Dx_Zx6u22eDuq~H2rjbHzbtN5zF`(FI!w7}-#n#)f$C@aB9nYAX=Vpf1P zM6SJoU`ll6&*bi`wFbu15oOZuz0iTS=Fw!`JE0csGJ*AgVMRPq32IHkl$hP0?zG04HNvh*~c4OkXnniBPFB0Eb~ zA{lvAB7Q|wM@#Ob$^9Q~QIjw<(oMrRq{9}EjmKrkw9l^eovuFIBBU3wmPt#ZG zib`F5*zpP(N8!7DGMXWw2hfcJq5%7f*j>SeFa25^eCn4WuirpUyE|ZF6E=#oOh*Qy zumGLe4f4CkR0LPeilS5R6O=1D-E6z2i;U^GIIHO>p3ZJT8D=^`p8%tCKmi$>0l>_Y zYfMO8^$YQ{9cl-ZCPhM7209g8zSXtKp0mCsubzrE90r%VXy*BVz5uF@W>D6+pdbsK zmZ~7CSV@cj&ChT~+ICiQndsRdNVLr#Hj7a>Sc77nL%!;A;l%+l6y%gx+;tbWzxOlv zqwo3Kz~)|HSdgYR_(4Y`ly!7_?4$FlKPft8^s)_psLz9njGQ-cv&32_78?XQFAszE zl#{b)UK@A_Yja#Z+fnHhF_@H19;iDAx1k{JP$zA!sB1~b4RY4(j7CT%%YuQOaS?NU z5gNIe1hVZdn<||M(meqTIC%J-I($l0)lRF_vTBe_NhFh5bdfkT_o@S^gZ5a=7|qWT z%X;5%o0)~Ff_9QN$7JkT0lGh9PtQ<_`d=etIz?Q16y=4lL!O;#m}HIsm0y4b!-k&@ zj-3h;xw>sfnNpe&;EtY<5STSv`c|pt1g6!1cfbDzHfMXh?$aKi|4_3#hsH(ldj`a` zLY;>13+-{?mCuOia@M9XF;0nT;@@$qm?j$5bbShhLpdpIzVGS`2{dUY+^R1VVVXuf z^6+_l)(bD-*M8#){%}XP5IFK3PnwF{xnN>14Je2V+r?i$JUj%4$HY z3$PBvY5-OPVlx1Xf>;e0)&sCCyk3&Wcvv~>i-!_HV-Wy~vsNwD52dDwgXUZ$og+Fz zGLBM+Cs%RT7rqG>KIdyNK6{N3xf9p=WL05*k@Excc*_uq-%<`IqT?NQKmv03JI;&7 zZKE{|1GP_!p8J8&?8C;`4s&f=_3EL6F~-=UKpf0ObE3p=)?op}RIs}Der$jL*KqdqHDI#=YDHOa<6Q2`)%nn{F^fiC33W-n zbhZU;h5)h#%xtka1dqo+O~k^d(@PIowp19;cUaehX%dh4y0SPBk7YL7-FOPJ9q7R$ zq9CV{yg1l7D{VS2b*>_+S7NKoM61slug!uN_AiIi&XnlyOuJ=Fk}~6Rb5&y~VJdPK z;mrQQSl2u4x~84TRWtsS79iE6yq@!pogTl}V48VL?lWR`AAF{SrDEQ3bLiMCmytFk zfkfooYu9UpP2m!(g9g$vqixf!5z5= zBo-x5aze?(BEf%144GJDVu?hl6+_MzGbgmrLsFDZ<&jx2fMY8aC^a!?tV43InaGL~iDdvw z1Qwutq<6g*zBxR%FXx-YCYVV+GwnH6ZV6$YN609Jd}gshZHlP3hvYKksN9@ystKU9 z#RfvUqBiRR%eg*xI5f_>=pBfEY>C1536rPac)k$FseZCMh5b3wEsOe;!JIoH>afXz zjVvO7X^-Ka3)sB!jlj)QAol{hBdL_&3FvYdQd3r8WnH;)uQ{rEHN1~W(2#LYO~O_b z_@r0uIMe9*CCQO_mCf*m`($tEC*123GaZMjJs-pG^h~Y;%2Glri9`c6LM)N*GlLmS z@p)4tqC4eA=nhEc!~$8#4t6A5BrWHO|07+f%LpU+RrkP^ya72CLHuR{IR!WAR3Koz zI)|^S;5We{@@(UxPUeCKAH1z;V9}-hZS9W0a2~5iUJ8t7It-LfOe!`$Z7Xt2b9*Yn5;4$NQA9{UE^nj)YQt58)l=OZ?+}6YX2AC12H*0- zAHa|Oiw|M7USqLfn|wICf{IYz0;P?c4jr%YqGByx60TV1;mE}ANm2Yqbfxl9%lgPc zlCkb6r4dNkuu$S|wOZkqfBk9v5C8YaFdZ)G6naG!lA9MxNSV>0G9}8pbIC}LKyxPp z!cmi}rvy@Wo+S{o(eZbR_BM77KeLSjpt}k9c|R+*CW`0IHlMBfNxyBjlwK{ff3FY% z6_K4Cow;Tlw2uX~Rz&Dbs18J{#j>NKmpbnNs5w!=XEsC4h)psSXk)ig4H-4V3Mr9h zSOS!lq%%VYkaO&uT6qpX1sy?Su$#(A0n9H6$P->am)gLU?e8 z9=E4%82iMu=H|ijLj95#IZlwKabaYF=qJat35PhJP(Gm7=Vb=Nmyv$}m)@4#>`w z=GDP2O5tX7GV=g9?F0nYs{z-~ukiIh@O${7AOC% zjCsKL>2M&s!eGQ8Ws*q`9QM%lLQ37LDQ+63w!QC;a0o?E!vL%|EBwN*Ud5mN-rvEy zPe&}*gEBWVeqId{O`Xqb3aB_s@Oh+@dOEL1o>rT#lM!Kk4%@62X0T1Buz>^}i7J5s z2(#HWgcH`daI8h+O4STx)u|1p0U*WQivsP;RApGE${dpdrshbH{{lsPng~plg?q%i zifUUw78Al$RKQOI!8WY~>=tpgk~pv0D9PbZ@fOnz!fkJd21arvT+)b9MiOZIhdA}$ z#@A$q?J@1nw#0>PL$dBIl2?TsIknL@LnWGwoQ6L@&JP;mfb@y(Y_dJ?2BPqv)8%9k zeh>1Tm{mG!Xv&xjW8J`ii2#Nb;_N1HdKJ^NAHnq0dl47z0aANDf%~KRXpp+!Qzo+S zo7R-M!S%2Ve`Pk(!9cB0;4mOCc&4q>N`_xPXr~Q?1{B)lsFz-bKv(Z*Tn6xLAvVsPrbDjQZ){H=DV3N)gi4Ahp1;6|`j z4r|kG8W(j&y<@VWdK1a1B4UA3Rw!5_VuQtU17L-+*kFhiN^F2!qF{|-*Z_5fQkTeS zfkkY9X^9*cC^$qZ2N+_7zy^^UlsrJh8c_~Wu*PbA4(p3|s{4Kh7IqcxKv|A&Cf_#@PYC2;<}7!S}ri1Q+v zSIT>GreX$z-xttqM+ybH1Su}J743%p1TdbV-1i8|i(dzvowQ;&3pXL9at;xqZ3HD_ zNN6n8gfo*<77?7=rDuERkO8IoXR9FqDzC+Q!0qJ%|L4DZ8gaD46OUcS=5WDt#oV9& z2wtWQjSb?;&{^q62a$|1Q$+1OPiyhX)*t6cS7Ouk`z7KS@mV&>qr{&n5+-pJHOSW>X!IkOJ08Cl(UqhUht zC?XCiRO2n!1OQ-|rO*w(;o(#cueFyN&PW)GSn4sT598NuVKz>{4wJ93mxvBOXD6h| zlYP@!*GIfy@oZD97FYE_I&rx)d7~(E*b5%1kVL0;&0wn?1CsnM7l9v*BZejN>^ipZ z{dr&t7C43;K(Klp!XX7vW7Jt|q5Ex&vj{Lc?wV6$}UULAk4LCv1W?45aE zOW^D#aP$^}VK7#@5+hWlRt9NdjqokOe-5C;b+n?uCGIh4(Ll=T6yJ_l?L z5t~EA<~*?6AeI}H^%`Y;2rSmX`T%9UMyys`F}EBrtQK4*zYGkU1(tVRK;#0LM$$Y8 zU;(GwOqO`sfO!Z9kgz;Fh{ zDJGmChAn^-Ahw9bDKbuw!znNvBjX5VIKi+yMJ$d{hGQ(2$B4LvEVmGg+d$mLusQ-3 zC#c6C#mO)I6h8Lj{}kgkP}WQ8p=5AkYM9@mumG9gDZ|uP;&o`sJ(S;2O${SC(Nr=O z;&BG3whOb5o{3OtN#$;#~#!$WiItY>JCQ-!1%kVMGlBs}MPOY?E%(xmyw5`}5PB$4-H1#X<-Yd-lh{$F4F z3Ow}CIh<|JFik*-GHW721ry#GSaZ5^j766)fo!P@fUp0b9TM zsG|@)E4(C3SYxR>fSht=1Vw|uPu23?u;SO$PL<(cW{Wiib)u{g1Q{^(&F)BNS}Mzi z>mc-8IAbT}D`QFrRt{5h=*0h88jq}sm;QCA*Lfp&qxW#juO@daCRLyewxpkX-{t<4mMc5 z_>)jBKMagCYBivMO+}~R>QHwH2T3_;3W^y322KF#9+>ueH&MqOFzr!FVDs>UIQ)#S zL^=O5?6sEszVZ@O@C_&E2}c?RZeOY z;X$@zu-@%KZJ#QKW}NJxxl=j|EK*K}R{s-8UgHY3zJ%XS zlvo0R%b!LJ5lixc$STaG8EPm3LwA(sACABpq$`2s06W*FkTkR4zGtW!#)Xacu9;Q@ zZhQU2Y&m>30*ae500O>0E}+LSM#6)IvjrxLl6LgJhnCxVUu zh{ALvML;?Of>R;h!n{H&kO~=!(*!h9`(XgC?eOXMtnjX{dI{e6+J}Hzu{|BT2i%+l zIbl{v5Xr<;9gD&xAS2!#Hi$9(T)?ncq}h`nv>-u>b2$XcYJora;0fOOkA4q7^xHRp zOB-w!JdhH>E&C_cqHuFH%NHHOgkjdy4n)F$;1HaUaRK}0Me>aCi=aa=D7_onbPqw= zu(pX)OHA#`@d>sSaGwPUO@%?zs+x{+R*=t2*_!pD3txa^w9-e?k%N_*c!iFi`VaDU zL@)NEv%}@@9HT_G3X#?^GD114i7*`@ECvLF;AQbDI7V#}m%%+tLaFysI4!~cgz|80 z7WxhpN$DMcv~WODO<(98%95UxZh_hWb&TsPn1-N%IJ*U$JgfE%w}fik0cS@*p2<_w z*vKgQZ7+W|PBVCO05Mngv@AY9j@ z*LlCMiYh)UDq|K+3%f02p0iAx_&U(XnVOPn`0e+)59R)p#g#G5;C2|pAie>ow8+20 zziLbpEZWVSZJ*Jy%^b6x4uX}GZ?`j!D8mY|*y73Wek;!2_aA`u-JH|UKK;^dqG@OQ zW3CZ@_%@zPH*|YA?YZ^Cy{`ZcFCs9`?2C{ku_9}S^tXOT=iv(NdhF>k&`F{5JSvMq z_~?l7SSAiWH40RzzSOa{sxn{8ocMGOl7%1BA~az80LRRazmerKarNRdH`#Y)2fRzRu0 z+$YdQjs6$tO4(Fz-(}HE_|}GRn_>K({-*!)9L3=N8pG*(>R;%$L7xAuTa-(WV0h8z zBDW_r$V#;tUjCuc2vE=w^sd>XosU9q*>0^@br_Y1ma&g0OuHowUeW$CDF>zuyq}pU zQ^jz8g+DwV@xTA_v$*oqF<$Y=1zf)O088yNl-U=JQjrN8&Bf*)6uLP?Gl2;?4|5r# z0ukdzX#5g3H5P8K(hXcL2COzqjAy`){PdIfOF!^_{OgY$V{z{R)?vNCF+ou!NlPV6 zdT}a{utSlVSVH{{n#OUaMqo7I@?fmcld?yp9U&T#1~bzpXMzp3>&gF+?la{HK5O&> z+B{RkaD7JvFrdp$YSkE>5ecN)B+ogL7EcLR=0`qjeq+BD{nVI^r`{&199oVK(K(Zj zl=;jbwl>3gf=TQGDm}I7{^&%y!NA~1UyN`5g68+hbp}xX$pnxn!y37}f$e*K7N`sD z7t-hI`!thiZzW2!=z1TE>DP>saBW!U5pfsPnCYHbJ9EGzX3miMkD%e--U809_U%J# zu?$uz!0G^4p9fYKIMua2QK+%SKv^zv@ai`KWd+ocMnfQ@O#z5kN>HDKb)7SJ3>N4hm=_fsi6f0(1Rax1JKnr$ zn~yLAiG-%&^}kLdKHM_Sl0(Xat~fBMi6~tzSP$i{2yY3=N+!?olrv-==diLF?2^E6 z{sK|quI`OtA;*oQusuq|ENUk)8H|Z10&P0i z`zFz8Vqh5wPURIl@%}SYj2>jauJ6IKO8Who4j`_LL^hb0E>{T-gVsqSGaURNu(5f z7iueXKWE|3)T%x!VttIy%C1!WNo4Y#fD9_#`CIHoEv5=u#dpNjENfcHAB0D^vw~rh zVDee-s%;3@S#!4YY*&mTLu1LX@^FBwG59%7Yf%OOpw>w%`FhMVjmlKbAYu4!dJ?zk zWw3TkQxP5+QSX*+1SiX~Xc$30O(=@?Z8JA?0eVjOZ5qA_irUb-9&CF?1*h)b3=PAn z{&%-o_Y;d*AI5A87ELh!2y85ps+?_re9 zS`j*t)ZCU7EyPpQeV)SUW2Q{9@EAU>K>ETstEPkHP*WHI!Bd5ggm|-X_`;9?02E-b zUA5t%H=M+sOSmifiDN;-1Dmj3X5TamUhzg9U_1cMk_NC?V1MmHd|w-ZT0b`@L)R?UbQmCPRs0_EXtNuI;R(3id>xsrd`uVX+12RK$6WC1c8naof%M9f%=R+a$KUO zz*A<#h-*k8Jri_5?4-7TlJl%wN)9ln;>x(fEU@T9T9{T+kou7b?mC`cG3J79We2su z2&K>o7u`84ph3W8DjMaa3|}GsIW{g}0fJ6{Vck#D8Patb|3A9^Jo?)8EDHp$`+4_o z{D$+L`D6|uArNMgAQ3POZP5sdq*qZT+A7*Ed#Pm?RhFe|Rdun-F2(8^EZRcbvR2Vn zqaavlTZm|hm>7^L5E7C=LI@$#$(g?MO}}C9_qqFz>$>je**{YIoc;aY{l3p|&-eY@ z&+sz4n0y{Q+VwRhXCP)~bBN9R5i(#F2>(%?5+EA@x1(pImZse%`b$B}&;^N7 zAA>pnaC25MAw7g0KsH3DBk2OWmtm%`z&l)W6265IZc5;?=t71iwEbE5w8n@zP4sf) z6uQuv6p#WY*tf~kd&glUHjfxHjsv_*J>P}9O0lXc;_!XkN@jmdk=o^_xuWe z_%|M)KXQWO;|6Tqw?={DmmMXQl|MSh+6x=4Zh9F&t?^+XfC>OwG_+-5s#{LpJGa`h zaMxAR0CQyO-8DqXx=Cklqd8Z(^LM>Mkjl(H`lkOtOy^V2aVV;2zC@wRtlVg zU($gW!ckK)lsyIu#DRRI;<8@|t{#wk)AWT9qQRG3>HLfeK+550x&a&=!8_%$)9HlD zkuq|CP?*%Yo~>+%f^#>s#oAy*I^{7fj?wFnw$)2U5xZPp|TSp zN2B|0lZ?=F84LFX+cP?=l3(G=vfecoz{Pz|eYHiqS3> z{_1&chc+FAm+h`;Z+=F{!7E;mwp>GQFJ+II<*}@l%$t|Wf=7``dH{{wEe9e=*j@n| zC(h z1O#tb?+oW9EIQYcsDF2D_NXW-Bp>Cyf<+& zwJVlDNj`N~956!7?C2`Xe#21OpC?(44^2enr>M5qe7 zKEv}`N8@MZg{DSvr4z$Cjgk<+?hNhmmty&>w<0dj1vjS!7=gPhDTxA=bX>TEqF2H( zoCy`pA5T5hSvL`A%Vu0RrOOi~5&@r~fieOC8tt|Kc<2znd1s4%{L9bbpa1+b_{4AB z#mUm}*h5D+xwhbN)3DKKBcL?N9F$HynI3Jzff$pIt#NJ7;o*YKVMCzd>F2iir|*0k zf9Z!mg1`D>AH&-}afXW<2RJ%u;4CXxpSDKpVAQjMM!yU+bueHH!{n@hzBE|_a$PX6 zm@_!K-+S38qF_~%x;4$Kvyp1EdaCx+t7X7bl?uWLC#TYARJ^7@!K0Lp%IQ+GGYBkB zIcwU0fsA>;@_>xF0=u?2TPfU0L~+ySwG>j~gB+vjC#T*Z`m3B!C5?3Lru>O%q*vD@ z2O*fI7m9N=^DQ|K3~MboV>tjWp2x*|-vO)}tz{8|*tB4iAZ1FYF$D z?~56-2@%qhfZyuLcIY{$?*vRVV0$0f-W|_G2g>_Y4-Q~d&knQ7wBa13yL_y25rn%< z?LlQQ+f6;&U7{TpSb8A(F8MxWjB%P9+7Mq+bMlBbx>9xL6 z{}4dPrWn>i9$ouUN+$dsMzb#%kifgM9EcJC1J1wtNoP2IFQ(Z*VNBDA548j#M>1$R zI6xfj@ZwMY5VoKE6sHwUXDE0npJ@I#n^%TTJPZX&{_Q{r-0AqxD}aM*h+tNQv?TpP zc+;OS*vsUa6?0p?vDrSY(lo)HWeM({3g{f6nhZ6IL^v%MKtlF#<{!DrX;Tldy%<~z zpVNaUwn?(lE@ZB>g^gus!wdxkC;NkKhF}dOFzpXjyq(ihyj#v z@vowAJJdyj&h86TD?$q}D(=8?ydaM@_|#d)+dp^*KlD>i<6pn~c|85>1^PCyi3Qh= z8xBtnusLivINac16WHh-IIV0gg>z|%B@&y>f}^7i4h|O_94y#u0v8vFkA3C!d^5{K5Ds@2X3%SYp= z&3)7OlTHN9?J_gyb`nz%V&h}n6ms=dyek3)mnBLDGpXR@@3MDZi}5gVNrB;rLK#f& z$|?CbuQclSnlsWq2%BYjfF=Hl-bxXWjS7}B5p4r(U%jC9AGAD@N6&A z<==rK%gHDsweYb%DrhE}AL)Q`D(3zrPsNan`@s5OI5uE7JwO=%-?R0#Q*^n;#mgbQ zJRmCKDWgPTALYW=6T*^LWB}U>ERQ~nYhU+AfOZYJZYS9kFC^~?@}0bKQ)5wh>6Cs% zIOCuUjAVqFO!3wv5QHSF7Whxorv8MoQ6;0=aKJ1g`AQN}cLE&9*pbpU@V;C0Jp)9W zGJrDf*_oB_Tc8dOPOzST3NQZCzlZhymg{xgPE5QieoZ_D2EXg8GEH)woiFr!=;esR z>xkR|q4i85$L&69y2^nufoHHLxtF{dUBbX}soh-GGr)Guy60`^ifLLym=G$TU^G&; z#{Gf;Z&P5+zSLGyer-=^7vy-{en{U6c=J>yqVK#A_S2Y(&57Z{R|HO)r31!okr%3Q3?sddu9-1Y;4$E4x`}KP|>e`^3bC@I%g6K8n;Cm-MgFI;dw{B%J(T5uo-yzbUYi^l?>YfCx;ZKGWnU>^ZGZaeC3 zWl}oYqmJ;Dmc>90wx`Z4@fKpSyXnQE0FQX*%U_c__NFvH?S)_!O(8ZjSY?0a`%thf zS!NkJd-93AZ=jJ6^SJ_vr7}O^)1u{&xf_s%s&}AmqGX?Cr+^U7Qc%z$G^MJ*B#_(& z+ogXFZrU=|-)Ks}?+vnEc$8h!X3m5>N(o>N8^2&dc)L|1vq z9tU`nowCweR$Buu?*qFBydQIaM%dRdF?20_%x1Tl78=vY_XRuD4pcT2&?eNE4{21< z2QT9AOMWLF{iEN5ymO|RxFJ^(R=to`L5t-*#j80W$I#z;u_!DDYA&^lhlTY}_6?RP z>l4Oc*fMS(;GI1cP-p{cSQ$4Qzg3J1BkWb`1&Kb z_|z}pV}JEeVLcDv=xE}fZI?fWS@Kal6rb8GOXgJo*PlXcoLM3q&<1a2QkW4+2Si{w zC~yJvN}jOHN)A&l6SO;#9g13(nMcLfmxwYPy0h_h$_i z=QRT5XwlF6^jksD#S2(o_ZDov?mt1^eVzx1CB{jbQm|+=pq1JsN03?s&5@A09~m_= z3ZU?KbUdNcDNh7T9)o>3xZ{bIq8>mu3CLIx6Q%wdC~(VyHG$o32V8XEvID!s(E;%A zLEy&ef~RgC;l`08aPlH_8g0gcyO$jwd-e=xJK%*~!)0Fyz~KgQ+;Hd@e6D(Pxn2kx za;(ruE1E_{DP<7fj6>}}vN$E5`d3b|6#oNKmTQ9*AAPiNc=d(pldtTw39KFrZ&=aQoMBg=#>0IU3=^!-@A;PPUCQ?5 zj?c3L4_?5{|I?qr^{@F;=+8Zm+|X{(dC{rTCGoch2bf0191w7^^5~wneMqXx*mSLy zd+WMoR-_P1)SRBld3WMO_?!)v{<#5@rjLv{KWsE)lcAtKK^ZK)Pyl9J>(qEP6}{u& zkw|Y%H|%r;G>rrPqPT))l@#y6 zHq<6!LG~TRRDH;C0lg!ZMQ@$?~M-QuwPJ{Y(+3s#yc*hyx3* zy-X)TPe#DX<$D1E4t3zhM+fYGx-UXn0g2o|itWzzRYyfeAw7qUl^?s!xs2P@z4Q%z zR!)JnSAP|-<@p$lLYFdV94Q*@37>NG7W@hH1f7r9wFDIqG9)R6c)bVPf#}4)%oeau z-tvMjb`rG~Dk)ovkOO=v=B5D$hYRAkp`C899xS*Uf#-YTqxW|B;B9?h*y4jPT;hYb zSA6jH4j;O+#YgY0xDDWb1Nw2p!Sw@djyG5~4GWlEAUlaW)8tZA30%N94xZ8&34X~# zz;nY+^OA?gll65QlW|cSjK|fXWQ32o_Q^_FG)}dz|3Wg<#Vab13YN2_@$`-a;zroa z=a4aJF=Z)0o{|6BDUpOb36j=bX`!I9d?G7CI3_3zd?tE!(Qr08E+yMicnd!f7OCZ+D?2D;Fec` zT09qGzB{g+4MtEINjxJo{)&7oYrY8wd3l-=_ahy(FKGZe4;mc8AilT{e-vcshn`J5 z1jeFR_ZKnh)o*2-;Aa>(n*NC47=t_J;-KNiH+%=$=~KY=Qq{;Y3!o1#C0NXgMeTf5 zkT3oc3(JF=la35W$7HogCosbivV$4USGWI5=8xc(}pQ;RXi{Xgj^E585FRHb$hEppr3CwyWvj zGL2>;pxt%K!b$(SULKe^4kFAL3u!|JYSs4gh_MKcN^MQih(he^tKRXI(CCFmAoXsq z7Qxq8h~eb~mEmv%$|DLSD+*LN#l@SnL4)ULi4Mt(16(_U{vv^} zVYdp1KINoT8qj)-MrYDj!rNsW3;_cb1|R}~JApbEGLk2&aswlq~0fD7-C3XotfQj`C18J1TLa0VtTv0ZA$2VEI=+=>oe^dvV&~eJyy=r*G(td zHf^t0TOJt5Mo2ISWAISDgC}2wgU4TwJih>RepYJ7U4XVRLQ|L%t~4*Cr5y!rn3T3j z_nakA=9T(Oo#c)_$s1Tc&4yrLOh-L-p%Hu?U!gkoFeT^G4Z=tH^CD(yiUtf40m`+4 z3Xonwv1Iu!9E0-GGk|u0_3R$DAO0X;Y2pRXVIfl1FtiqE5nmSZttogn@04A@a)3B} z6xbXK4Gm&Vlz;*#C}XAeC8M-DvUi53W;?W2M*7l4Tk=HqQu0B6A|;y+B+cHLiGc>5 zCUthbpO8rn4r0tO!W#)qDRD*up2Izfe07CC1gR_0W110juP;TLNwe0noSv2v=w-AKug&C?!Bh*%f$j zcboLh{L*Ji^m1a^zij zi*AL#+RorRw}d_-8c#{+bncNnsn~0dxcyPI5?388paK)pg~5o2_o9p8Oa2a(MKX)k z1Vdl>qC^|w^a<25!wh68n>0qf-akV*qS0xsRd%RrOTE!g$bgHcNuiS}di{@_g|54K z8Vsl-{L)Ik4IYib3$(k2Fj{UYKh_cV8(>+kWuse)Mx!FF(fC2K-+4X_r#aLV)!axC1+9s(T=_Qd@Py~V7 zcl$8-OJ(I>2Qqegka6DoDwy%YXWNX>$=BiO4fQkegN%27b5;Tsv?I7P?fA1l5AFDt z;HF;LjAW2sY*K4UOiBeh925Wm^%S8pX$Pu7MOQh;VO?2A=|5WlWki8cK&MVicWk3* zH{{ro`o*o^w2YpbNea3KLllOT+_xYd9Na}{a3p=|a`Y7WM9)<^)_5v@3#_+4iR~vp z$pa|OLxh5x10eV+jPhlRUfU9uo8b2IMVX*j5XTQ84-O@Fgw?Xfpp!KbzYE&;u#MBBg-w?(q9IkDK)DIlH2MzPFWEvRw z4IUI`7WRRA*;y!pfh(OAg`)*T4=@UsGX;oulVb!x^I{T(0s%Rq@Eh;dH_`zVmCI!J zbYInn7M-c@GCC4`jv9xOBP=>H&Ix6`go8$yK~o{Mpz;tFpRg?$F)}-SzVfHpa{ALmRomvWA*$AwWUDB z4iOk|<~$AJ%#Wr?eIL$V$tk&A#FYR__+5peWKHGQ1eOJx&-pSgTJK4@(3C9)K0;Rk zJozH~WE+;u2BJjS_emFnQno=O_u$Pc&w|n+fsE7}-6d1H#nwvy8kPWeHd+wPLY0BU zfDKzGZ09Vq(s#Rh{FS{&wdo!J9l_0cLk!_g@rb??X%DK3WH94J?AzAI> zk75}67r(f)3 zP(uJ&ydwpC-H_5!_sBbyiQxU9%vm()&?X|})J{Neyk;Nl#k?P~QMRk8E)>|5&BPQS zDN__p0g_IRj?k2egP!RxffoFsAgYMR>9tTF7Z0#`^eG&^{7t~6jK1s}k~~lJG3^WO zs%!)_#gsH@(^ANcUv|1TlaHX2e`9bkWFS}RQIdkG*p|BxDKA8o84Sv`AWJAzAq*+U z8Jf1`Q{Hc}03BRNEB;XTv=+0O=L*V&BL@i_tYuH+;exY|{2KCN<lJU3j~rZ8zl}Rp6S^mR$$mM_RlZ|gxqGf{_=>1>R+!~7f{6vwNPuvtq_c@a zStG;QQNG1x;q^)ij6(X6nz9#wNZEH@kH9Rkm8Uq zkg`Q1Bl~3cTrUDe)Yckb*eCed7KN9NAB=Rn1&Y%PMx!+z@*beWwU?rxfFi4GMZ(4d z9OZQyHX0;3AC1CWYgi(%w56uQQg}H4M3d2~j1@CAE{_go7m!$YJ1MQ5CWDQ2Re&O8 z@;V=9BW!rM{giNgriK7}RGQcT- zm4{jqhGZZDzK15Q*kV$KU(I0U9pWf}klMkP#=+SaXOSc?l!p=II5>BZ5HY8rfn{k} zLMdoF9~q+nr;@5(^2{hCM|=u7COIMm3DFSLp-PuaKkWhmu4|K$R0hFli?JoEfri|z z8nF_-=v^mOaGJxgAp(87MQ*pU5#$+1?6MVIeWi4rg`}&{`kWZSa$@Ll+5E`?q=Oa( zCo$E9gCDK=5uI6qwx9|+XhDn&PuO0mY>oj<1xy7aR9EfAlsN+ESnIj^sy=gM!~kHu z#Nlhd7@KQP0o#kwWQ3fCx|6=8Y?Ffv4i+T0wz+1r@=n4_TZ5zfmh8~53a%XDc)7s@6C9l*?VCm<$_{jT# zIAFHHJaE8Me6YOuU_?)Q4%)`yHRR@q+sRYgz2OXw^g+DK-Z^Cx4e;XhSPN04Z_&Ed`&W|B#H}1@l!m@ls)7x4LoG0 zR3AVc$VmGoT;xA|=pkiG)8kTA!%h1yzV$8#DE*Hyn57M3f`K;4@7?SOCodwH#Sbp3 zXDcZrtxz)*er5zL(~^e@8(rAIlL|*#qcFCNn;SQ;t^# zE>|6<7E};E(z+li8XyISw!9{Q-gywP9XU(MrVXJsy#X+=QsyVSw~w2KmRBlBDXD0^ zhre->0aXQeLTY<-V&gBF<>8~s1O!D!z3Bt`9l+wGeysrGqa{j-u_7tSf? zZbC>NNj?Qe3Jf82Nl;G6%TWj7V~9L_5NOI00LnPRQ?6Wx1<*;#jIz1TDHJ=Fa)6=D z0kyDQtciv^zlYF^2}l3)M+kU8mNdZZRE=Rqz~7KT*0Y&bT`37n0SA1~ZB2omXuoIA zifEqpu+ucG4wzhCeOb0@fwN$B8?K9K%B)~4N)H@&m%ygs@blh+!~uHWI>ew|fEKaZ zoI99>$;qr~1oT=21{PZ3qfw**eANv`?x2Sd8V2KJCe{ApkQ1>mrNT!`Jo_OmPsm94=pp$(~cO`gQEZ8hZ*xmj(9(?pSfNMAR`DddU%QW>Qy9QsOOBn~5-)+_!>s2dEa_<&wbK_}8v&Z9fn>KN>jCfi31;|I+ku9fn&d{a z4C(B!sBd})am&=Z+#ng&TC0TCy^7KfK-rUN!oZ7Nt1UgA%k#bl@J+V37jtYND3c0S z*arJ{08BaL`dkXRJb5Z$mmTWH)qN-F%h#bcJ&Hjnz?RcSN5)3P7iIO^Ku_gi22R0{ zgB_PAMnfp1V1jx)hhbEG-@^o#`_}DIK{qlWmY5(z$~>p12s5&XWd60b0?X zL6&z|kh2O*WQdS*h+sOrcfR*5LIx&jt!!vQX>Wj8q!5)CPkC52oav|$E9qg@bGH)t zRvCfDAZcB9;;TY38S&J4HDP|3uF!%<8JGr-AV(j7w*MOT;BN?K2cxEkKVGPb1eG&5 zQe)3a+35AM2EbEsDf$`DzOGUa;^?4;ByvDb!Vm>z_`>jW ziVV;KZIWZcQvnfB#|tD9**UEi09tFB_ET`1%mz|^iNkKUo6wj1%BeXx`#&?367K|A(Gq7SMjc=8?y6_^LOeUu*%% zHXQ`l!Ue?FaAWVS~ zP`i<{uM$H|6@gQC3DO`kxmbG+-ZYRe9~Po-1rU<;3cx(=CfPME*%8sX@IV`A9H>A6 zwP^t`ds`A2e3eD2Z`$Y~7aTN7K3NE8jqhHRUC-cwoXm3#+vu4HW|_D&frH(EJh7E( zjvTGTY=jCcWps8WAm?UB$L{MoBuqvUHr_)x`SEYnVML)eR6UjLNUwLXQSx_!v)Z=u z3cj{Mp5I5_{wQ#CqJRuoLN98xzzJq6Ht+cjwt?_jJPNWT;|O?5A6P$ST%lz}0^gBq zG%Z916^_PYe7cktVAC=0iFPJu@$JtYb>;a!U-S-lC!J*4h-wK#UBeTtjjpUF_3tKRM7G zf<+arHEA?V1Yfc%L&=eQFC&PAc8aCW2I0xdmmhgAusN0il}=M2MVBa8NKDJn^cP^@ zLV(z|mC{;ZTVdnrcHy%_yz{`e$MwYLCYzGN5wb1Nzz%YdYF-{f!H?PrjNfq3J}sOz zNEO^cuuOGQ&m^;0FLC&~FG0KYa`dzN)X6Tr5D9E$4I4ojgPI6PegGs7_AK&r1`D(g z#39Y6L>*^Q=qbw>2xgj7_5p(j+D9O{Q1-gyi$GI%ra_kjE@!o*$C=c5C|C+WQ%uS< zfbe?Y!6gYA00PK^!1-^y7rA2=GQDWsJP&U@pE8tMd&IsLWIF(2oNq;VomL~BJZsK; zP(T=s3%)&FCcWf(JFR1q9F?dC>C!-5MD3IkEt_D}x*~vj*Ctz=BpO=hdYx>{gVZZa zJLwy3sig%e&|#nG832y#*;iwr)RegyQ($s@P#Ib|4eov5F!d-PUl*izfVv!=Zyrdk zol3|zW|D@csW)6SwX^QD)M50;bzZch^n@wtb)*EsI+T3+lw$j1BO&IPRD)urkmA_5 zHc>+5BmgC7Hi}ip_bu7(qb>w<45Kmk(++@ji~RU6A)=vcl#7X&u;B=0Q*@{s<&JoJ zv08TSuJA6K0F?33S_zGr7%&iEFNjU*C`W5u>m-6_`Sjj7r6T2~GiRlclkBNTwi-+H zzN?IdX<>n1EAU`IAREEJLJN}ZbOJPLwUa_?S!g(@fWz6+K!$>r%*1MkY-3>BXljIF zqCmk$SI*iZKt7mv#2E=1+%XmvYXg0&(Va$%gpvj(h)hkbYCMV3UJyqG!kt|e0%5Idb+K?Dp+P8eVsGCC8VZG#Ub~E@1FyrQ>7_{*` z?t(CSu%v!$^HX<%W%x^3&4i}eq(hQ{Tvys?BMxZY6!pzAL$Y;5?#Lzzl)zm9=y1ac zF8eIXj{>A zZexJ~zw6kj+V~w@!}^;)gM9JhXa^?9Nn6d3YO$iZ)9kp1Vp^60GHfc(5$y;nQ-KuetKCa6!EZJvcgwL6oAb_fCR$q% zq5GPe2x!`+45!M30)iy%IGxGgnYlmR*Z9Whl%rub%!?+~FDTF69ThrXgamTnAtKn> z))`4ekW*AD?|?Ry(P{u9v92rDwe#RX1%lR++Ks06EDw}b!Pi&4Gi^+VT0YbYW0%fn z5ezW-SR>^=>Z}UR10%qypifM9;N)q+!np$PKpbqaecwBfD+d!qfPI!O!?H8otG{*_ zGWDUXkIU986D)eKmF`*1c$@C0O=RDaH9 zyZWB((!FB9kS+2U!1fZ$<1a;f)f`ccKmJ=lJ5-Pqw3lt+VUnU5MTx!v5e$6v&OyR&2tXTTn^U6- zZB#(hAddW}{;~)~yATx77;rEM3$EF-zk+P4h{7GEbnI+i^4;2a+kt~KD65zIvL8gB z+tQ~EE9efeIAAo6>S%AE%czLonpU%T%T5Gz&XIU#xagmhJw$3jz1I~nBS!h5Y)d?d zQEU8$?~iG|NUj6w;uXIO8Y8}v&_Rq+M&FmxI`wMf?$4|Qq2D#4vxHmm6%C4bqkBbW zp~4X(C`#y=`r9*%5>QO=84%Myb$xh(yz?CTul^|7=?yYYK~FTM8Yvh~Pjs$XAos}D zRjGX$F`haJ3YK<$A-hhwm4XDAy-6v@gl3{CSkd-vWgZYd(2mnX+}cU_{LGq@a{i&| zBxZGV-b_XBnw9{lQ~^XZ?h-30V4KyK94$odbzOmV#ZuEC+R+A-5ul>WK?f9!h!iDH zcGL{AQjRi|ae@qN6Fiw6YxgOp?7IWQ=_|X#sVOj}-EGjB#qn;DIo@wJR+ z|2@&J-NNou@5aRke-1djE}c&4|D?atx%vwsY^MTcx-bKz({?FXVzREOgnI4<#p95T zD!K?KU_7^dqL9-mxt$7lVuClcn@fGSyt3ZM{8#;^e!G5KNJU%XtZM)`yMu$*y%BN! zCFtuVwLBSM0+I!aY}L;$J;UV8lg`FG2PhL>AWCw0bZ+}7n#&FtFiyd7(?yrgbZ1fx ze$yI_lw<8#?X)?VvF!n;c4Ar3B5=_I+cgD~`jwBN%4(BILAC!ElH+!8fQyg3AG;Ut z>P5UFR&WgudFnx>b}xmAIfp#*L*0Rb)+O4~O7N@;zAu~|%s@7sLTMvL!9Q;v zghr4pG`%UKnwrYuG#=|OKI^74bCWt_W#FhOK4%Mbcol;Xjua`wqP0hn!h=p*yA)JE zD&1UjI=Y8)%7MVTu9aEYqpjNZG*xyjPOtPSn++Kv(uu+nV8oKism+qtOa@tY43hEr zSO9>}NSowZ8}qOh9=lN**!0LNRWcR0=fv|aqvCcGq5*GtO2PF*nGVZ9^(h%c&pLs% zjI|tD-|fckv65ffmt2!)r0nkC;vIhvd6~fGkod)L#zJ^p@7=epV%sb#8?}e~)Q;^5 z1%PD$E7E@bl)g55Q_&ijvdJ=6b#JmUc_o-KyxoI72V-gr3aAPh#bn6wEO7``MLsE=OirrDAaHnZW21ZNmD-K*eiX zy5&vu;=rKGXbq5tob@_?GK7LfqaktU{uYm6#jT?S7dy(X2Xz#AW;J3Yg@r6LV-a-R zt!=Qh726O03UbG7?Ig2;oRpjk$k4F_*~N3oHejbqyIDac#Ofqq5qe*n0qY7Vr@`x} zM91&Ihx(QhX=M%J?27c;;G_ZowTm2w6-E-Do(ei(qKVfaA4z%Jef1&!)&k}xA2SUM zf!XJCFeB?EIyvNEp|mWMcx+QL5Yt*HH7HqS@M9qiEl}4lRu9>mz8k!dPe90Lfdm_G z>%<_&K*Yq*r%M{I8Vo)(6#N94OoO12lMx0e8I7Yweukl^)Y~u&g!s$|P4K3!#VEGp zzZj>&8ouQa*sj>U^KYPC+(sTg#Klsn)%__0FB$}z*4)q$w$^H}RwD!%3`fTm?R&m6 z0r*^oW?|A)jo>cwtBeDY(1<;tsV$38Qkk>UsMFDq7KyQAhXH~et=cKRxys-@|F9gh zNn+!|5d&KvK~D*mqj|OJ-~bqDWVSlq|HIK5Gc+N`S$qd-YdUv=aEcC~Q4T2k$>t)DveGH$t)q&#C^#SNH@H0%o#VZ^L>$N-+McCwBqP+p(Bncn)j58J2#LbDT>vljhB?VEpnm&~zt zPQ8UP%qxITytu^|UtjRw{_dN2^{oYW&IS*ug9=1~_R+QrsUS|zG84IM(9fU6#fRSq zY>vhPS#uz?)gP%TO@3oxAY}0bI6Y&h4*3r16csEHK=)^>fJ>Xf@xYiBx%d!6j&;Q9gX_N{yg=>y7DF*)UWIQ zCZK7$o`DLpKRrV9<)ARy!c3O?Y76?jTtb@*qHWllX_;E%*|~c&lLul3=<*#XY3Qo} z$xAdyQ>G|n=&7WpfFXB_nu8`s{7})T?$xM5mKBf@a+_)kIR!Mb5;d9-APzv>70B$m z?*IoD&gmW{h~?+BrT+rJ@eQocd=wY|;=9rE0dV~>1b8xJHAMnZz~pe5b#Tg#fK8B4 zNi^rmCMeLeGw^7ug-=J-l$S`*EO5yMgp6;zFj@vg4$%VNQ^GGH3m+@5HW+=&I4a6s zf-C(And(bnxXy+hS-+UsSqURZTXwH?F~t+HWRbDy;&DO>M>_Q0(Q=%IOmY$iE}T?* zrn!PW2XlNah4q|s;|<_6S&EqI3+W(HJhGS+Z`nOlwPOttix0Yx{~XD(56T3$tLwd9 z>YBV)+i8nsHp}n>+%l@E2Hx`PHTZkch_Upt)47DE4NbOC3bGh!&POc+P4{`C%{}Jc!`6-p9;yc^4 z9np1DAF%D3QVvbFXKuHiL)Llf*MSjyJ<*^da@7qwE?|qJFZ^08n}?9=h3o(jZDb50 z0;?RqH)W(wiFQ+|V>vkZpln;#0S5nO35^V8nm5RE1{E48(9Q5)(OlCEKsj89Y37FKcTlu@SRW!Y$GdKq?NDW6Q=DjAysw+L;e@3O&K@SOk;dGsQC zO~Hmk7JgEl3jp7P4Yx-nlOZ+}`9mWo1t^tfh7RVl0uc%R#vFBxJ{$}bOe#|F7(U;h zKB;y>hN*1CZ+ zZ_%~0T!iIlC)0m`5Zg`W&YQ!H;5*r~7jpxef!& z1-6tI>N}lxD%%kt?#Ct$h}LGjU9 zBlQ70SMsC`yk#qu8OV-US42C&a`Po zlhW-Z_hEX9pr(s$l1*V^7~!jRP{KbBipyZ#!eQE>)!grpiwbr!S+Clc zOkRc2g9qE71hCs;bL$q4KIbi1A6%g8bt0{HpwY?5^h?i;3wa7T#oQ@dY5Iy>tVx`* z`}G=w+^8Uf*PdQtg%te^I+qJrC%AKv^eMQM?M$6QpW3>8Z@1#^v*-BEFF3;g{0APx z%O2U_#S1#lrPj09H_@Rx^HT#>uuQ02^u%(w;PS&Cz;QIgK2%HT!l+*(Y#KEF#Kg6F$O9O3}9=wTL?z?9g2%uxPo6;Aa5GEI0dO zriXO!`XtRVNT-N{w*N=t6qw|KnIFmbx++T#g+VpCv>@4__zVOwi;#&q0#zcwI4J22$Jdt(4?K$5?mt7+bqf~`OG4sw=~voZQ*;Pz(_njHKCJxQ!hA8XD?gHDDm0hPm&A%BQk6BS{0`)xBLix^ zfzs;X`x;p}z_VVMUkL^}L1fDCInX5@T)S1I(Y?eNFIcxshg1e}-O3qt8p6=%viDVI zd(a+4INJ&IRT+UUeNXWGBaja%rvq>h)Yk+y$B0``0>{VL{^~!&y&wFGxP1S+fRo2G zIFS>WKejP|5KtNGt^*_Q#_9?Rk<_(@NnoKx=))mEqi`u0AQMzJ$hLxnFMVKj*_Xh0 zO$B6EY_IeRk94^%hO|XCOKlbrok{k6^$p=x!BPi;d;}SB_r=v_LtL=bAI>P6y8xGv{PC$RE&yZ{hKFW|8 zAW;Y|E$Ax`4ZM9BIJ|d>|K{s%;;;PMPvFK$1GZd1TX@)^mzn1@u?G=$y3S|;KrRcg zyTtup`6VugXc&vr#nZ6=NdV3q!~*nbZH@vgBxu`Jfv;LniIrIpHj|QrK*sDiO$6z= z{0fDDG%Q(+HnJsX%*L!cm*hfUuhY`Bo|-0J5=?pn^)6f^G;mJKzrYGFOlF*rQ0A#J ziL@Chy8#WbL$e!c`kB5-oR}R?Wi(MU80ZXe(HsDp4WO5eB**kHMhV!?j>z551a=7{f!DVW=p zaY+)XUnR=-DT2LPBV zOv9n5eOWe?p^&l8M1Vn6YCTOv(>YrfN-9~?+N4Bk_lfXeAsPVT!d+#Yw&;7o2L-4F zjW!nmD*yxN_!^XQlz}t3o94&8?O1eO1*0=7oX(-)N$|j|wov#eI-;MIU;)rIN`mR4 zKycwMn}A-$psnasJ}Uy~96aqK=h6bm4>$#5fVe8ee^p4#maasrv0 zhi+0*5SFDi^j#-ymj%1s7C>Ut7Gx+m3T5D+H#SECmlwe90Z|}v!GC3hq*~dTHfP{# zhhm!Zx{RcLx1Px50D0s<-tr>;*A7ARB**R{rKyR(GKpY%nQegOC9e+lT3e9oiuK|i z@ZcHrPrMh~_x}XekNpa;c?!7xFpxW~t0}=6GF*D9zXFFu@IBj?E1wA2f~o8rPz4vE ziqQ3!*$8!H8`9i{;If>3rjOw%xMsUIwd;N%K2bnbSGE<9jdI|Y#Ho%>Sc${g^SJeY z{!elIdEbP7=Q&{0cxrbWdI)em7?Q4zfv#~M_~**O7{Mo=P17C@kfA|ff-p145V(e4 zG-AL_I#W-Kwd{s>c7mrEa}Xst1Q5}%0(kb`7O%#N|MnXn#W%h226mS#wmabDF!0R9 zir@c(FW}wJ?(pcf18mn-J8ub3TNn@$^q^^J%CrU$%PIQ#NAaoe`H!%>JU|>C5#}zL z2@HNT+Ic}I{)#5h+7&nKpd#6~*N$b2y*B~$Al{h#1tUN5Jes!Gi(cftvU;L-$PUy! z5LbdOdld@Sx@@U-UvcnCIN63WH*KN3MWb8 z!C;_ln*AJQO)@0>LjzI{1Q?8a9Z-lCJy)J1C&3KJ=0S7~$cA&E9xx9d{c;WgB*O(E z83tOi3$f0(<6v!1JhBLScs`)fFwobTsH^sRnB0jtjnbPFoD!Z3K>6}kxSo~ zkx3Arz5~`X04w735ybVUfRjfN2OE~}oyTok=K~Z1jp~V3%D_8-QP3h(DKuheaDJQu zOW4e~1au_7`pFpg!^%KYlA&$-+WlZ5g4#{vpK1(LM1%x5$F&;ADT&eOOt1agv%Nq@ycHmB#Ea#tU3CATer^l4Pob63!HxSWbMAXdIi z7ZezGFv>7BH{DZqCzb80U~KBcb_^l;P=Kbzr**1dPat=Ebbb$;#~;HZf8uW-`w`H$ zfGF#J+p;iwszX#U>6+yx5nL~ngt>)Y`V1!6$YbKv?2sBWF98KaI;a!yD1Y8mFq~RI z+ppOeNm!1IgF~*1?6}B==U=$MTOZ!w|M@MC;*Fnug571W18a{CfKQ(%zV(N0!d$@LCs8^UK_)jcSMtlppz(UFXoe^w|Z*h0@n@DlO?KI(<^ zpcxGL6}M^q?$UR#9}U=tEjGL=E*~0r^v#1~FqOqEGk1}32}j41AqyySHI1gxW=i0# z#1KQ9)89m{`f~e#%B!ENecCX<0%|Fc;SfRjT-9b_hWbzFpeglPqh$5B+X4M@ls7Cc zB-BPH>ZchAQ9E4N_f&2GH_EupV(`>Y^@r)kWUOIj6hG_WwiubQQj7_gxy=;MV)9r1 zD5x8B99g20pMr4)TJ449K=+_~C4Z2!FMtNj1?OZ<=3@S&U{T;Q(x_8AZmSHAk(3P1 z&L}Vz(}r*dfK(QzO*Eh3sld)RXIbn(Uf|#rUx?Fh`Ag_GUWN7EvuMkL>_7)!l|ir> z@RgBsAf$!jnXBGYChgL$!{y`#&VTZ+;o_a&2eczw&k0w5uF~6|@?<*h9+H`fuQUCs z*#$UM)@eBaPM!cZM}xMO7eMW3S_-1e3}1xmXrWZ~CH<~oNp;+Iv;J#j4P_$I3$A47 zL(j}p%k)eWKZA6}_ADp(s_YEE@A;Pdnc54{v~voF_RD>GYQPyGW;t>D^QU9zDS2Ii0)-dAJFD`l91) zKX4nr{LCe8U1#>onfML`Y~vSIaa|Fup{;?qB z|1TpRc^&$_XE?H~of0yDT0l?dgE7Sb@~~@%S4~B2j*$Q!eE*-s`pI7hu01~CjS&c? zXjwcrt{(7Ig;Cc(OZWY3(w*G#@9C3>1khQNy#iMW4>@BFe8{Dp6L0>{URi*p7rt+6yR zaJT`UxmfYGA9w-3_{h?zUZGA_AQ3(W2PNgj!x0=3_khS{~XSr+agX+foWP9 zqDdkdtfVu4@>Pot6eS^qw}T=QiLjCol~oDUv3n+zGt@|lu7U{;Vq_yE%K_RG^)%p9 z;6l)q-8LSepBOU~&fGhZAzhK|F+&a@S7l?I)#2KjTGk<6bG@WGQlI<`Iu>oAKtzku zY0I=uRtF0+lgvOH^Ff9RZXud5pkc7h;~j*fQ-;Ba}%MhbVq0^_9nzm1kE7rNe)nXb0n zrP@h9bN`lem$6K$zrsarS37QI`kmH;$!Vq6ahSfwZOUF=e**oPkKz1B{ygx)uVK0I z1h;FtyzuT?&_`&vtB~4BU8CcZ*;sk#T_h0839xLG<#ZN7Z_9ReL55>oi>9W3{WX84 zGDTD46l!+?PM!qXkw(6KWn zo3T<|&G9 zoH`-hn$Il?U~_tmi%)z2m(Sh>Hb)AaoY@jjLyj9-qhs^ZI50?DnVt&qIjt93GY1Bo zhQD|zx$!wWT&KhPJ_uGV3l3M89N4u6>sX{K2n_K~L2S`SgNK9%4$2yV!3{G?$qZ4V z0@Vl(5NKv4LngO$R#X(syj1{VF9?3hJ1zuhKw-^CgwL6t_pDk#-tIT9rLv2(&MWvxB!lpJ6V-3(; z&xYHTYQEC+n##^_8g}S+;V0Y{_lc>TmD5f@^l71Y%ILWd_;Oot`>Nh_)PI|%DKNnr z)A9X)@YaqOk+paf(`y6Z{wCRRyY+Q2>YY38U%ws1)`D8$7q0K7CV2PSSAi-s!DKR) zLGi+6J+sqvU6*Ui;N?}tEu7r9aKH8#)@MJ7vmgEsk#xnD7-exNd zhi+I7XZdLwjaE5LA5?(hI#b}{asl9Si*|a9<2QXXV%Ly;E9a^;Sx7m~3Fkna#kIev zp7bdy+u^KsTznEvq=CUE9Uzn;A^suUlYUWa3H?e7?Z#3^bbx9*xz6zE+gp5Y?(p}& z{Ym`cw?2aPa>d1^j~LO^uc&1DXL1^aaPhr>mJ6yM`IDK1A;{W{1!ybozwhVK&pX$4 zg4q$b2Y|0Sf^C`j+|=%r)nP`(yEmEXa6m=k@Go%??^E0T(>w>K*^q$OM1t86c#TYe z!GNZyJT+xrK$*Qv>Gd4sC?MuN1$v>sQ|5|mwS*7A00N#qDh5LPWPw`M#UQKb&~+H% z!dGVOkpm+$o7RPttO_IE8oVZ!B9(EKJ&B}D8O~T1?O>xWaNQcGG9gPNs&o1^0iCjE zU9&MDvg|?kotn0iDiSOs5>wi|)|(g)Q9)5#eF7s82t8*os)2h)gE_Z*nCjqcew zU4cF1VAGCD0_6a~U*iH@R{-O7OfR?ZHxf^9waFO*6Ydk;43iB73u^SP=WXIc)0?hM z4?uV>a-ycuRruVe>X$rPc6@CfnO|3FVLoFlY7F;1(W?Rh)d|5047}m?P0tCRXtu-? zZ2F!00#-EO^iixYJcIi`^yjdC%IhsPkjm2yLU*!1VX#;=rlklqBt*mqVKr&g*IM+gaQ`W z0ZJZATr_Itra5O3_~|+qiXuR{V`fRy5gKLp-Ac2D!IFBN5CYrQ@azj0`1*$fKm12t zhOd0XOUbRDtgb;u0 zyc`C1*(qCWF9E&1ok4>6m!x}WQM!Ip<}k9rA-f7_2k4l-5|NRqt>zMzRA$Y(!Jvom zGE1}Q{bA%86I~r{MZ?`8nXQGYyw9JX4*yoE=U%A%kuw zKEYPT`HFFc+PV6TxoGO68lLCExn&*;Ly@^;hi(R+lkN3}-m2!L^IAbez8F_aOTL zvp;fXJiCX%PSHs6!Ud^rlQJ_<)M%T880$ooF=FO`P8?crZ^skCEQ!z13NW~-sT;{) z*Rca$e4W{`1aP*lc;T5d{PE8@#^3vnm*F)pKf=X153N&-#K42DYN9daDT1~?dsh&| zQeFo_zL5_NL;N-;8|*&$eq4U)S>W0=KxfxfK-_g?NHD|Woklz=fry3aDc#|H$+>?` zbR7hz?h4YH!U@3%WxNVM@yvKcB%<$z&jSEu;)ny(_A~|n*oM2OV9rD$6Lo3m;&KE}`Tsk#oz zG{V@UpZOKy7eYJ5+^0XTXEiWf$rF;d!1@3BmvQl~9{_GVj*N{Io+I<#{U&aWzV+@U zssjy3@5xsnAVvUdSt@u0=Wh%Agk$mTe}{(Vk#Rk`1uVzF>K72&mZ+atguk6rhzu&1 zazy6;UQnTSnlp5!pXy<)dljy)k#M@ca7yfzVY|APV<4?W zSAQ&@Y*fY6PSH)D0C0W>hp+j39Dep&us*nhIM7*66a=BI5KV#6s;LYvpr59%ibkx% zu9RU(z3OG*&L!PKHtrMy63emx^8!^lR!&1P5aYJ;fp;p?v@8p5Uv%L1CH^08xq}9n` zXD-B6LjzX_hN&H|e1{WBR8y!5&g!fy*6TXe+1V|=Xj}wrgJzkjoob|~vvFF1r%wru zjgUuLa%L&UEh32(y%gD;!!T4SgNI~0Hkwx8YM%mG?WifX=O1ogeU>0i2GEM&^8W2n zDmxqoe-7H<>&bYQ(|4U10Zu8ojC;soILdTZqS~^%#+ZoPuGEZZ}VqTCKjr~FW&U9QFL4ar)!r#Ut)PK>) zbaGH?UZ_p?SM-^1V1rY83RIfY=8|dCFERD$phmdlqM&k?3)ARIFkrd(Of=i0O$Z3V zkqI21BC)~QKl!WJ{oLQda`R!dIM54TW!4%EQ`Z(xZae0C+BhnPjHZmuEWZV}Wy)~5 z+$0;OrRj#oAbVM+z^XCxvpJzdFdZv^4Fx^UXqd)kz)YK&Cf0T9udd5GsIFxwlfTnn z_n~(fVzL)d9fYZbq*G(v0G<01+yVB&y^dQCw)pGc_&EOjx4Z-g0bE=-!)e+PkTjfiQzcTkR5pPD ze+WKiOy!V)I{&D}f_`}$_kZm@!0}17>!}<-Q(Z|Or`N@FWwF3ag!xSz<=^@`vPN!M z@*Mmjm>E z(3|RF%3`$`nW{Oca+_|?*_x0e{cY`-b`u}w=ZSq>O%n$jMgJLZ(aW+@0n0=qmvNuv z{3c!*p9&O>pZ^iROAecGbi1aVz7V@BNbL+JHmA7w=l>nHKmE6{+`NUhIi)Y(QxhNU zpmxvz@Kn^USBYSe{^ShnMQt-eDA_$HFBK4PMcY7SmJmD#NYqjp28+aByQ)gQ1}q65%b?&tg&#b9 zL|tMT!jWDO?Hz0GQ&cWI{K!F9LdP$3pz$!xY*5C}vaMiAI>VO)sh^+>j6O#{4giTQ zb5x{52fVO4A)B^xF*C6gjdgyI4+C}p46S*C`mP1-#LK}dG$m~L7iYki5~*_&ipIXv zKy)wkQ{^(+DvQYg72dk%`Oj223y$l~Z84M_<-!KT_w`JKW;r7%;}d*WOOjuGN80KpSLxxvQ$K@lYfWRS|j-Z z1%ikQp!trwjyMS1d(TfHw+TekJ{@K_qL30Rp#{K51WEvPKEILSV1mK?5 zN=VKn7oklHBT#3fykh2_c)Al_`&Am5o&sZ_!d+vbHwZA8WL9LfO<4uYHN8tLxSOiP zQNa>rW>iHd?5W_4t%|nEz>C>01tTG*NgSHqfyhjc(P1A|G!--}v(3utM{6MKmj8|5 z^;J41r}DfTEP{HQ9-wI_9YEN`bs1fMNyP$mW-O7X5YbRN>oOU%nSpM9HgGX%5j90k z3$%2EEualCB-p7sLa6!y6}OynX_?qAnA;bf<1c&gkoG8r)i zJt>+y!%(!*msVoJedf*NP~4YcX$mYzKwX=b!nyhi@kp}hd(f1X4D(>1@JzvN-kB$1 zSOsqddxER_G`;*=Fjl6@W&M2O(Ql)#>7*|bI5-9lZ{p(Z--q*m_E)i-9H5;%gr@X! zPfqV}KAxkrzSGVyA~ETqWIto6X@UwO=rp zcd`v752--H&s<)=&Ch^rjq3S+1uc@DR6j=F11`&d>RB3A;pPf5oE4ZSX?jYHF?_B+yFGS+d`)dC-fQ> zIn|VrXELUod#JB+X_Zy#R6PYg1e5DJ92{lxWtVjDdX0sqOCso4Hk-iRZO6S&o#EgA zqEq~x?|3O*^W*_8&UVURC~IMoif0rHtqlnKt;)faFYmkD^FB z7MjXNK#PzA&^ru`e>U$NJT`q{QTiWh{4>!1i3< z?VzWfzT4{<&eB~J5`xj6JwqRYLGbyW;Y%5Mv;kYw+Le^j!&XMl+j6J8FF_V^Fyey$nlbyM&YRwQNE6+)n^F*Z?OtvHjT}#^sNF7uqHfC%4dd zyHb2Azxo$E9C=QGW3@fec@AibZ{msRY2LdmLPt3qs80w7>)~t{^e7~A=?t(Pf@x)X z&=?|AHZig+nS+f4^et<#3Hv$Yl! zqq0~cfdjMz1FmAR9Jl#h9RWyB^_eW3`pHb5B;Gr61vaOr*nQ%?*naw1;E->BXI97Z zX{NF7BoGP?HT4P0r{uZlrXUBB2|khtCm7CXU5t|mHbKQl!ke(JaEBIEMT9ANT^V#h z??yCS(3Cg)=61`V*C;t)OAWFl4=G-@tZRrG8K8_Ad@45ZdwVD}aWEk6&0dRNKml&9-=WfK#E{0I=^)06YJ2B%p z8F^^Scg)UT&LP_fB<%ccXpxB1hk%=pAs%`Zae71TPcSLUFFXq_{VC@&)k)zGFLLcsjK8OwjAvrBUHBR<@wXJm@Q8Nq!uYm{r$vt`fT%LidML;_YD&#* zh5CyL_LwqXE(7SDT94u47k>=*{^4IhU(d0eJOXUTE)>Yn*bp#maNEizHf0tI2FWuZ zoFF-C3UC}0DTs>3ZSKnfaf%r71dI$X%qJ+2pi`{v92 z^)hU}@Eftadl$P3QsicuvlKc*#%p2%l?h2ukGnEHE|-2qg-8ZDu!QKDiLNXM?}0%` z1qZ>K#-J=;Zhob`r}1Y%X#B-k(Ol3}87B`PFdv8f6EE^Nq3HT5^-gMd2X{ z%vhL5D8M93Nj|`tD#@nlNbzB|g*%cM5PB_BbiHV}+90(A1+SbHa*&&R^Sogl@=bp8 z+6%Rn#p|7m+#QG^kSllmnVtk+3zsc(8Vor5#T|0yN!KB}(7}k*rwHq#z=H;Go(Lj< z`ak6dI&$Tf`hX5UGz?m(&VWisIV7`{*(n#p?|IR;ItP&Jt~fVI+T?I&Wvy~o9Fe2R zG<(c!XCovv5(<8q9@{q{F6XkkE{8ppfxA+FkTDW73ihx;HO!`-9k!nB)t6&!PWRT_5!V`Zt+jerWE<~DXi~*2e$vezlgTGgLZPONQUHGc`7B|v>vGR zd6s(zYiS*HUk;Rw3lt0makuOMLpKbl_0l>kV>IY3yh^82@@2ZX%@qGsuVG|k=996l zi`~Cxg6WeJj-hfMQNw2oP5qnSAy^6y;pJc^rv414?=_WygCK)s+ypyB@376gV*AeT z;polZggANv*jtQs?H>@oN{UaLU@Br)WkKw@wJ^-BFpc5DQnfaRs*=!?Oc`Wd4!Dn4lhMo!p z#0O?FLN84XO`#>g-Cm)s+}de{44r088A}B_z6QKdnTPdR2RZcv=307JHcm2{Kz2_@ ziBMibve2f5L@$B^l1v7RSw{ho=6=~IAQe#X!l_5@C@Z-U|M-@AmZeN8D;R`Vk~?V4 zh7kd@#wlCdJ+3Jd8nuB1%BW3)gy{^z%Erl`dAbm0w+08z!G2ON;h^tCI_Z#_e<)yF0;TL`b;_Qrv4DNQ!@HB8#ZWxsDKus++EZ15>Oa zdFjO1is~e^6K5K*LL#E_g^mNL0I)RNxxd99eBBAY|Bt@{Z+PVq&d*lGfP-!c;!YJd ztu(a~jv7cu#>k`#@dcsIhQ6aS2Eb`Qy}91gLcOmDG_=DbT>Sda9LJsx0|X_*!p8(zzCsvqIStkB4`8OKa6zK4U35)!tTz4N_r zM3(XyE}$K12?dRd@J=8}DMk8PmnFHBj0abz0m-8Wm_>76JlJsr_L6tOtQ0GO7BMboHrgs9y-t5-|PIW!=w^^M@FCrCvZ$ zvx6)QhZZiY(Wv3a1iSkHMn8rds%zMUS4X047*S@fiu_&32&fM@yWrCl> zep9d^qY;;Paqxw2#o;%77mmK^FJXDr7Xg>|C!Ac~j@brX&pm}R;|1}~#d-(Ua~ypB z*JAV1-+_ZS{b6jr_;)iCB({~KE}BnHH8wQdmFH~YTkdC6%+CtEns&xa#@Mt-%bnV@ zGqXV{KIU*}J*Nf0Q=n3~>#w)+BSu+gkLv5p)RfUHnwz}l=hR0i_+Wtv7X1wM845al z9ikZkTzedsA9)|{{?LDjeD>GSZasNuV?11cnnp67 z&i$WKF(ZO#ws{6pEY`(ZkJst9`KwK7M*Bn z8GD;8$`#-uIQ7fsjUEIj)A6v3NIiJ0%54Lf)cYj7(_V3r33g_k8&L9zxZbn zlfH!XAcFp@)@CKwV1biK$w5O)h2IC#wv@hp3FZj z$aYo<%FH3BsVT!u;KV;RkjX$MA%7zs%3K-vE8~;^*$7Hw${>k2DME^lsyHE&;=Bx)2&w`iq{$MYT%mp} z$mwY}b7eACZW=b6!dt|sHs->v)24u>0vCvhgej0fzd+_rN0y&cfuxiy+oqt>c<5Qm z2%_n*xoO+9h1X^E&0K+&SU&45h+P0{N8EhrWLQO?j4`rsdu}Jd6^QaJyf@Je0M>IX zk3NNi*L^MW_H$^L_XV5yu=i2j?lnu|ixmh8!b#0p=ljg6dlPrI(OF|6UE`F&k0J!!r z)~A0H=l|f(1D||1aPuidY9ao*Lpwa$Z`bq>2dUx-0hqpqecp9wT_Y0HzdHmM9w z&N6QOpX@*?z%VRfITAb-h$x8Ah#AfN7aTEP3lEE9svV=n8x)ZAwFU#Ghx?z8{jgrT zuNh7_Sn>{+sZ8IgZ@~}CnW|eK!!+#F!^?YEUiu0geZe;(AKb^9JQIbi8lz!464HfJ zPz*{^BXF*Zp)A?Cu_wXjX&gBlP8~r(Gjx8A)~eLe3Ud4%bS%P;Spfcb|6;Tsnr5Lm z$oaJjg#^!_CaaAnnPcq|!mzP4#fC6CFybM2+SL>t?erMiXFiDY4}K6hzCQ8Jyl^&x z^2+r-3ILQTVqB^zp~$Mv43QRVV}iR5Y8)R1EZTl89q}$b2Oks@Wwm1BmSx6RCUo3^ zf*%Ex4yq_l4keT^3ZO{`Gj+C4bCyeR1gE}iQyENF$S67OX!3W(y_jrL>2shhg9@CE z3iQ6C8u@F4KzdS4B%6>`(-d zSD{i3VE`E*8$!6K42Tqr&y9o%rKQzv3?!?qa*iIQ&jv?*!NO;%t*e}3p zI6_&Hg~oJyA2@pvIJ*OEFDIO5*a>rHM?XIYVvEFz+?|gAsOLDK&bxLDcNuli>2X*z z;brnSV0VUtH+(JP^fB~EthYac^}Rn199|oI6Y2KwP5qUkx%=W(=x;rcEM)41x~^}h zY!=OQo!e6YQO{J*eOeP@l08U1UEj}|GCTzz2Fwj|q=rR+<%ILxNA;z@rfU>J6a9tf zKz15+2`7j~*B;02#pm$gAO6SaANx00Za#%}^bnTQhmp5GihlQb;Nbdb*8xSfW4YJw zaB%AKQ@@qHGkrwQz{FJjPTzC+Nk(*wfrEn)(az6Pa8;kGl*}?zz~#Y2!K~{Fz~+zn zq>sxu=#8m=NM6%;#}u$MWoa<#L=1U=^-h2L1g~jTG}pIiz@1+wZ~jKa(G$qs{fhZ` z(l?zLO{rf;z&076$bPEbglMQ~A(EZJPNae#gJt07ZRZJPoJ>#eRD#Y~0YZDikUXn~ zyu;XrFPwR;>|A~1=#+ip$3b2-#JjG@3P5to3(5=-Uw-K10-I|mxcJqd!FqPiY=Ze) z(<<{|3>;9V`j%{Snr-DSq>jNS_pS z&NY~}?IfuBakmVLBX#7=bQossdV>~Cn{LLXk3c!Vj>i%X$%1wOGB_S!7*5I?^&}w~ zQT^0(*I2toc>1^mNJ_#W9z|$?q264a=m)S28A4O`JEV7DTa;eWST>M>X1xkSK=~`2 zO+-LOKZSLeaH?zNt02Se41uVx@4F4RZ|U^2kU(4=@x^4E%4nLX5^DDw5+0Xz`%sgy`5Qo76AzngM?Xj1mJ@G2E!wvA@d3CM!(144(z~wz)cPX6^-r0eE4y+IK zJwt3?KwP{y*7cYM=0%0b!rh;?0NZmck35d$4gVI_`*(oDBV4}c$I$P;h&VWAxu}06 zBgR>ohmso%y1Qb`Spf6b?fDBSzU9opkQG$o1#rr&LG9H|mAf)66K=~vg{njdPUEBY ze9aC9shZ@)v`y=h>s{@0lJBB{r_@65s;tYnocj&X>7G7<_0Bz<|1WSb^yqVOJ1CpBX zA%kxkOYQQ3r%grh~qxVXYIlvu)%nNMrKSXC|>1h7XUud4%dQ zkMwj;AX&i1!=fgyE!AZRW`To%(Ia075J|{*W+M8NxYC!HFy8|t5Ox}%&{zADLk!o4 z9D?f`jMUm6wfEan;tkk7KzsD%*u3GJbs*f1Le&#-c#ODs9+yA+gG#^%&T6Y;^ZKtw zd+H6y3@nF-*!|kS0%F1Pny*A$dmM3ijBFdk#U1S4_oLW-;O)r6n*?xsfrHn*5u4Bc zYQp@`OAyN;732PMSkGQSw1r3Gbs(_A`k|l1_QSu7JeW@IE&2&(3z-AiSb%#^V3$a~Zkpe*C_#p7<^NzRu-DmNxr!Voy^^I7}=Lu$_ zHn$$b#c%veeENU-Z_qclfX%{oX4znO(s3;SuKVV%=}y`ZUg?o`b)|x-3Iw4HkmNg| z>_oQ>^b{ujrKcfDdQX+nMmS58!6_>)bm#W|gx3dYx~GB?)KLeh09L$Cww;=aEWHWh zlcgejeFwDAc=&2|z#w?TzEdYsD;T1lD8L1fO|(}qV|`!%FPl+=A;E%_4H4&)yoe_M zL2d}ymG3ZP5im5~=Rtw4I;8(t;;n}4mlc7o0C`jcp{{wgdl{}QyrV?@71?skZW zUWVmmUygXmmtgafFT(PQH=@1ztvLL;KZCe_1K4c`y&(Fe_*e!}cy2EcC)cof<(q-? z2Z+OK=%08W`o(=Y%Gq%%?dlO(c74S=^D^xS%nv<-1%Hw!4+Fr_L#>(d$1>!!XYn^j zU1w$7Etuw^Y#&VcZEWIwgT3Rk|mXZZ;`Nwr}I4oK;zy3K2F{IxDB zYqTsh$eUB()~k`rDX=*N4ix+tmu?uY>PL(|hnE!ntapY@M3`*>rYtVZ@XPo?* z^?Pp5UHPJ}75F*c49SGs0H)x{WmGTwkP(-u!J4K%x{Und1=35vG~N z)j*Gcq3o9{mOTsL!EGG8=5ulQ`mY7<-Bqkj+6Ksj^lKDSP1M;fY?CABtnI?TpS{4V3FhBJ$ zarKcAl9zz_ z;$4I44wUU^qyu-zQP!D}l5BKhmZFmbPWCP0G+%4|m+D$h=OYTnx+)O%l{~aerH^-z zEU^nM#0O=mNDjRoMsJ)Segh*2RG=tG^{{z(YsTwi!=%P}Z&v<^A<>61HAVuK7j_bJ zTfVjd^v}uQ%zcxly7q+%mD0!JQ)oufpQ}mDg6#6HA z2Dtxmp z0F6L$zx$;hLEce&J+Zv*cTq^&0-WDRfA9YayzqXk&wmJcd4Y}%vMpH8Zlgc<0rcm7 z75#+|^7`5L$}lku|?MoK1y~V2c|%PH%0-Mv#g|L!A4<>b{RlV zg=bnod=Aw~$)(F%F8Au&2ze@GDmOn*%TQCc!!)08@^wvBL1kTD&bh_3P&$Fbhk&D- zz~)HxXS`?lrd^FqcvL_oxQh;wi_l zO&-s`+2QytZ$sn_V0VGOG6;#*(DnBB0Cd{17W^)niqT?Rc;}A9m)Qzs5`wu3vr)xI zQ02q)M027}8qkTLrsUWs^rBRGz_#lN=aF63uvyvwxg12@Kp)Cq6R(XV!x1?bo81mX=GO`t0d+-ltlS zs&IzT(~qg(8eaUYUpF?>Qc5}790A~px;ANm*A{`CKZ{%h~R`oVW1&tJgu*}oG@+W>8c{^6hD*&A_y z{#)V~$vRX) z2Lcn%4U0d90iv6KTOPy0rv424+)mh{2+sMepiDUuOhLeKB71rO0Eah$!|P*lE{0(s z&5W<TuazE+3>F=gy7^=?v+c#zzo9N{}W?INt^7+&+Bx6<2Wek(`cdln| zZ-75T{|>l9@)M9ePi=Zo6@s<0cOC?qzUJLz*K+PdZKq+;@B7c-@blh?ldt?^$h&uu zjks$3t@m;f;L**1tAT4}2;QJ4)sp=7qSrAkLmi)Y`%rwJWNca&Bc6gG9I&x3&x!pSCk5E?|n5l=(u)d zN6&Rh4Grz)H9UCtkK*3Deh#?)m;xFvch!_oFmuX)Om@aWI>rtw_Z!LZK|jYAAg@9^ zcL0@^5fiN`D?)5y;ez1MR`qHZ7{Q776)E^7w+!}pk~7?ZCE%<81bVC?5MNkj)P|Ct<{Vt;`xKq+H^E`B6{33zPF)|O3 zmmRrXf$ilmOm@hD$?&V)!|P1toxMN>IJ}Act)Ij0o!^JNa~s)CfRl%S^A{;tZ9&3k z)3E*AT*ta?ST9#(bi_u{dnWotqOS}3+L&~?T!GCoQ^Au`7ah${{T$995Jxw7zb(ki zd&v7Qj_BL;**-vf=y5Dx|L4%Y_B*kB&7Vbk>z~E)*8dxpulx7W-uh?I-ukD}zUJS< z@-_b++SmMPEMNa0VELNwM4a5zNw-!+(O(97z-na`?V(`O@-Yeznbatx;6zLdjV*5~ z1L191DBgtvDwmn)0T zUh02)fp&U?)35$R=-Y-&*$_Y1PM!pinONndBODeeJETR?Dc?nP(W@^iuq7Pa$)ox? z-nQ*_7iA{k07kHTN&=~Au);CXI~O3U5kR6MXvZ!jWib%YbcO&nc*QRAtUwFdPk$Px zk}{bQfkLTR4iLK+@!%KU4jkNIi-IRXogv`U{`L#;DP?erRP3NZ->ain?zfYy7Zc$In8 zf6C4VZBPc#%1$WTB-{v}yK^RH3QHP&5P3RIBnKpeUHF52Mfl~iqTTctp>6TgRGDcN z>4n>(@v>CLD-;Yevm}~JKO@zKY*(fOa1$jZ0L+a}0#R5?m?lAVnNkL&{Vc2!zP<7x z0kGiP7=|M_^7 zlUvB+Tj)m*qaWQuoIFzBJiY~7d!!c9k|o<-WtwE9K5EmWet#oWM=9Qr+*-a8lOc?;R;5Ti1vK-ntLj#P4{`(!>1i<4-<@MS=+p_5Z5pv85kc)0}pQa%!Xf7vR?NeYd*9-jevsZR9 zR{}_Bn0Qcu*Y1Ivzgf2-kH1Ue{WQrcpUNLu)z< zXhJ2y_lRY3>W$eY_L+`FYm}dQRRLwZr^2jhv|MRbZ@Xtjh8@a}yq@sBUZA z=>_5zlB-B%9WeC9!5g4;TC zv?#&hQGlj_B!byL`Nnb&<^e2wYFATBkk2c2yN_y@G-8HJs7-6!SU~}QSWjgtB$O;+ zw=KYSd|7WqaMz-EG=eGt)n@Q2jPf*(k_?Z~!JpZ-NMC-?xQn=8H%0c6_2w4qi~+9OPJj z1di$F{vG&CO3d$E*KNW~o<37B<)9|!KncwHY#2ZTlhY1a9C)fma3xe%aMwpVre+})?>X`9p3zhU>+@P|5YIR;%7JiDB}XLqrA^a&il@!tl{E|liiRE}QenSIr? zm4kvYVor_Fo3;r@YqhwUj*k6>`b@z{n**#mNN(oi9BlDI5BxJcARCSjG6N-g;wh&{ z_^oCVDvU7|qO3^nIlnpcW$>y;q(<-I{<9-vL0>L#=Ux92*|pZOjAF>Hxo-hu_Y#(I z_9P0*Ve+gV^y!s7C08p4u?}jLX+W2gHOkJ!Nd`$PhhZ9Er1aRXUBN;694BQsGNH4a zhRkv*jj{uP>w`)a*iP)U9;Ru4-;-y@i3d=IDMLYxGJzSCk;G)D!i%}d10KZyWO!1E zb$G_n@HIZ(E&GlR4^%6p&UHNo%55Pdga_y_Lb67*N?T)KJaB ziOG=LIIsmi4i^>{RoD-cf3F%xVx{_Gw#&^;_#$&SaUV`4hV47|=^BGZgIM#mm=};C z*0TxhDpwyX#nfIYl%Bf}3rXjqwhRYd>eqc%RWAVZLM^?+%WWoKYrxC_+x7?yu%b}l zBG>VT=k0dt%bh86kje@`u+4ZBBZ6X~=eb@WvLX74Tn?F`@+Snx<_P`n^SJ!q{yXe` z;(M@r`}bmf$KS&4C%+f#zxrOR@A!XXef!_U?kB$&yLbEz?Eck%kM$@18g~EkuOlDa z2ab-}cV4BxJ{|!iCVEcg%5e(z`j{^gS!aFxN%Em&qi7GdGpD@+Q$Xdw%)h71ioZG2 z)52xPKizjxlb=;B;R!bfX``E1YI|?`qcpX6-C- zJA%j8?mIEzHtCoHGF8_;Dc{cc0I1BoC?<;aCQf7`ZdJyEwTG1y`@LIYRRRJaiaamn&pvM1VEu6)1oVS3;ruRLXLv1IHuc~T|3`2h1gdGY~(}K!IZiO>LY_k z9ifnfhXXX)z*>~uv!>a|3#c!xhXW4^bs*;U_>4Lbfw2aSpS>S4kT!gZ8Y46kg{i?W zHDwAeinbym_`~+3816Qv_v%3X`Wjx9uX@lZOid1_r!B1RbT;NT;&wKMyBILFA0j*{ zHtLs>s%}rdfqlIMcIVn+4jGQd9bCI}V0*6fSSEb+$^!PH-@6O74q$ zK%71#!JEoUIJqExnRX9tI1*bMkO!Qq%ME}-B#v}1gs}PHQF$9{T`(y_x~%1Ey4M8D zq%egeG%Bx(`t%%*$vig^iZ%)!Sx9m!94+_2Fmy%*(w7YF{8IfE3`9EyjF_$+=+D8B z1B>NY!OxWG4AH#cHL&X6L9cbj+q}EBl!r2VZNjr;!nB#>BAV!PCEKdeYxV6v3DHV4 zsK5f#Xj;{P;jo$w>=dY(S7Cj0wy8V@+v}R6$thbD_U=>vA)HHQrpy_f@i84`cS4TN zZJPhphrV5dJ$r?&egNS7E)HJ(1{{9jHv{*$3pBOEs%zBTy)#Qe4R^}$ptmI!PE(+v zwFTmq9IrD7T`y4OG+Av!j=-W_MZ`4ejtg(yP11z#3zNcmQceZ8=auuR%P(*sMKrJ#uue*_t3E9;^$x|wGLYWqi93&flQGsBNj2PQe9MJh&Qd+bM>ykts znw~29s7|h9H`_2LBV!ZJ2729=ct=sD%_J}Nnikp0g!N5-#PF&yhN98DJiRKL5PzF~vmD9&xWJsVNABZ1)k0X#>DD%->mnAjFj6}K??h8gGQ z?#pFT_2ItNt`rmzT*#PPv|En>C)a_K6U51NWpp|a3)+o`5U1DCP9H)X9{}q)NxnTp zJH3JB`lFmhTQAXWy#np}EnvL>a!cF$lFvi71LXD$IJ$}D$U=#@#sO#9z}Q zAp8Ye1y;5hwy4Tf`cv{DegRVkH5D98GQ-n}l0 zBX&-m5#|U^pK%(2S(lgsvIgM*$QfyUPbyPoF}J*c3w0x-JgXKdLsImfs> zJ@~M$=_RT@^SH!hImCMYDcpb0&v0F&MQx!?V%C5*%4gnGFo#KQAv*>J2nZn8ow6w& zoT+T~daJlaq1f*>!#9F$cgk?}Y1)8tL~(TBZn*fnern2#?*!Akv6}d^t_&1LVGh2t zYu%U0Ny0Vw)aMbzAthgCr5D&EgtK#a4#tM9&7h2ND$X`Cht9w;0cyIAwBQ;^20~hw zMDZZpo(OB4@qn_AoQAV(k(QJwuRo){)Rdv7`9k*>oV@J23ULcTDWDC>e1CLCM$51v zhCwZcO90%))wZT$G!RqJF@eCpu8-gDcno)fjA-Iq;WhOK^)=&Gj?(R@ubhlns(b{{ zw}|x|o3H#Mh%f$Dw3mMg+Gl??;>p)D)z^2(7HF@06WVLO3hi}Yg?Qap^Ys`Xe=nBT zeK|H?^Jjr;PoeM5k(c)o55EG-=X@3L>0d{_@KJ2O`j2CI!?&QH-=TqwhUIg<2C)SC z$KTHd&aDC4bHw3-gU@*@;=vunjmObm{U$6g`CKfo|4JNu{x@Lr+PCt6#V6l@Tmt<= z|9ZT8ER5?!r>0EZW&@nPh~<@E44gj3ZS1=TSbyW^xc+3OJ0=GQOnjVV#XM~@Kg_?$ z`OHS9+M0j5yr*aM@d$P=fbetuHOvMmG^&T?>k7ODpFYtBPGy{@ZuVqHa6kcNhJyA9 zjv1b-G^uvD$QJt;3rcW3!JD97u2quq?iw1(DDX?^>O#yNfUu~sa-Y`Qv z37ZB{W1rCl>v4WS0UwgP4+zEH{q1q|t>f^qqPk3$FWFH{BXItd^ zMx>r`^g6D^0|apIX&is)SK;_g--g|t7daANSH|$_!p-umno8Uc6!vh?bDQ68TI&@A znaqZ;!IJl=k-fT;6J?(YZX}b@T$j!S1WQhgxUQFpx4nVe;CEZKu_u%6Rk!S_!p{dz z{AHWqJHTcMJXkw^@RuLp$^SdA2tV7seUGW5Cf;o zF^78V<%rWKfoo47Z@wJ3{t_(LpWv%3u04)^?InntFGXB?678W^qTP5Lu{#GIc{T9J z>yXO{;`Cv}%_o6_YiPG#fw=iNgOevd7kPAwcKs1-Zaf7X-b9`}ip^86(+EMM)T4*6 ze&}bhefQr-Ub~LIc?kK)=OAAH^=PmBoxnq%g*?86wpoy${6*~E{g2uHvY7}Wd@F-z z{11>9msmgi)5yaE;Os7zmwW-@`eW0H(sqPih55^0kL1GG6a|(VY zenWhP489CI>$slj7{J*bEH|&?=q-N$>-h>mi;}h2GyB+iHIoU+H5ffRrwr2500VAL zp@0jh1sh4|sRbQ)w+9k;vSoJk9i10RM3~sV*4r2-U~*>UUDv^U&M2kY5nxkY$}juZ zBJ5hXWU}kO)E&zhNcXI;K?h0p1rg`C|E`}v#_@D!4W{gyc-xiDH{Ts#gxWW8z~5eI z>>XA_+fyzo*gGMT4a{H}+CKRtF*IVlkCE*u+va{ExRY#IN>uHV%uC9Zk3Av1m<4KM zO_JcUoJRV+YBEvaTC)f+@S?Z?fP#miFPwtX!f5T{N|2U=c0=ruI%}z^4b#cGtU#}L z9RRu)l1~Ac@bJ>ZCjBUR2M@RmBnJ`6fRVh_*Ek?}aHrQFISYkH-ZX{*PVxFTZ@Mc9 zh!KHM*8TciDJz6Yh^Y^FRD2~snGFo|+Z+RQA44Jv6!&3x=Cm-;ed_5A(dD!|RjdpZJkY^wM7d*j}O?HynNIcLD7t;_wu^cl`ji zKl>xd8!yotiYE;X$w#Ed`De z=C5T@a%5QCPqjBhqQEr1<^`EQ+T9yTPHhvI&j1r@5heoTWtxyBC?~D*&d3z41xEyp z|LlBBrG> z3LKW!klN1c0H@WKb@rLs_ANw)NOa)^&;d6t-t}wFoY4uLAk7Shuu0M|d!jAV042zG zkF>i^(G3J*2~LG2u*;6~2U~pqw?2X2_hmP6eomWCQE{LK(aUY`lQqOYPJ<|T%Rtj% zf5^n~Vc_ZW6>s~#Pvc$BT;Q?OhIaiiY(M@^JpFzD74qm|(kOJ|a|cKLrCV~Yeo3fh zp=%mPL51ZhvQLNlneEn@>3EJXKUDWK`Xgp0IOQe!gJs9H_1ArhpTPcZr!T!WL{mW;9(_}e1)35N zGczHFJ~L8ADpj79#(e{WUaRiMD9ZK3-M*r`Kp zRvRv&V4%`wn4Gu@h80NtfNOcsFDKlm&Qti>0LB6woN^jty##g-rgFxo@y*4{0kG8q z=sg9}BG|*zX(hjfaRn|P(9mip3`r|o+oHn|4+q_$ep8t`*l61_CC{EYdk#lm{`+zG z=0Avj|3&1|aq*-71=eRi1swShzPY||4+$bfGs_hwz9J|2ayy{hIodZ38~|a0pFf1` z81WR3fqf^Qa*hR;d2SldvMHG`tYy^ne6HvI>l#Du3l{<#?yIvzfhc;9I0G4H8prtw) ziRcW9BG@;=(^S+G{$V2)ofZu%fU|pBeE-{?!0-FA8#p^J!V7LqvB2Wu0Dzw%7U7Ap z0@Tkkf#U<^XPRv|HJ<|?)=jGfa?!2Xh{sd8ULr^y^`Re@m{7Q-8;I;z{Wwwvf;C%hxqqcWsa_o1;fj! z+PncA-5TXLhvRTB<7h=Zy3R7k4+F;!b2N1FFmQ5?kJOyZ+f+$L@VU ziM;c1L_0*BK8b_3{2?wxT=n+y3O*(|&g1(?BdirHO!P_Xqv+~j1LAu~7p)I2U;SET)ZboaMySp_L6=S&9}j}&tjxqa zs6R~dVmdgmD3}C?uZ!OPYh2Z?SB^!X8 zvmCL4kp?b4C1*VqM;no;cUE=ZW4nH{e6S;BEEr(;!|n0RLQK>wHEOEI8a{W%e4*3M z6#SszAwN19}@Q@6QTmvl&Q+BX%*gzY_`DKM>V=_7l^`p{v9sn?#+ zk44JHC0q10x6eEKqwH96IxZUZBKxYz0q@2#pPWroED@F|eyIWqxUgz*JYh^wf5?By zS(5eu1EpxT>lpU0(RQWY=pL{gB1j~B*AX+$n(EwV=tS*kV4ljdN=U^({Y{im5ddAs zd|%8>8H2@!-R+7h!R|{9nl4jXQ2p7N+F2HW`c5z=5#7Tf%vcl5ZKpS?%~k2@p-L-cw=YpDBlB`jHuQxYHDam`val7{O$SQNBJ?-=j;!reL+~ z)jB8PShA&iE)U~W#8jh(VS3j42s(<#qE*q-vTivP+75J_)zQ13N@mm*|FPWYcR)HM z+(Noz__~aBz){H1C)3_~AFemSSNf@EZWp3`;c42dTnd)SF|i%tP&`xJ?s8E7)_cia zeGQEIYMP!m?RZoD`G^6PKYI?xzw`HEdGhno@4Wylo3U^;!5vyeM(rnBYgiU9aOHhY zF--lLgnHfsMOvS!j!Vg!bs< zpoJYa(NjMr;RF}gm)PkGOX(!DK*3!~5(#!gr=DoY6cUaNbudraiqE=KtG$lo>xbuvM8p2cz z%2kSQ3_?XWtvP~DLWTm!@U$3|xU$o6;;uN+EQ=q%eZM z#q?F+r;yFYWO_vaq24!e0vcC^r=-(H&mF4x{Bav$<0ymEhmwze=6W{p>Yo6stb{hN z-Zu<}RY64NFzyAX6yCJBx`@@?@}}BxkTSX*w3x5;w`AWA)$QyTBQw=LpuhTtuhowA z)p%5Pv8C188 znQk(a(MEPIM0+XRfX(e)2?$G$yohnar}#aUGeD+=f19>@w70HZy(j&)q4#54HSUuf z0TN{YncxFP+3x9BE5Ijj}~KjSvbyJ0pynB=)=s4}kWfYG!@h(^jB zb?e6@Qw84?Fu85pO|OaLP2zR`1suNewK(|Fw_$y754m`}JKA3-g3RYYuAm=WAbi&o> zMcJPI88N=;!Vfbk{;FE?J{u5RNS*CselQqVj!u!ce*^b_<>#42SLynb?1jkdW`c{p z9dL%^%K@MH9@D_WfpDJ&LgEdB0y|{GOb1_PdzKYt`kcuz4N$w$=JJ$P{&7Ghne7Tv zil(%6-WA4W5R@aXFJqA6>=JaAPJtL;#>vxSni^$)r~r-h5nYO={7pVlE;2{P*LZbg z`3nXnGhZh=lfo(`#~Mg6;DgQ)a?m9ik)FG$!F!QML3+YF#45BJ0$he|797N2Fd^4p zGs_H^n4JW$$~f4`N$5a9t}^h{1Ql)^TIcd|7(ry%-UL(F*mVh_$`%C-gB}#l6Oj_* zJQlbgGJ(wLa$JT*^dbPGedCd$PuS4vcN;qa07tg&(*mWSB@LK|K{04sBk9nB*L{Z5 zIT*$wo@im3`LQKOFhD-3nI8>#a1Gn{{VdjJKFO&yfbE-yZetc|hz@Lc-&lmpsV;QS zMSTsoD|`w!^>0g4xT?OY*0Tz_jk{@K`cHhSMoiazTBHObKMz!*Mndyo(bOqWa3+so|#@vxWTZh3~YNWZxc-%oEGd89bou9%Gc-e z4DDdW@z?$_M0*&qUV=V_K@0VteXu(p{09a#sYRx8%$yd17Qv#N3rGFLpQM}lLOP@t z?J^(=jkqyog1lBpBlM=WyVuYN202zfOZ1(lVRBl(!l$+E*nCa#mBq|=_HUN52lCAe zm=h|i^)#(5SWb^{_KW`<+ZP@nPHr&k(q-2}K}}A6Cz)v|a3EQ5=3tg7%RDO$xL$%cwNKKF%lRV$?!%2Ch=BpS%VWOpa(2cpJJm1P zr6ie?p#=M%9ewDY{~C6PF8k5<#s=rK8h;-wom?cCO9 zDs$!1c%lQ>9s-W8?YC8eHhgLcB}t z8+kX7X(M2 zr%A80#X_SE)5B$8$0QmSpY*d#qOwo3?SmbqS-@@V?Avsm`U?POFW~6S--P8QZ$#d` zP3IwJV5bsIhZH8zbUq0kK5@+6bwBDg5xM#RI!`j7oFg)o)YGJbaX0(4CAdcF0c7@( zacabY0h(}1FeniZ!$Az7X)rmtBykdwwPcT$DgNR8?5qPhWcaKikVgS%*{g8&cKPf8 z4$)uyB<{WIo!Zs99l=(~*>nxb(B4rSmK({PWjUPzc95YgTnhHCH7wl(btc6-R;M;i zV+dzwnlc$^nl5tm%tx!_c|DVk;;hZWN?yC zds-2Qwm6rw13icmfcRkua1J&Xz?1*PRQxCQVH^_$&S*b z`D~!c_Vl%aWS)vGp48eU)@ynRiLmfL5~8agF{&QBNb|hE1kMk#dK$l>a@D*p$}xzt z9b?xPREL}yNMbTL)t(%N9wYVF^OPO8zF77oY|`jO+Z+K=Hhfyv1TUrM9;umVrN;q;}hG2t<{S9A~`=e8&G zSZ{VxekMV#or%Jw;1~ZU($w{63^n9_xkj0@oDB`hGf~y z@bd|N;{)-x#fU6S?`n6Z^K{>Gujcmo3F)W)qA8HDe5?Lkrw;?m{$?0*I26O-a!}tA zLm;@WsN`+R0M0a;$Sr_JUnXbsbj4=C>THdh^T@rxvECRDJBLZ%x`WYaTXVrUz$sqL z_x#BuT^+O|fcr0C^Rmyv!JGeG^m})a!B^!VfK^+cXB*HvN3C4}kMF1Go;vLrTGYF= zK;()Dy)-5{ZAItI^HI?GdH`t3B$P>D>k2nkt+_CMz3cQ~1|XdJ@|iIyU!yT~0}_ee z0$qUsN#sSaQ7D=&<)me1&E6_C?Ifxx5*5e@#EvhWe(;O`0_QK>MI4;~z?l9q?`(hk z4K@;Ba0p1od2xlQq2JR$!{wTI;&R+ zbn=LSg0pGD+pt#fI$&{m{?D~P&IS>6?Nk$FBS0R(E`n>!SV+fps6Ov@0ERzgclaiH z`*8+i3X;19UlYaEIe&+)gC#7Y1at12lUb>$SQPxE1H(rKngSl6nKI-eIH@@tL;ZFo z{Vt&pQ(2Fq|TiqM7DOeIKHcgP#}z%qC3-wc)Z6Q}7@dOmEYwxm<|e z>Q+L__9r9a{!EAZOfZ-?6?lmbMPCRf(Qj5v!{T&nI%6?8pl~3dKDw_>4}rwtBF9JcfFapcmdOFrojZ8X<=EfEQ{(?ndxuAhk;9E z$n~NIU!m7s5JI-umd0rf(-T@us?jY$<-=&q_ujwQ;lVa>cA2=?CC;`TXWNeZmx;3# zcyPJmV%KrLU2(SSINK)9){gUC$N83ZE>_?Yz(ohnc8SX#IA4K_p14>$w$fMb=26fi znr7!YKbeWX##I%D2jHf&EVKd$GE7UsW#*-!wiAe8}v+QvAVpkQe_ zj8`GWa27Q@^}9U{4T^GWJj#S9VKT z6AXh59diFXsp7TZO_iSw53RrYa<@}o{%JU)4SWg@|5hIkjOwx4Gd&<0mJGU{@2gJp zC`^3wy_ot6@y35Ez*I*r3qLo|rjde_Hp_wWRN3sLtN9GCQ}D+~sjk~d$-HS-S(GU# z0EWYl6#SwUW;`Yb;?b^ga2eCcv`Owt*?Vr9MbnFeZEq&M4dHBX9b{!aoanDYX_$?3 zbvWAeEyHgI6~1TvpL8p8a)g#2(W!Tyo%NRAhs{gh4BWp1L?BnM!2pAaV4Dd}KV|BD zP2iLm)r0bvIuH>puv-(?Ti~g~hW|fZe;$ABR@DcB-?g7}e#1N7d*3?%0+-9E3{k@c zaUyt8B#PK-3`&xYZMBJDEUQyVRi{&fNmo^;%9&KsDThjI2SCdtMjTL#h!`hO5JXf| zMj7tC@AR90=RAAWAM5*Fdz}OQyr18D&Uv1_*Ix5ldwlL)8tz$i+%wJZ8sm-wx|chIBn31+rI=OqP6{M8Q2OR1B*@(jX(56uc) z!hy7}P63?9>CTs~#n$ng9|zWJI?-gp2yR|@S#e0(l*pBPD4;~QXx?C4ElB5`WQhhP zOa%vm&FXo(!o`rWD}W0Ih>v(xXmdVuwkiDeys-zRt?=prL5@r`@Vi+#HCf5jc${T~ z_ckpOi>{Q1bf)N<^iIi_%Ih*CUrU0bfa(}Lx5B52fXc|}%E20KLOP>Md<5|X%LsJk zZzC^L?rg7>A!r8!h3Hp#!B%obe00^MRXhb3eJ20Ot8}umn+ga*Y9v3#@6P*`W)vQX zR?(Zk3%!Ev{4U;t@^y{KiGH@9yb(NslP*dIOo$D@!NXWQ{(fBintuwMSsa#1*bzLm zwHae-iT!GBm@cA@ojq}2VbE}LbdG=evd80Zz2F*7PuB{akuV^Fk*D84oW#sTrWw!~ zxS|b*_hr44k!|u+6|K<&Uf&bsTj&S+n5{nl2MKByR06=dO&JI@i@vpgtm;L3d zI5}nTO9?PIgVS4VPkoKRM=~j$&kW*@-G$+i(;d9@``?4#`@w$#J3NN(?vDf^<-yKW z_5H5Iq3T$@PeeC#GVE0g&SMcd;qktA`5&T?`c64(YK&w7It`lb(dR{g58aDn35p(9 zU%=gBE<2LX3gpQ@gYne(Q7-;+!E}l)wT5UDKMAkyPUAFMBu>RQ_Z|l)a->EgAPa&g zbB~wp#tpUu7+NIzV1gy~L9R9qca)C0b6QXxc`h(FL+)5J1AL}_^R#K$G!A4WA7NSp zWQ(FetxORO!oz{_w|c(7W{~JCD@U%&bf4wKp#;K9ZMuw?0(O2^Krt$K{2)v!liCuI zabqa18WK#S<`PtV)*iiX7Kbi+RcU>Kw!e?*`LD$EqQ8&!g1?LDh5tF))yKwZ(O%$G zgA+fjdSiyuxNo9GZLY%^d&d?|Mzbx_GPid?{E-w?&KOCfr3kHj^LWsUpb_@lCKQc=Uz=TOS$oEA@sO|4y|HXd?*7tdud-OizAL{~4hGOc*J#>BaCD_|Fz`J8I z1%cQqf7d?n*gKba;+;!8@va5#zqY^=?wat#yB2uDoefXC7T=$E_X1Dg_xrC+c*30x z_uplB;9A4|cQxF9Z5d_np5phN6P|Q!i6`9EaPJ+43(Hu;V`ems;FrQ?aM0ks#*7(V zOc86@bMKUIh(-&8i?0(OrGJpkcYuq6+m7Mi{n0so|82ho+b7%aS#mb=VU8i`!9&vPRfp-P)IoE^fBG)kX3C_g9Fs34IT<9? z25A(pvVFoc!J`0^Wusf8cu-^NpGFQ~5x6aauxu?(HYp<{)s9*OT)4%_ z^js*eQ9a=U*JvWkBTljp9>lYFw^it2sF4~hVGRagj)lqTi^)>7nASr4IawEvm^^6R z3vJRl?Hu644)U~U;}lls?m~#K9-~R_>8FfSnr0f+qit#}R0}$d(`fFD2O5d&wCBn< zb`RP_ozZBOO+hPd02&cwvSR@4xiM)XFT?7GcRmq*^f25z+WHXfE#cEYS$^i+pe;1!5PGZ=$vE zTQK7XKesQ!cF>4L13#TO3Z{M=U*B+Y6F5GAxen?R9P$XpvH*^60Vj{rv5*!k@P%UD z=O3uF9>y7TOQtLXQVgv%S$llZ}uku!WX_M z@P)4mZUhV+Wl(ih$t0`i)@#+pfTi|THj`fBkR%uQx}3aEyClvEO#DcmNOlQCy=?L@ zWg~c20zpYDx z=kSAvvGc6Y!|rE&IsD)TciM2>L$WK9#6Vp;aE3gM(+tC3dBE_#p-RT!8Ej_oNCHA$ zCiFb~hcn>{jul`I_V^`Yr;bFgy+Qnaz@(S!homZ@cu^v7j5y%bL3k`$PMtPs**L=}ZJqLQAlECo&s-zM zSHJ`d#)ysD0JqMk{=_pUGG>U^c4QrKp~&7MDH@ZJB0>~NLF8b9g2HXyYo#u4Q{%^P zanRaW-{GYW)QeU?b-v<3(p8&cV1VO;;oN`_iWm$zPnBn#Y&Q{%OTo;0IaenXHgJ){ z4dp^NU|PbiJO+Mt1mC#?d;f1>{Y(ENR=@Zi=#PF3SnLnJqVPv>t8Ee@n&L8Gb&R$&EI#W?Fg@@b0Ovs0c3uT%@~6*$pJQ?V zGq8BhOJF;@F$J*EkiJVsD7XrL;ZpQ)TPNLVdBj!sQkU3F{uNyiom7#W>Jra|tMk9) zkshn<(lZl(RZ#r&ayT1`{1RWnQ#(!_R~bDw;mKZ+6&M;)&*YeV=}!I-m&8N*M;a8w zB?kx(=>va5!}zo@!E&~*&P3u=o||-9a!@;kzKrmdc9H|$YkIGrXeiGS?Q8fu@bci7 zS2;_USXsOjO*w+e-oEK9F7iK%a2m&*uTn6e!!dItA#^8T1qxa_!fnP5Bfq?4{gRKWK|GgC3LS#G z(Ht~axicv;~+7`SvLFPI#PNXgO>`qz{nQAdS_$~)_T zZ6$08gJsmC6Yd*4t?dfNXd-YaQ+&0alDE_`!7jK+7UD@hW_!ZP$q(V)eb|bcP5Bb8 zqa*>2jw20UsI!CY%(uQv^;vS21xrPGV!Yo7#k*t70LL(3` z^f}gLfIHN{DH82kOHz91pnCgkWqj(4pN%WzU3*27Qj#c!3w|rYi|Xve+a(V z-Kd%|%54PNw40*$nYb!ws;!{i1P>nUkp9UZOXjZiIvfEe2lH6HjaVqZKv{U$Q=E%a zOq5&Uqd1eBvPB&>5uC@4Cw9D?yf(zT95FY-0(GY(?B1q8jW0QM#4a%SJVqpem`=)R zERFPWTFRLm0kNA)JTm}&9VK&}SkUbVKE`xZ*jA7;M=2gUX^mUu2@Z|#wj(~ln_zO# zP3_|I_(XIh5Xl>yqUZ!_`DvNcc^y1ek&(z^^Cs_X#jeMwsMK=SlLUtVlGr=~=k z;F5OLb*Xpt4@EwPfuE8p6uNrBU3gm2E0qyU=~C~&;ltSd+^@po2`@lDy1|1V*(CWO zmN?(BrJ&O2@I%d{-&#-#2F0h>8hxk42U)~bpeXdlr|yx8#oQwcr)xQ4L1*f@Bj4=p#RaY z<@!+@)kYHHp_dYE=w-TS5zC@s3!0>XhisyraYC``3EQKO9qf=#19yZmNdU-eCQ4C& zJmKNNx&|Wxzup190Upq3ndDn!2@ombsqNnsY@jZ?Veu|K&`2W_3+Sc0Or}^*NmrZK#Yij^H>YX>^9*{f+FGzzic$0&Gk0Xn0iOtf1aEP`;Pv z#y=N~?J~UNuu#gPtl>!7NPko!>M|TBT=6Tuhx2JL&6msYa`Y;go%G64SDJlm#LS3u zI_Ba}IM{)kHH%4;TjItDN z2JBqK`hCBF`TG0deGR{G52jClF)*JDdXpDy2kMDa7OesE3OG9i&JKX{(}80UFyLf@ zNZPUu`FyMsF1 z;xqAO5!D4K^P;2D1s4ygv!)SH;$_7~I6V|_sSBNY!rpy$e7tnByx<`lGow)!`gBP* z_1%e=?Bw=GvGa`QV)waU13$hMw`1KVUo8qk0(Fg@9(lK-*+UwrorrtTt!9cnL zuLzLBxde8I9%w=aXpZKNY1#1lKRCzl{N`JL>mLSot_Cl>=%(-ik4Xt81su`=u&uP+ zkc--f;K`?0@vHhX>KUjDic_>TvuIB*w2g8_UpOifs>1|uGU{H$P3y7kTO*K$h`lz? zL853?QtaR%h)TR9YqsN@`q9FA#WKsNTw-wgfGr97Gsj`h?k05$T{Q~{wqdZ z0>3!TTFG{_<9w}!RKO(FxvHo+(@8j&dx!sk5h*$4oS>pO?tr3 zRsn1X3;gZ;LL&>OR1`y(molJIm|&EK8-EL~m0@lQHtuf?*DGM?xq@%^q2${zyee!k zcHDDnI2BpWHL{t&(9TD$qEE<sCZz!2MzKQAXyRiGvHvwzF z)@NL3%r!XxM>@C-p1Y=;iG|jxgmW%gLz*Xpm3!oWxne|F#KiX^jDk-6py_#C~*`aWKLcgf^PCBKr)r#^M@~ck&MEy1ko<$PKDXCnvtPW1B&jLcv zHDZURMasdGAd`9$fPl7F+eny30v@WUTqN*{`@uUylpnFZOsjc4Xz|+fVoXR02Ypchlq2N5RHC9JQVQOR zGHOZ6m=;B)V_`X|EQ|oucserpr)&;v3xo@lWQJT9A{%%Zjf~!};wR)?u)wllFo*-C z;=bV0kZG{}TPfe;hAiRb<)br!iSLKZad>ET#uv z5vn(z0oLI2Iu`6zS!54VL0=;d$$(<bxrk3yABv5pmY9I0%rm8p{{C+avf36(a}3Fwb(u%yue$>EG2`m`|k$c`Af0cq^|>5E3$(=>8DY2kG?J3AxAEp zK`wPbv4Mz!f>F6ZjQ^Dccw+KHUy<;HlQGE_>}?p0_==VqqY^*mQX^3|Xr+qy*h9|Z z2V+1c*z{33x`-$jK8FbilL|_R7*PMXliBo0res{G&YfQ|B1NCfSnN@3tQDdiB(FXE zj3Zvl5u=-GOl4TU(eKEYc8>Uorp8z)9`Rl@$7GJS9V1AgyJWgXLI_PpU%xxQZy;D4 zi|aS3x znV2fLbc($L^D*p!=fN*r1I|z3^BR8mFfc6#9LK;xQ(|yMN&Yc_3U`yx3y)A}GK=@U zT)2StSziNt;Kjg`Uj%#d7XnZIeE3sd2t4&6;K^SIf8ehGPks^bz!$(i{bg8u=F0>F~Rr2ArM1Pmf^JW!PPhhxK!|Q}}7>oq=$M!}G-@^yLNg zoy)-PRbcN9`2Jn!%PZ(Rm*M+&pzmCbA@!Zh@ZBrudw0NhF2Q#$!*}lhcCVr@_R$xY zqTcdiJlnYh-@OFixdQB7h3{R3?_Q4I`**^3?||=Lh3#AhcCNzruE2LLq3>Qn-@O9t z1rB}ZDtzZE`p#AKz02_ZJJEM8!FR8~_pYGtUV`smMc=)QzI!?D5l7p-4D4KCyO+_Y z3+T(s@Vz^M-79cC+rI<8yoA2IguZ(feeX{A{++P>yI{LlqP_Zz_e)m&qf^pUP0PM-|&(!CZw z%29V*IelDwYIGqlqr5@giZ3xO0~;gD9#cK&C0Pc2n=4r+EZK>4P#rCediC&MQ7R-6 zKVtO6p`?k)f`{e^Mc0&=$>xHN7%gPSEEgstbt9+1EXrH*R=P3bf#`JfILk`waQa99 zW2C7hYZSSGI;us^9El433=Pu>)UK1LmB2NGjX3>16Hw=}lOfA7QWTBH^O$-g?#&^*XtzHE-1=xF z32~wpd8b3(3XjxF3CR#A(MG%_G>JNg)=^XstFM`5RrpdEb- z)6pl;&K`lCJPbSe1aSBl!1eb5z8VdovCx!^0fre9W;6o~9p-D8bLWfCXe}Ig zkZCYDnsu1XXqb8Qyu2!m?(tk2sNd>640EhE=@L<|I@`32zo9GLcqujDEHAnjG&fkB}!a1bA&!6E0oO?@!c&3G8UmH5T3sc73#k{PIZ z;VE1RpGi*Yd5?82Q9KGdII7|jGIcL^&(St}oKOwKbdE_OoV;NiH83#(>!7@V)Z+!J znyPXjr$h|^jJwUOl|+fM>=C2lScX`;6gnEa)y(2G91i1pGPcXLK>>=3?mhHEtTyK; zs)zqD*WsWMTO#Syt2M}53qP%q`bfam(Qcbyh;8xE8BE4eGF*F5(Wo$x0F~Jp??b{= ztEyHWdN2m=%#v9KQb;MDz6(%wSV971Lcz&2{4N+y2c}zsTNG>i9yqL*PT1H!&nQaf zvpz7AD_FefbXs6~$v?uh+($q91pMN?@VEVI^bfuZ*uP`YD}IO`(eCWYIX1uRx$su| z^_g?%Z|<<23AWq~W6+{Cwrd!}wAu4KJ0d&cWqpI!`VL^Vf?e3f?w9|!fbGLBUB>+O z*W&zl{sVC7F+e{fPn_PPMO`DC&JQs?;hETZ(YK=a8MZ#e+0Xrd;K!$2KwWe}!gUXv z*2ie~JP~&7iD5*iw=sY4-2fJ4L;=LN@J^S<)K=TS9A?~6^i!%FaH8i)oS~j9Wv|{_ z@;tr|F(@Dle&YgDCYPl_OLA#X)CFTNhDtDKMFq1r%gg~N_s zwg?YiYsh=li^_g-H1rK3v;-9=ADYS(S?E)aGNS(|mNpAXA71|8RU941OFz?G zNi!U&o2)uMxdv%>cY#0rxZ%sb`&aRS*L??IyRlxaOV;w2L^kCF@>sIheZ>bdR!B7? ze@b#Kg2W!#k5hiFv2#N`&CUT~iXe3krsCJP@wG-AiF2F6Ha$j_%)qH5C6?81f(U9< zqz}QDwv>8GFY>a+x2TWbadA3L^s9Z1z9D#KR@MwbG+Fr1^qtXiOgjY+A~8`i&loKK zEKmT?j6ztHBa$6w64}6=29jO)@}5(ydKV$M{)igx(HX0vnsD)P-yV$P$ct!#MlTrL zB=F>hJeIF?s7zFd zXJAiKxT%iXFvO_9eNP82KNdJW0Hz)I`V{!Y9|3JC)7!5iI{B%Htwy?`QA6mVWS-dI*XBky?snie<5Hyu$>+B z_x~39$KMYuFHyN@Y$&`5tp?E1E?vdqfzOHTzn`PO?>7UFiErbTTx58H(H8LApMZbl zkI+B*KKPA~0@Hr1n-Pw+PV%eBuRHwYkUPnaf%D@yyXfo$es&!9PLJaI=?QRp6!*?p z?({fzpPiooXD7hPVS#ZN&$B$soSy)z^1D3ubNyyH{&~gi^qB3Q0O!Z>Gq!(z44j?9 z&yJ(~>Xi46;llBpbeyxT^OJZ7-RUu~IxBTffYlj%Mf!y6ihq(#wF{R_C2xHv+hzZ$ z%bN05898Oij76)i8||?b`0QcEGull_AToK$x_s8zNa`11x_a%bvjLl|9;h((mQT)>D zegwGwAz=5?n6i%w0dgACas(hjgd(IYBx3>KXRtG8Gz`dq4`Z<1&=u*Bd~q9zyI@<1 zdA8M#Z6!lsLI)-`>Qre&NuSh%2<#GG{IN@x>vWP2&i45!od9SroZ1X}gZGixmij`u zN1F+wkSa2*#X3WWMtno3qYZM`;|!w$o^ZojwVNP8hPMmXy7?Q zv>6v0m^4KvgLET)bApjf0l#kuj>;y1SrL#p03{6kZM@yf@OPuKrV^^XnmCpF=`dx% z;xve_lz#|$v;#(M?gP`QJM8=Y&q{IKtBfN)3~4CkAd}x zfR6yO!G=K8U}$X#L)YpCJ}Pbm&-k1u@|5EzSxT$YvJ!rFBkj3a+kk%`CRq(V>ilz zzjye#*xhU|;TG5%FbH?CJHGGi0Xu?op}^I1-Q)M=E->vz*_}$mF3afq4ryY$N#hnz zQc?BEzZAXnQ?imXRj;hri&GzrzQUCZlqogIUWr1rw``-@J#|Yus_{eBQLR)F%U0=V*S2{fE8*e(f2U4{yS!DW-+y*cBC5=wU-iM4W3S7<9D# zJX2YAb$ukiX``ZeJFZv*!4grTfgWLY#N z2E~8$ntX)pqX|_e0O^vLCz|MAGy)SyQh%I**yy*!TQAH)lr_)?F^Sfpi-|+7RpD%g z8}Ze>GP*2S#`Q*9&s`Zx9`&Jmg4Kacqoj5dTmEP(g~LPRnf$Otfz}O z$#JM%mFYGlD?H_lm2jAl+L|_z0}r010MVB4vs28!_j>fxo0z@BrUlv^kBzl1N}zr`x{t3?-f|Q;BTQl;W;sd2RaMUS@{Dl^fPW3=Ui$sK|EIZPA38Kt21e` z7`3s!;*0y_pu}I%R%8J=1F=lKE9pkzN2hK{HsY06CqaFx$tDo=I^`)C zmn^bf-qW*$MOuYN=Vw$Nc$wfE`As+tLtg_Rzfv~?AfKrSc_lteZ_~aAzp<<6_mEvTO|h2;V`TLG{6|+69YeM` z3R7ZF_3zGv176mHkr9F+KPA1c&05=x2d%(WaCPJem*6NV9r|3aVgtG~SfF~|OB)K} ztW$9p_@PwAUvbK+8Ne5bg3w}mOQRzL&Nw58@@j)l?~#~ga;HR{J|Rw-CJl};ATh6# ztY8Nh+rwk3%p+0SP}Pmm(9v<%dL^lX>%Dt<3cC{2Xh;9+r~!@uRl$g%M7sW&I9!53 zf-KKnO2uqdxl<~jU{>J~mV~9UsLd4IP#mmTOsxqgWyCUQICo!hU5C>#LW)=6R9Y&{ zM|VkX1aOUONI#S3&^b_z^6h`(i9U`|HpT4r5U}kfS%v^ww)|u_l87 z0={XT59zUK!Zhg(*D-n`kpk-N2LGH#FgW6~86xN?2xxIGMGYoAAvz^SF;x)jD8zpN ztQR9kfm^VP_#k)?;^Ph-B{UuAJvIqAM~5)SYY?P2qB;1$;9A9HF?s-xQp;V#&%FB- zZ+OEm0oOkO>|BmlD^#5#5HlqTv;*%vM380F0TN@ok4~PFpiIuFFU~S~ky{qjRbpR;}J*o0)Fr{n%TBb$#W|oXfX;T7*73(WXjTSq~Cl@PCJ0 zxEr>60rsw+!uox`0qn(zrQwK6Ps0j7MZa(m&dCRsQE^=s?;pa{v3%h-!>&CU{qzPJ z*U9wmuvx}nv2q>_(}hczKlpZ>|K?A|)ChZS1R8C$DBqS1yI=l~;k$Rhb}wN5lV8O7 zoBs{4e~pGA9Ux+v@HudD1Iy3;ax9VWkQXP{HF;pAgi1(zLp5^Rxl- zQ^^PM3%$^@p@N(Dq+=)vzW9RS`~?%_rIOluJKNZ5Gx1SfFZ@rW%E+ATNSzYWw1HQp zmCUU56MP|DUz6r7e^kGtJOgP++DaKEMhVYDzYacu>50$4{>%OmaNc8m)ug~4by_AO z0XC8X=7hymx*3{!+T1-8(_M&Uf$~oq;eFxl9@9)Ghbw&F*FFKSdeOZ&I9dT94xhq@ z25XhjDB&4pw0;6*#0d^GbL{Rky!!QjfggC=EnK~_K#O|EgfzyK(UiXT} z;VT}zisRFDu#&9=UBZjI$2d@H2J9^xZk;UfvhR5Z{?iZtPq4E?_|8SHu^}Nw`H?rF z1G-l(li#a;O38pr=uz1sIWjnWTErt~n|1WlF?86FN!v*4_-UoQe7kT0Vk)T-f6CKP zHaCEalMB8~A$jpzn^-SmmgKCMnWbIDgi+X!J4DJ;6H<3ycf2+4}a%RqW}5ZfZZ#cI;!omvgl4& z^^?7Ly__<&LEj5rJ_8fbmb=V!ndQrGv3S;Zq8-twB+bXcQntE{-M{(| zVD~-?-dC`j@5jl{{Ijwk8N@|O+L_Bvz}XG#KJ+Tsr#%l2pugv5vHIoKr}XaQ5-en^3vJc%#ucjm>zvw~Uf34+lkO1Fnle1Ok8u46fI#YoV*nN%t~(k(0%# zzHJ9My@CFpekg!zBZ7>1LobZ{V$TQCZRr*Z%XX_?Ym~1^mx?XtHF~;HR=XtW^rJDt z4_%9Df>|yHM_rZplwP9A*VOU_AL%0aU89m>gm{xMN#q7EO8LZHb%hgg=SWLDCp_8a z$xYbRtGM{`{|>gi1O40Iz=Uz{!VbRs7jNRf z{Ad3Pc-Jog7unHj%gp6L*aV*)j=+N9TH4&>u3+wD51z7bm{KvgnKp53$t}CnTOm+}x0_ zZwWseGKjWZ264Q0&kED@_ zjSYp+GlCyMkP7U4n2KI@fQ1z3kfr!6qvEMJY)9}%<+uteIU1wKU2TyT3L$93fFl9A z1HO(P(K>oPc^Mc4$Sd75!m>7=cOv9{@J=}DGl8>yn}FHSk51qxr|{Dg^pg|#@hSZD z4E^*p?w_2YpPs=_&*9i1?zMMB9vDC2@VTQu@@KKg_WT^UcvjHQev?SYdf&z1^BcFTkOGh_F!!fZE*p%+(ldN z!C221dm|uA4@gSV6GW5D?PNqwxTprGuX4`L2ifbyXa}GUst)bY+NK}K_E=9gBXyCD zfZrR-WP2i`lo1`qbw)YD~+^y4CMpiup?ntVC6F>Z0Ysc z5!%vl;h}Fv+r5TW5NoxiG`}oQDR0U zHUUPRxgk2RhwcFOb{pRNfiwJzpL;v-C%+2pUP-!w=BO3t7*WnbN<&DbCmZVY{S$Sd zb86mYFVqDv@ySklOz(w&$%7n`BuYm8N?x&s{#(lsS`V0%2TYK#O0ZyYho9q$b!2`w7h7_l)XTHsDA zC%zpy4du?)ri4Pp!fKI}xC|aB(HhF4bzaI@2{-8px+(Qs)D3`V4heVgbb9JK#l%-( z=ogW6fg2yH5Wk5aK&B~qQg2s|R23yieouueM4~*`*LvRzen!DU_ry#U7mUG{U~*}u z4nrm!AGD~=q*F>t_%bA0qdor{U{{_HS@S!80{w&U;1t-JMk%Mvw!pSWSFIR9Er*fd z0V60R7}j?XKcdc`qsN~&qKuqI!YMTB_xUN>)vMTf*?)&-duV(6SiSvqIQy-C8@)3W zoYk-`fWwbs@!(gXJ?pChU&9VQgtK4xUjVzHF0C3Z_!7qY9PR3z*m==6!T0WozT@OL z`;~u%{^9okdzUtOlXw^2^cAq&gWdh406(u`Ew*=u(Xu%CA0K1b)j5=l&KLIu!{R%6 zmt#U1EJEL-Oz=6|vN*2^JU1iGw+Ogy4Yoc(f8_mT4NcMYPtr}%%FjCTW{CeJ6FKu* zH_m^jtfWWI%F+qhGJi`?6kvSK1&tLq1r^G%5f6dR4il3tqr3uXUV6^&Y8Nb4%cstP z35L!x4-NM*`pzyck+I}={@x{u(8e(yG}Tw2EH7Rk%SuMU_wW&_S{uJPKh zdkjZ_BDo-`46@QmWYV~74Q0Q=dwLr&-oRE@5b2-KI_s;5hVs9 zM@}5HPjG}!@lN%Ll5h!K<%mtlgXELUE;&Db+GsH3m@@`|K457EN0U;Lj zGXVk>MA}9qBs90-1Srvdm1?FHWmTz(9Ev4s8MPXmAWAJG>VxkY-p!MZd$;is#S z#&qxV&*b6%uY6E=$DXBW zJ&R-)Cy_>*s?vCJxPTDXq)X+pkx{=sk?U)rlmd{LbWwV3Jn~I&5E# zS8eLIrjR#ygZQ1e^FiWHJi2(#juJ51%=T+wk`9*S$;nrMI#(ND894dH?;d#AJi||} zW9JM1CU*YP%YlPW#5#*95>%f%Ob5KOr*7TQ$y_A{)(m~kwJuButwnO9yft3`05qOP zlFq-ymf)t5F}39#9fp(JXL!xm-;Zy8(S0~LSY@(hNn%vWQ6Zk25|7A(q62C>5}`=! z8jw?9|NA>`Fsm8?iG*4%b$N|9E9jfdgNq93+aL5!u|q3 z|DG9N^X)%|lVAN|VDHX&X|G0bsxFH*7ykOKWL@@9-Vw!son?B}eYH_^K}ip!+tL-` z!Ka3icz{za8Mg@6nFx0;>RIS%?DS-e-1Z$Y9V!7uz(*u9q}Te)DKhdQDi_>|tSDg8 zG3W{%GvebS)j7S@VuO)7bS{25M$$vQ+2p6OZrpc^^M6L{0oO}XheQ{YD3PBo%!#iB zZ#3l<^ia1y=$d4}QQHIxStZ*NNC%xr8w#fNDYdIogMÜhAMp@<&HK-pX? zZOA~a>}+vRDdhaKael}MSQbuP6jXRG0LAa5feNcXQ1L*V)8JSa@!R?eesVpgGtQ2H z`(FtA%dbRx&R>OHyaQOT1}~DPWWWfH9Rn^ziv(8MPrmDi@Mj(8r+BE#F=!O*Oh|}> z>i2M3zPNzZyWR*tel!;8U41;JXMZVteNuQ-KqQ&QU9me^L`J?Z{{1<-$zkNLp=u4i-2q+&HUx`QWu|{dQm2%A86Mp^J+(J;3M2r7UTg)D~gY*^yr#9{NxkZ{hXI! z=Q%G!zx6O*Vybmtv4CCc5u|$^alf?)+yfn)j-4TLfFn{#)c^RTdtaTvuvhXKHa?&4x?B}SJ_jos1h=kK}>}k7$ zYwU_mB6{zmH3qiEM%}TyFg$wH@Xy}x9-RE%&&8&IiSfdRYQU9X>!$8e&XRFv`06k# zmehDv;Ydefy-dR4?Z89H6)7SALjFCzxJLZ?m{zlhQD(7>BSLMN+5+n%lC?M{q>mGh z9Yx0jx7ZC>Y^HOHN6RNbT}@%u7)hM<`VE8~M#63}zT?HOIM_z$RX~qdUKq%$9zdNu z2>B!Egr?!5ZY-vbBO<&_p)b9YZZ6eXh*MSO|YylK5%Bw12< zjX(jK0(NeLhmRd!*(39jxkrnMU?9iu9!!sWCF>S~6iQ%27~V5WOeJuPz^LcB_^dcX z3Ad{(%Zoc8JgrIcGN&u1CJe;AdWCfPoptEQ5?7TmD$$?66>W9O;CB)JgwKUP?WMql zyW(&{)b_>0+CvFJM=&Y8^1?F|qX3^(1CcSBlQ_}9@>CQa>_NT~zDdR)Y&wmd%kb+T zLx10!(JtQ&EcURtd^ZiKC}3KgqwQY?cJ|ROT*mxo{|SC{JJ#8V?$m+8k8IOoICz>y zqOsg3Ez~g<-~2*7awf(u9ab^Pj37*UC%)-B=@OpFBkGE=OzJ0lc3zyIXsVq92zA*R zFJ}V71&b*+iBF%hxzrN^)Cd82pSWj0*wPd6#TrLxDxHLF{N5!K(NcKY5RSS_uf#hg z9}F7XIGPfb0!#WT9)f&H9>|W1zCrR9ed-YLdBf;Q=Ow-phx8xZ*6aX|9>((7UxdYT zzYaLQ&7OJe-kaBR>})}-i)qaO^8^znG;}o7BJdl5A@H*XSmOfXOeCDU%EtPi-s8PV z5lkF2*UbQ26U1qSXePd^tze6VxSc`F!Q{=^FOGyMd+_k2!C~>L!r5brqD6T##K-{U z*L%DevuW`xB)>tsV2^2|2t3oW;a|S>7T)snKLgzScytyJ@J6CkWhNdC(O zQ@xyDCeh>{?KOlj^nKPgceSGqykcBD0@2G$on`7poYNM#Wfks-f|n60ji$+um~#UL z?L7oZ2yEEMW78TZ`F_I6I|*jc%UYP zGn3+wpT~|iAoP>(6$@@PE?N%VF^+PYGfB#|c7b1f=gv3crNmoFU35^QLlCbaiL!2N zin#3AFPg*fhZ`UV0hspy07V zBij~FjL$lXlUF687Fsp^HKjO7!@{4Xw9hI@(V!inuRItHVI*}a0*dwvD05B>&L zzx|^)ed~|HcP>R$V;#}6yNCHBzYG8P?_>VZZ(#o8UxhFBOHxOC5`W=DysFddWzph> zoJBM5dvRX+o$!j>MYEBArhr-Saq)ys0QxIU=l8-pISP%kB#rf=b0cc`Jn@qpYI{{j zsE3KWXxk3xY{Q*;&Lj&Jf8jzHYR6fq;s-q=;wC&;Hu+R8*`Ge4z)d=qeV6ff~@v5(#R98R`1^sZB8 z$%lNQWyjoCJd7=55bG%D2ON>&uq+%ga^zzt;nbp+-^uf_RX(=OgNaYNHji_Hl73+H zq?LH&nv6Jvv72;AVi>6pAk-p&1m3g-jZm@U-|K>IAn=}NGz4wJA~l1087l7BzX-hb zPtWns|Bp8V@A(zr!ktvPC=?@OL9=eBPIk&px-S2cSx&j~*|2jZiSb9hQ0GFO7$sJ$ z8g2Cw3t2byF)1a?Xm{|IHkZ0x?W!=$4DdOUVb^nhYRXK%D~<@*nPAD+xsNzn6CxfO z7(b~;M8Y`Y3F>c*Y7!6A8k&d`2I)EP5x;n0spKQQBJPmRjy5;sR(x}`pb=e-?2HlE z_-Syx-bpxk=*gHyrVdlzbucd}tt;Q9r2`)s>_C`I6%qP$Yz~{ddXxfIiIqd7zzl;> zv$2jK;jw;K=3edz7TCU&hS_SMTnt9sgT7m#jeyb+z)zOR;EhK zoj(bG-!H=7`v&xbhk9@C465zY{M7N5XL>3Wc}9 zobt&!PPry~W?;FCete3vH+(17zwvtX(;h?B;>qyF!15yI>mS3}FMJoyf9d~=e!h+o z91e2=GFrAv7Ryeca{fpSn!pvXkeT|tgAOHjiohi>qh+H`(5{qQlOC>)%+ zNyDl=r@UPCYE{za(xuM%ZXK{m8A(Tb#evVAuyqid8J%MryfPd7Y1qVDe~tDIuDM8g z@Jb!kAM0&DOPJDc3|+@SACPQRMs(VsPt)rr-P*>1WyK!>?hHnkhKkHTqhB4c#n}FH!!h@5ihsc(FOK+9m9P@auiHf za^s{c4kP5DitKd72ur|eqCa0+(>PH=r&dNXKIz#^P`G)CBADv7Gb7?X7K}6yZ zVwApcG|__B2E<{M+B8Bu&3Rs);JBvmf-kNu?49SR!O(i>uq)}YNU9=n30=rG5WYB) zBMRAg>;o+0U>sx_FPcV=axp<>TU*~#a1ywbNe|>WdC91o96A+2isD2vs9-y_UUB#m zVs3R$YhZoiq;g7-()kugo(dt<1=h;3iN&i3Z{?bvhF^wvVcF{G60@*w|H-^cJ2b--x#p zuHfs>iEnxu$zHgN9@?ofX++WaSc+}bn>(x)0A4#$*P}F+eN0; zZuO-G2PP3od()e`sSEDZ8P*ZMlmT?Mb@T`pPkuIbANm&HbPb#xHR*9Y*qVxy#H&X9-LIr!Dx1=L>-e zNvKB9>aN#wP|AEAM(30n%%V3fAH?m*dO2!q6BD!mz_Ed0i-9R(*8WWDTi5#GdAcn7ipI%zDIVekbCS}H3V#n19vg;G8h zc=;|qBu`XiO9mRvqLJkD#=v8xE%9INHU&#MxP;5(T4lZBP;hKpy(pqv$sDAK&w5C` z$Tq|#={Sq2ZZEnSH~ArcW$8gfy`Oy3O(9y4On#S&(#70mQS{6xckv5_*Rp|ZPS2!| zDnp)_6+Y{}_*2moZ)pD;$!hTpkj)q8D_k0RLnj-uPeu*=_%qu_(H$dxCLTe~gyjia z;y(NYmQQ&$b|3oBG4}~}b_kndgr~b>YKG@rTH@}#3G0=DOf0fAwiltj$4TFgT<6j# zo1CH|pG<*-KF8o#!SRk;GmfocG6pTFUu&4>8P*JwHO%ffJvhVnz2b>@)kBZL!66S@ z4Q9kQ1Cy4(4-j7>0U9NVzYYDCTW@CA+iiIDk9`YpH}V>P|7~kJ^%cQE;hC+q$eZFuJ9)FyNWVr-P?ghpa;$ z)8=TKfe8#3Z*Sxc9t-Z_zzinqF{qYTKI~z%E9zh5~rgn!6aHO$qLJ}*Dw^Tw4KICp%exW`Ia9} zoSF(3128E{fnRmOK1Cf}dX|9zq`?ZEY&iMDGWEW0ZImTXG7c!Pt4-1?Tn)pCI}HV* zsTwX7*iiy0%YnSIl7xXhWVMG%C*d@f^@-BvrU@WmUmDARq=9fWT3)Ob(# zooy=N5PfA^Z0LlB@Y#;)D?v&+Nt5`|8heEpG@;s!=)gFaO!f8b=n+hx_7v>A^dG>m zjL}+6^*C^{TI0%j$N%wnKOHZA-d(tTu*L$xS#` z6B%YW_9n-p$G}U!=MVADTW7eqHvt|?k#iJB$sticJy_v;zV`8W^@|^a!$ZDuqKz=s zp*F;p;G^-=5eZIcW=u&~s!5cY4A|eD@aiA`0KWh2w{geiNK#ze^BqivV%^f(fb)YD zUi->V!&g3d2ab;AAEO)q?C&gavIf5XhyECE_}{)8c=!Xb{i|?a$Hs@wq@>0N$yL4t zEf?daMo8vP{YbwCfZNBzJxbS9kv1WH)cw>U>KBU+olj;(VKEwNqxiAZWj=4}IAQFd zl}~RLxYteqpPPZ}T*|Z;^)HhQ;iSZle2@F_HGUHx$~t3(H4zVRbSKa8={yR;V+7D9 zo*6XjU{Udh$;xPquCpX1kZdAhHO`zii-q^-Jg{)$d0RSpTzb(OXUh4TdZ;T!XS6pR zQ9%2&?&xN*cz+0yj4&z%sK8RJgermYcUL*E=bnY)PmWN*#Oc6@Oe!SQE0Xi3pg^TF zDi9Pj_-vy&-5WxT=cR5FYzCR6jb((dU`Jspk(6GFQxXUeUy~veAJ=`O5s#Jg8?c;h zxr|JB@|i}aDvuzTGGH2;fw++jjfiCLiEXx_P;e%}O*FHdwsnd>GPWEAu;EyuF_tg9 zHxSR_2o#_sFE5F4(pPv18mO8Pf0AC6C0`{&@0&Q8BV5#mW7MtN!8i1v z;BOp$Rb3iAOlV2=!i~unXb*{>2hUPJL|=f8FSJE{?`)6F0GgVX{Yh>GglN`+OWAkI zSGrS~B|O9nkpGk`=vcMm%0OJn8{uZvcKBQbHpxpi$YFf(2ZBpG(7jGL!Ve8NdKA;A zJqi0S`7h9X4>-OJ*J~XjQj$F#-Xc-$&9R;w^W^Xe@P(l_pih7=9DQ=k(+pq4Z(nru z1%RoePr%#^eF}Lx;bH3Vg#&HI1ddF3$Ve&)NOr{Ef$s4VQt%*7=fcz!kHlqQh*Yu= zi${%QMo%3~g5uAZ+(m0)CsRE{k0zxM=ZFB+n!&VViiunNg&r)dVOli&Z*RGUpZ)2d z1wQ^hVE-~4t0J%HSeWcbGBe5^AyaK(&b2{GM5|td_M;;Usy&LKM&Bjg%1_8gNiWro z@uuoECQqF{m^>MAi!?ZO-}qfP7|SNT^tXv(PaBPOGn}R?HXxZLt`>T0Twovc3~7W6 z4d8*EI=6}ii8~W6S9!Lf#s7#lVCvLV{=|Kb#W03w$pNRZ)L8=nbqa(gjQ=p=n(zRR z5nzI7)`A9O%EcIH%`!nV>LOJl1tc5s6IP6Lu*XJ{QpxEI?uMw-;ql z&=9Qq}P$FikS3Cc#E*28_95<_mHo*hkgb4SnvI*N*koNWx1q~f6OTCpNU(>~0+swEb)+ufjL+59576|JghIVFqX5K9 zwv{+me0w;&Ui`KMm~e_cz}PtwJn6w8aijA=Sg9AFZ705LCrA2pF~K11kz5o$kp?Bb zK`qYEU5Q73}Jm2??u23L{+mN7XH(h(ZXdWF9L+vN9N z@I}R$GzzDzTJ%z%s^hel#x|7jq@2h!(VjT-S?7iUEA4jbua)8JT3?q&F`P7kyZ|=K zIupF?Ik6pxkF4VSojkzS=&E?dPdWCiE63Vs7Xth#^jdJN>a2nd2vWjx)$x>~1Lx!bJ@-*Q3;iH)DeH?ba_}hTxRrJG~aXtuQtwewz+&1dP zs7T-wqbTM5U*H-VV_PI4dZj~m~UaS@PMN(FnBjy+?{a! z(D2{>^!xDfUw?h5#A3H3;6f;TK?Fa=prUW&L#50luTS+n6F2^mzSM8WupjA7>Q1py zGVGH^R1{+@bT&vw}weL~abRVpzm{oa396~=t`bcElqFm?{{gd!1 zqkS=T%lP2o8@+RvDHjfleeRrz;FP8Jxs2E`;h~L)|H1>kN3tx^IdT)vqfF?v)@x0X z7%AOx4;r{h!CH)rIbu<>gQD#rdyWeM8Z9DkTH-dd<00XI!ch=*&L=iHNKl|5>G-W+ zCdX^hVBQCvtca|aqa1h5_CaPz=u#L}s0u12fNl*zz%5>y6y-2Maa@xq=)i_}Y z$0~0rjuUUe2jQad7$TK$oDM}~DcMXJas;wV$xEPDoy1MRb>EptlXoaQ5I%AYsw7^B zwpQlX1=nLs=RkxoI;WSivrrtAfdQF#WskVYj8l=_@?YhpYES zIBHAs@M1?gM9npnPkHB&BjhJoH@Z)RsW-+K+JS*vQ$kc9DA9i2-t+3@a;Or3I8s>F8w<)%n2P-2naM!s#As5R5 zRoQ2ZhJb5m#8>{J`{L9R6O#_%JnYIGd||4=jLx5S7Qsu~@z%3cYBgsK!0Bvj`YKm_e_o!30rI$%d=v|0h z>y+4DL&2MEZP+QFgP+MxKCeCz(s3UzIu$JHN$|NQLbP*tCQJNov^~VG!C0U?^fpN1 z$;>{^#es#+03)6R2^Q1A;)O;^L4G25?tJNMVNN6;qQ@)`{7k+v@sCbLOlv9OF~n}( zXpg(UJl3s6Le6dNVk2$XJa!C*Tw|)R_w`1?W!AtkE=f;>6otwl$NMQQ)uTY1K^Sb5 zk0d-1IxywW;1HE{C_rGTDzz=bk|C&EG+r*@%1e$~29sAQW6`^c?_%C~95jRUSVW2B z5rbZi0MvRiIMu~w&{LVp4}iPOh&> zSD)02%9~^*ZK2X7y%LUUTgjd(v$vD5!B6Rf9CrXEj0nJa&x?+y{0e^)w(u;S9~4^B z!IpZ4@!VNI?-e~&o8AZi5}0&Roe%!3moo^7ZVdF2#zutHRwi$iW{W_2bRF&P`>^wp z{{q;*8}s2K3C?uLOCFNeGwCrP*0vOqfS^}_BXFSeCO+}31c*Y0*rn$k(uMfeXGfns zUwow#&@0KHLv|;;1B*IaN+Lg?C_YA7`>=E&iZxQ7#LKgeANL_l3jGr z2*(-3jkcw>1TP31u%((VqUm2U$zdD1r&z?4bBr2_2f~r|WKkzaY+N=fSjGOq`z;cJ z07+WC=zr2qoHGH7CV;4yvhA{YwHx>IjYhq6taO!=o5k8_nhTyY;bHOt@x9mp@ifRi z#mG(AjL@iMF-9h*#fW1q_+$WQJa{w$af+m8?DjK}*ieoQKW#f;|UT~b8*bYQaC)O;mZjr%7TVzNY3lS6JgqPsgs}-SBctJaFNOCCz z5BM1fl2JuLL`SKwdrfs%uLf_?+KZ72b}*qNcrpqpzi>Ay`pmY}<1e@xc_+Fg7j+v= z0gUZb+GRx6Vz-j`)QY@As|HU%BbLlJRFM$=rr=K zaXKo?h)&^IoDbMe$C#2;TYwNA?V9e%Fw_=xU!xJK+r?+;v*cLt5D&8r=~&@IEhoB# zit2$j<TIR7MPcdq9kpPX_Mo!eI? z&o#)P$VvsplftWmhtckRES6vLt?1L8m=A9N%PD%lJbT17%|j3d@t^wKxPE|6Q(N8D zaI90{Y8#ID06JZ_;)V!-!aoC3iO=wHLOp=)aq_gTt^fs!5g1b$K(tNLV`@XZ(})iN zahq{e3ZvA>QLG(`f7-#;nIOi95kXL%@vOtFyt4_8i~AEkbRGDA{p7oF{WpFR@F`v` zBEM%vkMah;yMi@k(ZX-VL5QSFNs^%)I7&DTVV~XUjLC-<2Sa9{7kjWhGOId9Kc}V! z?}1@!5pZb>#vN@=I)$(3Fyfi?Gr1*Shpoi-ASw9nJ`dmG7@eJb$Cs|SpBxn~x&g+- zR0#U5OiDFv7C1W`#&u{)S_ovz&!}V1ompj}zJZB}BkZY+E}8Sd&o284p1Q?os4>Zj zon*lq1K`GY@R2ySmJ6#nh6$hL6M|>a4m1T;1Og*La*i^ns;FXS>3Ipbv$rqflOj9Y zNQJLVRDw_gLuOr6YQ`JkFR^HB~cbI&m2T!Hl*&5TcOd zcd$Ill=fW?jQ280P}{0cnw(|zr+b=X7yh4g)jDcd3rg8oXBM3_(V-asYT}zjvn}z< zF%lNFBO1l`4H^Xx!(dg`2+%A1f*-c{EnHPccqfi(pL#&>BiK`~ngTK5ns67Zcp#bp zIO0JQKot~{<$jmr70v8KK)fpUg31$>=Y6%Q-$q`{osNfVZJ?mItyd@sN8Vs^s03GX z=cj9AO2091PCZt#D3R#7^se%x$fpLhge$bj+eZ90i5Q8Gcqe`}>Q?GOfqnQerpG;i z-G{ynZE+`XbThYt~0U_G>O7c5Bc4YPvGt7^pPgMsXZQ} zz%ED;bl@=*QV!p#RM8~wQTULOF_2_=DS`x7lqmxyL5eUF_F|+2&13^fG3zLcRht97 zD9itnqr(|Q0I7ji#IrpXkG6$(0q%O1KMI`Ewi-`|&vI71s>-T;(gMoBm^`|dh2uT~ z935hSVL%#$F-XaH#be>dwxmF!M{p8f!RFeEbi{g2c2*G< z0Cd0bI&HZYVR=V9%l0cHB!9^woLMG@Dw{T{dU{l!q2SB*z0~P7_>}q}A5sTZhM#Nk zS~Mjg{7%~fpC5b-(*w`M@{7L>SX=^5578FO5aB$JwLRqZWUkU zG9*S`^cmF0#8(W{R?$d%vnNx`4EB^aBsh|lE8_$^os!=^P#gLpQo@n)5?+Nm8Q z&;J0*7Or|s+Ir9uNils`W)Jn#`SMpMFM}r`7r|8LDQFry4aG0wqHyPtbbz{t&bO$; zhkp_ry?UcFiLo+(A{^Lm{83MZTe6BHHsDGAP|^k_?F0h=7O&Y*&5;rX?$8L2#h-SN z0T!pJ8xX0y2?_SRoQ|IaMI9=V0)SDe(&P<->vrpKyiOma=UM zpJl|+M*I_pqKFw##Ys8&ipN%2u1F=?};A;7Qpjo zBrEbuXVTQm2(#0P>Y{RtzpZ-unTjl>6|G#jPQ~4D9D=#Y)WS>l@Kt78?$I!#hsQdl zDiaiZMPJqd>y^lm2_oB0T;)u{80BaJHgyKP-vvi)vt0-2;^nMk)bF@C+7^z+`(OYt z>9cPJ0eyGEcJfZWxWu(2@gP0MG9aH&Y(_h>GC5Oy;wjvHYZN$n$nWkMn1Ws6sbCda zO`|wOOVL-~#RJiipQPJBV5}s)+0Y#inhrmX>B*mkoxk!e0G7bnA<)9<#c+DqPInFI zZ=SU49Bs+zBmf4U*vnm6IdXz1Zyw_}6;+3a`f@?F5}!;!M3NyL|CqJ{Cd$j%(+0HL zWsDLHwge!R^a?9MIvNu_XW7_ZtWEf$pS(3hLe}FibUls*$X#k|zA*uC@4%wrxBqm7 z|KTTp3;w%5gSLBlsJEtFa($CV>)CjIm)#;hbLN1y2+BH88gN_rE~@l3V?^Mc@yAH7 zzBi-o$rf3jjEzJzcoX-O5E0kTgw7d@L^nGW=3I0v`3hIz(5c^G9Ahf3_ETq+OesN5 zpF=lj#sdI}Q=4M<7IjBt0jz7G7cLQ4OFMI)8NLetnB3bG3!mKz4jesqr`>R|e25`p zxu&>M&N10qBgyU2wDM>ndDz?_6xSq2uR!=y_=W1F?>YR2+dbD7Q_YyWa zWGW*>HN?oq93{!1)(Q{NF2y&N5uA<0iHN!b>my)w$j>9-{1{lB0Ov=*>Uca~@&4)v zSo8DjnB^*rWBxt{&JXyVaMwo#?s33b>zUx|`zfEF66WE6wK|G2=ZA5BCY<##Ftgq) zcqaq)TyR_0HctZw;Wq18EvI(b&YHNcL`IM2{;>TueH z^iQy8dyq}Z=7igDw1Ib-YRwZ=tr#_Rd)mgWmSF%eO;Z({g|@`YK9s!Ez*NU*k5>3# zAYLq&BrsV!{1~REKZxavUIjnz@Z;OD&3xu^W74eu<&@(+SW!lN@!SO#2}`3)oYPq` z4Hkdydgl}C7C3=769gd28G~A+O<5-rqZkcv_i#y+WA7Xt>%-TXiESQ96n}@iD(f(a zgAzE2kc4tgMzm#2Ky4H9Dz=|R6;_yE@miFj%l0ttwDl-N$iP> zVg%bu+{!e#@wuJ>F}|jI9_2hchNM+&@JL`XVXQbS&hgUm3M0NU@d2m3^-NU=Gp3MY z)YqD9w(vu`?4f_gsZm(yY_i$_^EtpP>7#x*sLSFa6PtuZ`Ney>;-$h~bW%ED-qS5; z)GU*l9*Loe=Ni=wK=If43XtAmxa)cBMvyo$ML|C(BqJJ;(7k%`K3FdWi;^5j08$Fo zQ=57$$rEv4IQe?tY$!=efM3h4#0x!ek#Jo?qC!cKt&O+Q*R~)Ywea)3;6557&ILE0 z0c&Va{UTs_0p8ET!L=z+(!xBkuOr%Sjq4HuH#MWP7kpX{Bbq~5t%ag@1D#qJRwzWF zVOj>BjZS-B$Gck^0|{S#7@{X^LnzKX!)=01eA9He+7w~1jYFB%qKA!8*3faDHPR-) zgO;B1bhJ4Fj~N4SIe5+UP1%Ux)xmeYNcQZ_%1B!D^y3+OyB6Ci-D7=JIF@iSZVS>% z`61Rx7)H?X7KdoNo^dUOEq37VeG~lP5n#Eyr8ku0hMv-)>AA{6_QUU0m(nJMUxAhF z)GL*cdRy#S!GgWNabIm<1h;IjkfBSsZ#2z%wGKpM5;JUW1EA=kO)5cZqOa6f-PH;> zc^Hdlz7UJg`3Cg!bJ*$#HZ5bsWuDyBxP02XW;f&RRATs&Xn^?&!7_|oTH z!}VL|Jav}oit!AZq5TL5g~jEy0D)#aFbvFqOo-z%PkS3PteZXd3x*I*zDImE|cz9C@2xUNGw&uOvH!bp@FU*EC2YxtHQ z`7nOq?Kg4d>JCw+kS%)sW-%prwpzoF&++g7_Wk&kk2L&`|LlK-{n4A?m+xjB>ZuML zOgSoX0R0nxC)30?FmNjll;`r7x+(RLZYgeM5eY~@L{rFq{AL~TOAQ)*zuB-mA>65_ zAU!6USY#vdDmI)TBp3abZF0kifD4^)^t@~{h7+zvW$FUrXkW=|;B8Zk07W&8>{2th zl|1QGv(4aZCK_P#!bi!pbKRI^F5hkq?(-OdWI0%a&+~ZYi6eB4V1st$B5_0Y^*E3b zAA&D#5&Lap!^2(Ajd#_{c)$Rk#Hyizd@xZ8RRvJ)K~_kP)Lvk%Z$)W(S)596Nr-T1 zlWm$8h5n~Lt-by9KWupmMZ(N67IXTt){bu?0H;V2|67VM=0D7YA~J`ZL1oc|2i zy&9t*;9O}MwejqWITpqlm1}lb^EeIGqHXIvl80%^MP(tISTvaiXU4bi8jMGlcj6q2 zK`pn_HaQ;y9B}|uV=p^iB1bv*IkIlO=+0Wa2$DOxqQ@B_0ZNM4!!RJugJ=!r6FPJV zo5%Z$$cJDrd!ZRxh#zS;V=tLc95j;Lwj4MIs19JFn$sZ7VHPj2OoQa2x!7qEqXEsP zG+ggJ7Ni0|Uz6^2;Mf+CRKD%U;MYF{?Ci4~ov`%IwFo_^3Z2(fQ^+jUu3>X(Gkax( zr{qL-qlUW5@;93rU(`FSx7{uqOi>@!|$!qQe+3>A$y}OsVZV@k^YeWK|2oh zVT@a(H|i2@g#qb(@Fdm&kr$n`Z1@oAvTPV(A2YYHYgCmuI}}f;uZ&-Ts(2XuR%g{Y z^5fPbPFV|`XEGP>7Gum|{A!!YPsuz*y_AGbBJW8k5p9w=c~2aZaIy@)>t}wluACkO zLU4xP-B4bWDH_KpJqO}P|k1H0KNz)skgU%L9CRTx)G0|v?C2X3| z+7i|lksVJvWHLg?+7FF54SL=7Hqzc!wW#Dq(tx7LEzX<}Q8$P=x>rX40x ziwG1g6nJc748sZf8=6gMJb@RmXm@JBv_P{d+MO0z-fcpgcDPltp|y#8kKhdYnfW_zk4NQOemB7g{FrO9uqf_M6QTOOfnCrknaB3-1?Xf0-_UvIx zxdX+6zBoKk={cV};T8!}de|6W9I>;sc0l5w$uW3>aWS z6c{m}AZQ9z*p!FsH|1?2-w?jWV!Er(9I;ix;IaLG0$`W!#2eoAUflZi*TEM1z=96j zr9&P%x{>TtKglN`UC@X*x^g3j^n$F=)k=)gl$%jcY%!9Yra(fRD8s-cY!kN68GD#IoY0!L?T>amZ- zSZO>ml4xMy<}>Wt6M)5TJaNLd5MF$l!|}CN0%aUGo(AVV5-8`{6CR^7$(JtUj8P8f z^wW5GV!*VC(|iC|`twW_(Z$ggv<3M?g(t1SA=X!rk**k|)^U0#9gcfUeRVUK&!PN{ zZ8=Bi5C$9PVn}8&^#F_>oc@ntQo@O>DxAHh3Bjasy@pRy7&v94H3&oO93m|N4ZXu9 z3(5-$5TMQ=oQk(4aQ%buvr{IW)c>TTIA`fa>UPm}#{$I42$QQa zqf2;~c%D_PG)nl5r#&0>D&eS#DvK@#m|ozhi2Hyc`YHa*3TJ(B~?8mu`^&O5H0cD(-YJriI0 z;9Yp+_IacdMGQ?-pB9Oed53#Ud%*zbR8oqNI6$NT*jY3@dbGw@eb*o2?KjSGX`gQ{ zXEII>hOL1nl#i55^3(!Rgfa8CuKRfkN-V#7=-K$>&H;pQF5%SWKiP zVd*je-1v~PzxE(CLe83iQvq1lkpU_&;#YmCzfBsoB~)f@n+&Nt%?R5IK2fnaP9IJj z6nK}Asxj~xm^eVgjjXEj7$n6{dgN4?t-vJM^(Mh&oeb8**8ubuQ(u{N7aU|{=`3V8 zq}3I~R8|IEaECt0>*moWWWb3e>k+R(c#+Fi8?}sE37!agnhyS=6LFA7(q7fCG8Ezi zHeE7tR$1bMiXU-c(J0UR0f^sKukx+b5ievd{F!xycPCwtQ@|$f!p|Mpy%1Aj9h+@L z0sgUPSsj+zl+KB!%+7R4A0=n%ixH3#;CjExGt1G5(@Dm)g>UL5+f;I#!KgS#!A`o% zrO_cT3q!FrwUE56@RSq_HF-4v$2ZWfT*2~%--LGUGtiG7K}_(*)>v|oXc4A4oPi>G zxH00|y>nw`@YEI!s~Na-c8=G*>e+b7^X|g+Tjv3S|EE}rDngE1=u$-SJc5T=L)Riw zGwdvYM~~L{zkJ6Z;&*SaaA_}gx(JAquVR%gCY;_l#rM7P0ley=`*7=E75LP^2#z#E zvKOvlVZzb46D)b!kgx2RtYdFy!mEDtgZQD}yNxSXb|Q_?`U%P+lFWwbj;lES<$r;r z-+B{p<*{7jSpAts+c9KqjU#NGg3@;})r+sMK0!+jsB`iMZY;khJ)C|^e_GXy8Y271 zrlc#v6(de%J>;6nR97*X{7!q5?PYUedy$aTSV`F8kzg?~r)sl!DQ}$SGjMlt*!)HZ z*+(bH(BbtpBcf4XsF%?ZmOqyt37v5he>QD4mt$xdfpf7j5B!YjCje-9|i@XHIyRg3So}G zRg470N1Rpt_1k(`D zT|EoJ3}B_KKJ|n3J8>5r@Ox){Q{BQdCANk!QekY!i*cq5wt{nH0jwh&)plCUxOC5n zm}P^5an?A!X@h>>8p#kWRTEvh@>$Vm-A`FdK5BDRA3!a>8;yIzNf%*s>InVG2Aukv zJvYoVdCB@Ye2h)rp|s^{v#?CIm(Hy6f%q$_$vT2foLxH3cKZw*KLWe=30S`9Rj>>9 zq8(gE*EA-V+{YA6=uWV6@I2NA#58&ILZgjHl%m4<3|v~R@!D_x41DQ>*Kp(3Di+&2 za>P?8N3*o~!j5=uWAw6+7wL*&cVW1GG~+A3^AGX%TW7em%XMkwjadZ6MmF`yaCY+y zulc$M@TxD41Sn`IYkHEGV;9ZlH40hPxwr#3Fg3^CZo@bK@Q3ifzvCt@UtY#mcf<&F z9*SrUcKHsh-u=@!dgBknFWd{C+NN))`ePc!<;X{>gUT0qJIi$+zBz5dhK(l7fDNcI{M8YJ{F&Hp1-4++=Y*5=3m5rF;@3Hy zUXwcvpP`K>a3&Zk!!@BBQ@u=#b$*X2aUnkOn{6vLsZ%3aW-I~a!jVvbI|XCDz#X~s z5>h)hmGnCcHm=a2{No*VTl~~$5MPEGx*l{n?_1|@z1VdkOa;Hsf&orU&V)XS`=>Z#2US!w@POMtVqUmPr~^MvNC9 z1XBXVX0S^E)bb^mh%dqi#6zP$=sdKlmpO6rCl49ac4|K3BI9VEu)LF3g}^!RoZ8`6h@Tw6DeRpcJQNX`6b+zJ2T*&Jb(#Px zM3(8Y_!+Nf0l$;0|mdkohn;!Uv&Fi~-ahV+0 zJL6a4iOnR@5cgd)5J%^KMn79eZUswVdJkBRNE-Z8v{@1(({lhQW0xCKS1C8pCzAz^ zk~heAMg1(!@kTW578V%BJdGG(({;uM6=K7YA#)~e9PJEzW4aC&Ixe&VZupw?2R#31 zO!0*sMOv2co+;L&;lm9Dl2Dl4R^~E$Bn4Z}Ok9?-(81=Lo9QrJWw#8-ee?h%Se4N; zk)J|m`=*2A3a&1W7ljiIE*LT@Y~rIttjR-BS+|v5bT|#t7(l#e!eH$9ok~eKN?yQT zm8%@ffWb`~lr$Eeq_ZqCNgQ=0Qh{?LzHQ6UjUx#t2?JvltnkSTUd|-J3V(otzxX4E z!AFp8kftX3#Csnvq=gJpdcyWAAN0&BABNKyWh!rokKhPDXL~N^MOvWWy!6ay6Q;FY zgqeI%uUY&cuhLhG7U_p@FYq&A6wTswGN{zoJ=HDvHw)Wrl(+a*X-D}D+iWwFItHhd ztsJF#^!3y^ zEgtggvpNkP$1$jV=?FMF0fd7WOvI>=lAWNRuA%{M9*03D14U1~5j?>2fV=7S~I|9)|mXNMX1~mpT z&QL4>;p$n13yXD~W~@g#GJccZ^r3P53R?JhN1$RJvd(s#BSXpujIm$z8^%T+wWWh{ zg)ene=U*8&^#Gn>HuRQA)MUp4hI_07(kbkct@D_dsMs3Z%f-upgNcJ$EHq zEDI`#(RifXiAGf-@<#Z0A;4;&D)fPgWGg(&;YhWqKf<+QL`LOLbcG*buiXVPrXDIq^#g9Ox&SbgDQpkQdE4!X%lnUM3sj zJ7rmWENVymCYY29%1DUtG}0;<8U<>l3`(!8Vc0}EFV;cjPhmpxSo|Wb4)Pqsp)>GB zJ;E^Qj&uv;{~FPXNdHfJ3bnZh2V~n z*0^|hjuFmCJc1xO+DIp2s%MC<=oiW~Q`w0U{pp~=pdKlwXFMFg&J>E|C_*A~mkrg2 zQ!f##Mj{t#5$9k<62ty>iaSPf+=0duKz=f4m0jhn#!rJ={E&y;tkzJU7Li@htM6HluiX7V6V9DQvQ-w{^8P+q|R`62~! z=~7v~AfJ=|Er|}jZS3etAJv$1tM;UzOWmHdUX6G_O~^)vT}J{DTh)nd8Z&q zoU*9ejVwOt+;9Mb#s8ez2O4zJP>|AdjShfxt3JR0UmSyQ6E5P3v96PE!atKGjjk13 zGWjg`lI}`>!At175+k+89;^a;7E&*=v>DN?;FJxGYR)ev{79#CBl!R(`xvw*FQt#d zp*Xq3k$Nto=_QEG6ODJt-c?A%VK|+)IlJt-Ur;MBoJ$wXhcZr>cz7_WAUxxYU zHu`)P2?fjb)r{_l*Ff|bWr<;YXFw5eqj%^WQHT+lz@c}`U4esNI+sL8LV&>mOmM`D zLNAk$xHMePfWYB+4*=xhrV6*3C?uOBaRCs?o>4C5Jnu)NKSeHxPxkEtZ+Lk_ebGS$ zSPPj13j!f`?IVqQ4UWlnFzxN(_*efm&OiL8z~y^JuoC`~t1%&$UU-qOfwKX`M<2%W z`tAH8)CE^~!y=LCK6DJ^k$yXZUX2v#BF$CD4RO|5`fMW-q$Nk^B*d=RP;hQcZj^8t z{gaK(xjP2lDZIcS`B!09UZ@;=Y!s>X?sg zm{l`TaL^eE34Tc!GFEDVFt;{A#j#K$66BP{8=fm6X4iBKcm zz3QV_B0kmoHHj*AVZ=vQ%9F5^0P4!1BKlOYv@N8SWT`!qjwxXhf924mpWF7yOS5L2Y{H7)M@U;Pin;u>>t} zABhfPK%V8}tTf>Znma$hQz)RSL>ioleK_MRTkb9BzVTAibiFnbF6C!X*y!6=0`W z<&#r9zbSQzu+q0NvFUTv717ntdThnk!TR}ig@q*345w(wAs&RFTC zlV_q)0Hrzc+uUK=Az5vi z6R#NM47j0parkeH_z0yKVT#lKBMA$e!Z;|{!oPCtn9L)u;*&S3lN2(QnG$+0?+;1= z@voK>qXxDk7&yidpjlC%qP+UOp*$*D6naQ(v}at?;)2I4Hh`v}!stYE!P6S20VQjM-k_B{6HNvht&KpFWf_FUXCoeoH*q)7NSMxEN7BxEs-sI^^Pc!XT%3YXyHX4j zFPIRBze*+zB_SxdCJcQv{*gZKfqzr`YD0Jsgwa8y?1)!BQ!>cj97eoL=eetim@Jc8wCyb!w&{g?3N zUFZi7=LpW=KQciGr;1EQ##tu8lQ30InQ^Ec#*?h*Fat-6sWb9A`WT!lL&#hr4%i&B z*HlvWTVu;_gc%7wK7&nMz)6<1Kx1QjuhQ2uYCmB_r zmc)<5Sapi;AGos9lzK~DRAWy51dB>p>0kAoaR{p#4c-fsY*xC?46Me1)c>N-$rC=4 zU%`-D#tf9f0L7?AJ_v684uKl)=7O=azio?r7Ug&-B5@wmi|Qm`@P}t-f$QMB#fjq4 zW;xi^Bax0)Nr(6caOW9-#*tbJ8iMq(4c?o09OVOF;_Tds=Uk(Q7}YckF~Gn?KX{w? zkiCIhl;PNwMk#a^L01KI{pA<_DL9n+sslP@$VpS!VzBN@c~w!$AQ(_$!uyGz+9CeV z|CH1L1E1RFMtKy6FW4x-MuiykgtO`^iAk8%&?`N)%@UAco8PldmX~qJh=IXN_hL|b zSVwvEs2H6trvvih2y|cY(#UFEJ~QIhNuN`$x?e~bS82-;it1;7Anvs+FAIkr-wEH02?+V2OSCs7Up2@Vhx(~_)F@K}c~AV3COJIT->^aB?lLiR z1oAACU`F7M-vt-RBl%Qm(%J(LU~;O1DAq0fsPq{-6NpiZUTWQ7u zI6Xka33fj3>oGn58!?}sV|{cTy=e^&0rz-coPxbZZUir;!gwDDho}X=*`%huLRSok z9Z$wL#m^4+Mh?Vi5*!n6#4r zK__b$lMQY}&p2)^IYMzWBMEwa{b z9@EB&Xk|Pn9-VO}7{g)(?qKbBCbg_OiKr46eV~D|VnD8+N_y%gKa=+6qeL8t%XUjV z*XSuYB9myl@Dy<(mAugp@pBIz0LAj{{Hc@MrDK>r`@SkuNQ$v|u5 z5O5qY3;)3h<#Gu*F*5I0MWDb_5aoGhx|KlIi7ynidgrArjRIgR<5fLofddEDS735T zD(t}&Mx$h-F1W&(^kms8G`6F*q=*WlV4LQ|g|v&_8c;zv{2J|(Uun=xjNEC&HH#)} z2(H>Bu60{^D>8`615eI>2ER*veb#&FB#5ipH}#3%YD38&>+8AnEag*lLG;>|9F0a-+t1urd{K4L&$?SI8inO>`PaDZA4OWP^g&#>9f6KY1&Q@5ZO~E#cL@|4{)F0`AZ~~JG6uqi=L2}fK zKUw$a6PWI}jGZs}HngXIDf;1c_k7!@4PV+Byro0ncYx=!B-4vNN@lbH`7-HMU1OT?>j+EvlrIu2u&fdX zMDPq;v~Ev$$bQ85zF4A0$HZU08i@N9FX@6v6}@RI6c$vTv}@GIMK9@S zjmMRQZc~|nuAP!>n7Y(nbl}*fDcP%(2DG>?p^DLR zZY&Ef7L#DIJ{w5^SK&}%(hVUE;i110oOH=ZR7T8J`+3PZ3#a;s&r~OqE#7Y|FGX@H zeQ3%^e#DbZP*8$6ajTw7_*rQWC`v9Ki6$8Y9gGyoXiO%S*$8%-SQ3BTt91n%{4n(j z^jpS3^i+Ji$K*a77>LslYP>Ri1Bfmn?t&o@!b5e6QxJSL2l16i8^)&#cfyiFd;a8L1fMa)#u;GtrR@^;@zxaD7h?`nC2)`Tz{xiw{ORWmCGBG?gR_ zqLngs+mwAKyn-Wo#DC{nyAr^}XOg^Wf5k3zFZGOa(546S&dkRmNO-`W*YPIzr#uHc zU-A!OcRn5c<|ksSwH7pY#H%4XV#~P#6=iI+OLvc#2YUp%?v6h9IJl2Is;UiG9B?RI zi91}3OdNq6b%}S?#Yjo1!di&)hzL%#)4?N#@MSX+Q9O1yM|k2D7y+P7l5>2_0Wg!g z&K~XH1@(zRB9c8~VjQhStc%E^92tU<3XYt?4SnVCol7t~#NiwNCDykNfD2bMm_}Lg zk2>U9)-d2^jB%u&cX-&qB%M{FG1NVoEEq1IqC}-ITUYV}Y)cpIs?i>)BWa(qkBHo( z4j53=uc!?&um?f?+J1?MV(?Bu;S7L?q*skp{KN>3uWA%eOr`1(BG@9z{#MBP@B5 zFF56ML=xqMrD@ziF{bn!0CF0eTi$grqsN*dAUZ&t0+YfFLk*0n6fWjaXhAj0Z{AKy zH*V-+##(>Zuc_SnE`?+PFR+EP1SEww{U`hiOo2+&s60^pN_%N1$zgk~CP}=9O#|NG z0EIw$zmMQlr=2)4xa37xH4$(*0n$^@9A#KnzawI7(i56i2`WLg)=%JUTi=U3((#le zMYpmo-jGui=!PL*!4?2H4pYH`i}{!;N}dTH8oa42+jj9>@c29vRnTd8{ADt%R|Dw9Ms31bt-J_1<4 zB4FWeg%8O?3_SJFw%R9cF~vi99UlPmZ7e?Lt1x}xw_xsj=m(FEAO*lX&#Mt_;iI!3 z0)(uzUL#oyz<6>oV0j{Jl!?(AQvv}1h!>^8BVii&hK+`k77w)kAlgWpJm@r@ahAmq z_ch9rcRNag6i*_F3gVqM7x+jd!_P2;6ydY|DwZH3KBabE+vO$nEnaak?HFv@f%P*S z|NQsj`~x3=UAjBVgbbI;54B?Qx<|LAKhX~E_GaG<$H{L zDgMb?wbg=uBfSZSg%f?*LC7p#)XRtTEfG>B=*r{x3tQ0dpf~i8He!Kuz}1LbktM;# zEy;(Q7C_u4+B!#z4B#jyX>}W;Y;9s&>>P;3>`aI+QmLRv!y83W#mO@DB1V#^#K6f| zBQvsRC*}wd5zM-ot&&;5P-?-g%*;Tc-{bMXhjmp>&C9`CRv7I7LoxD?%+CN&8Z!k& zmV*cH)`!6A5I8&F&>L7@qebi`qu?w0;Uhta2l2a!Ue#f{l2IybSv(6m63Ip7lsHMA z^;H^~6p&VUlj zk_Vl-lp|RzP?K3X4mp|x&i2DIunzA_wwZ9UJ=59;^0m_J}48sfhDlMvaJ3%d(^?2&W4=hh1AxBW0q|M=a&rF&wrEHt$xt}+?vN-i+` zP3k7~ScwrZY{@k;g<(t1Izq1V6!{H*tunF?`e)-B5IrNG6FCc7+2F8uD?ZFT5@zwe zQ71uJp!f>YXa`lnM4QU;a<=P?2a+@Obd1JmBn2E1!YJ$VSE7s4KA<0!T$*qc4TbM= z#IxW= zZea()7D8u-|I0OU(ur_7JoI$vhUZDpa(daS4TqP;SiOh@OFB!jD(=0yxLGvAtGf`ef=4qs~qn`Wox@bdE-(&B9M}!vO9R%M;785Y91`UGxeq5qc)@)9swboOBso)__rcI7hX&l zM7In7Vh7TxpcPhMoe_T*i3FOy?AFY2;fo`Ibg{j|c9q^Sf7 z(IFb3atc&i{7#;;;fj;&MwejgxoAutAm}_lid|mM_&n@<=|9AD&!^-3`ombAo#Xs$ z#@X=-=cj9|&StF69qV<+deyNypX2j*6@MpdtWH;0ovyJuSz}&xtk#azS;y*Zjq|fr z{61e{eYVE>Y{vQAF?KF?@OI73Y-k2>1LH*^PVCPKy_&;wZ|J%Lcj)nWl?;u#}J z0sg{H!|hYYfA#Ng;MaflwXi?_P2lpqF{N!vB1nu8IWZ;g7a!(Z{=Z&Xp3j`41xA|) ztUkGpIx(3E{6NB8oy33}(=Mtj0Q}V36XbJEFj&kq!lmF`aLZ0K zKeg5+1Ul@HfAKCk!j_OkW+U(5V<&c{DQS>Dlgx;F`kYt;m-{0l$}tNuJ%etQ`x{Ck<(2Xkg_Hnl^(H~9jvf{#ULE*$Hml2QGjYgI!msz; z%8#0is14#G=M8-tw*~WFpMhx?cK0)YYfl57`o*x%{90hK1Dv03qDU6RRUE=5Q@6@) z<4rs^ei!`ZAR%R~!5G!c4w}UK07&@auXrID@tG1P@8r2FYz+L=R?48Ba5|cc?;5QD zaVP$e4zav=whaerk8R6=suu)oIw_Syg+W}Ee4v!|G7V-059c%C*d+@&XFhk{&OOfc zB7d#uo$6KsCCY>;8R?@sVK!)LI2^?$A63T#fPOoZnk+*e3P15AFX5~Eh3AQ%#~C9q z;N(%XrD5^H{~Oxpe&k?uT`)Z5qT#8RCOqYm;VGAZXY4mT?ZSko zUTS#8MZ?oBO?c|X2~WG&@boK7JpJN?r(T)xv?~*ydS!u6zp}*BFE8+vi-xCPTHxtd zcJb6JOFaAPgvU&A@^dVF=3Ctn$+7WdXyY5@9c3i8(3rh)^MkTwpJ%f%OpgQYaM$>&H!TYwH>eNS zsn}9F5C%d9J01i3(A(kf`FZ$qzc>NWO!^Z+(jZtsO@1m_|8$B%uS2z zRakaa&(X-Xg-dNud;}LyOJ;&6JuZ9`eJJ#r^a`7D1PFk2nnp#ap91A1O8l0dh+kzIM0?U_V)5Bu3%~q0wBze=Go0Nx!QXk|WAI;p^^uYVuD=T|?3>FPcf9(LmmXj2TkcaEr> z&A^q_jMu*US$OI5?!ong^KitZJBQdEu`pWd%-2;k_MSCD;|d-c_IJSG*jY4OKk4{u z-}!F*_9N%mzc8UC|M)Ue8}vI2XSYxAn!oWByy}Y{i(5ylAqHn3*!8ZXXhV3SBt2%@ zr3N&Mk)y?AxVX2#_rB>m{=sX03iEINIIwdC*j2jTURobsKN5!q_DYgNA&hnv@lR9$p z&z&&{F?!-4uQQHQ7Ko7-jUoYD==T!x*f?#)H6C`gk6B6qX1uVD?&_4(MAJagel=ls2M~+MWLgVvh=O2TbBeGRy!Vf z{Vq5vPhoYfw09bimn2OJ%-{iK#w5oH*a@rNH!7ivR%XtLlhH^C7l?Vy^)dVdZvhTI z3ZHg?vs2*e6X45T(k>?&daMU;e@TJ7Q=uo zI4WauI)%Tb`D{n{Lomxd^@fG}20w~^ZSaSm-iLmw9EyxevjZ282gZkzFDf3YNPMy$ zamY5QU%sVppo7l#iCgNc9MNEB@>;!0IeHWx=NVBny9Cbz| z4BZ6zrq7(_Q1TPbEpeCZjBTgRfQ!_HFKIZw0kbnKUhuWpdC}j4?_UEBABLmB7fWDv zT-=@T5-|J^%y;MyLZbZrMux_cK7+`Wq@-Ls4P@8;h+(Yx&)!9-J3Lqt-5%4aUbb|yszH22^OOGbTewbvHr9xq>o zX~-Y3#z^Zp$oDuMI})<^$8}R4BSVo+MSz$ZaPiUtKlOWO_{Tr|tC)Z1CxM*{z;cIn zR_$LpQ1yX&<d0!N);i2uR`#6iEQ z-{}L2ejCPV{>IVoPG6f-PPAp$AN8fSCEwM1;MIowV|1Lj%%Y7+g8ZiN?N=p?|)aSIL;;~*HEMCbEY2=4xObf-uXYwg_ zSaJ%u1zvHIJ91Pt^p^ZLaM5(^9Mi5Zcf={v^wT=-!Vvj`&ddsNidn>OWgqRzTsW<7yKiv zZR3Sx!e*r-l2hK7(@>pKX@keb8Nz79Rj>J{`kBBK`3YvlRX2@zWye7FAZINYf+GjR z@4zP~MPBd~U-Xx_k_N$uid$dRuJnOrB^SYqFAP?!<9$492D1fhbq<`~z~XUF!p=+o zK`eAWJ_b&2!=?q?XZY$IFyO2Mho>EfXO4rjHEy5A-@)08!_yguryU2!GY(ExI5_J# zIGu6pWX5eiKR8|E@NA8P(;0^+YaE=eaqDD-+b1jBK3U`T*^GX=#%c!jDH4}BOp&{} zEc7?l`v3+*YcYZo;u>=7H0Kzd;mOSIXk1xSyj-dRa-EI%ToM>9E|$DFY~S^E>%b;; zi4urQI_1y=1fVVOKw=U&V8f@!yTlxqE-vwN?>@!1{;OZW@teOte8%oRVCyK`nOxL> zTyPC|ykFx6=+jk3r04hQdoV^FHsH~2<(C|6Lj>`8+9GvTcA^-eQ43Ib@(H>!86!M^ zeyqeF+1IvBxsykdd|5*T(1yzN5Wj4^n+?35c3xs6C_tjWag`XH(_!KPC_69?sk&gy z#MvV$b7O~D&qWh?6UQS^#xdlXwyzKgfEx^`-$woclp!*qiMENG_vE$ls0-O#u&ekt z@gIo9Udflov*fEgyp@=kiBpV7wRCa<=t7DBlIi7n8Uf3yoG0}~2uvQt(5y!+P?&9M zU+uE4o~g1Fn@mpXY9D6@ZCbs!*8h9)W*(IquJ^aEQ|aHnHcV zI#&6jZGpr+=@*GqFr&k9(yUL&FlfjcF#wk+CRQA7MM%loQ#uP#e{FY2pCx&cO7~(fr*CaO9ZA|`z zhxA2t1T*oG6Xti}V+2gFS-v`7l}YdgwwInG3jMm(N_pY$C`m4zgmCL>v+#5@R`|_( z`fjls$d4X@*%@{o{3`5x@jnDEKN0=b$Kmri7bOyGpCe&n;1g*;EOv}bvb>4>SV+;tfMiCz z<-1yG!x(E!d@TYGCJz5M@l*GcN1Be4AC7b~FX1eos`%E4tL}knrO{4xY=O{~#*q|_ z3Y%hOi$p``*`RbBk{;sS#4{!(;#bl|JdC3tiB~dZ@P|L6ZX46c$=gV(gBsF8J4+l; z5-3&++lzH_LAN^Dpv?wOmT@U;Ew-``pi$7VE0g!U zEEq??3i~T?y2lwt9y~ML^;~)uQK!tBf(p$U*_jZQGC7SyLTzQPRe=Z?4%b^SP2i0M z1S{|+BZP;B(pX8#P>sYR3*CgJ#@UWj!PRC_1R^uOr^6=?l2+m*!!QHZ=fK_tw9oo_ z`0^5bJ_FwQI^g&gFzsy8CfsvM0vz3-@@??8;O3+gTQsPg@CU!ISFnqB0oR@s4h?bm znd%xsHr}JH5KnxuR8!LL#MzjcZ{UO|-x@6EVu9Y*)SNKV7=|>!W9LoAU&MM1S{)2? zte5Z(U_ytZp~rNiO~A+h5Po_PBWw^~i`>M6{HiacL(VnzmM|#RxHL7zGF5({OnT8n zuo-eK*f!?Plfg#IcIvZWtBlhwq{_y&w((UP;B!{rz!6GnNW0+ZS=BXN865dN^^Lez zJ2cXfJYdqaK8CFh(H{RSEI#{d(C&H){NxsVeS+Sm;bxk}Ql@4&yLpUPzxeU^pI`YD zoSd%FJzhm&&VWF2TTU4ezrj4}EO&+gF=`^bxGw093lqNm-~2KD-@o(`EUxYf^rk&g z7tU9XE9WzQ{9B)cmp=aOAWNz;ZI&IG*v<-|+`{ z+oLDg-{EhH=Q-LF1gv_bT#LoEJ^t|A+vmLLbB{M?N1VMaOzLO2Qs>bFIkE_{T$mt;wCL<^LS z^3gQmHoeYuJ>q*FA;D=fO$+nIzD|D@WClON?g(#ck=W$DaRuCv4J|c!YPj|wC(Xn_ z5hn%;;R@16Qef<#B8K`qLaP#PVQoIfq=)HZm56(Z4rw9j@QE<`2etcX*krX16FxL z;^Z`n2!hW{Jo7&3%ZvJy@cMAx@RDRWrw)C<18phssP!;(0DSI|3;@`4v^CJ@+K6hO zLWS^BU1g7800Es}$tY0uPd5o$-xE#ZS$PfcE@((NahWhm2`OQ2KPuD-t$|NoKlp z-3jkI6C0=Ex?t+Q)5VJNqCll%@4LR2wiT$?>o|`<%ns&mDm1td zZbPt@2Xtn1mLbSOk13#2W;y+$vVvEK-y6C$7$$gI03KU`duI<77SFrK%OAOLGS);i zcw6Sy&6p#W!$+*AXj2U3_l_Bk-sfn`2OrELfaM^lu^u`w5wEqQ&vE`qh&>#FzT31c ziAFX2A``M2AfGm#7rra`L2)AK_*uuOBO4dX0sN#+3bso|DlYiFl#!gIPyEwYE3#Dc zX&3x1{ZM_^6d3r7&eW9@IC&>{*-%O{0+VPjqr!skq}ip57NeJ^C$N+2SUmYJVeyjx z3V7O=qMsa~pWFa?B-Tz{GmCK(@ils8p+A6S>;exC4E2#?GxBHbV2X($M54_%Ov^dC zhZBvnd4h(yhaB3}(9lBPxJXz&f|$}VbL+WbBvhdog_Y`a#{0>n27w=0mz{v98>do- ztWpBKqt9G(ByuTAYb{>uq5Bk5@`43PNx@6d<8G(^-Enybzw!sC_=bP}oA}c={vdGp zD186UO+5}l1u*0HOwx-#18K>Yiw-GPsD22me5W5xe@UUI9kP6@n{KvkzXVs^H!-Q; z%spW16O;fAl1P>=$22rvA$|2buXLNB;zuqe=v2O&tbC05kf3 zE|4Y-=Fyqct8O&<1p1CZRa1#kZ?khHq@o?CzDCD@$&l7PnZa=FxqAORkyQpMA%VeH zNraE=5iBocQm9)7k&3~4dS<3Hz1%Mh76NH(<^G1?z^OIcbk0tWs(m`RY)dfRX!ulU zkS@``(N;K+yv%^rDQxc|@T{+fU$_fxK83&Yb?~Fxz_g4qS*7w-_=<0XjXk6qtHmsk4Rt?73PQ zjil_7U(yHiTDns3jK{?Z*4`B)8xkjx5si=y>#5BRywoOPPaDemSNmeGcYT$NKojI8!GBbZlWo z8A>+8x*j7y`p*GaV~pG6y&3&JZNk}JnDOu_tpRsjT;l)a z>(9fk-_o)$@P5|b@9<4$uA)W|p{NoC1PZJ`;sjD)(z!I4R;KP4qYS0C-K|&pO0Fa_ zNEx*+;}An@7_>qhT4JjaLsimdo;Cm1-}xSV>koVc+lS9F_SQL81U?iM3EaQjh}d<(ovW zD)YhU%r_=YcfC7!u?i2)u6={X)$1-F!!_^rMVK5&8`e&=2M(ZBK2`0x+> zEyS%Sk!O!+qr>dc`}!H=W9ei{->tiq&-yr)Pwn;=uEbR#yR0EWy1ZyQ7oohW46PGO ziFGwwl0FQ{tEHjS)cw z3JK|f?GDEECFNM<6qR+*8Ray}=eDhcfHkpT)yR!93Gj1S8{e>VP`3rmZ<~K z$M+FMh?R;O@m9JD&J?*kc0nu(LIS zxG)^=tkV1fy$o=}!$+>4;=lQ>_uyOp)rYZt@EjX3*!Hj$X7XUv1THgh zU-qWQ@bvQ+oG>bK%s#;4V($-EUMcW1-o{lK$rq+O-2%_v+2hOq^1JY}Pu|0ot0%yo zfmmoSq0ox1h(wMJ?!Rz>zy4Lf8Q<`GUx8|Wq#7piLtMuRUj3TM+?y;8kSvI5)o zj_tAC8>i4lg*^Z|uye!HZQ*1BTE27~W<5j&W&!qw0`6@V9LcITR13ECLi~)O6_H?L zAbWr{r;fQ1Iw&Irpiu%ykNn+qXi5Y$e7j(n-=p!y?*ud2;jPIdZjcOn$i-A4Va2kL zbw3xt6?GmfXcJ%&;7df>+4_44+=#bK0hKQyIFA+LSiuXvU_?{Afp&;yXqj~|ZP6yd zSka7MXeeM{<+nkZZVb%b1!BKL%uB@f9OL>cfXka)wFJnhY@EtFpddlG6dt};nZ*xZ zGWz1(Qoxc2Cg&fWTtjZpfs=FK^g8n78nC^pzbothb#l%CWqZc-n=387-k)4s`3v4vV0(?_Y_0$sKew_@1S`gpbBgw2i{zH(GsHjX zhaGI+6b#MSEb}?ZKZ6deAUZUU%(@5rFgxjH3$vx2ZVg*kvuz4yWbJeWH~rppd3Zv2 zqB#)js&&%1S})M}V>`3Hm5w)^vW_}F0=uknc>&yd9OLD$#_1P*15Q5gtGRE@?WZw! zmz=!py+Qy^6b>NgWJO(-4DlivJnR&roPCC3zlN7mS6x7htok#5&#cBaDpHBg`45%A1m@)1@Q(rq2qXOUG4?gP#gqx<9n8 zh@4_P_?x+GTPV=~+g_E<^B`SMP~jH6N=6)1=5&X_rs1h{6V2{ac^fz9w_>8zd$5jS z(Is1B*?LX|bqN(_V$53|yjtagRyQ2DbzdVNQSOAW0@lxkLw!yzV+XtesLro5PwJw) z%5Du#0g7eGMm(o=1k}qjpk8F^Yy_$&7~$2D^u3J1+#9`m-n`4uBG$P1SqX`a5ex}b z>7<;zH(`3V65EKJ9&*+_pYd?yEanJ+-dPGZ8eJu9u*`zlD;~AdoiB`gQ)(O=i+ED_ z9PtJTY)%mOZzFF#i5y$Z%e%-={|^wq{r`+OIR$q2B&2Sf=C^oRd=cK^i2yFfxHczY znrw8YYsj#8%AEil8LG?4Ty*%Oaf0yZSK**Chw>0<{)Jl*eutxb=h1s=vKhVf$z>m* zS2qXxV4dkW3yw3T-W7k$^Cpvmr?dxfOsaLn@-%y`7ulSV9jY^%zE-KE>Bnj{O0<5psy3ot$q!fjCWU-}IH(e)0bkcz zh7bMlcL4XE0r4NNy2|($x6p*MVEu=28tM)1Y4>D*Uq1;=D?es<$e* zGB5Sfv=|@z2A7pbX>9k#xxjTED1WM$xv%;%%xe~+d*R>b$@#r`TJVgYdCbd29r7nM z)XquS4AU2mS;0Q(;hZ1?RJzG@zNGQ;MWAg@EE@zg#BDu*wj5Q<2WZ0ey^+c$05sVG zym6lT=15q|>k6kX2Ra5MLc#<(x$lLvg95mP?r~4yo5ovL-TSvi6;scy?5#1Sh@!dE zna3@##`rn7Ve~EePX-p(0 zw31J)J3%j2c?aX16I0vnj|j}kjR+A@J1a+M(s9$*)(50uh`d?m69t4nQ1grIXw$I8|4h=fE(?Zfd24$$1X3_TC5v*6Dy!1u@sNABn(I2Kk`eFE9@mFx{sGE)yf80wE%2UJ&SMjI^4V|~CW!$0n#w(ic`mf_} zJci1Ecv-Y6|A1&x*&#mIK#MPKL85i(o8}Iq$=Yc$!WY0pzVGfq5UPv$#CpWrD{^WU_HHiF+y^}l=6-Y|3iq+L)mh4Hx zWYBhgHgNrP;IIC(kK<4Mou9$-HAUztV6pi~xHIX6gtE;XJLw#_7oRR310IYvns=n97r)%RZM%p>!6u z;7;icQpzU(YC2Wfhd@ItAlwd*Lox}yy4yJb0RQw!L_t*hk7mdAA@;A8M{vxO&aadm z2u-G4yC`GRd`1P)SSz=tU`7x8h%*Cg(Kt1jDmHPUg!pyPfJ*Y-_y_fodBi)|U75z@ zF&xI(!6h{J$Z6Ad%rdGRHAw&B4p$a!&TmF>& z(d+WXkYSq6>N>Pcl-D$bzPX&}go>Be4`vi!3`{+F=BbUVNU)RfOXqWTeJtIQj8nw9 zH>UEdaHlukP@X)}C(~5CZ9GlEG#=)Mzg6(j4b?ceE75qV?>2bo8>Ay{2!sPS0Z7lc zlcN_~il%ZPy*&LHPC&{q9SNwc;Y`Ba6_NAgI*$m!c|NzFz&P7r`vqTx&F}fY0gt{O zxb+O;{_WKhs9k|QG!zbG#K2Nx$ZwIW|Y`yzh z>Me0pp0FNbDcO`?9m3i20V)V69@VX%RrwDsY}mVAR~iLsMN=5aqK7K6hG?rd5T>p5 z_CO07EO!WJ(`1~K9iic_>7iA^$RU}ACtQ>NnVP#7)(xmJ#JPr9?>+P@veNi9pPPx? z@0cdjGogw*i%6DIw+9Y&E+Z$x%2QFB;1x530AvJpH3nIVsr&kLq#y_BL~82$fnjtw zHXOs0qC1W8O*AFbr?9~*e>&3dS$BxjE5O+eV1FMu_sI8rAM(RLgWM;u*)Acx2p0%% z;Y6ewzm+gn-NyG);;HodLApW_48ut)zG*dqzF(gzeSPyeMOA>DP4A7EGE&2ehP(1) z3z~av;vmOxT$FD@{}g|e-gaC@>TIgaoez!Qejhk;O2YBrGX7Wrv2iXs?U-%+?Wz{i zGTaq-Sf5O+9iHwxoe-|*Ep{Ak*!Gf_`Q7ZYmw8bBmilq$X^hQ%Y=7JD#rWbsi};k^ zjs4{g^UgDv`%6S@sMC|Hk^<1MPgULO0dWh|_|w&JhiB1{a)hoABoDUag!1YOViu4` z8JbU|RQkx`)OzMC2N`sjNF6u{>aOPply0RMBR|D|DTjoH0K)P>?GfZ&pc+~eQFO-w z*@_C~p8#Scm&{8i0&5=>_MW*XN@!|J0Dk9Hd#)hy;EfaP?oa$bzWvwm=l{`9;PMy0 z9dY*-^2%dvpPLp0W6{HB`3dtAN4}%dVf9uHhryzwC#v$=`{MJG^eQ(G{fFNv3(I(k z_hxQ=Z+_n8IdLfMaXvKvnXSCkFD%5y4=-kbe1X%MZs)H?lBF(?Y$bibj$z-Mt7b<{BZrLcq-x0^jJR1Dl?| zeoTy_L@SC7#eyon7RIa4^s-644_7!{+07&2@G`reU%Y9NI1f)I}5)rJ<j+4_E4;Y@ln|6~K3T7M>Ryqwq;-&cR^nz#FUqo*)u;I~g3d>sjs&Y)@ z0ps{?^2B!Rp2zsq&%yT1|1XR;ehp%C1$px+9;MP3G3@u;=SdataF?_jnvwxeBNt5$ z1tw{Z5y;f}L;&Vgpi?p=Uqa-%cPT5RAdN+0BrM&9VLsRgazw@e0HMo&z>LAp*0+`y*i|#-)0ty6y zoD&aUJHg{m-obzN-@hOK!$13J;2qzNapxBD%0r@G3=8jva%3}TdNbNi?_v9>LYv*| za;0ovn@iPbQnn|RJKD2#-0~0Eik}V4I#`W7RrZAx*6)Dq(7r<%vNZ@QDADI$*Fkte zc=#$B>@U@Dac^4D*?8dwqq4Eyv>$3TL-rVgr7a=I56{)JJX(Nc{#pM$B<1oPq{V1{ z4rQN2!#F5S9M?DY9{`X%{CjZj9?*g=KzmXNW|wIwFN8zCOb4J|G{GP4rx72gR;CBM z2DD_#o+EuXe}g&@;nk^1AL}GEUKX5?XpWnjYq_iY4JyuL)zH8!3xiSbVBc}FWMA~mvJ+%(RePW=2n#hf9pf> zx|Np<1o&HpES_l94(~<7fqsPSL;4!I@Ujeyo9(R2+InwzA^t^oUXsB~;Nm9Y@;Pi? z`zbj6y>G$xO@ADD_=I5w? z19NTkX||d#74VP&?7K=-pv8dDnJABez|6p2`Y0ug^Hy;D zJ+SIV*$30>Z_dUC`J!SsbtXj%CnKwDm64$Q`teGX2jyK=$Q0}$9MHu=ok%T?Kf@Zsq5YaQX72&vH+(8*NDHRO~Jlx`r4GIs9T+^X}!$iz_N5l}`CWzr_7eaZ~w+ zjILk_c6auMGZx))NN?qY{$GaE01ZD!?573^mYyezH}hboTAd1FYu2YNV{^X zd>K$kmpXl&Cxx#cIzP>aY&z&?{aH^#aCCvbl<&nI#Jy)Q9(xtGzw1w6 z{Cj@}^Px`#?mUNi=V^grxy(WwJ(-ck@3jjtQ*qVOs=!zej<%GWc%*3o5MvAER_OB^ z_v2Z^NmD&0<|kFy!Bsa~9e`@GH53P^cPfKDCzgX%)|93&5Nc^bL3$@Bn@1ix#ZUg*r|}hk^ZoeO zKl!h)dFOW{FA{m>L2dR};C1=U!jYGC$^K4xQu?DTsJ)DuZ}(=j0aiM*+kwm0eer40 zQ#|u`>w7vFb6%xOtRR34Sv@8O8qpfWN97wfa2QmPu=Q7)@O4{v!^;gF!|C+tGJS=U z8!qkYdW-IhjfR!4l?4Su-bXInU}{MK@@PPTO$%yM-xPGyr|LuT-5W46|LQ^MWf)iM zOfDau49wC2H@c5+^d$3e<3!~T@jmsK&!~j`A}Kee$6Lr>M+j|B>b(B(Rmi;o64$6xbex1syvO~DL&hy*Rdd` z)w~p<+2RT#WS*oHz6@Qo7vB13O6d!Pb;i6@dB)GYgLqbH1i%Il8-s$JZ~=C79g%KC zBFH$G1CdM}3|JRTuirUnb6F0sQmwk84U3ni&3NfGLcxrRTr^R>?on8+RT-{%9?}ET zV3<%@rr9tp`vbbL#^y~{4B+w}aQg|wgAZf#g;k33{+k)j~l2etg@=8_)Tet%%Pr9izl$T9c_Xqjx&w4q> zwyVaC_*(T@w4NZN;IbXe1fSU}+4vDE6N}z-W6{3CK)ZkU5S4XgZ@vqr`5tI>oXhoI zK;A{a@f4C#NG4QV{!LFL*3laKz930?0WDZ)!K(dTgaVk#rEBZ!Rli;qCGu{2i>MaGLixNld|0Y*opbCyB!fs%Y*)*84R55?U+}E##YfMPkpZ+wzxZk=Vs@bMt8~}KDZE^Eimqs7*x1Mv-FJLj4`G+HuNdM( zw#j#RF@KE5@x}BB<uqi_2S zeE41e1o6xN7#Y{OD|=4rMe&K{m(G+e*`}?RD=E{;7J!B;d35N5o1GSelrP=zUHVH% z$|pIqoW>K&-1&R)L(I)=0fd}V>5%=X!Pm&cluMR9WTo)Ob!Q$JFqS z{l-BdEv@mgUogM@H+62IpAUFHwQSzF98`A1!@(<>Z?Umqw6qFvJVXfM#;lf6V|GY? zjd$@;hz{Wl`7Jjfq2Iv5$#S0Nhjqw%aH&qSOw?#`%z!H@G;K!zD{=(HH~v2t}_xypp|wpS%DeLvuJLp-EMnS^2I;wxI- zqO%!+iH*khFh3zDu6+I-au9h$gT>zs(SOFT_^P}e4}$}mgD{FtEB!azevM9NFUwB4 z)9SL0Y^L~Scz&5$<>U7QxVQz}eHwA?8ph{+Ikvy=&jP>scVq4ndG}e&yhLucoZF&S z8ri6zW528Nz1uSq4hJti10;ZEg`3{S|unQ1Y11QAOu$p8)Qhs&_N~J*PEh$St87OJ zBU(LSMm0ZSp;x0rW%u-%fBk1waxQ*<8Xv(f?c4aRR>5G z1o({^77?)G>M`d^6x_I?_=&0dG{7@dABMP0nxAU2|HP=)&cZf zWVMLbfTDMek0m41&@U^oDkB7ne& z-#R>(X{Tu%{p)moalo@?kI)>SJ5ORf@DMhi`yXNZ#eWv#^>4<0m)PBU8gqYNVS-jW z&3&DP6#zC`)d(F>nA&s0tZ;w?^~_{KoBD}0!gXvmn3kRR$G8BHKySa%``fTY_L!)v zy7A3p_-wtcw2&%AfH!%gZnf`{W& z2DIrKDMx4s%(ya$(MmFl-+LLkhs#)MMH#e(0O4>I46I@aoSvQFiDz!(&wj^y@K=BM z{h06kcEo#s0(tfru+eGqklwpOInZYTN|uR8sZZ1U)OW~#^!(=Qls_qZa(>&T{B@=( zUga;FN%@p+d#-boI0Z`_Gil~!`6T<117FaB2>UhDXx~d^Z2qj#*=VBtY`gky--qr8 zQuUJYP`O@3S%2oU?AE>^LXDV~7Lp+v?=7FbmW~&^g)<-@HSHT3?)Dd^dl9wji{gcY zO4So1cwU|5mkK~a_)CWgPWh}ujF1G@I%4J4H`4}GT);Vq`d&J%wA1&5$0CG(0NC#U zuUgf14IT>D<{T=k;YOxdc);tJ1FBr^P1| z=yELI5ejnbL{xr2G%AnFHX+fRhw(Mf40{o^zK4ULBYrHzbn7$?p3ATN8_}L^4#JU~ zi_fNYp;Nkr#{a?46S%ko+9CLU7)Tcbg7K)r^OHa6&v64unhK!@dSQ0wY-zM({Wf&RL>U&IG1be9fSv zXK#>X1RkWyu!q2im!0g?@g7aS2bbtf@JuuSz+UljU~G6E(wzGWP&Y9!uAkwrzWpx# z&X4>8#ykE$h>!g$^4iN8(57tO!H;DdA)g`!rQTW3tVd+%$_J21WV{$A#*L=Ou#L5J z>5AL>FZ=L!vT*6HD_JI18o@MOA-@yy1I}+eZKG*_rhB-aF;T+D^Ips=D@8VV)w3a< znRgwQCl?O~V*YNNDEl=OeC${4KR_9z=JX_olxr&z%r>`=a4C|;PuJU1{uLowiNhfe zxUB^=bPKeA!oJ7JS&(FG{*n%^M3fv6WvdwMWZ*et)+yrWy{^jNxlv>uL#W!V`em3N z4TAyg+%T+pR4{LC7eoEkq$9>~jcMjtSfaQaft3k@-I4UKh2ND30+&aX9f1gr6Sga{ z@Hl|wG8#U{A01~g*2++2Hp4)t!FU)aalRtumQLXLH-X)K?u~NuH-KOI{{c_@3UGG4 z;je!(RdIFz>t|hd5XMiq*npejy*RUk?fdACOZXNKntba@@eGUaHXH{$rYE{Q?64Fp zi*ekL5g0I2&;y;J@&0mE5 zJ}_@Rg}l70$@$)e7C?5at&tdoDe+%=OCy`ek z0X7;EFpOmREWj1n!i#A-k7VDr(QNmXrTHEUsQa4f;7futobE%-s7!rVTJf`(R4^Pw z$z~wiO6RrhOV`r0`&U=0aNAd>tI`#MOCBlvuf#2n?cASz6Riit&%(DRQ={RU3UXZZ zFs}AT=pPU9b)D;PHHljJ&C6(cZI`1p3f)@?^T#wQP3eL@T6bKAuUI;fA)T1AKNh}Z z4K-q1F2L{m-UEge*qh#ENbBnL@)W;azM3fXN3ur+yyV^x04|vzlw-vWDMF?y3p1-B z<3iVqg?M4-JT^!<-^!=ngHV1~MrKg9ayqVM4DENcO30TD+po&;AE!YpvwaKUmWAJ^VIfuh!yo3i@zQVh`hl~{Z zZUsV9+%$|-*{ZOk7i?Nu+Gx(_AdTnvD4qW-kEtPs#BvV6;%jiPmIFDMUFjZ6%fZf3 zWy9aZhK)DyJEFIzGw^7<^6QiVyS3|b(mE%7?G*uXInd&vT6w8q*MpX#;8s>UUu7*m znh9Wwa3*l)N#OE%j8}geHedM1vH4wp8u9AS!~Xsyc6Xiy<~{ZJ5NEQ~Jv(&B8FWq_ z${COh2Jy<>p2I*%hr&Pz$f>z8A-^V6f#gJ99Rra-Ep6XxqH%3Nro3~nR-~4kS33d3 zSN{_hpw=qZ=7Qp1C}3frwB8{IXWEAa=zfDVI<|-A7y<0@B8t?F%;1WleyK9y{ylJ* zN4~joOyd=t$em1SoC51;3^uGer)o}U;x}8%xj6%_Jc#`}|0(7V|4ra>4_tXrj7jR3 z_1!iO*)x$OZXu*#hK9ELU@MuQtm93u51vK439LUXU6+Up58vBwpiMzgwyG~&Cm5$O z)VtikNls+2D@N;XqtWmS#Uq@HUr<^01FE2{;|MBiuaYcJ=P$VO7tUvV%_7L&Vc+F@ zPo{1#L%gq^uOZ&quM6+YniO0_7drYjwa1$MTxf_DXu+QTTn`NIpVwfzyfjY2z5Hjc z_#vnE(+UcCYF;56G;4@!G9AWN4Mb;mFT1C>=z|*`@DVZ8Iqn}OJfu_Xp#pu0B`_p(eiP?V#58Qo^@{p4^{Zi4+*cbn$gYJOh||4q?xT^Zo+^BFdXq6;Zy=@ z!ZbX?bfuI@c*BLZvWgI;2dFT2UqD{m0XFBr*)`E8I5SoG>Mw=Q{sP$D<4N)R`+B|r z<|Xgvh2GuQ`}-VL+v|7U2ln@Pzq`lusXUi=f!$qx-wFP_59FoNci8utcXz>bJK?gw ze^jfxgt}w(`*( ztC8*c>_5>Qrdur+B`-R|Gzt$$-u<|k!etf5`@_>k6Scyvs|j=)zr$PyQTi zf7jPzyymZ&E+yE{6y!YeiGk{W+cC{QZD zO(G(|-iko&TjMel>cNWa;EkS^81_^S0BdM1ol7qZMgWcw_(N=^)kz+b=|T4+eg_pTyg5P7-#BMUWDwV z4gXtTo!?oVR~1ab$X0)d7sQM7FrDF0PUbI}qJ|C`x$v0EG}~Xd-AwugD#-fgx+SH9 zQ}5hEF`Y;EPUE~&L$z~qPRX3wBEuUF$`|f-{L7YZzZblA-d^Wd9NsgDdeTj^TmXO- z~Kp7R(7zpw8LG(!2R;uSvVL5cBl-XWvtxV4HUg(H+Mq(DUr z4rzDTI8~0z?ZE&Oi*6%t7!z@J1Gzn0#^dyrUwIDr1`WS#^{h%+XaqDNvo`*tp+)$R zMmZG(>7AYsD&-s-;s)*Dd2v&LP+Ltl%>P`xQu$TpLP+_btrgt5bh0J`;{+Mb2s+@s zmT7jGS_jY!_JBwFCn4Rdmkm!edFZhMy#C$!LID>JfrRJ^=~QKLK-bDIyi`c(WdU1- z2c*|~%6o$Hm=}nv41X zW5W`)iC{{m)$Qy63FJF>TQ(m!j_zdSoqBu#E;FB+*c*uv!eM~H%^t{2VE^L8v@BJu6Ti^>lQ#t24MN2BStE1 zdIw)+X}CrVR$%EM$&3SWaQP~{P*6G#yD$iK0UVn3bAYQAL-~lOe5v~;wMqz)>=T`> zqV*N4p-#N%BSXVUTxq1^UIu_TMV_3Cj#gI`ZK7jf)oCGLTlEw4zU8TR=E<^~#UMAJ z)Qi%B3YElXA8PC4Ct!cv%1Jl&usSP@U&^=Gho}6U8yFoA;U8c_O9%;X-}lZ6Z4m%H zn>Pb%E>|+RDZlG<1=jXQS^^J$PBPMixPA?vo)`ZWC~V5%n^ZQ z2!nK1@ZrX!s^XqaD44+zfvNQSHiF zMcU~Im*SE5H}{B7{SxHWN7x;h?84(|xK2tVsc!T+Hh2-;7aZE*S2ZG6L*d?McZ z)t`ntcP_D0yIKo@-w*qWB()Otrvi+kBQG(i32r; z2Fs!SNzm5a0C0H^@!%%_kGvMKzif6PAESIjC(vW?3`5J2TBKe*2hH#f$^4q?1sfxP zjm}jY8wL>R9loVo8QgGF4X=m|W}v31A}9Tnkr4cn{btKv%v2Ah8lO>h8Dv`uY^EA} z5et7;{=o`8u;H1Gk;uu0qnXP&YJ^F5ubw`rVvlX%S$06?vG?=ZgUAoQ1G``QIriLz z{76DRsObjuUi>QGAib-4Wn%f7&_7mA^PxXa@j`f!FMcN*mfcq!4y8-`D6DNv{A_{D4>FYAj2tQImak4i$$3WoG&vj!(jG1f! z)N?Bgomf{OLaLZ)99l(Kj1Zy?sfBN=Sc+JvoGu8Z^*h+{F5^(*BgHWtN^86=ME=tv z$1X7EGj3KQ)8K>#BiPI=-WZq3py$)xj5vFUJM)fFD~q_d0fosq7ZT5q;!SnM4z~Pa zCa~G8z$dkVS_O_oijHbeR3o^2a(hZAvSBwQ(}}Fj72y5fk9_9WfYa;hzO~WHNJ{w{ z4^qL_lp!Ak15IZ__&IOM0g|nQU8RT1mK*^wrOUMk%Qjl&dnvh~>xSQV+WcNJNvsBd zuhK8+PV~TdB|E&#H>d4}Dj8qi z`Conrn}@GpRPTmGvgq0E6W1?xc-x=+Ed2gAJ%(qVztE1s)(g*KqJ1*p;$=KoNv?N^ zl#7&|A+a5STNe|5W27JXD{fV1#i>a4(k_oFuOa?Eo+{ zFt+Lm-R}XVkGVr^89W6xD@Y$3jG0I*9FbFv3;Ht-OAci2Wh>rCSmE~AV87E)uS7AX z0-y&UL%#E0;{MP66X3=plHvM6ZRH@{Fu!9c(6Qfb3WfHrY;ox)^S5-c$>^PJ1Zcjz z`BXRTVH<9FNchsRW1N^_;Z)_iN6`L*esy7Do$WN4e&VuvxQ2AiJ=T;Tl0JhZFn&K zwD!pS*zy=Rztgj$N#i+`w#xDQ=5Q9`N@Im{>)*I5#hqt?i)VrR&jNRzLf(A}xc3xr z_bK4k#}PL_4%~hMxbpKEfV)ouH$R4W;WrSspG4ew3UT`> zj9X72?mi9Nc}n>|4%~hUaqCIM?WYmIufZLBFclTDn zT8b>XJc+sUGOfwxt63ao;u5mqRF9f?iE*fd*0)d|ml5W%(k0q=2ie_V4Ua#(?9`jl z*OhW2(uZjn?n!IO!tcxr90tWs2bXW&NH-INyWa!%o&_$R!+78U;J5r9jNkbuG2ZmY zkdOUV%-zJi`vUUv4k=I627Acl0huZ1sn&Yx{2R`r;arB$P-$wia?U-l-zo0XDli>~ z;XQ&Jyl_s>zPRO;R~&lS^Po&f<|VAX*x(v7MO zVzcEWc?|YY$tHNQTK)rOSiXU@g?(YM0$4X1v9t5Bs z9L=loPWoY4aVPRQ_bZs+?-99Y=()cHu;+ZX-43zeF|1O)n3oLTYBzJQOx^H%@sAtw zad+T7>C$1du1t9;u=lFLOvJoIJE+7M+YN^7ilFREWcz9av3J61 zNIouEYBi>Ash{$7HjJttTRrPSC8w&FA)Z6;3$TW~oX_75e4ajr-p``!#etSUvK*mW zus20txl7ZL9e)8a-%K;sclsdZh3oK8@I(K?^0Vbl1RnWp<_t5F3>@RD+1<;0i#6E<736H}YG!&>9f_FC}==2f53}j3p+!MP6 zYnoJ$WmFNro;N2P3d=^5>79-L==2G0sO;(CH_}ZUtWV~*@|g~1)VB`5=|kw{RHokJ z)d8r5Xj}r#V3a<|N9vr@$)MZ|hR%yrZ&hoFmCk7{1qG+H-QnokT>!hgh|@E~ z%YHNBHJ^ic`5Q1#t|2ck5WBnL-Dc^X$JED$mB7Y&q#cN*!kG*tW*b6crA0oBOs>od z_YQeD!@A@uT=QQ}I807M)+xYr7zXosp%1^`X zyE_In(s`=@dunuqM1*=SMw^pEo<{{vER&U3U~>|9@O+DJ{LWv+TYvc1v3cM`ElKL= zaKM)nBRJ3e`sEJ)(_20hZ~pv8@$3utflztk2TiHnj}+Za%>FK!r-xn06`X8<=kHAX z;lKE^_?ai};r!*V#O8&M;oeVt8}=W2FL3SU?4gAmdP=YC6Rn%2k6mZMdbNcPI?cQw5u&CFz_U+{tx>p9G~K~B!0BC|<2#lgX>P+&^bmR)gv z30a?h2zi@_;JJazOqeCx=yn=YV-tVr6+XVG6g5>tK^wDBdR3pmy60b~QJ_8r zPrc6U&5;l9BMru(>JaYYPW_kcolhFH{H!j?DXlkyy?FuRA9(bQYC4H{39XQK3ms4z z3q^$X%Zvyy)p*#VOi=ot#wgf;TtP_)PFn&wBo59F;e|EYd!v0zsgQI>_YtG!4)KdB z9aU+gy46?Ng+j3L{P49c{+sW3FW<AI0X8bBw)uyF^2E&Bws*{tnmg?eO>h)Mw)N zf59i<+2=245^8{S^>ra*0Q=-hGFGa@Zb-MQqL(hr1g@M7?Dm2G)3^Q--u}$Q`4c~l zi=TQMSCw9UOb(s0XJD`U10q`h?F$bFqY+G(kRO234>3c0gM+3qnq3l(akMV-#`rL3;*l;YDU3P&w;=rZ*-GHFWoyML5GPlgk(XE7@g1GdVzk8 z&hW;x5_(Hp>GZ<)&f6>RY%Tu6Pve3~0voUdNEr{VMqi3X^Y9=I7CkV{>oswFDdmJ{6wYO2IIQ$5kg&o!tG*xL z*m!;*yY{{3ac@&dG0hXSbS9@|JGhFT*4uWFIHeCNqdCzR!931phZb$P(>!x)9l?1$ zmv@2KAFZ(pat3M0z*ry`5S85vqcEh{NT+>1a4co^oFraY|O`LO1#MV4gWifZe zLA@tLmpHPr6E9j%5mePoOpGxYkhv0}vd9cI$7Rng=Jg67#_DBY(2zulmDAuP?U)mJ zIcO%jBQunH{aSv^=HZw%n!YbW^g-|=pI z>koVsN! zYT`L*x%QydkmTvf1`l4{;{W?IxA14)_RIMA&;LWjul_KHygX4hLvwv(E3*Yc{Ze^) zSd}LrhUm5e5523Ff3H{tOBITg#=zS5b|1%i6(sm_qbKbfN*Na|T_5Yx_wc+zCs#Qx zqw>~2%BT5IAz#tUNT+Ey2X%;_V>Qk~!I04nH*&)NI(^X45ElPfljAF zO3940i11}(t$gsa(xl4rdt$s`m>D9Z2n!iWB{e=~R1=W#EF6#0)UzK`ft?(S8Pla% zm9z4g9y#n<0`9WC@6Y}|kUQ<`bHTlPYR?|+|1;ZOLHm0eGSOZ>_1^c|=f`8-g`*gg zMzZtV&kaAz#QAM}=(O7S#2YkSDEjq$kRD4Ab^`UvjzlorGB~~h!r8Dp?oD4Iy-v;R zNb9%-g|+FH0~II@8gG!x`4sOO-~3m!i!XBm_ih5WKMv$Q#4A4qo6r7ojNkdEFy8pp z$d`XQyW;QN1TOD!!X`M$6UhznpjBFI`HI(5E$_j=29X$>4gF9%iM@s}p}9P&s^@-c zt_&-t46r3Nn05{haUcffejPnQn4B2ON?tuiAngfgf+-L_*fXJ|+E4`jn{!1OV}I@RXc*oNJJS>P$@7w~^`%^AQ_WSy7HLwQWBc%{(Cd z2rkX1s*>j%mh)s7XjNLM zw^jR25uS8l^x#d;_9fOu>$h=*Versg!WCUZ{yxa3FpYYypl+i|-F%c@7k~7Lbn`c% zA$iv|F3)8E3K;y&fIu0T&eCtm#=pj8Xz>axPv@I0@M*AsRla3UqgnJu$p4!LmFN7a z;Ku=7=8}E+c$HhcJgN))J<)<6x=F;_K?=@jqM#f__nwu}S?wG&U zhvFO5D{kD(N6phJq${xK6_tJ!!PWcy+NrVrJgF%S(@vukEhb~H9{{dA#NV@rfb)kCR~`heJ_MXU3|x7b>CPTRTzP;y!(M$E zyIWH&fZ~gltnvoJWcVUoQ4t(;gFJH*kNM9 zHtr>3k6E{1DWof59PLC+vtdY<{s!xj%TxN&uVv6o+tRq=Kyq^7{X4+LbHMH<;*nQi z^V_}*n}6>u*!+(F6nO2MkY^7e?>>jPxXE4`?Y|Ub9n=@YEoX2qol<-CGC;vXdX0)n0p^eMJ&A(G{HR93jWydss%=nRreBT>VlyU>QhfG8lLj&gK!o za#IuP0U%mAf<4NSG2j89CCcK3_%g=8usuqw6jNJOlbQsq3H+Sj0n8mYs*6xXX}Z;O zpqVNaED;~;0qG9Sb(-_A2M7TMUy|X;NWA=^Q+(iwJ^t9=`epnVfB8G{!jJzA;F*sg zufAL@VB1FvOeDX$PpnGL&VRUa7Y|c^(UvXu-lLM4?w!Z zMVDcO_-8)p*L7WrZ}nYzG*SVP{f-*4;kvi;0qTq>M=BcRJijr2MO#lw; zBG`*7^E5k&3l8%X&uoLDBZbe9!KP?IG`=gSHUELG5Q|pN`6)!C3x&Vrob*G=z4CP1 zNl(Uq^m8={x+zu>CSp_Hj5kDJUA-s~hMw0%V+qFZ(F7f_6s$8ldl`b2N4-^MhQGTE zms!^lKF%`?$M0nz3E?OdQWduuIrQB)8@B^EEse+EU;m}Rl}C`5_XLyOggkYd!UNQj z9o!s^tydXPBoZ5hE1KkL2E+-+nLqZk$dCR!gDX2B^F^^5Gl)mUV+VEmW*#~}tZ-P} zpjF$L&(@dDKNmcd-aPAkI>yJmHa;>~zh(IlYUz73|-6373`4cnVdw6H)7>G5;B0*>6 zeO#yt;-?*5s^NIH#qP;l`1&t?Exz?@UXR=NE;%WiLMs*E{2u^dKveXGWLo$&Ia&4^ zF?i(qIll2be;I$_dq0Hn$W;u{SW9QMR6hflyNMeY6L0%dpM~G|J08VzFI;M#k??3e zUk->0AN39qCk}n>XW;sk4bHY3eBV26;lKPlKZ$q!(02n*{UUIF1=w7XZw&SpZ@j;c zdyYf)hGjpI%jOPjNpzcdvxLaDw9S^q>$1joN^PS`5TWqW8sNR{0{x~AvC zxjnR`i#Ge7=F_W;hBxvkaFinLJ$*w#Zs?oufriKtPyKBE33d$kHaf4rV+C2AF9&q# zpMr1l&A*nW@>(9T@`mYDz_Mvukyv)-S@A`_8w$3kHX8IdKz>%YF0*)Ie62f;?$RGU zyMFck1nUFqfHvL4^lC2U4a2govaSRiSP8$EsuvQhKcnR>ocK)d7>=UF*v{aD3T0m4 zB^UuQ)yy{XMX-?)v1#~zwxE=5*r_!}7efRW##w}i80*VIDH=K)S9DlHGyfcdX0}ST zr`2uf*|-oee=6Y6H#;`r!!CC25(;Ra34q&zkAaL0oq22zc4f_APezUnm*SSuGHu2w z5(Bx}>flS2Z+=2})wAdL5>>2;Hk(nI_a4hOg>yYZM! zUkbM2D1FJ=bToV|&w``w=n9^dwhXisVL4mVXz<1}0o=b0+<5|+cMuQ10^8UBUTnVL zKSO-MTYxuw8Rqp@BX7R|+LI&}t?_~%|Fc!!OI z#`6QI9hWf`SVbWBwliOG*prhA+JbsA276hiom)b~R!6!3>Ud~ajvP)5xV5QaKk4P# z=SahONN(a1Toq=O=Ds(ST__lXdUyc#@~j|<&;p6a9yrCl%YpymAAJOWntRF$6BcRi=%Z`&&xbZ>i#kblxUh>&p40ejA< za4(TRn>{D_x_pN0r!L!(kx?4Mc&XqDq67Zke0Qh80_yov732^;?rG%5#m7{hZ2WQ= z^}W?&Lv#H=K9S7kgX}9pe6(^L1Zgf`zNwQCA-;5esdvNvYkJhpl}on<87KCJ{N+$K~56%q0&nlne7R7Q$lsso9F<-Ytx z>8pI6(cxW_A&fKOXaa#9y(>$%L`0;Kfew_C?i0w{zk#^>EO7TJ#GQ{} z+=3NeN{njtR_`*Mq z@uvS2`1F4txbaEAeusJc3B=_sjKM&`b3r0C$vFaJY)b9DLoF+I1uY}i2A2vlh#r@n z)4>l8=KzS{JQVM6oH;phdT;|oPO#o{f0en%+_PIbgGU}b$J^h18-M68{S^MnU;cmN z?$7)!VD~(5MN8aEXFWHi4P*HmAbuA^Rit@lo0CmC*>oE7T_63<6_#zNCm^XhjmhUvdwuk zyihWwhYmWAjCdCyznwwA%`veF22Az;DQdp(Abno`CFsuERxrSF0+CD#=ex|L*o zI>0R?9G4xjV8a2{LiIoqQe{A`TYoRZmVnFn8r>;+76JOydE#H=;4&cPPp+W>KLj(qqv7>|7_ z@W>|v54=Wu;&38+>@GR?W^6gv2At45cRTiM1j8Tz3=-s!*AnlEvDvISKU?m#!c%J0 zUeORs1kd=IyWK&sF~FXPawgEZTw0X{_0({gyjF5SE3`IT@fAs366+q~)!zBRnw&o9=ZLxpm9=_p=UW32zHLu65JNJ2FJE#)@tezeuHtNwS zP+?y}TIo(bF?^ZUW+WcDdV+8KyT6KW{k{)lJbYfgP%KUS*IcaK3|zl=A8-4UpNTL1 z{Fmd|n-}FDtadg>gz%`Zbi|K6u*Gw?_xRgC_&EN%@BRTi`Lo{x-24dV{cX-@7Y?o? zw9iuuYyz?!@uPIujX#xF`t0(3H5eA6?G(;qYVC$ z*L=Tpvv6NZCRk3d{bBsgX^UpOnAU*gAUy3yQfaLi;d-k*cX;S{w)z2$S1|peIn_`z zpZpC?mPMo9nckG$LJemnsd_6~8Ado2+&TS_VkVjl1vAr#FJI|k(0b*%vGCFTG~QFA z6QbRCnP)l6M-=Ze*XlFzEui5kGo$mld`RP)X&S~;g;zfFRsmVWl8?7B(6GLDE!Pm3 zfQ2I|XHtQ+j8MoK=`dodXww2K%~^tne{^pFb_O7&zzzybgbheA4coAW%WB`-=XIGu zx{VfH1|(QLr+}YIBdX0v*hSJ=Dl(6Mx0VaNKR?vIFgy+`Mdd+ zowqL6W!o9`q1Pimx(w@|(}#5~4;^{vHw{iL5a&TFckY3U+w5W6-vzEe41CgOV|><^ zBfju07;pTez$gE1#PwGI7q>9)KF5vbE-zWM4AdusLqQNyr>pxNgeSPdB?0csvY%R= z0OWp;5nBzLvB$xcbWLIgY7WAP;Siws6=Q?kb8br_ctGP2zrf|{fx*ob1tUNQobaA3 z3b4keCN?`Tv8)rs4RdmnyCk187?`BzO3c+88#CAG*+2yniPdA1;O34D5T$MwV=9PM zK*-}2lDjv<>XLwlsWMqPar3|BW5)1du^zhHud|~@l)f@eZod1pdpn{tZ0&zx@xu?Z<)hM}W=wf)QF-<=!95EmUTcR{@6bg@@}Je-QGk4#?Hp5UnQ!s)Rf2`Y!t7s0SC# z=N4X~(dAC5lj}&d^!>7oW?!7q zz8Ri_0S604%yp6R>G->BI)X!40IKi(EM6&4sP{3XuZ=c{7inE^o?^Cs4U=%WUzl}5 zDFdvR_v$4=56UcG+FIRL#sa>0SChn3^#ljPxzE^yw_+49Aw(?Nv(n_Tz+9jd+z6(+ z1Vf0WD!Ud-Cng}w8!W1Jzf4~aNLc%OuT*+D(`g59)Vw5oTT!QiVsD<14;cG}> z!ljqrX$#}i;6pgWG&_wI-8?aIM~YN5D{aII$o$Re>e5I1Dl1#17q2oGUsGj9C`c3! z!$8yv1vrZ0ZMN0|j^t3h)q5LI527H&&ZGB+W7)!R6i`Z3OTU`@I*z43p$bR3uv0J3 zy%&J{FR)H}*(YIq`j=w!@BC4WFZ_Cp&-!xURi6!<-ay>D3EX)a^ZqSl?hu~iqQGPX zH`EKwsmVEMa9ahX-ib7LWWdxMmIwuW?ul^xC*F``Py99ddmUg(+TF8~B6lQtrz|Wx zEHkdM8bjxaC2EMM>~FHnnc}&fXlRl(Al&JwLb8g@M!^{Q?SRVPp)f50AUW5`M@|se z7I>(xr-)OBg%XXLFQjia?V(APTv4ZB(dO>p$Xf`chQ@>=fw96&tE4FrAFXZy?a#DN zY&U^NZ=B-!+k1TD-~Tmy`G56~@k4*_F9PrV7i=+Kc|wZ&orfyAy8&sx>Y31<+)gnzbS zGBR=n6dtXfq5tu7zW#+wzgAQ72@d<`)DnTDhjH9;`R|t$MVKR)3@?H|0=QgRvM7 z2`G%H9UUZ0l?x+ehPpr{J`j%o4tcSZ*9gg@g6Qa?%x+ZIhed z$6&>?-!a&^_cU<-7BD8_fkzR)`Avw={Ug8^d>!!l{|WG^Uxd8=DpsC%ZUXms4%a>s z6YOb0Y~<&(XODt~O!0qM?`T(H-M6vBb9y?@s=5Wnz|=e(vj|$v1*pkl z+6m4_;Gg{DbNGXQ{wMI(zxp@v^pAfVaQSiI{4uV~%qc%KoiaWXgTPk=9YEY9Oha2Q9N*&rn9~a ziB4+;1TB3bhUG_z{7P?qfblKm7u=VCQLh?bz4e2GBh%@0F3SzHY&ch159cZvNpBm# zZ&k4A2YS>%x~;p#k0$pjH&>7nL+K<3XG2IQg-2kev#vt(oibIg3U+8xcxJ6~K9Jpu z?gb0h$9@TRSY~=>d`uf4*;#(VrR3*d$0HzaVr6qZW~>C6jZtP^h@fJ!h%gf>7!Whk z6}^qih}z&A-0Bq&8ct_o!-V;}{#=o#y9y0gFx-QHCXBjw6lrc4zagh0?v!E`a>A#T z13Ro!^m3cS3w@%V%w*F5iYw{4hS^NlGr}g9F^rm*gsM$=yb4kir+@@5LS9_R~Co zb|m7FS7Che7a)H7AHe1d{y6YE{si(3{~_XKzZKY=VP4$Ey!{mN{$1emf(MO8=b_FV z((rJAoATx0_ffqr6ifgbhT`x7sdbByX`o>mw*FD8z$gn%unp#(ku)_H}fq$5QoUq5kRcoq<%#TXT=}`EGIUakUjSpLo3u$hff9r zHp>_}F>_)Eu0*@C4ZQ5ZQ@ra#_waT9GGDDbx9ZysIcURUY!lAGXa5E#PSwPJ?D!y}mF`?ip%+ zuF5bR{f20X{te5{rv3^i`6bh}Sv`a-zx6bm-T@`>W_W^KywQ()h|1?0XRp4@LmY90 zd--kqFxg|c=b`yL*DDF$S6wfkCY>wT=2KeU$``G!3;S#7YQW4Z-yA6(go6*sGn$Bo zC*gP4>g8p@ElyA#K8kLeFS*!H~U9>6nr&`-tV&J;yNlJz&^a(>3Y84gjqP3$2@c_c-mq3h}^e5Z4~%mI28CE%z6|{kt{qs@SR)N{oK+ zW1C2qpmV@##c@M6(!cia5lQxHm^iE(`+J&ddnV-I)gf1B76O zZxJC)%WAcfcGM7B_22|JN!kSf81RYT43?nD+#$T!rOaNe7=shP6`XO%PJ8GK1y^pp zZUgg)JNVi!{Y1R=YuE)Bf-!{LwLvDW4E1 zKOR%NfE#}*i)ant>>B4$9;`HL{D8_We`p@7Ca!uwd+H<pcQ2XVxn8h8wcK2WdDV3xT?gpi^{)A~(K(Q? zDA#cK@=Zs6-ttiT;+^3PALn5mwVet+d=4Fl2qUujUhxOH>?3siP7ses2S5;09OYKU z=~jS=az&&{$ygm%;^>UD&>PcXJo)*L^~qO!3DT?NDfsLbIQ{2D5$M^o5C-FD_`Frs8pZpQvgFl40 zcn*2`Aoa|0^#o_cYVd_x)+Pu8vAc(O22Y3Q_5}8+40-_%HA+uou;*`ptNsS} zcVh3|U?-`E69?@!u#wFrBDi9bjf|9W4~*DQXC+q#J+@6UFN3&-8WXYEA~13JD?fs~ zcXyq$b#OJMu=2WbP_`;x=E_**RwW&ttK`PCeWlX}W!L>`9BA?SN$4Lx=(q4_uwY{o zysE4HY(L!mveU$oU(MDtRrRHDX!TL)s&Q*PlK-IIiB9S1LQI$Q6c1b#HC~6)wIDMW zPuZwbdS;?ssaHD%l>Uw|!zfE%Gv&Jh?F5bTD7uV@Kw44Y$WIl5GnFu~mX$AbcvYOz z1b|MUot4V-dk1Ef#Y8veMiXGAahZ*&MR=|>F4N(&gM))g*>JnE0oY3rPFpl!8ACdc zB4?K@hLmcoyP^%YdG9$6#lFpD#9BjPnPP=MMqbUk2QGIpW64fs+S;^J~c9 zDd#aSk^B2%8*vF}oA(iP@ak#d(r6U_QZ1Qje1iMN@Loo$E0SkuaT0VOQZPmHRFDGo z&>%IJWV>bW#iV``2L(2P)$0THCUDxBl)!jsf-#5U0E}(z`x9YxO7$+KRzk=g_9V!| zcaalw0%J=%Oqm6I8aANHO8AWpCu7SwF_73Xycn%V0>mM-(cheV#L2+^={xv_FaAV) z^H+ZwZr#1aUYjiPBzgsA%FWZ*Q}&c~k~yk3%9S!|sXzalc;vFHuM|)f zccLZJbWF7Fov#}5(jQM!N#llvUrr6Z4-NtD zbzFuUJsn=*tujR>VVAb3-tY(U%V>t+1*FHWJC-l?ZuWeq-ur~$2*~uDMBBmy_9`b_ zSGM4;&Pbz9tX_Ae1>x|$aWvk7FB-x&p5_y2^kjrJ$;}Ki02pu+0$(z{Bjn7sxl;Qr zBQUS6aiAbmLJ7A@C6MX&t*o#o7H(-J6yuBsj>~M$CdHfp!9YI0Y!!0^p!1OktI@<8 z{VA{ME=AHm7K&?}!le=&fTAKxQNl1JH0WJ4uhwZap2cGcA5x%nk5rO2<1>VxcD=1u z#Y@rbvi;m9>H1Yob~OEAdFZ*K`X&qLor6KxX|i_)+EWLYcYw>Az{Lx|yvrjd9(@hs zH+??h)4vRx&-z1%&-qHkXMY9ox-UVz`g4IBuR?COnD=iZ?>&pW_X3BvbnsmSTb2=A z3f_m3kW)JW5XaP}SzZ|x$>1jjgAh!<;Lm;g`|yXp`TOv{eCJ=o?j7HO zc;Q39*`qviCZORh9|XEx=inLl7;BylTp0Nqm>AfRPVYhua5#6*BUA#3k(1_ggM~+$NO=VsZrVh!Cn83V5*L3w1T_RV$4MxdZbyk4@^KcO;u-Du;hdtXg2 zq<5=s)8|ABNL2O+D(!4NQdOTGmqmGt5sfzaX&T*1ixyK>=7 zJXS=rQGs5lOeimK6#S5G_P&dE5w!rxD_AWDq9T0YIfN|+aL*-xz{8(Qj@sFp(1d~_ z3CM+_RciIkLZ2(*3vbM%G+}{uX8a#rN|VZK0^}6QWGn_j$^n-lTz!d&bw8D^(_z>U zjva1bDTbNLzTK4`f>}aWe)A0$dc(`#oxkHy*Ac%`{}}iB>~h2(RaC`yCn*@hzu+0? zPQPF}ztbK9k^) zjm}0xCURa1=AJ9U-+dJajAS|kYsFr*@hX+<0YeH&XPt%9ekX#!gX6w<37{~$4CvV{!zVwsu zO<(;6+_`tD08PCB!i7G^Fj;9?Wo$lnY8EGZi`Y7ik$B|VDZc5u-h;RPi(kWd*;T5j zTIi91IWHA_0sH;L_5BY2;Lp4fpY@xr<8S}-kKk=T{sDaO7k>o!(EkSPZUHCPIMG@9 zRSl5vAImQr0OeK)Hksk_0`c&x5HI@_#Qu_#?iUBCAxUZYy$`PisJe7ZLqWjG$pDCZ zK^Y`XU{4-ks|v%FiTAByQIwzbbSfZns6V3SY31B&(!2uyKnt$c@ZZQ_U=u_1#@ywuMA7);v zJP0lt{`UX2fxUP?xF1^eHtluaaV>bVslq|!y%cYXC-fCjXDqgS&L9@?D4|C_*OAF0 zSWdvNxMaHvPJ}{{B;3ud3a~P#@_8Qvy_a#YE3E}IF1Lv4!js@MtWYqV7EOqdkSa2C z6xr}A<%4j}w0aysl#1px8FIQbir zGAQ&Nfj2RfVmZK4AlA#O{4xs5B%rj%v>N{w<(sbsTh7Xpl0!U-EjM^Pxq>)<5V-OX z^5h0^^&!Oh1Kch5#F;tZ&w2Lq77`2Y?U$O6tch{0Zf^is_YdxGfH z*Ki5zTGAHaN|Q{sgd(^RV1V;Q#%6Upr)(i*3l&^sR+vTZH91PJxY3}7w}x5Dmh6h< zInml&Ptb^wT+QSl1rGWgkVRm)w@H zuw)}wf&y_W`(DEXa}&sC@8Rp-{7LwhulQ8lxx1sEhIL%?faEX-prJ%|e`i9wL$l)K zMu_$)q23N4V&LH$r}*aYd^g_uFF%0s@YPizn9ss>jKF^G@jwLrz;AsNzxv^)@b+K$ zS>U7p8hHN0z~(_+=H!sxt&p@Ga0shxp?r~hW8F|3JV^KA7Vka$Ll!K)Igs$P z15%1zJ=vpaNb@(ISdIB&pX@RW7xD?|ilxstDTLOK?HUeFTDsB$;bUY&iayQ5T)wOF zx!hj1>?ce4+NF2rH@Jzcc~GC^mo}=1;RcbDH9sGoQ=|9c{1EPfW&R}OGo8Md-FR&H z1=H``yW@ZWl7oG#WD%{qbZ98wzS{UWZMJVAJf?88p5#u$LhW1cZShrdl;b79C0FUA znu$v<4Q8P7Fle3(QZ`;W=DKOg+zr74UO{n(WrVH|=K0Y(`I~@-`nAF}@W>n00Jaj? zddg`+N~O-LDGFSgzlJjtcfV;QedF8aFQdpbY~t(=XY zF0{+Z2352b19-U`6-mcC)oqzOIq@xGdx9Kih_ma6)2r;&Ie!FkdL4OoRXbvDkegEk zIO#Ely3==>+&oT%^W@}S%@s&1wR&~}8V@(mO*`zU)H2tYF+XqQvov%7sJBI}6}WO- zI#YQQ>dh#DDAnp4KDiN{I_@9G>3(%f^@Cpw4HP5V3zHV}Zi_&2IFCN$Kf;4c&y z?e+?2RMA8zuw9PHDuqy>VGXqGlcB}H;<4$C;G7u*`G5cqHyzef1w)oyCUMjrJ}KDq z*}M4KFZ*PC%U8S(ckb>O%vA3b^OqSlpBnDf^F&7lYvqHavN6b+hpwOEo8R^;c+u$(_(VP$!4R&D`|ij0~w>$g{sEw@RM@L80=k8#g{WNbY=|I zft76alGyMBCa`)OJTW+PVtB|PpdlEwj@<(Ts7Gc6#-%0`fL7+zdz&R_^iiv`+_lY$ z$}*nN#8#ksqEP3Mksb_i?;EgJOVnWUlw_@j^E@Z%)1cF%iPIS;G^y3YozX0}6-@?~@$tU7lzWNQgdH0esaBw3%ruu5m2&r0p2RNq-xbUZYz{H0IMs4G+Qls`jHZ$&Zgz84tjfOUNN5&1`dJH8J5jnWiMmFahq zXO(9>qWLsuZs@+KQe6O~!}@3%!n!T^4i-C*&~OyQBY!F$w&&10=~eXt356AeDNkSC z-C?6Qw8KWb_(H_Rf6KS~czy5m8NTy(p1XYW*jIwI4+Rc=B6PtqI<9-Ho6v{~8+vsK zwJsX!IToGF+;DPya8%Fud-t2YEEi&X@V9o0;hrhS6Df2IyOkL$fU3q?6a(~UTbVqG0u7wO+3M8}%D~^RFqFk|L>n5C@JcTxgW~>!TFcU=#y!V2H)QRnUtTNqg zDHzj%+?02gG9JsoN?J-|!Jy$Lydhp4J0s(5*u}T5^fn?T>ggporm4(Li9ozUhMFly ztFp}lCJ_F5A2N31<8t8cL>sC2K6FOW*dWFka&rQloMLRRAh%Z-@SI*jY_A|U=Ui062q_BB{U79Zq0d&AmgPjD3z+yGZP$iG2;*>H`QX>-f| zr7CcUp47ZPKTr3nEjF(JOE|br0(}r+%5PNwX8uUW?TaDY$2jaA!eU3!nEuE9SqTDd zI8omR2*}6y)NZb&o;|z!>J{&L((w?&p4z5 z^Om^tr|TZX2jg+9|DkWz8Cc(XnX(@!-(b4H!*5JJfFH|9U4V_x*mZ=ZAa-J{Fv-3gs1^0+CDZofU)1P0(PZXc#!`bo(W`VIc^Vj+~T*4XIlj|dXVP;%d!(| z#6Pl7GKR#RoNUWCbWGeQC$(#Xb}d#4fm{`dWn=k(^uWV!2XapR8E33Yy9FgtxOwuh z4hEIs=01TfVX!AhGIRiUU_*;{T-n4jyi6T@!`>8^m2w(EXG6cIiQGB0*9?(#Ps>n) zW`YwH(V!c+n3nMIxWNg|GkpzX^Z-D_)Pg7kkEQL4_XfeJfr{ zuL7JPJI0z5bRYxbkinpEGk`~LoZ*|k>sL4l`q4AQ9Ej6vi1Vu$w;soQ@4v?G{XdMn z^_(W$U$J75-xZ8Wug7Nj3)xqtMR(ec=WfTtfhuMZT=Av`BT$N>eH4lt{^-F0?!m3w7bw`((^T!%#@F%FODV;x{N4KV@ zu9gN^_$3sa2&Qbgo&n;b`C|ulh4JobLjguKe`Py$-B*>leh&hxrXK}I!By#y`KG)P z@-f}_>$?N916@Rme|3Wjm;x_C>Y}>3~NK=p2YadW!{%#m0P$ zZ?C779>VRo4wfIQtuT6?kd7Mn!h`<6K^7-Lcm7T+ z#Va&rmVh=_kk?-goLxig@2ltqpPhPAtU1+lLgP_C336z1Z;T2UVrY4;oO5opM-BoQ zCpFo1DJd(h9Gom@RzQ{P(u*~Bg_W@O((y)lf|Urwc8G2VNC09(%7c!>E4cujPA(-r z++#%WN_<{rmB`p=pAb79(i@mu-fcQ8chSIiZavE+giitojsrm>@`PKiI0N^!8I&by z4*(O98wOZjwqBEyrE7xApoFm5L&F}kF(+m+V2zl9?n$E}GdQ^~cM6|m3&5vXL+K*zs??*9jKMQQnxshQgm?=H6E$JCUKB1){6P3;WCPcdZ z!IA!zY|vyR{WbTx>}0=UO7lCq!WEdxI`E4}{;e+G3;%<1yD#kcnJ4;Yy6x9GT`sp0 z`PMYJcn1zWkM7G~8ie@4jMDej6Ux^uLo2%IsduV$J1zxN_b{%e>J5*?S3nq#K-g>%ONFTQ8NPP}-T;;Y}M{>HH$7=F7)h%To!Pns_FI=bMsGzv-s zP~-NfcjrLnmhlQniUEO!lb)*q+HJ{pYx#6NQhA!I8r)r8iR5T7TK7>A<-#Q(*OKO) z^ZMQtiKmAT=6tQ-!K zhIli3o|e?#A*CsL>^zhwRc@sTZ zIdXH3+@1rQ6ZW!5yfHSaNOs71$vrf7_kjHlxxYZpd%(QlDwN#?u)E}t(*6S2-34~{ zdDc{*t+1g?Bf#OUq2n5?%*iF-8D0_&9z9`hsRHF5INA`f<_1Y-yB&v3!1B~zz`#vs zUu6cStG`lL^=epN3SvgmA!R^tG}%_@rc{ExAD&Q6T)A%zjV=?2Ow43O&O!rmAGN$zLEiQ^1l zb9gho?pp_k_)>ct=?pLKxyD|=oRcTLEBGOM*=v*m4Vy}r&1aBb!kXWzH;8#sLz?^= zjLU2*TH4L?!zk+nw33Z{=f8Bu)CDcYMqoPz9((83;+7&f zqnT@Fn%D}0gy2gd+U$w{=tX$4vW3uzGJ~^4!D8wZ0}EG`V?i1h!-JwhE2V`~$t~cX z-Q|h4!sjS$(XDqdpY+1_&R<=kIKrp#4K2_9f<|`!2yo*y!1;r60L}SDP=He_qfA8b z8(Hh!Wa+%!UC7ETH7QuVF?-ITF%GdgM{XFH09qOi&0PU^U-j@?aefS?;nGINO0N9D zvsVJzxi#6FFcnyYdW^C~@vdP9yW%r6adwi)x!I_PW(Dm-4lp$-lA_R24s%ZxjRAP6 zxb~}|I;&e$UApeI(F5@a$cQw#cP7u$ignIccuyb&0-XQE-lB|A!#{wA?6f?eyrtX_ z%kgEDQsT#xDl$$ANhyrG^dpMCuS7^OFEDV~xT`EX@8h*26JVIQFe z0_5{6gK+G)BiEJyt}F-bf_xD!*6aPAQw6rCFFkZtGEp(%UIx=^eK9J!G5-oT!Jq*w z)Sbo(Zu<$*9`4C)Wf+;j3fQcp==$jl9YM=iFbz(<)a-2++#047UxTZ33%437Gv4y= zZZxX=0Jqp6zODn3P1}%66;K*<@y$FiEaMmo7!9}Uwd5Ok^mDW(Sjt#%8*@W*g91xI zQvrbUpet~L5sf+Zp%O^ZonH!Xf~|~Ur{J^}jN$9PE25d3s=x_k31(#!DAToG731p0 zdGu>iT>b%XI-R~+-juSSwQSPeiQxVIk~}!Mfw=xk;M!xzIOQ_)x#PJ^8wL)*Y8|h+ z3RHT&T}Bfd%>&Xr8}EaIlhbktu{~wkdri2FppvSBC(WdRw;VoV#pp^C3bJT0tT@48 zs_CH`R&rd?#bANrQH41)cO;;5eHxpG9nj=)0oAMF^e0I7;;3vSI1p1f(atV zA9cuIif;hWoR#}cA{5L{Jjg z{Mau)g@5#;AHom++`Do6!#@W+{R@b@H<6y>hOG#R6@U!sBCrCUpgd#@`sVjC1xy{m z!r&l6c9-m(B#YDkCzD7vmh7X|*y1|OVBf?(-p ztr!FXkA8OY6mLajYSkYGL@W9Ne7|t#ubf9T#Va8zodpwOU=eJ=NzldUmM_r8Uz@|V zvXqi3ic@U+S+yjwHNoKQew4x5+F~=bI(1Kol767yaKhqk9gn{5TE%6ICMOCz7=*m z-8WgGqXY|Hr>!k~s+SwhROGI8UdrMo& z;yM8eoLpXmWk!bTFynWClP}Rd8XZmt!937osha zc_0=J5NwwNG#naCGpsAqakOcgp>*lWPD#iB{Tu~35FTjwLLMa>UzuQ~H;rgzn@_P)TVibGvVD|)asT0f@Cupfk zH^1cO0}L2dDR0KW`RTxw(+&1>gLl5~IegDgK7oJnQy;+l-~02x<39)7{s3@sAK2b# zJ)CZw$x&NBW3(P0@u$)V88a-fhEW2*82D!byB*67`L&^dXL1Ey zia-Vd@*S3cY*cqL2tZ;jKmb_D%ePF+R6d#q?1J|oEit&du1RFYHLQY_8J+U1a_CHhe+CaWB z*jA7h)~N2c+0*2Je*_rVXlOf!7k90LfydY)1DKaP#P*ajsX2c;?o9vd@5JR#{eA8* zZH+Xc(Rw_r9HlRM1qTh1ud6fbT2I&E4b^w0Xh-#=8-@-%GRSu~_J@z55U#V;YqI}k za1IvSrK*6i@~kqKkPXXhSwUpcBbF>1TWl)&d)lJ019myW!B@xG$qHWMt;_0VAUp@i zFZ4srSDJ=ELQz<+(2DYwMu5Ts(f7{8j$B2^eqkUA0E|yB%e_H`kFzy~2T07!w#>bO zHOi1_1|o{A)p{T3_>$j_K;7z_nK* z&L2i@&*^^VB`ZqFj!r{Lso;f5Y7Y!;UZ>N>MPEXj`=xjl9J;7hr{qaeG?#|Z6o`1m z7|&Y5@LVG1V(*m5-3<0FR97uAaODlFOK7*~V4&t65LK;AxZMJ|uddUGHV!@PuoQHJ zXtQ`i6<$>+8kTb9&?HG(*~yO@?r^IL%TBD5Ze52fk*&%gPb1hOo@3Kgkq(gGJhzI@ zuI7JLizqA&78_(*_2T7RJ7%ZH=dEAjtt*S+UAY689I6Tju5vgGilm~Km)b8!b~(jM zaDp^Eqy+_*o-1@Ruz&gsTc!svPH~5*Z~vVM{1+_9kuF|I^tD)j;zzq?ud>=Lh{lb%6D^ z%Spj-C@67Sh!>$@t`ST3ENiGN%fvXl?m!D_s(~lHav6|AEqk@z*{{3qsfe+`Z#tK) zZn6wrgfFM_w}@3YVpX&C2lK@Br|A%k;SsA)ee66wW2_A&cDW>0XM*bnJn}gTNBd=r zoY`JZ$WIzK-$x4+#NcA~kpQ3yzmQwS6k;K#JRl)BVsuT}(uHvK5KzvAr}3$)F*6Js zO^F?_IKT1~ydwd^{?yDp+Vl!aml8-A|E4T3Um9OSl?R#DfZ6G)@(d|?-sk6&2M|{u z1+KpwIDd@29J@=N7(K{SlB-s}dP>-eOTaCk^strN?CJ$TGvv?^*hWs4Q3Pc&M%DKf zG$bpR2+aXuRlopl?g@K7W+#!dtI%*|X7z++s0RnGpowJ#u?n2h@1V+h ztGQ83OgyXCaf7+van%@+(}ZjWq&akA{L{Db^l`^qHUbtQdzZfpRKs*y3Lt1-F(vunzSdwoO-BgWDG*R;6v+1T&yjbY=TSQ4JOtZvU=1gdw~o zW7?Vhp~?}8brVoS$00M*xc3p7tCU7+fO={$Vuy0_nMz6gGF8dcN8u@yB~!AGd0eNF zN6CQcpjXlObpFV?1m7--ex?+^4gWLvG>8g)a*6`KY4t@;F^M=arBR2h^akxNG!Y~3Y=pEH|)6&kR!>e%o}1A zF`*ITbd3lL+Vqt`eBYR7CAL7#KsoZtYs8^6F2ux_BWsm#F=zne$N|i3y*$RDl?CG| z<{3ALRtwMfrnl2+7`|tQ^_%8_71Zx>$m@D9oKtE1+(<=g!nBq7{9)kwCm^oBibqn+ zJtB7iJPZ`v+%N_wOajQUtrb{x=2KW1ji-mdSaIr30SkGy91mNQ>}Hm34Y%01a*CvK ztUr^1Uj!@8(iuO4`PiEw{zp(w$9zx9!a-ZiJ-dlFn+jAH-dYOpN}V;e;!Vx-*=%ag zjB#c_;9%B2o|B<8fGQNN43qvOxa!9C8n!3%R{W*-y(bO}i3n}Vt6)PxUpT+Z3+amC z)Z|<0PKrjik~sX8<-7>R4vqYo(!B~$_Zk{Y_9mr*(Fh=eL0qkPi`9$J@t7FEvv=@y zU-n7(^Iyrc!01a!-^nI$embx{Il&Xp+{cf->p6V?&p&~;zwe)Vz|9n!CrarHu_hEvkR$1RXT%b!NX&-UButqE0V zBi4%FGHw-JK+M!`H^x(ZDc>#}2RLy&wV%u25jF)Y4Ab!ZEEpwgRfdw2kA7j&1}m)( z#3cqBN7d3R9vM#s`6)iz{~4bHadx>YaEKPbgo6X=U}ul{D&AwiTYBKMpv^LqUy3H< zG--=~VS1s5^SJTtMmh*%xLnO$?R-|Rv#Z&{)u%sH{n})Wc3VMHmxq9*aH>ue!IYW; z;11&n$zb_u%Bo}9PlFF4d*tpu1Bt;^Tp`0_Pk?$hMrd506&kb*J_iuv zL_HxvdWOzJnjCtn)f~*cmWo#|f+tXe!H1lA44*+oBcv>ZLxO=<89NwMiQklfj4!w( zHs|U&i^1W5nNV+%4A>RTZpXmJ!w12kw9uiXVI)#RhTg3@+?~&frcfKwLq!byH1SzF zz+pK$-+d;zBK>!(-#s$L3qTbT({gBoy;kI1YdPyZAuNYVxa1T;DlqapZNdn#J(GJa zaVSTA7gBA z{puEH+YMg01H9`4H}ONi_&C1r=RS;I{ndA4|FNG3o_jBF|F(89-)hpaovL&)Y(LFe zQ{mP&8v!7WP7N3R%cqnA$&sp@3Q#B;rqOLu?#s96JJHzAn_hHJ=Z-<`#LEx#% zSJSTYqw(5lg+6JuO!dwF&R!PflhVxLCgbMz#^Q&hNJ6%7gmUd6Eij#&G5{4h)!6L4Xy-!C>-Z)35yOi zB{iQKK2ss96|LSYV05oox?JJUCh{utAV_U|POl(iFog3*5I0^4Tz>`fkZEV8u|qD7CVJd;J8UUJ)&Q_O8+DzE2fIR(V%wjyuO> zi?n(kq?_FLh-F7WE4RFYgm94LQ*Lx_mz+n2=0xoG90nVM6CEP}1qcYqC|QQ*upng@ zUfSOsl9nKIVkgfkqii%`c<13Q&SBsX6p%iVvz(aAq+Ym(C7~5AqB-1R74Il|O?d3> z2A|E9a)hagt6L49O>S(+Av4jAAPc;2l6&AL1DE1O>p5aDNW8785zzb>2nWt<;6!#V zCW>uh|I}T4-Iskb{@XwH2INd!+y~zG>zDYEUwRh*`sY4`pLy4>;DrzUTj1vVfLo8V zxAW{800lkvRV=W2y#Ub+>SNhn@q(Jo!%c-FsL#bS&q1_ZP4}v$6r@#p*>q=`=kimt zm1zdSaK)p7X`Trs=|bUPpW5%Id~E5Ge0i@RO#p$sc*d(#&jJrYt`Lhe|{tr^8^|qcV6R()hMd8 zQ#R%R+(Y&iut>I5j^IXWDv0%11zC<}-NcfS;VLQXL-VH7Yu+?H^WJ0yRCXHXj~1qk zjRK%j?gqCMxhs?s1lr+v0vhh_6%x)65CeU+`)*YAt(6HIc>BhTjo~u(^m{uP-M2c5 zxP&~f6tw7q@bF6+S2QQ%_kreE1lVZ}!!(;eRZbo%x${FXQ(ec!Gtrj1?|eAs>oGry z-sJp*-38xmuOO~Gin#ttqZz(;Hl^Aa;Jfm$6#gY!HTK*lNq&rn4(I9VEi_|IUe zHul?|s%Ie?bbxqrK1>w<5o$`kNSlwJ>W2Jh{j%lxDsLl3#iFY?<OXx6ey?{b_6eC|Q4(;bxK zI_+4Ntv+$S6uq7Q=<;&#tzh9mm$1@??jd+7|98M|XJLbnW$LeFp??Y=G1!G!qtV9jD!biWo*GQEyuLCZ&@|DJcPRIZF zilZpF0+}P_HjWNHtZZg{;bH~WyIhrIMd3YKHvQ7Fj zFFRBGIc&Sl$GSd{Jykg(t@0KM3W}^hDxzpY)BWxzpuAOvt|=WzSMv2i>HJQ(!aUPE z!|Jph@T<}4fTI`Bn!)u;Oeo_}1~ah> z&jw+pRs?B-YwwJsBRzCj2b^8E1>b_SQNUPZQc~28-F8pIb)CSITQAuOQTX3DabFt;__|@9)wmHfO-u!x-0J2|Vx`1v4dycO~=hIUTg@aPeErIVJcL)wZO z%2N-ToHIeXLZ&=8|BCaM#^CPGIoR7a_dd~mtyZu@4effuiQOSta5rI2TqF@z?*PlG z4IVu#3Bq(w3^#F<&cG8`p}>mgtx@+#Fy|Q2vBhA(kv_}Kje{|`lXz;rlJbu270k0M z*kF&i`ElfP@5k;#?*N|sHQ@f!3>vmqIIqVj8Ee~Q+PT}WNdDHBkne$m9^I$>QnbcQ z2qvUU{iq(7Z#@G_kC&qz%U=}?J(tgeY~OY&zhii&je=p`?oYD$i-gLOOkf_^Z#2K= zvIq2!$})^0+*64b*9{z55h@QR*cvud~TY;tWm<9;$Xu+Z9RaWCf`<)rC z*;DyVW7A2&sWPWz(P(uM*$6(+TT@L5kh-rU9n+xlu4t^K248Z8#_#>@0Ll2hf~c>iwLeStM-SBjAdt z5u7%7Z_w9*t?C)_L}(~4`A|WIov4?u)l@d0n}WFdzR#<3Aa!_r>kJfcp4{H zvK>b!^}XwiT=hag{AvNX^}{r#%JLpO$2=_FH8~Z-ls<$Pl&AE>G)T94`Id|GHM9#Z zE3~Hff@wM{5OLZ1$N0l#=>DZH_vpj>$sE;iWy+dG&By^t<206Gw!7~ToC zlDJh9I1FkU+)_vv7K$PvqMI(2k-`S=4~;=x=w>MV-Z%@^LP9VhMzlN!LDE>lbfVBd zU3jhyh)Bc3%rqN9{HqrdP;2cJe5lpXaP9_Y7~O!1r_q$qbXmbnyKr_MC|z_|dbb`H zALdT`noRy}PJr`=5Z7J?+;}zO+9x1Ru48V`*O1QsKJ$RXFs!H@6o9=A9-guBjv>}^ zrC6~x*lXgRhS*c_6Kv6QPaYq)V4Y*{MxR8yw%0fPTxAw$``b7mLb6g1Xy{43CN=4m z_-1G#ajsTM0Gyy~W3f(_~b#eQgiL%b0&D{z&Lq-6zYW5g9ajs#|2A`#e(6XfO$u{k0Cc6Wg1 zKZbnzSCNmu3-j5JAn(3F=Q~dL=U_HXiJg?}!p=5AbGwvgqp7xdCYWgs)-x(dCycc}FI{tcBb;`2cDyw`$OOFuD<5fkfJ34Qn_keI~ z^-t$1z-Rfd<$v9XcOB7_+lTrRk1Ia}v(bA@hq4i8sBSUs4fpad#>0r4-Ui3@MAf&J zYc_mBy)9i2LOjY=*L40FFZ)x$%ogaN)%huY_8zgK)xmy~Lz8>?ZKxsF_B>lKrs!$1 zvOXCWY{%wPqsutUo^=?i5UEI7a10Cr*5DtW=-!0e6~uEv`vB0Cd66LHjXitac5(q@o_DMru=~Tsq&{3??4IVcv9)m zmDchwGo*MmmqELQng`hxq?JEfK&9l&Xqbl4c$LkuKsfAo>>)yMBK7%$+<5W&D-l;- z2An;Jd3uHP@AruPeU(F+(lihAlqx3ouwp?@^@wBktzBj+7YI zv%OZn4GAc<+iYl<%sdbEF2Saw6MtCn0IS$BagaRw+RE)%4x*39Lk&-T-wI-E` z!JU3FFl7VjiRIu#cCwU1pi?}L?HO=(1&9;G{kzD!PXf<=82Q96BcJ&o@`aCc+4|UO zlS0qEa^*?5rk#qRUxaMhj!pNeN^(m6_F<$%aNPj1jp5aHqX>M@zZ$-c*a2UvK7D;}?MGtcA?CfGv^(QR7}H9S)lkZE`C zg@e10Un{a&r5nL}=`(RR?36zeuMa969TM^qY6OLv;MpCa2mDk2`R3?-U z-FcWPogpNU<@w$U)o|`t!Lm}vS}Q!1z{UnNSbCSjEu`@RQ|XOI72A}2PQ4dQlWc?X z3mbO9YH~Pml8t5?q`~`rSH|LJtX`)y5)JQ4+n)VvdHC92a)~{3diVB>dk$UUZq#}G z6&Pm^Avfp9af*n6$orhcJGQ`1%k#%Nc^%NiYOhKPpI@ef5ly%8(j;sju>ibbjAP}u{hLO?$!5a^SNDcrJn00rUKNNIS8n%zoAQwz>mYfyp$UE>F*4n?5ejY0b;d2M2C~WjGE54J(i6ud@8UrSr{k zaKXeXyXQILR|OSH*X3XQ&;;i4-_abC9;3rHJn^p{8r^rd;4m5b?L)e=* zfznqQN|(~l(tWJ*tp^bb=J^~z^$t-6#cjo3tIyx@1-{m$70qr>h2TF=-Y z=U%;9a~%h;IYFFW1Fk%Zyzy$pjaMPAJPe#(=frAkfc>S0Sa!($PAj02y)9!?b70JS z_H2MbK`g^#FOZjRt2abvSs_z_gn}PX-lZBEMuXX_)&t=%=wRTm7d((~9fFDkrwGSD zV#6JmQ{{SzINIitLHvo6da|_oYwq_vJ4roL&@dVR4e4pfZ|YmJawxpSCk_h&;2GCT zzp*+mVgy1vIdiU#f;reeb=*g6kte4-FcMm2mjGKpq`y0iJI`SM+(&_D-;a3u1IU|? zW8QgI^FX%z+h};}pn|mGbO$|_GF3$wn)}l9EadoIAwv1eXEYm&Xf~y^U5#x|ZjJYX z4($C%^&vbYJ3gEDqN`^r+?%foXHvQly&1B5RSuB~@R}31{Tg2V3LL}>!|s;@fc|V4qS4xE%wCVFOy^JIZhbB1 zx8Rv}SoUU|b*2X^?KYj)G`Vc^VS#0@n`!Vn*^>ECaGg&t3deQTqK|;+GoQPz^s_>&?-XRN02!cF&nUn7G`F;6+FZkGup~B<*18r<6?LgE|xMIw@?>v zbmiy_RXH5H;OCLe=)|b5#HQ88Spi0;O-W62rL&VbI?xUtlG9`8dqbJ<{b12FULCwQ zF0Qz{ksGio-Gp#cP!`&j95RODDb!1(E5(D9EV{Gnu)7jNX>-pWfZVYn-ChB%JOrFS zgmLYaNS|hZc7sD|vE>|;{e9%_qE2~EG-Gw87J)Ign32Fvy-EskFnBH)z;n&2Cq+YB zK0p;?!->b5-!**RR(PKvtN=pvXDHwjom^REEQkCZcR}V3#i5}pb_0`#n%6WGSVeHd z$2obr_gE{ODiD&huenp=Ng%nYBfK%3c&|A?3@Ft@6ZqG== z{sM9DCUEx|#_$JwsaI@1q_B=6?QDgFa23a`m(chPl3{xA8{Jtp?PT(rggtLbYPVcC|_BV zJK^s720!eJn%~Ig*AmUnZ42gOFH=3-=B52#IK5z+k2BXdxru_4l8wm7M-? z0TQRteY?s`WhxnZm_|b;?&+~FDc&5{0p_*&A-XDnu|EcZ3=vR`9P!(PrEr=MFOPYo ze=Lh|8S1?a>5b(<2eNqR?`C4h&A6yopv%Z<**N6;62waH{N{K6*kvdB+4yOA^g5=> zbump3l)etoc74%h>$-M`X7dOBE`BsJif`6q!>}HB6dCZ|Qjd@L&mE8Cm zh+q`1hUrT0R?X3s;w~`~g)ud(9#8ydVJMghMu0ZUE;GBhDTHZoCq>_A=n?I%0E< z+?*cpZk=luf*p*8?QG3lw);IO8}Uj2rZ-oG;G$F>S5A+9{3zEFSTzccPGGI zpWPEPqEe zb1KIa40J-hT)Vr7`*(mlPhj4B0`dH>W4`cF;DyJ5i(AOu1uNCTIbay4Z5eB<%Awl@ z{A}B@E$UZ%uC##0>`j&5ceu`H-LgI#wrTGUy*b-xeytd%s{(v8O9`^&3)7->W^Nt_ zp%#wu(y-4)K2kbz(350Z3FHu0!;%YPI?KAjEMUUTFin#QE*>_2;L9{s`O*A<`P6B& zj3Jr07^NA~%la-@)wt+&Ma!p&{G_8_jSt7T4ha4cea3eP*F*y#{#E7M;VQk$ol|8r z{VD{Tu3`12B93~oAX+Q%bp8g@V6B6phQ9A1zM<)ThaKjD$~~x`I!Q{?NaT0Ht7nxl zI_zkRZ3I8CfV<2pqw%Nfkjtw;8HAlUsQ)5dtkOByGt4wU4aZYQ6#Q3lOcQwcbNI>y z`(qV;gjf-yD-M)Jcs%0hmg0PK|KHK$UDyEuGuu-AEd}T9n*W2Htl%D`(^ZvV?+w6$bHJzm9WU)O;i5!j*}KX;=rL5{ls`WRyc+E#TiIjD zT;-X(7ThCRECE-Je(rvx(>B)x)j8#3%&*25Ky(|X=z-{~N>i{yW!3yJ{gqtIYr)D^ zj>|Q@ST8OY33k zeer0KLmXcs_zU;!S(lrg^=Io>=SjqZ>9UP)U7nYDWNQu<>z(=1cxpndOQwT}HJJ2C z+zA@0NM<)+ERL8#vjswgw$cTp^eUj7nhns(qdXObJCD+Y9h1IWNy@l%WvqQ4V1>3( zn@Qbp8}lp|RZ4t68_rVNN<5ZATVTWQdWB$^rdgNENDEFdydrM6`|ijA9>6iLb!!$C zty0b|Y;_!8Jn3obl2AIHb}We|qc%k8^o5ULcKPPi@Y!w!M`Hlk z0;g9o&L64jv?}J z>GaTU)ajF=0U$7P&y4}4n;{;pV?Nxoq!nJuhoG$4V44TLOdJB!d?guw!U2#$I6btY zVuLt2=kI1Ky_pRZSZ^f^j2m= z^8haNJB^cm6DxQ?EI(+#4nj7ql6INS1K~T(T&3BlM=NdTJ)i9g%l;r-(l|7pLHVpR zaK3UFt8D9+^=|5ZHv6f%pzBDVnj$%M{dOAkJ&W4vxC-2qrvgF|-gV6ly{cPZf)6mM z{@&h&{R#xzHry(gSY^j%s~(_YrV6UWjiCB=biGJ{Ex@kK|2vn9h2_+{z{K2g79u24 zdv{FXbR2L*Q-)mos|ftTuk*MIuine)mv9^G;>jU1i{AbYO;OVUn(_|4D}0Z5ZeF7E zSiuDvZ(Uv^yM0)H1(n)50|UB2Hpn>r}#rJSgB%?{xI z;7a4x)7#dKgNOPW`IWEht`ZcR8o#pLm#r(kE3at1Guqzau$7A=-n5?Mu%9@lIaZ~y zkkqG6jGn9F>gZcOyaGS$-DN~0 zSuijX2xKhWZ6pQ^nE3}V;QujT*kX(rF@%``2@e=pw#5YbqupIy^*$#ygIL#&mHC`X z>6|+=BVzBh*Zzpe%=;ty3@=tRO?~sGA)hVc@)2{EQ=h)LIPWc-c#z9=hD6zS8PBa( z&7Oaj4_6fe9dE*4!Od(hu9f95L2?FK)odKF4G0Ij$|g2WWu5 z9Q$77=Qc*Rlfdk56IeE4R_*~9Aae`#fhJ;_6yberoFytefz^>{>O(}zdToRA0Jw^)OFr;U0SDo zIqsKE`)=)3sy=s*j*oQS=*^q-e*TSC|4#e!yY~LBwLhirzfu3|f3E)duO+qC&%cv? z{!8uO{44cu|5{6*+CTqR`rTh2`*AxL4E62UT_65Vj`AX{F2@ylK0YyR<@g%DUpc^e z`jvCm_T6@4nD}uqnu6T7n36+s{U8_ceb?!`?C+T@EUE(Qb}ZDoxlc?`VCj#HR!jo4 zMO{?n0kQj){uI%09PQXizxEGwerAl@q4b4|vI6*K{NRY1P_q5OD>k+tWzaTqUYxd- zf}gR&B{nBd;L`c`;j8^=51nHpbu9E5^3m%Py&cEkwY=%ERUFBft@nZYu)hN z=2mG7^Sc*#+w;OZPm`*0yll6Hc@I*{dM1Xhtnty9{f@o9IJWn{eRI4;8~9>zdcFuz zaVx6J4jv0!JNkZ#ARSP#+MESOIICG@*1gkGigPwZ`#j=M`%CfMKK=JC;@jV4Gq>|X zP8&Fm1Y1s~<$y#rxR=MbWw&wVLare_7T z(R6HxL~8mQ&-OQ5i!Zg?wjJL1Ne&2fVXO~-wEGvQeSOpV_%^>AcBnqd)%s8^e{8=G zk3+3=-lw!b&(Cq}t@{2q+TVX`%=>(iWVf2THmXxFYxxnCb7dLlaOfgSd`%o1N8WXk z`!kjzfiLGH*tTC0|I<#9<-XKUvP|U49No0x{rM&&3BZYe%P=0BH&oW z%C;XNmt%0#K4ymwn*ha7fMLYdf5-xqPqh3I^BfD8 zbxAD;Y`J4QQ1!ZL(kIEcQ3OCFPa zF+L{A#EB2UHxp&r0`XuQx%4|R!rBvJf4A96puL0f%nM)nP(JY?fkvc-`5(m1rm-QDh%!Nc=;JbgB0~yEoFmOKj`~nBt ziVK#BgIB#CKN#l@9F=-9rqLI6&c#E>n=$CKj?_K6a<>Oa!*~ao}xZoS4Y&V54vlcjdT^D-QayaG&wUIsDny z^p67jG=y!rmH$mW4UFpN6>SmkDHgd=bjAn%qd4AYkOaUADi_%ik7!h^PUJ(= z0*JhDUu>%Ne1Fmvc*i&UKFwHJu83#&OBj$?s9 zzrqKKyMVHtxll+Ryp{i9^IRa%J#eRtm)X-cDIUHRJ`4Tmow$0QP^_+vH(-~cW`(Cm5Vy`0c1GSt;yspUAgcp-8dQ_G2V4@{6~A-HLJS3p$A#W zR{6b`Q9EeA3a_4$zxh5EdglLp3T#=xW1*n14t}E8Qp^F1VkVz__dAX(KQ4Q$gh_~S zGK-hlF5qhv4l$r{W`!Nr`58EJ!m7NwgG2($W1308=UCMbH55(oz{e&3_IKL^82xF} zmB%ydd1GKqu;>^$=4XnB6Ji-ZK|94$e$1G`L*g)*hh6!eBALJK#AzM*J8WsVcf1fZ z;KzSr0b5Q^+sb4_44ikX-Q#wQ)fgEZ$Z0{AukM1VT=Y|aVlT&=WUOTYU@vo*@dOt0 z+i?}I%v*&$wr$2R{$+R3myLeW7fken!xdN2!hgZ_^1mH1o4VTVg8`dD#@GnA9-lTh z$1K`Cj$EsC^W+Y=GLT0;jj7S6{lS#`)=#k@sAjnF=ET9)ax&!Cg=Y}F6C<2GxFU!Mzzr6%SQpS+o^p}In`#3q z{RQ6`PFwh>WO;t2Pve`k5#7Pz6=Jz5PZ1aHM?B=jAZ7J>VxFQP7umo=2Xq}GZ^AvC zNBpr!^SSQ$rE&`z+0)SlMg|mpr%#M|>w+6De7`O>LSh(lfq;UkS*l60~aErrmkP7!LPCVp!5g|{n#kmXx$^z6N11L{?G9< z2AeEvx`e!v;|M;8fgF$6;5|7j*$&4yP{(HL#^%oa3fYP{K~Tq?jj2Dn6ACfFdF-1v zCdV6)2T!&K_hT~pvB!Be+sl6G$6ARz@Qn>|5nHx9e_VTXMXiv0S1saOmW^$LSyp73 zb0^cj9?m`H&G%!2U(W?qPhG=*#8#uv;}e!pLEgP|!)f-BEGKnmKTZV>x$i8pI2V{% zA3S_E!os$|IQU-rXMFU-$0Ni4;E9FP$WZmYnM*WwA0E}%z+`P16^luM$2KJY=tWK?x5!Z0JB=+eafL7Qw^8bi6v}P8VaJyV9ErA8<}#J8}vh&=mseiz`^UKZ+l> z^t})fczxVue`P+tipKlSKoL`Ee*hVt1M}ov6i4Dm#_;N?tFMWeb6UtO8daqmxJNiiwj<*s6{}`__JQN ztO?kWcLg4D2cT`GzGNR?2(OK<*^hYCN51D> za@i+b;8dM>;U}_k95X3&;v`ka` zo7Cs-o!@jXn>RdLXxomlHO{rX0BV4S@onIx2ucf|B7;$9=m;-JcVIPNjAVxmcL8jO zNMdOB*z&;Aoz#TUmPvnfFQ1$V-hCdo%Dll_;VAuBq_*y4OTV!d$9f-7Z*GNr-Y4P0 zHe<}kG8Z$JeF}uRei%W!{1~mw6?V8kt8@aHBnKb-9YO8`&l$872ioCk$hT~nH``hJ z$r+#gbADXe??h$ayyM5kCvkig;%|qZ?J?2B-LsjfGA6)=O%_z#6?zD^NRLq_cRao% z{#XM9l(PUQSCCnkx7PU>aeFX*9*Y`aE&qMq<2IgC-EJPe?O4IVLRMfxXSdr7ZsIay z%=_t2a4^YCBY7BkSM*1wbL4=zLZ{eqg=ziEx4S3yZqb_O?NEUYvrZonNc`W8~$>NbXmb z+14v+h}(~_D}$O|#1h}nV;qAWoS{SU)fQ7jh$}Eh%ww-1;F^g;&W$1X#=5&B|2&2_ zp)+pyQ`CnXqZ=1x`CKF~_n#Xldg4f1kXQ8gzTld?LIn7I4$h}TJ2w1NKDO_E3XGtU zuCfk64Ja2$f)Q4y(1hVbxDAIG^-xuz770n* zvrJ?wc;pl^%j4LeWCL>~0}F}tNAd@boY*?C*bfwJQCJwq7(MU!;OhzuqwBpevw*Rc zF|rIW5fdKRp^ryH$<<)-Arm&Z=saWkPEc?!C-+h4{$9AuMS$aD^io{VZ$3u9k; z0OGgNZJnif(=;@Oq3;+0k1FEUjgJ@yL-0miE%}6x75T?iu$#{qigv_D`FQ(vCgA+U z8n5i9j~H*+Q_$Vc7_bmBoI3{I*kR10zUiKC?p|YKc1ixMtQ-qMe$@G?9oVDmlM4Mz z#E-8dV7Pg$=vOj-aLL4Por>IA_$71_TW!Cszz%Q3;rP(-F+E?KMviR9BAVg-8um%$S@9^dW5*2o_BK)!@(qY5CJj$x@%M~;#$E&1nejQ zqs|X-Lhupz#R5dq$1iS|NpRaRleD)cI7vMGKu{21UTNp7JXmQb(Xl77VxRdM4kBMAX%yWWQx)lz^)bezo!D6BqVmUZjR`x)Zb{m&U%<|Sk8JNxzK_uy3fXI&;njc@xsdBi9a&`*CTt)K3(%;#Y70z?rL6KC}GxN;l)v022m zeYf1F@kekr7?{*EX3a^VY?OwK@a6P1Ms$i8O`pX$)_$A>j#qIk3`^B8sIt#H%=dr=20wKBb9r-~nL@ICN2W}E;2yw8Lj1k-f=QHrjU;83|f!;xO z#`Jd3r=v@!08TLpe6`L`FG&7EzQal9V2+r?rZ5|8JNV#Abqif?jlJj&MQ}3D&E<=#{OIc)nku@F&#ENV zhr8W4I~1+?(#Q6iKcpGw%HO?&0wCx${D)>)<@w>7~{gv*g;+ z=jUJc@t6F=zN&hZ+S1{xO8&%5oj6*h-mUJ|T1&mZpPz6szFHsrV%<4Ec$e1tQ2&4b zRQiB#kmp5>%6erHEBfcBjU8^Y(+sfxXloXMKG)XE-uUL$&w$ z9YxP^&yT?aK8Yx|b(;)`1c=G&x*q%Ty%Nax?NHH<@wN)%*zZ^&rlFZQjbqZ0kj0|T zf|EeKl3_4%WOUk~rk@0abi zbGp^vzMbNRZngAre!4-QTl)6xOalAoyI^a7Q!qA`$Q{{6lHY}bJflr@{gN>aKfn98(%<=qs=xCOrJw)m_;@W< zdt$2d^BpWem;_IeKR;D*tf0NlB<01(o?oWdQEbwAb9z7VKoeI8$SK-}P}XsI*n} z%?seq6EoXUunyM#{PYj*9>4cztMw^;ocbg=EZ4E`_}}rn@BCdq{gL+n{y%E}zyG)N z%Rjnte3TuGd2vd7pBeDx$ZX_v(ru-qmy3ye(!2P_<5s+fuaAG!x(h5t z4VevG=$_yUIbXETIdD5B9v_BqTLotHZ%4MPO9!AVeABuciQ!>X)|X~RMzpp zW*<%sv!IGLy=)#%(sXL1Ul;cJTvHn@pMk7Z9P7&0`ph^?hL{REQ-8~$OUc0 zrMnPHqW}gFz~?rG+9`uceiK^XTiGMeZ)j5au8)h#0d%*v48{*n+xA%z__4J;;Vmz& zc1hoVqxxI_p7dY*_v-JTs+q(bMBjc=@1M^V+xkiR$A6*zm;Y4y<*!cr-bcoN`j4bP z{d>}H|Ls{s*qOb2Wx4xIDjBp@XK^K8HS9hM5&sl}`cw7si?hGKo5zn+C_g@q%RYbh z0;na5X|*)Ad{g)LyV&{s`QXvHQauxDOZ(GTec@VPMRt9v{3hi2iHP3Pw_ltq-v9G2 zq~H7-KOQv4#Kg+082n6v+j&jQacTm^e`Ka#>5rZpSRRiqCln`%2SpO&>q#)MIF4qx zv45!#917X_v2*u5#JMj8Cb`g)m*4)C^dJ4#(tr40Nk9MQ_(`W|+(k*N>YJoHsj9cH z)X&FmkI5&O&SdL;;m>n7#)}?I@ZFVioN~AFEP_wGokg!7)qVTrv2A}pvh{K99kp-y zpZiB=VN=@^{XUDLD(!V@)xmc7saoeQO1I-Va$bkOR-NC0bK!64*tx$Ste(VK5S}sI zWqSF}li;}zJ1CRT}#W8N)y8$XTf@)wd$Kc<+6Qu?Bm;9aHu{` zKCh2+QB+cWe0cG-=Ax)RzS(|B`c&)OtSbCXx=A}9n;Er zgmX-YvTu!HoP0#7c(0B7jlUs@9CzOtX#FhO6mk~%dArVd&iB1jDi3#HJQpU8UwxSC z*0s6&*0trD(7~;z3%j+4A(Q7&9Q(#&q)dM$!37jCmybxFz8-<$1QUNa7+JUna zlS&xCxg3K-_!2r4P3V6lmmeveiQZ}C+$hNtsUMl>^DM}GXQE18@Yt2D6Emh# zzLRtArr`TNcRIeEg?;aH*Z15#Y4yia>lEt)(V+Zj<}9GRc=6YLteHIbxzjoLO6sN7 zc@!m;%c1kiz+2A2-sf(L@04`)!KAa$JlB-Iz>^;<)`vDXzO}tzkrxpaIlNBzcyXaR znrrWKk@NZKJ5cA5)VVL_1*+rnsISAz{;s|bQ`cEsmVJHfI~Rl1Tibp=y4~J=ZYox5 z`B7N!&$AHvSkh0w(*7s^tNLI43+Wes;2Is18+CriL^l(jYoi?ZCs}MnJ76-;z{}V= zafJQnAZmi;(YK6e!*$;}^3G-U$wwAO+!aIz^>D^`9P-N;Wz40hDcBv@w?BSg#@~M8 zAs@RI9~sGuv3%}WR0cO4`YPUf(0<+fEcC?!!}9SP9JFgVwKU9|12EBNCIZI#&M>ub zhNu1%jxR#T#EWrx&Ut+bj9@AkW(R?+yxngC)%}ElI0mC4I0t|WemXM8B66^#9NjUk z=hXn`XR{y|w}U+rD7&?HSUioR9SG%#M?P1j`h!36-5A}%FBb~_uTuT?Z|*Jr)A>AN z`u0odr$4arBRdx-#|0EiueAL!&8l;2`>F59C-$XN$SUwjeS&F%$o`!Kivq%a%M+d- zF%S>th1>J*?Xr;W^Ls3Q`y-H6eg;#7@oDbM`y`x;L?+D?l8yxq6Q*DH_2ucG zdMtlV+3tyfdSMFrGN!RDZHf0rp&Q#hA&*RAaIn~x(QUpu`j-6o((k!a`1J_A+_o1R z#&tAAztQLMZ61`^y#CNjaDVo?V zKO*A$%G&3Y`N<;3TgqIz`;4Cwbn3`i=g~ak%}Vx-5UJ0D{fIgdGk1@= zoo}yP)``z5f6RRSByp$Od=A;;(;+|dhjWU!@B%}QqjU1d92gxI!0{pTDPOudPusR! zoKfVQxtnt@Iis68#CgVF)u+CM9ge$^G1%m}Amg9c^T>M63BOw(maiLtNye((ePkjeTX>#i)zGG?yR%hm(n>SB=$*V+Gp(YTmD%ewYmgLnaCK@$vh z7b@1BMd}#&TFI6X47V>}6tfC2koKdsXDg4xsF9t-aSq}wBUhZ{V<98-jZDARA?6$h zA8keDKy7~tEa6MW5Ub*kpU!EpqHurr>Yb$2wTpn2?T}tcrZnnuh?udt{5=lHj4QP< z+IZk$^y^I6qc;j$<<*M&K5R%*Q4#UQv-7H3XyjYgU>QIjI~a+#SlHwuN1?iG3*S#O zkX{Lr@%#8W4*G+YyCx)`Wle6h3sXXB12JzC`*r@XsVr-r^`m$G88fnM!-I?RCw9OT zljs8@F%;)Zw@~B;t{-wWc3bx&vTeIEKFcwYv0I8fw83!xgZejE(&7xSL8$3QY9N6!3w;^nKp8au!k3j$=pWh*AVXm2-`4h9z9 z6RRGg;6{o&4w2(vD%Zoo4lmw{TI-md#SM0^(=XKB6Vya2BX7n&z3lcYUro^5d7-}0 z-@aHrncweo1O@3~FPJlS9&r?LJ~E=V(H~`V2Sx|)qVDv4#EM+T{E$aGa>sp*ow&*+Dff@Do(Qf;SICuXY zTnzTKfi3dlu{kCO6L-HF-uE;Yb_c9jO z|FjK06giQ`o_O8ojn!u}xW*Q6#bUi9e#ZatI(>|Pv!L?bKh^cwS2CwI z+qS%z1J;s%&$5qCW>Lue_*y7h?bKrCmRtZOxAVy|WWH);%Gy4jcnJ(`4%a$9*Z{GO z6?Z&FHk>@&G&slK=aZ7B=6k+T+%YP@CzT6Y=2{jaibqzZo5R>6FklZ5`#E3pD%V== zXB!IIyl3rP#6rxerCB?ae*I_ndw^zQMe=Bl*C15}&z1&Ek$+h5T=X1-Pc;e|{USe^bN6$BSYJG5 zmu+770YLs0h6zP~e7(rg;EsjD!Ulc*Zy8gIw4r zkISD9z41isVMi{o?gbnlJm~hq(6;)WkvInM7#{|=K?;y0zt0s{Ux3eI=GRFK_Zb-; zM?eorHmq#O(sO|UQAeOj2%N~t$#?oe62l{i>4sAohXb3d{FLDd^K`hA!c5S}(c$2& zANfRT%M&2B5M;^OD=@)#PsE>JiU}~Vi7|PO;%O|5ProKFvi?m%TUP~~Ibh#ogq_x9 z^U z?dD>6a%}*Ap_|EH_H~gL6t;Gu^H>U>$bajkoyB7Xzr^aCM-FifuE1Z$!p3gdm;4>$ z;!4!VxgY^w_8+{~HTB3mjvifXMa&`i{R&R};=YRs86L96P_V;B5o>WWb+^Y&e`;TF z0)E8;WcbeuG`EdxB}7& zg^xVHjL(gCXUv3u$~cwv0G!!>2!HOkC*RzLPmYnpU)sO`-<4u9Fr4bCpW}qop3K#^ z#+4mk9t0LyhZJ+5Ie>4lPZKrC`ip+}!;7~Le`Fq|axiDE$=vU_Gevv*MuS6qY|I=3 zSEHBry!!a;xWDTcI#jL~=luDQkhjLSOXmw-kR=?2=Iu5IA*b0XQEktilN}^d_!}~E zgE(Zq3M;Ei`tVBPa<2IE&IE@G0>oxObR;N!kx`yp*v1*QUv|tm#eGY+_+&e`S&`Kg zDqU{C$REdW&<>1AMvtce&eftZP%uj#?_p^_xZrI&P~ZkWux0k6KmkYGYPJ2#tMkER zP6`eK2Yx@DY%|4}AXdbZF_e#Ifxsdsa6SCWV%o=AN5T@%M(G#>hn zKZCcu?RWcP`g*)7^2YpQZyRsx+A_RjH*t#&%fr6BOTu}4?WRYZd)U1@6?U-?-(xQ_ zdBsOz>%<(3JdZEiOy1&;rf#5?_&`4PY{wS)6^pa7zj#&Du#Uw!HL@eV$6VtcpO`zt zzx)#4^fQ0(!(v_Bg+cbZKV%9X`aNFjE;hjR5%mP!r?VmUv3X+y=lp`t<_;2fN3bz? zT8@b(_Ds;mW-_-Ay?zu?8kqaw}? zo>xaHJcD=L_~-mANGygO z#=hT+D(dy88ukTHOvxFmPS`Iu5Aj!v)WdSyT1&*He>Tc<|7&mPZ@Fd#|v(avzbF;nn zhctqKak=vDn|KXD5xCN|GxbpfCcrJv1m6HgCSzjpLw~`k^$yNZ-z2?H4qnR@P1cng zdOImMjk+>+#MXN9E5?V2lI`IULfFXo;V<`* zF+0X<;mB%VP16tjO)Ux8Gdbu^$^l)H$9#rP^svugEPjyLwo}+`oy7^=`oY4lh-=7Y zB8$2=wSt)p7~2yexI-6X5Uaq}Oi;$Rxr^m(J07_!q~NI{u4i#&et_4yIawJG=@%wS z;<_S_6AbZXn;M>@%hKfmzAoVN)gf*g8MzU^;{zLLwZreW+|)g9_U6LT+)Z9Yt_lok zlWS6Y+;n22j!{1|-#9h~cqA75f{4St7iYsE#&B2pl{XJ8@r0p{Kh75f(e01 zoiyh$l7bamTMh{&>zM@OeEF&%?snibOivj)WZph8rgR;&uxW(c0K%SW;!R}MH4Wf5 zR}-ugan>D4VO2KL$H7f=nsYt@U((T2#@K;j&e`wi3pb2iyeA`N&>m_}Aw~xai0CIc ziN!_h7U1E;{lO$(F_o{7M@J-25epst<;4%O0&ja~xes6$9eloR9JbM~S8yBr&Mo!8 zh0?*nx!gsUWwHR=9+UkFe?2_tKr* z!G^q=f6uX<{bMV*W&nNPwg-pQH_p#F#~mh1dj4wGZvfeN>CpOO6K!4l% z*eDhjajbT2@WMqt-@3;Wlm25aZ+O~a_ww5v$l;hQGq$0-iLW*X_0(%PbI}^qoLBon z%UsjJzUp?e!A0;-uH%#P_v0isc&hX@Ht>Eu+IiJ^gLL1w_?#i}#$PskC3DBQipA#K zxrjQ-+yyQ;t&quapKl63{|?FE*J9O?SAbT1M*{9sPc7o(!jJPgOOfaRKXNje{cM{&C#3gene{#>n0 zpp$I$Ny1{oC_pQI+M*PJNKp!z?W+dlOq+3Txv)4uAv<<0=wh4m4z4ESEn_CKj&U5j z|HI~&d|5Wh(D#QyT~N4HnvRqaW>`@y1O;6Z=VGgCg!$-P^#}0v_qwO*|Bj$bvI4(7&vg zZkRdphWIBjj8p&k>6;n%<}$gXPWmUXveV|GWKPj-eDg`Vz%w@Z%5HSv z19P|DxYKrBU#DG)#blm41HC&yqE67~jkRBeP*KZ>PwQK5tGa&aeHW8CPJw0WVc7L$ z9R&n99m_I@kIgarX}R$0FGC%k8yzxUpD$hifF1tJcSqr-@?z20@PV+~`z24d)IW1D zIE-cL-nufC6ok(i+vtsR{PF&nth>wu$P_#S+q~hQa-XbW<<5hPcnzO*EW*|IcL8ON z<~y(glgxq8Z{6c7Yy>uo->5x9F&r=#K1dqMRrw`|b29AA4aL|c$3Bm#VvZk9f~Ukg z`4ODLRdYVy3|?2)1DIvW?UM0lyrq9U)<5QZe!tHP%K3Q{%L#X$@gGucF%utsBNIb2 zX#;F77=BV z4!CEK!$FVWb6l295ovt-Ui`!`)w8gyio0=XON^U93*C>d^i4%h$YMOc#U}(Yx`K~v ze_ZV|;HzW^o4{N2_g_(z+-LeB+q~`1Gbu0Kcp8j1oKKvEif-FU;?fcMF;2ux^zTK8^L>$%vGkMYs)M&~GY?7X?<`@&}P`7+klu_0?5xktOG z8<}^E_u_(hp3M^gz8HCs8vM$A_I^$Tyw@QqXJencRmdLy_`6ydN4{XwOh$oC)?ZQI znnlfPV<B#=S56?*$`JCWfxLk2oHTaSTuR zq}*QqLfo;381$r#{-eZgT$rJU1v3}Q;Hjv4{@8o1sC$SE`{g;Xqn3{ksB5{1#x~p6 z=4|4QE%PYv(zN@AE^>~?cf)DONPL5zcI=}*f+74%9e3lr$7geqU|%p6{VZh7Nn{iO z=1!};(7=HhY3GdKNE~CBVC9eVgWk!fAfNVJFg$RDlct|BWpX6OlmS=BfIMtzlQ)Z- zXlE?v$BdYO^N~dsDi(~Urfrkpi@t75+XUvcJ^1Lbzx72i2QXZ5 zy8Thq=vz4%yA2UD{*^E}cJ_UY-Pi{oicdQWUm%K1Y|1cKY`YUqsBzMqljB1toV~y+66kFxywU^@mtM z?D*N|SL}lm+)~`-b<85GuoD{tODpPw$Ae8}``x~BF}Z*IPMPxgU#w$3*LZ*WBX zvrV2MPnPZD@lD(@W0A6T@o>cZ zw#u*U=b#Vpg9m(;-+__iiHYEfdNR7qF@5nta!xz>P%ECG1m3c}vX3Sgjd_7XuA|1d z*7Fm)2XH`uXXF^Wtb4Y|k@BLlt@FLG`Lxfd(dGAE6+Z{E{hp=BclLR893M}O18^>h z6+z;z_mK=_FqQlPsdOY|aAt zw$Ud#eZ+Y1M2!%Oeg8e;Cks~;uklGJ&B-cAtej8E9- ztz#meSPkCjL#<(BqEW;~3B?{~J2IxnU-ZA`pEvhLd}lngC!4td2;13)cSTMIHu!5# zM#*0}hGcuy2Rj!g)Rl=Z_-5=J+}xWj+Hxxva!e7gy7G>f0$W{K^r^6uSn;qB`0_P% z+nA>&zT!&ePTUcD)rL#leVzFs{vKRoYo7Nx{>pu)mVF+K4?lZrU5@4)*qvu7Td}B5 z49$AsPTME$cq2K$JO(W6cj}dSi<(!S~BTBkrVjRSXxKM^2Ag1T8x>GBlu~5VH=p4jPNIMh+R?m(JNzJ z$Or`~w~c4La(8UOzPgiMae;w6=OTQ9%dkfFU^W-jmhnUWcr1SMHhqk3_{66>E*#JU z9z{V$jyLW;AddD`9)tX-9Yfr{cRx$U;%4ONl?z<))86Dz@P?3P^5vXgi?Pvv1{aEC3hXr3& zU7M$d`}{Ho_$1pZ{Z3!>>*hnPJ3o{^Rha&5<`r@+=J|=2;FSH2Ps4$a1(oR24;-fj z2Ni)8(L<3<5Up@#f(98fEq4(}4!9;r^ep-{mW8jvndK{mZ6g@h+eAPl4&?UPeohc0 z6RhZ?jm1pbf|K*Eg(C4@lfC@hr-E$xy>7TDi+;sJmqmIl)FaK{S@WOJdNCa zEX*h>k!R_bc|Qi~+^?OxQrs2u@rFzC0^Tj8WrxugWAQ`l#wFW~^Lr3wnJg5SE<3c$uiDP`ywl^0fW9x-_+M@5Gu6WQVv5xTIaq}L$GRQd*^RnIV$HBU*ugtq+qz`Qqe9?CkW3sK}1-!YwVdKPM@B_i+{jo7(eEM?^ zoWWOeh5yxlb^c-Q@K%1rWf)t}m~G^G9K69juLTb7?s%Mxcj^|oX5owx6LkA+64V4M zg&TM%MW5HAMQ%&3v7LU(Iw500U)YO|To~#2z23Yt2yAdXhB#Ni!5C`(X)sO9f83OD z-Zwbi_kF%afjxi3H&DB8jVV3q{i!5OhzLniG65Q?1Vbtc!Wlck;slXmOu6XV!4vER za}b8pFn$s|#(^=xmP}-fy&a7K%-G}N`ba`uJ>%e)Ja=>F`#J#={o#c>4#1;9pieNRi_PGg2_nji4D6j*}o3XHfpiePA^yEei82VE#zHkg;FLvPT zhtBw$g#nm>5y#td7W!fm0|U4o=RIy@XF;)|;*lmX2TqTBgIVRMxn7aEF~lId(^%ec*rMMIT8My((F5OSaDE{b=yzIBPEeXq(^sa(<2u z{7&3}37m{GM*K3qMSt>VU&7%eF?RZV_Q%C+ZQF^xS^UtB?bw=f{U^p+f5ueeoj;G; z#G>pcY!1L}-=k-0la5j@_J>=~J>v0|Wykj^Us)bQ%p$Af{gz`&8W6_?Mw$|1jr*Q`nNxmXD z<_bNAa<$fxBw)%#!x*hG_7Y3rg*-)&vS!kY+*TBL5~=QjEQ10)dO3JxbrdrSg!LWe zH%JE}vO+$q^|V`_w8nl5K?gpOb<8bm2k)|7;6nF~LPo-4OEc-m)%h}5unYllKDXZX z5w?OqFk~VlUx>vQY$T7*Q7Ff!(I@$-Na8FOz{iG>8{@NIhmB>QP~7Q+t;>8C))1IhC zRpi4t5s;!TJaC73qr30L$b%a?hK#{uKP}rfccrMKVOQxs+F-+`*;qgTFt7?4#3->A z@m==g@KLwE5C<}+N=|d~$~$Y`;IRU`sFBV^;=2_#Ixu|79EK*VG%hw+=Y(h`*g*a}aS`V0`l!df9VkFkyoe98?S zV~cr2-qe2ZyKNR-tVtsFz(}8NmHzl2^iv5$LG(2E&2xFXH!vtjX$7g#DR{m<@XjO} z1(dNXk|2W_T{t0xQ^a(P{BbjY!5;dG3BWjz4<|T#rC`+Zg_HEWXxiK zoFbMizgb-BrI%Q+yu9+x{D3psHg=}|x(k?xO}gjdW_+cKb8HDtMmG(aGjQnrAI8La zbV|2&mHUEe@PsT*Y0$sq2oVoVyfp3P0e(zFqgzk*#O_D%Y&JST)wcPmXzG zj;^{32Xu2|VSjh7;ZqjUSz9As(aXZCHz4kK*@s}MKJ(eSE5JvqUl7RO%eW@V+{ViB5qOIJy5P%Ka~PS%mL1C=#!Vwl znS2msgNL^uaIk{Q=dus_+WSMO$BhkrUyFX&J^wBT-Eo)1$Ax2%Ydquhz)FD^HY3|M zWmhow+vdPRKgQevaUA|p;A&l)r_BwIfCXRR$T5T4i8l#sIjOJLmBm7G>@$y}+J%ji z3%&Q$T-hk}PTX4lT>ZG;swlR7{tA8~RwfqsW2;+O8h!Qp#F=F`xGW0}<#E_Pazowt z9}Xi1X7TBvndA6_F?6C9at@Qqv3!Mv4RLD57+}8&(!?YG(2pX&5>JUGb*3M{hRlRG zykwlE4=fj%ZNJZ?f-L&7cyj-8jHg}I?iaP9xl4jx_Kj`EMjUQrx!+?vdBnnwJV`!- zBPMikr%r_}$YtzISoHNcM2vl29L%E8=PU5au{_-RO|glmvrdK$1K#|=)65-oGw(C; zZ!f^Eiqp>+$JUolPAzPVZjjdd>YMy#Jh7j#8T>5AQTtzFX=9$RKwvzAxC0aZX1}@M z3y%2i9LaqGPt~=dx$tG|x>(TNTx^mD@P|_BSn9XV@s;y>`F)MsT#m7UqvQLq^s?oU z=M9}cM}J=T)*7nL7zV7?aHor-7$Dc4YBtxh40f zFGNKX(IO++I{9N76C3 zE{zYpgDs0M{4qX@i*=7bu{l1fuecg!!BMtfBrdlzxuP+yj|k+F`=bYyso!cymahBT zN>gOuKKQR?-Pl_<8C$j$ZrIJjBVUzS=Q)A!+h?s?7#i*^Q!?M?Z8)P3diqsBf*<4{ zdn@|7U&brOQ0NaiZgcF7Q0_`v(ZmpOnRw0D@@xA83EffTypKObZU+amkVKwiOCD2> z#YIeV-jG?aPK{957j`mkWaB5~JKkFN(PWYT*qpipoBYb7j{yho_=Pt9T>BK0F?lyw z;oS0gU4HGbU5@49JMx`6IR555c5$8U+(*;U-(%!9x9bkgYhL8$wAA>ILV*uKvpzg-~0UdK5Yhq zvCpE0KJn?v;m@)sFRTt<2)PlLwa#K=xqdCzug{3bsa0TWKPqMpGoGr;7s}HP?9Vts z2V0xFInH{(Ij}428sUMNm_vvC+bm9Pv!v3W{29G(XHf`VpdZ_-FUHJ7A-B^Pj2@Q+ zb$+Zbhqj;l`}S5A#Ks7&VwixO1dud=`^Nu!wg==$XqgX{6FA;+zp$I62pb23!dcMg zeqbIw*+2FATyFchybOM(-%Ouf@v+Q5Cd5#eoKBcIQ{aiSN?h*Zt-!ga6cgGbr z8##pza4|v9XE0co0>%Yz8Po7=Q&q_zH)(6wiAIr*x{zZ#zcWVq2HnZ z#J-=$6I)>xa!WUV=rDfqppND_XB}Yc$SX{hdEha_*x-MwEkzxZyN@UeNJR+nvQ7Es7GR}cQt&uipH z8&7gr@SQOQ?_tXi^?<%$2%mrn9GRbk86GSb4z}B|XLRV9!?Q!JH)a+g#K7YV2Emo~ z7zZ}v$F{7EoUrc#h}iSk&s-c>XR+ARt)IQ0TrTP{3woN6!(wKV>Tbk{JpPfJ;_dWHhu^_Z*Kys}_y-ZoEJIGu?;WVSI4WLDUWbpRCm zdg%ls{Zlt`(AO`X39{%jlX-6YE`H!QyI?Q+69XJDR=US3_*sko*Mj(E&f=ns6uSNy?MVi6o>Y#_(|Jnv0x2pi}_Ea_sV?U2MEn-&YB3JyDU zB<`T3;%+XOh%ssroOjAm;6R`2>HJu;v2Sehc((jx)8aSY+z))r4J>}ZwBpGOcE0`6 z2;vTB9Lsv!*h@DaMh1CiyQU*sKj%92vAH>Kc`Q^=FL~~Zm`z(aKY!*$8B^GIHV+RC z0BCDYVuxVXO)f0$ezl$jy^~Oq%;Nwi2M()g;V_SV7iEGWPpRIZ9lIEi1mgp5pzyfxQD;3n+V4Nwk7okZV{VqE63dM z!Z`kTVLyD-=BSK;jjOGef5AHzJj1PHjN^BVwc<^F@I$P`cj92HbTKM$%2>fS`*D62 z1i{J1zVL}W!Ertp^c1@JGvp>0u%88cVB!wN;3byLiOqa)kZr^j#qub+IOyBP&ejnN z$jP|oYIm;g!5zBs&$K1H?f4?k(2;j#(C!Ph+X<(2SbQsxS{XJcifH4 zz>yf6b8u^WMrKUV^rxNqXzaiyxUzqE+|#ym<{dD}WLZ~YPFps1n5!f3*4V-Bcu<`< z>ArD_9W1tp>mBm|j%zQ{+J0{T744RXoEiJ(*tPNzSLS5-Tgr)_!bTn4TlX;?zLR;J zH9+K%ay|pgy;D{C^`D&&_ro26$0(E$Kt8{D2fdv-Z5GsaTAX@v@6B|dLKIxnNK78mf3*4R+@k8k@lRL8S!~nK_OP}8l`+wm zZT8Kx^t4kic}lEsGDKR}E4Qzp@biv|z+801^8?FUt{1)ST%b+MwU;;a2Zv*5aM!jC zpI2aQkJ&81ZS!ET48+bDkH=2VjqIo$IWCW}amcY~O4Q#Gk>9 zWIHIjZXe%xKe?7;ZSp?iQgDbHWv-0jOFx?5#}+no_yaCEZrYqgGi9aYZk8(g zr~UTx$nPst<^`GDwHtZ<>wPCT_1WKF>67iH#=PuG{_Bf6F@Nc&zPZ!%rOnuyeK*aA z58nA{dmlKAWybILQRl#pEo~)G(Oh{m-a63>ro_zFk$aExetqPI`;A_ABHjz$!X8EJ z@uifDalys-F^|E6EDq!15W8pY3YkT1%N!4J*qnTBf7qZh^x-nFFosjJ7z&(h9b6HY z9lvOwoF%To{H_7)g8?4whuK~n`Q_+w{i>|teRWaa=s$JT^A`5cW4pKC1FwCx)V^b) znBXy_OircXFFf-WG=XmB7dq{Uk3zLvXohjY!L#37b11LB=>A z8UED93i(5nWnl*!iz zbBnF-4UWKh4sJWXY1=9|AXez_@q;mJuZHyLcKpsb`+TkYrDSaIgddtVVo~v!0GlZg zT%~{^aI)}9ld%t5u>skw;8@qDG9G1KaL!|-h*iZeUi&7P&Huedh^!up7VJ6OrH6i7fh6JPLU5Yk3>o&d&#K z`l2r$H4Y5RCohKH=!cAv>#NYT+o$gzy0}Aw|Kqz%Fl1s8TZreVHG{`}Q%3%XX=1E( z>)Y^STe(wDy(?n|dr|ixB=aF+dHBI@pFmH$u_*nH5f*62Xuo)0kz)(qiFMBnBCo+q z?0Foz$>s5v{ozL)ceDK6{#4rQt^=H_S&tHHY zZrrr-CnxM{Hsr3?-M&)f6nCbKeRP@I@nyurJaQt&@30v=uQ86lj+n$}6QA}mc9*%A zWhGZlT!oA>7;7c-9TNTRXnmC(rF++xE)jE&+k`Ycm8&T>`v6Kb=Cy<`6v z7@X!rb%!48VaN2behM8nw(Y7BaJP6S%P}~I0;lca# z1$UK`If@;9;VhGA#;1SrnV3ws;8OeiI(G25fpf3nS5Nu%ZEK`HoQ&S! z2;1qm13&h?IZNF+mc_vjHNg8raZ4XOj&nolKH6>LN?mU|8m^E_yn5_3y!{d+u?x?{ zdMh3m#;35#gZifK2tW=PGp3P2cQ*QtA3|5!kh!a{5e(xa*@jevKV;C3tEv4jObXR- zq3An1TuAZ>GRxuOVn?lO9=LdHw!ZA zF!5eGGI?KQW1IcAiAm!DAlwiCjv+9g0g_tlIxri2SO#5QMaco4N@hGSDB(&mj;Cwr zMD0;@{`RN8#{s$AR&P7F&U+v-f!l3{Ib=%?dXvxu0eIYp{t$;Fz&p-MeWS>BX7EPg z8yoGwqMkt?0s(?qt`0c zJm2=G7>|Ik4S&42Kz;cDSt9Xuai^^D8$OOLnl8q;I-XdMVo5Gc|2F65pcUA?HU4=R zVa|NV>y1q^FkPSGzjF{coMUqp8+Q+8!G(`PG&Ya}a6cPy;XI(oo;6v;xg-sah4|)!EH=tBOWYa8-Afr+ZOI( zrJghJyihYr7k@>3x1uI-N6ALboiT5QFuJh4bYm6Y&H#4Njm{kGKf1U7wPUaqbt3Mv zh?>aQjxX$kf8-N;_WMli7?k;(u@Qa7M$4qTNL z6^jpa+WRvg*pAMAfp7Q?Zooxh-DB*vc_x$SKMC%BWzGhiF)*-@8RN_G(v01Qx49^Z zSe!rWLI*Jox7hOF#85UkGe_xY-ng=ycFU9OSNoJk?zX_aJZ5CWD-$=13v$ihDqDI^ znAp{d2~lCQ&%t9JcU<8kuPkTykDAi%Fuc6<>CKyK$nauJ<2U-aee>~nlo1E6Q!*}e zJz{vOAFMiBr-IG=;+(r@tyfBhLpUkzO)OQ4ro^vtwLI z&|VI9h9e7Xv)Q5ZJU8v2R{CyIe|NCtIAoKgc^lk|xza7VBNzhNV$nljGuf{w;EZ7? zK}TSw+~(FJTi6Z+c9!+ARhuujqbCJm_h148$KG%DJq{eDXHZWJy!wE1mGns=4JbK= zA6q0Q)DeHWF+jXXzA}phX~v+Rv52Zyp^jL<_D4LsK&`qHIgRyttX#7HgO}XO#ZW97 z@o(e+a%IdJ8^{&;!Q&z@)O~DQ>lP~TJ+{P*z2sq=XBSjicDc{ilSATW#RbsFr7&Bj zu=5qS@L#sO!zQ^u+oSEpornd-z48k_%6U2Al{w*K;v(_qBB$izz*dfzF(mbaIq`Xt z&)He>TUQSadoLnnhXPiJLy9%Z2v+!bW%+ zSD}ymXP7avU%EWXF<*6gTw(L*Pe1J76Wq3;^YNRHXYQdNlRCb(Ec9d!h;if-=e@o0 zA)f{?gOLlZM~zAO|6rt*#yTVSg%up~#bfs3nv2ta|OV}c5-BvUyi z&^LE)D6T#)5)5wnQ@r;Dx!^QD84C-Tu?;L7Ti#4w>p3yam4@@AumOC=FxWX^T&FSG zz+w#Tq#k^v_m!LzF>%?Z?#l!Hu>WnNjFpa^x_1;t-I_8r z!upU)oHy;9^F}VwoHR^)xZmVY7F~FxPBB(7RyUR&Hrw|~xokToW8Lq#8F?LdKrC}6 zPh)-f3x2I{YDd;rZx7DykjL@ZPp+o_jqk1V(Lv{U>(;g5*MBqlVOO+0Ft{$vMIPgv z|6@z&r)E%dWI4l?`J07f))s_V&*UyD>i+Zzi;TAHm~tf7tf2%<%HjUa}t>J$h0J4V{?h0wLR z>*iHCe({CmA4No%PcQQ}S9j5NK-_*unK5yf08ZOEBj*=BXYmNH7K5Iya}hC*A8lvr z#yf?3FnVxD-;r+)IL2Rvd~ku+?T@(0xU?;8nT<_wg&rP*+n3|&&<+zzgf94`YO{^3=d*N6*w&82WOf2ehM?8WV8#WwyTv6W;=G>Qa zwR|2tLe?mJPPmKsf(~;s;g0|Gj@e23G zy+6ZN_(hlXWd4X_+W?lakqblXL)O#>Z|LuS;uWTYX?yH6xVzin4S2-L2X8|`hsU(@ zDD{sG)Jf!9F7}p{&)B%g&5N|=y+t063=wy_e8AZy&N?1T2-$2T`d&LJ58 zjLgUj>E?R-Vno!Nh-1BQaV%^OyJUR}Ij>lz{R}?b5_2OYbdAiY-J_sA!7O)-+*~Yn zeg5~={sv=y31V&l02bp(L_t)J182ky*ouiNbkK%fm2v!<$hUnqKM65pL_N*?vn=L> zD#xQw3{N@Ny<&tISnDoqz$g1)`bWIwq%OE(96sS#mj^fJ&~xsK7#heS4_lY*`pidQ z$iRQDsSS23PF;^N5kuQ;Rq_5w#}aXU1YBc=XX3_-qlty+KNR~BYx!IE%Xv?1u#I2d zxG$&o*Wib2z7f(}c_5C4dx<2ZTA~D{rO{&#bR341Api&3OU%axZtPo?>zbl>=WY=PhdyqOfGTdP28yO zPsm&Yo-)LRgk=;4`*H;V<2!1PWpsyNatS61Q>np1Q z6MdDjVq56fCZa-S!9n2rwC-HsHF1uQ*uat)eVStgfG_=`$RE10kV9t2ot$QIhEDT` ztQ6EfS^nn`mWW|bx*Pl9^O`kS5kw7dSx;h*SfT&eOIu$M!%|z19s?cO`5M_y8hj_rhg5(vY>#+iEIPq$og*jp#o}pdql+zf6B#sodeOu&Tu=POS3V$M$=ndbVaI3k_u{Fd zhA(PG>gHegZYH`glndOB^RxI1AB~L+4KCYx*2X^O+2+3G+De}_SQYiom_=UuIOBef z=^HZUT;P>`!=kIWcte%PvNd-@xKJW?$q9UFTbYkrmp?eI9rXtCh@Syxc`TmXXSt3MjT@u9CCn+C>zK=6I^AoMS_&ax6haE`xYL39Y7frhmo^AilHu%gIAY_8AJ2F zw-O5h;0;|QWP8Q@gB=XT2k3I3$=tMVF-2zbIs94fw#_U~37qXoxtVzHunG9lL(IJR zV9;>k^945Wxe=buNxx!~$IQ=6&=!8Fie%(ix8RF-ngOAsV-f-nU6ON;;c8`KFXWZ? z;a}uP`7WnpaOAaP5TAq5+k+Bh$2s_D^d}!|uXsY|#7@MiENg~`Z9mBMNpR%2i6sv&>cX?dM!$di@r?A39_-FX=`I6&5;=3wr3(UJueDSCV48sxf zJcRgr$03s#SKPAg%lnN^xU!x{{G)?0F^LC#b1v;~WLo~<^ME(!oF9McIWLs;&*bS9 z!&`5`VaA)~6maUWA5T$i@Bh#Bd@nOiWIu{c8Wy5Uan^-q& z`~WBZ^33U9w@!m$_RVPI(bEg zx8b0r9Z5S_V%%dNe8{4>+5X|cc`EtUI+9+a?uYzO%4Dg`U*Tl*3CnGkzaYG z$CfcYxXGK2$H-yl$PLbXc#kcVMGkR=zxwrPqoPo^?!+_+7?`)xpFgn$Yjz!^_mN*FvRr1T!9dZyE0m?xkn^a^a9Q zA}AeS4j*|J1i1`^EAI|p@BH<6IA@|AdyEf$h&k1B4jLE{d-#{Jv*=VTI53V_;0`bs zyP-QV2>xI3H5ejiJnYAf#m^gmoNU|4BgOs7G5jz%1LN>Bgk0VQ2X5zdE|%IdkX~;sI?n=#6Oc2;>K4h$$=eF%D$h=@bkM7S6~t5oiHtn^ zxxJj|kVMj#B2du}FHv|Fh2mu&LA4{%2kX0N-~jW0EGU{4E`N-TM}LnFFS`d%JRU(f zkDSEBjsvZ?t&4>Px|@9ln+I&@HoxW=JI1b9sE9;a2RptvGs?xDyw){Aa?+K;_quU3 zS1It%RZ#F=#yq!D(eX;?!l#iG^7vIzR6V53CwCiE_D|T7JXh+|)d^>kIePcWemwF) zzjKP)|1%-+g@vN?IbC5Z1*NQq31Ixr&KHG4JRUG6CD+gqoWWuH&69APV??aL6S5U~ z7!!+!jJzfudBg%yVfWbJadX~n$*VFJz_pEqI${4bu^9fE`oQM?jGG0L?DzB``GWn{ z56`j=@N_H^&Vb8faYw}C&~LQ|i}k|yEYRdQg4-|R17FE)<2(MrBYcN1W^N#7(2@Q9 zE$GmKkrgo~d5n2$?oQJ^xWk`gh{tdHbiHh7Pviopbz$F%WAM<27<}6V&-7&sr*3<^DvAN$0zmHI2Fg~Wy|+HR{m8EE;|n+eIgMs*DyIsNH=@_A&3Bk4Q0 zLmAJb6_c8QWf5m<2b1@k_btUjAn}iUFa)pcWI!g7(=Tk5gSJV;=!1UY#O)yDaigrq zZI2-Hc(8zDIQDDW07udNa*F=?LN54H2Ju0^*f68yZyv4tvH$gP7cPu@+aT|<5Pj=R zJg33BBEd2q9z3|Pz$3E8pSiux7kcxYyLMv2E()dPOb$hY17U3X0?)(09Q$08>!{_t z^LCDb21d3q;2wv%gEQK|w3dq!AG`>B2pC&Aw!LfvC49EIOB1$&VK`2C6ymfybR=f* zj11yDCR%i`NKGsvJ;R8$AK8cBS@?i8CKu}FG-FFUdHBkW$gg(pbRQXy-;0WR055E9 zTQGSm^2jlgK4U9#%JL2Wv_)QGf7*_mj>XW(4s7z6#J}4M*{pTpL%sZKGlr-4Hn{9h zjv15q()Z=XC+CaU0*mpK3ti5iCC86RtC+v=D}2Z9UGNcq-l}|lzrM$lKdDY0 zku_Ysa%yrqY;5OxMcl7^OwKqNpM5v37~?M9?wj*mbWCk@Y_pgvbBhauw>2c-cN@)SNx=gJZaK4BEc3{Yx$*PU^YMQ z?B}51c?W8Cw$8CBca-9*OV zu9M(gaVB8;v5j8?pJ_j1WzJ~y>-3L;$C%+a3QF>g!BuynWCF9gyJ4eTAR;G+TkLW% zA025b91sWC7g&&!SmBGDh#{}eFZ>yYmb3XZDOdH@0p3Cm_+v7|wrNN0dmq~@x15u6 zhY_*vH}T@faIy%naRM&Duc$AyXMgejo~$D&*Av|lcrea|q=A&*55c%|a!fq21`ftr zHaSQ?4?V~JhuvT*COE1iA1;{+Xv?(5& z!rjB-D^$9lo}%6imcUtc{Z39p0b9d4-}WBTp&1lRxY0lmNwHF(5r+0X$xS{23Dkc(`PJl!{^I5F+O==G96nHoP0#_oPP8LEAh;J=BoXP{<7X~FQ{X|HG1O_P3dBI zaF@2EKVxh1DIQ009-NcMz9X?c;XL%XU)s+3;mwO#;)L;O$0gqTU)Y5$Y~ar=ZH3Rt zqqi@zrVzu#2a{Xmf2V@J6LWPuLV48_g>GWGJ%;_U%LCJQyZ}eW+KvzUVh8gN)I8<| z>!Y^E>9MPcV{l++wmbLOy5rGd_#Y4zHE^&Jm)Re^Q6md`ZD++@6J=~r=imcbx(hA& z_bui23jeccDP3Q}9sHPr!-M57d?D8aIz?T~dAZ=j=Q1ZAy2IyS9Gkr!_^@C4^TtB* zK+cK9lCcf{V0|8+M__{)VBY7Y-+@j+WkWDy+yf+j+>xk#;h#swk>`iw|wXllPl3<9Q7`3%L|^ z3W@un;}K&tg}in{;v1jX&OAns!hh&M&zrZ2Q|$LuP}JHp8MDX^lO^lq&e0h0j2-s# z3K4$bYTNHqIAd(P_%(5gUHBrlibW$6M0qk$-#8L{dY5l^mwh(8_?&#D$6W@cO#0f6 z!5RFrE$$3Pj0!&@$LF_;GVS9-_kj!WaHu*(eR%=Uo@54V)`qZkF09!1HvHGKX5yo< zfjJr--f#L_mf$t{VnQn~IHT`uZ@$cbawA2Jj2y|lIwW0LoS$9q|B#Dc*s$Ez>%M7t z!>=*Sh3)GvZQkZ-E!VNg<GJfR3A9hpAY-7ew zj!`*Q@`4G!SpgXK43xT6bCDD}mARt;xUZjb(L6q)Zg5A3dV@{!Vx}E8SKaiTIVj?3 z7G1$Z8$&715&u9&`17Lr{1#Zfk_<&8@c=X_V;r}rTr`S+x3VrfESxtojOSWyQru5E z@+m}$Wa=c**c*JYq8=xvQ-iq5Bng|u?Ppz`+jx+{$?hoN7R5d~JCAK2Z|H>|l2SZ7 zjq!pLY~@X6aA7hkF{VQMvx7r*BvSmfF|_Y$3@-OqopUn>?VAk6SZsd9ljK*D$NdVP zgR3^p1J{dyG8SwH-z?r7uahY5Cv1mU_>2A1*?lYC9~O9&v1_imRV#FXP0!ezwvaU# z>wY=|!?Bq`<2z1KINhHG=$vzGG5!%3+wJJmixXtM__EkDCVo#%@Dj%@`$E@OW1suV zc;Tr$ehMCPgX3ixERv=Va+#oIo%oj=!A|1Yu|4*JA?(K&ZC=1Fj)%Al0nWhZbT|jp zAw>74|ttLexFaq~Tl|-h2Ru*oR-HMqqc?5B6q};aI`H zgOmD#+akY4k51>Agc)ya@BL+7iJ68&>r9@g37nTFTl@o0{LSJ**GFYLo8y>-2Lpe&n>$~ngdkA+R7Gl6@;H9YbKaHjk`nPq|Tm+6CmRt=mN7Xuk~R*nik!k}3*>EDJ|W|G1?% zc!I~~%cL;uwT+Fs$+C=HmIan7zYl>2xl`ycwtdeF(DFcT(m+gIQ<1*agt zf<0w%>$Rg8TioCrp1<(1ysz}P&ksK@2w)srC|6XkG@v+L-RW)z(BF*?t}Hs;KTrb7=-V^%@BTj%W;c64=(7;;}dhyU~?b1 zo*`jpyZ$Kn8Jr$7IQy8IxACWthRvy?xm6z6%Q3@MZ-b9mhm1BrB)=nv(`T*g>)gNyB!!x#(5kOizMSIkM*fJ-?pEN*Bvp*9H+YPVZ=_%=#H4rbIB*XMEd}j$L8He zYLf?0E0`nTCTnB*slvx!wH;8lCu9wuOX_{x`nUrsRks&C;14}I{i;e${T#jSPfq8Y zm^NvtPJnAZYEIoRoqzn?3Y;Dx79IJ;;;JNdsVwBcsnfT^ZzC+Yr_cIO^;Wm^{{tsT Vmf+#gfM);z002ovPDHLkV1nQwh^znr literal 0 HcmV?d00001 diff --git a/docs/porting/visual-cpp-porting-and-upgrading-guide.md b/docs/porting/visual-cpp-porting-and-upgrading-guide.md index a37ba527a58..8cd4255be49 100644 --- a/docs/porting/visual-cpp-porting-and-upgrading-guide.md +++ b/docs/porting/visual-cpp-porting-and-upgrading-guide.md @@ -1,60 +1,151 @@ --- title: "Microsoft C++ porting and upgrading guide" -description: "Upgrade Microsoft C++ code to the latest version of Visual Studio." -ms.date: 09/10/2020 -ms.assetid: f5fbcc3d-aa72-41a6-ad9a-a706af2166fb +description: "Your comprehensive hub for upgrading and modernizing Microsoft C++ code to the latest version of Visual Studio. Find tools, guides, success stories, and best practices." +ms.date: 11/06/2025 ms.topic: "overview" -ms.custom: intro-overview +ms.custom: intro-hub +author: tylermsft +ms.author: twhitney --- -# Microsoft C++ porting and upgrading guide - -This article provides a guide for upgrading Microsoft C++ code to the latest version of Visual Studio. For projects created in Visual Studio 2010 through 2017, just open the project in Visual Studio 2019. You can upgrade a Visual Studio 2008 or earlier project in two steps. Use Visual Studio 2010 to convert the project to MSBuild format first. Then open the project in Visual Studio 2019. For complete instructions, see [Upgrading C++ projects from earlier versions of Visual Studio](upgrading-projects-from-earlier-versions-of-visual-cpp.md). - -The toolsets in Visual Studio 2015, Visual Studio 2017, and Visual Studio 2019 are binary-compatible. Now you can upgrade to a more recent version of the compiler without having to upgrade your library dependencies. For more information, see [C++ binary compatibility between Visual Studio versions](binary-compat-2015-2017.md). - -When upgrading projects that use open-source libraries or are meant to run on multiple platforms, we recommended migrating to a CMake-based project. For more information, see [CMake projects in Visual Studio](../build/cmake-projects-in-visual-studio.md) - -## Reasons to upgrade C++ code - -If a legacy application is running satisfactorily, in a secure environment, and isn't under active development, there might not be much incentive to upgrade it. However, consider an upgrade in these cases: Your application requires ongoing maintenance. Or, you're doing new feature development, or making performance or security improvements. An upgrade brings these benefits: - -- The same code can run faster, because we've improved compiler optimizations. - -- Modern C++ features and programming practices eliminate many common causes of bugs, and produce code that's far easier to maintain than older C-style idioms. - -- Build times are faster, because of performance improvements in the compiler and linker. -- Better standards conformance. The [/permissive-](../build/reference/permissive-standards-conformance.md) compiler option helps you identify code that doesn't conform to the current C++ standard. The [new preprocessor](../preprocessor/preprocessor-experimental-overview.md) supports code conformance, too. - -- Better run-time security, including more secure [C Runtime library](../c-runtime-library/security-features-in-the-crt.md) features. And, compiler features such as [guard checking](../build/reference/guard-enable-guard-checks.md) and address sanitizers (new in Visual Studio 2019 version 16.4). - -## Multitargeting vs. upgrading - -Perhaps upgrading your code base to a new toolset isn't an option for you. You can still use the latest Visual Studio to build and edit projects that use older toolsets and libraries. In Visual Studio 2019, you can take advantage of features such as: - -- modern static analysis tools, including the C++ Core Guidelines checkers and Clang-Tidy, to help identify potential problems in your source code. - -- automatic formatting according to your choice of modern styles can help make legacy code much more readable. - -For more information, see [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md). - -## In this section +# Microsoft C++ porting and upgrading guide -| Title | Description | -|--|--| -| [Upgrading C++ projects from earlier versions of Visual Studio](upgrading-projects-from-earlier-versions-of-visual-cpp.md) | How to upgrade your code base to the latest version of Visual Studio and the compiler. | -| [IDE tools for upgrading C++ code](ide-tools-for-upgrading-code.md) | Useful IDE features that help in the upgrade process. | -| [C++ binary compatibility between Visual Studio versions](binary-compat-2015-2017.md) | Consume v140 and later libraries as-is from v140 and later projects. | -| [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md) | Use Visual Studio with older compilers and libraries. | -| [Visual C++ change history 2003 - 2015](visual-cpp-change-history-2003-2015.md) | A list of all the changes in the Microsoft C++ libraries and build tools from Visual Studio 2003 through 2015 that might require changes in your code. | -| [Visual C++ What's New 2003 through 2015](visual-cpp-what-s-new-2003-through-2015.md) | All the "what's new" information for Microsoft C++ from Visual Studio 2003 through Visual Studio 2015. | -| [Porting and Upgrading: Examples and Case Studies](porting-and-upgrading-examples-and-case-studies.md) | For this section, we ported and upgrades several samples and applications and discussed the experiences and results. These articles give you a sense of what's involved in the porting and upgrading process. Throughout the process, we discuss tips and tricks for upgrading and show how specific errors were fixed. | -| [Porting to the Universal Windows Platform](porting-to-the-universal-windows-platform-cpp.md) | Contains information about porting app code to Windows 10 and later | -| [Introduction to Visual C++ for UNIX Users](introduction-to-visual-cpp-for-unix-users.md) | Provides information for UNIX users who are new to Visual C++ and want to become productive with it. | -| [Running Linux programs on Windows](porting-from-unix-to-win32.md) | Discusses options for migrating UNIX applications to Windows. | +**Transform your legacy C++ applications with confidence.** Whether you're upgrading from Visual Studio 2008 or modernizing to take advantage of the latest C++ features, this comprehensive guide provides everything you need for a successful upgrade journey. + +:::row::: +:::column span="2"::: +## 🚀 Quick start + +**Most projects upgrade seamlessly:** For projects created in Visual Studio 2010-2017, simply open them in the latest Visual Studio. For Visual Studio 2008 or earlier projects, use our [two-step upgrade process](upgrading-projects-from-earlier-versions-of-visual-cpp.md). + +**Binary compatibility:** Visual Studio 2015, 2017, 2019, 2022, and 2026 build tools are binary-compatible, so you can upgrade without rebuilding library dependencies. [Learn more](binary-compat-2015-2017.md). + +**CMake projects:** For projects using open-source libraries or targeting multiple platforms, consider migrating to CMake. [Learn more](../build/cmake-projects-in-visual-studio.md). +:::column-end::: +:::column span="2"::: +## 💡 Why upgrade? + +- **🏃‍♂️ Better Performance:** Faster execution and build times +- **🔒 Enhanced Security:** Address sanitizers and security features +- **📐 Standards Compliance:** Modern C++ features and conformance +- **🛠️ Better Tools:** Advanced debugging and analysis capabilities +:::column-end::: +:::row-end::: + +## 🎯 Choose your upgrade path + +:::row::: +:::column::: +### 📋 Assess & plan +**Evaluate your current codebase and plan your strategy** + +- [🔍 Overview of potential upgrade issues](overview-of-potential-upgrade-issues-visual-cpp.md) +- [🔗 C++ binary compatibility between versions](binary-compat-2015-2017.md) +- [📜 Visual C++ change history 2003-2015](visual-cpp-change-history-2003-2015.md) +- [⚠️ Features deprecated in Visual Studio](features-deprecated-in-visual-studio.md) +- [🎯 Use native multi-targeting for old projects](use-native-multi-targeting.md) +:::column-end::: +:::column::: +### 🔧 Upgrade & modernize +**Step-by-step guides and tools for upgrading** + +- [⬆️ Upgrade projects from earlier versions](upgrading-projects-from-earlier-versions-of-visual-cpp.md) +- [🛠️ IDE tools for upgrading C++ code](ide-tools-for-upgrading-code.md) +- [🔄 Upgrade to Universal CRT](upgrade-your-code-to-the-universal-crt.md) +- [🔧 Update WINVER and _WIN32_WINNT](modifying-winver-and-win32-winnt.md) +- [🔗 Fix dependencies on library internals](fix-your-dependencies-on-library-internals.md) +- [📊 Floating-point migration issues](floating-point-migration-issues.md) +:::column-end::: +:::row-end::: + +:::row::: +:::column::: +### 🌐 Platform migration +**Move your applications to modern platforms** + +- [📱 Port to Universal Windows Platform](porting-to-the-universal-windows-platform-cpp.md) +- [🔗 Use existing C++ code in UWP apps](how-to-use-existing-cpp-code-in-a-universal-windows-platform-app.md) +- [🐧 Visual C++ for UNIX users](introduction-to-visual-cpp-for-unix-users.md) +- [🪟 Running Linux programs on Windows](porting-from-unix-to-win32.md) +- [📦 Port third-party libraries](porting-third-party-libraries.md) +:::column-end::: +:::column::: +### ✨ Success stories & examples +**Learn from real-world upgrade experiences** + +- [📖 Examples and case studies overview](porting-and-upgrading-examples-and-case-studies.md) +- [📝 Case study: MFC Scribble upgrade](porting-guide-mfc-scribble.md) +- [🕵️ Case study: COM Spy upgrade](porting-guide-com-spy.md) +- [🔍 Case study: Spy++ upgrade](porting-guide-spy-increment.md) +- [🏗️ VCBuild vs. MSBuild migration](build-system-changes.md) +:::column-end::: +:::row-end::: + +[📚 Read more case studies](porting-and-upgrading-examples-and-case-studies.md) + +:::row::: +:::column span=""::: +:::column-end::: +:::column span="2"::: +![C++ logo with an upward arrow and abstract code on a blue background suggesting improvements from upgrading.](media/upgrade-cpp.png) +:::column-end::: +:::column span=""::: +:::column-end::: +:::row-end::: + +## 🛠️ Upgrade benefits + +:::row::: +:::column span="2"::: +### Performance & optimization +- **Faster execution** with improved compiler optimizations +- **Reduced build times** through compiler and linker improvements +- **Better memory usage** with modern runtime optimizations +:::column-end::: +:::column span="2"::: +### Security & reliability +- **Enhanced security** with address sanitizers and [guard checking](../build/reference/guard-enable-guard-checks.md) +- **Secure runtime libraries** with improved [CRT security features](../c-runtime-library/security-features-in-the-crt.md)) +- **Better error detection** with static analysis tools +:::column-end::: +:::row-end::: + +:::row::: +:::column span="2"::: +### Developer experience +- **Modern IDE features** with IntelliSense improvements +- **Advanced debugging** with better visualizers and diagnostics +- **Code analysis** with Core Guidelines checkers and Clang-Tidy +:::column-end::: +:::column span="2"::: +### Standards & compatibility +- **Better C++ standards conformance** with [`/permissive-`](../build/reference/permissive-standards-conformance.md) mode +- **Modern preprocessor** for improved code conformance. [Learn more](../preprocessor/preprocessor-experimental-overview.md) +- **Cross-platform support** with CMake integration +:::column-end::: +:::row-end::: + +## 🤔 Multitargeting vs. upgrading + +**Not ready for a full upgrade?** You can still use the latest Visual Studio with older build tools and libraries: + +- ✅ **Modern static analysis tools** including C++ Core Guidelines checkers and Clang-Tidy +- ✅ **Automatic code formatting** to improve legacy code readability +- ✅ **Latest IDE features** while maintaining compatibility + +[Learn about native multi-targeting →](use-native-multi-targeting.md) + +## 🚀 Ready to start? + +1. **📊 Assess your current project** with our [upgrade issues overview](overview-of-potential-upgrade-issues-visual-cpp.md) +2. **🔄 Follow our step-by-step guide** to [upgrade from earlier versions](upgrading-projects-from-earlier-versions-of-visual-cpp.md) +3. **🛠️ Use our IDE tools** to [streamline the upgrade process](ide-tools-for-upgrading-code.md) +4. **📖 Learn from others** with our [real-world case studies](porting-and-upgrading-examples-and-case-studies.md) + +**Questions?** Join the conversation in [Microsoft Learn Q&A](/answers/topics/c%2B%2B.html) or check out the [C++ Team Blog](https://devblogs.microsoft.com/cppblog/) for the latest updates. ## See also -[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)
-[What's New for The C++ compiler in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md)
-[C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md)
+[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)\ +[What's new for the C++ compiler in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md)\ +[C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md) \ No newline at end of file From 48d2bdb01ae68192875426c39d8ef0d58747755b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 6 Nov 2025 15:56:46 -0800 Subject: [PATCH 1451/1799] put image back at top --- .../visual-cpp-porting-and-upgrading-guide.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/porting/visual-cpp-porting-and-upgrading-guide.md b/docs/porting/visual-cpp-porting-and-upgrading-guide.md index 8cd4255be49..87a10484b8c 100644 --- a/docs/porting/visual-cpp-porting-and-upgrading-guide.md +++ b/docs/porting/visual-cpp-porting-and-upgrading-guide.md @@ -12,6 +12,16 @@ ms.author: twhitney **Transform your legacy C++ applications with confidence.** Whether you're upgrading from Visual Studio 2008 or modernizing to take advantage of the latest C++ features, this comprehensive guide provides everything you need for a successful upgrade journey. +:::row::: +:::column span=""::: +:::column-end::: +:::column span="2"::: +![C++ logo with an upward arrow and abstract code on a blue background suggesting improvements from upgrading.](media/upgrade-cpp.png) +:::column-end::: +:::column span=""::: +:::column-end::: +:::row-end::: + :::row::: :::column span="2"::: ## 🚀 Quick start @@ -83,16 +93,6 @@ ms.author: twhitney [📚 Read more case studies](porting-and-upgrading-examples-and-case-studies.md) -:::row::: -:::column span=""::: -:::column-end::: -:::column span="2"::: -![C++ logo with an upward arrow and abstract code on a blue background suggesting improvements from upgrading.](media/upgrade-cpp.png) -:::column-end::: -:::column span=""::: -:::column-end::: -:::row-end::: - ## 🛠️ Upgrade benefits :::row::: From 186f736300bdcdac860e92eb990b48b44a34cb0c Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Fri, 7 Nov 2025 10:04:24 +0900 Subject: [PATCH 1452/1799] Fix typo: cancelation -> cancellation --- docs/parallel/concrt/cancellation-in-the-ppl.md | 2 +- .../concrt/codesnippet/CPP/cancellation-in-the-ppl_12.cpp | 2 +- .../concrt/codesnippet/CPP/cancellation-in-the-ppl_14.cpp | 2 +- .../concrt/codesnippet/CPP/cancellation-in-the-ppl_6.cpp | 2 +- docs/parallel/concrt/task-parallelism-concurrency-runtime.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/parallel/concrt/cancellation-in-the-ppl.md b/docs/parallel/concrt/cancellation-in-the-ppl.md index 3d97190376d..66e4150037a 100644 --- a/docs/parallel/concrt/cancellation-in-the-ppl.md +++ b/docs/parallel/concrt/cancellation-in-the-ppl.md @@ -215,7 +215,7 @@ This example produces the following output. Caught 50 ``` -The following example uses a Boolean flag to coordinate cancellation in a `parallel_for` loop. Every task runs because this example does not use the `cancel` method or exception handling to cancel the overall set of tasks. Therefore, this technique can have more computational overhead than a cancelation mechanism. +The following example uses a Boolean flag to coordinate cancellation in a `parallel_for` loop. Every task runs because this example does not use the `cancel` method or exception handling to cancel the overall set of tasks. Therefore, this technique can have more computational overhead than a cancellation mechanism. [!code-cpp[concrt-task-tree#8](../../parallel/concrt/codesnippet/cpp/cancellation-in-the-ppl_14.cpp)] diff --git a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_12.cpp b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_12.cpp index 54a60e82783..93413d211ca 100644 --- a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_12.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_12.cpp @@ -1,4 +1,4 @@ - // To enable cancelation, call parallel_for in a task group. + // To enable cancellation, call parallel_for in a task group. structured_task_group tg; task_group_status status = tg.run_and_wait([&] { diff --git a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_14.cpp b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_14.cpp index 501bef3171f..20dc01ea24a 100644 --- a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_14.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_14.cpp @@ -1,4 +1,4 @@ - // Create a Boolean flag to coordinate cancelation. + // Create a Boolean flag to coordinate cancellation. bool canceled = false; parallel_for(0, 100, [&](int i) { diff --git a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_6.cpp b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_6.cpp index a2fd7307692..64bd96b60aa 100644 --- a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_6.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_6.cpp @@ -23,7 +23,7 @@ for (int i = 0; i < 1000; ++i) { // To reduce overhead, occasionally check for - // cancelation. + // cancellation. if ((i%100) == 0) { if (tg2.is_canceling()) diff --git a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md index 23e2ad45736..d6ab7f02cc6 100644 --- a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md +++ b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md @@ -257,7 +257,7 @@ The runtime also provides an exception-handling model that enables you to throw Although we recommend that you use `task_group` or `parallel_invoke` instead of the `structured_task_group` class, there are cases where you want to use `structured_task_group`, for example, when you write a parallel algorithm that performs a variable number of tasks or requires support for cancellation. This section explains the differences between the `task_group` and `structured_task_group` classes. -The `task_group` class is thread-safe. Therefore you can add tasks to a `task_group` object from multiple threads and wait on or cancel a `task_group` object from multiple threads. The construction and destruction of a `structured_task_group` object must occur in the same lexical scope. In addition, all operations on a `structured_task_group` object must occur on the same thread. The exception to this rule is the [concurrency::structured_task_group::cancel](reference/structured-task-group-class.md#cancel) and [concurrency::structured_task_group::is_canceling](reference/structured-task-group-class.md#is_canceling) methods. A child task can call these methods to cancel the parent task group or check for cancelation at any time. +The `task_group` class is thread-safe. Therefore you can add tasks to a `task_group` object from multiple threads and wait on or cancel a `task_group` object from multiple threads. The construction and destruction of a `structured_task_group` object must occur in the same lexical scope. In addition, all operations on a `structured_task_group` object must occur on the same thread. The exception to this rule is the [concurrency::structured_task_group::cancel](reference/structured-task-group-class.md#cancel) and [concurrency::structured_task_group::is_canceling](reference/structured-task-group-class.md#is_canceling) methods. A child task can call these methods to cancel the parent task group or check for cancellation at any time. You can run additional tasks on a `task_group` object after you call the [concurrency::task_group::wait](reference/task-group-class.md#wait) or [concurrency::task_group::run_and_wait](reference/task-group-class.md#run_and_wait) method. Conversely, if you run additional tasks on a `structured_task_group` object after you call the [concurrency::structured_task_group::wait](reference/structured-task-group-class.md#wait) or [concurrency::structured_task_group::run_and_wait](reference/structured-task-group-class.md#run_and_wait) methods, then the behavior is undefined. From f7f268b30935dfad6e6e46d34983b5acf3cbd4ba Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 6 Nov 2025 17:53:18 -0800 Subject: [PATCH 1453/1799] update perf info --- docs/overview/what-s-new-for-msvc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 5085a6beeef..b471afa8297 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -52,7 +52,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi - Visual Studio 2026 now includes CMake 4.1.1 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. - Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2026 version 18.0. -- Compiler backend runtime performance improvements. Up to 6% as measured on Unreal Engine's City Sample RenderThread. For more information, see [Why you should upgrade your C++ build tools](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#why-you-should-upgrade-your-c++-build-tools). +- Compiler backend runtime performance improvements. Compared to Visual Studio version 17.14, up to 6% improvement on Unreal Engine's City Sample RenderThread and up to +3% improvements on Unreal Engine's City Sample GameThread benchmark. For more information, see [Why you should upgrade your C++ build tools](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#why-you-should-upgrade-your-c++-build-tools). - The Visual Studio setup assistant can help you retarget your projects, so they build with the latest MSVC Build Tools. For more information, see [Retarget your projects with the setup assistant](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#retarget-your-projects-with-the-setup-assistant). **Code analysis enhancements** From 6794f9b7b4093ca7ed48edefa8d32c71c56e478f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 6 Nov 2025 18:52:43 -0800 Subject: [PATCH 1454/1799] add links --- docs/overview/what-s-new-for-msvc.md | 3 ++- docs/porting/visual-cpp-porting-and-upgrading-guide.md | 1 + 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index b471afa8297..f509fdb496b 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,7 +1,7 @@ --- title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 11/05/2025 +ms.date: 11/06/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new @@ -47,6 +47,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi - Copilot Chat is smarter with improved context for everyday tasks. Expect better results when searching your codebase and referencing specific lines in your code. - A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments, unit tests, and so on. - Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. GitHub Copilot includes other relevant files as context which reduces hallucinations while offering more relevant and accurate suggestions. +- Read about [New GitHub Copilot capabilities for C++ developers: Upgrade MSVC, improve build performance, and refactor C++ code](https://devblogs.microsoft.com/cppblog/new-github-copilot-capabilities-for-c-developers-upgrade-msvc-improve-build-performance-and-refactor-c-code/). **Build enhancements** diff --git a/docs/porting/visual-cpp-porting-and-upgrading-guide.md b/docs/porting/visual-cpp-porting-and-upgrading-guide.md index 87a10484b8c..1b8b32c3e46 100644 --- a/docs/porting/visual-cpp-porting-and-upgrading-guide.md +++ b/docs/porting/visual-cpp-porting-and-upgrading-guide.md @@ -59,6 +59,7 @@ ms.author: twhitney ### 🔧 Upgrade & modernize **Step-by-step guides and tools for upgrading** +- [⬆️ Upgrading C++ Projects to Visual Studio 2026](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/) - [⬆️ Upgrade projects from earlier versions](upgrading-projects-from-earlier-versions-of-visual-cpp.md) - [🛠️ IDE tools for upgrading C++ code](ide-tools-for-upgrading-code.md) - [🔄 Upgrade to Universal CRT](upgrade-your-code-to-the-universal-crt.md) From 1b69374a1541a51012a5d77b7ebd45686fd84ef7 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 7 Nov 2025 10:49:13 -0800 Subject: [PATCH 1455/1799] add notice --- .../build-an-opengl-es-application-on-android-and-ios.md | 7 ++++--- .../create-an-android-native-activity-app.md | 4 +++- .../cross-platform-mobile-development-examples.md | 3 +++ docs/cross-platform/general-android-prop-page.md | 4 +++- docs/cross-platform/import-an-xcode-project.md | 4 +++- .../install-and-configure-tools-to-build-using-ios.md | 4 +++- ...ll-visual-cpp-for-cross-platform-mobile-development.md | 3 +++ .../sync-changes-between-xcode-and-visual-studio.md | 4 +++- .../visual-cpp-for-cross-platform-mobile-development.md | 6 ++++-- .../embedded/download-and-install-the-embedded-tooling.md | 3 +++ docs/overview/overview-of-cpp-development.md | 2 +- docs/overview/supported-platforms-visual-cpp.md | 2 +- ...al-cpp-tools-and-features-in-visual-studio-editions.md | 7 ++++++- docs/porting/features-deprecated-in-visual-studio.md | 8 ++------ docs/porting/introduction-to-visual-cpp-for-unix-users.md | 4 +++- 15 files changed, 45 insertions(+), 20 deletions(-) diff --git a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md index 319b56d17d1..fb0ef5ab3f3 100644 --- a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md +++ b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md @@ -8,13 +8,14 @@ ms.custom: sfi-image-nochange # Build an OpenGL ES application on Android and iOS +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> OpenGL support is no longer available. It was last available in Visual Studio 17.3. + You can create Visual Studio solutions and projects for iOS apps and Android apps that share common code. This article guides you through a combined solution template. It creates both an iOS app, and an Android Native Activity app. The apps have C++ code in common that uses OpenGL ES to display the same animated rotating cube on each platform. OpenGL ES (OpenGL for Embedded Systems or GLES) is a 2D and 3D graphics API. It's supported on many mobile devices. ## Requirements -> [!IMPORTANT] -> OpenGL support is no longer available. It was last available in Visual Studio 17.3. - Here are the system requirements to create an OpenGL ES app for iOS and Android. If you haven't already, install the Mobile Development with C++ workload in the Visual Studio Installer. To get the OpenGL ES templates, and to build for iOS, include the optional C++ iOS development tools. To build for Android, install the C++ Android development tools and the required third-party tools: Android NDK, Apache Ant, and Google Android Emulator. For better emulator performance on Intel platforms, one option is to install the Intel Hardware Accelerated Execution Manager (HAXM). For detailed instructions, see [Install cross-platform mobile development with C++](../cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md). diff --git a/docs/cross-platform/create-an-android-native-activity-app.md b/docs/cross-platform/create-an-android-native-activity-app.md index d8741577f0b..b4b60604d3f 100644 --- a/docs/cross-platform/create-an-android-native-activity-app.md +++ b/docs/cross-platform/create-an-android-native-activity-app.md @@ -2,11 +2,13 @@ description: "Learn more about: Create an Android Native Activity App" title: "Create an Android Native Activity App" ms.date: "10/17/2019" -ms.assetid: 884014b1-5208-45ec-b0da-ad0070d2c24d ms.topic: how-to --- # Create an Android Native Activity App +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + When you install the cross-platform **Mobile development with C++** workload, Visual Studio can be used to create fully functional Android Native Activity apps. The Android Native Development Kit (NDK) is a toolset that allows you to implement the majority of your Android app using pure C/C++ code. Some Java JNI code acts as glue to allow your C/C++ code to interact with Android. The Android NDK introduced the ability to create Native Activity apps with Android API Level 9. Native Activity code is popular for creating gaming and graphic intensive apps that use Unreal Engine or OpenGL. This topic will guide you through creation of a simple Native Activity app that uses OpenGL. Additional topics walk through the developer lifecycle of editing, building, debugging and deploying Native Activity code. ## Requirements diff --git a/docs/cross-platform/cross-platform-mobile-development-examples.md b/docs/cross-platform/cross-platform-mobile-development-examples.md index 7eb5ea368ab..07d0b920e86 100644 --- a/docs/cross-platform/cross-platform-mobile-development-examples.md +++ b/docs/cross-platform/cross-platform-mobile-development-examples.md @@ -5,6 +5,9 @@ ms.date: 03/04/2024 --- # Cross-platform mobile development examples +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + Several of the templates installed by the **Mobile development with C++** workload generate complete examples that you can use to learn from. Additionally, here are some example applications that you can download and try out in Visual Studio. - [hello-jni Android Application Sample](https://github.com/android/ndk-samples/tree/master/hello-jni) diff --git a/docs/cross-platform/general-android-prop-page.md b/docs/cross-platform/general-android-prop-page.md index 3bbadb70d3a..24c73cf5937 100644 --- a/docs/cross-platform/general-android-prop-page.md +++ b/docs/cross-platform/general-android-prop-page.md @@ -2,7 +2,6 @@ description: "Learn more about: General Project Properties (Android C++)" title: "General Project Properties (Android C++)" ms.date: "10/23/2017" -ms.assetid: 65f4868b-b864-4989-a275-1e51869ef599 f1_keywords: - VC.Project.VCConfiguration.Android.OutputDirectory - VC.Project.VCConfiguration.Android.IntermediateDirectory @@ -17,6 +16,9 @@ f1_keywords: --- # General Project Properties (Android C++) +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + | Property | Description | Choices | |--|--|--| | Output Directory | Specifies a relative path to the output file directory; can include environment variables. | diff --git a/docs/cross-platform/import-an-xcode-project.md b/docs/cross-platform/import-an-xcode-project.md index b4bff9ac579..e58f2a47ec2 100644 --- a/docs/cross-platform/import-an-xcode-project.md +++ b/docs/cross-platform/import-an-xcode-project.md @@ -2,11 +2,13 @@ description: "Learn more about: Import an Xcode project" title: "Import an Xcode project" ms.date: "10/17/2019" -ms.assetid: aa4b8161-d98f-4a1a-9db3-520133bfc82f ms.topic: how-to --- # Import an Xcode project +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + The Visual Studio tools for cross-platform mobile development with C++ include support for moving your Xcode projects into Visual Studio, where you can create cross-platform libraries and share code with other projects. The Import from Xcode wizard simplifies the process of importing projects and splitting out the C++ code in your Xcode targets for use as a static library or shared code project. You can manage your iOS-specific code in Visual Studio and still use Xcode to do storyboards and builds. For information on how to easily move code back and forth between Visual Studio and Xcode, see [Sync changes between Xcode and Visual Studio](sync-changes-between-xcode-and-visual-studio.md). ## Use the Import From Xcode wizard diff --git a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md index 4e7f878b3a2..f0d0033c58f 100644 --- a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md +++ b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md @@ -2,7 +2,6 @@ description: "Learn more about: Install and configure tools to build using iOS" title: "Install and configure tools to build using iOS" ms.date: 12/18/2022 -ms.assetid: d0c311c9-9eb9-42c5-ba07-25604362cd28 ms.topic: install-set-up-deploy ms.custom: - intro-installation @@ -10,6 +9,9 @@ ms.custom: --- # Install and configure tools to build using iOS +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + You can use Visual Studio with the cross-platform **Mobile development with C++** tools to edit, debug, and deploy iOS code to the iOS Simulator or to an iOS device. But, because of licensing restrictions, the code must be built and run remotely on a Mac. To build and run iOS apps using Visual Studio, you need to set up and configure the remote agent, [vcremote](https://www.npmjs.com/package/vcremote), on your Mac. The vcremote remote agent handles build requests from Visual Studio and runs the app on an iOS device connected to the Mac, or in the iOS Simulator on the Mac. > [!NOTE] diff --git a/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md b/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md index 08239a91208..2255328d963 100644 --- a/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md +++ b/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md @@ -7,6 +7,9 @@ ms.topic: install-set-up-deploy --- # Install cross-platform mobile development with C++ +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + You can use C++ in Visual Studio to build Windows Desktop apps, Universal Windows Platform (UWP) apps, and Linux apps. And now, you can build C++ apps for Android and iOS. The **Mobile development with C++** workload is an installable set of components in Visual Studio. It includes cross-platform iOS, Android, and UWP Visual Studio templates. The workload installs the cross-platform tools and SDKs you need to get started quickly. You don't have to locate, download, and configure them yourself. You can use these tools in Visual Studio to easily create, edit, debug, and test your cross-platform projects. This article describes how to install the tools and third-party software required to develop cross-platform apps in C++ using Visual Studio. For an overview, see [Visual C++ cross-platform mobile](https://visualstudio.microsoft.com/vs/features/cplusplus-mdd/) diff --git a/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md b/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md index 834a4af4463..0c124d1afcc 100644 --- a/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md +++ b/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md @@ -2,10 +2,12 @@ description: "Learn more about: Sync changes between Xcode and Visual Studio" title: "Sync changes between Xcode and Visual Studio" ms.date: "10/17/2019" -ms.assetid: c71a4d7c-120e-4559-a114-3a99c4b860a9 --- # Sync changes between Xcode and Visual Studio +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + The mobile development with C++ components in Visual Studio include remote capabilities for syncing your work between your PC and your Mac. When your Visual Studio and Mac machines are paired, new options are available for iOS Application projects in Visual Studio that you can use to open your project in Xcode, move your code between Xcode and Visual Studio, and clean the temporary Xcode project directory. To use the Remote Machine options, your project must be an iOS Application project, and Visual Studio must be paired with your Mac. For prerequisites and instructions on how to pair a Mac, see [Install and configure tools to build using iOS](../cross-platform/install-and-configure-tools-to-build-using-ios.md). diff --git a/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md b/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md index 561a0d7c2d8..42e3870beb1 100644 --- a/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md +++ b/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md @@ -1,11 +1,13 @@ --- description: "Learn more about: Cross-platform mobile development with C++" title: "Cross-platform mobile development with C++" -ms.date: "11/14/2019" -ms.assetid: 0bb872d6-981b-4c96-9143-fcec5336bf0d +ms.date: 11/07/2025 --- # Cross-platform mobile development with C++ +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + You can build native C++ apps for iOS, Android, and Windows devices by using the cross-platform tools available in Visual Studio. **Mobile development with C++** is a workload available in the Visual Studio installer. It installs the SDKs and tools you need for cross-platform development of shared libraries and native apps. When it's installed, you can use C++ to create code that runs on iOS and Android devices and platforms, Windows, Windows Store, and Xbox. Writing code for multiple platforms is often frustrating. The primary development languages and tools for iOS, Android, and Windows are different on each platform. However, all platforms support writing code in C++. It's the common denominator that can enable reuse of core code across platforms. Native code written in C++ can be both more performant and resistant to reverse engineering. Code reuse can save both time and effort when creating apps for multiple platforms. diff --git a/docs/embedded/download-and-install-the-embedded-tooling.md b/docs/embedded/download-and-install-the-embedded-tooling.md index e16dae943ea..c59cbbdcc61 100644 --- a/docs/embedded/download-and-install-the-embedded-tooling.md +++ b/docs/embedded/download-and-install-the-embedded-tooling.md @@ -15,6 +15,9 @@ ms.topic: install-set-up-deploy In Visual Studio 2022 and later versions, you can use the Visual Studio IDE on Windows to edit and debug embedded projects. Use tools such as the [Peripheral View](./peripheral-view.md), [RTOS View](./rtos-view.md), and the [Serial Monitor](./serial-monitor.md) to help interact with and debug your embedded projects. +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + To use the embedded development tools in Visual Studio, you must install the required **Linux and embedded development with C++** workload. ## To install the Linux and embedded development with C++ workload diff --git a/docs/overview/overview-of-cpp-development.md b/docs/overview/overview-of-cpp-development.md index ca4cb394b97..ac46ec8f83c 100644 --- a/docs/overview/overview-of-cpp-development.md +++ b/docs/overview/overview-of-cpp-development.md @@ -1,6 +1,6 @@ --- title: "Overview of C++ development in Visual Studio" -description: "The Visual Studio IDE supports C++ development on Windows, Linux, Android and iOS with a code editor, debugger, test frameworks, static analyzers, and other programming tools." +description: "The Visual Studio IDE supports C++ development on Windows and Linux with a code editor, debugger, test frameworks, static analyzers, and other programming tools." ms.date: 12/02/2019 helpviewer_keywords: ["Visual C++, development tools"] author: "tylermsft" diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 2b52a32f94e..afcfd94885f 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -44,7 +44,7 @@ Support for targeting 32-bit ARM was permanently removed in VS 2026 18.0. d Visual Studio 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2. Visual Studio 2026 and later target Windows 10 or later and Windows Server 2016 or later. -e You can install the **Mobile development with C++** workload in the installer for Visual Studio 2017 and later. In Visual Studio 2015 setup, choose the optional **Visual C++ for Cross Platform Mobile Development** component to target iOS or Android platforms. For instructions, see [Install Visual C++ for Cross-Platform Mobile Development](/visualstudio/cross-platform/install-visual-cpp-for-cross-platform-mobile-development). To build iOS code, you must have a Mac computer and meet other requirements. For a list of prerequisites and installation instructions, see [Install And Configure Tools to Build using iOS](/visualstudio/cross-platform/install-and-configure-tools-to-build-using-ios). You can build x86 or ARM code to match the target hardware. Use x86 configurations to build for some Android devices. Use ARM configurations to build for iOS devices and most Android devices. +e You can install the **Mobile development with C++** workload in the installer for Visual Studio 2017 and later. In Visual Studio 2015 setup, choose the optional **Visual C++ for Cross Platform Mobile Development** component to target iOS or Android platforms. For instructions, see [Install Visual C++ for Cross-Platform Mobile Development](/visualstudio/cross-platform/install-visual-cpp-for-cross-platform-mobile-development). To build iOS code, you must have a Mac computer and meet other requirements. For a list of prerequisites and installation instructions, see [Install And Configure Tools to Build using iOS](/visualstudio/cross-platform/install-and-configure-tools-to-build-using-ios). You can build x86 or ARM code to match the target hardware. Use x86 configurations to build for some Android devices. Use ARM configurations to build for iOS devices and most Android devices. **IMPORTANT**: Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. f You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. diff --git a/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md b/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md index f05857da1e0..dcdea408105 100644 --- a/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md +++ b/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md @@ -3,7 +3,6 @@ description: "Learn more about: C++ Tools and Features in Visual Studio Editions title: "C++ Tools and Features in Visual Studio Editions" ms.date: 10/27/2021 helpviewer_keywords: ["tools and platforms [C++]"] -ms.assetid: 3d88607b-9cc4-490a-8d4c-31ee7610a26f --- # C++ Tools and Features in Visual Studio Editions @@ -29,6 +28,9 @@ The following tables show C++ features that are available in Visual Studio 2017. - Android - iOS +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + ::: moniker-end ::: moniker range="<=msvc-150" @@ -257,6 +259,9 @@ Optional Components: ### Mobile development with C++ +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + Included: - C++ core features diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index 21e2344e522..c4054812aae 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -42,10 +42,6 @@ To build applications using the latest C++ tools, your target platform must be * These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. -### Support for Mobile development with C++ workload +### Support for Mobile development with C++ and Embedded and IoT tools -The Mobile development with C++ workload for iOS and Android targeting in the Visual Studio installer is no longer being supported and will be removed in a future Visual Studio update. This includes new projects, building, and debugging. - -### Support for Embedded and IoT tools - -The Embedded and IoT tools component in the Visual Studio installer is no longer being supported and will be removed in a future Visual Studio update. This includes the RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import. +Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. \ No newline at end of file diff --git a/docs/porting/introduction-to-visual-cpp-for-unix-users.md b/docs/porting/introduction-to-visual-cpp-for-unix-users.md index 4aa29e40e1a..84dd584cdcb 100644 --- a/docs/porting/introduction-to-visual-cpp-for-unix-users.md +++ b/docs/porting/introduction-to-visual-cpp-for-unix-users.md @@ -3,13 +3,15 @@ description: "Learn more about: Introduction to Microsoft C++ for UNIX Users" title: "Introduction to Microsoft C++ for UNIX Users" ms.date: 06/22/2021 helpviewer_keywords: ["UNIX [C++]"] -ms.assetid: 36108b31-e7fa-49a8-a1f7-7077fcbec873 ms.topic: concept-article --- # Introduction to Microsoft C++ for UNIX Users This topic provides information for users of all flavors of UNIX who are new to Visual Studio and want to become productive with C++ either from the command line or by using Visual Studio. You can use Visual Studio with the Microsoft C++ compiler to target Windows. You can also use the Visual Studio IDE with GCC or Clang in UNIX environments such as remote Linux machines, MinGW-w64, and Windows Subsystem for Linux. To use C++ in Visual Studio, the **Desktop Development with C++** workload must be installed. Open the Visual Studio Installer to install the workload or add or remove optional components. Also install the **Linux Development with C++** workload if you'll be targeting a remote Linux machine. For Android or iOS development, install the **Mobile Development with C++** workload. +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. + ## Getting started on the command line You can use the Microsoft C++ compiler from the command line in a similar way that you would use a UNIX command-line environment. You compile from the command prompt by using the command-line C and C++ compiler (CL.EXE), linker (LINK.EXE), and other tools, including NMAKE.EXE, the Microsoft version of the UNIX make utility. From 5a7969ba4afab5937db0c1bb4410034571dffe36 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 7 Nov 2025 14:28:41 -0800 Subject: [PATCH 1456/1799] optimize wording --- .../build-an-opengl-es-application-on-android-and-ios.md | 2 +- docs/cross-platform/create-an-android-native-activity-app.md | 2 +- .../cross-platform-mobile-development-examples.md | 2 +- docs/cross-platform/general-android-prop-page.md | 2 +- docs/cross-platform/import-an-xcode-project.md | 2 +- .../install-and-configure-tools-to-build-using-ios.md | 2 +- ...nstall-visual-cpp-for-cross-platform-mobile-development.md | 2 +- .../sync-changes-between-xcode-and-visual-studio.md | 2 +- .../visual-cpp-for-cross-platform-mobile-development.md | 2 +- docs/embedded/download-and-install-the-embedded-tooling.md | 2 +- ...visual-cpp-tools-and-features-in-visual-studio-editions.md | 4 ++-- docs/porting/introduction-to-visual-cpp-for-unix-users.md | 2 +- 12 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md index fb0ef5ab3f3..8f2c0764404 100644 --- a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md +++ b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md @@ -9,7 +9,7 @@ ms.custom: sfi-image-nochange # Build an OpenGL ES application on Android and iOS > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. > OpenGL support is no longer available. It was last available in Visual Studio 17.3. You can create Visual Studio solutions and projects for iOS apps and Android apps that share common code. This article guides you through a combined solution template. It creates both an iOS app, and an Android Native Activity app. The apps have C++ code in common that uses OpenGL ES to display the same animated rotating cube on each platform. OpenGL ES (OpenGL for Embedded Systems or GLES) is a 2D and 3D graphics API. It's supported on many mobile devices. diff --git a/docs/cross-platform/create-an-android-native-activity-app.md b/docs/cross-platform/create-an-android-native-activity-app.md index b4b60604d3f..095a2a7735a 100644 --- a/docs/cross-platform/create-an-android-native-activity-app.md +++ b/docs/cross-platform/create-an-android-native-activity-app.md @@ -7,7 +7,7 @@ ms.topic: how-to # Create an Android Native Activity App > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. When you install the cross-platform **Mobile development with C++** workload, Visual Studio can be used to create fully functional Android Native Activity apps. The Android Native Development Kit (NDK) is a toolset that allows you to implement the majority of your Android app using pure C/C++ code. Some Java JNI code acts as glue to allow your C/C++ code to interact with Android. The Android NDK introduced the ability to create Native Activity apps with Android API Level 9. Native Activity code is popular for creating gaming and graphic intensive apps that use Unreal Engine or OpenGL. This topic will guide you through creation of a simple Native Activity app that uses OpenGL. Additional topics walk through the developer lifecycle of editing, building, debugging and deploying Native Activity code. diff --git a/docs/cross-platform/cross-platform-mobile-development-examples.md b/docs/cross-platform/cross-platform-mobile-development-examples.md index 07d0b920e86..4a53fea00e5 100644 --- a/docs/cross-platform/cross-platform-mobile-development-examples.md +++ b/docs/cross-platform/cross-platform-mobile-development-examples.md @@ -6,7 +6,7 @@ ms.date: 03/04/2024 # Cross-platform mobile development examples > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. Several of the templates installed by the **Mobile development with C++** workload generate complete examples that you can use to learn from. Additionally, here are some example applications that you can download and try out in Visual Studio. diff --git a/docs/cross-platform/general-android-prop-page.md b/docs/cross-platform/general-android-prop-page.md index 24c73cf5937..df6f9dd5a42 100644 --- a/docs/cross-platform/general-android-prop-page.md +++ b/docs/cross-platform/general-android-prop-page.md @@ -17,7 +17,7 @@ f1_keywords: # General Project Properties (Android C++) > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. | Property | Description | Choices | |--|--|--| diff --git a/docs/cross-platform/import-an-xcode-project.md b/docs/cross-platform/import-an-xcode-project.md index e58f2a47ec2..1ea0c5c2e8b 100644 --- a/docs/cross-platform/import-an-xcode-project.md +++ b/docs/cross-platform/import-an-xcode-project.md @@ -7,7 +7,7 @@ ms.topic: how-to # Import an Xcode project > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. The Visual Studio tools for cross-platform mobile development with C++ include support for moving your Xcode projects into Visual Studio, where you can create cross-platform libraries and share code with other projects. The Import from Xcode wizard simplifies the process of importing projects and splitting out the C++ code in your Xcode targets for use as a static library or shared code project. You can manage your iOS-specific code in Visual Studio and still use Xcode to do storyboards and builds. For information on how to easily move code back and forth between Visual Studio and Xcode, see [Sync changes between Xcode and Visual Studio](sync-changes-between-xcode-and-visual-studio.md). diff --git a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md index f0d0033c58f..b0adf51b595 100644 --- a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md +++ b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md @@ -10,7 +10,7 @@ ms.custom: # Install and configure tools to build using iOS > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. You can use Visual Studio with the cross-platform **Mobile development with C++** tools to edit, debug, and deploy iOS code to the iOS Simulator or to an iOS device. But, because of licensing restrictions, the code must be built and run remotely on a Mac. To build and run iOS apps using Visual Studio, you need to set up and configure the remote agent, [vcremote](https://www.npmjs.com/package/vcremote), on your Mac. The vcremote remote agent handles build requests from Visual Studio and runs the app on an iOS device connected to the Mac, or in the iOS Simulator on the Mac. diff --git a/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md b/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md index 2255328d963..abd451551b8 100644 --- a/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md +++ b/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md @@ -8,7 +8,7 @@ ms.topic: install-set-up-deploy # Install cross-platform mobile development with C++ > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. You can use C++ in Visual Studio to build Windows Desktop apps, Universal Windows Platform (UWP) apps, and Linux apps. And now, you can build C++ apps for Android and iOS. The **Mobile development with C++** workload is an installable set of components in Visual Studio. It includes cross-platform iOS, Android, and UWP Visual Studio templates. The workload installs the cross-platform tools and SDKs you need to get started quickly. You don't have to locate, download, and configure them yourself. You can use these tools in Visual Studio to easily create, edit, debug, and test your cross-platform projects. diff --git a/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md b/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md index 0c124d1afcc..415ec583ea6 100644 --- a/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md +++ b/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md @@ -6,7 +6,7 @@ ms.date: "10/17/2019" # Sync changes between Xcode and Visual Studio > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. The mobile development with C++ components in Visual Studio include remote capabilities for syncing your work between your PC and your Mac. When your Visual Studio and Mac machines are paired, new options are available for iOS Application projects in Visual Studio that you can use to open your project in Xcode, move your code between Xcode and Visual Studio, and clean the temporary Xcode project directory. diff --git a/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md b/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md index 42e3870beb1..997d8893371 100644 --- a/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md +++ b/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md @@ -6,7 +6,7 @@ ms.date: 11/07/2025 # Cross-platform mobile development with C++ > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. You can build native C++ apps for iOS, Android, and Windows devices by using the cross-platform tools available in Visual Studio. **Mobile development with C++** is a workload available in the Visual Studio installer. It installs the SDKs and tools you need for cross-platform development of shared libraries and native apps. When it's installed, you can use C++ to create code that runs on iOS and Android devices and platforms, Windows, Windows Store, and Xbox. diff --git a/docs/embedded/download-and-install-the-embedded-tooling.md b/docs/embedded/download-and-install-the-embedded-tooling.md index c59cbbdcc61..3e7d613e7ae 100644 --- a/docs/embedded/download-and-install-the-embedded-tooling.md +++ b/docs/embedded/download-and-install-the-embedded-tooling.md @@ -16,7 +16,7 @@ ms.topic: install-set-up-deploy In Visual Studio 2022 and later versions, you can use the Visual Studio IDE on Windows to edit and debug embedded projects. Use tools such as the [Peripheral View](./peripheral-view.md), [RTOS View](./rtos-view.md), and the [Serial Monitor](./serial-monitor.md) to help interact with and debug your embedded projects. > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. To use the embedded development tools in Visual Studio, you must install the required **Linux and embedded development with C++** workload. diff --git a/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md b/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md index dcdea408105..05aadb31dd0 100644 --- a/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md +++ b/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md @@ -29,7 +29,7 @@ The following tables show C++ features that are available in Visual Studio 2017. - iOS > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. ::: moniker-end @@ -260,7 +260,7 @@ Optional Components: ### Mobile development with C++ > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. Included: diff --git a/docs/porting/introduction-to-visual-cpp-for-unix-users.md b/docs/porting/introduction-to-visual-cpp-for-unix-users.md index 84dd584cdcb..e70d60b5806 100644 --- a/docs/porting/introduction-to-visual-cpp-for-unix-users.md +++ b/docs/porting/introduction-to-visual-cpp-for-unix-users.md @@ -10,7 +10,7 @@ ms.topic: concept-article This topic provides information for users of all flavors of UNIX who are new to Visual Studio and want to become productive with C++ either from the command line or by using Visual Studio. You can use Visual Studio with the Microsoft C++ compiler to target Windows. You can also use the Visual Studio IDE with GCC or Clang in UNIX environments such as remote Linux machines, MinGW-w64, and Windows Subsystem for Linux. To use C++ in Visual Studio, the **Desktop Development with C++** workload must be installed. Open the Visual Studio Installer to install the workload or add or remove optional components. Also install the **Linux Development with C++** workload if you'll be targeting a remote Linux machine. For Android or iOS development, install the **Mobile Development with C++** workload. > [!IMPORTANT] -> Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. ## Getting started on the command line From 94ee44ecdb07de20dddc16735b6efee30ef782e1 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 7 Nov 2025 14:38:39 -0800 Subject: [PATCH 1457/1799] wording --- docs/overview/what-s-new-for-msvc.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index f509fdb496b..50ab77113c1 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,7 +1,7 @@ --- title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 11/06/2025 +ms.date: 11/07/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new @@ -85,7 +85,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi The MSVC compiler switch [`/await`](/cpp/build/reference/await-enable-coroutine-support) is being deprecated and will be removed in a future release. This switch enabled an early draft implementation of C++ coroutines using the `` header. Developers should transition to standard C++ coroutines by using the `` header available in C++20 and later. For C++14/17 projects, use `/await:strict` (which isn't being deprecated) to access the standard `` header without enabling other C++20 features. -The mobile development and embedded and IoT development tools are no longer supported. The mobile development with C++ workload and Android NDK component in the Visual Studio installer are no longer supported and will be removed in a future Visual Studio update. This impacts tooling support for iOS and Android development, including new projects, building, and debugging. +The Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. This impacts tooling support for iOS and Android development, including new projects, building, and debugging. **The following features have been removed and are no longer available:** From f57550697cfe236359891691ee833c1ee71fba49 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 7 Nov 2025 14:50:10 -0800 Subject: [PATCH 1458/1799] add links to stl cpp23 and 26 work --- docs/overview/visual-cpp-language-conformance.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 301128b5ac5..a80c29ceb30 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ language conformance" description: "Microsoft C and C++ conformance updates by Visual Studio version." -ms.date: 11/04/2025 +ms.date: 11/07/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- @@ -222,7 +222,9 @@ For details on conformance improvements, see [C++ conformance improvements in Vi ## C++ Standard library features -A more detailed listing of Standard Library features and bug fixes by product version is available on the [GitHub Microsoft STL wiki Changelog](https://github.com/microsoft/STL/wiki/Changelog) page. +A more detailed listing of Standard Library features and bug fixes by product version is available on the [GitHub Microsoft STL wiki Changelog](https://github.com/microsoft/STL/wiki/Changelog) page.\ +For the latest details on ongoing C++23 Standard Library conformance work, see [STL C++23 Features](https://github.com/orgs/microsoft/projects/1142/views/2).\ +For the latest details on ongoing C++26 Standard Library conformance work, see [STL C++26 Features](https://github.com/orgs/microsoft/projects/1142/views/2). | Feature | Supported | |--|--| From afc38e63de34c8c0ea5e83555a20a79f6ea529e1 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 7 Nov 2025 15:01:47 -0800 Subject: [PATCH 1459/1799] typo --- docs/overview/visual-cpp-language-conformance.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index a80c29ceb30..de57a8dc128 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -222,9 +222,11 @@ For details on conformance improvements, see [C++ conformance improvements in Vi ## C++ Standard library features -A more detailed listing of Standard Library features and bug fixes by product version is available on the [GitHub Microsoft STL wiki Changelog](https://github.com/microsoft/STL/wiki/Changelog) page.\ -For the latest details on ongoing C++23 Standard Library conformance work, see [STL C++23 Features](https://github.com/orgs/microsoft/projects/1142/views/2).\ -For the latest details on ongoing C++26 Standard Library conformance work, see [STL C++26 Features](https://github.com/orgs/microsoft/projects/1142/views/2). +A more detailed listing of Standard Library features and bug fixes by product version is available on the [GitHub Microsoft STL wiki Changelog](https://github.com/microsoft/STL/wiki/Changelog) page. + +For the latest details about ongoing conformance work, see: +- [STL C++23 Features](https://github.com/orgs/microsoft/projects/1142/views/2). +- [STL C++26 Features](https://github.com/orgs/microsoft/projects/1143/views/2). | Feature | Supported | |--|--| From 8e911ff21c335e2a0138d1dd2082ef09d30bf057 Mon Sep 17 00:00:00 2001 From: Mahmoud Saleh <12202790+MahmoudGSaleh@users.noreply.github.com> Date: Fri, 7 Nov 2025 16:10:35 -0800 Subject: [PATCH 1460/1799] Address feedback review Feedback review --- docs/windows/latest-supported-vc-redist.md | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 67d25d2f0f0..5465d47255a 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -36,33 +36,33 @@ To find the download you need, choose your version of Visual Studio from the tab Redistribution is permitted only for licensed Visual Studio users, as described in the [Visual Studio license terms](https://visualstudio.microsoft.com/license-terms/). For details on redistributing Visual C++ files, see [Redistributing Visual C++ Files](redistributing-visual-cpp-files.md). -A Visual C++ Redistributable installs Microsoft C and C++ runtime libraries. Many applications built using Microsoft C++ (MSVC) Build Tools require these libraries. If your app is built using those libraries, a Microsoft Visual C++ Redistributable package at least as recent as the build tools used to build your app must be installed on the target system along with the app. The Redistributable package architecture must match your app's target architecture (you can't install an ARM64 redistributable on an x86 system, or an x64 redistributable on an x86 system, for example). We recommend you use the latest Redistributable available for your version of Visual Studio. +A Visual C++ Redistributable installs Microsoft C and C++ runtime libraries. Many applications built using Microsoft C++ (MSVC) Build Tools require these libraries. If your app is built using those libraries, a Microsoft Visual C++ Redistributable package at least as recent as the build tools used to build your app must be installed on the target system along with the app. The Redistributable package architecture must match your app's target architecture (you can't install an ARM64 Redistributable on an x86 system, or an x64 Redistributable on an x86 system, for example). We recommend you use the latest Redistributable available for your version of Visual Studio. ## Visual C++ Redistributable v14 -This table lists the latest supported Microsoft Visual C++ Redistributable v14 packages. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created using MSVC C and C++ build tools available in Visual Studio 2017, 2019, 2022, or 2026. +This table lists the latest supported Microsoft Visual C++ Redistributable v14 packages. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created using MSVC C and C++ Build Tools available in Visual Studio 2017, 2019, 2022, or 2026. -Unlike older versions of Visual Studio that have infrequent redist updates, the version number isn't listed in the following table for Visual C++ redistributable v14 because the redist is updated frequently. To find the version number of the latest redist, download the redist you're interested in using one of the following links. Then, look at its properties using Windows File Explorer. In the **Details** pane, the **File version** contains the version of the redist. +Unlike older versions of Visual Studio that have infrequent redistributable updates, the version number isn't listed in the following table for the Visual C++ v14 Redistributable because it is updated frequently. To find the version number of the latest redistributable, download the one you're interested in using one of the following links. Then, look at its properties using Windows File Explorer. In the **Details** pane, the **File version** contains the version of the redistributable. ### Latest supported redistributable version | Architecture | Link | Notes | |--|--|--| -| ARM64 | [https://aka.ms/vs/18/release/vc_redist.arm64.exe](https://aka.ms/vs/18/release/vc_redist.arm64.exe) | Permalink for latest supported ARM64 version | -| X86 | [https://aka.ms/vs/18/release/vc_redist.x86.exe](https://aka.ms/vs/18/release/vc_redist.x86.exe) | Permalink for latest supported x86 version | -| X64 | [https://aka.ms/vs/18/release/vc_redist.x64.exe](https://aka.ms/vs/18/release/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | +| ARM64 | [https://aka.ms/vc14/release/vc_redist.arm64.exe](https://aka.ms/vc14/release/vc_redist.arm64.exe) | Permalink for latest supported ARM64 version | +| X86 | [https://aka.ms/vc14/release/vc_redist.x86.exe](https://aka.ms/vc14/release/vc_redist.x86.exe) | Permalink for latest supported x86 version | +| X64 | [https://aka.ms/vc14/release/vc_redist.x64.exe](https://aka.ms/vc14/release/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | Download other versions, including long term servicing release channel (LTSC) versions, from [my.visualstudio.com](https://my.visualstudio.com/). ### Notes -- The Visual C++ Redistributable v14 doesn't have separate packages for different languages. License terms for different languages are available at https://aka.ms/VCRedistLicense. - Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Log in using a Visual Studio Subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or, create a free account by choosing the [**No account? Create one!**](https://my.visualstudio.com/). -- Visual Studio versions since Visual Studio 2017 share the same Redistributable files. Any apps built by MSVC build tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ Redistributable v14. However, the version of the Microsoft Visual C++ Redistributable installed on the machine must be the same or higher than the version of the Visual C++ toolset used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). -- The latest version of the Visual C++ Redistributable v14 distributed with Visual Studio 2026 only supports the following operating systems: +- The Visual C++ v14 Redistributable doesn't have separate packages for different languages. License terms for different languages are available at [https://aka.ms/VCRedistLicense](https://aka.ms/VCRedistLicense). +- Visual Studio 2017 and later share the same Redistributable files. Any apps built by Microsoft C++ (MSVC) Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. However, the version of the redistributable installed on the machine must be the same or higher than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). +- The latest version of the Visual C++ v14 Redistributable included with Visual Studio 2026 only supports the following operating systems: * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 -- Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which they first ship, support for Visual C++ Redistributable 2015 (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version. +- Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version. - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions @@ -146,7 +146,6 @@ Download Redistributable files for other languages and architectures from: - [Visual Studio 2026 release notes](/visualstudio/releases/2026/release-notes) - [What's new for C++ in Visual Studio](../overview//what-s-new-for-visual-cpp-in-visual-studio.md) - [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md) -- [MSVC Backend Updates since Visual Studio 2022 version 17.3](https://devblogs.microsoft.com/cppblog/msvc-backend-updates-since-visual-studio-2022-version-17-3/) - [Standard Template Library (STL) changelog](https://github.com/microsoft/STL/wiki/Changelog) - [A year of C++ improvements](https://devblogs.microsoft.com/cppblog/a-year-of-cpp-improvements-in-visual-studio-vs-code-and-vcpkg) - [Microsoft Visual C++ compiler versioning](../overview/compiler-versions.md) From 865289df3a20fabb594c9d939e510c1cbea14fdf Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 10 Nov 2025 13:45:42 -0800 Subject: [PATCH 1461/1799] incorp feedback --- docs/overview/visual-cpp-language-conformance.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index de57a8dc128..221c9e92868 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ language conformance" description: "Microsoft C and C++ conformance updates by Visual Studio version." -ms.date: 11/07/2025 +ms.date: 11/10/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- @@ -174,8 +174,8 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P1073R3 Immediate functions`](https://wg21.link/P1073R3) | VS 2019 16.10 [20](#note_20) | |  [`P1143R2 constinit`](https://wg21.link/P1143R2) | VS 2019 16.10 [20](#note_20) | |  [`P1353R0 Missing feature-test macros`](https://wg21.link/P1353R0) | VS 2019 16.10 [20](#note_20) | -|  [`P0735R1 Interaction of memory_order_consume with release sequences`](https://wg21.link/P0735R1) | N/A | -|  [`P1236R1 Signed integers are two's complement`](https://wg21.link/P1236R1) | N/A | +|  [`P0735R1 Interaction of memory_order_consume with release sequences`](https://wg21.link/P0735R1) | VS 2022 v17.14 | +|  [`P1236R1 Signed integers are two's complement`](https://wg21.link/P1236R1) | VS 2022 v17.14 | | **C++23 Core language features** | **Supported** | |  [`P0330R8 Literal Suffix for (signed) size_t`](https://wg21.link/p0330r8) | VS 2022 17.13 [23](#note_23) | |  [`P0847R7 Deducing this`](https://wg21.link/p0847r7) | VS 2022 17.13 [23](#note_23) | @@ -207,13 +207,13 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P2314R4 Character sets and encodings`](https://wg21.link/p2314r4) | no | |  [`P2316R2 Consistent character literal encoding`](https://wg21.link/p2316r2) | VS 2022 17.0 [23](#note_23) | |  [`P2324R2 Labels at the end of compound statements (C compatibility)`](https://wg21.link/p2324r2) | no | -|  [`P2327R1 De-deprecating volatile compound operations`](https://wg21.link/p2327r1) | N/A | +|  [`P2327R1 De-deprecating volatile compound operations`](https://wg21.link/p2327r1) | VS 2022 v17.14 | |  [`P2334R1 preprocessing directives elifdef and elifndef`](https://wg21.link/p2334r1) | VS 2022 17.10 [23](#note_23) | |  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2362R3 Remove non-encodable wide character literals and multicharacter wide character literals`](https://wg21.link/p2362r3) | no | |  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2448R2 Relaxing some constexpr restrictions`](https://wg21.link/p2448r2) | no | -|  [`P2460R2 Relax requirements on wchar_t to match existing practices`](https://wg21.link/p2460r2) | N/A | +|  [`P2460R2 Relax requirements on wchar_t to match existing practices`](https://wg21.link/p2460r2) | VS 2022 v17.14 | |  [`P2468R2 The Equality Operator You Are Looking For`](https://wg21.link/p2468r2) | VS 2022 17.6 [23](#note_23) | |  [`P2493R0 Missing feature test macros for C++20 core papers`](https://wg21.link/p2493r0) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2513R4 char8_t Compatibility and Portability Fix`](https://wg21.link/p2513r4) | VS 2022 17.4 [DR](#note_DR) | @@ -442,7 +442,7 @@ For the latest details about ongoing conformance work, see: |  [`P1208R6 `](https://wg21.link/P1208R6) | VS 2019 16.10 [20](#note_20) | |  [`P1502R1 Standard Library Header Units`](https://wg21.link/P1502R1) | VS 2019 16.10 [20](#note_20) | |  [`P1614R2 Adding Spaceship <=> To The Library`](https://wg21.link/P1614R2) | VS 2019 16.10 [20](#note_20) | -|  [`P1285R0 Improving Completeness Requirements For Type Traits`](https://wg21.link/P1285R0) | N/A | +|  [`P1285R0 Improving Completeness Requirements For Type Traits`](https://wg21.link/P1285R0) | VS 2022 v17.14 | | **C++20 Standard library features (Defect reports)** | **Supported** | |  [`P2325R3 Views Should Not Be Required To Be Default Constructible`](https://wg21.link/P2325r3) | VS 2022 17.0 [20abi](#note_20abi) | |  [`P2328R1 join_view should join all views of ranges`](https://wg21.link/P2328R1) | VS 2022 17.0 [20abi](#note_20abi) | From b16c31e9305def473565ac01478a1a87b2bdb066 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 10 Nov 2025 14:58:28 -0800 Subject: [PATCH 1462/1799] edits --- docs/overview/what-s-new-for-msvc.md | 55 ++++++++++++++-------------- 1 file changed, 28 insertions(+), 27 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 50ab77113c1..5a347d2c568 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,7 +1,7 @@ --- title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 11/07/2025 +ms.date: 11/10/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new @@ -11,13 +11,13 @@ ms.custom: intro-whats-new Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and other build tools. -- For more information on what's new in all of Visual Studio, see [What's new in Visual Studio](/visualstudio/ide/whats-new-visual-studio). +- For more information about what's new in all of Visual Studio, see [What's new in Visual Studio](/visualstudio/ide/whats-new-visual-studio). ## What's new for MSVC Build Tools version 14.50 * Introduced in Visual Studio 2026 version 18.0 released November 2025. -Visual Studio 2026 version 18.0 ships with the v145 platform toolset for MSBuild C++ projects and Microsoft C++ (MSVC) Build Tools version 14.50, which offers the best conformance, build performance, and runtime performance story yet. To access to all the new language features, build with `/std:c++latest`, or use `/std:c++23preview` if you want to be restricted to features up to C++23. +Visual Studio 2026 version 18.0 ships with the v145 platform toolset for MSBuild C++ projects and Microsoft C++ (MSVC) Build Tools version 14.50, which offers the best conformance, build performance, and runtime performance story yet. To access all the new language features, build with `/std:c++latest`. Or, if you want to be restricted to features up to C++23, use `/std:c++23preview`. MSVC Build Tools version 14.50 preserves binary compatibility with code built with MSVC tools shipped in Visual Studio 2015 or later. For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](/cpp/porting/binary-compat-2015-2017). @@ -28,51 +28,52 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi | C++ language updates | [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) | | C++ language conformance improvements | [C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools](msvc-conformance-improvements.md) | -**A quick highlight of some of the new features in MSVC Build Tools version 14.50 and Visual Studio 2026 version 18.0:** +Here's a quick highlight of some of the new features in MSVC Build Tools version 14.50 and Visual Studio 2026 version 18.0: -**C++ language enhancements** +### C++ language enhancements - C++20 is the default for new Console App, Windows Desktop Application, Dynamic-Link Library, and Static Library C++ projects. -- C++23 preprocessing directive `#warning` allows you to generate a diagnostic message without stopping translation like `#error` does. For more information, see [`#warning` directive](/cpp/preprocessor/hash-warning-directive-c-cpp). -- Easily set debugger command line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without installing any other workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio&preserve-view=true). +- C++23 preprocessing directive `#warning` allows you to generate a diagnostic message without stopping translation as `#error` does. For more information, see [`#warning` directive](/cpp/preprocessor/hash-warning-directive-c-cpp). +- Easily set debugger command-line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without installing any other workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio&preserve-view=true). -**Standard Library enhancements** +### Standard Library enhancements -- `` addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) added a multiline option to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450). +- Enhanced `` reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) added a multiline option to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450). - Added and improved vectorized implementations of many types and functions. -**GitHub Copilot enhancements** +### GitHub Copilot enhancements - Copilot Chat allows you to use natural language to get answers to questions (Ask mode) or even implement changes for you automatically (Agent Mode). - Copilot Chat is smarter with improved context for everyday tasks. Expect better results when searching your codebase and referencing specific lines in your code. -- A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments, unit tests, and so on. +- A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments, generate unit tests, and more. - Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. GitHub Copilot includes other relevant files as context which reduces hallucinations while offering more relevant and accurate suggestions. -- Read about [New GitHub Copilot capabilities for C++ developers: Upgrade MSVC, improve build performance, and refactor C++ code](https://devblogs.microsoft.com/cppblog/new-github-copilot-capabilities-for-c-developers-upgrade-msvc-improve-build-performance-and-refactor-c-code/). +- For more information, see [New GitHub Copilot capabilities for C++ developers: Upgrade MSVC, improve build performance, and refactor C++ code](https://devblogs.microsoft.com/cppblog/new-github-copilot-capabilities-for-c-developers-upgrade-msvc-improve-build-performance-and-refactor-c-code/). -**Build enhancements** +### Build enhancements -- Visual Studio 2026 now includes CMake 4.1.1 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. +- Visual Studio 2026 now includes CMake 4.1.1 by default. CMake also includes a Visual Studio 2026 generator and supports modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. - Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2026 version 18.0. -- Compiler backend runtime performance improvements. Compared to Visual Studio version 17.14, up to 6% improvement on Unreal Engine's City Sample RenderThread and up to +3% improvements on Unreal Engine's City Sample GameThread benchmark. For more information, see [Why you should upgrade your C++ build tools](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#why-you-should-upgrade-your-c++-build-tools). -- The Visual Studio setup assistant can help you retarget your projects, so they build with the latest MSVC Build Tools. For more information, see [Retarget your projects with the setup assistant](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#retarget-your-projects-with-the-setup-assistant). +- Compiler backend runtime performance improvements. Compared to Visual Studio version 17.14, there's up to a 6% improvement on Unreal Engine's City Sample RenderThread and up to +3% improvements on Unreal Engine's City Sample GameThread benchmark. For more information, see [Why you should upgrade your C++ build tools](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#why-you-should-upgrade-your-c++-build-tools). +- The Visual Studio setup assistant can help you retarget your projects to build with the latest MSVC Build Tools. For more information, see [Retarget your projects with the setup assistant](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#retarget-your-projects-with-the-setup-assistant). -**Code analysis enhancements** +### Code analysis enhancements -- Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows. - - Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. +- Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows: + - Code analysis has new configuration options. You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. + - You can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). - AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with [AddressSanitizer](/cpp/sanitizers/asan), which allows you to identify hard-to-find memory safety issues with zero false positives at runtime and increase memory safety. Now you can use AddressSanitizer to target ARM64. This feature is in preview. -**Productivity enhancements** +### Productivity enhancements -- Generate preprocessed output for any C++ file. In Visual Studio, right-click a C++ file to instantly generate its preprocessed output, making it easy to debug macros and includes, and see errors immediately. ![Screenshot showing the right-click context menu for a C++ file with the Preprocess option highlighted.](./media/cpp-preprocess-menu-entry.png) -- Inline post-return values: The Visual Studio debugger now shows the actual return values of functions. This provides real-time visibility into function behavior without stepping into code or setting up watches, making it faster to catch logic issues or unexpected results. ![Screenshot showing inline post-return values displayed in the debugger next to function call."](./media/inline-post-return-value.png) +- Generate preprocessed output for a C++ file. In Visual Studio, right-click a C++ file to instantly generate its preprocessed output, making it easy to debug macros and includes, and see errors immediately: ![Screenshot showing the right-click context menu for a C++ file with the Preprocess option highlighted.](./media/cpp-preprocess-menu-entry.png) +- The Visual Studio debugger now shows the return values of functions inline. This provides real-time visibility into function behavior without stepping into code or setting up watches, making it faster to catch logic issues or unexpected results: ![Screenshot showing inline post-return values displayed in the debugger next to function call."](./media/inline-post-return-value.png) -**Other** +### Other changes -- In the Visual Studio installer, the C++ Linux workload is renamed to "Linux, Mac, and embedded development with C++". +- In the Visual Studio installer, the *C++ Linux* workload is renamed *Linux, Mac, and embedded development with C++*. -**Deprecations** +### Deprecations - The minimum supported target operating systems for the MSVC Build Tools version 14.50 are Windows 10 or Windows Server 2016. - MSVC Build Tools version 14.50 no longer targets: @@ -83,11 +84,11 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. -The MSVC compiler switch [`/await`](/cpp/build/reference/await-enable-coroutine-support) is being deprecated and will be removed in a future release. This switch enabled an early draft implementation of C++ coroutines using the `` header. Developers should transition to standard C++ coroutines by using the `` header available in C++20 and later. For C++14/17 projects, use `/await:strict` (which isn't being deprecated) to access the standard `` header without enabling other C++20 features. +The MSVC compiler switch [`/await`](/cpp/build/reference/await-enable-coroutine-support) is deprecated and will be removed in a future release. This switch enabled an early draft implementation of C++ coroutines using the `` header. Developers should transition to standard C++ coroutines by using the `` header available in C++20 and later. For C++14/17 projects, use `/await:strict` (which isn't being deprecated) to access the standard `` header without enabling other C++20 features. The Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. This impacts tooling support for iOS and Android development, including new projects, building, and debugging. -**The following features have been removed and are no longer available:** +### Removed features - C++AMP - ARM32 toolchain: if you still need to build for ARM32, use an older version of the MSVC Build Tools. For more information, see [Side-by-side Minor Version MSVC Toolsets in Visual Studio 2019](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). From f0809491d53ee1ab5a40d7ee1d70719d39496c8c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 10 Nov 2025 15:15:04 -0800 Subject: [PATCH 1463/1799] edits --- docs/overview/visual-cpp-language-conformance.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 221c9e92868..ed623aaf45c 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -196,7 +196,7 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P2156R1 Allow Duplicate Attributes`](https://wg21.link/p2156r1) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2173R1 Attributes on Lambda-Expressions`](https://wg21.link/p2173r1) | VS 2022 17.14 [23](#note_23) | |  [`P2186R2 Remove Garbage Collection Support`](https://wg21.link/p2186r2) | VS 2022 17.0 [23](#note_23) | -|  [`P2201R1 Mixed string literal concatenation`](https://wg21.link/p2201r1) | No change required | +|  [`P2201R1 Mixed string literal concatenation`](https://wg21.link/p2201r1) | VS 2022 17.14 | |  [`P2223R2 Trimming whitespaces before line splicing`](https://wg21.link/p2223r2) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2242R3 Non-literal variables (and labels and gotos) in constexpr functions`](https://wg21.link/p2242r3) | VS 2022 17.14 [23](#note_23) | |  [`P2246R1 Character encoding of diagnostic text`](https://wg21.link/p2246r1) | VS 2022 17.0 [23](#note_23) | @@ -224,7 +224,7 @@ For details on conformance improvements, see [C++ conformance improvements in Vi A more detailed listing of Standard Library features and bug fixes by product version is available on the [GitHub Microsoft STL wiki Changelog](https://github.com/microsoft/STL/wiki/Changelog) page. -For the latest details about ongoing conformance work, see: +For the latest information about ongoing conformance work, see: - [STL C++23 Features](https://github.com/orgs/microsoft/projects/1142/views/2). - [STL C++26 Features](https://github.com/orgs/microsoft/projects/1143/views/2). @@ -640,7 +640,7 @@ These algorithms aren't presently parallelized:
**T** `` is currently supported when compiled as C++ (`/std:c++latest`). It isn't yet supported when compiled as C (`/std:c11` and `/std:c17`) - **U** Extended floating-point types are an optional C++23 feature. MSVC doesn't plan to support this feature before the completion of C++23 standardization. + **U** Extended floating-point types are an optional C++23 feature. This feature won't be implemented until C++23 standardization is finalized. **V** Use the compiler options `/source-charset:utf-8` and `/we4828` to treat source files as UTF-8 encoded. From 147b67b7a1c7023b36e617e55affa61935159eda Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 10 Nov 2025 15:22:31 -0800 Subject: [PATCH 1464/1799] Fix duplicate entry for Warning C26864 in toc.yml --- docs/code-quality/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/code-quality/toc.yml b/docs/code-quality/toc.yml index 477bb054caa..948d04dcb78 100644 --- a/docs/code-quality/toc.yml +++ b/docs/code-quality/toc.yml @@ -661,7 +661,7 @@ items: href: ../code-quality/c26863.md - name: Warning C26864 href: ../code-quality/c26864.md - - name: Warning C26864 + - name: Warning C26865 href: ../code-quality/c26865.md - name: Warning C28020 href: ../code-quality/c28020.md From 61c95ca870b5328b612a87f34e32f29d92f46973 Mon Sep 17 00:00:00 2001 From: James Barnett Date: Mon, 10 Nov 2025 17:00:41 -0700 Subject: [PATCH 1465/1799] Update what-s-new-for-msvc.md --- docs/overview/what-s-new-for-msvc.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 5a347d2c568..8a8844fac47 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -61,7 +61,9 @@ Here's a quick highlight of some of the new features in MSVC Build Tools version - Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows: - Code analysis has new configuration options. You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. - You can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. - - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). + - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: + +![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png) - AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with [AddressSanitizer](/cpp/sanitizers/asan), which allows you to identify hard-to-find memory safety issues with zero false positives at runtime and increase memory safety. Now you can use AddressSanitizer to target ARM64. This feature is in preview. ### Productivity enhancements @@ -100,4 +102,4 @@ We'd love to hear from you! You can [Report a Problem or Suggest a Feature](/vis ## Blogs -Take advantage of the insights and recommendations available in the [Microsoft Developer Blogs](https://devblogs.microsoft.com/) site to stay up to date on all new releases. The blogs include deep dive posts on a broad range of features. The [C++ Team Blog](https://devblogs.microsoft.com/cppblog) and the [Visual Studio Blog](https://devblogs.microsoft.com/visualstudio) are of particular interest. \ No newline at end of file +Take advantage of the insights and recommendations available in the [Microsoft Developer Blogs](https://devblogs.microsoft.com/) site to stay up to date on all new releases. The blogs include deep dive posts on a broad range of features. The [C++ Team Blog](https://devblogs.microsoft.com/cppblog) and the [Visual Studio Blog](https://devblogs.microsoft.com/visualstudio) are of particular interest. From f26307549cb61764515ee971f6ec1af5f85becfd Mon Sep 17 00:00:00 2001 From: Paul Chapman Date: Tue, 11 Nov 2025 09:18:48 -0800 Subject: [PATCH 1466/1799] Update links for VC++ redistributable packages (#6145) Fixed evergreen links to the latest redist --- docs/windows/latest-supported-vc-redist.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 5465d47255a..e6d58668abf 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -48,9 +48,9 @@ Unlike older versions of Visual Studio that have infrequent redistributable upda | Architecture | Link | Notes | |--|--|--| -| ARM64 | [https://aka.ms/vc14/release/vc_redist.arm64.exe](https://aka.ms/vc14/release/vc_redist.arm64.exe) | Permalink for latest supported ARM64 version | -| X86 | [https://aka.ms/vc14/release/vc_redist.x86.exe](https://aka.ms/vc14/release/vc_redist.x86.exe) | Permalink for latest supported x86 version | -| X64 | [https://aka.ms/vc14/release/vc_redist.x64.exe](https://aka.ms/vc14/release/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | +| ARM64 | [https://aka.ms/vc14/vc_redist.arm64.exe](https://aka.ms/vc14/vc_redist.arm64.exe) | Permalink for latest supported ARM64 version | +| X86 | [https://aka.ms/vc14/vc_redist.x86.exe](https://aka.ms/vc14/vc_redist.x86.exe) | Permalink for latest supported x86 version | +| X64 | [https://aka.ms/vc14/vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | Download other versions, including long term servicing release channel (LTSC) versions, from [my.visualstudio.com](https://my.visualstudio.com/). From b520eb9fda994454fa5a55cc99597e64929e41cd Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 11 Nov 2025 12:59:30 -0800 Subject: [PATCH 1467/1799] fix link --- docs/overview/what-s-new-for-msvc.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 8a8844fac47..e9563fdf67e 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,7 +1,7 @@ --- title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 11/10/2025 +ms.date: 11/11/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new @@ -11,7 +11,7 @@ ms.custom: intro-whats-new Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and other build tools. -- For more information about what's new in all of Visual Studio, see [What's new in Visual Studio](/visualstudio/ide/whats-new-visual-studio). +- For more information about what's new in all of Visual Studio, see [Visual Studio 2026 release notes](/visualstudio/releases/2026/release-notes). ## What's new for MSVC Build Tools version 14.50 From 27114572131de0eb93bebdafea2968444df8d1c6 Mon Sep 17 00:00:00 2001 From: Pat Altimore <17440249+PatAltimore@users.noreply.github.com> Date: Wed, 12 Nov 2025 12:50:33 -0800 Subject: [PATCH 1468/1799] Remove Azure Storage Client library --- docs/cloud/cloud-and-web-programming-in-visual-cpp.md | 10 ---------- docs/data/data-access-in-cpp.md | 4 ++-- 2 files changed, 2 insertions(+), 12 deletions(-) diff --git a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md index fd87a91b844..d02d3a11cda 100644 --- a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md +++ b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md @@ -24,16 +24,6 @@ In C++, you have several options for connecting to the web and the cloud. To get started, see [Install and integrate from the Azure SDK for C++](/azure/developer/cpp/sdk/install-and-integrate-the-sdk/). -- [Microsoft Azure Storage Client Library for C++](https://azure.github.io/azure-storage-cpp/) - - The Azure Storage Client Library for C++ provides a comprehensive API for working with Azure storage, including but not limited to the following abilities: - - - Create, read, delete, and list blob containers, tables, and queues. - - Create, read, delete, list, and copy blobs plus read and write blob ranges. - - Insert, delete, replace, merge, and query entities in an Azure table. - - Enqueue and dequeue messages in an Azure queue. - - Lazily list containers, blobs, tables, and queues, and lazily query entities - - The ANSI C99 [Azure IoT Hub SDKs](/azure/iot-hub/iot-hub-devguide-sdks) for Internet of Things enable IoT applications to run on the device or on the backend. - [OneDrive and SharePoint in Microsoft Graph](https://dev.onedrive.com/README.htm) diff --git a/docs/data/data-access-in-cpp.md b/docs/data/data-access-in-cpp.md index 30bf4163522..cad81a78284 100644 --- a/docs/data/data-access-in-cpp.md +++ b/docs/data/data-access-in-cpp.md @@ -27,8 +27,8 @@ A mostly legacy interface which is still required in some scenarios, specificall [Connect to SQL Database using C and C++](/azure/sql-database/sql-database-develop-cplusplus-simple)
Connect to Azure SQL Database from C or C++ applications. -[Microsoft Azure Storage Client Library for C++](https://github.com/Azure/azure-storage-cpp)
-[Azure Storage](/azure/storage/common/storage-introduction) is a cloud storage solution for modern applications that rely on durability, availability, and scalability to meet the needs of their customers. Connect to Azure Storage from C++ by using the Azure Storage Client Library for C++. +[Azure SDK for C++](/azure/developer/cpp/sdk/overview)
+[Azure Storage](/azure/storage/common/storage-introduction) is a cloud storage solution for modern applications that rely on durability, availability, and scalability to meet the needs of their customers. Connect to Azure Storage from C++ by using the Azure SDK for C++. [ODBC Driver for SQL Server](/sql/connect/odbc/microsoft-odbc-driver-for-sql-server)
The latest ODBC driver provides robust data access to Microsoft SQL Server and Microsoft Azure SQL Database for C/C++ based applications. Provides support for features including always encrypted, Azure Active Directory, and AlwaysOn Availability Groups. Also available for macOS and Linux. From a16edc8bbc6db7f1817d4cec41be7b2673c285ad Mon Sep 17 00:00:00 2001 From: Pat Altimore <17440249+PatAltimore@users.noreply.github.com> Date: Wed, 12 Nov 2025 13:29:29 -0800 Subject: [PATCH 1469/1799] Fix branding --- docs/cloud/cloud-and-web-programming-in-visual-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md index d02d3a11cda..3259d2638e5 100644 --- a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md +++ b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md @@ -1,6 +1,6 @@ --- title: "Cloud and Web Programming in Microsoft C++" -description: "Learn more about: Cloud and Web Programming in Visual C++" +description: "Learn more about: Cloud and Web Programming in Microsoft C++" ms.date: "11/06/2025" ms.topic: "overview" ms.custom: intro-overview From e92475f74ce7d63ccf1f1be1b6b0abf3156f74bf Mon Sep 17 00:00:00 2001 From: Diana Richards Date: Wed, 12 Nov 2025 16:25:31 -0600 Subject: [PATCH 1470/1799] raising acrolinx Corrected a typographical error in the OLE DB Programming section. --- docs/data/data-access-in-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/data/data-access-in-cpp.md b/docs/data/data-access-in-cpp.md index cad81a78284..f9f8add32c0 100644 --- a/docs/data/data-access-in-cpp.md +++ b/docs/data/data-access-in-cpp.md @@ -20,7 +20,7 @@ Describes legacy data access programming with Visual C++, where the preferred wa The Microsoft Foundation Classes (MFC) library supplies classes for programming with Open Database Connectivity (ODBC). [OLE DB Programming](oledb/ole-db-programming.md)
-A mostly legacy interface which is still required in some scenarios, specifically when you are programming against linked servers. +A mostly legacy interface which is still required in some scenarios, specifically when you're programming against linked servers. ## Related Topics From 8a98c39c2c5e7937cbedf2097a1af5a0e8d79402 Mon Sep 17 00:00:00 2001 From: Bzychkin Egor Date: Thu, 13 Nov 2025 21:49:57 +0300 Subject: [PATCH 1471/1799] Clarify random_device usage in test function Updated comments in the test function to clarify the use of random_device. --- docs/standard-library/normal-distribution-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/normal-distribution-class.md b/docs/standard-library/normal-distribution-class.md index db8ba64c3be..e9e4be15c45 100644 --- a/docs/standard-library/normal-distribution-class.md +++ b/docs/standard-library/normal-distribution-class.md @@ -83,7 +83,7 @@ using namespace std; void test(const double m, const double s, const int samples) { // uncomment to use a non-deterministic seed - // random_device gen; + // random_device rd; // mt19937 gen(rd()); mt19937 gen(1701); From 08c9a393b79d58ac83e4d2512afdbb3ca9508d3d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 13 Nov 2025 16:24:04 -0800 Subject: [PATCH 1472/1799] note local::empty deprecated --- docs/standard-library/locale-class.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/standard-library/locale-class.md b/docs/standard-library/locale-class.md index b627b01ac3b..96b2151a0f3 100644 --- a/docs/standard-library/locale-class.md +++ b/docs/standard-library/locale-class.md @@ -1,10 +1,9 @@ --- description: "Learn more about: locale Class" title: "locale Class" -ms.date: 06/15/2022 +ms.date: 11/13/2025 f1_keywords: ["xlocale/std::locale", "xlocale/std::locale::category", "xlocale/std::locale::combine", "xlocale/std::locale::name", "xlocale/std::locale::classic", "xlocale/std::locale::global", "xlocale/std::locale::operator( )", "xlocale/std::locale::facet", "xlocale/std::locale::id"] helpviewer_keywords: ["std::locale [C++]", "std::locale [C++], category", "std::locale [C++], combine", "std::locale [C++], name", "std::locale [C++], classic", "std::locale [C++], global", "std::locale [C++], facet", "std::locale [C++], id"] -ms.assetid: 7dd6d271-472d-4750-8fb5-ea8f55fbef62 ms.custom: devdivchpfy22 --- @@ -92,15 +91,16 @@ messages Some of these predefined facets are used by the `iostream` classes, to control the conversion of numeric values to and from text sequences. -An object of class locale also stores a locale name as an object of class [string](../standard-library/string-typedefs.md#string). Using an invalid locale name to construct a locale facet or a locale object throws an object of class [runtime_error](../standard-library/runtime-error-class.md). The stored locale name is `"*"` if the locale object can't be certain that a C-style locale corresponds exactly to the one represented by the object. Otherwise, you can establish a matching locale within the Standard C Library, for some locale object `locale_object`, by calling `setlocale(LC_ALL , locale_object.`[name](#name)`().c_str())`. - -In this implementation, you can also call the static member function: +An object of class `locale` also stores a locale name as an object of class [string](../standard-library/string-typedefs.md#string). Using an invalid locale name to construct a locale facet or a locale object throws an object of class [runtime_error](../standard-library/runtime-error-class.md). The stored locale name is `"*"` if the locale object can't be certain that a C-style locale corresponds exactly to the one represented by the object. Otherwise, you can establish a matching locale within the Standard C Library, for some locale object `locale_object`, by calling `setlocale(LC_ALL , locale_object.`[name](#name)`().c_str())`. ```cpp static locale empty(); ``` -to construct a locale object that has no facets. It's also a transparent locale. If the template functions [has_facet](../standard-library/locale-functions.md#has_facet) and [use_facet](../standard-library/locale-functions.md#use_facet) can't find the requested facet in a transparent locale, they consult first the global locale and then, if that is transparent, the classic locale. So, you can write: +> [!NOTE] +> `locale::empty()` was deprecated starting with Visual Studio 2022 17.14. It'll be removed starting with MSVC Build Tools 14.51. For more information, see [#5834](https://github.com/microsoft/STL/pull/5834). + +In this implementation, you can also call the static member function `empty()` to construct a locale object that has no facets. It's also a transparent locale. If the template functions [has_facet](../standard-library/locale-functions.md#has_facet) and [use_facet](../standard-library/locale-functions.md#use_facet) can't find the requested facet in a transparent locale, they consult first the global locale and then, if that is transparent, the classic locale. So, you can write: ```cpp cout.imbue(locale::empty()); From c38b53522d2ec987383f1140ce6ba706ea8149dd Mon Sep 17 00:00:00 2001 From: Mahmoud Saleh <12202790+MahmoudGSaleh@users.noreply.github.com> Date: Fri, 14 Nov 2025 09:34:54 -0800 Subject: [PATCH 1473/1799] Update Note for VS 2015 Clarified support status for Visual C++ Redistributable versions and compatibility guidance for Visual Studio 2015. --- docs/windows/latest-supported-vc-redist.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index e6d58668abf..54c6d5c17c0 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -63,6 +63,7 @@ Download other versions, including long term servicing release channel (LTSC) ve * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 - Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version. +As of the time Visual Studio 2015 support ended, the v14 runtime is binary compatible with applications created with the VS 2015 MSVC Build Tools. Over time, Microsoft may no longer support that compatibility. Because Visual Studio 2015 is out of support, our guidance is that you update your projects to build with a supported MSVC Build Tools. If you are statically linking the Visual Studio 2015 C++ runtime, we recommend updating to a supported version of the runtime. - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions From 93300a3e96e5d4a874e321c7aa2eff3ca13b908e Mon Sep 17 00:00:00 2001 From: Mahmoud Saleh <12202790+MahmoudGSaleh@users.noreply.github.com> Date: Fri, 14 Nov 2025 10:09:36 -0800 Subject: [PATCH 1474/1799] Clarify support status for Visual Studio 2015 Removed duplicate information regarding the end of support for Visual Studio 2015 and its Redistributable. --- docs/windows/latest-supported-vc-redist.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 54c6d5c17c0..6df83b16c7a 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -62,8 +62,8 @@ Download other versions, including long term servicing release channel (LTSC) ve - The latest version of the Visual C++ v14 Redistributable included with Visual Studio 2026 only supports the following operating systems: * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 -- Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version. -As of the time Visual Studio 2015 support ended, the v14 runtime is binary compatible with applications created with the VS 2015 MSVC Build Tools. Over time, Microsoft may no longer support that compatibility. Because Visual Studio 2015 is out of support, our guidance is that you update your projects to build with a supported MSVC Build Tools. If you are statically linking the Visual Studio 2015 C++ runtime, we recommend updating to a supported version of the runtime. +- Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version.
+As of the time Visual Studio 2015 support ended, the v14 runtime is binary compatible with applications created with the VS 2015 MSVC Build Tools. Over time, Microsoft may no longer support that compatibility. Because Visual Studio 2015 is out of support, our guidance is that you update your projects to build with a supported MSVC Build Tools. If you are statically linking the Visual Studio 2015 C++ runtime, we recommend updating to a supported version. - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions From 796bc48133b42f3d5475ec0568c0ae478eae1fc9 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 18 Nov 2025 10:56:38 -0800 Subject: [PATCH 1475/1799] document ASan x64 debug spew --- docs/sanitizers/asan-known-issues.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 273389bad95..e82862095f7 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -99,6 +99,12 @@ If all of the DLLs compiled with ASan are unloaded from the process before the p Please report any bugs to our [Developer Community](https://aka.ms/feedback/report?space=62). +## ASan generates a large amount of benign first chance exceptions in 64-bit architectures + +ASan reserves about one third of the process virtual memory for its [shadow bytes](./asan-shadow-bytes.md). In a 64-bit address space, this corresponds to several terabytes of memory, making it impractical for ASan to pre-commit these pages during initialization. Therefore, ASan in 64-bit architectures uses an on-demand shadow byte paging scheme: when a shadow bytes page is accessed for the first time, ASan is notified through a first-chance exception, and only commits the page at that moment. As a result, some debuggers may display a large amount of benign 'first chance' exceptions when running under ASan. + +The Visual Studio debugger has been enlightened to handle this gracefully, and does not show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](https://learn.microsoft.com/en-us/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. + ## See also [AddressSanitizer overview](asan.md)\ From 52ecf7190156928989ed7de2d4bc6d9ffc472324 Mon Sep 17 00:00:00 2001 From: Mahmoud Saleh <12202790+MahmoudGSaleh@users.noreply.github.com> Date: Tue, 18 Nov 2025 13:37:36 -0800 Subject: [PATCH 1476/1799] Clarify guidance on Visual Studio 2015 support Reworded guidance on Visual Studio 2015 support and compatibility. --- docs/windows/latest-supported-vc-redist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 6df83b16c7a..eb11eb2f471 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -63,7 +63,7 @@ Download other versions, including long term servicing release channel (LTSC) ve * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 - Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version.
-As of the time Visual Studio 2015 support ended, the v14 runtime is binary compatible with applications created with the VS 2015 MSVC Build Tools. Over time, Microsoft may no longer support that compatibility. Because Visual Studio 2015 is out of support, our guidance is that you update your projects to build with a supported MSVC Build Tools. If you are statically linking the Visual Studio 2015 C++ runtime, we recommend updating to a supported version. +When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built using the VS 2015 MSVC Build Tools. Since VS 2015 is no longer supported, we recommend updating your projects to use a supported MSVC Build Tools version and the latest v14 runtime. - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions From 3fcb276fbef69bd2161b616d7dbfce7ced5e9dc0 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 18 Nov 2025 16:10:33 -0800 Subject: [PATCH 1477/1799] apply feedback: do not use 'enlightened' --- docs/sanitizers/asan-known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index e82862095f7..657243e90a8 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -103,7 +103,7 @@ Please report any bugs to our [Developer Community](https://aka.ms/feedback/repo ASan reserves about one third of the process virtual memory for its [shadow bytes](./asan-shadow-bytes.md). In a 64-bit address space, this corresponds to several terabytes of memory, making it impractical for ASan to pre-commit these pages during initialization. Therefore, ASan in 64-bit architectures uses an on-demand shadow byte paging scheme: when a shadow bytes page is accessed for the first time, ASan is notified through a first-chance exception, and only commits the page at that moment. As a result, some debuggers may display a large amount of benign 'first chance' exceptions when running under ASan. -The Visual Studio debugger has been enlightened to handle this gracefully, and does not show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](https://learn.microsoft.com/en-us/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. +The Visual Studio debugger handles this gracefully, and doesn't show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](https://learn.microsoft.com/en-us/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. ## See also From 59b72dfcb1e2624d5f06d67c768753d5ce48a22d Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 18 Nov 2025 16:13:04 -0800 Subject: [PATCH 1478/1799] simplify title --- docs/sanitizers/asan-known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 657243e90a8..ba29182e98f 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -99,7 +99,7 @@ If all of the DLLs compiled with ASan are unloaded from the process before the p Please report any bugs to our [Developer Community](https://aka.ms/feedback/report?space=62). -## ASan generates a large amount of benign first chance exceptions in 64-bit architectures +## ASan 64-bit first chance exceptions ASan reserves about one third of the process virtual memory for its [shadow bytes](./asan-shadow-bytes.md). In a 64-bit address space, this corresponds to several terabytes of memory, making it impractical for ASan to pre-commit these pages during initialization. Therefore, ASan in 64-bit architectures uses an on-demand shadow byte paging scheme: when a shadow bytes page is accessed for the first time, ASan is notified through a first-chance exception, and only commits the page at that moment. As a result, some debuggers may display a large amount of benign 'first chance' exceptions when running under ASan. From 27c2efe77b3a2ae76869147ae0d83490a96a9a13 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 18 Nov 2025 16:17:28 -0800 Subject: [PATCH 1479/1799] provide a higher-level explanation --- docs/sanitizers/asan-known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index ba29182e98f..2732dfdd65b 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -101,7 +101,7 @@ Please report any bugs to our [Developer Community](https://aka.ms/feedback/repo ## ASan 64-bit first chance exceptions -ASan reserves about one third of the process virtual memory for its [shadow bytes](./asan-shadow-bytes.md). In a 64-bit address space, this corresponds to several terabytes of memory, making it impractical for ASan to pre-commit these pages during initialization. Therefore, ASan in 64-bit architectures uses an on-demand shadow byte paging scheme: when a shadow bytes page is accessed for the first time, ASan is notified through a first-chance exception, and only commits the page at that moment. As a result, some debuggers may display a large amount of benign 'first chance' exceptions when running under ASan. +In 64-bit systems, MSVC ASan's [shadow bytes](./asan-shadow-bytes.md) region occupies several terabytes of virtual address space. ASan does not pre-commit this memory; instead, it uses on demand paging. When a shadow page is accessed for the first time, a first-chance page-fault exception occurs and is handled by ASan, which commits the page. The Visual Studio debugger handles this gracefully, and doesn't show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](https://learn.microsoft.com/en-us/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. From d0e9b95e6bf868d0ff8ed779b108215096b690d2 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 18 Nov 2025 16:23:32 -0800 Subject: [PATCH 1480/1799] remove localization from URI --- docs/sanitizers/asan-known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 2732dfdd65b..1d82b591fb0 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -103,7 +103,7 @@ Please report any bugs to our [Developer Community](https://aka.ms/feedback/repo In 64-bit systems, MSVC ASan's [shadow bytes](./asan-shadow-bytes.md) region occupies several terabytes of virtual address space. ASan does not pre-commit this memory; instead, it uses on demand paging. When a shadow page is accessed for the first time, a first-chance page-fault exception occurs and is handled by ASan, which commits the page. -The Visual Studio debugger handles this gracefully, and doesn't show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](https://learn.microsoft.com/en-us/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. +The Visual Studio debugger handles this gracefully, and doesn't show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](https://learn.microsoft.com/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. ## See also From 76bf79d0e56212f6317c6af50f4df5c1ccaf5f18 Mon Sep 17 00:00:00 2001 From: David Justo Date: Wed, 19 Nov 2025 13:49:41 -0800 Subject: [PATCH 1481/1799] apply feedback --- docs/sanitizers/asan-known-issues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 1d82b591fb0..2d44999caba 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -101,7 +101,7 @@ Please report any bugs to our [Developer Community](https://aka.ms/feedback/repo ## ASan 64-bit first chance exceptions -In 64-bit systems, MSVC ASan's [shadow bytes](./asan-shadow-bytes.md) region occupies several terabytes of virtual address space. ASan does not pre-commit this memory; instead, it uses on demand paging. When a shadow page is accessed for the first time, a first-chance page-fault exception occurs and is handled by ASan, which commits the page. +On x64, MSVC ASan's [shadow bytes](./asan-shadow-bytes.md) region occupies several terabytes of virtual address space. ASan doesn't pre-commit this memory. Instead, it uses on-demand paging. When a shadow page is accessed for the first time, a first-chance page fault exception occurs and is handled by ASan, which commits the page. The Visual Studio debugger handles this gracefully, and doesn't show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](https://learn.microsoft.com/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. From e228a3cacf67429e55694bb6d44e7ea6a6f79e7d Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 19 Nov 2025 14:01:54 -0800 Subject: [PATCH 1482/1799] Update link Updated the date for AddressSanitizer known issues documentation. --- docs/sanitizers/asan-known-issues.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index 2d44999caba..7d3b22a2e7a 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -1,7 +1,7 @@ --- title: "AddressSanitizer known issues and limitations" description: "Technical description of the AddressSanitizer for Microsoft C/C++ known issues." -ms.date: 5/21/2025 +ms.date: 11/19/2025 helpviewer_keywords: ["AddressSanitizer known issues"] --- @@ -103,7 +103,7 @@ Please report any bugs to our [Developer Community](https://aka.ms/feedback/repo On x64, MSVC ASan's [shadow bytes](./asan-shadow-bytes.md) region occupies several terabytes of virtual address space. ASan doesn't pre-commit this memory. Instead, it uses on-demand paging. When a shadow page is accessed for the first time, a first-chance page fault exception occurs and is handled by ASan, which commits the page. -The Visual Studio debugger handles this gracefully, and doesn't show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](https://learn.microsoft.com/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. +The Visual Studio debugger handles this gracefully, and doesn't show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. ## See also From 67afcae695bca6bba93270085e3e2f73ad541c08 Mon Sep 17 00:00:00 2001 From: Raymond Chen Date: Wed, 19 Nov 2025 19:21:36 -0800 Subject: [PATCH 1483/1799] Clarify CListBox::InitStorage parameters The meaning of the lParam has been a source of confusion. Clarified the text for lParam and cleaned up the wParam, return value, and blurb. (Also avoid overselling the message. Change "the shortest possible time" to just "more efficient". Because it's still not "the shortest possible time", but it's shorter than it would be without the message.) https://groups.google.com/g/comp.os.ms-windows.programmer.win32/c/MtviqqbHDQs/m/2a2PGs0xmJMJ This is the MFC counterpart to win32-pr#3259 --- docs/mfc/reference/clistbox-class.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/mfc/reference/clistbox-class.md b/docs/mfc/reference/clistbox-class.md index 93f4efc5532..a027c88be44 100644 --- a/docs/mfc/reference/clistbox-class.md +++ b/docs/mfc/reference/clistbox-class.md @@ -873,10 +873,10 @@ int InitStorage( ### Parameters *`nItems`*
-Specifies the number of items to add. +Specifies the number of items to for which to reserve space. *`nBytes`*
-Specifies the amount of memory, in bytes, to allocate for item strings. +Specifies the amount of additional memory, in bytes, to allocate for item strings. ### Return Value @@ -884,9 +884,9 @@ If successful, the maximum number of items that the list box can store before a ### Remarks -Call this function before adding a large number of items to a `CListBox`. +You can call this function before adding a large number of items to a `CListBox`. -This function helps speed up the initialization of list boxes that have a large number of items (more than 100). It preallocates the specified amount of memory so that subsequent [`AddString`](#addstring), [`InsertString`](#insertstring), and [`Dir`](#dir) functions take the shortest possible time. You can use estimates for the parameters. If you overestimate, some extra memory is allocated; if you underestimate, the normal allocation is used for items that exceed the preallocated amount. +This function helps speed up the initialization of list boxes that have a large number of items (more than 100). It preallocates the specified amount of memory so that subsequent [`AddString`](#addstring), [`InsertString`](#insertstring), and [`Dir`](#dir) functions are more efficient. You can use estimates for the parameters. If you overestimate, the extra rmemory remains allocated; if you underestimate, the list box will allocate additional memory as necessary. Windows 95/98 only: The *`nItems`* parameter is limited to 16-bit values. This means list boxes cannot contain more than 32,767 items. Although the number of items is restricted, the total size of the items in a list box is limited only by available memory. From df73a673bb42be358a95a1fe41e5657464d6267c Mon Sep 17 00:00:00 2001 From: Raymond Chen Date: Wed, 19 Nov 2025 19:26:38 -0800 Subject: [PATCH 1484/1799] Fix sample associated with CListBox::InitStorage --- docs/mfc/codesnippet/CPP/clistbox-class_23.cpp | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/mfc/codesnippet/CPP/clistbox-class_23.cpp b/docs/mfc/codesnippet/CPP/clistbox-class_23.cpp index 7301b4da087..f7c839534b6 100644 --- a/docs/mfc/codesnippet/CPP/clistbox-class_23.cpp +++ b/docs/mfc/codesnippet/CPP/clistbox-class_23.cpp @@ -1,6 +1,6 @@ -// Initialize the storage of the list box to be 256 strings with -// about 10 characters per string, performance improvement. -int n = m_myListBox.InitStorage(256, 16 * sizeof(TCHAR)); +// Reserve space in the list box for 256 additional strings with +// about 15 characters per string. +int n = m_myListBox.InitStorage(256, 256 * (15 + 1) * sizeof(TCHAR)); ASSERT(n != LB_ERRSPACE); // Add 256 items to the list box. From b754c12a31d6c02bd9a79d6318968f5bdd1f0a38 Mon Sep 17 00:00:00 2001 From: Raymond Chen Date: Thu, 20 Nov 2025 09:18:06 -0800 Subject: [PATCH 1485/1799] Typos and give specific calculation formula --- docs/mfc/reference/clistbox-class.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/mfc/reference/clistbox-class.md b/docs/mfc/reference/clistbox-class.md index a027c88be44..ffdca49e04e 100644 --- a/docs/mfc/reference/clistbox-class.md +++ b/docs/mfc/reference/clistbox-class.md @@ -886,7 +886,9 @@ If successful, the maximum number of items that the list box can store before a You can call this function before adding a large number of items to a `CListBox`. -This function helps speed up the initialization of list boxes that have a large number of items (more than 100). It preallocates the specified amount of memory so that subsequent [`AddString`](#addstring), [`InsertString`](#insertstring), and [`Dir`](#dir) functions are more efficient. You can use estimates for the parameters. If you overestimate, the extra rmemory remains allocated; if you underestimate, the list box will allocate additional memory as necessary. +This function helps speed up the initialization of list boxes that have a large number of items (more than 100). It preallocates the specified amount of memory so that subsequent [`AddString`](#addstring), [`InsertString`](#insertstring), and [`Dir`](#dir) functions are more efficient. You can use estimates for the parameters. If you overestimate, the extra memory remains allocated; if you underestimate, the list box will allocate additional memory as necessary. + +The memory required to store a string includes the null terminator. Therefore, if you plan to add 100 strings, each with a length of 10 characters, you would pass a *wParam* of 100 and an *lParam* of 100 × (10 + 1) × sizeof(TCHAR). Windows 95/98 only: The *`nItems`* parameter is limited to 16-bit values. This means list boxes cannot contain more than 32,767 items. Although the number of items is restricted, the total size of the items in a list box is limited only by available memory. From 06e9d609d40837a537feeb4328b9c35012c46f8c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 20 Nov 2025 14:52:53 -0800 Subject: [PATCH 1486/1799] update instructions --- .github/copilot-instructions.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 75dc5da1e0a..3f4b335d6c1 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -11,6 +11,7 @@ When writing documentation, follow these guidelines: ## Grammar +* Avoid "we"/"our" referring to documentation authors * Use present tense verbs (is, open) instead of past tense (was, opened). For example, "The method returns a value" instead of "The method will return a value." * Write factual statements and direct commands. Avoid hypotheticals. * Use active voice where the subject performs the action. @@ -81,7 +82,8 @@ When writing documentation, follow these guidelines: ## Adding links -* Add links to related topics and resources where appropriate. +* Add links to related topics and resources where appropriate. +* Use relative links for files in this repo * Links to other documentation articles should be relative, not absolute. Start relative links with `/docs/` and include the `.md` suffix. If you add a link to another page on learn.microsoft.com that's not in this repo, remove https://learn.microsoft.com/en-us from the link. * Links to bookmarks within the same article should be relative and start with `#`. * Link descriptions should be descriptive and make sense on their own. Don't use "click here" or "this link" or "here". From 0b92d03a224486982ee2432778833c328ec8ef99 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 24 Nov 2025 21:25:32 +0000 Subject: [PATCH 1487/1799] Initial plan From f37c90a774d8902c1ace6fc6f7316790c2d539fb Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 24 Nov 2025 21:30:18 +0000 Subject: [PATCH 1488/1799] Update x64 calling convention terminology for stack argument passing Co-authored-by: TylerMSFT <12305055+TylerMSFT@users.noreply.github.com> --- docs/build/x64-calling-convention.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/build/x64-calling-convention.md b/docs/build/x64-calling-convention.md index bf4a575b47f..d9bf0d97b40 100644 --- a/docs/build/x64-calling-convention.md +++ b/docs/build/x64-calling-convention.md @@ -34,7 +34,7 @@ Prologs and epilogs are highly restricted so that they can be properly described ## Parameter passing -By default, the x64 calling convention passes the first four arguments to a function in registers. The registers used for these arguments depend on the position and type of the argument. Remaining arguments get pushed on the stack in right-to-left order. All arguments passed on the stack are 8-byte aligned. +By default, the x64 calling convention passes the first four arguments to a function in registers. The registers used for these arguments depend on the position and type of the argument. Remaining arguments are passed on the stack in right-to-left order. The caller reserves the required stack space and writes these arguments to stack memory using store or move instructions, maintaining 8-byte alignment for each argument. Integer valued arguments in the leftmost four positions are passed in left-to-right order in RCX, RDX, R8, and R9, respectively. The fifth and higher arguments are passed on the stack as previously described. All integer arguments in registers are right-justified, so the callee can ignore the upper bits of the register and access only the portion of the register necessary. @@ -60,21 +60,21 @@ The following table summarizes how parameters are passed, by type and position f ```cpp func1(int a, int b, int c, int d, int e, int f); -// a in RCX, b in RDX, c in R8, d in R9, f then e pushed on stack +// a in RCX, b in RDX, c in R8, d in R9, f then e passed on stack ``` ### Example of argument passing 2 - all floats ```cpp func2(float a, double b, float c, double d, float e, float f); -// a in XMM0, b in XMM1, c in XMM2, d in XMM3, f then e pushed on stack +// a in XMM0, b in XMM1, c in XMM2, d in XMM3, f then e passed on stack ``` ### Example of argument passing 3 - mixed ints and floats ```cpp func3(int a, double b, int c, float d, int e, float f); -// a in RCX, b in XMM1, c in R8, d in XMM3, f then e pushed on stack +// a in RCX, b in XMM1, c in R8, d in XMM3, f then e passed on stack ``` ### Example of argument passing 4 - `__m64`, `__m128`, and aggregates @@ -82,7 +82,7 @@ func3(int a, double b, int c, float d, int e, float f); ```cpp func4(__m64 a, __m128 b, struct c, float d, __m128 e, __m128 f); // a in RCX, ptr to b in RDX, ptr to c in R8, d in XMM3, -// ptr to f pushed on stack, then ptr to e pushed on stack +// ptr to f passed on stack, then ptr to e passed on stack ``` ## Varargs @@ -112,7 +112,7 @@ These examples show how parameters and return values are passed for functions wi ```cpp __int64 func1(int a, float b, int c, int d, int e); -// Caller passes a in RCX, b in XMM1, c in R8, d in R9, e pushed on stack, +// Caller passes a in RCX, b in XMM1, c in R8, d in R9, e passed on stack, // callee returns __int64 result in RAX. ``` @@ -132,7 +132,7 @@ struct Struct1 { }; Struct1 func3(int a, double b, int c, float d); // Caller allocates memory for Struct1 returned and passes pointer in RCX, -// a in RDX, b in XMM2, c in R9, d pushed on the stack; +// a in RDX, b in XMM2, c in R9, d passed on the stack; // callee returns pointer to Struct1 result in RAX. ``` From a0e0ce49a2913f0221a430fe5fdf2ff5f349239e Mon Sep 17 00:00:00 2001 From: speryt-microsoft <245959870+speryt-microsoft@users.noreply.github.com> Date: Mon, 24 Nov 2025 14:01:36 -0800 Subject: [PATCH 1489/1799] Learn Editor: Update vectorizer-and-parallelizer-messages.md --- .../tool-errors/vectorizer-and-parallelizer-messages.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md b/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md index 07ff21fb4e3..3cab6214659 100644 --- a/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md +++ b/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md @@ -30,12 +30,16 @@ The 5*xx* reason codes apply to both the parallelizer and the vectorizer. | Reason code | Explanation | |--|--| -| 500 | A generic message that covers several cases: For example, the loop includes multiple exits, or the loop header doesn't end by incrementing the induction variable. | +| 500 | Induction variable discovery or recurrence failure. | | 501 | Induction variable isn't local; or upper bound isn't loop-invariant. | | 502 | Induction variable is stepped in some manner other than a simple +1. | | 503 | Loop includes exception-handling or switch statements. | | 504 | Loop body may throw an exception that requires destruction of a C++ object. | | 505 | Outer loop has a pre-incremented induction variable. Exiting analysis. | +| 506 | Loop structural / canonical form failure. | +| 507 | Bounds / initialization / termination / compare consistency failure. | +| 508 | Stride derivation or usage failure | +| 509 | Loop direction acceptability failure. | ```cpp void code_500(int *A) From c0fb8feac34d7841ffc219fcf13638d5cfa95f54 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 24 Nov 2025 16:24:03 -0800 Subject: [PATCH 1490/1799] Fix error message formatting and wording --- .../tool-errors/vectorizer-and-parallelizer-messages.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md b/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md index 3cab6214659..c364ea1966d 100644 --- a/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md +++ b/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md @@ -36,8 +36,8 @@ The 5*xx* reason codes apply to both the parallelizer and the vectorizer. | 503 | Loop includes exception-handling or switch statements. | | 504 | Loop body may throw an exception that requires destruction of a C++ object. | | 505 | Outer loop has a pre-incremented induction variable. Exiting analysis. | -| 506 | Loop structural / canonical form failure. | -| 507 | Bounds / initialization / termination / compare consistency failure. | +| 506 | Loop structural or canonical form failure. | +| 507 | Bounds, initialization, termination, or compare consistency failure. | | 508 | Stride derivation or usage failure | | 509 | Loop direction acceptability failure. | From 23d975a5ff2979b83b7e0b483f205e9919d83278 Mon Sep 17 00:00:00 2001 From: "Stephan T. Lavavej" Date: Thu, 27 Nov 2025 22:17:49 -0800 Subject: [PATCH 1491/1799] Learn Editor: Update rtc-run-time-error-checks.md --- docs/build/reference/rtc-run-time-error-checks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/rtc-run-time-error-checks.md b/docs/build/reference/rtc-run-time-error-checks.md index 265e61d945e..0bff5139a6e 100644 --- a/docs/build/reference/rtc-run-time-error-checks.md +++ b/docs/build/reference/rtc-run-time-error-checks.md @@ -42,7 +42,7 @@ int main() { } ``` -Because **`/RTCc`** rejects code that conforms to the standard, it's not supported by the C++ Standard Library. Code that uses **`/RTCc`** and the C++ Standard Library may cause compiler error [C1189](../../error-messages/compiler-errors-1/fatal-error-c1189.md). You can define `_ALLOW_RTCc_IN_STL` to silence the warning and use the **`/RTCc`** option. +Because **`/RTCc`** rejects code that conforms to the standard, it's not supported by the C++ Standard Library. Code that uses **`/RTCc`** and the C++ Standard Library may cause compiler error [C1189](../../error-messages/compiler-errors-1/fatal-error-c1189.md) or [C2338](../../error-messages/compiler-errors-1/compiler-error-c2338.md). Remove the **`/RTCc`** option to use the C++ Standard Library. **`/RTCs`**
Enables stack frame run-time error checking, as follows: From dc90fbfe45074739f3ba494528db033737eab4ba Mon Sep 17 00:00:00 2001 From: "Stephan T. Lavavej" Date: Thu, 27 Nov 2025 22:18:18 -0800 Subject: [PATCH 1492/1799] Learn Editor: Update rtc-run-time-error-checks.md From 2008082e6fd69ec30ec3e2220f6ca28dd3aa73ee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martin=20Storsj=C3=B6?= Date: Fri, 28 Nov 2025 21:10:35 +0200 Subject: [PATCH 1493/1799] Clarify docs for arm64 packed unwind, RegI=0 RegF>0 The condition CR=0 isn't correct here; the same about the first store for float registers doing the predecrement for any variant where there are no integer registers stored before the floats - this goes for both CR=0, CR=2 and CR=3. --- docs/build/arm64-exception-handling.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/arm64-exception-handling.md b/docs/build/arm64-exception-handling.md index d459965ede4..6c82d44da4c 100644 --- a/docs/build/arm64-exception-handling.md +++ b/docs/build/arm64-exception-handling.md @@ -401,7 +401,7 @@ Step 6: Allocate remaining stack, including local area, `` pair, and out \* If **CR** == 01 and **RegI** is an odd number, step 3 and the last `save_reg` in step 2 are merged into one `save_regp`. -\*\* If **RegI** == **CR** == 0, and **RegF** != 0, the first `stp` for the floating-point does the predecrement. +\*\* If **RegI** == 0, **CR** != 01, and **RegF** != 0, the first `stp` for the floating-point does the predecrement. \*\*\* No instruction corresponding to `mov x29,sp` is present in the epilog. Packed unwind data can't be used if a function requires restoration of `sp` from `x29`. From 35f7490046991de1b133c2ba953366cfca53fe5e Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 3 Dec 2025 02:22:50 +0000 Subject: [PATCH 1494/1799] Initial plan From 6cd5f319fde9dadadc2f2e0af6b4bf2a8484676f Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 3 Dec 2025 02:26:48 +0000 Subject: [PATCH 1495/1799] Add module trace file collection guidance to C++ Modules repros section Co-authored-by: TylerMSFT <12305055+TylerMSFT@users.noreply.github.com> --- ...-report-a-problem-with-the-visual-cpp-toolset.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index b917c543d08..86eacb9c832 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -311,6 +311,19 @@ After you generate the preprocessed files, it's a good idea to make sure the pro Finally, attach the preprocessed repro files (*filename*.i and *modulename*.i) along with the .ifc output to your report. +#### To generate a module trace file + +When issues involve C++ modules, providing a module trace file along with the preprocessed repro improves diagnostic quality and reduces turnaround time. A module trace file records detailed information about module operations during compilation. + +1. In the developer command prompt console window, enter the command **cl /d1module:enableLogging** *trace.json* *arguments* *filename.cpp*. The *trace.json* is the desired output file name for the module trace. The *arguments* are the compilation arguments, and *filename.cpp* is the source file that reproduces the problem. + + > [!IMPORTANT] + > You must compile exactly one source file to collect a module trace. Don't use the **/MP** (multi-processor compilation) option or invoke the compiler with multiple source files. Using **/MP** or multi-source invocations can cause the trace to represent only the last compiled file or be incomplete. + +1. If multiple translation units are involved in the problem, run separate single-file invocations to collect a trace for each relevant file. Focus on the specific file that reproduces the problem, and optionally collect one trace per relevant file. + +Finally, attach the generated *trace.json* file along with the preprocessed repro to your report. + ### Link repros A *link repro* is the linker-generated contents of a directory, specified either by the **link\_repro** environment variable, or as an argument to the [/LINKREPRO](../build/reference/linkrepro.md) linker option. It contains build artifacts that collectively demonstrate a problem that occurs at link time. Examples include a backend crash involving Link-Time Code Generation (LTCG), or a linker crash. These build artifacts are the ones needed as linker input so the problem can be reproduced. A link repro can be created easily by using this environment variable. It enables the linker's built-in repro generation capability. From da1b2f33104e3aa9cd7497c61428b98646e757ee Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 3 Dec 2025 02:28:06 +0000 Subject: [PATCH 1496/1799] Improve clarity and remove redundancy in module trace guidance Co-authored-by: TylerMSFT <12305055+TylerMSFT@users.noreply.github.com> --- .../how-to-report-a-problem-with-the-visual-cpp-toolset.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index 86eacb9c832..e994c9a6475 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -315,12 +315,12 @@ Finally, attach the preprocessed repro files (*filename*.i and *modulename*.i) a When issues involve C++ modules, providing a module trace file along with the preprocessed repro improves diagnostic quality and reduces turnaround time. A module trace file records detailed information about module operations during compilation. -1. In the developer command prompt console window, enter the command **cl /d1module:enableLogging** *trace.json* *arguments* *filename.cpp*. The *trace.json* is the desired output file name for the module trace. The *arguments* are the compilation arguments, and *filename.cpp* is the source file that reproduces the problem. +1. In the developer command prompt console window, enter the command **cl /d1module:enableLogging** *trace.json* *arguments* *filename.cpp*. For *trace.json*, specify the desired output file name for the module trace. For *arguments*, use the compilation arguments. For *filename.cpp*, specify the source file that reproduces the problem. > [!IMPORTANT] > You must compile exactly one source file to collect a module trace. Don't use the **/MP** (multi-processor compilation) option or invoke the compiler with multiple source files. Using **/MP** or multi-source invocations can cause the trace to represent only the last compiled file or be incomplete. -1. If multiple translation units are involved in the problem, run separate single-file invocations to collect a trace for each relevant file. Focus on the specific file that reproduces the problem, and optionally collect one trace per relevant file. +1. If multiple translation units are involved in the problem, run separate single-file invocations to collect a trace for the specific file that reproduces the problem. You can collect traces for additional relevant files if needed. Finally, attach the generated *trace.json* file along with the preprocessed repro to your report. From 53b89086f980b20c3224849f54d4bfbf79bc398e Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 3 Dec 2025 02:29:16 +0000 Subject: [PATCH 1497/1799] Refine command syntax to match specification and improve clarity Co-authored-by: TylerMSFT <12305055+TylerMSFT@users.noreply.github.com> --- .../how-to-report-a-problem-with-the-visual-cpp-toolset.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index e994c9a6475..d3a723c3715 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -315,7 +315,7 @@ Finally, attach the preprocessed repro files (*filename*.i and *modulename*.i) a When issues involve C++ modules, providing a module trace file along with the preprocessed repro improves diagnostic quality and reduces turnaround time. A module trace file records detailed information about module operations during compilation. -1. In the developer command prompt console window, enter the command **cl /d1module:enableLogging** *trace.json* *arguments* *filename.cpp*. For *trace.json*, specify the desired output file name for the module trace. For *arguments*, use the compilation arguments. For *filename.cpp*, specify the source file that reproduces the problem. +1. In the developer command prompt console window, enter the command **cl /d1module:enableLogging** *trace.json* [*other-args*] *filename.cpp*. For *trace.json*, specify the desired output file name for the module trace. For [*other-args*], include any additional compilation arguments. For *filename.cpp*, specify the source file that reproduces the problem. > [!IMPORTANT] > You must compile exactly one source file to collect a module trace. Don't use the **/MP** (multi-processor compilation) option or invoke the compiler with multiple source files. Using **/MP** or multi-source invocations can cause the trace to represent only the last compiled file or be incomplete. From 5ba90ff24cfe20b92edc491ed6120d120d1cabef Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 3 Dec 2025 14:59:22 -0800 Subject: [PATCH 1498/1799] customer question --- docs/windows/latest-supported-vc-redist.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index eb11eb2f471..52e25ecf47b 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -1,7 +1,7 @@ --- title: "Latest supported Visual C++ Redistributable downloads" description: "This article provides download links for the latest Visual C++ Redistributable packages." -ms.date: 11/03/2025 +ms.date: 12/03/2025 helpviewer_keywords: [ "redist", @@ -58,12 +58,12 @@ Download other versions, including long term servicing release channel (LTSC) ve - Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Log in using a Visual Studio Subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or, create a free account by choosing the [**No account? Create one!**](https://my.visualstudio.com/). - The Visual C++ v14 Redistributable doesn't have separate packages for different languages. License terms for different languages are available at [https://aka.ms/VCRedistLicense](https://aka.ms/VCRedistLicense). -- Visual Studio 2017 and later share the same Redistributable files. Any apps built by Microsoft C++ (MSVC) Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. However, the version of the redistributable installed on the machine must be the same or higher than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). +- Visual Studio 2017 and later share the same Redistributable files. Any apps built by Microsoft C++ (MSVC) Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. The version of the redistributable installed on the machine must be the same or higher than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). - The latest version of the Visual C++ v14 Redistributable included with Visual Studio 2026 only supports the following operating systems: * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 - Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version.
-When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built using the VS 2015 MSVC Build Tools. Since VS 2015 is no longer supported, we recommend updating your projects to use a supported MSVC Build Tools version and the latest v14 runtime. +When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built using the VS 2015 MSVC Build Tools. Since VS 2015 is no longer supported, we recommend updating your projects to use a supported MSVC Build Tools version and the latest v14 runtime. The Visual C++ Redistributable for 2017 and beyond is an in-place upgrade of the Visual C++ 2015 Redistributable (14.0.24212.0). - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions From c001077cccf98c3f227890699a4c9cb05f955927 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 3 Dec 2025 15:05:24 -0800 Subject: [PATCH 1499/1799] edit --- docs/windows/latest-supported-vc-redist.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 52e25ecf47b..33c92e2fa76 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -63,7 +63,8 @@ Download other versions, including long term servicing release channel (LTSC) ve * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 - Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version.
-When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built using the VS 2015 MSVC Build Tools. Since VS 2015 is no longer supported, we recommend updating your projects to use a supported MSVC Build Tools version and the latest v14 runtime. The Visual C++ Redistributable for 2017 and beyond is an in-place upgrade of the Visual C++ 2015 Redistributable (14.0.24212.0). +When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built using the VS 2015 MSVC Build Tools. Since VS 2015 is no longer supported, we recommend updating your projects to use a supported MSVC Build Tools version and the latest v14 runtime. The Visual C++ Redistributable for 2017, and later, in-place upgrade the Visual C++ 2015 Redistributable (14.0.24212.0). Redistributables for 2013 and earlier remain installed side-by-side. + - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions From 34c613e966151b32ead7cf3f0c1fc7748f73d4cf Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 3 Dec 2025 16:01:58 -0800 Subject: [PATCH 1500/1799] Improve clarity on generating module trace files Clarified instructions for generating a module trace file and emphasized the importance of reducing code complexity for diagnostics. --- ...ow-to-report-a-problem-with-the-visual-cpp-toolset.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index d3a723c3715..80a3991a305 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -313,13 +313,14 @@ Finally, attach the preprocessed repro files (*filename*.i and *modulename*.i) a #### To generate a module trace file -When issues involve C++ modules, providing a module trace file along with the preprocessed repro improves diagnostic quality and reduces turnaround time. A module trace file records detailed information about module operations during compilation. +When issues involve C++ modules, provide a module trace file along with the preprocessed repro improves diagnostic quality to reduce turnaround time. A module trace file records detailed information about module operations during compilation. -1. In the developer command prompt console window, enter the command **cl /d1module:enableLogging** *trace.json* [*other-args*] *filename.cpp*. For *trace.json*, specify the desired output file name for the module trace. For [*other-args*], include any additional compilation arguments. For *filename.cpp*, specify the source file that reproduces the problem. +It's ideal if the example can be condensed to a single source code file, without reference to any user headers. - > [!IMPORTANT] - > You must compile exactly one source file to collect a module trace. Don't use the **/MP** (multi-processor compilation) option or invoke the compiler with multiple source files. Using **/MP** or multi-source invocations can cause the trace to represent only the last compiled file or be incomplete. +Reducing the amount of code we have to consider as a possible contributor to the problem is enormously helpful to us. Using **/MP** or multi-source invocations can cause the trace to represent only the last compiled file or be incomplete. If you can't reduce the problem to a single source file, package your code into a .zip file or similar, or consider using an IDE project repro. For more information, see [Other repros](#other-repros). +1. Open the **Developer Command Prompt** that matches the Visual Studio version and configuration architecture used to build your project. +1. Enter the command `cl /d1module:enableLogging` *trace.json* [*other-args*] *filename.cpp*. For *trace.json*, specify the desired output file name for the module trace. For [*other-args*], include any additional compilation arguments. For *filename.cpp*, specify the source file that reproduces the problem. 1. If multiple translation units are involved in the problem, run separate single-file invocations to collect a trace for the specific file that reproduces the problem. You can collect traces for additional relevant files if needed. Finally, attach the generated *trace.json* file along with the preprocessed repro to your report. From e928b2871e7e34d0e4572e6c6cf9898995ae775a Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 3 Dec 2025 16:28:14 -0800 Subject: [PATCH 1501/1799] incorp feedback Clarified command syntax --- .../how-to-report-a-problem-with-the-visual-cpp-toolset.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index 80a3991a305..5664f47bcee 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -320,7 +320,7 @@ It's ideal if the example can be condensed to a single source code file, without Reducing the amount of code we have to consider as a possible contributor to the problem is enormously helpful to us. Using **/MP** or multi-source invocations can cause the trace to represent only the last compiled file or be incomplete. If you can't reduce the problem to a single source file, package your code into a .zip file or similar, or consider using an IDE project repro. For more information, see [Other repros](#other-repros). 1. Open the **Developer Command Prompt** that matches the Visual Studio version and configuration architecture used to build your project. -1. Enter the command `cl /d1module:enableLogging` *trace.json* [*other-args*] *filename.cpp*. For *trace.json*, specify the desired output file name for the module trace. For [*other-args*], include any additional compilation arguments. For *filename.cpp*, specify the source file that reproduces the problem. +1. Enter the command `cl /d1module:enableLogging`*trace.json* [*other-args*] *filename.cpp*. For *trace.json*, specify the desired output file name for the module trace. There can't be a space between `/d1module:enableLogging` and the output file name. For [*other-args*], include any additional compilation arguments. For *filename.cpp*, specify the source file that reproduces the problem. 1. If multiple translation units are involved in the problem, run separate single-file invocations to collect a trace for the specific file that reproduces the problem. You can collect traces for additional relevant files if needed. Finally, attach the generated *trace.json* file along with the preprocessed repro to your report. From a5893860a9ccff2d53f568cd8d11b8465617b629 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 4 Dec 2025 15:16:32 -0800 Subject: [PATCH 1502/1799] update style instructions (#6175) --- .github/copilot-instructions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 3f4b335d6c1..7f841f10a41 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -58,7 +58,7 @@ When writing documentation, follow these guidelines: * Code elements, like method names, property names, and language keywords. * SQL commands. * NuGet package names. - * Command-line commands. + * Command-line commands. The style in some articles uses **bold** for command-line commands, but use `code style` instead. * Database table and column names. * Resource names (like virtual machine names) that shouldn't be localized. * URLs that you don't want to be selectable. From a423eba3993d8776f84b6971917159a04daa7782 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 4 Dec 2025 16:40:54 -0800 Subject: [PATCH 1503/1799] draft --- docs/build-insights/elevate-note.md | 23 ++++++++++++++++++ .../build-insights/media/elevation-prompt.png | Bin 0 -> 39001 bytes 2 files changed, 23 insertions(+) create mode 100644 docs/build-insights/elevate-note.md create mode 100644 docs/build-insights/media/elevation-prompt.png diff --git a/docs/build-insights/elevate-note.md b/docs/build-insights/elevate-note.md new file mode 100644 index 00000000000..db97a2378e4 --- /dev/null +++ b/docs/build-insights/elevate-note.md @@ -0,0 +1,23 @@ +--- +title: "Build Insights needs additional permissions" +description: "To capture trace files, Build Insights needs additional permissions as described in this topic." +ms.topic: article +ms.date: 12/04/2025 +ms.update-cycle: 365-days +ms.topic: tutorial +f1_keywords: + - bi_permissions +--- +# Build Insights needs additional permissions + +Starting with Visual Studio 2026, Build Insights and `vcperf` need additional permissions to capture traces. + +To allow build trace capture by `vcperf`, please accept the one time, per user, elevated prompt that appears when you first attempt to capture a trace: + +:::image type="content" source="./media/elevation-prompt.png" alt-text="A screenshot of the elevation prompt. It says: To capture trace files, Build Insights needs additional permisisons. Allow this one-time elevated request?"::: + +After you accept the elevation request, you'll be able to capture trace files with `vcperf`. Once you accept this elevation request, you won't need to do it again. Accepting this request doesn't elevate permissions for Visual Studio. It only elevates permissions for `vcperf` to capture traces. + +## See also + +[Get started with C++ Build Insights](../get-started-with-cpp-build-insights.md) \ No newline at end of file diff --git a/docs/build-insights/media/elevation-prompt.png b/docs/build-insights/media/elevation-prompt.png new file mode 100644 index 0000000000000000000000000000000000000000..619c2999d87d8616b750446d6504e7df80725a30 GIT binary patch literal 39001 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 M%`9O}CeAVc4{ZLM=Kufz literal 0 HcmV?d00001 From cc4b27fae8aeb3970f1798941d091d8f40fc3407 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 4 Dec 2025 16:53:16 -0800 Subject: [PATCH 1504/1799] fix links --- docs/build-insights/elevate-note.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/build-insights/elevate-note.md b/docs/build-insights/elevate-note.md index db97a2378e4..a7bef19b663 100644 --- a/docs/build-insights/elevate-note.md +++ b/docs/build-insights/elevate-note.md @@ -4,7 +4,6 @@ description: "To capture trace files, Build Insights needs additional permission ms.topic: article ms.date: 12/04/2025 ms.update-cycle: 365-days -ms.topic: tutorial f1_keywords: - bi_permissions --- @@ -20,4 +19,4 @@ After you accept the elevation request, you'll be able to capture trace files wi ## See also -[Get started with C++ Build Insights](../get-started-with-cpp-build-insights.md) \ No newline at end of file +[Get started with C++ Build Insights](get-started-with-cpp-build-insights.md) \ No newline at end of file From 7d5b27e69c35f5c398ffb27f52464e617df41003 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 5 Dec 2025 13:50:41 -0800 Subject: [PATCH 1505/1799] Update date and wording in C2290 error documentation minor edit --- .../compiler-errors-1/compiler-error-c2290.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md index 66b814f4caf..41f755959b1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2290" description: "Learn more about: Compiler Error C2290" -ms.date: 08/23/2025 +ms.date: 12/5/2025 f1_keywords: ["C2290"] helpviewer_keywords: ["C2290"] --- @@ -11,7 +11,7 @@ helpviewer_keywords: ["C2290"] ## Remarks -The **`asm`** syntax is reserved for future use, try [`__asm`](../../assembler/inline/asm.md) instead. For more information, see [Inline Assembler](../../assembler/inline/inline-assembler.md). +The **`asm`** syntax is reserved for future use. Try [`__asm`](../../assembler/inline/asm.md) instead. For more information, see [Inline Assembler](../../assembler/inline/inline-assembler.md). ## Example @@ -19,11 +19,11 @@ The following example generates C2290: ```cpp // C2290.cpp -// processor: x86 +// Compile for 32 bit, i.e. x86 instead of x64 int main() { asm("nop"); // C2290 - __asm nop // OK + __asm { nop } // OK } ``` From 3b3f65c5b12da8c993281681ab3725bf3fee644c Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 5 Dec 2025 15:10:28 -0800 Subject: [PATCH 1506/1799] Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/standard-library/basic-string-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index bb063741d04..d3fcc17efe1 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -417,7 +417,7 @@ int main( ) << str1a << "." << endl << endl; // The second member function assigning a specific - // number of the characters of a C-string to a string + // number of characters of a C-string to a string string str1b; const char *cstr1b = "Out There"; cout << "The C-string cstr1b is: " << cstr1b << endl; From 5dd06e81bd06afa5c93315f9996f880acb22cbe5 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 5 Dec 2025 15:47:13 -0800 Subject: [PATCH 1507/1799] Update compiler-error-c2033.md For clarity, removed example that generates two errors: C2531 and C2033 --- docs/error-messages/compiler-errors-1/compiler-error-c2033.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 3af050bc1ef..110b499acd5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -24,7 +24,6 @@ The following example generates C2033: struct S { int* ptr : 1; // C2033 - int& ref : 1; // C2033 int arr[3] : 1; // C2033 }; ``` From 5175ad67713c4c368a8aa9b707b0dec0444dad01 Mon Sep 17 00:00:00 2001 From: jdp_ <42700985+jdpatdiscord@users.noreply.github.com> Date: Mon, 8 Dec 2025 12:22:53 -0500 Subject: [PATCH 1508/1799] add clarification to example --- docs/cpp/ptr32-ptr64.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/ptr32-ptr64.md b/docs/cpp/ptr32-ptr64.md index 08fc2cedc23..065deb056e2 100644 --- a/docs/cpp/ptr32-ptr64.md +++ b/docs/cpp/ptr32-ptr64.md @@ -28,7 +28,7 @@ For compatibility with previous versions, **_ptr32** and **_ptr64** are synonyms ## Example -The following example shows how to declare and allocate pointers with the **`__ptr32`** and **`__ptr64`** keywords. +The following example shows how to declare and allocate pointers with the **`__ptr32`** and **`__ptr64`** keywords. This code will crash when compiled for 64-bit due to the pointer from `malloc` being truncated to 32-bit. Since 32-bit pointers can be represented in 64-bit, when compiled for 32-bit this code does not necessarily crash. ```cpp #include From ae515d700ed5ec666d3142e632d772e6dc93779f Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Mon, 8 Dec 2025 16:06:12 -0800 Subject: [PATCH 1509/1799] Document $(ShortProjectName). Created an entry in the list and added to helpviewer_keywords --- .../common-macros-for-build-commands-and-properties.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/build/reference/common-macros-for-build-commands-and-properties.md b/docs/build/reference/common-macros-for-build-commands-and-properties.md index dfe8c6a5c01..bb52c1458b4 100644 --- a/docs/build/reference/common-macros-for-build-commands-and-properties.md +++ b/docs/build/reference/common-macros-for-build-commands-and-properties.md @@ -2,7 +2,7 @@ description: "Learn more about: Common macros for MSBuild commands and properties" title: "Common macros for MSBuild commands and properties" ms.date: 01/12/2024 -helpviewer_keywords: ["$(FrameworkSDKDir) macro", "ProjectName macro $(ProjectName)", "DevEnvDir macro $(DevEnvDir)", "$(DevEnvDir) macro", "TargetPath macro $(TargetPath)", "VSInstallDir macro $(VSInstallDir)", "$(InputFileName) macro", "$(SolutionFileName) macro", "macros [C++], build macros", "InputFileName macro $(InputFileName)", "$(VCInstallDir) macro", "$(IntDir) macro", "$(ConfigurationName) macro", "SolutionDir macro $(SolutionDir)", "$(TargetPath) macro", "$(Inherit) macro", "$(SolutionPath) macro", "WebDeployRoot macro $(WebDeployRoot)", "WebDeployPath macro $(WebDeployPath)", "StopEvaluating macro $(StopEvaluating)", "$(RootNamespace) macro", "$(WebDeployRoot) macro", "ProjectPath macro $(ProjectPath)", "$(ProjectPath) macro", "$(InputDir) macro", "SolutionName macro $(SolutionName)", "ProjectExt macro $(ProjectExt)", "$(TargetExt) macro", "$(ProjectFileName) macro", "TargetName macro $(TargetName)", "$(References) macro", "References macro $(References)", "TargetExt macro $(TargetExt)", "ProjectDir macro $(ProjectDir)", "$(TargetDir) macro", "SolutionExt macro $(SolutionExt)", "$(SolutionDir) macro", "ProjectFileName macro $(ProjectFileName)", "VCInstallDir macro $(VCInstallDir)", "$(InputExt) macro", "$(TargetFileName) macro", "$(SolutionExt) macro", "PlatformName macro $(PlatformName)", "IntDir macro $(IntDir)", "$(FrameworkVersion) macro", "$(ProjectDir) macro", "build macros [C++]", "InputPath macro $(InputPath)", "$(VSInstallDir) macro", "$(WebDeployPath) macro", "TargetFileName macro $(TargetFileName)", "NoInherit macro $(NoInherit)", "ConfigurationName macro $(ConfigurationName)", "$(ProjectExt) macro", "TargetDir macro $(TargetDir)", "InputName macro $(InputName)", "$(ProjectName) macro", "FrameworkSDKDir macro $(FrameworkSDKDir)", "$(ParentName) macro", "InputExt macro $(InputExt)", "$(SafeRootNamespace) macro", "InputDir macro $(InputDir)", "$(FxCopDir) macro", "$(RemoteMachine) macro", "Inherit macro $(Inherit)", "FrameworkVersion macro $(FrameworkVersion)", "$(StopEvaluating) macro", "$(OutDir) macro", "FrameworkDir macro $(FrameworkDir)", "SolutionFileName macro $(SolutionFileName)", "$(NoInherit) macro", "RemoteMachine macro $(RemoteMachine)", "properties [C++], build property macros", "$(TargetName) macro", "$(SolutionName) macro", "$(InputPath) macro", "ParentName macro $(ParentName)", "OutDir macro $(OutDir)", "SafeRootNamespace macro $(SafeRootNamespace)", "FxCopDir macro $(FxCopDir)", "$(InputName) macro", "RootNamespace macro $(RootNamespace)", "builds [C++], macros", "$(FrameworkDir) macro", "$(PlatformName) macro", "$(PlatformShortName) macro","SolutionPath macro $(SolutionPath)"] +helpviewer_keywords: ["$(FrameworkSDKDir) macro", "ProjectName macro $(ProjectName)", "DevEnvDir macro $(DevEnvDir)", "$(DevEnvDir) macro", "TargetPath macro $(TargetPath)", "VSInstallDir macro $(VSInstallDir)", "$(InputFileName) macro", "$(SolutionFileName) macro", "macros [C++], build macros", "InputFileName macro $(InputFileName)", "$(VCInstallDir) macro", "$(IntDir) macro", "$(ConfigurationName) macro", "SolutionDir macro $(SolutionDir)", "$(TargetPath) macro", "$(Inherit) macro", "$(SolutionPath) macro", "WebDeployRoot macro $(WebDeployRoot)", "WebDeployPath macro $(WebDeployPath)", "StopEvaluating macro $(StopEvaluating)", "$(RootNamespace) macro", "$(WebDeployRoot) macro", "ProjectPath macro $(ProjectPath)", "$(ProjectPath) macro", "$(InputDir) macro", "SolutionName macro $(SolutionName)", "ProjectExt macro $(ProjectExt)", "$(TargetExt) macro", "$(ProjectFileName) macro", "TargetName macro $(TargetName)", "$(References) macro", "References macro $(References)", "TargetExt macro $(TargetExt)", "ProjectDir macro $(ProjectDir)", "$(TargetDir) macro", "SolutionExt macro $(SolutionExt)", "$(SolutionDir) macro", "ProjectFileName macro $(ProjectFileName)", "VCInstallDir macro $(VCInstallDir)", "$(InputExt) macro", "$(TargetFileName) macro", "$(SolutionExt) macro", "PlatformName macro $(PlatformName)", "IntDir macro $(IntDir)", "$(FrameworkVersion) macro", "$(ProjectDir) macro", "build macros [C++]", "InputPath macro $(InputPath)", "$(VSInstallDir) macro", "$(WebDeployPath) macro", "TargetFileName macro $(TargetFileName)", "NoInherit macro $(NoInherit)", "ConfigurationName macro $(ConfigurationName)", "$(ProjectExt) macro", "TargetDir macro $(TargetDir)", "InputName macro $(InputName)", "$(ProjectName) macro", "FrameworkSDKDir macro $(FrameworkSDKDir)", "$(ParentName) macro", "InputExt macro $(InputExt)", "$(SafeRootNamespace) macro", "InputDir macro $(InputDir)", "$(FxCopDir) macro", "$(RemoteMachine) macro", "Inherit macro $(Inherit)", "FrameworkVersion macro $(FrameworkVersion)", "$(StopEvaluating) macro", "$(OutDir) macro", "FrameworkDir macro $(FrameworkDir)", "SolutionFileName macro $(SolutionFileName)", "$(NoInherit) macro", "RemoteMachine macro $(RemoteMachine)", "properties [C++], build property macros", "$(TargetName) macro", "$(SolutionName) macro", "$(InputPath) macro", "ParentName macro $(ParentName)", "OutDir macro $(OutDir)", "SafeRootNamespace macro $(SafeRootNamespace)", "FxCopDir macro $(FxCopDir)", "$(InputName) macro", "RootNamespace macro $(RootNamespace)", "builds [C++], macros", "$(FrameworkDir) macro", "$(PlatformName) macro", "$(PlatformShortName) macro","SolutionPath macro $(SolutionPath)", "ShortProjectName macro $(ShortProjectName)"] --- # Common macros for MSBuild commands and properties @@ -44,6 +44,7 @@ This table describes a commonly used subset of the available macros; there are m | **`$(ProjectExt)`** | The file extension of the project. It includes the '.' before the file extension. | | **`$(ProjectFileName)`** | The file name of the project (defined as base name + file extension). | | **`$(ProjectName)`** | The base name of the project. | +| **`$(ShortProjectName)`** | Shortened project name used when `IntDir` is unset; defaults to `$(ProjectName)` but truncates long names to `ProjectName.Substring(0,8).ProjectGuid.Substring(1,8)` to keep intermediate paths short and unique. | | **`$(ProjectPath)`** | The absolute path name of the project (defined as drive + path + base name + file extension). | | **`$(PublishDir)`** | The output location for the publish target; includes the trailing backslash (\\). Defaults to the **`$(OutDir)app.publish\`** folder. | | **`$(RemoteMachine)`** | Set to the value of the **Remote Machine** property on the Debug property page. For more information, see [Changing Project Settings for a C/C++ Debug Configuration](/visualstudio/debugger/project-settings-for-a-cpp-debug-configuration). | From 774abf6864f160d3b89fd05c1c911da20f85630f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 9 Dec 2025 09:31:40 -0800 Subject: [PATCH 1510/1799] acrolinx --- docs/build-insights/elevate-note.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/build-insights/elevate-note.md b/docs/build-insights/elevate-note.md index a7bef19b663..5712680839b 100644 --- a/docs/build-insights/elevate-note.md +++ b/docs/build-insights/elevate-note.md @@ -2,20 +2,20 @@ title: "Build Insights needs additional permissions" description: "To capture trace files, Build Insights needs additional permissions as described in this topic." ms.topic: article -ms.date: 12/04/2025 +ms.date: 12/9/2025 ms.update-cycle: 365-days f1_keywords: - bi_permissions --- # Build Insights needs additional permissions -Starting with Visual Studio 2026, Build Insights and `vcperf` need additional permissions to capture traces. +Starting with Visual Studio 2026, Build Insights and `vcperf` need extra permissions to capture traces. -To allow build trace capture by `vcperf`, please accept the one time, per user, elevated prompt that appears when you first attempt to capture a trace: +To allow `vcperf` to capture build traces, please accept the one time, per user, elevated prompt that appears when you first attempt to capture a trace: :::image type="content" source="./media/elevation-prompt.png" alt-text="A screenshot of the elevation prompt. It says: To capture trace files, Build Insights needs additional permisisons. Allow this one-time elevated request?"::: -After you accept the elevation request, you'll be able to capture trace files with `vcperf`. Once you accept this elevation request, you won't need to do it again. Accepting this request doesn't elevate permissions for Visual Studio. It only elevates permissions for `vcperf` to capture traces. +Once you accept this elevation request, you can capture trace files with `vcperf`. You won't be prompted again to elevate permissions again. Accepting this request doesn't elevate permissions for Visual Studio--only for `vcperf` so it can to capture traces. ## See also From ef0304f7fca7eddab3dd264f1d2e5b2509c9b805 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 9 Dec 2025 09:32:23 -0800 Subject: [PATCH 1511/1799] spelling --- docs/build-insights/elevate-note.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/elevate-note.md b/docs/build-insights/elevate-note.md index 5712680839b..058252e52ba 100644 --- a/docs/build-insights/elevate-note.md +++ b/docs/build-insights/elevate-note.md @@ -13,7 +13,7 @@ Starting with Visual Studio 2026, Build Insights and `vcperf` need extra permiss To allow `vcperf` to capture build traces, please accept the one time, per user, elevated prompt that appears when you first attempt to capture a trace: -:::image type="content" source="./media/elevation-prompt.png" alt-text="A screenshot of the elevation prompt. It says: To capture trace files, Build Insights needs additional permisisons. Allow this one-time elevated request?"::: +:::image type="content" source="./media/elevation-prompt.png" alt-text="A screenshot of the elevation prompt. It says: To capture trace files, Build Insights needs additional permissions. Allow this one-time elevated request?"::: Once you accept this elevation request, you can capture trace files with `vcperf`. You won't be prompted again to elevate permissions again. Accepting this request doesn't elevate permissions for Visual Studio--only for `vcperf` so it can to capture traces. From 615815f97b45874deaf7c50d097b1e664f997462 Mon Sep 17 00:00:00 2001 From: Hulon Jenkins <109993038+HulonJenkins@users.noreply.github.com> Date: Tue, 9 Dec 2025 13:16:08 -0800 Subject: [PATCH 1512/1799] Add documentation for [[msvc::musttail]] attribute (#5862) * Add documentation for [[msvc::musttail]] attribute --------- Co-authored-by: Tyler Whitney --- docs/cpp/attributes.md | 56 +++++++++++++++++++++++++++++++++++++++--- 1 file changed, 53 insertions(+), 3 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 8ed976529a0..9a45ef04e6f 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -1,9 +1,9 @@ --- title: "Attributes in C++" description: "Learn more about: Attributes in C++" -f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard"] -helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard"] -ms.date: 4/13/2023 +f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] +helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] +ms.date: 12/9/2025 --- # Attributes in C++ @@ -159,6 +159,56 @@ void f() { } ``` +### `[[msvc::musttail]]` + +The `[[msvc::musttail]]` attribute, introduced in [MSVC Build Tools version 14.50](../overview/what-s-new-for-msvc.md#whats-new-for-msvc-build-tools-version-1450), is an experimental x64-only Microsoft-specific attribute that enforces tail-call optimization. When applied to a qualifying return statement, it instructs the compiler to emit the call as a tail call. If the compiler can't emit the tail call, it produces a compilation error. The `[[msvc::musttail]]` attribute enforces a tail call instead of inlining the function. + +`[[msvc::musttail]]` requirements: +- The caller and callee must have matching return types. +- The calling conventions must be compatible. +- The tail call must be the final action in the calling function. +- The callee can't use more stack space than the calling function. +- If more than four integer parameters are passed, the calling function must allocate enough stack space for those additional arguments. +- Compile with `/O2` or `/O2 /GL` optimization level. + +#### Example + +Tail calls are a compiler optimization that is possible when a function call is the last action performed before returning. Instead of creating a new stack frame to call the function, the current function's stack frame is reused. This reduces stack usage and improves performance—especially in recursive scenarios. + +In the following code, the `[[msvc::musttail]]` attribute applied to `return increment(x)` causes control to transfer directly to `increment`. When `increment` reaches the `return x+1;` statement, its result is provided directly to the caller of `incrementIfPositive`, that is `main`. This replaces inlining `increment` into `incrementIfPositive` or calling `increment` from `incrementIfPositive` and returning to `incrementIfPositive` before returning to `main`. The tail call optimization eliminates the need for `incrementIfPositive` to regain control after `increment` finishes. This is a performance optimization that reduces stack usage, especially useful in recursive scenarios. + +```cpp +// compile with /O2 +#include + +int increment(int x) +{ + return x + 1; +} + +int incrementIfPositive(int x) +{ + if (x > 0) + { + [[msvc::musttail]] + return increment(x); + } + return -1; +} + +int main() +{ + int result = incrementIfPositive(42); + if (result < 0) + { + return -1; + } + + std::cout << result; // outputs 43 + return 0; +} +``` + ### `[[msvc::noinline]]` When placed before a function declaration, the Microsoft-specific attribute `[[msvc::noinline]]` has the same meaning as `__declspec(noinline)`. From ca52ece856a120af87a99f3228d555c283e80fcf Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 11 Dec 2025 09:05:17 -0800 Subject: [PATCH 1513/1799] add metadata --- docs/build/use-github-copilot-create-cpp-console-app.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/build/use-github-copilot-create-cpp-console-app.md b/docs/build/use-github-copilot-create-cpp-console-app.md index b70ab460381..1af34386ebc 100644 --- a/docs/build/use-github-copilot-create-cpp-console-app.md +++ b/docs/build/use-github-copilot-create-cpp-console-app.md @@ -6,6 +6,8 @@ ms.topic: "tutorial" ms.custom: - ai-assisted - copilot-scenario-highlight + - ce-skilling-ai-copilot + - ms.update-cycle: 180 days --- # Use AI to create a C++ console application in Visual Studio From e57fbfc2bcee00edcf8c6ced0bafb8ca43ebc7bc Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 11 Dec 2025 09:20:06 -0800 Subject: [PATCH 1514/1799] update metadata (#6186) --- docs/build-insights/elevate-note.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/elevate-note.md b/docs/build-insights/elevate-note.md index 058252e52ba..502e2087fef 100644 --- a/docs/build-insights/elevate-note.md +++ b/docs/build-insights/elevate-note.md @@ -3,7 +3,7 @@ title: "Build Insights needs additional permissions" description: "To capture trace files, Build Insights needs additional permissions as described in this topic." ms.topic: article ms.date: 12/9/2025 -ms.update-cycle: 365-days +ms.update-cycle: 3650-days f1_keywords: - bi_permissions --- From 8402f01dad74a9b3c234f597df5bdfb0d93fa9c1 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 11 Dec 2025 11:20:02 -0800 Subject: [PATCH 1515/1799] add PM note --- docs/build/clang-support-msbuild.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/build/clang-support-msbuild.md b/docs/build/clang-support-msbuild.md index 6e44fbb42ab..c8e52173a4a 100644 --- a/docs/build/clang-support-msbuild.md +++ b/docs/build/clang-support-msbuild.md @@ -1,7 +1,7 @@ --- title: "Clang/LLVM support in Visual Studio projects" description: "Learn more about: Clang/LLVM support in Visual Studio projects" -ms.date: 03/13/2024 +ms.date: 12/11/2025 ms.description: "Configure a Visual Studio MSBuild project to use the Clang/LLVM toolchain." helpviewer_keywords: ["Clang support for C++ MSBuild projects"] --- @@ -49,6 +49,10 @@ The Individual components tab is selected in the installer. C++ Clang Compiler f ::: moniker range=">=msvc-160" Later versions of Visual Studio provide newer versions of the Clang toolset. The bundled version of Clang gets updated automatically to stay current with updates in the Microsoft implementation of the Standard Library. For example, Visual Studio 2019 version 16.11 includes Clang v12. +The LLVM experience in Visual Studio delivers seamless build support, project system integration, and design-time features that work with your choice of LLVM distributions. For acquisition convenience, we provide an optional LLVM binary distribution with Visual Studio. This LLVM toolset is provided as-is, sourced directly from the [LLVM Foundation’s release page](https://github.com/llvm/llvm-project/releases) without modifications by Microsoft. The installed binaries, are digitally signed with a third-party Microsoft code signing certificate to mark their third-party status and to confirm that they were obtained from the LLVM Foundation’s release page. + +LLVM updates in Visual Studio are typically aligned with major LLVM releases ahead of a Visual Studio general release. However, if the community or partners report security or critical blocking issues that were addressed in a minor LLVM release, we prioritize updating the bundled LLVM toolset to a newer minor version containing the fix. Visual Studio’s build and project system supports using your own custom LLVM installation if needed. + ## Configure a Windows project to use Clang tools To configure a Visual Studio project to use Clang, right-click on the project node in **Solution Explorer** and choose **Properties**. Typically, you should first choose **All configurations** at the top of the dialog. Then, under **General** > **Platform Toolset**, choose **LLVM (clang-cl)** and then **OK**. From d97a5ae668efc9d865ddd02197a3e4c962b2d539 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 11 Dec 2025 14:59:46 -0800 Subject: [PATCH 1516/1799] metadata update --- docs/build/use-github-copilot-create-cpp-console-app.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/use-github-copilot-create-cpp-console-app.md b/docs/build/use-github-copilot-create-cpp-console-app.md index 1af34386ebc..49d4b8c3687 100644 --- a/docs/build/use-github-copilot-create-cpp-console-app.md +++ b/docs/build/use-github-copilot-create-cpp-console-app.md @@ -3,11 +3,11 @@ title: Use AI to create a C++ console application in Visual Studio description: "Learn how to use GitHub Copilot to create a C++ app using Microsoft C++ in Visual Studio." ms.date: 10/24/2025 ms.topic: "tutorial" +ms.collection: ce-skilling-ai-copilot ms.custom: - ai-assisted - copilot-scenario-highlight - - ce-skilling-ai-copilot - - ms.update-cycle: 180 days +ms.update-cycle: "180 days" --- # Use AI to create a C++ console application in Visual Studio From d21d6349860b2002d2ca829a08c6974d906d9be2 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 11 Dec 2025 15:09:24 -0800 Subject: [PATCH 1517/1799] fix metadata --- docs/build/use-github-copilot-create-cpp-console-app.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/use-github-copilot-create-cpp-console-app.md b/docs/build/use-github-copilot-create-cpp-console-app.md index 49d4b8c3687..ab3637cfa2b 100644 --- a/docs/build/use-github-copilot-create-cpp-console-app.md +++ b/docs/build/use-github-copilot-create-cpp-console-app.md @@ -7,7 +7,7 @@ ms.collection: ce-skilling-ai-copilot ms.custom: - ai-assisted - copilot-scenario-highlight -ms.update-cycle: "180 days" +ms.update-cycle: 180-days --- # Use AI to create a C++ console application in Visual Studio From d10db64b9b10aadbd045de9cd098d8bb56a171da Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 11 Dec 2025 16:42:38 -0800 Subject: [PATCH 1518/1799] acronlix --- docs/build/clang-support-msbuild.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/build/clang-support-msbuild.md b/docs/build/clang-support-msbuild.md index c8e52173a4a..a4150714fb9 100644 --- a/docs/build/clang-support-msbuild.md +++ b/docs/build/clang-support-msbuild.md @@ -49,9 +49,9 @@ The Individual components tab is selected in the installer. C++ Clang Compiler f ::: moniker range=">=msvc-160" Later versions of Visual Studio provide newer versions of the Clang toolset. The bundled version of Clang gets updated automatically to stay current with updates in the Microsoft implementation of the Standard Library. For example, Visual Studio 2019 version 16.11 includes Clang v12. -The LLVM experience in Visual Studio delivers seamless build support, project system integration, and design-time features that work with your choice of LLVM distributions. For acquisition convenience, we provide an optional LLVM binary distribution with Visual Studio. This LLVM toolset is provided as-is, sourced directly from the [LLVM Foundation’s release page](https://github.com/llvm/llvm-project/releases) without modifications by Microsoft. The installed binaries, are digitally signed with a third-party Microsoft code signing certificate to mark their third-party status and to confirm that they were obtained from the LLVM Foundation’s release page. +The LLVM experience in Visual Studio delivers seamless build support, project system integration, and design-time features that work with your choice of LLVM distributions. For acquisition convenience, we provide an optional LLVM binary distribution with Visual Studio. This LLVM toolset is provided as-is, sourced directly from the [LLVM Foundation’s release page](https://github.com/llvm/llvm-project/releases) without modifications by Microsoft. The installed binaries are digitally signed with a third-party Microsoft code signing certificate to mark their third-party status and to confirm that they were obtained from the LLVM Foundation’s release page. -LLVM updates in Visual Studio are typically aligned with major LLVM releases ahead of a Visual Studio general release. However, if the community or partners report security or critical blocking issues that were addressed in a minor LLVM release, we prioritize updating the bundled LLVM toolset to a newer minor version containing the fix. Visual Studio’s build and project system supports using your own custom LLVM installation if needed. +LLVM updates in Visual Studio are typically aligned with major LLVM releases ahead of a Visual Studio general release. However, if the community or partners report security or critical blocking issues that addressed in a minor LLVM release, we prioritize updating the bundled LLVM toolset to a newer minor version containing the fix. Visual Studio’s build and project system supports using your own custom LLVM installation if needed. ## Configure a Windows project to use Clang tools @@ -115,12 +115,12 @@ When you add a `Directory.build.props` file to a project or solution, the settin ## Set properties, edit, build, and debug -After you have set up a Clang configuration, right-click again on the project node and choose **Reload project**. You can now build and debug the project using the Clang tools. Visual Studio detects that you're using the Clang compiler and provides IntelliSense, highlighting, navigation, and other editing features. Errors and warnings are displayed in the **Output Window**. The project property pages for a Clang configuration are similar to the ones for MSVC. However, some compiler-dependent features such as Edit and Continue aren't available for Clang configurations. You can set a Clang compiler or linker option that isn't available in the property pages. Add it manually in the property pages under **Configuration Properties** > **C/C++ (or Linker)** > **Command Line** > **Additional Options**. +After you set up a Clang configuration, right-click again on the project node and choose **Reload project**. You can now build and debug the project using the Clang tools. Visual Studio detects that you're using the Clang compiler and provides IntelliSense, highlighting, navigation, and other editing features. Errors and warnings are displayed in the **Output Window**. The project property pages for a Clang configuration are similar to the ones for MSVC. However, some compiler-dependent features such as Edit and Continue aren't available for Clang configurations. You can set a Clang compiler or linker option that isn't available in the property pages. Add it manually in the property pages under **Configuration Properties** > **C/C++ (or Linker)** > **Command Line** > **Additional Options**. When debugging, you can use breakpoints, memory and data visualization, and most other debugging features. :::image type="complex" source="media/clang-debug-msbuild.png" alt-text="Screenshot of Visual Studio debugging a sample app"::: -The portion of the app that is visible creates a string vector and adds some strings to it. Execution has stopped on a breakpoint for the code: v.push_back("Clang/LLVM");. +The portion of the app that's visible creates a string vector and adds some strings to it. Execution stopped on a breakpoint for the code v.push_back("Clang/LLVM");. :::image-end::: ::: moniker-end From b518ede11fd5b04026bb8c1dd48b7e4c4f27c07f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 11 Dec 2025 16:43:57 -0800 Subject: [PATCH 1519/1799] typo --- docs/build/clang-support-msbuild.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/clang-support-msbuild.md b/docs/build/clang-support-msbuild.md index a4150714fb9..8741b608e9b 100644 --- a/docs/build/clang-support-msbuild.md +++ b/docs/build/clang-support-msbuild.md @@ -51,7 +51,7 @@ Later versions of Visual Studio provide newer versions of the Clang toolset. The The LLVM experience in Visual Studio delivers seamless build support, project system integration, and design-time features that work with your choice of LLVM distributions. For acquisition convenience, we provide an optional LLVM binary distribution with Visual Studio. This LLVM toolset is provided as-is, sourced directly from the [LLVM Foundation’s release page](https://github.com/llvm/llvm-project/releases) without modifications by Microsoft. The installed binaries are digitally signed with a third-party Microsoft code signing certificate to mark their third-party status and to confirm that they were obtained from the LLVM Foundation’s release page. -LLVM updates in Visual Studio are typically aligned with major LLVM releases ahead of a Visual Studio general release. However, if the community or partners report security or critical blocking issues that addressed in a minor LLVM release, we prioritize updating the bundled LLVM toolset to a newer minor version containing the fix. Visual Studio’s build and project system supports using your own custom LLVM installation if needed. +LLVM updates in Visual Studio are typically aligned with major LLVM releases ahead of a Visual Studio general release. However, if the community or partners report security or critical blocking issues addressed in a minor LLVM release, we prioritize updating the bundled LLVM toolset to a newer minor version containing the fix. Visual Studio’s build and project system supports using your own custom LLVM installation if needed. ## Configure a Windows project to use Clang tools From 3a662519b92860feba06a923ddf2355f086b85f9 Mon Sep 17 00:00:00 2001 From: Takashi Takebayashi Date: Sat, 13 Dec 2025 10:40:39 +0900 Subject: [PATCH 1520/1799] Fix typo: trough -> through (#5867) --- docs/build-insights/reference/sdk/functions/relog.md | 2 +- .../reference/sdk/functions/stop-and-relog-tracing-session.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build-insights/reference/sdk/functions/relog.md b/docs/build-insights/reference/sdk/functions/relog.md index 4bf0bb1dcee..c68f319545d 100644 --- a/docs/build-insights/reference/sdk/functions/relog.md +++ b/docs/build-insights/reference/sdk/functions/relog.md @@ -75,7 +75,7 @@ A result code from the [`RESULT_CODE`](../other-types/result-code-enum.md) enum. ### Remarks -The input trace is passed through the analyzer group *`numberOfAnalysisPasses`* times. There's no similar option for relogging passes. The trace is passed trough the relogger group only once, after all analysis passes are complete. +The input trace is passed through the analyzer group *`numberOfAnalysisPasses`* times. There's no similar option for relogging passes. The trace is passed through the relogger group only once, after all analysis passes are complete. The relogging of system events like CPU samples from within a relogger class isn't supported. Use the *`systemEventsRetentionFlags`* parameter to decide which system events to keep in the output trace. diff --git a/docs/build-insights/reference/sdk/functions/stop-and-relog-tracing-session.md b/docs/build-insights/reference/sdk/functions/stop-and-relog-tracing-session.md index b89dc7f62f5..10f6b58ae14 100644 --- a/docs/build-insights/reference/sdk/functions/stop-and-relog-tracing-session.md +++ b/docs/build-insights/reference/sdk/functions/stop-and-relog-tracing-session.md @@ -72,7 +72,7 @@ A result code from the [RESULT_CODE](../other-types/result-code-enum.md) enum. ### Remarks -The input trace is passed through the analyzer group *numberOfAnalysisPasses* times. There's no similar option for relogging passes. The trace is passed trough the relogger group only once, after all analysis passes are complete. +The input trace is passed through the analyzer group *numberOfAnalysisPasses* times. There's no similar option for relogging passes. The trace is passed through the relogger group only once, after all analysis passes are complete. The relogging of system events like CPU samples from within a relogger class isn't supported. Use the *systemEventsRetentionFlags* parameter to decide which system events to keep in the output trace. From 4fd4f59f533788f20b190f79f1efb445faed9c0b Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 12 Dec 2025 18:37:08 -0800 Subject: [PATCH 1521/1799] Copilotinstructions (#6194) * draft1 * new copilot instructions. Includes for triaging issues. --- .github/copilot-instructions.md | 253 +++++++++++------- .../copilot-issue-verification-action-plan.md | 220 +++++++++++++++ .vscode/settings.json | 5 +- 3 files changed, 382 insertions(+), 96 deletions(-) create mode 100644 .github/copilot-issue-verification-action-plan.md diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 7f841f10a41..417f80a8da9 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -1,120 +1,183 @@ -When writing documentation, follow these guidelines: - -## General style tips - -* Get to the point fast. Be concise and clear. -* Talk like a person. -* Simpler is better. -* Be brief. Give customers just enough information to make decisions confidently. Prune excess words. -* Break up long sentences. -* Follow the style of the [Microsoft Writing Style Guide](https://learn.microsoft.com/style-guide/welcome/). If there's a conflict between the following guidelines and the Microsoft Writing Style Guide, ask how to resolve it. - -## Grammar - -* Avoid "we"/"our" referring to documentation authors -* Use present tense verbs (is, open) instead of past tense (was, opened). For example, "The method returns a value" instead of "The method will return a value." -* Write factual statements and direct commands. Avoid hypotheticals. -* Use active voice where the subject performs the action. -* Write in second person (you) to speak directly to readers. -* Use gender-neutral language. -* Avoid multiple -ing words that could create ambiguity. -* Keep prepositional phrases simple and clear. -* Place modifiers close to what they modify. -* Use a conversational tone with contractions. -* Don't use "we" or "our" to refer to the authors of the documentation. -* Use the imperative mood for instructions. For example, "Call the method" instead of "You should call the method." -* Use "might" instead of "may" to indicate possibility. For example, "This method might throw an exception" instead of "This method may throw an exception." -* Use the Oxford comma in lists of three or more items. +# Copilot Instructions for `cpp-docs-pr` + +## Introduction + +This document contains general and repository-specific instructions for GitHub Copilot when assisting with the `cpp-docs-pr` repository. + +## Priority Levels + +This document uses the following markers to indicate instruction priority: + +- **[REQUIRED]** - Must be followed. May cause build failures or PR blocks if violated +- **[STYLE]** - Microsoft Writing Style Guide requirement for consistency +- **[C++-SPECIFIC]** - C++ documentation convention that overrides general guidance +- No marker - Best practice recommendation; use judgment based on context + +## General Guidelines + +### 1. Issue Handling +When creating a PR for an issue: +- [ ] Read the full issue and all linked references + - [ ] **new-feature:** State which version introduced the feature + - [ ] **bug:** Focus on correcting technical inaccuracies +- [ ] When you're assigned an issue, after you've completed your work and the workflows (status checks) have run, ensure there are no build warnings under the OpenPublishing.Build status check. If there are, open the build report (under View Details) and resolve any build warnings you introduced. +- [ ] When starting work on an issue, document your understanding in a comment: state the issue's purpose, expected outcome, and your implementation approach. + +### 2. Issue Discussion Analysis +When working on an issue: +- [ ] **Read the complete issue discussion** - Don't rely solely on the initial issue description +- [ ] **Prioritize maintainer guidance** - Comments from repository maintainers (especially those with "MEMBER" association) should take precedence over the original issue description +- [ ] **Look for updated analysis** - Later comments may contain revised understanding, additional context, or modified resolution approaches +- [ ] **Check for explicit instructions** - Look for phrases like "Action required by GitHub Copilot" or direct "@copilot" mentions that provide specific guidance +- [ ] **Validate your understanding** - If the discussion seems to contradict the initial issue description, follow the most recent maintainer guidance + +### 3. File Naming and Organization +**Naming conventions:** +- [ ] Name new Markdown files in all lowercase with hyphens separating words +- [ ] Omit filler words like "the" or "a" from file names + +**Folder structure:** +- [ ] Linux topics → `docs/linux/` +- [ ] C++ STL → `docs/standard-library/` +- [ ] C runtime → `docs/c-runtime-library/` +- [ ] C++ language → `docs/cpp/` +- [ ] Visual Studio IDE features → `docs/ide/` +- [ ] Build process/modules → `docs/build/reference/` +- [ ] Build Insights → `docs/build-insights/` + +### 4. Links and References +- [ ] Add links to related topics and resources where appropriate. +- [ ] Use relative links for files in this repo +- [ ] **[REQUIRED]** Links to other documentation articles should be relative, not absolute. Start relative links with `/docs/` and include the `.md` suffix. If you add a link to another page on learn.microsoft.com that's not in this repo, remove https://learn.microsoft.com/en-us from the link. +- [ ] **[REQUIRED]** Links to bookmarks within the same article should be relative and start with `#`. +- [ ] **[REQUIRED]** Link descriptions should be descriptive and make sense on their own. Don't use "click here" or "this link" or "here". +- [ ] **[STYLE]** When you are going to refer to another file or an article on the web, use this format: "For more information, see [descriptive name of link](link path)." The exception to this is the See Also links at the end of an article. Those should be markdown links and contain the title of the article you link to as the descriptive portion of the link. +- [ ] For external links to non-Microsoft sites: + - [ ] **[REQUIRED]** Use absolute URLs + - [ ] **[REQUIRED]** Remove any language or culture segment from the URL path (such as `/en-us/`, `/fr-fr/`, `/en/`, etc.) + - [ ] Example (MDN): + - [ ] Original: `https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event` + - [ ] Correct: `https://developer.mozilla.org/docs/Web/API/Element/click_event` + +- [ ] For links to Microsoft Learn content in other repositories: + - [ ] **[REQUIRED]** Use the relative URL starting with a forward slash + - [ ] Don't include the scheme and the host (example: `https://learn.microsoft.com`) and don't include the locale (example: `en-us`) + - [ ] Example: For the target Learn website URL `https://learn.microsoft.com/en-us/dotnet/core/introduction`, use the relative URL `/dotnet/core/introduction` for the link destination + +## Repository-Specific Guidelines +- [ ] **[REQUIRED]** Follow the [Microsoft Writing Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/) + - [ ] Use contractions following the guidance in [Use contractions](https://learn.microsoft.com/en-us/style-guide/word-choice/use-contractions) +- [ ] **Repository Exceptions**: + - [ ] **[REQUIRED]** Use **bold** text for UI elements like menu items, dialog names, and names of text boxes. + - [ ] **[REQUIRED]** Number ordered lists as "1." for every item (don't use sequential numbers) + - [ ] **[REQUIRED]** Use backticks around content specifically for file names (`file.txt`), folders (`folder`), file paths (`folder/file.txt`), custom types (`myVariable`, `MyClass`), raw URLs in the text (`https://www.contoso.com`), file extensions (`.cpp`), and code like method names, property names, and language keywords. Also use for text that should never be localized. + - [ ] **[REQUIRED]** Use `code style` for resource names (like virtual machine names) that shouldn't be localized. + - [ ] **[C++-SPECIFIC]** Use `code style` for command-line commands. The style in some articles uses **bold** for command-line commands, but use `code style` instead. + - [ ] **[STYLE]** Use placeholders with braces in the format `{PLACEHOLDER NAME}` when used code examples and other contexts where placeholders are used. Use uppercase letters with spaces between words for the placeholder name inside the braces. + - [ ] Wrong: "Launch the app and navigate to `https://localhost:/openapi/v1.json` to view the generated OpenAPI document." + - [ ] Correct: "Launch the app and navigate to `https://localhost:{PORT}/openapi/v1.json` to view the generated OpenAPI document, where the `{PORT}` placeholder is the port." + - [ ] For any new or updated .md file added to the repository, ensure the following frontmatter (metadata) is included as specified in [Metadata for Microsoft Learn documentation.](https://learn.microsoft.com/en-us/contribute/content/metadata): + - [ ] **[REQUIRED]** Metadata `ai-usage: ai-assisted` if any AI assistance was used. + - [ ] **[REQUIRED]** When updating a topic that has the ms.assetid: metadata, remove the entire ms.assetid line. + - [ ] **[REQUIRED]** Place the title metadata first, followed by the remaining metadata lines as shown in the following example: +**Example:** + ```yaml + --- + title: "Understanding C++ modules" + description: "Learn how to use C++ modules in Visual Studio" + author: github-username + ms.author: ms-alias + ms.date: 12/11/2025 + ms.topic: conceptual + ai-usage: ai-assisted + --- + ``` + +### 5. Content Writing Guidelines +- [ ] **[STYLE]** Get to the point fast. Be concise and clear. +- [ ] **[STYLE]** Talk like a person. +- [ ] **[STYLE]** Simpler is better. +- [ ] **[STYLE]** Be brief. Give customers just enough information to make decisions confidently. Prune excess words. +- [ ] **[STYLE]** Break up long sentences. +- [ ] **[STYLE]** Use present tense verbs (is, open) instead of past tense (was, opened). For example, "The method returns a value" instead of "The method will return a value." +- [ ] **[STYLE]** Write factual statements and direct commands. Avoid hypotheticals. +- [ ] **[STYLE]** Use active voice where the subject performs the action. +- [ ] **[STYLE]** Write in second person (you) to speak directly to readers. +- [ ] **[STYLE]** Use gender-neutral language. +- [ ] **[STYLE]** Avoid multiple -ing words that could create ambiguity. +- [ ] **[STYLE]** Keep prepositional phrases simple and clear. +- [ ] **[STYLE]** Place modifiers close to what they modify. +- [ ] **[STYLE]** Use a conversational tone with contractions. +- [ ] **[STYLE]** Don't use "we" or "our" to refer to the authors of the documentation. +- [ ] **[STYLE]** Use the imperative mood for instructions. For example, "Call the method" instead of "You should call the method." +- [ ] **[STYLE]** Use "might" instead of "may" to indicate possibility. For example, "This method might throw an exception" instead of "This method may throw an exception." +- [ ] **[STYLE]** Use the Oxford comma in lists of three or more items. +- [ ] Introductory paragraph: + - [ ] When drafting the first paragraph of any new article, or when significantly updating an existing article: + - [ ] Explain why and when the topic matters in practical C++ development scenarios. + - [ ] Give a concise summary of what the article covers or enables, so readers know what to expect. + - [ ] When significantly updating, revise the introductory paragraph to match the new scope and content. + +### 6. PR Description Requirements +- [ ] ALWAYS include "Fixes #[issue-number]" in the PR description, at the first line of the description to link back to the original issue +- [ ] Include a clear summary of changes made +- [ ] List all files that were modified with brief descriptions ## Capitalization -* Use sentence-style capitalization for everything except proper nouns. -* Always capitalize proper nouns. -* Don’t capitalize the spelled-out form of an acronym unless it's a proper noun. -* Use title-style capitalization for product and service names. -* Don't use all uppercase for emphasis. +- [ ] Use sentence-style capitalization for everything except proper nouns. +- [ ] Always capitalize proper nouns. +- [ ] Don’t capitalize the spelled-out form of an acronym unless it's a proper noun. +- [ ] Use title-style capitalization for product and service names. +- [ ] Don't use all uppercase for emphasis. ## Numbers -* Spell out numbers for zero through nine, unless space is limited. Use numerals for 10 and above. -* Spell out numbers at the beginning of a sentence. -* Spell out ordinal numbers such as first, second, and third. Don't add -ly to form adverbs from ordinal numbers. -* Number ordered list items all as "1." instead of "1.", "2.", etc. Use bullets for unordered lists. +The following does NOT apply to step numbers but applies to all other numbers: +- [ ] Spell out numbers for zero through nine, unless space is limited. Use numerals for 10 and above. +- [ ] Spell out numbers at the beginning of a sentence. +- [ ] Spell out ordinal numbers such as first, second, and third. Don't add -ly to form adverbs from ordinal numbers. +- [ ] Number ordered list items all as 1. instead of sequentially as 1., 2., etc. Use bullets for unordered lists. ## Punctuation -* Use short, simple sentences. -* End all sentences with a period. -* Use one space after punctuation marks. -* After a colon, capitalize only proper nouns. -* Avoid semicolons - use separate sentences instead. -* Use question marks sparingly. -* Don't use slashes (/) - use "or" instead. - -## Text formatting - -* UI elements, like menu items, dialog names, and names of text boxes, should be in **bold** text. -* Use `code style` for: - * Code elements, like method names, property names, and language keywords. - * SQL commands. - * NuGet package names. - * Command-line commands. The style in some articles uses **bold** for command-line commands, but use `code style` instead. - * Database table and column names. - * Resource names (like virtual machine names) that shouldn't be localized. - * URLs that you don't want to be selectable. - * File names and folders, custom types, and other text that should never be localized. -* For code placeholders, if you want users to replace part of an input string with their own values, use angle brackets (less than < and greater than > characters) on that placeholder text. +- [ ] Use short, simple sentences. +- [ ] End all sentences with a period. +- [ ] Use one space after punctuation marks. +- [ ] After a colon, capitalize only proper nouns. +- [ ] Avoid semicolons - use separate sentences instead. +- [ ] Use question marks sparingly. +- [ ] Don't use slashes (/) - use "or" instead. ## Headings -* Headings should be in sentence case, not title case. Don't use gerunds in titles. -* Don't apply an inline style like italic, or bold to headings. But do use inline code style for headings that are code elements, like method names or property names. +- [ ] Headings should be in sentence case, not title case. Don't use gerunds in titles. +- [ ] Don't apply an inline style like italic, or bold to headings. But do use inline code style for headings that are code elements, like method names or property names. ## Alerts -* Alerts are a Markdown extension to create block quotes that render with colors and icons that indicate the significance of the content. The following alert types are supported: +- [ ] Alerts are a Markdown extension to create block quotes that render with colors and icons that indicate the significance of the content. The following alert types are supported: - * `[!NOTE]` Information the user should notice even if skimming. - * `[!TIP]` Optional information to help a user be more successful. - * `[!IMPORTANT]` Essential information required for user success. - * `[!CAUTION]` Negative potential consequences of an action. - * `[!WARNING]` Dangerous certain consequences of an action. - -## Adding links - -* Add links to related topics and resources where appropriate. -* Use relative links for files in this repo -* Links to other documentation articles should be relative, not absolute. Start relative links with `/docs/` and include the `.md` suffix. If you add a link to another page on learn.microsoft.com that's not in this repo, remove https://learn.microsoft.com/en-us from the link. -* Links to bookmarks within the same article should be relative and start with `#`. -* Link descriptions should be descriptive and make sense on their own. Don't use "click here" or "this link" or "here". -* When you are going to refer to another file or an article on the web, use this format: "For more information, see [descriptive name of link](link path)." The exception to this is the See Also links at the end of an article. Those should be markdown links and contain the title of the article you link to as the descriptive portion of the link. - -## Adding new files - -* If you add a new Markdown file, it should be named in all lowercase with hyphens separating words. Also, omit any filler words such as "the" or "a" from the file name. -* If you're adding a new Markdown file, the following indicates where it should go the folder structure. If you aren't sure, ask. - If the new file is about Linux, put it in the docs/linux folder. - If the new file is about the C++ Standard Template Library (STL), put it in the docs/standard-library folder. - If the new file is about the C runtime, put it in the docs/c-runtime-library folder. - If the new file is about the C++ language, put it in the docs/cpp folder. - If the new file is about a C++ feature specific to the Visual Studio IDE, put it in the docs/ide folder. - If the new file is about the build process or modules, put it in the docs/build\reference folder. - If the new file is about Build Insights, put it in the docs/build-insights folder. + - [ ] `[!NOTE]` Information the user should notice even if skimming. + - [ ] `[!TIP]` Optional information to help a user be more successful. + - [ ] `[!IMPORTANT]` Essential information required for user success. + - [ ] `[!CAUTION]` Negative potential consequences of an action. + - [ ] `[!WARNING]` Dangerous certain consequences of an action. ## Images -* Use images only when they add value. -* Images have a descriptive and meaningful alt text that starts with "Screenshot showing" and ends with ".". -* Videos have a descriptive and meaningful alt text or title that starts with "Video showing" and ends with ".". +- [ ] Use images only when they add value. +- [ ] Images have a descriptive and meaningful alt text that starts with "Screenshot showing" and ends with ".". +- [ ] Videos have a descriptive and meaningful alt text or title that starts with "Video showing" and ends with ".". ## Numbered steps -* Write complete sentences with capitalization and periods -* Use imperative verbs -* Clearly indicate where actions take place (UI location) -* For single steps, use a bullet instead of a number -* When allowed, use angle brackets for menu sequences (File > Open) +- [ ] Write complete sentences with capitalization and periods +- [ ] Use imperative verbs +- [ ] Clearly indicate where actions take place (UI location) +- [ ] For single steps, use a bullet instead of a number +- [ ] When allowed, use angle brackets for menu sequences (File > Open) ## Terminology -* Use "Select" instead of "Click" for UI elements like buttons, menu items, links, dropdowns, and checkboxes. \ No newline at end of file +- [ ] Use "Select" instead of "Click" for UI elements like buttons, menu items, links, dropdowns, and checkboxes. \ No newline at end of file diff --git a/.github/copilot-issue-verification-action-plan.md b/.github/copilot-issue-verification-action-plan.md new file mode 100644 index 00000000000..3f6d7e270e6 --- /dev/null +++ b/.github/copilot-issue-verification-action-plan.md @@ -0,0 +1,220 @@ +--- +ai-usage: ai-assisted +author: TylerMSFT +ms.author: twhitney +ms.date: 11/13/2025 +--- + +# GitHub issue analysis and action plan prompt for C++ documentation + +## Goal +Analyze the GitHub issue and provide a **structured report** determining: +1. Whether the issue is valid and actionable. +2. Whether the issue is within scope of the articles the issue relates to, or if a new article is needed. +3. The exact documentation changes required (if applicable). +4. A clear action plan that can guide PR creation. + +The report should be suitable for posting directly in the issue discussion. + +--- + +## Analysis Steps + +### 1. Information Gathering +Collect and review: +* The **issue title, description, and all comments**. +* The **published documentation** (via the provided URL). +* The **source file(s)** in the repository. +* Any **linked issues, PRs, or external references**. +* **Environment details**: .NET version, tooling versions (VS, VS Code, CLI, EF Core, etc.). +* **Code samples or error messages** mentioned in the issue. + +### 1.5 Source File Analysis +When examining source files: +* **Provide direct GitHub permalinks** to specific lines or sections. +* **Note exact line numbers** for proposed changes. +* **Include line number ranges** in GitHub URLs using `#L-L` format. +* **Quote current content** from specific lines before proposing changes. +* **Use permalinks with commit SHA** when referencing specific versions. + +Example format for file references: +* Single line: `https://github.com/owner/repo/blob/main/file.md#L123`. +* Line range: `https://github.com/owner/repo/blob/main/file.md#L123-L145`. +* Permalink: `https://github.com/owner/repo/blob//file.md#L123`. + +### 2. Validation Criteria +Determine if the issue is: +* **In scope**: Related to ASP.NET Core documentation (not product bugs). +* **Accurate**: The reported problem genuinely exists. +* **Clear**: Sufficient information to take action. +* **Current**: Applies to supported .NET versions. + +### 3. Translation Requirements +If any content is not in English: +* Include the original text in a quote block. +* Provide complete English translation. +* Label clearly as "Original" and "Translation". + +--- + +## Output Format + +### File Naming +`-analysis-report.md` + +### Report Structure + +#### Header +```markdown +## AI Analysis Report +**Analyzed by:** @ +**Date:** +**Issue:** # +**Model:** GitHub Copilot +--- +``` + +#### For Valid Issues + +```markdown +# Issue Analysis: + +## ✅ Issue Validation +**Status:** Valid and actionable + +## 📋 Issue Summary + + +## 📁 Affected Files +| File | Path | Lines | Section | +|------|------|-------|---------| +| Main article | [`aspnetcore/path/to/file.md`](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/file.md#L123-L145) | 123-145 | "Section Heading" | +| Code sample | [`aspnetcore/path/to/sample.cs`](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/sample.cs#L45-L67) | 45-67 | `MethodName()` method | + +## 📝 Proposed Changes + +### Documentation Updates +**File:** [`aspnetcore/path/to/file.md`](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/file.md#L123-L145) +**Location:** Lines 123-145 (after the paragraph containing "[specific anchor text]") +**Type:** [New paragraph / Note block / Code example / Replacement] + +**Current content (lines 123-125):** +```markdown +[Current text that will be replaced or followed] +``` + +**Proposed change:** +```markdown +[Proposed documentation text here] +``` + +### Code Sample Updates (if applicable) +**File:** [`sample.cs`](https://github.com/dotnet/AspNetCore.Docs/blob/main/path/to/sample.cs#L45-L67) +**Lines:** 45-67 +**Change:** [Add/Modify/Remove] + +**Current code:** +```csharp +// Current code at specified lines +``` + +**Proposed code:** +```csharp +// Proposed code changes +``` + +## 🎯 Action Plan +1. **Edit file:** [`aspnetcore/path/to/file.md`](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/file.md) + * Navigate to: [Line 123](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/file.md#L123) + * Find section: "Exact Section Heading" + * After text: "last sentence before insertion point" + * Insert: [!NOTE] block with explanation + +2. **Update sample:** [`path/to/sample.cs`](https://github.com/dotnet/AspNetCore.Docs/blob/main/path/to/sample.cs) + * Navigate to: [Lines 45-67](https://github.com/dotnet/AspNetCore.Docs/blob/main/path/to/sample.cs#L45-L67) + * Modify method: `MethodName()` + * Change: Update to use new pattern + +## ⚠️ Considerations +* Verify change applies to .NET [version] +* Check if similar updates needed in related articles +* Consider adding cross-references to [related topic] + +## 🔗 References +* Published article: [URL] +* Related issue: #[number] +* Microsoft Learn docs: [relevant MS docs link] +``` + +#### For Invalid Issues + +```markdown +# Issue Analysis: + +## ❌ Issue Validation +**Status:** Not actionable as is +**Reason:** [Out of scope / Insufficient information / Product issue / Already addressed] + +## 📋 Explanation + + +## 💡 Recommendation +* [Close with explanation] +* [Redirect to appropriate repository] +* [Request additional information] +* [Convert to discussion] + +## 🔗 Alternative Resources +* [Link to relevant documentation] +* [Link to appropriate repository for product issues] +``` + +--- + +## Special Instructions + +### Line Number Guidelines +* **Always inspect the actual source file** to determine accurate line numbers. +* **Provide line ranges** rather than single lines when changes affect multiple lines. +* **Use GitHub's line highlighting** format in URLs (#L123 for single, #L123-L145 for range). +* **Quote the existing content** at those lines to confirm accuracy. +* **Consider context lines** - include a few lines before/after for clarity. +* **Update line numbers** if the file has changed since issue creation. + +### Content Block Usage +Only recommend using special blocks when truly appropriate, they should not be overused: +* `[!IMPORTANT]`: Security issues, breaking changes, data loss risks +* `[!WARNING]`: Common mistakes, deprecation notices +* `[!NOTE]`: Helpful clarifications, version-specific info +* `[!TIP]`: Best practices, productivity hints + +### Code Samples +* Use appropriate language identifier for syntax highlighting. +* Include necessary `using` statements or imports. +* Add comments for complex logic. +* Ensure samples are complete and runnable. + +### Scope Boundaries +**DO:** +* Focus on documentation clarity and accuracy. +* Address missing information. +* Fix technical inaccuracies. +* Improve code samples. + +**DON'T:** +* Attempt to fix product bugs through documentation. +* Make architectural recommendations. +* Add opinions or preferences. +* Modify unrelated sections. + +## Issue labels +* Upon completion of the report, set the `ai-reviewed-issue-reported-action-plan` label for the issue. + +### Common Issue Types +1. **Missing information**: Add clarifying content +2. **Outdated content**: Update to current version +3. **Broken samples**: Fix or replace code +4. **Unclear instructions**: Rewrite for clarity +5. **Missing prerequisites**: Add setup steps + +--- \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json index 7eaad279a3d..60de5be0fe6 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -13,5 +13,8 @@ "Makefile", "VB.NET", "XML" - ] + ], + "python-envs.defaultEnvManager": "ms-python.python:conda", + "python-envs.defaultPackageManager": "ms-python.python:conda", + "python-envs.pythonProjects": [] } \ No newline at end of file From 5b6b51bfddc719dbbdb81b070c22e342e374aac3 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 16 Dec 2025 16:43:22 -0800 Subject: [PATCH 1522/1799] Revise ptr32 and ptr64 documentation Updated to address Copilot suggestions. --- docs/cpp/ptr32-ptr64.md | 40 +++++++++++++++++++++++----------------- 1 file changed, 23 insertions(+), 17 deletions(-) diff --git a/docs/cpp/ptr32-ptr64.md b/docs/cpp/ptr32-ptr64.md index 065deb056e2..a41c67307da 100644 --- a/docs/cpp/ptr32-ptr64.md +++ b/docs/cpp/ptr32-ptr64.md @@ -1,16 +1,17 @@ --- description: "Learn more about: __ptr32, __ptr64" title: "__ptr32, __ptr64" -ms.date: "10/09/2018" +ms.date: 12/16/2025 f1_keywords: ["__ptr32_cpp", "__ptr64_cpp", "__ptr32", "__ptr64", "_ptr32", "_ptr64"] helpviewer_keywords: ["__ptr64 keyword [C++]", "_ptr32 keyword [C++]", "ptr32 keyword [C++]", "ptr64 keyword [C++]", "_ptr64 keyword [C++]", "__ptr32 keyword [C++]"] -ms.assetid: afb563d8-7458-4fe7-9c30-bd4b5385a59f --- # __ptr32, __ptr64 -**Microsoft Specific** +**Microsoft specific** -**`__ptr32`** represents a native pointer on a 32-bit system, while **`__ptr64`** represents a native pointer on a 64-bit system. +Use **`__ptr32`** to represent a native pointer on a 32-bit system. Use **`__ptr64`** to represent a native pointer on a 64-bit system. + +The `__ptr32` and `__ptr64` modifiers are Microsoft-specific extensions for interop scenarios. For standard 32-bit (x86) or standard x64 code, use native pointers, instead. The following example shows how to declare each of these pointer types: @@ -19,16 +20,21 @@ int * __ptr32 p32; int * __ptr64 p64; ``` -On a 32-bit system, a pointer declared with **`__ptr64`** is truncated to a 32-bit pointer. On a 64-bit system, a pointer declared with **`__ptr32`** is coerced to a 64-bit pointer. +On a 32-bit system, a pointer declared with **`__ptr64`** is treated as a 32-bit pointer and truncates the upper 32 bits of any 64-bit address assigned to it. On a 64-bit system, a pointer declared with **`__ptr32`** is treated as a 32-bit pointer and truncates the upper 32 bits of any 64-bit address assigned to it. This truncation can lead to an invalid pointer if the 64-bit address is above 4GB. > [!NOTE] -> You cannot use **`__ptr32`** or **`__ptr64`** when compiling with **/clr:pure**. Otherwise, Compiler Error C2472 will be generated. The **/clr:pure** and **/clr:safe** compiler options are deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017. +> You can't use **`__ptr32`** or **`__ptr64`** when compiling with **`/clr:pure`**. Otherwise, the compiler generates error C2472. The **/clr:pure** and **/clr:safe** compiler options are deprecated in Microsoft Visual Studio 2015 and unsupported in Microsoft Visual Studio 2017. -For compatibility with previous versions, **_ptr32** and **_ptr64** are synonyms for **`__ptr32`** and **`__ptr64`** unless compiler option [/Za \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) is specified. +For compatibility with previous versions, **`_ptr32`** and **`_ptr64`** are synonyms for **`__ptr32`** and **`__ptr64`** unless you specify compiler option [/Za \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md). ## Example -The following example shows how to declare and allocate pointers with the **`__ptr32`** and **`__ptr64`** keywords. This code will crash when compiled for 64-bit due to the pointer from `malloc` being truncated to 32-bit. Since 32-bit pointers can be represented in 64-bit, when compiled for 32-bit this code does not necessarily crash. +The following example shows how to declare and allocate pointers with the **`__ptr32`** and **`__ptr64`** keywords. + +This code works on x86 but might crash on x64. + +- It works when compiled for 32-bit because **`__ptr64`** pointers are treated as 32-bit pointers on x86. On x86 (32-bit), `malloc` returns a 32-bit address which fits in `p64`. +- It might crash when compiled for 64-bit because on x64, `malloc` returns a 64-bit pointer which is truncated to 32 bits by this line: `p32 = (int* __ptr32)malloc(4);`. Truncating a 64-bit address to a 32-bit address could result in an invalid pointer if the allocation happened above 4GB. In that case, `*p32 = 32` could attempt to access a truncated address that isn't part of your process's address space, causing an access violation. Even if it works once, it could fail later if the memory allocator returns a higher address. ```cpp #include @@ -38,22 +44,22 @@ int main() { using namespace std; - int * __ptr32 p32; - int * __ptr64 p64; + int* __ptr32 p32; + int* __ptr64 p64; - p32 = (int * __ptr32)malloc(4); - *p32 = 32; + p64 = (int* __ptr64)malloc(4); + *p64 = 64; // Works on x86 and x64 + cout << *p64 << endl; + + p32 = (int* __ptr32)malloc(4); + *p32 = 32; // Works on x86. Possible exception on x64 cout << *p32 << endl; - - p64 = (int * __ptr64)malloc(4); - *p64 = 64; - cout << *p64 << endl; } ``` ```Output -32 64 +32 ``` **END Microsoft Specific** From 897a33545a6b2c9cd524ba362062aa37e7369218 Mon Sep 17 00:00:00 2001 From: David Justo Date: Tue, 6 Jan 2026 10:32:37 -0800 Subject: [PATCH 1523/1799] remove "Microsoft specific" dividers from unary operator docs --- docs/cpp/unary-plus-and-negation-operators-plus-and.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/cpp/unary-plus-and-negation-operators-plus-and.md b/docs/cpp/unary-plus-and-negation-operators-plus-and.md index be1f3402345..16c5a8ce9d8 100644 --- a/docs/cpp/unary-plus-and-negation-operators-plus-and.md +++ b/docs/cpp/unary-plus-and-negation-operators-plus-and.md @@ -27,12 +27,8 @@ The unary negation operator (**`-`**) produces the negative of its operand. The Integral promotion is performed on integral operands, and the resultant type is the type to which the operand is promoted. See [Standard Conversions](standard-conversions.md) for more information about how the promotion is performed. -**Microsoft Specific** - Unary negation of unsigned quantities is performed by subtracting the value of the operand from 2^n, where n is the number of bits in an object of the given unsigned type. -**END Microsoft Specific** - ## See also [Expressions with Unary Operators](../cpp/expressions-with-unary-operators.md)\ From 4e9fd26515f35e6ee0feaa3b219e3201bc4325e3 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Tue, 6 Jan 2026 16:07:16 -0800 Subject: [PATCH 1524/1799] Add CMAKE --- docs/build/walkthrough-build-debug-wsl2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/walkthrough-build-debug-wsl2.md b/docs/build/walkthrough-build-debug-wsl2.md index 66dfa46bd3b..33e08ae4dcf 100644 --- a/docs/build/walkthrough-build-debug-wsl2.md +++ b/docs/build/walkthrough-build-debug-wsl2.md @@ -31,7 +31,7 @@ Install the tools necessary to build and debug on WSL 2. You'll install a recent ```bash sudo apt update - sudo apt install g++ gdb make ninja-build rsync zip + sudo apt install cmake g++ gdb make ninja-build rsync zip ``` The `apt` commands above install: From 2708ee4de23308d5643d7450a1a7541bd9aa1706 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Wed, 7 Jan 2026 13:42:20 -0800 Subject: [PATCH 1525/1799] Fix json --- docs/build/cppproperties-schema-reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/cppproperties-schema-reference.md b/docs/build/cppproperties-schema-reference.md index cafd37a1e78..8ab040779a0 100644 --- a/docs/build/cppproperties-schema-reference.md +++ b/docs/build/cppproperties-schema-reference.md @@ -93,7 +93,7 @@ You can optionally use the `environments` property to define sets of variables i "mingw_64" ], "name": "Mingw64", - "includePath ,": [ + "includePath": [ "${env.INCLUDE}", "${workspaceRoot}\\**", ], From 71697e68cf4008c6b59d243168191fe2600fe77f Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Wed, 7 Jan 2026 16:43:25 -0800 Subject: [PATCH 1526/1799] Add settings note --- docs/build/customize-cmake-settings.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index 6b56804360f..3d17e37a068 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -23,6 +23,9 @@ Now you see the **Settings Editor** with the installed configurations on the lef The left pane shows the installed configurations (x86-Debug). The right pane shows the settings for the selected configuration. The settings include the configuration name, configuration type (set to Debug), toolset (set to msvc_x86), CMake toolchain file (empty), build root (contains ${env:USERPROFILE}\CMakeBuilds\${workspaceHash}\build\${name}), CMake command arguments (empty), and build command arguments (-v). :::image-end::: +> [!NOTE] +> If a JSON editor opens instead of the **Settings Editor** when you select **Manage Configurations**, you need to enable the CMakeSettings mode. Under **Tools** > **Options** > **CMake**, select **Never use CMake Presets**, and then close and reopen your CMake project. Alternatively, you can choose **Use CMake Presets if available, otherwise use CMakeSettings.json**, and then delete the *CMakePresets.json* file from the project folder. + Visual Studio provides one `x64-Debug` configuration by default. You can add more configurations by choosing the green plus sign. The settings that you see in the editor might vary depending on which configuration is selected. The options that you choose in the editor are written to a file called *`CMakeSettings.json`*. This file provides command-line arguments and environment variables that are passed to CMake when you build the projects. Visual Studio never modifies *`CMakeLists.txt`* automatically; by using *`CMakeSettings.json`* you can customize the build through Visual Studio while leaving the CMake project files untouched so that others on your team can consume them with whatever tools they're using. From 9d224b2ced98633a4fad08c74f7bee7fe7284ace Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Wed, 7 Jan 2026 16:51:04 -0800 Subject: [PATCH 1527/1799] Add screenshot --- docs/build/customize-cmake-settings.md | 1 + docs/build/media/cmake-options-file.png | Bin 0 -> 28009 bytes 2 files changed, 1 insertion(+) create mode 100644 docs/build/media/cmake-options-file.png diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index 3d17e37a068..08f168e6d54 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -25,6 +25,7 @@ The left pane shows the installed configurations (x86-Debug). The right pane sho > [!NOTE] > If a JSON editor opens instead of the **Settings Editor** when you select **Manage Configurations**, you need to enable the CMakeSettings mode. Under **Tools** > **Options** > **CMake**, select **Never use CMake Presets**, and then close and reopen your CMake project. Alternatively, you can choose **Use CMake Presets if available, otherwise use CMakeSettings.json**, and then delete the *CMakePresets.json* file from the project folder. +> :::image type="content" source="media/cmake-options-file.png" alt-text="Screenshot of the C make options pane."::: Visual Studio provides one `x64-Debug` configuration by default. You can add more configurations by choosing the green plus sign. The settings that you see in the editor might vary depending on which configuration is selected. diff --git a/docs/build/media/cmake-options-file.png b/docs/build/media/cmake-options-file.png new file mode 100644 index 0000000000000000000000000000000000000000..43f6ec1e6069799475335f9aff5e42a1a621478a GIT binary patch literal 28009 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 Date: Wed, 7 Jan 2026 17:02:37 -0800 Subject: [PATCH 1528/1799] Rename image file --- docs/build/customize-cmake-settings.md | 2 +- ...ions-file.png => options-configuration-file.png} | Bin 2 files changed, 1 insertion(+), 1 deletion(-) rename docs/build/media/{cmake-options-file.png => options-configuration-file.png} (100%) diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index 08f168e6d54..4634014ab9d 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -25,7 +25,7 @@ The left pane shows the installed configurations (x86-Debug). The right pane sho > [!NOTE] > If a JSON editor opens instead of the **Settings Editor** when you select **Manage Configurations**, you need to enable the CMakeSettings mode. Under **Tools** > **Options** > **CMake**, select **Never use CMake Presets**, and then close and reopen your CMake project. Alternatively, you can choose **Use CMake Presets if available, otherwise use CMakeSettings.json**, and then delete the *CMakePresets.json* file from the project folder. -> :::image type="content" source="media/cmake-options-file.png" alt-text="Screenshot of the C make options pane."::: +> :::image type="content" source="media/options-configuration-file.png" alt-text="Screenshot of the C make options pane."::: Visual Studio provides one `x64-Debug` configuration by default. You can add more configurations by choosing the green plus sign. The settings that you see in the editor might vary depending on which configuration is selected. diff --git a/docs/build/media/cmake-options-file.png b/docs/build/media/options-configuration-file.png similarity index 100% rename from docs/build/media/cmake-options-file.png rename to docs/build/media/options-configuration-file.png From 3665741206b2b2d4a7bc298a718b8dd445140b05 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Thu, 8 Jan 2026 10:47:21 -0800 Subject: [PATCH 1529/1799] Minor edits --- docs/code-quality/quick-start-code-analysis-for-c-cpp.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/code-quality/quick-start-code-analysis-for-c-cpp.md b/docs/code-quality/quick-start-code-analysis-for-c-cpp.md index 7c2a7c05f31..1a8f22e7f2c 100644 --- a/docs/code-quality/quick-start-code-analysis-for-c-cpp.md +++ b/docs/code-quality/quick-start-code-analysis-for-c-cpp.md @@ -17,7 +17,7 @@ You can improve the quality of your application by running code analysis regular 1. Optionally, in the **Configuration** and **Platform** lists, choose the build configuration and target platform. -1. To run code analysis every time the project is built using the selected configuration, select the **Enable Code Analysis on Build** check box. You can also run code analysis manually by opening the **Analyze** menu and then choosing **Run Code Analysis on** *ProjectName* or **Run Code Analysis on File**. +1. To run code analysis every time the project is built using the selected configuration, select **Configuration Properties** > **Code Analysis**, then select the **Enable Code Analysis on Build** check box. You can also run code analysis manually by opening the **Analyze** menu and then choosing **Run Code Analysis on** *ProjectName* or **Run Code Analysis on File**. 1. Choose the [rule set](using-rule-sets-to-specify-the-cpp-rules-to-run.md) that you want to use or create a [custom rule set](using-rule-sets-to-specify-the-cpp-rules-to-run.md#to-create-a-rule-set-in-a-text-editor). If using LLVM/clang-cl, see [Using Clang-Tidy in Visual Studio](clang-tidy.md) to configure Clang-Tidy analysis options. @@ -92,7 +92,7 @@ To run code analysis on a file: 1. In the **Build** menu, choose **Run Code Analysis on File** or press **Ctrl+Shift+Alt+F7**. - The project or solution is compiled and code analysis runs. Results appear in the Error List window. +The project or solution is compiled and code analysis runs. Results appear in the **Error List** window. ## Analyze and resolve code analysis warnings From ab41f8c13512e2e3742938a4b5e886939d555655 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Thu, 8 Jan 2026 11:59:40 -0800 Subject: [PATCH 1530/1799] Add warning --- .../tool-errors/command-line-errors-d8000-through-d9999.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md index af66c940222..d87c3bbd718 100644 --- a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md +++ b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md @@ -27,6 +27,7 @@ The articles in this section provide a reference to the command-line errors and | Warning | Message | |--|--| +| Command-Line Warning D9014 | invalid value | | [Command-Line Warning D9024](command-line-warning-d9024.md) | unrecognized source file type 'filename', object file assumed | | [Command-Line Warning D9025](command-line-warning-d9025.md) | overriding 'option1' with 'option2' | | [Command-Line Warning D9026](command-line-warning-d9026.md) | options apply to entire command line | From c283db18e1b72d80c3638d66f983993ed2a610a5 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Thu, 8 Jan 2026 12:10:42 -0800 Subject: [PATCH 1531/1799] Add wording --- .../tool-errors/command-line-errors-d8000-through-d9999.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md index d87c3bbd718..d36c18a179d 100644 --- a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md +++ b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md @@ -27,7 +27,7 @@ The articles in this section provide a reference to the command-line errors and | Warning | Message | |--|--| -| Command-Line Warning D9014 | invalid value | +| Command-Line Warning D9014 | invalid value for 'processMax' | | [Command-Line Warning D9024](command-line-warning-d9024.md) | unrecognized source file type 'filename', object file assumed | | [Command-Line Warning D9025](command-line-warning-d9025.md) | overriding 'option1' with 'option2' | | [Command-Line Warning D9026](command-line-warning-d9026.md) | options apply to entire command line | From 8965a6c5e45f9cfc3041dbb2d2cdaa0fa0ecdca9 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Thu, 8 Jan 2026 12:58:17 -0800 Subject: [PATCH 1532/1799] Add instructions --- docs/code-quality/c6200.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/code-quality/c6200.md b/docs/code-quality/c6200.md index 0003197a5fd..020939f0198 100644 --- a/docs/code-quality/c6200.md +++ b/docs/code-quality/c6200.md @@ -70,3 +70,13 @@ void f() ``` Code analysis doesn't warn with just `rand()` because it doesn't have any information about its return value. On the other hand, `rand() % 15` and `rand() % 14` provide hints as to the range of the return value of `rand()` and code analysis can use that information to determine that the index is out of bounds in the first case but not the second. + +### Disable warning + +If you believe the warning message is inaccurate, you can modify it's behavior by using one of the following pragma directives. + +- `#pragma warning(disable : 6200)` +- `#pragma warning( push [ , n ] )` +- `#pragma warning( pop )` + +To learn more about pragma directives, see [warning pragma](../preprocessor/warning.md). From cb719e700b7ba3f47c53db208b3d76031fa109a9 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Thu, 8 Jan 2026 13:20:34 -0800 Subject: [PATCH 1533/1799] Reword text --- docs/code-quality/c6200.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/code-quality/c6200.md b/docs/code-quality/c6200.md index 020939f0198..40c81ae3a9c 100644 --- a/docs/code-quality/c6200.md +++ b/docs/code-quality/c6200.md @@ -73,7 +73,7 @@ Code analysis doesn't warn with just `rand()` because it doesn't have any inform ### Disable warning -If you believe the warning message is inaccurate, you can modify it's behavior by using one of the following pragma directives. +You can modify the behavior of a warning message by using one of the following pragma directives. - `#pragma warning(disable : 6200)` - `#pragma warning( push [ , n ] )` From 38a2d765bbd4181c0ac23600a1261e8e582b9f68 Mon Sep 17 00:00:00 2001 From: Meera Dietzel Date: Thu, 8 Jan 2026 14:52:30 -0700 Subject: [PATCH 1534/1799] Updates --- .github/copilot-instructions.md | 2 +- docs/build-insights/elevate-note.md | 2 +- docs/build-insights/tutorials/build-insights-tips.md | 2 +- docs/ide/cpp-linter-overview.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 417f80a8da9..75e32e18c89 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -88,7 +88,7 @@ When working on an issue: author: github-username ms.author: ms-alias ms.date: 12/11/2025 - ms.topic: conceptual + ms.topic: concept-article ai-usage: ai-assisted --- ``` diff --git a/docs/build-insights/elevate-note.md b/docs/build-insights/elevate-note.md index 502e2087fef..f13849c4b32 100644 --- a/docs/build-insights/elevate-note.md +++ b/docs/build-insights/elevate-note.md @@ -1,7 +1,7 @@ --- title: "Build Insights needs additional permissions" description: "To capture trace files, Build Insights needs additional permissions as described in this topic." -ms.topic: article +ms.topic: concept-article ms.date: 12/9/2025 ms.update-cycle: 3650-days f1_keywords: diff --git a/docs/build-insights/tutorials/build-insights-tips.md b/docs/build-insights/tutorials/build-insights-tips.md index b9c2b0e6f6c..45b4517777f 100644 --- a/docs/build-insights/tutorials/build-insights-tips.md +++ b/docs/build-insights/tutorials/build-insights-tips.md @@ -4,7 +4,7 @@ description: "Learn time-saving tips for using Build Insights." ms.date: 1/8/2025 author: tylermsft ms.author: twhitney -ms.topic: article +ms.topic: concept-article helpviewer_keywords: ["C++ Build Insights tips and tricks"] --- # Build Insights tips and tricks diff --git a/docs/ide/cpp-linter-overview.md b/docs/ide/cpp-linter-overview.md index 07057453ac3..e6c987576c8 100644 --- a/docs/ide/cpp-linter-overview.md +++ b/docs/ide/cpp-linter-overview.md @@ -2,7 +2,7 @@ description: "Learn more about: IntelliSense code linter for C++" title: IntelliSense code linter for C++ overview ms.date: 09/30/2021 -ms.topic: conceptual +ms.topic: overview helpviewer_keywords: - "C/C++, linter" - "C++, linter" From ac1f8ad5e5acc64d32905509338a519b349f9dcd Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Thu, 8 Jan 2026 13:54:08 -0800 Subject: [PATCH 1535/1799] Add instructions --- docs/embedded/serial-monitor.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/embedded/serial-monitor.md b/docs/embedded/serial-monitor.md index 6ec62acf7ed..581430e7832 100644 --- a/docs/embedded/serial-monitor.md +++ b/docs/embedded/serial-monitor.md @@ -14,6 +14,8 @@ The Serial Monitor allows users to configure, monitor, and communicate with seri # [Visual Studio](#tab/visual-studio) +To install Serial Monitor in Visual Studio, go to **Extensions** > **Manage Extensions**. Search for **Serial Monitor 2** in the extensions marketplace. Select **Install** and then restart Visual Studio to complete the installation. + :::image type="complex" source="./media/serial-monitor.png" alt-text="Screenshot of the Visual Studio Serial Monitor window."::: The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section shows the messages, consisting of four lines of the text Hello, World! :::image-end::: @@ -44,6 +46,8 @@ The window is split into two sections. The top section shows the monitoring mode # [Visual Studio Code](#tab/visual-studio-code) +To install Serial Monitor in Visual Studio Code, open the extensions marketplace and then search for **Serial Monitor**. Select **Install**. + :::image type="complex" source="./media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window."::: The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section where messages are displayed is empty. :::image-end::: From 9794d8f6f6ff5b29ac25b60a78123eac43439cc9 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Thu, 8 Jan 2026 17:40:38 -0800 Subject: [PATCH 1536/1799] Add screenshots --- .../reference/creating-a-makefile-project.md | 8 +++++++- docs/build/reference/media/create-project.png | Bin 0 -> 25659 bytes docs/build/reference/media/file-new-project.png | Bin 0 -> 27281 bytes 3 files changed, 7 insertions(+), 1 deletion(-) create mode 100644 docs/build/reference/media/create-project.png create mode 100644 docs/build/reference/media/file-new-project.png diff --git a/docs/build/reference/creating-a-makefile-project.md b/docs/build/reference/creating-a-makefile-project.md index 1f88156dfd8..bdec06056bd 100644 --- a/docs/build/reference/creating-a-makefile-project.md +++ b/docs/build/reference/creating-a-makefile-project.md @@ -30,7 +30,13 @@ The output file that you specify in the project has no effect on the name that t ### To create a makefile project in Visual Studio -1. From the Visual Studio main menu, choose **File** > **New** > **Project** and type "makefile" into the search box. If you see more than one project template, select from the options depending on your target platform. +1. From the Visual Studio main menu, choose **File** > **New** > **Project**. + +:::image type="content" source="media/file-new-project.png" alt-text="Screenshot of the menu dropdown item to create a new project highlighted"::: + +1. Type *makefile* into the search box. If you see more than one project template, select the option for your target platform. + +:::image type="content" source="media/create-project.png" alt-text="Screenshot of the search bar with makefile entered."::: 1. **Windows only**: In the Makefile project **Debug Configuration Settings** page, provide the command, output, clean, and rebuild information for debug and retail builds. Choose **Next** if you want to specify different settings for a Release configuration. diff --git a/docs/build/reference/media/create-project.png b/docs/build/reference/media/create-project.png new file mode 100644 index 0000000000000000000000000000000000000000..3cb1a61de5d58fb91eadc9cf6c9c945b939efc67 GIT binary patch literal 25659 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 literal 0 HcmV?d00001 diff --git a/docs/build/reference/media/file-new-project.png b/docs/build/reference/media/file-new-project.png new file mode 100644 index 0000000000000000000000000000000000000000..6e6767d5d8ffc3b3e39837c1c1c0df6a95208fa3 GIT binary patch literal 27281 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 literal 0 HcmV?d00001 From 7cabb6f7194a0b302231e0144bb70b66a197c38a Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Thu, 8 Jan 2026 17:50:45 -0800 Subject: [PATCH 1537/1799] Indent images --- .../reference/creating-a-makefile-project.md | 4 ++-- docs/build/reference/media/create-project.png | Bin 25659 -> 20664 bytes .../reference/media/file-new-project.png | Bin 27281 -> 13011 bytes 3 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/creating-a-makefile-project.md b/docs/build/reference/creating-a-makefile-project.md index bdec06056bd..437700d4a94 100644 --- a/docs/build/reference/creating-a-makefile-project.md +++ b/docs/build/reference/creating-a-makefile-project.md @@ -32,11 +32,11 @@ The output file that you specify in the project has no effect on the name that t 1. From the Visual Studio main menu, choose **File** > **New** > **Project**. -:::image type="content" source="media/file-new-project.png" alt-text="Screenshot of the menu dropdown item to create a new project highlighted"::: + :::image type="content" source="media/file-new-project.png" alt-text="Screenshot of the menu dropdown item to create a new project highlighted"::: 1. Type *makefile* into the search box. If you see more than one project template, select the option for your target platform. -:::image type="content" source="media/create-project.png" alt-text="Screenshot of the search bar with makefile entered."::: + :::image type="content" source="media/create-project.png" alt-text="Screenshot of the project template search bar with makefile entered."::: 1. **Windows only**: In the Makefile project **Debug Configuration Settings** page, provide the command, output, clean, and rebuild information for debug and retail builds. Choose **Next** if you want to specify different settings for a Release configuration. diff --git a/docs/build/reference/media/create-project.png b/docs/build/reference/media/create-project.png index 3cb1a61de5d58fb91eadc9cf6c9c945b939efc67..1ab81f0bfbc74852e9ad6724058f8bbeefcc6b4b 100644 GIT binary patch literal 20664 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 jG-_kc9S?av+(VJncVF)*WNotE6g}9 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 literal 25659 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 diff --git a/docs/build/reference/media/file-new-project.png b/docs/build/reference/media/file-new-project.png index 6e6767d5d8ffc3b3e39837c1c1c0df6a95208fa3..df61ed8476eba4e3b2e0145eced1ef092585915d 100644 GIT binary patch literal 13011 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 WuYGbI0)MUmypdLxDwi<)_`d*O8V6DU literal 27281 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 From f3f9e594fa68e6335a23d47a25dcc43543e4f5f0 Mon Sep 17 00:00:00 2001 From: Nick Bassett Date: Mon, 12 Jan 2026 15:29:20 -0800 Subject: [PATCH 1538/1799] Update signing guidance for /INTEGRITYCHECK files (#5875) * Update signing guidance for /INTEGRITYCHECK files The trusted signing service has a new name. * Update docs/build/reference/integritycheck-require-signature-check.md --------- Co-authored-by: Regan Downer --- docs/build/reference/integritycheck-require-signature-check.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/integritycheck-require-signature-check.md b/docs/build/reference/integritycheck-require-signature-check.md index 2e154fe9607..0820e55c26c 100644 --- a/docs/build/reference/integritycheck-require-signature-check.md +++ b/docs/build/reference/integritycheck-require-signature-check.md @@ -17,7 +17,7 @@ The **`/INTEGRITYCHECK`** linker option sets a flag, `IMAGE_DLLCHARACTERISTICS_F ### Signing `/INTEGRITYCHECK` files -Microsoft has new signing guidance for DLL and executable files linked by using **`/INTEGRITYCHECK`**. The guidance used to recommend a cross-signed certificate from the [cross-signing program](/windows-hardware/drivers/install/cross-certificates-for-kernel-mode-code-signing). However, the [cross-signing program is now deprecated](/windows-hardware/drivers/install/deprecation-of-software-publisher-certificates-and-commercial-release-certificates). You must now sign your **`/INTEGRITYCHECK`** files by using the Microsoft [Trusted Signing service](/azure/trusted-signing/) program instead. +Microsoft has new signing guidance for DLL and executable files linked by using **`/INTEGRITYCHECK`**. The guidance used to recommend a cross-signed certificate from the [cross-signing program](/windows-hardware/drivers/install/cross-certificates-for-kernel-mode-code-signing). However, the [cross-signing program is now deprecated](/windows-hardware/drivers/install/deprecation-of-software-publisher-certificates-and-commercial-release-certificates). You must now sign your **`/INTEGRITYCHECK`** files by using the [Azure Artifact Signing service](https://azure.microsoft.com/products/artifact-signing) program instead. ### To set this linker option in Visual Studio From e9723d2064a8cad446d7c232799bc0a87b772b1b Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 12 Jan 2026 17:06:03 -0800 Subject: [PATCH 1539/1799] Enhance command-line warning messages with details Added explanations for Command-Line Warnings D9014 and D9024. --- .../tool-errors/command-line-errors-d8000-through-d9999.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md index d36c18a179d..95eb607c2b7 100644 --- a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md +++ b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md @@ -27,8 +27,8 @@ The articles in this section provide a reference to the command-line errors and | Warning | Message | |--|--| -| Command-Line Warning D9014 | invalid value for 'processMax' | -| [Command-Line Warning D9024](command-line-warning-d9024.md) | unrecognized source file type 'filename', object file assumed | +| Command-Line Warning D9014 | invalid value for 'processMax' | The compiler ignores the invalid value and assumes a value of 1.| +| [Command-Line Warning D9024](command-line-warning-d9024.md) | unrecognized source file type 'filename', object file assumed. Occurs when a command‑line argument looks like a filename but doesn’t match a recognized source or object file extension. The compiler assumes it's an object file and passes it to the linker. | | [Command-Line Warning D9025](command-line-warning-d9025.md) | overriding 'option1' with 'option2' | | [Command-Line Warning D9026](command-line-warning-d9026.md) | options apply to entire command line | | [Command-Line Warning D9027](command-line-warning-d9027.md) | source file '\' ignored | From 80eec8691568d8dfcb80af4dd8249baf7112e704 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 12 Jan 2026 17:07:24 -0800 Subject: [PATCH 1540/1799] Fix formatting of Command-Line Warning D9014 message --- .../tool-errors/command-line-errors-d8000-through-d9999.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md index 95eb607c2b7..14a992e335f 100644 --- a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md +++ b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md @@ -27,7 +27,7 @@ The articles in this section provide a reference to the command-line errors and | Warning | Message | |--|--| -| Command-Line Warning D9014 | invalid value for 'processMax' | The compiler ignores the invalid value and assumes a value of 1.| +| Command-Line Warning D9014 | invalid value for 'processMax'. The compiler ignores the invalid value and assumes a value of 1.| | [Command-Line Warning D9024](command-line-warning-d9024.md) | unrecognized source file type 'filename', object file assumed. Occurs when a command‑line argument looks like a filename but doesn’t match a recognized source or object file extension. The compiler assumes it's an object file and passes it to the linker. | | [Command-Line Warning D9025](command-line-warning-d9025.md) | overriding 'option1' with 'option2' | | [Command-Line Warning D9026](command-line-warning-d9026.md) | options apply to entire command line | From ede29fabe4eac5649aaff3e17f35ca55e14100b7 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 12 Jan 2026 17:32:07 -0800 Subject: [PATCH 1541/1799] Enhance documentation for disabling warning C6200 Updated the section on disabling warning C6200 with additional details and code examples. --- docs/code-quality/c6200.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/code-quality/c6200.md b/docs/code-quality/c6200.md index 40c81ae3a9c..9ec6fc83017 100644 --- a/docs/code-quality/c6200.md +++ b/docs/code-quality/c6200.md @@ -71,12 +71,15 @@ void f() Code analysis doesn't warn with just `rand()` because it doesn't have any information about its return value. On the other hand, `rand() % 15` and `rand() % 14` provide hints as to the range of the return value of `rand()` and code analysis can use that information to determine that the index is out of bounds in the first case but not the second. -### Disable warning +## Disable warning C6200 -You can modify the behavior of a warning message by using one of the following pragma directives. +You can disable this warning project-wide by passing the compiler switch `/wd6200`. If you want a more targeted solution, surround the code that generates the warning with: -- `#pragma warning(disable : 6200)` -- `#pragma warning( push [ , n ] )` -- `#pragma warning( pop )` +`cpp + #pragma warning(push) // save which warnings are enabled/disabled + #pragma warning(disable: 6200) // suppress this warning only in this block + // ... code that intentionally generates C6200 + #pragma warning(pop) // restore the warning state saved with the previous push +``` To learn more about pragma directives, see [warning pragma](../preprocessor/warning.md). From 36a1da921af5fc148ca039ebacd2f3fe0baa576a Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 12 Jan 2026 17:35:52 -0800 Subject: [PATCH 1542/1799] Fix code block formatting for warning C6200 Corrected the formatting of code block for disabling warning C6200. --- docs/code-quality/c6200.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/code-quality/c6200.md b/docs/code-quality/c6200.md index 9ec6fc83017..945df12b0be 100644 --- a/docs/code-quality/c6200.md +++ b/docs/code-quality/c6200.md @@ -75,7 +75,7 @@ Code analysis doesn't warn with just `rand()` because it doesn't have any inform You can disable this warning project-wide by passing the compiler switch `/wd6200`. If you want a more targeted solution, surround the code that generates the warning with: -`cpp +```cpp #pragma warning(push) // save which warnings are enabled/disabled #pragma warning(disable: 6200) // suppress this warning only in this block // ... code that intentionally generates C6200 From dfa0c167dd647b57506452e0f2a1ca96325877ab Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Tue, 13 Jan 2026 14:30:05 -0800 Subject: [PATCH 1543/1799] Use vs2026 --- docs/build/customize-cmake-settings.md | 4 ++-- .../media/options-configuration-file.png | Bin 28009 -> 34449 bytes .../vs2026-cmake-manage-configurations.png | Bin 0 -> 10542 bytes 3 files changed, 2 insertions(+), 2 deletions(-) create mode 100644 docs/build/media/vs2026-cmake-manage-configurations.png diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index 4634014ab9d..5312290a772 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -15,7 +15,7 @@ If you maintain projects that use a *`CMakeSettings.json`* file for CMake build To open the CMake settings editor, select the **Configuration** drop-down in the main toolbar and choose **Manage Configurations**. -![Screenshot of the CMake configuration drop-down. Manage Configurations is highlighted.](media/vs2019-cmake-manage-configurations.png) +![Screenshot of the CMake configuration drop-down. Manage Configurations is highlighted.](media/vs2026-cmake-manage-configurations.png) Now you see the **Settings Editor** with the installed configurations on the left. @@ -24,7 +24,7 @@ The left pane shows the installed configurations (x86-Debug). The right pane sho :::image-end::: > [!NOTE] -> If a JSON editor opens instead of the **Settings Editor** when you select **Manage Configurations**, you need to enable the CMakeSettings mode. Under **Tools** > **Options** > **CMake**, select **Never use CMake Presets**, and then close and reopen your CMake project. Alternatively, you can choose **Use CMake Presets if available, otherwise use CMakeSettings.json**, and then delete the *CMakePresets.json* file from the project folder. +> If a JSON editor opens instead of the **Settings Editor** when you select **Manage Configurations**, you need to enable the CMakeSettings mode. In Visual Studio 2026, under **Tools** > **Options** > **CMake**, select **Never use CMake Presets**, and then close and reopen your CMake project. Alternatively, you can choose **Use CMake Presets if available, otherwise use CMakeSettings.json**, and then delete the *CMakePresets.json* file from the project folder. > :::image type="content" source="media/options-configuration-file.png" alt-text="Screenshot of the C make options pane."::: Visual Studio provides one `x64-Debug` configuration by default. You can add more configurations by choosing the green plus sign. The settings that you see in the editor might vary depending on which configuration is selected. diff --git a/docs/build/media/options-configuration-file.png b/docs/build/media/options-configuration-file.png index 43f6ec1e6069799475335f9aff5e42a1a621478a..2a22a033a179ce9b580b0a94e87cdf06e20f29be 100644 GIT binary patch literal 34449 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 a+}zEMKESSae#HO*o6Ji^SgH8i5C0GL)4SpT literal 28009 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 NQc=)&RV8N@^gp9A Date: Tue, 13 Jan 2026 14:59:24 -0800 Subject: [PATCH 1544/1799] Change image name --- docs/build/customize-cmake-settings.md | 2 +- ....png => vs-2026-cmake-manage-configurations.png} | Bin 2 files changed, 1 insertion(+), 1 deletion(-) rename docs/build/media/{vs2026-cmake-manage-configurations.png => vs-2026-cmake-manage-configurations.png} (100%) diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index 5312290a772..abcbfa224fc 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -15,7 +15,7 @@ If you maintain projects that use a *`CMakeSettings.json`* file for CMake build To open the CMake settings editor, select the **Configuration** drop-down in the main toolbar and choose **Manage Configurations**. -![Screenshot of the CMake configuration drop-down. Manage Configurations is highlighted.](media/vs2026-cmake-manage-configurations.png) +![Screenshot of the CMake configuration drop-down. Manage Configurations is highlighted.](media/vs-2026-cmake-manage-configurations.png) Now you see the **Settings Editor** with the installed configurations on the left. diff --git a/docs/build/media/vs2026-cmake-manage-configurations.png b/docs/build/media/vs-2026-cmake-manage-configurations.png similarity index 100% rename from docs/build/media/vs2026-cmake-manage-configurations.png rename to docs/build/media/vs-2026-cmake-manage-configurations.png From f300874275d4644f7eedb2ab590974797aa40b10 Mon Sep 17 00:00:00 2001 From: Eve Silfanus Date: Thu, 15 Jan 2026 11:30:05 -0800 Subject: [PATCH 1545/1799] Getting Started with GitHub Copilot build performance for Windows --- .../copilot_build_performance_windows.md | 193 ++++++++++++++++++ .../media/build-analysis-complete.png | Bin 0 -> 8173 bytes .../media/build-insights-options.png | Bin 0 -> 52877 bytes .../media/build-insights-permission.png | Bin 0 -> 10780 bytes .../media/build-menu-improve.png | Bin 0 -> 20425 bytes docs/build-insights/media/build-summary.png | Bin 0 -> 46290 bytes .../media/copilot-build-perf-select.png | Bin 0 -> 27834 bytes .../media/copilot-build-request.png | Bin 0 -> 17604 bytes .../media/copilot-improve-includes.png | Bin 0 -> 13898 bytes .../media/copilot-improve-prompt.png | Bin 0 -> 12298 bytes docs/build-insights/media/copilot-signin.png | Bin 0 -> 34001 bytes .../media/copilot-subscription.png | Bin 0 -> 28848 bytes .../media/copilot-usage-menu.png | Bin 0 -> 7298 bytes .../media/insights-improve-button.png | Bin 0 -> 13118 bytes docs/build-insights/media/model-select.png | Bin 0 -> 38362 bytes docs/build-insights/media/msvc-elevation.png | Bin 0 -> 15758 bytes .../media/solution-menu-improve.png | Bin 0 -> 6398 bytes .../media/terminal-permission.png | Bin 0 -> 10480 bytes docs/build-insights/media/vs-account-auth.png | Bin 0 -> 13967 bytes .../media/vs-installer-options.png | Bin 0 -> 19853 bytes docs/build-insights/media/windows-uac.png | Bin 0 -> 37564 bytes 21 files changed, 193 insertions(+) create mode 100644 docs/build-insights/copilot_build_performance_windows.md create mode 100644 docs/build-insights/media/build-analysis-complete.png create mode 100644 docs/build-insights/media/build-insights-options.png create mode 100644 docs/build-insights/media/build-insights-permission.png create mode 100644 docs/build-insights/media/build-menu-improve.png create mode 100644 docs/build-insights/media/build-summary.png create mode 100644 docs/build-insights/media/copilot-build-perf-select.png create mode 100644 docs/build-insights/media/copilot-build-request.png create mode 100644 docs/build-insights/media/copilot-improve-includes.png create mode 100644 docs/build-insights/media/copilot-improve-prompt.png create mode 100644 docs/build-insights/media/copilot-signin.png create mode 100644 docs/build-insights/media/copilot-subscription.png create mode 100644 docs/build-insights/media/copilot-usage-menu.png create mode 100644 docs/build-insights/media/insights-improve-button.png create mode 100644 docs/build-insights/media/model-select.png create mode 100644 docs/build-insights/media/msvc-elevation.png create mode 100644 docs/build-insights/media/solution-menu-improve.png create mode 100644 docs/build-insights/media/terminal-permission.png create mode 100644 docs/build-insights/media/vs-account-auth.png create mode 100644 docs/build-insights/media/vs-installer-options.png create mode 100644 docs/build-insights/media/windows-uac.png diff --git a/docs/build-insights/copilot_build_performance_windows.md b/docs/build-insights/copilot_build_performance_windows.md new file mode 100644 index 00000000000..d5024193c4d --- /dev/null +++ b/docs/build-insights/copilot_build_performance_windows.md @@ -0,0 +1,193 @@ +# Getting Started with GitHub Copilot build performance for Windows  + +The GitHub Copilot build performance for Windows analyzes your C++ builds and highlights expensive headers, templates, and functions so you can identify and fix build time bottlenecks. GitHub Copilot integrates seamlessly with Visual Studio, reducing complexity and improving developer productivity. + +## Prerequisites  + +- Windows 10 or later. +- An MSBuild or CMake project. +- MSVC Build Tools version 14.50. + +## Installing Visual Studio 2026 + +To use GitHub Copilot build performance for Windows, you must install the latest available **Visual Studio 2026**. + +[Installation Guide](https://learn.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=visualstudio) + +Visual Studio 2026 supports **side-by-side installation** with older versions. You do not need to uninstall previous versions or other release channels. Installing Visual Studio 2026 will not interfere with your existing development environment.  + +### Before you begin  + +After installing the Visual Studio Installer, ensure the following components are selected under the **Desktop development with C++** [workload](https://learn.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=visualstudio#step-5---choose-individual-components-optional:~:text=proceeding%20with%20installation.-,Step%204%20%2D%20Choose%20workloads,-After%20you%20install) during installation: + +- C++ Build Insights +- C++ profiling tools +- C++ CMake tools for Windows (required for CMake projects)  + +:::image type="complex" source="./media/vs-installer-options.png" alt-text="Screenshot of Visual Studio Installer showing selected options for Desktop development with C++."::: +The list shows C++ Build Insights, C++ profiling tools, and C++ CMake tools for Windows are all selected for installation. +:::image-end::: + +## Verify GitHub Copilot subscription + +GitHub Copilot build performance for Windows is available to users on GitHub Copilot Pro, Pro+, Business, and Enterprise plans.   + +- Verify your subscription  + + - Log in to [https://github.com](https://github.com/) and access the [Copilot features](https://github.com/settings/copilot/features) + + - Your plan type will appear near the top of the page.  + +:::image type="complex" source="./media/copilot-subscription.png" alt-text="Banner in GitHub settings indicating Copilot Enterprise is active."::: +The banner shows buttons for Copilot in IDE, CLI, Mobile, GitHub.com, and more features. +:::image-end::: + +- Authenticate in Visual Studio 2026 +Before proceeding, ensure you are signed in to your GitHub account in Visual Studio. + + - Click on your profile picture in the upper-right corner of Visual Studio to confirm your GitHub login status. + + :::image type="complex" source="./media/vs-account-auth.png" alt-text="Visual Studio account dropdown showing GitHub EMU account."::: + The dropdown displays the GitHub EMU account with active status and sync indicator. + :::image-end::: + + - If you are not signed in, open the GitHub Copilot Chat and follow the sign-in instructions from the pop-up window. + + :::image type="complex" source="./media/copilot-signin.png" alt-text="GitHub Copilot sign-in window with authentication options."::: + The window shows options to continue with GitHub or Google, and links to terms and privacy policy. + :::image-end::: + + - Once authenticated, you can verify your plan by selecting Copilot Usage from the dropdown menu under the GitHub Copilot badge. + + :::image type="complex" source="./media/copilot-usage-menu.png" alt-text="Visual Studio dropdown menu under Copilot badge."::: + The menu lists options like Copilot Usage, Open Chat Window, Settings, Learn More, GitHub Copilot Walkthrough, and Manage Copilot Subscription. + :::image-end::: + +### Enable Template Collection + +Template instantiation time collection is off by default to minimize analysis overhead. To turn it on: + + 1. In Visual Studio, go to **Tools** \> **Options**. + + 2. In the **Options** dialog, expand **Build Insights** in the left navigation. + + 3. Select **Collect Template Instantiation**. + +:::image type="complex" source="./media/build-insights-options.png" alt-text="Visual Studio Build Insights options dialog."::: +The dialog shows trace collection settings with the Collect template instantiation checkbox selected. +:::image-end::: + +*Learn more:* [Troubleshoot template instantiation impact on build time | Microsoft Learn](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/build-insights-template-view?view=msvc-170) + +## Workflow + +GitHub Copilot build performance on Windows is available via the GitHub Copilot chat pane. Users can access this functionality through the Agent feature within the chat interface. + +:::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="GitHub Copilot chat pane showing agent selection."::: +The pane shows GitHub Copilot build performance for Windows selected to optimize C++ build, with other agents listed. +:::image-end::: + +Before submitting a request to the GitHub Copilot, select your preferred model. + +:::image type="complex" source="./media/model-select.png" alt-text="Dropdown menu in Copilot chat for selecting AI models."::: +The menu includes GPT-5, GPT-5.1, Claude, Gemini, and other available AI models. +:::image-end::: + +Instruct GitHub Copilot to improve the build performance of your selected project. You can add additional context and information so that GitHub Copilot can create suggestions that match the needs of your project. + +:::image type="complex" source="./media/copilot-build-request.png" alt-text="Copilot chat window with build performance request."::: +The window shows GitHub Copilot build performance for Windows with user message requesting build performance improvement for the project. +:::image-end::: + +### Enable Build Insights + +To analyze the build performance of the selected project, Visual Studio needs elevated permissions. The Build Insights tool needs to be enabled for a first-time user to kickstart the build performance analysis. + +*Learn more:* [Build Insights needs additional permissions | Microsoft Learn](https://learn.microsoft.com/en-us/cpp/build-insights/elevate-note?view=msvc-170&f1url=%3FappId%3DDev18IDEF1%26l%3DEN-US%26k%3Dk(bi_permissions)%26rd%3Dtrue) + +:::image type="complex" source="./media/build-insights-permission.png" alt-text="Visual Studio dialog asking to run Build Insights tool."::: +The dialog requests permission to analyze build performance, with Confirm and Deny buttons. +:::image-end::: + +A one-time elevated request is then needed to capture the MSVC compiler traces. + +:::image type="complex" source="./media/msvc-elevation.png" alt-text="Microsoft Visual Studio dialog requesting permission to capture MSVC compiler traces."::: +The dialog shows options for Yes and No to allow trace capture. +:::image-end::: + +:::image type="complex" source="./media/windows-uac.png" alt-text="User Account Control dialog for Windows Command Processor."::: +The UAC dialog asks to allow Windows Command Processor to make changes to the device, with Yes and No buttons. +:::image-end::: + +If the one-time elevated request is denied, the Build Insights operation is cancelled due to lack of rights to continue. + + +You will guide GitHub Copilot through the process of improving the build time by providing permission, as needed, to run tools. Additional permissions may be required to run PowerShell scripts. + +:::image type="complex" source="./media/terminal-permission.png" alt-text="Copilot chat window prompting user to confirm running a terminal command."::: +The prompt shows options to always allow or allow in this session. +:::image-end::: + +The GitHub Copilot build performance for Windows goes through multiple iterations of code implementation to make the build faster. + +:::image type="complex" source="./media/build-analysis-complete.png" alt-text="Screenshot showing analysis complete status and performance improvement summary."::: +The display shows build time improved from 78.6 seconds to 70.5 seconds (8.1 seconds faster, ~10.3% improvement), with a note that further improvement is possible. +:::image-end::: + +After GitHub Copilot completes the request, a summary of the changes and build performance impact is displayed. The build performance summary changes depending on each iteration of the agent. + +:::image type="complex" source="./media/build-summary.png" alt-text="Screenshot of build performance summary showing before and after optimization metrics."::: +The summary displays top bottlenecks and quantitative results of the performance improvements. +:::image-end::: + +In this case, build time dropped from **110.7s to 34.1s** after enabling precompiled headers for costly includes, delivering a **69% improvement** and **3.2× faster builds** with near-instant incremental rebuilds. + +### Additional entry points + +The GitHub Copilot build performance for Windows can be accessed through other entry points. + +- Button from build menu + + :::image type="complex" source="./media/build-menu-improve.png" alt-text="Visual Studio Build menu with Improve build performance option highlighted."::: + The menu shows the Improve build performance option under Run Build Insights. + :::image-end::: + +Clicking the Improve build performance button prompts GitHub Copilot chat + + :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Copilot chat window with Improve Build Performance prompt."::: + The window shows GitHub Copilot build performance for Windows ready to assist with optimization. + :::image-end::: + +- Button from solution context menu + + :::image type="complex" source="./media/solution-menu-improve.png" alt-text="Visual Studio solution context menu showing Improve build performance option."::: + The context menu displays the Improve build performance on Solution option. + :::image-end::: + +Clicking the Improve build performance on Solution button prompts the GitHub Copilot chat + + :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Copilot chat window with Improve Build Performance prompt."::: + The window shows GitHub Copilot build performance for Windows ready to assist with optimization. + :::image-end::: + +- Button from Build Insights view + + :::image type="complex" source="./media/insights-improve-button.png" alt-text="Build Insights diagnostics session view with Improve button highlighted."::: + The view shows the diagnostics session with the Improve button available for optimization. + :::image-end::: + +Clicking the Improve button prompts the GitHub Copilot chat. This button uses data from the existing build insights trace results and does not trigger a new build insights tool execution until the current proposed changes have been processed. + + :::image type="complex" source="./media/copilot-improve-includes.png" alt-text="Copilot chat window with GitHub Copilot build performance for Windows focusing on includes optimization."::: + The chat shows a user message focusing on improving build performance of includes. + :::image-end::: + +## See Also + +[Build Insights function view](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/build-insights-function-view?view=msvc-170) + +[Build Insights included files view](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/build-insights-included-files-view?view=msvc-170) + +[vcperf and Windows Performance Analyzer](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/vcperf-and-wpa?view=msvc-170) + +[Windows Performance Analyzer basics](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/wpa-basics?view=msvc-170) diff --git a/docs/build-insights/media/build-analysis-complete.png b/docs/build-insights/media/build-analysis-complete.png new file mode 100644 index 0000000000000000000000000000000000000000..10bd55a02352caef4752fc5807a83412cfd5f838 GIT binary patch literal 8173 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 j{O@NX|5x+N!X7OCOVPUCGU_W?x9JoK} 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 literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/build-menu-improve.png b/docs/build-insights/media/build-menu-improve.png new file mode 100644 index 0000000000000000000000000000000000000000..14fd3cbe2fa457f0ee7d88aa7a4a841391cba13c GIT binary patch literal 20425 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 G9s3V$;Qb%~ literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/build-summary.png b/docs/build-insights/media/build-summary.png new file mode 100644 index 0000000000000000000000000000000000000000..fc7e0a51bffa026ae5b0e644ff964911510f43f0 GIT binary patch literal 46290 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

rneWTid`Kk?g z6F)yBghKeJ+N~&)PF&;n;--4{7LLxfTjpsW0eFf0M$27xjORE=<=lOySoBr4M(XgT zx={Y|Lz=B_deWLp%Tu>b>cD!)P*R}ioW^RPOB@5Ll;bfrlPK#*rEgJc^ zOrnc4skuctw`q$%6;_$sdd)raLu4-#KSQE4s%EjI(ps=es#(gGsBiy8)nqpR7UKi>vZ zCR6s^%5$QwMb`?w)}KH7^A>wpCU|479P2P*`i7>Rh??#efyptn>N4(#yM4A-K5jdn zjB%LQHs9o~9x_MMx*HAf@h_!OmxgPI=`rc^llL8b#_qi<%gdli@PnwO_o7n>QMu=s zE0N(Un?U2k1UQ&wJRe$G&tLq)O%XD^-Wr&}t)Wwno~k06(KkFiBToNkH>>ktCd$an zoEgwDeDfc5)b;LbkJHU?@7KfDYq1!9RN5pRtfS;Ax@q|&jWm&aRAjq~px#CdST%#F zwy~6zlBT$D%(i3jq|CN?rJ!yi3lqDnYj7^u=nY)BPW3yira_e;#WFwpn!1SH{qrY* zMD*?cSbMkIpLkt)ciFe-F3Q@iDIo8Ra4HTx4G9XwS8l=@DjJQZ_f)jPlLqI}9Gy=Wok@!;2b#R5Z~ewFqF z7Ni-<1paRYclLitt8KdD%e_jBZxB%p14Yh$uO6I^c_6T|Fc%d|`J*4iyns=kNaz`cKqB>+S!JGZ4E;GMuey#PVA#8hIb}rJzuN;2V*H z0bLdYReLm0F!Sy%4+iRIyb%72KR+>0ZyBU$5Z4e1WT22QNwdzCnxCIXtagN9-4;z! zeZ)-x9$|-WjV54^kF#s4ptAt??FlGtnSJ%I1Xqk^D;u?0EaxgUcGowq;9WL=Su~U^ z<>B)*f~2d+q-BovXQCK6s_^+Bk65n0K|$I0Q)Kf2P~#||5Hz`NCqlKznZh}-`^hKv zHgfoYcll9Mptr^EXl1ER_o>NTM0swtafsSa`LNejR8ZsYNy>jWD=v`;a)hu5B7Qm+ zXlrWvzI#U|R-ptX6v}pMTk!I-6(U7e=)4f6vlpdv6xc0XE9dd5GgQ4$X=&JhlS*(W z6=FEEMJ)`C*>7(*+UE;r4A4p_BF8&X{=IG^oTDI@Elw~a2)2JF{hQ+50GCgN<6JZ?^;1}l<)U%kPnG#<>?r{a5xV!s!M%Jyfot=?43 zdt7p71f2~a3IU_w7`AqGDT1z|JjdG(qUm?zB7_`6F^v~c&AR#Q0Kk;?c5y^P0)D|@ z?g^dkB$RFV6>YE5Ve9y0jI6#OxH@wS3xF@0@6;+AmRf)KbGo&sQ1R~FyNH)LIg=c* zQ7f0ZQo3<~6a%yd=@;O~&t$15WpBYrf}tO`4SFATl zVwM@J-I-u9#7VC+Ps>AlY*nnP{zFD{Ina+DKD^?!;m4Q?^M+VzheW%;AQZ6(k(m#^ z@Ed@dQ>CM}jdkazcF58|xCclxK`K$~MlcKr9|N7}B38;Y5=e5VT)oE0dCSP?W8&NS zj#w7Z^;ETCk-%o04p-bAmQRCmkp-Fuggwxa_+Y!guUqruv0&H5ix=;REqdC6Q~?Es zqNJoG{>LaJ7TVsiwR?mF2g5v~a+y#BktI_VUW7>vKal-Wa$e4ZEB`=SyS)tx*d;u& zejrc?I|E=0S~wJ-U!D+7kVDO z4>1+^B!59HUl^YLwk0Rf78^kj#3G;{P`LpU*emJqs#hH&{D5wFC%$)^D#(68>Cg6I zL~?Tea2e1E{oa{>!x5kK%*@P`(}zBMoql~>Ln{8cYTQ;QY#h)v^~p0o7GT`tL<<#?O$NEJd#51=lv058KwAeoC z+mU4)2st^d8?ainpYVSSW(ZJRGup_072GmIekFM&oW&a!PgPXm6RVBK1MUF@_-=1Dl&Emnl9WVbhQCY>?>gmOzEFrp$pQ{~&uf^U@#Rs`1+Y@!sov--U??

9ghb2Y;oGGWFk@jdKmWDUKRAeFLtx&v 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 A_y7O^ literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/copilot-build-request.png b/docs/build-insights/media/copilot-build-request.png new file mode 100644 index 0000000000000000000000000000000000000000..325ec315daa6c5139c6565b219b73d03d43bf5bd GIT binary patch literal 17604 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 bex%ecrKDAU>Iw|@5Qwt8np}~LX~6#ghZLu| literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/copilot-improve-includes.png b/docs/build-insights/media/copilot-improve-includes.png new file mode 100644 index 0000000000000000000000000000000000000000..2a39818263432a409114fcba9aade963241ec992 GIT binary patch literal 13898 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 literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/copilot-improve-prompt.png b/docs/build-insights/media/copilot-improve-prompt.png new file mode 100644 index 0000000000000000000000000000000000000000..43a5194dc4a81bfdf6ead24857f1deecf89bed22 GIT binary patch literal 12298 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 literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/copilot-signin.png b/docs/build-insights/media/copilot-signin.png new file mode 100644 index 0000000000000000000000000000000000000000..05ae12cad457ebb15227f832d38ab9d1887c4f16 GIT binary patch literal 34001 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¬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 literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/insights-improve-button.png b/docs/build-insights/media/insights-improve-button.png new file mode 100644 index 0000000000000000000000000000000000000000..ba4a0383b823a97df31917d17ed1fbb61fc492a9 GIT binary patch literal 13118 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 a7gCV?^!-4l3;fRuNL*M(sO*cL-~R!UK0WgQ literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/model-select.png b/docs/build-insights/media/model-select.png new file mode 100644 index 0000000000000000000000000000000000000000..4c3db683c85f154299c557684e354621966cfc68 GIT binary patch literal 38362 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 L?42x0ZIAy2=hXN= literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/msvc-elevation.png b/docs/build-insights/media/msvc-elevation.png new file mode 100644 index 0000000000000000000000000000000000000000..7404b6f41ab81471e7c4ce48cb3a9437b956e59c GIT binary patch literal 15758 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 literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/terminal-permission.png b/docs/build-insights/media/terminal-permission.png new file mode 100644 index 0000000000000000000000000000000000000000..4baf7683bf5d676253dfdbd42a29737d37baf4e4 GIT binary patch literal 10480 zcmch7WmsHIw`HTjCAbH72oAx6Lx2Q#cXzjhBshd%Aq4l}ZXMhcAOvZkaS714b>qz8 z{bruI-@Sik?mW-@INe=cr%qMv+Iz26t4_>o4JBMGN-PivgsY+~uLS}j?E}9zG0=fe zBRsM;;0wuHOX(%3dYpO}D4^QQs>^~vbxGK_mS{j3(?i+N8wA4Zd%Tc_+{A%nUJ^~xl#$SnuqqNO_-5v zjD`7{Nz~?)Gv2>%s^#_$>#5^X%pf^=llZv=uX;X zUe49Z)X_KhI~lvXyR;YaioD#R(z+bSQ+E<~5}Jq|k%^jM!QQQ(8O#KPgp-Xg0*;@7 zEcRxrFt=6=0x6ZkgZy7ofI@l=WaQ=L8}Lzt2?>)?o?8$R5{iNTRhYw@`#hbL-6lTC zt3D>+RK9Suk{JgEgNt(0s;cHPJDyfeZocqSxf4&$$cS1@tBO`MuH*M-HY&VJar3YK zJdtv>sJw8?>@H9^em6Q><~jBL+*iAa$kj9k43^m6*W6EGQkZP#Cu<{xEZP)_<7>0e zTzysUb!Hr(R{u*rFP!yv8SidUtm^3dyw82YImCm>>sRtwg}u1NMA7G^LUIa+JX`X@(%HTPvn1`p(%Ny`MeoDRShCE#Un@Z^ z7K?&6{V#VYLFxNtiZP#-?ltUaOV+_Q47*MFS%vd|lms%z?_9{WOF~7y;#$}7XNL-y z_0djzto(KK%1gdG$4ISq&XuchUW08uAvu}wn^ErkNZg0^=Ml_h$77NH_7oe=k>A|h zO#2Km=bVDxsOwhjDv1p+X6$Jv>1|QOH9H=ZJ5I(V(yQDBFu0?<>wN}K-}+guyR~F) z%w-9|gu+%bspuNkXo`qk2S&5+7Q$fETO77}-u9{B+>meC;`&aZ^{~>D*1)&KdO#!S_K`_}5C+U# zr+ZuL#`O#1(wB=fOD+-d&U?z=_bboIMz*z=MY7MVBx)8;4sv+=49+37Cr$Y?bvuj} z_b=pQ@13DDVz8v6(jSRwu6mHR&J|2oNA|y)8!Qu{v3!oMb|=@hqSAJdgqc?D1Xk&; z7mi$mVVPr@A(d$cZT$B)IG@a&iIzzDQWnj{&%OoF?C)nhHJk9O;oR{3{&2TUnYOLg zG00E7@@iPMTd@@_7(DcxpZ^_T<$WH)O-$p-53vGX^TT|ruZ@4zQ-f-4`2K_o2u4Uo zMcgqmlDlDASZKzDSQ^mC(PJyXm!DT5!81o-TQ+e17u1cm}^jm z4KtPqbqZG>q8BU6`jwpwxMQ;uT06(M!;PdV4hV&S>}Y6b$BmfLWnOc`6KXYpX-&6e zY9*%87J?5R+C076c^Op~S%O|`U-?R^+RyBlIRVPL)jl1C?9qk-0Xm{!@G_AdSL;Co zF#LOBhaSL3jgVP}a9S*m@*;$cXM4CYFr@2{XbcLLoG6w|3l2ESy#?E;2I_<>jq0AD zsQKmj8!SU$?JB7fWR@vsZeSMeY_c!k^e@PMWS`kCy0;=cqp9@rg*ccmbzA^@50)eAY)&~w+@`;yhK{bH!IYHDn6|W3*@_z z#I;cQfbS+7@l*dTgNka-is1X;Ey8N{l%xYQaDQzSIEe`@Zyy=4&P?!1F9p=7E1D`| z9{Dcs0wR^t7Ljn4NW47&120IL*YQOg6pp=JHA~`lM*nm*odw3TF28Ztm2Tr5+*?%a zDkL3h3gI^V3A?aF+=5s(#yupO|Gx6CT<5Rc-I+nQt|33Fan-xae!cEX{3-V7O&Z+S zR)awG_?$2AMHi(g+-Ek|I+Fv)5T|`l3+Iw3H<^o!XY&*SOEWLW1=~yr77e<@Pu9{$ zRHPLDvN-(Ql0$1Ji2X3hsn@N)FNZcrknrI*8uJ0A>%ezhnV-kcKSl-D$;B|vdS}FJ zh8fX7OuX*e6hB{2LXj-gGvN%rHPRo}(m@~#4|fVL{pQ~FA84TN4$%Q#rH;kDKcYt? z+sr@CUQB(y$&F=F;A5dw6G&e6tok*4VaXxBks19gH7_VCTF#ZPe*sVS)df0Jarxnq zPK)%74YNhX;+|$c;)EgEnyjrxS(ZatjEUl=>bzQ-V;daRpQB8TV z?$@VJU(jNU^O_gFLykV3+I9NA-mG_#qAjG%;Bz~E`rWtHR?3R&>Vadtec8Cr^l?oz z^=8HP4v)^kx&~3456lJfCVu4DsU%`?Dl^0>|QhT+0h4M<=eD;R&DIOpT?0H z%5Sb*I#LZ>PF@EaWb1cqt2yeAg{V&IQNyBZdg}+jKd7KLLX~0PCmVVFZd@ew?|KdVC)Qul(J-b-3TcHBr4@Nz>;RZrX`u@hr@`vFzk$t!cqLCsGoGT?0k?){~lX8(1$fM`wrGi*>dYG-#@1 zYmGD{XYv>nuy_S}SIttlww)0<{uvlDo~9 z3OF82I+0ibnxFVyki`ezeWcu0j5#BObkk)x&fd>rB!WMe6rW`NX;AMu7%ItIK3mz}U3LDL`BEPk zIwvWusCVWdoWt5XPy+eg?@h|u3bBrBL7`dZ7M4aQ(bU}D+OpKmf);emo_)isxT=1z9&+2ov90OUEhVrW|zLO#J3dVI#1GE-HnMF}=9sVk7N#_iUzaOwSYowsA z9C5uUaAES5DTui^`laBWc@KEyU!$WP+_G%Cb0UIiG!hc6q&I8Ew6)iP9#eD5ap$lQ*V;RwV2pzL z+rN@73=9S509T_3Jqg&sJb2siFGt*WUIF@WV0g3)Ljgs%`yK-@)kyMM;9u&9$6*g6 z{r3yq@QiRDKR?R2XuA)iqpH>b!>r6W%m^gi3{Nb&S%5-BCHj8&LsxhY=iSk&(#?3j-xR0At^32f61vXVDc*tOwJ16&f1nvd zRy}F0`EK|Vap4Ee#s>$2hf`>H-^0~i?sJKAC7hfal(730OP8u3ic*buiV9$jl5v5Y zI+TP{aHkY`d6p|RSPy-m)m`D~&FM4mK_Hgja*Inv8B0IpdTiC`d%(7>9Udm1-Cye) zUvPEY9lg;Gr}Dd9 z#lD;_t?30OktaaTCv5$_>z;HPF%;RsbWwPpKI0Gv8@=B1R158byEC#ce4P3C!mrs@ z6;=}k*&E=lfD)wDLk@LDZD{$+<>civvvj({9`M5lu_u7!Tz2h8c*xN<(i+FowR-d# z@nga|dC&cX?tY^*K1-eC1{vdH@5ws@R0j0PC9)}!7`D^ajT>@|LtoLWS(Qp}Y!xK) zE^aD-4C7|KGYGZ8aL+b*(()2IVP!_rRrq2Ie~g%++ah6In|j6~XgYzo6}nB}2*tO>lHv;_{v*>mP+ z_5Cgb@*9m`^%)rI?X{3@vRfYL@+!ZTzI)cXc7n%&4P#?CE}YiIF_)2NLVrg6^7*P< z%;z8;#}MoSHY^h1-s9WBPdKRmUoW z6X(1ApoYEPmjjJbMH--5y`h;_ul_!U!8F}K5GNxKk}A$wHH#WUy1>N%5f>|OljR>~ zaW zUfu=@_!O>)88+y0gYMpCF;#Ljbl*c>UM2>kT1%Q>SFJUiTLDTihe}OB+57vq<1`7y zg6DIUSOx}|8nP(AU{O`TSOZ#SG961W_Jl=8`hqYgBSXQiPZE+|2eZBiW;|K$VQJ*RuN+#yhZ^^E zNE|a@T*&$ZQP|gWsVXS6GfPd`DG$&yY8aFO*kzwF za_1zVaICmV;@YE+=z(%Uw4w6aZEynp7uK24LB>6M7X{#vxG`OxDgGZL2`SOh`(Mrx zmJj=FEx&InJVRhp`fK92E%ZR9i0}9%rqzi1_7p=nPMauolXV=wZ;EJh`x|TbQ6CFK z=~wts-~F}7*$KY?a)k85uC?IZvCwUj@SEVEkZP2W)(_pp(~mWYP=%;|2qs@wsx##5j3kWfGwPZVKYE(A4Im9z3Dz zL<`0XN3%t2t$w7c8CbbJK;CdmWX5o-6lV_~G$vMvn^3n;0%&D&I2@RcPyN$cU6I9r zD$-W`hgNcFy!16_Qwya(BY<6kwnC4x#N_n9pyPkyi1MEIoO}bJbdS~T>Xg&lP>g}P*F+g zen51^aJtQz`%hE0Mf4rFK_RY!;T}$xQ557hdV@_MGvwyA7C#qB1SU= znJ(n`ZJlTZz*~}}uA?129?5`}_&)~yW%&;l|2r^KV9sUmnD(A*40+yOdYXU(CR;NB zii1-kX<-fyAoO4ICF3yzM~ke45aCN4gCYUlXc85uq>~6BFm7=hKy)G`_n|HLZ)Id| z&RqOdv@n|DNa#I>C}cV}I()`H*PbSVo#p3=toro1(4dHEnrcq zoZrNfcYtV(d~j%pFs`XE&r^(a=3~70m{@t3XYqpYQvDK{3ReDMGSTG_oSetU^}Rj% zJxj#ud~`Lo>D*4{y|uU@%b73 zl#c1v%)jN1_;X1Trx<#b25)0yu@-$HrUrFZXtR}u){ESshx|G`l5caQu5!JCIC6w* za4G)yXrU@`k}{{Ny`;GH+#~tdl8eU3P01KlK%LW{x@8jqcmbB zwTtP)>x?suFnXNTT`T>UiakzQGot6y8#A+dY`Y?Rd`1^zb2*0QAW$-CmGpJcbr_{~ z#2|b+$ZycjMt5lZO4XkBe5hPBX!@KIX&sVZC#`okok$hyUW2O=O!G~Y2I0`%KFNvmM>~Ie#)hKOgZ0(>!`B7Va9EPwsM%LD(XD(> zxa=AmN;WyNtJ3^?@M^JTQ#iqOk!xw+J$Uz>FHhvpS>mDH~ccZX;r8f0n!22KUpG1~HA`1H+k^2XQDw(~IUp zG^PeE*jseoljXv(((sgXh}nK;XGb|UyF3hjxWsv|)FDzHa-grNa@6$@_GhB8surJC z0;2_*eagBNHSw99eQJm8V=d`cu~#|ZhF_bu`J6&{sv4=C(*)a@KKvHYNm5dqD$9*! zB~y!1Bur*Hzre|_FL}DNuOJ_r*Fsdrm9oNDfv?qOqAQyGyIX5o`nyja(3sCG zu~1^MQ7%im<4StL{k+rFeM6_253!tRQfZv&sfo@V^7fcGMaJwLaXD;G!aRoSFa3+y z{Nm9j)NWJL$R^AS;z=`~9P>EJ4H&zw^xLAqTO~&oaJb5L-+iZ}d7R%+W`DsCOxv65 zy6@H@+;h2o^0OO_InLR`Y~y5`6XoPTeNb1HLQz-jfqgleuky!{<#d-)h=^T|ul^Aet<`EE9(& z*qxzMv#eep9kJ&irvBM=Y&}58vMdh80&&s;CPW*`S|vj5&W=N7TAo-AXXvz=^v=*l z&Q|h}?}}A5T!~yPZlBRGPudl?kv-0wi)7NXxmht@?si|wp~}Z>=UL;3E~RUrLR~Z z1xub9O)4hRjx!^qS>D_$*4s+$Y;Ft4@HX#lkKI4a635*r9vw?%Wo62jqWaIt~0aq%&lG7TPjCKHex5R(wy= zpq9ZyA%X+~0M2vC7m{CGjHW4hK^%tYSXui(W~O`@5BI^G;d!YUD6vXpn?fuWdy}42 zU>6b_$wN3+X7N1wapPIXe9=}_W!%D&8g9MiNPV}vglYR_l*G^1*LT!nX=bLlxW~PH zm&M1|cTBl9ok6M2JajJJ0qdN`F}_qLCYoQ+7O4a17@LeoUR#@pl*c4GJ)LyXbBHFQ z{<^xX>^FR=+0}RuQ6o?sdhZ*^$}z(#6I0)PIS*6Ps2n&kKcQqS7|E=UFf}lU);9}8 zbDpj2;j96_tFPx56cTcjHCB(BAeKG0u!f+S4A161Wzs5xq{GioK7_vdKr~sTZrCl{ z;IZ}+eB6s2tyn1F*9GkShhs|qAv|yF{`>p$|A!4eHC-(;`@2GtxKAl5kqU86grAu< zc&2!~8j(qq7zfwc`Lc%q4w1QW8NrP~>$2Y-VNglqoIqtC!SunSs176q|i|e+ZQ_r8#>X!lFp=IUU_lL%=Worf;~P ziDiG@(@#CiGNi-$!j8+&n|N(~Ah4$hhDA)cs(N(Iu1ivskjV*iD;m zanx`*X4HOTciROf{wEsQ)X6x_kxn%$5#Ts&yK?q=k4w>})*5nEf1#yW+R#AsR;JtF z)u{F=LK0o#rlK6bU@8z8Up+55PC(sL3X|U$Rrn+xR<*c{;f9abB7D_5TBTWvz*;5fs^g^D zYGSPi+L^d*o#N~*^{J>K;I#R&&7gU|A>jDxi>FBa7f>rcb@wEy3tjv6KhS7qpT?$fpG8Co zjFon}*daH>5RcLe2Hy*~4-~toDsf}pKcUP7@xH>L2ih_b(ds zH24m=ML*PjzWAL>6o|KR_BBLm6G{UMjP&YYplXq{6MvkjF_uKF5r*0y!&{3qFmm`o zlgKe_gc8U7hPOR<(tTZ~QD?dNAqigzuX>8 z*@B~xci*nbPdo5@oztV|;`#TZaH2O=FX@{leUfgw{4>_Wa2W08znIY<{!n@l&L@CU zrh&Zt**jTC`ddn8-1u|d(K>IISnFJ&b}rCnij}*=6g=G7QSOf?Y#&cp@TxmWex`?# z=GFva%DoXnvGkNWfYiqO?;K%AdWR`%3DUiAal!4_)jW?c;M+Jzba~y3VsKt0OI#@T`2y|M=CcNK}sQ@9pR*4Elur` zo5*q~!c@NSjY*r=z(1Snl1~Szq9EnZ@7LBW!HDJH%hgEy_^g=d`thx{GM_G7vt9Hah^GWvhmx{u1V_F%iq%^Ad^yMqq+tac_TQ(2#z|jbB$|reI>)1LelP-KwXj{N5Jb-BWk~oVH zgH|#4*N5+8?d_o6{Ab8n6{}b+1tZYPeO@d5y5=~RHpvazAWOkiksfH}^lo`%s|wyP zzZ=b|C}3&XaJ^oDiFrT~*u`OasptDvN~NalbRT7F&#)1qOI^@vD2di2Ij2m z9>F+u@IHbW5sYdMR0Tpn&kR&utp9;Cw=1pA`M8Q5z4WMYu-}D6MO(SF( zYe(~F+;UQH9vqEMpzYBPdRY@Ivm|cE44VSst?_^9ssYckD+GM40zZq84-lEggh%bG zes-*dm&77sRr(&o%;`*wS)*u(E!tQ38_BGJFDmSX<5xh7{3)MnsOBc zLT?S@AN@zY4mj87qTRcb@z2d>Qx*(-JpFTw$*-Y0&S+odxIkG7ttF|qKEMe0am*p@ zBrLf|@bFNS=21z5B<_fSqgO4-{NaBQkAB30$`@VYB}XYud87@_=?vY<>ca_5Y?#Y= zK8rp)V0ZI1E%Vpg5%4_K&Eh|CnP@=QzNS=;9Z^9X=3~9C;75+TrG6|NN1#AxrAgDT z?)94EUqK`O7&K1*1dYFywhH7zeGY7Z)~rO~Ea1^9Y1dg}Xt<8VwXH5ZIk!y;xMP9f@b0nJ zR`7RIwhI*XDx&u>z~K_|aXHe6?uW6rvhoF>MOxw*!hXqqFE{3le{}6S%WcNymghJ^bP=ojf{QF&AhuiD-iNITmAQc4- K`RbPz@BRlQlr&EO literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/vs-account-auth.png b/docs/build-insights/media/vs-account-auth.png new file mode 100644 index 0000000000000000000000000000000000000000..ae395549d004f2c89e83661937d17992ac2c6f0e GIT binary patch literal 13967 zcmch;bx<5#^foy7;2J!@;1(na5}d(<27=q*?(Q~Na7cilfndQQxLa^Y0zneo-5mzl z=H0FR>sMcG?YFg6baDGmci(%Sd*nH%Z%3=C$l+p9Vu3&)Tm^Y)br1+i0yucU=s-_@ zZHXQ556Mkk4hpIqr``chP^~1DB|)H?1Z;!}8gP#3EU)VZ0^#*O9Y_OCCFURyKcj-Q zEV1o3^_}7J>OyLk9ypR9tnR|-FO&s+}z7ES}Gi*4F%f>go+VMcOzr&c%2Ma zikLs>hSx^EY{GvvpneqMy>|m?^4ub%nPGR{_!+4~{V67Q@(9{JfwBXJJeR8mA#UDM zOjEbTV`#oC&k#e+du7jaYvY!cmKtWF!}<9&ft?XGR$6zv+UXZ`JG^JheV_agy-)Kb zWCS^-&Cu=65Q&t&>zWuPPq1AFi)%$Sc8(0RN4}J1c?>@`3y%^$Bg=6+L;;nQrmkfg zKlU7)>OHK0K%AK|tm68!5zMD$AW(Fkhljl*3Bq0~X*NW3xKB-g_TRrAZuT@|8Srn7 zP}JpSgzI{m$ZEqgPCD)CZ8P==!$%r&+o|WSXxPmLb^`04M0%W(G5&??87wDf8*tCg z&a>_hdWOWlBK&A zW2Ug^8nDHudICNI6<4&F+=;`}n0i4WOEWq594%d=VHd&MTiZ{BPLfZ3H%C;y9JE{&KBjQW5TUQzJ^O8mD4(jY6$$N%o{`1CYs1Lc4wz8l}jU*IlP zd^uTJ!J@ev26lE5&+faB`|j%c3#s>x_u@G4L?IU!m#CN+yOV}QRLm~Fgx$wv{dCGT zOI^N~j#{hshbT=rhd-QX2r zBmU8oCmGzKF0G|MJSgzsDH7&ZQ*v>YCDBC>OcZ89qO(v&qv7v;Q5B!>Uio7}JWS2Z z2&t&%RvjP!jsdNd#Gq=5LVWbA9GM5Mv!67?htqAh(^1!kzV|oP2uc?9WSZM zHSM2~0@=$7D_c4(t0Rf?ArfjYgGK2ocKqQ68l7s836N!sS#}nzUxVY4}m=4}IA-B)M`?>ZjvBZYxG)%h>&5 z&1r%Nm*6yR0vc*OxubscP7tih{>tdJfYS^Q6^@kP;-rqj8wxVKYhM>pxrmc)W(8!e zH9_^$eUr5&+U}#WffWg(bG-fBwFMK7pYX&6Vn$GI{SodRl4#wq>xVM62l;-7;>`uQ z4YP19syn12=SIFscDva7dAxs-4~7}ys;>$eR4g#{z8o< zgt77)Y@C!a44$5oF7sa4sX{#IEo?|--@}?OCll`ICC%i^ElLG8f6;>>zN*!BAweqK zy%|#BJbRAtWwtP9BlRGUnes?N-*j@5tIwUVe`DZGquTDX%CRfJ$4Xm=F5*ab*9y99 z(1@vA6Em9@b)P+ezN|~)`d$%0-1`Zxo6co=E5H!xMpRshdOI(gwR_r1hT;OOdRMgd z(sxx!U><&=ZWkE7y{`{>PEl(&0aPea1(~395vKL-nd=8yn+5z|E??MkDE@r?y$FH8 z>&UXv=pgWIVaX#5c`zg!7dY#Ky#ou5wz zL>4BpnX{I%B7<5RV|H57A2uZ3*T& zGgv;?-;rk%jGII&b}8aPyP{p%67ZpKSMpu?3!yo#Jqb-4la8ek%s@^`I+!S*<)0{s!;YPI&rdvz21{%Dea~Yn8Sbqx zoiuHoABao%QZLeYpbQ_l+H|qIxsC@ak6}9lLTsO-QxE?8$<43xO+dY7f7T9R3Y8bO zY5Y$>DwUu?ZhmiI^-l+H;5s)IgBF~;*Cznt1 zcQrs>QtBL4j$U}(t89#AVHU05wpQ5hr{B}3`wqeDII_`U6ZIN(+rP249z_ynM|l5x z$Tla)0s!jPhp99D^;(#QozRbae9RpzchcabpnVBPT`r*iYh5V`ZT4apH#2-YSOxh> zB><%v=4O6D;&DQiA;47de47!pL)PT5jSq$#NF9SdvYB763bY_u>;Eu{&uf-|x+@+3 zCtWx`*3FNCPwaN=gf|0tfxHlDiBJp}PIf;eeOB?@kSJd<6dkq_1}z}T+9XS1kzQhf zv@ltN)DvX9|9oYZ_Cm$&618c)ktv8<{fp<;*pclg@ zV>wX2EOsA)H50bW>S|# zhoo~`{n1z&mHFI8c4KN|HtB(>=y?Y6mT0{5;#$<-0YvqtJ?jVdhjjs#0!1LoDQvk) zQ{w0Lrqo>YkQ%VHht6p>I=AkUjz7!oUCa_a7Uw7StDJ~?AwMIBWDUDCScvmdiCn%7 z+w<1BBXHFkpBmDkpc$dbt8ODOdAt{hmtU*DWGX1j1HGn`c_wpxKB4t-=3^MzNY!RF z?47QD^u?oL%;~OcU_B{6FG)i~LusxWV{II5W5pBkp~@KKo{qlse=*?#2sx6IilC>j zMrubtj?p_f8_8X%8t%OQ5yxK1*?(B(f-uF)q(Xay(W%piyk`$*G$F@QJ=Mn?FxerL z7q~l)LF;CYutm$^GLG5Cmqe~ER^SE@)e-pWh{)G!^}jPs5fzUVV{kqWZ!zJ#LY>{O2mwfT2p!UF46@o5{5t;C$jkbMd;9yQAmMY0kU=)% zwaJ)V>-uKT&ge4#B44xd2iUdDRCd8wZFAJ=cNuF_!(XM5DNpv52;#{QM4z9lP*D*Je>XLG1 zMyVb0)rn*8Py^5a?jC@K$8V$|XyBz*QT@TqA8G&fn$OssLAm;2ON!%m^}h`mSIo$1 z?UNb1uCCp=%*p$a6jOh8KbUXmq+7Tpxl-#q7u0OlkQMZVVHc>g5ow{UxRiQE=cNbE zlVO&wxNG#PrYcJtG%*OAJC?jyt0s{vP@nqc&sXau%^?*dV4p^#i-nOpmMA@rv?&c` z7Y!}M^Jv%kKiSkvfyU2iuGGgDp`t3Q0j=iVZoNUq)Iq8@lm%x1t#-KkcN!DbwSW8X zBu38xRwb!7xA)kJx5;dIeM$S+-TAYk`=&Fnj4T;1AOp`R!li410bo=~64lwY#e7q( zT(3{novAyHYqbxSYbo_pSq1jn{a2C=qYP4i46Wa%fA`0ve&4%O^cR*s5{P;y@LVuD zZ+P+Z!nw1#xq(!kP?r{lYwzVIPb_}h*1p`Sf=9Zr=?#$|T@}IK*#wwyt8bO05TG%~ z6dWv1HmLCkfXw~3qoCf}8)k^~-*?0zI#srjhpxlz9H#*N&gR zEtb+83<<)8r^kGHEIbSoG}*)7w>1CgetRB9hqO)CbsYP8%qZ9 z9)8oNyc>KR>f|XHf7f8&v{QW!rhnecYsgn%U!q-H)O-!IBEyk(obbhUqMu#-b*}qXFeKg>0|H4#(GZnmJcWzSfQ?aZW@JJBBbMt~ zh>0y^X2_QwH<5J1on@Ktl75QV14^UV|h>NhRMUWB_dukg;b5O6KB=wxa0Q zrD+P>s0oJSK==jAAA?9@`n=r`SU|KZ{E`%7@_QllDcU72BY{DRa-DC}`s<%&)3$a3 zgl+ zRf`}-Z`|xC?tso!GGgdIg;sPr zkpIrzGg*AZcA07GlN;6%LXL!{Y}0y4axqNcyJh0b5@gkSr}{ohm!xhvQR#o2Mk z$+_NhL)*g#xGV8=SXc0O?>gp=^K+tL5YM1JL2_u|51h!)h*GW*vnY&kT8M8!FOZPr zEq4deKufmnfFD?_*G(C@5aAK+@a-f#AhF>&y12e93@|)3x2chTg06R*!gw+i1L7;o z4csfN;8jnf&YfZumFtJ<)G~={iuqg4mlzn&ciB2C=puoOmwTJH52dryQ}P%igBS|` zs*MDm!a4zl?5Xh)_ZYS_!#Jl57JOWg$3oO=bOb?hq8HJ=WF#!SHo#JmO24{QaS3WW zTs;Ke+|9`w=SXU|5=bPeg%`)QlhmBfhTyB>dEilrDg_!CUyA-8W;Wv+3IL=f8?|M^2^o*SAVzrNW`PyS_K^(_oFLzhBp6N*CW9mo=GFP%X)@`6YWJV-&-+v6 zoOoSpqOY0PnFIwwg{Zob2_}SRtt=vvik(&&M^5d8aX6Z>evWA;ad-I*Cp;>1EML!Q zq$%}L1aUZK667zTVoNBu@9K1jqWU<_?U{OCz=13a$x!V3~1g;n7 zca2m#8f`cI`=hm{=p9{p9(z^l1oG&ug1^VNr+9&8b;eS07F8w|gUZq`^L?v+v`0SN zC)WQX6m;!4d{r%aa??lI_N^vB#FVj`18qRo+oV;FtphI&IcIa$OYP=%tzFi+U8-VD z_@Z~qYd9or;UvSsCTt0)190{2B@{gvxEPE zRk^wX|9U*TlNAXAPX5SxyROU}&?SDc)xVE;a~a^%EF)#hUj_z7&ExMO9?0f6UP)5t z@%%}*fy)tlw1lrMUO~&8%+ToKlYc7u$DiMb!+Pq7!%q4QDJ|O%=f{(#U5nTgBL=mz zzpR{V4yqQ{lA3YPtb)_Q+<)2@@zs=ZtCP!)g>=HWjkE*$2@`5oQ*G1!Wa^mk>Ffyu z^@MnUo-3-LrN((vg1UHm>ms^4*WbfF7c)fIp`wl$_0}l8D!-TvOl(?L!A%{b84AZV zyTX}naF!nv#9c*RYbLZ5G}h{NQcuYKgc+zf)cxVR2NFlK1_~fjKg0?~?TY@h;7`N0 z&V@(s7I&FgW5qM%ayz&Uv}?z2xT57aaza$io3pM+X%`hV(m4ilr&w z|E(3zm{A!4qnGXS;?G!PoD$^6Q7d9X6t-BYaci_!z^XamNfay&sBE>E=sUn!Y{j0# zEj~A%)c+yUkOgtzncG$M{L_PgysEF|zilSLtSmyaG4>+b%GcS&Mql^h;CmdEI9lH; zj;EXtQ}TNZNt-L9URr$Y86QU7@@PtS*fJf*jYOKN))qz8qBs<%;p4vO8_(MN_Y6)T zS^oya7ujh$Y~sv!X~DWR9b}IxwH+ix6~U(E&RwSkAYv#+@&;{vtnnLe|<$u5!XviGhV~IamFjFGIfL zVG2RMUrz;c3JdcaS1RFbO^$7NqNfbf?6}S)rB<7Vp51n~jFcf%2o*O3c+U_W(FHge z+5c@P^Z(LK{V-_y`12GS6VgZUpTBQV)ju1-gcK;I7!Jttq`G8j>=fskLMs@$s z&E0AcNi;b*1usF23_(mB%rqZC7!yZF8be3K3nLFUx%MN1M)CaP15reTBqf2FnPqwS zwIZ^CrmQRux$KRZd4au|y*(;1F>l{$i!T&RsNQObnZJKP;WGE~GY%6I)8N?Hk6Zz# z)x~x{P;f`Uo$2v%ceR&uaD6>rpDAx+0<=57K?^Cka*^RSyrL4_k15+&>3w=gSQidu zANQf!#9pI2Z7_WjxWC`y`PlIATWT?Pu(-xqK&XiDK8L{L`zqH|K8gc z3>x)6kvZR;iV==bVvaOWfykd@=)Z>#Oy;bS5kEUQ6@axNJOW)JCvFOzhx5w8z%0>b zs@C?hg;!pAu=h+?NO^kl+uGXFr3}%fjpV7ZeoFh09uM4ip` zW~P&xjt;olppsHZ{BL6VSi%nxZL20*#AwV228c17t+6+m5>K1orb5dP1pBK2cJqiR z+tXwG25sY=w~NeP)t;LCb?1&NjFvhkH!tGx`O?nz;Hz&OqN({}$qgkpj6ka3JLo-^ zW0ab{e$3^eO_c((Y(ih|J}=PcQZ3!MvX`er8XZNbJY;mKO@U znC3QG#L$d_6ktsIsIFR0PZ>D|PEH){iAey4Yh`^UuC%q&LPecM&ljtvX5F=%jj#zK z`#{cV8FS=^xf8=>=gKS!8aU6?<$ASJL2*z**9wjfKkc{Z&y;e%Ua5>bBNOB%qk=q+ zv^7*%5W7AwZ$!2V#w-uav9#noN2bc94W@Dtei`Wm>A2bmR?{k9; z*A`bVIxwyBViVfz@p@l%))~p2dCcI(OLgr#47$2TXlNCcHUbX`dz4&uKDg@J9AKZj zb(-0|sj(OH#JFZaE+a7Q#3ei#p1DY6O~8HBl|Yy{ieK#6wQm*FUx;DYP(4u7y|N}~ z$-R~-i-UYyIC*9++_Bz(Yl)}!JTMZErZ1;Su(C}qfu_2;I(T+grz}8`oQkTqrw4hV z)oW`QKzMCCiJ_#TBD|)iM6-Cv`sdd-y&guKr}djh`_AscGegi>yJ%3D5jn%@NM26;Ak;gsXH&s19c0Mb z6mx}d0o!FMUTHZ*y=^0`nh~$uQ-PgMo0lUFUj~jfk39-zCx1aIF-jjC8tSgxwifX| z2B}r-ckq~@i~ViDwVN*QF8TenUd73T9Nn~r+_XlAV=y)@ZsqVWo{!c)xFXjdIoD>g zspanK$V}V)_37ECJlK1$2<7kOmV(HgBhq^RJg?6<^t%+?@Jr2XCMY2snc+QzKXSL(GSvp$}k-U&l$ zV^QsIsxdPuNOJe_@tJM4!Ust(+WJcNIYzmDlM=O>=2MDD6Ax}9mLEmV@@MXfpMl;t z^C>v4BZ2lKkM)TSg?*dBhqT#!zei+%YW9}>!*h|=9Wv?cj{d6M*8myxIO1ktKskxT zciXx^3Qp3A%@Or0tvu&}E_DRda0-&ww0fEClvSA~HwwtcQ%5I#mF@OBHGeXQsJV8k zs*YQB&fD`4dB#xS?{jmr7Jib2?vr!Wt};UFWhFDF>{WUoAbc2xSeO+zTbrh@Sknn- z6yjyIQ4xW<#zN6a)mK$HRE-rD%d)KAUx9Oj8)rD_I5gfMF0AQ(y>IU;@B2Pzr5pDn zTle^MQ-Ha}{oIuh+3P;Oc9^nq)ae}7*RdNiLS@{w5ywp@)<+d$)S!2_^F4CP6>${e z?th}VB~n;=(r3-Yz<}=BOih>@sOKaJ)zXg{j>NBr*3<*edzgcL_xaa`2GTk4JEeN| z`SXF#)Tz;7knt#dm){wkZl|AvS8!1iy@GAy9UBzeZyIHNxFw=A7DPQw>SRTe0}*05lIyXxD=$#pz$f7>%w#7!18!(eGrqPZ~icP`ggEXvzvR` zFSHyvMj8jud*_3He53v=Xzw*`eqyIz?nlRE@|$dqey-3f|5c#I>U`XV1o-91fdpE+ zsm~c1^ebDrynX%X_4Tf-B&sxZaFOUutq>Hi`*B=9U}$=uIDAee<)+(+`Kr>8tA6Q% zXNw!!HfFi~-{kR|=9Od~$2>GtUtCV1Dhs=x}rJn;6nIWlw#7;m`(@xC{M=&;SkW1 z|K%L=1#7f1$7}u4X^{S>80*-Z53iUuj}1nv9E>BmpPj{=XVBSn^U%N7*8W;vUcN}3 z9UYBnU}#uBoI}#fLoVw3y2WF!NOQcF({ZVzqNOHO>lx(vVZxq=)T~U-Fj{=5@F&*y z;RaF@SVyi>OVRPlO7Ch^%~qCev!aoVM%W_nqfYduVxY$8cL&hwC9e0Ex1pAy*``Qe zCGipu0x61_tFL`W{0(qTYgo@MDsmvqB9U{#Ilc6$nh$mr*EgtJ@e=!OQFU9f#Qv9 z&qr0qce3<@ZO5zM#TfF`tdbg;0sCJ_PtkQ|!Zm&=?Nj>Whak0fk1nB{_-%#E(spOH z;QPGe>WjgH4gYOfN?XWuv_9w@{EqLe@nIoH!^My0_^_vacnyKoc3R{4tJEfNnuRam z_O(*3k=MAB+nmEYafO^jXdY;8aKjp5;-X*88H3*HgZqgvAHy7XzNNw|!E*EB^=m$i z>kF{k`UawC9yV@=8`eo<65l4SV(O*H($9CLeZjdVV2Bct*)!}j^P>&Zv$T_P5x?N-M5Y&-*f!QXqDEUl%!%Y$Nn@ zXXG6r_hVr<>|mzsq}uTt98N4RFZg@)paCduBas4utVq=Fl;eq8&1X>uo)DYpl2T|_ zekm$ClvXd!p80d)+aB; zDytg4eZ|xI&}hs-nZ;m;;D!&bpCdByma>DP>I-I+;<0iU4{3ocv7%kwP3@IK;0nIH zo3$np%`07D6iH;YJhiUAKGge)^4;uRbznjIq^s8$$)@&8Vps9M9NW>d|veDu?JQz{Ev7bI{Q=( zEwLl;QCu{+?O)hoCu(ONmqlZuLsEhh^E!Awk$yrwWGJ_bnB z2Ji)u_mox!Hx4i!Tj8a^H)DwK6}iBM?P1He6;H9$uEwcWt`m#r}(IU!Em;;Ww4qf*4UynWx(*mhQelI15~UWQR2f9J#w50!a* zxUaeXqz$vTkIm1gFE^+`CM6{Wr;8i!!MA}B*XuX@(RT#{6mWa_qd*}g16Q1wn3z+y zg+xnB%l#R6hh)*;QE(jY>ovScwB&5}3PHUZj(?w3-&6I9kQ0PdLZgS*_S%nMHh}^q z!URYSQ5YE+mv!;+pU8hKg)pfjgIv$R00wv4G4dk;^;n*}6nRAV^~oCVUSS$2IEPqC z2-m}TABz&jcqU}qN$aWvBVeW~4U;);JK^9=)-#%p%pP1`6sSJ;_m$Q0Ve8TAWrhCs zWFxoOd^M6rk&gB|#Q!UY~Ztoa>hff2WZ*sXf+|Tzs zS`>|?d6R666JY|gv5Cf?uKW>8@ro|(d!k3u4atPh2?{|`5zi^%rtj2v)Ywo6Jxk^s ze+dY_yW{;2_ zgj8gaFKB~sgoTA!NxmF2!0SGbM|5R;{CRKD#Y6w+&-*omQ)gaX-ADayhtX~n448vM zoXg=M5AP0os-^_9S*A!xMk3xjO*Ef;9xv9N59x#qbd`GM{hc24@- zX&jN0AN}A2dE4%I)sS5i7ms=zfI|(M4^xp@i~Uf}Q!~=$O#5E)E$M5E9^U8Jo&*B= zHcwm$Wh}Ija07=5>Zz%hnmog5`en;KNtFjo@a?yePy2`5U;i)aA^&rg9Lk0b+%4GuB$gj?zpr+P@0XQZx%yc3y2n+@Lm>vYm zS%ZM8NcZ7_i=Y?RGpR^1Tzq_d92ybw>1h<0gD423rls{EIhlxrjBIVb`ThFlCTxB1 z9T=RRz-!ijimw2MR7_VQd9U^3N=w^^Nhc?K`J%miAlm#}&h%7MQxn3pq21Tl*EK&+ z4S|#ai`eHR3x>Ryc0?k7cEN{7Ef^e*O=fa9A0)|1dX`x?`}?b0wc8e+w~umP>rux{ zkr^QrCv6<1y0jFFHsBnBg;lv0!`%Vx3`|8Zs}=ygM{Q^P>#lEldc_@GRFesyf81}? zfPVJ2+g&0N-*fQq-!-A(w4n5ijMcNBoqfyQQUv5p1Qr&B2xd6J1ZOtdvK(yyn1h1@ zn11B9Z)}|{V}NFfT`w<@iwBA<`W*!U)s|~zFr+|12(zoCr0SiT^K&Wz$4za_!v(J; zsRSC)YL_*1U}p~ewZbu|4QM|}#oclJmPJ%ttVSpHg?_{8M4{r-$^bi%;IH2vgJPp* zBLKNEg|=p>H8eEJ4Q@!q9=x$TKM+7Efej{`o0}5!Lj&{8kE_}?Y*lOnmvs)u^Wu1_ z132)l2bbBL2HXukfa<*9_cOQuU5PVWp1M#ZJSrgG|j5cTss174vONQR<) zQDW|GcKddGnKN27LFC4VrF~@SJZEL}kbQSG)k+aH2B^6>jf{&6p{r|cjk$tajFj_e zdJQXUQ#=p~Ps#wyXu6S)d&0$e+_xvkaz6UA9${1*6p!Xi{1aonK|(@0I|00)NpD14 z`kP67VXwnqwv*%lVph2q60WX9Pa^FCjyWYIWqD<#o4Zm@bYJxB)W^WMeE+YZvBBsC z>ePj;S%0jJ3qJ5}P=tAT^fO7I%Xgs6<8qe8%gvQ*To?`%!rFXlfaEdona(9ikHHN6 zw-6yi^^U9Ns1c{78K#2o#GIg!;b9){V_2YzsOp9K<+TWY)7nmY2kC>&dv1Mqhr1(bhCBpzJHG4~#kRm$&8@J%9)& z^g_`9Ps`>dTvpU(ex+J*AkN`v>+rMTj^#s4%<<2l@&5Cj$tPRUM4APR^J8l2NlYe_ zf+&(-)y46tcz!#7L4kAvF(*nEAI}n$r(Fd#B7U#JfjQQpu@yQu9$#F$q%Tb-I zH*R=V<5|767TpE`iaPrE)*kqY7H3Hr*7)2`U2}G%s~UA%1SvgPE4!r#-P}^maG-c) zVAyp?_3snq>x7lk-(d<^Zn8QPZ18V;J-aGvCTC{6s)mQVvDJ(lVmB^syu$Rvx`YqT z9){RlRZjgb2Yh~!{|4US{cbjKo7bx_6KG5D6wNG{mpl7jQcQ4tQ2(!G8h7$W^bLT9 z%?pEG6&ru6(yJ`mnBc#2iJ$6mzb_c zPYpRgSMq*lFO_O501Rp=H_HIkY@}f!sPb4AO6h%>lv9a_u3m}=pllz#PMkb`J0kH^ z3mTAva2el^1R{%Jd>T+uoWp}7uw8CABQOFJfaKp9D_YL?Hu4x9WKK^{sgs);QWsVR zno`RdOOWXjvheZsWuBl9PQ2I+{wXcpE&WvDw125_6#?Su4Li=>y)Sxh5Z<;eXd$>U zKu?D{Z>93c1@5IlAKJT5+9v)P&|f`-Gh0yaJZYWj=}bvvRb}^=L<;e?z??4|rwv zb~w8NVA{ZI!ikBOyZ2AJA?zi4im$1vt7}tM1yxXagA>HPu_KK0O2&@d|2qh*OB=Nk zdzv;T414yc(e%^&U|3L}uZ1&mwSFDRL#dG17>%a9NTQci&(ybsJpThFl6h3;Ga-Un zq>$cE1D5G*U@#Jq#@^-Rrooli0dv;?8@>SJ@LGwVQf1}1Gxi&t^@ZS5)^RYVHKLBm z1Ao-vlHc6Ia6ozLJrb1EIhUgJNAAaKU7gxN6}zB^E8u-jPjadX@3qqw@;IQnwOEu# zhQy}@K#>Y?(jPz8Ic|Tm*&2Tic&}wLH^3%gmX`h8mBj_?q?|AGX@ZB1jp)RrDF}9h zKd34ok8G~V(gY<431Gjxk-=5J+^jTHEAS-H2#(6Mf}Tr7T>!s|cw7xtc`+ z*9!+>vVGuc6LENB<2w3jR*vkMA`HGw){R_kEIy)@UD+dGlkAluHBTEPGO@2P4N@~O zK(*V`nqTI-dA;g`lt=U7Fm<-O7b9v`TYx3Kt;!L+f53-*Qkn+=$$QH2iJ*4)Jl8D^ zRvQ;+pcBLp$CXC3I*!MRh6fM^C&;<|{_*PCM(|t2)QdvAK(6g%Rkz%cCj*x9?$v3< zJnrT%pQ~69uBS4sno0$9&>g|)?SoQHg?v{|tmb9S^o^zI=u_e)y$-OgVgI|JS9~M% z7uMrlXIWBK7QEh0T*A>2Pdjj>hgPTc5(RO+_Ks7(!N4vzB1UZCJ%zaV^3Himhm0syD>m0$OPX)Y7kKPfF^yy=QSwAG`7yGTvODB?9fh8342n-Wr zxG244Swy8HM@ZD8vy`cDf(qdAFw$@Q%d+fN?bt+1fP5HG!BM@{F~j_=CzVt(iU75h zDNtFN&)+{s3fdFR(t)cbBZC%*IAMJ{$U;#t@cKqS2Lk+LDIZdu@Y8L!^=gi^LY^3) z5z9YOF)?+cZ6=FWZnlcg%Kpj7_CK?qJ%(H!i4RuM!wFu5iW4)^!Ng2WO|O3(Ff&_{ zAtP`8U(pbKIi1(c#L+SSt6aiynfoCS)##GeduOiD{tNx`zd)$LiHVv~@ek+#?Ln|- zCk>fj?|%oE>zrt%T+uVa36w)IzNDlO=LAfn0HnpURrH$!z?!xvi}8z8E>^UGFG0Sd z;!Bj|{3-IcZa&P#A|ob_QeVTJ1d| ZU0kIxi>pu_0w0lq6l7GSE1|H^{{!uu69NDL literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/vs-installer-options.png b/docs/build-insights/media/vs-installer-options.png new file mode 100644 index 0000000000000000000000000000000000000000..6bd7c59e9f80cd20870b271028a142f8f001b36d GIT binary patch literal 19853 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 literal 0 HcmV?d00001 diff --git a/docs/build-insights/media/windows-uac.png b/docs/build-insights/media/windows-uac.png new file mode 100644 index 0000000000000000000000000000000000000000..add461eb50fd62ad8f0b77384242b80fa0a2f2f0 GIT binary patch literal 37564 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 literal 0 HcmV?d00001 From 585322bd6e3121ef145418571a4ed28c25b6ee0c Mon Sep 17 00:00:00 2001 From: Eve Silfanus Date: Thu, 15 Jan 2026 13:50:00 -0800 Subject: [PATCH 1546/1799] Updated copilot-usage-menu and vs-account-auth images --- .../media/copilot-usage-menu.png | Bin 7298 -> 13063 bytes docs/build-insights/media/vs-account-auth.png | Bin 13967 -> 14132 bytes 2 files changed, 0 insertions(+), 0 deletions(-) diff --git a/docs/build-insights/media/copilot-usage-menu.png b/docs/build-insights/media/copilot-usage-menu.png index 9ca861d75b6b19181e409dc0f99240582cba0aea..6fbb212ac934ee24f531afd26aa206221f89884a 100644 GIT binary patch literal 13063 zcmb`uby$>N+b%p(BA|o_NHa)CHz-IsfJ!+?w+KiNp%M}Tf^>*<3CPeb9RngQCEeZK zIqC~ zA+k*&5P_uUFd20h!>uVVdzz(WsohFb@hj4=AJVZo{snE{ii=xGS zp301KADQQh_rD4Wp^`?2!*>{l%Qhv)qcyKeG=H2}%L{gtg`dRcSEishna7-#|HN|z zP>e1vJ`ji}`nx9dckO3g702M%5>1my$gHa8ye_?DYylWUeEsZ=`aRQ zcCHO%-GFq(^2Snji|?7#zgr_iB9Rb?va)h^K|yrwa&j$;V$Ao#LOVkr?!<0rREM#Z z6~RhxDsK%UN1b3{VIeywN9N5NW@>8cL(+Zy9ldIj6?Sl!i3t`ZuOaMlvi#Ghz7OBs zuli{mg8CLr$;%T=xgd*I7}0Ic&(H5oNXY|ip_@YEuuV-vQ(`kF(A70^27c*qb?G|c z(PdtSS+WE@aSWG^Pit#yok!8T`7?3nZCYSX3SPr}DXDDumsLxPvGpd zpqweA-FG2jVU4BWzqj^$qOE_ zE{mRaBRsJe4G+Dgr5S9Mm6T>1y|JHVszE*pTMy5+(jd6jT8!=p>ob=~DaP^)P5iFD zXjhOF*nltQyvq8XYh`E&feaTK1oL{Gb!8V7#ZumYcwS%3U{hRZ8X1LK7gn1OUufRC z+WjI0jzLyR0k{uICf>GSuY|8b?T5L`vjgNYIMrFbnRAN5hI6aS(>AGL>=zam7LCi@ zi6yQF<_b+8S#Y-%q|V{>wycJ3Yb-WXHNuE*RzFQz2#D_7NvPl@CzvGmI&Jn(84C7R zG)w!|=&=~7usirlb?w@y+L2{_ecc{xxC>%f^X?(=DEs}z=k@4{3A<(~^ng_Sxo!@! z5j{TA;J;B=dna7-JbQ`#c(mlrX{T0$&lh?({F6zi@VYqfjZd^y`EzPI7h4Fg;QEgz zSP-8kMtOPp-Tf}!g%(Pq-|g-AcGXK1^*c51H~0hud?=0FNqJG10+@S}cieA6{<*U~ zlG)7&i!2alxIpji{R)UZ`e+2(zb|X-&8(Wv$L;Eshz`?YyQ#;QQ#0sf%S9bvMOBaW zSLfFwMMemM@TIQUg{zC5HrvW6Jjf`@3)K)}!Ng~ulV5+aT`O&Os2egA$^bcCWRtoD zaal=rUX;7HQ&2hm%NccHU^7~L!@$7c*#olk(u9Nr+-pzY&Gs4Nshal#;YHUt2(vBD zBxbLujY>PZEA!tqsSX|=Jf_b(MoPeP+|g`^HCq)=6`Pq;r%V&D*1HVM<%tLmtox9w z4b)ZF&;0RZapyZH(;s;~&$^7}f$RM4&rsL{)}q;|KcR=rs$MOs?p_}BE@Z|UVmS&= zOw~GXgnwc1q=MKlgo-8%iz9xr(_dFlig72>HQms#>ppRM%69aryEEwJwSZ3~R+ALX zFscP+X40J?4Ea>{wzo5QclzVb+)}L3@bz_`5&A`{fcYUX4mL#cYA?Jim}7jd`O6;W zmVO0>mN(%~{IgQr2v&NMoBR4mAhTbjE}1~~*{k32Aih2?x(+JxJjxp_dmDcBQsW*t zbYi>uBTd(#gI1mgGut!1Ca!s3N~Hq6GkkJ0_HW9W=Vczg;MXJ4=dd0z{KyS4HZ{fh zc)Zz^SJV)sW#n;B^~n+W)n)HBEl5yprDk2bCE*@KAP*#pB3fUmKFK`!c)8bBf|!vs zzO%hP5&8B7x!Q}Fv4prd2vHgSqH1A*K`jLx9UbHo#sx)Z+yxE2(CdBn8{x5`2a;iW-Lu#inY$PRI!`)$sk4~=Sy5rK_BV61<~?V6 zKf4HGI^_J^E#C-bxZ`v*q=gOHu0JvSZNmTL+my4o$QSf5)7e2A=@7)rMbJ)^x8JM` zk>(Xn&=?+eWWAd?krkywL;Fyhvd3B6%}WSfww`iD=2anv#}m!XFN^zWdD+~3SunL< zN~6NOn|kv7h=I%T*xS9cUN8EM;ezG{j|=;gDd&vp>idR8l(%o+uA1|w>6@G+f}B=* zU5H9tUmhTB|M*?(pcqhBM@5)a)77V(spc~4ebat-R_1bR=Bl91WjbHG1gk`wXhh#B z)RX>XbIiBgdSu-L1S&nz?b~xVrB1!Yna8k(^LIYYKp$jnln%&PZETSeSwSx8v{87C zu_DY8^#UQ^#M+PYuf0y;_BBY_m}ajSsw(xEFxp2xsMBCnpF)QDVe)51g$SeQi>oGL&+j9AE1k*C z(}4;M9^{C+J$b`b>gHpN(}Rna=VNCd29!l#&op>Y(b2Vls$uw~0*P!TZzQzpc6;}X z=}g8zgz|^TH2wYG@1_gebi;4b_v+@S8s5iKRMv+Wt)oeif}$a*b;8aW`oQ>^E2&-$ zv)?kMK#+;q&q8<%YJOB^4p`EP*-P_29gPn^tI|xXjd=YL7;zv3`)uzQA@8d2wBy`f zzTAot?hT88Wh7@nqFEDa{kLx7j``{LR%?3PiO{&@U6+l$Z)L(YRorGoz3vY)p=f(Loq^SCT^t?YI_eXrEDgi7*b zKT1Ov8N(KzeV5@k=bo`a*yw7;+tXo3A{lyAowtt7H8sJu(gmqg=vfpP+Vr|Ts}(yi zhYwK7B9gNeb8Kx4UbNv-S5>7T$K3*KOAg8{>M^rFOo0l=WNIa&i zY+_(JEZQLthuO6@DRmM+W_2#;U`}Oh>D60*@UUY$zs50GtsGAv6rMiC*45QLtdM5> zaEi$wsh5jv6{0t<7o@JR ziKQ<2Fu9gJ2+C_{&oC)*VLa?jht8-IF}oT5*2B)T2%R+=#2-Up9z63!k?>c?$sBUP z@^V!{O4i6IRr1a2rOxQ8g)njZHah27!PK*mOJ?cqB3W7q7ZTpOT`bR&+L^U2=NS*t zE0E=>LqkK6SMt%j9#wbm-d$Z^|K)YH;w1|wpL{ox49~{uO5M!kFX3_M4P3BiD=LUZJU<^u#dp=8@Ea^dwK%qsZU03MP zeqLMUBl9&Ih0Wz7hIw9H+BsBJJ^#MB%6<+DAbxYd%jo@55BA)X zEdE8EL!+Gc<)W46+B<4M56(kN{QdpwP%EsdwO~`mj*gCoybEPxTmTgAwn<&VubmV$ zFP4wo-~e=~bND%}^sLP!Xx{F%7D<%ji2j?3%E@^+I5Lu0h~+X6LZQwP{R_ac6=AMI z7=8FnP+?q|pJn(xc2+sIb#(lzP8O+19L*8cv5Me3IywU2Sd{xMunyo6aY;!SHu5;R zFsMJ`9$501D0Uk1h2iSN4h$n0XwbkgE|+>kF5RE)`^x^_im=76^N3e4m=K$dLKWCe zj{1utg(?F!C{)+Nutq8Zox+P$3J*iSfUY$Kw<68WNRGs*cV!)QT^eRGLE5b}?_gspBf9pGS z3rlYgm}X8->|^zH;R70HVP*C8f`k;V0=UoBZOfJ`*`I%$)(3Mo!D8l)+)4nVpNK4Q zz;Y^AGGR?$hi+>P4G*u+5WZd+%y|V!iG_^~*J+M8bJ1x+Ie0|R-(D`mizJex)TaGNV|C%CMd`Q&(8BjNc&~MQMt7Sa(dS8*id*|m;VXVnly{*x|QzE z_$wwLTQ^|#$gRHJRKV#tx!bL?GZPD58!-_Wkn8R6Q!hJ4kDxbo`l^fzB7wdfQ6>y2 z*9)@`%%%>!yz69d=5-wHbrUi;q@tRI9?fMr-CWU}^;b3URV~!>S0BH;ck66`%n_C@ zXcL&N8+hrI;ENJ>pzpoD&~sT#8`(wgpvhLIMQ0cek|bOOf+yMjg#1qJXN0C-hJ0pX zYbjOd@O662#$UC=U3WO?FgWP4>)e0syELLQV_ZfzM@9;_w6darwjm-0-zUYj-P(ggXH?a)>6)Axq1fo}ICueQFku+kw zoD_{4vmioy=e-tefj8S^R7t6cW8<5#J;nDr$#F*b%kik((ez*b#U6t)vZY&$1z zW*A-0Q(9PC3v$l@7WWV)_bG@h%q2jSAmc8Z3L`ne>#i7Xk z3os;IQ2OGK9)tU?4116dTdMot!7%;Z`__#ZE??rXAdex?B1fF2tP{z^fiNt9fKzk2 zsa7!zqT#F?kr0EJtRii0Za%+Gb>Dx^9`yA@o^hHz#PhV70b^t2`)N>=FvM~xkp_Hq zRpWcB>nk)^XjI}22tcWrUrmN2A{un;ekBN7M?8D5Xs#zXw(b6s92XdpoBBg*sZSl^ zLmPA^j$DgjW28v5-0O0I;U?trxDq8?epe$m=$8H-RFySqKmF??I+ot@F}uodvtILo zY{g*xpJkbT>JGk@^BB?AWG|QGxm#|rSIqH*M57curmer zkPPwmzOgxjGC~EupZ|Red}06u<_{<5AOCE*F5*1So9Qpq;ocbDP7?@&?rc{@%g)(| zPBg9WPZSm<$J>kq@_OzCOK+RUD*X(UEY--Y4NaTLs(y97XhnQxW@ccyJk5f?7x%H%HdFgOPNu%Vps#gf zM^lt08KauDC5d6t`6ei0=K-X$>x~=IsbLS=(fQ^io50g+KWzPKY?L-!?cA7X@DLB9 z6Gs+3y+X~J*0zUI$bGV%tSYgnqPZZ%7^Kz)5xtD=oS+=2`pm6YF}qbc(<4q%ovN*B zZOvI>GiJi^Tx?1--SNTO2V4!rBc0diaS{k)#mR8z?aAr~SXy_qN=L@WJNYt$pl=_T zlT_W)Q2V~m*okK{PD!f#X7+E$)>N(N4qhfZjm=mo3qq0yUXHoyu@`LgyU?Ik$;rCX zZYs#z+xt8ZhqxZ@h}x@HzMy(EZyW&$kukA*ACH<;gDcX(#B^eC z@N-Sg3+J}bgtXJWrtpd7D=^r6sL zKKsCc<^I&GF}6c5LGW4s7v}j}*s%faEdS$%|Kr6I0*XKw34!0@a&9I&!TH6-l6iXR zTtPvBoULuaq-RSo4EmD15J zPsG(o4x*V0qO8x&1&)twTU}lCxf$~c+)f?3O!t(J>RWBkeK|Nuc-xYB6kwi^;!Wq( zJ|;-x?CkftXHqNkD}lN27F@fJAH{(zMi%(F4j&sE8z0Zt0)dF7jJ_uaw+T*0 zviN&gN@m(S8|a9S{nVBT{T4wc>Vnyy__FXJcUNGi~X7|evJ*8 zJ>6Syo7mmu1IB`U&&sr@dbYk@>&dh9iC-K1yDhKC#{Mc%ph6qoY zX=->l<^<0~D|}ce^u0ww2}q(@yz8l`ip^{(iUz4(H7{ zd|vo9_wRM>kcqX84d0oa-j7d75LEJ!&u~0ZQbn4R6BC4h6*e?THWnM1NJVmbe{Oy~ zKvRbA$<`)gnrVWiRa_Il@NI~&LyVe&`K9Y;W;>kw3htUmFI*QzDPN3*?Fr~>Xt+8& z$8g&B0S8d|hIxsggSnqd^NZSxe?K!`(-IuwegY0L@Cf)Ea)wSr<7k0YhI73SCaA&h z&1q<_g5_MnOAB8iC$8-pQ;T*a$|Mn1dZW|y96|w|e)qNGhopdze~N>tu2uZ++xu5P z%gfhp(1y1i?TX^<0Ux*hboUXQ-#d7cy``hQps&5{7JTI!gC_H$TKBTr%nO0|&$+n) zEhesJeq(%w{^6maOSn~3GC}=mRNOIyXUfX@nZFkth=_?3JDGu#x@Nef$7g3Z-h2P# z3@;{9+x(uS<86w+OT`*nj)j1F$qf9gt6gyF&Ru-T!GHcrL%8S<)aUu6Qd!Mn>Mhg^ z;>_Rly9i<@mJHskM zMK`p_O+K>+9OdK&#l%nyl#Z>gtzn)Q9WoUN#JIQ=)pXtBfyGfBRFs2(mR1Ni4}ac5 z=y6^i6sm4Ad+sjzfb7=KpFbD7>&b#MwiA#`xOt~2{Sy|B=#@Y5f;tfGI+v2Ve5=EglZ_cYY1rc6SlL_9 zVT$1fsb(-Md~Pgj24=HU5G{&H%3A+(&h1tveS?k(Sf=^^kc}~UJFJ0w^Kfmz@h&O6 zMX$lVdeZb40@MbMS7Gv1FxaAQLyR%dV+qb#`)DcJi-@f$ef{dy<+AoTvPNJgsb~PQk%pzpy7pE+?a)a1-R` zE8wk;S_B!+XS?YL#flM2o4_m8{f;y1bJQLB0wFmNbm<$bD%fhu$~%Xe|hTg>cZv} z?Fpjqm7by^Az0MWb>2TE?G*#WRqD&+c};EY%B8Y*Hd&_HLjb67!I!&imbBS-aaXn* z=xarKa|X=H*{NGUuqvK^{r;Ab9UdMY2@ziZ^mNZTH~fa8l-o=9EmviD%}xYuz(M~41H~o?SXW2 zbNgjcFj{ zGY~4Zxni{1qTfOSEcG4h2Maw|vAjPS(vw^;A-{Hnc#z9At*)|5P05=U1D&95ua(9O zw9jTAx$c`%Kw`M{Sa~yWk?aH}CE8;n(Sfd61AH~lx?3CQl&&d!%~cE^KzO!VPT;pBiwxx!PPJ;3@GYLkO$Y=NX$1)7|@lxOOakLIuVc|IE(i5WP$KDN`{vJtyZD$N&f(e;(}0Kfp&p)#~c5dHUr})6Pj( zHw@={MFoWvdQCNr{l&lTdH3#}w1&omsOPSv5C9j`Gcuk6wx0wrcC78Hrok+DJ$q2P zRK685?PdEQ8(Cmni~^MOvus*jO`b(;W&g|!;`~fj#AXz-C|@c7w_4rY{6@J3^B6ge z7~7JfO<_oP)GAEV)9_9NJ~cfZ2H+J8>J5Y5Sj2h;BvJrX`(oM1Zh>k?nUH`4&PD}@ zFF>EjV+`Dqq6uyx36&=tHZz;Er|P#*w`&C&0VxsQl6i7EJLrfAZ++yW`kc=0%50v8 zc6RgxP||Ug{)wCV_Iyn)!6bMG6G$KO0hmx%Je6jQ5cMI#^92ziRDMGmfhd~9fq-`L zm#ZCV#+N^NIPYfYzj?;?PsD@n+S6WQ7?c!P@zp7FWjM$o9v&XZ4<&!vJIjadCauvkS7h361x>f#hXwWmNAb{14(oegGK7O7qiHC?{%$IJNh!m9?cM2!!mM z0+Q6;FCaT(+NieRtpNA9ZcwOeloxCT)f7k8U1wqp2l{ixW?dBE3>Qk;=$pAKC!x*` z217W7eIPh<;T4sYi7~;{*(LceR|Py9Krax)IygxWjyPI>6=6})F6D}#WQKH3Z`z8b z{g3+Zy@55AgjM$Naj@KqTTDvoN_{5WB~uLvNM1F8aGmUqEGgly?$As-c>0coeWX}U z7_j7GHLD!ihfANTAFO8q^i#2f)l}F+1OXrA6xPZfNx_zW=r>agkyr8I#7Vr7R`MV_ zg1=b>cC$!8Ue73-sOMPf_LEk!%d`(v{l4lFZOoiD@T zU;P7Q>Jn|PB9*a$fsE@-(CAgy7>WfOp`@eh$+8#Qw738iB(>E{LWE!W&n>omhn(6p+LtIo+B;s*DnRUfdCUwY=MGBlT|q5?;!^*Eg{AshDpN67wn zx#QmvPneHFF$ATzcWeE8_8|S*@|-i-oePad3rdQ(8fYbOdR%wOwBQxu3!ISxxGD)k zte^L#1U*Ov&w#`Ng-8p;|Is^UPJ^zLsFm*p1-IMl?|0szdyE6Y z)CtNpgyj6nN^sPh@9VD|Kz$(i4+aR%qQ1WV{Q4#y9v>gy_iL{P1)qb=KK_&AV^CN+ zx}9D~hL_D9J_61J`2_sNl@yHC%${7NStisyBVHKF)9MOd4jI6_7w*l;!xWmPyOz5b z=V#1k@hC_`;~wBkpIY#>KkvDtZjtJM6c{R>!D1jwgTMm51DF>!1QgM?1}lVqvN2MK zk+8{9HR~eabu4s(L`SL%PtEJ%*>+-SO;iv_@(H_~UKuARK_O+qWVRASa&q$S1=^M6 z!5gaP`B4Jf-Y~Jkt1C~1Hb$#IA126GUQLQe^xBpj1Yn`we%RVSCm3o9-jW*2i)&1_ zwJiih_vzE85Kz(lVbHntY&e`8^wpmh)%!QU2J2e!ON0Z)@Gt5}Ii^OA;c~9;4fmi? zI$K)K&dyEf(s|R`Ov#%xA~p~Rt(2!ef`*>ne`e<<1fXf-ckk4VSSy%&v?S;i6coN# zrh=#^x-SmcR&K5dDD7bJa^WD5Z6+#|XAHS0$|jLWODcMLd1xeGv~^Nan_9pwIm^R6 z5(KqC)`jXY2dn*70Nlr=J;P58EH81Gh5iF7DH9+>WY;91ggCx3o743ZgS|lmjiE3o z#xO_2)6<3^tsNd6#gFrMp~=ik4cOczji%W@fYmWHRg{;<%QvQba;~F*7k~ww_ohq7 z|9au&g`%&>{Kozt+_G`!L~l5KNi^|HEF2^;%&RBJ5Y(DU+fqw;r;WF9u#l0BHlWiU zFMnemz8X95kQ7UP{;O+Yd+dNbIRBR#8g?mB=!A|B$ySz@{a%J4r!DPTo3&IoCZdf( z%y6?V{?5#VTL>kb_^XF#ptb1(nMYJb7*_i2lJ_MER8CU!HI!z9jC`!zvXZ;re0cmK z#ky>&ke!JIO6nTPnWf-P6d5z70=EEE3U1l&BxpHBUzO$=^c+ik6$fykTTLu)$iIYy3@0hd7mvbKysj@jQA>{%>mR=8QCG*1FSMMoutv)|WuFBPZ-2{e zngw3FG@1|lp_Kp?C=cx0nYV|u*_2;_wDJXs|F+sF&9?g;D&)o3wo-~On69YzeCYLE zCSO%U14H4;X%JO`Xa^1wd`8+kD}LKbVNHQ*JsATtsFW0Xiv)AGdQdmsIXfqw_fG<9 z>o>x@J`ov=NFWK8}|6d9m_fOI_)oZa6v#@O36@OLut})g|NsCXf)bfnj)fj zUHyOzdPC20Bt3|FCDE)V9}xw0K;`RBVV7%Xp-xB+x&@*J`IR0f^vbaa~) z{kx>V!a&EQb-{r>XnwVYHW2omonU^isxI3kurY$6!&Ghiah7aaM8=9~0|u?V*#-rp z)_`<*LBFT%afdEYzkvTXF)Fi0VZyM`;vcmT(2F?wCgYdey2nWk@F3Ayj4H$5X2M@> zJ!J2;ZQ%(h>-m31mG>0ke&r*V0S9=rz5CvC{l}orbOv*zAT1s5 z_WR_vH%@0m>9x`Y8H?v~aoU}Zx;|uxP@c>X@4Da%6NB^35 z&KlJxbi2E|dmpM7ln%O-?ksi%+e4qp#$W~IZO#mGg4F3R0pCXtk z@)kh+h+17{<|Fs%E$Oc#JLUg@@z| z*C*<=LAUiGV64OkX$kPxvt^`DN1E9KE6rB5PX=dcan<^!|SL;bYN+03<0(TNAvQ>d4U1G(XHkEvuyc$bX5SjqHxGwHRa1=@%`xz z1!`mFC$;XSnh@BQvgat>U9L_lL1D_YCwC7@4EX;hBLMaSNREn{+9x;HNv%iQ;$Y8R zJu2vqKGk{>28PEz_xrPC7Fovw6vg}g``vhZt^835aa2oPqF4Fk1aE7{?r3HR*EW1G zFP$2Tc-p+ZKf?1(@rgO$9ok$-Birufv!AclCGX82AHbD4B<)*PRR@0hWGFkF*}9Vg z1U5lwz@#!VG%$b-iVcrwZEdYG+Sp|wqPc1``+40c&}PhLKdn&HAZ$( z`<;(JG^@@0_MAM}QVD3{xw%lFpMyiP?faq1)_GyFxEQxI#thUDq;8gr->l8NKw1zGua#T zp4v;ZW2*fwFAPwtF;ykvQUM{MZ{NDH0Jtr_6!}dIBz3 zAzF|`TekP;UYkkX25-t;P(D8r`H79OiAgwTN-``att@s#0S&UkCcZ9&A_4&G78Bf! zGQu1b%IMk-Pgl&Ho?`fatwCX=+tKp+<3W~2F!lQYm?b78m>+551HkVpS~kBY2ErM{ z|G}~dS$}ka36`_FySrw%U-9c^y!sSYdQD+@XfDzJz6jMB@(Kct^0r}k8#V-tI_wKT zp`}a$uS~P=PJ?k1h%`s^*H}{0$WSF#YzWEy_0N@sg?Au)j~+ebWrjj&z_b(u5}Bsr zVr^{=I%2`<94&o7pk$1G@fwWbgAq$G-2asl%z8+J5qvPVgBc4XjtT@y+vz*293#Tn zmP2)1At50M1PqUa=j7ykC1?V}C*b+H$!aIC9xx%po8w8iATcQyOtF?GE-4uXMzI)^ zRhSdI1>6I(t-xOrfWi8Z@bCpN2jn&yRLAA_*2LtO5Caz&@&}_UYwyNKC3soc*!U0s z+V|Uf?4PSPdNtoZpuYs8O}uv)8iBg8D8~xcDSJU@%Yv%y{#_#4whKml-i=SkisrZd z%~V`6hbBA)n*ll~OZ_pSXROc2MvI1)fghNF0TW8y*6l3e47}78qUfD#KN|Fv>lAU* z!d~Obthj~LRmsMS$8%*4Xto50u5KfCw@XBQ^0jC|fWJ1Z z?-jw^k`pfx1+8+S_1Oc-gEiHz?t}F|@h1+mOR=EK#*1s$QqHN>2`-K%zBxVGC;~DJ zI4GOTP6L)HewOqzE&I{6V8z|H+Qq3--C!`H;+siRbj qRt2ej(rTSpm8?gdEF4bP4Bn%@e177WKH!g6AkXDgV1=^AKK~E8*TWM4 literal 7298 zcma)hby!qi*Y+q#4viq)jWp6AJs{no#DGXi2n-E^(lXHirC>Pd-K)CuI7rR+Nd~Qx{zwo%6Ol~1Np5|5^S?t3u#iva=V|&6OA9^L#N2U zpx%R1hQ6Ki@P}~|>%A&Bu~d0t<5do1j*gBx`udYm?bny5<$;$l!CL!-FJHcUxQ7&MM?auZyg#u9jC-8PxpCaBia$8`Qx8moNgu{D(_e-!k{lr+xC8 zngq}JC~KT2?gJ(axKWD<2?=v=e(oI&YiHNgz?9qE#cA`4i%~VNr*w>sjqhxkydWxi zh5RWQFbxgyll@LkPumywmjW&>FHt#?c*PN%a+|P4dl+og zO`ju4W1)J?qJ3+NH|V4?!+LYH7{VTR2JGn`2%C_$#bZDw!d57%`Fh(G^cEp^^T@o$ znM9rYx)a%b=V-4@BgUzW)pUO?4QO=NV(Zcp>j1);svfqjAWc7(+vvS(F?3ucy4-~2 z6msHcC4(YVHzEpkU-HOQxaTr%d_+PgOkNXVi-ot+0CX_7ZEEfc21gzrIN zeR9EQ%5BxDQiV(Nk{g3G$nDK(GX}`a%&dbG)bjT)?QN6O7$2xbY&IZUjfo*6-~bo4 zJsEa#0t-0k;gAl1!Hm9WNn7A%Zi;zzd6%ZDLMT5iuXw$02s&$I!ZFprnZJs!hg$6~ z70gbFg-Utv%=M>9MG~Bm`02L}@CUQ8SI*AT8qH)Bl5tJ_9EoFH3fo6= zUIjHLl8co_%pEtv#{y?kX{K?SXA$;aiM}*f$e~SiA=hx3JQA8c7V6p@nsvPOQV7?D zz8CY$&Ek?0J}?+O*LXV9?!Vg@5gv{uA|f)^jbsrIx)R62!g5>cCV7z#Jv+>}O|8uB zf5Z?hBx=SriA`uO#ULB-sIs!M)_oDHv$K;J(M5vjazER%*6e5AKc9=Rv#pbYBl8*j zPdDNUHpELJ8uqp)Lg@Sh_8eV2^-t2<-pWO{usO+3WaeL_B+vgjAvn2og5X~08!~IM z$KhbTyEc3a9d zH@#1ybnU-yBRKJU6UR4jyb_}YF0+@UA)y>}<;T#FDdsU6@<3nXS_;<25!e6=?4@`>!_mN2L#mPX9&>dZY; z#J}P8=JIS+?zVtzV|_T!{qp4X-3as`Ywz;<5e-fI(o&8K-pc8vaf7LCXB^G0Waq?) ztLx5V|3g2VNUS-1a?WU?5c{3Uew?oUG2*pDX3rZuql#pn!kc{Dqv#2)O>; zrG9r(q6;amO+%V5<9cj+ygib1R##UAMMVusL+-bnAFc{YNc4=QYza$9L>;aU#PmFi zZZ9YE53o?m*7dox=%U}pCKfAY!6bt148GqU$3@i62)E9UzthJE0%i#I(kqXY!kY;! z8S!pg3Q}*Dwq5Cs&>4lK1w)ft6R$G6yk zuIJ&8F+!=6vpG~;EEO_kOz~}S>5d&t{K%=k;p)um$QSk0f4o?ZdT-x5r#GeLDR20& z|Azm&JUJTX`25w z!+K6*vWaBRK*psOsQTTenCW_N8yJkD+yv~}cuYaaAnUyO@ZK7wDw^qLA-_;5dTTQp z2+;Xa3M*mX*z*j&qeQaJc7jJCQ${&3G%psWK5nh;ph{*fq zo8wZ@TfqLJar4DP*zU|@cF`~;Zc0ObJr!W3KxK8AY3K>&j@%-z$jyBqcQJ%;n`^nJ z=q}V7_->rUfr}B@tNbU@)5V2w_Ik&=?}CADxk}xS zPUq#r>m65D4Sbqhi5VG|@c_U@j$v$?=6HE|LGp%8Oic3gkxX$tR@T<{5cD!=Q@Bly z>&nWCx{#uYg+(Xe4*+KS%!sUsDmO!p8`xjw=yACuSCHlx6v)4R{rHLVxK%A5uVJv! zcltJZqcNN5n9q#dX~$b{g65U%exQ^04-ot9PPu+Vim72+DOyl09NJ!b1NQ< zI@(|C@;O=~sd1T(CZKuJvhKO^3xONTNo#0$4icA=!Uu4>u1-=giRpO`fGx6saRYh5lbv1U>R8F7)9Yy{LIjV`;R~zCYKBAsVkfUyzsH z>)uyZRn>u?Rm~+&PG}xeF~(yC&;bD{sTiOvY_usmehduZqbMsYdkfGH0QE^Z<;igm z6KiT~6Az#9)yutDX7-Xyll~a{6;u8*+*7jnFwySR8x6Pg1Q#HN@y~YUu2Zr52L@J6 zez4#`m&Mbx(&$!iFV=6rj#lFyA6Jhbx1A1NES&CP3{XttY(jGNHrgYI_S1F)BCz}W z`_bfI7<=CvIcfM87A_2BgJo&7tX6h-XT-DIGO1mbKLI=Q0_e(k?NHe5*#N`b?B~3F z)NNqjB3N0SxMQ+>H_zp2H^c5sFzPcSE5JzR`lLP~a!Q*nxXsMXhbAYZjV%KWKk!8+ zB~ew?)IjZ4dg9bB8%;j+3gEFs>M_PclD^LPED~sFXjnm^_c^puTZ+wpbmY`HI6HTA zbYN1`(4aVyz9yh+qCZ{cyZ;{XpLYh#q6bcG zR$`*{>ohbp<-xZ>0oTW4(!Zm~I5ZZOwmut!X8{f(C@r1J!nw^kkeHMdlEv9TfK5a{ zf@0zs867nOmPGEoOR*@9$oI@4aj>yrAy+mXVn-(MH(%+2xv3T+2QdGPk9Ug|eoYD; z`1NaUZ74f{_2Hp;>jB_ma_K^{O$-MmJdkU{J{Fu_rjTso*DtWkbREk3mFZvLV|YY_ zm(zIj)iS>{-|WSxmam=k?bV@VUfW$+yScvfav-Faj$~1VGa?~#o2AVwZMLr!YY56s zKKziEx~MpbViD2}1dfW*G5}dhFfp=sw!ipXd{Vr|V))JJ&I@|)lP%L1sU$|r+q2EH zo{N#O_C>LlLFa5l!&*)QX;KmIu!#;%DsSvn(Uq?T4xU7oRg3ZrBe?C8A;KyVVM91bJA(+uwdjkN&=wN-BS6LZ1HajuV)BaFd zo*6lq`#8a-3(iCuwbs^gz=Fhq(@BLZF(b)deSsd58~{lMjMdfGlMqIb#Gr^{Py#|i z6^;rop=;~w^T!zy9_*?bVOH#)0xwUjJv~1&REpTx*ho7&I^zBQ{oAd6IuZp1?$Ypl z`W#Y+;9$AX)~`Eu(jF_|`yp@nUi@6!-c}ZPq-1VRL*!9EUAL$=G&1tuN4g);)!8{X zHWpD(z(xN=NGKE_&OsUm9Oy_9B!rPVb_J(x8`i#ge1KHZC7=FmBGp@g{22I%H%*s5 z-1M4xcz8H`nN|w+A%Z~)1|Br2+g)3mvj(3qLa(8r;4lSgO%dwl^(vMM!{Dmbr(1bG zLE~WgR6nOpbyiY|*BnNacVTW(Y7Ab`(AGZOy}rH%wt*ATj)QssDtrU5rN3+?kYBHs z_wAcc?L@b;q1?Maj}tsLMz~~^3Bwd1tfYVS0>x=N3-t3ua-~}r_t!3#VfFK;mq-XJ zag@^B>800tb>eYeb~Z+<)yJ`7Wg1Gth@t7}SS9An6hBpF5}!s3*=>3n8buF}N*&Vj zWFRZ-MYyrtlarIrPK96fgOXGH{QS%~43u>Tr>BckBeJBMo}HvSRlkHg^9wpGxIgjg@rIuTi?_`}dfPhgzco{V8YNuTQHaBCj{nP4Y zd94z2hz@7RgZ0Dn!Ko?yjDao$zePhgBC1-E8(C9b&GZPo@k9&=GndKmEk6xi@}^E` znJ9Ok`C7Ot5N4L&%Z2>>{SRH(%Y70oq&{6-2erqtgb%E~8{7PYi{3poFHtQ9T8D;f z=Eqw?s&(C&*&-d^{dZO}-M#!Ld3l3>Jta)R$?_!MF6&Xx0jdV26m#x6 z-~UWx{Wz^Wq*flvEtHWpMCDGl_|HUViHB6%3C21fkt;wS-00&du;-8z*i#7860TOG zIihv^x7csFl&Ekc+Qt2j)(RV_kSaN5m5H3$L=>T%5ByJeP-rwMoK`{)mZ{EyuBmwf zI9aj&r}IW(8dhcVujk)VhglUN@tOFD~q|r zz%(?F=sKLX;&o)06$*hXNw4;{f6PYfvMEX;nd|AdH#dhRCSGQn7CmL)=LvZ&E5G;# z$yk*t?tb4gVE;kT<JoDQEla$5 zf!!^gMJy{RuBWHxk~1@jl7zr8y{TQ<+yW}5<~oM7!|^He!9I}ef+Q`h2Gm8u**Yb0Li{~=8N(-z!-`Hvag z62D5NUrDL&1hd=>!lp+R*|iw1Fk;rg5n1Rt&WcZuzy>OCT^WS+e)DW8K1*Q=Fl-x! zY-b1k)r}L^1Sn21biPP!X)se!BHIoq$==f^_@jQl_zBJntvpnNz31i=Tr;uqi1GH zq@KJPwe8GQj2N7qC9>V#J2^U9TQIdSN|@RXpWW>`Iug-t-}vDur+aQt+|JIT6rqXR zD(u5WU{VkNDEDoH-r@4b(9tO!+0?F`jb_P6ujdtcuq@Pwv0U$=-PY^s`n+ z_b3Bi7#QU|8kBWVAQ_LveBs_(|Y|HE%Z4wo#_fW@hm-( ztw(~gDwrZPF?HDhOyw0OR(c?R2b=#+(Es%O|3cUQ+cdZ*^TWrRUNG23+iz#GBvevZ z%(!M3Kn#C5*px>G@>D%$?t;?|oASSxPXeG|S1yBcn7w|z7iBhPNeJL00LP}IF(@cd zv!9NF)p#iuS0JMsPyzYlqochi>33jD9>#d`o6m053aGh{=;)Tacw~`q`{Uz}E-o%Sjqp@e zRNnA%lfGe&g^-!rK#jzt{2h5r$%{ua$e57S$2vBWrYto)noRlN%Ma-ST z4a_6PDZ)*CjaJ{vESdOfe9Y8|%!^XVmQG7Tx(k~~Rz68gQx(iGoi#D5bjtnxYAL&` z=tfa8t#sm_+!5>;275P)9{)2}a0Mtw!QWdnMWI3E0LU z)F^#I!pcXQK8?=Gjz$~_S*rbACM3j%o|uTT66ii``ASfPPzmo=&Yo8Z?2CAkL1J`l z%&Zq>;FM7L{d?aLb7JO;z6x!oR0$6(0YMn>Te@Bs0iHYCR^wa);2J&vaRXk={{8!_ z_^-oQwvkF__0h>m+v=fdKkL`^Y$Vg0A$y<9z-Rx0%nYQc>h}vC5(g!2t)Wrs?PT~o zfa=G7##L%LsC>9y>u4@O_Qrp>GJJg4Ju>pyMJAbZuv^@8)-n+25-M&)Bqb#~<~{+x zIFFlz*gKyJTbG~Ms#I2=Pmq6-u`l{yH&yV?I!{{IWacU3+i&04=_&BSJU53FK76Po zDJ0))2nZCeH*)zw0{~J)eAeR%00HXj>WINuUQWGDO|n7q)o0f?sRS_r0wG+{S^mnc ziOI>KpG0AFU@Vk9qf{80y3?ql^XJ6x_yPNxG|4KH_%FM(X92PR-IzWVVL?+gE>mC86iR_)aBo%}dDGO+Sl`8hXTfl_qQW3%iS#!9v~u*2@H4lbtg zF@lJ89>-aA&K%dt8}d)CGE8X@8G1zjC1nN6+fi_?vq2~sM{(c_$hd49?YffR+F)j? zZe?>bLj)lmIxI4;9VEi<|cN~)cyDxoaQXFL!omghQWX7u~6w(_tAoivU8P?bAg z?{*&%oL^wz_*)K8g$)+>YbU3szQf`0!U6;J*sjHmKK|yS7_q*trqh#?yD=b<4ZU~% zCdJKg5`A~IvSQ?b2QmO-*jQMe%l1>RPKFW~5M3U$UM2B5UI>im3@frd8%zU8L=!Sm- z*z(iS5=U)qM55B^(nIU)lC`ofPVKg~d>X$m7w`>FL*N_^4h{44!xKyHDISs?4-f z@7m&z=I|f&?4pjA`ub!FnIB!=Lo4xEIMfHlorK!*33;|su`4gXqCe{8INLD(0}`tm zY-A54sT7dDk9f6tDf--n*Gd>Uw7@^6Vw;+pXio`XR@*iy;)5E-&rpu3@6;94kqV3W z9jk{?x(_6%poz=w=HehIQB1&QlDgXhd6beTOHX$42pC&-r-ce4KDLY8x zXDQkc$QnP?iGuLlF(n{j+6&0)iK8_+6uaZPdhZc?ob-L`SqKMncSPv}G&7@yC;C33 zt9_t2-h(xlnZ%jA}q>dm! zg;Fpy6ofNI3hC>|1*3YD0Ue9C6X+mS3=G4D*U8^`Y$sm*yqp%Pf z6hsf`J%Bz%noZyisB3A|!bxC2yc0?S7wh9@y&oAF0oDU;4=30}_unPSzVaqK^ diff --git a/docs/build-insights/media/vs-account-auth.png b/docs/build-insights/media/vs-account-auth.png index ae395549d004f2c89e83661937d17992ac2c6f0e..3e62cf49c70838a226e5bb7a1174e92ffaf1f9cb 100644 GIT binary patch literal 14132 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 ZU0kIxi>pu_0w0lq6l7GSE1|H^{{!uu69NDL From 62551c68e9c5e32d88d458759b81cbcabe69fa08 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 16 Jan 2026 14:12:01 -0800 Subject: [PATCH 1547/1799] draft --- docs/standard-library/priority-queue-class.md | 343 ++++++++++-------- 1 file changed, 198 insertions(+), 145 deletions(-) diff --git a/docs/standard-library/priority-queue-class.md b/docs/standard-library/priority-queue-class.md index 8e22659fb47..d9c96fa37be 100644 --- a/docs/standard-library/priority-queue-class.md +++ b/docs/standard-library/priority-queue-class.md @@ -1,13 +1,13 @@ --- description: "Learn more about: priority_queue Class" title: "priority_queue Class" -ms.date: "11/04/2016" +ms.date: 01/18/2026 f1_keywords: ["queue/std::priority_queue::container_type", "queue/std::priority_queue::size_type", "queue/std::priority_queue::value_type", "queue/std::priority_queue::empty", "queue/std::priority_queue::pop", "queue/std::priority_queue::push", "queue/std::priority_queue::size", "queue/std::priority_queue::top"] helpviewer_keywords: ["std::priority_queue [C++], container_type", "std::priority_queue [C++], size_type", "std::priority_queue [C++], value_type", "std::priority_queue [C++], empty", "std::priority_queue [C++], pop", "std::priority_queue [C++], push", "std::priority_queue [C++], size", "std::priority_queue [C++], top"] --- -# `priority_queue` Class +# `priority_queue` class -A template container adaptor class that provides a restriction of functionality limiting access to the top element of some underlying container type, which is always the largest or of the highest priority. New elements can be added to the `priority_queue` and the top element of the `priority_queue` can be inspected or removed. +A container adaptor that maintains a collection of elements where the largest (or highest priority) element is always accessible at the top. You can add new elements and remove or examine the top element, but you can't directly access elements in the middle of the collection. ## Syntax @@ -19,31 +19,29 @@ class priority_queue ### Parameters *`Type`*\ -The element data type to be stored in the `priority_queue`. +The element data type to store in the `priority_queue`. *`Container`*\ -The type of the underlying container used to implement the `priority_queue`. +The type of the underlying container that stores the elements for the `priority_queue`. *`Compare`*\ -The type that provides a function object that can compare two element values as sort keys to determine their relative order in the `priority_queue`. This argument is optional and the binary predicate `less` is the default value. +The type that provides a function object that compares two element values as sort keys to determine their relative order in the `priority_queue`. This argument is optional. The binary predicate `less` is the default. ## Remarks -The elements of class `Type` stipulated in the first template parameter of a queue object are synonymous with [`value_type`](#value_type) and must match the type of element in the underlying container class `Container` stipulated by the second template parameter. The `Type` must be assignable, so that it's possible to copy objects of that type and to assign values to variables of that type. +Elements of class `Type` specified in the first template parameter of a `priority_queue` object are equivalent to [`value_type`](#value_type) and must match the element type in the underlying container class `Container` specified by the second template parameter. The `Type` must be assignable, which means you can copy objects of that type and assign values to variables of that type. -The `priority_queue` orders the sequence it controls by calling a stored function object of class `Traits`. In general, the elements need be merely less than comparable to establish this order: so that, given any two elements, it may be determined either that they're equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. +The `priority_queue` uses a comparison function to determine which elements have higher priority. This comparison function is a function object of class `Traits`. To work with `priority_queue`, your elements only need to support comparison using the less-than operator (`<`) so that it can arrange the elements in order. -Suitable underlying container classes for `priority_queue` include [`deque` Class](../standard-library/deque-class.md) and the default [`vector` Class](../standard-library/vector-class.md) or any other sequence container that supports the operations of `front`, `push_back`, and `pop_back` and a random-access iterator. The underlying container class is encapsulated within the container adaptor, which exposes only the limited set of the sequence container member functions as a public interface. +Suitable underlying container classes for `priority_queue` include [`deque` Class](../standard-library/deque-class.md), the default [`vector` Class](../standard-library/vector-class.md), or any other sequence container that supports the operations of `front`, `push_back`, and `pop_back` and a random-access iterator. The container adaptor encapsulates the underlying container class and exposes only a limited set of the sequence container member functions as a public interface. -Adding elements to and removing elements from a `priority_queue` both have logarithmic complexity. Accessing elements in a `priority_queue` has constant complexity. +Adding and removing elements from a `priority_queue` both have logarithmic complexity. Accessing elements in a `priority_queue` has constant complexity. -There are three types of container adaptors defined by the C++ Standard Library: `stack`, `queue`, and `priority_queue`. Each restricts the functionality of some underlying container class to provide a precisely controlled interface to a standard data structure. +The C++ Standard Library defines other container adaptors that you can use to store the elements in your `priority_queue`: `stack`, `queue`, and `priority_queue`: -- The [`stack` Class](../standard-library/stack-class.md) supports a last-in, first-out (LIFO) data structure. A good analogue to keep in mind would be a stack of plates. Elements (plates) may be inserted, inspected, or removed only from the top of the stack, which is the last element at the end of the base container. The restriction to accessing only the top element is the reason for using the `stack` class. - -- The [`queue` Class](../standard-library/queue-class.md) supports a first-in, first-out (FIFO) data structure. A good analogue to keep in mind would be people lining up for a bank teller. Elements (people) may be added to the back of the line and are removed from the front of the line. Both the front and the back of a line may be inspected. The restriction to accessing only the front and back elements in this way is the reason for using the `queue` class. - -- The `priority_queue` class orders its elements so that the largest element is always at the top position. It supports insertion of an element and the inspection and removal of the top element. A good analogue to keep in mind would be people lining up where they're arranged by age, height, or some other criterion. +- The [`stack` Class](../standard-library/stack-class.md) supports a last-in, first-out (LIFO) data structure. Consider a stack of plates: you can insert, inspect, or remove elements (plates) only from the top of the stack, which is the last element at the end of the base container. +- The [`queue` Class](../standard-library/queue-class.md) supports a first-in, first-out (FIFO) data structure. Consider people in a line. You add elements (people) to the back of the line and remove them from the front of the line. Both the front and the back of a line can be inspected. +- The `priority_queue` class orders its elements so that the largest element is always at the top. It supports insertion of an element and the inspection and removal of the top element. ### Constructors @@ -75,6 +73,17 @@ There are three types of container adaptors defined by the C++ Standard Library: **Namespace:** `std` +## Examples index + +- [Check if the `priority_queue` is empty](#check-if-a-priority_queue-is-empty) +- [Pop elements and inspect size](#pop-elements-and-inspect-size) +- [Use custom containers and comparers](#construct-priority_queue-with-custom-containers-and-comparers) +- [Push elements and read the top](#push-elements-and-read-the-top) +- [Get the number of elements in the `priority_queue`](#get-priority_queue-size) +- [Access the top element](#access-the-top-element) +- [Use the `value_type` alias](#use-the-priority_queue-value_type-alias) +- [Use a user-defined data type](#use-a-user-defined-data-type-with-the-priority_queue) + ## `priority_queue::container_type` A type that provides the base container to be adapted. @@ -87,11 +96,8 @@ typedef Container container_type; The type is a synonym for the template parameter `Container`. The C++ Standard Library sequence container class `deque` and the default class `vector` meet the requirements to be used as the base container for a `priority_queue` object. User-defined types satisfying the requirements may also be used. -For more information on `Container`, see the Remarks section of the [`priority_queue` Class](../standard-library/priority-queue-class.md) topic. - -### Example - -See the example for [`priority_queue`](#priority_queue) for an example of how to declare and use `container_type`. +For more information about `Container`, see the Remarks section of the [`priority_queue` Class](../standard-library/priority-queue-class.md) topic. +To specify a different STL container as the base container for a `priority_queue`, see [`priority_queue`](#priority_queue) for an example of how to declare and use `container_type`. ## `priority_queue::empty` @@ -105,29 +111,28 @@ bool empty() const; **`true`** if the `priority_queue` is empty; **`false`** if the `priority_queue` is nonempty. -### Example +### Example: Check if the `priority_queue` is empty ```cpp -// pqueue_empty.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; // Declares priority_queues with default deque base container priority_queue q1, s2; - q1.push( 1 ); + q1.push(1); - if ( q1.empty( ) ) + if (q1.empty()) cout << "The priority_queue q1 is empty." << endl; else cout << "The priority_queue q1 is not empty." << endl; - if ( s2.empty( ) ) + if (s2.empty()) cout << "The priority_queue s2 is empty." << endl; else cout << "The priority_queue s2 is not empty." << endl; @@ -149,42 +154,38 @@ void pop(); ### Remarks -The `priority_queue` must be nonempty to apply the member function. The top of the `priority_queue` is always occupied by the largest element in the container. +The `priority_queue` must be nonempty to use this member function. The top of the `priority_queue` always holds the largest element in the container. -### Example +### Example: Pop elements and check size ```cpp -// pqueue_pop.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; priority_queue q1, s2; - q1.push( 10 ); - q1.push( 20 ); - q1.push( 30 ); + q1.push(10); + q1.push(20); + q1.push(30); priority_queue ::size_type i, iii; - i = q1.size( ); + i = q1.size(); cout << "The priority_queue length is " << i << "." << endl; - const int& ii = q1.top( ); - cout << "The element at the top of the priority_queue is " - << ii << "." << endl; + const int& ii = q1.top(); + cout << "The element at the top of the priority_queue is " << ii << "." << endl; - q1.pop( ); + q1.pop(); - iii = q1.size( ); - cout << "After a pop, the priority_queue length is " - << iii << "." << endl; + iii = q1.size(); + cout << "After a pop, the priority_queue length is " << iii << "." << endl; - const int& iv = q1.top( ); - cout << "After a pop, the element at the top of the " - << "priority_queue is " << iv << "." << endl; + const int& iv = q1.top(); + cout << "After a pop, the element at the top of the " << "priority_queue is " << iv << "." << endl; } ``` @@ -197,7 +198,7 @@ After a pop, the element at the top of the priority_queue is 20. ## `priority_queue::priority_queue` -Constructs a `priority_queue` that is empty or that is a copy of a range of a base container object or of another `priority_queue`. +Creates a `priority_queue` that is empty or that copies a range from a base container object or from another `priority_queue`. ```cpp priority_queue(); @@ -243,10 +244,9 @@ The fourth constructor specifies a copy of the `priority_queue right`. The last three constructors copy the range `[first, last)` of some container and use the values to initialize a `priority_queue` with increasing explicitness in specifying the type of comparison function of class `Traits` and `container_type`. -### Example +### Example: Use custom containers and comparers ```cpp -// pqueue_ctor.cpp // compile with: /EHsc #include #include @@ -254,101 +254,94 @@ The last three constructors copy the range `[first, last)` of some container and #include #include -int main( ) +int main() { using namespace std; - // The first member function declares priority_queue - // with a default vector base container + // Declares a priority_queue with a default vector base container priority_queue q1; cout << "q1 = ( "; - while ( !q1.empty( ) ) + while (!q1.empty()) { - cout << q1.top( ) << " "; - q1.pop( ); + cout << q1.top() << " "; + q1.pop(); } cout << ")" << endl; - // Explicitly declares a priority_queue with nondefault - // deque base container - priority_queue > q2; - q2.push( 5 ); - q2.push( 15 ); - q2.push( 10 ); + // Declares a priority_queue with nondefault deque base container + priority_queue > q2; + q2.push(5); + q2.push(15); + q2.push(10); cout << "q2 = ( "; - while ( !q2.empty( ) ) + while (!q2.empty()) { - cout << q2.top( ) << " "; - q2.pop( ); + cout << q2.top() << " "; + q2.pop(); } cout << ")" << endl; - - // This method of printing out the elements of a priority_queue - // removes the elements from the priority queue, leaving it empty - cout << "After printing, q2 has " << q2.size( ) << " elements." << endl; - - // The third member function declares a priority_queue - // with a vector base container and specifies that the comparison - // function greater is to be used for ordering elements - priority_queue , greater > q3; - q3.push( 2 ); - q3.push( 1 ); - q3.push( 3 ); + cout << "After printing, q2 has " << q2.size() << " elements." << endl; + + // Declares a priority_queue with a vector base container and specifies that + // the comparison function greater is to be used for ordering elements + priority_queue , greater> q3; + q3.push(2); + q3.push(1); + q3.push(3); cout << "q3 = ( "; - while ( !q3.empty( ) ) + + while (!q3.empty()) { - cout << q3.top( ) << " "; - q3.pop( ); + cout << q3.top() << " "; + q3.pop(); } cout << ")" << endl; - // The fourth member function declares a priority_queue and - // initializes it with elements copied from another container: - // first, inserting elements into q1, then copying q1 elements into q4 - q1.push( 100 ); - q1.push( 200 ); - priority_queue q4( q1 ); + // Declares a priority_queue and initializes it with elements copied from another + // container by first inserting elements into q1 and then copying q1 elements into q4 + q1.push(100); + q1.push(200); + priority_queue q4(q1); cout << "q4 = ( "; - while ( !q4.empty( ) ) + while (!q4.empty()) { - cout << q4.top( ) << " "; - q4.pop( ); + cout << q4.top() << " "; + q4.pop(); } cout << ")" << endl; // Creates an auxiliary vector object v5 to be used to initialize q5 vector v5; vector ::iterator v5_Iter; - v5.push_back( 10 ); - v5.push_back( 30 ); - v5.push_back( 20 ); + v5.push_back(10); + v5.push_back(30); + v5.push_back(20); cout << "v5 = ( " ; - for ( v5_Iter = v5.begin( ) ; v5_Iter != v5.end( ) ; v5_Iter++ ) + for (v5_Iter = v5.begin() ; v5_Iter != v5.end() ; v5_Iter++) + { cout << *v5_Iter << " "; + } cout << ")" << endl; - // The fifth member function declares and - // initializes a priority_queue q5 by copying the + // Declares and initializes a priority_queue q5 by copying the // range v5[ first, last) from vector v5 - priority_queue q5( v5.begin( ), v5.begin( ) + 2 ); + priority_queue q5(v5.begin(), v5.begin() + 2); cout << "q5 = ( "; - while ( !q5.empty( ) ) + while (!q5.empty()) { - cout << q5.top( ) << " "; - q5.pop( ); + cout << q5.top() << " "; + q5.pop(); } cout << ")" << endl; - // The sixth member function declares a priority_queue q6 - // with a comparison function greater and initializes q6 - // by copying the range v5[ first, last) from vector v5 - priority_queue , greater > - q6( v5.begin( ), v5.begin( ) + 2 ); + // Declares a priority_queue q6 with a comparison function greater and + // initializes q6 by copying the range v5[ first, last) from vector v5 + priority_queue , greater> q6(v5.begin(), v5.begin() + 2); cout << "q6 = ( "; - while ( !q6.empty( ) ) + while (!q6.empty()) { - cout << q6.top( ) << " "; - q6.pop( ); + cout << q6.top() << " "; + q6.pop(); } cout << ")" << endl; } @@ -365,36 +358,34 @@ void push(const Type& val); ### Parameters *`val`*\ -The element added to the top of the `priority_queue`. +The element to add to the top of the `priority_queue`. ### Remarks -The top of the `priority_queue` is the position occupied by the largest element in the container. +The top of the `priority_queue` contains the largest element in the container. -### Example +### Example: Push elements and read the top ```cpp -// pqueue_push.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; priority_queue q1; - q1.push( 10 ); - q1.push( 30 ); - q1.push( 20 ); + q1.push(10); + q1.push(30); + q1.push(20); priority_queue::size_type i; - i = q1.size( ); + i = q1.size(); cout << "The priority_queue length is " << i << "." << endl; - const int& ii = q1.top( ); - cout << "The element at the top of the priority_queue is " - << ii << "." << endl; + const int& ii = q1.top(); + cout << "The element at the top of the priority_queue is " << ii << "." << endl; } ``` @@ -415,26 +406,25 @@ size_type size() const; The current length of the `priority_queue`. -### Example +### Example: Get the number of elements in the `priority_queue` ```cpp -// pqueue_size.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; priority_queue q1, q2; priority_queue ::size_type i; - q1.push( 1 ); - i = q1.size( ); + q1.push(1); + i = q1.size(); cout << "The priority_queue length is " << i << "." << endl; - q1.push( 2 ); - i = q1.size( ); + q1.push(2); + i = q1.size(); cout << "The priority_queue length is now " << i << "." << endl; } ``` @@ -446,7 +436,7 @@ The priority_queue length is now 2. ## `priority_queue::size_type` -An unsigned integer type that can represent the number of elements in a `priority_queue`. +An unsigned integer type that represents the number of elements in a `priority_queue`. ```cpp typedef typename Container::size_type size_type; @@ -454,9 +444,9 @@ typedef typename Container::size_type size_type; ### Remarks -The type is a synonym for the `size_type` of the base container adapted by the `priority_queue`. +This type is a synonym for the `size_type` of the base container that the `priority_queue` adapts. -### Example +### Example: Access the top element See the example for [`size`](#size) for an example of how to declare and use `size_type`. @@ -474,32 +464,30 @@ A reference to the largest element, as determined by the `Traits` function, obje ### Remarks -The `priority_queue` must be nonempty to apply the member function. +The `priority_queue` must be nonempty to use this member function. -### Example +### Example: Use the `value_type` alias ```cpp -// pqueue_top.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; priority_queue q1; - q1.push( 10 ); - q1.push( 30 ); - q1.push( 20 ); + q1.push(10); + q1.push(30); + q1.push(20); priority_queue::size_type i; - i = q1.size( ); + i = q1.size(); cout << "The priority_queue length is " << i << "." << endl; - const int& ii = q1.top( ); - cout << "The element at the top of the priority_queue is " - << ii << "." << endl; + const int& ii = q1.top(); + cout << "The element at the top of the priority_queue is " << ii << "." << endl; } ``` @@ -518,17 +506,16 @@ typedef typename Container::value_type value_type; ### Remarks -The type is a synonym for the `value_type` of the base container adapted by the `priority_queue`. +This type is a synonym for the `value_type` of the base container that the `priority_queue` adapts. -### Example +### Example: Use the priority_queue value_type alias ```cpp -// pqueue_value_type.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; @@ -539,9 +526,8 @@ int main( ) cout << "The value_type is AnInt = " << AnInt << endl; priority_queue q1; - q1.push( AnInt ); - cout << "The element at the top of the priority_queue is " - << q1.top( ) << "." << endl; + q1.push(AnInt); + cout << "The element at the top of the priority_queue is " << q1.top() << "." << endl; } ``` @@ -550,6 +536,73 @@ The value_type is AnInt = 69 The element at the top of the priority_queue is 69. ``` +## Example: Use a user-defined data type + +To use `priority_queue` with user-defined type elements, you must provide a way to compare the elements. You can either define `operator<` for your type or provide a custom comparison function object. + +The following example demonstrates a `priority_queue` that stores `Task` objects, ordered by priority level. Tasks with higher priority values are at the top of the queue. + +```cpp +// compile with: /EHsc +#include +#include +#include + +struct Task +{ + int priority; + std::string name; + + // Define operator< for priority_queue ordering + // Returns true if this task has LOWER priority than other + // (priority_queue puts the "largest" element at the top) + bool operator<(const Task& other) const + { + return priority < other.priority; + } +}; + +int main() +{ + std::priority_queue tasks; + + tasks.push({3, "Low priority task"}); + tasks.push({10, "High priority task"}); + tasks.push({5, "Medium priority task"}); + + std::cout << "Processing tasks by priority:\n"; + while (!tasks.empty()) + { + const Task& t = tasks.top(); + std::cout << " Priority " << t.priority << ": " << t.name << "\n"; + tasks.pop(); + } +} +``` + +```Output +Processing tasks by priority: + Priority 10: High priority task + Priority 5: Medium priority task + Priority 3: Low priority task +``` + +### Remarks + +If you want different ordering (for example, lower values first), provide a custom comparator: + +```cpp +struct ComparePriority +{ + bool operator()(const Task& a, const Task& b) + { + return a.priority > b.priority; // Lower priority value means higher priority + } +}; + +std::priority_queue, ComparePriority> minQueue; +``` + ## See also [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)\ From 015629ff43ee22665d3c9c1bfa30c3f02319dba1 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Fri, 16 Jan 2026 14:39:19 -0800 Subject: [PATCH 1548/1799] Add new moniker --- docs/build/customize-cmake-settings.md | 74 +++++------------- .../vs-2026-cmake-manage-configurations.png | Bin 10542 -> 0 bytes 2 files changed, 20 insertions(+), 54 deletions(-) delete mode 100644 docs/build/media/vs-2026-cmake-manage-configurations.png diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index abcbfa224fc..b56f85cd753 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -7,7 +7,17 @@ ms.topic: how-to --- # Customize CMake build settings -::: moniker range=">=msvc-160" +::: moniker range="=visual-studio" + +The CMake settings editor has been deprecated in Visual Studio 2026. + +To learn about changing the *`CMakePresets.json`* file, see [CMakePresets.json and CMakeUserPresets.json Microsoft vendor maps](/cpp/build/cmake-presets-json-reference). + +For Visual Studio 2019 to 2022, select your version by using the version selector in the sidebar menu. + +::: moniker-end + +::: moniker range="<=msvc-170" Visual Studio uses a CMake configuration file to drive CMake generation and build. *`CMakePresets.json`* is supported by Visual Studio 2019 version 16.10 or later and is the recommended CMake configuration file. *`CMakePresets.json`* is supported directly by CMake and can be used to drive CMake generation and build from Visual Studio, from VS Code, in a Continuous Integration pipeline, and from the command line on Windows, Linux, and Mac. For more information on *`CMakePresets.json`*, see [Configure and build with CMake Presets](cmake-presets-vs.md). @@ -15,7 +25,7 @@ If you maintain projects that use a *`CMakeSettings.json`* file for CMake build To open the CMake settings editor, select the **Configuration** drop-down in the main toolbar and choose **Manage Configurations**. -![Screenshot of the CMake configuration drop-down. Manage Configurations is highlighted.](media/vs-2026-cmake-manage-configurations.png) +![Screenshot of the CMake configuration drop-down. Manage Configurations is highlighted.](media/vs2019-cmake-manage-configurations.png) Now you see the **Settings Editor** with the installed configurations on the left. @@ -24,7 +34,7 @@ The left pane shows the installed configurations (x86-Debug). The right pane sho :::image-end::: > [!NOTE] -> If a JSON editor opens instead of the **Settings Editor** when you select **Manage Configurations**, you need to enable the CMakeSettings mode. In Visual Studio 2026, under **Tools** > **Options** > **CMake**, select **Never use CMake Presets**, and then close and reopen your CMake project. Alternatively, you can choose **Use CMake Presets if available, otherwise use CMakeSettings.json**, and then delete the *CMakePresets.json* file from the project folder. +> If a JSON editor opens instead of the **Settings Editor** when you select **Manage Configurations**, you need to enable the CMakeSettings mode. Under **Tools** > **Options** > **CMake**, select **Never use CMake Presets**, and then close and reopen your CMake project. Alternatively, you can choose **Use CMake Presets if available, otherwise use CMakeSettings.json**, and then delete the *CMakePresets.json* file from the project folder. > :::image type="content" source="media/options-configuration-file.png" alt-text="Screenshot of the C make options pane."::: Visual Studio provides one `x64-Debug` configuration by default. You can add more configurations by choosing the green plus sign. The settings that you see in the editor might vary depending on which configuration is selected. @@ -161,55 +171,11 @@ For more information about each of the properties in the file, see [CMakeSetting ::: moniker-end -::: moniker range="<=msvc-150" - -Visual Studio 2017 provides several CMake configurations that define how CMake is invoked to create the CMake cache for a given project. To add a new configuration, select the configuration drop-down in the toolbar and choose **Manage Configurations**: - - ![Screenshot of Manage configurations selected in the drop-down.](media/cmake-manage-configurations.png) - -You can choose from the list of predefined configurations: - - ![Add Configuration to CMake Settings dialog list of predefined configurations.](media/cmake-configurations.png) - -The first time you select a configuration, Visual Studio creates a *`CMakeSettings.json`* file in your project's root folder. This file is used to re-create the CMake cache file, for example after a **Clean** operation. - -To add another configuration, right-click *`CMakeSettings.json`* and choose **Add Configuration**. - - ![Screenshot of the shortcut menu with Add configuration selected.](media/cmake-add-configuration.png "CMake Add Configuration") - -You can also edit the file using the **CMake Settings Editor**. Right-click on *`CMakeSettings.json`* in **Solution Explorer** and choose **Edit CMake Settings**. Or, select **Manage Configurations** from the configuration drop-down at the top of the editor window. - -You can also directly edit *`CMakeSettings.json`* to create custom configurations. The following example shows a sample configuration, which you can use as a starting point: - -```json - { - "name": "x86-Debug", - "generator": "Ninja", - "configurationType": "Debug", - "inheritEnvironments": [ "msvc_x86" ], - "buildRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\build\\${name}", - "installRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\install\\${name}", - "cmakeCommandArgs": "", - "buildCommandArgs": "-v", - "ctestCommandArgs": "" - }, -``` - -JSON IntelliSense helps you edit the *`CMakeSettings.json`* file: - - :::image type="complex" source="media/cmake-json-intellisense.png" alt-text="Screenshot of the CMake JSON IntelliSense pop-up in the editor."::: - The JSON IntelliSense pop-up for "configurations" shows buildCommandArgs, buildRoot, cmakeCommandArgs, configurationType, among several others. - :::image-end::: - -For more information about each of the properties in the file, see [`CMakeSettings.json` schema reference](cmakesettings-reference.md). - -::: moniker-end - -## See also +## Related content -[CMake Projects in Visual Studio](cmake-projects-in-visual-studio.md)
-[Configure a Linux CMake project](../linux/cmake-linux-project.md)
-[Connect to your remote Linux computer](../linux/connect-to-your-remote-linux-computer.md)
-[Configure CMake debugging sessions](configure-cmake-debugging-sessions.md)
-[Deploy, run, and debug your Linux project](../linux/deploy-run-and-debug-your-linux-project.md)
-[CMake predefined configuration reference](cmake-predefined-configuration-reference.md) +- [CMake Projects in Visual Studio](cmake-projects-in-visual-studio.md) +- [Configure a Linux CMake project](../linux/cmake-linux-project.md) +- [Connect to your remote Linux computer](../linux/connect-to-your-remote-linux-computer.md) +- [Configure CMake debugging sessions](configure-cmake-debugging-sessions.md) +- [Deploy, run, and debug your Linux project](../linux/deploy-run-and-debug-your-linux-project.md) +- [CMake predefined configuration reference](cmake-predefined-configuration-reference.md) diff --git a/docs/build/media/vs-2026-cmake-manage-configurations.png b/docs/build/media/vs-2026-cmake-manage-configurations.png deleted file mode 100644 index ca06469ab2f761491b67696040af63a568727e78..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10542 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 NQc=)&RV8N@^gp9A Date: Fri, 16 Jan 2026 14:44:10 -0800 Subject: [PATCH 1549/1799] link --- docs/standard-library/priority-queue-class.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/priority-queue-class.md b/docs/standard-library/priority-queue-class.md index d9c96fa37be..f8d63d9f60f 100644 --- a/docs/standard-library/priority-queue-class.md +++ b/docs/standard-library/priority-queue-class.md @@ -33,7 +33,7 @@ Elements of class `Type` specified in the first template parameter of a `priorit The `priority_queue` uses a comparison function to determine which elements have higher priority. This comparison function is a function object of class `Traits`. To work with `priority_queue`, your elements only need to support comparison using the less-than operator (`<`) so that it can arrange the elements in order. -Suitable underlying container classes for `priority_queue` include [`deque` Class](../standard-library/deque-class.md), the default [`vector` Class](../standard-library/vector-class.md), or any other sequence container that supports the operations of `front`, `push_back`, and `pop_back` and a random-access iterator. The container adaptor encapsulates the underlying container class and exposes only a limited set of the sequence container member functions as a public interface. +For more information about suitable underlying container classes, see [container_type](#container_type). Adding and removing elements from a `priority_queue` both have logarithmic complexity. Accessing elements in a `priority_queue` has constant complexity. @@ -94,10 +94,11 @@ typedef Container container_type; ### Remarks -The type is a synonym for the template parameter `Container`. The C++ Standard Library sequence container class `deque` and the default class `vector` meet the requirements to be used as the base container for a `priority_queue` object. User-defined types satisfying the requirements may also be used. +The type is a synonym for the template parameter `Container`. + +Suitable underlying container classes for `priority_queue` include [`deque` Class](../standard-library/deque-class.md), the default [`vector` Class](../standard-library/vector-class.md), or any other sequence container that supports the operations of `front`, `push_back`, and `pop_back` and a random-access iterator. The container adaptor encapsulates the underlying container class and exposes only a limited set of the sequence container member functions as a public interface. -For more information about `Container`, see the Remarks section of the [`priority_queue` Class](../standard-library/priority-queue-class.md) topic. -To specify a different STL container as the base container for a `priority_queue`, see [`priority_queue`](#priority_queue) for an example of how to declare and use `container_type`. +For an example of how to declare and use `container_type`, see [Use custom containers and comparers](#construct-priority_queue-with-custom-containers-and-comparers) ## `priority_queue::empty` From 0fd890e2748037f3822579f18a40546f011ba9e8 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Fri, 16 Jan 2026 14:46:00 -0800 Subject: [PATCH 1550/1799] Fix new moniker --- docs/build/customize-cmake-settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index b56f85cd753..d49e435c42b 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -7,7 +7,7 @@ ms.topic: how-to --- # Customize CMake build settings -::: moniker range="=visual-studio" +::: moniker range=">=msvc-180" The CMake settings editor has been deprecated in Visual Studio 2026. From 8095dee92137c35c10a4c29c6ee61e0782768efd Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 16 Jan 2026 15:33:37 -0800 Subject: [PATCH 1551/1799] draft --- docs/standard-library/priority-queue-class.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/standard-library/priority-queue-class.md b/docs/standard-library/priority-queue-class.md index f8d63d9f60f..2ed920229e7 100644 --- a/docs/standard-library/priority-queue-class.md +++ b/docs/standard-library/priority-queue-class.md @@ -33,7 +33,7 @@ Elements of class `Type` specified in the first template parameter of a `priorit The `priority_queue` uses a comparison function to determine which elements have higher priority. This comparison function is a function object of class `Traits`. To work with `priority_queue`, your elements only need to support comparison using the less-than operator (`<`) so that it can arrange the elements in order. -For more information about suitable underlying container classes, see [container_type](#container_type). +You can change the underlying container type used by the `priority_queue`. You may want to do that for performance reasons. The default, `vector`, is usually best for cache locality because elements are stored in contiguous storage, and does fewer allocations as it grows. But perhaps you would consider `deque` if you have very large or unbounded queues and moving elements is expensive. For more information about suitable underlying container classes, see [container_type](#container_type). Adding and removing elements from a `priority_queue` both have logarithmic complexity. Accessing elements in a `priority_queue` has constant complexity. @@ -43,6 +43,17 @@ The C++ Standard Library defines other container adaptors that you can use to st - The [`queue` Class](../standard-library/queue-class.md) supports a first-in, first-out (FIFO) data structure. Consider people in a line. You add elements (people) to the back of the line and remove them from the front of the line. Both the front and the back of a line can be inspected. - The `priority_queue` class orders its elements so that the largest element is always at the top. It supports insertion of an element and the inspection and removal of the top element. +## Examples + +- [Check if the `priority_queue` is empty](#check-if-a-priority_queue-is-empty) +- [Pop elements and check queue size](#pop-elements-and-inspect-size) +- [Use custom containers and comparers](#construct-priority_queue-with-custom-containers-and-comparers) +- [Push elements and read the top](#push-elements-and-read-the-top) +- [Get the number of elements](#get-priority_queue-size) +- [Access the top element](#access-the-top-element) +- [Get the top element of the `priority_queue`](#use-the-priority_queue-value_type-alias) +- [Use a user-defined data type](#use-a-user-defined-data-type-with-the-priority_queue) + ### Constructors |Constructor|Description| @@ -73,17 +84,6 @@ The C++ Standard Library defines other container adaptors that you can use to st **Namespace:** `std` -## Examples index - -- [Check if the `priority_queue` is empty](#check-if-a-priority_queue-is-empty) -- [Pop elements and inspect size](#pop-elements-and-inspect-size) -- [Use custom containers and comparers](#construct-priority_queue-with-custom-containers-and-comparers) -- [Push elements and read the top](#push-elements-and-read-the-top) -- [Get the number of elements in the `priority_queue`](#get-priority_queue-size) -- [Access the top element](#access-the-top-element) -- [Use the `value_type` alias](#use-the-priority_queue-value_type-alias) -- [Use a user-defined data type](#use-a-user-defined-data-type-with-the-priority_queue) - ## `priority_queue::container_type` A type that provides the base container to be adapted. @@ -449,7 +449,7 @@ This type is a synonym for the `size_type` of the base container that the `prior ### Example: Access the top element -See the example for [`size`](#size) for an example of how to declare and use `size_type`. +For an example of how to declare and use `size_type`, see [Get the number of elements](#get-priority_queue-size) ## `priority_queue::top` @@ -467,7 +467,7 @@ A reference to the largest element, as determined by the `Traits` function, obje The `priority_queue` must be nonempty to use this member function. -### Example: Use the `value_type` alias +### Example: Get the top element of the `priority_queue` ```cpp // compile with: /EHsc From 93c5a1cf9eae694a0816cb90925291309f6968ad Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 16 Jan 2026 15:51:21 -0800 Subject: [PATCH 1552/1799] fix link --- docs/standard-library/priority-queue-class.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/priority-queue-class.md b/docs/standard-library/priority-queue-class.md index 2ed920229e7..54de3d14480 100644 --- a/docs/standard-library/priority-queue-class.md +++ b/docs/standard-library/priority-queue-class.md @@ -51,7 +51,7 @@ The C++ Standard Library defines other container adaptors that you can use to st - [Push elements and read the top](#push-elements-and-read-the-top) - [Get the number of elements](#get-priority_queue-size) - [Access the top element](#access-the-top-element) -- [Get the top element of the `priority_queue`](#use-the-priority_queue-value_type-alias) +- [Use the priority_queue value_type alias](#use-the-priority_queue-value_type-alias) - [Use a user-defined data type](#use-a-user-defined-data-type-with-the-priority_queue) ### Constructors @@ -64,7 +64,7 @@ The C++ Standard Library defines other container adaptors that you can use to st |Type name|Description| |-|-| -|[`container_type`](#container_type)|A type that provides the base container to be adapted by a `priority_queue`.| +|[`container_type`](#container_type)|A type that provides the base container that the `priority_queue` adapts.| |[`size_type`](#size_type)|An unsigned integer type that can represent the number of elements in a `priority_queue`.| |[`value_type`](#value_type)|A type that represents the type of object stored as an element in a `priority_queue`.| From 5a03e2aa903e5f20729ee2b063ae4d502d57486a Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 16 Jan 2026 16:49:34 -0800 Subject: [PATCH 1553/1799] update example --- docs/standard-library/set-class.md | 89 +++++++++++++----------------- 1 file changed, 38 insertions(+), 51 deletions(-) diff --git a/docs/standard-library/set-class.md b/docs/standard-library/set-class.md index a311d618735..0d8b7a74316 100644 --- a/docs/standard-library/set-class.md +++ b/docs/standard-library/set-class.md @@ -1080,9 +1080,9 @@ An iterator that refers to the location of an element with a specified key, or t ### Remarks -The member function returns an iterator that refers to an element in the set whose key is equivalent to the argument *key* under a binary predicate that induces an ordering based on a less than comparability relation. +The member function returns an iterator that points to the element in the set that has a key equal to the argument *key*. If no such element exists, the function returns `end()`. The comparison uses a binary predicate based on a less-than ordering relation. -If the return value of `find` is assigned to a `const_iterator`, the set object can't be modified. If the return value of `find` is assigned to an `iterator`, the set object can be modified +If the return value of `find` is assigned to a `const_iterator`, the set object can't be modified. If the return value of `find` is assigned to an `iterator`, the set object can be modified. ### Example @@ -1090,61 +1090,48 @@ If the return value of `find` is assigned to a `const_iterator`, the set object // compile with: /EHsc /W4 /MTd #include #include -#include -#include - -using namespace std; - -template void print_elem(const T& t) { - cout << "(" << t << ") "; -} - -template void print_collection(const T& t) { - cout << t.size() << " elements: "; - for (const auto& p : t) { - print_elem(p); - } - cout << endl; -} - -template void findit(const C& c, T val) { - cout << "Trying find() on value " << val << endl; - auto result = c.find(val); - if (result != c.end()) { - cout << "Element found: "; print_elem(*result); cout << endl; - } else { - cout << "Element not found." << endl; - } -} +using namespace std; // std c++ libs implemented in std -int main() +void main() { - set s1({ 40, 45 }); - cout << "The starting set s1 is: " << endl; - print_collection(s1); - - vector v; - v.push_back(43); - v.push_back(41); - v.push_back(46); - v.push_back(42); - v.push_back(44); - v.push_back(44); // attempt a duplicate - - cout << "Inserting the following vector data into s1: " << endl; - print_collection(v); - - s1.insert(v.begin(), v.end()); - - cout << "The modified set s1 is: " << endl; - print_collection(s1); - cout << endl; - findit(s1, 45); - findit(s1, 6); + set, allocator> s1{5, 8, 12}; + + // find() returns an iterator that points to the first element + // that has the same key as the value passed to the find function. + // If no such element exists, the iterator equals end(). + + set, allocator>::iterator it; + + // Is 8 in the set? + it = s1.find(8); + if (it != s1.end()) + { + cout << "Found 8" << endl; + } + else + { + cout << "Didn't find 8" << endl; + } + + // Is 6 in the set? + it = s1.find(6); + if (it != s1.end()) + { + cout << "Found 6" << endl; + } + else + { + cout << "Didn't find 6" << endl; + } } ``` +```output +Found 8 +Didn't find 6 +``` + ## `get_allocator` Returns a copy of the allocator object used to construct the set. From 3d1e773645d6fb0aef7a5e71123781d426915c44 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 16 Jan 2026 16:50:35 -0800 Subject: [PATCH 1554/1799] update header --- docs/standard-library/set-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/set-class.md b/docs/standard-library/set-class.md index 0d8b7a74316..3fb4d1f5de9 100644 --- a/docs/standard-library/set-class.md +++ b/docs/standard-library/set-class.md @@ -1084,7 +1084,7 @@ The member function returns an iterator that points to the element in the set th If the return value of `find` is assigned to a `const_iterator`, the set object can't be modified. If the return value of `find` is assigned to an `iterator`, the set object can be modified. -### Example +### Example of set::find() ```cpp // compile with: /EHsc /W4 /MTd From 7a2a3aca5f2dd25a1a455c6e1564510f720f82a1 Mon Sep 17 00:00:00 2001 From: Eve Silfanus Date: Tue, 20 Jan 2026 16:25:27 -0800 Subject: [PATCH 1555/1799] File and images update --- ...indows.md => build_performance_windows.md} | 111 +++++++++--------- docs/build-insights/media/copilot-signin.png | Bin 34001 -> 0 bytes .../media/copilot-usage-menu.png | Bin 13063 -> 0 bytes ...auth.png => vs-account-authentication.png} | Bin docs/build-insights/media/windows-uac.png | Bin 37564 -> 0 bytes .../media/windows-user-account-control.png | Bin 0 -> 37212 bytes 6 files changed, 56 insertions(+), 55 deletions(-) rename docs/build-insights/{copilot_build_performance_windows.md => build_performance_windows.md} (50%) delete mode 100644 docs/build-insights/media/copilot-signin.png delete mode 100644 docs/build-insights/media/copilot-usage-menu.png rename docs/build-insights/media/{vs-account-auth.png => vs-account-authentication.png} (100%) delete mode 100644 docs/build-insights/media/windows-uac.png create mode 100644 docs/build-insights/media/windows-user-account-control.png diff --git a/docs/build-insights/copilot_build_performance_windows.md b/docs/build-insights/build_performance_windows.md similarity index 50% rename from docs/build-insights/copilot_build_performance_windows.md rename to docs/build-insights/build_performance_windows.md index d5024193c4d..64265d93c7b 100644 --- a/docs/build-insights/copilot_build_performance_windows.md +++ b/docs/build-insights/build_performance_windows.md @@ -1,4 +1,12 @@ -# Getting Started with GitHub Copilot build performance for Windows  +--- +title: "Get Started with GitHub Copilot build performance for Windows" +description: "Learn how to use GitHub Copilot build performance for Windows to analyze C++ builds, identify expensive headers and templates, and automatically optimize build times in Visual Studio 2026." +ms.date: 1/20/2026 +helpviewer_keywords: ["GitHub Copilot build performance", "C++ Build Insights", "build time optimization", "header file analysis", "template instantiation", "Visual Studio build performance"] +ms.topic: how-to +--- + +# Get Started with GitHub Copilot build performance for Windows  The GitHub Copilot build performance for Windows analyzes your C++ builds and highlights expensive headers, templates, and functions so you can identify and fix build time bottlenecks. GitHub Copilot integrates seamlessly with Visual Studio, reducing complexity and improving developer productivity. @@ -12,19 +20,19 @@ The GitHub Copilot build performance for Windows analyzes your C++ builds and hi To use GitHub Copilot build performance for Windows, you must install the latest available **Visual Studio 2026**. -[Installation Guide](https://learn.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=visualstudio) +[Installation Guide](/visualstudio/install/install-visual-studio) Visual Studio 2026 supports **side-by-side installation** with older versions. You do not need to uninstall previous versions or other release channels. Installing Visual Studio 2026 will not interfere with your existing development environment.  ### Before you begin  -After installing the Visual Studio Installer, ensure the following components are selected under the **Desktop development with C++** [workload](https://learn.microsoft.com/en-us/visualstudio/install/install-visual-studio?view=visualstudio#step-5---choose-individual-components-optional:~:text=proceeding%20with%20installation.-,Step%204%20%2D%20Choose%20workloads,-After%20you%20install) during installation: +After installing the Visual Studio Installer, ensure the following components are selected under the **Desktop development with C++** [workload](/visualstudio/install/install-visual-studio#step-4---choose-workloads) during installation: - C++ Build Insights - C++ profiling tools - C++ CMake tools for Windows (required for CMake projects)  -:::image type="complex" source="./media/vs-installer-options.png" alt-text="Screenshot of Visual Studio Installer showing selected options for Desktop development with C++."::: +:::image type="complex" source="./media/vs-installer-options.png" alt-text="This installer view highlights the available optional components within the Desktop development with C++ workload, helping users confirm that tools required for build analysis and performance optimization are included during setup."::: The list shows C++ Build Insights, C++ profiling tools, and C++ CMake tools for Windows are all selected for installation. :::image-end::: @@ -38,31 +46,24 @@ GitHub Copilot build performance for Windows is available to users on GitHub Cop - Your plan type will appear near the top of the page.  -:::image type="complex" source="./media/copilot-subscription.png" alt-text="Banner in GitHub settings indicating Copilot Enterprise is active."::: -The banner shows buttons for Copilot in IDE, CLI, Mobile, GitHub.com, and more features. -:::image-end::: + :::image type="complex" source="./media/copilot-subscription.png" alt-text="Banner in GitHub account settings confirming that GitHub Copilot Enterprise is active, with quick-access buttons for various Copilot features including IDE, CLI, mobile, GitHub.com, and more."::: + This banner provides context for where subscription details are displayed within GitHub’s account settings interface. + :::image-end::: + +- Authenticate in Visual Studio 2026 -- Authenticate in Visual Studio 2026 -Before proceeding, ensure you are signed in to your GitHub account in Visual Studio. + Before proceeding, ensure you are signed in to your GitHub account in Visual Studio. - Click on your profile picture in the upper-right corner of Visual Studio to confirm your GitHub login status. - :::image type="complex" source="./media/vs-account-auth.png" alt-text="Visual Studio account dropdown showing GitHub EMU account."::: - The dropdown displays the GitHub EMU account with active status and sync indicator. - :::image-end::: + :::image type="complex" source="./media/vs-account-authentication.png" alt-text="Visual Studio account dropdown showing an active login session with a Microsoft account and a connected GitHub account, both marked as active and synced."::: + The dropdown displays the GitHub account with active status and sync indicator. + :::image-end::: - If you are not signed in, open the GitHub Copilot Chat and follow the sign-in instructions from the pop-up window. - :::image type="complex" source="./media/copilot-signin.png" alt-text="GitHub Copilot sign-in window with authentication options."::: - The window shows options to continue with GitHub or Google, and links to terms and privacy policy. - :::image-end::: - - Once authenticated, you can verify your plan by selecting Copilot Usage from the dropdown menu under the GitHub Copilot badge. - :::image type="complex" source="./media/copilot-usage-menu.png" alt-text="Visual Studio dropdown menu under Copilot badge."::: - The menu lists options like Copilot Usage, Open Chat Window, Settings, Learn More, GitHub Copilot Walkthrough, and Manage Copilot Subscription. - :::image-end::: - ### Enable Template Collection Template instantiation time collection is off by default to minimize analysis overhead. To turn it on: @@ -73,29 +74,29 @@ Template instantiation time collection is off by default to minimize analysis ov 3. Select **Collect Template Instantiation**. -:::image type="complex" source="./media/build-insights-options.png" alt-text="Visual Studio Build Insights options dialog."::: +:::image type="complex" source="./media/build-insights-options.png" alt-text="Build Insights settings page in Visual Studio Options with the Collect template instantiation checkbox enabled, displaying trace collection configurations for analysis."::: The dialog shows trace collection settings with the Collect template instantiation checkbox selected. :::image-end::: -*Learn more:* [Troubleshoot template instantiation impact on build time | Microsoft Learn](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/build-insights-template-view?view=msvc-170) +*Learn more:* [Troubleshoot template instantiation impact on build time | Microsoft Learn](/cpp/build-insights/tutorials/build-insights-template-view) ## Workflow GitHub Copilot build performance on Windows is available via the GitHub Copilot chat pane. Users can access this functionality through the Agent feature within the chat interface. -:::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="GitHub Copilot chat pane showing agent selection."::: +:::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="GitHub Copilot chat pane showing agent selection. The GitHub Copilot build performance on Windows is highlighted as the option to select."::: The pane shows GitHub Copilot build performance for Windows selected to optimize C++ build, with other agents listed. :::image-end::: Before submitting a request to the GitHub Copilot, select your preferred model. -:::image type="complex" source="./media/model-select.png" alt-text="Dropdown menu in Copilot chat for selecting AI models."::: -The menu includes GPT-5, GPT-5.1, Claude, Gemini, and other available AI models. +:::image type="complex" source="./media/model-select.png" alt-text="Model selection menu in Copilot Chat showing available AI models including GPT-5, GPT-5.1, Claude, and Gemini, with usage rate indicators."::: +This dropdown provides context on the range of AI models available when initiating a performance analysis. :::image-end::: Instruct GitHub Copilot to improve the build performance of your selected project. You can add additional context and information so that GitHub Copilot can create suggestions that match the needs of your project. -:::image type="complex" source="./media/copilot-build-request.png" alt-text="Copilot chat window with build performance request."::: +:::image type="complex" source="./media/copilot-build-request.png" alt-text="Copilot Chat interface where the user has entered a request for build performance improvement using GitHub Copilot build performance on Windows."::: The window shows GitHub Copilot build performance for Windows with user message requesting build performance improvement for the project. :::image-end::: @@ -103,20 +104,20 @@ The window shows GitHub Copilot build performance for Windows with user message To analyze the build performance of the selected project, Visual Studio needs elevated permissions. The Build Insights tool needs to be enabled for a first-time user to kickstart the build performance analysis. -*Learn more:* [Build Insights needs additional permissions | Microsoft Learn](https://learn.microsoft.com/en-us/cpp/build-insights/elevate-note?view=msvc-170&f1url=%3FappId%3DDev18IDEF1%26l%3DEN-US%26k%3Dk(bi_permissions)%26rd%3Dtrue) +*Learn more:* [Build Insights needs additional permissions | Microsoft Learn](/cpp/build-insights/elevate-note) -:::image type="complex" source="./media/build-insights-permission.png" alt-text="Visual Studio dialog asking to run Build Insights tool."::: -The dialog requests permission to analyze build performance, with Confirm and Deny buttons. +:::image type="complex" source="./media/build-insights-permission.png" alt-text="Visual Studio dialog titled Run Build Insights requesting permission to start build analysis, with Confirm and Deny buttons."::: +This dialog appears when Visual Studio is preparing to launch the profiling tools necessary for trace generation. :::image-end::: A one-time elevated request is then needed to capture the MSVC compiler traces. -:::image type="complex" source="./media/msvc-elevation.png" alt-text="Microsoft Visual Studio dialog requesting permission to capture MSVC compiler traces."::: -The dialog shows options for Yes and No to allow trace capture. +:::image type="complex" source="./media/msvc-elevation.png" alt-text="Microsoft Visual Studio prompt requesting elevated permissions for Build Insights to collect MSVC compiler traces, displaying Yes and No options."::: +This prompt provides system-level acknowledgment of the resource access required for tracing. :::image-end::: -:::image type="complex" source="./media/windows-uac.png" alt-text="User Account Control dialog for Windows Command Processor."::: -The UAC dialog asks to allow Windows Command Processor to make changes to the device, with Yes and No buttons. +:::image type="complex" source="./media/windows-user-account-control.png" alt-text="Windows User Account Control dialog asking whether to allow the Windows Command Processor to make changes, with Yes and No choices."::: +This UAC dialog is part of Windows’ layer of elevation confirmation and appears when enabling Build Insights for the first time. :::image-end::: If the one-time elevated request is denied, the Build Insights operation is cancelled due to lack of rights to continue. @@ -124,19 +125,19 @@ If the one-time elevated request is denied, the Build Insights operation is canc You will guide GitHub Copilot through the process of improving the build time by providing permission, as needed, to run tools. Additional permissions may be required to run PowerShell scripts. -:::image type="complex" source="./media/terminal-permission.png" alt-text="Copilot chat window prompting user to confirm running a terminal command."::: -The prompt shows options to always allow or allow in this session. +:::image type="complex" source="./media/terminal-permission.png" alt-text="Copilot Chat notification prompting the user to authorize execution of a terminal command, offering Confirm, Always allow, and Allow in this session."::: +This prompt appears within the chat flow when Copilot requires permission to run terminal commands necessary for optimization. :::image-end::: The GitHub Copilot build performance for Windows goes through multiple iterations of code implementation to make the build faster. -:::image type="complex" source="./media/build-analysis-complete.png" alt-text="Screenshot showing analysis complete status and performance improvement summary."::: -The display shows build time improved from 78.6 seconds to 70.5 seconds (8.1 seconds faster, ~10.3% improvement), with a note that further improvement is possible. +:::image type="complex" source="./media/build-analysis-complete.png" alt-text="The display shows build time improved from 78.6 seconds to 70.5 seconds (8.1 seconds faster, ~10.3% improvement), with a note that further improvement is possible."::: +This image provides contextual insight into how build metrics are presented after an optimization iteration. :::image-end::: After GitHub Copilot completes the request, a summary of the changes and build performance impact is displayed. The build performance summary changes depending on each iteration of the agent. -:::image type="complex" source="./media/build-summary.png" alt-text="Screenshot of build performance summary showing before and after optimization metrics."::: +:::image type="complex" source="./media/build-summary.png" alt-text="A summary view comparing build performance before and after optimization. The report shows build time dropping from about 110.7 seconds to 34.1 seconds, with major header bottlenecks significantly reduced. It highlights a 69% overall improvement and faster incremental rebuilds after precompiled headers were enabled."::: The summary displays top bottlenecks and quantitative results of the performance improvements. :::image-end::: @@ -148,46 +149,46 @@ The GitHub Copilot build performance for Windows can be accessed through other e - Button from build menu - :::image type="complex" source="./media/build-menu-improve.png" alt-text="Visual Studio Build menu with Improve build performance option highlighted."::: + :::image type="complex" source="./media/build-menu-improve.png" alt-text="Visual Studio Build menu expanded with the Improve build performance option highlighted under Run Build Insights."::: The menu shows the Improve build performance option under Run Build Insights. :::image-end::: -Clicking the Improve build performance button prompts GitHub Copilot chat + Clicking the Improve build performance button prompts GitHub Copilot chat - :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Copilot chat window with Improve Build Performance prompt."::: - The window shows GitHub Copilot build performance for Windows ready to assist with optimization. - :::image-end::: + :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Copilot chat window with Improve Build Performance prompt."::: + The window shows GitHub Copilot build performance for Windows ready to assist with optimization. + :::image-end::: - Button from solution context menu - :::image type="complex" source="./media/solution-menu-improve.png" alt-text="Visual Studio solution context menu showing Improve build performance option."::: + :::image type="complex" source="./media/solution-menu-improve.png" alt-text="Solution context menu in Visual Studio showing Improve build performance on Solution among the available commands."::: The context menu displays the Improve build performance on Solution option. :::image-end::: -Clicking the Improve build performance on Solution button prompts the GitHub Copilot chat + Clicking the Improve build performance on Solution button prompts the GitHub Copilot chat - :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Copilot chat window with Improve Build Performance prompt."::: - The window shows GitHub Copilot build performance for Windows ready to assist with optimization. + :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Copilot chat window with a request to help improve the build performance of this project."::: + The window shows GitHub Copilot build performance for Windows request to assist with build optimization. :::image-end::: - Button from Build Insights view - :::image type="complex" source="./media/insights-improve-button.png" alt-text="Build Insights diagnostics session view with Improve button highlighted."::: + :::image type="complex" source="./media/insights-improve-button.png" alt-text="Build Insights diagnostics session interface with the Improve button visible for triggering optimization using existing trace data."::: The view shows the diagnostics session with the Improve button available for optimization. :::image-end::: -Clicking the Improve button prompts the GitHub Copilot chat. This button uses data from the existing build insights trace results and does not trigger a new build insights tool execution until the current proposed changes have been processed. + Clicking the Improve button prompts the GitHub Copilot chat. This button uses data from the existing build insights trace results and does not trigger a new build insights tool execution until the current proposed changes have been processed. - :::image type="complex" source="./media/copilot-improve-includes.png" alt-text="Copilot chat window with GitHub Copilot build performance for Windows focusing on includes optimization."::: - The chat shows a user message focusing on improving build performance of includes. + :::image type="complex" source="./media/copilot-improve-includes.png" alt-text="Copilot chat with request to help improve the build performance of this project, focusing on includes."::: + Copilot Chat showing a user request specifically targeting include file optimization as part of the build performance improvements. :::image-end::: ## See Also -[Build Insights function view](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/build-insights-function-view?view=msvc-170) +[Build Insights function view](/cpp/build-insights/tutorials/build-insights-function-view) -[Build Insights included files view](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/build-insights-included-files-view?view=msvc-170) +[Build Insights included files view](/cpp/build-insights/tutorials/build-insights-included-files-view) -[vcperf and Windows Performance Analyzer](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/vcperf-and-wpa?view=msvc-170) +[vcperf and Windows Performance Analyzer](/cpp/build-insights/tutorials/vcperf-and-wpa) -[Windows Performance Analyzer basics](https://learn.microsoft.com/en-us/cpp/build-insights/tutorials/wpa-basics?view=msvc-170) +[Windows Performance Analyzer basics](/cpp/build-insights/tutorials/wpa-basics) \ No newline at end of file diff --git a/docs/build-insights/media/copilot-signin.png b/docs/build-insights/media/copilot-signin.png deleted file mode 100644 index 05ae12cad457ebb15227f832d38ab9d1887c4f16..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 34001 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 diff --git a/docs/build-insights/media/vs-account-auth.png b/docs/build-insights/media/vs-account-authentication.png similarity index 100% rename from docs/build-insights/media/vs-account-auth.png rename to docs/build-insights/media/vs-account-authentication.png diff --git a/docs/build-insights/media/windows-uac.png b/docs/build-insights/media/windows-uac.png deleted file mode 100644 index add461eb50fd62ad8f0b77384242b80fa0a2f2f0..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 37564 zcmd?RbyQZ}*EV_s0!pYzDF_HiNGjbSAR-;oWzcZbD2*T`Dk9Pd2+}Fth^TaT3*2-` zi-h0Y`g_lN#u?u^XPoi<@%?ca;~9_2j+CQ0JSF z|FD|vvmT>RZ`BoKrL~?KuTT1Vkqy>Kp6XzqA#bTpxyJUGNh89tV(iT&xpV&JVWkNM zzR$JzrlOgMB?i-wNh$U{UNe)#qE_CCwXVl{MV#J$Y(IHZ>2?`;Z& zU029n(@CC}Q@`o;%R%;uiwg=BpveF~E0i)pM2)zVhA5Pf$1ZCs$B0{)0TFB^lNLAj9Q8(WB&!D4B zrLFC8Gfn@U*cgkO-Pze$N0EpvrKPAC#t?oTIj660D3+j(B+(y>4S6wvxm8tHG&5E1 z2isU%U!2f@FA z6kq>4@Q|=D-ddr-NNKkJjL(cB@dagS$JEAV_O+;gH@tF&P$h7RK;z24iB=J6% zQ(n`EQaoyY9VJiwTr}B8IiBwv{7vq`gAZb%N_>KX?P=BN@T3yS7p`2nVm)<5)Qv-o z_JWhMv$}x+J9pn=mm3`{0EVcTnBaHs-i7#UN}tKTapOiydwV2H@VD}05prn@m_#uJ zmWji)th_v;(a}*9DyBVfWyRW^qVMNZv8=+v@L#%=6ch}Sk|s1N3JU6fjPBpZJ)_bg z7e>e zxVRXFN)WVL3C{*QU{n1VD-!4K| z&%@P&y~aB?57LT?)GG2@TU&n~dS%#AwzsvptaGv`$3Gq&DlRXl(9_eijt@O4%^4+M zEqfTn^|0=&n47AKiuNKbQT~t5YH4rTmZN!7PZS?KpucqK5~h_twD#kqN_g|5QFJ9- z;1SOH3pv`}1(}k0%*m~B`E?I!Dyo6q7!!1H8>6|EA_TVl;$y!Rh|u`>7qhbuKc=VC zb8}y?va-s`$@x;~v&Zi4hFMr(5EZ3fUtfp!Dr0O+J2pNZ@&5g*i3vk@x52bYVwjbS>wClL9{1#NRaMnbk2)BKMn4BHFRAF0jjy%tJN_9m zA0f4<4u{p&id7nN!F*Cxvfg zM%UdK;o%gcIix*3MYnf$X11Pk1k^LizrH3ce5J;1{mbmPuuqR$FQKG-d?dUilF`QQ zzW(cT5sdOTeNVmCCaOqbjIrXLofrSNMPEOAHN3c{+(C2Y8|EG@MSN9(7tqfMX%SoEf&(GhzcTXep6-40qU>wxX zHugf78g2CIP=2hSebR>DH=&C0S8Z+g+)1Q%u$9ftnWMRka>m2q@g@a+dr9OOR$W3@ zP}>aUNgEm_&et;3byUCW$p}bHf>4D?D;B$B-h4;Y_*5JwdbGqMEj#-h6BARAU!S#i zW5`_1QpjG!^QV6 zqn5CLCH>s(S6%h#UUqpnRqKxOyCCsPiq``3`l>K?EGEz)r1pVpVhooNRjE}_)6C6* zcg)wXXO*SWdGAJ`^($djD~AsT5mWaJ3_S1XP?B*VKtUYbRZy5AbcaCkgh285My`W; z)|_BwW|q;2gUzo2L9vo%KRO>{a{kP6OdrSDv)>@9YiqBfkWim2#i#SScy_?DO*Vh! z_;6=l0nfhvkolr+@~DrMRln5v$G9Xt`xxql^TADgO9?z?1Sr#^{q^mSA&H#=VRMgN z6W^<_petwaJ~NE)d5T>?^=ByKpw>n{$t00cbvg#mZ`)~Uh#~9Ik%47?K5t5%4Z%&5V$4= z;3f>4_|}Q#$Uhg+e)RoignYKgZ#+Lpkb;SkSZvtgW)-%h{!EI|pXZ%Ez=Z59bn=Qh z$z3~3!W|iVlAf8_9`>BbFb`@v!P$W|v&WB@PQQk6!hB{(=g<&Q3nP2TT}8ik*%2Z(Gq!Dvux3D$0zG! zOyPYbm^dhrZX}!QjQp`849ZwsN6Lg&PB`1D%;x+ZUFMx zJ2Q@#mFk_L=cy!pMp@hLr1b6Ew*vx6$v(etpiF1KhDw==JN1lFf34@xD?Y=?$(iBH z&(H7IDiC_ju-26P<a2}dR8woREt0*plRjRWObC@fflBH2cpP=Vc1hjP z(3a|Bfl-b2iA(x~ea7^rpcuo!(a8!S@9eFz{$;JB48tPRXY_aN&}e~mE%8fZc9-mw zJCPecizrtec=?hD>eaiL7-|tiIIUX0BaYW1Ct0<#rRC;Y%+(Ms{BMi>U}}Z?lPWcl))0(+&6iShvez_)Vf<*eLZc7MYjNk_{>n1+q%Ay zzW1W&G#2(rbenq-01ZM44ixq>O9jhot&c}%Q2^baHO)xfzaM2q+uGSF2kRM%2a&k& zMG}(HP&=G~j~}m-k&|PgoSd9)!dflMU-+mH`6ej5b{4&p@_jL~^qIq0{{*wOik*E$!`t$JYhCl?q(D#Sc*N zV_avjb&|U?-E7_^CgyF7V_GAL?GGeRcKaa@uJ~B>cdhQNV1ELzLJu_xmM@g7mFmdI z$eBHl-l?hAsi_PyYK+*a85ztTGBV->1_nNu7881}@-8|$ zN4h3a5D*r#YEs_*dv@J<>G0-&Y|YFZ?>;X5(z`o07A$?o2M`aT27FBA=HYilK(4{K|-d-JTHUOpwcx6$6e?2=ks zdd zK-XMuPR>A~V_e-!w{j?DFW{a7!^4b{k_`sj5}|X3T3R3XQ?B*N4zN*>kzErNHK<6` zqa{1(r64EY`{k3=DZ$_{fnXWmEpm=3XWzdWU_Is|g724(AFopV#r7h9{?kGj{HGBp z|MIT|unqhNq(}b?dz1ga^f3Q_zd$Nheo@gy=mzfpAs{52*ZUG5{L({Y^4LcbfbT80 zHC-iW7N8DpbI2~%BA~=Q3L1^>+ipZ^W%!&U$<1@p+S(LD1x8^=$2kmJdviA8gc=h#N z)Z-QQG4dbM(qw4m1bT-L1Mb><#>*;(-moJ<@B(0Ev24rFmX?-&-HQRubBz$G^Q|P~ z)voL?;E2S;mw|+oZIR1jLk8|#SD}zb%0K9cy|vA{!UAAgx5kYVP~}Z{F0b8Qd3Y%A z@B3KR#>PoA-K%?F*4^4muu*O8?a)j$UW>weethhO0I@Hl=}7zHQKalUaK zRa8_|R(7^Jp=drl5G1bKv=G!MEz2%n7I!|Rr{mIj{lx0)>%-`Ug!nzXn1V-2Nr|7_ z9lX8m1POYw6tMfi(9p_vqy>#QAznh=2Xy%*`E-}Xo$vH#uw=_$x}#;GD-=ck?Am>w z38dl_b6VTkal-Tf5O$f=Wny7rWM^N^J6b07KDDZ8CP>fAQ>suxqYK2sa-eyGDZZP=}|OUvi6GMj*f zDAQ#vZEf?rF?o3$?Z!-{J8gD#rK^|6J9h`UG69yD>Du3{^Hym&_G$S2@H?D7FrC0> zrBQfnTp6E`Ftc+=)a=&xQGtHvWulw5I~KEnClWO@uzq`s+-gO^l7`~vO zpk;-6V;5uGU0-2NUZ5a$4tpjhIJo=lw3~I;6tha-#E|YBo%oPZP^^?2VHVX^2MX-- z77U^OX`6VxtJtyayFET^=i^h4jvrnfv{NkdameqQ`y}qwaq;>qYa5%0sHpTK@7&_b zn)&iI+X9vuYfH~abVFSx(e*4ADLvTrzXo4kq5@(>ydKyH9z&`+;qKzMxn z_6>?gOHr@lql!tl1hj6wuJz!+z*5lk(>dbFqG&g9$ja4L1{G-Hcx{+Zh^6Iy$Ni%d zs5TI40&DW_?!pV536y+Utr_;$~2?ds7Y=Nx*)LV46K zFtidXhghu^dqkn;Ge=;$7>J?7m>uM!il8qr!= zTi%i>`sV3pe4M=3pGGJPhsW2Q zEC01q&>#-m)wFa!d_URR4Y>tIku&p6{?mJ)TE4+La&6yDht5hrsd?$cBZ`;MUqgzi zHRguEbZy{{`3BvL#eMX_(4OqV!O_;wrVFe4-`3scT3M0@I$7Y2=Nyi%B`$~Bt=KGT z`Nh9^V`>>@?e+jthLp8+4!yHJjQxwzlS%U4XUcc)-rN=XxsYJL5>y5`5AHDd0C)>P zKPwA2*x3VySNRh!Yr{j?l73`nVp@J3;l*IpN?8T(xBrK6y@QQSHX$M5E&Hk3qQ0EE zI+`bwt})B@u)ZZB&G@4wvF$$0pA@Cli?KWhjD=ZTq~sC`YILPEZTj57kuu>M1Y^8=mjbN-w4ufD=HG|>+1tekXrK$K%Kmm zRknz2I)oDBY(ULGWoY&rqs_5DJJ7Rna^CkfQ6ao#d<;Wd&cIJIQekIe`c`C|e=5X+ zLa2+C22BkOH7%{@z~GgZmYN=HOtP}E@l13)Kl;U~K}gBPXIT5SJoHg5um?a$Oo}0} z(~D!8!vOcx_s`Mvyn3|Y!!eZ&BQBkaYKxU@u?mQVe>6q56=2$jx)zm-5ph6g>`kY# zvwgCI{s3;^-#+g@zWzN`F3hDph>?p+O6o}z zzVSN>Ge-r5&>5SCz>ygT)AndiB!56R4?WOL=LMx-UJ|w2ZR|mW#aC^g zKl;79Ts`yqTKM67^AW)NUgAH{)eI8XOro`PbRd0GDkvyG<+=^bk#?c+D}c|FwUEzF zoPs$c$7kBGm_HI$3tYbGd7NG604Gfbiqg|#0nLK6yK-{4NZ!2;U46erS7Io?%}`d; zSu(eoi-E`#4wN1odI2%m(`iBOFe2xhNP3pfw-wHlmd3iLs2C9)ok1&_*&kY3$|ut~ z2+7j5N!$wPm>{X*tgO3}0*)`8f%sHce^9y9h7~Xo_;&P_uAE%pZ+kll!5Wf&bi(Mj zib9~NwY0Rdta#wb0nk&GE2y+P{5tV5S|0#%$#wZM#2(xLj=9`5zVURsl_lcsTV$2< zCx?ak!ds!>)PHf| z1rb*})*&1%aAt+Bb3DAf>PAL(BL_en$#^U*E*@A`WpRcfvoV;fL+zu9EUNBBLVa|C z5x&Qc2LpfxAgbgAyB2qredOPSL%*fgt!(Gh)!8{1rK+r~{9y9xUd0ZVl=nu}qDvDr zD;fB-&pKF5t}&kb3GKj)>@Cj@ZpkTC1%+N*14zI@Y=2mt8?D(D8R7Y zZvU`J$He>oNrk{?!J504+zU?1=dqWeICJ#hfMs1_C=_mg@ncWrpVK2^%2ZX!6D>ho zmJ>&nvl7YOJt_u@=eIq!{h2+N(_>tkfWNzSTo3F&90}=mGOYwUq?L?z!G}H#Cd9Lb zTsl3}w+Cmfv`U$OD5PClNxa%{Jc`i-<{mX0G#Kj%Z36++TDM(v~ zHSFcvF9%5;Vn`>8fEx)+SB#0z2=8C! zd>>kOqi)0F1g46Wva=u{Lbv#Fs8t-3q@C;!st0by3F)6kmCfvpR4=lU(mwrxHCgHJ zkKMl>*m~=1xselT_EhcY=8eVse)f5kN3P;#~Ee$^a5v<^dD9ezdMH%ZhP1+R0G@nfz z?%7Eu{Fm%H1<$(|dCx4JNK5#b*BTd^`Jo~Oe%(CRW_B>)94>ZGzWzoy=KHlvV`ILt zd}h3ig1nK#BsX%MB)Pb{E|Rqm-{%zO^t@L&|LD%0paQY3jt)M4M|{aWLbJ8wyWSW5pMShtMKd&&!xc65cJTI5IP*Bo-yx zcalyKe^y3mQ8;WwpaQvfy;O`Q zZ8%G+OF6;2QjGJW$)DdbXkCgG^RIa?V+uLzq`SJeiR0pI3aai1+77*Ay42X_Ei6@c zyxs2FWRaFxz;brL$J(Cj_Tb$n%w@}(Xr80~6_rl3uW%-|mR)DU#Wi)^N_)Syzzq-^ zU7Kd!Zqk;83u2m&oE)r~`_?y?mU@T}@T;y3!q|Wj%15&2kt2_w__R zt4jctfGK&CoE#1bM=Q=H)JYHhS$OABkZ<2^tGF#xZD zU^d|E;ckU)!b~Re9-2bR_|>_R@nnI{Yb+{>S=7Z6O&wBrH#${ z*H^mE&Lv!%`|<}G-U_7`I@{Yz#JCgU<8K0L3$fAkmY{=`Kd<}-xMJeBo=xOBhV>vj<1^a#B10#Mj62^RNNiirhx@rqmhZZ8`bU{62bN;SxU2M}{0AoA zRg&}zDECfzS=q>cdlg&GJUH07k&ed(g$+omnScutQqT%)Z*ME%eBW?;8ZKo|JT}G_ zoRJ{W+c^q!wO=!>r&5KXYDC3>EuC=tYJh^o8lm|(eWZ=sd`icL$EwFHWL|NR5Fdk@ zG=M?|zHU#t&SXKJz8Hd#dA-E#;d6N#NoG!>aV6PNQPi~!hYJaoX!OwFnW-n!-qr4B zs{EqIFT_WTCx~2qUBXuT<;L?bOv6uyhKBSd+TL;R!g3g(p)3&yfNo|mJr`Q1?2KHB zl?G?X)jD{eBxDxp-i zkIN}V5gK7A|7v=Ap@80ugh!^PXt$XdM>SQ&)2V&tqjUz)zcD-?Yi^gZM74W7SATGA zny3xK66{UB+d9m6C?~<|WZ>#f<2E!t9Es$A9UTD7(h0>a&HD9I7hD!){q%KpEiD@! z>^r?G|0(~2;d;YWdUkep-r9LvHxhzjpiEuka#B;j^b7_~kV(B6@0WliO3$6TO%pp& z?mANRpn4|f+GJ8Jd4YvYefu%Icvqv3E#W+6`~?65s|hPc=UyOEh9Jjuk!35^@L_60 z*EwN2J$|d@Tx=bm59d(EPiJr^i}I?fMt?3eBw9S^n|!x_M@dDrg!+~piXjGTF`=?j zNNl@>vD$HFBFn~V$N1j87iLpY0oe|DCJn~4>5PK&JT;%9TiaVO(`&g2m#aFWY*3wu z;4a9aqcNgqVyG%R-J=hHvX}#Zp0fW-zUgIFJQqJUs;c(nUrrziP3OAC@5=uMDp;5H z7$~16mQf71sNC(E*N{pk!zAM3;-Wh*VSbd?)rl{$D1p>Tw0?xyDCi)tC?PDF-fZ^A zCB*bv$ZeokkgUs1YYr0-I11FY3qRquqK{C-Gj0F{i}t~275Ci z2`Q6oZ+;$~JU!lOp6{gxgsJC44^h_fCOJPT+G>7r(SSA$1kR>I&W6}00{*yvoCIy* zsGwqLc0oa%m>8P#!B(eqtPl>1Q#kcjLe9QUbq|I(}u{ z1O(#Wc<;TOprVN#t(8Pe8@sucf4I=BS7J^NkQdgu9PlvZ=*btzEf?t~NqqEGnTOw4 z+dR1KO2b6y06hyZFG1alGH@J_5J+1MOo|N4Hv|j~ur*;`i-LY0Lu)f!@NI3hgt*LD zyfKf4O{x5x#w#0WnnW7zA82gPtv1v78d5rd9(#?Qz5Pvww*p$}4kVgqU?1{ZLg+#K_&>uh#qHMZNr@b&&rPxta87@y8TU(on5hR zbnobdm7QG%3e#8VJHWeeb%!|1bA=mm#mwlNegk&Bs~Hq^xZ!2CYmkqv(q$?iK6>QZ zR9OEzCtkp53b9XkiRV{VUIs=5c)Wa%`aGi=3fl1IqI_h*3|on=#i=gS7!3#=l5TQR9WQa}3R#%-t(Oyr3EtP^E!~3~3{5WZV3!D0^*eJ^eB! zk$?AfLUiICCyD;I;Sq-AHi7XK+=VRWW=67=q0|!ABS~F-hh>5b|X{3S*n5bjzGKaw zxnlVoGsrZs0HMK^g5*B)5gKV}=xjj%`ocy8Zw$HCW8j$jZhw?Hz?N_yDu0}aAb4iP^~3(Bg$14T-& zh}lT)>+g4MLJVb#?08uxpEnOyjZGbier^aLvXjRpoB^LAg!ym)swupT4m2qSs-?>* z`-s`C>`yh4&7Y(+EpI@KQ%F4DGWM%1ZNu@i#nBI($Cn3K4-wKZzHIy>B|APj9y}$3~st@`v zaFL*_A~K9~WJooLdc;qGbO6Q)i0)W1_hPX)%g?a_cJX2a|H0|t2!PV!BAp!tWGzL$?VQ!uZ{xMLf z5b|VveMq^mu+SnwpMiiHG3+IPX$kIcX=T-jz-Q>+-6_WJDk>sQDR7oSfB?;b5MkGu znCKx!LFj?#?&Z|f)J&shW+?tEP%;!-_A)?q)gRjKN|rPcoS2x%`|n>axQNWF=a4Yo zSqcK&fsPGnd9jY8mCL0B6N=Esu&Bxn?1NvpS`9}=MFm2=ZYzn00wV_x4mMSqu8Vj4o^i{*9V0QTYQAv4Px-L}xopnsDAPKHF0H3y-a z7F|~-#gI9pP5}!U$fn$RTuKnEw`@mlx|eo=m(QBj&kR`P4E}6DYTpns#L1mrRCL@$ z+#K|Q!Piy!$XtDULB4HyA54c3T9{ru82Ct)bEeps7A!a*5I|D^*{E{0phgMj8ip?PZn_(|47X ziA9mA(W6bPcfhoefQ#oYt=(9<1}lha$i<1Us`7x)hs?NbsR?I1$R~ZqbNjr;X3eI= zWRchLM`P7U}oSSww2YykcvZwX2{+;K%j_6e81s`%bJF#>q0Y5GL~ z?h$tnqzOm`i2P7)JNhtdp2r~k3P~cc>N(?JleNflW#{4&$j8bC_-FVLQ`%R+ofxJL zhFdO6w<<$OFkb-U_4f7oL#qmxlYKumHHH4o^L+nu^(0y*K6G8b`0+Vl)?M0zHNf0j zpy;Ei`;yXkyPA^A(DLjZkP<+p_?R&Y;Ngc;mCFvI3FT!AGUCU=z@qtQVd|>w6e0iA z`GGH+n9}F2(J@q5#Jd?2{PorI!Oi^)C*@Zkq3eeH1>n;qyu7K*w9)^~5m%R--K#qC zlHHDuj<3K#4;+IglG;uP%ca^>xqv*cu&_eO;_z3sVL^&nOcXi0_GPphM$Ax6EoEp! z0{WinA4R~y!D3k{VxgbKWFTP9Nl%xH zkl$y4NQQ*cgbM++yg-VGVYps)cKP(CV5fZwEj-ZSuNN0p$BG`;r$G>_OjfnJ{0 zRaQ|MG9rW95$(L@x0=(@(t7-~W4Ncs54x}A?{S?he=^3`?|?k?;7IOO*wt8gORLzG z3k&8SGct0PHywlkciHLEDOukIB4Hq`XDHtQNhGfE$D+5v1`NH3@-STip2e z;O4Hs4Y!w;epY~YpR1;$TrUY<+UEj=*~dh>{4Ui)FFjzSKj7)Lb9Cd53otOSm*+}P z7Ci_kaB!|N3?j^lHvFl-1?JXzWls-W>p2(kN)Q&7%E+x%t2OA zCfr2G58_RhWUo|ew54SaZYE+|6p~A+n}*JcGhE;)lGc_tcMg??@gw6KLCnkjbNVCT zf=hqi7|!=^-}DL^1Z#Ku6su>z78si$iEUMmfTv1u)`ieUS(uqE2j$c5*wFofP*O^k zFcLHx&$#f+w1>ll@l7zsIa4&;%Cm2KzFiq7Wka{Yrw%Q|&E35{0{Y{XE;`<^T^FDs z8gF19Y8@Fs=B^%-Jq#>#c+HKP@L0{So^d#yx!~JFY!F57pC}0{$feN=I+OWNal+0S z1^c?x&)WgqfTV@&qVRaWjy>?=1;OOczH~*`rU(MZZunWxNUvv6 z0k(ROxIdKNQ#o)zp7IIfz(p#gcua?;|$Tz3pCYR|H1Gyt}tuX z7*~wj-Mzq&x`8~`Dtd-GRE?7712h{@`@zyo0r>>svB4Jum;g6lZ;9Rekh%7XFmaOi zzMjm^Im_z8EpSw{w1g~0xT~He&m-J!7u!}8nR$z&a(Js~f6HEoyZd>9{XBJ1Q}Bh= zAWwtq_N&1R4WEbTFwBBZukw%eRM-2@1vm9FVj22=lo3*n`66Bs5|TF}AytNBN0;Mt zk-5^az^6)gw;W~+ePYFQ{kkdmj-s_07i=-Ny3m~-KGbixIFb5 zqx{lo;G{e{IddG1UQ{|{g%mpld(fC*Nt$_f%APB1JGfj$7n?SU?T0*U=?(f0pj7|;b0}+!`K8| z`R!LKMTIG?R=qk%5*fd;vfw(HbAOwa=5RjW!GB5(K_G(eU`~bLyr6)30d_>i)*|M*u}Y5k*tJR-;@>GADly)cXG6H-q!-<6}(SZ*PS2A#|#}8kAkw#kBN2{jQ1Ii|2{R z#*D&2-x_}x8YcXTzrJ7Hj8CJt1Z{#C@U0Q{1+5EjuFN)Ik`g1of{fvawyPXcKfPQ( zx*BXSP+qdov_P1}nfZ{ET1|iro0wW)DWiSS?n!I217PsK9Z4eW93!^6{v;IMqFGff ztXZPf2=H!S16>K(paih9;#haRM1gxLZWl1d_w>PD6My6>L@ z-@!RX{9FY2Pq%e-4W;V=dkZWhc%||^9b0D{E{oKMKcB#jIesb`3#6({L&g{%MYEWo z;P6j5I>>KhBqu=Tx;DWqRPQ1rDe!a~I~6C==!#L=UtYOO#Y(oh(4BZ1`0l3BEeEx? zw}X=paZmDJI6U#;Cq|Os`}Z__zuqP|T6$W9lx}L~+xs4k2k8%hSqpN$>H1h%wOAs! zBf%P^I85{z!f$K#ThM$-ak0yyBB)XNT?Jrt+*#}vtRo=@P<H1+IXgZaPvD*Wh&t zSAsBACA_&e63u!B)W4md>2GIVX;1GyonKf8a&2_3nXI-GII>Nhcw$-9eJ`kl&L>i} zNuT7IUY6=rH^CEJyXJ}QMR}Q98fjkF0kb9}Lx_ZQi8-Y&${G0|PI#HYAmn|0i;c^B6IT zXlVFD*VPn8C*Jzc5)M9^YVi781v3o-@IBVPkcI;21LtNcFvf3GfYOEzx{cY_ z{0IKS^kJL+kP)^@^nTZD>)V-fQAVH8+g;8}plJh(d+6&(#%llp5NgD!g) z2k*mvVZ}}icrC87S9#ms1Y5cFZx3KOe?!ZIv{Yc{YFru2m7(?gR1e5;31KjO7aj9K z&-{>)@%>HV*Ycr(0T)k${=Pl{>-kACW2S>M4q1m~zy(Sqb3gWopY(Hil5jf|3=r|b zO|3W|+H`?t1}_E-DL4<;q|7?18pvp~(df7k)~n@SUsdbmeRgTP7|m8_V27UuU2j{b z7DC8bl;=yQCoRU*o6k82T~6F5tvbqt7lW4x6d@LoS~sIpar(K*PvkRXIG|f0ZRxFF z&`3fLU08uO?$^_X@DLw98%S%AwVsY%pFl?Ne&tBQ`FY?C- zH~RShZXfXfIuH5(*~OnqCZ~>xKt?5d63GAmyiNIk!|?tu8>Rm@jNsn{ohYc2B?>uS zVo|v&Z(%`6He$WQa0#-DbO0W``CX!*^RJ{`T=-zOIA#>qT1d-ltd&qwmY#{)3xAHY zNRrFSKI~u=+@rB9dfw1i{(6W%Ys6J)=y+LRje&?(OgHHja?;x66j}+d%XIucFTaN; zT%-{{tKPeB9oXYjiDP%lDCBc2bmz5;>26C{@91D4^gfOlOMI@Xuc0KAMkv(CL94Wj zo7>En4>AtROq7fpZS6Nt+t_b0X z{M7K~u2RvkxOj=8xy|8l!+6oANpkAR&s&w>UrBpS%nLbglg00s{pcT(iM=RD5%bbT z3QO(J6zx?>cLGXc8vn513yrMJHw}4K9)5jA7YsYkhEfsQJ+8~N z-;=aZHVQL;&!Xx&i^TyvMw zz?m0LSJ{j+G|0B-)<<}Ea%B1%2I=LFC2y*b{LxCe>zf(Xucl)2$D7K?$Y@E#n+kkg zad@a(GQkf=ev(vT`fi2L+#*tGJ`1;NT6UTBCuGQ`VTQRAsTk#vvKxDXqFWygEAN*0 zW`Y0bl}zw4s%t>@Mdy7oInofk428Mwm!yBrD@6{a;U)j_ZDhgTNgBdS&s5EATwIpA z$#yzDIvQHgrGk9XfJODatc3-O%9HnasFxwHzExJ{-h8w`bJ=q=y;8{SOo7w4M!5eM zLT<7IRpe>0V8@c=ub;^y!@IX6go`fZ=O<$^W97K@&u@)My8FPV5`OQ-p)`_o&Yh`z zL6-8uRO{H)&20sHAd*FO7PfZ?InJID5f$wn9X*GFMaWVQ7NyGLqOmWQ=I`Q0BZvIro;PL$h9QI*KpXR>VD0JIZnC` z(~FDK(1zoavZ#Cwq%_X*$+m*cu$4dj2`^Gp6T)6DtNx4`aMH>uDZQ*^L*%03Y%KDW z*VKaNk&Wa)CykAb{rwsR^Fl|aOfb(_d4N%KR?+15C1A&HA(IK8 zwYYot?q_75tepDKZu0W){bU|QsdsRNw^|+ot7~TOe@LgS3d%^ za2nB|*RRhTI<+#z3OO<$dI!iLrayl)B9n@Ag)gu0-g*BAKGrc(^Msp?jjd;7Bt$*! z&I8yja+%kh2=4;zOSmQ(g5JJ|(-ocqTbb<(bA^kNInbEhM3#~3%0S%f-#8~})<*{7 z)4*>7BZ-0n9m%qn02l#$#o4}yG6f>oS*vc&@McC;W`-BBcA_i3f0}$}=e~=NG!&l8 zPo_D8GISd?tK1*6xn(!Thxo)7yWT(jb8_Ga^tG(KJQ99k-1VOk{~pce1uDL?$gr4| zV*T2=YKS)L4rtF`74oZcUi<>P*TEO$mr>%owF#1f*#5{POIzEot&uFQG<$@pgzUX> z4ZlcNokZjx_F-CM4?aJ+D0uq9xjgN3eY|2W+5oK{9K&f4gxEaN+>5iNAR&owaLoT@|lRZROB2u_o#ihZEYc$S@-iVY_G z=go7yGzZ}D1-pvr;r2Z8RR~H(f`r71j?)aKIDgmy7IeP=KK{@c&7VcLZudo!NcfQE=R0@cbA+W- z$#(t`S5>8swc33A7a+Q?Ar|Uz+qQQ%vT}1ZgGotA5uR{TtQZ-~<^fLMF|tn|Y(OF= zUS49bpCIl00j02!ZU9vhxJlrP3##kHjPGEhjM$&!oy+{z@5Dm89;l0}1*||jXVuT_ zUdpt;;pSMgi#-` z;&Ui1D|@gpQ3WK~Sy3VK%Qw|bMoO(n#b{M~ieH4_)nieoBuPNMQF;Fbp0j6YCqQI5?xme+kilSy7+CXAjyYs2!6(I|Zln zPCW;*)WI|GJe75%#Nq;MEJYg^HBkc0FE+iUpNmF#c$2;9yzvjXp!HWhhnhLhR20>8IZZ*?2Cy9F& zInLb?NJuf}g&cuwf6vt^9D4O<-QG8snmN_E-H%Z1TiP))lfU2^jz2zQT@`zJ5!m2G zBPq6jdw&pe)U`>!ux>y8_vY@dOaB&6u9@YJ@p^AjXjon5KrE0ce}reRl@-pRTO@Vx zE~`daEyU9FlZ9VSh~#|7ADsGMvxHu!hl@yF|GAu*jJ&3$rKQgZ$QvAVRgtLPd<~nc zCyVYERe2w|m2qbO{hCL-NdBi!y}S9gRVT}kcwPD{?57JnSIeQF6QrT=W(Mtw65{YH z?Ap)wd{mK=axG8598#xb?z|Z!)FxyaS4qcfybhhphOzVEwNBPLDVImrzDM>xxvoZr z2aigaz~={IMW3L*diTHvhSeaQJY5nO$?CNHd}4?qP-7cm=hL7ag*X-zALgY`#VhS@ zlhv-(f}iDIUk!yAUwIwz%g&CQ(tO8iZ*TLQ=fTD|NFT)ZWyqCv;oCR#be66b36Ptq zcb8wJh@&Gorl~PJDm64t)zX^vAzl_ynE~nEPr7sKJP(l0*Tv|A2gAj2`o(02^2W8N za)GQh4ixR@QpMhSzCBm5h6|mH|mCF1}mTr9j@A+x0%@3?h!v)KVGaH$yQRhr=9dWnPEO^o51YIz@9zX zYdh2lvZVX4r|iRrsT&6d1_twb@66hxv-{yE3W9!;2bNDXr8;bu$xpBtE-65phcbPb)kZ)j*}kUInsbKxCzGP%(* zo0v;H}=f7W}#Jar|<-*RNlRVtAZ!^OqdIx#cMwYM)&CfD?se8)8 z%$&1IppCN(Wg-C;ac5g>`&(h5uj;vpYa;Je%pko6oy7F_t>N|ACd|#vxe7{w4#tPs zbJ(_m5J8K>XMA|B3Z6M9bvweh`-P!E%c5T`?U~oj#b)jApjg~Mq5~J>6fX=HL%zl1 z^my+3t01WkTgmx3j@Rk?2eLjf{S#}y+T5j#8{BBdtW+ZPf5SuF$bJ^DkbgHuQ>jlM z!~bdW)vH$-W)79Zfxmt|MK06^PoU(R+;w3nU0PE3=}%s>qw%sfUbzMxo`xOod3Hgs z`&CP+VR%~k+53fsI9hT9k1;hMVMmuUYx(5;kM`aJD5|a97Hy&!P!R+K34#PsK_q8X zl1da6iH)!&XNeLT3`kHAL88ziN)!;uO=u91BsoczB(cdkbl-3J|L4|wuj;(2d#g^p zcdL$7*4Ay)YpuEF{Nfnn<2qzDU~NGaXw(p>doqs7GUTQR6`_cq_eIJ*MIOiEe%xee zlut+3TcJ}fA3kKey-6#yvB4A!3UP3FB@{9V5InsUS_9A8t=HmeWs<#?Q~No2J!6jaA`O{TWkCA9SNVW(Zb@?h(O8N;JaM^5nOUNmx% zZW4DGvf93^7QS^la-(Y8lb=^2)q*U(9gcE(MD#SRhp|P$AloI{LN7%_2di-3uTzgA z1p5+Yxne9Wy!2$)7{!WQ{k~1#zJo&Y2P6=&QFspK4%;WB;1*Lv;aj@qYrl18Kw@P| zBCilD_-;?(V4$xul{KvU#tFIe;p8YFnxff150rW2=7je_P}I!C0dYVwNhz)8C4?K*G6Bl`&Z;fKm2Oh8`A5CvTTk#y) zgr+a~#>+_^%g-|PG`!fl14w1Qutq&u2kKi54uo#bu0grT_aG6D(8856GVKTF`QzxMG&ww<=`=j__- zQT#dhdYvMo2?$?Waiee9BtrWs190RkK|oIp)4cu$$RF zD9`Cck8X@D1)sg@-W&2ugqZY#11$B?cpUeyC(t&U)X7A`1>6{EJDk)`+g!lpE;5i~ zgG7AI_NOKn3kzOki_1Y@aWUK0p7ag9H_+#bCU*LXUX#I=I}VJFK*TpbF(Le@iQy8u z@+`#kIIlA9?iZD1IPX_T>QY;)je(8&Zp zh9n`-;)Di;(?*ZpynG+)@htnm#)M^qfduxnt}_Lg!K7A+v7qqqdNAG3MwV$H@646G zRp>YhXr6r@`F=w2Xbx*{bT}kRNe%|-Zq|*{O^F^O)->&PXy}YMnCMhC;A0{pk}G%c z04!)`?N^JL*JLO22Mx%Xz`}PNSJS$z(=R2j#lRw7i@?QwTy9|cP(1SF=o?(j)0^2D zMf2$z3E~-IxdR_Iiv}HZNy8kI-!DJ7!W!bk=Xl!GO6n~1{%_?ZcJ|7K4jiV7wS6XT zubrte4=GS4N#(C_X1bnu*P5q5-3W~&I&;!uBN30%;gKP*Ub5gzffk? zMJZ6R*_k|-3>-F&iT25Ht%u0lziKHP1S2FsP|o~dccY=H={m&106IDM`;}|y;-3ga zJt^w5Q?Kgu3ByC_3};GJZc)k&gzZhmE5=ePEtRi@C6jb_auU`HS}rQJ~uy(2B;6n=eCwrmC?lpNdD@~D!##Ht%IP{51nt7Y$1bXSG($SJ6j*pyxBGZIXI)vIrdIOynX*ed zDM}2nt)}$hNe4@~haxU})qi13#=>rg z@PaPn;|Gw?fouTb1YqS#+fxtV>s-59dC&)QdXOr}KSf=@kXJ#a;|tNyVeX`ju>sh? zKH9c8kwXB}dw9@@mqFrx!{X!M!;x$T8ZN0aNq%?^(!nSx+mM>>Qd;(Yd$j)j;~er} zr<$F(pv>N;>E2nr6ev0efr5ulN2(=w9tZT~X0-*hr5G|DI zjhU*vW_jcpX9rFHVO+b7F{qT{#VeWk(CHJn=75SKV8y4*7 z4N2-tB_zZWc@G7;5DL}z-g19p^(j3@Qz&?OhgV;;UYa#U<@I;SQ<3aw0?>w?R8cbS z3+*jgrx#rYZoP6cc`^XlB!>rncU1p*K{h94gA^-%-)24E5b!p7KQ(=m{BvS2dh!73 zJl~Fe0wk8@PEpne+EdUE^jnR@&ZOFA>*uR5smD?+xU7XBXL*pbFT|z`fJvj>Jx&Q! z7pfZux%v#AuTF4~erelY1sK2^CTvB3mWWNG*h=!qNs}VGIJkb}k`Gs31Gly}AHHtH zaFS_Y(wrNz;W0~vy*Sw?Rc{>IedV!_q&gwzg~ryfBw=+}KSo_%5A6BV5eE3=i}K)J z7BL$JU`?~TJs32)7;D^B8`;jE0YzyFx$kiScdIzK(HI-;rSIsq6bhterV^|-5`|3vkx z(zk3^Pg@(QIdRF$vunw&JRjS_di^;w>;(8&5EXD`T0{hP5@qz5d>~R}30vAx@}n&C zSTgaHO_KN4xg}5P%SDI7&(DP!0s$Y20}TlZGT=3z3T`t>`~z8E7gdlMx^Nb6*MD`G zmI!v_nDK>{SYZmd{u~a<5Xe)){nR;iZ8dO*r;|W|q+}vY=GYpiQy7L|iv}^D4yxz& z_V#m90*8v>zqqSv-fL%PT^>)j_R#kA^khuE{Uw-(chS9CYQ%Zu)*^Euo=tW;?i+z% zFooC4xnC*Ir%~zxm@Dqlfb~8OD4^ZP#*5Bdp>HqpbMUe?HBYuC+;HpW_+oD5W$aSF z;=(srO`PvKh_ zi$;dTRjqV|tmCaynlmk7$!2dIf3AKwX;)cEl-t=3HqUBdU6uXjRIGnE#oW`&_&&yE zM9ff6a`N~lchB%ffy#2JW|rn`S-v3Q&>c#z!8)JuvoUGb3NBn28ZP1G(mVN61v^}w zQ&BVuFKsvI7znZvf6hruObV%pk~pSn-~ogCiV*V5;n?u1XZogU{H0&-@AAtr)2FB!X= zLgutGyyT}RfxQnQ+^h?L>TvS6xs8tpTwR3Ha9__S1K`p=sCZI1c9>R&AB^Ec7jL!a zGo0v>+0=wdoxqr!-Go8H{W7D@#S|!4xVyVIaNZI3-n2s`o#qTz2K=G_ka=*W5@NH! z?*p&)2VKf8U(@UZo8Glq4bZF_xSue90(?qKn}7P4uu1rp$33}13mP&hVC@lsP{<;V z%?4Dthm6|U+tZt982K+YW(1Cp7=T1@^M_L7fIX zM;=;mAzXo2GH~!_^B3egh#qKkz<{C%tP|o4AU(N(kORxr)zxd^YKVuDC2mh#+mh)g2KP7iVdDgA};|BNW{XE;Dl~-X{m4qphB$9~}Ml%Zfh|@?sFk0I>f{>$vAt z#2k>Af?Ih2F|z}Uj^sy%1m7F$`E3R(V@csFtzmfc`9HVzQ~dajFMtLv>y@)iGAo~j zG`?4i`l0A^LTX}f3;wv5BMIrE5kLx87m#+rv|R81UG~{9kHAf2TUxxnF*vw9wpZ4% zn%jV9>>gFAmA*2T>FINjKqBkgzPR&OUz#7$Or+&lxaPfg?yR&cjcPc11YFq6ERf5+ zmc~eY)5Yj&=fCuu;iFXP1j5S|or(Hi2h|GB+skx5Nbg6>ttp?Dx#QVKI+63#OfqJ| zyQlaB@phs)CF3s8)__)*;2TRsvRZnnUrnMPR@3heuSNQ-7LfrimWVD--CjKBPwo>U?=C26hmAp@Y<3L0w|J55}=;-iKMY^DB7G)p@g=9jY6Mj}^lS*1fD>*CcDD!VJ z8&_8bGcz+MfM}Y{v?nu*TAf51u4n!-f4mXQ291gg{NV1o^?P~WKXiBv39(OrE`ff; z!}br?kk8v{A|HPG)!zR|r2k!ZcK!mf&tJrldp^?I`!B(}M9lV=IHWQ2-wJsDMQbpO zI52oA)e|cXkth^6C?wT^>dNbXzbq(DTG`sxfF8*emq|5{erX8ZV9BFJT1tHVt(%0w z9>QyAU0l0+mjUs(6F1oMooGK5EC?OEYdaJIHAu6u?=P68T+YMxK)wMwRL%MQosdjv zwB?RixS7y*l(xB(W%ARcsmF0?eJem{Wrwd{_k!R9RISDBuhQOK1Wv>yV;lomDj-%U zo0)OtRBRfQgWd{sES>@VTBJ>uTS%pXzgt*_BiM8gdVA4)FA5-ya`Te1GL6g8dH07(I-%z5Nb}{l)Lps0Wt-!zFitwxw-XFEC*>9#PNXJK$=fr z#gJSwA~u!=iFZKE4mXwVK_z1`T?VBnFnXHoY~8@+=Lx?fj5YKIhRGPnS%U*YpzN19 zo+Inm5-)b{nQA|q#}FCH6MB=AH>IKdFo&10ANZ7jD3=D}aMGx%K0MLQ&Bxtc9EGGg zbCRH@`%f9F2V|omHbQ;%TC?!_b`63Y7FJg1VmR*+ikl<7yTMN;^B)2J-;f?f@nwlSjvNE*Boxwa>|I~^@n!S%6GXxMkLF&{4D1(Sk3}OlDbV$* zTD}_1>;c_oRKTY3z$ksKWY$0?^gGR=M}?E{fqK5J6dpN@8=nKyt3rj6O=6+WsG4Uy zupxx594esZeGf&a4MSn?2`@NN*Bl@Gq}-Fsm%R$L4fqwih=m@O1`n=ZtVBh?v zVvAYMRov##F-ua7zU9{uN-inls+T}?o;06QDVK?$0SKnx-v6ox^H69!bGdlvW0**D zzJ)`@#(hq0##p+-k0KU7wQW`EBKfkB4n$ra9gXO{&Tmf=Oyu#Ct5(ovycSNT-o)%I zANM&e4myY#gJ~LNNcSN>Q>fb@QDmG)F{^-SFk?7PZ55^!T+7RVsD{cP%KJiEcR+jj zA}R{HmNP$MqN4?%RBtQ~1^t`q>UUB6s3-uU4)2G2obyBR282TN(?hP%D;pl-%QJmCoMGE~`iDFbqraM0c>O zLYHJ=pzwC_Pk0tYz*sYi4IY24D9Bg+T~oLzJW7xK8w|Q*G7_xMhAe&ko!e2R0~4G< z2T@(h-tU!mgM8cBnewly=c(yBpN0GC!8GHuC@)YsNXh6V*xb>gUm$W<}6U85Y$+$s}stNalS&B@@D1bu}TC zveYTpq{869*ekxo6e6-=d4c%fvcke0U*FR#fAJGx&I{+F5xIRs2i3eM(1~JvQFiJ) zZDBJ~J%_i6GlxoU=3;)=`IE<{$uoHbU#;%LL2m-R=411H4u%kXI_x5Eb3M8%tFZ7M z?a9fh0;UI2%n{+w^naiGBYd>#X$Lzu!R!1|K4<4G$}{(^vnd;=p@?C_(m4Bpa`l}% zM@>J*-pRB`lioq)fs=0Yb>nz${k+)MxP**9w z!As|`%g;K$xX&8U{=k8He1@TBM3cOfe^0cC1wPB_X(M=_no7!xX|=>=ugrUoTLK!z zu1D$2&d$!2EdBwq7}o9lLyGZ9i855^cMU};xxqunhRo35;dX06VagcG2T!3WaK|!8p zzxsrduBxF+S-x<9k4~|H$%)|nMrg$Hw!F%HCVk}rdFQ;sTeduE@=W-L?~a3f1N!}Z zb#E!Wy_(I7!?MKtJI0J(inJEO`$az|44VJQlx3JGyq0$F%!MYdeEYA`e+DN0DS9tH z6PXq|8d-d!eMGhqe{u8T$mGqi4;29KE;OsgjKEJfpmEceoUIR~YGTB7Z>UqD$C z#b}>}5L&7}E$MbNpx4s`=!Hy!cm9D@iG>tg7N=)7TFC}QCD_A(IT@4@)EMF#w#WHn zg#mQBrd%xdQr&!f${(=+)VA=o69N(4`636kuvLD}_SYRqR)?wrypN#PBBS#wU^cvP zD5Q^EOW@pn)x9ZkxW##|`h?#HRw4D+D`ar)K~W{J=pBvg*5ji3s|?QXp-3Wo7%9z> zp@0lv*>gKk@+HXa>v-MKu7*{rsqU46^bCrip!7R$a%`@3<;1iPg+EADGShUt)^((t z8i07fb&tC>GQqJ@pN-GNzcc9ulo*i4^o?;i?TnNJq!GVEpPLn~QY&Bhi2Ck&zRe^Vg z_7oLrVX#>1pqPK}OPC}7c=;_gwKsgTAZ3E8DqE_|3WMT*C3WoGJAkxc_ZV`1$#U0L zfw7Bm+y5GDk{qA8|5&3C#cZli#hS|5twy1hS}>#lVt^aOer5R7!@)@fx|24+rr8RB z;`h3X4SN0hovLyz*zzHb%dqAWkgp}x5lQu!{X-wTxXj)~M@)jP2nYWB%I7GM z)7Z$lJG5i4;R`cR01I_ywM{Uma@VG&s1bvt>E+CuOQS;Jb0P>HV@k*OV{-B}_S1Q= zsZ1gFhJI!p^eTEne?tAB&HV zsxc^Q>`j0e_r}J&)uE5nu5C$jtDip9a;KX5K20KUr)oEc*2fMQ3<1Eu$RVqx&icUqCL`rk$5*to=`D zlC)6Sl-QIOR(($Co1q_1xfeV3Vp+ zw_MQ)?c|+t4R~9K-~>t=9o+$?)+hs~gDniHShn9?$uJ$9a~D(f7b}@RMFLgIB0*}v zN6@FP0sx5)zA?vsFtws2uE(yxx^n;YPgsFV;pF7i8CLWcYdNk!@U{FL)Q;K4r z7Cwm(Jey3OqpjpeKb<~gaR&hcz1QReK3=y$x7r|9<$8CwjqSptK?<~x$YW&IK)}BB zJ!(ME=v{VPtlV=L7LDKoD+F{oGGJ(>TSIqJZxjP4zycrrwpaRywK{W>EOWEP+qwQC zljPrFJ)BO$!h3J)A*H;G=j!Z(D*g+I^H3;8AcwP*gDynta;z0R&|I@QXas0KL-M=W0Y0Z+SGK_hYHlFO)7K_Z-~1| z7CDYOu>1}+=OoX}-)O&aBBRg%O0r^SFRq+s@$!+Z)$@6BRbl$iAMyazN^lMjsocg+ zPEW!4*TA3pCwl7!-E>%wG?cVKZ%-Cg1qoW22 zR#Z88?NiV6ts0&I?GTqc4k8&ml`CE;2kQJz>%>4R-hN zp~y<&KLhfLb^96TD(%dA+OX00u<=d$>(4UP(7Mj?KGrn6zWFu^(x}MX;`jCn=^33& z#&>GArNhm>84vh6Q%jdJO%xU!d%*TV$P-QT=(kF}t!l~zKY1-4D-F?Rv@LaxPnq`{y1F-~Ek8lhU z8I6A3ej9afCF0n*{U?h37Yb&<5+eS9AT zy+|6d#cC$gA}EmDd1u5=A0Bmf2{M(0KbBd9-cxIoWi$zgixO}B4!kfjuKVWJn}Yk_ z)%YSTr`GPYPQyZ(7HVdhXDB)Czv!%*zFBwGjP==+2G1+hy~AG&S%(_f>R#S1)2g(EkAkP+Un`VF*?P3}6_WV01)DYt#7|94Fl$PEe!h~2(h)W*#6%!r<>gyak9E$G zlZU^C(Lo^qN4PtXo<@O`1u@5h#Q!o(T#5ga5%Zr-o2ab&3wba4{;xR|-~N021lRuw zYanGw(VaevSLt3yPfTUXt)7?GqK%SWX=d`^vf0gbUi%p1Hi6C=NLi#nX3E(qQl{^n zV6ST&2%u3aO3xm5VUcKu3;$A zrBD`1yEE@C_fQ+8y^Vxlm}P$6GL>vvLfqIW%6~qGrHLyALu5Mz{dUGRWsOSM zCR9$;SH=)wDqNIj*Uo3O4;wnc=Zs&ujf{Y8f^*5ld9#;wRgnxY-@jsA>9JL54$VY< zvV2t~C5JGt(f7KJ5InKGM%s^e7(rHX-{A(uVxlnJJZ7;&gTfz6T4CECFEv2cqD!?n zNwq02!=1x#tHC}n-b_S7=*byJeBaZTixp&}NgF&2QAFcn%-WKA70IJb?~22^Q~BQ5 zwHjBgJ7fQk?g=|?KSr0Age(^=Av8zAvBIm}7 zV(>oBe13Rm33mzK<0xi{Cz6Xd3#PnRs*n&m>J*(W+{V?BEU4zB36nlcnp~C>EOrDwjjX1L&jI()W{N^W z&SO$_idusYJMz_oONFN2Y|lHu{UCb-w%Bs$v`xgDopOhMZwqxw)Ln@g^yDd%Bjv9z z<7as6GKUYL)HFgO`KWr@y8{RP)-BygKVGwk)v)m)``&C(NFcA&LBV0K1G_Rl&v9mR zR6v8fAEWP9gLiIgBZg35+3r0v$VOh+&{{s;OqU>U;%y!!@PAR)0J3uV)B#n9y~+M#1o(lG_?`6Qw%kA7#^)s@EmdQRf*eI z48F5forbf{CHzX$#9NQu##x&su5J?c)`M_zB^zg^JaQ}35{RAi92ekkJR9|oa4XeA z1)gHHx_|#PMGFTqpsH6aokmvBca{mQXG@JKPA2n^H40qW z+86#ZkOl|$#fHMx47>9PobOHwu_PCcOobD&Z`ol>3t(4S;!#6MlE*Oy?lN#rnRheR zDQy%+ckA(@w^2g(5;Fk)wwzG7gvm@092n3{^oavbGi($G&$}ep4X!9YDm^6|?k8VKmA8Hcj6;yzlLrCmly^_dmNCn0gdOh3Url?$ECJ7P`PC_6d5V zhw))rLh*sW9tukiId@*At#SLEFCy08czAbz4Xn(>ta5dNGcrLe0+K*V@+M!Q13tuR zsA;gApk&9wu46kK*ETVH;zUzux)S#7H<{G;`fc7EVERJ+H)Qhp3{8IFpR`zsG51h= zjtjfDEQ*k&EyL>yVq<(pGVx3`9yjbXCpHaOpsFMsaJMAn&nA76>>@A>O7x4t%u_bh z+Z;9ul%&f-l*4}i0>0P7LMvL8EWkbLrHp30{3cVa=gyz%TT?QYokC*Pe2m~>J^amVU+S-*7}uc+3sut?m)4i(Y6%bZW2239powij@`qlnWe z+CBJU@?E_yU!CTm8#IHld?_ zxyoDjt`J7IaQ!P4CFj(f;z$-(1_o|>$<&T+dlSrY^faZq5L%h26T0}t(hVgFdjjs za=*~mKg3-x$$9;_Ddjt(%%va8dls1C4KQfqxI@_bt)yL6#PWdkds#ecTm3HPxaz{! z-x5q?r!)>L(Z7XdL9C`QF-c(@9^r2Tyhwr*V1$FwtC4NelZ}=-n)}Ln_TZl>8vT!J)BWIHTs$SjM3C`RO8Uh8 z^xRGzZ%5eO0+H-5_9`}=o`rJL;5A#z{Tb4wvK_3hEqslABNpvDWw)ikpwnEcP`g`p zLsY^O-w&MteYr(qyv5$L!bf4X9Hd?Olb$d@FXF3)uHJD?&{&j_mg3{8uDx3^&Z*hPl+3D zP)Wn(#rTEz<<`V8=bus)TM#}-^bzzFc-sw?6fYI$1BvyU3;-INvDrV|PRNHNE~kcj z8rfzLP?^J*!ih|gzph|7o+YzK!ExvfMK}^jRnh+qJ|HlvUaw0{ps+u!OdG%NUg`PF z#I^W5`6Zc|;DZwu5HHQKZs0w0dPUU;i{`V4d72;}eiLWE2Jv0k>=F&0ro4g#E^rKX zL?GuD`1okHgV1>Aj?@RXwaPb8kt{!v%aIOtHHJ&_S0I|$U#&|FBrxt>B6mW}^LLn# zJPa}0AL7TWlL@U5av@uscKGOv-7k;6wy8Me42Cb|{Q79J%mJ& z>Nt-4Y&`*yp-jF#?OaJm&C30;VNdWy^%Ww#EH(j1I0ELW%DZj2Z-QwQzIH78yLb2T zB?t+^kW&a>%_U|nix}tB>NqE`?;ErP?@LcbSBgj)0b1yR#{NZ&WG`tbWxj6{?xDLa zz|T?hdht_THOFtEi}gq(-FP@=3?k3rlMkBMaa+{oo31QK3<;sBUU9wfC2H_ER;6L^ z&^24+!?MA@cR9Qb1FFOkpY)0Mbv>9#&%Fx9vr_J-P7Hh3=%-y+2vN@dBI>^*$6K{PDFOjvd|add_q6Z-PWk?iNcsMkB`5wv(?N+% z%0($c710Wy+hF>CVx#`IzxMw>11*E4T_%IL!q0PktaJue8nhBlfSlwuNCW~R>mmP< z&_`TzY#kjPQ1Pz=47gLzJw1f%jxgc*+j^Ifb=r6aFa#JZZw^i0^z7_=6x{%lhbR1K zLeIwb8lc<1zcmXY3Y>TDoI?8HMxdAz6js#s%ncdW>AL{TKTl}BBVfgHfGZ%^o`Q*p zyR`sxa|UDpCqPNiJ5735e72puqWuv3So#TgFO)Fb{Rhr%ewnzplmhT8grE=IoFEvB z061G}&|G`R#LYEF$HvCCy^!AqBLiOn81LkhJY%79Lo<~;ykCZ>*|Tpg`*r>gW`(!7^wKPk`OTk91b_x2wEmKKzT7$vd$IP8Eu&Gd<>)pqAg+7^%4^k|4lwU3A^B7 zO(0eF&EX1f3BR?3QByz=Blw>@KoxBW8^Dr_mv2cCz30<@b@<#hi3&v^hZD>>a1HiG4Oqc81 zXJAa%!057uH|Hb)<)@h_&C~XA4W7pQFVh_Q&g$j-a#Eeygbi^ zIOd(|P~>dN)E0WoF5`X-B=D$EzhQ{_y|TA=7^pbdWCdF^l)CpuNLz7RzMvYR%w+r= z5s{!Nh*NN1h?Vumg2de|CDAuQ?rF&;4${861uV74&sBnPpJt<#zT3@cB9~UL*IYKcH98YCMW z)Ua8(Go@29W%E)tex@8mx2X{&50H=|i$`_;gzslU>=|%0>X9yj*HyZRY&ID$7S!_I zp_~XlxZ6>2$~Rd6cBPudYA&&ldC83AqpdbVUJMj?|g`r~k7+)Y6% zw1l`jPX{s|&~;~rc`M(;*kmU4$xvWvA5{8CA?pFtxz7m-9!De%zk*I7bc(&)xjwSz zdk(YvxGodVZcnbik1`^9rhS~4Z3_Vy8R&x>?;9rlRP-nL%v(Xfq%&1PGUtYkAtiO z3e}aSRUd=jf3!bJI^an1S-ts}qpv`xqqVn)m9Ncgeai zkmGv1PW2GJ3i-{HhFgYDjPZH=NPaR)yK1IX1V)?sY$>ujpx1ZuN`{;-0Mb{W;Fj;sWg*(M z$UI9f=u)g5RZ^03987ZGUutbbp-zm-A9v;!dSjXA+T3$|e=Oi;2|q837zan7ZNJQR zr5MP7M?t&TEb_Px~OV})tsc_fg?u!`Mm zarC2yUTh60edGaC#%-T?ut$bMxIto%DPSHaaI|0sUH5A~t~uH*(h9|f4hhZpf60`x?;Gk~fnP*LyR%=F zMtP3sl9n3ZETrX%CudJEAQ$&=tW-}@?*@n6>Cc0ED-D|iR2p7_uN+=Sydr8D0?vL;HMJY<`{GCk6;LMr!!N2>^lKJ(4_cIM+8?>U7uEvboHx zcqJ7(V*Kwd|o>-wJMi~P=H1_ww?^IA#KX0~vW#7;`>zgdw z^n0LL@U1FcKQ+Z&X-nhBEpb{@e&FU-KYaxlClU?-MnKZUZ|4z8d$1g$n|B*-*fAke zA1v$SrU+rOC2C1pD~xrqbQ#C?TLS|$}*)~7{bx}JX=u?>;IyKKlU!ClDi z&ZH=Q$kol~+z`U-gpNfVAiIEgudsF%F`8}@5U7NBc9U9!!r$^`_^rl>XuYoVsk?Gl zsG@q=tjB!RX>3gK@h(9p2N%}zx?XCVg|1ptutLQ6>W(84eT$X?YG4Wv6}K;`e@TGu5CFXQ>(jmJ0WSC zg}C$J6!O~uTX|TaRAlj|<=rg#YAv+=TPD75RLHCHhSgmedffJ~^}UqhhrtZsl2Ra# zvGR;#|F7ysPG}}bu&}9k&q(-5vr>%@bm)%X@cuxaN++8p2MFk~Oeg!O1Pl zu3^%5wyz9GYd!>H-NTe-BQO7|v~BUnxSRK6U63939K@6%vfmVfH+@r7!=nMC+TRHQ z0T~Lc&Fc9ch#qXAnT#hx0et5n5HS%)4}n>rf)QVvCd2??@`*w4d2@i|r>CbYBIseb zyX}CnwK3n|{}Khd4PoWH9;VdbAQUQ13rmdxWg%{99OgzX@xYDiBbg>;0uYc_&qGXQ zbqq9yP)lY zIp$XY2!KN5ZRB@nxZ#=4NlUXlrWdN-U8*&|HRR+a41Q9A$3e0e!^fV~$ixl*jL6q0 zkan~dhDzyS-GG0r3NWVf2iOoK-60svdw^C9q!&IB{y}!2Fm(hT@#xO=YpSY;fPnZ? zfw&U>SMcRO4Up-z9FA}x5}$3NY|LZ$z7z=`SgEHSzsz1j3W;N49Pf%ZEer#;X?o!Fyz{$aSnTA zL;P=gHUqiMuW~ODfcJ+3|DFS`g{XER!wn&3c?brRS=u$doS9B19EtZKt_=j8{qnuV zG6^-*5f zec{27OY>!*G}P%;uAVleOhY>H-3pL4AvqkP4g@0y{v%5T6|SNi|F5~`0r3Gk6uG8? zwEF@x;AqmQ(_fz8uz)YE;DyZsHUUu;%fZbFAgSrWZc*j`EbDA$G$REcE;INr{Bp1P z&#(Zye<9>4{58?576XECUeZXpLkGJHxgz9+9{~mb2~`Eo`ikeWsh9lUuQ2I@ zuK>v^l;S$Dr^rxXEGPz3kUEJDdVXP{7LrdCipj`{4AG{9ytDhaC@<*WJx}Mi*7^Gd rNhy#zawvp>?jQMIa}_Fxqai6^im`D<*pJ^(@av|src%yz)2IIfS``{4 diff --git a/docs/build-insights/media/windows-user-account-control.png b/docs/build-insights/media/windows-user-account-control.png new file mode 100644 index 0000000000000000000000000000000000000000..59a96159289fe7a8e74a755dfc0b9df9cf7372d6 GIT binary patch literal 37212 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 Date: Tue, 20 Jan 2026 16:32:16 -0800 Subject: [PATCH 1556/1799] Renamed markdown file --- .../{build_performance_windows.md => build-performance.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/build-insights/{build_performance_windows.md => build-performance.md} (100%) diff --git a/docs/build-insights/build_performance_windows.md b/docs/build-insights/build-performance.md similarity index 100% rename from docs/build-insights/build_performance_windows.md rename to docs/build-insights/build-performance.md From d72280a8be53619a57097c0dab1f4bc24693f093 Mon Sep 17 00:00:00 2001 From: Eve Silfanus Date: Wed, 21 Jan 2026 10:24:56 -0800 Subject: [PATCH 1557/1799] Adjusted uac image --- .../media/windows-user-account-control.png | Bin 37212 -> 121314 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/docs/build-insights/media/windows-user-account-control.png b/docs/build-insights/media/windows-user-account-control.png index 59a96159289fe7a8e74a755dfc0b9df9cf7372d6..7bee87290d720d248cddfd10fa160fb8a6ae3c65 100644 GIT binary patch literal 121314 zcmd3OWmHvL^zWgOMhWQ@kXDhDZbd?oMmi-Wr5mI%P^3WtrKLq$1f`|Bluqe>b9?{q zeShP9d3Sin)hp-hefC;w&R@;*TwPU>5RV!Ug+dW3E6F`Tq0lSgUn5*>_&(30qYhDb@4%2PFmCR z@mi{fk7nywoBv{p{jxX{)&nKRkjq{PY>e_h_YP0htn59;$Ky0!j5J)s z<*YlfL|+bNWo5dwZ1J*d$Yn~>-BMUr5KB%zwK)Au$z3h=IN2)gnL@i{|9k6B!Yu($ zDHKZH*$;*5bZ+E)E`7do)r(v4zW4Rvse_cV-sSvDFf@e}&g)3B&5vGA6oo&F@J z(`yY?2m0RAwZ8`Eg;S=lWaj0__vyy;+6n{|NM$rvV&plkALca(7GVUs%r;l9p58PW zU!cTFO?14y{=93yKG$`>_T7$1V$1C5?WIoH4P*HiXm7MBwdaH4XE#%BYz* zRG%@vxbVQFtW0eQU2pw8hpR9BdSa1_O-!^tdwRfiue!+TMse$`lb<1P4#(O`g{Wvz z_OyWr@-Fw#a!V=%WCIA$f*vyGeY5vQk8#i6y(kLT*dDi-P$5nqzU{YsRIN0;bh+qb z+w#@SNtGp)kxvbe@b&Lnq4({5N~N0~-Q1{-cM+!TPEW=seMOhr-{-jQ%(UnvyrE7O z`kGxnktrf;mB}z@{|(*i`}Y{w(xAdx2}s>OJr@KpT$J&v2Cm02hbyqTN=yxf(}$nG%$(rzrX zZrN9rq@H5!CM4H+(8u!Sl!~0$j%rx(tKHUyk=hHPFBKM1V z@>Dpb0h?0a=keOAvv3hdWdB*CLsgS$Y1XKR>_ke zpE0_=TaK)|d!8IhW%rdl!3{!bkf3IRf83FFQgt@y{BGpiwJ(7@ zxX>pwy;F;(&ZWg|v(+uje#W7yxxtegQmU#%X`X+TQ|=@YOOwpZ&Z5PzO0PZD)iy4D ztD*lesw-K@?9b2F96Z-e+R84{i-frJ?%iVSP?-|V?Hk|!Yfq`6!S~C>Vj`5c@;INV zG0Epn4KH>xU*(AVoXD@ReT76?qHve%zv|Uzoc!pllU~Y^261G4{CMeL+Fw%8ZY;u2 z*>`*FNpYs*bUleu`X>%m!{wEFMqJhYd|7v?L<<2Sq4`?JhL*qNT#QQ06cb)F8+8Yd z2UF2BE@MW#STZnS!?Vh!t-gz;{Up&={L8V<@aB0W1Dt}Q7;X{x*av}C8Y$B>oLY3B z32G;af|~-Y(w||ogb~SVS+Z@^Zc3P2S~lC2Hf}gI4vgW+Cywhl{sTt>uA{(rs4ZNNLBqA8E{yzc88lZ?hO>NUg7Rpx%dyD+;?Z*FQ=R~QJ3jgb zA0=lAit(bx!Y^?7ssMcL?hnz7xbYTL)XG6!4zg};x6hAyLJyBdZtSj)Q}TU1WIo)N{MRyko2yI;>s{_c+0FS)^KIZ9uzFncycUy`n07X9$GH#qQ-WO z?D*F&V-)FqF+YC%STeru&{4*S60D`0E;NjKl&{rfTVc8}QFC}QeL=)vWaM#^Oy*hk zqduLkfHf3ZlJ9_6T&j4&`Mtfanw}=-;-j8G_DMc@@#q;R;eTt)l$S*=g(g6K$+C

7qCs5oR<%;4i{D~nOz6;L_|CoA>py1UqTL^2 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 z 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 z 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 Z?RfMJA|yu@z8r%;syA;deNi-h@jsL%VjTbg literal 37212 zcmeFZWmHw|_cppo6$C_7R7yZfN+mWO0)oUTfX!UiUrcHLvTMD_BKImW1dk5ekJOxhE(6 z0ENQMfj^R`3E`7hTe6qne>jd0WbdGgdZ}07ANXdHijpW)X*ltrF#-JhjJ=$;BML>@ zg8ad0v&(scLPc!ela^F}X0Sf}+~dN?k@&GDt{>48eU)<;%g*P@Rp{Et1*hXnmdi}^ zWE;Fu=k?OjInTPNSxA4!eT%|5xbi5C#CNnROPZp-;+{Y6>0ws$M?wA`mMZMc_$9e< zH7^tO&VS!M_58cAqp7KD`ND1Av8~OZ+hfUsj^DeV_a+Hayk~vo=TlU~MJ?)nAzLZ= zd`1xRSbeVLQP z+GF|mFoq0PA`Ax8KQiJ^!J;HF979ScMonqxaVy~L6~CNsZQ<+(JL^(rW-KTpG{{$o7`{9RkfFf0L|!}N-&?Mz;LEyWho5ca^LO^=EG;aWhjZ0N z<|Za|K7IbY`hDe$$0ucE66p7iyt-4x4bis8hkF5(+3vXi#!GbHi$1TaYV>z&Zpz1h z1L5fSJMc%3ACqt^Z9j?V{P(d!JVExnKWlmQ!Sfq(CjTx-*zBkFuG&xi-Z%OLz-GBtw&tWvg z;cYLbru2qKMmj=%*YZruGBBjeEiNw73knLRe^oyxY3bl_8;iv*bQqVeXDi9{k55e8 zP#!$vDkgk`n_Je!g&*}{(cxWI*4-3;UJ+Wdt5>fwh>iOD`@@3J42+738u8ZD)Wq|p zaGd+-zxt=qCF|gFZt3H;JOX&Gs@~-`B&)SX>l2kIRQ2TR@83@#OmLb7RpYLn z9vLq$F>2CNL_|a-j!Ve;$n!2NEM#S4Yp!lOvT+*_b7nq}la_X>GV+;F*3r>X(bp$| zGZhqYpgw$lO|>|la|%v*rM0!yUV!@9VvMH!tmkgLSXG>$W7f(uSWBzAW;Q+(gM)rB z3ze^zGVeu2#Kf44e=e!7r=|^;9b+!7uh&Z<>91Fr-#v&-Or%m3{^Gngii6r{*fmf{ z6{8^y#DlZb&$?_K9IecyQiBEY)JN6^nJyf8KR3idnm=vLHWSN<-sqg6Sji zLQ9uc_d>1rAzIwH;nPuX-VD1rIy#bATq~A6n^-s*YJT!SODpKlpJ#3katz!S)kEJl zwW_F!^7C81NYp)wl&#q7w-$8s?%q+YoB90tF5l5&Y+?a6NP7aNbbLVjO4|OBS7v5r zT20O6+}zyut}ZD{%Nu$5`I~EoCpsxKwY9bFy}fs3WlzC#jfjm63=1QDVrIsOMr)?% zZ?`jsBL{YLbhLMON3)!I_}~F9s%G)6?pG(F$b%TBU_|^#_WAj5ou3PkA1Bk^2kI4 zGhtE{l7%iJPqc0tZmwm%H3UMV@8O}xGZEUZw4eR&q~z}3{}@IiTw*@Jz+q5-85NP5 zN|xG}ov1mJYIN{yxu3o}5luE(Z6^z3H0?_%RI;+RmVWTy&BUn2g4t6%7|ctU*q#X_ zI4%`<+_UUS;A`*bkW^KTy!wa!Tm}6vm-uT2Nt^BsT9uYDwgv-aS~4;O=P4*gEMN!v zx6GkX_1I4K>7tm)dN-c$y~+6pinn^#T{80W?i=9u*Gojj#|JaXzg^zRC@NB_el3YGeTDIBUyM!=loZ*qc=)ZoA`rxT#n` zfpXcHvM_&e&YG^(ord(39#`y2>G>5FI(Bn|PM+uVb{vLpU|&!PvRkQ;(Tbc#UB30` zrEUGt3NJo>pUBo()Yo8^l>XPQLdlks{o*HkeHaT=|G)rFYMFnwn(NTjhd?B;>Fb;d|BD=d#C+&?M5hSii;y!uw09&Jq3qI}52{z&kcEs)X(;m0lb+XvMfJ150*XrHgJ z2xytRIUN1Dtu4PYozC-jq^(YkkdTl<_z1>%t$%7Nw7XkD%AN=XyFpG#={vC-k6XLJL4sx76-THGkBRw4#b<=a-X}aPR z?K9NrVe?Mu!qs}Wt%ZApc8ztHlXFMK9ld}5z9Z!2S-pY+z1s7qhkuwnd9r-`DTEW|GfOg$<}4Mz z0z!eur-H*h7&cjElwzPr>d-jhgc zFoY#+X=$mVs)`fX;tPxBGVOSs9v6pRO+U78mE6vikDouiw)P4NdB&@&mMy8*gf?R# zo5<6eC9VMX+=A`kqwBU+xU=4(>=4apDRe>D{9yrRUkW?KPA;`pABU+|0!6)NYtT!g6dNv z5?ml1WqDUtR{C`C2Vc{xH@X=5tin)Lm7KTc&Ncl{UD_HrNjW{0_sz<8V(scT14Qx+ z0bu0m`yBnw7AJ|P)kzO-Bj&EZri{x=rwcjC(qL6Ny)M@*)l(xS^ZayTu-DR2g`i(Sr>8Twf)!EJ-nXKs@}o1B4g1~{(VtdD26O6V_^F;ddk*M@8Y`Pb745zveJ(q=wXjF?sXm z4U*@J$MT;mhp=Q79`z{5iU%lDUi!zu<+ zG(=A%$)u+`>as%7VS4sz+$sBBr8F%No58;KjbEnegc4|>di4f^xN$NZEc#3#)v z5*6|qElqXx9KKiS$yq}y(x#@&mR44Zc<+Avu-;x|Ee(A}et)BDXvHZ#FOP_TfWR_M z2WF*dHXOp;-)9^e{?c5{{b$2&XVh8K-lQ|JT_(%LxB2)kQt?|$z}Wy|W9%T)Yn43- zwx!wJ+{`H`kTx)&owBW_r&)+~_Yk9d_3G8I*KL`r&l(KilyO<*Lo1&GNT`N;zvV+B zFMb-|5bBckmP6YQt_kq|nz(qAF1J|lH$8Rr%$>ArgVMt{E?u~AO;}jBI!T-M!qLE` zix;>5c%^iRG1yPZ&<=d}-n__B>*)PA0<6boB7lB*>dD&Gzm?pdJw@p(Ys$2Me25AcFJ1(^)Lful{&n+NiQAT`8-F?uK*X*LcWJxASi;7} zUMk&c+Zfro_DDu7Yguq(FP*dw9=}8kA1|*FWc&8c&iQ*Xcy|HNz$*N=hd7kOzI^XV z1P~sQnR%T{)MvVoKX;-IR+cNGrY&5D9a6uPrPsA>h^A+&qFMIkMJqDIFj%pib;{p|)*} z6yi3d*mz=Uii-kF16$%86%~8m-J>Vd7-s|)LPQe@&gmN$lhCiRe>Z10lJ_ttFYk_x zO`*;g3*?6Ou!~r8s5N8(-2m2ul=0{53$loWgd2T#r18(bMDfLa`J(m5Lk#v90Hfus zi&k?FnGXSq!V;k1EykD61{^MhL4e54 zjd#hKwrlV8+rHRl6}t!)BAM9z#mc(lo$tE`Ba}RFc;@j8gmU-A-H#)KgSdbM1*)Jp zC5ks&s3`9wzRAYuw_fbh2vwU~+541U$N4ymT^<-dlq!;SuZdh}JEZr!EaD?00c8fh zeS66*(zaaa^CQDM@BQnO;${J(m6WJduQP}T>SVikKIU73nm=TJKBGR_?9HW#M%%5e zE$5+ngJN4J?E-*G&=<5>_s*fUz~1fY%0B>$XRAom;T25Av(3 zG|-2isqB^mDl69RDJhLALh<0(Uy%oNijtC2b$I#g&p_CRE-qEZ;x}&GxQSFxl9kiH zM+DzJgn|+F#CB^a6m!lxva*5u&uPQ6`>-W&Oy5!qq{Y%ltwb%Q>&wgii&x5huvD{u z0&Jg6R@q>TIRy>7_6#EM5)*AP_s~RijSXfxb%0ZHbTfJp9$}z;d5(W<) zD$BUW?uYvNuK|!5tq$i(+S$L@JSBG7$T_sN@ma%+ZE6b?h%g^_fCRFgl<~T>_Cv{w zi<`R*MnS?Y_G&!|vNf!u4Bag5LhbU;SdqJAH04GRi^|H%AknI-s=hn$tmUw^wid~7 zsH-kwxeZAzkk(zUnj2^%Ws%L7wqoz#iTCuGE-5Hms~HOC;|@c;ETyYnPAml>Ebbm4S0Du>*_|Y)hE{fS6NI%f_o?K8zP?T3 zHNIQ7R9!!;H>>Eo}vE!a}`yE*+JhhF!ye6*apVyJwg`~ujhLVe)(eFp6Kx5 zM!U&4XZ2J%)dq1ODa}VHD$Y)F2uJBO^dzDgg@uI+JZ?SublOc_4#*oQxvTb@eN^Ca zw2fPQhWf*Of%G>EHcZ*=#88Pcl0@SRWoc=>A!##l?Zbeu% z^#s`nMLE=QCqKlwfztCn+QzcdG|k%S_&_vF&&^SgHpaO_hEi7{P4;*xYHs`tFQKCgJuRG`f$_d!E+-?)ZK>=dbI7v=Q3I#AX zJUW_QS$R>|bwe6z`#DqQsW!Vvof0G8xp}54Me1+=3Z9kk9lgDyi;wqA$8Y>PX%j!D z4=<}HA98W{=}?Oq5mi%OtcAUh29*d`th^#@_VX=5Eu!Jw3yX`nCzte9gKhE)3uT}t z(Bq<Zo8G0G8Pc^#V+|j15Sd0jL=uF>5`$ct2r&em<>-0F%$~E4_j>ME?H$ zvtttYVd1B_czAeTyqz@tS@L^yTe=D`y1F^8EfiCl25zmq0x{vf0_e&;?LV(L+xFDz&J}zy|#b_Gb(u-I$Vx%6*Rvsfk z4!57g93Ek|wux?lMY^zcTkuyyn>|tQ-DHQZ``;8==26V`%{R!^kQNL$zqP*6$%U*bZG9T zl@JHA@*-21)c`!Eq@=H{SiVmS*Z#L8iL^a=I1ac%6&;;d!^7&^Uj&ntGPAO-S{Cu! zPUTQ-+)G5;@#DXN<+oZD{5T1ANN4B$78y;_%L`o5-L{|Lk|W+$Teah_<6I`Yxf(rN z;YP~J9wa zJ-x%nj~|!X&)t#gXV9e88hFdc&^P5e>j~xjt*I{}2S3U&#_SW0(urhHT4yE}XJp_3 zTQKx`4fZ!&yCt8 zrxsX2S*K`yyIBpdF`oGa<-nZut>?(IREG3JpbKF<;Km88g~XYM^!C2d-kPL72QT!x zYD{lseS!Qy7Hu0cdQ@t^Og6pPAwsn-28`)z%G(dB4yQdMmbbSt65#>M_x^a zB=dS)n*CI__9CaE+0>j`JUjBbwJXdcZMBMmNdpgiKfIF)bZYS%TKSqU*1&Zks;70s`Ym3VY2M&vuCKm`rZJxDlch0^@Bxe+6SN-^*2t-cS z#^=#>7phJ|PQWLuls!c+BDLzDm0H9ziQ7njy=v@YkodlIT+sxgDeaSBTuY1gxhVXsnz4spXjKJbWlU>F%`)9JBAh#k>C?qaS95Q zh8&BqFwif>q+Cy>a`5E}dHtG1$BI>4Fw*W*Mfh&Ea%$1R*&Mw~?TR>eXfkFPW_hjR z2~JNloeD*`#l9sT{N*D_F)vfdbtXQjDE>b;&vcr=daM??FWbl#zVP|l`H2bdI9?MT zMl?^<7&%+MgE&9`=(!7BV-Gn6IiKIJS$qt#L6JyrcQ>zIOXb3EVi(0XeUpFh+DzZ) z>JM9W((?-;As1^u|7;->A0`Q8L{e#boapzlQClHuQYq6YVmZ)3OiU?BgfHwkNT!MU zR#KW3k6G22TUaSnQbJ@hj?>ftSOy6y4GI>(ua>c_(#_Q-)6Q5{-PJzFJ6(YI z;4#AT1;$+(1~oyTU>L!D%|VTv9sBfnN&F=Dcyh&wuz`GN)M(0O(gvfWx_9?SVfD;| z6Pk@%t0WWGCPF8hsfsAN zV!?4~_T;$QR_oHL>8FCw*kaBG$=*IJNql^Maib2}dNi8pd~>I#phUxuvM#3qRQ_d}OZ+_BN zhNBnS4jk+)nFrU!9TtLYYsA|LYWYiDYY5E_J_Ql0UmgoWK<$jW#oz2q=Py2A(4hFdGorA#k$F zF19_P!NiXiLjC$j1DUKzkHw$POHY@0G@iw8cq%&H=vnt}Pxd;urt>MhVKHX$OD{Uk zkO$+PB5luLU}*Z4>DkSVwkFdkoYjv^y4j%UHT=GiW^^a z+2fLpP@p2_N~s9OD3)F>uRZW0*6Lc#YT+uFkR!tGgizhG*?j<+eYI6z*NVmV6X-uq zZq?$L*j4#-Pji3-i*Dn<3<7GqtCzUCwFeW%Y3D~x8fXzQMa9*0=-@Vdg^I^CRHX9~ zLqlX`$P6Z>-KO7o@IYPwh^e}5Ggq^RJ~!z4Rn~p)=;&tD^^Z{{2SQr`K^+7O!@` z%j*i?u>DlQms@1(!p)}wi4ADbb95fRaG(?b702xAO_%DH=lJec{i7O!ywksfZF|N3 ze8m&lU(UcRy1%M#Fxzj}HlS0$8XMl6B#qZAXFp})GNwC5kv(LwJRtdda)JhE-0A)D zx^iZT?LChGi66qVdttU(UespJyBtxI9ZB~J3#Psv^`K{^p}Z<${x$Rb=SUA@J3+;i zSAXc#%8lHA=XO&rKz5^ST{SUA_9Tb8Uh@yTqI<$EJvJQ1igy#m@JxA9ocdGnwAF zMB?cKoPhKn1St{F+iGWXSXfvD_mz$m5A40^U+l&8=`KSovGmgy^F(v?Mj1ni@b*kq zn8gKukML|Sf_dQ41AKoS2!7RqlbWv6y2h1iWe=I4in zs=}54k|7e!Q!6{43hYHGu=?Kv>AZ5*7-YPna|@qB;Xk5Z(?hH2@vHe1#&|D4MxL~$ z_u`SWQu|(e-aUE4i#1qcMbxj4#N5jPCIABh&?k!`#8Der73fC}6YY6bttzU|F=W=$t{P^-NUpvAObNjJ#GaCm-g|+hV*d2nv$kQ6; zH#0y@5|cxZ)N3)_NXt zjz6(=#`#4>{Lv&j08%maKkNk*woW7lU_0zFHHUqOP3I`IkK9* zh)GpWybv`sXa9BFEVc417GxO`Pl4V9K4LiA7m)l`S630%YXL4PcCsAy zYsmd}ZGgHiF-6`QYpsu!xw*t&k(ds?rvljy%4%Rzt_ZOi0N{A1afR7+3MK&aTdUlZ z1oTOpobA;!rt2!kWr`7&day-?_X;twZ|DrgcfLHv_+*rpl0%{l;9Zw@c)X8Da+Y(( z&Zi;le3WCTE1;w?)^CvoseMpr3lz$#LodTw`ddS z)^i@9LcG=g*j`ya;dxtlwvw-Cfx8`l7dSiG02 zdGzR!Qw!)Yc?tXuGeNIk^LdCC0{?dJ-aWYg*Y1tLA`;Sux0Mt^zJEJrA-tNu77R4B znzHD7VdcccM3M#+egC0MQAY}&)g@pzofkd+(T0dl0L3m+_g07M%T!iX-N3dVU*8=W zp+Q*hS_hMMg(kPH@3v$6HF{jpF){I@5z-9o>|MW}_5U+9pnF3BIPqGXW)c(}FH?2; zr>`=F^TQn33ngRfz5=H+^!28mv$Jy+r9u8SGZWL5iL1{W3<`8A@1vD&CK_Jq_3D_s z!XZk|>QPDX5R%f|$5#@CuRP`kCu$wd+7GRn(daRI$#Y1i3wh+}sZ>!>ahcXL@oC+3 z09D55sK&ItfCWvj$Z2cM`}glx`%ysk_VMG#w8}*6PhxE2HMxlk7cOY=`!9!WEC{;Q z6%H!4x3~8be8nF73xzMt5;G0&#GR=;@k`oWu<`FW?(EWfiZ2#reMzBn?1TN-ic6iU zj?Pt8H+ro_(RZ1dpCbB1X_d7mvoCf$9eOh)*K4MOz4fNcrBG#SXL0*efdT^lrcNLH z^#C~?T!xD7O2Xmz>vb!YmN|#oVLQ`6M+d~B1%=~n-kVkPK<8*{Um5WK^6Iec0!CHp z4HR97ilP`4Q(rG4^?mFWnTMgkW!1ERMANx9b%}Q(uBvK@oF^F#TY9DpkvI=XrPhrd_&BV`yB@~rb)a0*;8prrMwQ7G?V!Fc=CqUljV%?0KMw2#j>+X zJ>WCBYPn;=@ZrqTKBa=Sb-~=r*rs0j%Pwk$3l9wLaasjiL>;I~}` z2x-R74i#8)wC6v%We}H7opTrBNU}a^Mu(7ex@|OfZ2XZdZT=aE< zoS>jQQzx;`wfE^wU}ZOLa3{B}MesKcSG8{rweFrxA0I+B428<{jvzHD@N+?RX-|cc z;h<)4PB^y>Ejnl$NF3}Z$tfzz0A+2F!VcGY_;BRP$=&PHz941#!gZwVuML&}-}CU{ zL*qrdy+xLn%l3w(2Kvl4Wqs0i3$-cd=;(^Gj^K z<1@B4LPJ?R76Rmm6z4-%;JUY|2hW>0n3$Mox!patH?aE5IopAmnwXMH8hi~aJGzU2 z-Si;EKiZsc4Z!NwCG+v|WsNoZrWY5pK$s111XXFWe~Ljpo~bv{*X6ABZqSJyy|@OY z>j!CR-kUGouTuwah%_<_C6csX9WM8sI#NSwuQ)_u(rZOk(t(j}nwTRDXJ(oZJZ7rO zk9;P`G>Q!hsgx8I*GqS#5QZI(1|Tfh-*R>gV-pjt{*XEe=%;{QNuJDpIc>)m;n5%# z0+|)i$QH|~JDOp)1PU@aiPKq?1D_q;2^}{#H_^dOe)w!){3VVhUH{G|>;B99oSf77 z-iVDb-I3%#@~^8+*O=u0Xv6z2G%fHtKusEm_^!MG%Y(?{^p+}U(P#FjEJ*BN0}BC@ z(mTZHPDq7DNQ72@nmgs=|RH@C5A zJw@l?1NFPxrAcIK{MAL#Ai&OT?cD@A>N+zs14yZ`Az*`!a;oX-=2I~HSb8Onh6 zfgqwYitSBAE2F0d2h;!8FTXnpEvn{`Gu~Ye0QVRy$o5z3coN&UOia05vhIiY>s|<&%d)8E85VnW z6g9M{P^}Ev8*Qzevt3zHvHV^6{{1&*s@jWf@RR|e_>X*7o@q2fa_rWnOP4y!wR(qO zZwT+gux!!EY(#84uf-c7&Nq#^Pz{v;1t~>KiY9~2 zH?-KoIpnu@Fndx&)wq(C=+q)Dtzk`*W($l$8F3V>5f~jK3(F}$0$G$~oFD?g>^SS+ zf%W)L|ImY#xB7O#65Lz=n<}#aLbMUcc~G)iwiEktpwW~D#bYJmz!n2H?%Ve5%#~pT zQ^0cItLM0magXP-(x|S^FDdDFNR?G%_)sr#=1qA~{3VQGW z`|$Q(Few&RlVDqld8RBx(w(-$+<(Au?Bg<;jP}#`LhY76u4G&H4gG zo5+MZEI2Uvft&PyBoDl6Aix3F-JU@L*RcnuR7b}1*EQN_%qG)TZi>DM;YEr3`hbU- zgX(O$ zV$Idy2;)Ku-`jUcAAoIC)nQy8+FQPYSPHS7C~9^_Lf_>ZegB6FfxuUo$fhd zP^?_z;@}AVll3yFSG4M^3Me8Z%`dtZ??_4_Me?w%f^^RV`1|~~Z_Zm*;GROHJIKy( z#Z@6`S1ui8vAs+YB7_vtDFM0)arc0}0ii&~%8DHl?vtFw+q&Ub$dgP>P4gyWpy6Vd^k8@(_O-e88ScLg^)^e+bT&Ydkz^v4Njnza06wlSQQXIupc3 zh+p9MbPBI(;qyK|j5y%xm9cr9V3TAtM zFnUF4Cb2P#U9nWQDhncdDk^EC8)681{j~(BAy_P{C9G6dR#wPuf|iksq|Fy^gy2OCZlzzcVrrG3QlQK8%#zVS$|t0i}fiHq^>@3PkxK@X*&!rZ)op2{GxO z-2#u(XO)8*@cgzUdjaZ(We9PXV^&M?{{2Dy3vfA-tuQ`|Z=i)ddDcA!{&ekf)0NNh zJuD|#lk0au0x~|3c^yI>_YlMq+#1k~LAT6V`Drhp0))C2or0wts3gN7{a`2n8>*gj z!lCdTd3j=}MHI&9iXhHRw_;$lXnpw^F0D*_F-H6K!H{!Pg(<#VT&fgY( z^G?#mB_VbMO^OtV^hAnV1o`W4!tFrSC?b5wRo7jmopMUji|mp~W)fXtukxM;0N2uY zgxXykeFT&I3=Hg5`I7q8w#h~Ij?UmEegn_HOxX~1trciB&@Cc+}cwZ zI~A4C{F(}#cXAB21*f5c3B1prKkF1Vq3eGS%46n0B}>c_$F-<(-?p5t0cTwhZH$?T z$x1*W?UohY32Y@WO6#NbC$q?WjrutZ86yH09J7VPEuIgSnRF@OrEO@{xfI$8aC7%z zzq|*%rk9Rq;;gR*9&Q_SQMkWc#~lWxXZja#n@%l}L>h7ih?JQ_TWT}O z?-t!$-MG!^7Ja|5qjUAlrAIfXEh~3WUI!v5IiH#U z1!*8-y35S-5Njg6eU!w1GgEB>wT%^-eR`L#@F_iL&1w(d^1_TJU*z{5vh)2!}&q&~S1+bUgL#&U|!STuxnyvy;;`$h43W zAJ!GGtV!HE7OkG7(eSaKb{<;^07}7o6->5>NMp5UH`D#!R%@iqhO;$p_Kr`y;Jdew%{mh zX|z09xZS+UtX5}GJ!vCH#*n^&+}E1z996Ii7B2M*$O@D%4(P z_uONyzamJI;<=+OwROfEQw(lwsCvn5_3{4+K=@yvL4zCLjwUyV0&IGm$FyiQWXG#eu#(os74hkv& z(x(#7hAz+H9CM9ckyowO?6M09kV z%j_^DmuDUmlplL^9TdmohgZ8iO<%QrK&Ta4kDQ&D<-1=w#NWi=u?yKi(GqY-{iBbg zeR#)ha$w-yP9TT)My%Bk<3(Fq((ePZbbLQ_OT_aNj_Q6k>aP1KdkINM59?PEt1Nz% z;reorF#B`NSqchF6>aTcNXulw!NEuStnywST-CWe6nPn5f=AEuOu?M^=zDj3JGea+ z6-jR39t{#X2v^VCMDzmtlH(hd3;fv{l*{(*zS%VqR)!w%472v`+ghHpP3UOTQwrQT zjb`1ja46IVgxmg@GOw_ZI;X2m@citb&uFKXbTeX`50{j-NZ7&pH9*qUaOR~{V>3~V z(%kta*Aka)Y3aE#SWd3_<)A%J+Z#sJB_#;E7FqoAp~ZY~4m{LfL;M6K1wceRIk+cy z)I#EiVZU{2;Fmws9zjG3;B=DpTZYf(2;e*K-?#o6b-J#PcSb2&ZEOKN&>#Etzf8N% z79Q)a1yI@clc0HdUn=nI#U&ERVqYtj6sL7q3}_-jWb(@DcW2;UftTG|EVTEVQ9%$0 z+70Z$goj>DT+_Xodv_7^$6PkN&>?dZ+ZFB5M+2r`qdL^X4QwWWBB*!YQiiEeE~l7Y zd^tKYvc1=;OB$V!n8+zS0KvN=DT^uF+sn(VUq>C>8Ezg>9QkpvujMAh8oAxs2geEr_#J_cSjO5znGLolC4C-L_E4})$fYZ9`#L)ZleqybS_;;I6$!du z`hMS4M_RN}Yrw)rCFZRlJxo(|FwDjwcI!&0)IPPDzW#C_fn`UkX+eb80Z<=QqXd0m z(5M>!Q6B6t`>t7x{YtObA4M?|D;a##cVbV!O#h~=pmFR6kdv(jVP8l!I@f4j)t&b6By76+gUM$Ix_EPEvlF!znb8oG5OjA2AE|ihbccK~6 zjjT0ay!t=`%@}N#xD7azZ!ZF7PBz`G0Qvv2<@6KqeFRWm-v_(EC(wz`I~;%+=RT*{ ziyIUx++&$KPXV#Bu?^@yTk1(P%UQhj4aN;!oKNk6uQe~RiJ>b6)B~g(^YU#S@Szpg zWABF(WZ%p+kwS}6Bb0#kLAsIvey^f;BDRWim( zM%!<(kVjt8CCoXk#|s@}s=B%%2=uz-1r#RY!U9=wt~ESm!AVH<;X{95S*KmV?hh0B z2s%wfUFL$Nfp^Ty%Tob&kz6(yRe-&H2bEgE-$p;^U;Q$c8EiB#JOnDAo&mut zI3eLGe3zbwXUM+vzLL^iC?-T%P)zSR4bCTSgHXjpeq%7m(uX%_%_0P(1^wW=rmdRMkN(7PLsspYk8}au z*EJMEi47#BY9GB#$*R4;@F7^hh=KLEE!tx%fvHn`2h1;FPs`kbuZl?l)HhJr!I18Z z`W5TdKF|*YBGLCRO>Y3Vw{&}QH0?p(mb_v4 zQvvF;N(aF}5yFFcp$4=ZiZEyCTy0-pir0eNT-3oXNp-_@;P7gFa8|V?Htu&QfKRlj zNf95zk=|GhQqMHi3|H)0sKI$g1_q(Yn-Vl%0hA)#7W5hHoMKZ(ubpxRBGaROR#sX( z0YV1^H{N>d^S0IZkf9JYUg!JJ!7b{~sAU*1yydrDz5<;*;Rn#I+Ur~(N%H~FEEH*% zTuxrk{Wg&kEe5wJEdjpY5KGFlJG9U+;MDt=WK}yI!V2`F04WqWx0N(z=q(EJ(QD|N z{-wC-1^%30Q;vPPiX2c^M!tRfId&MhP>%m`$j>o)0Uyaw_W$Vq{V!<8f9=2j#R*hj zrL$t?kWr-{fBe@H@c*UZ{nz*RU!UOb1hpS$vJ!>SiTgsY`n&RSVj}BGH}c?DuRcQe z_sxZRq-FhddPW8`i!=4zMM!Nh^@r1mhrN9(`e#g5@lQbmO)`s8d-+*`7rnw{l==%2 zNnHf7?3Y>s^n<{g(p3)RHF+cu;eedyGqS=5em~_&&p1VYW5S^DoDeCkWZlU*=(Y@q zWTd$)ie+$eah@yRA*B}bz^63)@hOP7?-c6C-V<>l;X3=~{w@2CR!aJvSMs-xUv=Gb z|IJkM)sOg`O}QuR8-_BxNrIeI&(VNs&gYvyM~`YA9X?AE|Ls&VCMsGkZ)&x->pfAr zG@F|K?W=0d=hu>YKTHI?=C3F0R?H7o;l-U3zC;=BB!ScaYle$j`005{Qc*HW5^=H& z>K6OWoRD+EUer+EYlR>^-%mb{;;b&l>IcwE^+{FptE!$jejctgA9b65!lINU5?oZI zcG-Q#?ecA>o6%}SVW|SaQOU`dg%(84((;}r^5G7nX#=0y{>1m`t3TPeGW){sll&a+AN*8XUR}L2ma8VYKSiwHE>_KJ(YnJ`ASNO>YB-tc$PgI@zh)8;2X)I6$A#0Bg>kbQMh%>1G!qsr@R zZj``#{99o2=LcR3QOjS!CzKuxH-EC(sJO32U-d{K!q1pLNls2)Uj6Z@BZ}qe{K6S0 z7ngbUF*ekPpt#GSAr0qwOlQJMV-5U59^L(VUy}o_&sFmkw{#C#Ru_yWQQI%bPW(lC z=)OgHKJOphxngua%@VCoTYMC?qQZP6`8!Y5x2C-3y#RzowhY%U4Wr}Owq zNdn0F%_uLYfDxd4Lbx2}<)fJCIlqa8(z#yw+jO6P&ideLEpA$QJ~4|@iu#MD#(iO~ z<1jk1edzSN)iMh&ZFqMe3@=!Klf5Hs`#Yv28$5NM7lb4q{V5HCUeU8}CRmM4xEp%e zcdJjF4!B1|qu{r>T2wPnboR<^X@iT%BOf33AyR33O%;eJD$oPBzP?@qevVsD+ECyJsOMlyl@m&ZCIyc^ z;%P^A7`(IsM$ITBbd~XL=m!|`)5AYcdHMKoP(^hcLI9BGR`ZMRDkz+7nn7;3GczGFo51XbLu%J^88=b6Kmdgs0rYbR(g?eJ1(V%J zSUk5(IxpyfW3Oi6jr_t0GBc5iXLC^7%L5q#4hyHb8vi^}NP^A?ctt@FIpfV|zl@T+ zkN4sPo-%w6y^_)E{pXkQkC_H4@Y$GKT7Jw?%|JQ=L$B}%S+*DVO-mi9E z({Q`Q@G4?w3j0h1`-CAqXuK-pcvt+8Qp|S3zu|epz|OcA>cjh3gI88XwS<76q<{qm zdwSUJtT!FF_3t=2@xuCV{4-BXE%HodZ1Wg-{YdLYO{0%5&(r`hwh8_yW3WHTDJugU z`B-Ayf>Ja)nV$t4?z7(mvIE1zFX4qF%R;M^(v%wMJl>luql->qpE5h5ZtWibyykMa zXl5gO1Z`5SV7V$F<<`es2p8RnvrRchZU-=JPK$1pb#sNqkki&V)h8ADf8ImaKhk)T z9K`ydsz7pG$eD;mxUPSE#9u8TZQ$qbH?U=XsPK2k-2- zP>XqJ?Jj0Vu_(_&R~9nuZ#i{KEQXk^XB%lw_Q#r#S|4T+2f+F? zQb=jNCMv35-Mukghl8?fI;yg5Y@_qmLo48^nV2wL;?P1tBa`q3qionqD1_j!{{H@J z+;=bV3);mWDaPL>Ail(LI$w`5z5E5Im5TVpbf`DKm(Sbp%oSc`l*c>#9~K-Z3x^C>p@6J=W1DY1JKlXX99+Jm`0EzWQ3?Ht9~n{a&A^H41wPV40J?~3J? zRZqbbcjN21rEVDmPW$tMf8z66)aBf7pFQDU?W`o-SQ$olm z0)jRmcD3g%r$J^T=o3E?x%>JmlX7~wmO9yRn!5`ql4XVAAIoy+<%*=;%9rZF)_)Y4|khR z^wAuX4bQ8&1PFZg_uVV1tJgjw-DWw>Y^W)(gZ0&>pO`f+XDa9o_|?f?oHJzp)!fcb z*4(r!vTo-MdT@Gqmk+T@YsTTp;ga~DKi|Sj?PkS(%r?;h9lWF` zaib1itl`w+eK0xe)S^?|u#>R=v!a4`X!CZyiTT$_j59k_VNTzm$damhOlYT`6OO!! zW;Z&gPEjSu+^E#dCof2R@%ITH5`;XU?dH!yl=82Y?9_Q=y+D`+R2T*Z-g4}Krz;57 zs{w_6J%zf}c{capRRqwKF=7GhEX&TMYhBr_JMLX#BSgh%-D+^1U{*?&d7kcWOly@G z;UI}&nyL;yHmZ>onBq@-Th zdSW+kPA=saVTe{%R>*fH6H`-*sSFxD-1?7}!yw>5N5@rI2C%2ptF?dQm$+}QrnPnE zaZf^!nWp**pML@t)u~PHu&OGSxO}f-e}DJobe-$t@iLQu>WN|)6?B1qh#;%Ll=r|T zBvXq{Pkg)7fo+iF`c^SXpH0QP7}D;l;U=Ut;ksKt(eNA%%^?b77xP$fOKBXA&zMnl zhiR$@l@XhjBwg!dtYwL}e{K-rP2uZo`8-q`-bYb?IhpuE;&{^u&thSMO=q6j7;CMY zxY}*HKVi2)eT5w^6Mx&})oriCXN!KsTq^15>BBcid%eR#k~*V5U0>`t;e23_o1LL(Gzi zjV4`}rhkL_wwA@7{gZmQDLVSXdw6jMSa>j-6HPB);t#D;RvZ}b#70CI#hJnO!CGFB zQH_RF%=+}{(*WnVqxknA^V%=uZHX-No#dM^%CrMf9_-VS zeI9nHh1;V*c`HmoxoT|KbG+clF}N5l(HJu{waSgC)O8o5);{iUuaR^W8#Wmjg!bYz z%fIltb}DDLx4{rvBsGxMQay(brp^d@DMAJNS6-)87C(;u_%v!D-70fmmD7% zyjpf!YimbT9ZgyQ=1;JAIq|FWrfH@-W*Yqgx^h-03rA7hT&BK3B4iw4;rxZ=<>e!r z*j9M)2=vgh1%$jDZ{@x$*k5vgYvaurRd4F}X5_ALQauGFB_*%c1@ALw&S3kt4}J#k z!AvT6*JTg3uQ(+T>P04zEx$lj!c#`4dN48-%RZ+K7T=p%wiTRr65_-wv>!96BHjB# zACZDwfT-C@Z;d^v6xkVOt>|p0opLUc{f^_KR5o3! zDmMQnP7SX=8G$hu`m7i8@{1lo2hZ&%?dPOER~{G|p2~4ZV?9OXU=v>>VS%Sx`&ILT zjHbEy3uehuJ2%j zhR_F{-knc|=Uv3EMUn|Gr?A77zS^tU7kc)Im?nG9t_ zmj!V3G0+mV(iyqEHb#YetNbWByj&L5q7o#l2uKc+Qwt~(ga(ly8AO6)NfKLvq9PzUgCvyD?$A`v@Z7dj3IXtEMaza4aJ#}*rtbY}sj zeOjv`dl=VnOp93{Dte`|qQY=EQERs}>~y+y&KqVn7jAZqtB+Wc1WZAc&G8%I{Oc#H&d81HtMyZaPiG{ICL~flz6R$vL&Y#va@6fjmxD)%SnqE# z`|1q2t;V=`QW!Xk!cEcU+#igX!CkoNau0C~;5)^DNR~RqG z5Eg1C0Zar<9JIe9#O4XY4+3Qkp*Gx$u{F~xe+9o%(=b$KwJ`oHz8-S5nn^Q=cC+`7 z#Z33#El0O2DJxG#$}9^f+X7=Ddq1ZF%vsNLz^C0@^;W3vw|S{XoU-r?)k?yFPi!`g zSCiK-w+K=jxg9>rkql9Pa1{FPo4F2`v2VOCCl|N(uQ!NoLL=U&2-_hDFcoH0j)p)@ z~Wp;02PF;FDA9;Tv6pM{l%_9<4Fblz?1sw6V zCW=CSGVEf}Pr3=GX1baO zlZm!P(W+E^@wh6VZ3p-@fO()G{6;zyy80&X_Kh8-3Mx;YcWkn?cJxlxu=+`~_mQ4> z#tRfy@FMiy&Ad>0l*9A)rONrZHsj-W9#xIGCpp|Rl5f}^_o=bY=zn)E?V`u1^9yc8 zRs^I7N@BY_BvT-F?foW!ES8|-BVLmt881o{G!);m_v`t81#_42;aP_XyhJMHdCRaS zUbCm;-V1_?^QK46!@(?i3*l{gf1ORxu#scEF2Ms6MO$^h(T*RVQm6Yg131Yu+83(b zZyBv$vf)#@Uqm-tel<^`5Mto>MD~DF7wzeQjw^swAWAKNoIdvQ^p(q*%lBr^m}*Qf zzlx{-!}h#JY>Acz}nU%UA!~m1)QVIzHf#6=H-5XhfT-)M$ z5F!8_uesnn4@A8J67t~0X^1-jLIarF{bcDC@)ea_Os)IUoqay}5eq9TbAXUNAecZk zVBQ5_YfwxGx2}#<)OrI!$sq||lgM1Ou%g`UHx<|W`a8aHEb%(27Sj15Yh{vj0|-cm z6892~gQ_7o9&_^eiZvyzVKIM$+rKW+sJ>*&VDEZ%Wjkh#$<%u476N|g95RSdXd)0VV?xD|x@9n#+1 zuLyXn64A}vf+Po%*Ut7d6g*%lvE|YZbq;{^X%=X^U5uV#pcHpx6vgB?Kb`((` zK_anXfUu^sAG7Su)eesT2K2p=LfXQ9kST@aXS2Hp@@_Y;yGb;i?oedtlWW3k4Oyvk zJ!q3usaH3Vm07t#_9|wg>nj84*hwT14@Z=!LxjBN}$J+`VJZx*|ZJiR|8M;TYqy5 zvq5VOTN9MWi=k81ruZIufp~lUtL$e%zVKj%PoYbFzz{-kp#)*t!P(!4W|3Ca)gtD; z>_1744SD&K60~;$qpOsQDh|y8CBHPI{}F6dZnS(YMVe*rE8D5-_1twx;8}9;YNA>R ztXKM$hJSc{)mL=+w^kKMg`fZQRmsD2k2{*>YbarxqJXYLDFK8gb6Sxf)%pH%0=82Vvz545| zBKdoCvBrb$Rabq@qJm0Kidv=@6sQTF^`L2ZE{NN-Q91Sla=R!YKU?Dh$fa&`K#;vQ z%|*J$(cjIoIDE>uT2CjbABqllgUqf(F}G}gXtybvL1`7eIcxzw49F|*9Fl?Y1f`*u z0(Z01!5qUPg1XO z=1~Y7gS1GNQ!}le|6CdgQgUU;>Xtw1>ghF2uRW{VEh{_BbpCIkqcg}?>Sfb1d~UGm z!OV5Pt6@KYAF$QjNfa@shHve4tEj4aTTpNmsyrg28*&G$&GR^DsypBa?#;4?lBdn~ zhX=q$x{^Kc@u~HW{N88}|1CP&Jua(SV~k{y9~&A>1>;-XLkY1-ufENaYiqf*<`V3Y z;7bsKFPw4dt=+w3o!Kzw(%?v6nr<_UYcKkqpG|kcTR*|-x4sFk{OA}N$76lkn3Bkh zS+{Q-t!*iGH2X2z%BJzh&!z+ts1`g;my=JiaOhlQv9_;VK0jAGrO|GsF{{xM^v<3? zI_vo$XY~{N-8O{`Vu7?&yiA6qOmNuE29dU)YbCpoea=ktMHWgpeqI0CG-i43W#r_n zn*rgQ*MObLWR%PxR>xzYho$k4bfNUSm5!Qnt{aRq_N?onPmEKu3134GxI>Ycx*_M7{oCOB2TL9VWw2*LYA6dD z!8KmBymE37uq_JLc`}C?ctee%`)5Q%EEx3Ofq}FbEXfq~$F8p*vG0ijE|@PswFWMA z)dCjy64w$fMB!jfUa8Xa!`)ni4)ZJ%?GRLFpu=o2Jgei;-`CswD3{w0iVt*4pOO+2 zd!HCzgu>SZVcElN-MVjJAV~-~@9!7N#JXo0_@@DQ=Vqe*o*AGCh=f7vPlo4+Av|C8 zLMh}J{yDp2oi?Y1=iGZ7ka#NE&MnDHr)VIk*P}cZNclyT%P*^extNX(eE%^0G`KKx z{(|1}TO>9Z4A&A3{*e$K)ndC^&ZY&4nD57y>I*rcv5C&Sa?5U&g!>s zH$zgoKifncG{@$R(OYBvu3aP7D>Sq?nM)^zyeFVML3R=dAHVJeKJe+g+wl*f+U~hn z+8Vh0B-afJwFv4OYOI%Eb0f?AJ@%qtJlwukoA|D=z{QJYvaKy!kd&PKo&|Xz+%`Ob zrQvz*5*(D5uKD@N0l%_1N##T&|7Xhy2Et;Qgzv`%^SZJnuEDy}BP6@QNIxH=nIY<< zt;!m{bGKuhI;&P%pItN;`8^fx^zI@H2vM;bI|azfKw-Y?3Re98B>4PQ&u%{iGg2!9 zq%RiV9im1#Q3hX3wOPd|a!l>xm;t~0O%F;&~E6Hr8X=;CVIinyX|1{bB z0>1bq_w`^N%a%jN(p#5}WxM~Q)yz)`{XGs2nl_~j%|jut>w^`VxY;GNNGhP?i%k0@ zko?MuU5lEY^I7=Ahr;eZ9z$#5-pf)n*m~} zFjX~|9Sq*(IW%;Ro)S9*pMTgc03X(70NK9>$D_VCQ#`NCeqE7`v~e1Tr2pw&XFj1% z6K6s?DgUEt_uumlD%ih&|IPqjAKS{SNsfXF_*?L+`X+A7P}qb2{~QXF@ITGJzZPJ- z;&K+`VrD;kM+^o-N%eb-ofYt%=C@S9ZJxPs0TE=ZS<8qt_(*-na4Vkp{SU=wh__1b zHEh78i&lX8JMj#>Xf&UJVWph`mXbR|c6;;* z>M0$&L<02%NSDxv;vxW%kbs<P$Jfs=L!ZnJNiWPAHGKT;h|L86R3{?L(ANVZJbNy+rUIkkBWY1+Ic>|n0 zXs!Ylg$A*?5E(+V!1zhK_>CJko&p35N$-)SBH}i5F`khQ7FJ#zvg2{vRI%_f+<8&QQ2zMcR4xN zwNF4A@GS;msGt-dKFrL}dj!$*V5L2~Jn7&GM7u_k5#IVG=I%mIq@hinlj?md^-&&# zc5(wh;NAXH+(p7fHgTKRvL_)!Rs_{=!^md~sXohO4_X10){MNQK-fu{t!w8;h74Pry|NFjR;)LBaj0;+cnft4z_+x$XJI#q_mvL5D1R zdU|GW_G$vO(7TyoG1wod|ML-;lKWfGf+ZIdFN3K9pX12h=N`7Vu{pB$HNU>z#7}7# z8WTpTYD!lT32a0d8?AYH5E>28Q;CMfgI0-gsv6GZ^IkSIBv*6jvSJDp44~$TLZKUWGGz@ap!Wm3E+oSoW(||HtZ?l00ZDEN zkKrn1kCpL=jSW|~D;eqOpH?r&v3Wqxg(6_f1WI%*Qu)L0;SBLWH*h=H5n{pF18|{l z_U>HQ`Sm$o3#~@UyYhBWXlV~R4VH!!OdUx(_`Sk}`n5XHz)zRFWEn_EHQ-&b(MvJ~B2w9%<1QmxtrSKTEKJ1Bah_P`yx83&KOCP@+j6 zIi}9A-^@j1K&nc7`7I3wvqojE3|=Na4#8!l$pX=Pj^xp&F}t$NZTC``GL0G0tbzs~ zluR@h&B4+S3vK*Pa@1>mGixAPHR?jkz)$-l#IOsZ{#^05Q{Q6x;Y>llmy$B^g0(@t zIy%kF#Y@cM`|I>p)Om}SQfWWBd(_~8Yy5`Gjo_fl=I>oA?7PBiN?v};r!-~QFYGKA zqc+=#qzi(Ax+tWsk3S2n-b8Xmg9hJf2VV#dp`_e53)QvP5cW|$C09fg%i4?iK{4%B zCQ2(#$mG3H68tgA1Hz7Z&kX1wRQc!hb+H(co&F_u3~z^+_^sE+Pj5?gfy&eZF>Z3p;6&h!(1k&lVveb zY*q|yK@-C;YXCvIVp?QfOiT9ak#>NWk|~xAhv2a*t>dAI5iF*CLU{-p0N%zwwgkAj z8%vViYd_abv4wk8cxB0yw}sSMxoaGP@Kr1Q3Tt7v;o;~`q<))S?LN`s4}Fx}^?&Qr zV>40XbHJ?Jm2&st$t7o3>6GtKrG!2+JWG|_@T}4hZ0}5m@WIv-c?XBG;Zeq@cek0< z<)Q6zr&HAVQial+e7R$RgPK=N%3E({VFziJoJB4+p9mLYZsq3YzDlS%sJ#_+S&NhJ z4{JUFYUx!4Cq>i?L|^#=%v?l))?U%*Z=%T})YE(Cps6P%E6 zAU}1&CQ!HJ?PKywW!AT%Xt#m#-8&JR6G|HlsxnJ&GY@w#L0Z-pit3z~3}W2p4-_sF zJ3&=aSIk3qU;E?5tKC|)1yD#wR#S!=x-s+eGV0`wPD1I1Q%(Gx6A-(CM)GKh|57E? zWEQfK)l_%9QV&e*Uer}n4IiMZFz!kvP;oxwEJIylTN3F`RmIEG@)RmXJ&5hU73DkL z-=CcwoqX)p88ho`kz~REHI3y$Zz>JG(tUd;TycC+mM&J3xt;hG#}^_NJHR1ST9-^} zS?i;I#G^iQSve~-nKkxItMOvI!7$8S$yScRYqxx zQ3e&6R%6S0XQ>pFAGe;aKW8Pn0BachajEjp4h9vvzTc6MUg+`O0Hu>t+ z!@r5Q7_3+0aR+cxhx4JFXdvW~?Pv%ME`#ihktMy6Lj(Q&-(xxlr?Cn`SaR|)Ha|$| zXix~s2S4M$*t!EysK0tLB3E#SGdpkCV`6@uuHriQMN_i|g#{+W(gTO!u~8_f@>qFa zy3W`-^k@BB%qn!;IZ>c0>7!ErDCEfwVE?1}sF>|YpRb&@OM%=>#n|{X0R5Lgr!Su- zIdw>)JpX3Ac*-y)waKDgWDlT+DupT8YT)_yI!{sYFI|DU3GzjMO)nT*u8^H^>InOQ zH0|NwY=OE_n~Tc6P@r0}KE1+0iA6&))a(;Ih+9>-ylLe(7vi~r_6fnoP8w;K3-t*~ zmf1-{k@=M}&C4_3>p6{Ra)-miNBQd;8peNa=WUS}+Y1*HYIml>`@DXPLPZ;&Yr4KQ z;z-dQu8W`G@EGMr2jfVD6-Bh8ZEo>VKdAaqi4kPBvhGX%gMpza{j~W`L+JAYbhx3i zi@=uv0${#5-^Y!>(9~oxG{72-abxKA{26A+cUw+U;S-~#A7*YkaZVm=b1~;u_wdi68>*+_^>^ zQZ_bDelRklz{p?|dcRNsQXwy$G{DG3t17pE9wJm}2-iA>D{P~IvKWqT7+lSE(Tu|8 z3{3!#Yv%Lb%N_h(z`9E>14Km*5p@MBXlL2-t-0qmESN3WU7u0a5NXO^P;4k zR)raDzf2fj#K~L=N9#VsU5{;Tk$k={9FacrKA3t1^i8R3yjgDIr}49?dVsIXyV~Z6 z**8Lc!eS20t(U)2?zdQGH5ugOlEu1#T{KjO1*XpNW^1*Dw#HRbEc?FM;%Gypw6Hi-Rtoc%pi@d!@)&#aaI{Co(#qnk4Y$3di31fv zfi*~#{5;P(`SW*psx-RxNm2NETY&`KgVUJkforoS&M%wu`j+V6fP<6LQE=iR*Dcdj z3|CyJ7%;sXRQK%JGg0~e$x{mcvJ5Iu4&{G1GrE53v}iSpNml3$(9XP^_3mAs=8+b@ zD&?4X1X1~De^hH1=xwcAWEaHD>I6U+7=$KJsQI?b$nD;tEkY{h_(vm*_8G_vFrzHX zTuK;uk78{&PBY=&FhwzuF8kd69SR~lUf#F&!7HzeWcJY3#kr!xhR#RCn$}8uKI44uJB~p zG&-;vsYgE{Pt8k49$e@X9S2bXwIm5T$QPg|X(MQpwWP_*ZDUg*zV)Fn zpg8_bHSpj96p7^*C?MD^jFSZPW4uG+*BJOT2bzOGNj!mOg9c`(ot+E6axF= zTY-t3L2V62Xg=PyqXp2BM_IAJbKNYQLudh#bcqs%3VU5x*Aal`90Qn_UO);AH`+OZ zpmV(69-p_Lcd{F+=@a|J+NwyYV>RDM!=+)MpgzEgT7|aeLbltV9nB;O_4WbFKT1A6 zGH^MhbOsy6f$DPLA)Z2c{Zm3+!FOKAxFp>aWQ+Bu+sJ-Hq^cg|T1w(^{3_m_`K<*h;w#=2N$>k-)y{6q zSmlC+&4MZ4pIBb7*Q?W!&ZVQgml)PFbNjmRT$1j77g>UD{jA#l zRrTnGzpsve8Spw0v(&vDF8cFZJzMd+B^uoy=35pl`B?sY918j7*<-Aw5f77lvdle2 ziggWbs?5&k+?1NLt{5|fo&oRR<>6zSvrm*tZrPqwl723Yu2_I5f_X0AdDzXS=Zl>J zM5rSWixGl9$7dDbvyZDNss`Z=Aki^_= zEf6-~sw^?oJDjXPJk8&6aY=f1{nqUfoPFT8fwB|o{=uJLT&hXJhVc9T))!#!X34f> zJv{`$?`tSOnvfj_FbNb;lT2lUn4euMY1&aE*E#ny!xPd6?kEIW`P=M4Gq*k#bp zpLcw=r!G3|XJ>1B7s;J(H-jKmI;-5dsI6f?#(=z?nlJMDEzCqojrvHYL>PUaJu{|t8fzbBZi3jP;CrvE=f>Hen* z_uo^6`#06^f8B(S?*{DYD(V<&?Vhy8w!Ye#o34?k_`Rm|(GIG;8&*y|P4RBiW<}%g zmMLIA4B07C=K5@Ned#3a9CI+-`QRPE!n(SmuUWEzuYiZlio=Xji zv76K*G`Z{x+f&)k(UYv5eUtDLx1MqTVrHDtKuE2>VQBq6{X#b5=JSY6pEUv>NeEOC zJv6Wss8P?Qd!wyyO-sv>($0rk|j`1I#f|52k-dY#E1 zCfhCKzd7YDtMie0T7|wfHJ)gcdiu3z&n|K^W=XyR{&g-F-_IL5t$sb+a+IB1^Wi0z z%MPFPi#Y|+@Avw`N7lZxtJhQ(OPb2CRGoX-+)3KEt?|N(d{vrL{*t zMr^O;IOMF<<0sDqme%%XM1V`LJ*teqSk88uF35%yft0rteqf_&* z`~F_9u~--dV-AeL!YFkyxHpf_JwL)n&mjb2{%`{0?PnblOb-u zR zvRZuoVgrp*_58P97>>CBYcOU7t?ks-^L=Lj_Uk=*`95_Y`w>pJy$D)U7-zNcy2`OL z=SA;QqoC$RoX@7**hai5=?3yQ0R^Ff2>Rb&sL*)}G25CNqFxH7BbBOS{W<-_>l|pM z8dBKJnxx$!E}K3tQ*Q$Am{=)D1ejUuEZx83Z(QV1R@X66zn5Br`#5XeyfIL@q@D9^ z_iBc2XbA#+olHk1m_ZG1$e#-LEm=)w^ z`W3waheLZaYv3p4ugYi6J3ZYa45D@+8ELmP)3??OF+`&>%GEoYbBTpMpjm$j(^E(Yd8qrZ7{4Bd~ljbTp(RmZ_Q!Rxc;MrTgr3hnZ>DK+X<^2 z+Yd2Qo4bGV^|4>>(gsORp8>`oFPPs$l&^hE_Z$zFCyk_N8 z9M7s9Du2$RO7lv6>bAVYKm;qNO_O38+nW{(I|I)1Rtnp~4coi!DuMmhccdvk0@bO=+p z@+0*U6kC?~={c`F*c&usn4V3dxv0C6tbu#ovKF_{Tge?8`b+Pa#`D@3O`7$G4a-p! zcMHMrp2LQHWsXml*Ffv892s5=3<-Ih&c;CYUf5AX_I>Kc!_M2J2%42@PLbx|`&R3J zc8cpZ<5+*My;c4C))kf}gPp}*={glX5C7w%buTH@_qDG?4QW-;++2%)IQqB8UeH4V zQ$*bdE=|w&QV^A>o{F)Q66d=oU8@;*{xe^Zdl$@~RkmLnS*e(BIFe1+Hs!}Ml#1ARsB)&OOkc+xcXrwrdMFb5N9JyTvnI@ zyM$kad#jW@L!onZBn}_b8TmD)^G2?F05CMq4@ZZ&XTwZAPc`2jw|Fwt_)uP&5c$2@ z5LZ&OxWmSwI$clwpSWfJr&r5Aziesb>_3rM**kUdam43s!~V;vQ^;N& zPV?!_7UsFfY*GPkm+mZuw4yQ__G9hsI^%LH61Uf@$V0(1tVv2Tce*-Y+7FdL=ycy! zGWbmy0{NZv-{sk*%&_>+3Q89*TGfy;LJT|Vx%($LGOHW+1^vBVeV=#U9snh&0>LL| zi91!>0iW9R!IN1^eW5wVH9)uh3@okrc(NyACzisuhBoE)1@yotjax3DHpl3YFj57kY)xww-*U`$-oLjk9ktAFP;8ChETW#JdY3ct8>>|E ztG|F_1ANbXE2Ve%p^#bkeq@7KEuh?n%EUiz1^hu`BnQu#1K4MX|3~5>c=}xI&(7C7 z^Bv=#TFGWUnVS<#M@c&>r)6EpAvSW{d)T8MP#Kmj$@;RNFxfa zeKTUuOjh6ORF?a8=|<4DG1fW2;p>me-9H%L)(wwmW|ZUO7;w9*T9bO$qxM}kh1w#C z%IzN?-z^ZIYFbCdoce);ZX~(&Y=_Y|o)B9hd#u?#+>eD!3c@JG2P2v(@a$~hRgdgu zKLMNNx!W}qy!`x{U;pJn7_8gB^4TNa@eXjaIKF@hI91s?KWH#JwB|w5meYG!yS=QCHD327g$r3F z%aK#Pu$iU{n`&3P(G8J4mTF?XVvp3!rUe2#I%sUwjKTw3MU zlqX`I)q_MQ!5_`D4|^C`!yn)7^tz2$&4A7p^PWX?*b8cNYk(7LXl4P3x1 zJ5Z31Y~bIPAufRioBRo`JoU4S$rB>xPANh;@fC)q0sK)6zy-AhuUkQK*dW6hl zr+8&=`)~9)j3ONQuTg}OBL5ja{y(D#d3gT+{0?sQ!c3VHULf{?3@HEa)8zest^M%- z^a8QDAW$HH$ZE{9BaB@DIw%ignsIi9_(2u%|@6|8{i{RGJT=g5R0kRHy}e90lhg0Rn_5wRLu>`T@Bf_Vqo>0}-XFacx9K!DKkqk)mY@(J&gO71sK&vSA@s1raN35{@`ktq(KZT$%*!*~FBnhl^T2wO5+BV~96 zyKm2)ejzLn7~Tl&9{8yU$J}2Wi0%mD>w56fs|Z4Ds27j{Yqb-EV^HyIMl=e5oX-kq zA9`dyi8#N-{#~AV`^+En06QD6_W`Z;FsP}6Dnrx4<`n#z&=)Kh8r`2`cQV}_c*MZ2 zzmyyLbqnB1AOc$wRY9j3dAbprG$9JaH7wHTK%@>Y!I)oYF$87ugSNzp6Uq;&Rh8<6 z0J8+Br1^+7;9$Qb5hh5V0e2z{A_TtMwG*G=_X_>}YA4*u-ovl??g*byMl=&dKx+0V zr|iAdh>%<}HxP>eCNo0B1-%jYQAxUZ9?Vv2ar9qjw;QiJi2#)Vw3;oi0)r}>YPRKD z(UO=jd%+j8$^d%leLXn2v-U$I;mOhsxF#C_^IG83tAOQ4z(za3K#xTFlmJ+YVO|bXBwV!#W5yNA=OZ4i48;xW@#|8`__s6~Yd_#JE{=Kv!sU zWyVSBmrFGYmFBng#?W+=6;M>*lN&zYQlbdp&%ajx!)xQOw(r_!R@75OpjvT+%(O+Zd`ZXGnNlLy(z~BVLDw4&A@r?ifV*Wj`%PL? ze)lZu7Ysa!;{%0_aY-Dg^qS2^sWPS9MScOn@HkCgQ)GIYxC_@0lk?fSf3UNLG!O(d zL6f`UEuRJ%${$1O!=KH3a)d(XlyFm?vc-}BBi$qMS{bK}76G->eq{Xz+h@HlcU?gQ z#o01!w9`Q10J#Yma%Y8n_J*oPaue6M0~N}5Vej@%Zd!-IQ7vo5()Y?R^a7ONP)|W@ z%{orX9#H!*tB)JeB~Kr!}gFQUtRJyE+(13@5>EA+H7**ADX{j=%)4 z)Rd6i)=L*go@2K#0kkiarX^1@&3=0j&fz70fyFqyUQ@PCOPf82P&GFmTJPv}y@Jiw@>A zF-~2$WgGaG*)KUb#5`DXj`a4S0h}=MWCB2HEg;NyRR|=(jbSo?p+@ z-e0@=F|Hv9O(;KRwr9;DW%VC#v4-;#(vF!EjzensobSS|Fq`ilK^MI~Vja5!i{Kx1*t6Y?pi2`&XK zu1%8LgPnjG$IIuZnz*}maGH^4tashZef`xW2|2|Q(|Hj&ZPf-b$zwW~TTQi4uKnA$uJ$qjOKz5u#0QMuCY?tVSx`VDq;?zq=sb-=0rJ7l@s<+d)_yMO zMU|mw1s4!M3jN~YSfi7w*1LjikaIP!q&-*9ATzu` z!EtN@@xQ25m^Yh?mi~tM$Cx~cN|5mo0@$+I{os=u*NM%;ZU?#HNq;4c*~AxR%ek(E=8%Y? zvTt%HL=@kZ#Q`9e7b{CnxhE}7dj}C)ImJ2TI8v#;WTt!j5@{BVF_26R$t@01B}^RP z`MqAv^I_x&y?@){>94oHTA)Mg$?egxavtezDk^|6b*G|DgyE`&fIS@^n9EcSM|6BA ziTf+95IJFC{gDs=8KhhEmIxd%hHw_aCjACHv)edgmf&yKKtu?zl&-j|@GfBG3kwQK zM{#*XrKOj+-L>LLGwk^(_&0MYk9`eJye3AaVvp%yqtDXIna2puy;VITn1S@#fvrhF zS(D;D9U-|2k8x6Ar;&aYz>@PdxxlV(r1xK?@ZD`Q)B7U_$|A__1O=I{51P6>nGL^8 zb~%T!$*)xxz#>w0_K;o-W9c&qUvGl74%nO0S!$(;CN65g56_`h9hj1;`1a ze^f7gu+x8gb_fDFlVy8zIANf10vbcqDCA={UVUaT9RAqJ%arg)QlQZV^8*ku78rou zyCN+k19=0Y{{`As(lgT~h&(4yR8a`fd>SUWUxQ#DLdxh=Cy{=CzGHVEzGw@F-rGlk z(&o}F8Ru2ChC^@xDKGq4B4`pl*xy=0o(2GE0QUw+k`9v7*$o)tAkv4FXEvNt>5&iI z2b+Z5y|1iCkaPi}>H{F1wjf$Bj(!V9_sSnLeu-eGQPy^v?-k$=YjVMcc&B)J^L{Uc z2ZoW#N5-W7Zo zk_|b0oTP@3=HZV75l|J(tz%=<#v(d1Fb_Z!U;@8D4_O(Y{J}?01_CCJ1vFU_fE^f2 zze3tt{g=cI!a}Sr*RDJSyuRl`VHF})^Sz9LaWfP+JyT#7R6qCIMn{%3t)t^E>K2Wv!e>C( Date: Thu, 22 Jan 2026 00:02:29 +0000 Subject: [PATCH 1558/1799] New article: troubleshoot vcredist install issues --- ...oubleshoot-vcredist-installation-issues.md | 82 +++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 docs/windows/troubleshoot-vcredist-installation-issues.md diff --git a/docs/windows/troubleshoot-vcredist-installation-issues.md b/docs/windows/troubleshoot-vcredist-installation-issues.md new file mode 100644 index 00000000000..aaba4d0846f --- /dev/null +++ b/docs/windows/troubleshoot-vcredist-installation-issues.md @@ -0,0 +1,82 @@ +--- +title: "Troubleshoot Visual C++ Redistributable installation issues" +description: "Provide steps to diagnose and resolve issues with installing the Visual C++ Redistributable (vcredist)" +author: vicroms +ms.author: viromer +ms.date: 01/21/2025 +ms.topic: troubleshooting-general +helpviewer_keywords: [ "redist","vcredist", "Visual [C++] redistributable" ] +--- +# Troubleshoot Visual C++ Redistributable installation issues + +This guide is for users experiencing issues while installing the Visual C++ +Runtime components using the Visual C++ Redistributable installer or the +Visual Studio Installer. + +If you're experiencing such issues, we recommend that you first attempt +installing the [latest version of the Visual C++ +Redistributable](latest-supported-vc-redist.md). + +## Collect failure logs + +The first step to diagnose an issue with the Visual C++ +Redistributable (vcredist) installer is to collect its failure logs. + +1) Download the [Microsoft Visual Studio and .NET Log Collection + Tool](). +2) Run `Collect.exe` +3) Extract the contents of `%TEMP%/vscollect.zip` + +Once you extract `vscollect.zip`, the vcredist logs are located inside the +`Temp` folder. The relevant log files will be prefixed with the pattern +`dd_vcredist__yyyyMMddHHmmss`. + +In this article, we use these logs to diagnose common issues with the redist +installer. + +## Return Code 1603 + +Issues with the vcredist installer often produce the return code 1603. This is +a generic install failure code produced by the Windows Installer, which is +invoked during the installation of the Visual C++ Runtime components. + +Because many factors can produce a 1603 code, the return code itself is not +enough to diagnose the root cause of the issue. In such cases, the log files +usually contain relevant information that can lead to a solution. + +The [Common issues](#common-issues) section describes examples of how to +diagnose common installation errors and steps that may resolve them. If your +issue is not found here, then follow the instructions to [report an issue in +the Visual C++ Redistributable installer](#my-issue-is-not-here). + +## Common issues + +### Binary file is being used + +**Diagnose** + +**Steps to resolve** + +1 - Close all currently running applications. + +### Antivirus or third-party software interference + +**Diagnose** + +**Steps to resolve** + +1 - Disable any antivirus or third-party software that may have a lock on + components that are part of the Visual C++ Redistributable. + +### Corrupted Windows Installer cache + +**Diagnose** + +**Steps to resolve** + +1 - Try using the Windows Installer troubleshooting tool. + +## My issue is not here + +TBD: Instructions to report an issue with the redist installer. + From c83222bbc133c9ed989fb407116c0c4d0ff230f2 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 21 Jan 2026 16:47:05 -0800 Subject: [PATCH 1559/1799] first edit pass --- docs/build-insights/build-performance.md | 188 ++++++++---------- .../media/copilot-build-perf-select.png | Bin 27834 -> 28237 bytes .../media/copilot-subscription.png | Bin 28848 -> 29363 bytes 3 files changed, 85 insertions(+), 103 deletions(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 64265d93c7b..853b6f7a01d 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -1,194 +1,176 @@ --- title: "Get Started with GitHub Copilot build performance for Windows" description: "Learn how to use GitHub Copilot build performance for Windows to analyze C++ builds, identify expensive headers and templates, and automatically optimize build times in Visual Studio 2026." -ms.date: 1/20/2026 +ms.date: 01/21/2026 helpviewer_keywords: ["GitHub Copilot build performance", "C++ Build Insights", "build time optimization", "header file analysis", "template instantiation", "Visual Studio build performance"] ms.topic: how-to --- -# Get Started with GitHub Copilot build performance for Windows  +# Get started with GitHub Copilot build performance for Windows  -The GitHub Copilot build performance for Windows analyzes your C++ builds and highlights expensive headers, templates, and functions so you can identify and fix build time bottlenecks. GitHub Copilot integrates seamlessly with Visual Studio, reducing complexity and improving developer productivity. +The GitHub Copilot build performance for Windows analyzes your C++ builds and highlights expensive headers, template instantiations, and functions so you can identify and fix build time bottlenecks. GitHub Copilot is integrated with Visual Studio. ## Prerequisites  -- Windows 10 or later. +- Visual Studio 2026. Install the latest available version here: [Installation Guide](/visualstudio/install/install-visual-studio) +- MSVC Build Tools version 14.50 or later. - An MSBuild or CMake project. -- MSVC Build Tools version 14.50. - -## Installing Visual Studio 2026 - -To use GitHub Copilot build performance for Windows, you must install the latest available **Visual Studio 2026**. - -[Installation Guide](/visualstudio/install/install-visual-studio) - -Visual Studio 2026 supports **side-by-side installation** with older versions. You do not need to uninstall previous versions or other release channels. Installing Visual Studio 2026 will not interfere with your existing development environment.  +- Windows 10 or later. ### Before you begin  -After installing the Visual Studio Installer, ensure the following components are selected under the **Desktop development with C++** [workload](/visualstudio/install/install-visual-studio#step-4---choose-workloads) during installation: +In the Visual Studio 2026 Installer, ensure the following components are selected in the **Desktop development with C++** [workload](/visualstudio/install/install-visual-studio#step-4---choose-workloads): -- C++ Build Insights -- C++ profiling tools -- C++ CMake tools for Windows (required for CMake projects)  +- **C++ Build Insights** +- **C++ profiling tools** +- **C++ CMake tools for Windows (required for CMake projects)** -:::image type="complex" source="./media/vs-installer-options.png" alt-text="This installer view highlights the available optional components within the Desktop development with C++ workload, helping users confirm that tools required for build analysis and performance optimization are included during setup."::: +:::image type="complex" source="./media/vs-installer-options.png" alt-text="Screenshot of the Visual Studio installer. The desktop development with C++ section is highlighted and C++ Build Insights, C++ profiling tools, and C++ CMake tools for Windows are selected."::: The list shows C++ Build Insights, C++ profiling tools, and C++ CMake tools for Windows are all selected for installation. :::image-end::: -## Verify GitHub Copilot subscription - -GitHub Copilot build performance for Windows is available to users on GitHub Copilot Pro, Pro+, Business, and Enterprise plans.   +### Verify your GitHub Copilot subscription -- Verify your subscription  +To use GitHub Copilot build performance for Windows, you need a GitHub Copilot Pro, Pro+, Business, or Enterprise subscription. - - Log in to [https://github.com](https://github.com/) and access the [Copilot features](https://github.com/settings/copilot/features) +Verify your GitHub Copilot subscription on GitHub, and then sign in to your GitHub account in Visual Studio 2026: - - Your plan type will appear near the top of the page.  +1. Verify your GitHub Copilot subscription: + - Sign in to [https://github.com](https://github.com/). + - Select your profile picture and then [Copilot settings](https://github.com/settings/copilot/features). Your plan type appears near the top of the page: - :::image type="complex" source="./media/copilot-subscription.png" alt-text="Banner in GitHub account settings confirming that GitHub Copilot Enterprise is active, with quick-access buttons for various Copilot features including IDE, CLI, mobile, GitHub.com, and more."::: - This banner provides context for where subscription details are displayed within GitHub’s account settings interface. + :::image type="complex" source="./media/copilot-subscription.png" alt-text="Screenshot of the users GitHub Copilot information."::: + The Copilot settings page shows the type of subscription. In this case, the user has GitHub Copilot Enterprise. :::image-end::: -- Authenticate in Visual Studio 2026 +1. Sign in to your GitHub account in Visual Studio: - Before proceeding, ensure you are signed in to your GitHub account in Visual Studio. + - If you're not signed in to GitHub in Visual Studio, open the GitHub Copilot Chat and follow the sign-in instructions in the pop-up window. + - Select your profile picture in Visual Studio to confirm your GitHub sign-in status: - - Click on your profile picture in the upper-right corner of Visual Studio to confirm your GitHub login status. - - :::image type="complex" source="./media/vs-account-authentication.png" alt-text="Visual Studio account dropdown showing an active login session with a Microsoft account and a connected GitHub account, both marked as active and synced."::: - The dropdown displays the GitHub account with active status and sync indicator. + :::image type="complex" source="./media/vs-account-authentication.png" alt-text="Screenshot of the account dropdown in Visual Studio."::: + The account dropdown shows that a Microsoft account and a GitHub account are both signed in and active. :::image-end::: - - If you are not signed in, open the GitHub Copilot Chat and follow the sign-in instructions from the pop-up window. - - - Once authenticated, you can verify your plan by selecting Copilot Usage from the dropdown menu under the GitHub Copilot badge. +### Enable template collection -### Enable Template Collection +To minimize analysis overhead, the template instantiation time collection is off by default. To turn it on: -Template instantiation time collection is off by default to minimize analysis overhead. To turn it on: - - 1. In Visual Studio, go to **Tools** \> **Options**. - - 2. In the **Options** dialog, expand **Build Insights** in the left navigation. - - 3. Select **Collect Template Instantiation**. + 1. In Visual Studio, go to **Tools** > **Options**. + 1. In the **Options** dialog, expand **Build Insights**. + 1. Select **Collect Template Instantiation**. :::image type="complex" source="./media/build-insights-options.png" alt-text="Build Insights settings page in Visual Studio Options with the Collect template instantiation checkbox enabled, displaying trace collection configurations for analysis."::: The dialog shows trace collection settings with the Collect template instantiation checkbox selected. :::image-end::: -*Learn more:* [Troubleshoot template instantiation impact on build time | Microsoft Learn](/cpp/build-insights/tutorials/build-insights-template-view) +For more information about template instantiation on build time, see [Troubleshoot template instantiation impact on build time | Microsoft Learn](/cpp/build-insights/tutorials/build-insights-template-view) -## Workflow +## Troubleshoot build performance with GitHub Copilot -GitHub Copilot build performance on Windows is available via the GitHub Copilot chat pane. Users can access this functionality through the Agent feature within the chat interface. +View GitHub Copilot build performance on Windows via the GitHub Copilot chat pane. Choose the **Agent** feature within the chat interface: -:::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="GitHub Copilot chat pane showing agent selection. The GitHub Copilot build performance on Windows is highlighted as the option to select."::: -The pane shows GitHub Copilot build performance for Windows selected to optimize C++ build, with other agents listed. +:::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="Screenshot of the GitHub Copilot chat pane."::: +The GitHub Copilot chat pane shows a list of agents to choose from. Build Perf C p p (optimize your c + + build) is selected. :::image-end::: -Before submitting a request to the GitHub Copilot, select your preferred model. +Select your preferred model in the model drowpdown menu: -:::image type="complex" source="./media/model-select.png" alt-text="Model selection menu in Copilot Chat showing available AI models including GPT-5, GPT-5.1, Claude, and Gemini, with usage rate indicators."::: -This dropdown provides context on the range of AI models available when initiating a performance analysis. +:::image type="complex" source="./media/model-select.png" alt-text="Screenshot of the model selection menu in the Copilot Chat window."::: +This dropdown lists models various models like GPT-5, CLaude Sonnet 4, Gemini 3 Pro, and others. :::image-end::: -Instruct GitHub Copilot to improve the build performance of your selected project. You can add additional context and information so that GitHub Copilot can create suggestions that match the needs of your project. +Instruct GitHub Copilot to improve the build performance of your selected project. You can add extra context so that GitHub Copilot can better make suggestions to match the needs of your project. -:::image type="complex" source="./media/copilot-build-request.png" alt-text="Copilot Chat interface where the user has entered a request for build performance improvement using GitHub Copilot build performance on Windows."::: -The window shows GitHub Copilot build performance for Windows with user message requesting build performance improvement for the project. +:::image type="complex" source="./media/copilot-build-request.png" alt-text="Screenshot of the GitHub Copilot Chat window."::: +The GitHub Copilot chat window shows @ Build Per Cpp: Help me improve the build performance of this project. :::image-end::: -### Enable Build Insights +If this is your first time using GitHub Copilot build performance for Windows, you'll need to enable Build Insights and grant elevated permissions to collect MSVC compiler traces. -To analyze the build performance of the selected project, Visual Studio needs elevated permissions. The Build Insights tool needs to be enabled for a first-time user to kickstart the build performance analysis. +### Grant additional permissions to run Build Insights -*Learn more:* [Build Insights needs additional permissions | Microsoft Learn](/cpp/build-insights/elevate-note) +Visual Studio needs elevated permissions to analyze build performance. The Build Insights tool needs to be enabled to start the build performance analysis. Once enabled, it stays enabled until you disable it. For more information about these permissions, see [Build Insights needs additional permissions](/cpp/build-insights/elevate-note). Github copilot prompts you to enable Build Insights and grant elevated permissions: -:::image type="complex" source="./media/build-insights-permission.png" alt-text="Visual Studio dialog titled Run Build Insights requesting permission to start build analysis, with Confirm and Deny buttons."::: -This dialog appears when Visual Studio is preparing to launch the profiling tools necessary for trace generation. +:::image type="complex" source="./media/build-insights-permission.png" alt-text="Screenshot of a GitHub Copilot dialog asking to elevate permissions."::: +The dialog indicates that Build Insights (vcperf) needs additional permissions to capture MSVC compiler traces. There are Confirm and Deny buttons. :::image-end::: -A one-time elevated request is then needed to capture the MSVC compiler traces. +Choose **Confirm** to have GitHub Copilot proceed with the request. A Visual Studio dialog then appears prompting you to allow a one-time elevated request: -:::image type="complex" source="./media/msvc-elevation.png" alt-text="Microsoft Visual Studio prompt requesting elevated permissions for Build Insights to collect MSVC compiler traces, displaying Yes and No options."::: -This prompt provides system-level acknowledgment of the resource access required for tracing. +:::image type="complex" source="./media/msvc-elevation.png" alt-text="Screenshot of a Microsoft Visual Studio prompt requesting elevated permissions."::: +The elevation prompt says: Build Insights (vcperf) needs additional permissions to capture MSVC compiler traces. Allow this one-time elevated request? There are Yes and No buttons. :::image-end::: -:::image type="complex" source="./media/windows-user-account-control.png" alt-text="Windows User Account Control dialog asking whether to allow the Windows Command Processor to make changes, with Yes and No choices."::: -This UAC dialog is part of Windows’ layer of elevation confirmation and appears when enabling Build Insights for the first time. +If you choose to grant elevated permissions, the Windows User Account Control dialog appears. Choose **Yes** to grant permission to capture the MSVC compiler traces: + +:::image type="complex" source="./media/windows-user-account-control.png" alt-text="Screenshot of the User Account Control dialog."::: +The dialog asks for permission for the Windows Command Processor, verified publisher Microsoft, to allow this app to make changes to your device. There are Yes and No buttons. :::image-end::: -If the one-time elevated request is denied, the Build Insights operation is cancelled due to lack of rights to continue. +Denying the elevated request will cancel the Build Insights operation. +## Guide GitHub Copilot through the process of improving the build time -You will guide GitHub Copilot through the process of improving the build time by providing permission, as needed, to run tools. Additional permissions may be required to run PowerShell scripts. +As you guide GitHub Copilot through the process of improving the build time, you will be asked to provide permission, as needed, to run tools such as PowerShell scripts: -:::image type="complex" source="./media/terminal-permission.png" alt-text="Copilot Chat notification prompting the user to authorize execution of a terminal command, offering Confirm, Always allow, and Allow in this session."::: -This prompt appears within the chat flow when Copilot requires permission to run terminal commands necessary for optimization. +:::image type="complex" source="./media/terminal-permission.png" alt-text="Screenshot of a Copilot Chat notification."::: +The prompt asks the user to authorize running the command: ls ../src/ in the terminal. The Confirm dropdown offers: Always allow and Allow in this session. There is also a Deny button. :::image-end::: -The GitHub Copilot build performance for Windows goes through multiple iterations of code implementation to make the build faster. +The GitHub Copilot build performance for Windows may go through multiple iterations to find the best way to make the build faster: -:::image type="complex" source="./media/build-analysis-complete.png" alt-text="The display shows build time improved from 78.6 seconds to 70.5 seconds (8.1 seconds faster, ~10.3% improvement), with a note that further improvement is possible."::: -This image provides contextual insight into how build metrics are presented after an optimization iteration. +:::image type="complex" source="./media/build-analysis-complete.png" alt-text="Screenshot of a message in the GitHub Copilot chat window."::: +The message indicates that analysis is complete and the build time improved from 78.6 seconds to 70.5 seconds (8.1 seconds faster, ~10.3% improvement). It indicates there's still room for improvement. :::image-end::: -After GitHub Copilot completes the request, a summary of the changes and build performance impact is displayed. The build performance summary changes depending on each iteration of the agent. +When the analysis is complete, GitHub Copilot displays a summary of the changes and build performance impact for that iteration: -:::image type="complex" source="./media/build-summary.png" alt-text="A summary view comparing build performance before and after optimization. The report shows build time dropping from about 110.7 seconds to 34.1 seconds, with major header bottlenecks significantly reduced. It highlights a 69% overall improvement and faster incremental rebuilds after precompiled headers were enabled."::: -The summary displays top bottlenecks and quantitative results of the performance improvements. +:::image type="complex" source="./media/build-summary.png" alt-text="Screenshot of the build performance summary."::: +The summary shows a before and after optimization summary indicating build time, the top bottleneck, and the top 5 headers that contributed the most to the build time. The report shows build time dropping from 110.7 seconds to 34.1 seconds. It highlights a 69.2% overall improvement and faster incremental rebuilds after enabling precompiled headers. :::image-end::: In this case, build time dropped from **110.7s to 34.1s** after enabling precompiled headers for costly includes, delivering a **69% improvement** and **3.2× faster builds** with near-instant incremental rebuilds. -### Additional entry points +### Other ways to access GitHub Copilot build performance for Windows -The GitHub Copilot build performance for Windows can be accessed through other entry points. +You can access the GitHub Copilot build performance for Windows in these other ways: -- Button from build menu +- The **Build** menu: - :::image type="complex" source="./media/build-menu-improve.png" alt-text="Visual Studio Build menu expanded with the Improve build performance option highlighted under Run Build Insights."::: - The menu shows the Improve build performance option under Run Build Insights. + :::image type="complex" source="./media/build-menu-improve.png" alt-text="Screenshot of the Build menu.""::: + The Build menu option Run Build Insights is expanded to show Build All, Rebuild All, and Improve Build Performance. The latter is selected. :::image-end::: - Clicking the Improve build performance button prompts GitHub Copilot chat +- Select a **Improve build performance** prompt in GitHub Copilot chat: - :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Copilot chat window with Improve Build Performance prompt."::: - The window shows GitHub Copilot build performance for Windows ready to assist with optimization. + :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Screenshot of the Copilot chat window."::: + The chat window shows a prompt to Improve Build Performance. :::image-end::: -- Button from solution context menu +- **Solution** window context menu: - :::image type="complex" source="./media/solution-menu-improve.png" alt-text="Solution context menu in Visual Studio showing Improve build performance on Solution among the available commands."::: - The context menu displays the Improve build performance on Solution option. + :::image type="complex" source="./media/solution-menu-improve.png" alt-text="A screenshot of the Solution explorer."::: + The context menu shows Build Solution, Build Solution, and so on. Improve build performance on Solution is highlighted. :::image-end::: - Clicking the Improve build performance on Solution button prompts the GitHub Copilot chat + Select **Improve build performance on Solution** to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project. - :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Copilot chat window with a request to help improve the build performance of this project."::: - The window shows GitHub Copilot build performance for Windows request to assist with build optimization. + :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Screenshot of the Copilot chat window."::: + The chat window shows a prompt to Improve Build Performance. :::image-end::: -- Button from Build Insights view +- Build Insights view: - :::image type="complex" source="./media/insights-improve-button.png" alt-text="Build Insights diagnostics session interface with the Improve button visible for triggering optimization using existing trace data."::: - The view shows the diagnostics session with the Improve button available for optimization. - :::image-end::: + Select **Improve** from the Build Insights diagnostics session view to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project, shown previously. This button uses data from the existing build insights trace results and doesn't trigger a new build insights tool execution until the current changes are processed. - Clicking the Improve button prompts the GitHub Copilot chat. This button uses data from the existing build insights trace results and does not trigger a new build insights tool execution until the current proposed changes have been processed. - - :::image type="complex" source="./media/copilot-improve-includes.png" alt-text="Copilot chat with request to help improve the build performance of this project, focusing on includes."::: - Copilot Chat showing a user request specifically targeting include file optimization as part of the build performance improvements. + :::image type="complex" source="./media/insights-improve-button.png" alt-text="Screenshot of the Build Insights view window."::: + The Improve link is highlighted. :::image-end::: -## See Also - -[Build Insights function view](/cpp/build-insights/tutorials/build-insights-function-view) - -[Build Insights included files view](/cpp/build-insights/tutorials/build-insights-included-files-view) - -[vcperf and Windows Performance Analyzer](/cpp/build-insights/tutorials/vcperf-and-wpa) +## See also +[Build Insights function view](/cpp/build-insights/tutorials/build-insights-function-view)\ +[Build Insights included files view](/cpp/build-insights/tutorials/build-insights-included-files-view)\ +[vcperf and Windows Performance Analyzer](/cpp/build-insights/tutorials/vcperf-and-wpa)\ [Windows Performance Analyzer basics](/cpp/build-insights/tutorials/wpa-basics) \ No newline at end of file diff --git a/docs/build-insights/media/copilot-build-perf-select.png b/docs/build-insights/media/copilot-build-perf-select.png index 67e5e0449db8bf47e19beb085dea9be867185371..4bda984a9ca6eb76b6af0a80f52c68fe26c78576 100644 GIT binary patch literal 28237 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 S_(Sh>d!+P4vEaUu-+ut$Y)?P{ literal 27834 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

rneWTid`Kk?g z6F)yBghKeJ+N~&)PF&;n;--4{7LLxfTjpsW0eFf0M$27xjORE=<=lOySoBr4M(XgT zx={Y|Lz=B_deWLp%Tu>b>cD!)P*R}ioW^RPOB@5Ll;bfrlPK#*rEgJc^ zOrnc4skuctw`q$%6;_$sdd)raLu4-#KSQE4s%EjI(ps=es#(gGsBiy8)nqpR7UKi>vZ zCR6s^%5$QwMb`?w)}KH7^A>wpCU|479P2P*`i7>Rh??#efyptn>N4(#yM4A-K5jdn zjB%LQHs9o~9x_MMx*HAf@h_!OmxgPI=`rc^llL8b#_qi<%gdli@PnwO_o7n>QMu=s zE0N(Un?U2k1UQ&wJRe$G&tLq)O%XD^-Wr&}t)Wwno~k06(KkFiBToNkH>>ktCd$an zoEgwDeDfc5)b;LbkJHU?@7KfDYq1!9RN5pRtfS;Ax@q|&jWm&aRAjq~px#CdST%#F zwy~6zlBT$D%(i3jq|CN?rJ!yi3lqDnYj7^u=nY)BPW3yira_e;#WFwpn!1SH{qrY* zMD*?cSbMkIpLkt)ciFe-F3Q@iDIo8Ra4HTx4G9XwS8l=@DjJQZ_f)jPlLqI}9Gy=Wok@!;2b#R5Z~ewFqF z7Ni-<1paRYclLitt8KdD%e_jBZxB%p14Yh$uO6I^c_6T|Fc%d|`J*4iyns=kNaz`cKqB>+S!JGZ4E;GMuey#PVA#8hIb}rJzuN;2V*H z0bLdYReLm0F!Sy%4+iRIyb%72KR+>0ZyBU$5Z4e1WT22QNwdzCnxCIXtagN9-4;z! zeZ)-x9$|-WjV54^kF#s4ptAt??FlGtnSJ%I1Xqk^D;u?0EaxgUcGowq;9WL=Su~U^ z<>B)*f~2d+q-BovXQCK6s_^+Bk65n0K|$I0Q)Kf2P~#||5Hz`NCqlKznZh}-`^hKv zHgfoYcll9Mptr^EXl1ER_o>NTM0swtafsSa`LNejR8ZsYNy>jWD=v`;a)hu5B7Qm+ zXlrWvzI#U|R-ptX6v}pMTk!I-6(U7e=)4f6vlpdv6xc0XE9dd5GgQ4$X=&JhlS*(W z6=FEEMJ)`C*>7(*+UE;r4A4p_BF8&X{=IG^oTDI@Elw~a2)2JF{hQ+50GCgN<6JZ?^;1}l<)U%kPnG#<>?r{a5xV!s!M%Jyfot=?43 zdt7p71f2~a3IU_w7`AqGDT1z|JjdG(qUm?zB7_`6F^v~c&AR#Q0Kk;?c5y^P0)D|@ z?g^dkB$RFV6>YE5Ve9y0jI6#OxH@wS3xF@0@6;+AmRf)KbGo&sQ1R~FyNH)LIg=c* zQ7f0ZQo3<~6a%yd=@;O~&t$15WpBYrf}tO`4SFATl zVwM@J-I-u9#7VC+Ps>AlY*nnP{zFD{Ina+DKD^?!;m4Q?^M+VzheW%;AQZ6(k(m#^ z@Ed@dQ>CM}jdkazcF58|xCclxK`K$~MlcKr9|N7}B38;Y5=e5VT)oE0dCSP?W8&NS zj#w7Z^;ETCk-%o04p-bAmQRCmkp-Fuggwxa_+Y!guUqruv0&H5ix=;REqdC6Q~?Es zqNJoG{>LaJ7TVsiwR?mF2g5v~a+y#BktI_VUW7>vKal-Wa$e4ZEB`=SyS)tx*d;u& zejrc?I|E=0S~wJ-U!D+7kVDO z4>1+^B!59HUl^YLwk0Rf78^kj#3G;{P`LpU*emJqs#hH&{D5wFC%$)^D#(68>Cg6I zL~?Tea2e1E{oa{>!x5kK%*@P`(}zBMoql~>Ln{8cYTQ;QY#h)v^~p0o7GT`tL<<#?O$NEJd#51=lv058KwAeoC z+mU4)2st^d8?ainpYVSSW(ZJRGup_072GmIekFM&oW&a!PgPXm6RVBK1MUF@_-=1Dl&Emnl9WVbhQCY>?>gmOzEFrp$pQ{~&uf^U@#Rs`1+Y@!sov--U??

9ghb2Y;oGGWFk@jdKmWDUKRAeFLtx&v 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 A_y7O^ diff --git a/docs/build-insights/media/copilot-subscription.png b/docs/build-insights/media/copilot-subscription.png index 6cec3744fdda0405837988d16d05ecde7f0d1b60..9147ff7177c02eaa1926f0856b2cff693c9d1a45 100644 GIT binary patch literal 29363 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¬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 Date: Wed, 21 Jan 2026 17:02:15 -0800 Subject: [PATCH 1560/1799] fix link --- docs/build-insights/build-performance.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 853b6f7a01d..ab2e82933f3 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -1,6 +1,6 @@ --- title: "Get Started with GitHub Copilot build performance for Windows" -description: "Learn how to use GitHub Copilot build performance for Windows to analyze C++ builds, identify expensive headers and templates, and automatically optimize build times in Visual Studio 2026." +description: "Learn how to use GitHub Copilot to improve build times." ms.date: 01/21/2026 helpviewer_keywords: ["GitHub Copilot build performance", "C++ Build Insights", "build time optimization", "header file analysis", "template instantiation", "Visual Studio build performance"] ms.topic: how-to @@ -8,7 +8,7 @@ ms.topic: how-to # Get started with GitHub Copilot build performance for Windows  -The GitHub Copilot build performance for Windows analyzes your C++ builds and highlights expensive headers, template instantiations, and functions so you can identify and fix build time bottlenecks. GitHub Copilot is integrated with Visual Studio. +The GitHub Copilot build performance for Windows helps you make your builds faster. It finds expensive headers, template instantiations, and functions and can automatically make your builds more efficient. GitHub Copilot is integrated with Visual Studio. ## Prerequisites  @@ -108,7 +108,7 @@ If you choose to grant elevated permissions, the Windows User Account Control di The dialog asks for permission for the Windows Command Processor, verified publisher Microsoft, to allow this app to make changes to your device. There are Yes and No buttons. :::image-end::: -Denying the elevated request will cancel the Build Insights operation. +Denying the elevated request cancels the Build Insights operation. ## Guide GitHub Copilot through the process of improving the build time @@ -138,7 +138,7 @@ You can access the GitHub Copilot build performance for Windows in these other w - The **Build** menu: - :::image type="complex" source="./media/build-menu-improve.png" alt-text="Screenshot of the Build menu.""::: + :::image type="complex" source="./media/build-menu-improve.png" alt-text="Screenshot of the Build menu."::: The Build menu option Run Build Insights is expanded to show Build All, Rebuild All, and Improve Build Performance. The latter is selected. :::image-end::: From c1c9838ad8dfc1f356b74e1d941e1e3dc38c5337 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 21 Jan 2026 17:47:28 -0800 Subject: [PATCH 1561/1799] edits --- docs/build-insights/build-performance.md | 43 ++++++++++-------------- 1 file changed, 18 insertions(+), 25 deletions(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index ab2e82933f3..d5d9127b5dc 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -12,21 +12,16 @@ The GitHub Copilot build performance for Windows helps you make your builds fast ## Prerequisites  -- Visual Studio 2026. Install the latest available version here: [Installation Guide](/visualstudio/install/install-visual-studio) - MSVC Build Tools version 14.50 or later. -- An MSBuild or CMake project. +- A MSBuild or CMake project. - Windows 10 or later. ### Before you begin  In the Visual Studio 2026 Installer, ensure the following components are selected in the **Desktop development with C++** [workload](/visualstudio/install/install-visual-studio#step-4---choose-workloads): -- **C++ Build Insights** -- **C++ profiling tools** -- **C++ CMake tools for Windows (required for CMake projects)** - -:::image type="complex" source="./media/vs-installer-options.png" alt-text="Screenshot of the Visual Studio installer. The desktop development with C++ section is highlighted and C++ Build Insights, C++ profiling tools, and C++ CMake tools for Windows are selected."::: -The list shows C++ Build Insights, C++ profiling tools, and C++ CMake tools for Windows are all selected for installation. +:::image type="complex" source="./media/vs-installer-options.png" alt-text="Screenshot of the Visual Studio installer."::: +The desktop development with C++ section is highlighted and C++ Build Insights, C++ profiling tools, and C++ CMake tools for Windows are selected. :::image-end::: ### Verify your GitHub Copilot subscription @@ -35,18 +30,14 @@ To use GitHub Copilot build performance for Windows, you need a GitHub Copilot P Verify your GitHub Copilot subscription on GitHub, and then sign in to your GitHub account in Visual Studio 2026: -1. Verify your GitHub Copilot subscription: - - Sign in to [https://github.com](https://github.com/). - - Select your profile picture and then [Copilot settings](https://github.com/settings/copilot/features). Your plan type appears near the top of the page: +1. Verify your GitHub Copilot subscription by signing in to [https://github.com](https://github.com/). Select your profile picture and then [Copilot settings](https://github.com/settings/copilot/features). Your plan type appears near the top of the page: :::image type="complex" source="./media/copilot-subscription.png" alt-text="Screenshot of the users GitHub Copilot information."::: The Copilot settings page shows the type of subscription. In this case, the user has GitHub Copilot Enterprise. :::image-end::: - 1. Sign in to your GitHub account in Visual Studio: - - If you're not signed in to GitHub in Visual Studio, open the GitHub Copilot Chat and follow the sign-in instructions in the pop-up window. - - Select your profile picture in Visual Studio to confirm your GitHub sign-in status: + - To confirm your GitHub sign-in status, select your profile picture in Visual Studio: :::image type="complex" source="./media/vs-account-authentication.png" alt-text="Screenshot of the account dropdown in Visual Studio."::: The account dropdown shows that a Microsoft account and a GitHub account are both signed in and active. @@ -68,13 +59,13 @@ For more information about template instantiation on build time, see [Troublesho ## Troubleshoot build performance with GitHub Copilot -View GitHub Copilot build performance on Windows via the GitHub Copilot chat pane. Choose the **Agent** feature within the chat interface: +View GitHub Copilot build performance on Windows via the GitHub Copilot chat pane. Choose **Agent** in the dropdown: :::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="Screenshot of the GitHub Copilot chat pane."::: The GitHub Copilot chat pane shows a list of agents to choose from. Build Perf C p p (optimize your c + + build) is selected. :::image-end::: -Select your preferred model in the model drowpdown menu: +Then Select your preferred model in the model drop down menu: :::image type="complex" source="./media/model-select.png" alt-text="Screenshot of the model selection menu in the Copilot Chat window."::: This dropdown lists models various models like GPT-5, CLaude Sonnet 4, Gemini 3 Pro, and others. @@ -86,36 +77,38 @@ Instruct GitHub Copilot to improve the build performance of your selected projec The GitHub Copilot chat window shows @ Build Per Cpp: Help me improve the build performance of this project. :::image-end::: -If this is your first time using GitHub Copilot build performance for Windows, you'll need to enable Build Insights and grant elevated permissions to collect MSVC compiler traces. +The first time you use GitHub Copilot build performance for Windows, you may need to enable Build Insights and grant elevated permissions to collect MSVC compiler traces. ### Grant additional permissions to run Build Insights -Visual Studio needs elevated permissions to analyze build performance. The Build Insights tool needs to be enabled to start the build performance analysis. Once enabled, it stays enabled until you disable it. For more information about these permissions, see [Build Insights needs additional permissions](/cpp/build-insights/elevate-note). Github copilot prompts you to enable Build Insights and grant elevated permissions: +Visual Studio needs elevated permissions to analyze build performance and the Build Insights tool needs to be enabled. It stays enabled until you disable it. For more information about these permissions, see [Build Insights needs additional permissions](/cpp/build-insights/elevate-note). + +GitHub Copilot prompts you to enable Build Insights and grant elevated permissions: :::image type="complex" source="./media/build-insights-permission.png" alt-text="Screenshot of a GitHub Copilot dialog asking to elevate permissions."::: The dialog indicates that Build Insights (vcperf) needs additional permissions to capture MSVC compiler traces. There are Confirm and Deny buttons. :::image-end::: -Choose **Confirm** to have GitHub Copilot proceed with the request. A Visual Studio dialog then appears prompting you to allow a one-time elevated request: +Choose **Confirm**. A Visual Studio dialog then appears prompting you to allow a one-time elevated request: :::image type="complex" source="./media/msvc-elevation.png" alt-text="Screenshot of a Microsoft Visual Studio prompt requesting elevated permissions."::: The elevation prompt says: Build Insights (vcperf) needs additional permissions to capture MSVC compiler traces. Allow this one-time elevated request? There are Yes and No buttons. :::image-end::: -If you choose to grant elevated permissions, the Windows User Account Control dialog appears. Choose **Yes** to grant permission to capture the MSVC compiler traces: +If you choose to grant elevated permissions, the Windows User Account Control dialog appears: :::image type="complex" source="./media/windows-user-account-control.png" alt-text="Screenshot of the User Account Control dialog."::: The dialog asks for permission for the Windows Command Processor, verified publisher Microsoft, to allow this app to make changes to your device. There are Yes and No buttons. :::image-end::: -Denying the elevated request cancels the Build Insights operation. +Choose **Yes** to grant permission to capture the MSVC compiler traces. Denying the elevated request to cancel the build analysis. ## Guide GitHub Copilot through the process of improving the build time -As you guide GitHub Copilot through the process of improving the build time, you will be asked to provide permission, as needed, to run tools such as PowerShell scripts: +As you guide GitHub Copilot through the process of improving the build time, it may ask you to provide permission to run tools such as PowerShell scripts: :::image type="complex" source="./media/terminal-permission.png" alt-text="Screenshot of a Copilot Chat notification."::: -The prompt asks the user to authorize running the command: ls ../src/ in the terminal. The Confirm dropdown offers: Always allow and Allow in this session. There is also a Deny button. +The prompt asks the user to authorize running the command: ls ../src/ in the terminal. The Confirm dropdown offers: Always allow and Allow in this session. There's also a Deny button. :::image-end::: The GitHub Copilot build performance for Windows may go through multiple iterations to find the best way to make the build faster: @@ -127,7 +120,7 @@ The message indicates that analysis is complete and the build time improved from When the analysis is complete, GitHub Copilot displays a summary of the changes and build performance impact for that iteration: :::image type="complex" source="./media/build-summary.png" alt-text="Screenshot of the build performance summary."::: -The summary shows a before and after optimization summary indicating build time, the top bottleneck, and the top 5 headers that contributed the most to the build time. The report shows build time dropping from 110.7 seconds to 34.1 seconds. It highlights a 69.2% overall improvement and faster incremental rebuilds after enabling precompiled headers. +The summary shows a before and after optimization summary indicating build time, the top bottleneck, and the top five headers that contributed the most to the build time. The report shows build time dropping from 110.7 seconds to 34.1 seconds. It highlights a 69.2% overall improvement and faster incremental rebuilds after enabling precompiled headers. :::image-end::: In this case, build time dropped from **110.7s to 34.1s** after enabling precompiled headers for costly includes, delivering a **69% improvement** and **3.2× faster builds** with near-instant incremental rebuilds. @@ -162,7 +155,7 @@ You can access the GitHub Copilot build performance for Windows in these other w - Build Insights view: - Select **Improve** from the Build Insights diagnostics session view to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project, shown previously. This button uses data from the existing build insights trace results and doesn't trigger a new build insights tool execution until the current changes are processed. + Select **Improve** from the Build Insights diagnostics session view to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project, shown previously. This button uses data from the existing build insights trace results. It doesn't do a new analysis until the current changes are processed. :::image type="complex" source="./media/insights-improve-button.png" alt-text="Screenshot of the Build Insights view window."::: The Improve link is highlighted. From 0d0208fd11e95cdedb6614f92e235984c08ac173 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 21 Jan 2026 17:48:39 -0800 Subject: [PATCH 1562/1799] add version --- docs/build-insights/build-performance.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index d5d9127b5dc..39263f721a1 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -12,6 +12,7 @@ The GitHub Copilot build performance for Windows helps you make your builds fast ## Prerequisites  +- Visual Studio 2026 version 18.3 Insiders 4, or later. - MSVC Build Tools version 14.50 or later. - A MSBuild or CMake project. - Windows 10 or later. From 2ab5e575d9a975b209e15a8db593741a151c326f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 22 Jan 2026 10:38:24 -0800 Subject: [PATCH 1563/1799] edits --- docs/build-insights/build-performance.md | 34 ++++++++++-------------- 1 file changed, 14 insertions(+), 20 deletions(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 39263f721a1..6c46dbda93e 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -38,7 +38,7 @@ Verify your GitHub Copilot subscription on GitHub, and then sign in to your GitH :::image-end::: 1. Sign in to your GitHub account in Visual Studio: - If you're not signed in to GitHub in Visual Studio, open the GitHub Copilot Chat and follow the sign-in instructions in the pop-up window. - - To confirm your GitHub sign-in status, select your profile picture in Visual Studio: + - Confirm your GitHub sign-in status by selecting your profile picture in Visual Studio. You should see that your GitHub account is **Active**: :::image type="complex" source="./media/vs-account-authentication.png" alt-text="Screenshot of the account dropdown in Visual Studio."::: The account dropdown shows that a Microsoft account and a GitHub account are both signed in and active. @@ -60,19 +60,21 @@ For more information about template instantiation on build time, see [Troublesho ## Troubleshoot build performance with GitHub Copilot -View GitHub Copilot build performance on Windows via the GitHub Copilot chat pane. Choose **Agent** in the dropdown: +To start GitHub Copilot build performance: + +1. open the GitHub Copilot chat pane and type '@'. One of the options is **@BuildPerfCpp**. Select it: :::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="Screenshot of the GitHub Copilot chat pane."::: The GitHub Copilot chat pane shows a list of agents to choose from. Build Perf C p p (optimize your c + + build) is selected. :::image-end::: -Then Select your preferred model in the model drop down menu: +1. Select your preferred model in the model drop down menu: :::image type="complex" source="./media/model-select.png" alt-text="Screenshot of the model selection menu in the Copilot Chat window."::: This dropdown lists models various models like GPT-5, CLaude Sonnet 4, Gemini 3 Pro, and others. :::image-end::: -Instruct GitHub Copilot to improve the build performance of your selected project. You can add extra context so that GitHub Copilot can better make suggestions to match the needs of your project. +1. Instruct GitHub Copilot to improve the build performance of your selected project by typing something like **Help me improve the build performance of this project**. You can add extra context so that GitHub Copilot can better make suggestions to match the needs of your project. :::image type="complex" source="./media/copilot-build-request.png" alt-text="Screenshot of the GitHub Copilot Chat window."::: The GitHub Copilot chat window shows @ Build Per Cpp: Help me improve the build performance of this project. @@ -80,23 +82,21 @@ The GitHub Copilot chat window shows @ Build Per Cpp: Help me improve the build The first time you use GitHub Copilot build performance for Windows, you may need to enable Build Insights and grant elevated permissions to collect MSVC compiler traces. -### Grant additional permissions to run Build Insights - Visual Studio needs elevated permissions to analyze build performance and the Build Insights tool needs to be enabled. It stays enabled until you disable it. For more information about these permissions, see [Build Insights needs additional permissions](/cpp/build-insights/elevate-note). -GitHub Copilot prompts you to enable Build Insights and grant elevated permissions: +If GitHub Copilot prompts you to enable Build Insights and grant elevated permissions, choose **Confirm**: :::image type="complex" source="./media/build-insights-permission.png" alt-text="Screenshot of a GitHub Copilot dialog asking to elevate permissions."::: The dialog indicates that Build Insights (vcperf) needs additional permissions to capture MSVC compiler traces. There are Confirm and Deny buttons. :::image-end::: -Choose **Confirm**. A Visual Studio dialog then appears prompting you to allow a one-time elevated request: +A Visual Studio dialog then appears prompting you to allow a one-time elevated request: :::image type="complex" source="./media/msvc-elevation.png" alt-text="Screenshot of a Microsoft Visual Studio prompt requesting elevated permissions."::: The elevation prompt says: Build Insights (vcperf) needs additional permissions to capture MSVC compiler traces. Allow this one-time elevated request? There are Yes and No buttons. :::image-end::: -If you choose to grant elevated permissions, the Windows User Account Control dialog appears: +Choose **Yes**. The Windows User Account Control dialog then appears: :::image type="complex" source="./media/windows-user-account-control.png" alt-text="Screenshot of the User Account Control dialog."::: The dialog asks for permission for the Windows Command Processor, verified publisher Microsoft, to allow this app to make changes to your device. There are Yes and No buttons. @@ -112,13 +112,7 @@ As you guide GitHub Copilot through the process of improving the build time, it The prompt asks the user to authorize running the command: ls ../src/ in the terminal. The Confirm dropdown offers: Always allow and Allow in this session. There's also a Deny button. :::image-end::: -The GitHub Copilot build performance for Windows may go through multiple iterations to find the best way to make the build faster: - -:::image type="complex" source="./media/build-analysis-complete.png" alt-text="Screenshot of a message in the GitHub Copilot chat window."::: -The message indicates that analysis is complete and the build time improved from 78.6 seconds to 70.5 seconds (8.1 seconds faster, ~10.3% improvement). It indicates there's still room for improvement. -:::image-end::: - -When the analysis is complete, GitHub Copilot displays a summary of the changes and build performance impact for that iteration: +Copilot may go through multiple iterations to find the best way to make the build faster. When the analysis is done, GitHub Copilot displays a summary of the changes and build performance impact for that iteration: :::image type="complex" source="./media/build-summary.png" alt-text="Screenshot of the build performance summary."::: The summary shows a before and after optimization summary indicating build time, the top bottleneck, and the top five headers that contributed the most to the build time. The report shows build time dropping from 110.7 seconds to 34.1 seconds. It highlights a 69.2% overall improvement and faster incremental rebuilds after enabling precompiled headers. @@ -130,19 +124,19 @@ In this case, build time dropped from **110.7s to 34.1s** after enabling precomp You can access the GitHub Copilot build performance for Windows in these other ways: -- The **Build** menu: +The **Build** menu: :::image type="complex" source="./media/build-menu-improve.png" alt-text="Screenshot of the Build menu."::: The Build menu option Run Build Insights is expanded to show Build All, Rebuild All, and Improve Build Performance. The latter is selected. :::image-end::: -- Select a **Improve build performance** prompt in GitHub Copilot chat: +Or select a **Improve build performance** prompt in GitHub Copilot chat: :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Screenshot of the Copilot chat window."::: The chat window shows a prompt to Improve Build Performance. :::image-end::: -- **Solution** window context menu: +Or use the **Solution** window context menu: :::image type="complex" source="./media/solution-menu-improve.png" alt-text="A screenshot of the Solution explorer."::: The context menu shows Build Solution, Build Solution, and so on. Improve build performance on Solution is highlighted. @@ -154,7 +148,7 @@ You can access the GitHub Copilot build performance for Windows in these other w The chat window shows a prompt to Improve Build Performance. :::image-end::: -- Build Insights view: +Or from the Build Insights view: Select **Improve** from the Build Insights diagnostics session view to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project, shown previously. This button uses data from the existing build insights trace results. It doesn't do a new analysis until the current changes are processed. From aaa1238e366502273cc3ce70f1a040a02b998693 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 22 Jan 2026 10:48:21 -0800 Subject: [PATCH 1564/1799] edits --- docs/build-insights/build-performance.md | 45 ++++++++++-------- .../media/build-analysis-complete.png | Bin 8173 -> 0 bytes 2 files changed, 25 insertions(+), 20 deletions(-) delete mode 100644 docs/build-insights/media/build-analysis-complete.png diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 6c46dbda93e..a8d324da6ea 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -29,14 +29,14 @@ The desktop development with C++ section is highlighted and C++ Build Insights, To use GitHub Copilot build performance for Windows, you need a GitHub Copilot Pro, Pro+, Business, or Enterprise subscription. -Verify your GitHub Copilot subscription on GitHub, and then sign in to your GitHub account in Visual Studio 2026: +Verify your GitHub Copilot subscription on GitHub, and then sign in to your GitHub account in Visual Studio 2026. 1. Verify your GitHub Copilot subscription by signing in to [https://github.com](https://github.com/). Select your profile picture and then [Copilot settings](https://github.com/settings/copilot/features). Your plan type appears near the top of the page: :::image type="complex" source="./media/copilot-subscription.png" alt-text="Screenshot of the users GitHub Copilot information."::: The Copilot settings page shows the type of subscription. In this case, the user has GitHub Copilot Enterprise. :::image-end::: -1. Sign in to your GitHub account in Visual Studio: +1. In Visual Studio, sign in to your GitHub account: - If you're not signed in to GitHub in Visual Studio, open the GitHub Copilot Chat and follow the sign-in instructions in the pop-up window. - Confirm your GitHub sign-in status by selecting your profile picture in Visual Studio. You should see that your GitHub account is **Active**: @@ -46,7 +46,7 @@ Verify your GitHub Copilot subscription on GitHub, and then sign in to your GitH ### Enable template collection -To minimize analysis overhead, the template instantiation time collection is off by default. To turn it on: +To minimize analysis overhead, the template instantiation time collection is off by default. Turn it on: 1. In Visual Studio, go to **Tools** > **Options**. 1. In the **Options** dialog, expand **Build Insights**. @@ -60,25 +60,27 @@ For more information about template instantiation on build time, see [Troublesho ## Troubleshoot build performance with GitHub Copilot -To start GitHub Copilot build performance: +To start the GitHub Copilot build performance agent: -1. open the GitHub Copilot chat pane and type '@'. One of the options is **@BuildPerfCpp**. Select it: - -:::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="Screenshot of the GitHub Copilot chat pane."::: -The GitHub Copilot chat pane shows a list of agents to choose from. Build Perf C p p (optimize your c + + build) is selected. -:::image-end::: +1. Open the GitHub Copilot chat pane and type '@'. One of the options is **@BuildPerfCpp**. Select it: + :::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="Screenshot of the GitHub Copilot chat pane."::: + The GitHub Copilot chat pane shows a list of agents to choose from. Build Perf C p p (optimize your c + + build) is selected. + :::image-end::: + 1. Select your preferred model in the model drop down menu: -:::image type="complex" source="./media/model-select.png" alt-text="Screenshot of the model selection menu in the Copilot Chat window."::: -This dropdown lists models various models like GPT-5, CLaude Sonnet 4, Gemini 3 Pro, and others. -:::image-end::: - + :::image type="complex" source="./media/model-select.png" alt-text="Screenshot of the model selection menu in the Copilot Chat window."::: + This dropdown lists models various models like GPT-5, CLaude Sonnet 4, Gemini 3 Pro, and others. + :::image-end::: + 1. Instruct GitHub Copilot to improve the build performance of your selected project by typing something like **Help me improve the build performance of this project**. You can add extra context so that GitHub Copilot can better make suggestions to match the needs of your project. -:::image type="complex" source="./media/copilot-build-request.png" alt-text="Screenshot of the GitHub Copilot Chat window."::: -The GitHub Copilot chat window shows @ Build Per Cpp: Help me improve the build performance of this project. -:::image-end::: + :::image type="complex" source="./media/copilot-build-request.png" alt-text="Screenshot of the GitHub Copilot Chat window."::: + The GitHub Copilot chat window shows @ Build Per Cpp: Help me improve the build performance of this project. + :::image-end::: + +### Permissions The first time you use GitHub Copilot build performance for Windows, you may need to enable Build Insights and grant elevated permissions to collect MSVC compiler traces. @@ -112,17 +114,20 @@ As you guide GitHub Copilot through the process of improving the build time, it The prompt asks the user to authorize running the command: ls ../src/ in the terminal. The Confirm dropdown offers: Always allow and Allow in this session. There's also a Deny button. :::image-end::: -Copilot may go through multiple iterations to find the best way to make the build faster. When the analysis is done, GitHub Copilot displays a summary of the changes and build performance impact for that iteration: +Choose the level of permission you are comfortable with. If you deny the request, GitHub Copilot can't proceed with the build performance analysis. +Copilot may go through multiple iterations to find the best way to make the build faster. + +When the analysis is done, GitHub Copilot displays a summary of the changes and build performance impact for that iteration: :::image type="complex" source="./media/build-summary.png" alt-text="Screenshot of the build performance summary."::: The summary shows a before and after optimization summary indicating build time, the top bottleneck, and the top five headers that contributed the most to the build time. The report shows build time dropping from 110.7 seconds to 34.1 seconds. It highlights a 69.2% overall improvement and faster incremental rebuilds after enabling precompiled headers. :::image-end::: -In this case, build time dropped from **110.7s to 34.1s** after enabling precompiled headers for costly includes, delivering a **69% improvement** and **3.2× faster builds** with near-instant incremental rebuilds. +In this example, build time dropped from **110.7s to 34.1s** after enabling precompiled headers for costly includes. A **69% improvement** and **3.2× faster builds** with near-instant incremental rebuilds. ### Other ways to access GitHub Copilot build performance for Windows -You can access the GitHub Copilot build performance for Windows in these other ways: +You can access the GitHub Copilot build performance for Windows in other ways: The **Build** menu: @@ -136,7 +141,7 @@ Or select a **Improve build performance** prompt in GitHub Copilot chat: The chat window shows a prompt to Improve Build Performance. :::image-end::: -Or use the **Solution** window context menu: +Or use the **Solution** window context menu which you can access by right-clicking the solution node: :::image type="complex" source="./media/solution-menu-improve.png" alt-text="A screenshot of the Solution explorer."::: The context menu shows Build Solution, Build Solution, and so on. Improve build performance on Solution is highlighted. diff --git a/docs/build-insights/media/build-analysis-complete.png b/docs/build-insights/media/build-analysis-complete.png deleted file mode 100644 index 10bd55a02352caef4752fc5807a83412cfd5f838..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8173 zcmd6McT`jV(G=HATblg!MWdFGjSMg}?z*SM}xQBg5G zd93-2it54{<#Xy48p@eJhRe zOH=%A&G&EZ%A5ZfKv+IWqFVB#vt9tCabJpEQ}-*Sn==XNeQx|U!|svcS_z1WAmIK$ z!?^KmXp@%XF+n%{G(@?&8DjbUCutXomLrIw+l{ibrCXte#}kydS@mTO0yT+fDn zqMGC^QftbBt=LRkIHP-t-5u=;%viVzGh!|;TJo@CxV#~KGA>qiwcIh#~=vx{sppXg;iy`SZtxN8U^XV=>O z{gvCsQ6q)eDN{~ySkLbfuH*O4%3^xXm5Xm3*XvP>M^|7PKRHdh3P%;PFPKqD>48e4pgN&I`2w2T&YdUhA{Td;#=T)!qMB? zKuJS8>xrr4=44{Cz4z6_%D{!!;p+IZm;5PhOf+cGg(oqgmDyRF48xL{K-9+k@;A+@ zT@@K)lx>r(Enkr+q(;Kb%h0U$T$x2nI=qWkiWqQn{;BA7qZqf?(W}grui_Xc(zz*4Lm;>u znX6Mm5S~=Ma#N)ctOTSOXxV(m?0aF)a2)RJ@)u;aGsu}*v{7T9Pds%M#Wdr>-O$}! z=7!Mxoyfk&Ae36xW@Q>kLwkkl%W`b23tQgStB+N4ma6J4v|V~au0R;;Ma;L@HEm`$ zo??;U2cA@Yty8|w!$}hNcvh_(xjyO9z|kQOb{LmAX+FMM-|>h73_7;%VHk%T{gI+` zo)@5X6THB&i@Qg5)pO&|NoXwzxC5!^^nJ;4Y!)KM`u)@}O*YDf2b<&whohsvs5*tA zlrBi`NLSmQR2;X~6ae8mN@XNYaQI^Yua&|+xc9`KMK=0m@_YhkII6nKU+mZTKABy# zw#WtkuE5YMU+JLzsAtE$IT95Nr<>4+zS=ATrG6YRepSBn?3)`xI~=XuG4Nk`0=f;roRA&09=kLH8!Nbl!96$&wpLP*1Fy{cxnfqt2~y)kY2 zuEBGsV4$$TSKA7DjK8f4`r81zqRQy``}WQkBj9)U#?JLdi$0oU3V6>8!lx=cHEl~b z5+6F#0+M&XNyJgjNYS&3 zaYN^ev@g4f=VyeWGJP~pilyRg285sxj3hi64mZW zDIx~#^>w*@4L2$h1ANMc{Dj>TonHWCJ!+9;X10ArPhk6WX1&sMDidh0=p)L?49n`5 z2&0s$%PYM9kG1LlRNOTA#BpVX;U7epSK)?gSt88LFm^ffE_+MMG!c`x9pR+U7YY-$ zK0D<6xAyKTr9QK$wHwM%Zz@>q$B2l7_U9UYPIuIA#**A0w89uI5Oc5NJ8#k z1;TE__+Gr)*@flMgJfmvDl*i=!I8a+t_y8{y6-6{D9E+ibMf2(*w!As!pA}t-;-2)fGrm)NX88a&q z7L5ff$0V-c;`jwpH`wsG(^ie;oegLJbS{;K4URmtjy^Gbez9YL^l;u3dJ4sCE-zsa zh7&B}XF^2kaJln%A6)qEw61Tf!>5FVty6GXBpKlYS?!Ld{pr8Scz!wy8E)u3is<&Z zw_qn-I*Lke`&6=;Q|EP+GuLg_b~^&djZ@$`VL)U&ozz`$e7u6I z>$KcQp*hCwFD@&(ocviGAaHk@WP7>IM?)@+lW%Mlx3u87=+qF1hHxso^MPM#-}!y* z&#p$Oy-Bi%40&Wb8(w3E>C3<($+!qIceV?IzJD}nZEcOvy@VcvT!KqEa0pWjJYE%j zi(zC1J#9rSZ1A^y8;dunW)UZjk$rZLy~NRB zY!3!cNcMZDZ?4*h7ku~ziI2TKqBwtlggvx1;62_>MwW2eHtxtpBL#>jt{GbX{QXrR zYZT%s#j8VBxySPx(Z-KB+S}9Np}oQ7tVjv5W?`;9++u5VZRhDQ-KlpS`Jj-@^EVjO zk4~h|@fh1$Ya+IVd@1i1ulAw4<>^JjImWs@EF`klb^SI~@1XOM2c0Atu0vLnbZotO zW8+%**^xzPJVdl@S7#LBrhd2=PEdlnUR{QSp^xOwPWA2Vx|o4~cTS<~+%QjpHMJ3| zRkfWxRTi~-E8UlrLkZU-PN4SdS|zXeoqRStcnBBMdE4Xhid7LO4td-=J2PAlLnV3B%;N)@dIy3aTF3DYO4#ES=l~@VaA@=S z>jvKJBt}fXroe4~j7c} zYNM*PhxAi2)Llbi!D2DDwIIT5GRc^K(?#Vke7{?NVVRhJCQ@6!(#dH^Sy-c9x6sL% zlC5Az>2rWk%6I;8>=F?ad`d<0SGer(uMk;pw;=T4PpOJvFL;BXG4V zlCn%D6+PkqE5VsI6jtTr=YEZXohXM%lG$NQ+D(A0!1FtXS+Eb2-dSZv-VER7q2k30 z2l^ga(q`Tua?Vwl`bpk?n0e*?d+3r*hQ3DQa5PCJ>M*0)jE_g{9Mb2G8zHJ;PtQrb z+1hi;YON%_Nzk`2=AIqjtp{z92PU;(4!3x3>zK7roPmYkLBY@qsZ!Bpv$bp_zu{Q# zpwbQT%rIazG&OW70j}MDjZkdS*KtCV=%ch1unR$Y-aHk)ZaepAMd4rM%%`^%H1A&& zZV*`a&&$1X&|8DDXwo#)qrufncE1zg5$rf7i-EE|7<+#pS=b83X>0Wqg|gfxFs3PfHv2 zxgv4uTK6yxVi8gGD{q@}fuKpkx{|j-y(`Bc`=$ez@J6B{M?c>gzER`Hc71fa{d#2T zxd4|A^v=kztS6Q|ytO?+v`lPinRneFdg}gPhg&Fy^h+18f759Do&H&anStk+wp&Fd zN4t3`U=mjplBu=u4qvHEc@nLORga5OcZv@azL*_@pPHgiK|%MwcfUqubL{l|35ps* z9Z&x8+O+$Q*3a3jIGE4?`uzkv?nLaD)mwfKK4?c(M%VmY_5P-18q!PDp2k!UUy?&j zd-8R3x7qdf*U4XPIGtGQpooJ;L(%|~xp{eEx z(V>Ga2-nFr6VJ3pxnL=YOH5TgeY^+;TC_K+CNS|cYHrVn`{7GnB+07}GxI={oVM2c zXef8HblY0E?kxV2@xIqMImifn`zh_1(wGeGZIS%w4?oS6u6(T>jrKWtxKJ_!91evJ z^~OhkAZ(SS(g1ypSX#WZenpwaIkaND3Y3nNY|4c8Z=oX24t*GQpgGG9T$7!DHmufA z$nJ0p5;dHwLm$Z132wGaY%B8eF?u=u!|_PEl0gh@BkeU+n0M~5;F~)+o%%y%5KTK= zgGhBGo6lPKwmH7i0T^7|c7t*#VCul>_>ON3$)K?`I9DyB(8d!9>&GgDmTfOYuqgI4 zMb`(MkwO%~(UE1a&B(c1k|9Q5_B$;(KKRfTXguCWl<^J1f5xxHLWv{OdJH7qQZB}J^s=hs?ec3d^PDy}hg1<>(^beR8-u$;={=uHAfc*o#o{3jZ&c+%=7UI4UrJIld@baPb2dqg1%)gKh7&COwL*nVsimS$$I)5%~BFmGD-;lB&8U`5L^cIk7P7>9tLyF zsCll;N!9JPg#{HtlS=c8TnS)#?;u_7$D{1hLYfYcPuo27_DnQXwYrE7|9lDM-g>wT zW@AWy78Urt4FqgaIP}h$I`RS%qmD)b#&T;%5LaFY4~G)UcOEc?KrUUGFI0kE3cs7Y zJI8I=pK|c_Q5n3u?YpvOZDNQ=*Vxci1B1_VJX0svd!_2Zr6AF6P|7m)xkgqpwrK4n zOo}NyE`8wiTP)@|KWRa}x~QMM6Z@bz8*oRN>6lIrw|DXO3t?E6vcMlGcQTO$dO|k? z`D=zT9Vs@D6BJ9&QT!APMi(z1u=kqG2HS~22V0D2~xf=7mMwH!yfx@%72xM4+DJX;gNnTcE3Q8ihH7R0}l4{%1FJ+yqaK}8Y zko!^Y+$L-*a0q@dTuMPk0G5ymoFlEE+ zw(C%q&bwHlZKEJ#+iLRaMe5x-KZ$F^CQLVSj{_uSfro|4v4$SAW}pA_b;D>xbiZ5- z_lXdm%zSL{&cp{B+q`8~ZyS`&Tc)Z#MftBJcuzsnfQ+EpC2+7z`q&Bf3PL|@-uCy@ z>_3_k&Ng6hdQ4N1-#BMRWiK-*QI`^oK&n>3GyGF;snH-`)DDe2yD+4Eu+=*5|&I)%JoWoP?VmM#iR2kuNr?cceFKsxTzvC8yyPeV3fp*wt#r8p=fexI;G!U|9wR_f`z{K z*Kn2Xi!ji=mYC*tN9~pb{HT+^{61(b;dy+?`wXtio{(2Q)uCHEbMs|^oOIzvTS(GH@b1(OvJBTi*Dr&9GbB$I-Slc-`=wuq%gYOTKZXo~mzA^Z-#!IzY1E=P|Ia z>aGAKD4i`%01LTF|9IHE27C-VrRj@v=btbW!9lC^#?U~3#Q1A$e$21SXPu-`+qSnv zTgx$>kVU4rLHi^*de$l;ZUXe2qrlJEW=$&3c>)_B$O_yP(v3S{e~hDZXY3sm!qMPN zxjq+h@`O!2we?hH2)~`A-JrIUq18vq<6(Yfv(&2ax~rwO`fV@maPLjKz9I&sV?cad z*kRn9R}tsIK_*zjIifW_Zt#8G*+c-|-CR2KdwW5|pguBi7u4p$-*#EX_H(67jD8Dza##1E;x8Gw?TVeJO?j*I`rce|%{)ti7Z0LAS%|JXCHtbA z8VWv(zoE7|KrC-lazi783Peyw7P=F<&@zoh`Qxiamyu_&46fzYv$l163=uT5H-Vl&<)h#$7!JNECj#dd<)l@HEZNWhR;rCdAAy)IPR;Z zd4D;7OJ=N*+%$pD2#zGZ4yA69+*AwYe%+CelHBL*d`;-`P--mNGV`mw-0rLW@~&L8 zMNWEooaQuRdIhJp{BT-MWzmb?xJ6Tx$7PgJv+*P>>m~=^f^5ue!*9r1!2}*o!5$%( zYt&gyJ_DkTe|vqkucm4WiK_DK@QV}dh!L^y|aopUa0$k{W#0(^RV&MoHqw7v-K^N%{Ad=t2jE_ zzkGOA!9Cpbwd#E@anFJbgRj5E^kTezc}HA>UFvkAI7_Kbk@bxH`y(eHSuQEZ33 z{^>Nd;_9eTGYtOD-j33Ncp(tj_9xDWR^O47H~oS^t5DlB86illZC@J~rTLPVulwLG zX1|^*=jRgtB43kBC4f|7RzQpMv*FgSN@$%|WP@qdMkLUjmBdp+{m+3M$=EkZPa|x0 zhQH+USxg=Fra~WAm-{NKWoC$eO{}5Y9$C*4KRx^ zwDM9J+{)k^=##GGd*-jT;B$-_7veIiHQCGXbmE zt)iFw4hqeAPrP~q{53m!Ay|5UcF9DB5j8%tl}dgxGCw>VX&P{{kh*C+S- zJ4IUVi@OzQsl4b~?daYY#}RhV7h-o_sot-U2=WE&^G5hydEyGLRCW#*eV>rvoicbq zZR<*wSIDo{jQrcX-wjJ*Zf-pw<0I@N+~zlgzC7Cp#`1SRg>xX;hzZbyHKfZ?n+w_tJk?QKgjnr!{of2v<4z Date: Thu, 22 Jan 2026 10:53:55 -0800 Subject: [PATCH 1565/1799] fix warning --- docs/build-insights/build-performance.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index a8d324da6ea..5152e0d6878 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -137,9 +137,9 @@ The **Build** menu: Or select a **Improve build performance** prompt in GitHub Copilot chat: - :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Screenshot of the Copilot chat window."::: - The chat window shows a prompt to Improve Build Performance. - :::image-end::: + :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Screenshot of the Copilot chat window."::: + The chat window shows a prompt to Improve Build Performance. + :::image-end::: Or use the **Solution** window context menu which you can access by right-clicking the solution node: From 017a47c36514fd069da729bdd8eb14414d94cc32 Mon Sep 17 00:00:00 2001 From: cdpark <15152924+cdpark@users.noreply.github.com> Date: Thu, 22 Jan 2026 11:02:35 -0800 Subject: [PATCH 1566/1799] Use VS2026 images --- .../reference/creating-a-makefile-project.md | 2 +- docs/build/reference/media/create-project.png | Bin 20664 -> 28846 bytes .../reference/media/file-new-project.png | Bin 13011 -> 15487 bytes 3 files changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/creating-a-makefile-project.md b/docs/build/reference/creating-a-makefile-project.md index 437700d4a94..726dcc60c9d 100644 --- a/docs/build/reference/creating-a-makefile-project.md +++ b/docs/build/reference/creating-a-makefile-project.md @@ -30,7 +30,7 @@ The output file that you specify in the project has no effect on the name that t ### To create a makefile project in Visual Studio -1. From the Visual Studio main menu, choose **File** > **New** > **Project**. +1. From the Visual Studio main menu, choose **File** > **New** > **Project/Solution**. :::image type="content" source="media/file-new-project.png" alt-text="Screenshot of the menu dropdown item to create a new project highlighted"::: diff --git a/docs/build/reference/media/create-project.png b/docs/build/reference/media/create-project.png index 1ab81f0bfbc74852e9ad6724058f8bbeefcc6b4b..e3398e80f7d96dd2a093c524d4cf3533a58d0ebb 100644 GIT binary patch literal 28846 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 CVQ8cP literal 20664 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 jG-_kc9S?av+(VJncVF)*WNotE6g}9 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 diff --git a/docs/build/reference/media/file-new-project.png b/docs/build/reference/media/file-new-project.png index df61ed8476eba4e3b2e0145eced1ef092585915d..d42284e46a53532f81c656e5ecd10cdeb744e8da 100644 GIT binary patch literal 15487 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 literal 13011 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 WuYGbI0)MUmypdLxDwi<)_`d*O8V6DU From b88cde827e72143c94f86eda37ad7dce13bd2a60 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 22 Jan 2026 11:09:26 -0800 Subject: [PATCH 1567/1799] edit --- docs/build-insights/build-performance.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 5152e0d6878..db76bc79f18 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -161,6 +161,10 @@ Or from the Build Insights view: The Improve link is highlighted. :::image-end::: +## Summary + +By combining MSVC Build Insights with GitHub Copilot, you can identify build bottlenecks and apply fixes without manually analyzing trace data or configuring precompiled headers yourself. The workflow handles trace collection, analysis, and code changes in an iterative loop until build times are reduced to your satisfaction. + ## See also [Build Insights function view](/cpp/build-insights/tutorials/build-insights-function-view)\ From fbd01695b88b9aa9350ecb7f868f2f9e49a8e014 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 22 Jan 2026 11:12:25 -0800 Subject: [PATCH 1568/1799] put screenshot back --- docs/build-insights/build-performance.md | 7 ++++++- .../media/build-analysis-complete.png | Bin 0 -> 8173 bytes 2 files changed, 6 insertions(+), 1 deletion(-) create mode 100644 docs/build-insights/media/build-analysis-complete.png diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index db76bc79f18..9c8b02d3936 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -115,7 +115,12 @@ The prompt asks the user to authorize running the command: ls ../src/ in the ter :::image-end::: Choose the level of permission you are comfortable with. If you deny the request, GitHub Copilot can't proceed with the build performance analysis. -Copilot may go through multiple iterations to find the best way to make the build faster. + +Copilot may go through multiple iterations to find the best way to make the build faster. In this chat example, ... + +:::image type="complex" source="./media/build-analysis-complete.png" alt-text="Screenshot of a message in the GitHub Copilot chat window."::: +The message indicates that analysis is complete and the build time improved from 78.6 seconds to 70.5 seconds (8.1 seconds faster, ~10.3% improvement). It indicates there's still room for improvement. +:::image-end::: When the analysis is done, GitHub Copilot displays a summary of the changes and build performance impact for that iteration: diff --git a/docs/build-insights/media/build-analysis-complete.png b/docs/build-insights/media/build-analysis-complete.png new file mode 100644 index 0000000000000000000000000000000000000000..10bd55a02352caef4752fc5807a83412cfd5f838 GIT binary patch literal 8173 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 Date: Thu, 22 Jan 2026 12:38:37 -0800 Subject: [PATCH 1569/1799] Edited build analysis iteration image and text --- docs/build-insights/build-performance.md | 2 +- .../media/build-analysis-complete.png | Bin 8173 -> 8389 bytes 2 files changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 9c8b02d3936..f09150c8063 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -116,7 +116,7 @@ The prompt asks the user to authorize running the command: ls ../src/ in the ter Choose the level of permission you are comfortable with. If you deny the request, GitHub Copilot can't proceed with the build performance analysis. -Copilot may go through multiple iterations to find the best way to make the build faster. In this chat example, ... +Copilot may go through multiple iterations to find the best way to make the build faster. In this chat example, Copilot made its first build performance improvement but recognizes more areas to optimize. :::image type="complex" source="./media/build-analysis-complete.png" alt-text="Screenshot of a message in the GitHub Copilot chat window."::: The message indicates that analysis is complete and the build time improved from 78.6 seconds to 70.5 seconds (8.1 seconds faster, ~10.3% improvement). It indicates there's still room for improvement. diff --git a/docs/build-insights/media/build-analysis-complete.png b/docs/build-insights/media/build-analysis-complete.png index 10bd55a02352caef4752fc5807a83412cfd5f838..18857c6d6231a7f4b884c229b565008042311708 100644 GIT binary patch literal 8389 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 literal 8173 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 Date: Thu, 22 Jan 2026 12:51:23 -0800 Subject: [PATCH 1570/1799] Updates on entry points --- docs/build-insights/build-performance.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index f09150c8063..83e43d3590b 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -140,8 +140,7 @@ The **Build** menu: The Build menu option Run Build Insights is expanded to show Build All, Rebuild All, and Improve Build Performance. The latter is selected. :::image-end::: -Or select a **Improve build performance** prompt in GitHub Copilot chat: - + Select **Improve build performance on Solution** to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project. :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Screenshot of the Copilot chat window."::: The chat window shows a prompt to Improve Build Performance. :::image-end::: @@ -160,12 +159,18 @@ Or use the **Solution** window context menu which you can access by right-clicki Or from the Build Insights view: - Select **Improve** from the Build Insights diagnostics session view to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project, shown previously. This button uses data from the existing build insights trace results. It doesn't do a new analysis until the current changes are processed. + Select **Improve** from the Build Insights diagnostics session view to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project. This button uses data from the existing build insights trace results. It doesn't do a new analysis until the current changes are processed. :::image type="complex" source="./media/insights-improve-button.png" alt-text="Screenshot of the Build Insights view window."::: The Improve link is highlighted. :::image-end::: + The GitHub Copilot chat window is prompted to optimize the build performance of your project, focusing on includes. + + :::image type="complex" source="./media/copilot-improve-includes.png" alt-text="Screenshot of the Build Insights view window."::: + The chat window shows a prompt to Improve Build Performance, focusing on includes. + :::image-end::: + ## Summary By combining MSVC Build Insights with GitHub Copilot, you can identify build bottlenecks and apply fixes without manually analyzing trace data or configuring precompiled headers yourself. The workflow handles trace collection, analysis, and code changes in an iterative loop until build times are reduced to your satisfaction. From 77984edeacc7cd164219dc87fc739fc9090f4f3d Mon Sep 17 00:00:00 2001 From: Eve Silfanus Date: Thu, 22 Jan 2026 13:03:22 -0800 Subject: [PATCH 1571/1799] Fixed alt text and bold Build Insights --- docs/build-insights/build-performance.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 83e43d3590b..d1229bed775 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -166,8 +166,8 @@ Or from the Build Insights view: :::image-end::: The GitHub Copilot chat window is prompted to optimize the build performance of your project, focusing on includes. - - :::image type="complex" source="./media/copilot-improve-includes.png" alt-text="Screenshot of the Build Insights view window."::: + + :::image type="complex" source="./media/copilot-improve-includes.png" alt-text="Screenshot of the Copilot chat window with focusing on includes prompt."::: The chat window shows a prompt to Improve Build Performance, focusing on includes. :::image-end::: From ca17c32bd2f7b9a575df1daee5e88e5944d90568 Mon Sep 17 00:00:00 2001 From: Eve Silfanus Date: Thu, 22 Jan 2026 13:09:44 -0800 Subject: [PATCH 1572/1799] Bold Build Insights --- docs/build-insights/build-performance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index d1229bed775..dcb21393d31 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -157,7 +157,7 @@ Or use the **Solution** window context menu which you can access by right-clicki The chat window shows a prompt to Improve Build Performance. :::image-end::: -Or from the Build Insights view: +Or from the **Build Insights** view: Select **Improve** from the Build Insights diagnostics session view to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project. This button uses data from the existing build insights trace results. It doesn't do a new analysis until the current changes are processed. From 25b836b777c4ce1ca3ab16052b64c7863dcef79e Mon Sep 17 00:00:00 2001 From: Stacy Chambers <102548089+Stacyrch140@users.noreply.github.com> Date: Thu, 22 Jan 2026 17:43:37 -0500 Subject: [PATCH 1573/1799] pencil edit --- docs/build-insights/build-performance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index dcb21393d31..0d5f2b6ce7f 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -52,7 +52,7 @@ To minimize analysis overhead, the template instantiation time collection is off 1. In the **Options** dialog, expand **Build Insights**. 1. Select **Collect Template Instantiation**. -:::image type="complex" source="./media/build-insights-options.png" alt-text="Build Insights settings page in Visual Studio Options with the Collect template instantiation checkbox enabled, displaying trace collection configurations for analysis."::: +:::image type="complex" source="./media/build-insights-options.png" alt-text="Screenshot of the Build Insights settings page in Visual Studio Options with the Collect template instantiation checkbox enabled, displaying trace collection configurations for analysis."::: The dialog shows trace collection settings with the Collect template instantiation checkbox selected. :::image-end::: From 2e82077dcc7783eec12c2a5a833d2e165c24014b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 22 Jan 2026 16:15:46 -0800 Subject: [PATCH 1574/1799] doc new syntax --- docs/ide/include-cleanup-config.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ide/include-cleanup-config.md b/docs/ide/include-cleanup-config.md index 5d4e2813902..13c2f6ffdb0 100644 --- a/docs/ide/include-cleanup-config.md +++ b/docs/ide/include-cleanup-config.md @@ -1,7 +1,7 @@ --- title: "Configure C/C++ Include Cleanup in Visual Studio" description: "Learn how to configure C/C++ Include Cleanup." -ms.date: 10/10/2023 +ms.date: 01/22/2026 ms.topic: "how-to" f1_keywords: ["config include cleanup"] helpviewer_keywords: ["config include cleanup"] @@ -59,7 +59,7 @@ The `.editorconfig` settings that you can use with Include Cleanup are: | `cpp_include_cleanup_excluded_files`

Excludes the specified files from Include Cleanup messages. You won't get a suggestion related to the header at all, whether to add it or that it's unused. | *filename* | `cpp_include_cleanup_excluded_files = vcruntime.h, vcruntime_string.h` | | `cpp_include_cleanup_required_files`

Specify that usage of *file1* requires *file2*. For example, specify that if you use `atlwin.h` that `altbase.h` must also be included. | *file1*:*file2* | `cpp_include_cleanup_required_files = atlwin.h:altbase.h, atlcom.h:altbase.h` | | `cpp_include_cleanup_replacement_files`

Replaces *file1* with *file2* during Include Cleanup processing. For example, you may prefer using `cstdio` over `stdio.h`. If you have a file with both `#include ` and `#include ` and you consume content only from `stdio.h`, with this setting Include Cleanup will tell you to remove `stdio.h` because it replaced the usage of `cstdio` with `stdio.h` during processing. If you don't use the contents from either, Include Cleanup will tell you to remove both.| *file1*:*file2* | `cpp_include_cleanup_replacement_files = stdio.h:cstdio,stdint.h:cstdint` | -| `cpp_include_cleanup_alternate_files`

Don't generate a message for indirect include *file2* if *file1* is included. For example, if you `#include ` and are only using something from its indirectly included header `winerror.h`, Include Cleanup won't prompt to add `winerror.h`. Useful when you prefer to include a facade header file instead of the indirect includes it contains. | *file1*:*file2* | `cpp_include_cleanup_alternate_files = windows.h:winerror.h, windows.h:minwindef.h` | +| `cpp_include_cleanup_alternate_files`

Suppress messages for indirect includes from an umbrella header. For example, if you `#include ` and only use content from its indirectly included headers `winerror.h` or `minwindef.h`, Include Cleanup won't suggest adding them. *| *file1*:*file2*[:*file3*...][,*file4*:*file5*...] | `cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h`
`cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h,umbrella.h:internal.h`| ## See also From 302d37c245d1a1bde5398e9e6cab20535974a830 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 23 Jan 2026 10:46:11 -0800 Subject: [PATCH 1575/1799] Update alt-text for images in makefile project guide --- docs/build/reference/creating-a-makefile-project.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/creating-a-makefile-project.md b/docs/build/reference/creating-a-makefile-project.md index 726dcc60c9d..566ed5e134c 100644 --- a/docs/build/reference/creating-a-makefile-project.md +++ b/docs/build/reference/creating-a-makefile-project.md @@ -32,11 +32,11 @@ The output file that you specify in the project has no effect on the name that t 1. From the Visual Studio main menu, choose **File** > **New** > **Project/Solution**. - :::image type="content" source="media/file-new-project.png" alt-text="Screenshot of the menu dropdown item to create a new project highlighted"::: + :::image type="content" source="media/file-new-project.png" alt-text="Screenshot of the File > New > Project/Solution menu item."::: 1. Type *makefile* into the search box. If you see more than one project template, select the option for your target platform. - :::image type="content" source="media/create-project.png" alt-text="Screenshot of the project template search bar with makefile entered."::: + :::image type="content" source="media/create-project.png" alt-text="Screenshot of the Create a new project dialog. The Create a new project text field text box contains the text: makefile."::: 1. **Windows only**: In the Makefile project **Debug Configuration Settings** page, provide the command, output, clean, and rebuild information for debug and retail builds. Choose **Next** if you want to specify different settings for a Release configuration. From 280a2420de6559391adc9e5bc24af55af04d6586 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 23 Jan 2026 11:05:05 -0800 Subject: [PATCH 1576/1799] add to toc --- docs/build-insights/toc.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/build-insights/toc.yml b/docs/build-insights/toc.yml index d5f07030b96..ac2d35b30c7 100644 --- a/docs/build-insights/toc.yml +++ b/docs/build-insights/toc.yml @@ -6,6 +6,8 @@ items: - name: "Tutorials" expanded: true items: + - name: "Get started with GitHub Copilot build performance for Windows" + href: ../build-insights/tutorials/build-performance.md - name: "Troubleshoot function inlining impact on build time" href: ../build-insights/tutorials/build-insights-function-view.md - name: "Troubleshoot template instantiation impact on build time" From cbb538e97e95058c63106c1ad684def3f082c104 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 23 Jan 2026 11:12:56 -0800 Subject: [PATCH 1577/1799] add to landing page --- docs/build-insights/index.yml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/build-insights/index.yml b/docs/build-insights/index.yml index 5020326898f..b52b5a4595d 100644 --- a/docs/build-insights/index.yml +++ b/docs/build-insights/index.yml @@ -25,6 +25,10 @@ landingContent: url: get-started-with-cpp-build-insights.md - linkListType: tutorial links: + - text: Build performance analysis overview + url: tutorials/build-performance.md + - text: Get started with GitHub Copilot build performance for Windows + url: tutorials/build-performance.md - text: Build Insights function view url: tutorials/build-insights-function-view.md - text: Build Insights included files view From fce5777de2410bb674a83e9e479e4f2a035ac07e Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 23 Jan 2026 11:20:35 -0800 Subject: [PATCH 1578/1799] fix links --- docs/build-insights/index.yml | 4 +--- docs/build-insights/toc.yml | 2 +- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/build-insights/index.yml b/docs/build-insights/index.yml index b52b5a4595d..bf11ccdb5e3 100644 --- a/docs/build-insights/index.yml +++ b/docs/build-insights/index.yml @@ -25,10 +25,8 @@ landingContent: url: get-started-with-cpp-build-insights.md - linkListType: tutorial links: - - text: Build performance analysis overview - url: tutorials/build-performance.md - text: Get started with GitHub Copilot build performance for Windows - url: tutorials/build-performance.md + url: build-performance.md - text: Build Insights function view url: tutorials/build-insights-function-view.md - text: Build Insights included files view diff --git a/docs/build-insights/toc.yml b/docs/build-insights/toc.yml index ac2d35b30c7..f9c51225e1d 100644 --- a/docs/build-insights/toc.yml +++ b/docs/build-insights/toc.yml @@ -7,7 +7,7 @@ items: expanded: true items: - name: "Get started with GitHub Copilot build performance for Windows" - href: ../build-insights/tutorials/build-performance.md + href: ../build-insights/build-performance.md - name: "Troubleshoot function inlining impact on build time" href: ../build-insights/tutorials/build-insights-function-view.md - name: "Troubleshoot template instantiation impact on build time" From f47a9be2d2617f9891d70723ccfb0726b75fee3c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 23 Jan 2026 13:08:33 -0800 Subject: [PATCH 1579/1799] edits --- docs/ide/include-cleanup-config.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ide/include-cleanup-config.md b/docs/ide/include-cleanup-config.md index 13c2f6ffdb0..529170a6d05 100644 --- a/docs/ide/include-cleanup-config.md +++ b/docs/ide/include-cleanup-config.md @@ -1,7 +1,7 @@ --- title: "Configure C/C++ Include Cleanup in Visual Studio" description: "Learn how to configure C/C++ Include Cleanup." -ms.date: 01/22/2026 +ms.date: 01/23/2026 ms.topic: "how-to" f1_keywords: ["config include cleanup"] helpviewer_keywords: ["config include cleanup"] @@ -59,7 +59,7 @@ The `.editorconfig` settings that you can use with Include Cleanup are: | `cpp_include_cleanup_excluded_files`

Excludes the specified files from Include Cleanup messages. You won't get a suggestion related to the header at all, whether to add it or that it's unused. | *filename* | `cpp_include_cleanup_excluded_files = vcruntime.h, vcruntime_string.h` | | `cpp_include_cleanup_required_files`

Specify that usage of *file1* requires *file2*. For example, specify that if you use `atlwin.h` that `altbase.h` must also be included. | *file1*:*file2* | `cpp_include_cleanup_required_files = atlwin.h:altbase.h, atlcom.h:altbase.h` | | `cpp_include_cleanup_replacement_files`

Replaces *file1* with *file2* during Include Cleanup processing. For example, you may prefer using `cstdio` over `stdio.h`. If you have a file with both `#include ` and `#include ` and you consume content only from `stdio.h`, with this setting Include Cleanup will tell you to remove `stdio.h` because it replaced the usage of `cstdio` with `stdio.h` during processing. If you don't use the contents from either, Include Cleanup will tell you to remove both.| *file1*:*file2* | `cpp_include_cleanup_replacement_files = stdio.h:cstdio,stdint.h:cstdint` | -| `cpp_include_cleanup_alternate_files`

Suppress messages for indirect includes from an umbrella header. For example, if you `#include ` and only use content from its indirectly included headers `winerror.h` or `minwindef.h`, Include Cleanup won't suggest adding them. *| *file1*:*file2*[:*file3*...][,*file4*:*file5*...] | `cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h`
`cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h,umbrella.h:internal.h`| +| `cpp_include_cleanup_alternate_files`

Suppress messages for indirect includes. For example, if you `#include ` and only use content from its indirectly included headers `winerror.h` or `minwindef.h`, Include Cleanup won't suggest adding them. *| *file1*:*file2*[:*file3*...][,*file4*:*file5*...] | `cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h`
or
`cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h,umbrella.h:internal.h`| ## See also From f68f380d6e2ad94b83d8780c4bbbf6fb4c800473 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 23 Jan 2026 13:13:51 -0800 Subject: [PATCH 1580/1799] cleanup --- docs/ide/include-cleanup-config.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ide/include-cleanup-config.md b/docs/ide/include-cleanup-config.md index 529170a6d05..0f2b6d59871 100644 --- a/docs/ide/include-cleanup-config.md +++ b/docs/ide/include-cleanup-config.md @@ -59,7 +59,7 @@ The `.editorconfig` settings that you can use with Include Cleanup are: | `cpp_include_cleanup_excluded_files`

Excludes the specified files from Include Cleanup messages. You won't get a suggestion related to the header at all, whether to add it or that it's unused. | *filename* | `cpp_include_cleanup_excluded_files = vcruntime.h, vcruntime_string.h` | | `cpp_include_cleanup_required_files`

Specify that usage of *file1* requires *file2*. For example, specify that if you use `atlwin.h` that `altbase.h` must also be included. | *file1*:*file2* | `cpp_include_cleanup_required_files = atlwin.h:altbase.h, atlcom.h:altbase.h` | | `cpp_include_cleanup_replacement_files`

Replaces *file1* with *file2* during Include Cleanup processing. For example, you may prefer using `cstdio` over `stdio.h`. If you have a file with both `#include ` and `#include ` and you consume content only from `stdio.h`, with this setting Include Cleanup will tell you to remove `stdio.h` because it replaced the usage of `cstdio` with `stdio.h` during processing. If you don't use the contents from either, Include Cleanup will tell you to remove both.| *file1*:*file2* | `cpp_include_cleanup_replacement_files = stdio.h:cstdio,stdint.h:cstdint` | -| `cpp_include_cleanup_alternate_files`

Suppress messages for indirect includes. For example, if you `#include ` and only use content from its indirectly included headers `winerror.h` or `minwindef.h`, Include Cleanup won't suggest adding them. *| *file1*:*file2*[:*file3*...][,*file4*:*file5*...] | `cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h`
or
`cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h,umbrella.h:internal.h`| +| `cpp_include_cleanup_alternate_files`

Suppress messages for indirect includes. For example, if you `#include ` and only use content from its indirectly included headers `winerror.h` or `minwindef.h`, the tool won't suggest adding them. | *file1*:*file2*[:*file3*...][,*file4*:*file5*...] | `cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h`
or
`cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h,umbrella.h:internal.h`| ## See also From 047497ebaacc51e7fc967a3891c1b943edc105ff Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 26 Jan 2026 13:28:48 -0800 Subject: [PATCH 1581/1799] Update docs/build-insights/build-performance.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/build-insights/build-performance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 0d5f2b6ce7f..4cadd179b79 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -71,7 +71,7 @@ To start the GitHub Copilot build performance agent: 1. Select your preferred model in the model drop down menu: :::image type="complex" source="./media/model-select.png" alt-text="Screenshot of the model selection menu in the Copilot Chat window."::: - This dropdown lists models various models like GPT-5, CLaude Sonnet 4, Gemini 3 Pro, and others. + This dropdown lists various models like GPT-5, CLaude Sonnet 4, Gemini 3 Pro, and others. :::image-end::: 1. Instruct GitHub Copilot to improve the build performance of your selected project by typing something like **Help me improve the build performance of this project**. You can add extra context so that GitHub Copilot can better make suggestions to match the needs of your project. From 696e6e4cdeaf9fc908eddeee52cc39538dadce5d Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 26 Jan 2026 13:31:59 -0800 Subject: [PATCH 1582/1799] Update docs/build-insights/build-performance.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/build-insights/build-performance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 4cadd179b79..401e2f82812 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -33,7 +33,7 @@ Verify your GitHub Copilot subscription on GitHub, and then sign in to your GitH 1. Verify your GitHub Copilot subscription by signing in to [https://github.com](https://github.com/). Select your profile picture and then [Copilot settings](https://github.com/settings/copilot/features). Your plan type appears near the top of the page: - :::image type="complex" source="./media/copilot-subscription.png" alt-text="Screenshot of the users GitHub Copilot information."::: + :::image type="complex" source="./media/copilot-subscription.png" alt-text="Screenshot showing the user's GitHub Copilot information."::: The Copilot settings page shows the type of subscription. In this case, the user has GitHub Copilot Enterprise. :::image-end::: 1. In Visual Studio, sign in to your GitHub account: From 4c1acc2817df1131712e54e9139874f679700a15 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 26 Jan 2026 13:32:31 -0800 Subject: [PATCH 1583/1799] Update docs/build-insights/build-performance.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/build-insights/build-performance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 401e2f82812..3523b430d59 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -104,7 +104,7 @@ Choose **Yes**. The Windows User Account Control dialog then appears: The dialog asks for permission for the Windows Command Processor, verified publisher Microsoft, to allow this app to make changes to your device. There are Yes and No buttons. :::image-end::: -Choose **Yes** to grant permission to capture the MSVC compiler traces. Denying the elevated request to cancel the build analysis. +Choose **Yes** to grant permission to capture the MSVC compiler traces. Denying the elevated request cancels the build analysis. ## Guide GitHub Copilot through the process of improving the build time From f207e6aa3cf0b7839402a2f7f434731752dbb201 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 26 Jan 2026 13:33:15 -0800 Subject: [PATCH 1584/1799] Update docs/build-insights/build-performance.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/build-insights/build-performance.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md index 3523b430d59..13a51332376 100644 --- a/docs/build-insights/build-performance.md +++ b/docs/build-insights/build-performance.md @@ -14,7 +14,7 @@ The GitHub Copilot build performance for Windows helps you make your builds fast - Visual Studio 2026 version 18.3 Insiders 4, or later. - MSVC Build Tools version 14.50 or later. -- A MSBuild or CMake project. +- An MSBuild or CMake project. - Windows 10 or later. ### Before you begin  From 6975ddd977131a6e744cd0e774a5c279b41c2b68 Mon Sep 17 00:00:00 2001 From: "Michael B. Price" Date: Tue, 27 Jan 2026 02:52:24 -0600 Subject: [PATCH 1585/1799] Docs for GitHub Copilot app modernization for C++ (#6221) * Documentation for using GitHub Copilot app modernization for C++ features * Adding a link to the GitHub Copilot app modernization for C++ documentation to the porting and upgrading page. * first style pass * edit pass * Minor-ish grammatical changes * Removing line about working in solutions that have mixed languages. The default should be to assume that it does anyways. * Adding some screenshots for enabling and getting started with app modernization. * Attempt to get side-by-side images of the ice breakers for both MSBuild and CMake projects * Bring the link for app modernization down into the upgrade & modernize section instead of it's own section. * Fixing typo in image file name * Addressing several of @TylerMSFT's review comments * Adjusting the ice breaker section to be clearer about the role of each image and why they should be laid out next to each other and fixing the images to be roughly the same size so that they present in a way that isn't too jarring. * Shortening and clarifying the names of the images showing the ice breakers * Renaming file so that ghcp turns into copilot which is a bit less confusing if someone is looking at file names. * Missed one place where the filename needed to be updated * Renaming images to fully spell out modernization * Removing 'public' from 'public preview' and adding a period at the end of a sentence on the same line as one of those changes * Removing the hyphen from 'pre-existing' to make it simply 'preexisting' * Rewording to avoid unnecessary repetition between the first and second sentence. * Removing Insiders descriptor from the requirements section, as it becomes an irrelevant detail in a short period of time. * Adding a link to the documentation for the new retarget projects experience. --------- Co-authored-by: TylerMSFT --- docs/porting/copilot-app-modernization-cpp.md | 100 ++++++++++++++++++ .../app-modernization-cmake-ice-breaker.png | Bin 0 -> 192513 bytes .../app-modernization-msbuild-ice-breaker.png | Bin 0 -> 92370 bytes ...copilot-app-modernization-context-menu.png | Bin 0 -> 50329 bytes .../enable-copilot-app-modernization-cpp.png | Bin 0 -> 59288 bytes docs/porting/toc.yml | 2 + .../visual-cpp-porting-and-upgrading-guide.md | 1 + 7 files changed, 103 insertions(+) create mode 100644 docs/porting/copilot-app-modernization-cpp.md create mode 100644 docs/porting/media/app-modernization-cmake-ice-breaker.png create mode 100644 docs/porting/media/app-modernization-msbuild-ice-breaker.png create mode 100644 docs/porting/media/copilot-app-modernization-context-menu.png create mode 100644 docs/porting/media/enable-copilot-app-modernization-cpp.png diff --git a/docs/porting/copilot-app-modernization-cpp.md b/docs/porting/copilot-app-modernization-cpp.md new file mode 100644 index 00000000000..baf39363b46 --- /dev/null +++ b/docs/porting/copilot-app-modernization-cpp.md @@ -0,0 +1,100 @@ +--- +title: "Modernize your C++ project with GitHub Copilot app modernization" +description: "Instructions on effectively using GitHub Copilot app modernization in your C++ projects" +ms.date: 01/23/2026 +ms.topic: upgrade-and-migration-article +author: michaelbprice +ms.author: miprice +--- + +# Using GitHub Copilot app modernization for C++ + +GitHub Copilot app modernization for C++ helps you upgrade C++ projects to newer MSVC Build Tools versions. If necessary, Copilot will upgrade your project's settings to use the latest MSVC, and then conduct a thorough assessment of the impact of those changes after executing a build. It develops a plan on how to address each identified problem. Once you approve the plan, the agent completes a sequence of tasks and validates that any changes resolved the identified problems. If there remains work to be done, the agent continues iterating until the problems are resolved or you discontinue the conversation. + +> [!NOTE] +> GitHub Copilot app modernization for C++ is currently in preview. + +## Requirements + +- Visual Studio 2026 version 18.3 or later +- A GitHub Copilot account +- A MSBuild-based codebase (`.sln`, `.vcxproj`) OR a CMake-based codebase + +## Enable GitHub Copilot app modernization for C++ + +GitHub Copilot app modernization for C++ is enabled by default. To disable or explicitly enable the feature, follow these steps. + +1. From Visual Studio, select **Tools > Options...** to open the **Options** window. +1. Navigate to **All Settings > GitHub > Copilot > C/C++**. +1. Select (to enable) or clear (to disable) the checkbox for **Enable GitHub Copilot app modernization for C++ (preview)**. +1. Restart Visual Studio for the setting change to take effect. + +![Screenshot of the settings to enable GitHub Copilot app modernization for C++.](media/enable-copilot-app-modernization-cpp.png "enable GitHub Copilot app modernization for C++") + +## Upgrade your codebase by using GitHub Copilot app modernization for C++ + +This section describes how to start the Modernize agent and the stages it goes through to upgrade your codebase. + +### Start the Modernize agent + +GitHub Copilot app modernization is an agent that operates inside the GitHub Copilot Chat window. You can start the agent in any of the following ways: + +- **From the Solution Explorer context menu**: Right-click on the solution or a loaded project in the Solution Explorer, and choose **Modernize** from the context menu. This automatically launches a GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. + +![Screenshot of the context menu to start GitHub Copilot app modernization.](media/copilot-app-modernization-context-menu.png "Start GitHub Copilot app modernization") + +- **From GitHub Copilot Chat**: Open the GitHub Copilot Chat Window by selecting **View > GitHub Copilot Chat**. After the GitHub Copilot Chat window opens, mention `@Modernize` in a prompt to activate the Modernize agent. For example, type this prompt: + + `Use @Modernize to update MSVC Build Tools.` + +#### For MSBuild-based codebases targeting an earlier version of MSVC Build Tools + +The first time that you load a `.vcxproj` project that targets an earlier version of the MSVC Build Tools, you see an option to [upgrade project settings to use a newer version of the MSVC Build Tools](https://learn.microsoft.com/visualstudio/install/setup-assistant). If you retarget any of your projects to a new version of MSVC Build Tools and GitHub Copilot app modernization for C++ is enabled, you receive an infobar in Visual Studio prompting you to use GitHub Copilot app modernization for C++ to resolve any newly introduced build problems. Selecting **Run GitHub Copilot app modernization for C++** launches the GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. + +### Start the upgrade + +Once the Modernize agent is active, you can instruct it via a prompt to upgrade your MSVC Build Tools, or select the already constructed prompt from the list shown in the window. If you launched the agent directly in the GitHub Copilot Chat window by mentioning @Modernize in your prompt, you probably don't need to provide any additional prompting. + +:::row::: +:::column::: + +**MSBuild Projects** + +:::column-end::: +:::column::: + +**CMake Projects** + +:::column-end::: +:::row-end::: +:::row::: +:::column::: + +![Screenshot of GitHub Copilot app modernization window with MSVC upgrade ice breaker for an MSBuild project.](media/app-modernization-msbuild-ice-breaker.png "GitHub Copilot app modernization window") + +:::column-end::: +:::column::: + +![Screenshot of GitHub Copilot app modernization window with MSVC upgrade ice breaker for a CMake project.](media/app-modernization-cmake-ice-breaker.png "GitHub Copilot app modernization window") + +:::column-end::: +:::row-end::: + + +### Assessment stage + +The agent first assesses what kinds of problems show up after upgrading. If you didn't already upgrade the project, the agent guides you through that process before creating its assessment. After ensuring that your project is upgraded, the agent builds your codebase, analyzes the reported warnings and errors, and generates an `assessment.md` file that describes the problems that it found, their severity, and other useful information. This is your opportunity to tell the agent any additional context that could help it make a plan. + +One of the things you might choose to do here is to tell the agent not to fix certain discovered problems, because you know that resolving them involves some strategic decisions or because they were preexisting warnings that you decided are acceptable for your project. You should carefully read through the plan, making sure to provide that additional context where it is needed. Once you approve the assessment, the agent moves on to creating a concrete plan on addressing the problems. + +### Planning stage + +Based on the approved assessment and any additional context or instructions you provide, the agent creates a `plan.md` file that proposes a detailed plan for resolving each of the identified problems. If the agent produces a plan that doesn't match your organization's coding style or practices, you can provide that guidance to the agent and have it solve the problem differently. After you agree on the plan, the agent moves to the execution stage. + +### Execution stage + +Now that the agent has a plan, it breaks down the necessary tasks to execute the plan. You can define these tasks as finely as you want. The tasks can even include steps to work on a branch or to commit specific changes together in the same commit. After making any changes, the agent builds the project again to confirm that the problems are resolved. If the problems aren't resolved, the agent iterates with you until they're resolved to your satisfaction. + +### Post-upgrade validation + +When the agent finishes, run the changes through any testing infrastructure you have. Have a colleague review the changes in a pull request. Since this feature is currently in preview, you might receive an infobar to complete a product survey to let the product team know how the agent performed on your codebase. The product team looks forward to hearing how they can improve the agent to solve your problems and accelerate your upgrade and modernization efforts. \ No newline at end of file diff --git a/docs/porting/media/app-modernization-cmake-ice-breaker.png b/docs/porting/media/app-modernization-cmake-ice-breaker.png new file mode 100644 index 0000000000000000000000000000000000000000..676e21dbbc5e7b204abde61935b42eb3a037dae2 GIT binary patch literal 192513 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

3M_GMeyLFDdSl=?oSNIF|MkYgDOkYB)gPY{Bb6 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 R{3in=E2St|CjK_?{{dNl$9ez& literal 0 HcmV?d00001 diff --git a/docs/porting/media/app-modernization-msbuild-ice-breaker.png b/docs/porting/media/app-modernization-msbuild-ice-breaker.png new file mode 100644 index 0000000000000000000000000000000000000000..0820fec37c113236d2a5a409e671bd15cd57f3a2 GIT binary patch literal 92370 zcmeFZbySsY)Hiqx6hRbeK|}?YMF}LLp!?1ee7J1#MCJ(sQ5=eUqK5^auh~4;utOkjG-3WO z5Hm=5!k4$v;_7H6Yh$#do~;o=UeC-5%_b|Ze2<%rgN=hD0Gp&6cB(Q`mo%1?WI|xW z2P_2n1uVn`cqava6#wxaZU@0|;nLslF*n3<;UeM|ylTRqneXMl-&??Y%(m@t0kL@L ze}DZyUKK`$K!jaIT!wuga&kSq@bTaCVy=nx@!xYr!+Xqj5zc(^@1BZ$kKx^a9L4eQ zA?8=@HNB&2i=S!{h_gD$r%#mM=&X*LXcJ0ay0S@~;xlnM1DAHfsnNU<8r%LR)&esg)lU)}~NJ{84Er=iDZ20D@hPV`O=R-s`Bd_U6Jaia z@XoG`3e1#x+WK`34*cZc;>wvf9Qx8*AVfW@u=tN}&mR*LlfL+X)U=f7=s%u!eObQ0 zqR)Ez%e81-`nNgK9mg7TO$4!DPO(ya<_=Tr;7Jm>+wb2~d3k7OTxyF;mo9xdH#Ie_ z`gvPBSF@*0u9AK7LsHT$_7YaiamtTIMBY!j*X89JSSe)`XZrlfs=~h;Dq*cGN=wc^ z%wx9E@OXabbjqc3XM2va;P0Hxjr1go%rppcbD(WXHp0Tlj)dr@Qy zi@)ndJh?xR{li8?NS2NnSFNT%RPPbG%vu85>F`h4b0N&hPMCzB>e72DJFY%eBVq{h zQDIrWg?z6h5--J1r&j*sL-IH>RXQ(26A#jytMIF*E|$pBmQwOl z?_T*B16l0p?Eswz6qvIz-FNSs$rAR*N&71$C-eW;VselC?_FN%#m5{(=I4WX`7HVf zR?t&dcjjBL%l`U!gPRLayv$G(8&CXrjuO3=mR1e&R&;bUs@8$kfB)@Y!E5Ba;X5-k zV>jCt{xer?W4L(cU~5JtSE`=$Ipg9$PJcA3R(G<<#{B%Vq4w6UuC?vC&UhY6a!x~R zl$yog%Wg7{l^6xuVCQO8u7}e|bUdW=@%6Q<*1q9e>bRjp*Ow9>KQ>YC!guFJOsCu4 zGBFAT$8}_L@lJKc^IBh=A51ZKXLsAL%lWwGDTj}k;^jau{(#FWdK()X=c*Nwu(MNA ziMVT*nf5O9B=gGM(y9*hc`-WN zA5-AT>D>dijp>fL`HIzeO>c(R=J5^KNn3Sk^W<gQ~G#M}$tdYAnq zL8lV<3>R`-|K)Uc;^d60!VqQJhVJzX592yIDsjwb*1A*vxQE4^4{4-Y~h9p~ksR(VW=Pw~PZ!&7_H7ofzUo`-$y!3qH zffv5*@nmUJOJneT&Aji*o;?|LJd_ATWH34RtLH16MA-~WMFVi?v#lY^`>0+YTJUE~!f3Na-(A6b7IH^2 zMoQ1vn8$pOMM+7iCRMpj);A*oSDK0Z&-m9KZ@BxwWn+GU6hA!on{NA?UxV+kUP=9d zh8r8o(Wqh)6O#Rd{JWo6H$ zeKV4Ar5})!oTyIfsMm}?B39F@iS;K@x(?I-@iL2cmCeECv_#0Aa4yQY*jP$FTf<*f zuR)kHSERx-GK|j8PAjb^?~;)*Y<1*W)YR0V6&U$F&Q5&rD5|szKmeM&amRmQHWD^% zQzN66Ia^+fVR`=QBHC2F#Oj&Y$z@6@`)T>oVBGn5&X_DqiGyno5>FFZwR%Hhj2%f8L-n6eWK_jcaUp&i*?B|6E^^8dL^Er! z@T4(psQX^Z`I;(8=(Zm3lVa!AP^zq4Y476Vt*X~EuCA`p?79;vVplCKEuC@s(layr z#50)h-Fx{h==R&6MOZ7EJs&t|?%ng8sARV~E4O-iKE0|b)j(?kC zg=Hae;7@lYCtytfgaNsBAzbi0UUfAw=F?*ry2{@?l)95b`U0b`GSb~5x07IB;>LQA zXku&YjYI**?f&UZnRs$us~6S^A79UW16%NWp$UGlny8DNNS$3;Svfv9c#$kT-q8_I z5TT{7|2v9VZLv?06d(VdI-XWhfxX#$6M>)4PfF!Y16Hrte8q<;8gKrXIgzOkT82(y zYn`q7Uc^!=gcBQv z|CGGcSI&)6)D)d%<0(91=CxZ$1au>Pysp!J4x zpkjD@yt$c~WDL`NYHGb^zgrp_8t4{l$(G(CS#B33HnqY=)LF4=(q_4Uq;kXW#5KQL z`OU^6UioXv_+*;F>@{3Dk69mlxa{IWohZ;W=)i|l!qrAFe_N{SOIkY33w$rR!vj!%)b_slg<)%(6t*w_eVMmXuwnF9V7T1N@* z{KWR=hs8l+&;8e2U+;g49G_qwyrO5mzujN##vOhITdP*JNdTwT_1&cQjh{M*&7UtS+u{WJJEi#yV%Rw_Ij&v{^>36rkNXH z+_Rb!%;zHIAEh5@;XJGyc-dC_%f6bJ@Gyjp3IC690R9plwd^_`Zks)y$~UWQ+XY-= z$HGX3pses-?2>DH9=Waw7ZIXPrN&+4?)D{4vG1dC52ZvXKRqUYUwY0NLDuo5 zr70jqS@VT4y-qCSx=xf-Kk;I%M7D?go7K0=t&Cs+q~9`k&MotoJbZQIDoWJ!l`mCggRK*8vH6z@D4XKZDiCHjuqBO&P z#uS^^mOXKO>;2aeo1I!Pe6XGK-(!_-9OKe;Pk*f7b5ZR>?3B>RvCT4fp|iJ5)gON; zSC^iN;&0!1jZ2~ujeO;(@}%m$VCO%nhJhT_Z4S*;id4!)#{`aI+yZjU>pG0j+B20B zg6N21L6|1RL`6Lt8%0o>gNEOy@hx`FPLH>XvdcYBs>2Eg`cjtDsIO^_<-9Z#yuHH8 zEb&Y&rsVR@>z2}#m)^oTw2o@T6T@mpk5GDV_q2)3Ii4iPM$%oxbKA7mTONGNfq`c;I5EB=WQ*bDZJn@S%=NISb9Feb&0I;$}@r0J@zElJFYk9xo z;^LRC)8IRr7i=~cSWJwJPIr1lnpBM1`uY^V33ontBXRPxC|4!-nYDri9U-3hx(oFd z4;_-(y^S|jX0eZY=kkr+2OUhSP6QJQjkhYmRhmqEtRx|@Yqp!VTwWudpqBlzWh!3& zq1mh$?8&67EOsdc?3JSxgl6{Q|Pfx^`SHqU0WhuFV`RS?DdhW#; zJyS$4wj*8puX7;l#k|7wStRNId0sIU$oHGE$M9V#Ve{maW${=}d!QM|ZCv4iLM2MT z3kPgOtKO@Q_ogjL4Hm>1%GFv9{i4kHy`P)1YzbTlVCepPH|ZG}tXdU$jvEu4oP+xt zlYuqZ>Yu=WR9lRc+@g8bHf%C-@#4iRH||t{O3t)~_S?5)8e3X+oe$;tr+DF8C(rLb z*fgKkWsDiL$AIZZp2C!UY-$RJ+CE~hNSngHz*(8$f5yZJ#FhUd>iRl)qx9lE)dEZ` z#=+$0BjRy3Yg-Nf)0r`l`XiFj>JdOilV{Jq0TAKh`I~%^UNXI1%UHyFDTQe~teC>yiE&U;f_&4*%t$m>~A7(OBj> zo!6V=M_Ih#UR}ne>MT6*`6($+hG05AZ_u){hjz|wzY%1Mksf+-IK#brm)h{Fm0HbP zd?RPP5epvQuhTYmt8wqCk`iJ4bK;nbz4+CbsAu-ew9UZ4z@lO{_H3}v^71lEbR7lE z^k?fE#VK#!?;D8y!AQp;HMy$%wz~z{Blv*W7PHO%2)nCiUBR3}?PT`lvZz6q?-)h-Z-@nepk3{iUL^{LG{Wryp!TOR6=77ay)4 zb!DTozZzQ?j^&{;m_ll!`o+D?2A$oiumMIkb=#8Z; zLPdT41$VjQkhO84Iet`ZbX<(u4ZD;8xB`KY^DY^O{?jcxYU<{}L5I(t7sPyTWMI_m zBa*}ZQ4X&$p-til*_iS{{Ibtfc^A%__4Z?K+7T@Zk=SKbJRc8GUu3q&8jG|j@ z>s_EE4*~8%cVc{OET6^j!y1S|5FH_@^*;7jYbz3_Wn&0RzIMgqZ?_V%*SrlQrAMBR zp(`~?jbVHQY@z=C{y{;4Zb!QiS$KC!`%dw5QqwYVS;D+XR*QJ?e&Dx%Rj5<%B~4oc zL3FBk;9{RXb7;NK$yw9y1tju0cx39QYHBeB2s%@K2l9t6MfXSV)Id1?v03GlnJg)B zOI{`)HSPWTZ<#8~%Pq%i_6GB{q#GBWzi~}D$RiTQ#jTE>DlRKa50ugw*(FaBa16ok z%aWt2K{9@FtC)=I^&~v+wh0g!sLk3psVR6ma#Kg3H_B^0$>n}P0n>#z%6Zm}mmh3i zuSXxFiTxPHA;NX%3;08RW19kGx#@f#76<9}b&(aD+DqAT<{p{jhvcZn+BsooTqG>7 zW~G&oVH-YAybw$Qpw51+$m_2rB%O7VUj9mXGpVP+2xFb|?X2sJVb^VNMXSf|N0^mq z+HFDPAH!Z?rZP*OlAtGn`R#DKTI7SaZm-53`FH`43TZA;-N#FURVK9#YezRt#nn8s z70t1(Bx&*WUG&U2e4TW4l7tb9gYKXjfq1^TXPG)RIbMlAobe|;7jgHW z^0=C`OJwoqRP6oKIelZRT7j=O1*Y}zE-7GE}bqP!xh=J@OZf+ z%VjGD#W;J5H$V?OI1VIwdzo$zb3?mxbEGxd3|o4-OZTZE0QSPCOjOi7laFW#>FOp( z4*f3YTiCDoNS*keqlzbrh2tA#o#t}HNf!N?G<9>q0>hB)53HEOErSOf795}6k)V`5 zyH9=Aq~)D=W1@a4W6REuO;!%}k;eEEU}1uD!6Y^&sU}=+Dn;8f9Je3G?jM`&U%j{W z2zujcZqtT$b}pO9&#iugSvButa`x=$x85Hg_olubd3hxW+0E(TP)D5)Rr1tJ-adG< zsYuXk{n)Bb2=#Tyc6;+v-mj^zDQKWvJl`63Ctw0C3>APR^8E_x*98b^5l2ND`Y=P9XEb?@TIKCxgO;h57#xu ztLvhO3j?XCsp+qho0E+V-xMUfZ{y@ZG*SBE=yklZ>0mVGus7LE{bC|Eo+j7*>a6;2a-D}!Y1y=g_h}R)l))SBDlRh z-U_>0_x2ZL!G+BvPt*k8R1^-koo?b=J@$vKXSp6Cv8`FBmKWpbx93deuCiXs#9qC~V{asTc{lXEizDG&SM zx1}+!usrGWW&-_#MiG8#jZ}%O^+j%po9NRH^yb8M8P2uJ{*BGPC*>`iq+?D~ePR;6 z3&iLvB9cGW%6c~zM|<(o1$oy>d%lIC^(T%)&;9e)mGeE+w6|D`jUs3APHu0X}WfSYDT2=Nu`Xtd*>_ciIsXe!P?%dH`$kryY731rT@@^ zlR1hQ-a__$wce?$CZy(2Bt%{(-%YOU>9N+>X(GAizA0IFuFyy$?fZz3%C{qj%do3` zPem77N2|17^^3W5>v@puiP3(;lz0-YdhnJ&wG-zKxxz%J8%>Gd_=n(A+~m$x59Z98 zu-(n^e$~KTlCk{{m4!v9cT}#5))mT&)d!C#1!P8D`>Zui544&#Ivrbg9d;#?);KLE zyZH;>zJpCH)h=68SUlvaldxl{v0LWG=FZqaIH_}lQ`3~z*4}X?!?5T-ARpeRr~8v& z;YunilSMolN=vy=GJd6{I|0PZz==Ap4Cd2GNB{UqcaN8b*Jf*PHS#`*Q+rRxO-+)7 zyX@0_tVD!kpFOW#TF0x$rVbUm`6C`5iQU^ruoA%FbK%kze59+J+Y(L&!;ZzDw3wj0 zuZPZhTRvCYMXt36{9JmRUK}24wptu$U5y-D;w67n)X?BlExk8e8qZTOIYUYW8~Su< zL78x9zWmi-ejNJex&0MtFMP|GhOcq)MR?`|zjekd^iI1Y&aYs>CKPm3pj#@Q7`K;T zSD5S;cYpU+>Tt-oM0xIe3iodM&DZFk|J0igkEWx9j}y*+dEq021Xy(XhIsat`;63n z+f(3?tLr9HxF1bX&NGhKKd{o7Udq1hZrdM%(%MhP#ldVx?1CIhmB#%ftQ5+}e>O5~ z9u$n+L{++fOj9j8KfYpNY13=BlaH&5yT_E` zc`bf9tm5n>Xphaaj*sW1o>d=hU8VLSD<_-NP(qCjuFkAy;8rBpkrSc!XF{8JIC3-H zCSCfk%x~RH+xs;-RBUJ4i_Pa0dRs_4<7?HrisZIiaw)q9e$(k2-^OFCb)y=zwOT6+ zx9LnB>&=M6o4pQZFW;OuwHshbjb>;dUzN?(TM|nrk+6g*(AA;%z~F`@QC>uT3iNa?M00IV`(SXX~8D z9~YD*78(;Na7MWot)9O3QOb4hX2a?c|Ip)H*4bm?%ZnS*UVBTDTsB{;YKYg}N%%2O zDE6rCkj_HOym;XL0oG+KA-^udW9_G*zHf)3Yy{g*t0^4StIVE|uAFQtX;p0esyNqv zDG%F^;LY^i;YtOw?F|tG10!tw{G$T{We}dv&(CvkaQORs+j*G}=JC0o96$zSqQ>5Q zvcV0q9E46qcWmwKmhSVVw`TYrH*yzoKFndV?Ltn0?+lDMm&A@5mP1l-=wGIWL=Fw` zn0etVWXQJq)(JEgb)$7*ib~;nrk5-3pYzW%q_jy5cf_%CjoFU|$3b9snZ+%2oQrH8 zUt<50Ir&YDz53}`OKITZLqv$oa*FuziS9M$EP{>Xu~j#bz@ksiyYD&O<-d;%c$>TbzV=^SmXuSguG)4uh5LQGilrB zM;r#IQXNViTiO7lKEvfIelOFqINq%MjHAx{oo>aiW{)h}yy=i@QhiA}zpA3YqubOc|mysgLa{$@xq3Gx)0; z^^as5r7}<-5)m zuYI~j*C(8`v@6ZswIbNLe-0Y&w2aZN^ksS|<^0$cTHJO)s{bip6R%jfV!d-LWp8LW zUX33ur%qD-s-1%*7$5m2`HyvDeCuy?;-FF}V_!Ds$J}eo`z=Y0xceH|wdVWIajy=k zC$17Mt$5Z2`DTf6`o+mC2$Or^H@*7Zs~Imou|7s9o>5h2y{{X%JC)0~x7@53ZXKF* znrFfO{YYY!6ge!*{egSsQ2+dNAtF6-rUCbmp+t?3qfj54+QOc1^qtZ0>&}0YNJJVb zDa#l2e17!ra4LQ{T~PkL5fvpIh~K10THB_3Id}rK#{K-+l)mY z5jCCJh$0sE$~(F``s&KUaMC3W@AKQQMT8GbEol1UqJA5c`p4;&$6;yBKV6S^d&IAs z)#{_sopx?&@PV}W^yZe^jQ5+3;B?`&U-W+mm{OX%X+lY{9cMtd{a)q0z7lrtCsidw zv|01q=Z&UwIi<}vQw?~x#zl_oc$ddVykxf56Y=l`UL6ws@<7P<0cAH>fTAEKo?BmU zKrbl*u)g8TWjXrD(Q!XJJG}ZoFC<>j`JQN{hS1DZds5~F;9m^lx6pL z;p-c*ml#hBsXr0XPN@q`-nm8{wK}^>N8@$k$p6^CwV*eq`lh$WLW|G~$m?gYJ zmQ@yP>bl`j0`@}jW@AERkj3gX>gLZA0r*Jaox&l1sdL(rE1u6(n0ct1>n3GIM$x25 zzqq6}qTs^b_s4(eD*Rmmu(2hMCB)ouwphR6JYpofwtf<7b#%ixE1FyB)wHbug#q%p zLtb-)%tULCHqy^~(In>&Bp*jyo@vepshnza;mFB93=lLLbr?9I0#&Lmog zaf1tqsGX>2-3A@fZuYS+@qSCfPc1N~JyG{>^}-hq_3aUNT@M+of$2L|jJd03bACb8 zNm5c$M@L6NLE+DzKNAxZ0C#iL3U!o~BV%IJ6yN7@XGmX+@474O`WU6z+s1cQgXg|QdB!*3G`(2xOeKSIOSuOU|Y`fFL+4EJ)MTz7eW1NZ&8GYgb*F+>6Nep^W8fu{# zjC(UrTEKX`r=z1|)vgK?VfGf;Fr04khJ>oeZQJfA(QCYMDR(F+q_JPy*`+ZPElf>` zVz+m9XELYvE(sLh@(qjea0#Gr=l3sqG5RNKBVTJovuRa7H#!)bde$zoZNq`i{MwEc zpCyG^`=UyOAE}G8%a=Ew_zACSMyy_)xSAev>6qZu8^5WffN9G)Got(kH7&hRF!sJf zfXuT8PbV`=HqSYQj91w!UFit!QmJ0lEchk(*+0T{)O^I~$ezVVW((~&;C#6MQm$v( zZlB}WP9UUVktt?TZt@y6|DZmXg`}RGhH;ITyFkmP2+jNRvpYY7f&%5dk5*UfN%lV> z-^*<{OYTy1#nLY|jQXhZpl?y9iy0^(pLb+2C?06!wrFSQ2FaP`{dSKpf%9+VpQ*w{kw_07$t)fi-#_5H+6t*_?UQQ;46S5J^-z`r?(+=?3js(s_iDKlEBe!cSHe#J zm@q4qe{VH8k4TcOQe&&1y|wpEC#^-b++c}&X;M9ORvc^7`g&`iGjR(|bB@-6l>Ua< zOBdAi+hkp_uXfjp&ysyFo#s6aHlQuZ4=^L+)hW)b7iOPp%EP<0`&bT{XU=DaPjI+V z?w6e{H+iVmJL0qVNos=5-aeMn-)W)1?MQN$|BO%6;#8tSFJ8xfz+=9l>WEz_)y5+Y zv2Q=`FsU%9h+oUpX(9ox$owhkI*yK`gISrO_-8tf( zZ+dzIik(wRm1+f8QQ&#$bw%ykf-CE{h| zXjgAT8t~O1QBYS5i-5rKw_u9nKWk~sv|KBbT}ffPtyz~A$${QUX4jUz@Ac@eXg;H9 zpW9ZIaMxuc>st-G%yBq|l-|T+uj-bRVROn<{ z&&&ty`(E4>c&xB}>Qc&CicNi`Apf$ETS($F_B93nb?)!7J@>uTc`aW-P-$k42&TO|)?)6xxg`xTCmtD(bzGAPikRxAQ>Ei7t{naRDGv)}U*VH4 zLCnYjbC-v$MFIO%2qvHYEIGUCU(;WG_m_W4tEo+k2ppD`mqQJYpiu`AvaKbMbm>)? z>~D4>|IW_NF`%!3Tg0MMj?vp&{t0BUxuGEu1x4+ft>2MEODh+c-l9wl*B>Ps>_VOP#%9sj0+h zccdKpglm4FU@}%iRlKtxr$x$NsB&$}{vQc-q(bZ$WhQ?U>88;bUY01<9-LeXKx$U4w ziOoMRxtt^g@2VTyYcVwV%19s81gO zWU*7x{d7ytF4Hgx^odW1cl8 zTL67ar|_ZB?rfjJ40}AubzJ+>6W1U8cE8B4nSVB_uPrkE^@Aoa`g^8~C8zAo{X50V zea;@XZ8eqCiUjR=6R&0d{8B(-OS;#^rt;A9=lE6&fn3k)+*7aC;_#E9 zbBnXDcH2wVqapdRcq?@YD~GMoW8eAPkpvr5TKpaG(^JAB9;}|xLH;-CSqs-ycGD$a za#*~wHi5;L;rTjA@}=z+LfQvOYe*?r!NX{wL}$!+^(F@IY0*w_xGO*p302( z@@0^gA+kw>S)+9;sRf#2VflP;YNpM=^bCtj|my67N7wOT!^ z(;!3mrL)RpV{3Q!*TH*yB#Y15u#EBB z)+Y7K1vGrUug=qTxps&}Kjh`4a{W0%p5u;ygT>MAlAfMk-#o#G_;?7LwVttk@9KgA zleMG06{s>38;S}D5D?Rlv5{`pAQZbsJt5q+Bm+#};)?VKzZB$&&R1c#BPc)AYx25g z!E+3Wo3Tpkg)JiTp#oc#IyN0LmBX*|vhQSxxy62(e)jh;dE7#^Jl=oIg}V9?Nq)Z5 zP~OLSdJ-mUKG6>)xO2~)YrM)QBk}LtVfkggxVTsal`VvX5g$H$SnAKBr{}6{zsTo= zS1*A*QZyD-a4-GW9{COON2Y!0l5lazzCrqcbwwLf>pCY5DX&V)F=KuGZAeG^6Vl%& z{iN;W?{ji{8`5G6w$-p?{7&1n^_W`jlZhIKwVGEynJ6g}KY#ul%VlzQKy7=IUEY72 z0B?VF1WHt(^l~Ckz4$%@gI@upLOmzPvK7*Rvu`&p4W$&QfO;8iO&01oI`U`Fp0TMH zz5MbP3zD{IOp5m8n@*#<4EAjv3$mEbaiDZl#C#W7MeRGJAF&jcOitq7xZzI5YLri* zSIt3 ze0_X|@vgz85VY-`onO^IZ%cA>MOJG^})EXKeUSiVq;+-8G$U;4=4ADoB-LJ0J-@lH@|Kh(-P7Y=J z8XygIBbY+0_KuFG1w8oSca^r4s;a7k0}tu~v9Eq_*m(|AKf|^#Kd*0vNk?zKsr&Uy z+g(ufTtS?Eqvmh@?Ix~#*MGe06vLF_{+Ai`|0wqUUrEOQ_o4sK3OoMS%N_oEhW~qp z|9??;^WTE_|G6LzMB@Km>ra@tjQHqkP^|9b;}a4R!u@K%#>QsK<}nl# z9UUFL^)P+)3JSKqwfx;$F&or~^Rcn9v9bocv$ZTOE~;y4swG3?yex*-q}1>+T^Pg!@m&Sl z)wcD{d!K+=f^rBb)7MZ}FH#RcT>~E>sMk_4G;2?hc zWf)zb76Tm@*ACSF(90&gIoQ+-KMd+JR?AhjocjC^B|lpJ{w=BIIoq_fv~$Smef;ws&?!+)v&>JofpssJH;<1;nfuX80d+a&mlqTYsd8=a#+}wMBM15~kg#-kot{@Nr5)O|HDagn+&*vt71mbT$ z-bK`3Lx^hp7#sv{eD8NlAb_bfsB}_`xqib}sZd7<`auByKmq+WuFQ)US8m=F1R_;h zTKeb$otT!^SW8O=FIqZpoCZ>Si2P;xi0i4lNtNTqsyM#el7Yx^EB+B zsFv`-i=vVes9+%rY=N97Y@tCxCx6zUJZYpz?MS!rov)|yS%@$fLP3lP%=kQ7I| z*M?#)h|+cG#R0_erfAzhD=(a}EpjKCKCa*Gk$ zp#qfA2V5+;hpX4grsn1{va%$gb}t*Vl98lPnJ47(CxO>mCw2iTY;SK5^E3~|;kvq* zK>E2a5YU+W)P^ZtpQt~EYGNjpPfv#~P-A}L$NaQfte&TuuL+H2P{7h_fA1+A3gtLy z5}|Cl3Ll^f84!_Y39yN<%vYldwGTi{Kqs18TXSc1+HpY4=O^In&04d+#Sa)t)&%T5FzL8?(XV(0`*9s5C-~~4HONezqF*pi?_eO zKUcH-6=)O4x)!Wo&S)REC9g8IKJQ@4^zxB?|+3Mwj0QLvUB{jSc7&DZ36sSxHbsgL}Sac^n8siBTsg zJEQYIkEyArr@p*v4WUef(zt;80_6HAF$9A&7$8`g)room6g3L83uq81L~Ydj>SI1s zApZ2Jp|NovMf>i~LQiC5q(taladB~w-LB?luL-0uKw402^+tC$Lqpn_&Wv26j;^j# z2q4~Fz1a<28!LmXP=yL(XJut|7GT`n-F@`vk+Azow)}%Dh|hp!;lVLfE3% zn3!IH>Jrk+UcY|*dt2MbT;lMU7)OXpXe2@yc<($E5jlr|3Di<`eflEE0YqZbF>Hws z^^jmy-Q9)jy@?=xwCc~qgMv5z5f^CQs`iO1coF45#hnkY2;v!ClP4zD*U4!mF52z-veWv5)b_%l?HENl7VTu>i zQEBw8qvI0KfZ zSy@?IV>RI~tEhl-HcZ*6{B`l<@Cyhjzx;g5M1K24MM-EMDYai2{P2OSCUqF11Pcp` zr%x}VsFkFoI$-F^KaChzgoI9iRolT@%x%4au1jEs)zsQAwO>F)zQf#_n1n=YZ?8g9 zZhLQU?~^A_AhUq>4uER9IZz37&Wmf;u7U7mNvqJ((aklUpW$A+mcrb;xV+5I#}^fG zjC1jG;RWdX>v$H$qyiMjlbC>M+v-p%kp|~ICR7SPnAqoXa#_-trS1aWURq@V=I#9K zxKJ>6S{eKd=mwe*N;)xGYe7a%-eFfe3vvwpBInhF|5H9bz5rnl2ZxGOGev4xM(Dk} ze)DD)b2AwkSzCV)0%429Xfm})rhjno--fbpH5(Pw9*J2o>81`76NCFsT*1hzXFC zkvZL-!$p01b?1geuK*)dDT{A7=XsTtJ#t!qX9CJ@WhEPP5y60knLtnQCk+k4D5eKs zMi?3W*;KfprrESR!tOkf5%MF#!bxnzX$1uZIXRO5c~D_OLIMGb#zzj8RZcFHElLuW z^Ydp7CMR;Yt9jfK5)09x8>E;hWh$arCVm_=Aw{~pjvrga4=KasBd6^#rC7& z*4*6O>A}`JxX9B&dW7erzk>mlnDtkMiHC(i=X|_jpqK(AOG>ap2W7(olc7t%!sMejWG$UqDwUJ&&r5~jF_ zAkt+-U+rk`>np*?P|h6|7M44dluLaj_ZBRO5eTQhgAUud+icsd$`}G3Lb*^UkuB<7 zdAU89yG6yQ_d9FA;ZE-Oa3JIfF!FcZ6)2nGVgrmegGpKODjHcOKz-McmhJ?XG&&kr z5caO2p#iFo0O5de+ZGtHE^PZkAvg58dUAfAvz@GSDuvchNQr4Tx+k{I^lIU!{?Z@7 zDXyq+c>P*I|08vBRFsOp!<|>==ACvuQ70#^yW|%=KQTBVFC!R)*(J}QxYb7-0lAJ%d53{*8R=K~stL*$a^%1Ze zV2s(e%^;6F^ZPfgPRLb+Jn|Mj$b}*hREuB>7Z&IRnOopgI`z)t4`{sy3Q#UTK0c9^ zl|_3i!r~49TMAC3pSZ=q+FBRn~@DJdx=@*-Hyk1Q%lmKP8KjKacaP?6HK1iFB! z!3OA=$*Y1B*aGD&@!aOBkQiI6(YLX+jpHj~&KB%L2CHFPOhUpPVqzmh!{$bBN&tJMrRFdpFy-3X2?V^}06f4akH5vj zy@E$>sIQMylLikN^Zxz&`1suXe3>E1)U-5!pY_m{2qDI|Z{Gsss@UFxguum2x)Vmy zByKwK--~$v9_sBd_(2V7gNNGeuT#%X7+6Cq1?0)6co3xzdnWW+wZ{&KC&1t zQb>DdWo5;~!?Q~w?gWi_fMWplh+yjK3otcG!1_Tx6X-u;1>~*6B!dR&m|N>GP@ zX75)WTtdjZg1UUv9~>M6Rf;lMBL-yw8!1n7t7UFs;VKrEC6w$E4LZ0(YzjFwAj_qr zB*ewxrhWs6Q+A5w;@~KTs74x4i#MQ_Plje@m}ZMZ>pPgh5~QRSgMm{ImTVxoR$@X& zdNs5a7Y}b7`Y6F*F7YD|>ixm$ZSL>0tEokUGWxr~`140T+Zv zDLi{-Tm1`C5~U*+HJVQZ?{0uZ0LJHYJt$foB94xar?`9fY<*k+fH~0PAmPq|eHjG> zRt5(B@Jt70=3EHFp^psnP>{dD==+TP{BekwMa~Yybaj&pA}IbwqP#pj?(hf$RcJ?G zorPBN6RoxCni{6W8(1keUw!aEr#m`3(<;OKTW6r-=j3>!5gGQ}?B6Ibl2Hk4!4f~#)<%>CgkU5j4+JQUjf})4B+OsE zs;R1C7&U7J58dEaYdKaS6VK!A1&_cm>DOutp7g#=Ms~0|!UcdX>S{A!DqzzOuX2CN z$x#7_3V|eW0=I76LUSV!)R>ul3t=tfV$NHsJOIPS7AOV4V&v!NS5*9g{$0aKLq4$4 zoScf%(op`Uxt;zMx{X0lQB^j2;6Q z+8Klyb@lZiSv@mb@PGtqYwC!c95ZeVG0rY_QAzcH-LAP(;Mkg}R)6=uF7eWl7ICpq>2%ZUK?Htw{1_0I!Aa`73|X+qk)duv<|m;`SKnI3#RoO)*LoIzC*CZuqc4hLjC-vT2<}rcEDf*6%gRA zu5hs8Wj#_d2kHiSnUg<;lMFWj(M2lsIr7TBc(J>+#fM%DTWt_KOM>750|v>+P9XLJ zQv@0Z+pdF=3;>lMm`z?+SA>S!`ZK8F+reS@?gIO`k-tJV!*V`@Ry zzz(KDRGj|x8YzNk1|lJ|zV!Rnu6YDt-(WhH`?GGME^LEUF^9#5FBTz1!-zTa1(+Nv zc=|(UH0x3Tfq}WX0JyxrM*1EVfOB~FJmK;s#Jw9ZakDDruYQ7!jC7aE)u}%Mng*P| zoSNqyh>5jPC_pREFb)~R*x3TQyvt*u4#smSKv4l$gJOf$=x&u&-O#i&gNO$*0SP}Y zAw2)?SyV*EY3P@gWpcY48w$rJ;3*u-L%>CeDnL3K9I5%wPvUT1KgQBhL4-09*a~=@ z2073Lx95?4pcG0T1X>2T!)~t9oW-1*jtVFNw&g z%#4hmz~x=KdgB)`E#SVGT#bL0l$GTvq+Kasyd)ZKbJGYBCiO2L1RMa1NTMDXHvnk> zR{w`_qvPP_rsOni3%bn(k=ucz*5HpHMMXuX&@2xk3p`7M`>B-3GhuiJ4FHmOK09N0 z*g<(&nOE{id;1a?K>#Pa21F^jxmw_bqqN0Liq#<+hDQTPLqxj*&xWBnzT2?~9;6-S zt`@z->AY(SFrcR3#n#3S2UuN@o*LO8aNa<7wFXnrpRvK>L9oINJ3>tJN$M_`4In=5 z!jinPg4;9g&+LMFy4jJhiU#m>B0aq)5b610-0(HbB^)<|jXEN?o#MHHf&vom^l%|r z+?bt|GzRdsq}I>S7X9klS}+>P5U2oH2V0jR#1-FV1w#g(x`c!9+{OdhG6lQ`4c51L zt+d0xp41uKi&x5MJa~>2L@bsO&KDvg=r_M<^qBVKY`$2_EH6a)-f(Mw8776WV_u(PwXuvoy<0U3fuT|l8w z1_lQIxv!?W`Y`Z~(ERs`#0aJpW4LBirhzKO0DWD#$lTmq7(!#Chm{rE>A^*iN6-~O z_lV~hCaB{Wy0@?4y--$CVm>2#LJ~L!G+(6^3e&Nf&afU!if}gp7)gg7j|FBG9J2Bg z;8i}MYAaT`i!UHV$zZGu>>?r}Km@a?V1Zi)$Ot<@IECqD#sM-I0Xz?;@fqe@)Efhq zIzZHpV2AUjBP>A)$INXLuUe#~0vT zJ-30!1bPY?^XaXWGhTmRA4X|n0)QY@McY5)%Q9YASm;!@D~>cWHg-QhON4Xd|Gnt( z){KO$?KUt$ivjuur6XYR(K&Aq+RNLbNHHuf%tMWG=Irb&CZPJyP)(BrNbZRSHwr>R zF^n0)Fbn#CDYcZ9iBOutz_bBN+tzIZbF{U!wT))OiC9p8;5S(qV6s#ya|cpgT^)#( zaK_sR1W0wL7E)7aP;gqQ9F_QxBS)KG8}@(vLA zXGwP=fkqP*{R|K2!B}n%jKgOEHkH+1M-1c=BMr*0Ar`rC;R5J&#E0qo_wRQn@TF-R z!!1Cm!zgfji#Skm1cr#uZvKU2Sx_n{6|e>%eb4`g(Qbi2jDV7owI|`aH*i_XpOk^| z=>Qd11wd=RqB?C}J2En&2IvCL0TK4o3e{%d>!A^&!k{%IGLq;C^?B?vE2wD?wnkc-1oUj{$|w08+`t)Bp?z@uM) zxApVGCJwpCl41hs8Y)ObK`q82&LM;ifI}^QRTT@ObuNk?PXA9`^%xEV=c$B*ua8e( zMhk#J6NoosNW=hJf*FIkgc4PisEGrq-?8>+G&zsOaGnNN4N@4uCg>g@6%gK!_`oGG z6hMd#M07S2!L@8ba#bP=o?3vqz}%whoy#%JTdcl7paKplMAfQR>qR0q1u#~K*e@u^ z_0Q^Ul%^oKEP#pVCHCMJedrB@a*?UU-n6@S?}Co(lGwKO^g#R4DELz#NEi7Lo~i#E zdv6())z`fXqo{Ou3rLrQbm&b;NJ+N>(k0!u;!TT$ba!_*QqtYs-Q92&zvubC&l&GH z=hKNV@4JTs)Eo9*Ywfk>n)ABmyw>A1M+ViuO8`E|P57w~ZUB;KqwXKM3mt83Fyf9N zhyC4;7Yq$H@)8n0Nl6O;l`pP+14sXeSt-9{V>_5CGX^zgsZ0UQot>TC-O@Tb35Ayx zAjzg2kR8C`06;oubJ8O*<~<9RkSjpnfeX6ycN{L63-ntd2t<}(uhSZe!|M5CRMywq z`-mZ`;R5gk^agmn1<6N4!^5_ZLQ=uxa}91zAes)Zb7wvT@e;Vx-dvqpg+~?KVcnw% z7+bWh0bZKgp1vojLwV1EJ0-9+l%fP_i3t#Wt*hpC!>f(7@j7^DjU|24-Z7bufO>@w7X+XApS zBQI|UAPryyL0V8Hhyj^|6pF-vaRh+wy+)a15fvg;Puo~c6mv;L3`S}6SVF~u{Z%^QX|7>Vr(7JN;@#9B;EQynA>pyx| z@$ujTE+F^=QlQYu1t-VG#s&vN<_ihKe*eC^y?rdG01R5?6amnP`?qtC2V4kHNYw^r za3CM-7hsrLJ35R3&0sJ71Pv_+ES>>CLpc)4N=YGMU_c+KU8jSV)>g2+sR-zR@T&>9 z=V-)SHg-@1)f9&;?tEC@K%7;2G^!+yNRhO2-v!sn^OP< z0wyk)d*CaWgc+|D`Gtk&Cnhd>V>lT}2SEfw^0?sPfiHFqpsjzrQ2Kp`i@O0aACZnL@an*Z0)~lxeft|T zz6_X3larI+r31?Zj4fbD2$@uI*~v5nBC1pfs>UfmkojG`jzM|CPRxa5~p252%j zqzG_LNUTwAV06F=>*};S20DaRz<6!`LtX%n0(4HHt0w~IR)H6^1(0_+xA8_P;V&J*_{M5h{qOMvEM#<4Sx-+7h@R=aBr`HJ)UI>11OO1I0|B$S zYhWO&3J97K{S%l1ciHj&_6i_6LwEsp4i0<68G*YyH6ZE(dtc$;)@u;OfvD@z;RV43 z@WcX>a-YEAdX<1pt`y8e5IF&U1o#z!Wus-la{&=4*v0=bm6Tx7fFKxr1rXh%Rtjqo zpqv1Y2{P`$rsV<3Hej%4`Kn;F#m?15A7AcQP^|*!K~*(1Cr3wCIc+eTS8R9z+yREv zJ|P6Gq|Hqe^5Bi_ZO!;7CNeOvk7f{nHo)itjxr=MQO+88A|D^Sb`IVLNcBrdO40+} z2LW`grWNoG!88E0SzlLI$_~sBXyg6;Ys*WjGFK|U2Fez(h>2YRTnCWWtIJFG+sl$s ztMR9BO?;1SBLM#1(!w!x>opx6 zm`v5cLAMv*TDGkLZVSjl^hGC|26$8R4+P-3T;JU|{iFp1!lQ?{CJAbD2tq=~!(Z&JFmrw5=Q0N5)mDmnnHK9~uQAO>)iP-(!e=mdzD zC0qd81-21Elfh&FE|L%t4LKZ3{Z}lm5Sn%h*d6e>HVD!{EwlizVFChxz7bba`VFiS z;E9))mw_?S1D^x>8Mpx6LKbW=RtkMubQAfx6%Cy;Pxxxhp{_wpX@OhRV>!2($E zAe73}t|^!vG8fmT4Q+LblpxIS)9PCH=YU;w59VB!z~3p5zPye?D;MeXHBf5OI9W&AJsaC3{uY-0|5o_| zsr>PF1HQce_v4vDI&+?@Ii#Vb3#3_nVXZxG{3JOz5JWb%wYhee71deUJ1J`fnzZt1 zy_PD5q^9eIAys=(hzV z^onlRXVvZ*Dw@JWZ;f^D7-B;4P zjk=pAj`uViQLHsUyh@^~i4pI{sm-IdPWIiv^IKuFxUFGv7-nRs1Btyv_=|FpzVZ{> zrnstm4fbMF6&x0E&!6hV5|xFrJ9nkVC5+d#pknle5v!k%0weAfH-s;FY0%8k@_In( zIU3=}A5w~2>rJCoCnV8`pR+Sm&p0=e?nqL`PL}wtg z2TuBFV>ljK&+r$+zGXwv{!wAp7ufey-g>&@=LVGi+C!!B(Rt?FU;HB9bwj8*&dNg5 zIOR>6N0;_l-WxDoX&?A8U>&c^o2m4B8~-{sANl^wA<=1lkOD0*z`MSFm-#cFa^`)z zcM;Kc#m#+Ixi&c^Ebc^TeSG{~S}<*%JEL3IS8`tKn@}bmNTSeUFl7bz*!`EHhX*fA zG^Uro`CEOM1c;uuqC)MYCh*-V&9xWC#wrrEPR>Q8^_Or%-Zh_Fa}JhKi(m}D!3#gB z=k$G{JP~p1=cF_0qVX&QKHuG%ogG?C(CKewr=>U#CFetP@9sosNZM3ZjdT` zv>kx@k6Vw{-h_*W5fn01xw@j8=qyYt*YQSGC-+KT`9NyIBEzU`RTVrrkcE0*3k24h zJ%Ll;;B5dhf#G2&HKr7W1^Y9Z4jYssj&~==dFh1VXIn7~;|$cbl~$vk=UrJzoX21H zpVAXyH>E4|uNoPx`o}+iV?h$6V#Ll>l$hFziX+m#x_F8VM-x2ab`nl&6viJ~-Srtk zqH0U%X4KdIO76YX#Q4wMVVC>^YhDk8WUiOQs?TEeR`kW+Pt(6qjNz;Z`WD~=YLX$BSFZ%+PLTt#e=D}pCL8{p^$$A; zwuk$sZ=?Grrv~<^Q^uv%3|Fw zsmnmK_*&bQ`yal+DAp^-w_U9W7*@I`0>yuKpelh5T1+GB2CBOPIF}1|EpEm_Zl{a= zXD0|z=r+vboPnS@mJ`)2`89RE?|HCbyK){l&Hr|gy}USi8sDV0 zs?{zs8SFN&t0GR*QS0}lOl!&yp|xIq!ssW9w`moP=dV;LVdIDeHnSWa%y1_&0FvKA z`(g>D5s%JI<*c7(T7BH2+X5_LL0jHEV2cG z`d^DLYTc;{SaycmTy_(iI=W3z=7V9rb?;rs!uf&~*O_p`1|tK)PRk+j2v+LsIUZ=a zZ|G;sF}}yq4G3jTDpG%+@DK54O_kwZYY>^QJ>b_sLAG6wuj6c!GDHY;#WY^>c1u+8 zCiz9MvQX2}0`oGE_;nst>`%IBT>z6;C`S6%u7W?`t$}*bku|gPS5`o4*OBc{%(hHY zJ*a4hB_HWz`G&80uZHox?=sWYpLVIaxZUT_RO@fmTn|*hol*^#CXsBh!VMC>Pbqi) zPhHQm1|K}h@k%?k5iuoyxr$#StMS>)mHiI7t9xff;d%_c_J7WqnthF&aw$6)yrFi^ z6T&^L_iiR;9$UsA6yvW02ed_2Y3zMnq|~P)t*EOK=iZEpH9BG%@PE3ASY&CPGi>_M z%(PeQYUBy;vhW>o!^IdqDBUh)mbc-d(a|tqxAK#z7I&QMb$Qs0S^)2vFhdmVj7F?A)yQe8=ipbix$K1<-dQqMMXrL|^;yCJj|NmG zoPWcV?rG&|M1(fjBxlMs?6(&Wm$}`Z^s74|gud$sdLkTpH!SpB+Umy}^z8B6dG|G? zg;BfXG#2n3{ef)pdP559sx(EY#E6WjF6c<~6z&*;ceK|Rv9n;o`Vg&)3r(J@bR{v% z#i=}K$1F^1s>+2*=7r5nHV}-LV{X@ldyN=H9PBrKRIR~GQ|Y=JNMl+>?P`h7N~nG< zAIj4*oX2f5;2nXSG_q$@u&E*2??f$8b+IoKIHNWcx^h=?n(I=iv!FgS$Alzk#i}EA zNqI55pAukbSRlR6$wtbk`=N{fOfx^P^-raPokkujhPfFXxv`;0wvz|bHYE}pMnk5k zDUt2t79dGbW0Y9(llTK)Zt5vVY7WdWn$&UE#DDIr0JmRpIez0Rf6t0;;36C|vQkvu znx_9%?nhd*XLx?82rt4@>f#PQ!lSRn|D@vXeSNYwW;x6j*wtcM*6ox~zafHDZc%sV zQSYZm+Mj-Bo1{;qS(%`z!E_7<*_9xjeFGUD0Fs*mds@A|egjf5Vf%lQzsz{to%f6L zxKj2}_PD8T&{sM=HFFq$m{M-J^e|PAEFfTW2!-BYHvkXlGw+=(nO7+9vf5HUTBfo^0KW_V^vs9fCmCMP$a@ ztAvkWw_^`xb7PCZs0;$w*S;{e6y6#Il9ka}!GF zd9hh5MJ+VDQ(L(w;(1;fC@=B_x7;@}@^T;;wg2S)+%^q|0GO%YtvFgd7Q?9?7xNyq z<(A{wo- z`J3()%ldf3u^o`5QEfm@MFF=BnnQWvlnp}p>B@&)%O}<}R3=0oVal}&@iFr0(;fqVKd;g6W&ZV9dzt@EPLCb*i$(oXlmT{MBs%KqEG$L3u9U* zi-WC-qsxRW#Vrx3;TeR9b2j3sf~!T#V48XeRy;w$-il-cGTYkJula=cmiP(AVfL0^ zn;ux|qUfhDT1zdsEz@^Z2?mSpN{!@FX3L{HHpVfw6b4idf8Q4P)eRM^GeZ!&u3Vuq z7pe_(R)XZ%5%<5LdVXUoZVrj}@?2!8h?KN)P_tGFw>b|Sa)v9bXnh(?{4mb+4YUp3_cJ7ul1m|WO7Hk=u zy!u?%g>pNjk*?lN6Af8S4Z1Gtpz^UtWuk{16EEGomvMhi#M`>zkcuF()}|dRY}B+m z)u6FKXXP$=2O${RhS;B;UWyR2M`hXXu)F5S6F$&>x=mVD%p2K4@LK|p+2>On9$m?g zLow0`z->wiiZQ@2UQ-H>=WT5;=EA{ndm1-o&* z2!%pyAv!*dF1^NQ;wGnT`(fxKOF&}I% z(xT3H4}{au{V1e01|kFB@KVBxKjfW{XQJRK&3(8fNl3iBuA4N^d21S?l@uCc+cZVP0<;vbeUo1g;xOlP;siF4M)J_v+&)E?^@xp-#9*fpq9B-arVDZ z3npl?r-ytj4s)cLwTh41OqK*Q(cQyjl?usJ^ySX&>0WSHyY4&UI=;Itl=^zuL!=Bc z*Hg9e*-Rf7v&q_^Fju~hsBB03slq4eZOK&WLJKrY#}?lY@r?D1{ZxomO&P|kbJqk1 zj6Vupzo*@sI$y#TVMOYg{^FAq>+)fHhU%4Tfi>Zon!=H*sE4(CI*Igj=etn!Kd0ba zhNTXbT;aD6>o6TV^C6}|my&^B-8IF^IiP*|KBL@GgNrask21}_%Ll4Y9Ivs5Tjg~N zCz<{=BHcIk9#d2rdS4leQq5;lvu=w%3VxY>s}Kr2b>1-AG_L4b>0|lK%V*&j?|j3r zn~4W=h{>Kw8ePVSKe5%0ZREJS)!OE-Zet~>`+AnYMIA=qwijy zm1?a~M0`h3Emj{b5Ey~#1AFye*Hf$Qrs-I*o@6rF)))K6E^!0^k-{oDOvm-G#h76$ zi=m1Fc#p$Zjc0Y#!k+%NH#i<+L!*sV>WsgWE{}b%PZ~N`4RvqhsOc60NVURzNX`qs zP}(vdF6)so>!A>1hhf%U_^Y#GeLeSZnK2d*@8*+^ZR4T)v3mJSMo^we)$9X>JWc8c z5=2J)>nK7-I3##<8gz9m5~J+XXSgk9hgN zM5K4G_RdSX7B*D8mZqQ^?4>wwzpu--d?bB}m`hDY@5ZtB9oGKH5-Pq4WE@R16b_ z4F)t16ol(^<)_`{-;=#kf^oAk+Ym^lqwy($kkb|tJ*>QhJ3X+o3X$T9O;(1VdOJ>; zpo`6caR>>Lm{j(ZPmuiXX_zD-uJzQC^Ad}Dh9;Ba1&0uhvCFaAan_F1@otQmi%8g- z`$I;nOX2`&3DPgVgMpu6ylo-!EzN04=F9N4-)S(L_Ef=orD6798Q-Ji=Zk6LpcHC| zA-6J__$yZ~+dbjs

NySNYBQ4=(Pg`U=%l}b!>Mr=((vgLE;wOu&Zf&uGoa?dLi zzm&R`wR`Ha=zn!*pk9G}R)|=dWrUU+#J3-G)@OR4fe&MJ6jC`XS7dWp)H1G#&IeCA zMrE@*GJh0=+R%U#j(XdSZSPoEs|wNo+J_FSGdu8qk^a+jd8}S>kg_XDq+jhZ>#Ct+ zh>cF3fmg<(+;Z%LKjwpi;e$iQ6-~MX)39z z=mpxdkBg!O*=<1FF#m>D_{mzuK@C+A-4n^?tp*oq93)Xx8WwAv#5pv-mCj4Z3G%E*0- zA;K;^-GSUid#q7HiXq~Km+h0G;-|k~6SbGL(xX$xGgvBfKk;T`)v<^V`yLZWh4a+n zOzhkbDEM88ywWzqPWkf|Ux{oePEqolQPI7mCO^9Xg@C>_u4ei&&n~g5mQJWm;re)7 z{}rj=m6TKDNC87sMdLw$9Vw1~4+(OiRX~1eYarB4Z1Yn}W@<5Wyzf!j=ZRb@tSmuR z2c61I<-V+?K_e?_6}iR`o9GB&bKZsRlSJcFC?n7H;-!C2)_%*C-`S?tG@di=8IU*^ zkAKb>_pRlEU+VV8+Hg+gegrwok)|Z3*>nNooi-NHc>sCnpnC|=BNY%GS`&R0c%R5} z&g6YYV7PQT{}_X~@B5dp6|}b-`?2_{?z&mv`d&b>QU#Q49Fz>Fh)dr1X7B&?TJoWa zN^XBjg9%Br@W5p{FQ8`biA2GdZV39lEWJXi;_hgr(xxlc-1V|Mmk{mQ8hq+!Z(89+ zh1SNSc%;!$!;Fa<*3(rDuS>o7fP9!psw&=fdf3I@ToV;4f_S-)xv>HT{5v_ zV0{|poMRN)|%Ss`&hjghP>`&K}$HJfE1h`Nm@D ze}wMpQJE9MQ?|LxFL>mQh@u9n&udai{pjN&#zBHtDv1^7BCX@8-$hKqrSlt z??|tS%Q#%k^1>^XiG-}Qb_eC_^ssq`;G!eR6lpe*MGX`jP&?+R5I@onzD2q-B5%vd zz|5zK@G&^}!68o>HlS2roh4u$b<5tWmWd{YIK*kkP)GSU8T0zBcffmh4rxm7rh1Oc z!Uwh6^KIs|7tn;0n0f7Pin~ns%A`0ZN2#z?u^0LLuRdRw#$SIy5G0X30#!0ag0&u7i^C~Fd+i&C*bu~yOwWxHrt<`( zdZ&%!fbVGer)|~}%E%k^TL7rB7UmW`?vZrC3M1NYQl){`_T=D_Z0e*=>YS;M2N~zt ztMZ3O>)jIUU%V71%J_y%n~aF0$3CHVTMwC}b&%LcuHWAfvXczdj8GS|!4`49(p~f# zSFzv3k(2xICm$HavE{x#ledhQx@q?%#BSj*D__L& zh%+$VCncw!&G=nme)WZ@qkmjVNc+-P?#T#oBGgLc=%7L1eSNIPS7m5ott~Z&jD(FLa-O&Q9qipNn8fhbm(OScr!xO zr;YmeTQ_$3@lFM~xWf7Td5S}A&^Iy!BWlR!Ber~XC0*HI8J6p_j?1|}?w$1fn&8-$ z#tR6gg2R}1Zp#ZWUY+X|qeW9>5e$$EfkL2WKpQ0a3Rl-#nhnsZ$cnxAdS42*cGMzS z40h(mLp-|ysruwj_hLFPkOX#o_yh+Y@(;^Y5tsp^mK1llcE{E0`4N)(cU(rhDFzeB zov!Y+eti0cU6Pns263h>1{&_;Gtb*#^9i2G11$pjiH6#}Pob#nfP*Gp6js7z&rAC2 zdrd*w?}!{$aQ2Rg|6K-^I2g)TlK1C9dPhpLbpD9D zwZBOoDlL*SB0HP5zX0;Y2{?A9_ZICwqQ(hHyj}9^Y`9v1k4FIU$2LtkwOQWbmr(jJ zVuNMJACtr^f=Q1FA0TeK$!Hc?vPvO1r4!UnWolyK9eHNq(zI`G)ovtZA%RDKWfxxk z^Ty85-dFmiS}h}G#^~EH2|`ivBe%QVyOy^1TR9d_ky${ybnS}7y8~3hY(`oJZinnf zzYmBDv+mr!3XYgqDGe070E+Sl?^oBFeCX|dq3Mkj-Nb6yHvW8VrMbI95YVLC{^_%V z7qlHTeU<$@x{VcO%2@=PN>s(8MAgDYv=J8Nt1H83>=*QL_4m}6I&&k`B9a?Y)FKU# zf{K}0lqH7tOX8zymyc}z;g@{UvvsNWhge}JXZt{yb5&A}CR3T1-nA=#1bOWXy$B{6 z6mJM2$rE3AAlLS3Ky|M630x!#tU~ieqh0HH%NBxEdP|+k*Nx zck)CWP=0_#7P1_Sxy_TgBt=H93S`(#@Db>GMie3Zh>F5KxttBNDtJ){Jqf&1jf%}T zCVAmNyymf!7N7Gi?uzC1Z>2xb{6A81;Od>ee=Y4!7oaU8c1zm}R5u})3|rtG{C4nM zPEWWH>2dn0O8O5yX~wSa@u%n6l%5?i&&iB$$A;?Jp74GAPtnx20Y&}Ne)(gb!W8rZS&!3xzefM=3EUSkP=yuyQ1l-OHaNpa!t6BIYA+!# zmSl4iv9R&@xD>kjC9BQd`R?_njrkFZHiTC_UFBENH8`&0d1hAWSv^htASLHM^j>Ja z^+#DA&lST%8*Z2N4;#Bu+iH=I%LdeXA`N!k8-|l=eEq2}2>^xPyy9yQKIR-6VXgP; zef;I9s2Dj|*WG?>woX}Pt2*Au=G#cb z_=>%!;(ug4jpVAUT*Z@ASk$R+8{&d@%v-u6uAED-0J_e)R4zJ{a;VMX(^KG$>|B96cyCA-wHVH zo1L@k47u;?+d5uAn@+*($(&236usu+N@tRmW^WR>y?ZQe31O83#a7DCKn{dw%!NiB zIGKt~tyY^np4MOkq*>+!Vd*F~@}1t9_s2I~PmipveZTn$l7(5e)5W8rV8^rQ8L|!M zAyXhpeM|qHT6p-fyOaH#v4wVp4f;a#Ur_G$c=dNFo>6 zpROU*B^nFJ1l`{B5X=SqbM+)w!TodR?jm`uItQT0v(8eh-QGLXC$bDRW4)#gwE64~ zvg}@v^=I~E4BHZyAB8{Mf2Nr%LtT?vi?ot}r8l}Hyq|!3D-KGinuL4{EoCeTC#=0k z(v3xhYB4<>q!vmyso=5|{xid9a;{V3Qc~nG?8o1fSaOKahaY`Xa}vODfPgOKqMf;@ zD%|!OOTG!kf}#hKd;9q4-n2?*|1^o2nQ>ZBIgAE{Z3d#dd7E$M-9@-g=QAZ*w2&*E z^ll`J9S-Yb9cj038CNKcMZtC9G)N;>wDQC#@GfC1i~i5T{WL{o>W#XTWgD_4}1tR_{>(y1`e$|A(@FbL9`Y#*iwmcXXiR?Pn&t?=7z_r2Y$tT zVeaPL66f=QJX7mtMI0CAg6JEORf}vBlCsm>$vU}n0zoP+uG3{P64mAna#wS?HxS8) zBeg4sVEkh`(kNSj$M=EKR5Un73Txyabt;9_uTn%=O-|3*2iHOFOsb z64hr7jOVEb)TiguKBt>%4mfq1CqKj!^(olRq_YGWPR) zq(&-&A)-kl)k{s)tU6MNl&;Wck7G!r=8gH$1HGvviF`A^tLO`f#>@=H5teJo;9%hI z-97POw)LCFCeDr)&*Sz%g`Y!z}hFoIWiUkH)m8GTI< zY2>rcCxe80avKqWL>_yYVXLg&WgTLS9P7mt7eQtdh82rKJrN2Ce+!oh8 zgt18(n4F}Uf$Jj28`56Eu?E7scZ~$+{rjI}MSeW%-WTc1nOLU27sfeF#H&yF^T+tw z!)+TAGOW9>3e5!PBwc*i(Ss&PNt#yu&~5!nB7bH5ptqgi6@`L&KWp=eDTR(Lptff) zg6{SLt(T1#0(!PE?dHfZ3z^8c*li%VZK%s6sBGUuw3?W^-{Agftu|`hQfkU$a)bqa z7?b^othXd*w(%}iu%mj?<0O0zs?K4>6J7$s7I->z6lHq#Ly1 zE#>jGsCq8L54*d>B^S@w2wQ;e*l}X1#kA~Xbxj^V&-KFD55dT$9nicIpCHv>6jI+sMSwwVv77b5kOO3qD$=s4$zCKn8^!FAa0W;&6H z=4N$qp|{6uav(4y=!+ywr|OE>A*@3Xj6^a3bfvSEZBUWP(qM-Z1Mv+L3sASLTjO`n zN$6eO5laZm@7n(S{PTEe6%G3#pP!7R?6KJ)n)0UyPV$ueeTyLw_VBsMNlJd?$3jSK z#Tz^R=>O=$y?yE{9?W_^5im28aq?@xUMFQc&?<4uIy{DmsMw{of8?SO3u3Qx-K$wq z9W44cZ=#KLXS9W;&P(J7amaSNw8c%wIFRDuZpiuA@;(&KIJx)!eu%j+Hb#MPJni60I`Vr^2WH8-FDLTs&Hh~zLe=iETi829%Ju!SDr+K5 z8K%9Y6c&6$x$GdGg@uKstU-f}&xxETGb=(QF%!m9<#FW}YnML!L!b35PRW_|ikD`4 zK0y3xZuDjv-j7j%BeI=D4uc+S`ug)CV;k=emX7kUK;Fivj)cY3o3seUZjrPZR_9(C z*gV0B@C-(uxn+-Qx!ZV{PIJlgx+UKA&QOt^GV%kxCYK5Cs4H+r#ANXREJnt6T)LjW zq$A$#_8D#AKbCGY-pt!l+i5JpK7pzIUQ)QDf03tNb&046{*|T%R2v= z+w9_CG1vIJ10_*yqTOKekOAsgDT%7V|7o|z3n8Fvw`r%%3*Sg1_~N1A;njlx5J5KQ z{qtt}Vx9-$XS4y2F~QUQa87gFl&0lKzG9s+VKZE5i9@oD1l6;ji@LPhGLN&h+=;bB zxV&iwYvfaRy-Pyh{NDDA^~HP0vpu5_TepeGR*-#UWLsHNm$ip-e<5~imnX2bxv;Vm zuGKTc0vR?!iB5K$P+WSo+3U5{fu*za^{DllKTL-N{Sxx8;!n65c^vZN1p z_3wlxE!!+kSG1J2lF`IHZMMt49(Nbd0g)jX;b#DlCTL==R3h@Msd;tDe{%PK`< z2Pe=?r4K|hN;95N*0&*4!Or)TY?g$jRATp%72CbUCFKl56f(P@Id8$qD(YHhIDoSh z4M9Po#Cl#6g1OA@VdH@AKP%)A_mTh`q&;1q1k033qzOH1P+s14?K83Z+g)=!@xi*; z35FSV6rF_fyu5c|Pvd}^zQ?)V`bd1}0LAzZGlo_{I8$I01@Hu z!v3|(zzli!mzgv2Va?SiZOkK3vWEj4jgM@Fx=`)x22Sz=fn%<~VrG(BJX}0?R_aI! z>{XUfgYr)c`0{hErHg{;ZAXfoiyJ{f?_tx*G&eEVi;D%Msr!>@b)9^9g&Pm3h&6RP zs{~6Q;l|!_!LTnl*V=`ab|4}vdhRb_AsA{!o_M-zR5Z+CGJZ8mXek_@|K8Qc6n9nO zkQ8Ph%dG%A<4kms*cOP-UfrCPgu?NP5@0w@Kfy7Kc_RiMs~u=i^-E5`n7d&ozC)C% z_2A~(G5-9uzo)7TmaXQ1|5NEYCZgq*+YGpP|6GK*IFQjv;!(nPk&UeiNlg#NE!Uo| zCIdP{T@cg2v3e&hOML&DhX8|iD7M6!HTwe6P@!%hIf1y6>jT3CPzeMLjV zWi$_wbQzhgu1|)Izv%)sb#YnokMR2|&V z+NK``_b6e2^NTE<5N%6a`F4|fRrbkLQe;}hIX1U=axKh_I)Wzfzrdj!t{(1xV*YgKU&8;#dN@j<3_+==oh`}vJ z`xi-1{`NnEM`h2@M6U$X_Ng) zGL>`!;}hKGJ5n7(`7puUDH}w}1p_KjlqWfA?BBEJadirG0J+zaenYLNDMfvNro|U~dpGhZeSy_E?Z)lhz6n!w9QWHh`9k8t-iGgb7V3^vn=YwWf9~!d z{S^u-SCN(Ob9@-)eiovC*S^OGe9E>?RZaP72^Dh(NN3=~<^|pQ%?4quWcZH)c1qZY z{+l`S`+1!TM9SJ1wcdO9RI?LIL|Iq4I`B-P`h;^R({=@Oo_Fia){_@!YO zeNAETcCGUvM(UJXOjXUaj3$g{XBz8z=A8vvAPozWS=?JdjxBz6YwF+;u0&xq&E@OW;KQMXr`I)PkX^_2OGZ z8Ga!+!gsFLe5xRG;8EGV)IsKko-6U?$$n-GifSRKew(YAl)!n6MyhRN?;z=2<|9+&t8bL{A zW0!x2MP8(e+&Fh807`hq89?pu4rDBkYoE)t9akzT_^n2{DA-kiLIj1La7(MfBB&6n zP;D?O!q$X)PhKzIO!ugN=vfa`WD_M>>elD()mxjO&hDcG5X70kQp;~v%qmGCoxxn8 zN5+t2;lJxR5avC+?p$o~zwUIfVveK{+2+My1B26Ffkq_b(a+axt5R5PcTwYpGZ z40;}o1r7bpPaxlo$TUDAqnkPl!)h%ZuePwrx8qyPd@o5o5uN*2$oU2&V45dFq0bW= z(pi<)L4m1%*z}|jh8frR!?L0?a3pKB`Vc)C_i@ZPbnE-T0a$l$)y(dM9ez`izX^1q zFB|=m7#rBvmJx|h`Sm*iBrR1xxT;B6Q%K2R(ac)v2og3NcF zzIjm#@5Mdz|C*ErZ3`d=<1RM3lJ`(=JKWe~-)IvO4d{Ns)SveZiJNT1>wE}prQWWn zdxInVca*pAPE$r$mmzoR@l@ukDsHmC4bwa8PeMXF%{r*i%-gb~`c!}7w^qZA*l=rd z^Q|j9*hnRW#ro%iEsB=w`=YcKr=_@wsmaOVr|uBmHv+Yr*pTx0Z7JQkf@oV#4kSv_ zjdL%DO^fLuO~E$Bzgu@LmqP-OHEd37rA8$(VDyiN z7v7&HCVkJ#q8jMQ+LlQ+((l4kwdf5O7S1%@hbKc0 zTS9K)PC7&#=9FW*#?6i!Kd_xO$r>c&_e>>(^^QCklsiN)(1|$2{N)kfK6R}ndwUh( z;&jt3WJE&CwaaN<;?SUW8))xSA;ABh`NH#!ft-x18=pr#>1~FSbq{OLIFZ z(Pe!n`!%x6?Z)EDJts-!wZYWiT18L+#-6wEYVP3cdiwaV0E#eqLY1~%S8Ps!53Bm; z?2`#EJ0uvUEqLCY5mN^bsX$SHxl$&cpO4CK?g~_h(LiQmY8zoy0#{L-@8TKKP{C05 z_p`O>bx|)Oycmprk^bz3;&HzS5*-}q_B3t&-UEN5{Y-Ppf!@iUX2mbYOByxKqJ?4l zjfep==>6GxF1+yoklpG zSZoege*Ln~l+@1T9<8b@wz_3dR411`=5mc(DFA&ah#mFkyJzgkD;Z?dl=~Bl7x897 z)|%$H2D9wCFxd5Q!u!hEeu=RsV#g<7pJb*nV_w+kE;cyp{C>i~bjQblpfG=$<%o_F zBtyjXm5BzUWp(oEqGX$iTnQ)gpSez+PLrdZNv?i}PoX;L8Qb}#!)qLZ=U;)eQ=(dq z{1$2R4J=?)=`b_Fwf6uC{LhLfeKKUm{FEu z)2Ge0wWX5lC*|EARogS$yA;?zwK+|G&J!5Re7m=w;%y*DgZ*QA&M3+7@63_#^Me?^ zL4)ow)OSqwyORtDrImc}B#=*3M(SqkOdGADJ@Gtt>p&3EXU%|xo2Pz- zN5LzX0-Z}ZK-1J(&Htjg-g9z$H;C;z&}R?{_VO8;(+Ro11`BII(*0bFcog4aY-m=` zkmNHTmRgmZhOKY5nyH|3LsQENI(6Z`4)3JFY|g7Xd@nWg{I9Ox-Y?{6d5_bnyj}0P zQ@WO`iKUu+kbXcVtGSgTZkVg8dryFVOy~?mOAqa~I{9B;M<)~TEN?%$11AT?-sgRH zcU;X!tvB{xhZa-345|&@JB>FtuS_hkZac3j&4Eo9@nEEjGo>v#Ok+G@k1nT)sQQ3H z92+9JnuhpOl8PT~vUL%ejX$AZ#yL|Du@S1lB;(2{#i z&yHNmN6$K-BeQe}GTKZ?Z>_3HkZ+HB>nbW=!bq+b(RAQn>Ws0n1lhLqKc^;uTy>NZ zjSfVFw2^dBP!T|oM7dzd@_8fm{$RRw@BR4Rt)1Yt5aD9(lomfh;ME93B-es(!j~!} z`}3%0@JM!%lAi&e;4NdYAbELJl#Rbcoa{s)v#FZ5;haXpWhRXM6mHmEgl8)4ptom} z6J|S5e9`!3uTP!t`;MFx5f<{J&ay&Dv38Uj$Q5_Nf9%-;>5H6&z~I0pY5m z?L*n$;1J8s3#eKl>Yqsj1-z+|f1~rB)TL>Ztp89#|M!`j|4$Wb|9P0IJ1D0A#e=?h zpt8707Hajry)BHMQL!Yo(1t?Vr9EaB!D{^tb^nj~687gQ|kUpFW=p^WJ27D$UxVz_@p?!D8E` zBWEBwg6$9U3zz=l>Dj2wx`7W~)a4-Jv!_5DML0=b3@9G~MG$0fFD=A*0+^rr##ess%qkYvIf$je*8KQT%c7$Qh_lh=oT+`c#9u z{#-_HNGOn!P*?9f^|2{S!G3F^&H&E+%2Uq$`4crly1ftZmDvzyL0zC_uFcBx=FQsr zJDP8U#moL;RNzm9G#0^AxIZ0lGd`}Zu1dbb292~LSLTBG-~lOW$&8PmNdfaIOpfdg z$@mC<-s;6apUKnX>NB#!!MR(2Bh6tDN*+8$Vn}NM9k&1La8x)ria0PtfKRYu{MS#v z#Qbyz0i!UPt;`6t7i7Hydu&m&K}sDeqX z%HZ=W5kKh+KUSS&!s7GxSZLhi;Z_QaK-U821Ue$ofjQ(eH$O{t_zTE30pZRrLk=qm zJ|ceCX{W?b+If6Omtx@$%bwDgMN{mb#a`j7tCLhx;RVu_(=UmM(fIfgn+JZrg#AaVpUIX4o7D>}NUQWx0n8`9IwZv({kfpQdjk=HG<5!% z@b3^6dNm__Mov9^ZJ8dCEQK{Y8PK|VeDDG?P6sjJyH&n_uHgTmO+O$t;DIYE_S_Wd zN~*-?yyCyHcGf{{b#I)nytJjXXo2EwaBp$v1%em1;>8_`YoL_k?!}8c6nAKgyAw!| z76}@HCIsEv-*0#JkNsn3XZ8#;Omgo%Idbp0=RD7Iz8^=3e5RkLcA1;j$)weYGh&1; zbwBT2B4|BJpOVj$?@(Xmgi($C5CCv}s(1|Sy+n=sKd;1?S{}|T<|gM-H>)~sn4k84 zUv8}|4{~ZoiT#|K=Dq8`VKy8jx0Vnj)+IlB)=Jg$S%KqC1D~z6#gtslh+jgJNW-fz zLm!pQh+${5 zf5~rMdkc!+jm&1t=!Xi*2Dlp*a<|g`?FyYI(!CY0Zk8uDr${sI!YZCNAs$qu0J#)r z>*odd#Y$)98+Uh}kWS8?auX+JEGGYL>;HKb%Fc13izNqWS4{-tEpu##5*wpnW%dav zcZ5P;!>08o{DuMX2M@2BU4O;m=tRYO{|l(J0m)kp*b;xQ;$=XHR7RPC6j+S-Bk#ZA zkZo6hy09BxtLDQWg5LmeD#Xfh1iR{qd}57SKcE}`3sUqvBR6-JxTpR0$@4!q#8?gq zT0lH~C_F14!FQ`*YrBJfjb48CsiOGw2OvMvee*!Mlbr1_rp`S?gpdEqM)hAH{TLGO zf5d!tnn?o)odZ{U0~%-1j1=|ke0&}d?`noT*)h3(YFblchrHrN;Y9_9pnFFmgp|Lo z`gt3_Hvs9)rga(axFho5peklsQn63a)x)z+id%)$6LGKt2#M_fNnDN@`C?kAN3Qo4 zHBo_*0R)o(ndycRAz@idv;Sb+^h9l!6bQPUzS=lC0bi8Uj8GWB04*GY6jvIYhj@mf zq8;^Vk3Q8)+dfg(Uuw+g7Pf>ohAn%PQ5K0lzQST-#RpVswa2m`*76Kp{-V)YT1>;k z*iC`6!S4AsiemL;qvhH7LMW^h{Gvf!w0e6zO9>REUzHR}Fvi_`cyGt%Yp2cD?z4Jl9;;wr8|~{>Wr1^N~-0MWTE@54&FOH@}T77ZcO!C9~=2 zbOFy7REw>xaS|`9T|aurK<$~91sp#BlC3T6W!h&8w>9(cGPxpS;%@z2NmSmpERh3} z=z?A;i{%(!#~6B|#2=mQl@5S0Q?#|SI%wQHkG|2(_1uI|M|Hh{Zkoo2WaVySC(q!2TWo$0NKj?WbwvioWLvq zeKc8XUxnE9o z*8UQ=pG|II^n;aPB0RkktY7GpClFUM({4?k3LQqEH$;DqsAo;2SZf1o~K z@%PkTYbYBmd3B!z;^$`!R5|C8*n8On7@!@!IP+7ZFU1NoEc~~c7|@iv&8CP>qpB#{ z8iHp)NhElin23b&B?nTb_0o%zjc;6UO*51fXN41ONf;}hirjFphIcMRv@evvPw2ihwLwge^kGJQyG}}WD zvQgW*j;ftSffyI)9j#dZc}=_JnR{ui44RW}t)S>_^XD(h?}UXDuQM(cYQ!xXoI1nD z;6%hH)i%;8e(7TpG6Iu_D;K2G`Mxb%uV0_;FRQz}O#S9TRp&GqZ#-I0Rw#wcJ@vA$ zk?IQxIJvc(ERf)D+^E#cL7gTu(+w*wi+qn;kkc0Yp87T7Ai#f)Lj?brd3+_JNH6|Y zYv|gjaJH57=j&4{X4&r@-CsYzyfLW#(#DMmD-yo1^}fa-hJQnG{-ke2_k7XxyZ&L! znwTDBvvRo(J(!+|v&8)=pUWdD+C))j>pgUW*57NFxKm&CRjKom_k$&U54`ggm0rN; z*upe@F2td$vP6Nd*0EO;tJK6iYliOgOYYB>goD22qCs{-w$rzahj%=Tg~TcA6AmLE zIWrty)VI4gm(YCQZo1q4<22`)@iDS(GD4xkdHZtjMCU0zIhV+lkt*jvtb_f)_&=XU z9;4K2d|Ynvt(*dK70THxZz~n6T=*xoH!1QOdSSm$7t&(s><~5lT3CpfIy@8 zl`?^7fl-kj`{T@;QaT=;y*Vb^gR^5AWQ1F}gAA(l%K6aJbWHok zdZdWfIUvb22g%D8gZ&r`?K5@=pG(VGYxEd*DW$7td?=@uF+Ypky{)}YA7J6j8=Ln~ z+#K*?tF~bJTTV&TWqC-**>%OaC;?q(T5l1|=keL|%nKch-Y*G?x00rFY?EdbtsklT zvn9#L777(NG)DCTRu)<8)IMNH<6DdQfiZD;Q8ha^`z7Q<^(Ez#eFB4KdrkJ}s!?~5 zcs$N4tjIGw34t0!G>vhOQSTgcBJ{e!@Md$DhdsKKy=SK(3zGE1)qJt;^`q?)uMFzf zjG*{$<5`12pw{N|^wb{O=v0!1zKe)q$!BHhUVhTGC@!VQUH;{{xTNHbJ7fMEc~7b- znHlRXx={m)TfrXBsk#Db{t{}q;13Z*DHna5HBn;M-ChoFm&)ORaoveta}DEp$8#*A zgDCbi3TBM!RDND@%5HFCj#162&vsG<^NV;E%sO_xjK{t4Z#BNmzoj8xWuCFqt85N0 zgVSa39})>!{u zLe*Da%_BcCoOhhl2zdp_cQo$cJd~%?p!;t1;V7e=zX>(SV_wsHV}-nWY(ofyK=imr z=E?s0zD;%Sw5O-h?(SwUR>V2VWD%U$*yZ9D}X%2poISvO>>u(QOnOa|Ocwjpm>GB69Gy^A;pyR}K8kmx!uc6C!d^ zSYM~_2>%Qg{yk`j_X~zITg^O`#Iua$aoKlo*=?LO21CIqluf8~-^a=GlJ)I@B=40$ zu?9Rg>{JAV8ur>lC+8ZPZU=LQU8D8xlw#F6K&Uv`_)=jcUIyeAebb)xG*}rk105a} ztF!d|&P4laq^;Q#qVLm5%8q)U0)L^a#Oc+F$R|g*;Iouv`FfUsE)xq%iO_pN|{V*Q~v=nxJrdfGTJPpQ+Q3@8!?eG{Wetj78h64wG0|bsR+1 zuii&0R7G9*VkK0TvKUhRZrK5TDYgD+Mgf>+zE>DSpc+URAAU&x54AVfYK61NdmfZwR z5l*j>go^5)4DVV*W%FHPv3U)xv3TsQ~PR7FHYY)=&@C!e5) zf6wM)BG-N^OIp`t5A{Uzs-+TAYAS&HTvj*mWF*Af0^ma$HcHJ*rP4)e3P&rx|F zM3aZsL^1nur$}K{Rcw&0~_ghNb=xwYfiXYx>5>EDWf7?WwCi86nZk;DMkwuF$pZm)i57kbfoh$HG zKHo!Wv6{X<`q@AzIK!dY>!bfszgUwJuWh#I45$9L(_X1ONffe@r6Oko#rf{1)VwUF2QA8SQhPU`+%poxVc*CsqNh;NK)x zoR222&x*z&QY4|XEiM=Lt(XO5Rskvmit8`YGzm#dkym(Y4_ud z9qRI>e@mojAkf6@=XUT9Z@c56ZcfCIQ=hB*6akCg5ERN;&>Po6{i-=vUZa<+!N?NEv*Rh}b6I)Z3#ewsad zk-3p?jLiF-T4KsN#EHc@s^Q8+Qv6gBL{<#@boTmf0I^Qby(hzetN>7h zVY4H4da#ysqJq@qCU!~Vt*8erLy+N&=}t_-{!wn@$BDE5u0{v8IQ(DuySR76ufC(0 z5M;UtAdAdAvzq{iIbUz~s7f$JiGCEx;OO)hAWSG~3$n2A3pn_)V9P<&f4Fs++;n{H zkPTiAo*f3CU&A9KBMi=*L7Ea0o#DLY$YY{In>yWGMJVSmW2}L&`^4nmf_ZJ)CD)b$ zW!<>C8>icu;MB!O?RF0-vfh%!0n0O{)WL1`+zRaz z$0cLLv;}B{r8OxnNcEIHxtIa%4PeVNxNP z(giV(+fVNz{+TyAi;?zivR42{^~r~V!2~4AhsPh?Ic9&w92O2>9RGmgGf4;u-*`+c z{Qgf0NuOD+p0-biKJ%rEbz=V@BI_QZs zRCN_Kl6n&&Zw%(&v|^P%{0ng7d+Owgu8ym`upqa%_j+ud={6S{?GWy=JLAA(;i{t#|93FhT$sP8FzLlVo@@=Ziv)i!* zVpZA?w79Peezlf91rc{%L|>W3JS18ke$vlMLXZE?Mb5+Q8g8NWLD_> zh*~^#&td3Cel1lZ7C2Z+^FIJTaCbk<^t-f09KSW8eL4!NM+z1f9*TH_8S3|!o5)yC z?>2b<9w z|CMEbtEmG=Y;XcXd^38 zp8`;_svlwzRfRJZWK2;MX0sn8u&WG|Gly;_$_B|%TZ9JgvbDQdU zhYs9*@4L%zFFBDenHKyoar*ilF>f^CIORvnnbyf~zFPLhJ6?`u; zq;v`^Ihr;d?OW^we^4EAz|5rY<sA{^-r&2~)K;+3Lt>`kc4up9(v>+vdcC-edGH<({oZp9p1N{O~qA9pmIsSSr_`f$mqS5I{gsl zpK1oNj%?HVrZq2b960tAxv#L9=ZgV*;c9*0NzAjI?)BVDN+np;wS~S#?mN(xd(m39 zgTZ!zo#2U$-mP^lS0r^7c8+(pU0}@5ueQRF(^_00@A9WI7vuCfYjuxsEfo{ohu|vk zwpEu5=74eseHGc??1=Ul#Jn=SAiPe7sSHrs~v3D{FR5sT>a_U1IN#Em!&0u%v5k*A#RVNW!vMJ> zyY(H}z8?J9^-O;F5CI-GHu!D@ff#N%KY8-xy@4Z5^x-CGgxSd0kW$~}6YS)b>k zdvPrK6r?%HYpKW$?s*jn&UXFt`}vBy8GJltRyeZ~pln(+O1^saVZt{jX)B2|@H*}@ zcVZDO>|^7=dTB4W1pX+)S#gk zjom-%OU<*L3XV<|b5jkPM~I4B0BZV2xB1ZT1>c}Y8z4OdaU%LNzY9*@ATx+G^;)+@ zX}lylUOaLAcuRDd8t`9CeV+PWk;q0IIrQ%b?)9E=;nlDQ@}MME6Pw_Kr#4e&m(bW) z){X19hT0V*u*vX91Muw4Z;}m=vNhm{71|F32GDwYMnNqYs;n*M!XoM|>y|r5`pt&W zQ|Bv9T40Ijcsgv23V)IuX9hXeE8P}w+LXEdwQ{>zp`$w`BZd~Hpi7pYnxycQLrPpu zCMU|eqK64dG@fUG3VC`g^;M>Rhud_^PMM*T0jAW)tA4ga@18gEIXW_( z@DVPa_&!=bH~}p0cqzlX*lGRxEEfpY0dOhWzUHf9dGegS!<&ebm?+Q2mZ6GiGvma! z--JV#Hgtr#jfdCt_;WO#>n&D9LvP4CsIiIat69PR2FsfsK6W()>Jq;D3jsNS3J-VMX zx&>swlx!Ag7Ao`Krmq4zWegyk0f|f+Kt12P_u=*59{az3T;Q+r0B~>smj%Eg0vuG8 zckf!4fXnD8%e5~7n84ZD89)*P9D5%d{@k!ZjAg!rrA8<)*aLVW0EkKiP(hg)8UM_0 z0G)&bc*6lIW+Ye|4B#XHzlIO95{|U(h1vI}Ca39w(8R=PfL;S|s*a~8*R1f}j%P-2;EG#T)m0MsT<&gZUxdb75;7%evdKLNhs zOznC^$Jexm^N0B-(ZW+z}ri ze_8v#`9?giAY@mrm7{g7XVRo6^Sk{%f zqyE8iUj*cDnt*!DWRI1~8{0^1ZV%*_FGPb-C$wLxj|;<5xi zq7ftsMMs-?IfX0Ina0C!pT|!MR?bE-3jq7Dy|E zfjWM0QaNfS!xT9S^`;0Wbmpd#ksZ%mv^nTZfcq-<<@_ms{W7Z^BuA=EE!& zJ_gjUIj@Q7&+IJ#lcCz(uF_KCZXlBZIERA2wdkGYLP`7y0ASd1gje%&jMDxJbSqqs zIW?kb?V!zl8~=E-nz9>LA`i8wBTUo1-Y~N% z8#jJ!2-1XrX7pa?)O*g z$ROm0JxTb*m{ED~?5y{f+vy|j19T1|Q95dZLBf`%v_wSMJ2Ht08A>cN{q%N=4Ds=0 zv(4nI@K(=TdVDLl(}>2s#uvEoOBK<6l>mz*v#WT5`eC7C&mU3pz@%U|)e}1)(J4|c z_UsBJ_O?Jo&C6OkUAAs{EGo>TH|n#A%qxq;$jb7L{BHq4bL^=jt*xy99S`vcVckQU z8{7u4q+{Fe3(Bb2+B*Rt7*?qsDlHNLf%DIDbKG_95fMJ~kK?a@4V1j^qI@ry`I4Hp zyE>kxmPNx6(eUb8FbGu8DXCiW9=15Qzx-3T@)MV0C0DGYV^tBfkl!^wvD$qj@+aUZ ztQ57!$p(W1EF7rtLWnW43_J~Wb<><6fl5&xAu*qVbURjfDuciYfOXt!80yJrJu+UW zcn|QB7Qa4iqexAg`Ze8_xdiWyzZk%un6FlLiciIz99mdfTG-)->FPfjs}L47&_**Q z(h+5(0I2!5^)vmU>UOXBu33Bx1P*@B%`f$(W@$VE!mY-B@B#5Vk5jcPh_7NC^IChGQ^ohPz|np#!|2@6?l^K}AOvQt(w z7wSM+RlT&=COgpmQ^lX075<~u;|#sc@-q+E6JHQ$oyhN2LTsrNGnfR#OgwS95vPlT z3F3~|#d46b zZBC0nU`uT`lLl%Awa4Dgg1453$45sS?o@VBZSU}(6A;`LS0@7d=KRBi2}Og3mV#mz z@P92_bdXY8FJKF?82GEOiPCzmup-YuKnn=sz8+ zs5=#%|Fz)J@;l8O7(M}PoFv~wP6YKMq}fQgDx04z{6~AcGX#hRzgq_AXYGxt)r;+S z{qoWb$Jo%7gLHxR;uuHI2^YhJTz3)!A(57gLv@XENozrOuivYtwc4Gly+C_aV(9HV z#5lynu3MbRz@O#T^30XqxI0EJI{YcWfinceO4_Wx`a3MFm|k^1C&*P-9uo5+p`{Jn zyOMhVigxa)%P>IJD>S{8|65mbGOAfJp9!HCw71(6_cP%Jj>aoMCo)G#ATg0mp4*B7 znE<4mR-&b@4pNOfb`C#qk=hfPZ7I^u}-IAoMfi0m|=}7pXzNwx| z;7#Zc_hp0*i2+%4g0v;9Y%-e@PL5?;=PDm9_5>i3*8bb(rnO1!IfI-_?Y>o~AqC|yGr4F{XzhpXfug6kt^~e@?{IwI#OwEp%N-g$17eFE7+!9 zeX6)p!wYp;TkK^xj=FpxW?LUPnw`sk{sp#Wy;8Ln;|XtxugtoL_d|`HuXNih5pd_Y z=+DZDmsSCk%LN;5J}34Qr2@tHSU7a@K+C|8aN#(w&iQJFcBB9aq7w>QiZhH$gGnOziP%h8mK?Nvyys?Sk_+I1J8H zH}38u{vS8_PM@SMcCAF@1;QmNr%&+?4r>@P&lbOX4!17A&gH=jWun&env zs9AysOhOQUOI}@~N>9%%hS}3`b=R4OIuMB_5jT(ZwSR52Kq zN|MnY#-?xwWekYO6mVio9|b11Gq=KEFgnTJsnUBU4sG;q8Tk8pr#2kq%6T5eG`dn% zlBYarxGT6`PiITaP8#fvaiOL|8nyYZh1!6}YG+L7nc^H*t>?>M0P%iM5(qR1Cbo_AKIMd&x7c(-(FAYD{O;0EyYOt2)~GMJl-u{>wQ9P*1tc8T0CZbXufi zBp`EG7cxoaxy%3#ZK0nJnXVl#>78qPzNA!tH#hiaADh?Y%8w)0W&_BYnTtgM-p zg!wG5@^obZ^xj*Kv7JwXdCb<+)(4yU35$U0`FeJNf1DxP}E`nqLFQAV%c zJELd`s@3gm!QNBnFx$Pc*DPBS+kUopbv}hCWQteA&m_+e>e?xh3Fj9~U%}HqKJ^=y zUOhxAMLlC>^jPXt=fSK6lr`HSLitad#i1h}xL^6+erpzb?XglL6TXO6FvobU+&qpy z!TT!2iT$}4;wKZdn;LssLkQu)T$G|cyfI?p(GQof_!G|zyF3QVJKR7Z`8=09Oh}&c zsjIjVNZ|Wb<9XH_yASk#fLR2U*Y|VAa(EqT$mQ|=@}QNwpr!FpsySviLDdk1DPb}9 zzU7M_vT#%2Wu9dYzY|1pSN9h!IwTU;`HrVS$de*)^*adi-sF$}z`eEUSxx;H%q7lr z(RQQ-65zbqC1}naYS)k7+Xbf()!Cc;6A9yz)L&D&MAe=u8LBh?Q9tSm)S?QQ>0&i* zFH$6(+ds(=R^&#C^iy{!|0s&Q@A*OyU329*ST5>j4jcHUq2=$LaWua+jn`O$rh~K_(}#-(*e$s`&QKxsY9`(_>X?9T$t0 zD#OX!!bgo1l8nrDJ5dELk3l>RZ_ECyIi#aLj2Z}1UCnlW5^)-MCPdjLw}yIgF$I_& z_ujmHy9*El0XOnjI>rYZbDf*)!y0-?h4q&D;4?l9?&(JACJPb>y{UTc7%`;q{<^k* zr+==_Q z&aV%H(vH>%uq#^orH^r{qZwxbn5)FiT?;_+9`-}LkPvfYN*rn&FXNJJxcRb5e_a)! z2~z8?OV)d?5)+}2kz8!UT_>oQwLk=5Lgl(8{HJ-wz)*sGS~) z6>hiE_`dq2%!v9b&c%tl=s#8VKeU3SZioi15?B5f_1vBRtipTg=E%(aw%<9k$FR~# z105@g<}iUU#vd4-qvwmkt*?B1ymbJ+$#~tY_}p z64ajTs+>%mamMVuF`{yQeH2yM)~*q`x4V1901B2Dr=kVM_ZBqS10~VU*C0dh^&B3- zOKTn*F4~RVB`rlDs7ROW$`HEv7n2JlRcUY^dA)KUZinYbBF)34*l=Etj@LTAb$0{% z)CJ#UwjY`2f)15BL+Km1)5cGW#MU#QA2u%ZMnqdKEd|t;KkU5pM(1u(1?@urtqSmU zq~Rq|@99ioR>N00IzKn|U2e13B5Rpg(<|Jrr}C9Pq8e3bwqBly>32j3P65l|5ipdzMJ1g@}WiJ<-K;rGJF`<{pDzbL16S#~-3#=r0|FMQq&Yolri|Y_qXx2d~a0CUF~PQ##TS zgc2sg4Skoj<$KY@yRJ2Io~0z3(~)m*JNp7?@9LxywLPtCi6+5yAUaE3n!n;L6ogvc zBG;Yw#P2;@;>9^Wu=gV*(wND4jKk)3XRqrIY#4wGW(2$vr}HzE14?a&po*e8zaGm@ zhq$fC3X>YA7gb`ORqj$JLi{wD5`*QPazr<#GkQEk^sKxOEm?;O;MuR#Y;5Ek^j7l_ zD~n!Ndb)L9S(LQs2!#t@o063ZR$8Ok98(VE&MXD+gK2g)DhYL9#cHw;Cg3?HzHcyB z>!7hVFcqgyk%g_Rk%ib;w5-QhbmEL;8y(gb@@RDW{JK$PEZFRO0U{P^e;OIFTtPvk zfzX1iNa0SlnudYFDJMl24nlxs>lpJl<<;8*#B_kCyC$}vbw&OyIvEIbNF-VNg z+)hs{rA7RcyCLv5&Z#b(l!)SGdRrdD?&cpb#Zn;AZ$<_Xv0p63j$*wi96x1I@Y}{* zW8e*w%MI^|vw&|Lyz^U-aZad;<^**V=PRk|3DY-&^w?`(I8+pZE{4AduscW7;`N4b!vh03XfD-H~vTtCO> zXA&D{0MQS+O<>tiK&;_eMKU{kEDRtxt#X@pFWNO1+$Z>!eUe=B_{t-D0%AanFnGzI z)h`}_j1K4rTUxTc1}QDw^;8F$D8As!YJyy$87*#ZZv2})I3|xthb5X=L52?9`E@90 zHzFnQlEEL9*{)3wa-;1G^9REpcMt+GT+Bw>CX(3x)Jj#km2ofHPU|c5Iq&7=)s^>L zSC40#FeQQ<+`&h1qjR8cu>v0ca4Xuw>p5)>ZZ*M&- zbJ9qUsCrhFLD$iGw)1<_2INk65uF+pP5zl>r>%=3ukg^l1j;}PN4cuXd&6c>~3q~VMaIfC>MPiNFZlojY z)y%|@+q(%Rp;p_~nH<4QhMEOh@w$PbUY4`zBlc%g0u(5vPjp|a3Hjj z6&#RGmS^vBApp!(=+s^n7;x^TZdKldB;^)h)QBNU&Zjf%RNLGJZC*e*@)ctr#RFE% z^%Rsfn#;9#R1l;L&CR?36qwvx9xe>@oQV(S=d}V=C@Di}d4*F+kGkero5K2T0u~al z9238UMBlaqoC6i|TKRbP*BpAG$h#fmtgAGpQ@_|t-k^A)h$#Vs>xS6unTG!tBKZ zlP4JU_i*mrye}1rM0IE8HX zy)pi3Zh%;qJ<}c$5yjJ3%aP9yWTk=&zNx=v1~wNCU%&sxLiiMnvKG!dDCLeA+KMJd zkW$Q@6B1fU%;en3Gko`6aOca-gVKX!H9NB-c8(jwKs>cIDACzsgN(2*MqzPB4!Xw2 zlam0%e1i-r?g4PMWy0f3AmuBw83|vdz{Fi$?5gt~w~MOQB8*!E@o)XtXEN{5_Dgz# z;S32t-0fpScp!b|OLgfXMCI0EZbZa-98IedSk6nJeZOm{Fy5Gv7>b;kNr@3bSJ{Cx zY=ZEh8G5N_S8KcAM=Ek>{>donuA(Jha3Ak<&&A}vvf?{NP;g;ZZnMS4MM)`9y0)7? zy%w$hfSB(r~O~1ES)&nKj4^*c;hq{jkfoAcVq@#Utb}A`Wd0Fib5tW;CT+!P1z6YNN~r-Muhn){rvW{v$Ih= z7g_l^E1@T?TBW&Z*E%eX->1o+opOj*5G8_oKAm!M^mts?XaCbA+EjnIR41aAik(cP z%618#TQPLmWDPx}hpJVb3vA<@#29#Aeu*f;pm^dF+3-$C!T1tLk5wc`qZ3>g)uKQA z!W+d5YV@Q-3Jg9W36juB zbcIjf_9LD?9W(Gee^Ft1cSG@Wc$%JjYdD!1&RiW$pDQ)qUK?l*_U8J^a~VJCR$vek zF6<6}G&$5Duk4`N`ApJS>C?zMZY#3}Q$>m)#tJ+S$F`9f&L-Pfn&ch|#f!uRXnx1o zk@@Et?5~!}{v(atr|y%yewE3o1^?Yrf={lQf- z)=n;N_ZAaVW4-P)bXO$r@e5c&PMyjId9!Y~^bbdhiCn;98Z3`8~@S*^Dg(ecM z(_~cVbv$-ZtTajMYoTJ~XyCUwjCrbHdH@rHh%w_4wS=K}m$>3e+-)!UGq3zJDtPm* zKH<+|=-7Q(_o|CHPJh*mEq2{vd6(s%X=$dCFH%)4;Skv3rvlIQsw^x)CU0NO;#p9a zo4XY_V3dh-uCn*(z89^?{GdAXKOOD|wd7z#_iV|TL%F`}LaRo6H}AmQZ?VIK?-qmS zjy#u+1?W27ZIO=y-`#p51+4B|wr6zK$&8J(ceexKrZCGkd#O9BeH3a<)t?hw=il+^ zHBELzeJxF=dR5Qy`n3Bl8}QcOFzirQbYQ&gl(;q#&_7?in0+$Q9jX7K3C7SN< z4Psy$t{A+ogJE(PyNrJ<+O0TkaZgl3`j_XcjD!<4klcGp5ef$;ck|QbX$O)5q1_3| z%D>0{z>r^1i}f}?79(jq@Y2}?_2l{*9G9hUuz-^=T-Bl4KaW_$OZ9%@k9qiLO2kFn zxp8EKc?;4%K^}oDQQa*SXP#`-AivA!eYhlQaImV{!l}F$xc-WPO<`I)fk#wc*3x8c z(D)rVsXe#2=7hY%!lg4i^Pgv!^P+&gQJ;yJUO7XtJ-gZ$Od{H!oK z((5iW&+6UT2bqsmJT&Qm5Iy=*TT+ff_N$4KMx>KGs|{wCL$WBmVXf6Q1%jGg$Q+al z#n1DDS}$D8wtS*)K*3auBZyTG=Q}1oDD9juVhOJQT5(?L$=j^;%}FIUhBBM-bCq?~ zyiT;E$x}nJGMdlM6yTimfLd}6x{A`H*ILVU^TZS1LOaaRbq%Z`?Wri)-@qKI$}>y6 zPUSS8gmY!7nd#$gXYs)hw}xo|yi1IR$B%*9sNI0a{2H)64TwT6hw0I3+_NI9c`$ZV zXw`cPO};D+&a?DXL@#rUEw4|uOh}j`oPje2$FZGzJ+34Uwuj;+ z#+D|qdh@PsuYArwlX!rsXR$fwGG~}1V=9OJqzH01fbk0*2YG`w|A(+w-6Q&^D!yF z-dKxRy1*AL;cmQ}>xkQp#gTM<>Mn$h&D>d*cBk!Yu%B8s^5V7}-%W~R`ty5cUXFg? zF+ZK~>MjWciH?PGg%TJE-~9+@W7A5@S7&wGDwZ_6Xl6;~I>?k1VX@WwY)3Qxz*}N` zMaxU&38h4k_cSaN2Jh@_x4GRx)wDMh8$w&!ySP|vFXdK*7 zTlsAd3XWAkkPZ+!0sfQ`A;iGjV^O%rl=i{7Ge!p>ci;4M|SBBc5WV~Q8^t0XFS53Hcn zTHZK^y~D(I>7$$PH!#BtEpl(K$#qw$*|-v6h^~iRL2_Y;TtJVkKT_BWGOj2^;>BnS zD~VU*?QrJ}=>{Z-Qx>iTYQ8w#iQ4GRc?AS?&IrU_*k4|{7Y|z61x@6&vj^Mg^fbi- zS7@;LyKE0oTfqvy@2pzD`dj<2OvOu8XdBFu5bZwj?VS!iKVr`4Caj}!GO-sIjc67HOU+_$)#|+4`3TQC zbI+@j<72zDGiCLuA>;vtRo-o&x9arU%L_h1+$=Ia=i}Go?XloC@^lpg^2!e|clYEm zJ+b~QKZGL)mobU?bw}%|)z`Ji!q43VlTBCP)5KLd`Olv}2XYy(81}#&^p@vD2=W&A zX}O+K9^a(R)L1Vsbwv;0sBAUE-}=Eg17dtsRaM9CRH$fVz*JuDY3*OUxd2IQAf|?~ zxN-Vt{l)DSii*$nRg$=dmjg?epnjzS%qx6;-7+o4B|*yx9r9$%$Q$=BDJc{TEC?C$Sm08s7VD{Ni;i zLy9l!d;c5>;3Aes4@XE*PS05k4GdJXh3bF}H%~)B{O6>zCL=@t3A`H|9IQ3%xdkSP z%LkZ3>W3p$C}%~3peR>d46`h>rc$n<|G`$ZDV@8Gym)U zV>tyC1*0=t>H6ZRi`HhT;4sHiW#>dCU#?HE;xd1>2j(KI?OMV$5#GqQC z_4R9SiYTEc^ydvMVBjRnR~ReM7M7PsX3FR4XlY%sfu=Y(I2bS44b2~784j;^(%sth z&d=XojCC^7)lHR32R)c#Vq*OGQo%q$2b>|`%K}cnTh1>@NoV_#g*`B6dj6AzOnYu- zMgs}w##Kf`(6as)k z;A-G{=g+Z%i*Xa(H6ib6k$4^S?CH~g@pC@#Zw5BWu+L;2sOH_>-FZ`vQegP2b^rA8 z$#Z=C?PGgL8?ZBWbTq)f&^-B2|M-^zZAnql(+77H6&0Bxe6CHY(>M?A;Ns#!_rQH} zc4lwHR)u$c^a@m4*4)Cv!Vn>0;g2fdTx3J8eU)^yv|6?w%SNuqMeyShT#=dTR9+-Y~f5a9-A67V@mifZPHi}XBACL=29g(p-)ORJ&t7oa2M z%>Y?BU546+^fsU~eT!1PedkMH+KLD1$KEuaYPhTaIgFU1rK~mQU z8w*SO@{oe+*{803OxjGdU9j^hQoz@uW=z6_=+2_o&V!r#GYa)!uMF)Kh0B^=jQ~3cj+Wz6Dx} zoM2+BkGww>`_}w|>?1ZFJX*CXYpst)oM3BJ9AE{R*1s#*SuwuH%!Fd;6aZ6mWUHKU`t)kXDO2U}HvBE;L{n)2pr1VdNir^E-)~>6i$t6`RI0nrr5)5N}N9oe7 z)7qfn@`_PGmgb#>I}3xV(ODDxcf_F3x}lrvfLgS+#=AQBQ5=sEJRcd89a-z|XYTcC zeWKEAEAUB$Y7NERX5Y*X5YnDwU0aPzW_bs9)T}0#qB=Zx_JrA;93OZ3%#k7P>xedI zU!K>BXHO`RHCwH4S_!la^=?9LQ9!Uumd^1d(x~MTEH7ab~+!D0REVBdfF^9?lrHDwih{V~( zLLPa6Dzf};qkI|Zx2E#hq**i!pm+|Cm9fwwX?-+=)-VRv!i;B@Mt_f!YARn!Ek5A{ z>3aYkD$eu#(bDEbQrSE6I`S5ThC+UyQGdOEP%NP^HgG$-^0a(g&~o8R*4kJ>y<&rv z-ehWyM5>RLNLtr@JuZZCo{LAC0#QLE?FAPnCudpOqwtFH0ZENTPA`s)SZ2EV!7Wk{_avFriW-jVO~A*zC{!N<4uBb$VLz@s5Yb+I@ou zXvaefUbee5-FGk%m=oO9zL;16GslBlVDUy{f@mvsD5iAGTU%QFWzrNFx-4T_t`;(W z+ecuI6fR{pk#}yk+dXLvmd0+yrY}G>CNY=Wr?QdauA`yhPj9{a*{N}eU*ITYC4NrP zC}{n3|U)0xCmuhPvP3FQ5ph+Ib76)Jj zIf2C|>BRS)x`P#M0z5p(CU9zEhkNNc4A#5NMzVFgj%^eb3QT6F`-LJW4|h5e@R@b& zNzN4bgK?@O$Bo2a0A|f$6faCcb9OFITX+E`rne9k8@66eXST}W(1p}iC{6u}7}80y zx7WMB`_gJ`Gd0i?Dr&ph!TdW~F>QiJbD|e$W368^7xJ5>)QlQe1nZES4{t7R)1!SPirb~FU{SIBtwh$8W;qOmiIiXhfjA$ zr>4BqS7N0Zj5w_Y-hc2<*)R59eznX~4)=aLyLaZwMT$MbqOH;3oUCk2t!C_~UN0FG zsl2P5>ZtJCo>q=ICP&2QZJyD_L9>>E*;Xdf++eu!7rtcOa*r0>-5q&_w=*7n`p=he@St<3NOSPtr#VY)gWLr3~k(Py{@avH~Ho>>>$ zS_Ez_x0bNVd-K3mx0aTcDWEe4)%qb7B?%_}tF1ZSOA9`8Td1TO@!upL6z`M1yG^tbT^1gK6!GP*9~DkC=XVfH_PuYF{|W+0t?9RKY+HP_+E!uo6_WxDpcj_x0y%i8V&PEe z9^~RKyC;YMUw7Dg7*$P9cD)>-+-@1Y;u%w+_4qu)6FVZ*9@(V<2@DV2FUJaPsjkR# z(HtPd$gB**&4d?U7UcY(WEjt*GZO=uEoW!P68sV9TwiOqU**k!B**S!=IW4dj9fZd zvWM%{p?KTf7LJax=g%WT3jgC2v{@9BDLblce;!|Ykw~ZfnIz^p8Ya@Y+KJ6>9P5`n5q3O!l=u5bB>%@aZ%ok#?4}i ztrTEUWk3W@R$#kVOZIC`!OO5+hRbhREEno2wKUDag~o1F+I?0WDIx{#aHN1>Yrgd6 z2_zPcCyQ!!Amg^D_M>*<*Fv5xb^Pjxl+0P0IxV-;B@-UyvX;b!J9q9pjIJbqd$k-* z@qN?A?{SR!4GwAgRrWD*Vp>g-&qPxp!AAw0fd_DI571{B&x9r=Z_VV(VQ79J39zma1*{14I#` z6oy`9D#Eeaw44>*f9s=kzAw$yEF*^Nd31Z>7Mvy1N?H@Z4xC|QVY49+iUqZs0fwj= zOpZ-9T&25~naU{#s_p%r;$A3<3m<=fr^s}G(hBemgJ0a#j_+EluM5BIlhN8yL@YE; z-lr>gW7jCc54`Fa#fe6P=k-o)9#QV1dQt}3c(?tDqoV|=cpN@d8;O}%I#ej3rES&y z={cIA-{2!9#kN{nPv=z#7}UkUJ&vSSCyuO`yJ@$e~<)sb6&nD*!VUSp8U9gA!BUrZdFEhXr>J8E2Lk8@_KrtC4!|J-Xx z`o+h~SJBgxPtU%&PUWLgNb&xY+ITg29~Ww<`TMT0^pW`1YItxN{-yU>y4DY)s zvw><-FQal9{}d53D=Qr(r3B@k`A9I4e|PCR%X@?Mgy`Mi%5SS?WNp>B5I#k9fu~#KB>* zX30QQqv`w%_Z;#4$())J_u|%UT|(bb_Wi>g-C#QhRE!?mV8Z@Z&Atmi3XiuO-jX|B zB3OMw$D1uZixUf!W1x69I`!bSA`FBL7uG+RP?SUq_8FkMrNf_ItfH+qDl(}nIZPva zvejm7SqVzkuJv)A6Q`3UYg0M~t{Tgcv4?QKYTkS+BZ*4OSvI1I;<&{4QjaA6jTB|a z(F(z!Zob_N*-}N+-<`#q<=#9Wm9ew_vU)6%Ej}Zm{nYkgZE0buH!f6n*D~66z=QAT zkU3$_NmCjmjFpS^cWvq;Eh3MZ?AC^K-`R!zgef~Il`YE2p=pj|Z$?ZW=De~onR8FZ z+xK^;pop+o+xM(4l%9!CwBn5}uvNM*aGTmXVsp5PXctTxxdTaaY9s=v>E2(Yt79BS z`tqeqd#8_gRac+{)e1zcJyjqgL-pNo{)@Zjdj`euHHRZ#DFGBU?^m9^&^@gKFn*DkTm2w+}X%=-%s_KGPhq1LVK+=mAQeQ&fdWRHAwsUi&S!{9~}vb zVk-=Ok5wt3Yir*ypzP(#xXYB(G1a9u&nUi`FgSXlEiXXEW{WTnbA~n(pBgUI{-8?T zg_THd=0(dN4E^}w%*-wj%uOP(r^rVFOPDJZAPH7jxNr_agU+1rj1Ca&_&V`0Lm&&g z9FcF|d~7LjM|8h57Ru4$1lSf?#98Qkq2<=9=3{5B>FIhjiMXyX1&ot-Vk$Be6P zGK~utOfM3D-kkS3T)5pPM|Z-xcjO0G647sv(^d<$=_iI@2-HaIeNnVh9K{J5r86A0 zZ)B$2PJYT=Q=6wmv~bC6?7})DNc1DA4#5gu1j^EhsRY2KcwLiXfOe()Br zy#5xC8H~o?EnM2%3gGW2F4#*NJC%f(-JeyWv%Yn{%7wFyNd!}L9D-Y))%oCo@3Er_ ztBp=-+rXASeCWfX1>Iw-?xSLtkQ1Nkb>;4_MzN|daFM36cPlzWp3M_;UcfHOuz;8cdNo_dF2_#?5E7)JZJDs4Tx~^=)=sU;}bwc-umv{yWGT&iQGZ_Ym4Df6Csi!m0sow zw$1wv+`zT9KO)q_LA|&v@0KtAQ+}v0yR8Yc2dHRWrHZaI{ur(w0PX#noPVQr-t;Qt z-}(lTSNG4Qm%EO}|8Eo`0XK#7U+DZ*EMUr)al`e4q{7ug8Pp0m31uT&jv+NUufT!~$&OmZ?gR&sLkD|(QG&k%~2 zNJ>co#bc)GS7Qd()n0Va697d2Nl8BfOu|)(Fyjfae^_)hU0A!QsA##(-^@QG;4}Cy zS*ihC<1I#sbQw^t$M$Rh2l-FdpP7kCDqZHe0AOYKyMKrWYd``#{>kX$pu2{9fzl@l z{O8YG@e(cn)P4c7{~`HR2{|P%uLpc(|BOCR-Bv(c-Fs}*Azsb1Cf7snzr$DfpWP21 z!KwcLksG$7qN2ht;cT349&Bp|3%Jf!9lgDbG&I7mgG`tw!i$S7)<=s~RaNiay2+k< z2S{MNycZMIc0h(31K5Qhr2@3L@Q4Ur1AE>1EdBJi>17Z#eDn`xe+8^vRTz6}%<6goiE zt^z_EpUsX7z-8W;^8GjLNGUNvS0rnuY^EGwDrCxKSA3to#a{W4fX(2oX46Aq;dU;o z4G}n-Xu6E4u>D&Rg2QDw<=;4FYtXD<_8h1%%zkI1Ca-3Jhy>Ios7$Gms?h|Y z34s%t41%9`tl&n7vvlq>n1|Gm+R801RN+M5KiJ#fU&m7@-n^eX@g95-?PktAvvA|x zUGU~TSXNPijfFE<9X~dv0?}9?s^R&-4B+uxFhRxGhr zYAlZQ+}NCE*4=zfL81QGe?aj3H(Ez#C8wgNd7s9Gj|dQax$RzyQ{dmA285FgH^tPH zweDz{-*~6)$0nUwoa(L;#SOH3K-^Kb4uW5#knOu?KX{}#A$pk0u-x?r+|Qc+%VdtV zM`Gg(8xKY}M@88=OjBZG)pLuD`Nr=3V0QuiCgL;{9D9pn!r=<@4|vX%Y7Up{1E~*;k?R%`tab-$5pTZM1&|7q;gdWF=909?h#%vH(#3v51DXg?x7bCn_I%d7iE;r+c9$i0oy06MpP;n=pEo z6ENa8&JeGK6Cw^iC8aB$cWn}OaLdInauU55m*{7MUm@`Qcu!0W*tojvXOq?g1jiT1zP}jT50V7{j zo(s*Ns<9{{%~kXcRPN$*n8_Os@(RtO;Q9g_|3G=hJvPAn_P%1(k2i+ctq&ds3@1f) zIaC$%r4lh4I#kLj`#*}7OSQJUeS_{+=f`_=a4;WU3a7hj3=$C;iTm_v)%b|>C$as; zp&W>?K*)!b;OYf}?;tP$7KF_%c(fRs1cvahPCKlk73OZD@S;0ANg>+ydxZo}iC?r(X=~Np+|URXo-W2i z10+SBuy527pK(eajB(|dn{YF(JTpubrW^ERUw*F|sPJGh_e6%(pPq82OqRbm6{&6@ zD>Ur;_&$~+8>d?pL4s$+$2oJBXb&lDI@ifo**AnW`fhob4tHN<$x9rbWP~Gf^h+4J zD)y%)_8+S8;uJ-1ha4j=$2`5gg{3$K^agq-ceNYVBPR`1M#xV$y-SH38_98p%aF#X zO2%kD;%r{L{l%`0g|juGBR;F}k4~?$25p9KAPD;GdKo=eV01=o-$5;R&z*xv_nua? ze+?eq;gl_OE?Nb={}WHrEAKkswMKt0ndl=|Q-5@5Y+!ym#@~6+$Y>FBtTJT213gse zVpL-$tg-EX_a}Lm@$t+I@nU%8(6_aU-^;9U zULC!xG5h!5h}4zo{Y-!F$X@_pN5WW<$U|)-LHwuIj}4Z`H-Vk=vBJ z7I*_kJ2dLeKacFHh-qpV5gow}^yX%;KH1$7a+*_C)3rBQaIQvGQN5G#l$YD&2jPJ- zgOL{Nlc~w`i5LMUBhU{R$dxKxf3ptNb#hlUJkoH28k3D~I6joM=Ed@AnmumKdc(&9 ztJo{npZ5^`^JQ{>+0xFkhFfqs2lqXg!BY~m?N@d@gNKrB)v3O^^hVgtp>%oMdOan& zn)Av1^3v!LreZbBNQ09a?|_u-=Emd^^Y7e>u$#aiy!D8caeJcrvpV9r1`~4!!@oRTGjr(WCnkBQ|1b$$J7^}3} zjN!2>v&ro?JaGMWaj)-S)(O1RVi|llR18`rf z+9j$&+X|lX%aF^y@IV4I=|!pK{#}@S7GD}~(_gaV@f1Qu_hR{YcPPe@k`$0bBZ^HG z8Q2@0c9riFY5KXJs|c=5Xe%GyXSVnRsF&HBwfVDLqsjaX&)=Rru=~)l&t_+@HO*i^ zgaz=SB*&el>a1+9`zk`UHW9XqBE~^ncJf(gA=ROQC*yARyW<{BHj;(6UdPx7CaVav z*G@4@!-Rrjd5+AQmG%$VCZy$P2_^h54K9)D^xBuN^$W;srMW5)Sq_&|5BHmt$R>i= z=$^|k@U5ky75Xz-2!%RhG)s0Io2{6!e&g0Z_R1wBBwt5ctC_*7d?lSacFu&PKbN@l z!`Q?Lx&DdaEY0(TkRNZmj>FhCwA(WHxYqZQ#3uQlIXn@t$&u_Q4&FbHw+#3QZnM!at2Jw-4u60*6-?}^@7wdF zyDN*W?M#0>D6qmcBhh|MG0t5D9D%Ssm9m9XKg&K;``P{bsn}TM;vDCvH&*e!@`(

h&+99vtsgOhXQOOXJZqe(_j0>xEn!{fnzS7x#Kz<-RUtja z$i5z!#Y-z!td(tlzougjv(eJhjheT6-6R_WrEp>|qB5yvQ&$BMq&zPa`DSAGGT`y5|7$z*pvx$5x=g!(z;b=%wc)4&*q8YGUmlk%Jna{tSS*zJIQK5!*?ltCe z#+L7)Nu^YDzb9CULV;LH(nGd^VZR*4Cs#TlZ^#8;vTFmET@BG{XKHy^aXDD zkMsD=;x%s2)TSi!)BK#Aj(IT(#JZ=EfYTuQQOk(FZ)gZQWT04ae12`Ld6kY+}tyFoxeK)OQ(fuTF3Vd#)c5TtY9?m<24obR0P zu5aCS*Sh!jhYN>c|90>9ectzZHv1^QUf)E~Wjeog_aLxO<=r4Hu^vlLKZcF_E%p0X zE;)HytOa4jF(Qp=qW4{FHtMhV7nbguw7M+Z0jy)k;gWA2LldyQhg)v~&K(JYJn@(V z7k#1knwFW1F#j>Xx?rNnPFrwauju_6SJvR;zB)6K8rS^3nQlF8Y7^`kaGX0e#3@2| zs{tQurE+&!HW4Ve6oe(PWErP9jW&tqSbZmM6ROzI=rNoq4eni9$q-wbkE{h zOeZc#uKEqFhG^Or1CEoek7C`3!pLiAt5yHHR+nvs ziNL)=@kUjACU1cp_1<65@1)jOPG@!~i<6l=b39Tpb;DK?+;8q_msxlEv`48yl|;8! zlr}|;Af14g;d?Htrb@qy)km)br1@lNa?&yOS>=fZW9;_sxcl*GlyyRd1(f|KXt6>HveiVBUY78{=@BGEIP z4&k_utC;;1^Ijg;H0c!G%Y!aW-0X^wszdErESoFUBTbJ8_2S)ko^zJfOCIEdv~$u! zw7~f(ZJHMWcm%O;A@BlRMbQ=ISsHdn4ffGXLmnGKY+YO{=(+gb6rDge9Nf6o_eO4t zHMEo|Y`=7<%2f|hM+fH1JJ=qX8y1~gJyocrYY84U2_!U=l+Mt54$f&+$!(z;2u(yP}bA3e!(2q%oMO=HdPuZHmVk)_6w( zCCgo1*E|k)gNR&$WXlRAxOv8mH+7*L`r#;E!SJ)mt-TO;Y0aY@ z!7G}U6KpgwTN(`*-$X3bpGVLbF*RI(Zw(X?D7Ba;#jFf7df}*l`u*+c z4(vej{%FH0lgYTwFvb4()D5?_?a($$?~)0t51V&=0(YFrd`4Rlv2jFoN7Z$o zqc<1Eq9Qfb6vKP>FKgkZJvgik$+)T&qd%(P%5v# zw3VM?D_g#=o69>>1$N!%fAoqA$Ju6uGWheW&lsws;E1$oDY zh5gmaq%A^zNv&H@qs>mz41}uQ1VhjlMOo;8sE^HB>v|@;dv3Y;#Lrz%rX81~;`c@} zk2-iVpM=&z?~unxztdKg?fUL5@S13gRBxBk)*TJK$n|4t&BCFiMw%+)O-*I&d2FgF zwj#_P@ju>#^{ScR`#g{RvU@3*BH!-vq$0|v%RtK$EqFceZ@n-~Gr3r6bfMRY!y0>3 z<9&c$j@F1+)XQ{Vrjgrz{W2|(cI3+}s2rzzZj^x~POPd&TFV?o6Jqq&5rjgrlT$Jfh7PT-oXDyKUVkgvaM z`C$?^w$H}5YVZVRz{xLDdj2E{Zso_Ud?4{e+auD7Iuh)aB=mbN#<%1oEjwhz)gA`! zn+En_7x;m{tr03yL}kE%=$P@*TFhJejgPA&;@LWThDr~N0^>rChmZq`C>AkS%o~q% zqEvZQdmWy(TVW%8+B#wU7s zI#0v$)-@>c%}x2*YP;sI`KsY}3w$$_%^!6jS=?qVUpHc{F#2atNYdEmEmcHc`6?Jk zyj##gu2HUQ_`Bwd2XEM@ve^kn<9p6rmh{*-L}VrBi>SQf$;l35L8(0RF=A7j#t@0I zpW)Zare55A!G|lYqYWXZlY<8G&gC`wzmAo^#~f^loSI$9VMjLw)ILxt+>Ub1e|hnE zTHDYkW6Z>MgLP}2ceexY*_La}-RpAGT5Z&@t5Au)NzGLD%qwGZaEt}A<7Bq>(#s-! zHn~YPWwHS#IgKBkgkv zpXxHr1|PXGd<(+>&wSeynczK!nEtI zn(j+Buo^U8Ll(p~CnFzSNZ6QL@=4&Mha+9omV&9Z^AG8Kz0U}ap$KWPs7=u7oK7Yja${^^|n4;e^rA!Bas?|D7jT`!~UtJR-Lev_Ed@_#_}N4_A|i zo0zVDdpljdbW~&O!i-Gp46d?&Eh2ntyXI|^f9v)bzw9epmHATM;Ss{&c^G~56JD4a z5!fpkHoCqqOX@e3UDe8_b7v0Pv`D(=gYr}|Vr1NJsG5$ZlvW>0z6>nvQRkn2n9kj6 zqoD8d5q_l&@l@8z-`xS}j%%VOF7O+65s>9C&>S!4`yCzMq-Ebd0`L1h~_mS!vF|dg8DRebb_`*A?MH4(Qh1SE5S?U|M zu8B70$?Fwlt`L|JjH5Q&$Fpmr-?ZHo?&LiF<^bI62Fr=NPXbe+p2a`u-S61t+9~Un zdJdhKi^ZX?6YGpOBCmFR znS!;htu@Sie!?4nO}n<@s$F%0%yl)rmLJL)MGchUZ(OV8io7}e3?y)yss{G9SZWJ0 z9+d$@c;M8+JvB77fmY+^&u{J&V*9C16K?|x?+yyDueHD1d!htOy=!(E8e8%B;V?e& z2%fkf<_S)$t{Z81w+Qg=dh>-B?@v<{9*xEj_Ihb|@SxlC$E$Yh{FiZQbX}C1uME;Z zVenfvi~SYkEKs!I<)z6E@RykOY|Ruc(D zxl`b#d9al3t?|(Ho_{s^9|Do!{KB3D+6EN-);`Zmjy`i~c`xY-ri`3?A17j^-YsgF z@S_n}{SbH@hC)HYlJFtJsirq6EL9W|)F12$fFgmkol_Q=K2j78g% zT2saBt>sW8Lc%m-8A1c5vo!O@PljIOH7%EhBSESr!ABa%7~QYqV8B^99P#_rl(Si~ zG~xqQT{w})FUKVDoZwTB^Oh^Qr?kaWnlvO5l{v&Dm*#1HfEm4giJ!xvBxLj`awcIWRmkEeT{bk>io4|ic0&3CGA+D*IX@mwXfI$Al0r42d zo~~Xbws9&i;At-exfOp2^nMXdE7eQ%PZyBOe7}DIf@)_GT|=<+0kzP@G&Z0(uoE-b z5c=ipeUS5KW(P=Y;m1@HMDd%n3X}n;?xz~9()HOvkfPvAi;Z`J2e>9!bjs^_gQqGU z9q>m0yUvm@@9O3l9hT=+Ygzl*W`X`C!E9n(eb08|r~Zm1^7 zPT?mlEiiPWTFvnU_LYC4gTB1P%Hra{Uo@`+L`$@RlXVBU_odx-DN5nJ^gjwBrDO8T zcHw=>K|o#arVT=bH%=~rySg>b==R#AWh4%yY-$W&e~$@B=m1BI9H5K|oreI3*WU1E z;A?Mk{Tx%NiaWG_!kWI@;Jx+$nAGmoG)7qIzyB`U_YnOjPV0*g1f7-^Ez5CF&3nyO zX)QAT$O-^5`@iQo;8uNl+;o@CZ}O|+)Hk*?N5H;w6tGIw(9X3!NH&h9+=3p_n5|Ll zG|fqNRxBTnYb6YW3nFX^o`)Jvj@>smpLOduwtqjcl>HJO6oZ0BRN!g2$d!A~#cOk< z9u}NGa7QmQS_&N46DNEeG{B#;ODiAU+qPoLXbhO?Q>6UU*Lljpl&eJIm8EqdT5wsF z^_=2*#a?E>3|y?YIu;tsS@HIm#Rgs7F6x8sQy`N!$zAIde=_FSR8h9C2@Jv+UU4if zJ+cOja;Bj;_)fF9UqoL-o3+i-jdf6IT-A3vj}RLE77+$1$&0R82MdJYEb*IBpx`L0`Nv961Gr< zOj&#t>FqFF8UDIPqEY@mv3ffF0@qNkl`ym72*gMbos>02CFR#yA@^_PQgWWkpbf?Y zBHT{sP2zH#84)a{oVgd(who<5}6xLnINiO zL-lI;AepRa$+A4)P;Vv&IfysOQ&CIf6FTwX;D)>$nFI0>v-eS3yD0X* zYYLll0590M#uHaAOMHDvdorUT;81>>wZUL%TF;(^- z3+8sVADP~RQO$`iGkM36dO1N?>yoEA_|CH$9w9DlKQ2U$@^Cd8^A8zYNkyTM<9Pb4 zecPRg0(P?gmotMR)Fs}rx_!&p!#4gLKLc441(b_3<0G_aBBy4wXjGOu|8%^eA;=`y zUh;6cDf%17&fs%dfzQ9@u-UykUQ~9HnSYyD3rFP=uAidJCGeU_JlMfS%hk&D^%~X) z1tH2{jXg(yjv}ImcOxnvWCWAYGpNN^=W--ANjD9vUsZQ|$pA;O{q4bXNTAkZBJcZ) z8m1vfLS1l!^=y74GhILB-I*gBq>Orh)pt=xppKq(>7(>{tBfKKWf}~e zN&8An@dG`bO>w*ozNzW28COJ9zoJs=le$OMVH-n+FUa>|AOCI1)kl6Y5t?9k7_a@r z_iJjb{@X3Zy`;ei3kxN}Dsx*U)YH{Ud;4CkB@k@4N*3-fZ_&Tf^Zs!LM?!2Uqglaz zXvBG|&Bw|c%c*_}Xr$!m`MJWd>nbFp)sN>Ss@c0<^dWI06;3+D)jJ zfGxyV7j~quq-{O=GN#RGP~yV7ukc*S6icHvHA2Qi^%*47pZc;8Cq4%&yZku@PSJ$Z zshX1Bw!WN=-NL%t9weguF%bZ-b@#e_g?KAcD~Fdm;gQ09;32!z8ghD#RcN`UiD z$!!G5%x-U;N%}9P(_jC$3`RvSY-H@yH#4}qj6@TC>c3X!{9XOG5_n&m=kJ-Z8vR-Z z9Bg|xthUjtLsE{LAL$HA9A`%9k3}KIh|Ng+^Z1?zAo<^i2t+3T{tUTjI1Mh8y6s2w zAt1E&Y0I1nM@Ja#UYWxu&+X(2=1vX9-QI?yuttyXU&an6o6YqxKOO#A^awtqyANns z;J#9z<`d6x^l?0h(rlKLsbXDh{R*ee{!Z7MzY0xxRIAurx<`PFb^2lH6tkrZ*uz{YS7f|)0R)qtQQ706ecN3Mmwqt~KA^O->5FqYImUsen!EoJI6=xepvr>i^2ee!4a; zS4z7m;yu%(;8U=%VsP?4k>OK&{O^uRZ^43DAWyP8_YKH$vE@Dh z{bEZ9QSPLt)q1T%)v9^?f60=R^|D`%FKIts0u5q&eU(~d+4D?A=*Q}`d5Gsx%GBeO zZDwpI{gwL4W5l` z{~j4oQ?S%y^rfG@TTU)KUzpZ}r>5NK3RLl$pf%T5g`C(rU zn$dErh`CY89b}UwceLf%uOi5DpClIu{sJtcBKB5KRJRV$YWWCIc03@;&6u`_$z#N!S28=B%kKu~;bv z#{=^r%vRctaE&x90N*5x;vNd3R$_(F2e+nqBXB+n6lj_4K4M6(%&XFX4bwt*$ORw| zo}l=#^Z4-6S+z*8+7>8?lY`2&GmEJyM<${Q#7W%|8GtsLenfU_XQ4 ziYO?1+^uTZ$L(MiQ4&)s29D5yu@L`waE$aXtMTC1Cka1>1a@gtl@tJjsVkr}R6}<) zRXtIjvf-?_v#Lgv|F>cTyv{cmUV}}`0?kASnQLR?;6LjsICheYC1Gj*{&XM6s)e|B z#{!$Elv-vXw-KN(YQH#w%Kkd@HM7mc+M>Iu+lv#Vfv+$y%3@$}Tkpm_4tf-R?59?C z#}@{IripPnxIGa@wdQ1K!rD@P&UhOOMVd-2Lbb%S_RSp_%3gM$^ihciV^41p z(yq5eLje(dkaaIIQ=}(*8u7y^e?`2MM7GFr{u&?f)z+zJWftuc8TFxwg-CttX~X%| zk`y5eKXG>vuY))#Ww%x-mh9s?{Jki`-uU0;|}iWx`{x(o0n~l%(N$)kcu>TC@A_tkawf z3Cb3#hYsP@`M`ndey_ja)jj6d*oBH#q2js4MK6*i>y`fYRnz3x+on<04&fclWaac5 z@K|XyNoWevgA9L#h_gYX%PmN3yM_pd&*4Y=_vE*ifg2*VBcjCXQ=2_sNMvg0Mv3Qa zMrk0`3!aO}Gb#077oN(bADjPr{v2n`{va^O#R|^A8a_;w!D1<9X3Bf0u4Lu&aTfev zm+96`^xl#}Ph9Duc`uIrt(Xtm+Wc(UJ?#xit6zMNB5yA+oVJ;9bUA2}t=%o*z%vX!Wwx!-LuMS;p+zSOEw0pqIu z1#;$P8@sclv)iViTVo?g#B+bWIpPW8zZtZ~SA+2LT@O>E8fQqz?}f%UDrYK7MP@HO z^0rlKW#&8nJs-fy-r1o!;EQt=VraNO;B(Ld_6{=f<4uh>o|$lRS_LG$%0<$4#nOcR zdEY>$&j)uM9r6!_Ly#K&1LcF5U+rReM)Fm7G@@3GA8z%jPqa14|I)(^zW-TvuyPq@ z2)h#bIUo0%hYqEizino)Vx%hy>VQV3q!_nEnm=NFCYk@m_~A5iq&4j0>E#EhMoOVS zP|ylLe^p@&iL9n<_!{vvQ)x`4s%f0TPsh~eQ7?MCdc8bV0=e^0H(CIV+XzjbQt{!^9Vc-@v@8)5K0P7^^= z_lon*FwMfru|pw8N19R@QI|xl*~P&c>|)bKm*>J0T$E1>s6>UFs*08f3$%om%d9UI za=oCu!{SUvmzqA~M9dkhT^m3p(IrQorXmEA)Qt)l2Tjqh@sFJc($fdh?&#ZKVm*!Fu_9o`D#~B{mx( zAn~U5>1=jPgL=uX5z|Dwe@$oU=4RRp1s3;(pSBv1JUC!fHa$Nv>Gg{B-s-FvtnyJ7 z4owNORT4Tyv4?z&Q-m$-FKE(nk(qeqXB8}5-dpE^D~&>ApY^xu8n>kT-*E&6UWV*nc5&8b0i9K=uh)x(;pXD^pVFP` zyS<)QCRRjW+i?Op(+D~1(ikMk-gSS9efFY&g6zj}i6Z@Kl~2ioGz#9SUUuY5+#(LaxAwzS_fE{U*;@&)VJfoXu2czQP zgZ+)I&+4~X3~a7_EdZ9d?>3ln7QD{dIz=~*Pp)y7R;ioSRGae+4-6$Wc&*bf%-SWg z=vpRM_s7~vxdOQU--x|AY-EJu0%u5qfb@)TEk7exfXyRng*sR~oC^`MVkWiW?N^fTv>MmfEM*Oqx{3AQK2cl3`^u=+8y0t zqW3eEU~|~&pzk#3Q-W}!zfT}{wpx3{OcR(;eS<=o&9kvHah;{P2Z6(mN>ZM6t)*BS zx({Hs`9O=;X$#O5_h?}q*UOj%nODMT(Bt?%1Lq*PI178E$ODW6ar&arcy)DA`vQe^ zEGNeop&RyY`LaVpvj@8EUW~USyp$*K8>Yte1i9nN{oT@)va?H-+(=t-Icdw}*V^5b2#2bj*m;G(j%*LTdh=!;jA zyAz^vER-Z@_2uW6Pe5C*r`+ok%2d*m-)$?e6*l7lESi~q63$q7djOS;yZ=?@AvTVO zbb#CP`kKfzLjSH=zNbf0nx;IZ{A|3=%Vp5u+vEV#Dgm8);NoA`TEH4lNk2xhOlWN) zDOYjgX*b!nL0PoHrw@RLgJcGVg)}Yw4}KMEPlxbp)G!k`5HUQdEbG^vC5vfnRV6ts zXpK0}l6~5GF@TV)HH@6HOV>rS9IsdrjIRdP_^So4P;$s-dqCd(NlFK<_pI1kS$$ImyAaArbNW&4ko$6k+8*>-->NZl`j0q zA>NM&HO6leAq@WF(xeOI@#zuB&sN*q%GX@FzH$`otSK21I zQ}LgXr=O~S2(O7Yr98a7bmU-mZL?;%du8rJufuYPumWX4=3`vQt9GEEJS#!&J0+&* zB<$U@WFD&pH8k8hTEPKjQ?-XY%m#AX+=$CdmW?0quFp9XxXK%;z4~~}WB(*J1(lRX z_Cu!-qG&zowN60y5xBc?z@r6{;rMiuB8MIa7rDNe{>^EQ_q)a&hS&^Eexj084W<316jZsHfc)eq1;|x*>Ernn26Qwi6WnCb5oUjG@Z$-^ zqij7dc=0_1wuX>APcYC)LnP3p@0v84CId`-ktufKZxR7^@s4efwK;TGQ5Av)#gDZ;Y5Int5jm zCTiq40mOtGD;L@}1q}_s(HUi9Vj&1D#(_PJ#hgElpn3;l7JM*7j}}MDv#U=Su@LdH zD+Gf2!93})CaUhUKV9}Ut5@`R4R+vIcMDd&-soTnJN~74Qim3GUzI=LRonpkP?fGe z42qr6ITjeQy8Q053~~tW0{~Qq*MY1ZhiaL;To9drks;2wiBEf6YAGDc0ORk;lm+D1 z-by_G`r+p_htK(fcE?SCIvcGJKe^NoxU(m{BMz2_yO`DAmoHq9(umIaGVmGwO4Tgi zcX<$?sL+4SQ zZireAsN$Li>itJk0ZkspJ3M zyENz+0cbrrGddfx=*TyEWslPO@=Ym z7qVStBIWFUM0J|)b;-L9l{+URsxSHHdH_Q)fV)>Z@mV;(ZOe4w{ixM|uBmEXd<^W_ zJ_{H1RUv|_5J1U|A!)@z7d%~KBembjfgJ~$DTppQ4IPQ4*u^CAw(f( qaMJJp{eP^H|EIbT$iJ%npNhU`x9WlRMiFDbASd-$vP9hQ<^KY0RQ>P( literal 59288 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 Date: Wed, 11 Mar 2026 14:25:14 -0500 Subject: [PATCH 1704/1799] Apply suggestions from code review Co-authored-by: Diana Richards --- docs/porting/copilot-app-modernization-cpp.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/porting/copilot-app-modernization-cpp.md b/docs/porting/copilot-app-modernization-cpp.md index 972ac4df976..d6e23461baf 100644 --- a/docs/porting/copilot-app-modernization-cpp.md +++ b/docs/porting/copilot-app-modernization-cpp.md @@ -29,7 +29,7 @@ GitHub Copilot modernization for C++ is enabled by default. To disable or explic 1. Select (to enable) or clear (to disable) the checkbox for **Enable GitHub Copilot modernization for C++ (preview)**. 1. Restart Visual Studio for the setting change to take effect. -:::image type="content" source="media/enable-copilot-app-modernization-cpp.png" alt-text="Screenshot of Visual Studio Options dialog. GitHub > Copilot > C/C++ settings are visible. The modernization for C++ checkbox is enabled."::: +:::image type="content" source="media/enable-copilot-app-modernization-cpp.png" alt-text="Screenshot of Visual Studio Options dialog. GitHub > Copilot > C/C++ settings are visible. The modernization for C++ checkbox is enabled." lightbox="media/enable-copilot-app-modernization-cpp.png"::: ## Upgrade your codebase by using GitHub Copilot modernization for C++ @@ -75,7 +75,7 @@ Once the Modernize agent is active, you can instruct it via a prompt to upgrade :::column-end::: :::column::: -:::image type="content" source="media/app-modernization-cmake-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to Modernize experience and Resolve build issues by migrating to modern alternatives is highlighted"::: +:::image type="content" source="media/app-modernization-cmake-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to Modernize experience and Resolve build issues by migrating to modern alternatives is highlighted."::: :::column-end::: :::row-end::: From 738400a112ed72af62d580d86a832e27c12bc9bd Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 12 Mar 2026 16:09:45 -0700 Subject: [PATCH 1705/1799] dev feedback --- .../cgthreads-code-generation-threads.md | 20 ++++++------------- 1 file changed, 6 insertions(+), 14 deletions(-) diff --git a/docs/build/reference/cgthreads-code-generation-threads.md b/docs/build/reference/cgthreads-code-generation-threads.md index d169b1d3419..bdaf07bd846 100644 --- a/docs/build/reference/cgthreads-code-generation-threads.md +++ b/docs/build/reference/cgthreads-code-generation-threads.md @@ -1,43 +1,35 @@ --- description: "Learn more about: `/cgthreads` (Code generation threads)" title: "/cgthreads (Code generation threads)" -ms.date: 07/31/2020 +ms.date: 03/12/2026 f1_keywords: ["/cgthreads"] helpviewer_keywords: ["/cgthreads compiler option (C++)", "-cgthreads compiler option (C++)", "cgthreads compiler option (C++)", "cgthreads"] -ms.assetid: 64bc768c-6caa-4baf-9dea-7cfa1ffb01c2 --- # `/cgthreads` (Code generation threads) -Sets number of cl.exe threads to use for optimization and code generation. +Sets number of `cl.exe` threads to use for optimization and code generation. ## Syntax > **`/cgthreads1`**\ > **`/cgthreads2`**\ -> **`/cgthreads3`**\ -> **`/cgthreads4`**\ -> **`/cgthreads5`**\ -> **`/cgthreads6`**\ -> **`/cgthreads7`**\ -> **`/cgthreads8`** +etc. ## Arguments **`cgthreadsN`**\ -The maximum number of threads for cl.exe to use, where *N* is a number in the range 1 to 8. +The maximum number of threads for `cl.exe` to use, where *N* is a number in the range 1 to 512. ## Remarks -The **`cgthreads`** option specifies the maximum number of threads cl.exe uses in parallel for the optimization and code generation phases of compilation. Notice that there can be no space between **`cgthreads`** and the *number* argument. By default, cl.exe uses four threads, as if **`/cgthreads4`** were specified. If more processor cores are available, a larger *number* value can improve build times. This option is especially useful when it's combined with [`/GL` (Whole Program Optimization)](gl-whole-program-optimization.md). +The **`cgthreads`** option specifies the maximum number of threads `cl.exe` uses in parallel for the optimization and code generation phases of compilation. No space can appear between **`cgthreads`** and the *number* argument. By default, `cl.exe` uses four threads, as if **`/cgthreads4`** were specified. If more processor cores are available, a larger *number* value can improve build times. This option is especially useful when it's combined with [`/GL` (Whole Program Optimization)](gl-whole-program-optimization.md). Multiple levels of parallelism can be specified for a build. The msbuild.exe switch **`/maxcpucount`** specifies the number of MSBuild processes that can be run in parallel. The [`/MP` (Build with Multiple Processes)](mp-build-with-multiple-processes.md) compiler flag specifies the number of cl.exe processes that simultaneously compile the source files. The **`cgthreads`** option specifies the number of threads used by each cl.exe process. The processor can only run as many threads at the same time as there are processor cores. It's not useful to specify larger values for all of these options at the same time, and it can be counterproductive. For more information about how to build projects in parallel, see [Building Multiple Projects in Parallel](/visualstudio/msbuild/building-multiple-projects-in-parallel-with-msbuild). ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page. - 1. Modify the **Additional Options** property to include **`cgthreadsN`**, where *`N`* is a value from 1 to 8, and then select **OK**. ### To set this compiler option programmatically @@ -46,5 +38,5 @@ Multiple levels of parallelism can be specified for a build. The msbuild.exe swi ## See also -[MSVC compiler options](compiler-options.md)
+[MSVC compiler options](compiler-options.md)\ [MSVC compiler command-line syntax](compiler-command-line-syntax.md) From 0aa8aecc26014422bb4119d750e88eeba373a613 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 12 Mar 2026 16:17:15 -0700 Subject: [PATCH 1706/1799] acrolinx --- docs/build/reference/cgthreads-code-generation-threads.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/cgthreads-code-generation-threads.md b/docs/build/reference/cgthreads-code-generation-threads.md index bdaf07bd846..da08ab45b78 100644 --- a/docs/build/reference/cgthreads-code-generation-threads.md +++ b/docs/build/reference/cgthreads-code-generation-threads.md @@ -22,7 +22,7 @@ The maximum number of threads for `cl.exe` to use, where *N* is a number in the ## Remarks -The **`cgthreads`** option specifies the maximum number of threads `cl.exe` uses in parallel for the optimization and code generation phases of compilation. No space can appear between **`cgthreads`** and the *number* argument. By default, `cl.exe` uses four threads, as if **`/cgthreads4`** were specified. If more processor cores are available, a larger *number* value can improve build times. This option is especially useful when it's combined with [`/GL` (Whole Program Optimization)](gl-whole-program-optimization.md). +The **`cgthreads`** option specifies the maximum number of threads `cl.exe` uses in parallel for the optimization and code generation phases of compilation. No space can appear between **`cgthreads`** and the *number* argument. By default, `cl.exe` uses four threads, as if **`/cgthreads4`** were specified. If more processor cores are available, a larger *number* value improves build times. This option is especially useful when combined with [`/GL` (Whole Program Optimization)](gl-whole-program-optimization.md). Multiple levels of parallelism can be specified for a build. The msbuild.exe switch **`/maxcpucount`** specifies the number of MSBuild processes that can be run in parallel. The [`/MP` (Build with Multiple Processes)](mp-build-with-multiple-processes.md) compiler flag specifies the number of cl.exe processes that simultaneously compile the source files. The **`cgthreads`** option specifies the number of threads used by each cl.exe process. The processor can only run as many threads at the same time as there are processor cores. It's not useful to specify larger values for all of these options at the same time, and it can be counterproductive. For more information about how to build projects in parallel, see [Building Multiple Projects in Parallel](/visualstudio/msbuild/building-multiple-projects-in-parallel-with-msbuild). From 445b65a88482c26acfffcee08a592da12a19b523 Mon Sep 17 00:00:00 2001 From: "Docs.Archive pipeline" Date: Wed, 18 Mar 2026 17:30:45 +0000 Subject: [PATCH 1707/1799] [DocsArchive-1.0.26057.1](2026-03-18-17-29-49)Auto archive content --- .openpublishing.redirection.json | 562 ++++++++++++- docs/docfx.json | 35 +- docs/parallel/toc.yml | 1260 +++++++++++++++--------------- 3 files changed, 1211 insertions(+), 646 deletions(-) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 585f812c4b4..f4bb352073f 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1,5 +1,565 @@ { "redirections": [ + { + "source_path": "docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/cpp-amp-overview.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-overview", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/graphics-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/graphics-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-accelerator-and-accelerator-view-objects", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-cpp-amp-in-windows-store-apps", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-lambdas-function-objects-and-restricted-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/using-tiles.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-tiles", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-debugging-a-cpp-amp-application.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-debugging-a-cpp-amp-application", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-matrix-multiplication.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-matrix-multiplication", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-removed-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-removed-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/adopt-d3d-access-lock-t-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/adopt-d3d-access-lock-t-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/completion-future-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/completion-future-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-enums.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-enums", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-constants-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-constants-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-enums-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-enums-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-operators-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-operators-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/invalid-compute-domain-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/invalid-compute-domain-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/out-of-memory-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/out-of-memory-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/reference-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/reference-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/runtime-exception-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/runtime-exception-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/sampler-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/sampler-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/scoped-d3d-access-lock-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/scoped-d3d-access-lock-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-traits-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-traits-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tile-barrier-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tile-barrier-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uninitialized-object-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uninitialized-object-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unsupported-feature-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unsupported-feature-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, + { + "source_path": "docs/parallel/amp/reference/writeonly-texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/writeonly-texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-170" + ] + }, { "source_path": "docs/windows/desktop-applications-visual-cpp.md", "redirect_url": "/cpp/windows/overview-of-windows-programming-in-cpp", @@ -13936,4 +14496,4 @@ "redirect_document_id": false } ] -} \ No newline at end of file +} diff --git a/docs/docfx.json b/docs/docfx.json index 752316e2e79..ad6d38ef295 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -6,15 +6,15 @@ "**/*.md", "**/*.yml" ], - "group": "group-vc2015", - "src": ".", "exclude": [ "**/2019/**", "**/2017/**", "**/obj/**", "vcppdocs/**", "**/includes/**" - ] + ], + "src": ".", + "group": "group-vc2015" } ], "resource": [ @@ -25,13 +25,13 @@ "**/*.gif", "**/*.svg" ], - "group": "group-vc2015", - "src": ".", "exclude": [ "**/obj/**", "vcppdocs/**", "**/includes/**" - ] + ], + "src": ".", + "group": "group-vc2015" } ], "overwrite": [], @@ -63,9 +63,9 @@ }, "fileMetadata": { "feedback_help_link_url": { - "dotnet/*.md": "https://learn.microsoft.com/en-us/answers/tags/308/dotnetcli", - "ide/*.md": "https://learn.microsoft.com/en-us/answers/tags/176/vs", - "windows/*.md": "https://learn.microsoft.com/en-us/answers/tags/184/windows-app-sdk" + "dotnet/*.md": "https://learn.microsoft.com/en-us/answers/tags/308/dotnetcli", + "ide/*.md": "https://learn.microsoft.com/en-us/answers/tags/176/vs", + "windows/*.md": "https://learn.microsoft.com/en-us/answers/tags/184/windows-app-sdk" }, "ms.tgt_pltfrm": { "linux/**.md": "Linux" @@ -175,7 +175,7 @@ "c-runtime-library/**.md": "3650-days", "c-runtime-library/**.yml": "3650-days", "cpp/**.md": "1095-days", - "cpp/**.yml": "1095-days", + "cpp/**.yml": "1095-days", "cppcx/**.md": "3650-days", "cppcx/**.yml": "3650-days", "cross-platform/**.md": "1825-days", @@ -342,17 +342,22 @@ "text/**.yml": "twhitney", "windows/**.md": "twhitney", "windows/**.yml": "twhitney" + }, + "exclude_monikers": { + "parallel/amp/**/*.{md,yml,yaml}": [ + "msvc-170" + ] } }, "template": [], + "markdownEngineName": "markdig", "xref": [], - "dest": "vcppdocs", "groups": { "group-vc2015": { - "moniker_range": ">= msvc-140", - "dest": "vcppdocs-2015" + "dest": "vcppdocs-2015", + "moniker_range": ">= msvc-140" } }, - "markdownEngineName": "markdig" + "dest": "vcppdocs" } -} +} \ No newline at end of file diff --git a/docs/parallel/toc.yml b/docs/parallel/toc.yml index d8a0ae92833..e140a198cc1 100644 --- a/docs/parallel/toc.yml +++ b/docs/parallel/toc.yml @@ -1,659 +1,659 @@ -items: +items: - name: Parallel programming in MSVC href: ../parallel/parallel-programming-in-visual-cpp.md - name: Auto-parallelization and auto-vectorization href: ../parallel/auto-parallelization-and-auto-vectorization.md - name: C++ Accelerated Massive Parallelism (AMP) - expanded: false items: - - name: C++ AMP (C++ Accelerated Massive Parallelism) - href: ../parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md - - name: C++ AMP overview - href: ../parallel/amp/cpp-amp-overview.md - - name: Using tiles - href: ../parallel/amp/using-tiles.md - - name: Using C++ AMP in UWP apps - href: ../parallel/amp/using-cpp-amp-in-windows-store-apps.md - - name: "Walkthrough: Matrix multiplication" - href: ../parallel/amp/walkthrough-matrix-multiplication.md - - name: "Walkthrough: Debugging a C++ AMP application" - href: ../parallel/amp/walkthrough-debugging-a-cpp-amp-application.md - - name: Using lambdas, function objects, and restricted functions - href: ../parallel/amp/using-lambdas-function-objects-and-restricted-functions.md - - name: Graphics (C++ AMP) - href: ../parallel/amp/graphics-cpp-amp.md - - name: Using accelerator and accelerator_view objects - href: ../parallel/amp/using-accelerator-and-accelerator-view-objects.md + - name: C++ AMP (C++ Accelerated Massive Parallelism) + href: ../parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md + - name: C++ AMP overview + href: ../parallel/amp/cpp-amp-overview.md + - name: Using tiles + href: ../parallel/amp/using-tiles.md + - name: Using C++ AMP in UWP apps + href: ../parallel/amp/using-cpp-amp-in-windows-store-apps.md + - name: 'Walkthrough: Matrix multiplication' + href: ../parallel/amp/walkthrough-matrix-multiplication.md + - name: 'Walkthrough: Debugging a C++ AMP application' + href: ../parallel/amp/walkthrough-debugging-a-cpp-amp-application.md + - name: Using lambdas, function objects, and restricted functions + href: ../parallel/amp/using-lambdas-function-objects-and-restricted-functions.md + - name: Graphics (C++ AMP) + href: ../parallel/amp/graphics-cpp-amp.md + - name: Using accelerator and accelerator_view objects + href: ../parallel/amp/using-accelerator-and-accelerator-view-objects.md + - name: Reference (C++ AMP) + items: - name: Reference (C++ AMP) + href: ../parallel/amp/reference/reference-cpp-amp.md + - name: Concurrency namespace (C++ AMP) + items: + - name: Concurrency namespace (C++ AMP) + href: ../parallel/amp/reference/concurrency-namespace-cpp-amp.md + - name: Concurrency namespace functions (AMP) + href: ../parallel/amp/reference/concurrency-namespace-functions-amp.md + - name: Concurrency namespace enums (AMP) + href: ../parallel/amp/reference/concurrency-namespace-enums-amp.md + - name: Concurrency namespace operators (AMP) + href: ../parallel/amp/reference/concurrency-namespace-operators-amp.md + - name: Concurrency namespace constants (AMP) + href: ../parallel/amp/reference/concurrency-namespace-constants-amp.md + - name: accelerator class + href: ../parallel/amp/reference/accelerator-class.md + - name: accelerator_view class + href: ../parallel/amp/reference/accelerator-view-class.md + - name: accelerator_view_removed class + href: ../parallel/amp/reference/accelerator-view-removed-class.md + - name: array class + href: ../parallel/amp/reference/array-class.md + - name: array_view class + href: ../parallel/amp/reference/array-view-class.md + - name: completion_future class + href: ../parallel/amp/reference/completion-future-class.md + - name: extent class (C++ AMP) + href: ../parallel/amp/reference/extent-class.md + - name: index class + href: ../parallel/amp/reference/index-class.md + - name: invalid_compute_domain class + href: ../parallel/amp/reference/invalid-compute-domain-class.md + - name: out_of_memory class + href: ../parallel/amp/reference/out-of-memory-class.md + - name: runtime_exception class + href: ../parallel/amp/reference/runtime-exception-class.md + - name: tile_barrier class + href: ../parallel/amp/reference/tile-barrier-class.md + - name: tiled_extent class + href: ../parallel/amp/reference/tiled-extent-class.md + - name: tiled_index class + href: ../parallel/amp/reference/tiled-index-class.md + - name: uninitialized_object class + href: ../parallel/amp/reference/uninitialized-object-class.md + - name: unsupported_feature class + href: ../parallel/amp/reference/unsupported-feature-class.md expanded: false - items: - - name: Reference (C++ AMP) - href: ../parallel/amp/reference/reference-cpp-amp.md - - name: Concurrency namespace (C++ AMP) - expanded: false - items: - - name: Concurrency namespace (C++ AMP) - href: ../parallel/amp/reference/concurrency-namespace-cpp-amp.md - - name: Concurrency namespace functions (AMP) - href: ../parallel/amp/reference/concurrency-namespace-functions-amp.md - - name: Concurrency namespace enums (AMP) - href: ../parallel/amp/reference/concurrency-namespace-enums-amp.md - - name: Concurrency namespace operators (AMP) - href: ../parallel/amp/reference/concurrency-namespace-operators-amp.md - - name: Concurrency namespace constants (AMP) - href: ../parallel/amp/reference/concurrency-namespace-constants-amp.md - - name: accelerator class - href: ../parallel/amp/reference/accelerator-class.md - - name: accelerator_view class - href: ../parallel/amp/reference/accelerator-view-class.md - - name: accelerator_view_removed class - href: ../parallel/amp/reference/accelerator-view-removed-class.md - - name: array class - href: ../parallel/amp/reference/array-class.md - - name: array_view class - href: ../parallel/amp/reference/array-view-class.md - - name: completion_future class - href: ../parallel/amp/reference/completion-future-class.md - - name: extent class (C++ AMP) - href: ../parallel/amp/reference/extent-class.md - - name: index class - href: ../parallel/amp/reference/index-class.md - - name: invalid_compute_domain class - href: ../parallel/amp/reference/invalid-compute-domain-class.md - - name: out_of_memory class - href: ../parallel/amp/reference/out-of-memory-class.md - - name: runtime_exception class - href: ../parallel/amp/reference/runtime-exception-class.md - - name: tile_barrier class - href: ../parallel/amp/reference/tile-barrier-class.md - - name: tiled_extent class - href: ../parallel/amp/reference/tiled-extent-class.md - - name: tiled_index class - href: ../parallel/amp/reference/tiled-index-class.md - - name: uninitialized_object class - href: ../parallel/amp/reference/uninitialized-object-class.md - - name: unsupported_feature class - href: ../parallel/amp/reference/unsupported-feature-class.md - - name: "Concurrency::direct3d Namespace" - expanded: false - items: - - name: "Concurrency::direct3d Namespace" - href: ../parallel/amp/reference/concurrency-direct3d-namespace.md - - name: "Concurrency::direct3d namespace functions (AMP)" - href: ../parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md - - name: adopt_d3d_access_lock_t Structure - href: ../parallel/amp/reference/adopt-d3d-access-lock-t-structure.md - - name: scoped_d3d_access_lock class - href: ../parallel/amp/reference/scoped-d3d-access-lock-class.md - - name: "Concurrency::fast_math Namespace" - expanded: false - items: - - name: "Concurrency::fast_math Namespace" - href: ../parallel/amp/reference/concurrency-fast-math-namespace.md - - name: "Concurrency::fast_math namespace functions" - href: ../parallel/amp/reference/concurrency-fast-math-namespace-functions.md - - name: "Concurrency::graphics Namespace" - expanded: false - items: - - name: "Concurrency::graphics Namespace" - href: ../parallel/amp/reference/concurrency-graphics-namespace.md - - name: "Concurrency::graphics::direct3d namespace" - expanded: false - items: - - name: "Concurrency::graphics::direct3d namespace" - href: ../parallel/amp/reference/concurrency-graphics-direct3d-namespace.md - - name: "Concurrency::graphics::direct3d namespace functions" - href: ../parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md - - name: "Concurrency::graphics namespace functions" - href: ../parallel/amp/reference/concurrency-graphics-namespace-functions.md - - name: "Concurrency::graphics namespace enums" - href: ../parallel/amp/reference/concurrency-graphics-namespace-enums.md - - name: double_2 class - href: ../parallel/amp/reference/double-2-class.md - - name: double_3 class - href: ../parallel/amp/reference/double-3-class.md - - name: double_4 class - href: ../parallel/amp/reference/double-4-class.md - - name: float_2 class - href: ../parallel/amp/reference/float-2-class.md - - name: float_3 class - href: ../parallel/amp/reference/float-3-class.md - - name: float_4 class - href: ../parallel/amp/reference/float-4-class.md - - name: int_2 class - href: ../parallel/amp/reference/int-2-class.md - - name: int_3 class - href: ../parallel/amp/reference/int-3-class.md - - name: int_4 class - href: ../parallel/amp/reference/int-4-class.md - - name: norm class - href: ../parallel/amp/reference/norm-class.md - - name: norm_2 class - href: ../parallel/amp/reference/norm-2-class.md - - name: norm_3 class - href: ../parallel/amp/reference/norm-3-class.md - - name: norm_4 class - href: ../parallel/amp/reference/norm-4-class.md - - name: sampler class - href: ../parallel/amp/reference/sampler-class.md - - name: short_vector Structure - href: ../parallel/amp/reference/short-vector-structure.md - - name: short_vector_traits Structure - href: ../parallel/amp/reference/short-vector-traits-structure.md - - name: texture class - href: ../parallel/amp/reference/texture-class.md - - name: texture_view class - href: ../parallel/amp/reference/texture-view-class.md - - name: writeonly_texture_view class - href: ../parallel/amp/reference/writeonly-texture-view-class.md - - name: uint_2 class - href: ../parallel/amp/reference/uint-2-class.md - - name: uint_3 class - href: ../parallel/amp/reference/uint-3-class.md - - name: uint_4 class - href: ../parallel/amp/reference/uint-4-class.md - - name: unorm class - href: ../parallel/amp/reference/unorm-class.md - - name: unorm_2 class - href: ../parallel/amp/reference/unorm-2-class.md - - name: unorm_3 class - href: ../parallel/amp/reference/unorm-3-class.md - - name: unorm_4 class - href: ../parallel/amp/reference/unorm-4-class.md - - name: "Concurrency::precise_math namespace" - expanded: false - items: - - name: "Concurrency::precise_math namespace" - href: ../parallel/amp/reference/concurrency-precise-math-namespace.md - - name: "Concurrency::precise_math namespace functions" - href: ../parallel/amp/reference/concurrency-precise-math-namespace-functions.md -- name: Concurrency Runtime (ConcRT) + - name: Concurrency::direct3d Namespace + items: + - name: Concurrency::direct3d Namespace + href: ../parallel/amp/reference/concurrency-direct3d-namespace.md + - name: Concurrency::direct3d namespace functions (AMP) + href: ../parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md + - name: adopt_d3d_access_lock_t Structure + href: ../parallel/amp/reference/adopt-d3d-access-lock-t-structure.md + - name: scoped_d3d_access_lock class + href: ../parallel/amp/reference/scoped-d3d-access-lock-class.md + expanded: false + - name: Concurrency::fast_math Namespace + items: + - name: Concurrency::fast_math Namespace + href: ../parallel/amp/reference/concurrency-fast-math-namespace.md + - name: Concurrency::fast_math namespace functions + href: ../parallel/amp/reference/concurrency-fast-math-namespace-functions.md + expanded: false + - name: Concurrency::graphics Namespace + items: + - name: Concurrency::graphics Namespace + href: ../parallel/amp/reference/concurrency-graphics-namespace.md + - name: Concurrency::graphics::direct3d namespace + items: + - name: Concurrency::graphics::direct3d namespace + href: ../parallel/amp/reference/concurrency-graphics-direct3d-namespace.md + - name: Concurrency::graphics::direct3d namespace functions + href: ../parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md + expanded: false + - name: Concurrency::graphics namespace functions + href: ../parallel/amp/reference/concurrency-graphics-namespace-functions.md + - name: Concurrency::graphics namespace enums + href: ../parallel/amp/reference/concurrency-graphics-namespace-enums.md + - name: double_2 class + href: ../parallel/amp/reference/double-2-class.md + - name: double_3 class + href: ../parallel/amp/reference/double-3-class.md + - name: double_4 class + href: ../parallel/amp/reference/double-4-class.md + - name: float_2 class + href: ../parallel/amp/reference/float-2-class.md + - name: float_3 class + href: ../parallel/amp/reference/float-3-class.md + - name: float_4 class + href: ../parallel/amp/reference/float-4-class.md + - name: int_2 class + href: ../parallel/amp/reference/int-2-class.md + - name: int_3 class + href: ../parallel/amp/reference/int-3-class.md + - name: int_4 class + href: ../parallel/amp/reference/int-4-class.md + - name: norm class + href: ../parallel/amp/reference/norm-class.md + - name: norm_2 class + href: ../parallel/amp/reference/norm-2-class.md + - name: norm_3 class + href: ../parallel/amp/reference/norm-3-class.md + - name: norm_4 class + href: ../parallel/amp/reference/norm-4-class.md + - name: sampler class + href: ../parallel/amp/reference/sampler-class.md + - name: short_vector Structure + href: ../parallel/amp/reference/short-vector-structure.md + - name: short_vector_traits Structure + href: ../parallel/amp/reference/short-vector-traits-structure.md + - name: texture class + href: ../parallel/amp/reference/texture-class.md + - name: texture_view class + href: ../parallel/amp/reference/texture-view-class.md + - name: writeonly_texture_view class + href: ../parallel/amp/reference/writeonly-texture-view-class.md + - name: uint_2 class + href: ../parallel/amp/reference/uint-2-class.md + - name: uint_3 class + href: ../parallel/amp/reference/uint-3-class.md + - name: uint_4 class + href: ../parallel/amp/reference/uint-4-class.md + - name: unorm class + href: ../parallel/amp/reference/unorm-class.md + - name: unorm_2 class + href: ../parallel/amp/reference/unorm-2-class.md + - name: unorm_3 class + href: ../parallel/amp/reference/unorm-3-class.md + - name: unorm_4 class + href: ../parallel/amp/reference/unorm-4-class.md + expanded: false + - name: Concurrency::precise_math namespace + items: + - name: Concurrency::precise_math namespace + href: ../parallel/amp/reference/concurrency-precise-math-namespace.md + - name: Concurrency::precise_math namespace functions + href: ../parallel/amp/reference/concurrency-precise-math-namespace-functions.md + expanded: false + expanded: false expanded: false +- name: Concurrency Runtime (ConcRT) items: - - name: Concurrency Runtime - href: ../parallel/concrt/concurrency-runtime.md - - name: Overview of the Concurrency Runtime - href: ../parallel/concrt/overview-of-the-concurrency-runtime.md - - name: Exception handling in the Concurrency Runtime - href: ../parallel/concrt/exception-handling-in-the-concurrency-runtime.md - - name: Parallel diagnostic tools (Concurrency Runtime) - href: ../parallel/concrt/parallel-diagnostic-tools-concurrency-runtime.md - - name: Creating asynchronous operations in C++ for UWP apps - href: ../parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md + - name: Concurrency Runtime + href: ../parallel/concrt/concurrency-runtime.md + - name: Overview of the Concurrency Runtime + href: ../parallel/concrt/overview-of-the-concurrency-runtime.md + - name: Exception handling in the Concurrency Runtime + href: ../parallel/concrt/exception-handling-in-the-concurrency-runtime.md + - name: Parallel diagnostic tools (Concurrency Runtime) + href: ../parallel/concrt/parallel-diagnostic-tools-concurrency-runtime.md + - name: Creating asynchronous operations in C++ for UWP apps + href: ../parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md + - name: Comparing the Concurrency Runtime to other concurrency models + items: - name: Comparing the Concurrency Runtime to other concurrency models + href: ../parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md + - name: Migrating from OpenMP to the Concurrency Runtime + items: + - name: Migrating from OpenMP to the Concurrency Runtime + href: ../parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md + - name: 'How to: Convert an OpenMP parallel for loop to use the Concurrency Runtime' + href: ../parallel/concrt/how-to-convert-an-openmp-parallel-for-loop-to-use-the-concurrency-runtime.md + - name: 'How to: Convert an OpenMP loop that uses cancellation to use the Concurrency Runtime' + href: ../parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md + - name: 'How to: Convert an OpenMP loop that uses exception handling to use the Concurrency Runtime' + href: ../parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md + - name: 'How to: Convert an OpenMP loop that uses a reduction variable to use the Concurrency Runtime' + href: ../parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md expanded: false - items: - - name: Comparing the Concurrency Runtime to other concurrency models - href: ../parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md - - name: Migrating from OpenMP to the Concurrency Runtime - expanded: false - items: - - name: Migrating from OpenMP to the Concurrency Runtime - href: ../parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md - - name: "How to: Convert an OpenMP parallel for loop to use the Concurrency Runtime" - href: ../parallel/concrt/how-to-convert-an-openmp-parallel-for-loop-to-use-the-concurrency-runtime.md - - name: "How to: Convert an OpenMP loop that uses cancellation to use the Concurrency Runtime" - href: ../parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md - - name: "How to: Convert an OpenMP loop that uses exception handling to use the Concurrency Runtime" - href: ../parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md - - name: "How to: Convert an OpenMP loop that uses a reduction variable to use the Concurrency Runtime" - href: ../parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md + expanded: false + - name: Parallel Patterns Library (PPL) + items: - name: Parallel Patterns Library (PPL) + href: ../parallel/concrt/parallel-patterns-library-ppl.md + - name: Task parallelism (Concurrency Runtime) + items: + - name: Task parallelism (Concurrency Runtime) + href: ../parallel/concrt/task-parallelism-concurrency-runtime.md + - name: 'How to: Use parallel_invoke to write a parallel sort routine' + href: ../parallel/concrt/how-to-use-parallel-invoke-to-write-a-parallel-sort-routine.md + - name: 'How to: Use parallel_invoke to execute parallel operations' + href: ../parallel/concrt/how-to-use-parallel-invoke-to-execute-parallel-operations.md + - name: 'How to: Create a task that completes after a delay' + href: ../parallel/concrt/how-to-create-a-task-that-completes-after-a-delay.md expanded: false - items: - - name: Parallel Patterns Library (PPL) - href: ../parallel/concrt/parallel-patterns-library-ppl.md - - name: Task parallelism (Concurrency Runtime) - expanded: false - items: - - name: Task parallelism (Concurrency Runtime) - href: ../parallel/concrt/task-parallelism-concurrency-runtime.md - - name: "How to: Use parallel_invoke to write a parallel sort routine" - href: ../parallel/concrt/how-to-use-parallel-invoke-to-write-a-parallel-sort-routine.md - - name: "How to: Use parallel_invoke to execute parallel operations" - href: ../parallel/concrt/how-to-use-parallel-invoke-to-execute-parallel-operations.md - - name: "How to: Create a task that completes after a delay" - href: ../parallel/concrt/how-to-create-a-task-that-completes-after-a-delay.md - - name: Parallel algorithms - expanded: false - items: - - name: Parallel algorithms - href: ../parallel/concrt/parallel-algorithms.md - - name: "How to: Write a parallel_for loop" - href: ../parallel/concrt/how-to-write-a-parallel-for-loop.md - - name: "How to: Write a parallel_for_each loop" - href: ../parallel/concrt/how-to-write-a-parallel-for-each-loop.md - - name: "How to: Perform map and reduce operations in parallel" - href: ../parallel/concrt/how-to-perform-map-and-reduce-operations-in-parallel.md - - name: Parallel containers and objects - expanded: false - items: - - name: Parallel containers and objects - href: ../parallel/concrt/parallel-containers-and-objects.md - - name: "How to: Use parallel containers to increase efficiency" - href: ../parallel/concrt/how-to-use-parallel-containers-to-increase-efficiency.md - - name: "How to: Use combinable to improve performance" - href: ../parallel/concrt/how-to-use-combinable-to-improve-performance.md - - name: "How to: Use combinable to combine sets" - href: ../parallel/concrt/how-to-use-combinable-to-combine-sets.md - - name: Cancellation in the PPL - expanded: false - items: - - name: Cancellation in the PPL - href: ../parallel/concrt/cancellation-in-the-ppl.md - - name: "How to: Use cancellation to break from a parallel loop" - href: ../parallel/concrt/how-to-use-cancellation-to-break-from-a-parallel-loop.md - - name: "How to: Use exception handling to break from a parallel loop" - href: ../parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md - - name: Asynchronous Agents Library + - name: Parallel algorithms + items: + - name: Parallel algorithms + href: ../parallel/concrt/parallel-algorithms.md + - name: 'How to: Write a parallel_for loop' + href: ../parallel/concrt/how-to-write-a-parallel-for-loop.md + - name: 'How to: Write a parallel_for_each loop' + href: ../parallel/concrt/how-to-write-a-parallel-for-each-loop.md + - name: 'How to: Perform map and reduce operations in parallel' + href: ../parallel/concrt/how-to-perform-map-and-reduce-operations-in-parallel.md expanded: false - items: - - name: Asynchronous Agents Library - href: ../parallel/concrt/asynchronous-agents-library.md - - name: Asynchronous agents - href: ../parallel/concrt/asynchronous-agents.md - - name: Asynchronous message blocks - href: ../parallel/concrt/asynchronous-message-blocks.md - - name: Message passing functions - href: ../parallel/concrt/message-passing-functions.md - - name: "How to: Implement various producer-consumer patterns" - href: ../parallel/concrt/how-to-implement-various-producer-consumer-patterns.md - - name: "How to: Provide work functions to the call and transformer classes" - href: ../parallel/concrt/how-to-provide-work-functions-to-the-call-and-transformer-classes.md - - name: "How to: Use transformer in a data pipeline" - href: ../parallel/concrt/how-to-use-transformer-in-a-data-pipeline.md - - name: "How to: Select among completed tasks" - href: ../parallel/concrt/how-to-select-among-completed-tasks.md - - name: "How to: Send a message at a regular interval" - href: ../parallel/concrt/how-to-send-a-message-at-a-regular-interval.md - - name: "How to: Use a message block filter" - href: ../parallel/concrt/how-to-use-a-message-block-filter.md - - name: Synchronization data structures + - name: Parallel containers and objects + items: + - name: Parallel containers and objects + href: ../parallel/concrt/parallel-containers-and-objects.md + - name: 'How to: Use parallel containers to increase efficiency' + href: ../parallel/concrt/how-to-use-parallel-containers-to-increase-efficiency.md + - name: 'How to: Use combinable to improve performance' + href: ../parallel/concrt/how-to-use-combinable-to-improve-performance.md + - name: 'How to: Use combinable to combine sets' + href: ../parallel/concrt/how-to-use-combinable-to-combine-sets.md expanded: false - items: - - name: Synchronization data structures - href: ../parallel/concrt/synchronization-data-structures.md - - name: Comparing synchronization data structures to the Windows API - href: ../parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md + - name: Cancellation in the PPL + items: + - name: Cancellation in the PPL + href: ../parallel/concrt/cancellation-in-the-ppl.md + - name: 'How to: Use cancellation to break from a parallel loop' + href: ../parallel/concrt/how-to-use-cancellation-to-break-from-a-parallel-loop.md + - name: 'How to: Use exception handling to break from a parallel loop' + href: ../parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md + expanded: false + expanded: false + - name: Asynchronous Agents Library + items: + - name: Asynchronous Agents Library + href: ../parallel/concrt/asynchronous-agents-library.md + - name: Asynchronous agents + href: ../parallel/concrt/asynchronous-agents.md + - name: Asynchronous message blocks + href: ../parallel/concrt/asynchronous-message-blocks.md + - name: Message passing functions + href: ../parallel/concrt/message-passing-functions.md + - name: 'How to: Implement various producer-consumer patterns' + href: ../parallel/concrt/how-to-implement-various-producer-consumer-patterns.md + - name: 'How to: Provide work functions to the call and transformer classes' + href: ../parallel/concrt/how-to-provide-work-functions-to-the-call-and-transformer-classes.md + - name: 'How to: Use transformer in a data pipeline' + href: ../parallel/concrt/how-to-use-transformer-in-a-data-pipeline.md + - name: 'How to: Select among completed tasks' + href: ../parallel/concrt/how-to-select-among-completed-tasks.md + - name: 'How to: Send a message at a regular interval' + href: ../parallel/concrt/how-to-send-a-message-at-a-regular-interval.md + - name: 'How to: Use a message block filter' + href: ../parallel/concrt/how-to-use-a-message-block-filter.md + expanded: false + - name: Synchronization data structures + items: + - name: Synchronization data structures + href: ../parallel/concrt/synchronization-data-structures.md + - name: Comparing synchronization data structures to the Windows API + href: ../parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md + expanded: false + - name: Task scheduler (Concurrency Runtime) + items: - name: Task scheduler (Concurrency Runtime) + href: ../parallel/concrt/task-scheduler-concurrency-runtime.md + - name: Scheduler instances + items: + - name: Scheduler instances + href: ../parallel/concrt/scheduler-instances.md + - name: 'How to: Manage a scheduler instance' + href: ../parallel/concrt/how-to-manage-a-scheduler-instance.md expanded: false - items: - - name: Task scheduler (Concurrency Runtime) - href: ../parallel/concrt/task-scheduler-concurrency-runtime.md - - name: Scheduler instances - expanded: false - items: - - name: Scheduler instances - href: ../parallel/concrt/scheduler-instances.md - - name: "How to: Manage a scheduler instance" - href: ../parallel/concrt/how-to-manage-a-scheduler-instance.md - - name: Scheduler policies - expanded: false - items: - - name: Scheduler policies - href: ../parallel/concrt/scheduler-policies.md - - name: "How to: Specify specific scheduler policies" - href: ../parallel/concrt/how-to-specify-specific-scheduler-policies.md - - name: "How to: Create agents that use specific scheduler policies" - href: ../parallel/concrt/how-to-create-agents-that-use-specific-scheduler-policies.md - - name: Schedule groups - expanded: false - items: - - name: Schedule groups - href: ../parallel/concrt/schedule-groups.md - - name: "How to: Use schedule groups to influence order of execution" - href: ../parallel/concrt/how-to-use-schedule-groups-to-influence-order-of-execution.md - - name: Lightweight tasks - href: ../parallel/concrt/lightweight-tasks.md - - name: Contexts - expanded: false - items: - - name: Contexts - href: ../parallel/concrt/contexts.md - - name: "How to: Use the Context class to implement a cooperative semaphore" - href: ../parallel/concrt/how-to-use-the-context-class-to-implement-a-cooperative-semaphore.md - - name: "How to: Use oversubscription to offset latency" - href: ../parallel/concrt/how-to-use-oversubscription-to-offset-latency.md - - name: Memory management functions - expanded: false - items: - - name: Memory management functions - href: ../parallel/concrt/memory-management-functions.md - - name: "How to: Use Alloc and Free to improve memory performance" - href: ../parallel/concrt/how-to-use-alloc-and-free-to-improve-memory-performance.md - - name: Concurrency Runtime walkthroughs + - name: Scheduler policies + items: + - name: Scheduler policies + href: ../parallel/concrt/scheduler-policies.md + - name: 'How to: Specify specific scheduler policies' + href: ../parallel/concrt/how-to-specify-specific-scheduler-policies.md + - name: 'How to: Create agents that use specific scheduler policies' + href: ../parallel/concrt/how-to-create-agents-that-use-specific-scheduler-policies.md + expanded: false + - name: Schedule groups + items: + - name: Schedule groups + href: ../parallel/concrt/schedule-groups.md + - name: 'How to: Use schedule groups to influence order of execution' + href: ../parallel/concrt/how-to-use-schedule-groups-to-influence-order-of-execution.md expanded: false - items: - - name: Concurrency Runtime walkthroughs - href: ../parallel/concrt/concurrency-runtime-walkthroughs.md - - name: "Walkthrough: Connecting using tasks and xml http requests" - href: ../parallel/concrt/walkthrough-connecting-using-tasks-and-xml-http-requests.md - - name: "Walkthrough: Creating an agent-based application" - href: ../parallel/concrt/walkthrough-creating-an-agent-based-application.md - - name: "Walkthrough: Creating a dataflow agent" - href: ../parallel/concrt/walkthrough-creating-a-dataflow-agent.md - - name: "Walkthrough: Creating an image-processing network" - href: ../parallel/concrt/walkthrough-creating-an-image-processing-network.md - - name: "Walkthrough: Implementing futures" - href: ../parallel/concrt/walkthrough-implementing-futures.md - - name: "Walkthrough: Using join to prevent deadlock" - href: ../parallel/concrt/walkthrough-using-join-to-prevent-deadlock.md - - name: "Walkthrough: Removing work from a user-interface thread" - href: ../parallel/concrt/walkthrough-removing-work-from-a-user-interface-thread.md - - name: "Walkthrough: Using the Concurrency Runtime in a COM-enabled application" - href: ../parallel/concrt/walkthrough-using-the-concurrency-runtime-in-a-com-enabled-application.md - - name: "Walkthrough: Adapting existing code to use lightweight tasks" - href: ../parallel/concrt/walkthrough-adapting-existing-code-to-use-lightweight-tasks.md - - name: "Walkthrough: Creating a custom message block" - href: ../parallel/concrt/walkthrough-creating-a-custom-message-block.md + - name: Lightweight tasks + href: ../parallel/concrt/lightweight-tasks.md + - name: Contexts + items: + - name: Contexts + href: ../parallel/concrt/contexts.md + - name: 'How to: Use the Context class to implement a cooperative semaphore' + href: ../parallel/concrt/how-to-use-the-context-class-to-implement-a-cooperative-semaphore.md + - name: 'How to: Use oversubscription to offset latency' + href: ../parallel/concrt/how-to-use-oversubscription-to-offset-latency.md + expanded: false + - name: Memory management functions + items: + - name: Memory management functions + href: ../parallel/concrt/memory-management-functions.md + - name: 'How to: Use Alloc and Free to improve memory performance' + href: ../parallel/concrt/how-to-use-alloc-and-free-to-improve-memory-performance.md + expanded: false + expanded: false + - name: Concurrency Runtime walkthroughs + items: + - name: Concurrency Runtime walkthroughs + href: ../parallel/concrt/concurrency-runtime-walkthroughs.md + - name: 'Walkthrough: Connecting using tasks and xml http requests' + href: ../parallel/concrt/walkthrough-connecting-using-tasks-and-xml-http-requests.md + - name: 'Walkthrough: Creating an agent-based application' + href: ../parallel/concrt/walkthrough-creating-an-agent-based-application.md + - name: 'Walkthrough: Creating a dataflow agent' + href: ../parallel/concrt/walkthrough-creating-a-dataflow-agent.md + - name: 'Walkthrough: Creating an image-processing network' + href: ../parallel/concrt/walkthrough-creating-an-image-processing-network.md + - name: 'Walkthrough: Implementing futures' + href: ../parallel/concrt/walkthrough-implementing-futures.md + - name: 'Walkthrough: Using join to prevent deadlock' + href: ../parallel/concrt/walkthrough-using-join-to-prevent-deadlock.md + - name: 'Walkthrough: Removing work from a user-interface thread' + href: ../parallel/concrt/walkthrough-removing-work-from-a-user-interface-thread.md + - name: 'Walkthrough: Using the Concurrency Runtime in a COM-enabled application' + href: ../parallel/concrt/walkthrough-using-the-concurrency-runtime-in-a-com-enabled-application.md + - name: 'Walkthrough: Adapting existing code to use lightweight tasks' + href: ../parallel/concrt/walkthrough-adapting-existing-code-to-use-lightweight-tasks.md + - name: 'Walkthrough: Creating a custom message block' + href: ../parallel/concrt/walkthrough-creating-a-custom-message-block.md + expanded: false + - name: Concurrency Runtime best practices + items: - name: Concurrency Runtime best practices + href: ../parallel/concrt/concurrency-runtime-best-practices.md + - name: Best practices in the Parallel Patterns Library + href: ../parallel/concrt/best-practices-in-the-parallel-patterns-library.md + - name: Best practices in the Asynchronous Agents Library + href: ../parallel/concrt/best-practices-in-the-asynchronous-agents-library.md + - name: General best practices in the Concurrency Runtime + href: ../parallel/concrt/general-best-practices-in-the-concurrency-runtime.md + expanded: false + - name: Reference + items: + - name: Reference (Concurrency Runtime) + href: ../parallel/concrt/reference/reference-concurrency-runtime.md + - name: concurrency namespace + items: + - name: concurrency namespace + href: ../parallel/concrt/reference/concurrency-namespace.md + - name: concurrency namespace functions + href: ../parallel/concrt/reference/concurrency-namespace-functions.md + - name: concurrency namespace Operators + href: ../parallel/concrt/reference/concurrency-namespace-operators.md + - name: concurrency namespace constants1 + href: ../parallel/concrt/reference/concurrency-namespace-constants1.md + - name: concurrency namespace enums + href: ../parallel/concrt/reference/concurrency-namespace-enums.md + - name: affinity_partitioner class + href: ../parallel/concrt/reference/affinity-partitioner-class.md + - name: agent class + href: ../parallel/concrt/reference/agent-class.md + - name: auto_partitioner class + href: ../parallel/concrt/reference/auto-partitioner-class.md + - name: bad_target class + href: ../parallel/concrt/reference/bad-target-class.md + - name: call class + href: ../parallel/concrt/reference/call-class.md + - name: cancellation_token class + href: ../parallel/concrt/reference/cancellation-token-class.md + - name: cancellation_token_registration class + href: ../parallel/concrt/reference/cancellation-token-registration-class.md + - name: cancellation_token_source class + href: ../parallel/concrt/reference/cancellation-token-source-class.md + - name: choice class + href: ../parallel/concrt/reference/choice-class.md + - name: combinable class + href: ../parallel/concrt/reference/combinable-class.md + - name: concurrent_priority_queue class + href: ../parallel/concrt/reference/concurrent-priority-queue-class.md + - name: concurrent_queue class + href: ../parallel/concrt/reference/concurrent-queue-class.md + - name: concurrent_unordered_map class + href: ../parallel/concrt/reference/concurrent-unordered-map-class.md + - name: concurrent_unordered_multimap class + href: ../parallel/concrt/reference/concurrent-unordered-multimap-class.md + - name: concurrent_unordered_multiset class + href: ../parallel/concrt/reference/concurrent-unordered-multiset-class.md + - name: concurrent_unordered_set class + href: ../parallel/concrt/reference/concurrent-unordered-set-class.md + - name: concurrent_vector class + href: ../parallel/concrt/reference/concurrent-vector-class.md + - name: Context class + href: ../parallel/concrt/reference/context-class.md + - name: context_self_unblock class + href: ../parallel/concrt/reference/context-self-unblock-class.md + - name: context_unblock_unbalanced class + href: ../parallel/concrt/reference/context-unblock-unbalanced-class.md + - name: critical_section class + href: ../parallel/concrt/reference/critical-section-class.md + - name: CurrentScheduler class + href: ../parallel/concrt/reference/currentscheduler-class.md + - name: default_scheduler_exists class + href: ../parallel/concrt/reference/default-scheduler-exists-class.md + - name: DispatchState Structure + href: ../parallel/concrt/reference/dispatchstate-structure.md + - name: event class + href: ../parallel/concrt/reference/event-class.md + - name: IExecutionContext Structure + href: ../parallel/concrt/reference/iexecutioncontext-structure.md + - name: IExecutionResource Structure + href: ../parallel/concrt/reference/iexecutionresource-structure.md + - name: improper_lock class + href: ../parallel/concrt/reference/improper-lock-class.md + - name: improper_scheduler_attach class + href: ../parallel/concrt/reference/improper-scheduler-attach-class.md + - name: improper_scheduler_detach class + href: ../parallel/concrt/reference/improper-scheduler-detach-class.md + - name: improper_scheduler_reference class + href: ../parallel/concrt/reference/improper-scheduler-reference-class.md + - name: invalid_link_target class + href: ../parallel/concrt/reference/invalid-link-target-class.md + - name: invalid_multiple_scheduling class + href: ../parallel/concrt/reference/invalid-multiple-scheduling-class.md + - name: invalid_operation class + href: ../parallel/concrt/reference/invalid-operation-class.md + - name: invalid_oversubscribe_operation class + href: ../parallel/concrt/reference/invalid-oversubscribe-operation-class.md + - name: invalid_scheduler_policy_key class + href: ../parallel/concrt/reference/invalid-scheduler-policy-key-class.md + - name: invalid_scheduler_policy_thread_specification class + href: ../parallel/concrt/reference/invalid-scheduler-policy-thread-specification-class.md + - name: invalid_scheduler_policy_value class + href: ../parallel/concrt/reference/invalid-scheduler-policy-value-class.md + - name: IResourceManager Structure + href: ../parallel/concrt/reference/iresourcemanager-structure.md + - name: IScheduler Structure + href: ../parallel/concrt/reference/ischeduler-structure.md + - name: ISchedulerProxy Structure + href: ../parallel/concrt/reference/ischedulerproxy-structure.md + - name: ISource class + href: ../parallel/concrt/reference/isource-class.md + - name: ITarget class + href: ../parallel/concrt/reference/itarget-class.md + - name: IThreadProxy Structure + href: ../parallel/concrt/reference/ithreadproxy-structure.md + - name: ITopologyExecutionResource Structure + href: ../parallel/concrt/reference/itopologyexecutionresource-structure.md + - name: ITopologyNode Structure + href: ../parallel/concrt/reference/itopologynode-structure.md + - name: IUMSCompletionList Structure + href: ../parallel/concrt/reference/iumscompletionlist-structure.md + - name: IUMSScheduler Structure + href: ../parallel/concrt/reference/iumsscheduler-structure.md + - name: IUMSThreadProxy Structure + href: ../parallel/concrt/reference/iumsthreadproxy-structure.md + - name: IUMSUnblockNotification Structure + href: ../parallel/concrt/reference/iumsunblocknotification-structure.md + - name: IVirtualProcessorRoot Structure + href: ../parallel/concrt/reference/ivirtualprocessorroot-structure.md + - name: join class + href: ../parallel/concrt/reference/join-class.md + - name: location class + href: ../parallel/concrt/reference/location-class.md + - name: message class + href: ../parallel/concrt/reference/message-class.md + - name: message_not_found class + href: ../parallel/concrt/reference/message-not-found-class.md + - name: message_processor class + href: ../parallel/concrt/reference/message-processor-class.md + - name: missing_wait class + href: ../parallel/concrt/reference/missing-wait-class.md + - name: multi_link_registry class + href: ../parallel/concrt/reference/multi-link-registry-class.md + - name: multitype_join class + href: ../parallel/concrt/reference/multitype-join-class.md + - name: nested_scheduler_missing_detach class + href: ../parallel/concrt/reference/nested-scheduler-missing-detach-class.md + - name: network_link_registry class + href: ../parallel/concrt/reference/network-link-registry-class.md + - name: operation_timed_out class + href: ../parallel/concrt/reference/operation-timed-out-class.md + - name: ordered_message_processor class + href: ../parallel/concrt/reference/ordered-message-processor-class.md + - name: overwrite_buffer class + href: ../parallel/concrt/reference/overwrite-buffer-class.md + - name: progress_reporter class + href: ../parallel/concrt/reference/progress-reporter-class.md + - name: propagator_block class + href: ../parallel/concrt/reference/propagator-block-class.md + - name: reader_writer_lock class + href: ../parallel/concrt/reference/reader-writer-lock-class.md + - name: ScheduleGroup class + href: ../parallel/concrt/reference/schedulegroup-class.md + - name: Scheduler class + href: ../parallel/concrt/reference/scheduler-class.md + - name: scheduler_interface Structure + href: ../parallel/concrt/reference/scheduler-interface-structure.md + - name: scheduler_not_attached class + href: ../parallel/concrt/reference/scheduler-not-attached-class.md + - name: scheduler_ptr Structure (Concurrency Runtime) + href: ../parallel/concrt/reference/scheduler-ptr-structure-concurrency-runtime.md + - name: scheduler_resource_allocation_error class + href: ../parallel/concrt/reference/scheduler-resource-allocation-error-class.md + - name: scheduler_worker_creation_error class + href: ../parallel/concrt/reference/scheduler-worker-creation-error-class.md + - name: SchedulerPolicy class + href: ../parallel/concrt/reference/schedulerpolicy-class.md + - name: simple_partitioner class + href: ../parallel/concrt/reference/simple-partitioner-class.md + - name: single_assignment class + href: ../parallel/concrt/reference/single-assignment-class.md + - name: single_link_registry class + href: ../parallel/concrt/reference/single-link-registry-class.md + - name: source_block class + href: ../parallel/concrt/reference/source-block-class.md + - name: source_link_manager class + href: ../parallel/concrt/reference/source-link-manager-class.md + - name: static_partitioner class + href: ../parallel/concrt/reference/static-partitioner-class.md + - name: structured_task_group class + href: ../parallel/concrt/reference/structured-task-group-class.md + - name: target_block class + href: ../parallel/concrt/reference/target-block-class.md + - name: task class (Concurrency Runtime) + href: ../parallel/concrt/reference/task-class.md + - name: task_canceled class + href: ../parallel/concrt/reference/task-canceled-class.md + - name: task_completion_event class + href: ../parallel/concrt/reference/task-completion-event-class.md + - name: task_continuation_context class + href: ../parallel/concrt/reference/task-continuation-context-class.md + - name: task_group class + href: ../parallel/concrt/reference/task-group-class.md + - name: task_handle class + href: ../parallel/concrt/reference/task-handle-class.md + - name: task_options class (Concurrency Runtime) + href: ../parallel/concrt/reference/task-options-class-concurrency-runtime.md + - name: timer class + href: ../parallel/concrt/reference/timer-class.md + - name: transformer class + href: ../parallel/concrt/reference/transformer-class.md + - name: unbounded_buffer class + href: ../parallel/concrt/reference/unbounded-buffer-class.md + - name: unsupported_os class + href: ../parallel/concrt/reference/unsupported-os-class.md expanded: false - items: - - name: Concurrency Runtime best practices - href: ../parallel/concrt/concurrency-runtime-best-practices.md - - name: Best practices in the Parallel Patterns Library - href: ../parallel/concrt/best-practices-in-the-parallel-patterns-library.md - - name: Best practices in the Asynchronous Agents Library - href: ../parallel/concrt/best-practices-in-the-asynchronous-agents-library.md - - name: General best practices in the Concurrency Runtime - href: ../parallel/concrt/general-best-practices-in-the-concurrency-runtime.md - - name: Reference + - name: std namespace + items: + - name: std namespace + href: ../parallel/concrt/reference/std-namespace.md + - name: make_exception_ptr function + href: ../parallel/concrt/reference/make-exception-ptr-function.md expanded: false - items: - - name: Reference (Concurrency Runtime) - href: ../parallel/concrt/reference/reference-concurrency-runtime.md - - name: concurrency namespace - expanded: false - items: - - name: concurrency namespace - href: ../parallel/concrt/reference/concurrency-namespace.md - - name: concurrency namespace functions - href: ../parallel/concrt/reference/concurrency-namespace-functions.md - - name: concurrency namespace Operators - href: ../parallel/concrt/reference/concurrency-namespace-operators.md - - name: concurrency namespace constants1 - href: ../parallel/concrt/reference/concurrency-namespace-constants1.md - - name: concurrency namespace enums - href: ../parallel/concrt/reference/concurrency-namespace-enums.md - - name: affinity_partitioner class - href: ../parallel/concrt/reference/affinity-partitioner-class.md - - name: agent class - href: ../parallel/concrt/reference/agent-class.md - - name: auto_partitioner class - href: ../parallel/concrt/reference/auto-partitioner-class.md - - name: bad_target class - href: ../parallel/concrt/reference/bad-target-class.md - - name: call class - href: ../parallel/concrt/reference/call-class.md - - name: cancellation_token class - href: ../parallel/concrt/reference/cancellation-token-class.md - - name: cancellation_token_registration class - href: ../parallel/concrt/reference/cancellation-token-registration-class.md - - name: cancellation_token_source class - href: ../parallel/concrt/reference/cancellation-token-source-class.md - - name: choice class - href: ../parallel/concrt/reference/choice-class.md - - name: combinable class - href: ../parallel/concrt/reference/combinable-class.md - - name: concurrent_priority_queue class - href: ../parallel/concrt/reference/concurrent-priority-queue-class.md - - name: concurrent_queue class - href: ../parallel/concrt/reference/concurrent-queue-class.md - - name: concurrent_unordered_map class - href: ../parallel/concrt/reference/concurrent-unordered-map-class.md - - name: concurrent_unordered_multimap class - href: ../parallel/concrt/reference/concurrent-unordered-multimap-class.md - - name: concurrent_unordered_multiset class - href: ../parallel/concrt/reference/concurrent-unordered-multiset-class.md - - name: concurrent_unordered_set class - href: ../parallel/concrt/reference/concurrent-unordered-set-class.md - - name: concurrent_vector class - href: ../parallel/concrt/reference/concurrent-vector-class.md - - name: Context class - href: ../parallel/concrt/reference/context-class.md - - name: context_self_unblock class - href: ../parallel/concrt/reference/context-self-unblock-class.md - - name: context_unblock_unbalanced class - href: ../parallel/concrt/reference/context-unblock-unbalanced-class.md - - name: critical_section class - href: ../parallel/concrt/reference/critical-section-class.md - - name: CurrentScheduler class - href: ../parallel/concrt/reference/currentscheduler-class.md - - name: default_scheduler_exists class - href: ../parallel/concrt/reference/default-scheduler-exists-class.md - - name: DispatchState Structure - href: ../parallel/concrt/reference/dispatchstate-structure.md - - name: event class - href: ../parallel/concrt/reference/event-class.md - - name: IExecutionContext Structure - href: ../parallel/concrt/reference/iexecutioncontext-structure.md - - name: IExecutionResource Structure - href: ../parallel/concrt/reference/iexecutionresource-structure.md - - name: improper_lock class - href: ../parallel/concrt/reference/improper-lock-class.md - - name: improper_scheduler_attach class - href: ../parallel/concrt/reference/improper-scheduler-attach-class.md - - name: improper_scheduler_detach class - href: ../parallel/concrt/reference/improper-scheduler-detach-class.md - - name: improper_scheduler_reference class - href: ../parallel/concrt/reference/improper-scheduler-reference-class.md - - name: invalid_link_target class - href: ../parallel/concrt/reference/invalid-link-target-class.md - - name: invalid_multiple_scheduling class - href: ../parallel/concrt/reference/invalid-multiple-scheduling-class.md - - name: invalid_operation class - href: ../parallel/concrt/reference/invalid-operation-class.md - - name: invalid_oversubscribe_operation class - href: ../parallel/concrt/reference/invalid-oversubscribe-operation-class.md - - name: invalid_scheduler_policy_key class - href: ../parallel/concrt/reference/invalid-scheduler-policy-key-class.md - - name: invalid_scheduler_policy_thread_specification class - href: ../parallel/concrt/reference/invalid-scheduler-policy-thread-specification-class.md - - name: invalid_scheduler_policy_value class - href: ../parallel/concrt/reference/invalid-scheduler-policy-value-class.md - - name: IResourceManager Structure - href: ../parallel/concrt/reference/iresourcemanager-structure.md - - name: IScheduler Structure - href: ../parallel/concrt/reference/ischeduler-structure.md - - name: ISchedulerProxy Structure - href: ../parallel/concrt/reference/ischedulerproxy-structure.md - - name: ISource class - href: ../parallel/concrt/reference/isource-class.md - - name: ITarget class - href: ../parallel/concrt/reference/itarget-class.md - - name: IThreadProxy Structure - href: ../parallel/concrt/reference/ithreadproxy-structure.md - - name: ITopologyExecutionResource Structure - href: ../parallel/concrt/reference/itopologyexecutionresource-structure.md - - name: ITopologyNode Structure - href: ../parallel/concrt/reference/itopologynode-structure.md - - name: IUMSCompletionList Structure - href: ../parallel/concrt/reference/iumscompletionlist-structure.md - - name: IUMSScheduler Structure - href: ../parallel/concrt/reference/iumsscheduler-structure.md - - name: IUMSThreadProxy Structure - href: ../parallel/concrt/reference/iumsthreadproxy-structure.md - - name: IUMSUnblockNotification Structure - href: ../parallel/concrt/reference/iumsunblocknotification-structure.md - - name: IVirtualProcessorRoot Structure - href: ../parallel/concrt/reference/ivirtualprocessorroot-structure.md - - name: join class - href: ../parallel/concrt/reference/join-class.md - - name: location class - href: ../parallel/concrt/reference/location-class.md - - name: message class - href: ../parallel/concrt/reference/message-class.md - - name: message_not_found class - href: ../parallel/concrt/reference/message-not-found-class.md - - name: message_processor class - href: ../parallel/concrt/reference/message-processor-class.md - - name: missing_wait class - href: ../parallel/concrt/reference/missing-wait-class.md - - name: multi_link_registry class - href: ../parallel/concrt/reference/multi-link-registry-class.md - - name: multitype_join class - href: ../parallel/concrt/reference/multitype-join-class.md - - name: nested_scheduler_missing_detach class - href: ../parallel/concrt/reference/nested-scheduler-missing-detach-class.md - - name: network_link_registry class - href: ../parallel/concrt/reference/network-link-registry-class.md - - name: operation_timed_out class - href: ../parallel/concrt/reference/operation-timed-out-class.md - - name: ordered_message_processor class - href: ../parallel/concrt/reference/ordered-message-processor-class.md - - name: overwrite_buffer class - href: ../parallel/concrt/reference/overwrite-buffer-class.md - - name: progress_reporter class - href: ../parallel/concrt/reference/progress-reporter-class.md - - name: propagator_block class - href: ../parallel/concrt/reference/propagator-block-class.md - - name: reader_writer_lock class - href: ../parallel/concrt/reference/reader-writer-lock-class.md - - name: ScheduleGroup class - href: ../parallel/concrt/reference/schedulegroup-class.md - - name: Scheduler class - href: ../parallel/concrt/reference/scheduler-class.md - - name: scheduler_interface Structure - href: ../parallel/concrt/reference/scheduler-interface-structure.md - - name: scheduler_not_attached class - href: ../parallel/concrt/reference/scheduler-not-attached-class.md - - name: scheduler_ptr Structure (Concurrency Runtime) - href: ../parallel/concrt/reference/scheduler-ptr-structure-concurrency-runtime.md - - name: scheduler_resource_allocation_error class - href: ../parallel/concrt/reference/scheduler-resource-allocation-error-class.md - - name: scheduler_worker_creation_error class - href: ../parallel/concrt/reference/scheduler-worker-creation-error-class.md - - name: SchedulerPolicy class - href: ../parallel/concrt/reference/schedulerpolicy-class.md - - name: simple_partitioner class - href: ../parallel/concrt/reference/simple-partitioner-class.md - - name: single_assignment class - href: ../parallel/concrt/reference/single-assignment-class.md - - name: single_link_registry class - href: ../parallel/concrt/reference/single-link-registry-class.md - - name: source_block class - href: ../parallel/concrt/reference/source-block-class.md - - name: source_link_manager class - href: ../parallel/concrt/reference/source-link-manager-class.md - - name: static_partitioner class - href: ../parallel/concrt/reference/static-partitioner-class.md - - name: structured_task_group class - href: ../parallel/concrt/reference/structured-task-group-class.md - - name: target_block class - href: ../parallel/concrt/reference/target-block-class.md - - name: task class (Concurrency Runtime) - href: ../parallel/concrt/reference/task-class.md - - name: task_canceled class - href: ../parallel/concrt/reference/task-canceled-class.md - - name: task_completion_event class - href: ../parallel/concrt/reference/task-completion-event-class.md - - name: task_continuation_context class - href: ../parallel/concrt/reference/task-continuation-context-class.md - - name: task_group class - href: ../parallel/concrt/reference/task-group-class.md - - name: task_handle class - href: ../parallel/concrt/reference/task-handle-class.md - - name: task_options class (Concurrency Runtime) - href: ../parallel/concrt/reference/task-options-class-concurrency-runtime.md - - name: timer class - href: ../parallel/concrt/reference/timer-class.md - - name: transformer class - href: ../parallel/concrt/reference/transformer-class.md - - name: unbounded_buffer class - href: ../parallel/concrt/reference/unbounded-buffer-class.md - - name: unsupported_os class - href: ../parallel/concrt/reference/unsupported-os-class.md - - name: std namespace - expanded: false - items: - - name: std namespace - href: ../parallel/concrt/reference/std-namespace.md - - name: make_exception_ptr function - href: ../parallel/concrt/reference/make-exception-ptr-function.md - - name: stdx namespace - expanded: false - items: - - name: stdx namespace - href: ../parallel/concrt/reference/stdx-namespace.md - - name: declval function - href: ../parallel/concrt/reference/declval-function.md -- name: OpenMP + - name: stdx namespace + items: + - name: stdx namespace + href: ../parallel/concrt/reference/stdx-namespace.md + - name: declval function + href: ../parallel/concrt/reference/declval-function.md + expanded: false + expanded: false expanded: false +- name: OpenMP items: - - name: OpenMP in MSVC - href: ../parallel/openmp/openmp-in-visual-cpp.md - - name: SIMD Extension - href: ../parallel/openmp/openmp-simd.md + - name: OpenMP in MSVC + href: ../parallel/openmp/openmp-in-visual-cpp.md + - name: SIMD Extension + href: ../parallel/openmp/openmp-simd.md + - name: OpenMP C and C++ Application Program Interface + items: - name: OpenMP C and C++ Application Program Interface - expanded: false - items: - - name: OpenMP C and C++ Application Program Interface - href: ../parallel/openmp/openmp-c-and-cpp-application-program-interface.md - - name: Introduction - href: ../parallel/openmp/1-introduction.md - - name: Directives - href: ../parallel/openmp/2-directives.md - - name: Run-time library functions - href: ../parallel/openmp/3-run-time-library-functions.md - - name: Environment variables - href: ../parallel/openmp/4-environment-variables.md - - name: Appendices - items: - - name: Examples - href: ../parallel/openmp/a-examples.md - - name: Stubs for run-time library functions - href: ../parallel/openmp/b-stubs-for-run-time-library-functions.md - - name: OpenMP C and C++ grammar - href: ../parallel/openmp/c-openmp-c-and-cpp-grammar.md - - name: The schedule clause - href: ../parallel/openmp/d-using-the-schedule-clause.md - - name: Implementation-defined behaviors in OpenMP C/C++ - href: ../parallel/openmp/e-implementation-defined-behaviors-in-openmp-c-cpp.md - - name: New features and clarifications in version 2.0 - href: ../parallel/openmp/f-new-features-and-clarifications-in-version-2-0.md + href: ../parallel/openmp/openmp-c-and-cpp-application-program-interface.md + - name: Introduction + href: ../parallel/openmp/1-introduction.md + - name: Directives + href: ../parallel/openmp/2-directives.md + - name: Run-time library functions + href: ../parallel/openmp/3-run-time-library-functions.md + - name: Environment variables + href: ../parallel/openmp/4-environment-variables.md + - name: Appendices + items: + - name: Examples + href: ../parallel/openmp/a-examples.md + - name: Stubs for run-time library functions + href: ../parallel/openmp/b-stubs-for-run-time-library-functions.md + - name: OpenMP C and C++ grammar + href: ../parallel/openmp/c-openmp-c-and-cpp-grammar.md + - name: The schedule clause + href: ../parallel/openmp/d-using-the-schedule-clause.md + - name: Implementation-defined behaviors in OpenMP C/C++ + href: ../parallel/openmp/e-implementation-defined-behaviors-in-openmp-c-cpp.md + - name: New features and clarifications in version 2.0 + href: ../parallel/openmp/f-new-features-and-clarifications-in-version-2-0.md + expanded: false + - name: OpenMP library reference + items: - name: OpenMP library reference - expanded: false - items: - - name: OpenMP library reference - href: ../parallel/openmp/reference/openmp-library-reference.md - - name: Directives - href: ../parallel/openmp/reference/openmp-directives.md - - name: Clauses - href: ../parallel/openmp/reference/openmp-clauses.md - - name: Functions - href: ../parallel/openmp/reference/openmp-functions.md - - name: Environment variables - href: ../parallel/openmp/reference/openmp-environment-variables.md -- name: Multithreading support for older code (C++) + href: ../parallel/openmp/reference/openmp-library-reference.md + - name: Directives + href: ../parallel/openmp/reference/openmp-directives.md + - name: Clauses + href: ../parallel/openmp/reference/openmp-clauses.md + - name: Functions + href: ../parallel/openmp/reference/openmp-functions.md + - name: Environment variables + href: ../parallel/openmp/reference/openmp-environment-variables.md + expanded: false expanded: false - items: - - name: Multithreading support for older code (C++) - href: ../parallel/multithreading-support-for-older-code-visual-cpp.md +- name: Multithreading support for older code (C++) + items: + - name: Multithreading support for older code (C++) + href: ../parallel/multithreading-support-for-older-code-visual-cpp.md + - name: Multithreading with C and Win32 + items: - name: Multithreading with C and Win32 - expanded: false - items: - - name: Multithreading with C and Win32 - href: ../parallel/multithreading-with-c-and-win32.md - - name: Sample multithread C program - href: ../parallel/sample-multithread-c-program.md - - name: Thread local storage (TLS) - href: ../parallel/thread-local-storage-tls.md + href: ../parallel/multithreading-with-c-and-win32.md + - name: Sample multithread C program + href: ../parallel/sample-multithread-c-program.md + - name: Thread local storage (TLS) + href: ../parallel/thread-local-storage-tls.md + expanded: false + - name: Multithreading with C++ and MFC + items: - name: Multithreading with C++ and MFC - expanded: false - items: - - name: Multithreading with C++ and MFC - href: ../parallel/multithreading-with-cpp-and-mfc.md - - name: "Multithreading: Creating user-interface threads" - href: ../parallel/multithreading-creating-user-interface-threads.md - - name: "Multithreading: Creating worker threads" - href: ../parallel/multithreading-creating-worker-threads.md - - name: "Multithreading: When to use the synchronization classes" - href: ../parallel/multithreading-when-to-use-the-synchronization-classes.md - - name: "Multithreading: How to use the synchronization classes" - href: ../parallel/multithreading-how-to-use-the-synchronization-classes.md - - name: "Multithreading: Terminating threads" - href: ../parallel/multithreading-terminating-threads.md - - name: "Multithreading: Programming tips" - href: ../parallel/multithreading-programming-tips.md - - name: Multithreading and locales - href: ../parallel/multithreading-and-locales.md + href: ../parallel/multithreading-with-cpp-and-mfc.md + - name: 'Multithreading: Creating user-interface threads' + href: ../parallel/multithreading-creating-user-interface-threads.md + - name: 'Multithreading: Creating worker threads' + href: ../parallel/multithreading-creating-worker-threads.md + - name: 'Multithreading: When to use the synchronization classes' + href: ../parallel/multithreading-when-to-use-the-synchronization-classes.md + - name: 'Multithreading: How to use the synchronization classes' + href: ../parallel/multithreading-how-to-use-the-synchronization-classes.md + - name: 'Multithreading: Terminating threads' + href: ../parallel/multithreading-terminating-threads.md + - name: 'Multithreading: Programming tips' + href: ../parallel/multithreading-programming-tips.md + expanded: false + - name: Multithreading and locales + href: ../parallel/multithreading-and-locales.md + expanded: false From b5f528a8f1ec324d680950e5b2dc89bdc0e188d5 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 19 Mar 2026 15:51:57 -0700 Subject: [PATCH 1708/1799] ignore squad files --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 10b0192bf56..de09a544e84 100644 --- a/.gitignore +++ b/.gitignore @@ -10,6 +10,7 @@ _themes.VS.Modern/ #.github/ .openpublishing.buildcore.ps1 .vscode/ +.squad/ # Documentation build /docs/vcppdocs From d9263a8cb179c57e8a380d021d5bd96dc9f5b733 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 19 Mar 2026 16:00:21 -0700 Subject: [PATCH 1709/1799] ignore squad files (#6661) --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index 10b0192bf56..de09a544e84 100644 --- a/.gitignore +++ b/.gitignore @@ -10,6 +10,7 @@ _themes.VS.Modern/ #.github/ .openpublishing.buildcore.ps1 .vscode/ +.squad/ # Documentation build /docs/vcppdocs From a3acf9e658f03ff6824d6c5f5df3b59392a85068 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 20 Mar 2026 14:04:37 -0700 Subject: [PATCH 1710/1799] fix code example --- docs/c-runtime-library/reference/stat-functions.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/reference/stat-functions.md b/docs/c-runtime-library/reference/stat-functions.md index b1a5efc58ff..19b26217c48 100644 --- a/docs/c-runtime-library/reference/stat-functions.md +++ b/docs/c-runtime-library/reference/stat-functions.md @@ -1,7 +1,7 @@ --- title: "_stat, _stat32, _stat64, _stati64, _stat32i64, _stat64i32, _wstat, _wstat32, _wstat64, _wstati64, _wstat32i64, _wstat64i32" description: "Learn more about: _stat, _stat32, _stat64, _stati64, _stat32i64, _stat64i32, _wstat, _wstat32, _wstat64, _wstati64, _wstat32i64, _wstat64i32" -ms.date: "5/25/2023" +ms.date: 03/20/2026 api_name: ["_wstat64", "_stati64", "_stat32", "_stat32i64", "_stat", "_wstati64", "_wstat32", "_wstat64i32", "_wstat", "_stat64", "_stat64i32", "_wstat32i64", "_o__stat32", "_o__stat32i64", "_o__stat64", "_o__stat64i32", "_o__wstat32", "_o__wstat32i64", "_o__wstat64", "_o__wstat64i32"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-filesystem-l1-1-0.dll"] api_type: ["DLLExport"] @@ -162,13 +162,14 @@ For more compatibility information, see [Compatibility](../compatibility.md). #include #include #include +#include int main( void ) { struct _stat buf; int result; char timebuf[26]; - char* filename = "crt_stat.c"; + const char* filename = "crt_stat.c"; errno_t err; // Get data associated with "crt_stat.c": From e51a904a7991257c57f1f62603177e603932109b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 20 Mar 2026 14:31:30 -0700 Subject: [PATCH 1711/1799] acronlix updates --- .../cgthreads-code-generation-threads.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/build/reference/cgthreads-code-generation-threads.md b/docs/build/reference/cgthreads-code-generation-threads.md index da08ab45b78..20091542bd9 100644 --- a/docs/build/reference/cgthreads-code-generation-threads.md +++ b/docs/build/reference/cgthreads-code-generation-threads.md @@ -1,7 +1,7 @@ --- description: "Learn more about: `/cgthreads` (Code generation threads)" title: "/cgthreads (Code generation threads)" -ms.date: 03/12/2026 +ms.date: 07/31/2020 f1_keywords: ["/cgthreads"] helpviewer_keywords: ["/cgthreads compiler option (C++)", "-cgthreads compiler option (C++)", "cgthreads compiler option (C++)", "cgthreads"] --- @@ -13,18 +13,23 @@ Sets number of `cl.exe` threads to use for optimization and code generation. > **`/cgthreads1`**\ > **`/cgthreads2`**\ -etc. +> **`/cgthreads3`**\ +> **`/cgthreads4`**\ +> **`/cgthreads5`**\ +> **`/cgthreads6`**\ +> **`/cgthreads7`**\ +> **`/cgthreads8`** ## Arguments **`cgthreadsN`**\ -The maximum number of threads for `cl.exe` to use, where *N* is a number in the range 1 to 512. +The maximum number of threads for `cl.exe` to use, where *N* is a number in the range 1 to 8. ## Remarks -The **`cgthreads`** option specifies the maximum number of threads `cl.exe` uses in parallel for the optimization and code generation phases of compilation. No space can appear between **`cgthreads`** and the *number* argument. By default, `cl.exe` uses four threads, as if **`/cgthreads4`** were specified. If more processor cores are available, a larger *number* value improves build times. This option is especially useful when combined with [`/GL` (Whole Program Optimization)](gl-whole-program-optimization.md). +The **`cgthreads`** option specifies the maximum number of threads `cl.exe` uses in parallel for the optimization and code generation phases of compilation. Notice that there can be no space between **`cgthreads`** and the *number* argument. By default, `cl.exe` uses four threads, as if **`/cgthreads4`** were specified. If more processor cores are available, a larger *number* value can improve build times. This option is especially useful when it's combined with [`/GL` (Whole Program Optimization)](gl-whole-program-optimization.md). -Multiple levels of parallelism can be specified for a build. The msbuild.exe switch **`/maxcpucount`** specifies the number of MSBuild processes that can be run in parallel. The [`/MP` (Build with Multiple Processes)](mp-build-with-multiple-processes.md) compiler flag specifies the number of cl.exe processes that simultaneously compile the source files. The **`cgthreads`** option specifies the number of threads used by each cl.exe process. The processor can only run as many threads at the same time as there are processor cores. It's not useful to specify larger values for all of these options at the same time, and it can be counterproductive. For more information about how to build projects in parallel, see [Building Multiple Projects in Parallel](/visualstudio/msbuild/building-multiple-projects-in-parallel-with-msbuild). +Multiple levels of parallelism can be specified for a build. The msbuild.exe switch **`/maxcpucount`** specifies the number of MSBuild processes that can be run in parallel. The [`/MP` (Build with Multiple Processes)](mp-build-with-multiple-processes.md) compiler flag specifies the number of `cl.exe` processes that simultaneously compile the source files. The **`cgthreads`** option specifies the number of threads used by each `cl.exe` process. The processor can only run as many threads at the same time as there are processor cores. It's not useful to specify larger values for all of these options at the same time, and it can be counterproductive. For more information about how to build projects in parallel, see [Building Multiple Projects in Parallel](/visualstudio/msbuild/building-multiple-projects-in-parallel-with-msbuild). ### To set this compiler option in the Visual Studio development environment From 0c0e3794ade84050642d0fd93a4299eac1626c9c Mon Sep 17 00:00:00 2001 From: Justin Piesco <107575186+JustPies@users.noreply.github.com> Date: Tue, 24 Mar 2026 14:02:20 -0400 Subject: [PATCH 1712/1799] updated links --- docs/cpp/c-cpp-language-and-standard-libraries.md | 2 +- docs/overview/what-s-new-for-cpp-2019.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/cpp/c-cpp-language-and-standard-libraries.md b/docs/cpp/c-cpp-language-and-standard-libraries.md index 59218ff5e3e..ee3ccbc4ab2 100644 --- a/docs/cpp/c-cpp-language-and-standard-libraries.md +++ b/docs/cpp/c-cpp-language-and-standard-libraries.md @@ -61,7 +61,7 @@ Classes that simplify the writing of programs that use data parallelism or task Reference for the Microsoft implementation of the OpenMP API. [Proxy library](https://github.com/microsoft/proxy)\ -A header-only C++20 library for using polymorphism in C++ without inheritance. For API reference information, see [Proxy 3 Specifications](https://microsoft.github.io/proxy/docs/specifications.html) +A header-only C++20 library for using polymorphism in C++ without inheritance. For API reference information, see [Proxy 4 Specifications](https://github.com/microsoft/proxy/tree/main/docs/spec#readme) [SafeInt library](../safeint/safeint-library.md)\ A portable library that can be used with MSVC, GCC, or Clang to help prevent integer overflows. diff --git a/docs/overview/what-s-new-for-cpp-2019.md b/docs/overview/what-s-new-for-cpp-2019.md index e79f0e6d590..341347e69cd 100644 --- a/docs/overview/what-s-new-for-cpp-2019.md +++ b/docs/overview/what-s-new-for-cpp-2019.md @@ -134,7 +134,7 @@ For a summary of new features and bug fixes in Visual Studio version 16.8, see [ - Support for ARM64 projects using clang-cl. -- [Intel AMX intrinsics](https://software.intel.com/content/www/us/en/develop/documentation/cpp-compiler-developer-guide-and-reference/top/compiler-reference/intrinsics/intrinsics-for-intel-advanced-matrix-extensions-intel-amx-instructions.html) support. +- [Intel AMX intrinsics](https://www.intel.com/content/www/us/en/developer/articles/code-sample/advanced-matrix-extensions-intrinsics-functions.html) support. ## What's new for C++ in Visual Studio version 16.7 From a035e7f6ce5dd74f8152bb55bbf1f668c1f2aab2 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 24 Mar 2026 11:25:26 -0700 Subject: [PATCH 1713/1799] remove AMP --- docs/parallel/parallel-programming-in-visual-cpp.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/parallel/parallel-programming-in-visual-cpp.md b/docs/parallel/parallel-programming-in-visual-cpp.md index 9a0a35d7c76..15d93e96c22 100644 --- a/docs/parallel/parallel-programming-in-visual-cpp.md +++ b/docs/parallel/parallel-programming-in-visual-cpp.md @@ -1,8 +1,7 @@ --- description: "Learn more about: Parallel Programming in Visual C++" title: "Parallel Programming in Visual C++" -ms.date: "11/04/2016" -ms.assetid: f5c28ab6-a1d9-492f-b207-05e8aee73e96 +ms.date: 03/24/2026 ms.topic: "overview" ms.custom: intro-overview --- @@ -16,7 +15,6 @@ Visual C++ provides the following technologies to help you create multi-threaded |-----------|-----------------| |[Auto-Parallelization and Auto-Vectorization](auto-parallelization-and-auto-vectorization.md)|Compiler optimizations that speed up code.| |[Concurrency Runtime](concrt/concurrency-runtime.md)|Classes that simplify the writing of programs that use data parallelism or task parallelism.| -|[C++ AMP (C++ Accelerated Massive Parallelism)](amp/cpp-amp-cpp-accelerated-massive-parallelism.md)|Classes that enable the use of modern graphics processors for general purpose programming.| -|[Multithreading Support for Older Code (Visual C++)](multithreading-support-for-older-code-visual-cpp.md)|Older technologies that may be useful in older applications. For new apps, use the Concurrency Runtime or C++ AMP.| +|[Multithreading Support for Older Code (Visual C++)](multithreading-support-for-older-code-visual-cpp.md)|Older technologies that may be useful in older applications. For new apps, use the Concurrency Runtime.| |[OpenMP](openmp/openmp-in-visual-cpp.md)|The Microsoft implementation of the OpenMP API.| |[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)|This section of the documentation contains information about most of the features of Visual C++.| From 91e4b771e2a321f33448ce02500372f88294e70d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 24 Mar 2026 11:49:40 -0700 Subject: [PATCH 1714/1799] add moniker --- docs/parallel/parallel-programming-in-visual-cpp.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/parallel/parallel-programming-in-visual-cpp.md b/docs/parallel/parallel-programming-in-visual-cpp.md index 15d93e96c22..249c0b958b7 100644 --- a/docs/parallel/parallel-programming-in-visual-cpp.md +++ b/docs/parallel/parallel-programming-in-visual-cpp.md @@ -18,3 +18,6 @@ Visual C++ provides the following technologies to help you create multi-threaded |[Multithreading Support for Older Code (Visual C++)](multithreading-support-for-older-code-visual-cpp.md)|Older technologies that may be useful in older applications. For new apps, use the Concurrency Runtime.| |[OpenMP](openmp/openmp-in-visual-cpp.md)|The Microsoft implementation of the OpenMP API.| |[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)|This section of the documentation contains information about most of the features of Visual C++.| +::: moniker range="<=msvc-160" +|[C++ AMP (C++ Accelerated Massive Parallelism)](amp/cpp-amp-cpp-accelerated-massive-parallelism.md)|Classes that enable the use of modern graphics processors for general purpose programming.| +:::moniker-end From d8cb371587450dccc28c0d87338cf7653936dec6 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 24 Mar 2026 14:08:15 -0700 Subject: [PATCH 1715/1799] fix markdown --- .../parallel/parallel-programming-in-visual-cpp.md | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/docs/parallel/parallel-programming-in-visual-cpp.md b/docs/parallel/parallel-programming-in-visual-cpp.md index 249c0b958b7..2aec9538eb0 100644 --- a/docs/parallel/parallel-programming-in-visual-cpp.md +++ b/docs/parallel/parallel-programming-in-visual-cpp.md @@ -11,13 +11,23 @@ Visual C++ provides the following technologies to help you create multi-threaded ## Related Articles +::: moniker range="<=msvc-160" |Title|Description| |-----------|-----------------| |[Auto-Parallelization and Auto-Vectorization](auto-parallelization-and-auto-vectorization.md)|Compiler optimizations that speed up code.| |[Concurrency Runtime](concrt/concurrency-runtime.md)|Classes that simplify the writing of programs that use data parallelism or task parallelism.| -|[Multithreading Support for Older Code (Visual C++)](multithreading-support-for-older-code-visual-cpp.md)|Older technologies that may be useful in older applications. For new apps, use the Concurrency Runtime.| +|[Multithreading Support for Older Code (Visual C++)](multithreading-support-for-older-code-visual-cpp.md)|Older technologies that may be useful in older applications. For new apps, use the Concurrency Runtime or C++ AMP.| |[OpenMP](openmp/openmp-in-visual-cpp.md)|The Microsoft implementation of the OpenMP API.| |[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)|This section of the documentation contains information about most of the features of Visual C++.| -::: moniker range="<=msvc-160" |[C++ AMP (C++ Accelerated Massive Parallelism)](amp/cpp-amp-cpp-accelerated-massive-parallelism.md)|Classes that enable the use of modern graphics processors for general purpose programming.| :::moniker-end +::: moniker range=">msvc-160" +|Title|Description| +|-----------|-----------------| +|[Auto-Parallelization and Auto-Vectorization](auto-parallelization-and-auto-vectorization.md)|Compiler optimizations that speed up code.| +|[Concurrency Runtime](concrt/concurrency-runtime.md)|Classes that simplify the writing of programs that use data parallelism or task parallelism.| +|[Multithreading Support for Older Code (Visual C++)](multithreading-support-for-older-code-visual-cpp.md)|Older technologies that may be useful in older applications. For new apps, use the Concurrency Runtime.| +|[OpenMP](openmp/openmp-in-visual-cpp.md)|The Microsoft implementation of the OpenMP API.| +|[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)|This section of the documentation contains information about most of the features of Visual C++.| +:::moniker-end + From 5b8875b2993bc9a51ec530fabcc1e180583b6585 Mon Sep 17 00:00:00 2001 From: "Docs.Archive pipeline" Date: Tue, 24 Mar 2026 21:15:09 +0000 Subject: [PATCH 1716/1799] [DocsArchive-1.0.26057.1](2026-03-24-21-14-41)Auto archive content --- .openpublishing.redirection.json | 560 +++++++++++++++++++++++++++++++ docs/docfx.json | 3 +- 2 files changed, 562 insertions(+), 1 deletion(-) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index f4bb352073f..9c53df0bcc0 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1,5 +1,565 @@ { "redirections": [ + { + "source_path": "docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/cpp-amp-overview.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-overview", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/graphics-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/graphics-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-accelerator-and-accelerator-view-objects", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-cpp-amp-in-windows-store-apps", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-lambdas-function-objects-and-restricted-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/using-tiles.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-tiles", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-debugging-a-cpp-amp-application.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-debugging-a-cpp-amp-application", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-matrix-multiplication.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-matrix-multiplication", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-removed-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-removed-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/adopt-d3d-access-lock-t-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/adopt-d3d-access-lock-t-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/completion-future-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/completion-future-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-enums.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-enums", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-constants-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-constants-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-enums-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-enums-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-operators-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-operators-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/invalid-compute-domain-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/invalid-compute-domain-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/out-of-memory-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/out-of-memory-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/reference-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/reference-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/runtime-exception-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/runtime-exception-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/sampler-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/sampler-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/scoped-d3d-access-lock-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/scoped-d3d-access-lock-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-traits-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-traits-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tile-barrier-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tile-barrier-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uninitialized-object-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uninitialized-object-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unsupported-feature-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unsupported-feature-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, + { + "source_path": "docs/parallel/amp/reference/writeonly-texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/writeonly-texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-180" + ] + }, { "source_path": "docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md", "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism", diff --git a/docs/docfx.json b/docs/docfx.json index ad6d38ef295..04421fa8583 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -345,7 +345,8 @@ }, "exclude_monikers": { "parallel/amp/**/*.{md,yml,yaml}": [ - "msvc-170" + "msvc-170", + "msvc-180" ] } }, From 3a4786b90b3ef7ddd883cdf9844adb87cd0b0ab8 Mon Sep 17 00:00:00 2001 From: David Justo Date: Wed, 25 Mar 2026 13:52:18 -0700 Subject: [PATCH 1717/1799] document debuginformation flags --- docs/build/reference/c-cpp-prop-page.md | 8 +++---- .../z7-zi-zi-debug-information-format.md | 21 +++++++++++++++++++ 2 files changed, 25 insertions(+), 4 deletions(-) diff --git a/docs/build/reference/c-cpp-prop-page.md b/docs/build/reference/c-cpp-prop-page.md index 80e4b1f366b..2a7bd6765bf 100644 --- a/docs/build/reference/c-cpp-prop-page.md +++ b/docs/build/reference/c-cpp-prop-page.md @@ -47,10 +47,10 @@ Specifies the type of debugging information generated by the compiler. This pro #### Choices -- **None** - Produces no debugging information, so compilation may be faster. -- **C7 compatible** - Select the type of debugging information created for your program and whether this information is kept in object (.obj) files or in a program database (PDB). -- **Program Database** - Produces a program database (PDB) that contains type information and symbolic debugging information for use with the debugger. The symbolic debugging information includes the names and types of variables and functions, and line numbers. -- **Program Database for Edit And Continue** - Produces a program database, as described previously, in a format that supports the [Edit and Continue](/visualstudio/debugger/edit-and-continue) feature. +- **None** (`None`) - Produces no debugging information, so compilation may be faster. +- **C7 compatible** (`OldStyle`) - Select the type of debugging information created for your program and whether this information is kept in object (.obj) files or in a program database (PDB). +- **Program Database** (`ProgramDatabase`) - Produces a program database (PDB) that contains type information and symbolic debugging information for use with the debugger. The symbolic debugging information includes the names and types of variables and functions, and line numbers. +- **Program Database for Edit And Continue** (`EditAndContinue`) - Produces a program database, as described previously, in a format that supports the [Edit and Continue](/visualstudio/debugger/edit-and-continue) feature. ### Support Just My Code Debugging diff --git a/docs/build/reference/z7-zi-zi-debug-information-format.md b/docs/build/reference/z7-zi-zi-debug-information-format.md index 6cc70e4d4c8..df251b7c4aa 100644 --- a/docs/build/reference/z7-zi-zi-debug-information-format.md +++ b/docs/build/reference/z7-zi-zi-debug-information-format.md @@ -62,6 +62,27 @@ The **`/ZI`** option forces both the [`/Gy` (Enable Function-Level Linking)](gy- 1. Modify the **Debug Information Format** property. Choose **OK** to save your changes. +### To set this compiler option in a project file + +To set the debug information format in a `.vcxproj` project file, use the `` property within a `` item definition. The following table shows the MSBuild XML values and their corresponding compiler options: + +| MSBuild XML value | Compiler option | Description | +|---|---|---| +| `None` | *(none)* | No debug information | +| `OldStyle` | **`/Z7`** | C7-compatible debug information | +| `ProgramDatabase` | **`/Zi`** | Program database (PDB) | +| `EditAndContinue` | **`/ZI`** | PDB with Edit and Continue support | + +For example, to set the debug information format to program database in a release configuration: + +```xml + + + ProgramDatabase + + +``` + ### To set this compiler option programmatically - See . From c7da63cce3e0b7baad0a03c3e0d210b4ee75518a Mon Sep 17 00:00:00 2001 From: ChanPark Date: Wed, 25 Mar 2026 16:56:08 -0700 Subject: [PATCH 1718/1799] Revert all changes --- docs/embedded/media/serial-monitor-vscode.png | Bin 45810 -> 30294 bytes docs/embedded/media/serial-monitor.png | Bin 27462 -> 28291 bytes docs/embedded/serial-monitor.md | 50 +++++++++++------- 3 files changed, 31 insertions(+), 19 deletions(-) diff --git a/docs/embedded/media/serial-monitor-vscode.png b/docs/embedded/media/serial-monitor-vscode.png index 08c640ae17ed27357af7fc4b09b15d96fb3db95b..29a6c931e11e5f04eda11626da1373f233ce1fe1 100644 GIT binary patch literal 30294 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 literal 45810 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 r0TfNXdsd)RoOjHl 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 RlHUS8FI2RZYZPC-|9?jNNlO3# diff --git a/docs/embedded/media/serial-monitor.png b/docs/embedded/media/serial-monitor.png index 633e19edd21760ad590724eb663020b659ae916f..e247eef5e74d46d6d2facf694a69ae6b056546d6 100644 GIT binary patch literal 28291 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%0Df|>ST^x_-EN$+!ktA4RPfj|MbDilidKu`Rom{X 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 diff --git a/docs/embedded/serial-monitor.md b/docs/embedded/serial-monitor.md index 8f396f4e72c..3081df27700 100644 --- a/docs/embedded/serial-monitor.md +++ b/docs/embedded/serial-monitor.md @@ -8,21 +8,25 @@ monikerRange: '>=msvc-170' --- # Serial Monitor +> [!NOTE] +> This article references a non-Microsoft extension and is not actively maintained. The information might not reflect the current state of the Serial Monitor 2 extension. + ## Overview The Serial Monitor allows users to configure, monitor, and communicate with serial ports. # [Visual Studio](#tab/visual-studio) -To install Serial Monitor in Visual Studio, go to **Extensions** > **Manage Extensions**. Search for **Serial Monitor 2** in the extensions marketplace. Select **Install** and then restart Visual Studio to complete the installation. - -To activate the Serial Monitor window, select **Tools** from the menu bar and then choose **Serial Monitor 2**. - -:::image type="content" source="media/serial-monitor.png" alt-text="Screenshot of the Visual Studio Serial Monitor window."::: +:::image type="complex" source="./media/serial-monitor.png" alt-text="Screenshot of the Visual Studio Serial Monitor window."::: +The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section shows the messages, consisting of four lines of the text Hello, World! +:::image-end::: ## Capabilities -- **Send data to a serial port**: Enter text into the **Command** text field at the bottom of the view. Select **Send** to send the data. +- **Monitor a serial port**: Choose the **Start Monitoring** or **Stop Monitoring** button to control whether to monitor data coming from the port. +- **Send data to a serial port**: Enter text into the text field at the bottom of the view. Use the **Enter** key or choose the **Send Message** arrow button to send the data. +- **Clear the Serial Monitor output**: Choose the **Clear Output** button to clear the incoming data text field. +- **Send preset control signals**: Use the split-button next to the input field to send preset control signals (Ctrl+C, Ctrl+D, Ctrl+X, and Ctrl+Z). - **Configure Serial Monitor and port connection settings**: See the following table to learn about the settings that the Serial Monitor provides. ## Configurable settings @@ -30,20 +34,26 @@ To activate the Serial Monitor window, select **Tools** from the menu bar and th | Settings | Description | Usage | Available options | |--|--|--|--| | **Port** | Ports that are actively connected to a device | Use the **Port** dropdown | Serial port compatible devices connected to the machine | -| **Baud rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud Rate** dropdown | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 | -| **Encoding** | Can select type of encoding for messages sent to serial port | Use the **Encoding** dropdown in **Serial** mode | Text (utf8), Hex, Binary | +| **Baud Rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud Rate** dropdown | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 | +| **Line Ending** | The line ending to use in messages sent to the connected device | Use the **Line Ending** dropdown | None, LF, CR, CRLF | +| **Timestamp** | Adds timestamps to the output of data received from the connected port | Use the **timestamp** toggle button | On/Off | +| **Autoscroll** | Whether to auto-scroll new content that comes from the connected port | Use the **autoscroll** toggle button | On/Off | +| **Automatic Reconnection** | Allows for automatic reconnection and monitoring of disconnected selected ports | Use the **automatic reconnection** toggle button in **Serial** mode | On/Off | +| **Message Encoding** | Can select type of encoding for messages sent to serial port | Use the **message encoding** dropdown in **Serial** mode | Text (utf8), Hex, Binary | | **Data bits** | Can select how many data bits are used for the serial port connection | Use the **Data bits** dropdown in the **additional settings** | 5, 6, 7, 8 | | **Stop bits** | Can select how many stop bits are used for the serial port connection | Use the **Stop bits** dropdown in the **additional settings** | 1, 1.5, 2 | | **Parity** | Can select what parity is used for the serial port connection | Use the **Parity** dropdown in the **additional settings** | None, Odd, Even, Mark, Space | -| **File Logging** | Allows the ability to log output to a file | Use the **file logging** toggle button, as well as the **Record file path** button to choose the desired directory | On/Off | +| **File Logging** | Allows the ability to log output to a file | Use the **file logging** toggle button, as well as the **Choose Log File Directory** button to choose the desired directory in the **additional settings** | On/Off | # [Visual Studio Code](#tab/visual-studio-code) -To install Serial Monitor in Visual Studio Code, open the extensions marketplace and then search for **Serial Monitor**. Select **Install**. - -To activate the Serial Monitor window, select **Terminal** from the menu bar and choose **New Terminal**. Then, select **Serial Monitor** from the tabs. +:::image type="complex" source="./media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window."::: +The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section where messages are displayed is empty. +:::image-end::: -:::image type="content" source="media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window."::: +:::image type="complex" source="./media/serial-monitor-vscode-tcp.png" alt-text="Screenshot of the VS Code TCP Serial Monitor window."::: +The window is split into two sections. The top section shows the monitoring mode (TCP), Host (::1), Port (1234), and a Start monitoring button. The bottom section shows the messages, starting with "Opening the TCP connection on ::1:1234. Then Connected to ::1:1234. Then five lines of the text Hello, World!. Then Closed the TCP connection ::1:1234. +:::image-end::: ## Capabilities @@ -54,13 +64,15 @@ To activate the Serial Monitor window, select **Terminal** from the menu bar and - **Clear the Serial Monitor output**: Choose the **Clear Output** button to clear the incoming data text field. - **Send preset control signals**: Use the split-button next to the input field to send preset control signals (Ctrl+C, Ctrl+D, Ctrl+X, and Ctrl+Z). - **Configure Serial Monitor and connection settings**: See the following table to learn about the settings that the Serial Monitor provides. +- **Clear the Serial Monitor output**: Choose the **Clear Output** button to clear the incoming data text field. +- **Send preset control signals**: Use the split-button next to the input field to send preset control signals (Ctrl+C, Ctrl+D, Ctrl+X, and Ctrl+Z). ## Configurable settings | Settings | Description | Usage | Available options | |--|--|--|--| | **Port** | Ports that are actively connected to a device | Use the **Port** dropdown in **Serial** mode | Serial port compatible devices connected to the machine | -| **Baud rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud rate** dropdown in **Serial** mode | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 | +| **Baud Rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud Rate** dropdown in **Serial** mode | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 | | **Host** | Name of your host address | Use the **Host** text box to enter your host name in **TCP** mode | Any string that matches a valid host | | **Port** | The port number of your address | Use the **Port** text box in **TCP** mode | Any valid TCP port | | **Line Ending** | The line ending to use in messages sent to the connected device | Use the **Line Ending** dropdown in **Serial** mode | None, LF, CR, CRLF | @@ -68,13 +80,13 @@ To activate the Serial Monitor window, select **Terminal** from the menu bar and | **RTS** | Allows the RTS COM output line to be manually set | Use the **RTS** checkbox | True/False | | **Timestamp** | Adds timestamps to the output of data received from the connected port | Use the **timestamp** toggle button | On/Off | | **Autoscroll** | Whether to auto-scroll new content that comes from the connected port | Use the **autoscroll** toggle button | On/Off | -| **Automatic reconnection** | Allows for automatic reconnection and monitoring of disconnected selected ports | Use the **automatic reconnection** toggle button | On/Off| -| **Message echoing** | Allows the ability to echo/not echo messages you send | Use the **message echoing** toggle button | On/Off | -| **Message encoding** | Can select type of encoding for messages sent to serial port | Use the **message encoding** dropdown | Text (utf8), Hex, Binary | +| **Automatic Reconnection** | Allows for automatic reconnection and monitoring of disconnected selected ports | Use the **automatic reconnection** toggle button | On/Off| +| **Message Echoing** | Allows the ability to echo/not echo messages you send | Use the **message echoing** toggle button | On/Off | +| **Message Encoding** | Can select type of encoding for messages sent to serial port | Use the **message encoding** dropdown | Text (utf8), Hex, Binary | | **Data bits** | Can select how many data bits are used for the serial port connection | Use the **Data bits** dropdown in the **additional settings** | 5, 6, 7, 8 | | **Stop bits** | Can select how many stop bits are used for the serial port connection | Use the **Stop bits** dropdown in the **additional settings** | 1, 1.5, 2 | | **Parity** | Can select what parity is used for the serial port connection | Use the **Parity** dropdown in the **additional settings** | None, Odd, Even, Mark, Space | -| **File logging** | Allows the ability to log output to a file | Use the **file logging** toggle button, as well as the **Choose Log File Directory** button to choose the desired directory in the **additional settings** | On/Off | +| **File Logging** | Allows the ability to log output to a file | Use the **file logging** toggle button, as well as the **Choose Log File Directory** button to choose the desired directory in the **additional settings** | On/Off | | **Serial Wire Output (SWO)** | Can enable Serial Wire Output (SWO) decoding | Use the **Serial Wire Output** toggle in the **additional settings** in **TCP** mode | On/Off | ---- +--- \ No newline at end of file From b3adf48b970f8483e545329610b307c590cf65d2 Mon Sep 17 00:00:00 2001 From: David Justo Date: Wed, 25 Mar 2026 18:54:46 -0700 Subject: [PATCH 1719/1799] respond to feedback: clarify Z7 comments --- docs/build/reference/c-cpp-prop-page.md | 2 +- docs/build/reference/z7-zi-zi-debug-information-format.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/c-cpp-prop-page.md b/docs/build/reference/c-cpp-prop-page.md index 2a7bd6765bf..fa9184b6357 100644 --- a/docs/build/reference/c-cpp-prop-page.md +++ b/docs/build/reference/c-cpp-prop-page.md @@ -48,7 +48,7 @@ Specifies the type of debugging information generated by the compiler. This pro #### Choices - **None** (`None`) - Produces no debugging information, so compilation may be faster. -- **C7 compatible** (`OldStyle`) - Select the type of debugging information created for your program and whether this information is kept in object (.obj) files or in a program database (PDB). +- **C7 compatible** (`OldStyle`) - Produces object files that contain full symbolic debugging information. No PDB file is produced. - **Program Database** (`ProgramDatabase`) - Produces a program database (PDB) that contains type information and symbolic debugging information for use with the debugger. The symbolic debugging information includes the names and types of variables and functions, and line numbers. - **Program Database for Edit And Continue** (`EditAndContinue`) - Produces a program database, as described previously, in a format that supports the [Edit and Continue](/visualstudio/debugger/edit-and-continue) feature. diff --git a/docs/build/reference/z7-zi-zi-debug-information-format.md b/docs/build/reference/z7-zi-zi-debug-information-format.md index df251b7c4aa..3faba3c0f19 100644 --- a/docs/build/reference/z7-zi-zi-debug-information-format.md +++ b/docs/build/reference/z7-zi-zi-debug-information-format.md @@ -69,7 +69,7 @@ To set the debug information format in a `.vcxproj` project file, use the ` Date: Thu, 26 Mar 2026 09:02:09 -0700 Subject: [PATCH 1720/1799] update date metadata --- docs/build/reference/c-cpp-prop-page.md | 2 +- docs/build/reference/z7-zi-zi-debug-information-format.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/c-cpp-prop-page.md b/docs/build/reference/c-cpp-prop-page.md index fa9184b6357..dce5341a0ff 100644 --- a/docs/build/reference/c-cpp-prop-page.md +++ b/docs/build/reference/c-cpp-prop-page.md @@ -1,7 +1,7 @@ --- title: "C/C++ Project Properties (Visual Studio)" description: "Reference guide to the Visual Studio Microsoft C/C++ project Property Pages properties." -ms.date: 6/9/2023 +ms.date: 3/26/2026 ms.topic: "article" f1_keywords: ["VC.Project.VCCLCompilerTool.AdditionalModuleDirectories", "VC.Project.VCCLCompilerTool.ScanSourceForModuleDependencies"] --- diff --git a/docs/build/reference/z7-zi-zi-debug-information-format.md b/docs/build/reference/z7-zi-zi-debug-information-format.md index 3faba3c0f19..4cf63809f02 100644 --- a/docs/build/reference/z7-zi-zi-debug-information-format.md +++ b/docs/build/reference/z7-zi-zi-debug-information-format.md @@ -1,7 +1,7 @@ --- description: "Learn more about: /Z7, /Zi, /ZI (Debug Information Format)" title: "/Z7, /Zi, /ZI (Debug Information Format)" -ms.date: 12/09/2021 +ms.date: 3/26/2026 f1_keywords: ["VC.Project.VCCLCompilerTool.DebugInformationFormat", "/ZI", "/Zi", "/Z7", "VC.Project.VCCLWCECompilerTool.DebugInformationFormat"] helpviewer_keywords: ["C7 compatible compiler option [C++]", "Debug Information Format compiler option", "ZI compiler option", "-Zi compiler option [C++]", "/ZI compiler option [C++]", "Z7 compiler option [C++]", "debugging [C++], debug information files", "Zi compiler option [C++]", "/Zi compiler option [C++]", "program database compiler option [C++]", "full symbolic debugging information", "/Z7 compiler option [C++]", "line numbers only compiler option [C++]", "cl.exe compiler, debugging options", "-Z7 compiler option [C++]"] --- From 09cd5b750d5cc04d59e6c607dbea85996b29e4bd Mon Sep 17 00:00:00 2001 From: Dan Moseley Date: Thu, 26 Mar 2026 11:51:36 -0600 Subject: [PATCH 1721/1799] /CETCOMPAT: correct supported architectures to x64 only (#5911) --- docs/build/reference/cetcompat.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/cetcompat.md b/docs/build/reference/cetcompat.md index d5c8870b4c0..984e60d83ad 100644 --- a/docs/build/reference/cetcompat.md +++ b/docs/build/reference/cetcompat.md @@ -23,7 +23,7 @@ Specifies that the executable shouldn't be marked compatible with CET Shadow Sta Control-flow Enforcement Technology (CET) Shadow Stack is a computer processor feature. It provides capabilities to defend against return-oriented programming (ROP) based malware attacks. For more information, see [A Technical Look at Intel's Control-flow Enforcement Technology](https://software.intel.com/content/www/us/en/develop/articles/technical-look-control-flow-enforcement-technology.html). -The **`/CETCOMPAT`** linker option tells the linker to mark the binary as CET Shadow Stack-compatible. **`/CETCOMPAT:NO`** marks the binary as not compatible with CET Shadow Stack. If both options are specified on the command line, the last one specified is used. This switch is currently only applicable to x86 and x64 architectures. +The **`/CETCOMPAT`** linker option tells the linker to mark the binary as CET Shadow Stack-compatible. **`/CETCOMPAT:NO`** marks the binary as not compatible with CET Shadow Stack. If both options are specified on the command line, the last one specified is used. This switch is currently only applicable to the x64 architecture. The **`/CETCOMPAT`** option is available beginning in Visual Studio 2019. From b1810fd9b6f82771a84276fb4344137fc722e4a0 Mon Sep 17 00:00:00 2001 From: ChanPark Date: Thu, 26 Mar 2026 10:52:39 -0700 Subject: [PATCH 1722/1799] Add instructions back --- docs/embedded/serial-monitor.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/embedded/serial-monitor.md b/docs/embedded/serial-monitor.md index 3081df27700..48d55fb9c04 100644 --- a/docs/embedded/serial-monitor.md +++ b/docs/embedded/serial-monitor.md @@ -9,7 +9,7 @@ monikerRange: '>=msvc-170' # Serial Monitor > [!NOTE] -> This article references a non-Microsoft extension and is not actively maintained. The information might not reflect the current state of the Serial Monitor 2 extension. +> This article is no longer maintained. It references a non-Microsoft extension and might not reflect the current state of the Serial Monitor 2 extension. ## Overview @@ -17,6 +17,8 @@ The Serial Monitor allows users to configure, monitor, and communicate with seri # [Visual Studio](#tab/visual-studio) +To install Serial Monitor in Visual Studio, go to **Extensions** > **Manage Extensions**. Search for **Serial Monitor 2** in the extensions marketplace. Select **Install** and then restart Visual Studio to complete the installation. + :::image type="complex" source="./media/serial-monitor.png" alt-text="Screenshot of the Visual Studio Serial Monitor window."::: The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section shows the messages, consisting of four lines of the text Hello, World! :::image-end::: @@ -47,6 +49,8 @@ The window is split into two sections. The top section shows the monitoring mode # [Visual Studio Code](#tab/visual-studio-code) +To install Serial Monitor in Visual Studio Code, open the extensions marketplace and then search for **Serial Monitor**. Select **Install**. + :::image type="complex" source="./media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window."::: The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section where messages are displayed is empty. :::image-end::: @@ -89,4 +93,4 @@ The window is split into two sections. The top section shows the monitoring mode | **File Logging** | Allows the ability to log output to a file | Use the **file logging** toggle button, as well as the **Choose Log File Directory** button to choose the desired directory in the **additional settings** | On/Off | | **Serial Wire Output (SWO)** | Can enable Serial Wire Output (SWO) decoding | Use the **Serial Wire Output** toggle in the **additional settings** in **TCP** mode | On/Off | ---- \ No newline at end of file +--- From 9e950e694f7482dfd646f87d3974c58c7982bd3f Mon Sep 17 00:00:00 2001 From: "Docs.Archive pipeline" Date: Mon, 30 Mar 2026 21:56:09 +0000 Subject: [PATCH 1723/1799] [DocsArchive-1.0.26057.1](2026-03-30-21-55-42)Auto archive content --- .openpublishing.redirection.json | 560 +++++++++++++++++++++++++++++++ docs/docfx.json | 3 +- 2 files changed, 562 insertions(+), 1 deletion(-) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 9c53df0bcc0..951e6b990ad 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1,5 +1,565 @@ { "redirections": [ + { + "source_path": "docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/cpp-amp-overview.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-overview", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/graphics-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/graphics-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-accelerator-and-accelerator-view-objects", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-cpp-amp-in-windows-store-apps", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-lambdas-function-objects-and-restricted-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/using-tiles.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-tiles", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-debugging-a-cpp-amp-application.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-debugging-a-cpp-amp-application", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-matrix-multiplication.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-matrix-multiplication", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-removed-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-removed-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/adopt-d3d-access-lock-t-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/adopt-d3d-access-lock-t-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/completion-future-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/completion-future-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-enums.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-enums", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-constants-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-constants-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-enums-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-enums-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-operators-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-operators-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/invalid-compute-domain-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/invalid-compute-domain-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/out-of-memory-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/out-of-memory-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/reference-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/reference-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/runtime-exception-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/runtime-exception-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/sampler-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/sampler-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/scoped-d3d-access-lock-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/scoped-d3d-access-lock-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-traits-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-traits-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tile-barrier-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tile-barrier-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uninitialized-object-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uninitialized-object-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unsupported-feature-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unsupported-feature-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, + { + "source_path": "docs/parallel/amp/reference/writeonly-texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/writeonly-texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-140" + ] + }, { "source_path": "docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md", "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism", diff --git a/docs/docfx.json b/docs/docfx.json index 04421fa8583..78303d85aca 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -346,7 +346,8 @@ "exclude_monikers": { "parallel/amp/**/*.{md,yml,yaml}": [ "msvc-170", - "msvc-180" + "msvc-180", + "msvc-140" ] } }, From 829454e8406a11138ae7ef87e7179f054b600c52 Mon Sep 17 00:00:00 2001 From: "Docs.Archive pipeline" Date: Mon, 30 Mar 2026 22:53:26 +0000 Subject: [PATCH 1724/1799] [DocsArchive-1.0.26057.1](2026-03-30-22-52-59)Auto archive content --- .openpublishing.redirection.json | 560 +++++++++++++++++++++++++++++++ docs/docfx.json | 3 +- 2 files changed, 562 insertions(+), 1 deletion(-) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 951e6b990ad..2c57c05f29e 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1,5 +1,565 @@ { "redirections": [ + { + "source_path": "docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/cpp-amp-overview.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-overview", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/graphics-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/graphics-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-accelerator-and-accelerator-view-objects", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-cpp-amp-in-windows-store-apps", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-lambdas-function-objects-and-restricted-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/using-tiles.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-tiles", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-debugging-a-cpp-amp-application.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-debugging-a-cpp-amp-application", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-matrix-multiplication.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-matrix-multiplication", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-removed-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-removed-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/adopt-d3d-access-lock-t-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/adopt-d3d-access-lock-t-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/completion-future-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/completion-future-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-enums.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-enums", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-constants-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-constants-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-enums-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-enums-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-operators-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-operators-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/invalid-compute-domain-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/invalid-compute-domain-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/out-of-memory-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/out-of-memory-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/reference-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/reference-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/runtime-exception-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/runtime-exception-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/sampler-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/sampler-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/scoped-d3d-access-lock-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/scoped-d3d-access-lock-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-traits-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-traits-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tile-barrier-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tile-barrier-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uninitialized-object-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uninitialized-object-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unsupported-feature-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unsupported-feature-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, + { + "source_path": "docs/parallel/amp/reference/writeonly-texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/writeonly-texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-150" + ] + }, { "source_path": "docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md", "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism", diff --git a/docs/docfx.json b/docs/docfx.json index 78303d85aca..89cb19b620f 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -347,7 +347,8 @@ "parallel/amp/**/*.{md,yml,yaml}": [ "msvc-170", "msvc-180", - "msvc-140" + "msvc-140", + "msvc-150" ] } }, From ea9012d1493507e0a0b3741bd5a3d5039103e440 Mon Sep 17 00:00:00 2001 From: "Docs.Archive pipeline" Date: Tue, 31 Mar 2026 01:40:49 +0000 Subject: [PATCH 1725/1799] [DocsArchive-1.0.26057.1](2026-03-31-01-40-23)Auto archive content --- .openpublishing.redirection.json | 560 +++++++++++++++++++++++++++++++ docs/docfx.json | 3 +- 2 files changed, 562 insertions(+), 1 deletion(-) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 2c57c05f29e..717a62c31c1 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1,5 +1,565 @@ { "redirections": [ + { + "source_path": "docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/cpp-amp-overview.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-overview", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/graphics-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/graphics-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-accelerator-and-accelerator-view-objects", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-cpp-amp-in-windows-store-apps", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-lambdas-function-objects-and-restricted-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/using-tiles.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/using-tiles", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-debugging-a-cpp-amp-application.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-debugging-a-cpp-amp-application", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/walkthrough-matrix-multiplication.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/walkthrough-matrix-multiplication", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/accelerator-view-removed-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/accelerator-view-removed-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/adopt-d3d-access-lock-t-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/adopt-d3d-access-lock-t-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/array-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/array-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/completion-future-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/completion-future-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-fast-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-fast-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-direct3d-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-enums.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-enums", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-graphics-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-graphics-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-constants-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-constants-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-enums-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-enums-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-functions-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-functions-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-namespace-operators-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-namespace-operators-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace-functions", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/concurrency-precise-math-namespace.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/concurrency-precise-math-namespace", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/double-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/double-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/float-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/float-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/int-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/int-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/invalid-compute-domain-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/invalid-compute-domain-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/norm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/norm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/out-of-memory-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/out-of-memory-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/reference-cpp-amp.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/reference-cpp-amp", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/runtime-exception-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/runtime-exception-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/sampler-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/sampler-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/scoped-d3d-access-lock-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/scoped-d3d-access-lock-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/short-vector-traits-structure.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/short-vector-traits-structure", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tile-barrier-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tile-barrier-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-extent-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-extent-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/tiled-index-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/tiled-index-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uint-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uint-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/uninitialized-object-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/uninitialized-object-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-2-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-2-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-3-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-3-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-4-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-4-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unorm-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unorm-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/unsupported-feature-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/unsupported-feature-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, + { + "source_path": "docs/parallel/amp/reference/writeonly-texture-view-class.md", + "redirect_url": "/previous-versions/cpp/parallel/amp/reference/writeonly-texture-view-class", + "redirect_document_id": false, + "monikers": [ + "msvc-160" + ] + }, { "source_path": "docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md", "redirect_url": "/previous-versions/cpp/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism", diff --git a/docs/docfx.json b/docs/docfx.json index 89cb19b620f..4be629bb780 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -348,7 +348,8 @@ "msvc-170", "msvc-180", "msvc-140", - "msvc-150" + "msvc-150", + "msvc-160" ] } }, From ab5ef342b41a83b70f6566e38ad6f8569c51e005 Mon Sep 17 00:00:00 2001 From: Saisang Cai Date: Tue, 31 Mar 2026 04:51:13 +0000 Subject: [PATCH 1726/1799] Delete amp files --- docs/docfx.json | 9 - ...amp-cpp-accelerated-massive-parallelism.md | 38 - docs/parallel/amp/cpp-amp-overview.md | 505 ---- docs/parallel/amp/graphics-cpp-amp.md | 428 --- docs/parallel/amp/media/campc.PNG | Bin 15562 -> 0 bytes .../parallel/amp/media/campcpubreakpoints.png | Bin 6863 -> 0 bytes docs/parallel/amp/media/campd.png | Bin 13479 -> 0 bytes docs/parallel/amp/media/campe.png | Bin 24824 -> 0 bytes docs/parallel/amp/media/campf.PNG | Bin 21953 -> 0 bytes docs/parallel/amp/media/campg.PNG | Bin 18959 -> 0 bytes .../parallel/amp/media/campgpubreakpoints.png | Bin 4115 -> 0 bytes docs/parallel/amp/media/camph.png | Bin 3709 -> 0 bytes docs/parallel/amp/media/campk.PNG | Bin 21833 -> 0 bytes docs/parallel/amp/media/campl.PNG | Bin 35513 -> 0 bytes .../amp/media/campmatrixanontiled.PNG | Bin 919 -> 0 bytes .../amp/media/campmatrixapartitioned.PNG | Bin 1704 -> 0 bytes docs/parallel/amp/media/campmatrixatiled.PNG | Bin 1064 -> 0 bytes .../amp/media/campmatrixbnontiled.PNG | Bin 1002 -> 0 bytes .../amp/media/campmatrixbpartitioned.PNG | Bin 1715 -> 0 bytes docs/parallel/amp/media/campmatrixbtiled.PNG | Bin 1070 -> 0 bytes .../amp/media/campmatrixproductnontiled.PNG | Bin 2971 -> 0 bytes .../media/campmatrixproductpartitioned.PNG | Bin 1405 -> 0 bytes .../amp/media/campmatrixproducttiled.PNG | Bin 1622 -> 0 bytes .../amp/media/camptiledgridexample.png | Bin 6789 -> 0 bytes docs/parallel/amp/media/usingtilesmatrix.PNG | Bin 8260 -> 0 bytes .../amp/reference/accelerator-class.md | 524 ---- .../amp/reference/accelerator-view-class.md | 327 -- .../accelerator-view-removed-class.md | 86 - .../adopt-d3d-access-lock-t-structure.md | 32 - docs/parallel/amp/reference/array-class.md | 816 ----- .../amp/reference/array-view-class.md | 773 ----- .../amp/reference/completion-future-class.md | 277 -- ...rrency-direct3d-namespace-functions-amp.md | 583 ---- .../concurrency-direct3d-namespace.md | 71 - ...ncurrency-fast-math-namespace-functions.md | 1211 -------- .../concurrency-fast-math-namespace.md | 98 - ...y-graphics-direct3d-namespace-functions.md | 162 - ...concurrency-graphics-direct3d-namespace.md | 37 - .../concurrency-graphics-namespace-enums.md | 37 - ...oncurrency-graphics-namespace-functions.md | 293 -- .../concurrency-graphics-namespace.md | 83 - .../concurrency-namespace-constants-amp.md | 29 - .../concurrency-namespace-cpp-amp.md | 109 - .../concurrency-namespace-enums-amp.md | 44 - .../concurrency-namespace-functions-amp.md | 655 ---- .../concurrency-namespace-operators-amp.md | 271 -- ...rrency-precise-math-namespace-functions.md | 2622 ----------------- .../concurrency-precise-math-namespace.md | 166 -- docs/parallel/amp/reference/double-2-class.md | 155 - docs/parallel/amp/reference/double-3-class.md | 205 -- docs/parallel/amp/reference/double-4-class.md | 407 --- docs/parallel/amp/reference/extent-class.md | 386 --- docs/parallel/amp/reference/float-2-class.md | 155 - docs/parallel/amp/reference/float-3-class.md | 206 -- docs/parallel/amp/reference/float-4-class.md | 407 --- docs/parallel/amp/reference/index-class.md | 311 -- docs/parallel/amp/reference/int-2-class.md | 162 - docs/parallel/amp/reference/int-3-class.md | 207 -- docs/parallel/amp/reference/int-4-class.md | 414 --- .../reference/invalid-compute-domain-class.md | 65 - docs/parallel/amp/reference/norm-2-class.md | 169 -- docs/parallel/amp/reference/norm-3-class.md | 212 -- docs/parallel/amp/reference/norm-4-class.md | 425 --- docs/parallel/amp/reference/norm-class.md | 94 - .../amp/reference/out-of-memory-class.md | 65 - .../amp/reference/reference-cpp-amp.md | 36 - .../amp/reference/runtime-exception-class.md | 129 - docs/parallel/amp/reference/sampler-class.md | 197 -- .../reference/scoped-d3d-access-lock-class.md | 108 - .../amp/reference/short-vector-structure.md | 108 - .../short-vector-traits-structure.md | 117 - docs/parallel/amp/reference/texture-class.md | 579 ---- .../amp/reference/texture-view-class.md | 479 --- .../amp/reference/tile-barrier-class.md | 103 - .../amp/reference/tiled-extent-class.md | 218 -- .../amp/reference/tiled-index-class.md | 253 -- docs/parallel/amp/reference/uint-2-class.md | 161 - docs/parallel/amp/reference/uint-3-class.md | 211 -- docs/parallel/amp/reference/uint-4-class.md | 402 --- .../reference/uninitialized-object-class.md | 65 - docs/parallel/amp/reference/unorm-2-class.md | 163 - docs/parallel/amp/reference/unorm-3-class.md | 214 -- docs/parallel/amp/reference/unorm-4-class.md | 418 --- docs/parallel/amp/reference/unorm-class.md | 93 - .../reference/unsupported-feature-class.md | 65 - .../reference/writeonly-texture-view-class.md | 161 - ...ccelerator-and-accelerator-view-objects.md | 184 -- .../using-cpp-amp-in-windows-store-apps.md | 118 - ...nction-objects-and-restricted-functions.md | 159 - docs/parallel/amp/using-tiles.md | 334 --- ...through-debugging-a-cpp-amp-application.md | 405 --- .../amp/walkthrough-matrix-multiplication.md | 322 -- 92 files changed, 20133 deletions(-) delete mode 100644 docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md delete mode 100644 docs/parallel/amp/cpp-amp-overview.md delete mode 100644 docs/parallel/amp/graphics-cpp-amp.md delete mode 100644 docs/parallel/amp/media/campc.PNG delete mode 100644 docs/parallel/amp/media/campcpubreakpoints.png delete mode 100644 docs/parallel/amp/media/campd.png delete mode 100644 docs/parallel/amp/media/campe.png delete mode 100644 docs/parallel/amp/media/campf.PNG delete mode 100644 docs/parallel/amp/media/campg.PNG delete mode 100644 docs/parallel/amp/media/campgpubreakpoints.png delete mode 100644 docs/parallel/amp/media/camph.png delete mode 100644 docs/parallel/amp/media/campk.PNG delete mode 100644 docs/parallel/amp/media/campl.PNG delete mode 100644 docs/parallel/amp/media/campmatrixanontiled.PNG delete mode 100644 docs/parallel/amp/media/campmatrixapartitioned.PNG delete mode 100644 docs/parallel/amp/media/campmatrixatiled.PNG delete mode 100644 docs/parallel/amp/media/campmatrixbnontiled.PNG delete mode 100644 docs/parallel/amp/media/campmatrixbpartitioned.PNG delete mode 100644 docs/parallel/amp/media/campmatrixbtiled.PNG delete mode 100644 docs/parallel/amp/media/campmatrixproductnontiled.PNG delete mode 100644 docs/parallel/amp/media/campmatrixproductpartitioned.PNG delete mode 100644 docs/parallel/amp/media/campmatrixproducttiled.PNG delete mode 100644 docs/parallel/amp/media/camptiledgridexample.png delete mode 100644 docs/parallel/amp/media/usingtilesmatrix.PNG delete mode 100644 docs/parallel/amp/reference/accelerator-class.md delete mode 100644 docs/parallel/amp/reference/accelerator-view-class.md delete mode 100644 docs/parallel/amp/reference/accelerator-view-removed-class.md delete mode 100644 docs/parallel/amp/reference/adopt-d3d-access-lock-t-structure.md delete mode 100644 docs/parallel/amp/reference/array-class.md delete mode 100644 docs/parallel/amp/reference/array-view-class.md delete mode 100644 docs/parallel/amp/reference/completion-future-class.md delete mode 100644 docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md delete mode 100644 docs/parallel/amp/reference/concurrency-direct3d-namespace.md delete mode 100644 docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md delete mode 100644 docs/parallel/amp/reference/concurrency-fast-math-namespace.md delete mode 100644 docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md delete mode 100644 docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md delete mode 100644 docs/parallel/amp/reference/concurrency-graphics-namespace-enums.md delete mode 100644 docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md delete mode 100644 docs/parallel/amp/reference/concurrency-graphics-namespace.md delete mode 100644 docs/parallel/amp/reference/concurrency-namespace-constants-amp.md delete mode 100644 docs/parallel/amp/reference/concurrency-namespace-cpp-amp.md delete mode 100644 docs/parallel/amp/reference/concurrency-namespace-enums-amp.md delete mode 100644 docs/parallel/amp/reference/concurrency-namespace-functions-amp.md delete mode 100644 docs/parallel/amp/reference/concurrency-namespace-operators-amp.md delete mode 100644 docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md delete mode 100644 docs/parallel/amp/reference/concurrency-precise-math-namespace.md delete mode 100644 docs/parallel/amp/reference/double-2-class.md delete mode 100644 docs/parallel/amp/reference/double-3-class.md delete mode 100644 docs/parallel/amp/reference/double-4-class.md delete mode 100644 docs/parallel/amp/reference/extent-class.md delete mode 100644 docs/parallel/amp/reference/float-2-class.md delete mode 100644 docs/parallel/amp/reference/float-3-class.md delete mode 100644 docs/parallel/amp/reference/float-4-class.md delete mode 100644 docs/parallel/amp/reference/index-class.md delete mode 100644 docs/parallel/amp/reference/int-2-class.md delete mode 100644 docs/parallel/amp/reference/int-3-class.md delete mode 100644 docs/parallel/amp/reference/int-4-class.md delete mode 100644 docs/parallel/amp/reference/invalid-compute-domain-class.md delete mode 100644 docs/parallel/amp/reference/norm-2-class.md delete mode 100644 docs/parallel/amp/reference/norm-3-class.md delete mode 100644 docs/parallel/amp/reference/norm-4-class.md delete mode 100644 docs/parallel/amp/reference/norm-class.md delete mode 100644 docs/parallel/amp/reference/out-of-memory-class.md delete mode 100644 docs/parallel/amp/reference/reference-cpp-amp.md delete mode 100644 docs/parallel/amp/reference/runtime-exception-class.md delete mode 100644 docs/parallel/amp/reference/sampler-class.md delete mode 100644 docs/parallel/amp/reference/scoped-d3d-access-lock-class.md delete mode 100644 docs/parallel/amp/reference/short-vector-structure.md delete mode 100644 docs/parallel/amp/reference/short-vector-traits-structure.md delete mode 100644 docs/parallel/amp/reference/texture-class.md delete mode 100644 docs/parallel/amp/reference/texture-view-class.md delete mode 100644 docs/parallel/amp/reference/tile-barrier-class.md delete mode 100644 docs/parallel/amp/reference/tiled-extent-class.md delete mode 100644 docs/parallel/amp/reference/tiled-index-class.md delete mode 100644 docs/parallel/amp/reference/uint-2-class.md delete mode 100644 docs/parallel/amp/reference/uint-3-class.md delete mode 100644 docs/parallel/amp/reference/uint-4-class.md delete mode 100644 docs/parallel/amp/reference/uninitialized-object-class.md delete mode 100644 docs/parallel/amp/reference/unorm-2-class.md delete mode 100644 docs/parallel/amp/reference/unorm-3-class.md delete mode 100644 docs/parallel/amp/reference/unorm-4-class.md delete mode 100644 docs/parallel/amp/reference/unorm-class.md delete mode 100644 docs/parallel/amp/reference/unsupported-feature-class.md delete mode 100644 docs/parallel/amp/reference/writeonly-texture-view-class.md delete mode 100644 docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md delete mode 100644 docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md delete mode 100644 docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md delete mode 100644 docs/parallel/amp/using-tiles.md delete mode 100644 docs/parallel/amp/walkthrough-debugging-a-cpp-amp-application.md delete mode 100644 docs/parallel/amp/walkthrough-matrix-multiplication.md diff --git a/docs/docfx.json b/docs/docfx.json index 4be629bb780..e450d439f85 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -342,15 +342,6 @@ "text/**.yml": "twhitney", "windows/**.md": "twhitney", "windows/**.yml": "twhitney" - }, - "exclude_monikers": { - "parallel/amp/**/*.{md,yml,yaml}": [ - "msvc-170", - "msvc-180", - "msvc-140", - "msvc-150", - "msvc-160" - ] } }, "template": [], diff --git a/docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md b/docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md deleted file mode 100644 index d4b2d50056a..00000000000 --- a/docs/parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -description: "Learn more about: C++ AMP (C++ Accelerated Massive Parallelism)" -title: "C++ AMP (C++ Accelerated Massive Parallelism)" -ms.date: "11/04/2016" -helpviewer_keywords: ["C++ AMP (see C++ Accelerated Massive Parallelism)", "C++ Accelerated Massive Parallelism, getting started"] ---- -# C++ AMP (C++ Accelerated Massive Parallelism) - -C++ AMP (C++ Accelerated Massive Parallelism) accelerates the execution of your C++ code by taking advantage of the data-parallel hardware that's commonly present as a graphics processing unit (GPU) on a discrete graphics card. The C++ AMP programming model includes support for multidimensional arrays, indexing, memory transfer, and tiling. It also includes a mathematical function library. You can use C++ AMP language extensions to control how data is moved from the CPU to the GPU and back. - -> [!NOTE] -> C++ AMP headers are deprecated starting with Visual Studio 2022 version 17.0. -> Including any AMP headers will generate build errors. Define `_SILENCE_AMP_DEPRECATION_WARNINGS` before including any AMP headers to silence the warnings. - -## Related Topics - -|Title|Description| -|-----------|-----------------| -|[C++ AMP Overview](../../parallel/amp/cpp-amp-overview.md)|Describes the key features of C++ AMP and the mathematical library.| -|[Using Lambdas, Function Objects, and Restricted Functions](../../parallel/amp/using-lambdas-function-objects-and-restricted-functions.md)|Describes how to use lambda expressions, function objects, and restricted functions in calls to the [parallel_for_each](reference/concurrency-namespace-functions-amp.md#parallel_for_each) method.| -|[Using Tiles](../../parallel/amp/using-tiles.md)|Describes how to use tiles to accelerate your C++ AMP code.| -|[Using accelerator and accelerator_view Objects](../../parallel/amp/using-accelerator-and-accelerator-view-objects.md)|Describes how to use accelerators to customize execution of your code on the GPU.| -|[Using C++ AMP in UWP Apps](../../parallel/amp/using-cpp-amp-in-windows-store-apps.md)|Describes how to use C++ AMP in Universal Windows Platform (UWP) apps that use Windows Runtime types.| -|[Graphics (C++ AMP)](../../parallel/amp/graphics-cpp-amp.md)|Describes how to use the C++ AMP graphics library.| -|[Walkthrough: Matrix Multiplication](../../parallel/amp/walkthrough-matrix-multiplication.md)|Demonstrates matrix multiplication using C++ AMP code and tiling.| -|[Walkthrough: Debugging a C++ AMP Application](../../parallel/amp/walkthrough-debugging-a-cpp-amp-application.md)|Explains how to create and debug an application that uses parallel reduction to sum up a large array of integers.| - -## Reference - -[Reference (C++ AMP)](../../parallel/amp/reference/reference-cpp-amp.md)
-[tile_static Keyword](../../cpp/tile-static-keyword.md)
-[restrict (C++ AMP)](../../cpp/restrict-cpp-amp.md) - -## Other Resources - -[Parallel Programming in Native Code Blog](/archive/blogs/nativeconcurrency/)
-[C++ AMP sample projects for download](/archive/blogs/nativeconcurrency/c-amp-sample-projects-for-download)
-[Analyzing C++ AMP Code with the Concurrency Visualizer](/archive/blogs/nativeconcurrency/analyzing-c-amp-code-with-the-concurrency-visualizer) diff --git a/docs/parallel/amp/cpp-amp-overview.md b/docs/parallel/amp/cpp-amp-overview.md deleted file mode 100644 index 71492d2b0f3..00000000000 --- a/docs/parallel/amp/cpp-amp-overview.md +++ /dev/null @@ -1,505 +0,0 @@ ---- -title: "C++ AMP Overview" -description: "Learn more about: C++ AMP Overview" -ms.date: 11/19/2018 -ms.topic: concept-article -helpviewer_keywords: ["C++ Accelerated Massive Parallelism, requirements", "C++ Accelerated Massive Parallelism, architecture", "C++ AMP", "C++ Accelerated Massive Parallelism, overview", "C++ Accelerated Massive Parallelism"] ---- -# C++ AMP Overview - -> [!NOTE] -> C++ AMP headers are deprecated starting with Visual Studio 2022 version 17.0. -> Including any AMP headers will generate build errors. Define `_SILENCE_AMP_DEPRECATION_WARNINGS` before including any AMP headers to silence the warnings. - -C++ Accelerated Massive Parallelism (C++ AMP) accelerates execution of C++ code by taking advantage of data-parallel hardware such as a graphics processing unit (GPU) on a discrete graphics card. By using C++ AMP, you can code multi-dimensional data algorithms so that execution can be accelerated by using parallelism on heterogeneous hardware. The C++ AMP programming model includes multidimensional arrays, indexing, memory transfer, tiling, and a mathematical function library. You can use C++ AMP language extensions to control how data is moved from the CPU to the GPU and back, so that you can improve performance. - -## System Requirements - -- Windows 7 or later - -- Windows Server 2008 R2 through Visual Studio 2019. - -- DirectX 11 Feature Level 11.0 or later hardware - -- For debugging on the software emulator, Windows 8 or Windows Server 2012 is required. For debugging on the hardware, you must install the drivers for your graphics card. For more information, see [Debugging GPU Code](/visualstudio/debugger/debugging-gpu-code). - -- Note: AMP is currently not supported on ARM64. - -## Introduction - -The following two examples illustrate the primary components of C++ AMP. Assume that you want to add the corresponding elements of two one-dimensional arrays. For example, you might want to add `{1, 2, 3, 4, 5}` and `{6, 7, 8, 9, 10}` to obtain `{7, 9, 11, 13, 15}`. Without using C++ AMP, you might write the following code to add the numbers and display the results. - -```cpp -#include - -void StandardMethod() { - - int aCPP[] = {1, 2, 3, 4, 5}; - int bCPP[] = {6, 7, 8, 9, 10}; - int sumCPP[5]; - - for (int idx = 0; idx < 5; idx++) - { - sumCPP[idx] = aCPP[idx] + bCPP[idx]; - } - - for (int idx = 0; idx < 5; idx++) - { - std::cout << sumCPP[idx] << "\n"; - } -} -``` - -The important parts of the code are as follows: - -- Data: The data consists of three arrays. All have the same rank (one) and length (five). - -- Iteration: The first **`for`** loop provides a mechanism for iterating through the elements in the arrays. The code that you want to execute to compute the sums is contained in the first **`for`** block. - -- Index: The `idx` variable accesses the individual elements of the arrays. - -Using C++ AMP, you might write the following code instead. - -```cpp -#include -#include -using namespace concurrency; - -const int size = 5; - -void CppAmpMethod() { - int aCPP[] = {1, 2, 3, 4, 5}; - int bCPP[] = {6, 7, 8, 9, 10}; - int sumCPP[size]; - - // Create C++ AMP objects. - array_view a(size, aCPP); - array_view b(size, bCPP); - array_view sum(size, sumCPP); - sum.discard_data(); - - parallel_for_each( - // Define the compute domain, which is the set of threads that are created. - sum.extent, - // Define the code to run on each thread on the accelerator. - [=](index<1> idx) restrict(amp) { - sum[idx] = a[idx] + b[idx]; - } - ); - - // Print the results. The expected output is "7, 9, 11, 13, 15". - for (int i = 0; i < size; i++) { - std::cout << sum[i] << "\n"; - } -} -``` - -The same basic elements are present, but C++ AMP constructs are used: - -- Data: You use C++ arrays to construct three C++ AMP [array_view](../../parallel/amp/reference/array-view-class.md) objects. You supply four values to construct an `array_view` object: the data values, the rank, the element type, and the length of the `array_view` object in each dimension. The rank and type are passed as type parameters. The data and length are passed as constructor parameters. In this example, the C++ array that is passed to the constructor is one-dimensional. The rank and length are used to construct the rectangular shape of the data in the `array_view` object, and the data values are used to fill the array. The runtime library also includes the [array Class](../../parallel/amp/reference/array-class.md), which has an interface that resembles the `array_view` class and is discussed later in this article. - -- Iteration: The [parallel_for_each Function (C++ AMP)](reference/concurrency-namespace-functions-amp.md#parallel_for_each) provides a mechanism for iterating through the data elements, or *compute domain*. In this example, the compute domain is specified by `sum.extent`. The code that you want to execute is contained in a lambda expression, or *kernel function*. The `restrict(amp)` indicates that only the subset of the C++ language that C++ AMP can accelerate is used. - -- Index: The [index Class](../../parallel/amp/reference/index-class.md) variable, `idx`, is declared with a rank of one to match the rank of the `array_view` object. By using the index, you can access the individual elements of the `array_view` objects. - -## Shaping and Indexing Data: index and extent - -You must define the data values and declare the shape of the data before you can run the kernel code. All data is defined to be an array (rectangular), and you can define the array to have any rank (number of dimensions). The data can be any size in any of the dimensions. - -### index Class - -The [index Class](../../parallel/amp/reference/index-class.md) specifies a location in the `array` or `array_view` object by encapsulating the offset from the origin in each dimension into one object. When you access a location in the array, you pass an `index` object to the indexing operator, `[]`, instead of a list of integer indexes. You can access the elements in each dimension by using the [array::operator() Operator](reference/array-class.md#operator_call) or the [array_view::operator() Operator](reference/array-view-class.md#operator_call). - -The following example creates a one-dimensional index that specifies the third element in a one-dimensional `array_view` object. The index is used to print the third element in the `array_view` object. The output is 3. - -```cpp -int aCPP[] = {1, 2, 3, 4, 5}; -array_view a(5, aCPP); - -index<1> idx(2); - -std::cout << a[idx] << "\n"; -// Output: 3 -``` - -The following example creates a two-dimensional index that specifies the element where the row = 1 and the column = 2 in a two-dimensional `array_view` object. The first parameter in the `index` constructor is the row component, and the second parameter is the column component. The output is 6. - -```cpp -int aCPP[] = {1, 2, 3, 4, 5, 6}; -array_view a(2, 3, aCPP); - -index<2> idx(1, 2); - -std::cout < a(2, 3, 4, aCPP); - -// Specifies the element at 3, 1, 0. -index<3> idx(0, 1, 3); - -std::cout << a[idx] << "\n"; -// Output: 8 -``` - -### extent Class - -The [extent Class](../../parallel/amp/reference/extent-class.md) specifies the length of the data in each dimension of the `array` or `array_view` object. You can create an extent and use it to create an `array` or `array_view` object. You can also retrieve the extent of an existing `array` or `array_view` object. The following example prints the length of the extent in each dimension of an `array_view` object. - -```cpp -int aCPP[] = { - 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, - 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12}; -// There are 3 rows and 4 columns, and the depth is two. -array_view a(2, 3, 4, aCPP); - -std::cout << "The number of columns is " << a.extent[2] << "\n"; -std::cout << "The number of rows is " << a.extent[1] << "\n"; -std::cout << "The depth is " << a.extent[0] << "\n"; -std::cout << "Length in most significant dimension is " << a.extent[0] << "\n"; -``` - -The following example creates an `array_view` object that has the same dimensions as the object in the previous example, but this example uses an `extent` object instead of using explicit parameters in the `array_view` constructor. - -```cpp -int aCPP[] = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24}; -extent<3> e(2, 3, 4); - -array_view a(e, aCPP); - -std::cout << "The number of columns is " << a.extent[2] << "\n"; -std::cout << "The number of rows is " << a.extent[1] << "\n"; -std::cout << "The depth is " << a.extent[0] << "\n"; -``` - -## Moving Data to the Accelerator: array and array_view - -Two data containers used to move data to the accelerator are defined in the runtime library. They are the [array Class](../../parallel/amp/reference/array-class.md) and the [array_view Class](../../parallel/amp/reference/array-view-class.md). The `array` class is a container class that creates a deep copy of the data when the object is constructed. The `array_view` class is a wrapper class that copies the data when the kernel function accesses the data. When the data is needed on the source device the data is copied back. - -### array Class - -When an `array` object is constructed, a deep copy of the data is created on the accelerator if you use a constructor that includes a pointer to the data set. The kernel function modifies the copy on the accelerator. When the execution of the kernel function is finished, you must copy the data back to the source data structure. The following example multiplies each element in a vector by 10. After the kernel function is finished, the `vector conversion operator` is used to copy the data back into the vector object. - -```cpp -std::vector data(5); - -for (int count = 0; count <5; count++) -{ - data[count] = count; -} - -array a(5, data.begin(), data.end()); - -parallel_for_each( - a.extent, - [=, &a](index<1> idx) restrict(amp) { - a[idx] = a[idx]* 10; - }); - -data = a; -for (int i = 0; i < 5; i++) -{ - std::cout << data[i] << "\n"; -} -``` - -### array_view Class - -The `array_view` has nearly the same members as the `array` class, but the underlying behavior is not the same. Data passed to the `array_view` constructor is not replicated on the GPU as it is with an `array` constructor. Instead, the data is copied to the accelerator when the kernel function is executed. Therefore, if you create two `array_view` objects that use the same data, both `array_view` objects refer to the same memory space. When you do this, you have to synchronize any multithreaded access. The main advantage of using the `array_view` class is that data is moved only if it is necessary. - -### Comparison of array and array_view - -The following table summarizes the similarities and differences between the `array` and `array_view` classes. - -|Description|array class|array_view class| -|-----------------|-----------------|-----------------------| -|When rank is determined|At compile time.|At compile time.| -|When extent is determined|At run time.|At run time.| -|Shape|Rectangular.|Rectangular.| -|Data storage|Is a data container.|Is a data wrapper.| -|Copy|Explicit and deep copy at definition.|Implicit copy when it is accessed by the kernel function.| -|Data retrieval|By copying the array data back to an object on the CPU thread.|By direct access of the `array_view` object or by calling the [array_view::synchronize Method](reference/array-view-class.md#synchronize) to continue accessing the data on the original container.| - -### Shared memory with array and array_view - -Shared memory is memory that can be accessed by both the CPU and the accelerator. The use of shared memory eliminates or significantly reduces the overhead of copying data between the CPU and the accelerator. Although the memory is shared, it cannot be accessed concurrently by both the CPU and the accelerator, and doing so causes undefined behavior. - -`array` objects can be used to specify fine-grained control over the use of shared memory if the associated accelerator supports it. Whether an accelerator supports shared memory is determined by the accelerator's [supports_cpu_shared_memory](reference/accelerator-class.md#supports_cpu_shared_memory) property, which returns **`true`** when shared memory is supported. If shared memory is supported, the default [access_type Enumeration](reference/concurrency-namespace-enums-amp.md#access_type) for memory allocations on the accelerator is determined by the `default_cpu_access_type` property. By default, `array` and `array_view` objects take on the same `access_type` as the primary associated `accelerator`. - -By setting the [array::cpu_access_type Data Member](reference/array-class.md#cpu_access_type) property of an `array` explicitly, you can exercise fine-grained control over how shared memory is used, so that you can optimize the app for the hardware's performance characteristics, based on the memory access patterns of its computation kernels. An `array_view` reflects the same `cpu_access_type` as the `array` that it's associated with; or, if the array_view is constructed without a data source, its `access_type` reflects the environment that first causes it to allocate storage. That is, if it's first accessed by the host (CPU), then it behaves as if it were created over a CPU data source and shares the `access_type` of the `accelerator_view` associated by capture; however, if it's first accessed by an `accelerator_view`, then it behaves as if it were created over an `array` created on that `accelerator_view` and shares the `array`'s `access_type`. - -The following code example shows how to determine whether the default accelerator supports shared memory, and then creates several arrays that have different cpu_access_type configurations. - -```cpp -#include -#include - -using namespace Concurrency; - -int main() -{ - accelerator acc = accelerator(accelerator::default_accelerator); - - // Early out if the default accelerator doesn't support shared memory. - if (!acc.supports_cpu_shared_memory) - { - std::cout << "The default accelerator does not support shared memory" << std::endl; - return 1; - } - - // Override the default CPU access type. - acc.default_cpu_access_type = access_type_read_write - - // Create an accelerator_view from the default accelerator. The - // accelerator_view inherits its default_cpu_access_type from acc. - accelerator_view acc_v = acc.default_view; - - // Create an extent object to size the arrays. - extent<1> ex(10); - - // Input array that can be written on the CPU. - array arr_w(ex, acc_v, access_type_write); - - // Output array that can be read on the CPU. - array arr_r(ex, acc_v, access_type_read); - - // Read-write array that can be both written to and read from on the CPU. - array arr_rw(ex, acc_v, access_type_read_write); -} -``` - -## Executing Code over Data: parallel_for_each - -The [parallel_for_each](reference/concurrency-namespace-functions-amp.md#parallel_for_each) function defines the code that you want to run on the accelerator against the data in the `array` or `array_view` object. Consider the following code from the introduction of this topic. - -```cpp -#include -#include -using namespace concurrency; - -void AddArrays() { - int aCPP[] = {1, 2, 3, 4, 5}; - int bCPP[] = {6, 7, 8, 9, 10}; - int sumCPP[5] = {0, 0, 0, 0, 0}; - - array_view a(5, aCPP); - array_view b(5, bCPP); - array_view sum(5, sumCPP); - - parallel_for_each( - sum.extent, - [=](index<1> idx) restrict(amp) - { - sum[idx] = a[idx] + b[idx]; - } - ); - - for (int i = 0; i < 5; i++) { - std::cout << sum[i] << "\n"; - } -} -``` - -The `parallel_for_each` method takes two arguments, a compute domain and a lambda expression. - -The *compute domain* is an `extent` object or a `tiled_extent` object that defines the set of threads to create for parallel execution. One thread is generated for each element in the compute domain. In this case, the `extent` object is one-dimensional and has five elements. Therefore, five threads are started. - -The *lambda expression* defines the code to run on each thread. The capture clause, `[=]`, specifies that the body of the lambda expression accesses all captured variables by value, which in this case are `a`, `b`, and `sum`. In this example, the parameter list creates a one-dimensional `index` variable named `idx`. The value of the `idx[0]` is 0 in the first thread and increases by one in each subsequent thread. The `restrict(amp)` indicates that only the subset of the C++ language that C++ AMP can accelerate is used. The limitations on functions that have the restrict modifier are described in [restrict (C++ AMP)](../../cpp/restrict-cpp-amp.md). For more information, see, [Lambda Expression Syntax](../../cpp/lambda-expression-syntax.md). - -The lambda expression can include the code to execute or it can call a separate kernel function. The kernel function must include the `restrict(amp)` modifier. The following example is equivalent to the previous example, but it calls a separate kernel function. - -```cpp -#include -#include -using namespace concurrency; - -void AddElements( - index<1> idx, - array_view sum, - array_view a, - array_view b) restrict(amp) { - sum[idx] = a[idx] + b[idx]; -} - -void AddArraysWithFunction() { - - int aCPP[] = {1, 2, 3, 4, 5}; - int bCPP[] = {6, 7, 8, 9, 10}; - int sumCPP[5] = {0, 0, 0, 0, 0}; - - array_view a(5, aCPP); - array_view b(5, bCPP); - array_view sum(5, sumCPP); - - parallel_for_each( - sum.extent, - [=](index<1> idx) restrict(amp) { - AddElements(idx, sum, a, b); - } - ); - - for (int i = 0; i < 5; i++) { - std::cout << sum[i] << "\n"; - } -} -``` - -## Accelerating Code: Tiles and Barriers - -You can gain additional acceleration by using tiling. Tiling divides the threads into equal rectangular subsets or *tiles*. You determine the appropriate tile size based on your data set and the algorithm that you are coding. For each thread, you have access to the *global* location of a data element relative to the whole `array` or `array_view` and access to the *local* location relative to the tile. Using the local index value simplifies your code because you don't have to write the code to translate index values from global to local. To use tiling, call the [extent::tile Method](reference/extent-class.md#tile) on the compute domain in the `parallel_for_each` method, and use a [tiled_index](../../parallel/amp/reference/tiled-index-class.md) object in the lambda expression. - -In typical applications, the elements in a tile are related in some way, and the code has to access and keep track of values across the tile. Use the [tile_static Keyword](../../cpp/tile-static-keyword.md) keyword and the [tile_barrier::wait Method](reference/tile-barrier-class.md#wait) to accomplish this. A variable that has the **tile_static** keyword has a scope across an entire tile, and an instance of the variable is created for each tile. You must handle synchronization of tile-thread access to the variable. The [tile_barrier::wait Method](reference/tile-barrier-class.md#wait) stops execution of the current thread until all the threads in the tile have reached the call to `tile_barrier::wait`. So you can accumulate values across the tile by using **tile_static** variables. Then you can finish any computations that require access to all the values. - -The following diagram represents a two-dimensional array of sampling data that is arranged in tiles. - -![Index values in a tiled extent.](../../parallel/amp/media/camptiledgridexample.png "Index values in a tiled extent") - -The following code example uses the sampling data from the previous diagram. The code replaces each value in the tile by the average of the values in the tile. - -```cpp -// Sample data: -int sampledata[] = { - 2, 2, 9, 7, 1, 4, - 4, 4, 8, 8, 3, 4, - 1, 5, 1, 2, 5, 2, - 6, 8, 3, 2, 7, 2}; - -// The tiles: -// 2 2 9 7 1 4 -// 4 4 8 8 3 4 -// -// 1 5 1 2 5 2 -// 6 8 3 2 7 2 - -// Averages: -int averagedata[] = { - 0, 0, 0, 0, 0, 0, - 0, 0, 0, 0, 0, 0, - 0, 0, 0, 0, 0, 0, - 0, 0, 0, 0, 0, 0, -}; - -array_view sample(4, 6, sampledata); - -array_view average(4, 6, averagedata); - -parallel_for_each( - // Create threads for sample.extent and divide the extent into 2 x 2 tiles. - sample.extent.tile<2,2>(), - [=](tiled_index<2,2> idx) restrict(amp) { - // Create a 2 x 2 array to hold the values in this tile. - tile_static int nums[2][2]; - - // Copy the values for the tile into the 2 x 2 array. - nums[idx.local[1]][idx.local[0]] = sample[idx.global]; - - // When all the threads have executed and the 2 x 2 array is complete, find the average. - idx.barrier.wait(); - int sum = nums[0][0] + nums[0][1] + nums[1][0] + nums[1][1]; - - // Copy the average into the array_view. - average[idx.global] = sum / 4; - }); - -for (int i = 0; i <4; i++) { - for (int j = 0; j <6; j++) { - std::cout << average(i,j) << " "; - } - std::cout << "\n"; -} - -// Output: -// 3 3 8 8 3 3 -// 3 3 8 8 3 3 -// 5 5 2 2 4 4 -// 5 5 2 2 4 4 -``` - -## Math Libraries - -C++ AMP includes two math libraries. The double-precision library in the [Concurrency::precise_math Namespace](../../parallel/amp/reference/concurrency-precise-math-namespace.md) provides support for double-precision functions. It also provides support for single-precision functions, although double-precision support on the hardware is still required. It conforms to the [C99 Specification (ISO/IEC 9899)](https://go.microsoft.com/fwlink/p/?linkid=225887). The accelerator must support full double precision. You can determine whether it does by checking the value of the [accelerator::supports_double_precision Data Member](reference/accelerator-class.md#supports_double_precision). The fast math library, in the [Concurrency::fast_math Namespace](../../parallel/amp/reference/concurrency-fast-math-namespace.md), contains another set of math functions. These functions, which support only **`float`** operands, execute more quickly but aren't as precise as those in the double-precision math library. The functions are contained in the \ header file and all are declared with `restrict(amp)`. The functions in the \ header file are imported into both the `fast_math` and `precise_math` namespaces. The **`restrict`** keyword is used to distinguish the \ version and the C++ AMP version. The following code calculates the base-10 logarithm, using the fast method, of each value that is in the compute domain. - -```cpp -#include -#include -#include -using namespace concurrency; - -void MathExample() { - - double numbers[] = { 1.0, 10.0, 60.0, 100.0, 600.0, 1000.0 }; - array_view logs(6, numbers); - - parallel_for_each( - logs.extent, - [=] (index<1> idx) restrict(amp) { - logs[idx] = concurrency::fast_math::log10(numbers[idx]); - } - ); - - for (int i = 0; i < 6; i++) { - std::cout << logs[i] << "\n"; - } -} -``` - -## Graphics Library - -C++ AMP includes a graphics library that is designed for accelerated graphics programming. This library is used only on devices that support native graphics functionality. The methods are in the [Concurrency::graphics Namespace](../../parallel/amp/reference/concurrency-graphics-namespace.md) and are contained in the \ header file. The key components of the graphics library are: - -- [texture Class](../../parallel/amp/reference/texture-class.md): You can use the texture class to create textures from memory or from a file. Textures resemble arrays because they contain data, and they resemble containers in the C++ Standard Library with respect to assignment and copy construction. For more information, see [C++ Standard Library Containers](../../standard-library/stl-containers.md). The template parameters for the `texture` class are the element type and the rank. The rank can be 1, 2, or 3. The element type can be one of the short vector types that are described later in this article. - -- [writeonly_texture_view Class](../../parallel/amp/reference/writeonly-texture-view-class.md): Provides write-only access to any texture. - -- Short Vector Library: Defines a set of short vector types of length 2, 3, and 4 that are based on **`int`**, `uint`, **`float`**, **`double`**, [norm](../../parallel/amp/reference/norm-class.md), or [unorm](../../parallel/amp/reference/unorm-class.md). - -## Universal Windows Platform (UWP) Apps - -Like other C++ libraries, you can use C++ AMP in your UWP apps. These articles describe how to include C++ AMP code in apps that is created by using C++, C#, Visual Basic, or JavaScript: - -- [Using C++ AMP in UWP Apps](../../parallel/amp/using-cpp-amp-in-windows-store-apps.md) - -- [Walkthrough: Creating a basic Windows Runtime component in C++ and calling it from JavaScript](/previous-versions/windows/apps/hh755833(v=vs.140)) - -- [Bing Maps Trip Optimizer, a Window Store app in JavaScript and C++](/previous-versions/windows/apps/hh699893(v=vs.140)) - -- [How to use C++ AMP from C# using the Windows Runtime](https://devblogs.microsoft.com/pfxteam/how-to-use-c-amp-from-c-using-winrt/) - -- [How to use C++ AMP from C#](https://devblogs.microsoft.com/pfxteam/how-to-use-c-amp-from-c/) - -- [Calling Native Functions from Managed Code](../../dotnet/calling-native-functions-from-managed-code.md) - -## C++ AMP and Concurrency Visualizer - -The Concurrency Visualizer includes support for analyzing performance of C++ AMP code. These articles describe these features: - -- [GPU Activity Graph](/visualstudio/profiling/gpu-activity-graph) - -- [GPU Activity (Paging)](/visualstudio/profiling/gpu-activity-paging) - -- [GPU Activity (This Process)](/visualstudio/profiling/gpu-activity-this-process) - -- [GPU Activity (Other Processes)](/visualstudio/profiling/gpu-activity-other-processes) - -- [Channels (Threads View)](/visualstudio/profiling/channels-threads-view) - -- [Analyzing C++ AMP Code with the Concurrency Visualizer](/archive/blogs/nativeconcurrency/analyzing-c-amp-code-with-the-concurrency-visualizer) - -## Performance Recommendations - -Modulus and division of unsigned integers have significantly better performance than modulus and division of signed integers. We recommend that you use unsigned integers when possible. - -## See also - -[C++ AMP (C++ Accelerated Massive Parallelism)](../../parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md)
-[Lambda Expression Syntax](../../cpp/lambda-expression-syntax.md)
-[Reference (C++ AMP)](../../parallel/amp/reference/reference-cpp-amp.md)
-[Parallel Programming in Native Code Blog](/archive/blogs/nativeconcurrency/) diff --git a/docs/parallel/amp/graphics-cpp-amp.md b/docs/parallel/amp/graphics-cpp-amp.md deleted file mode 100644 index 5368ba8b88e..00000000000 --- a/docs/parallel/amp/graphics-cpp-amp.md +++ /dev/null @@ -1,428 +0,0 @@ ---- -title: "Graphics (C++ AMP)" -description: "Learn more about: Graphics (C++ AMP)" -ms.date: 11/04/2016 ---- -# Graphics (C++ AMP) - -C++ AMP contains several APIs in the [`Concurrency::graphics`](../../parallel/amp/reference/concurrency-graphics-namespace.md) namespace that you can use to access the texture support on GPUs. Some common scenarios are: - -- You can use the [`texture`](../../parallel/amp/reference/texture-class.md) class as a data container for computation and exploit the *spatial locality* of the texture cache and layouts of GPU hardware. Spatial locality is the property of data elements being physically close to each other. - -- The runtime provides efficient interoperability with non-compute shaders. Pixel, vertex, tessellation, and hull shaders frequently consume or produce textures that you can use in your C++ AMP computations. - -- The graphics APIs in C++ AMP provide alternative ways to access sub-word packed buffers. Textures that have formats that represent *texels* (texture elements) that are composed of 8-bit or 16-bit scalars allow access to such packed data storage. - -> [!NOTE] -> C++ AMP headers are deprecated starting with Visual Studio 2022 version 17.0. -> Including any AMP headers will generate build errors. Define `_SILENCE_AMP_DEPRECATION_WARNINGS` before including any AMP headers to silence the warnings. - -## The norm and unorm Types - -The `norm` and `unorm` types are scalar types that limit the range of **`float`** values; this is known as *clamping*. These types can be explicitly constructed from other scalar types. In casting, the value is first cast to **`float`** and then clamped to the respective region that's allowed by `norm [-1.0, 1.0]` or `unorm [0.0, 1.0]`. Casting from +/- infinity returns +/-1. Casting from NaN is undefined. A `norm` can be implicitly constructed from a `unorm` and there is no loss of data. The implicit conversion operator to **`float`** is defined on these types. Binary operators are defined between these types and other built-in scalar types such as **`float`** and **`int`**: `+`, `-`, `*`, `/`, `==`, `!=`, `>`, `<`, `>=`, `<=`. The compound assignment operators are also supported: `+=`, `-=`, `*=`, `/=`. The unary negation operator (`-`) is defined for `norm` types. - -## Short Vector Library - -The Short Vector Library provides some of the functionality of the [Vector Type](/windows/win32/direct3dhlsl/dx-graphics-hlsl-vector) that's defined in HLSL and is typically used to define texels. A short vector is a data structure that holds one to four values of the same type. The supported types are **`double`**, **`float`**, **`int`**, `norm`, `uint`, and `unorm`. The type names are shown in the following table. For each type, there is also a corresponding **`typedef`** that doesn't have an underscore in the name. The types that have the underscores are in the [Concurrency::graphics Namespace](../../parallel/amp/reference/concurrency-graphics-namespace.md). The types that don't have the underscores are in the [Concurrency::graphics::direct3d Namespace](../../parallel/amp/reference/concurrency-graphics-direct3d-namespace.md) so that they are clearly separated from the similarly-named fundamental types such as **`__int8`** and **`__int16`**. - -|Type|Length 2|Length 3|Length 4| -|-|--------------|--------------|--------------| -|double|double_2

double2|double_3

double3|double_4

double4| -|float|float_2

float2|float_3

float3|float_4

float4| -|int|int_2

int2|int_3

int3|int_4

int4| -|norm|norm_2

norm2|norm_3

norm3|norm_4

norm4| -|uint|uint_2

uint2|uint_3

uint3|uint_4

uint4| -|unorm|unorm_2

unorm2|unorm_3

unorm3|unorm_4

unorm4| - -### Operators - -If an operator is defined between two short vectors, then it is also defined between a short vector and a scalar. Also, one of these must be true: - -- The scalar's type must be the same as the short vector's element type. - -- The scalar's type can be implicitly converted to the vector's element type by using only one user-defined conversion. - -The operation is carried component-wise between each component of the short vector and the scalar. Here are the valid operators: - -|Operator type|Valid types| -|-------------------|-----------------| -|Binary operators|Valid on all types: `+`, `-`, `*`, `/`,

Valid on integer types: `%`, `^`, `|`, `&`, `<<`, `>>`

The two vectors must have the same size, and the result is a vector of the same size.| -|Relational operators|Valid on all types: `==` and `!=`| -|Compound assignment operator|Valid on all types: `+=`, `-=`, `*=`, `/=`

Valid on integer types: `%=`, `^=`, `|=`, `&=`, `<<=`, `>>=`| -|Increment and decrement operators|Valid on all types: `++`, `--`

Both prefix and postfix are valid.| -|Bitwise NOT operator (`~`)|Valid on integer types.| -|Unary `-` operator|Valid on all types except `unorm` and `uint`.| - -### Swizzling Expressions - -The Short Vector Library supports the `vector_type.identifier` accessor construct to access the components of a short vector. The `identifier`, which is known as a *swizzling expression*, specifies the components of the vector. The expression can be an l-value or an r-value. Individual characters in the identifier may be: x, y, z, and w; or r, g, b, and a. "x" and "r" mean the zero-th component, "y" and "g" mean the first component, and so on. (Notice that "x" and "r" cannot be used in the same identifier.) Therefore, "rgba" and "xyzw" return the same result. Single-component accessors such as "x" and "y" are scalar value types. Multi-component accessors are short vector types. For example, if you construct an `int_4` vector that's named `fourInts` and has the values 2, 4, 6, and 8, then `fourInts.y` returns the integer 4 and `fourInts.rg` returns an `int_2` object that has the values 2 and 4. - -## Texture Classes - -Many GPUs have hardware and caches that are optimized to fetch pixels and texels and to render images and textures. The [`texture`](../../parallel/amp/reference/texture-class.md) class, which is a container class for texel objects, exposes the texture functionality of these GPUs. A texel can be: - -- An **`int`**, `uint`, **`float`**, **`double`**, `norm`, or `unorm` scalar. - -- A short vector that has two or four components. The only exception is `double_4`, which is not allowed. - -The `texture` object can have a rank of 1, 2, or 3. The `texture` object can be captured only by reference in the lambda of a call to `parallel_for_each`. The texture is stored on the GPU as Direct3D texture objects. For more information about textures and texels in Direct3D, see [Introduction to Textures in Direct3D 11](/windows/win32/direct3d11/overviews-direct3d-11-resources-textures-intro). - -The texel type you use might be one of the many texture formats that are used in graphics programming. For example, an RGBA format could use 32 bits, with 8 bits each for the R, G, B, and A scalar elements. The texture hardware of a graphics card can access the individual elements based on the format. For example, if you are using the RGBA format, the texture hardware can extract each 8-bit element into a 32-bit form. In C++ AMP, you can set the bits per scalar element of your texel so that you can automatically access the individual scalar elements in the code without using bit-shifting. - -### Instantiating Texture Objects - -You can declare a texture object without initialization. The following code example declares several texture objects. - -```cpp -#include -#include -using namespace concurrency; -using namespace concurrency::graphics; - -void declareTextures() { - // Create a 16-texel texture of int. - texture intTexture1(16); - texture intTexture2(extent<1>(16)); - - // Create a 16 x 32 texture of float_2. - texture floatTexture1(16, 32); - texture floatTexture2(extent<2>(16, 32)); - - // Create a 2 x 4 x 8 texture of uint_4. - texture uintTexture1(2, 4, 8); - texture uintTexture2(extent<3>(2, 4, 8)); -} -``` - -You can also use a constructor to declare and initialize a `texture` object. The following code example instantiates a `texture` object from a vector of `float_4` objects. The bits per scalar element is set to the default. You cannot use this constructor with `norm`, `unorm`, or the short vectors of `norm` and `unorm`, because they do not have a default bits per scalar element. - -```cpp -#include -#include -#include -using namespace concurrency; -using namespace concurrency::graphics; - -void initializeTexture() { - std::vector texels; - for (int i = 0; i < 768 * 1024; i++) { - int_4 i4(i, i, i, i); - texels.push_back(i4); - } - - texture aTexture(768, 1024, texels.begin(), texels.end()); -} -``` - -You can also declare and initialize a `texture` object by using a constructor overload that takes a pointer to the source data, the size of source data in bytes, and the bits per scalar element. - -```cpp -void createTextureWithBPC() { // Create the source data. - float source[1024* 2]; - for (int i = 0; i <1024* 2; i++) { - source[i] = (float)i; - } - // Initialize the texture by using the size of source in bytes // and bits per scalar element. - texture floatTexture(1024, source, (unsigned int)sizeof(source), 32U); -} -``` - -The textures in these examples are created on the default view of the default accelerator. You can use other overloads of the constructor if you want to specify an `accelerator_view` object. You cannot create a texture object on a CPU accelerator. - -There are limits on the size of each dimension of the `texture` object, as shown in the following table. A run-time error is generated if you exceed the limits. - -|Texture|Size limitation per dimension| -|-------------|---------------------| -|texture\|16384| -|texture\|16384| -|texture\|2048| - -### Reading from Texture Objects - -You can read from a `texture` object by using [texture::operator\[\]](reference/texture-class.md#operator_at), [texture::operator() Operator](reference/texture-class.md#operator_call), or [texture::get Method](reference/texture-class.md#get). The two operators return a value, not a reference. Therefore, you cannot write to a `texture` object by using `texture::operator[]`. - -```cpp -void readTexture() { - std::vector src; - for (int i = 0; i <16 *32; i++) { - int_2 i2(i, i); - - src.push_back(i2); - } - - std::vector dst(16* 32); - - array_view arr(16, 32, dst); - - arr.discard_data(); - - const texture tex9(16, 32, src.begin(), src.end()); - - parallel_for_each(tex9.extent, [=, &tex9] (index<2> idx) restrict(amp) { // Use the subscript operator. - arr[idx].x += tex9[idx].x; // Use the function () operator. - arr[idx].x += tex9(idx).x; // Use the get method. - arr[idx].y += tex9.get(idx).y; // Use the function () operator. - arr[idx].y += tex9(idx[0], idx[1]).y; - }); - - arr.synchronize(); -} -``` - -The following code example demonstrates how to store texture channels in a short vector, and then access the individual scalar elements as properties of the short vector. - -```cpp -void UseBitsPerScalarElement() { // Create the image data. // Each unsigned int (32-bit) represents four 8-bit scalar elements(r,g,b,a values). - const int image_height = 16; - const int image_width = 16; - std::vector image(image_height* image_width); - - extent<2> image_extent(image_height, image_width); - - // By using uint_4 and 8 bits per channel, each 8-bit channel in the data source is // stored in one 32-bit component of a uint_4. - texture image_texture(image_extent, image.data(), image_extent.size()* 4U, 8U); - - // Use can access the RGBA values of the source data by using swizzling expressions of the uint_4. - parallel_for_each(image_extent, - [&image_texture](index<2> idx) restrict(amp) - { // 4 bytes are automatically extracted when reading. - uint_4 color = image_texture[idx]; - unsigned int r = color.r; - unsigned int g = color.g; - unsigned int b = color.b; - unsigned int a = color.a; - }); -} -``` - -The following table lists the valid bits per channel for each sort vector type. - -|Texture data type|Valid bits per scalar element| -|-----------------------|-----------------------------------| -|int, int_2, int_4

uint, uint_2, uint_4|8, 16, 32| -|int_3, uint_3|32| -|float, float_2, float_4|16, 32| -|float_3|32| -|double, double_2|64| -|norm, norm_2, norm_4

unorm, unorm_2, unorm, 4|8, 16| - -### Writing to Texture Objects - -Use the [texture::set](reference/texture-class.md#set) method to write to `texture` objects. A texture object can be readonly or read/write. For a texture object to be readable and writeable, the following conditions must be true: - -- T has only one scalar component. (Short vectors are not allowed.) - -- T is not **`double`**, `norm`, or `unorm`. - -- The `texture::bits_per_scalar_element` property is 32. - -If all three are not true, then the `texture` object is readonly. The first two conditions are checked during compilation. A compilation error is generated if you have code that tries to write to a `readonly` texture object. The condition for `texture::bits_per_scalar_element` is detected at run time, and the runtime generates the [unsupported_feature](../../parallel/amp/reference/unsupported-feature-class.md) exception if you try to write to a readonly `texture` object. - -The following code example writes values to a texture object. - -```cpp -void writeTexture() { - texture tex1(16); - - parallel_for_each(tex1.extent, [&tex1] (index<1> idx) restrict(amp) { - tex1.set(idx, 0); - }); -} -``` - -### Copying Texture Objects - -You can copy between texture objects by using the [copy](reference/concurrency-namespace-functions-amp.md#copy) function or the [copy_async](reference/concurrency-namespace-functions-amp.md#copy_async) function, as shown in the following code example. - -```cpp -void copyHostArrayToTexture() { // Copy from source array to texture object by using the copy function. - float floatSource[1024* 2]; - for (int i = 0; i <1024* 2; i++) { - floatSource[i] = (float)i; - } - texture floatTexture(1024); - - copy(floatSource, (unsigned int)sizeof(floatSource), floatTexture); - - // Copy from source array to texture object by using the copy function. - char charSource[16* 16]; - for (int i = 0; i <16* 16; i++) { - charSource[i] = (char)i; - } - texture charTexture(16, 16, 8U); - - copy(charSource, (unsigned int)sizeof(charSource), charTexture); - // Copy from texture object to source array by using the copy function. - copy(charTexture, charSource, (unsigned int)sizeof(charSource)); -} -``` - -You can also copy from one texture to another by using the [texture::copy_to](reference/texture-class.md#copy_to) method. The two textures can be on different accelerator_views. When you copy to a `writeonly_texture_view` object, the data is copied to the underlying `texture` object. The bits per scalar element and the extent must be the same on the source and destination `texture` objects. If those requirements are not met, the runtime throws an exception. - -## Texture View Classes - -C++ AMP introduces the [texture_view Class](../../parallel/amp/reference/texture-view-class.md) in Visual Studio 2013. Texture views support the same texel types and ranks as the [texture Class](../../parallel/amp/reference/texture-class.md), but unlike textures, they provide access to additional hardware features such as texture sampling and mipmaps. Texture views support read-only, write-only, and read-write access to the underlying texture data. - -- Read-only access is provided by the `texture_view` template specialization, which supports elements that have 1, 2, or 4 components, texture sampling, and dynamic access to a range of mipmap levels that are determined when the view is instantiated. - -- Write-only access is provided by the non-specialized template class `texture_view`, which supports elements that have either 2 or 4 components and can access one mipmap level that's determined when the view is instantiated. It does not support sampling. - -- Read-write access is provided by the non-specialized template class `texture_view`, which, like textures, supports elements that have only one component; the view can access one mipmap level that's determined when it is instantiated. It does not support sampling. - -Texture views are analogous to array views, but do not provide the automatic data management and movement functionality that the [array_view Class](../../parallel/amp/reference/array-view-class.md) provides over the [array class](../../parallel/amp/reference/array-class.md). A `texture_view` can only be accessed on the accelerator view where the underlying texture data resides. - -### writeonly_texture_view Deprecated - -For Visual Studio 2013, C++ AMP introduces better support for hardware texture features such as sampling and mipmaps, which could not be supported by the [writeonly_texture_view Class](../../parallel/amp/reference/writeonly-texture-view-class.md). The newly introduced `texture_view` class supports a superset of the functionality in `writeonly_texture_view`; as a result, `writeonly_texture_view` is deprecated. - -We recommend—at least for new code—that you use `texture_view` to access functionality that was formerly provided by `writeonly_texture_view`. Compare the following two code examples that write to a texture object that has two components (int_2). Notice that in both cases, the view, `wo_tv4`, must be captured by value in the lambda expression. Here is the example that uses the new `texture_view` class: - -```cpp -void write2ComponentTexture() { - texture tex4(16); - - texture_view wo_tv4(tex4); - - parallel_for_each(extent<1>(16), [=] (index<1> idx) restrict(amp) { - wo_tv4.set(idx, int_2(1, 1)); - }); -} -``` - -And here is the deprecated `writeonly_texture_view` class: - -```cpp -void write2ComponentTexture() { - texture tex4(16); - - writeonly_texture_view wo_tv4(tex4); - - parallel_for_each(extent<1>(16), [=] (index<1> idx) restrict(amp) { - wo_tv4.set(idx, int_2(1, 1)); - }); -} -``` - -As you can see, the two code examples are nearly identical when all you are doing is writing to the primary mipmap level. If you used `writeonly_texture_view` in existing code and you're not planning to enhance that code, you don't have to change it. However, if you're thinking about bringing that code forward, we suggest that you rewrite it to use `texture_view` because the enhancements in it support new hardware texture features. Read on for more information about these new capabilities. - -For more information about the deprecation of `writeonly_texture_view`, see [Overview of the Texture View Design in C++ AMP](/archive/blogs/nativeconcurrency/overview-of-the-texture-view-design-in-c-amp) on the Parallel Programming in Native Code blog. - -### Instantiating Texture View Objects - -Declaring a `texture_view` is similar to declaring an `array_view` that's associated with an **array**. The following code example declares several `texture` objects and `texture_view` objects that are associated with them. - -```cpp -#include -#include -using namespace concurrency; -using namespace concurrency::graphics; - -void declareTextureViews() -{ - // Create a 16-texel texture of int, with associated texture_views. - texture intTexture(16); - texture_view intTextureViewRO(intTexture); // read-only - texture_view intTextureViewRW(intTexture); // read-write - - // Create a 16 x 32 texture of float_2, with associated texture_views. - texture floatTexture(16, 32); - texture_view floatTextureViewRO(floatTexture); // read-only - texture_view floatTextureViewRO(floatTexture); // write-only - - // Create a 2 x 4 x 8 texture of uint_4, with associated texture_views. - texture uintTexture(2, 4, 8); - texture_view uintTextureViewRO(uintTexture); // read-only - texture_view uintTextureViewWO(uintTexture); // write-only -} -``` - -Notice how a texture view whose element type is non-const and has one component is read-write, but a texture view whose element type is non-const but has more than one componenent are write-only. Texture views of const element types are always read-only, but if the element type is non-const, then the number of components in the element determines whether it is read-write (1 component) or write-only (multiple components). - -The element type of a `texture_view`—its const-ness and also the number of components it has—also plays a role in determining whether the view supports texture sampling, and how mipmap levels can be accessed: - -|Type|Components|Read|Write|Sampling|Mipmap access| -|----------|----------------|----------|-----------|--------------|-------------------| -|texture_view\|1, 2, 4|Yes|No (1)|Yes|Yes, indexable. Range is determined at instantiation.| -|Texture_view\|1

2, 4|Yes

No (2)|Yes

Yes|No (1)

No (1)|Yes, one level. Level is determined at instantiation.

Yes, one level. Level is determined at instantiation.| - -From this table, you can see that read-only texture views fully support the new capabilities in exchange for not being able to write to the view. Writable texture views are limited in that they can only access one mipmap level. Read-write texture views are even more specialized than writable ones, because they add the requirement that the element type of the texture view has only one component. Notice that sampling is not supported for writable texture views because it's a read-oriented operation. - -### Reading from Texture View Objects - -Reading unsampled texture data through a texture view is just like reading it from the texture itself, except that textures are captured by reference, whereas texture views are captured by value. The following two code examples demonstrate; first, by using `texture` only: - -```cpp -void write2ComponentTexture() { - texture text_data(16); - - parallel_for_each(extent<1>(16), [&] (index<1> idx) restrict(amp) { - tex_data.set(idx, int_2(1, 1)); - }); -} -``` - -And here is the same example, except it now uses the `texture_view` class: - -```cpp -void write2ComponentTexture() { - texture tex_data(16); - - texture_view tex_view(tex_data); - - parallel_for_each(extent<1>(16), [=] (index<1> idx) restrict(amp) { - tex_view.set(idx, int_2(1, 1)); - }); -} -``` - -Texture views whose elements are based on floating-point types—for example, float, float_2, or float_4—can also be read by using texture sampling to take advantage of hardware support for various filtering modes and addressing modes. C++ AMP supports the two filtering modes that are most common in compute scenarios—point-filtering (nearest-neighbor) and linear-filtering (weighted average)—and four addressing modes—wrapped, mirrored, clamped, and border. For more information about addressing modes, see [address_mode Enumeration](reference/concurrency-graphics-namespace-enums.md#address_mode). - -In addition to modes that C++ AMP supports directly, you can access other filtering modes and addressing modes of the underlying platform by using the interop APIs to adopt a texture sampler that was created by using the platform APIs directly. For example, Direct3D supports other filtering modes such as anisotropic filtering, and can apply a different addressing mode to each dimension of a texture. You could create a texture sampler whose coordinates are wrapped vertically, mirrored horizontally, and sampled with anisotropic filtering by using the Direct3D APIs, and then leverage the sampler in your C++ AMP code by using the `make_sampler` interop API. For more information, see [Texture Sampling in C++ AMP](/archive/blogs/nativeconcurrency/texture-sampling-in-c-amp) on the Parallel Programming in Native Code blog. - -Texture views also support the reading of mipmaps. Read-only texture views (those that have a const element type) offer the most flexibility because a range of mip-levels that is determined at instantiation can be dynamically sampled, and because elements that have 1, 2, or 4 components are supported. Read-write texture views that have elements that have one component also support mipmaps, but only of a level that's determined at instantiation. For more information, see [Texture with Mipmaps](/archive/blogs/nativeconcurrency/texture-with-mipmaps) on the Parallel Programming in Native Code blog. - -### Writing to Texture View Objects - -Use the [texture_view::get Method](reference/texture-view-class.md#get) to write to the underlying `texture` through the `texture_view` object. A texture view can be read-only, read-write, or write-only. For a texture view to be writable it must have an element type that is non-const; for a texture view to be readable and writable, its element type must also have only one component. Otherwise, the texture view is read-only. You can only access one mipmap level of a texture at a time through a texture view, and the level is specified when the view is instantiated. - -This example shows how to write to the second-most detailed mipmap level of a texture that has 4 mipmap levels. The most detailed mipmap level is level 0. - -```cpp -// Create a texture that has 4 mipmap levels : 16x16, 8x8, 4x4, 2x2 -texture tex(extent<2>(16, 16), 16U, 4); - -// Create a writable texture view to the second mipmap level :4x4 -texture_view w_view(tex, 1); - -parallel_for_each(w_view.extent, [=](index<2> idx) restrict(amp) -{ - w_view.set(idx, 123); -}); -``` - -## Interoperability - -The C++ AMP runtime supports interoperability between `texture` and the [ID3D11Texture1D interface](/windows/win32/api/d3d11/nn-d3d11-id3d11texture1d), between `texture` and the [ID3D11Texture2D interface](/windows/win32/api/d3d11/nn-d3d11-id3d11texture2d), and between `texture` and the [ID3D11Texture3D interface](/windows/win32/api/d3d11/nn-d3d11-id3d11texture3d). The [get_texture](reference/concurrency-graphics-direct3d-namespace-functions.md#get_texture) method takes a `texture` object and returns an `IUnknown` interface. The [make_texture](reference/concurrency-graphics-direct3d-namespace-functions.md#make_texture) method takes an `IUnknown` interface and an `accelerator_view` object and returns a `texture` object. - -## See also - -[double_2 Class](../../parallel/amp/reference/double-2-class.md)
-[double_3 Class](../../parallel/amp/reference/double-3-class.md)
-[double_4 Class](../../parallel/amp/reference/double-4-class.md)
-[float_2 Class](../../parallel/amp/reference/float-2-class.md)
-[float_3 Class](../../parallel/amp/reference/float-3-class.md)
-[float_4 Class](../../parallel/amp/reference/float-4-class.md)
-[int_2 Class](../../parallel/amp/reference/int-2-class.md)
-[int_3 Class](../../parallel/amp/reference/int-3-class.md)
-[int_4 Class](../../parallel/amp/reference/int-4-class.md)
-[norm_2 Class](../../parallel/amp/reference/norm-2-class.md)
-[norm_3 Class](../../parallel/amp/reference/norm-3-class.md)
-[norm_4 Class](../../parallel/amp/reference/norm-4-class.md)
-[short_vector Structure](../../parallel/amp/reference/short-vector-structure.md)
-[short_vector_traits Structure](../../parallel/amp/reference/short-vector-traits-structure.md)
-[uint_2 Class](../../parallel/amp/reference/uint-2-class.md)
-[uint_3 Class](../../parallel/amp/reference/uint-3-class.md)
-[uint_4 Class](../../parallel/amp/reference/uint-4-class.md)
-[unorm_2 Class](../../parallel/amp/reference/unorm-2-class.md)
-[unorm_3 Class](../../parallel/amp/reference/unorm-3-class.md)
-[unorm_4 Class](../../parallel/amp/reference/unorm-4-class.md) diff --git a/docs/parallel/amp/media/campc.PNG b/docs/parallel/amp/media/campc.PNG deleted file mode 100644 index adbcadddb1a0e348726cae98e5c4ecc326ec5ccb..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 15562 zcmeHuWmJ^i*Ecc100Kid3@M6~A{_$^rKBK8x8%^>F|?F`bSoXw(jkp>gEUBY_d9xf zKkIp(|CjgkyWX=FTyw5<&c629C-(2`2vt&$#=)Y%LPA2qk(GhIK|(?SA%1rO(GmXx zF6%xb9>@-Fq{Wd+2dTCY6@aOjyciNvc@*}o0UDx?X)B}QfP{qm{r4Yow@tn=5|WUf zEL2R@Rd-M4rk1!fzB&4bD5oehe)r=0=Sd%c(AZ*G0DP%0S@wO8Tr{w+pH~k0s0~1W zi87wQN*3b+1rW)su_1H!h6thbNT7Yl_RR!?BDk6@2TL6aZJg5F)4fwg@>&`uH7*uJ z=FcwA)f<{;s~Z}OF7|~V(dr}N`l2o&@%?_#QEdYG$v6D9|JD%?2$iod1b~juVv9tD zgwcv@3r<7@fxz;d=3lQ{w^9FjhlKK{{H;&{e<1+?GK6vz#X?_?|8zn^Q2AZ{R?L)f z9d{-p3NjiybgWSf55jtP+pSHdsqeHGWv%W8n|AATPNvsQdy%wzn9HWSd*v2!b|$Y{ zw#cY6giliiK$zprgi{v%%Ke2l(!9=BKL(vU=BBUGIEf~F22C6c1C-R6tEGANOM|7H zYi^1StoBPcIHR>3!5c5ll=0NO5yJxWK~7R{Yj0aZALmF%EuRd=J*gcZ;C1}aoa3M^ z)GrB9?Uc|4{-DxGd-gWwtMiJa90_SNint>;)UjuyaOxYtM)!09{yAnREdV_XdD$ZPCmw+?kp`#*28)qI4JD%cB#s^s zC2XtUWQ&Zk^n1o6mwX4i!)3K=ah3^@W$3}G`1nt08quIVYq{w~r4?F|ke=8EHWV?G zt=w?;lOEKlDs4x?#bmBfY7M2(5O{q_48TS^Jf8f|^p|``P766C#*;;ZKcn}oWiz%m zX%5U%D6D!_R#>wANlI6X%mP;;Z)L|S*fTP9NGYKoy#BQ3F18aM<(ugM&&)gzNyUD2 zKS_T3mDmam!JRBWI6MS&6dmLXiosA(fS1_lqO?E0H7bOX`YF|77{)em^9QfJ_*@s5 zRWn0^c*VBqLnq=mRX{IMrNx+Z9Rj5FSfYZ%+K>^ej|CS)n?3+8!LTA$d$$}bBfA$< z%VrfCpIhUB2~_WfEjB=X56*psM*2d7OWE*M7$L%?;qZ_WG!;rG7Y$n@&5s-~ErE(l z8GruL&M@GgDY3U}Rp$okZram`OG1C4_*3-PvOS7Ho1(^b^!S`=mfxWBhK7Z`%}{`s zJ1Mqrgh{NBANN>?QQS6!<$EbVVNL^2hf_~5%T#7?Y;Y5TOE3;D90=5EHx3Euk%WZw zs^M0DQ@cP>;+OUXi{hS*vc3+-8wzFy_=L;=u-OcSP!g7=pY^yI&Am zN4l`b%>5n4bm7~g>FIJKjSLYlLs|i;#SwnT(pecG5R|~ToZREIw$R{0t5s)Dtkrz0 z-Zez1SiD5f5bCSMzjq@V8o?MqFlA_kI0hlCwwZLuV*X35eyF>TMXzMjY?ab>VYTyJ zLvJM!!a$eFLGk}q<#tl3cJ$S#TcO03IAD}XTLu71aM_zBKFzWOgIo91Z12q&T$AHa zaWH{lPop_Oh6b}$=ET9x{PtC+ywrq?vBQ~`YhCpKK-1P6Z;!molm+iPmri46gIesX zqOUq-sI|!BS2aH@G|G8>UX{`2O*x-je=&+cvDs1o*bJ}f&MOrK+9Y%Z)2rC$&qTfzcnzY^Cior>I7JVQ z!IBEdzHQ^+gDNt8eOryAJ6$D{mfqs?gPws|_}{DvDaHAz84%eiF@RQl@Ix~#H#L#P zM*#2;5p59%S{nvQ{^l9jJ4W_Cc5p>|_sf`@UxG^Geo%OnD=-3*kB>3`kf7`SgcchF zvOSe_JT)V9O+v%)M}xmhipe3O_wycmAhH7~W1I<2lr!Ulj<+>*WYueV2P0wp!z3LW z*9wL^E?u$wCd!$gavnr8fE@!b1a2T&JZbpR*fWO)O*th*I(l2$ZYgW2{lB2u@**t{ ziq@r2)j}=afsSq_aK31%XE1E8MqN^msczII`rCFq1Be~@sOi8fDm)ksn*;(`sxh;{ zy|yRbFgWITia~%0bi=z0eViUr!@6m6CAjRnzE<%J02kOA>yRP*`T&@D0!n5Avx^pK zF*>{MOR^n^uQBBN`vZ_-UZ1{YPJUXIZ-sA=wHIRDhC=Vg}d@gT~LUEzKlp z*|=)9M|#L~q8Q@x^;TUvWHsJlETOaNb$F(Fe5pE<2b9XHk_)py`Rvcv6|IQ%+pi$= zGX_8TAk)FP)O})(PnHEpN9W2;kLRc@MUo7v~5k1R$yB9XP0r&LeF zD2bPbJ_6Tpb&v%0cpx_0 z=a1cqQ0gU(7{1|XUr_w86mr@8ATELzRS^{H62az)7g>dhK|uf#N{vV`H)wegD14xVEcO$7z{N}z0&n(H z5ow`LMZNZw#YG(8R#ay1AR*#M0ydy$p|R#r2xEbw_FS?1n3-T-Ya%KF)X>`^PH?j- z!e+dW7FC|wQxvGh8ia0@+h`nG0SR9TcLBKH_>quf#K~x&4um*l$P9lJ!)!R}0*XI9 zy15S|_ne+^7t`a9Dp8`rb;SgNvW4KjB?gv%TDBt7;zA($*r+bC{{>Uq5NHy~++TJz zN6rpcjT52hkZ`MbG5&6ie^gJapFX0WFL&GLw!-Wtb>goayVwYYC-OgmC=!N0|L`b^ zzn5d`%ahfdVO!id&snOT@DuY|%Jrn~_DE{MnJ{A3nZEd-gP+)S`aV6= zXeVLQ?4WU5!#_X#j#ue+@~fQR;nyMWcah7bfL%Wf8vTn!AD{J0&-0W;D_}a3KH+5^ zBjV#SVDXPgQI@fIKbckEH>DgELm+)FVh`R zE75$5Pr^D~=6%LmV>R>qeA+0=9If+o%cVk^R!6nIT!~xoQ;9GLQP_4I!QhIB*7yN( zp2`+RFpbx#a*g>I^ZCu2$PHsUEr7Ha7F><+no4*VMxD08jwOJg*r55OL-v8OlWBs#- zfsiQv@~q5fAcvr8fXnUJ_IN=d;iv_|{5%j(Kpg+~Z}#eSdo{>dXgfTqpMjpH4o|4u;p%*@2OBRKj9g$5jW@ zio8sN1R6Y|Ov6rfD&w=$mv)cChW5GBt9f8lD8pP0Y~u=t5d?R2-7d(RelaBUUDxN% z>HMghwsI^_v65QQ*%n!>eHl^Tn4^iKJsQinkGoqT#Y2zCh%OIupw#%CH*B!v?h=o7dIyXHilV@yB3`qDo~}OXXnF#}(;14@K-)_~N+9A3CwL z(u$8$8?9g@Bgpu~;E|IkorekPzo0_Fh_a44iBYoK*d86GI6Qmd ztq!*XMisDW)mj%>i3xR_P_kf^d*8X=U(8lp&crH;^q%j{buV~b=+K1nxg9gkRhVFt z;yG*#uDck2pcedeH}vrHK-k%{n`}^Gt*y)N2LLX_pHGN}^Rwlk5Z-J4@_K#e3Tr;0 zN<$JXV%TELATVfjLB;oj0kr*)t-I)4SY!zUh;KJgS&&A`XusGG@*DZ&M|GUQb(cr! zO{H~pvy!GdosW;5;2WLuyge(NB?7NT0~lh5=V-4&?D=p%?~o%CLo$Zt;#5QEMVJ~j zlZV-e(Nd&U!0ug0b-G^LXGzN*>zk?d{0W!+!~NYZ0&9+JY>wpYju)s1VTp;-dY$5X zoDA?@sbNU6ZPs%cb$#{NubY~4xvs+8xEzu+>3r&foRuO}mt*bE@DdYb|Mh#lE`cP~ zM=aocpZ1_1XNj6Bz7ztKy;}B(QK6&9Slfi|ivbt1@BtLu_6h;BcqsvDIn?c0{rHcj zGUc=&wkbfmytXMKG5Y<&D@uX6t=+Ll3jvE0p>5I-?sgj|sybJ>MVpz5_<4jP6yiF* zJbGo^dvvnkaZujmadDjA*>thcU)p?a;e0VK8te;v=X*VkwlOWKx{pHNY+ocrC;r{5 zJ->v&@2mWeSAkXJ<_WV}3$!gn$^AacEQ4)}Sc9{=A ze)(&cGtUk8O6JF7kv$;bl3EcLZ@nA@5`DNDaAP2DL zC3T+>1?7-PL!f+yNZR7ZC!(Ad%k6=;WK0UpCxe2XH~t-{Oj?LlI&XzQ?7Qc4Hl_)B z-ux*7PMW2$(hMu4Q&m$nGW#gv@VOo98P;KvAomT)(FRU!eh`-(cv-)Jc#;=N6IQ#$ z{%9^t$Q~;Ury3s^o+fb-nZgA2y6H^q{!z$lj;6SIyKYq= z5DKr(;A8*}e-0hm)l7j-!aSEv#gr|B@N8smS%-n`UssJbh zah{$0do8kb#k@yb5}VrspRLY*4wnQoI(>11G2C=TV1-o8{w%gXUh$H7Xg%0A9tB2i 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 Kv{YQ*|Nj6A+*6NXo+8yxnC_jH z-DzR2LqOBg*3?;2=7D+erJm~P>B-2<;&yK7;Na4}z}aD0=7oLZdUB;ME7;fDxi~W6 zacS0MUfXkQ#YR8ATUgC^bIoXD>y(YNG%oF#k>=js=F-yT$;ah?cid)P%(An?Lp{@X za_#5lwLCc5V_e>DXUtAV@u{KNX=3f0mExY6>zb11hkw{yRkAlT_xAku_51Si_w@7m z+tC3?A_eq@9y-^&(qe{+Q`Vu!NJ5@S6Il$$B~ba($doL@$q7;#pL7T*45RP z$l1%|?5(S-Xk})Dfr8A;&USNj_4NAk`1-oJxlBn)pPiks)#CH=_}J?4ZsBgYfW+nT z^}@lzz1-(irNG<2;(WT#?CkOI@AQem)T7SbZ?nojJ3L38ynv(Xlt8EP@b$mZ_2}pA zKy=`e>5}E;>gnk2^6~aDEiU%&`0MKL^z`(}pVRH%@TOq3;^F4x&*{(H_tDVQEs(N0 zm$#izuG`w*pStg_aJ|y6+Un`<@ALe^!NtSE#>~sl+}q&fcw`@Acl@ z;@8&O@$mNT?D5~|`f!)$P=Mms*4n_2%OG9aV2kCvyu8iK&@gG;)zsLdp`+m7;MCLC z#&(n)ApVHCQtE#KX$;`{j&cDCEuf_5ZQrM5K?as~6&(G1#&ClK4-R_^5+1cIE z(9_h^*VEF~=!t=_u&~oqP3hRz>5hlDQBUX4&fsljx_y4>==c+U@?3RzMZg1?D zk-=hK#h;<#l8f-CpWfZz|J2&1lmGx1Wl2OqRCwC#oe6v+)p@{|EuthrG+`lJ ziM=7P+}CpKLP8oK38bX~l9ZHs?Okt@nPFx$nwbb)sMboBEn8k|y|LHp?rGTjZ1-lD zJJ|p+A@?SsEv0E`+B9uKXwpCfoqpeYGou+vwq<0?vh=>6Eot6dZ{|PW_l|kr`)2(g zlX{d{>=rQYOc-}2b;kXECbcKyaK}yll1c4J0sC2Q>bT8=L>4ir1)(ra^u@U&bp-wp zNE4G<5yZKOuy=ybaVOLPdef>y+3fyKkX9x$TM**@Z1&KqCW0Qw7jj4JivW7Iv(@7{ z+yTzQs&tz5vI8?L#dcp4O}z{4Bd{ z2kfglJsm>>iyQj)?QLdK8?tv_f5YN|p$<>yDg$7`SQ=r{e458&ZdWKg`Z`sdsEia@^+!H zn^ptzFW&Y2eJ!4BldbSJcd+su1B`oZ%71SL@B;%jEvR1MC)8r7T=} ze6F{7aZAq7+uRR9;vO8ok=Wy`+#P5AhFWiEy1MZ=JJpPeA`ymP&X z>q`{-AmW6x;d7mH)WcwkGqa|wZExQIU#r*B#di9=p?x)c;Oe#3hO65#4c6c$@N>gj z_rb@>_>XrFAKbGZ4E>=3?pe?F{>GBHrxd^6h(-O~X=m!PuPr0;wPlszE^vUE7dSgX z7BbHDVIflTv8;pm^!zpHB3nDsc#dsDJEw)eI@2kX}Ku4^}p^VS&WwYg8Ls$*W@PeztLv$?T#fzKhM8#!*P%!f&u%$rB?IabkKe5TnT zI}+m{YM2s>;YSdz55AJ{h~uTk;UgZ5<0^mBA0x-n@W6OZO{Q!^wwVc8&zu~HU;^*V zApLEKz^kpD0H)j@1F+8l+cji$uM<0NvAP#@9Ct8!H*I(h_R#s-q9QTfrFr;eZS z?i)Bi;x~+jBPT+t9dDXP@2Ir-lM>$A*H*aP*bFI5-wTk z!4ggs0-|+(F(8QMPdO}bK1Wt~E+9Y#gn*ErSyhAW+8%3PW9$1Sz`S(>`9io(>|_gk zASm~BTespKLO`}pMW5Nx0Uh{ab$v z@~uhc4muT}b{qaPRxuWKaYrMkxw)GZ;Dd+VIiD*%M2w=y*(wvJo8vL!06h)bo$eym zjC@3ab2k7_7=Fb{%Y>XoLcK}U!X5u* zfg7}Mvbm7sE`&LbE5@DNZO*-75VnO|&+A-n1!teg@b^fP6vK=2+uW5Tq`{Zp!JXIC z9CuaYt&@T1Iow6Ko0*k~jX;d+))wc!8jEr#_iZ+J^GP9j;01RbrKo&=*U0d}C4~E; z0`7}Tengg_mer3#J~Jl$5s)rPB)!wV4+p~xyJGjIdd+(Z*e?*wp9KoQ@C54obi zuV5E2$4Y%1jekt(3fjja`x`l(rU#^%CKPDaXd}XzSyPSMu=c*TjeM^q3&z^V+Ca1M z=e7-YL%)q^`Wo_uo3xmHT^bRMZ2{`y{z3;izlyEGS_%o zV*3nrwCaPfb6qKJkKqqZPM;BXL%pYbME>ULxflX2x-6GAY8iGwzH#<31to zv7|&^O(+jng1gQ!Y*oQMo}{f9f4U;v!;D&Wa96s_?wepmxHEOH67Et;N&@<{->3xl zvEMT>sUUa72=>GiP{db)dw^%us)KuqypKyulJu}N_1q^gYKF;_a`#KY*dwHB$IAD* zYR4s{?ijWBj63VMnKJIIfUisL);J<2^~IeD3Ee84!z17qTwUkp~psqR5-+f_XfU_TOOk9T#AgB)%+d|QJo&{#81kf@>92w z>gGN!3*K36GzY%<#KK+a;JH9#fH4O&S@JCu4Ky+2~7ug>L*1;mR1LMIlu*| zLIMk2)qI@nL=xwlth(q*L;RZ0pfUQRS$#&2X`E=E^8tVr589E?iC;Q`OvjZ z7CB#Wea{VcH+R%RhK^oUMBOtu6dFBMI9UxiO^a+~bRWkXy2c9{d9jc&e1p!h-JtxU zeSDf5deVpvNOAP9p+@qq%Q6I*XEQs7iV7bQE6bhwNd^6R{;<=>UC=@f?r=q+-*OphpU6TAxAReXxszDTP?z)*>!Ob zg>`Ox?sP}a!Ci=;W~1kwZ_w$33XriZ&yc@R06$^VylQ}`hWVo0>G?P~n=kLWOzy;! z&&zw%;?RoE5Gu56XgZY4 zs&0rjCaC7aD$sA-2LN(tA&vfM}Uld6Y)8M)*~ztTMAZXgrMb_5{yLsWi7g$GZe7BC z6!VO$SfnK#&O44e*?BiJF_F1=>V~^Oq(n`V>DKb(oH|m`yff}h76VhIN^sY5Z?Kq5D|g~2r9k1{9jyTOP=Il-3hvZTDhgFQMX8jXS3`{5 zbaSVEQlRp|9)G2{(-#q}RzI!nIO-=A>y{Fgs@Ks0WdT;NtDAlsUs$yVkTQpWKSY|8>#qtA2RveINb!Z%&VPClyr`GF5XK+~ol4jj0yycb)X-_nvafSwFn+ z%3q!TvFpZ)C*}A1A1T+)v$-s)h5J8z==Q75I_npod-;yL-+KSM#*QZyO*8Jb!u^xy zT===!voE>zz8fz+|IdCqRy--gkm8Jct#E(kPj7hn)>|)p>5iK}bI)I#IaWL=Bi3DZ zeLfUmNUB8N|M=P~Z@A&g-`#xY6@T*T&&KqVN|o;ysj-n1Rl`Nnd`ss_pjZw;Aiv3@RK6=8TXpuKL6r>yye_; zZ~66Y3x0pyn0`{RV7c67U1vn9h5Os{fBu`xUR|)@gKu2-HtVmeBkpg%{fVEy@y6Mo zp2z$q>Wn+{mtou)cgCG@uW#kPR?$l2znuPK_!MN8^JC6EE zMI~tl%sH9<}fWxixzGacXW~Q&R8UdE|ze8lNe9Rh~>gbRfv1A zSYilo_YOzG%ECL#lerVdP*SeMv@s{M!a+%b-{dx=V;FD+ zv}Mc6Z^Pp9M~^;!1h9X5<)cLzl1=Tq9pJc-Jr%t^h_QQkPRpoyX*M?JM8UFds2ErX zgBam-@IWr4%HctC`v`{$DRLZ+5{Iv_9Z5(hhYWEfI8az8v&)l7Jkm)CE(Ti1U2v`G zN63VbG)+l&!wrcgdq|_1=j><`^rso%sv_K}pA?Rwx8BRVL+(H}5g8=L2L8aaWpc zrkxXmhjc^NM42<>!H^N=F>ah5GQ-N*dJm6@PbaZ~ochkuKry&&M#iu;Wab`tjPVMC zl3%j*-Aq#yBcWLOt_jYA2?2Y)r;2c=eo{Dxne`s_o!a?W7y4gNv!>8v#iJ>>#8f=$ zDCDdq+(eSd^r%v_CoZAt@Hy@)j1^;Y7xmms{TwCZ<}MVb73B_)IUmN8L3f`3k0B>8 z5Q$|E1P*63$G~5leG~_G@{_av$iI@5B=j*&&=(%$hL~w^&3>D^Kp$LsFj*7qm=zV_ zPW_}}JxZ#lJnl*=k;>!lm!dc>KcOTYg?U1eg4QOc`In?vTA~lVSR(h3=BRjKmGHiZmvECr3Mv8QouC=TjKpAba({fs z4y(H7;_e!>tp=dXC2@L4+%66ywef>KIX|ta45F^1e!~MG=my7&7%m3QyDvoQZg`jw zaDlApP@sq;*pwX-EbKD^s?8no#icl2RIEEl9&jkvgI1cwz1ytS=E`@gs!=iSc04J+ zR9?LS81}I$gp_0L}^5MJ~!8CHDm{k*2{l$1p7|*{xWebJRHTDvDj- z6mX}0Qn7T}o{@U;+i}Tq4-lF7Tz3|sTD0i8Y?ao#fhpL2m3*USDRi~VC?^`0drjxp&c5lFH#m*salWR zMU{mVs4?zVB&m38OgqoI%4&?e8A&SHqcHAuX6G@IR8Se4JBuMwP26{m%Dr;}+({&< zak#UXK~=^58p^%1kb6hT+-W2!h1vO;!+qDtv&VpYM=|bwrE;f{q!{;^Bj4XOGJJ4J zb6)}X2MPBBC2=<+Nips-N4|T(3&RT!5bh7=ao^w3x7S+|cN$4bktAhw?!K_f?soOa z_vY+=ey(?KU&sD@?hj=T59}+AJB=iTzAR(uJCiDsAI*8{_zCa6fy3E{3b=c=_cxZ? zU&mj4_0{YySD*Z3Wa%@T8~e9=3b`Nh3^lATm;2v6`Q(%AE?1xYc=zzZJ?k5WJckOn zufmR-GPyIUQdzk4_*^e`+pNmtP8xCp{fv8U%8APt?rH2FAk8=jce8*WYH0RuK6d%i z-6M16T(E1`&YfRoGLvQJ&Rx4Mm@{W&_tMLcZT2>UnYW8~2lrL2pz!Oxn-?A*Ui#GT z7e+>|`4W?vE!T{Uys-PJrNhS;ZuYJRb{Sx-wJfZsFs;4{acA0B>oDU+El z&kheifBcz)bN2xDz7|imX;B_`RQRS&&rn}~bE9|9<`Z)l9z6C%CNo`*9b7o~#O6KT z#^(OMAx~!$s=JdrQFyTQo|b`z{^s?KUhjb=Olm<6c)gA5oBJCET0CIoZFRS~Q}CUh zj-i3Y4gLG}HZ!RW*}Jd5Ve!CFho_TbcXP+49Dr}iwt6~RhPDs%_4O@gGV=vE4s0K4 z>F~5>n-IID?lyM|{HknctH*P=1Eht?Oc%s>*yCyK%&u}{&v7TT*&@MFW&uzzv$!%hxZFkV<2)Z%omFdrU`pJr^V-+@BAB$ej+k7D!0Eq7a#vnw~~~ z(!4wf&of|zD$12Pb(StwbiUtH&lnSBhjvX z_*?+7_#y z8OxWG&O7>}j16j?6T+}mk(njYb0tX$FJ6&GW#VWC{(F*%1eXzr`*+=zg#;%|G@Hi7iGf?R{?B5kF9=a^fEjC&%GG|_qyWE{$PX)#V z<-6Z(GyH2o7~iyW*`!%wdIAKL*Q~R{c|XkcvrP|WSIRQ#!Q;~adx zL;ov6%P;b+^#CxnU?qON5& z^9@qI*Taeo-sm?Z6o(0x#U{xJL8qDvHL`DOoTnJ$H=W6O8l5-aQ4+*`l1v!U! z?62w($VbC?jZIfp4M~#9%Y;9#-ejv)QA{kc+UiYpV0)0?r?xhdjp1&wAPp%vop zCJ{|b4#o4m%zoM`{ppH0hMi=idzq0*s=bi%F%0CKE4PuFQdueI;ph4hp~0g4dLn4U zmDPB*tY8R7G)*FeD1fMupXC8Yy)yoI@~hID`Kl7}zoYEKs! zgnAZRQ!v~%q9Kq^qtFXuSy%Ulh!#}JRyF@+Esx1>xu@IHTF%UAxguqd@hggZ=b5xl z)zm=hrPxA&%0p|9%Tb)*tGyRU$*Vh_1xgQ(GEv|NBzSz62q*UzmWlDdCqIyGLHN=C zv()19Jj8ZM9!Awtk79ujm-$!OR4q^ms~3LYPt%(6uuy}PwEoYEW5tSvm!X04+v4~_5`1ZnFMAn+@$}D(j&cTM^ww1UPfJE%Pklz{m5uSGi8Y;%ztAodptzr319iZD z!aM%GN3YElIp(*ESZnr6bp}o!C1BurhWO(gKQG;4Zj}aBF1hQ+IWKqEqwcTz@2saz zV2IlZ;{Y*7Fq2>$#HfgD{3|dE*(gSEP)L0kSr9$w;1SG9eHIgxXR<@rE#zng-E&Vi z`mhy=h=NEK3+f(yPi3>jzXioKb7^P)n?Uu{$+T-U{8@SrS}#+mCl5YGxl9Mt0;;jA zd_HJr?y&r4r(;yqo9td`q(T)bAIXOfnVgnk}-ld z9EMGzX1rD<1d#~#$A4kAE|{x?v4#pihFoAhV`gO)^*Lju4GlOX(aK!)L7@h_7%Lo zK!GFU)~DN1RONV@BOCb^a%rZmP>3l610Qz@l(@&77Zna;RG~vIuHql4e~N$bV8pQ; z5nW%<7Uuo0?Tu>}H^VftYAaUaAjCJTtE-g4t{;?^lcfL?K49Y9RU-E>4hr4XOjfR< z71j}cTR;FqaL;~Qiku6QC8n+Agw!e|5{lfA6hVD1*x6yM{^~9+JiggZD;?eLzAXU+ z=1`6KDmk#wCFE+9p5Q4uG!gz9U8xshrDi!&~X<~iR zz%X*|T#M4KCG4@+piG;Puu*1i0Nzr;Ug8NvK7UM&33fP$czWRws5HC*GcfZ=7E2Lw z`Ie&6W|d4=D#Fc#Er;a}$3n;kEm=a-n`ui$5*j$KhBmM}&Ln0KSzaMRxTuF>31oP7 zy90TABtyTnj<|y?tU(XbL$T_YYML0@kBpe6VVnuEQV$!?pshAWh-|#^m=iX(X`%MJg=^f+=q^j zQc_)a7}f?~i48-=s8>P{hX5X>vpy_7pHSdlUqau1VI}Y)**OMH{^ zLHw=0a{JB`Sf4pvK9G zORG;00kH)VB&d|-XpIPzw6stp?|!9`2e|&PKuae>l*Io4)8i1pi3k0^PTV9GLVtl^ ze){^KSJy;}CWrHaI)f(A9z1>^R#g1|6#whDPpB z0K-KhB4zrYw}Fgc)63NP`KHZnUxDfK{RLya+GZyFTL=47OkZ*TZ;uvwbTFbdms~tN z&Zn>|%doNkiJ*!c^AI&uR0iWDs4sSVHBd+;b4#nxg*TxFrR?xQQ&j zk`Ul^bv464`Hx7sfltwwuOXQOQ{`4+5G!SB47(PDxp9Vd^SEQxH!_OWuPNVl+7Q!` zWA^s;lhF>v{FQi$z^H+tNuoEfJj;N*1LhH_kf&1uBNa{Y@n&mYTR`KN=X?(HyK}DF zgM<6`TS-Ls7u81@dcc4WvXJ~aM$YftRz5b%)RFR>JL&9s1e)D0X#+OeLb1l^W*l=R z-J{YLv8kkPN1qD%Eq`}97UaTK9dI1c>~o1;h6@b23M*>v^gJ79;p%Fxl$+>r3`+Vs z>}+q2u^YSP36%WoPd=L6!NN!xs=+v`^ zgNXw(^8wxk5cIa}Kt>5BzV+u8jLjVZ3ui7{arGJL`(nO%BUQdmwY`nLdLw^~qDRka z;=)Zx8?OA~T{}Cx zqh3_yUY~STMV&PK+kYf)F}$OZw!B0A4gH+Ab^ZK`(X_*?D@RSMGt&oXZPMNzP;A6y zq-t@!uWE5%FsB8ITIoSEJw>x;bhxIHcR6+RLX%b(U8)__M~4YRLZFiPqy~om0gwlp z0pJ~FOy5b4D*MZ*_#VWV$YE8_Dib<`9fNN_MPGIc;&tXbn(^1v0&7)DY zqFBJP3wp){xlKd@j8(~OcL2ZDC1x&9$dH?9k`7v!ql+vD*3!wqF7ezVf`g8g_Fxc^ zc`tg#4W{@7<>a%&srQF){^IL2yHw6=4-AeuUPhQE`Y624m1i9`AYhax!dDl`i@rce z;gR5Abh1q|YB5Z6?ibiIZJ|E0{R+J-GM=$hg;~PUsW+U6!rga^H$T3`clZ)!Jdjd- zl7FS2sxn+E1NI`5)n%L`%FM8U?LJ$lj1Y@Z!H#fGv`;x|1N#bkpKSgRaAy)EYAn;Y zQg=J9)QWtY|M_D7%8eox3EzA;>M4gC%Bzh1+n*!oy`@~#uqzl<^zL<|8Ih_CSjbWs z!QC0;uU;4PtHKz-GQ&}jgDf-&jPnK#rQzPMDjw$910a(QDJDqW2wZbS6I;Ah>p6_o z+S5ATLk{euH24I)3*l;s-{!Q#jH{oFwt-1O1RLPzBjHG|w!F7YQ~%kD(5d>9mLy?> z5;8<*=5a#((^M`e+nP&Z0_wypIdc&;?%zkS8?>)1X z%sfbxso=s+!7?Q0##?2fN69NKlo5TTVN=+K$N@^u0b>HxRqq`3WAQ&;_=No2@RJy1 zZ+@Yn(C6fsqAon~TTg37+I}O&mrDf#_ZxfV`M%(`;v)VGJG(S4zx7KOlI<@u)rk%nl@%v;$85eY z{M^d>7!B*kgTJSjQgKZD&QP(jZawp}@p)})ycPagMWyR{TZ*Ue%avX0U5GJ1A0L}h zgXdY<=MDY+3cd-BfUoZcTg@faG|Z3t$jYM)?3#bOR~HsiS?=FSuD6A@tf zM{Lwh&&(()Djt$)*yiL=c>KA#O^BX(u|A6rx8R1{Q#m2BQMLeo1~!dFv3@^ywSM+T zq{{G@@9t-cG<9K-!*MnmhqULg(U1yuAzacEwIbfCtef|9Utn)J9tDL$Fk;dN{NA2@ zEO)yoHX9zx*J%wuKg&RdE!Jm_8d#?rS12XNOSnyI2(1KFlc66+PZ+3#Lqt4wQBqaM z-+LCCZD5!TLm3qP0}gnTM~6KvW$#v}A{t+Bs{-v0Os~Q!jQ#|f4dvSCf zF<@YKPpl;Db+o$b#X|R3lF#3FuQMa#IqYEN2)Y7*a&mWFp-?POOMKFiSzjDUsmr@- z8kBuZ_-Yyizc{}z>?!Zcae05>Gf@x{M0|yXC=WGsyuionlx2whNgC_3p3FBjWQdt{@B)Mt%;R@4M@NZrF?5XY%BgmO6Dr zku6g|aH&PVTSk)DO}ioKE2kAOrwY*cc`b$IfMJUihSpne$~?PA2-3yfg`D$NMCSCf zGGru}4uU@5MArc58*SoyW#wn3HpOt+gE=XyBAGLPFYV+CtHJN(RwOMdSF4*0YjkiW zl+g4PVTax`l}663i^F2@>y(D$at#x8KR-Wz|GOQLv(C?RwLE#XwPa1xk;V2pO2Hev zJ5x*ti6uE^GiMuE=@A)dNsmj#4`G_S%8v=RKG?C&Jr0k9>=oh55?n#(#Sz1SAOL|3 zGj%SR*`uz9f^ZW>e8>Vra}5vcCM+Z4*NW{l05nGj50>&`WxVhI<74y1A+>o}*z_vc ze1qIg0@Fp2W?wARrpUjNl0Y#rX^yW-MtsV{abUQzjOwsXi-Nzge1-lHc2H}#(RnaP z%&vF0)LMMVMoCW!&yc{06HZPtE_s&hyV02D9G|tuz_ZclxMZV0SE>AQ-E@V;p@GkS z{%HG(B3T96NX)AL^Agmt2c_Jt@p<#&83=a3E32r;q9BKnD0|KYx2SD4j}94$S2vW# z{$#ekzIWzjQ!cJqyjSz0S z9W(KZn|#&9Wd=vHXtRyT{?-;p5}lH@0_6bfm}KvsYK)ykZ2rU$8*M zlKm9TZ;*SoXwgeE-2JG3|6z6li z2Z881k@u}%A=BNsvj$Dh{d_8M(@vnWJKsp5p`Z&6DHUl>DfeGzk_21M3-wn~qj!TE zwq(TCHgx0|!D45V=3P!L&FeJt{C>;r6BES?zjfTm_bw4MSMM9%94*((k{N3n9?r;d zoI1!A4fI`~mWQ#Bi!@WbX?_||ebw}`6{7&X%;YW@vzFk;j~_ifJ^l&DeR2uLb=6OM zJreBC)JG!I3J8>e@a33J@@CC2h!(zjoBQ@PBN$m;Il$ij)bIq&O;ud4V~n7wL|CT3u!xXMc}ix$${?Ca;r z4Qgy%MptV7X#zVotGI!@OakA3Z1WN)$Z4q2=Cdl1skIqua5K#;)#jq)?)Y*eL8wI&l+GH%`P)a@4w*AUz99yd%vbE z;ki7#eCbjec>#HcqibVdm%<5))^3vE+u%CPX@`2uv;QQFKY6S6v{E0e>?7J@L&o^y9u&XaQkY`S9$l^PDmnL`n1wMSg~*%AAA< zZn4Ww;eT(T&Y!y0w`U%!gmrU?KtoJyz%1I6x=4fVx|m`M&~5}$hMx7BN;jc8Q-Yc$ zj|f3lO9o>TjwKfFWd%@qWZ!9TE2hz9n0G>nL7gw7^Y_Oxyzp$l23$+-;-)7~9{4Uj z2Tj1|lK4+4G2klD7g-l!p6?*elt`SJc(2N+O-S+CAK6^#!^MLLS`B4okh!g8EH+-E zYCibUJL(9ut2`daV2688W8w$6FU#dDegMo5gZl@DoTFd;rQQ>M{ol4dYN@+J_MG*_ zRvC(}%GJh$HvrbkC9CY;RYQ61lJuKd5*&6m`kONb3#}Uz6H!sfFM15=_C}R@Wbxu=StgdfPVF( zrNL>8XJJ^LKyLOZ3x6k65Ab&JN)kVTgojd04F{2YBT#;uZv!s`NY*Ow3vf&xw~psZ zaswfwJGayC=fg=0SS_gUA-DT8SAhbm2I$E&POpKS5}iQN-(JCTS2^Hlv^Z^DL0(#) z)E8yKp;vvOoBy2A{?uGZteZt|_vogemOXw7`xv6{^7+O0@2>q#B4Qz|d=W*qeDA(i zr(U%3Wg+-BHnK5@66x!#&Yp@*gjkJ#(b67(*zO5?O7tr0kig?7_oIEn2u%~P z;-jNKEKq-gLOfCDhqEr%r{#_8I)e zBle9OL`=>0`i$O}W#-g_q+36_NUlhwHv_!C=CU8wkS%XK12Lvon9oHt_rEiVY#gL> za3j|p>waS;IVN6t2W!ZHR2v(A>5)>cO!EFIESxXlQIHRENQDv=$`CM8g{SXq!e7zk ztZiQB#0#Rbysgc!ETG8J=5g{qn!eTp!y4|t>GCxG0}j3ya9+<0pZapQS3{HyD12x9 z?*p7DJiy(|axR~Y?EW;YR9j9)l=5+KIP@m6g(+%Vv&pbwGNA_ zETYl&4>Ipgwmp0EhE&2!+hsLzbl-SLLBmLMOds_pG0{LAkz3Ady?yEEH3VDq7=?9D zZvb^Cw-(eRzjrEbTuJdH@ze#U*y-mL4iDD)pFB|uHIX7Mb>ov(r$c8Wp%~(_E8$)X z=>3AuO@5kv_{$(xGyIM<=xMR+1j$nt7>Mu@w_Y+@ud$vn3TwA+RkO2%Am~sasv+_d zv75VlUL=GoFX#9yE9=+y`~ms$10u(m3?x{|Hk5KA5z-r(PExlbNim)@%?+tUdP`Y! z^V=XnK{j9!;n^*k{CV8YcS`=)<IY)94I%zi+sgu4T&@HT zGd)4z{QN4p&V%XENgB02V2tmB?diHZ4hO|iqUEiV40IX_VTE7BNL-P|u@HuS=Zs&` zZ+N3GD;>DhSY2)MRg^V7ln-8__V%%Y!gxopkdS`$`!ubJAEn3jch%wM8p_dL66`)p z^LoUn?VonJiF>C*gkcu09VVan2EuUGEY}{v4*ZXmOKr^dU~BpU<|m=_4Adb80=FKw zrChG(az3SK@dfvwh2R&u9@6`HcKh4A-lpBy%P^ewy(}?&#Zct3B2m$==2}T?`(O-o zwT%QQQC8rE(jZBpq}5Bo0xI;Oqa*P9Y4vDFVnS(^R}o*&an!y^0_;0D>vohgr)totF z1c!UXR}6Z*&8)Y$Cx^zNg>H z3?IjJ`@G>|@ARIFNZ_zoI|_myyqoQdTJN^Q=n#ZoJ>o?8!63O+jW_nOT3p@u3Bi?R z%i$H^l}v0{dcP0;g4sYVDR8(3Vj=Y7RLi0ogBi>%`_JLRB(+8#g^6B}tK#@%L?=tuXY{SS~owD0UIM-8W=K|9ad&3m?mXsXxw7Jf#iKf)j> zTHa@92gdAH1QC)iX`Jklq&`8o&%;-;zUBT|V}(JeF$lC3Z6C0?%3%N587^TIxBn|L zYVc_>VUFqfEUfN`bVT(`fVf#T8|scqeTs>yzI*6U9kG8Vj~2U{P<5 z7(9bZmaM1>rk(hw@WzQ75ZPg5VnGWj^D4oD#)Et$r~I% z++i@MGQ8qohHAk6wYbcJ_NN)=vQ_%)A>_i>Us4$rvf@aoveRF5yg$4LufGl!U(DHK zBqCx9HqN;YX6}4hc+cxGU@%K5-z)ug%j_yskGE*U_%Zfrx%rP(!g|(&qR&T^ zHc)M1_yCn`O!N)j#fUT8%K!sKK@Ww1FP8{i<5=h6+0orKR-f82^ZB%exQNrA-y~y| z6uvq9YzIXVI`4DX!Xm>yK}e4lU$hv;9TUz1?T$K5U!*9^4!b{+i*;@qUl*_6$9_{3G^)r~xFWXG=`LG_<= zIZoT4IX3lqP>tviv*C{f#$U9zSfsJutrg&uGP@_nd7^A6iJBazw}e3)?7ez>_0Ep2 zpTin*+l5WFY0Kff$=39vadA4yp{AwW-nPw1Tr3|wyv)^Wj~>l4=ePW(SL6Hm1+x2I zdrAG{Yg4kx8HrpI@^s`tqM4MF)ZqG`nlfH0liO1+-T<*4Y9iB+)+}hO?qGU} z7R2(E!hD*+(`Pu}RetT6S=s+)zMaVL++)>l{i$&-(2}f+a>&wCorSKrt1PPaacVnm zxW?-8^ps`6(~7ZS>2yb+;aHh$K%{DS+6Pg%KWN4XCtM#&tnyN$jZ6-uQ`yTSf^n+n zHUw7Y8=rI``0^)AddP$5$@D-GQqysi7-Y8?<9dTk?CkuvAhLkoo}Mvt_C>Ud(1=*@ zswkaD|CNTq)w>*L9A_67WKcJiWW37rH_#PY^Q;3*m#wae&5SP}*8~Ykirbyk^!g`% zCTObAf21*a%b21^A%%ia%=*q$JwwrE? zzx?}1;vu4p;czihR? zp*(PKpg{?5K?Ra!N}qB*pEATSTtP51r1s>|AI^(7!d-P}k-&63q`EdXHsT(8qR+yf z-@%Hdz?aa-guKAQhcZ#FIwm#At_O>BjqM2^l|HfHv8V>s07%q{!7MD6R$RW*C|uODGOuAP@#UC&o3HU z`t9WAZMJj#^tQ$fTn2la3J4wn{c@(FPsc`~z;6Il8IW=yeE}GT2n5{yMeH4Y_@t`fpfOLuW=pk_2+6L(_w44c27y49i#vdO% z#BUMFiuod+t>8^F=KkKO&KQh16jJ7&KeZF2g_Hd!lY3r~g+-phg}-)R9@s5>jz1E8 zuZm^C4J#pST}?GM?f<%opUYNAiALyjrVFxsc!j^ufg5qV`bC9 zZy2Z?N@3@^J3C#bYLve~UNgK#FR2Xs>F`^(iJWD4@L%wqR-2tyllknNwdlnZjuYq? zt7xy4azai~Y)u#4!aSJ-St*lv$P{a~iK7R<1iRhKMDXPsx8?VjzIiVv7pjD{J&|zb z-h~*o9iV@dFA3&>oWnrSa5n-~3voSu)0)I?S+I&>`f_?Qdu7XB;Zb%^psXl`r zU7~TDv$zS;vf(>|9TF3|=TA-?8%hjD;u{QFP#1czU4WgTltN6WFF!~fy8n5Q1S4-YM*0V`^c&a56#!`k7d*|-R$|S;M zHG7@VIeKMR7k&_mtK)y6t9)m>MkDX495dJLU5uYbFupAlH<`w1{qt%#xt|N`?AlkW z#8Iz%{j8}O2*W!0D+TJpz;s_ydFe{nJ?udXGD1npvvS8+8qWDol~5$+*#dNE>Q9Ge zv0;zQ4Aj8gR;*$eU`VkW7!J2vL?%|`(=6mW%O(Hq4H?Ykw&94*DZ*FZUJt+$8XDX8l)ztKS8~@; z*Z-W}ILLDK>zhpT%`dA1_UD>atAaIsj6sqgXcRaaI`>?`I2Qq1t27{&KbFHy7V6-% z{@qfTVmgqP{Icy#@XB&sPf8cCqPXyJrEVrWxkSOF0PONwTnkoIQ6ot1`*OqT(mLWA2&7U^+K23N9)xb3bxi z01;hWI`|#YOF_z*_LR|OW&UpCqfvz={PvC4sx|%SuMXatG3bIB-lCpoq0r~FoQhPh z%AM@Y1yC?icp5MR{^}(+6PZZKeg{E7T*k=C{{8Xq%Pzh|9F0KGBkLNnHyG$6Y%CGo&{v?rlleem4ncLlhFS|AAQOFagdS0QKQB1FBwi#@?kV6UNNYHIR9F- zD14C2_LW8Fes>&{shJ?UWG}O=4dU|MvGcTh7&K z+OEQg^Os$LsC;O!Ff8-$dt_$LWuU(4$E@g!97)u_LeLleP02j)5ppGUAF>I$M#ROB zdHi^1CF{v{YrAZK+aT3buJr4g&(?{ zYMin)6s)XB!oEGwLxBDl6_II_r0O%H6?eqM1ZHML5P?QbyC#m^(WbZq95i5{EsvQcC74(} zFz7w;4u1dDY3%>n!fbM=PTu(VxM7Xs;msvBCgJXfIeq;ZsbJ%OG}%lPI-Qm{2nt9P z6SV#xp-Bl%qNNXbe16COhs}(yu}ET5%_+%^YA3(T>&WpR ztpLY~AC0IUCW%%C>$eIPsba$j!0mf5%1~g6x)9Iio-_DTxyS+Kxut;)=eCPd`L5>G zN}GLTW4zX8W6^KL)7GRU}DNM_HI=V{#qs&lgyL*7!|K5L}u z$J5xS67w-WXQNcR%fIVLG}1g}JL@`|FG|6Qd3thwh{Id zsPt7i-D6pVIXNw`|3AVsdPuI=IZ+qhq1Vbh_4l{-pOZeD%P!=rGJoFGMmCq?`)vG*|hnY)%mtBs8F>mS?o{}!NT_t!)ge-z>`gZZi5PRm$a^kngNTSgG) zWP5bdX6HyT+BRf&$KPNE*L#7X0u=`*8-<$apdEzG6ZqoE@1tU&tLq;CXIZcT;26&->L&&{$6$y;tT$> zUYcsBK~L-cafc2rS79RQXj`wg9~ntlM|QPYApV7ltM)~LPEw)Q!O+_B_qwMi%G1KP zMGcdSNf70%TK&Dlq(K`^+ElEIxA?LL!(8TgUXk8U%=teZTO7g&>6W!|Lm~J=quDOX z{nOLg_2S;N%EFcJS462il{=lypnE;KMMzO*y)=H0rQJvMoJe2H!9h;cBQaclcr)fg zQ{ehyUA{SD&#H;iUkvzAJ$?n-Dt~AsAu$iYJ$IMkdxyKza~!$j3n=P@=gbThPB`!~ zRy#}qSw(5s+ym>CjV}opFmAu}?mXw&n$-DB8I+YiMx4G!TYJ&9k%eNy25d@DWj%uz ze8(1b+LLq6?r!sfemRd+^-+Y->k)i>mRa>?>+C&GZgrKbFt-mjR_Eb5CDROb`mC~y zerhnKo`tePYuoffvZ}9a<@7zaT=3PQOUL2yFvxa?lmy>zPWBr+t1s=9mFPmZ2-VMD zdBM8qqHBVi$I{+i%IKA&n+}IUvn=&!Qw@EbdQj{>Yr1kgeV^G|#OI8L8-Poxt1jAS z&alY1MJGa(&h4~30IDTt9gzaq?48c%uq@M}uT#YAI_duH$y`HuRF!HHvGyJYh?3-` zP+q?CY)@M8T(+QRNvQN<(YwU<8jFlLZzJEidMqc_Gg9rEJml@M2oF{nw+?=fENP~H z5x>fJT7X7b=?le9rr|RB?RB<+{!30DT{23i#?`#8&Z0G zp?hC?a6*+;Io_R&NzKB3VQJF#VO^L*EyImJuU~Bzi~HmOc3mgVMkFD-TiW07!C!=z zNJ=ga;ZeUjm$#WSQfhFt2a=eCdRW1ws;N5H>YPl~?O&COcL_5n2vT8xo|%42LF3Z= zVeS^xNb=UBL4Jwwm%6rIP0qLA)aP!?x4D{P8di+xf9O2PF`ht7y6bFdAko8TFN;2u7t|O{odEa(xRt~Y>`5lp2{Y2Yp}*LOKK~&+ z{sTTiC4b|dX)Uqb*f`;G{ATYSQ`#{j(?(XjH?(P=cA;947?(S~i zVif-X`~%96Pm1r|yXr{9XB}wpZ+I(FRoi#(kh}kUATTM!z23dk4i^*TQ*_ciNrz3t z5W4MOgGopuD38C_4YbrHgbFIAmb>rn7pFmmXdx@aenw?X2nvotps7I>8et1vlA-m9lAE8q!&Dc z_Xj~D&i6C^rQQEm2EpfriGK?B=Q6}s@V&eNq@4)T0jBa5sQ*3%E=EAU`{&|66%qBI zX+x9ue5X_i`u7=dF?8V5|5}0g8nppemNVnmym@AQ4)$+zTQq?A;x4mC=uI8E9f&_e zcu!-;E>0gqOM=DtDsP&dg;0hgCI-%4yxft>m)lmR>C0ScOBiZ`Q^M|z@$PV;YG#ui z-8Y(Wb;b<6BJxOM%k}@>*G=#pLip!=gU9QGO$}^x^jKlYw4U$1)ws_U>%37_RW{eV zarrqpQ|yA1b-_F#iFF?~`mx7{nUIP%4w8-I2<;b>Af$|Ug2wzVwaLnr;H35W$;kCi zUYtzWPA`3)+l0v`$CHF|A|zhXr9?c*OJ-Pw-Lx>6!f+L+e67tTfH8y*w@w?h>=&2x zB!u`K*I`-qo?i;k43GTi>atJm)aDDZa0Yb~VfzjLnL&uJs1%Ut9F7Ib<(jf_N%R_V z_!O*wK+_=I??8Dg;Yfm$;j#VN8OYGKdv-2cD_ZjqDJ83)4duB-il>7^Tm{q8{CGA<}8*pHF+u`tJC|!L&IqM)q`*1 zePSbpnu~L0#!{fLKhl?CfHPHOyu&Uaf}k5e>HQtV>HF+e*sxW{$(S5gNS%J4&A}(d z(ru@bX31rwm7wY_7_`?G4LL?=J`4bVAsdx(&M$@H9gWvmoBP}7l9g*z&*;~SUgTEChyb0W4$+y?56zEhwx_SqCx`mWPIcl# z*vk1`4v5c=D^+Bt5|`ML;phlJy7?9Ofqyp-BR7PxSoHTB#liD9#cY26G_je?lWjw> zuIirwwkkzx*87aP7~#*?LVJif0?cUkxBwa!G@)X?bhwmnmZ3}>2fnp>pj1Vd85is~ zyxKYkUbsHq6W=QZOO2smxs0f`kw$$ew#aa|)tDIFub!9QOc;0xvunbjcg}AQmT_~m z;b$@Amq25~h^?%#|C`C-)oA&_>e6M=&~W_Cn4SHRvdLIJE}HzkSlzD;SDz2gj5mb^ z_)&S0^UEad`>hA!my-hM4#mFjqa<$7+^4vSyZ13ft<=?YzkbS@><&mf%WzTxJcC?J z0*i*XJ((XkM^5I%0H2Q7I7*KuE{CB^zRO$NC?_2t85-|YFR}p${%3nE;fexF%C>X& zY)J!$*d0A2teGwJ$?(wnW1#zOELcdtTCVU8QQPMoASMC~;a}>k*zL>e)U8>h?Y|@} zbn`V`56k$~cU!2X<}8F{)VW7Y`9OB0Na5YdH%<1f?CN~wpM*yUu~F|jUKc@byxy@Jx?r3!pj+CFpZu?_^NNK3#D;-4Qo%^gt$~^L8P6k^%KoVF zK61TJv(N%lt(Mq6Nn9DSo$N%uAenx#ahbV1R3>~Ak902cV#c{p{X1x4;tt<~e?)6v zvQ`3l&Yne?H6XrOz&ct$b8`A_xL45RJV^If0y~B!M?^qklGNv?k!*#?glgJIRgsOO z|Jmthv3IjL0Fomq=zcc!THUUTCmJfx?)BE>|5;)0buw+oAW-6W9q9fEzvlk`xrKFAMVtyT-v)jeT04y_ z1}8Fm(O-wqvv0m_;Xv*`6?>sUEFnm5bo(b4U_*^&@|+1Bj!Ppz_s@y@DyBR~S5{tq zIGNQw_~#|Eg}gj-0+d}B5?Bm$J_w13EJ^Q~`&?7a{b*w2`nx>zK0ubOLs@eO3kpWf z^h}xPjb((lvbo7wI60ZH)=`C$@2Cwf#k#Q}{kKgnm`!|m;>|S6Yoe0 zS0SPzNMDF0&?eS@cO;ei*>T(Z4FBIXdWCx4;uCAPiRY4goBQ(3gwTGE-sF5tmkB>Ug+4tg^u2XY&wD zYT@YUX#VPpdYjx|^H9xCDENS=5G-2ZyVDg31!jED{GRH^+UPLVTH%Q_He0ySWm1s{ z3}uSvzB@wC=jalZN`n1EYv;f75`_%)T(bVf|ExglEm1VHY)Lq^zb=bQp%77D7)TUn z8VLGOXr3AGJVQ4ENh?_J`uYt_)RnsrzeQKHOK(ml9@!)F2*` z2NgB^jLoCk3+l(5;V;$%{ha|i5IrF{67G-J)@)XzCJa{%O)fW78jV(6^dKZXJHxIn zS=HGx)jsdBb~t%!K26mc!4P6Hs2k@K8d^8jlqNELwI&;~wo4GTxW|G}`Z@NRb-Q#r zJ4s3%jA}K)Lrz5+?7zz)!AlD>?L5z9+SCY^DuFDl`-n?wBsOAVLjhR`YA%ISmETP| zh)XmO)8EjBBXG**=$T4|diGL-CCAvH>1smXUt=XnbPosR?}M&dLn0LTwvC?i*g8gg62k@bM_`Ad+$^?8n&iDouesHAw`U_aEuomOJ1Zoz&0cP;*B$K~> zrc{Hz2=tf?!Mbx*?gJg4pkVMjk7oIYjVCa!1cr{1Ja;qIm(d| z;v3gfDwSYtM9t!BC035eaOvsSm$f*aO-RtU3F^mXiv#F;x;}Y+d-`xQ-(*|3;p3w` zwC?nG2cbSgIh6*yYlxmH#{~~?e%Yz3a+&wmh*cc8VB0F97eXI)&t`YnxG~!lK+95?^KP@+pdhPnX@LvIRX!sr-$Pl<7r)?#Yq_3$KU{5V zvHc{GKz?=CKe`8TYNC$+XR#A0pu-^`N*7o__<|&;BRZbV>-tLOQsl-M9rSP$G6}Uidn>xbQqF zD%_H4&fnDaGvq$hWq_U7bJc80TxK2ckM|fS0#h)rrNIcFEyRgo418*R?EzTC{R3!A zO#Ir*k=fSj(sdwhBp6GHUfBQX1FseOI&sOmMP^nMvHtD;-NdTd2b$o%)G@n%AaXeq`HI%No1JjzLPV}!mAcI&EP~=lZ#G?8FH?WZx zg{q8ZGlN+67AXFsI_;nNqXpN{DD#&s{y`Kt5%1mvN35hkm_PsJD4kGtv;coZYy-x> z6aEkMfOCNqu8m#rLBE#jhh+SZPCCF>`RFEo`j6jqLiuF8qXzJ;3DW%AC2&jHiQpoK zU~9L(1O8_+_rcGBtLpv#sLD$OVYFITgp!R-Rgv!ERBEwCpUHf+HMydfZ8V+hmx|k( z?RH%d`Igz!Q`UV(6snAfOosI?+I1X|_y5|;gPWJP`iPFcf5!7`^5N)WR9q8a8$-o? z|7oU7)we>ElR7S0BG`HVqMxvkge`Xe@N-V7N@WOO2f+|~tx}^!SSSP|yQ-=x%BQdU z|K2>CuQS019Suzkg;PBgVJE_F_Vl*x3n=08=JsUCZg2E6D4H}-!MV#3XLDv>xaE&K+=Jp<14@B6}JahT5|=R zWbN&4-pF1}wawOdxlu28Jx$1a>+Al$vg;mi{Oi#Y{<yGgOi^Q8fO_QJX#5LoO{2t&V|66dot218YO}Z zn*62LL5q3)b8clL#^Y8nQQKv z(i#agdQoI@4Z4zPWH$RbPy6Wn=+rD%=Y54cTAtG3Wx`@A^H8HHhmj_xSouU$62;_` z)j6zLoyy*}5pqd*cN=AJNNbP504|Ww| z9I2z%ELS0F+2B^Rkdo+B1i2C=ibR`TWc|W2af?G6J?EzVfRCh!L-wLhp_k(kn6||? zEj`6+RbxSP$N8jBcR^~)(h)gahMPri{R+h+TYW~OiCVHV8M#>`NA`t zGhiYg=#ifG(Myu3cFrSI0sU`s2tVW#hd>(+>|ZeN=Z+Og`?uEZmrf{N zcEMb~?vEAAL^}2fhgYeK3yI0(u*-Z$w_j{G`R4w7M$r8cN&@R&Lwg?K)sKK2hxe=7 z36_U6?>FM}G-W@AyPrTHGCcKX44`on80u5+jHJ$0HCI_2FV;&OYZ*3(_+EHt@2Fk({3@}}`Poo7Ws--+gn#~Zyo z-i+R-vY3CI(|bqH;IbVp0tNfWV}M6_oy!|;r;A-NRcbUX;w60=aV1)4^Dj=9! zb|Y+4q}ub%m|dz*C|U-qh4@w2FZs>oP7hQR@1i=QLazzP*TDO2;t@4sqF#DYwwwI@ z0>=GiNAYndQOjtgWNm+aA@w@4p*eIx#?Y$~efV;P&6gSj#F>h>FG_R@0o|ME##0IAin#_zpoEc`=4e(& zX(}r%os_GQw~5Dio~g;1rTwlH`y#QeLc1sa#-A%}jvF7-Iqd@o-1C~FAS7?We4ou` z$6DHPt<8~VXE;4kJdQ%FDAn$B?$ zol;Lh$r*w*_7XAs(j51Z1VbXuhC{LP0T561Bl^}-ONwVCnRZhov6NS(axJglgqwc| z+e2h+^f?5p5-1|ab~Pzc{-aT?QJy_Rt_8Ye4S0g$u&LUnRlaRJTRBoudS=->!>y%R z={5u+_1Xf@2v}!WUn|At)P&tTU1|CGi9{xYlSGSx{k;Dhf~?1Sq}Mxr(G#r=coYBx zomyS`uZdg|Hu~#C2ljdkUuqP~(k_q$al>X!Xw;|ObIRx*>VD`Q*qv+%+2=8qlXp~TuQJ$6#I@a_1E z`Um5yYAWo0-M@U|4vO=(s~Qmt0U1Bqy3?n}`(G*c5BYc{L9HUD(o*3y<@Y!NQD|Xz zJ$wU?ofy1Xet+*Jv<+NZU=gFS$ht`&6h!8kkp3KO|6E)h!e|1kyu;6Hd%iS6a3#qR zoyz+2_OoS*ggnYtj2hVM2!W{Hb}ClSCwd>CVG&Dp;^XmHEhv!39sMgK)gy%}%NfA> zlOdf(CXpGnm(V=m&wM?=r46bG%2~}$sg=-EjUh&fh&v0a# zV$bJ$>%HTOabxL(xc^?nN`y#(11FQyS^gNQ&i)9idYK!`bnAbTEf~{rdwWp=xKZb;1w)C~nEe?VC&pn32>Q92!%cnE7g*6Aed?CTAqL%hYBBm^7bu@T~ZJfKXO9wRA zooIh$Y$63zxFnzVrtk&&Lp^JDksB`7Y2klV>%egtPeqd&aQpM%T#YlhPYs$gv13w&y2oxvWy5Fg@I}|7F*D7LYgw zr7$=Ap6y2RC;XmbcNW3ech$gtD>NF6v$i_|Bs}&o1WYPH_s83U-d;gmfOgc?Q<-Y* z{#l2koHr!&ez!j&iAH_NOx#AQK=&quL_f!htDHXqCNtwD*g;=9g zRQtm&o_H8YAXhkC{&qMb7veq4_=zhr*E8<&-dH$ zwQfcSu5X0^LIN~tjTVP|GQ_=*OW{ad@u5WeLVxOCvQM`s2f>Rda_Z`7-G*6399Vj8 z_Zxx55__z@cNbf~70k@aVtb@O=`j_}^eM4d+K|8C&iOrmSy}6SjjDi}bkF9I>}Yp; zr~y=Hb!1d9a8f>d*0vYeR`(y|-&#%>DzxXIz~1E0EMU3{@aF+OlA!kzcMPo*R+8^# zJ&x7o7wf`Oi+5`*R=;7iU08S?F1I7;i?xb%l&=z%;Rq8K)~GmcuY@um_4mbL#3yp& zeV3&mBmD45IKGrya;iWwYcGXUXz6WP=!n%)W?_oM`w}x4%jTEqf?)3)sM_r2Ycqc0 zm$=k;Y89$>(KaKnsKS4c!eofN5)>(`SY{Sr!$;{$@+C0$cLX8d4i%=%PBcmIFcHZq zq&sI8xl)N*`d7(hVcL}GLU&J#9NN@|$+01iZ1?K9eg9hx2rE}y zz1&-rY%ZS%?x9=%Ab!-GT%m})he z*d=NJOeT7d-vw4P=w6kJ<@*waY&HJ^hA4P=D9J8(`(IK&>T~JZRtsCv8V<%YkM>sx zNcRs%j*Uy~$z$LG4mR&?KtLC< z>RBMtWVheFER}Frx@0ERgJe3RbahTxfm_H0j0cNwS4Cymb(8UUoj=K0VhHA*t#zGS zJG@ZT(RtzwyA|jEv>IV3U|017D+7(MPFf6^1Oj4zlkJ}0cR@8yu=>4YI|NHZXTDg6 zrvG}oWZCU0qUNbwsY&~+hMGX9arkUjFAiKsb?!1DE$1DuT&U4csPQ6bY3XRy205$_q72tJj_c?7Wm?#P-$^CKGsnoojkH#H6n@_J}g2Vs5`2ZVgGJ4C%X;tGnu2b^3B#a!g$lTj(=j;_23v3;zZ zIQP&vNVjOiOrC=?+)C6sqj-+R@?eTzJz?^)AQNWWk%|1Z%lNM?zJ`Y~!@^W%OrZYM zV-rQKLRY!}A}s_?;y9@bC%}BTcg4ai&?42gVezs15b(Zo)tT)$Ml?d`vS!l!;x2-b z2LYlsZ+eZCSz%n?nX#QlnbD3vxsgp6sf9+nX} zmUubzoQ2vbIVIghRA^mzhe&YwNAPQZ-F3x=vQcw!8QQCK*l=TF1j!(8H0-<1W zk!4Au1vz45J0aJUR)A5b3drE2!9A44MuJ}TCqV|U3P6P}Y6zLk-{t+j0{>Cea8;cX zY}1J)i8L>8QooyWmFGX^U`eRKcIe-h{TraynW4Dq7se>KgY;f{ z2pk0UgsXz?=TT=<`MQn*dC(s7t>C>bv@Sk4q=0Y1_P+%NR$)2`p<0=8=cC}5{&+ib zWJ^QY1&V~+|5Ff?qy8*H$$^B@;s3P2Jaq7TO~P|xgIoFokifh3J`#KzewlXI=RRxg ziH&T(6QoQv5R{ z2=srm0`48G6HOWKL|qodk9|*%UN*R4uoRiI(QB()9=>Nw;AgHVROJ{rs_|4Uw_JSP zUpzaW6Ua=W5m}N6yLVYcIax))&jjZnjgz8Q`M+jOi|+lr-vY;TfMRn~sAjcAF=s0U z!RX|ZwdGo5$Ex~umz6V*bRnvOIyySjIr@mPUj~1AmNX$I$c|-jQM$&dqtBa&Jzi`> z`f=RiXScgQ$wyGAXaKlR*^xdmcpY*+;Mbci$d?6`X`+rB5%V@#t>0<{_OYOe2CghL zyfjI`U79>eE4Db8^S|~4q7&tAWZR=0^1DwEv)s3k)yuROQ0(54-LD6Wj_& zTSLB8p53%--z69TbUmeECAbGhOrTu-+~2C+>Z9AZ*Kf0%Xl3>nlfKxD$K<>EnSih~ z7e^UetWufr2Y+5bHjFVz%F$3yLJ19~aq1&TsW_;-WvO6OsWGO6B+`+W=`7S3*q)|v z>u(k+Hu2*ibU3Daq&y+DotuzXQ$O)&x(ClzzRsY2#Hg7U@SGZU9x@)7A2VKT%*JrM zfGb~URahXUIXS&#B#mP--z1;TS;5OmLq1WPtb@-zSZuR$X|rX`e^uzcn2D1q9__hP z*nurUh(i=D)!@5y1y zJRvz%Xfba2k7aH9gRPH#=EgvLm63GYw<90z&`&IVByc??F=a5CsbO*UB^D2 z)ACH;D1iwb1nfXRf)fOeW|3~d@Pv`;yz~9&5%8gj&lje9(dT?SR%Y_`<;lOkn__*@ z`#r3nIux*-N~J<_UTGOy2ON7Q=_sP;_s|xG;K@*vDMPutU(rB;9H%RoZ;r5tlAq zu`cuRJt{Bb7EOP*8__=mX-l+{nCkiC@6d-W>&#Gp#HYIxVoh~45WU?8Ij)7~SSPtR z26vxN2%YqLtxzu4?pj3mXT4+l)%^sy4_AAkXBsVc*)ydoQx!Z7!EP`SkCLrL%D>&H z9W>Y4-r)Lv|Cax$Xz?vi4&a(2%4+}kA)2R*5}f6blO8x0N?d|R{+a`hgH3%FVRk8g zS^5b_VhSqAs`o`he+_dN;XV4i6(jT40rz%k?pFdn6$%-!v%|NpyzOCOo@4TZE?P zi#;ymvo0>D6T^CHJDhJSMb#)>=UjOtgMr70|hG^Rc6(*C}Qw-x`uOSb}KYBOUrc6!7{G%N}rDc#bLqy z>%p|8zYuxk&k4TAA3Dx{t&My$EjcRgRRO^I<}=r~yfL1)v_;1g@TGt=zfK5d0vBlQ9r4H>LM=wXlM0Ld)|-$lg?Oq-X?3{$}z1i9o;cNoVI_kWXSA zoZyoO))#`ZpJ55zfV&t({7j^Hfy4_`P)~?lacOI*cYrG~}`x zJ5#=a<>L*zg*-9z%;2yEqw`t@gsNR$2;L^${)l`qX>6v&>*1d4!t~7lE z(WKLbGK6w(V4)UuG+WY7xm=Cy$_EAhSxdXzmrR5{O9q2N*6R;eZVhXUTBFh4jZw3x zy>D->Sd|%3aW=Vv7sPpu;lj8Yk!+<0YohU@^OiaHaF8%Yq14$+4$6D z+NZy_LSzsP4)mnjrKSqT?2`5U76?`7Gcf5bT06hl)fk=;4CUtuODemmJFunO=_XX> zZ|;=Jy)G{lo8;Tn>EF+9~9X-9vo zv$#QME|eTh==#YdH|5$UFfV^X;gAeVb^a3aAz`lr+jx7zwhIv?3ToR_LV_3 z(9scA$}d5IACk04Jt~z*3OTqGrp0p_88F-`o`(L!=h9y zClZ(Hbcc1a)+CfPRoRR7((D1NRIC<{K!w}|dwYyg>jU|jVfye4HHh(9BTyE^!*qen zdxw-?V5sVw=GDN%4eYwe@z$vxuXXC2gGoRHvOnG&iGXeET@eO_m?(O+)#;`CMus0BO766CxhRPz^Ik`T(^_bcNedoCS!yK zH&0U%wyB4&HiBsUS)yxDDSD^ds%o7mi9QP(_q%3`gA}iu6@#C0kt}fsf3@20CCd&e zEpVIwS9QI2rNz-QTaS>_X}s9zQNgIThQZcq>6babpIW`i#BBMG7s`n8*7D2QA&iKq zF|NC`tC)rkfI0jr-}YMkMHDz5Ah#8GdPiix_=P(0O|r5rC^!Sp|79 z2beV!S6M_&j*;?Y(`74E5ke>?fSKs!*vw{N9w2^yQt3XOHTt3mf`#02_B!vw)@mFX zS!pwIAbjGL98&Fsh4n~NtUFgMEs#4rhIlFc+kr>yl;4{z@)xshn=A8kQT>k zYl{OJfNu+j4^fASpPb(Z>p4Qh=p9Q}Cyvlt>0YY8&KK|`-mYjpw!svastv#I>STnB z$1+TLQ)<;UtGTD>*I zfa7a-4*fh4bxTi%BxJd+!1uM81n$>z)gGZUxuVe|cHrE+!kAdJw6LjM?>71=dw;Ei zB#!+a4`Xmtw7o1W)3<>&4U-?dB0})ngRa0)p^3?S35|kt-Jowt1=p@1JOrdNIYy`- zZP$xqQ_Y9e0FY1IcT;wHa59zh#h~jV_DaB2m6-O$X5Y^t4E+1yF1}8%v+09w|9qbh zaYBe#N=7kS20R|ke(nwCDzI2>B_0-2snoX-JOyzmaV$w`teP!MB882wo3R_T?}9K1C+ zVNp7HBBAuxu~9kR;aLs$V)NjmVi{0wdQAL0j`h(0(fFv6+?PP4&FSYtAxc>->g8kvUTrOHWGwtNxMWo6u7w`8dz2y9isR zNcHh{mgCy#G0oHRPU#AE*N^%1k5t=N%EYWn zR%M+tq3;W)IGt@^6$iT*pW4}F$+dR+9_}kN!hkM|GA9LBw*j^C8T3P+81;gjL_0$u z`>pMZOeDto?{-?nvUdfOe(R+;S; zQ09^!NJO2757#S3qOj;OT6yy(v;Pb(M-7Q3O*m0t4`;oXvw{j2vMUBFbeYVJ)4^n& z$qW^mz5wW!lzOfLQ$n9;{S0~M8Db}?@`D@!hl6@rKO#=-cL%CHYtEZ#1-icVM^A%M zyWQOQjivyk;u85^&2GKk-;o{$YxG~K1sD3$7CN<%?2`)OCh~oCd(?aT?!JN8)fuzW z^2Oazu`dVmzm+YIy+)9pVY5NJ-zh#LcDyTDa5uXR8$U{HKP+uu-(`h{?G_`0r6()1 z_c;TE70^B9@Pkt%&&eTVJWrOQ2NU%>*P!{@QD;!NTREpu1UQe+a{^)@b|4^7sLPdL zoq4UJotv*7q9giTZW3z-+|Io`j>;SSa`efr&(_weER-jQ0IQb)J#~tsVKme(_$LEF zzr1~n^=NBT5*zGi5^TRR61rELeSXPmeddwHfGXYw%!-fhE)UyZg(xZ3IvJPbQINvT zUw*w!+Uzd|eANAV*f*fQDZ27}^VNO64gI^>6(iSjUh+mk6%*^Lw5haK!J4#sftn24 zBU5+o7)xO(2$w19=TwQlq6Q^4Y(9-A@fK3X<97{NQ27gnGT+#)BzcE`F#h?SbA^tE zP%@RsnZ46g%}0xRjn-iDz(PHOPX)M424PpLEX^wA%l!spaBUt3rR|4E=*hE{2oW3* z4VG)ti#^zwo195rJn;9A(AngsM4)kM6*bs%Y%JJv^z!8I!l~pKSa}zAfWFL=qR}Pn zRyh^m`>MAT7N;S!2VzfScex*-$BdUk8aJS@h=_uQILtw?YPrXps8jANBj=(0;ssq; z6CSQtPSqleuU+oFNk$9EH;*eHL9ZEd%hLzZd3yE+>SF~y6Z?$0)Ka_4{kp};o}+i4 zQ6a8uz!K@80syP;A8+uw6QS|gHaU=MXYAc4Q2)#`EQF;cfSM6H=R-ZdO&dwMJ@1Ji z^^5WL5LN@tp3PyRrhV5=+l+1K4ftB6Fq{(bv9R=ym+8_r});#bsZD9&ogz^L;K@d%XdGb*-z3 zyf<{Lqy;T$tcP{c_=W0qp+iKK*}j|SWM7eDyZS>C0uXn#EvyjLL!ph;Fu&d1XB(0% z%Mz{gh_MVNK{d_L3pMJfzx+fey})pQ{12;j&-Z;o>>%8F>dUAe z)=TWKmod(zm0~)QPN|KKNY_QG(qm@(FEQQk-F(^TcxYPIO5mW;LfOW_4+$p z+EKpKx}~L|dTgzcHTo_D(J7~-s;^Gxwy1{l)mgYHK!^toCA;Qhp-3bF9TvWsBa=rj zoC~li;60*G$$J{IAm5i$PWT$L?eLl*SEH^6{SjQ;(irp`gaEH6NCEjpFWbuuYsX5p zw#aCnQ>7Co{z|RKlFA%O8BaG+f&#>sE-jc>rg_i7W1WHkH*h56vd{+oeuTw0o1^xF zFw`uJQFaGdBvN>|+<93<1^dQIOt|V{CiJtJ{z~-O@6__YSrK3SfeNtcje8MK7TFzH zrD=(fI@vtK0|C{&mZ|1H0hB*}nRRQyjM^!ql-v0By@2yx$&dlKfocOeN$S?xC}jBa zD^F`LE>rEgt_Q-;_J>y+R?Q~4YV#vcO9u)@BL?~%6#9u@%|)9XL%Bb5`LLL+Zq&@h z%otraDRzi6%7aO zeb1rcfL?O2qd|#jz;T&6Q<`FELg7S`;vnNWGd;aN|_fKN|2;ukGEd2+@bL=IN=X-z&EYrw+B%T_3*Jf;sPf z6nB6G=)~{x`t!CDLCOhdIr;Omfe~hzshU=dq83Iw762>T$}_JpY!z8fRo==?uIv2V zYC}Ctz@lJ3)a`wI;Ih&WXXb(rQDox|US>OJQ;D-8wp5#8H3xnye;vYmG$Qs=4 zF!Rrg@N>+*! zaL%=gap5v(zpFQylgs0A-ABphWp=&M(10f2T(!^st3`Arb6S+0Q=CmTG|X??P1Y^s zJildevG8_KYrD*`1nk;_f4 z;D|8Py(|j>Sh*>bLDD?ExA@)}xRal#`H|k0g44)uJNWXv+uz1_yv|r*k6l1^a-5H$ z9_7;QYJ}BpqZ>LK^-o3{|2LnH7vPgk?0vv?x2DDjvZ)m$vQ69qZGM=hMr=JVB}C8c zUcPMa8w0S?C;f&8j06j#W``|MXU?ixa4NaNNEqkgrmbTX~?W6FqmL{eiaEiovS2W^F{vG0=C!o4jDUZ?Z8eb~u zvI$TijU%IhLH#>FG?9Yxn;6c3^>Zy=9XH2h12h7n&vV7dop&H1rcIa(o3Q)522ekX zflq8Qz)-D?KU4Z447IW-o>GUR}& z3^UnOgRvA^w-D*{7C~qPyj0wB8@ai;3f-C+#^c_j$^6iuhz{X?IQ`E^z&pLvg~80N zztJ2oE=UL^EASyMegNZTj^{kz=TIf%!fq86tfa*b&koxi1t81o>yxExc|JN`kL0K3 zXnJR$_O_JY$;G{153pveqCDCK76v@}V4>R866<6X{HbZZ^GN zP7^=XFlvLO)f@SgOs4Y_r0~XfXND%r8ho!e2S|gtr{qkl=+Bp9*aLfE8w=TAt%q2zi7+Dx*y=KDN{2eqzQBgTsszRPHhMv0@ zwpz=#Hk*GmIfyZx zqfn*wOEoz%X!?gQJj%zW9q-l%=6OzqYdj&eXyfcC?YA#9tHo_!_2v5KN)uP@Ynher zf#F-BHOm(P_Asq5FW-Wsm#ywSjRg*t^Nl4>zI8XlA=a~GNmX${LpnG%)Ho#2ALf&r z8rT&5nhbpITM%D3J#}18z0dZ4QhrgT*UD{dXRo}I^v1tzZOMnt`hSxQUhd7y6LYIlSh zKl9r)v}pv3c8S5(?{I%x`(k;ku4@^v;0tSiJTLd0LJ!uqaCd%d6gvU;&3B8WeX%JC z2o4jA6fNqUb$Lk5dixU~bPuf@wD4Qzg_<5JMjZVd;vhoCmV0dbYA#)L{s=l9L|{S3 z8$JoG6D1O?*o7L=s?}Mwa5T!PYo!x{*VN3J-QPE=UUWEJZqmpZG7gfpK<(FRS=qwoE?DKc8fM~es{VoO0pGNwCwB@K_yYZL zbZ_jRNn#63ZY;I{tiAc)?(h`QJi(Q6RBMPKX^ zy?4=T5Yc-t(R(L)?}F$(ge9?}6ReWoxc7eV{o}WP&dh6P=FIDy^PKZ}p0|`R;&R#W z%bd9bY+o#zp?{#*ASwQ12>bMz`Aq4iFG-fxYwG;(uiGt;;(G%pmvfW!53Y*8J=er7 zq_1kVzqI8wH7f3i^vE|jKSC1=Zc|?=+p=C+vli1fJ1&5=?1`I8HF@2RmHcV7F#+ud z(a~D^qm}CBatzb&ajty3@34JuBk5NRyd6ePy~Gn^NpGRw_F~y$CyN8v1v=e%sx;}R zmUKcZLDIr1t3@^oRY-V1MdxV5>9KM~^OoiBuieV2;{JZe0RgWVD+L^}s$pH7HLFGo z-oM&*c?r9sA@-K~6Bl=Ld>7EMwP??HIyRq7IB< zSvsFvexVNQ|JK*_D0s!ZJtSJ{+gXyMsx9b21UB_`RI?I5cGj2S8@3ar&r>;2M$fbo zdWh#-q4+dY0LB22pA674(27%3SSlb!!&72Nwwdw8aJbd#9Y z0AXcc&gjbLbHb1h(9kM>cwAA#jDg02)@0-C1Gfn%?*!{M_^+L~K#SrDug5MF2Kl*aF%gk6;p4_5{ ztk!B`J80^Nersk~9r?6VO-7bXj#DqO)Q}LPr5Aa^|8}a&-@or}tE#Hb!79lb^riB$ z^k-wZFf=~q%!K=6`T0P?al2@Y7)BxFn(-9~V;MuC_}8_zuI07$@a4wkR!F9(BKd9k zpq5z@^m=dfQi^usMf2kg^!MNi#u$;O$+w}wU|L&puDZO{0*n2E7Clj)PmQBL^)Sy& zL+j}MJxi-?{0&Ph@$M?xyj)~i`B}+EqeL9Gb#iWAvcXzADf4=N$##6|cUhQdVdejj zZ;{kjZAU#F88bNzKV;Kjby7=o>_+C}LXx#dkKTVy@~Pb@T{Ds;t-ld9Hr9dmU&sm~ z#2nn|CjNq()U$Z%!&bZz3X__)jZkuw zgnHjt^ofv~l1q?Wh|->7aO+4|{TV18Pma~=HSji)HDul;PVBZ9w70SWgu8{VB>su=OF{+smJo5nt{_FhTI9nwHo`M>0T@11)U%2 zO^J^Ty48e%aXQLNVAS%GDw%G$awnp56I{q*B&E3wi*)zJ7in1%P~Ksvao?vL^Ogq0 z@n6AKzSH-8PC&IJgiXu--S=pS*Aw+pGoFm)vX{r@VRm1pdv78!$Wdr@5#Q-WxxV43 zGl*BF!En{(1q<>R!+y-VNp%qoxneh6!v%6KIQEYU+LFK3u4Fu6K4iI zQGbN`JUQ@jz=Mjgdsobh;tjO$@9a1lX_c?X&UjcJvht*EuGf0WrY|`bIWi9ddFn75 z_u?B1m3RXiW_;ayv_vw03h6Vn4RGK~r(Ae<=Es5COD2+MQAF?G8ZBWe9fDzhM;@~;{W!3uI{T0xKS(8xPHSFB^kcl3s1E&uDV|jm-6Yv@Pwl;_e z=^J2^i(m61VwB1#F!dNHI<_0fPEDILe@iQ^`ZTTDqI{;$USO_nd_z3rvQ5CA6|-&n zZ#efAAlQ8zYu<2VMmVi@`U;=P)!qjL|Gu}x@V)1nh=M{M*zF<;bC*Aj{WK61%JHye zxpJc60Wx=oxmqn;V243e_ zNAef=DU&NKIph)jC-TWf!C;|^eTnMZ-{}HJ6hBll1&mweo-J+w8rgluz6v1^%^XY$ z0AGh!FO?m>t8b6mL~gcc{Rl-ub;PmHey6_~EAk^vo12?(1Jci5H=7w0A9$-Iv1z=n z(Dm7!W?Dn-D_JBfw4N)I)KL|o2e!0)mTHD#R^L4aEB_jKHd)R;rm6Gl;7{H+d1`Np z(%|;co5&L<4D{=#r5BkAS0hgtf^o|p1sY`q7Mg#h3${FnYvKBcLrj;s*VWRsINCED zkNSJ@iZV=#N#=GlNx1OZC5i%@RY2jvV+r-{+wkkh7x}{5i}xyF%zDgQzfC*~nU>eN zuruGC}9vi0B_je#a53J_T@TyC_9a7#Vo^8&muxr;Ga zASx5BEhB6o5%0p47dnY~G7!F2NKn&Sr5@0WG9Y&wujw#bq7oKH%(vQr4hU0RmyHO}sbWgY$f&!zHY{d8 zoTqkUHE4b=dfZR+szox>Xua+s9+qzUky>{(ed*!`xYGu8Q_A>w2({l{e`6t&*HF=g z@1$E$us`GwQs2xWD~eNer&S(ZJwdh`8Tz|o*za^lxwfZBNRvY|u82QFh2&6Ci@qgSaKdt*S%=h`a55xKG zJNH?}uakK|hX-sA+uVIlH!=_SEr5XYz!-oPYuGdbe*&uf*xN<6OLd8y`h5Q38}&ZN z*mCSVYLMJt!zp=jguwzlB``HFJdi;OR^sG)l@ZI~ScZx34Pw5?W>Z+90*TX;hj{O- zHbb}N#b)RFj4ri6fJ*C6*fksUXjae=uUgVN+1%W8y|u}O`<&nCs4!vlY3ZU!Q5E=j zG~4)(C~RXV(^!>-`PAW-bj^>3y2EOW0_(|rl6`wVq$Tn3ZhmY)@Fhq+ahB6u3FYB3 z9eU~Zr!GB)MDOh6^R#~?GMs`@guh`QUX@dJI#cu#qzGN0itj&)HH~hH?UQ-km(nQ! z4wKtf4)qeWNm13yZP3`>Eha+~z) zT-nS=#}Fb)XsZHXcoQuq=FE&$drnEa4R*{c^3_kw3|1{J=Wu2E?ZvcBr^ePR{xt8g z9FS8qCXno8H`KPm_C}ZvU2a}R*qGYYdP8r2#ro=GYg})X_)C=dI?m2>18=IZe#VRo z68QFYtAPRd{uDk=w4QJRc4&LEn&VL}2e9yxW97F7g`!o{dd1IE@AoNAI_EApA~2GW zt-r}qmf62g;?h@AUPizI0Pz(Kh_95~oAbwl+l~=5Y4sM9Rl=s82g`z9E+ZMPM|oS1 zqK%bB*ST0D1mIu;ANL=s#xi^YS$W`%fZhUJh`IL3>HG2|pHDtZPuxwp$JU8R-M3|Y z{1fvJR?IIl?w4v8@56k+#3=#Z|u1`P6Ip|1F7V@(7D8VxCRE7@_xDjz)+9VwKmu?5u z^xF#%!=r#iJUcy|;eboEvu7BhHcu*^8Pzzfi|M~L8Lt8~m&)qDnv0!ZAVy&Myn`MO zuGRGb0K_;di~ZV%q!fVhkiiXi(c-SgcijIlq|J#&;25*8>rS-jW35 zBimV(gH*+ckYc-vrn66g-cn}2a&G?m*AB@FIjLz|-$EUD_y-=xM6BUBxzo+3Gc?Vf z9uK}~AWiD&eCSBYyz%m(h)2yLTnbP0nV;KMpcjAw%sosvf^{nzv^BlY3<^J;?vlVG zgub6{;5_ZdULTz`Db*Ztz1+6tMIGBiR~V5%>JIZ98zt>HWCr&Z-i5FiPuPV0ob98j z$zG(u4Ps4oTgWrTX3uJCsJE^j_Z~NU>26@7-&y&g9QP<@3Zm;s^P_++>a6rD^7%$c zkvos}573H|LweUT#MEt#=AFTQ6H6%JI5MwIWZbkiy$kwBvgP$H+5$X+?4bCY#H={s@)qlLX0bL*Dhj3&l^TSI;BV}q+fhV3#0JA{PNj^-FQ#{?begtRqX84y1}$j8x+jmQ;Pc$SEwm1h;fUaHrgnsk+5BP zFdj%6{u9wNM-y@9;Tub>ei0}^7?8mIKLU>cS~Q(Fmv;8h+X^60!e6ln7{1)9Yl9M; zkSGh%3^g9dPj~+L3yKc_6f5TAfL>HkT+r4Wz83oCkk;S$!u#9s;6H5IFwGr=m&NKf z#GwA|>^J2=$<}q`U=tXMroqN6{rU4}Kw@9We-Q$T;0M!(`thG9& zKCIXEcvI%%$B%^9sP`i9e=0IS3kCW_y~i1K8(jfYoBsDU0R;uyNvG3R=v?c6X&vD5 zW+o#m8fslVqm~}OH=Ve{FP=UP`fPvnQgozW%l_sM9%{dy~heNQUVaLup|2~a`7d}8N6)kZ|`}a@)4B*FX>9l7G{@s#5 z`^3_saR^g{G1=zzoVU$Pj^Jjoa#!%2BaN9G!CPgFcI0m|kReg|0AosMFJCzVn{&|q zQ{a<61B7j&yXD$s=}l&};a_mlIp@(j^trVPDj2q?=Qw8Bnt!c87V&%}b0yttc}8oE zoSc~n`nEr7p1k!^Y!;+I=r&^HxY%lEh0_X=P3))DHoXZJdUO0-r^U1#JgP*9a}F;h zN^2@_cHzNQ6j5}!cFUu{V3h8C|B=ROa51GsPP*n`guu87L6&RZ1j68MNab6eX+vq-o@z* zW*9m*D|W1|S(dE4PnNPQEVJRGY)rbG0c7>OGJ1`GRUh4mu^{ip)S}3SWtNA6GDd98R<@ zg@;cXGC%P*kVj zK^cC@j6Lm4&|4&4q4MKWiPgf!2xUW3(>eAxudgIS0sfa&Z)jy+bVe6g72`9rT8DA8 zki**ZxNOC$P19U$`_+*c8yd=nf<=`TX|YXmLP=0lq3@If_0`i#FXuot`$%|gALGp> z3gWm|-*s~vW_i4s(|@cui3z!owO;!0;#5h>+QW;PQ^dYpk^Ezjh9qex zc_o4_Dh|9mkLb@5(MB+aEDL?Ywkr`{t8?Dc%&X8#C<`{z|E5${Cl8S&FWfFkG|mu?gQ*v5Pf2qOwXSS2Yr;)f1sN zt_4P`g%-l>X~dGlAmk+`WtU7>)LLVdy7%&K!~wi9K1OfdX=v2&&io1z7j+*l2bx>N zFC)pX1JtBDafe|WC`lo&alWCWa zWbh0&PwJG}XVRC&(wEO_SLW3<_jP_IEvq-UugK@ns{lMDTx|{+rUV*oM!U2FEbjOr zYv0(5-4@^XGNUW7jqpMR5PPq>kSC9wIHq?6?MvL5uA<5ul0kDGGVfzIubmCZGBFkN zvU^X=Sjkkk<{o8YdWu)4^5Yl&uI#1|!EBF0BAV-C;o^AH#@Y@m)g>~~xP>yGWe;oZ z?46$7`?1MP0rm^6;VE0Q6Srk7V?`8g;_Z@vXnYG4T05#t!~4G z4bkut`P;)Ls~nOpWXtPY$S^A=QNkil~OJREGQgA5-gCId_<_K z!H66mXiXsQ%wYapt{fwNM?R-Nm)hjN7XHypp1U!lpm9YAQD;3zyU9bm!&MC*7UFeX zd+KHFX2bAfxbXmHzyq#tow+s3(q`y5VK{8~)BhDaOGqdUb6`@+bJpy=7W+;^-p@`S z5++N=IRda%yDegx*_h#o?|sNZff#o*LjoyhIu&k&*Omm!vWSAM7N)#p0?Zw`>iqJIJd<$=_WOI6(OCd}T()M9aOkjl%k5RPP zAYX*Rd#L&|5nSYJS27dRkmjAQ>~3nEORIW7`=Rf0)bGx9vA;;WC1dhpj-hY+rjf{D z0dk@6k{OBi0`C5)TottO)XxK4&TE&$)%VO^@njRmoX-XD)DaVHx=Z7m({36t6FWcKKqR zulFP{f8YN?{bsVOpf0LnqoJJv?m~1B@+V4 zEU}-C@ts-zgLd=gZafJ~a#lQVA7U?tqE2a+B_7v28;vZPi@qZePGxqe?dr;$yMN!g zlTenF+_y;v{+QC4B9gKt6;{6e_0ol@Wh6=tr{@iajzWOanobGed^9Adc{$5bdP2)- z&@~{aXnBeZIfEuKwSwIRSW~ViC5$U;GUjudH~GIfLew^NPFE13nzgnFUdN8Qad_CH zBB>$mhUWDxu6g<|vFVLd=S;-E`{~oy&sp94_iVm*!NWzkz$61f)2)UtAc7}?WP6Xz z`@gJJDS2!A$R+C_N^$H9$RW~Y{K`k{Z zcF|y!xh8N7pLjd(Hhx^gw8#tYI7$&hNnyU5*II~qr(><2v0Rlkb`_h52w3>r?>)q( zX!)mgH#L-_tN8#}nd2U;tQ#?C`#OQdb9GKu|64BZbc zzL>hupJ3nqtv8i~8*BZQ@tYohtI${q%*+0u1PTc!n*XTHUl{=Of^?W(~v4?AiO-Pu$miUDy3YYHO5BYhP=6#42>z-w>jcdE9r8aJ$WQG7S9 zTMHJhmQ1F7vsxX;6Da7ih61j68n%B0Q4*&#U}G!lJihw{zy2d<{{+W|NmvArVz@>v zMS2d7I%CUttJ90;FZvq5Zd}K6tzWnZl>!Q+AGvv{^`yiuWiWq?x}lHd#L=(d?ISlm zy@L|aL+eH9!WJchj})O6_7B5OJZ(6KuD+98kDCeV^j-dLREGN^r*wv8R&Ge#sWN>%MFE8+00@w)Q?l&{dSewY8z;NlaM!gNKpXV}> zrdcNE;R4r+GK;vUsK6W>U6hrw1W!I8MwH5f(}$vvQ=iroStVy$HG+E|y@?^*41((j zG75Ug6-J}IgT7gJU3X{VizB>)zLMyIKB6%aS8j71ptgDJvw(X|-myom*OBw}saIl# zu0?82zpxHfb*99cygTEmwY34aOUKxKNb9Vd%A>Amam9@E2*@@u6h>rZV4nKJ@Z5Vc zr9hx`pTvIkpOjzC6PaMzftH9A^Xo4NNrg857OAWjGawy#}=PkFDkrrj3R&nhZn zRJVv8N%d$Cx#)*~+?<7q!HMcqSR}3I?HO!;aw!{%%wMUrGdo+Q%CZwXL^VuzebktQ zp&AS|mJp6|U7C#2h~B`(ssy&SsSL?Zi^N(h<7fObt-E1A;BJYP23T){bzN?cxYGw}hb06fH;JMACU%8iV6R*Y#*zuJ7ED z4kG}Q3?Jxj&A%D>i{qRn=?3*D(w7`DXgFL z3+agQ&)C4UIeG7I4PhxeBdw0P#9*HDst;W-D4wk3$mwgL8$xVw1XvQ^gLaG!t27vG zF&G!io(Rs8Z3MT_&_MJ(@K_<1@?A$#7>-*Bh(9C7(oK|fHBg$I97O&S2`3a#65gJ2 zanIv;zv33a4K5wxVG=mBZDH86C$r1J3n+mwl4`gdJr9fRL#r;qa%d1Ev`LvYG(?3b z_rjv8H(vI7RiBv+StUzX1Oeihz>*Xt74!S2~=u%khX>Q%l%Cos|u}YNN4);mw0u~K(F1x z$_C9N?n<1>5Xax|{(KmW<_17|RFiO??cYBEzF*`9&|gl|<;%Sj&AaQ%&UAl+dfPyJ zS%f_B_=8oyfAsgGBOAZ3wNk$#_^$9*ei2ef6ATRp9vFY69JU}V9+SF9lffvW7Hh#A zu8a_B*N`Z`*CD^$QgHBrbIJaC4r0QPC!;BU-X>9TUV_!4K_7TZ^z#Q}`k%Sz-id-u z76Eo;V6N~z+?ZKum|{Xnhf2NpA(|oSQ)w^ZwnXc@UBX;nU(Wb;^fH0;lu#NSxcHZU z{A#6FXS&8oLh5Ap*Egr_ZxpC<#$`~l^*c{E(6<9l=2YIXYT;k=UXx$A?e}!k|8?V8 zQ=*`3)QV{in$!7{k9lIx*M{>RzuQnVPnC1{=AUwYfn~XB&6(=lIMC)8!jig;+G{0x=~wYUZvbtwAojUhH_x#N z?@f%*{NnWFB+cVzY*1FXxsjq)v)c#74=y(+t#_|8!n9+IGrz21d3`2vb#roWe}LC$ zI=$Lg)Uwtmd|nq(gp++vf8Dt|{BY<}idNj?ec)kkP|m{5)dImWuko?=98HNaqG7E7 zwrb+8$_U~AA~M*q()0?` zQl)KYcidARX1Xg}9gZ;Abi8R}An}jZv0)Q7_!WlL%It06wa?uC(cw z_kq_G!6GV|Dx>Z^_!$=ZtDO<5Oz7|!4HKi}pq7hNPc~Impa6FBe{A&Vwd|^h-)z;Mo;feojCw1x}52~4^*F_|!teM;A9 zC`LQri7{u7`iN1pR?bh;{=~#c-L!*QjkE^&Vp8#WmI{swu5;eL{_7UEpR1Nz;ja?d ztUA7}pc&Sx?-JIf9xI(RQ!$rj9z`jo{JQSBc~2IBq`x_>e*?Xm8VaQQar08P`Y8*|@?7iN>-x_jP5 zT*ogfF=IR&osPGl$=&5lKfwE(zux8Yxo;LmZy;*Fc7#WxerIPwGVkZ&RElcLrx`0w_Sa)2|1DUZ#)9`P-uo#xKQII<2hpvjK!Y@NC-+50q z+39_$g6}Zvh0Q1te$!K?fa#2k_->`F-)Dl@cvOG8)E^5kAg?fT-~gpy4y#f~A7YS* z{f>qMogw$TVE#1R^g`713K9hlYDG;|Ua|LgOme(d4X?NAVr+1j9 zKzfnMOay)=iaD=0yn|F61+8>zm)_M@3$!<>h!PB5t0%M?4J-T2g3F&XJSIwbVOl@| zA9WrpJpVL^byU0yC4m z1gcEHqfV!0^j-F=(blukI*-o;_$xR#U_vrNrBEd*5Q~_)`|p5Lg^Kkyb$kq_BK>rN zey$Mtap*`M@%h5vS*k@tAHm|*?mA$IoG|pflDI>ygTD^;M}j%7 zq|Y~)J23D5S0%wjltIWkC`cwlCg>xNd5gM1nVIK&sY$)=Y5FdPxYtjUN212vFh{?V+%G8pO9XTll=PiVNYLQQ!16}f;8`*;{N>A+#eSmE z!n(WYROL*d8|8Osr(N`tZG17`H#XRsFAw^w0xn*hpDxEQqs@j21wZ88(Dz^`M#=ca z{Qwel)^A?$^O|e=Q8S5cTNLP$S_6NPBxn!RiSvrdcXVz}LoI~|ucn7SNYcCMwK*k< zD`reDHLCc!u`1%JTS9+MY*WH$;dMvr$UI1Te+uVrH04Ke&!}Wxb2D<7Zn^Z~u!6@* zZ^Ef;tv24GI<6Rrshhm)y1!Z^@?;@s;ZB%nc%?0KT!5$u9ct+{Sv-%D;aQ~FzDq?J zGN|+vo8};js0YQOmoaQv9JSgNa|0y=BK!O2;QeIibSu#8MuMV+IMBK|IJm^5{_XXl z){Wp~S8KSdljlg^_uS}lNz1NS-alvHNk_4l%}OF17NdUv>7KdPlDQJhkn*dsPXh58 zpw)S7>Tb0N)VMuo9dK|cJU+fN?wM}8KDRUe?Hi<8!zeIy<5V?On?oi1m-vhe-eARb zjc4-K2Nekya#iGLvf9;S#)6vsnRI>Xd*fEiZyx7e4=h~b?M!`Q1se2=!6^4LC7(Mp z8=pt#oqP^#YyMgk7luU=pevm$!4WzM+kv~yCzxlu=c5p_C}cDRZ$VsjMXaoBa#x-` z3M+a2awSjowb8VDiOikx!y3mIEF+L8&yDL?VhaGuSv<#-9L&wltMl#7^7MDDdM-9b zBJ-*9BTdIe#K~(IpI)$Bv&QKp2AS@7aX+Ih;|_Tub>(%>AldgN^DQFpxp!SAo!S1~ql|hp=f^9$E>o2c za#j;MDu{?3j1)^9o>cStDF!&{tT$;Ot{1Unu*0^1#AoBR%q1g`fw6gauuoVX=^~=E zU8iNNsH?Gijk>tH?5BSsVCE-fgy{!5H8FWxOyFzo?k!rcSvgC;^$afo3b0~Py3@h&GEzM)eF_>PLjeBuZ|8Ex`_&WakZkIn|Fpb`)jWPPuUX!O}};&hz5@R zkZQiHsRS9^(6(7`r14vP4=q;sz_lif^^nTUy8K4;YB4gY>L79;gs}R0ix5r`-z4u) zdzje0m4vIZah<75 z^l=`ZZLPA2hNma*9B*y;qeY_w>|khx$fblhpzQE6F=~dh9dd?8am`+{t_B*EjO1RL-#J-$n2}$ ziMjyZ#x*$nJr9c`Q#DHkRfC)@=Q6u5N#I>Wv8PQwu1$B|ijW=Xcun1eQWsRA;6X@k zmMyFSHH$jCms%1-#&FOh7qam#{;$4dtw_Zj>Z74Gk0~ObrYv)hAc5OWlC~4XT@*?O z7QY?LpRhWWAbqTHwk8=}&;5bZcGgI_Xt$U8ux-?3WQ5t}HC-Vt(aE9S(6H=HeTT62 z>B*R&zyVzMrBX%xk9M2z=k!^bju)+r73YCL^qx}QGFLkRr%)u06jk{_#rdZR{LxV?`fR@xX?Y1hGwzqHVOxDF zbUDvznzA14)lCXdoc#{_QGT-?^S)XYW&R?6@P++8xoHLSw{72#nAl|UU)0YxldGwf-xQS&cK zNqABI`Uxq%P8(EL%O^J#!-E%97iU2XA+3|;%y!bO(jrIT;-Abz3iI9VbqKk->J-79s!Ym!qyeq<$bPG~{pu-a;;7hy zt|geu_|5Uqq;fN=E(tulM}0cX$i*5=@kTk@B-JBkhcmua{+&*A6nL)HEsT;Aa-QNd@ymk5G(A(*Gl||y0Ij#{MwIeiI3#i4>wEU)!f0GF;}I1Cesv8* zLH8%rnDg8lZRcnD)n$vhk_pXdLam3-gn+5LQ~$8xTF%$5Ul|@j z$}36x(gYf%=vQNU4x3k@d$?vz98z%zn*3+AlE&n<0tTLHLkYT?4*aN>i=(Z0HI=8xuC1f%-1cZQ3dK+M z#`*5BN%BoJ6`m$wJ_`!S4mp`92OT{UX{J6?HneI^QQrPN4_i*={p>8rVPliZ#Fo{h zSA5E&l@W;PX#;u!hkoa3ORC_X3%+5KG4~#Be0cWp&f6wnZ0q#F6E>`a2U~hSDUOxy?ilk2el-fO;e7>?dD*IjM@*y>S z?rJ=OO;M!GU=*a9FqR*#a@k#S>SIR4-wY*mdmITi9EvxerBJjBe?-n}By|!$G;-2< za#i`B)DB}wi6eoEu+OGM2a#;RIXp;BTThpVKYO#-ryGaB^)3M`|4xh^J{!#Y$!$gb zI0F2n{v*yC8>-;^03nyk0QqO9vE~oNksQ3x&1*7wb!;uhyQ2Jz-7h1GqHIL2SIw^< z7$K)pysAuFv8WapsYp z*J8s9RxZWdnY~!F%12^GsXIroDqp#r)4|i4_qH`)=2?h_3 z8uj@wiCRO?FOuVWHdyyV#SDC|5 zaC^%zZru4K-y!#aU@(A!i9E%T`kd~MHPn=k4x4nLC;F15ywb@jL=!tRFT%P?MUQ(& z9~{=IrHuTV36zg7HB#9xR(m!2vV#NFvYu|llgFfwJ+?wHfBZAub%HrLchCdapdvz^} zdAa*{b*eX6nhe8i=pKW(6@VlL{c&T^dJZm+%$O#v_BcQqo*zxn8D(^FmGY zISu9u0YWksNwPcq3Xl4d7%s%iXZD(+(l!_WldGyccHOxFwt$tUz5I()qgYO9-KuXd z6IxmveVi=J<%&m2x%dzx_eoD^LX1S0eGDw<2wed-(nJVn%Hdc`B#=JMVo=9Id%~f( zx!P~A@%6(APJc9Qz6im|D76bs-c=cGR_2YPIb-auuIopG1n{!1oMw3)MPCk{mxH!| z9s1&etzw9l|7VoWQ_8gxOji~cI+Y;L!5%Vr>uERdP2D>0MhhF0C53it??l`ZuBq zxCD8QL+Sum%VdyFNTGT53?_;vGC-wt$Nnzb#Uc9U8M-?wMCoH_|F?+=185<9FX74B>&LGYit6Km zqi_E0Xwi!E5fyqeUA1_O&3u*k7LC{Vv^f)Ib6RCB=Tyzd)7KXFI6XHx*3*$(vLYIw z4%vMTud|?;leyi7?NWJGb8f_hr`V{zx`3f~rJGY*tK@N8L{9`K%3ZNAR~kz)n%;+~ z>ComEJ5&MZW0?i}%ROWCH~aK@Dk@lWe!I<8mfbi;t$|V*{_FY&fa7&goLnKs7Y8L{ zI@Y>g(b`avIVXxds&kC~VD;8+=R4ZX!8OJ|I)xCvDEpDfl?Z-I6rH9j!)sg?GuIfw98Iob*XC-i&di*|mo@W!!{NvMTCBFQnP8OM)4&Q# zXq|FZtyWg)a*{A&g2Yf!g0<5BjB5OwZf1GxF42uc8(!RvbZGb&#ziJbw-KTzp1#nk zCys*df#LSOmkZj(i5T0 zyDb-}73bey(?b|tDBxr|97?gGhF4zNh75PfP}0&}w#y!WD&G82*1GO|O_m>5mbah3 zJ2tb&9u>CFn4OSiH?MD#AsCYIDc<95ew$hw<)Y#SJ;gmAMu6lLqM;ArT8B%Xz}^?mGxsPvcYdIf-XLgYp!hApoYU0Gv(yAD7f zebzoO;I)0jXN9chjn$V}+dK(L3n3ZpB zZe{~aeRN~PRwGoDlpD!H?Z!pQzHfp^{c$vZjouR#sgNDPzHa`Y;eD2&85kpGsj(A` zP>xk;?=Ow~WqUDs+$Z$8V+hG=j@^ea3M8nmCesDs7@xfo5A@Pjz{HkCJOv4)?qQ-( z+%6-9`w)!Nz0UZJEhOAyzaw8(?W2TO3*oFk>zN=ZWH6Rm#CCVSSup7O(%r*zFkP(5 zd9IN5O?^-W%TK3>?iGN&73->}E9qE-pw%FEMZMCH`9%thk93e$ZV4^9VUL zmB(Xe234dAv=z;BqMLNtui1f!v$rS8#y(2<*|vvbv~Pi!u%5WO4&Q6z!h9&AV-T5C z@YN7(Mr@CHk#Vns!twFV!CYxEIv?x~kJS@{3j4;75h^#orl_FodFs`P}1cDZDIZj6NI4obPzs#M~AM-aoxbX{F(EY~{)WT?%+#-b9}aj(&K! zJF+>pTX3NRx@SsO56{TRkXu6VF>t)r_p~K{`5~<+TuS3aSPFv1HWo3^vvL`ojs*4h z^1nfgsf+v!MpQzhP>ndE@ci~e!Dp*7c_^+t2S2^Zf2Db4yppR|3MPRwyjMmGmW_3QewX|A*;~GfKJ8T^=FGy$xh4H^2L5g|_*WLD@5Rrp8B9+G(&%Rgd zbXxHetG$F)CmEbj2d5XbDK527j~Kd z8i)!O7m05F!31Ic@(taxdh>^ttB0}J3L)Ot{#>vHX{M{834F;olFDBml)nFky8M9? zdJ_d4H8?vvTNWIhpLe{wp!IC%WB&K=Psr1_Fh7|hY77E=3i=jV&O(#OY|VF`efVz1 z5TyX7_a27fNj>#+soYdW%{}GmUos+FP#p)$`Cx84=3!FHYBR!0%CCl1IxaVE zX8!1l=5z`cT~=L5pjR~VqNU8B!C(>}d61=0L9JVR#GS15LIA&B{u_QVK&*V}->IvE zq-1EXS835>ykqK!+ukT(_W)&HA(Fs!q#C<;Z*7UXakja~yUXy8OW;@F;IG_6c?S(x ziewG-N)0@Mn`6xMMocQ>>N?HF(1KCV|q>anRj z`A8Iyl~J>fyQqM!SEo?^(R3n146K8gVD?Ji>q{R%c&2FvxYQw#g^N2q8%)0gNhDqu zQ-O?ON=M&e01}4Jca9VgpTC1X%hDW1t)u=UyBYEdan`5ztuOCbi<1Y|+PGMPxu$y`%2CgGou-_C z_?GyWR6z>(j5MzS8y#qV3P6_G%m0AyzPT^*LP0({B++)cUFB_plTP;fQPRm-Op-%YpW3cX~CLhuRB6{F|y>pjQdPw zk7V2Kp#XQ0ua;5-hesCx*)d?G3j^kf7C|zXsOMHFG=c!Ebl689<-0-UXVwGFx^OM$DbseDX0VlMDbG>mNhD+HA)!2#voX2GEurCEC7Ou}!UlgWPkj z)`i~F!(%v+T@Tg;i>QmLuGCByCE@}(T-flx-$_8`fRZfBo*REr4OrUK`SHP#ef#zu)= z8(Lag&jSFx0HhZDWe@V9u=&Wo>g@9B zKG&KEuLORsdt~s0CD?mqy4s=2@5I@t&XtkdurdsvPI4o$jAL-Xk`G89hQ;CM=*wsJ zpzlJKY7P>xfW47x^w*WK3I`fqBrj=)rO zo-U4cI^Ota{H;DyZj?!Cw^#zC8GL-Q4ilyM-O&_dYXfO7^Knf646YqK-m;85&7OUG zNpPqSDz>th97J~jW_G~|NqCs{sSYAW{W4S|1SC2}>KvMIhw&EUu4t&JaB}jbq@=2X zZUTV}kPDB1;1i)Wuu?3m4=_04*)4%6utZ*iBO97#=9cLpfzD=G($_HQy(}=bq`T9; z5Tu@!vaL7P0f4?)F1g~Ta-eiOa;^5k`-HYQ6-F*9pZ=eRsE}7c352My#Xs{#kSJj{ z3K(&6ax!-IYyBlMyVR_CtI4$9{Q zs-t|Av$7MARUt!`sJ%I{Rc`WEF90n5Nc(Rzju6h@9RHYwCHP||{>=eC>c8@^U})@S zfVu!b%HgHQX^I!&f53wyzyQ(jfBM{loJ5w~Y2`y!>`#fyem@Z9KBe1(V8+*kaSFd% z1cburi3ycxa_*cD51)+!5+Py+$W!gMzm-64Z1_j4qY^sjI6ao#=L&3$MVE)h7C-6v`*)iBqLqVq$yvuT~W z0`(s`EhGFnqjh8x_w;<0*WYOzb?xHY_ku#W)@tuIgs=n$lb`~AA0TSz7#L7!WQZrR zXnk~?Ezru;q!xC}(ks;T;ec@F=wC_uB5Oxq-ccqh*K}5^fAe%~fPy}|bQvZK{&55> zn(q~w*gXcLr*9vXf7c_eSmvC3V4I?K%OmH@pRkEmZS|Ab$zO!w#N*83UYXjPHH+bt zK17kZ2&G;<_Q@EZ3UqiMo$R}Gf+=Jj0_w6SXUoMiC*0FT#Kpu6w**`i<>tODQ2(I& z0HW08d3Ao|vD9^k*v6?9$kL=LjYvHNwjgoJu^SZA=%_5{O=LhwcR9@~iuzSPIE9m7PLe zaPXRXA1co(!MDV7nx@Q6l=4nr-2gBXHX4NxQFyhjKCbbc&KV|3FE|4rL+#T}^y3;H zRKW858&Mjco1%p={zjnmhK*l3KiGvg9U}VJ;!|E?{GC8lAdYXt!L4OLbgxtGsix))jgwKF#VVD(Al_@mc9Gs+pPc+sfX@sHt z)4ww5>%Xy>TL=Q(#lyqs*FHKt9KOD~*!(f|Nl;Sqt0i!{nrP(lR$1=`xyTm^1VZ-0 zUZ(%<391fF<(fq@Or+(_+PueDBD(UvX;ODJM@v#sJ1ctIz04*Q<5A@-_AdKo1^~uB z+2+n)FE^b6TBPKwe}rTc6;L_~>p>V03DjMdLy1UahqPV?`Cy^^BcH!5Jskp)l+TCK zEFa#3d;`TV`z5gdHPYVls}ue&UFgHV#=e`+%l+dLf5baHpv=?FvF-1>aBer(xH3ec z!JxalyM@2jhp^xZrp>-cpGNmp)pE1eQ+a!rUE|dfjVpyqiGK6n9H*D~VHKG&z;W*V z8^@7VV20bFWp<;#QKGh64m;nuy-|t(>sj9a5^bq2D~l)RHd4HGdhR`Z3a$OSXxMLw z%J)|R3f$kh`ZV@b*xrF;MsnKclXYcTCMWVoVP!_Qw1@Mr*=uwa57O6tna0(N%+j^u zc4wRDCHtQ^EJzo4mG4fu6~^`em}6Dd9DwRc%R6N=Mc=~1zWhg30%EJpFrFX^dirgI zH*4^SY-nh(-5M_z^f|Cz77jS~m@a>UmLcxhr&nP_l)oji0&iiZSHB+>?CEaY7cQ8l znAmuU%c9+FM!%y)NVgs4>i-}%b5bcF*Q#9)L?W%k&)334MO@Wic*|5=-t$%M_tlvH zMw|zM)5i<``w2KAM{cyOYDJ7TK>X3eq(u4wIl85%wRPC7whE-4f;N4L92Fc)rGUIs zNW!Z5hVAbJCF|Wtw7Xy>gF8#LmwpahI;xp1?a&HfOpAn{+#W@sSdHuVC`1G|da>9h z1l=N_^pi4hjT>aTHNesDw4k=U_0tu^DBu8N`PzLPoNC5lUM&+ip{<~bU7r59*i;`E zohszEF^-O0&?>N^L7_$(IWhdxvmyMjtqQ9irf?YO;qOQ_%8Jst(4qnXTM8>#i?%0N zAGqjuRpHP-Ku!Cb+V`>%0^Wy>Tl=)KJYCf|n3L$xa)vp7%->##Xx6bKAKFPmjZmkwwvy{@*F{8%ig6z_xT6%MJ61 zK^TR}y?K}Z&>tZZ-WJg)86G!-5yU=W`aQ``vM*rOHi&)Uh?DmaNc5Bn zKEIO6)x_!J?TLF+u$qNrGs0GtB1R{4=wO}`XbTJV9@AnqG-(8!&^SFc^>}V>PL5}L zW21;f5ukV}kquJ@XxJg#Ok(-9F)y#g)X^ehlDAG*7%0lWr6Voa1(OuSfPS>7nBbs& zXqf#Z2&^hwjNk{$9-%$EALkbi>c3Zp2YJh2s{6lmj7WdxE(rbZ<{-uH` zh&?@DSO}oYW6@<=aI_r}YXE6s zcPPe*=@)|~Um=fd9ctV$m%TfG3vb@6Pe6ohze&lz3UBHuyyh?5EpC|_LYZp29%>VE zJQDcL_5>AzFQ$n0>rEMzj~;eRdSr5Ub>9>vsUr@0+lK;Ik{EStl-+LF#`^HEHsOOE zK+C?mI2oJz^vurN`+Yb=bh{%3Jc$=-i072d3!M^QgkNzzoW)gii|9Y;?~mqe>&?)r zdHe5@UaCCe8?HS0OR;F-tsR-c=y=d&zZLdB#3xSxga59NQG&);ItuGQPf z|7~e*Si6FQst5C5iZF9Tv!af!uLH${uKml!$C2)yl1EmGOS7v*1Ro4yzKvk_P>mP|7W}h2+|r}A69@=TNP;&Ga5KyI~i zv4E_oMZ89vYWmh8(F+kSxi!KS1GyO@YAhG$^|}Ms0&N(6Gc&B(6K+F0TCR#JZbe(q z;Z)K~&*ATqGc|{)WZ|fY{5Vp$(`V^D2NMxAN`I z_fu6WnTqIh<(@uyxt>Bcy3Yn(0iiF>^vM8+2an{{)_|t#9NWHzq^GV6!z$h$K#4}2 z??+E0^#TnV(@}Uy7z}kH+_SA=#0I)XMOoQ)p(S8^WJFG{K)sk4&a~7Jc;zeZwuBxD zxJ|(Np(A3~Bo&xu%%#^S6ni%=*2sbDbq@0n(^=%eu;5y+`oum8f=iq%2*mB8IsD7Bk6TY`fUwHz9k;5?B#P$ z#i%j&!HChR%vC~$(H+tZfZ(>KAoB!`kZ<7Oynnl@qCxk1Ipp8P zForsT_HZU^Lb#H)LmMlgh|S_r_hd_2bj2z&zY5>j2s_q7=he9~>al-*{hYzFQ*4)M zqB`BTLu%^#-A*?bqG0IJHz7VQ4D_a0L{y7eYhVT-Au8aKb74cUCM&G4@bK})JKuC$ zl-lKxCyN*l+S}O#FR5a7b00o+pJ#@P_4Ke;;>1ikko%R4mQhzKYs75Xp@2nDYkZ-& zI&C5Vl$<{0`+Acx9l=4&nX3i*-`9mm?}98^0jYD5`mCUb3WiB8GTkFmJot0iMUnA zK!H2c01xmJ;Wnvzlgwo(k3~S|(PvPt>`#206Ai^%eb3%c`xs^80vD2C$rYb~9L0Nt zq=K<9zCwb$D^daXs6Xxu1KzQGIXZUtix9A}?*poKb8980!^+X?hj)9Ll>lO5JkeH8 z`ad8h34e&mIoq*)MR9Varr9s}o4=UJiY4H#q!0YB^O8P*kh~I}p+FqQo&KGc@KEc+ zqz`kV{oZL95L0%08In)HP9Zs%nS`Kc{s)+jkEufn2;oPez{mk5622Glzm{$VCCYy? z5om$>^YmU4K-1=Lj>T2}-*;sqkniVv?vwntyhczT5%swO1?{gb27k8mhp^!nS-X)u}1?jnTaH`f<2m6g-RJzIx(P!MNJXyXB zi??RZ(P+NfI1;G@NM8AX1w>uDIaW9Z6!~lbH47i3kWp;lRz`EcGm)j_K>ar5$xc4* z#1T;e2u@@PCBi#^&?Ik_L5TA{CgoiVM&^=6->E%Nnh+qZ518(Lay{Dfi#0>rd4tEs z{WO(36yy> zrlpng6%-x30<2UXOQHM9X*viFS*&-dsWopDDma{F9YrX8I(vM9{1OnmHoS=wklM~o zF>5KMBFpr1U`MUT1boS5U+hVp@Bh}de$Y>2qH>_lM}dh{8wm2vZzi=!sKt}7 zxMW$~)d^H)@I`<-)q+g$9W|QezH<@YI$AmOwrJRO4F8d6s4ZOf8gfIY58)_mw$Uj< zz+U#qE9odF))#eT?tMKm9av&;u&jX_8y2OTqnZgK>XDsYbri_u1Gz57Jt(i1KcHKI z9un?h-135mQvADjhkEK*0?yHWDZsRKfv&uL6Q2D+JC$5FoIx^P^Ze z>4$0c z>LcQUJPe3_jw%`sHXi9X-d3;GMF%O}=lsiw5Rvrx9Fd!Dx@WN7VElZMxeG?-H^@hG zLJqV*#6^Oj)BQD2a!6)gNgOf=NH>^7NT->agh!mGvNB@XaGIon4U@KGxNDj7NYi7j*5TUqQDmmU_PuxatDibV1T`g8PZaLdf`%}Q=f zP#o>T_Nf;<#)lbhy%u!IR3~iIQcEzl-ab2oNQbNgd_(H6WC_l4yE^xr{`8E18(Pi) zrM2jZqZJet-MFj&yMRoi{+UM7Czw(w{2UFC|A@X)OIIsGIz=Q^=WU{&_pXM5J!wby z5}E*AGkh5L153-kW%ZHy`SbRsseVB36_QXcZ}lWBQbKH@3L$%8RDa6UZrvBQ)sYb$ zRsz5c066Der(-0j3zup&CF~8Rwy#~Oz;~6Umw+~gSfgeB8EQigSN&+e+5HuE3GT#A zD**ER<&@t{14!luW(GUUXBh!lB%7}TN^*DRo72d7OdhEvbKTaXim$?rn5FMDPAVZ@ zxqn@8R~f~p&sF_gq{;79YLBM^XvxDpHFxAp@nnx&$fTio413D+{7YlMidCTbI@kA8@Cy3QH{9op=PcUKMN7O;9vX(=hOiJwvcwu_}*=x^8Mzb7}6 zD{$p`QdH(=0?*t^+=VeQ(oj)c3)pATnMvf^{3oHj;k|8L+pZ|b4VuHP-c#|Ao#+UB-3_e+K_)pXhvPRwN-bNji>FSF)+JJqXxzkfe}JfG+F`R93kUeEKq zV@qAk8$d7(p-0G#VgIt1vj*v0^z87Fwq9`qjcmp@J@^k39Odn$9|n=hyT z`5>4nk;m`RMwUhAjESJn!{xSXnlayz)wWA2uS9K`0&P;r8*9|yTv%_!9QkaIu<}as z4eOtFnun6#`^Aa_qMEr^mp!f5dr1urfKf&&rW*MsndKwi)QkonpA#wWP)V2yYuvT( z32rTjH(4PV5x_XS;n>?cD#8$FkBN>618I$2;x#suIq?Gb`_=U7t zoUIC>DYHY5a_Z+x)s4gA->Wl_T;MCOV>gwjjv7` zY~&i>>@A0M+^iFB7_HAYi^{nbq1fwy=k! z+E!BBIixo(P#e5>W2;|YacF5eN=v`V!Loiu>=K>V`}@1?_>xZCvQYH>t(#%MtTJCz z77N3MhrdEL8b(l^4$%ZoweIN${AJ?RtlIa|zZcfqCgwUMdSHk`)nHokMZkLdrTwLz zTxaI>Tq(q+w^e|68<5R@=#h2pcW$%5#5HA3)87~@#M6!C$moTbc@^g4%_DL>Cm^D%}=b_qJ+;t`E6C!un|o`=-91PjjqQT95gYD zxC0l@=;rw>-7!FNax#2mn)RIs3kS01LfleoCnI7GC+)SsArQ9nmX*RX%xa@*IqB{( z7|5S>N99@qDBkTZiNW5ivSBVGaTGpY%yD`NJuweP@=Bq+=cD{|YM&WZ<7Ym!ZU1as z_RA&k=-FrT2>g75!*5f-dtGpqAX|3v6;f{JIAyr4dIh9MdTLb$hO8Y;i`ob-!8&Zch5d?ZFWk_t0JWP2_&hgC?Xw*<4-N76dI z&Z^rkZclmUrL7?>TYdFI=)dk6Fy|KJ-wFqjrx@M5^M%^^JoB}ao9ufuQisT6F!l5b z!N^U2I|yCi99g^XHj2>9ma1pmICNq*4jJ50z4-bqKAPmS+SS`hpOtByq42X4uw~9O z!{EAUwy*rkT~GfMC-hi| zc}S&2KmddMkR#D_$AWD7H_a&%EGjTG&&a4sopBRSL1!{oxOOrWA6*M4Zr-PxEAJt%Y&an*H*& zsUwt8kLY&Dd%J=lT|@3SnqAndaX@;Yq=)=CSGU6h9ui|?J9b=aG%I8zULbOLnWs+$ z5H|m30|<$P)#}=EreFl-z~qscTU96uja19gpkT>wEt+a*KFT`1bo=uCbw*1^$}Ut? zl`7dayoW2p^3D7#uLQks5I^WChPXB1enU-wPudso^P98d4!WbRA+ey>m3jnNvESbE zj;Kd%`af3F!bvCJtY{-qethq+6YV2Iuj_J?W4%?H0FR}rbsTNk!A-P2>iO&NL!T?#C-_SX*{*YR z*^AbEUiQTk^^dp-pcj6Gzow$TazER6K$IR*Q6vWe8kG(%CJF8x1kOle;x1?J)9(Go_d9 z=ZGM{->Vl%fd7k@qVT}4^NyydR`JUkvkz-VM);MSdlC#vZjY>K`R7{ zrG1$;3aw0QttkjSGt+kk)Iqf`ctR=P2qD_AzH~RP*^N=%r(e1F*w-4&LSrgx($sNd z@mCKpli_sOYY*jaVe!f=L4Zz(BdX}udiCVrf}o`P}P`z}w+K=t-K zpD#(zIcg~)^K)dt2W}7%n&G(HDk}nMJWcrsfL+3o<+T_A6D@(cp^3XXb3D`eU`ky;-9!>g=PPEq{DE&l~mOGH=&obBE`HhsCT_I379No7_r^5Ic zRz5izTr#>X={g#7+`XU`g5M!+I@n%mYNgbF<9$l-*;2G$-#vU6*@)Uguk@YPHbhPN zpmJPnW90F8;keT#4|;+=QWy@BbXoagA-n}yZe;xiIW^kr@Z=5r=%S=UFaAife!HS< z-A;6k(tgfA!sG#W?B9lOnswg7WI#v@lyJw1oSn7bUvP{3$!{6UvPs zpV)$Q_aulw`w#4l_Y68wm2l_u)QpIre$&Z&;p(M7=LA>j^ojAoUMaKq$Dt^mZHxi#OP&&VND?l@VCa-!~T zDUUxU=i2pyCV#%;aI&k<|JX!l)fazPLw>FhW4D7oWcU(p35W5{SeewJVOYj7m{peu zIyACZ5xS0sb!R6N%(Pfa6-x>mkE=D>-Uu&1ggS?FK-7-aI-p5fz452dh{1o^q@-3K zkw`B^^sG(`b`hCrE{vhC{S3lD`~)uSw)GWHo=}wEW*+Q=I7Wny=B3BUDyQRJd3I|S zJ#`@4{jjiz$j4Pz(P1`IilB8`g$rSS-Tc>b&rjf9#>YQEqZ5Md*D%FjGkUOlu-0nE z5hNUk(5vz5QIt_r=)gf1IG4!!C48t@W-cF;u+AjWIh^B7YS7e^vA$cF>r)8517D*lM!R{P=+qPmI|j7v zQ+-64cnqv7e^&f1qg_t2?TdEq1?}~QznxgVjPpi>ckO0l6f;&xOMXa+uY>P;f(5I` z9qmnRgpF+78c!>y*@LJEuB#d(@fkc1Z`l{M$sU5ivnCt*hTrVM+pK z-KZJ=x--vFn>UhhL+U!6S10G6wDz5Z2T)!A#||)Nw(tdkU=*2`&g9h}^5h&DIvFVR z%4PMTXw>@Mr?=P9Y5(}vn2*dD&JCdg{pI~LVdp~q5z9DQOu^yG0j;$_lKkIlrRCw_!tLV#w~c21UV_~NqxA~3OXaV&&;KD#t*P%L;NCl>WF|8$t<9N= zi4cbUqU|2hSClQ%Po)22gm1mc&~P}t`>e{w-i-1q zjXcd@$1Y)cTGw%VOvI7W33ETTjJV`PDjYm>NA}s^W6PyrmXvD@hr_Lbd|6gMWEl>g znz*%7fzr#l|_;Y_X&%UN{Pkg<}m%y-$FdQIO<*@RW^kDzNvC$DV&a&X&wgImq(I+Uh ztK^aYyY;7B1~uyAu2ZNbU*!`$?=0`QKzVwKU)GoVCs~o*DdJlgpHBwUy)n0g$#EyX zRpxW1(`nm7!N2xvf4O05GCu#3-D@FQZTL$Ka z4^W2n?F0A9#3bA?Uh4EHdK40|k2ZmCA`xCNG`pipLm&Fl@hA-4SH2>MCcPcpv-8M< z&;Pfsngg4M7zA<`)aL}L`B#6<(-OsNcTA~^xa017B11^V9xlkHqt8Zkd5*^Scktl)Kx}B2QiCBnyFAZb@=G36L!{PTypO+-x{}HmeG;aPxw} z7SU*7BGbduEQ#%$_Z-IXMPu1Rp}zD#4@tTeBNm%|Ptf6GCNAVi@5HFDH>E&ZoJrE1%giR~X~^6uU2? zq}cVJTi2|1YHDFLjT$nM@zKI+)=s?BU*tPmk_3$sYQN8UIfFo{$J`DT`0qgsS0U|k zBu|WVHQ{iHgWd>c=6SuT14?M1Jm$hwKI>TA^P|PvlEa^_{zNS&)KnwbMNi_Bb^HmZ z0hIZ);53uuMfxh;MIH!JS6C_z`qAvI?bW742*jZ~9AeOB82!nRuH2}ZPvAh}*0!EY z_0X2#9d}#)nY(daIVesEuUTP)hy{9_=aQg@T%gSSNN`uqX<0M4l+YX+Y{U(<&&>m&T~bF*-&cfZR5DlRg#HGH(93^zWcdiUXwR6U0$JOqty z2$KJ*VfHpLq67-D|kFxA`*rcW;2z*tfmFg-`ErtW&@kqg-lDd(_?P2Y2Jm( ztq1J?2$E#?{^8GX_cV@qUioBJxetU@iFn2aHPgx@-H zaO9bmHd^`GaW<+>Zy1Ptt;mX<1J<@CAtHyfwhUJR=QuPF2NbCeM$fLEzmx&mHN2=S zKyVi^#G=u*CbNwh?vcp(k`7J0Lrq#81n1<>}+Jl=-dT zgBnF&L?u2vP4fPXCu_uKv?8KAPZX&^C{1Q3Ni+uu6EIIr_hr+a3XvwWyUQw_IBd^S zglv{FsF(FOb%ncm*1nEKHJ9{NW|Yw@R-+Wqfeeo7xh(GSqfshEM5O$qWZAxD1Q+C{ zhc2oJhV_mIX1}ZEK1Dh#OjkE^r`Z@@#n@yXHS5>)2L^}#l(dOoGo)3JE!&l&m5dP< zG>Yau)Zfw0(mK;D>WI0IsuJfu(k`~)y#x#**!bEF6#dEhAsY5}52kY4yWMkp8EC)1 z`a@>c@jq?HUOU>j>fOI#)&7((#;(7vEp;d4_wUb<;qC$|+0EK|WrwTtJqgsH%J?tZ z{4M?eo4)2>uFgBJRrSZNmm->Z4_E+aroo>r{H(7Cv&gCUM)U0zF_gnPmHU8UFeqAjXu7xjpyl-gnCVkniHI*j}x1*`TUKUjN*HA`iQehTSeHto!b17P}={rwwZ%KitgT-0qo~+Yh*Q;RX=V`|s zeKk6caog&ZPh_JKmcJ(@8WH089`~yE(Xgdxw$+AtKxD9e5C@dLJja0~rOIk!Q5R+U zh%%Gse$)lx1mJbM*hb~`CTx&u9iKs{JR2J4M|8n5;yGH(vZ#r){q64sZvB@6C&!0Y z|3?KHP=}TgA2=fTLy^J2Pg*xmN5$ohL24d;D^>O>ZO`7z1Q7?fyehXs&93T>=GZUt zcW&l4u;=r*@=WdV^Oy}L2^DAOw98Q|msOc7dat`DpmT;2r~*<19?7P$kUy3r+5)K> z^vN(XpEsLwUx;>DGh`pEyH%<_n?Z4r-e?JhyijD|oR?)@r{a22+&y&}OxWsI9x}v_ zi&>MgB4^q=*erg?2j__LKdi?$I4CRDyS(?%o4L-4A8kgqF>3kLyD4>vDzYc-7J8Ki zMz+1Sfywe}XDODEZN8MEKW`<9-^R4!bh&K|2l#s{Z4NTQe1^m?TD1;zf&*^Pyne{j zGQc#KBWeRo_GG>1N?{hZGd<%>?7(5LiT8J$9}K!ZY_GL_SwUD>vRf%}m+AT?w=sF{ z3l`qPmzf62?`Iw*ahG9?@GVd77@-<#C!VTUN(}FDyABNQ8N9A4JmG#zyvIPvS9^V+ ziS>!vm2AEFq-ytB5Qe`a3Us}im_x^b`INLznImNtB^lpGk4xH$%T-i%G>a`-QV1&B za%}X-L4gw8huWa5QTV1UT$m2a@u|O$QOPRK$f2CyYfM1nnaCA#(J6N&VYjz{1 zZhdYil^sNTFB6!@^ys`oQ{889m$gw1t>Zqz{QP%r$m6VRlGrwnap`nwQY6eYYCUTy zqtod_!v5nv(r_(aj!mT__A&ZvV;?nH5J_2*Pia=~u>z$gqE&d7DNXHO^V6q5TWVJ; zga!)vJV}&}EqJ=(snh_vdm~;sH65Eb2O_(YRGt?Y_s(QHs0#zNNW}C=u5VhspS)ds}M4{HK?_ zLXmLx#*SL$$64z<;HX&1B3pjB7HV>3a1@X30gta6QlJHk6 zyrL!A`z#JgznUNeQ&Nm9Zb|IG_8Jhs2Yaj@QMz+no ziO({eJTPP*b7k5Niv-SbIu%Ikuo>HQk;`3*k?9++#3Q?Nb6Y5k)pINw$9Q$7hehBX zMsZ7ei12t|h2o&mf{&XpN0*F#Kg>&oY%KiiAHxMigSkJsEt5uG9iT;ieK%MHp6%_Z7I%l2urG0 zi3@YJdo*CvZ_SrvPWC}iWcYkxwUO2p%l?V3&XbT3cUzQf)y`Ot1P$s5YGYuF=-12Z z(2PW|)%dDiSgY~1?8Y&(#bgON*FJXpYy*9I(C{*w@YoIl9ve5e)U=(b*e$?WvCEC_ ztp&Z{gO~NDRhXD}d;Rbm@#eL;YsPBCoO)-?WAWA9Ym3z9i(Co~^0q24u4MEzUDbtg zrUNVj8DXk3c}XX{rLe}F_ONFSz%jJ>+z0Fho3V;fOw+$=KZv{3TOB}SBKHqxmC#=I zn-%)Y-O4^=ttUj>^6kUy!z1Oxnp5qw)^){dG^eOu1Xz%^&z|=~Uh3&eoWn+9-#mJZ=e7(`9(ejUzbUC zpVV;xoM*UM{HFI?8GPz?F8&*>{~yOa{2}fCdx4wOnAGD{vlrx~e_+Kw5RyX=GQq!=y1{j6Lkj(#Zt=how_#$6_mkCY|~fr*rcP zZ?I|RKld(dJn^ufLhTBtQxSQf#irYwjvSYNThYsZuISBj0$4u$mH!3u5OL3)R};0a zEUERLyCGVJ?sC|vJvB+ccT``EesSoz1dJ;KjoVopYZhKe0xL=E!|liITXiHiD@(g2 z^z!v83!S0!*zX0?)72CvChtx$HU0OelhsTH^My_Jp%Ku{p8%wftDtqsA*uf2ap)@*RKrr=lMo z{JQ6-8RlwII;?`IWrd4e>sM@jNMn7-&_;P1oyE6?T3+ov0by<%x=D{abZ|^lr0%_p zm-IP#9T~|yUz&QHuU+d>;09Q+dS>v+8ndOcjYrh|PO@*p*53p;P7s+Brs)YL47^1N zO;m9B19pFo`CZ!4B&t!J&@4;d^oj#p0|Bmj?d8)7jiH!|Tzp2PFmmw4Gv2wrg#CK= zqmNVwoFcxqXgq3W@RynKkgl5G3hijKNxWR^s0nvFk6-a!VPY9OZR|*_S&BPU|HwbI z`LGa`8hSuwGmnd>Yo!JV*G&EXf#4^z6)khV!6A8HXB&WW|ATapU2O!(;G0&eFlpIe; z7X#emlU2HhamULU>wX;27Fk0-GLD^JnM_C(k8^6(mZYW-cRel|Sj3#??Y@41f>5Xr zV$Iou+V!5W`cdbyaxGYxT4_?gzpspjS>JkX6h^E+v@SU5CY!I(RxBR zJyYo=#?O~E;gz7>XkY)DSFpin)>p4fB(L#G1e;|<01MSAu^cq>heuFkjyiF`%)}E% zs}nfTefEZ=n8-u8lJH#g05-{OI(U*9ngS--`Yh%_RGogI!vdbJC*fMG?F^5Z00?QD z*_&m{xIuR1xW&5)&&&K;2d3MWbW(AuDNCZ)+oE@jbM%mwdJ07}`JdV`y`w*OK*$IN9|D5%YuV5ZHnrb+!}cK!QXI^-52 z7Tbd?AyuB?uGhEgX}PeZVf6MOo>BZZRSZs5s^0F6eFg44Sxm3Fe6^rcF6sS+7rp_$ zE2GDwRz<-p-fqcmyD@mBFf<=~;*Q;og-ORkx9+d_>#g}h(DCD_+Gahw{Z8WDqAdAc zGZWm3ES`p$}vV(ty!)Ql7k|%r;4}Qa9H)*v!6F?ops8m zVHsiQRiO&&kvk1P0=O<(7|$AlgeeI1codgT>N0_aWUEdraGf$+S_hk~h_F>>$>7qU zIYLq=I(-~h5arV@A$_eLbpL|RlCc_t)WJvF#|aQ9Gp{zEkl7CFNY&M4yJY_Cjjn`F zEL>zg&22ZV43>VPwA*7I*z9uE;<-$NV3?lIHA(Rw0=w9|B7B{74eTEw=dxv8G|5Ir zW&I)_FUMI_>VPq|E}qZV)1*T&S$*#^xGoMlMk=AuiJb#fh_W3)XW}=GGK@jMq;Uum zjJ)x4Il+;DkHYPtxA)O(MDyb*G1h&XIU=_DFtn{9BooTZQ$1vPstDsK}KFNrhRyLuU#zFtF%I%_)nFlzSaGCpxtsF0?(MMnO^PvAqmm%f(a3 znn-nb$W9H%E!F)J2Fo-p!QFXJ1a&kmuOsBGPiN9hd3Xv8knGlB{6AGY;Hl$=9?zNG zH-#r95vr*9KiJN*Q!~cC{U!=dPaNAie>2?AB7+y=F|k>e*QbMDC8tOCegk|lI_+f_ zru^!KFBTt94Sf7I9_2V0TMzo)XJV*>JM!xOeqSy3o|c%wLWGc-&b!C<=JFS-3MYyh z4sxqpCdy@bA+=XmZy4zx%56+qP11;gO*vUQRt>fcysfHPW5!=DqZ+XyG`w!#da}uH zoBLh$LZb;aVUamvF91LjbGxSL5*rW1VbtYIAlY;sp^GB*WGkzg&UIX+iVMo+NV-@k z7AT-YK4CFP8esK7i|fK83?C7r9>Y6gbqnRYYaFoZGJ3?EU~4>Aajo z%xVjb-Ay$$HIt>j43n`6o9Rx$sjUa5q>EjM`^#5@3*H0lWPFE$`lRfN*#+0C3rnG~ z9&UC@TOm*CgDrU=oP{15PA$k=R+^=7xBcOqKveekBn3N_R_#m)m)NMY<+fP zPG!)y)oY6s&%?-Pt4vQ%jxkxWZ94JQS~$A397L>@{~C$n^F(^FUu{0|jH)rA3N=jc z`rZM9^FFI}O#jN)5-(zC6XKZLgvD9|Bu=!GkU}i`_0)ZwSyQe?o^HK7a*^(Kg=^bQ zQmVeN{rN!M4qv!Aw>js^VzMk(|4;laX{pc!Nwh1+w=M~iyXNS%aTQ z3wP><@bO0-y#6&OK+Ionyf9F8csY?ZV(0B8RH;wjK1-toVxS!<8iW&@JsjVyuNw8W z-|ahSxW`L*J^ld^|CZq|sJ6_L__aIYzs3hfr(5kmQjvVNL$i4*AbvY0$2Gpxu7vvO z+Oc%(y+Z39hO|$Pj}XM0BnSt|Grp#2O|nMZU3cWtQ1WXp%E^kS`6o-uZ+Ee9+lS^E z-MDWw$0?9QcT>MIBks8HIsLo`{&_e3jpcJKyRE$3p$C@ce0{tX@j@Y^+YTYU=C#jW%dyOW+pRi`J1 z&Ea&SO)Eu>hT5G}J*KlN+A25R6aP-24WvWL3sddf6kTaLZi0Wz_Okw>GUlFz)zliP zyG1!T;vv4`R8jZ+q)dc1EH%fY5oai75T* zSIh(ucRty#RBBBI%H53NqZy4|(V13c1!u4y{-0offgnWkcuBdLLRpN-dowDP6h-g$ z?fk}UlyV4wUecd38C+%KtUSmM4~+wj9u$v;XEa~U^y7Fnfr2Dm>+wgthN1+?{Ef?g&X|G=(r@!gBvwFSO z6|W@Wxx3CmOMwQ5R>W4{huU!L!Z?6=11t*bsRo19qc7wk^>(LmCc9ip+5p&3KAqWZ zisg6J1VSmQF_JzFLIfP|ncQYdLG9>l9IO=S5!%SC@tq|BcBvX>YxRnrmV@uL8+c?W zUSYIeE-&h6&wS6tw-f~nm(Hty5krOk073)euc;B~&-)7dk7TT0>VdxdW zE=%l^WQDFK$km_N^d|Iv)N-$I%@5OU$^OdVtzD@e}1nmqGVg z*bwm9oVk45PGj}MRgc}(0qpAG*Yr1Ya0lj0Y!lXTR{FGEtKp7-^)Mp^z5eXuxC~Z?oR$1yM0-&5)?`-o92O^}K2%5^f^LGo>y3HB*%^;$B5TTtuMYhr!j{W*BbwPPc3ykxAh7LLTj9ScK zNZbk;%y6>vqJn3vvvL`ad8(#=)`Mr}yh~gIZ*C@1hDpe5i%WZOazE&jP~Z$IZ?f`O zdOK)Hd;C|Z^MXypSM{1ZVBP_|_5rYEazp8%^WWuPIsv8}ymez>zO^}uA(iXB zU!*7Eeej6Kf=%0jda9&*4>_$6qdr5m{@Pre(T*;WRi~`WgBs!DHP2#!s!3xxGN*0C zBcd5oz>tts9YSce*g#S~UU-Q-NAZ@{ypf$R+6z>(3DF z`=)l_>&5ta9E35n5!mjC)T3gdr9_r{jRjuD8I_T}oeC`jTd#AiWY_ui-wlnW+E2s^ za!0w$Ei<(6IRVJRy`F~q3t(t@p(bnnSgO+s>zP- z!*C{77C>Xqd*&#n2oHFf!JYaOC7eE{Rp*+))hCsB%`8}C75b=CB2{cS`;}xytqpbc zye=%UEYxv$Mt%Oe6WWDOU&uwH^U&_cPuIkWKvIkfANeKRw!dmMm#-AkB}9%m8^`TU zk8*|V8WJYIfk2MJI>^Dvua&nZ?}NsVmNN8aJzhQOEzg~M_k#!0wITq`++1v-QqwYA zyurd=U&h{RY&Yt%0FDR&f-IPdkNu;jbL>vShTcFl)~R~dT$>1~bmhHd9$2C!OYj-z!m@#YTp=tmj@atFKWh0GF~t5AD`KsX36n@8Y`EBGA2>^g=b z+;n2DN}O!QI;)z@a`VnWa72@MZu_S zO7P6|TJAgg3y#6+&47Y+mT110Bk%H9M?;y#F`0#zVoqB(_I>Zp)q4viYxnwK+9Ab$ zS+O}T5P0EMYr$+nE6>^Xkl6W!8-}jVJXOeFzOmqi7 zmFjMZNeaMtHjnqF=pw607E!H_6go%*<7d@+C~4Ehk9oFqzdG351ibuSDY}$guKXk^qzkC}e3mjQ&MY$>JM;wsm&dM_|n zNJmtArMq55rMCPuA;iv12xYa7x>NX3YUTR+UP&pu?M9kdORUZZoTqYG?W`iaCqaVaN@(c8! z?Q3Kx$%uw%N5CZ@dqV~tP>|Ofu8gUTjkvkZuz4im!3oiFN5yvUBZT#jUmLk9Jh-S1 zWyFti?0&(DmsOrF?#x;sSoB?GHg(*_WQq^6^86>kGae46$jr(3auuYc9s2domH8A{ z$M9Q-d8G2JDO`W({rhbHMAzzw{RsUm`>v~C-p}+H_&2`zm`IZOw#L0FlYUpb$CDpc zc-bh#hCavJ zpDkN_>A?}7L*6jn>-nvz_w+G2&c|L~c++jz)zBZKfxv-(=Pe*d!^CVNDS+TY^+#{5lAQwDhI1OoK@aoQc|T8PTf^mhdO?oA2q zzl7AD1!=DhO4a6T)Mso!AlsCmHmJUa@UA7u7El?@Wv%>V%-er86=wSHttxc%NCgnr z4C-jT3Rjahw!YZYHOBD3WT24B`OG8WvQ)$iaQ?C@KzzVO(0?6hFzCN{1ms!IoHR)L zenr9Hyuz9%`P#*w_p471R+>?}6ANgkvq?3Niykvb_{~d^Ch>>4BBdfK=`j0B=**rh zHH#Ro_jKJH0SrsGxfrdNM`4oN6!$|^j_)yENS68&{wD#^j?;hvL)l8_nzRk}5j|Wj zZLV=%8MT6Y*u`>q9p*nk;cZ6MN|~EC!>&^+0Z>*w>qA=ga_xqdNmst`S8nC0J7P@C z%*;&#$;Ya6e?$0m3Ig3nmDII;n%gK<<>b!sIg^g>lZ=edeAL?!GN>Xyol^7IcfHZO2>4fh9eA8}y^H=t%eP0k@ktD#!0gYy>O6+9xcKgFqH05{Dz*A>~#>A!l(W zF@J&dSF^2yZr&J=cMpipdr?*xUSu0p1vtr;`dH}98wp-3DH;9H$A=9sa+$L}{KWM+ z=X*|VI{MF8{=>j#6H3o123{-a&)9>k-NV_s{-)3Fcxr(JB8vAo69=y|d_N9>VI~M+6W?8Jm(22bX zcaRHE{fv^W+*N&(j^>V#P%hN)2HoqMRNVytU_YsQ?jS^EjE>PlDpQl#8nLc%& z-Gxk-HJJsPd5!5(OOS6~a^pq|jme?G)UDd7-P9mO+{b}cA&bIc_fyG>!j5WtEO=d` ziey2Q*R#2fd-oxbfFV&dtoocW{3RbRMSE{{BPyp|2UM**AFZbJI1C2_=Pufqz$JJ{ z?iOZ`>q#TUG`;&OB$FO@~=boy>-?zu}w+uotHst>GLq8 znF2|xVT}bsv+`c!5N3J)5eEk^fMEIEoqU*E;F^3n`z9^~Y>@Z0jN_79BNLNZ9I=E~pneNW1*Gg_ZHz z!!x+GRzB1e+YuXF-zdhEBDr60GBwZ&Ni_>U<|rm;c^g_EtaD5kREi<}IxCpW<~8)X zYy?L;-y3%34=wk2%iN$&7tn^o0}tpFQgLY5(^9M=?H|PT02+-moLm|%L4@vozTLq1 z6QIw+aJvn=^>9>fcPdp+fqQoNgW0Q@5JAhgd0ev8KUw|X!Fb=N9O?Hz!Favew%_O` z9|8?SelY*h&8}Gbqe~yoekih>@c07=18Wt3@89q#)?#34X_K?_!*CZ9nbP9!o3Y;8 zQ(v{hOf3w2o~P2SKKK&H!|xyZ{4262+Q~L?kmB~Ah#Vu57(kVz2kIF(r%NLDc&u{k z`X>+0n%Wi9aqCQId7Lz;;P`3B;jIus!o{kV3q^HDA;T4`M{t4pm|9!9+`SH;dcOU& z4N==o0mz6rMAs7W9!oQh3WwCj+py3-7G{Mbkal058cMh1Ae3p}9ExivmV zs4#90jsX=0BH;rDIGE@L-7q<4wi0TDm|JLfHmMR}r&?7OuSLo0Gvz3R(*SsVhB*-* zLrL|_>(AMVp^RrX-NAC62_Zuv3WPy1oZzQFGWgs%6kf0F=)_jhzj?MaHtP)Lp)2&} zDodp*6<9QdI~;1DaThthpdJATHRD%K_Ywf1CRI#)c;+vJuOl>NNgi9+1A61;dT4J4 z9Z}73xZBR9dxI=-0i+%cd2QGUn z=iay6P|2f|J&1ZC9Z6^lK7-~yI1&}a=)Km8RHBYQ7t3kz zpu%R1dD4rZSahSsHziTtfEO|kxgjTeRh2iQl1_}H-SKgdJInYLhmIRxP2l=<2F^n> zZ%=DUG%F57Ql}wRq8VJQdCN=iLINE5j#i=L4d1~Hc2kDl*Y3SI?GV0cwGMUB;uyAi zi|Z!r)-^rh-D2FIGMZllUK$nS9^RFH4&*=uDfDVh3qnVMtTRTf;uYYpN=A#OOmb8h zJ`dl{L5TVs8-*%r8R;(PAeN$Nuf)c(nyQtR!6v z-KzYa873H z-9>t#=Tg@D^OuVcj~l@*$3sRpYkg+on!?GC3x{_mXcX$@nM-BBSreoMvsB~0*t#f~ z=w#mS+a3Vr582r{LI(k~oPCca4~NYLG>qhY2wUMbAlt%qGteMa2Sc^a1EuE(Uedmq z{u{V`b?pz#_itGJ;YzzyxBpJ-1GZ9JoT0~Kv7KSl=}Axgt=%b~#^GYqAh+Y~p(}Zy zGx&d*?a7O10KEN-uJusQY%$P8Nj^o_=n~9LG1UIjExa*O11=J3OoRGGXViXutA~5v z$kc|Bg(@!+-|zYpnAfq=0G8zcKgs9^-)zUQEsze>No`1jWS*WI(F``_&TZ}0wj zUjMfl{*tC7ekDP4@5h(!+{~Hu6yWOEOE+8l zdV2qHSpkrr^sx-c`n_)U_8NUM`QMX>v!Oo|czNZ>wff^1qrd%;ngm>P;O7S9{r+o0 zuwQY%)a%F*LJxV9UFrtehGUk&$f?%}LzCqCBzR}l4M-I`KrHQ^PODAb@Yy%^DGEMX zD^s(3bc#Pv@;>eCXplhtyd$7`$gU!#RV+^Ds!oe?!9-lFELZwT;^^(@S)V0I1ig!~ zXcl`!L)>DH=c%3Udg|#w^7NSJjxIy|)7hRPiM8aPDWunXWmk$Qt{{D+^vgDjw>*zU z-EpfUr9lz|t|~Ug#*_AD%+&T290O@=MEO;@9LrA1RKzG3nW;=d*1+V2w-n}2b#+^e zk{ci9qki;9D%E6K#Yizv>{!^MtO`Gf7Qmdxy; z@4IfUSDuksoh6=0p{RcdK>C_+!ZS5!rs|D8(Kphy7Mdp~nJc`^twY%Rj@L}Qx60=2 z`;70KJ`>Hdg~E>~j{{<+Bf1&|hMY25kj8Ga_VTHd3$Lm2CQlo^w5G%`sbWl$HJf)f zYFUyvl_bCKCS}Ue8S!1D6}ZvwPs{JC>i-0T2l8GMZ||R8Da>iX#uKsg+UY1^rY;~G zWf%P)m69@94+wV*SlsN&jO@Me=~9rNG&{t*!C3<;O_rY*G6O`RB=#B&dMU1C->*Q5 zcWzQz2sud^Rh(o#R;d~2jN@}WI5jA4?^lkTmt8Ix?H8qFr>za`i?Cg2_sfXL1DtT1)PC0VHWEX2z3apw1LxO3`*8#*rJz#6)!Pz$Aq#Zl*E1i}*<=>fq=~^94$y z7~K0d5uc^K{5HoWhiCyExc4UM^GM+xn~wKZ-2oWwYgf*e&Nmep0a|#4n-dBZ1iAA< z`mzo7n(df*c}fcLBD<6DwxkZHr52^mp7@SV8602$b50N0}l#PQft&~ zIn_38qza{@l_v}NJSNkuw?HpdR@BSSE_|4L%Uf1hla|dMZl$@kzRm@UyPb)6(tz*A z?llc+Dwo!|D=^E3!A1^NR!g1NOBdr>KO;WM3QDJ!Jw~Iae(k64>T3RabP(i*zAVK0bq03GOY)WH{aUIy+KA2xs zRFQve1`pX3P)y_~dMZ$(qjqR3v!V`%w#Y8j3z2DRKx$xdYUGp-{Ux zeF)}3e{N7w7Zv8+@Sp`8a#SvEfN)~p&+}kGq)w$KS3C3`M#byKrH~M3 zf8Y551Tz0^fVONIh8qd3lQuIqFd$k~S+0)p_hJ)h;HQTwjcs^y;p!=NIAd{5Cddc=*v*n4y5(;`W;26RlV zZ5H=rQude4*wH0sED%15|9EwsZ;T|bB12rx^<$@BO6NB$Urq3)1-$TlR<}gRJ8_7d zwHN+j&|uCJaC&?$!q%P0X$7X-bymlGz@QFST;F(r77S0r;}chE;O<#uy*<#O_kINe zMc$-a;Wg3X5EkGCJ0HEchdJhvtHJe0M9hbxOGY?RV}8n>%!>TCHHAK3KkNE6c_Kq7 z^eT4l+ysBW>ej;#v&Ai=fo@}_;Vaw_iNs@@#O+RT?gO=<=na)pPEnr^0;qP3NLRU0 z3$x`IvyI~iFg|1@aY&Y4E?<&Ip_3MSzLZ+KsB!+q7OO@@R>&>>raEbLmC0q!D*Xh6 zr=`wy8m&ph&%NHU#9lg=cE#QE$$+u0J)53css6G`3n!80O+A7a(*53ym_ZOVrer&A z4r7=gQ2&yRpJVh!#T|qBrL0GUv~2-1qR>&c#@6Z&pFv$`cLDeb{S>O^|9T6D@_z2} zMn}8vV~XvM;XdtkE6^CDga?TmPkGtg@mLjwRsBN;FCfarxT}KIpfSC$=s3>bdyJy` zGFd>y;G~yPpajJ?kBC=!(xdB23-w=GDvabf0#rQ})sI7lt2PB1$qUrJ0!fM2upVvo z%oV$zUJg0$O~@c-vb%{NbtVh?92AcWpfLEzw*HtkaTfQQov?xd^njiQPuyCUwb6W- z|2yqlAdJ&a*6y&q8i5JgGP|%$Qx)G*9skGB_NXsHAaW76=XbxmwgQ)w$nR|gkUPfz z<$4R_I)2~C;<~C5PFbia2;U-e^orpx>V7o+Ecut&{X4@y-Drf40^k7^2nJA2f4#@U yc$LpL@)H)FY~H%0bRIF+MfsP?mU};*UU<%~ZWhQ@F>((0c`T>&uu#VM#s35Nl=wXW diff --git a/docs/parallel/amp/media/campgpubreakpoints.png b/docs/parallel/amp/media/campgpubreakpoints.png deleted file mode 100644 index c3195246a9ddd4be7031119db5d57b1de6c1fbe1..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 4115 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 AwEzGB diff --git a/docs/parallel/amp/media/campl.PNG b/docs/parallel/amp/media/campl.PNG deleted file mode 100644 index aa55a8b92d1436e707b44b4fed6bf096c6697a14..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 35513 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 diff --git a/docs/parallel/amp/media/campmatrixanontiled.PNG b/docs/parallel/amp/media/campmatrixanontiled.PNG deleted file mode 100644 index 9d614e606398f08d4c92a75cb1b99d29ca44625e..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 919 zcmV;I18Dq-P)FMd&+1a>>R>gwlv zdwb{Rgwvs%F5l{-MhQH z&d$!;+uQp3`tb1Z-rnBG$Hd0Q!_Uvm=;!6f#=_&`-pb0x=jY_t*3;(Y;p*w<>FDO( z-P_{f-SqVI`}_O;{{8>}0RR90_4W3|9)14+00L)8L_t(|+U(iaa-%R524IpX+7%Lr z>VkVOY1^wo=KWtPlz3nl*~Y`s%+8Mg8()z5ET4cl9JIaCXm6hpaLRn7>#YzpEnSZe ze58lnw&{60pm?6y?uMDKrTX_DKRvlj{YNv@bG{4D51;zI zZpKHgHaxElM}u}NO8L-)=ck+1+zfNxgXh=F?ZSKGckp~io89a#;z<(gYO~mJ zj$E>}cr-!eWN`>;z}qOs;{%w6{>}4omG==Rb$Di2#ag7Rw;gF0VH>0d?CHL zW9v^|Qu$JW&hXSo7BWUfXF~`p^Gv=QXWwg|=d(_R8ApqQjr8A9ImR9A1nex&@^j|+ znPX)?sJhvYvCXb~&Xxafd2R?K*{>-V0)odZ#$3`NlNjokI)R-wWS$&O}!eL}_Ie*c><;tI&Mk(ftVVB}jo%#9Kw+~;QU)}@d<@r--(Aa7Z zMni47?sV=z(&?+VLQAhfN*&ECk tH(*)JO9OVruLo4W+)({$MqOS77y#_ag7ZeB+Km7J002ovPDHLkV1iM6^&$WO diff --git a/docs/parallel/amp/media/campmatrixapartitioned.PNG b/docs/parallel/amp/media/campmatrixapartitioned.PNG deleted file mode 100644 index c7ea08435eba5e24332d2c877e3aca1513e8f1e8..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1704 zcmV;Z23PrsP)`0000PbVXQnQ*UN; zcVTj606}DLVr3vnZDD6+Qe|Oed2z{QJOBUy+fYnYMSFXD$jHd#Dk%Yx3{;r zxVgr~!sh1Z*4Edvv#^<&n#ae;A0HnsE-qYLTn`TqO-)T}Yix>&iv9ilsHmy-_V)Gl z_5A$&_xJa>xVZWG`R?xS)YR1I=;-qD^5Wv+ySuyU>gvD0zuMZ`%F4>l&d%H0+uhyW z<>cY(>+AaZ`rh8&@bK{G=Hu(?=f=jvwY0J2<>AQ3#OUbdwzjg@*3-($#=E+==jY|m z&&|00960|Mm6u)~phg000GJ zNklzF3}~#sKYV@v z`R+yk?e4e3lgS$mrntuQ57AKU&(q^~lleH|I`}#mu0M|69-kbFny}e427Syx7`_>q?0?Jw(W)R1Z&N2+V7$PfTMj8ScQ9c1duA zJm2n5CS0n!{Ea`&Mwc%i%5zD%<>iJj^&1C8*TaM`+##fLT?&(nxPE#yd5y~(|2P}H z`W9UJ9Tr^ny&7DYn{kL3hHJQ9x5-5$s>3Dp@XQ+%(R1L!EPdZq<1p}ysE(~`E+Mlp zs=}qei#@x;cKt;prIMJbOUk6J3Kw8NP}nus(>%61wIyvuT#mn`%K-QVvjZY6kFQNu z#8nVu<+^N?OTGMtxwubA=UjwJ%9`b(OuD#pf2r}1-U91vAVpm+hdNOpvrd*7re!Xu zYFOE*zx42evSWWi8Xy50^%qy^&<7p+OU=26!bbf?NgRsZ`YTXNhj3#)1iHX6D~^Dr z!E19luF6DsQ|OC)SS(AJFcgjEL$YQ5Dyn)hbE5TiFM?=umugZ6o;fHHl75@>auF9r zQH}aAzJn3uzH%05my1fzcnCG;g)XSWWtAj|Nt_nbEpe%!!R{&;RB6GXL3J+Vnt6qI zm{ZbreQ3lYl*_hiT!33jP_T4jSuP-Jb8#cTxhQL^#AUlH(t1v?6BnV3RO9mFwTQ<7 zXGVepG;Z5fk76v5_6mfcz!gGAd!k2`;gW%bRk%o6DL6jBR^Enj+phYdzN7YX(LCTJ zcS`ib5?okj`Lj|{)0u7I(xF_all7cSs5*&xSys!(O?fV4g&OfeP~(|lVe}$Wo{P9@ z`pJY;2=h`!+3|&-wEXRIz=TdM%HYo93sN9l>uYLePW84Dc_SXC$gPtPiKG^nYDN`w z>@**u!s?8(@_H0XONMWtV>`4?9py0dnE-nhI(C%)7E_JO{)q-t^c=X5hildI$efx( z5AZbJJLGa0uDMPz1rU{}TjoNLbE80TT(C*+jpGWh?=lFKzd_eJHpv$$xhY_?KJNt^ zBrq1b!Y-wVXqJl<*Lc-+(FlXUMP2Knx;9VVloQX}q&AoIfMiulfkt)Fr!@$S>nvQC zOD`IIQN46)hKu78>&l(Dn6qYhwaS%SoHeBPhUtR3Q@uChJVLlpf4Kw!7Ip0}XDOLA z#f3u({LZuk%V`HCI^s@I1kpLPu$phaC&+FXe7)FoB8v_8+IxjYb}UH!1An)h&B z9a{jiK3ul7#l@|dK@$hgD-PqfX7T%Nu4k5aGY^_S|@ zw<~Y%SLcG%%Bw(SX3#d5F~(vIppHIoZ+z6{LAp?Bi7U{*ofsob`dM2guE3tQxreef zbWN^IEML!+>=y-YX#K28WZbr^&X#Ra<@R?FPxi(pI$K`&-`!uE_rVtIi>hnewiM?l z>E$%ND_39aJ6F%RX2axK*=JtjTtHuJ#Ew#E3( yg=dHW0000FMd&+1aK+8 zxVh@;=h)cQ0002T$H?a9=MN7LE-o(C*4G~&AN~FPnVFi3ii&%Cdt6*xYin$%sHyh$ z_VxAkO-)Vw{QS7MxcB$>`T6GS;^N}y=;*t+9>?-QDWy>dMN> zzrVlQ+S=RO+uq*Z@bK{Z`uf?})yBrd$j8LxgVO<;ojZb=jP+u z+1KOZ-sI!q;o#lE!oSMO#^~tf&(F*~JwEjG^!xk!{{H^||Nr&%_T_6u82|tR=1D|B zRCwC#nrD03Fc5&9QMDfO#sjnWNYW(TGp(@U|No=Pgak>r4FubA`sh9Yw!wORr#qdF zla>__Y4e_N5fUOX&3ep1>ZX}IKqO||Z1_R2C{=>MZ#3gIg_JV9|M=_6r`z+A<@UVQ z_ODV33}MEvS6t+Kw|D8s<~>A{6U2|sMX%jlLnQSECx~}ar`u}OlN2KMIYE4#4n{*i zzJ~}nLA>ox=Hp-kvET&pCX!|+3;qzN{2|T+MBWf8P?$3cP&2=&06>5DPzV_dT7U8o zb-|Vqgw&uKM4HD8uL1m8Lr6o%Kp^x;LqjMSAhgLdUezxIWgpjF6%L^zW@hRjtdVNbJOFLIPzc3PGUhR<7=$Mzw2FkVAgc%b z%)nrOp07DlUv}YScp9YfIV+hB*fmg5fB36zk*N!n-u&#e<0$xo+|{< za1gH1VH+VbFgR)SlBuAoA7fpj+JRne9n74~k4;p$*`j93NyLy2jM~Kwd z9MU_i5Dx?Cv=%U_HrAezXJ%zlXHAf)GcQeeFnh0ACd4Mn$cI7fU!TY^Y(Kv~ zk>?If)F(uJLewWjeM0O-1%!YQ^$Ag*5cLUBpLoIbiKonQM14X503HRw=1ml diff --git a/docs/parallel/amp/media/campmatrixbnontiled.PNG b/docs/parallel/amp/media/campmatrixbnontiled.PNG deleted file mode 100644 index 2c7633e1787587a5343ae957e79811464af3dbd7..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1002 zcmVgwz3>&C{z+uPgD&d$op%DcO} zzrVlT-QC*S+VJr3-rnB&`ufk$%*x8f-rd{R*3;$W;k~`P<>le$=Huq&+0v@ z;@;}%<>~3^$jHd_^z{4t`~Lp^|NsB>_4e5{m1+P00=G#-K~#9!?3ve=+At7?*;OP* za&MU4JKNKf1slKrL#^b#Ym*T0k#6`efa5{v(`Y<1$c=+wHIny$yNUpTEH{15YRYnu z0tB+(Y8#fd=O)WC+ATjKXt4SJeB!R(-GTAI2q=K;{|dS5c{IE;d^rYa{p1hu(!U=L zS`k3dY=7qu@VM)by6tAb0DR*ce}Jd;Vly@T7{L0%A7H#%&L>s^u>Z^-VCL<%uX}+2 z4R3dI1^{9rRTk_(RKBV}2Oj~rJqrL(>9ES;no!q1Uet7G+PD?~g|1vlrb1P&0b$qy zAFt}vS*prD5$3u}0DujE8m|ge?f_lBQ*w=zps`Uvmo5ST*-Vuo5IVZ9mz)hK5==+J zdH|qV9i1S=YRNYWknCQsRsd{QI{?DO<0YwDtpIUIm8H?0aY`Pbd*ZnGe*o~Y+dKil z;K*$qLR$h#X=5bG%m$nU;OGEIoxjDv`8o-p*GaZh6aY4U?C7D03edW7r^cy)H6e29w2PZ+COSR6cr?oj(8+481qaVy*RK_Unaze z)t8Xis#?g&q@$zUm`$%mGukF})!G1*xE*1^sycZd1~$r#SrGtIl8&)dXEkJV0F>7G z)QocD`*tAmkS-V?jw@jRxTl461DNzDHS;t8;%c?@18&rmVq}`MK4>n+ZhpTKYRh+%y}1EgaJ|+uc!rw_bVPEhl;2YMmcc9^}?wc;8P>(F Y0MvyOh6$Qbp#T5?07*qoM6N<$f~{BlHvj+t diff --git a/docs/parallel/amp/media/campmatrixbpartitioned.PNG b/docs/parallel/amp/media/campmatrixbpartitioned.PNG deleted file mode 100644 index 9e345d153e2024dceb32b84dbeb8b392b1442207..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1715 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 diff --git a/docs/parallel/amp/media/campmatrixproductnontiled.PNG b/docs/parallel/amp/media/campmatrixproductnontiled.PNG deleted file mode 100644 index 8632cfec78014d3b02b118e700c820df7311f4e9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2971 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 diff --git a/docs/parallel/amp/media/campmatrixproductpartitioned.PNG b/docs/parallel/amp/media/campmatrixproductpartitioned.PNG deleted file mode 100644 index 82b5f65cba4249086d28b7582c4b9d6588e980b2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1405 zcmV-@1%mpCP)FMd&+1bX$!ne1#;o#l4 zxVb$&J^%m!=H}&VB%%F4>SySv)j+TGpV z#>T_y>gvD0zs}Ci+uPgl@bKQ=-un9b&(F-t%EsQ^+v4Hg;o;ub*3;9^=jY|_ z?drX~yW`^D<>cYx;@dxb3G5s@Hj6#O0c& z>3G%;8K>#I=9;Io=_nr#Z@MnSVLqD93b292`uFd@{`>Le>zl62*DwF<@8%yY7;vSt zx27-hd1vokK1)lkX@9uB9lYP$ofcg4@u)vs9|s3J`=jyPa?SGoaDBSGIy=l~CD*V& zTt_Fz*B8Tz>!v?k=aa$di<|y&y_yVO_LA%MGuJjm&`m}WB$|!1Y!jjy0z$UTg#r+? z$w;X-7(_MBnytM202!8JFy_ujZj0+aC@LG1yI+=r990rjoz(ZK+vbXOz+kOORJ>HZ z*qNLRG@PE01yR&|P80-~m?XfmsTy+}M8y*rqpfoZVnS>PMusxun;bGxXhJTG^l(u_ zG%^Y=%*#=gksz8DPr#~uE`_x;p~e^o3p-%A-T-S}N*M-QmW0jcWC;#PZ9#Wb?cs#w zvYnOnwa67~g?Mam2+oRn_RCH#iHio^^o%^oLhf3Sqgt339AVqZMB7|Ah6xa}>dsat zCp1AYdBmDefo3TUVLsIu7k{>s>RPFpHQJ1esH}**R4Jc^5SbEX+)X@77%Ksx zRtRsf5MfBls9X=&lne32@_^4V^;GS#(BcvCtLYvhmGGyHn)h+Rrm%Y16J4Jpa0Lp? z<|(;EsAAI^mx5y()CP_NxriIUh27Q0R^%hNwvgql=Ms!#Tt#vc35*gaZwa1szgp#r zB*dI$W>)VLptlPtSF3L-wo#NAk1At2fjuClsm`dD$7;nC-il80wZ z*Qz=*M8COCxtlFLv`mDrdZiUr=S2NxF1k8N!ZxoxJ*sZ<*diB^EC441|D`AGwRIPd ztTDrjC)6Vzus8(AyjImIzgp#r5<-xzLC7LscP1BdV#_be5cng{&O$pCh@thWPWja) z7v<&rAaFC(tf6e(1qUgLZ7$_0my0Z<&U?M8PWja)mr`ZsVk1HG98z4`h>h~TvNAAt zVog)kDZg6fl66Mrt2OL9yBkoU2~SyR+s&G?vQl-+uQs_vAQcw^%B;lWHwcr74s9)k zwa+Ui9Mt?}Wu>|-zX(EM3taX0he9b@ChWfGOBE`jGNM`HEnrkeh(ElQs>||=+T@%5 zQQu<=uH*v+UFW{XE{>4h7SlhjZOAj%GuJcM7P)%*JM7Bu=6${AkpKVr+s98w=dZdh z=SSb2dnx15{?5VR@?pj@s-dpbNJ@X#QPXPu1jb3eNWxz4Q00000 LNkvXXu0mjfztQO1 diff --git a/docs/parallel/amp/media/campmatrixproducttiled.PNG b/docs/parallel/amp/media/campmatrixproducttiled.PNG deleted file mode 100644 index 4339e6523f4ad274493b41597f2d22b0e8eab174..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1622 zcmV-c2C4apP)FMdXxVhQc*|)d1Jv}}E z007w7)#2dXdwYAw$H?a9=MN7L=jPgwvdySv-l+rPiR-rnBu@bLQj`o_k?$j8Ll*wx|T-s0ij-Q3yZ;@{`z<>lnzF3_v+w1D*%F4#+=;r9><@EIQ`}_O;{{H{} z|Mm6ur6t9~000FANkl*becn>auWl}GuX`oseOoEN z9CWUp+_#`A@ z(BLWa4QP7J|4NAsLjHz{%#rZ8gjQ;n?TFyIuF#@p1*A#fU-3q!XlNUhbI;5jrHXXr zGnVa4B#%+n^)P1!HpM%lloW%-vWU^DXDr*fQK**EU@Pl;07+9pFj$T%rd)+NsH7A#=Pli_H!5-k@USP1^l|tmzKb^)R(*0^`;R-36s{ z3X%6ib-zT}Ui(`*iR8K-5*U{BDIJ~~mCq@aEuzpl%~?=`>?EqwiBFeTC?ztkUt7dS zRuvs?nNkUA3sYrcb?o3tbV}wmE23OwoyA(4lbV!7SZ~zsyoiXmN~viQ`GLYQTTeOF ztfbV2<=W)6l)%JOy(3Cy%FK&Zc$Njqsb(c5jJUK|=OU;kz4YDfh7v_Siv}N2m2&v! zL4X(Isb&?WbFZq%-|BwLH1-3MYG)K1QqB^acePl9sXHeIW2{zIbcAa&DHZWlbIHd> z5m-7kR7a?qQek1>G91dkR76#=8}&EaT5eh z%8Svej|K7TOI}4%DmR=j`Ldf#Y@=fzOhqKYYoV0pR1gP~2x4GtV7G$pMiUXS^7hnN zN(7?-f{j>EBq`<`hEHO+Yx2G#g~<=)OiB`?8J82*BueMm;LpVyJ|=;4cYtB(omk>s znwuUP9j!a(3^9{)Hs0G?<-%k)EZssmG?SHKNxjG>Q4$wga_?-MiNd*q1xw9|^svNF zDXCg?nBE^Yh7t+urm)yg#1TwqkP`@PBQRi*YUhKjp^!(USU1>WsZN~j73-hepXZDs z7Zbq2H^bz{VRDKequfpX@|`GGa-X(z0E7ULN6UX(~QhWcfwUoJ(tp?(?am)oIiWc~8}Ew+jE%MXYOnpeMk z4@!Y+*WI@g_-y5?8HUQQWVE&r z^RIt?{aM@O^-psB-skleWqA+1w6}`>`A6p6sl;C%fdfUj7qc0EXYF Uc?&*jr~m)}07*qoM6N<$f@U9M4FCWD diff --git a/docs/parallel/amp/media/camptiledgridexample.png b/docs/parallel/amp/media/camptiledgridexample.png deleted file mode 100644 index 8a82b2c08f98dba4d2c43c651800b1a0ba0b7907..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 6789 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 diff --git a/docs/parallel/amp/media/usingtilesmatrix.PNG b/docs/parallel/amp/media/usingtilesmatrix.PNG deleted file mode 100644 index 0175a433a18b87395923c870febaa93991c83464..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8260 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 diff --git a/docs/parallel/amp/reference/accelerator-class.md b/docs/parallel/amp/reference/accelerator-class.md deleted file mode 100644 index e5f08b9b8a2..00000000000 --- a/docs/parallel/amp/reference/accelerator-class.md +++ /dev/null @@ -1,524 +0,0 @@ ---- -title: "accelerator Class" -description: "Learn more about: accelerator Class" -ms.date: 11/04/2016 -f1_keywords: ["AMPRT/accelerator", "AMPRT/Concurrency::accelerator::accelerator", "AMPRT/Concurrency::accelerator::create_view", "AMPRT/Concurrency::accelerator::get_all", "AMPRT/Concurrency::accelerator::get_auto_selection_view", "AMPRT/Concurrency::accelerator::get_dedicated_memory", "AMPRT/Concurrency::accelerator::get_default_cpu_access_type", "AMPRT/Concurrency::accelerator::get_default_view", "AMPRT/Concurrency::accelerator::get_description", "AMPRT/Concurrency::accelerator::get_device_path", "AMPRT/Concurrency::accelerator::get_has_display", "AMPRT/Concurrency::accelerator::get_is_debug", "AMPRT/Concurrency::accelerator::get_is_emulated", "AMPRT/Concurrency::accelerator::get_supports_cpu_shared_memory", "AMPRT/Concurrency::accelerator::get_supports_double_precision", "AMPRT/Concurrency::accelerator::get_supports_limited_double_precision", "AMPRT/Concurrency::accelerator::get_version", "AMPRT/Concurrency::accelerator::set_default", "AMPRT/Concurrency::accelerator::set_default_cpu_access_type", "AMPRT/Concurrency::accelerator::cpu_accelerator", "AMPRT/Concurrency::accelerator::dedicated_memory", "AMPRT/Concurrency::accelerator::default_accelerator", "AMPRT/Concurrency::accelerator::default_cpu_access_type", "AMPRT/Concurrency::accelerator::default_view", "AMPRT/Concurrency::accelerator::description", "AMPRT/Concurrency::accelerator::device_path", "AMPRT/Concurrency::accelerator::direct3d_ref", "AMPRT/Concurrency::accelerator::direct3d_warp", "AMPRT/Concurrency::accelerator::has_display", "AMPRT/Concurrency::accelerator::is_debug", "AMPRT/Concurrency::accelerator::is_emulated", "AMPRT/Concurrency::accelerator::supports_cpu_shared_memory", "AMPRT/Concurrency::accelerator::supports_double_precision", "AMPRT/Concurrency::accelerator::supports_limited_double_precision", "AMPRT/Concurrency::accelerator::version"] -helpviewer_keywords: ["accelerator class"] ---- -# accelerator Class - -An accelerator is a hardware capability that is optimized for data-parallel computing. An accelerator may be a device attached to a PCIe bus (such as a GPU), or it might be an extended instruction set on the main CPU. - -## Syntax - -```cpp -class accelerator; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[accelerator Constructor](#ctor)|Initializes a new instance of the `accelerator` class.| -|[~accelerator Destructor](#ctor)|Destroys the `accelerator` object.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[create_view](#create_view)|Creates and returns an `accelerator_view` object on this accelerator.| -|[get_all](#get_all)|Returns a vector of `accelerator` objects that represent all the available accelerators.| -|[get_auto_selection_view](#get_auto_selection_view)|Returns the auto-selection `accelerator_view`.| -|[get_dedicated_memory](#get_dedicated_memory)|Returns the dedicated memory for the `accelerator`, in kilobytes.| -|[get_default_cpu_access_type](#get_default_cpu_access_type)|Returns the default [access_type](concurrency-namespace-enums-amp.md#access_type) for buffers created on this accelerator.| -|[get_default_view](#get_default_view)|Returns the default `accelerator_view` object that is associated with the `accelerator`.| -|[get_description](#get_description)|Returns a short description of the `accelerator` device.| -|[get_device_path](#get_device_path)|Returns the path of the device.| -|[get_has_display](#get_has_display)|Determines whether the `accelerator` is attached to a display.| -|[get_is_debug](#get_is_debug)|Determines whether the `accelerator` has the DEBUG layer enabled for extensive error reporting.| -|[get_is_emulated](#get_is_emulated)|Determines whether the `accelerator` is emulated.| -|[get_supports_cpu_shared_memory](#get_supports_cpu_shared_memory)|Determines whether the `accelerator` supports shared memory| -|[get_supports_double_precision](#get_supports_double_precision)|Determines whether the `accelerator` is attached to a display.| -|[get_supports_limited_double_precision](#get_supports_limited_double_precision)|Determines whether the `accelerator` has limited support for double-precision math.| -|[get_version](#get_version)|Returns the version of the `accelerator`.| -|[set_default](#set_default)|Returns the path of the default accelerator.| -|[set_default_cpu_access_type](#set_default_cpu_access_type)|Sets the default CPU [access_type](concurrency-namespace-enums-amp.md#access_type) for arrays and implicit memory allocations made on this `accelerator`.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator!=](#operator_neq)|Compares this `accelerator` object with another and returns **`false`** if they are the same; otherwise, returns **`true`**.| -|[operator=](#operator_eq)|Copies the contents of the specified `accelerator` object to this one.| -|[operator==](#operator_eq_eq)|Compares this `accelerator` object with another and returns **`true`** if they are the same; otherwise, returns **`false`**.| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|[cpu_accelerator](#cpu_accelerator)|Gets a string constant for the CPU `accelerator`.| -|[dedicated_memory](#dedicated_memory)|Gets the dedicated memory for the `accelerator`, in kilobytes.| -|[default_accelerator](#default_accelerator)|Gets a string constant for the default `accelerator`.| -|[default_cpu_access_type](#default_cpu_access_type)|Gets or sets the default CPU [access_type](concurrency-namespace-enums-amp.md#access_type) for arrays and implicit memory allocations made on this `accelerator`.| -|[default_view](#default_view)|Gets the default `accelerator_view` object that is associated with the `accelerator`.| -|[description](#description)|Gets a short description of the `accelerator` device.| -|[device_path](#device_path)|Gets the path of the device.| -|[direct3d_ref](#direct3d_ref)|Gets a string constant for a Direct3D reference `accelerator`.| -|[direct3d_warp](#direct3d_warp)|Gets the string constant for an `accelerator` object that you can use for executing C++ AMP code on multi-core CPUs that use Streaming SIMD Extensions (SSE).| -|[has_display](#has_display)|Gets a Boolean value that indicates whether the `accelerator` is attached to a display.| -|[is_debug](#is_debug)|Indicates whether the `accelerator` has the DEBUG layer enabled for extensive error reporting.| -|[is_emulated](#is_emulated)|Indicates whether the `accelerator` is emulated.| -|[supports_cpu_shared_memory](#supports_cpu_shared_memory)|Indicates whether the `accelerator` supports shared memory.| -|[supports_double_precision](#supports_double_precision)|Indicates whether the accelerator supports double-precision math.| -|[supports_limited_double_precision](#supports_limited_double_precision)|Indicates whether the accelerator has limited support for double-precision math.| -|[version](#version)|Gets the version of the `accelerator`.| - -## Inheritance Hierarchy - -`accelerator` - -## Remarks - -An accelerator is a hardware capability that is optimized for data-parallel computing. An accelerator is often a discrete GPU, but it can also be a virtual host-side entity such as a DirectX REF device, a WARP (a CPU-side device that is accelerated by means of SSE instructions), or the CPU itself. - -You can construct an `accelerator` object by enumerating the available devices, or by getting the default device, the reference device, or the WARP device. - -## Requirements - -**Header:** amprt.h - -**Namespace:** Concurrency - -##
~accelerator - -Destroys the `accelerator` object. - -```cpp -~accelerator(); -``` - -### Return Value - -## accelerator - -Initializes a new instance of the [accelerator class](accelerator-class.md). - -```cpp -accelerator(); - -explicit accelerator(const std::wstring& _Device_path); - -accelerator(const accelerator& _Other); -``` - -### Parameters - -*_Device_path*
-The path of the physical device. - -*_Other*
-The accelerator to copy. - -## cpu_accelerator - -Gets a string constant for the CPU accelerator. - -```cpp -static const wchar_t cpu_accelerator[]; -``` - -## create_view - -Creates and returns an `accelerator_view` object on this accelerator, using the specified queuing mode. When the queuing mode is not specified, the new `accelerator_view` uses the [queuing_mode::immediate](concurrency-namespace-enums-amp.md#queuing_mode) queuing mode. - -```cpp -accelerator_view create_view(queuing_mode qmode = queuing_mode_automatic); -``` - -### Parameters - -*qmode*
-The queuing mode. - -### Return Value - -A new `accelerator_view` object on this accelerator, using the specified queuing mode. - -## dedicated_memory - -Gets the dedicated memory for the `accelerator`, in kilobytes. - -```cpp -__declspec(property(get= get_dedicated_memory)) size_t dedicated_memory; -``` - -## default_accelerator - -Gets a string constant for the default `accelerator`. - -```cpp -static const wchar_t default_accelerator[]; -``` - -## default_cpu_access_type - -The default cpu [access_type](concurrency-namespace-enums-amp.md#access_type) for arrays and implicit memory allocations made on this `accelerator`. - -```cpp -__declspec(property(get= get_default_cpu_access_type)) access_type default_cpu_access_type; -``` - -## default_view - -Gets the default accelerator view that is associated with the `accelerator`. - -```cpp -__declspec(property(get= get_default_view)) accelerator_view default_view; -``` - -## description - -Gets a short description of the `accelerator` device. - -```cpp -__declspec(property(get= get_description)) std::wstring description; -``` - -## device_path - -Gets the path of the accelerator. The path is unique on the system. - -```cpp -__declspec(property(get= get_device_path)) std::wstring device_path; -``` - -## direct3d_ref - -Gets a string constant for a Direct3D reference accelerator. - -```cpp -static const wchar_t direct3d_ref[]; -``` - -## direct3d_warp - -Gets the string constant for an `accelerator` object that you can use for executing your C++ AMP code on multi-core CPUs using Streaming SIMD Extensions (SSE). - -```cpp -static const wchar_t direct3d_warp[]; -``` - -## get_all - -Returns a vector of `accelerator` objects that represent all the available accelerators. - -```cpp -static inline std::vector get_all(); -``` - -### Return Value - -The vector of available accelerators - -## get_auto_selection_view - -Returns the auto selection accelerator_view, which when specified as the parallel_for_each target results in the target accelerator_view for executing the parallel_for_each kernel to be automatically selected by the runtime. For all other purposes, the accelerator_view returned by this method is the same as the default accelerator_view of the default accelerator - -```cpp -static accelerator_view __cdecl get_auto_selection_view(); -``` - -### Return Value - -The auto selection accelerator_view. - -## get_dedicated_memory - -Returns the dedicated memory for the `accelerator`, in kilobytes. - -```cpp -size_t get_dedicated_memory() const; -``` - -### Return Value - -The dedicated memory for the `accelerator`, in kilobytes. - -## get_default_cpu_access_type - -Gets the default cpu access_type for buffers created on this accelerator - -```cpp -access_type get_default_cpu_access_type() const; -``` - -### Return Value - -The default cpu access_type for buffers created on this accelerator. - -## get_default_view - -Returns the default `accelerator_view` object that is associated with the `accelerator`. - -```cpp -accelerator_view get_default_view() const; -``` - -### Return Value - -The default `accelerator_view` object that is associated with the `accelerator`. - -## get_description - -Returns a short description of the `accelerator` device. - -```cpp -std::wstring get_description() const; -``` - -### Return Value - -A short description of the `accelerator` device. - -## get_device_path - -Returns the path of the accelerator. The path is unique on the system. - -```cpp -std::wstring get_device_path() const; -``` - -### Return Value - -The system-wide unique device instance path. - -## get_has_display - -Returns a Boolean value that indicates whether the `accelerator` can output to a display. - -```cpp -bool get_has_display() const; -``` - -### Return Value - -**`true`** if the `accelerator` can output to a display; otherwise, **`false`**. - -## get_is_debug - -Determines whether the `accelerator` has the DEBUG layer enabled for extensive error reporting. - -```cpp -bool get_is_debug() const; -``` - -### Return Value - -**`true`** if the `accelerator` has the DEBUG layer enabled for extensive error reporting. Otherwise, **`false`**. - -## get_is_emulated - -Determines whether the `accelerator` is emulated. - -```cpp -bool get_is_emulated() const; -``` - -### Return Value - -**`true`** if the `accelerator` is emulated. Otherwise, **`false`**. - -## get_supports_cpu_shared_memory - -Returns a boolean value indicating whether the accelerator supports memory accessible both by the accelerator and the CPU. - -```cpp -bool get_supports_cpu_shared_memory() const; -``` - -### Return Value - -**`true`** if the accelerator supports CPU shared memory; otherwise, **`false`**. - -## get_supports_double_precision - -Returns a Boolean value that indicates whether the accelerator supports double precision math, including fused multiply add (FMA), division, reciprocal, and casting between **`int`** and **`double`** - -```cpp -bool get_supports_double_precision() const; -``` - -### Return Value - -**`true`** if the accelerator supports double precision math; otherwise, **`false`**. - -## get_supports_limited_double_precision - -Returns a Boolean value that indicates whether the accelerator has limited support for double precision math. If the accelerator has only limited support, then fused multiply add (FMA), division, reciprocal, and casting between **`int`** and **`double`** are not supported. - -```cpp -bool get_supports_limited_double_precision() const; -``` - -### Return Value - -**`true`** if the accelerator has limited support for double precision math; otherwise, **`false`**. - -## get_version - -Returns the version of the `accelerator`. - -```cpp -unsigned int get_version() const; -``` - -### Return Value - -The version of the `accelerator`. - -## has_display - -Gets a Boolean value that indicates whether the `accelerator` can output to a display. - -```cpp -__declspec(property(get= get_has_display)) bool has_display; -``` - -## is_debug - -Gets a Boolean value that indicates whether the `accelerator` has the DEBUG layer enabled for extensive error reporting. - -```cpp -__declspec(property(get= get_is_debug)) bool is_debug; -``` - -## is_emulated - -Gets a Boolean value that indicates whether the `accelerator` is emulated. - -```cpp -__declspec(property(get= get_is_emulated)) bool is_emulated; -``` - -## operator!= - -Compares this `accelerator` object with another and returns **`false`** if they are the same; otherwise, returns **`true`**. - -```cpp -bool operator!= (const accelerator& _Other) const; -``` - -### Parameters - -*_Other*
-The `accelerator` object to compare with this one. - -### Return Value - -**`false`** if the two `accelerator` objects are the same; otherwise, **`true`**. - -## operator= - -Copies the contents of the specified `accelerator` object to this one. - -```cpp -accelerator& operator= (const accelerator& _Other); -``` - -### Parameters - -*_Other*
-The `accelerator` object to copy from. - -### Return Value - -A reference to this `accelerator` object. - -## operator== - -Compares this `accelerator` object with another and returns **`true`** if they are the same; otherwise, returns **`false`**. - -```cpp -bool operator== (const accelerator& _Other) const; -``` - -### Parameters - -*_Other*
-The `accelerator` object to compare with this one. - -### Return Value - -**`true`** if the other `accelerator` object is same as this `accelerator` object; otherwise, **`false`**. - -## set_default - -Sets the default accelerator to be used for any operation that implicitly uses the default accelerator. This method only succeeds if the runtime selected default accelerator has not already been used in an operation that implicitly uses the default accelerator - -```cpp -static inline bool set_default(std::wstring _Path); -``` - -### Parameters - -*_Path*
-The path to the accelerator. - -### Return Value - -**`true`** if the call succeeds at setting the default accelerator. Otherwise, **`false`**. - -## set_default_cpu_access_type - -Set the default cpu access_type for arrays created on this accelerator or for implicit memory allocations as part of array_views accessed on this accelerator. This method only succeeds if the default_cpu_access_type for the accelerator has not already been overridden by a previous call to this method and the runtime selected default_cpu_access_type for this accelerator has not yet been used for allocating an array or for an implicit memory allocation backing an array_view accessed on this accelerator. - -```cpp -bool set_default_cpu_access_type(access_type _Default_cpu_access_type); -``` - -### Parameters - -*_Default_cpu_access_type*
-The default cpu access_type to be used for array/array_view memory allocations on this accelerator. - -### Return Value - -A boolean value indicating if the default cpu access_type for the accelerator was successfully set. - -## supports_cpu_shared_memory - -Gets a Boolean value indicating whether the `accelerator` supports shared memory. - -```cpp -__declspec(property(get= get_supports_cpu_shared_memory)) bool supports_cpu_shared_memory; -``` - -## supports_double_precision - -Gets a Boolean value that indicates whether the accelerator supports double precision math. - -```cpp -__declspec(property(get= get_supports_double_precision)) bool supports_double_precision; -``` - -## supports_limited_double_precision - -Gets a Boolean value that indicates whether the accelerator has limited support for double precision math. If the accelerator has only limited support, then fused multiply add (FMA), division, reciprocal, and casting between **`int`** and **`double`** are not supported. - -```cpp -__declspec(property(get= get_supports_limited_double_precision)) bool supports_limited_double_precision; -``` - -## version - -Gets the version of the `accelerator`. - -```cpp -__declspec(property(get= get_version)) unsigned int version; -``` - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/accelerator-view-class.md b/docs/parallel/amp/reference/accelerator-view-class.md deleted file mode 100644 index 53208aae6bf..00000000000 --- a/docs/parallel/amp/reference/accelerator-view-class.md +++ /dev/null @@ -1,327 +0,0 @@ ---- -description: "Learn more about: accelerator_view Class" -title: "accelerator_view Class" -ms.date: "03/27/2019" -f1_keywords: ["accelerator_view", "AMPRT/accelerator_view", "AMPRT/Concurrency::accelerator_view::accelerator_view", "AMPRT/Concurrency::accelerator_view::create_marker", "AMPRT/Concurrency::accelerator_view::flush", "AMPRT/Concurrency::accelerator_view::get_accelerator", "AMPRT/Concurrency::accelerator_view::get_is_auto_selection", "AMPRT/Concurrency::accelerator_view::get_is_debug", "AMPRT/Concurrency::accelerator_view::get_queuing_mode", "AMPRT/Concurrency::accelerator_view::get_version", "AMPRT/Concurrency::accelerator_view::wait", "AMPRT/Concurrency::accelerator_view::accelerator", "AMPRT/Concurrency::accelerator_view::is_auto_selection", "AMPRT/Concurrency::accelerator_view::is_debug", "AMPRT/Concurrency::accelerator_view::queuing_mode", "AMPRT/Concurrency::accelerator_view::version"] -helpviewer_keywords: ["accelerator_view class"] -ms.assetid: 9f298c21-bf62-46e0-88b8-01c5c78ef144 ---- -# accelerator_view Class - -Represents a virtual device abstraction on a C++ AMP data-parallel accelerator. - -## Syntax - -```cpp -class accelerator_view; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[accelerator_view Constructor](#ctor)|Initializes a new instance of the `accelerator_view` class.| -|[~accelerator_view Destructor](#dtor)|Destroys the `accelerator_view` object.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[create_marker](#create_marker)|Returns a future to track the completion of all commands submitted so far to this `accelerator_view` object.| -|[flush](#flush)|Submits all pending commands queued to the `accelerator_view` object to the accelerator for execution.| -|[get_accelerator](#get_accelerator)|Returns the `accelerator` object for the `accelerator_view` object.| -|[get_is_auto_selection](#get_is_auto_selection)|Returns a Boolean value that indicates whether the runtime will automatically select an appropriate accelerator when the `accelerator_view` object is passed to a [parallel_for_each](concurrency-namespace-functions-amp.md#parallel_for_each).| -|[get_is_debug](#get_is_debug)|Returns a Boolean value that indicates whether the `accelerator_view` object has the DEBUG layer enabled for extensive error reporting.| -|[get_queuing_mode](#get_queuing_mode)|Returns the queuing mode for the `accelerator_view` object.| -|[get_version](#get_version)|Returns the version of the `accelerator_view`.| -|[wait](#wait)|Waits for all commands submitted to the `accelerator_view` object to finish.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator!=](#operator_neq)|Compares this `accelerator_view` object with another and returns **`false`** if they are the same; otherwise, returns **`true`**.| -|[operator=](#operator_eq)|Copies the contents of the specified `accelerator_view` object into this one.| -|[operator==](#operator_eq_eq)|Compares this `accelerator_view` object with another and returns **`true`** if they are the same; otherwise, returns **`false`**.| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|[accelerator](#accelerator)|Gets the `accelerator` object for the `accelerator_view` object.| -|[is_auto_selection](#is_auto_selection)|Gets a Boolean value that indicates whether the runtime will automatically select an appropriate accelerator when the `accelerator_view` object is passed to a [parallel_for_each](concurrency-namespace-functions-amp.md#parallel_for_each).| -|[is_debug](#is_debug)|Gets a Boolean value that indicates whether the `accelerator_view` object has the DEBUG layer enabled for extensive error reporting.| -|[queuing_mode](#queuing_mode)|Gets the queuing mode for the `accelerator_view` object.| -|[version](#version)|Gets the version of the accelerator.| - -## Inheritance Hierarchy - -`accelerator_view` - -### Remarks - -An `accelerator_view` object represents a logical, isolated view of an accelerator. A single physical compute device can have many logical, isolated `accelerator_view` objects. Each accelerator has a default `accelerator_view` object. Additional `accelerator_view` objects can be created. - -Physical devices can be shared among many client threads. Client threads can cooperatively use the same `accelerator_view` object of an accelerator, or each client can communicate with a compute device via an independent `accelerator_view` object for isolation from other client threads. - -An `accelerator_view` object can have one of two [queuing_mode Enumeration](concurrency-namespace-enums-amp.md#queuing_mode) states. If the queuing mode is `immediate`, commands like `copy` and `parallel_for_each` are sent to the corresponding accelerator device as soon as they return to the caller. If the queuing mode is `deferred`, such commands are queued up on a command queue that corresponds to the `accelerator_view` object. Commands are not actually sent to the device until `flush()` is called. - -## Requirements - -**Header:** amprt.h - -**Namespace:** Concurrency - -## accelerator - -Gets the accelerator object for the accelerator_view object. - -### Syntax - -```cpp -__declspec(property(get= get_accelerator)) Concurrency::accelerator accelerator; -``` - -## accelerator_view - -Initializes a new instance of the accelerator_view class by copying an existing `accelerator_view` object. - -### Syntax - -```cpp -accelerator_view( const accelerator_view & other ); -``` - -### Parameters - -*other*
-The `accelerator_view` object to copy. - -## create_marker - -Returns a future to track the completion of all commands submitted so far to this `accelerator_view` object. - -### Syntax - -```cpp -concurrency::completion_future create_marker(); -``` - -### Return Value - -A future to track the completion of all commands submitted so far to this `accelerator_view` object. - -## flush - -Submits all pending commands queued to the accelerator_view object to the accelerator for execution. - -### Syntax - -```cpp -void flush(); -``` - -### Return Value - -Returns **`void`**. - -## get_accelerator - -Returns the accelerator object for the accelerator_view object. - -### Syntax - -```cpp -accelerator get_accelerator() const; -``` - -### Return Value - -The accelerator object for the accelerator_view object. - -## get_is_auto_selection - -Returns a Boolean value that indicates whether the runtime will automatically select an appropriate accelerator when the accelerator_view is passed to a [parallel_for_each](concurrency-namespace-functions-amp.md#parallel_for_each). - -### Syntax - -```cpp -bool get_is_auto_selection() const; -``` - -### Return Value - -**`true`** if the runtime will automatically select an appropriate accelerator; otherwise, **`false`**. - -## get_is_debug - -Returns a Boolean value that indicates whether the accelerator_view object has the DEBUG layer enabled for extensive error reporting. - -### Syntax - -```cpp -bool get_is_debug() const; -``` - -### Return Value - -A Boolean value that indicates whether the `accelerator_view` object has the DEBUG layer enabled for extensive error reporting. - -## get_queuing_mode - -Returns the queuing mode for the accelerator_view object. - -### Syntax - -```cpp -queuing_mode get_queuing_mode() const; -``` - -### Return Value - -The queuing mode for the `accelerator_view` object. - -## get_version - -Returns the version of the accelerator_view. - -### Syntax - -```cpp -unsigned int get_version() const; -``` - -### Return Value - -The version of the `accelerator_view`. - -## is_auto_selection - -Gets a Boolean value that indicates whether the runtime will automatically select an appropriate accelerator when the accelerator_view is passed to a [parallel_for_each](concurrency-namespace-functions-amp.md#parallel_for_each). - -### Syntax - -```cpp -__declspec(property(get= get_is_auto_selection)) bool is_auto_selection; -``` - -## is_debug - -Gets a Boolean value that indicates whether the accelerator_view object has the DEBUG layer enabled for extensive error reporting. - -### Syntax - -```cpp -__declspec(property(get= get_is_debug)) bool is_debug; -``` - -## operator!= - -Compares this accelerator_view object with another and returns **`false`** if they are the same; otherwise, returns **`true`**. - -### Syntax - -```cpp -bool operator!= ( const accelerator_view & other ) const; -``` - -### Parameters - -*other*
-The `accelerator_view` object to compare with this one. - -### Return Value - -**`false`** if the two objects are the same; otherwise, **`true`**. - -## operator= - -Copies the contents of the specified accelerator_view object into this one. - -### Syntax - -```cpp -accelerator_view & operator= ( const accelerator_view & other ); -``` - -### Parameters - -*other*
-The `accelerator_view` object to copy from. - -### Return Value - -A reference to the modified `accelerator_view` object. - -## operator== - -Compares this accelerator_view object with another and returns **`true`** if they are the same; otherwise, returns **`false`**. - -### Syntax - -```cpp -bool operator== ( const accelerator_view & other ) const; -``` - -### Parameters - -*other*
-The `accelerator_view` object to compare with this one. - -### Return Value - -**`true`** if the two objects are the same; otherwise, **`false`**. - -## queuing_mode - -Gets the queuing mode for the accelerator_view object. - -### Syntax - -```cpp -__declspec(property(get= get_queuing_mode)) Concurrency::queuing_mode queuing_mode; -``` - -## version - -Gets the version of the accelerator_view. - -### Syntax - -```cpp -__declspec(property(get= get_version)) unsigned int version; -``` - -## wait - -Waits for all commands submitted to the accelerator_view object to finish. - -### Syntax - -```cpp -void wait(); -``` - -### Return Value - -Returns **`void`**. - -### Remarks - -If the [queuing_mode](concurrency-namespace-enums-amp.md#queuing_mode) is `immediate`, this method returns immediately without blocking. - -## ~accelerator_view - -Destroys the accelerator_view object. - -### Syntax - -```cpp -~accelerator_view(); -``` - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/accelerator-view-removed-class.md b/docs/parallel/amp/reference/accelerator-view-removed-class.md deleted file mode 100644 index f5487950ff2..00000000000 --- a/docs/parallel/amp/reference/accelerator-view-removed-class.md +++ /dev/null @@ -1,86 +0,0 @@ ---- -description: "Learn more about: accelerator_view_removed Class" -title: "accelerator_view_removed Class" -ms.date: "03/27/2019" -f1_keywords: ["accelerator_view_removed", "AMPRT/accelerator_view_removed", "AMPRT/Concurrency::accelerator_view_removed::accelerator_view_removed", "AMPRT/Concurrency::accelerator_view_removed::get_view_removed_reason"] -helpviewer_keywords: ["AMPRT/Concurrency::accelerator_view_removed::accelerator_view_removed Class"] -ms.assetid: 262446de-311c-454e-a5ed-e2aaced0d88a ---- -# accelerator_view_removed Class - -The exception that is thrown when an underlying DirectX call fails due to the Windows timeout detection and recovery mechanism. - -## Syntax - -```cpp -class accelerator_view_removed : public runtime_exception; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[accelerator_view_removed Constructor](#ctor)|Initializes a new instance of the `accelerator_view_removed` class.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[get_view_removed_reason](#get_view_removed_reason)|Returns an HRESULT error code indicating the cause of the `accelerator_view` object's removal.| - -## Inheritance Hierarchy - -`exception` - -`runtime_exception` - -`out_of_memory` - -## Requirements - -**Header:** amprt.h - -**Namespace:** Concurrency - -## accelerator_view_removed - -Initializes a new instance of the [accelerator_view_removed](accelerator-view-removed-class.md) class. - -### Syntax - -```cpp -explicit accelerator_view_removed( - const char * message, - HRESULT view_removed_reason ) throw(); - -explicit accelerator_view_removed( - HRESULT view_removed_reason ) throw(); -``` - -### Parameters - -*message*
-A description of the error. - -*view_removed_reason*
-An HRESULT error code indicating the cause of removal of the `accelerator_view` object. - -### Return Value - -A new instance of the `accelerator_view_removed` class. - -## get_view_removed_reason - -Returns an HRESULT error code indicating the cause of the `accelerator_view` object's removal. - -### Syntax - -```cpp -HRESULT get_view_removed_reason() const throw(); -``` - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/adopt-d3d-access-lock-t-structure.md b/docs/parallel/amp/reference/adopt-d3d-access-lock-t-structure.md deleted file mode 100644 index 9c6baf74c4d..00000000000 --- a/docs/parallel/amp/reference/adopt-d3d-access-lock-t-structure.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -description: "Learn more about: adopt_d3d_access_lock_t Structure" -title: "adopt_d3d_access_lock_t Structure" -ms.date: "11/04/2016" -f1_keywords: ["amprt/concurrency::direct3d::adopt_d3d_access_lock_t"] -ms.assetid: ef10bb06-88d6-420b-bb81-35895b2e02e6 ---- -# adopt_d3d_access_lock_t Structure - -Tag type to indicate the D3D access lock should be adopted rather than acquired. - -## Syntax - -```cpp -struct adopt_d3d_access_lock_t; -``` - -## Members - -## Inheritance Hierarchy - -`adopt_d3d_access_lock_t` - -## Requirements - -**Header:** amprt.h - -**Namespace:** concurrency::direct3d - -## See also - -[Concurrency::direct3d Namespace](concurrency-direct3d-namespace.md) diff --git a/docs/parallel/amp/reference/array-class.md b/docs/parallel/amp/reference/array-class.md deleted file mode 100644 index 5fd455d1f15..00000000000 --- a/docs/parallel/amp/reference/array-class.md +++ /dev/null @@ -1,816 +0,0 @@ ---- -title: "array Class" -description: "Learn more about: array Class" -ms.date: 11/04/2016 -f1_keywords: ["array", "AMP/array", "AMP/Concurrency::array::array", "AMP/Concurrency::array::copy_to", "AMP/Concurrency::array::data", "AMP/Concurrency::array::get_accelerator_view", "AMP/Concurrency::array::get_associated_accelerator_view", "AMP/Concurrency::array::get_cpu_access_type", "AMP/Concurrency::array::get_extent", "AMP/Concurrency::array::reinterpret_as", "AMP/Concurrency::array::section", "AMP/Concurrency::array::view_as", "AMP/Concurrency::array::rank", "AMP/Concurrency::array::accelerator_view", "AMP/Concurrency::array::associated_accelerator_view", "AMP/Concurrency::array::cpu_access_type", "AMP/Concurrency::array::extent"] -helpviewer_keywords: ["array class"] ---- -# array Class - -Represents a data container used to move data to an accelerator. - -## Syntax - -```cpp -template -friend class array; -``` - -### Parameters - -*value_type*
-The element type of the data. - -*_Rank*
-The rank of the array. - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[array Constructor](#ctor)|Initializes a new instance of the `array` class.| -|[~array Destructor](#dtor)|Destroys the `array` object.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[copy_to](#copy_to)|Copies the contents of the array to another array.| -|[data](#data)|Returns a pointer to the raw data of the array.| -|[get_accelerator_view](#get_accelerator_view)|Returns the [accelerator_view](accelerator-view-class.md) object that represents the location where the array is allocated. This property can be accessed only on the CPU.| -|[get_associated_accelerator_view](#get_associated_accelerator_view)|Gets the second [accelerator_view](accelerator-view-class.md) object that is passed as a parameter when a staging constructor is called to instantiate the `array` object.| -|[get_cpu_access_type](#get_cpu_access_type)|Returns the [access_type](concurrency-namespace-enums-amp.md#access_type) of the array. This method can be accessed only on the CPU.| -|[get_extent](#get_extent)|Returns the [extent](extent-class.md) object of the array.| -|[reinterpret_as](#reinterpret_as)|Returns a one-dimensional array that contains all the elements in the `array` object.| -|[section](#section)|Returns a subsection of the `array` object that is at the specified origin and, optionally, that has the specified extent.| -|[view_as](#view_as)|Returns an [array_view](array-view-class.md) object that is constructed from the `array` object.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[`operator std::vector`](#operator_vec)|Uses `copy(*this, vector)` to implicitly convert the array to a [std::vector](../../../standard-library/vector-class.md) object.| -|[operator()](#operator_call)|Returns the element value that is specified by the parameters.| -|[operator\[\]](#operator_at)|Returns the element that is at the specified index.| -|[operator=](#operator_eq)|Copies the contents of the specified `array` object into this one.| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[rank Constant](#rank)|Stores the rank of the array.| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|[accelerator_view](#accelerator_view)|Gets the [accelerator_view](accelerator-view-class.md) object that represents the location where the array is allocated. This property can be accessed only on the CPU.| -|[associated_accelerator_view](#associated_accelerator_view)|Gets the second [accelerator_view](accelerator-view-class.md) object that is passed as a parameter when a staging constructor is called to instantiate the `array` object.| -|[cpu_access_type](#cpu_access_type)|Gets the [access_type](concurrency-namespace-enums-amp.md#access_type) that represents how the CPU can access the storage of the array.| -|[extent](#extent)|Gets the extent that defines the shape of the array.| - -## Remarks - -The type `array` represents a dense and regular (not jagged) *N*-dimensional array that is located in a specific location, such as an accelerator or the CPU. The data type of the elements in the array is `T`, which must be of a type that is compatible with the target accelerator. Although the rank, `N`, (of the array is determined statically and is part of the type, the extent of the array is determined by the runtime and is expressed by using class `extent`. - -An array can have any number of dimensions, although some functionality is specialized for `array` objects with rank one, two, and three. If you omit the dimension argument, the default is 1. - -Array data is laid out contiguously in memory. Elements that differ by one in the least significant dimension are adjacent in memory. - -Arrays are logically considered to be value types, because when an array is copied to another array, a deep copy is performed. Two arrays never point to the same data. - -The `array` type is used in several scenarios: - -- As a data container that can be used in computations on an accelerator. - -- As a data container to hold memory on the host CPU (that can be used to copy to and from other arrays). - -- As a staging object to act as a fast intermediary in host-to-device copies. - -## Inheritance Hierarchy - -`array` - -## Requirements - -**Header:** amp.h - -**Namespace:** Concurrency - -## ~array - -Destroys the `array` object. - -```cpp -~array() restrict(cpu); -``` - -## accelerator_view - -Gets the [accelerator_view](accelerator-view-class.md) object that represents the location where the array is allocated. This property can be accessed only on the CPU. - -```cpp -__declspec(property(get= get_accelerator_view)) Concurrency::accelerator_view accelerator_view; -``` - -## array - -Initializes a new instance of the [array class](array-class.md). There is no default constructor for `array`. All constructors are run on the CPU only. They cannot be executed on a Direct3D target. - -```cpp -explicit array( - const Concurrency::extent<_Rank>& _Extent) restrict(cpu); - -explicit array( - int _E0) restrict(cpu); - -explicit array( - int _E0, - int _E1) restrict(cpu); - -explicit array( - int _E0, - int _E1, - int _E2) restrict(cpu); - -array( - const Concurrency::extent<_Rank>& _Extent, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -array( - int _E0, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -array( - int _E0, - int _E1, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -array( - int _E0, - int _E1, - int _E2, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -array( - const Concurrency::extent<_Rank>& _Extent, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -array( - int _E0, - accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -array( - int _E0, - int _E1, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -array( - int _E0, - int _E1, - int _E2, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -template -array( - const Concurrency::extent<_Rank>& _Extent, - _InputIterator _Src_first, - _InputIterator _Src_last) restrict(cpu); - -template -array( - const Concurrency::extent<_Rank>& _Extent, - _InputIterator _Src_first) restrict(cpu); - -template -array( - int _E0, - _InputIterator _Src_first, - _InputIterator _Src_last) restrict(cpu); - -template -array( - int _E0, - _InputIterator _Src_first) restrict(cpu); - -template -array( - int _E0, - int _E1, - _InputIterator _Src_first, - _InputIterator _Src_last) restrict(cpu); - -template -array( - int _E0, - int _E1, - _InputIterator _Src_first) restrict(cpu); - -template -array( - int _E0, - int _E1, - int _E2, - _InputIterator _Src_first, - _InputIterator _Src_last) restrict(cpu); - -template -array( - int _E0, - int _E1, - int _E2, - _InputIterator _Src_first) restrict(cpu); - -template -array( - const Concurrency::extent<_Rank>& _Extent, - _InputIterator _Src_first, - _InputIterator _Src_last, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -template -array( - const Concurrency::extent<_Rank>& _Extent, - _InputIterator _Src_first, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -template -array( - int _E0, - _InputIterator _Src_first, - _InputIterator _Src_last, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -template -array( - int _E0, - _InputIterator _Src_first, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -template -array( - int _E0, - int _E1, - _InputIterator _Src_first, - _InputIterator _Src_last, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -template -array( - int _E0, - int _E1, - _InputIterator _Src_first, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -template -array( - int _E0, - int _E1, - int _E2, - _InputIterator _Src_first, - _InputIterator _Src_last, - Concurrency::accelerator_view _Av, - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -template -array( - int _E0, - int _E1, - int _E2, - _InputIterator _Src_first, - Concurrency::accelerator_view _Av - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -template -array( - const Concurrency::extent<_Rank>& _Extent, - _InputIterator _Src_first, - _InputIterator _Src_last, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -template -array( - const Concurrency::extent<_Rank>& _Extent, - _InputIterator _Src_first, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -template -array( - int _E0, - _InputIterator _Src_first, - _InputIterator _Src_last, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -template -array( - int _E0, _InputIterator _Src_first, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -template -array( - int _E0, - int _E1, _InputIterator _Src_first, _InputIterator _Src_last, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -template -array( - int _E0, - int _E1, _InputIterator _Src_first, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -template -array( - int _E0, - int _E1, - int _E2, _InputIterator _Src_first, _InputIterator _Src_last, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -template -array( - int _E0, - int _E1, - int _E2, _InputIterator _Src_first, - Concurrency::accelerator_view _Av, - Concurrency::accelerator_view _Associated_Av) restrict(cpu); - -explicit array( - const array_view& _Src) restrict(cpu); - -array( - const array_view& _Src, - accelerator_view _Av, - access_type _Cpu_access_type = access_type_auto) restrict(cpu); - -array( - const array_view& _Src, - accelerator_view _Av, - accelerator_view _Associated_Av) restrict(cpu); - -array(const array& _Other) restrict(cpu); - -array(array&& _Other) restrict(cpu); -``` - -### Parameters - -*_Associated_Av*
-An accelerator_view which specifies the preferred target location of the array. - -*_Av*
-An [accelerator_view](accelerator-view-class.md) object that specifies the location of the array. - -*_Cpu_access_type*
-The desired [access_type](concurrency-namespace-enums-amp.md#access_type) for the array on the CPU. This parameter has a default value of `access_type_auto` leaving the CPU `access_type` determination to the runtime. The actual CPU `access_type` for the array can be queried using the `get_cpu_access_type` method. - -*_Extent*
-The extent in each dimension of the array. - -*_E0*
-The most significant component of the extent of this section. - -*_E1*
-The next-to-most-significant component of the extent of this section. - -*_E2*
-The least significant component of the extent of this section. - -*_InputIterator*
-The type of the input iterator. - -*_Src*
-To object to copy. - -*_Src_first*
-A beginning iterator into the source container. - -*_Src_last*
-An ending iterator into the source container. - -*_Other*
-Other data source. - -*_Rank*
-The rank of the section. - -*value_type*
-The data type of the elements that are copied. - -## associated_accelerator_view - -Gets the second [accelerator_view](accelerator-view-class.md) object that is passed as a parameter when a staging constructor is called to instantiate the `array` object. - -```cpp -__declspec(property(get= get_associated_accelerator_view)) Concurrency::accelerator_view associated_accelerator_view; -``` - -## copy_to - -Copies the contents of the `array` to another `array`. - -```cpp -void copy_to( - array& _Dest) const ; - -void copy_to( - array_view& _Dest) const ; -``` - -### Parameters - -*_Dest*
-The [array_view](array-view-class.md) object to copy to. - -## cpu_access_type - -Gets the CPU access_type allowed for this array. - -```cpp -__declspec(property(get= get_cpu_access_type)) access_type cpu_access_type; -``` - -## data - -Returns a pointer to the raw data of the `array`. - -```cpp -value_type* data() restrict(amp, cpu); - -const value_type* data() const restrict(amp, cpu); -``` - -### Return Value - -A pointer to the raw data of the array. - -## extent - -Gets the [extent](extent-class.md) object that defines the shape of the `array`. - -```cpp -__declspec(property(get= get_extent)) Concurrency::extent<_Rank> extent; -``` - -## get_accelerator_view - -Returns the [accelerator_view](accelerator-view-class.md) object that represents the location where the `array` object is allocated. This property can be accessed only on the CPU. - -```cpp -Concurrency::accelerator_view get_accelerator_view() const; -``` - -### Return Value - -The `accelerator_view` object that represents the location where the `array` object is allocated. - -## get_associated_accelerator_view - -Gets the second [accelerator_view](accelerator-view-class.md) object that is passed as a parameter when a staging constructor is called to instantiate the `array` object. - -```cpp -Concurrency::accelerator_view get_associated_accelerator_view() const ; -``` - -### Return Value - -The second [accelerator_view](accelerator-view-class.md) object passed to the staging constructor. - -## get_cpu_access_type - -Returns the CPU access_type that's allowed for this array. - -```cpp -access_type get_cpu_access_type() const restrict(cpu); -``` - -### Return Value - -## get_extent - -Returns the [extent](extent-class.md) object of the `array`. - -```cpp -Concurrency::extent<_Rank> get_extent() const restrict(amp,cpu); -``` - -### Return Value - -The `extent` object of the `array`. - -## `operator std::vector` - -Uses `copy(*this, vector)` to implicitly convert the array to a std::vector object. - -```cpp -operator std::vector() const restrict(cpu); -``` - -### Parameters - -*value_type*
-The data type of the elements of the vector. - -### Return Value - -An object of type `vector` that contains a copy of the data that is contained in the array. - -## operator() - -Returns the element value that is specified by the parameters. - -```cpp -value_type& operator() (const index<_Rank>& _Index) restrict(amp,cpu); - -const value_type& operator() (const index<_Rank>& _Index) cons t restrict(amp,cpu); - -value_type& operator() (int _I0, int _I1) restrict(amp,cpu); - -const value_type& operator() (int _I0, int _I1) const restrict(amp,cpu) ; - -value_type& operator() (int _I0, int _I1, int _I2) restrict(amp,cpu); - -const value_type& operator() (int _I0, int _I1, int _I2) const restrict(amp,cpu); - -typename details::_Projection_result_type::_Result_type operator()(int _I) restrict(amp,cpu); - -typename details::_Projection_result_type::_Const_result_type operator()(int _I) const restrict(amp,cpu); -``` - -### Parameters - -*_Index*
-The location of the element. - -*_I0*
-The most significant component of the origin of this section. - -*_I1*
-The next-to-most-significant component of the origin of this section. - -*_I2*
-The least significant component of the origin of this section. - -*_I*
-The location of the element. - -### Return Value - -The element value specified by the parameters. - -## operator[] - -Returns the element that is at the specified index. - -```cpp -value_type& operator[](const index<_Rank>& _Index) restrict(amp,cpu); - -const value_type& operator[] - (const index<_Rank>& _Index) const restrict(amp,cpu); - -typename details::_Projection_result_type::_Result_type operator[](int _i) restrict(amp,cpu); - -typename details::_Projection_result_type::_Const_result_type operator[](int _i) const restrict(amp,cpu); -``` - -### Parameters - -*_Index*
-The index. - -*_I*
-The index. - -### Return Value - -The element that is at the specified index. - -## operator= - -Copies the contents of the specified `array` object. - -```cpp -array& operator= (const array& _Other) restrict(cpu); - -array& operator= (array&& _Other) restrict(cpu); - -array& operator= ( - const array_view& _Src) restrict(cpu); -``` - -### Parameters - -*_Other*
-The `array` object to copy from. - -*_Src*
-The `array` object to copy from. - -### Return Value - -A reference to this `array` object. - -## rank - -Stores the rank of the `array`. - -```cpp -static const int rank = _Rank; -``` - -## reinterpret_as - -Reinterprets the array through a one-dimensional array_view, which optionally may have a different value type than the source array. - -### Syntax - -```cpp -template -array_view<_Value_type2,1> reinterpret_as() restrict(amp,cpu); - -template -array_view reinterpret_as() const restrict(amp,cpu); -``` - -### Parameters - -*_Value_type2*
-The data type of the returned data. - -### Return Value - -An array_view or const array_view object that is based on the array, with the element type reinterpreted from T to ElementType and the rank reduced from N to 1. - -### Remarks - -Sometimes it is convenient to view a multi-dimensional array as if it is a linear, one-dimensional array, possibly with a different value type than the source array. You can use this method to achieve this. -**Caution** Reinterpreting an array object by using a different value type is a potentially unsafe operation. We recommend that you use this functionality carefully. - -The following code provides an example. - -```cpp -struct RGB { float r; float g; float b; }; - -array a = ...; -array_view v = a.reinterpret_as(); - -assert(v.extent == 3*a.extent); -``` - -## section - -Returns a subsection of the `array` object that is at the specified origin and, optionally, that has the specified extent. - -```cpp -array_view section( - const Concurrency::index<_Rank>& _Section_origin, - const Concurrency::extent<_Rank>& _Section_extent) restrict(amp,cpu); - -array_view section( - const Concurrency::index<_Rank>& _Section_origin, - const Concurrency::extent<_Rank>& _Section_extent) const restrict(amp,cpu); - -array_view section( - const Concurrency::extent<_Rank>& _Ext) restrict(amp,cpu); - -array_view section( - const Concurrency::extent<_Rank>& _Ext) const restrict(amp,cpu); - -array_view section( - const index<_Rank>& _Idx) restrict(amp,cpu); - -array_view section( - const index<_Rank>& _Idx) const restrict(amp,cpu); - -array_view section( - int _I0, - int _E0) restrict(amp,cpu); - -array_view section( - int _I0, - int _E0) const restrict(amp,cpu); - -array_view section( - int _I0, - int _I1, - int _E0, - int _E1) restrict(amp,cpu); - -array_view section( - int _I0, - int _I1, - int _E0, - int _E1) const restrict(amp,cpu); - -array_view section( - int _I0, - int _I1, - int _I2, - int _E0, - int _E1, - int _E2) restrict(amp,cpu); - -array_view section( - int _I0, - int _I1, - int _I2, - int _E0, - int _E1, - int _E2) const restrict(amp,cpu); -``` - -### Parameters - -*_E0*
-The most significant component of the extent of this section. - -*_E1*
-The next-to-most-significant component of the extent of this section. - -*_E2*
-The least significant component of the extent of this section. - -*_Ext*
-The [extent](extent-class.md) object that specifies the extent of the section. The origin is 0. - -*_Idx*
-The [index](index-class.md) object that specifies the location of the origin. The subsection is the rest of the extent. - -*_I0*
-The most significant component of the origin of this section. - -*_I1*
-The next-to-most-significant component of the origin of this section. - -*_I2*
-The least significant component of the origin of this section. - -*_Rank*
-The rank of the section. - -*_Section_extent*
-The [extent](extent-class.md) object that specifies the extent of the section. - -*_Section_origin*
-The [index](index-class.md) object that specifies the location of the origin. - -*value_type*
-The data type of the elements that are copied. - -### Return Value - -Returns a subsection of the `array` object that is at the specified origin and, optionally, that has the specified extent. When only the `index` object is specified, the subsection contains all elements in the associated grid that have indexes that are larger than the indexes of the elements in the `index` object. - -## view_as - -Reinterprets this array as an [array_view](array-view-class.md) of a different rank. - -```cpp -template -array_view view_as( - const Concurrency::extent<_New_rank>& _View_extent) restrict(amp,cpu); - -template -array_view view_as( - const Concurrency::extent<_New_rank>& _View_extent) const restrict(amp,cpu); -``` - -### Parameters - -*_New_rank*
-The rank of the `extent` object passed as a parameter. - -*_View_extent*
-The extent that is used to construct the new [array_view](array-view-class.md) object. - -*value_type*
-The data type of the elements in both the original `array` object and the returned `array_view` object. - -### Return Value - -The [array_view](array-view-class.md) object that is constructed. - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/array-view-class.md b/docs/parallel/amp/reference/array-view-class.md deleted file mode 100644 index 26700c4f97b..00000000000 --- a/docs/parallel/amp/reference/array-view-class.md +++ /dev/null @@ -1,773 +0,0 @@ ---- -description: "Learn more about: array_view Class" -title: "array_view Class" -ms.date: "11/04/2016" -f1_keywords: ["array_view", "AMP/array_view", "AMP/Concurrency::array_view::array_view", "AMP/Concurrency::array_view::copy_to", "AMP/Concurrency::array_view::data", "AMP/Concurrency::array_view::discard_data", "AMP/Concurrency::array_view::get_extent", "AMP/Concurrency::array_view::get_ref", "AMP/Concurrency::array_view::get_source_accelerator_view", "AMP/Concurrency::array_view::refresh", "AMP/Concurrency::array_view::reinterpret_as", "AMP/Concurrency::array_view::section", "AMP/Concurrency::array_view::synchronize", "AMP/Concurrency::array_view::synchronize_async", "AMP/Concurrency::array_view::synchronize_to", "AMP/Concurrency::array_view::synchronize_to_async", "AMP/Concurrency::array_view::view_as", "AMP/Concurrency::array_view::rank", "AMP/Concurrency::array_view::extent", "AMP/Concurrency::array_view::source_accelerator_view", "AMP/Concurrency::array_view::value_type"] -helpviewer_keywords: ["array_view class"] -ms.assetid: 7e7ec9bc-05a2-4372-b05d-752b50006c5a ---- -# array_view Class - -Represents an N-dimensional view over the data held in another container. - -## Syntax - -```cpp -template < - typename value_type, - int _Rank = 1 -> -class array_view : public _Array_view_base<_Rank, sizeof(value_type)/sizeof(int)>; - -template < - typename value_type, - int _Rank -> -class array_view : public _Array_view_base<_Rank, sizeof(value_type)/sizeof(int)>; -``` - -### Parameters - -*value_type*
-The data type of the elements in the `array_view` object. - -*_Rank*
-The rank of the `array_view` object. - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[array_view Constructor](#ctor)|Initializes a new instance of the `array_view` class. There is no default constructor for `array`. All constructors are restricted to run on the CPU only and cannot be executed on a Direct3D target.| -|[~array_view Destructor](#ctor)|Destroys the `array_view` object.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[copy_to](#copy_to)|Copies the contents of the `array_view` object to the specified destination by calling `copy(*this, dest)`.| -|[data](#data)|Returns a pointer to the raw data of the `array_view`.| -|[discard_data](#discard_data)|Discards the current data underlying this view.| -|[get_extent](#get_extent)|Returns the extent object of the array_view object.| -|[get_ref](#get_ref)|Returns a reference to the indexed element.| -|[get_source_accelerator_view](#get_source_accelerator_view)|Returns the [accelerator_view](accelerator-view-class.md) where the data source of the `array_view` is located.| -|[refresh](#refresh)|Notifies the `array_view` object that its bound memory has been modified outside the `array_view` interface. A call to this method renders all cached information stale.| -|[reinterpret_as](#reinterpret_as)|Returns a one-dimensional array that contains all the elements in the `array_view` object.| -|[section](#section)|Returns a subsection of the `array_view` object that's at the specified origin and, optionally, that has the specified extent.| -|[synchronize](#synchronize)|Synchronizes any modifications made to the `array_view` object back to its source data.| -|[synchronize_async](#synchronize_async)|Asynchronously synchronizes any modifications made to the `array_view` object back to its source data.| -|[synchronize_to](#synchronize_to)|Synchronizes any modifications made to the `array_view` object to the specified [accelerator_view](accelerator-view-class.md).| -|[synchronize_to_async](#synchronize_to_async)|Asynchronously synchronizes any modifications made to the `array_view` object to the specified [accelerator_view](accelerator-view-class.md).| -|[view_as](#view_as)|Produces an `array_view` object of a different rank using this `array_view` object's data.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator()](#operator_call)|Returns the value of the element that is specified by the parameter or parameters.| -|[operator\[\]](#operator_at)|Returns the element that is specified by the parameters.| -|[operator=](#operator_eq)|Copies the contents of the specified `array_view` object into this one.| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[rank Constant](#rank)|Stores the rank of the `array_view` object.| - -### Data Members - -|Name|Description| -|----------|-----------------| -|[extent](#extent)|Gets the `extent` object that defines the shape of the `array_view` object.| -|[source_accelerator_view](#source_accelerator_view)|Gets the [accelerator_view](accelerator-view-class.md) where the data source of the `array_view` is located| -|[value_type](#value_type)|The value type of the `array_view` and the bound array.| - -## Remarks - -The `array_view` class represents a view into the data that is contained in an [array](array-class.md) object or a subsection of an `array` object. - -You can access the `array_view` object where the source data is located (locally) or on a different accelerator or a coherence domain (remotely). When you access the object remotely, views are copied and cached as necessary. Except for the effects of automatic caching, `array_view` objects have a performance profile similar to that of `array` objects. There is a small performance penalty when you access the data through views. - -There are three remote usage scenarios: - -- A view to a system memory pointer is passed by means of a [parallel_for_each](../../../parallel/concrt/reference/concurrency-namespace-functions.md#parallel_for_each) call to an accelerator and accessed on the accelerator. - -- A view to an array located on an accelerator is passed by means of a `parallel_for_each` call to another accelerator and is accessed there. - -- A view to an array located on an accelerator is accessed on the CPU. - -In any one of these scenarios, the referenced views are copied by the runtime to the remote location and, if modified by the calls to the `array_view` object, are copied back to the local location. The runtime might optimize the process of copying changes back, might copy only changed elements, or might copy unchanged portions also. Overlapping `array_view` objects on one data source are not guaranteed to maintain referential integrity in a remote location. - -You must synchronize any multithreaded access to the same data source. - -The runtime makes the following guarantees regarding the caching of data in `array_view` objects: - -- All well-synchronized accesses to an `array` object and an `array_view` object on it in program order obey a serial happens-before relationship. - -- All well-synchronized accesses to overlapping `array_view` objects on the same accelerator on a single `array` object are aliased through the `array` object. They induce a total occurs-before relationship which obeys program order. There is no caching. If the `array_view` objects are executing on different accelerators, the order of access is undefined, creating a race condition. - -When you create an `array_view` object using a pointer in system memory, you must change the view `array_view` object only through the `array_view` pointer. Alternatively, you must call `refresh()` on one of the `array_view` objects that are attached to the system pointer, if the underlying native memory is changed directly, instead of through the `array_view` object. - -Either action notifies the `array_view` object that the underlying native memory is changed and that any copies that are located on an accelerator are outdated. If you follow these guidelines, the pointer-based views are identical to those provided to views of data-parallel arrays. - -## Inheritance Hierarchy - -`_Array_view_shape` - -`_Array_view_base` - -`array_view` - -## Requirements - -**Header:** amp.h - -**Namespace:** Concurrency - -## ~array_view - -Destroys the `array_view` object. - -```cpp -~array_view()restrict(amp,cpu); -``` - -## array_view - -Initializes a new instance of the `array_view` class. - -```cpp -array_view( - array& _Src)restrict(amp,cpu); - -array_view( - const array_view& _Other)restrict(amp,cpu); - -explicit array_view( - const Concurrency::extent<_Rank>& _Extent) restrict(cpu); - -template < - typename _Container -> -array_view( - const Concurrency::extent<_Rank>& _Extent, - _Container& _Src) restrict(cpu); - -array_view( - const Concurrency::extent<_Rank>& _Extent, - value_type* _Src)restrict(amp,cpu); - -explicit array_view( - int _E0) restrict(cpu); - -template < - typename _Container -> -explicit array_view( - _Container& _Src, - typename std::enable_if::type::value, void **>::type = 0) restrict(cpu); - -template < - typename _Container -> -explicit array_view( - int _E0, - _Container& _Src) restrict(cpu); - -explicit array_view( - int _E0, - int _E1) __CPU_ONLY; - -template < - typename _Container -> -explicit array_view( - int _E0, - int _E1, - _Container& _Src) restrict(cpu); - -explicit array_view( - int _E0, - int _E1, - int _E2) __CPU_ONLY; - -template < - typename _Container -> -explicit array_view( - int _E0, - int _E1, - int _E2, - _Container& _Src); - -explicit array_view( - int _E0, - _In_ value_type* _Src)restrict(amp,cpu); - -template < - typename _Arr_type, - int _Size -> -explicit array_view( - _In_ _Arr_type (& _Src) [_Size]) restrict(amp,cpu); - -explicit array_view( - int _E0, - int _E1, - _In_ value_type* _Src)restrict(amp,cpu); - -explicit array_view( - int _E0, - int _E1, - int _E2, - _In_ value_type* _Src)restrict(amp,cpu); - -array_view( - const array& _Src)restrict(amp,cpu); - -array_view( - const array_view& _Src)restrict(amp,cpu); - -array_view( - const array_view& _Src)restrict(amp,cpu); - -template < - typename _Container -> -array_view( - const Concurrency::extent<_Rank>& _Extent, - const _Container& _Src) restrict(cpu); - -template < - typename _Container -> -explicit array_view( - const _Container& _Src, - typename std::enable_if::type::value, void **>::type = 0) restrict(cpu); - -array_view( - const Concurrency::extent<_Rank>& _Extent, - const value_type* _Src)restrict(amp,cpu); - -template < - typename _Arr_type, - int _Size -> -explicit array_view( - const _In_ _Arr_type (& _Src) [_Size]) restrict(amp,cpu); - -template < - typename _Container -> -array_view( - int _E0, - const _Container& _Src); - -template < - typename _Container -> -array_view( - int _E0, - int _E1, - const _Container& _Src); - -template < - typename _Container -> -array_view( - int _E0, - int _E1, - int _E2, - const _Container& _Src); - -array_view( - int _E0, - const value_type* _Src)restrict(amp,cpu); - -array_view( - int _E0, - int _E1, - const value_type* _Src) restrict(amp,cpu); - -array_view( - int _E0, - int _E1, - int _E2, - const value_type* _Src) restrict(amp,cpu); -``` - -### Parameters - -*_Arr_type*
-The element type of a C-style array from which data is supplied. - -*_Container*
-A template argument that must specify a linear container that supports `data()` and `size()` members. - -*_E0*
-The most significant component of the extent of this section. - -*_E1*
-The next-to-most-significant component of the extent of this section. - -*_E2*
-The least significant component of the extent of this section. - -*_Extent*
-The extent in each dimension of this `array_view`. - -*_Other*
-An object of type `array_view` from which to initialize the new `array_view`. - -*_Size*
-The size of a C-style array from which data is supplied. - -*_Src*
-A pointer to the source data that will be copied into the new array. - -## copy_to - -Copies the contents of the `array_view` object to the specified destination object by calling `copy(*this, dest)`. - -```cpp -void copy_to( - array& _Dest) const; - -void copy_to( - array_view& _Dest) const; -``` - -### Parameters - -*_Dest*
-The object to copy to. - -## data - -Returns a pointer to the raw data of the `array_view`. - -```cpp -value_type* data() const restrict(amp, - cpu); - -const value_type* data() const restrict(amp, - cpu); -``` - -### Return Value - -A pointer to the raw data of the `array_view`. - -## discard_data - -Discards the current data underlying this view. This is an optimization hint to the runtime used to avoid copying the current contents of the view to a target `accelerator_view` that it is accessed on, and its use is recommended if the existing content is not needed. This method is a no-op when used in a restrict(amp) context - -```cpp -void discard_data() const restrict(cpu); -``` - -## extent - -Gets the `extent` object that defines the shape of the `array_view` object. - -```cpp -__declspec(property(get= get_extent)) Concurrency::extent<_Rank> extent; -``` - -## get_extent - -Returns the [extent](extent-class.md) object of the `array_view` object. - -```cpp -Concurrency::extent<_Rank> get_extent() const restrict(cpu, amp); -``` - -### Return Value - -The `extent` object of the `array_view` object - -## get_ref - -Get a reference to the element indexed by _Index. Unlike the other indexing operators for accessing the array_view on the CPU, this method does not implicitly synchronize this array_view's contents to the CPU. After accessing the array_view on a remote location or performing a copy operation involving this array_view users are responsible to explicitly synchronize the array_view to the CPU before calling this method. Failure to do so results in undefined behavior. - -```cpp -value_type& get_ref( - const index<_Rank>& _Index) const restrict(amp, cpu); -``` - -### Parameters - -*_Index*
-The index. - -### Return Value - -Reference to the element indexed by _Index - -## get_source_accelerator_view - -Returns the accelerator_view where the data source of the array_view is located. If the array_view does not have a data source, this API throws a runtime_exception - -```cpp -accelerator_view get_source_accelerator_view() const; -``` - -### Return Value - -## operator() - -Returns the value of the element that is specified by the parameter or parameters. - -```cpp -value_type& operator() ( - const index<_Rank>& _Index) const restrict(amp,cpu); - -typename details::_Projection_result_type::_Result_type operator() ( - int _I) const restrict(amp,cpu); - -value_type& operator() ( - int _I0, - int _I1) const restrict(amp,cpu); - -value_type& operator() ( - int _I0, - int _I1, - int _I2) const restrict(amp,cpu); - -typename details::_Projection_result_type::_Const_result_type operator() ( - int _I) const restrict(amp,cpu); -``` - -### Parameters - -*_Index*
-The location of the element. - -*_I0*
-The index in the first dimension. - -*_I1*
-The index in the second dimension. - -*_I2*
-The index in the third dimension. - -*_I*
-The location of the element. - -### Return Value - -The value of the element that is specified by the parameter or parameters. - -## operator[] - -Returns the element that is specified by the parameters. - -```cpp -typename details::_Projection_result_type::_Const_result_type operator[] ( - int _I) const restrict(amp,cpu); - -value_type& operator[] ( - const index<_Rank>& _Index) const restrict(amp,cpu); -``` - -### Parameters - -*_Index*
-The index. - -*_I*
-The index. - -### Return Value - -The value of the element at the index, or an `array_view` projected on the most-significant dimension. - -## operator= - -Copies the contents of the specified `array_view` object to this one. - -```cpp -array_view& operator= ( - const array_view& _Other) restrict(amp,cpu); - -array_view& operator= ( - const array_view& _Other) restrict(amp,cpu); -``` - -### Parameters - -*_Other*
-The `array_view` object to copy from. - -### Return Value - -A reference to this `array_view` object. - -## rank - -Stores the rank of the `array_view` object. - -```cpp -static const int rank = _Rank; -``` - -## refresh - -Notifies the `array_view` object that its bound memory has been modified outside the `array_view` interface. A call to this method renders all cached information stale. - -```cpp -void refresh() const restrict(cpu); -``` - -## reinterpret_as - -Reinterprets the array_view through a one-dimensional array_view, which as an option can have a different value type than the source array_view. - -### Syntax - -```cpp -template < - typename _Value_type2 -> -array_view< _Value_type2, _Rank> reinterpret_as() const restrict(amp,cpu); - -template < - typename _Value_type2 -> -array_view reinterpret_as() const restrict(amp,cpu); -``` - -### Parameters - -*_Value_type2*
-The data type of the new `array_view` object. - -### Return Value - -An `array_view` object or a const `array_view` object that is based on this `array_view`, with the element type converted from `T` to `_Value_type2`, and the rank reduced from *N* to 1. - -### Remarks - -Sometimes it is convenient to view a multi-dimensional array as a linear, one-dimensional array, which may have a different value type than the source array. You can achieve this on an `array_view` by using this method. - -**Warning** Reinterpreting an array_view object by using a different value type is a potentially unsafe operation. This functionality should be used with care. - -Here's an example: - -```cpp -struct RGB { float r; float g; float b; }; - -array a = ...; -array_view v = a.reinterpret_as(); - -assert(v.extent == 3*a.extent); -``` - -## section - -Returns a subsection of the `array_view` object that's at the specified origin and, optionally, that has the specified extent. - -```cpp -array_view section( - const Concurrency::index<_Rank>& _Section_origin, - const Concurrency::extent<_Rank>& _Section_extent) const restrict(amp,cpu); - -array_view section( - const Concurrency::index<_Rank>& _Idx) const restrict(amp,cpu); - -array_view section( - const Concurrency::extent<_Rank>& _Ext) const restrict(amp,cpu); - -array_view section( - int _I0, - int _E0) const restrict(amp,cpu); - -array_view section( - int _I0, - int _I1, - int _E0, - int _E1) const restrict(amp,cpu); - -array_view section( - int _I0, - int _I1, - int _I2, - int _E0, - int _E1, - int _E2) const restrict(amp,cpu); -``` - -### Parameters - -*_E0*
-The most significant component of the extent of this section. - -*_E1*
-The next-to-most-significant component of the extent of this section. - -*_E2*
-The least significant component of the extent of this section. - -*_Ext*
-The [extent](extent-class.md) object that specifies the extent of the section. The origin is 0. - -*_Idx*
-The [index](index-class.md) object that specifies the location of the origin. The subsection is the rest of the extent. - -*_I0*
-The most significant component of the origin of this section. - -*_I1*
-The next-to-most-significant component of the origin of this section. - -*_I2*
-The least significant component of the origin of this section. - -*_Rank*
-The rank of the section. - -*_Section_extent*
-The [extent](extent-class.md) object that specifies the extent of the section. - -*_Section_origin*
-The [index](index-class.md) object that specifies the location of the origin. - -### Return Value - -A subsection of the `array_view` object that's at the specified origin and, optionally, that has the specified extent. When only the `index` object is specified, the subsection contains all elements in the associated extent that have indexes that are larger than the indexes of the elements in the `index` object. - -## source_accelerator_view - -Gets the source accelerator_view that this array_view is associated with. - -```cpp -__declspec(property(get= get_source_accelerator_view)) accelerator_view source_accelerator_view; -``` - -## synchronize - -Synchronizes any modifications made to the `array_view` object back to its source data. - -```cpp -void synchronize(access_type _Access_type = access_type_read) const restrict(cpu); - -void synchronize() const restrict(cpu); -``` - -### Parameters - -*_Access_type*
-The intended [access_type](concurrency-namespace-enums-amp.md#access_type) on the target [accelerator_view](accelerator-view-class.md). This parameter has a default value of `access_type_read`. - -## synchronize_async - -Asynchronously synchronizes any modifications made to the `array_view` object back to its source data. - -```cpp -concurrency::completion_future synchronize_async(access_type _Access_type = access_type_read) const restrict(cpu); - -concurrency::completion_future synchronize_async() const restrict(cpu); -``` - -### Parameters - -*_Access_type*
-The intended [access_type](concurrency-namespace-enums-amp.md#access_type) on the target [accelerator_view](accelerator-view-class.md). This parameter has a default value of `access_type_read`. - -### Return Value - -A future upon which to wait for the operation to complete. - -## synchronize_to - -Synchronizes any modifications made to this array_view to the specified accelerator_view. - -```cpp -void synchronize_to( - const accelerator_view& _Accl_view, - access_type _Access_type = access_type_read) const restrict(cpu); - -void synchronize_to( - const accelerator_view& _Accl_view) const restrict(cpu); -``` - -### Parameters - -*_Accl_view*
-The target accelerator_view to synchronize to. - -*_Access_type*
-The desired access_type on the target accelerator_view. This parameter has a default value of access_type_read. - -## synchronize_to_async - -Asynchronously synchronizes any modifications made to this array_view to the specified accelerator_view. - -```cpp -concurrency::completion_future synchronize_to_async( - const accelerator_view& _Accl_view, - access_type _Access_type = access_type_read) const restrict(cpu); - -concurrency::completion_future synchronize_to_async( - const accelerator_view& _Accl_view) const restrict(cpu); -``` - -### Parameters - -*_Accl_view*
-The target accelerator_view to synchronize to. - -*_Access_type*
-The desired access_type on the target accelerator_view. This parameter has a default value of access_type_read. - -### Return Value - -A future upon which to wait for the operation to complete. - -## value_type - -The value type of the array_view and the bound array. - -```cpp -typedef typenamevalue_type value_type; -``` - -## view_as - -Reinterprets this `array_view` as an `array_view` of a different rank. - -```cpp -template < - int _New_rank -> -array_view view_as( - const Concurrency::extent<_New_rank>& _View_extent) const restrict(amp,cpu); - -template < - int _New_rank -> -array_view view_as( - const Concurrency::extent<_New_rank> _View_extent) const restrict(amp,cpu); -``` - -### Parameters - -*_New_rank*
-The rank of the new `array_view` object. - -*_View_extent*
-The reshaping `extent`. - -*value_type*
-The data type of the elements in both the original [array](array-class.md) object and the returned `array_view` object. - -### Return Value - -The `array_view` object that is constructed. - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/completion-future-class.md b/docs/parallel/amp/reference/completion-future-class.md deleted file mode 100644 index 7441757f113..00000000000 --- a/docs/parallel/amp/reference/completion-future-class.md +++ /dev/null @@ -1,277 +0,0 @@ ---- -description: "Learn more about: completion_future Class" -title: "completion_future Class" -ms.date: "11/04/2016" -f1_keywords: ["completion_future", "AMPRT/completion_future", "AMPRT/Concurrency::completion_future::completion_future", "AMPRT/Concurrency::completion_future::get", "AMPRT/Concurrency::completion_future::then", "AMPRT/Concurrency::completion_future::to_task", "AMPRT/Concurrency::completion_future::valid", "AMPRT/Concurrency::completion_future::wait", "AMPRT/Concurrency::completion_future::wait_for", "AMPRT/Concurrency::completion_future::wait_until"] -ms.assetid: 1303c62e-546d-4b02-a578-251ed3fc0b6b ---- -# completion_future Class - -Represents a future corresponding to a C++ AMP asynchronous operation. - -## Syntax - -```cpp -class completion_future; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[completion_future Constructor](#ctor)|Initializes a new instance of the `completion_future` class.| -|[~completion_future Destructor](#dtor)|Destroys the `completion_future` object.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[get](#get)|Waits until the associated asynchronous operation completes.| -|[then](#then)|Chains a callback function object to the `completion_future` object to be executed when the associated asynchronous operation finishes execution.| -|[to_task](#to_task)|Returns a `task` object corresponding to the associated asynchronous operation.| -|[valid](#valid)|Gets a Boolean value that indicates whether the object is associated with an asynchronous operation.| -|[wait](#wait)|Blocks until the associated asynchronous operation completes.| -|[wait_for](#wait_for)|Blocks until the associated asynchronous operation completes or the time specified by `_Rel_time` has elapsed.| -|[wait_until](#wait_until)|Blocks until the associated asynchronous operation completes or until the current time exceeds the value specified by `_Abs_time`.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator std::shared_future\](#operator_shared_future)|Implicitly converts the `completion_future` object to an `std::shared_future` object.| -|[operator=](#operator_eq)|Copies the contents of the specified `completion_future` object into this one.| - -## Inheritance Hierarchy - -`completion_future` - -## Requirements - -**Header:** amprt.h - -**Namespace:** concurrency - -## completion_future - -Initializes a new instance of the `completion_future` class. - -### Syntax - -```cpp -completion_future(); - -completion_future( - const completion_future& _Other ); - -completion_future( - completion_future&& _Other ); -``` - -### Parameters - -*_Other*
-The `completion_future` object to copy or move. - -### Overloads List - -|Name|Description| -|----------|-----------------| -|`completion_future();`|Initializes a new instance of the `completion_future` Class| -|`completion_future(const completion_future& _Other);`|Initializes a new instance of the `completion_future` class by copying a constructor.| -|`completion_future(completion_future&& _Other);`|Initializes a new instance of the `completion_future` class by moving a constructor.| - -## get - -Waits until the associated asynchronous operation completes. Throws the stored exception if one was encountered during the asynchronous operation. - -### Syntax - -```cpp -void get() const; -``` - -## operator std::shared_future\ - -Implicitly converts the `completion_future` object to an `std::shared_future` object. - -### Syntax - -```cpp -operator std::shared_future() const; -``` - -### Return Value - -An `std::shared_future` object. - -## operator= - -Copies the contents of the specified `completion_future` object into this one. - -### Syntax - -```cpp -completion_future& operator= (const completion_future& _Other ); -completion_future& operator= (completion_future&& _Other ); -``` - -### Parameters - -*_Other*
-The object to copy from. - -### Return Value - -A reference to this `completion_future` object. - -## Overloads List - -|Name|Description| -|----------|-----------------| -|`completion_future& operator=(const completion_future& _Other);`|Copies the contents of the specified `completion_future` object into this one, using a deep copy.| -|`completion_future& operator=(completion_future&& _Other);`|Copies the contents of the specified `completion_future` object into this one, using a move assignment.| - -## then - -Chains a callback function object to the `completion_future` object to be executed when the associated asynchronous operation finishes execution. - -### Syntax - -```cpp -template -void then(const _Functor & _Func ) const; -``` - -### Parameters - -*_Functor*
-The callback functor. - -*_Func*
-The callback function object. - -## to_task - -Returns a `task` object corresponding to the associated asynchronous operation. - -### Syntax - -```cpp -concurrency::task to_task() const; -``` - -### Return Value - -A `task` object corresponding to the associated asynchronous operation. - -## valid - -Gets a Boolean value that indicates whether the object is associated with an asynchronous operation. - -### Syntax - -```cpp -bool valid() const; -``` - -### Return Value - -**`true`** if the object is associated with an asynchronous operation; otherwise, **`false`**. - -## wait - -Blocks until the associated asynchronous operation completes. - -### Syntax - -```cpp -void wait() const; -``` - -## wait_for - -Blocks until the associated asynchronous operation completes or the time that's specified by `_Rel_time` has elapsed. - -### Syntax - -```cpp -template < - class _Rep, - class _Period -> -std::future_status::future_status wait_for( - const std::chrono::duration< _Rep, _Period>& _Rel_time ) const; -``` - -### Parameters - -*_Rep*
-An arithmetic type that represents the number of ticks. - -*_Period*
-A std::ratio that represents the number of seconds that elapse per tick. - -*_Rel_time*
-The maximum amount of time to wait for the operation to complete. - -### Return Value - -Returns: - -- `std::future_status::deferred` if the associated asynchronous operation is not running. - -- `std::future_status::ready` if the associated asynchronous operation is finished. - -- `std::future_status::timeout` if the specified time period has elapsed. - -## wait_until - -Blocks until the associated asynchronous operation completes or until the current time exceeds the value specified by `_Abs_time`. - -### Syntax - -```cpp -template < - class _Clock, - class _Duration -> -std::future_status::future_status wait_until( - const std::chrono::time_point< _Clock, _Duration>& _Abs_time ) const; -``` - -### Parameters - -*_Clock*
-The clock on which this time point is measured. - -*_Duration*
-The time interval since the start of `_Clock`'s epoch, after which the function will time out. - -*_Abs_time*
-The point in time after which the function will time out. - -### Return Value - -Returns: - -1. `std::future_status::deferred` if the associated asynchronous operation is not running. - -1. `std::future_status::ready` if the associated asynchronous operation is finished. - -1. `std::future_status::timeout` if the time period specified has elapsed. - -## ~completion_future - -Destroys the `completion_future` object. - -### Syntax - -```cpp -~completion_future(); -``` - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md b/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md deleted file mode 100644 index 4576e407e43..00000000000 --- a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md +++ /dev/null @@ -1,583 +0,0 @@ ---- -title: "Concurrency::direct3d namespace functions (AMP)" -description: "Learn more about: Concurrency::direct3d namespace functions (AMP)" -ms.date: 08/31/2018 -f1_keywords: ["amp/Concurrency::direct3d::abs", "amp/Concurrency::direct3d::countbits", "amp/Concurrency::direct3d::create_accelerator_view", "amp/Concurrency::direct3d::d3d_access_lock", "amp/Concurrency::direct3d::d3d_access_unlock", "amp/Concurrency::direct3d::firstbithigh", "amp/Concurrency::direct3d::get_buffer", "amp/Concurrency::direct3d::get_device", "amp/Concurrency::direct3d::imax", "amp/Concurrency::direct3d::is_timeout_disabled", "amp/Concurrency::direct3d::mad", "amp/Concurrency::direct3d::noise", "amp/Concurrency::direct3d::radians", "amp/Concurrency::direct3d::reversebits", "amp/Concurrency::direct3d::saturate", "amp/Concurrency::direct3d::smoothstep", "amp/Concurrency::direct3d::step", "amp/Concurrency::direct3d::umin"] ---- -# Concurrency::direct3d namespace functions (AMP) - -The following functions are defined in the `Concurrency::direct3d` namespace (AMP): - -## Requirements - -**Header:** amp.h - -**Namespace:** Concurrency - -## abs - -Returns the absolute value of the argument. - -```cpp -inline int abs(int _X) restrict(amp); -``` - -### Parameters - -*_X*\ -Integer value - -### Return Value - -Returns the absolute value of the argument. - -## clamp - -Computes the value of the first specified argument clamped to a range defined by the second and third specified arguments. - -```cpp -inline float clamp( - float _X, - float _Min, - float _Max) restrict(amp); - -inline int clamp( - int _X, - int _Min, - int _Max) restrict(amp); -``` - -### Parameters - -*_X*\ -The value to be clamped. - -*_Min*\ -The lower bound of the clamping range. - -*_Max*\ -The upper bound of the clamping range. - -### Return Value - -The clamped value of `_X`. - -## countbits - -Counts the number of set bits in `_X`. - -```cpp -inline unsigned int countbits(unsigned int _X) restrict(amp); -``` - -### Parameters - -*_X*\ -Unsigned integer value - -### Return Value - -Returns the number of set bits in `_X`. - -## create_accelerator_view - -Creates an [accelerator_view](accelerator-view-class.md) object from a pointer to a Direct3D device interface. - -## Syntax - -```cpp -accelerator_view create_accelerator_view( - IUnknown * _D3D_device, - queuing_mode _Qmode = queuing_mode_automatic); - -accelerator_view create_accelerator_view( - accelerator& _Accelerator, - bool _Disable_timeout, - queuing_mode _Qmode = queuing_mode_automatic); -``` - -### Parameters - -*_Accelerator*\ -The accelerator on which the new accelerator_view is to be created. - -*_D3D_device*\ -The pointer to the Direct3D device interface. - -*_Disable_timeout*\ -A Boolean parameter that specifies whether timeout should be disabled for the newly created accelerator_view. This corresponds to the D3D11_CREATE_DEVICE_DISABLE_GPU_TIMEOUT flag for Direct3D device creation and is used to indicate if the operating system should allow workloads that take more than 2 seconds to execute without resetting the device per the Windows timeout detection and recovery mechanism. Use of this flag is recommended if you need to perform time consuming tasks on the accelerator_view. - -*_Qmode*\ -The [queuing_mode](concurrency-namespace-enums-amp.md#queuing_mode) to be used for the newly created accelerator_view. This parameter has a default value of `queuing_mode_automatic`. - -## Return Value - -The `accelerator_view` object created from the passed Direct3D device interface. - -## Remarks - -This function creates a new `accelerator_view` object from an existing pointer to a Direct3D device interface. If the function call succeeds, the reference count of the parameter is incremented by means of an `AddRef` call to the interface. You can safely release the object when it is no longer required in your DirectX code. If the method call fails, a [runtime_exception](runtime-exception-class.md) is thrown. - -The `accelerator_view` object that you create by using this function is thread safe. You must synchronize concurrent use of the `accelerator_view` object. Unsynchronized concurrent usage of the `accelerator_view` object and the raw ID3D11Device interface causes undefined behavior. - -The C++ AMP runtime provides detailed error information in debug mode by using the D3D Debug layer if you use the `D3D11_CREATE_DEVICE_DEBUG` flag. - -## d3d_access_lock - -Acquire a lock on an accelerator_view for the purpose of safely performing D3D operations on resources shared with the accelerator_view. The accelerator_view and all C++ AMP resources associated with this accelerator_view internally take this lock when performing operations and will block while another thread holds the D3D access lock. This lock is non-recursive: It is undefined behavior to call this function from a thread that already holds the lock. It is undefined behavior to perform operations on the accelerator_view or any data container associated with the accelerator_view from the thread that holds the D3D access lock. See also scoped_d3d_access_lock, a RAII-style class for a scope-based D3D access lock. - -```cpp -void __cdecl d3d_access_lock(accelerator_view& _Av); -``` - -### Parameters - -*_Av*\ -The accelerator_view to lock. - -## d3d_access_try_lock - -Attempt to acquire the D3D access lock on an accelerator_view without blocking. - -```cpp -bool __cdecl d3d_access_try_lock(accelerator_view& _Av); -``` - -### Parameters - -*_Av*\ -The accelerator_view to lock. - -### Return Value - -true if the lock was acquired, or false if it is currently held by another thread. - -## d3d_access_unlock - -Release the D3D access lock on the given accelerator_view. If the calling thread does not hold the lock on the accelerator_view the results are undefined. - -```cpp -void __cdecl d3d_access_unlock(accelerator_view& _Av); -``` - -### Parameters - -*_Av*\ -The accelerator_view for which the lock is to be released. - -## firstbithigh - -Gets the location of the first set bit in `_X`, beginning with the highest-order bit and moving towards the lowest-order bit. - -```cpp -inline int firstbithigh(int _X) restrict(amp); -``` - -### Parameters - -*_X*\ -Integer value - -### Return Value - -The location of the first set bit. - -## firstbitlow - -Gets the location of the first set bit in `_X`, beginning with the lowest-order bit and working toward the highest-order bit. - -```cpp -inline int firstbitlow(int _X) restrict(amp); -``` - -### Parameters - -*_X*\ -Integer value - -### Return Value - -Returns The location of the first set bit. - -## get_buffer - -Get the Direct3D buffer interface underlying the specified array. - -```cpp -template< - typename value_type, - int _Rank -> -IUnknown *get_buffer( - const array& _Array); -``` - -### Parameters - -*value_type*\ -The type of elements in the array. - -*_Rank*\ -The rank of the array. - -*_Array*\ -An array on a Direct3D accelerator_view for which the underlying Direct3D buffer interface is returned. - -### Return Value - -The IUnknown interface pointer corresponding to the Direct3D buffer underlying the array. - -## get_device - -Get the D3D device interface underlying a accelerator_view. - -```cpp -IUnknown* get_device(const accelerator_view Av); -``` - -### Parameters - -*Av*\ -The D3D accelerator_view for which the underlying D3D device interface is returned. - -### Return value - -The `IUnknown` interface pointer of the D3D device underlying the accelerator_view. - -## imax - -Determine the maximum numeric value of the arguments. - -```cpp -inline int imax( - int _X, - int _Y) restrict(amp); -``` - -### Parameters - -*_X*\ -Integer value - -*_Y*\ -Integer value - -### Return Value - -Return the maximum numeric value of the arguments. - -## imin - -Determine the minimum numeric value of the arguments. - -```cpp -inline int imin( - int _X, - int _Y) restrict(amp); -``` - -### Parameters - -*_X*\ -Integer value - -*_Y*\ -Integer value - -### Return Value - -Return the minimum numeric value of the arguments. - -## is_timeout_disabled - -Returns a boolean flag indicating if timeout is disabled for the specified accelerator_view. This corresponds to the D3D11_CREATE_DEVICE_DISABLE_GPU_TIMEOUT flag for Direct3D device creation. - -```cpp -bool __cdecl is_timeout_disabled(const accelerator_view& _Accelerator_view); -``` - -### Parameters - -*_Accelerator_view*\ -The accelerator_view for which the timeout disabled setting is to be queried. - -### Return Value - -A boolean flag indicating if timeout is disabled for the specified accelerator_view. - -## mad - -Computes the product of the first and second specified argument, then adds the third specified argument. - -```cpp -inline float mad( - float _X, - float _Y, - float _Z) restrict(amp); - -inline double mad( - double _X, - double _Y, - double _Z) restrict(amp); - -inline int mad( - int _X, - int _Y, - int _Z) restrict(amp); - -inline unsigned int mad( - unsigned int _X, - unsigned int _Y, - unsigned int _Z) restrict(amp); -``` - -### Parameters - -*_X*\ -The first specified argument. - -*_Y*\ -The second specified argument. - -*_Z*\ -The third specified argument. - -### Return Value - -The result of `_X` \* `_Y` + `_Z`. - -## make_array - -Create an array from a Direct3D buffer interface pointer. - -```cpp -template< - typename value_type, - int _Rank -> -array make_array( - const extent<_Rank>& _Extent, - const Concurrency::accelerator_view& _Rv, - IUnknown* _D3D_buffer); -``` - -### Parameters - -*value_type*\ -The element type of the array to be created. - -*_Rank*\ -The rank of the array to be created. - -*_Extent*\ -An extent that describes the shape of the array aggregate. - -*_Rv*\ -A D3D accelerator view on which the array is to be created. - -*_D3D_buffer*\ -IUnknown interface pointer of the D3D buffer to create the array from. - -### Return Value - -An array created using the provided Direct3D buffer. - -## noise - -Generates a random value using the Perlin noise algorithm. - -```cpp -inline float noise(float _X) restrict(amp); -``` - -### Parameters - -*_X*\ -Floating-point value from which to generate Perlin noise. - -### Return Value - -Returns the Perlin noise value within a range between -1 and 1. - -## radians - -Converts `_X` from degrees to radians. - -```cpp -inline float radians(float _X) restrict(amp); -``` - -### Parameters - -*_X*\ -Floating-point value - -### Return Value - -Returns `_X` converted from degrees to radians. - -## rcp - -Computes the reciprocal of the specified argument by using a fast approximation. - -```cpp -inline float rcp(float _X) restrict(amp); - -inline double rcp(double _X) restrict(amp); -``` - -### Parameters - -*_X*\ -The value for which to compute the reciprocal. - -### Return Value - -The reciprocal of the specified argument. - -## reversebits - -Reverses the order of the bits in `_X`. - -```cpp -inline unsigned int reversebits(unsigned int _X) restrict(amp); -``` - -### Parameters - -*_X*\ -Unsigned integer value - -### Return Value - -Returns the value with the bit order reversed in `_X`. - -## saturate - -Clamps `_X` within the range of 0 to 1. - -```cpp -inline float saturate(float _X) restrict(amp); -``` - -### Parameters - -*_X*\ -Floating-point value - -### Return Value - -Returns `_X` clamped within the range of 0 to 1. - -## sign - -Determines the sign of the specified argument. - -```cpp -inline int sign(int _X) restrict(amp); -``` - -### Parameters - -*_X*\ -Integer value - -### Return Value - -The sign of the argument. - -## smoothstep - -Returns a smooth Hermite interpolation between 0 and 1, if `_X` is in the range [_Min, _Max]. - -```cpp -inline float smoothstep( - float _Min, - float _Max, - float _X) restrict(amp); -``` - -### Parameters - -*_Min*\ -Floating-point value - -*_Max*\ -Floating-point value - -*_X*\ -Floating-point value - -### Return Value - -Returns 0 if `_X` is less than _Min; 1 if `_X` is greater than _Max; otherwise, a value between 0 and 1 if `_X` is in the range [_Min, _Max]. - -## step - -Compares two values, returning 0 or 1 based on which value is greater. - -```cpp -inline float step( - float _Y, - float _X) restrict(amp); -``` - -### Parameters - -*_Y*\ -Floating-point value - -*_X*\ -Floating-point value - -### Return Value - -Returns 1 if the `_X` is greater than or equal to `_Y`; otherwise, 0. - -## umax - -Determine the maximum numeric value of the arguments. - -```cpp -inline unsigned int umax( - unsigned int _X, - unsigned int _Y) restrict(amp); -``` - -### Parameters - -*_X*\ -Integer value - -*_Y*\ -Integer value - -### Return Value - -Return the maximum numeric value of the arguments. - -## umin - -Determine the minimum numeric value of the arguments. - -```cpp -inline unsigned int umin( - unsigned int _X, - unsigned int _Y) restrict(amp); -``` - -### Parameters - -*_X*\ -Integer value - -*_Y*\ -Integer value - -### Return Value - -Return the minimum numeric value of the arguments. - -## See also - -[Concurrency::direct3d Namespace](concurrency-direct3d-namespace.md) diff --git a/docs/parallel/amp/reference/concurrency-direct3d-namespace.md b/docs/parallel/amp/reference/concurrency-direct3d-namespace.md deleted file mode 100644 index 3c371c751ec..00000000000 --- a/docs/parallel/amp/reference/concurrency-direct3d-namespace.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -description: "Learn more about: Concurrency::direct3d Namespace" -title: "Concurrency::direct3d Namespace" -ms.date: "11/04/2016" -f1_keywords: ["amp/Concurrency::direct3d", "amprt/Concurrency::direct3d", "amp_short_vectors/Concurrency::direct3d", "amp_graphics/Concurrency::direct3d", "amp_math/Concurrency::direct3d"] -helpviewer_keywords: ["direct3d namespace"] -ms.assetid: 9566a2f1-4d5f-43e4-a3ac-676643d38420 ---- -# Concurrency::direct3d Namespace - -The `direct3d` namespace provides functions that support D3D interoperability. It lets you use D3D resources for compute in AMP code. It also allows use of resources created in AMP in D3D code, without creating redundant intermediate copies. You can incrementally accelerate the compute intensive sections of your DirectX applications by using C++ AMP, and use the D3D API on data produced from AMP computations. - -## Syntax - -```cpp -namespace direct3d; -``` - -## Members - -### Classes - -|Name|Description| -|----------|-----------------| -|[scoped_d3d_access_lock Class](scoped-d3d-access-lock-class.md)|An RAII wrapper for a D3D access lock on an `accelerator_view` object.| - -### Structures - -|Name|Description| -|----------|-----------------| -|[adopt_d3d_access_lock_t Structure](adopt-d3d-access-lock-t-structure.md)|Tag type to indicate the D3D access lock should be adopted rather than acquired.| - -### Functions - -|Name|Description| -|----------|-----------------| -|[abs](concurrency-direct3d-namespace-functions-amp.md#abs)|Returns the absolute value of the argument| -|[clamp](concurrency-direct3d-namespace-functions-amp.md#clamp)|Overloaded. Clamps _X to the specified _Min and _Max range| -|[countbits](concurrency-direct3d-namespace-functions-amp.md#countbits)|Counts the number of set bits in _X| -|[create_accelerator_view](concurrency-direct3d-namespace-functions-amp.md#create_accelerator_view)|Creates an [accelerator_view Class](accelerator-view-class.md) from a pointer to a Direct3D device interface| -|[d3d_access_lock](concurrency-direct3d-namespace-functions-amp.md#d3d_access_lock)|Acquires a lock on an accelerator_view to safely perform D3D operations on resources shared with the accelerator_view| -|[d3d_access_try_lock](concurrency-direct3d-namespace-functions-amp.md#d3d_access_try_lock)|Attempt to acquire the D3D access lock on an accelerator_view without blocking.| -|[d3d_access_unlock](concurrency-direct3d-namespace-functions-amp.md#d3d_access_unlock)|Release the D3D access lock on the given accelerator_view.| -|[firstbithigh](concurrency-direct3d-namespace-functions-amp.md#firstbithigh)|Gets the location of the first set bit in _X, starting from the highest order bit and working downward| -|[firstbitlow](concurrency-direct3d-namespace-functions-amp.md#firstbitlow)|Gets the location of the first set bit in _X, starting from the lowest order bit and working upward| -|[get_buffer](concurrency-direct3d-namespace-functions-amp.md#get_buffer)|Get the D3D buffer interface underlying an array.| -|[imax](concurrency-direct3d-namespace-functions-amp.md#imax)|Compares two values, returning the value that's greater.| -|[imin](concurrency-direct3d-namespace-functions-amp.md#imin)|Compares two values, returning the value that's smaller.| -|[is_timeout_disabled](concurrency-direct3d-namespace-functions-amp.md#is_timeout_disabled)|Returns a boolean flag indicating if timeout is disabled for the specified accelerator_view.| -|[mad](concurrency-direct3d-namespace-functions-amp.md#mad)|Overloaded. Performs an arithmetic multiply/add operation on three arguments: _X \* _Y + _Z| -|[make_array](concurrency-direct3d-namespace-functions-amp.md#make_array)|Create an array from a D3D buffer interface pointer.| -|[noise](concurrency-direct3d-namespace-functions-amp.md#noise)|Generates a random value by using the Perlin noise algorithm| -|[radians](concurrency-direct3d-namespace-functions-amp.md#radians)|Converts _X from degrees to radians| -|[rcp](concurrency-direct3d-namespace-functions-amp.md#rcp)|Calculates a fast, approximate reciprocal of the argument| -|[reversebits](concurrency-direct3d-namespace-functions-amp.md#reversebits)|Reverses the order of the bits in _X| -|[saturate](concurrency-direct3d-namespace-functions-amp.md#saturate)|Clamps _X within the range of 0 to 1| -|[sign](concurrency-direct3d-namespace-functions-amp.md#sign)|Overloaded. Returns the sign of the argument| -|[smoothstep](concurrency-direct3d-namespace-functions-amp.md#smoothstep)|Returns a smooth Hermite interpolation between 0 and 1, if _X is in the range [_Min, _Max].| -|[step](concurrency-direct3d-namespace-functions-amp.md#step)|Compares two values, returning 0 or 1 based on which value is greater| -|[umax](concurrency-direct3d-namespace-functions-amp.md#umax)|Compares two unsigned values, returning the value that's greater.| -|[umin](concurrency-direct3d-namespace-functions-amp.md#umin)|Compares two unsigned values, returning the value that's smaller.| - -## Requirements - -**Header:** amp.h - -**Namespace:** Concurrency - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md deleted file mode 100644 index 3bbf140a6af..00000000000 --- a/docs/parallel/amp/reference/concurrency-fast-math-namespace-functions.md +++ /dev/null @@ -1,1211 +0,0 @@ ---- -title: "Concurrency::fast_math namespace functions" -description: "Learn more about: Concurrency::fast_math namespace functions" -ms.date: 11/04/2016 -f1_keywords: ["amp_math/Concurrency::fast_math::acos", "amp_math/Concurrency::fast_math::asin", "amp_math/Concurrency::fast_math::asinf", "amp_math/Concurrency::fast_math::atan2", "amp_math/Concurrency::fast_math::atan2f", "amp_math/Concurrency::fast_math::ceil", "amp_math/Concurrency::fast_math::ceilf", "amp_math/Concurrency::fast_math::cosf", "amp_math/Concurrency::fast_math::cosh", "amp_math/Concurrency::fast_math::exp", "amp_math/Concurrency::fast_math::exp2", "amp_math/Concurrency::fast_math::expf", "amp_math/Concurrency::fast_math::fabs", "amp_math/Concurrency::fast_math::floor", "amp_math/Concurrency::fast_math::floorf", "amp_math/Concurrency::fast_math::fmaxf", "amp_math/Concurrency::fast_math::fmin", "amp_math/Concurrency::fast_math::fmod", "amp_math/Concurrency::fast_math::fmodf", "amp_math/Concurrency::fast_math::frexpf", "amp_math/Concurrency::fast_math::isfinite", "amp_math/Concurrency::fast_math::isnan", "amp_math/Concurrency::fast_math::ldexp", "amp_math/Concurrency::fast_math::log", "amp_math/Concurrency::fast_math::log10", "amp_math/Concurrency::fast_math::log2", "amp_math/Concurrency::fast_math::log2f", "amp_math/Concurrency::fast_math::modf", "amp_math/Concurrency::fast_math::modff", "amp_math/Concurrency::fast_math::powf", "amp_math/Concurrency::fast_math::round", "amp_math/Concurrency::fast_math::rsqrt", "amp_math/Concurrency::fast_math::rsqrtf", "amp_math/Concurrency::fast_math::signbitf", "amp_math/Concurrency::fast_math::sin", "amp_math/Concurrency::fast_math::sincosf", "amp_math/Concurrency::fast_math::sinf", "amp_math/Concurrency::fast_math::sinhf", "amp_math/Concurrency::fast_math::sqrt", "amp_math/Concurrency::fast_math::tan", "amp_math/Concurrency::fast_math::tanf", "amp_math/Concurrency::fast_math::tanhf", "amp_math/Concurrency::fast_math::trunc"] ---- -# Concurrency::fast_math namespace functions - -The following functions are available in the `Concurrency::fast_math` namespace: - -## acos - -Calculates the arccosine of the argument - -```cpp -inline float acos(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arccosine value of the argument - -## acosf - -Calculates the arccosine of the argument - -```cpp -inline float acosf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arccosine value of the argument - -## asin - -Calculates the arcsine of the argument - -```cpp -inline float asin(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arcsine value of the argument - -## asinf - -Calculates the arcsine of the argument - -```cpp -inline float asinf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arcsine value of the argument - -## atan - -Calculates the arctangent of the argument - -```cpp -inline float atan(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arctangent value of the argument - -## atan2 - -Calculates the arctangent of _Y/_X - -```cpp -inline float atan2( - float _Y, - float _X) restrict(amp); -``` - -### Parameters - -*_Y*
-Floating-point value - -*_X*
-Floating-point value - -### Return Value - -Returns the arctangent value of _Y/_X - -## atan2f - -Calculates the arctangent of _Y/_X - -```cpp -inline float atan2f( - float _Y, - float _X) restrict(amp); -``` - -### Parameters - -*_Y*
-Floating-point value - -*_X*
-Floating-point value - -### Return Value - -Returns the arctangent value of _Y/_X - -## atanf - -Calculates the arctangent of the argument - -```cpp -inline float atanf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arctangent value of the argument - -## ceil - -Calculates the ceiling of the argument - -```cpp -inline float ceil(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the ceiling of the argument - -## ceilf - -Calculates the ceiling of the argument - -```cpp -inline float ceilf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the ceiling of the argument - -## cosf - -Calculates the cosine of the argument - -```cpp -inline float cosf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the cosine value of the argument - -## coshf - -Calculates the hyperbolic cosine value of the argument - -```cpp -inline float coshf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic cosine value of the argument - -## cos - -Calculates the cosine of the argument - -```cpp -inline float cos(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the cosine value of the argument - -## cosh - -Calculates the hyperbolic cosine value of the argument - -```cpp -inline float cosh(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic cosine value of the argument - -## exp - -Calculates the base-e exponential of the argument - -```cpp -inline float exp(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e exponential of the argument - -## exp2 - -Calculates the base-2 exponential of the argument - -```cpp -inline float exp2(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-2 exponential of the argument - -## exp2f - -Calculates the base-2 exponential of the argument - -```cpp -inline float exp2f(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-2 exponential of the argument - -## expf - -Calculates the base-e exponential of the argument - -```cpp -inline float expf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e exponential of the argument - -## fabs - -Returns the absolute value of the argument - -```cpp -inline float fabs(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Integer value - -### Return Value - -Returns the absolute value of the argument - -## fabsf - -Returns the absolute value of the argument - -```cpp -inline float fabsf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the absolute value of the argument - -## floor - -Calculates the floor of the argument - -```cpp -inline float floor(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the floor of the argument - -## floorf - -Calculates the floor of the argument - -```cpp -inline float floorf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the floor of the argument - -## fmax - -Determine the maximum numeric value of the arguments - -```cpp -inline float max( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Integer value - -*_Y*
-Integer value - -### Return Value - -Return the maximum numeric value of the arguments - -## fmaxf - -Determine the maximum numeric value of the arguments - -```cpp -inline float fmaxf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Return the maximum numeric value of the arguments - -## fmin - -Determine the minimum numeric value of the arguments - -```cpp -inline float min( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Integer value - -*_Y*
-Integer value - -### Return Value - -Return the minimum numeric value of the arguments - -## fminf - -Determine the minimum numeric value of the arguments - -```cpp -inline float fminf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Return the minimum numeric value of the arguments - -## fmod - -Calculates the floating-point remainder of _X/_Y - -```cpp -inline float fmod( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns the floating-point remainder of _X/_Y - -## fmodf - -Calculates the floating-point remainder of _X/_Y. - -```cpp -inline float fmodf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns the floating-point remainder of _X/_Y - -## frexp - -Gets the mantissa and exponent of _X - -```cpp -inline float frexp( - float _X, - _Out_ int* _Exp) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Exp*
-Returns the integer exponent of _X in floating-point value - -### Return Value - -Returns the mantissa _X - -## frexpf - -Gets the mantissa and exponent of _X - -```cpp -inline float frexpf( - float _X, - _Out_ int* _Exp) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Exp*
-Returns the integer exponent of _X in floating-point value - -### Return Value - -Returns the mantissa _X - -## isfinite - -Determines whether the argument has a finite value - -```cpp -inline int isfinite(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the argument has a finite value - -## isinf - -Determines whether the argument is an infinity - -```cpp -inline int isinf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the argument has an infinite value - -## isnan - -Determines whether the argument is a NaN - -```cpp -inline int isnan(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the argument has a NaN value - -## ldexp - -Computes a real number from the mantissa and exponent - -```cpp -inline float ldexp( - float _X, - int _Exp) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value, mentissa - -*_Exp*
-Integer exponent - -### Return Value - -Returns _X \* 2^_Exp - -## ldexpf - -Computes a real number from the mantissa and exponent - -```cpp -inline float ldexpf( - float _X, - int _Exp) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value, mentissa - -*_Exp*
-Integer exponent - -### Return Value - -Returns _X \* 2^_Exp - -## log - -Calculates the base-e logarithm of the argument - -```cpp -inline float log(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e logarithm of the argument - -## log10 - -Calculates the base-10 logarithm of the argument - -```cpp -inline float log10(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-10 logarithm of the argument - -## log10f - -Calculates the base-10 logarithm of the argument - -```cpp -inline float log10f(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-10 logarithm of the argument - -## log2 - -Calculates the base-2 logarithm of the argument - -```cpp -inline float log2(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-2 logarithm of the argument - -## log2f - -Calculates the base-2 logarithm of the argument - -```cpp -inline float log2f(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-10 logarithm of the argument - -## logf - -Calculates the base-e logarithm of the argument - -```cpp -inline float logf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e logarithm of the argument - -## modf - -Splits _X into fractional and integer parts. - -```cpp -inline float modf( - float _X, - float* _Ip) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Ip*
-Receives integer part of the value - -### Return Value - -Returns the signed fractional portion of _X - -## modff - -Splits _X into fractional and integer parts. - -```cpp -inline float modff( - float _X, - float* _Ip) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Ip*
-Receives integer part of the value - -### Return Value - -Returns the signed fractional portion of _X - -## pow - -Calculates _X raised to the power of _Y - -```cpp -inline float pow( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value, base - -*_Y*
-Floating-point value, exponent - -### Return Value - -Returns the value of _X raised to the power of _Y - -## powf - -Calculates _X raised to the power of _Y - -```cpp -inline float powf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value, base - -*_Y*
-Floating-point value, exponent - -### Return Value - -## round - -Rounds _X to the nearest integer - -```cpp -inline float round(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the nearest integer of _X - -## roundf - -Rounds _X to the nearest integer - -```cpp -inline float roundf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the nearest integer of _X - -## rsqrt - -Returns the reciprocal of the square root of the argument - -```cpp -inline float rsqrt(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the reciprocal of the square root of the argument - -## rsqrtf - -Returns the reciprocal of the square root of the argument - -```cpp -inline float rsqrtf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the reciprocal of the square root of the argument - -## signbit - -Determines whether the sign of _X is negative - -```cpp -inline int signbit(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the sign of _X is negative - -## signbitf - -Determines whether the sign of _X is negative - -```cpp -inline int signbitf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the sign of _X is negative - -## sin - -Calculates the sine value of the argument - -```cpp -inline float sin(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the sine value of the argument - -## sinf - -Calculates the sine value of the argument - -```cpp -inline float sinf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the sine value of the argument - -## sincos - -Calculates sine and cosine value of _X - -```cpp -inline void sincos( - float _X, - float* _S, - float* _C) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_S*
-Returns the sine value of _X - -*_C*
-Returns the cosine value of _X - -## sincosf - -Calculates sine and cosine value of _X - -```cpp -inline void sincosf( - float _X, - float* _S, - float* _C) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_S*
-Returns the sine value of _X - -*_C*
-Returns the cosine value of _X - -## sinh - -Calculates the hyperbolic sine value of the argument - -```cpp -inline float sinh(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic sine value of the argument - -## sinhf - -Calculates the hyperbolic sine value of the argument - -```cpp -inline float sinhf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic sine value of the argument - -## sqrt - -Calculates the squre root of the argument - -```cpp -inline float sqrt(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the squre root of the argument - -## sqrtf - -Calculates the squre root of the argument - -```cpp -inline float sqrtf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the squre root of the argument - -## tan - -Calculates the tangent value of the argument - -```cpp -inline float tan(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the tangent value of the argument - -## tanf - -Calculates the tangent value of the argument - -```cpp -inline float tanf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the tangent value of the argument - -## tanh - -Calculates the hyperbolic tangent value of the argument - -```cpp -inline float tanh(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic tangent value of the argument - -## tanhf - -Calculates the hyperbolic tangent value of the argument - -```cpp -inline float tanhf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic tangent value of the argument - -## trunc - -Truncates the argument to the integer component - -```cpp -inline float trunc(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the integer component of the argument - -## truncf - -Truncates the argument to the integer component - -```cpp -inline float truncf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the integer component of the argument - -## Requirements - -**Header:** amp_math.h -**Namespace:** Concurrency::fast_math - -## See also - -[Concurrency::fast_math Namespace](concurrency-fast-math-namespace.md) diff --git a/docs/parallel/amp/reference/concurrency-fast-math-namespace.md b/docs/parallel/amp/reference/concurrency-fast-math-namespace.md deleted file mode 100644 index 38e9403d86e..00000000000 --- a/docs/parallel/amp/reference/concurrency-fast-math-namespace.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -description: "Learn more about: Concurrency::fast_math Namespace" -title: "Concurrency::fast_math Namespace" -ms.date: "11/04/2016" -f1_keywords: ["amp_math/Concurrency::fast_math"] -ms.assetid: 54fed939-9902-49db-9f29-e98fd9821508 ---- -# Concurrency::fast_math Namespace - -Functions in the `fast_math` namespace have lower accuracy, support only single-precision (**`float`**), and call the DirectX intrinsics. There are two versions of each function, for example `cos` and `cosf`. Both versions take and return a **`float`**, but each calls the same DirectX intrinsic. - -## Syntax - -```cpp -namespace fast_math; -``` - -## Members - -### Functions - -|Name|Description| -|----------|-----------------| -|[cos](concurrency-fast-math-namespace-functions.md#cos)|Calculates the arccosine of the argument| -|[cosf](concurrency-fast-math-namespace-functions.md#cosf)|Calculates the arccosine of the argument| -|[asin](concurrency-fast-math-namespace-functions.md#asin)|Calculates the arcsine of the argument| -|[asinf](concurrency-fast-math-namespace-functions.md#asinf)|Calculates the arcsine of the argument| -|[atan](concurrency-fast-math-namespace-functions.md#atan)|Calculates the arctangent of the argument| -|[atan2](concurrency-fast-math-namespace-functions.md#atan2)|Calculates the arctangent of _Y/_X| -|[atan2f](concurrency-fast-math-namespace-functions.md#atan2f)|Calculates the arctangent of _Y/_X| -|[atanf](concurrency-fast-math-namespace-functions.md#atanf)|Calculates the arctangent of the argument| -|[ceil](concurrency-fast-math-namespace-functions.md#ceil)|Calculates the ceiling of the argument| -|[ceilf](concurrency-fast-math-namespace-functions.md#ceilf)|Calculates the ceiling of the argument| -|[cos](concurrency-fast-math-namespace-functions.md#cos)|Calculates the cosine of the argument| -|[cosf](concurrency-fast-math-namespace-functions.md#cosf)|Calculates the cosine of the argument| -|[cosh](concurrency-fast-math-namespace-functions.md#cosh)|Calculates the hyperbolic cosine value of the argument| -|[coshf](concurrency-fast-math-namespace-functions.md#coshf)|Calculates the hyperbolic cosine value of the argument| -|[exp](concurrency-fast-math-namespace-functions.md#exp)|Calculates the base-e exponential of the argument| -|[exp2](concurrency-fast-math-namespace-functions.md#exp2)|Calculates the base-2 exponential of the argument| -|[exp2f](concurrency-fast-math-namespace-functions.md#exp2f)|Calculates the base-2 exponential of the argument| -|[expf](concurrency-fast-math-namespace-functions.md#expf)|Calculates the base-e exponential of the argument| -|[fabs](concurrency-fast-math-namespace-functions.md#fabs)|Returns the absolute value of the argument| -|[fabsf](concurrency-fast-math-namespace-functions.md#fabsf)|Returns the absolute value of the argument| -|[floor](concurrency-fast-math-namespace-functions.md#floor)|Calculates the floor of the argument| -|[floorf](concurrency-fast-math-namespace-functions.md#floorf)|Calculates the floor of the argument| -|[fmax](concurrency-fast-math-namespace-functions.md#fmax)|Determine the maximum numeric value of the arguments| -|[fmaxf](concurrency-fast-math-namespace-functions.md#fmaxf)|Determine the maximum numeric value of the arguments| -|[fmin](concurrency-fast-math-namespace-functions.md#fmin)|Determine the minimum numeric value of the arguments| -|[fminf](concurrency-fast-math-namespace-functions.md#fminf)|Determine the minimum numeric value of the arguments| -|[fmod](concurrency-fast-math-namespace-functions.md#fmod)|Calculates the floating-point remainder of _X/_Y| -|[fmodf](concurrency-fast-math-namespace-functions.md#fmodf)|Calculates the floating-point remainder of _X/_Y| -|[frexp](concurrency-fast-math-namespace-functions.md#frexp)|Gets the mantissa and exponent of _X| -|[frexpf](concurrency-fast-math-namespace-functions.md#frexpf)|Gets the mantissa and exponent of _X| -|[isfinite](concurrency-fast-math-namespace-functions.md#isfinite)|Determines whether the argument has a finite value| -|[isinf](concurrency-fast-math-namespace-functions.md#isinf)|Determines whether the argument is an infinity| -|[isnan](concurrency-fast-math-namespace-functions.md#isnan)|Determines whether the argument is a NaN| -|[ldexp](concurrency-fast-math-namespace-functions.md#ldexp)|Computes a real number from the mantissa and exponent| -|[ldexpf](concurrency-fast-math-namespace-functions.md#ldexpf)|Computes a real number from the mantissa and exponent| -|[log](concurrency-fast-math-namespace-functions.md#log)|Calculates the base-e logarithm of the argument| -|[log10](concurrency-fast-math-namespace-functions.md#log10)|Calculates the base-10 logarithm of the argument| -|[log10f](concurrency-fast-math-namespace-functions.md#log10f)|Calculates the base-10 logarithm of the argument| -|[log2](concurrency-fast-math-namespace-functions.md#log2)|Calculates the base-2 logarithm of the argument| -|[log2f](concurrency-fast-math-namespace-functions.md#log2f)|Calculates the base-2 logarithm of the argument| -|[logf](concurrency-fast-math-namespace-functions.md#logf)|Calculates the base-e logarithm of the argument| -|[modf](concurrency-fast-math-namespace-functions.md#modf)|Splits _X into fractional and integer parts.| -|[modff](concurrency-fast-math-namespace-functions.md#modff)|Splits _X into fractional and integer parts.| -|[pow](concurrency-fast-math-namespace-functions.md#pow)|Calculates _X raised to the power of _Y| -|[powf](concurrency-fast-math-namespace-functions.md#powf)|Calculates _X raised to the power of _Y| -|[round](concurrency-fast-math-namespace-functions.md#round)|Rounds _X to the nearest integer| -|[roundf](concurrency-fast-math-namespace-functions.md#roundf)|Rounds _X to the nearest integer| -|[rsqrt](concurrency-fast-math-namespace-functions.md#rsqrt)|Returns the reciprocal of the square root of the argument| -|[rsqrtf](concurrency-fast-math-namespace-functions.md#rsqrtf)|Returns the reciprocal of the square root of the argument| -|[signbit](concurrency-fast-math-namespace-functions.md#signbit)|Returns the sign of the argument| -|[signbitf](concurrency-fast-math-namespace-functions.md#signbitf)|Returns the sign of the argument| -|[sin](concurrency-fast-math-namespace-functions.md#sin)|Calculates the sine value of the argument| -|[sincos](concurrency-fast-math-namespace-functions.md#sincos)|Calculates sine and cosine value of _X| -|[sincosf](concurrency-fast-math-namespace-functions.md#sincosf)|Calculates sine and cosine value of _X| -|[sinf](concurrency-fast-math-namespace-functions.md#sinf)|Calculates the sine value of the argument| -|[sinh](concurrency-fast-math-namespace-functions.md#sinh)|Calculates the hyperbolic sine value of the argument| -|[sinhf](concurrency-fast-math-namespace-functions.md#sinhf)|Calculates the hyperbolic sine value of the argument| -|[sqrt](concurrency-fast-math-namespace-functions.md#sqrt)|Calculates the square root of the argument| -|[sqrtf](concurrency-fast-math-namespace-functions.md#sqrtf)|Calculates the square root of the argument| -|[tan](concurrency-fast-math-namespace-functions.md#tan)|Calculates the tangent value of the argument| -|[tanf](concurrency-fast-math-namespace-functions.md#tanf)|Calculates the tangent value of the argument| -|[tanh](concurrency-fast-math-namespace-functions.md#tanh)|Calculates the hyperbolic tangent value of the argument| -|[tanhf](concurrency-fast-math-namespace-functions.md#tanhf)|Calculates the hyperbolic tangent value of the argument| -|[trunc](concurrency-fast-math-namespace-functions.md#trunc)|Truncates the argument to the integer component| -|[truncf](concurrency-fast-math-namespace-functions.md#truncf)|Truncates the argument to the integer component| - -## Requirements - -**Header:** amp_math.h - -**Namespace:** Concurrency::fast_math - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md deleted file mode 100644 index cea85945655..00000000000 --- a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md +++ /dev/null @@ -1,162 +0,0 @@ ---- -title: "Concurrency::graphics::direct3d namespace functions" -description: "Learn more about: Concurrency::graphics::direct3d namespace functions" -ms.date: 11/04/2016 -f1_keywords: ["amp_graphics/Concurrency::graphics::direct3d::get_sampler", "amp_graphics/Concurrency::graphics::direct3d::make_sampler", "amp_graphics/Concurrency::graphics::direct3d::make_texture"] ---- -# Concurrency::graphics::direct3d namespace functions - -The following functions are available in the `Concurrency::graphics::direct3d` namespace: - -## get_sampler - -Get the D3D sampler state interface on the given accelerator view that represents the specified sampler object. - -```cpp -IUnknown* get_sampler( - const Concurrency::accelerator_view& _Av, - const sampler& _Sampler) restrict(amp); -``` - -### Parameters - -*_Av*
-A D3D accelerator view on which the D3D sampler state is to be created. - -*_Sampler*
-A sampler object for which the underlying D3D sampler state interface is created. - -### Return Value - -The IUnknown interface pointer corresponding to the D3D sampler state that represents the given sampler. - -## get_texture - -Gets the Direct3D texture interface underlying the specified [texture](texture-class.md) object. - -```cpp -template< - typename value_type, - int _Rank -> -_Ret_ IUnknown *get_texture( - const texture& _Texture) restrict(cpu); - -template< - typename value_type, - int _Rank -> -_Ret_ IUnknown *get_texture( - const writeonly_texture_view& _Texture) restrict(cpu); - -template< - typename value_type, - int _Rank -> -_Ret_ IUnknown *get_texture( - const texture_view& _Texture) restrict(cpu); -``` - -### Parameters - -*value_type*
-The element type of the texture. - -*_Rank*
-The rank of the texture. - -*_Texture*
-A texture or texture view associated with the accelerator_view for which the underlying Direct3D texture interface is returned. - -### Return Value - -The IUnknown interface pointer corresponding to the Direct3D texture underlying the texture. - -## make_sampler - -Create a sampler from a D3D sampler state interface pointer. - -```cpp -sampler make_sampler(_In_ IUnknown* _D3D_sampler) restrict(amp); -``` - -### Parameters - -*_D3D_sampler*
-IUnknown interface pointer of the D3D sampler state to create the sampler from. - -### Return Value - -A sampler represents the provided D3D sampler state. - -## make_texture - -Creates a [texture](texture-class.md) object by using the specified parameters. - -```cpp -template< - typename value_type, - int _Rank -> -texture make_texture( - const Concurrency::accelerator_view& _Av, - _In_ IUnknown* _D3D_texture, - DXGI_FORMAT _View_format = DXGI_FORMAT_UNKNOWN) restrict(cpu); -``` - -### Parameters - -*value_type*
-The type of the elements in the texture. - -*_Rank*
-The rank of the texture. - -*_Av*
-A D3D accelerator view on which the texture is to be created. - -*_D3D_texture*
-IUnknown interface pointer of the D3D texture to create the texture from. - -*_View_format*
-The DXGI format to use for views created from this texture. Pass DXGI_FORMAT_UNKNOWN (the default) to derive the format from the underlying format of _D3D_texture and the value_type of this template. The provided format must be compatible with the underlying format of _D3D_texture. - -### Return Value - -A texture using the provided D3D texture. - -## msad4 - -Compares a 4-byte reference value and an 8-byte source value and accumulates a vector of 4 sums. Each sum corresponds to the masked sum of absolute differences of different byte alignments between the reference value and the source value. - -```cpp -inline uint4 msad4( - uint _Reference, - uint2 _Source, - uint4 _Accum) restrict(amp); -``` - -### Parameters - -*_Reference*
-The reference array of 4 bytes in one uint value - -*_Source*
-The source array of 8 bytes in a vector of two uint values. - -*_Accum*
-A vector of 4 values to be added to the masked sum of absolute differences of the different byte alignments between the reference value and the source value. - -### Return Value - -Returns a vector of 4 sums. Each sum corresponds to the masked sum of absolute differences of different byte alignments between the reference value and the source value. - -## Requirements - -**Header:** amp_graphics.h - -**Namespace:** Concurrency::graphics::direct3d - -## See also - -[Concurrency::graphics::direct3d Namespace](concurrency-graphics-direct3d-namespace.md) diff --git a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md deleted file mode 100644 index 05afb7f5aed..00000000000 --- a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: "Concurrency::graphics::direct3d Namespace" -description: "Learn more about: Concurrency::graphics::direct3d Namespace" -ms.date: 11/04/2016 -f1_keywords: ["amp_graphics/Concurrency::graphics::direct3d", "amp_short_vectors/Concurrency::graphics::direct3d"] ---- -# Concurrency::graphics::direct3d Namespace - -Provides the [get_texture](concurrency-graphics-direct3d-namespace-functions.md#get_texture) and [make_texture](concurrency-graphics-direct3d-namespace-functions.md#make_texture) methods. - -## Syntax - -```cpp -namespace direct3d; -``` - -## Members - -### Functions - -|Name|Description| -|----------|-----------------| -|[get_sampler](concurrency-graphics-direct3d-namespace-functions.md#get_sampler)|Get the Direct3D sampler state interface on the given accelerator view that represents the specified sampler object.| -|[get_texture](concurrency-graphics-direct3d-namespace-functions.md#get_texture)|Gets the Direct3D texture interface underlying the specified [texture](texture-class.md) object.| -|[make_sampler](concurrency-graphics-direct3d-namespace-functions.md#make_sampler)|Create a sampler from a Direct3D sampler state interface pointer.| -|[make_texture](concurrency-graphics-direct3d-namespace-functions.md#make_texture)|Creates a [texture](texture-class.md) object by using the specified parameters.| -|[msad4](concurrency-graphics-direct3d-namespace-functions.md#msad4)|Compares a 4-byte reference value and an 8-byte source value and accumulates a vector of 4 sums.| - -## Requirements - -**Header:** amp_graphics.h - -**Namespace:** Concurrency::graphics - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/concurrency-graphics-namespace-enums.md b/docs/parallel/amp/reference/concurrency-graphics-namespace-enums.md deleted file mode 100644 index 212776f47b4..00000000000 --- a/docs/parallel/amp/reference/concurrency-graphics-namespace-enums.md +++ /dev/null @@ -1,37 +0,0 @@ ---- -description: "Learn more about: Concurrency::graphics namespace enums" -title: "Concurrency::graphics namespace enums" -ms.date: "11/04/2016" -f1_keywords: ["amp_graphics/concurrency::graphics::address_mode", "amp_graphics/concurrency::graphics::filter_mode"] -ms.assetid: 1d2e1859-a3d7-4d3d-8e03-1a877a86b3e0 ---- -# Concurrency::graphics namespace enums - -|Name|Description| -|-|-| -|[_mode Enumeration](#address_mode)|[filter_mode Enumeration](#filter_mode)| - -## address_mode Enumeration - -Enumeration type use to denote address modes supported for texture sampling. - -```cpp -enum address_mode; -``` - -## filter_mode Enumeration - -Enumeration type use to denote filter modes supported for texture sampling. - -```cpp -enum filter_mode; -``` - -## Requirements - -**Header:** amp_graphics.h -**Namespace:** Concurrency::graphics - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md b/docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md deleted file mode 100644 index e9e8eef1890..00000000000 --- a/docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md +++ /dev/null @@ -1,293 +0,0 @@ ---- -title: "Concurrency::graphics namespace functions" -description: "Learn more about: Concurrency::graphics namespace functions" -ms.date: 11/04/2016 -f1_keywords: ["amp_graphics/Concurrency::fast_math::copy_async", "amp_graphics/Concurrency::fast_math::copy"] ---- -# Concurrency::graphics namespace functions - -The following functions are available in the `Concurrency::graphics` namespace: - -## copy Function (Concurrency::graphics Namespace) - -Copies a source texture into a destination buffer, or copies a source buffer into a destination buffer. The general form of this function is `copy(src, dest)`. - -```cpp -template < - typename _Src_type, - typename = typename std::enable_if::is_texture, void>::type> -> -void copy ( - const _Src_type& _Src, - _Out_ void* _Dst, - unsigned int _Dst_byte_size); - -template < - typename _Src_type, - typename = typename std::enable_if::is_texture, void>::type -> -void copy( - const _Src_type& _Src, - const index<_Src_type::rank>& _Src_offset, - const extent<_Src_type::rank>& _Copy_extent, - _Out_ void* _Dst, - unsigned int _Dst_byte_size); - -template < - typename _Dst_type, - typename = typename std::enable_if::is_texture, void>::type -> -void copy( - const void* _Src, - unsigned int _Src_byte_size, _Dst_type& _Dst); - -template < - typename _Dst_type, - typename = typename std::enable_if::is_texture, void>::type -> -void copy( - const void* _Src, - unsigned int _Src_byte_size, - _Dst_type& _Dst, - const index<_Dst_type::rank>& _Dst_offset, - const extent<_Dst_type::rank>& _Copy_extent); - -template < - typename InputIterator, - typename _Dst_type, - typename = typename std::enable_if::is_texture, void>::type -> -void copy(InputIterator first, InputIterator last, _Dst_type& _Dst); - -template < - typename InputIterator, - typename _Dst_type, - typename = typename std::enable_if::is_texture, void>::type ->void copy(InputIterator first, InputIterator last, _Dst_type& _Dst, - const index<_Dst_type::rank>& _Dst_offset, - const extent<_Dst_type::rank>& _Copy_extent); - -template < - typename _Src_type, - typename OutputIterator, - typename = typename std::enable_if::is_texture&& !details::texture_traits::is_texture, void>::type -> -void copy( - const _Src_type& _Src, OutputIterator _Dst); - -template < - typename _Src_type, - typename OutputIterator, - typename = typename std::enable_if::is_texture&& !details::texture_traits::is_texture, void>::type -> -void copy ( - const _Src_type& _Src, - const index<_Src_type::rank>& _Src_offset, - const extent<_Src_type::rank>& _Copy_extent, OutputIterator _Dst); - -template < - typename _Src_type, - typename _Dst_type, - typename = typename std::enable_if::is_texture&& details::texture_traits<_Dst_type>::is_texture, void>::type -> -void copy ( - const _Src_type& _Src, _Dst_type& _Dst); - -template < - typename _Src_type, - typename _Dst_type, - typename = typename std::enable_if::is_texture&& details::texture_traits<_Dst_type>::is_texture, - void>::type -> -void copy ( - const _Src_type& _Src, - const index<_Src_type::rank>& _Src_offset, _Dst_type& _Dst, - const index<_Dst_type::rank>& _Dst_offset, - const extent<_Src_type::rank>& _Copy_extent); -``` - -### Parameters - -*_Copy_extent*
-The extent of the texture section to be copied. - -*_Dst*
-The object to copy to. - -*_Dst_byte_size*
-The number of bytes in the destination. - -*_Dst_type*
-The type of the destination object. - -*_Dst_offset*
-The offset into the destination at which to begin copying. - -*InputIterator*
-The type of the input iterator. - -*OutputIterator*
-The type of the output iterator. - -*_Src*
-To object to copy. - -*_Src_byte_size*
-The number of bytes in the source. - -*_Src_type*
-The type of the source object. - -*_Src_offset*
-The offset into the source from which to begin copying. - -*first*
-A beginning iterator into the source container. - -*last*
-An ending iterator into the source container. - -## copy_async Function (Concurrency::graphics Namespace) - -Asynchronously copies a source texture into a destination buffer, or copies a source buffer into a destination buffer, and then returns a [completion_future](completion-future-class.md) object that can be waited on. Data can't be copied when code is running on an accelerator. The general form of this function is `copy(src, dest)`. - -```cpp -template< - typename _Src_type, - typename = typename std::enable_if::is_texture, void>::type -> -concurrency::completion_future copy_async( - const _Src_type& _Src, - _Out_ void* _Dst, - unsigned int _Dst_byte_size); - -template< - typename _Src_type, - typename = typename std::enable_if::is_texture, void>::type -> -concurrency::completion_future copy_async( - const _Src_type& _Src, - const index<_Src_type::rank>& _Src_offset, - const extent<_Src_type::rank>& _Copy_extent, - _Out_ void* _Dst, - unsigned int _Dst_byte_size); - -template < - typename _Dst_type, - typename = typename std::enable_if::is_texture, void>::type -> -concurrency::completion_future copy_async( - const void* _Src, - unsigned int _Src_byte_size, _Dst_type& _Dst); - -template < - typename _Dst_type, - typename = typename std::enable_if::is_texture, void>::type -> -concurrency::completion_future copy_async( - const void* _Src, - unsigned int _Src_byte_size, _Dst_type& _Dst, - const index<_Dst_type::rank>& _Dst_offset, - const extent<_Dst_type::rank>& _Copy_extent); - -template < - typename InputIterator, - typename _Dst_type, - typename = typename std::enable_if::is_texture, void>::type -> -concurrency::completion_future copy_async(InputIterator first, InputIterator last, _Dst_type& _Dst); - -template < - typename InputIterator, - typename _Dst_type, - typename = typename std::enable_if::is_texture, void>::type -> -concurrency::completion_future copy_async(InputIterator first, InputIterator last, _Dst_type& _Dst, - const index<_Dst_type::rank>& _Dst_offset, - const extent<_Dst_type::rank>& _Copy_extent); - -template < - typename _Src_type, - typename OutputIterator, - typename = typename std::enable_if::is_texture&& !details::texture_traits::is_texture, void>::type -> -concurrency::completion_future copy_async(_Src_type& _Src, OutputIterator _Dst); - -template < - typename _Src_type, - typename OutputIterator, - typename = typename std::enable_if::is_texture&& !details::texture_traits::is_texture, void>::type -> -concurrency::completion_future copy_async(_Src_type& _Src, - const index<_Src_type::rank>& _Src_offset, - const extent<_Src_type::rank>& _Copy_extent, - OutputIterator _Dst); - -template < - typename _Src_type, - typename _Dst_type, - typename = typename std::enable_if::is_texture&& details::texture_traits<_Dst_type>::is_texture, void>::type -> -concurrency::completion_future copy_async(_Src_type& _Src, _Dst_type& _Dst); - -template < - typename _Src_type, - typename _Dst_type, - typename = typename std::enable_if::is_texture&& details::texture_traits<_Dst_type>::is_texture, void>::type -> -concurrency::completion_future copy_async(_Src_type& _Src, - const index<_Src_type::rank>& _Src_offset, _Dst_type &_Dst, - const index<_Dst_type::rank>& _Dst_offset, - const extent<_Src_type::rank>& _Copy_extent); -``` - -### Parameters - -*_Copy_extent*
-The extent of the texture section to be copied. - -*_Dst*
-The object to copy to. - -*_Dst_byte_size*
-The number of bytes in the destination. - -*_Dst_type*
-The type of the destination object. - -*_Dst_offset*
-The offset into the destination at which to begin copying. - -*InputIterator*
-The type of the input iterator. - -*OutputIterator*
-The type of the output iterator. - -*_Src*
-To object to copy. - -*_Src_byte_size*
-The number of bytes in the source. - -*_Src_type*
-The type of the source object. - -*_Src_offset*
-The offset into the source from which to begin copying. - -*first*
-A beginning iterator into the source container. - -*last*
-An ending iterator into the source container. - -## Requirements - -**Header:** amp_graphics.h - -**Namespace:** Concurrency::graphics - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/concurrency-graphics-namespace.md b/docs/parallel/amp/reference/concurrency-graphics-namespace.md deleted file mode 100644 index cf1517f385d..00000000000 --- a/docs/parallel/amp/reference/concurrency-graphics-namespace.md +++ /dev/null @@ -1,83 +0,0 @@ ---- -description: "Learn more about: Concurrency::graphics Namespace" -title: "Concurrency::graphics Namespace" -ms.date: "11/04/2016" -f1_keywords: ["AMP_GRAPHICS/Concurrency"] -ms.assetid: 4529d3b1-d7da-4ffb-82bf-080915e0f23e ---- -# Concurrency::graphics Namespace - -The graphics namespace provides types and functions that are designed for graphics programming. - -## Syntax - -```cpp -namespace graphics; -``` - -## Members - -### Namespaces - -|Name|Description| -|----------|-----------------| -|[Concurrency::graphics::direct3d Namespace](concurrency-graphics-direct3d-namespace.md)|Provides functions for Direct3D interop.| - -### Typedefs - -|Name|Description| -|----------|-----------------| -|`uint`|The element type for [uint_2 Class](uint-2-class.md), [uint_3 Class](uint-3-class.md), and [uint_4 Class](uint-4-class.md). Defined as `typedef unsigned int uint;`.| - -### Enumerations - -|Name|Description| -|----------|-----------------| -|[address_mode Enumeration](concurrency-graphics-namespace-enums.md#address_mode).|Specifies address modes supported for texture sampling.| -|[filter_mode Enumeration](concurrency-graphics-namespace-enums.md#filter_mode)|Specifies filter modes supported for texture sampling.| - -### Classes - -|Name|Description| -|----------|-----------------| -|[texture Class](texture-class.md)|A texture is a data aggregate on an accelerator_view in the extent domain. It is a collection of variables, one for each element in an extent domain. Each variable holds a value corresponding to C++ primitive type (unsigned int, int, float, double), or scalar type norm, or unorm (defined in concurrency::graphics), or eligible short vector types defined in concurrency::graphics.| -|[writeonly_texture_view Class](writeonly-texture-view-class.md)|A writeonly_texture_view provides writeonly access to a texture.| -|[double_2 Class](double-2-class.md)|Represents a short vector of 2 **`double`** values.| -|[double_3 Class](double-3-class.md)|Represents a short vector of 3 **`double`** values.| -|[double_4 Class](double-4-class.md)|Represents a short vector of 4 **`double`** values.| -|[float_2 Class](float-2-class.md)|Represents a short vector of 2 **`float`** values.| -|[float_3 Class](float-3-class.md)|Represents a short vector of 3 **`float`** values.| -|[float_4 Class](float-4-class.md)|Represents a short vector of 4 **`float`** values.| -|[int_2 Class](int-2-class.md)|Represents a short vector of 2 **`int`** values.| -|[int_3 Class](int-3-class.md)|Represents a short vector of 3 **`int`** values.| -|[int_4 Class](int-4-class.md)|Represents a short vector of 4 **`int`** values.| -|[norm_2 Class](norm-2-class.md)|Represents a short vector of 2 `norm` values.| -|[norm_3 Class](norm-3-class.md)|Represents a short vector of 3 `norm` values.| -|[norm_4 Class](norm-4-class.md)|Represents a short vector of 4 `norm` values.| -|[uint_2 Class](uint-2-class.md)|Represents a short vector of 2 `uint` values.| -|[uint_3 Class](uint-3-class.md)|Represents a short vector of 3 `uint` values.| -|[uint_4 Class](uint-4-class.md)|Represents a short vector of 4 `uint` values.| -|[unorm_2 Class](unorm-2-class.md)|Represents a short vector of 2 `unorm` values.| -|[unorm_3 Class](unorm-3-class.md)|Represents a short vector of 3 `unorm` values.| -|[unorm_4 Class](unorm-4-class.md)|Represents a short vector of 4 `unorm` values.| -|[sampler Class](sampler-class.md)|Represents the sampler configuration used for texture sampling.| -|[short_vector Structure](short-vector-structure.md)|Provides a basic implementation of a short vector of values.| -|[short_vector_traits Structure](short-vector-traits-structure.md)|Provides for retrieval of the length and type of a short vector.| -|[texture_view Class](texture-view-class.md)|Provides read access and write access to a texture.| - -### Functions - -|Name|Description| -|----------|-----------------| -|[copy](concurrency-graphics-namespace-functions.md#copy)|Overloaded. Copies the contents of the source texture into the destination host buffer.| -|[copy_async](concurrency-graphics-namespace-functions.md#copy_async)|Overloaded. Asynchronously copies the contents of the source texture into the destination host buffer.| - -## Requirements - -**Header:** amp_graphics.h - -**Namespace:** Concurrency - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/concurrency-namespace-constants-amp.md b/docs/parallel/amp/reference/concurrency-namespace-constants-amp.md deleted file mode 100644 index a03bea4d1af..00000000000 --- a/docs/parallel/amp/reference/concurrency-namespace-constants-amp.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: "Concurrency namespace constants (AMP)" -description: "Learn more about: Concurrency namespace constants (AMP)" -ms.date: 11/04/2016 -f1_keywords: ["amp/Concurrency::HLSL_MAX_NUM_BUFFERS", "amp/Concurrency::MODULENAME_MAX_LENGTH"] ---- -# Concurrency namespace constants (AMP) - -The following constants are defined in the `Concurrency` namespace (AMP): - -## `HLSL_MAX_NUM_BUFFERS` Constant - -The maximum number of buffers allowed by DirectX. - -```cpp -static const UINT HLSL_MAX_NUM_BUFFERS = 64 + 128; -``` - -## `MODULENAME_MAX_LENGTH` constant - -Stores the maximum length of the module name. This value must be the same at compile time and runtime. - -```cpp -static const UINT MODULENAME_MAX_LENGTH = 1024; -``` - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/concurrency-namespace-cpp-amp.md b/docs/parallel/amp/reference/concurrency-namespace-cpp-amp.md deleted file mode 100644 index df6d09b52f2..00000000000 --- a/docs/parallel/amp/reference/concurrency-namespace-cpp-amp.md +++ /dev/null @@ -1,109 +0,0 @@ ---- -description: "Learn more about: Concurrency Namespace (C++ AMP)" -title: "Concurrency Namespace (C++ AMP)" -ms.date: "11/04/2016" -f1_keywords: ["AMP/Concurrency"] -helpviewer_keywords: ["Concurrency namespace"] -ms.assetid: b5aab265-3bac-42c5-8ead-f92ce05ef267 ---- -# Concurrency Namespace (C++ AMP) - -Provides classes and functions that accelerate the execution of C++ code on data-parallel hardware. For more information, see [C++ AMP Overview](../cpp-amp-overview.md) - -## Syntax - -```cpp -namespace Concurrency; -``` - -## Members - -### Namespaces - -|Name|Description| -|----------|-----------------| -|[Concurrency::direct3d Namespace](concurrency-direct3d-namespace.md)|Provides functions that support D3D interoperability. Enables seamless use of D3D resources for compute in AMP code and the use of resources created in AMP in D3D code, without creating redundant intermediate copies. You can use C++ AMP to incrementally accelerate the compute-intensive sections of your DirectX applications and use the D3D API on data produced from AMP computations.| -|[Concurrency::fast_math Namespace](concurrency-fast-math-namespace.md)|Functions in the `fast_math` namespace are not C99-conformant. Only single-precision versions of each function are provided. These functions use the DirectX intrinsic functions, which are faster than the corresponding functions in the `precise_math` namespace and do not require extended double-precision support on the accelerator, but they are less accurate. There are two versions of each function for source-level compatibility with C99 code; both versions take and return single-precision values.| -|[Concurrency::graphics Namespace](concurrency-graphics-namespace.md)|Provides types and functions that are designed for graphics programming.| -|[Concurrency::precise_math Namespace](concurrency-precise-math-namespace.md)|Functions in the `precise_math` namespace are C99 conformant. Both single-precision and double-precision versions of each function are included. These functions—this includes the single-precision functions—require extended double-precision support on the accelerator.| - -### Classes - -|Name|Description| -|----------|-----------------| -|[accelerator Class](accelerator-class.md)|Represents an abstraction of a physical DP-optimized compute node.| -|[accelerator_view Class](accelerator-view-class.md)|Represents a virtual device abstraction on a C++ AMP data-parallel accelerator.| -|[accelerator_view_removed Class](accelerator-view-removed-class.md)|The exception that is thrown when an underlying DirectX call fails due to the Windows timeout-detection-and-recovery mechanism.| -|[array Class](array-class.md)|A data aggregate on an `accelerator_view` in the grid domain. It is a collection of variables, one for each element in a grid domain. Each variable holds a value that corresponds to some C++ type.| -|[array_view Class](array-view-class.md)|Represents a view into the data in an array\.| -|[completion_future Class](completion-future-class.md)|Represents a future that corresponds to a C++ AMP asynchronous operation.| -|[extent Class](extent-class.md)|Represents a vector of N integer values that specify the bounds of an N-dimensional space that has an origin of 0. The values in the coordinate vector are ordered from most significant to least significant. For example, in Cartesian 3-dimensional space, the extent vector (7,5,3) represents a space in which the z coordinate ranges from 0 to 7, the y coordinate ranges from 0 to 5, and the x coordinate ranges from 0 to 3.| -|[index Class](index-class.md)|Defines an N-dimensional index point.| -|[invalid_compute_domain Class](invalid-compute-domain-class.md)|The exception that's thrown when the runtime can't start a kernel by using the compute domain specified at the `parallel_for_each` call site.| -|[out_of_memory Class](out-of-memory-class.md)|The exception that is thrown when a method fails because of a lack of system or device memory.| -|[runtime_exception Class](runtime-exception-class.md)|The base type for exceptions in the C++ AMP library.| -|[tile_barrier Class](tile-barrier-class.md)|A capability class that is only creatable by the system and is passed to a tiled `parallel_for_each` lambda as part of the `tiled_index` parameter. It provides one method, `wait()`, whose purpose is to synchronize execution of threads that are running in the thread group (tile).| -|[tiled_extent Class](tiled-extent-class.md)|A `tiled_extent` object is an `extent` object of one to three dimensions that subdivides the extent space into one-dimensional, two-dimensional, or three-dimensional tiles.| -|[tiled_index Class](tiled-index-class.md)|Provides an index into a `tiled_grid` object. This class has properties to access element relative to the local tile origin and relative to the global origin.| -|[uninitialized_object Class](uninitialized-object-class.md)|The exception that is thrown when an uninitialized object is used.| -|[unsupported_feature Class](unsupported-feature-class.md)|The exception that is thrown when an unsupported feature is used.| - -### Enumerations - -|Name|Description| -|----------|-----------------| -|[access_type Enumeration](concurrency-namespace-enums-amp.md#access_type)|Specifies the data access type.| -|[queuing_mode Enumeration](concurrency-namespace-enums-amp.md#queuing_mode)|Specifies the queuing modes that are supported on the accelerator.| - -### Operators - -|Operator|Description| -|--------------|-----------------| -|[operator== Operator (C++ AMP)](concurrency-namespace-operators-amp.md#operator_eq_eq)|Determines whether the specified data structures are equal.| -|[operator!= Operator (C++ AMP)](concurrency-namespace-operators-amp.md#operator_neq)|Determines whether the specified data structures are unequal.| -|[operator+ Operator (C++ AMP)](concurrency-namespace-operators-amp.md#operator_add)|Computes the component-wise sum of the specified arguments.| -|[operator- Operator (C++ AMP)](concurrency-namespace-operators-amp.md#operator-)|Computes the component-wise difference between the specified arguments.| -|[operator* Operator (C++ AMP)](concurrency-namespace-operators-amp.md#operator_star)|Computes the component-wise product of the specified arguments.| -|[operator/ Operator (C++ AMP)](concurrency-namespace-operators-amp.md#operator_div)|Computes the component-wise quotient of the specified arguments.| -|[operator% Operator (C++ AMP)](concurrency-namespace-operators-amp.md#operator_mod)|Computes the modulus of the first specified argument by the second specified argument.| - -### Functions - -|Name|Description| -|----------|-----------------| -|[all_memory_fence](concurrency-namespace-functions-amp.md#all_memory_fence)|Blocks execution of all threads in a tile until all memory accesses have been completed.| -|[amp_uninitialize](concurrency-namespace-functions-amp.md#amp_uninitialize)|Uninitializes the C++ AMP runtime.| -|[atomic_compare_exchange](concurrency-namespace-functions-amp.md#atomic_compare_exchange)|Overloaded. If the value stored at the specified location compares equal to the first specified value, then the second specified value is stored in the same location as an atomic operation.| -|[atomic_exchange](concurrency-namespace-functions-amp.md#atomic_exchange)|Overloaded. Sets the value stored at the specified location to the specified value as an atomic operation.| -|[atomic_fetch_add](concurrency-namespace-functions-amp.md#atomic_fetch_add)|Overloaded. Sets the value stored at the specified location to the sum of that value and a specified value as an atomic operation.| -|[atomic_fetch_and](concurrency-namespace-functions-amp.md#atomic_fetch_and)|Overloaded. Sets the value stored at the specified location to the bitwise `and` of that value and a specified value as an atomic operation.| -|[atomic_fetch_dec](concurrency-namespace-functions-amp.md#atomic_fetch_dec)|Overloaded. Decrements the value stored at the specified location and stores the result in the same location as an atomic operation.| -|[atomic_fetch_inc](concurrency-namespace-functions-amp.md#atomic_fetch_inc)|Overloaded. Increments the value stored at the specified location and stores the result in the same location as an atomic operation.| -|[atomic_fetch_max](concurrency-namespace-functions-amp.md#atomic_fetch_max)|Overloaded. Sets the value stored at the specified location to the larger of that value and a specified value as an atomic operation.| -|[atomic_fetch_min](concurrency-namespace-functions-amp.md#atomic_fetch_min)|Overloaded. Sets the value stored at the specified location to the smaller of that value and a specified value as an atomic operation.| -|[atomic_fetch_or](concurrency-namespace-functions-amp.md#atomic_fetch_or)|Overloaded. Sets the value stored at the specified location to the bitwise `or` of that value and a specified value as an atomic operation.| -|[atomic_fetch_sub](concurrency-namespace-functions-amp.md#atomic_fetch_sub)|Overloaded. Sets the value stored at the specified location to the difference of that value and a specified value as an atomic operation.| -|[atomic_fetch_xor](concurrency-namespace-functions-amp.md#atomic_fetch_xor)|Overloaded. Sets the value stored at the specified location to the bitwise `xor` of that value and a specified value as an atomic operation.| -|[copy](concurrency-namespace-functions-amp.md#copy)|Copies a C++ AMP object. All synchronous data transfer requirements are met. Data can't be copied when code is running code on an accelerator. The general form of this function is `copy(src, dest)`.| -|[copy_async](concurrency-namespace-functions-amp.md#copy_async)|Copies a C++ AMP object and returns [completion_future](completion-future-class.md) that can be waited on. Data can't be copied when code is running on an accelerator. The general form of this function is `copy(src, dest)`.| -|[direct3d_abort](concurrency-namespace-functions-amp.md#direct3d_abort)|Aborts the execution of a function that has the `restrict(amp)` restriction clause.| -|[direct3d_errorf](concurrency-namespace-functions-amp.md#direct3d_errorf)|Prints a formatted string to the Visual Studio **Output** window and raises a [runtime_exception](runtime-exception-class.md) exception that has the same formatting string.| -|[direct3d_printf](concurrency-namespace-functions-amp.md#direct3d_printf)|Prints a formatted string to the Visual Studio **Output** window. It is called from a function that has the `restrict(amp)` restriction clause.| -|[global_memory_fence](concurrency-namespace-functions-amp.md#global_memory_fence)|Blocks execution of all threads in a tile until all global memory accesses have been completed.| -|[parallel_for_each Function (C++ AMP)](concurrency-namespace-functions-amp.md#parallel_for_each)|Runs a function across the compute domain.| -|[tile_static_memory_fence](concurrency-namespace-functions-amp.md#tile_static_memory_fence)|Blocks execution of all threads in a tile until `tile_static` memory accesses have been completed.| - -## Constants - -|Name|Description| -|----------|-----------------| -|[HLSL_MAX_NUM_BUFFERS Constant](concurrency-namespace-constants-amp.md#hlsl_max_num_buffers)|The maximum number of buffers allowed by DirectX.| -|[MODULENAME_MAX_LENGTH Constant](concurrency-namespace-constants-amp.md#modulename_max_length)|Stores the maximum length of the module name. This value must be the same on the compiler and the runtime.| - -## Requirements - -**Header:** amp.h - -## See also - -[Reference (C++ AMP)](reference-cpp-amp.md) diff --git a/docs/parallel/amp/reference/concurrency-namespace-enums-amp.md b/docs/parallel/amp/reference/concurrency-namespace-enums-amp.md deleted file mode 100644 index feef3abec33..00000000000 --- a/docs/parallel/amp/reference/concurrency-namespace-enums-amp.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: "Concurrency namespace enums (AMP)" -description: "Learn more about: Concurrency namespace enums (AMP)" -ms.date: 11/04/2016 -f1_keywords: ["amp/Concurrency::access_type", "amp/Concurrency::queuing_mode"] ---- -# `Concurrency` namespace enums (AMP) - -The following enumerations are available in the `Concurrency` namespace: - -## `access_type` enumeration - -```cpp -enum access_type; -``` - -### Values - -|Name|Description| -|----------|-----------------| -|`access_type_auto`|Automatically choose the best `access_type` for the accelerator.| -|`access_type_none`|Dedicated. The allocation is only accessible on the accelerator and not on the CPU.| -|`access_type_read`|Shared. The allocation is accessible on the accelerator and is readable on the CPU.| -|`access_type_read_write`|Shared. The allocation is accessible on the accelerator and is writable on the CPU.| -|`access_type_write`|Shared. The allocation is accessible on the accelerator and is both readable and writable on the CPU.| - -## `queuing_mode` enumeration - -Specifies the queuing modes that are supported on the accelerator. - -```cpp -enum queuing_mode; -``` - -### Values - -|Name|Description| -|----------|-----------------| -|`queuing_mode_immediate`|A queuing mode that specifies that any commands, for example, [parallel_for_each Function (C++ AMP)](concurrency-namespace-functions-amp.md#parallel_for_each), are sent to the corresponding accelerator device as soon as they return to the caller.| -|`queuing_mode_automatic`|A queuing mode that specifies that commands be queued up on a command queue that corresponds to the [accelerator_view](accelerator-view-class.md) object. Commands are sent to the device when [accelerator_view::flush](accelerator-view-class.md#flush) is called.| - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md b/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md deleted file mode 100644 index ebc67e6ab11..00000000000 --- a/docs/parallel/amp/reference/concurrency-namespace-functions-amp.md +++ /dev/null @@ -1,655 +0,0 @@ ---- -title: "Concurrency namespace functions (AMP)" -description: "Learn more about: Concurrency namespace functions (AMP)" -ms.date: 11/04/2016 -f1_keywords: ["amp/Concurrency::all_memory_fence", "amp/Concurrency::atomic_compare_exchange", "amp/Concurrency::atomic_fetch_dec", "amp/Concurrency::atomic_fetch_max", "amp/Concurrency::atomic_fetch_min", "amp/Concurrency::copy", "amp/Concurrency::direct3d_abort", "amp/Concurrency::direct3d_printf", "amp/Concurrency::global_memory_fence", "amp/Concurrency::tile_static_memory_fence"] ---- -# Concurrency namespace functions (AMP) - -The following functions are defined in the `Concurrency` namespace (AMP): - -## all_memory_fence - -Blocks execution of all threads in a tile until all memory accesses have been completed. This ensures that all memory accesses are visible to other threads in the thread tile, and are executed in program order. - -```cpp -inline void all_memory_fence(const tile_barrier& _Barrier) restrict(amp); -``` - -### Parameters - -*_Barrier*
-A `tile_barrier` object. - -## amp_uninitialize - -Uninitializes the C++ AMP runtime. It is legal to call this function multiple times during an applications lifetime. Calling any C++ AMP API after calling this function will reinitialize the C++ AMP runtime. Note that it is illegal to use C++ AMP objects across calls to this function and doing so will result in undefined behavior. Also, concurrently calling this function and any other AMP APIs is illegal and would result in undefined behavior. - -```cpp -void __cdecl amp_uninitialize(); -``` - -## atomic_compare_exchange - -Atomically compares the value stored at a memory location specified in the first argument for equality with the value of the second specified argument, and if the values are the same, the value at the memory location is changed to that of the third specified argument. - -```cpp -inline bool atomic_compare_exchange( - _Inout_ int* _Dest, - _Inout_ int* _Expected_value, - int value - ) restrict(amp) - -inline bool atomic_compare_exchange( - _Inout_ unsigned int* _Dest, - _Inout_ unsigned int* _Expected_value, - unsigned int value - ) restrict(amp) -``` - -### Parameters - -*_Dest*
-The location from which one of the values to be compared is read, and to which the new value, if any, is to be stored. - -*_Expected_value*
-The location from which the second value to be compared is read. - -*value*
-The value to be stored to the memory location specified in by `_Dest` if `_Dest` is equal to `_Expected_value`. - -### Return Value - -**`true`** if the operation is successful; otherwise, **`false`**. - -## atomic_exchange Function (C++ AMP) - -Sets the value of destination location as an atomic operation. - -```cpp -inline int atomic_exchange( - _Inout_ int* _Dest, - int value - ) restrict(amp) - -inline unsigned int atomic_exchange( - _Inout_ unsigned int* _Dest, - unsigned int value - ) restrict(amp) - -inline float atomic_exchange( - _Inout_ float* _Dest, - float value - ) restrict(amp) -``` - -### Parameters - -*_Dest*
-Pointer to the destination location. - -*value*
-The new value. - -### Return Value - -The original value of the destination location. - -## atomic_fetch_add Function (C++ AMP) - -Atomically add a value to the value of a memory location. - -```cpp -inline int atomic_fetch_add( - _Inout_ int* _Dest, - int value - ) restrict(amp) - -inline unsigned int atomic_fetch_add( - _Inout_ unsigned int* _Dest, - unsigned int value - ) restrict(amp) -``` - -### Parameters - -*_Dest*
-Pointer to the memory location. - -*value*
-The value to be added. - -### Return Value - -The original value of the memory location. - -## atomic_fetch_and Function (C++ AMP) - -Atomically performs a bitwise AND operation of a value and the value of a memory location. - -```cpp -inline int atomic_fetch_and( - _Inout_ int* _Dest, - int value - ) restrict(amp) - -inline unsigned int atomic_fetch_and( - _Inout_ unsigned int* _Dest, - unsigned int value - ) restrict(amp) -``` - -### Parameters - -*_Dest*
-Pointer to the memory location. - -*value*
-The value to use in the bitwise AND calculation. - -### Return Value - -The original value of the memory location. - -## atomic_fetch_dec - -Atomically decrements the value stored at the specified memory location. - -```cpp -inline int atomic_fetch_dec(_Inout_ int* _Dest - ) restrict(amp) - -inline unsigned int atomic_fetch_dec(_Inout_ unsigned int* _Dest) restrict(amp); -``` - -### Parameters - -*_Dest*
-The location in memory of the value to be decremented. - -### Return Value - -The original value stored at the memory location. - -## atomic_fetch_inc - -Atomically increments the value stored at the specified memory location. - -```cpp -inline int atomic_fetch_inc(_Inout_ int* _Dest) restrict(amp); - -inline unsigned int atomic_fetch_inc(_Inout_ unsigned int* _Dest) restrict(amp); -``` - -### Parameters - -*_Dest*
-The location in memory of the value to be incremented. - -### Return Value - -The original value stored at the memory location. - -## atomic_fetch_max - -Atomically computes the maximum value between the value stored at the memory location specified in the first argument and the value specified in the second argument, and stores it at the same memory location. - -```cpp -inline int atomic_fetch_max( - _Inout_ int* _Dest, - int value - ) restrict(amp) - -inline unsigned int atomic_fetch_max( - _Inout_ unsigned int* _Dest, - unsigned int value - ) restrict(amp) -``` - -### Parameters - -*_Dest*
-The location from which one of the values to be compared is read, and to which the maximum of the two values is to be stored. - -*value*
-The value to be compared to the value at the specified location. - -### Return Value - -The original value stored at the specified location location. - -## atomic_fetch_min - -Atomically computes the minimum value between the value stored at the memory location specified in the first argument and the value specified in the second argument, and stores it at the same memory location. - -```cpp -inline int atomic_fetch_min( - _Inout_ int* _Dest, - int value - ) restrict(amp) - -inline unsigned int atomic_fetch_min( - _Inout_ unsigned int* _Dest, - unsigned int value - ) restrict(amp) -``` - -### Parameters - -*_Dest*
-The location from which one of the values to be compared is read, and to which the minimum of the two values is to be stored. - -*value*
-The value to be compared to the value at the specified location. - -### Return Value - -The original value stored at the specified location location. - -## atomic_fetch_or Function (C++ AMP) - -Atomically performs a bitwise OR operation with a value and the value of a memory location. - -```cpp -inline int atomic_fetch_or( - _Inout_ int* _Dest, - int value - ) restrict(amp) - -inline unsigned int atomic_fetch_or( - _Inout_ unsigned int* _Dest, - unsigned int value - ) restrict(amp) -``` - -### Parameters - -*_Dest*
-Pointer to the memory location. - -*value*
-The value to use in the bitwise OR calculation. - -### Return Value - -The original value of the memory location. - -## atomic_fetch_sub Function (C++ AMP) - -Atomically subtracts a value from a memory location. - -```cpp -inline int atomic_fetch_sub( - _Inout_ int* _Dest, - int value - ) restrict(amp) - -inline unsigned int atomic_fetch_sub( - _Inout_ unsigned int* _Dest, - unsigned int value - ) restrict(amp) -``` - -### Parameters - -*_Dest*
-Pointer to the destination location. - -*value*
-The value to be subtracted. - -### Return Value - -The original value of the memory location. - -## atomic_fetch_xor Function (C++ AMP) - -Atomically performs an bitwise XOR operation of a value and a memory location. - -```cpp -inline int atomic_fetch_xor( - _Inout_ int* _Dest, - int value - ) restrict(amp) - -inline unsigned int atomic_fetch_xor( - _Inout_ unsigned int* _Dest, - unsigned int value - ) restrict(amp) -``` - -### Parameters - -*_Dest*
-Pointer to the memory location. - -*value*
-The value to use in the XOR calculation. - -### Return Value - -The original value of the memory location. - -## copy - -Copies a C++ AMP object. All synchronous data transfer requirements are met. You can't copy data when running code on an accelerator. The general form of this function is `copy(src, dest)`. - -```cpp -template -void copy( - const array& _Src, - array& _Dest); - -template -void copy( - InputIterator _SrcFirst, - InputIterator _SrcLast, - array& _Dest); - -template -void copy( - InputIterator _SrcFirst, - array& _Dest); - -template -void copy( - const array& _Src, - OutputIterator _DestIter); - -template -void copy( - const array& _Src, - array_view& _Dest); - -template -void copy( - const array_view& _Src, - array& _Dest); - -template -void copy( - const array_view& _Src, - array& _Dest); - -template -void copy( - const array_view& _Src, - array_view& _Dest); - -template -void copy( - const array_view& _Src, - array_view& _Dest); - -template -void copy( - InputIterator _SrcFirst, - InputIterator _SrcLast, - array_view& _Dest); - -template -void copy( - InputIterator _SrcFirst, - array_view& _Dest); - -template -void copy( - const array_view& _Src, - OutputIterator _DestIter); -``` - -### Parameters - -*_Dest*
-The object to copy to. - -*_DestIter*
-An output iterator to the beginning position at destination. - -*InputIterator*
-The type of the input iterator. - -*OutputIterator*
-The type of the output iterator. - -*_Rank*
-The rank of the object to copy from or the object to copy to. - -*_Src*
-To object to copy. - -*_SrcFirst*
-A beginning iterator into the source container. - -*_SrcLast*
-An ending iterator into the source container. - -*value_type*
-The data type of the elements that are copied. - -## copy_async - -Copies a C++ AMP object and returns a [completion_future](completion-future-class.md) object that can be waited on. You can't copy data when running code on an accelerator. The general form of this function is `copy(src, dest)`. - -```cpp -template -concurrency::completion_future copy_async( - const array& _Src, - array& _Dest); - -template -concurrency::completion_future copy_async(InputIterator _SrcFirst, InputIterator _SrcLast, - array& _Dest); - -template -concurrency::completion_future copy_async(InputIterator _SrcFirst, - array& _Dest); - -template -concurrency::completion_future copy_async( - const array& _Src, OutputIterator _DestIter); - -template -concurrency::completion_future copy_async( - const array& _Src, - array_view& _Dest); - -template -concurrency::completion_future copy_async( - const array_view& _Src, - array& _Dest); - -template -concurrency::completion_future copy_async( - const array_view& _Src, - array& _Dest); - -template -concurrency::completion_future copy_async( - const array_view& _Src, - array_view& _Dest); - -template -concurrency::completion_future copy_async( - const array_view& _Src, - array_view& _Dest); - -template -concurrency::completion_future copy_async(InputIterator _SrcFirst, InputIterator _SrcLast, - array_view& _Dest); - -template -concurrency::completion_future copy_async(InputIterator _SrcFirst, - array_view& _Dest); - -template -concurrency::completion_future copy_async( - const array_view& _Src, OutputIterator _DestIter); -``` - -### Parameters - -*_Dest*
-The object to copy to. - -*_DestIter*
-An output iterator to the beginning position at destination. - -*InputIterator*
-The type of the input iterator. - -*OutputIterator*
-The type of the output iterator. - -*_Rank*
-The rank of the object to copy from or the object to copy to. - -*_Src*
-To object to copy. - -*_SrcFirst*
-A beginning iterator into the source container. - -*_SrcLast*
-An ending iterator into the source container. - -*value_type*
-The data type of the elements that are copied. - -### Return Value - -A `future` that can be waited on. - -## direct3d_abort - -Aborts the execution of a function with the `restrict(amp)` restriction clause. When the AMP runtime detects the call, it raises a [runtime_exception](runtime-exception-class.md) exception with the error message "Reference Rasterizer: Shader abort instruction hit". - -```cpp -void direct3d_abort() restrict(amp); -``` - -## direct3d_errorf - -Prints a formatted string to the Visual Studio output window. It is called from a function with the `restrict(amp)` restriction clause. When the AMP runtime detects the call, it raises a [runtime_exception](runtime-exception-class.md) exception with the same formatting string. - -```cpp -void direct3d_errorf( - const char *, -...) restrict(amp); -``` - -## direct3d_printf - -Prints a formatted string to the Visual Studio output window. It is called from a function with the `restrict(amp)` restriction clause. - -```cpp -void direct3d_printf( - const char *, -...) restrict(amp); -``` - -## global_memory_fence - -Blocks execution of all threads in a tile until all global memory accesses have been completed. This ensures that global memory accesses are visible to other threads in the thread tile, and are executed in program order. - -```cpp -inline void global_memory_fence(const tile_barrier& _Barrier) restrict(amp); -``` - -### Parameters - -*_Barrier*
-A tile_barrier object - -## parallel_for_each Function (C++ AMP) - -Runs a function across the compute domain. For more information, see [C++ AMP Overview](../../../parallel/amp/cpp-amp-overview.md). - -```cpp -template -void parallel_for_each( - const extent<_Rank>& _Compute_domain, - const _Kernel_type& _Kernel); - -template -void parallel_for_each( - const tiled_extent<_Dim0, _Dim1, _Dim2>& _Compute_domain, - const _Kernel_type& _Kernel); - -template -void parallel_for_each( - const tiled_extent<_Dim0, _Dim1>& _Compute_domain, - const _Kernel_type& _Kernel); - -template -void parallel_for_each( - const tiled_extent<_Dim0>& _Compute_domain, - const _Kernel_type& _Kernel); - -template -void parallel_for_each( - const accelerator_view& _Accl_view, - const extent<_Rank>& _Compute_domain, - const _Kernel_type& _Kernel); - -template -void parallel_for_each( - const accelerator_view& _Accl_view, - const tiled_extent<_Dim0, _Dim1, _Dim2>& _Compute_domain, - const _Kernel_type& _Kernel); - -template -void parallel_for_each( - const accelerator_view& _Accl_view, - const tiled_extent<_Dim0, _Dim1>& _Compute_domain, - const _Kernel_type& _Kernel); - -template -void parallel_for_each( - const accelerator_view& _Accl_view, - const tiled_extent<_Dim0>& _Compute_domain, - const _Kernel_type& _Kernel); -``` - -### Parameters - -*_Accl_view*
-The `accelerator_view` object to run the parallel computation on. - -*_Compute_domain*
-An `extent` object that contains the data for the computation. - -*_Dim0*
-The dimension of the `tiled_extent` object. - -*_Dim1*
-The dimension of the `tiled_extent` object. - -*_Dim2*
-The dimension of the `tiled_extent` object. - -*_Kernel*
-A lambda or function object that takes an argument of type "index\<_Rank>" and performs the parallel computation. - -*_Kernel_type*
-A lambda or functor. - -*_Rank*
-The rank of the extent. - -## tile_static_memory_fence - -Blocks execution of all threads in a tile until all outstanding `tile_static` memory accesses have been completed. This ensures that `tile_static` memory accesses are visible to other threads in the thread tile, and that accesses are executed in program order. - -```cpp -inline void tile_static_memory_fence(const tile_barrier& _Barrier) restrict(amp); -``` - -### Parameters - -*_Barrier*
-A tile_barrier object. - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md b/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md deleted file mode 100644 index fff2ed01733..00000000000 --- a/docs/parallel/amp/reference/concurrency-namespace-operators-amp.md +++ /dev/null @@ -1,271 +0,0 @@ ---- -title: "Concurrency namespace operators (AMP)" -description: "Learn more about: Concurrency namespace operators (AMP)" -ms.date: 11/04/2016 ---- -# Concurrency namespace operators (AMP) - -The following operators are defined in the `Concurrency` namespace (AMP): - -## operator== - -Determines whether the specified arguments are equal. - -```cpp -template < - int _Rank, - template class _Tuple_type -> -bool operator== ( - const _Tuple_type<_Rank>& _Lhs, - const _Tuple_type<_Rank>& _Rhs) restrict(amp); -``` - -### Parameters - -*_Rank*
-The rank of the tuple arguments. - -*_Lhs*
-One of the tuples to compare. - -*_Rhs*
-One of the tuples to compare. - -### Return Value - -**`true`** if the tuples are equal; otherwise, **`false`**. - -## operator!= - -Determines whether the specified arguments are not equal. - -```cpp -template < - int _Rank, - template class _Tuple_type -> -bool operator!= ( - const _Tuple_type<_Rank>& _Lhs, - const _Tuple_type<_Rank>& _Rhs) restrict(amp); -``` - -### Parameters - -*_Rank*
-The rank of the tuple arguments. - -*_Lhs*
-One of the tuples to compare. - -*_Rhs*
-One of the tuples to compare. - -### Return Value - -**`true`** if the tuples are not equal; otherwise, **`false`**. - -## operator+ - -Computes the component-wise sum of the specified arguments. - -```cpp -template < - int _Rank, - template class _Tuple_type -> -class _Tuple_type> _Tuple_type<_Rank> operator+( - const _Tuple_type<_Rank>& _Lhs, - const _Tuple_type<_Rank>& _Rhs) restrict(amp,cpu); - -template < - int _Rank, - template class _Tuple_type -> -class _Tuple_type> _Tuple_type<_Rank> operator+( - const _Tuple_type<_Rank>& _Lhs, - typename _Tuple_type<_Rank>::value_type _Rhs) restrict(amp,cpu); - -template < - int _Rank, - template class _Tuple_type -> -class _Tuple_type> _Tuple_type<_Rank> operator+( - typename _Tuple_type<_Rank>::value_type _Lhs, - const _Tuple_type<_Rank>& _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rank*
-The rank of the tuple arguments. - -*_Lhs*
-One of the arguments to add. - -*_Rhs*
-One of the arguments to add. - -### Return Value - -The component-wise sum of the specified arguments. - -## operator- - -Computes the component-wise difference between the specified arguments. - -```cpp -template < - int _Rank, - template class _Tuple_type -> -_Tuple_type<_Rank> operator-( - const _Tuple_type<_Rank>& _Lhs, - const _Tuple_type<_Rank>& _Rhs) restrict(amp,cpu); - -template < - int _Rank, - template class _Tuple_type -> -_Tuple_type<_Rank> operator-( - const _Tuple_type<_Rank>& _Lhs, - typename _Tuple_type<_Rank>::value_type _Rhs) restrict(amp,cpu); - -template < - int _Rank, - template class _Tuple_type -> -_Tuple_type<_Rank> operator-( - typename _Tuple_type<_Rank>::value_type _Lhs, - const _Tuple_type<_Rank>& _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rank*
-The rank of the tuple arguments. - -*_Lhs*
-The argument to be subtracted from. - -*_Rhs*
-The argument to subtract. - -### Return Value - -The component-wise difference between the specified arguments. - -## operator* - -Computes the component-wise product of the specified arguments. - -```cpp -template < - int _Rank, - template class _Tuple_type -> -_Tuple_type<_Rank> operator*( - const _Tuple_type<_Rank>& _Lhs, - typename _Tuple_type<_Rank>::value_type _Rhs) restrict(amp,cpu); - -template < - int _Rank, - template class _Tuple_type -> -_Tuple_type<_Rank> operator*( - typename _Tuple_type<_Rank>::value_type _Lhs, - const _Tuple_type<_Rank>& _Rhs) restrict(amp, cpu); -``` - -### Parameters - -*_Rank*
-The rank of the tuple arguments. - -*_Lhs*
-One of the tuples to multiply. - -*_Rhs*
-One of the tuples to multiply. - -### Return Value - -The component-wise product of the specified arguments. - -## operator/ - -Computes the component-wise quotient of the specified arguments. - -```cpp -template < - int _Rank, - template class _Tuple_type -> -_Tuple_type<_Rank> operator/( - const _Tuple_type<_Rank>& _Lhs, - typename _Tuple_type<_Rank>::value_type _Rhs) restrict(amp,cpu); - -template < - int _Rank, - template class _Tuple_type -> -_Tuple_type<_Rank> operator/( - typename _Tuple_type<_Rank>::value_type _Lhs, - const _Tuple_type<_Rank>& _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rank*
-The rank of the tuple arguments. - -*_Lhs*
-The tuple to be divided. - -*_Rhs*
-The tuple to divide by. - -### Return Value - -The component-wise quotient of the specified arguments. - -## operator% - -Computes the modulus of the first specified argument by the second specified argument. - -```cpp -template < - int _Rank, - template class _Tuple_type -> -_Tuple_type<_Rank> operator%( - const _Tuple_type<_Rank>& _Lhs, - typename _Tuple_type<_Rank>::value_type _Rhs) restrict(amp,cpu); - -template < - int _Rank, - template class _Tuple_type -> -_Tuple_type<_Rank> operator%( - typename _Tuple_type<_Rank>::value_type _Lhs, - const _Tuple_type<_Rank>& _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rank*
-The rank of the tuple arguments. - -*_Lhs*
-The tuple from which the modulo is calculated. - -*_Rhs*
-The tuple to modulo by. - -### Return Value - -The result of the first specified argument modulus the second specified argument. - -## See also - -[Concurrency Namespace](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md deleted file mode 100644 index 4c85696fdd1..00000000000 --- a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md +++ /dev/null @@ -1,2622 +0,0 @@ ---- -title: "Concurrency::precise_math namespace functions" -description: "Learn more about: Concurrency::precise_math namespace functions" -ms.date: 11/04/2016 -f1_keywords: ["amp_math/Concurrency::precise_math::acos", "amp_math/Concurrency::precise_math::acosh", "amp_math/Concurrency::precise_math::acoshf", "amp_math/Concurrency::precise_math::asinf", "amp_math/Concurrency::precise_math::asinh", "amp_math/Concurrency::precise_math::atan", "amp_math/Concurrency::precise_math::atan2", "amp_math/Concurrency::precise_math::atanf", "amp_math/Concurrency::precise_math::atanh", "amp_math/Concurrency::precise_math::cbrt", "amp_math/Concurrency::precise_math::cbrtf", "amp_math/Concurrency::precise_math::ceilf", "amp_math/Concurrency::precise_math::copysign", "amp_math/Concurrency::precise_math::cos", "amp_math/Concurrency::precise_math::cosf", "amp_math/Concurrency::precise_math::coshf", "amp_math/Concurrency::precise_math::cospi", "amp_math/Concurrency::precise_math::erf", "amp_math/Concurrency::precise_math::erfc", "amp_math/Concurrency::precise_math::erfcinv", "amp_math/Concurrency::precise_math::erfcinvf", "amp_math/Concurrency::precise_math::erfinv", "amp_math/Concurrency::precise_math::erfinvf", "amp_math/Concurrency::precise_math::exp10", "amp_math/Concurrency::precise_math::exp10f", "amp_math/Concurrency::precise_math::exp2f", "amp_math/Concurrency::precise_math::expf", "amp_math/Concurrency::precise_math::expm1f", "amp_math/Concurrency::precise_math::fabs", "amp_math/Concurrency::precise_math::floor", "amp_math/Concurrency::precise_math::fdim", "amp_math/Concurrency::precise_math::floorf", "amp_math/Concurrency::precise_math::fmaf", "amp_math/Concurrency::precise_math::fmaxf", "amp_math/Concurrency::precise_math::fmin", "amp_math/Concurrency::precise_math::fmod", "amp_math/Concurrency::precise_math::fmodf", "amp_math/Concurrency::precise_math::frexp", "amp_math/Concurrency::precise_math::frexpf", "amp_math/Concurrency::precise_math::hypotf", "amp_math/Concurrency::precise_math::ilogb", "amp_math/Concurrency::precise_math::isfinite", "amp_math/Concurrency::precise_math::isinf", "amp_math/Concurrency::precise_math::isnormal", "amp_math/Concurrency::precise_math::ldexp", "amp_math/Concurrency::precise_math::lgamma", "amp_math/Concurrency::precise_math::lgammaf", "amp_math/Concurrency::precise_math::log10", "amp_math/Concurrency::precise_math::log10f", "amp_math/Concurrency::precise_math::log1pf", "amp_math/Concurrency::precise_math::log2", "amp_math/Concurrency::precise_math::logb", "amp_math/Concurrency::precise_math::logbf", "amp_math/Concurrency::precise_math::modf", "amp_math/Concurrency::precise_math::modff", "amp_math/Concurrency::precise_math::nanf", "amp_math/Concurrency::precise_math::nearbyint", "amp_math/Concurrency::precise_math::nextafter", "amp_math/Concurrency::precise_math::nextafterf", "amp_math/Concurrency::precise_math::phif", "amp_math/Concurrency::precise_math::pow", "amp_math/Concurrency::precise_math::probit", "amp_math/Concurrency::precise_math::probitf", "amp_math/Concurrency::precise_math::rcbrtf", "amp_math/Concurrency::precise_math::remainder", "amp_math/Concurrency::precise_math::remquo", "amp_math/Concurrency::precise_math::remquof", "amp_math/Concurrency::precise_math::roundf", "amp_math/Concurrency::precise_math::rsqrt", "amp_math/Concurrency::precise_math::scalb", "amp_math/Concurrency::precise_math::scalbf", "amp_math/Concurrency::precise_math::scalbnf", "amp_math/Concurrency::precise_math::signbit", "amp_math/Concurrency::precise_math::sin", "amp_math/Concurrency::precise_math::sincos", "amp_math/Concurrency::precise_math::sinf", "amp_math/Concurrency::precise_math::sinh", "amp_math/Concurrency::precise_math::sinpi", "amp_math/Concurrency::precise_math::sinpif", "amp_math/Concurrency::precise_math::sqrtf", "amp_math/Concurrency::precise_math::tan", "amp_math/Concurrency::precise_math::tanh", "amp_math/Concurrency::precise_math::tanhf", "amp_math/Concurrency::precise_math::tanpif", "amp_math/Concurrency::precise_math::tgamma", "amp_math/Concurrency::precise_math::trunc", "amp_math/Concurrency::precise_math::truncf"] ---- -# Concurrency::precise_math namespace functions - -The following functions are available in the `Concurrency::precise_math` namespace: - -## acos - -Calculates the arccosine of the argument - -```cpp -inline float acos(float _X) restrict(amp); - -inline double acos(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arccosine value of the argument - -## acosf - -Calculates the arccosine of the argument - -```cpp -inline float acosf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arccosine value of the argument - -## acosh - -Calculates the inverse hyperbolic cosine of the argument - -```cpp -inline float acosh(float _X) restrict(amp); - -inline double acosh(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse hyperbolic cosine value of the argument - -## acoshf - -Calculates the inverse hyperbolic cosine of the argument - -```cpp -inline float acoshf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse hyperbolic cosine value of the argument - -## asin - -Calculates the arcsine of the argument - -```cpp -inline float asin(float _X) restrict(amp); - -inline double asin(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arcsine value of the argument - -## asinf - -Calculates the arcsine of the argument - -```cpp -inline float asinf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arcsine value of the argument - -## asinh - -Calculates the inverse hyperbolic sine of the argument - -```cpp -inline float asinh(float _X) restrict(amp); - -inline double asinh(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse hyperbolic sine value of the argument - -## asinhf - -Calculates the inverse hyperbolic sine of the argument - -```cpp -inline float asinhf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse hyperbolic sine value of the argument - -## atan - -Calculates the arctangent of the argument - -```cpp -inline float atan(float _X) restrict(amp); - -inline double atan(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arctangent value of the argument - -## atan2 - -Calculates the arctangent of _Y/_X - -```cpp -inline float atan2( - float _Y, - float _X) restrict(amp); - -inline double atan2( - double _Y, - double _X) restrict(amp); -``` - -### Parameters - -*_Y*
-Floating-point value - -*_X*
-Floating-point value - -### Return Value - -Returns the arctangent value of _Y/_X - -## atan2f - -Calculates the arctangent of _Y/_X - -```cpp -inline float atan2f( - float _Y, - float _X) restrict(amp); -``` - -### Parameters - -*_Y*
-Floating-point value - -*_X*
-Floating-point value - -### Return Value - -Returns the arctangent value of _Y/_X - -## atanf - -Calculates the arctangent of the argument - -```cpp -inline float atanf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the arctangent value of the argument - -## atanh - -Calculates the inverse hyperbolic tangent of the argument - -```cpp -inline float atanh(float _X) restrict(amp); - -inline double atanh(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse hyperbolic tangent value of the argument - -## atanhf - -Calculates the inverse hyperbolic tangent of the argument - -```cpp -inline float atanhf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse hyperbolic tangent value of the argument - -## cbrt - -Computes the real cube root of the argument - -```cpp -inline float cbrt(float _X) restrict(amp); - -inline double cbrt(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the real cube root of the argument - -## cbrtf - -Computes the real cube root of the argument - -```cpp -inline float cbrtf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the real cube root of the argument - -## ceil - -Calculates the ceiling of the argument - -```cpp -inline float ceil(float _X) restrict(amp); - -inline double ceil(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the ceiling of the argument - -## ceilf - -Calculates the ceiling of the argument - -```cpp -inline float ceilf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the ceiling of the argument - -## copysign - -Produces a value with the magnitude of _X and the sign of _Y - -```cpp -inline float copysign( - float _X, - float _Y) restrict(amp); - -inline double copysign( - double _X, - double _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns a value with the magnitude of _X and the sign of _Y - -## copysignf - -Produces a value with the magnitude of _X and the sign of _Y - -```cpp -inline float copysignf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns a value with the magnitude of _X and the sign of _Y - -## cos - -Calculates the cosine of the argument - -```cpp -inline float cos(float _X) restrict(amp); - -inline double cos(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the cosine value of the argument - -## cosf - -Calculates the cosine of the argument - -```cpp -inline float cosf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the cosine value of the argument - -## cosh - -Calculates the hyperbolic cosine value of the argument - -```cpp -inline float cosh(float _X) restrict(amp); - -inline double cosh(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic cosine value of the argument - -## coshf - -Calculates the hyperbolic cosine value of the argument - -```cpp -inline float coshf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic cosine value of the argument - -## cospi - -Calculates the cosine value of pi \* _X - -```cpp -inline float cospi(float _X) restrict(amp); - -inline double cospi(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the cosine value of pi \* _X - -## cospif - -Calculates the cosine value of pi \* _X - -```cpp -inline float cospif(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the cosine value of pi \* _X - -## erf - -Computes the error function of _X - -```cpp -inline float erf(float _X) restrict(amp); - -inline double erf(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the error function of _X - -## erfc - -Computes the complementary error function of _X - -```cpp -inline float erfc(float _X) restrict(amp); - -inline double erfc(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the complementary error function of _X - -## erfcf - -Computes the complementary error function of _X - -```cpp -inline float erfcf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the complementary error function of _X - -## erfcinv - -Computes the inverse complementary error function of _X - -```cpp -inline float erfcinv(float _X) restrict(amp); - -inline double erfcinv(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse complementary error function of _X - -## erfcinvf - -Computes the inverse complementary error function of _X - -```cpp -inline float erfcinvf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse complementary error function of _X - -## erff - -Computes the error function of _X - -```cpp -inline float erff(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the error function of _X - -## erfinv - -Computes the inverse error function of _X - -```cpp -inline float erfinv(float _X) restrict(amp); - -inline double erfinv(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse error function of _X - -## erfinvf - -Computes the inverse error function of _X - -```cpp -inline float erfinvf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse error function of _X - -## exp10 - -Calculates the base-10 exponential of the argument - -```cpp -inline float exp10(float _X) restrict(amp); - -inline double exp10(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-10 exponential of the argument - -## exp10f - -Calculates the base-10 exponential of the argument - -```cpp -inline float exp10f(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-10 exponential of the argument - -## expm1 - -Calculates the base-e exponential of the argument, minus 1 - -```cpp -inline float expm1(float exponent) restrict(amp); - -inline double expm1(double exponent) restrict(amp); -``` - -### Parameters - -*exponent*
-The exponential term *n* of the mathematical expression `e`n, where `e` is the base of the natural logarithm. - -### Return Value - -Returns the base-e exponential of the argument, minus 1 - -## expm1f - -Calculates the base-e exponential of the argument, minus 1 - -```cpp -inline float expm1f(float exponent) restrict(amp); -``` - -### Parameters - -*exponent*
-The exponential term *n* of the mathematical expression `e`n, where `e` is the base of the natural logarithm. - -### Return Value - -Returns the base-e exponential of the argument, minus 1 - -## exp - -Calculates the base-e exponential of the argument - -```cpp -inline float exp(float _X) restrict(amp); - -inline double exp(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e exponential of the argument - -## expf - -Calculates the base-e exponential of the argument - -```cpp -inline float expf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e exponential of the argument - -## exp2 - -Calculates the base-2 exponential of the argument - -```cpp -inline float exp2(float _X) restrict(amp); - -inline double exp2(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-2 exponential of the argument - -## exp2f - -Calculates the base-2 exponential of the argument - -```cpp -inline float exp2f(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-2 exponential of the argument - -## fabs - -Returns the absolute value of the argument - -```cpp -inline float fabs(float _X) restrict(amp); - -inline double fabs(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the absolute value of the argument - -## fabsf - -Returns the absolute value of the argument - -```cpp -inline float fabsf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the absolute value of the argument - -## fdim - -Computes the positive difference between the arguments. - -```cpp -inline float fdim( - float _X, - float _Y -) restrict(amp); -inline double fdim( - double _X, - double _Y -) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -The difference between _X and _Y if _X is greater than _Y; otherwise, +0. - -## fdimf - -Computes the positive difference between the arguments. - -```cpp -inline float fdimf( - float _X, - float _Y -) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -The difference between _X and _Y if _X is greater than _Y; otherwise, +0. - -## floor - -Calculates the floor of the argument - -```cpp -inline float floor(float _X) restrict(amp); - -inline double floor(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the floor of the argument - -## floorf - -Calculates the floor of the argument - -```cpp -inline float floorf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the floor of the argument - -## fma - -Computes the product of the first and second specified arguments, then adds the third specified argument to the result; the entire computation is performed as a single operation. - -```cpp -inline float fma( - float _X, - float _Y, - float _Z -) restrict(amp); - -inline double fma( - double _X, - double _Y, - double _Z -) restrict(amp); -``` - -### Parameters - -*_X*
-The first floating-point argument. - -*_Y*
-The second floating-point argument. - -*_Z*
-The third floating-point argument. - -### Return Value - -The result of the expression (_X \* _Y) + _Z. The entire computation is performed as a single operation; that is, the sub-expressions are calculated to infinite precision, and only the final result is rounded. - -## fmaf - -Computes the product of the first and second specified arguments, then adds the third specified argument to the result; the entire computation is performed as a single operation. - -```cpp -inline float fmaf( - float _X, - float _Y, - float _Z -) restrict(amp); -``` - -### Parameters - -*_X*
-The first floating-point argument. - -*_Y*
-The second floating-point argument. - -*_Z*
-The third floating-point argument. - -### Return Value - -The result of the expression (_X \* _Y) + _Z. The entire computation is performed as a single operation; that is, the sub-expressions are calculated to infinite precision, and only the final result is rounded. - -## fmax - -Determine the maximum numeric value of the arguments - -```cpp -inline float fmax( - float _X, - float _Y) restrict(amp); - -inline double fmax( - double _X, - double _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Return the maximum numeric value of the arguments - -## fmaxf - -Determine the maximum numeric value of the arguments - -```cpp -inline float fmaxf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Return the maximum numeric value of the arguments - -## fmin - -Determine the minimum numeric value of the arguments - -```cpp -inline float fmin( - float _X, - float _Y) restrict(amp); - -inline double fmin( - double _X, - double _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Return the minimum numeric value of the arguments - -## fminf - -Determine the minimum numeric value of the arguments - -```cpp -inline float fminf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Return the minimum numeric value of the arguments - -## fmod Function (C++ AMP) - -Computes the remainder of the first specified argument divided by the second specified argument. - -```cpp -inline float fmod( - float _X, - float _Y) restrict(amp); - -inline double fmod( - double _X, - double _Y) restrict(amp); -``` - -### Parameters - -*_X*
-The first floating-point argument. - -*_Y*
-The second floating-point argument. - -### Return Value - -The remainder of `_X` divided by `_Y`; that is, the value of `_X` - `_Y`*n*, where *n* is a whole integer such that the magnitude of `_X` - `_Y`*n* is less than the magnitude of `_Y`. - -## fmodf - -Computes the remainder of the first specified argument divided by the second specified argument. - -```cpp -inline float fmodf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-The first floating-point argument. - -*_Y*
-The second floating-point argument. - -### Return Value - -The remainder of `_X` divided by `_Y`; that is, the value of `_X` - `_Y`*n*, where *n* is a whole integer such that the magnitude of `_X` - `_Y`*n* is less than the magnitude of `_Y`. - -## fpclassify - -Classifies the argument value as NaN, infinite, normal, subnormal, zero - -```cpp -inline int fpclassify(float _X) restrict(amp); - -inline int fpclassify(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the value of the number classification macro appropriate to the value of the argument. - -## frexp - -Gets the mantissa and exponent of _X - -```cpp -inline float frexp( - float _X, - _Out_ int* _Exp) restrict(amp); - -inline double frexp( - double _X, - _Out_ int* _Exp) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Exp*
-Returns the integer exponent of _X in floating-point value - -### Return Value - -Returns the mantissa _X - -## frexpf - -Gets the mantissa and exponent of _X - -```cpp -inline float frexpf( - float _X, - _Out_ int* _Exp) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Exp*
-Returns the integer exponent of _X in floating-point value - -### Return Value - -Returns the mantissa _X - -## hypot - -Computes the square root of the sum of the squares of _X and _Y - -```cpp -inline float hypot( - float _X, - float _Y) restrict(amp); - -inline double hypot( - double _X, - double _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns the square root of the sum of the squares of _X and _Y - -## hypotf - -Computes the square root of the sum of the squares of _X and _Y - -```cpp -inline float hypotf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns the square root of the sum of the squares of _X and _Y - -## ilogb - -Extract the exponent of _X as a signed int value - -```cpp -inline int ilogb(float _X) restrict(amp); - -inline int ilogb(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the exponent of _X as a signed int value - -## ilogbf - -Extract the exponent of _X as a signed int value - -```cpp -inline int ilogbf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the exponent of _X as a signed int value - -## isfinite - -Determines whether the argument has a finite value - -```cpp -inline int isfinite(float _X) restrict(amp); - -inline int isfinite(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the argument has a finite value - -## isinf - -Determines whether the argument is an infinity - -```cpp -inline int isinf(float _X) restrict(amp); - -inline int isinf(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the argument has an infinite value - -## isnan - -Determines whether the argument is a NaN - -```cpp -inline int isnan(float _X) restrict(amp); - -inline int isnan(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the argument has a NaN value - -## isnormal - -Determines whether the argument is a normal - -```cpp -inline int isnormal(float _X) restrict(amp); - -inline int isnormal(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the argument has a normal value - -## ldexp - -Computes a real number from the specified mantissa and exponent. - -```cpp -inline float ldexp( - float _X, - int _Exp) restrict(amp); - -inline double ldexp( - double _X, - double _Exp) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value, mantissa - -*_Exp*
-Integer value, exponent - -### Return Value - -Returns _X \* 2^_Exp - -## ldexpf - -Computes a real number from the specified mantissa and exponent. - -```cpp -inline float ldexpf( - float _X, - int _Exp) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value, mantissa - -*_Exp*
-Integer value, exponent - -### Return Value - -Returns _X \* 2^_Exp - -## lgamma - -Computes the natural logarithm of the absolute value of gamma of the argument - -```cpp -inline float lgamma( - float _X, - _Out_ int* _Sign) restrict(amp); - -inline double lgamma( - double _X, - _Out_ int* _Sign) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Sign*
-Returns the sign - -### Return Value - -Returns the natural logarithm of the absolute value of gamma of the argument - -## lgammaf - -Computes the natural logarithm of the absolute value of gamma of the argument - -```cpp -inline float lgammaf( - float _X, - _Out_ int* _Sign) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Sign*
-Returns the sign - -### Return Value - -Returns the natural logarithm of the absolute value of gamma of the argument - -## log - -Calculates the base-e logarithm of the argument - -```cpp -inline float log(float _X) restrict(amp); - -inline double log(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e logarithm of the argument - -## log10 - -Calculates the base-10 logarithm of the argument - -```cpp -inline float log10(float _X) restrict(amp); - -inline double log10(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-10 logarithm of the argument - -## log10f - -Calculates the base-10 logarithm of the argument - -```cpp -inline float log10f(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-10 logarithm of the argument - -## log1p - -Calculates the base-e logarithm of 1 plus the argument - -```cpp -inline float log1p(float _X) restrict(amp); - -inline double log1p(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e logarithm of 1 plus the argument - -## log1pf - -Calculates the base-e logarithm of 1 plus the argument - -```cpp -inline float log1pf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e logarithm of 1 plus the argument - -## log2 - -Calculates the base-2 logarithm of the argument - -```cpp -inline float log2(float _X) restrict(amp); - -inline double log2(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-10 logarithm of the argument - -## log2f - -Calculates the base-2 logarithm of the argument - -```cpp -inline float log2f(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-10 logarithm of the argument - -## logb - -Extracts the exponent of _X, as a signed integer value in floating-point format - -```cpp -inline float logb(float _X) restrict(amp); - -inline double logb(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the signed exponent of _X - -## logbf - -Extracts the exponent of _X, as a signed integer value in floating-point format - -```cpp -inline float logbf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the signed exponent of _X - -## logf - -Calculates the base-e logarithm of the argument - -```cpp -inline float logf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the base-e logarithm of the argument - -## modf - -Splits the specified argument into fractional and integer parts. - -```cpp -inline float modf( - float _X, - _Out_ float* _Iptr) restrict(amp); - -inline double modf( - double _X, - _Out_ double* _Iptr) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Iptr*
-[out] The integer portion of `_X`, as a floating-point value. - -### Return Value - -The signed fractional portion of `_X`. - -## modff - -Splits the specified argument into fractional and integer parts. - -```cpp -inline float modff( - float _X, - _Out_ float* _Iptr) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Iptr*
-The integer portion of `_X`, as a floating-point value. - -### Return Value - -Returns the signed fractional portion of `_X`. - -## nan - -Returns a quiet NaN - -```cpp -inline double nan(int _X) restrict(amp); -``` - -### Parameters - -*_X*
-Integer value - -### Return Value - -Returns a quiet NaN, if available, with the content indicated in _X - -## nanf - -Returns a quiet NaN - -```cpp -inline float nanf(int _X) restrict(amp); -``` - -### Parameters - -*_X*
-Integer value - -### Return Value - -Returns a quiet NaN, if available, with the content indicated in _X - -## nearbyint - -Rounds the argument to an integer value in floating-point format, using the current rounding direction. - -```cpp -inline float nearbyint(float _X) restrict(amp); - -inline double nearbyint(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the rounded integer value. - -## nearbyintf - -Rounds the argument to an integer value in floating-point format, using the current rounding direction. - -```cpp -inline float nearbyintf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the rounded integer value. - -## nextafter - -Determine the next representable value, in the type of the function, after _X in the direction of _Y - -```cpp -inline float nextafter( - float _X, - float _Y) restrict(amp); - -inline double nextafter( - double _X, - double _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns the next representable value, in the type of the function, after _X in the direction of _Y - -## nextafterf - -Determine the next representable value, in the type of the function, after _X in the direction of _Y - -```cpp -inline float nextafterf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns the next representable value, in the type of the function, after _X in the direction of _Y - -## phi - -Returns the cumulative distribution function of the argument - -```cpp -inline float phi(float _X) restrict(amp); - -inline double phi(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the cumulative distribution function of the argument - -## phif - -Returns the cumulative distribution function of the argument - -```cpp -inline float phif(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the cumulative distribution function of the argument - -## pow - -Calculates _X raised to the power of _Y - -```cpp -inline float pow( - float _X, - float _Y) restrict(amp); - -inline double pow( - double _X, - double _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value, base - -*_Y*
-Floating-point value, exponent - -### Return Value - -## powf - -Calculates _X raised to the power of _Y - -```cpp -inline float powf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value, base - -*_Y*
-Floating-point value, exponent - -### Return Value - -## probit - -Returns the inverse cumulative distribution function of the argument - -```cpp -inline float probit(float _X) restrict(amp); - -inline double probit(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse cumulative distribution function of the argument - -## probitf - -Returns the inverse cumulative distribution function of the argument - -```cpp -inline float probitf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the inverse cumulative distribution function of the argument - -## rcbrt - -Returns the reciprocal of the cube root of the argument - -```cpp -inline float rcbrt(float _X) restrict(amp); - -inline double rcbrt(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the reciprocal of the cube root of the argument - -## rcbrtf - -Returns the reciprocal of the cube root of the argument - -```cpp -inline float rcbrtf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the reciprocal of the cube root of the argument - -## remainder - -Computes the remainder: _X REM _Y - -```cpp -inline float remainder( - float _X, - float _Y) restrict(amp); - -inline double remainder( - double _X, - double _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns _X REM _Y - -## remainderf - -Computes the remainder: _X REM _Y - -```cpp -inline float remainderf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns _X REM _Y - -## remquo - -Computes the remainder of the first specified argument divided by the second specified argument. Also computes the quotient of the significand of the first specified argument divided by the significand of the second specified argument, and returns the quotient using the location specified in the third argument. - -```cpp -inline float remquo( - float _X, - float _Y, - _Out_ int* _Quo) restrict(amp); - -inline double remquo( - double _X, - double _Y, - _Out_ int* _Quo) restrict(amp); -``` - -### Parameters - -*_X*
-The first floating-point argument. - -*_Y*
-The second floating-point argument. - -*_Quo*
-[out] The address of an integer that's used to return the quotient of the fractional bits of `_X` divided by the fractional bits of `_Y`. - -### Return Value - -Returns the remainder of `_X` divided by `_Y`. - -## remquof - -Computes the remainder of the first specified argument divided by the second specified argument. Also computes the quotient of the significand of the first specified argument divided by the significand of the second specified argument, and returns the quotient using the location specified in the third argument. - -```cpp -inline float remquof( - float _X, - float _Y, - _Out_ int* _Quo) restrict(amp); -``` - -### Parameters - -*_X*
-The first floating-point argument. - -*_Y*
-The second floating-point argument. - -*_Quo*
-[out] The address of an integer that's used to return the quotient of the fractional bits of `_X` divided by the fractional bits of `_Y`. - -### Return Value - -Returns the remainder of `_X` divided by `_Y`. - -## round - -Rounds _X to the nearest integer - -```cpp -inline float round(float _X) restrict(amp); - -inline double round(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the nearest integer of _X - -## roundf - -Rounds _X to the nearest integer - -```cpp -inline float roundf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the nearest integer of _X - -## rsqrt - -Returns the reciprocal of the square root of the argument - -```cpp -inline float rsqrt(float _X) restrict(amp); - -inline double rsqrt(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the reciprocal of the square root of the argument - -## rsqrtf - -Returns the reciprocal of the square root of the argument - -```cpp -inline float rsqrtf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the reciprocal of the square root of the argument - -## scalb - -Multiplies _X by FLT_RADIX to the power _Y - -```cpp -inline float scalb( - float _X, - float _Y) restrict(amp); - -inline double scalb( - double _X, - double _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns _X \* (FLT_RADIX ^ _Y) - -## scalbf - -Multiplies _X by FLT_RADIX to the power _Y - -```cpp -inline float scalbf( - float _X, - float _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Floating-point value - -### Return Value - -Returns _X \* (FLT_RADIX ^ _Y) - -## scalbn - -Multiplies _X by FLT_RADIX to the power _Y - -```cpp -inline float scalbn( - float _X, - int _Y) restrict(amp); - -inline double scalbn( - double _X, - int _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Integer value - -### Return Value - -Returns _X \* (FLT_RADIX ^ _Y) - -## scalbnf - -Multiplies _X by FLT_RADIX to the power _Y - -```cpp -inline float scalbnf( - float _X, - int _Y) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_Y*
-Integer value - -### Return Value - -Returns _X \* (FLT_RADIX ^ _Y) - -## signbit - -Determines whether the sign of _X is negative - -```cpp -inline int signbit(float _X) restrict(amp); - -inline int signbit(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the sign of _X is negative - -## signbitf - -Determines whether the sign of _X is negative - -```cpp -inline int signbitf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns a nonzero value if and only if the sign of _X is negative - -## sin - -Calculates the sine value of the argument - -```cpp -inline float sin(float _X) restrict(amp); - -inline double sin(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the sine value of the argument - -## sinf - -Calculates the sine value of the argument - -```cpp -inline float sinf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the sine value of the argument - -## sincos - -Calculates sine and cosine value of _X - -```cpp -inline void sincos( - float _X, - _Out_ float* _S, - _Out_ float* _C) restrict(amp); - -inline void sincos( - double _X, - _Out_ double* _S, - _Out_ double* _C) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_S*
-Returns the sine value of _X - -*_C*
-Returns the cosine value of _X - -## sincosf - -Calculates sine and cosine value of _X - -```cpp -inline void sincosf( - float _X, - _Out_ float* _S, - _Out_ float* _C) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -*_S*
-Returns the sine value of _X - -*_C*
-Returns the cosine value of _X - -## sinh - -Calculates the hyperbolic sine value of the argument - -```cpp -inline float sinh(float _X) restrict(amp); - -inline double sinh(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic sine value of the argument - -## sinhf - -Calculates the hyperbolic sine value of the argument - -```cpp -inline float sinhf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic sine value of the argument - -## sinpi - -Calculates the sine value of pi \* _X - -```cpp -inline float sinpi(float _X) restrict(amp); - -inline double sinpi(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the sine value of pi \* _X - -## sinpif - -Calculates the sine value of pi \* _X - -```cpp -inline float sinpif(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the sine value of pi \* _X - -## sqrt - -Calculates the squre root of the argument - -```cpp -inline float sqrt(float _X) restrict(amp); - -inline double sqrt(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the squre root of the argument - -## sqrtf - -Calculates the squre root of the argument - -```cpp -inline float sqrtf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the squre root of the argument - -## tan - -Calculates the tangent value of the argument - -```cpp -inline float tan(float _X) restrict(amp); - -inline double tan(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the tangent value of the argument - -## tanf - -Calculates the tangent value of the argument - -```cpp -inline float tanf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the tangent value of the argument - -## tanh - -Calculates the hyperbolic tangent value of the argument - -```cpp -inline float tanh(float _X) restrict(amp); - -inline double tanh(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic tangent value of the argument - -## tanhf - -Calculates the hyperbolic tangent value of the argument - -```cpp -inline float tanhf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the hyperbolic tangent value of the argument - -## tanpi - -Calculates the tangent value of pi \* _X - -```cpp -inline float tanpi(float _X) restrict(amp); - -inline double tanpi(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the tangent value of pi \* _X - -## tanpif - -Calculates the tangent value of pi \* _X - -```cpp -inline float tanpif(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the tangent value of pi \* _X - -## tgamma - -Computes the gamma function of _X - -```cpp -inline float tgamma(float _X) restrict(amp); - -inline double tgamma(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the result of gamma function of _X - -## tgammaf - -Computes the gamma function of _X - -```cpp -inline float tgammaf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the result of gamma function of _X - -## trunc - -Truncates the argument to the integer component - -```cpp -inline float trunc(float _X) restrict(amp); - -inline double trunc(double _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the integer component of the argument - -## truncf - -Truncates the argument to the integer component - -```cpp -inline float truncf(float _X) restrict(amp); -``` - -### Parameters - -*_X*
-Floating-point value - -### Return Value - -Returns the integer component of the argument - -## See also - -[Concurrency::precise_math Namespace](concurrency-precise-math-namespace.md) diff --git a/docs/parallel/amp/reference/concurrency-precise-math-namespace.md b/docs/parallel/amp/reference/concurrency-precise-math-namespace.md deleted file mode 100644 index ade1b8c16cc..00000000000 --- a/docs/parallel/amp/reference/concurrency-precise-math-namespace.md +++ /dev/null @@ -1,166 +0,0 @@ ---- -description: "Learn more about: Concurrency::precise_math Namespace" -title: "Concurrency::precise_math Namespace" -ms.date: "11/04/2016" -f1_keywords: ["AMP_MATH/Concurrency::acos", "AMP_MATH/Concurrency::acosf", "AMP_MATH/Concurrency::acosh", "AMP_MATH/Concurrency::acoshf", "AMP_MATH/Concurrency::asin", "AMP_MATH/Concurrency::asinf", "AMP_MATH/Concurrency::asinh", "AMP_MATH/Concurrency::asinhf", "AMP_MATH/Concurrency::atan", "AMP_MATH/Concurrency::atan2", "AMP_MATH/Concurrency::atan2f", "AMP_MATH/Concurrency::atanf", "AMP_MATH/Concurrency::atanh", "AMP_MATH/Concurrency::atanhf", "AMP_MATH/Concurrency::cbrt", "AMP_MATH/Concurrency::cbrtf", "AMP_MATH/Concurrency::ceil", "AMP_MATH/Concurrency::ceilf", "AMP_MATH/Concurrency::copysign", "AMP_MATH/Concurrency::copysignf", "AMP_MATH/Concurrency::cos", "AMP_MATH/Concurrency::cosf", "AMP_MATH/Concurrency::cosh", "AMP_MATH/Concurrency::coshf", "AMP_MATH/Concurrency::cospi", "AMP_MATH/Concurrency::cospif", "AMP_MATH/Concurrency::erf", "AMP_MATH/Concurrency::erfc", "AMP_MATH/Concurrency::erfcf", "AMP_MATH/Concurrency::erfcinv", "AMP_MATH/Concurrency::erfcinvf", "AMP_MATH/Concurrency::erff", "AMP_MATH/Concurrency::erfinv", "AMP_MATH/Concurrency::erfinvf", "AMP_MATH/Concurrency::exp", "AMP_MATH/Concurrency::exp10", "AMP_MATH/Concurrency::exp10f", "AMP_MATH/Concurrency::exp2", "AMP_MATH/Concurrency::exp2f", "AMP_MATH/Concurrency::expf", "AMP_MATH/Concurrency::expm1", "AMP_MATH/Concurrency::expm1f", "AMP_MATH/Concurrency::fabs", "AMP_MATH/Concurrency::fabsf", "AMP_MATH/Concurrency::fdim", "AMP_MATH/Concurrency::fdimf", "AMP_MATH/Concurrency::floor", "AMP_MATH/Concurrency::floorf", "AMP_MATH/Concurrency::fma", "AMP_MATH/Concurrency::fmaf", "AMP_MATH/Concurrency::fmax", "AMP_MATH/Concurrency::fmaxf", "AMP_MATH/Concurrency::fmin", "AMP_MATH/Concurrency::fminf", "AMP_MATH/Concurrency::fmodf", "AMP_MATH/Concurrency::fpclassify", "AMP_MATH/Concurrency::frexp", "AMP_MATH/Concurrency::frexpf", "AMP_MATH/Concurrency::hypot", "AMP_MATH/Concurrency::hypotf", "AMP_MATH/Concurrency::ilogb", "AMP_MATH/Concurrency::ilogbf", "AMP_MATH/Concurrency::isfinite", "AMP_MATH/Concurrency::isinf", "AMP_MATH/Concurrency::isnan", "AMP_MATH/Concurrency::isnormal", "AMP_MATH/Concurrency::ldexp", "AMP_MATH/Concurrency::ldexpf", "AMP_MATH/Concurrency::lgamma", "AMP_MATH/Concurrency::lgammaf", "AMP_MATH/Concurrency::log", "AMP_MATH/Concurrency::log10", "AMP_MATH/Concurrency::log10f", "AMP_MATH/Concurrency::log1p", "AMP_MATH/Concurrency::log1pf", "AMP_MATH/Concurrency::log2", "AMP_MATH/Concurrency::log2f", "AMP_MATH/Concurrency::logb", "AMP_MATH/Concurrency::logbf", "AMP_MATH/Concurrency::logf", "AMP_MATH/Concurrency::modf", "AMP_MATH/Concurrency::modff", "AMP_MATH/Concurrency::nan", "AMP_MATH/Concurrency::nanf", "AMP_MATH/Concurrency::nearbyint", "AMP_MATH/Concurrency::nearbyintf", "AMP_MATH/Concurrency::nextafter", "AMP_MATH/Concurrency::nextafterf", "AMP_MATH/Concurrency::phi", "AMP_MATH/Concurrency::phif", "AMP_MATH/Concurrency::pow", "AMP_MATH/Concurrency::powf", "AMP_MATH/Concurrency::probit", "AMP_MATH/Concurrency::probitf", "AMP_MATH/Concurrency::rcbrt", "AMP_MATH/Concurrency::rcbrtf", "AMP_MATH/Concurrency::remainder", "AMP_MATH/Concurrency::remainderf", "AMP_MATH/Concurrency::remquo", "AMP_MATH/Concurrency::remquof", "AMP_MATH/Concurrency::round", "AMP_MATH/Concurrency::roundf", "AMP_MATH/Concurrency::rsqrt", "AMP_MATH/Concurrency::rsqrtf", "AMP_MATH/Concurrency::scalb", "AMP_MATH/Concurrency::scalbf", "AMP_MATH/Concurrency::scalbn", "AMP_MATH/Concurrency::scalbnf", "AMP_MATH/Concurrency::signbit", "AMP_MATH/Concurrency::signbitf", "AMP_MATH/Concurrency::sin", "AMP_MATH/Concurrency::sincos", "AMP_MATH/Concurrency::sincosf", "AMP_MATH/Concurrency::sinf", "AMP_MATH/Concurrency::sinh", "AMP_MATH/Concurrency::sinhf", "AMP_MATH/Concurrency::sinpi", "AMP_MATH/Concurrency::sinpif", "AMP_MATH/Concurrency::sqrt", "AMP_MATH/Concurrency::sqrtf", "AMP_MATH/Concurrency::tan", "AMP_MATH/Concurrency::tanf", "AMP_MATH/Concurrency::tanh", "AMP_MATH/Concurrency::tanhf", "AMP_MATH/Concurrency::tanpi", "AMP_MATH/Concurrency::tanpif", "AMP_MATH/Concurrency::tgamma", "AMP_MATH/Concurrency::tgammaf", "AMP_MATH/Concurrency::trunc", "AMP_MATH/Concurrency::truncf"] -ms.assetid: ba653308-dc28-4384-b2fd-6cd718a72f91 ---- -# Concurrency::precise_math Namespace - -Functions in the `precise_math` namespace are C99 conformant. Both single precision and double precision versions of each function are included. For example, `acos` is the double-precision version and `acosf` is the single-precision version. These functions, including the single-precision functions, require extended double-precision support on the accelerator. You can use the [accelerator::supports_double_precision](accelerator-class.md#supports_double_precision) to determine if you can run these functions on a specific accelerator. - -## Syntax - -```cpp -namespace precise_math; -``` - -### Parameters - -## Members - -### Functions - -|Name|Description| -|----------|-----------------| -|[acos](concurrency-precise-math-namespace-functions.md#acos)|Overloaded. Calculates the arccosine of the argument| -|[acosf](concurrency-precise-math-namespace-functions.md#acosf)|Calculates the arccosine of the argument| -|[acosh](concurrency-precise-math-namespace-functions.md#acosh)|Overloaded. Calculates the inverse hyperbolic cosine of the argument| -|[acoshf](concurrency-precise-math-namespace-functions.md#acoshf)|Calculates the inverse hyperbolic cosine of the argument| -|[asin](concurrency-precise-math-namespace-functions.md#asin)|Overloaded. Calculates the arcsine of the argument| -|[asinf](concurrency-precise-math-namespace-functions.md#asinf)|Calculates the arcsine of the argument| -|[asinh](concurrency-precise-math-namespace-functions.md#asinh)|Overloaded. Calculates the inverse hyperbolic sine of the argument| -|[asinhf](concurrency-precise-math-namespace-functions.md#asinhf)|Calculates the inverse hyperbolic sine of the argument| -|[atan](concurrency-precise-math-namespace-functions.md#atan)|Overloaded. Calculates the arctangent of the argument| -|[atan2](concurrency-precise-math-namespace-functions.md#atan2)|Overloaded. Calculates the arctangent of _Y/_X| -|[atan2f](concurrency-precise-math-namespace-functions.md#atan2f)|Calculates the arctangent of _Y/_X| -|[atanf](concurrency-precise-math-namespace-functions.md#atanf)|Calculates the arctangent of the argument| -|[atanh](concurrency-precise-math-namespace-functions.md#atanh)|Overloaded. Calculates the inverse hyperbolic tangent of the argument| -|[atanhf](concurrency-precise-math-namespace-functions.md#atanhf)|Calculates the inverse hyperbolic tangent of the argument| -|[cbrt](concurrency-precise-math-namespace-functions.md#cbrt)|Overloaded. Computes the real cube root of the argument| -|[cbrtf](concurrency-precise-math-namespace-functions.md#cbrtf)|Computes the real cube root of the argument| -|[ceil](concurrency-precise-math-namespace-functions.md#ceil)|Overloaded. Calculates the ceiling of the argument| -|[ceilf](concurrency-precise-math-namespace-functions.md#ceilf)|Calculates the ceiling of the argument| -|[copysign](concurrency-precise-math-namespace-functions.md#copysign)|Overloaded. Produces a value with the magnitude of _X and the sign of _Y| -|[copysignf](concurrency-precise-math-namespace-functions.md#copysignf)|Produces a value with the magnitude of _X and the sign of _Y| -|[cos](concurrency-precise-math-namespace-functions.md#cos)|Overloaded. Calculates the cosine of the argument| -|[cosf](concurrency-precise-math-namespace-functions.md#cosf)|Calculates the cosine of the argument| -|[cosh](concurrency-precise-math-namespace-functions.md#cosh)|Overloaded. Calculates the hyperbolic cosine value of the argument| -|[coshf](concurrency-precise-math-namespace-functions.md#coshf)|Calculates the hyperbolic cosine value of the argument| -|[cospi](concurrency-precise-math-namespace-functions.md#cospi)|Overloaded. Calculates the cosine value of pi \* _X| -|[cospif](concurrency-precise-math-namespace-functions.md#cospif)|Calculates the cosine value of pi \* _X| -|[erf](concurrency-precise-math-namespace-functions.md#erf)|Overloaded. Computes the error function of _X| -|[erfc](concurrency-precise-math-namespace-functions.md#erfc)|Overloaded. Computes the complementary error function of _X| -|[erfcf](concurrency-precise-math-namespace-functions.md#erfcf)|Computes the complementary error function of _X| -|[erfcinv](concurrency-precise-math-namespace-functions.md#erfcinv)|Overloaded. Computes the inverse complementary error function of _X| -|[erfcinvf](concurrency-precise-math-namespace-functions.md#erfcinvf)|Computes the inverse complementary error function of _X| -|[erff](concurrency-precise-math-namespace-functions.md#erff)|Computes the error function of _X| -|[erfinv](concurrency-precise-math-namespace-functions.md#erfinv)|Overloaded. Computes the inverse error function of _X| -|[erfinvf](concurrency-precise-math-namespace-functions.md#erfinvf)|Computes the inverse error function of _X| -|[exp](concurrency-precise-math-namespace-functions.md#exp)|Overloaded. Calculates the base-e exponential of the argument| -|[exp10](concurrency-precise-math-namespace-functions.md#exp10)|Overloaded. Calculates the base-10 exponential of the argument| -|[exp10f](concurrency-precise-math-namespace-functions.md#exp10f)|Calculates the base-10 exponential of the argument| -|[exp2](concurrency-precise-math-namespace-functions.md#exp2)|Overloaded. Calculates the base-2 exponential of the argument| -|[exp2f](concurrency-precise-math-namespace-functions.md#exp2f)|Calculates the base-2 exponential of the argument| -|[expf](concurrency-precise-math-namespace-functions.md#expf)|Calculates the base-e exponential of the argument| -|[expm1](concurrency-precise-math-namespace-functions.md#expm1)|Overloaded. Calculates the base-e exponential of the argument, minus 1| -|[expm1f](concurrency-precise-math-namespace-functions.md#expm1f)|Calculates the base-e exponential of the argument, minus 1| -|[fabs](concurrency-precise-math-namespace-functions.md#fabs)|Overloaded. Returns the absolute value of the argument| -|[fabsf](concurrency-precise-math-namespace-functions.md#fabsf)|Returns the absolute value of the argument| -|[fdim](concurrency-precise-math-namespace-functions.md#fdim)|Overloaded. Determines the positive difference between the arguments| -|[fdimf](concurrency-precise-math-namespace-functions.md#fdimf)|Determines the positive difference between the arguments| -|[floor](concurrency-precise-math-namespace-functions.md#floor)|Overloaded. Calculates the floor of the argument| -|[floorf](concurrency-precise-math-namespace-functions.md#floorf)|Calculates the floor of the argument| -|[fma](concurrency-precise-math-namespace-functions.md#fma)|Overloaded. Compute (_X \* _Y) + _Z, rounded as one ternary operation| -|[fmaf](concurrency-precise-math-namespace-functions.md#fmaf)|Compute (_X \* _Y) + _Z, rounded as one ternary operation| -|[fmax](concurrency-precise-math-namespace-functions.md#fmax)|Overloaded. Determine the maximum numeric value of the arguments| -|[fmaxf](concurrency-precise-math-namespace-functions.md#fmaxf)|Determine the maximum numeric value of the arguments| -|[fmin](concurrency-precise-math-namespace-functions.md#fmin)|Overloaded. Determine the minimum numeric value of the arguments| -|[fminf](concurrency-precise-math-namespace-functions.md#fminf)|Determine the minimum numeric value of the arguments| -|[fmod Function (C++ AMP)](concurrency-precise-math-namespace-functions.md#fmod)|Overloaded. Calculates the floating-point remainder of _X/_Y| -|[fmodf](concurrency-precise-math-namespace-functions.md#fmodf)|Calculates the floating-point remainder of _X/_Y| -|[fpclassify](concurrency-precise-math-namespace-functions.md#fpclassify)|Overloaded. Classifies the argument value as NaN, infinite, normal, subnormal, zero| -|[frexp](concurrency-precise-math-namespace-functions.md#frexp)|Overloaded. Gets the mantissa and exponent of _X| -|[frexpf](concurrency-precise-math-namespace-functions.md#frexpf)|Gets the mantissa and exponent of _X| -|[hypot](concurrency-precise-math-namespace-functions.md#hypot)|Overloaded. Computes the square root of the sum of the squares of _X and _Y| -|[hypotf](concurrency-precise-math-namespace-functions.md#hypotf)|Computes the square root of the sum of the squares of _X and _Y| -|[ilogb](concurrency-precise-math-namespace-functions.md#ilogb)|Overloaded. Extract the exponent of _X as a signed int value| -|[ilogbf](concurrency-precise-math-namespace-functions.md#ilogbf)|Extract the exponent of _X as a signed int value| -|[isfinite](concurrency-precise-math-namespace-functions.md#isfinite)|Overloaded. Determines whether the argument has a finite value| -|[isinf](concurrency-precise-math-namespace-functions.md#isinf)|Overloaded. Determines whether the argument is an infinity| -|[isnan](concurrency-precise-math-namespace-functions.md#isnan)|Overloaded. Determines whether the argument is a NaN| -|[isnormal](concurrency-precise-math-namespace-functions.md#isnormal)|Overloaded. Determines whether the argument is a normal| -|[ldexp](concurrency-precise-math-namespace-functions.md#ldexp)|Overloaded. Computes a real number from the mantissa and exponent| -|[ldexpf](concurrency-precise-math-namespace-functions.md#ldexpf)|Computes a real number from the mantissa and exponent| -|[lgamma](concurrency-precise-math-namespace-functions.md#lgamma)|Overloaded. Computes the natural logarithm of the absolute value of gamma of the argument| -|[lgammaf](concurrency-precise-math-namespace-functions.md#lgammaf)|Computes the natural logarithm of the absolute value of gamma of the argument| -|[log](concurrency-precise-math-namespace-functions.md#log)|Overloaded. Calculates the base-e logarithm of the argument| -|[log10](concurrency-precise-math-namespace-functions.md#log10)|Overloaded. Calculates the base-10 logarithm of the argument| -|[log10f](concurrency-precise-math-namespace-functions.md#log10f)|Calculates the base-10 logarithm of the argument| -|[log1p](concurrency-precise-math-namespace-functions.md#log1p)|Overloaded. Calculates the base-e logarithm of 1 plus the argument| -|[log1pf](concurrency-precise-math-namespace-functions.md#log1pf)|Calculates the base-e logarithm of 1 plus the argument| -|[log2](concurrency-precise-math-namespace-functions.md#log2)|Overloaded. Calculates the base-2 logarithm of the argument| -|[log2f](concurrency-precise-math-namespace-functions.md#log2f)|Calculates the base-2 logarithm of the argument| -|[logb](concurrency-precise-math-namespace-functions.md#logb)|Overloaded. Extracts the exponent of _X, as a signed integer value in floating-point format| -|[logbf](concurrency-precise-math-namespace-functions.md#logbf)|Extracts the exponent of _X, as a signed integer value in floating-point format| -|[logf](concurrency-precise-math-namespace-functions.md#logf)|Calculates the base-e logarithm of the argument| -|[modf](concurrency-precise-math-namespace-functions.md#modf)|Overloaded. Splits _X into fractional and integer parts.| -|[modff](concurrency-precise-math-namespace-functions.md#modff)|Splits _X into fractional and integer parts.| -|[nan](concurrency-precise-math-namespace-functions.md#nan)|Returns a quiet NaN| -|[nanf](concurrency-precise-math-namespace-functions.md#nanf)|Returns a quiet NaN| -|[nearbyint](concurrency-precise-math-namespace-functions.md#nearbyint)|Overloaded. Rounds the argument to an integer value in floating-point format, using the current rounding direction.| -|[nearbyintf](concurrency-precise-math-namespace-functions.md#nearbyintf)|Rounds the argument to an integer value in floating-point format, using the current rounding direction.| -|[nextafter](concurrency-precise-math-namespace-functions.md#nextafter)|Overloaded. Determine the next representable value, in the type of the function, after _X in the direction of _Y| -|[nextafterf](concurrency-precise-math-namespace-functions.md#nextafterf)|Determine the next representable value, in the type of the function, after _X in the direction of _Y| -|[phi](concurrency-precise-math-namespace-functions.md#phi)|Overloaded. Returns the cumulative distribution function of the argument| -|[phif](concurrency-precise-math-namespace-functions.md#phif)|Returns the cumulative distribution function of the argument| -|[pow](concurrency-precise-math-namespace-functions.md#pow)|Overloaded. Calculates _X raised to the power of _Y| -|[powf](concurrency-precise-math-namespace-functions.md#powf)|Calculates _X raised to the power of _Y| -|[probit](concurrency-precise-math-namespace-functions.md#probit)|Overloaded. Returns the inverse cumulative distribution function of the argument| -|[probitf](concurrency-precise-math-namespace-functions.md#probitf)|Returns the inverse cumulative distribution function of the argument| -|[rcbrt](concurrency-precise-math-namespace-functions.md#rcbrt)|Overloaded. Returns the reciprocal of the cube root of the argument| -|[rcbrtf](concurrency-precise-math-namespace-functions.md#rcbrtf)|Returns the reciprocal of the cube root of the argument| -|[remainder](concurrency-precise-math-namespace-functions.md#remainder)|Overloaded. Computes the remainder: _X REM _Y| -|[remainderf](concurrency-precise-math-namespace-functions.md#remainderf)|Computes the remainder: _X REM _Y| -|[remquo](concurrency-precise-math-namespace-functions.md#remquo)|Overloaded. Computes the same remainder as _X REM _Y. Also calculates the lower 23 bits of the integral quotient _X/_Y, and gives that value the same sign as _X/_Y. It stores this signed value in the integer pointed to by _Quo.| -|[remquof](concurrency-precise-math-namespace-functions.md#remquof)|Computes the same remainder as _X REM _Y. Also calculates the lower 23 bits of the integral quotient _X/_Y, and gives that value the same sign as _X/_Y. It stores this signed value in the integer pointed to by _Quo.| -|[round](concurrency-precise-math-namespace-functions.md#round)|Overloaded. Rounds _X to the nearest integer| -|[roundf](concurrency-precise-math-namespace-functions.md#roundf)|Rounds _X to the nearest integer| -|[rsqrt](concurrency-precise-math-namespace-functions.md#rsqrt)|Overloaded. Returns the reciprocal of the square root of the argument| -|[rsqrtf](concurrency-precise-math-namespace-functions.md#rsqrtf)|Returns the reciprocal of the square root of the argument| -|[scalb](concurrency-precise-math-namespace-functions.md#scalb)|Overloaded. Multiplies _X by FLT_RADIX to the power _Y| -|[scalbf](concurrency-precise-math-namespace-functions.md#scalbf)|Multiplies _X by FLT_RADIX to the power _Y| -|[scalbn](concurrency-precise-math-namespace-functions.md#scalbn)|Overloaded. Multiplies _X by FLT_RADIX to the power _Y| -|[scalbnf](concurrency-precise-math-namespace-functions.md#scalbnf)|Multiplies _X by FLT_RADIX to the power _Y| -|[signbit](concurrency-precise-math-namespace-functions.md#signbit)|Overloaded. Determines whether the sign of _X is negative| -|[signbitf](concurrency-precise-math-namespace-functions.md#signbitf)|Determines whether the sign of _X is negative| -|[sin](concurrency-precise-math-namespace-functions.md#sin)|Overloaded. Calculates the sine value of the argument| -|[sincos](concurrency-precise-math-namespace-functions.md#sincos)|Overloaded. Calculates sine and cosine value of _X| -|[sincosf](concurrency-precise-math-namespace-functions.md#sincosf)|Calculates sine and cosine value of _X| -|[sinf](concurrency-precise-math-namespace-functions.md#sinf)|Calculates the sine value of the argument| -|[sinh](concurrency-precise-math-namespace-functions.md#sinh)|Overloaded. Calculates the hyperbolic sine value of the argument| -|[sinhf](concurrency-precise-math-namespace-functions.md#sinhf)|Calculates the hyperbolic sine value of the argument| -|[sinpi](concurrency-precise-math-namespace-functions.md#sinpi)|Overloaded. Calculates the sine value of pi \* _X| -|[sinpif](concurrency-precise-math-namespace-functions.md#sinpif)|Calculates the sine value of pi \* _X| -|[sqrt](concurrency-precise-math-namespace-functions.md#sqrt)|Overloaded. Calculates the squre root of the argument| -|[sqrtf](concurrency-precise-math-namespace-functions.md#sqrtf)|Calculates the squre root of the argument| -|[tan](concurrency-precise-math-namespace-functions.md#tan)|Overloaded. Calculates the tangent value of the argument| -|[tanf](concurrency-precise-math-namespace-functions.md#tanf)|Calculates the tangent value of the argument| -|[tanh](concurrency-precise-math-namespace-functions.md#tanh)|Overloaded. Calculates the hyperbolic tangent value of the argument| -|[tanhf](concurrency-precise-math-namespace-functions.md#tanhf)|Calculates the hyperbolic tangent value of the argument| -|[tanpi](concurrency-precise-math-namespace-functions.md#tanpi)|Overloaded. Calculates the tangent value of pi \* _X| -|[tanpif](concurrency-precise-math-namespace-functions.md#tanpif)|Calculates the tangent value of pi \* _X| -|[tgamma](concurrency-precise-math-namespace-functions.md#tgamma)|Overloaded. Computes the gamma function of _X| -|[tgammaf](concurrency-precise-math-namespace-functions.md#tgammaf)|Computes the gamma function of _X| -|[trunc](concurrency-precise-math-namespace-functions.md#trunc)|Overloaded. Truncates the argument to the integer component| -|[truncf](concurrency-precise-math-namespace-functions.md#truncf)|Truncates the argument to the integer component| - -## Requirements - -**Header:** amp_math.h - -**Namespace:** Concurrency - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/double-2-class.md b/docs/parallel/amp/reference/double-2-class.md deleted file mode 100644 index 59d983be77d..00000000000 --- a/docs/parallel/amp/reference/double-2-class.md +++ /dev/null @@ -1,155 +0,0 @@ ---- -description: "Learn more about: double_2 Class" -title: "double_2 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::double_2::set_x", "amp_short_vectors/Concurrency::graphics::double_2::operator+=", "amp_short_vectors/Concurrency::graphics::double_2::operator=", "amp_short_vectors/Concurrency::graphics::double_2::operator/=", "amp_short_vectors/Concurrency::graphics::double_2::operator*=", "amp_short_vectors/Concurrency::graphics::double_2::yx", "amp_short_vectors/Concurrency::graphics::double_2::y", "amp_short_vectors/Concurrency::graphics::double_2::xy", "amp_short_vectors/Concurrency::graphics::double_2::set_xy", "amp_short_vectors/Concurrency::graphics::double_2::get_yx", "amp_short_vectors/Concurrency::graphics::double_2::set_yx", "amp_short_vectors/Concurrency::graphics::double_2::get_xy", "amp_short_vectors/Concurrency::graphics::double_2::operator++", "amp_short_vectors/Concurrency::graphics::double_2::get_x", "amp_short_vectors/Concurrency::graphics::double_2::operator-=", "amp_short_vectors/Concurrency::graphics::double_2::rg", "amp_short_vectors/Concurrency::graphics::double_2::gr", "amp_short_vectors/Concurrency::graphics::double_2::get_y", "amp_short_vectors/Concurrency::graphics::double_2::x", "amp_short_vectors/Concurrency::graphics::double_2::r", "amp_short_vectors/Concurrency::graphics::double_2::operator--", "amp_short_vectors/Concurrency::graphics::double_2", "amp_short_vectors/Concurrency::graphics::double_2::operator-", "amp_short_vectors/Concurrency::graphics::double_2::g", "amp_short_vectors/Concurrency::graphics::double_2::set_y"] -ms.assetid: c19c2d21-3cbf-4ce5-b460-3b8253688f82 ---- -# double_2 Class - -Represent a short vector of 2 double's. - -## Syntax - -```cpp -class double_2; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[double_2 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|double_2::get_x|| -|double_2::get_xy|| -|double_2::get_y|| -|double_2::get_yx|| -|double_2::ref_g|| -|double_2::ref_r|| -|double_2::ref_x|| -|double_2::ref_y|| -|double_2::set_x|| -|double_2::set_xy|| -|double_2::set_y|| -|double_2::set_yx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|double_2::operator-|| -|double_2::operator--|| -|double_2::operator*=|| -|double_2::operator/=|| -|double_2::operator++|| -|double_2::operator+=|| -|double_2::operator=|| -|double_2::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|double_2::size Constant|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|double_2::g|| -|double_2::gr|| -|double_2::r|| -|double_2::rg|| -|double_2::x|| -|double_2::xy|| -|double_2::y|| -|double_2::yx|| - -## Inheritance Hierarchy - -`double_2` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## double_2 - -Default constructor, initializes all elements with 0. - -```cpp -double_2() restrict(amp, - cpu); - -double_2( - double _V0, - double _V1) restrict(amp, - cpu); - -double_2( - double _V) restrict(amp, - cpu); - -double_2( - const double_2& _Other) restrict(amp, - cpu); - -explicit inline double_2( - const uint_2& _Other) restrict(amp, - cpu); - -explicit inline double_2( - const int_2& _Other) restrict(amp, - cpu); - -explicit inline double_2( - const float_2& _Other) restrict(amp, - cpu); - -explicit inline double_2( - const unorm_2& _Other) restrict(amp, - cpu); - -explicit inline double_2( - const norm_2& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 2; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/double-3-class.md b/docs/parallel/amp/reference/double-3-class.md deleted file mode 100644 index 67dd97384bb..00000000000 --- a/docs/parallel/amp/reference/double-3-class.md +++ /dev/null @@ -1,205 +0,0 @@ ---- -description: "Learn more about: double_3 Class" -title: "double_3 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::double_3::get_xzy", "amp_short_vectors/Concurrency::graphics::double_3", "amp_short_vectors/Concurrency::graphics::double_3::set_yz", "amp_short_vectors/Concurrency::graphics::double_3::bgr", "amp_short_vectors/Concurrency::graphics::double_3::get_zyx", "amp_short_vectors/Concurrency::graphics::double_3::r", "amp_short_vectors/Concurrency::graphics::double_3::g", "amp_short_vectors/Concurrency::graphics::double_3::gr", "amp_short_vectors/Concurrency::graphics::double_3::yz", "amp_short_vectors/Concurrency::graphics::double_3::gbr", "amp_short_vectors/Concurrency::graphics::double_3::xyz", "amp_short_vectors/Concurrency::graphics::double_3::grb", "amp_short_vectors/Concurrency::graphics::double_3::get_z", "amp_short_vectors/Concurrency::graphics::double_3::get_xyz", "amp_short_vectors/Concurrency::graphics::double_3::set_yxz", "amp_short_vectors/Concurrency::graphics::double_3::z", "amp_short_vectors/Concurrency::graphics::double_3::zx", "amp_short_vectors/Concurrency::graphics::double_3::operator+=", "amp_short_vectors/Concurrency::graphics::double_3::rg", "amp_short_vectors/Concurrency::graphics::double_3::get_x", "amp_short_vectors/Concurrency::graphics::double_3::x", "amp_short_vectors/Concurrency::graphics::double_3::set_y", "amp_short_vectors/Concurrency::graphics::double_3::set_yx", "amp_short_vectors/Concurrency::graphics::double_3::operator-=", "amp_short_vectors/Concurrency::graphics::double_3::operator/=", "amp_short_vectors/Concurrency::graphics::double_3::get_y", "amp_short_vectors/Concurrency::graphics::double_3::zy", "amp_short_vectors/Concurrency::graphics::double_3::xy", "amp_short_vectors/Concurrency::graphics::double_3::operator-", "amp_short_vectors/Concurrency::graphics::double_3::bg", "amp_short_vectors/Concurrency::graphics::double_3::get_xz", "amp_short_vectors/Concurrency::graphics::double_3::zxy", "amp_short_vectors/Concurrency::graphics::double_3::set_xzy", "amp_short_vectors/Concurrency::graphics::double_3::set_zx", "amp_short_vectors/Concurrency::graphics::double_3::xzy", "amp_short_vectors/Concurrency::graphics::double_3::get_yzx", "amp_short_vectors/Concurrency::graphics::double_3::br", "amp_short_vectors/Concurrency::graphics::double_3::set_zxy", "amp_short_vectors/Concurrency::graphics::double_3::zyx", "amp_short_vectors/Concurrency::graphics::double_3::get_zx", "amp_short_vectors/Concurrency::graphics::double_3::operator--", "amp_short_vectors/Concurrency::graphics::double_3::b", "amp_short_vectors/Concurrency::graphics::double_3::set_xy", "amp_short_vectors/Concurrency::graphics::double_3::set_x", "amp_short_vectors/Concurrency::graphics::double_3::rb", "amp_short_vectors/Concurrency::graphics::double_3::y", "amp_short_vectors/Concurrency::graphics::double_3::set_xyz", "amp_short_vectors/Concurrency::graphics::double_3::get_xy", "amp_short_vectors/Concurrency::graphics::double_3::operator++", "amp_short_vectors/Concurrency::graphics::double_3::set_z", "amp_short_vectors/Concurrency::graphics::double_3::yx", "amp_short_vectors/Concurrency::graphics::double_3::operator*=", "amp_short_vectors/Concurrency::graphics::double_3::set_zy", "amp_short_vectors/Concurrency::graphics::double_3::rgb", "amp_short_vectors/Concurrency::graphics::double_3::set_zyx", "amp_short_vectors/Concurrency::graphics::double_3::gb", "amp_short_vectors/Concurrency::graphics::double_3::get_zy", "amp_short_vectors/Concurrency::graphics::double_3::get_yz", "amp_short_vectors/Concurrency::graphics::double_3::operator=", "amp_short_vectors/Concurrency::graphics::double_3::yxz", "amp_short_vectors/Concurrency::graphics::double_3::xz", "amp_short_vectors/Concurrency::graphics::double_3::get_zxy", "amp_short_vectors/Concurrency::graphics::double_3::set_yzx", "amp_short_vectors/Concurrency::graphics::double_3::yzx", "amp_short_vectors/Concurrency::graphics::double_3::brg", "amp_short_vectors/Concurrency::graphics::double_3::set_xz", "amp_short_vectors/Concurrency::graphics::double_3::get_yx", "amp_short_vectors/Concurrency::graphics::double_3::rbg", "amp_short_vectors/Concurrency::graphics::double_3::get_yxz"] -ms.assetid: baeb3ff0-2862-4c81-857e-b1a4c085be25 ---- -# double_3 Class - -Represents a short vector of three doubles. - -## Syntax - -```cpp -class double_3; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|value_type|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[double_3 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|double_3::get_x|| -|double_3::get_xy|| -|double_3::get_xyz|| -|double_3::get_xz|| -|double_3::get_xzy|| -|double_3::get_y|| -|double_3::get_yx|| -|double_3::get_yxz|| -|double_3::get_yz|| -|double_3::get_yzx|| -|double_3::get_z|| -|double_3::get_zx|| -|double_3::get_zxy|| -|double_3::get_zy|| -|double_3::get_zyx|| -|double_3::ref_b|| -|double_3::ref_g|| -|double_3::ref_r|| -|double_3::ref_x|| -|double_3::ref_y|| -|double_3::ref_z|| -|double_3::set_x|| -|double_3::set_xy|| -|double_3::set_xyz|| -|double_3::set_xz|| -|double_3::set_xzy|| -|double_3::set_y|| -|double_3::set_yx|| -|double_3::set_yxz|| -|double_3::set_yz|| -|double_3::set_yzx|| -|double_3::set_z|| -|double_3::set_zx|| -|double_3::set_zxy|| -|double_3::set_zy|| -|double_3::set_zyx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|double_3::operator-|| -|double_3::operator--|| -|double_3::operator*=|| -|double_3::operator/=|| -|double_3::operator++|| -|double_3::operator+=|| -|double_3::operator=|| -|double_3::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#double_3__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|double_3::b|| -|double_3::bg|| -|double_3::bgr|| -|double_3::br|| -|double_3::brg|| -|double_3::g|| -|double_3::gb|| -|double_3::gbr|| -|double_3::gr|| -|double_3::grb|| -|double_3::r|| -|double_3::rb|| -|double_3::rbg|| -|double_3::rg|| -|double_3::rgb|| -|double_3::x|| -|double_3::xy|| -|double_3::xyz|| -|double_3::xz|| -|double_3::xzy|| -|double_3::y|| -|double_3::yx|| -|double_3::yxz|| -|double_3::yz|| -|double_3::yzx|| -|double_3::z|| -|double_3::zx|| -|double_3::zxy|| -|double_3::zy|| -|double_3::zyx|| - -## Inheritance Hierarchy - -`double_3` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## double_3 - -Default constructor, initializes all elements with 0. - -```cpp -double_3() restrict(amp, - cpu); - -double_3( - double _V0, - double _V1, - double _V2) restrict(amp, - cpu); - -double_3( - double _V) restrict(amp, - cpu); - -double_3( - const double_3& _Other) restrict(amp, - cpu); - -explicit inline double_3( - const uint_3& _Other) restrict(amp, - cpu); - -explicit inline double_3( - const int_3& _Other) restrict(amp, - cpu); - -explicit inline double_3( - const float_3& _Other) restrict(amp, - cpu); - -explicit inline double_3( - const unorm_3& _Other) restrict(amp, - cpu); - -explicit inline double_3( - const norm_3& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 3; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/double-4-class.md b/docs/parallel/amp/reference/double-4-class.md deleted file mode 100644 index ef7b6325492..00000000000 --- a/docs/parallel/amp/reference/double-4-class.md +++ /dev/null @@ -1,407 +0,0 @@ ---- -description: "Learn more about: double_4 Class" -title: "double_4 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::double_4::get_xw", "amp_short_vectors/Concurrency::graphics::double_4::wxz", "amp_short_vectors/Concurrency::graphics::double_4::rag", "amp_short_vectors/Concurrency::graphics::double_4::wzx", "amp_short_vectors/Concurrency::graphics::double_4::get_yzxw", "amp_short_vectors/Concurrency::graphics::double_4::zxw", "amp_short_vectors/Concurrency::graphics::double_4::set_zwx", "amp_short_vectors/Concurrency::graphics::double_4::get_yxwz", "amp_short_vectors/Concurrency::graphics::double_4::get_wy", "amp_short_vectors/Concurrency::graphics::double_4::set_yx", "amp_short_vectors/Concurrency::graphics::double_4::rbag", "amp_short_vectors/Concurrency::graphics::double_4::ab", "amp_short_vectors/Concurrency::graphics::double_4::ywx", "amp_short_vectors/Concurrency::graphics::double_4::set_xwzy", "amp_short_vectors/Concurrency::graphics::double_4::set_wxyz", "amp_short_vectors/Concurrency::graphics::double_4::xw", "amp_short_vectors/Concurrency::graphics::double_4::set_wxz", "amp_short_vectors/Concurrency::graphics::double_4::ga", "amp_short_vectors/Concurrency::graphics::double_4::yxz", "amp_short_vectors/Concurrency::graphics::double_4::wyx", "amp_short_vectors/Concurrency::graphics::double_4::get_yz", "amp_short_vectors/Concurrency::graphics::double_4::rgba", "amp_short_vectors/Concurrency::graphics::double_4::yzwx", "amp_short_vectors/Concurrency::graphics::double_4::rgb", "amp_short_vectors/Concurrency::graphics::double_4::ywz", "amp_short_vectors/Concurrency::graphics::double_4::set_yw", "amp_short_vectors/Concurrency::graphics::double_4::get_yw", "amp_short_vectors/Concurrency::graphics::double_4::get_xy", "amp_short_vectors/Concurrency::graphics::double_4::set_zwxy", "amp_short_vectors/Concurrency::graphics::double_4::arb", "amp_short_vectors/Concurrency::graphics::double_4::abgr", "amp_short_vectors/Concurrency::graphics::double_4::xwyz", "amp_short_vectors/Concurrency::graphics::double_4::get_wxy", "amp_short_vectors/Concurrency::graphics::double_4::wzyx", "amp_short_vectors/Concurrency::graphics::double_4::zwx", "amp_short_vectors/Concurrency::graphics::double_4::wyz", "amp_short_vectors/Concurrency::graphics::double_4::xwz", "amp_short_vectors/Concurrency::graphics::double_4::set_wy", "amp_short_vectors/Concurrency::graphics::double_4::g", "amp_short_vectors/Concurrency::graphics::double_4::set_zxwy", "amp_short_vectors/Concurrency::graphics::double_4::abg", "amp_short_vectors/Concurrency::graphics::double_4::xzyw", "amp_short_vectors/Concurrency::graphics::double_4::operator++", "amp_short_vectors/Concurrency::graphics::double_4::get_yzx", "amp_short_vectors/Concurrency::graphics::double_4::set_wzx", "amp_short_vectors/Concurrency::graphics::double_4::arg", "amp_short_vectors/Concurrency::graphics::double_4::rab", "amp_short_vectors/Concurrency::graphics::double_4::set_zwyx", "amp_short_vectors/Concurrency::graphics::double_4::ba", "amp_short_vectors/Concurrency::graphics::double_4::w", "amp_short_vectors/Concurrency::graphics::double_4::set_yxwz", "amp_short_vectors/Concurrency::graphics::double_4::ywxz", "amp_short_vectors/Concurrency::graphics::double_4::bar", "amp_short_vectors/Concurrency::graphics::double_4::set_xz", "amp_short_vectors/Concurrency::graphics::double_4::yxzw", "amp_short_vectors/Concurrency::graphics::double_4::get_xzyw", "amp_short_vectors/Concurrency::graphics::double_4::get_wxzy", "amp_short_vectors/Concurrency::graphics::double_4::garb", "amp_short_vectors/Concurrency::graphics::double_4::zwyx", "amp_short_vectors/Concurrency::graphics::double_4::set_yxz", "amp_short_vectors/Concurrency::graphics::double_4::get_xzw", "amp_short_vectors/Concurrency::graphics::double_4::wzy", "amp_short_vectors/Concurrency::graphics::double_4::get_xz", "amp_short_vectors/Concurrency::graphics::double_4::barg", "amp_short_vectors/Concurrency::graphics::double_4::get_zwyx", "amp_short_vectors/Concurrency::graphics::double_4::operator-=", "amp_short_vectors/Concurrency::graphics::double_4::set_yzwx", "amp_short_vectors/Concurrency::graphics::double_4::get_wxz", "amp_short_vectors/Concurrency::graphics::double_4::gabr", "amp_short_vectors/Concurrency::graphics::double_4::set_wxzy", "amp_short_vectors/Concurrency::graphics::double_4::operator/=", "amp_short_vectors/Concurrency::graphics::double_4::zxy", "amp_short_vectors/Concurrency::graphics::double_4::set_zx", "amp_short_vectors/Concurrency::graphics::double_4::get_ywzx", "amp_short_vectors/Concurrency::graphics::double_4::grab", "amp_short_vectors/Concurrency::graphics::double_4::set_ywzx", "amp_short_vectors/Concurrency::graphics::double_4::get_zy", "amp_short_vectors/Concurrency::graphics::double_4::wxzy", "amp_short_vectors/Concurrency::graphics::double_4::yzx", "amp_short_vectors/Concurrency::graphics::double_4::brag", "amp_short_vectors/Concurrency::graphics::double_4::get_wyz", "amp_short_vectors/Concurrency::graphics::double_4::set_yxw", "amp_short_vectors/Concurrency::graphics::double_4::set_xzw", "amp_short_vectors/Concurrency::graphics::double_4::get_zx", "amp_short_vectors/Concurrency::graphics::double_4::get_zxyw", "amp_short_vectors/Concurrency::graphics::double_4::get_zyxw", "amp_short_vectors/Concurrency::graphics::double_4::set_xzwy", "amp_short_vectors/Concurrency::graphics::double_4::get_xyzw", "amp_short_vectors/Concurrency::graphics::double_4::get_xywz", "amp_short_vectors/Concurrency::graphics::double_4::operator-", "amp_short_vectors/Concurrency::graphics::double_4::bga", "amp_short_vectors/Concurrency::graphics::double_4::bgra", "amp_short_vectors/Concurrency::graphics::double_4::set_yzxw", "amp_short_vectors/Concurrency::graphics::double_4::abr", "amp_short_vectors/Concurrency::graphics::double_4::brga", "amp_short_vectors/Concurrency::graphics::double_4::rga", "amp_short_vectors/Concurrency::graphics::double_4::yxw", "amp_short_vectors/Concurrency::graphics::double_4::abrg", "amp_short_vectors/Concurrency::graphics::double_4::gbr", "amp_short_vectors/Concurrency::graphics::double_4::set_wzyx", "amp_short_vectors/Concurrency::graphics::double_4::set_zyxw", "amp_short_vectors/Concurrency::graphics::double_4::xz", "amp_short_vectors/Concurrency::graphics::double_4::get_zxy", "amp_short_vectors/Concurrency::graphics::double_4::set_zw", "amp_short_vectors/Concurrency::graphics::double_4::wy", "amp_short_vectors/Concurrency::graphics::double_4::zx", "amp_short_vectors/Concurrency::graphics::double_4::set_xy", "amp_short_vectors/Concurrency::graphics::double_4::rabg", "amp_short_vectors/Concurrency::graphics::double_4::set_zwy", "amp_short_vectors/Concurrency::graphics::double_4::xzwy", "amp_short_vectors/Concurrency::graphics::double_4::bgar", "amp_short_vectors/Concurrency::graphics::double_4::operator+=", "amp_short_vectors/Concurrency::graphics::double_4::get_xwz", "amp_short_vectors/Concurrency::graphics::double_4::operator*=", "amp_short_vectors/Concurrency::graphics::double_4::get_yxw", "amp_short_vectors/Concurrency::graphics::double_4::y", "amp_short_vectors/Concurrency::graphics::double_4::set_zy", "amp_short_vectors/Concurrency::graphics::double_4::wzxy", "amp_short_vectors/Concurrency::graphics::double_4::get_xwy", "amp_short_vectors/Concurrency::graphics::double_4::xzy", "amp_short_vectors/Concurrency::graphics::double_4::set_zywx", "amp_short_vectors/Concurrency::graphics::double_4::yxwz", "amp_short_vectors/Concurrency::graphics::double_4::ragb", "amp_short_vectors/Concurrency::graphics::double_4::get_zyx", "amp_short_vectors/Concurrency::graphics::double_4::agb", "amp_short_vectors/Concurrency::graphics::double_4::gar", "amp_short_vectors/Concurrency::graphics::double_4::get_wyxz", "amp_short_vectors/Concurrency::graphics::double_4::a", "amp_short_vectors/Concurrency::graphics::double_4::set_wyx", "amp_short_vectors/Concurrency::graphics::double_4::rg", "amp_short_vectors/Concurrency::graphics::double_4::set_xzyw", "amp_short_vectors/Concurrency::graphics::double_4::get_ywx", "amp_short_vectors/Concurrency::graphics::double_4::yx", "amp_short_vectors/Concurrency::graphics::double_4::get_wyzx", "amp_short_vectors/Concurrency::graphics::double_4::set_w", "amp_short_vectors/Concurrency::graphics::double_4::set_zyx", "amp_short_vectors/Concurrency::graphics::double_4::set_wyz", "amp_short_vectors/Concurrency::graphics::double_4::set_wzxy", "amp_short_vectors/Concurrency::graphics::double_4::wyzx", "amp_short_vectors/Concurrency::graphics::double_4::gbar", "amp_short_vectors/Concurrency::graphics::double_4::operator=", "amp_short_vectors/Concurrency::graphics::double_4::x", "amp_short_vectors/Concurrency::graphics::double_4::get_y", "amp_short_vectors/Concurrency::graphics::double_4::set_wx", "amp_short_vectors/Concurrency::graphics::double_4::get_zyw", "amp_short_vectors/Concurrency::graphics::double_4::set_xywz", "amp_short_vectors/Concurrency::graphics::double_4::zyxw", "amp_short_vectors/Concurrency::graphics::double_4::get_zywx", "amp_short_vectors/Concurrency::graphics::double_4::yzw", "amp_short_vectors/Concurrency::graphics::double_4::xyw", "amp_short_vectors/Concurrency::graphics::double_4::bra", "amp_short_vectors/Concurrency::graphics::double_4::agr", "amp_short_vectors/Concurrency::graphics::double_4::zw", "amp_short_vectors/Concurrency::graphics::double_4::get_xwyz", "amp_short_vectors/Concurrency::graphics::double_4::gbra", "amp_short_vectors/Concurrency::graphics::double_4::get_wz", "amp_short_vectors/Concurrency::graphics::double_4::brg", "amp_short_vectors/Concurrency::graphics::double_4::xyz", "amp_short_vectors/Concurrency::graphics::double_4::set_y", "amp_short_vectors/Concurrency::graphics::double_4::set_wyxz", "amp_short_vectors/Concurrency::graphics::double_4::set_z", "amp_short_vectors/Concurrency::graphics::double_4::zwxy", "amp_short_vectors/Concurrency::graphics::double_4::get_ywxz", "amp_short_vectors/Concurrency::graphics::double_4::set_xwy", "amp_short_vectors/Concurrency::graphics::double_4::xyzw", "amp_short_vectors/Concurrency::graphics::double_4::get_x", "amp_short_vectors/Concurrency::graphics::double_4::get_zw", "amp_short_vectors/Concurrency::graphics::double_4::rbga", "amp_short_vectors/Concurrency::graphics::double_4::gr", "amp_short_vectors/Concurrency::graphics::double_4::set_xyzw", "amp_short_vectors/Concurrency::graphics::double_4::get_xzwy", "amp_short_vectors/Concurrency::graphics::double_4::gb", "amp_short_vectors/Concurrency::graphics::double_4::zxyw", "amp_short_vectors/Concurrency::graphics::double_4::set_zxw", "amp_short_vectors/Concurrency::graphics::double_4::gab", "amp_short_vectors/Concurrency::graphics::double_4::xwy", "amp_short_vectors/Concurrency::graphics::double_4::wxyz", "amp_short_vectors/Concurrency::graphics::double_4::wx", "amp_short_vectors/Concurrency::graphics::double_4::gra", "amp_short_vectors/Concurrency::graphics::double_4::xwzy", "amp_short_vectors/Concurrency::graphics::double_4::wxy", "amp_short_vectors/Concurrency::graphics::double_4::set_ywz", "amp_short_vectors/Concurrency::graphics::double_4::set_xw", "amp_short_vectors/Concurrency::graphics::double_4::set_yxzw", "amp_short_vectors/Concurrency::graphics::double_4::set_zyw", "amp_short_vectors/Concurrency::graphics::double_4::get_zwy", "amp_short_vectors/Concurrency::graphics::double_4::agrb", "amp_short_vectors/Concurrency::graphics::double_4::get_yxzw", "amp_short_vectors/Concurrency::graphics::double_4::grb", "amp_short_vectors/Concurrency::graphics::double_4::get_yx", "amp_short_vectors/Concurrency::graphics::double_4::gba", "amp_short_vectors/Concurrency::graphics::double_4::set_ywxz", "amp_short_vectors/Concurrency::graphics::double_4::ywzx", "amp_short_vectors/Concurrency::graphics::double_4::yzxw", "amp_short_vectors/Concurrency::graphics::double_4::zyx", "amp_short_vectors/Concurrency::graphics::double_4::get_yxz", "amp_short_vectors/Concurrency::graphics::double_4::set_yzw", "amp_short_vectors/Concurrency::graphics::double_4::xzw", "amp_short_vectors/Concurrency::graphics::double_4::wz", "amp_short_vectors/Concurrency::graphics::double_4::yw", "amp_short_vectors/Concurrency::graphics::double_4::set_zxyw", "amp_short_vectors/Concurrency::graphics::double_4::get_yzw", "amp_short_vectors/Concurrency::graphics::double_4::get_xyw", "amp_short_vectors/Concurrency::graphics::double_4::get_wzx", "amp_short_vectors/Concurrency::graphics::double_4::argb", "amp_short_vectors/Concurrency::graphics::double_4::set_ywx", "amp_short_vectors/Concurrency::graphics::double_4::get_zwx", "amp_short_vectors/Concurrency::graphics::double_4::set_xyw", "amp_short_vectors/Concurrency::graphics::double_4::r", "amp_short_vectors/Concurrency::graphics::double_4::set_yzx", "amp_short_vectors/Concurrency::graphics::double_4::agbr", "amp_short_vectors/Concurrency::graphics::double_4::set_wzy", "amp_short_vectors/Concurrency::graphics::double_4::xywz", "amp_short_vectors/Concurrency::graphics::double_4::set_wyzx", "amp_short_vectors/Concurrency::graphics::double_4::grba", "amp_short_vectors/Concurrency::graphics::double_4::bg", "amp_short_vectors/Concurrency::graphics::double_4::get_zwxy", "amp_short_vectors/Concurrency::graphics::double_4::get_wyx", "amp_short_vectors/Concurrency::graphics::double_4::get_zxwy", "amp_short_vectors/Concurrency::graphics::double_4::set_zxy", "amp_short_vectors/Concurrency::graphics::double_4::get_w", "amp_short_vectors/Concurrency::graphics::double_4", "amp_short_vectors/Concurrency::graphics::double_4::set_x", "amp_short_vectors/Concurrency::graphics::double_4::bgr", "amp_short_vectors/Concurrency::graphics::double_4::xy", "amp_short_vectors/Concurrency::graphics::double_4::yz", "amp_short_vectors/Concurrency::graphics::double_4::get_wzxy", "amp_short_vectors/Concurrency::graphics::double_4::rbg", "amp_short_vectors/Concurrency::graphics::double_4::get_xzy", "amp_short_vectors/Concurrency::graphics::double_4::operator--", "amp_short_vectors/Concurrency::graphics::double_4::z", "amp_short_vectors/Concurrency::graphics::double_4::b", "amp_short_vectors/Concurrency::graphics::double_4::set_wz", "amp_short_vectors/Concurrency::graphics::double_4::arbg", "amp_short_vectors/Concurrency::graphics::double_4::rba", "amp_short_vectors/Concurrency::graphics::double_4::get_zxw", "amp_short_vectors/Concurrency::graphics::double_4::get_wxyz", "amp_short_vectors/Concurrency::graphics::double_4::ag", "amp_short_vectors/Concurrency::graphics::double_4::zxwy", "amp_short_vectors/Concurrency::graphics::double_4::get_ywz", "amp_short_vectors/Concurrency::graphics::double_4::get_xyz", "amp_short_vectors/Concurrency::graphics::double_4::get_wzy", "amp_short_vectors/Concurrency::graphics::double_4::zy", "amp_short_vectors/Concurrency::graphics::double_4::set_xyz", "amp_short_vectors/Concurrency::graphics::double_4::set_wxy", "amp_short_vectors/Concurrency::graphics::double_4::get_wx", "amp_short_vectors/Concurrency::graphics::double_4::rb", "amp_short_vectors/Concurrency::graphics::double_4::get_wzyx", "amp_short_vectors/Concurrency::graphics::double_4::get_yzwx", "amp_short_vectors/Concurrency::graphics::double_4::rgab", "amp_short_vectors/Concurrency::graphics::double_4::set_xwz", "amp_short_vectors/Concurrency::graphics::double_4::get_z", "amp_short_vectors/Concurrency::graphics::double_4::br", "amp_short_vectors/Concurrency::graphics::double_4::bagr", "amp_short_vectors/Concurrency::graphics::double_4::zywx", "amp_short_vectors/Concurrency::graphics::double_4::set_xzy", "amp_short_vectors/Concurrency::graphics::double_4::set_yz", "amp_short_vectors/Concurrency::graphics::double_4::zyw", "amp_short_vectors/Concurrency::graphics::double_4::ar", "amp_short_vectors/Concurrency::graphics::double_4::wyxz", "amp_short_vectors/Concurrency::graphics::double_4::get_xwzy", "amp_short_vectors/Concurrency::graphics::double_4::ra", "amp_short_vectors/Concurrency::graphics::double_4::set_xwyz", "amp_short_vectors/Concurrency::graphics::double_4::bag", "amp_short_vectors/Concurrency::graphics::double_4::zwy"] -ms.assetid: a81c1595-24c6-4b3f-9574-d5942275e5e8 ---- -# double_4 Class - -Represents a short vector of four doubles. - -## Syntax - -```cpp -class double_4; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[double_4 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|double_4::get_w|| -|double_4::get_wx|| -|double_4::get_wxy|| -|double_4::get_wxyz|| -|double_4::get_wxz|| -|double_4::get_wxzy|| -|double_4::get_wy|| -|double_4::get_wyx|| -|double_4::get_wyxz|| -|double_4::get_wyz|| -|double_4::get_wyzx|| -|double_4::get_wz|| -|double_4::get_wzx|| -|double_4::get_wzxy|| -|double_4::get_wzy|| -|double_4::get_wzyx|| -|double_4::get_x|| -|double_4::get_xw|| -|double_4::get_xwy|| -|double_4::get_xwyz|| -|double_4::get_xwz|| -|double_4::get_xwzy|| -|double_4::get_xy|| -|double_4::get_xyw|| -|double_4::get_xywz|| -|double_4::get_xyz|| -|double_4::get_xyzw|| -|double_4::get_xz|| -|double_4::get_xzw|| -|double_4::get_xzwy|| -|double_4::get_xzy|| -|double_4::get_xzyw|| -|double_4::get_y|| -|double_4::get_yw|| -|double_4::get_ywx|| -|double_4::get_ywxz|| -|double_4::get_ywz|| -|double_4::get_ywzx|| -|double_4::get_yx|| -|double_4::get_yxw|| -|double_4::get_yxwz|| -|double_4::get_yxz|| -|double_4::get_yxzw|| -|double_4::get_yz|| -|double_4::get_yzw|| -|double_4::get_yzwx|| -|double_4::get_yzx|| -|double_4::get_yzxw|| -|double_4::get_z|| -|double_4::get_zw|| -|double_4::get_zwx|| -|double_4::get_zwxy|| -|double_4::get_zwy|| -|double_4::get_zwyx|| -|double_4::get_zx|| -|double_4::get_zxw|| -|double_4::get_zxwy|| -|double_4::get_zxy|| -|double_4::get_zxyw|| -|double_4::get_zy|| -|double_4::get_zyw|| -|double_4::get_zywx|| -|double_4::get_zyx|| -|double_4::get_zyxw|| -|double_4::ref_a|| -|double_4::ref_b|| -|double_4::ref_g|| -|double_4::ref_r|| -|double_4::ref_w|| -|double_4::ref_x|| -|double_4::ref_y|| -|double_4::ref_z|| -|double_4::set_w|| -|double_4::set_wx|| -|double_4::set_wxy|| -|double_4::set_wxyz|| -|double_4::set_wxz|| -|double_4::set_wxzy|| -|double_4::set_wy|| -|double_4::set_wyx|| -|double_4::set_wyxz|| -|double_4::set_wyz|| -|double_4::set_wyzx|| -|double_4::set_wz|| -|double_4::set_wzx|| -|double_4::set_wzxy|| -|double_4::set_wzy|| -|double_4::set_wzyx|| -|double_4::set_x|| -|double_4::set_xw|| -|double_4::set_xwy|| -|double_4::set_xwyz|| -|double_4::set_xwz|| -|double_4::set_xwzy|| -|double_4::set_xy|| -|double_4::set_xyw|| -|double_4::set_xywz|| -|double_4::set_xyz|| -|double_4::set_xyzw|| -|double_4::set_xz|| -|double_4::set_xzw|| -|double_4::set_xzwy|| -|double_4::set_xzy|| -|double_4::set_xzyw|| -|double_4::set_y|| -|double_4::set_yw|| -|double_4::set_ywx|| -|double_4::set_ywxz|| -|double_4::set_ywz|| -|double_4::set_ywzx|| -|double_4::set_yx|| -|double_4::set_yxw|| -|double_4::set_yxwz|| -|double_4::set_yxz|| -|double_4::set_yxzw|| -|double_4::set_yz|| -|double_4::set_yzw|| -|double_4::set_yzwx|| -|double_4::set_yzx|| -|double_4::set_yzxw|| -|double_4::set_z|| -|double_4::set_zw|| -|double_4::set_zwx|| -|double_4::set_zwxy|| -|double_4::set_zwy|| -|double_4::set_zwyx|| -|double_4::set_zx|| -|double_4::set_zxw|| -|double_4::set_zxwy|| -|double_4::set_zxy|| -|double_4::set_zxyw|| -|double_4::set_zy|| -|double_4::set_zyw|| -|double_4::set_zywx|| -|double_4::set_zyx|| -|double_4::set_zyxw|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|double_4::operator-|| -|double_4::operator--|| -|double_4::operator*=|| -|double_4::operator/=|| -|double_4::operator++|| -|double_4::operator+=|| -|double_4::operator=|| -|double_4::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#double_4__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|double_4::a|| -|double_4::ab|| -|double_4::abg|| -|double_4::abgr|| -|double_4::abr|| -|double_4::abrg|| -|double_4::ag|| -|double_4::agb|| -|double_4::agbr|| -|double_4::agr|| -|double_4::agrb|| -|double_4::ar|| -|double_4::arb|| -|double_4::arbg|| -|double_4::arg|| -|double_4::argb|| -|double_4::b|| -|double_4::ba|| -|double_4::bag|| -|double_4::bagr|| -|double_4::bar|| -|double_4::barg|| -|double_4::bg|| -|double_4::bga|| -|double_4::bgar|| -|double_4::bgr|| -|double_4::bgra|| -|double_4::br|| -|double_4::bra|| -|double_4::brag|| -|double_4::brg|| -|double_4::brga|| -|double_4::g|| -|double_4::ga|| -|double_4::gab|| -|double_4::gabr|| -|double_4::gar|| -|double_4::garb|| -|double_4::gb|| -|double_4::gba|| -|double_4::gbar|| -|double_4::gbr|| -|double_4::gbra|| -|double_4::gr|| -|double_4::gra|| -|double_4::grab|| -|double_4::grb|| -|double_4::grba|| -|double_4::r|| -|double_4::ra|| -|double_4::rab|| -|double_4::rabg|| -|double_4::rag|| -|double_4::ragb|| -|double_4::rb|| -|double_4::rba|| -|double_4::rbag|| -|double_4::rbg|| -|double_4::rbga|| -|double_4::rg|| -|double_4::rga|| -|double_4::rgab|| -|double_4::rgb|| -|double_4::rgba|| -|double_4::w|| -|double_4::wx|| -|double_4::wxy|| -|double_4::wxyz|| -|double_4::wxz|| -|double_4::wxzy|| -|double_4::wy|| -|double_4::wyx|| -|double_4::wyxz|| -|double_4::wyz|| -|double_4::wyzx|| -|double_4::wz|| -|double_4::wzx|| -|double_4::wzxy|| -|double_4::wzy|| -|double_4::wzyx|| -|double_4::x|| -|double_4::xw|| -|double_4::xwy|| -|double_4::xwyz|| -|double_4::xwz|| -|double_4::xwzy|| -|double_4::xy|| -|double_4::xyw|| -|double_4::xywz|| -|double_4::xyz|| -|double_4::xyzw|| -|double_4::xz|| -|double_4::xzw|| -|double_4::xzwy|| -|double_4::xzy|| -|double_4::xzyw|| -|double_4::y|| -|double_4::yw|| -|double_4::ywx|| -|double_4::ywxz|| -|double_4::ywz|| -|double_4::ywzx|| -|double_4::yx|| -|double_4::yxw|| -|double_4::yxwz|| -|double_4::yxz|| -|double_4::yxzw|| -|double_4::yz|| -|double_4::yzw|| -|double_4::yzwx|| -|double_4::yzx|| -|double_4::yzxw|| -|double_4::z|| -|double_4::zw|| -|double_4::zwx|| -|double_4::zwxy|| -|double_4::zwy|| -|double_4::zwyx|| -|double_4::zx|| -|double_4::zxw|| -|double_4::zxwy|| -|double_4::zxy|| -|double_4::zxyw|| -|double_4::zy|| -|double_4::zyw|| -|double_4::zywx|| -|double_4::zyx|| -|double_4::zyxw|| - -## Inheritance Hierarchy - -`double_4` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## double_4 - -Default constructor, initializes all elements with 0. - -```cpp -double_4() restrict(amp, - cpu); - -double_4( - double _V0, - double _V1, - double _V2, - double _V3) restrict(amp, - cpu); - -double_4( - double _V) restrict(amp, - cpu); - -double_4( - const double_4& _Other) restrict(amp, - cpu); - -explicit inline double_4( - const uint_4& _Other) restrict(amp, - cpu); - -explicit inline double_4( - const int_4& _Other) restrict(amp, - cpu); - -explicit inline double_4( - const float_4& _Other) restrict(amp, - cpu); - -explicit inline double_4( - const unorm_4& _Other) restrict(amp, - cpu); - -explicit inline double_4( - const norm_4& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V3*
-The value to initialize element 3. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 4; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/extent-class.md b/docs/parallel/amp/reference/extent-class.md deleted file mode 100644 index f547bd38c0f..00000000000 --- a/docs/parallel/amp/reference/extent-class.md +++ /dev/null @@ -1,386 +0,0 @@ ---- -title: "extent Class (C++ AMP)" -description: "Learn more about: extent Class (C++ AMP)" -ms.date: 03/27/2019 -f1_keywords: ["extent", "AMP/extent", "AMP/Concurrency::extent::extent", "AMP/Concurrency::extent::contains", "AMP/Concurrency::extent::size", "AMP/Concurrency::extent::tile", "AMP/Concurrency::extent::rank Constant"] -helpviewer_keywords: ["extent structure"] ---- -# extent Class (C++ AMP) - -Represents a vector of *N* integer values that specify the bounds of an *N*-dimensional space that has an origin of 0. The values in the vector are ordered from most significant to least significant. - -## Syntax - -```cpp -template -class extent; -``` - -### Parameters - -*_Rank*
-The rank of the `extent` object. - -## Requirements - -**Header:** amp.h - -**Namespace:** Concurrency - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[extent Constructor](#ctor)|Initializes a new instance of the `extent` class.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[contains](#contains)|Verifies that the specified `extent` object has the specified rank.| -|[size](#size)|Returns the total linear size of the extent (in units of elements).| -|[tile](#tile)|Produces a `tiled_extent` object with the tile extents given by specified dimensions.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator-](#operator_min)|Returns a new `extent` object that's created by subtracting the `index` elements from the corresponding `extent` elements.| -|[operator--](#operator_min_min)|Decrements each element of the `extent` object.| -|[operator%=](#operator_mod_eq)|Calculates the modulus (remainder) of each element in the `extent` object when that element is divided by a number.| -|[operator*=](#operator_star_eq)|Multiplies each element of the `extent` object by a number.| -|[operator/=](#operator_min_eq)|Divides each element of the `extent` object by a number.| -|[extent::operator\[\]](#operator_at)|Returns the element that's at the specified index.| -|[operator+](#operator_add)|Returns a new `extent` object that's created by adding the corresponding `index` and `extent` elements.| -|[operator++](#operator_add_add)|Increments each element of the `extent` object.| -|[operator+=](#operator_add_eq)|Adds the specified number to each element of the `extent` object.| -|[operator=](#operator_eq)|Copies the contents of another `extent` object into this one.| -|[operator-=](#operator_min_eq)|Subtracts the specified number from each element of the `extent` object.| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[rank Constant](#rank_constant)|Gets the rank of the `extent` object.| - -## Inheritance Hierarchy - -`extent` - -## contains - -Indicates whether the specified [index](index-class.md) value is contained within the `extent` object. - -### Syntax - -```cpp -bool contains(const index& _Index) const restrict(amp,cpu); -``` - -### Parameters - -*_Index*
-The `index` value to test. - -### Return Value - -**`true`** if the specified *index* value is contained in the `extent` object; otherwise, **`false`**. - -## extent - -Initializes a new instance of the `extent` class. - -### Syntax - -```cpp -extent() restrict(amp,cpu); -extent(const extent<_Rank>& _Other) restrict(amp,cpu); -explicit extent(int _I) restrict(amp,cpu); -extent(int _I0, int _I1) restrict(amp,cpu); -extent(int _I0, int _I1, int _I2) restrict(amp,cpu); -explicit extent(const int _Array[_Rank])restrict(amp,cpu); -``` - -### Parameters - -*_Array*
-An array of `_Rank` integers that is used to create the new `extent` object. - -*_I*
-The length of the extent. - -*_I0*
-The length of the most significant dimension. - -*_I1*
-The length of the next-to-most-significant dimension. - -*_I2*
-The length of the least significant dimension. - -*_Other*
-An `extent` object on which the new `extent` object is based. - -## Remarks - -The default constructor initializes an `extent` object that has a rank of three. - -If an array is used to construct an `extent` object, the length of the array must match the rank of the `extent` object. - -## operator%= - -Calculates the modulus (remainder) of each element in the `extent` when that element is divided by a number. - -### Syntax - -```cpp -extent<_Rank>& operator%=(int _Rhs) restrict(cpu, direct3d); -``` - -### Parameters - -*_Rhs*
-The number to find the modulus of. - -### Return Value - -The `extent` object. - -## operator*= - -Multiplies each element in the `extent` object by the specified number. - -### Syntax - -```cpp -extent<_Rank>& operator*=(int _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The number to multiply. - -### Return Value - -The `extent` object. - -## operator+ - -Returns a new `extent` object created by adding the corresponding `index` and `extent` elements. - -### Syntax - -```cpp -extent<_Rank> operator+(const index<_Rank>& _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The `index` object that contains the elements to add. - -### Return Value - -The new `extent` object. - -## operator++ - -Increments each element of the `extent` object. - -### Syntax - -```cpp -extent<_Rank>& operator++() restrict(amp,cpu); -extent<_Rank> operator++(int)restrict(amp,cpu); -``` - -### Return Value - -For the prefix operator, the `extent` object (**`*this`**). For the suffix operator, a new `extent` object. - -## operator+= - -Adds the specified number to each element of the `extent` object. - -### Syntax - -```cpp -extent<_Rank>& operator+=(const extent<_Rank>& _Rhs) restrict(amp,cpu); -extent<_Rank>& operator+=(const index<_Rank>& _Rhs) restrict(amp,cpu); -extent<_Rank>& operator+=(int _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The number, index, or extent to add. - -### Return Value - -The resulting `extent` object. - -## operator- - -Creates a new `extent` object by subtracting each element in the specified `index` object from the corresponding element in this `extent` object. - -### Syntax - -```cpp -extent<_Rank> operator-(const index<_Rank>& _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The `index` object that contains the elements to subtract. - -### Return Value - -The new `extent` object. - -## operator-- - -Decrements each element in the `extent` object. - -### Syntax - -```cpp -extent<_Rank>& operator--() restrict(amp,cpu); -extent<_Rank> operator--(int)restrict(amp,cpu); -``` - -### Return Value - -For the prefix operator, the `extent` object (**`*this`**). For the suffix operator, a new `extent` object. - -## operator/= - -Divides each element in the `extent` object by the specified number. - -### Syntax - -```cpp -extent<_Rank>& operator/=(int _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The number to divide by. - -### Return Value - -The `extent` object. - -## operator-= - -Subtracts the specified number from each element of the `extent` object. - -### Syntax - -```cpp -extent<_Rank>& operator-=(const extent<_Rank>& _Rhs) restrict(amp,cpu); -extent<_Rank>& operator-=(const index<_Rank>& _Rhs) restrict(amp,cpu); -extent<_Rank>& operator-=(int _Rhs) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The number to subtract. - -### Return Value - -The resulting `extent` object. - -## operator= - -Copies the contents of another `extent` object into this one. - -### Syntax - -```cpp -extent<_Rank>& operator=(const extent<_Rank>& _Other) restrict(amp,cpu); -``` - -### Parameters - -*_Other*
-The `extent` object to copy from. - -### Return Value - -A reference to this `extent` object. - -## extent::operator \[\] - -Returns the element that's at the specified index. - -### Syntax - -```cpp -int operator[](unsigned int _Index) const restrict(amp,cpu); -int& operator[](unsigned int _Index) restrict(amp,cpu); -``` - -### Parameters - -*_Index*
-An integer from 0 through the rank minus 1. - -### Return Value - -The element that's at the specified index. - -## rank - -Stores the rank of the `extent` object. - -### Syntax - -```cpp -static const int rank = _Rank; -``` - -## size - -Returns the total linear size of the `extent` object (in units of elements). - -### Syntax - -```cpp -unsigned int size() const restrict(amp,cpu); -``` - -## tile - -Produces a tiled_extent object with the specified tile dimensions. - -```cpp -template -tiled_extent<_Dim0> tile() const ; - -template -tiled_extent<_Dim0, _Dim1> tile() const ; - -template -tiled_extent<_Dim0, _Dim1, _Dim2> tile() const ; -``` - -### Parameters - -*_Dim0*
-The most significant component of the tiled extent. - -*_Dim1*
-The next-to-most-significant component of the tiled extent. - -*_Dim2*
-The least significant component of the tiled extent. - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/float-2-class.md b/docs/parallel/amp/reference/float-2-class.md deleted file mode 100644 index 4f6befc7b98..00000000000 --- a/docs/parallel/amp/reference/float-2-class.md +++ /dev/null @@ -1,155 +0,0 @@ ---- -description: "Learn more about: float_2 Class" -title: "float_2 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::float_2::yx", "amp_short_vectors/Concurrency::graphics::float_2::operator-=", "amp_short_vectors/Concurrency::graphics::float_2::operator++", "amp_short_vectors/Concurrency::graphics::float_2::operator-", "amp_short_vectors/Concurrency::graphics::float_2::r", "amp_short_vectors/Concurrency::graphics::float_2::get_yx", "amp_short_vectors/Concurrency::graphics::float_2::get_xy", "amp_short_vectors/Concurrency::graphics::float_2::operator/=", "amp_short_vectors/Concurrency::graphics::float_2::set_yx", "amp_short_vectors/Concurrency::graphics::float_2::x", "amp_short_vectors/Concurrency::graphics::float_2::get_y", "amp_short_vectors/Concurrency::graphics::float_2::operator+=", "amp_short_vectors/Concurrency::graphics::float_2::gr", "amp_short_vectors/Concurrency::graphics::float_2::operator=", "amp_short_vectors/Concurrency::graphics::float_2::set_x", "amp_short_vectors/Concurrency::graphics::float_2::operator--", "amp_short_vectors/Concurrency::graphics::float_2::get_x", "amp_short_vectors/Concurrency::graphics::float_2::operator*=", "amp_short_vectors/Concurrency::graphics::float_2::rg", "amp_short_vectors/Concurrency::graphics::float_2::set_xy", "amp_short_vectors/Concurrency::graphics::float_2::xy", "amp_short_vectors/Concurrency::graphics::float_2", "amp_short_vectors/Concurrency::graphics::float_2::set_y", "amp_short_vectors/Concurrency::graphics::float_2::y", "amp_short_vectors/Concurrency::graphics::float_2::g"] -ms.assetid: b3ebd48e-f8c8-4f00-a640-357f702f0cae ---- -# float_2 Class - -Represents a short vector of two floats. - -## Syntax - -```cpp -class float_2; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[float_2 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|float_2::get_x|| -|float_2::get_xy|| -|float_2::get_y|| -|float_2::get_yx|| -|float_2::ref_g|| -|float_2::ref_r|| -|float_2::ref_x|| -|float_2::ref_y|| -|float_2::set_x|| -|float_2::set_xy|| -|float_2::set_y|| -|float_2::set_yx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|float_2::operator-|| -|float_2::operator--|| -|float_2::operator*=|| -|float_2::operator/=|| -|float_2::operator++|| -|float_2::operator+=|| -|float_2::operator=|| -|float_2::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#float_2__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|float_2::g|| -|float_2::gr|| -|float_2::r|| -|float_2::rg|| -|float_2::x|| -|float_2::xy|| -|float_2::y|| -|float_2::yx|| - -## Inheritance Hierarchy - -`float_2` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## float_2 - -Default constructor, initializes all elements with 0. - -```cpp -float_2() restrict(amp, - cpu); - -float_2( - float _V0, - float _V1) restrict(amp, - cpu); - -float_2( - float _V) restrict(amp, - cpu); - -float_2( - const float_2& _Other) restrict(amp, - cpu); - -explicit inline float_2( - const uint_2& _Other) restrict(amp, - cpu); - -explicit inline float_2( - const int_2& _Other) restrict(amp, - cpu); - -explicit inline float_2( - const unorm_2& _Other) restrict(amp, - cpu); - -explicit inline float_2( - const norm_2& _Other) restrict(amp, - cpu); - -explicit inline float_2( - const double_2& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 2; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/float-3-class.md b/docs/parallel/amp/reference/float-3-class.md deleted file mode 100644 index 0a4ac77c7da..00000000000 --- a/docs/parallel/amp/reference/float-3-class.md +++ /dev/null @@ -1,206 +0,0 @@ ---- -description: "Learn more about: float_3 Class" -title: "float_3 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::float_3::get_zyx", "amp_short_vectors/Concurrency::graphics::float_3::set_y", "amp_short_vectors/Concurrency::graphics::float_3::b", "amp_short_vectors/Concurrency::graphics::float_3::operator-=", "amp_short_vectors/Concurrency::graphics::float_3::get_y", "amp_short_vectors/Concurrency::graphics::float_3::set_zy", "amp_short_vectors/Concurrency::graphics::float_3::get_yzx", "amp_short_vectors/Concurrency::graphics::float_3::xz", "amp_short_vectors/Concurrency::graphics::float_3::xyz", "amp_short_vectors/Concurrency::graphics::float_3::operator+=", "amp_short_vectors/Concurrency::graphics::float_3::brg", "amp_short_vectors/Concurrency::graphics::float_3::get_x", "amp_short_vectors/Concurrency::graphics::float_3::get_zx", "amp_short_vectors/Concurrency::graphics::float_3::y", "amp_short_vectors/Concurrency::graphics::float_3::rbg", "amp_short_vectors/Concurrency::graphics::float_3::operator-", "amp_short_vectors/Concurrency::graphics::float_3::get_yz", "amp_short_vectors/Concurrency::graphics::float_3::set_xz", "amp_short_vectors/Concurrency::graphics::float_3::operator/=", "amp_short_vectors/Concurrency::graphics::float_3::zxy", "amp_short_vectors/Concurrency::graphics::float_3::yx", "amp_short_vectors/Concurrency::graphics::float_3::g", "amp_short_vectors/Concurrency::graphics::float_3::r", "amp_short_vectors/Concurrency::graphics::float_3::zy", "amp_short_vectors/Concurrency::graphics::float_3::set_zxy", "amp_short_vectors/Concurrency::graphics::float_3::set_zyx", "amp_short_vectors/Concurrency::graphics::float_3::get_yx", "amp_short_vectors/Concurrency::graphics::float_3", "amp_short_vectors/Concurrency::graphics::float_3::get_xz", "amp_short_vectors/Concurrency::graphics::float_3::get_yxz", "amp_short_vectors/Concurrency::graphics::float_3::set_xy", "amp_short_vectors/Concurrency::graphics::float_3::get_xzy", "amp_short_vectors/Concurrency::graphics::float_3::bgr", "amp_short_vectors/Concurrency::graphics::float_3::zx", "amp_short_vectors/Concurrency::graphics::float_3::gr", "amp_short_vectors/Concurrency::graphics::float_3::set_z", "amp_short_vectors/Concurrency::graphics::float_3::get_zy", "amp_short_vectors/Concurrency::graphics::float_3::gb", "amp_short_vectors/Concurrency::graphics::float_3::set_xzy", "amp_short_vectors/Concurrency::graphics::float_3::set_zx", "amp_short_vectors/Concurrency::graphics::float_3::set_yzx", "amp_short_vectors/Concurrency::graphics::float_3::operator=", "amp_short_vectors/Concurrency::graphics::float_3::x", "amp_short_vectors/Concurrency::graphics::float_3::grb", "amp_short_vectors/Concurrency::graphics::float_3::zyx", "amp_short_vectors/Concurrency::graphics::float_3::set_yxz", "amp_short_vectors/Concurrency::graphics::float_3::get_zxy", "amp_short_vectors/Concurrency::graphics::float_3::set_yz", "amp_short_vectors/Concurrency::graphics::float_3::operator--", "amp_short_vectors/Concurrency::graphics::float_3::set_xyz", "amp_short_vectors/Concurrency::graphics::float_3::operator++", "amp_short_vectors/Concurrency::graphics::float_3::z", "amp_short_vectors/Concurrency::graphics::float_3::xy", "amp_short_vectors/Concurrency::graphics::float_3::rgb", "amp_short_vectors/Concurrency::graphics::float_3::rg", "amp_short_vectors/Concurrency::graphics::float_3::yzx", "amp_short_vectors/Concurrency::graphics::float_3::set_yx", "amp_short_vectors/Concurrency::graphics::float_3::xzy", "amp_short_vectors/Concurrency::graphics::float_3::rb", "amp_short_vectors/Concurrency::graphics::float_3::get_z", "amp_short_vectors/Concurrency::graphics::float_3::br", "amp_short_vectors/Concurrency::graphics::float_3::bg", "amp_short_vectors/Concurrency::graphics::float_3::get_xyz", "amp_short_vectors/Concurrency::graphics::float_3::set_x", "amp_short_vectors/Concurrency::graphics::float_3::yxz", "amp_short_vectors/Concurrency::graphics::float_3::yz", "amp_short_vectors/Concurrency::graphics::float_3::gbr", "amp_short_vectors/Concurrency::graphics::float_3::operator*=", "amp_short_vectors/Concurrency::graphics::float_3::get_xy"] -helpviewer_keywords: ["amp_short_vectors/Concurrency::graphics::float_3"] -ms.assetid: 209df7a5-08d7-48b4-8ba5-77603642cdd8 ---- -# float_3 Class - -Represents a short vector of three floats. - -## Syntax - -```cpp -class float_3; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[float_3 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|float_3::get_x|| -|float_3::get_xy|| -|float_3::get_xyz|| -|float_3::get_xz|| -|float_3::get_xzy|| -|float_3::get_y|| -|float_3::get_yx|| -|float_3::get_yxz|| -|float_3::get_yz|| -|float_3::get_yzx|| -|float_3::get_z|| -|float_3::get_zx|| -|float_3::get_zxy|| -|float_3::get_zy|| -|float_3::get_zyx|| -|float_3::ref_b|| -|float_3::ref_g|| -|float_3::ref_r|| -|float_3::ref_x|| -|float_3::ref_y|| -|float_3::ref_z|| -|float_3::set_x|| -|float_3::set_xy|| -|float_3::set_xyz|| -|float_3::set_xz|| -|float_3::set_xzy|| -|float_3::set_y|| -|float_3::set_yx|| -|float_3::set_yxz|| -|float_3::set_yz|| -|float_3::set_yzx|| -|float_3::set_z|| -|float_3::set_zx|| -|float_3::set_zxy|| -|float_3::set_zy|| -|float_3::set_zyx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|float_3::operator-|| -|float_3::operator--|| -|float_3::operator*=|| -|float_3::operator/=|| -|float_3::operator++|| -|float_3::operator+=|| -|float_3::operator=|| -|float_3::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#float_3__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|float_3::b|| -|float_3::bg|| -|float_3::bgr|| -|float_3::br|| -|float_3::brg|| -|float_3::g|| -|float_3::gb|| -|float_3::gbr|| -|float_3::gr|| -|float_3::grb|| -|float_3::r|| -|float_3::rb|| -|float_3::rbg|| -|float_3::rg|| -|float_3::rgb|| -|float_3::x|| -|float_3::xy|| -|float_3::xyz|| -|float_3::xz|| -|float_3::xzy|| -|float_3::y|| -|float_3::yx|| -|float_3::yxz|| -|float_3::yz|| -|float_3::yzx|| -|float_3::z|| -|float_3::zx|| -|float_3::zxy|| -|float_3::zy|| -|float_3::zyx|| - -## Inheritance Hierarchy - -`float_3` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## float_3 - -Default constructor, initializes all elements with 0. - -```cpp -float_3() restrict(amp, - cpu); - -float_3( - float _V0, - float _V1, - float _V2) restrict(amp, - cpu); - -float_3( - float _V) restrict(amp, - cpu); - -float_3( - const float_3& _Other) restrict(amp, - cpu); - -explicit inline float_3( - const uint_3& _Other) restrict(amp, - cpu); - -explicit inline float_3( - const int_3& _Other) restrict(amp, - cpu); - -explicit inline float_3( - const unorm_3& _Other) restrict(amp, - cpu); - -explicit inline float_3( - const norm_3& _Other) restrict(amp, - cpu); - -explicit inline float_3( - const double_3& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 3; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/float-4-class.md b/docs/parallel/amp/reference/float-4-class.md deleted file mode 100644 index 386b6fa124a..00000000000 --- a/docs/parallel/amp/reference/float-4-class.md +++ /dev/null @@ -1,407 +0,0 @@ ---- -description: "Learn more about: float_4 Class" -title: "float_4 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::float_4::get_wyxz", "amp_short_vectors/Concurrency::graphics::float_4::zxw", "amp_short_vectors/Concurrency::graphics::float_4::bgra", "amp_short_vectors/Concurrency::graphics::float_4::get_xz", "amp_short_vectors/Concurrency::graphics::float_4::get_yxw", "amp_short_vectors/Concurrency::graphics::float_4::r", "amp_short_vectors/Concurrency::graphics::float_4::set_wzx", "amp_short_vectors/Concurrency::graphics::float_4::brga", "amp_short_vectors/Concurrency::graphics::float_4::get_xyw", "amp_short_vectors/Concurrency::graphics::float_4::gr", "amp_short_vectors/Concurrency::graphics::float_4::operator/=", "amp_short_vectors/Concurrency::graphics::float_4::agrb", "amp_short_vectors/Concurrency::graphics::float_4::set_wxz", "amp_short_vectors/Concurrency::graphics::float_4::get_wzy", "amp_short_vectors/Concurrency::graphics::float_4::rag", "amp_short_vectors/Concurrency::graphics::float_4::yzx", "amp_short_vectors/Concurrency::graphics::float_4::gbr", "amp_short_vectors/Concurrency::graphics::float_4::set_zxwy", "amp_short_vectors/Concurrency::graphics::float_4::wx", "amp_short_vectors/Concurrency::graphics::float_4::zwx", "amp_short_vectors/Concurrency::graphics::float_4::zwyx", "amp_short_vectors/Concurrency::graphics::float_4::wxy", "amp_short_vectors/Concurrency::graphics::float_4::set_wyx", "amp_short_vectors/Concurrency::graphics::float_4::set_zyx", "amp_short_vectors/Concurrency::graphics::float_4::set_yz", "amp_short_vectors/Concurrency::graphics::float_4::rbag", "amp_short_vectors/Concurrency::graphics::float_4::rb", "amp_short_vectors/Concurrency::graphics::float_4::get_zxyw", "amp_short_vectors/Concurrency::graphics::float_4::xz", "amp_short_vectors/Concurrency::graphics::float_4::get_zy", "amp_short_vectors/Concurrency::graphics::float_4::abrg", "amp_short_vectors/Concurrency::graphics::float_4::bg", "amp_short_vectors/Concurrency::graphics::float_4::xwy", "amp_short_vectors/Concurrency::graphics::float_4::get_xwz", "amp_short_vectors/Concurrency::graphics::float_4::ragb", "amp_short_vectors/Concurrency::graphics::float_4::wzx", "amp_short_vectors/Concurrency::graphics::float_4::rgba", "amp_short_vectors/Concurrency::graphics::float_4::set_zyw", "amp_short_vectors/Concurrency::graphics::float_4::get_zw", "amp_short_vectors/Concurrency::graphics::float_4::zywx", "amp_short_vectors/Concurrency::graphics::float_4::set_zwxy", "amp_short_vectors/Concurrency::graphics::float_4::set_wyzx", "amp_short_vectors/Concurrency::graphics::float_4::zyxw", "amp_short_vectors/Concurrency::graphics::float_4::yw", "amp_short_vectors/Concurrency::graphics::float_4::set_xw", "amp_short_vectors/Concurrency::graphics::float_4::gar", "amp_short_vectors/Concurrency::graphics::float_4::get_yzx", "amp_short_vectors/Concurrency::graphics::float_4::get_w", "amp_short_vectors/Concurrency::graphics::float_4::wzy", "amp_short_vectors/Concurrency::graphics::float_4::ywx", "amp_short_vectors/Concurrency::graphics::float_4::get_zx", "amp_short_vectors/Concurrency::graphics::float_4::operator=", "amp_short_vectors/Concurrency::graphics::float_4::set_wx", "amp_short_vectors/Concurrency::graphics::float_4::get_zyx", "amp_short_vectors/Concurrency::graphics::float_4::ra", "amp_short_vectors/Concurrency::graphics::float_4::zy", "amp_short_vectors/Concurrency::graphics::float_4::grab", "amp_short_vectors/Concurrency::graphics::float_4::get_xwy", "amp_short_vectors/Concurrency::graphics::float_4::get_yw", "amp_short_vectors/Concurrency::graphics::float_4::set_xyz", "amp_short_vectors/Concurrency::graphics::float_4::get_zywx", "amp_short_vectors/Concurrency::graphics::float_4::w", "amp_short_vectors/Concurrency::graphics::float_4::get_ywxz", "amp_short_vectors/Concurrency::graphics::float_4::xy", "amp_short_vectors/Concurrency::graphics::float_4::yzwx", "amp_short_vectors/Concurrency::graphics::float_4::rabg", "amp_short_vectors/Concurrency::graphics::float_4::get_ywx", "amp_short_vectors/Concurrency::graphics::float_4::get_zwyx", "amp_short_vectors/Concurrency::graphics::float_4::rbg", "amp_short_vectors/Concurrency::graphics::float_4::get_yxzw", "amp_short_vectors/Concurrency::graphics::float_4::a", "amp_short_vectors/Concurrency::graphics::float_4::ba", "amp_short_vectors/Concurrency::graphics::float_4::operator+=", "amp_short_vectors/Concurrency::graphics::float_4::brag", "amp_short_vectors/Concurrency::graphics::float_4::yxz", "amp_short_vectors/Concurrency::graphics::float_4::get_yzxw", "amp_short_vectors/Concurrency::graphics::float_4::set_xyw", "amp_short_vectors/Concurrency::graphics::float_4::set_yxwz", "amp_short_vectors/Concurrency::graphics::float_4::ab", "amp_short_vectors/Concurrency::graphics::float_4", "amp_short_vectors/Concurrency::graphics::float_4::set_wz", "amp_short_vectors/Concurrency::graphics::float_4::gabr", "amp_short_vectors/Concurrency::graphics::float_4::operator-", "amp_short_vectors/Concurrency::graphics::float_4::set_zwyx", "amp_short_vectors/Concurrency::graphics::float_4::set_zxy", "amp_short_vectors/Concurrency::graphics::float_4::set_x", "amp_short_vectors/Concurrency::graphics::float_4::get_wzxy", "amp_short_vectors/Concurrency::graphics::float_4::gbar", "amp_short_vectors/Concurrency::graphics::float_4::gb", "amp_short_vectors/Concurrency::graphics::float_4::zxwy", "amp_short_vectors/Concurrency::graphics::float_4::yxzw", "amp_short_vectors/Concurrency::graphics::float_4::get_wxz", "amp_short_vectors/Concurrency::graphics::float_4::zyx", "amp_short_vectors/Concurrency::graphics::float_4::xzyw", "amp_short_vectors/Concurrency::graphics::float_4::operator*=", "amp_short_vectors/Concurrency::graphics::float_4::yxwz", "amp_short_vectors/Concurrency::graphics::float_4::xywz", "amp_short_vectors/Concurrency::graphics::float_4::arb", "amp_short_vectors/Concurrency::graphics::float_4::get_yzw", "amp_short_vectors/Concurrency::graphics::float_4::wyxz", "amp_short_vectors/Concurrency::graphics::float_4::get_yzwx", "amp_short_vectors/Concurrency::graphics::float_4::wy", "amp_short_vectors/Concurrency::graphics::float_4::zwxy", "amp_short_vectors/Concurrency::graphics::float_4::set_wyz", "amp_short_vectors/Concurrency::graphics::float_4::set_wyxz", "amp_short_vectors/Concurrency::graphics::float_4::gab", "amp_short_vectors/Concurrency::graphics::float_4::get_xyzw", "amp_short_vectors/Concurrency::graphics::float_4::get_wyz", "amp_short_vectors/Concurrency::graphics::float_4::rbga", "amp_short_vectors/Concurrency::graphics::float_4::bagr", "amp_short_vectors/Concurrency::graphics::float_4::xyz", "amp_short_vectors/Concurrency::graphics::float_4::set_wzxy", "amp_short_vectors/Concurrency::graphics::float_4::agb", "amp_short_vectors/Concurrency::graphics::float_4::brg", "amp_short_vectors/Concurrency::graphics::float_4::zxyw", "amp_short_vectors/Concurrency::graphics::float_4::arg", "amp_short_vectors/Concurrency::graphics::float_4::g", "amp_short_vectors/Concurrency::graphics::float_4::get_zxy", "amp_short_vectors/Concurrency::graphics::float_4::set_yzxw", "amp_short_vectors/Concurrency::graphics::float_4::set_yzx", "amp_short_vectors/Concurrency::graphics::float_4::gba", "amp_short_vectors/Concurrency::graphics::float_4::ywzx", "amp_short_vectors/Concurrency::graphics::float_4::get_wx", "amp_short_vectors/Concurrency::graphics::float_4::set_z", "amp_short_vectors/Concurrency::graphics::float_4::set_xwyz", "amp_short_vectors/Concurrency::graphics::float_4::grba", "amp_short_vectors/Concurrency::graphics::float_4::yxw", "amp_short_vectors/Concurrency::graphics::float_4::set_zw", "amp_short_vectors/Concurrency::graphics::float_4::get_yx", "amp_short_vectors/Concurrency::graphics::float_4::get_zwxy", "amp_short_vectors/Concurrency::graphics::float_4::get_wz", "amp_short_vectors/Concurrency::graphics::float_4::garb", "amp_short_vectors/Concurrency::graphics::float_4::set_yxw", "amp_short_vectors/Concurrency::graphics::float_4::rba", "amp_short_vectors/Concurrency::graphics::float_4::xzwy", "amp_short_vectors/Concurrency::graphics::float_4::get_zxwy", "amp_short_vectors/Concurrency::graphics::float_4::zw", "amp_short_vectors/Concurrency::graphics::float_4::abgr", "amp_short_vectors/Concurrency::graphics::float_4::set_wxzy", "amp_short_vectors/Concurrency::graphics::float_4::wz", "amp_short_vectors/Concurrency::graphics::float_4::agbr", "amp_short_vectors/Concurrency::graphics::float_4::ar", "amp_short_vectors/Concurrency::graphics::float_4::bra", "amp_short_vectors/Concurrency::graphics::float_4::zxy", "amp_short_vectors/Concurrency::graphics::float_4::set_wy", "amp_short_vectors/Concurrency::graphics::float_4::argb", "amp_short_vectors/Concurrency::graphics::float_4::abr", "amp_short_vectors/Concurrency::graphics::float_4::get_wyzx", "amp_short_vectors/Concurrency::graphics::float_4::set_xywz", "amp_short_vectors/Concurrency::graphics::float_4::get_xwzy", "amp_short_vectors/Concurrency::graphics::float_4::b", "amp_short_vectors/Concurrency::graphics::float_4::ywz", "amp_short_vectors/Concurrency::graphics::float_4::wxz", "amp_short_vectors/Concurrency::graphics::float_4::rga", "amp_short_vectors/Concurrency::graphics::float_4::set_zx", "amp_short_vectors/Concurrency::graphics::float_4::ga", "amp_short_vectors/Concurrency::graphics::float_4::get_y", "amp_short_vectors/Concurrency::graphics::float_4::agr", "amp_short_vectors/Concurrency::graphics::float_4::wzxy", "amp_short_vectors/Concurrency::graphics::float_4::set_xzy", "amp_short_vectors/Concurrency::graphics::float_4::arbg", "amp_short_vectors/Concurrency::graphics::float_4::gbra", "amp_short_vectors/Concurrency::graphics::float_4::set_xy", "amp_short_vectors/Concurrency::graphics::float_4::yx", "amp_short_vectors/Concurrency::graphics::float_4::set_yxz", "amp_short_vectors/Concurrency::graphics::float_4::wxzy", "amp_short_vectors/Concurrency::graphics::float_4::bgr", "amp_short_vectors/Concurrency::graphics::float_4::get_wxyz", "amp_short_vectors/Concurrency::graphics::float_4::xyw", "amp_short_vectors/Concurrency::graphics::float_4::set_ywx", "amp_short_vectors/Concurrency::graphics::float_4::get_wzyx", "amp_short_vectors/Concurrency::graphics::float_4::wyx", "amp_short_vectors/Concurrency::graphics::float_4::get_xzyw", "amp_short_vectors/Concurrency::graphics::float_4::get_zwy", "amp_short_vectors/Concurrency::graphics::float_4::get_wzx", "amp_short_vectors/Concurrency::graphics::float_4::barg", "amp_short_vectors/Concurrency::graphics::float_4::get_ywzx", "amp_short_vectors/Concurrency::graphics::float_4::set_wxyz", "amp_short_vectors/Concurrency::graphics::float_4::get_wxy", "amp_short_vectors/Concurrency::graphics::float_4::set_zyxw", "amp_short_vectors/Concurrency::graphics::float_4::set_zywx", "amp_short_vectors/Concurrency::graphics::float_4::operator-=", "amp_short_vectors/Concurrency::graphics::float_4::set_y", "amp_short_vectors/Concurrency::graphics::float_4::wyzx", "amp_short_vectors/Concurrency::graphics::float_4::bgar", "amp_short_vectors/Concurrency::graphics::float_4::set_yx", "amp_short_vectors/Concurrency::graphics::float_4::set_xzyw", "amp_short_vectors/Concurrency::graphics::float_4::set_yxzw", "amp_short_vectors/Concurrency::graphics::float_4::xyzw", "amp_short_vectors/Concurrency::graphics::float_4::abg", "amp_short_vectors/Concurrency::graphics::float_4::x", "amp_short_vectors/Concurrency::graphics::float_4::gra", "amp_short_vectors/Concurrency::graphics::float_4::get_zyw", "amp_short_vectors/Concurrency::graphics::float_4::set_xz", "amp_short_vectors/Concurrency::graphics::float_4::get_xw", "amp_short_vectors/Concurrency::graphics::float_4::bag", "amp_short_vectors/Concurrency::graphics::float_4::xwz", "amp_short_vectors/Concurrency::graphics::float_4::get_xwyz", "amp_short_vectors/Concurrency::graphics::float_4::get_zxw", "amp_short_vectors/Concurrency::graphics::float_4::set_xwzy", "amp_short_vectors/Concurrency::graphics::float_4::get_wxzy", "amp_short_vectors/Concurrency::graphics::float_4::get_xzwy", "amp_short_vectors/Concurrency::graphics::float_4::get_xzw", "amp_short_vectors/Concurrency::graphics::float_4::get_xzy", "amp_short_vectors/Concurrency::graphics::float_4::set_yzw", "amp_short_vectors/Concurrency::graphics::float_4::zwy", "amp_short_vectors/Concurrency::graphics::float_4::operator--", "amp_short_vectors/Concurrency::graphics::float_4::set_xzw", "amp_short_vectors/Concurrency::graphics::float_4::get_wy", "amp_short_vectors/Concurrency::graphics::float_4::xzy", "amp_short_vectors/Concurrency::graphics::float_4::set_zy", "amp_short_vectors/Concurrency::graphics::float_4::set_xwz", "amp_short_vectors/Concurrency::graphics::float_4::set_zwx", "amp_short_vectors/Concurrency::graphics::float_4::bar", "amp_short_vectors/Concurrency::graphics::float_4::set_wzy", "amp_short_vectors/Concurrency::graphics::float_4::set_zxyw", "amp_short_vectors/Concurrency::graphics::float_4::set_wzyx", "amp_short_vectors/Concurrency::graphics::float_4::set_w", "amp_short_vectors/Concurrency::graphics::float_4::get_yxz", "amp_short_vectors/Concurrency::graphics::float_4::get_ywz", "amp_short_vectors/Concurrency::graphics::float_4::set_ywzx", "amp_short_vectors/Concurrency::graphics::float_4::get_zwx", "amp_short_vectors/Concurrency::graphics::float_4::set_zwy", "amp_short_vectors/Concurrency::graphics::float_4::set_yzwx", "amp_short_vectors/Concurrency::graphics::float_4::wyz", "amp_short_vectors/Concurrency::graphics::float_4::yzxw", "amp_short_vectors/Concurrency::graphics::float_4::yz", "amp_short_vectors/Concurrency::graphics::float_4::xw", "amp_short_vectors/Concurrency::graphics::float_4::bga", "amp_short_vectors/Concurrency::graphics::float_4::ywxz", "amp_short_vectors/Concurrency::graphics::float_4::set_wxy", "amp_short_vectors/Concurrency::graphics::float_4::get_wyx", "amp_short_vectors/Concurrency::graphics::float_4::yzw", "amp_short_vectors/Concurrency::graphics::float_4::grb", "amp_short_vectors/Concurrency::graphics::float_4::operator++", "amp_short_vectors/Concurrency::graphics::float_4::xwyz", "amp_short_vectors/Concurrency::graphics::float_4::br", "amp_short_vectors/Concurrency::graphics::float_4::set_zxw", "amp_short_vectors/Concurrency::graphics::float_4::rgab", "amp_short_vectors/Concurrency::graphics::float_4::get_xy", "amp_short_vectors/Concurrency::graphics::float_4::xzw", "amp_short_vectors/Concurrency::graphics::float_4::zyw", "amp_short_vectors/Concurrency::graphics::float_4::set_ywz", "amp_short_vectors/Concurrency::graphics::float_4::zx", "amp_short_vectors/Concurrency::graphics::float_4::wxyz", "amp_short_vectors/Concurrency::graphics::float_4::set_xzwy", "amp_short_vectors/Concurrency::graphics::float_4::rab", "amp_short_vectors/Concurrency::graphics::float_4::ag", "amp_short_vectors/Concurrency::graphics::float_4::set_xwy", "amp_short_vectors/Concurrency::graphics::float_4::get_xywz", "amp_short_vectors/Concurrency::graphics::float_4::get_xyz", "amp_short_vectors/Concurrency::graphics::float_4::y", "amp_short_vectors/Concurrency::graphics::float_4::rg", "amp_short_vectors/Concurrency::graphics::float_4::wzyx", "amp_short_vectors/Concurrency::graphics::float_4::z", "amp_short_vectors/Concurrency::graphics::float_4::set_ywxz", "amp_short_vectors/Concurrency::graphics::float_4::get_yxwz", "amp_short_vectors/Concurrency::graphics::float_4::rgb", "amp_short_vectors/Concurrency::graphics::float_4::get_zyxw", "amp_short_vectors/Concurrency::graphics::float_4::get_yz", "amp_short_vectors/Concurrency::graphics::float_4::set_yw", "amp_short_vectors/Concurrency::graphics::float_4::xwzy", "amp_short_vectors/Concurrency::graphics::float_4::get_x", "amp_short_vectors/Concurrency::graphics::float_4::get_z", "amp_short_vectors/Concurrency::graphics::float_4::set_xyzw"] -ms.assetid: 10f92170-e58c-4afc-8198-fc5778d56038 ---- -# float_4 Class - -Represents a short vector of four floats. - -## Syntax - -```cpp -class float_4; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[float_4 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|float_4::get_w|| -|float_4::get_wx|| -|float_4::get_wxy|| -|float_4::get_wxyz|| -|float_4::get_wxz|| -|float_4::get_wxzy|| -|float_4::get_wy|| -|float_4::get_wyx|| -|float_4::get_wyxz|| -|float_4::get_wyz|| -|float_4::get_wyzx|| -|float_4::get_wz|| -|float_4::get_wzx|| -|float_4::get_wzxy|| -|float_4::get_wzy|| -|float_4::get_wzyx|| -|float_4::get_x|| -|float_4::get_xw|| -|float_4::get_xwy|| -|float_4::get_xwyz|| -|float_4::get_xwz|| -|float_4::get_xwzy|| -|float_4::get_xy|| -|float_4::get_xyw|| -|float_4::get_xywz|| -|float_4::get_xyz|| -|float_4::get_xyzw|| -|float_4::get_xz|| -|float_4::get_xzw|| -|float_4::get_xzwy|| -|float_4::get_xzy|| -|float_4::get_xzyw|| -|float_4::get_y|| -|float_4::get_yw|| -|float_4::get_ywx|| -|float_4::get_ywxz|| -|float_4::get_ywz|| -|float_4::get_ywzx|| -|float_4::get_yx|| -|float_4::get_yxw|| -|float_4::get_yxwz|| -|float_4::get_yxz|| -|float_4::get_yxzw|| -|float_4::get_yz|| -|float_4::get_yzw|| -|float_4::get_yzwx|| -|float_4::get_yzx|| -|float_4::get_yzxw|| -|float_4::get_z|| -|float_4::get_zw|| -|float_4::get_zwx|| -|float_4::get_zwxy|| -|float_4::get_zwy|| -|float_4::get_zwyx|| -|float_4::get_zx|| -|float_4::get_zxw|| -|float_4::get_zxwy|| -|float_4::get_zxy|| -|float_4::get_zxyw|| -|float_4::get_zy|| -|float_4::get_zyw|| -|float_4::get_zywx|| -|float_4::get_zyx|| -|float_4::get_zyxw|| -|float_4::ref_a|| -|float_4::ref_b|| -|float_4::ref_g|| -|float_4::ref_r|| -|float_4::ref_w|| -|float_4::ref_x|| -|float_4::ref_y|| -|float_4::ref_z|| -|float_4::set_w|| -|float_4::set_wx|| -|float_4::set_wxy|| -|float_4::set_wxyz|| -|float_4::set_wxz|| -|float_4::set_wxzy|| -|float_4::set_wy|| -|float_4::set_wyx|| -|float_4::set_wyxz|| -|float_4::set_wyz|| -|float_4::set_wyzx|| -|float_4::set_wz|| -|float_4::set_wzx|| -|float_4::set_wzxy|| -|float_4::set_wzy|| -|float_4::set_wzyx|| -|float_4::set_x|| -|float_4::set_xw|| -|float_4::set_xwy|| -|float_4::set_xwyz|| -|float_4::set_xwz|| -|float_4::set_xwzy|| -|float_4::set_xy|| -|float_4::set_xyw|| -|float_4::set_xywz|| -|float_4::set_xyz|| -|float_4::set_xyzw|| -|float_4::set_xz|| -|float_4::set_xzw|| -|float_4::set_xzwy|| -|float_4::set_xzy|| -|float_4::set_xzyw|| -|float_4::set_y|| -|float_4::set_yw|| -|float_4::set_ywx|| -|float_4::set_ywxz|| -|float_4::set_ywz|| -|float_4::set_ywzx|| -|float_4::set_yx|| -|float_4::set_yxw|| -|float_4::set_yxwz|| -|float_4::set_yxz|| -|float_4::set_yxzw|| -|float_4::set_yz|| -|float_4::set_yzw|| -|float_4::set_yzwx|| -|float_4::set_yzx|| -|float_4::set_yzxw|| -|float_4::set_z|| -|float_4::set_zw|| -|float_4::set_zwx|| -|float_4::set_zwxy|| -|float_4::set_zwy|| -|float_4::set_zwyx|| -|float_4::set_zx|| -|float_4::set_zxw|| -|float_4::set_zxwy|| -|float_4::set_zxy|| -|float_4::set_zxyw|| -|float_4::set_zy|| -|float_4::set_zyw|| -|float_4::set_zywx|| -|float_4::set_zyx|| -|float_4::set_zyxw|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|float_4::operator-|| -|float_4::operator--|| -|float_4::operator*=|| -|float_4::operator/=|| -|float_4::operator++|| -|float_4::operator+=|| -|float_4::operator=|| -|float_4::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#float_4__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|float_4::a|| -|float_4::ab|| -|float_4::abg|| -|float_4::abgr|| -|float_4::abr|| -|float_4::abrg|| -|float_4::ag|| -|float_4::agb|| -|float_4::agbr|| -|float_4::agr|| -|float_4::agrb|| -|float_4::ar|| -|float_4::arb|| -|float_4::arbg|| -|float_4::arg|| -|float_4::argb|| -|float_4::b|| -|float_4::ba|| -|float_4::bag|| -|float_4::bagr|| -|float_4::bar|| -|float_4::barg|| -|float_4::bg|| -|float_4::bga|| -|float_4::bgar|| -|float_4::bgr|| -|float_4::bgra|| -|float_4::br|| -|float_4::bra|| -|float_4::brag|| -|float_4::brg|| -|float_4::brga|| -|float_4::g|| -|float_4::ga|| -|float_4::gab|| -|float_4::gabr|| -|float_4::gar|| -|float_4::garb|| -|float_4::gb|| -|float_4::gba|| -|float_4::gbar|| -|float_4::gbr|| -|float_4::gbra|| -|float_4::gr|| -|float_4::gra|| -|float_4::grab|| -|float_4::grb|| -|float_4::grba|| -|float_4::r|| -|float_4::ra|| -|float_4::rab|| -|float_4::rabg|| -|float_4::rag|| -|float_4::ragb|| -|float_4::rb|| -|float_4::rba|| -|float_4::rbag|| -|float_4::rbg|| -|float_4::rbga|| -|float_4::rg|| -|float_4::rga|| -|float_4::rgab|| -|float_4::rgb|| -|float_4::rgba|| -|float_4::w|| -|float_4::wx|| -|float_4::wxy|| -|float_4::wxyz|| -|float_4::wxz|| -|float_4::wxzy|| -|float_4::wy|| -|float_4::wyx|| -|float_4::wyxz|| -|float_4::wyz|| -|float_4::wyzx|| -|float_4::wz|| -|float_4::wzx|| -|float_4::wzxy|| -|float_4::wzy|| -|float_4::wzyx|| -|float_4::x|| -|float_4::xw|| -|float_4::xwy|| -|float_4::xwyz|| -|float_4::xwz|| -|float_4::xwzy|| -|float_4::xy|| -|float_4::xyw|| -|float_4::xywz|| -|float_4::xyz|| -|float_4::xyzw|| -|float_4::xz|| -|float_4::xzw|| -|float_4::xzwy|| -|float_4::xzy|| -|float_4::xzyw|| -|float_4::y|| -|float_4::yw|| -|float_4::ywx|| -|float_4::ywxz|| -|float_4::ywz|| -|float_4::ywzx|| -|float_4::yx|| -|float_4::yxw|| -|float_4::yxwz|| -|float_4::yxz|| -|float_4::yxzw|| -|float_4::yz|| -|float_4::yzw|| -|float_4::yzwx|| -|float_4::yzx|| -|float_4::yzxw|| -|float_4::z|| -|float_4::zw|| -|float_4::zwx|| -|float_4::zwxy|| -|float_4::zwy|| -|float_4::zwyx|| -|float_4::zx|| -|float_4::zxw|| -|float_4::zxwy|| -|float_4::zxy|| -|float_4::zxyw|| -|float_4::zy|| -|float_4::zyw|| -|float_4::zywx|| -|float_4::zyx|| -|float_4::zyxw|| - -## Inheritance Hierarchy - -`float_4` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## float_4 - -Default constructor, initializes all elements with 0. - -```cpp -float_4() restrict(amp, - cpu); - -float_4( - float _V0, - float _V1, - float _V2, - float _V3) restrict(amp, - cpu); - -float_4( - float _V) restrict(amp, - cpu); - -float_4( - const float_4& _Other) restrict(amp, - cpu); - -explicit inline float_4( - const uint_4& _Other) restrict(amp, - cpu); - -explicit inline float_4( - const int_4& _Other) restrict(amp, - cpu); - -explicit inline float_4( - const unorm_4& _Other) restrict(amp, - cpu); - -explicit inline float_4( - const norm_4& _Other) restrict(amp, - cpu); - -explicit inline float_4( - const double_4& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V3*
-The value to initialize element 3. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 4; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/index-class.md b/docs/parallel/amp/reference/index-class.md deleted file mode 100644 index 7e4fe7573d1..00000000000 --- a/docs/parallel/amp/reference/index-class.md +++ /dev/null @@ -1,311 +0,0 @@ ---- -description: "Learn more about: index Class" -title: "index Class" -ms.date: 06/21/2022 -f1_keywords: ["AMP/index", "AMP/Concurrency::index::index", "AMP/Concurrency::index::rank"] -helpviewer_keywords: ["index structure"] -ms.assetid: cbe79b08-0ba7-474c-9828-f1a71da39eb3 -ms.custom: devdivchpfy22 ---- - -# index Class - -Defines an *N*-dimensional index vector. - -## Syntax - -```cpp -template -class index; -``` - -### Parameters - -*_Rank*
-The rank, or number of dimensions. - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[index Constructor](#index_ctor)|Initializes a new instance of the `index` class.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator--](#operator--)|Decrements each element of the `index` object.| -|[operator%=](#operator_mod_eq)|Calculates the modulus (remainder) of each element in the `index` object when that element is divided by a number.| -|[operator*=](#operator_star_eq)|Multiplies each element of the `index` object by a number.| -|[operator/=](#operator_div_eq)|Divides each element of the `index` object by a number.| -|[index::operator\[\]](#operator_at)|Returns the element that's at the specified index.| -|[operator++](#operator_add_add)|Increments each element of the `index` object.| -|[operator+=](#operator_add_eq)|Adds the specified number to each element of the `index` object.| -|[operator=](#operator_eq)|Copies the contents of the specified `index` object into this one.| -|[operator-=](#operator_-_eq)|Subtracts the specified number from each element of the `index` object.| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[rank Constant](#rank)|Stores the rank of the `index` object.| - -## Inheritance Hierarchy - -`index` - -## Remarks - -The `index` structure represents a coordinate vector of *N* integers that specifies a unique position in an *N*-dimensional space. The values in the vector are ordered from most significant to least significant. You can retrieve the values of the components using [operator=](#operator_eq). - -## Requirements - -**Header:** amp.h - -**Namespace:** Concurrency - -## index Constructor - -Initializes a new instance of the index class. - -```cpp -index() restrict(amp,cpu); - -index( - const index<_Rank>& _Other -) restrict(amp,cpu); - -explicit index( - int _I -) restrict(amp,cpu); - -index( - int _I0, - int _I1 -) restrict(amp,cpu); - -index( - int _I0, - int _I1, - int _I2 -) restrict(amp,cpu); - -explicit index( - const int _Array[_Rank] -) restrict(amp,cpu); -``` - -### Parameters - -*_Array*
-A one-dimensional array with the rank values. - -*_I*
-The index location in a one-dimensional index. - -*_I0*
-The length of the most significant dimension. - -*_I1*
-The length of the next-to-most-significant dimension. - -*_I2*
-The length of the least significant dimension. - -*_Other*
-An index object on which the new index object is based. - -## operator-- - -Decrements each element of the index object. - -```cpp -index<_Rank>& operator--() restrict(amp,cpu); - -index operator--( - int -) restrict(amp,cpu); -``` - -### Return values - -For the prefix operator, the index object (`*this`). For the suffix operator, a new index object. - -## operator%= - -Calculates the modulus (remainder) of each element in the index object when that element is divided by the specified number. - -```cpp -index<_Rank>& operator%=( - int _Rhs -) restrict(cpu, amp); -``` - -### Parameters - -*_Rhs*
-The number to divide by to find the modulus. - -## Return Value - -The index object. - -## operator*= - -Multiplies each element in the index object by the specified number. - -```cpp -index<_Rank>& operator*=( - int _Rhs -) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The number to multiply. - -## operator/= - -Divides each element in the index object by the specified number. - -```cpp -index<_Rank>& operator/=( - int _Rhs -) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The number to divide by. - -## operator\[\] - -Returns the component of the index at the specified location. - -```cpp -int operator[] ( - unsigned _Index -) const restrict(amp,cpu); - -int& operator[] ( - unsigned _Index -) restrict(amp,cpu); -``` - -### Parameters - -*_Index*
-An integer from 0 through the rank minus 1. - -### Return Value - -The element that's at the specified index. - -### Remarks - -This following example displays the component values of the index. - -```cpp -// Prints 1 2 3. -concurrency::index<3> idx(1, 2, 3); -std::cout << idx[0] << "\n"; -std::cout << idx[1] << "\n"; -std::cout << idx[2] << "\n"; -``` - -## operator++ - -Increments each element of the index object. - -```cpp -index<_Rank>& operator++() restrict(amp,cpu); - -index<_Rank> operator++( - int -) restrict(amp,cpu); -``` - -### Return Value - -For the prefix operator, the index object (`*this`). For the suffix operator, a new index object. - -## operator+= - -Adds the specified number to each element of the index object. - -```cpp -index<_Rank>& operator+=( - const index<_Rank>& _Rhs -) restrict(amp,cpu); - -index<_Rank>& operator+=( - int _Rhs -) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The number to add. - -### Return Value - -The index object. - -## operator= - -Copies the contents of the specified index object into this one. - -```cpp -index<_Rank>& operator=( - const index<_Rank>& _Other -) restrict(amp,cpu); -``` - -### Parameters - -*_Other*
-The index object to copy from. - -### Return Value - -A reference to this index object. - -## operator-= - -Subtracts the specified number from each element of the index object. - -```cpp -index<_Rank>& operator-=( - const index<_Rank>& _Rhs -) restrict(amp,cpu); - -index<_Rank>& operator-=( - int _Rhs -) restrict(amp,cpu); -``` - -### Parameters - -*_Rhs*
-The number to subtract. - -### Return Value - -The index object. - -## Rank - -Gets the rank of the index object. - -```cpp -static const int rank = _Rank; -``` - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/int-2-class.md b/docs/parallel/amp/reference/int-2-class.md deleted file mode 100644 index 6b5e99b2225..00000000000 --- a/docs/parallel/amp/reference/int-2-class.md +++ /dev/null @@ -1,162 +0,0 @@ ---- -description: "Learn more about: int_2 Class" -title: "int_2 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::int_2::y", "amp_short_vectors/Concurrency::graphics::int_2::set_x", "amp_short_vectors/Concurrency::graphics::int_2::set_y", "amp_short_vectors/Concurrency::graphics::int_2::get_yx", "amp_short_vectors/Concurrency::graphics::int_2::operator++", "amp_short_vectors/Concurrency::graphics::int_2::x", "amp_short_vectors/Concurrency::graphics::int_2::set_yx", "amp_short_vectors/Concurrency::graphics::int_2::operator/=", "amp_short_vectors/Concurrency::graphics::int_2::get_y", "amp_short_vectors/Concurrency::graphics::int_2::gr", "amp_short_vectors/Concurrency::graphics::int_2::operator*=", "amp_short_vectors/Concurrency::graphics::int_2::r", "amp_short_vectors/Concurrency::graphics::int_2::get_xy", "amp_short_vectors/Concurrency::graphics::int_2::operator=", "amp_short_vectors/Concurrency::graphics::int_2::g", "amp_short_vectors/Concurrency::graphics::int_2::rg", "amp_short_vectors/Concurrency::graphics::int_2::xy", "amp_short_vectors/Concurrency::graphics::int_2::operator-=", "amp_short_vectors/Concurrency::graphics::int_2::get_x", "amp_short_vectors/Concurrency::graphics::int_2::yx", "amp_short_vectors/Concurrency::graphics::int_2", "amp_short_vectors/Concurrency::graphics::int_2::operator-", "amp_short_vectors/Concurrency::graphics::int_2::set_xy", "amp_short_vectors/Concurrency::graphics::int_2::operator+=", "amp_short_vectors/Concurrency::graphics::int_2::operator--"] -ms.assetid: 258b02e9-f1ee-46c2-8edd-dc9f69184846 ---- -# int_2 Class - -Represents a short vector of two integers. - -## Syntax - -```cpp -class int_2; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[int_2 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|int_2::get_x|| -|int_2::get_xy|| -|int_2::get_y|| -|int_2::get_yx|| -|int_2::ref_g|| -|int_2::ref_r|| -|int_2::ref_x|| -|int_2::ref_y|| -|int_2::set_x|| -|int_2::set_xy|| -|int_2::set_y|| -|int_2::set_yx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|int_2::operator-|| -|int_2::operator--|| -|int_2::operator%=|| -|int_2::operator&=|| -|int_2::operator*=|| -|int_2::operator/=|| -|int_2::operator^=|| -|int_2::operator\|=|| -|int_2::operator~|| -|int_2::operator++|| -|int_2::operator+=|| -|int_2::operator<\<=|| -|int_2::operator=|| -|int_2::operator-=|| -|int_2::operator>>=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#int_2__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|int_2::g|| -|int_2::gr|| -|int_2::r|| -|int_2::rg|| -|int_2::x|| -|int_2::xy|| -|int_2::y|| -|int_2::yx|| - -## Inheritance Hierarchy - -`int_2` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## int_2 - -Default constructor, initializes all elements with 0. - -```cpp -int_2() restrict(amp, - cpu); - -int_2( - int _V0, - int _V1) restrict(amp, - cpu); - -int_2( - int _V) restrict(amp, - cpu); - -int_2( - const int_2& _Other) restrict(amp, - cpu); - -explicit inline int_2( - const uint_2& _Other) restrict(amp, - cpu); - -explicit inline int_2( - const float_2& _Other) restrict(amp, - cpu); - -explicit inline int_2( - const unorm_2& _Other) restrict(amp, - cpu); - -explicit inline int_2( - const norm_2& _Other) restrict(amp, - cpu); - -explicit inline int_2( - const double_2& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 2; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/int-3-class.md b/docs/parallel/amp/reference/int-3-class.md deleted file mode 100644 index 460a6983ff9..00000000000 --- a/docs/parallel/amp/reference/int-3-class.md +++ /dev/null @@ -1,207 +0,0 @@ ---- -description: "Learn more about: int_3 Class" -title: "int_3 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::int_3::get_x", "amp_short_vectors/Concurrency::graphics::int_3::operator-=", "amp_short_vectors/Concurrency::graphics::int_3::get_y", "amp_short_vectors/Concurrency::graphics::int_3::operator=", "amp_short_vectors/Concurrency::graphics::int_3::operator++", "amp_short_vectors/Concurrency::graphics::int_3::zyx", "amp_short_vectors/Concurrency::graphics::int_3::get_z", "amp_short_vectors/Concurrency::graphics::int_3::operator*=", "amp_short_vectors/Concurrency::graphics::int_3::grb", "amp_short_vectors/Concurrency::graphics::int_3::get_xz", "amp_short_vectors/Concurrency::graphics::int_3::br", "amp_short_vectors/Concurrency::graphics::int_3::operator--", "amp_short_vectors/Concurrency::graphics::int_3", "amp_short_vectors/Concurrency::graphics::int_3::set_yx", "amp_short_vectors/Concurrency::graphics::int_3::x", "amp_short_vectors/Concurrency::graphics::int_3::yxz", "amp_short_vectors/Concurrency::graphics::int_3::set_y", "amp_short_vectors/Concurrency::graphics::int_3::zy", "amp_short_vectors/Concurrency::graphics::int_3::z", "amp_short_vectors/Concurrency::graphics::int_3::get_zx", "amp_short_vectors/Concurrency::graphics::int_3::rb", "amp_short_vectors/Concurrency::graphics::int_3::yzx", "amp_short_vectors/Concurrency::graphics::int_3::gb", "amp_short_vectors/Concurrency::graphics::int_3::set_zxy", "amp_short_vectors/Concurrency::graphics::int_3::xy", "amp_short_vectors/Concurrency::graphics::int_3::set_zx", "amp_short_vectors/Concurrency::graphics::int_3::g", "amp_short_vectors/Concurrency::graphics::int_3::operator/=", "amp_short_vectors/Concurrency::graphics::int_3::get_zy", "amp_short_vectors/Concurrency::graphics::int_3::yx", "amp_short_vectors/Concurrency::graphics::int_3::xzy", "amp_short_vectors/Concurrency::graphics::int_3::set_x", "amp_short_vectors/Concurrency::graphics::int_3::set_xz", "amp_short_vectors/Concurrency::graphics::int_3::get_yzx", "amp_short_vectors/Concurrency::graphics::int_3::b", "amp_short_vectors/Concurrency::graphics::int_3::gbr", "amp_short_vectors/Concurrency::graphics::int_3::operator+=", "amp_short_vectors/Concurrency::graphics::int_3::gr", "amp_short_vectors/Concurrency::graphics::int_3::brg", "amp_short_vectors/Concurrency::graphics::int_3::bg", "amp_short_vectors/Concurrency::graphics::int_3::zx", "amp_short_vectors/Concurrency::graphics::int_3::get_xyz", "amp_short_vectors/Concurrency::graphics::int_3::set_zyx", "amp_short_vectors/Concurrency::graphics::int_3::set_yzx", "amp_short_vectors/Concurrency::graphics::int_3::y", "amp_short_vectors/Concurrency::graphics::int_3::set_z", "amp_short_vectors/Concurrency::graphics::int_3::r", "amp_short_vectors/Concurrency::graphics::int_3::set_xzy", "amp_short_vectors/Concurrency::graphics::int_3::rg", "amp_short_vectors/Concurrency::graphics::int_3::xyz", "amp_short_vectors/Concurrency::graphics::int_3::get_yz", "amp_short_vectors/Concurrency::graphics::int_3::operator-", "amp_short_vectors/Concurrency::graphics::int_3::set_xy", "amp_short_vectors/Concurrency::graphics::int_3::zxy", "amp_short_vectors/Concurrency::graphics::int_3::yz", "amp_short_vectors/Concurrency::graphics::int_3::set_zy", "amp_short_vectors/Concurrency::graphics::int_3::bgr", "amp_short_vectors/Concurrency::graphics::int_3::get_xzy", "amp_short_vectors/Concurrency::graphics::int_3::get_yx", "amp_short_vectors/Concurrency::graphics::int_3::rbg", "amp_short_vectors/Concurrency::graphics::int_3::get_zxy", "amp_short_vectors/Concurrency::graphics::int_3::set_yxz", "amp_short_vectors/Concurrency::graphics::int_3::rgb", "amp_short_vectors/Concurrency::graphics::int_3::get_xy", "amp_short_vectors/Concurrency::graphics::int_3::set_xyz", "amp_short_vectors/Concurrency::graphics::int_3::get_yxz", "amp_short_vectors/Concurrency::graphics::int_3::get_zyx", "amp_short_vectors/Concurrency::graphics::int_3::xz", "amp_short_vectors/Concurrency::graphics::int_3::set_yz"] -ms.assetid: d4af182f-30f1-455c-b16d-aa99cd314038 ---- -# int_3 Class - -Represents a short vector of three integers. - -## Syntax - -```cpp -class int_3; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[int_3 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|int_3::get_x|| -|int_3::get_xy|| -|int_3::get_xyz|| -|int_3::get_xz|| -|int_3::get_xzy|| -|int_3::get_y|| -|int_3::get_yx|| -|int_3::get_yxz|| -|int_3::get_yz|| -|int_3::get_yzx|| -|int_3::get_z|| -|int_3::get_zx|| -|int_3::get_zxy|| -|int_3::get_zy|| -|int_3::get_zyx|| -|int_3::ref_b|| -|int_3::ref_g|| -|int_3::ref_r|| -|int_3::ref_x|| -|int_3::ref_y|| -|int_3::ref_z|| -|int_3::set_x|| -|int_3::set_xy|| -|int_3::set_xyz|| -|int_3::set_xz|| -|int_3::set_xzy|| -|int_3::set_y|| -|int_3::set_yx|| -|int_3::set_yxz|| -|int_3::set_yz|| -|int_3::set_yzx|| -|int_3::set_z|| -|int_3::set_zx|| -|int_3::set_zxy|| -|int_3::set_zy|| -|int_3::set_zyx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|int_3::operator-|| -|int_3::operator--|| -|int_3::operator%=|| -|int_3::operator&=|| -|int_3::operator*=|| -|int_3::operator/=|| -|int_3::operator^=|| -|int_3::operator\|=|| -|int_3::operator~|| -|int_3::operator++|| -|int_3::operator+=|| -|int_3::operator<\<=|| -|int_3::operator=|| -|int_3::operator-=|| -|int_3::operator>>=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|int_3::b|| -|int_3::bg|| -|int_3::bgr|| -|int_3::br|| -|int_3::brg|| -|int_3::g|| -|int_3::gb|| -|int_3::gbr|| -|int_3::gr|| -|int_3::grb|| -|int_3::r|| -|int_3::rb|| -|int_3::rbg|| -|int_3::rg|| -|int_3::rgb|| -|int_3::x|| -|int_3::xy|| -|int_3::xyz|| -|int_3::xz|| -|int_3::xzy|| -|int_3::y|| -|int_3::yx|| -|int_3::yxz|| -|int_3::yz|| -|int_3::yzx|| -|int_3::z|| -|int_3::zx|| -|int_3::zxy|| -|int_3::zy|| -|int_3::zyx|| - -## Inheritance Hierarchy - -`int_3` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## int_3 - -Default constructor, initializes all elements with 0. - -### Syntax - -```cpp -int_3() restrict(amp,cpu); -int_3( - int _V0, - int _V1, - int _V2 -) restrict(amp,cpu); -int_3( - int _V -) restrict(amp,cpu); -int_3( - const int_3& _Other -) restrict(amp,cpu); -explicit inline int_3( - const uint_3& _Other -) restrict(amp,cpu); -explicit inline int_3( - const float_3& _Other -) restrict(amp,cpu); -explicit inline int_3( - const unorm_3& _Other -) restrict(amp,cpu); -explicit inline int_3( - const norm_3& _Other -) restrict(amp,cpu); -explicit inline int_3( - const double_3& _Other -) restrict(amp,cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -### Syntax - -```cpp -static const int size = 3; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/int-4-class.md b/docs/parallel/amp/reference/int-4-class.md deleted file mode 100644 index ad9e159065f..00000000000 --- a/docs/parallel/amp/reference/int-4-class.md +++ /dev/null @@ -1,414 +0,0 @@ ---- -description: "Learn more about: int_4 Class" -title: "int_4 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::int_4::get_ywxz", "amp_short_vectors/Concurrency::graphics::int_4::xzyw", "amp_short_vectors/Concurrency::graphics::int_4::get_x", "amp_short_vectors/Concurrency::graphics::int_4::agr", "amp_short_vectors/Concurrency::graphics::int_4::set_ywxz", "amp_short_vectors/Concurrency::graphics::int_4::set_yzxw", "amp_short_vectors/Concurrency::graphics::int_4::get_zyw", "amp_short_vectors/Concurrency::graphics::int_4::set_zwyx", "amp_short_vectors/Concurrency::graphics::int_4::abgr", "amp_short_vectors/Concurrency::graphics::int_4::get_wzxy", "amp_short_vectors/Concurrency::graphics::int_4::get_wyxz", "amp_short_vectors/Concurrency::graphics::int_4::zyxw", "amp_short_vectors/Concurrency::graphics::int_4::rgb", "amp_short_vectors/Concurrency::graphics::int_4::wyxz", "amp_short_vectors/Concurrency::graphics::int_4::get_xwz", "amp_short_vectors/Concurrency::graphics::int_4::set_wyz", "amp_short_vectors/Concurrency::graphics::int_4::set_xz", "amp_short_vectors/Concurrency::graphics::int_4::gabr", "amp_short_vectors/Concurrency::graphics::int_4::gbr", "amp_short_vectors/Concurrency::graphics::int_4::set_wx", "amp_short_vectors/Concurrency::graphics::int_4::yxw", "amp_short_vectors/Concurrency::graphics::int_4::get_ywx", "amp_short_vectors/Concurrency::graphics::int_4::set_wxzy", "amp_short_vectors/Concurrency::graphics::int_4::get_yzx", "amp_short_vectors/Concurrency::graphics::int_4::yz", "amp_short_vectors/Concurrency::graphics::int_4::rg", "amp_short_vectors/Concurrency::graphics::int_4::rba", "amp_short_vectors/Concurrency::graphics::int_4::operator/=", "amp_short_vectors/Concurrency::graphics::int_4::get_wxy", "amp_short_vectors/Concurrency::graphics::int_4::set_yx", "amp_short_vectors/Concurrency::graphics::int_4::get_ywz", "amp_short_vectors/Concurrency::graphics::int_4::abg", "amp_short_vectors/Concurrency::graphics::int_4::get_y", "amp_short_vectors/Concurrency::graphics::int_4::ra", "amp_short_vectors/Concurrency::graphics::int_4::wxzy", "amp_short_vectors/Concurrency::graphics::int_4::rabg", "amp_short_vectors/Concurrency::graphics::int_4::ag", "amp_short_vectors/Concurrency::graphics::int_4::xwyz", "amp_short_vectors/Concurrency::graphics::int_4::zxy", "amp_short_vectors/Concurrency::graphics::int_4::x", "amp_short_vectors/Concurrency::graphics::int_4::bag", "amp_short_vectors/Concurrency::graphics::int_4::grb", "amp_short_vectors/Concurrency::graphics::int_4::xwz", "amp_short_vectors/Concurrency::graphics::int_4::get_wzx", "amp_short_vectors/Concurrency::graphics::int_4::operator*=", "amp_short_vectors/Concurrency::graphics::int_4::r", "amp_short_vectors/Concurrency::graphics::int_4::get_xzwy", "amp_short_vectors/Concurrency::graphics::int_4::bgra", "amp_short_vectors/Concurrency::graphics::int_4::xyzw", "amp_short_vectors/Concurrency::graphics::int_4::ab", "amp_short_vectors/Concurrency::graphics::int_4::set_xwyz", "amp_short_vectors/Concurrency::graphics::int_4::brg", "amp_short_vectors/Concurrency::graphics::int_4::garb", "amp_short_vectors/Concurrency::graphics::int_4::set_xzw", "amp_short_vectors/Concurrency::graphics::int_4::set_ywz", "amp_short_vectors/Concurrency::graphics::int_4::xywz", "amp_short_vectors/Concurrency::graphics::int_4::get_w", "amp_short_vectors/Concurrency::graphics::int_4::wzy", "amp_short_vectors/Concurrency::graphics::int_4::zwy", "amp_short_vectors/Concurrency::graphics::int_4::arb", "amp_short_vectors/Concurrency::graphics::int_4::agbr", "amp_short_vectors/Concurrency::graphics::int_4::get_yw", "amp_short_vectors/Concurrency::graphics::int_4::gra", "amp_short_vectors/Concurrency::graphics::int_4::get_yx", "amp_short_vectors/Concurrency::graphics::int_4::get_zyx", "amp_short_vectors/Concurrency::graphics::int_4::rag", "amp_short_vectors/Concurrency::graphics::int_4::b", "amp_short_vectors/Concurrency::graphics::int_4::rbag", "amp_short_vectors/Concurrency::graphics::int_4::set_zyw", "amp_short_vectors/Concurrency::graphics::int_4::grab", "amp_short_vectors/Concurrency::graphics::int_4::xzy", "amp_short_vectors/Concurrency::graphics::int_4::get_xwzy", "amp_short_vectors/Concurrency::graphics::int_4::wxy", "amp_short_vectors/Concurrency::graphics::int_4::abr", "amp_short_vectors/Concurrency::graphics::int_4::yw", "amp_short_vectors/Concurrency::graphics::int_4::set_zxyw", "amp_short_vectors/Concurrency::graphics::int_4::get_xyzw", "amp_short_vectors/Concurrency::graphics::int_4::set_wxz", "amp_short_vectors/Concurrency::graphics::int_4::get_yxwz", "amp_short_vectors/Concurrency::graphics::int_4::bar", "amp_short_vectors/Concurrency::graphics::int_4::zwxy", "amp_short_vectors/Concurrency::graphics::int_4::operator+=", "amp_short_vectors/Concurrency::graphics::int_4::get_zwy", "amp_short_vectors/Concurrency::graphics::int_4::get_xwyz", "amp_short_vectors/Concurrency::graphics::int_4::zxwy", "amp_short_vectors/Concurrency::graphics::int_4::barg", "amp_short_vectors/Concurrency::graphics::int_4::set_yxwz", "amp_short_vectors/Concurrency::graphics::int_4::operator=", "amp_short_vectors/Concurrency::graphics::int_4::get_xz", "amp_short_vectors/Concurrency::graphics::int_4::wz", "amp_short_vectors/Concurrency::graphics::int_4::w", "amp_short_vectors/Concurrency::graphics::int_4::set_zwy", "amp_short_vectors/Concurrency::graphics::int_4::yzx", "amp_short_vectors/Concurrency::graphics::int_4::set_xwzy", "amp_short_vectors/Concurrency::graphics::int_4::set_wzxy", "amp_short_vectors/Concurrency::graphics::int_4::get_yxz", "amp_short_vectors/Concurrency::graphics::int_4::set_ywx", "amp_short_vectors/Concurrency::graphics::int_4::get_zyxw", "amp_short_vectors/Concurrency::graphics::int_4::ragb", "amp_short_vectors/Concurrency::graphics::int_4::xzwy", "amp_short_vectors/Concurrency::graphics::int_4::get_wx", "amp_short_vectors/Concurrency::graphics::int_4::arbg", "amp_short_vectors/Concurrency::graphics::int_4::set_zxw", "amp_short_vectors/Concurrency::graphics::int_4::get_wyx", "amp_short_vectors/Concurrency::graphics::int_4::gab", "amp_short_vectors/Concurrency::graphics::int_4::agrb", "amp_short_vectors/Concurrency::graphics::int_4::bagr", "amp_short_vectors/Concurrency::graphics::int_4::get_wzyx", "amp_short_vectors/Concurrency::graphics::int_4::operator-=", "amp_short_vectors/Concurrency::graphics::int_4::get_wxz", "amp_short_vectors/Concurrency::graphics::int_4::get_xzw", "amp_short_vectors/Concurrency::graphics::int_4::gar", "amp_short_vectors/Concurrency::graphics::int_4::zw", "amp_short_vectors/Concurrency::graphics::int_4::yxzw", "amp_short_vectors/Concurrency::graphics::int_4::get_yxw", "amp_short_vectors/Concurrency::graphics::int_4::get_yxzw", "amp_short_vectors/Concurrency::graphics::int_4::operator++", "amp_short_vectors/Concurrency::graphics::int_4::xzw", "amp_short_vectors/Concurrency::graphics::int_4::arg", "amp_short_vectors/Concurrency::graphics::int_4::get_zwyx", "amp_short_vectors/Concurrency::graphics::int_4::g", "amp_short_vectors/Concurrency::graphics::int_4::set_zywx", "amp_short_vectors/Concurrency::graphics::int_4::z", "amp_short_vectors/Concurrency::graphics::int_4::get_z", "amp_short_vectors/Concurrency::graphics::int_4::get_zwxy", "amp_short_vectors/Concurrency::graphics::int_4::set_zyx", "amp_short_vectors/Concurrency::graphics::int_4", "amp_short_vectors/Concurrency::graphics::int_4::set_wy", "amp_short_vectors/Concurrency::graphics::int_4::bgr", "amp_short_vectors/Concurrency::graphics::int_4::xwy", "amp_short_vectors/Concurrency::graphics::int_4::xz", "amp_short_vectors/Concurrency::graphics::int_4::get_zwx", "amp_short_vectors/Concurrency::graphics::int_4::set_z", "amp_short_vectors/Concurrency::graphics::int_4::ywz", "amp_short_vectors/Concurrency::graphics::int_4::set_yz", "amp_short_vectors/Concurrency::graphics::int_4::wyx", "amp_short_vectors/Concurrency::graphics::int_4::get_yzwx", "amp_short_vectors/Concurrency::graphics::int_4::grba", "amp_short_vectors/Concurrency::graphics::int_4::bra", "amp_short_vectors/Concurrency::graphics::int_4::set_zxy", "amp_short_vectors/Concurrency::graphics::int_4::set_xzyw", "amp_short_vectors/Concurrency::graphics::int_4::get_zx", "amp_short_vectors/Concurrency::graphics::int_4::xyz", "amp_short_vectors/Concurrency::graphics::int_4::operator--", "amp_short_vectors/Concurrency::graphics::int_4::y", "amp_short_vectors/Concurrency::graphics::int_4::yzwx", "amp_short_vectors/Concurrency::graphics::int_4::agb", "amp_short_vectors/Concurrency::graphics::int_4::set_wyxz", "amp_short_vectors/Concurrency::graphics::int_4::set_xyzw", "amp_short_vectors/Concurrency::graphics::int_4::wzyx", "amp_short_vectors/Concurrency::graphics::int_4::rgab", "amp_short_vectors/Concurrency::graphics::int_4::set_wzy", "amp_short_vectors/Concurrency::graphics::int_4::set_wxyz", "amp_short_vectors/Concurrency::graphics::int_4::set_wyzx", "amp_short_vectors/Concurrency::graphics::int_4::wyzx", "amp_short_vectors/Concurrency::graphics::int_4::set_ywzx", "amp_short_vectors/Concurrency::graphics::int_4::zyw", "amp_short_vectors/Concurrency::graphics::int_4::get_xyw", "amp_short_vectors/Concurrency::graphics::int_4::ywxz", "amp_short_vectors/Concurrency::graphics::int_4::brag", "amp_short_vectors/Concurrency::graphics::int_4::get_yzw", "amp_short_vectors/Concurrency::graphics::int_4::get_xzy", "amp_short_vectors/Concurrency::graphics::int_4::get_xw", "amp_short_vectors/Concurrency::graphics::int_4::xw", "amp_short_vectors/Concurrency::graphics::int_4::gbra", "amp_short_vectors/Concurrency::graphics::int_4::set_wxy", "amp_short_vectors/Concurrency::graphics::int_4::get_xyz", "amp_short_vectors/Concurrency::graphics::int_4::get_zxyw", "amp_short_vectors/Concurrency::graphics::int_4::zwx", "amp_short_vectors/Concurrency::graphics::int_4::get_xzyw", "amp_short_vectors/Concurrency::graphics::int_4::set_xzwy", "amp_short_vectors/Concurrency::graphics::int_4::set_yxw", "amp_short_vectors/Concurrency::graphics::int_4::get_xy", "amp_short_vectors/Concurrency::graphics::int_4::get_wz", "amp_short_vectors/Concurrency::graphics::int_4::set_yw", "amp_short_vectors/Concurrency::graphics::int_4::rbga", "amp_short_vectors/Concurrency::graphics::int_4::ywzx", "amp_short_vectors/Concurrency::graphics::int_4::get_wxyz", "amp_short_vectors/Concurrency::graphics::int_4::ba", "amp_short_vectors/Concurrency::graphics::int_4::gba", "amp_short_vectors/Concurrency::graphics::int_4::set_zw", "amp_short_vectors/Concurrency::graphics::int_4::set_x", "amp_short_vectors/Concurrency::graphics::int_4::set_xwy", "amp_short_vectors/Concurrency::graphics::int_4::get_zxy", "amp_short_vectors/Concurrency::graphics::int_4::set_xwz", "amp_short_vectors/Concurrency::graphics::int_4::wyz", "amp_short_vectors/Concurrency::graphics::int_4::set_y", "amp_short_vectors/Concurrency::graphics::int_4::get_wyzx", "amp_short_vectors/Concurrency::graphics::int_4::set_zyxw", "amp_short_vectors/Concurrency::graphics::int_4::rgba", "amp_short_vectors/Concurrency::graphics::int_4::gr", "amp_short_vectors/Concurrency::graphics::int_4::set_yzx", "amp_short_vectors/Concurrency::graphics::int_4::set_xyz", "amp_short_vectors/Concurrency::graphics::int_4::get_xwy", "amp_short_vectors/Concurrency::graphics::int_4::get_wxzy", "amp_short_vectors/Concurrency::graphics::int_4::set_xzy", "amp_short_vectors/Concurrency::graphics::int_4::set_xy", "amp_short_vectors/Concurrency::graphics::int_4::rbg", "amp_short_vectors/Concurrency::graphics::int_4::br", "amp_short_vectors/Concurrency::graphics::int_4::get_yzxw", "amp_short_vectors/Concurrency::graphics::int_4::rab", "amp_short_vectors/Concurrency::graphics::int_4::set_xw", "amp_short_vectors/Concurrency::graphics::int_4::ga", "amp_short_vectors/Concurrency::graphics::int_4::wxyz", "amp_short_vectors/Concurrency::graphics::int_4::set_wzyx", "amp_short_vectors/Concurrency::graphics::int_4::zywx", "amp_short_vectors/Concurrency::graphics::int_4::xyw", "amp_short_vectors/Concurrency::graphics::int_4::bgar", "amp_short_vectors/Concurrency::graphics::int_4::xy", "amp_short_vectors/Concurrency::graphics::int_4::zxw", "amp_short_vectors/Concurrency::graphics::int_4::get_xywz", "amp_short_vectors/Concurrency::graphics::int_4::wy", "amp_short_vectors/Concurrency::graphics::int_4::zyx", "amp_short_vectors/Concurrency::graphics::int_4::get_zw", "amp_short_vectors/Concurrency::graphics::int_4::bga", "amp_short_vectors/Concurrency::graphics::int_4::set_zx", "amp_short_vectors/Concurrency::graphics::int_4::get_zywx", "amp_short_vectors/Concurrency::graphics::int_4::yzw", "amp_short_vectors/Concurrency::graphics::int_4::set_yzw", "amp_short_vectors/Concurrency::graphics::int_4::rb", "amp_short_vectors/Concurrency::graphics::int_4::set_w", "amp_short_vectors/Concurrency::graphics::int_4::get_wy", "amp_short_vectors/Concurrency::graphics::int_4::yzxw", "amp_short_vectors/Concurrency::graphics::int_4::wzx", "amp_short_vectors/Concurrency::graphics::int_4::zxyw", "amp_short_vectors/Concurrency::graphics::int_4::set_zwxy", "amp_short_vectors/Concurrency::graphics::int_4::get_wzy", "amp_short_vectors/Concurrency::graphics::int_4::zwyx", "amp_short_vectors/Concurrency::graphics::int_4::set_xywz", "amp_short_vectors/Concurrency::graphics::int_4::set_zxwy", "amp_short_vectors/Concurrency::graphics::int_4::set_zy", "amp_short_vectors/Concurrency::graphics::int_4::yx", "amp_short_vectors/Concurrency::graphics::int_4::set_yxzw", "amp_short_vectors/Concurrency::graphics::int_4::ar", "amp_short_vectors/Concurrency::graphics::int_4::yxwz", "amp_short_vectors/Concurrency::graphics::int_4::get_zxwy", "amp_short_vectors/Concurrency::graphics::int_4::rga", "amp_short_vectors/Concurrency::graphics::int_4::zy", "amp_short_vectors/Concurrency::graphics::int_4::operator-", "amp_short_vectors/Concurrency::graphics::int_4::xwzy", "amp_short_vectors/Concurrency::graphics::int_4::wxz", "amp_short_vectors/Concurrency::graphics::int_4::set_wzx", "amp_short_vectors/Concurrency::graphics::int_4::gb", "amp_short_vectors/Concurrency::graphics::int_4::get_yz", "amp_short_vectors/Concurrency::graphics::int_4::set_yzwx", "amp_short_vectors/Concurrency::graphics::int_4::get_wyz", "amp_short_vectors/Concurrency::graphics::int_4::set_wyx", "amp_short_vectors/Concurrency::graphics::int_4::get_zy", "amp_short_vectors/Concurrency::graphics::int_4::zx", "amp_short_vectors/Concurrency::graphics::int_4::set_xyw", "amp_short_vectors/Concurrency::graphics::int_4::wx", "amp_short_vectors/Concurrency::graphics::int_4::get_zxw", "amp_short_vectors/Concurrency::graphics::int_4::brga", "amp_short_vectors/Concurrency::graphics::int_4::set_zwx", "amp_short_vectors/Concurrency::graphics::int_4::a", "amp_short_vectors/Concurrency::graphics::int_4::ywx", "amp_short_vectors/Concurrency::graphics::int_4::wzxy", "amp_short_vectors/Concurrency::graphics::int_4::argb", "amp_short_vectors/Concurrency::graphics::int_4::set_wz", "amp_short_vectors/Concurrency::graphics::int_4::gbar", "amp_short_vectors/Concurrency::graphics::int_4::set_yxz", "amp_short_vectors/Concurrency::graphics::int_4::get_ywzx", "amp_short_vectors/Concurrency::graphics::int_4::abrg", "amp_short_vectors/Concurrency::graphics::int_4::bg", "amp_short_vectors/Concurrency::graphics::int_4::yxz"] -ms.assetid: 01768c28-23a8-4965-8267-96834864f4eb ---- -# int_4 Class - -Represents a short vector of four integers. - -## Syntax - -```cpp -class int_4; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[int_4 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|int_4::get_w|| -|int_4::get_wx|| -|int_4::get_wxy|| -|int_4::get_wxyz|| -|int_4::get_wxz|| -|int_4::get_wxzy|| -|int_4::get_wy|| -|int_4::get_wyx|| -|int_4::get_wyxz|| -|int_4::get_wyz|| -|int_4::get_wyzx|| -|int_4::get_wz|| -|int_4::get_wzx|| -|int_4::get_wzxy|| -|int_4::get_wzy|| -|int_4::get_wzyx|| -|int_4::get_x|| -|int_4::get_xw|| -|int_4::get_xwy|| -|int_4::get_xwyz|| -|int_4::get_xwz|| -|int_4::get_xwzy|| -|int_4::get_xy|| -|int_4::get_xyw|| -|int_4::get_xywz|| -|int_4::get_xyz|| -|int_4::get_xyzw|| -|int_4::get_xz|| -|int_4::get_xzw|| -|int_4::get_xzwy|| -|int_4::get_xzy|| -|int_4::get_xzyw|| -|int_4::get_y|| -|int_4::get_yw|| -|int_4::get_ywx|| -|int_4::get_ywxz|| -|int_4::get_ywz|| -|int_4::get_ywzx|| -|int_4::get_yx|| -|int_4::get_yxw|| -|int_4::get_yxwz|| -|int_4::get_yxz|| -|int_4::get_yxzw|| -|int_4::get_yz|| -|int_4::get_yzw|| -|int_4::get_yzwx|| -|int_4::get_yzx|| -|int_4::get_yzxw|| -|int_4::get_z|| -|int_4::get_zw|| -|int_4::get_zwx|| -|int_4::get_zwxy|| -|int_4::get_zwy|| -|int_4::get_zwyx|| -|int_4::get_zx|| -|int_4::get_zxw|| -|int_4::get_zxwy|| -|int_4::get_zxy|| -|int_4::get_zxyw|| -|int_4::get_zy|| -|int_4::get_zyw|| -|int_4::get_zywx|| -|int_4::get_zyx|| -|int_4::get_zyxw|| -|int_4::ref_a|| -|int_4::ref_b|| -|int_4::ref_g|| -|int_4::ref_r|| -|int_4::ref_w|| -|int_4::ref_x|| -|int_4::ref_y|| -|int_4::ref_z|| -|int_4::set_w|| -|int_4::set_wx|| -|int_4::set_wxy|| -|int_4::set_wxyz|| -|int_4::set_wxz|| -|int_4::set_wxzy|| -|int_4::set_wy|| -|int_4::set_wyx|| -|int_4::set_wyxz|| -|int_4::set_wyz|| -|int_4::set_wyzx|| -|int_4::set_wz|| -|int_4::set_wzx|| -|int_4::set_wzxy|| -|int_4::set_wzy|| -|int_4::set_wzyx|| -|int_4::set_x|| -|int_4::set_xw|| -|int_4::set_xwy|| -|int_4::set_xwyz|| -|int_4::set_xwz|| -|int_4::set_xwzy|| -|int_4::set_xy|| -|int_4::set_xyw|| -|int_4::set_xywz|| -|int_4::set_xyz|| -|int_4::set_xyzw|| -|int_4::set_xz|| -|int_4::set_xzw|| -|int_4::set_xzwy|| -|int_4::set_xzy|| -|int_4::set_xzyw|| -|int_4::set_y|| -|int_4::set_yw|| -|int_4::set_ywx|| -|int_4::set_ywxz|| -|int_4::set_ywz|| -|int_4::set_ywzx|| -|int_4::set_yx|| -|int_4::set_yxw|| -|int_4::set_yxwz|| -|int_4::set_yxz|| -|int_4::set_yxzw|| -|int_4::set_yz|| -|int_4::set_yzw|| -|int_4::set_yzwx|| -|int_4::set_yzx|| -|int_4::set_yzxw|| -|int_4::set_z|| -|int_4::set_zw|| -|int_4::set_zwx|| -|int_4::set_zwxy|| -|int_4::set_zwy|| -|int_4::set_zwyx|| -|int_4::set_zx|| -|int_4::set_zxw|| -|int_4::set_zxwy|| -|int_4::set_zxy|| -|int_4::set_zxyw|| -|int_4::set_zy|| -|int_4::set_zyw|| -|int_4::set_zywx|| -|int_4::set_zyx|| -|int_4::set_zyxw|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|int_4::operator-|| -|int_4::operator--|| -|int_4::operator%=|| -|int_4::operator&=|| -|int_4::operator*=|| -|int_4::operator/=|| -|int_4::operator^=|| -|int_4::operator\|=|| -|int_4::operator~|| -|int_4::operator++|| -|int_4::operator+=|| -|int_4::operator<\<=|| -|int_4::operator=|| -|int_4::operator-=|| -|int_4::operator>>=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#int_4__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|int_4::a|| -|int_4::ab|| -|int_4::abg|| -|int_4::abgr|| -|int_4::abr|| -|int_4::abrg|| -|int_4::ag|| -|int_4::agb|| -|int_4::agbr|| -|int_4::agr|| -|int_4::agrb|| -|int_4::ar|| -|int_4::arb|| -|int_4::arbg|| -|int_4::arg|| -|int_4::argb|| -|int_4::b|| -|int_4::ba|| -|int_4::bag|| -|int_4::bagr|| -|int_4::bar|| -|int_4::barg|| -|int_4::bg|| -|int_4::bga|| -|int_4::bgar|| -|int_4::bgr|| -|int_4::bgra|| -|int_4::br|| -|int_4::bra|| -|int_4::brag|| -|int_4::brg|| -|int_4::brga|| -|int_4::g|| -|int_4::ga|| -|int_4::gab|| -|int_4::gabr|| -|int_4::gar|| -|int_4::garb|| -|int_4::gb|| -|int_4::gba|| -|int_4::gbar|| -|int_4::gbr|| -|int_4::gbra|| -|int_4::gr|| -|int_4::gra|| -|int_4::grab|| -|int_4::grb|| -|int_4::grba|| -|int_4::r|| -|int_4::ra|| -|int_4::rab|| -|int_4::rabg|| -|int_4::rag|| -|int_4::ragb|| -|int_4::rb|| -|int_4::rba|| -|int_4::rbag|| -|int_4::rbg|| -|int_4::rbga|| -|int_4::rg|| -|int_4::rga|| -|int_4::rgab|| -|int_4::rgb|| -|int_4::rgba|| -|int_4::w|| -|int_4::wx|| -|int_4::wxy|| -|int_4::wxyz|| -|int_4::wxz|| -|int_4::wxzy|| -|int_4::wy|| -|int_4::wyx|| -|int_4::wyxz|| -|int_4::wyz|| -|int_4::wyzx|| -|int_4::wz|| -|int_4::wzx|| -|int_4::wzxy|| -|int_4::wzy|| -|int_4::wzyx|| -|int_4::x|| -|int_4::xw|| -|int_4::xwy|| -|int_4::xwyz|| -|int_4::xwz|| -|int_4::xwzy|| -|int_4::xy|| -|int_4::xyw|| -|int_4::xywz|| -|int_4::xyz|| -|int_4::xyzw|| -|int_4::xz|| -|int_4::xzw|| -|int_4::xzwy|| -|int_4::xzy|| -|int_4::xzyw|| -|int_4::y|| -|int_4::yw|| -|int_4::ywx|| -|int_4::ywxz|| -|int_4::ywz|| -|int_4::ywzx|| -|int_4::yx|| -|int_4::yxw|| -|int_4::yxwz|| -|int_4::yxz|| -|int_4::yxzw|| -|int_4::yz|| -|int_4::yzw|| -|int_4::yzwx|| -|int_4::yzx|| -|int_4::yzxw|| -|int_4::z|| -|int_4::zw|| -|int_4::zwx|| -|int_4::zwxy|| -|int_4::zwy|| -|int_4::zwyx|| -|int_4::zx|| -|int_4::zxw|| -|int_4::zxwy|| -|int_4::zxy|| -|int_4::zxyw|| -|int_4::zy|| -|int_4::zyw|| -|int_4::zywx|| -|int_4::zyx|| -|int_4::zyxw|| - -## Inheritance Hierarchy - -`int_4` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## int_4 - -Default constructor, initializes all elements with 0. - -```cpp -int_4() restrict(amp, - cpu); - -int_4( - int _V0, - int _V1, - int _V2, - int _V3) restrict(amp, - cpu); - -int_4( - int _V) restrict(amp, - cpu); - -int_4( - const int_4& _Other) restrict(amp, - cpu); - -explicit inline int_4( - const uint_4& _Other) restrict(amp, - cpu); - -explicit inline int_4( - const float_4& _Other) restrict(amp, - cpu); - -explicit inline int_4( - const unorm_4& _Other) restrict(amp, - cpu); - -explicit inline int_4( - const norm_4& _Other) restrict(amp, - cpu); - -explicit inline int_4( - const double_4& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V3*
-The value to initialize element 3. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 4; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/invalid-compute-domain-class.md b/docs/parallel/amp/reference/invalid-compute-domain-class.md deleted file mode 100644 index 333ee60fc80..00000000000 --- a/docs/parallel/amp/reference/invalid-compute-domain-class.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -description: "Learn more about: invalid_compute_domain Class" -title: "invalid_compute_domain Class" -ms.date: "11/04/2016" -f1_keywords: ["invalid_compute_domain", "AMPRT/invalid_compute_domain", "AMPRT/Concurrency::invalid_compute_domain::invalid_compute_domain"] -helpviewer_keywords: ["invalid_compute_domain class"] -ms.assetid: ac7a7166-8bdb-4db1-8caf-ea129ab5117e ---- -# invalid_compute_domain Class - -The exception that's thrown when the runtime can't start a kernel by using the compute domain specified at the [parallel_for_each](concurrency-namespace-functions-amp.md#parallel_for_each) call site. - -## Syntax - -```cpp -class invalid_compute_domain : public runtime_exception; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[invalid_compute_domain Constructor](#ctor)|Initializes a new instance of the `invalid_compute_domain` class.| - -## Inheritance Hierarchy - -`exception` - -`runtime_exception` - -`invalid_compute_domain` - -## Requirements - -**Header:** amprt.h - -**Namespace:** Concurrency - -## invalid_compute_domain - -Initializes a new instance of the class. - -### Syntax - -```cpp -explicit invalid_compute_domain( - const char * _Message ) throw(); - -invalid_compute_domain() throw(); -``` - -### Parameters - -*_Message*
-A description of the error. - -### Return Value - -An instance of the `invalid_compute_domain` class - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/norm-2-class.md b/docs/parallel/amp/reference/norm-2-class.md deleted file mode 100644 index 4a244b33204..00000000000 --- a/docs/parallel/amp/reference/norm-2-class.md +++ /dev/null @@ -1,169 +0,0 @@ ---- -description: "Learn more about: norm_2 Class" -title: "norm_2 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::norm_2::set_x", "amp_short_vectors/Concurrency::graphics::norm_2::set_xy", "amp_short_vectors/Concurrency::graphics::norm_2::g", "amp_short_vectors/Concurrency::graphics::norm_2::get_yx", "amp_short_vectors/Concurrency::graphics::norm_2::set_yx", "amp_short_vectors/Concurrency::graphics::norm_2::operator-=", "amp_short_vectors/Concurrency::graphics::norm_2::operator/=", "amp_short_vectors/Concurrency::graphics::norm_2::operator*=", "amp_short_vectors/Concurrency::graphics::norm_2::yx", "amp_short_vectors/Concurrency::graphics::norm_2::y", "amp_short_vectors/Concurrency::graphics::norm_2::xy", "amp_short_vectors/Concurrency::graphics::norm_2::operator++", "amp_short_vectors/Concurrency::graphics::norm_2::operator-", "amp_short_vectors/Concurrency::graphics::norm_2::rg", "amp_short_vectors/Concurrency::graphics::norm_2::operator=", "amp_short_vectors/Concurrency::graphics::norm_2::get_y", "amp_short_vectors/Concurrency::graphics::norm_2::r", "amp_short_vectors/Concurrency::graphics::norm_2::get_x", "amp_short_vectors/Concurrency::graphics::norm_2::get_xy", "amp_short_vectors/Concurrency::graphics::norm_2::gr", "amp_short_vectors/Concurrency::graphics::norm_2::set_y", "amp_short_vectors/Concurrency::graphics::norm_2::x", "amp_short_vectors/Concurrency::graphics::norm_2::operator+=", "amp_short_vectors/Concurrency::graphics::norm_2", "amp_short_vectors/Concurrency::graphics::norm_2::operator--"] -ms.assetid: 80703f9b-61f4-414a-93fd-bc774f7d3393 ---- -# norm_2 Class - -Represents a short vector of two normal numbers. - -## Syntax - -```cpp -class norm_2; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[norm_2 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|norm_2::get_x|| -|norm_2::get_xy|| -|norm_2::get_y|| -|norm_2::get_yx|| -|norm_2::ref_g|| -|norm_2::ref_r|| -|norm_2::ref_x|| -|norm_2::ref_y|| -|norm_2::set_x|| -|norm_2::set_xy|| -|norm_2::set_y|| -|norm_2::set_yx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|norm_2::operator-|| -|norm_2::operator--|| -|norm_2::operator*=|| -|norm_2::operator/=|| -|norm_2::operator++|| -|norm_2::operator+=|| -|norm_2::operator=|| -|norm_2::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#norm_2__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|norm_2::g|| -|norm_2::gr|| -|norm_2::r|| -|norm_2::rg|| -|norm_2::x|| -|norm_2::xy|| -|norm_2::y|| -|norm_2::yx|| - -## Inheritance Hierarchy - -`norm_2` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## norm_2 - -Default constructor, initializes all elements with 0. - -```cpp -norm_2() restrict(amp, - cpu); - -norm_2( - norm _V0, - norm _V1) restrict(amp, - cpu); - -norm_2( - float _V0, - float _V1) restrict(amp, - cpu); - -norm_2( - unorm _V0, - unorm _V1) restrict(amp, - cpu); - -norm_2( - norm _V) restrict(amp, - cpu); - -explicit norm_2( - float _V) restrict(amp, - cpu); - -norm_2( - const norm_2& _Other) restrict(amp, - cpu); - -explicit inline norm_2( - const uint_2& _Other) restrict(amp, - cpu); - -explicit inline norm_2( - const int_2& _Other) restrict(amp, - cpu); - -explicit inline norm_2( - const float_2& _Other) restrict(amp, - cpu); - -explicit inline norm_2( - const unorm_2& _Other) restrict(amp, - cpu); - -explicit inline norm_2( - const double_2& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 2; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/norm-3-class.md b/docs/parallel/amp/reference/norm-3-class.md deleted file mode 100644 index a0e3841d4dd..00000000000 --- a/docs/parallel/amp/reference/norm-3-class.md +++ /dev/null @@ -1,212 +0,0 @@ ---- -title: "norm_3 Class" -description: "Learn more about: norm_3 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::norm_3::get_z", "amp_short_vectors/Concurrency::graphics::norm_3::operator=", "amp_short_vectors/Concurrency::graphics::norm_3::r", "amp_short_vectors/Concurrency::graphics::norm_3::set_zyx", "amp_short_vectors/Concurrency::graphics::norm_3::xyz", "amp_short_vectors/Concurrency::graphics::norm_3::operator/=", "amp_short_vectors/Concurrency::graphics::norm_3::yz", "amp_short_vectors/Concurrency::graphics::norm_3::get_xyz", "amp_short_vectors/Concurrency::graphics::norm_3::br", "amp_short_vectors/Concurrency::graphics::norm_3::xy", "amp_short_vectors/Concurrency::graphics::norm_3::get_yzx", "amp_short_vectors/Concurrency::graphics::norm_3::set_xyz", "amp_short_vectors/Concurrency::graphics::norm_3::gr", "amp_short_vectors/Concurrency::graphics::norm_3::g", "amp_short_vectors/Concurrency::graphics::norm_3::set_yxz", "amp_short_vectors/Concurrency::graphics::norm_3::get_zyx", "amp_short_vectors/Concurrency::graphics::norm_3::get_y", "amp_short_vectors/Concurrency::graphics::norm_3::zx", "amp_short_vectors/Concurrency::graphics::norm_3::yzx", "amp_short_vectors/Concurrency::graphics::norm_3::gb", "amp_short_vectors/Concurrency::graphics::norm_3::xzy", "amp_short_vectors/Concurrency::graphics::norm_3::xz", "amp_short_vectors/Concurrency::graphics::norm_3::rb", "amp_short_vectors/Concurrency::graphics::norm_3::rgb", "amp_short_vectors/Concurrency::graphics::norm_3::b", "amp_short_vectors/Concurrency::graphics::norm_3::z", "amp_short_vectors/Concurrency::graphics::norm_3::operator*=", "amp_short_vectors/Concurrency::graphics::norm_3::operator+=", "amp_short_vectors/Concurrency::graphics::norm_3::get_zy", "amp_short_vectors/Concurrency::graphics::norm_3::get_xz", "amp_short_vectors/Concurrency::graphics::norm_3::gbr", "amp_short_vectors/Concurrency::graphics::norm_3::get_yz", "amp_short_vectors/Concurrency::graphics::norm_3::get_zx", "amp_short_vectors/Concurrency::graphics::norm_3::get_xzy", "amp_short_vectors/Concurrency::graphics::norm_3::set_xz", "amp_short_vectors/Concurrency::graphics::norm_3::set_xzy", "amp_short_vectors/Concurrency::graphics::norm_3::set_zy", "amp_short_vectors/Concurrency::graphics::norm_3::get_xy", "amp_short_vectors/Concurrency::graphics::norm_3::y", "amp_short_vectors/Concurrency::graphics::norm_3::yx", "amp_short_vectors/Concurrency::graphics::norm_3::rbg", "amp_short_vectors/Concurrency::graphics::norm_3::zxy", "amp_short_vectors/Concurrency::graphics::norm_3", "amp_short_vectors/Concurrency::graphics::norm_3::set_yz", "amp_short_vectors/Concurrency::graphics::norm_3::brg", "amp_short_vectors/Concurrency::graphics::norm_3::operator--", "amp_short_vectors/Concurrency::graphics::norm_3::yxz", "amp_short_vectors/Concurrency::graphics::norm_3::x", "amp_short_vectors/Concurrency::graphics::norm_3::set_x", "amp_short_vectors/Concurrency::graphics::norm_3::get_x", "amp_short_vectors/Concurrency::graphics::norm_3::get_yxz", "amp_short_vectors/Concurrency::graphics::norm_3::grb", "amp_short_vectors/Concurrency::graphics::norm_3::get_yx", "amp_short_vectors/Concurrency::graphics::norm_3::zy", "amp_short_vectors/Concurrency::graphics::norm_3::rg", "amp_short_vectors/Concurrency::graphics::norm_3::set_yzx", "amp_short_vectors/Concurrency::graphics::norm_3::operator-=", "amp_short_vectors/Concurrency::graphics::norm_3::bg", "amp_short_vectors/Concurrency::graphics::norm_3::operator++", "amp_short_vectors/Concurrency::graphics::norm_3::set_y", "amp_short_vectors/Concurrency::graphics::norm_3::zyx", "amp_short_vectors/Concurrency::graphics::norm_3::set_z", "amp_short_vectors/Concurrency::graphics::norm_3::operator-", "amp_short_vectors/Concurrency::graphics::norm_3::get_zxy", "amp_short_vectors/Concurrency::graphics::norm_3::set_xy", "amp_short_vectors/Concurrency::graphics::norm_3::set_zxy", "amp_short_vectors/Concurrency::graphics::norm_3::set_yx", "amp_short_vectors/Concurrency::graphics::norm_3::set_zx", "amp_short_vectors/Concurrency::graphics::norm_3::bgr"] ---- -# norm_3 Class - -Represents a short vector of three normal numbers. - -## Syntax - -```cpp -class norm_3; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[norm_3 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|norm_3::get_x|| -|norm_3::get_xy|| -|norm_3::get_xyz|| -|norm_3::get_xz|| -|norm_3::get_xzy|| -|norm_3::get_y|| -|norm_3::get_yx|| -|norm_3::get_yxz|| -|norm_3::get_yz|| -|norm_3::get_yzx|| -|norm_3::get_z|| -|norm_3::get_zx|| -|norm_3::get_zxy|| -|norm_3::get_zy|| -|norm_3::get_zyx|| -|norm_3::ref_b|| -|norm_3::ref_g|| -|norm_3::ref_r|| -|norm_3::ref_x|| -|norm_3::ref_y|| -|norm_3::ref_z|| -|norm_3::set_x|| -|norm_3::set_xy|| -|norm_3::set_xyz|| -|norm_3::set_xz|| -|norm_3::set_xzy|| -|norm_3::set_y|| -|norm_3::set_yx|| -|norm_3::set_yxz|| -|norm_3::set_yz|| -|norm_3::set_yzx|| -|norm_3::set_z|| -|norm_3::set_zx|| -|norm_3::set_zxy|| -|norm_3::set_zy|| -|norm_3::set_zyx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|norm_3::operator-|| -|norm_3::operator--|| -|norm_3::operator*=|| -|norm_3::operator/=|| -|norm_3::operator++|| -|norm_3::operator+=|| -|norm_3::operator=|| -|norm_3::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|norm_3::b|| -|norm_3::bg|| -|norm_3::bgr|| -|norm_3::br|| -|norm_3::brg|| -|norm_3::g|| -|norm_3::gb|| -|norm_3::gbr|| -|norm_3::gr|| -|norm_3::grb|| -|norm_3::r|| -|norm_3::rb|| -|norm_3::rbg|| -|norm_3::rg|| -|norm_3::rgb|| -|norm_3::x|| -|norm_3::xy|| -|norm_3::xyz|| -|norm_3::xz|| -|norm_3::xzy|| -|norm_3::y|| -|norm_3::yx|| -|norm_3::yxz|| -|norm_3::yz|| -|norm_3::yzx|| -|norm_3::z|| -|norm_3::zx|| -|norm_3::zxy|| -|norm_3::zy|| -|norm_3::zyx|| - -## Inheritance Hierarchy - -`norm_3` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## norm_3 Constructor - -Default constructor, initializes all elements with 0. - -### Syntax - -```cpp -norm_3() restrict(amp,cpu); -norm_3( - norm _V0, - norm _V1, - norm _V2 -) restrict(amp,cpu); -norm_3( - float _V0, - float _V1, - float _V2 -) restrict(amp,cpu); -norm_3( - unorm _V0, - unorm _V1, - unorm _V2 -) restrict(amp,cpu); -norm_3( - norm _V -) restrict(amp,cpu); -explicit norm_3( - float _V -) restrict(amp,cpu); -norm_3( - const norm_3& _Other -) restrict(amp,cpu); -explicit inline norm_3( - const uint_3& _Other -) restrict(amp,cpu); -explicit inline norm_3( - const int_3& _Other -) restrict(amp,cpu); -explicit inline norm_3( - const float_3& _Other -) restrict(amp,cpu); -explicit inline norm_3( - const unorm_3& _Other -) restrict(amp,cpu); -explicit inline norm_3( - const double_3& _Other -) restrict(amp,cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size Constant - -### Syntax - -```cpp -static const int size = 3; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/norm-4-class.md b/docs/parallel/amp/reference/norm-4-class.md deleted file mode 100644 index 0b0262d23a5..00000000000 --- a/docs/parallel/amp/reference/norm-4-class.md +++ /dev/null @@ -1,425 +0,0 @@ ---- -description: "Learn more about: norm_4 Class" -title: "norm_4 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::norm_4::grab", "amp_short_vectors/Concurrency::graphics::norm_4::agrb", "amp_short_vectors/Concurrency::graphics::norm_4::bg", "amp_short_vectors/Concurrency::graphics::norm_4::get_wx", "amp_short_vectors/Concurrency::graphics::norm_4::rabg", "amp_short_vectors/Concurrency::graphics::norm_4::get_wxz", "amp_short_vectors/Concurrency::graphics::norm_4::get_zxyw", "amp_short_vectors/Concurrency::graphics::norm_4::get_ywxz", "amp_short_vectors/Concurrency::graphics::norm_4::zwyx", "amp_short_vectors/Concurrency::graphics::norm_4::set_yxzw", "amp_short_vectors/Concurrency::graphics::norm_4::rag", "amp_short_vectors/Concurrency::graphics::norm_4::operator--", "amp_short_vectors/Concurrency::graphics::norm_4::agbr", "amp_short_vectors/Concurrency::graphics::norm_4::set_zyw", "amp_short_vectors/Concurrency::graphics::norm_4::y", "amp_short_vectors/Concurrency::graphics::norm_4::get_xzy", "amp_short_vectors/Concurrency::graphics::norm_4::get_wxy", "amp_short_vectors/Concurrency::graphics::norm_4::get_ywzx", "amp_short_vectors/Concurrency::graphics::norm_4::grba", "amp_short_vectors/Concurrency::graphics::norm_4::get_xwz", "amp_short_vectors/Concurrency::graphics::norm_4::xzy", "amp_short_vectors/Concurrency::graphics::norm_4::get_xywz", "amp_short_vectors/Concurrency::graphics::norm_4::get_ywx", "amp_short_vectors/Concurrency::graphics::norm_4::abgr", "amp_short_vectors/Concurrency::graphics::norm_4::get_xyzw", "amp_short_vectors/Concurrency::graphics::norm_4::ywx", "amp_short_vectors/Concurrency::graphics::norm_4::argb", "amp_short_vectors/Concurrency::graphics::norm_4::set_ywx", "amp_short_vectors/Concurrency::graphics::norm_4::set_yzx", "amp_short_vectors/Concurrency::graphics::norm_4::b", "amp_short_vectors/Concurrency::graphics::norm_4::arb", "amp_short_vectors/Concurrency::graphics::norm_4::rab", "amp_short_vectors/Concurrency::graphics::norm_4::gb", "amp_short_vectors/Concurrency::graphics::norm_4::yzxw", "amp_short_vectors/Concurrency::graphics::norm_4::bagr", "amp_short_vectors/Concurrency::graphics::norm_4::wyzx", "amp_short_vectors/Concurrency::graphics::norm_4::gba", "amp_short_vectors/Concurrency::graphics::norm_4::wz", "amp_short_vectors/Concurrency::graphics::norm_4::get_yz", "amp_short_vectors/Concurrency::graphics::norm_4::rgab", "amp_short_vectors/Concurrency::graphics::norm_4::get_wxzy", "amp_short_vectors/Concurrency::graphics::norm_4::set_wzyx", "amp_short_vectors/Concurrency::graphics::norm_4::set_yzxw", "amp_short_vectors/Concurrency::graphics::norm_4::xzw", "amp_short_vectors/Concurrency::graphics::norm_4::zwxy", "amp_short_vectors/Concurrency::graphics::norm_4::yzw", "amp_short_vectors/Concurrency::graphics::norm_4::set_zxw", "amp_short_vectors/Concurrency::graphics::norm_4::ywxz", "amp_short_vectors/Concurrency::graphics::norm_4::yxz", "amp_short_vectors/Concurrency::graphics::norm_4::rbg", "amp_short_vectors/Concurrency::graphics::norm_4::get_wyz", "amp_short_vectors/Concurrency::graphics::norm_4::get_zwyx", "amp_short_vectors/Concurrency::graphics::norm_4::set_zxwy", "amp_short_vectors/Concurrency::graphics::norm_4::set_xzwy", "amp_short_vectors/Concurrency::graphics::norm_4::set_zxyw", "amp_short_vectors/Concurrency::graphics::norm_4::get_wzyx", "amp_short_vectors/Concurrency::graphics::norm_4::barg", "amp_short_vectors/Concurrency::graphics::norm_4::set_zywx", "amp_short_vectors/Concurrency::graphics::norm_4::set_wx", "amp_short_vectors/Concurrency::graphics::norm_4::bar", "amp_short_vectors/Concurrency::graphics::norm_4::a", "amp_short_vectors/Concurrency::graphics::norm_4::set_xyz", "amp_short_vectors/Concurrency::graphics::norm_4::gab", "amp_short_vectors/Concurrency::graphics::norm_4::gbra", "amp_short_vectors/Concurrency::graphics::norm_4::agr", "amp_short_vectors/Concurrency::graphics::norm_4::xzyw", "amp_short_vectors/Concurrency::graphics::norm_4::rg", "amp_short_vectors/Concurrency::graphics::norm_4::get_wzxy", "amp_short_vectors/Concurrency::graphics::norm_4::operator=", "amp_short_vectors/Concurrency::graphics::norm_4::wxzy", "amp_short_vectors/Concurrency::graphics::norm_4::get_x", "amp_short_vectors/Concurrency::graphics::norm_4::bra", "amp_short_vectors/Concurrency::graphics::norm_4::get_xwzy", "amp_short_vectors/Concurrency::graphics::norm_4::yzwx", "amp_short_vectors/Concurrency::graphics::norm_4::wzyx", "amp_short_vectors/Concurrency::graphics::norm_4::gbar", "amp_short_vectors/Concurrency::graphics::norm_4::set_wyzx", "amp_short_vectors/Concurrency::graphics::norm_4::set_yxz", "amp_short_vectors/Concurrency::graphics::norm_4::wzxy", "amp_short_vectors/Concurrency::graphics::norm_4::garb", "amp_short_vectors/Concurrency::graphics::norm_4::bgar", "amp_short_vectors/Concurrency::graphics::norm_4::set_zx", "amp_short_vectors/Concurrency::graphics::norm_4::bgr", "amp_short_vectors/Concurrency::graphics::norm_4::ga", "amp_short_vectors/Concurrency::graphics::norm_4::set_wzy", "amp_short_vectors/Concurrency::graphics::norm_4::zxw", "amp_short_vectors/Concurrency::graphics::norm_4::get_xwyz", "amp_short_vectors/Concurrency::graphics::norm_4::yzx", "amp_short_vectors/Concurrency::graphics::norm_4::get_wy", "amp_short_vectors/Concurrency::graphics::norm_4::get_xwy", "amp_short_vectors/Concurrency::graphics::norm_4::set_xw", "amp_short_vectors/Concurrency::graphics::norm_4::yz", "amp_short_vectors/Concurrency::graphics::norm_4::w", "amp_short_vectors/Concurrency::graphics::norm_4::wxyz", "amp_short_vectors/Concurrency::graphics::norm_4::set_w", "amp_short_vectors/Concurrency::graphics::norm_4::gar", "amp_short_vectors/Concurrency::graphics::norm_4::get_yzx", "amp_short_vectors/Concurrency::graphics::norm_4::set_zwx", "amp_short_vectors/Concurrency::graphics::norm_4::set_wxzy", "amp_short_vectors/Concurrency::graphics::norm_4::xyz", "amp_short_vectors/Concurrency::graphics::norm_4::set_wz", "amp_short_vectors/Concurrency::graphics::norm_4::get_xz", "amp_short_vectors/Concurrency::graphics::norm_4::set_zwxy", "amp_short_vectors/Concurrency::graphics::norm_4::get_w", "amp_short_vectors/Concurrency::graphics::norm_4::set_yzw", "amp_short_vectors/Concurrency::graphics::norm_4::set_yx", "amp_short_vectors/Concurrency::graphics::norm_4::rga", "amp_short_vectors/Concurrency::graphics::norm_4::xwy", "amp_short_vectors/Concurrency::graphics::norm_4::wzy", "amp_short_vectors/Concurrency::graphics::norm_4::wzx", "amp_short_vectors/Concurrency::graphics::norm_4::xz", "amp_short_vectors/Concurrency::graphics::norm_4::brga", "amp_short_vectors/Concurrency::graphics::norm_4::brag", "amp_short_vectors/Concurrency::graphics::norm_4::set_wyz", "amp_short_vectors/Concurrency::graphics::norm_4::ra", "amp_short_vectors/Concurrency::graphics::norm_4::get_xzwy", "amp_short_vectors/Concurrency::graphics::norm_4::zyx", "amp_short_vectors/Concurrency::graphics::norm_4::yw", "amp_short_vectors/Concurrency::graphics::norm_4::set_yzwx", "amp_short_vectors/Concurrency::graphics::norm_4::get_yxz", "amp_short_vectors/Concurrency::graphics::norm_4::xwzy", "amp_short_vectors/Concurrency::graphics::norm_4::get_zyw", "amp_short_vectors/Concurrency::graphics::norm_4::gbr", "amp_short_vectors/Concurrency::graphics::norm_4::zxyw", "amp_short_vectors/Concurrency::graphics::norm_4::wyx", "amp_short_vectors/Concurrency::graphics::norm_4::get_zyxw", "amp_short_vectors/Concurrency::graphics::norm_4::get_zwy", "amp_short_vectors/Concurrency::graphics::norm_4::set_zxy", "amp_short_vectors/Concurrency::graphics::norm_4::ywz", "amp_short_vectors/Concurrency::graphics::norm_4::xy", "amp_short_vectors/Concurrency::graphics::norm_4", "amp_short_vectors/Concurrency::graphics::norm_4::set_wxyz", "amp_short_vectors/Concurrency::graphics::norm_4::r", "amp_short_vectors/Concurrency::graphics::norm_4::get_zwx", "amp_short_vectors/Concurrency::graphics::norm_4::get_xw", "amp_short_vectors/Concurrency::graphics::norm_4::xyw", "amp_short_vectors/Concurrency::graphics::norm_4::wxy", "amp_short_vectors/Concurrency::graphics::norm_4::set_wxz", "amp_short_vectors/Concurrency::graphics::norm_4::agb", "amp_short_vectors/Concurrency::graphics::norm_4::bga", "amp_short_vectors/Concurrency::graphics::norm_4::gr", "amp_short_vectors/Concurrency::graphics::norm_4::arg", "amp_short_vectors/Concurrency::graphics::norm_4::rgba", "amp_short_vectors/Concurrency::graphics::norm_4::arbg", "amp_short_vectors/Concurrency::graphics::norm_4::yx", "amp_short_vectors/Concurrency::graphics::norm_4::set_yz", "amp_short_vectors/Concurrency::graphics::norm_4::set_yxwz", "amp_short_vectors/Concurrency::graphics::norm_4::get_wyzx", "amp_short_vectors/Concurrency::graphics::norm_4::get_yzw", "amp_short_vectors/Concurrency::graphics::norm_4::set_yw", "amp_short_vectors/Concurrency::graphics::norm_4::brg", "amp_short_vectors/Concurrency::graphics::norm_4::zxy", "amp_short_vectors/Concurrency::graphics::norm_4::operator-", "amp_short_vectors/Concurrency::graphics::norm_4::yxzw", "amp_short_vectors/Concurrency::graphics::norm_4::rbga", "amp_short_vectors/Concurrency::graphics::norm_4::set_zyxw", "amp_short_vectors/Concurrency::graphics::norm_4::zwy", "amp_short_vectors/Concurrency::graphics::norm_4::abr", "amp_short_vectors/Concurrency::graphics::norm_4::get_zwxy", "amp_short_vectors/Concurrency::graphics::norm_4::br", "amp_short_vectors/Concurrency::graphics::norm_4::set_xzy", "amp_short_vectors/Concurrency::graphics::norm_4::get_zx", "amp_short_vectors/Concurrency::graphics::norm_4::rgb", "amp_short_vectors/Concurrency::graphics::norm_4::get_zy", "amp_short_vectors/Concurrency::graphics::norm_4::zw", "amp_short_vectors/Concurrency::graphics::norm_4::set_ywzx", "amp_short_vectors/Concurrency::graphics::norm_4::set_xy", "amp_short_vectors/Concurrency::graphics::norm_4::get_xzw", "amp_short_vectors/Concurrency::graphics::norm_4::rba", "amp_short_vectors/Concurrency::graphics::norm_4::get_wyx", "amp_short_vectors/Concurrency::graphics::norm_4::operator+=", "amp_short_vectors/Concurrency::graphics::norm_4::set_xwz", "amp_short_vectors/Concurrency::graphics::norm_4::set_zwy", "amp_short_vectors/Concurrency::graphics::norm_4::abg", "amp_short_vectors/Concurrency::graphics::norm_4::xywz", "amp_short_vectors/Concurrency::graphics::norm_4::ar", "amp_short_vectors/Concurrency::graphics::norm_4::set_y", "amp_short_vectors/Concurrency::graphics::norm_4::get_xzyw", "amp_short_vectors/Concurrency::graphics::norm_4::set_yxw", "amp_short_vectors/Concurrency::graphics::norm_4::set_ywxz", "amp_short_vectors/Concurrency::graphics::norm_4::yxw", "amp_short_vectors/Concurrency::graphics::norm_4::get_z", "amp_short_vectors/Concurrency::graphics::norm_4::get_zxy", "amp_short_vectors/Concurrency::graphics::norm_4::ag", "amp_short_vectors/Concurrency::graphics::norm_4::operator/=", "amp_short_vectors/Concurrency::graphics::norm_4::gra", "amp_short_vectors/Concurrency::graphics::norm_4::ragb", "amp_short_vectors/Concurrency::graphics::norm_4::get_yxwz", "amp_short_vectors/Concurrency::graphics::norm_4::get_wyxz", "amp_short_vectors/Concurrency::graphics::norm_4::xyzw", "amp_short_vectors/Concurrency::graphics::norm_4::zyw", "amp_short_vectors/Concurrency::graphics::norm_4::set_wzxy", "amp_short_vectors/Concurrency::graphics::norm_4::set_x", "amp_short_vectors/Concurrency::graphics::norm_4::set_xwyz", "amp_short_vectors/Concurrency::graphics::norm_4::wyz", "amp_short_vectors/Concurrency::graphics::norm_4::zwx", "amp_short_vectors/Concurrency::graphics::norm_4::set_zw", "amp_short_vectors/Concurrency::graphics::norm_4::zy", "amp_short_vectors/Concurrency::graphics::norm_4::set_zwyx", "amp_short_vectors/Concurrency::graphics::norm_4::set_xwzy", "amp_short_vectors/Concurrency::graphics::norm_4::get_yzxw", "amp_short_vectors/Concurrency::graphics::norm_4::get_yzwx", "amp_short_vectors/Concurrency::graphics::norm_4::z", "amp_short_vectors/Concurrency::graphics::norm_4::g", "amp_short_vectors/Concurrency::graphics::norm_4::get_xyz", "amp_short_vectors/Concurrency::graphics::norm_4::xwyz", "amp_short_vectors/Concurrency::graphics::norm_4::get_wxyz", "amp_short_vectors/Concurrency::graphics::norm_4::zywx", "amp_short_vectors/Concurrency::graphics::norm_4::operator++", "amp_short_vectors/Concurrency::graphics::norm_4::operator-=", "amp_short_vectors/Concurrency::graphics::norm_4::set_wyx", "amp_short_vectors/Concurrency::graphics::norm_4::wxz", "amp_short_vectors/Concurrency::graphics::norm_4::set_xyw", "amp_short_vectors/Concurrency::graphics::norm_4::set_ywz", "amp_short_vectors/Concurrency::graphics::norm_4::operator*=", "amp_short_vectors/Concurrency::graphics::norm_4::wx", "amp_short_vectors/Concurrency::graphics::norm_4::x", "amp_short_vectors/Concurrency::graphics::norm_4::get_y", "amp_short_vectors/Concurrency::graphics::norm_4::set_xzyw", "amp_short_vectors/Concurrency::graphics::norm_4::bag", "amp_short_vectors/Concurrency::graphics::norm_4::get_zw", "amp_short_vectors/Concurrency::graphics::norm_4::abrg", "amp_short_vectors/Concurrency::graphics::norm_4::get_xy", "amp_short_vectors/Concurrency::graphics::norm_4::set_wyxz", "amp_short_vectors/Concurrency::graphics::norm_4::ywzx", "amp_short_vectors/Concurrency::graphics::norm_4::set_xwy", "amp_short_vectors/Concurrency::graphics::norm_4::set_wxy", "amp_short_vectors/Concurrency::graphics::norm_4::set_xyzw", "amp_short_vectors/Concurrency::graphics::norm_4::wyxz", "amp_short_vectors/Concurrency::graphics::norm_4::ba", "amp_short_vectors/Concurrency::graphics::norm_4::xwz", "amp_short_vectors/Concurrency::graphics::norm_4::zxwy", "amp_short_vectors/Concurrency::graphics::norm_4::gabr", "amp_short_vectors/Concurrency::graphics::norm_4::set_wzx", "amp_short_vectors/Concurrency::graphics::norm_4::get_xyw", "amp_short_vectors/Concurrency::graphics::norm_4::grb", "amp_short_vectors/Concurrency::graphics::norm_4::get_zxw", "amp_short_vectors/Concurrency::graphics::norm_4::get_yw", "amp_short_vectors/Concurrency::graphics::norm_4::set_xzw", "amp_short_vectors/Concurrency::graphics::norm_4::set_wy", "amp_short_vectors/Concurrency::graphics::norm_4::get_yxw", "amp_short_vectors/Concurrency::graphics::norm_4::get_ywz", "amp_short_vectors/Concurrency::graphics::norm_4::get_wz", "amp_short_vectors/Concurrency::graphics::norm_4::yxwz", "amp_short_vectors/Concurrency::graphics::norm_4::get_zxwy", "amp_short_vectors/Concurrency::graphics::norm_4::set_zy", "amp_short_vectors/Concurrency::graphics::norm_4::xzwy", "amp_short_vectors/Concurrency::graphics::norm_4::bgra", "amp_short_vectors/Concurrency::graphics::norm_4::set_xz", "amp_short_vectors/Concurrency::graphics::norm_4::rbag", "amp_short_vectors/Concurrency::graphics::norm_4::zx", "amp_short_vectors/Concurrency::graphics::norm_4::get_zyx", "amp_short_vectors/Concurrency::graphics::norm_4::zyxw", "amp_short_vectors/Concurrency::graphics::norm_4::set_z", "amp_short_vectors/Concurrency::graphics::norm_4::xw", "amp_short_vectors/Concurrency::graphics::norm_4::set_xywz", "amp_short_vectors/Concurrency::graphics::norm_4::get_yxzw", "amp_short_vectors/Concurrency::graphics::norm_4::get_yx", "amp_short_vectors/Concurrency::graphics::norm_4::get_wzx", "amp_short_vectors/Concurrency::graphics::norm_4::ab", "amp_short_vectors/Concurrency::graphics::norm_4::rb", "amp_short_vectors/Concurrency::graphics::norm_4::get_zywx", "amp_short_vectors/Concurrency::graphics::norm_4::get_wzy", "amp_short_vectors/Concurrency::graphics::norm_4::set_zyx", "amp_short_vectors/Concurrency::graphics::norm_4::wy"] -ms.assetid: d628b2bf-2cdb-4dbb-95c6-cd778f5e991f ---- -# norm_4 Class - -Represents a short vector of four normal numbers. - -## Syntax - -```cpp -class norm_4; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[norm_4 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|norm_4::get_w|| -|norm_4::get_wx|| -|norm_4::get_wxy|| -|norm_4::get_wxyz|| -|norm_4::get_wxz|| -|norm_4::get_wxzy|| -|norm_4::get_wy|| -|norm_4::get_wyx|| -|norm_4::get_wyxz|| -|norm_4::get_wyz|| -|norm_4::get_wyzx|| -|norm_4::get_wz|| -|norm_4::get_wzx|| -|norm_4::get_wzxy|| -|norm_4::get_wzy|| -|norm_4::get_wzyx|| -|norm_4::get_x|| -|norm_4::get_xw|| -|norm_4::get_xwy|| -|norm_4::get_xwyz|| -|norm_4::get_xwz|| -|norm_4::get_xwzy|| -|norm_4::get_xy|| -|norm_4::get_xyw|| -|norm_4::get_xywz|| -|norm_4::get_xyz|| -|norm_4::get_xyzw|| -|norm_4::get_xz|| -|norm_4::get_xzw|| -|norm_4::get_xzwy|| -|norm_4::get_xzy|| -|norm_4::get_xzyw|| -|norm_4::get_y|| -|norm_4::get_yw|| -|norm_4::get_ywx|| -|norm_4::get_ywxz|| -|norm_4::get_ywz|| -|norm_4::get_ywzx|| -|norm_4::get_yx|| -|norm_4::get_yxw|| -|norm_4::get_yxwz|| -|norm_4::get_yxz|| -|norm_4::get_yxzw|| -|norm_4::get_yz|| -|norm_4::get_yzw|| -|norm_4::get_yzwx|| -|norm_4::get_yzx|| -|norm_4::get_yzxw|| -|norm_4::get_z|| -|norm_4::get_zw|| -|norm_4::get_zwx|| -|norm_4::get_zwxy|| -|norm_4::get_zwy|| -|norm_4::get_zwyx|| -|norm_4::get_zx|| -|norm_4::get_zxw|| -|norm_4::get_zxwy|| -|norm_4::get_zxy|| -|norm_4::get_zxyw|| -|norm_4::get_zy|| -|norm_4::get_zyw|| -|norm_4::get_zywx|| -|norm_4::get_zyx|| -|norm_4::get_zyxw|| -|norm_4::ref_a|| -|norm_4::ref_b|| -|norm_4::ref_g|| -|norm_4::ref_r|| -|norm_4::ref_w|| -|norm_4::ref_x|| -|norm_4::ref_y|| -|norm_4::ref_z|| -|norm_4::set_w|| -|norm_4::set_wx|| -|norm_4::set_wxy|| -|norm_4::set_wxyz|| -|norm_4::set_wxz|| -|norm_4::set_wxzy|| -|norm_4::set_wy|| -|norm_4::set_wyx|| -|norm_4::set_wyxz|| -|norm_4::set_wyz|| -|norm_4::set_wyzx|| -|norm_4::set_wz|| -|norm_4::set_wzx|| -|norm_4::set_wzxy|| -|norm_4::set_wzy|| -|norm_4::set_wzyx|| -|norm_4::set_x|| -|norm_4::set_xw|| -|norm_4::set_xwy|| -|norm_4::set_xwyz|| -|norm_4::set_xwz|| -|norm_4::set_xwzy|| -|norm_4::set_xy|| -|norm_4::set_xyw|| -|norm_4::set_xywz|| -|norm_4::set_xyz|| -|norm_4::set_xyzw|| -|norm_4::set_xz|| -|norm_4::set_xzw|| -|norm_4::set_xzwy|| -|norm_4::set_xzy|| -|norm_4::set_xzyw|| -|norm_4::set_y|| -|norm_4::set_yw|| -|norm_4::set_ywx|| -|norm_4::set_ywxz|| -|norm_4::set_ywz|| -|norm_4::set_ywzx|| -|norm_4::set_yx|| -|norm_4::set_yxw|| -|norm_4::set_yxwz|| -|norm_4::set_yxz|| -|norm_4::set_yxzw|| -|norm_4::set_yz|| -|norm_4::set_yzw|| -|norm_4::set_yzwx|| -|norm_4::set_yzx|| -|norm_4::set_yzxw|| -|norm_4::set_z|| -|norm_4::set_zw|| -|norm_4::set_zwx|| -|norm_4::set_zwxy|| -|norm_4::set_zwy|| -|norm_4::set_zwyx|| -|norm_4::set_zx|| -|norm_4::set_zxw|| -|norm_4::set_zxwy|| -|norm_4::set_zxy|| -|norm_4::set_zxyw|| -|norm_4::set_zy|| -|norm_4::set_zyw|| -|norm_4::set_zywx|| -|norm_4::set_zyx|| -|norm_4::set_zyxw|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|norm_4::operator-|| -|norm_4::operator--|| -|norm_4::operator*=|| -|norm_4::operator/=|| -|norm_4::operator++|| -|norm_4::operator+=|| -|norm_4::operator=|| -|norm_4::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#norm_4__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|norm_4::a|| -|norm_4::ab|| -|norm_4::abg|| -|norm_4::abgr|| -|norm_4::abr|| -|norm_4::abrg|| -|norm_4::ag|| -|norm_4::agb|| -|norm_4::agbr|| -|norm_4::agr|| -|norm_4::agrb|| -|norm_4::ar|| -|norm_4::arb|| -|norm_4::arbg|| -|norm_4::arg|| -|norm_4::argb|| -|norm_4::b|| -|norm_4::ba|| -|norm_4::bag|| -|norm_4::bagr|| -|norm_4::bar|| -|norm_4::barg|| -|norm_4::bg|| -|norm_4::bga|| -|norm_4::bgar|| -|norm_4::bgr|| -|norm_4::bgra|| -|norm_4::br|| -|norm_4::bra|| -|norm_4::brag|| -|norm_4::brg|| -|norm_4::brga|| -|norm_4::g|| -|norm_4::ga|| -|norm_4::gab|| -|norm_4::gabr|| -|norm_4::gar|| -|norm_4::garb|| -|norm_4::gb|| -|norm_4::gba|| -|norm_4::gbar|| -|norm_4::gbr|| -|norm_4::gbra|| -|norm_4::gr|| -|norm_4::gra|| -|norm_4::grab|| -|norm_4::grb|| -|norm_4::grba|| -|norm_4::r|| -|norm_4::ra|| -|norm_4::rab|| -|norm_4::rabg|| -|norm_4::rag|| -|norm_4::ragb|| -|norm_4::rb|| -|norm_4::rba|| -|norm_4::rbag|| -|norm_4::rbg|| -|norm_4::rbga|| -|norm_4::rg|| -|norm_4::rga|| -|norm_4::rgab|| -|norm_4::rgb|| -|norm_4::rgba|| -|norm_4::w|| -|norm_4::wx|| -|norm_4::wxy|| -|norm_4::wxyz|| -|norm_4::wxz|| -|norm_4::wxzy|| -|norm_4::wy|| -|norm_4::wyx|| -|norm_4::wyxz|| -|norm_4::wyz|| -|norm_4::wyzx|| -|norm_4::wz|| -|norm_4::wzx|| -|norm_4::wzxy|| -|norm_4::wzy|| -|norm_4::wzyx|| -|norm_4::x|| -|norm_4::xw|| -|norm_4::xwy|| -|norm_4::xwyz|| -|norm_4::xwz|| -|norm_4::xwzy|| -|norm_4::xy|| -|norm_4::xyw|| -|norm_4::xywz|| -|norm_4::xyz|| -|norm_4::xyzw|| -|norm_4::xz|| -|norm_4::xzw|| -|norm_4::xzwy|| -|norm_4::xzy|| -|norm_4::xzyw|| -|norm_4::y|| -|norm_4::yw|| -|norm_4::ywx|| -|norm_4::ywxz|| -|norm_4::ywz|| -|norm_4::ywzx|| -|norm_4::yx|| -|norm_4::yxw|| -|norm_4::yxwz|| -|norm_4::yxz|| -|norm_4::yxzw|| -|norm_4::yz|| -|norm_4::yzw|| -|norm_4::yzwx|| -|norm_4::yzx|| -|norm_4::yzxw|| -|norm_4::z|| -|norm_4::zw|| -|norm_4::zwx|| -|norm_4::zwxy|| -|norm_4::zwy|| -|norm_4::zwyx|| -|norm_4::zx|| -|norm_4::zxw|| -|norm_4::zxwy|| -|norm_4::zxy|| -|norm_4::zxyw|| -|norm_4::zy|| -|norm_4::zyw|| -|norm_4::zywx|| -|norm_4::zyx|| -|norm_4::zyxw|| - -## Inheritance Hierarchy - -`norm_4` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## norm_4 - -Default constructor, initializes all elements with 0. - -```cpp -norm_4() restrict(amp, - cpu); - -norm_4( - norm _V0, - norm _V1, - norm _V2, - norm _V3) restrict(amp, - cpu); - -norm_4( - float _V0, - float _V1, - float _V2, - float _V3) restrict(amp, - cpu); - -norm_4( - unorm _V0, - unorm _V1, - unorm _V2, - unorm _V3) restrict(amp, - cpu); - -norm_4( - norm _V) restrict(amp, - cpu); - -explicit norm_4( - float _V) restrict(amp, - cpu); - -norm_4( - const norm_4& _Other) restrict(amp, - cpu); - -explicit inline norm_4( - const uint_4& _Other) restrict(amp, - cpu); - -explicit inline norm_4( - const int_4& _Other) restrict(amp, - cpu); - -explicit inline norm_4( - const float_4& _Other) restrict(amp, - cpu); - -explicit inline norm_4( - const unorm_4& _Other) restrict(amp, - cpu); - -explicit inline norm_4( - const double_4& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V3*
-The value to initialize element 3. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 4; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/norm-class.md b/docs/parallel/amp/reference/norm-class.md deleted file mode 100644 index 56952e2cf8f..00000000000 --- a/docs/parallel/amp/reference/norm-class.md +++ /dev/null @@ -1,94 +0,0 @@ ---- -description: "Learn more about: norm Class" -title: "norm Class" -ms.date: "11/04/2016" -f1_keywords: ["AMP_SHORT_VECTORS/norm", "AMP_SHORT_VECTORS/Concurrency::graphics::norm Constructor"] -ms.assetid: 73002f3d-c25e-4119-bcd3-4c46c9b6abf1 ---- -# norm Class - -Represent a norm number. Each element is a floating point number in the range of [-1.0f, 1.0f]. - -## Syntax - -```cpp -class norm; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[norm Constructor](#ctor)|Overloaded. Default constructor. Initialize to 0.0f.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|norm::operator-|| -|norm::operator--|| -|norm::operator float|Conversion operator. Convert the norm number to a floating point value.| -|norm::operator*=|| -|norm::operator/=|| -|norm::operator++|| -|norm::operator+=|| -|norm::operator=|| -|norm::operator-=|| - -## Inheritance Hierarchy - -`norm` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## norm - -Default constructor. Initialize to 0.0f. - -```cpp -norm( - void) restrict(amp, - cpu); - -explicit norm( - float _V) restrict(amp, - cpu); - -explicit norm( - unsigned int _V) restrict(amp, - cpu); - -explicit norm( - int _V) restrict(amp, - cpu); - -explicit norm( - double _V) restrict(amp, - cpu); - -norm( - const norm& _Other) restrict(amp, - cpu); - -norm( - const unorm& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V*
-The value used to initialize. - -*_Other*
-The object used to initialize. - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/out-of-memory-class.md b/docs/parallel/amp/reference/out-of-memory-class.md deleted file mode 100644 index c59ef294a0a..00000000000 --- a/docs/parallel/amp/reference/out-of-memory-class.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -description: "Learn more about: out_of_memory Class" -title: "out_of_memory Class" -ms.date: "11/04/2016" -f1_keywords: ["out_of_memory", "AMPRT/out_of_memory", "AMPRT/Concurrency::out_of_memory::out_of_memory"] -helpviewer_keywords: ["out_of_memory class"] -ms.assetid: 3aa7e682-8f13-4ae6-9188-31fb423956e4 ---- -# out_of_memory Class - -The exception that is thrown when a method fails because of a lack of system or device memory. - -## Syntax - -```cpp -class out_of_memory : public runtime_exception; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[out_of_memory Constructor](#ctor)|Initializes a new instance of the `out_of_memory` class.| - -## Inheritance Hierarchy - -`exception` - -`runtime_exception` - -`out_of_memory` - -## Requirements - -**Header:** amprt.h - -**Namespace:** Concurrency - -## out_of_memory - -Initializes a new instance of the class. - -### Syntax - -```cpp -explicit out_of_memory( - const char * _Message ) throw(); - -out_of_memory () throw(); -``` - -### Parameters - -*_Message*
-A description of the error. - -### Return Value - -A new instance of the `out_of_memory` class. - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/reference-cpp-amp.md b/docs/parallel/amp/reference/reference-cpp-amp.md deleted file mode 100644 index 21e44bd2a83..00000000000 --- a/docs/parallel/amp/reference/reference-cpp-amp.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -description: "Learn more about: Reference (C++ AMP)" -title: "Reference (C++ AMP)" -ms.date: "11/04/2016" -f1_keywords: ["amp/Concurrency::Reference (C++ AMP)"] -helpviewer_keywords: ["C++ Accelerated Massive Parallelism, reference"] -ms.assetid: 372a8aed-8a53-48c9-996f-9c3cf09c9fa8 ---- -# Reference (C++ AMP) - -This section contains reference information for the C++ Accelerated Massive Parallelism (C++ AMP) runtime. - -> [!NOTE] -> The C++ language standard reserves the use of identifiers that begin with an underscore (`_`) character for implementations such as libraries. Do not use names beginning with an underscore in your code. The behavior of code elements whose names follow this convention are not guaranteed and are subject to change in future releases. For these reasons, such code elements are omitted from this documentation. - -## In This Section - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md)
-Provides classes and functions that enable the acceleration of C++ code on data parallel hardware. - -[Concurrency::direct3d Namespace](concurrency-direct3d-namespace.md)
-Provides functions that support D3D interoperability. Enables seamless use of D3D resources for compute in AMP code and the use of resources created in AMP in D3D code, without creating redundant intermediate copies. You can use C++ AMP to incrementally accelerate the compute-intensive sections of your DirectX applications and use the D3D API on data produced from AMP computations. - -[Concurrency::fast_math Namespace](concurrency-fast-math-namespace.md)
-Functions in the `fast_math` namespace are not C99-conformant. Only single-precision versions of each function are provided. These functions use the DirectX intrinsic functions, which are faster than the corresponding functions in the `precise_math` namespace and do not require extended double-precision support on the accelerator, but they are less accurate. There are two versions of each function for source-level compatibility with C99 code; both versions take and return single-precision values. - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md)
-Provides types and functions that are designed for graphics programming. - -[Concurrency::precise_math Namespace](concurrency-precise-math-namespace.md)
-Functions in the `precise_math` namespace are C99 conformant. Both single-precision and double-precision versions of each function are included. These functions—this includes the single-precision functions—require extended double-precision support on the accelerator. - -## Related Sections - -[C++ AMP (C++ Accelerated Massive Parallelism)](../../../parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md)
-C++ AMP accelerates the execution of your C++ code by taking advantage of the data-parallel hardware that's commonly present as a graphics processing unit (GPU) on a discrete graphics card. diff --git a/docs/parallel/amp/reference/runtime-exception-class.md b/docs/parallel/amp/reference/runtime-exception-class.md deleted file mode 100644 index ae03941949e..00000000000 --- a/docs/parallel/amp/reference/runtime-exception-class.md +++ /dev/null @@ -1,129 +0,0 @@ ---- -title: "runtime_exception Class" -description: "Learn more about: runtime_exception Class" -ms.date: 03/27/2019 -f1_keywords: ["runtime_exception", "AMPRT/runtime_exception", "AMPRT/Concurrency::runtime_exception", "AMPRT/Concurrency::runtime_exception::get_error_code"] -helpviewer_keywords: ["runtime_exception class"] ---- -# runtime_exception Class - -The base type for exceptions in the C++ Accelerated Massive Parallelism (AMP) library. - -### Syntax - -```cpp -class runtime_exception : public std::exception; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[runtime_exception Constructor](#ctor)|Initializes a new instance of the `runtime_exception` class.| -|[~runtime_exception Destructor](#dtor)|Destroys the `runtime_exception` object.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[get_error_code](#get_error_code)|Returns the error code that caused the exception.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator=](#operator_eq)|Copies the contents of the specified `runtime_exception` object into this one.| - -## Inheritance Hierarchy - -`exception` - -`runtime_exception` - -## Requirements - -**Header:** amprt.h - -**Namespace:** Concurrency - -## runtime_exception Constructor - -Initializes a new instance of the class. - -### Syntax - -```cpp -runtime_exception( - const char * _Message, - HRESULT _Hresult ) throw(); - -explicit runtime_exception( - HRESULT _Hresult ) throw(); - -runtime_exception( - const runtime_exception & _Other ) throw(); -``` - -### Parameters - -*_Message*
-A description of the error that caused the exception. - -*_Hresult*
-The HRESULT of error that caused the exception. - -*_Other*
-The `runtime_exception` object to copy. - -### Return Value - -The `runtime_exception` object. - -## ~runtime_exception Destructor - -Destroys the object. - -### Syntax - -```cpp -virtual ~runtime_exception() throw(); -``` - -## get_error_code - -Returns the error code that caused the exception. - -### Syntax - -```cpp -HRESULT get_error_code() const throw(); -``` - -### Return Value - -The HRESULT of error that caused the exception. - -## operator= - -Copies the contents of the specified `runtime_exception` object into this one. - -### Syntax - -```cpp -runtime_exception & operator= ( const runtime_exception & _Other ) throw(); -``` - -### Parameters - -*_Other*
-The `runtime_exception` object to copy. - -### Return Value - -A reference to this `runtime_exception` object. - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/sampler-class.md b/docs/parallel/amp/reference/sampler-class.md deleted file mode 100644 index 5542115588c..00000000000 --- a/docs/parallel/amp/reference/sampler-class.md +++ /dev/null @@ -1,197 +0,0 @@ ---- -description: "Learn more about: sampler Class" -title: "sampler Class" -ms.date: "06/28/2018" -f1_keywords: ["sampler", "AMP_GRAPHICS/sampler", "AMP_GRAPHICS/concurrency::sampler::graphics::sampler", "AMP_GRAPHICS/concurrency::sampler::graphics::get_address_mode", "AMP_GRAPHICS/concurrency::sampler::graphics::get_border_color", "AMP_GRAPHICS/concurrency::sampler::graphics::get_filter_mode", "AMP_GRAPHICS/concurrency::sampler::graphics::address_mode", "AMP_GRAPHICS/concurrency::sampler::graphics::border_color", "AMP_GRAPHICS/concurrency::sampler::graphics::filter_mode"] -ms.assetid: 9a6a9807-497d-402d-b092-8c4d86275b80 ---- -# sampler Class - -The sampler class aggregates sampling configuration information to be used for texture sampling. - -## Syntax - -```cpp -class sampler; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[sampler Constructor](#ctor)|Overloaded. Constructs a sampler instance.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[get_address_mode](#get_address_mode)|Returns the `address_mode` that's associated with the sampler object.| -|[get_border_color](#get_border_color)|Returns the border color that's associated with the sampler object.| -|[get_filter_mode](#get_filter_mode)|Returns the `filter_mode` that's associated with the sampler object.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator=](#operator_eq)|Overloaded. Assignment operator.| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|[address_mode](#address_mode)|Gets the address mode of the `sampler` object.| -|[border_color](#border_color)|Gets the border color of the `sampler` object.| -|[filter_mode](#filter_mode)|Gets the filter mode of the `sampler` object.| - -## Inheritance Hierarchy - -`sampler` - -## Requirements - -**Header:** amp_graphics.h - -**Namespace:** concurrency::graphics - -## sampler - -Constructs an instance of the [sampler Class](sampler-class.md). - -```cpp -sampler() restrict(cpu); // [1] default constructor - -sampler( // [2] constructor - filter_mode _Filter_mode) restrict(cpu); - -sampler( // [3] constructor - address_mode _Address_mode, - float_4 _Border_color = float_4(0.0f, - 0.0f, - 0.0f, - 0.0f)) restrict(cpu); - -sampler( // [4] constructor - filter_mode _Filter_mode, - address_mode _Address_mode, - float_4 _Border_color = float_4(0.0f, - 0.0f, - 0.0f, - 0.0f)) restrict(cpu); - -sampler( // [5] copy constructor - const sampler& _Other) restrict(amp, - cpu); - -sampler( // [6] move constructor - sampler&& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_Filter_mode*
-The filter mode to be used in sampling. - -*_Address_mode*
-The addressing mode to be used in sampling for all dimensions. - -*_Border_color*
-The border color to be used if the address mode is address_border. The default value is `float_4(0.0f, 0.0f, 0.0f, 0.0f)`. - -*_Other*
-[5] Copy Constructor -The `sampler` object to copy into the new `sampler` instance. - -[6] Move Constructor -The `sampler` object to move into the new `sampler` instance. - -## address_mode - -Gets the address mode of the `sampler` object. - -```cpp -__declspec(property(get= get_address_mode)) Concurrency::graphics::address_mode address_mode; -``` - -## border_color - -Gets the border color of the `sampler` object. - -```cpp -__declspec(property(get= get_border_color)) Concurrency::graphics::float_4 border_color; -``` - -## filter_mode - -Gets the filter mode of the `sampler` object. - -```cpp -__declspec(property(get= get_filter_mode)) Concurrency::graphics::filter_mode filter_mode; -``` - -## get_address_mode - -Returns the filter mode that's configured for this `sampler`. - -```cpp -Concurrency::graphics::address_mode get_address_mode() const __GPU; -``` - -### Return Value - -The address mode that's configured for the sampler. - -## get_border_color - -Returns the border color that's configured for this `sampler`. - -```cpp -Concurrency::graphics::float_4 get_border_color() const restrict(amp, cpu); -``` - -### Return Value - -A float_4 that contains the border color. - -## get_filter_mode - -Returns the filter mode that's configured for this `sampler`. - -```cpp -Concurrency::graphics::filter_mode get_filter_mode() const restrict(amp, cpu); -``` - -### Return Value - -The filter mode that's configured for the sampler. - -## operator= - -Assigns the value of another sampler object to an existing sampler. - -```cpp -sampler& operator= ( // [1] copy assignment operator - const sampler& _Other) restrict(amp, cpu); - -sampler& operator= ( // [2] move assignment operator - sampler&& _Other) restrict(amp, cpu); -``` - -### Parameters - -*_Other*
-[1] Copy Assignment Operator -The `sampler` object to copy into this `sampler`. - -[2] Move Assignment Operator -The `sampler` object to move into this `sampler`. - -### Return Value - -A reference to this sampler instance. - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/scoped-d3d-access-lock-class.md b/docs/parallel/amp/reference/scoped-d3d-access-lock-class.md deleted file mode 100644 index 8a6888a479a..00000000000 --- a/docs/parallel/amp/reference/scoped-d3d-access-lock-class.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -description: "Learn more about: scoped_d3d_access_lock Class" -title: "scoped_d3d_access_lock Class" -ms.date: "11/04/2016" -f1_keywords: ["scoped_d3d_access_lock", "AMPRT/scoped_d3d_access_lock", "AMPRT/concurrency::direct3d::scoped_d3d_access_lock::scoped_d3d_access_lock"] -ms.assetid: 0ad333e6-9839-4736-a722-16d95d70c4b1 ---- -# scoped_d3d_access_lock Class - -RAII wrapper for a D3D access lock on an accelerator_view object. - -## Syntax - -```cpp -class scoped_d3d_access_lock; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[scoped_d3d_access_lock Constructor](#ctor)|Overloaded. Constructs a `scoped_d3d_access_lock` object. The lock is released when this object goes out of scope.| -|[~scoped_d3d_access_lock Destructor](#dtor)|Releases the D3D access lock on the associated `accelerator_view` object.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator=](#operator_eq)|Takes ownership of a lock from another `scoped_d3d_access_lock`.| - -## Inheritance Hierarchy - -`scoped_d3d_access_lock` - -## Requirements - -**Header:** amprt.h - -**Namespace:** concurrency::direct3d - -## scoped_d3d_access_lock - -Constructs a `scoped_d3d_access_lock` object. The lock is released when this object goes out of scope. - -```cpp -explicit scoped_d3d_access_lock(// [1] constructor - accelerator_view& _Av); - -explicit scoped_d3d_access_lock(// [2] constructor - accelerator_view& _Av, - adopt_d3d_access_lock_t _T); - -scoped_d3d_access_lock(// [3] move constructor - scoped_d3d_access_lock&& _Other); -``` - -### Parameters - -*_Av*
-The `accelerator_view` for the lock to adopt. - -*_T*
-The `adopt_d3d_access_lock_t` object. - -*_Other*
-The `scoped_d3d_access_lock` object from which to move an existing lock. - -## Construction - -[1] Constructor -Acquires a D3D access lock on the given [accelerator_view](accelerator-view-class.md) object. Construction blocks until the lock is acquired. - -[2] Constructor -Adopt a D3D access lock from the given [accelerator_view](accelerator-view-class.md) object. - -[3] Move Constructor -Takes an existing D3D access lock from another `scoped_d3d_access_lock` object. Construction does not block. - -## ~scoped_d3d_access_lock - -Releases the D3D access lock on the associated `accelerator_view` object. - -```cpp -~scoped_d3d_access_lock(); -``` - -## operator= - -Takes ownership of a D3D access lock from another `scoped_d3d_access_lock` object, releasing the previous lock. - -```cpp -scoped_d3d_access_lock& operator= (scoped_d3d_access_lock&& _Other); -``` - -### Parameters - -*_Other*
-The accelerator_view from which to move the D3D access lock. - -### Return Value - -A reference to this `scoped_accelerator_view_lock`. - -## See also - -[Concurrency::direct3d Namespace](concurrency-direct3d-namespace.md) diff --git a/docs/parallel/amp/reference/short-vector-structure.md b/docs/parallel/amp/reference/short-vector-structure.md deleted file mode 100644 index f35a36cbd38..00000000000 --- a/docs/parallel/amp/reference/short-vector-structure.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -description: "Learn more about: short_vector Structure" -title: "short_vector Structure" -ms.date: "11/04/2016" -f1_keywords: ["short_vector", "AMP_SHORT_VECTORS/short_vector", "AMP_SHORT_VECTORS/Concurrency::graphics::short_vector::short_vector Constructor"] -ms.assetid: e4f50b8f-1150-437d-b58c-79c5fb883708 ---- -# short_vector Structure - -short_vector provides metaprogramming definitions which are useful for programming short vectors generically. - -## Syntax - -```cpp -template< - typename _Scalar_type, - int _Size -> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -template<> -struct short_vector; -``` - -### Parameters - -*_Scalar_type*
- -*_Size*
- -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[short_vector::short_vector Constructor](#ctor)|| - -## Inheritance Hierarchy - -`short_vector` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## short_vector::short_vector Constructor - -```cpp -short_vector(); -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/short-vector-traits-structure.md b/docs/parallel/amp/reference/short-vector-traits-structure.md deleted file mode 100644 index 671761e5cdf..00000000000 --- a/docs/parallel/amp/reference/short-vector-traits-structure.md +++ /dev/null @@ -1,117 +0,0 @@ ---- -description: "Learn more about: short_vector_traits Structure" -title: "short_vector_traits Structure" -ms.date: "11/04/2016" -f1_keywords: ["short_vector_traits", "AMP_SHORT_VECTORS/short_vector_traits", "AMP_SHORT_VECTORS/Concurrency::graphics::short_vector_traits::short_vector_traits", "AMP_SHORT_VECTORS/Concurrency::graphics::short_vector_traits::size Constant"] -ms.assetid: cd9492da-9e02-4a6e-9d50-b61252cdb460 ---- -# short_vector_traits Structure - -short_vector_traits allows retrieval of the underlying vector length and scalar type of a short vector type or a scalar type - -## Syntax - -```cpp -template< - typename T -> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -template<> -struct short_vector_traits; -``` - -### Parameters - -`T` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[short_vector_traits::short_vector_traits Constructor](#ctor)|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[short_vector_traits::size Constant](#size)|| - -## Inheritance Hierarchy - -`short_vector_traits` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## short_vector_traits::short_vector_traits Constructor - -```cpp -short_vector_traits(); -``` - -## short_vector_traits::size Constant - -```cpp -static int const size = 1; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/texture-class.md b/docs/parallel/amp/reference/texture-class.md deleted file mode 100644 index 67d5044baea..00000000000 --- a/docs/parallel/amp/reference/texture-class.md +++ /dev/null @@ -1,579 +0,0 @@ ---- -title: "texture Class" -description: "Learn more about: texture Class" -ms.date: 11/04/2016 -f1_keywords: ["texture", "AMP_GRAPHICS/texture", "AMP_GRAPHICS/concurrency::graphics::texture::texture", "AMP_GRAPHICS/concurrency::graphics::texture::copy_to", "AMP_GRAPHICS/concurrency::graphics::texture::data", "AMP_GRAPHICS/concurrency::graphics::texture::get", "AMP_GRAPHICS/concurrency::graphics::texture::get_associated_accelerator_view", "AMP_GRAPHICS/concurrency::graphics::texture::get_depth_pitch", "AMP_GRAPHICS/concurrency::graphics::texture::get_row_pitch", "AMP_GRAPHICS/concurrency::graphics::texture::set", "AMP_GRAPHICS/concurrency::graphics::texture::rank", "AMP_GRAPHICS/concurrency::graphics::texture::associated_accelerator_view", "AMP_GRAPHICS/concurrency::graphics::texture::depth_pitch", "AMP_GRAPHICS/concurrency::graphics::texture::row_pitch"] ---- -# texture Class - -A texture is a data aggregate on an `accelerator_view` in the extent domain. It is a collection of variables, one for each element in an extent domain. Each variable holds a value corresponding to C++ primitive type ( **`unsigned int`**, **`int`**, **`float`**, **`double`**), a scalar type (`norm`, or `unorm`), or a short vector type. - -## Syntax - -```cpp -template -class texture; -``` - -### Parameters - -*value_type*
-The type of the elements in the texture. - -*_Rank*
-The rank of the texture. - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`scalar_type`|Scalar types.| -|`value_type`|Value types.| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[texture Constructor](#ctor)|Initializes a new instance of the `texture` class.| -|[~texture Destructor](#ctor)|Destroys the `texture` object.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[copy_to](#copy_to)|Copies the `texture` object to the destination, by doing a deep copy.| -|[data](#data)|Returns a CPU pointer to the raw data of this texture.| -|[get](#get)|Returns the value of the element at the specified index.| -|[get_associated_accelerator_view](#get_associated_accelerator_view)|Returns the [accelerator_view](accelerator-view-class.md) that is the preferred target for this texture to be copied to.| -|[get_depth_pitch](#get_depth_pitch)|Returns the number of bytes between each depth slice in a 3D staging texture on the CPU.| -|[get_row_pitch](#get_row_pitch)|Returns the number of bytes between each row in a 2D or 3D staging texture on the CPU.| -|[set](#set)|Sets the value of the element at the specified index.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator()](#operator_call)|Returns the element value that is specified by the parameters.| -|[operator\[\]](#operator_at)|Returns the element that is at the specified index.| -|[operator=](#operator_eq)|Copies the specified [texture](texture-class.md) object to this one.| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[rank Constant](#rank)|Gets the rank of the `texture` object.| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|[associated_accelerator_view](#associated_accelerator_view)|Gets the [accelerator_view](accelerator-view-class.md) that is the preferred target for this texture to be copied to.| -|[depth_pitch](#depth_pitch)|Gets the number of bytes between each depth slice in a 3D staging texture on the CPU.| -|[row_pitch](#row_pitch)|Gets the number of bytes between each row in a 2D or 3D staging texture on the CPU.| - -## Inheritance Hierarchy - -`_Texture_base` - -`texture` - -## Requirements - -**Header:** amp_graphics.h - -**Namespace:** Concurrency::graphics - -## ~texture - -Destroys the `texture` object. - -```cpp -~texture() restrict(cpu); -``` - -## associated_accelerator_view - -Gets the [accelerator_view](accelerator-view-class.md) that is the preferred target for this texture to be copied to. - -```cpp -__declspec(property(get= get_associated_accelerator_view)) Concurrency::accelerator_view associated_accelerator_view; -``` - -## copy_to - -Copies the `texture` object to the destination, by doing a deep copy. - -```cpp -void copy_to(texture& _Dest) const; -void copy_to(writeonly_texture_view& _Dest) const; -``` - -### Parameters - -*_Dest*
-The object to copy to. - -*_Rank*
-The rank of the texture. - -*value_type*
-The type of the elements in the texture. - -## data - -Returns a CPU pointer to the raw data of this texture. - -```cpp -void* data() restrict(cpu); - -const void* data() const restrict(cpu); -``` - -### Return Value - -A pointer to the raw data of the texture. - -## depth_pitch - -Gets the number of bytes between each depth slice in a 3D staging texture on the CPU. - -```cpp -__declspec(property(get= get_depth_pitch)) unsigned int depth_pitch; -``` - -## get - -Returns the value of the element at the specified index. - -```cpp -const value_type get(const index<_Rank>& _Index) const restrict(amp); -``` - -### Parameters - -*_Index*
-The index of the element. - -### Return Value - -The value of the element at the specified index. - -## get_associated_accelerator_view - -Returns the accelerator_view that is the preferred target for this texture to be copied to. - -```cpp -Concurrency::accelerator_view get_associated_accelerator_view() const restrict(cpu); -``` - -### Return Value - -The [accelerator_view](accelerator-view-class.md) that is the preferred target for this texture to be copied to. - -## get_depth_pitch - -Returns the number of bytes between each depth slice in a 3D staging texture on the CPU. - -```cpp -unsigned int get_depth_pitch() const restrict(cpu); -``` - -### Return Value - -The number of bytes between each depth slice in a 3D staging texture on the CPU. - -## get_row_pitch - -Returns the number of bytes between each row in a 2-dimensional staging texture, or between each row of a depth slice in 3-dimensional staging texture. - -```cpp -unsigned int get_row_pitch() const restrict(cpu); -``` - -### Return Value - -The number of bytes between each row in a 2-dimensional staging texture, or between each row of a depth slice in 3-dimensional staging texture. - -## operator() - -Returns the element value that is specified by the parameters. - -```cpp -const value_type operator() ( - const index<_Rank>& _Index) const restrict(amp); - -const value_type operator() ( - int _I0) const restrict(amp); - -const value_type operator() ( - int _I0, - int _I1) const restrict(amp); - -const value_type operator() ( - int _I0, - int _I1, - int _I2) const restrict(amp); -``` - -### Parameters - -*_Index*
-The index. - -*_I0*
-The most-significant component of the index. - -*_I1*
-The next-to-most-significant component of the index. - -*_I2*
-The least-significant component of the index. - -*_Rank*
-The rank of the index. - -### Return Value - -The element value that is specified by the parameters. - -## operator[] - -Returns the element that is at the specified index. - -```cpp -const value_type operator[] (const index<_Rank>& _Index) const restrict(amp); - -const value_type operator[] (int _I0) const restrict(amp); -``` - -### Parameters - -*_Index*
-The index. - -*_I0*
-The index. - -### Return Value - -The element that is at the specified index. - -## operator= - -Copies the specified [texture](texture-class.md) object to this one. - -```cpp -texture& operator= ( - const texture& _Other); - -texture& operator= ( - texture&& _Other); -``` - -### Parameters - -*_Other*
-The `texture` object to copy from. - -### Return Value - -A reference to this `texture` object. - -## rank - -Gets the rank of the `texture` object. - -```cpp -static const int rank = _Rank; -``` - -## row_pitch - -Gets the number of bytes between each row in a 2D or 3D staging texture on the CPU. - -```cpp -__declspec(property(get= get_row_pitch)) unsigned int row_pitch; -``` - -## set - -Sets the value of the element at the specified index. - -```cpp -void set( - const index<_Rank>& _Index, - const value_type& value) restrict(amp); -``` - -### Parameters - -*_Index*
-The index of the element. - -*_Rank*
-The rank of the index. - -*value*
-The new value of the element. - -## texture - -Initializes a new instance of the `texture` class. - -```cpp -texture(const Concurrency::extent<_Rank>& _Ext) restrict(cpu); - -texture(int _E0) restrict(cpu); - -texture(int _E0, int _E1) restrict(cpu); - -texture(int _E0, int _E1, int _E2) restrict(cpu); - -texture( - const Concurrency::extent<_Rank>& _Ext, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -texture( - int _E0, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -texture( - int _E0, - int _E1, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -texture( - int _E0, - int _E1, - int _E2, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -template -texture( - const Concurrency::extent<_Rank>& _Ext, - _Input_iterator _Src_first, - _Input_iterator _Src_last) restrict(cpu); - -template -texture( - int _E0, _Input_iterator _Src_first, _Input_iterator _Src_last) restrict(cpu); - -template -texture( - int _E0, - int _E1, - _Input_iterator _Src_first, - _Input_iterator _Src_last) restrict(cpu); - -template -texture( - int _E0, - int _E1, - int _E2, - _Input_iterator _Src_first, - _Input_iterator _Src_last) restrict(cpu); - -template -texture( - const Concurrency::extent<_Rank>& _Ext, - _Input_iterator _Src_first, - _Input_iterator _Src_last, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -template -texture( - int _E0, - _Input_iterator _Src_first, - _Input_iterator _Src_last, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -template -texture( - int _E0, - int _E1, - _Input_iterator _Src_first, - _Input_iterator _Src_last, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -template -texture( - int _E0, - int _E1, - int _E2, - _Input_iterator _Src_first, - _Input_iterator _Src_last, - const Concurrency::accelerator_view& _Av) restrict(cpu)) ; - -texture( - int _E0, - unsigned int _Bits_per_scalar_element) restrict(cpu); - -texture( - int _E0, - int _E1, - unsigned int _Bits_per_scalar_element) restrict(cpu); - -texture( - int _E0, - int _E1, - int _E2, - unsigned int _Bits_per_scalar_element) restrict(cpu); - -texture( - const Concurrency::extent<_Rank>& _Ext, - unsigned int _Bits_per_scalar_element, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -texture( - int _E0, - unsigned int _Bits_per_scalar_element, - const Concurrency::accelerator_view& _Av) ; - -texture( - int _E0, - int _E1, - unsigned int _Bits_per_scalar_element, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -texture( - int _E0, - int _E1, - int _E2, - unsigned int _Bits_per_scalar_element, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -texture( - const Concurrency::extent<_Rank>& _Ext, - _In_ void* _Source, - unsigned int _Src_byte_size, - unsigned int _Bits_per_scalar_element) restrict(cpu); - -texture( - int _E0, - _In_ void* _Source, - unsigned int _Src_byte_size, - unsigned int _Bits_per_scalar_element) restrict(cpu); - -texture( - int _E0, - int _E1, - _In_ void* _Source, - unsigned int _Src_byte_size, - unsigned int _Bits_per_scalar_element) restrict(cpu); - -texture( - int _E0, - int _E1, - int _E2, - _In_ void* _Source, - unsigned int _Src_byte_size, - unsigned int _Bits_per_scalar_element) restrict(cpu); - -texture( - const Concurrency::extent<_Rank>& _Ext, - _In_ void* _Source, - unsigned int _Src_byte_size, - unsigned int _Bits_per_scalar_element, - const Concurrency::accelerator_view& _Av) ; - -texture( - int _E0, - _In_ void* _Source, - unsigned int _Src_byte_size, - unsigned int _Bits_per_scalar_element, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -texture( - int _E0, - int _E1, - _In_ void* _Source, - unsigned int _Src_byte_size, - unsigned int _Bits_per_scalar_element, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -texture( - int _E0, - int _E1, - int _E2, - _In_ void* _Source, - unsigned int _Src_byte_size, - unsigned int _Bits_per_scalar_element, - const Concurrency::accelerator_view& _Av) restrict(cpu); - -texture( - const texture& _Src, - const Concurrency::accelerator_view& _Acc_view); - -texture( - texture&& _Other); - -texture( - const Concurrency::extent<_Rank>& _Ext, - unsigned int _Bits_per_scalar_element, - const Concurrency::accelerator_view& _Av); - -texture( - const texture& _Src); -``` - -### Parameters - -*_Acc_view*
-The [accelerator_view](accelerator-view-class.md) that specifies the location of the texture. - -*_Av*
-The [accelerator_view](accelerator-view-class.md) that specifies the location of the texture. - -*_Associated_av*
-An accelerator_view that specifies the preferred target for copies to or from this texture. - -*_Bits_per_scalar_element*
-The number of bits per each scalar element in the underlying scalar type of the texture. In general, supported value are 8, 16, 32, and 64. If 0 is specified, the number of bits is the same as the underlying scalar_type. 64 is only valid for double-based textures. - -*_Ext*
-The extent in each dimension of the texture. - -*_E0*
-The most significant component of the texture. - -*_E1*
-The next-to-most-significant component of the texture. - -*_E2*
-The least significant component of the extent of the texture. - -*_Input_iterator*
-The type of the input iterator. - -*_Mipmap_levels*
-The number of mipmap levels in the underlying texture. If 0 is specified, the texture will have the full range of mipmap levels down to the smallest possible size for the specified extent. - -*_Rank*
-The rank of the extent. - -*_Source*
-A pointer to a host buffer. - -*_Src*
-To texture to copy. - -*_Src_byte_size*
-The number of bytes in the source buffer. - -*_Src_first*
-A beginning iterator into the source container. - -*_Src_last*
-An ending iterator into the source container. - -*_Other*
-Other data source. - -*_Rank*
-The rank of the section. - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/texture-view-class.md b/docs/parallel/amp/reference/texture-view-class.md deleted file mode 100644 index 2ab64c9f966..00000000000 --- a/docs/parallel/amp/reference/texture-view-class.md +++ /dev/null @@ -1,479 +0,0 @@ ---- -description: "Learn more about: texture_view Class" -title: "texture_view Class" -ms.date: "11/04/2016" -f1_keywords: ["texture_view", "AMP_GRAPHICS/texture_view", "AMP_GRAPHICS/Concurrency::graphics::texture_view::texture_view", "AMP_GRAPHICS/Concurrency::graphics::texture_view::gather_alpha", "AMP_GRAPHICS/Concurrency::graphics::texture_view::gather_blue", "AMP_GRAPHICS/Concurrency::graphics::texture_view::gather_green", "AMP_GRAPHICS/Concurrency::graphics::texture_view::gather_red", "AMP_GRAPHICS/Concurrency::graphics::texture_view::get", "AMP_GRAPHICS/Concurrency::graphics::texture_view::sample", "AMP_GRAPHICS/Concurrency::graphics::texture_view::set", "AMP_GRAPHICS/Concurrency::graphics::texture_view::value_type"] -ms.assetid: 6ec2e289-1626-4727-9592-07981cf1d27d ---- -# texture_view Class - -Provides read access and write access to a texture. `texture_view` can only be used to read textures whose value type is **`int`**, **`unsigned int`**, or **`float`** that have default 32-bit bpse. To read other texture formats, use `texture_view`. - -## Syntax - -```cpp -template -class texture_view; - -template -class texture_view - : public details::_Texture_base; - -template -class texture_view - : public details::_Texture_base; -``` - -### Parameters - -*value_type*
-The type of the elements in the texture aggregate. - -*_Rank*
-The rank of the `texture_view`. - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|The type of the elements in the texture aggregates.| -|`coordinates_type`|The type of the coordinate used to specify a texel in the `texture_view`—that is, a `short_vector` that has the same rank as the associated texture that has a value type of **`float`**.| -|`gather_return_type`|The return type used for gather operations—that is, a rank 4 `short_vector` that holds the four homogeneous color components gathered from the four texel values sampled.| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[texture_view Constructor](#ctor)|Overloaded. Constructs a `texture_view` instance.| -|[~texture_view Destructor](#ctor)|Destroys the `texture_view` instance.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[gather_alpha](#gather_alpha)|Overloaded. Samples the texture at the specified coordinates by using the specified sampling configuration and returns the alpha (w) components of the four sampled texels.| -|[gather_blue](#gather_blue)|Overloaded. Samples the texture at the specified coordinates by using the specified sampling configuration and returns the blue (z) components of the four sampled texels.| -|[gather_green](#gather_green)|Overloaded. Samples the texture at the specified coordinates by using the specified sampling configuration and returns the green (y) components of the four sampled texels.| -|[gather_red](#gather_red)|Overloaded. Samples the texture at the specified coordinates by using the specified sampling configuration and returns the red (x) components of the four sampled texels.| -|[get](#get)|Overloaded. Gets the element value by index.| -|[sample](#sample)|Overloaded. Samples the texture at the specified coordinates and level of detail by using the specified sampling configuration.| -|[set](#set)|Sets the value of an element by index.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator()](#operator_call)|Overloaded. Gets the element value by index.| -|[operator\[\]](#operator_at)|Overloaded. Gets the element value by index.| -|[operator=](#operator_eq)|Overloaded. Assignment operator.| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|[value_type](#value_type)|The value type of the elements of the `texture_view`.| - -## Inheritance Hierarchy - -`_Texture_base` - -`texture_view` - -## Requirements - -**Header:** amp_graphics.h - -**Namespace:** concurrency::graphics - -## ~texture_view - -Destroys the `texture_view` instance. - -```cpp -~texture_view() restrict(amp, cpu); -``` - -## texture_view - -Constructs a `texture_view` instance. - -```cpp -texture_view(// [1] constructor - texture& _Src) restrict(amp); - -texture_view(// [2] constructor - texture& _Src, - unsigned int _Mipmap_level = 0) restrict(cpu); - -texture_view(// [3] constructor - const texture& _Src) restrict(amp); - -texture_view(// [4] constructor - const texture& _Src, - unsigned int _Most_detailed_mip, - unsigned int _Mip_levels) restrict(cpu); - -texture_view(// [5] copy constructor - const texture_view& _Other) restrict(amp, cpu); - -texture_view(// [6] copy constructor - const texture_view& _Other) restrict(amp, cpu); - -texture_view(// [7] copy constructor - const texture_view& _Other, - unsigned int _Most_detailed_mip, - unsigned int _Mip_levels) restrict(cpu); -``` - -### Parameters - -*_Src*
-[1, 2] Constructor -The `texture` on which the writable `texture_view` is created. - -[3, 4] Constructor -The `texture` on which the non-writable `texture_view` is created. - -*_Other*
-[5] Copy Constructor -The source writable `texture_view`. - -[6, 7] Copy Constructor -The source non-writable `texture_view`. - -*_Mipmap_level*
-The specific mipmap level on the source `texture` that this writeable `texture_view` binds to. The default value is 0, which represents the top level (most detailed) mip level. - -*_Most_detailed_mip*
-Top level (most detailed) mip level for the view, relative to the specified `texture_view` object. - -*_Mip_levels*
-The number of mipmap levels accessible through the `texture_view`. - -## gather_red - -Samples the texture at the specified coordinates by using the specified sampling configuration and returns the red (x) components of the four sampled texels. - -```cpp -const gather_return_type gather_red( - const sampler& _Sampler, - const coordinates_type& _Coord) const restrict(amp); - -template< - address_mode _Address_mode = address_clamp -> -const gather_return_type gather_red( - const coordinates_type& _Coord) const restrict(amp); -``` - -### Parameters - -*_Address_mode*
-The address mode to use to sample the `texture_view`. The address mode is the same for all dimensions. - -*_Sampler*
-The sampler configuration to use to sample the `texture_view`. - -*_Coord*
-The coordinates to take the sample from. Fractional coordinate values are used to interpolate between sample texels. - -### Return Value - -A rank 4 short vector containing the red (x) component of the 4 sampled texel values. - -## gather_green - -Samples the texture at the specified coordinates by using the specified sampling configuration and returns the green (y) components of the four sampled texels. - -```cpp -const gather_return_type gather_green( - const sampler& _Sampler, - const coordinates_type& _Coord) const restrict(amp); - -template< - address_mode _Address_mode = address_clamp -> -const gather_return_type gather_green( - const coordinates_type& _Coord) const restrict(amp); -``` - -### Parameters - -*_Address_mode*
-The address mode to use to sample the `texture_view`. The address mode is the same for all dimensions. - -*_Sampler*
-The sampler configuration to use to sample the `texture_view`. - -*_Coord*
-The coordinates to take the sample from. Fractional coordinate values are used to interpolate between sample texels. - -### Return Value - -A rank 4 short vector containing the green (y) component of the 4 sampled texel values. - -## gather_blue - -Samples the texture at the specified coordinates by using the specified sampling configuration and returns the blue (z) components of the four sampled texels. - -```cpp -const gather_return_type gather_blue( - const sampler& _Sampler, - const coordinates_type& _Coord) const restrict(amp); - -template< - address_mode _Address_mode = address_clamp -> -const gather_return_type gather_blue( - const coordinates_type& _Coord) const restrict(amp); -``` - -### Parameters - -*_Address_mode*
-The address mode to use to sample the `texture_view`. The address mode is the same for all dimensions. - -*_Sampler*
-The sampler configuration to use to sample the `texture_view`. - -*_Coord*
-The coordinates to take the sample from. Fractional coordinate values are used to interpolate between sample texels. - -### Return Value - -A rank 4 short vector containing the red (x) component of the 4 sampled texel values. - -## gather_alpha - -Samples the texture at the specified coordinates by using the specified sampling configuration and returns the alpha (w) components of the four sampled texels. - -```cpp -const gather_return_type gather_alpha( - const sampler& _Sampler, - const coordinates_type& _Coord) const restrict(amp); - -template< - address_mode _Address_mode = address_clamp -> -const gather_return_type gather_alpha( - const coordinates_type& _Coord) const restrict(amp); -``` - -### Parameters - -*_Address_mode*
-The address mode to use to sample the `texture_view`. The address mode is the same for all dimensions. - -*_Sampler*
-The sampler configuration to use to sample the `texture_view`. - -*_Coord*
-The coordinates to take the sample from. Fractional coordinate values are used to interpolate between sample texels. - -### Return Value - -A rank 4 short vector containing the alpha (w) component of the 4 sampled texel values. - -## get - -Gets the value of the element at the specified index. - -```cpp -const value_type get( - const index<_Rank>& _Index) const restrict(amp); - -value_type get( - const index<_Rank>& _Index, - unsigned int _Mip_level = 0) const restrict(amp); -``` - -### Parameters - -*_Index*
-The index of the element to get, possibly multi-dimensional. - -*_Mip_level*
-The mipmap level from which we should get the value. The default value 0 represents the most detailed mipmap level. - -### Return Value - -The value of the element. - -## operator= - -Assigns a view of the same texture as the specified `texture_view` to this `texture_view` instance. - -```cpp -texture_view& operator= (// [1] copy constructor - const texture_view& _Other) restrict(amp, cpu); - -texture_view& operator= (// [2] copy constructor - const texture_view& _Other) restrict(cpu); - -texture_view& operator= (// [3] copy constructor - const texture_view& _Other) restrict(amp, cpu); -``` - -### Parameters - -*_Other*
-[1, 2] Copy Constructor -A writable `texture_view` object. - -[3] Copy Constructor -A non-writable `texture_view` object. - -### Return Value - -A reference to this `texture_view` instance. - -## operator[] - -Returns the element value by index. - -```cpp -const value_type operator[] (const index<_Rank>& _Index) const restrict(amp); - -const value_type operator[] (int _I0) const restrict(amp); - -value_type operator[] (const index<_Rank>& _Index) const restrict(amp); - -value_type operator[] (int _I0) const restrict(amp); -``` - -### Parameters - -*_Index*
-The index, possibly multi-dimensional. - -*_I0*
-The one-dimensional index. - -### Return Value - -The element value indexed by `_Index`. - -## operator() - -Returns the element value by index. - -```cpp -const value_type operator() ( - const index<_Rank>& _Index) const restrict(amp); - -const value_type operator() ( - int _I0) const restrict(amp); - -const value_type operator() ( - int _I0, int _I1) const restrict(amp); - -const value_type operator() ( - int _I0, - int _I1, - int _I2) const restrict(amp); - -value_type operator() ( - const index<_Rank>& _Index) const restrict(amp); - -value_type operator() ( - int _I0) const restrict(amp); - -value_type operator() ( - int _I0, - int _I1) const restrict(amp); - -value_type operator() ( - int _I0, - int _I1, - int _I2) const restrict(amp); -``` - -### Parameters - -*_Index*
-The index, possibly multi-dimensional. - -*_I0*
-The most-significant component of the index. - -*_I1*
-The next-to-most-significant component of the index. - -*_I2*
-The least-significant component of the index. - -### Return Value - -The element value indexed by `_Index`. - -## sample - -Samples the texture at the specified coordinates and level of detail by using the specified sampling configuration. - -```cpp -value_type sample( - const sampler& _Sampler, - const coordinates_type& _Coord, - float _Level_of_detail = 0.0f) const restrict(amp); - -template< - filter_mode _Filter_mode = filter_linear, - address_mode _Address_mode = address_clamp -> -value_type sample( - const coordinates_type& _Coord, - float _Level_of_detail = 0.0f) const restrict(amp); -``` - -### Parameters - -*_Filter_mode*
-The filter mode to use to sample the texture_view. The filter mode is the same for the minimization, maximization, and mipmap filters. - -*_Address_mode*
-The address mode to use to sample the texture_view. The address mode is the same for all dimensions. - -*_Sampler*
-The sampler configuration to use to sample the texture_view. - -*_Coord*
-The coordinates to take the sample from. Fractional coordinate values are used to interpolate between texel values. - -*_Level_of_detail*
-The value specifies the mipmap level to sample from. Fractional values are used to interpolate between two mipmap levels. The default level of detail is 0, which represents the most detailed mip level. - -### Return Value - -The interpolated sample value. - -## set - -Sets the value of the element at the specified index to the specified value. - -```cpp -void set( - const index<_Rank>& _Index, - const value_type& value) const restrict(amp); -``` - -### Parameters - -*_Index*
-The index of the element to set, possibly multi-dimensional. - -*value*
-The value to set the element to. - -## value_type - -The value type of the elements of the texture_view. - -```cpp -typedef typename const value_type value_type; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/tile-barrier-class.md b/docs/parallel/amp/reference/tile-barrier-class.md deleted file mode 100644 index d9c181b68bd..00000000000 --- a/docs/parallel/amp/reference/tile-barrier-class.md +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: "tile_barrier Class" -description: "Learn more about: tile_barrier Class" -ms.date: "03/27/2019" -f1_keywords: ["tile_barrier", "AMP/tile_barrier", "AMP/Concurrency::tile_barrier::tile_barrier::tile_barrier", "AMP/Concurrency::tile_barrier::tile_barrier::wait", "AMP/Concurrency::tile_barrier::tile_barrier::wait_with_all_memory_fence", "AMP/Concurrency::tile_barrier::tile_barrier::wait_with_global_memory_fence", "AMP/Concurrency::tile_barrier::tile_barrier::wait_with_tile_static_memory_fence"] -helpviewer_keywords: ["tile_barrier class"] ---- -# tile_barrier Class - -Synchronizes the execution of threads that are running in the thread group (the tile) by using `wait` methods. Only the runtime can instantiate this class. - -## Syntax - -```cpp -class tile_barrier; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[tile_barrier Constructor](#ctor)|Initializes a new instance of the `tile_barrier` class.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[wait](#wait)|Instructs all threads in the thread group (tile) to stop executing until all threads in the tile have finished waiting.| -|[wait_with_all_memory_fence](#wait_with_all_memory_fence)|Blocks execution of all threads in a tile until all memory accesses have been completed and all threads in the tile have reached this call.| -|[wait_with_global_memory_fence](#wait_with_global_memory_fence)|Blocks execution of all threads in a tile until all global memory accesses have been completed and all threads in the tile have reached this call.| -|[wait_with_tile_static_memory_fence](#wait_with_tile_static_memory_fence)|Blocks execution of all threads in a tile until all `tile_static` memory accesses have been completed and all threads in the tile have reached this call.| - -## Inheritance Hierarchy - -`tile_barrier` - -## Requirements - -**Header:** amp.h - -**Namespace:** Concurrency - -## tile_barrier Constructor - -Initializes a new instance of the class by copying an existing one. - -### Syntax - -```cpp -tile_barrier( - const tile_barrier& _Other ) restrict(amp,cpu); -``` - -### Parameters - -*_Other*
-The `tile_barrier` object to copy. - -## wait - -Instructs all threads in the thread group (tile) to stop execution until all threads in the tile have finished waiting. - -### Syntax - -```cpp -void wait() const restrict(amp); -``` - -## wait_with_all_memory_fence - -Blocks execution of all threads in a tile until all threads in a tile have reached this call. This ensures that all memory accesses are visible to other threads in the thread tile, and have been executed in program order. - -### Syntax - -```cpp -void wait_with_all_memory_fence() const restrict(amp); -``` - -## wait_with_global_memory_fence - -Blocks execution of all threads in a tile until all threads in a tile have reached this call. This ensures that all global memory accesses are visible to other threads in the thread tile, and have been executed in program order. - -### Syntax - -```cpp -void wait_with_global_memory_fence() const restrict(amp); -``` - -## wait_with_tile_static_memory_fence - -Blocks execution of all threads in a tile until all threads in a tile have reached this call. This ensures that `tile_static` memory accesses are visible to other threads in the thread tile, and have been executed in program order. - -### Syntax - -```cpp -void wait_with_tile_static_memory_fence() const restrict(amp); -``` - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/tiled-extent-class.md b/docs/parallel/amp/reference/tiled-extent-class.md deleted file mode 100644 index ba3df5b31f3..00000000000 --- a/docs/parallel/amp/reference/tiled-extent-class.md +++ /dev/null @@ -1,218 +0,0 @@ ---- -description: "Learn more about: tiled_extent Class" -title: "tiled_extent Class" -ms.date: "11/04/2016" -f1_keywords: ["tiled_extent", "AMP/tiled_extent", "AMP/Concurrency::tiled_extent::tiled_extent", "AMP/Concurrency::tiled_extent::get_tile_extent", "AMP/Concurrency::tiled_extent::pad", "AMP/Concurrency::tiled_extent::truncate", "AMP/Concurrency::tiled_extent::tile_dim0", "AMP/Concurrency::tiled_extent::tile_dim1", "AMP/Concurrency::tiled_extent::tile_dim2", "AMP/Concurrency::tiled_extent::tile_extent"] -ms.assetid: 671ecaf8-c7b0-4ac8-bbdc-e30bd92da7c0 ---- -# tiled_extent Class - -A `tiled_extent` object is an `extent` object of one to three dimensions that subdivides the extent space into one-, two-, or three-dimensional tiles. - -## Syntax - -```cpp -template < - int _Dim0, - int _Dim1, - int _Dim2 -> -class tiled_extent : public Concurrency::extent<3>; - -template < - int _Dim0, - int _Dim1 -> -class tiled_extent<_Dim0, _Dim1, 0> : public Concurrency::extent<2>; - -template < - int _Dim0 -> -class tiled_extent<_Dim0, 0, 0> : public Concurrency::extent<1>; -``` - -### Parameters - -*_Dim0*
-The length of the most significant dimension. - -*_Dim1*
-The length of the next-to-most significant dimension. - -*_Dim2*
-The length of the least significant dimension. - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[tiled_extent Constructor](#ctor)|Initializes a new instance of the `tiled_extent` class.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[get_tile_extent](#get_tile_extent)|Returns an `extent` object that captures the values of the `tiled_extent` template arguments `_Dim0`, `_Dim1`, and `_Dim2`.| -|[pad](#pad)|Returns a new `tiled_extent` object with extents adjusted up to be evenly divisible by the tile dimensions.| -|[truncate](#truncate)|Returns a new `tiled_extent` object with extents adjusted down to be evenly divisible by the tile dimensions.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator=](#operator_eq)|Copies the contents of the specified `tiled_index` object into this one.| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[tile_dim0 Constant](#tile_dim0)|Stores the length of the most significant dimension.| -|[tile_dim1 Constant](#tile_dim1)|Stores the length of the next-to-most significant dimension.| -|[tile_dim2 Constant](#tile_dim2)|Stores the length of the least significant dimension.| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|[tile_extent](#tile_extent)|Gets an `extent` object that captures the values of the `tiled_extent` template arguments `_Dim0`, `_Dim1`, and `_Dim2`.| - -## Inheritance Hierarchy - -`extent` - -`tiled_extent` - -## Requirements - -**Header:** amp.h - -**Namespace:** Concurrency - -## tiled_extent Constructor - -Initializes a new instance of the `tiled_extent` class. - -### Syntax - -```cpp -tiled_extent(); - -tiled_extent( - const Concurrency::extent& _Other ); - -tiled_extent( - const tiled_extent& _Other ); -``` - -### Parameters - -*_Other*
-The `extent` or `tiled_extent` object to copy. - -## get_tile_extent - -Returns an `extent` object that captures the values of the `tiled_extent` template arguments `_Dim0`, `_Dim1`, and `_Dim2`. - -### Syntax - -```cpp -Concurrency::extent get_tile_extent() const restrict(amp,cpu); -``` - -### Return Value - -An `extent` object that captures the dimensions of this `tiled_extent` instance. - -## pad - -Returns a new `tiled_extent` object with extents adjusted up to be evenly divisible by the tile dimensions. - -### Syntax - -```cpp -tiled_extent pad() const; -``` - -### Return Value - -The new `tiled_extent` object, by value. - -## truncate - -Returns a new `tiled_extent` object with extents adjusted down to be evenly divisible by the tile dimensions. - -### Syntax - -```cpp -tiled_extent truncate() const; -``` - -### Return Value - -Returns a new `tiled_extent` object with extents adjusted down to be evenly divisible by the tile dimensions. - -## operator= - -Copies the contents of the specified `tiled_index` object into this one. - -### Syntax - -```cpp -tiled_extent& operator= ( - const tiled_extent& _Other ) restrict (amp, cpu); -``` - -### Parameters - -*_Other*
-The `tiled_index` object to copy from. - -### Return Value - -A reference to this `tiled_index` instance. - -## tile_dim0 - -Stores the length of the most significant dimension. - -### Syntax - -```cpp -static const int tile_dim0 = _Dim0; -``` - -## tile_dim1 - -Stores the length of the next-to-most significant dimension. - -### Syntax - -```cpp -static const int tile_dim1 = _Dim1; -``` - -## tile_dim2 - -Stores the length of the least significant dimension. - -### Syntax - -```cpp -static const int tile_dim2 = _Dim2; -``` - -## tile_extent - -Gets an `extent` object that captures the values of the `tiled_extent` template arguments `_Dim0`, `_Dim1`, and `_Dim2`. - -### Syntax - -```cpp -__declspec(property(get= get_tile_extent)) Concurrency::extent tile_extent; -``` - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/tiled-index-class.md b/docs/parallel/amp/reference/tiled-index-class.md deleted file mode 100644 index 0ce0b17509e..00000000000 --- a/docs/parallel/amp/reference/tiled-index-class.md +++ /dev/null @@ -1,253 +0,0 @@ ---- -description: "Learn more about: tiled_index Class" -title: "tiled_index Class" -ms.date: "03/27/2019" -f1_keywords: ["tiled_index", "AMP/tiled_index", "AMP/Concurrency::tiled_index::tiled_index", "AMP/Concurrency::tiled_index::get_tile_extent", "AMP/Concurrency::tiled_index::barrier", "AMP/Concurrency::tiled_index::global", "AMP/Concurrency::tiled_index::local", "AMP/Concurrency::tiled_index::rank", "AMP/Concurrency::tiled_index::tile", "AMP/Concurrency::tiled_index::tile_dim0", "AMP/Concurrency::tiled_index::tile_dim1", "AMP/Concurrency::tiled_index::tile_dim2", "AMP/Concurrency::tiled_index::tile_origin", "AMP/Concurrency::tiled_index::tile_extent"] -helpviewer_keywords: ["tiled_index class"] -ms.assetid: 0ce2ae26-f1bb-4436-b473-a9e1b619bb38 ---- -# tiled_index Class - -Provides an index into a [tiled_extent](tiled-extent-class.md) object. This class has properties to access elements relative to the local tile origin and relative to the global origin. For more information about tiled spaces, see [Using Tiles](../../../parallel/amp/using-tiles.md). - -## Syntax - -```cpp -template < - int _Dim0, - int _Dim1 = 0, - int _Dim2 = 0 -> -class tiled_index : public _Tiled_index_base<3>; - -template < - int _Dim0, - int _Dim1 -> -class tiled_index<_Dim0, _Dim1, 0> : public _Tiled_index_base<2>; - -template < - int _Dim0 -> -class tiled_index<_Dim0, 0, 0> : public _Tiled_index_base<1>; -``` - -### Parameters - -*_Dim0*
-The length of the most significant dimension. - -*_Dim1*
-The length of the next-to-most significant dimension. - -*_Dim2*
-The length of the least significant dimension. - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[tiled_index Constructor](#ctor)|Initializes a new instance of the `tile_index` class.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[get_tile_extent](#tiled_index__get_tile_extent)|Returns an [extent](extent-class.md) object that has the values of the `tiled_index` template arguments `_Dim0`, `_Dim1`, and `_Dim2`.| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[barrier Constant](#tiled_index__barrier)|Stores a [tile_barrier](tile-barrier-class.md) object that represents a barrier in the current tile of threads.| -|[global Constant](#tiled_index__global)|Stores an [index](index-class.md) object of rank 1, 2, or 3 that represents the global index in a grid object.| -|[local Constant](#tiled_index__local)|Stores an `index` object of rank 1, 2, or 3 that represents the relative index in the current tile of a [tiled_extent](tiled-extent-class.md) object.| -|[rank Constant](#tiled_index__rank)|Stores the rank of the `tiled_index` object.| -|[tile Constant](#tiled_index__tile)|Stores an `index` object of rank 1, 2, or 3 that represents the coordinates of the current tile of a `tiled_extent` object.| -|[tile_dim0 Constant](#tiled_index__tile_dim0)|Stores the length of the most significant dimension.| -|[tile_dim1 Constant](#tiled_index__tile_dim1)|Stores the length of the next-to-most significant dimension.| -|[tile_dim2 Constant](#tiled_index__tile_dim2)|Stores the length of the least significant dimension.| -|[tile_origin Constant](#tiled_index__tile_origin)|Stores an `index` object of rank 1, 2, or 3 that represents the global coordinates of the origin of the current tile in a `tiled_extent` object.| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|[tile_extent](#tile_extent)|Gets an [extent](extent-class.md) object that has the values of the `tiled_index` template arguments `tiled_index` template arguments `_Dim0`, `_Dim1`, and `_Dim2`.| - -## Inheritance Hierarchy - -`_Tiled_index_base` - -`tiled_index` - -## Requirements - -**Header:** amp.h - -**Namespace:** Concurrency - -## tiled_index Constructor - -Initializes a new instance of the `tiled_index` class. - -### Syntax - -```cpp -tiled_index( - const index& _Global, - const index& _Local, - const index& _Tile, - const index& _Tile_origin, - const tile_barrier& _Barrier ) restrict(amp,cpu); - -tiled_index( - const tiled_index& _Other ) restrict(amp,cpu); -``` - -### Parameters - -*_Global*
-The global [index](index-class.md) of the constructed `tiled_index`. - -*_Local*
-The local [index](index-class.md) of the constructed `tiled_index` - -*_Tile*
-The tile [index](index-class.md) of the constructed `tiled_index` - -*_Tile_origin*
-The tile origin [index](index-class.md) of the constructed `tiled_index` - -*_Barrier*
-The [tile_barrier](tile-barrier-class.md) object of the constructed `tiled_index`. - -*_Other*
-The `tile_index` object to be copied to the constructed `tiled_index`. - -### Overloads - -|Name|Description| -|-|-| -|`tiled_index(const index& _Global, const index& _Local, const index& _Tile, const index& _Tile_origin, const tile_barrier& _Barrier restrict(amp,cpu);`|Initializes a new instance of the `tile_index` class from the index of the tile in global coordinates and the relative position in the tile in local coordinates. The `_Global` and `_Tile_origin` parameters are computed.| -|`tiled_index( const tiled_index& _Other) restrict(amp,cpu);`|Initializes a new instance of the `tile_index` class by copying the specified `tiled_index` object.| - -## get_tile_extent - -Returns an [extent](extent-class.md) object that has the values of the `tiled_index` template arguments `_Dim0`, `_Dim1`, and `_Dim2`. - -### Syntax - -```cpp -extent get_tile_extent()restrict(amp,cpu); -``` - -### Return Value - -An `extent` object that has the values of the `tiled_index` template arguments `_Dim0`, `_Dim1`, and `_Dim2`. - -## barrier - -Stores a [tile_barrier](tile-barrier-class.md) object that represents a barrier in the current tile of threads. - -### Syntax - -```cpp -const tile_barrier barrier; -``` - -## global - -Stores an [index](index-class.md) object of rank 1, 2, or 3 that represents the global index of an object. - -### Syntax - -```cpp -const index global; -``` - -## local - -Stores an [index](index-class.md) object of rank 1, 2, or 3 that represents the relative index in the current tile of a [tiled_extent](tiled-extent-class.md) object. - -### Syntax - -```cpp -const index local; -``` - -## rank - -Stores the rank of the `tiled_index` object. - -### Syntax - -```cpp -static const int rank = _Rank; -``` - -## tile - -Stores an [index](index-class.md) object of rank 1, 2, or 3 that represents the coordinates of the current tile of a [tiled_extent](tiled-extent-class.md) object. - -### Syntax - -```cpp -const index tile; -``` - -## tile_dim0 - -Stores the length of the most significant dimension. - -### Syntax - -```cpp -static const int tile_dim0 = _Dim0; -``` - -## tile_dim1 - -Stores the length of the next-to-most significant dimension. - -### Syntax - -```cpp -static const int tile_dim1 = _Dim1; -``` - -## tile_dim2 - -Stores the length of the least significant dimension. - -### Syntax - -```cpp -static const int tile_dim2 = _Dim2; -``` - -## tile_origin - -Stores an [index](index-class.md) object of rank 1, 2, or 3 that represents the global coordinates of the origin of the current tile within a [tiled_extent](tiled-extent-class.md) object. - -### Syntax - -```cpp -const index tile_origin -``` - -## tile_extent - -Gets an [extent](extent-class.md) object that has the values of the `tiled_index` template arguments `tiled_index` template arguments `_Dim0`, `_Dim1`, and `_Dim2`. - -### Syntax - -```cpp -__declspec(property(get= get_tile_extent)) extent tile_extent; -``` - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/uint-2-class.md b/docs/parallel/amp/reference/uint-2-class.md deleted file mode 100644 index b94c30a56f3..00000000000 --- a/docs/parallel/amp/reference/uint-2-class.md +++ /dev/null @@ -1,161 +0,0 @@ ---- -description: "Learn more about: uint_2 Class" -title: "uint_2 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::uint_2::set_xy", "amp_short_vectors/Concurrency::graphics::uint_2::y", "amp_short_vectors/Concurrency::graphics::uint_2::gr", "amp_short_vectors/Concurrency::graphics::uint_2::operator-", "amp_short_vectors/Concurrency::graphics::uint_2::get_x", "amp_short_vectors/Concurrency::graphics::uint_2::operator-=", "amp_short_vectors/Concurrency::graphics::uint_2::r", "amp_short_vectors/Concurrency::graphics::uint_2::yx", "amp_short_vectors/Concurrency::graphics::uint_2::operator--", "amp_short_vectors/Concurrency::graphics::uint_2::set_yx", "amp_short_vectors/Concurrency::graphics::uint_2::operator=", "amp_short_vectors/Concurrency::graphics::uint_2::set_x", "amp_short_vectors/Concurrency::graphics::uint_2::operator+=", "amp_short_vectors/Concurrency::graphics::uint_2::get_y", "amp_short_vectors/Concurrency::graphics::uint_2::xy", "amp_short_vectors/Concurrency::graphics::uint_2::x", "amp_short_vectors/Concurrency::graphics::uint_2::get_xy", "amp_short_vectors/Concurrency::graphics::uint_2::set_y", "amp_short_vectors/Concurrency::graphics::uint_2", "amp_short_vectors/Concurrency::graphics::uint_2::operator*=", "amp_short_vectors/Concurrency::graphics::uint_2::get_yx", "amp_short_vectors/Concurrency::graphics::uint_2::operator/=", "amp_short_vectors/Concurrency::graphics::uint_2::g", "amp_short_vectors/Concurrency::graphics::uint_2::operator++", "amp_short_vectors/Concurrency::graphics::uint_2::rg"] -ms.assetid: 9fcc9129-72b1-4da7-9012-4d3be15f1c52 ---- -# uint_2 Class - -Represents a short vector of two unsigned integers. - -## Syntax - -```cpp -class uint_2; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[uint_2 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|uint_2::get_x|| -|uint_2::get_xy|| -|uint_2::get_y|| -|uint_2::get_yx|| -|uint_2::ref_g_Method|| -|uint_2::ref_r_Method|| -|uint_2::ref_x_Method|| -|uint_2::ref_y_Method|| -|uint_2::set_x|| -|uint_2::set_xy|| -|uint_2::set_y|| -|uint_2::set_yx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|uint_2::operator--|| -|uint_2::operator%=|| -|uint_2::operator&=|| -|uint_2::operator*=|| -|uint_2::operator/=|| -|uint_2::operator^=|| -|uint_2::operator\|=|| -|uint_2::operator~|| -|uint_2::operator++|| -|uint_2::operator+=|| -|uint_2::operator<\<=|| -|uint_2::operator=|| -|uint_2::operator-=|| -|uint_2::operator>>=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#uint_2__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|uint_2::g|| -|uint_2::gr|| -|uint_2::r|| -|uint_2::rg|| -|uint_2::x|| -|uint_2::xy|| -|uint_2::y|| -|uint_2::yx|| - -## Inheritance Hierarchy - -`uint_2` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## uint_2 - -Default constructor, initializes all elements with 0. - -```cpp -uint_2() restrict(amp, - cpu); - -uint_2( - unsigned int _V0, - unsigned int _V1) restrict(amp, - cpu); - -uint_2( - unsigned int _V) restrict(amp, - cpu); - -uint_2( - const uint_2& _Other) restrict(amp, - cpu); - -explicit inline uint_2( - const int_2& _Other) restrict(amp, - cpu); - -explicit inline uint_2( - const float_2& _Other) restrict(amp, - cpu); - -explicit inline uint_2( - const unorm_2& _Other) restrict(amp, - cpu); - -explicit inline uint_2( - const norm_2& _Other) restrict(amp, - cpu); - -explicit inline uint_2( - const double_2& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 2; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/uint-3-class.md b/docs/parallel/amp/reference/uint-3-class.md deleted file mode 100644 index f6eba197139..00000000000 --- a/docs/parallel/amp/reference/uint-3-class.md +++ /dev/null @@ -1,211 +0,0 @@ ---- -description: "Learn more about: uint_3 Class" -title: "uint_3 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::uint_3::get_xz", "amp_short_vectors/Concurrency::graphics::uint_3::set_yzx", "amp_short_vectors/Concurrency::graphics::uint_3::get_y", "amp_short_vectors/Concurrency::graphics::uint_3::get_yzx", "amp_short_vectors/Concurrency::graphics::uint_3::get_yz", "amp_short_vectors/Concurrency::graphics::uint_3::yzx", "amp_short_vectors/Concurrency::graphics::uint_3::get_z", "amp_short_vectors/Concurrency::graphics::uint_3::z", "amp_short_vectors/Concurrency::graphics::uint_3::xy", "amp_short_vectors/Concurrency::graphics::uint_3::gr", "amp_short_vectors/Concurrency::graphics::uint_3::operator=", "amp_short_vectors/Concurrency::graphics::uint_3::x", "amp_short_vectors/Concurrency::graphics::uint_3::gbr", "amp_short_vectors/Concurrency::graphics::uint_3::set_xy", "amp_short_vectors/Concurrency::graphics::uint_3::g", "amp_short_vectors/Concurrency::graphics::uint_3::set_yz", "amp_short_vectors/Concurrency::graphics::uint_3::br", "amp_short_vectors/Concurrency::graphics::uint_3::get_xyz", "amp_short_vectors/Concurrency::graphics::uint_3::b", "amp_short_vectors/Concurrency::graphics::uint_3::get_yxz", "amp_short_vectors/Concurrency::graphics::uint_3::set_zyx", "amp_short_vectors/Concurrency::graphics::uint_3::get_x", "amp_short_vectors/Concurrency::graphics::uint_3::rgb", "amp_short_vectors/Concurrency::graphics::uint_3::set_zy", "amp_short_vectors/Concurrency::graphics::uint_3::brg", "amp_short_vectors/Concurrency::graphics::uint_3::set_xyz", "amp_short_vectors/Concurrency::graphics::uint_3::xyz", "amp_short_vectors/Concurrency::graphics::uint_3::set_zxy", "amp_short_vectors/Concurrency::graphics::uint_3", "amp_short_vectors/Concurrency::graphics::uint_3::get_xy", "amp_short_vectors/Concurrency::graphics::uint_3::set_yx", "amp_short_vectors/Concurrency::graphics::uint_3::get_zyx", "amp_short_vectors/Concurrency::graphics::uint_3::get_zxy", "amp_short_vectors/Concurrency::graphics::uint_3::set_y", "amp_short_vectors/Concurrency::graphics::uint_3::yx", "amp_short_vectors/Concurrency::graphics::uint_3::grb", "amp_short_vectors/Concurrency::graphics::uint_3::operator+=", "amp_short_vectors/Concurrency::graphics::uint_3::set_x", "amp_short_vectors/Concurrency::graphics::uint_3::operator/=", "amp_short_vectors/Concurrency::graphics::uint_3::rbg", "amp_short_vectors/Concurrency::graphics::uint_3::set_zx", "amp_short_vectors/Concurrency::graphics::uint_3::set_z", "amp_short_vectors/Concurrency::graphics::uint_3::get_zx", "amp_short_vectors/Concurrency::graphics::uint_3::bgr", "amp_short_vectors/Concurrency::graphics::uint_3::get_xzy", "amp_short_vectors/Concurrency::graphics::uint_3::get_yx", "amp_short_vectors/Concurrency::graphics::uint_3::bg", "amp_short_vectors/Concurrency::graphics::uint_3::r", "amp_short_vectors/Concurrency::graphics::uint_3::xzy", "amp_short_vectors/Concurrency::graphics::uint_3::zyx", "amp_short_vectors/Concurrency::graphics::uint_3::set_xz", "amp_short_vectors/Concurrency::graphics::uint_3::rg", "amp_short_vectors/Concurrency::graphics::uint_3::zxy", "amp_short_vectors/Concurrency::graphics::uint_3::zy", "amp_short_vectors/Concurrency::graphics::uint_3::yz", "amp_short_vectors/Concurrency::graphics::uint_3::zx", "amp_short_vectors/Concurrency::graphics::uint_3::gb", "amp_short_vectors/Concurrency::graphics::uint_3::operator--", "amp_short_vectors/Concurrency::graphics::uint_3::set_yxz", "amp_short_vectors/Concurrency::graphics::uint_3::get_zy", "amp_short_vectors/Concurrency::graphics::uint_3::operator++", "amp_short_vectors/Concurrency::graphics::uint_3::operator-", "amp_short_vectors/Concurrency::graphics::uint_3::y", "amp_short_vectors/Concurrency::graphics::uint_3::xz", "amp_short_vectors/Concurrency::graphics::uint_3::rb", "amp_short_vectors/Concurrency::graphics::uint_3::operator*=", "amp_short_vectors/Concurrency::graphics::uint_3::yxz", "amp_short_vectors/Concurrency::graphics::uint_3::set_xzy", "amp_short_vectors/Concurrency::graphics::uint_3::operator-="] -ms.assetid: 5e22c277-9d4f-4a3a-b38c-a83d5fcab33c ---- -# uint_3 Class - -Represents a short vector of three unsigned integers. - -## Syntax - -```cpp -class uint_3; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[uint_3 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|uint_3::get_x|| -|uint_3::get_xy|| -|uint_3::get_xyz|| -|uint_3::get_xz|| -|uint_3::get_xzy|| -|uint_3::get_y|| -|uint_3::get_yx|| -|uint_3::get_yxz|| -|uint_3::get_yz|| -|uint_3::get_yzx|| -|uint_3::get_z|| -|uint_3::get_zx|| -|uint_3::get_zxy|| -|uint_3::get_zy|| -|uint_3::get_zyx|| -|uint_t::ref_b|| -|uint_t::ref_g|| -|uint_t::ref_r|| -|uint_t::ref_x|| -|uint_t::ref_y|| -|uint_t::ref_z|| -|uint_3::set_x|| -|uint_3::set_xy|| -|uint_3::set_xyz|| -|uint_3::set_xz|| -|uint_3::set_xzy|| -|uint_3::set_y|| -|uint_3::set_yx|| -|uint_3::set_yxz|| -|uint_3::set_yz|| -|uint_3::set_yzx|| -|uint_3::set_z|| -|uint_3::set_zx|| -|uint_3::set_zxy|| -|uint_3::set_zy|| -|uint_3::set_zyx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|uint_3::operator--|| -|uint_3::operator%=|| -|uint_3::operator&=|| -|uint_3::operator*=|| -|uint_3::operator/=|| -|uint_3::operator^=|| -|uint_3::operator\|=|| -|uint_3::operator~|| -|uint_3::operator++|| -|uint_3::operator+=|| -|uint_3::operator<\<=|| -|uint_3::operator=|| -|uint_3::operator-=|| -|uint_3::operator>>=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#uint_3__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|uint_3::b|| -|uint_3::bg|| -|uint_3::bgr|| -|uint_3::br|| -|uint_3::brg|| -|uint_3::g|| -|uint_3::gb|| -|uint_3::gbr|| -|uint_3::gr|| -|uint_3::grb|| -|uint_3::r|| -|uint_3::rb|| -|uint_3::rbg|| -|uint_3::rg|| -|uint_3::rgb|| -|uint_3::x|| -|uint_3::xy|| -|uint_3::xyz|| -|uint_3::xz|| -|uint_3::xzy|| -|uint_3::y|| -|uint_3::yx|| -|uint_3::yxz|| -|uint_3::yz|| -|uint_3::yzx|| -|uint_3::z|| -|uint_3::zx|| -|uint_3::zxy|| -|uint_3::zy|| -|uint_3::zyx|| - -## Inheritance Hierarchy - -`uint_3` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## uint_3 - -Default constructor, initializes all elements with 0. - -```cpp -uint_3() restrict(amp, - cpu); - -uint_3( - unsigned int _V0, - unsigned int _V1, - unsigned int _V2) restrict(amp, - cpu); - -uint_3( - unsigned int _V) restrict(amp, - cpu); - -uint_3( - const uint_3& _Other) restrict(amp, - cpu); - -explicit inline uint_3( - const int_3& _Other) restrict(amp, - cpu); - -explicit inline uint_3( - const float_3& _Other) restrict(amp, - cpu); - -explicit inline uint_3( - const unorm_3& _Other) restrict(amp, - cpu); - -explicit inline uint_3( - const norm_3& _Other) restrict(amp, - cpu); - -explicit inline uint_3( - const double_3& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 3; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/uint-4-class.md b/docs/parallel/amp/reference/uint-4-class.md deleted file mode 100644 index 52c3c56b77a..00000000000 --- a/docs/parallel/amp/reference/uint-4-class.md +++ /dev/null @@ -1,402 +0,0 @@ ---- -description: "Learn more about: uint_4 Class" -title: "uint_4 Class" -ms.date: "03/27/2019" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::uint_4::ywx", "amp_short_vectors/Concurrency::graphics::uint_4::get_yxw", "amp_short_vectors/Concurrency::graphics::uint_4::xw", "amp_short_vectors/Concurrency::graphics::uint_4::brga", "amp_short_vectors/Concurrency::graphics::uint_4::get_zw", "amp_short_vectors/Concurrency::graphics::uint_4::get_wzyx", "amp_short_vectors/Concurrency::graphics::uint_4::operator+=", "amp_short_vectors/Concurrency::graphics::uint_4::zw", "amp_short_vectors/Concurrency::graphics::uint_4::set_zy", "amp_short_vectors/Concurrency::graphics::uint_4::rgba", "amp_short_vectors/Concurrency::graphics::uint_4::grab", "amp_short_vectors/Concurrency::graphics::uint_4::xzwy", "amp_short_vectors/Concurrency::graphics::uint_4::get_ywzx", "amp_short_vectors/Concurrency::graphics::uint_4::set_xzwy", "amp_short_vectors/Concurrency::graphics::uint_4::set_wz", "amp_short_vectors/Concurrency::graphics::uint_4::ab", "amp_short_vectors/Concurrency::graphics::uint_4::set_zxy", "amp_short_vectors/Concurrency::graphics::uint_4::gabr", "amp_short_vectors/Concurrency::graphics::uint_4::agrb", "amp_short_vectors/Concurrency::graphics::uint_4::zxy", "amp_short_vectors/Concurrency::graphics::uint_4::br", "amp_short_vectors/Concurrency::graphics::uint_4::ragb", "amp_short_vectors/Concurrency::graphics::uint_4::rgb", "amp_short_vectors/Concurrency::graphics::uint_4::arb", "amp_short_vectors/Concurrency::graphics::uint_4::xyzw", "amp_short_vectors/Concurrency::graphics::uint_4::wzyx", "amp_short_vectors/Concurrency::graphics::uint_4::zxwy", "amp_short_vectors/Concurrency::graphics::uint_4::set_yzxw", "amp_short_vectors/Concurrency::graphics::uint_4::zwxy", "amp_short_vectors/Concurrency::graphics::uint_4::operator*=", "amp_short_vectors/Concurrency::graphics::uint_4::yzwx", "amp_short_vectors/Concurrency::graphics::uint_4::bg", "amp_short_vectors/Concurrency::graphics::uint_4::set_yz", "amp_short_vectors/Concurrency::graphics::uint_4::x", "amp_short_vectors/Concurrency::graphics::uint_4::set_z", "amp_short_vectors/Concurrency::graphics::uint_4::grba", "amp_short_vectors/Concurrency::graphics::uint_4::zwy", "amp_short_vectors/Concurrency::graphics::uint_4::get_yzwx", "amp_short_vectors/Concurrency::graphics::uint_4::xz", "amp_short_vectors/Concurrency::graphics::uint_4::set_wxyz", "amp_short_vectors/Concurrency::graphics::uint_4::b", "amp_short_vectors/Concurrency::graphics::uint_4::set_zx", "amp_short_vectors/Concurrency::graphics::uint_4::set_wyzx", "amp_short_vectors/Concurrency::graphics::uint_4::get_xyw", "amp_short_vectors/Concurrency::graphics::uint_4::get_ywz", "amp_short_vectors/Concurrency::graphics::uint_4::g", "amp_short_vectors/Concurrency::graphics::uint_4::get_zwxy", "amp_short_vectors/Concurrency::graphics::uint_4::yxzw", "amp_short_vectors/Concurrency::graphics::uint_4::set_ywx", "amp_short_vectors/Concurrency::graphics::uint_4::ar", "amp_short_vectors/Concurrency::graphics::uint_4::get_zyxw", "amp_short_vectors/Concurrency::graphics::uint_4::get_yxz", "amp_short_vectors/Concurrency::graphics::uint_4::set_xy", "amp_short_vectors/Concurrency::graphics::uint_4::get_y", "amp_short_vectors/Concurrency::graphics::uint_4::ga", "amp_short_vectors/Concurrency::graphics::uint_4::zyx", "amp_short_vectors/Concurrency::graphics::uint_4::get_zyx", "amp_short_vectors/Concurrency::graphics::uint_4::get_zxyw", "amp_short_vectors/Concurrency::graphics::uint_4::wy", "amp_short_vectors/Concurrency::graphics::uint_4::set_y", "amp_short_vectors/Concurrency::graphics::uint_4::bgr", "amp_short_vectors/Concurrency::graphics::uint_4::gbr", "amp_short_vectors/Concurrency::graphics::uint_4::wzxy", "amp_short_vectors/Concurrency::graphics::uint_4::set_wxz", "amp_short_vectors/Concurrency::graphics::uint_4::get_wxy", "amp_short_vectors/Concurrency::graphics::uint_4::set_zxyw", "amp_short_vectors/Concurrency::graphics::uint_4::bagr", "amp_short_vectors/Concurrency::graphics::uint_4::zxw", "amp_short_vectors/Concurrency::graphics::uint_4::operator/=", "amp_short_vectors/Concurrency::graphics::uint_4::rabg", "amp_short_vectors/Concurrency::graphics::uint_4::get_xwzy", "amp_short_vectors/Concurrency::graphics::uint_4::get_xzwy", "amp_short_vectors/Concurrency::graphics::uint_4::xywz", "amp_short_vectors/Concurrency::graphics::uint_4::get_ywxz", "amp_short_vectors/Concurrency::graphics::uint_4::get_z", "amp_short_vectors/Concurrency::graphics::uint_4::set_xyw", "amp_short_vectors/Concurrency::graphics::uint_4::get_wxzy", "amp_short_vectors/Concurrency::graphics::uint_4::get_yxzw", "amp_short_vectors/Concurrency::graphics::uint_4::z", "amp_short_vectors/Concurrency::graphics::uint_4::operator=", "amp_short_vectors/Concurrency::graphics::uint_4::wxyz", "amp_short_vectors/Concurrency::graphics::uint_4::set_xwzy", "amp_short_vectors/Concurrency::graphics::uint_4::set_yw", "amp_short_vectors/Concurrency::graphics::uint_4::a", "amp_short_vectors/Concurrency::graphics::uint_4::set_zwyx", "amp_short_vectors/Concurrency::graphics::uint_4::xy", "amp_short_vectors/Concurrency::graphics::uint_4::get_yzx", "amp_short_vectors/Concurrency::graphics::uint_4::rg", "amp_short_vectors/Concurrency::graphics::uint_4::rgab", "amp_short_vectors/Concurrency::graphics::uint_4::set_xwz", "amp_short_vectors/Concurrency::graphics::uint_4::set_zyxw", "amp_short_vectors/Concurrency::graphics::uint_4::gra", "amp_short_vectors/Concurrency::graphics::uint_4::rbg", "amp_short_vectors/Concurrency::graphics::uint_4::set_zwxy", "amp_short_vectors/Concurrency::graphics::uint_4::get_wzxy", "amp_short_vectors/Concurrency::graphics::uint_4::zyxw", "amp_short_vectors/Concurrency::graphics::uint_4::set_wzxy", "amp_short_vectors/Concurrency::graphics::uint_4::set_yxw", "amp_short_vectors/Concurrency::graphics::uint_4::yz", "amp_short_vectors/Concurrency::graphics::uint_4::zwx", "amp_short_vectors/Concurrency::graphics::uint_4::w", "amp_short_vectors/Concurrency::graphics::uint_4::get_xwyz", "amp_short_vectors/Concurrency::graphics::uint_4::rab", "amp_short_vectors/Concurrency::graphics::uint_4::set_wzy", "amp_short_vectors/Concurrency::graphics::uint_4::get_xwy", "amp_short_vectors/Concurrency::graphics::uint_4::get_zywx", "amp_short_vectors/Concurrency::graphics::uint_4::set_wx", "amp_short_vectors/Concurrency::graphics::uint_4::set_wxy", "amp_short_vectors/Concurrency::graphics::uint_4::get_ywx", "amp_short_vectors/Concurrency::graphics::uint_4::set_wyx", "amp_short_vectors/Concurrency::graphics::uint_4::bag", "amp_short_vectors/Concurrency::graphics::uint_4::zyw", "amp_short_vectors/Concurrency::graphics::uint_4::get_wx", "amp_short_vectors/Concurrency::graphics::uint_4::get_xyzw", "amp_short_vectors/Concurrency::graphics::uint_4::abg", "amp_short_vectors/Concurrency::graphics::uint_4::bra", "amp_short_vectors/Concurrency::graphics::uint_4::get_zx", "amp_short_vectors/Concurrency::graphics::uint_4::gab", "amp_short_vectors/Concurrency::graphics::uint_4::barg", "amp_short_vectors/Concurrency::graphics::uint_4::agbr", "amp_short_vectors/Concurrency::graphics::uint_4::yzxw", "amp_short_vectors/Concurrency::graphics::uint_4::set_xwyz", "amp_short_vectors/Concurrency::graphics::uint_4::get_zyw", "amp_short_vectors/Concurrency::graphics::uint_4::ag", "amp_short_vectors/Concurrency::graphics::uint_4::zxyw", "amp_short_vectors/Concurrency::graphics::uint_4::operator++", "amp_short_vectors/Concurrency::graphics::uint_4::wxy", "amp_short_vectors/Concurrency::graphics::uint_4::set_xyz", "amp_short_vectors/Concurrency::graphics::uint_4::grb", "amp_short_vectors/Concurrency::graphics::uint_4", "amp_short_vectors/Concurrency::graphics::uint_4::wyz", "amp_short_vectors/Concurrency::graphics::uint_4::gr", "amp_short_vectors/Concurrency::graphics::uint_4::get_zxw", "amp_short_vectors/Concurrency::graphics::uint_4::set_zwx", "amp_short_vectors/Concurrency::graphics::uint_4::ra", "amp_short_vectors/Concurrency::graphics::uint_4::bgar", "amp_short_vectors/Concurrency::graphics::uint_4::get_yz", "amp_short_vectors/Concurrency::graphics::uint_4::abrg", "amp_short_vectors/Concurrency::graphics::uint_4::zywx", "amp_short_vectors/Concurrency::graphics::uint_4::set_yxwz", "amp_short_vectors/Concurrency::graphics::uint_4::get_wzy", "amp_short_vectors/Concurrency::graphics::uint_4::set_zxw", "amp_short_vectors/Concurrency::graphics::uint_4::get_xzy", "amp_short_vectors/Concurrency::graphics::uint_4::agr", "amp_short_vectors/Concurrency::graphics::uint_4::set_wzyx", "amp_short_vectors/Concurrency::graphics::uint_4::r", "amp_short_vectors/Concurrency::graphics::uint_4::operator-=", "amp_short_vectors/Concurrency::graphics::uint_4::set_wxzy", "amp_short_vectors/Concurrency::graphics::uint_4::set_yxzw", "amp_short_vectors/Concurrency::graphics::uint_4::agb", "amp_short_vectors/Concurrency::graphics::uint_4::set_zyx", "amp_short_vectors/Concurrency::graphics::uint_4::get_zwyx", "amp_short_vectors/Concurrency::graphics::uint_4::get_yzw", "amp_short_vectors/Concurrency::graphics::uint_4::set_wy", "amp_short_vectors/Concurrency::graphics::uint_4::xwzy", "amp_short_vectors/Concurrency::graphics::uint_4::set_zyw", "amp_short_vectors/Concurrency::graphics::uint_4::wyx", "amp_short_vectors/Concurrency::graphics::uint_4::zx", "amp_short_vectors/Concurrency::graphics::uint_4::yx", "amp_short_vectors/Concurrency::graphics::uint_4::get_xyz", "amp_short_vectors/Concurrency::graphics::uint_4::get_wy", "amp_short_vectors/Concurrency::graphics::uint_4::get_xzw", "amp_short_vectors/Concurrency::graphics::uint_4::set_yzw", "amp_short_vectors/Concurrency::graphics::uint_4::get_wz", "amp_short_vectors/Concurrency::graphics::uint_4::xzy", "amp_short_vectors/Concurrency::graphics::uint_4::bar", "amp_short_vectors/Concurrency::graphics::uint_4::set_xzyw", "amp_short_vectors/Concurrency::graphics::uint_4::get_wyx", "amp_short_vectors/Concurrency::graphics::uint_4::wxz", "amp_short_vectors/Concurrency::graphics::uint_4::yzw", "amp_short_vectors/Concurrency::graphics::uint_4::get_xwz", "amp_short_vectors/Concurrency::graphics::uint_4::ywxz", "amp_short_vectors/Concurrency::graphics::uint_4::wyzx", "amp_short_vectors/Concurrency::graphics::uint_4::set_xz", "amp_short_vectors/Concurrency::graphics::uint_4::get_yxwz", "amp_short_vectors/Concurrency::graphics::uint_4::get_yx", "amp_short_vectors/Concurrency::graphics::uint_4::zwyx", "amp_short_vectors/Concurrency::graphics::uint_4::arg", "amp_short_vectors/Concurrency::graphics::uint_4::wzx", "amp_short_vectors/Concurrency::graphics::uint_4::rbga", "amp_short_vectors/Concurrency::graphics::uint_4::set_zwy", "amp_short_vectors/Concurrency::graphics::uint_4::get_xzyw", "amp_short_vectors/Concurrency::graphics::uint_4::get_xywz", "amp_short_vectors/Concurrency::graphics::uint_4::yxz", "amp_short_vectors/Concurrency::graphics::uint_4::rbag", "amp_short_vectors/Concurrency::graphics::uint_4::yzx", "amp_short_vectors/Concurrency::graphics::uint_4::set_zw", "amp_short_vectors/Concurrency::graphics::uint_4::wzy", "amp_short_vectors/Concurrency::graphics::uint_4::get_zxy", "amp_short_vectors/Concurrency::graphics::uint_4::get_zy", "amp_short_vectors/Concurrency::graphics::uint_4::abr", "amp_short_vectors/Concurrency::graphics::uint_4::gbra", "amp_short_vectors/Concurrency::graphics::uint_4::xzyw", "amp_short_vectors/Concurrency::graphics::uint_4::get_wxz", "amp_short_vectors/Concurrency::graphics::uint_4::xwy", "amp_short_vectors/Concurrency::graphics::uint_4::set_ywzx", "amp_short_vectors/Concurrency::graphics::uint_4::set_zywx", "amp_short_vectors/Concurrency::graphics::uint_4::wyxz", "amp_short_vectors/Concurrency::graphics::uint_4::set_x", "amp_short_vectors/Concurrency::graphics::uint_4::gb", "amp_short_vectors/Concurrency::graphics::uint_4::ba", "amp_short_vectors/Concurrency::graphics::uint_4::set_ywxz", "amp_short_vectors/Concurrency::graphics::uint_4::get_xy", "amp_short_vectors/Concurrency::graphics::uint_4::get_wzx", "amp_short_vectors/Concurrency::graphics::uint_4::bga", "amp_short_vectors/Concurrency::graphics::uint_4::get_x", "amp_short_vectors/Concurrency::graphics::uint_4::get_wyzx", "amp_short_vectors/Concurrency::graphics::uint_4::set_xwy", "amp_short_vectors/Concurrency::graphics::uint_4::set_xzy", "amp_short_vectors/Concurrency::graphics::uint_4::wxzy", "amp_short_vectors/Concurrency::graphics::uint_4::set_wzx", "amp_short_vectors/Concurrency::graphics::uint_4::set_ywz", "amp_short_vectors/Concurrency::graphics::uint_4::set_yx", "amp_short_vectors/Concurrency::graphics::uint_4::get_wyxz", "amp_short_vectors/Concurrency::graphics::uint_4::rga", "amp_short_vectors/Concurrency::graphics::uint_4::set_xw", "amp_short_vectors/Concurrency::graphics::uint_4::get_zwx", "amp_short_vectors/Concurrency::graphics::uint_4::get_w", "amp_short_vectors/Concurrency::graphics::uint_4::get_xw", "amp_short_vectors/Concurrency::graphics::uint_4::get_wxyz", "amp_short_vectors/Concurrency::graphics::uint_4::garb", "amp_short_vectors/Concurrency::graphics::uint_4::y", "amp_short_vectors/Concurrency::graphics::uint_4::get_xz", "amp_short_vectors/Concurrency::graphics::uint_4::yxw", "amp_short_vectors/Concurrency::graphics::uint_4::xzw", "amp_short_vectors/Concurrency::graphics::uint_4::set_xzw", "amp_short_vectors/Concurrency::graphics::uint_4::get_zxwy", "amp_short_vectors/Concurrency::graphics::uint_4::arbg", "amp_short_vectors/Concurrency::graphics::uint_4::ywzx", "amp_short_vectors/Concurrency::graphics::uint_4::zy", "amp_short_vectors/Concurrency::graphics::uint_4::brg", "amp_short_vectors/Concurrency::graphics::uint_4::gar", "amp_short_vectors/Concurrency::graphics::uint_4::get_yzxw", "amp_short_vectors/Concurrency::graphics::uint_4::bgra", "amp_short_vectors/Concurrency::graphics::uint_4::xwyz", "amp_short_vectors/Concurrency::graphics::uint_4::ywz", "amp_short_vectors/Concurrency::graphics::uint_4::yxwz", "amp_short_vectors/Concurrency::graphics::uint_4::set_zxwy", "amp_short_vectors/Concurrency::graphics::uint_4::wz", "amp_short_vectors/Concurrency::graphics::uint_4::set_yzwx", "amp_short_vectors/Concurrency::graphics::uint_4::get_zwy", "amp_short_vectors/Concurrency::graphics::uint_4::abgr", "amp_short_vectors/Concurrency::graphics::uint_4::brag", "amp_short_vectors/Concurrency::graphics::uint_4::set_w", "amp_short_vectors/Concurrency::graphics::uint_4::set_wyz", "amp_short_vectors/Concurrency::graphics::uint_4::gba", "amp_short_vectors/Concurrency::graphics::uint_4::rb", "amp_short_vectors/Concurrency::graphics::uint_4::gbar", "amp_short_vectors/Concurrency::graphics::uint_4::xyz", "amp_short_vectors/Concurrency::graphics::uint_4::yw", "amp_short_vectors/Concurrency::graphics::uint_4::operator-", "amp_short_vectors/Concurrency::graphics::uint_4::get_yw", "amp_short_vectors/Concurrency::graphics::uint_4::wx", "amp_short_vectors/Concurrency::graphics::uint_4::set_wyxz", "amp_short_vectors/Concurrency::graphics::uint_4::xwz", "amp_short_vectors/Concurrency::graphics::uint_4::operator--", "amp_short_vectors/Concurrency::graphics::uint_4::set_xyzw", "amp_short_vectors/Concurrency::graphics::uint_4::xyw", "amp_short_vectors/Concurrency::graphics::uint_4::get_wyz", "amp_short_vectors/Concurrency::graphics::uint_4::rag", "amp_short_vectors/Concurrency::graphics::uint_4::argb", "amp_short_vectors/Concurrency::graphics::uint_4::set_yxz", "amp_short_vectors/Concurrency::graphics::uint_4::set_xywz", "amp_short_vectors/Concurrency::graphics::uint_4::rba", "amp_short_vectors/Concurrency::graphics::uint_4::set_yzx"] -ms.assetid: 1cda9e2c-5970-4ced-ae54-d7ff3c6746f4 ---- -# uint_4 Class - -Represents a short vector of four unsigned integers. - -## Syntax - -```cpp -class uint_4; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[uint_4 Constructor](#uint_4__ctor) |Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|uint_4::get_w|| -|uint_4::get_wx|| -|uint_4::get_wxy|| -|uint_4::get_wxyz|| -|uint_4::get_wxz|| -|uint_4::get_wxzy|| -|uint_4::get_wy|| -|uint_4::get_wyx|| -|uint_4::get_wyxz|| -|uint_4::get_wyz|| -|uint_4::get_wyzx|| -|uint_4::get_wz|| -|uint_4::get_wzx|| -|uint_4::get_wzxy|| -|uint_4::get_wzy|| -|uint_4::get_wzyx|| -|uint_4::get_x|| -|uint_4::get_xw|| -|uint_4::get_xwy|| -|uint_4::get_xwyz|| -|uint_4::get_xwz|| -|uint_4::get_xwzy|| -|uint_4::get_xy|| -|uint_4::get_xyw|| -|uint_4::get_xywz|| -|uint_4::get_xyz|| -|uint_4::get_xyzw|| -|uint_4::get_xz|| -|uint_4::get_xzw|| -|uint_4::get_xzwy|| -|uint_4::get_xzy|| -|uint_4::get_xzyw|| -|uint_4::get_y|| -|uint_4::get_yw|| -|uint_4::get_ywx|| -|uint_4::get_ywxz|| -|uint_4::get_ywz|| -|uint_4::get_ywzx|| -|uint_4::get_yx|| -|uint_4::get_yxw|| -|uint_4::get_yxwz|| -|uint_4::get_yxz|| -|uint_4::get_yxzw|| -|uint_4::get_yz|| -|uint_4::get_yzw|| -|uint_4::get_yzwx|| -|uint_4::get_yzx|| -|uint_4::get_yzxw|| -|uint_4::get_z|| -|uint_4::get_zw|| -|uint_4::get_zwx|| -|uint_4::get_zwxy|| -|uint_4::get_zwy|| -|uint_4::get_zwyx|| -|uint_4::get_zx|| -|uint_4::get_zxw|| -|uint_4::get_zxwy|| -|uint_4::get_zxy|| -|uint_4::get_zxyw|| -|uint_4::get_zy|| -|uint_4::get_zyw|| -|uint_4::get_zywx|| -|uint_4::get_zyx|| -|uint_4::get_zyxw|| -|uint_4::ref_a|| -|uint_4::ref_b|| -|uint_4::ref_g|| -|uint_4::ref_r|| -|uint_4::ref_w|| -|uint_4::ref_x|| -|uint_4::ref_y|| -|uint_4::ref_z|| -|uint_4::set_w|| -|uint_4::set_wx|| -|uint_4::set_wxy|| -|uint_4::set_wxyz|| -|uint_4::set_wxz|| -|uint_4::set_wxzy|| -|uint_4::set_wy|| -|uint_4::set_wyx|| -|uint_4::set_wyxz|| -|uint_4::set_wyz|| -|uint_4::set_wyzx|| -|uint_4::set_wz|| -|uint_4::set_wzx|| -|uint_4::set_wzxy|| -|uint_4::set_wzy|| -|uint_4::set_wzyx|| -|uint_4::set_x|| -|uint_4::set_xw|| -|uint_4::set_xwy|| -|uint_4::set_xwyz|| -|uint_4::set_xwz|| -|uint_4::set_xwzy|| -|uint_4::set_xy|| -|uint_4::set_xyw|| -|uint_4::set_xywz|| -|uint_4::set_xyz|| -|uint_4::set_xyzw|| -|uint_4::set_xz|| -|uint_4::set_xzw|| -|uint_4::set_xzwy|| -|uint_4::set_xzy|| -|uint_4::set_xzyw|| -|uint_4::set_y|| -|uint_4::set_yw|| -|uint_4::set_ywx|| -|uint_4::set_ywxz|| -|uint_4::set_ywz|| -|uint_4::set_ywzx|| -|uint_4::set_yx|| -|uint_4::set_yxw|| -|uint_4::set_yxwz|| -|uint_4::set_yxz|| -|uint_4::set_yxzw|| -|uint_4::set_yz|| -|uint_4::set_yzw|| -|uint_4::set_yzwx|| -|uint_4::set_yzx|| -|uint_4::set_yzxw|| -|uint_4::set_z|| -|uint_4::set_zw|| -|uint_4::set_zwx|| -|uint_4::set_zwxy|| -|uint_4::set_zwy|| -|uint_4::set_zwyx|| -|uint_4::set_zx|| -|uint_4::set_zxw|| -|uint_4::set_zxwy|| -|uint_4::set_zxy|| -|uint_4::set_zxyw|| -|uint_4::set_zy|| -|uint_4::set_zyw|| -|uint_4::set_zywx|| -|uint_4::set_zyx|| -|uint_4::set_zyxw|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|uint_4::operator-|| -|uint_4::operator--|| -|uint_4::operator*=|| -|uint_4::operator/=|| -|uint_4::operator++|| -|uint_4::operator+=|| -|uint_4::operator=|| -|uint_4::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|uint_4::a|| -|uint_4::ab|| -|uint_4::abg|| -|uint_4::abgr|| -|uint_4::abr|| -|uint_4::abrg|| -|uint_4::ag|| -|uint_4::agb|| -|uint_4::agbr|| -|uint_4::agr|| -|uint_4::agrb|| -|uint_4::ar|| -|uint_4::arb|| -|uint_4::arbg|| -|uint_4::arg|| -|uint_4::argb|| -|uint_4::b|| -|uint_4::ba|| -|uint_4::bag|| -|uint_4::bagr|| -|uint_4::bar|| -|uint_4::barg|| -|uint_4::bg|| -|uint_4::bga|| -|uint_4::bgar|| -|uint_4::bgr|| -|uint_4::bgra|| -|uint_4::br|| -|uint_4::bra|| -|uint_4::brag|| -|uint_4::brg|| -|uint_4::brga|| -|uint_4::g|| -|uint_4::ga|| -|uint_4::gab|| -|uint_4::gabr|| -|uint_4::gar|| -|uint_4::garb|| -|uint_4::gb|| -|uint_4::gba|| -|uint_4::gbar|| -|uint_4::gbr|| -|uint_4::gbra|| -|uint_4::gr|| -|uint_4::gra|| -|uint_4::grab|| -|uint_4::grb|| -|uint_4::grba|| -|uint_4::r|| -|uint_4::ra|| -|uint_4::rab|| -|uint_4::rabg|| -|uint_4::rag|| -|uint_4::ragb|| -|uint_4::rb|| -|uint_4::rba|| -|uint_4::rbag|| -|uint_4::rbg|| -|uint_4::rbga|| -|uint_4::rg|| -|uint_4::rga|| -|uint_4::rgab|| -|uint_4::rgb|| -|uint_4::rgba|| -|uint_4::w|| -|uint_4::wx|| -|uint_4::wxy|| -|uint_4::wxyz|| -|uint_4::wxz|| -|uint_4::wxzy|| -|uint_4::wy|| -|uint_4::wyx|| -|uint_4::wyxz|| -|uint_4::wyz|| -|uint_4::wyzx|| -|uint_4::wz|| -|uint_4::wzx|| -|uint_4::wzxy|| -|uint_4::wzy|| -|uint_4::wzyx|| -|uint_4::x|| -|uint_4::xw|| -|uint_4::xwy|| -|uint_4::xwyz|| -|uint_4::xwz|| -|uint_4::xwzy|| -|uint_4::xy|| -|uint_4::xyw|| -|uint_4::xywz|| -|uint_4::xyz|| -|uint_4::xyzw|| -|uint_4::xz|| -|uint_4::xzw|| -|uint_4::xzwy|| -|uint_4::xzy|| -|uint_4::xzyw|| -|uint_4::y|| -|uint_4::yw|| -|uint_4::ywx|| -|uint_4::ywxz|| -|uint_4::ywz|| -|uint_4::ywzx|| -|uint_4::yx|| -|uint_4::yxw|| -|uint_4::yxwz|| -|uint_4::yxz|| -|uint_4::yxzw|| -|uint_4::yz|| -|uint_4::yzw|| -|uint_4::yzwx|| -|uint_4::yzx|| -|uint_4::yzxw|| -|uint_4::z|| -|uint_4::zw|| -|uint_4::zwx|| -|uint_4::zwxy|| -|uint_4::zwy|| -|uint_4::zwyx|| -|uint_4::zx|| -|uint_4::zxw|| -|uint_4::zxwy|| -|uint_4::zxy|| -|uint_4::zxyw|| -|uint_4::zy|| -|uint_4::zyw|| -|uint_4::zywx|| -|uint_4::zyx|| -|uint_4::zyxw|| - -## Inheritance Hierarchy - -`uint_4` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## uint_4 - -Default constructor, initializes all elements with 0. - -### Syntax - -```cpp -uint_4() restrict(amp,cpu); -uint_4( - unsigned int _V0, - unsigned int _V1, - unsigned int _V2, - unsigned int _V3 -) restrict(amp,cpu); -uint_4( - unsigned int _V -) restrict(amp,cpu); -uint_4( - const uint_4& _Other -) restrict(amp,cpu); -explicit inline uint_4( - const int_4& _Other -) restrict(amp,cpu); -explicit inline uint_4( - const float_4& _Other -) restrict(amp,cpu); -explicit inline uint_4( - const unorm_4& _Other -) restrict(amp,cpu); -explicit inline uint_4( - const norm_4& _Other -) restrict(amp,cpu); -explicit inline uint_4( - const double_4& _Other -) restrict(amp,cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V3*
-The value to initialize element 3. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -### Syntax - -```cpp -static const int size = 4; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/uninitialized-object-class.md b/docs/parallel/amp/reference/uninitialized-object-class.md deleted file mode 100644 index bfa77321403..00000000000 --- a/docs/parallel/amp/reference/uninitialized-object-class.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -description: "Learn more about: uninitialized_object Class" -title: "uninitialized_object Class" -ms.date: "03/27/2019" -f1_keywords: ["uninitialized_object", "AMPRT/uninitialized_object", "AMPRT/Concurrency::uninitialized_object"] -helpviewer_keywords: ["uninitialized_object class"] -ms.assetid: 6ae3c4e8-64a6-4511-a158-03be197b63af ---- -# uninitialized_object Class - -The exception that is thrown when an uninitialized object is used. - -## Syntax - -```cpp -class uninitialized_object : public runtime_exception; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[uninitialized_object Constructor](#uninitialized_object)|Initializes a new instance of the `uninitialized_object` class.| - -## Inheritance Hierarchy - -`exception` - -`runtime_exception` - -`uninitialized_object` - -## Requirements - -**Header:** amprt.h - -**Namespace:** Concurrency - -## uninitialized_object - -Constructs a new instance of the `uninitialized_object` exception. - -### Syntax - -```cpp -explicit uninitialized_object( - const char * _Message ) throw(); - -uninitialized_object() throw(); -``` - -### Parameters - -*_Message*
-A description of the error. - -### Return Value - -The `uninitialized_object` exception object. - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/unorm-2-class.md b/docs/parallel/amp/reference/unorm-2-class.md deleted file mode 100644 index 56ca540fa1a..00000000000 --- a/docs/parallel/amp/reference/unorm-2-class.md +++ /dev/null @@ -1,163 +0,0 @@ ---- -description: "Learn more about: unorm_2 Class" -title: "unorm_2 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::unnorm_2::operator+=", "amp_short_vectors/Concurrency::graphics::unnorm_2::y", "amp_short_vectors/Concurrency::graphics::unnorm_2::set_y", "amp_short_vectors/Concurrency::graphics::unnorm_2::x", "amp_short_vectors/Concurrency::graphics::unnorm_2::get_yx", "amp_short_vectors/Concurrency::graphics::unnorm_2::operator--", "amp_short_vectors/Concurrency::graphics::unnorm_2::set_xy", "amp_short_vectors/Concurrency::graphics::unnorm_2::operator*=", "amp_short_vectors/Concurrency::graphics::unnorm_2::xy", "amp_short_vectors/Concurrency::graphics::unnorm_2::get_y", "amp_short_vectors/Concurrency::graphics::unnorm_2::operator=", "amp_short_vectors/Concurrency::graphics::unnorm_2::set_x", "amp_short_vectors/Concurrency::graphics::unnorm_2::rg", "amp_short_vectors/Concurrency::graphics::unorm_2", "amp_short_vectors/Concurrency::graphics::unnorm_2::operator-=", "amp_short_vectors/Concurrency::graphics::unnorm_2::operator/=", "amp_short_vectors/Concurrency::graphics::unnorm_2::get_xy", "amp_short_vectors/Concurrency::graphics::unnorm_2::set_yx", "amp_short_vectors/Concurrency::graphics::unnorm_2::yx", "amp_short_vectors/Concurrency::graphics::unnorm_2::gr", "amp_short_vectors/Concurrency::graphics::unnorm_2::r", "amp_short_vectors/Concurrency::graphics::unnorm_2::operator-", "amp_short_vectors/Concurrency::graphics::unnorm_2::get_x", "amp_short_vectors/Concurrency::graphics::unnorm_2::g", "amp_short_vectors/Concurrency::graphics::unnorm_2::operator++"] -ms.assetid: 62e88ea7-e29f-4f62-95ce-61a1f39f5e34 ---- -# unorm_2 Class - -Represents a short vector of two unsigned normal numbers. - -## Syntax - -```cpp -class unorm_2; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[unorm_2 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|unorm_2::get_x|| -|unorm_2::get_xy|| -|unorm_2::get_y|| -|unorm_2::get_yx|| -|unorm_2::ref_g|| -|unorm_2::ref_r|| -|unorm_2::ref_x|| -|unorm_2::ref_y|| -|unorm_2::set_x|| -|unorm_2::set_xy|| -|unorm_2::set_y|| -|unorm_2::set_yx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|unorm_2::operator--|| -|unorm_2::operator*=|| -|unorm_2::operator/=|| -|unorm_2::operator++|| -|unorm_2::operator+=|| -|unorm_2::operator=|| -|unorm_2::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|unorm_2::size Constant|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|unorm_2::g|| -|unorm_2::gr|| -|unorm_2::r|| -|unorm_2::rg|| -|unorm_2::x|| -|unorm_2::xy|| -|unorm_2::y|| -|unorm_2::yx|| - -## Inheritance Hierarchy - -`unorm_2` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## unorm_2 - -Default constructor, initializes all elements with 0. - -```cpp -unorm_2() restrict(amp, - cpu); - -unorm_2( - unorm _V0, - unorm _V1) restrict(amp, - cpu); - -unorm_2( - float _V0, - float _V1) restrict(amp, - cpu); - -unorm_2( - unorm _V) restrict(amp, - cpu); - -explicit unorm_2( - float _V) restrict(amp, - cpu); - -unorm_2( - const unorm_2& _Other) restrict(amp, - cpu); - -explicit inline unorm_2( - const uint_2& _Other) restrict(amp, - cpu); - -explicit inline unorm_2( - const int_2& _Other) restrict(amp, - cpu); - -explicit inline unorm_2( - const float_2& _Other) restrict(amp, - cpu); - -explicit inline unorm_2( - const norm_2& _Other) restrict(amp, - cpu); - -explicit inline unorm_2( - const double_2& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 2; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/unorm-3-class.md b/docs/parallel/amp/reference/unorm-3-class.md deleted file mode 100644 index d79203d802b..00000000000 --- a/docs/parallel/amp/reference/unorm-3-class.md +++ /dev/null @@ -1,214 +0,0 @@ ---- -description: "Learn more about: unorm_3 Class" -title: "unorm_3 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::unorm_3::set_zy", "amp_short_vectors/Concurrency::graphics::unorm_3::zxy", "amp_short_vectors/Concurrency::graphics::unorm_3::set_zyx", "amp_short_vectors/Concurrency::graphics::unorm_3::operator-=", "amp_short_vectors/Concurrency::graphics::unorm_3::xzy", "amp_short_vectors/Concurrency::graphics::unorm_3::get_xzy", "amp_short_vectors/Concurrency::graphics::unorm_3::zyx", "amp_short_vectors/Concurrency::graphics::unorm_3::rgb", "amp_short_vectors/Concurrency::graphics::unorm_3::set_xz", "amp_short_vectors/Concurrency::graphics::unorm_3::set_yxz", "amp_short_vectors/Concurrency::graphics::unorm_3::set_yx", "amp_short_vectors/Concurrency::graphics::unorm_3::br", "amp_short_vectors/Concurrency::graphics::unorm_3::get_zy", "amp_short_vectors/Concurrency::graphics::unorm_3::set_zx", "amp_short_vectors/Concurrency::graphics::unorm_3::get_xyz", "amp_short_vectors/Concurrency::graphics::unorm_3::b", "amp_short_vectors/Concurrency::graphics::unorm_3::set_xyz", "amp_short_vectors/Concurrency::graphics::unorm_3", "amp_short_vectors/Concurrency::graphics::unorm_3::set_z", "amp_short_vectors/Concurrency::graphics::unorm_3::set_xy", "amp_short_vectors/Concurrency::graphics::unorm_3::get_zyx", "amp_short_vectors/Concurrency::graphics::unorm_3::get_xy", "amp_short_vectors/Concurrency::graphics::unorm_3::x", "amp_short_vectors/Concurrency::graphics::unorm_3::get_zxy", "amp_short_vectors/Concurrency::graphics::unorm_3::z", "amp_short_vectors/Concurrency::graphics::unorm_3::get_x", "amp_short_vectors/Concurrency::graphics::unorm_3::operator=", "amp_short_vectors/Concurrency::graphics::unorm_3::yxz", "amp_short_vectors/Concurrency::graphics::unorm_3::get_yx", "amp_short_vectors/Concurrency::graphics::unorm_3::gbr", "amp_short_vectors/Concurrency::graphics::unorm_3::get_yxz", "amp_short_vectors/Concurrency::graphics::unorm_3::operator--", "amp_short_vectors/Concurrency::graphics::unorm_3::operator/=", "amp_short_vectors/Concurrency::graphics::unorm_3::brg", "amp_short_vectors/Concurrency::graphics::unorm_3::gb", "amp_short_vectors/Concurrency::graphics::unorm_3::zy", "amp_short_vectors/Concurrency::graphics::unorm_3::set_xzy", "amp_short_vectors/Concurrency::graphics::unorm_3::get_yzx", "amp_short_vectors/Concurrency::graphics::unorm_3::rb", "amp_short_vectors/Concurrency::graphics::unorm_3::gr", "amp_short_vectors/Concurrency::graphics::unorm_3::zx", "amp_short_vectors/Concurrency::graphics::unorm_3::r", "amp_short_vectors/Concurrency::graphics::unorm_3::xyz", "amp_short_vectors/Concurrency::graphics::unorm_3::grb", "amp_short_vectors/Concurrency::graphics::unorm_3::bg", "amp_short_vectors/Concurrency::graphics::unorm_3::get_y", "amp_short_vectors/Concurrency::graphics::unorm_3::g", "amp_short_vectors/Concurrency::graphics::unorm_3::yz", "amp_short_vectors/Concurrency::graphics::unorm_3::yx", "amp_short_vectors/Concurrency::graphics::unorm_3::get_xz", "amp_short_vectors/Concurrency::graphics::unorm_3::set_zxy", "amp_short_vectors/Concurrency::graphics::unorm_3::get_z", "amp_short_vectors/Concurrency::graphics::unorm_3::bgr", "amp_short_vectors/Concurrency::graphics::unorm_3::set_x", "amp_short_vectors/Concurrency::graphics::unorm_3::operator-", "amp_short_vectors/Concurrency::graphics::unorm_3::y", "amp_short_vectors/Concurrency::graphics::unorm_3::set_yzx", "amp_short_vectors/Concurrency::graphics::unorm_3::get_zx", "amp_short_vectors/Concurrency::graphics::unorm_3::yzx", "amp_short_vectors/Concurrency::graphics::unorm_3::operator++", "amp_short_vectors/Concurrency::graphics::unorm_3::set_yz", "amp_short_vectors/Concurrency::graphics::unorm_3::operator+=", "amp_short_vectors/Concurrency::graphics::unorm_3::xz", "amp_short_vectors/Concurrency::graphics::unorm_3::rg", "amp_short_vectors/Concurrency::graphics::unorm_3::xy", "amp_short_vectors/Concurrency::graphics::unorm_3::operator*=", "amp_short_vectors/Concurrency::graphics::unorm_3::set_y", "amp_short_vectors/Concurrency::graphics::unorm_3::get_yz", "amp_short_vectors/Concurrency::graphics::unorm_3::rbg"] -ms.assetid: ea4e7a17-5256-464c-af28-8b01962564c0 ---- -# unorm_3 Class - -Represents a short vector of three unsigned normal numbers. - -## Syntax - -```cpp -class unorm_3; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[unorm_3 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|unorm_3::get_x|| -|unorm_3::get_xy|| -|unorm_3::get_xyz|| -|unorm_3::get_xz|| -|unorm_3::get_xzy|| -|unorm_3::get_y|| -|unorm_3::get_yx|| -|unorm_3::get_yxz|| -|unorm_3::get_yz|| -|unorm_3::get_yzx|| -|unorm_3::get_z|| -|unorm_3::get_zx|| -|unorm_3::get_zxy|| -|unorm_3::get_zy|| -|unorm_3::get_zyx|| -|Unorm_3::ref_b|| -|Unorm_3::ref_g|| -|Unorm_3::ref_r|| -|Unorm_3::ref_x|| -|Unorm_3::ref_y|| -|Unorm_3::ref_z|| -|unorm_3::set_x|| -|unorm_3::set_xy|| -|unorm_3::set_xyz|| -|unorm_3::set_xz|| -|unorm_3::set_xzy|| -|unorm_3::set_y|| -|unorm_3::set_yx|| -|unorm_3::set_yxz|| -|unorm_3::set_yz|| -|unorm_3::set_yzx|| -|unorm_3::set_z|| -|unorm_3::set_zx|| -|unorm_3::set_zxy|| -|unorm_3::set_zy|| -|unorm_3::set_zyx|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|unorm_3::operator--|| -|unorm_3::operator*=|| -|unorm_3::operator/=|| -|unorm_3::operator++|| -|unorm_3::operator+=|| -|unorm_3::operator=|| -|unorm_3::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#unorm_3__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|unorm_3::b|| -|unorm_3::bg|| -|unorm_3::bgr|| -|unorm_3::br|| -|unorm_3::brg|| -|unorm_3::g|| -|unorm_3::gb|| -|unorm_3::gbr|| -|unorm_3::gr|| -|unorm_3::grb|| -|unorm_3::r|| -|unorm_3::rb|| -|unorm_3::rbg|| -|unorm_3::rg|| -|unorm_3::rgb|| -|unorm_3::x|| -|unorm_3::xy|| -|unorm_3::xyz|| -|unorm_3::xz|| -|unorm_3::xzy|| -|unorm_3::y|| -|unorm_3::yx|| -|unorm_3::yxz|| -|unorm_3::yz|| -|unorm_3::yzx|| -|unorm_3::z|| -|unorm_3::zx|| -|unorm_3::zxy|| -|unorm_3::zy|| -|unorm_3::zyx|| - -## Inheritance Hierarchy - -`unorm_3` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## unorm_3 - -Default constructor, initializes all elements with 0. - -```cpp -unorm_3() restrict(amp, - cpu); - -unorm_3( - unorm _V0, - unorm _V1, - unorm _V2) restrict(amp, - cpu); - -unorm_3( - float _V0, - float _V1, - float _V2) restrict(amp, - cpu); - -unorm_3( - unorm _V) restrict(amp, - cpu); - -explicit unorm_3( - float _V) restrict(amp, - cpu); - -unorm_3( - const unorm_3& _Other) restrict(amp, - cpu); - -explicit inline unorm_3( - const uint_3& _Other) restrict(amp, - cpu); - -explicit inline unorm_3( - const int_3& _Other) restrict(amp, - cpu); - -explicit inline unorm_3( - const float_3& _Other) restrict(amp, - cpu); - -explicit inline unorm_3( - const norm_3& _Other) restrict(amp, - cpu); - -explicit inline unorm_3( - const double_3& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 3; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/unorm-4-class.md b/docs/parallel/amp/reference/unorm-4-class.md deleted file mode 100644 index 1726971da23..00000000000 --- a/docs/parallel/amp/reference/unorm-4-class.md +++ /dev/null @@ -1,418 +0,0 @@ ---- -description: "Learn more about: unorm_4 Class" -title: "unorm_4 Class" -ms.date: "11/04/2016" -f1_keywords: ["amp_short_vectors/Concurrency::graphics::unorm_4::set_yxzw", "amp_short_vectors/Concurrency::graphics::unorm_4::gbra", "amp_short_vectors/Concurrency::graphics::unorm_4::abg", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zx", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xzyw", "amp_short_vectors/Concurrency::graphics::unorm_4::brag", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zywx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xwy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_x", "amp_short_vectors/Concurrency::graphics::unorm_4::ra", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xyw", "amp_short_vectors/Concurrency::graphics::unorm_4::rg", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yxwz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xw", "amp_short_vectors/Concurrency::graphics::unorm_4::get_z", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wxyz", "amp_short_vectors/Concurrency::graphics::unorm_4::operator*=", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zyw", "amp_short_vectors/Concurrency::graphics::unorm_4::b", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wyzx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wyz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wyzx", "amp_short_vectors/Concurrency::graphics::unorm_4::ywx", "amp_short_vectors/Concurrency::graphics::unorm_4::ragb", "amp_short_vectors/Concurrency::graphics::unorm_4::yxzw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wzy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_y", "amp_short_vectors/Concurrency::graphics::unorm_4::rag", "amp_short_vectors/Concurrency::graphics::unorm_4::zwxy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wyxz", "amp_short_vectors/Concurrency::graphics::unorm_4::gab", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yzw", "amp_short_vectors/Concurrency::graphics::unorm_4::rgb", "amp_short_vectors/Concurrency::graphics::unorm_4::arbg", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wyx", "amp_short_vectors/Concurrency::graphics::unorm_4::y", "amp_short_vectors/Concurrency::graphics::unorm_4::wz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yxwz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xw", "amp_short_vectors/Concurrency::graphics::unorm_4::bgra", "amp_short_vectors/Concurrency::graphics::unorm_4::grb", "amp_short_vectors/Concurrency::graphics::unorm_4::wzx", "amp_short_vectors/Concurrency::graphics::unorm_4::set_ywzx", "amp_short_vectors/Concurrency::graphics::unorm_4::yz", "amp_short_vectors/Concurrency::graphics::unorm_4::xywz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xzwy", "amp_short_vectors/Concurrency::graphics::unorm_4::rba", "amp_short_vectors/Concurrency::graphics::unorm_4::set_ywx", "amp_short_vectors/Concurrency::graphics::unorm_4::wzy", "amp_short_vectors/Concurrency::graphics::unorm_4::bg", "amp_short_vectors/Concurrency::graphics::unorm_4::agb", "amp_short_vectors/Concurrency::graphics::unorm_4::get_w", "amp_short_vectors/Concurrency::graphics::unorm_4::bag", "amp_short_vectors/Concurrency::graphics::unorm_4::bga", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wx", "amp_short_vectors/Concurrency::graphics::unorm_4::arb", "amp_short_vectors/Concurrency::graphics::unorm_4::get_ywz", "amp_short_vectors/Concurrency::graphics::unorm_4::a", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zxyw", "amp_short_vectors/Concurrency::graphics::unorm_4::operator/=", "amp_short_vectors/Concurrency::graphics::unorm_4::w", "amp_short_vectors/Concurrency::graphics::unorm_4::operator++", "amp_short_vectors/Concurrency::graphics::unorm_4::wyxz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yzx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zyx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xywz", "amp_short_vectors/Concurrency::graphics::unorm_4::xyzw", "amp_short_vectors/Concurrency::graphics::unorm_4::rbag", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wxy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xwzy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wxzy", "amp_short_vectors/Concurrency::graphics::unorm_4::gabr", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xyzw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xyz", "amp_short_vectors/Concurrency::graphics::unorm_4::br", "amp_short_vectors/Concurrency::graphics::unorm_4::yw", "amp_short_vectors/Concurrency::graphics::unorm_4::zxyw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wxzy", "amp_short_vectors/Concurrency::graphics::unorm_4::argb", "amp_short_vectors/Concurrency::graphics::unorm_4::x", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wzxy", "amp_short_vectors/Concurrency::graphics::unorm_4::ab", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yzwx", "amp_short_vectors/Concurrency::graphics::unorm_4::xyz", "amp_short_vectors/Concurrency::graphics::unorm_4::gbr", "amp_short_vectors/Concurrency::graphics::unorm_4::rab", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xy", "amp_short_vectors/Concurrency::graphics::unorm_4::operator--", "amp_short_vectors/Concurrency::graphics::unorm_4::gba", "amp_short_vectors/Concurrency::graphics::unorm_4::bra", "amp_short_vectors/Concurrency::graphics::unorm_4::garb", "amp_short_vectors/Concurrency::graphics::unorm_4::zwyx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_ywx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_ywzx", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xwy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_ywxz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zxwy", "amp_short_vectors/Concurrency::graphics::unorm_4::agr", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wzx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zxyw", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yxz", "amp_short_vectors/Concurrency::graphics::unorm_4::zxy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zxw", "amp_short_vectors/Concurrency::graphics::unorm_4::ga", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zyw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wxyz", "amp_short_vectors/Concurrency::graphics::unorm_4::wxy", "amp_short_vectors/Concurrency::graphics::unorm_4::wzxy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zwy", "amp_short_vectors/Concurrency::graphics::unorm_4::xwz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wzx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xzwy", "amp_short_vectors/Concurrency::graphics::unorm_4::ywxz", "amp_short_vectors/Concurrency::graphics::unorm_4::yx", "amp_short_vectors/Concurrency::graphics::unorm_4::xzy", "amp_short_vectors/Concurrency::graphics::unorm_4::zy", "amp_short_vectors/Concurrency::graphics::unorm_4::bgar", "amp_short_vectors/Concurrency::graphics::unorm_4::set_y", "amp_short_vectors/Concurrency::graphics::unorm_4::xw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xwyz", "amp_short_vectors/Concurrency::graphics::unorm_4::xzyw", "amp_short_vectors/Concurrency::graphics::unorm_4::ar", "amp_short_vectors/Concurrency::graphics::unorm_4::rgba", "amp_short_vectors/Concurrency::graphics::unorm_4::gra", "amp_short_vectors/Concurrency::graphics::unorm_4::ba", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zyx", "amp_short_vectors/Concurrency::graphics::unorm_4::operator=", "amp_short_vectors/Concurrency::graphics::unorm_4::set_x", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xzw", "amp_short_vectors/Concurrency::graphics::unorm_4::rga", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_z", "amp_short_vectors/Concurrency::graphics::unorm_4::yzx", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yzx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zwx", "amp_short_vectors/Concurrency::graphics::unorm_4::xwzy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zwxy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yxz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xzy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xwyz", "amp_short_vectors/Concurrency::graphics::unorm_4::yzwx", "amp_short_vectors/Concurrency::graphics::unorm_4::bagr", "amp_short_vectors/Concurrency::graphics::unorm_4::yxwz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xyz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zyxw", "amp_short_vectors/Concurrency::graphics::unorm_4::bar", "amp_short_vectors/Concurrency::graphics::unorm_4::zyw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wxz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zxy", "amp_short_vectors/Concurrency::graphics::unorm_4::yzw", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wyxz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zwyx", "amp_short_vectors/Concurrency::graphics::unorm_4::wyzx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zwy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wx", "amp_short_vectors/Concurrency::graphics::unorm_4::zyxw", "amp_short_vectors/Concurrency::graphics::unorm_4::rbga", "amp_short_vectors/Concurrency::graphics::unorm_4::rabg", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zwxy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zxy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xwz", "amp_short_vectors/Concurrency::graphics::unorm_4::abr", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zwyx", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yzxw", "amp_short_vectors/Concurrency::graphics::unorm_4::zywx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yzwx", "amp_short_vectors/Concurrency::graphics::unorm_4::zyx", "amp_short_vectors/Concurrency::graphics::unorm_4::g", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xwz", "amp_short_vectors/Concurrency::graphics::unorm_4::zwy", "amp_short_vectors/Concurrency::graphics::unorm_4::gbar", "amp_short_vectors/Concurrency::graphics::unorm_4::zx", "amp_short_vectors/Concurrency::graphics::unorm_4::xzwy", "amp_short_vectors/Concurrency::graphics::unorm_4::bgr", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xwzy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yx", "amp_short_vectors/Concurrency::graphics::unorm_4::set_w", "amp_short_vectors/Concurrency::graphics::unorm_4::set_yxw", "amp_short_vectors/Concurrency::graphics::unorm_4::wxzy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zywx", "amp_short_vectors/Concurrency::graphics::unorm_4::agrb", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zxwy", "amp_short_vectors/Concurrency::graphics::unorm_4::zxw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xywz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yzw", "amp_short_vectors/Concurrency::graphics::unorm_4::ywzx", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wxy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yxzw", "amp_short_vectors/Concurrency::graphics::unorm_4::rgab", "amp_short_vectors/Concurrency::graphics::unorm_4::yxz", "amp_short_vectors/Concurrency::graphics::unorm_4::rbg", "amp_short_vectors/Concurrency::graphics::unorm_4::set_ywz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yzxw", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wy", "amp_short_vectors/Concurrency::graphics::unorm_4::zxwy", "amp_short_vectors/Concurrency::graphics::unorm_4::gr", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xzyw", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wzy", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xzw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zwx", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zy", "amp_short_vectors/Concurrency::graphics::unorm_4::zw", "amp_short_vectors/Concurrency::graphics::unorm_4::xz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zyxw", "amp_short_vectors/Concurrency::graphics::unorm_4::agbr", "amp_short_vectors/Concurrency::graphics::unorm_4::gb", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yxw", "amp_short_vectors/Concurrency::graphics::unorm_4::get_yz", "amp_short_vectors/Concurrency::graphics::unorm_4::operator+=", "amp_short_vectors/Concurrency::graphics::unorm_4::ag", "amp_short_vectors/Concurrency::graphics::unorm_4::grab", "amp_short_vectors/Concurrency::graphics::unorm_4::barg", "amp_short_vectors/Concurrency::graphics::unorm_4::r", "amp_short_vectors/Concurrency::graphics::unorm_4::wx", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wyx", "amp_short_vectors/Concurrency::graphics::unorm_4::abgr", "amp_short_vectors/Concurrency::graphics::unorm_4::yxw", "amp_short_vectors/Concurrency::graphics::unorm_4::z", "amp_short_vectors/Concurrency::graphics::unorm_4::grba", "amp_short_vectors/Concurrency::graphics::unorm_4::operator-=", "amp_short_vectors/Concurrency::graphics::unorm_4::gar", "amp_short_vectors/Concurrency::graphics::unorm_4::operator-", "amp_short_vectors/Concurrency::graphics::unorm_4::xyw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xyw", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wzxy", "amp_short_vectors/Concurrency::graphics::unorm_4::brg", "amp_short_vectors/Concurrency::graphics::unorm_4::wy", "amp_short_vectors/Concurrency::graphics::unorm_4::wxz", "amp_short_vectors/Concurrency::graphics::unorm_4::wxyz", "amp_short_vectors/Concurrency::graphics::unorm_4::wyz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wxz", "amp_short_vectors/Concurrency::graphics::unorm_4::get_xyzw", "amp_short_vectors/Concurrency::graphics::unorm_4::xzw", "amp_short_vectors/Concurrency::graphics::unorm_4::xwyz", "amp_short_vectors/Concurrency::graphics::unorm_4::zwx", "amp_short_vectors/Concurrency::graphics::unorm_4::xy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_zx", "amp_short_vectors/Concurrency::graphics::unorm_4::brga", "amp_short_vectors/Concurrency::graphics::unorm_4::get_zxw", "amp_short_vectors/Concurrency::graphics::unorm_4", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wzyx", "amp_short_vectors/Concurrency::graphics::unorm_4::wzyx", "amp_short_vectors/Concurrency::graphics::unorm_4::yzxw", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wz", "amp_short_vectors/Concurrency::graphics::unorm_4::xwy", "amp_short_vectors/Concurrency::graphics::unorm_4::set_ywxz", "amp_short_vectors/Concurrency::graphics::unorm_4::set_xzy", "amp_short_vectors/Concurrency::graphics::unorm_4::arg", "amp_short_vectors/Concurrency::graphics::unorm_4::set_wyz", "amp_short_vectors/Concurrency::graphics::unorm_4::ywz", "amp_short_vectors/Concurrency::graphics::unorm_4::abrg", "amp_short_vectors/Concurrency::graphics::unorm_4::wyx", "amp_short_vectors/Concurrency::graphics::unorm_4::rb", "amp_short_vectors/Concurrency::graphics::unorm_4::get_wzyx"] -ms.assetid: dd216a9d-95f7-4978-8e78-6cb9c781a7e9 ---- -# unorm_4 Class - -Represents a short vector of four unsigned normal numbers. - -## Syntax - -```cpp -class unorm_4; -``` - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`value_type`|| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[unorm_4 Constructor](#ctor)|Overloaded. Default constructor, initializes all elements with 0.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|unorm_4::get_w|| -|unorm_4::get_wx|| -|unorm_4::get_wxy|| -|unorm_4::get_wxyz|| -|unorm_4::get_wxz|| -|unorm_4::get_wxzy|| -|unorm_4::get_wy|| -|unorm_4::get_wyx|| -|unorm_4::get_wyxz|| -|unorm_4::get_wyz|| -|unorm_4::get_wyzx|| -|unorm_4::get_wz|| -|unorm_4::get_wzx|| -|unorm_4::get_wzxy|| -|unorm_4::get_wzy|| -|unorm_4::get_wzyx|| -|unorm_4::get_x|| -|unorm_4::get_xw|| -|unorm_4::get_xwy|| -|unorm_4::get_xwyz|| -|unorm_4::get_xwz|| -|unorm_4::get_xwzy|| -|unorm_4::get_xy|| -|unorm_4::get_xyw|| -|unorm_4::get_xywz|| -|unorm_4::get_xyz|| -|unorm_4::get_xyzw|| -|unorm_4::get_xz|| -|unorm_4::get_xzw|| -|unorm_4::get_xzwy|| -|unorm_4::get_xzy|| -|unorm_4::get_xzyw|| -|unorm_4::get_y|| -|unorm_4::get_yw|| -|unorm_4::get_ywx|| -|unorm_4::get_ywxz|| -|unorm_4::get_ywz|| -|unorm_4::get_ywzx|| -|unorm_4::get_yx|| -|unorm_4::get_yxw|| -|unorm_4::get_yxwz|| -|unorm_4::get_yxz|| -|unorm_4::get_yxzw|| -|unorm_4::get_yz|| -|unorm_4::get_yzw|| -|unorm_4::get_yzwx|| -|unorm_4::get_yzx|| -|unorm_4::get_yzxw|| -|unorm_4::get_z|| -|unorm_4::get_zw|| -|unorm_4::get_zwx|| -|unorm_4::get_zwxy|| -|unorm_4::get_zwy|| -|unorm_4::get_zwyx|| -|unorm_4::get_zx|| -|unorm_4::get_zxw|| -|unorm_4::get_zxwy|| -|unorm_4::get_zxy|| -|unorm_4::get_zxyw|| -|unorm_4::get_zy|| -|unorm_4::get_zyw|| -|unorm_4::get_zywx|| -|unorm_4::get_zyx|| -|unorm_4::get_zyxw|| -|unorm_4::ref_a|| -|unorm_4::ref_b|| -|unorm_4::ref_g|| -|unorm_4::ref_r|| -|unorm_4::ref_w|| -|unorm_4::ref_x|| -|unorm_4::ref_y|| -|unorm_4::ref_z|| -|unorm_4::set_w|| -|unorm_4::set_wx|| -|unorm_4::set_wxy|| -|unorm_4::set_wxyz|| -|unorm_4::set_wxz|| -|unorm_4::set_wxzy|| -|unorm_4::set_wy|| -|unorm_4::set_wyx|| -|unorm_4::set_wyxz|| -|unorm_4::set_wyz|| -|unorm_4::set_wyzx|| -|unorm_4::set_wz|| -|unorm_4::set_wzx|| -|unorm_4::set_wzxy|| -|unorm_4::set_wzy|| -|unorm_4::set_wzyx|| -|unorm_4::set_x|| -|unorm_4::set_xw|| -|unorm_4::set_xwy|| -|unorm_4::set_xwyz|| -|unorm_4::set_xwz|| -|unorm_4::set_xwzy|| -|unorm_4::set_xy|| -|unorm_4::set_xyw|| -|unorm_4::set_xywz|| -|unorm_4::set_xyz|| -|unorm_4::set_xyzw|| -|unorm_4::set_xz|| -|unorm_4::set_xzw|| -|unorm_4::set_xzwy|| -|unorm_4::set_xzy|| -|unorm_4::set_xzyw|| -|unorm_4::set_y|| -|unorm_4::set_yw|| -|unorm_4::set_ywx|| -|unorm_4::set_ywxz|| -|unorm_4::set_ywz|| -|unorm_4::set_ywzx|| -|unorm_4::set_yx|| -|unorm_4::set_yxw|| -|unorm_4::set_yxwz|| -|unorm_4::set_yxz|| -|unorm_4::set_yxzw|| -|unorm_4::set_yz|| -|unorm_4::set_yzw|| -|unorm_4::set_yzwx|| -|unorm_4::set_yzx|| -|unorm_4::set_yzxw|| -|unorm_4::set_z|| -|unorm_4::set_zw|| -|unorm_4::set_zwx|| -|unorm_4::set_zwxy|| -|unorm_4::set_zwy|| -|unorm_4::set_zwyx|| -|unorm_4::set_zx|| -|unorm_4::set_zxw|| -|unorm_4::set_zxwy|| -|unorm_4::set_zxy|| -|unorm_4::set_zxyw|| -|unorm_4::set_zy|| -|unorm_4::set_zyw|| -|unorm_4::set_zywx|| -|unorm_4::set_zyx|| -|unorm_4::set_zyxw|| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|unorm_4::operator-|| -|unorm_4::operator--|| -|unorm_4::operator*=|| -|unorm_4::operator/=|| -|unorm_4::operator++|| -|unorm_4::operator+=|| -|unorm_4::operator=|| -|unorm_4::operator-=|| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[size Constant](#unorm_4__size)|| - -### Public Data Members - -|Name|Description| -|----------|-----------------| -|unorm_4::a|| -|unorm_4::ab|| -|unorm_4::abg|| -|unorm_4::abgr|| -|unorm_4::abr|| -|unorm_4::abrg|| -|unorm_4::ag|| -|unorm_4::agb|| -|unorm_4::agbr|| -|unorm_4::agr|| -|unorm_4::agrb|| -|unorm_4::ar|| -|unorm_4::arb|| -|unorm_4::arbg|| -|unorm_4::arg|| -|unorm_4::argb|| -|unorm_4::b|| -|unorm_4::ba|| -|unorm_4::bag|| -|unorm_4::bagr|| -|unorm_4::bar|| -|unorm_4::barg|| -|unorm_4::bg|| -|unorm_4::bga|| -|unorm_4::bgar|| -|unorm_4::bgr|| -|unorm_4::bgra|| -|unorm_4::br|| -|unorm_4::bra|| -|unorm_4::brag|| -|unorm_4::brg|| -|unorm_4::brga|| -|unorm_4::g|| -|unorm_4::ga|| -|unorm_4::gab|| -|unorm_4::gabr|| -|unorm_4::gar|| -|unorm_4::garb|| -|unorm_4::gb|| -|unorm_4::gba|| -|unorm_4::gbar|| -|unorm_4::gbr|| -|unorm_4::gbra|| -|unorm_4::gr|| -|unorm_4::gra|| -|unorm_4::grab|| -|unorm_4::grb|| -|unorm_4::grba|| -|unorm_4::r|| -|unorm_4::ra|| -|unorm_4::rab|| -|unorm_4::rabg|| -|unorm_4::rag|| -|unorm_4::ragb|| -|unorm_4::rb|| -|unorm_4::rba|| -|unorm_4::rbag|| -|unorm_4::rbg|| -|unorm_4::rbga|| -|unorm_4::rg|| -|unorm_4::rga|| -|unorm_4::rgab|| -|unorm_4::rgb|| -|unorm_4::rgba|| -|unorm_4::w|| -|unorm_4::wx|| -|unorm_4::wxy|| -|unorm_4::wxyz|| -|unorm_4::wxz|| -|unorm_4::wxzy|| -|unorm_4::wy|| -|unorm_4::wyx|| -|unorm_4::wyxz|| -|unorm_4::wyz|| -|unorm_4::wyzx|| -|unorm_4::wz|| -|unorm_4::wzx|| -|unorm_4::wzxy|| -|unorm_4::wzy|| -|unorm_4::wzyx|| -|unorm_4::x|| -|unorm_4::xw|| -|unorm_4::xwy|| -|unorm_4::xwyz|| -|unorm_4::xwz|| -|unorm_4::xwzy|| -|unorm_4::xy|| -|unorm_4::xyw|| -|unorm_4::xywz|| -|unorm_4::xyz|| -|unorm_4::xyzw|| -|unorm_4::xz|| -|unorm_4::xzw|| -|unorm_4::xzwy|| -|unorm_4::xzy|| -|unorm_4::xzyw|| -|unorm_4::y|| -|unorm_4::yw|| -|unorm_4::ywx|| -|unorm_4::ywxz|| -|unorm_4::ywz|| -|unorm_4::ywzx|| -|unorm_4::yx|| -|unorm_4::yxw|| -|unorm_4::yxwz|| -|unorm_4::yxz|| -|unorm_4::yxzw|| -|unorm_4::yz|| -|unorm_4::yzw|| -|unorm_4::yzwx|| -|unorm_4::yzx|| -|unorm_4::yzxw|| -|unorm_4::z|| -|unorm_4::zw|| -|unorm_4::zwx|| -|unorm_4::zwxy|| -|unorm_4::zwy|| -|unorm_4::zwyx|| -|unorm_4::zx|| -|unorm_4::zxw|| -|unorm_4::zxwy|| -|unorm_4::zxy|| -|unorm_4::zxyw|| -|unorm_4::zy|| -|unorm_4::zyw|| -|unorm_4::zywx|| -|unorm_4::zyx|| -|unorm_4::zyxw|| - -## Inheritance Hierarchy - -`unorm_4` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## unorm_4 - -Default constructor, initializes all elements with 0. - -```cpp -unorm_4() restrict(amp, - cpu); - -unorm_4( - unorm _V0, - unorm _V1, - unorm _V2, - unorm _V3) restrict(amp, - cpu); - -unorm_4( - float _V0, - float _V1, - float _V2, - float _V3) restrict(amp, - cpu); - -unorm_4( - unorm _V) restrict(amp, - cpu); - -explicit unorm_4( - float _V) restrict(amp, - cpu); - -unorm_4( - const unorm_4& _Other) restrict(amp, - cpu); - -explicit inline unorm_4( - const uint_4& _Other) restrict(amp, - cpu); - -explicit inline unorm_4( - const int_4& _Other) restrict(amp, - cpu); - -explicit inline unorm_4( - const float_4& _Other) restrict(amp, - cpu); - -explicit inline unorm_4( - const norm_4& _Other) restrict(amp, - cpu); - -explicit inline unorm_4( - const double_4& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V0*
-The value to initialize element 0. - -*_V1*
-The value to initialize element 1. - -*_V2*
-The value to initialize element 2. - -*_V3*
-The value to initialize element 3. - -*_V*
-The value for initialization. - -*_Other*
-The object used to initialize. - -## size - -```cpp -static const int size = 4; -``` - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/unorm-class.md b/docs/parallel/amp/reference/unorm-class.md deleted file mode 100644 index a59ea39f7c5..00000000000 --- a/docs/parallel/amp/reference/unorm-class.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -description: "Learn more about: unorm Class" -title: "unorm Class" -ms.date: "11/04/2016" -f1_keywords: ["unorm", "AMP_SHORT_VECTORS/unorm", "AMP_SHORT_VECTORS/Concurrency::graphics::unorm Constructor"] -ms.assetid: bc30bd20-6452-4d5f-9158-3b11c4c16ed2 ---- -# unorm Class - -Represent a unorm number. Each element is a floating point number in the range of [0.0f, 1.0f]. - -## Syntax - -```cpp -class unorm; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[unorm Constructor](#ctor)|Overloaded. Default constructor. Initialize to 0.0f.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|unorm::operator--|| -|unorm::operator float|Conversion operator. Convert the unorm number to a floating point value.| -|unorm::operator*=|| -|unorm::operator/=|| -|unorm::operator++|| -|unorm::operator+=|| -|unorm::operator=|| -|unorm::operator-=|| - -## Inheritance Hierarchy - -`unorm` - -## Requirements - -**Header:** amp_short_vectors.h - -**Namespace:** Concurrency::graphics - -## unorm - -Default constructor. Initialize to 0.0f. - -```cpp -unorm( - void) restrict(amp, - cpu); - -explicit unorm( - float _V) restrict(amp, - cpu); - -explicit unorm( - unsigned int _V) restrict(amp, - cpu); - -explicit unorm( - int _V) restrict(amp, - cpu); - -explicit unorm( - double _V) restrict(amp, - cpu); - -unorm( - const unorm& _Other) restrict(amp, - cpu); - -inline explicit unorm( - const norm& _Other) restrict(amp, - cpu); -``` - -### Parameters - -*_V*
-The value used to initialize. - -*_Other*
-The norm object used to initialize. - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/reference/unsupported-feature-class.md b/docs/parallel/amp/reference/unsupported-feature-class.md deleted file mode 100644 index 637c3551bbd..00000000000 --- a/docs/parallel/amp/reference/unsupported-feature-class.md +++ /dev/null @@ -1,65 +0,0 @@ ---- -description: "Learn more about: unsupported_feature Class" -title: "unsupported_feature Class" -ms.date: "03/27/2019" -f1_keywords: ["unsupported_feature", "AMPRT/unsupported_feature", "AMPRT/Concurrency::unsupported_feature"] -helpviewer_keywords: ["unsupported_feature class"] -ms.assetid: 6b1ab917-df13-48c7-9648-7cb2465a0ff5 ---- -# unsupported_feature Class - -The exception that is thrown when an unsupported feature is used. - -## Syntax - -```cpp -class unsupported_feature : public runtime_exception; -``` - -## Members - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[unsupported_feature Constructor](#unsupported_feature)|Constructs a new instance of the `unsupported_feature` exception.| - -## Inheritance Hierarchy - -`exception` - -`runtime_exception` - -`unsupported_feature` - -## unsupported_feature - - Constructs a new instance of the `unsupported_feature` exception. - -### Syntax - -```cpp -explicit unsupported_feature( - const char * _Message ) throw(); - -unsupported_feature() throw(); -``` - -### Parameters - -*_Message*
-A description of the error. - -### Return Value - -The `unsupported_feature` object. - -## Requirements - -**Header:** amprt.h - -**Namespace:** Concurrency - -## See also - -[Concurrency Namespace (C++ AMP)](concurrency-namespace-cpp-amp.md) diff --git a/docs/parallel/amp/reference/writeonly-texture-view-class.md b/docs/parallel/amp/reference/writeonly-texture-view-class.md deleted file mode 100644 index cedd6714dc1..00000000000 --- a/docs/parallel/amp/reference/writeonly-texture-view-class.md +++ /dev/null @@ -1,161 +0,0 @@ ---- -description: "Learn more about: writeonly_texture_view Class" -title: "writeonly_texture_view Class" -ms.date: "11/04/2016" -f1_keywords: ["writeonly_texture_view", "AMP_GRAPHICS/writeonly_texture_view", "AMP_GRAPHICS/Concurrency::graphics::writeonly_texture_view", "AMP_GRAPHICS/Concurrency::graphics::writeonly_texture_view::set", "AMP_GRAPHICS/Concurrency::graphics::rank Constant"] -ms.assetid: 8d117ad3-0a1c-41ae-b29c-7c95fdd4d04d ---- -# writeonly_texture_view Class - -Provides writeonly access to a texture. - -## Syntax - -```cpp -template < - typename value_type, - int _Rank -> -class writeonly_texture_view; - -template < - typename value_type, - int _Rank -> -class writeonly_texture_view : public details::_Texture_base; -``` - -### Parameters - -*value_type*
-The type of the elements in the texture. - -*_Rank*
-The rank of the texture. - -## Members - -### Public Typedefs - -|Name|Description| -|----------|-----------------| -|`scalar_type`|| -|`value_type`|The type of the elements in the texture.| - -### Public Constructors - -|Name|Description| -|----------|-----------------| -|[writeonly_texture_view Constructor](#ctor)|Initializes a new instance of the `writeonly_texture_view` class.| -|[~writeonly_texture_view Destructor](#ctor)|Destroys the `writeonly_texture_view` object.| - -### Public Methods - -|Name|Description| -|----------|-----------------| -|[set](#set)|Sets the value of the element at the specified index.| - -### Public Operators - -|Name|Description| -|----------|-----------------| -|[operator=](#operator_eq)|Copies the specified `writeonly_texture_view` object to this one.| - -### Public Constants - -|Name|Description| -|----------|-----------------| -|[rank Constant](#rank)|Gets the rank of the `writeonly_texture_view` object.| - -## Inheritance Hierarchy - -`_Texture_base` - -`writeonly_texture_view` - -## Requirements - -**Header:** amp_graphics.h - -**Namespace:** Concurrency::graphics - -## ~writeonly_texture_view - -Destroys the `writeonly_texture_view` object. - -```cpp -~writeonly_texture_view() restrict(amp,cpu); -``` - -## operator= - -Copies the specified `writeonly_texture_view` object to this one. - -```cpp -writeonly_texture_view& operator= ( - const writeonly_texture_view& _Other) restrict(amp,cpu); -``` - -### Parameters - -*_Other*
-`writeonly_texture_view` object to copy from. - -### Return Value - -A reference to this `writeonly_texture_view` object. - -## rank - -Gets the rank of the `writeonly_texture_view` object. - -```cpp -static const int rank = _Rank; -``` - -## set - -Sets the value of the element at the specified index. - -```cpp -void set( - const index<_Rank>& _Index, - const value_type& value) const restrict(amp); -``` - -### Parameters - -*_Index*
-The index of the element. - -*value*
-The new value of the element. - -## writeonly_texture_view - -Initializes a new instance of the `writeonly_texture_view` class. - -```cpp -writeonly_texture_view( - texture& _Src) restrict(amp); - -writeonly_texture_view( - const writeonly_texture_view& _Src) restrict(amp,cpu); -``` - -### Parameters - -*_Rank*
-The rank of the texture. - -*value_type*
-The type of the elements in the texture. - -*_Src*
-The texture that is used to create the `writeonly_texture_view`. - -## See also - -[Concurrency::graphics Namespace](concurrency-graphics-namespace.md) diff --git a/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md b/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md deleted file mode 100644 index 5546f803840..00000000000 --- a/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md +++ /dev/null @@ -1,184 +0,0 @@ ---- -title: "Using accelerator and accelerator_view Objects" -description: "Learn more about: Using accelerator and accelerator_view Objects" -ms.date: "11/04/2016" -ms.topic: how-to ---- -# Using accelerator and accelerator_view Objects - -You can use the [accelerator](reference/accelerator-class.md) and [accelerator_view](reference/accelerator-view-class.md) classes to specify the device or emulator to run your C++ AMP code on. A system might have several devices or emulators that differ by amount of memory, shared memory support, debugging support, or double-precision support. C++ Accelerated Massive Parallelism (C++ AMP) provides APIs that you can use to examine the available accelerators, set one as the default, specify multiple accelerator_views for multiple calls to parallel_for_each, and perform special debugging tasks. - -> [!NOTE] -> C++ AMP headers are deprecated starting with Visual Studio 2022 version 17.0. -> Including any AMP headers will generate build errors. Define `_SILENCE_AMP_DEPRECATION_WARNINGS` before including any AMP headers to silence the warnings. - -## Using the Default Accelerator - -The C++ AMP runtime picks a default accelerator, unless you write code to pick a specific one. The runtime chooses the default accelerator as follows: - -1. If the app is running in debug mode, an accelerator that supports debugging. - -2. Otherwise, the accelerator that's specified by the `CPPAMP_DEFAULT_ACCELERATOR` environment variable, if it's set. - -3. Otherwise, a non-emulated device. - -4. Otherwise, the device that has the greatest amount of available memory. - -5. Otherwise, a device that's not attached to the display. - -Additionally, the runtime specifies an `access_type` of `access_type_auto` for the default accelerator. This means that the default accelerator uses shared memory if it's supported and if its performance characteristics (bandwidth and latency) are known to be the same as dedicated (non-shared) memory. - -You can determine the properties of the default accelerator by constructing the default accelerator and examining its properties. The following code example prints the path, amount of accelerator memory, shared memory support, double-precision support, and limited double-precision support of the default accelerator. - -```cpp -void default_properties() { - accelerator default_acc; - std::wcout << default_acc.device_path << "\n"; - std::wcout << default_acc.dedicated_memory << "\n"; - std::wcout << (accs[i].supports_cpu_shared_memory ? - "CPU shared memory: true" : "CPU shared memory: false") << "\n"; - std::wcout << (accs[i].supports_double_precision ? - "double precision: true" : "double precision: false") << "\n"; - std::wcout << (accs[i].supports_limited_double_precision ? - "limited double precision: true" : "limited double precision: false") << "\n"; -} -``` - -### CPPAMP_DEFAULT_ACCELERATOR Environment Variable - -You can set the `CPPAMP_DEFAULT_ACCELERATOR` environment variable to specify the `accelerator::device_path` of the default accelerator. The path is hardware-dependent. The following code uses the `accelerator::get_all` function to retrieve a list of the available accelerators and then displays the path and characteristics of each accelerator. - -```cpp -void list_all_accelerators() -{ - std::vector accs = accelerator::get_all(); - - for (int i = 0; i accs = accelerator::get_all(); - accelerator acc_chosen = accs[0]; - - for (int i = 0; i acc_chosen.dedicated_memory) { - acc_chosen = accs[i]; - } - } - - std::wcout << "The accelerator with the most memory is " - << acc_chosen.device_path << "\n" - << acc_chosen.dedicated_memory << ".\n"; -} -``` - -> [!NOTE] -> One of the accelerators that are returned by `accelerator::get_all` is the CPU accelerator. You cannot execute code on the CPU accelerator. To filter out the CPU accelerator, compare the value of the [device_path](reference/accelerator-class.md#device_path) property of the accelerator that's returned by `accelerator::get_all` with the value of the [accelerator::cpu_accelerator](reference/accelerator-class.md#cpu_accelerator). For more information, see the "Special Accelerators" section in this article. - -## Shared Memory - -Shared memory is memory that can be accessed by both the CPU and the accelerator. The use of shared memory eliminates or significantly reduces the overhead of copying data between the CPU and the accelerator. Although the memory is shared, it cannot be accessed concurrently by both the CPU and the accelerator, and doing so causes undefined behavior. The accelerator property [supports_cpu_shared_memory](reference/accelerator-class.md#supports_cpu_shared_memory) returns **`true`** if the accelerator supports shared memory, and the [default_cpu_access_type](reference/accelerator-class.md#default_cpu_access_type) property gets the default [access_type](reference/concurrency-namespace-enums-amp.md#access_type) for memory allocated on the `accelerator`—for example, **array**s associated with the `accelerator`, or `array_view` objects accessed on the `accelerator`. - -The C++ AMP runtime automatically chooses the best default `access_type` for each `accelerator`, but the performance characteristics (bandwidth and latency) of shared memory can be worse than those of dedicated (non-shared) accelerator memory when reading from the CPU, writing from the CPU, or both. If shared memory performs as well as dedicated memory for reading and writing from the CPU, the runtime defaults to `access_type_read_write`; otherwise, the runtime chooses a more conservative default `access_type`, and allows the app to override it if the memory access patterns of its computation kernels benefit from a different `access_type`. - -The following code example shows how to determine whether the default accelerator supports shared memory, and then overrides its default access type and creates an `accelerator_view` from it. - -```cpp -#include -#include - -using namespace Concurrency; - -int main() -{ - accelerator acc = accelerator(accelerator::default_accelerator); - - // Early out if the default accelerator doesn't support shared memory. - if (!acc.supports_cpu_shared_memory) - { - std::cout << "The default accelerator does not support shared memory" << std::endl; - return 1; - } - - // Override the default CPU access type. - acc.set_default_cpu_access_type(access_type_read_write); - - // Create an accelerator_view from the default accelerator. The - // accelerator_view reflects the default_cpu_access_type of the - // accelerator it's associated with. - accelerator_view acc_v = acc.default_view; -} -``` - -An `accelerator_view` always reflects the `default_cpu_access_type` of the `accelerator` it's associated with, and it provides no interface to override or change its `access_type`. - -## Changing the Default Accelerator - -You can change the default accelerator by calling the `accelerator::set_default` method. You can change the default accelerator only once per app execution and you must change it before any code is executed on the GPU. Any subsequent function calls to change the accelerator return **`false`**. If you want to use a different accelerator in a call to `parallel_for_each`, read the "Using Multiple Accelerators" section in this article. The following code example sets the default accelerator to one that is not emulated, is not connected to a display, and supports double-precision. - -```cpp -bool pick_accelerator() -{ - std::vector accs = accelerator::get_all(); - accelerator chosen_one; - - auto result = std::find_if(accs.begin(), accs.end(), - [] (const accelerator& acc) { - return !acc.is_emulated && - acc.supports_double_precision && - !acc.has_display; - }); - - if (result != accs.end()) { - chosen_one = *(result); - } - - std::wcout < [!NOTE] -> C++ AMP headers are deprecated starting with Visual Studio 2022 version 17.0. -> Including any AMP headers will generate build errors. Define `_SILENCE_AMP_DEPRECATION_WARNINGS` before including any AMP headers to silence the warnings. - -## Performance considerations - -If you're using Visual C++ component extensions C++/CX to create your Universal Windows Platform (UWP) app, we recommend that you use plain-old-data (POD) types together with contiguous storage—for example, `std::vector` or C-style arrays—for data that will be used with C++ AMP. This can help you achieve higher performance than by using non-POD types or Windows Runtime containers because no marshaling has to occur. - -In a C++ AMP kernel, to access data that's stored in this way, just wrap the `std::vector` or array storage in a `concurrency::array_view` and then use the array view in a `concurrency::parallel_for_each` loop: - -```cpp -// simple vector addition example -std::vector data0(1024, 1); -std::vector data1(1024, 2); -std::vector data_out(data0.size(), 0); - -concurrency::array_view av0(data0.size(), data0); -concurrency::array_view av1(data1.size(), data1); -concurrency::array_view av2(data_out.size(), data2); - -av2.discard_data(); - -concurrency::parallel_for_each(av0.extent, [=](concurrency::index<1> idx) restrict(amp) - { - av2[idx] = av0[idx] + av1[idx]; - }); -``` - -## Marshaling Windows Runtime types - -When you work with Windows Runtime APIs, you might want to use C++ AMP on data that's stored in a Windows Runtime container such as a `Platform::Array^` or in complex data types such as classes or structs that are declared by using the **ref** keyword or the **value** keyword. In these situations, you have to do some extra work to make the data available to C++ AMP. - -### Platform::Array\^, where T is a POD type - -When you encounter a `Platform::Array^` and T is a POD type, you can access its underlying storage just by using the `get` member function: - -```cpp -Platform::Array^ arr; // Assume that this was returned by a Windows Runtime API -concurrency::array_view av(arr->Length, &arr->get(0)); -``` - -If T is not a POD type, use the technique that's described in the following section to use the data with C++ AMP. - -### Windows Runtime types: ref classes and value classes - -C++ AMP doesn't support complex data types. This includes non-POD types and any types that are declared by using the **ref** keyword or the **value** keyword. If an unsupported type is used in a `restrict(amp)` context, a compile-time error is generated. - -When you encounter an unsupported type, you can copy interesting parts of its data into a `concurrency::array` object. In addition to making the data available for C++ AMP to consume, this manual-copy approach can also improve performance by maximizing data locality, and by ensuring that data that won't be used isn't copied to the accelerator. You can improve performance further by using a *staging array*, which is a special form of `concurrency::array` that provides a hint to the AMP runtime that the array should be optimized for frequent transfer between it and other arrays on the specified accelerator. - -```cpp -// pixel_color.h -ref class pixel_color sealed -{ -public: - pixel_color(Platform::String^ color_name, int red, int green, int blue) - { - name = color_name; - r = red; - g = green; - b = blue; - } - - property Platform::String^ name; - property int r; - property int g; - property int b; -}; - -// Some other file - -std::vector pixels (256); - -for (pixel_color ^pixel : pixels) -{ - pixels.push_back(ref new pixel_color("blue", 0, 0, 255)); -} - -// Create the accelerators -auto cpuAccelerator = concurrency::accelerator(concurrency::accelerator::cpu_accelerator); -auto devAccelerator = concurrency::accelerator(concurrency::accelerator::default_accelerator); - -// Create the staging arrays -concurrency::array red_vec(256, cpuAccelerator.default_view, devAccelerator.default_view); -concurrency::array blue_vec(256, cpuAccelerator.default_view, devAccelerator.default_view); - -// Extract data from the complex array of structs into staging arrays. -concurrency::parallel_for(0, 256, [&](int i) - { - red_vec[i] = pixels[i]->r; - blue_vec[i] = pixels[i]->b; - }); - -// Array views are still used to copy data to the accelerator -concurrency::array_view av_red(red_vec); -concurrency::array_view av_blue(blue_vec); - -// Change all pixels from blue to red. -concurrency::parallel_for_each(av_red.extent, [=](index<1> idx) restrict(amp) - { - av_red[idx] = 255; - av_blue[idx] = 0; - }); -``` - -## See also - -[Create your first UWP app using C++](/windows/uwp/get-started/create-a-basic-windows-10-app-in-cpp)
-[Creating Windows Runtime Components in C++](/windows/uwp/winrt-components/creating-windows-runtime-components-in-cpp) diff --git a/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md b/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md deleted file mode 100644 index dfe089c6702..00000000000 --- a/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md +++ /dev/null @@ -1,159 +0,0 @@ ---- -description: "Learn more about: Using Lambdas, Function Objects, and Restricted Functions" -title: "Using Lambdas, Function Objects, and Restricted Functions" -ms.date: "11/04/2016" -ms.topic: concept-article ---- -# Using Lambdas, Function Objects, and Restricted Functions - -The C++ AMP code that you want to run on the accelerator is specified as an argument in a call to the [`parallel_for_each`](reference/concurrency-namespace-functions-amp.md#parallel_for_each) method. You can provide either a lambda expression or a function object (functor) as that argument. Additionally, the lambda expression or function object can call a C++ AMP-restricted function. This topic uses an array addition algorithm to demonstrate lambdas, function objects, and restricted functions. The following example shows the algorithm without C++ AMP code. Two 1-dimensional arrays of equal length are created. The corresponding integer elements are added and stored in a third 1-dimensional array. C++ AMP is not used. - -```cpp -void CpuMethod() { - - int aCPP[] = {1, 2, 3, 4, 5}; - int bCPP[] = {6, 7, 8, 9, 10}; - int sumCPP[5]; - - for (int idx = 0; idx <5; idx++) - { - sumCPP[idx] = aCPP[idx] + bCPP[idx]; - } - - for (int idx = 0; idx <5; idx++) - { - std::cout < a(5, aCPP); - - array_view b(5, bCPP); - - array_view sum(5, sumCPP); - - sum.discard_data(); - - parallel_for_each( - sum.extent, - [=](index<1> idx) restrict(amp) - { - sum[idx] = a[idx] + b[idx]; - }); - - for (int i = 0; i <5; i++) { - std::cout <& a, - const array_view& b, - const array_view& sum) - : a(a), b(b), sum(sum) - { - } - - void operator()(index<1> idx) restrict(amp) - { - sum[idx] = a[idx] + b[idx]; - } - -private: - array_view a; - array_view b; - array_view sum; -}; - -void AddArraysWithFunctionObject() { - int aCPP[] = {1, 2, 3, 4, 5}; - int bCPP[] = {6, 7, 8, 9, 10}; - int sumCPP[5]; - - array_view a(5, aCPP); - - array_view b(5, bCPP); - - array_view sum(5, sumCPP); - - sum.discard_data(); - - parallel_for_each( - sum.extent, - AdditionFunctionObject(a, b, sum)); - - for (int i = 0; i <5; i++) { - std::cout < idx, array_view sum, array_view a, array_view b) restrict(amp) -{ - sum[idx] = a[idx] + b[idx]; -} - -void AddArraysWithFunction() { - - int aCPP[] = {1, 2, 3, 4, 5}; - int bCPP[] = {6, 7, 8, 9, 10}; - int sumCPP[5]; - - array_view a(5, aCPP); - - array_view b(5, bCPP); - - array_view sum(5, sumCPP); - - sum.discard_data(); - - parallel_for_each( - sum.extent, - [=](index<1> idx) restrict(amp) - { - AddElementsWithRestrictedFunction(idx, sum, a, b); - }); - - for (int i = 0; i <5; i++) { - std::cout < -[Lambda Expression Syntax](../../cpp/lambda-expression-syntax.md)
-[Function Call](../../cpp/function-call-cpp.md)
-[Function Objects in the C++ Standard Library](../../standard-library/function-objects-in-the-stl.md)
-[restrict (C++ AMP)](../../cpp/restrict-cpp-amp.md) diff --git a/docs/parallel/amp/using-tiles.md b/docs/parallel/amp/using-tiles.md deleted file mode 100644 index e8b2840cdca..00000000000 --- a/docs/parallel/amp/using-tiles.md +++ /dev/null @@ -1,334 +0,0 @@ ---- -description: "Learn more about: Using Tiles" -title: "Using Tiles" -ms.date: "11/19/2018" -ms.topic: how-to ---- -# Using Tiles - -You can use tiling to maximize the acceleration of your app. Tiling divides threads into equal rectangular subsets or *tiles*. If you use an appropriate tile size and tiled algorithm, you can get even more acceleration from your C++ AMP code. The basic components of tiling are: - -- `tile_static` variables. The primary benefit of tiling is the performance gain from `tile_static` access. Access to data in `tile_static` memory can be significantly faster than access to data in the global space (`array` or `array_view` objects). An instance of a `tile_static` variable is created for each tile, and all threads in the tile have access to the variable. In a typical tiled algorithm, data is copied into `tile_static` memory once from global memory and then accessed many times from the `tile_static` memory. - -- [tile_barrier::wait Method](reference/tile-barrier-class.md#wait). A call to `tile_barrier::wait` suspends execution of the current thread until all of the threads in the same tile reach the call to `tile_barrier::wait`. You cannot guarantee the order that the threads will run in, only that no threads in the tile will execute past the call to `tile_barrier::wait` until all of the threads have reached the call. This means that by using the `tile_barrier::wait` method, you can perform tasks on a tile-by-tile basis rather than a thread-by-thread basis. A typical tiling algorithm has code to initialize the `tile_static` memory for the whole tile followed by a call to `tile_barrier::wait`. Code that follows `tile_barrier::wait` contains computations that require access to all the `tile_static` values. - -- Local and global indexing. You have access to the index of the thread relative to the entire `array_view` or `array` object and the index relative to the tile. Using the local index can make your code easier to read and debug. Typically, you use local indexing to access `tile_static` variables, and global indexing to access `array` and `array_view` variables. - -- [tiled_extent Class](../../parallel/amp/reference/tiled-extent-class.md) and [tiled_index Class](../../parallel/amp/reference/tiled-index-class.md). You use a `tiled_extent` object instead of an `extent` object in the `parallel_for_each` call. You use a `tiled_index` object instead of an `index` object in the `parallel_for_each` call. - -To take advantage of tiling, your algorithm must partition the compute domain into tiles and then copy the tile data into `tile_static` variables for faster access. - -## Example of Global, Tile, and Local Indices - -> [!NOTE] -> C++ AMP headers are deprecated starting with Visual Studio 2022 version 17.0. -> Including any AMP headers will generate build errors. Define `_SILENCE_AMP_DEPRECATION_WARNINGS` before including any AMP headers to silence the warnings. - -The following diagram represents an 8x9 matrix of data that is arranged in 2x3 tiles. - -![Diagram of an 8 by 9 matrix divided into 2 by 3 tiles.](../../parallel/amp/media/usingtilesmatrix.png) - -The following example displays the global, tile, and local indices of this tiled matrix. An `array_view` object is created by using elements of type `Description`. The `Description` holds the global, tile, and local indices of the element in the matrix. The code in the call to `parallel_for_each` sets the values of the global, tile, and local indices of each element. The output displays the values in the `Description` structures. - -```cpp -#include -#include -#include -#include -using namespace concurrency; - -const int ROWS = 8; -const int COLS = 9; - -// tileRow and tileColumn specify the tile that each thread is in. -// globalRow and globalColumn specify the location of the thread in the array_view. -// localRow and localColumn specify the location of the thread relative to the tile. -struct Description { - int value; - int tileRow; - int tileColumn; - int globalRow; - int globalColumn; - int localRow; - int localColumn; -}; - -// A helper function for formatting the output. -void SetConsoleColor(int color) { - int colorValue = (color == 0) 4 : 2; - SetConsoleTextAttribute(GetStdHandle(STD_OUTPUT_HANDLE), colorValue); -} - -// A helper function for formatting the output. -void SetConsoleSize(int height, int width) { - COORD coord; - - coord.X = width; - coord.Y = height; - SetConsoleScreenBufferSize(GetStdHandle(STD_OUTPUT_HANDLE), coord); - - SMALL_RECT* rect = new SMALL_RECT(); - rect->Left = 0; - rect->Top = 0; - rect->Right = width; - rect->Bottom = height; - SetConsoleWindowInfo(GetStdHandle(STD_OUTPUT_HANDLE), true, rect); -} - -// This method creates an 8x9 matrix of Description structures. -// In the call to parallel_for_each, the structure is updated -// with tile, global, and local indices. -void TilingDescription() { - // Create 72 (8x9) Description structures. - std::vector descs; - for (int i = 0; i < ROWS * COLS; i++) { - Description d = {i, 0, 0, 0, 0, 0, 0}; - descs.push_back(d); - } - - // Create an array_view from the Description structures. - extent<2> matrix(ROWS, COLS); - array_view descriptions(matrix, descs); - - // Update each Description with the tile, global, and local indices. - parallel_for_each(descriptions.extent.tile< 2, 3>(), - [=] (tiled_index< 2, 3> t_idx) restrict(amp) - { - descriptions[t_idx].globalRow = t_idx.global[0]; - descriptions[t_idx].globalColumn = t_idx.global[1]; - descriptions[t_idx].tileRow = t_idx.tile[0]; - descriptions[t_idx].tileColumn = t_idx.tile[1]; - descriptions[t_idx].localRow = t_idx.local[0]; - descriptions[t_idx].localColumn= t_idx.local[1]; - }); - - // Print out the Description structure for each element in the matrix. - // Tiles are displayed in red and green to distinguish them from each other. - SetConsoleSize(100, 150); - for (int row = 0; row < ROWS; row++) { - for (int column = 0; column < COLS; column++) { - SetConsoleColor((descriptions(row, column).tileRow + descriptions(row, column).tileColumn) % 2); - std::cout << "Value: " << std::setw(2) << descriptions(row, column).value << " "; - } - std::cout << "\n"; - - for (int column = 0; column < COLS; column++) { - SetConsoleColor((descriptions(row, column).tileRow + descriptions(row, column).tileColumn) % 2); - std::cout << "Tile: " << "(" << descriptions(row, column).tileRow << "," << descriptions(row, column).tileColumn << ") "; - } - std::cout << "\n"; - - for (int column = 0; column < COLS; column++) { - SetConsoleColor((descriptions(row, column).tileRow + descriptions(row, column).tileColumn) % 2); - std::cout << "Global: " << "(" << descriptions(row, column).globalRow << "," << descriptions(row, column).globalColumn << ") "; - } - std::cout << "\n"; - - for (int column = 0; column < COLS; column++) { - SetConsoleColor((descriptions(row, column).tileRow + descriptions(row, column).tileColumn) % 2); - std::cout << "Local: " << "(" << descriptions(row, column).localRow << "," << descriptions(row, column).localColumn << ") "; - } - std::cout << "\n"; - std::cout << "\n"; - } -} - -int main() { - TilingDescription(); - char wait; - std::cin >> wait; -} -``` - -The main work of the example is in the definition of the `array_view` object and the call to `parallel_for_each`. - -1. The vector of `Description` structures is copied into an 8x9 `array_view` object. - -2. The `parallel_for_each` method is called with a `tiled_extent` object as the compute domain. The `tiled_extent` object is created by calling the `extent::tile()` method of the `descriptions` variable. The type parameters of the call to `extent::tile()`, `<2,3>`, specify that 2x3 tiles are created. Thus, the 8x9 matrix is tiled into 12 tiles, four rows and three columns. - -3. The `parallel_for_each` method is called by using a `tiled_index<2,3>` object (`t_idx`) as the index. The type parameters of the index (`t_idx`) must match the type parameters of the compute domain (`descriptions.extent.tile< 2, 3>()`). - -4. When each thread is executed, the index `t_idx` returns information about which tile the thread is in (`tiled_index::tile` property) and the location of the thread within the tile (`tiled_index::local` property). - -## Tile Synchronization—tile_static and tile_barrier::wait - -The previous example illustrates the tile layout and indices, but is not in itself very useful. Tiling becomes useful when the tiles are integral to the algorithm and exploit `tile_static` variables. Because all threads in a tile have access to `tile_static` variables, calls to `tile_barrier::wait` are used to synchronize access to the `tile_static` variables. Although all of the threads in a tile have access to the `tile_static` variables, there is no guaranteed order of execution of threads in the tile. The following example shows how to use `tile_static` variables and the `tile_barrier::wait` method to calculate the average value of each tile. Here are the keys to understanding the example: - -1. The rawData is stored in an 8x8 matrix. - -2. The tile size is 2x2. This creates a 4x4 grid of tiles and the averages can be stored in a 4x4 matrix by using an `array` object. There are only a limited number of types that you can capture by reference in an AMP-restricted function. The `array` class is one of them. - -3. The matrix size and sample size are defined by using `#define` statements, because the type parameters to `array`, `array_view`, `extent`, and `tiled_index` must be constant values. You can also use `const int static` declarations. As an additional benefit, it is trivial to change the sample size to calculate the average over 4x4 tiles. - -4. A `tile_static` 2x2 array of float values is declared for each tile. Although the declaration is in the code path for every thread, only one array is created for each tile in the matrix. - -5. There is a line of code to copy the values in each tile to the `tile_static` array. For each thread, after the value is copied to the array, execution on the thread stops due to the call to `tile_barrier::wait`. - -6. When all of the threads in a tile have reached the barrier, the average can be calculated. Because the code executes for every thread, there is an `if` statement to only calculate the average on one thread. The average is stored in the averages variable. The barrier is essentially the construct that controls calculations by tile, much as you might use a **`for`** loop. - -7. The data in the `averages` variable, because it is an `array` object, must be copied back to the host. This example uses the vector conversion operator. - -8. In the complete example, you can change SAMPLESIZE to 4 and the code executes correctly without any other changes. - -```cpp -#include -#include -using namespace concurrency; - -#define SAMPLESIZE 2 -#define MATRIXSIZE 8 -void SamplingExample() { - - // Create data and array_view for the matrix. - std::vector rawData; - for (int i = 0; i < MATRIXSIZE * MATRIXSIZE; i++) { - rawData.push_back((float)i); - } - extent<2> dataExtent(MATRIXSIZE, MATRIXSIZE); - array_view matrix(dataExtent, rawData); - - // Create the array for the averages. - // There is one element in the output for each tile in the data. - std::vector outputData; - int outputSize = MATRIXSIZE / SAMPLESIZE; - for (int j = 0; j < outputSize * outputSize; j++) { - outputData.push_back((float)0); - } - extent<2> outputExtent(MATRIXSIZE / SAMPLESIZE, MATRIXSIZE / SAMPLESIZE); - array averages(outputExtent, outputData.begin(), outputData.end()); - - // Use tiles that are SAMPLESIZE x SAMPLESIZE. - // Find the average of the values in each tile. - // The only reference-type variable you can pass into the parallel_for_each call - // is a concurrency::array. - parallel_for_each(matrix.extent.tile(), - [=, &averages] (tiled_index t_idx) restrict(amp) - { - // Copy the values of the tile into a tile-sized array. - tile_static float tileValues[SAMPLESIZE][SAMPLESIZE]; - tileValues[t_idx.local[0]][t_idx.local[1]] = matrix[t_idx]; - - // Wait for the tile-sized array to load before you calculate the average. - t_idx.barrier.wait(); - - // If you remove the if statement, then the calculation executes for every - // thread in the tile, and makes the same assignment to averages each time. - if (t_idx.local[0] == 0 && t_idx.local[1] == 0) { - for (int trow = 0; trow < SAMPLESIZE; trow++) { - for (int tcol = 0; tcol < SAMPLESIZE; tcol++) { - averages(t_idx.tile[0],t_idx.tile[1]) += tileValues[trow][tcol]; - } - } - averages(t_idx.tile[0],t_idx.tile[1]) /= (float) (SAMPLESIZE * SAMPLESIZE); - } - }); - - // Print out the results. - // You cannot access the values in averages directly. You must copy them - // back to a CPU variable. - outputData = averages; - for (int row = 0; row < outputSize; row++) { - for (int col = 0; col < outputSize; col++) { - std::cout << outputData[row*outputSize + col] << " "; - } - std::cout << "\n"; - } - // Output for SAMPLESIZE = 2 is: - // 4.5 6.5 8.5 10.5 - // 20.5 22.5 24.5 26.5 - // 36.5 38.5 40.5 42.5 - // 52.5 54.5 56.5 58.5 - - // Output for SAMPLESIZE = 4 is: - // 13.5 17.5 - // 45.5 49.5 -} - -int main() { - SamplingExample(); -} -``` - -## Race Conditions - -It might be tempting to create a `tile_static` variable named `total` and increment that variable for each thread, like this: - -```cpp -// Do not do this. -tile_static float total; -total += matrix[t_idx]; -t_idx.barrier.wait(); - -averages(t_idx.tile[0],t_idx.tile[1]) /= (float) (SAMPLESIZE* SAMPLESIZE); -``` - -The first problem with this approach is that `tile_static` variables cannot have initializers. The second problem is that there is a race condition on the assignment to `total`, because all of the threads in the tile have access to the variable in no particular order. You could program an algorithm to only allow one thread to access the total at each barrier, as shown next. However, this solution is not extensible. - -```cpp -// Do not do this. -tile_static float total; -if (t_idx.local[0] == 0&& t_idx.local[1] == 0) { - total = matrix[t_idx]; -} -t_idx.barrier.wait(); - -if (t_idx.local[0] == 0&& t_idx.local[1] == 1) { - total += matrix[t_idx]; -} -t_idx.barrier.wait(); - -// etc. -``` - -## Memory Fences - -There are two kinds of memory accesses that must be synchronized—global memory access and `tile_static` memory access. A `concurrency::array` object allocates only global memory. A `concurrency::array_view` can reference global memory, `tile_static` memory, or both, depending on how it was constructed. There are two kinds of memory that must be synchronized: - -- global memory - -- `tile_static` - -A *memory fence* ensures that memory accesses are available to other threads in the thread tile, and that memory accesses are executed according to program order. To ensure this, compilers and processors do not reorder reads and writes across the fence. In C++ AMP, a memory fence is created by a call to one of these methods: - -- [tile_barrier::wait Method](reference/tile-barrier-class.md#wait): Creates a fence around both global and `tile_static` memory. - -- [tile_barrier::wait_with_all_memory_fence Method](reference/tile-barrier-class.md#wait_with_all_memory_fence): Creates a fence around both global and `tile_static` memory. - -- [tile_barrier::wait_with_global_memory_fence Method](reference/tile-barrier-class.md#wait_with_global_memory_fence): Creates a fence around only global memory. - -- [tile_barrier::wait_with_tile_static_memory_fence Method](reference/tile-barrier-class.md#wait_with_tile_static_memory_fence): Creates a fence around only `tile_static` memory. - -Calling the specific fence that you require can improve the performance of your app. The barrier type affects how the compiler and the hardware reorder statements. For example, if you use a global memory fence, it applies only to global memory accesses and therefore, the compiler and the hardware might reorder reads and writes to `tile_static` variables on the two sides of the fence. - -In the next example, the barrier synchronizes the writes to `tileValues`, a `tile_static` variable. In this example, `tile_barrier::wait_with_tile_static_memory_fence` is called instead of `tile_barrier::wait`. - -```cpp -// Using a tile_static memory fence. -parallel_for_each(matrix.extent.tile(), - [=, &averages] (tiled_index t_idx) restrict(amp) -{ - // Copy the values of the tile into a tile-sized array. - tile_static float tileValues[SAMPLESIZE][SAMPLESIZE]; - tileValues[t_idx.local[0]][t_idx.local[1]] = matrix[t_idx]; - - // Wait for the tile-sized array to load before calculating the average. - t_idx.barrier.wait_with_tile_static_memory_fence(); - - // If you remove the if statement, then the calculation executes - // for every thread in the tile, and makes the same assignment to - // averages each time. - if (t_idx.local[0] == 0&& t_idx.local[1] == 0) { - for (int trow = 0; trow -[tile_static Keyword](../../cpp/tile-static-keyword.md) diff --git a/docs/parallel/amp/walkthrough-debugging-a-cpp-amp-application.md b/docs/parallel/amp/walkthrough-debugging-a-cpp-amp-application.md deleted file mode 100644 index d9c3ddfd4e3..00000000000 --- a/docs/parallel/amp/walkthrough-debugging-a-cpp-amp-application.md +++ /dev/null @@ -1,405 +0,0 @@ ---- -description: "Learn more about: Walkthrough: Debugging a C++ AMP application" -title: "Walkthrough: Debugging a C++ AMP application" -ms.date: 10/27/2021 -helpviewer_keywords: ["debugging, C++ Accelerated Massive Parallelism", "C++ AMP, debugging", "C++ Accelerated Massive Parallelism, debugging", "debugging, C++ AMP"] ---- -# Walkthrough: Debugging a C++ AMP application - -This article demonstrates how to debug an application that uses C++ Accelerated Massive Parallelism (C++ AMP) to take advantage of the graphics processing unit (GPU). It uses a parallel-reduction program that sums up a large array of integers. This walkthrough illustrates the following tasks: - -- Launching the GPU debugger. -- Inspecting GPU threads in the GPU Threads window. -- Using the **Parallel Stacks** window to simultaneously observe the call stacks of multiple GPU threads. -- Using the **Parallel Watch** window to inspect values of a single expression across multiple threads at the same time. -- Flagging, freezing, thawing, and grouping GPU threads. -- Executing all the threads of a tile to a specific location in code. - -## Prerequisites - -Before you start this walkthrough: - -> [!NOTE] -> C++ AMP headers are deprecated starting with Visual Studio 2022 version 17.0. -> Including any AMP headers will generate build errors. Define `_SILENCE_AMP_DEPRECATION_WARNINGS` before including any AMP headers to silence the warnings. - -- Read [C++ AMP Overview](../../parallel/amp/cpp-amp-overview.md). -- Make sure that line numbers are displayed in the text editor. For more information, see [How to: Display line numbers in the editor](/visualstudio/ide/reference/how-to-display-line-numbers-in-the-editor). -- Make sure you're running at least Windows 8 or Windows Server 2012 to support debugging on the software emulator. - -[!INCLUDE[note_settings_general](../../mfc/includes/note_settings_general_md.md)] - -### To create the sample project - -The instructions for creating a project vary depending on which version of Visual Studio you're using. Make sure you have the correct documentation version selected above the table of contents on this page. - -::: moniker range=">=msvc-160" - -### To create the sample project in Visual Studio - -1. On the menu bar, choose **File** > **New** > **Project** to open the **Create a New Project** dialog box. - -1. At the top of the dialog, set **Language** to **C++**, set **Platform** to **Windows**, and set **Project type** to **Console**. - -1. From the filtered list of project types, choose **Console App** then choose **Next**. In the next page, enter `AMPMapReduce` in the **Name** box to specify a name for the project, and specify the project location if you want a different one. - - ![Screenshot showing the Create a new project dialog with the Console App template selected.](../../build/media/mathclient-project-name-2019.png) - -1. Choose the **Create** button to create the client project. - -::: moniker-end - -::: moniker range="<=msvc-150" - -### To create the sample project in Visual Studio 2017 or Visual Studio 2015 - -1. Start Visual Studio. - -1. On the menu bar, choose **File** > **New** > **Project**. - -1. Under **Installed** in the templates pane, choose **Visual C++**. - -1. Choose **Win32 Console Application**, type `AMPMapReduce` in the **Name** box, and then choose the **OK** button. - -1. Choose the **Next** button. - -1. Clear the **Precompiled header** check box, and then choose the **Finish** button. - -1. In **Solution Explorer**, delete *stdafx.h*, *targetver.h*, and *stdafx.cpp* from the project. - -::: moniker-end - -Next: - -1. Open AMPMapReduce.cpp and replace its content with the following code. - - ```cpp - // AMPMapReduce.cpp defines the entry point for the program. - // The program performs a parallel-sum reduction that computes the sum of an array of integers. - - #include - #include - #include - - const int BLOCK_DIM = 32; - - using namespace concurrency; - - void sum_kernel_tiled(tiled_index t_idx, array &A, int stride_size) restrict(amp) - { - tile_static int localA[BLOCK_DIM]; - - index<1> globalIdx = t_idx.global * stride_size; - index<1> localIdx = t_idx.local; - - localA[localIdx[0]] = A[globalIdx]; - - t_idx.barrier.wait(); - - // Aggregate all elements in one tile into the first element. - for (int i = BLOCK_DIM / 2; i > 0; i /= 2) - { - if (localIdx[0] < i) - { - - localA[localIdx[0]] += localA[localIdx[0] + i]; - } - - t_idx.barrier.wait(); - } - - if (localIdx[0] == 0) - { - A[globalIdx] = localA[0]; - } - } - - int size_after_padding(int n) - { - // The extent might have to be slightly bigger than num_stride to - // be evenly divisible by BLOCK_DIM. You can do this by padding with zeros. - // The calculation to do this is BLOCK_DIM * ceil(n / BLOCK_DIM) - return ((n - 1) / BLOCK_DIM + 1) * BLOCK_DIM; - } - - int reduction_sum_gpu_kernel(array input) - { - int len = input.extent[0]; - - //Tree-based reduction control that uses the CPU. - for (int stride_size = 1; stride_size < len; stride_size *= BLOCK_DIM) - { - // Number of useful values in the array, given the current - // stride size. - int num_strides = len / stride_size; - - extent<1> e(size_after_padding(num_strides)); - - // The sum kernel that uses the GPU. - parallel_for_each(extent<1>(e).tile(), [&input, stride_size] (tiled_index idx) restrict(amp) - { - sum_kernel_tiled(idx, input, stride_size); - }); - } - - array_view output = input.section(extent<1>(1)); - return output[0]; - } - - int cpu_sum(const std::vector &arr) { - int sum = 0; - for (size_t i = 0; i < arr.size(); i++) { - sum += arr[i]; - } - return sum; - } - - std::vector rand_vector(unsigned int size) { - srand(2011); - - std::vector vec(size); - for (size_t i = 0; i < size; i++) { - vec[i] = rand(); - } - return vec; - } - - array vector_to_array(const std::vector &vec) { - array arr(vec.size()); - copy(vec.begin(), vec.end(), arr); - return arr; - } - - int _tmain(int argc, _TCHAR* argv[]) - { - std::vector vec = rand_vector(10000); - array arr = vector_to_array(vec); - - int expected = cpu_sum(vec); - int actual = reduction_sum_gpu_kernel(arr); - - bool passed = (expected == actual); - if (!passed) { - printf("Actual (GPU): %d, Expected (CPU): %d", actual, expected); - } - printf("sum: %s\n", passed ? "Passed!" : "Failed!"); - - getchar(); - - return 0; - } - ``` - -1. On the menu bar, choose **File** > **Save All**. - -1. In **Solution Explorer**, open the shortcut menu for **AMPMapReduce**, and then choose **Properties**. - -1. In the **Property Pages** dialog box, under **Configuration Properties**, choose **C/C++** > **Precompiled Headers**. - -1. For the **Precompiled Header** property, select **Not Using Precompiled Headers**, and then choose the **OK** button. - -1. On the menu bar, choose **Build** > **Build Solution**. - -## Debugging the CPU Code - -In this procedure, you'll use the Local Windows Debugger to make sure that the CPU code in this application is correct. The segment of the CPU code in this application that is especially interesting is the **`for`** loop in the `reduction_sum_gpu_kernel` function. It controls the tree-based parallel reduction that is run on the GPU. - -### To debug the CPU code - -1. In **Solution Explorer**, open the shortcut menu for **AMPMapReduce**, and then choose **Properties**. - -2. In the **Property Pages** dialog box, under **Configuration Properties**, choose **Debugging**. Verify that **Local Windows Debugger** is selected in the **Debugger to launch** list. - -3. Return to the **Code Editor**. - -4. Set breakpoints on the lines of code shown in the following illustration (approximately lines 67 line 70). - - ![CPU breakpoints marked next to lines of code in the editor.](../../parallel/amp/media/campcpubreakpoints.png "CPU breakpoints")
- CPU breakpoints - -5. On the menu bar, choose **Debug** > **Start Debugging**. - -6. In the **Locals** window, observe the value for `stride_size` until the breakpoint at line 70 is reached. - -7. On the menu bar, choose **Debug** > **Stop Debugging**. - -## Debugging the GPU Code - -This section shows how to debug the GPU code, which is the code contained in the `sum_kernel_tiled` function. The GPU code computes the sum of integers for each "block" in parallel. - -### To debug the GPU code - -1. In **Solution Explorer**, open the shortcut menu for **AMPMapReduce**, and then choose **Properties**. - -2. In the **Property Pages** dialog box, under **Configuration Properties**, choose **Debugging**. - -3. In the **Debugger to launch** list, select **Local Windows Debugger**. - -4. In the **Debugger Type** list, verify that **Auto** is selected. - - **Auto** is the default value. In versions before Windows 10, **GPU Only** is the required value instead of **Auto**. - -5. Choose the **OK** button. - -6. Set a breakpoint at line 30, as shown in the following illustration. - - ![GPU breakpoints marked next to a line of code in the editor.](../../parallel/amp/media/campgpubreakpoints.png "GPU breakpoints")
- GPU breakpoint - -7. On the menu bar, choose **Debug** > **Start Debugging**. The breakpoints in the CPU code at lines 67 and 70 don't get executed during GPU debugging because those lines of code run on the CPU. - -### To use the GPU Threads window - -1. To open the **GPU Threads** window, on the menu bar, choose **Debug** > **Windows** > **GPU Threads**. - - You can inspect the state the GPU threads in the **GPU Threads** window that appears. - -2. Dock the **GPU Threads** window at the bottom of Visual Studio. Choose the **Expand Thread Switch** button to display the tile and thread text boxes. The **GPU Threads** window shows the total number of active and blocked GPU threads, as shown in the following illustration. - - ![GPU Threads window with 4 active threads.](../../parallel/amp/media/campc.png "GPU Threads window with 4 active threads")
- GPU Threads window - - 313 tiles get allocated for this computation. Each tile contains 32 threads. Because local GPU debugging occurs on a software emulator, there are four active GPU threads. The four threads execute the instructions simultaneously and then move on together to the next instruction. - - In the **GPU Threads** window, there are four GPU threads active and 28 GPU threads blocked at the [tile_barrier::wait](reference/tile-barrier-class.md#wait) statement defined at about line 21 (`t_idx.barrier.wait();`). All 32 GPU threads belong to the first tile, `tile[0]`. An arrow points to the row that includes the current thread. To switch to a different thread, use one of the following methods: - - - In the row for the thread to switch to in the **GPU Threads** window, open the shortcut menu and choose **Switch To Thread**. If the row represents more than one thread, you'll switch to the first thread according to the thread coordinates. - - - Enter the tile and thread values of the thread in the corresponding text boxes and then choose the **Switch Thread** button. - - The **Call Stack** window displays the call stack of the current GPU thread. - -### To use the Parallel Stacks window - -1. To open the **Parallel Stacks** window, on the menu bar, choose **Debug** > **Windows** > **Parallel Stacks**. - - You can use the **Parallel Stacks** window to simultaneously inspect the stack frames of multiple GPU threads. - -2. Dock the **Parallel Stacks** window at the bottom of Visual Studio. - -3. Make sure that **Threads** is selected in the list in the upper-left corner. In the following illustration, the **Parallel Stacks** window shows a call-stack focused view of the GPU threads that you saw in the **GPU Threads** window. - - ![Parallel Stacks window with 4 active threads.](../../parallel/amp/media/campd.png "Parallel Stacks window with 4 active threads")
- Parallel Stacks window - - 32 threads went from `_kernel_stub` to the lambda statement in the `parallel_for_each` function call and then to the `sum_kernel_tiled` function, where the parallel reduction occurs. 28 out of the 32 threads have progressed to the [`tile_barrier::wait`](reference/tile-barrier-class.md#wait) statement and remain blocked at line 22, while the other four threads remain active in the `sum_kernel_tiled` function at line 30. - - You can inspect the properties of a GPU thread. They're available in the **GPU Threads** window in the rich DataTip of the **Parallel Stacks** window. To see them, hover the pointer on the stack frame of `sum_kernel_tiled`. The following illustration shows the DataTip. - - ![DataTip for Parallel Stacks window.](../../parallel/amp/media/campe.png "DataTip for Parallel Stacks window")
- GPU thread DataTip - - For more information about the **Parallel Stacks** window, see [Using the Parallel Stacks Window](/visualstudio/debugger/using-the-parallel-stacks-window). - -### To use the Parallel Watch window - -1. To open the **Parallel Watch** window, on the menu bar, choose **Debug** > **Windows** > **Parallel Watch** > **Parallel Watch 1**. - - You can use the **Parallel Watch** window to inspect the values of an expression across multiple threads. - -2. Dock the **Parallel Watch 1** window to the bottom of Visual Studio. There are 32 rows in the table of the **Parallel Watch** window. Each corresponds to a GPU thread that appeared in both the GPU Threads window and the **Parallel Stacks** window. Now, you can enter expressions whose values you want to inspect across all 32 GPU threads. - -3. Select the **Add Watch** column header, enter `localIdx`, and then choose the **Enter** key. - -4. Select the **Add Watch** column header again, type `globalIdx`, and then choose the **Enter** key. - -5. Select the **Add Watch** column header again, type `localA[localIdx[0]]`, and then choose the **Enter** key. - - You can sort by a specified expression by selecting its corresponding column header. - - Select the **localA[localIdx[0]]** column header to sort the column. The following illustration shows the results of sorting by **localA[localIdx[0]]**. - - ![Parallel Watch window with sorted results.](../../parallel/amp/media/campf.png "Parallel Watch window with sorted results")
- Results of sort - - You can export the content in the **Parallel Watch** window to Excel by choosing the **Excel** button and then choosing **Open in Excel**. If you have Excel installed on your development computer, the button opens an Excel worksheet that contains the content. - -6. In the upper-right corner of the **Parallel Watch** window, there's a filter control that you can use to filter the content by using Boolean expressions. Enter `localA[localIdx[0]] > 20000` in the filter control text box and then choose the **Enter** key. - - The window now contains only threads on which the `localA[localIdx[0]]` value is greater than 20000. The content is still sorted by the `localA[localIdx[0]]` column, which is the sorting action you chose earlier. - -## Flagging GPU Threads - -You can mark specific GPU threads by flagging them in the **GPU Threads** window, the **Parallel Watch** window, or the DataTip in the **Parallel Stacks** window. If a row in the GPU Threads window contains more than one thread, flagging that row flags all threads contained in the row. - -### To flag GPU threads - -1. Select the **[Thread]** column header in the **Parallel Watch 1** window to sort by tile index and thread index. - -2. On the menu bar, choose **Debug** > **Continue**, which causes the four threads that were active to progress to the next barrier (defined at line 32 of AMPMapReduce.cpp). - -3. Choose the flag symbol on the left side of the row that contains the four threads that are now active. - - The following illustration shows the four active flagged threads in the **GPU Threads** window. - - ![GPU Threads window with flagged threads.](../../parallel/amp/media/campg.png "GPU Threads window with flagged threads")
- Active threads in the GPU Threads window - - The **Parallel Watch** window and the DataTip of the **Parallel Stacks** window both indicate the flagged threads. - -4. If you want to focus on the four threads that you flagged, you can choose to show only the flagged threads. It limits what you see in the **GPU Threads**, **Parallel Watch**, and **Parallel Stacks** windows. - - Choose the **Show Flagged Only** button on any of the windows or on the **Debug Location** toolbar. The following illustration shows the **Show Flagged Only** button on the **Debug Location** toolbar. - - ![Debug Location toolbar with Show Only Flagged icon.](../../parallel/amp/media/camph.png "Debug Location toolbar with Show Only Flagged icon")
- **Show Flagged Only** button - - Now the **GPU Threads**, **Parallel Watch**, and **Parallel Stacks** windows display only the flagged threads. - -## Freezing and Thawing GPU Threads - -You can freeze (suspend) and thaw (resume) GPU threads from either the **GPU Threads** window or the **Parallel Watch** window. You can freeze and thaw CPU threads the same way; for information, see [How to: Use the Threads Window](/visualstudio/debugger/how-to-use-the-threads-window). - -### To freeze and thaw GPU threads - -1. Choose the **Show Flagged Only** button to display all the threads. - -2. On the menu bar, choose **Debug** > **Continue**. - -3. Open the shortcut menu for the active row and then choose **Freeze**. - - The following illustration of the **GPU Threads** window shows that all four threads are frozen. - - ![GPU Threads windows showing frozen threads.](../../parallel/amp/media/campk.png "GPU Threads windows showing frozen threads")
- Frozen threads in the **GPU Threads** window - - Similarly, the **Parallel Watch** window shows that all four threads are frozen. - -4. On the menu bar, choose **Debug** > **Continue** to allow the next four GPU threads to progress past the barrier at line 22 and to reach the breakpoint at line 30. The **GPU Threads** window shows that the four previously frozen threads remain frozen and in the active state. - -5. On the menu bar, choose **Debug**, **Continue**. - -6. From the **Parallel Watch** window, you can also thaw individual or multiple GPU threads. - -### To group GPU threads - -1. On the shortcut menu for one of the threads in the **GPU Threads** window, choose **Group By**, **Address**. - - The threads in the **GPU Threads** window are grouped by address. The address corresponds to the instruction in disassembly where each group of threads is located. 24 threads are at line 22 where the [tile_barrier::wait Method](reference/tile-barrier-class.md#wait) is executed. 12 threads are at the instruction for the barrier at line 32. Four of these threads are flagged. Eight threads are at the breakpoint at line 30. Four of these threads are frozen. The following illustration shows the grouped threads in the **GPU Threads** window. - - ![GPU Threads window with threads grouped by Address.](../../parallel/amp/media/campl.png "GPU Threads window with threads grouped by Address")
- Grouped threads in the **GPU Threads** window - -2. You can also do the **Group By** operation by opening the shortcut menu for the **Parallel Watch** window's data grid. Select **Group By**, and then choose the menu item that corresponds to how you want to group the threads. - -## Running All Threads to a Specific Location in Code - -You run all the threads in a given tile to the line that contains the cursor by using **Run Current Tile To Cursor**. - -### To run all threads to the location marked by the cursor - -1. On the shortcut menu for the frozen threads, choose **Thaw**. - -2. In the **Code Editor**, put the cursor in line 30. - -3. On the shortcut menu for the **Code Editor**, choose **Run Current Tile To Cursor**. - - The 24 threads that were previously blocked at the barrier at line 21 have progressed to line 32. It's shown in the **GPU Threads** window. - -## See also - -[C++ AMP overview](../../parallel/amp/cpp-amp-overview.md)\ -[Debugging GPU code](/visualstudio/debugger/debugging-gpu-code)\ -[How to: Use the GPU Threads window](/visualstudio/debugger/how-to-use-the-gpu-threads-window)\ -[How to: Use the Parallel Watch window](/visualstudio/debugger/how-to-use-the-parallel-watch-window)\ -[Analyzing C++ AMP code with the Concurrency Visualizer](/archive/blogs/nativeconcurrency/analyzing-c-amp-code-with-the-concurrency-visualizer) diff --git a/docs/parallel/amp/walkthrough-matrix-multiplication.md b/docs/parallel/amp/walkthrough-matrix-multiplication.md deleted file mode 100644 index b3dbcffba19..00000000000 --- a/docs/parallel/amp/walkthrough-matrix-multiplication.md +++ /dev/null @@ -1,322 +0,0 @@ ---- -description: "Learn more about: Walkthrough: Matrix Multiplication" -title: "Walkthrough: Matrix Multiplication" -ms.date: 10/27/2021 ---- -# Walkthrough: Matrix Multiplication - -This step-by-step walkthrough demonstrates how to use C++ AMP to accelerate the execution of matrix multiplication. Two algorithms are presented, one without tiling and one with tiling. - -## Prerequisites - -Before you start: - -- Read [C++ AMP Overview](../../parallel/amp/cpp-amp-overview.md). -- Read [Using Tiles](../../parallel/amp/using-tiles.md). -- Make sure that you are running at least Windows 7, or Windows Server 2008 R2. - -> [!NOTE] -> C++ AMP headers are deprecated starting with Visual Studio 2022 version 17.0. -> Including any AMP headers will generate build errors. Define `_SILENCE_AMP_DEPRECATION_WARNINGS` before including any AMP headers to silence the warnings. - -### To create the project - -Instructions for creating a new project vary depending on which version of Visual Studio you have installed. To see the documentation for your preferred version of Visual Studio, use the **Version** selector control. It's found at the top of the table of contents on this page. - -::: moniker range=">=msvc-160" - -### To create the project in Visual Studio - -1. On the menu bar, choose **File** > **New** > **Project** to open the **Create a New Project** dialog box. - -1. At the top of the dialog, set **Language** to **C++**, set **Platform** to **Windows**, and set **Project type** to **Console**. - -1. From the filtered list of project types, choose **Empty Project** then choose **Next**. In the next page, enter *MatrixMultiply* in the **Name** box to specify a name for the project, and specify the project location if desired. - - ![Screenshot showing the Create a new project dialog with the Console App template selected.](../../build/media/mathclient-project-name-2019.png) - -1. Choose the **Create** button to create the client project. - -1. In **Solution Explorer**, open the shortcut menu for **Source Files**, and then choose **Add** > **New Item**. - -1. In the **Add New Item** dialog box, select **C++ File (.cpp)**, enter *MatrixMultiply.cpp* in the **Name** box, and then choose the **Add** button. - -::: moniker-end - -::: moniker range="<=msvc-150" - -### To create a project in Visual Studio 2017 or 2015 - -1. On the menu bar in Visual Studio, choose **File** > **New** > **Project**. - -1. Under **Installed** in the templates pane, select **Visual C++**. - -1. Select **Empty Project**, enter *MatrixMultiply* in the **Name** box, and then choose the **OK** button. - -1. Choose the **Next** button. - -1. In **Solution Explorer**, open the shortcut menu for **Source Files**, and then choose **Add** > **New Item**. - -1. In the **Add New Item** dialog box, select **C++ File (.cpp)**, enter *MatrixMultiply.cpp* in the **Name** box, and then choose the **Add** button. - -::: moniker-end - -## Multiplication without tiling - -In this section, consider the multiplication of two matrices, A and B, which are defined as follows: - -![Diagram showing 3 by 2 matrix A.](../../parallel/amp/media/campmatrixanontiled.png) - -![Diagram showing 2 by 3 matrix B.](../../parallel/amp/media/campmatrixbnontiled.png) - -A is a 3-by-2 matrix and B is a 2-by-3 matrix. The product of multiplying A by B is the following 3-by-3 matrix. The product is calculated by multiplying the rows of A by the columns of B element by element. - -![Diagram showing the result 3 by 3 product matrix.](../../parallel/amp/media/campmatrixproductnontiled.png) - -### To multiply without using C++ AMP - -1. Open MatrixMultiply.cpp and use the following code to replace the existing code. - - ```cpp - #include - - void MultiplyWithOutAMP() { - int aMatrix[3][2] = {{1, 4}, {2, 5}, {3, 6}}; - int bMatrix[2][3] = {{7, 8, 9}, {10, 11, 12}}; - int product[3][3] = {{0, 0, 0}, {0, 0, 0}, {0, 0, 0}}; - - for (int row = 0; row < 3; row++) { - for (int col = 0; col < 3; col++) { - // Multiply the row of A by the column of B to get the row, column of product. - for (int inner = 0; inner < 2; inner++) { - product[row][col] += aMatrix[row][inner] * bMatrix[inner][col]; - } - std::cout << product[row][col] << " "; - } - std::cout << "\n"; - } - } - - int main() { - MultiplyWithOutAMP(); - getchar(); - } - ``` - - The algorithm is a straightforward implementation of the definition of matrix multiplication. It does not use any parallel or threaded algorithms to reduce the computation time. - -1. On the menu bar, choose **File** > **Save All**. - -1. Choose the **F5** keyboard shortcut to start debugging and verify that the output is correct. - -1. Choose **Enter** to exit the application. - -### To multiply by using C++ AMP - -1. In MatrixMultiply.cpp, add the following code before the `main` method. - - ```cpp - void MultiplyWithAMP() { - int aMatrix[] = { 1, 4, 2, 5, 3, 6 }; - int bMatrix[] = { 7, 8, 9, 10, 11, 12 }; - int productMatrix[] = { 0, 0, 0, 0, 0, 0, 0, 0, 0 }; - - array_view a(3, 2, aMatrix); - - array_view b(2, 3, bMatrix); - - array_view product(3, 3, productMatrix); - - parallel_for_each(product.extent, - [=] (index<2> idx) restrict(amp) { - int row = idx[0]; - int col = idx[1]; - for (int inner = 0; inner <2; inner++) { - product[idx] += a(row, inner)* b(inner, col); - } - }); - - product.synchronize(); - - for (int row = 0; row <3; row++) { - for (int col = 0; col <3; col++) { - //std::cout << productMatrix[row*3 + col] << " "; - std::cout << product(row, col) << " "; - } - std::cout << "\n"; - } - } - ``` - - The AMP code resembles the non-AMP code. The call to `parallel_for_each` starts one thread for each element in `product.extent`, and replaces the **`for`** loops for row and column. The value of the cell at the row and column is available in `idx`. You can access the elements of an `array_view` object by using either the `[]` operator and an index variable, or the `()` operator and the row and column variables. The example demonstrates both methods. The `array_view::synchronize` method copies the values of the `product` variable back to the `productMatrix` variable. - -1. Add the following `include` and **`using`** statements at the top of MatrixMultiply.cpp. - - ```cpp - #include - using namespace concurrency; - ``` - -1. Modify the `main` method to call the `MultiplyWithAMP` method. - - ```cpp - int main() { - MultiplyWithOutAMP(); - MultiplyWithAMP(); - getchar(); - } - ``` - -1. Press the **Ctrl**+**F5** keyboard shortcut to start debugging and verify that the output is correct. - -1. Press the **Spacebar** to exit the application. - -## Multiplication with tiling - -Tiling is a technique in which you partition data into equal-sized subsets, which are known as tiles. Three things change when you use tiling. - -- You can create `tile_static` variables. Access to data in `tile_static` space can be many times faster than access to data in the global space. An instance of a `tile_static` variable is created for each tile, and all threads in the tile have access to the variable. The primary benefit of tiling is the performance gain due to `tile_static` access. - -- You can call the [tile_barrier::wait](reference/tile-barrier-class.md#wait) method to stop all of the threads in one tile at a specified line of code. You cannot guarantee the order that the threads will run in, only that all of the threads in one tile will stop at the call to `tile_barrier::wait` before they continue execution. - -- You have access to the index of the thread relative to the entire `array_view` object and the index relative to the tile. By using the local index, you can make your code easier to read and debug. - -To take advantage of tiling in matrix multiplication, the algorithm must partition the matrix into tiles and then copy the tile data into `tile_static` variables for faster access. In this example, the matrix is partitioned into submatrices of equal size. The product is found by multiplying the submatrices. The two matrices and their product in this example are: - -![Diagram showing 4 by 4 matrix A.](../../parallel/amp/media/campmatrixatiled.png) - -![Diagram showing 4 by 4 matrix B.](../../parallel/amp/media/campmatrixbtiled.png) - -![Diagram showing result 4 by 4 product matrix.](../../parallel/amp/media/campmatrixproducttiled.png) - -The matrices are partitioned into four 2x2 matrices, which are defined as follows: - -![Diagram showing 4 by 4 matrix A partitioned into 2 by 2 sub matrices.](../../parallel/amp/media/campmatrixapartitioned.png) - -![Diagram showing 4 by 4 matrix B partitioned into 2 by 2 sub matrices.](../../parallel/amp/media/campmatrixbpartitioned.png) - -The product of A and B can now be written and calculated as follows: - -![Diagram showing 4 by 4 matrix A B partitioned into 2 by 2 sub matrices.](../../parallel/amp/media/campmatrixproductpartitioned.png) - -Because matrices `a` through `h` are 2x2 matrices, all of the products and sums of them are also 2x2 matrices. It also follows that the product of A and B is a 4x4 matrix, as expected. To quickly check the algorithm, calculate the value of the element in the first row, first column in the product. In the example, that would be the value of the element in the first row and first column of `ae + bg`. You only have to calculate the first column, first row of `ae` and `bg` for each term. That value for `ae` is `(1 * 1) + (2 * 5) = 11`. The value for `bg` is `(3 * 1) + (4 * 5) = 23`. The final value is `11 + 23 = 34`, which is correct. - -To implement this algorithm, the code: - -- Uses a `tiled_extent` object instead of an `extent` object in the `parallel_for_each` call. - -- Uses a `tiled_index` object instead of an `index` object in the `parallel_for_each` call. - -- Creates `tile_static` variables to hold the submatrices. - -- Uses the `tile_barrier::wait` method to stop the threads for the calculation of the products of the submatrices. - -### To multiply by using AMP and tiling - -1. In MatrixMultiply.cpp, add the following code before the `main` method. - - ```cpp - void MultiplyWithTiling() { - // The tile size is 2. - static const int TS = 2; - - // The raw data. - int aMatrix[] = { 1, 2, 3, 4, 5, 6, 7, 8, 1, 2, 3, 4, 5, 6, 7, 8 }; - int bMatrix[] = { 1, 2, 3, 4, 5, 6, 7, 8, 1, 2, 3, 4, 5, 6, 7, 8 }; - int productMatrix[] = { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 }; - - // Create the array_view objects. - array_view a(4, 4, aMatrix); - array_view b(4, 4, bMatrix); - array_view product(4, 4, productMatrix); - - // Call parallel_for_each by using 2x2 tiles. - parallel_for_each(product.extent.tile(), - [=] (tiled_index t_idx) restrict(amp) - { - // Get the location of the thread relative to the tile (row, col) - // and the entire array_view (rowGlobal, colGlobal). - int row = t_idx.local[0]; - int col = t_idx.local[1]; - int rowGlobal = t_idx.global[0]; - int colGlobal = t_idx.global[1]; - int sum = 0; - - // Given a 4x4 matrix and a 2x2 tile size, this loop executes twice for each thread. - // For the first tile and the first loop, it copies a into locA and e into locB. - // For the first tile and the second loop, it copies b into locA and g into locB. - for (int i = 0; i < 4; i += TS) { - tile_static int locA[TS][TS]; - tile_static int locB[TS][TS]; - locA[row][col] = a(rowGlobal, col + i); - locB[row][col] = b(row + i, colGlobal); - // The threads in the tile all wait here until locA and locB are filled. - t_idx.barrier.wait(); - - // Return the product for the thread. The sum is retained across - // both iterations of the loop, in effect adding the two products - // together, for example, a*e. - for (int k = 0; k < TS; k++) { - sum += locA[row][k] * locB[k][col]; - } - - // All threads must wait until the sums are calculated. If any threads - // moved ahead, the values in locA and locB would change. - t_idx.barrier.wait(); - // Now go on to the next iteration of the loop. - } - - // After both iterations of the loop, copy the sum to the product variable by using the global location. - product[t_idx.global] = sum; - }); - - // Copy the contents of product back to the productMatrix variable. - product.synchronize(); - - for (int row = 0; row <4; row++) { - for (int col = 0; col <4; col++) { - // The results are available from both the product and productMatrix variables. - //std::cout << productMatrix[row*3 + col] << " "; - std::cout << product(row, col) << " "; - } - std::cout << "\n"; - } - } - ``` - - This example is significantly different than the example without tiling. The code uses these conceptual steps: - 1. Copy the elements of tile[0,0] of `a` into `locA`. Copy the elements of tile[0,0] of `b` into `locB`. Notice that `product` is tiled, not `a` and `b`. Therefore, you use global indices to access `a, b`, and `product`. The call to `tile_barrier::wait` is essential. It stops all of the threads in the tile until both `locA` and `locB` are filled. - - 1. Multiply `locA` and `locB` and put the results in `product`. - - 1. Copy the elements of tile[0,1] of `a` into `locA`. Copy the elements of tile [1,0] of `b` into `locB`. - - 1. Multiply `locA` and `locB` and add them to the results that are already in `product`. - - 1. The multiplication of tile[0,0] is complete. - - 1. Repeat for the other four tiles. There is no indexing specifically for the tiles and the threads can execute in any order. As each thread executes, the `tile_static` variables are created for each tile appropriately and the call to `tile_barrier::wait` controls the program flow. - - 1. As you examine the algorithm closely, notice that each submatrix is loaded into a `tile_static` memory twice. That data transfer does take time. However, once the data is in `tile_static` memory, access to the data is much faster. Because calculating the products requires repeated access to the values in the submatrices, there is an overall performance gain. For each algorithm, experimentation is required to find the optimal algorithm and tile size. - - In the non-AMP and non-tile examples, each element of A and B is accessed four times from the global memory to calculate the product. In the tile example, each element is accessed twice from the global memory and four times from the `tile_static` memory. That is not a significant performance gain. However, if the A and B were 1024x1024 matrices and the tile size were 16, there would be a significant performance gain. In that case, each element would be copied into `tile_static` memory only 16 times and accessed from `tile_static` memory 1024 times. - -1. Modify the main method to call the `MultiplyWithTiling` method, as shown. - - ```cpp - int main() { - MultiplyWithOutAMP(); - MultiplyWithAMP(); - MultiplyWithTiling(); - getchar(); - } - ``` - -1. Press the **Ctrl**+**F5** keyboard shortcut to start debugging and verify that the output is correct. - -1. Press the **Space** bar to exit the application. - -## See also - -[C++ AMP (C++ Accelerated Massive Parallelism)](../../parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md)
-[Walkthrough: Debugging a C++ AMP Application](../../parallel/amp/walkthrough-debugging-a-cpp-amp-application.md) From 8cb8aa01e2be976b41af94711e0265dafbb8189c Mon Sep 17 00:00:00 2001 From: Saisang Cai Date: Wed, 1 Apr 2026 12:17:02 +0800 Subject: [PATCH 1727/1799] Remove amp from toc --- docs/parallel/toc.yml | 164 ------------------------------------------ 1 file changed, 164 deletions(-) diff --git a/docs/parallel/toc.yml b/docs/parallel/toc.yml index e140a198cc1..0543f1e5c49 100644 --- a/docs/parallel/toc.yml +++ b/docs/parallel/toc.yml @@ -3,170 +3,6 @@ items: href: ../parallel/parallel-programming-in-visual-cpp.md - name: Auto-parallelization and auto-vectorization href: ../parallel/auto-parallelization-and-auto-vectorization.md -- name: C++ Accelerated Massive Parallelism (AMP) - items: - - name: C++ AMP (C++ Accelerated Massive Parallelism) - href: ../parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md - - name: C++ AMP overview - href: ../parallel/amp/cpp-amp-overview.md - - name: Using tiles - href: ../parallel/amp/using-tiles.md - - name: Using C++ AMP in UWP apps - href: ../parallel/amp/using-cpp-amp-in-windows-store-apps.md - - name: 'Walkthrough: Matrix multiplication' - href: ../parallel/amp/walkthrough-matrix-multiplication.md - - name: 'Walkthrough: Debugging a C++ AMP application' - href: ../parallel/amp/walkthrough-debugging-a-cpp-amp-application.md - - name: Using lambdas, function objects, and restricted functions - href: ../parallel/amp/using-lambdas-function-objects-and-restricted-functions.md - - name: Graphics (C++ AMP) - href: ../parallel/amp/graphics-cpp-amp.md - - name: Using accelerator and accelerator_view objects - href: ../parallel/amp/using-accelerator-and-accelerator-view-objects.md - - name: Reference (C++ AMP) - items: - - name: Reference (C++ AMP) - href: ../parallel/amp/reference/reference-cpp-amp.md - - name: Concurrency namespace (C++ AMP) - items: - - name: Concurrency namespace (C++ AMP) - href: ../parallel/amp/reference/concurrency-namespace-cpp-amp.md - - name: Concurrency namespace functions (AMP) - href: ../parallel/amp/reference/concurrency-namespace-functions-amp.md - - name: Concurrency namespace enums (AMP) - href: ../parallel/amp/reference/concurrency-namespace-enums-amp.md - - name: Concurrency namespace operators (AMP) - href: ../parallel/amp/reference/concurrency-namespace-operators-amp.md - - name: Concurrency namespace constants (AMP) - href: ../parallel/amp/reference/concurrency-namespace-constants-amp.md - - name: accelerator class - href: ../parallel/amp/reference/accelerator-class.md - - name: accelerator_view class - href: ../parallel/amp/reference/accelerator-view-class.md - - name: accelerator_view_removed class - href: ../parallel/amp/reference/accelerator-view-removed-class.md - - name: array class - href: ../parallel/amp/reference/array-class.md - - name: array_view class - href: ../parallel/amp/reference/array-view-class.md - - name: completion_future class - href: ../parallel/amp/reference/completion-future-class.md - - name: extent class (C++ AMP) - href: ../parallel/amp/reference/extent-class.md - - name: index class - href: ../parallel/amp/reference/index-class.md - - name: invalid_compute_domain class - href: ../parallel/amp/reference/invalid-compute-domain-class.md - - name: out_of_memory class - href: ../parallel/amp/reference/out-of-memory-class.md - - name: runtime_exception class - href: ../parallel/amp/reference/runtime-exception-class.md - - name: tile_barrier class - href: ../parallel/amp/reference/tile-barrier-class.md - - name: tiled_extent class - href: ../parallel/amp/reference/tiled-extent-class.md - - name: tiled_index class - href: ../parallel/amp/reference/tiled-index-class.md - - name: uninitialized_object class - href: ../parallel/amp/reference/uninitialized-object-class.md - - name: unsupported_feature class - href: ../parallel/amp/reference/unsupported-feature-class.md - expanded: false - - name: Concurrency::direct3d Namespace - items: - - name: Concurrency::direct3d Namespace - href: ../parallel/amp/reference/concurrency-direct3d-namespace.md - - name: Concurrency::direct3d namespace functions (AMP) - href: ../parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md - - name: adopt_d3d_access_lock_t Structure - href: ../parallel/amp/reference/adopt-d3d-access-lock-t-structure.md - - name: scoped_d3d_access_lock class - href: ../parallel/amp/reference/scoped-d3d-access-lock-class.md - expanded: false - - name: Concurrency::fast_math Namespace - items: - - name: Concurrency::fast_math Namespace - href: ../parallel/amp/reference/concurrency-fast-math-namespace.md - - name: Concurrency::fast_math namespace functions - href: ../parallel/amp/reference/concurrency-fast-math-namespace-functions.md - expanded: false - - name: Concurrency::graphics Namespace - items: - - name: Concurrency::graphics Namespace - href: ../parallel/amp/reference/concurrency-graphics-namespace.md - - name: Concurrency::graphics::direct3d namespace - items: - - name: Concurrency::graphics::direct3d namespace - href: ../parallel/amp/reference/concurrency-graphics-direct3d-namespace.md - - name: Concurrency::graphics::direct3d namespace functions - href: ../parallel/amp/reference/concurrency-graphics-direct3d-namespace-functions.md - expanded: false - - name: Concurrency::graphics namespace functions - href: ../parallel/amp/reference/concurrency-graphics-namespace-functions.md - - name: Concurrency::graphics namespace enums - href: ../parallel/amp/reference/concurrency-graphics-namespace-enums.md - - name: double_2 class - href: ../parallel/amp/reference/double-2-class.md - - name: double_3 class - href: ../parallel/amp/reference/double-3-class.md - - name: double_4 class - href: ../parallel/amp/reference/double-4-class.md - - name: float_2 class - href: ../parallel/amp/reference/float-2-class.md - - name: float_3 class - href: ../parallel/amp/reference/float-3-class.md - - name: float_4 class - href: ../parallel/amp/reference/float-4-class.md - - name: int_2 class - href: ../parallel/amp/reference/int-2-class.md - - name: int_3 class - href: ../parallel/amp/reference/int-3-class.md - - name: int_4 class - href: ../parallel/amp/reference/int-4-class.md - - name: norm class - href: ../parallel/amp/reference/norm-class.md - - name: norm_2 class - href: ../parallel/amp/reference/norm-2-class.md - - name: norm_3 class - href: ../parallel/amp/reference/norm-3-class.md - - name: norm_4 class - href: ../parallel/amp/reference/norm-4-class.md - - name: sampler class - href: ../parallel/amp/reference/sampler-class.md - - name: short_vector Structure - href: ../parallel/amp/reference/short-vector-structure.md - - name: short_vector_traits Structure - href: ../parallel/amp/reference/short-vector-traits-structure.md - - name: texture class - href: ../parallel/amp/reference/texture-class.md - - name: texture_view class - href: ../parallel/amp/reference/texture-view-class.md - - name: writeonly_texture_view class - href: ../parallel/amp/reference/writeonly-texture-view-class.md - - name: uint_2 class - href: ../parallel/amp/reference/uint-2-class.md - - name: uint_3 class - href: ../parallel/amp/reference/uint-3-class.md - - name: uint_4 class - href: ../parallel/amp/reference/uint-4-class.md - - name: unorm class - href: ../parallel/amp/reference/unorm-class.md - - name: unorm_2 class - href: ../parallel/amp/reference/unorm-2-class.md - - name: unorm_3 class - href: ../parallel/amp/reference/unorm-3-class.md - - name: unorm_4 class - href: ../parallel/amp/reference/unorm-4-class.md - expanded: false - - name: Concurrency::precise_math namespace - items: - - name: Concurrency::precise_math namespace - href: ../parallel/amp/reference/concurrency-precise-math-namespace.md - - name: Concurrency::precise_math namespace functions - href: ../parallel/amp/reference/concurrency-precise-math-namespace-functions.md - expanded: false - expanded: false - expanded: false - name: Concurrency Runtime (ConcRT) items: - name: Concurrency Runtime From 5f15d6f2e55478416ec5fdf8b679c5cf884be7ec Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 10 Apr 2026 12:46:44 -0700 Subject: [PATCH 1728/1799] UUF fixes --- docs/build/walkthrough-build-debug-wsl2.md | 1 + .../reference/time-time32-time64.md | 4 +- ...-create-and-use-unique-ptr-instances_1.cpp | 49 +++++++++++++----- ...-create-and-use-unique-ptr-instances_2.cpp | 45 +++++++++++------ ...-create-and-use-unique-ptr-instances_3.cpp | 36 ++++++++----- ...-create-and-use-unique-ptr-instances_4.cpp | 20 +++++--- ...-to-create-and-use-unique-ptr-instances.md | 50 ++++++++++++++++--- 7 files changed, 152 insertions(+), 53 deletions(-) diff --git a/docs/build/walkthrough-build-debug-wsl2.md b/docs/build/walkthrough-build-debug-wsl2.md index 33e08ae4dcf..55f0a393600 100644 --- a/docs/build/walkthrough-build-debug-wsl2.md +++ b/docs/build/walkthrough-build-debug-wsl2.md @@ -27,6 +27,7 @@ CMake Presets integration in Visual Studio supports the WSL 2 toolset. To learn Install the tools necessary to build and debug on WSL 2. You'll install a recent version of CMake using Visual Studio's CMake binary deployment in a later step. 1. Install WSL and a WSL 2 distro by following the instructions at [Install WSL](/windows/wsl/install-win10). +1. In the Visual Studio installer, verify that **C++ CMake tools for Linux** is installed. To do that, choose **Modify** for your version of Visual Studio. Under the **Individual components** tab, search for **C++ CMake tools for Linux and Mac** and make sure it is selected and installed. This component is required for Visual Studio to detect your WSL installations. 1. Assuming your distro uses `apt` (this walkthrough uses Ubuntu), use the following commands to install the required build tools on your WSL 2 distro: ```bash diff --git a/docs/c-runtime-library/reference/time-time32-time64.md b/docs/c-runtime-library/reference/time-time32-time64.md index 1087f1997a6..8db058298e9 100644 --- a/docs/c-runtime-library/reference/time-time32-time64.md +++ b/docs/c-runtime-library/reference/time-time32-time64.md @@ -34,7 +34,9 @@ Returns the time as seconds elapsed since midnight, January 1, 1970, or -1 if th The **`time`** function returns the number of seconds elapsed since midnight (00:00:00), January 1, 1970, Coordinated Universal Time (UTC), according to the system clock. The return value is stored in the location given by *`destTime`*. This parameter may be `NULL`, in which case the return value isn't stored. -**`time`** is a wrapper for **`_time64`** and **`time_t`** is, by default, equivalent to **`__time64_t`**. If you need to force the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, you can define `_USE_32BIT_TIME_T`. We don't recommend `_USE_32BIT_TIME_T`, because your application may fail after January 18, 2038; the use of this macro isn't allowed on 64-bit platforms. +**`time_t`** is defined in `` and ``. It represents time as an integer count of seconds. It's equivalent to **`__time64_t`** by default, which is a 64-bit signed integer that supports dates through 23:59:59, December 31, 3000 UTC. If you need the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, define `_USE_32BIT_TIME_T`. We don't recommend `_USE_32BIT_TIME_T` because your application may fail after January 18, 2038. This macro isn't allowed on 64-bit platforms. + +**`time`** is a wrapper for **`_time64`**. > [!Note] > When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `time` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ diff --git a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_1.cpp b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_1.cpp index 3ca09b621c1..838fe5a5607 100644 --- a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_1.cpp +++ b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_1.cpp @@ -1,20 +1,43 @@ -unique_ptr SongFactory(const std::wstring& artist, const std::wstring& title) -{ - // Implicit move operation into the variable that stores the result. - return make_unique(artist, title); +// Compile with: cl /EHsc /std:c++17 + +#include +#include +#include + +struct Song { + std::string artist; + std::string title; + Song(const std::string& a, const std::string& t) : artist(a), title(t) { + std::cout << "Created: " << title << "\n"; + } + ~Song() { std::cout << "Destroyed: " << title << "\n"; } +}; + +// Returning a unique_ptr by value transfers ownership to the caller. +std::unique_ptr SongFactory(const std::string& artist, const std::string& title) { + return std::make_unique(artist, title); +} + +// Passing a unique_ptr by value transfers ownership to the function. +// The Song is automatically destroyed when the function exits. +void SingSong(std::unique_ptr song) { + std::cout << "Singing: " << song->title << " by " << song->artist << "\n"; } -void MakeSongs() -{ +int main() { // Create a new unique_ptr with a new object. - auto song = make_unique(L"Mr. Children", L"Namonaki Uta"); + auto song = std::make_unique("Mr. Children", "Namonaki Uta"); + std::cout << "song points to: " << song->title << "\n"; - // Use the unique_ptr. - vector titles = { song->title }; + // Move ownership from one unique_ptr to another. + std::unique_ptr song2 = std::move(song); + std::cout << "After move, song is " << (song ? "not null" : "null") << "\n"; + std::cout << "song2 points to: " << song2->title << "\n"; - // Move raw pointer from one unique_ptr to another. - unique_ptr song2 = std::move(song); + // Obtain unique_ptr from a factory function that returns by value. + auto song3 = SongFactory("Michael Jackson", "Beat It"); - // Obtain unique_ptr from function that returns by value. - auto song3 = SongFactory(L"Michael Jackson", L"Beat It"); + // Transfer ownership to a function. + SingSong(std::move(song3)); + std::cout << "After SingSong, song3 is " << (song3 ? "not null" : "null") << "\n"; } \ No newline at end of file diff --git a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_2.cpp b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_2.cpp index b1f6a067f95..862c0293cd8 100644 --- a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_2.cpp +++ b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_2.cpp @@ -1,17 +1,32 @@ -void SongVector() -{ - vector> songs; - - // Create a few new unique_ptr instances - // and add them to vector using implicit move semantics. - songs.push_back(make_unique(L"B'z", L"Juice")); - songs.push_back(make_unique(L"Namie Amuro", L"Funky Town")); - songs.push_back(make_unique(L"Kome Kome Club", L"Kimi ga Iru Dake de")); - songs.push_back(make_unique(L"Ayumi Hamasaki", L"Poker Face")); +// Compile with: cl /EHsc /std:c++17 - // Pass by const reference when possible to avoid copying. - for (const auto& song : songs) - { - wcout << L"Artist: " << song->artist << L" Title: " << song->title << endl; - } +#include +#include +#include +#include + +struct Song { + std::string artist; + std::string title; + Song(const std::string& a, const std::string& t) : artist(a), title(t) {} +}; + +int main() { + std::vector> songs; + + // Create unique_ptr instances and add them to the vector + // using implicit move semantics. + songs.push_back(std::make_unique("B'z", "Juice")); + songs.push_back(std::make_unique("Namie Amuro", "Funky Town")); + songs.push_back(std::make_unique("Kome Kome Club", "Kimi ga Iru Dake de")); + songs.push_back(std::make_unique("Ayumi Hamasaki", "Poker Face")); + + // Pass by const reference to avoid copying. + // Passing by value causes a compile error because + // the unique_ptr copy constructor is deleted. + for (const auto& song : songs) { + std::cout << "Artist: " << song->artist + << " Title: " << song->title << "\n"; + } + // The unique_ptr instances in the vector are automatically destroyed when the vector goes out of scope at the end of main() } \ No newline at end of file diff --git a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp index 29baefa191f..35b67cc059c 100644 --- a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp +++ b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp @@ -1,17 +1,29 @@ -class MyClass -{ -private: - // MyClass owns the unique_ptr. - unique_ptr factory; +// Compile with: cl /EHsc /std:c++17 + +#include +#include + +class Engine { public: + Engine() { std::cout << "Engine created\n"; } + ~Engine() { std::cout << "Engine destroyed\n"; } + void Run() { std::cout << "Engine running\n"; } +}; - // Initialize by using make_unique with ClassFactory default constructor. - MyClass() : factory (make_unique()) - { - } +class Car { +private: + // Car owns the unique_ptr. + std::unique_ptr engine; +public: + // Initialize by using make_unique in the member initializer list. + Car() : engine(std::make_unique()) {} - void MakeClass() - { - factory->DoSomething(); + void Start() { + engine->Run(); } }; + +int main() { + Car car; + car.Start(); +} \ No newline at end of file diff --git a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_4.cpp b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_4.cpp index c7d62f9ca60..4637f942998 100644 --- a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_4.cpp +++ b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_4.cpp @@ -1,9 +1,17 @@ +// Compile with: cl /EHsc /std:c++17 + +#include +#include + +int main() { // Create a unique_ptr to an array of 5 integers. - auto p = make_unique(5); + // The elements are value-initialized to 0. + auto p = std::make_unique(5); - // Initialize the array. - for (int i = 0; i < 5; ++i) - { + // Assign values to the array elements. + for (int i = 0; i < 5; ++i) { p[i] = i; - wcout << p[i] << endl; - } \ No newline at end of file + std::cout << p[i] << "\n"; + } + // The array is automatically deleted when p goes out of scope. +} \ No newline at end of file diff --git a/docs/cpp/how-to-create-and-use-unique-ptr-instances.md b/docs/cpp/how-to-create-and-use-unique-ptr-instances.md index b679190aeee..eeed4d64c8e 100644 --- a/docs/cpp/how-to-create-and-use-unique-ptr-instances.md +++ b/docs/cpp/how-to-create-and-use-unique-ptr-instances.md @@ -2,12 +2,11 @@ description: "Learn more about: How to: Create and use unique_ptr instances" title: "How to: Create and use unique_ptr instances" ms.custom: "how-to" -ms.date: "11/19/2018" -ms.assetid: 9a373030-e587-452f-b9a5-c5f9d58b7673 +ms.date: 04/10/2026 --- # How to: Create and use unique_ptr instances -A [unique_ptr](../standard-library/unique-ptr-class.md) does not share its pointer. It cannot be copied to another `unique_ptr`, passed by value to a function, or used in any C++ Standard Library algorithm that requires copies to be made. A `unique_ptr` can only be moved. This means that the ownership of the memory resource is transferred to another `unique_ptr` and the original `unique_ptr` no longer owns it. We recommend that you restrict an object to one owner, because multiple ownership adds complexity to the program logic. Therefore, when you need a smart pointer for a plain C++ object, use `unique_ptr`, and when you construct a `unique_ptr`, use the [make_unique](../standard-library/memory-functions.md#make_unique) helper function. +A [unique_ptr](../standard-library/unique-ptr-class.md) does not share its pointer. It cannot be copied to another `unique_ptr`, passed by value to a function, or used in any C++ Standard Library algorithm that requires copies to be made. A `unique_ptr` can only be moved. This means that the ownership of the memory resource is transferred to another `unique_ptr` and the original `unique_ptr` no longer owns it. We recommend that you restrict an object to one owner, because multiple ownership adds complexity. When you need a smart pointer for a plain C++ object, use `unique_ptr`, and when you construct a `unique_ptr`, use the [`make_unique`](../standard-library/memory-functions.md#make_unique) helper function. The following diagram illustrates the transfer of ownership between two `unique_ptr` instances. @@ -15,12 +14,26 @@ The following diagram illustrates the transfer of ownership between two `unique_ `unique_ptr` is defined in the `` header in the C++ Standard Library. It is exactly as efficient as a raw pointer and can be used in C++ Standard Library containers. The addition of `unique_ptr` instances to C++ Standard Library containers is efficient because the move constructor of the `unique_ptr` eliminates the need for a copy operation. +To use `unique_ptr` and `make_unique`, include the `` header. The following examples each compile and run as standalone programs. + ## Example 1 -The following example shows how to create `unique_ptr` instances and pass them between functions. +The following example shows how to create `unique_ptr` instances and pass them between functions. Returning a `unique_ptr` by value transfers ownership to the caller. Passing a `unique_ptr` by value to a function transfers ownership to the callee. [!code-cpp[stl_smart_pointers#210](codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_1.cpp)] +```output +Created: Namonaki Uta +song points to: Namonaki Uta +After move, song is null +song2 points to: Namonaki Uta +Created: Beat It +Singing: Beat It by Michael Jackson +Destroyed: Beat It +After SingSong, song3 is null +Destroyed: Namonaki Uta +``` + These examples demonstrate this basic characteristic of `unique_ptr`: it can be moved, but not copied. "Moving" transfers ownership to a new `unique_ptr` and resets the old `unique_ptr`. ## Example 2 @@ -29,7 +42,18 @@ The following example shows how to create `unique_ptr` instances and use them in [!code-cpp[stl_smart_pointers#211](codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_2.cpp)] -In the range for loop, notice that the `unique_ptr` is passed by reference. If you try to pass by value here, the compiler will throw an error because the `unique_ptr` copy constructor is deleted. +```output +Artist: B'z Title: Juice +Artist: Namie Amuro Title: Funky Town +Artist: Kome Kome Club Title: Kimi ga Iru Dake de +Artist: Ayumi Hamasaki Title: Poker Face +Destroyed: Juice +Destroyed: Funky Town +Destroyed: Kimi ga Iru Dake de +Destroyed: Poker Face +``` + +In the range for loop, notice that the `unique_ptr` is passed by reference. If you try to pass by value here, the compiler reports an error because the `unique_ptr` copy constructor is deleted. ## Example 3 @@ -37,12 +61,26 @@ The following example shows how to initialize a `unique_ptr` that is a class mem [!code-cpp[stl_smart_pointers#212](codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp)] +```output +Engine created +Engine running +Engine destroyed +``` + ## Example 4 -You can use [make_unique](../standard-library/memory-functions.md#make_unique) to create a `unique_ptr` to an array, but you cannot use `make_unique` to initialize the array elements. +You can use [make_unique](../standard-library/memory-functions.md#make_unique) to create a `unique_ptr` to an array. `make_unique(5)` creates a 5-element array that is value-initialized to zero. You can't pass individual element values to `make_unique`, so assign them after creation. [!code-cpp[stl_smart_pointers#213](codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_4.cpp)] +```output +0 +1 +2 +3 +4 +``` + For more examples, see [make_unique](../standard-library/memory-functions.md#make_unique). ## See also From 5863a513b276ca160f4b6a3a922c540761493a9f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 10 Apr 2026 12:58:07 -0700 Subject: [PATCH 1729/1799] acrolinx --- docs/build/walkthrough-build-debug-wsl2.md | 14 +++++++------- .../how-to-create-and-use-unique-ptr-instances.md | 7 ++++--- 2 files changed, 11 insertions(+), 10 deletions(-) diff --git a/docs/build/walkthrough-build-debug-wsl2.md b/docs/build/walkthrough-build-debug-wsl2.md index 55f0a393600..34a242b1a10 100644 --- a/docs/build/walkthrough-build-debug-wsl2.md +++ b/docs/build/walkthrough-build-debug-wsl2.md @@ -24,10 +24,10 @@ CMake Presets integration in Visual Studio supports the WSL 2 toolset. To learn ## Install the build tools -Install the tools necessary to build and debug on WSL 2. You'll install a recent version of CMake using Visual Studio's CMake binary deployment in a later step. +Install the tools necessary to build and debug on WSL 2. You install a recent version of CMake using Visual Studio's CMake binary deployment in a later step. 1. Install WSL and a WSL 2 distro by following the instructions at [Install WSL](/windows/wsl/install-win10). -1. In the Visual Studio installer, verify that **C++ CMake tools for Linux** is installed. To do that, choose **Modify** for your version of Visual Studio. Under the **Individual components** tab, search for **C++ CMake tools for Linux and Mac** and make sure it is selected and installed. This component is required for Visual Studio to detect your WSL installations. +1. In the Visual Studio installer, verify that **C++ CMake tools for Linux** is installed. To do that, choose **Modify** for your version of Visual Studio. Under the **Individual components** tab, search for **C++ CMake tools for Linux and Mac** and make sure it's selected and installed. This component is required for Visual Studio to detect your WSL installations. 1. Assuming your distro uses `apt` (this walkthrough uses Ubuntu), use the following commands to install the required build tools on your WSL 2 distro: ```bash @@ -35,7 +35,7 @@ Install the tools necessary to build and debug on WSL 2. You'll install a recent sudo apt install cmake g++ gdb make ninja-build rsync zip ``` - The `apt` commands above install: + Which installs: * A C++ compiler * `gdb` @@ -55,9 +55,9 @@ Visual Studio defines a CMake project as a folder with a `CMakeLists.txt` file a :::image type="content" source="media/vs2022-get-started.png" alt-text="Screenshot of the Visual Studio 2022 get started dialog box."::: The available options are: Clone a repository, Open a project or solution, Open a local folder, Create a new project, or Continue without code."::: -4. In the **Search for templates** textbox, type "cmake". Choose the **CMake Project** type and select **Next**. Give the project a name and location, and then select **Create**. +4. In the **Search for templates** textbox, type "cmake". Choose the **CMake Project** type and select **Next**. Give the project a name and location, and then select **Create**. -5. Enable Visual Studio's CMake Presets integration. Select **Tools** > **Options** > **CMake** > **General**. Select **Prefer using CMake Presets for configure, build, and test**, then select **OK**. Instead, you could have added a `CMakePresets.json` file to the root of the project. For more information, see [Enable CMake Presets integration](cmake-presets-vs.md#enable-cmakepresets-json-integration). +5. Enable Visual Studio's CMake Presets integration. Select **Tools** > **Options** > **CMake** > **General**. Select **Prefer using CMake Presets for configure, build, and test**, then select **OK**. Alternatively, you could add a `CMakePresets.json` file to the root of the project. For more information, see [Enable CMake Presets integration](cmake-presets-vs.md#enable-cmakepresets-json-integration). :::image type="complex" source="media/cmake-general-prefer-cmake-presets.png" alt-text="Screenshot of the Visual Studio project options. Cmake > General is selected."::: In the CMake configuration file group, 'Use CMake Presets if available, otherwise use CMakeSettings.json' is called out and is selected. @@ -70,7 +70,7 @@ Visual Studio defines a CMake project as a folder with a `CMakeLists.txt` file a :::image type="content" source="media/vs2022-target-system-dropdown.png" alt-text="Screenshot of the Visual Studio target system dropdown. WSL2: Ubuntu-20.04 is the selected."::: > [!NOTE] - > If Visual Studio starts to configure your project automatically, read step 11 to manage CMake binary deployment, and then continue to the step below. To customize this behavior, see [Modify automatic configuration and cache notifications](cmake-presets-vs.md#modify-automatic-configuration-and-cache-notifications). + > If Visual Studio starts to configure your project automatically, read step 11 to manage CMake binary deployment, and then continue to the following step. To customize this behavior, see [Modify automatic configuration and cache notifications](cmake-presets-vs.md#modify-automatic-configuration-and-cache-notifications). 8. Use the dropdown in the middle to select your active Configure Preset. Configure Presets tell Visual Studio how to invoke CMake and generate the underlying build system. In step 7, the active Configure Preset is the **linux-default** Preset created by Visual Studio. To create a custom Configure Preset, select **Manage Configurations…** For more information about Configure Presets, see [Select a Configure Preset](cmake-presets-vs.md#select-a-configure-preset) and [Edit Presets](cmake-presets-vs.md#edit-presets). @@ -134,7 +134,7 @@ If you have a MSBuild-based Linux project, then you can upgrade to the WSL 2 too :::image type="content" source="media/wsl-platform-toolset-selection.png" alt-text="Screenshot of a Visual Studio dropdown with Platform Toolset selected, and to the right, another dropdown with WSL2 Toolset selected."::: -If you're targeting a WSL 2 distribution and you don't want to use the WSL 2 toolset, then in the **Platform Toolset** dropdown, select the **GCC for Windows Subsystem for Linux** or **Clang for Windows Subsystem for Linux** toolset. If either of these toolsets are selected, Visual Studio doesn't maintain a copy of your source files in the WSL file system and instead accesses source files over the mounted Windows drive (`/mnt/`…). System headers are still automatically copied to the Windows file system to provide a native IntelliSense experience. Customize the headers that are included or excluded from this copy in **Property Pages** > **General**. +If you're targeting a WSL 2 distribution and you don't want to use the WSL 2 toolset, then in the **Platform Toolset** dropdown, select the **GCC for Windows Subsystem for Linux** or **Clang for Windows Subsystem for Linux** toolset. If either of these toolsets are selected, Visual Studio doesn't maintain a copy of your source files in the WSL file system, and instead accesses source files over the mounted Windows drive (`/mnt/`…). System headers are still automatically copied to the Windows file system to provide a native IntelliSense experience. Customize the headers that are included or excluded from this copy in **Property Pages** > **General**. In most cases, it's best to use the WSL 2 toolset with WSL 2 distributions because WSL 2 is slower when project files are stored in the Windows file system. To learn more, see [Comparing WSL 1 and WSL 2](/windows/wsl/compare-versions). diff --git a/docs/cpp/how-to-create-and-use-unique-ptr-instances.md b/docs/cpp/how-to-create-and-use-unique-ptr-instances.md index eeed4d64c8e..f0c566944c2 100644 --- a/docs/cpp/how-to-create-and-use-unique-ptr-instances.md +++ b/docs/cpp/how-to-create-and-use-unique-ptr-instances.md @@ -3,16 +3,17 @@ description: "Learn more about: How to: Create and use unique_ptr instances" title: "How to: Create and use unique_ptr instances" ms.custom: "how-to" ms.date: 04/10/2026 +ai-usage: ai-assisted --- # How to: Create and use unique_ptr instances -A [unique_ptr](../standard-library/unique-ptr-class.md) does not share its pointer. It cannot be copied to another `unique_ptr`, passed by value to a function, or used in any C++ Standard Library algorithm that requires copies to be made. A `unique_ptr` can only be moved. This means that the ownership of the memory resource is transferred to another `unique_ptr` and the original `unique_ptr` no longer owns it. We recommend that you restrict an object to one owner, because multiple ownership adds complexity. When you need a smart pointer for a plain C++ object, use `unique_ptr`, and when you construct a `unique_ptr`, use the [`make_unique`](../standard-library/memory-functions.md#make_unique) helper function. +A [unique_ptr](../standard-library/unique-ptr-class.md) doesn't share its pointer. It can't be copied to another `unique_ptr`, passed by value to a function, or used in any C++ Standard Library algorithm that requires copies to be made. A `unique_ptr` can only be moved. This means that the ownership of the memory resource is transferred to another `unique_ptr` and the original `unique_ptr` no longer owns it. We recommend that you restrict an object to one owner, because multiple ownership adds complexity. When you need a smart pointer for a plain C++ object, use `unique_ptr`, and when you construct a `unique_ptr`, use the [`make_unique`](../standard-library/memory-functions.md#make_unique) helper function. The following diagram illustrates the transfer of ownership between two `unique_ptr` instances. ![Diagram that shows moving the ownership of a unique pointer.](media/unique_ptr.png) -`unique_ptr` is defined in the `` header in the C++ Standard Library. It is exactly as efficient as a raw pointer and can be used in C++ Standard Library containers. The addition of `unique_ptr` instances to C++ Standard Library containers is efficient because the move constructor of the `unique_ptr` eliminates the need for a copy operation. +`unique_ptr` is defined in the `` header in the C++ Standard Library. It's exactly as efficient as a raw pointer and can be used in C++ Standard Library containers. The addition of `unique_ptr` instances to C++ Standard Library containers is efficient because the move constructor of the `unique_ptr` eliminates the need for a copy operation. To use `unique_ptr` and `make_unique`, include the `` header. The following examples each compile and run as standalone programs. @@ -69,7 +70,7 @@ Engine destroyed ## Example 4 -You can use [make_unique](../standard-library/memory-functions.md#make_unique) to create a `unique_ptr` to an array. `make_unique(5)` creates a 5-element array that is value-initialized to zero. You can't pass individual element values to `make_unique`, so assign them after creation. +You can use [make_unique](../standard-library/memory-functions.md#make_unique) to create a `unique_ptr` to an array. `make_unique(5)` creates a five element array that is value-initialized to zero. You can't pass individual element values to `make_unique`, so assign them after creation. [!code-cpp[stl_smart_pointers#213](codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_4.cpp)] From 65ea7664deeec9cd4e0650aefba6f124d35ff1a7 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 10 Apr 2026 13:41:31 -0700 Subject: [PATCH 1730/1799] draft changes --- docs/build/building-on-the-command-line.md | 2 +- docs/build/reference/zf.md | 2 +- .../c-runtime-library/reference/calloc-dbg.md | 6 +- ...printf-snprintf-l-snwprintf-snwprintf-l.md | 9 ++- .../reference/wcstombs-s-wcstombs-s-l.md | 6 +- docs/code-quality/c6387.md | 28 ++++++- ...-analysis-properties-for-c-cpp-projects.md | 3 + docs/cpp/abstract-classes-cpp.md | 10 ++- .../tool-errors/linker-tools-error-lnk1140.md | 6 +- .../linker-tools-errors-and-warnings.md | 1 + ...mpiler-warnings-that-are-off-by-default.md | 1 + .../binary-function-struct.md | 1 + docs/standard-library/identity-structure.md | 3 + docs/standard-library/scoped-lock-class.md | 79 +++++++++++++++++++ .../redistributing-visual-cpp-files.md | 2 +- 15 files changed, 141 insertions(+), 18 deletions(-) diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index 07501e59a26..5f7a2fdff45 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -17,7 +17,7 @@ You can build C and C++ applications on the command line by using tools that are ::: moniker range=">=msvc-160" -If you've installed Visual Studio and a C++ workload, you have all the command-line tools. For information on how to install C++ and Visual Studio, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). If you only want the command-line toolset, download the [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022). When you run the downloaded executable, it updates and runs the Visual Studio Installer. To install only the tools you need for C++ development, select the **Desktop development with C++** workload. You can select optional libraries and toolsets to include under **Installation details**. To build code by using the Visual Studio 2015, 2017, or 2019 toolsets, select the optional MSVC v140, v141, or v142 build tools. When you're satisfied with your selections, choose **Install**. +If you've installed Visual Studio and a C++ workload, you have all the command-line tools. For information on how to install C++ and Visual Studio, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). If you only want the command-line toolset, download the [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/). On the downloads page, expand the **Tools for Visual Studio** section to find the Build Tools download. When you run the downloaded executable, it updates and runs the Visual Studio Installer. To install only the tools you need for C++ development, select the **Desktop development with C++** workload. You can select optional libraries and toolsets to include under **Installation details**. To build code by using the Visual Studio 2015, 2017, or 2019 toolsets, select the optional MSVC v140, v141, or v142 build tools. When you're satisfied with your selections, choose **Install**. ::: moniker-end ::: moniker range="<=msvc-150" diff --git a/docs/build/reference/zf.md b/docs/build/reference/zf.md index d15547b2e8c..cb7b1c17ec3 100644 --- a/docs/build/reference/zf.md +++ b/docs/build/reference/zf.md @@ -19,7 +19,7 @@ The **/Zf** option enables compiler support for faster generation of PDB files w Because the **/Zf** option only applies to PDB generation, it requires the [/Zi](z7-zi-zi-debug-information-format.md) or [/ZI](z7-zi-zi-debug-information-format.md) option. -The **/Zf** option is available beginning in Visual Studio 2017 version 15.1, where it is off by default. Starting in Visual Studio 2017 version 15.7, this option is on by default when the **/Zi** or **/ZI** option is enabled. +The **/Zf** option is available beginning in Visual Studio 2017 version 15.1, where it is off by default. Starting in Visual Studio 2017 version 15.7, this option is on by default when the **/Zi** or **/ZI** option is enabled. To explicitly disable this option, use **/Zf-**. ### To set this compiler option in the Visual Studio development environment diff --git a/docs/c-runtime-library/reference/calloc-dbg.md b/docs/c-runtime-library/reference/calloc-dbg.md index fbff456b61b..3c513e24f87 100644 --- a/docs/c-runtime-library/reference/calloc-dbg.md +++ b/docs/c-runtime-library/reference/calloc-dbg.md @@ -68,9 +68,9 @@ For information about how memory blocks are allocated, initialized, and managed ## Requirements -| Routine | Required header | -|---|---| -| **`_calloc_dbg`** | \ | +| Routine | Required header | Required library | +|---|---|---| +| **`_calloc_dbg`** | \ | The debug C Runtime Library (for example, `ucrtd.lib`). Only available in debug builds. See [CRT library features](../crt-library-features.md). | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md b/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md index a9ceb9d7a60..f3760790f34 100644 --- a/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md +++ b/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md @@ -109,7 +109,7 @@ For more information, see [Format specification syntax: `printf` and `wprintf` f ## Return value -The number of characters that which would have been written to the buffer if `count` was ignored. The count doesn't include the terminating `NULL` character. +The number of characters that would have been written to the buffer if `count` was ignored. The count doesn't include the terminating `NULL` character. Let **`len`** be the length of the formatted data string, not including the terminating `NULL`.\ For all functions, if `len < count`, then **`len`** characters are stored in *`buffer`*, a null-terminator is appended, and the number of characters written, not including the terminating `NULL`, is returned. @@ -120,7 +120,12 @@ See [Behavior summary](#behavior-summary) for details. ## Remarks -Beginning with the UCRT in Visual Studio 2015 and Windows 10, **`snprintf`** is no longer identical to **`_snprintf`**. The **`snprintf`** behavior is now C99 standard conformant. The difference is that if you run out of buffer, `snprintf` null-terminates the end of the buffer and returns the number of characters that would have been required whereas `_snprintf` doesn't null-terminate the buffer and returns -1. Also, `_snprintf()` includes one more character in the output because it doesn't null-terminate the buffer. +Beginning with the UCRT in Visual Studio 2015 and Windows 10, **`snprintf`** is no longer identical to **`_snprintf`**. The **`snprintf`** behavior is now C99 standard conformant. The differences are: + +- **`snprintf`** always null-terminates the buffer (even when truncating), and returns the total number of characters that would have been written if the buffer were large enough (not counting the null-terminator). +- **`_snprintf`** does **not** null-terminate the buffer when the output is truncated, and returns **-1** when truncation occurs. + +Because `_snprintf` doesn't write a null-terminator when it truncates, it can fit one more data character into the same buffer size. However, the resulting string is not null-terminated, so you must handle termination yourself. - **`snprintf`** and the **`_snprintf`** family of functions format and store *`count`* or fewer characters in *`buffer`*. - **`snprintf`** always stores a terminating `NULL` character, truncating the output if necessary. diff --git a/docs/c-runtime-library/reference/wcstombs-s-wcstombs-s-l.md b/docs/c-runtime-library/reference/wcstombs-s-wcstombs-s-l.md index 058ddb9ccbf..0fa56ead86e 100644 --- a/docs/c-runtime-library/reference/wcstombs-s-wcstombs-s-l.md +++ b/docs/c-runtime-library/reference/wcstombs-s-wcstombs-s-l.md @@ -114,9 +114,9 @@ By default, this function's global state is scoped to the application. To change ## Requirements -| Routine | Required header | -|---|---| -| **`wcstombs_s`** | `` | +| Routine | Required header | Required library | +|---|---|---| +| **`wcstombs_s`** | `` | The Universal C Runtime Library (UCRT). Linked automatically when you build with the Visual C++ compiler. | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/code-quality/c6387.md b/docs/code-quality/c6387.md index fc082680d9d..16211974f1d 100644 --- a/docs/code-quality/c6387.md +++ b/docs/code-quality/c6387.md @@ -13,11 +13,16 @@ helpviewer_keywords: ["C6387"] This warning is raised if an annotated function parameter is being passed an unexpected value. For example, passing a potentially null value to a parameter that is marked with `_In_` annotation generates this warning. +This commonly happens when one function is annotated with `_Post_ _Null_` on its return value (meaning it may return null), and the result is then passed to another function that expects a non-null `_In_` parameter. To fix the issue, either change the first function's annotation to `_Post_ _Notnull_` if it truly never returns null, or add a null check before passing the value to the second function. + +> [!NOTE] +> The SAL annotations (`_Post_ _Null_`, `_Post_ _Notnull_`, `_In_`, etc.) are used on function declarations to describe the contract of the function's parameters and return values. They do not apply to local variable declarations. + Code analysis name: `INVALID_PARAM_VALUE_1` ## Example -The following code generates this warning because a null parameter is passed to `f(char *)`: +The following code generates this warning because the function `g` is annotated as potentially returning null (`_Post_ _Null_`), and the result is passed to `f`, which requires a non-null input (`_In_`): ```cpp #include @@ -33,7 +38,7 @@ int main() } ``` -To correct this warning, use the following code: +To correct this warning, you can change the annotation on `g` if it never actually returns null: ```cpp #include @@ -49,6 +54,25 @@ int main() } ``` +Alternatively, you can add a null check before passing the value: + +```cpp +#include + +_Post_ _Null_ char * g(); + +void f(_In_ char *pch); + +int main() +{ + char *pCh = g(); + if (pCh != nullptr) + { + f(pCh); + } +} +``` + ## See also [strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l](../c-runtime-library/reference/strlen-wcslen-mbslen-mbslen-l-mbstrlen-mbstrlen-l.md) diff --git a/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md b/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md index d4b1e95e891..ef67f41285e 100644 --- a/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md +++ b/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md @@ -18,6 +18,9 @@ ms.assetid: 7af52097-6d44-4785-9b9f-43b7a7d447d7 You can configure which rules the code analysis tool uses to analyze the code in each configuration of your project. In addition, you can direct code analysis to suppress warnings from code that was generated and added to your project by a third-party tool. +> [!NOTE] +> In recent versions of Visual Studio, the legacy **Code Analysis** property page in the project properties dialog may appear empty or show a deprecation notice. Use the individual settings described below to configure code analysis. For CMake projects, use `CMakeSettings.json` or `CMakePresets.json` instead. + ## Code Analysis Property Page The **Code Analysis** property page contains all code analysis configuration settings for an MSBuild project. To open the code analysis property page for a project in **Solution Explorer**, right-click the project and then click **Properties**. Next, expand **Configuration Properties** and select the **Code Analysis** tab. diff --git a/docs/cpp/abstract-classes-cpp.md b/docs/cpp/abstract-classes-cpp.md index dd7181e7171..af5343782dd 100644 --- a/docs/cpp/abstract-classes-cpp.md +++ b/docs/cpp/abstract-classes-cpp.md @@ -31,13 +31,15 @@ The only difference between this declaration and the previous one is that `Print Abstract classes can't be used for: -- Variables or member data +- Variables or member data (you can't declare a variable of an abstract class type) -- Argument types +- Argument types (you can't pass an abstract class by value as a function parameter) -- Function return types +- Function return types (a function can't return an abstract class by value) -- Types of explicit conversions +- Types of explicit conversions (you can't cast to an abstract class type) + +In each case, you can use pointers or references to the abstract class type instead. For example, a function can take `AbstractBase&` or `AbstractBase*` as a parameter, and you can declare pointers or references of the abstract class type. If the constructor for an abstract class calls a pure virtual function, either directly or indirectly, the result is undefined. However, constructors and destructors for abstract classes can call other member functions. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md index 32776a589dc..8bbcbead89f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md @@ -11,7 +11,9 @@ helpviewer_keywords: ["LNK1140"] ## Remarks -The project contains more than 4096 modules. +The project exceeds the maximum number of modules allowed in a program database (PDB) file. This limit was originally 4,096 modules and was later increased to 65,535. + +This error can also occur when other PDB size limits are exceeded, such as very large symbol tables or an excessive number of type records. ### To fix by using the following possible solutions @@ -20,3 +22,5 @@ The project contains more than 4096 modules. 1. Compile some modules without debugging information. 1. Reduce the number of modules. + +1. Split your project into multiple smaller libraries or DLLs. diff --git a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md index 102d426b6e8..1e2d72eaa4a 100644 --- a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md @@ -25,6 +25,7 @@ The linker tools LINK, LIB, DUMPBIN, and EDITBIN share a common executable that | [Linker Tools Error LNK1120](linker-tools-error-lnk1120.md) | *number* unresolved externals | | [Linker Tools Error LNK1123](linker-tools-error-lnk1123.md) | failure during conversion to COFF: file invalid or corrupt | | [Linker Tools Error LNK1127](linker-tools-error-lnk1127.md) | library is corrupt | +| Linker Tools Error LNK1131 | no library specified | | [Linker Tools Error LNK1136](linker-tools-error-lnk1136.md) | invalid or corrupt file | | [Linker Tools Error LNK1140](linker-tools-error-lnk1140.md) | too many modules for program database; link with /PDB:NONE | | [Linker Tools Error LNK1141](linker-tools-error-lnk1141.md) | failure during build of exports file | diff --git a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md index 04ffb783279..e09e8a00d50 100644 --- a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md +++ b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md @@ -101,6 +101,7 @@ The following warnings are turned off by default in Visual Studio 2015 and later | [C4686](../error-messages/compiler-warnings/compiler-warning-level-3-c4686.md) (level 3) | '*user-defined type*': possible change in behavior, change in UDT return calling convention | | [C4692](../error-messages/compiler-warnings/compiler-warning-level-1-c4692.md) (level 1) | '*function*': signature of non-private member contains assembly private native type '*native_type*' | | [C4710](../error-messages/compiler-warnings/compiler-warning-level-4-c4710.md) (level 4) | '*function*': function not inlined | +| [C4711](../error-messages/compiler-warnings/compiler-warning-level-1-c4711.md) (level 1) | function '*function*' selected for inline expansion | | [C4738](../error-messages/compiler-warnings/compiler-warning-level-3-c4738.md) (level 3) | storing 32-bit float result in memory, possible loss of performance | | [C4746](../error-messages/compiler-warnings/compiler-warning-c4746.md) | volatile access of '*expression*' is subject to /volatile:\ setting; consider using __iso_volatile_load/store intrinsic functions | | C4749 (level 4) | conditionally supported: offsetof applied to non-standard-layout type '*type*' | diff --git a/docs/standard-library/binary-function-struct.md b/docs/standard-library/binary-function-struct.md index 719614bb1a7..510df3fc07f 100644 --- a/docs/standard-library/binary-function-struct.md +++ b/docs/standard-library/binary-function-struct.md @@ -13,6 +13,7 @@ An empty base struct that defines types that may be inherited by derived classes ## Syntax ```cpp +template struct binary_function { typedef Arg1 first_argument_type; typedef Arg2 second_argument_type; diff --git a/docs/standard-library/identity-structure.md b/docs/standard-library/identity-structure.md index bfb04dac3b2..0214efd578b 100644 --- a/docs/standard-library/identity-structure.md +++ b/docs/standard-library/identity-structure.md @@ -10,6 +10,9 @@ ms.assetid: 990756fd-7969-4b39-ad7e-0878e8dac8fd A struct that provides a type definition as the template parameter. +> [!NOTE] +> This Microsoft-specific `identity` structure from `` is deprecated and may not be available in all versions of Visual Studio. In C++20 and later, use `std::identity` from [``](functional.md) instead, which is the standard-conforming equivalent. + ## Syntax ```cpp diff --git a/docs/standard-library/scoped-lock-class.md b/docs/standard-library/scoped-lock-class.md index 42b35183393..45c76d8ff0f 100644 --- a/docs/standard-library/scoped-lock-class.md +++ b/docs/standard-library/scoped-lock-class.md @@ -6,6 +6,8 @@ f1_keywords: ["mutex/std::scoped_lock"] --- # scoped_lock Class +The `scoped_lock` class is an RAII (Resource Acquisition Is Initialization) wrapper that acquires one or more mutexes on construction and releases them on destruction. When multiple mutexes are provided, they are locked using a deadlock-avoidance algorithm (equivalent to `std::lock`), which prevents deadlocks regardless of the order in which different threads lock the same set of mutexes. Introduced in C++17. + ## Syntax ```cpp @@ -19,3 +21,80 @@ class scoped_lock { scoped_lock& operator=(const scoped_lock&) = delete; }; ``` + +## Remarks + +The `scoped_lock` class manages locking and unlocking of one or more mutexes throughout a scope. When you create a `scoped_lock` object, it acquires ownership of the mutexes passed to it. When the `scoped_lock` object is destroyed (for example, when it goes out of scope), the mutexes are released. This ensures that mutexes are always properly released, even if an exception is thrown. + +If you need to lock only a single mutex, consider using [`lock_guard`](lock-guard-class.md) or [`unique_lock`](unique-lock-class.md). Use `scoped_lock` when you need to lock multiple mutexes simultaneously without risk of deadlock. + +### Constructors + +| Constructor | Description | +|---|---| +| `scoped_lock(MutexTypes&... m)` | Constructs a `scoped_lock` object and locks all the supplied mutexes. If multiple mutexes are supplied, they're locked using a deadlock-avoidance algorithm. | +| `scoped_lock(MutexTypes&... m, adopt_lock_t)` | Constructs a `scoped_lock` object and adopts ownership of the supplied mutexes, which must already be locked by the calling thread. | + +### Destructor + +| Destructor | Description | +|---|---| +| `~scoped_lock()` | Destroys the `scoped_lock` object and releases all owned mutexes. | + +## Example + +```cpp +#include +#include +#include +#include + +std::mutex mutex1; +std::mutex mutex2; +int shared_data1 = 0; +int shared_data2 = 0; + +void update_both(int iterations) +{ + for (int i = 0; i < iterations; ++i) + { + // Lock both mutexes simultaneously without risk of deadlock + std::scoped_lock lock(mutex1, mutex2); + ++shared_data1; + ++shared_data2; + } +} + +int main() +{ + std::vector threads; + for (int i = 0; i < 4; ++i) + { + threads.emplace_back(update_both, 1000); + } + + for (auto& t : threads) + { + t.join(); + } + + std::cout << "shared_data1: " << shared_data1 << '\n'; + std::cout << "shared_data2: " << shared_data2 << '\n'; + // Output: + // shared_data1: 4000 + // shared_data2: 4000 +} +``` + +## Requirements + +**Header:** \ + +**Namespace:** std + +## See also + +[Header files reference](../standard-library/header-files-reference.md)\ +[`lock_guard` Class](lock-guard-class.md)\ +[`unique_lock` Class](unique-lock-class.md)\ +[``](mutex.md) diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index afeae969425..c9ab8d102c5 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -68,7 +68,7 @@ The version number is stored in the `REG_SZ` string value `Version` and also in The Visual C++ Redistributable supports several command-line options. The `/?`, `/h`, or `/help` options display a dialog that lists the available options. You can specify `/install` to install, `/repair` to repair, or `/uninstall` to uninstall the Redistributable. The `/layout` option copies the complete contents of the Redistributable in the current directory. -By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can specify the `/passive` option, which displays progress but doesn't otherwise require user interaction. You can also specify a `/quiet` option, which doesn't display a user interface or require any user interaction. The `/norestart` option suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. You can use `/log filename.txt` to log to a specific file. +By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can specify the `/passive` option, which displays a progress bar but doesn't otherwise require user interaction (however, a license acceptance dialog may still appear if the Redistributable hasn't been installed before). You can also specify a `/quiet` option, which doesn't display a user interface or require any user interaction, including no license dialog. Use `/quiet` for fully unattended installations. The `/norestart` option suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. You can use `/log filename.txt` to log to a specific file. This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction or a restart: From 88b555b4d0c978c596fb357ae4ee67424a27da46 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 10 Apr 2026 13:45:19 -0700 Subject: [PATCH 1731/1799] fix numbering --- docs/build/walkthrough-build-debug-wsl2.md | 26 +++++++++++----------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/build/walkthrough-build-debug-wsl2.md b/docs/build/walkthrough-build-debug-wsl2.md index 34a242b1a10..ad9e42efd9c 100644 --- a/docs/build/walkthrough-build-debug-wsl2.md +++ b/docs/build/walkthrough-build-debug-wsl2.md @@ -50,57 +50,57 @@ This walkthrough uses GCC and Ninja on Ubuntu. And Visual Studio 2022 version 17 Visual Studio defines a CMake project as a folder with a `CMakeLists.txt` file at the project root. In this walkthrough, you create a new CMake project by using the Visual Studio **CMake Project** template: -3. From the Visual Studio **Get started** screen, select **Create a new project**. +1. From the Visual Studio **Get started** screen, select **Create a new project**. :::image type="content" source="media/vs2022-get-started.png" alt-text="Screenshot of the Visual Studio 2022 get started dialog box."::: The available options are: Clone a repository, Open a project or solution, Open a local folder, Create a new project, or Continue without code."::: -4. In the **Search for templates** textbox, type "cmake". Choose the **CMake Project** type and select **Next**. Give the project a name and location, and then select **Create**. +1. In the **Search for templates** textbox, type "cmake". Choose the **CMake Project** type and select **Next**. Give the project a name and location, and then select **Create**. -5. Enable Visual Studio's CMake Presets integration. Select **Tools** > **Options** > **CMake** > **General**. Select **Prefer using CMake Presets for configure, build, and test**, then select **OK**. Alternatively, you could add a `CMakePresets.json` file to the root of the project. For more information, see [Enable CMake Presets integration](cmake-presets-vs.md#enable-cmakepresets-json-integration). +1. Enable Visual Studio's CMake Presets integration. Select **Tools** > **Options** > **CMake** > **General**. Select **Prefer using CMake Presets for configure, build, and test**, then select **OK**. Alternatively, you could add a `CMakePresets.json` file to the root of the project. For more information, see [Enable CMake Presets integration](cmake-presets-vs.md#enable-cmakepresets-json-integration). :::image type="complex" source="media/cmake-general-prefer-cmake-presets.png" alt-text="Screenshot of the Visual Studio project options. Cmake > General is selected."::: In the CMake configuration file group, 'Use CMake Presets if available, otherwise use CMakeSettings.json' is called out and is selected. :::image-end::: -6. To activate the integration: from the main menu, select **File** > **Close Folder**. The **Get started** page appears. Under **Open recent**, select the folder you just closed to reopen the folder. +1. To activate the integration: from the main menu, select **File** > **Close Folder**. The **Get started** page appears. Under **Open recent**, select the folder you just closed to reopen the folder. -7. There are three dropdowns across the Visual Studio main menu bar. Use the dropdown on the left to select your active target system. This is the system where CMake is invoked to configure and build the project. Visual Studio queries for WSL installations with `wsl -l -v`. In the following image, **WSL2: Ubuntu-20.04** is shown selected as the **Target System**. +1. There are three dropdowns across the Visual Studio main menu bar. Use the dropdown on the left to select your active target system. This is the system where CMake is invoked to configure and build the project. Visual Studio queries for WSL installations with `wsl -l -v`. In the following image, **WSL2: Ubuntu-20.04** is shown selected as the **Target System**. :::image type="content" source="media/vs2022-target-system-dropdown.png" alt-text="Screenshot of the Visual Studio target system dropdown. WSL2: Ubuntu-20.04 is the selected."::: > [!NOTE] > If Visual Studio starts to configure your project automatically, read step 11 to manage CMake binary deployment, and then continue to the following step. To customize this behavior, see [Modify automatic configuration and cache notifications](cmake-presets-vs.md#modify-automatic-configuration-and-cache-notifications). -8. Use the dropdown in the middle to select your active Configure Preset. Configure Presets tell Visual Studio how to invoke CMake and generate the underlying build system. In step 7, the active Configure Preset is the **linux-default** Preset created by Visual Studio. To create a custom Configure Preset, select **Manage Configurations…** For more information about Configure Presets, see [Select a Configure Preset](cmake-presets-vs.md#select-a-configure-preset) and [Edit Presets](cmake-presets-vs.md#edit-presets). +1. Use the dropdown in the middle to select your active Configure Preset. Configure Presets tell Visual Studio how to invoke CMake and generate the underlying build system. In step 7, the active Configure Preset is the **linux-default** Preset created by Visual Studio. To create a custom Configure Preset, select **Manage Configurations…** For more information about Configure Presets, see [Select a Configure Preset](cmake-presets-vs.md#select-a-configure-preset) and [Edit Presets](cmake-presets-vs.md#edit-presets). :::image type="content" source="media/vs2022-ActivePresetDropdown.png" alt-text="Screenshot of the Visual Studio active configure preset dropdown. Manage Configurations... is selected."::: -9. Use the dropdown on the right to select your active Build Preset. Build Presets tell Visual Studio how to invoke build. In the illustration for step 7, the active Build Preset is the **Default** Build Preset created by Visual Studio. For more information about Build Presets, see [Select a Build Preset](cmake-presets-vs.md#select-a-build-preset). +1. Use the dropdown on the right to select your active Build Preset. Build Presets tell Visual Studio how to invoke build. In the illustration for step 7, the active Build Preset is the **Default** Build Preset created by Visual Studio. For more information about Build Presets, see [Select a Build Preset](cmake-presets-vs.md#select-a-build-preset). -10. Configure the project on WSL 2. If project generation doesn't start automatically, then manually invoke configure with **Project** > **Configure** *project-name* +1. Configure the project on WSL 2. If project generation doesn't start automatically, then manually invoke configure with **Project** > **Configure** *project-name* :::image type="content" source="media/vs2022-project-configure.png" alt-text="Screenshot of the Visual Studio project configure dropdown. Configure CMakeProject is selected."::: -11. If you don't have a supported version of CMake installed on your WSL 2 distro, then Visual Studio prompts you beneath the main menu ribbon to deploy a recent version of CMake. Select **Yes** to deploy CMake binaries to your WSL 2 distro. +1. If you don't have a supported version of CMake installed on your WSL 2 distro, then Visual Studio prompts you beneath the main menu ribbon to deploy a recent version of CMake. Select **Yes** to deploy CMake binaries to your WSL 2 distro. :::image type="complex" source="media/vs2022-supported-cmake-not-present-prompt.png" alt-text="Screenshot of a prompt beneath the Visual Studio toolbar"::: The user is prompted whether to install the latest C Make binaries from C make . org because the supported C Make version isn't installed." :::image-end::: -12. Confirm that the configure step completed and that you can see the **CMake generation finished** message in the **Output** window under the **CMake** pane. Build files are written to a directory in the WSL 2 distro's file system. +1. Confirm that the configure step completed and that you can see the **CMake generation finished** message in the **Output** window under the **CMake** pane. Build files are written to a directory in the WSL 2 distro's file system. :::image type="content" source="media/vs-output-window-cmake-generation.png" alt-text="Screenshot of the Visual Studio Output window. It contains messages generated during the configure step, including that C Make generation is complete."::: -13. Select the active debug target. The debug dropdown menu lists all the CMake targets available to the project. +1. Select the active debug target. The debug dropdown menu lists all the CMake targets available to the project. :::image type="content" source="media/vs-debug-dropdown-menu-cmake.png" alt-text="Screenshot of the Visual Studio debug dropdown menu. CMakeProject is selected."::: -14. Expand the project subfolder in the **Solution Explorer**. In the `CMakeProject.cpp` file, set a breakpoint in `main()`. You can also navigate to CMake targets view by selecting the View Picker button in the **Solution Explorer**, highlighted in following screenshot: +1. Expand the project subfolder in the **Solution Explorer**. In the `CMakeProject.cpp` file, set a breakpoint in `main()`. You can also navigate to CMake targets view by selecting the View Picker button in the **Solution Explorer**, highlighted in following screenshot: :::image type="content" source="media/solution-explorer-switch-view.png" alt-text="Screenshot of the Visual Studio solution explorer showing the button to switch views. It's located to the right of the home button."::: -15. Select **Debug** > **Start**, or press **F5**. Your project builds, the executable launches on your WSL 2 distro, and Visual Studio halts execution at the breakpoint. The output of your program (in this case, `"Hello CMake."`) is visible in the Linux Console Window: +1. Select **Debug** > **Start**, or press **F5**. Your project builds, the executable launches on your WSL 2 distro, and Visual Studio halts execution at the breakpoint. The output of your program (in this case, `"Hello CMake."`) is visible in the Linux Console Window: :::image type="complex" source="media/walkthrough-build-debug-wsl2-breakpoint.png" alt-text="Screenshot of a running hello world program."::: The Visual Studio Linux console window displays the output of the program: 'Hello C Make.' The editor window shows the hello world program. Execution stopped at a breakpoint on the line that says return 0;." From 4a10187b5a2f70b051222ad4a21e1f76dc7def0f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 10 Apr 2026 19:16:12 -0700 Subject: [PATCH 1732/1799] draft updates --- .../c-runtime-library/reference/calloc-dbg.md | 2 +- ...printf-snprintf-l-snwprintf-snwprintf-l.md | 4 +- .../reference/wcstombs-s-wcstombs-s-l.md | 2 +- docs/code-quality/c6387.md | 52 +++++++--- .../tool-errors/linker-tools-error-lnk1140.md | 7 +- docs/standard-library/identity-structure.md | 94 ++++++++++++++++--- docs/standard-library/scoped-lock-class.md | 21 +++-- 7 files changed, 134 insertions(+), 48 deletions(-) diff --git a/docs/c-runtime-library/reference/calloc-dbg.md b/docs/c-runtime-library/reference/calloc-dbg.md index 3c513e24f87..1b02d2cf193 100644 --- a/docs/c-runtime-library/reference/calloc-dbg.md +++ b/docs/c-runtime-library/reference/calloc-dbg.md @@ -70,7 +70,7 @@ For information about how memory blocks are allocated, initialized, and managed | Routine | Required header | Required library | |---|---|---| -| **`_calloc_dbg`** | \ | The debug C Runtime Library (for example, `ucrtd.lib`). Only available in debug builds. See [CRT library features](../crt-library-features.md). | +| **`_calloc_dbg`** | `` | The debug C Runtime Library (for example, `ucrtd.lib`). Only available in debug builds. For information about Microsoft C runtime library `.lib` files, see [CRT library features](../crt-library-features.md). | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md b/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md index f3760790f34..ee4a0b52726 100644 --- a/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md +++ b/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md @@ -123,9 +123,9 @@ See [Behavior summary](#behavior-summary) for details. Beginning with the UCRT in Visual Studio 2015 and Windows 10, **`snprintf`** is no longer identical to **`_snprintf`**. The **`snprintf`** behavior is now C99 standard conformant. The differences are: - **`snprintf`** always null-terminates the buffer (even when truncating), and returns the total number of characters that would have been written if the buffer were large enough (not counting the null-terminator). -- **`_snprintf`** does **not** null-terminate the buffer when the output is truncated, and returns **-1** when truncation occurs. +- **`_snprintf`** doesn't null-terminate the buffer when the output is truncated, and returns `-1` when truncation occurs. -Because `_snprintf` doesn't write a null-terminator when it truncates, it can fit one more data character into the same buffer size. However, the resulting string is not null-terminated, so you must handle termination yourself. +Because `_snprintf` doesn't write a null-terminator when it truncates, it can fit one more character into the same buffer size. However, the resulting string is not null-terminated, so you must handle termination yourself. - **`snprintf`** and the **`_snprintf`** family of functions format and store *`count`* or fewer characters in *`buffer`*. - **`snprintf`** always stores a terminating `NULL` character, truncating the output if necessary. diff --git a/docs/c-runtime-library/reference/wcstombs-s-wcstombs-s-l.md b/docs/c-runtime-library/reference/wcstombs-s-wcstombs-s-l.md index 0fa56ead86e..aed6aa514a8 100644 --- a/docs/c-runtime-library/reference/wcstombs-s-wcstombs-s-l.md +++ b/docs/c-runtime-library/reference/wcstombs-s-wcstombs-s-l.md @@ -116,7 +116,7 @@ By default, this function's global state is scoped to the application. To change | Routine | Required header | Required library | |---|---|---| -| **`wcstombs_s`** | `` | The Universal C Runtime Library (UCRT). Linked automatically when you build with the Visual C++ compiler. | +| **`wcstombs_s`** | `` | ucrt.lib (the Universal C Runtime Library) | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/code-quality/c6387.md b/docs/code-quality/c6387.md index 16211974f1d..ab1c36f2927 100644 --- a/docs/code-quality/c6387.md +++ b/docs/code-quality/c6387.md @@ -1,7 +1,7 @@ --- title: "Warning C6387" description: "Learn more about: Warning C6387" -ms.date: 11/04/2016 +ms.date: 04/10/2026 f1_keywords: ["C6387", "INVALID_PARAM_VALUE_1", "__WARNING_INVALID_PARAM_VALUE_1"] helpviewer_keywords: ["C6387"] --- @@ -16,7 +16,7 @@ This warning is raised if an annotated function parameter is being passed an une This commonly happens when one function is annotated with `_Post_ _Null_` on its return value (meaning it may return null), and the result is then passed to another function that expects a non-null `_In_` parameter. To fix the issue, either change the first function's annotation to `_Post_ _Notnull_` if it truly never returns null, or add a null check before passing the value to the second function. > [!NOTE] -> The SAL annotations (`_Post_ _Null_`, `_Post_ _Notnull_`, `_In_`, etc.) are used on function declarations to describe the contract of the function's parameters and return values. They do not apply to local variable declarations. +> The SAL annotations (`_Post_ _Null_`, `_Post_ _Notnull_`, `_In_`, and so on) are used on function declarations to describe the contract of the function's parameters and return values. They do not apply to local variable declarations. Code analysis name: `INVALID_PARAM_VALUE_1` @@ -26,14 +26,21 @@ The following code generates this warning because the function `g` is annotated ```cpp #include +#include -_Post_ _Null_ char * g(); +_Post_ _Null_ char* g() +{ + return nullptr; +} -void f(_In_ char *pch); +void f(_In_ char* pch) +{ + printf("%s\n", pch);; +} int main() { - char *pCh = g(); + char* pCh = g(); f(pCh); // Warning C6387 } ``` @@ -42,15 +49,23 @@ To correct this warning, you can change the annotation on `g` if it never actual ```cpp #include +#include -_Post_ _Notnull_ char * g(); +_Post_ _Notnull_ char* g() +{ + static char buf[] = "hello"; + return buf; +} -void f(_In_ char *pch); +void f(_In_ char* pch) +{ + printf("%s\n", pch); +} int main() { - char *pCh = g(); - f(pCh); + char* pCh = g(); + f(pCh); // No warning C6387 } ``` @@ -58,21 +73,28 @@ Alternatively, you can add a null check before passing the value: ```cpp #include +#include -_Post_ _Null_ char * g(); - -void f(_In_ char *pch); +_Post_ _Null_ char* g() +{ + return nullptr; +} + +void f(_In_ char* pch) +{ + printf("%s\n", pch); +} int main() { - char *pCh = g(); + char* pCh = g(); if (pCh != nullptr) { - f(pCh); + f(pCh); // No warning C6387 } } ``` ## See also -[strlen, wcslen, _mbslen, _mbslen_l, _mbstrlen, _mbstrlen_l](../c-runtime-library/reference/strlen-wcslen-mbslen-mbslen-l-mbstrlen-mbstrlen-l.md) +[`strlen`, `wcslen`, `_mbslen`, `_mbslen_l`, `_mbstrlen`, `_mbstrlen_l`](../c-runtime-library/reference/strlen-wcslen-mbslen-mbslen-l-mbstrlen-mbstrlen-l.md) diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md index 8bbcbead89f..28bd6c168d8 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md @@ -11,16 +11,13 @@ helpviewer_keywords: ["LNK1140"] ## Remarks -The project exceeds the maximum number of modules allowed in a program database (PDB) file. This limit was originally 4,096 modules and was later increased to 65,535. +The project exceeds the maximum number of modules allowed in a program database (PDB) file. This limit was originally 4,096 modules and was later increased to 65,533. -This error can also occur when other PDB size limits are exceeded, such as very large symbol tables or an excessive number of type records. +This error can also occur when other PDB size limits are exceeded, such as too many symbols or an excessive number of types. ### To fix by using the following possible solutions 1. Relink using [/PDB:NONE](../../build/reference/pdb-use-program-database.md). - 1. Compile some modules without debugging information. - 1. Reduce the number of modules. - 1. Split your project into multiple smaller libraries or DLLs. diff --git a/docs/standard-library/identity-structure.md b/docs/standard-library/identity-structure.md index 0214efd578b..b337411706c 100644 --- a/docs/standard-library/identity-structure.md +++ b/docs/standard-library/identity-structure.md @@ -4,31 +4,95 @@ title: "identity Structure" ms.date: "11/04/2016" f1_keywords: ["utility/std::identity"] helpviewer_keywords: ["identity class", "identity structure"] -ms.assetid: 990756fd-7969-4b39-ad7e-0878e8dac8fd +ai-usage: ai-assisted --- -# identity Structure - -A struct that provides a type definition as the template parameter. +# `identity` Structure > [!NOTE] -> This Microsoft-specific `identity` structure from `` is deprecated and may not be available in all versions of Visual Studio. In C++20 and later, use `std::identity` from [``](functional.md) instead, which is the standard-conforming equivalent. +> There's a Microsoft-specific `identity` structure from `` that is deprecated and isn't available in later versions of Visual Studio. For C++20 and later, use `std::identity` from [``](functional.md) instead, which is the standard-conforming equivalent described below. + +## `std::identity` (C++20) + +`std::identity` (introduced in C++20) is a function object whose `operator()` returns its argument unchanged. -## Syntax +Many standard library APIs take a callable argument such as a projection or transformation function. If you need to pass a callable but don't want to change the data, pass `std::identity`. This is common in ranges algorithms. Most `` ranges overloads have a projection parameter that defaults to `std::identity{}`. + +### Syntax ```cpp -struct identity { - typedef Type type; - Type operator()(const Type& left) const; +struct identity +{ + template + _NODISCARD constexpr T&& operator()(T&& t) const noexcept; + using is_transparent = int; }; ``` -### Parameters +### Remarks -*left*\ -The value to identify. +The `is_transparent` member type is a tag that marks `std::identity` as a transparent function object. Its presence indicates that algorithms can perform comparisons or projections without needing to convert types to a common form first. This is useful for associative containers and algorithms that support heterogeneous lookup, allowing them to compare different types directly without constructing temporary objects. -## Remarks +### Example -The class contains the public type definition `type`, which is the same as the template parameter Type. It is used in conjunction with template function [forward](../standard-library/utility-functions.md#forward) to ensure that a function parameter has the desired type. +```cpp +#include +#include +#include +#include +#include -For compatibility with older code, the class also defines the identity function `operator()` which returns its argument *left*. +int main() +{ + std::vector v{3, 1, 4, 1, 5, 9, 2, 6}; + + // Ranges algorithms can apply a projection before comparison. + // But if you don't want to apply a projection, i.e. you don't want to modify the data + // before comparison, you can use std::identity to leave each element unchanged. + // Here, std::identity{} means "project each element as itself". + // So the comparator sees the original int values unchanged. + std::ranges::sort(v, std::less{}, std::identity{}); + + // This call is equivalent because std::identity{} is the default projection. + // In both calls, elements are sorted directly; no field extraction or + // value transformation happens first. + std::ranges::sort(v); + + for (int n : v) + { + std::cout << n << ' '; + } + std::cout << '\n'; + // Output: 1 1 2 3 4 5 6 9 +} +``` + +### Why `is_transparent` matters + +This example searches a `std::vector` with a `std::string_view` key. Because `std::identity` has the `is_transparent` member, the algorithm knows to compare these types directly. This way the key doesn't get converted to a temporary `std::string` just to do the comparison. + +```cpp +#include +#include +#include +#include +#include +#include +#include + +int main() +{ + std::vector words{"apple", "banana", "cherry", "date"}; + std::string_view key = "cherry"; + + // `std::less<>` is transparent, so it can compare `std::string` and + // `std::string_view` directly. + // `std::identity` is also marked transparent (`is_transparent`), so the + // projection stays type-flexible instead of forcing one fixed type. + auto it = std::ranges::lower_bound(words, key, std::less<>{}, std::identity{}); + + if (it != words.end() && *it == key) + { + std::cout << "Found: " << *it << '\n'; + } +} +``` diff --git a/docs/standard-library/scoped-lock-class.md b/docs/standard-library/scoped-lock-class.md index 45c76d8ff0f..fba9b3153b0 100644 --- a/docs/standard-library/scoped-lock-class.md +++ b/docs/standard-library/scoped-lock-class.md @@ -1,24 +1,25 @@ --- title: "scoped_lock Class" description: "Learn more about: scoped_lock Class" -ms.date: 11/04/2016 +ms.date: 04/10/2026 f1_keywords: ["mutex/std::scoped_lock"] +ai-usage: ai-generated --- # scoped_lock Class -The `scoped_lock` class is an RAII (Resource Acquisition Is Initialization) wrapper that acquires one or more mutexes on construction and releases them on destruction. When multiple mutexes are provided, they are locked using a deadlock-avoidance algorithm (equivalent to `std::lock`), which prevents deadlocks regardless of the order in which different threads lock the same set of mutexes. Introduced in C++17. +The `scoped_lock` class acquires one or more mutexes on construction and releases them on destruction. When multiple mutexes are provided, a deadlock-avoidance algorithm (equivalent to `std::lock`) is used to prevent deadlocks. Introduced in C++17. ## Syntax ```cpp template class scoped_lock { - using mutex_type = Mutex; // If MutexTypes... consists of the single type Mutex + using mutex_type = Mutex; explicit scoped_lock(MutexTypes&... m); explicit scoped_lock(MutexTypes&... m, adopt_lock_t); ~scoped_lock(); - scoped_lock(const scoped_lock&) = delete; - scoped_lock& operator=(const scoped_lock&) = delete; + scoped_lock(const scoped_lock&) = delete; // prevent creating a new scoped_lock by copying an existing one + scoped_lock& operator=(const scoped_lock&) = delete; // prevent assigning one scoped_lock to another }; ``` @@ -28,6 +29,8 @@ The `scoped_lock` class manages locking and unlocking of one or more mutexes thr If you need to lock only a single mutex, consider using [`lock_guard`](lock-guard-class.md) or [`unique_lock`](unique-lock-class.md). Use `scoped_lock` when you need to lock multiple mutexes simultaneously without risk of deadlock. +The `scoped_lock` class isn't copyable. + ### Constructors | Constructor | Description | @@ -88,13 +91,13 @@ int main() ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also [Header files reference](../standard-library/header-files-reference.md)\ -[`lock_guard` Class](lock-guard-class.md)\ -[`unique_lock` Class](unique-lock-class.md)\ +[`lock_guard` class](lock-guard-class.md)\ +[`unique_lock` class](unique-lock-class.md)\ [``](mutex.md) From 6b0c71c6692948552d8cc7a5f935767b8340b4dd Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Sat, 11 Apr 2026 19:21:31 -0700 Subject: [PATCH 1733/1799] updates --- .../tool-errors/linker-tools-errors-and-warnings.md | 1 - docs/standard-library/scoped-lock-class.md | 1 - 2 files changed, 2 deletions(-) diff --git a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md index 1e2d72eaa4a..102d426b6e8 100644 --- a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md @@ -25,7 +25,6 @@ The linker tools LINK, LIB, DUMPBIN, and EDITBIN share a common executable that | [Linker Tools Error LNK1120](linker-tools-error-lnk1120.md) | *number* unresolved externals | | [Linker Tools Error LNK1123](linker-tools-error-lnk1123.md) | failure during conversion to COFF: file invalid or corrupt | | [Linker Tools Error LNK1127](linker-tools-error-lnk1127.md) | library is corrupt | -| Linker Tools Error LNK1131 | no library specified | | [Linker Tools Error LNK1136](linker-tools-error-lnk1136.md) | invalid or corrupt file | | [Linker Tools Error LNK1140](linker-tools-error-lnk1140.md) | too many modules for program database; link with /PDB:NONE | | [Linker Tools Error LNK1141](linker-tools-error-lnk1141.md) | failure during build of exports file | diff --git a/docs/standard-library/scoped-lock-class.md b/docs/standard-library/scoped-lock-class.md index fba9b3153b0..ed3f86176a7 100644 --- a/docs/standard-library/scoped-lock-class.md +++ b/docs/standard-library/scoped-lock-class.md @@ -97,7 +97,6 @@ int main() ## See also -[Header files reference](../standard-library/header-files-reference.md)\ [`lock_guard` class](lock-guard-class.md)\ [`unique_lock` class](unique-lock-class.md)\ [``](mutex.md) From b12152b37dedfd62045c65da9ed79ed30fa1f301 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Sat, 11 Apr 2026 19:31:37 -0700 Subject: [PATCH 1734/1799] undo a file --- .../how-to-set-code-analysis-properties-for-c-cpp-projects.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md b/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md index ef67f41285e..d4b1e95e891 100644 --- a/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md +++ b/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md @@ -18,9 +18,6 @@ ms.assetid: 7af52097-6d44-4785-9b9f-43b7a7d447d7 You can configure which rules the code analysis tool uses to analyze the code in each configuration of your project. In addition, you can direct code analysis to suppress warnings from code that was generated and added to your project by a third-party tool. -> [!NOTE] -> In recent versions of Visual Studio, the legacy **Code Analysis** property page in the project properties dialog may appear empty or show a deprecation notice. Use the individual settings described below to configure code analysis. For CMake projects, use `CMakeSettings.json` or `CMakePresets.json` instead. - ## Code Analysis Property Page The **Code Analysis** property page contains all code analysis configuration settings for an MSBuild project. To open the code analysis property page for a project in **Solution Explorer**, right-click the project and then click **Properties**. Next, expand **Configuration Properties** and select the **Code Analysis** tab. From 06db2193cdb16b07d9f8f71f4d6babeda31ba270 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Sat, 11 Apr 2026 20:06:19 -0700 Subject: [PATCH 1735/1799] updates --- docs/standard-library/identity-structure.md | 8 +++--- docs/standard-library/scoped-lock-class.md | 28 ++++++++++++++++++++- 2 files changed, 30 insertions(+), 6 deletions(-) diff --git a/docs/standard-library/identity-structure.md b/docs/standard-library/identity-structure.md index b337411706c..7bc79322de2 100644 --- a/docs/standard-library/identity-structure.md +++ b/docs/standard-library/identity-structure.md @@ -1,7 +1,7 @@ --- description: "Learn more about: identity Structure" title: "identity Structure" -ms.date: "11/04/2016" +ms.date: 04/11/2026 f1_keywords: ["utility/std::identity"] helpviewer_keywords: ["identity class", "identity structure"] ai-usage: ai-assisted @@ -15,7 +15,7 @@ ai-usage: ai-assisted `std::identity` (introduced in C++20) is a function object whose `operator()` returns its argument unchanged. -Many standard library APIs take a callable argument such as a projection or transformation function. If you need to pass a callable but don't want to change the data, pass `std::identity`. This is common in ranges algorithms. Most `` ranges overloads have a projection parameter that defaults to `std::identity{}`. +Many standard library APIs take a callable argument such as a projection or transformation function. If you need to pass a callable but don't want to change the data, pass `std::identity`. This is common in ranges algorithms. Many `` ranges overloads have a projection parameter that defaults to `std::identity{}`. ### Syntax @@ -32,7 +32,7 @@ struct identity The `is_transparent` member type is a tag that marks `std::identity` as a transparent function object. Its presence indicates that algorithms can perform comparisons or projections without needing to convert types to a common form first. This is useful for associative containers and algorithms that support heterogeneous lookup, allowing them to compare different types directly without constructing temporary objects. -### Example +### Examples ```cpp #include @@ -66,8 +66,6 @@ int main() } ``` -### Why `is_transparent` matters - This example searches a `std::vector` with a `std::string_view` key. Because `std::identity` has the `is_transparent` member, the algorithm knows to compare these types directly. This way the key doesn't get converted to a temporary `std::string` just to do the comparison. ```cpp diff --git a/docs/standard-library/scoped-lock-class.md b/docs/standard-library/scoped-lock-class.md index ed3f86176a7..58e64719100 100644 --- a/docs/standard-library/scoped-lock-class.md +++ b/docs/standard-library/scoped-lock-class.md @@ -12,9 +12,31 @@ The `scoped_lock` class acquires one or more mutexes on construction and release ## Syntax ```cpp + +// Single mutex type version +template +class _NODISCARD_LOCK scoped_lock<_Mutex> { +public: + using mutex_type = _Mutex; + + explicit scoped_lock(_Mutex& _Mtx) : _MyMutex(_Mtx) { // construct and lock + _MyMutex.lock(); + } + + explicit scoped_lock(adopt_lock_t, _Mutex& _Mtx) noexcept + : _MyMutex(_Mtx) {} // construct but don't lock + + ~scoped_lock() noexcept { + _MyMutex.unlock(); + } + + scoped_lock(const scoped_lock&) = delete; // prevent creating a new scoped_lock by copying an existing one + scoped_lock& operator=(const scoped_lock&) = delete; // prevent assigning one scoped_lock to another +}; + +// multiple mutex types version template class scoped_lock { - using mutex_type = Mutex; explicit scoped_lock(MutexTypes&... m); explicit scoped_lock(MutexTypes&... m, adopt_lock_t); ~scoped_lock(); @@ -25,12 +47,16 @@ class scoped_lock { ## Remarks +`adopt_lock_t` is a tag type that indicates the `scoped_lock` constructor should assume ownership of mutexes that are already locked by the calling thread. This allows you to create a `scoped_lock` object without locking the mutexes again, which can be useful in certain scenarios where you have already acquired the locks and want to manage their lifetime with a `scoped_lock`. + The `scoped_lock` class manages locking and unlocking of one or more mutexes throughout a scope. When you create a `scoped_lock` object, it acquires ownership of the mutexes passed to it. When the `scoped_lock` object is destroyed (for example, when it goes out of scope), the mutexes are released. This ensures that mutexes are always properly released, even if an exception is thrown. If you need to lock only a single mutex, consider using [`lock_guard`](lock-guard-class.md) or [`unique_lock`](unique-lock-class.md). Use `scoped_lock` when you need to lock multiple mutexes simultaneously without risk of deadlock. The `scoped_lock` class isn't copyable. +If only one mutex type is passed to `scoped_lock`, the `scoped_lock` provides a type alias named `mutex_type` that refers to that one mutex type. However, if you create a `scoped_lock` with two or more mutex types, the `mutex_type` alias does not exist because `mutex_type` only makes sense when there is a single underlying mutex type. With multiple mutexes, there isn’t one mutex type to expose. + ### Constructors | Constructor | Description | From 1fda8913024873771366fcda948ec829883c21da Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Sat, 11 Apr 2026 20:26:53 -0700 Subject: [PATCH 1736/1799] update flag description --- docs/windows/redistributing-visual-cpp-files.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index c9ab8d102c5..24caab37063 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -68,9 +68,13 @@ The version number is stored in the `REG_SZ` string value `Version` and also in The Visual C++ Redistributable supports several command-line options. The `/?`, `/h`, or `/help` options display a dialog that lists the available options. You can specify `/install` to install, `/repair` to repair, or `/uninstall` to uninstall the Redistributable. The `/layout` option copies the complete contents of the Redistributable in the current directory. -By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can specify the `/passive` option, which displays a progress bar but doesn't otherwise require user interaction (however, a license acceptance dialog may still appear if the Redistributable hasn't been installed before). You can also specify a `/quiet` option, which doesn't display a user interface or require any user interaction, including no license dialog. Use `/quiet` for fully unattended installations. The `/norestart` option suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. You can use `/log filename.txt` to log to a specific file. +By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can modify this behavior with the following options: +- `/passive`: shows a progress bar but doesn't otherwise require user interaction (however, a license acceptance dialog may still appear if the Redistributable hasn't been installed before). +- `/quiet`: doesn't display a user interface or require any user interaction, including no license dialog. Use `/quiet` for fully unattended installations. +- `norestart`: suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. +- `/log filename.txt` to log to a specific file. -This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction or a restart: +This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction (aside from a license acceptance dialog) or a restart: ```cmd vc_redist.x64.exe /install /passive /norestart From 8bd2a67195bf075676600cb79414cdb109cd7131 Mon Sep 17 00:00:00 2001 From: Ivan Povazan Date: Mon, 13 Apr 2026 16:31:24 +0200 Subject: [PATCH 1737/1799] [docs] Add SHA384 and SHA512 options for checksum in debug info --- .../ml-and-ml64-command-line-reference.md | 2 ++ .../compiler-options-listed-alphabetically.md | 2 +- .../compiler-options-listed-by-category.md | 2 +- docs/build/reference/zh.md | 27 +++++++++++++------ ...ompiler-fatal-errors-c999-through-c1999.md | 1 + .../compiler-errors-1/fatal-error-c1029.md | 16 +++++++++++ docs/error-messages/toc.yml | 2 ++ 7 files changed, 42 insertions(+), 10 deletions(-) create mode 100644 docs/error-messages/compiler-errors-1/fatal-error-c1029.md diff --git a/docs/assembler/masm/ml-and-ml64-command-line-reference.md b/docs/assembler/masm/ml-and-ml64-command-line-reference.md index e4ea469e36f..fd18e15dcdd 100644 --- a/docs/assembler/masm/ml-and-ml64-command-line-reference.md +++ b/docs/assembler/masm/ml-and-ml64-command-line-reference.md @@ -69,6 +69,8 @@ The options listed in the following table: | **`/Zf`** | Makes all symbols public. | | **`/ZH:MD5`** | Use MD5 for checksum in debug info. | | **`/ZH:SHA_256`** | Use SHA256 for checksum in debug info (default in Visual Studio 2022 version 17.0 and later). | +| **`/ZH:SHA384`** | Use SHA384 for checksum in debug info. | +| **`/ZH:SHA512`** | Use SHA512 for checksum in debug info. | | **`/Zi`** | Generates CodeView information in object file. | | **`/Zm`** | Enables **`M510`** option for maximum compatibility with MASM 5.1.
Not available in ml64.exe. | | **`/Zp`**⟦*`alignment`*⟧ | Packs structures on the specified byte boundary. The *`alignment`* can be 1, 2, 4, 8, or 16. | diff --git a/docs/build/reference/compiler-options-listed-alphabetically.md b/docs/build/reference/compiler-options-listed-alphabetically.md index 193a21544b1..8f81c023df6 100644 --- a/docs/build/reference/compiler-options-listed-alphabetically.md +++ b/docs/build/reference/compiler-options-listed-alphabetically.md @@ -251,7 +251,7 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/Zc:zeroSizeArrayNew[-]`](zc-zerosizearraynew.md) | Call member `new`/`delete` for zero-size arrays of objects (on by default). | | [`/Ze`](za-ze-disable-language-extensions.md) | Deprecated. Enables C89 language extensions. | | [`/Zf`](zf.md) | Improves PDB generation time in parallel builds. | -| [`/ZH:[MD5|SHA1|SHA_256]`](zh.md) | Specifies MD5, SHA-1, or SHA-256 for checksums in debug info. | +| [`/ZH:[MD5|SHA1|SHA_256|SHA384|SHA512]`](zh.md) | Specifies MD5, SHA-1, SHA-256, SHA-384, or SHA-512 for checksums in debug info. | | [`/ZI`](z7-zi-zi-debug-information-format.md) | Includes debug information in a program database compatible with Edit and Continue. (x86 only) | | [`/Zi`](z7-zi-zi-debug-information-format.md) | Generates complete debugging information. | | [`/Zl`](zl-omit-default-library-name.md) | Removes the default library name from the *`.obj`* file. | diff --git a/docs/build/reference/compiler-options-listed-by-category.md b/docs/build/reference/compiler-options-listed-by-category.md index 5b2a78c030d..95220b83c1b 100644 --- a/docs/build/reference/compiler-options-listed-by-category.md +++ b/docs/build/reference/compiler-options-listed-by-category.md @@ -210,7 +210,7 @@ This article contains a categorical list of compiler options. For an alphabetica | [`/Zc:zeroSizeArrayNew[-]`](zc-zerosizearraynew.md) | Call member `new`/`delete` for 0-size arrays of objects (on by default). | | [`/Ze`](za-ze-disable-language-extensions.md) | Deprecated. Enables C89 language extensions. | | [`/Zf`](zf.md) | Improves PDB generation time in parallel builds. | -| [`/ZH`:[MD5|SHA1|SHA_256]](zh.md) | Specifies MD5, SHA-1, or SHA-256 for checksums in debug info. | +| [`/ZH`:[MD5|SHA1|SHA_256|SHA384|SHA512]](zh.md) | Specifies MD5, SHA-1, SHA-256, SHA-384, or SHA-512 for checksums in debug info. | | [`/ZI`](z7-zi-zi-debug-information-format.md) | Includes debug information in a program database compatible with Edit and Continue. (x86 only) | | [`/Zi`](z7-zi-zi-debug-information-format.md) | Generates complete debugging information. | | [`/Zl`](zl-omit-default-library-name.md) | Removes the default library name from the *`.obj`* file. | diff --git a/docs/build/reference/zh.md b/docs/build/reference/zh.md index 3cefaf8e712..5e77baaa831 100644 --- a/docs/build/reference/zh.md +++ b/docs/build/reference/zh.md @@ -1,9 +1,9 @@ --- title: "/ZH (Hash algorithm for calculation of file checksum in debug info)" -description: "Use the /ZH compiler option to enable MD5, SHA-1, or SHA-256 source file checksums in debug info" -ms.date: 02/01/2022 -f1_keywords: ["/ZH", "/ZH:MD5", "/ZH:SHA1", "/ZH:SHA_256"] -helpviewer_keywords: ["/ZH", "/ZH:MD5", "/ZH:SHA1", "/ZH:SHA_256", "/ZH compiler option", "/ZH:MD5 compiler option", "/ZH:SHA1 compiler option", "/ZH:SHA_256 compiler option", "Hash algorithm for file checksum in debug info"] +description: "Use the /ZH compiler option to enable MD5, SHA-1, SHA-256, SHA-384, or SHA-512 source file checksums in debug info" +ms.date: 04/13/2026 +f1_keywords: ["/ZH", "/ZH:MD5", "/ZH:SHA1", "/ZH:SHA_256", "/ZH:SHA384", "/ZH:SHA512"] +helpviewer_keywords: ["/ZH", "/ZH:MD5", "/ZH:SHA1", "/ZH:SHA_256", "/ZH:SHA384", "/ZH:SHA512", "/ZH compiler option", "/ZH:MD5 compiler option", "/ZH:SHA1 compiler option", "/ZH:SHA_256 compiler option", "/ZH:SHA384 compiler option", "/ZH:SHA512 compiler option", "Hash algorithm for file checksum in debug info"] --- # `/ZH` (Hash algorithm for calculation of file checksum in debug info) @@ -13,7 +13,9 @@ Specifies which cryptographic hash algorithm to use to generate a checksum of ea > **`/ZH:MD5`**\ > **`/ZH:SHA1`**\ -> **`/ZH:SHA_256`** +> **`/ZH:SHA_256`**\ +> **`/ZH:SHA384`**\ +> **`/ZH:SHA512`** ## Arguments @@ -26,11 +28,20 @@ Use an SHA-1 hash for the checksum. **`/ZH:SHA_256`**\ Use an SHA-256 hash for the checksum. This option is the default in Visual Studio 2022 version 17.0 and later. +**`/ZH:SHA384`**\ +Use an SHA-384 hash for the checksum. + +**`/ZH:SHA512`**\ +Use an SHA-512 hash for the checksum. + ## Remarks -PDB files store a checksum for each source file, compiled into the object code in the associated executable. The checksum allows the debugger to verify that the source code it loads matches the executable. The compiler and debugger support MD5, SHA-1, and SHA-256 hash algorithms. By default, in Visual Studio 2019 the compiler uses an MD5 hash to generate the checksum. To specify this hash algorithm explicitly, use the **`/ZH:MD5`** option. +PDB files store a checksum for each source file, compiled into the object code in the associated executable. The checksum allows the debugger to verify that the source code it loads matches the executable. The compiler and debugger support MD5, SHA-1, SHA-256, SHA-384, and SHA-512 hash algorithms. By default, in Visual Studio 2019 the compiler uses an MD5 hash to generate the checksum. To specify this hash algorithm explicitly, use the **`/ZH:MD5`** option. + +Because of a risk of collision problems in MD5 and SHA-1, Microsoft recommends you use the **`/ZH:SHA_256`** option or stronger. The SHA-384 and SHA-512 options provide stronger checksums but might result in a larger increase in compile times. The **`/ZH:SHA_256`** option is the default in Visual Studio 2022 version 17.0 and later. -Because of a risk of collision problems in MD5 and SHA-1, Microsoft recommends you use the **`/ZH:SHA_256`** option. The SHA-256 hash might result in a small increase in compile times. The **`/ZH:SHA_256`** option is the default in Visual Studio 2022 version 17.0 and later. +> [!NOTE] +> The **`/ZH:SHA384`** and **`/ZH:SHA512`** options aren't supported for IFC (module interface) files. If you compile modules with one of these options, the compiler emits [fatal error C1029](../../error-messages/compiler-errors-1/fatal-error-c1029.md). Use **`/ZH:SHA_256`** or a smaller hash algorithm when you compile C++ modules. When more than one **`/ZH`** option is specified, the last option is used. @@ -44,7 +55,7 @@ The **`/ZH`** option is available in Visual Studio 2019 version 16.4 and later. 1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page. -1. Modify the **Additional options** property to add a **`/ZH:MD5`**, **`/ZH:SHA1`**, or **`/ZH:SHA_256`** option, and then choose **OK**. +1. Modify the **Additional options** property to add a **`/ZH:MD5`**, **`/ZH:SHA1`**, **`/ZH:SHA_256`**, **`/ZH:SHA384`**, or **`/ZH:SHA512`** option, and then choose **OK**. ## See also diff --git a/docs/error-messages/compiler-errors-1/compiler-fatal-errors-c999-through-c1999.md b/docs/error-messages/compiler-errors-1/compiler-fatal-errors-c999-through-c1999.md index 8ba3fceb817..d19b4ce9368 100644 --- a/docs/error-messages/compiler-errors-1/compiler-fatal-errors-c999-through-c1999.md +++ b/docs/error-messages/compiler-errors-1/compiler-fatal-errors-c999-through-c1999.md @@ -43,6 +43,7 @@ The articles in this section of the documentation explain a subset of the error | [Fatal error C1026](fatal-error-c1026.md) | parser stack overflow, program too complex | | Fatal error C1027 | **(Obsolete)** Inconsistent values for /Ym between creation and use of precompiled header | | Fatal error C1028 | missing IFC for analysis. Please rebuild *module* '*ifc filename*' with `/analyze`. | +| [Fatal error C1029](fatal-error-c1029.md) | '*filename*': source file hash (*number* bytes) exceeds the IFC format's maximum supported hash size (*number* bytes); use a smaller hash algorithm such as SHA-256 | | Fatal error C1030 | WMMX types not allowed in the function signature by the calling convention | | Fatal error C1032 | `__eabi` requires VFP code generation (`/QRfpe-`) | | [Fatal error C1033](fatal-error-c1033.md) | cannot open program database '*file*' | diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1029.md b/docs/error-messages/compiler-errors-1/fatal-error-c1029.md new file mode 100644 index 00000000000..0e52957dfe2 --- /dev/null +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1029.md @@ -0,0 +1,16 @@ +--- +title: "Fatal error C1029" +description: "Learn more about: Fatal error C1029" +ms.date: 04/13/2026 +f1_keywords: ["C1029"] +helpviewer_keywords: ["C1029"] +--- +# Fatal error C1029 + +> '*filename*': source file hash (*number* bytes) exceeds the IFC format's maximum supported hash size (*number* bytes); use a smaller hash algorithm such as SHA-256 + +## Remarks + +This error occurs when you compile a C++ module (or header unit) with a [`/ZH`](../../build/reference/zh.md) hash algorithm that produces a checksum larger than the current IFC format supports. The **`/ZH:SHA384`** and **`/ZH:SHA512`** options produce checksums that exceed this limit. + +To fix this error, use **`/ZH:SHA_256`** or a smaller hash algorithm (such as **`/ZH:SHA1`** or **`/ZH:MD5`**) when you compile modules or header units. The default **`/ZH:SHA_256`** option works correctly with IFC files. diff --git a/docs/error-messages/toc.yml b/docs/error-messages/toc.yml index acb65fcdd54..fe34e4d9634 100644 --- a/docs/error-messages/toc.yml +++ b/docs/error-messages/toc.yml @@ -136,6 +136,8 @@ items: href: compiler-errors-1/fatal-error-c1025-c1115.md - name: Fatal error C1026 href: compiler-errors-1/fatal-error-c1026.md + - name: Fatal error C1029 + href: compiler-errors-1/fatal-error-c1029.md - name: Fatal error C1033 href: compiler-errors-1/fatal-error-c1033.md - name: Fatal error C1035 From e87a3d63c1e79a7340840bf1670a6edbb18af192 Mon Sep 17 00:00:00 2001 From: Ivan Povazan Date: Mon, 13 Apr 2026 18:11:30 +0200 Subject: [PATCH 1738/1799] Add a link to DIA SDK docs --- docs/build/reference/zh.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/build/reference/zh.md b/docs/build/reference/zh.md index 5e77baaa831..b87952888f4 100644 --- a/docs/build/reference/zh.md +++ b/docs/build/reference/zh.md @@ -60,4 +60,5 @@ The **`/ZH`** option is available in Visual Studio 2019 version 16.4 and later. ## See also [Compiler options](compiler-options.md)\ +[Debug Interface Access SDK](/visualstudio/debugger/debug-interface-access/idiasourcefile-get-checksumtype)\ [Source server](/windows/win32/debug/source-server-and-source-indexing) From 459b135de8329e20ea3899e7ffb151454c14bb3a Mon Sep 17 00:00:00 2001 From: Ivan Povazan Date: Mon, 13 Apr 2026 18:28:46 +0200 Subject: [PATCH 1739/1799] Better link title for DIA reference --- docs/build/reference/zh.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/zh.md b/docs/build/reference/zh.md index b87952888f4..ebed6282fd8 100644 --- a/docs/build/reference/zh.md +++ b/docs/build/reference/zh.md @@ -60,5 +60,5 @@ The **`/ZH`** option is available in Visual Studio 2019 version 16.4 and later. ## See also [Compiler options](compiler-options.md)\ -[Debug Interface Access SDK](/visualstudio/debugger/debug-interface-access/idiasourcefile-get-checksumtype)\ +[Debug Interface Access SDK - IDiaSourceFile::get_checksumType](/visualstudio/debugger/debug-interface-access/idiasourcefile-get-checksumtype)\ [Source server](/windows/win32/debug/source-server-and-source-indexing) From 4701b4ce0361bc0508c76830adf99bd806fe576c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 13 Apr 2026 15:03:34 -0700 Subject: [PATCH 1740/1799] updates --- docs/code-quality/c6387.md | 1 + docs/windows/redistributing-visual-cpp-files.md | 6 +++--- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/code-quality/c6387.md b/docs/code-quality/c6387.md index ab1c36f2927..b6aa4f4bc65 100644 --- a/docs/code-quality/c6387.md +++ b/docs/code-quality/c6387.md @@ -4,6 +4,7 @@ description: "Learn more about: Warning C6387" ms.date: 04/10/2026 f1_keywords: ["C6387", "INVALID_PARAM_VALUE_1", "__WARNING_INVALID_PARAM_VALUE_1"] helpviewer_keywords: ["C6387"] +ai-usage: ai-assisted --- # Warning C6387 diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 24caab37063..3ea69dc4b91 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -1,7 +1,7 @@ --- title: Redistribute Visual C++ Files description: Learn about Visual Studio Redistributable libraries and components that you can deploy with your app. -ms.date: 01/15/2025 +ms.date: 04/13/2026 helpviewer_keywords: ["application deployment [C++], file redistributing", "redistributing applications [C++]", "deploying applications [C++], file redistributing", "file redistribution [C++]", "redistributing applications [C++], about redistributing applications"] ms.topic: concept-article --- @@ -69,12 +69,12 @@ The version number is stored in the `REG_SZ` string value `Version` and also in The Visual C++ Redistributable supports several command-line options. The `/?`, `/h`, or `/help` options display a dialog that lists the available options. You can specify `/install` to install, `/repair` to repair, or `/uninstall` to uninstall the Redistributable. The `/layout` option copies the complete contents of the Redistributable in the current directory. By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can modify this behavior with the following options: -- `/passive`: shows a progress bar but doesn't otherwise require user interaction (however, a license acceptance dialog may still appear if the Redistributable hasn't been installed before). +- `/passive`: shows a progress bar as the Redistributable installs but doesn't otherwise require user interaction. - `/quiet`: doesn't display a user interface or require any user interaction, including no license dialog. Use `/quiet` for fully unattended installations. - `norestart`: suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. - `/log filename.txt` to log to a specific file. -This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction (aside from a license acceptance dialog) or a restart: +This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction aside from a license acceptance dialog or a restart: ```cmd vc_redist.x64.exe /install /passive /norestart From d64ba7f45de13f9359d507690063006c6bd569f5 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 13 Apr 2026 15:42:48 -0700 Subject: [PATCH 1741/1799] update --- docs/windows/redistributing-visual-cpp-files.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 3ea69dc4b91..be56ed44ff8 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -74,7 +74,7 @@ By default, the Redistributable installs its contents and prompts the user for i - `norestart`: suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. - `/log filename.txt` to log to a specific file. -This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction aside from a license acceptance dialog or a restart: +This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction aside from a restart: ```cmd vc_redist.x64.exe /install /passive /norestart From 3cf06732611a34b3214ba59781f3d74ef4784bd8 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 13 Apr 2026 15:55:08 -0700 Subject: [PATCH 1742/1799] update --- docs/windows/redistributing-visual-cpp-files.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index be56ed44ff8..185fa34b298 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -70,9 +70,10 @@ The Visual C++ Redistributable supports several command-line options. The `/?`, By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can modify this behavior with the following options: - `/passive`: shows a progress bar as the Redistributable installs but doesn't otherwise require user interaction. -- `/quiet`: doesn't display a user interface or require any user interaction, including no license dialog. Use `/quiet` for fully unattended installations. -- `norestart`: suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. +- `/quiet`: doesn't display a user interface or require any user interaction. Use `/quiet` for fully unattended installations. +- `/norestart`: suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. - `/log filename.txt` to log to a specific file. +If you are not running from an elevated command prompt, in any of these cases you'll need to respond to a User Account Control prompt to allow the installer to run with administrative privileges. This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction aside from a restart: From 64d64c38a91851deeb0838da6163005e25a15159 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 13 Apr 2026 16:16:15 -0700 Subject: [PATCH 1743/1799] fix line --- docs/windows/redistributing-visual-cpp-files.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 185fa34b298..15d2a671fca 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -73,7 +73,8 @@ By default, the Redistributable installs its contents and prompts the user for i - `/quiet`: doesn't display a user interface or require any user interaction. Use `/quiet` for fully unattended installations. - `/norestart`: suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. - `/log filename.txt` to log to a specific file. -If you are not running from an elevated command prompt, in any of these cases you'll need to respond to a User Account Control prompt to allow the installer to run with administrative privileges. + +If you aren't running from an elevated command prompt, you'll need to respond to a User Account Control prompt to allow the installer to run with administrative privileges. This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction aside from a restart: From ac0c7b154b5ba480162d5d8a9bbfc227199a45c0 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 13 Apr 2026 16:58:03 -0700 Subject: [PATCH 1744/1799] one more fix --- docs/build/reference/gm-enable-minimal-rebuild.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/docs/build/reference/gm-enable-minimal-rebuild.md b/docs/build/reference/gm-enable-minimal-rebuild.md index f0ec29080de..392220656af 100644 --- a/docs/build/reference/gm-enable-minimal-rebuild.md +++ b/docs/build/reference/gm-enable-minimal-rebuild.md @@ -1,14 +1,13 @@ --- description: "Learn more about: /Gm (Enable Minimal Rebuild)" title: "/Gm (Enable Minimal Rebuild)" -ms.date: "11/12/2018" +ms.date: 04/14/2026 f1_keywords: ["VC.Project.VCCLCompilerTool.MinimalRebuild", "/Gm", "VC.Project.VCCLWCECompilerTool.MinimalRebuild"] helpviewer_keywords: ["/Gm compiler option [C++]", "minimal rebuild", "enable minimal rebuild compiler option [C++]", "Gm compiler option [C++]", "-Gm compiler option [C++]"] -ms.assetid: d8869ce0-d2ea-40eb-8dae-6d2cdb61dd59 --- # /Gm (Enable Minimal Rebuild) -Deprecated. Enables minimal rebuild, which determines whether C++ source files that include changed C++ class definitions (stored in header (.h) files) need to be recompiled. +Deprecated in Visual Studio 2019 version 16.0. Enables minimal rebuild, which determines whether C++ source files that include changed C++ class definitions (stored in header (.h) files) need to be recompiled. ## Syntax @@ -18,7 +17,7 @@ Deprecated. Enables minimal rebuild, which determines whether C++ source files t ## Remarks -**/Gm** is deprecated. It may not trigger a build for certain kinds of header file changes. You may safely remove this option from your projects. To improve build times, we recommend you use precompiled headers and incremental and parallel build options instead. For a list of deprecated compiler options, see the **Deprecated and Removed Compiler Options** section in [Compiler Options Listed by Category](compiler-options-listed-by-category.md). +**/Gm** is deprecated as of Visual Studio 2019 version 16.0. Using it produces compiler warning D9035. It may not trigger a build for certain kinds of header file changes. You may safely remove this option from your projects. To improve build times, we recommend you use precompiled headers and incremental and parallel build options instead. For a list of deprecated compiler options, see the **Deprecated and Removed Compiler Options** section in [Compiler Options Listed by Category](compiler-options-listed-by-category.md). The compiler stores dependency information between source files and class definitions in the project's .idb file during the first compile. (Dependency information tells which source file is dependent on which class definition, and which .h file the definition is located in.) Subsequent compiles use the information stored in the .idb file to determine whether a source file needs to be compiled, even if it includes a modified .h file. @@ -30,9 +29,7 @@ Because the incremental linker does not support the Windows metadata included in ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Code Generation** property page. - 1. Modify the **Enable Minimal Rebuild** property. ### To set this compiler option programmatically @@ -41,5 +38,5 @@ Because the incremental linker does not support the Windows metadata included in ## See also -[MSVC Compiler Options](compiler-options.md)
+[MSVC Compiler Options](compiler-options.md)\ [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md) From 7f550af72846bf70af7b7ca5c523b771a3eb2381 Mon Sep 17 00:00:00 2001 From: Ivan Povazan <55002338+ivanpovazan@users.noreply.github.com> Date: Tue, 14 Apr 2026 05:14:27 +0200 Subject: [PATCH 1745/1799] Apply suggestion from feedback --- docs/build/reference/zh.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/zh.md b/docs/build/reference/zh.md index ebed6282fd8..d30cd5a3651 100644 --- a/docs/build/reference/zh.md +++ b/docs/build/reference/zh.md @@ -38,7 +38,7 @@ Use an SHA-512 hash for the checksum. PDB files store a checksum for each source file, compiled into the object code in the associated executable. The checksum allows the debugger to verify that the source code it loads matches the executable. The compiler and debugger support MD5, SHA-1, SHA-256, SHA-384, and SHA-512 hash algorithms. By default, in Visual Studio 2019 the compiler uses an MD5 hash to generate the checksum. To specify this hash algorithm explicitly, use the **`/ZH:MD5`** option. -Because of a risk of collision problems in MD5 and SHA-1, Microsoft recommends you use the **`/ZH:SHA_256`** option or stronger. The SHA-384 and SHA-512 options provide stronger checksums but might result in a larger increase in compile times. The **`/ZH:SHA_256`** option is the default in Visual Studio 2022 version 17.0 and later. +Because of a risk of collision problems in MD5 and SHA-1, use the **`/ZH:SHA_256`** option or stronger. The SHA-384 and SHA-512 options provide stronger checksums but can increase compile time. The **`/ZH:SHA_256`** option is the default in Visual Studio 2022 version 17.0 and later. > [!NOTE] > The **`/ZH:SHA384`** and **`/ZH:SHA512`** options aren't supported for IFC (module interface) files. If you compile modules with one of these options, the compiler emits [fatal error C1029](../../error-messages/compiler-errors-1/fatal-error-c1029.md). Use **`/ZH:SHA_256`** or a smaller hash algorithm when you compile C++ modules. From ccd1f611701cc95b5bc118e332c3f5d2897d79e6 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 14 Apr 2026 09:29:58 -0700 Subject: [PATCH 1746/1799] fix issue --- docs/standard-library/identity-structure.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/standard-library/identity-structure.md b/docs/standard-library/identity-structure.md index 7bc79322de2..252785219fc 100644 --- a/docs/standard-library/identity-structure.md +++ b/docs/standard-library/identity-structure.md @@ -8,13 +8,13 @@ ai-usage: ai-assisted --- # `identity` Structure +`std::identity` (introduced in C++20) is a function object whose `operator()` returns its argument unchanged. + > [!NOTE] > There's a Microsoft-specific `identity` structure from `` that is deprecated and isn't available in later versions of Visual Studio. For C++20 and later, use `std::identity` from [``](functional.md) instead, which is the standard-conforming equivalent described below. ## `std::identity` (C++20) -`std::identity` (introduced in C++20) is a function object whose `operator()` returns its argument unchanged. - Many standard library APIs take a callable argument such as a projection or transformation function. If you need to pass a callable but don't want to change the data, pass `std::identity`. This is common in ranges algorithms. Many `` ranges overloads have a projection parameter that defaults to `std::identity{}`. ### Syntax From edc9a1127aa9817b3ce3ad617694a923e2c11eea Mon Sep 17 00:00:00 2001 From: Pawwz85 <126493682+Pawwz85@users.noreply.github.com> Date: Tue, 21 Apr 2026 00:47:44 +0200 Subject: [PATCH 1747/1799] Enhance localtime_s documentation on compatibility Clarified compatibility issues of localtime_s with C standard and provided guidance for enabling the standard-conforming variant. --- .../reference/localtime-s-localtime32-s-localtime64-s.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index 430f90328b3..953a5c8294f 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -59,6 +59,8 @@ The **`localtime_s`** function converts a time stored as a [`time_t`](../standar **`localtime_s`** corrects for the local time zone if the user first sets the global environment variable **`TZ`**. When **`TZ`** is set, three other environment variables (**`_timezone`**, **`_daylight`**, and **`_tzname`**) are automatically set as well. If the **`TZ`** variable isn't set, **`localtime_s`** attempts to use the time zone information specified in the Date/Time application in Control Panel. If this information can't be obtained, PST8PDT, which signifies the Pacific time zone, is used by default. See [`_tzset`](tzset.md) for a description of these variables. **`TZ`** is a Microsoft extension and not part of the ANSI standard definition of **`localtime`**. +The Microsoft-specific **`localtime_s`** is not compatible with the C standard version due to differences in its signature. To enable the standard-conforming variant, define **`_CRT_USE_CONFORMING_ANNEX_K_TIME`** to a nonzero value before including any relevant headers. + > [!NOTE] > The target environment should try to determine whether daylight saving time is in effect. From 3ddbd609bb7ead01c964801c864cf194e100adbf Mon Sep 17 00:00:00 2001 From: Pawwz85 <126493682+Pawwz85@users.noreply.github.com> Date: Wed, 22 Apr 2026 19:06:28 +0000 Subject: [PATCH 1748/1799] Clarify documentation on Microsoft-specific localtime_s and gmtime_s signatures --- .../reference/gmtime-s-gmtime32-s-gmtime64-s.md | 2 ++ .../reference/localtime-s-localtime32-s-localtime64-s.md | 4 ++-- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md index 36f21d43df4..71494692725 100644 --- a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md +++ b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md @@ -72,6 +72,8 @@ Each of the structure fields is of type **`int`**, as shown in the following tab **`_gmtime64_s`**, which uses the **`__time64_t`** structure, allows dates to be expressed up through 23:59:59, December 31, 3000, UTC; whereas **`gmtime32_s`** only represent dates through 23:59:59 January 18, 2038, UTC. Midnight, January 1, 1970, is the lower bound of the date range for both these functions. +The Microsoft-specific **`gmtime_s`** has a different signature than the C standard version. To enable the standard-conforming variant, define **`_CRT_USE_CONFORMING_ANNEX_K_TIME`** to a nonzero value before including any of the required headers. + **`gmtime_s`** is an inline function that evaluates to **`_gmtime64_s`** and **`time_t`** is equivalent to **`__time64_t`**. If you need to force the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, you can define `_USE_32BIT_TIME_T`. `_USE_32BIT_TIME_T` causes **`gmtime_s`** to be inlined as **`_gmtime32_s`**. We don't recommend `_USE_32BIT_TIME_T`, because your application may fail after January 18, 2038, and because it isn't allowed on 64-bit platforms. By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index 953a5c8294f..ef051cb83d3 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -59,11 +59,11 @@ The **`localtime_s`** function converts a time stored as a [`time_t`](../standar **`localtime_s`** corrects for the local time zone if the user first sets the global environment variable **`TZ`**. When **`TZ`** is set, three other environment variables (**`_timezone`**, **`_daylight`**, and **`_tzname`**) are automatically set as well. If the **`TZ`** variable isn't set, **`localtime_s`** attempts to use the time zone information specified in the Date/Time application in Control Panel. If this information can't be obtained, PST8PDT, which signifies the Pacific time zone, is used by default. See [`_tzset`](tzset.md) for a description of these variables. **`TZ`** is a Microsoft extension and not part of the ANSI standard definition of **`localtime`**. -The Microsoft-specific **`localtime_s`** is not compatible with the C standard version due to differences in its signature. To enable the standard-conforming variant, define **`_CRT_USE_CONFORMING_ANNEX_K_TIME`** to a nonzero value before including any relevant headers. - > [!NOTE] > The target environment should try to determine whether daylight saving time is in effect. +The Microsoft-specific **`localtime_s`** has a different signature than the C standard version. To enable the standard-conforming variant, define **`_CRT_USE_CONFORMING_ANNEX_K_TIME`** to a nonzero value before including any of the required headers. + **`_localtime64_s`**, which uses the **`__time64_t`** structure, allows dates to be expressed up through 23:59:59, January 18, 3001, coordinated universal time (UTC), whereas **`_localtime32_s`** represents dates through 23:59:59 January 18, 2038, UTC. **`localtime_s`** is an inline function that evaluates to **`_localtime64_s`**, and **`time_t`** is equivalent to **`__time64_t`**. If you need to force the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, you can define `_USE_32BIT_TIME_T`, which causes **`localtime_s`** to evaluate to **`_localtime32_s`**. We don't recommend `_USE_32BIT_TIME_T`, because your application may fail after January 18, 2038, and it isn't allowed on 64-bit platforms. From 610eb624a2a871a89d24d3c04f5b8d0d8f32cd8b Mon Sep 17 00:00:00 2001 From: Pawwz85 <126493682+Pawwz85@users.noreply.github.com> Date: Wed, 22 Apr 2026 23:08:07 +0000 Subject: [PATCH 1749/1799] Update documentation to specify inclusion of for standard-conforming variants of gmtime_s and localtime_s --- .../reference/gmtime-s-gmtime32-s-gmtime64-s.md | 3 ++- .../reference/localtime-s-localtime32-s-localtime64-s.md | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md index 71494692725..2ce6ef33317 100644 --- a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md +++ b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md @@ -72,7 +72,8 @@ Each of the structure fields is of type **`int`**, as shown in the following tab **`_gmtime64_s`**, which uses the **`__time64_t`** structure, allows dates to be expressed up through 23:59:59, December 31, 3000, UTC; whereas **`gmtime32_s`** only represent dates through 23:59:59 January 18, 2038, UTC. Midnight, January 1, 1970, is the lower bound of the date range for both these functions. -The Microsoft-specific **`gmtime_s`** has a different signature than the C standard version. To enable the standard-conforming variant, define **`_CRT_USE_CONFORMING_ANNEX_K_TIME`** to a nonzero value before including any of the required headers. +The Microsoft-specific **`gmtime_s`** has a different signature than the C standard version. To enable the standard-conforming variant, define **`_CRT_USE_CONFORMING_ANNEX_K_TIME`** to a nonzero value before including **``**. + **`gmtime_s`** is an inline function that evaluates to **`_gmtime64_s`** and **`time_t`** is equivalent to **`__time64_t`**. If you need to force the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, you can define `_USE_32BIT_TIME_T`. `_USE_32BIT_TIME_T` causes **`gmtime_s`** to be inlined as **`_gmtime32_s`**. We don't recommend `_USE_32BIT_TIME_T`, because your application may fail after January 18, 2038, and because it isn't allowed on 64-bit platforms. diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index ef051cb83d3..14d4aaaa5df 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -62,7 +62,7 @@ The **`localtime_s`** function converts a time stored as a [`time_t`](../standar > [!NOTE] > The target environment should try to determine whether daylight saving time is in effect. -The Microsoft-specific **`localtime_s`** has a different signature than the C standard version. To enable the standard-conforming variant, define **`_CRT_USE_CONFORMING_ANNEX_K_TIME`** to a nonzero value before including any of the required headers. +The Microsoft-specific **`localtime_s`** has a different signature than the C standard version. To enable the standard-conforming variant, define **`_CRT_USE_CONFORMING_ANNEX_K_TIME`** to a nonzero value before including **``**. **`_localtime64_s`**, which uses the **`__time64_t`** structure, allows dates to be expressed up through 23:59:59, January 18, 3001, coordinated universal time (UTC), whereas **`_localtime32_s`** represents dates through 23:59:59 January 18, 2038, UTC. From 0c61e572e511b1eb565368f578a4aa6ea8d27d09 Mon Sep 17 00:00:00 2001 From: Sebastian Date: Fri, 24 Apr 2026 13:33:01 +0200 Subject: [PATCH 1750/1799] Fix typos in macro descriptions for clarity --- .../common-macros-for-build-commands-and-properties.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/common-macros-for-build-commands-and-properties.md b/docs/build/reference/common-macros-for-build-commands-and-properties.md index bb52c1458b4..5f3cd0fc40d 100644 --- a/docs/build/reference/common-macros-for-build-commands-and-properties.md +++ b/docs/build/reference/common-macros-for-build-commands-and-properties.md @@ -59,8 +59,8 @@ This table describes a commonly used subset of the available macros; there are m | **`$(TargetFileName)`** | The file name of the primary output file for the build (defined as base name + file extension). | | **`$(TargetName)`** | The base name of the primary output file for the build. | | **`$(TargetPath)`** | The absolute path name of the primary output file for the build (defined as drive + path + base name + file extension). | -| **`$(VCInstallDir)`** | The directory that contains the C++ content of your Visual Studio installation. This property contains the version of the targeted Microsoft C++ (MSVC) toolset, which might be different that the host Visual Studio. For example, when building with `$(PlatformToolset) = v140`, **`$(VCInstallDir)`** contains the path to the Visual Studio 2015 installation. | -| **`$(VSInstallDir)`** | The directory into which you installed Visual Studio. This property contains the version of the targeted Visual Studio toolset, which might be different that the host Visual Studio. For example, when building with `$(PlatformToolset) = v110`, **`$(VSInstallDir)`** contains the path to the Visual Studio 2012 installation. | +| **`$(VCInstallDir)`** | The directory that contains the C++ content of your Visual Studio installation. This property contains the version of the targeted Microsoft C++ (MSVC) toolset, which might be different than the host Visual Studio. For example, when building with `$(PlatformToolset) = v140`, **`$(VCInstallDir)`** contains the path to the Visual Studio 2015 installation. | +| **`$(VSInstallDir)`** | The directory into which you installed Visual Studio. This property contains the version of the targeted Visual Studio toolset, which might be different than the host Visual Studio. For example, when building with `$(PlatformToolset) = v110`, **`$(VSInstallDir)`** contains the path to the Visual Studio 2012 installation. | | **`$(WebDeployPath)`** | The relative path from the web deployment root to where the project outputs belong. | | **`$(WebDeployRoot)`** | The absolute path to the location of **``**. For example, *`c:\inetpub\wwwroot`*. | From c1c6f7be093b7586084fba4db8f0a5687b24f350 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 8 May 2026 02:40:57 -0700 Subject: [PATCH 1751/1799] Add segment heap entry to manifest tool property pages --- docs/build/reference/manifest-tool-property-pages.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/build/reference/manifest-tool-property-pages.md b/docs/build/reference/manifest-tool-property-pages.md index cdf705d3d85..ddabe61e2cc 100644 --- a/docs/build/reference/manifest-tool-property-pages.md +++ b/docs/build/reference/manifest-tool-property-pages.md @@ -22,6 +22,7 @@ f1_keywords: - VC.Project.VCManifestTool.ReplacementsFile - VC.Project.VCManifestTool.UpdateFileHashes - VC.Project.VCManifestTool.UpdateFileHashesSearchPath + - VC.Project.VCManifestTool.EnableSegmentHeap --- # Manifest Tool Property Pages @@ -97,6 +98,10 @@ Specifies whether the application is DPI-aware. By default, the setting is **Yes - **High DPI Aware** - **Per Monitor High DPI Aware** +### Segment Heap + +Specifies whether the application utilizes the Segment Heap. For new C++ projects, the setting is **Yes** by default. + ## Isolated COM Property Page For more information about isolated COM, see [Isolated applications](/windows/win32/SbsCs/isolated-applications) and [How to: Build isolated applications to consume COM components](../how-to-build-isolated-applications-to-consume-com-components.md). From b820571d67528c02506b995835e4522a9bee1b04 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 8 May 2026 05:33:11 -0700 Subject: [PATCH 1752/1799] Add entry for segment heap cmake side --- docs/build/cmake-presets-vs.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index 5282a491801..8624c45d3c8 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -4,6 +4,7 @@ description: "Reference for using CMake Presets to configure and build CMake pro ms.date: 06/09/2023 ms.topic: reference ms.custom: sfi-image-nochange +ai-usage: ai-assisted --- # Configure and build with CMake Presets in Visual Studio @@ -460,6 +461,28 @@ The `` part lists other compilation flags, like `"-fno-omit- Pass runtime flags to AddressSanitizer by using the `ASAN_OPTIONS` field in *`launch.vs.json`*. `ASAN_OPTIONS` defaults to `detect_leaks=0` when no other runtime options are specified because LeakSanitizer isn't supported in Visual Studio. +## Enable Segment Heap + +The Segment Heap is a modern Windows heap implementation that reduces memory usage and fragmentation. Visual Studio ships a CMake script that enables Segment Heap for your project by adding the required manifest settings. + +To enable Segment Heap, set `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` in the `cacheVariables` map of your Configure Preset in *`CMakePresets.json`*: + + ```json +"cacheVariables": { + "CMAKE_PROJECT_TOP_LEVEL_INCLUDES": "{VSInstallDir}Common7\\IDE\\CommonExtensions\\Microsoft\\CMake\\CMake\\Microsoft\\SegmentHeap.cmake" +} +``` + +> [!NOTE] +> `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` is available in CMake 3.24 or later. + +Use the `VS_SEGMENT_HEAP_ALLOWLIST` and `VS_SEGMENT_HEAP_EXCLUDE` environment variables to control which targets in the project use Segment Heap. Separate target names with semicolons. + +- `VS_SEGMENT_HEAP_ALLOWLIST` — Apply the Segment Heap manifest entry only to the listed targets. Exclude all other targets. +- `VS_SEGMENT_HEAP_EXCLUDE` — Exclude the listed targets from using the Segment Heap. + +When neither variable is set, Visual Studio enables Segment Heap for all targets. If both variables are set, `VS_SEGMENT_HEAP_ALLOWLIST` takes precedence. + ## Run CMake from the command line or a CI pipeline You can use the same *`CMakePresets.json`* and *`CMakeUserPresets.json`* files to invoke CMake in Visual Studio and from the command line. The [CMake](https://cmake.org/cmake/help/latest/manual/cmake.1.html) and [CTest](https://cmake.org/cmake/help/latest/manual/ctest.1.html) documentation are the best resources for invoking CMake and CTest with `--preset`. CMake version 3.20 or later is required. From f75c1f7a12780655cadd075708d2f7c413a7a365 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 8 May 2026 05:36:51 -0700 Subject: [PATCH 1753/1799] Add sentence about new cmake projects --- docs/build/cmake-presets-vs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index 8624c45d3c8..1dbd0ea9546 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -463,7 +463,7 @@ Pass runtime flags to AddressSanitizer by using the `ASAN_OPTIONS` field in *`la ## Enable Segment Heap -The Segment Heap is a modern Windows heap implementation that reduces memory usage and fragmentation. Visual Studio ships a CMake script that enables Segment Heap for your project by adding the required manifest settings. +The Segment Heap is a modern Windows heap implementation that reduces memory usage and fragmentation. Visual Studio ships a CMake script that enables Segment Heap for your project by adding the required manifest settings. New C++ CMake projects enable Segment Heap by default. To enable Segment Heap, set `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` in the `cacheVariables` map of your Configure Preset in *`CMakePresets.json`*: From 1ae7e2510b006e49d7bfd5f499fca69a20a3e1b3 Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Fri, 8 May 2026 06:14:25 -0700 Subject: [PATCH 1754/1799] Fix json example --- docs/build/cmake-presets-vs.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index 1dbd0ea9546..90427d3ffd4 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -468,9 +468,17 @@ The Segment Heap is a modern Windows heap implementation that reduces memory usa To enable Segment Heap, set `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` in the `cacheVariables` map of your Configure Preset in *`CMakePresets.json`*: ```json -"cacheVariables": { - "CMAKE_PROJECT_TOP_LEVEL_INCLUDES": "{VSInstallDir}Common7\\IDE\\CommonExtensions\\Microsoft\\CMake\\CMake\\Microsoft\\SegmentHeap.cmake" +{ + "configurePresets": [ + { + // ... + "cacheVariables": { + "CMAKE_PROJECT_TOP_LEVEL_INCLUDES": "$env{VSINSTALLDIR}Common7/IDE/CommonExtensions/Microsoft/CMake/cmake/Microsoft/SegmentHeap.cmake" + } + } + ] } + ``` > [!NOTE] From 530c4c0cc161d0399de82c2f525b1d1727668774 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 8 May 2026 14:58:21 -0700 Subject: [PATCH 1755/1799] Add MSVC Build Tools 14.51 what's new and conformance sections - Add 'What's new for MSVC Build Tools version 14.51' section to what-s-new-for-msvc.md - ARM SVE support (first-ever in MSVC) - overhaul (fixes stack overflows present since VS 2008 SP1) - ARM64 NEON vectorization of STL algorithms (first for ARM64/ARM64EC) - and headers - Sample-based PGO preview - Intel APX preview - ASan ARM64 now fully supported (no longer preview) - Removed non-standard features (TR1, , , etc.) - Add C++ conformance improvements section for MSVC Build Tools v14.51 to msvc-conformance-improvements.md - P2647R1: Static constexpr variables in constexpr functions (with example) - P2448R2: Relaxed constexpr restrictions (with example) - 22 CWG issue resolutions with links - Additional C++23 features (Unicode, assumptions, CTAD, modules) - Standard library additions (, , new type traits) - Update ms.date to 05/08/2026 in both documents Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../overview/msvc-conformance-improvements.md | 83 ++++++++++++++++++- docs/overview/what-s-new-for-msvc.md | 72 +++++++++++++++- 2 files changed, 152 insertions(+), 3 deletions(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index e9f57255dfa..160cbeddbee 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -1,7 +1,7 @@ --- title: "/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools" description: "Summary of conformance improvements in Microsoft C/C++ (MSVC)" -ms.date: 11/03/2025 +ms.date: 05/08/2026 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- @@ -18,6 +18,87 @@ For changes in earlier versions of Visual Studio: | 2017 | [C++ conformance improvements in Visual Studio 2017](cpp-conformance-improvements-2017.md) | | 2003-2015 | [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md) | +## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.51 + +MSVC Build Tools v14.51 continues the progress toward full C++23 conformance with several key language feature implementations and numerous Core Working Group (CWG) issue resolutions. This release focuses on compile-time evaluation improvements, Unicode support enhancements, and refined consteval handling. + +This version shipped first with Visual Studio 2026 version 18.6 and includes version 19.51 of the MSVC compiler. + +Key highlights of this release include: +- Static constexpr variables in constexpr functions (P2647R1) +- Relaxed constexpr restrictions (P2448R2) +- Unicode support improvements (P2029R4, P2071R2, P2314R4) +- 22 CWG issue resolutions +- Improved consteval function handling with default-enabled experimental features +- New standard library headers `` and `` + +For more information about library features and additional updates, see [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51) and [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog). + +### P2647R1: Static constexpr variables in constexpr functions + +[P2647R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2647r1.html) allows static local variables to be declared `constexpr` within `constexpr` functions, reducing friction when marking existing functions as `constexpr`. + +```cpp +constexpr char xdigit(int n) +{ + static constexpr char digits[] = "0123456789abcdef"; + return digits[n]; +} +``` + +This feature improves both compile-time evaluation and run-time optimization. Previously, static local variables couldn't be marked `constexpr`, which made it difficult to declare lookup tables inside `constexpr` functions. Now the compiler can evaluate these functions at compile time when possible, while also generating optimized run-time code that accesses the static storage directly. + +### P2448R2: Relaxing some constexpr restrictions + +[P2448R2](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2448r2.html) relaxes restrictions on `constexpr` functions. A `constexpr` function no longer fails to compile if it can't actually run at compile time. + +```cpp +void bar(); + +// Now accepted, but only executable at run time +constexpr void foo() +{ + bar(); +} +``` + +This change protects against library changes making user code ill-formed. If a library function is updated and can no longer be evaluated at compile time, code that calls it in a `constexpr` context remains valid—it simply runs at run time instead. + +### Other C++23 features + +Additional C++23 features implemented in this release include Unicode support improvements ([P2029R4](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2029r4.html), [P2071R2](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2020/p2071r2.html), [P2314R4](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2314r4.html)), portable assumptions ([P1774R8](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p1774r8.html)), labels at the end of compound statements for C compatibility ([P2324R2](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2324r2.html)), Class Template Argument Deduction (CTAD) from inherited constructors ([P2582R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2582r1.html)), and meaningful exports for modules ([P2615R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2615r1.html)). For more details, see the [blog post](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51). + +### CWG Issue Resolutions + +MSVC Build Tools v14.51 resolves 22 Core Working Group issues: + +- [CWG 2355](https://cplusplus.github.io/CWG/issues/2355.html): Deducing noexcept specifiers +- [CWG 2392](https://cplusplus.github.io/CWG/issues/2392.html): new-expression size checks and constant evaluation +- [CWG 2405](https://cplusplus.github.io/CWG/issues/2405.html): Additional type-dependent expressions +- [CWG 2479](https://cplusplus.github.io/CWG/issues/2479.html): Missing specifications for consteval and constinit +- [CWG 2484](https://cplusplus.github.io/CWG/issues/2484.html): char8_t / char16_t integral promotions +- [CWG 2490](https://cplusplus.github.io/CWG/issues/2490.html): Restrictions on destruction in constant expressions +- [CWG 2491](https://cplusplus.github.io/CWG/issues/2491.html): Export of typedef after first declaration +- [CWG 2518](https://cplusplus.github.io/CWG/issues/2518.html): Conformance requirements and #error / #warning +- [CWG 2529](https://cplusplus.github.io/CWG/issues/2529.html): Constant destruction of constexpr references +- [CWG 2538](https://cplusplus.github.io/CWG/issues/2538.html): Ignoring standard attributes syntactically +- [CWG 2539](https://cplusplus.github.io/CWG/issues/2539.html): Three-way comparison and floating-point strong ordering +- [CWG 2543](https://cplusplus.github.io/CWG/issues/2543.html): constinit and optimized dynamic initialization +- [CWG 2597](https://cplusplus.github.io/CWG/issues/2597.html): Replaceable allocation functions in the global module +- [CWG 2602](https://cplusplus.github.io/CWG/issues/2602.html): consteval defaulted functions +- [CWG 2605](https://cplusplus.github.io/CWG/issues/2605.html): Implicit-lifetime aggregates +- [CWG 2615](https://cplusplus.github.io/CWG/issues/2615.html): Missing __has_cpp_attribute(assume) +- [CWG 2618](https://cplusplus.github.io/CWG/issues/2618.html): Deduction excluding exception specifications +- [CWG 2627](https://cplusplus.github.io/CWG/issues/2627.html): Bit-fields and narrowing conversions +- [CWG 2631](https://cplusplus.github.io/CWG/issues/2631.html): Immediate function evaluation in default arguments +- [CWG 2640](https://cplusplus.github.io/CWG/issues/2640.html): Extended characters in n-character sequences +- [CWG 2651](https://cplusplus.github.io/CWG/issues/2651.html): Conversion function templates and noexcept +- [CWG 2664](https://cplusplus.github.io/CWG/issues/2664.html): CTAD deduction failure for alias templates + +### Standard Library + +MSVC Build Tools v14.51 adds new standard library features including the `` and `` headers, type traits for detecting references binding to temporaries ([P2255R2](https://wg21.link/p2255r2)), explicit lifetime management ([P2590R2](https://wg21.link/p2590r2)), and `is_implicit_lifetime` ([P2674R1](https://wg21.link/P2674R1)). The release also includes a major `` overhaul, SIMD-vectorized STL algorithms using NEON for ARM64/ARM64EC, and 18 Library Working Group (LWG) issue resolutions. For the complete list, see the [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog). + ## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.50 MSVC Build Tools v14.50 introduces improvements to the MSVC compiler and standard library, including better C++23 standards conformance, enhanced reliability, and improved correctness. This release also includes numerous bug fixes and updates that benefit large-scale C++ development. diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index e9563fdf67e..59b7b7ba49d 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,7 +1,7 @@ --- title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 11/11/2025 +ms.date: 05/08/2026 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new @@ -9,10 +9,78 @@ ms.custom: intro-whats-new # What's new for MSVC Build Tools -Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and other build tools. +Version 14.51 brings many updates and fixes to the Microsoft C++ compiler and other build tools. - For more information about what's new in all of Visual Studio, see [Visual Studio 2026 release notes](/visualstudio/releases/2026/release-notes). +## What's new for MSVC Build Tools version 14.51 + +* Introduced in Visual Studio 2026 version 18.6 released May 2026. + +Visual Studio 2026 version 18.6 ships with the v145 platform toolset for MSBuild C++ projects and Microsoft C++ (MSVC) Build Tools version 14.51. To access all the new language features, build with `/std:c++latest`. Or, if you want to be restricted to features up to C++23, use `/std:c++23preview`. + +MSVC Build Tools version 14.51 preserves binary compatibility with code built with MSVC tools shipped in Visual Studio 2015 or later. For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](/cpp/porting/binary-compat-2015-2017). + +| For detailed information about | See | +|---|---| +| What's new for C++ developers | [MSVC Build Tools version 14.51 Release Candidate Now Available](https://devblogs.microsoft.com/cppblog/msvc-build-tools-version-14-51-release-candidate-now-available/) | +| Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.51](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1451-preview) | +| C++23 language updates | [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51) | +| C++ language conformance improvements | [C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools](msvc-conformance-improvements.md) | + +Here's a quick highlight of some of the new features in MSVC Build Tools version 14.51: + +### C++ language enhancements + +- The frontend team continued implementing C++23 and C++20 features and fixing conformance issues. For full C++23 details, see [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51). +- Multiple fixes to `consteval` function handling, including support for constexpr `new`/`delete` in modules. The `/experimental:constevalVfuncVtable` behavior is now enabled by default. +- Added support for C language features: `_Atomic` qualifier and `__typeof__` for function types. +- Fixed incorrect diagnostics for C99 flexible array members. +- MSVC frontend now generates IFC files according to [version 0.44](https://github.com/microsoft/ifc-spec/releases/tag/0.44) of the [IFC specification](https://github.com/microsoft/ifc-spec). +- Improved parser error recovery and removal of legacy token accessors. + +### Standard Library enhancements + +- Added new C++23 headers: `` ([P0429R9](https://wg21.link/P0429R9)) and `` ([P1222R4](https://wg21.link/P1222R4)). +- **Massive `` overhaul:** Fixed long-standing correctness and performance problems present since VS 2008 SP1. After nearly two decades, the stack overflows are finally fixed. The implementation now performs matching non-recursively and includes significant performance improvements. +- **ARM64 NEON vectorization:** First release shipping NEON-vectorized STL algorithms for ARM64/ARM64EC. Previously, only x64/x86 received SIMD optimizations with SSE4.2 and AVX2. Vectorized implementations are now available for algorithms including `swap_ranges()`, `rotate()`, `reverse()`, `min_element()`, `max_element()`, `find()`, `count()`, and many more. +- Implemented 18 Library Working Group (LWG) issue resolutions, including fixes for duration conversion overflow, `construct_at` array support, and optional const overloads. +- Optimized integer-to-string conversions by printing digits in pairs. The STL is now optimized for speed instead of size. +- Added type traits to detect references binding to temporaries ([P2255R2](https://wg21.link/P2255R2)). +- Added explicit lifetime management support ([P2590R2](https://wg21.link/P2590R2)). +- Enhanced debugger visualizations, including a `c_str()` intrinsic function for `basic_string` that enables conditional breakpoints. + +### Build enhancements + +- **ARM SVE support:** First-ever ARM Scalable Vector Extension (SVE) support in MSVC, including frontend type support, intrinsic lowering, callee-saved register unwinding, and DIA SDK support. +- **Sample-based PGO:** Preview support for sample-based profile guided optimizations. +- The backend optimizer received significant investment with dozens of new optimization patterns for improved code generation, including better inlining, loop optimizations, and pattern matching. +- **Intel APX preview:** Preview support for Intel Advanced Performance Extensions. +- ARM64EC/ARM64X improvements: Fixed missing entry thunks for coroutine outlinees, improved identical COMDAT folding (ICF) in ARM64X binaries, and fixed volatile XMM assignment. +- Enabled debug info pruning to reduce PDB sizes. + +### Code analysis enhancements + +- Improved AddressSanitizer for ARM64 with comprehensive library packaging, interception fixes, and false-positive resolutions. ARM64 support is no longer preview—it's now fully supported. +- Consolidated static analysis tools: EspX and its extensions like CppCoreCheck merged into a single DLL, simplifying deployment. +- Fixed SanitizerCoverage blocklist handling and codegen issues. + +### Deprecations + +- The following experimental coroutine headers are now deprecated: ``, ``, and ``. Developers should transition to standard C++20 coroutines using the `` header. +- Removed the escape hatch macro `_ALLOW_RTCc_IN_STL`. The STL doesn't support the `/RTCc` compiler option (but `/RTCs` and `/RTCu`/`/RTC1` remain supported). + +### Removed features + +The following long-deprecated non-Standard features have been removed: + +- **TR1** including the `std::tr1` namespace, old `array::assign()`, and old `` engines and distributions. Deprecated since VS 2017 15.5 (December 2017). +- **`` and ``**. Deprecated since VS 2015 (July 2015). +- **``**. Deprecated since VS 2019 16.3 (September 2019). +- **`stdext::checked_array_iterator` and `stdext::unchecked_array_iterator`**. Deprecated since VS 2022 17.8 (November 2023) for C++17 and later. +- **`basic_istream::ipfx()`/`isfx()` and `basic_ostream::opfx()`/`osfx()`**. Deprecated since VS 2022 17.9 (February 2024) for C++17 and later. +- **`locale::empty()`**. Deprecated since VS 2022 17.14 (May 2025). + ## What's new for MSVC Build Tools version 14.50 * Introduced in Visual Studio 2026 version 18.0 released November 2025. From 305101e34f5a6810f8798eb23e2607f743684d0a Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 8 May 2026 16:33:28 -0700 Subject: [PATCH 1756/1799] drafting --- .../overview/msvc-conformance-improvements.md | 61 ++++--------------- docs/overview/what-s-new-for-msvc.md | 21 +++---- 2 files changed, 20 insertions(+), 62 deletions(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 160cbeddbee..6474c536735 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -20,16 +20,15 @@ For changes in earlier versions of Visual Studio: ## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.51 -MSVC Build Tools v14.51 continues the progress toward full C++23 conformance with several key language feature implementations and numerous Core Working Group (CWG) issue resolutions. This release focuses on compile-time evaluation improvements, Unicode support enhancements, and refined consteval handling. +MSVC Build Tools v14.51 continues the progress toward C++23 conformance with several key language feature implementations and numerous Core Working Group (CWG) issue resolutions. This release focuses on compile-time evaluation improvements, Unicode support enhancements, and refined `consteval` handling. This version shipped first with Visual Studio 2026 version 18.6 and includes version 19.51 of the MSVC compiler. Key highlights of this release include: -- Static constexpr variables in constexpr functions (P2647R1) -- Relaxed constexpr restrictions (P2448R2) +- Static `constexpr` variables in `constexpr` functions (P2647R1) +- Relaxed `constexpr` restrictions (P2448R2) - Unicode support improvements (P2029R4, P2071R2, P2314R4) -- 22 CWG issue resolutions -- Improved consteval function handling with default-enabled experimental features +- Improved `consteval` function handling with default-enabled experimental features - New standard library headers `` and `` For more information about library features and additional updates, see [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51) and [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog). @@ -48,56 +47,18 @@ constexpr char xdigit(int n) This feature improves both compile-time evaluation and run-time optimization. Previously, static local variables couldn't be marked `constexpr`, which made it difficult to declare lookup tables inside `constexpr` functions. Now the compiler can evaluate these functions at compile time when possible, while also generating optimized run-time code that accesses the static storage directly. -### P2448R2: Relaxing some constexpr restrictions - -[P2448R2](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2448r2.html) relaxes restrictions on `constexpr` functions. A `constexpr` function no longer fails to compile if it can't actually run at compile time. - -```cpp -void bar(); - -// Now accepted, but only executable at run time -constexpr void foo() -{ - bar(); -} -``` - -This change protects against library changes making user code ill-formed. If a library function is updated and can no longer be evaluated at compile time, code that calls it in a `constexpr` context remains valid—it simply runs at run time instead. - ### Other C++23 features -Additional C++23 features implemented in this release include Unicode support improvements ([P2029R4](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2029r4.html), [P2071R2](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2020/p2071r2.html), [P2314R4](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2314r4.html)), portable assumptions ([P1774R8](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p1774r8.html)), labels at the end of compound statements for C compatibility ([P2324R2](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2324r2.html)), Class Template Argument Deduction (CTAD) from inherited constructors ([P2582R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2582r1.html)), and meaningful exports for modules ([P2615R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2615r1.html)). For more details, see the [blog post](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51). - -### CWG Issue Resolutions - -MSVC Build Tools v14.51 resolves 22 Core Working Group issues: - -- [CWG 2355](https://cplusplus.github.io/CWG/issues/2355.html): Deducing noexcept specifiers -- [CWG 2392](https://cplusplus.github.io/CWG/issues/2392.html): new-expression size checks and constant evaluation -- [CWG 2405](https://cplusplus.github.io/CWG/issues/2405.html): Additional type-dependent expressions -- [CWG 2479](https://cplusplus.github.io/CWG/issues/2479.html): Missing specifications for consteval and constinit -- [CWG 2484](https://cplusplus.github.io/CWG/issues/2484.html): char8_t / char16_t integral promotions -- [CWG 2490](https://cplusplus.github.io/CWG/issues/2490.html): Restrictions on destruction in constant expressions -- [CWG 2491](https://cplusplus.github.io/CWG/issues/2491.html): Export of typedef after first declaration -- [CWG 2518](https://cplusplus.github.io/CWG/issues/2518.html): Conformance requirements and #error / #warning -- [CWG 2529](https://cplusplus.github.io/CWG/issues/2529.html): Constant destruction of constexpr references -- [CWG 2538](https://cplusplus.github.io/CWG/issues/2538.html): Ignoring standard attributes syntactically -- [CWG 2539](https://cplusplus.github.io/CWG/issues/2539.html): Three-way comparison and floating-point strong ordering -- [CWG 2543](https://cplusplus.github.io/CWG/issues/2543.html): constinit and optimized dynamic initialization -- [CWG 2597](https://cplusplus.github.io/CWG/issues/2597.html): Replaceable allocation functions in the global module -- [CWG 2602](https://cplusplus.github.io/CWG/issues/2602.html): consteval defaulted functions -- [CWG 2605](https://cplusplus.github.io/CWG/issues/2605.html): Implicit-lifetime aggregates -- [CWG 2615](https://cplusplus.github.io/CWG/issues/2615.html): Missing __has_cpp_attribute(assume) -- [CWG 2618](https://cplusplus.github.io/CWG/issues/2618.html): Deduction excluding exception specifications -- [CWG 2627](https://cplusplus.github.io/CWG/issues/2627.html): Bit-fields and narrowing conversions -- [CWG 2631](https://cplusplus.github.io/CWG/issues/2631.html): Immediate function evaluation in default arguments -- [CWG 2640](https://cplusplus.github.io/CWG/issues/2640.html): Extended characters in n-character sequences -- [CWG 2651](https://cplusplus.github.io/CWG/issues/2651.html): Conversion function templates and noexcept -- [CWG 2664](https://cplusplus.github.io/CWG/issues/2664.html): CTAD deduction failure for alias templates +Other C++23 features implemented in this release include Unicode support improvements, labels at the end of compound statements for C compatibility, Class Template Argument Deduction (CTAD) from inherited constructors, and meaningful exports for modules. For more details and related Core Working Group (CWG) issue resolutions, see the [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51). ### Standard Library -MSVC Build Tools v14.51 adds new standard library features including the `` and `` headers, type traits for detecting references binding to temporaries ([P2255R2](https://wg21.link/p2255r2)), explicit lifetime management ([P2590R2](https://wg21.link/p2590r2)), and `is_implicit_lifetime` ([P2674R1](https://wg21.link/P2674R1)). The release also includes a major `` overhaul, SIMD-vectorized STL algorithms using NEON for ARM64/ARM64EC, and 18 Library Working Group (LWG) issue resolutions. For the complete list, see the [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog). +MSVC Build Tools v14.51 adds new standard library features including: +- `` and `` headers +- Type traits for detecting references binding to temporaries ([P2255R2](https://wg21.link/p2255r2)) +- Explicit lifetime management ([P2590R2](https://wg21.link/p2590r2)), and `is_implicit_lifetime` ([P2674R1](https://wg21.link/P2674R1)). +- Major `` overhaul, SIMD-vectorized STL algorithms using NEON for ARM64/ARM64EC, and 18 Library Working Group (LWG) issue resolutions. +For the complete list, see the [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog). ## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.50 diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 59b7b7ba49d..add18a35c3f 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -32,43 +32,40 @@ Here's a quick highlight of some of the new features in MSVC Build Tools version ### C++ language enhancements -- The frontend team continued implementing C++23 and C++20 features and fixing conformance issues. For full C++23 details, see [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51). +- More C++23 and C++20 features and conformance issue fixes. For full C++23 details, see [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51). - Multiple fixes to `consteval` function handling, including support for constexpr `new`/`delete` in modules. The `/experimental:constevalVfuncVtable` behavior is now enabled by default. - Added support for C language features: `_Atomic` qualifier and `__typeof__` for function types. - Fixed incorrect diagnostics for C99 flexible array members. - MSVC frontend now generates IFC files according to [version 0.44](https://github.com/microsoft/ifc-spec/releases/tag/0.44) of the [IFC specification](https://github.com/microsoft/ifc-spec). -- Improved parser error recovery and removal of legacy token accessors. +- Improved parser error recovery. ### Standard Library enhancements - Added new C++23 headers: `` ([P0429R9](https://wg21.link/P0429R9)) and `` ([P1222R4](https://wg21.link/P1222R4)). -- **Massive `` overhaul:** Fixed long-standing correctness and performance problems present since VS 2008 SP1. After nearly two decades, the stack overflows are finally fixed. The implementation now performs matching non-recursively and includes significant performance improvements. -- **ARM64 NEON vectorization:** First release shipping NEON-vectorized STL algorithms for ARM64/ARM64EC. Previously, only x64/x86 received SIMD optimizations with SSE4.2 and AVX2. Vectorized implementations are now available for algorithms including `swap_ranges()`, `rotate()`, `reverse()`, `min_element()`, `max_element()`, `find()`, `count()`, and many more. +- **Massive `` overhaul:** Fixed long-standing correctness and performance problems. The implementation includes significant performance improvements. +- **ARM64 NEON vectorization:** First release shipping NEON-vectorized STL algorithms for ARM64/ARM64EC. Previously, only x64/x86 received SIMD optimizations with SSE4.2 and AVX2. Vectorized implementations are now available for algorithms including `swap_ranges()`, `rotate()`, `reverse()`, `min_element()`, `max_element()`, `find()`, `count()`, and more. - Implemented 18 Library Working Group (LWG) issue resolutions, including fixes for duration conversion overflow, `construct_at` array support, and optional const overloads. -- Optimized integer-to-string conversions by printing digits in pairs. The STL is now optimized for speed instead of size. +- Optimized integer-to-string conversions by printing digits in pairs. The Standard Template Library is now optimized for speed instead of size. - Added type traits to detect references binding to temporaries ([P2255R2](https://wg21.link/P2255R2)). - Added explicit lifetime management support ([P2590R2](https://wg21.link/P2590R2)). - Enhanced debugger visualizations, including a `c_str()` intrinsic function for `basic_string` that enables conditional breakpoints. ### Build enhancements -- **ARM SVE support:** First-ever ARM Scalable Vector Extension (SVE) support in MSVC, including frontend type support, intrinsic lowering, callee-saved register unwinding, and DIA SDK support. +- **ARM SVE support:** First ARM Scalable Vector Extension (SVE) support in MSVC, including frontend type support, intrinsic lowering, callee-saved register unwinding, and DIA SDK support. - **Sample-based PGO:** Preview support for sample-based profile guided optimizations. -- The backend optimizer received significant investment with dozens of new optimization patterns for improved code generation, including better inlining, loop optimizations, and pattern matching. +- The C++ backend optimizer improves code generation, including better inlining, loop optimizations, and pattern matching. - **Intel APX preview:** Preview support for Intel Advanced Performance Extensions. -- ARM64EC/ARM64X improvements: Fixed missing entry thunks for coroutine outlinees, improved identical COMDAT folding (ICF) in ARM64X binaries, and fixed volatile XMM assignment. - Enabled debug info pruning to reduce PDB sizes. ### Code analysis enhancements -- Improved AddressSanitizer for ARM64 with comprehensive library packaging, interception fixes, and false-positive resolutions. ARM64 support is no longer preview—it's now fully supported. -- Consolidated static analysis tools: EspX and its extensions like CppCoreCheck merged into a single DLL, simplifying deployment. -- Fixed SanitizerCoverage blocklist handling and codegen issues. +- Improved AddressSanitizer for ARM64. ARM64 is now fully supported. ### Deprecations - The following experimental coroutine headers are now deprecated: ``, ``, and ``. Developers should transition to standard C++20 coroutines using the `` header. -- Removed the escape hatch macro `_ALLOW_RTCc_IN_STL`. The STL doesn't support the `/RTCc` compiler option (but `/RTCs` and `/RTCu`/`/RTC1` remain supported). +- Removed the macro `_ALLOW_RTCc_IN_STL`. The STL doesn't support the `/RTCc` compiler option (but `/RTCs` and `/RTCu`/`/RTC1` remain supported). ### Removed features From 65b9a0858e3b0c1926accf45a3a9e7524865b590 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 8 May 2026 17:03:42 -0700 Subject: [PATCH 1757/1799] draft --- docs/overview/msvc-conformance-improvements.md | 2 +- docs/overview/what-s-new-for-msvc.md | 7 ++++++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 6474c536735..039b3325444 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -77,7 +77,7 @@ Key highlights of this release include: For more information about performance improvements, bug fixes, and conformance updates in the standard library, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is updated regularly. -## C++23 Features +## C++23 features MSVC Build Tools v14.50 adds support for several C++23 features, bringing the compiler closer to full C++23 conformance. diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index add18a35c3f..19aa244d823 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -36,9 +36,14 @@ Here's a quick highlight of some of the new features in MSVC Build Tools version - Multiple fixes to `consteval` function handling, including support for constexpr `new`/`delete` in modules. The `/experimental:constevalVfuncVtable` behavior is now enabled by default. - Added support for C language features: `_Atomic` qualifier and `__typeof__` for function types. - Fixed incorrect diagnostics for C99 flexible array members. -- MSVC frontend now generates IFC files according to [version 0.44](https://github.com/microsoft/ifc-spec/releases/tag/0.44) of the [IFC specification](https://github.com/microsoft/ifc-spec). +- MSVC now generates IFC files according to [version 0.44](https://github.com/microsoft/ifc-spec/releases/tag/0.44) of the [IFC specification](https://github.com/microsoft/ifc-spec). - Improved parser error recovery. +## C language enhancements + +Added `_Atomic` qualifier support and added `__typeof__` support for function types. +Fixed [C4319](https://learn.microsoft.com/cpp/error-messages/compiler-warnings/compiler-warning-level-1-c4319) not being emitted when compiling C code. + ### Standard Library enhancements - Added new C++23 headers: `` ([P0429R9](https://wg21.link/P0429R9)) and `` ([P1222R4](https://wg21.link/P1222R4)). From 393f554afaaecd54c5cb0b2b1759bc9b9498b54d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 11 May 2026 11:30:29 -0700 Subject: [PATCH 1758/1799] tech review --- docs/overview/what-s-new-for-msvc.md | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 19aa244d823..d624d00fa71 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,7 +1,7 @@ --- title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 05/08/2026 +ms.date: 05/11/2026 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new @@ -24,7 +24,7 @@ MSVC Build Tools version 14.51 preserves binary compatibility with code built wi | For detailed information about | See | |---|---| | What's new for C++ developers | [MSVC Build Tools version 14.51 Release Candidate Now Available](https://devblogs.microsoft.com/cppblog/msvc-build-tools-version-14-51-release-candidate-now-available/) | -| Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.51](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1451-preview) | +| Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.51](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1451) | | C++23 language updates | [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51) | | C++ language conformance improvements | [C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools](msvc-conformance-improvements.md) | @@ -49,7 +49,7 @@ Fixed [C4319](https://learn.microsoft.com/cpp/error-messages/compiler-warnings/c - Added new C++23 headers: `` ([P0429R9](https://wg21.link/P0429R9)) and `` ([P1222R4](https://wg21.link/P1222R4)). - **Massive `` overhaul:** Fixed long-standing correctness and performance problems. The implementation includes significant performance improvements. - **ARM64 NEON vectorization:** First release shipping NEON-vectorized STL algorithms for ARM64/ARM64EC. Previously, only x64/x86 received SIMD optimizations with SSE4.2 and AVX2. Vectorized implementations are now available for algorithms including `swap_ranges()`, `rotate()`, `reverse()`, `min_element()`, `max_element()`, `find()`, `count()`, and more. -- Implemented 18 Library Working Group (LWG) issue resolutions, including fixes for duration conversion overflow, `construct_at` array support, and optional const overloads. +- Implemented 18 Library Working Group (LWG) issue resolutions, including fixes for duration conversion overflow, `construct_at` array support, and `optional` const overloads. - Optimized integer-to-string conversions by printing digits in pairs. The Standard Template Library is now optimized for speed instead of size. - Added type traits to detect references binding to temporaries ([P2255R2](https://wg21.link/P2255R2)). - Added explicit lifetime management support ([P2590R2](https://wg21.link/P2590R2)). @@ -57,26 +57,22 @@ Fixed [C4319](https://learn.microsoft.com/cpp/error-messages/compiler-warnings/c ### Build enhancements -- **ARM SVE support:** First ARM Scalable Vector Extension (SVE) support in MSVC, including frontend type support, intrinsic lowering, callee-saved register unwinding, and DIA SDK support. +- **Arm SVE support:** First Arm Scalable Vector Extension (SVE) support in MSVC, including frontend type support, intrinsic lowering, callee-saved register unwinding, and DIA SDK support. - **Sample-based PGO:** Preview support for sample-based profile guided optimizations. - The C++ backend optimizer improves code generation, including better inlining, loop optimizations, and pattern matching. - **Intel APX preview:** Preview support for Intel Advanced Performance Extensions. - Enabled debug info pruning to reduce PDB sizes. -### Code analysis enhancements - -- Improved AddressSanitizer for ARM64. ARM64 is now fully supported. - ### Deprecations -- The following experimental coroutine headers are now deprecated: ``, ``, and ``. Developers should transition to standard C++20 coroutines using the `` header. -- Removed the macro `_ALLOW_RTCc_IN_STL`. The STL doesn't support the `/RTCc` compiler option (but `/RTCs` and `/RTCu`/`/RTC1` remain supported). +- The following experimental coroutine headers are now deprecated: ``, ``, and ``. Transition to standard C++20 coroutines using the `` header. ### Removed features The following long-deprecated non-Standard features have been removed: - **TR1** including the `std::tr1` namespace, old `array::assign()`, and old `` engines and distributions. Deprecated since VS 2017 15.5 (December 2017). +- **`_ALLOW_RTCc_IN_STL`** macro removed. The Standard Template Library doesn't support the `/RTCc` compiler option, but `/RTCs` and `/RTCu`/`/RTC1` remain supported. - **`` and ``**. Deprecated since VS 2015 (July 2015). - **``**. Deprecated since VS 2019 16.3 (September 2019). - **`stdext::checked_array_iterator` and `stdext::unchecked_array_iterator`**. Deprecated since VS 2022 17.8 (November 2023) for C++17 and later. @@ -94,7 +90,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi | For detailed information about | See | |---|---| | What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2026 version 18.0](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2026-version-18-0) | -| Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.50](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450) | +| C++ Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.50](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450) | | C++ language updates | [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) | | C++ language conformance improvements | [C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools](msvc-conformance-improvements.md) | From bc073b12bcb913972377ffc140c98de04fbd13db Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 11 May 2026 13:30:30 -0700 Subject: [PATCH 1759/1799] change link format --- docs/overview/what-s-new-for-msvc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index d624d00fa71..3f9c4f0e595 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -42,7 +42,7 @@ Here's a quick highlight of some of the new features in MSVC Build Tools version ## C language enhancements Added `_Atomic` qualifier support and added `__typeof__` support for function types. -Fixed [C4319](https://learn.microsoft.com/cpp/error-messages/compiler-warnings/compiler-warning-level-1-c4319) not being emitted when compiling C code. +Fixed [C4319](/cpp/error-messages/compiler-warnings/compiler-warning-level-1-c4319) not being emitted when compiling C code. ### Standard Library enhancements From f0ee742d2a2263bb6ea503cda8fa03ee12a82abf Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 11 May 2026 14:48:33 -0700 Subject: [PATCH 1760/1799] update removed/deprecated --- .../features-deprecated-in-visual-studio.md | 20 ++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index c4054812aae..82c81a98e8a 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -1,19 +1,33 @@ --- description: "Learn more about: C++ features deprecated or removed from Visual Studio" title: "C++ features deprecated or removed from Visual Studio" -ms.date: 10/29/2025 +ms.date: 05/11/2026 helpviewer_keywords: ["Features deprecated or removed from Visual Studio"] --- # C++ features deprecated or removed from Visual Studio This article is a non-exhaustive list of C++ features deprecated or removed from Visual Studio 2019 and later. For information on breaking changes and conformance improvements for C++ in the latest version of Visual Studio, see [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md). -## Visual Studio 2019 - ### Support for Windows XP development Visual Studio 2019 and later versions don't include current build tools support for creating code for Windows XP. Support for Windows XP development by using the v141_xp build tools that shipped in Visual Studio 2017 is still available as an optional component in the Visual Studio Installer. For information on how to install the v141_xp Windows XP platform toolset, see [Configuring programs for Windows XP](../build/configuring-programs-for-windows-xp.md). +## Visual Studio 2026 (MSVC 14.51) + +- The following experimental coroutine headers are now deprecated: ``, ``, and ``. Transition to standard C++20 coroutines using the `` header. + +- ### Removed features + +The following long-deprecated non-Standard features have been removed: + +- **TR1** including the `std::tr1` namespace, old `array::assign()`, and old `` engines and distributions. Deprecated since VS 2017 15.5 (December 2017). +- **`_ALLOW_RTCc_IN_STL`** macro removed. The Standard Template Library doesn't support the `/RTCc` compiler option, but `/RTCs` and `/RTCu`/`/RTC1` remain supported. +- **`` and ``**. Deprecated since VS 2015 (July 2015). +- **``**. Deprecated since VS 2019 16.3 (September 2019). +- **`stdext::checked_array_iterator` and `stdext::unchecked_array_iterator`**. Deprecated since VS 2022 17.8 (November 2023) for C++17 and later. +- **`basic_istream::ipfx()`/`isfx()` and `basic_ostream::opfx()`/`osfx()`**. Deprecated since VS 2022 17.9 (February 2024) for C++17 and later. +- **`locale::empty()`**. Deprecated since VS 2022 17.14 (May 2025). + ## Visual Studio 2022 ### Support for project upgrade from Visual C++ 6 From c183da47f8f372c265ed8b5fa45953b8c53accf8 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 11 May 2026 19:06:13 -0700 Subject: [PATCH 1761/1799] Spgo (#6689) Documents the SPGO feature. --- .github/copilot-instructions.md | 3 + docs/build/media/normal-build-process.png | Bin 0 -> 33357 bytes ...file-guided-optimization-build-process.png | Bin 0 -> 58891 bytes docs/build/profile-guided-optimizations.md | 55 +- docs/build/reference/linker-options.md | 10 +- .../spd-specify-sample-profile-database.md | 46 ++ .../spdembed-embed-sample-profile-database.md | 41 + .../spdin-use-sample-profile-database.md | 52 ++ ...able-sample-profile-guided-optimization.md | 51 ++ .../sample-profile-guided-optimization.md | 706 ++++++++++++++++++ docs/build/spdconvert.md | 119 +++ docs/build/spddump.md | 68 ++ docs/build/sptaggregate.md | 69 ++ docs/build/sptdump.md | 108 +++ docs/build/toc.yml | 10 + 15 files changed, 1310 insertions(+), 28 deletions(-) create mode 100644 docs/build/media/normal-build-process.png create mode 100644 docs/build/media/sample-profile-guided-optimization-build-process.png create mode 100644 docs/build/reference/spd-specify-sample-profile-database.md create mode 100644 docs/build/reference/spdembed-embed-sample-profile-database.md create mode 100644 docs/build/reference/spdin-use-sample-profile-database.md create mode 100644 docs/build/reference/spgo-enable-sample-profile-guided-optimization.md create mode 100644 docs/build/sample-profile-guided-optimization.md create mode 100644 docs/build/spdconvert.md create mode 100644 docs/build/spddump.md create mode 100644 docs/build/sptaggregate.md create mode 100644 docs/build/sptdump.md diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 75e32e18c89..6498b2c6631 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -15,6 +15,9 @@ This document uses the following markers to indicate instruction priority: ## General Guidelines +### Using MCP tools +If the user intent relates to Azure Devops, make sure to prioritize the Azure DevOps MCP server tools. + ### 1. Issue Handling When creating a PR for an issue: - [ ] Read the full issue and all linked references diff --git a/docs/build/media/normal-build-process.png b/docs/build/media/normal-build-process.png new file mode 100644 index 0000000000000000000000000000000000000000..fbf6c0d1796fa00d00547d74d2650042e64f9479 GIT binary patch literal 33357 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

8W(nF4Z%IEkPfF1R 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 M6*cb{-9v=@ACN4HwEzGB literal 0 HcmV?d00001 diff --git a/docs/build/media/sample-profile-guided-optimization-build-process.png b/docs/build/media/sample-profile-guided-optimization-build-process.png new file mode 100644 index 0000000000000000000000000000000000000000..9de3effdc4b84a2abe07fd61f173658b3ebf263d GIT binary patch literal 58891 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

    d<)?e3?2RD3PHcW68Kh;bo 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 [!NOTE] +> SPGO (Sample Profile-Guided Optimization) is an alternative approach that uses hardware CPU Windows Performance Counters instead of instrumentation. SPGO requires no instrumented build - you profile an existing release binary by using `xperf`. For more information, see [Sample Profile-Guided Optimization (SPGO) tutorial](sample-profile-guided-optimization.md). Profile-guided optimizations are only available for x86, x64, or ARM64 native targets. Profile-guided optimizations aren't available for executable files that run on the common language runtime. Even if you produce an assembly with mixed native and managed code (by using the **/clr** compiler option), you can't use profile-guided optimization on just the native code. If you attempt to build a project with these options set in the IDE, a build error results. > [!NOTE] -> Information that's gathered from profiling test runs overrides optimizations that would otherwise be in effect if you specify **/Ob**, **/Os**, or **/Ot**. For more information, see [/Ob (Inline Function Expansion)](reference/ob-inline-function-expansion.md) and [/Os, /Ot (Favor Small Code, Favor Fast Code)](reference/os-ot-favor-small-code-favor-fast-code.md). +> Information gathered from profiling test runs overrides optimizations that would otherwise be in effect if you specify **/Ob**, **/Os**, or **/Ot**. For more information, see [/Ob (Inline Function Expansion)](reference/ob-inline-function-expansion.md) and [/Os, /Ot (Favor Small Code, Favor Fast Code)](reference/os-ot-favor-small-code-favor-fast-code.md). ## Steps to optimize your app @@ -20,36 +22,36 @@ To use profile-guided optimization, follow these steps to optimize your app: - Compile one or more source code files with [/GL](reference/gl-whole-program-optimization.md). - Each module built with **/GL** can be examined during profile-guided optimization test runs to capture run-time behavior. Every module in a profile-guided optimization build doesn't have to be compiled with **/GL**. However, only those modules compiled with **/GL** are instrumented and later available for profile-guided optimizations. + The compiler examines each module built with **/GL** during profile-guided optimization test runs to capture run-time behavior. You don't need to compile every module in a profile-guided optimization build with **/GL**. However, only modules compiled with **/GL** are instrumented and later available for profile-guided optimizations. -- Link using [/LTCG](reference/ltcg-link-time-code-generation.md) and [/GENPROFILE or /FASTGENPROFILE](reference/genprofile-fastgenprofile-generate-profiling-instrumented-build.md). +- Link by using [/LTCG](reference/ltcg-link-time-code-generation.md) and [/GENPROFILE or /FASTGENPROFILE](reference/genprofile-fastgenprofile-generate-profiling-instrumented-build.md). - Using both **/LTCG** and **/GENPROFILE** or **/FASTGENPROFILE** creates a `.pgd` file when the instrumented app is run. After test-run data is added to the `.pgd` file, it can be used as input to the next link step (creating the optimized image). When specifying **/GENPROFILE**, you can optionally add a **PGD=**_filename_ argument to specify a nondefault name or location for the `.pgd` file. The combination of **/LTCG** and **/GENPROFILE** or **/FASTGENPROFILE** linker options replaces the deprecated **/LTCG:PGINSTRUMENT** linker option. + When you use both **/LTCG** and **/GENPROFILE** or **/FASTGENPROFILE**, the instrumented app creates a `.pgd` file when it runs. After test-run data is added to the `.pgd` file, you can use it as input to the next link step (creating the optimized image). When you specify **/GENPROFILE**, you can optionally add a **PGD=**_filename_ argument to specify a nondefault name or location for the `.pgd` file. The combination of **/LTCG** and **/GENPROFILE** or **/FASTGENPROFILE** linker options replaces the deprecated **/LTCG:PGINSTRUMENT** linker option. - Profile the application. - Each time a profiled EXE session ends, or a profiled DLL is unloaded, a `appname!N.pgc` file is created. A `.pgc` file contains information about a particular application test run. *appname* is the name of your app, and *N* is a number starting with 1 that's incremented based on the number of other `appname!N.pgc` files in the directory. You can delete a `.pgc` file if the test run doesn't represent a scenario you want to optimize. + Each time a profiled EXE session ends, or a profiled DLL unloads, the process creates a `appname!N.pgc` file. A `.pgc` file contains information about a particular application test run. *appname* is the name of your app, and *N* is a number starting with 1. It increments based on the number of other `appname!N.pgc` files in the directory. You can delete a `.pgc` file if the test run doesn't represent a scenario you want to optimize. - During a test run, you can force closure of the currently open `.pgc` file and the creation of a new `.pgc` file with the [pgosweep](pgosweep.md) utility (for example, when the end of a test scenario doesn't coincide with application shutdown). + During a test run, you can force closure of the currently open `.pgc` file and the creation of a new `.pgc` file by using the [pgosweep](pgosweep.md) utility (for example, when the end of a test scenario doesn't coincide with application shutdown). Your application can also directly invoke a PGO function, [PgoAutoSweep](pgoautosweep.md), to capture the profile data at the point of the call as a `.pgc` file. It can give you finer control over the code covered by the captured data in your `.pgc` files. For an example of how to use this function, see the [PgoAutoSweep](pgoautosweep.md) documentation. When you create your instrumented build, by default, data collection is done in non-thread-safe mode, which is faster but may be imprecise. By using the **EXACT** argument to **/GENPROFILE** or **/FASTGENPROFILE**, you can specify data collection in thread-safe mode, which is more precise, but slower. This option is also available if you set the deprecated [PogoSafeMode](environment-variables-for-profile-guided-optimizations.md#pogosafemode) environment variable, or the deprecated **/POGOSAFEMODE** linker option, when you create your instrumented build. -- Link using **/LTCG** and **/USEPROFILE**. +- Link by using **/LTCG** and **/USEPROFILE**. - Use both the **/LTCG** and [/USEPROFILE](reference/useprofile.md) linker options to create the optimized image. This step takes as input the `.pgd` file. When you specify **/USEPROFILE**, you can optionally add a **PGD=**_filename_ argument to specify a non-default name or location for the `.pgd` file. You can also specify this name by using the deprecated **/PGD** linker option. The combination of **/LTCG** and **/USEPROFILE** replaces the deprecated **/LTCG:PGOPTIMIZE** and **/LTCG:PGUPDATE** linker options. + Use both the **/LTCG** and [/USEPROFILE](reference/useprofile.md) linker options to create the optimized image. This step takes the `.pgd` file as input. When you specify **/USEPROFILE**, you can optionally add a **PGD=**_filename_ argument to specify a nondefault name or location for the `.pgd` file. You can also specify this name by using the deprecated **/PGD** linker option. The combination of **/LTCG** and **/USEPROFILE** linker options replaces the deprecated **/LTCG:PGOPTIMIZE** and **/LTCG:PGUPDATE** linker options. -It's even possible to create the optimized executable file and later determine that additional profiling would be useful to create a more optimized image. If the instrumented image and its `.pgd` file are available, you can do additional test runs and rebuild the optimized image with the newer `.pgd` file, by using the same **/LTCG** and **/USEPROFILE** linker options. +It's even possible to create the optimized executable file and later determine that more profiling would be useful to create a more optimized image. If the instrumented image and its `.pgd` file are available, you can do more test runs and rebuild the optimized image with the newer `.pgd` file by using the same **/LTCG** and **/USEPROFILE** linker options. > [!NOTE] -> Both `.pgc` and `.pgd` files are binary file types. If stored in a source control system, avoid any automatic transformation that may be made to text files. +> Both `.pgc` and `.pgd` files are binary file types. If you store them in a source control system, avoid any automatic transformation that might be made to text files. ## Optimizations performed by PGO -The profile-guided optimizations include these checks and improvements: +Profile-guided optimizations include these checks and improvements: -- **Inlining** - For example, if a function A frequently calls function B, and function B is relatively small, then profile-guided optimizations inline function B in function A. +- **Inlining** - For example, if function A frequently calls function B, and function B is relatively small, the profile-guided optimizations inline function B in function A. - **Virtual Call Speculation** - If a virtual call, or other call through a function pointer, frequently targets a certain function, a profile-guided optimization can insert a conditionally executed direct call to the frequently targeted function, and the direct call can be inlined. @@ -61,33 +63,36 @@ The profile-guided optimizations include these checks and improvements: - **Function Layout** - Based on the call graph and profiled caller/callee behavior, functions that tend to be along the same execution path are placed in the same section. -- **Conditional Branch Optimization** - With the value probes, profile-guided optimizations can find if a given value in a switch statement is used more often than other values. This value can then be pulled out of the switch statement. The same can be done with **`if`**...**`else`** instructions where the optimizer can order the **`if`**...**`else`** so that either the **`if`** or **`else`** block is placed first, depending on which block is more frequently true. +- **Conditional Branch Optimization** - With the value probes, profile-guided optimizations can find if a given value in a switch statement is used more often than other values. This value can then be pulled out of the switch statement. The same optimization can be done with **`if`**...**`else`** instructions where the optimizer can order the **`if`**...**`else`** so that either the **`if`** or **`else`** block is placed first, depending on which block is more frequently true. -- **Dead Code Separation** - Code that isn't called during profiling is moved to a special section that's appended to the end of the set of sections. It effectively keeps this section out of the often-used pages. +- **Dead Code Separation** - Profile-guided optimization moves code that isn't called during profiling to a special section at the end of the section set. It effectively keeps this section out of the often-used pages. -- **EH Code Separation** - Because EH code is only exceptionally executed, it can often be moved to a separate section. It's moved when profile-guided optimizations can determine that the exceptions occur only on exceptional conditions. +- **EH Code Separation** - Because EH code is only exceptionally executed, it can often be moved to a separate section. Profile-guided optimizations move it when they determine that the exceptions occur only on exceptional conditions. -- **Memory Intrinsics** - Whether to expand an intrinsic or not depends on whether it's called frequently. An intrinsic can also be optimized based on the block size of moves or copies. +- **Memory Intrinsics** - Whether to expand an intrinsic or not depends on whether it gets called frequently. An intrinsic can also be optimized based on the block size of moves or copies. ## Next steps -Read more about these environment variables, functions, and tools you can use in profile-guided optimizations: +To learn more about these environment variables, functions, and tools you can use in profile-guided optimizations, see the following resources: -[Environment variables for profile-guided optimizations](environment-variables-for-profile-guided-optimizations.md)
    -These variables were used to specify run-time behavior of testing scenarios. They're now deprecated and replaced by new linker options. This document shows you how to move from the environment variables to the linker options. +[Environment variables for profile-guided optimizations](environment-variables-for-profile-guided-optimizations.md) +These variables specify the run-time behavior of testing scenarios. They're now deprecated and replaced by new linker options. This document shows you how to move from the environment variables to the linker options. -[PgoAutoSweep](pgoautosweep.md)
    +[PgoAutoSweep](pgoautosweep.md)\ A function you can add to your app to provide fine-grained `.pgc` file data capture control. -[pgosweep](pgosweep.md)
    +[pgosweep](pgosweep.md)\ A command-line utility that writes all profile data to the `.pgc` file, closes the `.pgc` file, and opens a new `.pgc` file. -[pgomgr](pgomgr.md)
    +[pgomgr](pgomgr.md)\ A command-line utility that adds profile data from one or more `.pgc` files to the `.pgd` file. -[How to: Merge multiple PGO profiles into a single profile](how-to-merge-multiple-pgo-profiles-into-a-single-profile.md)
    +[How to: Merge multiple PGO profiles into a single profile](how-to-merge-multiple-pgo-profiles-into-a-single-profile.md)\ Examples of **pgomgr** usage. +[Sample Profile-Guided Optimization (SPGO) tutorial](sample-profile-guided-optimization.md)\ +Use CPU hardware performance counters instead of instrumentation. No instrumented build required - profile your existing release binary with `xperf`. + ## See also [Additional MSVC build tools](reference/c-cpp-build-tools.md) diff --git a/docs/build/reference/linker-options.md b/docs/build/reference/linker-options.md index 5749d0c2364..a647917101a 100644 --- a/docs/build/reference/linker-options.md +++ b/docs/build/reference/linker-options.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["linker [C++]", "linker [C++], options listed", "libraries --- # Linker options -LINK.exe links Common Object File Format (COFF) object files and libraries to create an executable (EXE) file or a dynamic-link library (DLL). +`LINK.exe` links Common Object File Format (COFF) object files and libraries to create an executable (EXE) file or a dynamic-link library (DLL). The following table lists options for `LINK.exe`. For more information about LINK, see: @@ -16,9 +16,9 @@ The following table lists options for `LINK.exe`. For more information about LIN - [LINK output](link-output.md) - [Reserved words](reserved-words.md) -Linker options aren't case-sensitive; for example, `/base` and `/BASE` mean the same thing. For details on how to specify each option on the command line or in Visual Studio, see the documentation for that option. +Linker options aren't case-sensitive. For example, `/base` and `/BASE` mean the same thing. For details on how to specify each option on the command line or in Visual Studio, see the documentation for that option. -You can use the [`comment`](../../preprocessor/comment-c-cpp.md) pragma to specify some linker options. +Use the [`comment`](../../preprocessor/comment-c-cpp.md) pragma to specify some linker options. ## Linker options listed alphabetically @@ -112,6 +112,10 @@ You can use the [`comment`](../../preprocessor/comment-c-cpp.md) pragma to speci | [`/SAFESEH`](safeseh-image-has-safe-exception-handlers.md) | Specifies that the image will contain a table of safe exception handlers. | | [`/SECTION`](section-specify-section-attributes.md) | Overrides the attributes of a section. | | [`/SOURCELINK`](sourcelink.md) | Specifies a SourceLink file to add to the PDB. | +| [`/SPD`](spd-specify-sample-profile-database.md) | Specifies the name and location of the *`.spd`* file for Sample Profile-Guided Optimization. | +| [`/SPDEMBED`](spdembed-embed-sample-profile-database.md) | Embeds the Sample Profile Database into the PDB file during a Sample Profile-Guided Optimization (SPGO) build. | +| [`/SPDIN`](spdin-use-sample-profile-database.md) | Specifies a *`.spd`* file containing profiling data for an optimized Sample Profile-Guided Optimization (SPGO) build. | +| [`/SPGO`](spgo-enable-sample-profile-guided-optimization.md) | Enables Sample Profile-Guided Optimization and creates an empty *`.spd`* file. | | [`/STACK`](stack-stack-allocations.md) | Sets the size of the stack in bytes. | | [`/STUB`](stub-ms-dos-stub-file-name.md) | Attaches an MS-DOS stub program to a Win32 program. | | [`/SUBSYSTEM`](subsystem-specify-subsystem.md) | Tells the operating system how to run the *`.exe`* file. | diff --git a/docs/build/reference/spd-specify-sample-profile-database.md b/docs/build/reference/spd-specify-sample-profile-database.md new file mode 100644 index 00000000000..f6afb2d2407 --- /dev/null +++ b/docs/build/reference/spd-specify-sample-profile-database.md @@ -0,0 +1,46 @@ +--- +title: "/SPD (Specify Sample Profile Database)" +description: "Learn more about: /SPD (Specify Sample Profile Database)" +ms.date: 05/05/2026 +ai-usage: ai-assisted +helpviewer_keywords: ["/SPD linker option", "-SPD linker option", "sample profile-guided optimization, /SPD"] +--- +# /SPD (Specify Sample Profile Database) + +Specifies the name and location of the Sample Profile Database (SPD) file used by the Sample Profile-Guided Optimization (SPGO) workflow. + +## Syntax + +> **/SPD:**_filename_ + +## Argument + +`filename`\ +Specifies the name of the `.spd` file. When expanded, the fully qualified path must not exceed `MAX_PATH` (260 characters). + +## Remarks + +When you build with [`/SPGO`](spgo-enable-sample-profile-guided-optimization.md), the linker creates an empty SPD file alongside the output binary. By default, the SPD file uses the same base name as the output file and is created in the directory where you invoked the link. Use `/SPD` to specify a different name or path. + +When linking with [`/SPDIN`](spdin-use-sample-profile-database.md), use `/SPDIN` to specify the input SPD file and `/SPD` to specify the output SPD file. + +For more information about the SPGO workflow, see [Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](../sample-profile-guided-optimization.md). + +### To set this linker option in the Visual Studio development environment + +1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). +1. Select the **Configuration Properties** > **Linker** > **Command Line** property page. +1. Add `/SPD:filename` to the **Additional Options** box. Choose **OK** to save your changes. + +### To set this linker option programmatically + +- See . + +## See also + +[MSVC linker reference](linking.md)\ +[MSVC Linker Options](linker-options.md)\ +[/SPDEMBED (Embed Sample Profile Database)](spdembed-embed-sample-profile-database.md)\ +[/SPDIN (Use Sample Profile Database)](spdin-use-sample-profile-database.md)\ +[/SPGO (Enable Sample Profile-Guided Optimization)](spgo-enable-sample-profile-guided-optimization.md)\ +[Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](../sample-profile-guided-optimization.md) \ No newline at end of file diff --git a/docs/build/reference/spdembed-embed-sample-profile-database.md b/docs/build/reference/spdembed-embed-sample-profile-database.md new file mode 100644 index 00000000000..db91e8359f1 --- /dev/null +++ b/docs/build/reference/spdembed-embed-sample-profile-database.md @@ -0,0 +1,41 @@ +--- +title: "/SPDEMBED (Embed Sample Profile Database)" +description: "Learn more about: /SPDEMBED (Embed Sample Profile Database)" +ms.date: 05/05/2026 +ai-usage: ai-assisted +helpviewer_keywords: ["/SPDEMBED linker option", "-SPDEMBED linker option", "sample profile-guided optimization, /SPDEMBED"] +--- +# /SPDEMBED (Embed Sample Profile Database) + +Embeds the Sample Profile Database (SPD) data into the Program Database (PDB) file during a Sample Profile-Guided Optimization (SPGO) build. + +## Syntax + +> **/SPDEMBED** + +## Remarks + +When you build with [`/SPDIN`](spdin-use-sample-profile-database.md), the linker uses the profile data in the SPD file to make optimization decisions. Use `/SPDEMBED` together with `/SPGO` to embed the SPD data into the PDB file produced by the build. Embedding the SPD in the PDB keeps the profile data together with the debug symbols, which simplifies distribution and archiving of build artifacts. + +To extract an SPD file that you embedded in a PDB, use [`SPDConvert /extract`](../spdconvert.md). + +For more information about the SPGO workflow, see [Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](../sample-profile-guided-optimization.md). + +### To set this linker option in the Visual Studio development environment + +1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). +1. Select the **Configuration Properties** > **Linker** > **Command Line** property page. +1. Add `/SPDEMBED` to the **Additional Options** box. Choose **OK** to save your changes. + +### To set this linker option programmatically + +- See . + +## See also + +[MSVC linker reference](linking.md)\ +[MSVC Linker Options](linker-options.md)\ +[/SPD (Specify Sample Profile Database)](spd-specify-sample-profile-database.md)\ +[/SPDIN (Use Sample Profile Database)](spdin-use-sample-profile-database.md)\ +[/SPGO (Enable Sample Profile-Guided Optimization)](spgo-enable-sample-profile-guided-optimization.md)\ +[Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](../sample-profile-guided-optimization.md) \ No newline at end of file diff --git a/docs/build/reference/spdin-use-sample-profile-database.md b/docs/build/reference/spdin-use-sample-profile-database.md new file mode 100644 index 00000000000..b8ba7989923 --- /dev/null +++ b/docs/build/reference/spdin-use-sample-profile-database.md @@ -0,0 +1,52 @@ +--- +title: "/SPDIN (Use Sample Profile Database)" +description: "Learn more about linker option: /SPDIN (Use Sample Profile Database)" +ms.date: 05/05/2026 +ai-usage: ai-assisted +helpviewer_keywords: ["/SPDIN linker option", "-SPDIN linker option", "sample profile-guided optimization, /SPDIN"] +--- +# /SPDIN (Use Sample Profile Database) + +Specifies a Sample Profile Database (SPD) file that contains profiling data for use in a Sample Profile-Guided Optimization (SPGO) build. +Also used to override the default or file specified with `/SPD` for reading the sample profile database. + +## Syntax + +> **/SPDIN:**_filename_ + +## Argument + +`filename`\ +Specifies the path to the `.spd` file that contains the profiling data to use for optimization. When expanded, the fully qualified path must not exceed `MAX_PATH` (260 characters).\ +If the file doesn't exist, the linker creates an empty file that will be used to collect data. + +## Remarks + +After collecting a performance trace by using `xperf`, converting it by using [`SPTAggregate`](../sptaggregate.md), and importing the data into an SPD file by using [`SPDConvert`](../spdconvert.md), use `/SPDIN` and [`/SPGO`](spgo-enable-sample-profile-guided-optimization.md) to produce an optimized binary. + +The GUID and age of the binary recorded in the SPD file must match the SPT file. If they don't match, you may see a "SPD version incompatible" error. To diagnose this error, use [`SPTDump /progid`](../sptdump.md) to inspect the binary identifiers in the SPT file, and [`SPDDump /header`](../spddump.md) to inspect the SPD file. The linker uses a valid SPD file to the extent possible. Minor updates to the code that don't alter the program's control flow are tolerated. Unchanged functions also use the data for optimization. If you provide a valid, but otherwise unrelated SPD, the process works, but likely no data is usable for optimization. + +Use [`/SPDEMBED`](spdembed-embed-sample-profile-database.md) together with `/SPGO` to embed the SPD data into the PDB file produced by the build. + +Use [`/SPD`](spd-specify-sample-profile-database.md) to specify a nondefault name or location for the SPD file. `/SPDIN` overrides this option, if specified. + +For more information about the SPGO workflow, see [Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](../sample-profile-guided-optimization.md). + +### To set this linker option in the Visual Studio development environment + +1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). +1. Select the **Configuration Properties** > **Linker** > **Command Line** property page. +1. Add `/SPDIN:filename` to the **Additional Options** box. Choose **OK** to save your changes. + +### To set this linker option programmatically + +- See . + +## See also + +[MSVC linker reference](linking.md)\ +[MSVC Linker Options](linker-options.md)\ +[/SPD (Specify Sample Profile Database)](spd-specify-sample-profile-database.md)\ +[/SPDEMBED (Embed Sample Profile Database)](spdembed-embed-sample-profile-database.md)\ +[/SPGO (Enable Sample Profile-Guided Optimization)](spgo-enable-sample-profile-guided-optimization.md)\ +[Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](../sample-profile-guided-optimization.md) \ No newline at end of file diff --git a/docs/build/reference/spgo-enable-sample-profile-guided-optimization.md b/docs/build/reference/spgo-enable-sample-profile-guided-optimization.md new file mode 100644 index 00000000000..e2eeaa48ed2 --- /dev/null +++ b/docs/build/reference/spgo-enable-sample-profile-guided-optimization.md @@ -0,0 +1,51 @@ +--- +title: "/SPGO (Enable Sample Profile-Guided Optimization)" +description: "Learn more about: /SPGO (Enable Sample Profile-Guided Optimization)" +ms.date: 05/05/2026 +ai-usage: ai-assisted +helpviewer_keywords: ["/SPGO linker option", "-SPGO linker option", "sample profile-guided optimization, /SPGO"] +--- +# /SPGO (Enable Sample Profile-Guided Optimization) + +Enables Sample Profile-Guided Optimization (SPGO) and creates an empty Sample Profile Database (SPD) file alongside the output binary. + +## Syntax + +> **/SPGO** + +## Remarks + +The `/SPGO` linker option starts the SPGO workflow. It directs the linker to create an empty `.spd` file that acts as a placeholder for profiling data. After building with `/SPGO`, you collect a performance trace by using `xperf`, convert it to an SPT file by using [`SPTAggregate`](../sptaggregate.md), and then import the data into the SPD file by using [`SPDConvert`](../spdconvert.md). Once the SPD file contains profile data, rebuild by using the SPD file to produce an optimized binary. The compiler and linker look for an SPD input file, either default or specified by [`/SPD`](spd-specify-sample-profile-database.md). The [/SPDIN (Use Sample Profile Database)](spdin-use-sample-profile-database.md) option is available as a convenience when the input file is over-written and that isn't desirable. + +When you build by using `/SPGO` but the SPD file contains no profile data yet, you see a message such as: + +``` +Result: SPD .spd does not contain sample profile, compiling without profile guided optimizations +``` + +This message is expected on the first build and indicates that the SPD file is ready to receive profiling data. + +By default, the build process creates the SPD file with the same base name as the output file in the directory from which the link was invoked. Use [`/SPD`](spd-specify-sample-profile-database.md) to specify a different name or location. + +Use [`/SPDEMBED`](spdembed-embed-sample-profile-database.md) to embed the SPD data into the PDB file after profile data is collected. Ensure that the linker is producing a PDB file by specifying the `/DEBUG` option. + +For more information about the SPGO workflow, see [Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](../sample-profile-guided-optimization.md). + +### To set this linker option in the Visual Studio development environment + +1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). +1. Select the **Configuration Properties** > **Linker** > **Command Line** property page. +1. Add `/SPGO` to the **Additional Options** box. Choose **OK** to save your changes. + +### To set this linker option programmatically + +- See . + +## See also + +[MSVC linker reference](linking.md)\ +[MSVC Linker Options](linker-options.md)\ +[/SPD (Specify Sample Profile Database)](spd-specify-sample-profile-database.md)\ +[/SPDEMBED (Embed Sample Profile Database)](spdembed-embed-sample-profile-database.md)\ +[/SPDIN (Use Sample Profile Database)](spdin-use-sample-profile-database.md)\ +[Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](../sample-profile-guided-optimization.md) \ No newline at end of file diff --git a/docs/build/sample-profile-guided-optimization.md b/docs/build/sample-profile-guided-optimization.md new file mode 100644 index 00000000000..8fcc4c4f3a8 --- /dev/null +++ b/docs/build/sample-profile-guided-optimization.md @@ -0,0 +1,706 @@ +--- +description: "Learn how to use Sample Profile-Guided Optimization (SPGO) to improve the performance of C and C++ applications." +title: "Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve C++ performance" +ms.date: 05/08/2026 +ms.topic: tutorial +ai-usage: ai-assisted +helpviewer_keywords: ["SPGO", "sample profile-guided optimization", "profiling, SPGO", "SPDConvert", "SPTAggregate"] +--- +# Use Sample Profile Guided Optimization (SPGO) to improve C++ performance + +Profile-Guided Optimization (PGO) uses runtime data to help the compiler make better optimization decisions. By using execution profile data collected from representative workloads, PGO enables the compiler to make smarter decisions about inlining, code layout, and hot/cold code separation. These decisions are impossible to make from static analysis alone. + +SPGO takes a different approach. Instead of instrumenting your binary and running it through synthetic training scenarios, SPGO uses hardware performance counter sampling collected from your actual release binaries. Modern processors provide hardware sampling capabilities. You can collect these samples with negligible runtime overhead, making it practical to gather runtime profiles directly from production code. + +Because SPGO profiles release bits instead of instrumented builds, it enables much more flexibility in where and how you collect data. You can gather runtime profiles from production servers, developer machines, performance labs, or any combination. The result is a binary that runs hot paths more efficiently, with a typical performance speedup of 5-15% depending on the quality of the profile data. + +In this tutorial, you walk through the complete SPGO workflow: build a sample app, profile it by using `xperf`, prepare the profile data, and rebuild with the profile data. When you finish, you can apply the same process to your own projects. + +## Prerequisites + +Before you start, make sure you have the following software and hardware. + +### Software + +- **MSVC build tools for x64/x86/ARM64 v14.51 or later**—Install them through the Visual Studio Installer. Under **Individual Components**, search for "MSVC build tools." +- **Windows Performance Toolkit (xperf.exe)**—The `xperf` profiler collects sample data during your program's execution. Download the Windows Assessment and Deployment Kit (ADK) from [ADK install](/windows-hardware/get-started/adk-install). When you run the ADK installer, select the **Windows Performance Toolkit** component to get `xperf`. You don't need to install the full ADK. +- **War and Peace text file**—Used as the sample workload to generate profiling data. Download it from Project Gutenberg: [https://www.gutenberg.org/ebooks/2600](https://www.gutenberg.org/ebooks/2600). Save it as a plain text file in your working directory. + +### Hardware requirements + +The tutorial has three profiling paths. Which path you use depends on your hardware. You run detection commands in [Choose your profiling method](#choose-your-profiling-method) to find out which path your machine supports. For now, use this table to confirm you meet at least one of the requirements. + +| Path | CPU requirement | Notes | +|------|----------------|-------| +| **LBR** (best results) | Last Branch Records (LBR) are performance counters provided on Intel Haswell CPUs (4th gen Core, 2013) or later; AMD Zen 4 (2022) or later, ARM64 ARMv9.2-A (2020) or later | Provides the best branch data. For more information about LBR, see [An introduction to last branch records](https://lwn.net/Articles/680985/) | +| **PMC/IP mode** (good results) | Performance Monitoring Counters (PMC) are supported on any x64 CPU with a performance monitoring unit (PMU) | Works on most modern CPUs where LBR is unavailable. For more information about PMC, see [Recording Hardware Performance (PMU) Events](/windows-hardware/test/wpt/recording-pmu-events) and [Recording Hardware Performance (PMU) Events with Complete Examples](https://devblogs.microsoft.com/performance-diagnostics/recording-hardware-performance-pmu-events-with-complete-examples/#configuring-extended-pmu-counter-configurations5) | +| **OS timer** (works everywhere) | Any x64 or ARM64 CPU, including Azure VMs and virtual machines | Lower-fidelity samples, but always available | + +Most developers on modern x64 desktop hardware have LBR support. VMs and some older hardware have PMC or an OS timer. + +## How SPGO works + +SPGO collects profile data from your running binary and feeds it back to the compiler when you next build. The compiler uses that data to make better decisions about inlining, code layout, and branch prediction. A convenience is that no instrumentation is required. + +The workflow is: + +1. Build your binary with the [/spgo](./reference/spgo-enable-sample-profile-guided-optimization.md) linker flag. This step creates an empty **sample profile database** (`.spd` file). +1. Profile the binary by using `xperf` to produce an ETL trace file. +1. Convert the ETL to an **SPT** file by using [`SPTAggregate.exe`](sptaggregate.md), then convert the SPT to an **SPD** file by using [`SPDConvert.exe`](spdconvert.md). +1. Rebuild with the [/spdin](./reference/spdin-use-sample-profile-database.md) linker flag pointing to the populated sample profile database (SPD). The linker applies SPGO optimizations. + +The optimizer uses the SPD to answer questions like: which branches are taken most often? Which functions are called in hot loops? This process produces better code layout and inlining decisions than static analysis alone. + +SPGO works with both C and C++. The workflow and flags are identical for both languages. + +**Best candidates for SPGO:** Large, branch-filled C/C++ applications with tight inner loops. Gains scale with codebase size and branch complexity. The small sample in this tutorial shows around 7% improvement. Larger production codebases often see more improvement. + +## Build Process Comparison + +This section covers how SPGO fits into the build pipeline if you want to understand the mechanics. + +### Normal build process + +In a standard C/C++ release build: + +- **Inputs:** Source code files (`.cpp`, `.h`) and release-mode compiler flags (`/O2`, `/GL`, and so on). +- **Process:** The compiler applies standard optimizations such as inlining heuristics, branch prediction assumptions, and code layout decisions based on static analysis alone. It has no data about how the program actually behaves when it runs. +- **Output:** Executable (`.exe`), DLL files (`.dll`), debug information (`.pdb`). + +:::image type="content" source="media/normal-build-process.png" alt-text="Diagram of the normal release build process showing source code files and example compiler switch /GL as inputs flowing to a build step, which produces .exe, .dll, and .pdb outputs." lightbox="media/normal-build-process.png"::: + +Without runtime data, hot paths and cold paths receive similar treatment. + +### SPGO-enabled build process + +SPGO adds profiling data as a new input to the build pipeline: + +- **Inputs:** Source code, the `.spd` profile file (sample counts from a profiling run), release-mode compiler flags, `/link /spgo`, and `/spdin:` to specify an input SPD file (if not specified, defaults to a .spd using the binary name and located in the obj folder). +- **Process:** The linker reads the SPD alongside the intermediate code. It uses branch-frequency data to make better inlining, code layout, and branch-ordering decisions. Hot functions get laid out for fast access; cold code moves out of the critical path. +- **Output:** Optimized executable (`.exe`), optimized DLL files (`.dll`), debug information (`.pdb`), **and a new `.spd` file** for future profiling iterations. + +:::image type="content" source="media/sample-profile-guided-optimization-build-process.png" alt-text="Diagram of the SPGO-enabled build process showing source code and profile data files (.spd) as inputs to the build step with an additional linker switch /spgo. The build process outputs optimized .exe, .dll, debug information (.pdb), and new profile data files (.spd)." lightbox="media/sample-profile-guided-optimization-build-process.png"::: + +The key insight: SPGO moves optimization decisions from compiler and linker heuristics to data-driven choices based on real execution. + +### Key flags + +| Flag | Type | Purpose | +|------|------|---------| +| [`/spgo`](./reference/spgo-enable-sample-profile-guided-optimization.md) | Linker | Enables SPGO. Embeds SPGO metadata in the binary and creates an empty `.spd` output file unless `/spdin` is specified, in which case the specified `.spd` file is used as input. | +| [`/spdin:`](./reference/spdin-use-sample-profile-database.md) | Linker | Input SPD - provides profile data to the linker for optimization | +| [`/spd:`](./reference/spd-specify-sample-profile-database.md) | Linker | Output SPD path - specifies where the new SPD is written (optional; defaults to the same directory as the binary). Serves as the input SPD path if `/spdin` isn't specified. | +| [`/GL`](./reference/gl-whole-program-optimization.md) | Compiler | Whole-program optimization-required for SPGO to work across translation units | +| [`/O1`, `/O2` (Minimize Size, Maximize Speed)](./reference/o1-o2-minimize-size-maximize-speed.md) | Compiler | Optimize for speed; enables aggressive optimizations that SPGO can enhance | + +### How SPGO differs from PGO + +PGO (Profile-Guided Optimization) requires you to compile your binary with instrumentation flags (`/GENPROFILE`), run the slower instrumented binary to collect `.pgc` execution count files, then relink with `/USEPROFILE`. The compiler gets exact execution counts but you have to instrument the code first. For more information about this process, see [Profile-guided optimizations](profile-guided-optimizations.md). + +SPGO uses hardware CPU performance counters to collect statistical samples from your uninstrumented release binary. Run your existing binary, profile it by using `xperf`, convert the trace to an SPD file, and rebuild. There's no instrumented build and no slowdown during profiling. The compiler gets statistical sampling data instead of exact counts, which is less precise but easier to get and requires no code changes. It also allows profiling of system components or realtime components that are difficult to collect data for with an instrumented approach. You can also profile final/shipping binaries. + +This tutorial covers three profiling methods: LBR, PMC, and OS timer. You choose your method in [Choose your profiling method](#choose-your-profiling-method). For a detailed comparison of the normal build process versus the SPGO build process, including a flag reference table, see [Build Process Comparison](#build-process-comparison). + +## Configure `perfcore.ini` + +> **⚠️ Required:** Without this step, `xperf` doesn't provide the necessary profiling data. Complete this step before running `xperf`. + +The Windows Performance Toolkit (WPT) uses `perfcore.ini`, located if you installed the WPT in the default location at `C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit\perfcore.ini`, to register the DLL providers it needs for SPGO. + +Open Windows Notepad as Administrator. Then open `perfcore.ini`. Find the DLL list section and add the following entries, one per line: + +``` +perf_spt.dll +perf_lbr.dll +``` + +If `xperf.exe` isn't installed, see [General issues](#general-issues-all-paths) to install it. + +Save and close `perfcore.ini`. The DLL files already ship in the same directory as `xperf.exe` so you don't need to copy them anywhere. You're only registering them in `perfcore.ini`. Ensure that `xperf` is in your path. + +## Create the sample app + +The sample app for this tutorial is a C++ program that reads text from standard input and produces a line count, word count, total character count, a character frequency table, and elapsed time to process the file in milliseconds. It's written in C++, but SPGO also works with C. The workflow is identical for C projects. + +Create a file named `textCount.cpp` in your working directory and add the following source code: + +```cpp +// textCount.cpp : Text Statistics Counter +// Counts words, lines, and character frequencies from standard input +// Usage: textCount < file.txt + +#include +#include +#include +#include +#include + +int main() +{ + auto start = std::chrono::steady_clock::now(); + + std::map charFrequency; + int wordCount = 0; + int lineCount = 0; + int totalChars = 0; + + std::string line; + bool inWord = false; + + while (std::getline(std::cin, line)) + { + lineCount++; + + for (char c : line) + { + totalChars++; + unsigned char uc = static_cast(c); + charFrequency[uc]++; + + if (std::isspace(static_cast(c))) + { + inWord = false; + } + else + { + if (!inWord) + { + wordCount++; + inWord = true; + } + } + } + + inWord = false; + } + + std::cout << "\n=== TEXT STATISTICS ===" << std::endl; + std::cout << "Lines: " << lineCount << std::endl; + std::cout << "Words: " << wordCount << std::endl; + std::cout << "Total Characters: " << totalChars << std::endl; + + std::cout << "\n=== CHARACTER FREQUENCIES ===" << std::endl; + + std::cout << "\nLetters:" << std::endl; + for (unsigned char ch = 'a'; ch <= 'z'; ch++) + { + unsigned char upperCh = static_cast(std::toupper(ch)); + int count = charFrequency[ch] + charFrequency[upperCh]; + if (count > 0) + { + std::cout << static_cast(ch) << ": " << count << std::endl; + } + } + + std::cout << "\nDigits:" << std::endl; + for (unsigned char ch = '0'; ch <= '9'; ch++) + { + if (charFrequency[ch] > 0) + { + std::cout << static_cast(ch) << ": " << charFrequency[ch] << std::endl; + } + } + + std::cout << "\nSpecial Characters:" << std::endl; + for (const auto& pair : charFrequency) + { + unsigned char ch = pair.first; + if (!std::isalnum(ch)) + { + std::string displayChar; + switch (ch) + { + case ' ': displayChar = "[space]"; break; + case '\t': displayChar = "[tab]"; break; + case '\n': displayChar = "[newline]"; break; + case '\r': displayChar = "[return]"; break; + default: + if (ch >= 32 && ch < 127) + { + displayChar = std::string(1, static_cast(ch)); + } + else + { + displayChar = "[byte:" + std::to_string(static_cast(ch)) + "]"; + } + break; + } + std::cout << displayChar << ": " << pair.second << std::endl; + } + } + + auto end = std::chrono::steady_clock::now(); + + auto elapsed = std::chrono::duration(end - start); + std::cout << "Elapsed time: " << std::fixed; + std::cout.precision(3); + std::cout << elapsed.count() << " ms\n"; + + return 0; +} +``` + +## Build and run the sample to get a baseline + +Before applying SPGO, build `textCount` and run it against a large text file, such as *War and Peace* (you can download it from Project Gutenberg), to see how fast it runs. This step shows you the performance before you optimize it by using SPGO: + +**Build:** + +```cmd +cl /EHsc /GL /O2 textCount.cpp +``` + +**Run:** + +```cmd +textCount.exe < warAndPeace.txt +``` + +You see output similar to: + +``` +=== TEXT STATISTICS === +Lines: 66041 +Words: 566333 +Total Characters: 3227531 + +=== CHARACTER FREQUENCIES === + +Letters: +a: 202719 +... + +Elapsed time: 512.000 ms +``` + +Record the `Elapsed time` value. You'll compare it to the SPGO-optimized time in [Measure the results](#measure-the-results). + +## Build textCount with /spgo + +Now build textCount with SPGO enabled. This step lays the groundwork to gather profiling data. + +```cmd +cl /EHsc /GL /O2 textCount.cpp /link /debug /spgo +``` + +When the build finishes, you see a message like: + +``` +SPD textCount.spd not found, compiling without profile guided optimizations +``` + +This message appears on the first `/spgo` build. The linker creates the SPD file but it's still empty, so it doesn't apply any SPGO optimizations yet. After you run the binary, collect profile data, and convert it to SPD, you won't see this message. + +**Flag explanations:** + +| Flag | Purpose | +|------|---------| +| `/EHsc` | Enable C++ exception handling | +| `/GL` | Whole-program optimization — required for SPGO. Defers final optimization to link time, enabling cross-module inlining, code layout, and dead code elimination decisions. | +| `/O2` | Optimize for speed — enables aggressive inlining, loop optimization, dead code removal, and related transforms. | +| `/link /debug` | Pass `/debug` to the linker to generate debug information (`.pdb`), which xperf uses to map profiling samples to source code. | +| `/spgo` | SPGO linker flag—embeds SPGO metadata in the binary and creates an empty `textCount.spd` file alongside the executable. | + +> **Note:** `/spgo` is a linker flag. Pass it to the linker via `/link /spgo` in the `cl` command. + +The `/spgo` flag doesn't optimize the binary yet. It prepares it for profiling. The optimization happens in [Rebuild textCount with /spdin](#rebuild-textcount-with-spdin) after the SPD is populated with real runtime data. + +> **Note:** To write the SPD to a specific location, add the optional `/spd:` linker flag. For example: `/link /debug /spgo /spd:.\profiles\textCount.spd`. If you omit this flag, the SPD is created alongside the `.exe`. + +## Choose your profiling method + +SPGO supports three profiling methods. Which method you use depends on your hardware. + +### The three profiling methods + +| Method | Sample quality | Hardware requirement | Best for | +|--------|----------------|---------------------|----------| +| **LBR** (Last Branch Record) | Highest—records sequences of recently taken branches, giving the optimizer rich control-flow data per sample | Intel Haswell (2013) or later; AMD Zen 4 (2022) or later; ARM64 ARMv9.2-A (2020) or later | Most modern desktop hardware | +| **PMC / IP mode** (Performance Monitoring Counter/Instruction pointer mode) | Good. Captures instruction-pointer samples with call stacks using the CPU's Performance Monitoring Unit (PMU), collected through Event Tracing for Windows (ETW) | Any x64 or ARM64 CPU with a PMU | Hardware without LBR support | +| **OS timer** | Basic—timer-based samples | Any x64 or ARM64 CPU, VMs without PMU passthrough | VMs and older hardware | + +With PMC / IP mode, each hardware interrupt gives you just one data point: "the CPU was at address 0x1A2B3C4D when the interrupt fired". With LBR, each interrupt gives you a stack of the last 16–32 branches the CPU took before the interrupt fired. The optimizer gets better control-flow data and can make better inlining and layout decisions. + +### Detect your path + +Run the following two commands to determine which profiling path your machine supports. These commands don't require an elevated prompt. + +**Step 1: Check for LBR support. This test works on Intel/AMD/ARM64.** + +Run the following from an **administrator** Visual Studio developer command prompt: + +```cmd +xperf.exe -on PMC_PROFILE -pmcprofile TotalIssues -LastBranch PmcInterrupt -setProfInt TotalIssues 2560000 +xperf -stop -d lbrtest.etl +xperf -tle -i lbrtest.etl -a dumper | findstr "LBR, TimeStamp" +``` + +- If this command finds a line containing `LBR, TimeStamp`, then your machine supports LBR. **Use the LBR path.** +- Otherwise, continue to Step 2. + +**Step 2: Check for PMC support (no LBR)** + +```cmd +xperf.exe -pmcsources | findstr TotalIssues +``` + +- If this command produces output, then your machine supports PMC counters but not LBR. **Use the PMC path.** +- If this command produces no output, then **Use the OS timer path.** + +For more information about PMU event collection with xperf, see [Recording hardware PMU events with xperf](https://devblogs.microsoft.com/performance-diagnostics/recording-hardware-performance-pmu-events-with-complete-examples/#configuring-extended-pmu-counter-configurations5). + +### Decision table + +| `LBR, TimeStamp` output | `TotalIssues` output | Your path | +|---------------------|-----------------------------|-----------| +| Not empty | (not checked) | LBR | +| Empty | Not empty | PMC | +| Empty | Empty | OS timer | +| ARM64 processor | N/A | PMC (if PMU available) or OS timer | + +### Choose your approach + +Decide whether to use the LBR, PMC, or OS timer path based on the detection results. Each path has different `xperf` start parameters to collect the appropriate profiling data. Follow the path that matches your hardware capabilities. + +> **Your path:** +> - **LBR users** (LBR detected in Step 1): Go to [LBR path](#lbr-path). +> - **PMC users** (InstructionRetired detected in Step 2): Go to [PMC path (no LBR)](#pmc-path-no-lbr). +> - **OS timer users** (VM or hardware without PMU): Go to [OS timer path](#os-timer-path). +> +> All paths rejoin at [Run the workload and stop xperf](#run-the-workload-and-stop-xperf-all-paths). + +The commands in this section depend on the profiling path you identified in [Choose your profiling method](#choose-your-profiling-method). Find the subsection that matches your path, run the `xperf` start command, and then continue to [Run the workload and stop xperf](#run-the-workload-and-stop-xperf-all-paths) to run the workload and stop xperf. + +> **⚠️ Run as Administrator:** `xperf` requires an elevated (Administrator) developer command prompt. Without elevation, `xperf` returns `"failed to configure counters"`. + +### LBR path + +Start `xperf` with LBR collection: + +```cmd +xperf -on LOADER+PROC_THREAD+PMC_PROFILE -MinBuffers 4096 -MaxBuffers 4096 -BufferSize 4096 -pmcprofile BranchInstructionRetired -LastBranch PmcInterrupt -setProfInt BranchInstructionRetired 16384 +``` + +**Parameter explanation:** + +| Parameter | Purpose | +|-----------|---------| +| `LOADER+PROC_THREAD+PMC_PROFILE` | Kernel providers: loader events (module mapping), process/thread events (execution context), and PMC profiling events | +| `-MinBuffers 4096 -MaxBuffers 4096 -BufferSize 4096` | Large ring buffers to avoid dropped samples during a full War and Peace run | +| `-pmcprofile BranchInstructionRetired` | PMC event trigger: generate a sample on every Nth retired branch instruction | +| `-LastBranch PmcInterrupt` | Enables LBR hardware recording: on each PMC interrupt, capture the hardware last-branch record stack | +| `-setProfInt BranchInstructionRetired 16384` | Sample interval: fire an interrupt every 16,384 retired branch instructions | + +After starting xperf, continue to [Run the workload and stop xperf](#run-the-workload-and-stop-xperf-all-paths). + +### PMC path (no LBR) + +Start `xperf` with PMC / IP-mode collection: + +```cmd +xperf -on LOADER+PROC_THREAD+PMC_PROFILE+PROFILE -MinBuffers 4096 -BufferSize 4096 -pmcprofile InstructionRetired -setProfInt InstructionRetired 16384 -stackwalk profile +``` + +**Parameter explanation:** + +| Parameter | Purpose | +|-----------|---------| +| `LOADER+PROC_THREAD+PMC_PROFILE+PROFILE` | Adds `PROFILE` (CPU sampling) and `PMC_PROFILE` for PMC events; no `-LastBranch` | +| `-pmcprofile InstructionRetired` | PMC event trigger: sample on retired instructions (instruction pointer mode) | +| `-setProfInt InstructionRetired 16384` | Fire an interrupt every 16,384 retired instructions | +| `-stackwalk profile` | Capture a call stack on each profile interrupt, providing call-chain data instead of branch sequences | + +Compared to LBR: no `-LastBranch` flag; uses `InstructionRetired` instead of `BranchInstructionRetired`. The result is instruction-pointer samples with call stacks, not branch sequences. This path still provides effective data for the optimizer, but it's slightly less rich. + +After starting `xperf`, continue to [Run the workload and stop xperf](#run-the-workload-and-stop-xperf-all-paths). + +### OS timer path + +Start xperf with OS timer-based sampling: + +```cmd +xperf -on LOADER+PROC_THREAD+PROFILE -MinBuffers 4096 -BufferSize 4096 -setProfInt Timer 1221 -stackwalk profile +``` + +**Parameter explanation:** + +| Parameter | Purpose | +|-----------|---------| +| `LOADER+PROC_THREAD+PROFILE` | No PMC events; CPU sampling via OS timer interrupt only | +| `-setProfInt Timer 1221` | Fire on the OS timer interrupt every 1,221 timer ticks (approximately 1 kHz) | +| `-stackwalk profile` | Capture a call stack on each timer interrupt | + +Compared to LBR and PMC, this method doesn't use hardware performance counters. The OS timer fires at roughly fixed time intervals regardless of CPU activity. Samples are less densely correlated to hot code but still provide useful control-flow data for the optimizer. + +### Run the workload and stop xperf (all paths) + +With `xperf` running, run `textCount` against War and Peace: + +```cmd +textCount.exe < warAndPeace.txt +``` + +After `textCount` finishes, stop `xperf` and write the trace file. Letting other processes run during profiling dilutes sample quality. For best results, close unnecessary applications before running the workload. + +```cmd +xperf -stop -d textCount.etl +``` + +After stopping `xperf` (it can take a while to write out the etl file), confirm that `textCount.etl` was created in the current directory. + +## Convert the ETL file to SPT + +This step is the same for all three profiling paths. + +Run `SPTAggregate.exe` to process the raw ETL trace and create an SPT profile file: + +```cmd +SPTAggregate.exe /binary textCount.exe /etl textCount.etl textCount.spt +``` + +**Parameter explanation:** + +| Parameter | Purpose | +|-----------|---------| +| `/binary textCount.exe` | The binary to extract samples from. The ETL might contain samples from all processes that ran during profiling | +| `/etl textCount.etl` | Input ETL trace file | +| `textCount.spt` | Output SPT profile file | + +`SPTAggregate` outputs a summary that shows how many samples it collected. This summary is your first confirmation that profiling worked. + +Check the output from `SPTAggregate` against the path you took: + +- **LBR path:** Look for a nonzero Used LBR Samples count. +- **PMC path:** Look for a nonzero PMC or stack sample count. +- **OS timer path:** Look for a nonzero used stack samples count. + +If all counts are zero, see [Troubleshooting](#troubleshooting) before continuing. + +## Convert the SPT file to SPD + +> **Your path:** +> - **LBR users** (use `/mode:LBR`): [LBR mode](#lbr-mode) +> - **PMC users** (use `/mode:IP`): [IP mode (PMC and OS timer)](#ip-mode-pmc-and-os-timer) +> - **OS timer users** (use `/mode:IP`): [IP mode (PMC and OS timer)](#ip-mode-pmc-and-os-timer) +> +> Both PMC and OS timer paths use `/mode:IP` because both produce instruction-pointer samples. + +The next step branches by profiling path, specifically on the `/mode` flag passed to `SPDConvert.exe`. + +### LBR mode + +```cmd +SPDConvert.exe /mode:LBR textCount.spd textCount.spt +``` + +`/mode:LBR` tells `SPDConvert` to interpret the SPT as containing LBR branch sequence data. + +### IP mode (PMC and OS timer) + +Both PMC and OS timer produce instruction-pointer samples, so both use the same conversion command: + +```cmd +SPDConvert.exe /mode:IP textCount.spd textCount.spt +``` + +`/mode:IP` tells `SPDConvert` to interpret the SPT as containing instruction-pointer samples. + +> **Warning:** Using the wrong mode for your data type can produce an empty or malformed SPD. If you profiled with LBR, use `/mode:LBR`. If you profiled with PMC or OS timer, use `/mode:IP`. The `SPTAggregate` summary output from [Convert the ETL file to SPT](#convert-the-etl-file-to-spt) shows which sample types were collected and confirms the correct mode to use. + +After running `SPDConvert`, confirm that `textCount.spd` was created (or updated) in the current directory. + +### Interpreting SPDConvert output + +The command `SPDConvert textCount.spd textCount.spt` prints a before-and-after block coverage summary, for example: + +``` +Block coverage (before) : 33.90% ( 4507/ 13294) +Block coverage (after) : 45.64% ( 6067/ 13294) +``` + +This summary shows the percentage of the binary's code blocks that have associated profile data. A higher percentage is better. Coverage above 70% is excellent, while coverage below 40% might limit optimization effectiveness. If coverage is low, run the profiling workload longer or combine multiple SPT files from separate runs with different workloads. For example, you could run `textCount` against multiple text files to exercise different code paths. + +You might see a warning from `SPDConvert` like the following: + +``` +Compiler may be conservative on some hot functions due to sparse sample coverage. +SPGO is estimated to optimize better if sample density is increased to 5.4x of current level. +Sample density can be increased by sampling for longer period, or increasing sample rate. +``` + +This warning means your profiling run didn't collect enough samples for the optimizer to confidently optimize all hot functions. The SPD is still usable, but you can improve results by: + +- Running the workload longer (for example, 5 or more minutes instead of 1 minute) or using different workloads. +- Lowering the `-setProfInt` value in the `xperf` command to increase the sampling rate. The tradeoff is that this change produces a larger ETL file, which takes longer to process. +- Combining multiple SPT files from separate profiling runs by passing them all to `SPDConvert`. + +The SPT file is a binary format. To inspect its contents, you can run `SPTDump.exe textCount.spt`. Similarly, `PTDump.exe textCount.spt` shows the compiled profile data after running `SPDConvert`. Both tools are useful for verifying nonzero samples before proceeding. + +## Rebuild textCount with /spdin + +Rebuild `textCount` by using the populated SPD file. The linker reads the profile data and applies SPGO optimizations. + +This step is the same for all three profiling paths. + +```cmd +cl /EHsc /GL /O2 textCount.cpp /link /debug /spgo /spdin:textCount.spd +``` + +**New flag (compared to [Build textCount with /spgo](#build-textcount-with-spgo)):** + +| Flag | Purpose | +|------|---------| +| `/spdin:textCount.spd` | Provide the SPD profile data to the linker for optimization | + +The command still includes `/spgo`. It generates a new SPD file alongside the optimized binary, which you can use as the starting point for subsequent profiling iterations. + +> **Warning:** The SPD file is associated with the exact binary it profiles against. If you rebuild `textCount` without `/spdin`, or rebuild from changed source, you must generate a new SPD file. The existing one doesn't match the new binary's GUID, and the linker won't use it. + +After the rebuild with `/spdin`, the linker outputs statistics about how much of your code was optimized using profile data. For example: + +``` +221 of 221 (100.00%) profiled functions will be compiled for speed +201 of 1383 inline instances were from dead/cold paths +474 of 474 profiled functions (100.0%) were optimized using profile data +202738780 of 202738780 instructions (100.0%) were optimized using profile data +``` + +A high percentage means the SPD covers your binary well. If the percentage is low (for example, below 90%), either the profiling workload didn't exercise enough of the binary, or the binary has changed significantly since the profile was collected. In both cases, reprofile against the current binary. + +### What SPGO does with your profile data + +SPGO uses the collected sample data to populate counts on each block and edge in the program's control flow graph. These counts drive optimizations such as: +- **Profile-guided inlining**: Aggressively inline hot call sites while avoiding code bloat from inlining cold paths. +- **Hot/cold code separation**: Move rarely executed code to separate sections of the binary, improving instruction cache utilization and paging behavior. +- **Function layout**: Place functions that call each other frequently near each other in the binary, reducing page faults and improving locality. Optimized functions are organized into high affinity COFF groups in the binary. +- **Size/speed decisions**: Compile hot functions for speed and cold functions for size. Routines with no observed profile hits might be compiled for size rather than speed, limiting optimizations like inlining and loop unrolling in those cold paths. +- **Speculative devirtualization**: When sampling reveals that an indirect call consistently targets the same function, SPGO can speculate on that target and inline it, with a fallback for the uncommon case. + +## Measure the results + +Run `textCount` again and compare elapsed times. + +```cmd +textCount.exe < warAndPeace.txt +``` + +Collect multiple runs for each configuration and use the median. A single run isn't reliable because OS scheduling and system noise can skew individual measurements. + +| Build | Representative elapsed time | +|-------|-----------------------------| +| Baseline (`cl /EHsc /O2`) | *(your measurement)* | +| `/spgo` build (no profile data yet) | *(should be close to baseline)* | +| SPGO-optimized (`/spdin`) | *(should show improvement)* | + +In one test, SPGO using the LBR method delivered approximately 7% reduction in elapsed time. Your results might vary with your own projects because SPGO gains depend on how well the profiling workload represents typical execution. Larger, branch filled codebases tend to see more improvement within the 5–10% range. The profiling method affects optimization quality. LBR typically produces better results than PMC, which produces better results than OS timer. If you're on the OS timer path, expect smaller gains. + +The LBR path followed in this tutorial was applied to the [SQLite](https://github.com/sqlite/sqlite) project, which is a production database library. The SPGO-optimized SQLite binary showed approximately a 7% improvement. + +## Apply SPGO to your own project + +Use this checklist to apply SPGO to your own C or C++ application. + +1. **Add `/link /spgo` to your existing release build command.** Modify your build script or project file: + + ```cmd + cl /EHsc /GL /O2 myapp.cpp /link /spgo + ``` + +1. **Choose a representative workload.** Select a real usage scenario that exercises the hot paths of your application. Use production-like data. Avoid the following as your primary profiling workload: code coverage tests (they don't stress performance bottlenecks), uncommon error paths, startup and shutdown phases, and deprecated code paths. This workload drives the profile that feeds the optimizer. +1. **Run xperf using your detected path.** Use the path you identified in [Choose your profiling method](#choose-your-profiling-method) (LBR, PMC, or OS timer). Start `xperf`, run the workload once, stop `xperf`, and capture the ETL file. +1. For the PMC or OS timer path, **run SPTAggregate and SPDConvert with the correct `/mode` flag.** Convert ETL to SPT then to SPD. Use `/mode:LBR` for LBR data; use `/mode:IP` for PMC or OS timer data. +1. **Rebuild with `/spdin:`.** Compile your application with the populated SPD: + + ```cmd + cl /EHsc /GL /O2 yourApp.cpp /link /spgo /spdin:yourApp.spd + ``` + +1. **Measure before and after.** Run your workload with both the nonoptimized and SPGO-optimized binaries. Collect the **median of multiple runs** for each configuration. A single run isn't reliable for benchmarking. +1. **Store the `.spd` file in source control.** Check the `.spd` file into your source control system alongside your source code. +1. **Enable SPGO in developer Release builds.** Have your team's Release builds use the same SPGO-optimized binaries as production. This helps catch performance regressions early. +1. Disable SPGO in Debug builds. +1. **Watch the linker's profile completeness statistics.** After each build with `/spgo`, note the percentage of profiled functions optimized using profile data. If this drops significantly (below 90%), reprofile the current binary. Code changes accumulate and the SPD can become stale. + +### Alternative to using `xperf` + +Another way to gather profile data is to use a sampling profiler like Windows Performance Recorder (WPR). WPR is installed by default on Windows 10 and later. It collects similar data to `xperf`. You can configure WPR to collect CPU samples with call stacks, and then export the data to an ETL file that you can process with `SPTAggregate` and `SPDConvert` like the `xperf` ETL. Here's an example of using WPR to collect profile data: + +```cmd +wpr -start CPU.light -filemode +textCount.exe < warAndPeace.txt +wpr -stop spgo_data.etl +``` +For more information on using WPR, see [Using Windows Performance Recorder](/windows-hardware/test/wpt/recording-pmu-events) + +### SPD distribution + +You can: + +- Check the `.spd` file directly into source control alongside your source code. +- Share the `.spd` file with teammates so they can build with SPGO optimizations without reprofiling. +- Package the `.spd` file with your binaries as a versioned artifact (for example, a NuGet package) and record which version corresponds to which binary. +- Regenerate the `.spd` file at any time by repeating the profiling workflow. + +The SPD ties to the exact binary it was built from. After significant code changes, reprofile to generate a fresh SPD. During the `/spdin` build, the compiler also produces a new `.spd` file. Save this new SPD as a build artifact - it's the starting point for your next profiling iteration. + +## Reusing SPD information across builds + +The "carry forward" concept in SPGO allows you to add profiling data to an existing SPD file without profiling all your scenarios over again from scratch and without losing existing profile information. You can also adjust how much weight to give to older profile data. This flexibility is useful when there might be behavioral changes over time and you don't want to completely lose the profiling information from earlier scenario runs. For instance, a DLL might see different APIs called as the application that calls it evolves. You still want the optimizations from how it used to behave, but want to mix in optimization opportunities for how it sometimes behaves differently now. You can evolve the profile over time by mixing old and new data. + +When you run `SPDConvert` with a new SPT file, pass the name of the existing SPD file. Then use the `/retire:N` option to control how aggressively `SPDConvert` de-emphasizes older profile data when you add new SPT files: +- The default (`/retire:8`) weights newer data more heavily. +- Use `/retire:0` to give equal weight to all runs. +- Use `/retire:16` to let only the newest data count. + +## Troubleshooting + +> **Find your issue:** +> - **LBR path problems:** [LBR path problems](#lbr-path-problems) +> - **PMC path problems:** [PMC path problems](#pmc-path-problems) +> - **OS timer problems:** [OS timer path problems](#os-timer-path-problems) +> - **Issues affecting all paths:** [General issues](#general-issues-all-paths) + +### LBR path problems + +| Problem | Likely cause | Fix | +|---------|-------------|-----| +| Zero LBR samples in `SPTAggregate` output | CPU doesn't support LBR, or VM doesn't expose LBR | Run the detection command from [Detect your path](#detect-your-path). If in a Hyper-V VM, run `Set-VMProcessor MyVMName -Perfmon @("pmu", "lbr")` on the host. If LBR isn't available, switch to the PMC or OS timer path. | +| Processor supports LBR but `SPTAggregate` shows 0 LBR samples | `perfcore.ini` DLL registration incomplete | Complete the `perfcore.ini` setup in [Configure perfcore.ini](#configure-perfcoreini). Ensure `perf_lbr.dll` is registered. | +| `SPDConvert` fails or produces an empty SPD | Wrong `/mode` flag, or SPT contains only IP-mode samples | Confirm `SPTAggregate` output showed LBR samples. If the output shows only IP-mode samples, switch to `/mode:IP`. | + +### PMC path problems + +| Problem | Likely cause | Fix | +|---------|-------------|-----| +| Zero PMC samples in `SPTAggregate` output | `perfcore.ini` DLL registration incorrect | Complete the `perfcore.ini` setup in [Configure perfcore.ini](#configure-perfcoreini). Ensure `perf_spt.dll` is registered. Without this DLL, `xperf` produces zero PMC samples without an error message.
    Run `xperf.exe -pmcsources` to see the list of Performance Counters sources available on your CPU. If you don't see entries like `SPT_OP_RETIRE_INSTR` or `SPT_OP_RETIRE_BR_INSTR` or `SPT_OP_ETW_INSTR`, then the DLL registration in `perfcore.ini` might be incomplete or your CPU might not support PMC. If you can't resolve the DLL registration, try the OS timer path, instead. | +| `findstr InstructionRetired` returns output but `xperf` produces no samples | VM masking PMC counters | Check if running in a VM. Enable PMU in Hyper-V with `Set-VMProcessor`, or switch to the OS timer path. | +| `SPDConvert` fails on PMC path | Using `/mode:LBR` on an IP-only SPT | Switch to `/mode:IP`. | + +### OS timer path problems + +| Problem | Likely cause | Fix | +|---------|-------------|-----| +| Less improvement than expected | Expected - OS timer is lower fidelity | This is normal. The optimizer has less branch-flow information from timer samples than from LBR or PMC. Performance gains are smaller. Consider upgrading to PMC or LBR if hardware supports it. | +| Zero timer samples | `xperf` wasn't run in an elevated prompt, or `PROFILE` provider missing | Confirm running as Administrator. Confirm `-stackwalk profile` was provided to the `xperf` command. | + +### General issues (all paths) + +| Problem | Likely cause | Fix | +|---------|-------------|-----| +| `"failed to configure counters"` error | `xperf` not running as administrator | Restart the command prompt as **Administrator** (right-click > Run as administrator). xperf requires elevated privileges to configure hardware performance counters. | +| `xperf` not found | `xperf.exe` not on PATH | Confirm the Windows ADK is installed. Check `C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit\`. Add that directory to your PATH, or run xperf from it directly. | +| `textCount.etl` not created | xperf failed silently | Confirm running as administrator. Rerun the xperf start command and check for error output. | +| `SPTAggregate` fails with "binary not found" | `textCount.exe` not in current directory or wrong path | Confirm you're in the same directory as `textCount.exe`, or provide the full path to the `/binary` parameter. | +| SPD file not created | `SPDConvert` failed | Check that `textCount.spt` size is nonzero. Run `SPTDump.exe textCount.spt` to inspect its contents. | +| `/spdin` build produces no improvement | GUID/age mismatch between SPD and binary | The SPD was built from a different `textCount.exe`. Profile the current build again to generate a fresh SPD. | +| MSVC version error on `/spgo` | MSVC toolset earlier than v14.51 | Open the Visual Studio Installer > **Individual Components** > install **MSVC v14.51** or later. Reopen the Developer Command Prompt. | + +## Next steps + +After completing this tutorial, explore these capabilities to get more from SPGO: + +- **Profile blending:** Run multiple workloads, accumulate SPT files from each run, and pass all of them to `SPDConvert`. A blended SPD reflects the full range of real usage patterns and produces better optimizations than a single-scenario profile. Use the `/retire:N` option to control how aggressively `SPDConvert` de-emphasizes older profile data when you add new SPT files. The default (`/retire:8`) weights newer data more heavily. Use `/retire:0` to give equal weight to all runs; use `/retire:16` to let only the newest data count. +- The best results come from blending profiles from multiple sources such as benchmarks that stress key scenarios plus real-world data (where available). Pass SPT files from all sources to `SPDConvert`. Repeat an SPT file in the argument list to give it more weight (for example, `SPDConvert myapp.spd critical.spt critical.spt common.spt` weights `critical.spt` twice as heavily as `common.spt`). +- **Iterative optimization:** Each rebuild with `/spdin` produces a new SPD. You can repeat the run, profile, rebuild cycle. Later iterations might show diminishing returns, but a second pass can sometimes capture patterns the first missed. +- **Code changes:** After significant source changes, recollect profile data. The existing SPD is tied to the binary it was profiled against. It won't match a substantially rebuilt binary. +- **Profile freshness:** The linker reports the percentage of profiled functions optimized using profile data after each `/spdin` build. If this percentage drops significantly, it's a signal that the code has diverged from the profile. Reprofile the current binary. \ No newline at end of file diff --git a/docs/build/spdconvert.md b/docs/build/spdconvert.md new file mode 100644 index 00000000000..e886c1e1846 --- /dev/null +++ b/docs/build/spdconvert.md @@ -0,0 +1,119 @@ +--- +description: "Learn more about: SPDConvert" +title: "SPDConvert" +ms.date: 05/08/2026 +ai-usage: ai-assisted +helpviewer_keywords: ["SPDConvert program", "sample profile-guided optimizations, SPDConvert", "SPGO"] +--- +# SPDConvert + +Use `SPDConvert` to prepare and manage sample profile data for Sample Profile-Guided Optimization (SPGO). + +This tool correlates the raw hardware samples in SPT files against the code structure in the SPD. This step performs sample correlation, flow smoothing, and size/speed decisions, and produces an enriched SPD file with execution counts annotated on the flow graph. + +You can combine data from multiple sources such as lab benchmarks, internal monitoring, and production telemetry, in a single conversion. To emphasize the importance of a particular scenario, you can specify its SPT file multiple times. Listing a critical benchmark SPT three times effectively triples its weight. + +This tool operates in three modes: + +- *import* .SPT data into an .SPD file for [/SPGO](sample-profile-guided-optimization.md) builds +- *extract* an embedded .SPD file from a .PDB +- *merge* multiple .SPD files from separate profiling runs + +`SPDConvert` works with three file types: +- **ETL** (Event Trace Log) Raw hardware performance events recorded by `xperf` +- **SPT** (Sample Profile Trace) Packaged sample events produced by [`SPTAggregate`](sptaggregate.md) from ETL files +- **SPD** (Sample Profile Database) Processed profile data used by the compiler during an optimized build. You can also embed SPD files in PDB symbol files during a `/spdembed` build + +## Syntax + +Import SPT data into an existing SPD file: + +> `SPDConvert` [*options*] *spdfile* *sptfile(s)* + +Extract an embedded SPD file from a PDB: + +> `SPDConvert` **/extract** *pdbfile* *spdfile* + +Merge multiple SPD files into one: + +> `SPDConvert` **/merge** *outputspdfile* *spdfile(s)* + +### Parameters + +**IMPORT MODE** + +*options*\ +Specify the following options in import mode: + +- **/mode:**\<**IP**\|**LBR**\> Select the profile mode. Use **IP** for instruction pointer profile data (default) or **LBR** for last branch record profile data. +- **/reset:** Reset the count to 0. This action ignores SPTs. Use this option to reset an SPD file before importing new data, or to create an empty SPD file if the specified file doesn't exist. +- **/sptlist:**\<*file*\> Specify SPT file names in a text file, with one file name per line. +- **/summary** Print a summary of the SPD file. +- **/help** Display help information. + +*spdfile*\ +The SPD file to import sample data into. + +*sptfiles*\ +One or more SPT files to import. SPT files are produced by [SPTAggregate](sptaggregate.md). + +**EXTRACT MODE (/extract)** + +*pdbfile*\ +The PDB file that contains an embedded SPD. + +*spdfile*\ +The output SPD file to create. + +**MERGE MODE (/merge)** + +*outputspdfile*\ +The output SPD file to create. + +**/retire:**\<*N*\> Set the profile data retire rate to *N*/16, where 0 ≤ *N* ≤ 16. The default is 8. This value controls how much of the existing data in an SPD to delete when adding new SPT data. For example, `/retire:8` deletes 8/16 (half) of the existing data before adding new SPT data. This setting weights newer profile data more heavily because it discards half of the older data. The two most common usages are `/retire:0` which gives equal weight to all profile runs, or `/retire:16` to make only the newest data count because it deletes all the old data. Use `/retire:N` to control how aggressively `SPDConvert` de-emphasizes older profile data. This "carry forward" concept allows you to refresh a profile using existing SPD data without starting over with new profiling data, which is time-consuming. This concept is discussed more in the [SPGO tutorial - Reusing SPD information across builds](sample-profile-guided-optimization.md#reusing-spd-information-across-builds). + +*spdfiles*\ +One or more SPD files to merge. + +## Remarks + +> [!NOTE] +> Run this tool from a Visual Studio developer command prompt. + +`SPDConvert` is the main conversion tool in the SPGO workflow. After collecting a trace by using `xperf` and converting it to an SPT file by using [`SPTAggregate`](sptaggregate.md), use `SPDConvert` to import the sample data into an SPD file. Pass the resulting SPD file to the compiler by using the [`/SPGO`](sample-profile-guided-optimization.md) flag to build an optimized binary. + +Use `/extract` to recover an SPD file that was embedded in a PDB during a `/SPGO` build. +Use `/merge` to combine SPD files from multiple profiling sessions before rebuilding. + +The GUID and age of a binary must match between the SPT and SPD files. If they don't match, `SPDConvert` reports an "SPD version incompatible" error. Use [`SPTDump /progid`](sptdump.md) to check the binary identifiers in the SPT file, and [`SPDDump /header`](spddump.md) to check the SPD file. + +The GUID and age of the binary recorded in the SPD file must match the SPT file. To diagnose this error, use [`SPTDump /progid`](sptdump.md) to inspect the binary identifiers in the SPT file, and [`SPDDump /header`](spddump.md) to inspect the SPD file. A valid SPD file is used to the extent possible. Minor updates to the code that don't alter the program's control flow are tolerated. Unchanged functions also use the data for optimization. If you provide a valid, but otherwise unrelated SPD, the process works, but likely no data is usable for optimization. + +## Example + +This example imports LBR profile data from an SPT file into an SPD file: + +`SPDConvert /mode:LBR sample.spd sample.spt` + +This example imports IP profile data by using a list of SPT files: + +`SPDConvert /mode:IP /sptlist:mysptfiles.txt sample.spd` + +This example prints a summary of the profile data in an SPD file: + +`SPDConvert /summary sample.spd` + +This example extracts the embedded SPD from a PDB file: + +`SPDConvert /extract sample.pdb sample_extracted.spd` + +This example merges two SPD files from different profiling runs: + +`SPDConvert /merge combined.spd run1.spd run2.spd` + +## See also + +[Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](sample-profile-guided-optimization.md)\ +[`SPDDump`](spddump.md)\ +[`SPTAggregate`](sptaggregate.md)\ +[`SPTDump`](sptdump.md) diff --git a/docs/build/spddump.md b/docs/build/spddump.md new file mode 100644 index 00000000000..f3cfdade2b3 --- /dev/null +++ b/docs/build/spddump.md @@ -0,0 +1,68 @@ +--- +description: "Learn more about: SPDDump" +title: "SPDDump" +ms.date: 04/30/2026 +ai-usage: ai-assisted +helpviewer_keywords: ["SPDDump program", "sample profile-guided optimizations, SPDDump", "SPGO"] +--- +# SPDDump + +Use `SPDDump` to inspect Sample Profile Database (SPD) files and object files that contain sample profile data for Sample Profile-Guided Optimization (SPGO). Use this tool to verify SPD contents, troubleshoot SPD/PDB compatibility problems, and view profile details such as functions, flow graphs, coverage, and dynamic instruction estimates. Run `SPDDump` from a Visual Studio Developer Command Prompt. + +An SPD file contains processed profile data that the compiler uses to make optimization decisions during a build. + +## Syntax + +> `SPDDump` [*options*] *spdfile* + +### Parameters + +*options*\ +Specify the following options for `SPDDump`: + +- **/all** Output the entire SPD file. This option is the default. +- **/header** Output the SPD file header. +- **/module** Output the module header in the SPD file. Implies **/header**. +- **/symbol** Output the module symbol table. Implies **/module**. +- **/func** Output the function profile. Implies **/module**. +- **/funcid:**\<*fid*\> Output the function profile for the function with the given function ID. +- **/cg** Include callee information in function profile output. Implies **/func**. +- **/fg** Include the flow graph in function profile output. Implies **/func**. +- **/data** Output the data profile. Implies **/module**. +- **/minidump** Exclude sample correlation information such as RVA ranges from output. +- **/coverage** Output basic block coverage information. +- **/dyninst**[**:**\<*n*\>] Output a dynamic instruction estimate for the top 50 functions, or the top *n* functions if specified. +- **/help** Display help information. + +*spdfile*\ +The path to the SPD file or object file to inspect. + +## Remarks + +> [!NOTE] +> Run this tool from a Visual Studio developer command prompt. + +Use `SPDDump` to inspect the contents of a Sample Profile Database (SPD) file. [`SPDConvert`](spdconvert.md) produces SPD files. The build process that uses [`/SPGO`](sample-profile-guided-optimization.md) embeds these files in PDB files. + +To diagnose an "SPD version incompatible" error, use `/header` to examine the PDB GUID and age stored in the SPD file. Then, compare those values against the SPT file by using [`SPTDump /progid`](sptdump.md). + +## Example + +This example outputs estimated basic block coverage information for an SPD file: + +`SPDDump /coverage filename.spd` + +This example outputs the SPD header to check the PDB GUID and age: + +`SPDDump /header filename.spd` + +This example outputs a dynamic instruction estimate for the top 10 functions: + +`SPDDump /dyninst:10 filename.spd` + +## See also + +[Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](sample-profile-guided-optimization.md)\ +[SPDConvert](spdconvert.md)\ +[SPTDump](sptdump.md)\ +[SPTAggregate](sptaggregate.md) diff --git a/docs/build/sptaggregate.md b/docs/build/sptaggregate.md new file mode 100644 index 00000000000..1d5a67e8a6b --- /dev/null +++ b/docs/build/sptaggregate.md @@ -0,0 +1,69 @@ +--- +description: "Learn more about: SPTAggregate" +title: "SPTAggregate" +ms.date: 05/01/2026 +ai-usage: ai-assisted +helpviewer_keywords: ["SPTAggregate program", "sample profile-guided optimizations, SPTAggregate", "SPGO"] +--- +# SPTAggregate + +`SPTAggregate` is a command-line tool for Sample Profile-Guided Optimization (SPGO). Use it to combine one or more ETL (Event Trace Log) files that `xperf` collects into a single SPT (Sample Profile Trace) file. You can optionally filter data by process or binary name and exclude kernel events. After you create the SPT file, use [SPDConvert](spdconvert.md) to import it into an SPD (Sample Profile Database) file for optimization workflows. + +ETL (Event Trace Log) files contain raw hardware performance events that `xperf` records. `SPTAggregate` converts those ETL files into SPT format, which packages the sample events for import into an SPD (Sample Profile Database) file by [SPDConvert](spdconvert.md). + +## Syntax + +> `SPTAggregate` [*options*] **/etl** *etlfiles* *sptfile* + +### Parameters + +*options*\ +Specify the following options to `SPTAggregate`: + +- **/process:**\<*processes*\> Filter events by process name. Specify one or more process names as a comma-separated list.\ + Example: `/process:myapp.exe` +- **/binary:**\<*binaries*\> Filter events by binary name. Specify one or more binary names as a comma-separated list.\ + Example: `/binary:mylib.dll,myapp.exe` +- **/nokernel** Exclude OS kernel events. +- **/help** Display help information. + +*etlfiles*\ +A comma-separated list of ETL (Event Trace Log) files to process. Collect ETL files by using `xperf`. + +*sptfile*\ +The output SPT file to create. + +## Remarks + +> [!NOTE] +> Run this tool from a Visual Studio developer command prompt. + +Use `SPTAggregate` to convert one or more ETL files collected by `xperf` into an SPT file. The `/etl` flag is required and must precede the list of ETL files. You can import the resulting SPT file into an SPD file by using [`SPDConvert`](spdconvert.md). + +`SPTAggregate` uses `xperf`, which must be in your path and set up with the `perfcore.ini` changes as described in [Configure perfcore.ini](sample-profile-guided-optimization.md#configure-perfcoreini). + +When `SPTAggregate` runs `xperf`, it uses parameters like: `xperf -a spt -genSPT outputfile.spt -binary application.exe,support.dll,companion.dll` where `-a spt` specifies generate a sample profile trace analysis report, `-genSPT` specifies the output SPT file, and `-binary` focuses analysis on the specified binaries. + +For more information about `xperf` flags, see the [Xperf Command-Line Reference](/windows-hardware/test/wpt/xperf-command-line-reference) documentation. + +## Example + +This example converts a single ETL file into an SPT file: + +`SPTAggregate /etl filename.etl filename.spt` + +This example filters events to a specific process: + +`SPTAggregate /process:filename.exe /etl filename.etl filename.spt` + +This example aggregates two ETL files and excludes kernel events: + +`SPTAggregate /nokernel /etl run1.etl,run2.etl filename.spt` + +## See also + +[Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](sample-profile-guided-optimization.md)\ +[Profile-Guided Optimizations](profile-guided-optimizations.md)\ +[`SPDConvert`](spdconvert.md)\ +[`SPDDump`](spddump.md)\ +[`SPTDump`](sptdump.md) diff --git a/docs/build/sptdump.md b/docs/build/sptdump.md new file mode 100644 index 00000000000..ac885470d62 --- /dev/null +++ b/docs/build/sptdump.md @@ -0,0 +1,108 @@ +--- +description: "Learn more about: SPTDump" +title: "SPTDump" +ms.date: 05/05/2026 +ai-usage: ai-assisted +helpviewer_keywords: ["SPTDump program", "sample profile-guided optimizations, SPTDump", "SPGO"] +--- +# SPTDump + +`SPTDump` is a command-line tool for inspecting Sample Profile Trace (SPT) files used in Sample Profile-Guided Optimization (SPGO) workflows. Use it to view SPT metadata and sample data. Validate trace contents before conversion to SPD, and troubleshoot issues such as SPD version mismatches. + +An SPT file contains raw hardware performance sample events collected from an application workload. + +## Syntax + +> `SPTDump` [*options*] *sptfile* + +### Parameters + +*options*\ +Specify the following options to `SPTDump`: + +- **/all** Output the entire SPT file. This option is the default. +- **/header** Output the SPT file header. +- **/progid** Output program IDs (GUID and age for each binary). +- **/strtab** Output the string table. +- **/event** Output sample events. +- **/help** Display help information. + +*sptfile*\ +The path to the SPT file to inspect. + +## Remarks + +> [!NOTE] +> Start this tool from a Visual Studio developer command prompt. + +Use `SPTDump` to inspect the contents of a Sample Profile Trace (SPT) file. [SPTAggregate](sptaggregate.md) produces SPT files from ETL event trace logs collected by `xperf`. Import SPT files into an SPD file (Sample Profile Database) by using [SPDConvert](spdconvert.md). + +To diagnose an "SPD version incompatible" error, use `/progid` to display the GUID and age for each binary in the SPT file, and then compare those values against the SPD file by using [`SPDDump /header`](spddump.md). + +## Example + +This example outputs the full contents of an SPT file: + +`SPTDump sample.spt` + +This example outputs only the program IDs (GUID and age) for binaries in an SPT file: + +`SPTDump /progid sample.spt` + +## SPT header format + +SPT file is a binary format with a 32-byte header, string table, program ID table, and sample event data stream. This document describes version 1 of the format. The version field updates if the layout changes in the future. + +The SPT header is 32 bytes: + +- `[0x00-0x03]` Signature (uint32 LE) = 0x5350543A ("SPT:") +- `[0x04-0x07]` Version (uint32 LE) = 1 +- `[0x08-0x0B]` RawDataId (uint32 LE) = 0 (unused/reserved) +- `[0x0C-0x0F]` TargetArch (uint32 LE) = 0 (unused/reserved) +- `[0x10-0x13]` StringTableOffset (uint32 LE) = offset to binary name string table (typically 0x20) +- `[0x14-0x17]` ProgramIdTableOffset (uint32 LE) = offset to RSDSKEY table (typically StringTableOffset+StringTableCapacity) +- `[0x18-0x19]` StringTableUsed (uint16 LE) = bytes used in string table +- `[0x1A-0x1B]` StringTableCapacity (uint16 LE) = bytes allocated in string table (typically 0x4000) +- `[0x1C-0x1D]` ProgramIdsUsed (uint16 LE) = number of program IDs (often just 1) +- `[0x1E-0x1F]` ProgramIdCapacity (uint16 LE) = capacity in count (not bytes) for program IDs (typically 0x100) + +The StringTable immediately follows the header at the specified offset. It contains a null-terminated UTF-8 binary filename. +The ProgramIdTable follows the StringTable at the specified offset. Each entry is 24 bytes: 16-byte Rich Signature Data Stream (RSDS) GUID + 4-byte age + 4-byte string index into StringTable. +The data stream starts at `ProgramIdTableOffset + (ProgramIdCapacity * 24)`, and starts with a `SPT_OP_BINARY_ID` opcode. + +**SPT Opcodes** + +In the following descriptions: +- RVA means the 32-bit relative virtual address of an instruction in the binary, that is, it's offset in the module. +- LE means little-endian byte order. + +`SPT_OP_REPEAT` (0x82)\ +Repeat the next record for the specified number of times. A repeat count of 2 means that there are 3 identical records in total. The repeat count resets after processing it.\ +Layout: 1 byte: opcode 0x82. 1 byte: padding. 8 bytes: repeat count (uint64 LE) + +`SPT_OP_UNHALT_CYCLE`, `SPT_OP_RETIRE_INSTR`, `SPT_OP_RETIRE_BR_INSTR`, `SPT_OP_L1_ICACHE_MISS`, `SPT_OP_L1_DCACHE_MISS`, `SPT_OP_ETW_INSTR` (0x01, 0x02, 0x03, 0x04, 0x05, 0x41)\ +Layout: 1 byte: opcode. 1 byte: RVA count (N). 4N bytes: N RVAs (uint32 LE each)\ +Each RVA represents an IP sample hit count = 1 + repeat count. + +`SPT_OP_LBR` (0x10)\ +Layout: 1 byte: opcode 0x10. 1 byte: event count (N). 8N bytes: N LBR pairs, each pair is: 4 bytes: To RVA (uint32 LE), 4 bytes: From RVA (uint32 LE)\ +Each pair represents a branch arc with hit count = 1 + repeat count. + +`SPT_OP_ETW_CALLSTACK` (0x42)\ +Layout: 1 byte: opcode 0x42. 1 byte: RVA count (N). 4N bytes: N RVAs (uint32 LE each, representing stack frames).\ +When: +- N = 2: Two RVAs form a single stack arc (RVA[0], RVA[1]) +- N > 2: Creates N-1 arcs from consecutive pairs: (RVA[0]->RVA[1]), (RVA[1]->RVA[2]), ..., (RVA[N-2]->RVA[N-1]) +Each series, whether it's a single arc or consecutive pairs, has hit count = 1 + repeat count. + +`SPT_OP_BINARY_ID` (0x81)\ +Layout: 1 byte: opcode 0x81. 1 byte: padding. 2 bytes: program ID (uint16 LE). 4 bytes: total data length in this segment (uint32 LE).\ +Marks the start of data records for a specific binary specified by an index ID. The index ID refers back to the RSDSKey and binary name string table in the SPT header.\ +The data length includes the 4-byte length field itself. This opcode can occur multiple times in a data stream. + +## See also + +[Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve performance](sample-profile-guided-optimization.md)\ +[`SPDConvert`](spdconvert.md)\ +[`SPDDump`](spddump.md)\ +[`SPTAggregate`](sptaggregate.md) \ No newline at end of file diff --git a/docs/build/toc.yml b/docs/build/toc.yml index 57a47a03ffb..87586735a6d 100644 --- a/docs/build/toc.yml +++ b/docs/build/toc.yml @@ -137,6 +137,8 @@ items: items: - name: Profile-guided optimizations href: ../build/profile-guided-optimizations.md + - name: Sample profile-guided optimization tutorial + href: ../build/sample-profile-guided-optimization.md - name: Environment variables for profile-guided optimizations href: ../build/environment-variables-for-profile-guided-optimizations.md - name: PgoAutoSweep @@ -145,6 +147,14 @@ items: href: ../build/pgomgr.md - name: pgosweep href: ../build/pgosweep.md + - name: SPDConvert + href: ../build/spdconvert.md + - name: SPDDump + href: ../build/spddump.md + - name: SPTAggregate + href: ../build/sptaggregate.md + - name: SPTDump + href: ../build/sptdump.md - name: "How to: Merge multiple PGO profiles into a single profile" href: ../build/how-to-merge-multiple-pgo-profiles-into-a-single-profile.md - name: Use the MSVC toolset from the command line From 6e36160bae7f91379985d39b29ec8ee58385deb1 Mon Sep 17 00:00:00 2001 From: AndrewDeanMS <45858683+AndrewDeanMS@users.noreply.github.com> Date: Mon, 11 May 2026 19:07:28 -0700 Subject: [PATCH 1762/1799] Document /feature:APX (#6709) * Document /feature:APX --------- Co-authored-by: Andrew Dean --- docs/build/reference/arch-x64.md | 1 + .../compiler-options-listed-alphabetically.md | 3 +- .../compiler-options-listed-by-category.md | 3 +- .../feature-enable-architecture-features.md | 23 +++++++++ docs/build/reference/feature-x64.md | 48 +++++++++++++++++++ docs/build/toc.yml | 7 ++- docs/preprocessor/predefined-macros.md | 18 +++++++ 7 files changed, 98 insertions(+), 5 deletions(-) create mode 100644 docs/build/reference/feature-enable-architecture-features.md create mode 100644 docs/build/reference/feature-x64.md diff --git a/docs/build/reference/arch-x64.md b/docs/build/reference/arch-x64.md index 696f055f190..da9e57733f8 100644 --- a/docs/build/reference/arch-x64.md +++ b/docs/build/reference/arch-x64.md @@ -84,5 +84,6 @@ Support for **`/arch:AVX10.1`** was added in Visual Studio 2022. Support for **` ## See also [`/arch` (Minimum CPU Architecture)](arch-minimum-cpu-architecture.md)\ +[`/feature` (x64)](feature-x64.md)\ [MSVC compiler options](compiler-options.md)\ [MSVC compiler command-line syntax](compiler-command-line-syntax.md) diff --git a/docs/build/reference/compiler-options-listed-alphabetically.md b/docs/build/reference/compiler-options-listed-alphabetically.md index 193a21544b1..bc25a3051cb 100644 --- a/docs/build/reference/compiler-options-listed-alphabetically.md +++ b/docs/build/reference/compiler-options-listed-alphabetically.md @@ -66,7 +66,7 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/FC`](fc-full-path-of-source-code-file-in-diagnostics.md) | Displays the full path of source code files passed to *cl.exe* in diagnostic text. | | [`/Fd`](fd-program-database-file-name.md) | Renames program database file. | | [`/Fe`](fe-name-exe-file.md) | Renames the executable file. | -| [`/feature`](feature-arm64.md) | Enable architecture features.17.10 | +| [`/feature`](feature-enable-architecture-features.md) | Enable architecture features. | | [`/forceInterlockedFunctions`](force-interlocked-functions.md) | Dynamically selects between Armv8.0 load, store exclusive instructions or Armv8.1 LSE atomic instructions based on target CPU.17.14 | | [`/FI`](fi-name-forced-include-file.md) | Preprocesses the specified include file. | | [`/Fi`](fi-preprocess-output-file-name.md) | Specifies the preprocessed output file name. | @@ -261,7 +261,6 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/Zs`](zs-syntax-check-only.md) | Checks syntax only. | | [`/ZW`](zw-windows-runtime-compilation.md) | Produces an output file to run on the Windows Runtime. | -17.10 This option is available starting in Visual Studio 2022 version 17.10.\ 17.14 This option is available starting in Visual Studio 2022 version 17.14. ## See also diff --git a/docs/build/reference/compiler-options-listed-by-category.md b/docs/build/reference/compiler-options-listed-by-category.md index 5b2a78c030d..b5498287621 100644 --- a/docs/build/reference/compiler-options-listed-by-category.md +++ b/docs/build/reference/compiler-options-listed-by-category.md @@ -43,7 +43,7 @@ This article contains a categorical list of compiler options. For an alphabetica | [`/EHc`](eh-exception-handling-model.md) | `extern "C"` defaults to `nothrow`. | | [`/EHr`](eh-exception-handling-model.md) | Always generate `noexcept` runtime termination checks. | | [`/EHs`](eh-exception-handling-model.md) | Enable C++ exception handling (no SEH exceptions). | -| [`/feature`](feature-arm64.md) | Enable architecture features.17.10 | +| [`/feature`](feature-enable-architecture-features.md) | Enable architecture features. | | [`/forceInterlockedFunctions`](force-interlocked-functions.md) | Dynamically selects between Armv8.0 load, store exclusive instructions or Armv8.1 LSE atomic instructions based on target CPU.17.14 | | [`/fp:contract`](fp-specify-floating-point-behavior.md) | Consider floating-point contractions when generating code. | | [`/fp:except[-]`](fp-specify-floating-point-behavior.md) | Consider floating-point exceptions when generating code. | @@ -329,7 +329,6 @@ Experimental options may only be supported by certain versions of the compiler. | [`/Ze`](za-ze-disable-language-extensions.md) | Deprecated. Enables language extensions. | | [`/Zg`](zg-generate-function-prototypes.md) | Removed in Visual Studio 2015. Generates function prototypes. | -17.10 This option is available starting in Visual Studio 2022 version 17.10.\ 17.14 This option is available starting in Visual Studio 2022 version 17.14. ## See also diff --git a/docs/build/reference/feature-enable-architecture-features.md b/docs/build/reference/feature-enable-architecture-features.md new file mode 100644 index 00000000000..b9ca7324c68 --- /dev/null +++ b/docs/build/reference/feature-enable-architecture-features.md @@ -0,0 +1,23 @@ +--- +description: "Learn more about: /feature (Enable architecture features)" +title: "/feature (Enable architecture features)" +ms.date: 05/11/2026 +f1_keywords: ["/feature"] +helpviewer_keywords: ["-feature compiler option [C++]", "/feature compiler option [C++]", "feature compiler option [C++]"] +--- +# `/feature` (Enable architecture features) + +The **`/feature`** option enables specific architecture features for code generation. Select the target platform you're working with to see **`/feature`** options for that platform. + +- [`/feature` (ARM64)](feature-arm64.md)17.10 + +- [`/feature` (x64)](feature-x64.md)14.51 + +17.10 This option is available starting in Visual Studio 2022 version 17.10.\ +14.51 This option ships with MSVC Build Tools version 14.51. Available as part of Visual Studio starting with version 18.6. + +## See also + +[`/arch` (Minimum CPU architecture)](arch-minimum-cpu-architecture.md)\ +[MSVC compiler options](compiler-options.md)\ +[MSVC compiler command-line syntax](compiler-command-line-syntax.md) diff --git a/docs/build/reference/feature-x64.md b/docs/build/reference/feature-x64.md new file mode 100644 index 00000000000..4e36fb8a8d5 --- /dev/null +++ b/docs/build/reference/feature-x64.md @@ -0,0 +1,48 @@ +--- +description: "Learn more about: /feature (x64)" +title: "/feature (x64)" +ms.date: 05/11/2026 +--- +# `/feature` (x64) + +Enable one or more architecture features for x64 code generation. + +> [!NOTE] +> **`/feature:APX`** support is experimental and subject to change. + +## Syntax + +> **`/feature:`** + +## Arguments + +To enable one or more features the x64 target supports, specify one or more of the following feature arguments: + +| Feature argument | Description | Supported in version | +|--|--|--| +| **`APX`** | Enables preview support for Intel APX (Advanced Performance Extensions). Enables the compiler to target various APX features like Extended General-Purpose Registers (EGPRs), New Data Destination (NDD), No-Flags Update (NF), new conditional ISA and optimized registers save/restore operations. For more information, see [Intel Advanced Performance Extensions (APX)](https://www.intel.com/content/www/us/en/developer/articles/technical/advanced-performance-extensions-apx.html). | MSVC Build Tools 14.51 (Preview Support) | + +## Remarks + +Example usage: to enable APX, specify **`/feature:APX`**. + +When **`/feature:APX`** is specified, the following preprocessor macros are defined: `__APX_F__`, `__CCMP__`, `__CF__`, `__EGPR__`, `__NDD__`, `__NF__`, `__PPX__`, `__PUSH2POP2__`, and `__ZU__`. For more information, see [Microsoft-specific predefined macros](../../preprocessor/predefined-macros.md). + +### To set the `/feature` compiler option in Visual Studio + +1. Open the **Property Pages** dialog box for the project. For more information, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). + +1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page. + +1. In the **Additional options** box, add *`/feature:APX`*. Choose **OK** to save your changes. + +### To set this compiler option programmatically + +- See . + +## See also + +[`/arch` (x64)](arch-x64.md)\ +[`/arch` (Minimum CPU architecture)](arch-minimum-cpu-architecture.md)\ +[MSVC compiler options](compiler-options.md)\ +[MSVC compiler command-line syntax](compiler-command-line-syntax.md) diff --git a/docs/build/toc.yml b/docs/build/toc.yml index 87586735a6d..345c6fa37fe 100644 --- a/docs/build/toc.yml +++ b/docs/build/toc.yml @@ -571,7 +571,12 @@ items: - name: /FC (Full path of source code file in diagnostics) href: ../build/reference/fc-full-path-of-source-code-file-in-diagnostics.md - name: /feature (Enable architecture features) - href: ../build/reference/feature-arm64.md + href: ../build/reference/feature-enable-architecture-features.md + items: + - name: /feature (ARM64) + href: ../build/reference/feature-arm64.md + - name: /feature (x64) + href: ../build/reference/feature-x64.md - name: /forceInterlockedFunctions (Generate and link with out-of-line atomic functions) href: ./reference/force-interlocked-functions.md diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index f76713d42fa..40a086752f7 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -65,6 +65,8 @@ The compiler supports these predefined macros specified by the ISO C99, C11, C17 MSVC supports other predefined macros: +- `__APX_F__` Defined as 1 when the [`/feature:APX`](../build/reference/feature-x64.md) compiler option is set and the compiler target is x64. Otherwise, undefined. + - `__ARM_ARCH` Defined as an integer literal that represents the ARM architecture version. The value is defined as 8 for the Armv8-A architecture. For 8.1 and onwards, the value is scaled for minor versions, such as X.Y, by using the formula X * 100 + Y as defined by the ARM C language extension. For example, for Armv8.1, `__ARM_ARCH` is 8 * 100 + 1 or 801. To set the ARM architecture version, see [`/arch (ARM64)`](../build/reference/arch-arm64.md). This macro was introduced in Visual Studio 2022 version 17.10. - `__ATOM__` Defined as 1 when the [`/favor:ATOM`](../build/reference/favor-optimize-for-architecture-specifics.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. @@ -85,6 +87,10 @@ MSVC supports other predefined macros: - `__AVX10_VER__` Defined as an integer that represents version of AVX10 when the [`/arch:AVX10.1`](../build/reference/arch-x86.md) or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__CCMP__` Defined as 1 when the [`/feature:APX`](../build/reference/feature-x64.md) compiler option is set and the compiler target is x64. Otherwise, undefined. + +- `__CF__` Defined as 1 when the [`/feature:APX`](../build/reference/feature-x64.md) compiler option is set and the compiler target is x64. Otherwise, undefined. + - `_CHAR_UNSIGNED` Defined as 1 if the default **`char`** type is unsigned. This value is defined when the [**`/J`** (Default char type is unsigned)](../build/reference/j-default-char-type-is-unsigned.md) compiler option is set. Otherwise, undefined. - `__CLR_VER` Defined as an integer literal that represents the version of the Common Language Runtime (CLR) used to compile the app. The value is encoded in the form `Mmmbbbbb`, where `M` is the major version of the runtime, `mm` is the minor version of the runtime, and `bbbbb` is the build number. `__CLR_VER` is defined if the [`/clr`](../build/reference/clr-common-language-runtime-compilation.md) compiler option is set. Otherwise, undefined. @@ -169,6 +175,8 @@ MSVC supports other predefined macros: - `_DLL` Defined as 1 when the [`/MD`](../build/reference/md-mt-ld-use-run-time-library.md) or [`/MDd`](../build/reference/md-mt-ld-use-run-time-library.md) (Multithreaded DLL) compiler option is set. Otherwise, undefined. +- `__EGPR__` Defined as 1 when the [`/feature:APX`](../build/reference/feature-x64.md) compiler option is set and the compiler target is x64. Otherwise, undefined. + - `__FUNCDNAME__` Defined as a string literal that contains the [decorated name](../build/reference/decorated-names.md) of the enclosing function. The macro is defined only within a function. The `__FUNCDNAME__` macro isn't expanded if you use the [`/EP`](../build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md) or [`/P`](../build/reference/p-preprocess-to-a-file.md) compiler option. This example uses the `__FUNCDNAME__`, `__FUNCSIG__`, and `__FUNCTION__` macros to display function information. @@ -287,6 +295,10 @@ MSVC supports other predefined macros: - `_MT` Defined as 1 when [**`/MD`** or **`/MDd`** (Multithreaded DLL)](../build/reference/md-mt-ld-use-run-time-library.md) or [**`/MT`** or **`/MTd`** (Multithreaded)](../build/reference/md-mt-ld-use-run-time-library.md) is specified. Otherwise, undefined. +- `__NDD__` Defined as 1 when the [`/feature:APX`](../build/reference/feature-x64.md) compiler option is set and the compiler target is x64. Otherwise, undefined. + +- `__NF__` Defined as 1 when the [`/feature:APX`](../build/reference/feature-x64.md) compiler option is set and the compiler target is x64. Otherwise, undefined. + - `_NATIVE_WCHAR_T_DEFINED` Defined as 1 when the [`/Zc:wchar_t`](../build/reference/zc-wchar-t-wchar-t-is-native-type.md) compiler option is set. Otherwise, undefined. - `_OPENMP` Defined as integer literal 200203, if the [**`/openmp`** (Enable OpenMP 2.0 Support)](../build/reference/openmp-enable-openmp-2-0-support.md) compiler option is set. This value represents the date of the OpenMP specification implemented by MSVC. Otherwise, undefined. @@ -300,8 +312,12 @@ MSVC supports other predefined macros: } ``` +- `__PPX__` Defined as 1 when the [`/feature:APX`](../build/reference/feature-x64.md) compiler option is set and the compiler target is x64. Otherwise, undefined. + - `_PREFAST_` Defined as 1 when the [`/analyze`](../build/reference/analyze-code-analysis.md) compiler option is set. Otherwise, undefined. +- `__PUSH2POP2__` Defined as 1 when the [`/feature:APX`](../build/reference/feature-x64.md) compiler option is set and the compiler target is x64. Otherwise, undefined. + - `__SANITIZE_ADDRESS__` Available beginning with Visual Studio 2019 version 16.9. Defined as 1 when the [`/fsanitize=address`](../build/reference/fsanitize.md) compiler option is set. Otherwise, undefined. - `__TIMESTAMP__` Defined as a string literal that contains the date and time of the last modification of the current source file, in the abbreviated, constant length form returned by the CRT [`asctime`](../c-runtime-library/reference/asctime-wasctime.md) function, for example, `Fri 19 Aug 13:32:58 2016`. This macro is always defined. @@ -316,6 +332,8 @@ MSVC supports other predefined macros: - `_WINRT_DLL` Defined as 1 when compiled as C++ and both [**`/ZW`** (Windows Runtime Compilation)](../build/reference/zw-windows-runtime-compilation.md) and [**`/LD`** or **`/LDd`**](../build/reference/md-mt-ld-use-run-time-library.md) compiler options are set. Otherwise, undefined. +- `__ZU__` Defined as 1 when the [`/feature:APX`](../build/reference/feature-x64.md) compiler option is set and the compiler target is x64. Otherwise, undefined. + No preprocessor macros that identify the ATL or MFC library version are predefined by the compiler. ATL and MFC library headers define these version macros internally. They're undefined in preprocessor directives made before the required header is included. - `_ATL_VER` Defined in `` as an integer literal that encodes the ATL version number. From 16be863b73532098bb25d96eefbdf19668cc645b Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 11 May 2026 19:08:17 -0700 Subject: [PATCH 1763/1799] New assembler directives for unwind version 3 (#6701) * Add MASM Unwind Version 3 (experimental) documentation --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: AgostonSzepessy --- docs/assembler/masm/at-unwindversion.md | 60 ++++++++++++++ docs/assembler/masm/directives-reference.md | 45 +++++++++- docs/assembler/masm/dot-allocstack.md | 78 +++++++++++++++--- docs/assembler/masm/dot-beginepilog.md | 59 +++++++++++++ docs/assembler/masm/dot-endepilog.md | 60 ++++++++++++++ docs/assembler/masm/dot-endprolog.md | 19 ++++- docs/assembler/masm/dot-freestack.md | 74 +++++++++++++++++ docs/assembler/masm/dot-pop2reg.md | 76 +++++++++++++++++ docs/assembler/masm/dot-popframe.md | 74 +++++++++++++++++ docs/assembler/masm/dot-popreg.md | 70 ++++++++++++++++ docs/assembler/masm/dot-push2reg.md | 65 +++++++++++++++ docs/assembler/masm/dot-pushframe.md | 47 +++++++++-- docs/assembler/masm/dot-pushreg.md | 58 ++++++++++--- docs/assembler/masm/dot-restorereg.md | 77 +++++++++++++++++ docs/assembler/masm/dot-restorexmm128.md | 77 +++++++++++++++++ docs/assembler/masm/dot-savereg.md | 56 +++++++++++-- docs/assembler/masm/dot-savexmm128.md | 55 +++++++++++-- docs/assembler/masm/dot-setframe.md | 54 ++++++++++-- docs/assembler/masm/dot-unsetframe.md | 82 +++++++++++++++++++ docs/assembler/masm/masm-for-x64-ml64-exe.md | 45 +++++++--- .../ml-and-ml64-command-line-reference.md | 8 +- docs/assembler/masm/proc.md | 10 +-- docs/assembler/masm/symbols-reference.md | 7 +- docs/assembler/toc.yml | 22 +++++ 24 files changed, 1202 insertions(+), 76 deletions(-) create mode 100644 docs/assembler/masm/at-unwindversion.md create mode 100644 docs/assembler/masm/dot-beginepilog.md create mode 100644 docs/assembler/masm/dot-endepilog.md create mode 100644 docs/assembler/masm/dot-freestack.md create mode 100644 docs/assembler/masm/dot-pop2reg.md create mode 100644 docs/assembler/masm/dot-popframe.md create mode 100644 docs/assembler/masm/dot-popreg.md create mode 100644 docs/assembler/masm/dot-push2reg.md create mode 100644 docs/assembler/masm/dot-restorereg.md create mode 100644 docs/assembler/masm/dot-restorexmm128.md create mode 100644 docs/assembler/masm/dot-unsetframe.md diff --git a/docs/assembler/masm/at-unwindversion.md b/docs/assembler/masm/at-unwindversion.md new file mode 100644 index 00000000000..388cfd802e7 --- /dev/null +++ b/docs/assembler/masm/at-unwindversion.md @@ -0,0 +1,60 @@ +--- +description: "Learn more about: @UnwindVersion" +title: "@UnwindVersion" +ms.date: 05/07/2026 +f1_keywords: ["@UnwindVersion"] +helpviewer_keywords: ["@UnwindVersion symbol"] +ai-usage: ai-assisted +--- +# \@UnwindVersion + +A predefined macro that returns the unwind version the `.asm` file is being assembled with. + +## Syntax + +> **\@UnwindVersion** + +## Remarks + +> [!IMPORTANT] +> This symbol is experimental and is subject to change. Enable Unwind Version 3 with `ml64.exe /unwindv3`. + +**\@UnwindVersion** is set to the unwind version used by the assembler. When `/unwindv3` is passed to `ml64.exe`, **\@UnwindVersion** is set to `3`; otherwise it's set to `1`. + +Use this macro with conditional assembly directives such as `IF` to assemble different code paths depending on the unwind version. + +This example is intended to be assembled only as it doesn't define an application entry point: + +## Example for unwindv3 + +```asm +; ml64 /c /unwindv3 ex1.asm +.code + +IF @UnwindVersion EQ 3 + +foo PROC FRAME + .pushreg r12 + push r12 + + .endprolog + + mov rax, 0 + + .beginepilog + .popreg r12 + pop r12 + .endepilog + ret +foo ENDP +ELSE + .ERR <@UnwindVersion should be 3> +ENDIF + +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/directives-reference.md b/docs/assembler/masm/directives-reference.md index c9f7208c7d7..97de3fcad7a 100644 --- a/docs/assembler/masm/directives-reference.md +++ b/docs/assembler/masm/directives-reference.md @@ -4,7 +4,7 @@ title: "Directives Reference" ms.date: 07/15/2020 f1_keywords: ["Directives Reference"] helpviewer_keywords: ["MASM (Microsoft Macro Assembler), directives reference"] -ms.assetid: da6efcd1-18f7-41de-81cd-a002a02f9a22 +ai-usage: ai-assisted --- # Directives Reference @@ -27,6 +27,49 @@ ms.assetid: da6efcd1-18f7-41de-81cd-a002a02f9a22 :::column-end::: :::row-end::: +## x64 Unwind Version 3 (experimental) + +The following directives are used with `ml64.exe` when the `/unwindv3` option is enabled. Unwind Version 3 is experimental and is subject to change. + +**Prologue directives** + +:::row::: + :::column span=""::: + [`.ALLOCSTACK`](dot-allocstack.md)\ + [`.ENDPROLOG`](dot-endprolog.md)\ + [`.PUSH2REG`](dot-push2reg.md) + :::column-end::: + :::column span=""::: + [`.PUSHFRAME`](dot-pushframe.md)\ + [`.PUSHREG`](dot-pushreg.md)\ + [`.SAVEREG`](dot-savereg.md) + :::column-end::: + :::column span=""::: + [`.SAVEXMM128`](dot-savexmm128.md)\ + [`.SETFRAME`](dot-setframe.md) + :::column-end::: +:::row-end::: + +**Epilogue directives** + +:::row::: + :::column span=""::: + [`.BEGINEPILOG`](dot-beginepilog.md)\ + [`.ENDEPILOG`](dot-endepilog.md)\ + [`.FREESTACK`](dot-freestack.md) + :::column-end::: + :::column span=""::: + [`.POP2REG`](dot-pop2reg.md)\ + [`.POPFRAME`](dot-popframe.md)\ + [`.POPREG`](dot-popreg.md)\ + [`.RESTOREREG`](dot-restorereg.md) + :::column-end::: + :::column span=""::: + [`.RESTOREXMM128`](dot-restorexmm128.md)\ + [`.UNSETFRAME`](dot-unsetframe.md) + :::column-end::: +:::row-end::: + ## Code Labels :::row::: diff --git a/docs/assembler/masm/dot-allocstack.md b/docs/assembler/masm/dot-allocstack.md index 13c5e6e1146..6d0881627bd 100644 --- a/docs/assembler/masm/dot-allocstack.md +++ b/docs/assembler/masm/dot-allocstack.md @@ -1,39 +1,41 @@ --- description: "Learn more about: .ALLOCSTACK" title: ".ALLOCSTACK" -ms.date: "12/17/2019" +ms.date: 05/11/2026 f1_keywords: [".ALLOCSTACK"] helpviewer_keywords: [".ALLOCSTACK directive"] -ms.assetid: 9801594b-7ac2-4df2-a49d-07d9dd9af99e +ai-usage: ai-assisted --- # .ALLOCSTACK -Generates a **UWOP_ALLOC_SMALL** or a **UWOP_ALLOC_LARGE** with the specified size for the current offset in the prologue. +`.ALLOCSTACK` generates a **UWOP_ALLOC_SMALL** or a **UWOP_ALLOC_LARGE** with the specified size for the current offset in the prologue. ## Syntax -> **.ALLOCSTACK** *size* +> `.ALLOCSTACK` *size* ## Remarks -MASM will choose the most efficient encoding for a given size. +Microsoft Assembler (MASM) chooses the most efficient encoding for a given size. -**.ALLOCSTACK** allows ml64.exe users to specify how a frame function unwinds and is only allowed within the prologue, which extends from the [PROC](proc.md) FRAME declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives do not generate code; they only generate `.xdata` and `.pdata`. **.ALLOCSTACK** should be preceded by instructions that actually implement the actions to be unwound. It is a good practice to wrap both the unwind directives and the code they are meant to unwind in a macro to ensure agreement. +`.ALLOCSTACK` allows `ml64.exe` users to specify how a frame function unwinds and is only allowed within the prologue, which extends from the [PROC](proc.md) `FRAME` declaration to the [.ENDPROLOG](dot-endprolog.md) directive. +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. +- Precede `.ALLOCSTACK` with the instructions that actually implement the actions to be unwound. Wrap both the unwind directives and the code they're meant to unwind in a macro to ensure agreement. The *size* operand must be a multiple of 8. -For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md). +The epilogue counterpart is [.FREESTACK](dot-freestack.md). -## Sample +## Example: specify an unwind version 3 unwind/exception handler The following sample shows how to specify an unwind/exception handler: ```asm -; ml64 ex3.asm /link /entry:Example1 /SUBSYSTEM:Console +; ml64 ex3.asm /link /entry:Example3 /SUBSYSTEM:Console text SEGMENT PUBLIC Example3 PUBLIC Example3_UW -Example3_UW PROC NEAR +Example3_UW PROC ; exception/unwind handler body ret 0 @@ -56,7 +58,61 @@ text ENDS END ``` +## Unwind Version 3 behavior + +> [!IMPORTANT] +> Unwind Version 3 support is experimental and is subject to change. Enable it by using `ml64.exe /unwindv3`. + +`.ALLOCSTACK` generates a `WOD_ALLOC_SMALL`, `WOD_ALLOC_LARGE`, or `WOD_ALLOC_HUGE` Unwind Version 3 unwind code entry with the specified size for the current offset in the prolog. + +`.ALLOCSTACK` must appear **before** the `sub rsp, N` instruction it describes. This requirement is the opposite of Version 1, where the directive follows the instruction. + +MASM emits one of three unwind codes depending on the allocation size: + +| Unwind code | Condition | +|---|---| +| `WOD_ALLOC_SMALL` | *size* ≤ 128 bytes | +| `WOD_ALLOC_LARGE` | *size* ≤ 32 KB | +| `WOD_ALLOC_HUGE` | *size* > 32 KB | + +Version 1 generates only `UWOP_ALLOC_SMALL` or `UWOP_ALLOC_LARGE`. Version 3 adds a third variant, `WOD_ALLOC_HUGE`, for allocations larger than 32 KB. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +### Example for unwindv3 + +```asm +; ml64 ex3.asm /unwindv3 /link /entry:Example3 /SUBSYSTEM:Console +text SEGMENT +PUBLIC Example3 +PUBLIC Example3_UW +Example3_UW PROC + ; exception/unwind handler body + + ret 0 + +Example3_UW ENDP + +Example3 PROC FRAME : Example3_UW + +.allocstack 16 + sub rsp, 16 + +.endprolog + + ; function body + add rsp, 16 + ret 0 + +Example3 ENDP +text ENDS +END +``` + ## See also +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ [Directives Reference](directives-reference.md)\ -[MASM BNF Grammar](masm-bnf-grammar.md) +[MASM BNF Grammar](masm-bnf-grammar.md)\ +[MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md) \ No newline at end of file diff --git a/docs/assembler/masm/dot-beginepilog.md b/docs/assembler/masm/dot-beginepilog.md new file mode 100644 index 00000000000..9f05bcdaf1d --- /dev/null +++ b/docs/assembler/masm/dot-beginepilog.md @@ -0,0 +1,59 @@ +--- +description: "Learn more about: .BEGINEPILOG" +title: ".BEGINEPILOG" +ms.date: 05/04/2026 +ai-usage: ai-assisted +f1_keywords: [".BEGINEPILOG"] +helpviewer_keywords: [".BEGINEPILOG directive"] +--- +# .BEGINEPILOG + +Marks the start of an epilogue unwind region. This directive doesn't emit an Unwind Operation Descriptors (WOD) code. + +## Syntax + +> `.BEGINEPILOG` + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. +> Enable Unwind Version 3 by using `ml64.exe /unwindv3`. + +`.BEGINEPILOG` is only valid in Unwind Version 3. + +- It marks the start of an epilogue region where epilogue unwind operations are recorded. Pair `.BEGINEPILOG` with a closing [.ENDEPILOG](dot-endepilog.md) or no epilog unwind codes are emitted. +- In Unwind Version 3, epilog directives are mandatory for epilog unwind code generation. +- Epilogues must contain at least one directive. +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +## Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .allocstack 16 + sub rsp, 16 +.endprolog + ; function body + .beginepilog + .freestack 16 + add rsp, 16 + .endepilog + ret +Example1 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[Directives Reference](directives-reference.md)\ +[.ENDEPILOG](dot-endepilog.md)\ +[.ENDPROLOG](dot-endprolog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-endepilog.md b/docs/assembler/masm/dot-endepilog.md new file mode 100644 index 00000000000..af9383ae19e --- /dev/null +++ b/docs/assembler/masm/dot-endepilog.md @@ -0,0 +1,60 @@ +--- +description: "Learn more about: .ENDEPILOG" +title: ".ENDEPILOG" +ms.date: "04/29/2026" +ai-usage: ai-assisted +f1_keywords: [".ENDEPILOG"] +helpviewer_keywords: [".ENDEPILOG directive"] +--- +# .ENDEPILOG + +Marks the end of an epilogue unwind region. This directive doesn't emit a Windows unwind data (WOD) unwind code. + +## Syntax + +> **.ENDEPILOG** + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. +> Enable Unwind Version 3 by using `ml64.exe /unwindv3`. + +**.ENDEPILOG** is only valid in Unwind Version 3. + +- It marks the end of an epilogue region started by [.BEGINEPILOG](dot-beginepilog.md). +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. +- Epilogues must contain at least one directive. +- Epilogue directives are mandatory for epilogue unwind code generation. No epilogue unwind codes are emitted without a `.BEGINEPILOG`/`.ENDEPILOG` pair. +- It's an error to use epilogue directives outside of the region between [.BEGINEPILOG](dot-beginepilog.md) and **.ENDEPILOG**. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +## Example + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .allocstack 16 + sub rsp, 16 +.endprolog + ; function body + .beginepilog + .freestack 16 + add rsp, 16 + .endepilog + ret +Example1 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[Directives Reference](directives-reference.md)\ +[.BEGINEPILOG](dot-beginepilog.md)\ +[.ENDPROLOG](dot-endprolog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-endprolog.md b/docs/assembler/masm/dot-endprolog.md index c864e0c8494..bc366ab72e5 100644 --- a/docs/assembler/masm/dot-endprolog.md +++ b/docs/assembler/masm/dot-endprolog.md @@ -1,14 +1,14 @@ --- description: "Learn more about: .ENDPROLOG" title: ".ENDPROLOG" -ms.date: "12/17/2019" +ms.date: 05/06/2026 f1_keywords: [".ENDPROLOG"] helpviewer_keywords: [".ENDPROLOG directive"] -ms.assetid: 61a2474c-9527-46e6-9f9d-bc4b42c10f35 +ai-usage: ai-assisted --- # .ENDPROLOG -Signals the end of the prologue declarations. +Marks the end of the prologue declarations. ## Syntax @@ -16,11 +16,22 @@ Signals the end of the prologue declarations. ## Remarks -It is an error to use any of the prologue declarations outside of the region between [PROC](proc.md) **FRAME** and **.ENDPROLOG**. +It's an error to use any of the prologue declarations outside of the region between [PROC](proc.md) `FRAME` and **.ENDPROLOG**. For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md). +## Unwind Version 3 behavior + +> [!IMPORTANT] +> Unwind Version 3 support is experimental and is subject to change. +> Enable it with `ml64.exe /unwindv3`. + +`.ENDPROLOG` is also used in Unwind Version 3 and continues to mark the end of the function prologue. It doesn't generate a Windows unwind data (WOD) unwind code entry. + +It's an error to use any prologue directive outside the region between `PROC FRAME` and `.ENDPROLOG`. + ## See also +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ [Directives Reference](directives-reference.md)\ [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-freestack.md b/docs/assembler/masm/dot-freestack.md new file mode 100644 index 00000000000..bf80a2be682 --- /dev/null +++ b/docs/assembler/masm/dot-freestack.md @@ -0,0 +1,74 @@ +--- +description: "Learn more about: .FREESTACK" +title: ".FREESTACK" +ms.date: 05/06/2026 +f1_keywords: [".FREESTACK"] +helpviewer_keywords: [".FREESTACK directive"] +ai-usage: ai-assisted +--- +# .FREESTACK + +Generates a **WOD_ALLOC_SMALL**, **WOD_ALLOC_LARGE**, or **WOD_ALLOC_HUGE** unwind code entry with the specified size for the current offset in the epilogue. + +## Syntax + +> **.FREESTACK** *size* + +## Parameters + +*size*\ +The number of bytes to deallocate from the stack. Must be a multiple of 8. + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. +> Enable Unwind Version 3 by using `ml64.exe /unwindv3`. + +- You can use **.FREESTACK** only in Unwind Version 3. It's the epilogue counterpart to [.ALLOCSTACK](dot-allocstack.md). +- You can use **.FREESTACK** only within an epilogue region, between [.BEGINEPILOG](dot-beginepilog.md) and [.ENDEPILOG](dot-endepilog.md). +- In Unwind Version 3, **.FREESTACK** must appear **before** the `add rsp, N` instruction that implements the stack deallocation. +- To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. +- Microsoft Assembler (MASM) chooses the most efficient encoding for a given size. + +MASM emits one of three unwind codes depending on the size: + +| Unwind code | Condition | +|---|---| +| `WOD_ALLOC_SMALL` | *size* ≤ 128 bytes | +| `WOD_ALLOC_LARGE` | *size* ≤ 32 KB | +| `WOD_ALLOC_HUGE` | *size* > 32 KB | + +In Unwind Version 3, epilogue directives are mandatory for epilogue unwind code generation. The assembler doesn't emit epilogue unwind codes without a `.BEGINEPILOG`/`.ENDEPILOG` pair. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +## Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .allocstack 16 + sub rsp, 16 +.endprolog + ; function body + .beginepilog + .freestack 16 + add rsp, 16 + .endepilog + ret +Example1 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[Directives Reference](directives-reference.md)\ +[.ALLOCSTACK](dot-allocstack.md)\ +[.BEGINEPILOG](dot-beginepilog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-pop2reg.md b/docs/assembler/masm/dot-pop2reg.md new file mode 100644 index 00000000000..56dbdff4b52 --- /dev/null +++ b/docs/assembler/masm/dot-pop2reg.md @@ -0,0 +1,76 @@ +--- +description: "Learn more about: .POP2REG" +title: ".POP2REG" +ms.date: 05/04/2026 +f1_keywords: [".POP2REG"] +helpviewer_keywords: [".POP2REG directive"] +ai-usage: ai-assisted +--- +# .POP2REG + +Generates a two-register pop unwind code entry for the specified register pair using the current offset in the epilogue. + +## Syntax + +> **.POP2REG** *register1*, *register2* + +## Parameters + +*register1*\ +The first register to pop. Must be a general-purpose 64-bit register. + +*register2*\ +The second register to pop. Must be a general-purpose 64-bit register. + +*register1* and *register2* may each be one of:\ +`RAX, RCX, RDX, RBX, RDI, RSI, RBP, R8, R9, R10, R11, R12, R13, R14, R15, R16, R17, R18, R19, R20, R21, R22, R23, R24, R25, R26, R27, R28, R29, R30, R31`. + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. Enable Unwind Version 3 with `ml64.exe /unwindv3`. + +- **.POP2REG** is only valid in Unwind Version 3. It's the epilogue counterpart to [.PUSH2REG](dot-push2reg.md). +- **.POP2REG** is only allowed within an epilogue region, between [.BEGINEPILOG](dot-beginepilog.md) and [.ENDEPILOG](dot-endepilog.md). +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. +- In Unwind Version 3, **.POP2REG** must appear **before** the instruction that actually implements the action to be unwound. +- In Unwind Version 3, epilogue directives are mandatory for epilogue unwind code generation. No epilogue unwind codes are emitted without a `.BEGINEPILOG`/`.ENDEPILOG` pair. +- To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. + +If *register1* and *register2* are consecutive and in increasing order, MASM emits a `WOD_PUSH_CONSECUTIVE_2` unwind code. Otherwise, MASM emits a `WOD_PUSH2` unwind code. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +## Example + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .push2reg rbx, rsi + push2 rbx, rsi + .push2reg r10, r11 + push2 r10, r11 +.endprolog + ; rest of function ... + .beginepilog + .pop2reg r10, r11 + pop2 r10, r11 + .pop2reg rbx, rsi + pop2 rbx, rsi + .endepilog + ret +Example1 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[Directives Reference](directives-reference.md)\ +[.PUSH2REG](dot-push2reg.md)\ +[.POPREG](dot-popreg.md)\ +[.BEGINEPILOG](dot-beginepilog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-popframe.md b/docs/assembler/masm/dot-popframe.md new file mode 100644 index 00000000000..6f0d869f13d --- /dev/null +++ b/docs/assembler/masm/dot-popframe.md @@ -0,0 +1,74 @@ +--- +description: "Learn more about: .POPFRAME" +title: ".POPFRAME" +ms.date: 05/01/2026 +f1_keywords: [".POPFRAME"] +helpviewer_keywords: [".POPFRAME directive"] +ai-usage: ai-assisted +--- +# .POPFRAME + +Generates a `WOD_PUSH_CANONICAL_FRAME` Windows unwind data (WOD) unwind code entry in the epilogue. + +## Syntax + +> **.POPFRAME** ⟦**CODE** | *value*⟧ + +## Parameters + +*value*\ +An optional numeric modifier in the range 0–255.\ +Mutually exclusive with **CODE**. If you specify the optional **CODE** keyword, the unwind code entry receives a modifier of 1.\ +If you specify an optional numeric *value* instead, it receives the specified value.\ +If you don't pass an argument, the value is 0. + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. Enable Unwind Version 3 with `ml64.exe /unwindv3`. + +The **.POPFRAME** directive lets `ml64.exe` users specify how a frame function unwinds in an epilog. You can only use it within an epilog region, between [.BEGINEPILOG](dot-beginepilog.md) and [.ENDEPILOG](dot-endepilog.md). + +- **.POPFRAME** is only valid in Unwind Version 3. It's the epilog counterpart of [.PUSHFRAME](dot-pushframe.md). The operand value should match the corresponding **.PUSHFRAME** in the prologue. +- In Unwind Version 3, **.POPFRAME** must appear **before** the instruction that implements the action to be unwound. To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. +- In Unwind Version 3, epilogue directives are mandatory for epilogue unwind code generation. No epilogue unwind codes are emitted without a `.BEGINEPILOG`/`.ENDEPILOG` pair. +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. + +> [!NOTE] +> In Unwind Version 1, directives appear after the corresponding instruction. In Unwind Version 3, directives appear **before** the instruction. + +## Example for unwindv3 + +The following example shows how to use **.POPFRAME** in an epilogue to indicate an interrupt handler that pushes and pops a canonical machine frame. + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .pushframe + .pushreg rbx + push rbx + .allocstack 32 + sub rsp, 32 +.endprolog + ; interrupt handler body ... + .beginepilog + .freestack 32 + add rsp, 32 + .popreg rbx + pop rbx + .popframe + .endepilog + iretq +Example1 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[.PUSHFRAME](dot-pushframe.md)\ +[.BEGINEPILOG](dot-beginepilog.md)\ +[.ENDEPILOG](dot-endepilog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-popreg.md b/docs/assembler/masm/dot-popreg.md new file mode 100644 index 00000000000..963e7de0f48 --- /dev/null +++ b/docs/assembler/masm/dot-popreg.md @@ -0,0 +1,70 @@ +--- +description: "Learn more about: .POPREG" +title: ".POPREG" +ms.date: 05/04/2026 +f1_keywords: [".POPREG"] +helpviewer_keywords: [".POPREG directive"] +ai-usage: ai-assisted +--- +# .POPREG + +Generates a `WOD_PUSH` unwind code entry for the specified register using the current offset in the epilogue. + +## Syntax + +> .POPREG *register* + +## Parameters + +*register*\ +The register to pop. Must be a general-purpose 64-bit register. + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. Enable Unwind Version 3 by using the `/unwindv3` option in ml64.exe. + +`.POPREG` is only valid in Unwind Version 3. It's the epilogue counterpart to [.PUSHREG](dot-pushreg.md). + +`.POPREG` is only allowed within an epilogue region, between [.BEGINEPILOG](dot-beginepilog.md) and [.ENDEPILOG](dot-endepilog.md). These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. In Unwind Version 3, `.POPREG` must appear **before** the `pop` instruction that implements the register restore. To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. + +*register* may be one of:\ +`RAX, RCX, RDX, RBX, RDI, RSI, RBP, R8, R9, R10, R11, R12, R13, R14, R15, R16, R17, R18, R19, R20, R21, R22, R23, R24, R25, R26, R27, R28, R29, R30, R31` + +In Unwind Version 3, epilogue directives are mandatory for epilogue unwind code generation. The assembler doesn't emit epilogue unwind codes without a `.BEGINEPILOG`/`.ENDEPILOG` pair. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +## Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .pushreg rbx + push rbx + .pushreg rsi + push rsi +.endprolog + ; rest of function ... + .beginepilog + .popreg rsi + pop rsi + .popreg rbx + pop rbx + .endepilog + ret +Example1 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[Directives Reference](directives-reference.md)\ +[.PUSHREG](dot-pushreg.md)\ +[.POP2REG](dot-pop2reg.md)\ +[.BEGINEPILOG](dot-beginepilog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-push2reg.md b/docs/assembler/masm/dot-push2reg.md new file mode 100644 index 00000000000..d43e1113271 --- /dev/null +++ b/docs/assembler/masm/dot-push2reg.md @@ -0,0 +1,65 @@ +--- +description: "Learn more about: .PUSH2REG" +title: ".PUSH2REG" +ms.date: 05/04/2026 +f1_keywords: [".PUSH2REG"] +helpviewer_keywords: [".PUSH2REG directive"] +ai-usage: ai-assisted +--- +# .PUSH2REG + +Generates a two-register push unwind code entry for the specified register pair using the current offset in the prologue. + +## Syntax + +> `.PUSH2REG` *register1*, *register2* + +## Parameters + +*register1*\ +The first register to push. Must be a general-purpose 64-bit register. + +*register2*\ +The second register to push. Must be a general-purpose 64-bit register. + +*register1* and *register2* may each be one of:\ +`RAX, RCX, RDX, RBX, RDI, RSI, RBP, R8, R9, R10, R11, R12, R13, R14, R15, R16, R17, R18, R19, R20, R21, R22, R23, R24, R25, R26, R27, R28, R29, R30, R31.` + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. Enable Unwind Version 3 by using `ml64.exe /unwindv3`. + +- Use `.PUSH2REG` to specify how a frame function unwinds. You can only use this directive within the prologue, which extends from the [PROC](proc.md) `FRAME` declaration to the [.ENDPROLOG](dot-endprolog.md) directive. +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. In Unwind Version 3, `.PUSH2REG` must appear **before** the instruction that actually implements the action to be unwound. To ensure agreement, it's a good practice to wrap both the unwind directives and the code they're meant to unwind in a macro. +- If *register1* and *register2* are consecutive and in increasing order, MASM emits a `WOD_PUSH_CONSECUTIVE_2` unwind code. Otherwise, MASM emits a `WOD_PUSH2` unwind code. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +## Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .push2reg r10, r11 + push2 r10, r11 + .push2reg rbx, rsi + push2 rbx, rsi +.endprolog + ; rest of function ... + ret +Example1 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[Directives Reference](directives-reference.md)\ +[.POP2REG](dot-pop2reg.md)\ +[.PUSHREG](dot-pushreg.md)\ +[.ENDPROLOG](dot-endprolog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-pushframe.md b/docs/assembler/masm/dot-pushframe.md index 07dc3972dfc..da3d77c596f 100644 --- a/docs/assembler/masm/dot-pushframe.md +++ b/docs/assembler/masm/dot-pushframe.md @@ -4,23 +4,58 @@ description: "Describes the .PUSHFRAME MASM directive, used to specify how to un ms.date: "12/06/2019" f1_keywords: [".PUSHFRAME"] helpviewer_keywords: [".PUSHFRAME directive"] -ms.assetid: 17b123d0-4c6d-4fd2-85eb-798e8ad0a73c +ai-usage: ai-assisted --- # .PUSHFRAME -Generates a `UWOP_PUSH_MACHFRAME` unwind code entry. If the optional **CODE** keyword is specified, the unwind code entry is given a modifier of 1. Otherwise the modifier is 0. +Generates a `UWOP_PUSH_MACHFRAME` unwind code entry. If you specify the optional **CODE** keyword, the unwind code entry gets a modifier of 1. Otherwise, the modifier is 0. ## Syntax -> **.PUSHFRAME** ⟦**CODE**⟧;; +> `.PUSHFRAME` ⟦**CODE**⟧ ;Prior to Unwind Version 3 +> `.PUSHFRAME` ⟦**CODE**⟧ | [0-255] ;Unwind Version 3 specific ## Remarks -.PUSHFRAME allows ml64.exe users to specify how a frame function unwinds. It's only allowed within the prologue, which extends from the [PROC](proc.md) FRAME declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives don't generate code; they only generate `.xdata` and `.pdata`. **.PUSHFRAME** should be preceded by instructions that actually implement the actions to be unwound. It's a good practice to wrap both the unwind directives and the code they're meant to unwind in a macro to ensure agreement. +Use `.PUSHFRAME` with `ml64.exe` to specify how a frame function unwinds. You can only use it within the prologue, which extends from the [PROC](proc.md) `FRAME` declaration to the [.ENDPROLOG](dot-endprolog.md) directive. +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. +- Precede `.PUSHFRAME` with the instructions that implement the actions to be unwound. +- To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. -For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md). +## Unwind Version 3 behavior + +> [!IMPORTANT] +> Unwind Version 3 support is experimental and is subject to change. Enable it by using `ml64.exe /unwindv3`. + +In Unwind Version 3, `.PUSHFRAME` emits a `WOD_PUSH_CANONICAL_FRAME` unwind code entry.\ +When you specify the optional **CODE** keyword, the unwind code entry modifier value is 1.\ +If you specify an optional *value*, the directive uses it directly.\ +If you don't pass an argument, the value is 0. The *value* must be in the range 0–255. + +> **Note:** In Unwind Version 1 the directives come after the instruction. In Unwind Version 3, the directives come before the instruction. +> `.PUSHFRAME` must appear **before** the instruction it describes. This behavior is the opposite of Version 1, where the directive follows the instruction. + +### Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .pushframe CODE +.endprolog + ; interrupt handler body ... + iretq +Example1 ENDP +_text ENDS +END +``` + +The epilogue counterpart is [.POPFRAME](dot-popframe.md). ## See also +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ [Directives reference](directives-reference.md)\ -[MASM BNF Grammar](masm-bnf-grammar.md) +[.POPFRAME](dot-popframe.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md)\ +[MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md) diff --git a/docs/assembler/masm/dot-pushreg.md b/docs/assembler/masm/dot-pushreg.md index a433f688d6e..d6a48cb5227 100644 --- a/docs/assembler/masm/dot-pushreg.md +++ b/docs/assembler/masm/dot-pushreg.md @@ -1,10 +1,10 @@ --- description: "Learn more about: .PUSHREG" title: ".PUSHREG" -ms.date: "12/16/2019" +ms.date: 05/04/2026 f1_keywords: [".PUSHREG"] helpviewer_keywords: [".PUSHREG directive"] -ms.assetid: e0c83758-dfed-40ea-afe6-cb833c8d2d30 +ai-usage: ai-assisted --- # .PUSHREG @@ -14,23 +14,20 @@ Generates a `UWOP_PUSH_NONVOL` unwind code entry for the specified register numb > .PUSHREG *register* -## Remarks - -**.PUSHREG** allows ml64.exe users to specify how a frame function unwinds, and is only allowed within the prologue, which extends from the [PROC](proc.md) **FRAME** declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives do not generate code; they only generate `.xdata` and `.pdata`. **.PUSHREG** should be preceded by instructions that actually implement the actions to be unwound. It is a good practice to wrap both the unwind directives and the code they are meant to unwind in a macro to ensure agreement. - *register* may be one of:\ -RAX | RCX | RDX | RBX | RDI | RSI | RBP | R8 | R9 | R10 | R11 | R12 | R13 | R14 | R15. - -For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md). +`RAX, RCX, RDX, RBX, RDI, RSI, RBP, R8, R9, R10, R11, R12, R13, R14, R15` -## Sample +Unwind Version 3 extends register support to include R16–R31. *register* may be one of:\ +`RAX, RCX, RDX, RBX, RDI, RSI, RBP, R8, R9, R10, R11, R12, R13, R14, R15, R16, R17, R18, R19, R20, R21, R22, R23, R24, R25, R26, R27, R28, R29, R30, R31` -### Description +## Remarks -The following sample shows how to push non-volatile registers. +Use `.PUSHREG` with `ml64.exe` to specify how a frame function unwinds. You can only use `.PUSHREG` within the prologue, which extends from the [PROC](proc.md) `FRAME` declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. Precede `.PUSHREG` with the instructions that actually implement the actions to be unwound. To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. ### Code +The following sample shows how to push nonvolatile registers. + ```asm ; ml64 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE _text SEGMENT @@ -51,7 +48,42 @@ _text ENDS END ``` +## Unwind Version 3 behavior + +> [!IMPORTANT] +> Unwind Version 3 support is experimental and is subject to change. Enable it by using `ml64.exe /unwindv3`. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. +> In Unwind Version 3, `.PUSHREG` generates a `WOD_PUSH` unwind code entry and must appear **before** the `push reg` instruction it describes. This requirement is the opposite of Version 1, where the directive follows the instruction. + +### Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .pushreg r10 + push r10 + .pushreg r15 + push r15 + .pushreg rbx + push rbx + .pushreg rsi + push rsi +.endprolog + ; rest of function ... + ret +Example1 ENDP +_text ENDS +END +``` + +The epilogue counterpart is [.POPREG](dot-popreg.md). + ## See also +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ [Directives reference](directives-reference.md)\ -[MASM BNF Grammar](masm-bnf-grammar.md) +[MASM BNF Grammar](masm-bnf-grammar.md)\ +[MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md) \ No newline at end of file diff --git a/docs/assembler/masm/dot-restorereg.md b/docs/assembler/masm/dot-restorereg.md new file mode 100644 index 00000000000..94836c8da74 --- /dev/null +++ b/docs/assembler/masm/dot-restorereg.md @@ -0,0 +1,77 @@ +--- +description: "Learn more about: .RESTOREREG" +title: ".RESTOREREG" +ms.date: 05/04/2026 +f1_keywords: [".RESTOREREG"] +helpviewer_keywords: [".RESTOREREG directive"] +ai-usage: ai-assisted +--- +# .RESTOREREG + +Generates either a `WOD_SAVE_NONVOL` or a `WOD_SAVE_NONVOL_FAR` unwind code entry for the specified register and offset, using the current epilogue offset. + +## Syntax + +> `.RESTOREREG` *reg*, *offset* + +## Parameters + +*reg*\ +The nonvolatile register to restore. + +*offset*\ +The stack offset from which the register is restored. + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. Enable Unwind Version 3 by using `ml64.exe /unwindv3`. + +`.RESTOREREG` is only valid in Unwind Version 3. It's the epilogue counterpart to [.SAVEREG](dot-savereg.md). + +Microsoft Assembler (MASM) chooses the most efficient encoding for a given offset. + +- `.RESTOREREG` is only allowed within an epilogue region, between [.BEGINEPILOG](dot-beginepilog.md) and [.ENDEPILOG](dot-endepilog.md). +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. +- In Unwind Version 3, `.RESTOREREG` must appear **before** the instruction that loads the register from the stack. +- To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. +- In Unwind Version 3, epilogue directives are mandatory for epilogue unwind code generation. No epilogue unwind codes are emitted without a `.BEGINEPILOG`/`.ENDEPILOG` pair. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +## Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .allocstack 020h + sub rsp, 020h + .savereg rbx, 0 + mov [rsp], rbx + .savereg rsi, 8 + mov [rsp+8], rsi +.endprolog + ; rest of function ... + .beginepilog + .restorereg rsi, 8 + mov rsi, [rsp+8] + .restorereg rbx, 0 + mov rbx, [rsp] + .freestack 020h + add rsp, 020h + .endepilog + ret +Example1 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[Directives Reference](directives-reference.md)\ +[.SAVEREG](dot-savereg.md)\ +[.BEGINEPILOG](dot-beginepilog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-restorexmm128.md b/docs/assembler/masm/dot-restorexmm128.md new file mode 100644 index 00000000000..03d1bc27750 --- /dev/null +++ b/docs/assembler/masm/dot-restorexmm128.md @@ -0,0 +1,77 @@ +--- +description: "Learn more about: .RESTOREXMM128" +title: ".RESTOREXMM128" +ms.date: 05/06/2026 +f1_keywords: [".RESTOREXMM128"] +helpviewer_keywords: [".RESTOREXMM128 directive"] +ai-usage: ai-assisted +--- +# .RESTOREXMM128 + +Generates either a `WOD_SAVE_XMM128` or a `WOD_SAVE_XMM128_FAR` Unwind Version 3 unwind code entry for the specified XMM register and offset using the current epilogue offset. + +## Syntax + +> `.RESTOREXMM128` *xmmreg*, *offset* + +## Parameters + +*xmmreg*\ +The XMM register to restore. + +*offset*\ +The stack offset from which the register is restored. Must be a multiple of 16. + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. Enable Unwind Version 3 with `ml64.exe /unwindv3`. + +`.RESTOREXMM128` is only valid in Unwind Version 3. It's the epilogue counterpart to [.SAVEXMM128](dot-savexmm128.md). + +Microsoft Assembler (MASM) chooses the most efficient encoding for a given offset. + +- `.RESTOREXMM128` is only allowed within an epilogue region, between [.BEGINEPILOG](dot-beginepilog.md) and [.ENDEPILOG](dot-endepilog.md). +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. +- In Unwind Version 3, `.RESTOREXMM128` must appear **before** the instruction that loads the XMM register from the stack. +- To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. +- In Unwind Version 3, epilogue directives are mandatory for epilogue unwind code generation. No epilogue unwind codes are emitted without a `.BEGINEPILOG`/`.ENDEPILOG` pair. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +## Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .allocstack 030h + sub rsp, 030h + .savexmm128 xmm6, 0 + movdqa [rsp], xmm6 + .savexmm128 xmm7, 010h + movdqa [rsp+010h], xmm7 +.endprolog + ; rest of function ... + .beginepilog + .restorexmm128 xmm7, 010h + movdqa xmm7, [rsp+010h] + .restorexmm128 xmm6, 0 + movdqa xmm6, [rsp] + .freestack 030h + add rsp, 030h + .endepilog + ret +Example1 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[Directives Reference](directives-reference.md)\ +[.SAVEXMM128](dot-savexmm128.md)\ +[.BEGINEPILOG](dot-beginepilog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-savereg.md b/docs/assembler/masm/dot-savereg.md index a786f88777f..654d19cfe57 100644 --- a/docs/assembler/masm/dot-savereg.md +++ b/docs/assembler/masm/dot-savereg.md @@ -1,26 +1,70 @@ --- description: "Learn more about: .SAVEREG" title: ".SAVEREG" -ms.date: "12/16/2019" +ms.date: 05/06/2026 f1_keywords: [".SAVEREG"] helpviewer_keywords: [".SAVEREG directive"] -ms.assetid: 1dbc2ef6-a197-40e7-9e55-fddcae8cef29 +ai-usage: ai-assisted --- # .SAVEREG -Generates either a `UWOP_SAVE_NONVOL` or a `UWOP_SAVE_NONVOL_FAR` unwind code entry for the specified register (*reg*) and offset (*offset*) using the current prologue offset. MASM will choose the most efficient encoding. +Generates either a `UWOP_SAVE_NONVOL` or a `UWOP_SAVE_NONVOL_FAR` unwind code entry for the specified register (*reg*) and offset (*offset*) using the current prologue offset. Microsoft Assembler (MASM) chooses the most efficient encoding. ## Syntax -> **.SAVEREG** *reg*__,__ *offset* +> `.SAVEREG` *reg*__,__ *offset* ## Remarks -**.SAVEREG** allows ml64.exe users to specify how a frame function unwinds and is only allowed within the prologue, which extends from the [PROC](proc.md) FRAME declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives do not generate code; they only generate `.xdata` and `.pdata`. **.SAVEREG** should be preceded by instructions that actually implement the actions to be unwound. It is a good practice to wrap both the unwind directives and the code they are meant to unwind in a macro to ensure agreement. +Use `.SAVEREG` with `ml64.exe` to specify how a frame function unwinds. You can only use it within the prologue, which extends from the [`PROC`](proc.md) `FRAME` declaration to the [.ENDPROLOG](dot-endprolog.md) directive. +- These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. +- Precede `.SAVEREG` with instructions that actually implement the actions to be unwound. +- To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. -For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md). +## Unwind Version 3 behavior + +> [!IMPORTANT] +> Unwind Version 3 support is experimental and is subject to change. Enable it by using `ml64.exe /unwindv3`. + +In Unwind Version 3, `.SAVEREG` emits either a `WOD_SAVE_NONVOL` or a `WOD_SAVE_NONVOL_FAR` unwind code entry. MASM selects the most efficient encoding based on the size of *offset*: + +| Unwind code | Condition | +|---|---| +| `WOD_SAVE_NONVOL` | *offset* can be encoded as a scaled 16-bit value | +| `WOD_SAVE_NONVOL_FAR` | *offset* requires a full 32-bit value | + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. +> `.SAVEREG` must appear **before** the instruction it describes. This requirement is the opposite of Version 1, where the directive follows the instruction. + +### Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .allocstack 020h + sub rsp, 020h + .savereg rbx, 0 + mov [rsp], rbx + .savereg rsi, 8 + mov [rsp+8], rsi +.endprolog + ; rest of function ... + mov rsi, [rsp+8] + mov rbx, [rsp] + add rsp, 020h + ret +Example1 ENDP +_text ENDS +END +``` + +The epilogue counterpart is [.RESTOREREG](dot-restorereg.md). ## See also +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ [Directives reference](directives-reference.md)\ +[MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md)\ [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-savexmm128.md b/docs/assembler/masm/dot-savexmm128.md index 6a914c5547f..ed2fae15341 100644 --- a/docs/assembler/masm/dot-savexmm128.md +++ b/docs/assembler/masm/dot-savexmm128.md @@ -1,28 +1,69 @@ --- description: "Learn more about: .SAVEXMM128" title: ".SAVEXMM128" -ms.date: "12/17/2019" +ms.date: 05/04/2026 f1_keywords: [".SAVEXMM128"] helpviewer_keywords: [".SAVEXMM128 directive"] -ms.assetid: 551eb472-b8d0-47b1-8d82-995d1f485723 +ai-usage: ai-assisted --- # .SAVEXMM128 -Generates either a `UWOP_SAVE_XMM128` or a `UWOP_SAVE_XMM128_FAR` unwind code entry for the specified XMM register and offset using the current prologue offset. MASM will choose the most efficient encoding. +Generates either a `UWOP_SAVE_XMM128` or a `UWOP_SAVE_XMM128_FAR` unwind code entry for the specified XMM register and offset using the current prologue offset. Microsoft Assembler (MASM) chooses the most efficient encoding. ## Syntax -> **.SAVEXMM128** *xmmreg* , *offset* +> `.SAVEXMM128` *xmmreg* , *offset* ## Remarks -**.SAVEXMM128** allows ml64.exe users to specify how a frame function unwinds, and is only allowed within the prologue, which extends from the [PROC](proc.md) FRAME declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives do not generate code; they only generate `.xdata` and `.pdata`. .SAVEXMM128 should be preceded by instructions that actually implement the actions to be unwound. It is a good practice to wrap both the unwind directives and the code they are meant to unwind in a macro to ensure agreement. +Use `.SAVEXMM128` with `ml64.exe` to specify how a frame function unwinds. You can only use it within the prologue, which extends from the [`PROC`](proc.md) `FRAME` declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. Precede `.SAVEXMM128` by the instructions that actually implement the actions to be unwound. To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. *offset* must be a multiple of 16. -For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md). +## Unwind Version 3 behavior + +> [!IMPORTANT] +> Unwind Version 3 support is experimental and is subject to change. Enable it by using `ml64.exe /unwindv3`. + +In Unwind Version 3, `.SAVEXMM128` emits either a `WOD_SAVE_XMM128` or a `WOD_SAVE_XMM128_FAR` unwind code entry. Microsoft Assembler (MASM) selects the most efficient encoding based on the size of *offset*: + +| Unwind code | Condition | +|---|---| +| `WOD_SAVE_XMM128` | *offset* can be encoded as a scaled 16-bit value | +| `WOD_SAVE_XMM128_FAR` | *offset* requires a full 32-bit value | + +> [!NOTE] +> In Unwind Version 1 the directives come after the instruction. In Unwind Version 3, the directives come before the instruction. +> `.SAVEXMM128` must appear **before** the instruction it describes. This requirement is the opposite of Version 1, where the directive follows the instruction. + +### Example for unwindv3 + +```asm +; ml64 /unwindv3 ex1.asm /link /entry:Example1 /SUBSYSTEM:CONSOLE +_text SEGMENT +Example1 PROC FRAME + .allocstack 030h + sub rsp, 030h + .savexmm128 xmm6, 0 + movdqa [rsp], xmm6 + .savexmm128 xmm7, 010h + movdqa [rsp+010h], xmm7 +.endprolog + ; rest of function ... + movdqa xmm7, [rsp+010h] + movdqa xmm6, [rsp] + add rsp, 030h + ret +Example1 ENDP +_text ENDS +END +``` + +The epilogue counterpart is [.RESTOREXMM128](dot-restorexmm128.md). ## See also +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ [Directives reference](directives-reference.md)\ -[MASM BNF Grammar](masm-bnf-grammar.md) +[MASM BNF Grammar](masm-bnf-grammar.md)\ +[MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md) diff --git a/docs/assembler/masm/dot-setframe.md b/docs/assembler/masm/dot-setframe.md index d33281ed97a..7eeec50f330 100644 --- a/docs/assembler/masm/dot-setframe.md +++ b/docs/assembler/masm/dot-setframe.md @@ -1,10 +1,10 @@ --- description: "Learn more about: .SETFRAME" title: ".SETFRAME" -ms.date: "12/17/2019" +ms.date: 05/04/2026 f1_keywords: [".SETFRAME"] helpviewer_keywords: [".SETFRAME directive"] -ms.assetid: eaa9b5ed-4daa-4f1e-bdb6-100758007ab3 +ai-usage: ai-assisted --- # .SETFRAME @@ -12,13 +12,11 @@ Fills in the frame register field and offset in the unwind information using the ## Syntax -> **.SETFRAME** *reg*, *offset* +> `.SETFRAME` *reg*, *offset* ## Remarks -**.SETFRAME** allows ml64.exe users to specify how a frame function unwinds, and is only allowed within the prologue, which extends from the [PROC](proc.md) FRAME declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives do not generate code; they only generate `.xdata` and `.pdata`. **.SETFRAME** should be preceded by instructions that actually implement the actions to be unwound. It is a good practice to wrap both the unwind directives and the code they are meant to unwind in a macro to ensure agreement. - -For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md). +Use `.SETFRAME` to specify how a frame function unwinds. You can only use it within the prologue, which extends from the [`PROC`](proc.md) `FRAME` declaration to the [.ENDPROLOG](dot-endprolog.md) directive. These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code. Precede `.SETFRAME` with instructions that implement the actions to be unwound. To ensure agreement, wrap both the unwind directives and the code they're meant to unwind in a macro. ## Sample @@ -55,7 +53,51 @@ _text ENDS END ``` +## Unwind Version 3 behavior + +> [!IMPORTANT] +> Unwind Version 3 support is experimental and is subject to change. Enable it by using `ml64.exe /unwindv3`. + +In Unwind Version 3, `.SETFRAME` emits a `WOD_SET_FPREG` unwind code entry for the specified register using the current prologue offset. It also fills in the frame register field and offset in the unwind information. The *offset* must be a multiple of 16 and less than or equal to 240. + +> [!NOTE] +> In Unwind Version 1 the directives come after the instruction. In Unwind Version 3, the directives come before the instruction. +> `.SETFRAME` must appear **before** the instruction it describes. This requirement is the opposite of Version 1, where the directive follows the instruction. + +### Example for unwindv3 + +```asm +; ml64 /unwindv3 frmex2.asm /link /entry:frmex2 /SUBSYSTEM:CONSOLE +_text SEGMENT +frmex2 PROC FRAME + .pushreg rbp + push rbp + .allocstack 010h + sub rsp, 010h + .setframe rbp, 0 + mov rbp, rsp +.endprolog + ; modify the stack pointer outside of the prologue (similar to alloca) + sub rsp, 060h + + ; we can unwind from the following AV because of the frame pointer + mov rax, 0 + mov rax, [rax] ; AV! + + add rsp, 060h + add rsp, 010h + pop rbp + ret +frmex2 ENDP +_text ENDS +END +``` + +The epilogue counterpart is [.UNSETFRAME](dot-unsetframe.md). + ## See also +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md)\ [Directives reference](directives-reference.md)\ [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/dot-unsetframe.md b/docs/assembler/masm/dot-unsetframe.md new file mode 100644 index 00000000000..10b55371053 --- /dev/null +++ b/docs/assembler/masm/dot-unsetframe.md @@ -0,0 +1,82 @@ +--- +description: "Learn more about: .UNSETFRAME" +title: ".UNSETFRAME" +ms.date: 05/04/2026 +f1_keywords: [".UNSETFRAME"] +helpviewer_keywords: [".UNSETFRAME directive"] +ai-usage: ai-assisted +--- +# .UNSETFRAME + +Generates a `WOD_SET_FPREG` unwind code entry for the specified register and offset using the current offset in the epilogue. + +## Syntax + +> `.UNSETFRAME` *reg*, *offset* + +## Parameters + +*reg*\ +The frame pointer register to unset. + +*offset*\ +The offset into the stack frame where the frame pointer was established. + +## Remarks + +> [!IMPORTANT] +> This directive is experimental and is subject to change. Enable Unwind Version 3 with `ml64.exe /unwindv3`. + +`.UNSETFRAME` is only valid in Unwind Version 3. It's the epilogue counterpart to [.SETFRAME](dot-setframe.md). + +`.UNSETFRAME` is only allowed within an epilogue region, between [.BEGINEPILOG](dot-beginepilog.md) and [.ENDEPILOG](dot-endepilog.md). These directives generate unwind metadata (`.xdata` and `.pdata` sections) but don't produce executable code.\ +In Unwind Version 3, `.UNSETFRAME` must appear **before** the instruction that restores the stack pointer from the frame pointer register.\ +It's a good practice to wrap both the unwind directives and the code they're meant to unwind in a macro to ensure agreement. + +In Unwind Version 3, epilogue directives are mandatory for epilogue unwind code generation. No epilogue unwind codes are emitted without a `.BEGINEPILOG`/`.ENDEPILOG` pair. + +> [!NOTE] +> In Unwind Version 1, the directive appears after the corresponding instruction. In Unwind Version 3, the directive appears **before** the instruction. + +## Example for unwindv3 + +```asm +; ml64 /unwindv3 frmex2.asm /link /entry:frmex2 /SUBSYSTEM:CONSOLE +_text SEGMENT +frmex2 PROC FRAME + .pushreg rbp + push rbp + .allocstack 010h + sub rsp, 010h + .setframe rbp, 0 + mov rbp, rsp +.endprolog + ; modify the stack pointer outside of the prologue (similar to alloca) + sub rsp, 060h + + ; we can unwind from the following AV because of the frame pointer + mov rax, 0 + mov rax, [rax] ; AV! + + add rsp, 060h + .beginepilog + .unsetframe rbp, 0 + mov rsp, rbp + .freestack 010h + add rsp, 010h + .popreg rbp + pop rbp + .endepilog + ret +frmex2 ENDP +_text ENDS +END +``` + +## See also + +[x64 Unwind Version 3 (experimental)](directives-reference.md#x64-unwind-version-3-experimental)\ +[Directives Reference](directives-reference.md)\ +[.SETFRAME](dot-setframe.md)\ +[.BEGINEPILOG](dot-beginepilog.md)\ +[MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/masm-for-x64-ml64-exe.md b/docs/assembler/masm/masm-for-x64-ml64-exe.md index 840b0020837..6abb9b44993 100644 --- a/docs/assembler/masm/masm-for-x64-ml64-exe.md +++ b/docs/assembler/masm/masm-for-x64-ml64-exe.md @@ -1,8 +1,9 @@ --- description: "Learn more about: Microsoft Macro Assembler (MASM) for x64 (ml64.exe)" title: "MASM for x64 (ml64.exe)" -ms.date: 09/21/2021 +ms.date: 05/07/2026 helpviewer_keywords: ["ml64", "ml64.exe", "masm for x64"] +ai-usage: ai-assisted --- # MASM for x64 (ml64.exe) @@ -21,34 +22,54 @@ The Visual Studio project system supports assembler-language files built by usin ### To add an assembler-language file to an existing Visual Studio C++ project 1. Select the project in **Solution Explorer**. On the menu bar, choose **Project**, **Build Customizations**. - 1. In the **Visual C++ Build Customization Files** dialog box, check the checkbox next to **masm(.targets,.props)**. Choose **OK** to save your selection and close the dialog box. - 1. On the menu bar, choose **Project**, **Add New Item**. - 1. In the **Add New Item** dialog box, select **C++ file (.cpp)** in the center pane. In the **Name** edit control, enter a new file name that has a *`.asm`* extension instead of *`.cpp`*. Choose **Add** to add the file to your project and close the dialog box. Create your assembler-language code in the *`.asm`* file you added. When you build your solution, the MASM assembler is invoked to assemble the *`.asm`* file into an object file that is then linked into your project. To make symbol access easier, declare your assembler functions as `extern "C"` in your C++ source code, rather than using the C++ name decoration conventions in your assembler-language source files. -## ml64-Specific Directives +## ml64-specific directives You can use the following ml64-specific directives in your assembler-language source code that targets x64: - [`.ALLOCSTACK`](dot-allocstack.md) - - [`.ENDPROLOG`](dot-endprolog.md) - - [`.PUSHFRAME`](dot-pushframe.md) - - [`.PUSHREG`](dot-pushreg.md) - - [`.SAVEREG`](dot-savereg.md) - - [`.SAVEXMM128`](dot-savexmm128.md) - - [`.SETFRAME`](dot-setframe.md) -The [`PROC`](proc.md) directive has also been updated for use with ml64.exe. +The [`PROC`](proc.md) directive is also updated for use with ml64.exe. + +## Unwind Version 3 directives (experimental) + +> [!IMPORTANT] +> Unwind Version 3 support is experimental and is subject to change. + +Unwind Version 3 is an updated unwind code scheme for x64 that generates richer stack unwind metadata. It introduces new epilogue directives, extends register support, and changes the directive ordering model. + +### Enable Unwind Version 3 + +Assemble with the `/unwindv3` option: `ml64 /unwindv3 filename.asm /link /entry:FunctionName` + +### Key differences from Version 1 + +| Feature | Version 1 | Version 3 | +|---|---|---| +| Directive ordering | Directive follows instruction | Directive precedes instruction | +| Unwind codes | `UWOP_*` | `WOD_*` | +| `.ALLOCSTACK` size variants | 2 (`UWOP_ALLOC_SMALL`, `UWOP_ALLOC_LARGE`) | 3 (adds `WOD_ALLOC_HUGE` for > 32 KB) | +| `.PUSHREG` register range | R0–R15 | R0–R31 | +| Epilogue recording | Optional | Mandatory (`.BEGINEPILOG`/`.ENDEPILOG` required) | +| Register-pair push/pop | Not supported | `.PUSH2REG`/`.POP2REG` directives | + +Epilogue recording is mandatory in Version 3: `.BEGINEPILOG` and `.ENDEPILOG` must surround the epilogue instructions. Without them, no epilogue unwind codes are emitted. + +> [!NOTE] +> In Unwind Version 1 the directives come after the instruction. In Unwind Version 3, the directives come before the instruction. + +For a complete list of Version 3 directives, see [x64 Unwind Version 3 directives](directives-reference.md) and [@UnwindVersion](at-unwindversion.md). ## 32-Bit Address Mode (Address Size Override) diff --git a/docs/assembler/masm/ml-and-ml64-command-line-reference.md b/docs/assembler/masm/ml-and-ml64-command-line-reference.md index e4ea469e36f..990ae9b5d2a 100644 --- a/docs/assembler/masm/ml-and-ml64-command-line-reference.md +++ b/docs/assembler/masm/ml-and-ml64-command-line-reference.md @@ -1,9 +1,10 @@ --- title: "ML and ML64 command-line reference" description: "Reference guide to the Microsoft MASM ML and ML64 assembler command-line options." -ms.date: 7/3/2023 -f1_keywords: ["ML"] -helpviewer_keywords: ["/W* MASM compiler option", "/c MASM compiler option", "/EP MASM compiler option", "/Fe MASM compiler option", "/Zp MASM compiler option", "/AT MASM compiler option", "/Zm MASM compiler option", "/Sf MASM compiler option", "/Sp MASM compiler option", "/w MASM compiler option", "/Fl MASM compiler option", "/coff MASM compiler option", "/St MASM compiler option", "/Cx MASM compiler option", "/Sl MASM compiler option", "/Cu MASM compiler option", "MASM (Microsoft Macro Assembler), ML command-line reference", "/FPi MASM compiler option", "/Zf MASM compiler option", "ML environment variable", "/Fr MASM compiler option", "/help MASM compiler option", "/Sa MASM compiler option", "/Zd MASM compiler option", "/I MASM compiler option", "/? MASM compiler option", "/Bl MASM compiler option", "/Fm MASM compiler option", "/Fo MASM compiler option", "command-line reference [ML]", "/Sn MASM compiler option", "/Gd MASM compiler option", "/D* MASM compiler option", "environment variables, ML", "/Gc MASM compiler option", "/F* MASM compiler option", "/Sc MASM compiler option", "/H MASM compiler option", "/Zs MASM compiler option", "/omf MASM compiler option", "/quiet MASM compiler option", "/Sg MASM compiler option", "/Cp MASM compiler option", "/Zi MASM compiler option", "/nologo MASM compiler option", "/Sx MASM compiler option", "/WX MASM compiler option", "/Ss MASM compiler option", "command line, reference [ML]", "/Ta MASM compiler option"] +ms.date: 04/29/2026 +ai-usage: ai-assisted +f1_keywords: ["ML", "/unwindv3"] +helpviewer_keywords: ["/W* MASM compiler option", "/c MASM compiler option", "/EP MASM compiler option", "/Fe MASM compiler option", "/Zp MASM compiler option", "/AT MASM compiler option", "/Zm MASM compiler option", "/Sf MASM compiler option", "/Sp MASM compiler option", "/w MASM compiler option", "/Fl MASM compiler option", "/coff MASM compiler option", "/St MASM compiler option", "/Cx MASM compiler option", "/Sl MASM compiler option", "/Cu MASM compiler option", "MASM (Microsoft Macro Assembler), ML command-line reference", "/FPi MASM compiler option", "/Zf MASM compiler option", "ML environment variable", "/Fr MASM compiler option", "/help MASM compiler option", "/Sa MASM compiler option", "/Zd MASM compiler option", "/I MASM compiler option", "/? MASM compiler option", "/Bl MASM compiler option", "/Fm MASM compiler option", "/Fo MASM compiler option", "command-line reference [ML]", "/Sn MASM compiler option", "/Gd MASM compiler option", "/D* MASM compiler option", "environment variables, ML", "/Gc MASM compiler option", "/F* MASM compiler option", "/Sc MASM compiler option", "/H MASM compiler option", "/Zs MASM compiler option", "/omf MASM compiler option", "/quiet MASM compiler option", "/Sg MASM compiler option", "/Cp MASM compiler option", "/Zi MASM compiler option", "/nologo MASM compiler option", "/Sx MASM compiler option", "/WX MASM compiler option", "/Ss MASM compiler option", "command line, reference [ML]", "/Ta MASM compiler option", "/unwindv3 MASM compiler option"] --- # ML and ML64 command-line reference @@ -61,6 +62,7 @@ The options listed in the following table: | **`/St`** *`text`* | Specifies title for source listing. Same as [`TITLE`](title.md) text. | | **`/Sx`** | Turns on false conditionals in listing. | | **`/Ta`** *`filename`* | Assembles source file whose name doesn't end with the *`.asm`* extension. | +| **`/unwindv3`** | Enables experimental Unwind Version 3 unwind directive support. When specified, V3 unwind directives must appear *before* their associated instruction (the reverse of V1 behavior), epilogue recording via [`.BEGINEPILOG`](dot-beginepilog.md)/[`.ENDEPILOG`](dot-endepilog.md) is required, and the predefined macro [`@UnwindVersion`](at-unwindversion.md) returns `3`. For more information, see [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md).
    Only available in ml64.exe. | | **`/w`** | Same as **`/W0 /WX`**. | | **`/W`** *`level`* | Sets the warning level, where *`level`* = 0, 1, 2, or 3. | | **`/WX`** | If warnings are generated, returns an error code. | diff --git a/docs/assembler/masm/proc.md b/docs/assembler/masm/proc.md index 9eb65fc3770..222b437a4a9 100644 --- a/docs/assembler/masm/proc.md +++ b/docs/assembler/masm/proc.md @@ -12,8 +12,8 @@ Marks start and end of a procedure block called *label*. The statements in the b ## Syntax -> *label* **PROC** ⟦*distance*⟧ ⟦*language-type*⟧ ⟦ **PUBLIC** | **PRIVATE** | **EXPORT** ⟧ ⟦__\<__*prologuearg*__>__⟧ ⟦**USES** *reglist*⟧ ⟦__,__ *parameter* ⟦__:__*tag*⟧ ...⟧\ -> ⟦**FRAME** ⟦__:__*ehandler-address*⟧ ⟧\ +> *label* `PROC` ⟦*distance*⟧ ⟦*language-type*⟧ ⟦ `PUBLIC` | `PRIVATE` | `EXPORT` ⟧ ⟦__\<__*prologuearg*__>__⟧ ⟦`USES` *reglist*⟧ ⟦__,__ *parameter* ⟦__:__*tag*⟧ ...⟧\ +> ⟦`FRAME` ⟦__:__*ehandler-address*⟧ ⟧\ > *statements*\ > *label* **ENDP** @@ -21,9 +21,9 @@ Marks start and end of a procedure block called *label*. The statements in the b The ⟦*distance*⟧ and ⟦*language-type*⟧ arguments are valid only in 32-bit MASM. -⟦**FRAME** ⟦__:__*ehandler-address*⟧ ⟧ is only valid with ml64.exe, and causes MASM to generate a function table entry in .pdata and unwind information in .xdata for a function's structured exception handling unwind behavior. +⟦`FRAME` ⟦__:__*ehandler-address*⟧ ⟧ is only valid with ml64.exe, and causes MASM to generate a function table entry in .pdata and unwind information in .xdata for a function's structured exception handling unwind behavior. -When the **FRAME** attribute is used, it must be followed by an [.ENDPROLOG](dot-endprolog.md) directive. +When the `FRAME` attribute is used, it must be followed by an [.ENDPROLOG](dot-endprolog.md) directive. See [MASM for x64 (ml64.exe)](masm-for-x64-ml64-exe.md) for more information on using ml64.exe. @@ -49,7 +49,7 @@ _text ENDS END ``` -The above code will emit the following function table and unwind information: +The above code emits the following function table and unwind information: ```Output FileHeader->Machine 34404 diff --git a/docs/assembler/masm/symbols-reference.md b/docs/assembler/masm/symbols-reference.md index c7fd4af9f81..a6c296fc5c1 100644 --- a/docs/assembler/masm/symbols-reference.md +++ b/docs/assembler/masm/symbols-reference.md @@ -1,9 +1,9 @@ --- description: "Learn more about: Symbols reference" title: "Symbols reference" -ms.date: 07/15/2020 +ms.date: 05/04/2026 helpviewer_keywords: ["MASM (Microsoft Macro Assembler), symbols reference"] -ms.assetid: 96ed59cc-dafa-4299-bb2e-9c7c3f496491 +ai-usage: ai-assisted --- # Symbols reference @@ -30,6 +30,9 @@ ms.assetid: 96ed59cc-dafa-4299-bb2e-9c7c3f496491 :::column span=""::: [`@Interface`](at-interface.md) :::column-end::: + :::column span=""::: + [`@UnwindVersion`](at-unwindversion.md) + :::column-end::: :::column span=""::: [`@Version`](at-version.md) :::column-end::: diff --git a/docs/assembler/toc.yml b/docs/assembler/toc.yml index 8f8b923a9c3..1e90a1e19d3 100644 --- a/docs/assembler/toc.yml +++ b/docs/assembler/toc.yml @@ -117,6 +117,8 @@ items: href: ../assembler/masm/dot-alpha.md - name: ASSUME href: ../assembler/masm/assume.md + - name: .BEGINEPILOG + href: ../assembler/masm/dot-beginepilog.md - name: .BREAK href: ../assembler/masm/dot-break.md - name: BYTE @@ -171,6 +173,8 @@ items: href: ../assembler/masm/end-masm.md - name: .ENDIF href: ../assembler/masm/dot-endif.md + - name: .ENDEPILOG + href: ../assembler/masm/dot-endepilog.md - name: ENDM href: ../assembler/masm/endm.md - name: ENDP @@ -225,6 +229,8 @@ items: href: ../assembler/masm/forc.md - name: .FPO href: ../assembler/masm/dot-fpo.md + - name: .FREESTACK + href: ../assembler/masm/dot-freestack.md - name: FWORD href: ../assembler/masm/fword.md - name: GOTO @@ -315,8 +321,14 @@ items: href: ../assembler/masm/oword.md - name: PAGE href: ../assembler/masm/page.md + - name: .POP2REG + href: ../assembler/masm/dot-pop2reg.md - name: POPCONTEXT href: ../assembler/masm/popcontext.md + - name: .POPREG + href: ../assembler/masm/dot-popreg.md + - name: .POPFRAME + href: ../assembler/masm/dot-popframe.md - name: PROC href: ../assembler/masm/proc.md - name: PROTO @@ -325,6 +337,8 @@ items: href: ../assembler/masm/public-masm.md - name: PURGE href: ../assembler/masm/purge.md + - name: .PUSH2REG + href: ../assembler/masm/dot-push2reg.md - name: PUSHCONTEXT href: ../assembler/masm/pushcontext.md - name: .PUSHFRAME @@ -349,6 +363,10 @@ items: href: ../assembler/masm/repeat.md - name: REPT href: ../assembler/masm/rept.md + - name: .RESTOREREG + href: ../assembler/masm/dot-restorereg.md + - name: .RESTOREXMM128 + href: ../assembler/masm/dot-restorexmm128.md - name: .SAFESEH href: ../assembler/masm/dot-safeseh.md - name: .SALL @@ -401,6 +419,8 @@ items: href: ../assembler/masm/typedef-masm.md - name: UNION href: ../assembler/masm/union.md + - name: .UNSETFRAME + href: ../assembler/masm/dot-unsetframe.md - name: .UNTIL href: ../assembler/masm/dot-until.md - name: .UNTILCXZ @@ -479,6 +499,8 @@ items: href: ../assembler/masm/at-substr.md - name: "@Time" href: ../assembler/masm/at-time.md + - name: "@UnwindVersion" + href: ../assembler/masm/at-unwindversion.md - name: "@Version" href: ../assembler/masm/at-version.md - name: "@WordSize" From f2cbfff884902039d074ed50dd7296f69a1e7dd2 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 11 May 2026 22:05:51 -0700 Subject: [PATCH 1764/1799] Spgo (#6711) Address PR feedback. Needs to publish in the morning. --- docs/build/profile-guided-optimizations.md | 6 +++--- docs/build/sample-profile-guided-optimization.md | 15 ++++++++++----- docs/build/toc.yml | 8 ++++++++ 3 files changed, 21 insertions(+), 8 deletions(-) diff --git a/docs/build/profile-guided-optimizations.md b/docs/build/profile-guided-optimizations.md index b953ba33dd7..d171360f143 100644 --- a/docs/build/profile-guided-optimizations.md +++ b/docs/build/profile-guided-optimizations.md @@ -1,7 +1,7 @@ --- description: "Learn more about: Profile-guided optimizations" title: "Profile-guided optimizations" -ms.date: "04/23/2019" +ms.date: 05/11/2026 helpviewer_keywords: ["profile-guided optimizations", "optimization, profile-guided [C++]"] --- # Profile-guided optimizations @@ -30,7 +30,7 @@ To use profile-guided optimization, follow these steps to optimize your app: - Profile the application. - Each time a profiled EXE session ends, or a profiled DLL unloads, the process creates a `appname!N.pgc` file. A `.pgc` file contains information about a particular application test run. *appname* is the name of your app, and *N* is a number starting with 1. It increments based on the number of other `appname!N.pgc` files in the directory. You can delete a `.pgc` file if the test run doesn't represent a scenario you want to optimize. + Each time a profiled EXE session ends, or a profiled DLL unloads, the process creates an `appname!N.pgc` file. A `.pgc` file contains information about a particular application test run. *appname* is the name of your app, and *N* is a number starting with 1. It increments based on the number of other `appname!N.pgc` files in the directory. You can delete a `.pgc` file if the test run doesn't represent a scenario you want to optimize. During a test run, you can force closure of the currently open `.pgc` file and the creation of a new `.pgc` file by using the [pgosweep](pgosweep.md) utility (for example, when the end of a test scenario doesn't coincide with application shutdown). @@ -75,7 +75,7 @@ Profile-guided optimizations include these checks and improvements: To learn more about these environment variables, functions, and tools you can use in profile-guided optimizations, see the following resources: -[Environment variables for profile-guided optimizations](environment-variables-for-profile-guided-optimizations.md) +[Environment variables for profile-guided optimizations](environment-variables-for-profile-guided-optimizations.md)\ These variables specify the run-time behavior of testing scenarios. They're now deprecated and replaced by new linker options. This document shows you how to move from the environment variables to the linker options. [PgoAutoSweep](pgoautosweep.md)\ diff --git a/docs/build/sample-profile-guided-optimization.md b/docs/build/sample-profile-guided-optimization.md index 8fcc4c4f3a8..084be1122e3 100644 --- a/docs/build/sample-profile-guided-optimization.md +++ b/docs/build/sample-profile-guided-optimization.md @@ -301,11 +301,13 @@ This message appears on the first `/spgo` build. The linker creates the SPD file | `/link /debug` | Pass `/debug` to the linker to generate debug information (`.pdb`), which xperf uses to map profiling samples to source code. | | `/spgo` | SPGO linker flag—embeds SPGO metadata in the binary and creates an empty `textCount.spd` file alongside the executable. | -> **Note:** `/spgo` is a linker flag. Pass it to the linker via `/link /spgo` in the `cl` command. +> [!NOTE] +> `/spgo` is a linker flag. Pass it to the linker via `/link /spgo` in the `cl` command. The `/spgo` flag doesn't optimize the binary yet. It prepares it for profiling. The optimization happens in [Rebuild textCount with /spdin](#rebuild-textcount-with-spdin) after the SPD is populated with real runtime data. -> **Note:** To write the SPD to a specific location, add the optional `/spd:` linker flag. For example: `/link /debug /spgo /spd:.\profiles\textCount.spd`. If you omit this flag, the SPD is created alongside the `.exe`. +> [!NOTE] +> To write the SPD to a specific location, add the optional `/spd:` linker flag. For example: `/link /debug /spgo /spd:.\profiles\textCount.spd`. If you omit this flag, the SPD is created alongside the `.exe`. ## Choose your profiling method @@ -505,7 +507,9 @@ SPDConvert.exe /mode:IP textCount.spd textCount.spt `/mode:IP` tells `SPDConvert` to interpret the SPT as containing instruction-pointer samples. -> **Warning:** Using the wrong mode for your data type can produce an empty or malformed SPD. If you profiled with LBR, use `/mode:LBR`. If you profiled with PMC or OS timer, use `/mode:IP`. The `SPTAggregate` summary output from [Convert the ETL file to SPT](#convert-the-etl-file-to-spt) shows which sample types were collected and confirms the correct mode to use. +> [!WARNING] +> Using the wrong mode for your data type can produce an empty or malformed SPD. If you profiled with LBR, use `/mode:LBR`. +> If you profiled with PMC or OS timer, use `/mode:IP`. The `SPTAggregate` summary output from [Convert the ETL file to SPT](#convert-the-etl-file-to-spt) shows which sample types were collected and confirms the correct mode to use. After running `SPDConvert`, confirm that `textCount.spd` was created (or updated) in the current directory. @@ -554,7 +558,8 @@ cl /EHsc /GL /O2 textCount.cpp /link /debug /spgo /spdin:textCount.spd The command still includes `/spgo`. It generates a new SPD file alongside the optimized binary, which you can use as the starting point for subsequent profiling iterations. -> **Warning:** The SPD file is associated with the exact binary it profiles against. If you rebuild `textCount` without `/spdin`, or rebuild from changed source, you must generate a new SPD file. The existing one doesn't match the new binary's GUID, and the linker won't use it. +> [!WARNING] +> The SPD file is associated with the exact binary it profiles against. If you rebuild `textCount` without `/spdin`, or rebuild from changed source, you must generate a new SPD file. The existing one doesn't match the new binary's GUID, and the linker won't use it. After the rebuild with `/spdin`, the linker outputs statistics about how much of your code was optimized using profile data. For example: @@ -630,7 +635,7 @@ wpr -start CPU.light -filemode textCount.exe < warAndPeace.txt wpr -stop spgo_data.etl ``` -For more information on using WPR, see [Using Windows Performance Recorder](/windows-hardware/test/wpt/recording-pmu-events) +For more information on using WPR, see [Using Windows Performance Recorder](/windows-hardware/test/wpt/recording-pmu-events). ### SPD distribution diff --git a/docs/build/toc.yml b/docs/build/toc.yml index 345c6fa37fe..d9dcd53f723 100644 --- a/docs/build/toc.yml +++ b/docs/build/toc.yml @@ -1113,6 +1113,14 @@ items: href: ../build/reference/section-specify-section-attributes.md - name: /SOURCELINK (Include Sourcelink file in PDB) href: ../build/reference/sourcelink.md + - name: /SPD + href: ../build/reference/spd-specify-sample-profile-database.md + - name: /SPDEMBED + href: ../build/reference/spdembed-embed-sample-profile-database.md + - name: /SPDIN + href: ../build/reference/spdin-use-sample-profile-database.md + - name: /SPGO + href: ../build/reference/spgo-enable-sample-profile-guided-optimization.md - name: /STACK (Stack allocations) href: ../build/reference/stack-stack-allocations.md - name: /STUB (MS-DOS stub file name) From 914fb42b812623a3822545d0fdad2a7d95d9536d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 12 May 2026 10:29:19 -0700 Subject: [PATCH 1765/1799] update f1 metadata and fix formatting --- docs/build/sptdump.md | 4 ++-- docs/preprocessor/predefined-macros.md | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/build/sptdump.md b/docs/build/sptdump.md index ac885470d62..e7605bdb0ff 100644 --- a/docs/build/sptdump.md +++ b/docs/build/sptdump.md @@ -66,8 +66,8 @@ The SPT header is 32 bytes: - `[0x1C-0x1D]` ProgramIdsUsed (uint16 LE) = number of program IDs (often just 1) - `[0x1E-0x1F]` ProgramIdCapacity (uint16 LE) = capacity in count (not bytes) for program IDs (typically 0x100) -The StringTable immediately follows the header at the specified offset. It contains a null-terminated UTF-8 binary filename. -The ProgramIdTable follows the StringTable at the specified offset. Each entry is 24 bytes: 16-byte Rich Signature Data Stream (RSDS) GUID + 4-byte age + 4-byte string index into StringTable. +The StringTable immediately follows the header at the specified offset. It contains a null-terminated UTF-8 binary filename.\ +The ProgramIdTable follows the StringTable at the specified offset. Each entry is 24 bytes: 16-byte Rich Signature Data Stream (RSDS) GUID + 4-byte age + 4-byte string index into StringTable.\ The data stream starts at `ProgramIdTableOffset + (ProgramIdCapacity * 24)`, and starts with a `SPT_OP_BINARY_ID` opcode. **SPT Opcodes** diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index 40a086752f7..4c1b0170f87 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -2,9 +2,9 @@ title: "Predefined macros" description: "Lists and describes the Microsoft C++ compiler predefined preprocessor macros." ms.custom: "update_every_version" -ms.date: 06/18/2025 -f1_keywords: ["__ARM_ARCH", "_ATL_VER", "__ATOM__", "__AVX__", "__AVX2__", "__AVX512BW__", "__AVX512CD__", "__AVX512DQ__", "__AVX512F__", "__AVX512VL__", "_CHAR_UNSIGNED", "__CLR_VER", "_CONTROL_FLOW_GUARD", "__COUNTER__", "__cplusplus", "__cplusplus_cli", "__cplusplus_winrt", "_CPPRTTI", "_CPPUNWIND", "__DATE__", "_DEBUG", "_DLL", "__FILE__", "__FUNCDNAME__", "__FUNCSIG__", "__FUNCTION__", "_INTEGRAL_MAX_BITS", "_ISO_VOLATILE", "_KERNEL_MODE", "__LINE__", "_M_AMD64", "_M_ARM", "_M_ARM_ARMV7VE", "_M_ARM_FP", "_M_ARM64", "_M_CEE", "_M_CEE_PURE", "_M_CEE_SAFE", "_M_FP_EXCEPT", "_M_FP_FAST", "_M_FP_PRECISE", "_M_FP_STRICT", "_M_IX86", "_M_IX86_FP", "_M_X64", "_MANAGED", "_MFC_VER", "_MSC_BUILD", "_MSC_EXTENSIONS", "_MSC_FULL_VER", "_MSC_VER", "_MSVC_LANG", "__MSVC_RUNTIME_CHECKS", "_MT", "_NATIVE_WCHAR_T_DEFINED", "_NO_SIZED_DEALLOCATION", "_OPENMP", "_PREFAST_", "_RESUMABLE_FUNCTIONS_SUPPORTED", "_RTC_CONVERSION_CHECKS_ENABLED", "__SANITIZE_ADDRESS__", "__STDC__", "__STDC_HOSTED__", "__STDC_NO_ATOMICS__", "__STDC_NO_COMPLEX__", "__STDC_NO_THREADS__", "__STDC_NO_VLA__", "__STDC_VERSION__", "__STDCPP_DEFAULT_NEW_ALIGNMENT__", "__STDCPP_THREADS__", "__TIME__", "__TIMESTAMP__", "__VA_ARGS__", "_VC_NODEFAULTLIB", "_WCHAR_T_DEFINED", "_WIN32", "_WIN64", "_WINRT_DLL"] -helpviewer_keywords: ["__ARM_ARCH macro", "timestamps, preprocessor macro", "cl.exe compiler, version number", "version numbers, C/C++ compiler (cl.exe)", "macros, predefined C++", "preprocessor, macros", "predefined macros", "_ATL_VER macro", "__ATOM__ macro", "__AVX__ macro", "__AVX2__ macro", "__AVX512BW__ macro", "__AVX512CD__ macro", "__AVX512DQ__ macro", "__AVX512F__ macro", "__AVX512VL__ macro", "_CHAR_UNSIGNED macro", "__CLR_VER macro", "_CONTROL_FLOW_GUARD macro", "__COUNTER__ macro", "__cplusplus macro", "__cplusplus_cli macro", "__cplusplus_winrt macro", "_CPPRTTI macro", "_CPPUNWIND macro", "__DATE__ macro", "_DEBUG macro", "_DLL macro", "__FILE__ macro", "__FUNCDNAME__ macro", "__FUNCSIG__ macro", "__FUNCTION__ macro", "_INTEGRAL_MAX_BITS macro", "_ISO_VOLATILE macro", "_KERNEL_MODE macro", "__LINE__ macro", "_M_AMD64 macro", "_M_ARM macro", "_M_ARM_ARMV7VE macro", "_M_ARM_FP macro", "_M_ARM64 macro", "_M_ARM64EC macro", "_M_CEE macro", "_M_CEE_PURE macro", "_M_CEE_SAFE macro", "_M_FP_EXCEPT macro", "_M_FP_FAST macro", "_M_FP_PRECISE macro", "_M_FP_STRICT macro", "_M_IX86 macro", "_M_IX86_FP macro", "_M_X64 macro", "_MANAGED macro", "_MFC_VER macro", "_MSC_BUILD macro", "_MSC_EXTENSIONS macro", "_MSC_FULL_VER macro", "_MSC_VER macro", "_MSVC_LANG macro", "__MSVC_RUNTIME_CHECKS macro", "_MT macro", "_NATIVE_WCHAR_T_DEFINED macro", "_NO_SIZED_DEALLOCATION macro", "_OPENMP macro", "_PREFAST_ macro", "_RESUMABLE_FUNCTIONS_SUPPORTED macro", "_RTC_CONVERSION_CHECKS_ENABLED macro", "__SANITIZE_ADDRESS__ macro", "__STDC__ macro", "__STDC_HOSTED__ macro", "__STDC_NO_ATOMICS__ macro", "__STDC_NO_COMPLEX__ macro", "__STDC_NO_THREADS__ macro", "__STDC_NO_VLA__ macro", "__STDC_VERSION__ macro", "__STDCPP_DEFAULT_NEW_ALIGNMENT__", "__STDCPP_THREADS__ macro", "__TIME__ macro", "__TIMESTAMP__ macro", "__VA_ARGS__ macro", "_VC_NODEFAULTLIB macro", "_WCHAR_T_DEFINED macro", "_WIN32 macro", "_WIN64 macro", "_WINRT_DLL macro", "__func__ identifier"] +ms.date: 05/12/2026 +f1_keywords: ["__APX_F__", "__ARM_ARCH", "_ATL_VER", "__ATOM__", "__AVX__", "__AVX2__", "__AVX512BW__", "__AVX512CD__", "__AVX512DQ__", "__AVX512F__", "__AVX512VL__", "__CCMP__", "__CF__", "_CHAR_UNSIGNED", "__CLR_VER", "_CONTROL_FLOW_GUARD", "__COUNTER__", "__cplusplus", "__cplusplus_cli", "__cplusplus_winrt", "_CPPRTTI", "_CPPUNWIND", "__DATE__", "_DEBUG", "_DLL", "__EGPR__", "__FILE__", "__FUNCDNAME__", "__FUNCSIG__", "__FUNCTION__", "_INTEGRAL_MAX_BITS", "_ISO_VOLATILE", "_KERNEL_MODE", "__LINE__", "_M_AMD64", "_M_ARM", "_M_ARM_ARMV7VE", "_M_ARM_FP", "_M_ARM64", "_M_CEE", "_M_CEE_PURE", "_M_CEE_SAFE", "_M_FP_EXCEPT", "_M_FP_FAST", "_M_FP_PRECISE", "_M_FP_STRICT", "_M_IX86", "_M_IX86_FP", "_M_X64", "_MANAGED", "_MFC_VER", "_MSC_BUILD", "_MSC_EXTENSIONS", "_MSC_FULL_VER", "_MSC_VER", "_MSVC_LANG", "__MSVC_RUNTIME_CHECKS", "_MT", "_NATIVE_WCHAR_T_DEFINED", "__NDD__", "__NF__", "_NO_SIZED_DEALLOCATION", "_OPENMP", "__PPX__", "_PREFAST_", "__PUSH2POP2__", "_RESUMABLE_FUNCTIONS_SUPPORTED", "_RTC_CONVERSION_CHECKS_ENABLED", "__SANITIZE_ADDRESS__", "__STDC__", "__STDC_HOSTED__", "__STDC_NO_ATOMICS__", "__STDC_NO_COMPLEX__", "__STDC_NO_THREADS__", "__STDC_NO_VLA__", "__STDC_VERSION__", "__STDCPP_DEFAULT_NEW_ALIGNMENT__", "__STDCPP_THREADS__", "__TIME__", "__TIMESTAMP__", "__VA_ARGS__", "_VC_NODEFAULTLIB", "_WCHAR_T_DEFINED", "_WIN32", "_WIN64", "_WINRT_DLL", "__ZU__"] +helpviewer_keywords: ["__APX_F__ macro", "__ARM_ARCH macro", "_ATL_VER macro", "__ATOM__ macro", "__AVX__ macro", "__AVX2__ macro", "__AVX512BW__ macro", "__AVX512CD__ macro", "__AVX512DQ__ macro", "__AVX512F__ macro", "__AVX512VL__ macro", "__CCMP__ macro", "__CF__ macro", "_CHAR_UNSIGNED macro", "cl.exe compiler, version number", "__CLR_VER macro", "_CONTROL_FLOW_GUARD macro", "__COUNTER__ macro", "__cplusplus macro", "__cplusplus_cli macro", "__cplusplus_winrt macro", "_CPPRTTI macro", "_CPPUNWIND macro", "__DATE__ macro", "_DEBUG macro", "_DLL macro", "__EGPR__ macro", "__FILE__ macro", "__func__ identifier", "__FUNCDNAME__ macro", "__FUNCSIG__ macro", "__FUNCTION__ macro", "_INTEGRAL_MAX_BITS macro", "_ISO_VOLATILE macro", "_KERNEL_MODE macro", "__LINE__ macro", "_M_AMD64 macro", "_M_ARM macro", "_M_ARM_ARMV7VE macro", "_M_ARM_FP macro", "_M_ARM64 macro", "_M_ARM64EC macro", "_M_CEE macro", "_M_CEE_PURE macro", "_M_CEE_SAFE macro", "_M_FP_EXCEPT macro", "_M_FP_FAST macro", "_M_FP_PRECISE macro", "_M_FP_STRICT macro", "_M_IX86 macro", "_M_IX86_FP macro", "_M_X64 macro", "macros, predefined C++", "_MANAGED macro", "_MFC_VER macro", "_MSC_BUILD macro", "_MSC_EXTENSIONS macro", "_MSC_FULL_VER macro", "_MSC_VER macro", "_MSVC_LANG macro", "__MSVC_RUNTIME_CHECKS macro", "_MT macro", "_NATIVE_WCHAR_T_DEFINED macro", "__NDD__ macro", "__NF__ macro", "_NO_SIZED_DEALLOCATION macro", "_OPENMP macro", "__PPX__ macro", "predefined macros", "_PREFAST_ macro", "preprocessor, macros", "__PUSH2POP2__ macro", "_RESUMABLE_FUNCTIONS_SUPPORTED macro", "_RTC_CONVERSION_CHECKS_ENABLED macro", "__SANITIZE_ADDRESS__ macro", "__STDC__ macro", "__STDC_HOSTED__ macro", "__STDC_NO_ATOMICS__ macro", "__STDC_NO_COMPLEX__ macro", "__STDC_NO_THREADS__ macro", "__STDC_NO_VLA__ macro", "__STDC_VERSION__ macro", "__STDCPP_DEFAULT_NEW_ALIGNMENT__", "__STDCPP_THREADS__ macro", "__TIME__ macro", "__TIMESTAMP__ macro", "timestamps, preprocessor macro", "__VA_ARGS__ macro", "_VC_NODEFAULTLIB macro", "version numbers, C/C++ compiler (cl.exe)", "_WCHAR_T_DEFINED macro", "_WIN32 macro", "_WIN64 macro", "_WINRT_DLL macro", "__ZU__ macro"] ms.assetid: 1cc5f70a-a225-469c-aed0-fe766238e23f no-loc: [_ATL_VER, __ATOM__, __AVX__, __AVX2__, __AVX512BW__, __AVX512CD__, __AVX512DQ__, __AVX512F__, __AVX512VL__, _CHAR_UNSIGNED, __CLR_VER, _CONTROL_FLOW_GUARD, __COUNTER__, __cplusplus, __cplusplus_cli, __cplusplus_winrt, _CPPRTTI, _CPPUNWIND, __DATE__, _DEBUG, _DLL, __FILE__, __FUNCDNAME__, __FUNCSIG__, __FUNCTION__, _INTEGRAL_MAX_BITS, _ISO_VOLATILE, _KERNEL_MODE, __LINE__, _M_AMD64, _M_ARM, _M_ARM_ARMV7VE, _M_ARM_FP, _M_ARM64, _M_ARM64EC, _M_CEE, _M_CEE_PURE, _M_CEE_SAFE, _M_FP_EXCEPT, _M_FP_FAST, _M_FP_PRECISE, _M_FP_STRICT, _M_IX86, _M_IX86_FP, _M_X64, _MANAGED, _MFC_VER, _MSC_BUILD, _MSC_EXTENSIONS, _MSC_FULL_VER, _MSC_VER, _MSVC_LANG, __MSVC_RUNTIME_CHECKS, _MT, _NATIVE_WCHAR_T_DEFINED, _NO_SIZED_DEALLOCATION, _OPENMP, _PREFAST_, _RESUMABLE_FUNCTIONS_SUPPORTED, _RTC_CONVERSION_CHECKS_ENABLED, __SANITIZE_ADDRESS__, __STDC__, __STDC_HOSTED__, __STDC_NO_ATOMICS__, __STDC_NO_COMPLEX__, __STDC_NO_THREADS__, __STDC_NO_VLA__, __STDC_VERSION__, __STDCPP_DEFAULT_NEW_ALIGNMENT__, __STDCPP_THREADS__, __TIME__, __TIMESTAMP__, __VA_ARGS__, _VC_NODEFAULTLIB, _WCHAR_T_DEFINED, _WIN32, _WIN64, _WINRT_DLL, __func__] --- From b57362821ac18f7580a4e7067eb4b7d15cc10e62 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 12 May 2026 10:35:17 -0700 Subject: [PATCH 1766/1799] tech review --- docs/overview/what-s-new-for-msvc.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 3f9c4f0e595..41aa00b0d56 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,7 +1,7 @@ --- title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 05/11/2026 +ms.date: 05/12/2026 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new @@ -25,7 +25,6 @@ MSVC Build Tools version 14.51 preserves binary compatibility with code built wi |---|---| | What's new for C++ developers | [MSVC Build Tools version 14.51 Release Candidate Now Available](https://devblogs.microsoft.com/cppblog/msvc-build-tools-version-14-51-release-candidate-now-available/) | | Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.51](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1451) | -| C++23 language updates | [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51) | | C++ language conformance improvements | [C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools](msvc-conformance-improvements.md) | Here's a quick highlight of some of the new features in MSVC Build Tools version 14.51: From 9e1001b22572dab470dcc5b9f5ae804444b29479 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 12 May 2026 10:46:16 -0700 Subject: [PATCH 1767/1799] acrolinx --- docs/overview/msvc-conformance-improvements.md | 10 +++++----- docs/overview/what-s-new-for-msvc.md | 8 +++++--- docs/porting/features-deprecated-in-visual-studio.md | 10 +++++----- 3 files changed, 15 insertions(+), 13 deletions(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 039b3325444..71c66d185d9 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -1,13 +1,13 @@ --- title: "/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools" description: "Summary of conformance improvements in Microsoft C/C++ (MSVC)" -ms.date: 05/08/2026 +ms.date: 05/12/2026 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- # C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools -Microsoft C++ (MSVC) Build Tools makes conformance improvements and bug fixes in every release. Starting with Visual Studio 2026 version 18.0, major improvements are organized by MSVC Build Tools version number. To jump directly to the changes for a specific version, use the **In this article** links at the top of this article. +We make conformance improvements and bug fixes in every release of Microsoft C++ (MSVC) Build Tools. Starting with Visual Studio 2026 version 18.0, we organize major improvements by MSVC Build Tools version number. Use the **In this article** links at the top of this article to jump directly to the changes for a specific version. For changes in earlier versions of Visual Studio: @@ -31,7 +31,7 @@ Key highlights of this release include: - Improved `consteval` function handling with default-enabled experimental features - New standard library headers `` and `` -For more information about library features and additional updates, see [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51) and [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog). +For more information about library features and other updates, see [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51) and [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog). ### P2647R1: Static constexpr variables in constexpr functions @@ -49,7 +49,7 @@ This feature improves both compile-time evaluation and run-time optimization. Pr ### Other C++23 features -Other C++23 features implemented in this release include Unicode support improvements, labels at the end of compound statements for C compatibility, Class Template Argument Deduction (CTAD) from inherited constructors, and meaningful exports for modules. For more details and related Core Working Group (CWG) issue resolutions, see the [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51). +Other C++23 features implemented in this release include Unicode support improvements, labels at the end of compound statements for C compatibility, Class Template Argument Deduction (CTAD) from inherited constructors, and meaningful exports for modules. For more information and related Core Working Group (CWG) issue resolutions, see the [C++23 Support in MSVC Build Tools 14.51](https://devblogs.microsoft.com/cppblog/c23-support-in-msvc-build-tools-14-51). ### Standard Library @@ -62,7 +62,7 @@ For the complete list, see the [STL Changelog](https://github.com/microsoft/STL/ ## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.50 -MSVC Build Tools v14.50 introduces improvements to the MSVC compiler and standard library, including better C++23 standards conformance, enhanced reliability, and improved correctness. This release also includes numerous bug fixes and updates that benefit large-scale C++ development. +MSVC Build Tools v14.50 introduces improvements to the MSVC compiler and standard library including better C++23 standards conformance, enhanced reliability, and improved correctness. This release also includes numerous bug fixes and updates that benefit large-scale C++ development. This version shipped first with Visual Studio 2026 version 18.0 and includes version 19.50 of the MSVC compiler. diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 41aa00b0d56..a9e342a61dd 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -111,7 +111,7 @@ Here's a quick highlight of some of the new features in MSVC Build Tools version - Copilot Chat allows you to use natural language to get answers to questions (Ask mode) or even implement changes for you automatically (Agent Mode). - Copilot Chat is smarter with improved context for everyday tasks. Expect better results when searching your codebase and referencing specific lines in your code. - A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments, generate unit tests, and more. -- Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. GitHub Copilot includes other relevant files as context which reduces hallucinations while offering more relevant and accurate suggestions. +- Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. GitHub Copilot includes other relevant files as context, which reduces hallucinations while offering more relevant and accurate suggestions. - For more information, see [New GitHub Copilot capabilities for C++ developers: Upgrade MSVC, improve build performance, and refactor C++ code](https://devblogs.microsoft.com/cppblog/new-github-copilot-capabilities-for-c-developers-upgrade-msvc-improve-build-performance-and-refactor-c-code/). ### Build enhancements @@ -129,7 +129,7 @@ Here's a quick highlight of some of the new features in MSVC Build Tools version - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png) -- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with [AddressSanitizer](/cpp/sanitizers/asan), which allows you to identify hard-to-find memory safety issues with zero false positives at runtime and increase memory safety. Now you can use AddressSanitizer to target ARM64. This feature is in preview. +- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools supported building projects that target x64 and x86 with [AddressSanitizer](/cpp/sanitizers/asan), which allows you to identify hard-to-find memory safety issues with zero false positives at runtime and increase memory safety. Now you can use AddressSanitizer to target ARM64. This feature is in preview. ### Productivity enhancements @@ -167,4 +167,6 @@ We'd love to hear from you! You can [Report a Problem or Suggest a Feature](/vis ## Blogs -Take advantage of the insights and recommendations available in the [Microsoft Developer Blogs](https://devblogs.microsoft.com/) site to stay up to date on all new releases. The blogs include deep dive posts on a broad range of features. The [C++ Team Blog](https://devblogs.microsoft.com/cppblog) and the [Visual Studio Blog](https://devblogs.microsoft.com/visualstudio) are of particular interest. +Stay up to date on all new releases by taking advantage of the insights and recommendations available in at [Microsoft Developer Blogs](https://devblogs.microsoft.com/). The blogs include deep dive posts on a broad range of features. + +The [C++ Team Blog](https://devblogs.microsoft.com/cppblog) and the [Visual Studio Blog](https://devblogs.microsoft.com/visualstudio) are of particular interest. diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index 82c81a98e8a..98421c0f4e3 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -6,7 +6,7 @@ helpviewer_keywords: ["Features deprecated or removed from Visual Studio"] --- # C++ features deprecated or removed from Visual Studio -This article is a non-exhaustive list of C++ features deprecated or removed from Visual Studio 2019 and later. For information on breaking changes and conformance improvements for C++ in the latest version of Visual Studio, see [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md). +This article is a nonexhaustive list of C++ features deprecated or removed from Visual Studio 2019 and later. For information on breaking changes and conformance improvements for C++ in the latest version of Visual Studio, see [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md). ### Support for Windows XP development @@ -18,7 +18,7 @@ Visual Studio 2019 and later versions don't include current build tools support - ### Removed features -The following long-deprecated non-Standard features have been removed: +The following long-deprecated non-Standard features are removed: - **TR1** including the `std::tr1` namespace, old `array::assign()`, and old `` engines and distributions. Deprecated since VS 2017 15.5 (December 2017). - **`_ALLOW_RTCc_IN_STL`** macro removed. The Standard Template Library doesn't support the `/RTCc` compiler option, but `/RTCs` and `/RTCu`/`/RTC1` remain supported. @@ -32,13 +32,13 @@ The following long-deprecated non-Standard features have been removed: ### Support for project upgrade from Visual C++ 6 -Visual Studio 2022 and later versions don't support upgrades from Visual C++ 6 Workspace (*`.dsw`*) and Project (*`.dsp`*) files. Visual Studio no longer registers the *`.dsw`* and *`.dsp`* file extensions as Visual Studio file types. To upgrade a project with these extensions, first use Visual Studio 2019 to upgrade the project to modern Solution (*`.sln`*) and C++ Project (*`.vcxproj`*) files. Then use the current version of Visual Studio to upgrade the project again. +Visual Studio 2022 and later versions don't support upgrades from Visual C++ 6 Workspace (*`.dsw`*) and Project (*`.dsp`*) files. Visual Studio no longer registers the *`.dsw`* and *`.dsp`* file extensions as Visual Studio file types. To upgrade a project with these extensions, first use Visual Studio 2019 to upgrade the project to modern Solution (*`.sln`*) and C++ Project (*`.vcxproj`*) files. Then upgrade the project again using the current version of Visual Studio. ## Visual Studio 2026 -### Support for C++AMP, ARM32 toolchain, and /DEBUG:FASTLINK +### Support for C++AMP, ARM32 toolchain, and `/DEBUG:FASTLINK` -Visual Studio 2026 and later versions don't support C++AMP, the ARM32 toolchain, and /DEBUG:FASTLINK. If you're utilizing `/DEBUG:FASTLINK`, it's recommended to switch to [`/DEBUG:FULL`](/cpp/build/reference/debug-generate-debug-info) for improved debugging support. Developers needing to target ARM32 can continue using the Visual Studio 2022 v143 build tools as detailed in this [Microsoft blog post](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). +Visual Studio 2026 and later versions don't support C++AMP, the ARM32 toolchain, and /DEBUG:FASTLINK. If you're utilizing `/DEBUG:FASTLINK`, switch to [`/DEBUG:FULL`](/cpp/build/reference/debug-generate-debug-info) for improved debugging support. Developers needing to target ARM32 can continue using the Visual Studio 2022 v143 build tools as detailed in this [Microsoft blog post](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). ### Deprecation of `/await` From 976257896db563821ff27ca48417d4310bec7608 Mon Sep 17 00:00:00 2001 From: James Barnett Date: Tue, 12 May 2026 12:01:21 -0700 Subject: [PATCH 1768/1799] Update features-deprecated-in-visual-studio.md --- docs/porting/features-deprecated-in-visual-studio.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index 98421c0f4e3..21848bb9152 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -16,7 +16,7 @@ Visual Studio 2019 and later versions don't include current build tools support - The following experimental coroutine headers are now deprecated: ``, ``, and ``. Transition to standard C++20 coroutines using the `` header. -- ### Removed features +### Removed features The following long-deprecated non-Standard features are removed: @@ -58,4 +58,4 @@ These changes allow for better performance, enhanced security, and alignment wit ### Support for Mobile development with C++ and Embedded and IoT tools -Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. \ No newline at end of file +Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. From d9f17bd13d00207eef8a698bfec8abd061828153 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 12 May 2026 12:18:07 -0700 Subject: [PATCH 1769/1799] update per VS/MSVC on separate tracks (#6705) * update per VS/MSVC on separate tracks * remove locale * more link fixing * update * moved the history down and more relevant info up * tech review * wordsmithing * Apply suggestion from @AugP Co-authored-by: Augustin Popa * Apply suggestion from @AugP Co-authored-by: Augustin Popa * incorp feedback --------- Co-authored-by: Augustin Popa --- docs/overview/compiler-versions.md | 191 ++++++++++++++++++----------- 1 file changed, 121 insertions(+), 70 deletions(-) diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index f1502c60088..21b903f2128 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -1,7 +1,7 @@ --- description: "Learn more about Microsoft C++ compiler versioning." title: "Microsoft C++ (MSVC) compiler versioning" -ms.date: 02/12/2025 +ms.date: 05/08/2026 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] @@ -35,36 +35,29 @@ The macros reflect these values like this: >[!Note] >Visual Studio 2019 versions 16.8 and 16.9 share the same major and minor versions, and so have the same value for `_MSC_VER`. As do Visual Studio 2019 versions 16.10 and 16.11. To distinguish them, use `_MSC_FULL_VER` as described in [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017). -## A brief history of Microsoft C++ compiler versioning - -### Visual Studio 6.0 through Visual Studio 2015 (14.0) +## Visual Studio channels -- For major releases, `_MSC_VER` increases by 100. `_MSC_FULL_VER` increases by 10,000,000. -- For minor releases, `_MSC_VER` increases by 10. `_MSC_FULL_VER` increases by 1,000,000. - - >[!Note] - > Visual Studio .NET 2003 was considered a minor release. - -### Visual Studio 2017 to Visual Studio 2022 - -- For major releases, the minor version increases by 10. -- For minor releases, the minor version increases by 1 starting with Visual Studio 2017 version 15.3. +All MSVC Build Tools are available through the Visual Studio Installer. -### Visual Studio 2026 and later +The [Visual Studio Stable Channel](https://visualstudio.microsoft.com) gets monthly updates and includes the latest supported MSVC Build Tools. The [Visual Studio Insiders Channel](https://visualstudio.microsoft.com/insiders) updates more often, so you can try upcoming MSVC changes sooner. For more information about the release cadence, see [Visual Studio 2026 release rhythm](/visualstudio/releases/2026/release-rhythm) and [Visual Studio Insiders release notes](/visualstudio/releases/2026/release-notes-insiders). -- The compiler minor version is no longer incremented in relation to Visual Studio version updates. -- The minor version increments by 1 with each new MSVC release. -- Not every new Visual Studio version will ship a new MSVC compiler version. +Each Visual Studio update receives updates to all of the MSVC build toolsets: +- The **preview** toolset receives new features and fixes that the development team completed since the previous update. +- The **default** and **older in-support** toolsets receive only targeted bug fixes. -### Service releases starting with Visual Studio 2017 -Servicing releases are distinguished by `_MSC_FULL_VER`. The build field (the BBBBB in the MMNNBBBBB version number) typically increases by 1. +Visual Studio Insiders users get early access to MSVC releases: +- On the Insiders Channel, preview toolsets update approximately weekly. +- On the Insiders Channel, new toolsets are available as release candidates about a month before they reach the Stable Channel, giving Insiders users time to validate the toolset and report issues. -For example, two cases where `_MSC_FULL_VER` is useful is to distinguish Visual Studio 2019 version 16.8 from 16.9, and Visual Studio 2019 version 16.10 from 16.11. That's because those versions share the same major and minor versions, and so have the same value for `_MSC_VER`. +### Install specific MSVC toolsets -To distinguish these versions, use `_MSC_FULL_VER`.\ -The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.8 is 192829333.\ -The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.9 is 192829910. +- To install only the default MSVC toolset, install the `Desktop development with C++` workload. +- To install the preview toolset, run the Visual Studio Installer and select **MSVC Build Tools for <arch> (Preview)**. For more information, see [MSVC Build Tools Preview](https://aka.ms/msvc/preview). +- To install an older in-support 14.5x toolset, run the Visual Studio Installer, open the **Individual Components** tab, and select the specific 14.5x toolset. +- To restore a previously installed toolset after an upgrade—for example, when 14.50 is replaced by 14.51—add the older toolset back from the **Individual Components** tab. +- To install only the Build Tools without the full Visual Studio IDE, use the [Visual Studio Stable Build Tools SKU](https://aka.ms/vs/stable/vs_BuildTools.exe). +- Some out-of-support toolsets (labeled **(Out of support)**) may also be available in the Visual Studio Installer. These toolsets don't receive any updates and may be removed in the future. We strongly recommend moving to a supported version. ## Version macros @@ -79,62 +72,120 @@ R - revision version **[`_MSC_FULL_VER`](../preprocessor/predefined-macros.md)** represents the major, minor, and build version of the compiler. It has the form: MMNNBBBBB. Use it to distinguish between different versions of the compiler, including servicing releases. For more information about Visual Studio 2019 versions 16.8, 16.9, 16.10 and 16.11, see [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017). -**[`_MSC_BUILD`](../preprocessor/predefined-macros.md)** represents the build version of the compiler. It has the form: R. Use it to distinguish between servicing releases. +**[`_MSC_BUILD`](../preprocessor/predefined-macros.md)** represents the revision version of the compiler. It has the form: R. Use it to distinguish between compiler revisions. When the major version changed between Visual Studio 2013 and Visual Studio 2015, `_MSC_VER` reflected the change by going from 1800 to 1900. An example of a minor change is from Visual Studio 2022 version 17.1 to Visual Studio 2022 version 17.2. In that case, `_MSC_VER` changed from 1931 to 1932. -The following table lists the Visual Studio version corresponding to each Microsoft C++ compiler (`_MSC_VER`) and MSVC Build Tools release: - -| Visual Studio version | `_MSC_VER` | MSVC Build Tools version | -|--|--|--| -| Visual Studio 6.0 | 1200 | 6.0 | -| Visual Studio .NET 2002 (7.0) | 1300 | 7.0 | -| Visual Studio .NET 2003 (7.1) | 1310 | 7.1 | -| Visual Studio 2005 (8.0) | 1400 | 8.0 | -| Visual Studio 2008 (9.0) | 1500 | 9.0 | -| Visual Studio 2010 (10.0) | 1600 | 10.0 | -| Visual Studio 2012 (11.0) | 1700 | 11.0 | -| Visual Studio 2013 (12.0) | 1800 | 12.0 | -| Visual Studio 2015 (14.0) | 1900 | 14.0 | -| Visual Studio 2017 RTW (15.0) | 1910 | 14.10 | -| Visual Studio 2017 version 15.3 | 1911 | 14.11 | -| Visual Studio 2017 version 15.5 | 1912 | 14.12 | -| Visual Studio 2017 version 15.6 | 1913 | 14.13 | -| Visual Studio 2017 version 15.7 | 1914 | 14.14 | -| Visual Studio 2017 version 15.8 | 1915 | 14.15 | -| Visual Studio 2017 version 15.9 | 1916 | 14.16 | -| Visual Studio 2019 RTW 16.0 | 1920 | 14.20 | -| Visual Studio 2019 version 16.1 | 1921 | 14.21 | -| Visual Studio 2019 version 16.2 | 1922 | 14.22 | -| Visual Studio 2019 version 16.3 | 1923 | 14.23 | -| Visual Studio 2019 version 16.4 | 1924 | 14.24 | -| Visual Studio 2019 version 16.5 | 1925 | 14.25 | -| Visual Studio 2019 version 16.6 | 1926 | 14.26 | -| Visual Studio 2019 version 16.7 | 1927 | 14.27 | -| Visual Studio 2019 version 16.8, 16.9 a | 1928 | 14.28 | -| Visual Studio 2019 version 16.10, 16.11 b | 1929 | 14.29 | -| Visual Studio 2022 RTW 17.0 | 1930 | 14.30 | -| Visual Studio 2022 version 17.1 | 1931 | 14.31 | -| Visual Studio 2022 version 17.2 | 1932 | 14.32 | -| Visual Studio 2022 version 17.3 | 1933 | 14.33 | -| Visual Studio 2022 version 17.4 | 1934 | 14.34 | -| Visual Studio 2022 version 17.5 | 1935 | 14.35 | -| Visual Studio 2022 version 17.6 | 1936 | 14.36 | -| Visual Studio 2022 version 17.7 | 1937 | 14.37 | -| Visual Studio 2022 version 17.8 | 1938 | 14.38 | -| Visual Studio 2022 version 17.9 | 1939 | 14.39 | -| Visual Studio 2022 version 17.10 | 1940 | 14.40 | -| Visual Studio 2022 version 17.11 | 1941 | 14.41 | -| Visual Studio 2022 version 17.12 | 1942 | 14.42 | -| Visual Studio 2022 version 17.13 | 1943 | 14.43 | -| Visual Studio 2022 version 17.14 | 1944 | 14.44 | +The following table lists the Visual Studio version that corresponds to each MSVC compiler (`_MSC_VER`) and MSVC Build Tools release, together with support status. EOL means end of life. + +| Visual Studio version | `_MSC_VER` | MSVC Build Tools version | Support | More info | +|--|--|--|--|--| +| Visual Studio 6.0 | 1200 | 6.0 | EOL | [Visual Studio lifecycle policy](/visualstudio/releases/2026/servicing-vs#support-for-older-versions) | +| Visual Studio .NET 2002 (7.0) | 1300 | 7.0 | EOL | [Visual Studio lifecycle policy](/visualstudio/releases/2026/servicing-vs#support-for-older-versions) | +| Visual Studio .NET 2003 (7.1) | 1310 | 7.1 | EOL | [Visual Studio lifecycle policy](/visualstudio/releases/2026/servicing-vs#support-for-older-versions) | +| Visual Studio 2005 (8.0) | 1400 | 8.0 | EOL | [Visual Studio lifecycle policy](/visualstudio/releases/2026/servicing-vs#support-for-older-versions) | +| Visual Studio 2008 (9.0) | 1500 | 9.0 | EOL | [Visual Studio lifecycle policy](/visualstudio/releases/2026/servicing-vs#support-for-older-versions) | +| Visual Studio 2010 (10.0) | 1600 | 10.0 | EOL | [Visual Studio lifecycle policy](/visualstudio/releases/2026/servicing-vs#support-for-older-versions) | +| Visual Studio 2012 (11.0) | 1700 | 11.0 | EOL | [Visual Studio lifecycle policy](/visualstudio/releases/2026/servicing-vs#support-for-older-versions) | +| Visual Studio 2013 (12.0) | 1800 | 12.0 | EOL | [Visual Studio lifecycle policy](/visualstudio/releases/2026/servicing-vs#support-for-older-versions) | +| Visual Studio 2015 (14.0) | 1900 | 14.0 | EOL | [Visual Studio lifecycle policy](/visualstudio/releases/2026/servicing-vs#support-for-older-versions) | +| Visual Studio 2017 RTW (15.0) | 1910 | 14.10 | EOL | [Visual Studio 2017 lifecycle](/lifecycle/products/visual-studio-2017) | +| Visual Studio 2017 version 15.3 | 1911 | 14.11 | EOL | [Visual Studio 2017 lifecycle](/lifecycle/products/visual-studio-2017) | +| Visual Studio 2017 version 15.5 | 1912 | 14.12 | EOL | [Visual Studio 2017 lifecycle](/lifecycle/products/visual-studio-2017) | +| Visual Studio 2017 version 15.6 | 1913 | 14.13 | EOL | [Visual Studio 2017 lifecycle](/lifecycle/products/visual-studio-2017) | +| Visual Studio 2017 version 15.7 | 1914 | 14.14 | EOL | [Visual Studio 2017 lifecycle](/lifecycle/products/visual-studio-2017) | +| Visual Studio 2017 version 15.8 | 1915 | 14.15 | EOL | [Visual Studio 2017 lifecycle](/lifecycle/products/visual-studio-2017) | +| Visual Studio 2017 version 15.9 | 1916 | 14.16 | Apr 13, 2027 | [Visual Studio 2017 lifecycle](/lifecycle/products/visual-studio-2017) | +| Visual Studio 2019 RTW (16.0) | 1920 | 14.20 | EOL | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2019 version 16.1 | 1921 | 14.21 | EOL | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2019 version 16.2 | 1922 | 14.22 | EOL | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2019 version 16.3 | 1923 | 14.23 | EOL | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2019 version 16.4 | 1924 | 14.24 | EOL | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2019 version 16.5 | 1925 | 14.25 | EOL | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2019 version 16.6 | 1926 | 14.26 | EOL | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2019 version 16.7 | 1927 | 14.27 | EOL | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2019 version 16.8, 16.9 a | 1928 | 14.28 | EOL | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2019 version 16.10, 16.11 b | 1929 | 14.29 | Apr 10, 2029 | [Visual Studio 2019 lifecycle](/lifecycle/products/visual-studio-2019) | +| Visual Studio 2022 RTW 17.0 | 1930 | 14.30 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.1 | 1931 | 14.31 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.2 | 1932 | 14.32 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.3 | 1933 | 14.33 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.4 | 1934 | 14.34 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.5 | 1935 | 14.35 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.6 | 1936 | 14.36 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.7 | 1937 | 14.37 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.8 | 1938 | 14.38 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.9 | 1939 | 14.39 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.10 | 1940 | 14.40 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.11 | 1941 | 14.41 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.12 | 1942 | 14.42 | Jul 14, 2026 | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.13 | 1943 | 14.43 | EOL | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | +| Visual Studio 2022 version 17.14 | 1944 | 14.44 | Jan 13, 2032 | [Visual Studio 2022 lifecycle](/lifecycle/products/visual-studio-2022) | + +The following table lists MSVC Build Tools versions for Visual Studio 2026 and later. Starting with Visual Studio 2026, MSVC versioning is decoupled from Visual Studio versioning. EOL (end of life) dates are defined by the [MSVC lifecycle policy](https://aka.ms/msvc/lifecycle). + +| MSVC Build Tools version | `_MSC_VER` | Support | EOL date | More info | +|--|--|--|--|--| +| 14.50 | 1950 | Long-term | Nov 2028 | [What's New for C++ developers in Visual Studio 2026 version 18.0](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2026-version-18-0/) | +| 14.51 | 1951 | Standard | TBD | [MSVC lifecycle policy](https://aka.ms/msvc/lifecycle) | +| 14.52 | 1952 | Standard | TBD | [MSVC lifecycle policy](https://aka.ms/msvc/lifecycle) | a Visual Studio 2019 versions 16.8 and 16.9 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.8 is 192829333. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.9 is 192829910. b Visual Studio 2019 versions 16.10 and 16.11 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.10 is 192929917. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.11 is 192930129. +## A brief history of Microsoft C++ compiler versioning + +### Visual Studio 6.0 through Visual Studio 2015 (14.0) + +- For major releases, `_MSC_VER` increases by 100. `_MSC_FULL_VER` increases by 10,000,000. +- For minor releases, `_MSC_VER` increases by 10. `_MSC_FULL_VER` increases by 1,000,000. + + >[!Note] + > Visual Studio .NET 2003 was considered a minor release. + +### Visual Studio 2017 to Visual Studio 2022 + +- For major releases, the minor version increases by 10. +- For minor releases, the minor version increases by 1 starting with Visual Studio 2017 version 15.3. + +### Visual Studio 2026 and later + +The MSVC build tools that ship with Visual Studio 2026 and later start at version 14.50, and `_MSC_VER` starts at 1950. A new MSVC version—14.51/1951, 14.52/1952, and so on, ships every six months. Support follows the [MSVC lifecycle policy](https://aka.ms/msvc/lifecycle). + +This versioning system differs from earlier Visual Studio releases because MSVC versioning is now separate from Visual Studio versioning. That means the compiler minor version can stay the same across multiple Visual Studio updates. + +At any given time, the Visual Studio Installer can offer several MSVC versions: + +- A preview toolset with the newest changes +- The current default toolset +- Earlier toolsets that are still in support + +For example, as of May 2026: + +- **14.52** is the preview toolset and gets regular feature and fix updates. +- **14.51** is the default toolset released in May 2026, with 9 months of support. +- **14.50** is the toolset released in November 2025, with 3 years of support. + +By November 2026, we expect **14.53** to become the new preview toolset, **14.52** to become the default toolset, and **14.51** and **14.50** to remain in support under the [MSVC lifecycle policy](https://aka.ms/msvc/lifecycle). + +Microsoft changed to this model for three reasons: +- It shortens the time between MSVC feature development and preview availability from months to a week or so. +- It keeps the MSVC release cadence aligned with Visual Studio and long-term servicing releases aligned with .NET Long Term Support (LTS) releases. +- It reduces the complexity of servicing older compilers. + +### Service releases starting with Visual Studio 2017 + +Use `_MSC_FULL_VER` to distinguish servicing releases. The build field (the BBBBB in the MMNNBBBBB version number) typically increases by 1. + +For example, `_MSC_FULL_VER` is useful to distinguish Visual Studio 2019 version 16.8 from 16.9, and Visual Studio 2019 version 16.10 from 16.11. Those versions share the same major and minor versions, so they have the same value for `_MSC_VER`. + +To distinguish these versions, use `_MSC_FULL_VER`.\ +The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.8 is 192829333.\ +The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.9 is 192829910. + ## See also [`_MSC_VER`](../preprocessor/predefined-macros.md)\ From 135a14f2c1cbcc0df8fa1fa4e50226f82202ef31 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 12 May 2026 15:09:06 -0700 Subject: [PATCH 1770/1799] updates --- docs/build/sptdump.md | 6 ++++-- docs/overview/compiler-versions.md | 9 +++++---- 2 files changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/build/sptdump.md b/docs/build/sptdump.md index e7605bdb0ff..7ba096eee51 100644 --- a/docs/build/sptdump.md +++ b/docs/build/sptdump.md @@ -66,8 +66,10 @@ The SPT header is 32 bytes: - `[0x1C-0x1D]` ProgramIdsUsed (uint16 LE) = number of program IDs (often just 1) - `[0x1E-0x1F]` ProgramIdCapacity (uint16 LE) = capacity in count (not bytes) for program IDs (typically 0x100) -The StringTable immediately follows the header at the specified offset. It contains a null-terminated UTF-8 binary filename.\ -The ProgramIdTable follows the StringTable at the specified offset. Each entry is 24 bytes: 16-byte Rich Signature Data Stream (RSDS) GUID + 4-byte age + 4-byte string index into StringTable.\ +The StringTable immediately follows the header at the specified offset. It contains a null-terminated UTF-8 binary filename. + +The ProgramIdTable follows the StringTable at the specified offset. Each entry is 24 bytes: 16-byte Rich Signature Data Stream (RSDS) GUID + 4-byte age + 4-byte string index into StringTable. + The data stream starts at `ProgramIdTableOffset + (ProgramIdCapacity * 24)`, and starts with a `SPT_OP_BINARY_ID` opcode. **SPT Opcodes** diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index 21b903f2128..a51e9795b8e 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -1,7 +1,7 @@ --- description: "Learn more about Microsoft C++ compiler versioning." title: "Microsoft C++ (MSVC) compiler versioning" -ms.date: 05/08/2026 +ms.date: 05/12/2026 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] @@ -45,7 +45,6 @@ Each Visual Studio update receives updates to all of the MSVC build toolsets: - The **preview** toolset receives new features and fixes that the development team completed since the previous update. - The **default** and **older in-support** toolsets receive only targeted bug fixes. - Visual Studio Insiders users get early access to MSVC releases: - On the Insiders Channel, preview toolsets update approximately weekly. - On the Insiders Channel, new toolsets are available as release candidates about a month before they reach the Stable Channel, giving Insiders users time to validate the toolset and report issues. @@ -129,13 +128,15 @@ The following table lists MSVC Build Tools versions for Visual Studio 2026 and l | MSVC Build Tools version | `_MSC_VER` | Support | EOL date | More info | |--|--|--|--|--| | 14.50 | 1950 | Long-term | Nov 2028 | [What's New for C++ developers in Visual Studio 2026 version 18.0](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2026-version-18-0/) | -| 14.51 | 1951 | Standard | TBD | [MSVC lifecycle policy](https://aka.ms/msvc/lifecycle) | -| 14.52 | 1952 | Standard | TBD | [MSVC lifecycle policy](https://aka.ms/msvc/lifecycle) | +| 14.51 | 1951 | Standard | Feb 2027 | [MSVC lifecycle policy](https://aka.ms/msvc/lifecycle) | +| 14.52 | 1952 | Standard | Previewc | [MSVC lifecycle policy](https://aka.ms/msvc/lifecycle) | a Visual Studio 2019 versions 16.8 and 16.9 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.8 is 192829333. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.9 is 192829910. b Visual Studio 2019 versions 16.10 and 16.11 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.10 is 192929917. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.11 is 192930129. +c MSVC Build Tools version 14.52 is in preview. The EOL date will be established upon general availability. + ## A brief history of Microsoft C++ compiler versioning ### Visual Studio 6.0 through Visual Studio 2015 (14.0) From 4781ee1ce3c9da3ceef6ab4fc41b7b669abe0f18 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 12 May 2026 15:13:20 -0700 Subject: [PATCH 1771/1799] pickup couple what's new items --- docs/overview/what-s-new-for-msvc.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index a9e342a61dd..bc4c3aa96bd 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -57,9 +57,10 @@ Fixed [C4319](/cpp/error-messages/compiler-warnings/compiler-warning-level-1-c43 ### Build enhancements - **Arm SVE support:** First Arm Scalable Vector Extension (SVE) support in MSVC, including frontend type support, intrinsic lowering, callee-saved register unwinding, and DIA SDK support. -- **Sample-based PGO:** Preview support for sample-based profile guided optimizations. +- **Sample-based PGO:** Preview support for sample-based profile guided optimizations. For more information, see [Use Sample Profile Guided Optimization (SPGO) to improve C++ performance](../build/sample-profile-guided-optimization.md). - The C++ backend optimizer improves code generation, including better inlining, loop optimizations, and pattern matching. -- **Intel APX preview:** Preview support for Intel Advanced Performance Extensions. +- **Experimental support for x64 Unwind Version 3 MASM directives**. For more information, see [Unwind Version 3 directives (experimental)](../assembler/masm/directives-reference#x64-unwind-version-3-experimental.md). +- **Intel APX preview:** Preview support for Intel Advanced Performance Extensions. For more information, see [/feature (x64)](..build/reference/feature-x64.md). - Enabled debug info pruning to reduce PDB sizes. ### Deprecations From 78cecde90abdaf0056ab344006987524c5e6c798 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 12 May 2026 15:20:12 -0700 Subject: [PATCH 1772/1799] fix links --- docs/overview/what-s-new-for-msvc.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index bc4c3aa96bd..f354b8eb1d7 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -59,8 +59,8 @@ Fixed [C4319](/cpp/error-messages/compiler-warnings/compiler-warning-level-1-c43 - **Arm SVE support:** First Arm Scalable Vector Extension (SVE) support in MSVC, including frontend type support, intrinsic lowering, callee-saved register unwinding, and DIA SDK support. - **Sample-based PGO:** Preview support for sample-based profile guided optimizations. For more information, see [Use Sample Profile Guided Optimization (SPGO) to improve C++ performance](../build/sample-profile-guided-optimization.md). - The C++ backend optimizer improves code generation, including better inlining, loop optimizations, and pattern matching. -- **Experimental support for x64 Unwind Version 3 MASM directives**. For more information, see [Unwind Version 3 directives (experimental)](../assembler/masm/directives-reference#x64-unwind-version-3-experimental.md). -- **Intel APX preview:** Preview support for Intel Advanced Performance Extensions. For more information, see [/feature (x64)](..build/reference/feature-x64.md). +- **Experimental support for x64 Unwind Version 3 MASM directives**. For more information, see [Unwind Version 3 directives (experimental)](../assembler/masm/directives-reference.md#x64-unwind-version-3-experimental) +- **Intel APX preview:** Preview support for Intel Advanced Performance Extensions. For more information, see [/feature (x64)](../build/reference/feature-x64.md). - Enabled debug info pruning to reduce PDB sizes. ### Deprecations From eb8673fd897da5a607f73248cc0703d5f6174b21 Mon Sep 17 00:00:00 2001 From: Justin Piesco <107575186+JustPies@users.noreply.github.com> Date: Wed, 13 May 2026 09:08:21 -0400 Subject: [PATCH 1773/1799] removed links --- .../set-up-fips-compliant-secure-remote-linux-development.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md index aa4ba4bf66e..c771087b836 100644 --- a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md +++ b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md @@ -147,7 +147,7 @@ It's possible to enable FIPS mode globally in Windows. 1. In the **Local Security Setting** tab, select **Enabled** or **Disabled**, and then choose **OK** to save your changes. > [!WARNING] -> Enabling FIPS mode may cause some applications to break or behave unexpectedly. For more information, see the blog post [Why We're Not Recommending "FIPS mode" Anymore](https://techcommunity.microsoft.com/t5/microsoft-security-baselines/why-we-8217-re-not-recommending-8220-fips-mode-8221-anymore/ba-p/701037). +> Enabling FIPS mode may cause some applications to break or behave unexpectedly. ## Additional resources @@ -157,8 +157,6 @@ It's possible to enable FIPS mode globally in Windows. [Cryptographic Algorithm Validation Program: Validation Notes](https://csrc.nist.gov/projects/cryptographic-algorithm-validation-program/Validation-Notes) (from NIST) -Microsoft blog post on [Why We're Not Recommending "FIPS mode" Anymore](https://techcommunity.microsoft.com/t5/microsoft-security-baselines/why-we-8217-re-not-recommending-8220-fips-mode-8221-anymore/ba-p/701037) - [SSH Server Configuration](https://www.ssh.com/ssh/sshd_config) ## See also From 34bb356867c5abeed2c4819e4709492d09cccbb0 Mon Sep 17 00:00:00 2001 From: Justin Piesco <107575186+JustPies@users.noreply.github.com> Date: Wed, 13 May 2026 09:12:14 -0400 Subject: [PATCH 1774/1799] updated link --- .../how-to-report-a-problem-with-the-visual-cpp-toolset.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index 5664f47bcee..579d8db1796 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -422,6 +422,6 @@ To maintain your privacy and keep your sensitive information out of public view, ## How to report a C++ documentation issue -If you see an issue with a document, a bad code sample, a confusing explanation, a critical omission, or even just a typo, you can easily let us know by using the feedback buttons on the page. Since 2024, we no longer use GitHub issues to track problems reported. For more information, see [Announcing a new way to give feedback on Microsoft Learn](https://techcommunity.microsoft.com/blog/microsoftlearnblog/announcing-a-new-way-to-give-feedback-on-microsoft-learn/4027635). +If you see an issue with a document, a bad code sample, a confusing explanation, a critical omission, or even just a typo, you can easily let us know by using the feedback buttons on the page. Since 2024, we no longer use GitHub issues to track problems reported. For more information, see [Announcing a new way to give feedback on Microsoft Learn](https://techcommunity.microsoft.com/blog/skills-hub-blog/announcing-a-new-way-to-give-feedback-on-microsoft-learn/4027635). [Our C++ docs are open source](https://github.com/MicrosoftDocs/cpp-docs/), so if you'd like to submit a fix yourself, you can. For more information about how you can contribute to our documentation, see our [Contributing guide](https://github.com/MicrosoftDocs/cpp-docs/blob/main/CONTRIBUTING.md) on GitHub. From c238fc5c52ecf1bbc0e9a599fa736086d6c590da Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 13 May 2026 13:30:48 -0700 Subject: [PATCH 1775/1799] Add more to Segment Heap description in documentation Expanded the description of the Segment Heap setting to include benefits such as improved memory efficiency, reduced fragmentation, and enhanced memory security. --- docs/build/reference/manifest-tool-property-pages.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/manifest-tool-property-pages.md b/docs/build/reference/manifest-tool-property-pages.md index ddabe61e2cc..fc70cc16669 100644 --- a/docs/build/reference/manifest-tool-property-pages.md +++ b/docs/build/reference/manifest-tool-property-pages.md @@ -100,7 +100,7 @@ Specifies whether the application is DPI-aware. By default, the setting is **Yes ### Segment Heap -Specifies whether the application utilizes the Segment Heap. For new C++ projects, the setting is **Yes** by default. +Specifies whether the application utilizes the Segment Heap. When enabled, applications benefit from improved memory efficiency, reduced fragmentation, and enhanced memory security. For new C++ projects, the setting is **Yes** by default. ## Isolated COM Property Page From a0429e0ca16ff5f66a28351ddd772177d5b2d07e Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 13 May 2026 14:17:13 -0700 Subject: [PATCH 1776/1799] Include usage examples of the environment variables --- docs/build/cmake-presets-vs.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index 90427d3ffd4..e0a16372fe9 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -465,13 +465,17 @@ Pass runtime flags to AddressSanitizer by using the `ASAN_OPTIONS` field in *`la The Segment Heap is a modern Windows heap implementation that reduces memory usage and fragmentation. Visual Studio ships a CMake script that enables Segment Heap for your project by adding the required manifest settings. New C++ CMake projects enable Segment Heap by default. -To enable Segment Heap, set `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` in the `cacheVariables` map of your Configure Preset in *`CMakePresets.json`*: +To enable Segment Heap, set `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` in the `cacheVariables` map of your Configure Preset in *`CMakePresets.json`*. Optionally, set the `VS_SEGMENT_HEAP_ALLOWLIST` and `VS_SEGMENT_HEAP_EXCLUDE` environment variables to control which targets in the project use Segment Heap. Separate target names with semicolons: ```json { "configurePresets": [ { // ... + "environment": { + "VS_SEGMENT_HEAP_ALLOWLIST": "target1;target2;", + "VS_SEGMENT_HEAP_EXCLUDE": "target3;" + }, "cacheVariables": { "CMAKE_PROJECT_TOP_LEVEL_INCLUDES": "$env{VSINSTALLDIR}Common7/IDE/CommonExtensions/Microsoft/CMake/cmake/Microsoft/SegmentHeap.cmake" } @@ -484,12 +488,10 @@ To enable Segment Heap, set `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` in the `cacheVari > [!NOTE] > `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` is available in CMake 3.24 or later. -Use the `VS_SEGMENT_HEAP_ALLOWLIST` and `VS_SEGMENT_HEAP_EXCLUDE` environment variables to control which targets in the project use Segment Heap. Separate target names with semicolons. - - `VS_SEGMENT_HEAP_ALLOWLIST` — Apply the Segment Heap manifest entry only to the listed targets. Exclude all other targets. - `VS_SEGMENT_HEAP_EXCLUDE` — Exclude the listed targets from using the Segment Heap. -When neither variable is set, Visual Studio enables Segment Heap for all targets. If both variables are set, `VS_SEGMENT_HEAP_ALLOWLIST` takes precedence. +In this example, `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` points to the Visual Studio-provided `SegmentHeap.cmake` script. The optional `VS_SEGMENT_HEAP_ALLOWLIST` and `VS_SEGMENT_HEAP_EXCLUDE` variables show how to include or exclude specific targets. If neither variable is set, Visual Studio enables Segment Heap for all targets. If both variables are set, `VS_SEGMENT_HEAP_ALLOWLIST` takes precedence. ## Run CMake from the command line or a CI pipeline From 8b310c96188c1f460c95110d826814d3baf0704e Mon Sep 17 00:00:00 2001 From: MacGyver Codilla Date: Wed, 13 May 2026 14:17:57 -0700 Subject: [PATCH 1777/1799] Remove 'modern' --- docs/build/cmake-presets-vs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index e0a16372fe9..62d80010a54 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -463,7 +463,7 @@ Pass runtime flags to AddressSanitizer by using the `ASAN_OPTIONS` field in *`la ## Enable Segment Heap -The Segment Heap is a modern Windows heap implementation that reduces memory usage and fragmentation. Visual Studio ships a CMake script that enables Segment Heap for your project by adding the required manifest settings. New C++ CMake projects enable Segment Heap by default. +The Segment Heap is a Windows heap implementation that reduces memory usage and fragmentation. Visual Studio ships a CMake script that enables Segment Heap for your project by adding the required manifest settings. New C++ CMake projects enable Segment Heap by default. To enable Segment Heap, set `CMAKE_PROJECT_TOP_LEVEL_INCLUDES` in the `cacheVariables` map of your Configure Preset in *`CMakePresets.json`*. Optionally, set the `VS_SEGMENT_HEAP_ALLOWLIST` and `VS_SEGMENT_HEAP_EXCLUDE` environment variables to control which targets in the project use Segment Heap. Separate target names with semicolons: From 6173eabf77f6c9ff173e3ff09581e32c6a28b37e Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 14 May 2026 15:22:12 -0700 Subject: [PATCH 1778/1799] docs(attributes): Add [[msvc::disable(feature:APX)]] and [[msvc::enable(feature:APX)]] documentation Integrated new Microsoft-specific C++ attributes for APX (Intel Advanced Performance Extensions) feature control into attributes.md. Both attributes are x64-only and experimental. ## Changes - Added [[msvc::disable(feature:APX)]] attribute documentation with examples - Added [[msvc::enable(feature:APX)]] attribute documentation with examples - Attributes placed alphabetically between [[gsl::suppress]] and [[msvc::flatten]] - Updated YAML front matter with msvc::disable and msvc::enable keywords - Applied Windows x64 calling convention corrections to assembly examples - Added experimental x64-only designation per [[msvc::musttail]] pattern ## Key Teaching Point Demonstrates per-function scope: when main has [[msvc::disable(feature:APX)]], main does NOT use APX instructions, but called functions still generate APX instructions. ## Pending Verification - Visual Studio version (placeholder: 17.XX) - /arch:APX compiler flag spelling confirmation - Experimental vs production status confirmation - Assembly example validation against actual compiler output These items flagged for TylerMSFT verification before publication. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/cpp/attributes.md | 83 ++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 80 insertions(+), 3 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 84be79ffc4b..d8f6471e601 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -1,9 +1,9 @@ --- title: "Attributes in C++" description: "Learn more about: Attributes in C++" -f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] -helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] -ms.date: 12/9/2025 +f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::disable", "msvc::enable", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] +helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::disable", "msvc::enable", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] +ms.date: 05/14/2026 --- # Attributes in C++ @@ -114,6 +114,83 @@ Both `#pragma warning(suppress)` and `[[gsl::suppress]]` offer fine-grained cont Whenever possible, use `[[gsl::suppress]]` for suppressing Microsoft C++ Code Analysis warnings. +### `[[msvc::disable(feature:APX)]]` + +The `[[msvc::disable(feature:APX)]]` attribute, introduced in Visual Studio 2022 version 17.XX, is an experimental x64-only Microsoft-specific attribute that disables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it prevents the compiler from emitting APX instructions in that function's body, even when APX is globally enabled via the `/arch:APX` compiler option. Other functions in the same translation unit continue to use APX instructions unless they are similarly attributed. + + + +#### Example + +```cpp +// Compile with /arch:APX on x64 + +int subtract(int a, int b) +{ + return a - b; +} + +[[msvc::disable(feature:APX)]] +int main() +{ + int result = subtract(10, 3); + return result; +} + +// Compiled output (relevant portions): +// +// subtract: +// {nf} sub eax,ecx,edx ; APX NDD instruction: eax = ecx - edx (no EFLAGS update) +// ret +// +// main: +// mov edx,3 ; Set up second argument +// mov ecx,10 ; Set up first argument +// call subtract ; Call proceeds normally; subtract uses APX +// ret ; main itself uses no APX instructions +``` + +In this example, `main` is compiled without APX instructions due to `[[msvc::disable(feature:APX)]]`. The `subtract` function, which has no such attribute, still generates APX instructions including the `{nf}` no-flags encoding. This demonstrates that the attribute affects only the specific function to which it is applied — other functions in the same translation unit continue to use APX. + +### `[[msvc::enable(feature:APX)]]` + +The `[[msvc::enable(feature:APX)]]` attribute, introduced in Visual Studio 2022 version 17.XX, is an experimental x64-only Microsoft-specific attribute that enables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it allows the compiler to emit APX instructions in that function's body, even when APX is not globally enabled. This provides per-function opt-in to APX features without requiring `/arch:APX` for the entire translation unit. + + + +#### Example + +```cpp +// Compile without /arch:APX on x64 + +[[msvc::enable(feature:APX)]] +int add_three(int a, int b, int c) +{ + return a + b + c; +} + +int main() +{ + return add_three(5, 10, 15); +} + +// Compiled output (relevant portions): +// +// add_three: +// {nf} add eax,ecx,edx ; APX NDD instruction: eax = ecx + edx (no EFLAGS update) +// {nf} add eax,eax,r8d ; APX NDD instruction: eax = eax + r8d +// ret +// +// main: +// mov r8d,15 ; Third argument +// mov edx,10 ; Second argument +// mov ecx,5 ; First argument +// call add_three +// ret ; main uses no APX instructions +``` + +The `add_three` function uses APX NDD (New Data Destination) 3-operand instructions even though APX isn't enabled globally, while `main` uses standard x64 instructions. This demonstrates per-function opt-in to APX without requiring `/arch:APX` for the entire translation unit. + ### `[[msvc::flatten]]` The Microsoft-specific attribute `[[msvc::flatten]]` is similar to `[[msvc::forceinline_calls]]`, and can be used in the same places and in the same way. The difference is that `[[msvc::flatten]]` will `[[msvc::forceinline_calls]]` all calls in the scope it's applied to recursively, until no calls are left. This may have consequences for the resulting code size growth of the function or the throughput of the compiler, which you must manage manually. From 9ae6e6d2108ff34a456ce6cbc90e50b9d607cf5b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 14 May 2026 15:29:06 -0700 Subject: [PATCH 1779/1799] Document [[msvc::disable(feature:APX)]] and [[msvc::enable(feature:APX)]] attributes Introduced in MSVC Build Tools 14.51 (Visual Studio 18.6.0). Both attributes are x64-only, non-experimental, and affect inlined callees. Examples use test()/test2() pattern showing APX vs non-APX compiled output. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/cpp/attributes.md | 54 +++++++++++++++++------------------------- 1 file changed, 22 insertions(+), 32 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index d8f6471e601..4e7d0883fed 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -116,47 +116,41 @@ Whenever possible, use `[[gsl::suppress]]` for suppressing Microsoft C++ Code An ### `[[msvc::disable(feature:APX)]]` -The `[[msvc::disable(feature:APX)]]` attribute, introduced in Visual Studio 2022 version 17.XX, is an experimental x64-only Microsoft-specific attribute that disables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it prevents the compiler from emitting APX instructions in that function's body, even when APX is globally enabled via the `/arch:APX` compiler option. Other functions in the same translation unit continue to use APX instructions unless they are similarly attributed. - - +The `[[msvc::disable(feature:APX)]]` attribute, introduced in [MSVC Build Tools version 14.51](../overview/what-s-new-for-msvc.md#whats-new-for-msvc-build-tools-version-1451) (Visual Studio version 18.6.0), is an x64-only Microsoft-specific attribute that disables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it prevents the compiler from emitting APX instructions in that function's body, even when APX is globally enabled via the `/arch:APX` compiler option. Other functions in the same translation unit continue to use APX instructions unless they are similarly attributed. If a function with `[[msvc::disable(feature:APX)]]` has calls that are inlined into it, the inlined code is also compiled without APX instructions. #### Example ```cpp // Compile with /arch:APX on x64 -int subtract(int a, int b) +int test(int a, int b) { return a - b; } [[msvc::disable(feature:APX)]] -int main() +int test2(int a, int b) { - int result = subtract(10, 3); - return result; + return a - b; } // Compiled output (relevant portions): // -// subtract: -// {nf} sub eax,ecx,edx ; APX NDD instruction: eax = ecx - edx (no EFLAGS update) +// test: // APX enabled — uses {nf} instruction +// {nf} sub eax,ecx,edx // APX NDD: eax = ecx - edx (no EFLAGS update) // ret // -// main: -// mov edx,3 ; Set up second argument -// mov ecx,10 ; Set up first argument -// call subtract ; Call proceeds normally; subtract uses APX -// ret ; main itself uses no APX instructions +// test2: // APX disabled by [[msvc::disable(feature:APX)]] +// mov eax,ecx // Standard x64: copy a to return register +// sub eax,edx // Subtract b (eax = a - b) +// ret ``` -In this example, `main` is compiled without APX instructions due to `[[msvc::disable(feature:APX)]]`. The `subtract` function, which has no such attribute, still generates APX instructions including the `{nf}` no-flags encoding. This demonstrates that the attribute affects only the specific function to which it is applied — other functions in the same translation unit continue to use APX. +`test` uses the APX `{nf}` (no-flags) NDD instruction, while `test2` uses standard x64 instructions. The attribute affects only the function it's applied to. ### `[[msvc::enable(feature:APX)]]` -The `[[msvc::enable(feature:APX)]]` attribute, introduced in Visual Studio 2022 version 17.XX, is an experimental x64-only Microsoft-specific attribute that enables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it allows the compiler to emit APX instructions in that function's body, even when APX is not globally enabled. This provides per-function opt-in to APX features without requiring `/arch:APX` for the entire translation unit. - - +The `[[msvc::enable(feature:APX)]]` attribute, introduced in [MSVC Build Tools version 14.51](../overview/what-s-new-for-msvc.md#whats-new-for-msvc-build-tools-version-1451) (Visual Studio version 18.6.0), is an x64-only Microsoft-specific attribute that enables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it allows the compiler to emit APX instructions in that function's body, even when APX is not globally enabled. This provides per-function opt-in to APX features without requiring `/arch:APX` for the entire translation unit. If a function with `[[msvc::enable(feature:APX)]]` has calls that are inlined into it, the inlined code is also compiled with APX instructions. #### Example @@ -164,32 +158,28 @@ The `[[msvc::enable(feature:APX)]]` attribute, introduced in Visual Studio 2022 // Compile without /arch:APX on x64 [[msvc::enable(feature:APX)]] -int add_three(int a, int b, int c) +int test(int a, int b) { - return a + b + c; + return a + b; } -int main() +int test2(int a, int b) { - return add_three(5, 10, 15); + return a + b; } // Compiled output (relevant portions): // -// add_three: -// {nf} add eax,ecx,edx ; APX NDD instruction: eax = ecx + edx (no EFLAGS update) -// {nf} add eax,eax,r8d ; APX NDD instruction: eax = eax + r8d +// test: // APX enabled by [[msvc::enable(feature:APX)]] +// {nf} add eax,ecx,edx // APX NDD: eax = ecx + edx (no EFLAGS update) // ret // -// main: -// mov r8d,15 ; Third argument -// mov edx,10 ; Second argument -// mov ecx,5 ; First argument -// call add_three -// ret ; main uses no APX instructions +// test2: // Standard x64 — APX not enabled globally +// lea eax,[rcx+rdx] // Standard x64 addition +// ret ``` -The `add_three` function uses APX NDD (New Data Destination) 3-operand instructions even though APX isn't enabled globally, while `main` uses standard x64 instructions. This demonstrates per-function opt-in to APX without requiring `/arch:APX` for the entire translation unit. +`test` uses the APX `{nf}` (no-flags) NDD instruction even though `/arch:APX` isn't enabled globally, while `test2` uses standard x64 instructions. The attribute provides per-function opt-in to APX. ### `[[msvc::flatten]]` From a0caa5ccc474d308b008cadf9c30dc4c713e8d05 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 15 May 2026 15:25:53 -0700 Subject: [PATCH 1780/1799] draft --- docs/cpp/attributes.md | 69 ++++++++++++++++++---------- docs/overview/what-s-new-for-msvc.md | 4 +- 2 files changed, 48 insertions(+), 25 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 4e7d0883fed..f59a6aa83d8 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -3,7 +3,7 @@ title: "Attributes in C++" description: "Learn more about: Attributes in C++" f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::disable", "msvc::enable", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::disable", "msvc::enable", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] -ms.date: 05/14/2026 +ms.date: 05/15/2026 --- # Attributes in C++ @@ -116,61 +116,84 @@ Whenever possible, use `[[gsl::suppress]]` for suppressing Microsoft C++ Code An ### `[[msvc::disable(feature:APX)]]` -The `[[msvc::disable(feature:APX)]]` attribute, introduced in [MSVC Build Tools version 14.51](../overview/what-s-new-for-msvc.md#whats-new-for-msvc-build-tools-version-1451) (Visual Studio version 18.6.0), is an x64-only Microsoft-specific attribute that disables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it prevents the compiler from emitting APX instructions in that function's body, even when APX is globally enabled via the `/arch:APX` compiler option. Other functions in the same translation unit continue to use APX instructions unless they are similarly attributed. If a function with `[[msvc::disable(feature:APX)]]` has calls that are inlined into it, the inlined code is also compiled without APX instructions. +The `[[msvc::disable(feature:APX)]]` attribute, introduced in [MSVC Build Tools version 14.51](../overview/what-s-new-for-msvc.md#whats-new-for-msvc-build-tools-version-1451) (Visual Studio version 18.6.0), is an x64-only Microsoft-specific attribute that disables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it prevents the compiler from emitting APX instructions in that function's body, even if APX is globally enabled via the `/feature:APX` compiler option. Other functions in the same translation unit continue to use APX instructions unless they are similarly attributed. If a function with `[[msvc::disable(feature:APX)]]` calls inlined functions, the inlined code is also compiled without APX instructions. #### Example ```cpp -// Compile with /arch:APX on x64 +// cl /std:c++latest apx.cpp /Zi /MD /O2 /d2offSSAPEEPLEA,SSAPEEPBUILDLEA,LEA_COMPLEX_ADDR,ADDR /link /incremental:no -int test(int a, int b) +​int test(int argc) { - return a - b; + auto lambda = + [] + [[msvc::enable(feature:APX), msvc::noinline]] + (int argc) + { + return argc + 42; + }; + return lambda(argc); } -[[msvc::disable(feature:APX)]] -int test2(int a, int b) +[[msvc::enable(feature:APX), msvc::noinline]] +int test2(int x) { - return a - b; + return x + 42; +} + +int main(int argc, char** argv) +{ + return test(argc) - test2(argc); } // Compiled output (relevant portions): // -// test: // APX enabled — uses {nf} instruction -// {nf} sub eax,ecx,edx // APX NDD: eax = ecx - edx (no EFLAGS update) +// test: // APX enabled by [[msvc::enable(feature:APX)]] +// {nf} add eax,ecx,edx // APX NDD: eax = ecx + edx (no EFLAGS update) // ret // -// test2: // APX disabled by [[msvc::disable(feature:APX)]] -// mov eax,ecx // Standard x64: copy a to return register -// sub eax,edx // Subtract b (eax = a - b) +// test2: // Standard x64 — APX not enabled globally +// lea eax,[rcx+rdx] // Standard x64 addition // ret ``` -`test` uses the APX `{nf}` (no-flags) NDD instruction, while `test2` uses standard x64 instructions. The attribute affects only the function it's applied to. +`test` uses the APX `{nf}` (no-flags) New Data Destination (NDD) instruction, while `test2` uses standard x64 instructions. The attribute affects only the function it's applied to. ### `[[msvc::enable(feature:APX)]]` The `[[msvc::enable(feature:APX)]]` attribute, introduced in [MSVC Build Tools version 14.51](../overview/what-s-new-for-msvc.md#whats-new-for-msvc-build-tools-version-1451) (Visual Studio version 18.6.0), is an x64-only Microsoft-specific attribute that enables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it allows the compiler to emit APX instructions in that function's body, even when APX is not globally enabled. This provides per-function opt-in to APX features without requiring `/arch:APX` for the entire translation unit. If a function with `[[msvc::enable(feature:APX)]]` has calls that are inlined into it, the inlined code is also compiled with APX instructions. -#### Example +#### `[[msvc::enable(feature:APX)]]` example ```cpp -// Compile without /arch:APX on x64 +// cl /std:c++latest apx.cpp /Zi /MD /O2 /d2offSSAPEEPLEA,SSAPEEPBUILDLEA,LEA_COMPLEX_ADDR,ADDR /link /incremental:no + +​int test(int argc) +{ + auto lambda = + [] + [[msvc::enable(feature:APX), msvc::noinline]] + (int argc) + { + return argc + 42; + }; + return lambda(argc); +} -[[msvc::enable(feature:APX)]] -int test(int a, int b) +[[msvc::enable(feature:APX), msvc::noinline]] +int test2(int x) { - return a + b; + return x + 42; } -int test2(int a, int b) +int main(int argc, char** argv) { - return a + b; + return test(argc) - test2(argc); } // Compiled output (relevant portions): // -// test: // APX enabled by [[msvc::enable(feature:APX)]] +// test: // APX enabled by [[msvc::enable(feature:APX)]] // {nf} add eax,ecx,edx // APX NDD: eax = ecx + edx (no EFLAGS update) // ret // @@ -179,7 +202,7 @@ int test2(int a, int b) // ret ``` -`test` uses the APX `{nf}` (no-flags) NDD instruction even though `/arch:APX` isn't enabled globally, while `test2` uses standard x64 instructions. The attribute provides per-function opt-in to APX. +`test` uses the APX `{nf}` (no-flags) New Data Destination (NDD) instruction even though `/feat:APX` isn't enabled globally, while `test2` uses standard x64 instructions. The attribute provides per-function APX opt-in. ### `[[msvc::flatten]]` diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index f354b8eb1d7..31aabe88305 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,7 +1,7 @@ --- title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 05/12/2026 +ms.date: 05/15/2026 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new @@ -60,7 +60,7 @@ Fixed [C4319](/cpp/error-messages/compiler-warnings/compiler-warning-level-1-c43 - **Sample-based PGO:** Preview support for sample-based profile guided optimizations. For more information, see [Use Sample Profile Guided Optimization (SPGO) to improve C++ performance](../build/sample-profile-guided-optimization.md). - The C++ backend optimizer improves code generation, including better inlining, loop optimizations, and pattern matching. - **Experimental support for x64 Unwind Version 3 MASM directives**. For more information, see [Unwind Version 3 directives (experimental)](../assembler/masm/directives-reference.md#x64-unwind-version-3-experimental) -- **Intel APX preview:** Preview support for Intel Advanced Performance Extensions. For more information, see [/feature (x64)](../build/reference/feature-x64.md). +- **Intel APX preview:** Preview support for Intel Advanced Performance Extensions. For more information, see [/feature (x64)](../build/reference/feature-x64.md), [`[[msvc::enable(feature:APX)]]`](../cpp/attributes.md#msvcenablefeatureapx), and [`[[msvc::disable(feature:APX)]]`](../cpp/attributes.md#msvcdisablefeatureapx). - Enabled debug info pruning to reduce PDB sizes. ### Deprecations From 8fc40814ae6bd86795037a85f619ec510c97edfa Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 15 May 2026 16:22:13 -0700 Subject: [PATCH 1781/1799] fix --- docs/cpp/attributes.md | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index f59a6aa83d8..41b2e0f4e44 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -121,13 +121,12 @@ The `[[msvc::disable(feature:APX)]]` attribute, introduced in [MSVC Build Tools #### Example ```cpp -// cl /std:c++latest apx.cpp /Zi /MD /O2 /d2offSSAPEEPLEA,SSAPEEPBUILDLEA,LEA_COMPLEX_ADDR,ADDR /link /incremental:no +// cl /std:c++latest apx.cpp /feature:APX /Zi /MD /O2 /d2offSSAPEEPLEA,SSAPEEPBUILDLEA,LEA_COMPLEX_ADDR,ADDR /link /incremental:no ​int test(int argc) { auto lambda = [] - [[msvc::enable(feature:APX), msvc::noinline]] (int argc) { return argc + 42; @@ -135,7 +134,7 @@ The `[[msvc::disable(feature:APX)]]` attribute, introduced in [MSVC Build Tools return lambda(argc); } -[[msvc::enable(feature:APX), msvc::noinline]] +[[msvc::disable(feature:APX)]] int test2(int x) { return x + 42; @@ -148,16 +147,14 @@ int main(int argc, char** argv) // Compiled output (relevant portions): // -// test: // APX enabled by [[msvc::enable(feature:APX)]] -// {nf} add eax,ecx,edx // APX NDD: eax = ecx + edx (no EFLAGS update) +// test2() is compiled without APX instructions because it has the attribute, e.g.: +// +// add eax,ecx,edx // instead of APX NDD: eax = ecx + edx (no EFLAGS update) // ret // -// test2: // Standard x64 — APX not enabled globally -// lea eax,[rcx+rdx] // Standard x64 addition -// ret ``` -`test` uses the APX `{nf}` (no-flags) New Data Destination (NDD) instruction, while `test2` uses standard x64 instructions. The attribute affects only the function it's applied to. +The function `test()` and the lambda inside `test()` are compiled with APX `{nf}` (no-flags) New Data Destination (NDD) instructions because of the `/feature:APX` flag, but `test2()` isn't because it has the attribute. ### `[[msvc::enable(feature:APX)]]` @@ -193,7 +190,7 @@ int main(int argc, char** argv) // Compiled output (relevant portions): // -// test: // APX enabled by [[msvc::enable(feature:APX)]] +// lambda inside test: // APX enabled by [[msvc::enable(feature:APX)]] // {nf} add eax,ecx,edx // APX NDD: eax = ecx + edx (no EFLAGS update) // ret // @@ -202,7 +199,7 @@ int main(int argc, char** argv) // ret ``` -`test` uses the APX `{nf}` (no-flags) New Data Destination (NDD) instruction even though `/feat:APX` isn't enabled globally, while `test2` uses standard x64 instructions. The attribute provides per-function APX opt-in. +`test` itself doesn't use the APX `{nf}` (no-flags) New Data Destination (NDD) instruction because `/feat:APX` isn't enabled globally, while the lambda inside `test` does. The attribute provides per-function APX opt-in. ### `[[msvc::flatten]]` From 82fcc5af0e9a03cdbcc709ad9e7b5d1cfe398e7b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 15 May 2026 17:00:46 -0700 Subject: [PATCH 1782/1799] update --- docs/cpp/attributes.md | 24 ++++++++++-------------- 1 file changed, 10 insertions(+), 14 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 41b2e0f4e44..a2651c31af1 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -121,12 +121,13 @@ The `[[msvc::disable(feature:APX)]]` attribute, introduced in [MSVC Build Tools #### Example ```cpp -// cl /std:c++latest apx.cpp /feature:APX /Zi /MD /O2 /d2offSSAPEEPLEA,SSAPEEPBUILDLEA,LEA_COMPLEX_ADDR,ADDR /link /incremental:no +// cl /std:c++latest apx.cpp /feature:APX /Zi /MD /O2 /link /incremental:no ​int test(int argc) { auto lambda = [] + [[msvc::disable(feature:APX)]] (int argc) { return argc + 42; @@ -147,15 +148,13 @@ int main(int argc, char** argv) // Compiled output (relevant portions): // -// test2() is compiled without APX instructions because it has the attribute, e.g.: +// test2(), and the lambda inside test(), are compiled without APX New Data Destination (NDD) +// instructions because they have the attribute, e.g.: // -// add eax,ecx,edx // instead of APX NDD: eax = ecx + edx (no EFLAGS update) -// ret +// add eax,ecx,edx instead of APX NDD: eax = ecx + edx (no EFLAGS update) // ``` -The function `test()` and the lambda inside `test()` are compiled with APX `{nf}` (no-flags) New Data Destination (NDD) instructions because of the `/feature:APX` flag, but `test2()` isn't because it has the attribute. - ### `[[msvc::enable(feature:APX)]]` The `[[msvc::enable(feature:APX)]]` attribute, introduced in [MSVC Build Tools version 14.51](../overview/what-s-new-for-msvc.md#whats-new-for-msvc-build-tools-version-1451) (Visual Studio version 18.6.0), is an x64-only Microsoft-specific attribute that enables Intel Advanced Performance Extensions (APX) instruction generation for a specific function. When applied to a function declaration or definition, it allows the compiler to emit APX instructions in that function's body, even when APX is not globally enabled. This provides per-function opt-in to APX features without requiring `/arch:APX` for the entire translation unit. If a function with `[[msvc::enable(feature:APX)]]` has calls that are inlined into it, the inlined code is also compiled with APX instructions. @@ -163,7 +162,7 @@ The `[[msvc::enable(feature:APX)]]` attribute, introduced in [MSVC Build Tools v #### `[[msvc::enable(feature:APX)]]` example ```cpp -// cl /std:c++latest apx.cpp /Zi /MD /O2 /d2offSSAPEEPLEA,SSAPEEPBUILDLEA,LEA_COMPLEX_ADDR,ADDR /link /incremental:no +// cl /std:c++latest apx.cpp /Zi /MD /O2 /link /incremental:no ​int test(int argc) { @@ -190,16 +189,13 @@ int main(int argc, char** argv) // Compiled output (relevant portions): // -// lambda inside test: // APX enabled by [[msvc::enable(feature:APX)]] -// {nf} add eax,ecx,edx // APX NDD: eax = ecx + edx (no EFLAGS update) -// ret -// -// test2: // Standard x64 — APX not enabled globally -// lea eax,[rcx+rdx] // Standard x64 addition +// test2(), and the lambda inside test(), are compiled with APX instructionsNew Data Destination (NDD) +// instructions because they have the attribute, e.g. +// instead of add eax,ecx,edx, get APX NDD: eax = ecx + edx (no EFLAGS update) // ret ``` -`test` itself doesn't use the APX `{nf}` (no-flags) New Data Destination (NDD) instruction because `/feat:APX` isn't enabled globally, while the lambda inside `test` does. The attribute provides per-function APX opt-in. +`test` itself doesn't use the APX `{nf}` (no-flags) New Data Destination (NDD) instruction because `/feat:APX` isn't enabled globally, but the lambda inside `test` does because of the attribute. The attribute provides per-function APX opt-in. ### `[[msvc::flatten]]` From 5943f7d322a995c650ecbc55a9c752313c87f4a7 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 15 May 2026 18:41:14 -0700 Subject: [PATCH 1783/1799] simplify --- docs/cpp/attributes.md | 36 +++++------------------------------- 1 file changed, 5 insertions(+), 31 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index a2651c31af1..5e6cfc32fc0 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -121,8 +121,8 @@ The `[[msvc::disable(feature:APX)]]` attribute, introduced in [MSVC Build Tools #### Example ```cpp -// cl /std:c++latest apx.cpp /feature:APX /Zi /MD /O2 /link /incremental:no - +// The following shows how to disable APX instructions for specific functions, +// even when APX is enabled globally with /feature:APX ​int test(int argc) { auto lambda = @@ -140,19 +140,6 @@ int test2(int x) { return x + 42; } - -int main(int argc, char** argv) -{ - return test(argc) - test2(argc); -} - -// Compiled output (relevant portions): -// -// test2(), and the lambda inside test(), are compiled without APX New Data Destination (NDD) -// instructions because they have the attribute, e.g.: -// -// add eax,ecx,edx instead of APX NDD: eax = ecx + edx (no EFLAGS update) -// ``` ### `[[msvc::enable(feature:APX)]]` @@ -162,13 +149,14 @@ The `[[msvc::enable(feature:APX)]]` attribute, introduced in [MSVC Build Tools v #### `[[msvc::enable(feature:APX)]]` example ```cpp -// cl /std:c++latest apx.cpp /Zi /MD /O2 /link /incremental:no +// The following shows how to enable APX instructions for specific functions, +// even when APX isn't enabled globally with /feature:APX ​int test(int argc) { auto lambda = [] - [[msvc::enable(feature:APX), msvc::noinline]] + [[msvc::enable(feature:APX)]] (int argc) { return argc + 42; @@ -181,22 +169,8 @@ int test2(int x) { return x + 42; } - -int main(int argc, char** argv) -{ - return test(argc) - test2(argc); -} - -// Compiled output (relevant portions): -// -// test2(), and the lambda inside test(), are compiled with APX instructionsNew Data Destination (NDD) -// instructions because they have the attribute, e.g. -// instead of add eax,ecx,edx, get APX NDD: eax = ecx + edx (no EFLAGS update) -// ret ``` -`test` itself doesn't use the APX `{nf}` (no-flags) New Data Destination (NDD) instruction because `/feat:APX` isn't enabled globally, but the lambda inside `test` does because of the attribute. The attribute provides per-function APX opt-in. - ### `[[msvc::flatten]]` The Microsoft-specific attribute `[[msvc::flatten]]` is similar to `[[msvc::forceinline_calls]]`, and can be used in the same places and in the same way. The difference is that `[[msvc::flatten]]` will `[[msvc::forceinline_calls]]` all calls in the scope it's applied to recursively, until no calls are left. This may have consequences for the resulting code size growth of the function or the throughput of the compiler, which you must manage manually. From 2bb18f484b2fbd3a31113e91bdcf42d64b4c0da6 Mon Sep 17 00:00:00 2001 From: Pedro Miguel Justo Teixeira Date: Mon, 18 May 2026 11:28:10 -0700 Subject: [PATCH 1784/1799] - x64 ABI cleanup with "Content Mentor" help. - APX Calling Convention - APX setjmp/longjmp - Unwind V3 - Beta. --- docs/build/exception-handling-x64.md | 190 +++++---- docs/build/toc.yml | 2 + docs/build/x64-calling-convention.md | 98 +++-- docs/build/x64-software-conventions.md | 42 +- docs/build/x64-unwind-information-v3.md | 539 ++++++++++++++++++++++++ 5 files changed, 728 insertions(+), 143 deletions(-) create mode 100644 docs/build/x64-unwind-information-v3.md diff --git a/docs/build/exception-handling-x64.md b/docs/build/exception-handling-x64.md index 8e35eb70ffd..a0cd688e6ab 100644 --- a/docs/build/exception-handling-x64.md +++ b/docs/build/exception-handling-x64.md @@ -9,27 +9,31 @@ ms.assetid: 41fecd2d-3717-4643-b21c-65dcd2f18c93 An overview of structured exception handling and C++ exception handling coding conventions and behavior on the x64. For general information on exception handling, see [Exception Handling in Microsoft C++](../cpp/exception-handling-in-visual-cpp.md). -## Unwind data for exception handling, debugger support +## Unwind data for exception handling and debugger support -Several data structures are required for exception handling and debugging support. +To recover nonvolatile registers when an exception is handled, nonleaf functions are annotated with static data. This data, commonly referred to as "Function Unwind Information", describes how to properly unwind the function at an arbitrary instruction. This data is stored as *pdata*, or procedure data, which in turn refers to *xdata*, the exception handling data. + +The Function Unwind Information is composed of several data structures, described next. + +For Unwind Information supporting the Intel APX (Advanced Performance Extensions), see the [Unwind V3 Preview Specification](../build/x64-unwind-information-v3.md). ### struct RUNTIME_FUNCTION Table-based exception handling requires a table entry for all functions that allocate stack space or call another function (for example, nonleaf functions). Function table entries have the format: -|Size|Value| +| Size | Value | |-|-| |ULONG|Function start address| |ULONG|Function end address| |ULONG|Unwind info address| -The RUNTIME_FUNCTION structure must be DWORD aligned in memory. All addresses are image relative, that is, they're 32-bit offsets from the starting address of the image that contains the function table entry. These entries are sorted, and put in the .pdata section of a PE32+ image. For dynamically generated functions [JIT compilers], the runtime to support these functions must either use RtlInstallFunctionTableCallback or RtlAddFunctionTable to provide this information to the operating system. Failure to do so will result in unreliable exception handling and debugging of processes. +The `RUNTIME_FUNCTION` structure must be `DWORD` aligned in memory. All addresses are image relative, that is, they're 32-bit offsets from the starting address of the image that contains the function table entry. These entries are sorted, and put in the `.pdata` section of a PE32+ image. For dynamically generated functions [JIT compilers], the runtime to support these functions must either use `RtlInstallFunctionTableCallback` or `RtlAddFunctionTable` to provide this information to the operating system. Failure to do so results in unreliable exception handling and debugging of processes. ### struct UNWIND_INFO -The unwind data info structure is used to record the effects a function has on the stack pointer, and where the nonvolatile registers are saved on the stack: +The unwind data info structure records the effects a function has on the stack pointer and where the nonvolatile registers are saved on the stack: -|Size|Value| +| Size | Value | |-|-| |UBYTE: 3|Version| |UBYTE: 5|Flags| @@ -42,20 +46,20 @@ The unwind data info structure is used to record the effects a function has on t (1) Exception Handler -|Size|Value| +| Size | Value | |-|-| |ULONG|Address of exception handler| |variable|Language-specific handler data (optional)| (2) Chained Unwind Info -|Size|Value| +| Size | Value | |-|-| |ULONG|Function start address| |ULONG|Function end address| |ULONG|Unwind info address| -The UNWIND_INFO structure must be DWORD aligned in memory. Here's what each field means: +The `UNWIND_INFO` structure must be `DWORD` aligned in memory. Here's what each field means: - **Version** @@ -67,9 +71,9 @@ The UNWIND_INFO structure must be DWORD aligned in memory. Here's what each fiel |Flag|Description| |-|-| - |`UNW_FLAG_EHANDLER`| The function has an exception handler that should be called when looking for functions that need to examine exceptions.| - |`UNW_FLAG_UHANDLER`| The function has a termination handler that should be called when unwinding an exception.| - |`UNW_FLAG_CHAININFO`| This unwind info structure is not the primary one for the procedure. Instead, the chained unwind info entry is the contents of a previous RUNTIME_FUNCTION entry. For information, see [Chained unwind info structures](#chained-unwind-info-structures). If this flag is set, then the UNW_FLAG_EHANDLER and UNW_FLAG_UHANDLER flags must be cleared. Also, the frame register and fixed-stack allocation fields must have the same values as in the primary unwind info.| + |`UNW_FLAG_EHANDLER`| The function has an exception handler that the system calls when looking for functions that need to examine exceptions.| + |`UNW_FLAG_UHANDLER`| The function has a termination handler that the system calls when unwinding an exception.| + |`UNW_FLAG_CHAININFO`| This unwind info structure isn't the primary one for the procedure. Instead, the chained unwind info entry is the contents of a previous `RUNTIME_FUNCTION` entry. For information, see [Chained unwind info structures](#chained-unwind-info-structures). If this flag is set, then the `UNW_FLAG_EHANDLER` and `UNW_FLAG_UHANDLER` flags must be cleared. Also, the frame register and fixed-stack allocation fields must have the same values as in the primary unwind info.| - **Size of prolog** @@ -77,23 +81,23 @@ The UNWIND_INFO structure must be DWORD aligned in memory. Here's what each fiel - **Count of unwind codes** - The number of slots in the unwind codes array. Some unwind codes, for example, UWOP_SAVE_NONVOL, require more than one slot in the array. + The number of slots in the unwind codes array. Some unwind codes, such as `UWOP_SAVE_NONVOL`, require more than one slot in the array. - **Frame register** - If nonzero, then the function uses a frame pointer (FP), and this field is the number of the nonvolatile register used as the frame pointer, using the same encoding for the operation info field of UNWIND_CODE nodes. + If nonzero, the function uses a frame pointer (FP), and this field is the number of the nonvolatile register used as the frame pointer, using the same encoding for the operation info field of `UNWIND_CODE` nodes. - **Frame register offset (scaled)** - If the frame register field is nonzero, this field is the scaled offset from RSP that is applied to the FP register when it's established. The actual FP register is set to RSP + 16 \* this number, allowing offsets from 0 to 240. This offset permits pointing the FP register into the middle of the local stack allocation for dynamic stack frames, allowing better code density through shorter instructions. (That is, more instructions can use the 8-bit signed offset form.) + If the frame register field is nonzero, this field is the scaled offset from `RSP` that will be applied the selected Frame Pointer (FP) register value. The actual FP register is set to `RSP` + 16 \* this number, which means you can use offsets from 0 to 240. This offset points the FP register into the middle of the local stack allocation for dynamic stack frames, so you get better code density through shorter instructions. (That is, more instructions can use the 8-bit signed offset form.) - **Unwind codes array** - An array of items that explains the effect of the prolog on the nonvolatile registers and RSP. See the section on UNWIND_CODE for the meanings of individual items. For alignment purposes, this array always has an even number of entries, and the final entry is potentially unused. In that case, the array is one longer than indicated by the count of unwind codes field. + An array of items that explains the effect of the prolog on the nonvolatile registers and `RSP`. See the section on `UNWIND_CODE` for the meanings of individual items. For alignment purposes, this array always has an even number of entries, and the final entry is potentially unused. In that case, the array is one longer than indicated by the count of unwind codes field. - **Address of exception handler** - An image-relative pointer to either the function's language-specific exception or termination handler, if flag UNW_FLAG_CHAININFO is clear and one of the flags UNW_FLAG_EHANDLER or UNW_FLAG_UHANDLER is set. + An image-relative pointer to either the function's language-specific exception or termination handler, if flag `UNW_FLAG_CHAININFO` is clear and one of the flags `UNW_FLAG_EHANDLER` or `UNW_FLAG_UHANDLER` is set. - **Language-specific handler data** @@ -101,13 +105,13 @@ The UNWIND_INFO structure must be DWORD aligned in memory. Here's what each fiel - **Chained Unwind Info** - If flag UNW_FLAG_CHAININFO is set, then the UNWIND_INFO structure ends with three UWORDs. These UWORDs represent the RUNTIME_FUNCTION information for the function of the chained unwind. + If flag `UNW_FLAG_CHAININFO` is set, the `UNWIND_INFO` structure ends with three `UWORD`s. These `UWORD`s represent the `RUNTIME_FUNCTION` information for the function of the chained unwind. ### struct UNWIND_CODE -The unwind code array is used to record the sequence of operations in the prolog that affect the nonvolatile registers and RSP. Each code item has this format: +Use the unwind code array to record the sequence of operations in the prolog that affect the nonvolatile registers and `RSP`. Each code item has this format: -|Size|Value| +| Size | Value | |-|-| |UBYTE|Offset in prolog| |UBYTE: 4|Unwind operation code| @@ -121,17 +125,17 @@ Offset (from the beginning of the prolog) of the end of the instruction that per #### Unwind operation code -Note: Certain operation codes require an unsigned offset to a value in the local stack frame. This offset is from the start, that is, the lowest address of the fixed stack allocation. If the Frame Register field in the UNWIND_INFO is zero, this offset is from RSP. If the Frame Register field is nonzero, this offset is from where RSP was located when the FP register was established. It equals the FP register minus the FP register offset (16 \* the scaled frame register offset in the UNWIND_INFO). If an FP register is used, then any unwind code taking an offset must only be used after the FP register is established in the prolog. +Certain operation codes require an unsigned offset to a value in the local stack frame. This offset is from the start, that is, the lowest address of the fixed stack allocation. If the Frame Register field in the `UNWIND_INFO` is zero, this offset is from `RSP`. If the Frame Register field is nonzero, this offset is from where `RSP` was located when the FP register was established. It equals the FP register minus the FP register offset (16 \* the scaled frame register offset in the `UNWIND_INFO`). If an FP register is used, then any unwind code taking an offset must only be used after the FP register is established in the prolog. -For all opcodes except `UWOP_SAVE_XMM128` and `UWOP_SAVE_XMM128_FAR`, the offset is always a multiple of 8, because all stack values of interest are stored on 8-byte boundaries (the stack itself is always 16-byte aligned). For operation codes that take a short offset (less than 512K), the final USHORT in the nodes for this code holds the offset divided by 8. For operation codes that take a long offset (512K <= offset < 4GB), the final two USHORT nodes for this code hold the offset (in little-endian format). +For all opcodes except `UWOP_SAVE_XMM128` and `UWOP_SAVE_XMM128_FAR`, the offset is always a multiple of 8, because all stack values of interest are stored on 8-byte boundaries (the stack itself is always 16-byte aligned). For operation codes that take a short offset (less than 512K), the final `USHORT` in the nodes for this code holds the offset divided by 8. For operation codes that take a long offset (512K <= offset < 4GB), the final two `USHORT` nodes for this code hold the offset (in little-endian format). -For the opcodes `UWOP_SAVE_XMM128` and `UWOP_SAVE_XMM128_FAR`, the offset is always a multiple of 16, since all 128-bit XMM operations must occur on 16-byte aligned memory. Therefore, a scale factor of 16 is used for `UWOP_SAVE_XMM128`, permitting offsets of less than 1M. +For the opcodes `UWOP_SAVE_XMM128` and `UWOP_SAVE_XMM128_FAR`, the offset is always a multiple of 16, since all 128-bit `XMM` operations must occur on 16-byte aligned memory. Therefore, a scale factor of 16 is used for `UWOP_SAVE_XMM128`, permitting offsets of less than 1M. The unwind operation code is one of these values: - `UWOP_PUSH_NONVOL` (0) 1 node - Push a nonvolatile integer register, decrementing RSP by 8. The operation info is the number of the register. Because of the constraints on epilogs, `UWOP_PUSH_NONVOL` unwind codes must appear first in the prolog and correspondingly, last in the unwind code array. This relative ordering applies to all other unwind codes except `UWOP_PUSH_MACHFRAME`. + Push a nonvolatile integer register, decrementing `RSP` by 8. The operation info is the number of the register. Because of the constraints on epilogs, `UWOP_PUSH_NONVOL` unwind codes must appear first in the prolog and correspondingly, last in the unwind code array. This relative ordering applies to all other unwind codes except `UWOP_PUSH_MACHFRAME`. - `UWOP_ALLOC_LARGE` (1) 2 or 3 nodes @@ -151,7 +155,7 @@ The unwind operation code is one of these values: - `UWOP_SET_FPREG` (3) 1 node - Establish the frame pointer register by setting the register to some offset of the current RSP. The offset is equal to the Frame Register offset (scaled) field in the UNWIND_INFO \* 16, allowing offsets from 0 to 240. The use of an offset permits establishing a frame pointer that points to the middle of the fixed stack allocation, helping code density by allowing more accesses to use short instruction forms. The operation info field is reserved and shouldn't be used. + Establish the frame pointer register by setting the register to some offset of the current `RSP`. The offset is equal to the Frame Register offset (scaled) field in the `UNWIND_INFO` \* 16, allowing offsets from 0 to 240. The use of an offset permits establishing a frame pointer that points to the middle of the fixed stack allocation, helping code density by allowing more accesses to use short instruction forms. The operation info field is reserved and shouldn't be used. - `UWOP_SAVE_NONVOL` (4) 2 nodes @@ -163,52 +167,52 @@ The unwind operation code is one of these values: - `UWOP_SAVE_XMM128` (8) 2 nodes - Save all 128 bits of a nonvolatile XMM register on the stack. The operation info is the number of the register. The scaled-by-16 stack offset is recorded in the next slot. + Save all 128 bits of a nonvolatile `XMM` register on the stack. The operation info is the number of the register. The scaled-by-16 stack offset is recorded in the next slot. - `UWOP_SAVE_XMM128_FAR` (9) 3 nodes - Save all 128 bits of a nonvolatile XMM register on the stack with a long offset. The operation info is the number of the register. The unscaled stack offset is recorded in the next two slots. + Save all 128 bits of a nonvolatile `XMM` register on the stack with a long offset. The operation info is the number of the register. The unscaled stack offset is recorded in the next two slots. - `UWOP_PUSH_MACHFRAME` (10) 1 node - Push a machine frame. This unwind code is used to record the effect of a hardware interrupt or exception. There are two forms. If the operation info equals 0, one of these frames has been pushed on the stack: + Push a machine frame. This unwind code records the effect of a hardware interrupt or exception. It has two forms. A value of 0, indicates hardware has pushed a frame such as this on the stack: |Location|Value| |-|-| - |RSP+32|SS| - |RSP+24|Old RSP| - |RSP+16|EFLAGS| - |RSP+8|CS| - |RSP|RIP| + |`RSP`+32|`SS`| + |`RSP`+24|Old `RSP`| + |`RSP`+16|`EFLAGS`| + |`RSP`+8|`CS`| + |`RSP`|`RIP`| - If the operation info equals 1, then one of these frames has been pushed: + A value of 1, indicates hardware has pushed a frame such as this on the stack: |Location|Value| |-|-| - |RSP+40|SS| - |RSP+32|Old RSP| - |RSP+24|EFLAGS| - |RSP+16|CS| - |RSP+8|RIP| - |RSP|Error code| + |`RSP`+40|`SS`| + |`RSP`+32|Old `RSP`| + |`RSP`+24|`EFLAGS`| + |`RSP`+16|`CS`| + |`RSP`+8|`RIP`| + |`RSP`|Error code| This unwind code always appears in a dummy prolog, which is never actually executed, but instead appears before the real entry point of an interrupt routine, and exists only to provide a place to simulate the push of a machine frame. `UWOP_PUSH_MACHFRAME` records that simulation, which indicates the machine has conceptually done this operation: - 1. Pop RIP return address from top of stack into *Temp* + 1. Pop `RIP` return address from top of stack into *Temp* - 1. Push SS + 1. Push `SS` - 1. Push old RSP + 1. Push old `RSP` - 1. Push EFLAGS + 1. Push `EFLAGS` - 1. Push CS + 1. Push `CS` 1. Push *Temp* 1. Push Error Code (if op info equals 1) - The simulated `UWOP_PUSH_MACHFRAME` operation decrements RSP by 40 (op info equals 0) or 48 (op info equals 1). + The simulated `UWOP_PUSH_MACHFRAME` operation decrements `RSP` by 40 (if op info equals 0) or 48 (if op info equals 1). #### Operation info @@ -216,57 +220,57 @@ The meaning of the operation info bits depends upon the operation code. To encod |Bit|Register| |-|-| -|0|RAX| -|1|RCX| -|2|RDX| -|3|RBX| -|4|RSP| -|5|RBP| -|6|RSI| -|7|RDI| -|8 to 15|R8 to R15| +|0|`RAX`| +|1|`RCX`| +|2|`RDX`| +|3|`RBX`| +|4|`RSP`| +|5|`RBP`| +|6|`RSI`| +|7|`RDI`| +|8 to 15|`R8` to `R15`| ### Chained unwind info structures -If the UNW_FLAG_CHAININFO flag is set, then an unwind info structure is a secondary one, and the shared exception-handler/chained-info address field contains the primary unwind information. This sample code retrieves the primary unwind information, assuming that `unwindInfo` is the structure that has the UNW_FLAG_CHAININFO flag set. +If the `UNW_FLAG_CHAININFO` flag is set, then an unwind info structure is a secondary one, and the shared exception-handler/chained-info address field contains the primary unwind information. This sample code retrieves the primary unwind information, assuming that `unwindInfo` is the structure that has the `UNW_FLAG_CHAININFO` flag set. ```cpp PRUNTIME_FUNCTION primaryUwindInfo = (PRUNTIME_FUNCTION)&(unwindInfo->UnwindCode[( unwindInfo->CountOfCodes + 1 ) & ~1]); ``` -Chained info is useful in two situations. First, it can be used for noncontiguous code segments. By using chained info, you can reduce the size of the required unwind information, because you do not have to duplicate the unwind codes array from the primary unwind info. +Chained info is useful in two situations. First, it can be used for noncontiguous code segments. By using chained info, you can reduce the size of the required unwind information, because you don't have to duplicate the unwind codes array from the primary unwind info. -You can also use chained info to group volatile register saves. The compiler may delay saving some volatile registers until it is outside of the function entry prolog. You can record them by having primary unwind info for the portion of the function before the grouped code, and then setting up chained info with a non-zero size of prolog, where the unwind codes in the chained info reflect saves of the nonvolatile registers. In that case, the unwind codes are all instances of UWOP_SAVE_NONVOL. A grouping that saves nonvolatile registers by using a PUSH or modifies the RSP register by using an additional fixed stack allocation is not supported. +You can also use chained info to group volatile register saves. The compiler might delay saving some volatile registers until it is outside of the function entry prolog. You can record them by having primary unwind info for the portion of the function before the grouped code, and then setting up chained info with a nonzero size of prolog, where the unwind codes in the chained info reflect saves of the nonvolatile registers. In that case, the unwind codes are all instances of `UWOP_SAVE_NONVOL`. A grouping that saves nonvolatile registers by using a `PUSH` or modifies the `RSP` register by using an additional fixed stack allocation isn't supported. -An UNWIND_INFO item that has UNW_FLAG_CHAININFO set can contain a RUNTIME_FUNCTION entry whose UNWIND_INFO item also has UNW_FLAG_CHAININFO set, sometimes called *multiple shrink-wrapping*. Eventually, the chained unwind info pointers arrive at an UNWIND_INFO item that has UNW_FLAG_CHAININFO cleared. This item is the primary UNWIND_INFO item, which points to the actual procedure entry point. +An `UNWIND_INFO` item that has `UNW_FLAG_CHAININFO` set can contain a `RUNTIME_FUNCTION` entry whose `UNWIND_INFO` item also has `UNW_FLAG_CHAININFO` set, sometimes called *multiple shrink-wrapping*. Eventually, the chained unwind info pointers arrive at an `UNWIND_INFO` item that has `UNW_FLAG_CHAININFO` cleared. This item is the primary `UNWIND_INFO` item, which points to the actual procedure entry point. ## Unwind procedure -The unwind code array is sorted into descending order. When an exception occurs, the complete context is stored by the operating system in a context record. The exception dispatch logic is then invoked, which repeatedly executes these steps to find an exception handler: +The unwind code array is sorted into descending order. When an exception occurs, the operating system stores the complete context in a context record. The exception dispatch logic is then invoked, which repeatedly executes these steps to find an exception handler: -1. Use the current RIP stored in the context record to search for a RUNTIME_FUNCTION table entry that describes the current function (or function portion, for chained UNWIND_INFO entries). +1. Use the current `RIP` stored in the context record to search for a `RUNTIME_FUNCTION` table entry that describes the current function (or function portion, for chained `UNWIND_INFO` entries). -1. If no function table entry is found, then it's in a leaf function, and RSP directly addresses the return pointer. The return pointer at [RSP] is stored in the updated context, the simulated RSP is incremented by 8, and step 1 is repeated. +1. If the search doesn't find a function table entry, the code is assumed to be part of a leaf function, and `RSP` directly addresses the return pointer. The return pointer at [`RSP`] is stored in the updated context, the simulated `RSP` is incremented by 8, and step 1 is repeated. -1. If a function table entry is found, RIP can lie within three regions: a) in an epilog, b) in the prolog, or c) in code that may be covered by an exception handler. +1. If the search finds a function table entry, `RIP` can lie within three regions: a) in an epilog, b) in the prolog, or c) in code that might be covered by an exception handler. - - Case a) If the RIP is within an epilog, then control is leaving the function, there can be no exception handler associated with this exception for this function, and the effects of the epilog must be continued to compute the context of the caller function. To determine if the RIP is within an epilog, the code stream from RIP onward is examined. If that code stream can be matched to the trailing portion of a legitimate epilog, then it's in an epilog, and the remaining portion of the epilog is simulated, with the context record updated as each instruction is processed. After this processing, step 1 is repeated. + - Case a) If the `RIP` is within an epilog, control is leaving the function. There can be no exception handler associated with this exception for this function. The effects of the epilog must continue to compute the context of the caller function. To determine if the `RIP` is within an epilog, the code stream from `RIP` onward is examined. If that code stream matches the trailing portion of a legitimate epilog, it's in an epilog. The remaining portion of the epilog is simulated, with the context record updated as each instruction is processed. After this processing, step 1 is repeated. - - Case b) If the RIP lies within the prologue, then control hasn't entered the function, there can be no exception handler associated with this exception for this function, and the effects of the prolog must be undone to compute the context of the caller function. The RIP is within the prolog if the distance from the function start to the RIP is less than or equal to the prolog size encoded in the unwind info. The effects of the prolog are unwound by scanning forward through the unwind codes array for the first entry with an offset less than or equal to the offset of the RIP from the function start, then undoing the effect of all remaining items in the unwind code array. Step 1 is then repeated. + - Case b) If the `RIP` lies within the prolog, control hasn't entered the function. There can be no exception handler associated with this exception for this function. The effects of the prolog must be undone to compute the context of the caller function. The `RIP` is within the prolog if the distance from the function start to the `RIP` is less than or equal to the prolog size encoded in the unwind info. The unwinder scans forward through the unwind codes array for the first entry with an offset less than or equal to the offset of the `RIP` from the function start, then undoes the effect of all remaining items in the unwind code array. Step 1 is then repeated. - - Case c) If the RIP isn't within a prolog or epilog, and the function has an exception handler (UNW_FLAG_EHANDLER is set), then the language-specific handler is called. The handler scans its data and calls filter functions as appropriate. The language-specific handler can return that the exception was handled or that the search is to be continued. It can also initiate an unwind directly. + - Case c) If the `RIP` isn't within a prolog or epilog, and the function has an exception handler (`UNW_FLAG_EHANDLER` is set), the language-specific handler is called. The handler scans its data and calls filter functions as appropriate. The language-specific handler can return that the exception was handled or that the search is to be continued. It can also initiate an unwind directly. -1. If the language-specific handler returns a handled status, then execution is continued using the original context record. +1. If the language-specific handler returns a handled status, execution continues by using the original context record. -1. If there's no language-specific handler or the handler returns a "continue search" status, then the context record must be unwound to the state of the caller. It's done by processing all of the unwind code array elements, undoing the effect of each. Step 1 is then repeated. +1. If there's no language-specific handler or the handler returns a "continue search" status, the context record must be unwound to the state of the caller. The unwinder undoes the effect of each element in the unwind code array. Step 1 is then repeated. -When chained unwind info is involved, these basic steps are still followed. The only difference is that, while walking the unwind code array to unwind a prolog's effects, once the end of the array is reached, it's then linked to the parent unwind info and the entire unwind code array found there is walked. This linking continues until arriving at an unwind info without the UNW_CHAINED_INFO flag, and then it finishes walking its unwind code array. +When chained unwind info is involved, these basic steps are still followed. The only difference is that, while walking the unwind code array to unwind a prolog's effects, once the process reaches the end of the array, it links to the parent unwind info and walks the entire unwind code array found there. This linking continues until arriving at an unwind info without the `UNW_CHAINED_INFO` flag, and then it finishes walking its unwind code array. -The smallest set of unwind data is 8 bytes. This would represent a function that only allocated 128 bytes of stack or less, and possibly saved one nonvolatile register. It's also the size of a chained unwind info structure for a zero-length prolog with no unwind codes. +The smallest set of unwind data is 8 bytes. Such set represents a function that only allocated 128 bytes of stack or less, and possibly saved one nonvolatile register. It's also the size of a chained unwind info structure for a zero-length prolog with no unwind codes. ## Language-specific handler -The relative address of the language-specific handler is present in the UNWIND_INFO whenever flags UNW_FLAG_EHANDLER or UNW_FLAG_UHANDLER are set. As described in the previous section, the language-specific handler is called as part of the search for an exception handler or as part of an unwind. It has this prototype: +The `UNWIND_INFO` structure provides the relative address of the language-specific handler when either `UNW_FLAG_EHANDLER` or `UNW_FLAG_UHANDLER` flags are set. As described in the previous section, the search for an exception handler or the process of unwinding calls the language-specific handler. The handler uses this prototype: ```cpp typedef EXCEPTION_DISPOSITION (*PEXCEPTION_ROUTINE) ( @@ -298,15 +302,15 @@ typedef struct _DISPATCHER_CONTEXT { } DISPATCHER_CONTEXT, *PDISPATCHER_CONTEXT; ``` -**ControlPc** is the value of RIP within this function. This value is either an exception address or the address at which control left the establishing function. The RIP is used to determine if control is within some guarded construct inside this function, for example, a **`__try`** block for **`__try`**/**`__except`** or **`__try`**/**`__finally`**. +**ControlPc** is the value of `RIP` within this function. This value is either an exception address or the address at which control left the establishing function. The `RIP` is used to determine if control is within some guarded construct inside this function, for example, a **`__try`** block for **`__try`**/**`__except`** or **`__try`**/**`__finally`**. -**ImageBase** is the image base (load address) of the module containing this function, to be added to the 32-bit offsets used in the function entry and unwind info to record relative addresses. +**ImageBase** is the image base (load address) of the module containing this function. The 32-bit offsets used in the function entry and unwind info should be added to the ImageBase obtain the final address. -**FunctionEntry** supplies a pointer to the RUNTIME_FUNCTION function entry holding the function and unwind info image-base relative addresses for this function. +**FunctionEntry** supplies a pointer to the `RUNTIME_FUNCTION` function entry holding the function and unwind info image-base relative addresses for this function. **EstablisherFrame** is the address of the base of the fixed stack allocation for this function. -**TargetIp** Supplies an optional instruction address that specifies the continuation address of the unwind. This address is ignored if **EstablisherFrame** isn't specified. +**TargetIp** supplies an optional instruction address that specifies the continuation address of the unwind. This address is ignored if **EstablisherFrame** isn't specified. **ContextRecord** points to the exception context, for use by the system exception dispatch/unwind code. @@ -316,19 +320,19 @@ typedef struct _DISPATCHER_CONTEXT { ## Unwind helpers for MASM -In order to write proper assembly routines, there's a set of pseudo-operations that can be used in parallel with the actual assembly instructions to create the appropriate .pdata and .xdata. And, there's a set of macros that provide simplified use of the pseudo-operations for their most common uses. +To write proper assembly routines, use a set of pseudo-operations alongside the actual assembly instructions. These pseudo-operations create the appropriate `.pdata` and `.xdata`. Also, use a set of macros that simplify the use of these pseudo-operations for their most common uses. ### Raw pseudo-operations |Pseudo operation|Description| |-|-| -|PROC FRAME \[:*ehandler*]|Causes MASM to generate a function table entry in .pdata and unwind information in .xdata for a function's structured exception handling unwind behavior. If *ehandler* is present, this proc is entered in the .xdata as the language-specific handler.

    When the FRAME attribute is used, it must be followed by an .ENDPROLOG directive. If the function is a leaf function (as defined in [Function types](../build/stack-usage.md#function-types)) the FRAME attribute is unnecessary, as are the remainder of these pseudo-operations.| -|.PUSHREG *register*|Generates a UWOP_PUSH_NONVOL unwind code entry for the specified register number using the current offset in the prologue.

    Only use it with nonvolatile integer registers. For pushes of volatile registers, use an .ALLOCSTACK 8, instead| -|.SETFRAME *register*, *offset*|Fills in the frame register field and offset in the unwind information using the specified register and offset. The offset must be a multiple of 16 and less than or equal to 240. This directive also generates a UWOP_SET_FPREG unwind code entry for the specified register using the current prologue offset.| -|.ALLOCSTACK *size*|Generates a UWOP_ALLOC_SMALL or a UWOP_ALLOC_LARGE with the specified size for the current offset in the prologue.

    The *size* operand must be a multiple of 8.| -|.SAVEREG *register*, *offset*|Generates either a UWOP_SAVE_NONVOL or a UWOP_SAVE_NONVOL_FAR unwind code entry for the specified register and offset using the current prologue offset. MASM chooses the most efficient encoding.

    *offset* must be positive, and a multiple of 8. *offset* is relative to the base of the procedure's frame, which is generally in RSP, or, if using a frame pointer, the unscaled frame pointer.| -|.SAVEXMM128 *register*, *offset*|Generates either a UWOP_SAVE_XMM128 or a UWOP_SAVE_XMM128_FAR unwind code entry for the specified XMM register and offset using the current prologue offset. MASM chooses the most efficient encoding.

    *offset* must be positive, and a multiple of 16. *offset* is relative to the base of the procedure's frame, which is generally in RSP, or, if using a frame pointer, the unscaled frame pointer.| -|.PUSHFRAME \[*code*]|Generates a UWOP_PUSH_MACHFRAME unwind code entry. If the optional *code* is specified, the unwind code entry is given a modifier of 1. Otherwise the modifier is 0.| +|PROC FRAME \[:*ehandler*]|Causes MASM to generate a function table entry in `.pdata` and unwind information in `.xdata` for a function's structured exception handling unwind behavior. If *ehandler* is present, this proc is entered in the .xdata as the language-specific handler.

    When you use the FRAME attribute, follow it with an .ENDPROLOG directive. If the function is a leaf function (as defined in [Function types](../build/stack-usage.md#function-types)), the FRAME attribute is unnecessary, as are the remainder of these pseudo-operations.| +|.PUSHREG *register*|Generates a `UWOP_PUSH_NONVOL` unwind code entry for the specified register number using the current offset in the prologue.

    Only use it with nonvolatile integer registers. For pushes of volatile registers, use an .ALLOCSTACK 8, instead.| +|.SETFRAME *register*, *offset*|Fills in the frame register field and offset in the unwind information using the specified register and offset. The offset must be a multiple of 16 and less than or equal to 240. This directive also generates a `UWOP_SET_FPREG` unwind code entry for the specified register using the current prologue offset.| +|.ALLOCSTACK *size*|Generates a `UWOP_ALLOC_SMALL` or a `UWOP_ALLOC_LARGE` with the specified size for the current offset in the prologue.

    The *size* operand must be a multiple of 8.| +|.SAVEREG *register*, *offset*|Generates either a `UWOP_SAVE_NONVOL` or a `UWOP_SAVE_NONVOL_FAR` unwind code entry for the specified register and offset using the current prologue offset. MASM chooses the most efficient encoding.

    *offset* must be positive, and a multiple of 8. *offset* is relative to the base of the procedure's frame, which is generally in `RSP`, or, if using a frame pointer, the unscaled frame pointer.| +|.SAVEXMM128 *register*, *offset*|Generates either a `UWOP_SAVE_XMM128` or a `UWOP_SAVE_XMM128_FAR` unwind code entry for the specified `XMM` register and offset using the current prologue offset. MASM chooses the most efficient encoding.

    *offset* must be positive, and a multiple of 16. *offset* is relative to the base of the procedure's frame, which is generally in `RSP`, or, if using a frame pointer, the unscaled frame pointer.| +|.PUSHFRAME \[*code*]|Generates a `UWOP_PUSH_MACHFRAME` unwind code entry. If you specify the optional *code*, the unwind code entry gets a modifier of 1. Otherwise the modifier is 0.| |.ENDPROLOG|Signals the end of the prologue declarations. Must occur in the first 255 bytes of the function.| Here's a sample function prolog with proper usage of most of the opcodes: @@ -384,19 +388,19 @@ For more information about the epilog example, see [Epilog code](prolog-and-epil ### MASM macros -In order to simplify the use of the [Raw pseudo-operations](#raw-pseudo-operations), there's a set of macros, defined in ksamd64.inc, which can be used to create typical procedure prologues and epilogues. +To simplify the use of [Raw pseudo-operations](#raw-pseudo-operations), use the set of macros defined in `ksamd64.inc`. These macros help you create typical procedure prologues and epilogues. |Macro|Description| |-|-| -|alloc_stack(n)|Allocates a stack frame of n bytes (using `sub rsp, n`), and emits the appropriate unwind information (.allocstack n)| -|save_reg *reg*, *loc*|Saves a nonvolatile register *reg* on the stack at RSP offset *loc*, and emits the appropriate unwind information. (.savereg reg, loc)| -|push_reg *reg*|Pushes a nonvolatile register *reg* on the stack, and emits the appropriate unwind information. (.pushreg reg)| -|rex_push_reg *reg*|Saves a nonvolatile register on the stack using a 2-byte push, and emits the appropriate unwind information (.pushreg reg). Use this macro if the push is the first instruction in the function, to ensure that the function is hot-patchable.| -|save_xmm128 *reg*, *loc*|Saves a nonvolatile XMM register *reg* on the stack at RSP offset *loc*, and emits the appropriate unwind information (.savexmm128 reg, loc)| -|set_frame *reg*, *offset*|Sets the frame register *reg* to be the RSP + *offset* (using a `mov`, or an `lea`), and emits the appropriate unwind information (.set_frame reg, offset)| -|push_eflags|Pushes the eflags with a `pushfq` instruction, and emits the appropriate unwind information (.alloc_stack 8)| - -Here's a sample function prolog with proper usage of the macros: +|alloc_stack(n)|Allocates a stack frame of *n* bytes (using `sub rsp, n`), and emits the appropriate unwind information (.allocstack n)| +|save_reg *reg*, *loc*|Saves a nonvolatile register *reg* on the stack at `RSP` offset *loc*, and emits the appropriate unwind information (.savereg reg, loc)| +|push_reg *reg*|Pushes a nonvolatile register *reg* on the stack, and emits the appropriate unwind information (.pushreg reg)| +|rex_push_reg *reg*|Saves a nonvolatile register on the stack by using a 2-byte push, and emits the appropriate unwind information (.pushreg reg). Use this macro if the push is the first instruction in the function, to ensure that the function is hot-patchable.| +|save_xmm128 *reg*, *loc*|Saves a nonvolatile `XMM` register *reg* on the stack at `RSP` offset *loc*, and emits the appropriate unwind information (.savexmm128 reg, loc)| +|set_frame *reg*, *offset*|Sets the frame register *reg* to be the `RSP` + *offset* (using a `mov` or an `lea`), and emits the appropriate unwind information (.set_frame reg, offset)| +|push_eflags|Pushes the eflags by using a `pushfq` instruction, and emits the appropriate unwind information (.alloc_stack 8)| + +Here's a sample function prologue with proper usage of the macros: ```MASM sampleFrame struct diff --git a/docs/build/toc.yml b/docs/build/toc.yml index d9dcd53f723..639c828118b 100644 --- a/docs/build/toc.yml +++ b/docs/build/toc.yml @@ -324,6 +324,8 @@ items: href: ../build/prolog-and-epilog.md - name: x64 exception handling href: ../build/exception-handling-x64.md + - name: x64 Unwind Information V3 + href: ../build/x64-unwind-information-v3.md - name: Configure C++ projects for ARM processors expanded: false items: diff --git a/docs/build/x64-calling-convention.md b/docs/build/x64-calling-convention.md index ff47e9dfd76..955092926a1 100644 --- a/docs/build/x64-calling-convention.md +++ b/docs/build/x64-calling-convention.md @@ -19,7 +19,7 @@ There's a strict one-to-one correspondence between a function call's arguments a The x87 register stack is unused. It might be used by the callee, but consider it volatile across function calls. All floating point operations are done using the 16 XMM registers. -Integer arguments are passed in registers RCX, RDX, R8, and R9. Floating point arguments are passed in XMM0L, XMM1L, XMM2L, and XMM3L. 16-byte arguments are passed by reference. Parameter passing is described in detail in [Parameter passing](#parameter-passing). These registers, and RAX, R10, R11, XMM4, and XMM5, are considered *volatile*, or potentially changed by a callee on return. Register usage is documented in detail in [x64 register usage](x64-software-conventions.md#x64-register-usage) and [Caller/callee saved registers](#callercallee-saved-registers). +Integer arguments are passed in registers `RCX`, `RDX`, `R8`, and `R9`. Floating point arguments are passed in `XMM0L`, `XMM1L`, `XMM2L`, and `XMM3L`. 16-byte arguments are passed by reference. Parameter passing is described in detail in [Parameter passing](#parameter-passing). These registers, and `RAX`, `R10`, `R11`, `XMM4`, and `XMM5`, are considered *volatile*, or potentially changed by a callee on return. Register usage is documented in detail in [x64 register usage](x64-software-conventions.md#x64-register-usage) and [Caller/callee saved registers](#callercallee-saved-registers). For prototyped functions, all arguments are converted to the expected callee types before passing. The caller is responsible for allocating space for the callee's parameters. The caller must always allocate sufficient space to store four register parameters, even if the callee doesn't take that many parameters. This convention simplifies support for unprototyped C-language functions and vararg C/C++ functions. For vararg or unprototyped functions, any floating point values must be duplicated in the corresponding general-purpose register. Any parameters beyond the first four must be stored on the stack after the shadow store before the call. Vararg function details can be found in [Varargs](#varargs). Unprototyped function information is detailed in [Unprototyped functions](#unprototyped-functions). @@ -29,7 +29,7 @@ Most structures are aligned to their natural alignment. The primary exceptions a ## Unwindability -Leaf functions are functions that don't change any nonvolatile registers. A nonleaf function might change nonvolatile RSP, for example, by calling a function. Or, it could change RSP by allocating more stack space for local variables. To recover nonvolatile registers when an exception is handled, nonleaf functions are annotated with static data. The data describes how to properly unwind the function at an arbitrary instruction. This data is stored as *pdata*, or procedure data, which in turn refers to *xdata*, the exception handling data. The xdata contains the unwinding information, and can point to additional pdata or an exception handler function. +Leaf functions are functions that don't change any nonvolatile registers. A nonleaf function might change nonvolatile `RSP`, for example, by calling a function. Or, it could change `RSP` by allocating more stack space for local variables. To recover nonvolatile registers when an exception is handled, nonleaf functions are annotated with static data. The data describes how to properly unwind the function at an arbitrary instruction. This data is stored as *pdata*, or procedure data, which in turn refers to *xdata*, the exception handling data. The xdata contains the unwinding information, and can point to additional pdata or an exception handler function. Prologs and epilogs are highly restricted so that they can be properly described in xdata. The stack pointer must remain 16-byte aligned in any region of code that isn't part of an epilog or prolog, except within leaf functions. Leaf functions can be unwound simply by simulating a return, so pdata and xdata aren't required. For details about the proper structure of function prologs and epilogs, see [x64 prolog and epilog](../build/prolog-and-epilog.md). For more information about exception handling, and the exception handling and unwinding of pdata and xdata, see [x64 exception handling](../build/exception-handling-x64.md). @@ -37,9 +37,9 @@ Prologs and epilogs are highly restricted so that they can be properly described By default, the x64 calling convention passes the first four arguments to a function in registers. The registers used for these arguments depend on the position and type of the argument. Remaining arguments are passed on the stack in right-to-left order. The caller reserves the required stack space and writes these arguments to stack memory using store or move instructions, maintaining 8-byte alignment for each argument. -Integer valued arguments in the leftmost four positions are passed in left-to-right order in RCX, RDX, R8, and R9, respectively. The fifth and higher arguments are passed on the stack as previously described. All integer arguments in registers are right-justified, so the callee can ignore the upper bits of the register and access only the portion of the register necessary. +Integer valued arguments in the leftmost four positions are passed in left-to-right order in `RCX`, `RDX`, `R8`, and `R9`, respectively. The fifth and higher arguments are passed on the stack as previously described. All integer arguments in registers are right-justified, so the callee can ignore the upper bits of the register and access only the portion of the register necessary. -Any floating-point and double-precision arguments in the first four parameters are passed in XMM0 - XMM3, depending on position. Floating-point values are only placed in the integer registers RCX, RDX, R8, and R9 when there are varargs arguments. For details, see [Varargs](#varargs). Similarly, the XMM0 - XMM3 registers are ignored when the corresponding argument is an integer or pointer type. +Any floating-point and double-precision arguments in the first four parameters are passed in `XMM0` - `XMM3`, depending on position. Floating-point values are only placed in the integer registers `RCX`, `RDX`, `R8`, and `R9` when there are varargs arguments. For details, see [Varargs](#varargs). Similarly, the `XMM0` - `XMM3` registers are ignored when the corresponding argument is an integer or pointer type. [`__m128`](../cpp/m128.md) types, arrays, and strings are never passed by immediate value. Instead, a pointer is passed to memory allocated by the caller. Structs and unions of size 8, 16, 32, or 64 bits, and **`__m64`** types, are passed as if they were integers of the same size. Structs or unions of other sizes are passed as a pointer to memory allocated by the caller. For these aggregate types passed as a pointer, including **`__m128`**, the caller-allocated temporary memory must be 16-byte aligned. @@ -51,11 +51,11 @@ The following table summarizes how parameters are passed, by type and position f | Parameter type | fifth and higher | fourth | third | second | leftmost | |-|-|-|-|-|-| -| floating-point | stack | XMM3 | XMM2 | XMM1 | XMM0 | -| integer | stack | R9 | R8 | RDX | RCX | -| Aggregates (8, 16, 32, or 64 bits) and **`__m64`** | stack | R9 | R8 | RDX | RCX | -| Other aggregates, as pointers | stack | R9 | R8 | RDX | RCX | -| **`__m128`**, as a pointer | stack | R9 | R8 | RDX | RCX | +| floating-point | stack | `XMM3` | `XMM2` | `XMM1` | `XMM0` | +| integer | stack | `R9` | `R8` | `RDX` | `RCX` | +| Aggregates (8, 16, 32, or 64 bits) and **`__m64`** | stack | `R9` | `R8` | `RDX` | `RCX` | +| Other aggregates, as pointers | stack | `R9` | `R8` | `RDX` | `RCX` | +| **`__m128`**, as a pointer | stack | `R9` | `R8` | `RDX` | `RCX` | ### Example of argument passing 1 - all integers @@ -103,9 +103,9 @@ func2() { // RCX = 2, RDX = XMM1 = 1.0, and R8 = 7 ## Return values -A scalar return value that can fit into 64 bits, including the `__m64` type, is returned through RAX. Nonscalar types including floats, doubles, and vector types such as [`__m128`](../cpp/m128.md), [`__m128i`](../cpp/m128i.md), [`__m128d`](../cpp/m128d.md) are returned in XMM0. The state of unused bits in the value returned in RAX or XMM0 is undefined. +A scalar return value that can fit into 64 bits, including the `__m64` type, is returned through `RAX`. Nonscalar types including floats, doubles, and vector types such as [`__m128`](../cpp/m128.md), [`__m128i`](../cpp/m128i.md), [`__m128d`](../cpp/m128d.md) are returned in `XMM0`. The state of unused bits in the value returned in `RAX` or `XMM0` is undefined. -User-defined types can be returned by value from global functions and static member functions. To return a user-defined type by value in RAX, it must have a length of 1, 2, 4, 8, 16, 32, or 64 bits. It must also have no user-defined constructor, destructor, or copy assignment operator. It can have no private or protected nonstatic data members, and no nonstatic data members of reference type. It can't have base classes or virtual functions. And, it can only have data members that also meet these requirements. This definition is essentially the same as a C++03 POD type. Because the definition has changed in the C++11 standard, we don't recommend using `std::is_pod` for this test. Otherwise, the caller must allocate memory for the return value and pass a pointer to it as the first argument. The remaining arguments are then shifted one argument to the right. The same pointer must be returned by the callee in RAX. +User-defined types can be returned by value from global functions and static member functions. To return a user-defined type by value in `RAX`, it must have a length of 1, 2, 4, 8, 16, 32, or 64 bits. It must also have no user-defined constructor, destructor, or copy assignment operator. It can have no private or protected nonstatic data members, and no nonstatic data members of reference type. It can't have base classes or virtual functions. And, it can only have data members that also meet these requirements. This definition is essentially the same as a C++03 POD type. Because the definition has changed in the C++11 standard, we don't recommend using `std::is_pod` for this test. Otherwise, the caller must allocate memory for the return value and pass a pointer to it as the first argument. The remaining arguments are then shifted one argument to the right. The same pointer must be returned by the callee in `RAX`. These examples show how parameters and return values are passed for functions with the specified declarations: @@ -150,9 +150,11 @@ Struct2 func4(int a, double b, int c, float d); ## Caller/callee saved registers -The x64 ABI considers the registers RAX, RCX, RDX, R8, R9, R10, R11, and XMM0-XMM5 volatile. When present, the upper portions of YMM0-YMM15 and ZMM0-ZMM15 are also volatile. On AVX512VL, the ZMM, YMM, and XMM registers 16-31 are also volatile. When AMX support is present, the TMM tile registers are volatile. Consider volatile registers destroyed on function calls unless otherwise safety-provable by analysis such as whole program optimization. +The x64 ABI considers the registers `RAX`, `RCX`, `RDX`, `R8`, `R9`, `R10`, `R11`, and `XMM0`-`XMM5` volatile. When present, the upper portions of `YMM0`-`YMM15` and `ZMM0`-`ZMM15` are also volatile. On AVX512VL, the `ZMM`, `YMM`, and `XMM` registers 16-31 are also volatile. When AMX support is present, the `TMM` tile registers are volatile. Consider volatile registers destroyed on function calls unless otherwise safety-provable by analysis such as whole program optimization. -The x64 ABI considers registers RBX, RBP, RDI, RSI, RSP, R12, R13, R14, R15, and XMM6-XMM15 nonvolatile. They must be saved and restored by a function that uses them. +The x64 ABI considers registers `RBX`, `RBP`, `RDI`, `RSI`, `RSP`, `R12`, `R13`, `R14`, `R15`, and `XMM6`-`XMM15` nonvolatile. They must be saved and restored by a function that uses them. + +When APX support is present, registers `R16`-`R29` are volatile. `R30` and `R31` are nonvolatile. ## Function pointers @@ -160,7 +162,7 @@ Function pointers are simply pointers to the label of the respective function. T ## Floating-point support for older code -The MMX and floating-point stack registers (MM0-MM7/ST0-ST7) are preserved across context switches. There's no explicit calling convention for these registers. The use of these registers is strictly prohibited in kernel mode code. +The MMX and floating-point stack registers (`MM0`-`MM7`/`ST0`-`ST7`) are preserved across context switches. There's no explicit calling convention for these registers. The use of these registers is strictly prohibited in kernel mode code. ## FPCSR @@ -170,48 +172,84 @@ The x87 FPU control word register gets set using the following standard values a | Register\[bits] | Setting | |-|-| -| FPCSR\[0:6] | Exception masks all 1s (all exceptions masked) | -| FPCSR\[7] | Reserved - 0 | -| FPCSR\[8:9] | Precision Control - 10B (double precision) | -| FPCSR\[10:11] | Rounding control - 0 (round to nearest) | -| FPCSR\[12] | Infinity control - 0 (not used) | +| `FPCSR\[0:6]` | Exception masks all 1s (all exceptions masked) | +| `FPCSR\[7]` | Reserved - 0 | +| `FPCSR\[8:9]` | Precision Control - 10B (double precision) | +| `FPCSR\[10:11]` | Rounding control - 0 (round to nearest) | +| `FPCSR\[12]` | Infinity control - 0 (not used) | -A callee that modifies any of the fields within FPCSR must restore them before returning to its caller. Furthermore, a caller that has modified any of these fields must restore them to their standard values before invoking a callee, unless by agreement the callee expects the modified values. +A callee that modifies any of the fields within `FPCSR` must restore them before returning to its caller. Furthermore, a caller that has modified any of these fields must restore them to their standard values before invoking a callee, unless by agreement the callee expects the modified values. There are two exceptions to the rules about the nonvolatility of the control flags: -- In functions where the documented purpose of the given function is to modify the nonvolatile FPCSR flags. +- In functions where the documented purpose of the given function is to modify the nonvolatile `FPCSR` flags. - When it's provably correct that the violation of these rules results in a program that behaves the same as a program that doesn't violate the rules, for example, through whole-program analysis. +Despite being considered nonvolatile, there is no static unwind descriptor describing where it was saved and where it should be restored from. Exception-safe code which modifies `FPCSR` should resort to an exception finalizer (e.g. C++ destructor or a `__finally` clause) to restore it explicitly, when unwinding the stack. + ## MXCSR -The register state also includes MXCSR. The calling convention divides this register into a volatile portion and a nonvolatile portion. The volatile portion consists of the six status flags, in MXCSR\[0:5], while the rest of the register, MXCSR\[6:15], is considered nonvolatile. +The register state also includes `MXCSR`. The calling convention divides this register into a volatile portion and a nonvolatile portion. The volatile portion consists of the six status flags, in `MXCSR\[0:5]`, while the rest of the register, `MXCSR\[6:15]`, is considered nonvolatile. The nonvolatile portion is set to the following standard values at the start of program execution: | Register\[bits] | Setting | |-|-| -| MXCSR\[6] | Denormals are zeros - 0 | -| MXCSR\[7:12] | Exception masks all 1s (all exceptions masked) | -| MXCSR\[13:14] | Rounding control - 0 (round to nearest) | -| MXCSR\[15] | Flush to zero for masked underflow - 0 (off) | +| `MXCSR\[6]` | Denormals are zeros - 0 | +| `MXCSR\[7:12]` | Exception masks all 1s (all exceptions masked) | +| `MXCSR\[13:14]` | Rounding control - 0 (round to nearest) | +| `MXCSR\[15]` | Flush to zero for masked underflow - 0 (off) | -A callee that modifies any of the nonvolatile fields within MXCSR must restore them before returning to its caller. Furthermore, a caller that has modified any of these fields must restore them to their standard values before invoking a callee, unless by agreement the callee expects the modified values. +A callee that modifies any of the nonvolatile fields within `MXCSR` must restore them before returning to its caller. Furthermore, a caller that has modified any of these fields must restore them to their standard values before invoking a callee, unless by agreement the callee expects the modified values. There are two exceptions to the rules about the nonvolatility of the control flags: -- In functions where the documented purpose of the given function is to modify the nonvolatile MXCSR flags. +- In functions where the documented purpose of the given function is to modify the nonvolatile `MXCSR` flags. - When it's provably correct that the violation of these rules results in a program that behaves the same as a program that doesn't violate the rules, for example, through whole-program analysis. -Make no assumptions about the MXCSR register's volatile portion state across a function boundary, unless the function documentation explicitly describes it. +Make no assumptions about the `MXCSR` register's volatile portion state across a function boundary, unless the function documentation explicitly describes it. + +Despite parts of `MXCSR` being considered nonvolatile, there is no static unwind descriptor describing where it was saved and where it should be restored from. Exception-safe code which modifies the nonvolatile portions of `MXCSR` should resort to an exception finalizer (e.g. C++ destructor or a `__finally` clause) to restore it explicitly, when unwinding the stack. ## setjmp/longjmp When you include `setjmpex.h` or `setjmp.h`, all calls to [`setjmp`](../c-runtime-library/reference/setjmp.md) or [`longjmp`](../c-runtime-library/reference/longjmp.md) result in an unwind that invokes destructors and `__finally` calls. This behavior differs from x86, where including `setjmp.h` results in `__finally` clauses and destructors not being invoked. -A call to `setjmp` preserves the current stack pointer, nonvolatile registers, and MXCSR registers. Calls to `longjmp` return to the most recent `setjmp` call site and resets the stack pointer, nonvolatile registers, and MXCSR registers, back to the state as preserved by the most recent `setjmp` call. +A call to `setjmp` preserves the current stack pointer, nonvolatile registers, and `MXCSR` registers. Calls to `longjmp` return to the most recent `setjmp` call site and resets the stack pointer, nonvolatile registers, and `MXCSR` registers, back to the state as preserved by the most recent `setjmp` call. + +If APX is supported, `R30` and `R31` should not be modified in a function from the point `setjmp` is called to the point where the call which ultimately results in `longjmp` is made. This limitation is the result of `R30` and `R31` not being saved as part of `jmp_buf` - this structure definition cannot change. Instead, they are restored via the unwinder. The following example helps illustrate this point: + +```c +jmp_buf jmpbuffer; + +void function_a() { + ... + + int val = setjmp(jmpbuffer); // At this time R30 is 10 + + ... + + if (val == 0) { + function_b(); // At this time R30 is 20 + } + + ... +} + +void function_b() { + ... + + longjmp(jmpbuffer, 1); + + ... +} +``` + +In this example, the value of `R30` changes from the point where `setjmp` is called to the point `function_b` is called. In `function_b`, `longjmp` will unwind the stack until it reaches the function which called `setjmp` (`function_a` in this case). The value restored for `R30` will be `20` (the value at the point `function_b` was called), not `10` (the value at which `setjmp` was called). This means that when `setjmp` returns for the second time (as the result of `longjmp`) the value of `R30` will be set to `20` instead of `10`, which is incorrect. This is the reason why compilers should make sure `R30` and `R31` must remain constant from the point `setjmp` is called to the last place in the function which could ultimately result in `longjmp` being called. + +Since `longjmp` can be called from an exception filter (not just a sub-routine), this effectively dictates that `R30` and `R31` should remain constant from the point `setjmp` is called through the rest of the function. ## See also diff --git a/docs/build/x64-software-conventions.md b/docs/build/x64-software-conventions.md index 7f8229a5313..fdb9f859bd9 100644 --- a/docs/build/x64-software-conventions.md +++ b/docs/build/x64-software-conventions.md @@ -187,7 +187,7 @@ If you require more strict alignment, use `__declspec(align(N))` on your variabl ## x64 register usage -The x64 architecture provides for 16 general-purpose registers (hereafter referred to as integer registers) as well as 16 XMM/YMM registers available for floating-point use. Volatile registers are scratch registers presumed by the caller to be destroyed across a call. Nonvolatile registers are required to retain their values across a function call and must be saved by the callee if used. +The x64 architecture provides for 16 general-purpose registers (hereafter referred to as integer registers) as well as 16 `XMM`/`YMM` registers available for floating-point use. Volatile registers are scratch registers presumed by the caller to be destroyed across a call. Nonvolatile registers are required to retain their values across a function call and must be saved by the callee if used. ### Register volatility and preservation @@ -195,25 +195,27 @@ The following table describes how each register is used across function calls: |Register|Status|Use| |-|-|-| -|RAX|Volatile|Return value register| -|RCX|Volatile|First integer argument| -|RDX|Volatile|Second integer argument| -|R8|Volatile|Third integer argument| -|R9|Volatile|Fourth integer argument| -|R10:R11|Volatile|Must be preserved as needed by caller; used in syscall/sysret instructions| -|R12:R15|Nonvolatile|Must be preserved by callee| -|RDI|Nonvolatile|Must be preserved by callee| -|RSI|Nonvolatile|Must be preserved by callee| -|RBX|Nonvolatile|Must be preserved by callee| -|RBP|Nonvolatile|May be used as a frame pointer; must be preserved by callee| -|RSP|Nonvolatile|Stack pointer| -|XMM0, YMM0|Volatile|First FP argument; first vector-type argument when **`__vectorcall`** is used| -|XMM1, YMM1|Volatile|Second FP argument; second vector-type argument when **`__vectorcall`** is used| -|XMM2, YMM2|Volatile|Third FP argument; third vector-type argument when **`__vectorcall`** is used| -|XMM3, YMM3|Volatile|Fourth FP argument; fourth vector-type argument when **`__vectorcall`** is used| -|XMM4, YMM4|Volatile|Must be preserved as needed by caller; fifth vector-type argument when **`__vectorcall`** is used| -|XMM5, YMM5|Volatile|Must be preserved as needed by caller; sixth vector-type argument when **`__vectorcall`** is used| -|XMM6:XMM15, YMM6:YMM15|Nonvolatile (XMM), Volatile (upper half of YMM)|Must be preserved by callee. YMM registers must be preserved as needed by caller.| +|`RAX`|Volatile|Return value register| +|`RCX`|Volatile|First integer argument| +|`RDX`|Volatile|Second integer argument| +|`R8`|Volatile|Third integer argument| +|`R9`|Volatile|Fourth integer argument| +|`R10`:`R11`|Volatile|Must be preserved as needed by caller; used in syscall/sysret instructions| +|`R12`:`R15`|Nonvolatile|Must be preserved by callee| +|`R16`:`R29`|Volatile|Must be preserved by callee (APX Register)| +|`R30`:`R31`|Nonvolatile|Must be preserved by callee (APX Register)| +|`RDI`|Nonvolatile|Must be preserved by callee| +|`RSI`|Nonvolatile|Must be preserved by callee| +|`RBX`|Nonvolatile|Must be preserved by callee| +|`RBP`|Nonvolatile|May be used as a frame pointer; must be preserved by callee| +|`RSP`|Nonvolatile|Stack pointer| +|`XMM0`, `YMM0`|Volatile|First FP argument; first vector-type argument when **`__vectorcall`** is used| +|`XMM1`, `YMM1`|Volatile|Second FP argument; second vector-type argument when **`__vectorcall`** is used| +|`XMM2`, `YMM2`|Volatile|Third FP argument; third vector-type argument when **`__vectorcall`** is used| +|`XMM3`, `YMM3`|Volatile|Fourth FP argument; fourth vector-type argument when **`__vectorcall`** is used| +|`XMM4`, `YMM4`|Volatile|Must be preserved as needed by caller; fifth vector-type argument when **`__vectorcall`** is used| +|`XMM5`, `YMM5`|Volatile|Must be preserved as needed by caller; sixth vector-type argument when **`__vectorcall`** is used| +|`XMM6`:`XMM15`, `YMM6`:`YMM15`|Nonvolatile (`XMM`), Volatile (upper half of `YMM`)|Must be preserved by callee. `YMM` registers must be preserved as needed by caller.| On function exit and on function entry to C Runtime Library calls and Windows system calls, the direction flag in the CPU flags register is expected to be cleared. diff --git a/docs/build/x64-unwind-information-v3.md b/docs/build/x64-unwind-information-v3.md new file mode 100644 index 00000000000..bc519fc68f3 --- /dev/null +++ b/docs/build/x64-unwind-information-v3.md @@ -0,0 +1,539 @@ +--- +title: x64 Unwind Information V3 +description: Exception Handling Unwind Information V3 - Preview Specification +ms.date: 05/18/2026 +author: pmsjt +ms.author: pedrot +ms.reviewer: pedrot +--- + +# Exception Handling Unwind Information V3 + +## 1. Scope + +Unwind Information V3 adds support for the Intel APX (Advanced Performance Extensions). It also brings additional flexibility to the code generation allowed in both function prologues and epilogues, enabling compilers to better optimize functions as a whole. + +Unwind V3 is required for code supporting APX. Non-APX enabled code should still use the [conventional (pre-V3) Unwind Information](../build/exception-handling-x64.md). + +This is a **Preview Specification**, in Beta Stage: There's still a risk of breaking changes. Code produced under this guidance should itself be considered **Preview Code**. + +--- + +## 2. Terminology + +| Term | Definition | +|------|------------| +| **Fragment** | A contiguous region of machine code described by a single `RUNTIME_FUNCTION` / `UNWIND_INFO_V3` pair. A function might consist of a *main fragment* and zero or more *sub-fragments* [chained together](../build/exception-handling-x64.md#chained-unwind-info-structures). | +| **WOD** | Winding Operation Descriptor — a variable-length packed encoding of a single unwind operation (push, alloc, save, and so on). | +| **WOD pool** | The byte array within the payload that stores all WODs for a fragment's prolog and epilog(s). | +| **IP Offset** | A single unsigned byte giving the byte offset of an instruction relative to the start of the prolog or epilog. | +| **Payload** | The variable-length region immediately after the 4-byte `UNWIND_INFO_V3` header, sized by `PayloadWords` 16-bit words. Contains prolog IP offsets, epilog descriptors (with their IP offsets), and the WOD pool. | + +--- + +## 3. Overall Object-File Layout + +Unwind V3 reuses the existing PE/COFF `.pdata` and `.xdata` section +conventions unchanged: + +``` +.pdata — sorted array of IMAGE_AMD64_RUNTIME_FUNCTION_ENTRY (12 bytes each) +.xdata — UNWIND_INFO_V3 structures referenced by .pdata entries +``` + +Each `RUNTIME_FUNCTION` entry is: + +| Offset | Size | Field | +|--------|------|-------| +| 0 | 4 | `BeginAddress` — RVA of fragment start | +| 4 | 4 | `EndAddress` — RVA of first byte past fragment end | +| 8 | 4 | `UnwindInfoAddress` — RVA of `UNWIND_INFO_V3` in `.xdata` | + +No changes from V1/V2. + +--- + +## 4. `UNWIND_INFO_V3` Header + +All multi-byte fields are little-endian. Bit 0 is the LSB of each byte. + +``` +Byte 0: + Bits [2:0] Version = 3 + Bits [7:3] Flags (5 bits) + +Byte 1: + Bits [7:0] SizeOfProlog (8 bits) + +Byte 2: + Bits [7:0] PayloadWords (8 bits) + +Byte 3: + Bits [4:0] NumberOfOps (5 bits) + Bits [7:5] NumberOfEpilogs (3 bits) +``` + +### 4.1. Field Semantics + +| Field | Description | +|-------|-------------| +| `Version` | Must be `3`. A dumper should gate all V3 decoding on this value. | +| `Flags` | Same flag definitions as V1/V2: `UNW_FLAG_EHANDLER` (0x01), `UNW_FLAG_UHANDLER` (0x02), `UNW_FLAG_CHAININFO` (0x04). New in V3: `UNW_FLAG_LARGE` (0x08). Bit 4 reserved (zero). | +| `SizeOfProlog` | Byte offset to the start of the first instruction that isn't part of the prolog. When `UNW_FLAG_LARGE` is set, this 8-bit field is the **low byte** of a 16-bit prolog size; see §4.2. | +| `PayloadWords` | Number of **16-bit words** of payload following this header. The payload contains prolog IP offsets, all epilog descriptors (including their IP offsets), and the WOD pool. Does **not** include the exception-handler RVA or chained `RUNTIME_FUNCTION` that might follow. The algorithm to locate the handler/chain data is the same as V1/V2: `header + 4 + PayloadWords * 2`, DWORD-aligned. | +| `NumberOfOps` | Count of WODs in the prolog (0–31). Zero means no prolog. If a function needs more than 31 prolog operations, use a sub-fragment. | +| `NumberOfEpilogs` | Count of `EPILOG_INFO_V3` descriptors that follow the prolog IP offsets (0–7). Zero means no epilogs in this fragment. If more than 7 are needed, use a sub-fragment. | + +### 4.2. `UNW_FLAG_LARGE` and `UNWIND_INFO_LARGE_V3` + +When `UNW_FLAG_LARGE` is set in the header `Flags`, the first byte of +the payload is a 1-byte `UNWIND_INFO_LARGE_V3` extension: + +``` +Byte 0: + Bits [7:0] SizeOfPrologHighByte (8 bits) +``` + +`SizeOfPrologHighByte` is combined with `UNWIND_INFO_V3.SizeOfProlog` +to form a 16-bit prolog size: +`SizeOfProlog16 = (SizeOfPrologHighByte << 8) | SizeOfProlog`. + +Additionally, when `UNW_FLAG_LARGE` is set: + +- Prolog IP offset entries are **16-bit unsigned** (2 bytes each) + instead of 8-bit. + +The `UNWIND_INFO_LARGE_V3` byte is part of the payload and is included +in `PayloadWords`. The handler-offset formula remains unchanged. + +This flag is expected to be needed very rarely (prologs exceeding +255 bytes). + +### 4.3. Locating Exception Handler / Chain Info + +Identical to V1/V2: + +``` +handler_offset = ALIGN_UP(sizeof(UNWIND_INFO_V3) + PayloadWords * 2, 4) +``` + +If `UNW_FLAG_EHANDLER` or `UNW_FLAG_UHANDLER` is set, a 4-byte handler RVA is +at `handler_offset`, followed by language-specific handler data. + +If `UNW_FLAG_CHAININFO` is set, a 12-byte `RUNTIME_FUNCTION` is at +`handler_offset`. + +--- + +## 5. Payload Layout + +Immediately after the 4-byte header, the payload is arranged as follows (all +packed, `#pragma pack(1)` semantics): + +``` +┌──────────────────────────────────────────────────────────────────┐ +│ UNWIND_INFO_LARGE_V3 (only if UNW_FLAG_LARGE) │ +├──────────────────────────────────────────────────────────────────┤ +│ Prolog IP Offsets [NumberOfOps bytes (or words if LARGE)] │ +├──────────────────────────────────────────────────────────────────┤ +│ EPILOG_INFO_V3[0] │ +| EPILOG_INFO(_LARGE)_EX_V3[0] (optional) | +│ + IP Offsets[0] [NumberOfOps bytes (or words if LARGE)] │ +├──────────────────────────────────────────────────────────────────┤ +│ EPILOG_INFO_V3[1] │ +| EPILOG_INFO(_LARGE)_EX_V3[1] (optional) | +│ + IP Offsets[1] [NumberOfOps bytes (or words if LARGE)] │ +├──────────────────────────────────────────────────────────────────┤ +│ ... │ +├──────────────────────────────────────────────────────────────────┤ +│ WOD Pool [remaining bytes] │ +└──────────────────────────────────────────────────────────────────┘ + Total size = PayloadWords * 2 bytes (may include padding to fill words) +``` + +### 5.1. Prolog IP Offsets + +An array of `NumberOfOps` entries. Each entry is an unsigned byte (or an +unsigned 16-bit word when `UNW_FLAG_LARGE` is set) giving the IP offset +(from the start of the prolog / start of the fragment) of the instruction +that performs the corresponding unwind operation. + +**Ordering:** The first entry corresponds to the operation closest to the +function body (the *last* prolog instruction with an unwind effect). The last +entry corresponds to the operation closest to the function entry point (the +*first* prolog instruction). This matches the V1/V2 convention of listing +unwind codes in reverse execution order. The prolog WODs always start at byte +offset 0 of the WOD pool, and this same ordering applies. + +### 5.2. Epilog Descriptors + +Zero or more `EPILOG_INFO_V3` structures follow the prolog IP offsets. Each +can have an optional `EPILOG_INFO_EX_V3` (or `EPILOG_INFO_LARGE_EX_V3` when +the `EPILOG_INFO_LARGE` flag is set) plus its own variable-size IP offset +array, of size `NumberOfOps`: + +#### 5.2.1. When `NumberOfOps > 0` (full descriptor) + +**Standard form** (`EPILOG_INFO_LARGE` not set): + +``` +EPILOG_INFO_V3 + +Byte 0: + Bits [2:0] Flags (3 bits) + Bits [7:3] NumberOfOps (5 bits) + +Bytes 1–2: + Bits [15:0] EpilogOffset (16-bit signed) + + +EPILOG_INFO_EX_V3 + +Bytes 0–1: + Bits [15:0] FirstOp (16-bit unsigned) + +Byte 2: + Bits [7:0] IpOffsetOfLastInstruction (8 bits unsigned) + +Bytes 3 .. + IP Offset array [NumberOfOps bytes, unsigned] +``` + +**Large form** (`EPILOG_INFO_LARGE` set): + +``` +EPILOG_INFO_V3 + +Byte 0: + Bits [2:0] Flags (3 bits) + Bits [7:3] NumberOfOps (5 bits) + +Bytes 1–2: + Bits [15:0] EpilogOffset (16-bit signed) + + +EPILOG_INFO_LARGE_EX_V3 + +Bytes 0–1: + Bits [15:0] FirstOp (16-bit unsigned) + +Bytes 2–3: + Bits [15:0] IpOffsetOfLastInstruction (16 bits unsigned) + +Bytes 4 .. + IP Offset array [NumberOfOps × 2 bytes, unsigned 16-bit] +``` + +#### 5.2.2. When `NumberOfOps == 0` (inherited descriptor): 3 bytes + +``` +EPILOG_INFO_V3 + +Byte 0: + Bits [2:0] Flags (3 bits) + Bits [7:3] NumberOfOps = 0 + +Bytes 1–2: + Bits [15:0] EpilogOffset (16-bit signed) +``` + +The `Flags` bits 0 and 1, `FirstOp`, `IpOffsetOfLastInstruction`, and IP offset array are inherited from the immediately preceding `EPILOG_INFO_V3`. + +#### 5.2.3. Epilog Field Semantics + +| Field | Description | +|-------|-------------| +| `Flags` | Bit 0: `EPILOG_INFO_PARENT_FRAGMENT_TRANSFER` — set if this epilog transfers control back to the parent fragment (e.g. via JMP) rather than returning to the caller. Bit 1: `EPILOG_INFO_LARGE` — when set, the extended descriptor uses `EPILOG_INFO_LARGE_EX_V3` (16-bit `IpOffsetOfLastInstruction`) and each IP offset entry is 16-bit, accommodating epilogs exceeding 255 bytes. Expected very rarely. Bit 2: reserved (zero). | +| `NumberOfOps` | Number of WODs for this epilog (0–31). Zero is a special value meaning "inherit from previous epilog descriptor." | +| `EpilogOffset` | 16-bit signed displacement to the first instruction of this epilog. For the **first** epilog descriptor: positive values are byte offsets from the fragment start; negative values are byte offsets from the fragment tail (first byte past the end). For **subsequent** epilog descriptors: delta from the start of the previous epilog. All epilogs must use the same sign (all sorted ascending from start, or all sorted descending from tail). | +| `FirstOp` | Byte index into the WOD pool where the first WOD for this epilog resides. Since WODs are variable-length, this is a byte offset, not a WOD index. Epilogs may share WODs with the prolog or with each other by pointing into the same pool region. | +| `IpOffsetOfLastInstruction` | Unsigned byte offset (from the epilog start) of the last instruction in the epilog (typically RET or JMP). 8-bit in `EPILOG_INFO_EX_V3`; 16-bit in `EPILOG_INFO_LARGE_EX_V3`. The unwinder uses this to determine where the epilog ends and the function body resumes. | + +#### 5.2.4. Epilog IP Offsets + +Immediately after each full epilog descriptor (when `NumberOfOps > 0`), an +array of `NumberOfOps` entries gives the IP offset of each epilog instruction +that has a corresponding WOD. Each entry is an unsigned byte, or an unsigned +16-bit word when `EPILOG_INFO_LARGE` is set. Ordering: first entry = operation +closest to the body (first epilog instruction with an unwind effect), last +entry = operation closest to the control-transfer instruction. + +### 5.3. WOD Pool + +The remaining bytes in the payload form the WOD pool. The prolog's WODs +implicitly start at byte offset 0 of this pool. Each epilog's WODs start at +the byte offset given by its `FirstOp` field. WODs are packed with no alignment +or padding between them. + +The number of WODs consumed for the prolog is `UNWIND_INFO_V3.NumberOfOps`. The +number consumed for each epilog is its respective `EPILOG_INFO_V3.NumberOfOps` +(or inherited). + +--- + +## 6. WOD Encoding Reference + +WODs are variable-length (1–5 bytes), packed with `#pragma pack(1)`. The opcode +is encoded in the **low-order bits** of the first byte. Decoding requires +multi-level bit inspection. + +### 6.1. Opcode Dispatch Table + +To decode a WOD, read the first byte and test low bits in the following order: + +| Test | Opcode Value | WOD Type | Size | +|------|--------------|----------|------| +| `byte[0] == 0x00` | 0 | `WOD_SET_FPREG` | 2 bytes | +| `byte[0] == 0x01` | 1 | `WOD_ALLOC_HUGE` | 5 bytes | +| `byte[0] == 0x02` | 2 | `WOD_ALLOC_LARGE` | 3 bytes | +| `byte[0] == 0x03` | 3 | `WOD_PUSH_CANONICAL_FRAME` | 2 bytes | +| `(byte[0] & 0x07) == 0x04` | 4 | `WOD_PUSH` | 1 byte | +| `(byte[0] & 0x07) == 0x05` | 5 | `WOD_SAVE_NONVOL_FAR` | 5 bytes | +| `(byte[0] & 0x07) == 0x06` | 6 | `WOD_SAVE_NONVOL` | 3 bytes | +| `(byte[0] & 0x07) == 0x07` | 7 | `WOD_PUSH_CONSECUTIVE_2` | 1 byte | +| `(byte[0] & 0x0F) == 0x08` | 8 | `WOD_ALLOC_SMALL` | 1 byte | +| `(byte[0] & 0x0F) == 0x09` | 9 | `WOD_SAVE_XMM128_FAR` | 5 bytes | +| `(byte[0] & 0x0F) == 0x0A` | 10 | `WOD_SAVE_XMM128` | 3 bytes | +| `(byte[0] & 0x3F) == 0x20` | 32 | `WOD_PUSH2` | 2 bytes | + +**Decoding algorithm (pseudocode):** + +```c +uint8_t b0 = pool[offset]; + +if (b0 <= 0x03) { + // 8-bit opcode: exact match on entire byte + switch (b0) { + case 0x00: return WOD_SET_FPREG; + case 0x01: return WOD_ALLOC_HUGE; + case 0x02: return WOD_ALLOC_LARGE; + case 0x03: return WOD_PUSH_CANONICAL_FRAME; + } +} else if ((b0 & 0x07) >= 0x04) { + // 3-bit opcode + switch (b0 & 0x07) { + case 0x04: return WOD_PUSH; + case 0x05: return WOD_SAVE_NONVOL_FAR; + case 0x06: return WOD_SAVE_NONVOL; + case 0x07: return WOD_PUSH_CONSECUTIVE_2; + } +} else if ((b0 & 0x0F) >= 0x08 && (b0 & 0x0F) <= 0x0A) { + // 4-bit opcode + switch (b0 & 0x0F) { + case 0x08: return WOD_ALLOC_SMALL; + case 0x09: return WOD_SAVE_XMM128_FAR; + case 0x0A: return WOD_SAVE_XMM128; + } +} else if ((b0 & 0x3F) == 0x20) { + // 6-bit opcode + return WOD_PUSH2; +} +return INVALID; +``` + +A cleaner approach: match from the shortest prefix (3-bit) upward, +since the 8-bit opcodes use values 0–3 which don't conflict with any +3-bit prefix pattern (the 3-bit opcodes occupy values 4–7): + +```c +uint8_t b0 = pool[offset]; +uint8_t op3 = b0 & 0x07; + +switch (op3) { +case 4: return WOD_PUSH; // 3-bit opcode = 100b +case 5: return WOD_SAVE_NONVOL_FAR;// 3-bit opcode = 101b +case 6: return WOD_SAVE_NONVOL; // 3-bit opcode = 110b +case 7: return WOD_PUSH_CONSECUTIVE_2; // 3-bit opcode = 111b +default: break; // bits[2:0] are 0b000, 0b001, 0b010, or 0b011 +} + +uint8_t op4 = b0 & 0x0F; +switch (op4) { +case 0x08: return WOD_ALLOC_SMALL; +case 0x09: return WOD_SAVE_XMM128_FAR; +case 0x0A: return WOD_SAVE_XMM128; +default: break; +} + +uint8_t op6 = b0 & 0x3F; +if (op6 == 0x20) return WOD_PUSH2; + +// 8-bit opcode (full byte match) +switch (b0) { +case 0x00: return WOD_SET_FPREG; +case 0x01: return WOD_ALLOC_HUGE; +case 0x02: return WOD_ALLOC_LARGE; +case 0x03: return WOD_PUSH_CANONICAL_FRAME; +default: return INVALID; +} +``` + +### 6.2. WOD Layouts (Bit-Level) + +All bit positions are numbered LSB-first within each byte. Multi-byte integer +fields are little-endian. + +#### 6.2.1. `WOD_PUSH` — 1 byte + +``` +Byte 0: [2:0] = 100b (opcode 4) + [7:3] = Register (5 bits, AMD64 integer register number) +``` + +**Effect:** `PUSH ` — adjusts RSP by 8 and stores register. + +#### 6.2.2. `WOD_PUSH2` — 2 bytes + +``` +Byte 0: [5:0] = 100000b (opcode 32) + [7:6] = Register1[1:0] (low 2 bits) +Byte 1: [2:0] = Register1[4:2] (high 3 bits) + [7:3] = Register2 (5 bits) +``` + +**Effect:** `PUSH2 , ` — pushes two registers with a single +instruction (APX). Adjusts RSP by 16. + +#### 6.2.3. `WOD_PUSH_CONSECUTIVE_2` — 1 byte + +``` +Byte 0: [2:0] = 111b (opcode 7) + [7:3] = Register (5 bits) +``` + +**Effect:** Pushes `Register` and `Register+1` consecutively. Adjusts `RSP` +by 16 total. `Register` value must be limited to [0, 30], as value of 31 would place `Register+1` out of bounds. + +#### 6.2.4. `WOD_ALLOC_SMALL` — 1 byte + +``` +Byte 0: [3:0] = 1000b (opcode 8) + [7:4] = Size (4 bits) +``` + +**Actual allocation:** `(Size + 1) * 8` bytes. Range: 8–128 bytes in steps +of 8. + +#### 6.2.5. `WOD_ALLOC_LARGE` — 3 bytes + +``` +Byte 0: [7:0] = 0x02 (opcode 2) +Bytes 1–2: Size (16-bit unsigned, little-endian) +``` + +**Actual allocation:** `Size * 8` bytes. Range: up to 524,280 bytes. + +#### 6.2.6. `WOD_ALLOC_HUGE` — 5 bytes + +``` +Byte 0: [7:0] = 0x01 (opcode 1) +Bytes 1–4: Size (32-bit unsigned, little-endian) +``` + +**Actual allocation:** Raw byte count (no scaling). Range: up to 4 GiB. + +#### 6.2.7. `WOD_SET_FPREG` — 2 bytes + +``` +Byte 0: [7:0] = 0x00 (opcode 0) +Byte 1: [3:0] = Register (4 bits, 0–15) + [7:4] = Offset (4 bits) +``` + +**Effect:** Establishes a frame pointer. ` = RSP + Offset * 16`. + +#### 6.2.8. `WOD_SAVE_NONVOL` — 3 bytes + +``` +Byte 0: [2:0] = 110b (opcode 6) + [7:3] = Register (5 bits) +Bytes 1–2: Displacement (16-bit unsigned, little-endian) +``` + +**Effect:** `MOV [RSP + Displacement * 8], ` — saves a non-volatile +integer register to the stack. + +#### 6.2.9. `WOD_SAVE_NONVOL_FAR` — 5 bytes + +``` +Byte 0: [2:0] = 101b (opcode 5) + [7:3] = Register (5 bits) +Bytes 1–4: Displacement (32-bit unsigned, little-endian) +``` + +**Effect:** Same as `WOD_SAVE_NONVOL` but with a 32-bit unscaled byte +displacement. Used when the offset doesn't fit in 16 bits scaled by 8. + +#### 6.2.10. `WOD_SAVE_XMM128` — 3 bytes + +``` +Byte 0: [3:0] = 1010b (opcode 10) + [7:4] = Register (4 bits, XMM0–XMM15) +Bytes 1–2: Displacement (16-bit unsigned, little-endian) +``` + +**Effect:** `MOVAPS [RSP + Displacement * 16], ` — saves a 128-bit +XMM register. + +#### 6.2.11. `WOD_SAVE_XMM128_FAR` — 5 bytes + +``` +Byte 0: [3:0] = 1001b (opcode 9) + [7:4] = Register (4 bits, XMM0–XMM15) +Bytes 1–4: Displacement (32-bit unsigned, little-endian) +``` + +**Effect:** Same as `WOD_SAVE_XMM128` but with a 32-bit unscaled byte +displacement. + +#### 6.2.12. `WOD_PUSH_CANONICAL_FRAME` — 2 bytes + +``` +Byte 0: [7:0] = 0x03 (opcode 3) +Byte 1: [7:0] = Type (8 bits) +``` + +**Effect:** Indicates the hardware/OS pushed a canonical frame onto the +stack. Type values distinguish: +- Machine frame without error code +- Machine frame with error code +- Machine frame with shadow-stack push +- Context record + +(Exact type values are defined by the OS; consult the Windows SDK headers.) + +### 6.3. Opcode Constant Summary + +```c +#define WOD_OP_SET_FPREG 0 // 8-bit opcode, 2 bytes +#define WOD_OP_ALLOC_HUGE 1 // 8-bit opcode, 5 bytes +#define WOD_OP_ALLOC_LARGE 2 // 8-bit opcode, 3 bytes +#define WOD_OP_PUSH_CANONICAL_FRAME 3 // 8-bit opcode, 2 bytes +#define WOD_OP_PUSH 4 // 3-bit opcode, 1 byte +#define WOD_OP_SAVE_NONVOL_FAR 5 // 3-bit opcode, 5 bytes +#define WOD_OP_SAVE_NONVOL 6 // 3-bit opcode, 3 bytes +#define WOD_OP_PUSH_CONSECUTIVE_2 7 // 3-bit opcode, 1 byte +#define WOD_OP_ALLOC_SMALL 8 // 4-bit opcode, 1 byte +#define WOD_OP_SAVE_XMM128_FAR 9 // 4-bit opcode, 5 bytes +#define WOD_OP_SAVE_XMM128 10 // 4-bit opcode, 3 bytes +#define WOD_OP_PUSH2 32 // 6-bit opcode, 2 bytes +``` + +### 6.4. Register Encoding + +Integer registers use the standard AMD64 numbering (5 bits, 0–31): + +| Value | Register | +|-------|----------| +| 0 | RAX | +| 1 | RCX | +| 2 | RDX | +| 3 | RBX | +| 4 | RSP | +| 5 | RBP | +| 6 | RSI | +| 7 | RDI | +| 8 - 15 | R8 - R15 +| 16 - 31 | R16 - R31 (APX) | + +XMM register fields are 4 bits (0–15), mapping directly to XMM0–XMM15. From edcad4c1c5781c771628a9391fc07f158cd3e10f Mon Sep 17 00:00:00 2001 From: Pedro Miguel Justo Teixeira Date: Mon, 18 May 2026 12:14:55 -0700 Subject: [PATCH 1785/1799] Add "omissions" to the list of potential hazards with Beta specs. --- docs/build/x64-unwind-information-v3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/x64-unwind-information-v3.md b/docs/build/x64-unwind-information-v3.md index bc519fc68f3..e2b001f84bf 100644 --- a/docs/build/x64-unwind-information-v3.md +++ b/docs/build/x64-unwind-information-v3.md @@ -15,7 +15,7 @@ Unwind Information V3 adds support for the Intel APX (Advanced Performance Exten Unwind V3 is required for code supporting APX. Non-APX enabled code should still use the [conventional (pre-V3) Unwind Information](../build/exception-handling-x64.md). -This is a **Preview Specification**, in Beta Stage: There's still a risk of breaking changes. Code produced under this guidance should itself be considered **Preview Code**. +This is a **Preview Specification**, in Beta Stage: There's still a risk of breaking changes or omissions. Code produced under this guidance should itself be considered **Preview Code**. --- From 423035fa63ee2cf75c2bc76d148104fb5f3051d8 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 19 May 2026 09:18:17 -0700 Subject: [PATCH 1786/1799] add link to blog post --- docs/build/profile-guided-optimizations.md | 2 +- docs/build/sample-profile-guided-optimization.md | 2 ++ 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/build/profile-guided-optimizations.md b/docs/build/profile-guided-optimizations.md index d171360f143..2da31ddff99 100644 --- a/docs/build/profile-guided-optimizations.md +++ b/docs/build/profile-guided-optimizations.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["profile-guided optimizations", "optimization, profile-gui Profile-guided optimization (PGO) lets you optimize a whole executable file. The optimizer uses data from test runs of the .exe or .dll file. The data represents the likely performance of the program in a production environment. > [!NOTE] -> SPGO (Sample Profile-Guided Optimization) is an alternative approach that uses hardware CPU Windows Performance Counters instead of instrumentation. SPGO requires no instrumented build - you profile an existing release binary by using `xperf`. For more information, see [Sample Profile-Guided Optimization (SPGO) tutorial](sample-profile-guided-optimization.md). +> SPGO (Sample Profile-Guided Optimization) is an alternative approach that uses hardware CPU Windows Performance Counters instead of instrumentation. SPGO requires no instrumented build - you profile an existing release binary by using `xperf`. For more information, see [Introducing Sample Profile Guided Optimization in MSVC](https://devblogs.microsoft.com/cppblog/introducing-sample-profile-guided-optimization-in-msvc/) and [Sample Profile-Guided Optimization (SPGO) tutorial](sample-profile-guided-optimization.md). Profile-guided optimizations are only available for x86, x64, or ARM64 native targets. Profile-guided optimizations aren't available for executable files that run on the common language runtime. Even if you produce an assembly with mixed native and managed code (by using the **/clr** compiler option), you can't use profile-guided optimization on just the native code. If you attempt to build a project with these options set in the IDE, a build error results. diff --git a/docs/build/sample-profile-guided-optimization.md b/docs/build/sample-profile-guided-optimization.md index 084be1122e3..f9f2df002ca 100644 --- a/docs/build/sample-profile-guided-optimization.md +++ b/docs/build/sample-profile-guided-optimization.md @@ -14,6 +14,8 @@ SPGO takes a different approach. Instead of instrumenting your binary and runnin Because SPGO profiles release bits instead of instrumented builds, it enables much more flexibility in where and how you collect data. You can gather runtime profiles from production servers, developer machines, performance labs, or any combination. The result is a binary that runs hot paths more efficiently, with a typical performance speedup of 5-15% depending on the quality of the profile data. +For more information about Sample Profile‑Guided Optimization (PGO) in MSVC and how it improves performance using sampling‑based profiling, see [Introducing Sample Profile Guided Optimization in MSVC](https://devblogs.microsoft.com/cppblog/introducing-sample-profile-guided-optimization-in-msvc/) + In this tutorial, you walk through the complete SPGO workflow: build a sample app, profile it by using `xperf`, prepare the profile data, and rebuild with the profile data. When you finish, you can apply the same process to your own projects. ## Prerequisites From e61067551f92a1c7beaad20c04b9f5ccfd2b5dd6 Mon Sep 17 00:00:00 2001 From: Pedro Miguel Justo Teixeira Date: Wed, 20 May 2026 10:50:56 -0700 Subject: [PATCH 1787/1799] Feedback batch. --- docs/build/exception-handling-x64.md | 8 ++--- docs/build/x64-calling-convention.md | 4 +-- docs/build/x64-unwind-information-v3.md | 47 +++---------------------- 3 files changed, 11 insertions(+), 48 deletions(-) diff --git a/docs/build/exception-handling-x64.md b/docs/build/exception-handling-x64.md index a0cd688e6ab..efb1eac2d73 100644 --- a/docs/build/exception-handling-x64.md +++ b/docs/build/exception-handling-x64.md @@ -71,8 +71,8 @@ The `UNWIND_INFO` structure must be `DWORD` aligned in memory. Here's what each |Flag|Description| |-|-| - |`UNW_FLAG_EHANDLER`| The function has an exception handler that the system calls when looking for functions that need to examine exceptions.| - |`UNW_FLAG_UHANDLER`| The function has a termination handler that the system calls when unwinding an exception.| + |`UNW_FLAG_EHANDLER`| The function has an exception handler that the operating system calls to examine the state of the exception and potentially handle it. Language features such as the C `__try` clause register such a handler.| + |`UNW_FLAG_UHANDLER`| The function has a termination handler that the operation system calls when unwinding the stack. This handler could release resources allocated by the function in exception safe code. Language features such as local C++ object destructors and C `__finally` clauses register such a termination handler. | |`UNW_FLAG_CHAININFO`| This unwind info structure isn't the primary one for the procedure. Instead, the chained unwind info entry is the contents of a previous `RUNTIME_FUNCTION` entry. For information, see [Chained unwind info structures](#chained-unwind-info-structures). If this flag is set, then the `UNW_FLAG_EHANDLER` and `UNW_FLAG_UHANDLER` flags must be cleared. Also, the frame register and fixed-stack allocation fields must have the same values as in the primary unwind info.| - **Size of prolog** @@ -89,11 +89,11 @@ The `UNWIND_INFO` structure must be `DWORD` aligned in memory. Here's what each - **Frame register offset (scaled)** - If the frame register field is nonzero, this field is the scaled offset from `RSP` that will be applied the selected Frame Pointer (FP) register value. The actual FP register is set to `RSP` + 16 \* this number, which means you can use offsets from 0 to 240. This offset points the FP register into the middle of the local stack allocation for dynamic stack frames, so you get better code density through shorter instructions. (That is, more instructions can use the 8-bit signed offset form.) + This field is a scaled offset between the `RSP` register value and the selected Frame Pointer (FP) register value. The selected FP register is set to `RSP` + 16 * this number, which means you can use offsets from 0 to 240. This offset points the FP register into the middle of the local stack allocation for dynamic stack frames, so you get better code density through shorter instructions. (That is, more instructions can use the 8-bit signed offset form.) - **Unwind codes array** - An array of items that explains the effect of the prolog on the nonvolatile registers and `RSP`. See the section on `UNWIND_CODE` for the meanings of individual items. For alignment purposes, this array always has an even number of entries, and the final entry is potentially unused. In that case, the array is one longer than indicated by the count of unwind codes field. + An array of items that explains the effect of the prolog on the nonvolatile registers and `RSP`. See the section on [Unwind operations code](#unwind-operation-code) for the meanings of individual items. To maintain proper data alignment, this array always contains an even number of entries, and the final entry may be unused. In that case, the array is one longer than indicated by the count of unwind codes field. - **Address of exception handler** diff --git a/docs/build/x64-calling-convention.md b/docs/build/x64-calling-convention.md index 955092926a1..a1265ca7cfc 100644 --- a/docs/build/x64-calling-convention.md +++ b/docs/build/x64-calling-convention.md @@ -219,7 +219,7 @@ When you include `setjmpex.h` or `setjmp.h`, all calls to [`setjmp`](../c-runtim A call to `setjmp` preserves the current stack pointer, nonvolatile registers, and `MXCSR` registers. Calls to `longjmp` return to the most recent `setjmp` call site and resets the stack pointer, nonvolatile registers, and `MXCSR` registers, back to the state as preserved by the most recent `setjmp` call. -If APX is supported, `R30` and `R31` should not be modified in a function from the point `setjmp` is called to the point where the call which ultimately results in `longjmp` is made. This limitation is the result of `R30` and `R31` not being saved as part of `jmp_buf` - this structure definition cannot change. Instead, they are restored via the unwinder. The following example helps illustrate this point: +If APX is supported, `R30` and `R31` should not be modified in a function from the point `setjmp` is called to the point where the call which ultimately results in `longjmp` is made. This limitation is the result of `R30` and `R31` not being saved as part of `jmp_buf` - this structure definition cannot change. Instead, they are restored via the unwinder. The following example demonstrates how the difference on how the data is restored influences this restriction: ```c jmp_buf jmpbuffer; @@ -247,7 +247,7 @@ void function_b() { } ``` -In this example, the value of `R30` changes from the point where `setjmp` is called to the point `function_b` is called. In `function_b`, `longjmp` will unwind the stack until it reaches the function which called `setjmp` (`function_a` in this case). The value restored for `R30` will be `20` (the value at the point `function_b` was called), not `10` (the value at which `setjmp` was called). This means that when `setjmp` returns for the second time (as the result of `longjmp`) the value of `R30` will be set to `20` instead of `10`, which is incorrect. This is the reason why compilers should make sure `R30` and `R31` must remain constant from the point `setjmp` is called to the last place in the function which could ultimately result in `longjmp` being called. +In this example, the value of `R30` changes from the point where `setjmp` is called to the point `function_b` is called. In `function_b`, `longjmp` unwinds the stack until it reaches the function which called `setjmp` (`function_a` in this case). The value restored for `R30` will be `20` (the value at the point `function_b` was called), not `10` (the value at which `setjmp` was called). This means that when `setjmp` returns for the second time (as the result of `longjmp`) the value of `R30` will be set to `20` instead of `10`, which is incorrect. This is why compilers must ensure `R30` and `R31` remain constant from the point `setjmp` is called to the last place in the function which could ultimately result in `longjmp` being called. Since `longjmp` can be called from an exception filter (not just a sub-routine), this effectively dictates that `R30` and `R31` should remain constant from the point `setjmp` is called through the rest of the function. diff --git a/docs/build/x64-unwind-information-v3.md b/docs/build/x64-unwind-information-v3.md index e2b001f84bf..377c9c7d7df 100644 --- a/docs/build/x64-unwind-information-v3.md +++ b/docs/build/x64-unwind-information-v3.md @@ -23,11 +23,11 @@ This is a **Preview Specification**, in Beta Stage: There's still a risk of brea | Term | Definition | |------|------------| -| **Fragment** | A contiguous region of machine code described by a single `RUNTIME_FUNCTION` / `UNWIND_INFO_V3` pair. A function might consist of a *main fragment* and zero or more *sub-fragments* [chained together](../build/exception-handling-x64.md#chained-unwind-info-structures). | +| **Fragment** | A contiguous region of machine code described by a single `RUNTIME_FUNCTION` / `UNWIND_INFO_V3` pair. A function might consist of a *main fragment* and zero or more *sub-fragments* chained together. For more information see [Chained unwind info structures](../build/exception-handling-x64.md#chained-unwind-info-structures). | | **WOD** | Winding Operation Descriptor — a variable-length packed encoding of a single unwind operation (push, alloc, save, and so on). | | **WOD pool** | The byte array within the payload that stores all WODs for a fragment's prolog and epilog(s). | -| **IP Offset** | A single unsigned byte giving the byte offset of an instruction relative to the start of the prolog or epilog. | -| **Payload** | The variable-length region immediately after the 4-byte `UNWIND_INFO_V3` header, sized by `PayloadWords` 16-bit words. Contains prolog IP offsets, epilog descriptors (with their IP offsets), and the WOD pool. | +| **IP Offset** | The unsigned byte offset of an instruction relative to the start of the prolog or epilog. | +| **Payload** | The variable-length region immediately after the 4-byte `UNWIND_INFO_V3` header, sized by `PayloadWords` 16-bit words. Contains the large prolog extension, prolog IP offsets, epilog descriptors (with their IP offsets), and the WOD pool. | --- @@ -77,7 +77,7 @@ Byte 3: | Field | Description | |-------|-------------| -| `Version` | Must be `3`. A dumper should gate all V3 decoding on this value. | +| `Version` | Must be `3`. | | `Flags` | Same flag definitions as V1/V2: `UNW_FLAG_EHANDLER` (0x01), `UNW_FLAG_UHANDLER` (0x02), `UNW_FLAG_CHAININFO` (0x04). New in V3: `UNW_FLAG_LARGE` (0x08). Bit 4 reserved (zero). | | `SizeOfProlog` | Byte offset to the start of the first instruction that isn't part of the prolog. When `UNW_FLAG_LARGE` is set, this 8-bit field is the **low byte** of a 16-bit prolog size; see §4.2. | | `PayloadWords` | Number of **16-bit words** of payload following this header. The payload contains prolog IP offsets, all epilog descriptors (including their IP offsets), and the WOD pool. Does **not** include the exception-handler RVA or chained `RUNTIME_FUNCTION` that might follow. The algorithm to locate the handler/chain data is the same as V1/V2: `header + 4 + PayloadWords * 2`, DWORD-aligned. | @@ -296,44 +296,7 @@ To decode a WOD, read the first byte and test low bits in the following order: | `(byte[0] & 0x0F) == 0x0A` | 10 | `WOD_SAVE_XMM128` | 3 bytes | | `(byte[0] & 0x3F) == 0x20` | 32 | `WOD_PUSH2` | 2 bytes | -**Decoding algorithm (pseudocode):** - -```c -uint8_t b0 = pool[offset]; - -if (b0 <= 0x03) { - // 8-bit opcode: exact match on entire byte - switch (b0) { - case 0x00: return WOD_SET_FPREG; - case 0x01: return WOD_ALLOC_HUGE; - case 0x02: return WOD_ALLOC_LARGE; - case 0x03: return WOD_PUSH_CANONICAL_FRAME; - } -} else if ((b0 & 0x07) >= 0x04) { - // 3-bit opcode - switch (b0 & 0x07) { - case 0x04: return WOD_PUSH; - case 0x05: return WOD_SAVE_NONVOL_FAR; - case 0x06: return WOD_SAVE_NONVOL; - case 0x07: return WOD_PUSH_CONSECUTIVE_2; - } -} else if ((b0 & 0x0F) >= 0x08 && (b0 & 0x0F) <= 0x0A) { - // 4-bit opcode - switch (b0 & 0x0F) { - case 0x08: return WOD_ALLOC_SMALL; - case 0x09: return WOD_SAVE_XMM128_FAR; - case 0x0A: return WOD_SAVE_XMM128; - } -} else if ((b0 & 0x3F) == 0x20) { - // 6-bit opcode - return WOD_PUSH2; -} -return INVALID; -``` - -A cleaner approach: match from the shortest prefix (3-bit) upward, -since the 8-bit opcodes use values 0–3 which don't conflict with any -3-bit prefix pattern (the 3-bit opcodes occupy values 4–7): +** WOD decoding algorithm (pseudocode):** ```c uint8_t b0 = pool[offset]; From d290f0ce4401abe4141cee58572e8a64374de585 Mon Sep 17 00:00:00 2001 From: Pedro Miguel Justo Teixeira Date: Wed, 20 May 2026 11:44:17 -0700 Subject: [PATCH 1788/1799] Feedback batch --- docs/build/x64-unwind-information-v3.md | 313 +++++++++--------------- 1 file changed, 120 insertions(+), 193 deletions(-) diff --git a/docs/build/x64-unwind-information-v3.md b/docs/build/x64-unwind-information-v3.md index 377c9c7d7df..303d2cbe4d7 100644 --- a/docs/build/x64-unwind-information-v3.md +++ b/docs/build/x64-unwind-information-v3.md @@ -9,21 +9,21 @@ ms.reviewer: pedrot # Exception Handling Unwind Information V3 -## 1. Scope +## Scope Unwind Information V3 adds support for the Intel APX (Advanced Performance Extensions). It also brings additional flexibility to the code generation allowed in both function prologues and epilogues, enabling compilers to better optimize functions as a whole. Unwind V3 is required for code supporting APX. Non-APX enabled code should still use the [conventional (pre-V3) Unwind Information](../build/exception-handling-x64.md). -This is a **Preview Specification**, in Beta Stage: There's still a risk of breaking changes or omissions. Code produced under this guidance should itself be considered **Preview Code**. +Unwind Information V3 is a preview specification. There's still a risk of breaking changes or omissions. Code produced under this guidance should itself be considered Preview Code. --- -## 2. Terminology +## Terminology | Term | Definition | |------|------------| -| **Fragment** | A contiguous region of machine code described by a single `RUNTIME_FUNCTION` / `UNWIND_INFO_V3` pair. A function might consist of a *main fragment* and zero or more *sub-fragments* chained together. For more information see [Chained unwind info structures](../build/exception-handling-x64.md#chained-unwind-info-structures). | +| **Fragment** | A contiguous region of machine code described by a single `RUNTIME_FUNCTION` / `UNWIND_INFO_V3` pair. A function might consist of a *main fragment* and zero or more *subfragments* chained together. For more information see [Chained unwind info structures](../build/exception-handling-x64.md#chained-unwind-info-structures). | | **WOD** | Winding Operation Descriptor — a variable-length packed encoding of a single unwind operation (push, alloc, save, and so on). | | **WOD pool** | The byte array within the payload that stores all WODs for a fragment's prolog and epilog(s). | | **IP Offset** | The unsigned byte offset of an instruction relative to the start of the prolog or epilog. | @@ -31,7 +31,7 @@ This is a **Preview Specification**, in Beta Stage: There's still a risk of brea --- -## 3. Overall Object-File Layout +## Overall Object-File Layout Unwind V3 reuses the existing PE/COFF `.pdata` and `.xdata` section conventions unchanged: @@ -53,63 +53,49 @@ No changes from V1/V2. --- -## 4. `UNWIND_INFO_V3` Header +## `UNWIND_INFO_V3` Header All multi-byte fields are little-endian. Bit 0 is the LSB of each byte. -``` -Byte 0: - Bits [2:0] Version = 3 - Bits [7:3] Flags (5 bits) - -Byte 1: - Bits [7:0] SizeOfProlog (8 bits) +| Byte | Bits | Field | Width | +|------|------|-------|-------| +| 0 | [2:0] | `Version` (= 3) | 3 bits | +| 0 | [7:3] | `Flags` | 5 bits | +| 1 | [7:0] | `SizeOfProlog` | 8 bits | +| 2 | [7:0] | `PayloadWords` | 8 bits | +| 3 | [4:0] | `NumberOfOps` | 5 bits | +| 3 | [7:5] | `NumberOfEpilogs` | 3 bits | -Byte 2: - Bits [7:0] PayloadWords (8 bits) - -Byte 3: - Bits [4:0] NumberOfOps (5 bits) - Bits [7:5] NumberOfEpilogs (3 bits) -``` - -### 4.1. Field Semantics +### Field Semantics | Field | Description | |-------|-------------| | `Version` | Must be `3`. | | `Flags` | Same flag definitions as V1/V2: `UNW_FLAG_EHANDLER` (0x01), `UNW_FLAG_UHANDLER` (0x02), `UNW_FLAG_CHAININFO` (0x04). New in V3: `UNW_FLAG_LARGE` (0x08). Bit 4 reserved (zero). | -| `SizeOfProlog` | Byte offset to the start of the first instruction that isn't part of the prolog. When `UNW_FLAG_LARGE` is set, this 8-bit field is the **low byte** of a 16-bit prolog size; see §4.2. | -| `PayloadWords` | Number of **16-bit words** of payload following this header. The payload contains prolog IP offsets, all epilog descriptors (including their IP offsets), and the WOD pool. Does **not** include the exception-handler RVA or chained `RUNTIME_FUNCTION` that might follow. The algorithm to locate the handler/chain data is the same as V1/V2: `header + 4 + PayloadWords * 2`, DWORD-aligned. | -| `NumberOfOps` | Count of WODs in the prolog (0–31). Zero means no prolog. If a function needs more than 31 prolog operations, use a sub-fragment. | -| `NumberOfEpilogs` | Count of `EPILOG_INFO_V3` descriptors that follow the prolog IP offsets (0–7). Zero means no epilogs in this fragment. If more than 7 are needed, use a sub-fragment. | +| `SizeOfProlog` | Byte offset to the start of the first instruction that isn't part of the prolog. When `UNW_FLAG_LARGE` is set, this 8-bit field is the low byte of a 16-bit prolog size. For more information on the 16-bit form see [`UNW_FLAG_LARGE` and `UNWIND_INFO_LARGE_V3`](#unw_flag_large-and-unwind_info_large_v3). | +| `PayloadWords` | Number of 16-bit words of payload following this header. The payload contains prolog IP offsets, all epilog descriptors (including their IP offsets), and the WOD pool. Does not include the exception-handler RVA or chained `RUNTIME_FUNCTION` that might follow. The algorithm to locate the handler/chain data is the same as V1/V2: `header + 4 + PayloadWords * 2`, DWORD-aligned. | +| `NumberOfOps` | Count of WODs in the prolog (0–31). Zero means no prolog. If a function needs more than 31 prolog operations, use a subfragment. | +| `NumberOfEpilogs` | Count of `EPILOG_INFO_V3` descriptors that follow the prolog IP offsets (0–7). Zero means no epilogs in this fragment. If more than 7 are needed, use a subfragment. | -### 4.2. `UNW_FLAG_LARGE` and `UNWIND_INFO_LARGE_V3` +### `UNW_FLAG_LARGE` and `UNWIND_INFO_LARGE_V3` -When `UNW_FLAG_LARGE` is set in the header `Flags`, the first byte of -the payload is a 1-byte `UNWIND_INFO_LARGE_V3` extension: +When `UNW_FLAG_LARGE` is set in the header `Flags`, the first byte of the payload is a 1-byte `UNWIND_INFO_LARGE_V3` extension: -``` -Byte 0: - Bits [7:0] SizeOfPrologHighByte (8 bits) -``` +| Byte | Bits | Field | Width | +|------|------|-------|-------| +| 0 | [7:0] | `SizeOfPrologHighByte` | 8 bits | -`SizeOfPrologHighByte` is combined with `UNWIND_INFO_V3.SizeOfProlog` -to form a 16-bit prolog size: -`SizeOfProlog16 = (SizeOfPrologHighByte << 8) | SizeOfProlog`. +`SizeOfPrologHighByte` is combined with `UNWIND_INFO_V3.SizeOfProlog` to form a 16-bit prolog size: `SizeOfProlog16 = (SizeOfPrologHighByte << 8) | SizeOfProlog`. Additionally, when `UNW_FLAG_LARGE` is set: -- Prolog IP offset entries are **16-bit unsigned** (2 bytes each) - instead of 8-bit. +- Prolog IP offset entries are 16-bit unsigned (2 bytes each) instead of 8-bit. -The `UNWIND_INFO_LARGE_V3` byte is part of the payload and is included -in `PayloadWords`. The handler-offset formula remains unchanged. +The `UNWIND_INFO_LARGE_V3` byte is part of the payload and is included in `PayloadWords`. The handler-offset formula remains unchanged. -This flag is expected to be needed very rarely (prologs exceeding -255 bytes). +This flag is expected to be needed very rarely (prologs exceeding 255 bytes). -### 4.3. Locating Exception Handler / Chain Info +### Locating Exception Handler / Chain Info Identical to V1/V2: @@ -117,169 +103,113 @@ Identical to V1/V2: handler_offset = ALIGN_UP(sizeof(UNWIND_INFO_V3) + PayloadWords * 2, 4) ``` -If `UNW_FLAG_EHANDLER` or `UNW_FLAG_UHANDLER` is set, a 4-byte handler RVA is -at `handler_offset`, followed by language-specific handler data. +If `UNW_FLAG_EHANDLER` or `UNW_FLAG_UHANDLER` is set, a 4-byte handler RVA is at `handler_offset`, followed by language-specific handler data. -If `UNW_FLAG_CHAININFO` is set, a 12-byte `RUNTIME_FUNCTION` is at -`handler_offset`. +If `UNW_FLAG_CHAININFO` is set, a 12-byte `RUNTIME_FUNCTION` is at `handler_offset`. --- -## 5. Payload Layout +## Payload Layout -Immediately after the 4-byte header, the payload is arranged as follows (all -packed, `#pragma pack(1)` semantics): +Immediately after the 4-byte header, the payload is arranged in the following order (all packed, `#pragma pack(1)` semantics): -``` -┌──────────────────────────────────────────────────────────────────┐ -│ UNWIND_INFO_LARGE_V3 (only if UNW_FLAG_LARGE) │ -├──────────────────────────────────────────────────────────────────┤ -│ Prolog IP Offsets [NumberOfOps bytes (or words if LARGE)] │ -├──────────────────────────────────────────────────────────────────┤ -│ EPILOG_INFO_V3[0] │ -| EPILOG_INFO(_LARGE)_EX_V3[0] (optional) | -│ + IP Offsets[0] [NumberOfOps bytes (or words if LARGE)] │ -├──────────────────────────────────────────────────────────────────┤ -│ EPILOG_INFO_V3[1] │ -| EPILOG_INFO(_LARGE)_EX_V3[1] (optional) | -│ + IP Offsets[1] [NumberOfOps bytes (or words if LARGE)] │ -├──────────────────────────────────────────────────────────────────┤ -│ ... │ -├──────────────────────────────────────────────────────────────────┤ -│ WOD Pool [remaining bytes] │ -└──────────────────────────────────────────────────────────────────┘ - Total size = PayloadWords * 2 bytes (may include padding to fill words) -``` - -### 5.1. Prolog IP Offsets - -An array of `NumberOfOps` entries. Each entry is an unsigned byte (or an -unsigned 16-bit word when `UNW_FLAG_LARGE` is set) giving the IP offset -(from the start of the prolog / start of the fragment) of the instruction -that performs the corresponding unwind operation. +1. `UNWIND_INFO_LARGE_V3` — 1 byte, present only if `UNW_FLAG_LARGE` is set. +1. Prolog IP Offsets — `NumberOfOps` bytes (or 16-bit words if `UNW_FLAG_LARGE`). +1. For each epilog (repeated `NumberOfEpilogs` times): + - `EPILOG_INFO_V3` descriptor. + - `EPILOG_INFO_EX_V3` or `EPILOG_INFO_LARGE_EX_V3` extended descriptor (present only when `NumberOfOps > 0`). + - IP Offset array — `NumberOfOps` bytes (or 16-bit words if `EPILOG_INFO_LARGE`). +1. WOD Pool — remaining bytes. -**Ordering:** The first entry corresponds to the operation closest to the -function body (the *last* prolog instruction with an unwind effect). The last -entry corresponds to the operation closest to the function entry point (the -*first* prolog instruction). This matches the V1/V2 convention of listing -unwind codes in reverse execution order. The prolog WODs always start at byte -offset 0 of the WOD pool, and this same ordering applies. +Total size = `PayloadWords` × 2 bytes (may include padding to fill words). -### 5.2. Epilog Descriptors +### Prolog IP Offsets -Zero or more `EPILOG_INFO_V3` structures follow the prolog IP offsets. Each -can have an optional `EPILOG_INFO_EX_V3` (or `EPILOG_INFO_LARGE_EX_V3` when -the `EPILOG_INFO_LARGE` flag is set) plus its own variable-size IP offset -array, of size `NumberOfOps`: +An array of `NumberOfOps` entries. Each entry is an unsigned byte (or an unsigned 16-bit word when `UNW_FLAG_LARGE` is set) giving the IP offset (from the start of the prolog / start of the fragment) of the instruction that performs the corresponding unwind operation. -#### 5.2.1. When `NumberOfOps > 0` (full descriptor) +**Ordering:** The first entry corresponds to the operation closest to the function body (the *last* prolog instruction with an unwind effect). The last entry corresponds to the operation closest to the function entry point (the *first* prolog instruction). This matches the V1/V2 convention of listing unwind codes in reverse execution order. The prolog WODs always start at byte offset 0 of the WOD pool, and this same ordering applies. -**Standard form** (`EPILOG_INFO_LARGE` not set): - -``` -EPILOG_INFO_V3 +### Epilog Descriptors -Byte 0: - Bits [2:0] Flags (3 bits) - Bits [7:3] NumberOfOps (5 bits) +Zero or more `EPILOG_INFO_V3` structures follow the prolog IP offsets. Each can have an optional `EPILOG_INFO_EX_V3` (or `EPILOG_INFO_LARGE_EX_V3` when the `EPILOG_INFO_LARGE` flag is set) plus its own variable-size IP offset array, of size `NumberOfOps`: -Bytes 1–2: - Bits [15:0] EpilogOffset (16-bit signed) +#### When `NumberOfOps > 0` (full descriptor) +**Standard form** (`EPILOG_INFO_LARGE` not set): -EPILOG_INFO_EX_V3 +`EPILOG_INFO_V3`: -Bytes 0–1: - Bits [15:0] FirstOp (16-bit unsigned) +| Byte | Bits | Field | Width | +|------|------|-------|-------| +| 0 | [2:0] | `Flags` | 3 bits | +| 0 | [7:3] | `NumberOfOps` | 5 bits | +| 1–2 | [15:0] | `EpilogOffset` | 16-bit signed | -Byte 2: - Bits [7:0] IpOffsetOfLastInstruction (8 bits unsigned) +`EPILOG_INFO_EX_V3`: -Bytes 3 .. - IP Offset array [NumberOfOps bytes, unsigned] -``` +| Byte | Bits | Field | Width | +|------|------|-------|-------| +| 0–1 | [15:0] | `FirstOp` | 16-bit unsigned | +| 2 | [7:0] | `IpOffsetOfLastInstruction` | 8 bits unsigned | +| 3 .. | — | IP Offset array | `NumberOfOps` bytes, unsigned | **Large form** (`EPILOG_INFO_LARGE` set): -``` -EPILOG_INFO_V3 +`EPILOG_INFO_V3`: -Byte 0: - Bits [2:0] Flags (3 bits) - Bits [7:3] NumberOfOps (5 bits) +| Byte | Bits | Field | Width | +|------|------|-------|-------| +| 0 | [2:0] | `Flags` | 3 bits | +| 0 | [7:3] | `NumberOfOps` | 5 bits | +| 1–2 | [15:0] | `EpilogOffset` | 16-bit signed | -Bytes 1–2: - Bits [15:0] EpilogOffset (16-bit signed) +`EPILOG_INFO_LARGE_EX_V3`: +| Byte | Bits | Field | Width | +|------|------|-------|-------| +| 0–1 | [15:0] | `FirstOp` | 16-bit unsigned | +| 2–3 | [15:0] | `IpOffsetOfLastInstruction` | 16 bits unsigned | +| 4 .. | — | IP Offset array | `NumberOfOps` × 2 bytes, unsigned 16-bit | -EPILOG_INFO_LARGE_EX_V3 +#### When `NumberOfOps == 0` (inherited descriptor) -Bytes 0–1: - Bits [15:0] FirstOp (16-bit unsigned) +`EPILOG_INFO_V3`: -Bytes 2–3: - Bits [15:0] IpOffsetOfLastInstruction (16 bits unsigned) - -Bytes 4 .. - IP Offset array [NumberOfOps × 2 bytes, unsigned 16-bit] -``` - -#### 5.2.2. When `NumberOfOps == 0` (inherited descriptor): 3 bytes - -``` -EPILOG_INFO_V3 - -Byte 0: - Bits [2:0] Flags (3 bits) - Bits [7:3] NumberOfOps = 0 - -Bytes 1–2: - Bits [15:0] EpilogOffset (16-bit signed) -``` +| Byte | Bits | Field | Width | +|------|------|-------|-------| +| 0 | [2:0] | `Flags` | 3 bits | +| 0 | [7:3] | `NumberOfOps` (= 0) | 5 bits | +| 1–2 | [15:0] | `EpilogOffset` | 16-bit signed | The `Flags` bits 0 and 1, `FirstOp`, `IpOffsetOfLastInstruction`, and IP offset array are inherited from the immediately preceding `EPILOG_INFO_V3`. -#### 5.2.3. Epilog Field Semantics +#### Epilog Field Semantics | Field | Description | |-------|-------------| | `Flags` | Bit 0: `EPILOG_INFO_PARENT_FRAGMENT_TRANSFER` — set if this epilog transfers control back to the parent fragment (e.g. via JMP) rather than returning to the caller. Bit 1: `EPILOG_INFO_LARGE` — when set, the extended descriptor uses `EPILOG_INFO_LARGE_EX_V3` (16-bit `IpOffsetOfLastInstruction`) and each IP offset entry is 16-bit, accommodating epilogs exceeding 255 bytes. Expected very rarely. Bit 2: reserved (zero). | | `NumberOfOps` | Number of WODs for this epilog (0–31). Zero is a special value meaning "inherit from previous epilog descriptor." | -| `EpilogOffset` | 16-bit signed displacement to the first instruction of this epilog. For the **first** epilog descriptor: positive values are byte offsets from the fragment start; negative values are byte offsets from the fragment tail (first byte past the end). For **subsequent** epilog descriptors: delta from the start of the previous epilog. All epilogs must use the same sign (all sorted ascending from start, or all sorted descending from tail). | +| `EpilogOffset` | 16-bit signed displacement to the first instruction of this epilog. For the first epilog descriptor: positive values are byte offsets from the fragment start; negative values are byte offsets from the fragment tail (first byte past the end). For subsequent epilog descriptors: delta from the start of the previous epilog. All epilogs must use the same sign (all sorted ascending from start, or all sorted descending from tail). | | `FirstOp` | Byte index into the WOD pool where the first WOD for this epilog resides. Since WODs are variable-length, this is a byte offset, not a WOD index. Epilogs may share WODs with the prolog or with each other by pointing into the same pool region. | | `IpOffsetOfLastInstruction` | Unsigned byte offset (from the epilog start) of the last instruction in the epilog (typically RET or JMP). 8-bit in `EPILOG_INFO_EX_V3`; 16-bit in `EPILOG_INFO_LARGE_EX_V3`. The unwinder uses this to determine where the epilog ends and the function body resumes. | -#### 5.2.4. Epilog IP Offsets - -Immediately after each full epilog descriptor (when `NumberOfOps > 0`), an -array of `NumberOfOps` entries gives the IP offset of each epilog instruction -that has a corresponding WOD. Each entry is an unsigned byte, or an unsigned -16-bit word when `EPILOG_INFO_LARGE` is set. Ordering: first entry = operation -closest to the body (first epilog instruction with an unwind effect), last -entry = operation closest to the control-transfer instruction. +#### Epilog IP Offsets -### 5.3. WOD Pool +Immediately after each full epilog descriptor (when `NumberOfOps > 0`), an array of `NumberOfOps` entries gives the IP offset of each epilog instruction that has a corresponding WOD. Each entry is an unsigned byte, or an unsigned 16-bit word when `EPILOG_INFO_LARGE` is set. Ordering: first entry = operation closest to the body (first epilog instruction with an unwind effect), last entry = operation closest to the control-transfer instruction. -The remaining bytes in the payload form the WOD pool. The prolog's WODs -implicitly start at byte offset 0 of this pool. Each epilog's WODs start at -the byte offset given by its `FirstOp` field. WODs are packed with no alignment -or padding between them. +### WOD Pool -The number of WODs consumed for the prolog is `UNWIND_INFO_V3.NumberOfOps`. The -number consumed for each epilog is its respective `EPILOG_INFO_V3.NumberOfOps` -(or inherited). +The remaining bytes in the payload form the WOD pool. The prolog's WODs implicitly start at byte offset 0 of this pool. Each epilog's WODs start at the byte offset given by its `FirstOp` field. WODs are packed with no alignment or padding between them. ---- +The number of WODs consumed for the prolog is `UNWIND_INFO_V3.NumberOfOps`. The number consumed for each epilog is its respective `EPILOG_INFO_V3.NumberOfOps` (or inherited). -## 6. WOD Encoding Reference +## WOD Encoding Reference -WODs are variable-length (1–5 bytes), packed with `#pragma pack(1)`. The opcode -is encoded in the **low-order bits** of the first byte. Decoding requires -multi-level bit inspection. +WODs are variable-length (1–5 bytes), packed with `#pragma pack(1)`. The opcode is encoded in the **low-order bits** of the first byte. Decoding requires multi-level bit inspection. -### 6.1. Opcode Dispatch Table +### Opcode Dispatch Table -To decode a WOD, read the first byte and test low bits in the following order: +To decode a WOD, read the first byte and test its low bits in the following order: | Test | Opcode Value | WOD Type | Size | |------|--------------|----------|------| @@ -302,7 +232,8 @@ To decode a WOD, read the first byte and test low bits in the following order: uint8_t b0 = pool[offset]; uint8_t op3 = b0 & 0x07; -switch (op3) { +switch (op3) +{ case 4: return WOD_PUSH; // 3-bit opcode = 100b case 5: return WOD_SAVE_NONVOL_FAR;// 3-bit opcode = 101b case 6: return WOD_SAVE_NONVOL; // 3-bit opcode = 110b @@ -311,7 +242,8 @@ default: break; // bits[2:0] are 0b000, 0b001, 0b010, or 0b011 } uint8_t op4 = b0 & 0x0F; -switch (op4) { +switch (op4) +{ case 0x08: return WOD_ALLOC_SMALL; case 0x09: return WOD_SAVE_XMM128_FAR; case 0x0A: return WOD_SAVE_XMM128; @@ -322,7 +254,8 @@ uint8_t op6 = b0 & 0x3F; if (op6 == 0x20) return WOD_PUSH2; // 8-bit opcode (full byte match) -switch (b0) { +switch (b0) +{ case 0x00: return WOD_SET_FPREG; case 0x01: return WOD_ALLOC_HUGE; case 0x02: return WOD_ALLOC_LARGE; @@ -331,21 +264,20 @@ default: return INVALID; } ``` -### 6.2. WOD Layouts (Bit-Level) +### WOD layouts (Bit-Level) -All bit positions are numbered LSB-first within each byte. Multi-byte integer -fields are little-endian. +All bit positions are numbered LSB-first within each byte. Multi-byte integer fields are little-endian. -#### 6.2.1. `WOD_PUSH` — 1 byte +#### `WOD_PUSH` — 1 byte ``` Byte 0: [2:0] = 100b (opcode 4) [7:3] = Register (5 bits, AMD64 integer register number) ``` -**Effect:** `PUSH ` — adjusts RSP by 8 and stores register. +**Effect:** `PUSH ` adjusts RSP by 8 and stores register. -#### 6.2.2. `WOD_PUSH2` — 2 bytes +#### `WOD_PUSH2` — 2 bytes ``` Byte 0: [5:0] = 100000b (opcode 32) @@ -354,20 +286,18 @@ Byte 1: [2:0] = Register1[4:2] (high 3 bits) [7:3] = Register2 (5 bits) ``` -**Effect:** `PUSH2 , ` — pushes two registers with a single -instruction (APX). Adjusts RSP by 16. +**Effect:** `PUSH2 , ` pushes two registers with a single instruction (APX). Adjusts RSP by 16. -#### 6.2.3. `WOD_PUSH_CONSECUTIVE_2` — 1 byte +#### `WOD_PUSH_CONSECUTIVE_2` — 1 byte ``` Byte 0: [2:0] = 111b (opcode 7) [7:3] = Register (5 bits) ``` -**Effect:** Pushes `Register` and `Register+1` consecutively. Adjusts `RSP` -by 16 total. `Register` value must be limited to [0, 30], as value of 31 would place `Register+1` out of bounds. +**Effect:** Pushes `Register` and `Register+1` consecutively. Adjusts `RSP` by 16 total. `Register` value must be limited to [0, 30], as value of 31 would place `Register+1` out of bounds. -#### 6.2.4. `WOD_ALLOC_SMALL` — 1 byte +#### `WOD_ALLOC_SMALL` — 1 byte ``` Byte 0: [3:0] = 1000b (opcode 8) @@ -377,7 +307,7 @@ Byte 0: [3:0] = 1000b (opcode 8) **Actual allocation:** `(Size + 1) * 8` bytes. Range: 8–128 bytes in steps of 8. -#### 6.2.5. `WOD_ALLOC_LARGE` — 3 bytes +#### `WOD_ALLOC_LARGE` — 3 bytes ``` Byte 0: [7:0] = 0x02 (opcode 2) @@ -386,7 +316,7 @@ Bytes 1–2: Size (16-bit unsigned, little-endian) **Actual allocation:** `Size * 8` bytes. Range: up to 524,280 bytes. -#### 6.2.6. `WOD_ALLOC_HUGE` — 5 bytes +#### `WOD_ALLOC_HUGE` — 5 bytes ``` Byte 0: [7:0] = 0x01 (opcode 1) @@ -395,7 +325,7 @@ Bytes 1–4: Size (32-bit unsigned, little-endian) **Actual allocation:** Raw byte count (no scaling). Range: up to 4 GiB. -#### 6.2.7. `WOD_SET_FPREG` — 2 bytes +#### `WOD_SET_FPREG` — 2 bytes ``` Byte 0: [7:0] = 0x00 (opcode 0) @@ -405,7 +335,7 @@ Byte 1: [3:0] = Register (4 bits, 0–15) **Effect:** Establishes a frame pointer. ` = RSP + Offset * 16`. -#### 6.2.8. `WOD_SAVE_NONVOL` — 3 bytes +#### `WOD_SAVE_NONVOL` — 3 bytes ``` Byte 0: [2:0] = 110b (opcode 6) @@ -413,10 +343,10 @@ Byte 0: [2:0] = 110b (opcode 6) Bytes 1–2: Displacement (16-bit unsigned, little-endian) ``` -**Effect:** `MOV [RSP + Displacement * 8], ` — saves a non-volatile +**Effect:** `MOV [RSP + Displacement * 8], ` saves a non-volatile integer register to the stack. -#### 6.2.9. `WOD_SAVE_NONVOL_FAR` — 5 bytes +#### `WOD_SAVE_NONVOL_FAR` — 5 bytes ``` Byte 0: [2:0] = 101b (opcode 5) @@ -424,10 +354,9 @@ Byte 0: [2:0] = 101b (opcode 5) Bytes 1–4: Displacement (32-bit unsigned, little-endian) ``` -**Effect:** Same as `WOD_SAVE_NONVOL` but with a 32-bit unscaled byte -displacement. Used when the offset doesn't fit in 16 bits scaled by 8. +**Effect:** Same as `WOD_SAVE_NONVOL` but with a 32-bit unscaled byte displacement. Used when the offset doesn't fit in 16 bits scaled by 8. -#### 6.2.10. `WOD_SAVE_XMM128` — 3 bytes +#### `WOD_SAVE_XMM128` — 3 bytes ``` Byte 0: [3:0] = 1010b (opcode 10) @@ -435,10 +364,10 @@ Byte 0: [3:0] = 1010b (opcode 10) Bytes 1–2: Displacement (16-bit unsigned, little-endian) ``` -**Effect:** `MOVAPS [RSP + Displacement * 16], ` — saves a 128-bit +**Effect:** `MOVAPS [RSP + Displacement * 16], ` saves a 128-bit XMM register. -#### 6.2.11. `WOD_SAVE_XMM128_FAR` — 5 bytes +#### `WOD_SAVE_XMM128_FAR` — 5 bytes ``` Byte 0: [3:0] = 1001b (opcode 9) @@ -446,18 +375,16 @@ Byte 0: [3:0] = 1001b (opcode 9) Bytes 1–4: Displacement (32-bit unsigned, little-endian) ``` -**Effect:** Same as `WOD_SAVE_XMM128` but with a 32-bit unscaled byte -displacement. +**Effect:** Same as `WOD_SAVE_XMM128` but with a 32-bit unscaled byte displacement. -#### 6.2.12. `WOD_PUSH_CANONICAL_FRAME` — 2 bytes +#### `WOD_PUSH_CANONICAL_FRAME` — 2 bytes ``` Byte 0: [7:0] = 0x03 (opcode 3) Byte 1: [7:0] = Type (8 bits) ``` -**Effect:** Indicates the hardware/OS pushed a canonical frame onto the -stack. Type values distinguish: +**Effect:** Indicates the hardware/OS pushed a canonical frame onto the stack. Type values distinguish: - Machine frame without error code - Machine frame with error code - Machine frame with shadow-stack push @@ -465,7 +392,7 @@ stack. Type values distinguish: (Exact type values are defined by the OS; consult the Windows SDK headers.) -### 6.3. Opcode Constant Summary +### Opcode Constant Summary ```c #define WOD_OP_SET_FPREG 0 // 8-bit opcode, 2 bytes @@ -482,7 +409,7 @@ stack. Type values distinguish: #define WOD_OP_PUSH2 32 // 6-bit opcode, 2 bytes ``` -### 6.4. Register Encoding +### Register Encoding Integer registers use the standard AMD64 numbering (5 bits, 0–31): From 62e5f50758abf84977d98fe6b991fd8a569e50e3 Mon Sep 17 00:00:00 2001 From: Pedro Miguel Justo Teixeira Date: Wed, 20 May 2026 11:48:48 -0700 Subject: [PATCH 1789/1799] Feedback batch --- docs/build/x64-unwind-information-v3.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/build/x64-unwind-information-v3.md b/docs/build/x64-unwind-information-v3.md index 303d2cbe4d7..03e9a1524ab 100644 --- a/docs/build/x64-unwind-information-v3.md +++ b/docs/build/x64-unwind-information-v3.md @@ -28,6 +28,7 @@ Unwind Information V3 is a preview specification. There's still a risk of breaki | **WOD pool** | The byte array within the payload that stores all WODs for a fragment's prolog and epilog(s). | | **IP Offset** | The unsigned byte offset of an instruction relative to the start of the prolog or epilog. | | **Payload** | The variable-length region immediately after the 4-byte `UNWIND_INFO_V3` header, sized by `PayloadWords` 16-bit words. Contains the large prolog extension, prolog IP offsets, epilog descriptors (with their IP offsets), and the WOD pool. | +| **RVA** | Relative Virtual Address — an offset from the base address of the image at load time. | --- @@ -49,7 +50,7 @@ Each `RUNTIME_FUNCTION` entry is: | 4 | 4 | `EndAddress` — RVA of first byte past fragment end | | 8 | 4 | `UnwindInfoAddress` — RVA of `UNWIND_INFO_V3` in `.xdata` | -No changes from V1/V2. +No changes from V1 or V2. --- @@ -71,9 +72,9 @@ All multi-byte fields are little-endian. Bit 0 is the LSB of each byte. | Field | Description | |-------|-------------| | `Version` | Must be `3`. | -| `Flags` | Same flag definitions as V1/V2: `UNW_FLAG_EHANDLER` (0x01), `UNW_FLAG_UHANDLER` (0x02), `UNW_FLAG_CHAININFO` (0x04). New in V3: `UNW_FLAG_LARGE` (0x08). Bit 4 reserved (zero). | +| `Flags` | Same flag definitions as V1 or V2: `UNW_FLAG_EHANDLER` (0x01), `UNW_FLAG_UHANDLER` (0x02), `UNW_FLAG_CHAININFO` (0x04). New in V3: `UNW_FLAG_LARGE` (0x08). Bit 4 reserved (zero). | | `SizeOfProlog` | Byte offset to the start of the first instruction that isn't part of the prolog. When `UNW_FLAG_LARGE` is set, this 8-bit field is the low byte of a 16-bit prolog size. For more information on the 16-bit form see [`UNW_FLAG_LARGE` and `UNWIND_INFO_LARGE_V3`](#unw_flag_large-and-unwind_info_large_v3). | -| `PayloadWords` | Number of 16-bit words of payload following this header. The payload contains prolog IP offsets, all epilog descriptors (including their IP offsets), and the WOD pool. Does not include the exception-handler RVA or chained `RUNTIME_FUNCTION` that might follow. The algorithm to locate the handler/chain data is the same as V1/V2: `header + 4 + PayloadWords * 2`, DWORD-aligned. | +| `PayloadWords` | Number of 16-bit words of payload following this header. The payload contains prolog IP offsets, all epilog descriptors (including their IP offsets), and the WOD pool. Does not include the exception-handler RVA or chained `RUNTIME_FUNCTION` that might follow. The algorithm to locate the handler/chain data is the same as V1 or V2: `header + 4 + PayloadWords * 2`, DWORD-aligned. | | `NumberOfOps` | Count of WODs in the prolog (0–31). Zero means no prolog. If a function needs more than 31 prolog operations, use a subfragment. | | `NumberOfEpilogs` | Count of `EPILOG_INFO_V3` descriptors that follow the prolog IP offsets (0–7). Zero means no epilogs in this fragment. If more than 7 are needed, use a subfragment. | @@ -97,7 +98,7 @@ This flag is expected to be needed very rarely (prologs exceeding 255 bytes). ### Locating Exception Handler / Chain Info -Identical to V1/V2: +Identical to V1 or V2: ``` handler_offset = ALIGN_UP(sizeof(UNWIND_INFO_V3) + PayloadWords * 2, 4) @@ -127,7 +128,7 @@ Total size = `PayloadWords` × 2 bytes (may include padding to fill words). An array of `NumberOfOps` entries. Each entry is an unsigned byte (or an unsigned 16-bit word when `UNW_FLAG_LARGE` is set) giving the IP offset (from the start of the prolog / start of the fragment) of the instruction that performs the corresponding unwind operation. -**Ordering:** The first entry corresponds to the operation closest to the function body (the *last* prolog instruction with an unwind effect). The last entry corresponds to the operation closest to the function entry point (the *first* prolog instruction). This matches the V1/V2 convention of listing unwind codes in reverse execution order. The prolog WODs always start at byte offset 0 of the WOD pool, and this same ordering applies. +**Ordering:** The first entry corresponds to the operation closest to the function body (the *last* prolog instruction with an unwind effect). The last entry corresponds to the operation closest to the function entry point (the *first* prolog instruction). This matches the V1 or V2 convention of listing unwind codes in reverse execution order. The prolog WODs always start at byte offset 0 of the WOD pool, and this same ordering applies. ### Epilog Descriptors From d4922a2aa01f67de003bcceef74fdf1b68e33d71 Mon Sep 17 00:00:00 2001 From: Pedro Miguel Justo Teixeira Date: Wed, 20 May 2026 11:55:32 -0700 Subject: [PATCH 1790/1799] Feedback batch --- docs/build/x64-unwind-information-v3.md | 11 +---------- 1 file changed, 1 insertion(+), 10 deletions(-) diff --git a/docs/build/x64-unwind-information-v3.md b/docs/build/x64-unwind-information-v3.md index 03e9a1524ab..4dc70040986 100644 --- a/docs/build/x64-unwind-information-v3.md +++ b/docs/build/x64-unwind-information-v3.md @@ -17,8 +17,6 @@ Unwind V3 is required for code supporting APX. Non-APX enabled code should still Unwind Information V3 is a preview specification. There's still a risk of breaking changes or omissions. Code produced under this guidance should itself be considered Preview Code. ---- - ## Terminology | Term | Definition | @@ -30,12 +28,9 @@ Unwind Information V3 is a preview specification. There's still a risk of breaki | **Payload** | The variable-length region immediately after the 4-byte `UNWIND_INFO_V3` header, sized by `PayloadWords` 16-bit words. Contains the large prolog extension, prolog IP offsets, epilog descriptors (with their IP offsets), and the WOD pool. | | **RVA** | Relative Virtual Address — an offset from the base address of the image at load time. | ---- - ## Overall Object-File Layout -Unwind V3 reuses the existing PE/COFF `.pdata` and `.xdata` section -conventions unchanged: +Unwind V3 reuses the existing PE/COFF `.pdata` and `.xdata` section conventions unchanged: ``` .pdata — sorted array of IMAGE_AMD64_RUNTIME_FUNCTION_ENTRY (12 bytes each) @@ -52,8 +47,6 @@ Each `RUNTIME_FUNCTION` entry is: No changes from V1 or V2. ---- - ## `UNWIND_INFO_V3` Header All multi-byte fields are little-endian. Bit 0 is the LSB of each byte. @@ -108,8 +101,6 @@ If `UNW_FLAG_EHANDLER` or `UNW_FLAG_UHANDLER` is set, a 4-byte handler RVA is at If `UNW_FLAG_CHAININFO` is set, a 12-byte `RUNTIME_FUNCTION` is at `handler_offset`. ---- - ## Payload Layout Immediately after the 4-byte header, the payload is arranged in the following order (all packed, `#pragma pack(1)` semantics): From 7a157f8a6044bf21ba19f823ca82c4b4642b51fa Mon Sep 17 00:00:00 2001 From: Pedro Miguel Justo Teixeira Date: Wed, 20 May 2026 12:05:52 -0700 Subject: [PATCH 1791/1799] Feedback batch --- docs/build/x64-unwind-information-v3.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/build/x64-unwind-information-v3.md b/docs/build/x64-unwind-information-v3.md index 4dc70040986..f72cf5f8cbb 100644 --- a/docs/build/x64-unwind-information-v3.md +++ b/docs/build/x64-unwind-information-v3.md @@ -117,7 +117,7 @@ Total size = `PayloadWords` × 2 bytes (may include padding to fill words). ### Prolog IP Offsets -An array of `NumberOfOps` entries. Each entry is an unsigned byte (or an unsigned 16-bit word when `UNW_FLAG_LARGE` is set) giving the IP offset (from the start of the prolog / start of the fragment) of the instruction that performs the corresponding unwind operation. +An array of `NumberOfOps` entries. Each entry is an unsigned byte giving the IP offset from the start of the fragment of the instruction that performs the corresponding unwind operation. When `UNW_FLAG_LARGE` is set, each entry is an unsigned 16-bit word instead. **Ordering:** The first entry corresponds to the operation closest to the function body (the *last* prolog instruction with an unwind effect). The last entry corresponds to the operation closest to the function entry point (the *first* prolog instruction). This matches the V1 or V2 convention of listing unwind codes in reverse execution order. The prolog WODs always start at byte offset 0 of the WOD pool, and this same ordering applies. @@ -179,11 +179,11 @@ The `Flags` bits 0 and 1, `FirstOp`, `IpOffsetOfLastInstruction`, and IP offset | Field | Description | |-------|-------------| -| `Flags` | Bit 0: `EPILOG_INFO_PARENT_FRAGMENT_TRANSFER` — set if this epilog transfers control back to the parent fragment (e.g. via JMP) rather than returning to the caller. Bit 1: `EPILOG_INFO_LARGE` — when set, the extended descriptor uses `EPILOG_INFO_LARGE_EX_V3` (16-bit `IpOffsetOfLastInstruction`) and each IP offset entry is 16-bit, accommodating epilogs exceeding 255 bytes. Expected very rarely. Bit 2: reserved (zero). | +| `Flags` | Bit 0: `EPILOG_INFO_PARENT_FRAGMENT_TRANSFER` — set if this epilog transfers control back to the parent fragment (e.g. via JMP) rather than returning to the caller. Bit 1: `EPILOG_INFO_LARGE` — when set, the extended descriptor uses `EPILOG_INFO_LARGE_EX_V3` (16-bit `IpOffsetOfLastInstruction`) and each IP offset entry is 16-bit, accommodating epilogs exceeding 255 bytes. Bit 2: reserved (zero). | | `NumberOfOps` | Number of WODs for this epilog (0–31). Zero is a special value meaning "inherit from previous epilog descriptor." | -| `EpilogOffset` | 16-bit signed displacement to the first instruction of this epilog. For the first epilog descriptor: positive values are byte offsets from the fragment start; negative values are byte offsets from the fragment tail (first byte past the end). For subsequent epilog descriptors: delta from the start of the previous epilog. All epilogs must use the same sign (all sorted ascending from start, or all sorted descending from tail). | +| `EpilogOffset` | 16-bit signed displacement to the first instruction of this epilog. For the first epilog descriptor: positive values are byte offsets from the fragment start, and negative values are byte offsets from the fragment tail, that is, the first byte past the end. For subsequent epilog descriptors: delta from the start of the previous epilog. All epilogs must use the same sign — either all sorted ascending from start, or all sorted descending from tail. | | `FirstOp` | Byte index into the WOD pool where the first WOD for this epilog resides. Since WODs are variable-length, this is a byte offset, not a WOD index. Epilogs may share WODs with the prolog or with each other by pointing into the same pool region. | -| `IpOffsetOfLastInstruction` | Unsigned byte offset (from the epilog start) of the last instruction in the epilog (typically RET or JMP). 8-bit in `EPILOG_INFO_EX_V3`; 16-bit in `EPILOG_INFO_LARGE_EX_V3`. The unwinder uses this to determine where the epilog ends and the function body resumes. | +| `IpOffsetOfLastInstruction` | Unsigned byte offset from the epilog start of the last instruction in the epilog, typically RET or JMP. 8-bit in `EPILOG_INFO_EX_V3`; 16-bit in `EPILOG_INFO_LARGE_EX_V3`. The unwinder uses this to determine where the epilog ends and the function body resumes. | #### Epilog IP Offsets From f7f00ace312340f8b31c744d1b0ad11231246042 Mon Sep 17 00:00:00 2001 From: Pedro Miguel Justo Teixeira Date: Wed, 20 May 2026 12:16:31 -0700 Subject: [PATCH 1792/1799] Warning format - trusting Content Mentor... --- docs/build/x64-unwind-information-v3.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/build/x64-unwind-information-v3.md b/docs/build/x64-unwind-information-v3.md index f72cf5f8cbb..f9b40fb4a6d 100644 --- a/docs/build/x64-unwind-information-v3.md +++ b/docs/build/x64-unwind-information-v3.md @@ -15,7 +15,8 @@ Unwind Information V3 adds support for the Intel APX (Advanced Performance Exten Unwind V3 is required for code supporting APX. Non-APX enabled code should still use the [conventional (pre-V3) Unwind Information](../build/exception-handling-x64.md). -Unwind Information V3 is a preview specification. There's still a risk of breaking changes or omissions. Code produced under this guidance should itself be considered Preview Code. +> [!WARNING] +> Unwind Information V3 is a preview specification. There's still a risk of breaking changes or omissions. Code produced under this guidance should itself be considered preview code. ## Terminology From c839d831cfb02279cfcee5ab52cabefa8282d3f2 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 20 May 2026 13:44:02 -0700 Subject: [PATCH 1793/1799] fix bugs --- docs/build/sample-profile-guided-optimization.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/build/sample-profile-guided-optimization.md b/docs/build/sample-profile-guided-optimization.md index f9f2df002ca..aa0364d2c98 100644 --- a/docs/build/sample-profile-guided-optimization.md +++ b/docs/build/sample-profile-guided-optimization.md @@ -1,7 +1,7 @@ --- description: "Learn how to use Sample Profile-Guided Optimization (SPGO) to improve the performance of C and C++ applications." title: "Tutorial: Use Sample Profile-Guided Optimization (SPGO) to improve C++ performance" -ms.date: 05/08/2026 +ms.date: 05/20/2026 ms.topic: tutorial ai-usage: ai-assisted helpviewer_keywords: ["SPGO", "sample profile-guided optimization", "profiling, SPGO", "SPDConvert", "SPTAggregate"] @@ -112,8 +112,9 @@ The Windows Performance Toolkit (WPT) uses `perfcore.ini`, located if you instal Open Windows Notepad as Administrator. Then open `perfcore.ini`. Find the DLL list section and add the following entries, one per line: ``` -perf_spt.dll +perf_hv.dll perf_lbr.dll +perf_spt.dll ``` If `xperf.exe` isn't installed, see [General issues](#general-issues-all-paths) to install it. @@ -249,7 +250,7 @@ Before applying SPGO, build `textCount` and run it against a large text file, su **Build:** ```cmd -cl /EHsc /GL /O2 textCount.cpp +cl /Zi /EHsc /GL /O2 textCount.cpp /link /debug ``` **Run:** @@ -282,7 +283,7 @@ Record the `Elapsed time` value. You'll compare it to the SPGO-optimized time in Now build textCount with SPGO enabled. This step lays the groundwork to gather profiling data. ```cmd -cl /EHsc /GL /O2 textCount.cpp /link /debug /spgo +cl /Zi /EHsc /GL /O2 textCount.cpp /link /debug /spgo ``` When the build finishes, you see a message like: @@ -297,6 +298,7 @@ This message appears on the first `/spgo` build. The linker creates the SPD file | Flag | Purpose | |------|---------| +| `/Zi` | Generate complete debugging information | | `/EHsc` | Enable C++ exception handling | | `/GL` | Whole-program optimization — required for SPGO. Defers final optimization to link time, enabling cross-module inlining, code layout, and dead code elimination decisions. | | `/O2` | Optimize for speed — enables aggressive inlining, loop optimization, dead code removal, and related transforms. | @@ -549,7 +551,7 @@ Rebuild `textCount` by using the populated SPD file. The linker reads the profil This step is the same for all three profiling paths. ```cmd -cl /EHsc /GL /O2 textCount.cpp /link /debug /spgo /spdin:textCount.spd +cl /Zi /EHsc /GL /O2 textCount.cpp /link /debug /spgo /spdin:textCount.spd ``` **New flag (compared to [Build textCount with /spgo](#build-textcount-with-spgo)):** From 200afee7b85d294fabf3419db654f466c742546d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 20 May 2026 15:24:29 -0700 Subject: [PATCH 1794/1799] fixes --- docs/build/sample-profile-guided-optimization.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/build/sample-profile-guided-optimization.md b/docs/build/sample-profile-guided-optimization.md index aa0364d2c98..c3dd44aa60a 100644 --- a/docs/build/sample-profile-guided-optimization.md +++ b/docs/build/sample-profile-guided-optimization.md @@ -112,9 +112,9 @@ The Windows Performance Toolkit (WPT) uses `perfcore.ini`, located if you instal Open Windows Notepad as Administrator. Then open `perfcore.ini`. Find the DLL list section and add the following entries, one per line: ``` -perf_hv.dll perf_lbr.dll perf_spt.dll +perf_hv.dll ``` If `xperf.exe` isn't installed, see [General issues](#general-issues-all-paths) to install it. @@ -597,7 +597,7 @@ Collect multiple runs for each configuration and use the median. A single run is | Build | Representative elapsed time | |-------|-----------------------------| -| Baseline (`cl /EHsc /O2`) | *(your measurement)* | +| Baseline (`cl /Zi /EHsc /O2 /link debug`) | *(your measurement)* | | `/spgo` build (no profile data yet) | *(should be close to baseline)* | | SPGO-optimized (`/spdin`) | *(should show improvement)* | @@ -609,7 +609,7 @@ The LBR path followed in this tutorial was applied to the [SQLite](https://githu Use this checklist to apply SPGO to your own C or C++ application. -1. **Add `/link /spgo` to your existing release build command.** Modify your build script or project file: +1. **Add `/Zi /link /spgo /debug` to your existing release build command.** Modify your build script or project file: ```cmd cl /EHsc /GL /O2 myapp.cpp /link /spgo @@ -621,7 +621,7 @@ Use this checklist to apply SPGO to your own C or C++ application. 1. **Rebuild with `/spdin:`.** Compile your application with the populated SPD: ```cmd - cl /EHsc /GL /O2 yourApp.cpp /link /spgo /spdin:yourApp.spd + cl /Zi /EHsc /GL /O2 yourApp.cpp /link /debug /spgo /spdin:yourApp.spd ``` 1. **Measure before and after.** Run your workload with both the nonoptimized and SPGO-optimized binaries. Collect the **median of multiple runs** for each configuration. A single run isn't reliable for benchmarking. From 1f19195f73770ff11abbffb0bcfed241116a00a7 Mon Sep 17 00:00:00 2001 From: Pedro Miguel Justo Teixeira Date: Wed, 20 May 2026 16:38:24 -0700 Subject: [PATCH 1795/1799] Acrolinx --- docs/build/x64-unwind-information-v3.md | 72 ++++++++++++------------- 1 file changed, 36 insertions(+), 36 deletions(-) diff --git a/docs/build/x64-unwind-information-v3.md b/docs/build/x64-unwind-information-v3.md index f9b40fb4a6d..246d81ca455 100644 --- a/docs/build/x64-unwind-information-v3.md +++ b/docs/build/x64-unwind-information-v3.md @@ -22,29 +22,29 @@ Unwind V3 is required for code supporting APX. Non-APX enabled code should still | Term | Definition | |------|------------| -| **Fragment** | A contiguous region of machine code described by a single `RUNTIME_FUNCTION` / `UNWIND_INFO_V3` pair. A function might consist of a *main fragment* and zero or more *subfragments* chained together. For more information see [Chained unwind info structures](../build/exception-handling-x64.md#chained-unwind-info-structures). | -| **WOD** | Winding Operation Descriptor — a variable-length packed encoding of a single unwind operation (push, alloc, save, and so on). | +| **Fragment** | A contiguous region of machine code described by a single `RUNTIME_FUNCTION` / `UNWIND_INFO_V3` pair. A function might consist of a *main fragment* and zero or more *subfragments* chained together. For more information, see [Chained unwind info structures](../build/exception-handling-x64.md#chained-unwind-info-structures). | +| **WOD** | The Winding Operation Descriptor is a variable-length packed encoding of a single unwind operation (push, alloc, save, and so on). | | **WOD pool** | The byte array within the payload that stores all WODs for a fragment's prolog and epilog(s). | | **IP Offset** | The unsigned byte offset of an instruction relative to the start of the prolog or epilog. | | **Payload** | The variable-length region immediately after the 4-byte `UNWIND_INFO_V3` header, sized by `PayloadWords` 16-bit words. Contains the large prolog extension, prolog IP offsets, epilog descriptors (with their IP offsets), and the WOD pool. | -| **RVA** | Relative Virtual Address — an offset from the base address of the image at load time. | +| **RVA** | Relative Virtual Address is the offset from the base address of the image at load time. | ## Overall Object-File Layout Unwind V3 reuses the existing PE/COFF `.pdata` and `.xdata` section conventions unchanged: ``` -.pdata — sorted array of IMAGE_AMD64_RUNTIME_FUNCTION_ENTRY (12 bytes each) -.xdata — UNWIND_INFO_V3 structures referenced by .pdata entries +.pdata - sorted array of IMAGE_AMD64_RUNTIME_FUNCTION_ENTRY (12 bytes each) +.xdata - UNWIND_INFO_V3 structures referenced by .pdata entries ``` Each `RUNTIME_FUNCTION` entry is: | Offset | Size | Field | |--------|------|-------| -| 0 | 4 | `BeginAddress` — RVA of fragment start | -| 4 | 4 | `EndAddress` — RVA of first byte past fragment end | -| 8 | 4 | `UnwindInfoAddress` — RVA of `UNWIND_INFO_V3` in `.xdata` | +| 0 | 4 | `BeginAddress` - RVA of fragment start | +| 4 | 4 | `EndAddress` - RVA of first byte past fragment end | +| 8 | 4 | `UnwindInfoAddress` - RVA of `UNWIND_INFO_V3` in `.xdata` | No changes from V1 or V2. @@ -67,8 +67,8 @@ All multi-byte fields are little-endian. Bit 0 is the LSB of each byte. |-------|-------------| | `Version` | Must be `3`. | | `Flags` | Same flag definitions as V1 or V2: `UNW_FLAG_EHANDLER` (0x01), `UNW_FLAG_UHANDLER` (0x02), `UNW_FLAG_CHAININFO` (0x04). New in V3: `UNW_FLAG_LARGE` (0x08). Bit 4 reserved (zero). | -| `SizeOfProlog` | Byte offset to the start of the first instruction that isn't part of the prolog. When `UNW_FLAG_LARGE` is set, this 8-bit field is the low byte of a 16-bit prolog size. For more information on the 16-bit form see [`UNW_FLAG_LARGE` and `UNWIND_INFO_LARGE_V3`](#unw_flag_large-and-unwind_info_large_v3). | -| `PayloadWords` | Number of 16-bit words of payload following this header. The payload contains prolog IP offsets, all epilog descriptors (including their IP offsets), and the WOD pool. Does not include the exception-handler RVA or chained `RUNTIME_FUNCTION` that might follow. The algorithm to locate the handler/chain data is the same as V1 or V2: `header + 4 + PayloadWords * 2`, DWORD-aligned. | +| `SizeOfProlog` | Byte offset to the start of the first instruction that isn't part of the prolog. When `UNW_FLAG_LARGE` is set, this 8-bit field is the low byte of a 16-bit prolog size. For more information on the 16-bit form, see [`UNW_FLAG_LARGE` and `UNWIND_INFO_LARGE_V3`](#unw_flag_large-and-unwind_info_large_v3). | +| `PayloadWords` | Number of 16-bit words of payload following this header. The payload contains prolog IP offsets, all epilog descriptors (including their IP offsets), and the WOD pool. Doesn't include the exception-handler RVA or chained `RUNTIME_FUNCTION` that might follow. The algorithm to locate the handler/chain data is the same as V1 or V2: `header + 4 + PayloadWords * 2`, DWORD-aligned. | | `NumberOfOps` | Count of WODs in the prolog (0–31). Zero means no prolog. If a function needs more than 31 prolog operations, use a subfragment. | | `NumberOfEpilogs` | Count of `EPILOG_INFO_V3` descriptors that follow the prolog IP offsets (0–7). Zero means no epilogs in this fragment. If more than 7 are needed, use a subfragment. | @@ -88,7 +88,7 @@ Additionally, when `UNW_FLAG_LARGE` is set: The `UNWIND_INFO_LARGE_V3` byte is part of the payload and is included in `PayloadWords`. The handler-offset formula remains unchanged. -This flag is expected to be needed very rarely (prologs exceeding 255 bytes). +This flag is only necessary for prologs exceeding 255 bytes. ### Locating Exception Handler / Chain Info @@ -106,13 +106,13 @@ If `UNW_FLAG_CHAININFO` is set, a 12-byte `RUNTIME_FUNCTION` is at `handler_offs Immediately after the 4-byte header, the payload is arranged in the following order (all packed, `#pragma pack(1)` semantics): -1. `UNWIND_INFO_LARGE_V3` — 1 byte, present only if `UNW_FLAG_LARGE` is set. -1. Prolog IP Offsets — `NumberOfOps` bytes (or 16-bit words if `UNW_FLAG_LARGE`). +1. `UNWIND_INFO_LARGE_V3` - 1 byte, present only if `UNW_FLAG_LARGE` is set. +1. Prolog IP Offsets - `NumberOfOps` bytes (or 16-bit words if `UNW_FLAG_LARGE`). 1. For each epilog (repeated `NumberOfEpilogs` times): - `EPILOG_INFO_V3` descriptor. - `EPILOG_INFO_EX_V3` or `EPILOG_INFO_LARGE_EX_V3` extended descriptor (present only when `NumberOfOps > 0`). - - IP Offset array — `NumberOfOps` bytes (or 16-bit words if `EPILOG_INFO_LARGE`). -1. WOD Pool — remaining bytes. + - IP Offset array - `NumberOfOps` bytes (or 16-bit words if `EPILOG_INFO_LARGE`). +1. WOD Pool - remaining bytes. Total size = `PayloadWords` × 2 bytes (may include padding to fill words). @@ -120,7 +120,7 @@ Total size = `PayloadWords` × 2 bytes (may include padding to fill words). An array of `NumberOfOps` entries. Each entry is an unsigned byte giving the IP offset from the start of the fragment of the instruction that performs the corresponding unwind operation. When `UNW_FLAG_LARGE` is set, each entry is an unsigned 16-bit word instead. -**Ordering:** The first entry corresponds to the operation closest to the function body (the *last* prolog instruction with an unwind effect). The last entry corresponds to the operation closest to the function entry point (the *first* prolog instruction). This matches the V1 or V2 convention of listing unwind codes in reverse execution order. The prolog WODs always start at byte offset 0 of the WOD pool, and this same ordering applies. +**Ordering:** The first entry corresponds to the operation closest to the function body (the *last* prolog instruction with an unwind effect). The last entry corresponds to the operation closest to the function entry point (the *first* prolog instruction). This matches the V1 or V2 convention of listing unwind codes in reverse execution order. The prolog WODs always start at byte offset zero of the WOD pool, and this same ordering applies. ### Epilog Descriptors @@ -144,7 +144,7 @@ Zero or more `EPILOG_INFO_V3` structures follow the prolog IP offsets. Each can |------|------|-------|-------| | 0–1 | [15:0] | `FirstOp` | 16-bit unsigned | | 2 | [7:0] | `IpOffsetOfLastInstruction` | 8 bits unsigned | -| 3 .. | — | IP Offset array | `NumberOfOps` bytes, unsigned | +| 3 .. | - | IP Offset array | `NumberOfOps` bytes, unsigned | **Large form** (`EPILOG_INFO_LARGE` set): @@ -162,7 +162,7 @@ Zero or more `EPILOG_INFO_V3` structures follow the prolog IP offsets. Each can |------|------|-------|-------| | 0–1 | [15:0] | `FirstOp` | 16-bit unsigned | | 2–3 | [15:0] | `IpOffsetOfLastInstruction` | 16 bits unsigned | -| 4 .. | — | IP Offset array | `NumberOfOps` × 2 bytes, unsigned 16-bit | +| 4 .. | - | IP Offset array | `NumberOfOps` × 2 bytes, unsigned 16-bit | #### When `NumberOfOps == 0` (inherited descriptor) @@ -180,11 +180,11 @@ The `Flags` bits 0 and 1, `FirstOp`, `IpOffsetOfLastInstruction`, and IP offset | Field | Description | |-------|-------------| -| `Flags` | Bit 0: `EPILOG_INFO_PARENT_FRAGMENT_TRANSFER` — set if this epilog transfers control back to the parent fragment (e.g. via JMP) rather than returning to the caller. Bit 1: `EPILOG_INFO_LARGE` — when set, the extended descriptor uses `EPILOG_INFO_LARGE_EX_V3` (16-bit `IpOffsetOfLastInstruction`) and each IP offset entry is 16-bit, accommodating epilogs exceeding 255 bytes. Bit 2: reserved (zero). | +| `Flags` | Bit 0: `EPILOG_INFO_PARENT_FRAGMENT_TRANSFER` - set if this epilog transfers control back to the parent fragment (for example, via JMP) rather than returning to the caller. Bit 1: `EPILOG_INFO_LARGE` - when set, the extended descriptor uses `EPILOG_INFO_LARGE_EX_V3` (16-bit `IpOffsetOfLastInstruction`) and each IP offset entry is 16-bit, accommodating epilogs exceeding 255 bytes. Bit 2: reserved (zero). | | `NumberOfOps` | Number of WODs for this epilog (0–31). Zero is a special value meaning "inherit from previous epilog descriptor." | -| `EpilogOffset` | 16-bit signed displacement to the first instruction of this epilog. For the first epilog descriptor: positive values are byte offsets from the fragment start, and negative values are byte offsets from the fragment tail, that is, the first byte past the end. For subsequent epilog descriptors: delta from the start of the previous epilog. All epilogs must use the same sign — either all sorted ascending from start, or all sorted descending from tail. | -| `FirstOp` | Byte index into the WOD pool where the first WOD for this epilog resides. Since WODs are variable-length, this is a byte offset, not a WOD index. Epilogs may share WODs with the prolog or with each other by pointing into the same pool region. | -| `IpOffsetOfLastInstruction` | Unsigned byte offset from the epilog start of the last instruction in the epilog, typically RET or JMP. 8-bit in `EPILOG_INFO_EX_V3`; 16-bit in `EPILOG_INFO_LARGE_EX_V3`. The unwinder uses this to determine where the epilog ends and the function body resumes. | +| `EpilogOffset` | 16-bit signed displacement to the first instruction of this epilog. For the first epilog descriptor: positive values are byte offsets from the fragment start, and negative values are byte offsets from the fragment tail, that is, the first byte past the end. For subsequent epilog descriptors: delta from the start of the previous epilog. All epilogs must use the same sign - either all sorted ascending from start, or all sorted descending from tail. | +| `FirstOp` | Byte index into the WOD pool where the first WOD for this epilog resides. This is a byte offset, not a WOD index. Epilogs may share WODs with the prolog or with each other by pointing into the same pool region. | +| `IpOffsetOfLastInstruction` | Unsigned byte offset from the epilog start of the last instruction in the epilog, typically RET, or JMP. 8-bit in `EPILOG_INFO_EX_V3`; 16-bit in `EPILOG_INFO_LARGE_EX_V3`. The unwinder uses this value to determine where the epilog ends and the function body resumes. | #### Epilog IP Offsets @@ -192,7 +192,7 @@ Immediately after each full epilog descriptor (when `NumberOfOps > 0`), an array ### WOD Pool -The remaining bytes in the payload form the WOD pool. The prolog's WODs implicitly start at byte offset 0 of this pool. Each epilog's WODs start at the byte offset given by its `FirstOp` field. WODs are packed with no alignment or padding between them. +The remaining bytes in the payload form the WOD pool. The prolog's WODs implicitly start at byte offset 0 of this pool. Each epilog's WOD list start at the byte offset given by its `FirstOp` field. WODs are packed with no alignment or padding between them. The number of WODs consumed for the prolog is `UNWIND_INFO_V3.NumberOfOps`. The number consumed for each epilog is its respective `EPILOG_INFO_V3.NumberOfOps` (or inherited). @@ -261,7 +261,7 @@ default: return INVALID; All bit positions are numbered LSB-first within each byte. Multi-byte integer fields are little-endian. -#### `WOD_PUSH` — 1 byte +#### `WOD_PUSH` - 1 byte ``` Byte 0: [2:0] = 100b (opcode 4) @@ -270,7 +270,7 @@ Byte 0: [2:0] = 100b (opcode 4) **Effect:** `PUSH ` adjusts RSP by 8 and stores register. -#### `WOD_PUSH2` — 2 bytes +#### `WOD_PUSH2` - 2 bytes ``` Byte 0: [5:0] = 100000b (opcode 32) @@ -281,7 +281,7 @@ Byte 1: [2:0] = Register1[4:2] (high 3 bits) **Effect:** `PUSH2 , ` pushes two registers with a single instruction (APX). Adjusts RSP by 16. -#### `WOD_PUSH_CONSECUTIVE_2` — 1 byte +#### `WOD_PUSH_CONSECUTIVE_2` - 1 byte ``` Byte 0: [2:0] = 111b (opcode 7) @@ -290,7 +290,7 @@ Byte 0: [2:0] = 111b (opcode 7) **Effect:** Pushes `Register` and `Register+1` consecutively. Adjusts `RSP` by 16 total. `Register` value must be limited to [0, 30], as value of 31 would place `Register+1` out of bounds. -#### `WOD_ALLOC_SMALL` — 1 byte +#### `WOD_ALLOC_SMALL` - 1 byte ``` Byte 0: [3:0] = 1000b (opcode 8) @@ -300,7 +300,7 @@ Byte 0: [3:0] = 1000b (opcode 8) **Actual allocation:** `(Size + 1) * 8` bytes. Range: 8–128 bytes in steps of 8. -#### `WOD_ALLOC_LARGE` — 3 bytes +#### `WOD_ALLOC_LARGE` - 3 bytes ``` Byte 0: [7:0] = 0x02 (opcode 2) @@ -309,7 +309,7 @@ Bytes 1–2: Size (16-bit unsigned, little-endian) **Actual allocation:** `Size * 8` bytes. Range: up to 524,280 bytes. -#### `WOD_ALLOC_HUGE` — 5 bytes +#### `WOD_ALLOC_HUGE` - 5 bytes ``` Byte 0: [7:0] = 0x01 (opcode 1) @@ -318,7 +318,7 @@ Bytes 1–4: Size (32-bit unsigned, little-endian) **Actual allocation:** Raw byte count (no scaling). Range: up to 4 GiB. -#### `WOD_SET_FPREG` — 2 bytes +#### `WOD_SET_FPREG` - 2 bytes ``` Byte 0: [7:0] = 0x00 (opcode 0) @@ -328,7 +328,7 @@ Byte 1: [3:0] = Register (4 bits, 0–15) **Effect:** Establishes a frame pointer. ` = RSP + Offset * 16`. -#### `WOD_SAVE_NONVOL` — 3 bytes +#### `WOD_SAVE_NONVOL` - 3 bytes ``` Byte 0: [2:0] = 110b (opcode 6) @@ -336,10 +336,10 @@ Byte 0: [2:0] = 110b (opcode 6) Bytes 1–2: Displacement (16-bit unsigned, little-endian) ``` -**Effect:** `MOV [RSP + Displacement * 8], ` saves a non-volatile +**Effect:** `MOV [RSP + Displacement * 8], ` saves a nonvolatile integer register to the stack. -#### `WOD_SAVE_NONVOL_FAR` — 5 bytes +#### `WOD_SAVE_NONVOL_FAR` - 5 bytes ``` Byte 0: [2:0] = 101b (opcode 5) @@ -349,7 +349,7 @@ Bytes 1–4: Displacement (32-bit unsigned, little-endian) **Effect:** Same as `WOD_SAVE_NONVOL` but with a 32-bit unscaled byte displacement. Used when the offset doesn't fit in 16 bits scaled by 8. -#### `WOD_SAVE_XMM128` — 3 bytes +#### `WOD_SAVE_XMM128` - 3 bytes ``` Byte 0: [3:0] = 1010b (opcode 10) @@ -360,7 +360,7 @@ Bytes 1–2: Displacement (16-bit unsigned, little-endian) **Effect:** `MOVAPS [RSP + Displacement * 16], ` saves a 128-bit XMM register. -#### `WOD_SAVE_XMM128_FAR` — 5 bytes +#### `WOD_SAVE_XMM128_FAR` - 5 bytes ``` Byte 0: [3:0] = 1001b (opcode 9) @@ -370,7 +370,7 @@ Bytes 1–4: Displacement (32-bit unsigned, little-endian) **Effect:** Same as `WOD_SAVE_XMM128` but with a 32-bit unscaled byte displacement. -#### `WOD_PUSH_CANONICAL_FRAME` — 2 bytes +#### `WOD_PUSH_CANONICAL_FRAME` - 2 bytes ``` Byte 0: [7:0] = 0x03 (opcode 3) From 52de283132947b55abc335a39bbded704a747c13 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 20 May 2026 17:00:44 -0700 Subject: [PATCH 1796/1799] missed one spot for /Zi --- docs/build/sample-profile-guided-optimization.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/build/sample-profile-guided-optimization.md b/docs/build/sample-profile-guided-optimization.md index c3dd44aa60a..a1bcf408526 100644 --- a/docs/build/sample-profile-guided-optimization.md +++ b/docs/build/sample-profile-guided-optimization.md @@ -298,7 +298,7 @@ This message appears on the first `/spgo` build. The linker creates the SPD file | Flag | Purpose | |------|---------| -| `/Zi` | Generate complete debugging information | +| `/Zi` | Generate complete debugging information. This is necessary for SPGO to map profiling samples to source code. | | `/EHsc` | Enable C++ exception handling | | `/GL` | Whole-program optimization — required for SPGO. Defers final optimization to link time, enabling cross-module inlining, code layout, and dead code elimination decisions. | | `/O2` | Optimize for speed — enables aggressive inlining, loop optimization, dead code removal, and related transforms. | @@ -609,10 +609,10 @@ The LBR path followed in this tutorial was applied to the [SQLite](https://githu Use this checklist to apply SPGO to your own C or C++ application. -1. **Add `/Zi /link /spgo /debug` to your existing release build command.** Modify your build script or project file: +1. **Add `/Zi /link /debug /spgo` to your existing release build command.** Modify your build script or project file: ```cmd - cl /EHsc /GL /O2 myapp.cpp /link /spgo + cl /Zi /EHsc /GL /O2 myapp.cpp /link /debug /spgo ``` 1. **Choose a representative workload.** Select a real usage scenario that exercises the hot paths of your application. Use production-like data. Avoid the following as your primary profiling workload: code coverage tests (they don't stress performance bottlenecks), uncommon error paths, startup and shutdown phases, and deprecated code paths. This workload drives the profile that feeds the optimizer. From ccde0628b6d7b635a084def06f287864600416ba Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 20 May 2026 17:03:05 -0700 Subject: [PATCH 1797/1799] fix flag --- docs/build/sample-profile-guided-optimization.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/sample-profile-guided-optimization.md b/docs/build/sample-profile-guided-optimization.md index a1bcf408526..9a9b7babe60 100644 --- a/docs/build/sample-profile-guided-optimization.md +++ b/docs/build/sample-profile-guided-optimization.md @@ -597,7 +597,7 @@ Collect multiple runs for each configuration and use the median. A single run is | Build | Representative elapsed time | |-------|-----------------------------| -| Baseline (`cl /Zi /EHsc /O2 /link debug`) | *(your measurement)* | +| Baseline (`cl /Zi /EHsc /O2 /link /debug`) | *(your measurement)* | | `/spgo` build (no profile data yet) | *(should be close to baseline)* | | SPGO-optimized (`/spdin`) | *(should show improvement)* | From 5b149a6b58b7fa86a8f16749354b73ab63c968bc Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 21 May 2026 14:35:58 -0700 Subject: [PATCH 1798/1799] add links --- docs/build/reference/feature-x64.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/build/reference/feature-x64.md b/docs/build/reference/feature-x64.md index 4e36fb8a8d5..6f7e91b1e03 100644 --- a/docs/build/reference/feature-x64.md +++ b/docs/build/reference/feature-x64.md @@ -1,7 +1,7 @@ --- description: "Learn more about: /feature (x64)" title: "/feature (x64)" -ms.date: 05/11/2026 +ms.date: 05/21/2026 --- # `/feature` (x64) @@ -28,12 +28,21 @@ Example usage: to enable APX, specify **`/feature:APX`**. When **`/feature:APX`** is specified, the following preprocessor macros are defined: `__APX_F__`, `__CCMP__`, `__CF__`, `__EGPR__`, `__NDD__`, `__NF__`, `__PPX__`, `__PUSH2POP2__`, and `__ZU__`. For more information, see [Microsoft-specific predefined macros](../../preprocessor/predefined-macros.md). +APX extends the x64 architecture with new registers and instructions, which affects how the compiler generates calls, preserves state across function boundaries, and emits unwind metadata. The following articles describe the x64 conventions and unwind information that APX builds on: + +- [Caller/callee saved registers](../x64-calling-convention.md#callercallee-saved-registers)\ + Describes which registers a callee must preserve and which the caller is responsible for saving across a call on x64. +- [setjmp/longjmp](../x64-calling-convention.md#setjmplongjmp)\ + Explains how nonlocal jumps capture and restore nonvolatile register state on x64, including the registers that participate in the jump buffer. +- [Register volatility and preservation](../x64-software-conventions.md#register-volatility-and-preservation)\ + Summarizes the x64 software conventions for volatile and nonvolatile general-purpose, `XMM`, `YMM`, and `ZMM` registers, and the rules callees must follow to preserve them. +- [Exception handling unwind information V3](../x64-unwind-information-v3.md)\ + Preview specification of the V3 unwind information format used to describe prologs, epilogs, and frame layout for x64 code, including the extended state introduced by APX. + ### To set the `/feature` compiler option in Visual Studio 1. Open the **Property Pages** dialog box for the project. For more information, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page. - 1. In the **Additional options** box, add *`/feature:APX`*. Choose **OK** to save your changes. ### To set this compiler option programmatically From b155663e2165e54c440d4f4e1a92336978df82e4 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 21 May 2026 14:39:36 -0700 Subject: [PATCH 1799/1799] wording tweak --- docs/build/reference/feature-x64.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/reference/feature-x64.md b/docs/build/reference/feature-x64.md index 6f7e91b1e03..676648ce4b5 100644 --- a/docs/build/reference/feature-x64.md +++ b/docs/build/reference/feature-x64.md @@ -28,7 +28,7 @@ Example usage: to enable APX, specify **`/feature:APX`**. When **`/feature:APX`** is specified, the following preprocessor macros are defined: `__APX_F__`, `__CCMP__`, `__CF__`, `__EGPR__`, `__NDD__`, `__NF__`, `__PPX__`, `__PUSH2POP2__`, and `__ZU__`. For more information, see [Microsoft-specific predefined macros](../../preprocessor/predefined-macros.md). -APX extends the x64 architecture with new registers and instructions, which affects how the compiler generates calls, preserves state across function boundaries, and emits unwind metadata. The following articles describe the x64 conventions and unwind information that APX builds on: +APX extends the x64 architecture with new registers and instructions, which affects how the compiler generates calls, preserves state across function boundaries, and emits unwind metadata. The following articles describe the x64 conventions and unwind information related to APX: - [Caller/callee saved registers](../x64-calling-convention.md#callercallee-saved-registers)\ Describes which registers a callee must preserve and which the caller is responsible for saving across a call on x64.

asdcExIwmHsGlmTd0K_A5Z+ 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 CF2vXX literal 0 HcmV?d00001 diff --git a/docs/porting/media/copilot-app-modernization-context-menu.png b/docs/porting/media/copilot-app-modernization-context-menu.png new file mode 100644 index 0000000000000000000000000000000000000000..9b671eadc33867a4b2f65614715465e5c37b06bc GIT binary patch literal 50329 zcmb@ubyQVf^e=hFzkxLAo31?(VL;j(&gR zzIWeWZ;ZPgz&`uzy;sb&=K9Rf{49gs$-hN^O!ycAfuKuCiYY-L$kY%B!VC%`xFY7X zYySb7@EO%cQo|ks!Dxa1Aaq#g7=Vie4&v$# z%GO2>&iZzSkazl~Rt`+^;wmpVm|iozejSX0+YfH4F;tf_l9Hl>pnwm^5JCiG2m&~h z20ujqorCH?ULhd;y$-L?YXn3H7Wk_PeoO-%{Jm}g&f&)g@B@GTfBycTr9vP`5J==B z$OCW>3o9E7Lh8Tw!kNN`s{M&~dqxNMHc6<;> zi@21Su!@WB&aCH8+0}c&19M~RQgyCvCVwh1wiv4uVHuT9ucN}*W~C618DDAq+|fH~ zEfcCPxf8|7VTqL4tBvws9&}Z&a9D|!T39LVya&qaV1h;Q<^$U6M*Y1%+3bzZPCZm2 zY>VveleT{jxehoco#TwvyV}EhLqbVIBe&l7?r>`?-#3z4E&(MZ?`cR|R7#2hN>^_$ z11;@0`o5l?p1!^qdc(5vax^qFKN%Eq&O}Cf`kqaPtjtU-k>Qb%T_-+z!yX=SadD$^ zjiZ`^ikcdiorzM5#b!S=Wo2b3i8PZzO*f`Ufm;4}I$Ej30$qAk%i=<;WL4Ts(5vz9 z=2ULv7cnSUq$)?RM7HRAb)0LB)#$2mAU>4XFnE8xxT!QB5BIuQ3SqAK_3PJ5ra5Zg ziQO}BW|j6%Q4tGoDWT6OphdrY(iiP(%c6}wa7YL$d2Vj5K$5tk z;x}%OOv_i$H!Fy_B`u4X?b8nQDG6whJRaW}P!8s26ERI~?OsQpkv-+9_oj}Z?djwv zpc#JjY-o5)?1_ENa;$7@riyB6u?nB97A6#sTwPrY1S&$Nt*S@Lm4h6uj13K4(FJJ# z__VdPHK&hoM(@aCXj@q^@duA=uE@`r2iU*B$&zE731%AT?k-bjxS4`LlrZhU&=L|W zRcBxbTxyq@w%{c6G&C}LELu4;GqbZ}F*Q$*k=bixZ)QeUEhQy|iq<3%imzB%)jvUN zU~FtJTBaekh3$mPexVX52u-)QOiWDd@$!$nUVV9in9DNzZbIOsKaK1LKlmwR3|qts zG!@1A^74{hEo0)kOS?pjkH(ZN_hNRxxmkp;c+UI&R{PrwwF6IBU+d>u`3>6Vcz7~r zdji)x#0d-cRJLSI54QYcU`D_#s6 z7#Rigkxw32A5PDXenxtPLQYFd>w!QXMce3G_pvy9J2>f!K`{e5%BA?$b6nhDBx|dt zdN4+aC_BIIQX%W=cbzdXGOpqwKsrS`(LuEr8QIvrH<-z|zc@ZVZbL1asxTE5v}srh z)qbDdY+{KURhqONOd`(uJmb09HV%6Iq)fkdG7HDsr*>aop_Md$uAqcKzD5#(H@)nb zDE(wQy6gOf{t12-w0pxCmIypU&a2{MyN>pD&Vu>cO6c44hg|IPjipY7SvQ2>p#_Se z-szY{YIl%foAqxwta6gng)~(50p{ zC++bZMql7D8zX}N;g)WgDJ?Cv)N~{my}x}+c9pShxm;}R$h>3;YQ@r+DHAtbVAO0o zbm#0=l@xV{V58=hjt~0xi4w@M=g3;Zx z?DSv1p5Bz2j?bxfDC|LPHeFm@31D>Ky(VI#*E*GA>SBU=jUMrsQPI&Vl}?Vo27CIh z-uUtVwD9Z_P?9Q0RGC1gqZA0%CgW?{TF_&z9#_V6mb;caQm+tIpSkRnbYcimXoaaA zRmM&4Kc+wbL?4F;vB_|UE-zz06gZgEah84Km{noZ*Eu#XJGZXweRiYYIt_})#8rteuFJh4B z8yLW|YQA#JS34ykVN-BsdO`sl4+%!V$mWUZy;I%nqD`Q;$tya#k8GM~Z!t?6Ki19m z_thJgPnwKZ)Cf~vj!QedtR5XzsSRrT_$@S(0G<8`WPvOwa@u2d*L$1Y>HhapF;}C< z?i5ZVKB(6V;u7xQ)7#kSXfU;g2Q)M^nhBasd}+Hj9fnc!{mMg1PutQ%G%5xxKXN8c z4&AD$t9Kd=WFfGL4=8FAaMWa_s>TpSSXOG9zWJGuKsV#d8F;n$=dLp9;4OAQi|{8S zLrqnDNRyyPCkYYJ^m2dK>({7SUOn`6Zr|wPi!}-b11}B+GoCzuA8-mpGy%W)_vjpET&a@R*?wG=)br2*ldz<> ztJvbfpImc8T?r=q*)-7r3=#<yO^L^dVD0D? zAmM$YuC`UmGO7-y(BGpXO`+3LZhLcUA(?q(Z0iS)auysQf#b!?4Q#u*-TCFo-*DFr zj(3(DM0VFPD_SqHtC@5EXcG)m&36}dr|iw8Uk?PN-S=K=(V7xbZ^zHRB8LW z{7svCr}v($&)Tc(c5sEqd-^`Y%DO*`J>-jgoE@r{I5PW*?T>c3VY-C3D)Maln={KK z-fkQlnIyBRr5Mq^WaBk~*T;h~b~J0Wkh8-zK;m;c-)9 zu{I3#J{`8R!qqIP&M7_)O_rp*6?Nb9U)uKWEH`FppD@v;Qg6*Q)TzwZxu@rmuG>RRh82Bd9U*=>mXa73?q`&%OH#MB2Ve@K2?sc1gX7$V?ju-)_=ygX4#7A zV69~@bZ#~%uBKD*BuvBu*W$C9I&aMNo)YiO6isvK0pc%~ags%+0ga!F7&@!J^hG-T zsh$ZlV*QNc$t2NRA#b9#^HQc1Xmn3eGW5mlNWK-THL}zC*Jm42_mPQo_>3-J;|8#e zET@ApCxu4aa1=I&AMNA|(eE(K_Ax*Hl9!rD{Y)99CdMqsMi=oj=eJR(JG=3()2U}ybf=l6$yE7gv96PXzKg<0c0eI`p|O|ZL4DVDE}AL^lGJg4Q? zYTJj;_C@QUx;bahXtsyM^3G8IKJ@`V4F%fvIhG#feF9le!k_PJusfw$8R!dY{@p@M2boNE3NcJucRptRgw7Z}`Ku{7*oQ#y!vui)`6xgG_2CSy*24Gc|Ow=wW?2Qfh&BXzIHO>I@YG_ zuFK2*?UNDNITMu4`Tf(sz18#zI21Gq=MUwdZB4371?IAd*{)Hj_lwH(6CzA=NZ76q zu5Fo!QtQ!#8Q!8O{)|r;Drmk+OS)e2NpuMv(WQNTru7SJGe}DB4FP!j5|d{>32;;W zxJ=p`Hr&C%!53cw)%XVpAwo(j$7_9l-c@0f@+cZ7`tKJ-as;%=Ysqd0AdpnQ?rv!) zRrAZM%cIpE-^h%NjJ(R{|LO!D zQ9w2r`1xnk0_PzQ7;w?%bur!o`~*w>oSBtXc8>_b$Nd`$1j@39R!mxW2%k!P-MzW- zX!OCXn{BjN6!FSc#KFTW|KE3_SjWf5t6_0UNvWyf>e3m3m!efcoj{bdJkANZLi)V2 zPyMMQyi&6eUljxLFyJ51ey6EPh*sZc#P-X|4B)ksuVZG6w6s{bt7~hTg@1;Jl@^;L zKjA!tpeX-~8a`%bW)6Ms0I_6Qc7-O0iHyqQF@FuFC4r!Z84=hTYckwqnbME`Ac)3mQRr2y4o1m|@6WW|+7w+0{n^b#% zknbW@*Z96DFULd+!`W8jE4?)`B=zCHKD5#EI7Gg+xxYQP2XV0Y(#)(=oep_qy4K{b z)8e!8$pTCT>0iRsuxQY?{fx$+bF_ClBtq!}W~ivB9DaD3ndQl=as&#|?bvYF1a<5< z)hYBLLtgm)>p|ik?AWNNm)g22Dq<940BJGVR!>^QqUqr=X`65+`X$1_;ID!L258QY z77QH_!Jbjb5;287k&%`*A+5opkWkqb@xe%T=1tO;V1Lcon|wxe+@|D_m#1dJ#1#u+ zW@e5csV*sr)SFfY(Wzi1O7*Xv^0G3@07(eM#qVDw$P(E?OD8SZS$cYVpG(*Rq&GP^ zSwXK(Y#86S1`w>(_o%36xQSijZ6Z5^;Hw$p_uw7|AH4P(nK&j@d?E#RL)h(^R-@44 zd^#exUB#WQh&+F=GG`Gzo(`BJJwY;}K!V)=Gw#+adioHjlwfy%z&V%(GLZ%{RR@i8 zwfk+Pg@lAq@mYYDZ4~*oBu*wQ(Up2Ro_4htg1A%z9+%$cn3*7}FB+$K#%eW#)yZNq ziXIX24vY;jBg6!zK6jO{#5An+@z^Z*xV+${!kaA9f%6N@*qBE5OFc6a;Ju@!3pD+8 z^4DXgxo&=beoIY>L^%7-s-jc}k7e$De5`>W=b;bFf6v9YeN1~zM9=e1`_fjloImPyy8obDuIY&tGf;!~uCo|7eje(6r4#bN#9E**fQur(P!; z(pj@gdop+*GarAKFVzfk7Wd{(?f7+%a~F+?V#`4IL6s_K1co{<`81LgKC?0Zb2PXi zetn*8a(AspUP>;G8b2guCGFOBPfi?c^=gUTHoz$A+L--VT7uep!Rp*>Sbsgo7VTCKB&0luZn%GF=ymzuUV zg8&Eee{q}Ke{q{LzN9J-L(~9>^{RA%s{m842Up(MTt-eVGf|xZw@W=?s05fNLFgYx zA@^no53LG}Qw=67c|g|~8ByQZd%-thCF!s>Uk^bG7`Khw&gnT@vL> zlK0a={hm{(RUOW(_L)x)1Y;eJczAdr0S1qhRMWuJ`cutd!CyYv%jEmxAP#FWMm1Fx zU~u+-Vam&QMn+j)?=Tq|FqMxRNR~r{T=i$)|<+_xI~u9N+lC zjpuZb}s-BqPc4cion-O9w-ypuO|qY?@f zz2^nFGguS*!jt3Ua}OS~1CaDU#L6cS2M5Qq&T+!>kG`Vf5RJnA^>XKcchZF8&FJ3u z?DNC?tpeTI*wgJQtI>n@tS~F9nF9$C$*z55K?@z1(Lu%@Jju~&mZqjpVV!iq1u)PW%m=m(q=2$*>d$lCnGomr5uA&{2N54syD|0owNM$ znL-l(!DfQu4!oQKO#hhz6JV7L6-K%A z+~2}U5xiR0gZ;^$J}Tm)K4@!X+lluNUSlNQd*U8&)98HKJwV21w=?eMs5$4@G2-#s zC$zr)4VTbWpVf5>rISFlBJ z4=SAx?;4mWAy>so&4?OJ=_Pnzy4;)54IYcXd;F z&Us+|2JEa@LNqQv3b{A&FEWMhVXiNdp_0=w zDqX?>H;O&LGcV=R{Yg;Cz3)!x^*+48VFeQ2+VAn=&4grzlta9L_L^cJ4;V(A+KHb#Z&UJcXgW zcmufYS-0)NuaBORuJtYa{#xg-85J4XwExnFWK$ z>N(AP+#^Q-N`*3V8;|Wq7Ncntl2_1Fa>gIw%ZeQIy3oaAIcDeiM$diN{oUE_bVpm;p&@HH z311ax!TFr~z^22Ip%-es``ff)Eqv?jjEou3pVc#VGN8jIgcXu_D*=@oM#Qx@TNgKv z|AHmqdWfXQk-S3e+d9jYfP1g+|x zS6;QG)n6Si)H=U89sorU^Ep{8G=09w!;(&miB5b^b9;U6ebhyho}P|MK3!#beb_;E zzB4(JD*TmJIcw0*e!X9((hLU{ulKxPM=Qd3=1!;>Ls|Fw;{ZZt%Ey?rIKaHTcdW1DE)1OcnEH#>4-lw8WyzCO20no+qY7O&0*W+cE{~Mg`f}Q z64*_LGo*l7>KwN@JuVKM=Uk23f^i542&k1&m>&2@bIsTw-KJ85R8MqFOrd(|7cUG~ z%E1gN?5jm!ikUj+{a8k=jd_|IH_Yd7{B?K+Sa73(WPaPFRvdaY?FKi;W?xkHIo*;E zpVbbXSomYccK!c!c`8kVu?4uOU1Yvt^FIZXJ_tw`nR#P5il1g`Y;T4K(-gU?-{D)A zPsPT?#l^-J>A}1J)=1>CHcFcA>grl<4+HTIXhdR%?u(_-0*w)q$ut!svAWx{>CG#% zCChaE`O5VaZ!hq++pALw-{@HX-vx@_It*Cll6YgcD!E#|<63V#huLWA zp_8yM0!)KDFd}5_FK37O>`UZzR-)A}9RjcIiBbyKtBh7_^ARdAI0(6{v;plaEc`nV zi{k2JlkHqn;VI>@{;WIlfS zw5gC2$D}jW;9hNGsK4*5t*s4GWqz3t**_gtCz0tM^jLeN;LUl6j!^Mza$tY_3$s#d zQ8hZzMdY*Xms*3^w@A5dK7hh6I9|L#UEXZ~{$aLm{Doq5F~JZ7(P7qceCVnB*-jc6 zlXlGk7!EOUapPc6gCPcBCX?}@ldCI_j@|9)c-`4EHEIl4Nc%J!u6LdJ{OiA~WL^Mf zzzp^GTrlY^dJDS@w!jEyu^s`=T_aaNMvu3H`B|EA9!vQ7O4s)R!TUG6IAp+`)P$yt zYpbZJ>`qlKFE3vrDu65%nBif;!AoeNzM!+Tp?0g?IH0q39)1t4PUJBEQ*Etx#!pSDVP* z4ot1zbM2QidJuq7rb0xH0o|`Z?g!(iKanfq))vf%=6X5!kXFytzx~0tGEscL8t1k( zoY~VG&xXgK-h_ujEZ}hgmZM+aS20N6{9rD62v8SDt%4cdAdftrr<$);s2Sg9)FLsv zS-RdiG|G(?Q09tNo+Z_B%y z2$;5T+o$=Qc2c)X_Vx~r`n&tiF|OA;#9>E&{Z5ka1?^>o;2pQ?Q3gms-+j{xh#~xQ z+2UTsLl8un+jvo)w51e02X*zT==XlN){txQh)U2Sb& zdp4XE)$J|yAP$1XU_IHrNWaD3<8wVIQvN4*sX~f?$LBvaF7Eetx4IqQfP>$kht2ya zRwsaJ8ja32db*2r);ex)n4lH^ls5+NBlktl_ZN59NaVEa#>0$?kC(D{wwx?81dcNV zk2&l344q71W}6RViuLGx)cOPueX1G2H?Z#W!5)%Vn1Iz5xHbH+>gj6h`-QJhpNTYH z@A0|)%{(To;UjpWw`Wi%Y-00Tj16lKoyq z<$xZV^v3n5^BaXjKIld!UfwI9f&dbTmGKemIKIJr;LM#jhyADmzK>Eu&pHv3Is~U2 zSA6={vZOp-1LKHQd*!Z8e*KS>|zR*Qn0t)iE8N_6v+2J{}&Z<#g4!o;N?wOru$d{iHvp?pQVeztAc)Bj1+ov%CM0w_nrhoy? zrmaWbHv%v4f(KKFW@+ZL?(H(!y~}FMdw?X`sd=#7x7+Tp1LirbI_H6dG{4;bdhrpo zCD7zI1~h`0r_8V?_RAN0X-7nAO>dYF{SrTk3;$E71-rZ2 z206a9ahvTK=<#+j2xpf;sVv6*#9ruO5Ady(9|qNezR4xFF8@uqRFe==yFHpq!GK)I zozxE?5@@iToi6*~#6@eX7)Sg~g<;cv?z}AZ2v{B`3bnYd#xKeT1bU)kl>v$(c;jLd zLCU{TO#!+}tJ(_SlSDypfv{@W)mA=mw! zsUdt8ZT>Q;>6~b{pz&q6D#^D=^CuiN(WWVyyDP7wr*AlSw1JPGm>6-C&9Qtuy*0k6 z0EX~`+merM!Qho+`S0mN8I5C%0Z@Run6?l+G(4rLl9qJo}BP#~#R+Ks6tbTGRimn@F^7G_BN(AmKX$SUSJgP-wo*Wg{&>B7#&7 zC7$2?3?RBo4izG{l{(N9ZDg5hYHD`k7C|L}URmfe-gWSlDAHpy=IYGFq_d)Z`NmIs zp`)u$D{tSHx2oL`E(W#BpKgsUqdkyM5$Iz~L(+!&J@<4OUgmMRySc1*DtFP@e{n)g zRx?#;ejHNqVtgng|9E|1f2wjDAh!2`)c_0Rv-sb1$I#a~?E;kH>~qL@u?UtqI%a0D z6x@NB?0PNHnn|ZNx_ugeZZyg-M~P{T*>~~WwlBk~ftQzIZpaXrV`63oc=vWWLXgy@ zewSX){*e;!KLF#TrVw$Mwc^1cQzc$~WSy?akxfr@PL7F)Rn>8oEsYeF9Mp6aSyq(BeyT*o`iK*YL za`?O&*aQ%JD-vnjecbcPf}uoQ;qrv*4!kt-KRZ{6@Y<(SfUQS!l{e?ZKme#KFOQML z$@*j8nhonGA0{x1h~#x7-=F8_-s6G-jmqJ`K+UTWv)r%A+bML|$TJL+oRFp>NbF@e zZ$JIWQkZUV=h`J##HZF#R6LwCPHEUT1<>He&A0VmNbHN5&>-~`*k%Ao$0GIt4~|a6 zX)#fv@8rbk84fO@_1oV7yaH&zuv%;d2?TAA1TlhTW4!IM9EnrB1G}?kLIDq}1#Lt4D_se7=0 zYyWnIx30#P;#LS78F?d|Z!bqN{bAC(0OpbYPy)7%kvDx|y+@?$tE+uKUVqio;>uP? z$x^KDGBBI1<=_g4C9E_X1E-Z;29HBr67w(=xkyxGQFxs9i1mzA;F!G99Pd{9-8;;@ zJ4^Df9tvYbAT9}mTaP-t8myUu_G_}Z*5$eMpvsV!KVr$9r`@>tz1N$!pJ|m-Ax%eE z>cN!3WVv^~U2f*M=Y}a3c>O?4#%9v8xrsJzBMxPZ0Nftwf%TMvYqv>?FUKQr-o#lGQBv;4~(Q>0(dG3-fba4@OkNX24o zZfO>G)fBW$Iiw0I5%o3{j;bbdo%iQF;+d`BZp;emhk10lo??$0aMC1EGMd4b`mqdO0uTuTQYh)bQ6kVQ)D*ZcDtxjz~qv(DE0yDEllo5SmiFn#>+&588Ch9JGPjOEhy(Dy zkQZGWrG7$*Is;He-YAJ|%qxQ2)yeTc0c(=Hv1YYxp5Cbk)yWc1P*gtghMBk>sk%F(h>Ci0#E&B*B}Kqy z^n_&mL-lkRwzWGvQ@SWelnTOep(RU{pMSM&OPK60H5hQA-z%qg^+!!XY}$K=2Eoid zag(^&|J=-=2hIjTrfYj-#t3d=Q1RQK z^ZepQx>v6j#&bwbMm<5aTnys|K0B?xeun$d3D7CGfz`B3TSdy*7%+c~yK~t6(9@^< zCzyI_VO<zvMI%|jCH!rm`RKu#Nh9AGt&j|RV20UP=5En~0jC9iN_6|~@ql3VeUEmv6$va}pFyi?2Ox@U#dCmNRH#{CUuc1W=>2a@n}(=)k%?4XZT35ZH^4eeN=-y#|s@ur|F4QN%xHU62t`q6*#%L#?2~YV`CrV`4i`}K!i?#G-x(cV_!b(!g<96 z(cUUep~_;i%wbc>D_0+c=RhP}3>Y*4D*!KUlbq)OlzR`tZ5SQ7t*z~Btz#maF~;^Y zIP;V2d8YA1?#bKrfs}cW6a}&3-rIUP9jKk*c##g^+yorAp6g|O1!2W%j}%r;)GmlCl^~MbJ}22kf5jon$LVILn+a02IJk`es51KYq<&V`JlR4VYX2 z+JRdmS_hN2y%E4L--N*;OifoL9M+CBCHNb!2KxtB?${S*8xR3&C5HmWbl(q8_s1L8 zvfmWLKsy0&CY%`v6$5w?sAi@>viGc;zF77Li#}LuL71C#S|?^BGKq3lsv-%_y+8uO7Qs=9V$I0DlL+dsT@>I5E%5 z@rYSak1PFoflcUBis^3@Z#T?e=+rvsqd{HV0qFqJMWl%cCY1dANo!4j9{j#D6aK+1 z+XBG8LK6bJlp2RN!@;ZIKG0vP ztH^;tGFbl>J``9Dr9mk65G-mYLoZvWF^MT8LSOiDC&^o0J8sr>h-_|d-bh=4-!t7& z%#0&DRy(TCd3kWtOT2l2nV4ac$cw_a+zud5I)hrK#JT5_T-LIf>P>E7Xc+W#%kgYK zFF3er)npDNOf`pCSMCNH>$|&;a&k8OIr3NoJb~9d_f7;0>DcvnhFXXsm%=CSP?b1l zJul#D*jQPq6_RfN?z+9Z-nY2R1{4fn!JGkhW^TM#`ubF$22S5iHbcIAU3N zsp1KOX!b*aCCfn~qK~(`)$>P&2p}i?%owqHdUvTLQew@iE=emHq;_>RI>ELB>`?$j zpxm(_V*Re|4icj&HfCdvajb9yZGh3 z{O#EoLIl&y*(su1I$tPYyx}YZfX#5Ov*|OEJ7{74`{DpHFBd>Yfh@osX#eXd;wOGt zG+vmQ5`TOPi zose)W9%U{e?klj^!!Fl|ymGm;sx0C`bPHoIvjB4xtn?tg!dHC*!eJsdBUz67-5p>) z_)q|S1_FSKR&0fn{rME5Zx04l0f)2ksBmtn3W!*Gmsv}J{>aGKcqH7A$te9B)TRr* zAHdi3eAXE)PTApph8i$wCtt6iWxnpINZI_s{H4d;{rzhg-$1H7oay|l$N{pFej(hP zq5xp~Mjjg)&pGz~Xf$29`kFt{+}$1QOu`1>k!yi;CxCX_7&qp3fADHnA(+pAyMTks zML#^?*ZB4CSb*Zdvpbr0jC>7XM!3magRs~865(!d=!HEP24jmeW86+V6IGVe@OedILCxB?qK zObEpro8B(DBx5ek%TE1M()3_c%c@XoGquW3qVTjM7MJ)lK7phLE%<>>4D&9CzwU_! zJ(uNqJ|S2QQ?k41=Qj6CbJy3`(b#m@>^$?LS*&?>Gh)Q*x+}$ztk0s@;%H?14&2pR)iBb4 z1m`Up66C=vxPH@MAa@r&7#nw<=s_TaY5EekwV$2Z9v~D_7M75iP!hnC&Hp8BebtVZ zGO;}nIzM46m%lL+ZVHpl(x{|5j(tSXrz#;xp@0wZNqfMz!Wj;n6d;VF^d4j0$^X0} zBhOH5Ap+UkT*Y(&@{FCloqVe9`4JZ0k#~w#`m1YU5PgS$S9-LOt-2?t*8XNZ&9dVk zfqKJ2j&qqkEKA;8EvDAttaMlK4mfgP_(>70in3%?UAg_a4pF4v?RG$pse_|7C|AHQg>hsgb7vFBN5DOQAT0b4UMY}hVKXVXJO&Y z$~1q?U=7T`C>gRp$$I?zJ)AOLenjyx&C2v*ABzk+UPgVAC&9mg#iryXeya1Yk z8OLkiqa*sZ#C7fZo%M;e67G?ALm5CHqCP_&Mx?n{d%OAf>-ido)#rLof+su_9e!}> z?Vxc+L^p>FHdh$fG2n*S{i=jyW@pP}ZDy%6(Dl~!w+O2xaPglIZ!7v z4#X2I7eGAW4;N2(1+=!0)qW|#o zT$}0st5!n!D#5!MJ!yg4Zy1xDoSc$U>^y8yH_PP83nEGj33L5D`%LEzZO+ z3``r|B(wJRa!CO}K|Op&JRBU5!GL0CALo}I-s6Udv&I^+7qCEluz+MOP!=vyIh!Ht zBXsWGxmP5zS7_vRNZ@F6TtFhLdVOB+a=GG9#^LgT_5Y#$U^n;J_IV^=GW%=2jh=?< zhC7k@;h3GhJwS7t#^saR9K~@ESXeXwt5qpL1GKodb9~(6*54qH*jA!Dmj_zl< zU|`SIqq~d752wrP%y(_YTYREGsIf8Cyx9NFIq*RG6n0)X#gWMS)LXB{?Lm=>57;Vb zQf1R9BqW#pYBs{9)ebCUV`i%&lNA;0R((KpXtDUcu)EGr0iJ zPnk)F?45qs94{J+X2u9U#=GbB`~wAk!2P^snoT8$|ShYfUUSJ8|;hZIY6yvr}MwZKeTN z{~iZyE8!6l5#izC!NG7gG$&^v1W1hFM^gj{I;g2ZIdpWvj#hBRG&p>I43Im6+_x+> zwx??%2=D(LT=ODU-@C+?EkkMk+j{hFO$)wFDumtizgx^MaP2x;TMt71`z#b}P0p2s z^W?ve^+$}pS>#*~|7Sar%c|C2!65u=I&!$E8GZ~R{}oHZPj&tp>i^Qk`^+ct1Z2lA z5Koo-d%HHrC+sKxP>C89pKCwI(9X7VIIRfkk+~G{-kcQRr)DM_3o_BxPu_kpHKs{X zpv(G2V>VSgFw$ne@o^!oV}P<|1|EEMeW)y6DU@_&`FB3(WQGYigX;T^6C|Nk_7q2UppcHMuqA;UG}xm zVf7^o)Ts4XiX@Sin@dV?ONecE5*KzuqK#t%qZ)&f zd^|Zlg0vUa@zw4N^`c`E;)b-54*-}?gf9ftl6s0<=M58llzN}Kag9C9?<2GR|`JPD*7p-8a?;Zp-(|o{78T56E1yKP;1_=PcntA zHjm!tWk2zr3J@$P4p2+ho|#45{G{O3j&|&d%r) zU59-gs)|)u(U*f_X4XbS4Gd7xO84c{nsjV(gKgMl4zFS7{Ux!@wN1pOw!(ea+!(t~ zs-B(>WKhe?%gZHfy|=r2m`Mb-j(sXKurh>_XYf;p zVC;z|914LZG1!u5?v{R~jeIOqUBcX#8BR|dYoN*C9I^X{N~xG4`$;@S-p6Gx9wq1e zH}{E>cSdKc?kixk87=#gz*Y8lt^T=PX+jWgp5VAVl3UliSF)+{_5qvD%b?E#q9jW z|Cdd+Umm(}L#pqLZ$Zj#x8zKXUbx-Lf?7W zc&Jxcei_Ysam6nkE=2h@y=VP}_sz%?7j z%dVc8(LPHh)BUQM57j6)It+QKV=$Ay)2#8AI@4DK7z^w-VZ^y*7R<<7Ov07=^4t!) z%*#o&Y05OZb-2ER~26w*u;z_!t1z2Ii}O~jEYQ$ zKg>H&Pf+V-RDsZWORUDMj3R&k=BU`S^ADBB3#D3*UwoR1B!}C~sgLO^OJ-`2c$#gy z5lK57AI&!V%y}XXBRDU6-SQru=PelF%ojdGG<(U+#iqyQw~zI0K9QJEBZLiW@SS#^ z7=^$eHq4^j{R|8>w~dk=Jyr;&5)h}PlYvFDBaUDgMCQVRAP)0qMq-JwfxTzM4Vko{ z_I>4Gvc9%<6au-ysfe7u9n~CDEWlJBHjrht_8DgQJws9CAiX~v1{|6QH(hd8&u5B3kqoYYX5szUqP*g>H`A=u5UMe z3_4t0``cP)2efkdvyv+j4v`z7W`9H@k(r zL6Q+DaA@GBxa-V}O&Ml*yj-<0v8Y$d=019h1!OurAm0+3WKypuX&3 zR{G3WTa3P~OrHxKsjt#k6&Ihj`(l5uA}ah8ntNJ~Y@KuDS~9b&*rw3Tq?@&CWX()A3&A^+_hpy-c^ptRY}%-s|z+| z=|f39%p!%D-by}D(!bqHF?%HjqGI31cZ8Cp3=uT0zbPflzKQ)nt?+yyWU*5l=fl^# ziHlX|{gOrYzIfYjhwkJ(<6-BcQ|1_m&$prVBY^bL(-EgGDP*l=;{bDs{39dm6u!Uf z(2(~Nzb0^7Gr52=)1)uVu@;Jz)2w0Dny1H=zpz!Zi;FUu_J-~w_Ytp8jq1`b;##cD_SktotEj`Sv)vvW zcFLh(t!?2pC~w7AY7}fiYdQ>sy{iro5*(igF#4S-Qtj{}{@bf5VlW))7Z@Rzap%55 zb{RUm_hw#6bP)mKAm)y@X^c+OpZ2s^yE7VSfCMkxQo%;K#Xz|;mcHU_w!}V(0eU{Z z#2&o1~eH{7(V(s^V7#0#`GasG96ASjx&qPm`o89+Rzqk4nv zWM+p5B__v`^s8*}ZbBh<9<%33XYo>t;$yXIoBAw<*+|NZe`8K|p7W6cg!XiH@Sdcwv#!@$#~ywtOy9qYdUBe zEcAk%<4s5)^nIb4ImlRDr;98UdN>rvQCt8IQNzzs@0~{uHVG{WHOJt|Si*{$cVI;? zPd(l^umnzb;B>y~i--ZRCE;FkRc3RTW@k<&)gh;3&X=cq7TSRG#cI+^yYlkl#N^kD z*f<0ZNCrfH^Z1R;FkosIe~^4LKOWgs>V=E=rOwQ z3Pu}xXIbC%YdqTp8Y+Tcf%Lfyk;?DvahoZTqqss>Ot0K8olUuLGv&1HI|&yyJIn zQAWQVdXFxPb<`y+ZMEB}gJY>kjHCujnuUMMJ*MVR{Epx>!kbHxltY%D33)XbP|Hax{hgG$P z>)seBA)$aMAt5M|1|>*KiG*|`ASn&fOi&u6r9mVlrMs2x5RjUrq;xlY&qVj$=X`r# z=lpZ#wXU_+HDM0M9OE5hyzlee_wTkZjEpOPrfnRUWAXF@%Xh4+KSL=W&{35-1se7C zb3YK8E7PjmjnfnFdD>(i{`gJT=Iqmx7)2&ayEzAuR+yc4FNy{p9y4<|IjHJ5=G+N8 zpe5NTcbQ>ODGu1S>3DY2dar#0T)S_iq-vW)^+vjR^rO*Z#&tMw7{2lOF8p%pVX9D& z^XjnF+my4@bYu;Yp1524;GH$W`Qz}bVA?BLyQfq+MpvFmIM+09&$M;Xsn~IS64@EL zgw`{5&R-!9G(rr$mTE<$84K@MJRsf3I_RdW@N<)s!4KJ^M-|e%e``^`Ru;f2f6!|p zyc%bq7P(Gv7yENxd3M7V!oeoxQ8HIZw#4|MrIU8*I6LZrp# za2r!=n;q70mSQEgg!TQWCnWGJmn=E)$S2bnQ(I2e@VrEAtlLCBtB8)g)0?f+;{r<< zqpTpu)v7b-~nRu~?sjD?gov|Ns^)rG-pMd6TQb1YF4V9zWY^>UOw(|}$rxg#u0s$c>S(-lBYG^8T29xu zM+y6}=-r?9+v(VY_Z}wsJ>MdS@8m%IK{*gVoXT6D=oj7!lK3jp1D}P3T#S{P=h347 zeIf6AvdFLI#bL8dbNap69i~z~hLqk3dr`cGq9uY2Oqtwh9%P+vdhD@xQ{`UaEx%Gr zDhw>DS=rPIzr()Y&b~+dPKDyxpNCx!au-f7-;{0S}eL5 zw-O~C^`4PwtFur)*XO2-Qx9sjc@`j2tHEEa1Q@D355(N5)5f&0pqR6BRkQwp7nl`W zTcNn<+H&7PSt(eVxSS{ybbVum zTQSex(JO7oRph;CPm?WZKA8QY^&1d1Lk~m_Ki~+l%D^|pnrbz+mu(veX85WQ${i84 zPdL*vSWEOPMPYi?qTDg_!EB3$WDe`gH3jt0=FK%L9~8t!wx*9JXj;oNd<}nARtEo* zrWu-#i4BIEY~9Yfuy?q`j%DBF0Nyu6m)ySSWH^?`RZk#}m{#x!>^41|DGx!hzi?HX zFBU<>{NO?2-St^bH5^qdMjX$X6j|BlEb-_cZGF>HQ(x3Dn&vATRy90EpsOfPWI?Yj zH2X#V#tdUxX-VYWU`1KiG$Ung4DdCf^`N=zsB&35*+1b34=h_$JG+rfiRLDNasM+B zuT4So0_rh!mu1OON8&@rltoWSe%*oJcFx0C_n6rA2Vf4LvH;B?+TI#PZ09}1)G)AZ zc2%GYuGD}zCr-|3;Wn+ds^(%#j5#h$6HM+nLhpT?7_{B z9toklx9NlBz6`0Wqa2hcmrb3`FHdAas)PBg8!G0+GJ6Ixcxk{95 z_H}wz?-Vv>EDdoVW0YO^7{rr|edJI!9J|n$1}4hdJd&4CuT;!ZDCiR(#Ok~4TV7KP zV`!Cp|8-kur{05_+m3CaD|c@eh0#BFFvZ*n)or$?==4lXl8>(ys%BGtjD+db*Q4uN zl(xnoBLDfvYQOh|m0ir^Z2D^#1P@u!&Zt~S&{`lU@sF*N*_HR#=}GdF{r&nsCEai_kC5yqckTHn3EAAE4rN~_W~ zKyMMJay7i|sHK0p`#yb==LrTd|zYP2Oo=&57g2!BSaX62gWq=WQ{%R`yI4k(*(Ie2dLcQ-} zVBlOky#JjTYq5>iI=l}Lv~*zXY9Ra!?|RJ|uyD9!94!wQHV09F#O&J2#@yiF?VzPM z9j~FRUuc~UE2}pVHO>c*sc0TN$S^jA_a5FjbNWvz5R{<*edhmZMehH&&F3g#@xH-m z)QU&2Foi7;on3=dXK5xpbEJzr>FO|?#5yC(HbZsFsVRD1v&&MVQTMF z(1?nP-lw4fhtd;fW>C(MY_R|RgKoimmR8X32b~Y-kW5Ta#E8EykNw*yCRS5(bF$jM zLM;FLZf$ED8&GDmV$MJ%)h{4G`0PJ6s01VIUKpkZs-BE`q3WP_$Nz0rrnNMf zRH*IW$K|00Dso=+#1H&062?WicL?KpLt}XZ{W_2z4tja}}HzBx? zo=$g|s4rNbQ!0h{GRSwd6Xhxt>kZni0|nHkDG3+u?t@(G;De8xOBdnA_eV4qhV}fg zBXVp6B&j>ywnxEMrj<}8&7QDE9m|$N;P73!5)7p)rGCkJL?IZ_ zcPC!!7!VgV;SEG9UY*)M2_@J(dS37d=w1gq*BEC^Z~Z#PEH_`|WaQ1su@HZ;^0{Ph4cAXru&h%#krnFu*+q|8^E= zz&wcl>Gq=jI@T4!zzG(q^i={V_0;rQX*meJDoYR=@Cx~n0Mx61CfNGRdmR+0)8Z8z z5h3EF3ne_ZMUG!;fG2dijF&r=I)DVZ;J)wx|By?qpy${f#jN6#l;_HyVq@PHt4c^n zcw!6XIF5GC$DP0jR3C=2jeSL91h#P zq99HC0fIPCPJl!yw`g$WKCA@z&W^WWt%E@YvTZUx#4}e^eg5H!Xi}KKKIz^;msWoz% zVXt^|Xw2}YVe!UMT+)D9F+dhmsc99daIkrMozxPf$D980lYuz}IJXm2#XC=yi*d5( z=|>`TgDY91GM!q+KwfqAj=dZHG)R{vW8RdG@*S@W@uuv~f&a#NXFw^zd9xM7!Z!pf z;7>#I@u+(GggTtkaPC#&EhlY1o z+|w<%>v{x(cW%A$d{4K1QH#!cjEJUdbw%|y4xrX_6Hie-lLbDER_c?R81PK7OanB7 zQFak(4c&21Jvw`h$f;-VcghSss*y;|9CPG1yL$7^SC|{*5KKPkiRsC_Nlc8r_kA2k z(Z^t>OAy(A8ghil=Q02+CXr%`1&U)+ILwHo0dC|?5KbKsE?kkSH^1DzCV3Qap!49p zx=n3HdBQBzJF3@Yf2Xff?SXPy8e=$LR}?h#D19gZ5WL&pGM!8efk14o6PT3;``S!p;dK0wzUp?_du{?_O5wGZ?bG+_+rbzqbrs`ZMcjjr98C*J;y5io;Q#z0 zaH-}?g;k>y1}R$qBJA_lk-OTuzW~Xp*9AXpEu%H+6{{&FoDP()gh^Xh6m&MNL&MX0SDL$#vDm9e{DY+bE?giKav|S^+Zdr=6|+_E_WEZ?OI>Tb5wzN%_SAZTZT?G zGbvinCD;9JdT^s|5bLO-Ch^v``K_lpq^u^f+*Lr+`O_;-eVb^XqtFbv8Wx<;>DkQ9S*YC?tPhAm^I2e>r*GA=(5EF?Xk7m z4K_0jropg$`6GAj^16XF>o@iNr{*T(&jOkZGxsYH-??_BzFye#x3*i?Gu~I#)*9r9 zdw4{u-;DgIO+ik>bfuPp-PPM0M|=N;lh}E+;`{IBDA}EbhpLVkmgD#0^Y$ibD4hQl zE9P%WexV(trF-x_OqOm_oHFgpCZlr5zKck9*9X~y6P`IZ~b@^l`~|`dKRl zO{s?Uf434t4P;e{Z&KgkkWgM(fS)Azbuc&{RB6o&?P0_ZQh)?eP$7<#nV7=(M{ zrzyz?vy+eH+z}$^Q&Dc-IE9~XE?@FB_Qrebr1phipRx%6 zS>A_<%5J2PMC;zu_$OsGIpo$)xa{ui_Ff3`Ol+bjyKq=L6)0HKy@*ulKlLcPvq_6h z9l61hZ}NR*$qgO8Mg5OUXTOPCw~Fg(a_~N1JY!yts$6yw6e~?U6d*_kQh(U{6SW{u8ClQ|bS+6GO6<;>?8}ZjdOG z0{w@`7%mCfGBT4gQHzW0|1h_5SJM9jb1Ou5ENCW|edST{pD?<<@VicJEOB43+jG^c z9P3mpcV3vthNUmuLd34mG!MyQh$(zunfEWkr#}(JH4|w0G0pNdcXaP*O#sjCyOZF* z$Ct#~&SvjVN1{~Udy?xI8za^EViTK63%e9r zkJUbgNWYkUfbsj0WyE8z_%EFHeX%op?Qh!|f-C7v6xlbPdL3~HlKKC!?A6$!!; z&3t&RT$jM-K?J_6!^#W21GXB@5BuRC2HA82gIUb4(a-nI_6by;Et4dT=&T=2yF11b zj(B5PhyO15H2R`AkihH8O$&c1;oX$*GExOcjv5WhwWdF`lGFJ zQ5>wMJA3Uk%*ep<+q{htH92eH73`MTv}OjmOw*`yqebF+*UI35+}i(82ethHjY)Nv*GM$C`BlYFPQGb--c{T8M22(^oC%1P8r{G%E?Ch0{G2_- ztgoTlLj+&U^T>aT(JuDhjyi*Ts`{oqMQp%)zOatN(D{CmOx!E=tet z<;t2_7~8QbuihC*fYmT6u1<;0I=#DyzVLdzR$Vz{6QIaLvf$8<&Fh_sXg(MVLhW?_|!w(h8*|misOwg zniMBk2 z8tLNc{8$sL)ZM!~2>zs~H& zyw%6Kcjet3Wa}vVpk#K-9czY=j@?`x7=8A9Q1lwL-U#16Qh>?VYAa~nEaPcG{^eNh zQOcpF1xJ4`U^3>zNf`a#Dfcm_b%x-++$OCBDx2jYp~WaU#lAZRkqVQXH8*#xY=+Mdo_zA#gc47>pEf9 z=M2XeOYD+53rSbC{j8aX#vXChpZFMl5jVP+Y2j}+h7mbtGVo;il`1ki1s7-Z7~x*S z>3tTTm?@P}UCk?3c;)GS??c`e)t!%n6c3LHUdKnf<>-Uvzor}W;kT69h<%6I?dvkJ z9w9fu&TsbM@y0+GDM2y+ z{v(=AKH_m_S(cx3wzWKhJi3!wtCuKu-Jtm2jSl#i;b8?WD^b*Kg$&}@#9vh&>q zL__KO!CyUpptStLYOfFqY-B%@VmQp1j|)vZYz14A@G7y0AA^zQp2xF8*S7~31rcLA z?|<*%9ej;>QG`^g9b6c?lBv1Jx7nM5U0HiSoXGio64#@h1jAj`s@A(HeCj3UM+egh zT?hs7sx?#a^8;R`pRrbO;FCiC-qRaFW~<>e*qGP1_wBz;jV!~o@_F^kJMEcbt4-~S zvZ5P>b*rAC%^}Z%@o0i>QMS6g80d3yFMGgN+;M?6h)%+h_(k)MrbDYs1xMJ(SM!Bc zg;mk1=QIZuyt4+e`%auxT6>dAhs>*o?PhcbrV3RH2=Qyjy8Ku7hN!GSR`q5Mp<%02}D1_i|$DDLQzbg{r6=In<6;2?oi zHS*OXOZewlwzlDUhB| zH!39w_UsCChH4b2fFEm)0VM>qDPAy>89*l9L_S)0kTgOZWGo>|wdQ5M?w-HXjd*}cA6gsfSg zuUB=p%wx*2QIG5d8~N;Axs;t(qf$VFyFeeNpgCd-l_y5i{4K|OoXrstM7qR6`m^5 z(wWy6bLFV!vOmM47J_mHE;;)4_YuF+B&p*nM1KGD@=te~8ZlVym|J$CbiF?gsLkGk z^!=|MghWKGo!me&O~}J4XUI{|tZZZ1epNrD?-AT-FvxtiH1J~jg#>|l=7Wxxh~mvZ zezlr>PAhK)^qZyvuiaMAWf~K@AMib$NdHmkn@~L!^844`Rl9R_bT`{8;3Q>yU+PHD zbjHZhr&CB~e|3v+8X=&nVgF4pIb$T;Eq5tvCd5a`>UHQ_+saG!k%avBp*=yz^@Kp5 z>7pAYc3SY!pXlVlu9HTVaM@Rywmbb44dk!6j~i2XND2HRv$US?=} zvNaY^gqZbRly;d}eX$DzN-xK-{_Qu49`wyFwfL{hmJ7M58zK?js9koH5j*2BM4)L& z$yADD9SVxuFcAo1EOKgpn7qa7d?8EBh1mJ`VY~V)7{b@D$KO!-sD+2d?>a?j71rjr z7080ee5+{h?8MaE)}Y+=g;w=EvgAxY!inO8rZ_#bLfQC&ewQZq52jZvR8&)4+-ver z-&S3Wc_+HPs|E9;RbmUCv^nj6xaYY^QI^bGd>w)nKh~U5gwy0GC_W*&2YDWb@whng z_V_{L%5)_vb_x+)KFXT$mfwfr2M2>T!6k=h*?X?KP?qq0>E!!>6=U(t%feTS*k|4; zKAbsUaMsN!(XOIu8gqMBO9`3fxLEhl z<@cFw;$*&4eEZ{l(Kp9|D{1D)oOd3jyyf@6%nDX}TS~LLAhRW9MkV>Wi%I@26_xh! z{sxcpK0k2WIu ziu4Y#%t0mPA!+@I(2s|wYbJv|PF1Y{*Tg@_G-@FyAc`dnb9Oz^c7D(O-oXm_&iQ?8 zqt0!*%^+Z200`pGNHGHy6d>M!*!o!iPqw2-)XJ|*l0O(6ZSOV^(Z86DJ>_j~zO3?j z3yCjCaVy-8%Kkg82c6VlyP=}?O1TxTgw|!jGVLojaCTh+k$SR})>Fc@d17SUOX$<$ z%k>iR)#}qdnv!>$kcnntuS3eh7jDxdUt%4bvTm%KH1dcKNUaddtXAg1^w9ooOtMVU zH0$&!VmLPG1{4Q<9{#u9@$JK;&E&KD*QHM@mM%4~QEW;C%xBDPh3b$fhPL%7on;b_ zMln~ZI_$_cmUH#)3>!D+-a+iONXV%k7aB_lYL4>(KuOnR$_m)2p--*n;&@$RSkTZ; z%0zx;t)hE=@7di=997|fs@}8gSozl`CPgC?l55X;t<@dA(xLlWV4ifG>;c=)BY1z` z{-4G?Q-fu%G))P1fbK@)v}sII)%w1gN!LTJ$f3Kf1Va?nT;Rb5I98SY#&o2nBjyG> ze_ro3K{87MQ*MlPY$~0d=Ap~) z+d<6&Z>0%$*MUp8jY@X-#vvTZJ!`Y7k9tTeQ?Ui+9TFBge{3kR?+ zfsbnMD?{48u!p>2#FqcZHiyMMJ6yiKQO^K4Fq+m@!yIXfKWDWPR2_;w&LxGvMn+d$ zaKl%U|9lVH;_ZoD3N){%kb$s{C zdDRA3G{ot#f@u`)}fl=~@u zxOlG*CwArdh4$N}a`Vl=8A7sHzO|lx=~GAR?ypQf(8RjdGC#ZlM-1&lSE=S|Lqh{J zmJmSSM7w+q2&UkNXok1_u(tP5-643Te>i6|!~gLU*LWh8ayN&o{`Io>L(Qq|goV+Q z{-Zm{=8RnqR7QX-`AyB9e;N%<6I!eUf^F^Xy}j`LQLoAHZV=U_eEYTxxRzttzi*=9 zuiu|ZeYFQ|yxy^Yzew2(UC_XXwIJGuenpOEwW^9rD+*xenGr*5q z87)178u>A*ku-pJ-Wt912+?BtIC>RWYyff@cbJcdPdVq0YPp_-CnVGY9is+*`3si- zs`K}n@(Nx#DXZZ_KyAdDRroTM0~r!5^myc4HehpwdlZ0$z_eKK6P&0_fDHhXt_da_ z|Kjsg@tyx8nbpL*K@G4GrYmIKL>sz790urtG)03^j|+MA6=2g7etKL$d{ogFxM8Ko#hei;c>Z!|0+11Z-Jc@ z8l)gbKp;+m9mipYv|mL&1%3^*x3>W+3Os}+kTf6t{ZTe@RB#f1icpgk zY;%1YSY(bs5;5XD0cwyd{2vf*XgzE)Rpx!Y2ALk&(V6sR?1Q z91j=Mj5zjzOL@m}feKOk+T`342J^HHbb);6XYd6A2p;60ChVkIukAsbKUD(n*4*Of zK6NSoZhn4t`NiF@;M{u|#gFk6zV4ImXN4|DupYv}ES}@2)kbWQ-pO_y3&1QU6>Vk@ z46LR~{6${;2dk6^7)b#5!@KiL4C6MNu{@wfz_(9`gO+I>XH+;0Mc{+4Xj9iF-a>;7 zzG2Jb=$8Qg%m8Q}kl6rFWe-3EL9w%x8PCp9yUayLj+KUD20pE4M~%b3DLx ztb;-kiZG;E@TS!hn>bZE0U#sjf-Pavyhe|Wc9%n-{!@9G=_a<;6>VBJw(yfu639sd zVTVUBEE%%~jEhx)VAP&_dElc(|D~|MeuIHyC#IC)vt8IJ%1tB;Kvup3VEI8iPy%C7 zrSh~eKz3U4kw@^m`M|W5(Gk~)Txp7taO*b{Nxxm=SXelsUk33WE&wqAq}HR*1RWY0 z0=jJtKs`Nz0Yd@f(x2~&yb~;9mum-l;7X82$!$R|;e1=3k98=5YzGJ%_33?OF|N6u z=jJK5Z*VEx5QIh;xNfWj#bjSD&xkM?b?>IsI~ANE?G8s2rVioU08{k#<2M*5zX28b z@~9MWt)h2#q4zs=h~^OtN`A%poH4*R#o`Nk2lKNT(r?>v^r<{p-~PI0Zga^eJR)M#|I1-C3g+<|I=?SocnHIHh1@2?J#ZRAF0>ATf-ey+5WVi;L6e#$NBATCrSP>N*W*%8WRKH0$_jvz>8|8$)n-3 z?+zvvdRmZKwS9!zL8AAa7#=5EAT2CXfI8!IY^>U=S3eZ@0Ylr~)`mev&Tac`1e&uL zi9Ah^0Z}v19a%oL;%?y)tVSGB5`aBUvW{$7by=-At!TRQB!NJ1Bsxr#*XpRPJc#w1 zQW!x0(H;iE*Muv_bgUvgm8`V?n`C6I(`KGUv4@8TU{V4}*yy>qVwfMWu(%$~MlL?r z8Qdvj&Uc`unt`+pNGl+vnyFaIAuxkytl%~qna?eZ^5Q|7ryFBRcZ~b0sHhqa=A)$t zPf8|}JL_B#WA7lMDb=BV&w$q_9qy*r-p;m#0}IL(sEdmfqs;>}9%L1c!uzMT>gq_K zwm5Dtyehs;1th`oLIXUi6opzvyUyjGx~m#C2LRDs9I~2fi}|e|mP)`ThkRCKBPp`^ z?zx#cqa+tCM}D@2Em?{0Oj}*`tLc;m8*^N5ceSn_Yr=Vj8~1r`uBr2c&*waQQu0RO zB#JgF>!aXry7jf`$MmsEtNO1KjGFbK8$24siOI*HLlgAXf>SkfrPTd~7ItfRxlmzc zOei9TN-@6}_Mpl}bf2syAInq(=d5PNxB9U0SE^>j?s3igPDUq^QRw2Fr?ZKefklxs^cK zdda9+<&+nxhs3X3tuvq;^>zDp8s8ASkt>nn`pk0rGF1w23F~%tgeYnj38+AysA8fB zNf-wDI>0t)c$EbakRfAc#LS7@pPa*yfCcCrJJ*%kCZYXpItQ>+KJJ@Gz4q2b|QdvLdP zEUiURWQWw$jqtq8Pn;}~6vV=z6Q-+68I~y9C}Ir+BjK?!@8vmZpyo-*L`IKM&ZbzY zh#ZTT!=OsYIa-OAMlk25&w$Yv|FLfCmFHvd9JJtZ+>Qd8flGWWeyE`zfQ}tbbF%?I zTE~ZCy+Z4GIViOZ2x|vKgQR01wJOrBGQPw!J3kL`0hToraPtIVWRD4Zp;0gduJtXZ zNLN^ClaA4V{?W9qAQuGpt)@^7Y77jGh-iucS8y+WQdwElij1=Ol(hle9kM^anIMkU z$%J+~)0-n=#i&)J3A?}UeZAB8N-5=inkr{N4e>hoUwXpk%p-6X6Ipp13mbdUz|qn( zt$tJgz$U?BW|il~sQFd3K7g@(=`~?*7Z%vY!s19o<%cwo4?-QBwdTgJU&h72TJRs- z{+;B5{&S8uK89wO`{D}6oc~woyw~=sn}yotuCq{!!y#P1iHrH$3ki4?6_|JcjC%i~ zZefw>OFly9@-UVynvWI!e8*QKbpnp&WA%c%T{qs}f6U!?YVF>xTm|&ncMj2ONT+;!t#6b2A}H+ zZ!2Ne1abubKJsA`_M4;@Jn!J9$v8xC1rsF$9n&7jG_&!0P;s$ww_AaegCp_^JxCY- zP)MI}+r?wV2EJ9^-CkqRlJ2RU3$MIQxNn*8u+6(~eN^DL+Ege!34US=ti8nLxobvX z%ZxNCxY+`^I|w#9Mn=M%>f8p`c`eVcF!|^+JML?qbU3C3E9t%+vZs}d1D-%7;4H?ttG1R|Glm^~OJv8A2{ zz@7g73#p%cKTFG0d~!H8ghtPuO8}CwWEFIpR|SOuQyLT`%bq$7SsgOc9q_Z{Tv`cE z^bT9b1zDx`4?MLNZvkk#|M5A$%W zDwMe-Gk7d;0p3iZASc|b<1#8uv@VvjE?R*-f5fZ)iT>HPA2srAM9{f~q7 zz7m%XZ1KMt(8ZyRs-I+J2uyHKUNm3*@?MFv2vF?#}g9szHf65XXETfzet!HN%p!W%n@6z(lfQ3YqhiCG+cfi_H#9c za)h;V;f8tDR_Xh>9ji~Z32lj;%irTes2dCRJ~ccU!~kP%!mb80&!JFwL>I)(H0NmW zSau%aXU7B>BiT3f1zUzM&F|$}-VlVDnefE)DT?t|{BCmMmhMw5C*2@7fI?0AEx7Y~ zXWu(m7875!23YfS7sUt@)kpE6dtf7}OR4#&z86Av)}?`G93z!jVnxV)J>knlCxgQi zIvMMN=|7L!yyZCcYB9GW7`7ua_*l6gw64lf)v{pS|IV)DYW%17du;Vg$1EmjR(=q_ z_S`X?ntW&mUZa1wQ^S59Gh~^MZ-rWEI?KmW1IEPsWVfU&C7q9Lk+CZAaFj8Z>YF31xhS+nCJ~;vB^Zjcyx4C9;m(tbZE(V;)ZSN){ z8bX;rpm-`(CJSaOX!-O9x# zFA6(uy`PZ64f;dreTDk>bqwFWWvR?wqE?ek%zBaIgG*_U{ATg$>WKo|(Vnl@{2fZR zv{V_jr&zH*(lV0dtci2{Si%C|MK}%g^;NSK%lD>EQd80CcHYv<6;gOoSNmQqyj4}F zqphT!?IF-Y4tz~cbdnX_h@K3V%V|({_GJ9M7^s9UJrT1<~FbIKJ};Y zq0Jv4OfAx`Rz~uA>b4uXG^iBVu8m9b?GF;&YYnoFjHC3MRoV+0lncvBQ?erUlkRy- zUUZ|yd|3KRoE^z*grwdTb8Ab+Oi|CB{kg}E@|=twqAlcsf4{>#On^?` z4PHmMQ*JV}mNF2O*52;YxcyUa{Eh9rwB1_oiNT=L{9GbKNjwpzIz(mjz84qNJhlL3dgriCo z-@KoZiFfg$6a|$rE+pa-&E6<~g@_|6h|0bpvK$3qs%9lgc{<=R^yw+qnlsjuhZ$3S z<%O6@4WcNPVQIsCM$<}U#=!|!{vknsvcv3Us|1hWMx9sDIWMF0GHBJ@de@UYN;-$7 zjY0t;LpGG8?Rn{7F7qrzxE{+pBoDLPsNb}7bg@GlFo0plI9EP#>Q{&q*mZBv#w6t{ zZc~ICA6oSHmb@_jzG1 z0dyR|HERYk3oaQRJ+qoRtG%Y)n7app!4w z^z)+^5$;`RQ1nIfLH$R9Z!km7o8^i*mWXunc~qqNkNXPY({UzI_rj;DoB}gX_M0FG z6{S4*GyeD!V8%XeytS@yLMabQocotNE37jzOV-zOOgn^>UMQ8%FGKd~2Oh=v-_svI zHZpj}czP4u#Ih4qA}o$PLSFd7l{|JGM3CAND77tsznxagn{|1lp{xaWHk6;hl%14Z z`V^%Vjb&&0R+tJJfEY^+PVDQkn5{uYFH!U6y42KE#ZJAMamd^HG0KG2J6Js#9N)p_b_8%>o)(R?b92d&ZoPBsH4qrm;%V z6MN$LFdOw-0);Fp1J7W07q7j)vlxvdNub_e$Af)d>iyRY24?1)c&)!O>rP#)J^3K8 z8kgh=Ltkc{Hcg!1D$I>hY;vGd-t%Bo&U-zOsc=j(sqteWQzp}?ONynsrjBr4J#Q&$ zxS70RWBy1cga-s+oSw4hEbk-~JP?mJp`#qr1~2)`_2R@!@Y<5BIf$!-VFTGX(2 zypELJv^x9u!k%}FJmZWlFbV1rvaZ!9{J48~bOr5s1vpVnT0?13tLl^F);EsuEW@ON zh#(?;Hfb?2fEqYMAp)Xwcma(r&3o_$xQa#AM{rw{h+u5(?8I5Jk44Q3rTt!l6BQfN z8HyD54k(w{iXZzMl<`tisj6*Ec7Q7kMdC4561jg>(RCH(-^dI&HK_L%2k}C~6Bi3S zC7h?18V5=o!Vg>$E(?JAco1WFczEP9FAr!(uOPqd6b-t;pFcf5- zv)+vBSFM^0Od@apbfAG^pP7&r#^V<()aTTBiu@y+gIqYeX%trc^Men)HiS;u%`6NA z#k`9goTEi-Z}JHD6?ST!UeZd{Y|`o8=p#)PZ&3QHAF%0i1pPqA-AU{0h1-`OhgNPB zg!jKX{+8#IIAckJMS-M^=7qnA6Hec8*!~rZHjpMC15Gfapg`8_95Zfd0`t6q zkqVeIbuIKJ4?B8R zu8xNBVSQm1H`1Ov4$c@EH!EB08m&VP*mgcM;fr!V8rzb znKg_GOhyfhhCS2%!s1JTSwv;u9$!6``-zquEi)FX(=by&bVNM@&aweEBqwckJn04y zuMQM~@4SUNy_;L&`8MRk+p7#>`0^ukx(lw~&aG3gv$(FIRct%2V311^<(>0<2nS6N z6vFl!jl?ki0hHBiUayrb zgZ$V({fh~xzCQGWybkWYQ(-FXQhE@O5ITPe4c`O?iKMhNpT#7a7JfOn>F>VFRQ}$G?nVjIZ&WZ3)RIi0=IZ=D z|Dwl?lHsYo<-!I^K zH}@7g;l@q+D-d*w%wm;7kT|)BHI?EI!-$TN@U{_a()of5^nH%`t?ADKYpv3U%T2z| znC};Bc;wTejLR7sp2ev)%n&$^ES}2=JQ`ULpYyU{CjCAE#Y%WhVtXJ*oDi!O3`*_E z$t_EAt6J<&T&DAKetRD?eRuurxNPoUKw-ZZ?rnUp;fCO6*WXzTdV~9yoD?3aMum=C z>Wp9_fBjT{_xj6m4ZV6+iatXpDG_0efIpw?sCkN+X+ z_`G+Ogo?*Fwk{n_fbM*iONIs2zVR7F8g?xbm|@_DQz(@Rh+5zmCHSNiI`*}>_P}Uu zM&&Kycn4n#%EtpgLH~t8g^4+GRtKnIv>1LC=v}zIKQ~iShF%^y!b0sYyh8s+>e)K; z`L8b=GTVV`4lI#iJA{|K{HInAt#R1FZO^koxCZ30|F+6d5kk(+&S09GHif@K`R~sy z^tY2!P;}4T0C!?atbY*dAdS?qpn8tinZeHps59HQ5IF|vD|x8mF`CUkT3fI74AlMr zzYIL{c@(;g9|S`1A8L>os>2_WmnU2qo;&}6!QUUqoxA(uTHgTJ6S4;Oq0hfyc(*pQ!%b z4ne#R>G@AE{x9S*;s2Iy4c`p|cOz@?JRakJv0c7DXNzq|eHzutM_M+M!%WMmFI5sE z0$>hS3>i<5^kN3x0yq?RJ)mbe3&s-jo-YD$G9aH13SCSwlXc1<~^Kgjx{|0=2_Xisv_;kAyl%BLJfxo!6Wd%B{ z+m}YuCb(>u%UV&icIW(OB?Fi6o_&v0AcY65-WiNL05!1)&r-1gmQ4<><6-7t< z?*9GzeRyyJP>E5+Zo;s}{lFhopBULY6GnM#Dw^y%+Kq5=Y=C{`m` zKy8LXZs;W8$T<{%HEVsTz`C*rMDER+EO<*pb^BpO(0UD2elhGcw35Q(T zDGf^GN1YrKu6Q#FRr-1Wo{%ZS-=i@)&ZAi^y8K|Pe$pha1 zZ|sW}0IvQUS{I2LM`93c`=Io>@^e0|8t3S)NrmDPe((_*xju$WRrtgNs1H!;fYS}o z+``hC8-gm}fJ1@;vd}=Y&b&G<6&t{^eT@-PVo z607~4M>;Sp?!rROaiJ#>j-rQF_X?`nJYIDGm(MX=DZMy=2OoekS)5i7e#}6eT2kKQ zo$oOGz$#it3!RATclO}05Jt!@Gu~>wR1J$L_+DdWmcLM`jG-(;6Ay_&~Pc8LZ|6oeUDl%LDYs!NmZ`EWv{r9(3jj0W*v?)eR}c@ZBI| zsI|Jp1w_WE-2&|q;~&W5fvL{-L?Lguw%wt?JJklOw>#`6$}j{Vwa(f37^ES)YZF?k zsv{Y4_kRtZz}G?5w2bx1!)UIRt4tKDSEV8JNT{r_Z<7f7`wH3of#2wCYYW9LpADov zU2*e7N~MM2Bt~8tDqVR0VEJC1UU0|Fy)6VR@b$G ztU>7g^ST^vgAX?>+ZskV&qf2mo!Eo7(ABr8VK^))xfM_ZdW$mMX55;WZjHgD9A?YZ z>(CYMBci!9f|}MM_V<4Wd8%E9S<9(I>lbU5xZW$P^AUS!5xFop1u(V7!ofq*d zCG*NE1;!N|k{PyS?oMsyrh7NS{7YRj;l#Ytg;_NWWH^+vVOWha9r{lKN+EUS1g7!G zvI zaRnVM_PyLwnCS#t3avt=A`Ln{uvD<(Qz9jBGE*)x4B5YbhPDD^wiB%ql>hn>|7Ab7*7-4!QBaLr-K$;kiG%oP#_q0 zhJH3{4N-H1O)HGdPnBhhcqed@2!q(u$QO&SBS~Gds}x|7Uh9KjG5}+lG3N&N^;Yb} zsKNBOAATyKi(i6>cc|`j-p-FHDqoG{$fy2 zpiRh}^rOUoZur9m2PxTlrV^p(QhK|(5+#crA054ZH?DFvTuolMaEn_ITS6%9m_Yj3 zBa2CXM1~lYn_zKDdwB5UDn-igde8b?SUu_$4#OR{eTPUQQ=^i-wnYotU7;sgtYWEO ztrk9wwLMya5h%=;7hY{f8z|`2$X7{`ua^P?Zkim z(J77OwEWrWWlu1=^QPP?{r#D%;T_?%1q!$O@NCQ-k%Z7yitq(Rp* zgNAd#RJ+W;cS7WwPh&Q++AT zIhqtFshw*Tq7Z=*_8RBbLpRhE5RCAPSm4jH@jayD;anIp*Ji$TcmU#?EoBxmkGx3b zRU)$lk36{2nzR>!x%Xe$$)**JtgQL@`Epmk+xdJDv=VdDlcA-kpkA(AX&PDa%jso4 z=J6Hn2XNmYJM^g0R)x97VTTRh2W-NR5f3n^2h&-HZwdM|k+t!iy3;pdlqLG*x2?py5QeWuH ztZd+c0ZjRhscZ9|PlPsLwz>;V5t-p?=}ITU4bLs{7S9Z>em}Y1V_Mc~-V(FlTTTeh z!=0blM?gQZA53%|X1RluqHlj&ylCQ=^~0RN>+#J#duUI&^&XY(uGwXhs;`pBuOg*| z2r$sdU6<9_Cx-S!il^^fWZwE!Tx`l9h%ua}eJMnvwHQ|c)BrZf*^V3pnXF2hsv{COZ@ zh(Gl;tCcO?xjyvZtMm1JpOUYyw;$bd)9F}o6dzSN)XR`FquujI`jicT4OD{FfNc|0 zU|ar|SvDS{bQl#ji~nD7Zyi)s8^()bA)qKBAqYqa0!m3qDhkrwDcxPteuR{CN+Ts8 zAYIZSA>G{|Y}k}^oo9dFIWyV3x(XR+SoPB1Q7tUz&OC;Vu% zhiTa{A4mR!Um~j=tQMa|{L`c zkz+Y?2v<1Ru+p+) zkLhmOntf}h^}05oyWE_0AjLpEx}k(E|D=)3zS4|wGJ<#UGW%O22b$JTJc(rG8jT-{ zY~9rqDtTC5i`vT0OI%UY@|V}UlY`_V@+8DG>Rf+KL*=_fggco2=C)O5AU+)`ZaPSR z67mYIphan}u7zy*5(ssPbq=}L7tiC!Akmmj!1LEmq z7yBG8-zQ-gE$Kc29?=?+%c!g!BPVFx6ziKU$4|jcUUuAfntcPD^Bq=yzy?3#aWr#I z(r$mgr?Xa+0#U(}ZX(CTk{Fa@BWABLa`6%33)v6ldi5y!-zkpq&MTq71OEK3F4bpW zXtbP;X~|~jb(lVLFZXr!bs0Y+v>fJtXLcv`D79Es?*jRfZPz!^aYH?@9g#x)kf{nv z1p+eB6hzF2utrJqJdKeky>~^LT!l{0Y3t|)Le}?_(?+c(eV$+Liha21z7%>Qot*ti zMup*{hI-i-bBR8w8MWn1D>OgftwP)bZv_<>dQ3elc;%q&f^?W_Kd21B>733N6(x@f z5rMMhcfsRP@QVHW_b=4?eP3RzLFbuu2NH^)!Z?L|7*rQE_v%hFeeH7gHlF@P4b;GV zh|R1Ns7q>6VF9&mDVUhnhqaubed9jgP9r31-y`Fpd0CS(Vg{(XrUNRR1$sRCL}7GxWSwN!Sc31I!486@~Vqo^@n#VCC~+WCMdo zvhfSasaK*$k8Gd4Qp+iHB*47?;{C&r)@54u4SvsW)f-P|@fHVmXu{80NCnkLdJYi5 z4rt5w`260Gv0D^>Zo_kvud-E|#S{pa(mAY!_(S=o)=R&>xzIzz4-|wok9hiZf!p2Jm&$h-61fF zw>LL8Gb03)WWo8DuDA1XQrH#eSDAN8`B%{KJ> z=ru0FSF?vTNQi3_UI?2}Mv`E19tY7RyiF9t6YOKw*C3QW#Zu_3vJIgC>D2G}JE390 zqhLH%eb6)VF5tkF^xuu`fi$Hvbcm=j`t)iO0#G5pGf1aJheJa(((P{1P<`PQRGXeF|@?P+6SH_O^N6${=8? z?)1g=#rf(fTiqAK<-9Fjb<o zI{6IQYZDf8ezJIGmo=_3Riu$%5#KJOxC*#dU9wFIlQaGf?hl)q>jJvGby>G?EAPie zJ_)}6r`fLon)_gU6MpEm9C(nBmkcr65Yr+8C>2D=9z$WuWj*^7W-KUTa1kIC(0Ee- zNt?-j9IA~?CpYl45fclvsU|mBdx7v)-i~-j9`Q)IAl&;5z6RrBo_*+IAU9dK%C{7H zQ=pOuDAdBJq8MHnGJQ^Iux-|Ar}Hywda`+{He&_!{{Y9}l0T zGB9YcYG$Kttf5Glq&ruHNL%L!y<)jynb)y1J3B>xRdV-6uI8i1P5jms+$p=_o;KCy zIofX9=ea+J&yYwa=gagt{|l9JpVk}oZUXOdj{?PqbMrhh7q4#%ieP}X^T8u!CP#F; z0tPBldx^KxU_F9MfxM|BmcmbDD^WYc}!6}SwZD% zp~`kbN;k)cJltLRg)UP#$C6hI=*}~>lDAcvu&_WIMh#hw)Kqre3JOjtlnsnKtXbFSVd- z*R%nh_;S#=^s*;z__HitgF9^_;WSoeyPxc0ZlZll5h7{J%{GUYl(nrrQE%xai|5;8 z0&v8_prq#In}BWeSq_QTc!iZ)g@NiBE02M~9jc>#nK|+^t!4DM+9hlbpDqvDi)ivc z_}mDCs9?mjJ&W588_Rfk$lF(RmBJl2NAu*b87fKA|GZyj$?7~;+#0^|*lv!*yL64( zDmUf*6_wS23d0W#btlHo{H=Pc=J>>vIiNggBJNnGhevu-uKK+{pm>S`b3oF*--*5UBB8t zS?F>39pSWUnAv$>y?czLC)TSZ%w;ra+`b$7&b7SjBR!b)|HCL$DbGcP*VENbbP1# zg6Opph9tF>@w!z-{rnjEnD2@=Z%cy&rf>h>r5osXp<^9L;V-<>g;8CQrz*@&V9`u< z-N=3IgN|b2AKGW<Zwu`4Sn>2eDC!nr$q%*o`ITaK-mcuI3lmdlTT=O&}cbr&lvxZ`OT?-M(jTd_~tSQ>l_?uY`g3~)=a|E_Sr5S#kW9UbJZujxN zImo(+2~B?|Y_DBirvPgTz<3$50{6_}%svLBzd>RISH9`%=99o;BfP`2;VTws7)5Ow zLZOLlNwceCEIPV;$n>iupwGI~emK)unMrBF;~|E?s@+O&Bsn6@G#JpB_5RoKQ|jyo zaY$$HcfX&L+1m3rExs&i4*ONN>~g_RWyQ1_8(M`a=Sbfa3@Pu?(b1c8)}M72;S4_a zR8cy^_#CFlraz(C&N2U~r3Q-LNhMFyn|iF3iiJilNSdj_$IUt1ev!mf8!vQw87a_X zZiB&_z?P0MZ&mxXJGtZHUM2W%-1e-AOPTrfnN(VPgrjRJRGUm*m(hNpAJ5@!l4<_D zOg`j;iK#Bi^lU6NDEsgz*6GT9sngM^V6sGq?56QrP_@Ejaf`U{^ylfU?|8n^-f((2 z>;D%(sj6U@6BeEPviU#x?@DV^m-zZK6ZKr0m~*O-sx{8o*A z>)d-}f+PN~gnYUf_bjipr<#(Ddws?V%F^Q*f(&PrzrSVq#Ck{HYCV9L__;ENVQg)k zdoBJswJ3cyOWLgC;f$Mc$ETIa-O1s|%CcHUZ9eR4)Nw}zd5jtlY-`Pj>YP8FjmqLa z3uZQ?0kO_w-+0OP3om{ceYU)G4yo>Z;sKK}Ws58I;ni9BBGVYOvxIpGDq8H3ezV!D zDW<0M?yXyeQb)52rblJ1+Z6RSeiyEn2I-aJ$ye4WtV;VK*D?^u4lFBYI3dZt{?+{$ zf}G02*@MX&Q?xTxmU_3Vy&m<=x$Nc0Fm}g$N{fq$8TfB1V|MFIV30;9fd(cFNG^%m zwGP^QP(eS{#YcSb?S2^ST=+;l$w6fns)mrc%@pb`{G{S|9jcZY3FeEZOkz=8j61eh z7H0ae3Z>8`7k^mmO+xl!leUt&+?AOxig(dh~;?}3UtgW0ld zq&^zTTS&r@7h~}%S2q}Hz7=OV0z751*AAB}i5Ar=*2+M}h zR$9;a*bKQ9!;_z0)kYob(jA{nJyvV29*54y;UR-eUtA*)t|d1dLSQm9=?FPL=afXG zIXCwBMceI$S3IXZO{jX)d~MUgqaGgO-(<{Z&v#VCc%F@gdsVX26Zc$_?EOsCBD`H&g#2XTTR{SAqlOLdUFApQM8o@ffBtNk}Yych^#Bty;Tp zFAe-}vtXSn{arYEwH2V#2vlp~zx&WIVN!zrQOVp5I3p6GqAXt|!Sa?pkp#Z>oA{oG zqqA{3o-bYYmceGM? z<~5Xma2Jo`R#*C&aPoMWN(fHY+n(3LXHy|^L?7pEJqX^oB7)u0Z)~m@E&h9a&B!=G zJ=^`*5WSX$*E%XMbeeV_O(adHL+bVyltFBJdx9kGPn1p-=O)0x-n|#?6*=LMKa2J$ z-TYs7*Vms=xLf0^e-ZV!cy}4#R8YtNSLs&&efs~qiCO>WXZC~Zwf%pI?yptVAk3P= z7-F0LrwkL6&6fY6lOGw_YqYCuC{e&p{hNR9g)Yiyo03|-R>{Y{3ltxl4RGHc|BKGy zm;zDf(LMh*y#;V~`;-HSJ}P?~?b^SfFWSQM7cYhw!co4jsCc6M(+<62lc|5c6I@7t z!9m%w=Z^qls)`cVy8HhNbW(|fnd_a`D4SY69pL;1>llcVq_Ba1^PPWj+qVgjj_U1c zGL((2LzteoKz{?x_m=OpI>7rufq`P8q9CbN1{@Ayo(G^iaHax)YX~08_kl=(I@*20 zH6#WG2A~WxANcCmrne3xR7lE&;do-U-)x;5iv5Gia|1;PRBy*OP&BAl044vqJ$l4Q z(|guaS0H6P2*gBC^cm7-(D+*pP2~7J7>pmFuOjXwJAI9ejxlb}&YE_A?(TG=+R1nmJe)dae)R04ahS}Cp9dpJ)Vpkdvl zY+ZMVjgH2M8*(s#1m3D}^brB!_`4y}rUpzjac*FUZWCnbOk$=Rpk!L%rz+uPeC3qnqym$Aifwx9eXM$hn)au!31WFv|YB zTGHTuh6V?Z*|>CTta(Vm&dx}y33!NQ9qSHwLLhhX?@E42)Rg;^R9g#%*9&f&589r$>2`c4L2vF8;70>#Xz1{VR@XXp9?uc=lvrw;pA}2T21jgo`(QE z6Vs}Y)Gg?(SKuj#?iV=xHww2tlGjkHSR~wH1X9Ce!E9Off|zR=SarOf=iHRbDDjUS z%*ca6t^2MrB0 z=8Oz+j6Q_!tMOkONW;II&M|eNDMSK0OycHK%H&>FBb@#GB9DDbiq@3aqgulI zM*9;-e(TNx-HR6r+?ih-$>4>*&HY~E-qaSnjmK;*k+xunMc*LmH=kNU%o{#k`=`k( z{}Ec_M<|jnWTiDP zR$JpK6Gw^S`>6>1ctPwf2P0jmfT+@8Z9+#ptHiX-*)V$Z1>ymJSDCD+3ev4RmM;i_I} zaxs|xVa5`1j$f^Ru$o?qeb|PM4d2HPxt_%`?awTo6-9!`((0lo875*ip(V;LU6Xnt zX*lW#*HJVy-KHv3E-ySDz+p&}I|9hv8^;lh%{iqK!`;Wi|0FoBM?O_>xR^SvBtEvY zNESJt+yggxMpR+IpckoURu)h+N14036_Vg+8SAdl(pnL?E47$muGmvRro$zWYbn3i zgKe%8M@&Z4b1_h!9~6Y<*3A#ITBU&Uba5r)ue%8n#5TNfJIX^9bIBS6 zv9@spNo>m2UM6E}%o%)@sgA4Go}y7m3OvjB zMb4p{TvM^(CxfB!aOu{yqvifXn_6yYA7A-Z{hFx)DDXq;^rFdR=~V)bP(ZaYNoDLW z@!r9i%@<7nxQ2d-!gYAZGkVa)qwn{nuKMm2JoXmJJ5OA?U}06~dF!BlNB#dHinRaS z`U^c%p2(7K>tP_a)%UUa_EYTV*dz|$baM2QeF-_f;%8(?$_-!+>^d$X%0wkA*e%@M zGHNWN%s6w^Dh;d3a4~ZijH=d4e zAs493}4P#rua6g>ZkwXkA6iU>3@kaic|Llbup_ ztasfNmZCn6j<|>Rn97v6d;KZ5oU`QC@^~w{T=pLcf3F6oOKvSy&y~fM264th?ZEso zb_SkLb0QI)540+!XArQ%1_z$)&!;w6PuTCB=em|7I7G#R!h*TlzHDfv8XzZrimlNG z_TZZj2g_7&nhY_o)L4y;SbZT*eV|k1Q5VbKBV}c-m@g;gId<8l`a3LamZbp3V|X`Y zfn=YS`n&3;*0ezjo@Ne9bDd3(qy7HFeoemHX>NtSToo5<@zt3dE3ScZmpI7rc{9R? z*_oOBmBDS>>kPTL?|tOkDbNl8C$DjW67t1oSOm^3tplNiLn5yj!8bhi15{1$)w z?GLw*sLMoF*Pc1}9(~o9qlqOxFm8Q?VgT$kn!hwPibN0OgXRX*D#?d$= z))H^0_Kp?1cnR?I@*kJi<~=Y>=}fL}xyeRaGOR0XyrAA`FZvPi=dn}ychQqY!>;Gm z)uX!I1{Jt?hjt}IE*#VoRnrq{JB+Ro#d{Z{DYMbxxg(jr z`qD)6nCj>gw)X)am3^4*N;87l1#?;Ar}m?3mpo4kH(%$`w`nlW-i|DH-W~5>!V@El zpDX<}^6EF43o1uV@I#M{QL!qRO4mtkgUb?YlpUNvU?n^d{2J0{q4Q9&YRy-- zNSjNHpzncMGcB&CaB`Lo)+oO6Kt_)*v)x%^oOwdA>LL#i)~BnTq7CBsmb#C;&nTOh z1Qsq=_n!VWxqE0R>r#NJhYV<+o#^fDHM+Czpb7Tz+__3XBJuRB*VNnkPm!viU@B?~ zRu&)mp?p1U0v%GR0VHvE_atUfbSlvLx&ssb?;H3ZEG&?Z&6e0>M^}iKXquFm^x4SA z`SR)z$wV8v^zp{AP2)>v&U=^FpRrVk1uhZhU ziWO5MgvAhawun>hd0kkj{AP@1o6@85(6n{`$YIlaW2WcV1R6Oh(2>El{79>_AHR^l zH^IZyP6D}eMaRhI){X4l{BD2sWk#(*r|RPJ(lfR1mr}%m9~zopRyY-CqKWUK`@CM+ zhFWY*P}{%c%{w#CzxgF^=BRxY$-D{{xF|dji)1T(NNQtEtD>CKteQ|pL*|Q*Rb`#+ z&&8i8w52b$3Q^79Il1EDKU#M;aC$=jByRgwwm?$C*^#CJXJimvT)k?-@qX))7hfP> zX!wZYyr<2Ek*lF+aD~l2+X`F0;eimVE_v5&wHTohPqp)zl)*v$gyDOaiixh%SUiT~ zlA3DY_^0%397eN~^hzHPnT@ju&rqf6MhXs*5R4cvk#4VL_e_}6+(p`2nV}`tyuIL> zBh4NgvZGZnJ|ti6T}(<)N?PCgHla;q!JGc>;G|w?_06eH`Cma(BmZZwjy^uNC;E|| zPI=&{gJpO!KmVA2c4}-aho%uaVl}OO5c25j>vzfiNFh0l*1C(0J&?-DnVm>o*A(*Q z&Wv6}OtFch9rtOanYsB$rOOm28{1dfbC^ebBULd=D<}xLy0wvVy_}jlAMW|BoNy{< zd;5J*w&QDsTUx z^?eXQg~u3~QNqr6i`F~+-NHzW(o6axz7TZsn?5fVmc`i~$_TH4ML5%~^Ypg{9MuUy z0wGNN7*84ZHOhS4#D|rY_wOfh#_RU%Ex)NbnToHT;xriLWXuxnJO51{b{M>&kDMOb z{hK{1;W5W(Q=R!-tQN<)e8l2f1;5IPkepoX!Kz(W z7d~?4NuQU!+g34&p$NOn=%0jMf(M-ZCqbgwcIO{mwph9{5NaBT(8HtA!B5EsV=b)k_f4M3GBfyRF&)Ti% zHwL2;+cE1rr87%eXcs_Ga?iSC^kokwTP#dT$NoXUTz zH8(dOxzoi=ef%F|mg;mAxT~#L;m-W2uCQ0cBG7nr)%e5;VG+R6JMED7`*Uw@1+@y{I2}$E zX619;NNOeQ-?fEhGe2G@SyKN-hJ3ZoKDAiK6)64Q;Yf{(cOcZS=32n^Ct}W_4HKE! zn^JDyRsTcMxqNS%SY_fT(|DUXok{`WRi;z4`9Dc@_&N^H<5SH2?a4QCJIu~8E1h~RJoacNw5F8Uor)kEnrI{!qO%xgd1VR>+0 zv{RLejRITprX9Bj3FFy#W1pJE(mxi5gmP2==)aS*}zeCkv4zmR^2a$AB?J zkRx`t;i*8*^sv)u^22iW+A+WSGKX@>*{bx5*upp=-gUJU^H4didvG-$wNA*Z?{HZ& zmSzhRQrq7r%6$8?rslN26470`rHaM;{8sFetyrSKR#f#4Tu>~by9~uouH8S@Vcz(! zO<&gkZHv5GRYYdXEHzLVzfcIb>0R`WD$2q!hqBd=xlaeMz)Q_-5hAy@6Sy8mrOi8(`hFBgAJ84j_unKj4?ueoZEuXWwCsJ^~ z`@YaZZh!L@(34!xm!l?D&YC(LOm@8_WCT()&h5moM9;G=7v6c@T}xfGRiG@`y`N-c zB-CZ^qJh=4vv5k>;2YFD%bv8aKhGLcwDPt#=9i5n+tc8pN+muILdtUEqU_tRxC$d! z)=LgYDmZ;KGS`D%s98qMi%)&?+ZZ5ik?gj5IUwykY2)0b@p4S>>m_Qw`thJ+t^>su zMQk0+sWWjQaYqx1Xx-ItUS_Pg_5K6kFvcf59XF3WEZWxS9`MQ@H;FyPKD zB-9A#nM>IB;x2W!e)&+wPLNGQlTN^XETzs&_qTsCR;Pn{-sf=^6U%cBE;}_WrS?UG zpB&D0H_wJ=`W|nnFRWHheoSlXyJ?hEHKA@uTegOoQo|XS5}=*>D_R?kjwBHG(2Vbc ztU3K==X;7Z&k+-j+r-nC1q<5VY3jcmn+%XX%w`HXQtq8Iq&8{wTINDujTL|QallnI zigeC(cz})EipP5&A0O-b6WS|V>9)Ak)*CX%SyZ_Onyx%gy6G=(;J&2%Wt=si+`lQf zMklxoJ z{+ZzdfBdG3hEwM7b)*E})xG!VXLZRJ3E$lmterMvy=BPIhhF7YnP%FtGjtlTc-$Mz zdZ{%QbeTN%wKdW_*5ADPOa3h~^q2DpOT#(kEd9y|)%K)!8*N6@aLG2Kv%YoL)_!l| z(VQpQMIUGq{S~;M#9hqksP0O(K@mRbLpMxopiT6pw|rh$A1)iMI;tT8gez0fmIFR& z%LD5j6@De*<)#04lv^vi1f71|DvO#VHKAO zcK076QpXl?m;b1cY0U-k_zc5%AGuSWlPW)nYq2`|$=p#3S5t3kDnP!nIh5+nR-7Zh z#B_d#gIu>Ob#dqWX6u=VohX*44*4%X@;1kk=iQrPCcPjnu19#!=8WQ|hyGCr`Icp9 zd1awx;8DnR`fqCA&S%tvadCP8ig5rC_b9kuOFy5hxoorcI-clj*q!LRM|!b)u~!>R zaV006FyqbCU4mB)wrqUlVN+Y$#?p`{N&o!$fomOH|GBYKe7&@aDAC8e-iaKrvpF>e zV*329{BSAoq1?FfIKQ5?Hf#Q#-WKsN2J3Xw1AhkW+LeLA@7CU&tuyZ3?yQ|(N1P;PG@A@imwPw^?51z43$?7%Ci0DPJ*durzJ6ML}?3&$spYcM${~?pm z*_huq%AA)4+I8ZpS5j1fm+Ac~4Glr&ze0WbuJ z3`1K^5|K1w@(hNY53K)zwd3eR#>1H-Bu9ppQKdNv36iC*N1?^Ta_snaO$oQB-;6vl zd27P&Hdu^$FLU)@IBd?}o*gr&NmOQ?jG3Z-5l1N{SF-(3{q|MkxV!?s)!BbD zbWDF8NqRq8b8+K_2!-LXlwXr$dJ#cQ$e$@3igYQ{HCODYs?v!EaMB++0;a2@MQOm$ z2~1KVWGN;(2rCPTWl*c%3y6(%4N zjCjLU#;D!%u!YRqT&eo*cF7%=Pg{NGHS^|vWUi}I;Y_p|0%N|9ZDADOi2gJ$H#gl2 z>Aqzz)WN$=o=)T~Odgg~k2)?vX#-NXqP#rt@qT!*s!}c)yD~B|qWX*ztgc?Xu)n&z z0G5fgjLbfwsnpLi+DYF(?;2+qUtQ?mt8Ur2ehPZ8ur@v4@Vz}dOOQUIbM4FxJp*iV7^4s>gnEyK~)ChW=op}oIUc6~ec*2m9#hg3q# zprjp_#HqH=t*RPd+Wk;B3vdaD8(jFvJwrA-OTJ5X5(d6)Uf2QUC=Ff&O`y*Gl$U?e zw6s@lee`~%_1eYh8l@dvwgqj#G}QYdL%}pwleh!Y0)HwgYe`KQ?Ha2!W$Hm3P`7boIA1?pi zEi~?LrKR>JCIK4bb8}bETDOfejfC@R_GJ`NWSNZ6Xj$aXd2oG)Odefz-XY_I44=Eh##|V6n<5&~rlh zyl+k{8$2{K!_UUn3_*O4z2#7M^yvqH2Lw|4o?3hPNvH6MVeFn=XwIX0k*nIk6))Dl nRKY%Gw*HBUPSC9Wn7`s*l6_ilRs(uJG&C_`>9>VK@4f#A^DzD^ literal 0 HcmV?d00001 diff --git a/docs/porting/media/enable-copilot-app-modernization-cpp.png b/docs/porting/media/enable-copilot-app-modernization-cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..3e0047e42ccd7aa583274f07eae9a1ae0534886b GIT binary patch literal 59288 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 Date: Wed, 28 Jan 2026 03:26:55 +0900 Subject: [PATCH 1586/1799] Fix typo: specifed -> specified (#5873) --- .../CPP/how-to-create-a-task-that-completes-after-a-delay_1.cpp | 2 +- .../CPP/how-to-create-a-task-that-completes-after-a-delay_3.cpp | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_1.cpp b/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_1.cpp index 19ec97fbf8d..07d9a402d18 100644 --- a/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_1.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_1.cpp @@ -28,7 +28,7 @@ task complete_after(unsigned int timeout) }); } -// Cancels the provided task after the specifed delay, if the task +// Cancels the provided task after the specified delay, if the task // did not complete. template task cancel_after_timeout(task t, cancellation_token_source cts, unsigned int timeout) diff --git a/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_3.cpp b/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_3.cpp index 05fa30ae3d4..efdf43e9507 100644 --- a/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_3.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_3.cpp @@ -38,7 +38,7 @@ task complete_after(unsigned int timeout) }); } -// Cancels the provided task after the specifed delay, if the task +// Cancels the provided task after the specified delay, if the task // did not complete. template task cancel_after_timeout(task t, cancellation_token_source cts, unsigned int timeout) From 1944953b7f81ce6eaa981c9200ab167530ae0914 Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Wed, 28 Jan 2026 02:57:32 +0800 Subject: [PATCH 1587/1799] Delete extra slash for link in "Microsoft Visual C++ Redistributable latest supported downloads" (#5818) Co-authored-by: Tyler Whitney --- docs/windows/latest-supported-vc-redist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 33c92e2fa76..55adb454dd4 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -145,8 +145,8 @@ Download Redistributable files for other languages and architectures from: **Release notes** +- [What's new for C++ in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md) - [Visual Studio 2026 release notes](/visualstudio/releases/2026/release-notes) -- [What's new for C++ in Visual Studio](../overview//what-s-new-for-visual-cpp-in-visual-studio.md) - [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md) - [Standard Template Library (STL) changelog](https://github.com/microsoft/STL/wiki/Changelog) - [A year of C++ improvements](https://devblogs.microsoft.com/cppblog/a-year-of-cpp-improvements-in-visual-studio-vs-code-and-vcpkg) From dfa4b622512074ce616434e38c36aa5aa60d4d2b Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 27 Jan 2026 13:31:21 -0800 Subject: [PATCH 1588/1799] Fix example code for C2277 error message The pointer-to-member syntax creates the error but the simpler example may convey the point faster. --- .../compiler-errors-1/compiler-error-c2277.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index c5e73e52a40..20429c174ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -18,15 +18,12 @@ You cannot take the address of a [constructor](../../cpp/constructors-cpp.md) or The following example generates C2277: ```cpp -// C2277.cpp // compile with: /c -struct S +class A { - S() {} - ~S() {} +public: + A(); }; - -void (S::* pointer_to_constructor)() = &S::S; // C2277 -void (S::* pointer_to_destructor)() = &S::~S; // C2277 +(*pctor)() = &A::A; // C2277 ``` From a1cd597bf43d457258d1d858f678cdfd367629a5 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 27 Jan 2026 13:54:17 -0800 Subject: [PATCH 1589/1799] Fix type references in array get function signatures --- docs/standard-library/array-functions.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index 709189a51eb..8ba4d4fcbca 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -15,16 +15,16 @@ Returns a reference to the specified element of the array. ```cpp template -constexpr T& get(std::array& arr) noexcept; +constexpr Type& get(std::array& arr) noexcept; template -constexpr const T& get(const std::array& arr) noexcept; +constexpr const Type& get(const std::array& arr) noexcept; template -constexpr T&& get(std::array&& arr) noexcept; +constexpr Type&& get(std::array&& arr) noexcept; template -constexpr const T&& get(const std::array&& arr) noexcept; +constexpr const Type&& get(const std::array&& arr) noexcept; ``` ### Template parameters From 8d8092dbb42b0c6490364f45ce939b79cff09d43 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 27 Jan 2026 15:02:00 -0800 Subject: [PATCH 1590/1799] Update compiler-errors-c2500-through-c2599.md --- .../compiler-errors-2/compiler-errors-c2500-through-c2599.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md index 5340336b562..d018f827b7c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md @@ -1,6 +1,6 @@ --- title: "Compiler errors C2500 Through C2599" -description: "Learn more about: Compiler errors C2500 Through C2599" +description: "Learn more about: Compiler errors C2500 through C2599" ms.date: 04/21/2019 f1_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2554", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] helpviewer_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2554", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] From 14c3fb4a2d899cd98a4b35328bee9bf1935dd2d5 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 28 Jan 2026 10:52:23 -0800 Subject: [PATCH 1591/1799] Update compiler-error-c3187.md --- .../compiler-errors-2/compiler-error-c3187.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md index 3710ca2abe3..1bb673cd78a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C3187" description: "Learn more about: Compiler Error C3187" -ms.date: 08/15/2025 +ms.date: 01/28/2026 f1_keywords: ["C3187"] helpviewer_keywords: ["C3187"] --- @@ -20,12 +20,18 @@ To correct this error, move the identifier inside the body of a function. The following example generates C3187: ```cpp -// C3187.cpp // compile with: /c -auto global = __func__; // C3187, usage in global scope +#include +auto global = __func__; // C3187, usage in global scope void func(const char* f = __func__); // C3187, usage in parameter list + +// correct usage inside a function +void test() +{ + std::cout << __func__; // outputs: test +} ``` ## See also From 7d27af0e765f62ccf8678926d10d967c989df3cc Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 28 Jan 2026 14:18:20 -0800 Subject: [PATCH 1592/1799] Update explanation for MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION Clarified the explanation of the warning related to missing integer arguments in sprintf_s. --- docs/code-quality/c6064.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/code-quality/c6064.md b/docs/code-quality/c6064.md index c17eeaf1c7a..2a64589d1ec 100644 --- a/docs/code-quality/c6064.md +++ b/docs/code-quality/c6064.md @@ -19,7 +19,7 @@ Code analysis name: `MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION` ## Example -The following code generates this warning because it uses an incorrect number of arguments in the call to `sprintf_s` and the missing argument is an integer. If the unsafe function `sprintf` was used instead of the safer variant `sprintf_s`, this code would likely cause a stack overflow instead of just an unexpected output: +The following code generates this warning when code analysis is enabled (Project properties > **Configuration Properties** > **Code Analysis ** > **General** > **Enable Code Analysis**) because it uses an incorrect number of arguments in the call to `sprintf_s` and the missing argument is an integer. If the unsafe function `sprintf` was used instead of the safer variant `sprintf_s`, this code would likely cause a stack overflow instead of just an unexpected output: ```cpp void f() From 9e1eb4e8e6440e96369d65371c670397cb406c6e Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 28 Jan 2026 14:18:52 -0800 Subject: [PATCH 1593/1799] Update c6064.md --- docs/code-quality/c6064.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/code-quality/c6064.md b/docs/code-quality/c6064.md index 2a64589d1ec..9d3c40d20a9 100644 --- a/docs/code-quality/c6064.md +++ b/docs/code-quality/c6064.md @@ -19,7 +19,7 @@ Code analysis name: `MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION` ## Example -The following code generates this warning when code analysis is enabled (Project properties > **Configuration Properties** > **Code Analysis ** > **General** > **Enable Code Analysis**) because it uses an incorrect number of arguments in the call to `sprintf_s` and the missing argument is an integer. If the unsafe function `sprintf` was used instead of the safer variant `sprintf_s`, this code would likely cause a stack overflow instead of just an unexpected output: +The following code generates this warning when code analysis is enabled (Project properties > **Configuration Properties** > **Code Analysis ** > **General** > **Enable Code Analysis on Build**) because it uses an incorrect number of arguments in the call to `sprintf_s` and the missing argument is an integer. If the unsafe function `sprintf` was used instead of the safer variant `sprintf_s`, this code would likely cause a stack overflow instead of just an unexpected output: ```cpp void f() From a640d6b12866052e8dba48e8e4d528dc6230fa05 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 28 Jan 2026 14:59:49 -0800 Subject: [PATCH 1594/1799] Update thread-functions.md Let's go the other way. For declaration, let's make them simple. --- docs/standard-library/thread-functions.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/thread-functions.md b/docs/standard-library/thread-functions.md index 2cba283ccc7..ed86df6516b 100644 --- a/docs/standard-library/thread-functions.md +++ b/docs/standard-library/thread-functions.md @@ -14,7 +14,7 @@ The `` header provides the following functions: Uniquely identifies the current thread of execution. ```cpp -thread::id this_thread::get_id() noexcept; +thread::id get_id() noexcept; ``` ### Return Value @@ -44,7 +44,7 @@ Blocks the calling thread. ```cpp template -void this_thread::sleep_for(const chrono::duration& Rel_time); +void sleep_for(const chrono::duration& Rel_time); ``` ### Parameters @@ -62,7 +62,7 @@ Blocks the calling thread at least until the specified time. ```cpp template -void this_thread::sleep_until(const chrono::time_point& Abs_time); +void sleep_until(const chrono::time_point& Abs_time); ``` ### Parameters @@ -99,7 +99,7 @@ The function calls `Left.swap(Right)`. Signals the operating system to run other threads, even if the current thread would ordinarily continue to run. ```cpp -inline void this_thread::yield() noexcept; +inline void yield() noexcept; ``` ## See also From 33583fbbef80c0a2ed0d4550272b6e3b7a70a3ab Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 29 Jan 2026 14:32:46 -0800 Subject: [PATCH 1595/1799] branding updates --- ...handling-events-from-an-activex-control.md | 2 +- ...sing-controls-in-a-non-dialog-container.md | 2 +- ...iewing-and-modifying-control-properties.md | 2 +- docs/mfc/activex-control-containers.md | 4 +- docs/mfc/activex-controls.md | 2 +- ...tives-to-the-document-view-architecture.md | 2 +- ...automation-clients-using-type-libraries.md | 4 +- docs/mfc/automation-servers.md | 2 +- docs/mfc/automation.md | 2 +- ...g-the-styles-of-a-window-created-by-mfc.md | 2 +- .../clipboard-using-the-windows-clipboard.md | 2 +- docs/mfc/command-ids.md | 2 +- docs/mfc/containers-for-activex-controls.md | 4 +- docs/mfc/controls-mfc.md | 2 +- ...n-active-document-container-application.md | 2 +- docs/mfc/crebar-vs-crebarctrl.md | 2 +- docs/mfc/cwinapp-the-application-class.md | 2 +- docs/mfc/dao-classes.md | 2 +- .../derived-view-classes-available-in-mfc.md | 2 +- docs/mfc/dialog-bars.md | 2 +- docs/mfc/dialog-boxes.md | 2 +- docs/mfc/docking-and-floating-toolbars.md | 2 +- ...s-created-by-the-mfc-application-wizard.md | 2 +- docs/mfc/form-views-mfc.md | 8 +- docs/mfc/framework-mfc.md | 2 +- ...-to-create-internet-client-applications.md | 2 +- docs/mfc/idle-loop-processing.md | 2 +- docs/mfc/inserting-a-form-into-a-project.md | 2 +- docs/mfc/making-and-using-controls.md | 2 +- docs/mfc/mapi-support-in-mfc.md | 2 +- docs/mfc/menus-mfc.md | 2 +- docs/mfc/message-handlers.md | 2 +- docs/mfc/methods-of-creating-a-status-bar.md | 2 +- docs/mfc/methods-of-creating-a-toolbar.md | 2 +- .../mfc-activex-controls-advanced-topics.md | 2 +- ...vex-controls-using-stock-property-pages.md | 2 +- docs/mfc/mfc-activex-controls.md | 2 +- docs/mfc/mfc-and-atl.md | 2 +- docs/mfc/mfc-desktop-applications.md | 4 +- docs/mfc/mfc-internet-programming-tasks.md | 2 +- docs/mfc/mfc-library-versions.md | 4 +- docs/mfc/mfc-mbcs-dll-add-on.md | 2 +- docs/mfc/mfc-toolbar-implementation.md | 2 +- ...-document-types-views-and-frame-windows.md | 2 +- ...controls-in-a-activex-control-container.md | 4 +- .../property-sheets-and-property-pages-mfc.md | 2 +- ...adding-an-mfc-class-from-a-type-library.md | 2 +- .../reference/adding-an-mfc-odbc-consumer.md | 2 +- .../application-information-and-management.md | 2 +- docs/mfc/reference/cdc-class.md | 4 +- docs/mfc/reference/cdialogbar-class.md | 2 +- docs/mfc/reference/cformview-class.md | 2 +- .../creating-a-forms-based-mfc-application.md | 2 +- ...ing-a-web-browser-style-mfc-application.md | 2 +- .../reference/creating-an-mfc-application.md | 8 +- docs/mfc/reference/crecordset-class.md | 2 +- docs/mfc/reference/ctoolbar-class.md | 2 +- docs/mfc/reference/diagnostic-services.md | 2 +- docs/mfc/reference/mfc-application-wizard.md | 2 +- docs/mfc/reference/mfc-dll-wizard.md | 2 +- .../mfc/relationship-to-the-c-language-api.md | 2 +- ...perations-for-building-mfc-applications.md | 6 +- ...perations-for-creating-activex-controls.md | 2 +- ...ions-for-creating-database-applications.md | 4 +- ...ers-implementing-in-place-frame-windows.md | 2 +- docs/mfc/technical-notes-by-category.md | 2 +- docs/mfc/technical-notes-by-number.md | 2 +- ...operties-and-events-with-test-container.md | 2 +- docs/mfc/tn006-message-maps.md | 4 +- docs/mfc/tn011-using-mfc-as-part-of-a-dll.md | 4 +- ...020-id-naming-and-numbering-conventions.md | 4 +- docs/mfc/tn021-command-and-message-routing.md | 6 +- .../tn022-standard-commands-implementation.md | 2 +- docs/mfc/tn023-standard-mfc-resources.md | 6 +- ...n024-mfc-defined-messages-and-resources.md | 6 +- .../tn028-context-sensitive-help-support.md | 2 +- docs/mfc/tn029-splitter-windows.md | 2 +- docs/mfc/tn033-dll-version-of-mfc.md | 6 +- ...-files-and-header-files-with-visual-cpp.md | 106 +++++++++--------- ...tn039-mfc-ole-automation-implementation.md | 2 +- .../tn041-mfc-ole1-migration-to-mfc-ole-2.md | 12 +- ...m-dfx-routines-for-dao-database-classes.md | 2 +- ...ao-directly-while-using-mfc-dao-classes.md | 2 +- ...e-class-applications-to-mfc-dao-classes.md | 2 +- .../tn057-localization-of-mfc-components.md | 4 +- ...message-reflection-for-windows-controls.md | 2 +- ...face-support-for-ole-automation-servers.md | 4 +- docs/mfc/toc.yml | 2 +- docs/mfc/toolbar-fundamentals.md | 2 +- .../upgrading-an-existing-activex-control.md | 4 +- ...asses-to-write-applications-for-windows.md | 2 +- docs/mfc/using-your-old-toolbars.md | 2 +- ...h-adding-a-d2d-object-to-an-mfc-project.md | 4 +- ...ough-adding-animation-to-an-mfc-project.md | 2 +- ...ing-the-mfc-scribble-application-part-2.md | 2 +- ...hrough-using-the-new-mfc-shell-controls.md | 4 +- docs/mfc/windows-sockets-in-mfc.md | 2 +- ...indows-sockets-using-class-casyncsocket.md | 2 +- docs/mfc/wizards-and-the-resource-editors.md | 8 +- 99 files changed, 191 insertions(+), 191 deletions(-) diff --git a/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md b/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md index 5052a8c4c3d..90af06c7fc7 100644 --- a/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md +++ b/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md @@ -15,7 +15,7 @@ This article discusses using the **Properties** window (in **Class View**) to in > [!NOTE] > This article uses a dialog-based ActiveX control container project named Container and an embedded control named Circ as examples in the procedures and code. -Using the Events button in the **Properties** window (in **Class View**), you can create a map of events that can occur in your ActiveX control container application. This map, called an "event sink map,'' is created and maintained by Visual C++ when you add event handlers to the control container class. Each event handler, implemented with an event map entry, maps a specific event to a container event handler member function. This event handler function is called when the specified event is fired by the ActiveX control object. +Using the Events button in the **Properties** window (in **Class View**), you can create a map of events that can occur in your ActiveX control container application. This map, called an "event sink map,'' is created and maintained by Visual Studio when you add event handlers to the control container class. Each event handler, implemented with an event map entry, maps a specific event to a container event handler member function. This event handler function is called when the specified event is fired by the ActiveX control object. For more information on event sink maps, see [Event Sink Maps](reference/event-sink-maps.md) in the *Class Library Reference*. diff --git a/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md b/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md index 9c54a250016..5c203ddbf53 100644 --- a/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md +++ b/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md @@ -7,7 +7,7 @@ ms.assetid: 46f195b0-b8ca-4409-8cca-fbfaf2c9ab9f --- # ActiveX Control Containers: Using Controls in a Non-Dialog Container -In some applications, such as an SDI or MDI application, you will want to embed a control in a window of the application. The **Create** member function of the wrapper class, inserted by Visual C++, can create an instance of the control dynamically, without the need for a dialog box. +In some applications, such as an SDI or MDI application, you will want to embed a control in a window of the application. The **Create** member function of the wrapper class, inserted by Visual Studio, can create an instance of the control dynamically, without the need for a dialog box. The **Create** member function has the following parameters: diff --git a/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md b/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md index a9609867536..2cd819edbd2 100644 --- a/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md +++ b/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md @@ -7,7 +7,7 @@ ms.assetid: 14ce5152-742b-4e0d-a9ab-c7b456e32918 --- # ActiveX Control Containers: Viewing and Modifying Control Properties -When you insert an ActiveX control into a project, it is useful to view and change the properties supported by the ActiveX control. This article discusses how to use the Visual C++ resource editor to do this. +When you insert an ActiveX control into a project, it is useful to view and change the properties supported by the ActiveX control. This article discusses how to use the Visual Studio resource editor to do this. If your ActiveX control container application uses embedded controls, you can view and modify the control's properties while in the resource editor. You can also use the resource editor to set property values during design time. The resource editor then automatically saves these values in the project's resource file. Any instance of the control will then have its properties initialized to these values. diff --git a/docs/mfc/activex-control-containers.md b/docs/mfc/activex-control-containers.md index 0201f13955c..25f68beb623 100644 --- a/docs/mfc/activex-control-containers.md +++ b/docs/mfc/activex-control-containers.md @@ -20,7 +20,7 @@ Control containers typically take two forms in a project: The ActiveX control container interacts with the control via exposed [methods](mfc-activex-controls-methods.md) and [properties](mfc-activex-controls-properties.md). These methods and properties, which can be accessed and modified by the control container, are accessed through a wrapper class in the ActiveX control container project. The embedded ActiveX control can also interact with the container by firing (sending) [events](mfc-activex-controls-events.md) to notify the container that an action has occurred. The control container can choose to act upon these notifications or not. -Additional articles discuss several topics, from creating an ActiveX control container project to basic implementation issues related to ActiveX control containers built with Visual C++: +Additional articles discuss several topics, from creating an ActiveX control container project to basic implementation issues related to ActiveX control containers built with Visual Studio: - [Creating an MFC ActiveX Control Container](reference/creating-an-mfc-activex-control-container.md) @@ -42,7 +42,7 @@ Additional articles discuss several topics, from creating an ActiveX control con For more information about using ActiveX controls in a dialog box, see the [Dialog Editor](../windows/dialog-editor.md) topics. -For a list of articles that explain the details of developing ActiveX controls using Visual C++ and the MFC ActiveX control classes, see [MFC ActiveX controls](mfc-activex-controls.md). The articles are grouped by functional categories. +For a list of articles that explain the details of developing ActiveX controls using Visual Studio and the MFC ActiveX control classes, see [MFC ActiveX controls](mfc-activex-controls.md). The articles are grouped by functional categories. ## See also diff --git a/docs/mfc/activex-controls.md b/docs/mfc/activex-controls.md index af9ca221c6c..a2beb263314 100644 --- a/docs/mfc/activex-controls.md +++ b/docs/mfc/activex-controls.md @@ -7,7 +7,7 @@ ms.assetid: 52aaec4d-3889-402e-b57d-758078f8ac57 --- # ActiveX Controls -In Visual C++ you can create ActiveX controls using MFC or ATL. +In Visual Studio you can create ActiveX controls using MFC or ATL. >[!IMPORTANT] > ActiveX is a legacy technology that should not be used for new development. Many capabilities of ActiveX controls can be performed in a simpler and much more secure way with modern technologies such as HTML5 and JavaScript, modern browser extensions, or WebAssembly modules. For more information, see [A break from the past, part 2: Saying goodbye to ActiveX, VBScript, attachEvent](https://blogs.windows.com/msedgedev/2015/05/06/a-break-from-the-past-part-2-saying-goodbye-to-activex-vbscript-attachevent/) and [Native Messaging](/microsoft-edge/extensions/guides/native-messaging) and [Microsoft Edge extensions](/microsoft-edge/extensions) and [WebAssembly](https://webassembly.org/). diff --git a/docs/mfc/alternatives-to-the-document-view-architecture.md b/docs/mfc/alternatives-to-the-document-view-architecture.md index 5254b76bd37..b89b6dbc905 100644 --- a/docs/mfc/alternatives-to-the-document-view-architecture.md +++ b/docs/mfc/alternatives-to-the-document-view-architecture.md @@ -22,7 +22,7 @@ To create an application that does not use the document/view architecture, clear > [!NOTE] > Dialog-based applications produced by the MFC Application Wizard do not use the document/view architecture, so the **Document/View architecture support** check box is disabled if you select the dialog application type. -The Visual C++ wizards, as well as the source and dialog editors, work with the generated application just as they would with any other Wizard-generated application. The application can support toolbars, scrollbars, and a status bar, and has an **About** box. Your application will not register any document templates, and it will not contain a document class. +The Visual Studio wizards, as well as the source and dialog editors, work with the generated application just as they would with any other Wizard-generated application. The application can support toolbars, scrollbars, and a status bar, and has an **About** box. Your application will not register any document templates, and it will not contain a document class. Note that your generated application has a view class, `CChildView`, derived from `CWnd`. MFC creates and positions one instance of the view class within the frame windows created by your application. MFC still enforces using a view window, because it simplifies positioning and managing the application's content. You can add painting code to the `OnPaint` member of this class. Your code should add scrollbars to the view rather than to the frame. diff --git a/docs/mfc/automation-clients-using-type-libraries.md b/docs/mfc/automation-clients-using-type-libraries.md index d5c6ccb2cc8..4c8eb1cb81e 100644 --- a/docs/mfc/automation-clients-using-type-libraries.md +++ b/docs/mfc/automation-clients-using-type-libraries.md @@ -14,9 +14,9 @@ This type information can be made known in several ways. The recommended way is For information on [MkTypLib](/windows/win32/Midl/differences-between-midl-and-mktyplib), see the Windows SDK. -Visual C++ can read a type-library file and create a dispatch class derived from [COleDispatchDriver](reference/coledispatchdriver-class.md). An object of that class has properties and operations duplicating those of the server object. Your application calls this object's properties and operations, and functionality inherited from `COleDispatchDriver` routes these calls to the OLE system, which in turn routes them to the server object. +Visual Studio can read a type-library file and create a dispatch class derived from [COleDispatchDriver](reference/coledispatchdriver-class.md). An object of that class has properties and operations duplicating those of the server object. Your application calls this object's properties and operations, and functionality inherited from `COleDispatchDriver` routes these calls to the OLE system, which in turn routes them to the server object. -Visual C++ automatically maintains this type-library file for you if you chose to include Automation when the project was created. As part of each build, the .tlb file will be built with MkTypLib. +Visual Studio automatically maintains this type-library file for you if you chose to include Automation when the project was created. As part of each build, the .tlb file will be built with MkTypLib. ### To create a dispatch class from a type-library (.tlb) file diff --git a/docs/mfc/automation-servers.md b/docs/mfc/automation-servers.md index 5a8b3b31a32..848c8d97b37 100644 --- a/docs/mfc/automation-servers.md +++ b/docs/mfc/automation-servers.md @@ -20,7 +20,7 @@ By exposing application functionality through a common, well-defined interface, ## Support for Automation Servers -Visual C++ and the MFC framework provide extensive support for Automation servers. They handle much of the overhead involved in making an Automation server, so you can focus your efforts on the functionality of your application. +Visual Studio and the MFC framework provide extensive support for Automation servers. They handle much of the overhead involved in making an Automation server, so you can focus your efforts on the functionality of your application. The framework's principal mechanism for supporting Automation is the dispatch map, a set of macros that expands into the declarations and calls needed to expose methods and properties for OLE. A typical dispatch map looks like this: diff --git a/docs/mfc/automation.md b/docs/mfc/automation.md index beca853d89d..9951fd3eff3 100644 --- a/docs/mfc/automation.md +++ b/docs/mfc/automation.md @@ -23,7 +23,7 @@ As another example, a word processor might expose its spell-checking functionali More important is the support Automation provides to users and solution providers. By exposing application functionality through a common, well-defined interface, Automation makes it possible to build comprehensive solutions in a single general programming language, such as Microsoft Visual Basic, instead of in diverse application-specific macro languages. -Many commercial applications, such as Microsoft Excel and Microsoft Visual C++, allow you to automate much of their functionality. For example, in Visual C++, you can write VBScript macros to automate builds, aspects of code editing, or debugging tasks. +Many commercial applications, such as Microsoft Excel and Visual Studio, allow you to automate much of their functionality. For example, in Visual Studio, you can write VBScript macros to automate builds, aspects of code editing, or debugging tasks. ## Passing Parameters in Automation diff --git a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md index eb6d87a53c4..fdab577e449 100644 --- a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md +++ b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md @@ -12,7 +12,7 @@ In its version of the `WinMain` function, MFC registers several standard window ## Changing Styles in a New MFC Application -If you're using Visual C++ 2.0 or later, you can change the default window styles in the Application Wizard when you create your application. In the Application Wizard's User Interface Features page, you can change styles for your main frame window and MDI child windows. For either window type, you can specify its frame thickness (thick or thin) and any of the following: +If you're using Microsoft C++ 2.0 or later, you can change the default window styles in the Application Wizard when you create your application. In the Application Wizard's User Interface Features page, you can change styles for your main frame window and MDI child windows. For either window type, you can specify its frame thickness (thick or thin) and any of the following: - Whether the window has Minimize or Maximize controls. diff --git a/docs/mfc/clipboard-using-the-windows-clipboard.md b/docs/mfc/clipboard-using-the-windows-clipboard.md index 64d3123609b..e07d461aecc 100644 --- a/docs/mfc/clipboard-using-the-windows-clipboard.md +++ b/docs/mfc/clipboard-using-the-windows-clipboard.md @@ -19,7 +19,7 @@ The Cut, Copy, and Paste commands are only meaningful in certain contexts. The C The Microsoft Foundation Class Library does provide Clipboard support for text editing with the `CEdit` and `CEditView` classes. The OLE classes also simplify implementing Clipboard operations that involve OLE items. For more information on the OLE classes, see [Clipboard: Using the OLE Clipboard Mechanism](clipboard-using-the-ole-clipboard-mechanism.md). -Implementing other Edit menu commands, such as Undo (**ID_EDIT_UNDO**) and Redo (**ID_EDIT_REDO**), is also left to you. If your application does not support these commands, you can easily delete them from your resource file using the Visual C++ resource editors. +Implementing other Edit menu commands, such as Undo (**ID_EDIT_UNDO**) and Redo (**ID_EDIT_REDO**), is also left to you. If your application does not support these commands, you can easily delete them from your resource file using the Visual Studio resource editors. ## What do you want to know more about diff --git a/docs/mfc/command-ids.md b/docs/mfc/command-ids.md index aacb5c805f9..d5508f8a545 100644 --- a/docs/mfc/command-ids.md +++ b/docs/mfc/command-ids.md @@ -11,7 +11,7 @@ A command is fully described by its command ID alone (encoded in the **WM_COMMAN For example, a Clear All item in the Edit menu might be assigned an ID such as **ID_EDIT_CLEAR_ALL**. The class library predefines some IDs, particularly for commands that the framework handles itself, such as **ID_EDIT_CLEAR_ALL** or **ID_FILE_OPEN**. You will create other command IDs yourself. -When you create your own menus in the Visual C++ menu editor, it is a good idea to follow the class library's naming convention as illustrated by **ID_FILE_OPEN**. [Standard Commands](standard-commands.md) explains the standard commands defined by the class library. +When you create your own menus in the Visual Studio menu editor, it is a good idea to follow the class library's naming convention as illustrated by **ID_FILE_OPEN**. [Standard Commands](standard-commands.md) explains the standard commands defined by the class library. ## See also diff --git a/docs/mfc/containers-for-activex-controls.md b/docs/mfc/containers-for-activex-controls.md index 6f6926c793a..8f11ee29d83 100644 --- a/docs/mfc/containers-for-activex-controls.md +++ b/docs/mfc/containers-for-activex-controls.md @@ -7,7 +7,7 @@ ms.assetid: 5ff0bf37-07f4-49aa-ad9c-c63d3756243a --- # Containers for ActiveX Controls -You can use ActiveX controls developed in Visual C++ in other applications, as long as they support ActiveX control containment. A number of Microsoft applications, beginning with the versions listed, support ActiveX control containment. +You can use ActiveX controls developed in Visual Studio in other applications, as long as they support ActiveX control containment. A number of Microsoft applications, beginning with the versions listed, support ActiveX control containment. >[!IMPORTANT] > ActiveX is a legacy technology that should not be used for new development. For more information about modern technologies that supersede ActiveX, see [ActiveX Controls](activex-controls.md). @@ -21,7 +21,7 @@ Applications that support ActiveX control containment include: - Visual Basic 4.x and greater -- Visual C++ 4.x and greater +- Microsoft C++ 4.x and greater - Access 95 and greater diff --git a/docs/mfc/controls-mfc.md b/docs/mfc/controls-mfc.md index fda1eeccf12..2fe0a205f76 100644 --- a/docs/mfc/controls-mfc.md +++ b/docs/mfc/controls-mfc.md @@ -17,7 +17,7 @@ Controls are objects that users can interact with to enter or manipulate data. T ## Windows Common Controls -The Windows operating system has always provided a number of Windows common controls. These control objects are programmable, and the Visual C++ dialog editor supports adding them to your dialog boxes. The Microsoft Foundation Class Library (MFC) supplies classes that encapsulate each of these controls, as shown in the table [Windows Common Controls and MFC Classes](#_core_windows_common_controls_and_mfc_classes). (Some items in the table have related topics that describe them further. For controls that lack topics, see the documentation for the MFC class.) +The Windows operating system has always provided a number of Windows common controls. These control objects are programmable, and the Visual Studio dialog editor supports adding them to your dialog boxes. The Microsoft Foundation Class Library (MFC) supplies classes that encapsulate each of these controls, as shown in the table [Windows Common Controls and MFC Classes](#_core_windows_common_controls_and_mfc_classes). (Some items in the table have related topics that describe them further. For controls that lack topics, see the documentation for the MFC class.) Class [CWnd](reference/cwnd-class.md) is the base class of all window classes, including all of the control classes. diff --git a/docs/mfc/creating-an-active-document-container-application.md b/docs/mfc/creating-an-active-document-container-application.md index c1ef6e9ac2d..077cea8136c 100644 --- a/docs/mfc/creating-an-active-document-container-application.md +++ b/docs/mfc/creating-an-active-document-container-application.md @@ -14,7 +14,7 @@ The simplest and most recommended way to create an active document container app 1. From the **File** menu, click **Project**from the **New** submenu. -1. From the left pane, click **Visual C++** project type. +1. From the left pane, click **MicrosoftVisual Studio** project type. 1. Select **MFC Application** from the right pane. diff --git a/docs/mfc/crebar-vs-crebarctrl.md b/docs/mfc/crebar-vs-crebarctrl.md index 6750c3db526..34ddc168552 100644 --- a/docs/mfc/crebar-vs-crebarctrl.md +++ b/docs/mfc/crebar-vs-crebarctrl.md @@ -11,7 +11,7 @@ MFC provides two classes to create rebars: [CReBar](reference/crebar-class.md) a `CReBarCtrl` is a wrapper class for the Win32 rebar control, and therefore may be easier to implement if you do not intend to integrate the rebar into the MFC architecture. If you plan to use `CReBarCtrl` and integrate the rebar into the MFC architecture, you must take additional care to communicate rebar control manipulations to MFC. This communication is not difficult; however, it is additional work that is unneeded when you use `CReBar`. -Visual C++ provides two ways to take advantage of the rebar common control. +Visual Studio provides two ways to take advantage of the rebar common control. - Create the rebar using `CReBar`, and then call [CReBar::GetReBarCtrl](reference/crebar-class.md#getrebarctrl) to get access to the `CReBarCtrl` member functions. diff --git a/docs/mfc/cwinapp-the-application-class.md b/docs/mfc/cwinapp-the-application-class.md index ba5a5f0062f..a34f9b55a13 100644 --- a/docs/mfc/cwinapp-the-application-class.md +++ b/docs/mfc/cwinapp-the-application-class.md @@ -19,7 +19,7 @@ Like any program for the Windows operating system, your framework application ha To initialize the application, `WinMain` calls your application object's `InitApplication` and `InitInstance` member functions. To run the application's message loop, `WinMain` calls the **Run** member function. On termination, `WinMain` calls the application object's `ExitInstance` member function. > [!NOTE] -> Names shown in **bold** in this documentation indicate elements supplied by the Microsoft Foundation Class Library and Visual C++. Names shown in `monospaced` type indicate elements that you create or override. +> Names shown in **bold** in this documentation indicate elements supplied by the Microsoft Foundation Class Library and Visual Studio. Names shown in `monospaced` type indicate elements that you create or override. ## See also diff --git a/docs/mfc/dao-classes.md b/docs/mfc/dao-classes.md index ad16f3fe673..85553ceccae 100644 --- a/docs/mfc/dao-classes.md +++ b/docs/mfc/dao-classes.md @@ -14,7 +14,7 @@ These classes work with the other application framework classes to give easy acc Programs that use DAO databases will have at least a `CDaoDatabase` object and a `CDaoRecordset` object. > [!NOTE] -> The Visual C++ environment and wizards no longer support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use ODBC for new MFC projects. You should only use DAO in maintaining existing applications. +> The Visual Studio environment and wizards no longer support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use ODBC for new MFC projects. You should only use DAO in maintaining existing applications. [CDaoWorkspace](reference/cdaoworkspace-class.md)
Manages a named, password-protected database session from login to logoff. Most programs use the default workspace. diff --git a/docs/mfc/derived-view-classes-available-in-mfc.md b/docs/mfc/derived-view-classes-available-in-mfc.md index e0831af6ac6..90f9c090011 100644 --- a/docs/mfc/derived-view-classes-available-in-mfc.md +++ b/docs/mfc/derived-view-classes-available-in-mfc.md @@ -18,7 +18,7 @@ The following table shows MFC's view classes and their relationships to one anot |[CEditView](reference/ceditview-class.md)|A simple view based on the Windows edit box control. Allows entering and editing text and can be used as the basis for a simple text editor application. See also `CRichEditView`.| |[CRichEditView](reference/cricheditview-class.md)|A view containing a [CRichEditCtrl](reference/cricheditctrl-class.md) object. This class is analogous to `CEditView`, but unlike `CEditView`, `CRichEditView` handles formatted text.| |[CListView](reference/clistview-class.md)|A view containing a [CListCtrl](reference/clistctrl-class.md) object.| -|[CTreeView](reference/ctreeview-class.md)|A view containing a [CTreeCtrl](reference/ctreectrl-class.md) object, for views that resemble the Solution Explorer window in Visual C++.| +|[CTreeView](reference/ctreeview-class.md)|A view containing a [CTreeCtrl](reference/ctreectrl-class.md) object, for views that resemble the Solution Explorer window in Visual Studio.| |[CScrollView](reference/cscrollview-class.md)|Base class of `CFormView`, `CRecordView`, and `CDaoRecordView`. Implements scrolling the view's contents.| |[CFormView](reference/cformview-class.md)|A form view, a view that contains controls. A forms-based application provides one or more such form interfaces.| |[CHtmlView](reference/chtmlview-class.md)|A Web browser view with which the application's user can browse sites on the World Wide Web, as well as folders in the local file system and on a network. The Web browser view can also work as an Active document container.| diff --git a/docs/mfc/dialog-bars.md b/docs/mfc/dialog-bars.md index 3e1b3cb5fba..f1d629b751a 100644 --- a/docs/mfc/dialog-bars.md +++ b/docs/mfc/dialog-bars.md @@ -9,7 +9,7 @@ ms.assetid: 485c8055-6bb0-4051-8417-dd2971499321 A dialog bar is a toolbar, a kind of [control bar](control-bars.md) that can contain any kind of control. Because it has the characteristics of a modeless dialog box, a [CDialogBar](reference/cdialogbar-class.md) object provides a more powerful toolbar. -There are several key differences between a toolbar and a `CDialogBar` object. A `CDialogBar` object is created from a dialog-template resource, which you can create with the Visual C++ dialog editor and which can contain any kind of Windows control. The user can tab from control to control. And you can specify an alignment style to align the dialog bar with any part of the parent frame window or even to leave it in place if the parent is resized. The following figure shows a dialog bar with a variety of controls. +There are several key differences between a toolbar and a `CDialogBar` object. A `CDialogBar` object is created from a dialog-template resource, which you can create with the Visual Studio dialog editor and which can contain any kind of Windows control. The user can tab from control to control. And you can specify an alignment style to align the dialog bar with any part of the parent frame window or even to leave it in place if the parent is resized. The following figure shows a dialog bar with a variety of controls. ![Example of a VC Dialog Bar.](../mfc/media/vc378t1.gif "VC Dialog Bar")
A Dialog Bar diff --git a/docs/mfc/dialog-boxes.md b/docs/mfc/dialog-boxes.md index 780520efb62..52ff46b668e 100644 --- a/docs/mfc/dialog-boxes.md +++ b/docs/mfc/dialog-boxes.md @@ -7,7 +7,7 @@ ms.assetid: e4feea1a-8360-4ccb-9b84-507f1ccd9ef3 --- # Dialog Boxes -Applications for Windows frequently communicate with the user through dialog boxes. Class [CDialog](reference/cdialog-class.md) provides an interface for managing dialog boxes, the Visual C++ dialog editor makes it easy to design dialog boxes and create their dialog-template resources, and Code wizards simplify the process of initializing and validating the controls in a dialog box and of gathering the values entered by the user. +Applications for Windows frequently communicate with the user through dialog boxes. Class [CDialog](reference/cdialog-class.md) provides an interface for managing dialog boxes, the Visual Studio dialog editor makes it easy to design dialog boxes and create their dialog-template resources, and Code wizards simplify the process of initializing and validating the controls in a dialog box and of gathering the values entered by the user. Dialog boxes contain controls, including: diff --git a/docs/mfc/docking-and-floating-toolbars.md b/docs/mfc/docking-and-floating-toolbars.md index 2dc9f54a2a7..e68d5dd87f7 100644 --- a/docs/mfc/docking-and-floating-toolbars.md +++ b/docs/mfc/docking-and-floating-toolbars.md @@ -57,7 +57,7 @@ The MFC implementation of dockable toolbars does not provide some of the extende ## Dynamically Resizing the Toolbar -As of Visual C++ version 4.0, you can make it possible for users of your application to resize floating toolbars dynamically. Typically, a toolbar has a long, linear shape, displayed horizontally. But you can change the toolbar's orientation and its shape. For example, when the user docks a toolbar against one of the vertical sides of the frame window, the shape changes to a vertical layout. It's also possible to reshape the toolbar into a rectangle with multiple rows of buttons. +As of Visual Studio version 4.0, you can make it possible for users of your application to resize floating toolbars dynamically. Typically, a toolbar has a long, linear shape, displayed horizontally. But you can change the toolbar's orientation and its shape. For example, when the user docks a toolbar against one of the vertical sides of the frame window, the shape changes to a vertical layout. It's also possible to reshape the toolbar into a rectangle with multiple rows of buttons. You can: diff --git a/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md b/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md index 6003a3f8dc8..5ebeea6596b 100644 --- a/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md +++ b/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md @@ -7,7 +7,7 @@ ms.assetid: 70c34a60-2701-4981-acea-c08a5787d8e6 --- # Document and View Classes Created by the MFC Application Wizard -The MFC Application Wizard gives you a head start on your program development by creating skeletal document and view classes for you. You can then [map commands and messages to these classes](reference/mapping-messages-to-functions.md) and use the Visual C++ source code editor to write their member functions. +The MFC Application Wizard gives you a head start on your program development by creating skeletal document and view classes for you. You can then [map commands and messages to these classes](reference/mapping-messages-to-functions.md) and use the Visual Studio source code editor to write their member functions. The document class created by the MFC Application Wizard is derived from class [CDocument](reference/cdocument-class.md). The view class is derived from [CView](reference/cview-class.md). The names that the Application Wizard gives these classes and the files that contain them are based on the project name you supply in the Application Wizard dialog box. In the Application Wizard, you can use the Generated Classes page to alter the default names. diff --git a/docs/mfc/form-views-mfc.md b/docs/mfc/form-views-mfc.md index 05801af5441..87517953bb5 100644 --- a/docs/mfc/form-views-mfc.md +++ b/docs/mfc/form-views-mfc.md @@ -7,14 +7,14 @@ ms.assetid: efbe73c1-4ca4-4613-aac2-30d916e92c0e --- # Form Views (MFC) -You can add forms to any Visual C++ application that supports the MFC libraries, including a [forms-based application](reference/creating-a-forms-based-mfc-application.md) (one whose view class is derived from `CFormView`). If you did not initially create your application to support forms, Visual C++ will add this support for you when you insert a new form. In an SDI or MDI application, which implements the default [document/view architecture](document-view-architecture.md), when the user chooses the **New** command (by default, on the **File** menu), Visual C++ prompts the user to choose from the available forms. +You can add forms to any Visual Studio application that supports the MFC libraries, including a [forms-based application](reference/creating-a-forms-based-mfc-application.md) (one whose view class is derived from `CFormView`). If you did not initially create your application to support forms, Visual Studio will add this support for you when you insert a new form. In an SDI or MDI application, which implements the default [document/view architecture](document-view-architecture.md), when the user chooses the **New** command (by default, on the **File** menu), Visual Studio prompts the user to choose from the available forms. With an SDI application, when the user chooses the **New** command, the current instance of the form continues to run but a new instance of the application with the selected form is created if one is not found. In an MDI application, the current instance of the form continues to run when the user chooses the **New** command. > [!NOTE] -> You can insert a form into a dialog-based application (one whose dialog class is based on `CDialog` and one in which no view class is implemented). However, without the document/view architecture, Visual C++ does not automatically implement the **File** > **New** functionality. You must create a way for the user to view additional forms, such as by implementing a tabbed dialog box with various property pages. +> You can insert a form into a dialog-based application (one whose dialog class is based on `CDialog` and one in which no view class is implemented). However, without the document/view architecture, Visual Studio does not automatically implement the **File** > **New** functionality. You must create a way for the user to view additional forms, such as by implementing a tabbed dialog box with various property pages. -When you insert a new form into your application, Visual C++ does the following: +When you insert a new form into your application, Visual Studio does the following: - Creates a class based on one of the form-style classes that you choose (`CFormView`, `CRecordView`, `CDaoRecordView`, or `CDialog`). @@ -42,7 +42,7 @@ For applications based on the document/view architecture, the **New Form** comma - Adds a call to `AddDocumentTemplate` in your application's `InitInstance` code. - Visual C++ adds this code for each new form you create, which adds the form to the list of available forms when the user chooses the **New** command. This code includes the form's associated resource ID and the names of the associated document, view, and frame classes that together make up the new form object. + Visual Studio adds this code for each new form you create, which adds the form to the list of available forms when the user chooses the **New** command. This code includes the form's associated resource ID and the names of the associated document, view, and frame classes that together make up the new form object. Document templates serve as the connection between documents, frame windows, and views. For a single document, you can create many templates. diff --git a/docs/mfc/framework-mfc.md b/docs/mfc/framework-mfc.md index 0bd459a85d7..7c8996f07c3 100644 --- a/docs/mfc/framework-mfc.md +++ b/docs/mfc/framework-mfc.md @@ -7,7 +7,7 @@ ms.assetid: 3be0fec8-9843-4119-ae42-ece993ef500b --- # Framework (MFC) -Your work with the Microsoft Foundation Class (MFC) Library framework is based largely on a few major classes and several Visual C++ tools. Some classes encapsulate a large portion of the Win32 application programming interface (API). Other classes encapsulate application concepts such as documents, views, and the application itself. Still others encapsulate OLE features and ODBC and DAO data-access functionality. (DAO is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete.) +Your work with the Microsoft Foundation Class (MFC) Library framework is based largely on a few major classes and several Visual Studio tools. Some classes encapsulate a large portion of the Win32 application programming interface (API). Other classes encapsulate application concepts such as documents, views, and the application itself. Still others encapsulate OLE features and ODBC and DAO data-access functionality. (DAO is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete.) For example, Win32's concept of window is encapsulated by MFC class `CWnd`. That is, a C++ class called `CWnd` encapsulates or "wraps" the `HWND` handle that represents a Windows window. Likewise, class `CDialog` encapsulates Win32 dialog boxes. diff --git a/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md b/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md index 4b8cec07283..e9adb0c6a10 100644 --- a/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md +++ b/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md @@ -9,7 +9,7 @@ ms.assetid: dc0f9f47-3184-4e7a-8074-2c63e0359885 The Win32 Internet Extensions, or WinInet, provide access to common Internet protocols, including gopher, FTP, and HTTP. Using WinInet, you can write Internet client applications at a higher level of programming, without having to deal with WinSock, TCP/IP, or the details of specific Internet protocols. WinInet provides a consistent set of functions for all three protocols, with a familiar Win32 API interface. This consistency minimizes code changes you need to make if the underlying protocol changes (for example, from FTP to HTTP). -Visual C++ provides two ways for you to use WinInet. You can call the Win32 Internet functions directly (see the OLE documentation in the Windows SDK for more information) or you can use WinInet through the [MFC WinInet classes](mfc-classes-for-creating-internet-client-applications.md). +Visual Studio provides two ways for you to use WinInet. You can call the Win32 Internet functions directly (see the OLE documentation in the Windows SDK for more information) or you can use WinInet through the [MFC WinInet classes](mfc-classes-for-creating-internet-client-applications.md). **You can use WinInet to:** diff --git a/docs/mfc/idle-loop-processing.md b/docs/mfc/idle-loop-processing.md index 33d16f0956d..04bee6c2f4a 100644 --- a/docs/mfc/idle-loop-processing.md +++ b/docs/mfc/idle-loop-processing.md @@ -32,7 +32,7 @@ Another method for performing idle processing in an application involves embeddi [!code-cpp[NVC_MFCDocView#8](codesnippet/cpp/idle-loop-processing_1.cpp)] -This code, embedded in a function, loops as long as there is idle processing to do. Within that loop, a nested loop repeatedly calls `PeekMessage`. As long as that call returns a nonzero value, the loop calls `CWinThread::PumpMessage` to perform normal message translation and dispatching. Although `PumpMessage` is undocumented, you can examine its source code in the ThrdCore.Cpp file in the \atlmfc\src\mfc directory of your Visual C++ installation. +This code, embedded in a function, loops as long as there is idle processing to do. Within that loop, a nested loop repeatedly calls `PeekMessage`. As long as that call returns a nonzero value, the loop calls `CWinThread::PumpMessage` to perform normal message translation and dispatching. Although `PumpMessage` is undocumented, you can examine its source code in the ThrdCore.Cpp file in the \atlmfc\src\mfc directory of your Visual Studio installation. Once the inner loop ends, the outer loop performs idle processing with one or more calls to `OnIdle`. The first call is for MFC's purposes. You can make additional calls to `OnIdle` to do your own background work. diff --git a/docs/mfc/inserting-a-form-into-a-project.md b/docs/mfc/inserting-a-form-into-a-project.md index 0166e9f5d36..ad08c10130e 100644 --- a/docs/mfc/inserting-a-form-into-a-project.md +++ b/docs/mfc/inserting-a-form-into-a-project.md @@ -22,7 +22,7 @@ Forms provide a convenient container for controls. You can easily insert an MFC- 1. Using the MFC Class Wizard, make the new class derive from [CFormView](reference/cformview-class.md). -Visual C++ adds the form to your application, opening it inside the Dialog editor so that you can begin adding controls and working on its overall design. +Visual Studio adds the form to your application, opening it inside the Dialog editor so that you can begin adding controls and working on its overall design. You may want to perform the following additional steps (not applicable for dialog-based applications): diff --git a/docs/mfc/making-and-using-controls.md b/docs/mfc/making-and-using-controls.md index 6e88beb322b..8cba3f0fffc 100644 --- a/docs/mfc/making-and-using-controls.md +++ b/docs/mfc/making-and-using-controls.md @@ -8,7 +8,7 @@ ms.topic: concept-article --- # Making and Using Controls -You make most controls for dialog boxes in the Visual C++ [dialog editor](../windows/dialog-editor.md). But you can also create controls in any dialog box or window. +You make most controls for dialog boxes in the Visual Studio [dialog editor](../windows/dialog-editor.md). But you can also create controls in any dialog box or window. ## What do you want to know more about diff --git a/docs/mfc/mapi-support-in-mfc.md b/docs/mfc/mapi-support-in-mfc.md index cdb9d8b6388..10329e6fd07 100644 --- a/docs/mfc/mapi-support-in-mfc.md +++ b/docs/mfc/mapi-support-in-mfc.md @@ -21,7 +21,7 @@ MAPI needs to read the file to send the attachment. If the application keeps its #### To implement a Send Mail command with MFC -1. Use the Visual C++ menu editor to add a menu item whose command ID is ID_FILE_SEND_MAIL. +1. Use the Visual Studio menu editor to add a menu item whose command ID is ID_FILE_SEND_MAIL. This command ID is provided by the framework in AFXRES.H. The command can be added to any menu, but it is usually added to the **File** menu. diff --git a/docs/mfc/menus-mfc.md b/docs/mfc/menus-mfc.md index 5cbfe9db0ff..8bbd4098c79 100644 --- a/docs/mfc/menus-mfc.md +++ b/docs/mfc/menus-mfc.md @@ -13,7 +13,7 @@ MFC supplies two elements to help you work with menus: - A mechanism for updating menus and toolbar buttons: enabling or disabling them on the fly to suit current program conditions. -Visual C++ also provides a [menu editor](../windows/menu-editor.md) for creating and editing your program's menu resources. +Visual Studio also provides a [menu editor](../windows/menu-editor.md) for creating and editing your program's menu resources. ## What do you want to know more about diff --git a/docs/mfc/message-handlers.md b/docs/mfc/message-handlers.md index 80bf4659c7d..5e8c2495f70 100644 --- a/docs/mfc/message-handlers.md +++ b/docs/mfc/message-handlers.md @@ -13,7 +13,7 @@ Writing message handlers accounts for a large proportion of your work in writing What does the handler for a message do It does whatever you want done in response to that message. You can create the handlers by using the [Class Wizard](reference/mfc-class-wizard.md) of the class, and then fill in the handler's code using the source code editor. -You can use all of the facilities of Microsoft Visual C++ and MFC to write your handlers. For a list of all classes, see [Class Library Overview](class-library-overview.md) in the *MFC Reference*. +You can use all of the facilities of Visual Studio and MFC to write your handlers. For a list of all classes, see [Class Library Overview](class-library-overview.md) in the *MFC Reference*. ## See also diff --git a/docs/mfc/methods-of-creating-a-status-bar.md b/docs/mfc/methods-of-creating-a-status-bar.md index 7d4e9bc4cf0..aa914e3f097 100644 --- a/docs/mfc/methods-of-creating-a-status-bar.md +++ b/docs/mfc/methods-of-creating-a-status-bar.md @@ -11,7 +11,7 @@ MFC provides two classes to create status bars: [CStatusBar](reference/cstatusba `CStatusBarCtrl` usually results in a smaller executable, and you may prefer to use `CStatusBarCtrl` if you do not intend to integrate the status bar into the MFC architecture. If you plan to use `CStatusBarCtrl` and integrate the status bar into the MFC architecture, you must take additional care to communicate status bar control manipulations to MFC. This communication is not difficult; however, it is additional work that is unneeded when you use `CStatusBar`. -Visual C++ provides two ways to take advantage of the status bar common control. +Visual Studio provides two ways to take advantage of the status bar common control. - Create the status bar using `CStatusBar`, and then call [CStatusBar::GetStatusBarCtrl](reference/cstatusbar-class.md#getstatusbarctrl) to get access to the `CStatusBarCtrl` member functions. diff --git a/docs/mfc/methods-of-creating-a-toolbar.md b/docs/mfc/methods-of-creating-a-toolbar.md index aca7ea41dc3..b241b3f46a3 100644 --- a/docs/mfc/methods-of-creating-a-toolbar.md +++ b/docs/mfc/methods-of-creating-a-toolbar.md @@ -11,7 +11,7 @@ MFC provides two classes to create toolbars: [CToolBar](reference/ctoolbar-class `CToolBarCtrl` usually results in a smaller executable, and you may prefer to use `CToolBarCtrl` if you do not intend to integrate the toolbar into the MFC architecture. If you plan to use `CToolBarCtrl` and integrate the toolbar into the MFC architecture, you must take additional care to communicate toolbar control manipulations to MFC. This communication is not difficult; however, it is additional work that is unneeded when you use `CToolBar`. -Visual C++ provides two ways to take advantage of the toolbar common control. +Visual Studio provides two ways to take advantage of the toolbar common control. - Create the toolbar using `CToolBar`, and then call [CToolBar::GetToolBarCtrl](reference/ctoolbar-class.md#gettoolbarctrl) to get access to the `CToolBarCtrl` member functions. diff --git a/docs/mfc/mfc-activex-controls-advanced-topics.md b/docs/mfc/mfc-activex-controls-advanced-topics.md index 12416853047..ecf01fac6b0 100644 --- a/docs/mfc/mfc-activex-controls-advanced-topics.md +++ b/docs/mfc/mfc-activex-controls-advanced-topics.md @@ -29,7 +29,7 @@ Because the ActiveX control classes are part of the class library, you can apply For a general overview of the MFC database classes, see [MFC Database Classes (DAO and ODBC)](../data/mfc-database-classes-odbc-and-dao.md). The article introduces both the MFC ODBC classes and the MFC DAO classes and directs you to more details on either. > [!NOTE] -> DAO is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-programming.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. +> DAO is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-programming.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. ## Implementing a Parameterized Property diff --git a/docs/mfc/mfc-activex-controls-using-stock-property-pages.md b/docs/mfc/mfc-activex-controls-using-stock-property-pages.md index e9553c4cef5..475aab0f011 100644 --- a/docs/mfc/mfc-activex-controls-using-stock-property-pages.md +++ b/docs/mfc/mfc-activex-controls-using-stock-property-pages.md @@ -30,7 +30,7 @@ Note that the count of property pages, in the BEGIN_PROPPAGEIDS macro, is 4. Thi After these modifications have been made, rebuild your project. Your control now has property pages for the font, picture, and color properties. > [!NOTE] -> If the control stock property pages cannot be accessed, it may be because the MFC DLL (MFCxx.DLL) has not been properly registered with the current operating system. This usually results from installing Visual C++ under an operating system different from the one currently running. +> If the control stock property pages cannot be accessed, it may be because the MFC DLL (MFCxx.DLL) has not been properly registered with the current operating system. This usually results from installing Visual Studio under an operating system different from the one currently running. > [!TIP] > If your stock property pages are not visible (see previous Note), register the DLL by running RegSvr32.exe from the command line with the full path name to the DLL. diff --git a/docs/mfc/mfc-activex-controls.md b/docs/mfc/mfc-activex-controls.md index fb744cd66d4..18ff2df6fdd 100644 --- a/docs/mfc/mfc-activex-controls.md +++ b/docs/mfc/mfc-activex-controls.md @@ -80,7 +80,7 @@ Note that a control is not responsible for obtaining access to the storage mediu ## Installing ActiveX Control Classes and Tools -When you install Visual C++, the MFC ActiveX control classes and retail and debug ActiveX control run-time DLLs are automatically installed if ActiveX controls are selected in Setup (they are selected by default). +When you install Visual Studio, the MFC ActiveX control classes and retail and debug ActiveX control run-time DLLs are automatically installed if ActiveX controls are selected in Setup (they are selected by default). By default, the ActiveX control classes and tools are installed in the following subdirectories under \Program Files\Microsoft Visual Studio .NET: diff --git a/docs/mfc/mfc-and-atl.md b/docs/mfc/mfc-and-atl.md index d9e499ac1bd..6859ab97126 100644 --- a/docs/mfc/mfc-and-atl.md +++ b/docs/mfc/mfc-and-atl.md @@ -12,7 +12,7 @@ The Microsoft Foundation Classes (MFC) provide a C++ object-oriented wrapper ove You can create MFC or ATL programs with Visual Studio Community Edition or higher. The Express editions do not support MFC or ATL. -In Visual Studio 2015, Visual C++ is an optional component, and MFC and ATL components are optional sub-components under Visual C++. If you do not select these components when you first install Visual Studio, you will be prompted to install them the first time you attempt to create or open an MFC or ATL project. +In Visual Studio 2015, Microsoft C++ is an optional component, and MFC and ATL components are optional sub-components under Microsoft C++. If you do not select these components when you first install Visual Studio, you will be prompted to install them the first time you attempt to create or open an MFC or ATL project. In Visual Studio 2017 and later, MFC and ATL are optional sub-components under the **Desktop development with C++** workload in the Visual Studio Installer program. You can install ATL support without MFC, or combined MFC and ATL support (MFC depends on ATL). For more information about workloads and components, see [Install Visual Studio](/visualstudio/install/install-visual-studio). diff --git a/docs/mfc/mfc-desktop-applications.md b/docs/mfc/mfc-desktop-applications.md index d1876d18607..873618fee18 100644 --- a/docs/mfc/mfc-desktop-applications.md +++ b/docs/mfc/mfc-desktop-applications.md @@ -72,8 +72,8 @@ Provides links to classes that are shared between MFC and ATL. [MFC Samples](../overview/visual-cpp-samples.md#mfc-samples)
Provides links to samples that demonstrate how to use MFC. -[Visual C++ Libraries Reference](../standard-library/cpp-standard-library-reference.md)
-Provides links to the various libraries provided with Visual C++, including ATL, MFC, OLE DB Templates, the C run-time library, and the C++ Standard Library. +[C++ Libraries Reference](../standard-library/cpp-standard-library-reference.md)
+Provides links to the various libraries provided with Visual Studio, including ATL, MFC, OLE DB Templates, the C run-time library, and the C++ Standard Library. [Debugging in Visual Studio](/visualstudio/debugger/debugging-in-visual-studio)
Provides links to using the Visual Studio debugger to correct logic errors in your application or stored procedures. diff --git a/docs/mfc/mfc-internet-programming-tasks.md b/docs/mfc/mfc-internet-programming-tasks.md index 7498fd45c93..c0911a53a89 100644 --- a/docs/mfc/mfc-internet-programming-tasks.md +++ b/docs/mfc/mfc-internet-programming-tasks.md @@ -9,7 +9,7 @@ ms.assetid: 6377e9b8-07c4-4380-b63b-05f5a9061313 This section contains detailed steps for adding Internet support to your applications. Topics include how to use the MFC classes to Internet-enable your existing applications, and how to add Active document support to your existing COM component. Do you want to create a document with up-to-the-minute stock quotes, Pittsburgh's football scores, and the latest temperature in Antarctica Microsoft provides a number of technologies to help you do that over the Internet. -Active technologies include ActiveX controls (formerly OLE controls) and Active documents; WinInet for easily retrieving and saving files across the Internet; and asynchronous monikers for efficient data downloading. Visual C++ provides wizards to help you get started quickly with a starter application. For an introduction to these technologies, see [MFC Internet Programming Basics](mfc-internet-programming-basics.md) and [MFC COM](mfc-com.md). +Active technologies include ActiveX controls (formerly OLE controls) and Active documents; WinInet for easily retrieving and saving files across the Internet; and asynchronous monikers for efficient data downloading. Visual Studio provides wizards to help you get started quickly with a starter application. For an introduction to these technologies, see [MFC Internet Programming Basics](mfc-internet-programming-basics.md) and [MFC COM](mfc-com.md). Have you always wanted to FTP a file but haven't learned WinSock and network programming protocols WinInet classes encapsulate these protocols, providing you with a simple set of functions you can use to write a client application on the Internet to download files using HTTP, FTP, and gopher. You can use WinInet to search directories on your hard drive or around the world. You can transparently collect data of several different types, and present it to the user in an integrated interface. diff --git a/docs/mfc/mfc-library-versions.md b/docs/mfc/mfc-library-versions.md index bafc3f49141..974d8e1bb97 100644 --- a/docs/mfc/mfc-library-versions.md +++ b/docs/mfc/mfc-library-versions.md @@ -100,7 +100,7 @@ Debugger files that have the same base name and a .pdb extension are also availa The MFC shared DLLs also follow a structured naming convention. This makes it easier to know which DLL or library you should be using for which purpose. -The MFC DLLs have *version* numbers that indicate binary compatibility. Use MFC DLLs that have the same version as your other libraries and compiler toolset to guarantee compatibility within a project. +The MFC DLLs have *version* numbers that indicate binary compatibility. Use MFC DLLs that have the same version as your other libraries and compiler build tools to guarantee compatibility within a project. |DLL|Description| |---------|-----------------| @@ -117,7 +117,7 @@ The import libraries needed to build applications or MFC extension DLLs that use If you are dynamically linking to the shared DLL version of MFC, whether it is from an application or from an MFC extension DLL, you must include the matching MFC*version*.DLL or MFC*version*U.DLL when you deploy your product. -For a list of Visual C++ DLLs that can be distributed with your applications, see [Distributable Code for Microsoft Visual Studio 2017 and Microsoft Visual Studio 2017 SDK (Includes Utilities and BuildServer Files)](/visualstudio/productinfo/2017-redistribution-vs) or [Distributable Code for Visual Studio 2019](/visualstudio/releases/2019/redistribution). +For a list of Visual Studio DLLs that can be distributed with your applications, see [Distributable Code for Microsoft Visual Studio 2017 and Microsoft Visual Studio 2017 SDK (Includes Utilities and BuildServer Files)](/visualstudio/productinfo/2017-redistribution-vs) or [Distributable Code for Visual Studio 2019](/visualstudio/releases/2019/redistribution). For more information on MBCS and Unicode support in MFC, see [Unicode and Multibyte Character Set (MBCS) Support](../atl-mfc-shared/unicode-and-multibyte-character-set-mbcs-support.md). diff --git a/docs/mfc/mfc-mbcs-dll-add-on.md b/docs/mfc/mfc-mbcs-dll-add-on.md index 154e05d42f4..0bc1d03de9a 100644 --- a/docs/mfc/mfc-mbcs-dll-add-on.md +++ b/docs/mfc/mfc-mbcs-dll-add-on.md @@ -10,7 +10,7 @@ Support for MFC and its multibyte character set (MBCS) libraries requires an add **Visual Studio 2013**: By default, the MFC libraries installed in Visual Studio 2013 only support Unicode development. You need the MBCS DLLs in order to build an MFC project in Visual Studio 2013 that has the **Character Set** property set to **Use Multi-Byte Character Set** or **Not Set**. Download the DLL at [Multibyte MFC Library for Visual Studio 2013](https://www.microsoft.com/download/details.aspx?id=40770). -**Visual Studio 2015**: Both Unicode and MBCS MFC DLLs are included in the Visual C++ setup components, but support for MFC is not installed by default. Visual C++ and MFC are optional install configurations in Visual Studio setup. To make sure that MFC is installed, choose **Custom** in setup, and under **Programming Languages**, make sure that **Visual C++** and **Microsoft Foundation Classes for C++** are selected. If you have already installed Visual Studio, you will be prompted to install Visual C++ and/or MFC when you attempt to create an MFC project. +**Visual Studio 2015**: Both Unicode and MBCS MFC DLLs are included in the Visual Studio setup components, but support for MFC is not installed by default. C++ and MFC are optional install configurations in Visual Studio setup. To make sure that MFC is installed, choose **Custom** in setup, and under **Programming Languages**, make sure that **C++ compilers and libraries** and **Microsoft Foundation Classes for C++** are selected. If you have already installed Visual Studio, you will be prompted to install C++ and/or MFC when you attempt to create an MFC project. **Visual Studio 2017 and later**: The Unicode and MBCS MFC DLLs are installed with the **Desktop development with C++** workload when you select **MFC and ATL support** from the **Optional Components** pane in the Visual Studio Installer program. If your installation does not include these components, navigate to the **File | New Projects** dialog and click the **Open Visual Studio Installer** link. For more information, see [Install Visual Studio](/visualstudio/install/install-visual-studio). diff --git a/docs/mfc/mfc-toolbar-implementation.md b/docs/mfc/mfc-toolbar-implementation.md index 696dfdd3cd3..66b9d9ee497 100644 --- a/docs/mfc/mfc-toolbar-implementation.md +++ b/docs/mfc/mfc-toolbar-implementation.md @@ -69,7 +69,7 @@ Also see the MFC General sample [DOCKTOOL](../overview/visual-cpp-samples.md). ## The Toolbar Bitmap -Once constructed, a `CToolBar` object creates the toolbar image by loading a single bitmap that contains one image for each button. The Application Wizard creates a standard toolbar bitmap that you can customize with the Visual C++ [toolbar editor](../windows/toolbar-editor.md). +Once constructed, a `CToolBar` object creates the toolbar image by loading a single bitmap that contains one image for each button. The Application Wizard creates a standard toolbar bitmap that you can customize with the Visual Studio [toolbar editor](../windows/toolbar-editor.md). ### What do you want to know more about diff --git a/docs/mfc/multiple-document-types-views-and-frame-windows.md b/docs/mfc/multiple-document-types-views-and-frame-windows.md index f24bb3620a6..bca21f51732 100644 --- a/docs/mfc/multiple-document-types-views-and-frame-windows.md +++ b/docs/mfc/multiple-document-types-views-and-frame-windows.md @@ -64,7 +64,7 @@ In a splitter window, the window is, or can be, split into two or more scrollabl Dynamic splitter windows, with views of the same class, allow the user to split a window into multiple panes at will and then scroll different panes to see different parts of the document. The user can also unsplit the window to remove the additional views. The splitter windows added to the [Scribble sample](../overview/visual-cpp-samples.md) are an example. That topic describes the technique for creating dynamic splitter windows. A dynamic splitter window is shown in part b of the figure Multiple-View User Interfaces. -Static splitter windows, with views of different classes, start with the window split into multiple panes, each with a different purpose. For example, in the Visual C++ bitmap editor, the image window shows two panes side by side. The left-hand pane displays a life-sized image of the bitmap. The right-hand pane displays a zoomed or magnified image of the same bitmap. The panes are separated by a "splitter bar" that the user can drag to change the relative sizes of the panes. A static splitter window is shown in part c of the figure Multiple-View User Interfaces. +Static splitter windows, with views of different classes, start with the window split into multiple panes, each with a different purpose. For example, in the Visual Studio bitmap editor, the image window shows two panes side by side. The left-hand pane displays a life-sized image of the bitmap. The right-hand pane displays a zoomed or magnified image of the same bitmap. The panes are separated by a "splitter bar" that the user can drag to change the relative sizes of the panes. A static splitter window is shown in part c of the figure Multiple-View User Interfaces. For more information, see class [CSplitterWnd](reference/csplitterwnd-class.md) in the *MFC Reference* and [MFC Samples](../overview/visual-cpp-samples.md#mfc-samples). diff --git a/docs/mfc/programming-activex-controls-in-a-activex-control-container.md b/docs/mfc/programming-activex-controls-in-a-activex-control-container.md index 43334e14538..594f5d61f3c 100644 --- a/docs/mfc/programming-activex-controls-in-a-activex-control-container.md +++ b/docs/mfc/programming-activex-controls-in-a-activex-control-container.md @@ -44,7 +44,7 @@ Once the Circ control is inserted into the project (step 1), insert an instance ## Modifications to the Project -To enable the Container application to access the Circ control, Visual C++ automatically adds the wrapper class (`CCirc`) implementation file (.CPP) to the Container project and the wrapper class header (.H) file to the dialog box header file: +To enable the Container application to access the Circ control, Visual Studio automatically adds the wrapper class (`CCirc`) implementation file (.CPP) to the Container project and the wrapper class header (.H) file to the dialog box header file: [!code-cpp[NVC_MFC_AxCont#1](../mfc/codesnippet/cpp/programming-activex-controls-in-a-activex-control-container_1.h)] @@ -59,7 +59,7 @@ These functions can then be called from other of the application's procedures us ## Member Variable Modifications to the Project -Once the ActiveX control has been added to the project and embedded in a dialog box container, it can be accessed by other parts of the project. The easiest way to access the control is to [create a member variable](../mfc/activex-control-containers-connecting-an-activex-control-to-a-member-variable.md) of the dialog class, `CContainerDlg` (step 2), that is of the same type as the wrapper class added to the project by Visual C++. You can then use the member variable to access the embedded control at any time. +Once the ActiveX control has been added to the project and embedded in a dialog box container, it can be accessed by other parts of the project. The easiest way to access the control is to [create a member variable](../mfc/activex-control-containers-connecting-an-activex-control-to-a-member-variable.md) of the dialog class, `CContainerDlg` (step 2), that is of the same type as the wrapper class added to the project by Visual Studio. You can then use the member variable to access the embedded control at any time. When the **Add Member Variable** dialog box adds the *m_circctl* member variable to the project, it also adds the following lines to the header file (.H) of the `CContainerDlg` class: diff --git a/docs/mfc/property-sheets-and-property-pages-mfc.md b/docs/mfc/property-sheets-and-property-pages-mfc.md index bf595657827..6fa12970360 100644 --- a/docs/mfc/property-sheets-and-property-pages-mfc.md +++ b/docs/mfc/property-sheets-and-property-pages-mfc.md @@ -7,7 +7,7 @@ ms.assetid: de8fea12-6c35-4cef-8625-b8073a379446 --- # Property Sheets and Property Pages (MFC) -An MFC [dialog box](../mfc/dialog-boxes.md) can take on a "tab dialog" look by incorporating property sheets and property pages. Called a "property sheet" in MFC, this kind of dialog box, similar to many dialog boxes in Microsoft Word, Excel, and Visual C++, appears to contain a stack of tabbed sheets, much like a stack of file folders seen from front to back, or a group of cascaded windows. Controls on the front tab are visible; only the labeled tab is visible on the rear tabs. Property sheets are particularly useful for managing large numbers of properties or settings that fall fairly neatly into several groups. Typically, one property sheet can simplify a user interface by replacing several separate dialog boxes. +An MFC [dialog box](../mfc/dialog-boxes.md) can take on a "tab dialog" look by incorporating property sheets and property pages. Called a "property sheet" in MFC, this kind of dialog box, similar to many dialog boxes in Microsoft Word, Excel, and Visual Studio, appears to contain a stack of tabbed sheets, much like a stack of file folders seen from front to back, or a group of cascaded windows. Controls on the front tab are visible; only the labeled tab is visible on the rear tabs. Property sheets are particularly useful for managing large numbers of properties or settings that fall fairly neatly into several groups. Typically, one property sheet can simplify a user interface by replacing several separate dialog boxes. As of MFC version 4.0, property sheets and property pages are implemented using the common controls that come with Windows 95 and Windows NT version 3.51 and later. diff --git a/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md b/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md index db0802eea7c..e1730119ef5 100644 --- a/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md +++ b/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md @@ -20,7 +20,7 @@ A type library contains a binary description of the interfaces exposed by a comp 1. From the shortcut menu, select **Add** > **New Item**. -1. In the **Add New Item** dialog, select **Installed** packages and then select **Visual C++**. +1. In the **Add New Item** dialog, select **Installed** packages and then select **Visual Studio**. 1. In the Templates pane, select **MFC Class from Typelib**, and then select **Add** to display the [Add Class from Typelib Wizard](../../mfc/reference/add-class-from-typelib-wizard.md). diff --git a/docs/mfc/reference/adding-an-mfc-odbc-consumer.md b/docs/mfc/reference/adding-an-mfc-odbc-consumer.md index 887931326d3..a0f9991f6d8 100644 --- a/docs/mfc/reference/adding-an-mfc-odbc-consumer.md +++ b/docs/mfc/reference/adding-an-mfc-odbc-consumer.md @@ -13,7 +13,7 @@ An MFC ODBC consumer consists of an ODBC recordset class and data bindings neces 1. In Class View, right-click the project. On the shortcut menu, click **Add** and then click **Add Class**. -1. In the Visual C++ folder, double-click the **MFC ODBC Consumer** icon or select it and click **Open**. +1. In the Visual Studio folder, double-click the **MFC ODBC Consumer** icon or select it and click **Open**. The MFC ODBC Consumer Wizard opens. diff --git a/docs/mfc/reference/application-information-and-management.md b/docs/mfc/reference/application-information-and-management.md index 444361085bc..4c97fa5d41a 100644 --- a/docs/mfc/reference/application-information-and-management.md +++ b/docs/mfc/reference/application-information-and-management.md @@ -414,7 +414,7 @@ This function is provided for backward compatibility. New applications should us `AfxInitRichEdit` loads `RICHED32.DLL` to initialize version 1.0 of the rich edit control. To use version 2.0 and 3.0 of the rich edit control, `RICHED20.DLL` needs to be loaded. It's loaded by making a call to [`AfxInitRichEdit2`](#afxinitrichedit2). -To update rich edit controls in existing Visual C++ applications to version 2.0, open the .RC file as text, change the class name of each rich edit control from "`RICHEDIT`" to "`RichEdit20a`". Then replace the call to `AfxInitRichEdit` with `AfxInitRichEdit2`. +To update rich edit controls in existing Visual Studio applications to version 2.0, open the .RC file as text, change the class name of each rich edit control from "`RICHEDIT`" to "`RichEdit20a`". Then replace the call to `AfxInitRichEdit` with `AfxInitRichEdit2`. This function also initializes the common controls library, if the library hasn't already been initialized for the process. If you use the rich edit control directly from your MFC application, call this function to assure that MFC has properly initialized the rich edit control runtime. If you call the `Create` method of [`CRichEditCtrl`](../../mfc/reference/cricheditctrl-class.md), [`CRichEditView`](../../mfc/reference/cricheditview-class.md), or [`CRichEditDoc`](../../mfc/reference/cricheditdoc-class.md), you typically don't need to call this function, but in some cases it might be necessary. diff --git a/docs/mfc/reference/cdc-class.md b/docs/mfc/reference/cdc-class.md index 910c96cad27..69ea401ff76 100644 --- a/docs/mfc/reference/cdc-class.md +++ b/docs/mfc/reference/cdc-class.md @@ -1643,7 +1643,7 @@ Specifies the last value returned by the [callback function](callback-functions- For each object of a given type, the callback function that you pass is called with the information for that object. The system calls the callback function until there are no more objects or the callback function returns 0. -New features of Microsoft Visual C++ let you use an ordinary function as the function passed to `EnumObjects`. The address passed to `EnumObjects` is a pointer to a function exported with **`EXPORT`** and with the Pascal calling convention. In protect-mode applications, you don't have to create this function with the Windows `MakeProcInstance` function or free the function after use with the `FreeProcInstance` Windows function. +New features of Visual Studio let you use an ordinary function as the function passed to `EnumObjects`. The address passed to `EnumObjects` is a pointer to a function exported with **`EXPORT`** and with the Pascal calling convention. In protect-mode applications, you don't have to create this function with the Windows `MakeProcInstance` function or free the function after use with the `FreeProcInstance` Windows function. You also don't have to export the function name in an **`EXPORTS`** statement in your application's module-definition file. You can instead use the **`EXPORT`** function modifier, as in @@ -5336,7 +5336,7 @@ Specifies the outcome of the `SetAbortProc` function. Some of the following valu If an application is to allow the print job to be canceled during spooling, it must set the abort function before the print job is started with the [`StartDoc`](#startdoc) member function. The Print Manager calls the abort function during spooling to allow the application to cancel the print job or to process out-of-disk-space conditions. If no abort function is set, the print job will fail if there isn't enough disk space for spooling. -The features of Microsoft Visual C++ simplify the creation of the callback function passed to `SetAbortProc`. The address passed to the `EnumObjects` member function is a pointer to a function exported with `__declspec(dllexport)` and with the **`__stdcall`** calling convention. +The features of Visual Studio simplify the creation of the callback function passed to `SetAbortProc`. The address passed to the `EnumObjects` member function is a pointer to a function exported with `__declspec(dllexport)` and with the **`__stdcall`** calling convention. You also don't have to export the function name in an **`EXPORTS`** statement in your application's module-definition file. You can instead use the **`EXPORT`** function modifier, as in diff --git a/docs/mfc/reference/cdialogbar-class.md b/docs/mfc/reference/cdialogbar-class.md index 8d8c5acd272..4b613e0fa29 100644 --- a/docs/mfc/reference/cdialogbar-class.md +++ b/docs/mfc/reference/cdialogbar-class.md @@ -39,7 +39,7 @@ Creating and using a dialog bar is similar to creating and using a `CFormView` o For more information on `CDialogBar`, see the article [Dialog Bars](../../mfc/dialog-bars.md) and [Technical Note 31](../../mfc/tn031-control-bars.md), Control Bars. > [!NOTE] -> In the current release, a `CDialogBar` object cannot host Windows Forms controls. For more information about Windows Forms controls in Visual C++, see [Using a Windows Form User Control in MFC](../../dotnet/using-a-windows-form-user-control-in-mfc.md). +> In the current release, a `CDialogBar` object cannot host Windows Forms controls. For more information about Windows Forms controls in Visual Studio, see [Using a Windows Form User Control in MFC](../../dotnet/using-a-windows-form-user-control-in-mfc.md). ## Inheritance Hierarchy diff --git a/docs/mfc/reference/cformview-class.md b/docs/mfc/reference/cformview-class.md index 2166ba0f16c..cb84a87b8d5 100644 --- a/docs/mfc/reference/cformview-class.md +++ b/docs/mfc/reference/cformview-class.md @@ -35,7 +35,7 @@ A form view is essentially a view that contains controls. These controls are lai When you're [Creating a Forms-Based Application](../../mfc/reference/creating-a-forms-based-mfc-application.md), you can base its view class on `CFormView`, making it a forms-based application. -You can also insert new [Form Topics](../../mfc/form-views-mfc.md) into document-view-based applications. Even if your application didn't initially support forms, Visual C++ will add this support when you insert a new form. +You can also insert new [Form Topics](../../mfc/form-views-mfc.md) into document-view-based applications. Even if your application didn't initially support forms, Visual Studio will add this support when you insert a new form. The MFC Application Wizard and the Add Class command are the preferred methods for creating forms-based applications. If you need to create a forms-based application without using these methods, see [Creating a Forms-Based Application](../../mfc/reference/creating-a-forms-based-mfc-application.md). diff --git a/docs/mfc/reference/creating-a-forms-based-mfc-application.md b/docs/mfc/reference/creating-a-forms-based-mfc-application.md index 9ef2409ba6b..1378686ea70 100644 --- a/docs/mfc/reference/creating-a-forms-based-mfc-application.md +++ b/docs/mfc/reference/creating-a-forms-based-mfc-application.md @@ -24,7 +24,7 @@ The base class for form-based applications is [`CFormView`](cformview-class.md). Even if you use a base class such as [`CView`](cview-class.md), you can later make your applications forms-based by [adding an MFC class](adding-an-mfc-class.md) derived from `CFormView`. -Once you finish with the wizard, your project opens, and if you selected `CFormView` (or a class that inherits from `CFormView`) as your base class or if you created a dialog-based application, Visual C++ opens the dialog editor. At this point, you are ready to design your first form. +Once you finish with the wizard, your project opens, and if you selected `CFormView` (or a class that inherits from `CFormView`) as your base class or if you created a dialog-based application, Visual Studio opens the dialog editor. At this point, you are ready to design your first form. ### To begin creating a forms-based MFC executable diff --git a/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md b/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md index 06aa373199c..ab5e862682c 100644 --- a/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md +++ b/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md @@ -28,7 +28,7 @@ The WebBrowser control supports Web browsing through hyperlinks and Uniform Reso Because `CHtmlView` simply implements the Microsoft Web browser control, its support for printing isn't like other [`CView`](../../mfc/reference/cview-class.md)-derived classes. Rather, the WebBrowser control implements the printer user interface and printing. As a result, `CHtmlView` doesn't support print preview, and the framework doesn't provide for other printing support functions: for example, [`CView::OnPreparePrinting`](../../mfc/reference/cview-class.md#onprepareprinting), [`CView::OnBeginPrinting`](../../mfc/reference/cview-class.md#onbeginprinting), and [`CView::OnEndPrinting`](../../mfc/reference/cview-class.md#onendprinting), which are available in other MFC applications. -`CHtmlView` acts as a wrapper for the Web browser control, which gives your application a view onto a Web or an HTML page. The wizard creates an override to the [`OnInitialUpdate`](../../mfc/reference/cview-class.md#oninitialupdate) function in the view class, providing a navigational link to the Microsoft Visual C++ Web site: +`CHtmlView` acts as a wrapper for the Web browser control, which gives your application a view onto a Web or an HTML page. The wizard creates an override to the [`OnInitialUpdate`](../../mfc/reference/cview-class.md#oninitialupdate) function in the view class, providing a navigational link to the Visual Studio Web site: ```cpp void CWebView::OnInitialUpdate() diff --git a/docs/mfc/reference/creating-an-mfc-application.md b/docs/mfc/reference/creating-an-mfc-application.md index 5a981ca05ca..8cf0f8d7610 100644 --- a/docs/mfc/reference/creating-an-mfc-application.md +++ b/docs/mfc/reference/creating-an-mfc-application.md @@ -56,7 +56,7 @@ The dialog shows the application type, set to Console Application (.exe). Under ## To create an MFC forms or dialog-based application 1. From the Visual Studio main menu, choose **File** > **New** > **Project**. -1. Under the **Installed** templates, choose **Visual C++** > **MFC/ATL**. If you don't see these, use the Visual Studio Installer to add MFC/ATL functionality. You can access the installer from the Visual Studio menu via **Tools** > **Get Tools and Features...** In the installer, select **Individual components** and search for **mfc** and then select the appropriate library for your machine such as **Visual C++ MFC for x86 and x64 with Spectre Mitigations**. +1. Under the **Installed** templates, choose **C++** > **MFC/ATL**. If you don't see these, use the Visual Studio Installer to add MFC/ATL functionality. You can access the installer from the Visual Studio menu via **Tools** > **Get Tools and Features...** In the installer, select **Individual components** and search for **mfc** and then select the appropriate library for your machine such as **C++ MFC for x86 and x64 with Spectre Mitigations**. 1. Choose **MFC App** from the center pane. 1. Modify the configuration values as needed, then press **OK**. @@ -71,7 +71,7 @@ The dialog shows the various settings set to their default, such as the applicat An MFC console application is a command-line program that uses MFC libraries but runs in the console window. 1. From the main menu, choose **File** > **New** > **Project**. -1. Under the **Installed** templates, choose **Visual C++** > **Windows Desktop**. +1. Under the **Installed** templates, choose **C++** > **Windows Desktop**. 1. From the center pane, choose **Windows Desktop Wizard**. 1. Modify the project name as needed, then press **OK** to open the **Windows Desktop Wizard**. 1. Check the **MFC Headers** box and set other values as needed, then press **OK**. @@ -87,7 +87,7 @@ The dialog shows the application type set to Console Application (.exe). Under a ## To create an MFC forms or dialog-based application 1. From the main menu, choose **File** > **New** > **Project**. -1. Under the **Installed** templates, choose **Visual C++** > **MFC**. +1. Under the **Installed** templates, choose **C++** > **MFC**. 1. Choose **MFC Application** from the center pane. 1. Click **Next** to start the **MFC Application Wizard**. @@ -102,7 +102,7 @@ The dialog lists the current project settings such as: tabbed multiple document An MFC console application is a command-line program that uses MFC libraries but runs in the console window. 1. From the main menu, choose **File** > **New** > **Project**. -1. Under the **Installed** templates, choose **Visual C++** > **Win32**. +1. Under the **Installed** templates, choose **C++** > **Win32**. 1. Choose **Win32 Console Application** from the center pane. 1. Modify the project name as needed, then press **OK**. 1. On the second page of the wizard, check the **Add common headers for MFC** box and set other values as needed, then press **Finish**. diff --git a/docs/mfc/reference/crecordset-class.md b/docs/mfc/reference/crecordset-class.md index 40295670721..ec14c8d5d1e 100644 --- a/docs/mfc/reference/crecordset-class.md +++ b/docs/mfc/reference/crecordset-class.md @@ -1403,7 +1403,7 @@ Accept the default value, `AFX_DB_USE_DEFAULT_TYPE`, or use one of the following - `CRecordset::forwardOnly` A read-only recordset with only forward scrolling. - For `CRecordset`, the default value is `CRecordset::snapshot`. The default-value mechanism allows the Visual C++ wizards to interact with both ODBC `CRecordset` and DAO `CDaoRecordset`, which have different defaults. + For `CRecordset`, the default value is `CRecordset::snapshot`. The default-value mechanism allows the Visual Studio wizards to interact with both ODBC `CRecordset` and DAO `CDaoRecordset`, which have different defaults. For more information about these recordset types, see [Recordset (ODBC)](../../data/odbc/recordset-odbc.md). For related information, see "Using Block and Scrollable Cursors" in the Windows SDK. diff --git a/docs/mfc/reference/ctoolbar-class.md b/docs/mfc/reference/ctoolbar-class.md index 983d20748bc..33cab610164 100644 --- a/docs/mfc/reference/ctoolbar-class.md +++ b/docs/mfc/reference/ctoolbar-class.md @@ -52,7 +52,7 @@ The buttons can act like pushbuttons, check-box buttons, or radio buttons. `CToo [`CToolBar::GetToolBarCtrl`](#gettoolbarctrl), a member function new to MFC 4.0, allows you to take advantage of the Windows common control's support for toolbar customization and additional functionality. `CToolBar` member functions give you most of the functionality of the Windows common controls; however, when you call `GetToolBarCtrl`, you can give your toolbars even more of the characteristics of Windows 95/98 toolbars. When you call `GetToolBarCtrl`, it will return a reference to a `CToolBarCtrl` object. See [`CToolBarCtrl`](../../mfc/reference/ctoolbarctrl-class.md) for more information about designing toolbars using Windows common controls. For more general information about common controls, see [Common Controls](/windows/win32/Controls/common-controls-intro) in the Windows SDK. -Visual C++ provides you with two methods to create a toolbar. To create a toolbar resource using the Resource Editor, follow these steps: +Visual Studio provides you with two methods to create a toolbar. To create a toolbar resource using the Resource Editor, follow these steps: 1. Create a toolbar resource. diff --git a/docs/mfc/reference/diagnostic-services.md b/docs/mfc/reference/diagnostic-services.md index 18c273ec9e0..235d76280b4 100644 --- a/docs/mfc/reference/diagnostic-services.md +++ b/docs/mfc/reference/diagnostic-services.md @@ -395,7 +395,7 @@ CDumpContext afxDump; `afxDump` is a predefined [CDumpContext](../../mfc/reference/cdumpcontext-class.md) object that allows you to send `CDumpContext` information to the debugger output window or to a debug terminal. Typically, you supply `afxDump` as a parameter to `CObject::Dump`. -Under Windows NT and all versions of Windows, `afxDump` output is sent to the Output-Debug window of Visual C++ when you debug your application. +Under Windows NT and all versions of Windows, `afxDump` output is sent to the Output-Debug window of Visual Studio when you debug your application. This variable is defined only in the Debug version of MFC. For more information on `afxDump`, see [Debugging MFC Applications](/visualstudio/debugger/mfc-debugging-techniques). diff --git a/docs/mfc/reference/mfc-application-wizard.md b/docs/mfc/reference/mfc-application-wizard.md index 81d79ea6b6e..1ca347b8771 100644 --- a/docs/mfc/reference/mfc-application-wizard.md +++ b/docs/mfc/reference/mfc-application-wizard.md @@ -68,7 +68,7 @@ This wizard page describes the current application settings for the MFC applicat To change these default settings, select the appropriate tab title in the left column of the wizard and make the changes on the page that appears. -After you create an MFC application project, you can add objects or controls to your project using Visual C++ [code wizards](../../ide/adding-functionality-with-code-wizards-cpp.md). +After you create an MFC application project, you can add objects or controls to your project using Visual Studio [code wizards](../../ide/adding-functionality-with-code-wizards-cpp.md). ## See also diff --git a/docs/mfc/reference/mfc-dll-wizard.md b/docs/mfc/reference/mfc-dll-wizard.md index 9f7433d1c1c..ad350303e65 100644 --- a/docs/mfc/reference/mfc-dll-wizard.md +++ b/docs/mfc/reference/mfc-dll-wizard.md @@ -16,7 +16,7 @@ This wizard page describes the current [application settings for the MFC DLL pro To change these defaults, click **Application Settings** in the left column of the wizard and make changes in that page of the MFC DLL Wizard. -After you create an MFC DLL project, you can add objects or controls to your project using Visual C++ [code wizards](../../ide/adding-functionality-with-code-wizards-cpp.md). +After you create an MFC DLL project, you can add objects or controls to your project using Visual Studio [code wizards](../../ide/adding-functionality-with-code-wizards-cpp.md). You can perform the following tasks and types of enhancements to a basic MFC DLL project: diff --git a/docs/mfc/relationship-to-the-c-language-api.md b/docs/mfc/relationship-to-the-c-language-api.md index b055335b658..22c012bd971 100644 --- a/docs/mfc/relationship-to-the-c-language-api.md +++ b/docs/mfc/relationship-to-the-c-language-api.md @@ -9,7 +9,7 @@ ms.assetid: 334e8efc-f3cc-4018-bc2e-02908b2a39fe The single characteristic that sets the Microsoft Foundation Class (MFC) Library apart from other class libraries for Windows is the very close mapping to the Windows API written in the C language. Further, you can generally mix calls to the class library freely with direct calls to the Windows API. This direct access does not, however, imply that the classes are a complete replacement for that API. Developers must still occasionally make direct calls to some Windows functions, such as [SetCursor](/windows/win32/api/winuser/nf-winuser-setcursor) and [GetSystemMetrics](/windows/win32/api/winuser/nf-winuser-getsystemmetrics), for example. A Windows function is wrapped by a class member function only when there is a clear advantage to doing so. -Because you sometimes need to make native Windows function calls, you should have access to the C-language Windows API documentation. This documentation is included with Microsoft Visual C++. +Because you sometimes need to make native Windows function calls, you should have access to the C-language Windows API documentation. This documentation is included with Visual Studio. > [!NOTE] > For an overview of how the MFC Library framework operates, see [Using the Classes to Write Applications for Windows](../mfc/using-the-classes-to-write-applications-for-windows.md). diff --git a/docs/mfc/sequence-of-operations-for-building-mfc-applications.md b/docs/mfc/sequence-of-operations-for-building-mfc-applications.md index 3c77d334150..529a989c36c 100644 --- a/docs/mfc/sequence-of-operations-for-building-mfc-applications.md +++ b/docs/mfc/sequence-of-operations-for-building-mfc-applications.md @@ -14,8 +14,8 @@ The following table explains the general sequence you might typically follow as |Task|You do|The framework does| |----------|------------|------------------------| |Create a skeleton application.|Run the [MFC Application Wizard](../mfc/reference/mfc-application-wizard.md). Specify the options you want in the options pages. Options include making the application a COM component, container, or both; adding Automation; and making the application database-aware.|The MFC Application Wizard creates the files for a skeleton application, including source files for your application, document, view, and frame windows; a resource file; a project file; and others, all tailored to your specifications.| -|See what the framework and the MFC Application Wizard offer without adding a line of your own code.|Build the skeleton application and run it in Visual C++.|The running skeleton application derives many standard **File**, **Edit**, **View**, and **Help** menu commands from the framework. For MDI applications, you also get a fully functional Windows menu, and the framework manages creation, arrangement, and destruction of MDI child windows.| -|Construct your application's user interface.|Use the Visual C++ [resource editors](../windows/resource-editors.md) to visually edit the application's user interface:

- Create menus.
- Define accelerators.
- Create dialog boxes.
- Create and edit bitmaps, icons, and cursors.
- Edit the toolbar created for you by the MFC Application Wizard.
- Create and edit other resources.

You can also test the dialog boxes in the dialog editor.|The default resource file created by the MFC Application Wizard supplies many of the resources you need. Visual C++ lets you edit existing resources and add new resources easily and visually.| +|See what the framework and the MFC Application Wizard offer without adding a line of your own code.|Build the skeleton application and run it in Visual Studio.|The running skeleton application derives many standard **File**, **Edit**, **View**, and **Help** menu commands from the framework. For MDI applications, you also get a fully functional Windows menu, and the framework manages creation, arrangement, and destruction of MDI child windows.| +|Construct your application's user interface.|Use the Visual Studio [resource editors](../windows/resource-editors.md) to visually edit the application's user interface:

- Create menus.
- Define accelerators.
- Create dialog boxes.
- Create and edit bitmaps, icons, and cursors.
- Edit the toolbar created for you by the MFC Application Wizard.
- Create and edit other resources.

You can also test the dialog boxes in the dialog editor.|The default resource file created by the MFC Application Wizard supplies many of the resources you need. Visual Studio lets you edit existing resources and add new resources easily and visually.| |Map menus to handler functions.|Use the **Events** button in the [**Properties** window](/visualstudio/ide/reference/properties-window) in **Class View** (or the **Commands** tab in [Class Wizard](reference/mfc-class-wizard.md)) to connect menus and accelerators to handler functions in your code.|These tools insert message-map entries and empty function templates into the source files you specify and manages many manual coding tasks.| |Write your handler code.|Use Class View to jump directly to the code in the source code editor. Fill in the code for your handler functions. For more information on using Class View and about wizards that add code to a project, see [Adding Functionality with Code Wizards](../ide/adding-functionality-with-code-wizards-cpp.md).|Class View opens the editor, scrolls to the empty function template and positions the cursor for you.| |Map toolbar buttons to commands.|Map each button on your toolbar to a menu or accelerator command by assigning the button the appropriate command ID.|The framework controls the drawing, enabling, disabling, checking, and other visual aspects of the toolbar buttons.| @@ -33,7 +33,7 @@ The following table explains the general sequence you might typically follow as |Create database forms.|If you want a form-based data-access application, derive your view class from [CRecordView](../mfc/reference/crecordview-class.md) (for ODBC programming).|The view works like a form view, but its controls are connected to the fields of a [CRecordset](../mfc/reference/crecordset-class.md) object representing a database table. MFC moves data between the controls and the recordset for you.| |Create a simple text editor.|If you want your view to be a simple text editor, derive your view class or classes from [CEditView](../mfc/reference/ceditview-class.md) or [CRichEditView](../mfc/reference/cricheditview-class.md).|The view provides editing functions, Clipboard support, and file input/output. `CRichEditView` provides styled text.| |Add splitter windows.|If you want to support window splitting, add a [CSplitterWnd](../mfc/reference/csplitterwnd-class.md) object to your SDI frame window or MDI child window and hook it up in the window's [OnCreateClient](../mfc/reference/cframewnd-class.md#oncreateclient) member function.|The framework supplies splitter-box controls next to the scroll bars and manages splitting your view into multiple panes. If the user splits a window, the framework creates and attaches additional view objects to the document.| -|Build, test, and debug your application.|Use the facilities of Visual C++ to build, test, and debug your application.|Visual C++ lets you adjust compile, link, and other options. It also lets you browse your source code and class structure.| +|Build, test, and debug your application.|Use the facilities of Visual Studio to build, test, and debug your application.|Visual Studio lets you adjust compile, link, and other options. It also lets you browse your source code and class structure.| ## See also diff --git a/docs/mfc/sequence-of-operations-for-creating-activex-controls.md b/docs/mfc/sequence-of-operations-for-creating-activex-controls.md index 1b1dc9884d5..e534e12453f 100644 --- a/docs/mfc/sequence-of-operations-for-creating-activex-controls.md +++ b/docs/mfc/sequence-of-operations-for-creating-activex-controls.md @@ -16,7 +16,7 @@ The following table shows your role and the framework's role in creating ActiveX |Create an ActiveX control framework.|Run the MFC ActiveX Control Wizard to create your control. Specify the options you want in the options pages. Options include the type and name of the control in the project, licensing, subclassing, and an About Box method.|The MFC ActiveX Control Wizard creates the files for an ActiveX control with basic functionality, including source files for your application, control, and property page or pages; a resource file; a project file; and others, all tailored to your specifications.| |See what the control and the ActiveX Control Wizard offer without adding a line of your own code.|Build the ActiveX control and test it with Internet Explorer or the [TSTCON sample](../overview/visual-cpp-samples.md).|The running control has the ability to be resized and moved. It also has an **About Box** method (if chosen) that can be invoked.| |Implement the control's methods and properties.|Implement your control-specific methods and properties by adding member functions to provide an exposed interface to the control's data. Add member variables to hold data structures and use event handlers to fire events when you determine.|The framework has already defined a map to support the control's events, properties, and methods, leaving you to focus on how the properties and methods are implemented. The default property page is viewable and a default About Box method is supplied.| -|Construct the control's property page or pages.|Use the Visual C++ resource editors to visually edit the control's property page interface:

- Create additional property pages.
- Create and edit bitmaps, icons, and cursors.

You can also test the property page(s) in the dialog editor.|The default resource file created by the MFC Application Wizard supplies many of the resources you need. Visual C++ lets you edit existing resources and add new resources easily and visually.| +|Construct the control's property page or pages.|Use the Visual Studio resource editors to visually edit the control's property page interface:

- Create additional property pages.
- Create and edit bitmaps, icons, and cursors.

You can also test the property page(s) in the dialog editor.|The default resource file created by the MFC Application Wizard supplies many of the resources you need. Visual Studio lets you edit existing resources and add new resources easily and visually.| |Test the control's events, methods, and properties.|Rebuild the control and use Test Container to test that your handlers work correctly.|You can invoke the control's methods and manipulate its properties through the property page interface or through Test Container. In addition, use Test Container to track events fired from the control and notifications received by the control's container.| ## See also diff --git a/docs/mfc/sequence-of-operations-for-creating-database-applications.md b/docs/mfc/sequence-of-operations-for-creating-database-applications.md index 2f39ff70f31..8243421de2d 100644 --- a/docs/mfc/sequence-of-operations-for-creating-database-applications.md +++ b/docs/mfc/sequence-of-operations-for-creating-database-applications.md @@ -10,7 +10,7 @@ ms.assetid: 9371da59-8536-43cd-8314-706ad320e2ec The following table shows your role and the framework's role in writing database applications. > [!NOTE] -> The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use ODBC for new MFC projects. You should only use DAO in maintaining existing applications. +> The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use ODBC for new MFC projects. You should only use DAO in maintaining existing applications. ### Creating Database Applications @@ -18,7 +18,7 @@ The following table shows your role and the framework's role in writing database |----------|------------|------------------------| |Decide whether to use the MFC ODBC or DAO classes.|Use ODBC for new MFC projects. Use DAO only to maintain existing applications. For general information, see the article [Data Access Programming](../data/data-access-programming-mfc-atl.md).|The framework supplies classes that support database access.| |Create your skeleton application with database options.|Run the MFC Application Wizard. Select options on the Database Support page. If you choose an option that creates a record view, also specify:

- Data source and table name or names
- Query name or names.|The MFC Application Wizard creates files and specifies the necessary includes. Depending on the options you specify, the files can include a recordset class.| -|Design your database form or forms.|Use the Visual C++ dialog editor to place controls on the dialog template resources for your record view classes.|The MFC Application Wizard creates an empty dialog template resource for you to fill in.| +|Design your database form or forms.|Use the Visual Studio dialog editor to place controls on the dialog template resources for your record view classes.|The MFC Application Wizard creates an empty dialog template resource for you to fill in.| |Create additional record view and recordset classes as needed.|Use Class View to create the classes and the dialog editor to design the views.|Class View creates additional files for your new classes.| |Create recordset objects as needed in your code. Use each recordset to manipulate records...|Your recordsets are based on the classes derived from [CRecordset](../mfc/reference/crecordset-class.md) with the wizards.|ODBC uses record field exchange (RFX) to exchange data between the database and your recordset's field data members. If you are using a record view, dialog data exchange (DDX) exchanges data between the recordset and the controls on the record view.| |...or create an explicit [CDatabase](../mfc/reference/cdatabase-class.md) in your code for each database you want to open.|Base your recordset objects on the database objects.|The database object provides an interface to the data source.| diff --git a/docs/mfc/servers-implementing-in-place-frame-windows.md b/docs/mfc/servers-implementing-in-place-frame-windows.md index 3349e0c1357..ae276eda3ea 100644 --- a/docs/mfc/servers-implementing-in-place-frame-windows.md +++ b/docs/mfc/servers-implementing-in-place-frame-windows.md @@ -7,7 +7,7 @@ ms.assetid: 09bde4d8-15e2-4fba-8d14-9b954d926b92 --- # Servers: Implementing In-Place Frame Windows -This article explains what you must do to implement in-place frame windows in your visual editing server application if you do not use the application wizard to create your server application. In place of following the procedure outlined in this article, you could use an existing in-place frame-window class from either an application wizard-generated application or a sample provided with Visual C++. +This article explains what you must do to implement in-place frame windows in your visual editing server application if you do not use the application wizard to create your server application. In place of following the procedure outlined in this article, you could use an existing in-place frame-window class from either an application wizard-generated application or a sample provided with Visual Studio. #### To declare an in-place frame-window class diff --git a/docs/mfc/technical-notes-by-category.md b/docs/mfc/technical-notes-by-category.md index 288094ac3af..64544f67312 100644 --- a/docs/mfc/technical-notes-by-category.md +++ b/docs/mfc/technical-notes-by-category.md @@ -79,7 +79,7 @@ Technical notes are divided into the following categories. For a numerical listi [TN023: Standard MFC Resources](../mfc/tn023-standard-mfc-resources.md)\ [TN024: MFC-Defined Messages and Resources](../mfc/tn024-mfc-defined-messages-and-resources.md)\ [TN028: Context-Sensitive Help Support](../mfc/tn028-context-sensitive-help-support.md)\ -[TN035: Using Multiple Resource Files and Header Files with Visual C++](../mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md)\ +[TN035: Using Multiple Resource Files and Header Files with Visual Studio](../mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md)\ [TN036: Using CFormView with AppWizard and ClassWizard](../mfc/tn036-using-cformview-with-appwizard-and-classwizard.md)\ [TN070: MFC Window Class Names](../mfc/tn070-mfc-window-class-names.md) diff --git a/docs/mfc/technical-notes-by-number.md b/docs/mfc/technical-notes-by-number.md index d07d4b3b3bd..52d265d9390 100644 --- a/docs/mfc/technical-notes-by-number.md +++ b/docs/mfc/technical-notes-by-number.md @@ -44,7 +44,7 @@ The technical notes below are listed numerically, with the most recently written |38|[MFC/OLE IUnknown Implementation](../mfc/tn038-mfc-ole-iunknown-implementation.md)| |37|[Multithreaded MFC 2.1 Applications](../mfc/tn037-multithreaded-mfc-2-1-applications.md)| |36|[Using CFormView with AppWizard and ClassWizard](../mfc/tn036-using-cformview-with-appwizard-and-classwizard.md)| -|35|[Using Multiple Resource Files and Header Files with Visual C++](../mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md)| +|35|[Using Multiple Resource Files and Header Files with Visual Studio](../mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md)| |33|[DLL Version of MFC](../mfc/tn033-dll-version-of-mfc.md)| |32|[MFC Exception Mechanism](../mfc/tn032-mfc-exception-mechanism.md)| |31|[Control Bars](../mfc/tn031-control-bars.md)| diff --git a/docs/mfc/testing-properties-and-events-with-test-container.md b/docs/mfc/testing-properties-and-events-with-test-container.md index d7258a77d5c..ead507de3af 100644 --- a/docs/mfc/testing-properties-and-events-with-test-container.md +++ b/docs/mfc/testing-properties-and-events-with-test-container.md @@ -7,7 +7,7 @@ ms.topic: how-to --- # Testing Properties and Events with Test Container -The Test Container application, shipped in Visual C++, is an ActiveX control container for testing and debugging ActiveX controls. Test Container allows the control developer to test the control's functionality by changing its properties, invoking its methods, and firing its events. Test Container can display logs of data-binding notifications and also provides facilities for testing an ActiveX control's persistence functionality: you can save properties to a stream or to substorage, reload them, and examine the stored stream data. This section describes how to use the basic features of Test Container. For additional information, select the **Help** menu while running Test Container. +The Test Container application, shipped in Visual Studio, is an ActiveX control container for testing and debugging ActiveX controls. Test Container allows the control developer to test the control's functionality by changing its properties, invoking its methods, and firing its events. Test Container can display logs of data-binding notifications and also provides facilities for testing an ActiveX control's persistence functionality: you can save properties to a stream or to substorage, reload them, and examine the stored stream data. This section describes how to use the basic features of Test Container. For additional information, select the **Help** menu while running Test Container. ### To access the ActiveX Control Test Container diff --git a/docs/mfc/tn006-message-maps.md b/docs/mfc/tn006-message-maps.md index 91f8aec4a38..4c24ca0197d 100644 --- a/docs/mfc/tn006-message-maps.md +++ b/docs/mfc/tn006-message-maps.md @@ -97,7 +97,7 @@ pWnd->SendMessage(WM_MYMESSAGE); The range of user-defined messages that use this approach must be in the range WM_USER to 0x7fff. > [!NOTE] -> ClassWizard does not support entering ON_MESSAGE handler routines from the ClassWizard user interface. You must manually enter them from the Visual C++ editor. ClassWizard will parse these entries and let you browse them just like any other message-map entries. +> ClassWizard does not support entering ON_MESSAGE handler routines from the ClassWizard user interface. You must manually enter them from the Visual Studio editor. ClassWizard will parse these entries and let you browse them just like any other message-map entries. ## Registered Windows Messages @@ -150,7 +150,7 @@ Advanced users can use the ON_COMMAND_EX macro, which is an extended form of com Examples of these forms: -- Inside Resource.h (usually generated by Visual C++) +- Inside Resource.h (usually generated by Visual Studio) ```cpp #define ID_MYCMD 100 diff --git a/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md b/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md index 6036c016123..d46e12b6e97 100644 --- a/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md +++ b/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md @@ -17,7 +17,7 @@ If both a DLL and an application want to use MFC, both have a choice to either u regular MFC DLLs have several advantages: -- The application that uses the DLL does not have to use MFC and does not have to be a Visual C++ application. +- The application that uses the DLL does not have to use MFC and does not have to be a Visual Studio application. - With regular MFC DLLs that statically link to MFC, the size of the DLL depends only on the MFC and C runtime routines that are used and linked. @@ -63,7 +63,7 @@ The `DllMain` function that MFC provides will call the [CWinApp::ExitInstance](. ## Linking Your DLL -With regular MFC DLLs that statically link to MFC, you must link your DLL with Nafxcwd.lib or Nafxcw.lib and with the version of the C runtimes named Libcmt.lib. These libraries are pre-built and may be installed by specifying them when you run Visual C++ setup. +With regular MFC DLLs that statically link to MFC, you must link your DLL with Nafxcwd.lib or Nafxcw.lib and with the version of the C runtimes named Libcmt.lib. These libraries are pre-built and may be installed by specifying them when you run Visual Studio setup. ## Sample Code diff --git a/docs/mfc/tn020-id-naming-and-numbering-conventions.md b/docs/mfc/tn020-id-naming-and-numbering-conventions.md index 753afb306c8..96b6e6d29b3 100644 --- a/docs/mfc/tn020-id-naming-and-numbering-conventions.md +++ b/docs/mfc/tn020-id-naming-and-numbering-conventions.md @@ -12,13 +12,13 @@ This note describes the ID naming and numbering conventions that MFC 2.0 uses fo The MFC ID naming and numbering conventions are intended to meet the following requirements: -- Provide a consistent ID-naming standard used across the MFC library and MFC applications that are supported by the Visual C++ resource editor. This makes it easier for the programmer to interpret the type and origin of a resource from its ID. +- Provide a consistent ID-naming standard used across the MFC library and MFC applications that are supported by the Visual Studio resource editor. This makes it easier for the programmer to interpret the type and origin of a resource from its ID. - Emphasize the strong 1-to-1 relationship between certain types of IDs. - Conform to already widely used standards for naming IDs in Windows. -- Partition the ID-numbering space. ID numbers can be assigned by the programmer, MFC, Windows, and Visual C++-edited resources. Appropriate partitioning will help avoid duplication of ID numbers. +- Partition the ID-numbering space. ID numbers can be assigned by the programmer, MFC, Windows, and Visual Studio-edited resources. Appropriate partitioning will help avoid duplication of ID numbers. ## The ID Prefix Naming Convention diff --git a/docs/mfc/tn021-command-and-message-routing.md b/docs/mfc/tn021-command-and-message-routing.md index 597613bdc7b..8e2210c3546 100644 --- a/docs/mfc/tn021-command-and-message-routing.md +++ b/docs/mfc/tn021-command-and-message-routing.md @@ -13,7 +13,7 @@ ms.assetid: b5952c8b-123e-406c-a36d-a6ac7c6df307 This note describes the command routing and dispatch architecture as well as advanced topics in general window message routing. -Please refer to Visual C++ for general details on the architectures described here, especially the distinction between Windows messages, control notifications, and commands. This note assumes you are very familiar with the issues described in the printed documentation and only addresses very advanced topics. +Please refer to Visual Studio for general details on the architectures described here, especially the distinction between Windows messages, control notifications, and commands. This note assumes you are very familiar with the issues described in the printed documentation and only addresses very advanced topics. ## Command Routing and Dispatch MFC 1.0 Functionality Evolves to MFC 2.0 Architecture @@ -29,7 +29,7 @@ This functionality has been generalized and extended in MFC 2.0 to allow command ## Command IDs -See Visual C++ for an explanation of the command routing and binding process. [Technical Note 20](../mfc/tn020-id-naming-and-numbering-conventions.md) contains information on ID naming. +See Visual Studio for an explanation of the command routing and binding process. [Technical Note 20](../mfc/tn020-id-naming-and-numbering-conventions.md) contains information on ID naming. We use the generic prefix "ID_" for command IDs. Command IDs are >= 0x8000. The message line or status bar will show the command description string if there is a STRINGTABLE resource with the same IDs as the command ID. @@ -71,7 +71,7 @@ Maintaining the enabled/checked state of all a program's menu items all the time `CFrameWnd` also handles the WM_ENTERIDLE message to describe the current menu item selected on the status bar (also known as the message line). -An application's menu structure, edited by Visual C++, is used to represent the potential commands available at WM_INITMENUPOPUP time. ON_UPDATE_COMMAND_UI handlers can modify the state or text of a menu, or for advanced uses (like the File MRU list or the OLE Verbs pop-up menu), actually modify the menu structure before the menu is drawn. +An application's menu structure, edited by Visual Studio, is used to represent the potential commands available at WM_INITMENUPOPUP time. ON_UPDATE_COMMAND_UI handlers can modify the state or text of a menu, or for advanced uses (like the File MRU list or the OLE Verbs pop-up menu), actually modify the menu structure before the menu is drawn. The same sort of ON_UPDATE_COMMAND_UI processing is done for toolbars (and other control bars) when the application enters its idle loop. See the *Class Library Reference* and [Technical Note 31](../mfc/tn031-control-bars.md) for more information on control bars. diff --git a/docs/mfc/tn022-standard-commands-implementation.md b/docs/mfc/tn022-standard-commands-implementation.md index 87a928b8c48..b58bce0c1b6 100644 --- a/docs/mfc/tn022-standard-commands-implementation.md +++ b/docs/mfc/tn022-standard-commands-implementation.md @@ -13,7 +13,7 @@ ms.assetid: a7883b46-23f7-4870-ac3a-804aed9258b5 This note describes the standard command implementations provided by MFC 2.0. Read [Technical Note 21](../mfc/tn021-command-and-message-routing.md) first because it describes the mechanisms used to implement many of the standard commands. -This description assumes knowledge of the MFC architectures, APIs, and common programming practice. Documented as well as undocumented "implementation only" APIs are described. This is not a place to start learning about the features of or how to program in MFC. Refer to Visual C++ for more general information and for details of documented APIs. +This description assumes knowledge of the MFC architectures, APIs, and common programming practice. Documented as well as undocumented "implementation only" APIs are described. This is not a place to start learning about the features of or how to program in MFC. Refer to Visual Studio for more general information and for details of documented APIs. ## The Problem diff --git a/docs/mfc/tn023-standard-mfc-resources.md b/docs/mfc/tn023-standard-mfc-resources.md index eebace2edac..f0dfaccf661 100644 --- a/docs/mfc/tn023-standard-mfc-resources.md +++ b/docs/mfc/tn023-standard-mfc-resources.md @@ -29,7 +29,7 @@ Clip-art resources are additional resources that the framework does not depend o - Prompts.rc: Contains menu-prompt string resources for each predefined command, such as "Create a new document" for ID_FILE_NEW. -- Commdlg.rc: A Visual C++ compatible .rc file that contains the standard COMMDLG dialog templates. +- Commdlg.rc: A Visual Studio compatible .rc file that contains the standard COMMDLG dialog templates. Standard framework resources are resources with AFX-defined IDs that the framework depends on for internal implementations. You will rarely need to change these AFX-defined resources. If you do, you should follow the procedure outlined later in this topic. @@ -47,7 +47,7 @@ The following framework resources are contained in the MFC\INCLUDE directory: #### To use a clip-art binary resource -1. Open your application's resource file in Visual C++. +1. Open your application's resource file in Visual Studio. 1. Open Common.rc. This file contains all the binary clip-art resources. This may take some time because the Common.rc file is compiled. @@ -76,7 +76,7 @@ In some rare cases you might want to customize the contents of the standard fram ##### To customize the contents of a standard resource file -1. Open the resource file in Visual C++. +1. Open the resource file in Visual Studio. 1. Using the Resource Set Includes command, remove the `#include` for the standard .rc file that you want to customize. For example, to customize the print-preview toolbar, remove the `#include "afxprint.rc"` line. diff --git a/docs/mfc/tn024-mfc-defined-messages-and-resources.md b/docs/mfc/tn024-mfc-defined-messages-and-resources.md index b510b909b79..4c2ed67fd50 100644 --- a/docs/mfc/tn024-mfc-defined-messages-and-resources.md +++ b/docs/mfc/tn024-mfc-defined-messages-and-resources.md @@ -159,9 +159,9 @@ The default toolbar supplied by AppWizard is based on an RT_TOOLBAR custom resou ## RT_DLGINIT Resource Format -One MFC private resource format is used to store extra dialog initialization information. This includes the initial strings stored in a combo box. The format of this resource is not designed to be manually edited, but is handled by Visual C++. +One MFC private resource format is used to store extra dialog initialization information. This includes the initial strings stored in a combo box. The format of this resource is not designed to be manually edited, but is handled by Visual Studio. -Visual C++ and this RT_DLGINIT resource are not required to use the related features of MFC since there are API alternative to using the information in the resource. Using Visual C++ makes it much easier to write, maintain, and translate your application in the long run. +Visual Studio and this RT_DLGINIT resource are not required to use the related features of MFC since there are API alternative to using the information in the resource. Using Visual Studio makes it much easier to write, maintain, and translate your application in the long run. The basic structure of a RT_DLGINIT resource is as follows: @@ -186,7 +186,7 @@ A repeated section contains the control ID to send the message to, the Message # SendDlgItemMessage(, , 0, &); ``` -This is a very general format, allowing any Windows messages and data content. The Visual C++ resource editor and MFC only support a limited subset of Windows messages: CB_ADDSTRING for the initial list-choices for combo boxes (the data is a text string). +This is a very general format, allowing any Windows messages and data content. The Visual Studio resource editor and MFC only support a limited subset of Windows messages: CB_ADDSTRING for the initial list-choices for combo boxes (the data is a text string). ## See also diff --git a/docs/mfc/tn028-context-sensitive-help-support.md b/docs/mfc/tn028-context-sensitive-help-support.md index 09992516214..7b6b5753c5f 100644 --- a/docs/mfc/tn028-context-sensitive-help-support.md +++ b/docs/mfc/tn028-context-sensitive-help-support.md @@ -8,7 +8,7 @@ ms.assetid: 884f1c55-fa27-4d4c-984f-30907d477484 --- # TN028: Context-Sensitive Help Support -This note describes the rules for assigning Help contexts IDs and other help issues in MFC. Context-sensitive help support requires the help compiler that is available in Visual C++. +This note describes the rules for assigning Help contexts IDs and other help issues in MFC. Context-sensitive help support requires the help compiler that is available in Visual Studio. > [!NOTE] > In addition to implementing context-sensitive help using WinHelp, MFC also supports using HTML Help. For more information on this support and programming with HTML Help, see [HTML Help: Context-Sensitive Help for Your Programs](../mfc/html-help-context-sensitive-help-for-your-programs.md). diff --git a/docs/mfc/tn029-splitter-windows.md b/docs/mfc/tn029-splitter-windows.md index 44ff393dd03..5e0142a3312 100644 --- a/docs/mfc/tn029-splitter-windows.md +++ b/docs/mfc/tn029-splitter-windows.md @@ -14,7 +14,7 @@ This note describes the MFC [CSplitterWnd Class](../mfc/reference/csplitterwnd-c A `CSplitterWnd` supports two different styles of splitting windows. -In "static splitters," the splitter window creates the panes when it is created. The order and number of panes never change. Splitter bars are used to resize the different panes. You can use this style to display a different view class in each pane. The Visual C++ graphics editor and the Windows File Manager are examples of programs that use this splitter style. This style of splitter window does not use splitter boxes. +In "static splitters," the splitter window creates the panes when it is created. The order and number of panes never change. Splitter bars are used to resize the different panes. You can use this style to display a different view class in each pane. The Visual Studio graphics editor and the Windows File Manager are examples of programs that use this splitter style. This style of splitter window does not use splitter boxes. In "dynamic splitters," additional panes are created and destroyed as the user splits and un-splits new views. This splitter starts out with a single view and provides splitter boxes for the user to initiate splitting. The splitter window dynamically creates a new view object when the view is split in one direction. This new view object represents the new pane. If the view is split in two directions by using the keyboard interface, the splitter window creates three new view objects for the three new panes. While the split is active, Windows displays the splitter box as a splitter bar between the panes. Windows destroys additional view objects when the user removes a split, but the original view remains until the splitter window itself is destroyed. Microsoft Excel and Microsoft Word are examples of applications that use the dynamic splitter style. diff --git a/docs/mfc/tn033-dll-version-of-mfc.md b/docs/mfc/tn033-dll-version-of-mfc.md index 0e5df9d531b..b4d84359c16 100644 --- a/docs/mfc/tn033-dll-version-of-mfc.md +++ b/docs/mfc/tn033-dll-version-of-mfc.md @@ -416,9 +416,9 @@ A full rebuild is required after these changes are made. ### Building the Samples -Most of the MFC sample programs can be built from Visual C++ or from a shared NMAKE-compatible MAKEFILE from the command line. +Most of the MFC sample programs can be built from Visual Studio or from a shared NMAKE-compatible MAKEFILE from the command line. -To convert any of these samples to use *`MFCxx.DLL`*, you can load the MAK file into the Visual C++ and set the Project options as described above. If you're using the NMAKE build, you can specify `AFXDLL=1` on the NMAKE command line and that will build the sample using the shared MFC libraries. +To convert any of these samples to use *`MFCxx.DLL`*, you can load the MAK file into the Visual Studio and set the Project options as described above. If you're using the NMAKE build, you can specify `AFXDLL=1` on the NMAKE command line and that will build the sample using the shared MFC libraries. The MFC Advanced Concepts sample [DLLHUSK](../overview/visual-cpp-samples.md) is built with the DLL version of MFC. This sample not only illustrates how to build an application linked with *`MFCxx.DLL`*, but it also illustrates other features of the MFC DLL packaging option such as MFC extension DLLs described later in this technical note. @@ -426,7 +426,7 @@ The MFC Advanced Concepts sample [DLLHUSK](../overview/visual-cpp-samples.md) is The release versions of the DLLs (*`MFCxx.DLL`* and *`MFCxxU.DLL`*) are freely redistributable. The debug versions of the DLLs are not freely redistributable and should be used only during the development of your application. -The debug DLLs are provided with debugging information. By using the Visual C++ debugger, you can trace execution of both your application and the DLL. The Release DLLs (*`MFCxx.DLL`* and *`MFCxxU.DLL`*) don't contain debugging information. +The debug DLLs are provided with debugging information. By using the Visual Studio debugger, you can trace execution of both your application and the DLL. The Release DLLs (*`MFCxx.DLL`* and *`MFCxxU.DLL`*) don't contain debugging information. If you customize or rebuild the DLLs, then you should call them something other than "MFCxx". The MFC SRC file *`MFCDLL.MAK`* describes build options and contains the logic for renaming the DLL. Renaming the files is necessary, since these DLLs are potentially shared by many MFC applications. Having your custom version of the MFC DLLs replace the ones installed on the system may break another MFC application using the shared MFC DLLs. diff --git a/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md b/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md index efb943db144..96416abb045 100644 --- a/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md +++ b/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md @@ -1,17 +1,17 @@ --- -description: "Learn more about: TN035: Using multiple resource files and header files with Visual C++" -title: "TN035: Using multiple resource files and header files with Visual C++" +description: "Learn more about: TN035: Using multiple resource files and header files with Visual Studio" +title: "TN035: Using multiple resource files and header files with Visual Studio" ms.date: "11/04/2016" f1_keywords: ["vc.resources"] helpviewer_keywords: ["resource files, multiple", "TN035"] ms.assetid: 1f08ce5e-a912-44cc-ac56-7dd93ad73fb6 --- -# TN035: Using multiple resource files and header files with Visual C++ +# TN035: Using multiple resource files and header files with Visual Studio > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. -This note describes how the Visual C++ resource editor supports multiple resource files and header files shared in a single project or shared across multiple projects and how you can take advantage of that support. This note answers these questions: +This note describes how the Visual Studio resource editor supports multiple resource files and header files shared in a single project or shared across multiple projects and how you can take advantage of that support. This note answers these questions: - When might you want to split a project into multiple resource files and/or header files, and how you do it @@ -25,7 +25,7 @@ You should be aware that if you add an additional resource file to your project, This note is structured to answer the above questions as follows: -- **Overview of how Visual C++ manages resource files and header files** provides an overview of how the Resource Set Includes command in Visual C++ lets you use multiple resource files and header files in the same project. +- **Overview of how Visual Studio manages resource files and header files** provides an overview of how the Resource Set Includes command in Visual Studio lets you use multiple resource files and header files in the same project. - **Analysis of AppWizard-created `.RC` and `.H` Files** looks at the multiple resource and header files that are used by an AppWizard-created application. These files serve as a good model for additional resource files and header files you might want to add to your project. @@ -35,17 +35,17 @@ This note is structured to answer the above questions as follows: - **Using multiple resource files in the same project** describes where you might want to break up your project into multiple `.RC` files, and provides details how to do so. -- **Enforcement of non-editable Visual C++ files** describes how you can make sure Visual C++ doesn't edit and unintentionally reformat a custom resource. +- **Enforcement of non-editable Visual Studio files** describes how you can make sure Visual Studio doesn't edit and unintentionally reformat a custom resource. -- **Managing symbols shared by multiple Visual C++-edited `.RC` files** describes how to share the same symbols across multiple `.RC` files and how to avoid assigning duplicate ID numeric values. +- **Managing symbols shared by multiple Visual Studio-edited `.RC` files** describes how to share the same symbols across multiple `.RC` files and how to avoid assigning duplicate ID numeric values. -- **Managing dependencies between `.RC`, `.CPP`, and `.H` files** describes how Visual C++ avoids unnecessary recompiling `.CPP` files that are dependent on resource symbol files. +- **Managing dependencies between `.RC`, `.CPP`, and `.H` files** describes how Visual Studio avoids unnecessary recompiling `.CPP` files that are dependent on resource symbol files. -- **How Visual C++ manages Set Includes information** provides technical details about how Visual C++ keeps track of multiple (nested) `.RC` files and multiple header files that are included by an `.RC` file. +- **How Visual Studio manages Set Includes information** provides technical details about how Visual Studio keeps track of multiple (nested) `.RC` files and multiple header files that are included by an `.RC` file. -## Overview of how Visual C++ manages resource files and header files +## Overview of how Visual Studio manages resource files and header files -Visual C++ manages a single `.RC` resource file and a corresponding `.H` header file as a tightly coupled pair of files. When you edit and save resources in an `.RC` file, you indirectly edit and save symbols in the corresponding `.H` file. Although you can open and edit multiple `.RC` files at a time (using Visual C++'s MDI user interface), for any given `.RC` file you indirectly edit exactly one corresponding header file. +Visual Studio manages a single `.RC` resource file and a corresponding `.H` header file as a tightly coupled pair of files. When you edit and save resources in an `.RC` file, you indirectly edit and save symbols in the corresponding `.H` file. Although you can open and edit multiple `.RC` files at a time (using Visual Studio's MDI user interface), for any given `.RC` file you indirectly edit exactly one corresponding header file. ### Resource View's Resource Includes dialog @@ -53,26 +53,26 @@ To access the **Resource Includes**, open the **Resource View** then right-click #### Symbol Header File -By default, Visual C++ always names the corresponding header file `RESOURCE.H`, regardless of the name of the resource file (for example, `MYAPP.RC`). The **Symbol Header File:** section in the **Resource Includes** dialog in Visual C++, lets you change the name of this header file. Enter a new file name in the section's edit box. +By default, Visual Studio always names the corresponding header file `RESOURCE.H`, regardless of the name of the resource file (for example, `MYAPP.RC`). The **Symbol Header File:** section in the **Resource Includes** dialog in Visual Studio, lets you change the name of this header file. Enter a new file name in the section's edit box. > [!NOTE] > resource files not located in the same directory as the `.RC` file must prepend a relative path with escaped-'\\' to be read properly. #### Read-Only Symbol Directives -Although Visual C++ only edits one header file for any given `.RC` file, Visual C++ supports references to symbols defined in additional read-only header files. The **Read-Only Symbol Directives:** section in the **Resource Includes** dialog lets you specify any number of additional read-only header files as Read-Only Symbol Directives. The "read-only" restriction means that when you add a new resource in the `.RC` file, you can use a symbol defined in the read-only header file. However, if you delete the resource, the symbol still remains defined in the read-only header file. You can't change the numeric value assigned to a read-only symbol. +Although Visual Studio only edits one header file for any given `.RC` file, Visual Studio supports references to symbols defined in additional read-only header files. The **Read-Only Symbol Directives:** section in the **Resource Includes** dialog lets you specify any number of additional read-only header files as Read-Only Symbol Directives. The "read-only" restriction means that when you add a new resource in the `.RC` file, you can use a symbol defined in the read-only header file. However, if you delete the resource, the symbol still remains defined in the read-only header file. You can't change the numeric value assigned to a read-only symbol. #### Compile-Time Directives -Visual C++ also supports nesting of resource files, where one `.RC` file is included within another by using a `#include` directive. When you edit a given `.RC` file using Visual C++, any resources in the included files aren't visible. But when you compile the `.RC` file, the included files are also compiled. The **Compile-Time Directives:** section in the **Resources Includes** dialog lets you specify any number of `.RC` files to include as Compile-Time Directives. +Visual Studio also supports nesting of resource files, where one `.RC` file is included within another by using a `#include` directive. When you edit a given `.RC` file using Visual Studio, any resources in the included files aren't visible. But when you compile the `.RC` file, the included files are also compiled. The **Compile-Time Directives:** section in the **Resources Includes** dialog lets you specify any number of `.RC` files to include as Compile-Time Directives. -Note what happens if you read into Visual C++ an `.RC` file that includes another `.RC` file that isn't* specified as a Compile-Time Directive. This situation might arise when you bring to Visual C++ an `.RC` file that you had been previously maintaining manually with a text editor. When Visual C++ reads the included `.RC` file, it merges the included resources into the parent `.RC` file. When you save the parent `.RC` file, the `#include` statement, in effect, will be replaced by the included resources. If you don't want this merge to happen, you should remove the `#include` statement from the parent `.RC` file *prior* to reading it into Visual C++; then using Visual C++, add back the same `#include` statement as a Compile-Time Directive. +Note what happens if you read into Visual Studio an `.RC` file that includes another `.RC` file that isn't* specified as a Compile-Time Directive. This situation might arise when you bring to Visual Studio an `.RC` file that you had been previously maintaining manually with a text editor. When Visual Studio reads the included `.RC` file, it merges the included resources into the parent `.RC` file. When you save the parent `.RC` file, the `#include` statement, in effect, will be replaced by the included resources. If you don't want this merge to happen, you should remove the `#include` statement from the parent `.RC` file *prior* to reading it into Visual Studio; then using Visual Studio, add back the same `#include` statement as a Compile-Time Directive. -Visual C++ saves in an `.RC` file the three kinds of above Set Includes information (Symbol Header File, Read-Only Symbol Directives, and Compile-Time Directives) in `#include` directives *and* in `TEXTINCLUDE` resources. The `TEXTINCLUDE` resources, an implementation detail that you don't normally need to deal with, are explained in [How Visual C++ manages set includes information](#_mfcnotes_tn035_set_includes). +Visual Studio saves in an `.RC` file the three kinds of above Set Includes information (Symbol Header File, Read-Only Symbol Directives, and Compile-Time Directives) in `#include` directives *and* in `TEXTINCLUDE` resources. The `TEXTINCLUDE` resources, an implementation detail that you don't normally need to deal with, are explained in [How Visual Studio manages set includes information](#_mfcnotes_tn035_set_includes). ## Analysis of AppWizard-created `.RC` and `.H` files -Examining the application code produced by AppWizard provides insight into how Visual C++ manages multiple resource files and header files. The code excerpts examined below are from a `MYAPP` application produced by AppWizard using the default options. +Examining the application code produced by AppWizard provides insight into how Visual Studio manages multiple resource files and header files. The code excerpts examined below are from a `MYAPP` application produced by AppWizard using the default options. An AppWizard-created application uses multiple resource files and multiple header files, as summarized in the diagram below: @@ -88,12 +88,12 @@ An AppWizard-created application uses multiple resource files and multiple heade AFXPRINT.RC ``` -You can view these multiple file relationships using the Visual C++ File/Set Includes command. +You can view these multiple file relationships using the Visual Studio File/Set Includes command. `MYAPP.RC`\ -The application resource file that you edit using Visual C++. +The application resource file that you edit using Visual Studio. -`RESOURCE.H` is the application-specific header file. It's always named `RESOURCE.H` by AppWizard, consistent with Visual C++'s default naming of the header file. The `#include` for this header file is the first statement in the resource file (`MYAPP.RC`): +`RESOURCE.H` is the application-specific header file. It's always named `RESOURCE.H` by AppWizard, consistent with Visual Studio's default naming of the header file. The `#include` for this header file is the first statement in the resource file (`MYAPP.RC`): ```rc //Microsoft Visual C++ generated resource script @@ -102,13 +102,13 @@ The application resource file that you edit using Visual C++. ``` `RES\MYAPP.RC2`\ -Contains resources that won't be edited by Visual C++ but will be included in the final compiled `.EXE` file. AppWizard creates no such resources by default, since Visual C++ can edit all of the standard resources, including the version resource (a new feature in this release). An empty file is generated by AppWizard in case you wish to add your own custom formatted resources to this file. +Contains resources that won't be edited by Visual Studio but will be included in the final compiled `.EXE` file. AppWizard creates no such resources by default, since Visual Studio can edit all of the standard resources, including the version resource (a new feature in this release). An empty file is generated by AppWizard in case you wish to add your own custom formatted resources to this file. -If you use custom formatted resources, you can add them to `RES\MYAPP.RC2` and edit them using the Visual C++ text editor. +If you use custom formatted resources, you can add them to `RES\MYAPP.RC2` and edit them using the Visual Studio text editor. -`AFXRES.RC` and `AFXPRINT.RC` contain standard resources required by certain features of the framework. Like `RES\MYAPP.RC2`, these two framework-provided resource files are included at the end of `MYAPP.RC`, and they're specified in the Compile-Time Directives of the Set Includes dialog box. Thus, you don't directly view or edit these framework resources while you edit `MYAPP.RC` in Visual C++, but they're compiled into the application's binary `.RES` file and final `.EXE` file. For more information on the standard framework resources, including procedures for modifying them, see [Technical Note 23](../mfc/tn023-standard-mfc-resources.md). +`AFXRES.RC` and `AFXPRINT.RC` contain standard resources required by certain features of the framework. Like `RES\MYAPP.RC2`, these two framework-provided resource files are included at the end of `MYAPP.RC`, and they're specified in the Compile-Time Directives of the Set Includes dialog box. Thus, you don't directly view or edit these framework resources while you edit `MYAPP.RC` in Visual Studio, but they're compiled into the application's binary `.RES` file and final `.EXE` file. For more information on the standard framework resources, including procedures for modifying them, see [Technical Note 23](../mfc/tn023-standard-mfc-resources.md). -`AFXRES.H` defines standard symbols, such as `ID_FILE_NEW`, used by the framework and specifically used in `AFXRES.RC`. `AFXRES.H` also uses `#include` to include `WINRES.H`, which contains a subset of `WINDOWS.H` that's needed by Visual C++ generated `.RC` files and `AFXRES.RC`. The symbols defined in `AFXRES.H` are available as you edit the application resource file (`MYAPP.RC`). For example, `ID_FILE_NEW` is used for the `File` `New` menu item in the `MYAPP.RC` file's menu resource. You can't change or delete these framework-defined symbols. +`AFXRES.H` defines standard symbols, such as `ID_FILE_NEW`, used by the framework and specifically used in `AFXRES.RC`. `AFXRES.H` also uses `#include` to include `WINRES.H`, which contains a subset of `WINDOWS.H` that's needed by Visual Studio generated `.RC` files and `AFXRES.RC`. The symbols defined in `AFXRES.H` are available as you edit the application resource file (`MYAPP.RC`). For example, `ID_FILE_NEW` is used for the `File` `New` menu item in the `MYAPP.RC` file's menu resource. You can't change or delete these framework-defined symbols. ## Including additional header files @@ -116,7 +116,7 @@ The AppWizard-created application includes only two header files: `RESOURCE.H` a The header file is provided by an external source, or you want to share the header file among multiple projects or multiple parts of the same project. -The header file has formatting and comments that you don't want Visual C++ to change or filter out when it saves the file. For example, maybe you want to preserve #define's that use symbolic arithmetic such as: +The header file has formatting and comments that you don't want Visual Studio to change or filter out when it saves the file. For example, maybe you want to preserve #define's that use symbolic arithmetic such as: ```h #define RED 0 @@ -170,22 +170,22 @@ The case where the second header file is shared by two `.RC` files in the same a ## Using multiple resource files in the same project -Visual C++ and the Resource Compiler support multiple `.RC` files in the same project through `#include` directives that include one `.RC` file within another. Multiple nesting is allowed. There are various reasons to split your project's resources into multiple `.RC` files: +Visual Studio and the Resource Compiler support multiple `.RC` files in the same project through `#include` directives that include one `.RC` file within another. Multiple nesting is allowed. There are various reasons to split your project's resources into multiple `.RC` files: - It's easier to manage a large number of resources among multiple project team members if you split the resources into multiple `.RC` files. If you use a source control management package for checking out files and checking in changes, splitting the resources into multiple `.RC` files will give you finer control over managing changes to resources. - If you want to use preprocessor directives, such as `#ifdef`, `#endif`, and `#define`, for portions of your resources, you must isolate them in read-only resources that will be compiled by the Resource Compiler. -- Component `.RC` files will load and save faster in Visual C++ than one composite `.RC` file. +- Component `.RC` files will load and save faster in Visual Studio than one composite `.RC` file. -- If you want to maintain a resource with a text editor in a human-readable form, you should keep it in a `.RC` file separate from the one Visual C++ edits. +- If you want to maintain a resource with a text editor in a human-readable form, you should keep it in a `.RC` file separate from the one Visual Studio edits. -- If you need to keep a user-defined resource in a binary or text form that is interpretable by another specialized data editor, then you should keep it in a separate `.RC` file so Visual C++ doesn't change the format to hexadecimal data. The `.WAV` (sound) file resources in the MFC Advanced Concepts sample [SPEAKN](../overview/visual-cpp-samples.md) are a good example. +- If you need to keep a user-defined resource in a binary or text form that is interpretable by another specialized data editor, then you should keep it in a separate `.RC` file so Visual Studio doesn't change the format to hexadecimal data. The `.WAV` (sound) file resources in the MFC Advanced Concepts sample [SPEAKN](../overview/visual-cpp-samples.md) are a good example. You can include `SECOND.RC` in the Compile-Time Directives in the Set Includes dialog box: ```h -#include "res\myapp.rc2" // non-Visual C++ edited resources +#include "res\myapp.rc2" // non-Visual Studio edited resources #include "second.rc" // THE SECOND .RC FILE #include "afxres.rc" // Standard components @@ -207,27 +207,27 @@ The result is illustrated in the following diagram: AFXPRINT.RC ``` -Using Compile-Time Directives, you can organize your Visual C++-editable and non-editable resources into multiple `.RC` files, where the main `MYAPP.RC` does nothing but `#include` the other `.RC` files. If you're using a Visual Studio C++ project `.MAK` file, then you should include the main `.RC` file in the project so that all the included resources are compiled with your application. +Using Compile-Time Directives, you can organize your Visual Studio-editable and non-editable resources into multiple `.RC` files, where the main `MYAPP.RC` does nothing but `#include` the other `.RC` files. If you're using a Visual Studio C++ project `.MAK` file, then you should include the main `.RC` file in the project so that all the included resources are compiled with your application. -## Enforcement of non-editable Visual C++ files +## Enforcement of non-editable Visual Studio files -The AppWizard-created `RES\MYAPP.RC2` file is an example of a file that contains resources that you don't want to accidentally read into Visual C++ and then write back out with loss of formatting information. To protect against this problem, place the following lines in the beginning of the `RES\MYAPP.RC2` file: +The AppWizard-created `RES\MYAPP.RC2` file is an example of a file that contains resources that you don't want to accidentally read into Visual Studio and then write back out with loss of formatting information. To protect against this problem, place the following lines in the beginning of the `RES\MYAPP.RC2` file: ```rc2 #ifdef APSTUDIO_INVOKED - #error this file is not editable by Visual C++ + #error this file is not editable by Visual Studio #endif //APSTUDIO_INVOKED ``` -When Visual C++ compiles the `.RC` file, it defines both `APSTUDIO_INVOKED` and `RC_INVOKED`. If the AppWizard-created file structure is corrupted and Visual C++ reads the #error line above, it reports a fatal error and aborts the reading of the `.RC` file. +When Visual Studio compiles the `.RC` file, it defines both `APSTUDIO_INVOKED` and `RC_INVOKED`. If the AppWizard-created file structure is corrupted and Visual Studio reads the #error line above, it reports a fatal error and aborts the reading of the `.RC` file. -## Managing symbols shared by multiple Visual C++-edited `.RC` files +## Managing symbols shared by multiple Visual Studio-edited `.RC` files -Two issues arise when you split up your resources into multiple `.RC` files that you want to edit separately in Visual C++: +Two issues arise when you split up your resources into multiple `.RC` files that you want to edit separately in Visual Studio: - You might want to share the same symbols across multiple `.RC` files. -- You need to help Visual C++ avoid assigning the same ID numeric values to distinct resources (symbols). +- You need to help Visual Studio avoid assigning the same ID numeric values to distinct resources (symbols). The following diagram illustrates an organization of `.RC` and `.H` files that deals with the first issue: @@ -243,11 +243,11 @@ MYSTRS.H / MYSHARED.H \ MYMENUS.H In this example, string resources are kept in one resource file, `MYSTRS.RC`, and menus are kept in another, `MYMENUS.RC`. Some symbols, such as for commands, may need to be shared between the two files. For example, a `ID_TOOLS_SPELL` may be the menu command ID for the Spell item in a Tools menu; and it may also be the string ID of the command prompt displayed by the framework in the application's main window status bar. -The `ID_TOOLS_SPELL` symbol is kept in the shared header file, `MYSHARED.H`. You maintain this shared header file manually with a text editor; Visual C++ doesn't directly edit it. In the two resource files `MYSTRS.RC` and `MYMENUS.RC`, you specify `#include "MYSHARED.H"` in the Read-Only Directives for `MYAPP.RC`, using the **Resource Includes** command, as described earlier. +The `ID_TOOLS_SPELL` symbol is kept in the shared header file, `MYSHARED.H`. You maintain this shared header file manually with a text editor; Visual Studio doesn't directly edit it. In the two resource files `MYSTRS.RC` and `MYMENUS.RC`, you specify `#include "MYSHARED.H"` in the Read-Only Directives for `MYAPP.RC`, using the **Resource Includes** command, as described earlier. It's most convenient to anticipate a symbol you'll share before you attempt to use it to identify any resource. Add the symbol to the shared header file and, if you haven't already included the shared header file in the Read-Only Directives for the `.RC` file, do so before using the symbol. If you didn't anticipate sharing the symbol in this way, then you'll have to manually (using a text editor) move the #define statement for the symbol from, say, `MYMENUS.H` to `MYSHARED.H` before using it in `MYSTRS.RC`. -When you manage symbols in multiple `.RC` files, you also must help Visual C++ avoid assigning the same ID numeric values to distinct resources (symbols). For any given `.RC` file, Visual C++ incrementally assigns IDs in each of four ID domains. Between editing sessions, Visual C++ keeps track of the last ID it assigned in each of the domains in the Symbol Header File for the `.RC` file. Here's what the `APS_NEXT` values are for an empty (new) `.RC` file: +When you manage symbols in multiple `.RC` files, you also must help Visual Studio avoid assigning the same ID numeric values to distinct resources (symbols). For any given `.RC` file, Visual Studio incrementally assigns IDs in each of four ID domains. Between editing sessions, Visual Studio keeps track of the last ID it assigned in each of the domains in the Symbol Header File for the `.RC` file. Here's what the `APS_NEXT` values are for an empty (new) `.RC` file: ```rc #define _APS_NEXT_RESOURCE_VALUE 101 @@ -264,9 +264,9 @@ When you manage symbols in multiple `.RC` files, you also must help Visual C++ a `_APS_NEXT_SYMED_VALUE` is the next symbol value that will be issued when you manually assign a symbol value using the New command in the Symbol Browser. -Visual C++ starts with slightly higher values that the lowest legal value when creating a new `.RC` file. AppWizard will also initialize these values to something more appropriate for MFC applications. For more information about ID value ranges, see [Technical Note 20](../mfc/tn020-id-naming-and-numbering-conventions.md). +Visual Studio starts with slightly higher values that the lowest legal value when creating a new `.RC` file. AppWizard will also initialize these values to something more appropriate for MFC applications. For more information about ID value ranges, see [Technical Note 20](../mfc/tn020-id-naming-and-numbering-conventions.md). -Now every time you create a new resource file, even in the same project, Visual C++ defines the same `_APS_NEXT_` values. It means that if you add, say, multiple dialogs in two different `.RC` files, it's highly likely that the same #define value will be assigned to different dialogs. For example, `IDD_MY_DLG1` in the first `.RC` file might be assigned the same number, 101, as `IDD_MY_DLG2` in a second `.RC` file. +Now every time you create a new resource file, even in the same project, Visual Studio defines the same `_APS_NEXT_` values. It means that if you add, say, multiple dialogs in two different `.RC` files, it's highly likely that the same #define value will be assigned to different dialogs. For example, `IDD_MY_DLG1` in the first `.RC` file might be assigned the same number, 101, as `IDD_MY_DLG2` in a second `.RC` file. To avoid this issue, you should reserve a separate numeric range for each of the four domains of IDs in the respective `.RC` files. Set the ranges by manually updating the `_APS_NEXT` values in each of the `.RC` files **before** you start adding resources. For example, if the first `.RC` file uses the default `_APS_NEXT` values, then you might want to assign the following `_APS_NEXT` values to the second `.RC` file: @@ -277,13 +277,13 @@ To avoid this issue, you should reserve a separate numeric range for each of the #define _APS_NEXT_SYMED_VALUE 2000 ``` -Of course, it's still possible that Visual C++ will assign so many IDs in the first `.RC` file that the numeric values start to overlap the ones reserved for the second `.RC` file. You should reserve sufficiently large ranges so that this collision doesn't happen. +Of course, it's still possible that Visual Studio will assign so many IDs in the first `.RC` file that the numeric values start to overlap the ones reserved for the second `.RC` file. You should reserve sufficiently large ranges so that this collision doesn't happen. ## Managing dependencies between `.RC`, `.CPP`, and `.H` files -When Visual C++ saves an `.RC` file, it also saves symbol changes to the corresponding `RESOURCE.H` file. Any of your `.CPP` files that refer to resources in the `.RC` file must use `#include` to include the `RESOURCE.H` file, usually from within your project's main header file. This inclusion leads to an undesirable side-effect because of the development environment's internal project management, which scans source files for header dependencies. Every time you add a new symbol in Visual C++, all the `.CPP` files that have `#include "RESOURCE.H"` directives would need to be recompiled. +When Visual Studio saves an `.RC` file, it also saves symbol changes to the corresponding `RESOURCE.H` file. Any of your `.CPP` files that refer to resources in the `.RC` file must use `#include` to include the `RESOURCE.H` file, usually from within your project's main header file. This inclusion leads to an undesirable side-effect because of the development environment's internal project management, which scans source files for header dependencies. Every time you add a new symbol in Visual Studio, all the `.CPP` files that have `#include "RESOURCE.H"` directives would need to be recompiled. -Visual C++, circumvents the dependency on `RESOURCE.H` by including the following comment as the first line of the `RESOURCE.H` file: +Visual Studio, circumvents the dependency on `RESOURCE.H` by including the following comment as the first line of the `RESOURCE.H` file: ```h //{{NO_DEPENDENCIES}} @@ -291,9 +291,9 @@ Visual C++, circumvents the dependency on `RESOURCE.H` by including the followin The development environment interprets this comment by ignoring the changes to `RESOURCE.H` so that dependent `.CPP` files won't need to be recompiled. -Visual C++ always adds the `//{{NO_DEPENDENCIES}}` comment line to a `.RC` file when it saves the file. In some cases, circumventing of the build dependency on `RESOURCE.H` may lead to run-time errors undetected at link time. For example, if you use the Symbol Browser to change the numeric value assigned to a symbol for a resource, the resource won't be correctly found and loaded at application run-time if the `.CPP` file referring to the resource isn't recompiled. In such cases, you should explicitly recompile any `.CPP` files that you know are affected by the symbol changes in `RESOURCE.H` or select **Rebuild All**. If you have the need to frequently change symbol values for a certain group of resources, you'll probably find it more convenient and safer to break out these symbols into a separate read-only header file, as described in the above section [Including Additional Header Files](#_mfcnotes_tn035_including). +Visual Studio always adds the `//{{NO_DEPENDENCIES}}` comment line to a `.RC` file when it saves the file. In some cases, circumventing of the build dependency on `RESOURCE.H` may lead to run-time errors undetected at link time. For example, if you use the Symbol Browser to change the numeric value assigned to a symbol for a resource, the resource won't be correctly found and loaded at application run-time if the `.CPP` file referring to the resource isn't recompiled. In such cases, you should explicitly recompile any `.CPP` files that you know are affected by the symbol changes in `RESOURCE.H` or select **Rebuild All**. If you have the need to frequently change symbol values for a certain group of resources, you'll probably find it more convenient and safer to break out these symbols into a separate read-only header file, as described in the above section [Including Additional Header Files](#_mfcnotes_tn035_including). -## How Visual C++ manages Set Includes information +## How Visual Studio manages Set Includes information As discussed above, the File menu Set Includes command lets you specify three types of information: @@ -303,11 +303,11 @@ As discussed above, the File menu Set Includes command lets you specify three ty - Compile-Time Directives -The following table describes how Visual C++ maintains this information in a `.RC` file. You don't need this information to use Visual C++, but it may enhance your understanding so that you can more confidently use the Set Includes feature. +The following table describes how Visual Studio maintains this information in a `.RC` file. You don't need this information to use Visual Studio, but it may enhance your understanding so that you can more confidently use the Set Includes feature. -Each of the above three types of Set Includes information is stored in the `.RC` file in two forms: (1) as `#include` or other directives interpretable by the Resource Compiler, and (2) as special `TEXTINCLUDE` resources interpretable only by Visual C++. +Each of the above three types of Set Includes information is stored in the `.RC` file in two forms: (1) as `#include` or other directives interpretable by the Resource Compiler, and (2) as special `TEXTINCLUDE` resources interpretable only by Visual Studio. -The purpose of the `TEXTINCLUDE` resource is to safely store Set Include information in a form that is readily presentable in Visual C++'s **Set Includes** dialog box. `TEXTINCLUDE` is a *resource type* defined by Visual C++. Visual C++ recognizes three specific `TEXTINCLUDE` resources that have the resource identification numbers 1, 2 and 3: +The purpose of the `TEXTINCLUDE` resource is to safely store Set Include information in a form that is readily presentable in Visual Studio's **Set Includes** dialog box. `TEXTINCLUDE` is a *resource type* defined by Visual Studio. Visual Studio recognizes three specific `TEXTINCLUDE` resources that have the resource identification numbers 1, 2 and 3: |`TEXTINCLUDE` resource ID|Type of Set Includes information| |-----------------------------|--------------------------------------| @@ -362,21 +362,21 @@ Compile-Time Directives are included at the end of `MYAPP.RC` in the following f // // From TEXTINCLUDE 3 // -#include "res\myapp.rc2" // non-Visual C++ edited resources +#include "res\myapp.rc2" // non-Visual Studio edited resources #include "afxres.rc" // Standard components #include "afxprint.rc" // printing/print preview resources #endif // not APSTUDIO_INVOKED ``` -The `#ifndef APSTUDIO_INVOKED` directive instructs Visual C++ to skip over Compile-Time Directives. +The `#ifndef APSTUDIO_INVOKED` directive instructs Visual Studio to skip over Compile-Time Directives. The corresponding `TEXTINCLUDE` resource is: ```rc 3 TEXTINCLUDE DISCARDABLE BEGIN -"#include ""res\myapp.rc2"" // non-Visual C++ edited resources\r\n" +"#include ""res\myapp.rc2"" // non-Visual Studio edited resources\r\n" "\r\n" "#include ""afxres.rc"" // Standard components\r\n" "#include ""afxprint.rc"" // printing/print preview resources\r\n" diff --git a/docs/mfc/tn039-mfc-ole-automation-implementation.md b/docs/mfc/tn039-mfc-ole-automation-implementation.md index f0293d78dae..9cc0196268e 100644 --- a/docs/mfc/tn039-mfc-ole-automation-implementation.md +++ b/docs/mfc/tn039-mfc-ole-automation-implementation.md @@ -85,7 +85,7 @@ The Z property is given a **DISPID** with a zero **HIWORD** since it is defined ## Advanced MFC Dispatch Map Features -There are a number of additional features that ClassWizard does not support with this release of Visual C++. ClassWizard supports `DISP_FUNCTION`, `DISP_PROPERTY`, and `DISP_PROPERTY_EX` which define a method, member variable property, and get/set member function property, respectively. These capabilities are usually all that is needed to create most automation servers. +There are a number of additional features that ClassWizard does not support with this release of Visual Studio. ClassWizard supports `DISP_FUNCTION`, `DISP_PROPERTY`, and `DISP_PROPERTY_EX` which define a method, member variable property, and get/set member function property, respectively. These capabilities are usually all that is needed to create most automation servers. The following additional macros can be used when the ClassWizard supported macros are not adequate: `DISP_PROPERTY_NOTIFY`, and `DISP_PROPERTY_PARAM`. diff --git a/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md b/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md index 9838cef62ca..5dbdc995f5f 100644 --- a/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md +++ b/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md @@ -276,7 +276,7 @@ At this point, OCLIENT is a functional OLE container application. It is possible One of the most interesting features of OLE is in-place activation (or "Visual Editing"). This feature allows the server application to take over portions of the container's user interface to provided a more seamless editing interface for the user. To implement in-place activation to OCLIENT, some special resources need to be added, as well as some additional code. These resources and the code are normally provided by AppWizard — in fact, much of the code here was borrowed directly from a fresh AppWizard application with "Container" support. -First of all, it is necessary to add a menu resource to be used when there is an item which is in-place active. You can create this extra menu resource in Visual C++ by copying the IDR_OCLITYPE resource and removing all but the File and Window pop-ups. Two separator bars are inserted between the File and Window pop-ups to indicate the separation of groups (it should look like: `File || Window`). For more information on what these separators mean and how the server and container menus are merged see [Menus and Resources: Menu Merging](../mfc/menus-and-resources-menu-merging.md). +First of all, it is necessary to add a menu resource to be used when there is an item which is in-place active. You can create this extra menu resource in Visual Studio by copying the IDR_OCLITYPE resource and removing all but the File and Window pop-ups. Two separator bars are inserted between the File and Window pop-ups to indicate the separation of groups (it should look like: `File || Window`). For more information on what these separators mean and how the server and container menus are merged see [Menus and Resources: Menu Merging](../mfc/menus-and-resources-menu-merging.md). Once you have these menus created, you need to let the framework know about them. This is done by calling `CDocTemplate::SetContainerInfo` for the document template before you add it to the document template list in your InitInstance. The new code to register the document template looks like this: @@ -292,7 +292,7 @@ pTemplate->SetContainerInfo(IDR_OLECLITYPE_INPLACE); AddDocTemplate(pTemplate); ``` -The IDR_OLECLITYPE_INPLACE resource is the special in-place resource created in Visual C++. +The IDR_OLECLITYPE_INPLACE resource is the special in-place resource created in Visual Studio. To enable in-place activation, there are some things that need to change in both the `CView` (CMainView) derived class as well as the `COleClientItem` derived class (CRectItem). All of these overrides are provided by AppWizard and most of the implementation will come directly from a default AppWizard application. @@ -338,7 +338,7 @@ BOOL CRectItem::OnChangeItemPosition(const CRect& rectPos) At this point, there is enough code to allow an item to be in-place activated and to deal with sizing and moving the item when it is active, but no code will allow the user to exit the editing session. Although some servers will provide this functionality themselves by handling the escape key, it is suggested that containers provide two ways to deactivate an item: (1) by clicking outside the item, and (2) by pressing the ESCAPE key. -For the ESCAPE key, add an accelerator with Visual C++ that maps the VK_ESCAPE key to a command, ID_CANCEL_EDIT is added to the resources. The handler for this command follows: +For the ESCAPE key, add an accelerator with Visual Studio that maps the VK_ESCAPE key to a command, ID_CANCEL_EDIT is added to the resources. The handler for this command follows: ```cpp // The following command handler provides the standard @@ -512,7 +512,7 @@ BOOL COLEServerApp::InitInstance() You will notice that the code above refers to a new resource ID, IDR_HIERSVRTYPE_SRVR_EMB. This is the menu resource to be used when a document that is embedded in another container is edited. In MFC/OLE1 the menu items specific to editing an embedded item were modified on the fly. Using an entirely different menu structure when editing an embedded item instead of editing a file-based document makes it much easier to provide different user interfaces for these two separate modes. As you'll see later, an entirely separate menu resource is used when editing an embedded object in-place. -To create this resource, load the resource script into Visual C++ and copy the existing IDR_HIERSVRTYPE menu resource. Rename the new resource to IDR_HIERSVRTYPE_SRVR_EMB (this is the same naming convention that AppWizard uses). Next change "File Save" to "File Update"; give it command ID ID_FILE_UPDATE. Also change "File Save As" to "File Save Copy As"; give it command ID ID_FILE_SAVE_COPY_AS. The framework provides the implementation of both of these commands. +To create this resource, load the resource script into Visual Studio and copy the existing IDR_HIERSVRTYPE menu resource. Rename the new resource to IDR_HIERSVRTYPE_SRVR_EMB (this is the same naming convention that AppWizard uses). Next change "File Save" to "File Update"; give it command ID ID_FILE_UPDATE. Also change "File Save As" to "File Save Copy As"; give it command ID ID_FILE_SAVE_COPY_AS. The framework provides the implementation of both of these commands. ```Output \hiersvr\svritem.h(60) : error C2433: 'OLESTATUS' : 'virtual' not permitted on data declarations @@ -629,9 +629,9 @@ To add "Visual Editing" (or in-place activation) to this server application, the - You need to tell the framework about these special resources and classes. -The menu resource is easy to create. Run Visual C++, copy the menu resource IDR_HIERSVRTYPE to a menu resource called IDR_HIERSVRTYPE_SRVR_IP. Modify the menu so that only the Edit and Help menu popups are left. Add two separators to the menu in between the Edit and Help menus (it should look like: `Edit || Help`). For more information on what these separators mean and how the server and container menus are merged, see [Menus and Resources: Menu Merging](../mfc/menus-and-resources-menu-merging.md). +The menu resource is easy to create. Run Visual Studio, copy the menu resource IDR_HIERSVRTYPE to a menu resource called IDR_HIERSVRTYPE_SRVR_IP. Modify the menu so that only the Edit and Help menu popups are left. Add two separators to the menu in between the Edit and Help menus (it should look like: `Edit || Help`). For more information on what these separators mean and how the server and container menus are merged, see [Menus and Resources: Menu Merging](../mfc/menus-and-resources-menu-merging.md). -The bitmap for the subset toolbar can be easily created by copying the one from a fresh AppWizard generated application with a "Server" option checked. This bitmap can then be imported into Visual C++. Be sure to give the bitmap an ID of IDR_HIERSVRTYPE_SRVR_IP. +The bitmap for the subset toolbar can be easily created by copying the one from a fresh AppWizard generated application with a "Server" option checked. This bitmap can then be imported into Visual Studio. Be sure to give the bitmap an ID of IDR_HIERSVRTYPE_SRVR_IP. The class derived from `COleIPFrameWnd` can be copied from an AppWizard generated application with server support as well. Copy both files, IPFRAME.CPP and IPFRAME.H and add them to the project. Make sure that the `LoadBitmap` call refers to IDR_HIERSVRTYPE_SRVR_IP, the bitmap created in the previous step. diff --git a/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md b/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md index 5902135a9a4..0a40b8e8745 100644 --- a/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md +++ b/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md @@ -8,7 +8,7 @@ ms.assetid: fdcf3c51-4fa8-4517-9222-58aaa4f25cac # TN053: Custom DFX Routines for DAO Database Classes > [!NOTE] -> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. +> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. This technical note describes the DAO record field exchange (DFX) mechanism. To help understand what is happening in the DFX routines, the `DFX_Text` function will be explained in detail as an example. As an additional source of information to this technical note, you can examine the code for the other the individual DFX functions. You probably will not need a custom DFX routine as often as you might need a custom RFX routine (used with ODBC database classes). diff --git a/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md b/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md index c17812d54ab..3b44465a053 100644 --- a/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md +++ b/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md @@ -9,7 +9,7 @@ ms.custom: sfi-ropc-nochange # TN054: Calling DAO Directly While Using MFC DAO Classes > [!NOTE] -> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. +> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. When using the MFC DAO database classes, there may be situations where it is necessary to use DAO directly. Usually, this will not be the case, but MFC has provided some helper mechanisms to facilitate making direct DAO calls simple when combining the use of the MFC classes with direct DAO calls. Making direct DAO calls to the methods of an MFC-managed DAO object should require only a few lines of code. If you need to create and use DAO objects that are *not* managed by MFC, you will have to do a little more work by actually calling `Release` on the object. This technical note explains when you might want to call DAO directly, what the MFC helpers can do to help you, and how to use the DAO OLE interfaces. Finally, this note provides some sample functions showing how to call DAO directly for DAO security features. diff --git a/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md b/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md index 4f563326304..20f25fc6f90 100644 --- a/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md +++ b/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md @@ -8,7 +8,7 @@ ms.assetid: 0f858bd1-e168-4e2e-bcd1-8debd82856e4 # TN055: Migrating MFC ODBC Database Class Applications to MFC DAO Classes > [!NOTE] -> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. +> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. ## Overview diff --git a/docs/mfc/tn057-localization-of-mfc-components.md b/docs/mfc/tn057-localization-of-mfc-components.md index bb920458129..b011cb4de35 100644 --- a/docs/mfc/tn057-localization-of-mfc-components.md +++ b/docs/mfc/tn057-localization-of-mfc-components.md @@ -43,13 +43,13 @@ From then on, MFC will load resources from that DLL instead of from myapp.exe. A It is relatively easy to create a resource only DLL. You create a DLL project, add your .RC file to it, and add the necessary resources. If you have an existing project that does not use this technique, you can copy the resources from that project. After adding the resource file to the project, you are almost ready to build the project. The only thing you must do is set the linker options to include **/NOENTRY**. This tells the linker that the DLL has no entry point - since it has no code, it has no entry point. > [!NOTE] -> The resource editor in Visual C++ 4.0 and later supports multiple languages per .RC file. This can make it very easy to manage your localization in a single project. The resources for each language are controlled by preprocessor directives generated by the resource editor. +> The resource editor in Visual Studio 4.0 and later supports multiple languages per .RC file. This can make it very easy to manage your localization in a single project. The resources for each language are controlled by preprocessor directives generated by the resource editor. ## Using the Provided MFC Localized Resources Any MFC application that you build reuses two things from MFC: code and resources. That is, MFC has various error messages, built-in dialogs, and other resources that are used by the MFC classes. In order to completely localize your application, you need to localize not only your application's resources, but also the resources that come directly from MFC. MFC provides a number of different language resource files automatically, so that if the language you are targeting is one of the languages MFC already supports, you just need to make sure you use those localized resources. -As of this writing, MFC supports Chinese, German, Spanish, French, Italian, Japanese, and Korean. The files which contain these localized versions are in the MFC\INCLUDE\L.* (the 'L' stands for localized) directories. The German files are in MFC\INCLUDE\L.DEU, for example. To cause your application to use these RC files instead of the files located in MFC\INCLUDE, add a `/IC:\PROGRAM FILES\MICROSOFT VISUAL STUDIO .NET 2003\VC7\MFC\INCLUDE\L.DEU` to your RC command line (this is just an example; you would need to substitute your locale of choice as well as the directory into which you installed Visual C++). +As of this writing, MFC supports Chinese, German, Spanish, French, Italian, Japanese, and Korean. The files which contain these localized versions are in the MFC\INCLUDE\L.* (the 'L' stands for localized) directories. The German files are in MFC\INCLUDE\L.DEU, for example. To cause your application to use these RC files instead of the files located in MFC\INCLUDE, add a `/IC:\PROGRAM FILES\MICROSOFT VISUAL STUDIO .NET 2003\VC7\MFC\INCLUDE\L.DEU` to your RC command line (this is just an example; you would need to substitute your locale of choice as well as the directory into which you installed Microsoft C++). The above instructions will work if your application links statically with MFC. Most applications link dynamically (because that is the AppWizard default). In this scenario, not only the code is dynamically linked - so are the resources. As a result, you can localize your resources in your application, but the MFC implementation resources will still be loaded from the MFC7x.DLL (or a later version) or from MFC7xLOC.DLL if it exists. You can approach this from two different angles. diff --git a/docs/mfc/tn062-message-reflection-for-windows-controls.md b/docs/mfc/tn062-message-reflection-for-windows-controls.md index 9f4d1c7ffe5..ce9be5675ff 100644 --- a/docs/mfc/tn062-message-reflection-for-windows-controls.md +++ b/docs/mfc/tn062-message-reflection-for-windows-controls.md @@ -90,7 +90,7 @@ This simple example creates a reusable control called `CYellowEdit`. The control You must have an application in which to develop the reusable control. If you don't have an existing application to use, create a dialog-based application using AppWizard. -2. With your project loaded into Visual C++, use ClassWizard to create a new class called `CYellowEdit` based on `CEdit`. +2. With your project loaded into Visual Studio, use ClassWizard to create a new class called `CYellowEdit` based on `CEdit`. 3. Add three member variables to your `CYellowEdit` class. The first two will be *COLORREF* variables to hold the text color and the background color. The third will be a `CBrush` object that will hold the brush for painting the background. The `CBrush` object allows you to create the brush once, merely referencing it after that, and to destroy the brush automatically when the `CYellowEdit` control is destroyed. diff --git a/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md b/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md index 295169fce62..d7b44243e73 100644 --- a/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md +++ b/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md @@ -31,7 +31,7 @@ Although OLE Automation allows you to implement an `IDispatch` interface, a VTBL A dual interface is really just a custom interface derived from `IDispatch`. The most straightforward way to implement dual-interface support in a `CCmdTarget`-based class is to first implement the normal dispatch interface on your class using MFC and ClassWizard, then add the custom interface later. For the most part, your custom interface implementation will simply delegate back to the MFC `IDispatch` implementation. -First, modify the ODL file for your server to define dual interfaces for your objects. To define a dual interface, you must use an interface statement, instead of the `DISPINTERFACE` statement that the Visual C++ wizards generate. Rather than removing the existing `DISPINTERFACE` statement, add a new interface statement. By retaining the `DISPINTERFACE` form, you can continue to use ClassWizard to add properties and methods to your object, but you must add the equivalent properties and methods to your interface statement. +First, modify the ODL file for your server to define dual interfaces for your objects. To define a dual interface, you must use an interface statement, instead of the `DISPINTERFACE` statement that the Visual Studio wizards generate. Rather than removing the existing `DISPINTERFACE` statement, add a new interface statement. By retaining the `DISPINTERFACE` form, you can continue to use ClassWizard to add properties and methods to your object, but you must add the equivalent properties and methods to your interface statement. An interface statement for a dual interface must have the *OLEAUTOMATION* and *DUAL* attributes, and the interface must be derived from `IDispatch`. You can use the [GUIDGEN](../overview/visual-cpp-samples.md) sample to create a **IID** for the dual interface: @@ -275,7 +275,7 @@ To add the **UUID** definitions from the MkTypLib-generated header file to your ## Specifying the Correct Object Class Name in the Type Library -The wizards shipped with Visual C++ incorrectly use the implementation class name to specify the coclass in the server's ODL file for OLE-creatable classes. While this will work, the implementation class name is probably not the class name you want users of your object to use. To specify the correct name, open the ODL file, locate each coclass statement, and replace the implementation class name with the correct external name. +The wizards shipped with Visual Studio incorrectly use the implementation class name to specify the coclass in the server's ODL file for OLE-creatable classes. While this will work, the implementation class name is probably not the class name you want users of your object to use. To specify the correct name, open the ODL file, locate each coclass statement, and replace the implementation class name with the correct external name. Note that when the coclass statement is changed, the variable names of **CLSID**s in the MkTypLib-generated header file will change accordingly. You will need to update your code to use the new variable names. diff --git a/docs/mfc/toc.yml b/docs/mfc/toc.yml index 691f07b181b..fcc45274295 100644 --- a/docs/mfc/toc.yml +++ b/docs/mfc/toc.yml @@ -1493,7 +1493,7 @@ items: href: tn032-mfc-exception-mechanism.md - name: "TN033: DLL version of MFC" href: tn033-dll-version-of-mfc.md - - name: "TN035: Using multiple resource files and header files with Visual C++" + - name: "TN035: Using multiple resource files and header files with Visual Studio" href: tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md - name: "TN036: Using CFormView with AppWizard and ClassWizard" href: tn036-using-cformview-with-appwizard-and-classwizard.md diff --git a/docs/mfc/toolbar-fundamentals.md b/docs/mfc/toolbar-fundamentals.md index 283156c66ef..e6f6328e2f2 100644 --- a/docs/mfc/toolbar-fundamentals.md +++ b/docs/mfc/toolbar-fundamentals.md @@ -47,7 +47,7 @@ The docking, floating, and tool tips calls are optional. You can remove those li ## Editing the Toolbar Resource -The default toolbar you get with the Application Wizard is based on an **RT_TOOLBAR** custom resource, introduced in MFC version 4.0. You can edit this resource with the [toolbar editor](../windows/toolbar-editor.md). The editor lets you easily add, delete, and rearrange buttons. It contains a graphical editor for the buttons that is very similar to the general graphics editor in Visual C++. If you edited toolbars in previous versions of Visual C++, you'll find the task much easier now. +The default toolbar you get with the Application Wizard is based on an **RT_TOOLBAR** custom resource, introduced in MFC version 4.0. You can edit this resource with the [toolbar editor](../windows/toolbar-editor.md). The editor lets you easily add, delete, and rearrange buttons. It contains a graphical editor for the buttons that is very similar to the general graphics editor in Visual Studio. If you edited toolbars in previous versions of Visual Studio, you'll find the task much easier now. To connect a toolbar button to a command, you give the button a command ID, such as `ID_MYCOMMAND`. Specify the command ID in the button's property page in the toolbar editor. Then create a handler function for the command (see [Mapping Messages to Functions](../mfc/reference/mapping-messages-to-functions.md) for more information). diff --git a/docs/mfc/upgrading-an-existing-activex-control.md b/docs/mfc/upgrading-an-existing-activex-control.md index 47524f29315..a6038e41168 100644 --- a/docs/mfc/upgrading-an-existing-activex-control.md +++ b/docs/mfc/upgrading-an-existing-activex-control.md @@ -48,7 +48,7 @@ CODEBASE="http://example.contoso.com/mycontrol.ocx#version=4, 1086" ``` -This solution downloads only the control's .ocx file, and requires any supporting DLLs to already be installed on the client machine. This will work for Internet Explorer and MFC ActiveX controls built with Visual C++, because Internet Explorer ships with the supporting DLLs for Visual C++ controls. If another Internet browser that is ActiveX control-capable is used to view this control, this solution will not work. +This solution downloads only the control's .ocx file, and requires any supporting DLLs to already be installed on the client machine. This will work for Internet Explorer and MFC ActiveX controls built with Visual Studio, because Internet Explorer ships with the supporting DLLs for Visual Studio controls. If another Internet browser that is ActiveX control-capable is used to view this control, this solution will not work. ### Using the CODEBASE Tag with an INF File @@ -158,7 +158,7 @@ HKEY_CLASSES_ROOT\CLSID\{06889605-B8D0-101A-91F1-00608CEAD5B3}\Implemented Categ If you want to use a licensed control on a Web page, you must verify that the license agreement allows its use on the Internet and create a license package file (LPK) for it. -A licensed ActiveX control will not load properly in an HTML page if the computer running Internet Explorer is not licensed to use the control. For example, if a licensed control was built using Visual C++, the HTML page using the control will load properly on the computer where the control was built, but it will not load on a different computer unless licensing information is included. +A licensed ActiveX control will not load properly in an HTML page if the computer running Internet Explorer is not licensed to use the control. For example, if a licensed control was built using Visual Studio, the HTML page using the control will load properly on the computer where the control was built, but it will not load on a different computer unless licensing information is included. To use a licensed ActiveX control in Internet Explorer, you must check the vendor's license agreement to verify that the license for the control permits: diff --git a/docs/mfc/using-the-classes-to-write-applications-for-windows.md b/docs/mfc/using-the-classes-to-write-applications-for-windows.md index bba61db9ffc..26a4f9ebf3c 100644 --- a/docs/mfc/using-the-classes-to-write-applications-for-windows.md +++ b/docs/mfc/using-the-classes-to-write-applications-for-windows.md @@ -8,7 +8,7 @@ ms.topic: concept-article --- # Using the Classes to Write Applications for Windows -Taken together, the classes in the Microsoft Foundation Class (MFC) Library make up an "application framework," on which you build an application for the Windows operating system. At a very general level, the framework defines the skeleton of an application and supplies standard user-interface implementations that can be placed onto the skeleton. Your job as programmer is to fill in the rest of the skeleton, which are those things that are specific to your application. You can get a head start by using the MFC Application Wizard to create the files for a very thorough starter application. You use the Microsoft Visual C++ resource editors to design your user-interface elements visually, Class View commands to connect those elements to code, and the class library to implement your application-specific logic. +Taken together, the classes in the Microsoft Foundation Class (MFC) Library make up an "application framework," on which you build an application for the Windows operating system. At a very general level, the framework defines the skeleton of an application and supplies standard user-interface implementations that can be placed onto the skeleton. Your job as programmer is to fill in the rest of the skeleton, which are those things that are specific to your application. You can get a head start by using the MFC Application Wizard to create the files for a very thorough starter application. You use the Visual Studio resource editors to design your user-interface elements visually, Class View commands to connect those elements to code, and the class library to implement your application-specific logic. Version 3.0 and later of the MFC framework supports programming for Win32 platforms, including Microsoft Windows 95 and later, and Windows NT versions 3.51 and later. MFC Win32 support includes multithreading. Use version 1.5*x* if you need to do 16-bit programming. diff --git a/docs/mfc/using-your-old-toolbars.md b/docs/mfc/using-your-old-toolbars.md index d1fe0d061b2..36e8fd1616e 100644 --- a/docs/mfc/using-your-old-toolbars.md +++ b/docs/mfc/using-your-old-toolbars.md @@ -9,7 +9,7 @@ ms.topic: concept-article --- # Using Your Old Toolbars -If you have used previous versions of Visual C++ to create customized toolbars, the new implementation of class [CToolBar](../mfc/reference/ctoolbar-class.md) could cause you problems. So that you don't have to give up your old toolbars to use the new functionality, the old implementation is still supported. +If you have used previous versions of Visual Studio to create customized toolbars, the new implementation of class [CToolBar](../mfc/reference/ctoolbar-class.md) could cause you problems. So that you don't have to give up your old toolbars to use the new functionality, the old implementation is still supported. The DOCKTOOL sample does not use the old-style toolbars, only the new-style toolbars. diff --git a/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md b/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md index a1bcbd4b77d..2f3c6645ec7 100644 --- a/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md +++ b/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md @@ -7,7 +7,7 @@ ms.assetid: dda36c33-c231-4da6-a62f-72d69a12b6dd --- # Walkthrough: Adding a D2D Object to an MFC Project -This walkthrough teaches how to add a basic Direct2D (D2D) object to a Visual C++, Microsoft Foundation Class Library (MFC) project, and then build the project into an application that prints "Hello, World!" on a gradient background. +This walkthrough teaches how to add a basic Direct2D (D2D) object to a Visual Studio, Microsoft Foundation Class Library (MFC) project, and then build the project into an application that prints "Hello, World!" on a gradient background. The walkthrough shows how to accomplish these tasks: @@ -25,7 +25,7 @@ The walkthrough shows how to accomplish these tasks: ## Prerequisites -To complete this walkthrough, you must have Visual Studio installed with the **Desktop development with C++** workload and the optional **Visual C++ MFC for x86 and x64** component. +To complete this walkthrough, you must have Visual Studio installed with the **Desktop development with C++** workload and the optional **C++ MFC for x64/x86** component. ## To create an MFC application diff --git a/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md b/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md index 2ab962abddd..203b4313782 100644 --- a/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md +++ b/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md @@ -7,7 +7,7 @@ ms.assetid: 004f832c-9fd5-4f88-9ca9-ae65dececdc2 --- # Walkthrough: Adding Animation to an MFC Project -This walkthrough teaches how to add a basic animated object to a Visual C++, Microsoft Foundation Class Library (MFC) project. +This walkthrough teaches how to add a basic animated object to a Visual Studio, Microsoft Foundation Class Library (MFC) project. The walkthrough shows how to accomplish these tasks: diff --git a/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md b/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md index 19b88357d9d..0d04318ced9 100644 --- a/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md +++ b/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md @@ -11,7 +11,7 @@ ms.assetid: 602df5c2-17d4-4cd9-8cf6-dff652c4cae5 ## Prerequisites -[Visual C++ Samples](../overview/visual-cpp-samples.md) +[Visual Studio C++ Samples](../overview/visual-cpp-samples.md) ## Sections diff --git a/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md b/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md index 35d503d1884..5aa336afc5a 100644 --- a/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md +++ b/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md @@ -53,7 +53,7 @@ These steps vary depending on which version of Visual Studio you are using. To s 1. Use the **MFC Application Wizard** to create a new MFC application. To run the wizard, from the **File** menu select **New**, and then select **Project**. The **New Project** dialog box will be displayed. -1. In the **New Project** dialog box, expand the **Visual C++** node in the **Project types** pane and select **MFC**. Then, in the **Templates** pane, select **MFC Application**. Type a name for the project, such as `MFCShellControls` and click **OK**. +1. In the **New Project** dialog box, expand the **Visual Studio** node in the **Project types** pane and select **MFC**. Then, in the **Templates** pane, select **MFC Application**. Type a name for the project, such as `MFCShellControls` and click **OK**. After **MFC Application Wizard** displays, use the following options: @@ -200,7 +200,7 @@ The wizard automatically creates an application that has a standard menu bar, a - The wizard created an Outlook bar with both a **Folders** pane and a **Calendar** pane. It probably doesn't make sense to have a **Calendar** pane in an **Explorer** window, so remove that pane now. -- The `CMFCShellListCtrl` supports viewing files in different modes, such as **Large Icons**, **Small Icons**, **List**, and **Details**. Update your application to implement this functionality. Hint: see [Visual C++ Samples](../overview/visual-cpp-samples.md). +- The `CMFCShellListCtrl` supports viewing files in different modes, such as **Large Icons**, **Small Icons**, **List**, and **Details**. Update your application to implement this functionality. Hint: see [Visual Studio C++ Samples](../overview/visual-cpp-samples.md). ## See also diff --git a/docs/mfc/windows-sockets-in-mfc.md b/docs/mfc/windows-sockets-in-mfc.md index c75929505b3..ade1e931319 100644 --- a/docs/mfc/windows-sockets-in-mfc.md +++ b/docs/mfc/windows-sockets-in-mfc.md @@ -30,7 +30,7 @@ Creating and using `CSocket` and `CAsyncSocket` objects is described in [Windows ## Windows Sockets DLLs -The Microsoft Windows operating systems supply the Windows Sockets dynamic-link libraries (DLL). Visual C++ supplies the appropriate header files and libraries and the Windows Sockets specification. +The Microsoft Windows operating systems supply the Windows Sockets dynamic-link libraries (DLL). Visual Studio supplies the appropriate header files and libraries and the Windows Sockets specification. For more information about Windows Sockets, see: diff --git a/docs/mfc/windows-sockets-using-class-casyncsocket.md b/docs/mfc/windows-sockets-using-class-casyncsocket.md index 992332b73a9..4b93d33ecb9 100644 --- a/docs/mfc/windows-sockets-using-class-casyncsocket.md +++ b/docs/mfc/windows-sockets-using-class-casyncsocket.md @@ -8,7 +8,7 @@ helpviewer_keywords: ["CAsyncSocket class [MFC], programming model", "Windows So This article explains how to use class [`CAsyncSocket`](reference/casyncsocket-class.md). This class encapsulates the Windows Sockets API at a very low level. `CAsyncSocket` is for use by programmers who know network communications in detail but want the convenience of callbacks for notification of network events. Based on this assumption, this article provides only basic instruction. You should probably consider using `CAsyncSocket` if you want Windows Sockets' ease of dealing with multiple network protocols in an MFC application but don't want to sacrifice flexibility. You might also feel that you can get better efficiency by programming the communications more directly yourself than you could using the more general alternative model of class `CSocket`. -`CAsyncSocket` is documented in the *MFC Reference*. Visual C++ also supplies the Windows Sockets specification, located in the Windows SDK. The details are left to you. Visual C++ doesn't supply a sample application for `CAsyncSocket`. +`CAsyncSocket` is documented in the *MFC Reference*. Visual Studio also supplies the Windows Sockets specification, located in the Windows SDK. The details are left to you. Visual Studio doesn't supply a sample application for `CAsyncSocket`. If you aren't highly knowledgeable about network communications and want a simple solution, use class [`CSocket`](reference/csocket-class.md) with a `CArchive` object. See [Windows Sockets: Using Sockets with Archives](windows-sockets-using-sockets-with-archives.md) for more information. diff --git a/docs/mfc/wizards-and-the-resource-editors.md b/docs/mfc/wizards-and-the-resource-editors.md index daf62848239..5646150d063 100644 --- a/docs/mfc/wizards-and-the-resource-editors.md +++ b/docs/mfc/wizards-and-the-resource-editors.md @@ -7,11 +7,11 @@ ms.assetid: f5dd4d13-9dc1-4a49-b6bf-5b3cb45fa8ba --- # Wizards and the Resource Editors -Visual C++ includes several wizards for use in MFC programming, along with many integrated resource editors. For ActiveX controls programming, the [ActiveX Control Wizard](../mfc/reference/mfc-activex-control-wizard.md) serves a purpose much like that of the MFC Application Wizard. While you can write MFC applications without most of these tools, the tools greatly simplify and speed your work. +Visual Studio includes several wizards for use in MFC programming, along with many integrated resource editors. For ActiveX controls programming, the [ActiveX Control Wizard](../mfc/reference/mfc-activex-control-wizard.md) serves a purpose much like that of the MFC Application Wizard. While you can write MFC applications without most of these tools, the tools greatly simplify and speed your work. ## Use the MFC Application Wizard to Create an MFC Application -Use the [MFC Application Wizard](../mfc/reference/mfc-application-wizard.md) to create an MFC project in Visual C++, which can include OLE and database support. Files in the project contain your application, document, view, and frame-window classes; standard resources, including menus and an optional toolbar; other required Windows files; and optional .rtf files containing standard Windows Help topics that you can revise and augment to create your program's help file. +Use the [MFC Application Wizard](../mfc/reference/mfc-application-wizard.md) to create an MFC project in Visual Studio, which can include OLE and database support. Files in the project contain your application, document, view, and frame-window classes; standard resources, including menus and an optional toolbar; other required Windows files; and optional .rtf files containing standard Windows Help topics that you can revise and augment to create your program's help file. ## Use Class View to Manage Classes and Windows Messages @@ -30,11 +30,11 @@ The [Class Wizard](reference/mfc-class-wizard.md) will create empty message-hand ## Use the Resource Editors to Create and Edit Resources -Use the Visual C++ [resource editors](../windows/resource-editors.md) to create and edit menus, dialog boxes, custom controls, accelerator keys, bitmaps, icons, cursors, strings, and version resources. As of Visual C++ version 4.0, a toolbar editor makes creating toolbars much easier. +Use the Visual Studio [resource editors](../windows/resource-editors.md) to create and edit menus, dialog boxes, custom controls, accelerator keys, bitmaps, icons, cursors, strings, and version resources. As of Visual Studio version 4.0, a toolbar editor makes creating toolbars much easier. To help you even more, the Microsoft Foundation Class Library provides a file called COMMON.RES, which contains "clip art" resources that you can copy from COMMON.RES and paste into your own resource file. COMMON.RES includes toolbar buttons, common cursors, icons, and more. You can use, modify, and redistribute these resources in your application. For more information about COMMON.RES, see the [Clipart sample](../overview/visual-cpp-samples.md). -The MFC Application Wizard, the Visual C++ wizards, resource editors, and the MFC framework do a lot of work for you and make managing your code much easier. The bulk of your application-specific code is in your document and view classes. +The MFC Application Wizard, the Visual Studio wizards, resource editors, and the MFC framework do a lot of work for you and make managing your code much easier. The bulk of your application-specific code is in your document and view classes. ## See also From 4c8b80ffadb9c0e3471748a3c97313eeada256f8 Mon Sep 17 00:00:00 2001 From: ChanPark Date: Fri, 30 Jan 2026 10:44:17 -0800 Subject: [PATCH 1596/1799] New moniker ranges --- docs/build/customize-cmake-settings.md | 46 +++++++++++++++++++++++++- 1 file changed, 45 insertions(+), 1 deletion(-) diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index d49e435c42b..5c8cd24cf4a 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -17,7 +17,7 @@ For Visual Studio 2019 to 2022, select your version by using the version selecto ::: moniker-end -::: moniker range="<=msvc-170" +::: moniker range=">=msvc-160 <=msvc-170" Visual Studio uses a CMake configuration file to drive CMake generation and build. *`CMakePresets.json`* is supported by Visual Studio 2019 version 16.10 or later and is the recommended CMake configuration file. *`CMakePresets.json`* is supported directly by CMake and can be used to drive CMake generation and build from Visual Studio, from VS Code, in a Continuous Integration pipeline, and from the command line on Windows, Linux, and Mac. For more information on *`CMakePresets.json`*, see [Configure and build with CMake Presets](cmake-presets-vs.md). @@ -171,6 +171,50 @@ For more information about each of the properties in the file, see [CMakeSetting ::: moniker-end +::: moniker range="<=msvc-150" + +Visual Studio 2017 provides several CMake configurations that define how CMake is invoked to create the CMake cache for a given project. To add a new configuration, select the configuration drop-down in the toolbar and choose **Manage Configurations**: + + ![Screenshot of Manage configurations selected in the drop-down.](media/cmake-manage-configurations.png) + +You can choose from the list of predefined configurations: + + ![Add Configuration to CMake Settings dialog list of predefined configurations.](media/cmake-configurations.png) + +The first time you select a configuration, Visual Studio creates a *`CMakeSettings.json`* file in your project's root folder. This file is used to re-create the CMake cache file, for example after a **Clean** operation. + +To add another configuration, right-click *`CMakeSettings.json`* and choose **Add Configuration**. + + ![Screenshot of the shortcut menu with Add configuration selected.](media/cmake-add-configuration.png "CMake Add Configuration") + +You can also edit the file using the **CMake Settings Editor**. Right-click on *`CMakeSettings.json`* in **Solution Explorer** and choose **Edit CMake Settings**. Or, select **Manage Configurations** from the configuration drop-down at the top of the editor window. + +You can also directly edit *`CMakeSettings.json`* to create custom configurations. The following example shows a sample configuration, which you can use as a starting point: + +```json + { + "name": "x86-Debug", + "generator": "Ninja", + "configurationType": "Debug", + "inheritEnvironments": [ "msvc_x86" ], + "buildRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\build\\${name}", + "installRoot": "${env.USERPROFILE}\\CMakeBuilds\\${workspaceHash}\\install\\${name}", + "cmakeCommandArgs": "", + "buildCommandArgs": "-v", + "ctestCommandArgs": "" + }, +``` + +JSON IntelliSense helps you edit the *`CMakeSettings.json`* file: + + :::image type="complex" source="media/cmake-json-intellisense.png" alt-text="Screenshot of the CMake JSON IntelliSense pop-up in the editor."::: + The JSON IntelliSense pop-up for "configurations" shows buildCommandArgs, buildRoot, cmakeCommandArgs, configurationType, among several others. + :::image-end::: + +For more information about each of the properties in the file, see [`CMakeSettings.json` schema reference](cmakesettings-reference.md). + +::: moniker-end + ## Related content - [CMake Projects in Visual Studio](cmake-projects-in-visual-studio.md) From b881da5964874a940c20071c3473015caf590770 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 30 Jan 2026 17:07:25 -0800 Subject: [PATCH 1597/1799] edits --- .../mfc/changing-the-styles-of-a-window-created-by-mfc.md | 2 +- docs/mfc/containers-for-activex-controls.md | 2 +- .../creating-an-active-document-container-application.md | 2 +- docs/mfc/docking-and-floating-toolbars.md | 2 +- docs/mfc/form-views-mfc.md | 2 +- docs/mfc/framework-mfc.md | 2 +- ...es-it-easier-to-create-internet-client-applications.md | 2 +- docs/mfc/methods-of-creating-a-status-bar.md | 2 +- docs/mfc/methods-of-creating-a-toolbar.md | 2 +- docs/mfc/mfc-and-atl.md | 2 +- docs/mfc/mfc-library-versions.md | 2 +- docs/mfc/mfc-mbcs-dll-add-on.md | 2 +- .../reference/adding-an-mfc-class-from-a-type-library.md | 2 +- docs/mfc/reference/adding-an-mfc-odbc-consumer.md | 2 +- docs/mfc/reference/creating-an-mfc-application.md | 8 ++++---- docs/mfc/technical-notes-by-category.md | 2 +- docs/mfc/technical-notes-by-number.md | 2 +- .../testing-properties-and-events-with-test-container.md | 2 +- docs/mfc/tn057-localization-of-mfc-components.md | 4 ++-- ...hrough-updating-the-mfc-scribble-application-part-2.md | 2 +- docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md | 4 ++-- 21 files changed, 26 insertions(+), 26 deletions(-) diff --git a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md index fdab577e449..eb6d87a53c4 100644 --- a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md +++ b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md @@ -12,7 +12,7 @@ In its version of the `WinMain` function, MFC registers several standard window ## Changing Styles in a New MFC Application -If you're using Microsoft C++ 2.0 or later, you can change the default window styles in the Application Wizard when you create your application. In the Application Wizard's User Interface Features page, you can change styles for your main frame window and MDI child windows. For either window type, you can specify its frame thickness (thick or thin) and any of the following: +If you're using Visual C++ 2.0 or later, you can change the default window styles in the Application Wizard when you create your application. In the Application Wizard's User Interface Features page, you can change styles for your main frame window and MDI child windows. For either window type, you can specify its frame thickness (thick or thin) and any of the following: - Whether the window has Minimize or Maximize controls. diff --git a/docs/mfc/containers-for-activex-controls.md b/docs/mfc/containers-for-activex-controls.md index 8f11ee29d83..8b5adeba287 100644 --- a/docs/mfc/containers-for-activex-controls.md +++ b/docs/mfc/containers-for-activex-controls.md @@ -21,7 +21,7 @@ Applications that support ActiveX control containment include: - Visual Basic 4.x and greater -- Microsoft C++ 4.x and greater +- Visual C++ 4.x and greater - Access 95 and greater diff --git a/docs/mfc/creating-an-active-document-container-application.md b/docs/mfc/creating-an-active-document-container-application.md index 077cea8136c..c1ef6e9ac2d 100644 --- a/docs/mfc/creating-an-active-document-container-application.md +++ b/docs/mfc/creating-an-active-document-container-application.md @@ -14,7 +14,7 @@ The simplest and most recommended way to create an active document container app 1. From the **File** menu, click **Project**from the **New** submenu. -1. From the left pane, click **MicrosoftVisual Studio** project type. +1. From the left pane, click **Visual C++** project type. 1. Select **MFC Application** from the right pane. diff --git a/docs/mfc/docking-and-floating-toolbars.md b/docs/mfc/docking-and-floating-toolbars.md index e68d5dd87f7..2dc9f54a2a7 100644 --- a/docs/mfc/docking-and-floating-toolbars.md +++ b/docs/mfc/docking-and-floating-toolbars.md @@ -57,7 +57,7 @@ The MFC implementation of dockable toolbars does not provide some of the extende ## Dynamically Resizing the Toolbar -As of Visual Studio version 4.0, you can make it possible for users of your application to resize floating toolbars dynamically. Typically, a toolbar has a long, linear shape, displayed horizontally. But you can change the toolbar's orientation and its shape. For example, when the user docks a toolbar against one of the vertical sides of the frame window, the shape changes to a vertical layout. It's also possible to reshape the toolbar into a rectangle with multiple rows of buttons. +As of Visual C++ version 4.0, you can make it possible for users of your application to resize floating toolbars dynamically. Typically, a toolbar has a long, linear shape, displayed horizontally. But you can change the toolbar's orientation and its shape. For example, when the user docks a toolbar against one of the vertical sides of the frame window, the shape changes to a vertical layout. It's also possible to reshape the toolbar into a rectangle with multiple rows of buttons. You can: diff --git a/docs/mfc/form-views-mfc.md b/docs/mfc/form-views-mfc.md index 87517953bb5..61a5a4bd8d9 100644 --- a/docs/mfc/form-views-mfc.md +++ b/docs/mfc/form-views-mfc.md @@ -7,7 +7,7 @@ ms.assetid: efbe73c1-4ca4-4613-aac2-30d916e92c0e --- # Form Views (MFC) -You can add forms to any Visual Studio application that supports the MFC libraries, including a [forms-based application](reference/creating-a-forms-based-mfc-application.md) (one whose view class is derived from `CFormView`). If you did not initially create your application to support forms, Visual Studio will add this support for you when you insert a new form. In an SDI or MDI application, which implements the default [document/view architecture](document-view-architecture.md), when the user chooses the **New** command (by default, on the **File** menu), Visual Studio prompts the user to choose from the available forms. +You can add forms to any Visual C++ application that supports the MFC libraries, including a [forms-based application](reference/creating-a-forms-based-mfc-application.md) (one whose view class is derived from `CFormView`). If you did not initially create your application to support forms, Visual Studio will add this support for you when you insert a new form. In an SDI or MDI application, which implements the default [document/view architecture](document-view-architecture.md), when the user chooses the **New** command (by default, on the **File** menu), Visual Studio prompts the user to choose from the available forms. With an SDI application, when the user chooses the **New** command, the current instance of the form continues to run but a new instance of the application with the selected form is created if one is not found. In an MDI application, the current instance of the form continues to run when the user chooses the **New** command. diff --git a/docs/mfc/framework-mfc.md b/docs/mfc/framework-mfc.md index 7c8996f07c3..0bd459a85d7 100644 --- a/docs/mfc/framework-mfc.md +++ b/docs/mfc/framework-mfc.md @@ -7,7 +7,7 @@ ms.assetid: 3be0fec8-9843-4119-ae42-ece993ef500b --- # Framework (MFC) -Your work with the Microsoft Foundation Class (MFC) Library framework is based largely on a few major classes and several Visual Studio tools. Some classes encapsulate a large portion of the Win32 application programming interface (API). Other classes encapsulate application concepts such as documents, views, and the application itself. Still others encapsulate OLE features and ODBC and DAO data-access functionality. (DAO is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete.) +Your work with the Microsoft Foundation Class (MFC) Library framework is based largely on a few major classes and several Visual C++ tools. Some classes encapsulate a large portion of the Win32 application programming interface (API). Other classes encapsulate application concepts such as documents, views, and the application itself. Still others encapsulate OLE features and ODBC and DAO data-access functionality. (DAO is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete.) For example, Win32's concept of window is encapsulated by MFC class `CWnd`. That is, a C++ class called `CWnd` encapsulates or "wraps" the `HWND` handle that represents a Windows window. Likewise, class `CDialog` encapsulates Win32 dialog boxes. diff --git a/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md b/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md index e9adb0c6a10..4b8cec07283 100644 --- a/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md +++ b/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md @@ -9,7 +9,7 @@ ms.assetid: dc0f9f47-3184-4e7a-8074-2c63e0359885 The Win32 Internet Extensions, or WinInet, provide access to common Internet protocols, including gopher, FTP, and HTTP. Using WinInet, you can write Internet client applications at a higher level of programming, without having to deal with WinSock, TCP/IP, or the details of specific Internet protocols. WinInet provides a consistent set of functions for all three protocols, with a familiar Win32 API interface. This consistency minimizes code changes you need to make if the underlying protocol changes (for example, from FTP to HTTP). -Visual Studio provides two ways for you to use WinInet. You can call the Win32 Internet functions directly (see the OLE documentation in the Windows SDK for more information) or you can use WinInet through the [MFC WinInet classes](mfc-classes-for-creating-internet-client-applications.md). +Visual C++ provides two ways for you to use WinInet. You can call the Win32 Internet functions directly (see the OLE documentation in the Windows SDK for more information) or you can use WinInet through the [MFC WinInet classes](mfc-classes-for-creating-internet-client-applications.md). **You can use WinInet to:** diff --git a/docs/mfc/methods-of-creating-a-status-bar.md b/docs/mfc/methods-of-creating-a-status-bar.md index aa914e3f097..7d4e9bc4cf0 100644 --- a/docs/mfc/methods-of-creating-a-status-bar.md +++ b/docs/mfc/methods-of-creating-a-status-bar.md @@ -11,7 +11,7 @@ MFC provides two classes to create status bars: [CStatusBar](reference/cstatusba `CStatusBarCtrl` usually results in a smaller executable, and you may prefer to use `CStatusBarCtrl` if you do not intend to integrate the status bar into the MFC architecture. If you plan to use `CStatusBarCtrl` and integrate the status bar into the MFC architecture, you must take additional care to communicate status bar control manipulations to MFC. This communication is not difficult; however, it is additional work that is unneeded when you use `CStatusBar`. -Visual Studio provides two ways to take advantage of the status bar common control. +Visual C++ provides two ways to take advantage of the status bar common control. - Create the status bar using `CStatusBar`, and then call [CStatusBar::GetStatusBarCtrl](reference/cstatusbar-class.md#getstatusbarctrl) to get access to the `CStatusBarCtrl` member functions. diff --git a/docs/mfc/methods-of-creating-a-toolbar.md b/docs/mfc/methods-of-creating-a-toolbar.md index b241b3f46a3..aca7ea41dc3 100644 --- a/docs/mfc/methods-of-creating-a-toolbar.md +++ b/docs/mfc/methods-of-creating-a-toolbar.md @@ -11,7 +11,7 @@ MFC provides two classes to create toolbars: [CToolBar](reference/ctoolbar-class `CToolBarCtrl` usually results in a smaller executable, and you may prefer to use `CToolBarCtrl` if you do not intend to integrate the toolbar into the MFC architecture. If you plan to use `CToolBarCtrl` and integrate the toolbar into the MFC architecture, you must take additional care to communicate toolbar control manipulations to MFC. This communication is not difficult; however, it is additional work that is unneeded when you use `CToolBar`. -Visual Studio provides two ways to take advantage of the toolbar common control. +Visual C++ provides two ways to take advantage of the toolbar common control. - Create the toolbar using `CToolBar`, and then call [CToolBar::GetToolBarCtrl](reference/ctoolbar-class.md#gettoolbarctrl) to get access to the `CToolBarCtrl` member functions. diff --git a/docs/mfc/mfc-and-atl.md b/docs/mfc/mfc-and-atl.md index 6859ab97126..d9e499ac1bd 100644 --- a/docs/mfc/mfc-and-atl.md +++ b/docs/mfc/mfc-and-atl.md @@ -12,7 +12,7 @@ The Microsoft Foundation Classes (MFC) provide a C++ object-oriented wrapper ove You can create MFC or ATL programs with Visual Studio Community Edition or higher. The Express editions do not support MFC or ATL. -In Visual Studio 2015, Microsoft C++ is an optional component, and MFC and ATL components are optional sub-components under Microsoft C++. If you do not select these components when you first install Visual Studio, you will be prompted to install them the first time you attempt to create or open an MFC or ATL project. +In Visual Studio 2015, Visual C++ is an optional component, and MFC and ATL components are optional sub-components under Visual C++. If you do not select these components when you first install Visual Studio, you will be prompted to install them the first time you attempt to create or open an MFC or ATL project. In Visual Studio 2017 and later, MFC and ATL are optional sub-components under the **Desktop development with C++** workload in the Visual Studio Installer program. You can install ATL support without MFC, or combined MFC and ATL support (MFC depends on ATL). For more information about workloads and components, see [Install Visual Studio](/visualstudio/install/install-visual-studio). diff --git a/docs/mfc/mfc-library-versions.md b/docs/mfc/mfc-library-versions.md index 974d8e1bb97..ff6462e70e0 100644 --- a/docs/mfc/mfc-library-versions.md +++ b/docs/mfc/mfc-library-versions.md @@ -117,7 +117,7 @@ The import libraries needed to build applications or MFC extension DLLs that use If you are dynamically linking to the shared DLL version of MFC, whether it is from an application or from an MFC extension DLL, you must include the matching MFC*version*.DLL or MFC*version*U.DLL when you deploy your product. -For a list of Visual Studio DLLs that can be distributed with your applications, see [Distributable Code for Microsoft Visual Studio 2017 and Microsoft Visual Studio 2017 SDK (Includes Utilities and BuildServer Files)](/visualstudio/productinfo/2017-redistribution-vs) or [Distributable Code for Visual Studio 2019](/visualstudio/releases/2019/redistribution). +For a list of Visual C++ DLLs that can be distributed with your applications, see [Distributable Code for Microsoft Visual Studio 2017 and Microsoft Visual Studio 2017 SDK (Includes Utilities and BuildServer Files)](/visualstudio/productinfo/2017-redistribution-vs) or [Distributable Code for Visual Studio 2019](/visualstudio/releases/2019/redistribution). For more information on MBCS and Unicode support in MFC, see [Unicode and Multibyte Character Set (MBCS) Support](../atl-mfc-shared/unicode-and-multibyte-character-set-mbcs-support.md). diff --git a/docs/mfc/mfc-mbcs-dll-add-on.md b/docs/mfc/mfc-mbcs-dll-add-on.md index 0bc1d03de9a..f64676d47cd 100644 --- a/docs/mfc/mfc-mbcs-dll-add-on.md +++ b/docs/mfc/mfc-mbcs-dll-add-on.md @@ -10,7 +10,7 @@ Support for MFC and its multibyte character set (MBCS) libraries requires an add **Visual Studio 2013**: By default, the MFC libraries installed in Visual Studio 2013 only support Unicode development. You need the MBCS DLLs in order to build an MFC project in Visual Studio 2013 that has the **Character Set** property set to **Use Multi-Byte Character Set** or **Not Set**. Download the DLL at [Multibyte MFC Library for Visual Studio 2013](https://www.microsoft.com/download/details.aspx?id=40770). -**Visual Studio 2015**: Both Unicode and MBCS MFC DLLs are included in the Visual Studio setup components, but support for MFC is not installed by default. C++ and MFC are optional install configurations in Visual Studio setup. To make sure that MFC is installed, choose **Custom** in setup, and under **Programming Languages**, make sure that **C++ compilers and libraries** and **Microsoft Foundation Classes for C++** are selected. If you have already installed Visual Studio, you will be prompted to install C++ and/or MFC when you attempt to create an MFC project. +**Visual Studio 2015**: Both Unicode and MBCS MFC DLLs are included in the Visual C++ setup components, but support for MFC is not installed by default. Visual C++ and MFC are optional install configurations in Visual Studio setup. To make sure that MFC is installed, choose **Custom** in setup, and under **Programming Languages**, make sure that **Visual C++** and ****Microsoft Foundation Classes for C++** are selected. If you have already installed Visual Studio, you will be prompted to install Visual C++ and/or MFC when you attempt to create an MFC project. **Visual Studio 2017 and later**: The Unicode and MBCS MFC DLLs are installed with the **Desktop development with C++** workload when you select **MFC and ATL support** from the **Optional Components** pane in the Visual Studio Installer program. If your installation does not include these components, navigate to the **File | New Projects** dialog and click the **Open Visual Studio Installer** link. For more information, see [Install Visual Studio](/visualstudio/install/install-visual-studio). diff --git a/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md b/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md index e1730119ef5..db0802eea7c 100644 --- a/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md +++ b/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md @@ -20,7 +20,7 @@ A type library contains a binary description of the interfaces exposed by a comp 1. From the shortcut menu, select **Add** > **New Item**. -1. In the **Add New Item** dialog, select **Installed** packages and then select **Visual Studio**. +1. In the **Add New Item** dialog, select **Installed** packages and then select **Visual C++**. 1. In the Templates pane, select **MFC Class from Typelib**, and then select **Add** to display the [Add Class from Typelib Wizard](../../mfc/reference/add-class-from-typelib-wizard.md). diff --git a/docs/mfc/reference/adding-an-mfc-odbc-consumer.md b/docs/mfc/reference/adding-an-mfc-odbc-consumer.md index a0f9991f6d8..887931326d3 100644 --- a/docs/mfc/reference/adding-an-mfc-odbc-consumer.md +++ b/docs/mfc/reference/adding-an-mfc-odbc-consumer.md @@ -13,7 +13,7 @@ An MFC ODBC consumer consists of an ODBC recordset class and data bindings neces 1. In Class View, right-click the project. On the shortcut menu, click **Add** and then click **Add Class**. -1. In the Visual Studio folder, double-click the **MFC ODBC Consumer** icon or select it and click **Open**. +1. In the Visual C++ folder, double-click the **MFC ODBC Consumer** icon or select it and click **Open**. The MFC ODBC Consumer Wizard opens. diff --git a/docs/mfc/reference/creating-an-mfc-application.md b/docs/mfc/reference/creating-an-mfc-application.md index 8cf0f8d7610..6d366fb7b8a 100644 --- a/docs/mfc/reference/creating-an-mfc-application.md +++ b/docs/mfc/reference/creating-an-mfc-application.md @@ -56,7 +56,7 @@ The dialog shows the application type, set to Console Application (.exe). Under ## To create an MFC forms or dialog-based application 1. From the Visual Studio main menu, choose **File** > **New** > **Project**. -1. Under the **Installed** templates, choose **C++** > **MFC/ATL**. If you don't see these, use the Visual Studio Installer to add MFC/ATL functionality. You can access the installer from the Visual Studio menu via **Tools** > **Get Tools and Features...** In the installer, select **Individual components** and search for **mfc** and then select the appropriate library for your machine such as **C++ MFC for x86 and x64 with Spectre Mitigations**. +1. Under the **Installed** templates, choose **Visual C++** > **MFC/ATL**. If you don't see these, use the Visual Studio Installer to add MFC/ATL functionality. You can access the installer from the Visual Studio menu via **Tools** > **Get Tools and Features...** In the installer, select **Individual components** and search for **mfc** and then select the appropriate library for your machine such as **C++ MFC for x86 and x64 with Spectre Mitigations**. 1. Choose **MFC App** from the center pane. 1. Modify the configuration values as needed, then press **OK**. @@ -71,7 +71,7 @@ The dialog shows the various settings set to their default, such as the applicat An MFC console application is a command-line program that uses MFC libraries but runs in the console window. 1. From the main menu, choose **File** > **New** > **Project**. -1. Under the **Installed** templates, choose **C++** > **Windows Desktop**. +1. Under the **Installed** templates, choose **Visual C++** > **Windows Desktop**. 1. From the center pane, choose **Windows Desktop Wizard**. 1. Modify the project name as needed, then press **OK** to open the **Windows Desktop Wizard**. 1. Check the **MFC Headers** box and set other values as needed, then press **OK**. @@ -87,7 +87,7 @@ The dialog shows the application type set to Console Application (.exe). Under a ## To create an MFC forms or dialog-based application 1. From the main menu, choose **File** > **New** > **Project**. -1. Under the **Installed** templates, choose **C++** > **MFC**. +1. Under the **Installed** templates, choose **Visual C++** > **MFC**. 1. Choose **MFC Application** from the center pane. 1. Click **Next** to start the **MFC Application Wizard**. @@ -102,7 +102,7 @@ The dialog lists the current project settings such as: tabbed multiple document An MFC console application is a command-line program that uses MFC libraries but runs in the console window. 1. From the main menu, choose **File** > **New** > **Project**. -1. Under the **Installed** templates, choose **C++** > **Win32**. +1. Under the **Installed** templates, choose **Visual C++** > **Win32**. 1. Choose **Win32 Console Application** from the center pane. 1. Modify the project name as needed, then press **OK**. 1. On the second page of the wizard, check the **Add common headers for MFC** box and set other values as needed, then press **Finish**. diff --git a/docs/mfc/technical-notes-by-category.md b/docs/mfc/technical-notes-by-category.md index 64544f67312..288094ac3af 100644 --- a/docs/mfc/technical-notes-by-category.md +++ b/docs/mfc/technical-notes-by-category.md @@ -79,7 +79,7 @@ Technical notes are divided into the following categories. For a numerical listi [TN023: Standard MFC Resources](../mfc/tn023-standard-mfc-resources.md)\ [TN024: MFC-Defined Messages and Resources](../mfc/tn024-mfc-defined-messages-and-resources.md)\ [TN028: Context-Sensitive Help Support](../mfc/tn028-context-sensitive-help-support.md)\ -[TN035: Using Multiple Resource Files and Header Files with Visual Studio](../mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md)\ +[TN035: Using Multiple Resource Files and Header Files with Visual C++](../mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md)\ [TN036: Using CFormView with AppWizard and ClassWizard](../mfc/tn036-using-cformview-with-appwizard-and-classwizard.md)\ [TN070: MFC Window Class Names](../mfc/tn070-mfc-window-class-names.md) diff --git a/docs/mfc/technical-notes-by-number.md b/docs/mfc/technical-notes-by-number.md index 52d265d9390..d07d4b3b3bd 100644 --- a/docs/mfc/technical-notes-by-number.md +++ b/docs/mfc/technical-notes-by-number.md @@ -44,7 +44,7 @@ The technical notes below are listed numerically, with the most recently written |38|[MFC/OLE IUnknown Implementation](../mfc/tn038-mfc-ole-iunknown-implementation.md)| |37|[Multithreaded MFC 2.1 Applications](../mfc/tn037-multithreaded-mfc-2-1-applications.md)| |36|[Using CFormView with AppWizard and ClassWizard](../mfc/tn036-using-cformview-with-appwizard-and-classwizard.md)| -|35|[Using Multiple Resource Files and Header Files with Visual Studio](../mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md)| +|35|[Using Multiple Resource Files and Header Files with Visual C++](../mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md)| |33|[DLL Version of MFC](../mfc/tn033-dll-version-of-mfc.md)| |32|[MFC Exception Mechanism](../mfc/tn032-mfc-exception-mechanism.md)| |31|[Control Bars](../mfc/tn031-control-bars.md)| diff --git a/docs/mfc/testing-properties-and-events-with-test-container.md b/docs/mfc/testing-properties-and-events-with-test-container.md index ead507de3af..d7258a77d5c 100644 --- a/docs/mfc/testing-properties-and-events-with-test-container.md +++ b/docs/mfc/testing-properties-and-events-with-test-container.md @@ -7,7 +7,7 @@ ms.topic: how-to --- # Testing Properties and Events with Test Container -The Test Container application, shipped in Visual Studio, is an ActiveX control container for testing and debugging ActiveX controls. Test Container allows the control developer to test the control's functionality by changing its properties, invoking its methods, and firing its events. Test Container can display logs of data-binding notifications and also provides facilities for testing an ActiveX control's persistence functionality: you can save properties to a stream or to substorage, reload them, and examine the stored stream data. This section describes how to use the basic features of Test Container. For additional information, select the **Help** menu while running Test Container. +The Test Container application, shipped in Visual C++, is an ActiveX control container for testing and debugging ActiveX controls. Test Container allows the control developer to test the control's functionality by changing its properties, invoking its methods, and firing its events. Test Container can display logs of data-binding notifications and also provides facilities for testing an ActiveX control's persistence functionality: you can save properties to a stream or to substorage, reload them, and examine the stored stream data. This section describes how to use the basic features of Test Container. For additional information, select the **Help** menu while running Test Container. ### To access the ActiveX Control Test Container diff --git a/docs/mfc/tn057-localization-of-mfc-components.md b/docs/mfc/tn057-localization-of-mfc-components.md index b011cb4de35..bb920458129 100644 --- a/docs/mfc/tn057-localization-of-mfc-components.md +++ b/docs/mfc/tn057-localization-of-mfc-components.md @@ -43,13 +43,13 @@ From then on, MFC will load resources from that DLL instead of from myapp.exe. A It is relatively easy to create a resource only DLL. You create a DLL project, add your .RC file to it, and add the necessary resources. If you have an existing project that does not use this technique, you can copy the resources from that project. After adding the resource file to the project, you are almost ready to build the project. The only thing you must do is set the linker options to include **/NOENTRY**. This tells the linker that the DLL has no entry point - since it has no code, it has no entry point. > [!NOTE] -> The resource editor in Visual Studio 4.0 and later supports multiple languages per .RC file. This can make it very easy to manage your localization in a single project. The resources for each language are controlled by preprocessor directives generated by the resource editor. +> The resource editor in Visual C++ 4.0 and later supports multiple languages per .RC file. This can make it very easy to manage your localization in a single project. The resources for each language are controlled by preprocessor directives generated by the resource editor. ## Using the Provided MFC Localized Resources Any MFC application that you build reuses two things from MFC: code and resources. That is, MFC has various error messages, built-in dialogs, and other resources that are used by the MFC classes. In order to completely localize your application, you need to localize not only your application's resources, but also the resources that come directly from MFC. MFC provides a number of different language resource files automatically, so that if the language you are targeting is one of the languages MFC already supports, you just need to make sure you use those localized resources. -As of this writing, MFC supports Chinese, German, Spanish, French, Italian, Japanese, and Korean. The files which contain these localized versions are in the MFC\INCLUDE\L.* (the 'L' stands for localized) directories. The German files are in MFC\INCLUDE\L.DEU, for example. To cause your application to use these RC files instead of the files located in MFC\INCLUDE, add a `/IC:\PROGRAM FILES\MICROSOFT VISUAL STUDIO .NET 2003\VC7\MFC\INCLUDE\L.DEU` to your RC command line (this is just an example; you would need to substitute your locale of choice as well as the directory into which you installed Microsoft C++). +As of this writing, MFC supports Chinese, German, Spanish, French, Italian, Japanese, and Korean. The files which contain these localized versions are in the MFC\INCLUDE\L.* (the 'L' stands for localized) directories. The German files are in MFC\INCLUDE\L.DEU, for example. To cause your application to use these RC files instead of the files located in MFC\INCLUDE, add a `/IC:\PROGRAM FILES\MICROSOFT VISUAL STUDIO .NET 2003\VC7\MFC\INCLUDE\L.DEU` to your RC command line (this is just an example; you would need to substitute your locale of choice as well as the directory into which you installed Visual C++). The above instructions will work if your application links statically with MFC. Most applications link dynamically (because that is the AppWizard default). In this scenario, not only the code is dynamically linked - so are the resources. As a result, you can localize your resources in your application, but the MFC implementation resources will still be loaded from the MFC7x.DLL (or a later version) or from MFC7xLOC.DLL if it exists. You can approach this from two different angles. diff --git a/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md b/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md index 0d04318ced9..19b88357d9d 100644 --- a/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md +++ b/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md @@ -11,7 +11,7 @@ ms.assetid: 602df5c2-17d4-4cd9-8cf6-dff652c4cae5 ## Prerequisites -[Visual Studio C++ Samples](../overview/visual-cpp-samples.md) +[Visual C++ Samples](../overview/visual-cpp-samples.md) ## Sections diff --git a/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md b/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md index 5aa336afc5a..35d503d1884 100644 --- a/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md +++ b/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md @@ -53,7 +53,7 @@ These steps vary depending on which version of Visual Studio you are using. To s 1. Use the **MFC Application Wizard** to create a new MFC application. To run the wizard, from the **File** menu select **New**, and then select **Project**. The **New Project** dialog box will be displayed. -1. In the **New Project** dialog box, expand the **Visual Studio** node in the **Project types** pane and select **MFC**. Then, in the **Templates** pane, select **MFC Application**. Type a name for the project, such as `MFCShellControls` and click **OK**. +1. In the **New Project** dialog box, expand the **Visual C++** node in the **Project types** pane and select **MFC**. Then, in the **Templates** pane, select **MFC Application**. Type a name for the project, such as `MFCShellControls` and click **OK**. After **MFC Application Wizard** displays, use the following options: @@ -200,7 +200,7 @@ The wizard automatically creates an application that has a standard menu bar, a - The wizard created an Outlook bar with both a **Folders** pane and a **Calendar** pane. It probably doesn't make sense to have a **Calendar** pane in an **Explorer** window, so remove that pane now. -- The `CMFCShellListCtrl` supports viewing files in different modes, such as **Large Icons**, **Small Icons**, **List**, and **Details**. Update your application to implement this functionality. Hint: see [Visual Studio C++ Samples](../overview/visual-cpp-samples.md). +- The `CMFCShellListCtrl` supports viewing files in different modes, such as **Large Icons**, **Small Icons**, **List**, and **Details**. Update your application to implement this functionality. Hint: see [Visual C++ Samples](../overview/visual-cpp-samples.md). ## See also From 8983b9338b48aeb09bd0b0dd536c868875cdbcd6 Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Wed, 4 Feb 2026 03:06:32 -0800 Subject: [PATCH 1598/1799] Log examples and download instructions --- ...oubleshoot-vcredist-installation-issues.md | 147 +++++++++++++++--- 1 file changed, 127 insertions(+), 20 deletions(-) diff --git a/docs/windows/troubleshoot-vcredist-installation-issues.md b/docs/windows/troubleshoot-vcredist-installation-issues.md index aaba4d0846f..58af67bca74 100644 --- a/docs/windows/troubleshoot-vcredist-installation-issues.md +++ b/docs/windows/troubleshoot-vcredist-installation-issues.md @@ -1,11 +1,11 @@ --- title: "Troubleshoot Visual C++ Redistributable installation issues" -description: "Provide steps to diagnose and resolve issues with installing the Visual C++ Redistributable (vcredist)" +description: "Provide steps to diagnose and resolve issues with installing the Visual C++ Redistributable (VC Redist)" author: vicroms ms.author: viromer -ms.date: 01/21/2025 +ms.date: 02/04/2025 ms.topic: troubleshooting-general -helpviewer_keywords: [ "redist","vcredist", "Visual [C++] redistributable" ] +helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC Redist" ] --- # Troubleshoot Visual C++ Redistributable installation issues @@ -14,29 +14,54 @@ Runtime components using the Visual C++ Redistributable installer or the Visual Studio Installer. If you're experiencing such issues, we recommend that you first attempt -installing the [latest version of the Visual C++ +installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). ## Collect failure logs The first step to diagnose an issue with the Visual C++ -Redistributable (vcredist) installer is to collect its failure logs. +Redistributable (VC Redist) installer is to collect its failure logs. 1) Download the [Microsoft Visual Studio and .NET Log Collection Tool](). 2) Run `Collect.exe` 3) Extract the contents of `%TEMP%/vscollect.zip` -Once you extract `vscollect.zip`, the vcredist logs are located inside the -`Temp` folder. The relevant log files will be prefixed with the pattern +Once you extract `vscollect.zip`, the VC Redist logs are located inside the +`Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. In this article, we use these logs to diagnose common issues with the redist installer. +### Other log locations + +VC Redist is often executed as a prerequisite of other products, in such cases +the installation log might be found in a different path. + +For example, [Configuration +Manager](/intune/configmgr/core/understand/introduction) upgrades VC Redist as +part of its own upgrade process, running `vcredist_x64.exe` with the `/l` +option, overriding the default log location. + +In such cases, the path to the VC Redist logs can be found by reading that product's +own logs: + +**Example: Configuration Manager logs** + +`\Logs\cmupdate.log` + +```log +10-31-2025 17:40:06.421 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) [Visual C++ 2015-2022 Redistributable (x64)] with older version 14.28.29914 is installed. it needs to upgraded. +10-31-2025 17:40:06.421 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) INFO: Start install Visual C redistributable ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe" /q /norestart /l "C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log"). +10-31-2025 17:40:14.553 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) ERROR: Failed to install Visual C redistributable. Return code: 1603. +10-31-2025 17:40:14.553 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) ERROR: 64-bit VC Redist installation ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe") failed. Please check log file [C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log]. +10-31-2025 17:40:14.554 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) Failed to install vc redist. Please manually install it from C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64 +``` + ## Return Code 1603 -Issues with the vcredist installer often produce the return code 1603. This is +Issues with the VC Redist installer often produce the return code 1603. This is a generic install failure code produced by the Windows Installer, which is invoked during the installation of the Visual C++ Runtime components. @@ -51,32 +76,114 @@ the Visual C++ Redistributable installer](#my-issue-is-not-here). ## Common issues -### Binary file is being used +### Error 1714 - Older Version Cannot Be Removed + +Error 1714 is often caused by a corrupted Windows Installer Cache. The +installation process fails to remove an older version due to a corrupted +or missing MSI package. **Diagnose** -**Steps to resolve** +> [!NOTE] +> The log file examples in this section have had the timestamps removed to +> present only the relevant information. -1 - Close all currently running applications. +> [!NOTE] +> The GUIDs on this examples may be different depending on the product version +> being installed. -### Antivirus or third-party software interference +The presence of these error messages indicate a corrupted cache. -**Diagnose** +In `dd_vcredist__.log` -**Steps to resolve** +```log +Error 0x80070003: Failed to get size of pseudo bundle: C:\ProgramData\Package Cache\{43d1ce82-6f55-4860-a938-20e5deb28b98}\VC_redist.x64.exe +Error 0x80070003: Failed to initialize package from related bundle id: {43d1ce82-6f55-4860-a938-20e5deb28b98} +``` -1 - Disable any antivirus or third-party software that may have a lock on - components that are part of the Visual C++ Redistributable. +In `dd_vcredist___vcRuntimeMinimum_.log`: -### Corrupted Windows Installer cache +```log +SOURCEMGMT: Trying source C:\ProgramData\Package Cache\{455DF12C-7D43-4EFF-AE2F-43C8AF2817A3}v14.28.29914\packages\vcRuntimeMinimum_amd64\. +Note: 1: 2203 2: C:\ProgramData\Package Cache\{455DF12C-7D43-4EFF-AE2F-43C8AF2817A3}v14.28.29914\packages\vcRuntimeMinimum_amd64\vc_runtimeMinimum_x64.msi 3: -2147287037 +SOURCEMGMT: Source is invalid due to missing/inaccessible package. +``` -**Diagnose** +```log +Note: 1: 1714 2: Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 3: 1612 +CustomAction returned actual error code 1612 (note this may not be 100% accurate if translation happened inside sandbox) +Product: Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 -- Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612. + +Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612. +``` + +In `VSSetupEvents.txt` + +```log +Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612.] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [] +``` **Steps to resolve** -1 - Try using the Windows Installer troubleshooting tool. +From the log files, take note of the VC Redist version causing the issue. + +Method 1: Use the Windows Installer: + +1. Try using the Windows Installer to manually remove the old VC Redist version. + If prompted, let the Windows Installer Troubleshooter attempt to fix the + issue. +2. Retry the installation. + +Method 2: Manually remove the old version. + +1. Download the VC Redist installer for the old version by following the steps in + [Download old versions of the Visual C++ Redistributable Installer](#old-vcredist-versions) +2. Run the installer to uninstall the old VC Redist. +3. Retry the installation. + +## Download old versions of the Visual C++ Redistributable Installer + +> [!WARNING] +> Never install a Visual C++ Redistributable Installer that wasn't downloaded +> from a Microsoft site. And only install packages that are signed by Microsoft. + +The VC Redist installer can be downloaded from +[my.visualstudio.com](), search for +Visual C++ Redistributable + +The latest supported VC Redist version for each version of Visual Studio can +be found in [this article](/cpp/windows/latest-supported-vc-redist). + +To access older or legacy versions follow these steps: + +**Version 14.50 or later** + +The download links use the +`https://aka.ms/vs/18/release//VC_redist..exe` pattern. +For example: . + +**Version 14.30 to 14.44** + +The download links use the +`https://aka.ms/vs/17/release//VC_redist.exe` pattern. +For example: . + +**Version 14.20 to 14.29** + +The download links use the +`https://aka.ms/vs/16/release//VC_redist.exe` pattern. +For example: + +**Version 14.10 or later** + +The download links use the +`https://aka.ms/vs/15/release//VC_redist.exe` pattern. +For example: + +If the aka.ms links do not work, you may be able to find the version you're +looking for through a Bing search. However, make sure that the download +comes from a Microsoft site and that the installer is signed by Microsoft. ## My issue is not here TBD: Instructions to report an issue with the redist installer. - From bd5518d634103a46c50b1f98cc9bcebf7877f867 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 4 Feb 2026 15:23:10 -0800 Subject: [PATCH 1599/1799] integrate troubleshooting guide --- docs/build/run-time-library-behavior.md | 80 ++++++++++++++++--- .../c-runtime-library/crt-library-features.md | 35 ++++++++ 2 files changed, 104 insertions(+), 11 deletions(-) diff --git a/docs/build/run-time-library-behavior.md b/docs/build/run-time-library-behavior.md index ad23da72e29..8b772a5e6b5 100644 --- a/docs/build/run-time-library-behavior.md +++ b/docs/build/run-time-library-behavior.md @@ -1,25 +1,24 @@ --- -description: "Learn more about: DLLs and Microsoft C++ run-time library behavior" -title: "DLLs and Visual C++ run-time library behavior" +description: "Learn more about: DLLs and Microsoft C++ runtime library behavior" +title: "DLLs and Visual C++ runtime library behavior" ms.date: "08/19/2019" f1_keywords: ["_DllMainCRTStartup", "CRT_INIT"] helpviewer_keywords: ["DLLs [C++], entry point function", "process detach [C++]", "process attach [C++]", "DLLs [C++], run-time library behavior", "DllMain function", "_CRT_INIT macro", "_DllMainCRTStartup method", "run-time [C++], DLL startup sequence", "DLLs [C++], startup sequence"] -ms.assetid: e06f24ab-6ca5-44ef-9857-aed0c6f049f2 --- -# DLLs and Visual C++ run-time library behavior +# DLLs and Visual C++ runtime library behavior -When you build a Dynamic-link Library (DLL) by using Visual Studio, by default, the linker includes the Visual C++ run-time library (VCRuntime). The VCRuntime contains code required to initialize and terminate a C/C++ executable. When linked into a DLL, the VCRuntime code provides an internal DLL entry-point function called `_DllMainCRTStartup` that handles Windows OS messages to the DLL to attach to or detach from a process or thread. The `_DllMainCRTStartup` function performs essential tasks such as stack buffer security set up, C run-time library (CRT) initialization and termination, and calls to constructors and destructors for static and global objects. `_DllMainCRTStartup` also calls hook functions for other libraries such as WinRT, MFC, and ATL to perform their own initialization and termination. Without this initialization, the CRT and other libraries, as well as your static variables, would be left in an uninitialized state. The same VCRuntime internal initialization and termination routines are called whether your DLL uses a statically linked CRT or a dynamically linked CRT DLL. +When you build a Dynamic-link Library (DLL) by using Visual Studio, by default, the linker includes the Visual C++ runtime library (VCRuntime). The VCRuntime contains code required to initialize and terminate a C/C++ executable. When linked into a DLL, the VCRuntime code provides an internal DLL entry-point function called `_DllMainCRTStartup` that handles Windows OS messages to the DLL to attach to or detach from a process or thread. The `_DllMainCRTStartup` function performs essential tasks such as stack buffer security set up, C runtime library (CRT) initialization and termination, and calls to constructors and destructors for static and global objects. `_DllMainCRTStartup` also calls hook functions for other libraries such as WinRT, MFC, and ATL to perform their own initialization and termination. Without this initialization, the CRT and other libraries, as well as your static variables, would be left in an uninitialized state. The same VCRuntime internal initialization and termination routines are called whether your DLL uses a statically linked CRT or a dynamically linked CRT DLL. ## Default DLL entry point _DllMainCRTStartup In Windows, all DLLs can contain an optional entry-point function, usually called `DllMain`, that is called for both initialization and termination. This gives you an opportunity to allocate or release additional resources as needed. Windows calls the entry-point function in four situations: process attach, process detach, thread attach, and thread detach. When a DLL is loaded into a process address space, either when an application that uses it is loaded, or when the application requests the DLL at runtime, the operating system creates a separate copy of the DLL data. This is called *process attach*. *Thread attach* occurs when the process the DLL is loaded in creates a new thread. *Thread detach* occurs when the thread terminates, and *process detach* is when the DLL is no longer required and is released by an application. The operating system makes a separate call to the DLL entry point for each of these events, passing a *reason* argument for each event type. For example, the OS sends `DLL_PROCESS_ATTACH` as the *reason* argument to signal process attach. -The VCRuntime library provides an entry-point function called `_DllMainCRTStartup` to handle default initialization and termination operations. On process attach, the `_DllMainCRTStartup` function sets up buffer security checks, initializes the CRT and other libraries, initializes run-time type information, initializes and calls constructors for static and non-local data, initializes thread-local storage, increments an internal static counter for each attach, and then calls a user- or library-supplied `DllMain`. On process detach, the function goes through these steps in reverse. It calls `DllMain`, decrements the internal counter, calls destructors, calls CRT termination functions and registered `atexit` functions, and notifies any other libraries of termination. When the attachment counter goes to zero, the function returns `FALSE` to indicate to Windows that the DLL can be unloaded. The `_DllMainCRTStartup` function is also called during thread attach and thread detach. In these cases, the VCRuntime code does no additional initialization or termination on its own, and just calls `DllMain` to pass the message along. If `DllMain` returns `FALSE` from process attach, signaling failure, `_DllMainCRTStartup` calls `DllMain` again and passes `DLL_PROCESS_DETACH` as the *reason* argument, then goes through the rest of the termination process. +The VCRuntime library provides an entry-point function called `_DllMainCRTStartup` to handle default initialization and termination operations. On process attach, the `_DllMainCRTStartup` function sets up buffer security checks, initializes the CRT and other libraries, initializes runtime type information, initializes and calls constructors for static and non-local data, initializes thread-local storage, increments an internal static counter for each attach, and then calls a user- or library-supplied `DllMain`. On process detach, the function goes through these steps in reverse. It calls `DllMain`, decrements the internal counter, calls destructors, calls CRT termination functions and registered `atexit` functions, and notifies any other libraries of termination. When the attachment counter goes to zero, the function returns `FALSE` to indicate to Windows that the DLL can be unloaded. The `_DllMainCRTStartup` function is also called during thread attach and thread detach. In these cases, the VCRuntime code does no additional initialization or termination on its own, and just calls `DllMain` to pass the message along. If `DllMain` returns `FALSE` from process attach, signaling failure, `_DllMainCRTStartup` calls `DllMain` again and passes `DLL_PROCESS_DETACH` as the *reason* argument, then goes through the rest of the termination process. -When building DLLs in Visual Studio, the default entry point `_DllMainCRTStartup` supplied by VCRuntime is linked in automatically. You do not need to specify an entry-point function for your DLL by using the [/ENTRY (Entry point symbol)](reference/entry-entry-point-symbol.md) linker option. +When building DLLs in Visual Studio, the default entry point `_DllMainCRTStartup` supplied by VCRuntime is linked in automatically. You do not need to specify an entry-point function for your DLL by using the [`/ENTRY` (Entry point symbol)](reference`/ENTRY`-entry-point-symbol.md) linker option. > [!NOTE] -> While it is possible to specify another entry-point function for a DLL by using the /ENTRY: linker option, we do not recommend it, because your entry-point function would have to duplicate everything that `_DllMainCRTStartup` does, in the same order. The VCRuntime provides functions that allow you to duplicate its behavior. For example, you can call [__security_init_cookie](../c-runtime-library/reference/security-init-cookie.md) immediately on process attach to support the [/GS (Buffer security check)](reference/gs-buffer-security-check.md) buffer checking option. You can call the `_CRT_INIT` function, passing the same parameters as the entry point function, to perform the rest of the DLL initialization or termination functions. +> While it is possible to specify another entry-point function for a DLL by using the `/ENTRY`: linker option, we do not recommend it, because your entry-point function would have to duplicate everything that `_DllMainCRTStartup` does, in the same order. The VCRuntime provides functions that allow you to duplicate its behavior. For example, you can call [__security_init_cookie](../c-runtime-library/reference/security-init-cookie.md) immediately on process attach to support the [/GS (Buffer security check)](reference/gs-buffer-security-check.md) buffer checking option. You can call the `_CRT_INIT` function, passing the same parameters as the entry point function, to perform the rest of the DLL initialization or termination functions. @@ -82,7 +81,66 @@ extern "C" BOOL WINAPI DllMain ( ``` > [!NOTE] -> Older Windows SDK documentation says that the actual name of the DLL entry-point function must be specified on the linker command-line with the /ENTRY option. With Visual Studio, you do not need to use the /ENTRY option if the name of your entry-point function is `DllMain`. In fact, if you use the /ENTRY option and name your entry-point function something other than `DllMain`, the CRT does not get initialized properly unless your entry-point function makes the same initialization calls that `_DllMainCRTStartup` makes. +> Older Windows SDK documentation says that the actual name of the DLL entry-point function must be specified on the linker command-line with the `/ENTRY` option. With Visual Studio, you do not need to use the `/ENTRY` option if the name of your entry-point function is `DllMain`. In fact, if you use the `/ENTRY` option and name your entry-point function something other than `DllMain`, the CRT does not get initialized properly unless your entry-point function makes the same initialization calls that `_DllMainCRTStartup` makes. + +### Manual CRT initialization with `_CRT_INIT` + +When building a DLL that uses any of the C runtime libraries, in order to ensure that the CRT is properly initialized, either: + +1. The initialization function must be named `DllMain()` and the entry point must be specified with the linker option `-entry:_DllMainCRTStartup@12`, or +1. The DLL's entry point must explicitly call `_CRT_INIT()` on process attach and process detach. + +This permits the C runtime libraries to properly allocate and initialize C runtime data when a process or thread is attaching to the DLL, to properly clean up C runtime data when a process is detaching from the DLL, and for global C++ objects in the DLL to be properly constructed and destructed. + +The Win32 SDK samples all use the first method. Refer to the Win32 Programmer's Reference for `DllEntryPoint()` and the Visual C++ documentation for `DllMain()`. Note that `DllMainCRTStartup()` calls `_CRT_INIT()` and `_CRT_INIT()` will call your application's `DllMain()`, if it exists. + +If you wish to use the second method and call the CRT initialization code yourself, instead of using `DllMainCRTStartup()` and `DllMain()`, there are two techniques: + +1. If there is no entry function that performs initialization code, specify `_CRT_INIT()` as the entry point of the DLL. Assuming that you've included `NTWIN32.MAK`, which defines `DLLENTRY` as `@12`, add the option to the DLL's link line: `-entry:_CRT_INIT$(DLLENTRY)`. +1. If you do have your own DLL entry point, do the following in the entry point: + + a. Use this prototype for `_CRT_INIT()`: `BOOL WINAPI _CRT_INIT(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpReserved);` + + For information on `_CRT_INIT()` return values, see the documentation for `DllEntryPoint`; the same values are returned. + + b. On `DLL_PROCESS_ATTACH` and `DLL_THREAD_ATTACH`, call `_CRT_INIT()` first, before any C runtime functions are called or any floating-point operations are performed. + + c. Call your own process/thread initialization/termination code. + + d. On `DLL_PROCESS_DETACH` and `DLL_THREAD_DETACH`, call `_CRT_INIT()` last, after all C runtime functions have been called and all floating-point operations are completed. + +Be sure to pass on to `_CRT_INIT()` all of the parameters of the entry point; `_CRT_INIT()` expects those parameters, so things may not work reliably if they are omitted (in particular, `fdwReason` is required to determine whether process initialization or termination is needed). + +Below is a skeleton sample entry point function that shows when and how to make these calls to `_CRT_INIT()` in the DLL entry point: + +```cpp +BOOL WINAPI DllEntryPoint(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpReserved) +{ + if (fdwReason == DLL_PROCESS_ATTACH || fdwReason == DLL_THREAD_ATTACH) + if (!_CRT_INIT(hinstDLL, fdwReason, lpReserved)) + return(FALSE); + + if (fdwReason == DLL_PROCESS_DETACH || fdwReason == DLL_THREAD_DETACH) + if (!_CRT_INIT(hinstDLL, fdwReason, lpReserved)) + return(FALSE); + + return(TRUE); +} +``` + +> [!NOTE] +> This is not necessary if you are using `DllMain()` and `-entry:_DllMainCRTStartup@12`. + +### Using NTWIN32.MAK to simplify the build process + +There are macros defined in `NTWIN32.MAK` that can be used to simplify your makefiles and to ensure that they are properly built to avoid conflicts. For this reason, Microsoft highly recommends using `NTWIN32.MAK `and its macros. + +For compilation, use: `$(cvarsdll)` for apps/DLLs using CRT in a DLL. + +For linking, use one of the following: + +- `$(conlibsdll)` for console apps/DLLs using CRT in a DLL +- `$(guilibsdll)` for GUI apps using CRT in a DLL @@ -145,7 +203,7 @@ Creating a new `CDynLinkLibrary` object during initialization allows the MFC ext If you are going to use your MFC extension DLL from one or more regular MFC DLLs, you must export an initialization function that creates a `CDynLinkLibrary` object. That function must be called from each of the regular MFC DLLs that use the MFC extension DLL. An appropriate place to call this initialization function is in the `InitInstance` member function of the regular MFC DLL's `CWinApp`-derived object before using any of the MFC extension DLL's exported classes or functions. -In the `DllMain` that the MFC DLL Wizard generates, the call to `AfxInitExtensionModule` captures the module's run-time classes (`CRuntimeClass` structures) as well as its object factories (`COleObjectFactory` objects) for use when the `CDynLinkLibrary` object is created. You should check the return value of `AfxInitExtensionModule`; if a zero value is returned from `AfxInitExtensionModule`, return zero from your `DllMain` function. +In the `DllMain` that the MFC DLL Wizard generates, the call to `AfxInitExtensionModule` captures the module's runtime classes (`CRuntimeClass` structures) as well as its object factories (`COleObjectFactory` objects) for use when the `CDynLinkLibrary` object is created. You should check the return value of `AfxInitExtensionModule`; if a zero value is returned from `AfxInitExtensionModule`, return zero from your `DllMain` function. If your MFC extension DLL will be explicitly linked to an executable (meaning the executable calls `AfxLoadLibrary` to link to the DLL), you should add a call to `AfxTermExtensionModule` on `DLL_PROCESS_DETACH`. This function allows MFC to clean up the MFC extension DLL when each process detaches from the MFC extension DLL (which happens when the process exits or when the DLL is unloaded as a result of a `AfxFreeLibrary` call). If your MFC extension DLL will be linked implicitly to the application, the call to `AfxTermExtensionModule` is not necessary. @@ -160,7 +218,7 @@ Note that the header file Afxdllx.h contains special definitions for structures > [!NOTE] > It is important that you neither define nor undefine any of the `_AFX_NO_XXX` macros in *pch.h* (*stdafx.h* in Visual Studio 2017 and earlier). These macros exist only for the purpose of checking whether a particular target platform supports that feature or not. You can write your program to check these macros (for example, `#ifndef _AFX_NO_OLE_SUPPORT`), but your program should never define or undefine these macros. -A sample initialization function that handles multithreading is included in [Using Thread Local Storage in a Dynamic-Link Library](/windows/win32/Dlls/using-thread-local-storage-in-a-dynamic-link-library) in the Windows SDK. Note that the sample contains an entry-point function called `LibMain`, but you should name this function `DllMain` so that it works with the MFC and C run-time libraries. +A sample initialization function that handles multithreading is included in [Using Thread Local Storage in a Dynamic-Link Library](/windows/win32/Dlls/using-thread-local-storage-in-a-dynamic-link-library) in the Windows SDK. Note that the sample contains an entry-point function called `LibMain`, but you should name this function `DllMain` so that it works with the MFC and C runtime libraries. ## See also diff --git a/docs/c-runtime-library/crt-library-features.md b/docs/c-runtime-library/crt-library-features.md index 165f5090864..9272de5f709 100644 --- a/docs/c-runtime-library/crt-library-features.md +++ b/docs/c-runtime-library/crt-library-features.md @@ -104,6 +104,41 @@ It's also possible to avoid some of these issues if all of the images in your pr Be careful if your program passes certain CRT resources across DLL boundaries. Resources such as file handles, locales, and environment variables can cause problems, even when using the same version of the CRT. For more information on the issues involved and how to resolve them, see [Potential errors passing CRT objects across DLL boundaries](./potential-errors-passing-crt-objects-across-dll-boundaries.md). +### Problems with statically linked CRT libraries + +If an application that makes C runtime calls links to a DLL that also makes C runtime calls, be aware that if they are both linked with one of the statically linked C runtime libraries, the `.EXE` and DLL will have separate copies of all C runtime functions and global variables. This means that C runtime data cannot be shared between the `.EXE` and the DLL. Some of the problems that can occur are: + +- Passing buffered stream handles from the .EXE/DLL to the other module +- Allocating memory with a C runtime call in the .EXE/DLL and reallocating or freeing it in the other module +- Checking or setting the value of the global `errno` variable in the .EXE/DLL and expecting it to be the same in the other module. A related problem is calling `perror()` in the opposite module from where the C runtime error occurred, since `perror()` uses `errno`. + +To avoid these problems, link both the `.EXE` and DLL with `CRTDLL.LIB` or `MSVCRT.LIB`, which allows both the `.EXE` and DLL to use the common set of functions and data contained within CRT in a DLL, and C runtime data such as stream handles can then be shared by both the `.EXE` and DLL. + +### Mixing library types + +You can link your DLL with `CRTDLL.LIB`/`MSVCRT.LIB` regardless of what your `.EXE` is linked with if you avoid mixing CRT data structures and passing CRT file handles or CRT `FILE*` pointers to other modules. + +When mixing library types adhere to the following: + +- CRT file handles may only be operated on by the CRT module that created them. +- CRT `FILE*` pointers may only be operated on by the CRT module that created them. +- Memory allocated with the CRT function `malloc()` may only be freed or reallocated by the CRT module that allocated it. + +To illustrate this, consider the following example: + +- `.EXE` is linked with `MSVCRT.LIB` +- DLL A is linked with `LIBCMT.LIB` +- DLL B is linked with `CRTDLL.LIB` + +If the `.EXE` creates a CRT file handle using `_create()` or `_open()`, this file handle may only be passed to `_lseek()`, `_read()`, `_write()`, `_close()`, etc. in the `.EXE` file. Do not pass this CRT file handle to either DLL. Do not pass a CRT file handle obtained from either DLL to the other DLL or to the `.EXE`. + +If DLL A allocates a block of memory with `malloc()`, only DLL A may call `free()`, `_expand()`, or `realloc()` to operate on that block. You cannot call `malloc()` from DLL A and try to free that block from the `.EXE` or from DLL B. + +> [!NOTE] +> If all three modules were linked with `CRTDLL.LIB` or all three were linked with `MSVCRT.LIB`, these restrictions would not apply. + +When linking DLLs with `LIBC.LIB`, be aware that if there is a possibility that such a DLL will be called by a multithreaded program, the DLL will not support multiple threads running in the DLL at the same time, which can cause major problems. If there is a possibility that the DLL will be called by multithreaded programs, be sure to link it with one of the libraries that support multithreaded programs (`LIBCMT.LIB`, `CRTDLL.LIB`, or `MSVCRT.LIB`). + ## See also [C runtime library reference](./c-run-time-library-reference.md)\ From 8ee52037e3787984f998857442a501e1112a7aac Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 4 Feb 2026 16:41:56 -0800 Subject: [PATCH 1600/1799] add missing section --- docs/c-runtime-library/crt-library-features.md | 8 ++++++++ docs/standard-library/add-const-class.md | 1 - 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/c-runtime-library/crt-library-features.md b/docs/c-runtime-library/crt-library-features.md index 9272de5f709..8795fdd9b27 100644 --- a/docs/c-runtime-library/crt-library-features.md +++ b/docs/c-runtime-library/crt-library-features.md @@ -106,6 +106,14 @@ Be careful if your program passes certain CRT resources across DLL boundaries. R ### Problems with statically linked CRT libraries +There are three forms of the C Run-time library provided with the Win32 SDK: + +- `LIBC.LIB` is a statically linked library for single-threaded programs. +- `LIBCMT.LIB` is a statically linked library that supports multithreaded programs. +- `CRTDLL.LIB` is an import library for `CRTDLL.DLL` that also supports multithreaded programs. `CRTDLL.DLL` is part of Windows NT. + +Microsoft Visual C++ 32-bit edition contains these three forms as well, however, the CRT in a DLL is named `MSVCRT.LIB`. The DLL is redistributable. Its name depends on the version of VC++ (that is, `MSVCRT10.DLL` or `MSVCRT20.DLL`). Note however, that `MSVCRT10.DLL` is not supported on Win32s, while `CRTDLL.LIB` is supported on Win32s. `MSVCRT20.DLL` comes in two versions: one for Windows NT and the other for Win32s. + If an application that makes C runtime calls links to a DLL that also makes C runtime calls, be aware that if they are both linked with one of the statically linked C runtime libraries, the `.EXE` and DLL will have separate copies of all C runtime functions and global variables. This means that C runtime data cannot be shared between the `.EXE` and the DLL. Some of the problems that can occur are: - Passing buffered stream handles from the .EXE/DLL to the other module diff --git a/docs/standard-library/add-const-class.md b/docs/standard-library/add-const-class.md index cc0af88c6f9..fcc0b07a48d 100644 --- a/docs/standard-library/add-const-class.md +++ b/docs/standard-library/add-const-class.md @@ -1,5 +1,4 @@ --- -description: "Learn more about: add_const Class" title: "add_const Class" ms.date: "11/04/2016" f1_keywords: ["type_traits/std::add_const"] From 135909dbc31ebf8d1e126cad9395b2a892f80b42 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 4 Feb 2026 16:49:45 -0800 Subject: [PATCH 1601/1799] restore prev version --- docs/standard-library/add-const-class.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/standard-library/add-const-class.md b/docs/standard-library/add-const-class.md index fcc0b07a48d..cc0af88c6f9 100644 --- a/docs/standard-library/add-const-class.md +++ b/docs/standard-library/add-const-class.md @@ -1,4 +1,5 @@ --- +description: "Learn more about: add_const Class" title: "add_const Class" ms.date: "11/04/2016" f1_keywords: ["type_traits/std::add_const"] From 08108a8c1354963182c02887a7e2c3373c59f27c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 4 Feb 2026 17:30:49 -0800 Subject: [PATCH 1602/1799] link and acrolinx fixes --- docs/build/run-time-library-behavior.md | 44 ++++++++++++------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/build/run-time-library-behavior.md b/docs/build/run-time-library-behavior.md index 8b772a5e6b5..fbf4bc4c786 100644 --- a/docs/build/run-time-library-behavior.md +++ b/docs/build/run-time-library-behavior.md @@ -7,24 +7,24 @@ helpviewer_keywords: ["DLLs [C++], entry point function", "process detach [C++]" --- # DLLs and Visual C++ runtime library behavior -When you build a Dynamic-link Library (DLL) by using Visual Studio, by default, the linker includes the Visual C++ runtime library (VCRuntime). The VCRuntime contains code required to initialize and terminate a C/C++ executable. When linked into a DLL, the VCRuntime code provides an internal DLL entry-point function called `_DllMainCRTStartup` that handles Windows OS messages to the DLL to attach to or detach from a process or thread. The `_DllMainCRTStartup` function performs essential tasks such as stack buffer security set up, C runtime library (CRT) initialization and termination, and calls to constructors and destructors for static and global objects. `_DllMainCRTStartup` also calls hook functions for other libraries such as WinRT, MFC, and ATL to perform their own initialization and termination. Without this initialization, the CRT and other libraries, as well as your static variables, would be left in an uninitialized state. The same VCRuntime internal initialization and termination routines are called whether your DLL uses a statically linked CRT or a dynamically linked CRT DLL. +When you build a Dynamic-link Library (DLL) by using Visual Studio, by default, the linker includes the Visual C++ runtime library (VCRuntime). The VCRuntime contains code required to initialize and terminate a C/C++ executable. When linked into a DLL, the VCRuntime code provides an internal DLL entry-point function called `_DllMainCRTStartup` that handles Windows OS messages to the DLL to attach to or detach from a process or thread. The `_DllMainCRTStartup` function performs essential tasks such as stack buffer security setup, C runtime library (CRT) initialization and termination, and calls to constructors and destructors for static and global objects. `_DllMainCRTStartup` also calls hook functions for other libraries such as WinRT, MFC, and ATL to perform their own initialization and termination. Without this initialization, the CRT and other libraries, and your static variables, would be left in an uninitialized state. The same VCRuntime internal initialization and termination routines are called whether your DLL uses a statically linked CRT or a dynamically linked CRT DLL. ## Default DLL entry point _DllMainCRTStartup -In Windows, all DLLs can contain an optional entry-point function, usually called `DllMain`, that is called for both initialization and termination. This gives you an opportunity to allocate or release additional resources as needed. Windows calls the entry-point function in four situations: process attach, process detach, thread attach, and thread detach. When a DLL is loaded into a process address space, either when an application that uses it is loaded, or when the application requests the DLL at runtime, the operating system creates a separate copy of the DLL data. This is called *process attach*. *Thread attach* occurs when the process the DLL is loaded in creates a new thread. *Thread detach* occurs when the thread terminates, and *process detach* is when the DLL is no longer required and is released by an application. The operating system makes a separate call to the DLL entry point for each of these events, passing a *reason* argument for each event type. For example, the OS sends `DLL_PROCESS_ATTACH` as the *reason* argument to signal process attach. +In Windows, all DLLs can contain an optional entry-point function, usually called `DllMain`, that is called for both initialization and termination. This gives you an opportunity to allocate or release other resources as needed. Windows calls the entry-point function in four situations: process attach, process detach, thread attach, and thread detach. When a DLL is loaded into a process address space, either when an application that uses it is loaded, or when the application requests the DLL at runtime, the operating system creates a separate copy of the DLL data. This is called *process attach*. *Thread attach* occurs when the process the DLL is loaded in creates a new thread. *Thread detach* occurs when the thread terminates, and *process detach* is when the DLL is no longer required and is released by an application. The operating system makes a separate call to the DLL entry point for each of these events, passing a *reason* argument for each event type. For example, the OS sends `DLL_PROCESS_ATTACH` as the *reason* argument to signal process attach. -The VCRuntime library provides an entry-point function called `_DllMainCRTStartup` to handle default initialization and termination operations. On process attach, the `_DllMainCRTStartup` function sets up buffer security checks, initializes the CRT and other libraries, initializes runtime type information, initializes and calls constructors for static and non-local data, initializes thread-local storage, increments an internal static counter for each attach, and then calls a user- or library-supplied `DllMain`. On process detach, the function goes through these steps in reverse. It calls `DllMain`, decrements the internal counter, calls destructors, calls CRT termination functions and registered `atexit` functions, and notifies any other libraries of termination. When the attachment counter goes to zero, the function returns `FALSE` to indicate to Windows that the DLL can be unloaded. The `_DllMainCRTStartup` function is also called during thread attach and thread detach. In these cases, the VCRuntime code does no additional initialization or termination on its own, and just calls `DllMain` to pass the message along. If `DllMain` returns `FALSE` from process attach, signaling failure, `_DllMainCRTStartup` calls `DllMain` again and passes `DLL_PROCESS_DETACH` as the *reason* argument, then goes through the rest of the termination process. +The VCRuntime library provides an entry-point function called `_DllMainCRTStartup` to handle default initialization and termination operations. On process attach, the `_DllMainCRTStartup` function sets up buffer security checks, initializes the CRT and other libraries, initializes runtime type information, initializes and calls constructors for static and nonlocal data, initializes thread-local storage, increments an internal static counter for each attach, and then calls a user- or library-supplied `DllMain`. On process detach, the function goes through these steps in reverse. It calls `DllMain`, decrements the internal counter, calls destructors, calls CRT termination functions and registered `atexit` functions, and notifies any other libraries of termination. When the attachment counter goes to zero, the function returns `FALSE` to indicate to Windows that the DLL can be unloaded. The `_DllMainCRTStartup` function is also called during thread attach and thread detach. In these cases, the VCRuntime code does no other initialization or termination on its own, and just calls `DllMain` to pass the message along. If `DllMain` returns `FALSE` from process attach, signaling failure, `_DllMainCRTStartup` calls `DllMain` again and passes `DLL_PROCESS_DETACH` as the *reason* argument, then goes through the rest of the termination process. -When building DLLs in Visual Studio, the default entry point `_DllMainCRTStartup` supplied by VCRuntime is linked in automatically. You do not need to specify an entry-point function for your DLL by using the [`/ENTRY` (Entry point symbol)](reference`/ENTRY`-entry-point-symbol.md) linker option. +When building DLLs in Visual Studio, the default entry point `_DllMainCRTStartup` supplied by VCRuntime is linked in automatically. You don't need to specify an entry-point function for your DLL by using the [`/ENTRY` (Entry point symbol)](reference/entry-entry-point-symbol.md) linker option. > [!NOTE] -> While it is possible to specify another entry-point function for a DLL by using the `/ENTRY`: linker option, we do not recommend it, because your entry-point function would have to duplicate everything that `_DllMainCRTStartup` does, in the same order. The VCRuntime provides functions that allow you to duplicate its behavior. For example, you can call [__security_init_cookie](../c-runtime-library/reference/security-init-cookie.md) immediately on process attach to support the [/GS (Buffer security check)](reference/gs-buffer-security-check.md) buffer checking option. You can call the `_CRT_INIT` function, passing the same parameters as the entry point function, to perform the rest of the DLL initialization or termination functions. +> While it's possible to specify another entry-point function for a DLL by using the `/ENTRY`: linker option, we don't recommend it, because your entry-point function would have to duplicate everything that `_DllMainCRTStartup` does, in the same order. The VCRuntime provides functions that allow you to duplicate its behavior. For example, you can call [__security_init_cookie](../c-runtime-library/reference/security-init-cookie.md) immediately on process attach to support the [/GS (Buffer security check)](reference/gs-buffer-security-check.md) buffer checking option. You can call the `_CRT_INIT` function, passing the same parameters as the entry point function, to perform the rest of the DLL initialization or termination functions. ## Initialize a DLL -Your DLL may have initialization code that must execute when your DLL loads. In order for you to perform your own DLL initialization and termination functions, `_DllMainCRTStartup` calls a function called `DllMain` that you can provide. Your `DllMain` must have the signature required for a DLL entry point. The default entry point function `_DllMainCRTStartup` calls `DllMain` using the same parameters passed by Windows. By default, if you do not provide a `DllMain` function, Visual Studio provides one for you and links it in so that `_DllMainCRTStartup` always has something to call. This means that if you do not need to initialize your DLL, there is nothing special you have to do when building your DLL. +Your DLL may have initialization code that must execute when your DLL loads. In order for you to perform your own DLL initialization and termination functions, `_DllMainCRTStartup` calls a function called `DllMain` that you can provide. Your `DllMain` must have the signature required for a DLL entry point. The default entry point function `_DllMainCRTStartup` calls `DllMain` using the same parameters passed by Windows. By default, if you don't provide a `DllMain` function, Visual Studio provides one for you and links it in so that `_DllMainCRTStartup` always has something to call. This means that if you don't need to initialize your DLL, there's nothing special you have to do when building your DLL. This is the signature used for `DllMain`: @@ -37,10 +37,10 @@ extern "C" BOOL WINAPI DllMain ( LPVOID const reserved); // reserved ``` -Some libraries wrap the `DllMain` function for you. For example, in a regular MFC DLL, implement the `CWinApp` object's `InitInstance` and `ExitInstance` member functions to perform initialization and termination required by your DLL. For more details, see the [Initialize regular MFC DLLs](#initializing-regular-dlls) section. +Some libraries wrap the `DllMain` function for you. For example, in a regular MFC DLL, implement the `CWinApp` object's `InitInstance` and `ExitInstance` member functions to perform initialization and termination required by your DLL. For more information, see the [Initialize regular MFC DLLs](#initializing-regular-dlls) section. > [!WARNING] -> There are significant limits on what you can safely do in a DLL entry point. For more information about specific Windows APIs that are unsafe to call in `DllMain`, see [General Best Practices](/windows/win32/Dlls/dynamic-link-library-best-practices). If you need anything but the simplest initialization then do that in an initialization function for the DLL. You can require applications to call the initialization function after `DllMain` has run and before they call any other functions in the DLL. +> There are significant limits on what you can safely do in a DLL entry point. For more information about specific Windows APIs that are unsafe to call in `DllMain`, see [General Best Practices](/windows/win32/Dlls/dynamic-link-library-best-practices). If you need anything but the simplest initialization, then do that in an initialization function for the DLL. You can require applications to call the initialization function after `DllMain` has run and before they call any other functions in the DLL. @@ -81,7 +81,7 @@ extern "C" BOOL WINAPI DllMain ( ``` > [!NOTE] -> Older Windows SDK documentation says that the actual name of the DLL entry-point function must be specified on the linker command-line with the `/ENTRY` option. With Visual Studio, you do not need to use the `/ENTRY` option if the name of your entry-point function is `DllMain`. In fact, if you use the `/ENTRY` option and name your entry-point function something other than `DllMain`, the CRT does not get initialized properly unless your entry-point function makes the same initialization calls that `_DllMainCRTStartup` makes. +> Older Windows SDK documentation says that the actual name of the DLL entry-point function must be specified on the linker command-line with the `/ENTRY` option. With Visual Studio, you don't need to use the `/ENTRY` option if the name of your entry-point function is `DllMain`. In fact, if you use the `/ENTRY` option and name your entry-point function something other than `DllMain`, the CRT does not get initialized properly unless your entry-point function makes the same initialization calls that `_DllMainCRTStartup` makes. ### Manual CRT initialization with `_CRT_INIT` @@ -92,11 +92,11 @@ When building a DLL that uses any of the C runtime libraries, in order to ensure This permits the C runtime libraries to properly allocate and initialize C runtime data when a process or thread is attaching to the DLL, to properly clean up C runtime data when a process is detaching from the DLL, and for global C++ objects in the DLL to be properly constructed and destructed. -The Win32 SDK samples all use the first method. Refer to the Win32 Programmer's Reference for `DllEntryPoint()` and the Visual C++ documentation for `DllMain()`. Note that `DllMainCRTStartup()` calls `_CRT_INIT()` and `_CRT_INIT()` will call your application's `DllMain()`, if it exists. +The Win32 SDK samples all use the first method. Refer to the Win32 Programmer's Reference for `DllEntryPoint()` and the Visual C++ documentation for `DllMain()`. `DllMainCRTStartup()` calls `_CRT_INIT()` and `_CRT_INIT()` calls your application's `DllMain()`, if it exists. If you wish to use the second method and call the CRT initialization code yourself, instead of using `DllMainCRTStartup()` and `DllMain()`, there are two techniques: -1. If there is no entry function that performs initialization code, specify `_CRT_INIT()` as the entry point of the DLL. Assuming that you've included `NTWIN32.MAK`, which defines `DLLENTRY` as `@12`, add the option to the DLL's link line: `-entry:_CRT_INIT$(DLLENTRY)`. +1. If there's no entry function that performs initialization code, specify `_CRT_INIT()` as the entry point of the DLL. Assuming that you've included `NTWIN32.MAK`, which defines `DLLENTRY` as `@12`, add the option to the DLL's link line: `-entry:_CRT_INIT$(DLLENTRY)`. 1. If you do have your own DLL entry point, do the following in the entry point: a. Use this prototype for `_CRT_INIT()`: `BOOL WINAPI _CRT_INIT(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpReserved);` @@ -109,7 +109,7 @@ If you wish to use the second method and call the CRT initialization code yourse d. On `DLL_PROCESS_DETACH` and `DLL_THREAD_DETACH`, call `_CRT_INIT()` last, after all C runtime functions have been called and all floating-point operations are completed. -Be sure to pass on to `_CRT_INIT()` all of the parameters of the entry point; `_CRT_INIT()` expects those parameters, so things may not work reliably if they are omitted (in particular, `fdwReason` is required to determine whether process initialization or termination is needed). +Be sure to pass on to `_CRT_INIT()` all of the parameters of the entry point; `_CRT_INIT()` expects those parameters, so things may not work reliably if they're omitted (in particular, `fdwReason` is required to determine whether process initialization or termination is needed). Below is a skeleton sample entry point function that shows when and how to make these calls to `_CRT_INIT()` in the DLL entry point: @@ -129,11 +129,11 @@ BOOL WINAPI DllEntryPoint(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpReserved ``` > [!NOTE] -> This is not necessary if you are using `DllMain()` and `-entry:_DllMainCRTStartup@12`. +> This isn't necessary if you're using `DllMain()` and `-entry:_DllMainCRTStartup@12`. ### Using NTWIN32.MAK to simplify the build process -There are macros defined in `NTWIN32.MAK` that can be used to simplify your makefiles and to ensure that they are properly built to avoid conflicts. For this reason, Microsoft highly recommends using `NTWIN32.MAK `and its macros. +There are macros defined in `NTWIN32.MAK` that can be used to simplify your makefiles and to ensure that they're properly built to avoid conflicts. For this reason, Microsoft highly recommends using `NTWIN32.MAK `and its macros. For compilation, use: `$(cvarsdll)` for apps/DLLs using CRT in a DLL. @@ -146,11 +146,11 @@ For linking, use one of the following: ### Initialize regular MFC DLLs -Because regular MFC DLLs have a `CWinApp` object, they should perform their initialization and termination tasks in the same location as an MFC application: in the `InitInstance` and `ExitInstance` member functions of the DLL's `CWinApp`-derived class. Because MFC provides a `DllMain` function that is called by `_DllMainCRTStartup` for `DLL_PROCESS_ATTACH` and `DLL_PROCESS_DETACH`, you should not write your own `DllMain` function. The MFC-provided `DllMain` function calls `InitInstance` when your DLL is loaded and it calls `ExitInstance` before the DLL is unloaded. +Because regular MFC DLLs have a `CWinApp` object, they should perform their initialization and termination tasks in the same location as an MFC application: in the `InitInstance` and `ExitInstance` member functions of the DLL's `CWinApp`-derived class. Because MFC provides a `DllMain` function that is called by `_DllMainCRTStartup` for `DLL_PROCESS_ATTACH` and `DLL_PROCESS_DETACH`, you shouldn't write your own `DllMain` function. The MFC-provided `DllMain` function calls `InitInstance` when your DLL is loaded and it calls `ExitInstance` before the DLL is unloaded. A regular MFC DLL can keep track of multiple threads by calling [TlsAlloc](/windows/win32/api/processthreadsapi/nf-processthreadsapi-tlsalloc) and [TlsGetValue](/windows/win32/api/processthreadsapi/nf-processthreadsapi-tlsgetvalue) in its `InitInstance` function. These functions allow the DLL to track thread-specific data. -In your regular MFC DLL that dynamically links to MFC, if you are using any MFC OLE, MFC Database (or DAO), or MFC Sockets support, respectively, the debug MFC extension DLLs MFCO*version*D.dll, MFCD*version*D.dll, and MFCN*version*D.dll (where *version* is the version number) are linked in automatically. You must call one of the following predefined initialization functions for each of these DLLs that you are using in your regular MFC DLL's `CWinApp::InitInstance`. +In your regular MFC DLL that dynamically links to MFC, if you're using any MFC OLE, MFC Database (or DAO), or MFC Sockets support, respectively, the debug MFC extension DLLs MFCO*version*D.dll, MFCD*version*D.dll, and MFCN*version*D.dll (where *version* is the version number) are linked in automatically. You must call one of the following predefined initialization functions for each of these DLLs that you're using in your regular MFC DLL's `CWinApp::InitInstance`. |Type of MFC support|Initialization function to call| |-------------------------|-------------------------------------| @@ -162,7 +162,7 @@ In your regular MFC DLL that dynamically links to MFC, if you are using any MFC ### Initialize MFC extension DLLs -Because MFC extension DLLs do not have a `CWinApp`-derived object (as do regular MFC DLLs), you should add your initialization and termination code to the `DllMain` function that the MFC DLL Wizard generates. +Because MFC extension DLLs don't have a `CWinApp`-derived object (as do regular MFC DLLs), you should add your initialization and termination code to the `DllMain` function that the MFC DLL Wizard generates. The wizard provides the following code for MFC extension DLLs. In the code, `PROJNAME` is a placeholder for the name of your project. @@ -201,11 +201,11 @@ DllMain(HINSTANCE hInstance, DWORD dwReason, LPVOID lpReserved) Creating a new `CDynLinkLibrary` object during initialization allows the MFC extension DLL to export `CRuntimeClass` objects or resources to the client application. -If you are going to use your MFC extension DLL from one or more regular MFC DLLs, you must export an initialization function that creates a `CDynLinkLibrary` object. That function must be called from each of the regular MFC DLLs that use the MFC extension DLL. An appropriate place to call this initialization function is in the `InitInstance` member function of the regular MFC DLL's `CWinApp`-derived object before using any of the MFC extension DLL's exported classes or functions. +If you're going to use your MFC extension DLL from one or more regular MFC DLLs, you must export an initialization function that creates a `CDynLinkLibrary` object. That function must be called from each of the regular MFC DLLs that use the MFC extension DLL. An appropriate place to call this initialization function is in the `InitInstance` member function of the regular MFC DLL's `CWinApp`-derived object before using any of the MFC extension DLL's exported classes or functions. -In the `DllMain` that the MFC DLL Wizard generates, the call to `AfxInitExtensionModule` captures the module's runtime classes (`CRuntimeClass` structures) as well as its object factories (`COleObjectFactory` objects) for use when the `CDynLinkLibrary` object is created. You should check the return value of `AfxInitExtensionModule`; if a zero value is returned from `AfxInitExtensionModule`, return zero from your `DllMain` function. +In the `DllMain` that the MFC DLL Wizard generates, the call to `AfxInitExtensionModule` captures the module's runtime classes (`CRuntimeClass` structures) and its object factories (`COleObjectFactory` objects) for use when the `CDynLinkLibrary` object is created. You should check the return value of `AfxInitExtensionModule`; if a zero value is returned from `AfxInitExtensionModule`, return zero from your `DllMain` function. -If your MFC extension DLL will be explicitly linked to an executable (meaning the executable calls `AfxLoadLibrary` to link to the DLL), you should add a call to `AfxTermExtensionModule` on `DLL_PROCESS_DETACH`. This function allows MFC to clean up the MFC extension DLL when each process detaches from the MFC extension DLL (which happens when the process exits or when the DLL is unloaded as a result of a `AfxFreeLibrary` call). If your MFC extension DLL will be linked implicitly to the application, the call to `AfxTermExtensionModule` is not necessary. +If your MFC extension DLL is explicitly linked to an executable (meaning the executable calls `AfxLoadLibrary` to link to the DLL), you should add a call to `AfxTermExtensionModule` on `DLL_PROCESS_DETACH`. This function allows MFC to clean up the MFC extension DLL when each process detaches from the MFC extension DLL (which happens when the process exits or when the DLL is unloaded as a result of a `AfxFreeLibrary` call). If your MFC extension DLL is linked implicitly to the application, the call to `AfxTermExtensionModule` isn't necessary. Applications that explicitly link to MFC extension DLLs must call `AfxTermExtensionModule` when freeing the DLL. They should also use `AfxLoadLibrary` and `AfxFreeLibrary` (instead of the Win32 functions `LoadLibrary` and `FreeLibrary`) if the application uses multiple threads. Using `AfxLoadLibrary` and `AfxFreeLibrary` ensures that the startup and shutdown code that executes when the MFC extension DLL is loaded and unloaded does not corrupt the global MFC state. @@ -213,10 +213,10 @@ Because the MFCx0.dll is fully initialized by the time `DllMain` is called, you Extension DLLs can take care of multithreading by handling the `DLL_THREAD_ATTACH` and `DLL_THREAD_DETACH` cases in the `DllMain` function. These cases are passed to `DllMain` when threads attach and detach from the DLL. Calling [TlsAlloc](/windows/win32/api/processthreadsapi/nf-processthreadsapi-tlsalloc) when a DLL is attaching allows the DLL to maintain thread local storage (TLS) indexes for every thread attached to the DLL. -Note that the header file Afxdllx.h contains special definitions for structures used in MFC extension DLLs, such as the definition for `AFX_EXTENSION_MODULE` and `CDynLinkLibrary`. You should include this header file in your MFC extension DLL. +The header file `Afxdllx.h` contains special definitions for structures used in MFC extension DLLs, such as the definition for `AFX_EXTENSION_MODULE` and `CDynLinkLibrary`. You should include this header file in your MFC extension DLL. > [!NOTE] -> It is important that you neither define nor undefine any of the `_AFX_NO_XXX` macros in *pch.h* (*stdafx.h* in Visual Studio 2017 and earlier). These macros exist only for the purpose of checking whether a particular target platform supports that feature or not. You can write your program to check these macros (for example, `#ifndef _AFX_NO_OLE_SUPPORT`), but your program should never define or undefine these macros. +> It's important that you neither define nor undefine any of the `_AFX_NO_XXX` macros in *pch.h* (*stdafx.h* in Visual Studio 2017 and earlier). These macros exist only to check whether a particular target platform supports that feature or not. You can write your program to check these macros (for example, `#ifndef _AFX_NO_OLE_SUPPORT`), but your program should never define or undefine these macros. A sample initialization function that handles multithreading is included in [Using Thread Local Storage in a Dynamic-Link Library](/windows/win32/Dlls/using-thread-local-storage-in-a-dynamic-link-library) in the Windows SDK. Note that the sample contains an entry-point function called `LibMain`, but you should name this function `DllMain` so that it works with the MFC and C runtime libraries. From 36c7f47ef1feac7e798966bc40277da79e895e86 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 5 Feb 2026 11:22:12 -0800 Subject: [PATCH 1603/1799] update alt-text --- docs/porting/copilot-app-modernization-cpp.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/porting/copilot-app-modernization-cpp.md b/docs/porting/copilot-app-modernization-cpp.md index baf39363b46..dcd24ad1831 100644 --- a/docs/porting/copilot-app-modernization-cpp.md +++ b/docs/porting/copilot-app-modernization-cpp.md @@ -29,7 +29,7 @@ GitHub Copilot app modernization for C++ is enabled by default. To disable or ex 1. Select (to enable) or clear (to disable) the checkbox for **Enable GitHub Copilot app modernization for C++ (preview)**. 1. Restart Visual Studio for the setting change to take effect. -![Screenshot of the settings to enable GitHub Copilot app modernization for C++.](media/enable-copilot-app-modernization-cpp.png "enable GitHub Copilot app modernization for C++") +:::image type="content" source="media/enable-copilot-app-modernization-cpp.png" alt-text="Screenshot of Visual Studio Options dialog. GitHub > Copilot > C/C++ settings are visible. The app modernization for C++ checkbox is enabled."::: ## Upgrade your codebase by using GitHub Copilot app modernization for C++ @@ -41,7 +41,7 @@ GitHub Copilot app modernization is an agent that operates inside the GitHub Cop - **From the Solution Explorer context menu**: Right-click on the solution or a loaded project in the Solution Explorer, and choose **Modernize** from the context menu. This automatically launches a GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. -![Screenshot of the context menu to start GitHub Copilot app modernization.](media/copilot-app-modernization-context-menu.png "Start GitHub Copilot app modernization") +:::image type="content" source="media/copilot-app-modernization-context-menu.png" alt-text="Screenshot of Visual Studio Solution Explorer showing a right-click context menu with Modernize selected to start the Copilot agent."::: - **From GitHub Copilot Chat**: Open the GitHub Copilot Chat Window by selecting **View > GitHub Copilot Chat**. After the GitHub Copilot Chat window opens, mention `@Modernize` in a prompt to activate the Modernize agent. For example, type this prompt: @@ -70,12 +70,12 @@ Once the Modernize agent is active, you can instruct it via a prompt to upgrade :::row::: :::column::: -![Screenshot of GitHub Copilot app modernization window with MSVC upgrade ice breaker for an MSBuild project.](media/app-modernization-msbuild-ice-breaker.png "GitHub Copilot app modernization window") +:::image type="content" source="media/app-modernization-msbuild-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to App Modernization experience and Upgrade MSVC Build Tools to the latest version is highlighted."::: :::column-end::: :::column::: -![Screenshot of GitHub Copilot app modernization window with MSVC upgrade ice breaker for a CMake project.](media/app-modernization-cmake-ice-breaker.png "GitHub Copilot app modernization window") +:::image type="content" source="media/app-modernization-cmake-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to App Modernization experience and Resolve build issues by migrating to modern alternatives is highlighted"::: :::column-end::: :::row-end::: From 2d7776b215648f9f6488f2291422e46fcbea38e3 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 5 Feb 2026 11:25:15 -0800 Subject: [PATCH 1604/1799] acrolinx --- docs/porting/copilot-app-modernization-cpp.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/porting/copilot-app-modernization-cpp.md b/docs/porting/copilot-app-modernization-cpp.md index dcd24ad1831..24148ed7020 100644 --- a/docs/porting/copilot-app-modernization-cpp.md +++ b/docs/porting/copilot-app-modernization-cpp.md @@ -53,7 +53,7 @@ The first time that you load a `.vcxproj` project that targets an earlier versio ### Start the upgrade -Once the Modernize agent is active, you can instruct it via a prompt to upgrade your MSVC Build Tools, or select the already constructed prompt from the list shown in the window. If you launched the agent directly in the GitHub Copilot Chat window by mentioning @Modernize in your prompt, you probably don't need to provide any additional prompting. +Once the Modernize agent is active, you can instruct it via a prompt to upgrade your MSVC Build Tools, or select the already constructed prompt from the list shown in the window. If you launched the agent directly in the GitHub Copilot Chat window by mentioning `@Modernize` in your prompt, you probably don't need to provide more prompting. :::row::: :::column::: @@ -83,13 +83,13 @@ Once the Modernize agent is active, you can instruct it via a prompt to upgrade ### Assessment stage -The agent first assesses what kinds of problems show up after upgrading. If you didn't already upgrade the project, the agent guides you through that process before creating its assessment. After ensuring that your project is upgraded, the agent builds your codebase, analyzes the reported warnings and errors, and generates an `assessment.md` file that describes the problems that it found, their severity, and other useful information. This is your opportunity to tell the agent any additional context that could help it make a plan. +The agent first assesses what kinds of problems show up after upgrading. If you didn't already upgrade the project, the agent guides you through that process before creating its assessment. After ensuring that your project is upgraded, the agent builds your codebase, analyzes the reported warnings and errors, and generates an `assessment.md` file that describes the problems that it found, their severity, and other useful information. This is your opportunity to tell the agent any other context that could help it make a plan. -One of the things you might choose to do here is to tell the agent not to fix certain discovered problems, because you know that resolving them involves some strategic decisions or because they were preexisting warnings that you decided are acceptable for your project. You should carefully read through the plan, making sure to provide that additional context where it is needed. Once you approve the assessment, the agent moves on to creating a concrete plan on addressing the problems. +One of the things you might choose to do here is to tell the agent not to fix certain discovered problems, because you know that resolving them involves some strategic decisions or because they were preexisting warnings that you decided are acceptable for your project. You should carefully read through the plan, making sure to provide that extra context where it is needed. Once you approve the assessment, the agent moves on to creating a concrete plan on addressing the problems. ### Planning stage -Based on the approved assessment and any additional context or instructions you provide, the agent creates a `plan.md` file that proposes a detailed plan for resolving each of the identified problems. If the agent produces a plan that doesn't match your organization's coding style or practices, you can provide that guidance to the agent and have it solve the problem differently. After you agree on the plan, the agent moves to the execution stage. +Based on the approved assessment and any other context or instructions you provide, the agent creates a `plan.md` file that proposes a detailed plan for resolving each of the identified problems. If the agent produces a plan that doesn't match your organization's coding style or practices, you can provide that guidance to the agent and have it solve the problem differently. After you agree on the plan, the agent moves to the execution stage. ### Execution stage From 8c9accdaa6d2532bfc73c61bebb8ffc00479755d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 5 Feb 2026 11:26:41 -0800 Subject: [PATCH 1605/1799] fix link --- docs/porting/copilot-app-modernization-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/porting/copilot-app-modernization-cpp.md b/docs/porting/copilot-app-modernization-cpp.md index 24148ed7020..9d8ab2b609b 100644 --- a/docs/porting/copilot-app-modernization-cpp.md +++ b/docs/porting/copilot-app-modernization-cpp.md @@ -49,7 +49,7 @@ GitHub Copilot app modernization is an agent that operates inside the GitHub Cop #### For MSBuild-based codebases targeting an earlier version of MSVC Build Tools -The first time that you load a `.vcxproj` project that targets an earlier version of the MSVC Build Tools, you see an option to [upgrade project settings to use a newer version of the MSVC Build Tools](https://learn.microsoft.com/visualstudio/install/setup-assistant). If you retarget any of your projects to a new version of MSVC Build Tools and GitHub Copilot app modernization for C++ is enabled, you receive an infobar in Visual Studio prompting you to use GitHub Copilot app modernization for C++ to resolve any newly introduced build problems. Selecting **Run GitHub Copilot app modernization for C++** launches the GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. +The first time that you load a `.vcxproj` project that targets an earlier version of the MSVC Build Tools, you see an option to [upgrade project settings to use a newer version of the MSVC Build Tools](/visualstudio/install/setup-assistant). If you retarget any of your projects to a new version of MSVC Build Tools and GitHub Copilot app modernization for C++ is enabled, you receive an infobar in Visual Studio prompting you to use GitHub Copilot app modernization for C++ to resolve any newly introduced build problems. Selecting **Run GitHub Copilot app modernization for C++** launches the GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. ### Start the upgrade From 142991a57ce19bf9e048e84c793b5b7465ecf206 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 5 Feb 2026 11:39:20 -0800 Subject: [PATCH 1606/1799] address customer issue --- docs/cpp/inline-functions-cpp.md | 42 +++++++++++++++++++++++++++++--- 1 file changed, 38 insertions(+), 4 deletions(-) diff --git a/docs/cpp/inline-functions-cpp.md b/docs/cpp/inline-functions-cpp.md index edfd41def2e..ebe06cadee4 100644 --- a/docs/cpp/inline-functions-cpp.md +++ b/docs/cpp/inline-functions-cpp.md @@ -1,7 +1,7 @@ --- title: "Inline Functions (C++)" description: "The C++ inline keyword can be used to suggest inline functions to the compiler." -ms.date: 12/07/2023 +ms.date: 02/05/2026 f1_keywords: ["__forceinline_cpp", "__inline_cpp", "inline_cpp", "__inline", "_inline", "__forceinline", "_forceinline"] helpviewer_keywords: ["inline functions [C++], class members"] --- @@ -13,11 +13,45 @@ In theory, using inline functions can make your program faster because they elim Inline code substitution is done at the compiler's discretion. For example, the compiler won't inline a function if its address is taken or if the compiler decides it's too large. -A function defined in the body of a class declaration is implicitly an inline function. +## The `inline` keyword and the One Definition Rule (ODR) -## Example +The original meaning of **`inline`** is a hint to the compiler to prefer code expansion at the call site over function call instructions. This remains one of the meanings of **`inline`**. -In the following class declaration, the `Account` constructor is an inline function because it is defined in the body of the class declaration. The member functions `GetBalance`, `Deposit`, and `Withdraw` are specified `inline` in their definitions. The `inline` keyword is optional in the function declarations in the class declaration. +However, the **`inline`** keyword also has implications for the One Definition Rule (ODR). Normally, a function can only be defined once across all translation units. When a function is marked **`inline`**, it can be defined in multiple translation units (typically via a header file), provided that all definitions are identical. The linker then selects one definition and discards the duplicates rather than reporting an error. + +This dual nature of **`inline`**—as both an optimization hint and an ODR mechanism—can cause confusion. The ODR aspect is a practical necessity where the same header (containing an inline function definition) may be included in multiple source files. + +## Implicitly inline functions + +Certain functions are implicitly **`inline`** without requiring the keyword: + +- **Functions defined at class scope**: A function defined in the body of a class declaration is implicitly an inline function. This allows small accessor functions and efficient abstractions to be defined directly in class definitions without incurring function call overhead—a priority since the early days of C++. + +- **`constexpr` functions**: Functions declared **`constexpr`** (introduced in C++11) are implicitly **`inline`**. Because **`constexpr`** functions are typically defined in header files to allow compile-time evaluation, they must follow the same ODR rules as inline functions. + +- **`consteval` functions**: Functions declared **`consteval`** (introduced in C++20) are implicitly **`inline`**. + +## Inline variables (C++17) + +C++17 extended the **`inline`** keyword to variables. An **`inline`** variable can be defined in multiple translation units, and like inline functions, the linker selects one definition and discards the rest. This extension applies to the ODR aspect of **`inline`**, not the code-expansion aspect, which only applies to functions. + +Inline variables are useful for defining constants or static data members in header files: + +```cpp +// constants.h +inline constexpr double pi = 3.14159265358979323846; + +struct MyClass +{ + static inline int instanceCount = 0; // Can be defined in header +}; +``` + +Before C++17, such variables required a separate definition in a single source file to avoid linker errors. + +## Example: Inline class member functions + +In the following class declaration, the `Account` constructor is an inline function because it's defined in the body of the class declaration. The member functions `GetBalance`, `Deposit`, and `Withdraw` are specified **`inline`** in their definitions. The **`inline`** keyword is optional in the function declarations in the class declaration. ```cpp // account.h From 433722dd85f2344bb54c1a22a1dd9833625a546b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 5 Feb 2026 15:05:14 -0800 Subject: [PATCH 1607/1799] extend to include msft attributes --- docs/cpp/inline-functions-cpp.md | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/docs/cpp/inline-functions-cpp.md b/docs/cpp/inline-functions-cpp.md index ebe06cadee4..e01c3956de8 100644 --- a/docs/cpp/inline-functions-cpp.md +++ b/docs/cpp/inline-functions-cpp.md @@ -25,7 +25,7 @@ This dual nature of **`inline`**—as both an optimization hint and an ODR mecha Certain functions are implicitly **`inline`** without requiring the keyword: -- **Functions defined at class scope**: A function defined in the body of a class declaration is implicitly an inline function. This allows small accessor functions and efficient abstractions to be defined directly in class definitions without incurring function call overhead—a priority since the early days of C++. +- **Functions defined at class scope**: A function defined in the body of a class declaration is implicitly an inline function. This allows small accessor functions and to be defined directly in class definitions without incurring function call overhead—a priority since the early days of C++. - **`constexpr` functions**: Functions declared **`constexpr`** (introduced in C++11) are implicitly **`inline`**. Because **`constexpr`** functions are typically defined in header files to allow compile-time evaluation, they must follow the same ODR rules as inline functions. @@ -33,7 +33,7 @@ Certain functions are implicitly **`inline`** without requiring the keyword: ## Inline variables (C++17) -C++17 extended the **`inline`** keyword to variables. An **`inline`** variable can be defined in multiple translation units, and like inline functions, the linker selects one definition and discards the rest. This extension applies to the ODR aspect of **`inline`**, not the code-expansion aspect, which only applies to functions. +C++17 extended the **`inline`** keyword to variables. An **`inline`** variable can be defined in multiple translation units, and like inline functions, the linker selects one definition and discards the rest. Inline variables are useful for defining constants or static data members in header files: @@ -102,7 +102,7 @@ The **`inline`** and **`__inline`** specifiers suggest to the compiler that it i The insertion, called *inline expansion* or *inlining*, occurs only if the compiler's own cost-benefit analysis shows it's worthwhile. Inline expansion minimizes the function-call overhead at the potential cost of larger code size. -The **`__forceinline`** keyword overrides the cost-benefit analysis and relies on the judgment of the programmer instead. Exercise caution when using **`__forceinline`**. Indiscriminate use of **`__forceinline`** can result in larger code with only marginal performance gains or, in some cases, even performance losses (because of the increased paging of a larger executable, for example). +The **`__forceinline`** keyword (or [`[msvc::forceinline]`](/cpp/cpp/attributes#msvcforceinline) attribute) overrides the cost-benefit analysis and relies on the judgment of the programmer instead. Exercise caution when using **`__forceinline`**. Indiscriminate use of **`__forceinline`** can result in larger code with only marginal performance gains or, in some cases, even performance losses (because of the increased paging of a larger executable, for example). The compiler treats the inline expansion options and keywords as suggestions. There's no guarantee that functions will be inlined. You can't force the compiler to inline a particular function, even with the **`__forceinline`** keyword. When you compile with **`/clr`**, the compiler won't inline a function if there are security attributes applied to the function. @@ -174,6 +174,14 @@ If the compiler can't inline a function declared with **`__forceinline`**, it ge Recursive functions can be replaced with inline code to a depth specified by the [`inline_depth`](../preprocessor/inline-depth.md) pragma, up to a maximum of 16 calls. After that depth, recursive function calls are treated as calls to an instance of the function. The depth to which recursive functions are examined by the inline heuristic can't exceed 16. The [`inline_recursion`](../preprocessor/inline-recursion.md) pragma controls the inline expansion of a function currently under expansion. See the [Inline-Function Expansion](../build/reference/ob-inline-function-expansion.md) (/Ob) compiler option for related information. +The C++ Standard defines a common set of attributes. It also allows compiler vendors to define their own attributes within a vendor-specific (in our case, `msvc`) namespace. The following Microsoft-specific attributes can be used to control inlining behavior: + +[`[msvc::forceinline]`](/cpp/cpp/attributes#msvcforceinline): Has the same meaning as **`__forceinline`**.\ +[`[msvc::forceinline_calls]`](/cpp/cpp/attributes#msvcforceinline_calls): Can be placed on or before a statement or block to cause the inline heuristic to force-inline all calls in that statement or block.\ +[`[msvc::flatten]`](/cpp/cpp/attributes#msvcflatten): Similar to `[[msvc::forceinline_calls]]`, but recursively force-inlines all calls in the scope it's applied to until no calls are left.\ +[`[msvc::noinline]`](/cpp/cpp/attributes#msvcnoinline): When placed before a function declaration, has the same meaning as `__declspec(noinline)`.\ +[`[msvc::noinline_calls]`](/cpp/cpp/attributes#msvcnoinline_calls): Can be placed before any statement or block to turn off inlining for all calls in the scope it's applied to. + **END Microsoft Specific** For more information on using the **`inline`** specifier, see: @@ -306,4 +314,9 @@ In this example, the function `increment` is called twice as the expression `sqr ## See also [`noinline`](../cpp/noinline.md)\ -[`auto_inline`](../preprocessor/auto-inline.md) +[`auto_inline`](../preprocessor/auto-inline.md)\ +[`[msvc::forceinline]`](/cpp/cpp/attributes#msvcforceinline)\ +[`[msvc::forceinline_calls]`](/cpp/cpp/attributes#msvcforceinline_calls)\ +[`[msvc::flatten]`](/cpp/cpp/attributes#msvcflatten)\ +[`[msvc::nolinline]`](/cpp/cpp/attributes#msvcnoinline)\ +[`[msvc::nolinline_calls]`](/cpp/cpp/attributes#msvcnoinline_calls) \ No newline at end of file From e3b47739e6ca79fcb7f606ccd60cb2e612f28bdf Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 5 Feb 2026 15:22:11 -0800 Subject: [PATCH 1608/1799] extend to include msft attributes --- docs/cpp/inline-functions-cpp.md | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) diff --git a/docs/cpp/inline-functions-cpp.md b/docs/cpp/inline-functions-cpp.md index e01c3956de8..25b31d277fc 100644 --- a/docs/cpp/inline-functions-cpp.md +++ b/docs/cpp/inline-functions-cpp.md @@ -106,7 +106,7 @@ The **`__forceinline`** keyword (or [`[msvc::forceinline]`](/cpp/cpp/attributes# The compiler treats the inline expansion options and keywords as suggestions. There's no guarantee that functions will be inlined. You can't force the compiler to inline a particular function, even with the **`__forceinline`** keyword. When you compile with **`/clr`**, the compiler won't inline a function if there are security attributes applied to the function. -For compatibility with previous versions, **`_inline`** and **`_forceinline`** are synonyms for **`__inline`** and **`__forceinline`**, respectively, unless compiler option [`/Za` \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) is specified. +For compatibility with previous versions, **`_inline`** and **`_forceinline`** are synonyms for **`__inline`** and **`__forceinline`** (two leading underscores), respectively, unless compiler option [`/Za` \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) is specified. The **`inline`** keyword tells the compiler that inline expansion is preferred. However, the compiler can ignore it. Two cases where this behavior can happen are: @@ -176,11 +176,16 @@ Recursive functions can be replaced with inline code to a depth specified by the The C++ Standard defines a common set of attributes. It also allows compiler vendors to define their own attributes within a vendor-specific (in our case, `msvc`) namespace. The following Microsoft-specific attributes can be used to control inlining behavior: -[`[msvc::forceinline]`](/cpp/cpp/attributes#msvcforceinline): Has the same meaning as **`__forceinline`**.\ -[`[msvc::forceinline_calls]`](/cpp/cpp/attributes#msvcforceinline_calls): Can be placed on or before a statement or block to cause the inline heuristic to force-inline all calls in that statement or block.\ -[`[msvc::flatten]`](/cpp/cpp/attributes#msvcflatten): Similar to `[[msvc::forceinline_calls]]`, but recursively force-inlines all calls in the scope it's applied to until no calls are left.\ -[`[msvc::noinline]`](/cpp/cpp/attributes#msvcnoinline): When placed before a function declaration, has the same meaning as `__declspec(noinline)`.\ -[`[msvc::noinline_calls]`](/cpp/cpp/attributes#msvcnoinline_calls): Can be placed before any statement or block to turn off inlining for all calls in the scope it's applied to. +## Microsoft-specific attributes for controlling inlining behavior + + +|Attribute | Meaning | +|---------|---------| +| [`[msvc::forceinline]`](/cpp/cpp/attributes#msvcforceinline)| Has the same meaning as **`__forceinline`**.| +| [`[msvc::forceinline_calls]`](/cpp/cpp/attributes#msvcforceinline_calls) | Can be placed on or before a statement or block to cause the inline heuristic to force-inline all calls in that statement or block.| +| [`[msvc::flatten]`](/cpp/cpp/attributes#msvcflatten) | Similar to `[[msvc::forceinline_calls]]`, but recursively force-inlines all calls in the scope it's applied to until no calls are left. | +| [`[msvc::noinline]`](/cpp/cpp/attributes#msvcnoinline) | When placed before a function declaration, has the same meaning as `__declspec(noinline)`. | +| [`[msvc::noinline_calls]`](/cpp/cpp/attributes#msvcnoinline_calls) | Can be placed before any statement or block to turn off inlining for all calls in the scope it's applied to. | **END Microsoft Specific** From ab27d2ba19dfd5fa0298a66826030f2c0244496e Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 5 Feb 2026 15:30:51 -0800 Subject: [PATCH 1609/1799] acrolinx --- docs/cpp/inline-functions-cpp.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/cpp/inline-functions-cpp.md b/docs/cpp/inline-functions-cpp.md index 25b31d277fc..f67599ff01b 100644 --- a/docs/cpp/inline-functions-cpp.md +++ b/docs/cpp/inline-functions-cpp.md @@ -11,13 +11,13 @@ The **`inline`** keyword suggests that the compiler substitute the code within t In theory, using inline functions can make your program faster because they eliminate the overhead associated with function calls. Calling a function requires pushing the return address on the stack, pushing arguments onto the stack, jumping to the function body, and then executing a return instruction when the function finishes. This process is eliminated by inlining the function. The compiler also has different opportunities to optimize functions expanded inline versus those that aren't. A tradeoff of inline functions is that the overall size of your program can increase. -Inline code substitution is done at the compiler's discretion. For example, the compiler won't inline a function if its address is taken or if the compiler decides it's too large. +Inline code substitution is done at the compiler's discretion. For example, the compiler doesn't inline a function if its address is taken or if the compiler decides it's too large. ## The `inline` keyword and the One Definition Rule (ODR) The original meaning of **`inline`** is a hint to the compiler to prefer code expansion at the call site over function call instructions. This remains one of the meanings of **`inline`**. -However, the **`inline`** keyword also has implications for the One Definition Rule (ODR). Normally, a function can only be defined once across all translation units. When a function is marked **`inline`**, it can be defined in multiple translation units (typically via a header file), provided that all definitions are identical. The linker then selects one definition and discards the duplicates rather than reporting an error. +However, the **`inline`** keyword also has implications for the One Definition Rule (ODR). Normally, a function can only be defined once across all translation units. When a function is marked **`inline`**, it can be defined in multiple translation units (typically via a header file) if all the definitions are identical. The linker then selects one definition and discards the duplicates rather than reporting an error. This dual nature of **`inline`**—as both an optimization hint and an ODR mechanism—can cause confusion. The ODR aspect is a practical necessity where the same header (containing an inline function definition) may be included in multiple source files. @@ -94,7 +94,7 @@ inline double Account::Withdraw(double amount) A given inline member function must be declared the same way in every compilation unit. There must be exactly one definition of an inline function. -A class member function defaults to external linkage unless a definition for that function contains the **`inline`** specifier. The preceding example shows that you don't have to declare these functions explicitly with the **`inline`** specifier. Using **`inline`** in the function definition suggests to the compiler that it be treated as an inline function. However, you can't redeclare a function as **`inline`** after a call to that function. +A class member function defaults to external linkage unless a definition for that function contains the **`inline`** specifier. The preceding example shows that you don't have to declare these functions explicitly with the **`inline`** specifier. Using **`inline`** in the function definition suggests to the compiler to treat it as an inline function. However, you can't redeclare a function as **`inline`** after a call to that function. ## `inline`, `__inline`, and `__forceinline` @@ -178,7 +178,6 @@ The C++ Standard defines a common set of attributes. It also allows compiler ven ## Microsoft-specific attributes for controlling inlining behavior - |Attribute | Meaning | |---------|---------| | [`[msvc::forceinline]`](/cpp/cpp/attributes#msvcforceinline)| Has the same meaning as **`__forceinline`**.| @@ -275,8 +274,8 @@ int main() Here are some of the differences between the macro and the inline function: -- Macros are always expanded inline. However, an inline function is only inlined when the compiler determines it is the optimal thing to do. -- The macro may result in unexpected behavior, which can lead to subtle bugs. For example, the expression `mult1(2 + 2, 3 + 3)` expands to `2 + 2 * 3 + 3` which evaluates to 11, but the expected result is 24. A seemingly valid fix is to add parentheses around both arguments of the function macro, resulting in `#define mult2(a, b) (a) * (b)`, which will solve the issue at hand but can still cause surprising behavior when part of a larger expression. That was demonstrated in the preceding example, and the problem could be addressed by defining the macro as such `#define mult3(a, b) ((a) * (b))`. +- Macros are always expanded inline. However, an inline function is only inlined when the compiler determines it's the optimal thing to do. +- The macro may result in unexpected behavior, which can lead to subtle bugs. For example, the expression `mult1(2 + 2, 3 + 3)` expands to `2 + 2 * 3 + 3` which evaluates to 11, but the expected result is 24. A seemingly valid fix is to add parentheses around both arguments of the function macro, resulting in `#define mult2(a, b) (a) * (b)`, which solves the issue at hand but can still cause surprising behavior when part of a larger expression. That was demonstrated in the preceding example, and the problem could be addressed by defining the macro as such `#define mult3(a, b) ((a) * (b))`. - An inline function is subject to semantic processing by the compiler, whereas the preprocessor expands macros without that same benefit. Macros aren't type-safe, whereas functions are. - Expressions passed as arguments to inline functions are evaluated once. In some cases, expressions passed as arguments to macros can be evaluated more than once. For example, consider the following: From bb6f51b928313d4ab995effc69c30ba4d754c6ad Mon Sep 17 00:00:00 2001 From: Tapasya Gutta Date: Fri, 6 Feb 2026 19:53:02 +0530 Subject: [PATCH 1610/1799] Make the example about top() much more clear Updated the stack example to push the value 3 instead of 2 avoid ambiguity and modified the output messages accordingly. --- docs/standard-library/stack-class.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/standard-library/stack-class.md b/docs/standard-library/stack-class.md index 12a610f22ee..78fc4b388aa 100644 --- a/docs/standard-library/stack-class.md +++ b/docs/standard-library/stack-class.md @@ -377,7 +377,7 @@ int main( ) stack s1; s1.push( 1 ); - s1.push( 2 ); + s1.push( 3 ); int& i = s1.top( ); const int& ii = s1.top( ); @@ -385,13 +385,13 @@ int main( ) cout << "The top integer of the stack s1 is " << i << "." << endl; i--; - cout << "The next integer down is "<< ii << "." << endl; + cout << "The updated top integer is "<< ii << "." << endl; } ``` ```Output -The top integer of the stack s1 is 2. -The next integer down is 1. +The top integer of the stack s1 is 3. +The updated top integer is 2. ``` ## `value_type` From a28fef9b503e45f27d6ce14ca04b80302cb0c9fd Mon Sep 17 00:00:00 2001 From: Tapasya Gutta Date: Fri, 6 Feb 2026 21:22:29 +0530 Subject: [PATCH 1611/1799] Formatting - Add space for readability. Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/standard-library/stack-class.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard-library/stack-class.md b/docs/standard-library/stack-class.md index 78fc4b388aa..8a30a18989f 100644 --- a/docs/standard-library/stack-class.md +++ b/docs/standard-library/stack-class.md @@ -385,7 +385,7 @@ int main( ) cout << "The top integer of the stack s1 is " << i << "." << endl; i--; - cout << "The updated top integer is "<< ii << "." << endl; + cout << "The updated top integer is " << ii << "." << endl; } ``` From c445d5bd4ce615e61fc9b63eea1be2fcb56276fe Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 6 Feb 2026 17:01:22 -0800 Subject: [PATCH 1612/1799] Update command targets for Visual Studio shortcuts --- docs/build/building-on-the-command-line.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index ffc6dff0b5a..b5b12aacbec 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -208,7 +208,7 @@ Leave this parameter out to use libraries without Spectre mitigations. Use the v Open the Properties dialog for a developer command prompt shortcut to see the command target used. For example, the target for the **x64 Native Tools Command Prompt for VS 2019** shortcut is something similar to: -``` +```cmd %comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat" ``` @@ -217,7 +217,7 @@ Open the Properties dialog for a developer command prompt shortcut to see the co Open the Properties dialog for a developer command prompt shortcut to see the command target used. For example, the target for the **x64 Native Tools Command Prompt for VS 2017** shortcut is something similar to: -``` +```cmd %comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars64.bat" ``` @@ -226,7 +226,7 @@ Open the Properties dialog for a developer command prompt shortcut to see the co Open the Properties dialog for a developer command prompt shortcut to see the command target used. For example, the target for the **VS2015 x64 Native Tools Command Prompt** shortcut is something similar to: -``` +```cmd %comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 ``` @@ -236,21 +236,21 @@ The architecture-specific batch files set the *`architecture`* parameter and cal ::: moniker range=">= msvc-160" -``` +```cmd %comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29 ``` ::: moniker-end ::: moniker range="= msvc-150" -``` +```cmd %comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.19 ``` ::: moniker-end ::: moniker range="< msvc-150" -``` +```cmd %comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0 ``` From cae3644e548e4322306a53116605f8800548be7f Mon Sep 17 00:00:00 2001 From: Rageking8 Date: Sat, 7 Feb 2026 09:11:14 +0800 Subject: [PATCH 1613/1799] Remove notion of issues and update `CONTRIBUTING.md` (#5629) * Remove notion of issues in `CONTRIBUTING.md` * Rephrase wording from "new content" to "changes/edits" in `CONTRIBUTING.md` * Use "Visual C++" in `CONTRIBUTING.md` * Update CONTRIBUTING.md Branding has changed since this was submmitted. --------- Co-authored-by: Tyler Whitney --- CONTRIBUTING.md | 23 +++++++++-------------- 1 file changed, 9 insertions(+), 14 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bbfa4431118..1fed536772c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,8 +1,8 @@ # Contributing -Thank you for your interest in contributing to the Visual C++ documentation! +Thank you for your interest in contributing to the Microsoft C++ documentation! -In this topic, you'll see the basic process for adding or updating content in the [Visual C++ documentation site](https://learn.microsoft.com/cpp/). +In this topic, you'll see the basic process for adding or updating content in the [Microsoft C++ documentation site](https://learn.microsoft.com/cpp/). In this topic, we'll cover: @@ -14,16 +14,13 @@ In this topic, we'll cover: ## Process for contributing -**Step 1:** Open an issue describing the article you wish to write and how it relates to existing content. -The content inside the **docs** folder is organized into sections that are organized by content area (e.g., debugger). Try to determine the correct folder for your new content. Get feedback on your proposal. - -You can skip this first step for small changes. +**Step 1:** The content inside the **docs** folder is organized into sections that are organized by content area (e.g., debugger). Try to determine the correct folder for your changes. **Step 2:** Fork the `MicrosoftDocs/cpp-docs` repository. -**Step 3:** Create a `branch` for your article. +**Step 3:** Create a `branch` for your changes. -**Step 4:** Write your article. +**Step 4:** Make your edits and commit. If it's a new topic, you can use this [template file](./styleguide/template.md) as your starting point. It contains the writing guidelines and also explains the metadata required for each article, such as author information. @@ -46,9 +43,7 @@ docs **Step 5:** Submit a Pull Request (PR) from your branch to `MicrosoftDocs/cpp-docs/main`. -If your PR is addressing an existing issue, add the `Fixes #Issue_Number` keyword to the commit message or PR description, so the issue can be automatically closed when the PR is merged. For more information, see [Closing issues via commit messages](https://help.github.com/articles/closing-issues-via-commit-messages/). - -The Visual Studio team will review your PR and let you know if the change looks good or if there are any other updates/changes necessary in order to approve it. +The Microsoft C++ docs team will review your PR and let you know if the change looks good or if there are any other updates/changes necessary in order to approve it. **Step 6:** Make any necessary updates to your branch as discussed with the team. @@ -58,9 +53,9 @@ On a certain cadence, we push all commits from main branch into the live branch ## DOs and DON'Ts -Below is a short list of guiding rules that you should keep in mind when you are contributing to the .NET documentation. +Below is a short list of guiding rules that you should keep in mind when you are contributing to the Microsoft C++ documentation. -- **DON'T** surprise us with big pull requests. Instead, file an issue and start a discussion so we can agree on a direction before you invest a large amount of time. +- **DON'T** surprise us with big pull requests. - **DO** read the [style guide](./styleguide/template.md) and [voice and tone](./styleguide/voice-tone.md) guidelines. - **DO** use the [template](./styleguide/template.md) file as the starting point of your work. - **DO** create a separate branch on your fork before working on the articles. @@ -68,7 +63,7 @@ Below is a short list of guiding rules that you should keep in mind when you are - **DO** blog and tweet (or whatever) about your contributions, frequently! > [!NOTE] -> You might notice that some of the topics are not currently following all the guidelines specified here and on the [style guide](./styleguide/template.md) as well. We're working towards achieving consistency throughout the site. Check the list of [open issues](https://github.com/MicrosoftDocs/cpp-docs/issues?q=is%3Aissue+is%3Aopen+label%3Aguidelines-adherence) we're currently tracking for that specific goal. +> You might notice that some of the topics are not currently following all the guidelines specified here and on the [style guide](./styleguide/template.md) as well. We're working towards achieving consistency throughout the site. ## Building the documentation From 1157d3be88af12526e21d921d224c684533d7d10 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 6 Feb 2026 17:32:15 -0800 Subject: [PATCH 1614/1799] Some code escape --- ...urce-compiler-errors-rc1000-through-rc4413.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md index 00125ae5b55..74e0908987d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md +++ b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md @@ -24,8 +24,8 @@ This section is a reference to the errors generated by the resource compiler. Re | [Resource compiler fatal error RC1020](resource-compiler-fatal-error-rc1020.md) | unexpected '#endif' | | [Resource compiler fatal error RC1021](resource-compiler-fatal-error-rc1021.md) | invalid preprocessor command 'string' | | [Resource compiler fatal error RC1022](resource-compiler-fatal-error-rc1022.md) | expected '#endif' | -| [Resource compiler fatal error RC1047](resource-compiler-fatal-error-rc1047.md) | "too many option options, 'string'" | -| [Resource compiler fatal error RC1052](resource-compiler-fatal-error-rc1052.md) | compiler limit : #if or #ifdef blocks nested too deeply | +| [Resource compiler fatal error RC1047](resource-compiler-fatal-error-rc1047.md) | too many option options, 'string' | +| [Resource compiler fatal error RC1052](resource-compiler-fatal-error-rc1052.md) | compiler limit : `#if` or `#ifdef` blocks nested too deeply | | [Resource compiler fatal error RC1067](resource-compiler-fatal-error-rc1067.md) | compiler limit : identifier overflowed internal buffer | | [Resource compiler fatal error RC1101](resource-compiler-fatal-error-rc1101.md) | no resource binary filename specified | | [Resource compiler fatal error RC1102](resource-compiler-fatal-error-rc1102.md) | internal error : too many arguments to RCPP | @@ -59,8 +59,8 @@ This section is a reference to the errors generated by the resource compiler. Re | [Resource compiler error RC2107](resource-compiler-error-rc2107.md) | expected numeric command value | | [Resource compiler error RC2109](resource-compiler-error-rc2109.md) | expected numerical dialog constant | | [Resource compiler error RC2111](resource-compiler-error-rc2111.md) | invalid control type | -| [Resource compiler error RC2112](resource-compiler-error-rc2112.md) | BEGIN expected in dialog | -| [Resource compiler error RC2113](resource-compiler-error-rc2113.md) | END expected in dialog | +| [Resource compiler error RC2112](resource-compiler-error-rc2112.md) | `BEGIN` expected in dialog | +| [Resource compiler error RC2113](resource-compiler-error-rc2113.md) | `END` expected in dialog | | [Resource compiler error RC2114](resource-compiler-error-rc2114.md) | expected control class name | | [Resource compiler error RC2116](resource-compiler-error-rc2116.md) | expecting number for ID | | [Resource compiler error RC2122](resource-compiler-error-rc2122.md) | unknown menu subtype | @@ -74,9 +74,9 @@ This section is a reference to the errors generated by the resource compiler. Re | [Resource compiler error RC2152](resource-compiler-error-rc2152.md) | invalid control character | | [Resource compiler error RC2162](resource-compiler-error-rc2162.md) | expected macro formal parameter | | [Resource compiler error RC2163](resource-compiler-error-rc2163.md) | accelerator type required [ASCII or VIRTKEY] | -| [Resource compiler error RC2164](resource-compiler-error-rc2164.md) | unexpected value in RCDATA | -| [Resource compiler error RC2165](resource-compiler-error-rc2165.md) | string not found in DLGINCLUDE statement | -| [Resource compiler error RC2167](resource-compiler-error-rc2167.md) | unrecognized VERSIONINFO field; BEGIN or comma expected | +| [Resource compiler error RC2164](resource-compiler-error-rc2164.md) | unexpected value in `RCDATA` | +| [Resource compiler error RC2165](resource-compiler-error-rc2165.md) | string not found in `DLGINCLUDE` statement | +| [Resource compiler error RC2167](resource-compiler-error-rc2167.md) | unrecognized `VERSIONINFO` field; `BEGIN` or comma expected | | [Resource compiler error RC2169](resource-compiler-error-rc2169.md) | resource file filename is not in 2.03 format | | [Resource compiler error RC2170](resource-compiler-error-rc2170.md) | bitmap file filename is not in 3.00 format | | [Resource compiler error RC2171](resource-compiler-error-rc2171.md) | unknown DIB header format | @@ -94,7 +94,7 @@ This section is a reference to the errors generated by the resource compiler. Re | [Resource compiler warning RC4093](resource-compiler-warning-rc4093.md) | unescaped newline in character constant in inactive code | | [Resource compiler warning RC4214](resource-compiler-warning-rc4214.md) | Codepage not valid : ignored | | [Resource compiler warning RW4001](resource-compiler-warning-rw4001.md) | .EXE processing options (/L /M /P /T /K /E /31 or /30) | -| [Resource compiler warning RW4003](resource-compiler-warning-rw4003.md) | SHIFT or CONTROL used without VIRTKEY | +| [Resource compiler warning RW4003](resource-compiler-warning-rw4003.md) | `SHIFT` or `CONTROL` used without `VIRTKEY` | | [Resource compiler warning RW4004](resource-compiler-warning-rw4004.md) | ASCII character not equivalent to virtual key code | ## See also From d5fdb408309f966e6e4e74b4d1a231bc50f4a846 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 6 Feb 2026 17:44:05 -0800 Subject: [PATCH 1615/1799] Fix duplicate ms.custom entry in documentation Removed duplicate ms.custom metadata entry. --- docs/build/building-on-the-command-line.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index 6f7ec2f05a0..07501e59a26 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -3,7 +3,6 @@ title: "Use the Microsoft C++ Build Tools from the command line" description: "Use the Microsoft C++ (MSVC) Build Tools from the command line outside of the Visual Studio IDE." ms.custom: "conceptual" ms.date: 04/07/2022 -ms.custom: "conceptual" ms.topic: how-to helpviewer_keywords: ["command-line builds [C++]", "compiling source code [C++], command line", "builds [C++], command-line", "command line [C++], building from", "command line [C++], compilers"] --- From b4f091ce5a2ce1139e64c384f032888b0d307b8f Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Tue, 10 Feb 2026 00:40:40 -0800 Subject: [PATCH 1616/1799] Add general troubleshooting steps --- ...ubleshoot-vc-redist-installation-issues.md | 277 ++++++++++++++++++ ...oubleshoot-vcredist-installation-issues.md | 189 ------------ 2 files changed, 277 insertions(+), 189 deletions(-) create mode 100644 docs/windows/troubleshoot-vc-redist-installation-issues.md delete mode 100644 docs/windows/troubleshoot-vcredist-installation-issues.md diff --git a/docs/windows/troubleshoot-vc-redist-installation-issues.md b/docs/windows/troubleshoot-vc-redist-installation-issues.md new file mode 100644 index 00000000000..fdb99b7dc73 --- /dev/null +++ b/docs/windows/troubleshoot-vc-redist-installation-issues.md @@ -0,0 +1,277 @@ +--- +title: "Troubleshoot Visual C++ Redistributable installation issues" +description: "Provide steps to diagnose and resolve issues with installing the Visual C++ Redistributable (VC Redist) as a standalone installation and as part of the VS Installer." +author: vicroms +ms.author: viromer +ms.date: 02/10/2025 +ms.topic: troubleshooting-general +helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC Redist" ] +--- +# Troubleshoot Visual C++ Redistributable installation issues + +This guide is for users experiencing issues while installing the Visual C++ Runtime components using the Visual C++ Redistributable (VC Redist) installer or the Visual Studio Installer (VS Installer). + +If you're experiencing such issues, we recommend that you first attempt installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). + +## Collect failure logs + +The first step to diagnose an issue with the Visual C++ Redistributable (VC Redist) installer is to collect its failure logs. + +1. Download the [Microsoft Visual Studio and .NET Log Collection Tool](). +2. Run `Collect.exe`. +3. Extract the contents of `%TEMP%/vscollect.zip`. + +Once you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. + +The VC Redist logs are useful to diagnose common installation issues. + +### Other log locations + +VC Redist is often executed as a prerequisite of other products, in such cases the installation log might be found in a different path. + +For example, [Configuration Manager](/intune/configmgr/core/understand/introduction) upgrades VC Redist as part of its own upgrade process by running `vcredist_x64.exe` with the `/l` option which overrides the default log location. + +In such cases, the path to the VC Redist logs can be found by reading that product's own logs: + +**Example: Configuration Manager logs** + +`\Logs\cmupdate.log` + +```log +10-31-2025 17:40:06.421 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) [Visual C++ 2015-2022 Redistributable (x64)] with older version 14.28.29914 is installed. it needs to upgraded. +10-31-2025 17:40:06.421 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) INFO: Start install Visual C redistributable ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe" /q /norestart /l "C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log"). +10-31-2025 17:40:14.553 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) ERROR: Failed to install Visual C redistributable. Return code: 1603. +10-31-2025 17:40:14.553 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) ERROR: 64-bit VC Redist installation ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe") failed. Please check log file [C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log]. +10-31-2025 17:40:14.554 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) Failed to install vc redist. Please manually install it from C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64 +``` + +## General troubleshooting steps + +This section describes general troubleshooting methods you can try to resolve issues with the VC Redist installer. + +### Method 1: Disable antivirus software temporarily + +Security products have been repeatedly linked to blocked VC Redist installs. + +1. Turn off Windows Defender real-time protection. +2. Disable any corporate endpoint protection temporarily (Symantec, McAfee, etc.). +3. Retry the installation. +4. Reenable any disabled protection software. + +### Method 2: Run VC Redist Installer as Administrator + +File-access failures are heavily correlated with insufficient permissions. + +1. Right-click the VC Redist Installer and select **Run as administrator**. +2. Retry the installation. + +### Method 3: Check for Windows System Updates + +On rare occasions, outdated system components can cause VC Redist installation issues. + +1. Go to Windows Update and install all pending updates. +2. Reboot your PC. +3. Retry the installation. + +> [!IMPORTANT] +> The troubleshooting methods below apply if you're installing VC Redist using the Visual Studio Installer. + +### Method 4: Manually Run the VC Redist Installer + +1. Go to `%ProgramData%\Microsoft\VisualStudio\Packages` +2. Open the folders: + - `Microsoft.VisualCpp.Redist.14,version=,chip=x64` + - `Microsoft.VisualCpp.Redist.14,version=,chip=x86` +3. Run the VC Redist installers: + - `vc_redist.x64.exe` + - `vc_redist.x86.exe` +4. Retry the Visual Studio Installer. + +If the manual installation fails, follow [methods 1 and 2](#method-1). + +### Method 5: Clear the Visual Studio Installer cache + +1. Open `%ProgramData%\Microsoft\VisualStudio\Packages` +2. Delete all files inside the folder to force the Visual Studio Installer to regenerate them. +3. Retry the Visual Studio Installer. + +### Method 6: Repair the Visual Studio Installer + +1. Go to **Settings** > **Apps** > **Installed Apps** +2. Select **Visual Studio Installer** > **Modify** > **Repair** +3. Retry the Visual Studio Installer. + +### Method 7: Delete the Visual Studio Installer folder + +> [!WARNING] +> This method requires that you have the Visual Studio Installer Setup downloaded (VisualStudioSetup.exe). +> You can download the Visual Studio Installer Setup from . + +This method helps in case the installer metadata is corrupted, deleting the installer folder forces the Visual Studio Installer to regenerate it. + +1. Download `VisualStudioSetup.exe` from . +2. Delete the folder `C:\Program Files (x86)\Microsoft Visual Studio\Installer`, you may be prompted to run this operation as Administrator. +3. Run `VisualStudioSetup.exe`. + +## Common issues + +### Return Code 1603 + +Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ Runtime components. + +Because many factors can produce a 1603 code, the code by itself does not provide enough information to diagnose the cause of the issue. +Often, the log files produced by the VC Redist installer contain relevant information that may lead to a solution or workaround. + +The [Common issues](#common-issues) section describes examples of how to diagnose common installation errors and steps that may resolve them. +If your issue isn't found here, then follow the instructions to [report an issue in the Visual C++ Redistributable installer](#report-a-vc-redist-installation-problem). + +### Access Denied + +An issue occurs during installation of VC Redist failing with return code 5. +The error code typically indicates a permissions issue; specifically, an access denied issue. + +**Steps to resolve** + +1. Disable antivirus, group policies, and firewalls temporarily. +2. Run the VC Redist installer. +3. Reenable any disabled protection software. + +If the installation fails, try to run the VC Redist installer as Administrator. + +### File is locked + +An issue occurs during the installation of VC Redist failing with return code 32. +Likely causes include blocked permissions, interference from antivirus or third-party software, group policies, or corrupted files. + +**Steps to resolve** + +1. Close any running software in your PC. +2. Try the methods in [General troubleshooting steps](#general-troubleshooting-steps). + +If the installation fails, try to restart your PC to release any locked files. + +### Corrupt or invalid installer package + +The issue involves an error during installation of VC Redist using the Visua Studio Installer with error code 1620. +Error code 1620 indicates that a Windows Installer package couldn't be opened, likely due to corruption or invalid files. + +One or more of these error codes are present in the VC Redist logs: + +- Error code 1620: indicates that the Windows Installer package could not be opened. +- Error code 0x80091007: several payloads failed verification due to hash mismatches. +- Errof code 0x80070654: occurs when an MSI package fails to execute. + +**Steps to resolve** + +Methods 5, 6, and 7 in the [General troubleshoot steps](#file-is-locked) may help solve this issue by cleaning the package cache. + +### Older Version Cannot Be Removed + +A corrupted Windows Installer cache produces error code 1714, indicating a failure to remove a previous version of VC Redist. + +The presence of these error messages indicates a corrupted cache. + +> [!NOTE] +> Tiemstamps have been rmoved from the log file examples to condense the output +> and present only the relevant information. + +> [!NOTE] +> The product's unique identifiers (GUIDs) on these examples can be different +> depending on the product version being installed. + +In `dd_vcredist__.log` + +```log +Error 0x80070003: Failed to get size of pseudo bundle: C:\ProgramData\Package Cache\{43d1ce82-6f55-4860-a938-20e5deb28b98}\VC_redist.x64.exe +Error 0x80070003: Failed to initialize package from related bundle id: {43d1ce82-6f55-4860-a938-20e5deb28b98} +``` + +In `dd_vcredist___vcRuntimeMinimum_.log`: + +```log +SOURCEMGMT: Trying source C:\ProgramData\Package Cache\{455DF12C-7D43-4EFF-AE2F-43C8AF2817A3}v14.28.29914\packages\vcRuntimeMinimum_amd64\. +Note: 1: 2203 2: C:\ProgramData\Package Cache\{455DF12C-7D43-4EFF-AE2F-43C8AF2817A3}v14.28.29914\packages\vcRuntimeMinimum_amd64\vc_runtimeMinimum_x64.msi 3: -2147287037 +SOURCEMGMT: Source is invalid due to missing/inaccessible package. +``` + +```log +Note: 1: 1714 2: Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 3: 1612 +CustomAction returned actual error code 1612 (note this may not be 100% accurate if translation happened inside sandbox) +Product: Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 -- Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612. + +Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612. +``` + +In `VSSetupEvents.txt` + +```log +Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612.] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [] +``` + +**Steps to resolve** + +From the log files, take note of the VC Redist version causing the issue. + +Method 1: Use the Windows Installer. + +1. Try using the Windows Installer to manually remove the old VC Redist version. + If prompted, let the Windows Installer Troubleshooter attempt to fix the issue. +2. Retry the installation. + +Method 2: Manually remove the old version. + +1. Download the VC Redist installer for the old version by following the steps in + [Download old versions of the Visual C++ Redistributable Installer](#old-vcredist-versions) +2. Run the installer to uninstall the old VC Redist. +3. Retry the installation. + +## Download old versions of the Visual C++ Redistributable Installer + +> [!WARNING] +> Never install a Visual C++ Redistributable Installer that wasn't downloaded from a Microsoft site. +> Only install packages signed by Microsoft. + +The VC Redist installer can be downloaded from [my.visualstudio.com](), search for Visual C++ Redistributable + +The latest supported VC Redist version for each version of Visual Studio can be found in [this article](/cpp/windows/latest-supported-vc-redist). + +To access older or legacy versions follow these steps: + +**Version 14.50 or later** + +The download links use the `https://aka.ms/vs/18/release//VC_redist..exe` pattern. +For example: . + +**Version 14.30 to 14.44** + +The download links use the `https://aka.ms/vs/17/release//VC_redist.exe` pattern. +For example: . + +**Version 14.20 to 14.29** + +The download links use the `https://aka.ms/vs/16/release//VC_redist.exe` pattern. +For example: + +**Version 14.10 or later** + +The download links use the `https://aka.ms/vs/15/release//VC_redist.exe` pattern. +For example: + +If the aka.ms links don't work, you may be able to find the version you're looking for through a Bing search. +However, make sure that the download comes from a Microsoft site and that the installer is signed by Microsoft. + +## Report a VC Redist installation problem + +The list of [common issues](#common-issues) has been collected from feedback reported to Microsoft through [Developer Community](). + +If you encounter an issue not found in that section, or if your issue isn't resolved by the steps in this troubleshooting guide. +Use the [Report a Problem]() form to create a new feedback item. + +Your report should include as much information as possible about your environment. Please include: + +- Version of VC Redist you are trying to install. +- If upgrading, version of previously installed VC Redist installations. +- If installing through the Visual Studio Installer, version of the VS Installer. +- Logs collected by following the steps in the [Collect failure logs](#collect-failure-logs) section. + +Feedback without this information, especially without logs, is non-actionable and will be closed. diff --git a/docs/windows/troubleshoot-vcredist-installation-issues.md b/docs/windows/troubleshoot-vcredist-installation-issues.md deleted file mode 100644 index 58af67bca74..00000000000 --- a/docs/windows/troubleshoot-vcredist-installation-issues.md +++ /dev/null @@ -1,189 +0,0 @@ ---- -title: "Troubleshoot Visual C++ Redistributable installation issues" -description: "Provide steps to diagnose and resolve issues with installing the Visual C++ Redistributable (VC Redist)" -author: vicroms -ms.author: viromer -ms.date: 02/04/2025 -ms.topic: troubleshooting-general -helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC Redist" ] ---- -# Troubleshoot Visual C++ Redistributable installation issues - -This guide is for users experiencing issues while installing the Visual C++ -Runtime components using the Visual C++ Redistributable installer or the -Visual Studio Installer. - -If you're experiencing such issues, we recommend that you first attempt -installing the [latest version of the Visual C++ -Redistributable](latest-supported-vc-redist.md). - -## Collect failure logs - -The first step to diagnose an issue with the Visual C++ -Redistributable (VC Redist) installer is to collect its failure logs. - -1) Download the [Microsoft Visual Studio and .NET Log Collection - Tool](). -2) Run `Collect.exe` -3) Extract the contents of `%TEMP%/vscollect.zip` - -Once you extract `vscollect.zip`, the VC Redist logs are located inside the -`Temp` folder. The relevant log files are prefixed with the pattern -`dd_vcredist__yyyyMMddHHmmss`. - -In this article, we use these logs to diagnose common issues with the redist -installer. - -### Other log locations - -VC Redist is often executed as a prerequisite of other products, in such cases -the installation log might be found in a different path. - -For example, [Configuration -Manager](/intune/configmgr/core/understand/introduction) upgrades VC Redist as -part of its own upgrade process, running `vcredist_x64.exe` with the `/l` -option, overriding the default log location. - -In such cases, the path to the VC Redist logs can be found by reading that product's -own logs: - -**Example: Configuration Manager logs** - -`\Logs\cmupdate.log` - -```log -10-31-2025 17:40:06.421 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) [Visual C++ 2015-2022 Redistributable (x64)] with older version 14.28.29914 is installed. it needs to upgraded. -10-31-2025 17:40:06.421 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) INFO: Start install Visual C redistributable ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe" /q /norestart /l "C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log"). -10-31-2025 17:40:14.553 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) ERROR: Failed to install Visual C redistributable. Return code: 1603. -10-31-2025 17:40:14.553 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) ERROR: 64-bit VC Redist installation ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe") failed. Please check log file [C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log]. -10-31-2025 17:40:14.554 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) Failed to install vc redist. Please manually install it from C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64 -``` - -## Return Code 1603 - -Issues with the VC Redist installer often produce the return code 1603. This is -a generic install failure code produced by the Windows Installer, which is -invoked during the installation of the Visual C++ Runtime components. - -Because many factors can produce a 1603 code, the return code itself is not -enough to diagnose the root cause of the issue. In such cases, the log files -usually contain relevant information that can lead to a solution. - -The [Common issues](#common-issues) section describes examples of how to -diagnose common installation errors and steps that may resolve them. If your -issue is not found here, then follow the instructions to [report an issue in -the Visual C++ Redistributable installer](#my-issue-is-not-here). - -## Common issues - -### Error 1714 - Older Version Cannot Be Removed - -Error 1714 is often caused by a corrupted Windows Installer Cache. The -installation process fails to remove an older version due to a corrupted -or missing MSI package. - -**Diagnose** - -> [!NOTE] -> The log file examples in this section have had the timestamps removed to -> present only the relevant information. - -> [!NOTE] -> The GUIDs on this examples may be different depending on the product version -> being installed. - -The presence of these error messages indicate a corrupted cache. - -In `dd_vcredist__.log` - -```log -Error 0x80070003: Failed to get size of pseudo bundle: C:\ProgramData\Package Cache\{43d1ce82-6f55-4860-a938-20e5deb28b98}\VC_redist.x64.exe -Error 0x80070003: Failed to initialize package from related bundle id: {43d1ce82-6f55-4860-a938-20e5deb28b98} -``` - -In `dd_vcredist___vcRuntimeMinimum_.log`: - -```log -SOURCEMGMT: Trying source C:\ProgramData\Package Cache\{455DF12C-7D43-4EFF-AE2F-43C8AF2817A3}v14.28.29914\packages\vcRuntimeMinimum_amd64\. -Note: 1: 2203 2: C:\ProgramData\Package Cache\{455DF12C-7D43-4EFF-AE2F-43C8AF2817A3}v14.28.29914\packages\vcRuntimeMinimum_amd64\vc_runtimeMinimum_x64.msi 3: -2147287037 -SOURCEMGMT: Source is invalid due to missing/inaccessible package. -``` - -```log -Note: 1: 1714 2: Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 3: 1612 -CustomAction returned actual error code 1612 (note this may not be 100% accurate if translation happened inside sandbox) -Product: Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 -- Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612. - -Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612. -``` - -In `VSSetupEvents.txt` - -```log -Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612.] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [] -``` - -**Steps to resolve** - -From the log files, take note of the VC Redist version causing the issue. - -Method 1: Use the Windows Installer: - -1. Try using the Windows Installer to manually remove the old VC Redist version. - If prompted, let the Windows Installer Troubleshooter attempt to fix the - issue. -2. Retry the installation. - -Method 2: Manually remove the old version. - -1. Download the VC Redist installer for the old version by following the steps in - [Download old versions of the Visual C++ Redistributable Installer](#old-vcredist-versions) -2. Run the installer to uninstall the old VC Redist. -3. Retry the installation. - -## Download old versions of the Visual C++ Redistributable Installer - -> [!WARNING] -> Never install a Visual C++ Redistributable Installer that wasn't downloaded -> from a Microsoft site. And only install packages that are signed by Microsoft. - -The VC Redist installer can be downloaded from -[my.visualstudio.com](), search for -Visual C++ Redistributable - -The latest supported VC Redist version for each version of Visual Studio can -be found in [this article](/cpp/windows/latest-supported-vc-redist). - -To access older or legacy versions follow these steps: - -**Version 14.50 or later** - -The download links use the -`https://aka.ms/vs/18/release//VC_redist..exe` pattern. -For example: . - -**Version 14.30 to 14.44** - -The download links use the -`https://aka.ms/vs/17/release//VC_redist.exe` pattern. -For example: . - -**Version 14.20 to 14.29** - -The download links use the -`https://aka.ms/vs/16/release//VC_redist.exe` pattern. -For example: - -**Version 14.10 or later** - -The download links use the -`https://aka.ms/vs/15/release//VC_redist.exe` pattern. -For example: - -If the aka.ms links do not work, you may be able to find the version you're -looking for through a Bing search. However, make sure that the download -comes from a Microsoft site and that the installer is signed by Microsoft. - -## My issue is not here - -TBD: Instructions to report an issue with the redist installer. From a4aff4ce03348a320bd3a07dba0338cc6a783b51 Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Tue, 10 Feb 2026 01:41:45 -0800 Subject: [PATCH 1617/1799] Apply Acrolynx suggestions --- ...ubleshoot-vcredist-installation-issues.md} | 113 ++++++++---------- 1 file changed, 53 insertions(+), 60 deletions(-) rename docs/windows/{troubleshoot-vc-redist-installation-issues.md => troubleshoot-vcredist-installation-issues.md} (67%) diff --git a/docs/windows/troubleshoot-vc-redist-installation-issues.md b/docs/windows/troubleshoot-vcredist-installation-issues.md similarity index 67% rename from docs/windows/troubleshoot-vc-redist-installation-issues.md rename to docs/windows/troubleshoot-vcredist-installation-issues.md index fdb99b7dc73..974fcf64fa5 100644 --- a/docs/windows/troubleshoot-vc-redist-installation-issues.md +++ b/docs/windows/troubleshoot-vcredist-installation-issues.md @@ -1,6 +1,6 @@ --- title: "Troubleshoot Visual C++ Redistributable installation issues" -description: "Provide steps to diagnose and resolve issues with installing the Visual C++ Redistributable (VC Redist) as a standalone installation and as part of the VS Installer." +description: "Provide steps to diagnose and resolve issues with installing the Visual C++ Redistributable as a standalone installation and as part of the Visual Studio Installer." author: vicroms ms.author: viromer ms.date: 02/10/2025 @@ -9,29 +9,29 @@ helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC --- # Troubleshoot Visual C++ Redistributable installation issues -This guide is for users experiencing issues while installing the Visual C++ Runtime components using the Visual C++ Redistributable (VC Redist) installer or the Visual Studio Installer (VS Installer). +This guide is for users experiencing issues while installing the Visual C++ Runtime components using the Visual C++ Redistributable (vcredist) installer or the Visual Studio (VS) Installer. If you're experiencing such issues, we recommend that you first attempt installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). ## Collect failure logs -The first step to diagnose an issue with the Visual C++ Redistributable (VC Redist) installer is to collect its failure logs. +The first step to diagnose an issue with the Visual C++ Redistributable installer is to collect its failure logs. 1. Download the [Microsoft Visual Studio and .NET Log Collection Tool](). 2. Run `Collect.exe`. 3. Extract the contents of `%TEMP%/vscollect.zip`. -Once you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. +Once you extract `vscollect.zip`, the vcredist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. -The VC Redist logs are useful to diagnose common installation issues. +The vcredist logs are useful to diagnose common installation issues. ### Other log locations -VC Redist is often executed as a prerequisite of other products, in such cases the installation log might be found in a different path. +The vcredist installer is often executed as a prerequisite of other products, in such cases the installation log might be found in a different path. -For example, [Configuration Manager](/intune/configmgr/core/understand/introduction) upgrades VC Redist as part of its own upgrade process by running `vcredist_x64.exe` with the `/l` option which overrides the default log location. +For example, [Configuration Manager](/intune/configmgr/core/understand/introduction) upgrades vcredist as part of its own upgrade process by running `vcredist_x64.exe` with the `/l` option that overrides the default log location. -In such cases, the path to the VC Redist logs can be found by reading that product's own logs: +In such cases, the path to the logs can be found by reading that product's own logs: **Example: Configuration Manager logs** @@ -47,42 +47,42 @@ In such cases, the path to the VC Redist logs can be found by reading that produ ## General troubleshooting steps -This section describes general troubleshooting methods you can try to resolve issues with the VC Redist installer. +This section describes general troubleshooting methods you can try to resolve issues with the vcredist installer. ### Method 1: Disable antivirus software temporarily -Security products have been repeatedly linked to blocked VC Redist installs. +Security products often block installation of vcredist components. 1. Turn off Windows Defender real-time protection. 2. Disable any corporate endpoint protection temporarily (Symantec, McAfee, etc.). 3. Retry the installation. 4. Reenable any disabled protection software. -### Method 2: Run VC Redist Installer as Administrator +### Method 2: Run the Visual C++ Redistributable installer as Administrator File-access failures are heavily correlated with insufficient permissions. -1. Right-click the VC Redist Installer and select **Run as administrator**. +1. Right-click the vcredist installer and select **Run as administrator**. 2. Retry the installation. ### Method 3: Check for Windows System Updates -On rare occasions, outdated system components can cause VC Redist installation issues. +On rare occasions, outdated system components can cause installation issues. 1. Go to Windows Update and install all pending updates. 2. Reboot your PC. 3. Retry the installation. > [!IMPORTANT] -> The troubleshooting methods below apply if you're installing VC Redist using the Visual Studio Installer. +> The following troubleshooting methods apply when vcredist is installed as a component of the Visual Studio Installer. -### Method 4: Manually Run the VC Redist Installer +### Method 4: Manually Run the Visual C++ Redistributable installer 1. Go to `%ProgramData%\Microsoft\VisualStudio\Packages` 2. Open the folders: - `Microsoft.VisualCpp.Redist.14,version=,chip=x64` - `Microsoft.VisualCpp.Redist.14,version=,chip=x86` -3. Run the VC Redist installers: +3. Run: - `vc_redist.x64.exe` - `vc_redist.x86.exe` 4. Retry the Visual Studio Installer. @@ -110,38 +110,38 @@ If the manual installation fails, follow [methods 1 and 2](#method-1). This method helps in case the installer metadata is corrupted, deleting the installer folder forces the Visual Studio Installer to regenerate it. 1. Download `VisualStudioSetup.exe` from . -2. Delete the folder `C:\Program Files (x86)\Microsoft Visual Studio\Installer`, you may be prompted to run this operation as Administrator. +2. Delete the folder `C:\Program Files (x86)\Microsoft Visual Studio\Installer`, you might be prompted to run this operation as Administrator. 3. Run `VisualStudioSetup.exe`. ## Common issues -### Return Code 1603 +### Return code 1603 Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ Runtime components. -Because many factors can produce a 1603 code, the code by itself does not provide enough information to diagnose the cause of the issue. -Often, the log files produced by the VC Redist installer contain relevant information that may lead to a solution or workaround. +Because many factors can produce a 1603 code, the code by itself doesn't provide enough information to diagnose the cause of the issue. +Often, the log files produced by the vcredistt installer contain relevant information that might lead to a solution or workaround. -The [Common issues](#common-issues) section describes examples of how to diagnose common installation errors and steps that may resolve them. -If your issue isn't found here, then follow the instructions to [report an issue in the Visual C++ Redistributable installer](#report-a-vc-redist-installation-problem). +The [Common issues](#common-issues) section describes examples of how to diagnose common installation errors and steps that might resolve them. +If your issue isn't found here, then follow the instructions to [report an issue in the Visual C++ Redistributable installer](#report-a-visual-c-redistributable-installation-problem). -### Access Denied +### Access denied -An issue occurs during installation of VC Redist failing with return code 5. +An issue occurs during installation of vcredist failing with return code 5. The error code typically indicates a permissions issue; specifically, an access denied issue. **Steps to resolve** 1. Disable antivirus, group policies, and firewalls temporarily. -2. Run the VC Redist installer. +2. Run the vcredist installer. 3. Reenable any disabled protection software. -If the installation fails, try to run the VC Redist installer as Administrator. +If the installation fails, try to run the vcredist installer as Administrator. ### File is locked -An issue occurs during the installation of VC Redist failing with return code 32. -Likely causes include blocked permissions, interference from antivirus or third-party software, group policies, or corrupted files. +An issue occurs during the installation of vcredist failing with return code 32. +Likely causes include blocked permissions, interference from antivirus, group policies, or corrupted files. **Steps to resolve** @@ -152,32 +152,27 @@ If the installation fails, try to restart your PC to release any locked files. ### Corrupt or invalid installer package -The issue involves an error during installation of VC Redist using the Visua Studio Installer with error code 1620. +The issue involves an error during installation of vcredist using the Visual Studio Installer with error code 1620. Error code 1620 indicates that a Windows Installer package couldn't be opened, likely due to corruption or invalid files. -One or more of these error codes are present in the VC Redist logs: +One or more of these error codes are present in the logs: -- Error code 1620: indicates that the Windows Installer package could not be opened. +- Error code 1620: indicates that the Windows Installer package couldn't be opened. - Error code 0x80091007: several payloads failed verification due to hash mismatches. -- Errof code 0x80070654: occurs when an MSI package fails to execute. +- Error code 0x80070654: occurs when an MSI package fails to execute. **Steps to resolve** -Methods 5, 6, and 7 in the [General troubleshoot steps](#file-is-locked) may help solve this issue by cleaning the package cache. +Methods 5, 6, and 7 in the [General troubleshoot steps](#file-is-locked) might help solve this issue by cleaning the package cache. -### Older Version Cannot Be Removed +### Older version can't be removed -A corrupted Windows Installer cache produces error code 1714, indicating a failure to remove a previous version of VC Redist. +A corrupted Windows Installer cache produces error code 1714, indicating a failure to remove a previous version of vcredist. The presence of these error messages indicates a corrupted cache. > [!NOTE] -> Tiemstamps have been rmoved from the log file examples to condense the output -> and present only the relevant information. - -> [!NOTE] -> The product's unique identifiers (GUIDs) on these examples can be different -> depending on the product version being installed. +> Timestamps are removed from these examples to condense the output. In `dd_vcredist__.log` @@ -210,30 +205,29 @@ Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - **Steps to resolve** -From the log files, take note of the VC Redist version causing the issue. +From the log files, take note of the vcredist version causing the issue. Method 1: Use the Windows Installer. -1. Try using the Windows Installer to manually remove the old VC Redist version. +1. Try using the Windows Installer to manually remove the old vcredist version. If prompted, let the Windows Installer Troubleshooter attempt to fix the issue. 2. Retry the installation. Method 2: Manually remove the old version. -1. Download the VC Redist installer for the old version by following the steps in - [Download old versions of the Visual C++ Redistributable Installer](#old-vcredist-versions) -2. Run the installer to uninstall the old VC Redist. +1. Download the vcredist installer for the old version by following the steps in + [Download old versions of the Visual C++ Redistributable installer](#old-vcredist-versions) +2. Run the installer to uninstall the old vcredist. 3. Retry the installation. -## Download old versions of the Visual C++ Redistributable Installer +## Download old versions of the Visual C++ Redistributable installer > [!WARNING] -> Never install a Visual C++ Redistributable Installer that wasn't downloaded from a Microsoft site. -> Only install packages signed by Microsoft. +> Never install a Visual C++ Redistributable installer that wasn't downloaded from a Microsoft site. -The VC Redist installer can be downloaded from [my.visualstudio.com](), search for Visual C++ Redistributable +The vcredist installer can be downloaded from [my.visualstudio.com](), search for Visual C++ Redistributable -The latest supported VC Redist version for each version of Visual Studio can be found in [this article](/cpp/windows/latest-supported-vc-redist). +The latest supported vcredist version for each version of Visual Studio can be found in [this article](/cpp/windows/latest-supported-vc-redist). To access older or legacy versions follow these steps: @@ -257,21 +251,20 @@ For example: The download links use the `https://aka.ms/vs/15/release//VC_redist.exe` pattern. For example: -If the aka.ms links don't work, you may be able to find the version you're looking for through a Bing search. +If the aka.ms links don't work, you might be able to find the version you're looking for through a Bing search. However, make sure that the download comes from a Microsoft site and that the installer is signed by Microsoft. -## Report a VC Redist installation problem +## Report a Visual C++ Redistributable installation problem -The list of [common issues](#common-issues) has been collected from feedback reported to Microsoft through [Developer Community](). +The list of [common issues](#common-issues) was collected from feedback reported to Microsoft through [Developer Community](). -If you encounter an issue not found in that section, or if your issue isn't resolved by the steps in this troubleshooting guide. -Use the [Report a Problem]() form to create a new feedback item. +If you encounter an issue not found in that section, or if the steps in this troubleshooting guide don't resolve your issue. Use the [Report a Problem]() form to create a new feedback item. -Your report should include as much information as possible about your environment. Please include: +Your report must include the following information about your environment: -- Version of VC Redist you are trying to install. -- If upgrading, version of previously installed VC Redist installations. +- Version of vcredist you're trying to install. +- If upgrading, version of previously installed vcredist installations. - If installing through the Visual Studio Installer, version of the VS Installer. - Logs collected by following the steps in the [Collect failure logs](#collect-failure-logs) section. -Feedback without this information, especially without logs, is non-actionable and will be closed. +Feedback without this information, especially without logs, is nonactionable and might be closed if additional information is not submitted promptly. From b020f1780838196cfba122f92941d99c602cb34d Mon Sep 17 00:00:00 2001 From: Hulon Jenkins <109993038+HulonJenkins@users.noreply.github.com> Date: Tue, 10 Feb 2026 11:55:22 -0800 Subject: [PATCH 1618/1799] Add preservenone.md calling convention doc --- ...argument-passing-and-naming-conventions.md | 1 + docs/cpp/preservenone.md | 70 +++++++++++++++++++ 2 files changed, 71 insertions(+) create mode 100644 docs/cpp/preservenone.md diff --git a/docs/cpp/argument-passing-and-naming-conventions.md b/docs/cpp/argument-passing-and-naming-conventions.md index aea3e8d3a15..d2929781fc0 100644 --- a/docs/cpp/argument-passing-and-naming-conventions.md +++ b/docs/cpp/argument-passing-and-naming-conventions.md @@ -31,6 +31,7 @@ The following calling conventions are supported by the Visual C/C++ compiler. |[__fastcall](../cpp/fastcall.md)|Callee|Stored in registers, then pushed on stack| |[__thiscall](../cpp/thiscall.md)|Callee|Pushed on stack; **`this`** pointer stored in ECX| |[__vectorcall](../cpp/vectorcall.md)|Callee|Stored in registers, then pushed on stack in reverse order (right to left)| +|[__preserve_none](../cpp/preservenone.md)|Callee|Stored in registers only| For related information, see [Obsolete Calling Conventions](../cpp/obsolete-calling-conventions.md). diff --git a/docs/cpp/preservenone.md b/docs/cpp/preservenone.md new file mode 100644 index 00000000000..97a40d3a453 --- /dev/null +++ b/docs/cpp/preservenone.md @@ -0,0 +1,70 @@ +# __preserve_none + +**Microsoft Specific** + +> [!IMPORTANT] +> The **`__preserve_none`** calling convention is experimental and subject to change in future releases. Use at your own risk. + +The **`__preserve_none`** calling convention specifies that arguments to functions are to be passed in registers, with most general-purpose registers treated as volatile. This calling convention is only supported for C programs and only applies to the x64 architecture. + +This calling convention is designed to minimize register spilling and improve performance. + +The following list shows the implementation of this calling convention. + +| Element | Implementation | +|---------|----------------| +| Argument-passing order | Arguments are passed in up to 10 registers in the following order: r13, r14, r15, rbx, rsi, rdi, r9, r8, rdx, rcx. If a hidden parameter is required for struct returns, it is passed in r13 (the first parameter register), reducing available parameter registers to 9. Registers r10-r12 are reserved for various CRT and Windows runtimes. All parameters must be passed through registers; stack-based parameters are not currently supported. | +| Register allocation strategy | Registers rcx, rdx, r8, and r9 are allocated towards the end and in reverse order to reduce register spilling. | +| Argument limit | Functions are restricted to a maximum of 10 parameters. An error is generated if this limit is exceeded. | +| Return value convention | Follows the regular x64 calling convention rules. Scalar return values are returned in rax. Structs of size 1, 2, 4, or 8 bytes are returned through the rax register. For structs of other sizes, a pointer to memory allocated by the caller and passed through the hidden parameter is returned in rax. | +| Volatile registers | All general-purpose registers except rsp (stack pointer) and rbp (base pointer) are treated as volatile and do not need to be preserved across function calls. While r10 and r11 are volatile, they are not used for parameter passing to maintain compatibility with existing programs. | +| Nonvolatile registers | Only rsp, rbp, and r12 are nonvolatile. | +| Stack alignment | The stack must maintain 16-byte alignment. | +| Frame pointer | The rbp register and frame chain follow the /Gy switch settings. | +| Stack-maintenance responsibility | The callee is responsible for cleaning up its own stack space. | +| Shadow space | A 32-byte shadow space is reserved on the stack to maintain compatibility with profilers and debugging tools. | +| Floating-point support | Floating-point parameters are not supported in the current version. | +| Name-decoration convention | Function names are decorated with @@_A suffix. | +| Case-translation convention | No case translation performed. | + +> [!NOTE] +> The number of registers used for parameter passing may change in future releases. + +## Restrictions and Limitations + +The **`__preserve_none`** calling convention has the following restrictions: + +- **C only**: Only supported for C programs. +- **x64 only**: Only the x64 backend provides support for this calling convention. +- **No floating-point**: Floating-point parameters are not supported. +- **No variadic functions**: Variadic functions (varargs) are not supported. +- **Parameter limit**: Maximum of 10 parameters, all passed through registers. + +## Use Cases + +The **`__preserve_none`** calling convention is designed for performance-critical scenarios where: + +- Most functions in the codebase use the **`__preserve_none`** calling convention +- Used in conjunction with `msvc::musttail` to tail call between functions with no stack usage +- Minimizing register spilling is important for performance +- The codebase is compatible with treating most registers as volatile + +## Example + +In the following example, the function `ProcessData` uses the **`__preserve_none`** calling convention: + +```c +// Example of the __preserve_none keyword +void __preserve_none ProcessData(int a, int b, int c, int d, int e); + +// Example of the __preserve_none keyword on function pointer +typedef int (__preserve_none *callback_ptr)(void* context, int value, int flags); +``` + +**END Microsoft Specific** + +## See also + +[Argument Passing and Naming Conventions](argument-passing-and-naming-conventions?view=msvc-170) +[x64 Calling Convention](../build/x64-calling-convention?view=msvc-170) +[Keywords](keywords-cpp?view=msvc-170) From dfadcda6beb4adbbed42bf0613369e06d1d8d8f8 Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Tue, 10 Feb 2026 13:26:32 -0800 Subject: [PATCH 1619/1799] Replace vcredist -> VC Redist --- ...oubleshoot-vcredist-installation-issues.md | 50 +++++++++---------- 1 file changed, 24 insertions(+), 26 deletions(-) diff --git a/docs/windows/troubleshoot-vcredist-installation-issues.md b/docs/windows/troubleshoot-vcredist-installation-issues.md index 974fcf64fa5..d06ce7b7985 100644 --- a/docs/windows/troubleshoot-vcredist-installation-issues.md +++ b/docs/windows/troubleshoot-vcredist-installation-issues.md @@ -9,7 +9,7 @@ helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC --- # Troubleshoot Visual C++ Redistributable installation issues -This guide is for users experiencing issues while installing the Visual C++ Runtime components using the Visual C++ Redistributable (vcredist) installer or the Visual Studio (VS) Installer. +This guide is for users experiencing issues while installing the Visual C++ Runtime components using the Visual C++ Redistributable (VC Redist) installer or the Visual Studio (VS) Installer. If you're experiencing such issues, we recommend that you first attempt installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). @@ -21,15 +21,13 @@ The first step to diagnose an issue with the Visual C++ Redistributable installe 2. Run `Collect.exe`. 3. Extract the contents of `%TEMP%/vscollect.zip`. -Once you extract `vscollect.zip`, the vcredist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. - -The vcredist logs are useful to diagnose common installation issues. +Once you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. ### Other log locations -The vcredist installer is often executed as a prerequisite of other products, in such cases the installation log might be found in a different path. +The VC Redist installer is often executed as a prerequisite of other products, in such cases the installation log might be found in a different path. -For example, [Configuration Manager](/intune/configmgr/core/understand/introduction) upgrades vcredist as part of its own upgrade process by running `vcredist_x64.exe` with the `/l` option that overrides the default log location. +For example, [Configuration Manager](/intune/configmgr/core/understand/introduction) upgrades VC Redist as part of its own upgrade process by running `vcredist_x64.exe` with the `/l` option that overrides the default log location. In such cases, the path to the logs can be found by reading that product's own logs: @@ -47,11 +45,11 @@ In such cases, the path to the logs can be found by reading that product's own l ## General troubleshooting steps -This section describes general troubleshooting methods you can try to resolve issues with the vcredist installer. +This section describes general troubleshooting methods you can try to resolve issues with the VC Redist installer. ### Method 1: Disable antivirus software temporarily -Security products often block installation of vcredist components. +Security products often block installation of VC Redist components. 1. Turn off Windows Defender real-time protection. 2. Disable any corporate endpoint protection temporarily (Symantec, McAfee, etc.). @@ -62,7 +60,7 @@ Security products often block installation of vcredist components. File-access failures are heavily correlated with insufficient permissions. -1. Right-click the vcredist installer and select **Run as administrator**. +1. Right-click the VC Redist installer and select **Run as administrator**. 2. Retry the installation. ### Method 3: Check for Windows System Updates @@ -74,7 +72,7 @@ On rare occasions, outdated system components can cause installation issues. 3. Retry the installation. > [!IMPORTANT] -> The following troubleshooting methods apply when vcredist is installed as a component of the Visual Studio Installer. +> The following troubleshooting methods apply when VC Redist is installed as a component of the Visual Studio Installer. ### Method 4: Manually Run the Visual C++ Redistributable installer @@ -120,27 +118,27 @@ This method helps in case the installer metadata is corrupted, deleting the inst Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ Runtime components. Because many factors can produce a 1603 code, the code by itself doesn't provide enough information to diagnose the cause of the issue. -Often, the log files produced by the vcredistt installer contain relevant information that might lead to a solution or workaround. +Often, the log files produced by the VC Redistt installer contain relevant information that might lead to a solution or workaround. The [Common issues](#common-issues) section describes examples of how to diagnose common installation errors and steps that might resolve them. If your issue isn't found here, then follow the instructions to [report an issue in the Visual C++ Redistributable installer](#report-a-visual-c-redistributable-installation-problem). ### Access denied -An issue occurs during installation of vcredist failing with return code 5. +An issue occurs during installation of VC Redist failing with return code 5. The error code typically indicates a permissions issue; specifically, an access denied issue. **Steps to resolve** 1. Disable antivirus, group policies, and firewalls temporarily. -2. Run the vcredist installer. +2. Run the VC Redist installer. 3. Reenable any disabled protection software. -If the installation fails, try to run the vcredist installer as Administrator. +If the installation fails, try to run the VC Redist installer as Administrator. ### File is locked -An issue occurs during the installation of vcredist failing with return code 32. +An issue occurs during the installation of VC Redist failing with return code 32. Likely causes include blocked permissions, interference from antivirus, group policies, or corrupted files. **Steps to resolve** @@ -152,7 +150,7 @@ If the installation fails, try to restart your PC to release any locked files. ### Corrupt or invalid installer package -The issue involves an error during installation of vcredist using the Visual Studio Installer with error code 1620. +The issue involves an error during installation of VC Redist using the Visual Studio Installer with error code 1620. Error code 1620 indicates that a Windows Installer package couldn't be opened, likely due to corruption or invalid files. One or more of these error codes are present in the logs: @@ -167,7 +165,7 @@ Methods 5, 6, and 7 in the [General troubleshoot steps](#file-is-locked) might h ### Older version can't be removed -A corrupted Windows Installer cache produces error code 1714, indicating a failure to remove a previous version of vcredist. +A corrupted Windows Installer cache produces error code 1714, indicating a failure to remove a previous version of VC Redist. The presence of these error messages indicates a corrupted cache. @@ -205,19 +203,19 @@ Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - **Steps to resolve** -From the log files, take note of the vcredist version causing the issue. +From the log files, take note of the VC Redist version causing the issue. Method 1: Use the Windows Installer. -1. Try using the Windows Installer to manually remove the old vcredist version. +1. Try using the Windows Installer to manually remove the old VC Redist version. If prompted, let the Windows Installer Troubleshooter attempt to fix the issue. 2. Retry the installation. Method 2: Manually remove the old version. -1. Download the vcredist installer for the old version by following the steps in +1. Download the VC Redist installer for the old version by following the steps in [Download old versions of the Visual C++ Redistributable installer](#old-vcredist-versions) -2. Run the installer to uninstall the old vcredist. +2. Run the installer to uninstall the old VC Redist. 3. Retry the installation. ## Download old versions of the Visual C++ Redistributable installer @@ -225,9 +223,9 @@ Method 2: Manually remove the old version. > [!WARNING] > Never install a Visual C++ Redistributable installer that wasn't downloaded from a Microsoft site. -The vcredist installer can be downloaded from [my.visualstudio.com](), search for Visual C++ Redistributable +The VC Redist installer can be downloaded from [my.visualstudio.com](), search for Visual C++ Redistributable -The latest supported vcredist version for each version of Visual Studio can be found in [this article](/cpp/windows/latest-supported-vc-redist). +The latest supported VC Redist version for each version of Visual Studio can be found in [this article](/cpp/windows/latest-supported-vc-redist). To access older or legacy versions follow these steps: @@ -262,9 +260,9 @@ If you encounter an issue not found in that section, or if the steps in this tro Your report must include the following information about your environment: -- Version of vcredist you're trying to install. -- If upgrading, version of previously installed vcredist installations. +- Version of VC Redist you're trying to install. +- If upgrading, version of previously installed VC Redist installations. - If installing through the Visual Studio Installer, version of the VS Installer. - Logs collected by following the steps in the [Collect failure logs](#collect-failure-logs) section. -Feedback without this information, especially without logs, is nonactionable and might be closed if additional information is not submitted promptly. +Feedback without this information, especially without logs, is nonactionable and might be closed if additional information isn't submitted promptly. From eb5fd54000a63a779ed3fe033b8058a54c73c239 Mon Sep 17 00:00:00 2001 From: Hulon Jenkins <109993038+HulonJenkins@users.noreply.github.com> Date: Tue, 10 Feb 2026 14:14:45 -0800 Subject: [PATCH 1620/1799] Add __preserve_none to more file locations --- docs/build/reference/decorated-names.md | 1 + docs/c-language/summary-of-declarations.md | 4 ++-- docs/cpp/toc.yml | 2 ++ .../compiler-errors-2/compiler-errors-c7500-through-c7999.md | 1 + docs/error-messages/tool-errors/name-decoration.md | 1 + 5 files changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/build/reference/decorated-names.md b/docs/build/reference/decorated-names.md index 6370302c0d6..e1742a83dc8 100644 --- a/docs/build/reference/decorated-names.md +++ b/docs/build/reference/decorated-names.md @@ -57,6 +57,7 @@ The form of decoration for a C function depends on the calling convention used i | **`__stdcall`** | Leading underscore (**`_`**) and a trailing at sign (**`@`**) followed by the number of bytes in the parameter list in decimal | | **`__fastcall`** | Leading and trailing at signs (**`@`**) followed by a decimal number representing the number of bytes in the parameter list | | **`__vectorcall`** | Two trailing at signs (**`@@`**) followed by a decimal number of bytes in the parameter list | +| **`__preserve_none`** | Two trailing at signs, an underscore and the 'A' character (**`@@_A`**) | For ARM64EC functions with C linkage (whether compiled as C or by using `extern "C"`), a **`#`** is prepended to the decorated name. diff --git a/docs/c-language/summary-of-declarations.md b/docs/c-language/summary-of-declarations.md index 117a5baaaab..35c95662840 100644 --- a/docs/c-language/summary-of-declarations.md +++ b/docs/c-language/summary-of-declarations.md @@ -21,7 +21,7 @@ ms.assetid: 53a5e9e5-1a33-40b5-9dea-7f669b479329  *`attribute`*1 *`attribute-seq`*opt1 *`attribute`*1, 2: one of\ - **`__asm`** **`__based`** **`__cdecl`** **`__clrcall`** **`__fastcall`** **`__inline`** **`__stdcall`** **`__thiscall`** **`__vectorcall`** + **`__asm`** **`__based`** **`__cdecl`** **`__clrcall`** **`__fastcall`** **`__inline`** **`__stdcall`** **`__thiscall`** **`__vectorcall`** **`__preserve_none`** *`init-declarator-list`*:\  *`init-declarator`*\ @@ -209,7 +209,7 @@ ms.assetid: 53a5e9e5-1a33-40b5-9dea-7f669b479329  **`_Static_assert`** **`(`** *`constant-expression`* **`,`** *`string-literal`* **`)`** **`;`** 1 This grammar element is Microsoft-specific.\ -2 For more information about these elements, see [`__asm`](../assembler/inline/asm.md), [`__clrcall`](../cpp/clrcall.md), [`__stdcall`](../cpp/stdcall.md), [`__based`](../cpp/based-grammar.md), [`__fastcall`](../cpp/fastcall.md), [`__thiscall`](../cpp/thiscall.md), [`__cdecl`](../cpp/cdecl.md), [`__inline`](../cpp/inline-functions-cpp.md), and [`__vectorcall`](../cpp/vectorcall.md).\ +2 For more information about these elements, see [`__asm`](../assembler/inline/asm.md), [`__clrcall`](../cpp/clrcall.md), [`__stdcall`](../cpp/stdcall.md), [`__based`](../cpp/based-grammar.md), [`__fastcall`](../cpp/fastcall.md), [`__thiscall`](../cpp/thiscall.md), [`__cdecl`](../cpp/cdecl.md), [`__inline`](../cpp/inline-functions-cpp.md), [`__preserve_none`](../cpp/preservenone.md) and [`__vectorcall`](../cpp/vectorcall.md).\ 3 This style is obsolete. ## See also diff --git a/docs/cpp/toc.yml b/docs/cpp/toc.yml index 1c9d0872d8e..1f17ade4e51 100644 --- a/docs/cpp/toc.yml +++ b/docs/cpp/toc.yml @@ -644,6 +644,8 @@ items: href: ../cpp/thiscall.md - name: __vectorcall href: ../cpp/vectorcall.md + - name: __preserve_none + href: ../cpp/preserve-none.md - name: "Calling example: Function prototype and call" items: - name: "Calling example: Function prototype and call" diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md index 5af9b70e4ff..96f98965178 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md @@ -241,6 +241,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C7740 | cannot jump to case label | | Compiler error C7741 | ABI inconsistency: '*function*' was originally assumed to use '`C`' return semantics but now it requires '`C++`' return semantics | | [Compiler error C7742](compiler-error-c7742.md) | '*identifier*': a forward declaration of an enum can only use a simple identifier | +| Compiler error C7743 | `__preserve_none` calling convention is not supported | | Compiler error C7800 | duplicate explicit instantiation definition of '*name*' | | Compiler error C7801 | '*function*': if one declaration of '*identifier*' has the '`[[msvc::disptach]]`' attribute then all functions must have the attribute | | Compiler error C7802 | '*identifier*': a capability must resolve to an enumerator | diff --git a/docs/error-messages/tool-errors/name-decoration.md b/docs/error-messages/tool-errors/name-decoration.md index b6f77174881..2a4b3e4f6cf 100644 --- a/docs/error-messages/tool-errors/name-decoration.md +++ b/docs/error-messages/tool-errors/name-decoration.md @@ -19,6 +19,7 @@ The following table shows the linker name for various calling conventions. |Fast call naming convention (**`__fastcall`**)|`@test@0`|`?test@@YIXXZ`| |Standard call naming convention (**`__stdcall`**)|`_test@0`|`?test@@YGXXZ`| |Vector call naming convention (**`__vectorcall`**)|`test@@0`|`?test@@YQXXZ`| +|Preserve None naming convention (**`__preserve_none`**)|`test@@_A`|`NA`| Use `extern "C"` to call a C function from C++. `extern "C"` forces use of the C naming convention for non-class C++ functions. Be aware of compiler switches **/Tc** or **/Tp**, which tell the compiler to ignore the filename extension and compile the file as C or C++, respectively. These options may cause linker names you don't expect. From 91416dd351a90cca8d69e81833706c00c67ba670 Mon Sep 17 00:00:00 2001 From: Hulon Jenkins <109993038+HulonJenkins@users.noreply.github.com> Date: Tue, 10 Feb 2026 16:04:10 -0800 Subject: [PATCH 1621/1799] More PR feedback --- docs/cpp/preservenone.md | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/docs/cpp/preservenone.md b/docs/cpp/preservenone.md index 97a40d3a453..f2caab2b0b2 100644 --- a/docs/cpp/preservenone.md +++ b/docs/cpp/preservenone.md @@ -3,7 +3,7 @@ **Microsoft Specific** > [!IMPORTANT] -> The **`__preserve_none`** calling convention is experimental and subject to change in future releases. Use at your own risk. +> The **`__preserve_none`** calling convention is experimental and subject to change. The **`__preserve_none`** calling convention specifies that arguments to functions are to be passed in registers, with most general-purpose registers treated as volatile. This calling convention is only supported for C programs and only applies to the x64 architecture. @@ -14,28 +14,25 @@ The following list shows the implementation of this calling convention. | Element | Implementation | |---------|----------------| | Argument-passing order | Arguments are passed in up to 10 registers in the following order: r13, r14, r15, rbx, rsi, rdi, r9, r8, rdx, rcx. If a hidden parameter is required for struct returns, it is passed in r13 (the first parameter register), reducing available parameter registers to 9. Registers r10-r12 are reserved for various CRT and Windows runtimes. All parameters must be passed through registers; stack-based parameters are not currently supported. | -| Register allocation strategy | Registers rcx, rdx, r8, and r9 are allocated towards the end and in reverse order to reduce register spilling. | +| Register allocation strategy | To help minimize register spilling, the allocator assigns r9, r8, rdx, and rcx only after other registers have been used. | | Argument limit | Functions are restricted to a maximum of 10 parameters. An error is generated if this limit is exceeded. | | Return value convention | Follows the regular x64 calling convention rules. Scalar return values are returned in rax. Structs of size 1, 2, 4, or 8 bytes are returned through the rax register. For structs of other sizes, a pointer to memory allocated by the caller and passed through the hidden parameter is returned in rax. | | Volatile registers | All general-purpose registers except rsp (stack pointer) and rbp (base pointer) are treated as volatile and do not need to be preserved across function calls. While r10 and r11 are volatile, they are not used for parameter passing to maintain compatibility with existing programs. | | Nonvolatile registers | Only rsp, rbp, and r12 are nonvolatile. | | Stack alignment | The stack must maintain 16-byte alignment. | -| Frame pointer | The rbp register and frame chain follow the /Gy switch settings. | +| Frame pointer | The rbp register and frame chain follow the [/Gy switch](../build/reference/gy-enable-function-level-linking.md) settings. | | Stack-maintenance responsibility | The callee is responsible for cleaning up its own stack space. | -| Shadow space | A 32-byte shadow space is reserved on the stack to maintain compatibility with profilers and debugging tools. | -| Floating-point support | Floating-point parameters are not supported in the current version. | +| Shadow space | A 32 byte shadow space is reserved on the stack to maintain compatibility with profilers and debugging tools. *(Shadow space is a reserved area on the stack where register parameters can be spilled if needed. It's typically 32 bytes (4 registers × 8 bytes each) reserved by the caller for the first 4 register parameters.)* | +| Floating-point support | Floating-point parameters are not supported. | | Name-decoration convention | Function names are decorated with @@_A suffix. | | Case-translation convention | No case translation performed. | -> [!NOTE] -> The number of registers used for parameter passing may change in future releases. - ## Restrictions and Limitations The **`__preserve_none`** calling convention has the following restrictions: - **C only**: Only supported for C programs. -- **x64 only**: Only the x64 backend provides support for this calling convention. +- **x64 only**: Only supported on x64. - **No floating-point**: Floating-point parameters are not supported. - **No variadic functions**: Variadic functions (varargs) are not supported. - **Parameter limit**: Maximum of 10 parameters, all passed through registers. From f3077d8638b52539e1901cdf0b6db21b8fad50ce Mon Sep 17 00:00:00 2001 From: Hulon Jenkins <109993038+HulonJenkins@users.noreply.github.com> Date: Wed, 11 Feb 2026 10:14:22 -0800 Subject: [PATCH 1622/1799] Rename to preserve-none.md and other PR feedback --- docs/c-language/summary-of-declarations.md | 2 +- docs/cpp/argument-passing-and-naming-conventions.md | 2 +- docs/cpp/{preservenone.md => preserve-none.md} | 13 ++++++++++--- .../compiler-errors-c7500-through-c7999.md | 2 +- 4 files changed, 13 insertions(+), 6 deletions(-) rename docs/cpp/{preservenone.md => preserve-none.md} (92%) diff --git a/docs/c-language/summary-of-declarations.md b/docs/c-language/summary-of-declarations.md index 35c95662840..975beb742bc 100644 --- a/docs/c-language/summary-of-declarations.md +++ b/docs/c-language/summary-of-declarations.md @@ -209,7 +209,7 @@ ms.assetid: 53a5e9e5-1a33-40b5-9dea-7f669b479329  **`_Static_assert`** **`(`** *`constant-expression`* **`,`** *`string-literal`* **`)`** **`;`** 1 This grammar element is Microsoft-specific.\ -2 For more information about these elements, see [`__asm`](../assembler/inline/asm.md), [`__clrcall`](../cpp/clrcall.md), [`__stdcall`](../cpp/stdcall.md), [`__based`](../cpp/based-grammar.md), [`__fastcall`](../cpp/fastcall.md), [`__thiscall`](../cpp/thiscall.md), [`__cdecl`](../cpp/cdecl.md), [`__inline`](../cpp/inline-functions-cpp.md), [`__preserve_none`](../cpp/preservenone.md) and [`__vectorcall`](../cpp/vectorcall.md).\ +2 For more information about these elements, see [`__asm`](../assembler/inline/asm.md), [`__clrcall`](../cpp/clrcall.md), [`__stdcall`](../cpp/stdcall.md), [`__based`](../cpp/based-grammar.md), [`__fastcall`](../cpp/fastcall.md), [`__thiscall`](../cpp/thiscall.md), [`__cdecl`](../cpp/cdecl.md), [`__inline`](../cpp/inline-functions-cpp.md), [`__preserve_none`](../cpp/preserve-none.md) and [`__vectorcall`](../cpp/vectorcall.md).\ 3 This style is obsolete. ## See also diff --git a/docs/cpp/argument-passing-and-naming-conventions.md b/docs/cpp/argument-passing-and-naming-conventions.md index d2929781fc0..11dfa80a2e9 100644 --- a/docs/cpp/argument-passing-and-naming-conventions.md +++ b/docs/cpp/argument-passing-and-naming-conventions.md @@ -31,7 +31,7 @@ The following calling conventions are supported by the Visual C/C++ compiler. |[__fastcall](../cpp/fastcall.md)|Callee|Stored in registers, then pushed on stack| |[__thiscall](../cpp/thiscall.md)|Callee|Pushed on stack; **`this`** pointer stored in ECX| |[__vectorcall](../cpp/vectorcall.md)|Callee|Stored in registers, then pushed on stack in reverse order (right to left)| -|[__preserve_none](../cpp/preservenone.md)|Callee|Stored in registers only| +|[__preserve_none](../cpp/preserve-none.md)|Callee|Stored in registers only| For related information, see [Obsolete Calling Conventions](../cpp/obsolete-calling-conventions.md). diff --git a/docs/cpp/preservenone.md b/docs/cpp/preserve-none.md similarity index 92% rename from docs/cpp/preservenone.md rename to docs/cpp/preserve-none.md index f2caab2b0b2..94ba81233c8 100644 --- a/docs/cpp/preservenone.md +++ b/docs/cpp/preserve-none.md @@ -1,3 +1,10 @@ +--- +description: "Learn more about: __preserve_none" +title: "__preserve_none" +ms.date: 02/11/2026 +f1_keywords: ["__preserve_none", "register spilling", "non preserving calling convention"] +helpviewer_keywords: ["__preserve_none keyword"] +--- # __preserve_none **Microsoft Specific** @@ -62,6 +69,6 @@ typedef int (__preserve_none *callback_ptr)(void* context, int value, int flags) ## See also -[Argument Passing and Naming Conventions](argument-passing-and-naming-conventions?view=msvc-170) -[x64 Calling Convention](../build/x64-calling-convention?view=msvc-170) -[Keywords](keywords-cpp?view=msvc-170) +[Argument Passing and Naming Conventions](argument-passing-and-naming-conventions.md) +[x64 Calling Convention](../build/x64-calling-convention.md) +[Keywords](keywords-cpp.md) diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md index 96f98965178..02b5801c7bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md @@ -241,7 +241,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C7740 | cannot jump to case label | | Compiler error C7741 | ABI inconsistency: '*function*' was originally assumed to use '`C`' return semantics but now it requires '`C++`' return semantics | | [Compiler error C7742](compiler-error-c7742.md) | '*identifier*': a forward declaration of an enum can only use a simple identifier | -| Compiler error C7743 | `__preserve_none` calling convention is not supported | +| Compiler error C7743 | [`__preserve_none` calling convention](../../cpp/preserve-none.md) is not supported | | Compiler error C7800 | duplicate explicit instantiation definition of '*name*' | | Compiler error C7801 | '*function*': if one declaration of '*identifier*' has the '`[[msvc::disptach]]`' attribute then all functions must have the attribute | | Compiler error C7802 | '*identifier*': a capability must resolve to an enumerator | From 7b7e5c8de2b8335c90bade7a0d3313b1cc5a248b Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Thu, 12 Feb 2026 00:05:49 +0000 Subject: [PATCH 1623/1799] PR comments and feedback --- docs/windows/latest-supported-vc-redist.md | 4 +++ docs/windows/toc.yml | 2 ++ ...oubleshoot-vcredist-installation-issues.md | 29 +++++++++++-------- 3 files changed, 23 insertions(+), 12 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 33c92e2fa76..51c36772683 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -20,6 +20,9 @@ ms.author: msaleh > [!NOTE] > Are you here to download Visual Studio? Go to [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/). +> [!NOTE] +> Having issues installing the Visual C++ Redistributable? Check out the [troubleshooting guide](troubleshoot-vcredist-installation-issues.md). + This topic is for developers who need to install the Visual C++ runtime libraries with their app. If you're an end user trying to fix an app by updating the Visual C++ runtime libraries, contact the app vendor for instructions. To find the download you need, choose your version of Visual Studio from the table below. Each link takes you to the appropriate download section. @@ -142,6 +145,7 @@ Download Redistributable files for other languages and architectures from: - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) - [How to audit Visual C++ Runtime version usage](redist-version-auditing.md) - [Lifecycle FAQ - Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) +- [Troubleshoot Visual C++ Redistributable installation issues](troubleshoot-vcredist-installation-issues.md) **Release notes** diff --git a/docs/windows/toc.yml b/docs/windows/toc.yml index 6b6e16a2dae..b0efca5195d 100644 --- a/docs/windows/toc.yml +++ b/docs/windows/toc.yml @@ -149,6 +149,8 @@ items: href: ../windows/latest-supported-vc-redist.md - name: How to audit Visual C++ Runtime version usage href: ../windows/redist-version-auditing.md + - name: Troubleshoot Visual C++ Redistributable installation issues + href: ../windows/troubleshoot-vcredist-installation-issues.md - name: Deployment examples expanded: false items: diff --git a/docs/windows/troubleshoot-vcredist-installation-issues.md b/docs/windows/troubleshoot-vcredist-installation-issues.md index d06ce7b7985..15b6b44e4f5 100644 --- a/docs/windows/troubleshoot-vcredist-installation-issues.md +++ b/docs/windows/troubleshoot-vcredist-installation-issues.md @@ -76,14 +76,12 @@ On rare occasions, outdated system components can cause installation issues. ### Method 4: Manually Run the Visual C++ Redistributable installer -1. Go to `%ProgramData%\Microsoft\VisualStudio\Packages` -2. Open the folders: - - `Microsoft.VisualCpp.Redist.14,version=,chip=x64` - - `Microsoft.VisualCpp.Redist.14,version=,chip=x86` -3. Run: - - `vc_redist.x64.exe` - - `vc_redist.x86.exe` -4. Retry the Visual Studio Installer. +> [!NOTE] +> The VS Installer might prompt for a reboot when VC Redist is installed separately. + +1. Download the [latest VC Redist installer](latest-supported-vc-redist.md). +2. Run the VC Redist installer. +3. Retry the Visual Studio Installer. If the manual installation fails, follow [methods 1 and 2](#method-1). @@ -118,7 +116,7 @@ This method helps in case the installer metadata is corrupted, deleting the inst Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ Runtime components. Because many factors can produce a 1603 code, the code by itself doesn't provide enough information to diagnose the cause of the issue. -Often, the log files produced by the VC Redistt installer contain relevant information that might lead to a solution or workaround. +Often, the log files produced by the VC Redist installer contain relevant information that might lead to a solution or workaround. The [Common issues](#common-issues) section describes examples of how to diagnose common installation errors and steps that might resolve them. If your issue isn't found here, then follow the instructions to [report an issue in the Visual C++ Redistributable installer](#report-a-visual-c-redistributable-installation-problem). @@ -236,17 +234,17 @@ For example: . **Version 14.30 to 14.44** -The download links use the `https://aka.ms/vs/17/release//VC_redist.exe` pattern. +The download links use the `https://aka.ms/vs/17/release//VC_redist..exe` pattern. For example: . **Version 14.20 to 14.29** -The download links use the `https://aka.ms/vs/16/release//VC_redist.exe` pattern. +The download links use the `https://aka.ms/vs/16/release//VC_redist..exe` pattern. For example: **Version 14.10 or later** -The download links use the `https://aka.ms/vs/15/release//VC_redist.exe` pattern. +The download links use the `https://aka.ms/vs/15/release//VC_redist..exe` pattern. For example: If the aka.ms links don't work, you might be able to find the version you're looking for through a Bing search. @@ -266,3 +264,10 @@ Your report must include the following information about your environment: - Logs collected by following the steps in the [Collect failure logs](#collect-failure-logs) section. Feedback without this information, especially without logs, is nonactionable and might be closed if additional information isn't submitted promptly. + +## See also + +- [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) +- [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) +- [How to audit Visual C++ Runtime version usage](redist-version-auditing.md) +- [Lifecycle FAQ - Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) From cabdbccde8e57b0d2ad562ee0b7f5723531591f1 Mon Sep 17 00:00:00 2001 From: Hulon Jenkins <109993038+HulonJenkins@users.noreply.github.com> Date: Wed, 11 Feb 2026 16:35:33 -0800 Subject: [PATCH 1624/1799] PR feedback 3 --- docs/build/reference/decorated-names.md | 10 +++++----- docs/cpp/preserve-none.md | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/build/reference/decorated-names.md b/docs/build/reference/decorated-names.md index e1742a83dc8..4b5a674a640 100644 --- a/docs/build/reference/decorated-names.md +++ b/docs/build/reference/decorated-names.md @@ -53,11 +53,11 @@ The form of decoration for a C function depends on the calling convention used i | Calling convention | Decoration | |--|--| -| **`__cdecl`** | Leading underscore (**`_`**) | -| **`__stdcall`** | Leading underscore (**`_`**) and a trailing at sign (**`@`**) followed by the number of bytes in the parameter list in decimal | -| **`__fastcall`** | Leading and trailing at signs (**`@`**) followed by a decimal number representing the number of bytes in the parameter list | -| **`__vectorcall`** | Two trailing at signs (**`@@`**) followed by a decimal number of bytes in the parameter list | -| **`__preserve_none`** | Two trailing at signs, an underscore and the 'A' character (**`@@_A`**) | +| [**`__cdecl`**](../../cpp/cdecl.md) | Leading underscore (**`_`**) | +| [**`__stdcall`**](../../cpp/stdcall.md) | Leading underscore (**`_`**) and a trailing at sign (**`@`**) followed by the number of bytes in the parameter list in decimal | +| [**`__fastcall`**](../../cpp/fastcall.md) | Leading and trailing at signs (**`@`**) followed by a decimal number representing the number of bytes in the parameter list | +| [**`__vectorcall`**](../../cpp/vectorcall.md) | Two trailing at signs (**`@@`**) followed by a decimal number of bytes in the parameter list | +| [**`__preserve_none`**](../../cpp/preserve-none.md) | Two trailing at signs, an underscore and the 'A' character (**`@@_A`**) | For ARM64EC functions with C linkage (whether compiled as C or by using `extern "C"`), a **`#`** is prepended to the decorated name. diff --git a/docs/cpp/preserve-none.md b/docs/cpp/preserve-none.md index 94ba81233c8..8aebac117dc 100644 --- a/docs/cpp/preserve-none.md +++ b/docs/cpp/preserve-none.md @@ -12,13 +12,13 @@ helpviewer_keywords: ["__preserve_none keyword"] > [!IMPORTANT] > The **`__preserve_none`** calling convention is experimental and subject to change. -The **`__preserve_none`** calling convention specifies that arguments to functions are to be passed in registers, with most general-purpose registers treated as volatile. This calling convention is only supported for C programs and only applies to the x64 architecture. +The **`__preserve_none`** calling convention specifies that arguments to functions are to be passed in registers, with most general-purpose registers treated as volatile. This calling convention is only supported for C programs and only applies to x64 code. This calling convention is designed to minimize register spilling and improve performance. -The following list shows the implementation of this calling convention. +The following list shows the behavior of this calling convention. -| Element | Implementation | +| Element | Behavior | |---------|----------------| | Argument-passing order | Arguments are passed in up to 10 registers in the following order: r13, r14, r15, rbx, rsi, rdi, r9, r8, rdx, rcx. If a hidden parameter is required for struct returns, it is passed in r13 (the first parameter register), reducing available parameter registers to 9. Registers r10-r12 are reserved for various CRT and Windows runtimes. All parameters must be passed through registers; stack-based parameters are not currently supported. | | Register allocation strategy | To help minimize register spilling, the allocator assigns r9, r8, rdx, and rcx only after other registers have been used. | @@ -69,6 +69,6 @@ typedef int (__preserve_none *callback_ptr)(void* context, int value, int flags) ## See also -[Argument Passing and Naming Conventions](argument-passing-and-naming-conventions.md) -[x64 Calling Convention](../build/x64-calling-convention.md) +[Argument Passing and Naming Conventions](argument-passing-and-naming-conventions.md)\ +[x64 Calling Convention](../build/x64-calling-convention.md)\ [Keywords](keywords-cpp.md) From 266cf98a4ec8d313c92581ea4812a688742dd63d Mon Sep 17 00:00:00 2001 From: Hulon Jenkins <109993038+HulonJenkins@users.noreply.github.com> Date: Thu, 12 Feb 2026 10:46:43 -0800 Subject: [PATCH 1625/1799] Acrolinx fixes --- docs/cpp/preserve-none.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/cpp/preserve-none.md b/docs/cpp/preserve-none.md index 8aebac117dc..4022e4684e0 100644 --- a/docs/cpp/preserve-none.md +++ b/docs/cpp/preserve-none.md @@ -20,17 +20,17 @@ The following list shows the behavior of this calling convention. | Element | Behavior | |---------|----------------| -| Argument-passing order | Arguments are passed in up to 10 registers in the following order: r13, r14, r15, rbx, rsi, rdi, r9, r8, rdx, rcx. If a hidden parameter is required for struct returns, it is passed in r13 (the first parameter register), reducing available parameter registers to 9. Registers r10-r12 are reserved for various CRT and Windows runtimes. All parameters must be passed through registers; stack-based parameters are not currently supported. | -| Register allocation strategy | To help minimize register spilling, the allocator assigns r9, r8, rdx, and rcx only after other registers have been used. | +| Argument-passing order | Arguments are passed in up to 10 registers in the following order: `r13`, `r14`, `r15`, `rbx`, `rsi`, `rdi`, `r9`, `r8`, `rdx`, `rcx`. If a hidden parameter is required for struct returns, it's passed in `r13` (the first parameter register), reducing available parameter registers to 9. Registers `r10`-`r12` are reserved for various CRT and Windows runtimes. All parameters must be passed through registers; stack-based parameters aren't currently supported. | +| Register allocation strategy | To help minimize register spilling, the allocator assigns `r9`, `r8`, `rdx`, and `rcx` only after other registers have been used. | | Argument limit | Functions are restricted to a maximum of 10 parameters. An error is generated if this limit is exceeded. | -| Return value convention | Follows the regular x64 calling convention rules. Scalar return values are returned in rax. Structs of size 1, 2, 4, or 8 bytes are returned through the rax register. For structs of other sizes, a pointer to memory allocated by the caller and passed through the hidden parameter is returned in rax. | -| Volatile registers | All general-purpose registers except rsp (stack pointer) and rbp (base pointer) are treated as volatile and do not need to be preserved across function calls. While r10 and r11 are volatile, they are not used for parameter passing to maintain compatibility with existing programs. | -| Nonvolatile registers | Only rsp, rbp, and r12 are nonvolatile. | +| Return value convention | Follows the regular x64 calling convention rules. Scalar return values are returned in `rax`. Structs of size 1, 2, 4, or 8 bytes are returned through the `rax` register. For structs of other sizes, a pointer to memory allocated by the caller and passed through the hidden parameter is returned in `rax`. | +| Volatile registers | All general-purpose registers except `rsp` (stack pointer) and `rbp` (base pointer) are treated as volatile and don't need to be preserved across function calls. While `r10` and `r11` are volatile, they aren't used for parameter passing to maintain compatibility with existing programs. | +| Nonvolatile registers | Only `rsp`, `rbp`, and `r12` are nonvolatile. | | Stack alignment | The stack must maintain 16-byte alignment. | -| Frame pointer | The rbp register and frame chain follow the [/Gy switch](../build/reference/gy-enable-function-level-linking.md) settings. | +| Frame pointer | The `rbp` register and frame chain follow the [/Gy switch](../build/reference/gy-enable-function-level-linking.md) settings. | | Stack-maintenance responsibility | The callee is responsible for cleaning up its own stack space. | -| Shadow space | A 32 byte shadow space is reserved on the stack to maintain compatibility with profilers and debugging tools. *(Shadow space is a reserved area on the stack where register parameters can be spilled if needed. It's typically 32 bytes (4 registers × 8 bytes each) reserved by the caller for the first 4 register parameters.)* | -| Floating-point support | Floating-point parameters are not supported. | +| Shadow space | A 32-byte shadow space is reserved on the stack to maintain compatibility with profilers and debugging tools. *(Shadow space is a reserved area on the stack where register parameters can be spilled if needed. It's typically 32-bytes (4 registers × 8 bytes each) reserved by the caller for the first 4 register parameters.)* | +| Floating-point support | Floating-point parameters aren't supported. | | Name-decoration convention | Function names are decorated with @@_A suffix. | | Case-translation convention | No case translation performed. | @@ -40,8 +40,8 @@ The **`__preserve_none`** calling convention has the following restrictions: - **C only**: Only supported for C programs. - **x64 only**: Only supported on x64. -- **No floating-point**: Floating-point parameters are not supported. -- **No variadic functions**: Variadic functions (varargs) are not supported. +- **No floating-point**: Floating-point parameters aren't supported. +- **No variadic functions**: Variadic functions (varargs) aren't supported. - **Parameter limit**: Maximum of 10 parameters, all passed through registers. ## Use Cases @@ -49,7 +49,7 @@ The **`__preserve_none`** calling convention has the following restrictions: The **`__preserve_none`** calling convention is designed for performance-critical scenarios where: - Most functions in the codebase use the **`__preserve_none`** calling convention -- Used in conjunction with `msvc::musttail` to tail call between functions with no stack usage +- Used with `msvc::musttail` to tail call between functions with no stack usage - Minimizing register spilling is important for performance - The codebase is compatible with treating most registers as volatile From 6aed91d23a63f34525c2b5f02ba475c8bc0833a4 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 12 Feb 2026 11:27:40 -0800 Subject: [PATCH 1626/1799] address acrolinx --- docs/cpp/preserve-none.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cpp/preserve-none.md b/docs/cpp/preserve-none.md index 4022e4684e0..f90d613bc96 100644 --- a/docs/cpp/preserve-none.md +++ b/docs/cpp/preserve-none.md @@ -29,7 +29,7 @@ The following list shows the behavior of this calling convention. | Stack alignment | The stack must maintain 16-byte alignment. | | Frame pointer | The `rbp` register and frame chain follow the [/Gy switch](../build/reference/gy-enable-function-level-linking.md) settings. | | Stack-maintenance responsibility | The callee is responsible for cleaning up its own stack space. | -| Shadow space | A 32-byte shadow space is reserved on the stack to maintain compatibility with profilers and debugging tools. *(Shadow space is a reserved area on the stack where register parameters can be spilled if needed. It's typically 32-bytes (4 registers × 8 bytes each) reserved by the caller for the first 4 register parameters.)* | +| Shadow space | 32 bytes are reserved on the stack as a shadow space to maintain compatibility with profilers and debugging tools. *(Shadow space is a reserved area on the stack where register parameters can be spilled if needed. It's typically 32 bytes (4 registers × 8 bytes each) that the caller reserves for the first four register parameters.)* | | Floating-point support | Floating-point parameters aren't supported. | | Name-decoration convention | Function names are decorated with @@_A suffix. | | Case-translation convention | No case translation performed. | From 302a0dbd9924d352a0bdcf440feae6f7b40c1678 Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Fri, 13 Feb 2026 14:05:01 -0800 Subject: [PATCH 1627/1799] Tyler's feedback --- ...oubleshoot-vcredist-installation-issues.md | 136 ++++++++---------- 1 file changed, 57 insertions(+), 79 deletions(-) diff --git a/docs/windows/troubleshoot-vcredist-installation-issues.md b/docs/windows/troubleshoot-vcredist-installation-issues.md index 15b6b44e4f5..28681b02528 100644 --- a/docs/windows/troubleshoot-vcredist-installation-issues.md +++ b/docs/windows/troubleshoot-vcredist-installation-issues.md @@ -3,7 +3,7 @@ title: "Troubleshoot Visual C++ Redistributable installation issues" description: "Provide steps to diagnose and resolve issues with installing the Visual C++ Redistributable as a standalone installation and as part of the Visual Studio Installer." author: vicroms ms.author: viromer -ms.date: 02/10/2025 +ms.date: 02/12/2026 ms.topic: troubleshooting-general helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC Redist" ] --- @@ -11,21 +11,21 @@ helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC This guide is for users experiencing issues while installing the Visual C++ Runtime components using the Visual C++ Redistributable (VC Redist) installer or the Visual Studio (VS) Installer. -If you're experiencing such issues, we recommend that you first attempt installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). +If you're experiencing such issues, first try installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). ## Collect failure logs The first step to diagnose an issue with the Visual C++ Redistributable installer is to collect its failure logs. 1. Download the [Microsoft Visual Studio and .NET Log Collection Tool](). -2. Run `Collect.exe`. -3. Extract the contents of `%TEMP%/vscollect.zip`. +1. Run `Collect.exe`. +1. Extract the contents of `%TEMP%/vscollect.zip`. Once you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. ### Other log locations -The VC Redist installer is often executed as a prerequisite of other products, in such cases the installation log might be found in a different path. +The VC Redist installer is often executed as a prerequisite of other products. In such cases, the installation log might be found in a different path. For example, [Configuration Manager](/intune/configmgr/core/understand/introduction) upgrades VC Redist as part of its own upgrade process by running `vcredist_x64.exe` with the `/l` option that overrides the default log location. @@ -47,23 +47,23 @@ In such cases, the path to the logs can be found by reading that product's own l This section describes general troubleshooting methods you can try to resolve issues with the VC Redist installer. -### Method 1: Disable antivirus software temporarily +### Disable antivirus software temporarily Security products often block installation of VC Redist components. 1. Turn off Windows Defender real-time protection. -2. Disable any corporate endpoint protection temporarily (Symantec, McAfee, etc.). -3. Retry the installation. -4. Reenable any disabled protection software. +1. Disable any corporate endpoint protection temporarily (Symantec, McAfee, etc.). +1. Retry the installation. +1. Reenable any disabled protection software. -### Method 2: Run the Visual C++ Redistributable installer as Administrator +### Run the Visual C++ Redistributable installer as administrator File-access failures are heavily correlated with insufficient permissions. -1. Right-click the VC Redist installer and select **Run as administrator**. -2. Retry the installation. +1. Right-click the VC Redist installer and select **Run as Administrator**. +1. Retry the installation. -### Method 3: Check for Windows System Updates +### Check for Windows System Updates On rare occasions, outdated system components can cause installation issues. @@ -71,33 +71,32 @@ On rare occasions, outdated system components can cause installation issues. 2. Reboot your PC. 3. Retry the installation. -> [!IMPORTANT] -> The following troubleshooting methods apply when VC Redist is installed as a component of the Visual Studio Installer. +## General troubleshooting steps when using Visual Studio Installer -### Method 4: Manually Run the Visual C++ Redistributable installer +### Manually install Visual C++ Redistributable > [!NOTE] > The VS Installer might prompt for a reboot when VC Redist is installed separately. 1. Download the [latest VC Redist installer](latest-supported-vc-redist.md). -2. Run the VC Redist installer. -3. Retry the Visual Studio Installer. +1. Run the VC Redist installer. +1. Retry the Visual Studio Installer. If the manual installation fails, follow [methods 1 and 2](#method-1). -### Method 5: Clear the Visual Studio Installer cache +### Clear the Visual Studio Installer cache -1. Open `%ProgramData%\Microsoft\VisualStudio\Packages` -2. Delete all files inside the folder to force the Visual Studio Installer to regenerate them. -3. Retry the Visual Studio Installer. +1. Open `%ProgramData%\Microsoft\VisualStudio\Packages`. +1. Delete all files inside the folder to force the Visual Studio Installer to regenerate them. +1. Retry the Visual Studio Installer. -### Method 6: Repair the Visual Studio Installer +### Repair the Visual Studio Installer 1. Go to **Settings** > **Apps** > **Installed Apps** -2. Select **Visual Studio Installer** > **Modify** > **Repair** -3. Retry the Visual Studio Installer. +1. Select **Visual Studio Installer** > **Modify** > **Repair** +1. Retry the Visual Studio Installer. -### Method 7: Delete the Visual Studio Installer folder +### Delete the Visual Studio Installer folder > [!WARNING] > This method requires that you have the Visual Studio Installer Setup downloaded (VisualStudioSetup.exe). @@ -106,8 +105,8 @@ If the manual installation fails, follow [methods 1 and 2](#method-1). This method helps in case the installer metadata is corrupted, deleting the installer folder forces the Visual Studio Installer to regenerate it. 1. Download `VisualStudioSetup.exe` from . -2. Delete the folder `C:\Program Files (x86)\Microsoft Visual Studio\Installer`, you might be prompted to run this operation as Administrator. -3. Run `VisualStudioSetup.exe`. +1. Delete the folder `C:\Program Files (x86)\Microsoft Visual Studio\Installer`, you might be prompted to run this operation as administrator. +1. Run `VisualStudioSetup.exe`. ## Common issues @@ -123,35 +122,32 @@ If your issue isn't found here, then follow the instructions to [report an issue ### Access denied -An issue occurs during installation of VC Redist failing with return code 5. -The error code typically indicates a permissions issue; specifically, an access denied issue. +Installation fails with error code 5. This error code typically indicates a permissions issue; specifically, an access denied issue. **Steps to resolve** 1. Disable antivirus, group policies, and firewalls temporarily. -2. Run the VC Redist installer. -3. Reenable any disabled protection software. +1. Run the VC Redist installer. +1. Re-enable any disabled protection software. -If the installation fails, try to run the VC Redist installer as Administrator. +If the installation fails, try to run the VC Redist installer as administrator. ### File is locked -An issue occurs during the installation of VC Redist failing with return code 32. -Likely causes include blocked permissions, interference from antivirus, group policies, or corrupted files. +Installation fails with error code 32. This error code is tipically caused by locked files, interference from antivirus, group policies, or corrupted files. **Steps to resolve** 1. Close any running software in your PC. -2. Try the methods in [General troubleshooting steps](#general-troubleshooting-steps). +1. Try the methods in [General troubleshooting steps](#general-troubleshooting-steps). If the installation fails, try to restart your PC to release any locked files. ### Corrupt or invalid installer package -The issue involves an error during installation of VC Redist using the Visual Studio Installer with error code 1620. -Error code 1620 indicates that a Windows Installer package couldn't be opened, likely due to corruption or invalid files. +Installation fails with error code 1620. This error code indicates that a Windows Installer package (MSI) couldn't be opened, likely due to corruption or invalid files. -One or more of these error codes are present in the logs: +The presence of these error messages indicates a corrupted cache. - Error code 1620: indicates that the Windows Installer package couldn't be opened. - Error code 0x80091007: several payloads failed verification due to hash mismatches. @@ -159,17 +155,14 @@ One or more of these error codes are present in the logs: **Steps to resolve** -Methods 5, 6, and 7 in the [General troubleshoot steps](#file-is-locked) might help solve this issue by cleaning the package cache. +Try the steps in the [General troubleshooting steps when using Visual Studio Installer](#general-troubleshooting-steps-when-using-visual-studio-installer). ### Older version can't be removed -A corrupted Windows Installer cache produces error code 1714, indicating a failure to remove a previous version of VC Redist. +Installation fails with the error code 1714. This error code indicates a corrupted Windows installre cache that results in failure to remove a previous version of VC Redist. The presence of these error messages indicates a corrupted cache. -> [!NOTE] -> Timestamps are removed from these examples to condense the output. - In `dd_vcredist__.log` ```log @@ -205,56 +198,41 @@ From the log files, take note of the VC Redist version causing the issue. Method 1: Use the Windows Installer. -1. Try using the Windows Installer to manually remove the old VC Redist version. - If prompted, let the Windows Installer Troubleshooter attempt to fix the issue. -2. Retry the installation. +1. Try using the Windows Installer to manually remove the old VC Redist version. If prompted, let the Windows Installer Troubleshooter attempt to fix the issue. +1. Retry the installation. Method 2: Manually remove the old version. -1. Download the VC Redist installer for the old version by following the steps in - [Download old versions of the Visual C++ Redistributable installer](#old-vcredist-versions) -2. Run the installer to uninstall the old VC Redist. -3. Retry the installation. +1. Download the VC Redist installer for the old version. Follow the [steps to download and old version of the VC Redist installer](#old-vcredist-versions) +1. Run the installer to uninstall the old VC Redist. +1. Retry the installation. ## Download old versions of the Visual C++ Redistributable installer > [!WARNING] > Never install a Visual C++ Redistributable installer that wasn't downloaded from a Microsoft site. -The VC Redist installer can be downloaded from [my.visualstudio.com](), search for Visual C++ Redistributable +Download the VC Redist installer from [my.visualstudio.com](). Search for Visual C++ Redistributable on the downloads page. The latest supported VC Redist version for each version of Visual Studio can be found in [this article](/cpp/windows/latest-supported-vc-redist). -To access older or legacy versions follow these steps: - -**Version 14.50 or later** - -The download links use the `https://aka.ms/vs/18/release//VC_redist..exe` pattern. -For example: . - -**Version 14.30 to 14.44** - -The download links use the `https://aka.ms/vs/17/release//VC_redist..exe` pattern. -For example: . - -**Version 14.20 to 14.29** - -The download links use the `https://aka.ms/vs/16/release//VC_redist..exe` pattern. -For example: - -**Version 14.10 or later** +Links for older or legacy versions: -The download links use the `https://aka.ms/vs/15/release//VC_redist..exe` pattern. -For example: +| Version range | Download link template | Example | +|----------------|---------------------------------------------------------------|----------------------------------------------------------------| +| 14.50 or later | `https://aka.ms/vs/18/release//VC_redist..exe` | | +| 14.30 to 14.44 | `https://aka.ms/vs/17/release//VC_redist..exe` | | +| 14.20 to 14.29 | `https://aka.ms/vs/16/release//VC_redist..exe` | | +| 14.10 to 14.19 | `https://aka.ms/vs/15/release//VC_redist..exe` | | -If the aka.ms links don't work, you might be able to find the version you're looking for through a Bing search. +You might be able to find installers for older versions through a Bing search. However, make sure that the download comes from a Microsoft site and that the installer is signed by Microsoft. ## Report a Visual C++ Redistributable installation problem The list of [common issues](#common-issues) was collected from feedback reported to Microsoft through [Developer Community](). -If you encounter an issue not found in that section, or if the steps in this troubleshooting guide don't resolve your issue. Use the [Report a Problem]() form to create a new feedback item. +If you encounter an issue not found in that section, or if the steps in this troubleshooting guide don't resolve your issue, use the [Report a Problem]() form to create a new feedback item. Your report must include the following information about your environment: @@ -263,11 +241,11 @@ Your report must include the following information about your environment: - If installing through the Visual Studio Installer, version of the VS Installer. - Logs collected by following the steps in the [Collect failure logs](#collect-failure-logs) section. -Feedback without this information, especially without logs, is nonactionable and might be closed if additional information isn't submitted promptly. +Feedback without this information, especially without logs, is nonactionable and may be closed if additional information isn't submitted promptly. ## See also -- [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) -- [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) -- [How to audit Visual C++ Runtime version usage](redist-version-auditing.md) -- [Lifecycle FAQ - Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) +[Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md)\ +[C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md)\ +[How to audit Visual C++ Runtime version usage](redist-version-auditing.md)\ +[Lifecycle FAQ - Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) From b67997ce6b8bc0429e2b65991e041618b4a3ecba Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Fri, 13 Feb 2026 14:16:34 -0800 Subject: [PATCH 1628/1799] Add common errors at a glance section suggested by Tyler --- ...troubleshoot-vcredist-installation-issues.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/windows/troubleshoot-vcredist-installation-issues.md b/docs/windows/troubleshoot-vcredist-installation-issues.md index 28681b02528..1b812a36678 100644 --- a/docs/windows/troubleshoot-vcredist-installation-issues.md +++ b/docs/windows/troubleshoot-vcredist-installation-issues.md @@ -82,7 +82,7 @@ On rare occasions, outdated system components can cause installation issues. 1. Run the VC Redist installer. 1. Retry the Visual Studio Installer. -If the manual installation fails, follow [methods 1 and 2](#method-1). +If the manual installation fails, follow the [general troubleshooting steps for the standalone VC Redist installer](#general-troubleshooting-steps). ### Clear the Visual Studio Installer cache @@ -110,6 +110,14 @@ This method helps in case the installer metadata is corrupted, deleting the inst ## Common issues +### Common errors at a glance + +* [Generic installation failure (return code 1603)](#return-code-1603) +* [Access denied (return code 5)](#access-denied) +* [File is locked (return code 32)](#file-is-locked) +* [Corrupt or invliad installer package (return code 1620)](#corrupt-or-invalid-installer-package) +* [Older version can't be removed (return code 1714)](#older-version-cant-be-removed) + ### Return code 1603 Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ Runtime components. @@ -134,7 +142,7 @@ If the installation fails, try to run the VC Redist installer as administrator. ### File is locked -Installation fails with error code 32. This error code is tipically caused by locked files, interference from antivirus, group policies, or corrupted files. +Installation fails with error code 32. Files in use by another process, interference from antivirus software, group policies, or corrupted files are common causes. **Steps to resolve** @@ -159,7 +167,7 @@ Try the steps in the [General troubleshooting steps when using Visual Studio Ins ### Older version can't be removed -Installation fails with the error code 1714. This error code indicates a corrupted Windows installre cache that results in failure to remove a previous version of VC Redist. +Installation fails with the error code 1714. This error code indicates a corrupted Windows Installer cache that results in failure to remove a previous version of VC Redist. The presence of these error messages indicates a corrupted cache. @@ -211,6 +219,7 @@ Method 2: Manually remove the old version. > [!WARNING] > Never install a Visual C++ Redistributable installer that wasn't downloaded from a Microsoft site. +> Never install a Visual C++ Redistributable installer that isn't signed by Microsoft. Download the VC Redist installer from [my.visualstudio.com](). Search for Visual C++ Redistributable on the downloads page. @@ -226,7 +235,7 @@ Links for older or legacy versions: | 14.10 to 14.19 | `https://aka.ms/vs/15/release//VC_redist..exe` | | You might be able to find installers for older versions through a Bing search. -However, make sure that the download comes from a Microsoft site and that the installer is signed by Microsoft. +Only download VC Redist installers from a Microsoft site. Only install packages signed by Microsoft. ## Report a Visual C++ Redistributable installation problem From 1dff244a56d89ea8b99d6b188137852710b4be70 Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Tue, 17 Feb 2026 12:21:36 -0800 Subject: [PATCH 1629/1799] Apply suggestions from code review Co-authored-by: David Justo --- docs/windows/troubleshoot-vcredist-installation-issues.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/windows/troubleshoot-vcredist-installation-issues.md b/docs/windows/troubleshoot-vcredist-installation-issues.md index 1b812a36678..9bef634a4a6 100644 --- a/docs/windows/troubleshoot-vcredist-installation-issues.md +++ b/docs/windows/troubleshoot-vcredist-installation-issues.md @@ -1,6 +1,6 @@ --- title: "Troubleshoot Visual C++ Redistributable installation issues" -description: "Provide steps to diagnose and resolve issues with installing the Visual C++ Redistributable as a standalone installation and as part of the Visual Studio Installer." +description: "Provide steps to diagnose and resolve issues when installing the Visual C++ Redistributable." author: vicroms ms.author: viromer ms.date: 02/12/2026 @@ -9,9 +9,9 @@ helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC --- # Troubleshoot Visual C++ Redistributable installation issues -This guide is for users experiencing issues while installing the Visual C++ Runtime components using the Visual C++ Redistributable (VC Redist) installer or the Visual Studio (VS) Installer. +This guide is for users experiencing issues installing Visual C++ Runtime components using the Visual Studio (VS) Installer or the Visual C++ Redistributable (VC Redist) installer. -If you're experiencing such issues, first try installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). +If you experience any issues, start by ensuring you're installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). ## Collect failure logs @@ -118,7 +118,7 @@ This method helps in case the installer metadata is corrupted, deleting the inst * [Corrupt or invliad installer package (return code 1620)](#corrupt-or-invalid-installer-package) * [Older version can't be removed (return code 1714)](#older-version-cant-be-removed) -### Return code 1603 +### Generic installation failure Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ Runtime components. From 571f52c88d332f4fa979c9011916bf7fec9bf44f Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Wed, 18 Feb 2026 10:38:08 -0800 Subject: [PATCH 1630/1799] Partially implement David's comments --- docs/windows/latest-supported-vc-redist.md | 4 +-- docs/windows/toc.yml | 2 +- ...vc-redistributable-installation-issues.md} | 27 ++++++++++++------- 3 files changed, 21 insertions(+), 12 deletions(-) rename docs/windows/{troubleshoot-vcredist-installation-issues.md => troubleshoot-vc-redistributable-installation-issues.md} (93%) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 51c36772683..c72d23054e1 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -20,8 +20,8 @@ ms.author: msaleh > [!NOTE] > Are you here to download Visual Studio? Go to [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/). -> [!NOTE] -> Having issues installing the Visual C++ Redistributable? Check out the [troubleshooting guide](troubleshoot-vcredist-installation-issues.md). +> [!TIP] +> Having issues installing the Visual C++ Redistributable? Check out the [troubleshooting guide](troubleshoot-vc-redistributable-installation-issues.md). This topic is for developers who need to install the Visual C++ runtime libraries with their app. If you're an end user trying to fix an app by updating the Visual C++ runtime libraries, contact the app vendor for instructions. diff --git a/docs/windows/toc.yml b/docs/windows/toc.yml index b0efca5195d..7afc39d94e9 100644 --- a/docs/windows/toc.yml +++ b/docs/windows/toc.yml @@ -150,7 +150,7 @@ items: - name: How to audit Visual C++ Runtime version usage href: ../windows/redist-version-auditing.md - name: Troubleshoot Visual C++ Redistributable installation issues - href: ../windows/troubleshoot-vcredist-installation-issues.md + href: ../windows/troubleshoot-vc-redistributable-installation-issues.md - name: Deployment examples expanded: false items: diff --git a/docs/windows/troubleshoot-vcredist-installation-issues.md b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md similarity index 93% rename from docs/windows/troubleshoot-vcredist-installation-issues.md rename to docs/windows/troubleshoot-vc-redistributable-installation-issues.md index 9bef634a4a6..b58314811d8 100644 --- a/docs/windows/troubleshoot-vcredist-installation-issues.md +++ b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md @@ -23,6 +23,8 @@ The first step to diagnose an issue with the Visual C++ Redistributable installe Once you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. +Once you have located the VC Redist installer logs, search for words like "Error", "Failed", or "System Error" and consult the [Common Errors](#common-errors-at-a-glance) to identify the issue. + ### Other log locations The VC Redist installer is often executed as a prerequisite of other products. In such cases, the installation log might be found in a different path. @@ -43,19 +45,23 @@ In such cases, the path to the logs can be found by reading that product's own l 10-31-2025 17:40:14.554 CONFIGURATION_MANAGER_UPDATE 67368 (0x10728) Failed to install vc redist. Please manually install it from C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64 ``` -## General troubleshooting steps +## General troubleshooting steps when using the Visual C++ Redistributable installer This section describes general troubleshooting methods you can try to resolve issues with the VC Redist installer. ### Disable antivirus software temporarily -Security products often block installation of VC Redist components. +Antivirus software often block installation of VC Redist components. 1. Turn off Windows Defender real-time protection. 1. Disable any corporate endpoint protection temporarily (Symantec, McAfee, etc.). 1. Retry the installation. 1. Reenable any disabled protection software. +> [!WARNING] +> Re-enable any disabled protection software after completing these steps. + + ### Run the Visual C++ Redistributable installer as administrator File-access failures are heavily correlated with insufficient permissions. @@ -63,7 +69,7 @@ File-access failures are heavily correlated with insufficient permissions. 1. Right-click the VC Redist installer and select **Run as Administrator**. 1. Retry the installation. -### Check for Windows System Updates +### Check for Windows updates On rare occasions, outdated system components can cause installation issues. @@ -71,7 +77,7 @@ On rare occasions, outdated system components can cause installation issues. 2. Reboot your PC. 3. Retry the installation. -## General troubleshooting steps when using Visual Studio Installer +## General troubleshooting steps when using the Visual Studio Installer ### Manually install Visual C++ Redistributable @@ -82,7 +88,7 @@ On rare occasions, outdated system components can cause installation issues. 1. Run the VC Redist installer. 1. Retry the Visual Studio Installer. -If the manual installation fails, follow the [general troubleshooting steps for the standalone VC Redist installer](#general-troubleshooting-steps). +If the manual installation fails, follow the [general troubleshooting steps for the standalone VC Redist installer](#general-troubleshooting-steps-when-using-the-visual-c-redistributable-installer). ### Clear the Visual Studio Installer cache @@ -92,9 +98,12 @@ If the manual installation fails, follow the [general troubleshooting steps for ### Repair the Visual Studio Installer -1. Go to **Settings** > **Apps** > **Installed Apps** -1. Select **Visual Studio Installer** > **Modify** > **Repair** -1. Retry the Visual Studio Installer. +1. Open the **Settings** app. +1. Search for **Installed Apps** using the search bar at the top of the window. +1. Search for **Visual Studio Installer**. +1. Click on the "**...**" button and select **Modify** from the drowdown list. +1. Select the optin to **Repair** the Visual Studio Installer. +1. Retry the VS installation. ### Delete the Visual Studio Installer folder @@ -147,7 +156,7 @@ Installation fails with error code 32. Files in use by another process, interfer **Steps to resolve** 1. Close any running software in your PC. -1. Try the methods in [General troubleshooting steps](#general-troubleshooting-steps). +1. Try the methods in [General troubleshooting steps](#general-troubleshooting-steps-when-using-the-visual-c-redistributable-installer). If the installation fails, try to restart your PC to release any locked files. From e52e991861c94f1e704f271d48537850defca912 Mon Sep 17 00:00:00 2001 From: Victor Romero Date: Wed, 18 Feb 2026 12:54:06 -0800 Subject: [PATCH 1631/1799] Fix broken links and acrolynx issues --- docs/windows/latest-supported-vc-redist.md | 2 +- ...leshoot-vc-redistributable-installation-issues.md | 12 ++++++------ 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index c72d23054e1..eda803ceaad 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -145,7 +145,7 @@ Download Redistributable files for other languages and architectures from: - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) - [How to audit Visual C++ Runtime version usage](redist-version-auditing.md) - [Lifecycle FAQ - Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) -- [Troubleshoot Visual C++ Redistributable installation issues](troubleshoot-vcredist-installation-issues.md) +- [Troubleshoot Visual C++ Redistributable installation issues](troubleshoot-vc-redistributable-installation-issues.md) **Release notes** diff --git a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md index b58314811d8..9698ba5a3ff 100644 --- a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md +++ b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md @@ -23,7 +23,7 @@ The first step to diagnose an issue with the Visual C++ Redistributable installe Once you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. -Once you have located the VC Redist installer logs, search for words like "Error", "Failed", or "System Error" and consult the [Common Errors](#common-errors-at-a-glance) to identify the issue. +Search the VC Redist logs for terms like "Error", "Failed", or "System Error" and consult the [Common Errors](#common-errors-at-a-glance) to identify the issue. ### Other log locations @@ -51,7 +51,7 @@ This section describes general troubleshooting methods you can try to resolve is ### Disable antivirus software temporarily -Antivirus software often block installation of VC Redist components. +Antivirus software often blocks installation of VC Redist components. 1. Turn off Windows Defender real-time protection. 1. Disable any corporate endpoint protection temporarily (Symantec, McAfee, etc.). @@ -77,7 +77,7 @@ On rare occasions, outdated system components can cause installation issues. 2. Reboot your PC. 3. Retry the installation. -## General troubleshooting steps when using the Visual Studio Installer +## General troubleshooting steps when using Visual Studio Installer ### Manually install Visual C++ Redistributable @@ -101,8 +101,8 @@ If the manual installation fails, follow the [general troubleshooting steps for 1. Open the **Settings** app. 1. Search for **Installed Apps** using the search bar at the top of the window. 1. Search for **Visual Studio Installer**. -1. Click on the "**...**" button and select **Modify** from the drowdown list. -1. Select the optin to **Repair** the Visual Studio Installer. +1. Click on the "**...**" button and select **Modify**. +1. Select the option to **Repair** the Visual Studio Installer. 1. Retry the VS installation. ### Delete the Visual Studio Installer folder @@ -121,7 +121,7 @@ This method helps in case the installer metadata is corrupted, deleting the inst ### Common errors at a glance -* [Generic installation failure (return code 1603)](#return-code-1603) +* [Generic installation failure (return code 1603)](#generic-installation-failure) * [Access denied (return code 5)](#access-denied) * [File is locked (return code 32)](#file-is-locked) * [Corrupt or invliad installer package (return code 1620)](#corrupt-or-invalid-installer-package) From 7c1109fe42534ada89a4201f87acf8912718e27f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 20 Feb 2026 11:02:44 -0800 Subject: [PATCH 1632/1799] Batch 7: update files --- docs/mfc/reference/cjumplist-class.md | 4 +++- docs/mfc/reference/ckeyboardmanager-class.md | 4 +++- docs/mfc/reference/ckeyframe-class.md | 4 +++- docs/mfc/reference/class-factories-and-licensing.md | 4 +++- .../classes-and-functions-generated-by-the-mfc-dll-wizard.md | 4 +++- docs/mfc/reference/clineartransition-class.md | 4 +++- docs/mfc/reference/clineartransitionfromspeed-class.md | 4 +++- docs/mfc/reference/clinkctrl-class.md | 4 +++- docs/mfc/reference/clist-class.md | 4 +++- docs/mfc/reference/clistbox-class.md | 4 +++- docs/mfc/reference/clistctrl-class.md | 3 +++ docs/mfc/reference/clistview-class.md | 4 +++- docs/mfc/reference/clongbinary-class.md | 4 +++- docs/mfc/reference/cmap-class.md | 4 +++- docs/mfc/reference/cmapptrtoptr-class.md | 4 +++- docs/mfc/reference/cmapptrtoword-class.md | 4 +++- docs/mfc/reference/cmapstringtoob-class.md | 3 +++ docs/mfc/reference/cmapstringtoptr-class.md | 4 +++- docs/mfc/reference/cmapstringtostring-class.md | 4 +++- docs/mfc/reference/cmapwordtoob-class.md | 4 +++- docs/mfc/reference/cmapwordtoptr-class.md | 4 +++- docs/mfc/reference/cmdichildwnd-class.md | 4 +++- docs/mfc/reference/cmdichildwndex-class.md | 3 +++ docs/mfc/reference/cmdiframewnd-class.md | 4 +++- docs/mfc/reference/cmdiframewndex-class.md | 3 +++ docs/mfc/reference/cmditabinfo-class.md | 3 +++ docs/mfc/reference/cmemfile-class.md | 3 +++ docs/mfc/reference/cmemoryexception-class.md | 4 +++- docs/mfc/reference/cmemorystate-structure.md | 4 +++- docs/mfc/reference/cmenu-class.md | 4 +++- docs/mfc/reference/cmenutearoffmanager-class.md | 4 +++- docs/mfc/reference/cmetafiledc-class.md | 4 +++- docs/mfc/reference/cmfcacceleratorkey-class.md | 4 +++- docs/mfc/reference/cmfcacceleratorkeyassignctrl-class.md | 4 +++- docs/mfc/reference/cmfcautohidebar-class.md | 4 +++- docs/mfc/reference/cmfcautohidebutton-class.md | 4 +++- docs/mfc/reference/cmfcbasetabctrl-class.md | 3 +++ docs/mfc/reference/cmfcbasetoolbar-class.md | 4 +++- docs/mfc/reference/cmfcbasevisualmanager-class.md | 4 +++- docs/mfc/reference/cmfcbutton-class.md | 3 +++ docs/mfc/reference/cmfccaptionbar-class.md | 4 +++- docs/mfc/reference/cmfccaptionbutton-class.md | 4 +++- docs/mfc/reference/cmfccmdusagecount-class.md | 4 +++- docs/mfc/reference/cmfccolorbar-class.md | 4 +++- docs/mfc/reference/cmfccolorbutton-class.md | 4 +++- docs/mfc/reference/cmfccolordialog-class.md | 4 +++- docs/mfc/reference/cmfccolormenubutton-class.md | 4 +++- docs/mfc/reference/cmfccolorpickerctrl-class.md | 3 +++ docs/mfc/reference/cmfccolorpopupmenu-class.md | 4 +++- docs/mfc/reference/cmfccustomcolorspropertypage-class.md | 4 +++- docs/mfc/reference/cmfcdesktopalertdialog-class.md | 4 +++- docs/mfc/reference/cmfcdesktopalertwnd-class.md | 4 +++- docs/mfc/reference/cmfcdesktopalertwndbutton-class.md | 4 +++- docs/mfc/reference/cmfcdesktopalertwndinfo-class.md | 4 +++- docs/mfc/reference/cmfcdisablemenuanimation-class.md | 4 +++- docs/mfc/reference/cmfcdragframeimpl-class.md | 4 +++- docs/mfc/reference/cmfcdropdownframe-class.md | 4 +++- docs/mfc/reference/cmfcdropdowntoolbar-class.md | 4 +++- docs/mfc/reference/cmfcdropdowntoolbarbutton-class.md | 4 +++- docs/mfc/reference/cmfcdynamiclayout-class.md | 3 +++ docs/mfc/reference/cmfceditbrowsectrl-class.md | 3 +++ docs/mfc/reference/cmfcfilterchunkvalueimpl-class.md | 4 +++- docs/mfc/reference/cmfcfontcombobox-class.md | 4 +++- docs/mfc/reference/cmfcfontinfo-class.md | 4 +++- docs/mfc/reference/cmfcheaderctrl-class.md | 4 +++- docs/mfc/reference/cmfcimageeditordialog-class.md | 4 +++- docs/mfc/reference/cmfcimageeditorpalettebar-class.md | 4 +++- docs/mfc/reference/cmfcimagepaintarea-class.md | 4 +++- .../cmfcimagepaintarea-image-edit-mode-enumeration.md | 4 +++- docs/mfc/reference/cmfckeymapdialog-class.md | 4 +++- docs/mfc/reference/cmfclinkctrl-class.md | 4 +++- docs/mfc/reference/cmfclistctrl-class.md | 3 +++ docs/mfc/reference/cmfcmaskededit-class.md | 4 +++- docs/mfc/reference/cmfcmenubar-class.md | 3 +++ docs/mfc/reference/cmfcmenubutton-class.md | 4 +++- docs/mfc/reference/cmfcoutlookbar-class.md | 4 +++- docs/mfc/reference/cmfcoutlookbarpane-class.md | 4 +++- docs/mfc/reference/cmfcoutlookbartabctrl-class.md | 4 +++- docs/mfc/reference/cmfcpopupmenu-class.md | 4 +++- docs/mfc/reference/cmfcpopupmenubar-class.md | 4 +++- docs/mfc/reference/cmfcpreviewctrlimpl-class.md | 3 +++ docs/mfc/reference/cmfcprintpreviewtoolbar-class.md | 4 +++- docs/mfc/reference/cmfcpropertygridcolorproperty-class.md | 4 +++- docs/mfc/reference/cmfcpropertygridctrl-class.md | 3 +++ docs/mfc/reference/cmfcpropertygridfileproperty-class.md | 4 +++- docs/mfc/reference/cmfcpropertygridfontproperty-class.md | 4 +++- docs/mfc/reference/cmfcpropertygridproperty-class.md | 3 +++ docs/mfc/reference/cmfcpropertygridtooltipctrl-class.md | 4 +++- docs/mfc/reference/cmfcpropertypage-class.md | 4 +++- docs/mfc/reference/cmfcpropertysheet-class.md | 4 +++- docs/mfc/reference/cmfcrebar-class.md | 4 +++- docs/mfc/reference/cmfcribbonapplicationbutton-class.md | 4 +++- docs/mfc/reference/cmfcribbonbar-class.md | 3 +++ docs/mfc/reference/cmfcribbonbaseelement-class.md | 3 +++ docs/mfc/reference/cmfcribbonbutton-class.md | 4 +++- docs/mfc/reference/cmfcribbonbuttonsgroup-class.md | 4 +++- docs/mfc/reference/cmfcribboncategory-class.md | 3 +++ docs/mfc/reference/cmfcribboncheckbox-class.md | 3 +++ docs/mfc/reference/cmfcribboncolorbutton-class.md | 4 +++- docs/mfc/reference/cmfcribboncombobox-class.md | 3 +++ 100 files changed, 300 insertions(+), 79 deletions(-) diff --git a/docs/mfc/reference/cjumplist-class.md b/docs/mfc/reference/cjumplist-class.md index e924d7a4a7c..140ef4a93e0 100644 --- a/docs/mfc/reference/cjumplist-class.md +++ b/docs/mfc/reference/cjumplist-class.md @@ -4,10 +4,12 @@ title: "CJumpList Class" ms.date: "03/27/2019" f1_keywords: ["CJumpList", "AFXADV/CJumpList", "AFXADV/CJumpList::CJumpList", "AFXADV/CJumpList::AbortList", "AFXADV/CJumpList::AddDestination", "AFXADV/CJumpList::AddKnownCategory", "AFXADV/CJumpList::AddTask", "AFXADV/CJumpList::AddTasks", "AFXADV/CJumpList::AddTaskSeparator", "AFXADV/CJumpList::ClearAll", "AFXADV/CJumpList::ClearAllDestinations", "AFXADV/CJumpList::CommitList", "AFXADV/CJumpList::GetDestinationList", "AFXADV/CJumpList::GetMaxSlots", "AFXADV/CJumpList::GetRemovedItems", "AFXADV/CJumpList::InitializeList", "AFXADV/CJumpList::SetAppID"] helpviewer_keywords: ["CJumpList [MFC], CJumpList", "CJumpList [MFC], AbortList", "CJumpList [MFC], AddDestination", "CJumpList [MFC], AddKnownCategory", "CJumpList [MFC], AddTask", "CJumpList [MFC], AddTasks", "CJumpList [MFC], AddTaskSeparator", "CJumpList [MFC], ClearAll", "CJumpList [MFC], ClearAllDestinations", "CJumpList [MFC], CommitList", "CJumpList [MFC], GetDestinationList", "CJumpList [MFC], GetMaxSlots", "CJumpList [MFC], GetRemovedItems", "CJumpList [MFC], InitializeList", "CJumpList [MFC], SetAppID"] -ms.assetid: d364d27e-f512-4b12-9872-c2a17c78ab1f --- # CJumpList Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A `CJumpList` is the list of shortcuts revealed when you right-click on an icon in the task bar. ## Syntax diff --git a/docs/mfc/reference/ckeyboardmanager-class.md b/docs/mfc/reference/ckeyboardmanager-class.md index 028992b0d67..19cfdf860e3 100644 --- a/docs/mfc/reference/ckeyboardmanager-class.md +++ b/docs/mfc/reference/ckeyboardmanager-class.md @@ -4,10 +4,12 @@ title: "CKeyboardManager Class" ms.date: "11/04/2016" f1_keywords: ["CKeyboardManager", "AFXKEYBOARDMANAGER/CKeyboardManager", "AFXKEYBOARDMANAGER/CKeyboardManager::CKeyboardManager", "AFXKEYBOARDMANAGER/CKeyboardManager::CleanUp", "AFXKEYBOARDMANAGER/CKeyboardManager::FindDefaultAccelerator", "AFXKEYBOARDMANAGER/CKeyboardManager::IsKeyHandled", "AFXKEYBOARDMANAGER/CKeyboardManager::IsKeyPrintable", "AFXKEYBOARDMANAGER/CKeyboardManager::IsShowAllAccelerators", "AFXKEYBOARDMANAGER/CKeyboardManager::LoadState", "AFXKEYBOARDMANAGER/CKeyboardManager::ResetAll", "AFXKEYBOARDMANAGER/CKeyboardManager::SaveState", "AFXKEYBOARDMANAGER/CKeyboardManager::ShowAllAccelerators", "AFXKEYBOARDMANAGER/CKeyboardManager::TranslateCharToUpper", "AFXKEYBOARDMANAGER/CKeyboardManager::UpdateAccelTable"] helpviewer_keywords: ["CKeyboardManager [MFC], CKeyboardManager", "CKeyboardManager [MFC], CleanUp", "CKeyboardManager [MFC], FindDefaultAccelerator", "CKeyboardManager [MFC], IsKeyHandled", "CKeyboardManager [MFC], IsKeyPrintable", "CKeyboardManager [MFC], IsShowAllAccelerators", "CKeyboardManager [MFC], LoadState", "CKeyboardManager [MFC], ResetAll", "CKeyboardManager [MFC], SaveState", "CKeyboardManager [MFC], ShowAllAccelerators", "CKeyboardManager [MFC], TranslateCharToUpper", "CKeyboardManager [MFC], UpdateAccelTable"] -ms.assetid: 4809ece6-89df-4479-8b53-9bf476ee107b --- # CKeyboardManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages shortcut key tables for the main frame window and child frame windows. ## Syntax diff --git a/docs/mfc/reference/ckeyframe-class.md b/docs/mfc/reference/ckeyframe-class.md index 295550b2edc..fab2e6461a0 100644 --- a/docs/mfc/reference/ckeyframe-class.md +++ b/docs/mfc/reference/ckeyframe-class.md @@ -4,10 +4,12 @@ title: "CKeyFrame Class" ms.date: "11/04/2016" f1_keywords: ["CKeyFrame", "AFXANIMATIONCONTROLLER/CKeyFrame", "AFXANIMATIONCONTROLLER/CKeyFrame::CKeyFrame", "AFXANIMATIONCONTROLLER/CKeyFrame::AddToStoryboard", "AFXANIMATIONCONTROLLER/CKeyFrame::AddToStoryboardAfterTransition", "AFXANIMATIONCONTROLLER/CKeyFrame::AddToStoryboardAtOffset", "AFXANIMATIONCONTROLLER/CKeyFrame::GetExistingKeyframe", "AFXANIMATIONCONTROLLER/CKeyFrame::GetOffset", "AFXANIMATIONCONTROLLER/CKeyFrame::GetTransition", "AFXANIMATIONCONTROLLER/CKeyFrame::m_offset", "AFXANIMATIONCONTROLLER/CKeyFrame::m_pExistingKeyFrame", "AFXANIMATIONCONTROLLER/CKeyFrame::m_pTransition"] helpviewer_keywords: ["CKeyFrame [MFC], CKeyFrame", "CKeyFrame [MFC], AddToStoryboard", "CKeyFrame [MFC], AddToStoryboardAfterTransition", "CKeyFrame [MFC], AddToStoryboardAtOffset", "CKeyFrame [MFC], GetExistingKeyframe", "CKeyFrame [MFC], GetOffset", "CKeyFrame [MFC], GetTransition", "CKeyFrame [MFC], m_offset", "CKeyFrame [MFC], m_pExistingKeyFrame", "CKeyFrame [MFC], m_pTransition"] -ms.assetid: d050a562-20f6-4c65-8ce5-ccb3aef1a20e --- # CKeyFrame Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an animation keyframe. ## Syntax diff --git a/docs/mfc/reference/class-factories-and-licensing.md b/docs/mfc/reference/class-factories-and-licensing.md index fb570c46f96..eb2f2f98254 100644 --- a/docs/mfc/reference/class-factories-and-licensing.md +++ b/docs/mfc/reference/class-factories-and-licensing.md @@ -3,10 +3,12 @@ description: "Learn more about: Class Factories and Licensing" title: "Class Factories and Licensing" ms.date: "11/04/2016" helpviewer_keywords: ["class factories [MFC], and licensing"] -ms.assetid: 53c4856a-4062-46db-9f69-dd4339f746b3 --- # Class Factories and Licensing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To create an instance of your OLE control, a container application calls a member function of the control's class factory. Because your control is an actual OLE object, the class factory is responsible for creating instances of your control. Every OLE control class must have a class factory. Another important feature of OLE controls is their ability to enforce a license. ControlWizard allows you to incorporate licensing during the creation of your control project. For more information on control licensing, see the article [ActiveX Controls: Licensing An ActiveX Control](../../mfc/mfc-activex-controls-licensing-an-activex-control.md). diff --git a/docs/mfc/reference/classes-and-functions-generated-by-the-mfc-dll-wizard.md b/docs/mfc/reference/classes-and-functions-generated-by-the-mfc-dll-wizard.md index 8a8852ea8bd..c0db5403493 100644 --- a/docs/mfc/reference/classes-and-functions-generated-by-the-mfc-dll-wizard.md +++ b/docs/mfc/reference/classes-and-functions-generated-by-the-mfc-dll-wizard.md @@ -3,10 +3,12 @@ description: "Learn more about: Classes and Functions Generated by the MFC DLL W title: "Classes and Functions Generated by the MFC DLL Wizard" ms.date: "11/04/2016" helpviewer_keywords: ["functions [MFC]", "functions [MFC], DLLs", "MFC DLL Wizard", "DLLs [MFC], wizard classes and functions", "classes [MFC], generated by MFC DLL wizard", "code [MFC], generated by MFC DLL wizard"] -ms.assetid: e69e62fe-4953-42bf-a2fc-50bbf9bdaeaf --- # Classes and Functions Generated by the MFC DLL Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The code that the MFC DLL Wizard generates depends on the kind of DLL you are creating and the options you have selected. The MFC DLL Wizard generates the same code for both forms of regular MFC DLLs. |Kind of DLL|Option|Classes|Functions| diff --git a/docs/mfc/reference/clineartransition-class.md b/docs/mfc/reference/clineartransition-class.md index db00d95751a..4fc9741cd95 100644 --- a/docs/mfc/reference/clineartransition-class.md +++ b/docs/mfc/reference/clineartransition-class.md @@ -4,10 +4,12 @@ title: "CLinearTransition Class" ms.date: "11/04/2016" f1_keywords: ["CLinearTransition", "AFXANIMATIONCONTROLLER/CLinearTransition", "AFXANIMATIONCONTROLLER/CLinearTransition::CLinearTransition", "AFXANIMATIONCONTROLLER/CLinearTransition::Create", "AFXANIMATIONCONTROLLER/CLinearTransition::m_dblFinalValue", "AFXANIMATIONCONTROLLER/CLinearTransition::m_duration"] helpviewer_keywords: ["CLinearTransition [MFC], CLinearTransition", "CLinearTransition [MFC], Create", "CLinearTransition [MFC], m_dblFinalValue", "CLinearTransition [MFC], m_duration"] -ms.assetid: 7fcb2dba-beb8-4933-9f5d-3b7fb1585ef0 --- # CLinearTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a linear transition. ## Syntax diff --git a/docs/mfc/reference/clineartransitionfromspeed-class.md b/docs/mfc/reference/clineartransitionfromspeed-class.md index 543e8eb4232..7054525da73 100644 --- a/docs/mfc/reference/clineartransitionfromspeed-class.md +++ b/docs/mfc/reference/clineartransitionfromspeed-class.md @@ -4,10 +4,12 @@ title: "CLinearTransitionFromSpeed Class" ms.date: "11/04/2016" f1_keywords: ["CLinearTransitionFromSpeed", "AFXANIMATIONCONTROLLER/CLinearTransitionFromSpeed", "AFXANIMATIONCONTROLLER/CLinearTransitionFromSpeed::CLinearTransitionFromSpeed", "AFXANIMATIONCONTROLLER/CLinearTransitionFromSpeed::Create", "AFXANIMATIONCONTROLLER/CLinearTransitionFromSpeed::m_dblFinalValue", "AFXANIMATIONCONTROLLER/CLinearTransitionFromSpeed::m_dblSpeed"] helpviewer_keywords: ["CLinearTransitionFromSpeed [MFC], CLinearTransitionFromSpeed", "CLinearTransitionFromSpeed [MFC], Create", "CLinearTransitionFromSpeed [MFC], m_dblFinalValue", "CLinearTransitionFromSpeed [MFC], m_dblSpeed"] -ms.assetid: 8f159a1c-8893-4017-951e-09e5758aba7d --- # CLinearTransitionFromSpeed Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a linear-speed transition. ## Syntax diff --git a/docs/mfc/reference/clinkctrl-class.md b/docs/mfc/reference/clinkctrl-class.md index 11601a0c130..0b0c0f80cc6 100644 --- a/docs/mfc/reference/clinkctrl-class.md +++ b/docs/mfc/reference/clinkctrl-class.md @@ -4,10 +4,12 @@ title: "CLinkCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CLinkCtrl", "AFXCMN/CLinkCtrl", "AFXCMN/CLinkCtrl::CLinkCtrl", "AFXCMN/CLinkCtrl::Create", "AFXCMN/CLinkCtrl::CreateEx", "AFXCMN/CLinkCtrl::GetIdealHeight", "AFXCMN/CLinkCtrl::GetIdealSize", "AFXCMN/CLinkCtrl::GetItem", "AFXCMN/CLinkCtrl::GetItemID", "AFXCMN/CLinkCtrl::GetItemState", "AFXCMN/CLinkCtrl::GetItemUrl", "AFXCMN/CLinkCtrl::HitTest", "AFXCMN/CLinkCtrl::SetItem", "AFXCMN/CLinkCtrl::SetItemID", "AFXCMN/CLinkCtrl::SetItemState", "AFXCMN/CLinkCtrl::SetItemUrl"] helpviewer_keywords: ["CLinkCtrl [MFC], CLinkCtrl", "CLinkCtrl [MFC], Create", "CLinkCtrl [MFC], CreateEx", "CLinkCtrl [MFC], GetIdealHeight", "CLinkCtrl [MFC], GetIdealSize", "CLinkCtrl [MFC], GetItem", "CLinkCtrl [MFC], GetItemID", "CLinkCtrl [MFC], GetItemState", "CLinkCtrl [MFC], GetItemUrl", "CLinkCtrl [MFC], HitTest", "CLinkCtrl [MFC], SetItem", "CLinkCtrl [MFC], SetItemID", "CLinkCtrl [MFC], SetItemState", "CLinkCtrl [MFC], SetItemUrl"] -ms.assetid: d1cd876a-ecca-42db-8ac4-9cd327df0cd4 --- # CLinkCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common SysLink control. ## Syntax diff --git a/docs/mfc/reference/clist-class.md b/docs/mfc/reference/clist-class.md index 083376f4fcf..536e937582b 100644 --- a/docs/mfc/reference/clist-class.md +++ b/docs/mfc/reference/clist-class.md @@ -4,10 +4,12 @@ title: "CList Class" ms.date: "11/04/2016" f1_keywords: ["CList", "AFXTEMPL/CList", "AFXTEMPL/CList::CList", "AFXTEMPL/CList::AddHead", "AFXTEMPL/CList::AddTail", "AFXTEMPL/CList::Find", "AFXTEMPL/CList::FindIndex", "AFXTEMPL/CList::GetAt", "AFXTEMPL/CList::GetCount", "AFXTEMPL/CList::GetHead", "AFXTEMPL/CList::GetHeadPosition", "AFXTEMPL/CList::GetNext", "AFXTEMPL/CList::GetPrev", "AFXTEMPL/CList::GetSize", "AFXTEMPL/CList::GetTail", "AFXTEMPL/CList::GetTailPosition", "AFXTEMPL/CList::InsertAfter", "AFXTEMPL/CList::InsertBefore", "AFXTEMPL/CList::IsEmpty", "AFXTEMPL/CList::RemoveAll", "AFXTEMPL/CList::RemoveAt", "AFXTEMPL/CList::RemoveHead", "AFXTEMPL/CList::RemoveTail", "AFXTEMPL/CList::SetAt"] helpviewer_keywords: ["CList [MFC], CList", "CList [MFC], AddHead", "CList [MFC], AddTail", "CList [MFC], Find", "CList [MFC], FindIndex", "CList [MFC], GetAt", "CList [MFC], GetCount", "CList [MFC], GetHead", "CList [MFC], GetHeadPosition", "CList [MFC], GetNext", "CList [MFC], GetPrev", "CList [MFC], GetSize", "CList [MFC], GetTail", "CList [MFC], GetTailPosition", "CList [MFC], InsertAfter", "CList [MFC], InsertBefore", "CList [MFC], IsEmpty", "CList [MFC], RemoveAll", "CList [MFC], RemoveAt", "CList [MFC], RemoveHead", "CList [MFC], RemoveTail", "CList [MFC], SetAt"] -ms.assetid: 6f6273c3-c8f6-47f5-ac2a-0a950379ae5d --- # `CList` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports ordered lists of nonunique objects accessible sequentially or by value. ## Syntax diff --git a/docs/mfc/reference/clistbox-class.md b/docs/mfc/reference/clistbox-class.md index ffdca49e04e..2c82cd368f2 100644 --- a/docs/mfc/reference/clistbox-class.md +++ b/docs/mfc/reference/clistbox-class.md @@ -4,10 +4,12 @@ description: "A description of the MFC CListBox class and its member functions." ms.date: "01/22/2020" f1_keywords: ["CListBox", "AFXWIN/CListBox", "AFXWIN/CListBox::CListBox", "AFXWIN/CListBox::AddString", "AFXWIN/CListBox::CharToItem", "AFXWIN/CListBox::CompareItem", "AFXWIN/CListBox::Create", "AFXWIN/CListBox::DeleteItem", "AFXWIN/CListBox::DeleteString", "AFXWIN/CListBox::Dir", "AFXWIN/CListBox::DrawItem", "AFXWIN/CListBox::FindString", "AFXWIN/CListBox::FindStringExact", "AFXWIN/CListBox::GetAnchorIndex", "AFXWIN/CListBox::GetCaretIndex", "AFXWIN/CListBox::GetCount", "AFXWIN/CListBox::GetCurSel", "AFXWIN/CListBox::GetHorizontalExtent", "AFXWIN/CListBox::GetItemData", "AFXWIN/CListBox::GetItemDataPtr", "AFXWIN/CListBox::GetItemHeight", "AFXWIN/CListBox::GetItemRect", "AFXWIN/CListBox::GetListBoxInfo", "AFXWIN/CListBox::GetLocale", "AFXWIN/CListBox::GetSel", "AFXWIN/CListBox::GetSelCount", "AFXWIN/CListBox::GetSelItems", "AFXWIN/CListBox::GetText", "AFXWIN/CListBox::GetTextLen", "AFXWIN/CListBox::GetTopIndex", "AFXWIN/CListBox::InitStorage", "AFXWIN/CListBox::InsertString", "AFXWIN/CListBox::ItemFromPoint", "AFXWIN/CListBox::MeasureItem", "AFXWIN/CListBox::ResetContent", "AFXWIN/CListBox::SelectString", "AFXWIN/CListBox::SelItemRange", "AFXWIN/CListBox::SetAnchorIndex", "AFXWIN/CListBox::SetCaretIndex", "AFXWIN/CListBox::SetColumnWidth", "AFXWIN/CListBox::SetCurSel", "AFXWIN/CListBox::SetHorizontalExtent", "AFXWIN/CListBox::SetItemData", "AFXWIN/CListBox::SetItemDataPtr", "AFXWIN/CListBox::SetItemHeight", "AFXWIN/CListBox::SetLocale", "AFXWIN/CListBox::SetSel", "AFXWIN/CListBox::SetTabStops", "AFXWIN/CListBox::SetTopIndex", "AFXWIN/CListBox::VKeyToItem"] helpviewer_keywords: ["CListBox [MFC], CListBox", "CListBox [MFC], AddString", "CListBox [MFC], CharToItem", "CListBox [MFC], CompareItem", "CListBox [MFC], Create", "CListBox [MFC], DeleteItem", "CListBox [MFC], DeleteString", "CListBox [MFC], Dir", "CListBox [MFC], DrawItem", "CListBox [MFC], FindString", "CListBox [MFC], FindStringExact", "CListBox [MFC], GetAnchorIndex", "CListBox [MFC], GetCaretIndex", "CListBox [MFC], GetCount", "CListBox [MFC], GetCurSel", "CListBox [MFC], GetHorizontalExtent", "CListBox [MFC], GetItemData", "CListBox [MFC], GetItemDataPtr", "CListBox [MFC], GetItemHeight", "CListBox [MFC], GetItemRect", "CListBox [MFC], GetListBoxInfo", "CListBox [MFC], GetLocale", "CListBox [MFC], GetSel", "CListBox [MFC], GetSelCount", "CListBox [MFC], GetSelItems", "CListBox [MFC], GetText", "CListBox [MFC], GetTextLen", "CListBox [MFC], GetTopIndex", "CListBox [MFC], InitStorage", "CListBox [MFC], InsertString", "CListBox [MFC], ItemFromPoint", "CListBox [MFC], MeasureItem", "CListBox [MFC], ResetContent", "CListBox [MFC], SelectString", "CListBox [MFC], SelItemRange", "CListBox [MFC], SetAnchorIndex", "CListBox [MFC], SetCaretIndex", "CListBox [MFC], SetColumnWidth", "CListBox [MFC], SetCurSel", "CListBox [MFC], SetHorizontalExtent", "CListBox [MFC], SetItemData", "CListBox [MFC], SetItemDataPtr", "CListBox [MFC], SetItemHeight", "CListBox [MFC], SetLocale", "CListBox [MFC], SetSel", "CListBox [MFC], SetTabStops", "CListBox [MFC], SetTopIndex", "CListBox [MFC], VKeyToItem"] -ms.assetid: 7ba3c699-c286-4cd9-9066-532c41ec05d1 --- # `CListBox` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows list box. ## Syntax diff --git a/docs/mfc/reference/clistctrl-class.md b/docs/mfc/reference/clistctrl-class.md index a9e92a75d11..489c3ee07dc 100644 --- a/docs/mfc/reference/clistctrl-class.md +++ b/docs/mfc/reference/clistctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CListCtrl [MFC], CListCtrl", "CListCtrl [MFC], Approximat --- # `CListCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the functionality of a "list view control," which displays a collection of items each consisting of an icon (from an image list) and a label. ## Syntax diff --git a/docs/mfc/reference/clistview-class.md b/docs/mfc/reference/clistview-class.md index 111656d0800..5536fc76f68 100644 --- a/docs/mfc/reference/clistview-class.md +++ b/docs/mfc/reference/clistview-class.md @@ -4,10 +4,12 @@ title: "CListView Class" ms.date: "11/04/2016" f1_keywords: ["CListView", "AFXCVIEW/CListView", "AFXCVIEW/CListView::CListView", "AFXCVIEW/CListView::GetListCtrl", "AFXCVIEW/CListView::RemoveImageList"] helpviewer_keywords: ["CListView [MFC], CListView", "CListView [MFC], GetListCtrl", "CListView [MFC], RemoveImageList"] -ms.assetid: 7626bdb2-a1b8-4eab-b631-6743710a8432 --- # CListView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Simplifies use of the list control and of [CListCtrl](../../mfc/reference/clistctrl-class.md), the class that encapsulates list-control functionality, with MFC's document-view architecture. ## Syntax diff --git a/docs/mfc/reference/clongbinary-class.md b/docs/mfc/reference/clongbinary-class.md index 7ba265343e8..268db8c9c57 100644 --- a/docs/mfc/reference/clongbinary-class.md +++ b/docs/mfc/reference/clongbinary-class.md @@ -4,10 +4,12 @@ title: "CLongBinary Class" ms.date: "11/04/2016" f1_keywords: ["CLongBinary", "AFXDB_/CLongBinary", "AFXDB_/CLongBinary::CLongBinary", "AFXDB_/CLongBinary::m_dwDataLength", "AFXDB_/CLongBinary::m_hData"] helpviewer_keywords: ["CLongBinary class [MFC]"] -ms.assetid: f4320059-aeb4-4ee5-bc2b-25f19d898ef5 --- # CLongBinary Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Simplifies working with very large binary data objects (often called BLOBs, or "binary large objects") in a database. ## Syntax diff --git a/docs/mfc/reference/cmap-class.md b/docs/mfc/reference/cmap-class.md index d985acc0408..ab87ec202a2 100644 --- a/docs/mfc/reference/cmap-class.md +++ b/docs/mfc/reference/cmap-class.md @@ -4,10 +4,12 @@ title: "CMap Class" ms.date: "11/04/2016" f1_keywords: ["CMap", "AFXTEMPL/CMap", "AFXTEMPL/CMap::CPair", "AFXTEMPL/CMap::CMap", "AFXTEMPL/CMap::GetCount", "AFXTEMPL/CMap::GetHashTableSize", "AFXTEMPL/CMap::GetNextAssoc", "AFXTEMPL/CMap::GetSize", "AFXTEMPL/CMap::GetStartPosition", "AFXTEMPL/CMap::InitHashTable", "AFXTEMPL/CMap::IsEmpty", "AFXTEMPL/CMap::Lookup", "AFXTEMPL/CMap::PGetFirstAssoc", "AFXTEMPL/CMap::PGetNextAssoc", "AFXTEMPL/CMap::PLookup", "AFXTEMPL/CMap::RemoveAll", "AFXTEMPL/CMap::RemoveKey", "AFXTEMPL/CMap::SetAt"] helpviewer_keywords: ["CMap [MFC], CPair", "CMap [MFC], CMap", "CMap [MFC], GetCount", "CMap [MFC], GetHashTableSize", "CMap [MFC], GetNextAssoc", "CMap [MFC], GetSize", "CMap [MFC], GetStartPosition", "CMap [MFC], InitHashTable", "CMap [MFC], IsEmpty", "CMap [MFC], Lookup", "CMap [MFC], PGetFirstAssoc", "CMap [MFC], PGetNextAssoc", "CMap [MFC], PLookup", "CMap [MFC], RemoveAll", "CMap [MFC], RemoveKey", "CMap [MFC], SetAt"] -ms.assetid: 640a45ab-0993-4def-97ec-42cc78eb10b9 --- # `CMap` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A dictionary collection class that maps unique keys to values. ## Syntax diff --git a/docs/mfc/reference/cmapptrtoptr-class.md b/docs/mfc/reference/cmapptrtoptr-class.md index 10277c43259..e30a3b31515 100644 --- a/docs/mfc/reference/cmapptrtoptr-class.md +++ b/docs/mfc/reference/cmapptrtoptr-class.md @@ -4,10 +4,12 @@ title: "CMapPtrToPtr Class" ms.date: "11/04/2016" f1_keywords: ["CMapPtrToPtr", "AFXCOLL/CMapPtrToPtr", "AFXCOLL/CMapPtrToPtr::CMapPtrToPtr", "AFXCOLL/CMapPtrToPtr::GetCount", "AFXCOLL/CMapPtrToPtr::GetHashTableSize", "AFXCOLL/CMapPtrToPtr::GetNextAssoc", "AFXCOLL/CMapPtrToPtr::GetSize", "AFXCOLL/CMapPtrToPtr::GetStartPosition", "AFXCOLL/CMapPtrToPtr::HashKey", "AFXCOLL/CMapPtrToPtr::InitHashTable", "AFXCOLL/CMapPtrToPtr::IsEmpty", "AFXCOLL/CMapPtrToPtr::Lookup", "AFXCOLL/CMapPtrToPtr::LookupKey", "AFXCOLL/CMapPtrToPtr::RemoveAll", "AFXCOLL/CMapPtrToPtr::RemoveKey", "AFXCOLL/CMapPtrToPtr::SetAt"] helpviewer_keywords: ["CMapPtrToPtr [MFC], CMapPtrToPtr", "CMapPtrToPtr [MFC], GetCount", "CMapPtrToPtr [MFC], GetHashTableSize", "CMapPtrToPtr [MFC], GetNextAssoc", "CMapPtrToPtr [MFC], GetSize", "CMapPtrToPtr [MFC], GetStartPosition", "CMapPtrToPtr [MFC], HashKey", "CMapPtrToPtr [MFC], InitHashTable", "CMapPtrToPtr [MFC], IsEmpty", "CMapPtrToPtr [MFC], Lookup", "CMapPtrToPtr [MFC], LookupKey", "CMapPtrToPtr [MFC], RemoveAll", "CMapPtrToPtr [MFC], RemoveKey", "CMapPtrToPtr [MFC], SetAt"] -ms.assetid: 23cbbaec-9d64-48f2-92ae-5e24fa64b926 --- # CMapPtrToPtr Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports maps of void pointers keyed by void pointers. ## Syntax diff --git a/docs/mfc/reference/cmapptrtoword-class.md b/docs/mfc/reference/cmapptrtoword-class.md index 1810b0d5fd7..6793004b32b 100644 --- a/docs/mfc/reference/cmapptrtoword-class.md +++ b/docs/mfc/reference/cmapptrtoword-class.md @@ -4,10 +4,12 @@ title: "CMapPtrToWord Class" ms.date: "11/04/2016" f1_keywords: ["CMapPtrToWord", "AFXCOLL/CMapPtrToWord", "AFXCOLL/CMapPtrToWord::CMapPtrToWord", "AFXCOLL/CMapPtrToWord::GetCount", "AFXCOLL/CMapPtrToWord::GetHashTableSize", "AFXCOLL/CMapPtrToWord::GetNextAssoc", "AFXCOLL/CMapPtrToWord::GetSize", "AFXCOLL/CMapPtrToWord::GetStartPosition", "AFXCOLL/CMapPtrToWord::HashKey", "AFXCOLL/CMapPtrToWord::InitHashTable", "AFXCOLL/CMapPtrToWord::IsEmpty", "AFXCOLL/CMapPtrToWord::Lookup", "AFXCOLL/CMapPtrToWord::LookupKey", "AFXCOLL/CMapPtrToWord::RemoveAll", "AFXCOLL/CMapPtrToWord::RemoveKey", "AFXCOLL/CMapPtrToWord::SetAt"] helpviewer_keywords: ["CMapPtrToWord [MFC], CMapPtrToWord", "CMapPtrToWord [MFC], GetCount", "CMapPtrToWord [MFC], GetHashTableSize", "CMapPtrToWord [MFC], GetNextAssoc", "CMapPtrToWord [MFC], GetSize", "CMapPtrToWord [MFC], GetStartPosition", "CMapPtrToWord [MFC], HashKey", "CMapPtrToWord [MFC], InitHashTable", "CMapPtrToWord [MFC], IsEmpty", "CMapPtrToWord [MFC], Lookup", "CMapPtrToWord [MFC], LookupKey", "CMapPtrToWord [MFC], RemoveAll", "CMapPtrToWord [MFC], RemoveKey", "CMapPtrToWord [MFC], SetAt"] -ms.assetid: 4631c6b6-d49f-49d9-adc0-1e0491e32d7b --- # CMapPtrToWord Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports maps of 16-bit words keyed by void pointers. ## Syntax diff --git a/docs/mfc/reference/cmapstringtoob-class.md b/docs/mfc/reference/cmapstringtoob-class.md index 7d7404e9956..a5de929c1c7 100644 --- a/docs/mfc/reference/cmapstringtoob-class.md +++ b/docs/mfc/reference/cmapstringtoob-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMapStringToOb [MFC], CMapStringToOb", "CMapStringToOb [M --- # `CMapStringToOb` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A dictionary collection class that maps unique `CString` objects to `CObject` pointers. ## Syntax diff --git a/docs/mfc/reference/cmapstringtoptr-class.md b/docs/mfc/reference/cmapstringtoptr-class.md index 4a4ac641f44..a89fe7b5c4f 100644 --- a/docs/mfc/reference/cmapstringtoptr-class.md +++ b/docs/mfc/reference/cmapstringtoptr-class.md @@ -4,10 +4,12 @@ title: "CMapStringToPtr Class" ms.date: "11/04/2016" f1_keywords: ["CMapStringToPtr", "AFXCOLL/CMapStringToPtr", "AFXCOLL/CMapStringToPtr::CMapStringToPtr", "AFXCOLL/CMapStringToPtr::GetCount", "AFXCOLL/CMapStringToPtr::GetHashTableSize", "AFXCOLL/CMapStringToPtr::GetNextAssoc", "AFXCOLL/CMapStringToPtr::GetSize", "AFXCOLL/CMapStringToPtr::GetStartPosition", "AFXCOLL/CMapStringToPtr::HashKey", "AFXCOLL/CMapStringToPtr::InitHashTable", "AFXCOLL/CMapStringToPtr::IsEmpty", "AFXCOLL/CMapStringToPtr::Lookup", "AFXCOLL/CMapStringToPtr::LookupKey", "AFXCOLL/CMapStringToPtr::RemoveAll", "AFXCOLL/CMapStringToPtr::RemoveKey", "AFXCOLL/CMapStringToPtr::SetAt"] helpviewer_keywords: ["CMapStringToPtr [MFC], CMapStringToPtr", "CMapStringToPtr [MFC], GetCount", "CMapStringToPtr [MFC], GetHashTableSize", "CMapStringToPtr [MFC], GetNextAssoc", "CMapStringToPtr [MFC], GetSize", "CMapStringToPtr [MFC], GetStartPosition", "CMapStringToPtr [MFC], HashKey", "CMapStringToPtr [MFC], InitHashTable", "CMapStringToPtr [MFC], IsEmpty", "CMapStringToPtr [MFC], Lookup", "CMapStringToPtr [MFC], LookupKey", "CMapStringToPtr [MFC], RemoveAll", "CMapStringToPtr [MFC], RemoveKey", "CMapStringToPtr [MFC], SetAt"] -ms.assetid: 1ac11143-eb0a-4511-a662-2df0d1d9005b --- # CMapStringToPtr Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports maps of void pointers keyed by `CString` objects. ## Syntax diff --git a/docs/mfc/reference/cmapstringtostring-class.md b/docs/mfc/reference/cmapstringtostring-class.md index 1899172a7ed..a7f970445e6 100644 --- a/docs/mfc/reference/cmapstringtostring-class.md +++ b/docs/mfc/reference/cmapstringtostring-class.md @@ -4,10 +4,12 @@ title: "CMapStringToString Class" ms.date: "11/04/2016" f1_keywords: ["CMapStringToString", "AFXCOLL/CMapStringToString", "AFXCOLL/CMapStringToString::CPair", "AFXCOLL/CMapStringToString::CMapStringToString", "AFXCOLL/CMapStringToString::GetCount", "AFXCOLL/CMapStringToString::GetHashTableSize", "AFXCOLL/CMapStringToString::GetNextAssoc", "AFXCOLL/CMapStringToString::GetSize", "AFXCOLL/CMapStringToString::GetStartPosition", "AFXCOLL/CMapStringToString::HashKey", "AFXCOLL/CMapStringToString::InitHashTable", "AFXCOLL/CMapStringToString::IsEmpty", "AFXCOLL/CMapStringToString::Lookup", "AFXCOLL/CMapStringToString::LookupKey", "AFXCOLL/CMapStringToString::PGetFirstAssoc", "AFXCOLL/CMapStringToString::PGetNextAssoc", "AFXCOLL/CMapStringToString::PLookup", "AFXCOLL/CMapStringToString::RemoveAll", "AFXCOLL/CMapStringToString::RemoveKey", "AFXCOLL/CMapStringToString::SetAt"] helpviewer_keywords: ["CMapStringToString [MFC], CPair", "CMapStringToString [MFC], CMapStringToString", "CMapStringToString [MFC], GetCount", "CMapStringToString [MFC], GetHashTableSize", "CMapStringToString [MFC], GetNextAssoc", "CMapStringToString [MFC], GetSize", "CMapStringToString [MFC], GetStartPosition", "CMapStringToString [MFC], HashKey", "CMapStringToString [MFC], InitHashTable", "CMapStringToString [MFC], IsEmpty", "CMapStringToString [MFC], Lookup", "CMapStringToString [MFC], LookupKey", "CMapStringToString [MFC], PGetFirstAssoc", "CMapStringToString [MFC], PGetNextAssoc", "CMapStringToString [MFC], PLookup", "CMapStringToString [MFC], RemoveAll", "CMapStringToString [MFC], RemoveKey", "CMapStringToString [MFC], SetAt"] -ms.assetid: b45794c2-fe6b-4edb-a8ca-faa03b57b4a8 --- # CMapStringToString Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports maps of `CString` objects keyed by `CString` objects. ## Syntax diff --git a/docs/mfc/reference/cmapwordtoob-class.md b/docs/mfc/reference/cmapwordtoob-class.md index 395f405e314..8b3c3c428d7 100644 --- a/docs/mfc/reference/cmapwordtoob-class.md +++ b/docs/mfc/reference/cmapwordtoob-class.md @@ -4,10 +4,12 @@ title: "CMapWordToOb Class" ms.date: "11/04/2016" f1_keywords: ["CMapWordToOb", "AFXCOLL/CMapWordToOb", "AFXCOLL/CMapWordToOb::CMapWordToOb", "AFXCOLL/CMapWordToOb::GetCount", "AFXCOLL/CMapWordToOb::GetHashTableSize", "AFXCOLL/CMapWordToOb::GetNextAssoc", "AFXCOLL/CMapWordToOb::GetSize", "AFXCOLL/CMapWordToOb::GetStartPosition", "AFXCOLL/CMapWordToOb::HashKey", "AFXCOLL/CMapWordToOb::InitHashTable", "AFXCOLL/CMapWordToOb::IsEmpty", "AFXCOLL/CMapWordToOb::Lookup", "AFXCOLL/CMapWordToOb::LookupKey", "AFXCOLL/CMapWordToOb::RemoveAll", "AFXCOLL/CMapWordToOb::RemoveKey", "AFXCOLL/CMapWordToOb::SetAt"] helpviewer_keywords: ["CMapWordToOb [MFC], CMapWordToOb", "CMapWordToOb [MFC], GetCount", "CMapWordToOb [MFC], GetHashTableSize", "CMapWordToOb [MFC], GetNextAssoc", "CMapWordToOb [MFC], GetSize", "CMapWordToOb [MFC], GetStartPosition", "CMapWordToOb [MFC], HashKey", "CMapWordToOb [MFC], InitHashTable", "CMapWordToOb [MFC], IsEmpty", "CMapWordToOb [MFC], Lookup", "CMapWordToOb [MFC], LookupKey", "CMapWordToOb [MFC], RemoveAll", "CMapWordToOb [MFC], RemoveKey", "CMapWordToOb [MFC], SetAt"] -ms.assetid: 9c9bcd76-456f-4cf9-b03c-dd28b49d5e4f --- # CMapWordToOb Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports maps of `CObject` pointers keyed by 16-bit words. ## Syntax diff --git a/docs/mfc/reference/cmapwordtoptr-class.md b/docs/mfc/reference/cmapwordtoptr-class.md index 474a9292c20..90d850b0f18 100644 --- a/docs/mfc/reference/cmapwordtoptr-class.md +++ b/docs/mfc/reference/cmapwordtoptr-class.md @@ -4,10 +4,12 @@ title: "CMapWordToPtr Class" ms.date: "11/04/2016" f1_keywords: ["CMapWordToPtr", "AFXCOLL/CMapWordToPtr", "AFXCOLL/CMapWordToPtr::CMapWordToPtr", "AFXCOLL/CMapWordToPtr::GetCount", "AFXCOLL/CMapWordToPtr::GetHashTableSize", "AFXCOLL/CMapWordToPtr::GetNextAssoc", "AFXCOLL/CMapWordToPtr::GetSize", "AFXCOLL/CMapWordToPtr::GetStartPosition", "AFXCOLL/CMapWordToPtr::HashKey", "AFXCOLL/CMapWordToPtr::InitHashTable", "AFXCOLL/CMapWordToPtr::IsEmpty", "AFXCOLL/CMapWordToPtr::Lookup", "AFXCOLL/CMapWordToPtr::LookupKey", "AFXCOLL/CMapWordToPtr::RemoveAll", "AFXCOLL/CMapWordToPtr::RemoveKey", "AFXCOLL/CMapWordToPtr::SetAt"] helpviewer_keywords: ["CMapWordToPtr [MFC], CMapWordToPtr", "CMapWordToPtr [MFC], GetCount", "CMapWordToPtr [MFC], GetHashTableSize", "CMapWordToPtr [MFC], GetNextAssoc", "CMapWordToPtr [MFC], GetSize", "CMapWordToPtr [MFC], GetStartPosition", "CMapWordToPtr [MFC], HashKey", "CMapWordToPtr [MFC], InitHashTable", "CMapWordToPtr [MFC], IsEmpty", "CMapWordToPtr [MFC], Lookup", "CMapWordToPtr [MFC], LookupKey", "CMapWordToPtr [MFC], RemoveAll", "CMapWordToPtr [MFC], RemoveKey", "CMapWordToPtr [MFC], SetAt"] -ms.assetid: b204d87f-6427-43e1-93e3-a4b1bb41099f --- # CMapWordToPtr Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports maps of void pointers keyed by 16-bit words. ## Syntax diff --git a/docs/mfc/reference/cmdichildwnd-class.md b/docs/mfc/reference/cmdichildwnd-class.md index a199284190a..acace68a0f5 100644 --- a/docs/mfc/reference/cmdichildwnd-class.md +++ b/docs/mfc/reference/cmdichildwnd-class.md @@ -4,10 +4,12 @@ title: "CMDIChildWnd Class" ms.date: "11/04/2016" f1_keywords: ["CMDIChildWnd", "AFXWIN/CMDIChildWnd", "AFXWIN/CMDIChildWnd::CMDIChildWnd", "AFXWIN/CMDIChildWnd::Create", "AFXWIN/CMDIChildWnd::GetMDIFrame", "AFXWIN/CMDIChildWnd::MDIActivate", "AFXWIN/CMDIChildWnd::MDIDestroy", "AFXWIN/CMDIChildWnd::MDIMaximize", "AFXWIN/CMDIChildWnd::MDIRestore", "AFXWIN/CMDIChildWnd::SetHandles"] helpviewer_keywords: ["CMDIChildWnd [MFC], CMDIChildWnd", "CMDIChildWnd [MFC], Create", "CMDIChildWnd [MFC], GetMDIFrame", "CMDIChildWnd [MFC], MDIActivate", "CMDIChildWnd [MFC], MDIDestroy", "CMDIChildWnd [MFC], MDIMaximize", "CMDIChildWnd [MFC], MDIRestore", "CMDIChildWnd [MFC], SetHandles"] -ms.assetid: 6d07f5d4-9a3e-4723-9fa5-e65bb669fdd5 --- # CMDIChildWnd Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows multiple document interface (MDI) child window, along with members for managing the window. ## Syntax diff --git a/docs/mfc/reference/cmdichildwndex-class.md b/docs/mfc/reference/cmdichildwndex-class.md index b1f2e320dd5..a689a0849b7 100644 --- a/docs/mfc/reference/cmdichildwndex-class.md +++ b/docs/mfc/reference/cmdichildwndex-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMDIChildWndEx [MFC], ActivateTopLevelFrame", "CMDIChildW --- # CMDIChildWndEx Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMDIChildWndEx` class provides the functionality of a Windows multiple document interface (MDI) child window. It extends the functionality of [CMDIChildWnd Class](../../mfc/reference/cmdichildwnd-class.md). The framework requires this class when an MDI application uses certain MFC classes. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmdiframewnd-class.md b/docs/mfc/reference/cmdiframewnd-class.md index 8e5dc3025ae..f757ad62da0 100644 --- a/docs/mfc/reference/cmdiframewnd-class.md +++ b/docs/mfc/reference/cmdiframewnd-class.md @@ -4,10 +4,12 @@ title: "CMDIFrameWnd Class" ms.date: "11/04/2016" f1_keywords: ["CMDIFrameWnd", "AFXWIN/CMDIFrameWnd", "AFXWIN/CMDIFrameWnd::CMDIFrameWnd", "AFXWIN/CMDIFrameWnd::CreateClient", "AFXWIN/CMDIFrameWnd::CreateNewChild", "AFXWIN/CMDIFrameWnd::GetWindowMenuPopup", "AFXWIN/CMDIFrameWnd::MDIActivate", "AFXWIN/CMDIFrameWnd::MDICascade", "AFXWIN/CMDIFrameWnd::MDIGetActive", "AFXWIN/CMDIFrameWnd::MDIIconArrange", "AFXWIN/CMDIFrameWnd::MDIMaximize", "AFXWIN/CMDIFrameWnd::MDINext", "AFXWIN/CMDIFrameWnd::MDIPrev", "AFXWIN/CMDIFrameWnd::MDIRestore", "AFXWIN/CMDIFrameWnd::MDISetMenu", "AFXWIN/CMDIFrameWnd::MDITile"] helpviewer_keywords: ["CMDIFrameWnd [MFC], CMDIFrameWnd", "CMDIFrameWnd [MFC], CreateClient", "CMDIFrameWnd [MFC], CreateNewChild", "CMDIFrameWnd [MFC], GetWindowMenuPopup", "CMDIFrameWnd [MFC], MDIActivate", "CMDIFrameWnd [MFC], MDICascade", "CMDIFrameWnd [MFC], MDIGetActive", "CMDIFrameWnd [MFC], MDIIconArrange", "CMDIFrameWnd [MFC], MDIMaximize", "CMDIFrameWnd [MFC], MDINext", "CMDIFrameWnd [MFC], MDIPrev", "CMDIFrameWnd [MFC], MDIRestore", "CMDIFrameWnd [MFC], MDISetMenu", "CMDIFrameWnd [MFC], MDITile"] -ms.assetid: fa8736e6-511b-4c51-8b4d-eba78378aeb9 --- # CMDIFrameWnd Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows multiple document interface (MDI) frame window, along with members for managing the window. ## Syntax diff --git a/docs/mfc/reference/cmdiframewndex-class.md b/docs/mfc/reference/cmdiframewndex-class.md index 4cebc0fd4de..47ee4e152ce 100644 --- a/docs/mfc/reference/cmdiframewndex-class.md +++ b/docs/mfc/reference/cmdiframewndex-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMDIFrameWndEx [MFC], ActiveItemRecalcLayout", "CMDIFrame --- # `CMDIFrameWndEx` class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Extends the functionality of [`CMDIFrameWnd`](../../mfc/reference/cframewnd-class.md), a Windows Multiple Document Interface (MDI) frame window. ## Syntax diff --git a/docs/mfc/reference/cmditabinfo-class.md b/docs/mfc/reference/cmditabinfo-class.md index f2c9ffc9a02..d2ef90ec29b 100644 --- a/docs/mfc/reference/cmditabinfo-class.md +++ b/docs/mfc/reference/cmditabinfo-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMDITabInfo [MFC], Serialize", "CMDITabInfo [MFC], m_bAut --- # CMDITabInfo Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMDITabInfo` class is used to pass parameters to [CMDIFrameWndEx::EnableMDITabbedGroups](../../mfc/reference/cmdiframewndex-class.md#enablemditabbedgroups) method. Set members of this class to control the behavior of MDI tabbed groups. ## Syntax diff --git a/docs/mfc/reference/cmemfile-class.md b/docs/mfc/reference/cmemfile-class.md index d6b8ff19954..4fdaeeddc42 100644 --- a/docs/mfc/reference/cmemfile-class.md +++ b/docs/mfc/reference/cmemfile-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMemFile [MFC], CMemFile", "CMemFile [MFC], Attach", "CMe --- # CMemFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [CFile](../../mfc/reference/cfile-class.md)-derived class that supports memory files. ## Syntax diff --git a/docs/mfc/reference/cmemoryexception-class.md b/docs/mfc/reference/cmemoryexception-class.md index d7afee5e522..42c37ca9bcc 100644 --- a/docs/mfc/reference/cmemoryexception-class.md +++ b/docs/mfc/reference/cmemoryexception-class.md @@ -4,10 +4,12 @@ title: "CMemoryException Class" ms.date: "11/04/2016" f1_keywords: ["CMemoryException", "AFX/CMemoryException", "AFX/CMemoryException::CMemoryException"] helpviewer_keywords: ["CMemoryException [MFC], CMemoryException"] -ms.assetid: 9af0ed57-d12a-45ca-82b5-c910a60f7edf --- # CMemoryException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an out-of-memory exception condition. ## Syntax diff --git a/docs/mfc/reference/cmemorystate-structure.md b/docs/mfc/reference/cmemorystate-structure.md index a81816fc534..9f6a7f3f41f 100644 --- a/docs/mfc/reference/cmemorystate-structure.md +++ b/docs/mfc/reference/cmemorystate-structure.md @@ -4,10 +4,12 @@ title: "CMemoryState Structure" ms.date: "11/04/2016" f1_keywords: ["CMemoryState"] helpviewer_keywords: ["CMemoryState structure [MFC]", "memory leaks [MFC], detecting", "detecting memory leaks [MFC]"] -ms.assetid: 229d9de7-a6f3-4cc6-805b-5a9d9b1bfe1d --- # CMemoryState Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides a convenient way to detect memory leaks in your program. ## Syntax diff --git a/docs/mfc/reference/cmenu-class.md b/docs/mfc/reference/cmenu-class.md index 70d8e40d751..7cf5c9589a0 100644 --- a/docs/mfc/reference/cmenu-class.md +++ b/docs/mfc/reference/cmenu-class.md @@ -4,10 +4,12 @@ title: "CMenu Class" ms.date: "11/04/2016" f1_keywords: ["CMenu", "AFXWIN/CMenu", "AFXWIN/CMenu::CMenu", "AFXWIN/CMenu::AppendMenu", "AFXWIN/CMenu::Attach", "AFXWIN/CMenu::CheckMenuItem", "AFXWIN/CMenu::CheckMenuRadioItem", "AFXWIN/CMenu::CreateMenu", "AFXWIN/CMenu::CreatePopupMenu", "AFXWIN/CMenu::DeleteMenu", "AFXWIN/CMenu::DeleteTempMap", "AFXWIN/CMenu::DestroyMenu", "AFXWIN/CMenu::Detach", "AFXWIN/CMenu::DrawItem", "AFXWIN/CMenu::EnableMenuItem", "AFXWIN/CMenu::FromHandle", "AFXWIN/CMenu::GetDefaultItem", "AFXWIN/CMenu::GetMenuContextHelpId", "AFXWIN/CMenu::GetMenuInfo", "AFXWIN/CMenu::GetMenuItemCount", "AFXWIN/CMenu::GetMenuItemID", "AFXWIN/CMenu::GetMenuItemInfo", "AFXWIN/CMenu::GetMenuState", "AFXWIN/CMenu::GetMenuString", "AFXWIN/CMenu::GetSafeHmenu", "AFXWIN/CMenu::GetSubMenu", "AFXWIN/CMenu::InsertMenu", "AFXWIN/CMenu::InsertMenuItem", "AFXWIN/CMenu::LoadMenu", "AFXWIN/CMenu::LoadMenuIndirect", "AFXWIN/CMenu::MeasureItem", "AFXWIN/CMenu::ModifyMenu", "AFXWIN/CMenu::RemoveMenu", "AFXWIN/CMenu::SetDefaultItem", "AFXWIN/CMenu::SetMenuContextHelpId", "AFXWIN/CMenu::SetMenuInfo", "AFXWIN/CMenu::SetMenuItemBitmaps", "AFXWIN/CMenu::SetMenuItemInfo", "AFXWIN/CMenu::TrackPopupMenu", "AFXWIN/CMenu::TrackPopupMenuEx", "AFXWIN/CMenu::m_hMenu"] helpviewer_keywords: ["CMenu [MFC], CMenu", "CMenu [MFC], AppendMenu", "CMenu [MFC], Attach", "CMenu [MFC], CheckMenuItem", "CMenu [MFC], CheckMenuRadioItem", "CMenu [MFC], CreateMenu", "CMenu [MFC], CreatePopupMenu", "CMenu [MFC], DeleteMenu", "CMenu [MFC], DeleteTempMap", "CMenu [MFC], DestroyMenu", "CMenu [MFC], Detach", "CMenu [MFC], DrawItem", "CMenu [MFC], EnableMenuItem", "CMenu [MFC], FromHandle", "CMenu [MFC], GetDefaultItem", "CMenu [MFC], GetMenuContextHelpId", "CMenu [MFC], GetMenuInfo", "CMenu [MFC], GetMenuItemCount", "CMenu [MFC], GetMenuItemID", "CMenu [MFC], GetMenuItemInfo", "CMenu [MFC], GetMenuState", "CMenu [MFC], GetMenuString", "CMenu [MFC], GetSafeHmenu", "CMenu [MFC], GetSubMenu", "CMenu [MFC], InsertMenu", "CMenu [MFC], InsertMenuItem", "CMenu [MFC], LoadMenu", "CMenu [MFC], LoadMenuIndirect", "CMenu [MFC], MeasureItem", "CMenu [MFC], ModifyMenu", "CMenu [MFC], RemoveMenu", "CMenu [MFC], SetDefaultItem", "CMenu [MFC], SetMenuContextHelpId", "CMenu [MFC], SetMenuInfo", "CMenu [MFC], SetMenuItemBitmaps", "CMenu [MFC], SetMenuItemInfo", "CMenu [MFC], TrackPopupMenu", "CMenu [MFC], TrackPopupMenuEx", "CMenu [MFC], m_hMenu"] -ms.assetid: 40cacfdc-d45c-4ec7-bf28-991c72812499 --- # `CMenu` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An encapsulation of the Windows `HMENU`. ## Syntax diff --git a/docs/mfc/reference/cmenutearoffmanager-class.md b/docs/mfc/reference/cmenutearoffmanager-class.md index 3aeb8d41a0b..d4fea412a20 100644 --- a/docs/mfc/reference/cmenutearoffmanager-class.md +++ b/docs/mfc/reference/cmenutearoffmanager-class.md @@ -4,10 +4,12 @@ title: "CMenuTearOffManager Class" ms.date: "10/18/2018" f1_keywords: ["CMenuTearOffManager", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager::CMenuTearOffManager", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager::Build", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager::GetRegPath", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager::Initialize", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager::IsDynamicID", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager::Parse", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager::Reset", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager::SetInUse", "AFXMENUTEAROFFMANAGER/CMenuTearOffManager::SetupTearOffMenus"] helpviewer_keywords: ["CMenuTearOffManager [MFC], CMenuTearOffManager", "CMenuTearOffManager [MFC], Build", "CMenuTearOffManager [MFC], GetRegPath", "CMenuTearOffManager [MFC], Initialize", "CMenuTearOffManager [MFC], IsDynamicID", "CMenuTearOffManager [MFC], Parse", "CMenuTearOffManager [MFC], Reset", "CMenuTearOffManager [MFC], SetInUse", "CMenuTearOffManager [MFC], SetupTearOffMenus"] -ms.assetid: ab7ca272-ce42-4678-95f7-6ad75038f5a0 --- # CMenuTearOffManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages tear-off menus. A tear-off menu is a menu on the menu bar. The user can remove a tear-off menu from the menu bar, causing the tear-off menu to float. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmetafiledc-class.md b/docs/mfc/reference/cmetafiledc-class.md index 247113ce933..cbbca361521 100644 --- a/docs/mfc/reference/cmetafiledc-class.md +++ b/docs/mfc/reference/cmetafiledc-class.md @@ -4,10 +4,12 @@ title: "CMetaFileDC Class" ms.date: "11/04/2016" f1_keywords: ["CMetaFileDC", "AFXEXT/CMetaFileDC", "AFXEXT/CMetaFileDC::CMetaFileDC", "AFXEXT/CMetaFileDC::Close", "AFXEXT/CMetaFileDC::CloseEnhanced", "AFXEXT/CMetaFileDC::Create", "AFXEXT/CMetaFileDC::CreateEnhanced"] helpviewer_keywords: ["CMetaFileDC [MFC], CMetaFileDC", "CMetaFileDC [MFC], Close", "CMetaFileDC [MFC], CloseEnhanced", "CMetaFileDC [MFC], Create", "CMetaFileDC [MFC], CreateEnhanced"] -ms.assetid: ffce60fa-4181-4d46-9832-25e46fad4db4 --- # CMetaFileDC Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a Windows metafile, which contains a sequence of graphics device interface (GDI) commands that you can replay to create a desired image or text. ## Syntax diff --git a/docs/mfc/reference/cmfcacceleratorkey-class.md b/docs/mfc/reference/cmfcacceleratorkey-class.md index cea5e0154c5..ceef60ee03b 100644 --- a/docs/mfc/reference/cmfcacceleratorkey-class.md +++ b/docs/mfc/reference/cmfcacceleratorkey-class.md @@ -4,10 +4,12 @@ title: "CMFCAcceleratorKey Class" ms.date: "11/04/2016" f1_keywords: ["CMFCAcceleratorKey", "AFXACCELERATORKEY/CMFCAcceleratorKey", "AFXACCELERATORKEY/CMFCAcceleratorKey::CMFCAcceleratorKey", "AFXACCELERATORKEY/CMFCAcceleratorKey::Format", "AFXACCELERATORKEY/CMFCAcceleratorKey::SetAccelerator"] helpviewer_keywords: ["CMFCAcceleratorKey [MFC], CMFCAcceleratorKey", "CMFCAcceleratorKey [MFC], Format", "CMFCAcceleratorKey [MFC], SetAccelerator"] -ms.assetid: d140fbf7-23db-45ea-a63e-414a5ec7b3d5 --- # CMFCAcceleratorKey Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A helper class that implements virtual key mapping and formatting. ## Syntax diff --git a/docs/mfc/reference/cmfcacceleratorkeyassignctrl-class.md b/docs/mfc/reference/cmfcacceleratorkeyassignctrl-class.md index 24c02779510..dadb4244270 100644 --- a/docs/mfc/reference/cmfcacceleratorkeyassignctrl-class.md +++ b/docs/mfc/reference/cmfcacceleratorkeyassignctrl-class.md @@ -4,10 +4,12 @@ title: "CMFCAcceleratorKeyAssignCtrl Class" ms.date: "10/18/2018" f1_keywords: ["CMFCAcceleratorKeyAssignCtrl", "AFXACCELERATORKEYASSIGNCTRL/CMFCAcceleratorKeyAssignCtrl", "AFXACCELERATORKEYASSIGNCTRL/CMFCAcceleratorKeyAssignCtrl::CMFCAcceleratorKeyAssignCtrl", "AFXACCELERATORKEYASSIGNCTRL/CMFCAcceleratorKeyAssignCtrl::GetAccel", "AFXACCELERATORKEYASSIGNCTRL/CMFCAcceleratorKeyAssignCtrl::IsFocused", "AFXACCELERATORKEYASSIGNCTRL/CMFCAcceleratorKeyAssignCtrl::IsKeyDefined", "AFXACCELERATORKEYASSIGNCTRL/CMFCAcceleratorKeyAssignCtrl::PreTranslateMessage", "AFXACCELERATORKEYASSIGNCTRL/CMFCAcceleratorKeyAssignCtrl::ResetKey"] helpviewer_keywords: ["CMFCAcceleratorKeyAssignCtrl [MFC], CMFCAcceleratorKeyAssignCtrl", "CMFCAcceleratorKeyAssignCtrl [MFC], GetAccel", "CMFCAcceleratorKeyAssignCtrl [MFC], IsFocused", "CMFCAcceleratorKeyAssignCtrl [MFC], IsKeyDefined", "CMFCAcceleratorKeyAssignCtrl [MFC], PreTranslateMessage", "CMFCAcceleratorKeyAssignCtrl [MFC], ResetKey"] -ms.assetid: 89fb8e62-596e-4e71-8c9a-32740347aaab --- # CMFCAcceleratorKeyAssignCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCAcceleratorKeyAssignCtrl` class extends the [CEdit Class](../../mfc/reference/cedit-class.md) to support extra system buttons such as ALT, CONTROL, and SHIFT. ## Syntax diff --git a/docs/mfc/reference/cmfcautohidebar-class.md b/docs/mfc/reference/cmfcautohidebar-class.md index 120b1d8303a..20ad6d6369f 100644 --- a/docs/mfc/reference/cmfcautohidebar-class.md +++ b/docs/mfc/reference/cmfcautohidebar-class.md @@ -4,10 +4,12 @@ title: "CMFCAutoHideBar Class" ms.date: "10/18/2018" f1_keywords: ["CMFCAutoHideBar", "AFXAUTOHIDEBAR/CMFCAutoHideBar", "AFXAUTOHIDEBAR/CMFCAutoHideBar::CMFCAutoHideBar", "AFXAUTOHIDEBAR/CMFCAutoHideBar::AddAutoHideWindow", "AFXAUTOHIDEBAR/CMFCAutoHideBar::AllowShowOnPaneMenu", "AFXAUTOHIDEBAR/CMFCAutoHideBar::CalcFixedLayout", "AFXAUTOHIDEBAR/CMFCAutoHideBar::Create", "AFXAUTOHIDEBAR/CMFCAutoHideBar::GetFirstAHWindow", "AFXAUTOHIDEBAR/CMFCAutoHideBar::GetVisibleCount", "AFXAUTOHIDEBAR/CMFCAutoHideBar::OnShowControlBarMenu", "AFXAUTOHIDEBAR/CMFCAutoHideBar::RemoveAutoHideWindow", "AFXAUTOHIDEBAR/CMFCAutoHideBar::SetActiveInGroup", "AFXAUTOHIDEBAR/CMFCAutoHideBar::SetRecentVisibleState", "AFXAUTOHIDEBAR/CMFCAutoHideBar::ShowAutoHideWindow", "AFXAUTOHIDEBAR/CMFCAutoHideBar::StretchPane", "AFXAUTOHIDEBAR/CMFCAutoHideBar::UnSetAutoHideMode", "AFXAUTOHIDEBAR/CMFCAutoHideBar::UpdateVisibleState", "AFXAUTOHIDEBAR/CMFCAutoHideBar::m_nShowAHWndDelay"] helpviewer_keywords: ["CMFCAutoHideBar [MFC], CMFCAutoHideBar", "CMFCAutoHideBar [MFC], AddAutoHideWindow", "CMFCAutoHideBar [MFC], AllowShowOnPaneMenu", "CMFCAutoHideBar [MFC], CalcFixedLayout", "CMFCAutoHideBar [MFC], Create", "CMFCAutoHideBar [MFC], GetFirstAHWindow", "CMFCAutoHideBar [MFC], GetVisibleCount", "CMFCAutoHideBar [MFC], OnShowControlBarMenu", "CMFCAutoHideBar [MFC], RemoveAutoHideWindow", "CMFCAutoHideBar [MFC], SetActiveInGroup", "CMFCAutoHideBar [MFC], SetRecentVisibleState", "CMFCAutoHideBar [MFC], ShowAutoHideWindow", "CMFCAutoHideBar [MFC], StretchPane", "CMFCAutoHideBar [MFC], UnSetAutoHideMode", "CMFCAutoHideBar [MFC], UpdateVisibleState", "CMFCAutoHideBar [MFC], m_nShowAHWndDelay"] -ms.assetid: 54c8d84f-de64-4efd-8a47-3ea0ade40a70 --- # CMFCAutoHideBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCAutoHideBar` class is a special toolbar class that implements the auto-hide feature. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcautohidebutton-class.md b/docs/mfc/reference/cmfcautohidebutton-class.md index a1b6dfaa421..1b1561fd267 100644 --- a/docs/mfc/reference/cmfcautohidebutton-class.md +++ b/docs/mfc/reference/cmfcautohidebutton-class.md @@ -4,10 +4,12 @@ title: "CMFCAutoHideButton Class" ms.date: "10/18/2018" f1_keywords: ["CMFCAutoHideButton", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::BringToTop", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::Create", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::GetAlignment", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::GetAutoHideWindow", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::GetParentToolBar", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::GetRect", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::GetSize", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::GetTextSize", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::HighlightButton", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::IsActive", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::IsHighlighted", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::IsHorizontal", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::IsTop", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::IsVisible", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::Move", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::OnDraw", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::OnDrawBorder", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::OnFillBackground", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::ReplacePane", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::ShowAttachedWindow", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::ShowButton", "AFXAUTOHIDEBUTTON/CMFCAutoHideButton::UnSetAutoHideMode"] helpviewer_keywords: ["CMFCAutoHideButton [MFC], BringToTop", "CMFCAutoHideButton [MFC], Create", "CMFCAutoHideButton [MFC], GetAlignment", "CMFCAutoHideButton [MFC], GetAutoHideWindow", "CMFCAutoHideButton [MFC], GetParentToolBar", "CMFCAutoHideButton [MFC], GetRect", "CMFCAutoHideButton [MFC], GetSize", "CMFCAutoHideButton [MFC], GetTextSize", "CMFCAutoHideButton [MFC], HighlightButton", "CMFCAutoHideButton [MFC], IsActive", "CMFCAutoHideButton [MFC], IsHighlighted", "CMFCAutoHideButton [MFC], IsHorizontal", "CMFCAutoHideButton [MFC], IsTop", "CMFCAutoHideButton [MFC], IsVisible", "CMFCAutoHideButton [MFC], Move", "CMFCAutoHideButton [MFC], OnDraw", "CMFCAutoHideButton [MFC], OnDrawBorder", "CMFCAutoHideButton [MFC], OnFillBackground", "CMFCAutoHideButton [MFC], ReplacePane", "CMFCAutoHideButton [MFC], ShowAttachedWindow", "CMFCAutoHideButton [MFC], ShowButton", "CMFCAutoHideButton [MFC], UnSetAutoHideMode"] -ms.assetid: c80e6b8b-25ca-4d12-9d27-457731028ab0 --- # CMFCAutoHideButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A button that displays or hides a [CDockablePane Class](../../mfc/reference/cdockablepane-class.md) that is configured to hide. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcbasetabctrl-class.md b/docs/mfc/reference/cmfcbasetabctrl-class.md index d34822e52a4..519bcbeb027 100644 --- a/docs/mfc/reference/cmfcbasetabctrl-class.md +++ b/docs/mfc/reference/cmfcbasetabctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCBaseTabCtrl [MFC], AddIcon", "CMFCBaseTabCtrl [MFC], --- # CMFCBaseTabCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the base functionality for tabbed windows. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcbasetoolbar-class.md b/docs/mfc/reference/cmfcbasetoolbar-class.md index 39389c20bd7..d9a2eb12cae 100644 --- a/docs/mfc/reference/cmfcbasetoolbar-class.md +++ b/docs/mfc/reference/cmfcbasetoolbar-class.md @@ -4,10 +4,12 @@ title: "CMFCBaseToolBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCBaseToolBar", "AFXBASETOOLBAR/CMFCBaseToolBar", "AFXBASETOOLBAR/CMFCBaseToolBar::GetDockingMode", "AFXBASETOOLBAR/CMFCBaseToolBar::GetMinSize", "AFXBASETOOLBAR/CMFCBaseToolBar::OnAfterChangeParent"] helpviewer_keywords: ["CMFCBaseToolBar [MFC], GetDockingMode", "CMFCBaseToolBar [MFC], GetMinSize", "CMFCBaseToolBar [MFC], OnAfterChangeParent"] -ms.assetid: 5d79206d-55e4-46f8-b1b8-042e34d7f9da --- # CMFCBaseToolBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Base class for toolbars. ## Syntax diff --git a/docs/mfc/reference/cmfcbasevisualmanager-class.md b/docs/mfc/reference/cmfcbasevisualmanager-class.md index c6e2eacfb4a..e092d50743a 100644 --- a/docs/mfc/reference/cmfcbasevisualmanager-class.md +++ b/docs/mfc/reference/cmfcbasevisualmanager-class.md @@ -4,10 +4,12 @@ title: "CMFCBaseVisualManager Class" ms.date: "11/04/2016" f1_keywords: ["CMFCBaseVisualManager", "AFXVISUALMANAGER/CMFCBaseVisualManager", "AFXVISUALMANAGER/CMFCBaseVisualManager::CMFCBaseVisualManager", "AFXVISUALMANAGER/CMFCBaseVisualManager::DrawCheckBox", "AFXVISUALMANAGER/CMFCBaseVisualManager::DrawComboBorder", "AFXVISUALMANAGER/CMFCBaseVisualManager::DrawComboDropButton", "AFXVISUALMANAGER/CMFCBaseVisualManager::DrawPushButton", "AFXVISUALMANAGER/CMFCBaseVisualManager::DrawRadioButton", "AFXVISUALMANAGER/CMFCBaseVisualManager::DrawStatusBarProgress", "AFXVISUALMANAGER/CMFCBaseVisualManager::FillReBarPane", "AFXVISUALMANAGER/CMFCBaseVisualManager::GetStandardWindowsTheme", "AFXVISUALMANAGER/CMFCBaseVisualManager::CleanUpThemes", "AFXVISUALMANAGER/CMFCBaseVisualManager::UpdateSystemColors"] helpviewer_keywords: ["CMFCBaseVisualManager [MFC], CMFCBaseVisualManager", "CMFCBaseVisualManager [MFC], DrawCheckBox", "CMFCBaseVisualManager [MFC], DrawComboBorder", "CMFCBaseVisualManager [MFC], DrawComboDropButton", "CMFCBaseVisualManager [MFC], DrawPushButton", "CMFCBaseVisualManager [MFC], DrawRadioButton", "CMFCBaseVisualManager [MFC], DrawStatusBarProgress", "CMFCBaseVisualManager [MFC], FillReBarPane", "CMFCBaseVisualManager [MFC], GetStandardWindowsTheme", "CMFCBaseVisualManager [MFC], CleanUpThemes", "CMFCBaseVisualManager [MFC], UpdateSystemColors"] -ms.assetid: d56f3afc-cdea-4de1-825a-a08999c571e0 --- # CMFCBaseVisualManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A layer between derived visual managers and the Windows Theme API. `CMFCBaseVisualManager` loads UxTheme.dll, if available, and manages access to Windows Theme API methods. diff --git a/docs/mfc/reference/cmfcbutton-class.md b/docs/mfc/reference/cmfcbutton-class.md index a244e55d07e..def437d5ce1 100644 --- a/docs/mfc/reference/cmfcbutton-class.md +++ b/docs/mfc/reference/cmfcbutton-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCButton [MFC], CleanUp", "CMFCButton [MFC], EnableFull --- # `CMFCButton` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCButton` class adds functionality to the [`CButton`](../../mfc/reference/cbutton-class.md) class such as aligning button text, combining button text and an image, selecting a cursor, and specifying a tool tip. ## Syntax diff --git a/docs/mfc/reference/cmfccaptionbar-class.md b/docs/mfc/reference/cmfccaptionbar-class.md index b6faf964bb5..c42a67c0d28 100644 --- a/docs/mfc/reference/cmfccaptionbar-class.md +++ b/docs/mfc/reference/cmfccaptionbar-class.md @@ -4,10 +4,12 @@ title: "CMFCCaptionBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCCaptionBar", "AFXCAPTIONBAR/CMFCCaptionBar", "AFXCAPTIONBAR/CMFCCaptionBar::Create", "AFXCAPTIONBAR/CMFCCaptionBar::DoesAllowDynInsertBefore", "AFXCAPTIONBAR/CMFCCaptionBar::EnableButton", "AFXCAPTIONBAR/CMFCCaptionBar::GetAlignment", "AFXCAPTIONBAR/CMFCCaptionBar::GetBorderSize", "AFXCAPTIONBAR/CMFCCaptionBar::GetButtonRect", "AFXCAPTIONBAR/CMFCCaptionBar::GetMargin", "AFXCAPTIONBAR/CMFCCaptionBar::IsMessageBarMode", "AFXCAPTIONBAR/CMFCCaptionBar::RemoveBitmap", "AFXCAPTIONBAR/CMFCCaptionBar::RemoveButton", "AFXCAPTIONBAR/CMFCCaptionBar::RemoveIcon", "AFXCAPTIONBAR/CMFCCaptionBar::RemoveText", "AFXCAPTIONBAR/CMFCCaptionBar::SetBitmap", "AFXCAPTIONBAR/CMFCCaptionBar::SetBorderSize", "AFXCAPTIONBAR/CMFCCaptionBar::SetButton", "AFXCAPTIONBAR/CMFCCaptionBar::SetButtonPressed", "AFXCAPTIONBAR/CMFCCaptionBar::SetButtonToolTip", "AFXCAPTIONBAR/CMFCCaptionBar::SetFlatBorder", "AFXCAPTIONBAR/CMFCCaptionBar::SetIcon", "AFXCAPTIONBAR/CMFCCaptionBar::SetImageToolTip", "AFXCAPTIONBAR/CMFCCaptionBar::SetMargin", "AFXCAPTIONBAR/CMFCCaptionBar::SetText", "AFXCAPTIONBAR/CMFCCaptionBar::OnDrawBackground", "AFXCAPTIONBAR/CMFCCaptionBar::OnDrawBorder", "AFXCAPTIONBAR/CMFCCaptionBar::OnDrawButton", "AFXCAPTIONBAR/CMFCCaptionBar::OnDrawImage", "AFXCAPTIONBAR/CMFCCaptionBar::OnDrawText", "AFXCAPTIONBAR/CMFCCaptionBar::m_clrBarBackground", "AFXCAPTIONBAR/CMFCCaptionBar::m_clrBarBorder", "AFXCAPTIONBAR/CMFCCaptionBar::m_clrBarText"] helpviewer_keywords: ["CMFCCaptionBar [MFC], Create", "CMFCCaptionBar [MFC], DoesAllowDynInsertBefore", "CMFCCaptionBar [MFC], EnableButton", "CMFCCaptionBar [MFC], GetAlignment", "CMFCCaptionBar [MFC], GetBorderSize", "CMFCCaptionBar [MFC], GetButtonRect", "CMFCCaptionBar [MFC], GetMargin", "CMFCCaptionBar [MFC], IsMessageBarMode", "CMFCCaptionBar [MFC], RemoveBitmap", "CMFCCaptionBar [MFC], RemoveButton", "CMFCCaptionBar [MFC], RemoveIcon", "CMFCCaptionBar [MFC], RemoveText", "CMFCCaptionBar [MFC], SetBitmap", "CMFCCaptionBar [MFC], SetBorderSize", "CMFCCaptionBar [MFC], SetButton", "CMFCCaptionBar [MFC], SetButtonPressed", "CMFCCaptionBar [MFC], SetButtonToolTip", "CMFCCaptionBar [MFC], SetFlatBorder", "CMFCCaptionBar [MFC], SetIcon", "CMFCCaptionBar [MFC], SetImageToolTip", "CMFCCaptionBar [MFC], SetMargin", "CMFCCaptionBar [MFC], SetText", "CMFCCaptionBar [MFC], OnDrawBackground", "CMFCCaptionBar [MFC], OnDrawBorder", "CMFCCaptionBar [MFC], OnDrawButton", "CMFCCaptionBar [MFC], OnDrawImage", "CMFCCaptionBar [MFC], OnDrawText", "CMFCCaptionBar [MFC], m_clrBarBackground", "CMFCCaptionBar [MFC], m_clrBarBorder", "CMFCCaptionBar [MFC], m_clrBarText"] -ms.assetid: acb54d5f-14ff-4c96-aeb3-7717cf566d9a --- # CMFCCaptionBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A `CMFCCaptionBar` object is a control bar that can display three elements: a button, a text label, and a bitmap. It can only display one element of each type at a time. You can align each element to the left or right edges of the control or to the center. You can also apply a flat or 3D style to the top and bottom borders of the caption bar. ## Syntax diff --git a/docs/mfc/reference/cmfccaptionbutton-class.md b/docs/mfc/reference/cmfccaptionbutton-class.md index 645ae95d272..3c1b580936c 100644 --- a/docs/mfc/reference/cmfccaptionbutton-class.md +++ b/docs/mfc/reference/cmfccaptionbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCCaptionButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCCaptionButton", "AFXCAPTIONBUTTON/CMFCCaptionButton", "AFXCAPTIONBUTTON/CMFCCaptionButton::CMFCCaptionButton", "AFXCAPTIONBUTTON/CMFCCaptionButton::GetHit", "AFXCAPTIONBUTTON/CMFCCaptionButton::GetIconID", "AFXCAPTIONBUTTON/CMFCCaptionButton::GetRect", "AFXCAPTIONBUTTON/CMFCCaptionButton::GetSize", "AFXCAPTIONBUTTON/CMFCCaptionButton::IsMiniFrameButton", "AFXCAPTIONBUTTON/CMFCCaptionButton::Move", "AFXCAPTIONBUTTON/CMFCCaptionButton::OnDraw", "AFXCAPTIONBUTTON/CMFCCaptionButton::SetMiniFrameButton"] helpviewer_keywords: ["CMFCCaptionButton [MFC], CMFCCaptionButton", "CMFCCaptionButton [MFC], GetHit", "CMFCCaptionButton [MFC], GetIconID", "CMFCCaptionButton [MFC], GetRect", "CMFCCaptionButton [MFC], GetSize", "CMFCCaptionButton [MFC], IsMiniFrameButton", "CMFCCaptionButton [MFC], Move", "CMFCCaptionButton [MFC], OnDraw", "CMFCCaptionButton [MFC], SetMiniFrameButton"] -ms.assetid: c5774b38-c0dd-414a-9ede-3b2f78f233ec --- # CMFCCaptionButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCCaptionButton` class implements a button that is displayed on the caption bar for a docking pane or a mini-frame window. Typically, the framework creates caption buttons automatically. ## Syntax diff --git a/docs/mfc/reference/cmfccmdusagecount-class.md b/docs/mfc/reference/cmfccmdusagecount-class.md index 72347cb1a62..db6d04fbc03 100644 --- a/docs/mfc/reference/cmfccmdusagecount-class.md +++ b/docs/mfc/reference/cmfccmdusagecount-class.md @@ -4,10 +4,12 @@ title: "CMFCCmdUsageCount Class" ms.date: "11/04/2016" f1_keywords: ["CMFCCmdUsageCount", "AFXCMDUSAGECOUNT/CMFCCmdUsageCount", "AFXCMDUSAGECOUNT/CMFCCmdUsageCount::AddCmd", "AFXCMDUSAGECOUNT/CMFCCmdUsageCount::GetCount", "AFXCMDUSAGECOUNT/CMFCCmdUsageCount::HasEnoughInformation", "AFXCMDUSAGECOUNT/CMFCCmdUsageCount::IsFreqeuntlyUsedCmd", "AFXCMDUSAGECOUNT/CMFCCmdUsageCount::Reset", "AFXCMDUSAGECOUNT/CMFCCmdUsageCount::Serialize", "AFXCMDUSAGECOUNT/CMFCCmdUsageCount::SetOptions"] helpviewer_keywords: ["CMFCCmdUsageCount [MFC], AddCmd", "CMFCCmdUsageCount [MFC], GetCount", "CMFCCmdUsageCount [MFC], HasEnoughInformation", "CMFCCmdUsageCount [MFC], IsFreqeuntlyUsedCmd", "CMFCCmdUsageCount [MFC], Reset", "CMFCCmdUsageCount [MFC], Serialize", "CMFCCmdUsageCount [MFC], SetOptions"] -ms.assetid: 9c33b783-37c0-43ea-9f31-3c75e246c841 --- # CMFCCmdUsageCount Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Tracks the usage count of Windows messages, such as when the user selects an item from a menu. ## Syntax diff --git a/docs/mfc/reference/cmfccolorbar-class.md b/docs/mfc/reference/cmfccolorbar-class.md index d24989d33b9..d423c2cacf5 100644 --- a/docs/mfc/reference/cmfccolorbar-class.md +++ b/docs/mfc/reference/cmfccolorbar-class.md @@ -4,10 +4,12 @@ title: "CMFCColorBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCColorBar", "AFXCOLORBAR/CMFCColorBar", "AFXCOLORBAR/CMFCColorBar::CMFCColorBar", "AFXCOLORBAR/CMFCColorBar::ContextToSize", "AFXCOLORBAR/CMFCColorBar::CreateControl", "AFXCOLORBAR/CMFCColorBar::Create", "AFXCOLORBAR/CMFCColorBar::EnableAutomaticButton", "AFXCOLORBAR/CMFCColorBar::EnableOtherButton", "AFXCOLORBAR/CMFCColorBar::GetColor", "AFXCOLORBAR/CMFCColorBar::GetCommandID", "AFXCOLORBAR/CMFCColorBar::GetHighlightedColor", "AFXCOLORBAR/CMFCColorBar::GetHorzMargin", "AFXCOLORBAR/CMFCColorBar::GetVertMargin", "AFXCOLORBAR/CMFCColorBar::IsTearOff", "AFXCOLORBAR/CMFCColorBar::SetColor", "AFXCOLORBAR/CMFCColorBar::SetColorName", "AFXCOLORBAR/CMFCColorBar::SetCommandID", "AFXCOLORBAR/CMFCColorBar::SetDocumentColors", "AFXCOLORBAR/CMFCColorBar::SetHorzMargin", "AFXCOLORBAR/CMFCColorBar::SetVertMargin", "AFXCOLORBAR/CMFCColorBar::AdjustLocations", "AFXCOLORBAR/CMFCColorBar::AllowChangeTextLabels", "AFXCOLORBAR/CMFCColorBar::AllowShowOnList", "AFXCOLORBAR/CMFCColorBar::CalcSize", "AFXCOLORBAR/CMFCColorBar::CreatePalette", "AFXCOLORBAR/CMFCColorBar::GetColorGridSize", "AFXCOLORBAR/CMFCColorBar::GetExtraHeight", "AFXCOLORBAR/CMFCColorBar::InitColors", "AFXCOLORBAR/CMFCColorBar::OnKey", "AFXCOLORBAR/CMFCColorBar::OnSendCommand", "AFXCOLORBAR/CMFCColorBar::OnUpdateCmdUI", "AFXCOLORBAR/CMFCColorBar::OpenColorDialog", "AFXCOLORBAR/CMFCColorBar::Rebuild", "AFXCOLORBAR/CMFCColorBar::SelectPalette", "AFXCOLORBAR/CMFCColorBar::SetPropList", "AFXCOLORBAR/CMFCColorBar::ShowCommandMessageString"] helpviewer_keywords: ["CMFCColorBar [MFC], CMFCColorBar", "CMFCColorBar [MFC], ContextToSize", "CMFCColorBar [MFC], CreateControl", "CMFCColorBar [MFC], Create", "CMFCColorBar [MFC], EnableAutomaticButton", "CMFCColorBar [MFC], EnableOtherButton", "CMFCColorBar [MFC], GetColor", "CMFCColorBar [MFC], GetCommandID", "CMFCColorBar [MFC], GetHighlightedColor", "CMFCColorBar [MFC], GetHorzMargin", "CMFCColorBar [MFC], GetVertMargin", "CMFCColorBar [MFC], IsTearOff", "CMFCColorBar [MFC], SetColor", "CMFCColorBar [MFC], SetColorName", "CMFCColorBar [MFC], SetCommandID", "CMFCColorBar [MFC], SetDocumentColors", "CMFCColorBar [MFC], SetHorzMargin", "CMFCColorBar [MFC], SetVertMargin", "CMFCColorBar [MFC], AdjustLocations", "CMFCColorBar [MFC], AllowChangeTextLabels", "CMFCColorBar [MFC], AllowShowOnList", "CMFCColorBar [MFC], CalcSize", "CMFCColorBar [MFC], CreatePalette", "CMFCColorBar [MFC], GetColorGridSize", "CMFCColorBar [MFC], GetExtraHeight", "CMFCColorBar [MFC], InitColors", "CMFCColorBar [MFC], OnKey", "CMFCColorBar [MFC], OnSendCommand", "CMFCColorBar [MFC], OnUpdateCmdUI", "CMFCColorBar [MFC], OpenColorDialog", "CMFCColorBar [MFC], Rebuild", "CMFCColorBar [MFC], SelectPalette", "CMFCColorBar [MFC], SetPropList", "CMFCColorBar [MFC], ShowCommandMessageString"] -ms.assetid: 4756ee40-25a5-4cee-af7f-acab7993d1c7 --- # CMFCColorBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCColorBar` class represents a docking control bar that can select colors in a document or application. ## Syntax diff --git a/docs/mfc/reference/cmfccolorbutton-class.md b/docs/mfc/reference/cmfccolorbutton-class.md index dca58ef49eb..1c99ada333c 100644 --- a/docs/mfc/reference/cmfccolorbutton-class.md +++ b/docs/mfc/reference/cmfccolorbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCColorButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCColorButton", "AFXCOLORBUTTON/CMFCColorButton", "AFXCOLORBUTTON/CMFCColorButton::CMFCColorButton", "AFXCOLORBUTTON/CMFCColorButton::EnableAutomaticButton", "AFXCOLORBUTTON/CMFCColorButton::EnableOtherButton", "AFXCOLORBUTTON/CMFCColorButton::GetAutomaticColor", "AFXCOLORBUTTON/CMFCColorButton::GetColor", "AFXCOLORBUTTON/CMFCColorButton::SetColor", "AFXCOLORBUTTON/CMFCColorButton::SetColorName", "AFXCOLORBUTTON/CMFCColorButton::SetColumnsNumber", "AFXCOLORBUTTON/CMFCColorButton::SetDocumentColors", "AFXCOLORBUTTON/CMFCColorButton::SetPalette", "AFXCOLORBUTTON/CMFCColorButton::SizeToContent", "AFXCOLORBUTTON/CMFCColorButton::IsDrawXPTheme", "AFXCOLORBUTTON/CMFCColorButton::OnDraw", "AFXCOLORBUTTON/CMFCColorButton::OnDrawBorder", "AFXCOLORBUTTON/CMFCColorButton::OnDrawFocusRect", "AFXCOLORBUTTON/CMFCColorButton::OnShowColorPopup", "AFXCOLORBUTTON/CMFCColorButton::RebuildPalette", "AFXCOLORBUTTON/CMFCColorButton::UpdateColor", "AFXCOLORBUTTON/CMFCColorButton::m_bEnabledInCustomizeMode"] helpviewer_keywords: ["CMFCColorButton [MFC], CMFCColorButton", "CMFCColorButton [MFC], EnableAutomaticButton", "CMFCColorButton [MFC], EnableOtherButton", "CMFCColorButton [MFC], GetAutomaticColor", "CMFCColorButton [MFC], GetColor", "CMFCColorButton [MFC], SetColor", "CMFCColorButton [MFC], SetColorName", "CMFCColorButton [MFC], SetColumnsNumber", "CMFCColorButton [MFC], SetDocumentColors", "CMFCColorButton [MFC], SetPalette", "CMFCColorButton [MFC], SizeToContent", "CMFCColorButton [MFC], IsDrawXPTheme", "CMFCColorButton [MFC], OnDraw", "CMFCColorButton [MFC], OnDrawBorder", "CMFCColorButton [MFC], OnDrawFocusRect", "CMFCColorButton [MFC], OnShowColorPopup", "CMFCColorButton [MFC], RebuildPalette", "CMFCColorButton [MFC], UpdateColor", "CMFCColorButton [MFC], m_bEnabledInCustomizeMode"] -ms.assetid: 9fdf34ae-4cc5-4c5e-9d89-1c50e8a73699 --- # CMFCColorButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCColorButton` and [CMFCColorBar Class](../../mfc/reference/cmfccolorbar-class.md) classes are used together to implement a color picker control. ## Syntax diff --git a/docs/mfc/reference/cmfccolordialog-class.md b/docs/mfc/reference/cmfccolordialog-class.md index db781111fc2..2eac941f55d 100644 --- a/docs/mfc/reference/cmfccolordialog-class.md +++ b/docs/mfc/reference/cmfccolordialog-class.md @@ -4,10 +4,12 @@ title: "CMFCColorDialog Class" ms.date: "11/04/2016" f1_keywords: ["CMFCColorDialog", "AFXCOLORDIALOG/CMFCColorDialog", "AFXCOLORDIALOG/CMFCColorDialog::CMFCColorDialog", "AFXCOLORDIALOG/CMFCColorDialog::GetColor", "AFXCOLORDIALOG/CMFCColorDialog::GetPalette", "AFXCOLORDIALOG/CMFCColorDialog::RebuildPalette", "AFXCOLORDIALOG/CMFCColorDialog::SetCurrentColor", "AFXCOLORDIALOG/CMFCColorDialog::SetNewColor", "AFXCOLORDIALOG/CMFCColorDialog::SetPageOne", "AFXCOLORDIALOG/CMFCColorDialog::SetPageTwo"] helpviewer_keywords: ["CMFCColorDialog [MFC], CMFCColorDialog", "CMFCColorDialog [MFC], GetColor", "CMFCColorDialog [MFC], GetPalette", "CMFCColorDialog [MFC], RebuildPalette", "CMFCColorDialog [MFC], SetCurrentColor", "CMFCColorDialog [MFC], SetNewColor", "CMFCColorDialog [MFC], SetPageOne", "CMFCColorDialog [MFC], SetPageTwo"] -ms.assetid: 235bbbbc-a3b1-46e0-801b-fb55093ec579 --- # CMFCColorDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCColorDialog` class represents a color selection dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfccolormenubutton-class.md b/docs/mfc/reference/cmfccolormenubutton-class.md index e234a849f45..8298e45f61f 100644 --- a/docs/mfc/reference/cmfccolormenubutton-class.md +++ b/docs/mfc/reference/cmfccolormenubutton-class.md @@ -4,10 +4,12 @@ title: "CMFCColorMenuButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCColorMenuButton", "AFXCOLORMENUBUTTON/CMFCColorMenuButton", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::CMFCColorMenuButton", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::EnableAutomaticButton", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::EnableDocumentColors", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::EnableOtherButton", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::EnableTearOff", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::GetAutomaticColor", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::GetColor", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::GetColorByCmdID", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::OnChangeParentWnd", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::OpenColorDialog", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::SetColor", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::SetColorByCmdID", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::SetColorName", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::SetColumnsNumber", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::CopyFrom", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::CreatePopupMenu", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::IsEmptyMenuAllowed", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::OnDraw", "AFXCOLORMENUBUTTON/CMFCColorMenuButton::OnDrawOnCustomizeList"] helpviewer_keywords: ["CMFCColorMenuButton [MFC], CMFCColorMenuButton", "CMFCColorMenuButton [MFC], EnableAutomaticButton", "CMFCColorMenuButton [MFC], EnableDocumentColors", "CMFCColorMenuButton [MFC], EnableOtherButton", "CMFCColorMenuButton [MFC], EnableTearOff", "CMFCColorMenuButton [MFC], GetAutomaticColor", "CMFCColorMenuButton [MFC], GetColor", "CMFCColorMenuButton [MFC], GetColorByCmdID", "CMFCColorMenuButton [MFC], OnChangeParentWnd", "CMFCColorMenuButton [MFC], OpenColorDialog", "CMFCColorMenuButton [MFC], SetColor", "CMFCColorMenuButton [MFC], SetColorByCmdID", "CMFCColorMenuButton [MFC], SetColorName", "CMFCColorMenuButton [MFC], SetColumnsNumber", "CMFCColorMenuButton [MFC], CopyFrom", "CMFCColorMenuButton [MFC], CreatePopupMenu", "CMFCColorMenuButton [MFC], IsEmptyMenuAllowed", "CMFCColorMenuButton [MFC], OnDraw", "CMFCColorMenuButton [MFC], OnDrawOnCustomizeList"] -ms.assetid: 42685704-e994-4f7b-9553-62283c27b754 --- # CMFCColorMenuButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCColorMenuButton` class supports a menu command or a toolbar button that starts a color picker dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfccolorpickerctrl-class.md b/docs/mfc/reference/cmfccolorpickerctrl-class.md index dc47c78a255..4ccef18c4df 100644 --- a/docs/mfc/reference/cmfccolorpickerctrl-class.md +++ b/docs/mfc/reference/cmfccolorpickerctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCColorPickerCtrl [MFC], CMFCColorPickerCtrl", "CMFCCol --- # CMFCColorPickerCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCColorPickerCtrl` class provides functionality for a control that is used to select colors. ## Syntax diff --git a/docs/mfc/reference/cmfccolorpopupmenu-class.md b/docs/mfc/reference/cmfccolorpopupmenu-class.md index e67a537f494..0b6d3554b4c 100644 --- a/docs/mfc/reference/cmfccolorpopupmenu-class.md +++ b/docs/mfc/reference/cmfccolorpopupmenu-class.md @@ -4,10 +4,12 @@ title: "CMFCColorPopupMenu Class" ms.date: "11/04/2016" f1_keywords: ["CMFCColorPopupMenu", "AFXCOLORPOPUPMENU/CMFCColorPopupMenu", "AFXCOLORPOPUPMENU/CMFCColorPopupMenu::CMFCColorPopupMenu", "AFXCOLORPOPUPMENU/CMFCColorPopupMenu::CreateTearOffBar", "AFXCOLORPOPUPMENU/CMFCColorPopupMenu::GetMenuBar", "AFXCOLORPOPUPMENU/CMFCColorPopupMenu::SetPropList"] helpviewer_keywords: ["CMFCColorPopupMenu [MFC], CMFCColorPopupMenu", "CMFCColorPopupMenu [MFC], CreateTearOffBar", "CMFCColorPopupMenu [MFC], GetMenuBar", "CMFCColorPopupMenu [MFC], SetPropList"] -ms.assetid: 0bf9efe8-aed5-4ab7-b23b-eb284b4668be --- # CMFCColorPopupMenu Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a pop-up menu that users use to select colors in a document or application. ## Syntax diff --git a/docs/mfc/reference/cmfccustomcolorspropertypage-class.md b/docs/mfc/reference/cmfccustomcolorspropertypage-class.md index 215b8deb8d2..1c1005ea7a5 100644 --- a/docs/mfc/reference/cmfccustomcolorspropertypage-class.md +++ b/docs/mfc/reference/cmfccustomcolorspropertypage-class.md @@ -4,10 +4,12 @@ title: "CMFCCustomColorsPropertyPage Class" ms.date: "11/04/2016" f1_keywords: ["CMFCCustomColorsPropertyPage", "AFXCUSTOMCOLORSPROPERTYPAGE/CMFCCustomColorsPropertyPage", "AFXCUSTOMCOLORSPROPERTYPAGE/CMFCCustomColorsPropertyPage::Setup"] helpviewer_keywords: ["CMFCCustomColorsPropertyPage [MFC], Setup"] -ms.assetid: 46a45ba2-1fda-440d-8018-d4dcd44f5816 --- # CMFCCustomColorsPropertyPage Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a property page that can select custom colors in a color dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfcdesktopalertdialog-class.md b/docs/mfc/reference/cmfcdesktopalertdialog-class.md index 8807b8902f3..0e7912e917e 100644 --- a/docs/mfc/reference/cmfcdesktopalertdialog-class.md +++ b/docs/mfc/reference/cmfcdesktopalertdialog-class.md @@ -4,10 +4,12 @@ title: "CMFCDesktopAlertDialog Class" ms.date: "10/18/2018" f1_keywords: ["CMFCDesktopAlertDialog", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertDialog", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertDialog::CreateFromParams", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertDialog::GetDlgSize", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertDialog::HasFocus", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertDialog::PreTranslateMessage"] helpviewer_keywords: ["CMFCDesktopAlertDialog [MFC], CreateFromParams", "CMFCDesktopAlertDialog [MFC], GetDlgSize", "CMFCDesktopAlertDialog [MFC], HasFocus", "CMFCDesktopAlertDialog [MFC], PreTranslateMessage"] -ms.assetid: a53c60aa-9607-485b-b826-ec64962075f6 --- # CMFCDesktopAlertDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCDesktopAlertDialog` class is used together with the [CMFCDesktopAlertWnd Class](../../mfc/reference/cmfcdesktopalertwnd-class.md) to display a custom dialog in a popup window. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcdesktopalertwnd-class.md b/docs/mfc/reference/cmfcdesktopalertwnd-class.md index d473b05c588..5179e51c5f5 100644 --- a/docs/mfc/reference/cmfcdesktopalertwnd-class.md +++ b/docs/mfc/reference/cmfcdesktopalertwnd-class.md @@ -4,10 +4,12 @@ title: "CMFCDesktopAlertWnd Class" ms.date: "10/18/2018" f1_keywords: ["CMFCDesktopAlertWnd", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::Create", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::GetAnimationSpeed", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::GetAnimationType", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::GetAutoCloseTime", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::GetCaptionHeight", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::GetDialogSize", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::GetLastPos", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::GetTransparency", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::HasSmallCaption", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::OnBeforeShow", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::OnClickLinkButton", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::OnCommand", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::OnDraw", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::ProcessCommand", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::SetAnimationSpeed", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::SetAnimationType", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::SetAutoCloseTime", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::SetSmallCaption", "AFXDESKTOPALERTWND/CMFCDesktopAlertWnd::SetTransparency"] helpviewer_keywords: ["CMFCDesktopAlertWnd [MFC], Create", "CMFCDesktopAlertWnd [MFC], GetAnimationSpeed", "CMFCDesktopAlertWnd [MFC], GetAnimationType", "CMFCDesktopAlertWnd [MFC], GetAutoCloseTime", "CMFCDesktopAlertWnd [MFC], GetCaptionHeight", "CMFCDesktopAlertWnd [MFC], GetDialogSize", "CMFCDesktopAlertWnd [MFC], GetLastPos", "CMFCDesktopAlertWnd [MFC], GetTransparency", "CMFCDesktopAlertWnd [MFC], HasSmallCaption", "CMFCDesktopAlertWnd [MFC], OnBeforeShow", "CMFCDesktopAlertWnd [MFC], OnClickLinkButton", "CMFCDesktopAlertWnd [MFC], OnCommand", "CMFCDesktopAlertWnd [MFC], OnDraw", "CMFCDesktopAlertWnd [MFC], ProcessCommand", "CMFCDesktopAlertWnd [MFC], SetAnimationSpeed", "CMFCDesktopAlertWnd [MFC], SetAnimationType", "CMFCDesktopAlertWnd [MFC], SetAutoCloseTime", "CMFCDesktopAlertWnd [MFC], SetSmallCaption", "CMFCDesktopAlertWnd [MFC], SetTransparency"] -ms.assetid: 73a2dd7b-ea84-4ae2-9830-7cf6e8dd2425 --- # CMFCDesktopAlertWnd Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCDesktopAlertWnd` class implements the functionality of a modeless dialog box which appears on the screen to inform the user about an event. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcdesktopalertwndbutton-class.md b/docs/mfc/reference/cmfcdesktopalertwndbutton-class.md index 65e46a6c1ec..f216316ca09 100644 --- a/docs/mfc/reference/cmfcdesktopalertwndbutton-class.md +++ b/docs/mfc/reference/cmfcdesktopalertwndbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCDesktopAlertWndButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCDesktopAlertWndButton", "AFXDESKTOPALERTWND/CMFCDesktopAlertWndButton", "AFXDESKTOPALERTWND/CMFCDesktopAlertWndButton::IsCaptionButton", "AFXDESKTOPALERTWND/CMFCDesktopAlertWndButton::IsCloseButton"] helpviewer_keywords: ["CMFCDesktopAlertWndButton [MFC], IsCaptionButton", "CMFCDesktopAlertWndButton [MFC], IsCloseButton"] -ms.assetid: df39a0c8-0c39-4ab0-8c64-78c5b2c4ecaf --- # CMFCDesktopAlertWndButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allows buttons to be added to a desktop alert dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfcdesktopalertwndinfo-class.md b/docs/mfc/reference/cmfcdesktopalertwndinfo-class.md index fcf410dddb8..1591b9e0164 100644 --- a/docs/mfc/reference/cmfcdesktopalertwndinfo-class.md +++ b/docs/mfc/reference/cmfcdesktopalertwndinfo-class.md @@ -4,10 +4,12 @@ title: "CMFCDesktopAlertWndInfo Class" ms.date: "10/18/2018" f1_keywords: ["CMFCDesktopAlertWndInfo", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertWndInfo", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertWndInfo::m_hIcon", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertWndInfo::m_nURLCmdID", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertWndInfo::m_strText", "AFXDESKTOPALERTDIALOG/CMFCDesktopAlertWndInfo::m_strURL"] helpviewer_keywords: ["CMFCDesktopAlertWndInfo [MFC], m_hIcon", "CMFCDesktopAlertWndInfo [MFC], m_nURLCmdID", "CMFCDesktopAlertWndInfo [MFC], m_strText", "CMFCDesktopAlertWndInfo [MFC], m_strURL"] -ms.assetid: 5c9bb84e-6c96-4748-8e74-6951b6ae8e84 --- # CMFCDesktopAlertWndInfo Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCDesktopAlertWndInfo` class is used with the [CMFCDesktopAlertWnd Class](../../mfc/reference/cmfcdesktopalertwnd-class.md). It specifies the controls that are displayed if the desktop alert window pops up. ## Syntax diff --git a/docs/mfc/reference/cmfcdisablemenuanimation-class.md b/docs/mfc/reference/cmfcdisablemenuanimation-class.md index 5dc689897be..e4bd79b0ee9 100644 --- a/docs/mfc/reference/cmfcdisablemenuanimation-class.md +++ b/docs/mfc/reference/cmfcdisablemenuanimation-class.md @@ -4,10 +4,12 @@ title: "CMFCDisableMenuAnimation Class" ms.date: "11/04/2016" f1_keywords: ["CMFCDisableMenuAnimation", "AFXPOPUPMENU/CMFCDisableMenuAnimation", "AFXPOPUPMENU/CMFCDisableMenuAnimation::Restore"] helpviewer_keywords: ["CMFCDisableMenuAnimation [MFC], Restore"] -ms.assetid: c6eb07da-c382-43d6-8028-007f2320e50e --- # CMFCDisableMenuAnimation Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Disables pop-up menu animation. ## Syntax diff --git a/docs/mfc/reference/cmfcdragframeimpl-class.md b/docs/mfc/reference/cmfcdragframeimpl-class.md index 0305fe19091..6f1eca2b4cd 100644 --- a/docs/mfc/reference/cmfcdragframeimpl-class.md +++ b/docs/mfc/reference/cmfcdragframeimpl-class.md @@ -4,10 +4,12 @@ title: "CMFCDragFrameImpl Class" ms.date: "10/18/2018" f1_keywords: ["CMFCDragFrameImpl"] helpviewer_keywords: ["CMFCDragFrameImpl class [MFC]"] -ms.assetid: 500cd824-8188-43c2-8754-b7bb46b5648a --- # CMFCDragFrameImpl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCDragFrameImpl` class draws the drag rectangle that appears when the user drags a pane in the standard dock mode. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcdropdownframe-class.md b/docs/mfc/reference/cmfcdropdownframe-class.md index dc2193522d5..d82e9660902 100644 --- a/docs/mfc/reference/cmfcdropdownframe-class.md +++ b/docs/mfc/reference/cmfcdropdownframe-class.md @@ -4,10 +4,12 @@ title: "CMFCDropDownFrame Class" ms.date: "11/04/2016" f1_keywords: ["CMFCDropDownFrame", "AFXDROPDOWNTOOLBAR/CMFCDropDownFrame", "AFXDROPDOWNTOOLBAR/CMFCDropDownFrame::Create", "AFXDROPDOWNTOOLBAR/CMFCDropDownFrame::GetParentMenuBar", "AFXDROPDOWNTOOLBAR/CMFCDropDownFrame::GetParentPopupMenu", "AFXDROPDOWNTOOLBAR/CMFCDropDownFrame::RecalcLayout", "AFXDROPDOWNTOOLBAR/CMFCDropDownFrame::SetAutoDestroy"] helpviewer_keywords: ["CMFCDropDownFrame [MFC], Create", "CMFCDropDownFrame [MFC], GetParentMenuBar", "CMFCDropDownFrame [MFC], GetParentPopupMenu", "CMFCDropDownFrame [MFC], RecalcLayout", "CMFCDropDownFrame [MFC], SetAutoDestroy"] -ms.assetid: 09ff81a9-de00-43ec-9df9-b626f7728c4b --- # CMFCDropDownFrame Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides drop-down frame window functionality to drop-down toolbars and drop-down toolbar buttons. ## Syntax diff --git a/docs/mfc/reference/cmfcdropdowntoolbar-class.md b/docs/mfc/reference/cmfcdropdowntoolbar-class.md index 9fbdc25a7b8..ef021c74955 100644 --- a/docs/mfc/reference/cmfcdropdowntoolbar-class.md +++ b/docs/mfc/reference/cmfcdropdowntoolbar-class.md @@ -4,10 +4,12 @@ title: "CMFCDropDownToolBar Class" ms.date: "11/19/2018" f1_keywords: ["CMFCDropDownToolBar", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolBar", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolBar::AllowShowOnPaneMenu", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolBar::LoadBitmap", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolBar::LoadToolBar", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolBar::OnLButtonUp", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolBar::OnMouseMove", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolBar::OnSendCommand", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolBar::OnUpdateCmdUI"] helpviewer_keywords: ["CMFCDropDownToolBar [MFC], AllowShowOnPaneMenu", "CMFCDropDownToolBar [MFC], LoadBitmap", "CMFCDropDownToolBar [MFC], LoadToolBar", "CMFCDropDownToolBar [MFC], OnLButtonUp", "CMFCDropDownToolBar [MFC], OnMouseMove", "CMFCDropDownToolBar [MFC], OnSendCommand", "CMFCDropDownToolBar [MFC], OnUpdateCmdUI"] -ms.assetid: 78818ec5-83ce-42fa-a0d4-2d9d5ecc8770 --- # CMFCDropDownToolBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A toolbar that appears when the user presses and holds a top-level toolbar button. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcdropdowntoolbarbutton-class.md b/docs/mfc/reference/cmfcdropdowntoolbarbutton-class.md index dd68698320f..4b264833d8e 100644 --- a/docs/mfc/reference/cmfcdropdowntoolbarbutton-class.md +++ b/docs/mfc/reference/cmfcdropdowntoolbarbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCDropDownToolbarButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCDropDownToolbarButton", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::CMFCDropDownToolbarButton", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::CopyFrom", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::DropDownToolbar", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::ExportToMenuButton", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::GetDropDownToolBar", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::IsDropDown", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::IsExtraSize", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::OnCalculateSize", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::OnChangeParentWnd", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::OnClick", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::OnClickUp", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::OnContextHelp", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::OnCustomizeMenu", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::OnDraw", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::OnDrawOnCustomizeList", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::Serialize", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::SetDefaultCommand", "AFXDROPDOWNTOOLBAR/CMFCDropDownToolbarButton::m_uiShowBarDelay"] helpviewer_keywords: ["CMFCDropDownToolbarButton [MFC], CMFCDropDownToolbarButton", "CMFCDropDownToolbarButton [MFC], CopyFrom", "CMFCDropDownToolbarButton [MFC], DropDownToolbar", "CMFCDropDownToolbarButton [MFC], ExportToMenuButton", "CMFCDropDownToolbarButton [MFC], GetDropDownToolBar", "CMFCDropDownToolbarButton [MFC], IsDropDown", "CMFCDropDownToolbarButton [MFC], IsExtraSize", "CMFCDropDownToolbarButton [MFC], OnCalculateSize", "CMFCDropDownToolbarButton [MFC], OnChangeParentWnd", "CMFCDropDownToolbarButton [MFC], OnClick", "CMFCDropDownToolbarButton [MFC], OnClickUp", "CMFCDropDownToolbarButton [MFC], OnContextHelp", "CMFCDropDownToolbarButton [MFC], OnCustomizeMenu", "CMFCDropDownToolbarButton [MFC], OnDraw", "CMFCDropDownToolbarButton [MFC], OnDrawOnCustomizeList", "CMFCDropDownToolbarButton [MFC], Serialize", "CMFCDropDownToolbarButton [MFC], SetDefaultCommand", "CMFCDropDownToolbarButton [MFC], m_uiShowBarDelay"] -ms.assetid: bc9d69e6-bd3e-4c15-9368-e80a504a0ba7 --- # CMFCDropDownToolbarButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A type of toolbar button that behaves like a regular button when it is clicked. However, it opens a drop-down toolbar ( [CMFCDropDownToolBar Class](../../mfc/reference/cmfcdropdowntoolbar-class.md) if the user presses and holds the toolbar button down. ## Syntax diff --git a/docs/mfc/reference/cmfcdynamiclayout-class.md b/docs/mfc/reference/cmfcdynamiclayout-class.md index c41f1893c72..09cb98df6b4 100644 --- a/docs/mfc/reference/cmfcdynamiclayout-class.md +++ b/docs/mfc/reference/cmfcdynamiclayout-class.md @@ -6,6 +6,9 @@ f1_keywords: ["CMFCDynamicLayout", "AFXLAYOUT/CMFCDynamicLayout", "AFXLAYOUT/CMF --- # CMFCDynamicLayout Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Specifies how controls in a window are moved and resized as the user resizes the window. ## Syntax diff --git a/docs/mfc/reference/cmfceditbrowsectrl-class.md b/docs/mfc/reference/cmfceditbrowsectrl-class.md index c24728b72e6..331e901377c 100644 --- a/docs/mfc/reference/cmfceditbrowsectrl-class.md +++ b/docs/mfc/reference/cmfceditbrowsectrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCEditBrowseCtrl [MFC], EnableBrowseButton", "CMFCEditB --- # CMFCEditBrowseCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCEditBrowseCtrl` class supports the edit browse control, which is an editable text box that optionally contains a browse button. When the user clicks the browse button, the control performs a custom action or displays a standard dialog box that contains a file browser or a folder browser. ## Syntax diff --git a/docs/mfc/reference/cmfcfilterchunkvalueimpl-class.md b/docs/mfc/reference/cmfcfilterchunkvalueimpl-class.md index 7bd629455bd..8b8400cd514 100644 --- a/docs/mfc/reference/cmfcfilterchunkvalueimpl-class.md +++ b/docs/mfc/reference/cmfcfilterchunkvalueimpl-class.md @@ -4,10 +4,12 @@ title: "CMFCFilterChunkValueImpl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCFilterChunkValueImpl", "AFXWIN/CMFCFilterChunkValueImpl", "AFXWIN/CMFCFilterChunkValueImpl::CMFCFilterChunkValueImpl", "AFXWIN/CMFCFilterChunkValueImpl::Clear", "AFXWIN/CMFCFilterChunkValueImpl::CopyChunk", "AFXWIN/CMFCFilterChunkValueImpl::CopyFrom", "AFXWIN/CMFCFilterChunkValueImpl::GetChunkGUID", "AFXWIN/CMFCFilterChunkValueImpl::GetChunkPID", "AFXWIN/CMFCFilterChunkValueImpl::GetChunkType", "AFXWIN/CMFCFilterChunkValueImpl::GetString", "AFXWIN/CMFCFilterChunkValueImpl::GetValue", "AFXWIN/CMFCFilterChunkValueImpl::GetValueNoAlloc", "AFXWIN/CMFCFilterChunkValueImpl::IsValid", "AFXWIN/CMFCFilterChunkValueImpl::SetBoolValue", "AFXWIN/CMFCFilterChunkValueImpl::SetDwordValue", "AFXWIN/CMFCFilterChunkValueImpl::SetFileTimeValue", "AFXWIN/CMFCFilterChunkValueImpl::SetInt64Value", "AFXWIN/CMFCFilterChunkValueImpl::SetIntValue", "AFXWIN/CMFCFilterChunkValueImpl::SetLongValue", "AFXWIN/CMFCFilterChunkValueImpl::SetSystemTimeValue", "AFXWIN/CMFCFilterChunkValueImpl::SetTextValue", "AFXWIN/CMFCFilterChunkValueImpl::SetChunk"] helpviewer_keywords: ["CMFCFilterChunkValueImpl [MFC], CMFCFilterChunkValueImpl", "CMFCFilterChunkValueImpl [MFC], Clear", "CMFCFilterChunkValueImpl [MFC], CopyChunk", "CMFCFilterChunkValueImpl [MFC], CopyFrom", "CMFCFilterChunkValueImpl [MFC], GetChunkGUID", "CMFCFilterChunkValueImpl [MFC], GetChunkPID", "CMFCFilterChunkValueImpl [MFC], GetChunkType", "CMFCFilterChunkValueImpl [MFC], GetString", "CMFCFilterChunkValueImpl [MFC], GetValue", "CMFCFilterChunkValueImpl [MFC], GetValueNoAlloc", "CMFCFilterChunkValueImpl [MFC], IsValid", "CMFCFilterChunkValueImpl [MFC], SetBoolValue", "CMFCFilterChunkValueImpl [MFC], SetDwordValue", "CMFCFilterChunkValueImpl [MFC], SetFileTimeValue", "CMFCFilterChunkValueImpl [MFC], SetInt64Value", "CMFCFilterChunkValueImpl [MFC], SetIntValue", "CMFCFilterChunkValueImpl [MFC], SetLongValue", "CMFCFilterChunkValueImpl [MFC], SetSystemTimeValue", "CMFCFilterChunkValueImpl [MFC], SetTextValue", "CMFCFilterChunkValueImpl [MFC], SetChunk"] -ms.assetid: 3c833f23-5b88-4d08-9e09-ca6a8aec88bf --- # CMFCFilterChunkValueImpl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This is a class which simplifies both chunk and property value pair logic. ## Syntax diff --git a/docs/mfc/reference/cmfcfontcombobox-class.md b/docs/mfc/reference/cmfcfontcombobox-class.md index 23d4f981449..bebc44a37c0 100644 --- a/docs/mfc/reference/cmfcfontcombobox-class.md +++ b/docs/mfc/reference/cmfcfontcombobox-class.md @@ -4,10 +4,12 @@ title: "CMFCFontComboBox Class" ms.date: "11/04/2016" f1_keywords: ["CMFCFontComboBox", "AFXFONTCOMBOBOX/CMFCFontComboBox", "AFXFONTCOMBOBOX/CMFCFontComboBox::CMFCFontComboBox", "AFXFONTCOMBOBOX/CMFCFontComboBox::GetSelFont", "AFXFONTCOMBOBOX/CMFCFontComboBox::SelectFont", "AFXFONTCOMBOBOX/CMFCFontComboBox::Setup", "AFXFONTCOMBOBOX/CMFCFontComboBox::m_bDrawUsingFont"] helpviewer_keywords: ["CMFCFontComboBox [MFC], CMFCFontComboBox", "CMFCFontComboBox [MFC], GetSelFont", "CMFCFontComboBox [MFC], SelectFont", "CMFCFontComboBox [MFC], Setup", "CMFCFontComboBox [MFC], m_bDrawUsingFont"] -ms.assetid: 9a53fb0c-7b45-486d-8187-2a4c723d9fbb --- # CMFCFontComboBox Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCFontComboBox` class creates a combo box control that contains a list of fonts. ## Syntax diff --git a/docs/mfc/reference/cmfcfontinfo-class.md b/docs/mfc/reference/cmfcfontinfo-class.md index f44dd4e20b1..cf82482be39 100644 --- a/docs/mfc/reference/cmfcfontinfo-class.md +++ b/docs/mfc/reference/cmfcfontinfo-class.md @@ -4,10 +4,12 @@ title: "CMFCFontInfo Class" ms.date: "11/04/2016" f1_keywords: ["CMFCFontInfo", "AFXTOOLBARFONTCOMBOBOX/CMFCFontInfo", "AFXTOOLBARFONTCOMBOBOX/CMFCFontInfo::GetFullName", "AFXTOOLBARFONTCOMBOBOX/CMFCFontInfo::m_nCharSet", "AFXTOOLBARFONTCOMBOBOX/CMFCFontInfo::m_nPitchAndFamily", "AFXTOOLBARFONTCOMBOBOX/CMFCFontInfo::m_nType", "AFXTOOLBARFONTCOMBOBOX/CMFCFontInfo::m_strName", "AFXTOOLBARFONTCOMBOBOX/CMFCFontInfo::m_strScript"] helpviewer_keywords: ["CMFCFontInfo [MFC], GetFullName", "CMFCFontInfo [MFC], m_nCharSet", "CMFCFontInfo [MFC], m_nPitchAndFamily", "CMFCFontInfo [MFC], m_nType", "CMFCFontInfo [MFC], m_strName", "CMFCFontInfo [MFC], m_strScript"] -ms.assetid: f88329b2-d74e-4921-9441-a3bb6536a049 --- # CMFCFontInfo Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCFontInfo` class describes the name and other attributes of a font. ## Syntax diff --git a/docs/mfc/reference/cmfcheaderctrl-class.md b/docs/mfc/reference/cmfcheaderctrl-class.md index c736bcd0e22..fb24bc1b33b 100644 --- a/docs/mfc/reference/cmfcheaderctrl-class.md +++ b/docs/mfc/reference/cmfcheaderctrl-class.md @@ -4,10 +4,12 @@ title: "CMFCHeaderCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCHeaderCtrl", "AFXHEADERCTRL/CMFCHeaderCtrl", "AFXHEADERCTRL/CMFCHeaderCtrl::CMFCHeaderCtrl", "AFXHEADERCTRL/CMFCHeaderCtrl::EnableMultipleSort", "AFXHEADERCTRL/CMFCHeaderCtrl::GetColumnState", "AFXHEADERCTRL/CMFCHeaderCtrl::GetSortColumn", "AFXHEADERCTRL/CMFCHeaderCtrl::IsAscending", "AFXHEADERCTRL/CMFCHeaderCtrl::IsDialogControl", "AFXHEADERCTRL/CMFCHeaderCtrl::IsMultipleSort", "AFXHEADERCTRL/CMFCHeaderCtrl::RemoveSortColumn", "AFXHEADERCTRL/CMFCHeaderCtrl::SetSortColumn", "AFXHEADERCTRL/CMFCHeaderCtrl::OnDrawItem", "AFXHEADERCTRL/CMFCHeaderCtrl::OnDrawSortArrow", "AFXHEADERCTRL/CMFCHeaderCtrl::OnFillBackground"] helpviewer_keywords: ["CMFCHeaderCtrl [MFC], CMFCHeaderCtrl", "CMFCHeaderCtrl [MFC], EnableMultipleSort", "CMFCHeaderCtrl [MFC], GetColumnState", "CMFCHeaderCtrl [MFC], GetSortColumn", "CMFCHeaderCtrl [MFC], IsAscending", "CMFCHeaderCtrl [MFC], IsDialogControl", "CMFCHeaderCtrl [MFC], IsMultipleSort", "CMFCHeaderCtrl [MFC], RemoveSortColumn", "CMFCHeaderCtrl [MFC], SetSortColumn", "CMFCHeaderCtrl [MFC], OnDrawItem", "CMFCHeaderCtrl [MFC], OnDrawSortArrow", "CMFCHeaderCtrl [MFC], OnFillBackground"] -ms.assetid: 2f5fbf7b-5c75-42db-9216-640b1628f777 --- # CMFCHeaderCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCHeaderCtrl` class supports sorting multiple columns in a header control. ## Syntax diff --git a/docs/mfc/reference/cmfcimageeditordialog-class.md b/docs/mfc/reference/cmfcimageeditordialog-class.md index fb12f266bfe..46b2338e662 100644 --- a/docs/mfc/reference/cmfcimageeditordialog-class.md +++ b/docs/mfc/reference/cmfcimageeditordialog-class.md @@ -4,10 +4,12 @@ title: "CMFCImageEditorDialog Class" ms.date: "11/19/2018" f1_keywords: ["CMFCImageEditorDialog", "AFXIMAGEEDITORDIALOG/CMFCImageEditorDialog", "AFXIMAGEEDITORDIALOG/CMFCImageEditorDialog::CMFCImageEditorDialog"] helpviewer_keywords: ["CMFCImageEditorDialog [MFC], CMFCImageEditorDialog"] -ms.assetid: 6a7d08f3-1ec2-4062-9b79-a0c2776b58d1 --- # CMFCImageEditorDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCImageEditorDialog` class supports an image editor dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfcimageeditorpalettebar-class.md b/docs/mfc/reference/cmfcimageeditorpalettebar-class.md index 3e967fd6efe..28e32d6f7e3 100644 --- a/docs/mfc/reference/cmfcimageeditorpalettebar-class.md +++ b/docs/mfc/reference/cmfcimageeditorpalettebar-class.md @@ -4,10 +4,12 @@ title: "CMFCImageEditorPaletteBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCImageEditorPaletteBar", "AFXIMAGEEDITORDIALOG/CMFCImageEditorPaletteBar", "AFXIMAGEEDITORDIALOG/CMFCImageEditorPaletteBar::GetRowHeight", "AFXIMAGEEDITORDIALOG/CMFCImageEditorPaletteBar::IsButtonExtraSizeAvailable"] helpviewer_keywords: ["CMFCImageEditorPaletteBar [MFC], GetRowHeight", "CMFCImageEditorPaletteBar [MFC], IsButtonExtraSizeAvailable"] -ms.assetid: 3fb7ba8e-f254-4d56-b913-9941b4ed8138 --- # CMFCImageEditorPaletteBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides palette bar functionality to an image editor dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfcimagepaintarea-class.md b/docs/mfc/reference/cmfcimagepaintarea-class.md index b9b12f31673..2c8bd7c1b13 100644 --- a/docs/mfc/reference/cmfcimagepaintarea-class.md +++ b/docs/mfc/reference/cmfcimagepaintarea-class.md @@ -4,10 +4,12 @@ title: "CMFCImagePaintArea Class" ms.date: "11/04/2016" f1_keywords: ["CMFCImagePaintArea", "AFXIMAGEPAINTAREA/CMFCImagePaintArea", "AFXIMAGEPAINTAREA/CMFCImagePaintArea::CMFCImagePaintArea", "AFXIMAGEPAINTAREA/CMFCImagePaintArea::GetMode", "AFXIMAGEPAINTAREA/CMFCImagePaintArea::SetBitmap", "AFXIMAGEPAINTAREA/CMFCImagePaintArea::SetColor", "AFXIMAGEPAINTAREA/CMFCImagePaintArea::SetMode"] helpviewer_keywords: ["CMFCImagePaintArea [MFC], CMFCImagePaintArea", "CMFCImagePaintArea [MFC], GetMode", "CMFCImagePaintArea [MFC], SetBitmap", "CMFCImagePaintArea [MFC], SetColor", "CMFCImagePaintArea [MFC], SetMode"] -ms.assetid: c59eec22-f15a-4e58-8c4d-4a18a41f4452 --- # CMFCImagePaintArea Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the picture area that you use to modify an image in an image editor dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfcimagepaintarea-image-edit-mode-enumeration.md b/docs/mfc/reference/cmfcimagepaintarea-image-edit-mode-enumeration.md index ea4942119f2..3ca70390145 100644 --- a/docs/mfc/reference/cmfcimagepaintarea-image-edit-mode-enumeration.md +++ b/docs/mfc/reference/cmfcimagepaintarea-image-edit-mode-enumeration.md @@ -4,10 +4,12 @@ title: "CMFCImagePaintArea::IMAGE_EDIT_MODE Enumeration" ms.date: "11/04/2016" f1_keywords: ["IMAGE_EDIT_MODE Enumeration"] helpviewer_keywords: ["IMAGE_EDIT_MODE Enumeration method [MFC]"] -ms.assetid: e51db66a-fa1c-4766-9dac-a25b595f871a --- # CMFCImagePaintArea::IMAGE_EDIT_MODE Enumeration +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Specifies a drawing mode that you use to modify an image in an image editor dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfckeymapdialog-class.md b/docs/mfc/reference/cmfckeymapdialog-class.md index 43c94443db1..80c2426815c 100644 --- a/docs/mfc/reference/cmfckeymapdialog-class.md +++ b/docs/mfc/reference/cmfckeymapdialog-class.md @@ -4,10 +4,12 @@ title: "CMFCKeyMapDialog Class" ms.date: "11/04/2016" f1_keywords: ["CMFCKeyMapDialog", "AFXKEYMAPDIALOG/CMFCKeyMapDialog", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::CMFCKeyMapDialog", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::DoModal", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::FormatItem", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::GetCommandKeys", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::OnInsertItem", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::OnPrintHeader", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::OnPrintItem", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::OnSetColumns", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::PrintKeyMap", "AFXKEYMAPDIALOG/CMFCKeyMapDialog::SetColumnsWidth"] helpviewer_keywords: ["CMFCKeyMapDialog [MFC], CMFCKeyMapDialog", "CMFCKeyMapDialog [MFC], DoModal", "CMFCKeyMapDialog [MFC], FormatItem", "CMFCKeyMapDialog [MFC], GetCommandKeys", "CMFCKeyMapDialog [MFC], OnInsertItem", "CMFCKeyMapDialog [MFC], OnPrintHeader", "CMFCKeyMapDialog [MFC], OnPrintItem", "CMFCKeyMapDialog [MFC], OnSetColumns", "CMFCKeyMapDialog [MFC], PrintKeyMap", "CMFCKeyMapDialog [MFC], SetColumnsWidth"] -ms.assetid: 5feb4942-d636-462d-a162-0104dd320f4e --- # CMFCKeyMapDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCKeyMapDialog` class supports a control that maps commands to keys on the keyboard. ## Syntax diff --git a/docs/mfc/reference/cmfclinkctrl-class.md b/docs/mfc/reference/cmfclinkctrl-class.md index 9fee3460bae..0e008d64bfd 100644 --- a/docs/mfc/reference/cmfclinkctrl-class.md +++ b/docs/mfc/reference/cmfclinkctrl-class.md @@ -4,10 +4,12 @@ title: "CMFCLinkCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCLinkCtrl", "AFXLINKCTRL/CMFCLinkCtrl", "AFXLINKCTRL/CMFCLinkCtrl::SetURL", "AFXLINKCTRL/CMFCLinkCtrl::SetURLPrefix", "AFXLINKCTRL/CMFCLinkCtrl::SizeToContent", "AFXLINKCTRL/CMFCLinkCtrl::OnDrawFocusRect"] helpviewer_keywords: ["CMFCLinkCtrl [MFC], SetURL", "CMFCLinkCtrl [MFC], SetURLPrefix", "CMFCLinkCtrl [MFC], SizeToContent", "CMFCLinkCtrl [MFC], OnDrawFocusRect"] -ms.assetid: 80f3874d-7cc8-410e-9ff1-62a225f5034b --- # CMFCLinkCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCLinkCtrl` class displays a button as a hyperlink and invokes the link's target when the button is clicked. ## Syntax diff --git a/docs/mfc/reference/cmfclistctrl-class.md b/docs/mfc/reference/cmfclistctrl-class.md index 2ac870b8469..9f7534a3fdf 100644 --- a/docs/mfc/reference/cmfclistctrl-class.md +++ b/docs/mfc/reference/cmfclistctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCListCtrl [MFC], EnableMarkSortedColumn", "CMFCListCtr --- # `CMFCListCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCListCtrl` class extends the functionality of [`CListCtrl` Class](../../mfc/reference/clistctrl-class.md) class by supporting the advanced header control functionality of the [`CMFCHeaderCtrl` Class](../../mfc/reference/cmfcheaderctrl-class.md). ## Syntax diff --git a/docs/mfc/reference/cmfcmaskededit-class.md b/docs/mfc/reference/cmfcmaskededit-class.md index 7b846c8641d..71ee2f137b4 100644 --- a/docs/mfc/reference/cmfcmaskededit-class.md +++ b/docs/mfc/reference/cmfcmaskededit-class.md @@ -4,10 +4,12 @@ title: "CMFCMaskedEdit Class" ms.date: "11/04/2016" f1_keywords: ["CMFCMaskedEdit", "AFXMASKEDEDIT/CMFCMaskedEdit", "AFXMASKEDEDIT/CMFCMaskedEdit::DisableMask", "AFXMASKEDEDIT/CMFCMaskedEdit::EnableGetMaskedCharsOnly", "AFXMASKEDEDIT/CMFCMaskedEdit::EnableMask", "AFXMASKEDEDIT/CMFCMaskedEdit::EnableSelectByGroup", "AFXMASKEDEDIT/CMFCMaskedEdit::EnableSetMaskedCharsOnly", "AFXMASKEDEDIT/CMFCMaskedEdit::GetWindowText", "AFXMASKEDEDIT/CMFCMaskedEdit::SetValidChars", "AFXMASKEDEDIT/CMFCMaskedEdit::SetWindowText", "AFXMASKEDEDIT/CMFCMaskedEdit::IsMaskedChar"] helpviewer_keywords: ["CMFCMaskedEdit [MFC], DisableMask", "CMFCMaskedEdit [MFC], EnableGetMaskedCharsOnly", "CMFCMaskedEdit [MFC], EnableMask", "CMFCMaskedEdit [MFC], EnableSelectByGroup", "CMFCMaskedEdit [MFC], EnableSetMaskedCharsOnly", "CMFCMaskedEdit [MFC], GetWindowText", "CMFCMaskedEdit [MFC], SetValidChars", "CMFCMaskedEdit [MFC], SetWindowText", "CMFCMaskedEdit [MFC], IsMaskedChar"] -ms.assetid: 13b1a645-2d5d-4c37-8599-16d5003f23a5 --- # CMFCMaskedEdit Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCMaskedEdit` class supports a masked edit control, which validates user input against a mask and displays the validated results according to a template. ## Syntax diff --git a/docs/mfc/reference/cmfcmenubar-class.md b/docs/mfc/reference/cmfcmenubar-class.md index 8b8174252b0..5dfec5efea7 100644 --- a/docs/mfc/reference/cmfcmenubar-class.md +++ b/docs/mfc/reference/cmfcmenubar-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCMenuBar [MFC], AdjustLocations", "CMFCMenuBar [MFC], --- # CMFCMenuBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A menu bar that implements docking. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcmenubutton-class.md b/docs/mfc/reference/cmfcmenubutton-class.md index 380fdad1eed..a7a14369f28 100644 --- a/docs/mfc/reference/cmfcmenubutton-class.md +++ b/docs/mfc/reference/cmfcmenubutton-class.md @@ -4,10 +4,12 @@ title: "CMFCMenuButton Class" ms.date: "07/15/2019" f1_keywords: ["CMFCMenuButton", "AFXMENUBUTTON/CMFCMenuButton", "AFXMENUBUTTON/CMFCMenuButton::CMFCMenuButton", "AFXMENUBUTTON/CMFCMenuButton::PreTranslateMessage", "AFXMENUBUTTON/CMFCMenuButton::SizeToContent", "AFXMENUBUTTON/CMFCMenuButton::m_bOSMenu", "AFXMENUBUTTON/CMFCMenuButton::m_bRightArrow", "AFXMENUBUTTON/CMFCMenuButton::m_bStayPressed", "AFXMENUBUTTON/CMFCMenuButton::m_hMenu", "AFXMENUBUTTON/CMFCMenuButton::m_nMenuResult", "AFXMENUBUTTON/CMFCMenuButton::m_bDefaultClick"] helpviewer_keywords: ["CMFCMenuButton [MFC], CMFCMenuButton", "CMFCMenuButton [MFC], PreTranslateMessage", "CMFCMenuButton [MFC], SizeToContent", "CMFCMenuButton [MFC], m_bOSMenu", "CMFCMenuButton [MFC], m_bRightArrow", "CMFCMenuButton [MFC], m_bStayPressed", "CMFCMenuButton [MFC], m_hMenu", "CMFCMenuButton [MFC], m_nMenuResult", "CMFCMenuButton [MFC], m_bDefaultClick"] -ms.assetid: 53d3d459-1e5a-47c5-8b7f-2e61f6af5187 --- # CMFCMenuButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A button that displays a pop-up menu and reports on the user's menu selections. ## Syntax diff --git a/docs/mfc/reference/cmfcoutlookbar-class.md b/docs/mfc/reference/cmfcoutlookbar-class.md index 86aa09e2f8d..e4b228d5fac 100644 --- a/docs/mfc/reference/cmfcoutlookbar-class.md +++ b/docs/mfc/reference/cmfcoutlookbar-class.md @@ -4,10 +4,12 @@ title: "CMFCOutlookBar Class" ms.date: "06/25/2018" f1_keywords: ["CMFCOutlookBar", "AFXOUTLOOKBAR/CMFCOutlookBar", "AFXOUTLOOKBAR/CMFCOutlookBar::AllowDestroyEmptyTabbedPane", "AFXOUTLOOKBAR/CMFCOutlookBar::CanAcceptPane", "AFXOUTLOOKBAR/CMFCOutlookBar::CanSetCaptionTextToTabName", "AFXOUTLOOKBAR/CMFCOutlookBar::Create", "AFXOUTLOOKBAR/CMFCOutlookBar::CreateCustomPage", "AFXOUTLOOKBAR/CMFCOutlookBar::DoesAllowDynInsertBefore", "AFXOUTLOOKBAR/CMFCOutlookBar::FloatTab", "AFXOUTLOOKBAR/CMFCOutlookBar::GetButtonsFont", "AFXOUTLOOKBAR/CMFCOutlookBar::GetTabArea", "AFXOUTLOOKBAR/CMFCOutlookBar::IsMode2003", "AFXOUTLOOKBAR/CMFCOutlookBar::OnAfterAnimation", "AFXOUTLOOKBAR/CMFCOutlookBar::OnBeforeAnimation", "AFXOUTLOOKBAR/CMFCOutlookBar::OnScroll", "AFXOUTLOOKBAR/CMFCOutlookBar::RemoveCustomPage", "AFXOUTLOOKBAR/CMFCOutlookBar::SetButtonsFont", "AFXOUTLOOKBAR/CMFCOutlookBar::SetMode2003"] helpviewer_keywords: ["CMFCOutlookBar [MFC], AllowDestroyEmptyTabbedPane", "CMFCOutlookBar [MFC], CanAcceptPane", "CMFCOutlookBar [MFC], CanSetCaptionTextToTabName", "CMFCOutlookBar [MFC], Create", "CMFCOutlookBar [MFC], CreateCustomPage", "CMFCOutlookBar [MFC], DoesAllowDynInsertBefore", "CMFCOutlookBar [MFC], FloatTab", "CMFCOutlookBar [MFC], GetButtonsFont", "CMFCOutlookBar [MFC], GetTabArea", "CMFCOutlookBar [MFC], IsMode2003", "CMFCOutlookBar [MFC], OnAfterAnimation", "CMFCOutlookBar [MFC], OnBeforeAnimation", "CMFCOutlookBar [MFC], OnScroll", "CMFCOutlookBar [MFC], RemoveCustomPage", "CMFCOutlookBar [MFC], SetButtonsFont", "CMFCOutlookBar [MFC], SetMode2003"] -ms.assetid: 2b335f71-ce99-4efd-b103-e65ba43ffc36 --- # CMFCOutlookBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A tabbed pane with the visual appearance of the **Navigation Pane** in Microsoft Outlook 2000 or Outlook 2003. The `CMFCOutlookBar` object contains a [CMFCOutlookBarTabCtrl Class](../../mfc/reference/cmfcoutlookbartabctrl-class.md) object and a series of tabs. The tabs can be either [CMFCOutlookBarPane Class](../../mfc/reference/cmfcoutlookbarpane-class.md) objects or `CWnd`-derived objects. To the user, the Outlook bar appears as a series of buttons and a display area. When the user clicks a button, the corresponding control or button pane is displayed. ## Syntax diff --git a/docs/mfc/reference/cmfcoutlookbarpane-class.md b/docs/mfc/reference/cmfcoutlookbarpane-class.md index 04527f6dd39..37a1f9e4ad7 100644 --- a/docs/mfc/reference/cmfcoutlookbarpane-class.md +++ b/docs/mfc/reference/cmfcoutlookbarpane-class.md @@ -4,10 +4,12 @@ title: "CMFCOutlookBarPane Class" ms.date: "11/04/2016" f1_keywords: ["CMFCOutlookBarPane", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::AddButton", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::CanBeAttached", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::ClearAll", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::Create", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::EnablePageScrollMode", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::GetRegularColor", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::IsBackgroundTexture", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::IsDrawShadedHighlight", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::RemoveButton", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::SetBackColor", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::SetBackImage", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::SetDefaultState", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::SetExtraSpace", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::SetTextColor", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::SetTransparentColor", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::EnableContextMenuItems", "AFXOUTLOOKBARPANE/CMFCOutlookBarPane::RemoveAllButtons"] helpviewer_keywords: ["CMFCOutlookBarPane [MFC], AddButton", "CMFCOutlookBarPane [MFC], CanBeAttached", "CMFCOutlookBarPane [MFC], ClearAll", "CMFCOutlookBarPane [MFC], Create", "CMFCOutlookBarPane [MFC], EnablePageScrollMode", "CMFCOutlookBarPane [MFC], GetRegularColor", "CMFCOutlookBarPane [MFC], IsBackgroundTexture", "CMFCOutlookBarPane [MFC], IsDrawShadedHighlight", "CMFCOutlookBarPane [MFC], RemoveButton", "CMFCOutlookBarPane [MFC], SetBackColor", "CMFCOutlookBarPane [MFC], SetBackImage", "CMFCOutlookBarPane [MFC], SetDefaultState", "CMFCOutlookBarPane [MFC], SetExtraSpace", "CMFCOutlookBarPane [MFC], SetTextColor", "CMFCOutlookBarPane [MFC], SetTransparentColor", "CMFCOutlookBarPane [MFC], EnableContextMenuItems", "CMFCOutlookBarPane [MFC], RemoveAllButtons"] -ms.assetid: 094e2ef3-a118-487e-a4cc-27626108fe08 --- # CMFCOutlookBarPane Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. A control derived from [CMFCToolBar Class](../../mfc/reference/cmfctoolbar-class.md) that can be inserted into an Outlook bar ( [CMFCOutlookBar Class](../../mfc/reference/cmfcoutlookbar-class.md)). The Outlook bar pane contains a column of large buttons. The user can scroll up and down the list of buttons if it is larger than the pane. When the user detaches an Outlook bar pane from the Outlook bar, it can float or dock in the main frame window. diff --git a/docs/mfc/reference/cmfcoutlookbartabctrl-class.md b/docs/mfc/reference/cmfcoutlookbartabctrl-class.md index 0ea3e6a49b0..7af29c03428 100644 --- a/docs/mfc/reference/cmfcoutlookbartabctrl-class.md +++ b/docs/mfc/reference/cmfcoutlookbartabctrl-class.md @@ -4,10 +4,12 @@ title: "CMFCOutlookBarTabCtrl Class" ms.date: "10/18/2018" f1_keywords: ["CMFCOutlookBarTabCtrl", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::AddControl", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::CanShowFewerPageButtons", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::CanShowMorePageButtons", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::Create", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::EnableAnimation", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::EnableInPlaceEdit", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::EnableScrollButtons", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::GetBorderSize", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::GetVisiblePageButtons", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::IsAnimation", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::IsMode2003", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::OnShowFewerPageButtons", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::OnShowMorePageButtons", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::OnShowOptions", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::SetActiveTab", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::SetBorderSize", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::SetPageButtonTextAlign", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::SetToolbarImageList", "AFXOUTLOOKBARTABCTRL/CMFCOutlookBarTabCtrl::SetVisiblePageButtons"] helpviewer_keywords: ["CMFCOutlookBarTabCtrl [MFC], AddControl", "CMFCOutlookBarTabCtrl [MFC], CanShowFewerPageButtons", "CMFCOutlookBarTabCtrl [MFC], CanShowMorePageButtons", "CMFCOutlookBarTabCtrl [MFC], Create", "CMFCOutlookBarTabCtrl [MFC], EnableAnimation", "CMFCOutlookBarTabCtrl [MFC], EnableInPlaceEdit", "CMFCOutlookBarTabCtrl [MFC], EnableScrollButtons", "CMFCOutlookBarTabCtrl [MFC], GetBorderSize", "CMFCOutlookBarTabCtrl [MFC], GetVisiblePageButtons", "CMFCOutlookBarTabCtrl [MFC], IsAnimation", "CMFCOutlookBarTabCtrl [MFC], IsMode2003", "CMFCOutlookBarTabCtrl [MFC], OnShowFewerPageButtons", "CMFCOutlookBarTabCtrl [MFC], OnShowMorePageButtons", "CMFCOutlookBarTabCtrl [MFC], OnShowOptions", "CMFCOutlookBarTabCtrl [MFC], SetActiveTab", "CMFCOutlookBarTabCtrl [MFC], SetBorderSize", "CMFCOutlookBarTabCtrl [MFC], SetPageButtonTextAlign", "CMFCOutlookBarTabCtrl [MFC], SetToolbarImageList", "CMFCOutlookBarTabCtrl [MFC], SetVisiblePageButtons"] -ms.assetid: b1f2b3f7-cc59-49a3-99d8-7ff9b37c044b --- # CMFCOutlookBarTabCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A tab control that has the visual appearance of the **Navigation Pane** in Microsoft Outlook. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcpopupmenu-class.md b/docs/mfc/reference/cmfcpopupmenu-class.md index ab702034109..a56effeb9f5 100644 --- a/docs/mfc/reference/cmfcpopupmenu-class.md +++ b/docs/mfc/reference/cmfcpopupmenu-class.md @@ -4,10 +4,12 @@ title: "CMFCPopupMenu Class" ms.date: "10/18/2018" f1_keywords: ["CMFCPopupMenu", "AFXPOPUPMENU/CMFCPopupMenu", "AFXPOPUPMENU/CMFCPopupMenu::CMFCPopupMenu", "AFXPOPUPMENU/CMFCPopupMenu::ActivatePopupMenu", "AFXPOPUPMENU/CMFCPopupMenu::AlwaysShowEmptyToolsEntry", "AFXPOPUPMENU/CMFCPopupMenu::AreAllCommandsShown", "AFXPOPUPMENU/CMFCPopupMenu::CheckArea", "AFXPOPUPMENU/CMFCPopupMenu::CloseMenu", "AFXPOPUPMENU/CMFCPopupMenu::Create", "AFXPOPUPMENU/CMFCPopupMenu::DefaultMouseClickOnClose", "AFXPOPUPMENU/CMFCPopupMenu::EnableMenuLogo", "AFXPOPUPMENU/CMFCPopupMenu::EnableMenuSound", "AFXPOPUPMENU/CMFCPopupMenu::EnableResize", "AFXPOPUPMENU/CMFCPopupMenu::EnableScrolling", "AFXPOPUPMENU/CMFCPopupMenu::EnableVertResize", "AFXPOPUPMENU/CMFCPopupMenu::FindSubItemByCommand", "AFXPOPUPMENU/CMFCPopupMenu::GetActiveMenu", "AFXPOPUPMENU/CMFCPopupMenu::GetAnimationSpeed", "AFXPOPUPMENU/CMFCPopupMenu::GetAnimationType", "AFXPOPUPMENU/CMFCPopupMenu::GetDropDirection", "AFXPOPUPMENU/CMFCPopupMenu::GetForceMenuFocus", "AFXPOPUPMENU/CMFCPopupMenu::GetForceShadow", "AFXPOPUPMENU/CMFCPopupMenu::GetHMenu", "AFXPOPUPMENU/CMFCPopupMenu::GetMenuBar", "AFXPOPUPMENU/CMFCPopupMenu::GetMenuItem", "AFXPOPUPMENU/CMFCPopupMenu::GetMenuItemCount", "AFXPOPUPMENU/CMFCPopupMenu::GetMessageWnd", "AFXPOPUPMENU/CMFCPopupMenu::GetParentArea", "AFXPOPUPMENU/CMFCPopupMenu::GetParentButton", "AFXPOPUPMENU/CMFCPopupMenu::GetParentPopupMenu", "AFXPOPUPMENU/CMFCPopupMenu::GetParentRibbonElement", "AFXPOPUPMENU/CMFCPopupMenu::GetParentToolBar", "AFXPOPUPMENU/CMFCPopupMenu::GetQuickCustomizeType", "AFXPOPUPMENU/CMFCPopupMenu::GetSelItem", "AFXPOPUPMENU/CMFCPopupMenu::HasBeenResized", "AFXPOPUPMENU/CMFCPopupMenu::HideRarelyUsedCommands", "AFXPOPUPMENU/CMFCPopupMenu::InCommand", "AFXPOPUPMENU/CMFCPopupMenu::InsertItem", "AFXPOPUPMENU/CMFCPopupMenu::InsertSeparator", "AFXPOPUPMENU/CMFCPopupMenu::IsAlwaysClose", "AFXPOPUPMENU/CMFCPopupMenu::IsAlwaysShowEmptyToolsEntry", "AFXPOPUPMENU/CMFCPopupMenu::IsCustomizePane", "AFXPOPUPMENU/CMFCPopupMenu::IsEscClose", "AFXPOPUPMENU/CMFCPopupMenu::IsIdle", "AFXPOPUPMENU/CMFCPopupMenu::IsMenuSound", "AFXPOPUPMENU/CMFCPopupMenu::IsQuickCustomize", "AFXPOPUPMENU/CMFCPopupMenu::IsResizeble", "AFXPOPUPMENU/CMFCPopupMenu::IsRightAlign", "AFXPOPUPMENU/CMFCPopupMenu::IsScrollable", "AFXPOPUPMENU/CMFCPopupMenu::IsSendMenuSelectMsg", "AFXPOPUPMENU/CMFCPopupMenu::IsShown", "AFXPOPUPMENU/CMFCPopupMenu::MoveTo", "AFXPOPUPMENU/CMFCPopupMenu::OnCmdMsg", "AFXPOPUPMENU/CMFCPopupMenu::PostCommand", "AFXPOPUPMENU/CMFCPopupMenu::PreTranslateMessage", "AFXPOPUPMENU/CMFCPopupMenu::RecalcLayout", "AFXPOPUPMENU/CMFCPopupMenu::RemoveAllItems", "AFXPOPUPMENU/CMFCPopupMenu::RemoveItem", "AFXPOPUPMENU/CMFCPopupMenu::SaveState", "AFXPOPUPMENU/CMFCPopupMenu::SetAnimationSpeed", "AFXPOPUPMENU/CMFCPopupMenu::SetAnimationType", "AFXPOPUPMENU/CMFCPopupMenu::SetAutoDestroy", "AFXPOPUPMENU/CMFCPopupMenu::SetDefaultItem", "AFXPOPUPMENU/CMFCPopupMenu::SetForceMenuFocus", "AFXPOPUPMENU/CMFCPopupMenu::SetForceShadow", "AFXPOPUPMENU/CMFCPopupMenu::SetMaxWidth", "AFXPOPUPMENU/CMFCPopupMenu::SetMessageWnd", "AFXPOPUPMENU/CMFCPopupMenu::SetParentRibbonElement", "AFXPOPUPMENU/CMFCPopupMenu::SetQuickCustomizeType", "AFXPOPUPMENU/CMFCPopupMenu::SetQuickMode", "AFXPOPUPMENU/CMFCPopupMenu::SetRightAlign", "AFXPOPUPMENU/CMFCPopupMenu::SetSendMenuSelectMsg", "AFXPOPUPMENU/CMFCPopupMenu::ShowAllCommands", "AFXPOPUPMENU/CMFCPopupMenu::TriggerResize", "AFXPOPUPMENU/CMFCPopupMenu::UpdateAllShadows", "AFXPOPUPMENU/CMFCPopupMenu::UpdateShadow", "AFXPOPUPMENU/CMFCPopupMenu::CreateTearOffBar", "AFXPOPUPMENU/CMFCPopupMenu::OnChangeHot", "AFXPOPUPMENU/CMFCPopupMenu::OnChooseItem"] helpviewer_keywords: ["CMFCPopupMenu [MFC], CMFCPopupMenu", "CMFCPopupMenu [MFC], ActivatePopupMenu", "CMFCPopupMenu [MFC], AlwaysShowEmptyToolsEntry", "CMFCPopupMenu [MFC], AreAllCommandsShown", "CMFCPopupMenu [MFC], CheckArea", "CMFCPopupMenu [MFC], CloseMenu", "CMFCPopupMenu [MFC], Create", "CMFCPopupMenu [MFC], DefaultMouseClickOnClose", "CMFCPopupMenu [MFC], EnableMenuLogo", "CMFCPopupMenu [MFC], EnableMenuSound", "CMFCPopupMenu [MFC], EnableResize", "CMFCPopupMenu [MFC], EnableScrolling", "CMFCPopupMenu [MFC], EnableVertResize", "CMFCPopupMenu [MFC], FindSubItemByCommand", "CMFCPopupMenu [MFC], GetActiveMenu", "CMFCPopupMenu [MFC], GetAnimationSpeed", "CMFCPopupMenu [MFC], GetAnimationType", "CMFCPopupMenu [MFC], GetDropDirection", "CMFCPopupMenu [MFC], GetForceMenuFocus", "CMFCPopupMenu [MFC], GetForceShadow", "CMFCPopupMenu [MFC], GetHMenu", "CMFCPopupMenu [MFC], GetMenuBar", "CMFCPopupMenu [MFC], GetMenuItem", "CMFCPopupMenu [MFC], GetMenuItemCount", "CMFCPopupMenu [MFC], GetMessageWnd", "CMFCPopupMenu [MFC], GetParentArea", "CMFCPopupMenu [MFC], GetParentButton", "CMFCPopupMenu [MFC], GetParentPopupMenu", "CMFCPopupMenu [MFC], GetParentRibbonElement", "CMFCPopupMenu [MFC], GetParentToolBar", "CMFCPopupMenu [MFC], GetQuickCustomizeType", "CMFCPopupMenu [MFC], GetSelItem", "CMFCPopupMenu [MFC], HasBeenResized", "CMFCPopupMenu [MFC], HideRarelyUsedCommands", "CMFCPopupMenu [MFC], InCommand", "CMFCPopupMenu [MFC], InsertItem", "CMFCPopupMenu [MFC], InsertSeparator", "CMFCPopupMenu [MFC], IsAlwaysClose", "CMFCPopupMenu [MFC], IsAlwaysShowEmptyToolsEntry", "CMFCPopupMenu [MFC], IsCustomizePane", "CMFCPopupMenu [MFC], IsEscClose", "CMFCPopupMenu [MFC], IsIdle", "CMFCPopupMenu [MFC], IsMenuSound", "CMFCPopupMenu [MFC], IsQuickCustomize", "CMFCPopupMenu [MFC], IsResizeble", "CMFCPopupMenu [MFC], IsRightAlign", "CMFCPopupMenu [MFC], IsScrollable", "CMFCPopupMenu [MFC], IsSendMenuSelectMsg", "CMFCPopupMenu [MFC], IsShown", "CMFCPopupMenu [MFC], MoveTo", "CMFCPopupMenu [MFC], OnCmdMsg", "CMFCPopupMenu [MFC], PostCommand", "CMFCPopupMenu [MFC], PreTranslateMessage", "CMFCPopupMenu [MFC], RecalcLayout", "CMFCPopupMenu [MFC], RemoveAllItems", "CMFCPopupMenu [MFC], RemoveItem", "CMFCPopupMenu [MFC], SaveState", "CMFCPopupMenu [MFC], SetAnimationSpeed", "CMFCPopupMenu [MFC], SetAnimationType", "CMFCPopupMenu [MFC], SetAutoDestroy", "CMFCPopupMenu [MFC], SetDefaultItem", "CMFCPopupMenu [MFC], SetForceMenuFocus", "CMFCPopupMenu [MFC], SetForceShadow", "CMFCPopupMenu [MFC], SetMaxWidth", "CMFCPopupMenu [MFC], SetMessageWnd", "CMFCPopupMenu [MFC], SetParentRibbonElement", "CMFCPopupMenu [MFC], SetQuickCustomizeType", "CMFCPopupMenu [MFC], SetQuickMode", "CMFCPopupMenu [MFC], SetRightAlign", "CMFCPopupMenu [MFC], SetSendMenuSelectMsg", "CMFCPopupMenu [MFC], ShowAllCommands", "CMFCPopupMenu [MFC], TriggerResize", "CMFCPopupMenu [MFC], UpdateAllShadows", "CMFCPopupMenu [MFC], UpdateShadow", "CMFCPopupMenu [MFC], CreateTearOffBar", "CMFCPopupMenu [MFC], OnChangeHot", "CMFCPopupMenu [MFC], OnChooseItem"] -ms.assetid: 9555dca1-8c9c-44c9-af72-0659ddad128e --- # CMFCPopupMenu Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements Windows pop-up menu functionality and extends it by adding features such as tear-off menus and tooltips. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcpopupmenubar-class.md b/docs/mfc/reference/cmfcpopupmenubar-class.md index c3b797becac..b80cec2199f 100644 --- a/docs/mfc/reference/cmfcpopupmenubar-class.md +++ b/docs/mfc/reference/cmfcpopupmenubar-class.md @@ -4,10 +4,12 @@ title: "CMFCPopupMenuBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCPopupMenuBar", "AFXPOPUPMENUBAR/CMFCPopupMenuBar", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::AdjustSizeImmediate", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::BuildOrigItems", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::CloseDelayedSubMenu", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::ExportToMenu", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::FindDestintationToolBar", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::GetCurrentMenuImageSize", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::GetDefaultMenuId", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::GetLastCommandIndex", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::GetOffset", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::ImportFromMenu", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::IsDropDownListMode", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::IsPaletteMode", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::IsRibbonPanel", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::IsRibbonPanelInRegularMode", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::LoadFromHash", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::RestoreDelayedSubMenu", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::SetButtonStyle", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::SetOffset", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::StartPopupMenuTimer", "AFXPOPUPMENUBAR/CMFCPopupMenuBar::m_bDisableSideBarInXPMode"] helpviewer_keywords: ["CMFCPopupMenuBar [MFC], AdjustSizeImmediate", "CMFCPopupMenuBar [MFC], BuildOrigItems", "CMFCPopupMenuBar [MFC], CloseDelayedSubMenu", "CMFCPopupMenuBar [MFC], ExportToMenu", "CMFCPopupMenuBar [MFC], FindDestintationToolBar", "CMFCPopupMenuBar [MFC], GetCurrentMenuImageSize", "CMFCPopupMenuBar [MFC], GetDefaultMenuId", "CMFCPopupMenuBar [MFC], GetLastCommandIndex", "CMFCPopupMenuBar [MFC], GetOffset", "CMFCPopupMenuBar [MFC], ImportFromMenu", "CMFCPopupMenuBar [MFC], IsDropDownListMode", "CMFCPopupMenuBar [MFC], IsPaletteMode", "CMFCPopupMenuBar [MFC], IsRibbonPanel", "CMFCPopupMenuBar [MFC], IsRibbonPanelInRegularMode", "CMFCPopupMenuBar [MFC], LoadFromHash", "CMFCPopupMenuBar [MFC], RestoreDelayedSubMenu", "CMFCPopupMenuBar [MFC], SetButtonStyle", "CMFCPopupMenuBar [MFC], SetOffset", "CMFCPopupMenuBar [MFC], StartPopupMenuTimer", "CMFCPopupMenuBar [MFC], m_bDisableSideBarInXPMode"] -ms.assetid: 4c93c459-7f70-4240-8c63-280bb811e374 --- # CMFCPopupMenuBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A menu bar embedded into a pop-up menu. ## Syntax diff --git a/docs/mfc/reference/cmfcpreviewctrlimpl-class.md b/docs/mfc/reference/cmfcpreviewctrlimpl-class.md index 0dc7d379523..00f4b24cce3 100644 --- a/docs/mfc/reference/cmfcpreviewctrlimpl-class.md +++ b/docs/mfc/reference/cmfcpreviewctrlimpl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCPreviewCtrlImpl [MFC], CMFCPreviewCtrlImpl", "CMFCPre --- # `CMFCPreviewCtrlImpl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This class implements a window that is placed on a host window provided by the Shell for Rich Preview. ## Syntax diff --git a/docs/mfc/reference/cmfcprintpreviewtoolbar-class.md b/docs/mfc/reference/cmfcprintpreviewtoolbar-class.md index d4afc3ce036..12c1fad00ce 100644 --- a/docs/mfc/reference/cmfcprintpreviewtoolbar-class.md +++ b/docs/mfc/reference/cmfcprintpreviewtoolbar-class.md @@ -3,10 +3,12 @@ description: "Learn more about: CMFCPrintPreviewToolBar Class" title: "CMFCPrintPreviewToolBar Class" ms.date: "11/04/2016" helpviewer_keywords: ["CMFCPrintPreviewToolBar class [MFC]", "CMFCPrintPreviewToolBar class [MFC], destructor"] -ms.assetid: 7b9f641b-d402-4339-8815-e5247237e7e5 --- # CMFCPrintPreviewToolBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The toolbar on the print preview. ## Syntax diff --git a/docs/mfc/reference/cmfcpropertygridcolorproperty-class.md b/docs/mfc/reference/cmfcpropertygridcolorproperty-class.md index 75794a5d3ce..2f8314b97fa 100644 --- a/docs/mfc/reference/cmfcpropertygridcolorproperty-class.md +++ b/docs/mfc/reference/cmfcpropertygridcolorproperty-class.md @@ -4,10 +4,12 @@ title: "CMFCPropertyGridColorProperty Class" ms.date: "11/04/2016" f1_keywords: ["CMFCPropertyGridColorProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridColorProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridColorProperty::CMFCPropertyGridColorProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridColorProperty::EnableAutomaticButton", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridColorProperty::EnableOtherButton", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridColorProperty::GetColor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridColorProperty::SetColor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridColorProperty::SetColumnsNumber", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridColorProperty::SetOriginalValue"] helpviewer_keywords: ["CMFCPropertyGridColorProperty [MFC], CMFCPropertyGridColorProperty", "CMFCPropertyGridColorProperty [MFC], EnableAutomaticButton", "CMFCPropertyGridColorProperty [MFC], EnableOtherButton", "CMFCPropertyGridColorProperty [MFC], GetColor", "CMFCPropertyGridColorProperty [MFC], SetColor", "CMFCPropertyGridColorProperty [MFC], SetColumnsNumber", "CMFCPropertyGridColorProperty [MFC], SetOriginalValue"] -ms.assetid: af37be93-a91e-40a2-9a65-0f3412c6f0f8 --- # CMFCPropertyGridColorProperty Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCPropertyGridColorProperty` class supports a property list control item that opens a color selection dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfcpropertygridctrl-class.md b/docs/mfc/reference/cmfcpropertygridctrl-class.md index 08bc061cf36..bddf570d91a 100644 --- a/docs/mfc/reference/cmfcpropertygridctrl-class.md +++ b/docs/mfc/reference/cmfcpropertygridctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCPropertyGridCtrl [MFC], CMFCPropertyGridCtrl", "CMFCP --- # CMFCPropertyGridCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For more detail see the source code located in the **`mfc`** folder of your Visual Studio installation. For example, `%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc`. Supports an editable property grid control that can display properties in alphabetical or hierarchical order. diff --git a/docs/mfc/reference/cmfcpropertygridfileproperty-class.md b/docs/mfc/reference/cmfcpropertygridfileproperty-class.md index 7d7c329867d..00f5bffd1f0 100644 --- a/docs/mfc/reference/cmfcpropertygridfileproperty-class.md +++ b/docs/mfc/reference/cmfcpropertygridfileproperty-class.md @@ -4,10 +4,12 @@ title: "CMFCPropertyGridFileProperty Class" ms.date: "11/04/2016" f1_keywords: ["CMFCPropertyGridFileProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridFileProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridFileProperty::CMFCPropertyGridFileProperty"] helpviewer_keywords: ["CMFCPropertyGridFileProperty [MFC], CMFCPropertyGridFileProperty"] -ms.assetid: 2bb8b8b4-47fc-4798-bd5e-dc8ea0b4cd9d --- # CMFCPropertyGridFileProperty Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCPropertyGridFileProperty` class supports a property list control item that opens a file selection dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfcpropertygridfontproperty-class.md b/docs/mfc/reference/cmfcpropertygridfontproperty-class.md index 9dc77057151..84b77c97caa 100644 --- a/docs/mfc/reference/cmfcpropertygridfontproperty-class.md +++ b/docs/mfc/reference/cmfcpropertygridfontproperty-class.md @@ -4,10 +4,12 @@ title: "CMFCPropertyGridFontProperty Class" ms.date: "11/04/2016" f1_keywords: ["CMFCPropertyGridFontProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridFontProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridFontProperty::CMFCPropertyGridFontProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridFontProperty::GetColor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridFontProperty::GetLogFont"] helpviewer_keywords: ["CMFCPropertyGridFontProperty [MFC], CMFCPropertyGridFontProperty", "CMFCPropertyGridFontProperty [MFC], GetColor", "CMFCPropertyGridFontProperty [MFC], GetLogFont"] -ms.assetid: 83693f33-bbd3-4fcb-a9ad-fa79fcf2ca24 --- # CMFCPropertyGridFontProperty Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCPropertyGridFileProperty` class supports a property list control item that opens a font selection dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfcpropertygridproperty-class.md b/docs/mfc/reference/cmfcpropertygridproperty-class.md index 8bf3752df36..e9a54f4ffc6 100644 --- a/docs/mfc/reference/cmfcpropertygridproperty-class.md +++ b/docs/mfc/reference/cmfcpropertygridproperty-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCPropertyGridProperty [MFC], CMFCPropertyGridProperty" --- # `CMFCPropertyGridProperty` class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A `CMFCPropertyGridProperty` object represents a list item in a property list control. For more detail, see the source code located in the **`mfc`** folder of your Visual Studio installation. For example, `%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc`. diff --git a/docs/mfc/reference/cmfcpropertygridtooltipctrl-class.md b/docs/mfc/reference/cmfcpropertygridtooltipctrl-class.md index 84ef4b26a9a..47484ecb7db 100644 --- a/docs/mfc/reference/cmfcpropertygridtooltipctrl-class.md +++ b/docs/mfc/reference/cmfcpropertygridtooltipctrl-class.md @@ -4,10 +4,12 @@ title: "CMFCPropertyGridToolTipCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCPropertyGridToolTipCtrl", "AFXPROPERTYGRIDTOOLTIPCTRL/CMFCPropertyGridToolTipCtrl", "AFXPROPERTYGRIDTOOLTIPCTRL/CMFCPropertyGridToolTipCtrl::CMFCPropertyGridToolTipCtrl", "AFXPROPERTYGRIDTOOLTIPCTRL/CMFCPropertyGridToolTipCtrl::Create", "AFXPROPERTYGRIDTOOLTIPCTRL/CMFCPropertyGridToolTipCtrl::Deactivate", "AFXPROPERTYGRIDTOOLTIPCTRL/CMFCPropertyGridToolTipCtrl::GetLastRect", "AFXPROPERTYGRIDTOOLTIPCTRL/CMFCPropertyGridToolTipCtrl::Hide", "AFXPROPERTYGRIDTOOLTIPCTRL/CMFCPropertyGridToolTipCtrl::SetTextMargin", "AFXPROPERTYGRIDTOOLTIPCTRL/CMFCPropertyGridToolTipCtrl::Track"] helpviewer_keywords: ["CMFCPropertyGridToolTipCtrl [MFC], CMFCPropertyGridToolTipCtrl", "CMFCPropertyGridToolTipCtrl [MFC], Create", "CMFCPropertyGridToolTipCtrl [MFC], Deactivate", "CMFCPropertyGridToolTipCtrl [MFC], GetLastRect", "CMFCPropertyGridToolTipCtrl [MFC], Hide", "CMFCPropertyGridToolTipCtrl [MFC], SetTextMargin", "CMFCPropertyGridToolTipCtrl [MFC], Track"] -ms.assetid: 84b436e5-6695-4da0-9569-1a875e087711 --- # CMFCPropertyGridToolTipCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a tooltip control that the [CMFCPropertyGridCtrl Class](../../mfc/reference/cmfcpropertygridctrl-class.md) uses to display tooltips. ## Syntax diff --git a/docs/mfc/reference/cmfcpropertypage-class.md b/docs/mfc/reference/cmfcpropertypage-class.md index a8448d4c043..7ad58c0a49a 100644 --- a/docs/mfc/reference/cmfcpropertypage-class.md +++ b/docs/mfc/reference/cmfcpropertypage-class.md @@ -4,10 +4,12 @@ title: "CMFCPropertyPage Class" ms.date: "11/04/2016" f1_keywords: ["CMFCPropertyPage", "AFXPROPERTYPAGE/CMFCPropertyPage", "AFXPROPERTYPAGE/CMFCPropertyPage::CMFCPropertyPage"] helpviewer_keywords: ["CMFCPropertyPage [MFC], CMFCPropertyPage"] -ms.assetid: d279d7f2-2d81-418d-9f23-6147d6e8df09 --- # CMFCPropertyPage Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCPropertyPage` class supports the display of pop-up menus on a property page. ## Syntax diff --git a/docs/mfc/reference/cmfcpropertysheet-class.md b/docs/mfc/reference/cmfcpropertysheet-class.md index b7f34be9f44..3526eeb6a54 100644 --- a/docs/mfc/reference/cmfcpropertysheet-class.md +++ b/docs/mfc/reference/cmfcpropertysheet-class.md @@ -4,10 +4,12 @@ title: "CMFCPropertySheet Class" ms.date: "11/19/2018" f1_keywords: ["CMFCPropertySheet", "AFXPROPERTYSHEET/CMFCPropertySheet", "AFXPROPERTYSHEET/CMFCPropertySheet::CMFCPropertySheet", "AFXPROPERTYSHEET/CMFCPropertySheet::AddPage", "AFXPROPERTYSHEET/CMFCPropertySheet::AddPageToTree", "AFXPROPERTYSHEET/CMFCPropertySheet::AddTreeCategory", "AFXPROPERTYSHEET/CMFCPropertySheet::EnablePageHeader", "AFXPROPERTYSHEET/CMFCPropertySheet::GetHeaderHeight", "AFXPROPERTYSHEET/CMFCPropertySheet::GetLook", "AFXPROPERTYSHEET/CMFCPropertySheet::GetNavBarWidth", "AFXPROPERTYSHEET/CMFCPropertySheet::GetTab", "AFXPROPERTYSHEET/CMFCPropertySheet::InitNavigationControl", "AFXPROPERTYSHEET/CMFCPropertySheet::OnActivatePage", "AFXPROPERTYSHEET/CMFCPropertySheet::OnDrawPageHeader", "AFXPROPERTYSHEET/CMFCPropertySheet::OnRemoveTreePage", "AFXPROPERTYSHEET/CMFCPropertySheet::RemoveCategory", "AFXPROPERTYSHEET/CMFCPropertySheet::RemovePage", "AFXPROPERTYSHEET/CMFCPropertySheet::SetIconsList", "AFXPROPERTYSHEET/CMFCPropertySheet::SetLook"] helpviewer_keywords: ["CMFCPropertySheet [MFC], CMFCPropertySheet", "CMFCPropertySheet [MFC], AddPage", "CMFCPropertySheet [MFC], AddPageToTree", "CMFCPropertySheet [MFC], AddTreeCategory", "CMFCPropertySheet [MFC], EnablePageHeader", "CMFCPropertySheet [MFC], GetHeaderHeight", "CMFCPropertySheet [MFC], GetLook", "CMFCPropertySheet [MFC], GetNavBarWidth", "CMFCPropertySheet [MFC], GetTab", "CMFCPropertySheet [MFC], InitNavigationControl", "CMFCPropertySheet [MFC], OnActivatePage", "CMFCPropertySheet [MFC], OnDrawPageHeader", "CMFCPropertySheet [MFC], OnRemoveTreePage", "CMFCPropertySheet [MFC], RemoveCategory", "CMFCPropertySheet [MFC], RemovePage", "CMFCPropertySheet [MFC], SetIconsList", "CMFCPropertySheet [MFC], SetLook"] -ms.assetid: 01d93573-9698-440f-a6a4-5bebbee879dc --- # CMFCPropertySheet Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCPropertySheet` class supports a property sheet where each property page is denoted by a page tab, a toolbar button, a tree control node, or a list item. ## Syntax diff --git a/docs/mfc/reference/cmfcrebar-class.md b/docs/mfc/reference/cmfcrebar-class.md index 355e63c99e2..babf161b4c7 100644 --- a/docs/mfc/reference/cmfcrebar-class.md +++ b/docs/mfc/reference/cmfcrebar-class.md @@ -4,10 +4,12 @@ title: "CMFCReBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCReBar", "AFXREBAR/CMFCReBar", "AFXREBAR/CMFCReBar::AddBar", "AFXREBAR/CMFCReBar::CalcFixedLayout", "AFXREBAR/CMFCReBar::CanFloat", "AFXREBAR/CMFCReBar::Create", "AFXREBAR/CMFCReBar::EnableDocking", "AFXREBAR/CMFCReBar::GetReBarBandInfoSize", "AFXREBAR/CMFCReBar::GetReBarCtrl", "AFXREBAR/CMFCReBar::OnShowControlBarMenu", "AFXREBAR/CMFCReBar::OnToolHitTest", "AFXREBAR/CMFCReBar::OnUpdateCmdUI", "AFXREBAR/CMFCReBar::SetPaneAlignment"] helpviewer_keywords: ["CMFCReBar [MFC], AddBar", "CMFCReBar [MFC], CalcFixedLayout", "CMFCReBar [MFC], CanFloat", "CMFCReBar [MFC], Create", "CMFCReBar [MFC], EnableDocking", "CMFCReBar [MFC], GetReBarBandInfoSize", "CMFCReBar [MFC], GetReBarCtrl", "CMFCReBar [MFC], OnShowControlBarMenu", "CMFCReBar [MFC], OnToolHitTest", "CMFCReBar [MFC], OnUpdateCmdUI", "CMFCReBar [MFC], SetPaneAlignment"] -ms.assetid: 02a60e29-6224-49c1-9e74-e0a7d9f8d023 --- # CMFCReBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A `CMFCReBar` object is a control bar that provides layout, persistence, and state information for rebar controls. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcribbonapplicationbutton-class.md b/docs/mfc/reference/cmfcribbonapplicationbutton-class.md index 5309f14c60f..50d4c58b4ff 100644 --- a/docs/mfc/reference/cmfcribbonapplicationbutton-class.md +++ b/docs/mfc/reference/cmfcribbonapplicationbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonApplicationButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonApplicationButton", "AFXRIBBONBAR/CMFCRibbonApplicationButton", "AFXRIBBONBAR/CMFCRibbonApplicationButton::CMFCRibbonApplicationButton", "AFXRIBBONBAR/CMFCRibbonApplicationButton::SetImage"] helpviewer_keywords: ["CMFCRibbonApplicationButton [MFC], CMFCRibbonApplicationButton", "CMFCRibbonApplicationButton [MFC], SetImage"] -ms.assetid: beb81757-fabd-4641-9130-876ba8505b78 --- # CMFCRibbonApplicationButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a special button located in the top-left corner of the application window. When clicked, the button opens a menu that usually contains common **File** commands like **Open**, **Save**, and **Exit**. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonbar-class.md b/docs/mfc/reference/cmfcribbonbar-class.md index b3ec1757ee4..0dc8d3faf6c 100644 --- a/docs/mfc/reference/cmfcribbonbar-class.md +++ b/docs/mfc/reference/cmfcribbonbar-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCRibbonBar [MFC], ActivateContextCategory", "CMFCRibbo --- # `CMFCRibbonBar` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonBar` class implements a ribbon bar similar to that used in Office 2007. For more detail, see the source code located in the `mfc` folder of your Visual Studio installation. For example, `%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc`. diff --git a/docs/mfc/reference/cmfcribbonbaseelement-class.md b/docs/mfc/reference/cmfcribbonbaseelement-class.md index 7f320909b9d..d67fb97cd16 100644 --- a/docs/mfc/reference/cmfcribbonbaseelement-class.md +++ b/docs/mfc/reference/cmfcribbonbaseelement-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCRibbonBaseElement [MFC], AddToKeyList", "CMFCRibbonBa --- # CMFCRibbonBaseElement Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonBaseElement` class is the base class for all elements that you can add to a [ribbon bar](../../mfc/reference/cmfcribbonbar-class.md). Examples of ribbon elements are ribbon buttons, ribbon check boxes, and ribbon combo boxes. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonbutton-class.md b/docs/mfc/reference/cmfcribbonbutton-class.md index 38845bda11c..fec84f00b6a 100644 --- a/docs/mfc/reference/cmfcribbonbutton-class.md +++ b/docs/mfc/reference/cmfcribbonbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonButton", "AFXRIBBONBUTTON/CMFCRibbonButton", "AFXRIBBONBUTTON/CMFCRibbonButton::CMFCRibbonButton", "AFXRIBBONBUTTON/CMFCRibbonButton::AddSubItem", "AFXRIBBONBUTTON/CMFCRibbonButton::CanBeStretched", "AFXRIBBONBUTTON/CMFCRibbonButton::CleanUpSizes", "AFXRIBBONBUTTON/CMFCRibbonButton::ClosePopupMenu", "AFXRIBBONBUTTON/CMFCRibbonButton::DrawBottomText", "AFXRIBBONBUTTON/CMFCRibbonButton::DrawImage", "AFXRIBBONBUTTON/CMFCRibbonButton::DrawRibbonText", "AFXRIBBONBUTTON/CMFCRibbonButton::FindSubItemIndexByID", "AFXRIBBONBUTTON/CMFCRibbonButton::GetCommandRect", "AFXRIBBONBUTTON/CMFCRibbonButton::GetCompactSize", "AFXRIBBONBUTTON/CMFCRibbonButton::GetIcon", "AFXRIBBONBUTTON/CMFCRibbonButton::GetImageIndex", "AFXRIBBONBUTTON/CMFCRibbonButton::GetImageSize", "AFXRIBBONBUTTON/CMFCRibbonButton::GetIntermediateSize", "AFXRIBBONBUTTON/CMFCRibbonButton::GetMenu", "AFXRIBBONBUTTON/CMFCRibbonButton::GetMenuRect", "AFXRIBBONBUTTON/CMFCRibbonButton::GetRegularSize", "AFXRIBBONBUTTON/CMFCRibbonButton::GetSubItems", "AFXRIBBONBUTTON/CMFCRibbonButton::GetTextRowHeight", "AFXRIBBONBUTTON/CMFCRibbonButton::GetToolTipText", "AFXRIBBONBUTTON/CMFCRibbonButton::HasCompactMode", "AFXRIBBONBUTTON/CMFCRibbonButton::HasIntermediateMode", "AFXRIBBONBUTTON/CMFCRibbonButton::HasLargeMode", "AFXRIBBONBUTTON/CMFCRibbonButton::HasMenu", "AFXRIBBONBUTTON/CMFCRibbonButton::IsAlwaysDrawBorder", "AFXRIBBONBUTTON/CMFCRibbonButton::IsAlwaysLargeImage", "AFXRIBBONBUTTON/CMFCRibbonButton::IsApplicationButton", "AFXRIBBONBUTTON/CMFCRibbonButton::IsCommandAreaHighlighted", "AFXRIBBONBUTTON/CMFCRibbonButton::IsDefaultCommand", "AFXRIBBONBUTTON/CMFCRibbonButton::IsDefaultPanelButton", "AFXRIBBONBUTTON/CMFCRibbonButton::IsDrawTooltipImage", "AFXRIBBONBUTTON/CMFCRibbonButton::IsLargeImage", "AFXRIBBONBUTTON/CMFCRibbonButton::IsMenuAreaHighlighted", "AFXRIBBONBUTTON/CMFCRibbonButton::IsMenuOnBottom", "AFXRIBBONBUTTON/CMFCRibbonButton::IsPopupDefaultMenuLook", "AFXRIBBONBUTTON/CMFCRibbonButton::IsRightAlignMenu", "AFXRIBBONBUTTON/CMFCRibbonButton::IsSingleLineText", "AFXRIBBONBUTTON/CMFCRibbonButton::OnCalcTextSize", "AFXRIBBONBUTTON/CMFCRibbonButton::OnDrawBorder", "AFXRIBBONBUTTON/CMFCRibbonButton::OnDraw", "AFXRIBBONBUTTON/CMFCRibbonButton::OnFillBackground", "AFXRIBBONBUTTON/CMFCRibbonButton::RemoveAllSubItems", "AFXRIBBONBUTTON/CMFCRibbonButton::RemoveSubItem", "AFXRIBBONBUTTON/CMFCRibbonButton::SetACCData", "AFXRIBBONBUTTON/CMFCRibbonButton::SetAlwaysLargeImage", "AFXRIBBONBUTTON/CMFCRibbonButton::SetDefaultCommand", "AFXRIBBONBUTTON/CMFCRibbonButton::SetDescription", "AFXRIBBONBUTTON/CMFCRibbonButton::SetImageIndex", "AFXRIBBONBUTTON/CMFCRibbonButton::SetMenu", "AFXRIBBONBUTTON/CMFCRibbonButton::SetParentCategory", "AFXRIBBONBUTTON/CMFCRibbonButton::SetRightAlignMenu", "AFXRIBBONBUTTON/CMFCRibbonButton::SetText", "AFXRIBBONBUTTON/CMFCRibbonButton::OnClick"] helpviewer_keywords: ["CMFCRibbonButton [MFC], CMFCRibbonButton", "CMFCRibbonButton [MFC], AddSubItem", "CMFCRibbonButton [MFC], CanBeStretched", "CMFCRibbonButton [MFC], CleanUpSizes", "CMFCRibbonButton [MFC], ClosePopupMenu", "CMFCRibbonButton [MFC], DrawBottomText", "CMFCRibbonButton [MFC], DrawImage", "CMFCRibbonButton [MFC], DrawRibbonText", "CMFCRibbonButton [MFC], FindSubItemIndexByID", "CMFCRibbonButton [MFC], GetCommandRect", "CMFCRibbonButton [MFC], GetCompactSize", "CMFCRibbonButton [MFC], GetIcon", "CMFCRibbonButton [MFC], GetImageIndex", "CMFCRibbonButton [MFC], GetImageSize", "CMFCRibbonButton [MFC], GetIntermediateSize", "CMFCRibbonButton [MFC], GetMenu", "CMFCRibbonButton [MFC], GetMenuRect", "CMFCRibbonButton [MFC], GetRegularSize", "CMFCRibbonButton [MFC], GetSubItems", "CMFCRibbonButton [MFC], GetTextRowHeight", "CMFCRibbonButton [MFC], GetToolTipText", "CMFCRibbonButton [MFC], HasCompactMode", "CMFCRibbonButton [MFC], HasIntermediateMode", "CMFCRibbonButton [MFC], HasLargeMode", "CMFCRibbonButton [MFC], HasMenu", "CMFCRibbonButton [MFC], IsAlwaysDrawBorder", "CMFCRibbonButton [MFC], IsAlwaysLargeImage", "CMFCRibbonButton [MFC], IsApplicationButton", "CMFCRibbonButton [MFC], IsCommandAreaHighlighted", "CMFCRibbonButton [MFC], IsDefaultCommand", "CMFCRibbonButton [MFC], IsDefaultPanelButton", "CMFCRibbonButton [MFC], IsDrawTooltipImage", "CMFCRibbonButton [MFC], IsLargeImage", "CMFCRibbonButton [MFC], IsMenuAreaHighlighted", "CMFCRibbonButton [MFC], IsMenuOnBottom", "CMFCRibbonButton [MFC], IsPopupDefaultMenuLook", "CMFCRibbonButton [MFC], IsRightAlignMenu", "CMFCRibbonButton [MFC], IsSingleLineText", "CMFCRibbonButton [MFC], OnCalcTextSize", "CMFCRibbonButton [MFC], OnDrawBorder", "CMFCRibbonButton [MFC], OnDraw", "CMFCRibbonButton [MFC], OnFillBackground", "CMFCRibbonButton [MFC], RemoveAllSubItems", "CMFCRibbonButton [MFC], RemoveSubItem", "CMFCRibbonButton [MFC], SetACCData", "CMFCRibbonButton [MFC], SetAlwaysLargeImage", "CMFCRibbonButton [MFC], SetDefaultCommand", "CMFCRibbonButton [MFC], SetDescription", "CMFCRibbonButton [MFC], SetImageIndex", "CMFCRibbonButton [MFC], SetMenu", "CMFCRibbonButton [MFC], SetParentCategory", "CMFCRibbonButton [MFC], SetRightAlignMenu", "CMFCRibbonButton [MFC], SetText", "CMFCRibbonButton [MFC], OnClick"] -ms.assetid: 732e941c-9504-4b83-a691-d18075965d53 --- # CMFCRibbonButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonButton` class implements buttons that you can position on ribbon bar elements such as panels, Quick Access Toolbars, and pop-up menus. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcribbonbuttonsgroup-class.md b/docs/mfc/reference/cmfcribbonbuttonsgroup-class.md index 943d046aca0..969db73abad 100644 --- a/docs/mfc/reference/cmfcribbonbuttonsgroup-class.md +++ b/docs/mfc/reference/cmfcribbonbuttonsgroup-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonButtonsGroup Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonButtonsGroup", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::CMFCRibbonButtonsGroup", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::AddButton", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::AddButtons", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::GetButton", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::GetCount", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::GetImageSize", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::GetRegularSize", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::HasImages", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::OnDrawImage", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::RemoveAll", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::SetImages", "AFXRIBBONBUTTONSGROUP/CMFCRibbonButtonsGroup::SetParentCategory"] helpviewer_keywords: ["CMFCRibbonButtonsGroup [MFC], CMFCRibbonButtonsGroup", "CMFCRibbonButtonsGroup [MFC], AddButton", "CMFCRibbonButtonsGroup [MFC], AddButtons", "CMFCRibbonButtonsGroup [MFC], GetButton", "CMFCRibbonButtonsGroup [MFC], GetCount", "CMFCRibbonButtonsGroup [MFC], GetImageSize", "CMFCRibbonButtonsGroup [MFC], GetRegularSize", "CMFCRibbonButtonsGroup [MFC], HasImages", "CMFCRibbonButtonsGroup [MFC], OnDrawImage", "CMFCRibbonButtonsGroup [MFC], RemoveAll", "CMFCRibbonButtonsGroup [MFC], SetImages", "CMFCRibbonButtonsGroup [MFC], SetParentCategory"] -ms.assetid: b993d93e-fc1a-472f-a87f-1d7b7b499845 --- # CMFCRibbonButtonsGroup Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonButtonsGroup` class allows you to organize a set of ribbon buttons into a group. All buttons in the group are directly adjacent to each other horizontally and enclosed in a border. ## Syntax diff --git a/docs/mfc/reference/cmfcribboncategory-class.md b/docs/mfc/reference/cmfcribboncategory-class.md index c63b58d2c59..4cfdf0d8b3e 100644 --- a/docs/mfc/reference/cmfcribboncategory-class.md +++ b/docs/mfc/reference/cmfcribboncategory-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCRibbonCategory [MFC], CMFCRibbonCategory", "CMFCRibbo --- # CMFCRibbonCategory Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonCategory` class implements a ribbon tab that contains a group of [ribbon panels](../../mfc/reference/cmfcribbonpanel-class.md). ## Syntax diff --git a/docs/mfc/reference/cmfcribboncheckbox-class.md b/docs/mfc/reference/cmfcribboncheckbox-class.md index dd35d634409..33cb715bbba 100644 --- a/docs/mfc/reference/cmfcribboncheckbox-class.md +++ b/docs/mfc/reference/cmfcribboncheckbox-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCRibbonCheckBox [MFC], CMFCRibbonCheckBox", "CMFCRibbo --- # CMFCRibbonCheckBox Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonCheckBox` class implements a check box that you can add to a ribbon panel, Quick Access Toolbar, or popup menu. ## Syntax diff --git a/docs/mfc/reference/cmfcribboncolorbutton-class.md b/docs/mfc/reference/cmfcribboncolorbutton-class.md index 29ea27176bb..a450dd22d7e 100644 --- a/docs/mfc/reference/cmfcribboncolorbutton-class.md +++ b/docs/mfc/reference/cmfcribboncolorbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonColorButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonColorButton", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::CMFCRibbonColorButton", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::AddColorsGroup", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::EnableAutomaticButton", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::EnableOtherButton", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::GetAutomaticColor", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::GetColor", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::GetColorBoxSize", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::GetColumns", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::GetHighlightedColor", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::RemoveAllColorGroups", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::SetColor", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::SetColorBoxSize", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::SetColorName", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::SetColumns", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::SetDocumentColors", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::SetPalette", "AFXRIBBONCOLORBUTTON/CMFCRibbonColorButton::UpdateColor"] helpviewer_keywords: ["CMFCRibbonColorButton [MFC], CMFCRibbonColorButton", "CMFCRibbonColorButton [MFC], AddColorsGroup", "CMFCRibbonColorButton [MFC], EnableAutomaticButton", "CMFCRibbonColorButton [MFC], EnableOtherButton", "CMFCRibbonColorButton [MFC], GetAutomaticColor", "CMFCRibbonColorButton [MFC], GetColor", "CMFCRibbonColorButton [MFC], GetColorBoxSize", "CMFCRibbonColorButton [MFC], GetColumns", "CMFCRibbonColorButton [MFC], GetHighlightedColor", "CMFCRibbonColorButton [MFC], RemoveAllColorGroups", "CMFCRibbonColorButton [MFC], SetColor", "CMFCRibbonColorButton [MFC], SetColorBoxSize", "CMFCRibbonColorButton [MFC], SetColorName", "CMFCRibbonColorButton [MFC], SetColumns", "CMFCRibbonColorButton [MFC], SetDocumentColors", "CMFCRibbonColorButton [MFC], SetPalette", "CMFCRibbonColorButton [MFC], UpdateColor"] -ms.assetid: 6b4b4ee3-8cc0-41b4-a4eb-93e8847008e1 --- # CMFCRibbonColorButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonColorButton` class implements a color button that you can add to a ribbon bar. The ribbon color button displays a drop-down menu that contains one or more color palettes. ## Syntax diff --git a/docs/mfc/reference/cmfcribboncombobox-class.md b/docs/mfc/reference/cmfcribboncombobox-class.md index 8c68550f07e..39b79bd3263 100644 --- a/docs/mfc/reference/cmfcribboncombobox-class.md +++ b/docs/mfc/reference/cmfcribboncombobox-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCRibbonComboBox [MFC], CMFCRibbonComboBox", "CMFCRibbo --- # CMFCRibbonComboBox Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonComboBox` class implements a combo box control that you can add to a ribbon bar, a ribbon panel, or a ribbon popup menu. ## Syntax From ce3944cff421760c7a66f8de66bc8df5d10488e6 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 20 Feb 2026 11:02:58 -0800 Subject: [PATCH 1633/1799] Batch 8: update files --- docs/mfc/reference/cmfcribboncontextcaption-class.md | 4 +++- docs/mfc/reference/cmfcribboncustomizedialog-class.md | 4 +++- docs/mfc/reference/cmfcribboncustomizepropertypage-class.md | 4 +++- docs/mfc/reference/cmfcribbonedit-class.md | 4 +++- docs/mfc/reference/cmfcribbonfontcombobox-class.md | 3 +++ docs/mfc/reference/cmfcribbongallery-class.md | 4 +++- docs/mfc/reference/cmfcribbongallerymenubutton-class.md | 4 +++- docs/mfc/reference/cmfcribbonlabel-class.md | 4 +++- docs/mfc/reference/cmfcribbonlinkctrl-class.md | 4 +++- docs/mfc/reference/cmfcribbonmainpanel-class.md | 4 +++- docs/mfc/reference/cmfcribbonminitoolbar-class.md | 4 +++- docs/mfc/reference/cmfcribbonpanel-class.md | 4 +++- docs/mfc/reference/cmfcribbonprogressbar-class.md | 4 +++- .../cmfcribbonquickaccesstoolbardefaultstate-class.md | 4 +++- docs/mfc/reference/cmfcribbonseparator-class.md | 4 +++- docs/mfc/reference/cmfcribbonslider-class.md | 4 +++- docs/mfc/reference/cmfcribbonstatusbar-class.md | 4 +++- docs/mfc/reference/cmfcribbonstatusbarpane-class.md | 4 +++- docs/mfc/reference/cmfcribbonundobutton-class.md | 4 +++- docs/mfc/reference/cmfcshelllistctrl-class.md | 4 +++- docs/mfc/reference/cmfcshelltreectrl-class.md | 4 +++- docs/mfc/reference/cmfcspinbuttonctrl-class.md | 4 +++- docs/mfc/reference/cmfcstandardcolorspropertypage-class.md | 4 +++- docs/mfc/reference/cmfcstatusbar-class.md | 4 +++- docs/mfc/reference/cmfctabctrl-class.md | 3 +++ docs/mfc/reference/cmfctabdroptarget-class.md | 4 +++- docs/mfc/reference/cmfctabtooltipinfo-structure.md | 4 +++- docs/mfc/reference/cmfctaskspane-class.md | 3 +++ docs/mfc/reference/cmfctaskspanetask-class.md | 4 +++- docs/mfc/reference/cmfctaskspanetaskgroup-class.md | 4 +++- docs/mfc/reference/cmfctoolbar-class.md | 3 +++ docs/mfc/reference/cmfctoolbarbutton-class.md | 4 +++- docs/mfc/reference/cmfctoolbarcomboboxbutton-class.md | 4 +++- docs/mfc/reference/cmfctoolbarcomboboxedit-class.md | 4 +++- docs/mfc/reference/cmfctoolbardatetimectrl-class.md | 4 +++- docs/mfc/reference/cmfctoolbareditboxbutton-class.md | 4 +++- docs/mfc/reference/cmfctoolbarfontcombobox-class.md | 4 +++- docs/mfc/reference/cmfctoolbarfontsizecombobox-class.md | 4 +++- docs/mfc/reference/cmfctoolbarimages-class.md | 4 +++- docs/mfc/reference/cmfctoolbarinfo-class.md | 4 +++- docs/mfc/reference/cmfctoolbarmenubutton-class.md | 4 +++- docs/mfc/reference/cmfctoolbarscustomizedialog-class.md | 4 +++- docs/mfc/reference/cmfctooltipctrl-class.md | 3 +++ docs/mfc/reference/cmfctooltipinfo-class.md | 4 +++- docs/mfc/reference/cmfcvisualmanager-class.md | 4 +++- docs/mfc/reference/cmfcvisualmanageroffice2003-class.md | 3 +++ docs/mfc/reference/cmfcvisualmanageroffice2007-class.md | 4 +++- docs/mfc/reference/cmfcvisualmanagerofficexp-class.md | 4 +++- docs/mfc/reference/cmfcvisualmanagervs2005-class.md | 4 +++- docs/mfc/reference/cmfcvisualmanagerwindows-class.md | 4 +++- docs/mfc/reference/cmfcvisualmanagerwindows7-class.md | 4 +++- docs/mfc/reference/cmfcwindowsmanagerdialog-class.md | 4 +++- docs/mfc/reference/cminiframewnd-class.md | 4 +++- docs/mfc/reference/cmonikerfile-class.md | 4 +++- docs/mfc/reference/cmonthcalctrl-class.md | 3 +++ docs/mfc/reference/cmousemanager-class.md | 3 +++ docs/mfc/reference/cmultidoctemplate-class.md | 4 +++- docs/mfc/reference/cmultilock-class.md | 4 +++- docs/mfc/reference/cmultipagedhtmldialog-class.md | 4 +++- docs/mfc/reference/cmultipaneframewnd-class.md | 4 +++- docs/mfc/reference/cmutex-class.md | 4 +++- docs/mfc/reference/cnetaddressctrl-class.md | 4 +++- docs/mfc/reference/cnotsupportedexception-class.md | 4 +++- docs/mfc/reference/cobarray-class.md | 3 +++ docs/mfc/reference/cobject-class.md | 3 +++ docs/mfc/reference/coblist-class.md | 3 +++ docs/mfc/reference/coccmanager-class.md | 4 +++- docs/mfc/reference/codbcfieldinfo-structure.md | 4 +++- docs/mfc/reference/colebusydialog-class.md | 4 +++- docs/mfc/reference/colechangeicondialog-class.md | 4 +++- docs/mfc/reference/colechangesourcedialog-class.md | 4 +++- docs/mfc/reference/coleclientitem-class.md | 3 +++ docs/mfc/reference/colecmdui-class.md | 4 +++- docs/mfc/reference/colecontrol-class.md | 4 +++- docs/mfc/reference/colecontrolcontainer-class.md | 4 +++- docs/mfc/reference/colecontrolmodule-class.md | 4 +++- docs/mfc/reference/colecontrolsite-class.md | 3 +++ docs/mfc/reference/coleconvertdialog-class.md | 4 +++- docs/mfc/reference/colecurrency-class.md | 3 +++ docs/mfc/reference/coledataobject-class.md | 4 +++- docs/mfc/reference/coledatasource-class.md | 4 +++- docs/mfc/reference/coledbrecordview-class.md | 4 +++- docs/mfc/reference/coledialog-class.md | 4 +++- docs/mfc/reference/coledispatchdriver-class.md | 4 +++- docs/mfc/reference/coledispatchexception-class.md | 4 +++- docs/mfc/reference/coledocobjectitem-class.md | 4 +++- docs/mfc/reference/coledocument-class.md | 3 +++ docs/mfc/reference/coledropsource-class.md | 4 +++- docs/mfc/reference/coledroptarget-class.md | 4 +++- docs/mfc/reference/coleexception-class.md | 4 +++- docs/mfc/reference/coleinsertdialog-class.md | 4 +++- docs/mfc/reference/coleipframewnd-class.md | 4 +++- docs/mfc/reference/coleipframewndex-class.md | 3 +++ docs/mfc/reference/colelinkingdoc-class.md | 4 +++- docs/mfc/reference/colelinksdialog-class.md | 4 +++- docs/mfc/reference/colemessagefilter-class.md | 4 +++- docs/mfc/reference/coleobjectfactory-class.md | 4 +++- docs/mfc/reference/colepastespecialdialog-class.md | 4 +++- docs/mfc/reference/colepropertiesdialog-class.md | 4 +++- docs/mfc/reference/colepropertypage-class.md | 4 +++- 100 files changed, 300 insertions(+), 84 deletions(-) diff --git a/docs/mfc/reference/cmfcribboncontextcaption-class.md b/docs/mfc/reference/cmfcribboncontextcaption-class.md index ce8c6bd89a9..a066c0981fd 100644 --- a/docs/mfc/reference/cmfcribboncontextcaption-class.md +++ b/docs/mfc/reference/cmfcribboncontextcaption-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonContextCaption Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonContextCaption", "AFXRIBBONBAR/CMFCRibbonContextCaption", "AFXRIBBONBAR/CMFCRibbonContextCaption::GetColor", "AFXRIBBONBAR/CMFCRibbonContextCaption::GetRightTabX"] helpviewer_keywords: ["CMFCRibbonContextCaption [MFC], GetColor", "CMFCRibbonContextCaption [MFC], GetRightTabX"] -ms.assetid: cce2c0a2-8370-4266-997e-f8d0eeb3d616 --- # CMFCRibbonContextCaption Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a colored caption that appears at the top of a ribbon category or a context category. ## Syntax diff --git a/docs/mfc/reference/cmfcribboncustomizedialog-class.md b/docs/mfc/reference/cmfcribboncustomizedialog-class.md index f465c917d41..dde0bf3da9d 100644 --- a/docs/mfc/reference/cmfcribboncustomizedialog-class.md +++ b/docs/mfc/reference/cmfcribboncustomizedialog-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonCustomizeDialog Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonCustomizeDialog", "AFXRIBBONCUSTOMIZEDIALOG/CMFCRibbonCustomizeDialog", "AFXRIBBONCUSTOMIZEDIALOG/CMFCRibbonCustomizeDialog::CMFCRibbonCustomizeDialog"] helpviewer_keywords: ["CMFCRibbonCustomizeDialog [MFC], CMFCRibbonCustomizeDialog"] -ms.assetid: ce67de7f-5eaa-4c75-9b94-f290f36df073 --- # CMFCRibbonCustomizeDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Displays the ribbon **Customize** page. ## Syntax diff --git a/docs/mfc/reference/cmfcribboncustomizepropertypage-class.md b/docs/mfc/reference/cmfcribboncustomizepropertypage-class.md index 1580c5a1aa3..47791413a83 100644 --- a/docs/mfc/reference/cmfcribboncustomizepropertypage-class.md +++ b/docs/mfc/reference/cmfcribboncustomizepropertypage-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonCustomizePropertyPage Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonCustomizePropertyPage", "AFXRIBBONCUSTOMIZEDIALOG/CMFCRibbonCustomizePropertyPage", "AFXRIBBONCUSTOMIZEDIALOG/CMFCRibbonCustomizePropertyPage::CMFCRibbonCustomizePropertyPage", "AFXRIBBONCUSTOMIZEDIALOG/CMFCRibbonCustomizePropertyPage::AddCustomCategory", "AFXRIBBONCUSTOMIZEDIALOG/CMFCRibbonCustomizePropertyPage::OnOK"] helpviewer_keywords: ["CMFCRibbonCustomizePropertyPage [MFC], CMFCRibbonCustomizePropertyPage", "CMFCRibbonCustomizePropertyPage [MFC], AddCustomCategory", "CMFCRibbonCustomizePropertyPage [MFC], OnOK"] -ms.assetid: ea32a99a-dfbe-401e-8975-aa191552532f --- # CMFCRibbonCustomizePropertyPage Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a custom page for the **Customize** dialog box in Ribbon-based applications. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonedit-class.md b/docs/mfc/reference/cmfcribbonedit-class.md index d27304b45d2..6e6bd2a3279 100644 --- a/docs/mfc/reference/cmfcribbonedit-class.md +++ b/docs/mfc/reference/cmfcribbonedit-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonEdit Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonEdit", "AFXRIBBONEDIT/CMFCRibbonEdit", "AFXRIBBONEDIT/CMFCRibbonEdit::CMFCRibbonEdit", "AFXRIBBONEDIT/CMFCRibbonEdit::CanBeStretched", "AFXRIBBONEDIT/CMFCRibbonEdit::CopyFrom", "AFXRIBBONEDIT/CMFCRibbonEdit::CreateEdit", "AFXRIBBONEDIT/CMFCRibbonEdit::DestroyCtrl", "AFXRIBBONEDIT/CMFCRibbonEdit::DropDownList", "AFXRIBBONEDIT/CMFCRibbonEdit::EnableSpinButtons", "AFXRIBBONEDIT/CMFCRibbonEdit::GetCompactSize", "AFXRIBBONEDIT/CMFCRibbonEdit::GetEditText", "AFXRIBBONEDIT/CMFCRibbonEdit::GetIntermediateSize", "AFXRIBBONEDIT/CMFCRibbonEdit::GetTextAlign", "AFXRIBBONEDIT/CMFCRibbonEdit::GetWidth", "AFXRIBBONEDIT/CMFCRibbonEdit::HasCompactMode", "AFXRIBBONEDIT/CMFCRibbonEdit::HasFocus", "AFXRIBBONEDIT/CMFCRibbonEdit::HasLargeMode", "AFXRIBBONEDIT/CMFCRibbonEdit::HasSpinButtons", "AFXRIBBONEDIT/CMFCRibbonEdit::IsHighlighted", "AFXRIBBONEDIT/CMFCRibbonEdit::OnAfterChangeRect", "AFXRIBBONEDIT/CMFCRibbonEdit::OnDraw", "AFXRIBBONEDIT/CMFCRibbonEdit::OnDrawLabelAndImage", "AFXRIBBONEDIT/CMFCRibbonEdit::OnDrawOnList", "AFXRIBBONEDIT/CMFCRibbonEdit::OnEnable", "AFXRIBBONEDIT/CMFCRibbonEdit::OnHighlight", "AFXRIBBONEDIT/CMFCRibbonEdit::OnKey", "AFXRIBBONEDIT/CMFCRibbonEdit::OnLButtonDown", "AFXRIBBONEDIT/CMFCRibbonEdit::OnLButtonUp", "AFXRIBBONEDIT/CMFCRibbonEdit::OnRTLChanged", "AFXRIBBONEDIT/CMFCRibbonEdit::OnShow", "AFXRIBBONEDIT/CMFCRibbonEdit::Redraw", "AFXRIBBONEDIT/CMFCRibbonEdit::SetACCData", "AFXRIBBONEDIT/CMFCRibbonEdit::SetEditText", "AFXRIBBONEDIT/CMFCRibbonEdit::SetTextAlign", "AFXRIBBONEDIT/CMFCRibbonEdit::SetWidth"] helpviewer_keywords: ["CMFCRibbonEdit [MFC], CMFCRibbonEdit", "CMFCRibbonEdit [MFC], CanBeStretched", "CMFCRibbonEdit [MFC], CMFCRibbonEdit", "CMFCRibbonEdit [MFC], CopyFrom", "CMFCRibbonEdit [MFC], CreateEdit", "CMFCRibbonEdit [MFC], DestroyCtrl", "CMFCRibbonEdit [MFC], DropDownList", "CMFCRibbonEdit [MFC], EnableSpinButtons", "CMFCRibbonEdit [MFC], GetCompactSize", "CMFCRibbonEdit [MFC], GetEditText", "CMFCRibbonEdit [MFC], GetIntermediateSize", "CMFCRibbonEdit [MFC], GetTextAlign", "CMFCRibbonEdit [MFC], GetWidth", "CMFCRibbonEdit [MFC], HasCompactMode", "CMFCRibbonEdit [MFC], HasFocus", "CMFCRibbonEdit [MFC], HasLargeMode", "CMFCRibbonEdit [MFC], HasSpinButtons", "CMFCRibbonEdit [MFC], IsHighlighted", "CMFCRibbonEdit [MFC], OnAfterChangeRect", "CMFCRibbonEdit [MFC], OnDraw", "CMFCRibbonEdit [MFC], OnDrawLabelAndImage", "CMFCRibbonEdit [MFC], OnDrawOnList", "CMFCRibbonEdit [MFC], OnEnable", "CMFCRibbonEdit [MFC], OnHighlight", "CMFCRibbonEdit [MFC], OnKey", "CMFCRibbonEdit [MFC], OnLButtonDown", "CMFCRibbonEdit [MFC], OnLButtonUp", "CMFCRibbonEdit [MFC], OnRTLChanged", "CMFCRibbonEdit [MFC], OnShow", "CMFCRibbonEdit [MFC], Redraw", "CMFCRibbonEdit [MFC], SetACCData", "CMFCRibbonEdit [MFC], SetEditText", "CMFCRibbonEdit [MFC], SetTextAlign", "CMFCRibbonEdit [MFC], SetWidth"] -ms.assetid: 9b85f1f2-446b-454e-9af9-104fdad8a897 --- # CMFCRibbonEdit Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements an edit control that is located on a ribbon bar. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonfontcombobox-class.md b/docs/mfc/reference/cmfcribbonfontcombobox-class.md index e37df6dfc0c..ac472185acb 100644 --- a/docs/mfc/reference/cmfcribbonfontcombobox-class.md +++ b/docs/mfc/reference/cmfcribbonfontcombobox-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCRibbonFontComboBox [MFC], CMFCRibbonFontComboBox", "C --- # CMFCRibbonFontComboBox Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a combo box that contains a list of fonts. You place the combo box on a ribbon panel. ## Syntax diff --git a/docs/mfc/reference/cmfcribbongallery-class.md b/docs/mfc/reference/cmfcribbongallery-class.md index 38ba418a4ea..097256031c0 100644 --- a/docs/mfc/reference/cmfcribbongallery-class.md +++ b/docs/mfc/reference/cmfcribbongallery-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonGallery Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonGallery", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::CMFCRibbonGallery", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::AddGroup", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::AddSubItem", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::Clear", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::EnableMenuResize", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::EnableMenuSideBar", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetCompactSize", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetDroppedDown", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetGroupName", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetGroupOffset", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetIconsInRow", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetItemToolTip", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetLastSelectedItem", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetPaletteID", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetRegularSize", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::GetSelectedItem", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::HasMenu", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::IsButtonMode", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::IsMenuResizeEnabled", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::IsMenuResizeVertical", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::IsMenuSideBar", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::OnAfterChangeRect", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::OnDraw", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::OnEnable", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::OnRTLChanged", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::RedrawIcons", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::RemoveItemToolTips", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::SelectItem", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::SetACCData", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::SetButtonMode", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::SetGroupName", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::SetIconsInRow", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::SetItemToolTip", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::SetPalette", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::SetPaletteID", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGallery::OnDrawPaletteIcon"] helpviewer_keywords: ["CMFCRibbonGallery [MFC], CMFCRibbonGallery", "CMFCRibbonGallery [MFC], AddGroup", "CMFCRibbonGallery [MFC], AddSubItem", "CMFCRibbonGallery [MFC], Clear", "CMFCRibbonGallery [MFC], EnableMenuResize", "CMFCRibbonGallery [MFC], EnableMenuSideBar", "CMFCRibbonGallery [MFC], GetCompactSize", "CMFCRibbonGallery [MFC], GetDroppedDown", "CMFCRibbonGallery [MFC], GetGroupName", "CMFCRibbonGallery [MFC], GetGroupOffset", "CMFCRibbonGallery [MFC], GetIconsInRow", "CMFCRibbonGallery [MFC], GetItemToolTip", "CMFCRibbonGallery [MFC], GetLastSelectedItem", "CMFCRibbonGallery [MFC], GetPaletteID", "CMFCRibbonGallery [MFC], GetRegularSize", "CMFCRibbonGallery [MFC], GetSelectedItem", "CMFCRibbonGallery [MFC], HasMenu", "CMFCRibbonGallery [MFC], IsButtonMode", "CMFCRibbonGallery [MFC], IsMenuResizeEnabled", "CMFCRibbonGallery [MFC], IsMenuResizeVertical", "CMFCRibbonGallery [MFC], IsMenuSideBar", "CMFCRibbonGallery [MFC], OnAfterChangeRect", "CMFCRibbonGallery [MFC], OnDraw", "CMFCRibbonGallery [MFC], OnEnable", "CMFCRibbonGallery [MFC], OnRTLChanged", "CMFCRibbonGallery [MFC], RedrawIcons", "CMFCRibbonGallery [MFC], RemoveItemToolTips", "CMFCRibbonGallery [MFC], SelectItem", "CMFCRibbonGallery [MFC], SetACCData", "CMFCRibbonGallery [MFC], SetButtonMode", "CMFCRibbonGallery [MFC], SetGroupName", "CMFCRibbonGallery [MFC], SetIconsInRow", "CMFCRibbonGallery [MFC], SetItemToolTip", "CMFCRibbonGallery [MFC], SetPalette", "CMFCRibbonGallery [MFC], SetPaletteID", "CMFCRibbonGallery [MFC], OnDrawPaletteIcon"] -ms.assetid: 9734c9c9-981c-4b3f-8c59-264fd41811b4 --- # CMFCRibbonGallery Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements Office 2007-style ribbon galleries. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcribbongallerymenubutton-class.md b/docs/mfc/reference/cmfcribbongallerymenubutton-class.md index 675fee0b139..34d3bb3d3a3 100644 --- a/docs/mfc/reference/cmfcribbongallerymenubutton-class.md +++ b/docs/mfc/reference/cmfcribbongallerymenubutton-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonGalleryMenuButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonGalleryMenuButton", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGalleryMenuButton", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGalleryMenuButton::CMFCRibbonGalleryMenuButton", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGalleryMenuButton::CopyFrom", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGalleryMenuButton::CreatePopupMenu", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGalleryMenuButton::GetPalette", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGalleryMenuButton::HasButton", "AFXRIBBONPALETTEGALLERY/CMFCRibbonGalleryMenuButton::IsEmptyMenuAllowed"] helpviewer_keywords: ["CMFCRibbonGalleryMenuButton [MFC], CMFCRibbonGalleryMenuButton", "CMFCRibbonGalleryMenuButton [MFC], CopyFrom", "CMFCRibbonGalleryMenuButton [MFC], CreatePopupMenu", "CMFCRibbonGalleryMenuButton [MFC], GetPalette", "CMFCRibbonGalleryMenuButton [MFC], HasButton", "CMFCRibbonGalleryMenuButton [MFC], IsEmptyMenuAllowed"] -ms.assetid: 4d459d9b-8b1a-4371-92f6-dc4ce6cc42c8 --- # CMFCRibbonGalleryMenuButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a ribbon menu button that contains ribbon galleries. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcribbonlabel-class.md b/docs/mfc/reference/cmfcribbonlabel-class.md index 9b505588b3d..da97ff30008 100644 --- a/docs/mfc/reference/cmfcribbonlabel-class.md +++ b/docs/mfc/reference/cmfcribbonlabel-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonLabel Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonLabel", "AFXRIBBONLABEL/CMFCRibbonLabel", "AFXRIBBONLABEL/CMFCRibbonLabel::CMFCRibbonLabel", "AFXRIBBONLABEL/CMFCRibbonLabel::SetACCData"] helpviewer_keywords: ["CMFCRibbonLabel [MFC], CMFCRibbonLabel", "CMFCRibbonLabel [MFC], SetACCData"] -ms.assetid: 0346c891-83bf-4f20-b8a1-c84cf2aadced --- # CMFCRibbonLabel Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a non-clickable text label for a ribbon. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonlinkctrl-class.md b/docs/mfc/reference/cmfcribbonlinkctrl-class.md index 1eaa093ba6f..6ac99272c06 100644 --- a/docs/mfc/reference/cmfcribbonlinkctrl-class.md +++ b/docs/mfc/reference/cmfcribbonlinkctrl-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonLinkCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonLinkCtrl", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::CMFCRibbonLinkCtrl", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::CopyFrom", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::GetCompactSize", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::GetLink", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::GetRegularSize", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::GetToolTipText", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::IsDrawTooltipImage", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::OnDraw", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::OnDrawMenuImage", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::OnMouseMove", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::OnSetIcon", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::OpenLink", "AFXRIBBONLINKCTRL/CMFCRibbonLinkCtrl::SetLink"] helpviewer_keywords: ["CMFCRibbonLinkCtrl [MFC], CMFCRibbonLinkCtrl", "CMFCRibbonLinkCtrl [MFC], CopyFrom", "CMFCRibbonLinkCtrl [MFC], GetCompactSize", "CMFCRibbonLinkCtrl [MFC], GetLink", "CMFCRibbonLinkCtrl [MFC], GetRegularSize", "CMFCRibbonLinkCtrl [MFC], GetToolTipText", "CMFCRibbonLinkCtrl [MFC], IsDrawTooltipImage", "CMFCRibbonLinkCtrl [MFC], OnDraw", "CMFCRibbonLinkCtrl [MFC], OnDrawMenuImage", "CMFCRibbonLinkCtrl [MFC], OnMouseMove", "CMFCRibbonLinkCtrl [MFC], OnSetIcon", "CMFCRibbonLinkCtrl [MFC], OpenLink", "CMFCRibbonLinkCtrl [MFC], SetLink"] -ms.assetid: 77ae1941-e0ab-4a9d-911e-1752d34c079b --- # CMFCRibbonLinkCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a hyperlink that is positioned on a ribbon. The hyperlink opens a Web page when you click it. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcribbonmainpanel-class.md b/docs/mfc/reference/cmfcribbonmainpanel-class.md index 622b1ecf24f..c97388bfaff 100644 --- a/docs/mfc/reference/cmfcribbonmainpanel-class.md +++ b/docs/mfc/reference/cmfcribbonmainpanel-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonMainPanel Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonMainPanel", "AFXRIBBONMAINPANEL/CMFCRibbonMainPanel", "AFXRIBBONMAINPANEL/CMFCRibbonMainPanel::Add", "AFXRIBBONMAINPANEL/CMFCRibbonMainPanel::AddRecentFilesList", "AFXRIBBONMAINPANEL/CMFCRibbonMainPanel::AddToBottom", "AFXRIBBONMAINPANEL/CMFCRibbonMainPanel::AddToRight", "AFXRIBBONMAINPANEL/CMFCRibbonMainPanel::GetCommandsFrame"] helpviewer_keywords: ["CMFCRibbonMainPanel [MFC], Add", "CMFCRibbonMainPanel [MFC], AddRecentFilesList", "CMFCRibbonMainPanel [MFC], AddToBottom", "CMFCRibbonMainPanel [MFC], AddToRight", "CMFCRibbonMainPanel [MFC], GetCommandsFrame"] -ms.assetid: 1af78798-5e75-4365-9c81-a54aa5679602 --- # CMFCRibbonMainPanel Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a ribbon panel that displays when you click the [CMFCRibbonApplicationButton](../../mfc/reference/cmfcribbonapplicationbutton-class.md). ## Syntax diff --git a/docs/mfc/reference/cmfcribbonminitoolbar-class.md b/docs/mfc/reference/cmfcribbonminitoolbar-class.md index 2cde2d313e5..07b6def8703 100644 --- a/docs/mfc/reference/cmfcribbonminitoolbar-class.md +++ b/docs/mfc/reference/cmfcribbonminitoolbar-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonMiniToolBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonMiniToolBar", "AFXRIBBONMINITOOLBAR/CMFCRibbonMiniToolBar", "AFXRIBBONMINITOOLBAR/CMFCRibbonMiniToolBar::IsContextMenuMode", "AFXRIBBONMINITOOLBAR/CMFCRibbonMiniToolBar::IsRibbonMiniToolBar", "AFXRIBBONMINITOOLBAR/CMFCRibbonMiniToolBar::SetCommands", "AFXRIBBONMINITOOLBAR/CMFCRibbonMiniToolBar::Show", "AFXRIBBONMINITOOLBAR/CMFCRibbonMiniToolBar::ShowWithContextMenu"] helpviewer_keywords: ["CMFCRibbonMiniToolBar [MFC], IsContextMenuMode", "CMFCRibbonMiniToolBar [MFC], IsRibbonMiniToolBar", "CMFCRibbonMiniToolBar [MFC], SetCommands", "CMFCRibbonMiniToolBar [MFC], Show", "CMFCRibbonMiniToolBar [MFC], ShowWithContextMenu"] -ms.assetid: 7017e963-aeaf-4fe9-b540-e15a7ed41e94 --- # CMFCRibbonMiniToolBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a contextual popup toolbar. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonpanel-class.md b/docs/mfc/reference/cmfcribbonpanel-class.md index 2a81fe3a7a0..bbacccf348a 100644 --- a/docs/mfc/reference/cmfcribbonpanel-class.md +++ b/docs/mfc/reference/cmfcribbonpanel-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonPanel Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonPanel", "AFXRIBBONPANEL/CMFCRibbonPanel", "AFXRIBBONPANEL/CMFCRibbonPanel::CMFCRibbonPanel", "AFXRIBBONPANEL/CMFCRibbonPanel::Add", "AFXRIBBONPANEL/CMFCRibbonPanel::AddSeparator", "AFXRIBBONPANEL/CMFCRibbonPanel::AddToolBar", "AFXRIBBONPANEL/CMFCRibbonPanel::FindByData", "AFXRIBBONPANEL/CMFCRibbonPanel::FindByID", "AFXRIBBONPANEL/CMFCRibbonPanel::GetCaptionHeight", "AFXRIBBONPANEL/CMFCRibbonPanel::GetCount", "AFXRIBBONPANEL/CMFCRibbonPanel::GetData", "AFXRIBBONPANEL/CMFCRibbonPanel::GetDefaultButton", "AFXRIBBONPANEL/CMFCRibbonPanel::GetDroppedDown", "AFXRIBBONPANEL/CMFCRibbonPanel::GetElement", "AFXRIBBONPANEL/CMFCRibbonPanel::GetElements", "AFXRIBBONPANEL/CMFCRibbonPanel::GetElementsByID", "AFXRIBBONPANEL/CMFCRibbonPanel::GetFocused", "AFXRIBBONPANEL/CMFCRibbonPanel::GetGalleryRect", "AFXRIBBONPANEL/CMFCRibbonPanel::GetHighlighted", "AFXRIBBONPANEL/CMFCRibbonPanel::GetIndex", "AFXRIBBONPANEL/CMFCRibbonPanel::GetItemIDsList", "AFXRIBBONPANEL/CMFCRibbonPanel::GetName", "AFXRIBBONPANEL/CMFCRibbonPanel::GetParentButton", "AFXRIBBONPANEL/CMFCRibbonPanel::GetParentCategory", "AFXRIBBONPANEL/CMFCRibbonPanel::GetParentMenuBar", "AFXRIBBONPANEL/CMFCRibbonPanel::GetPreferedMenuLocation", "AFXRIBBONPANEL/CMFCRibbonPanel::GetPressed", "AFXRIBBONPANEL/CMFCRibbonPanel::GetRect", "AFXRIBBONPANEL/CMFCRibbonPanel::GetVisibleElements", "AFXRIBBONPANEL/CMFCRibbonPanel::HasElement", "AFXRIBBONPANEL/CMFCRibbonPanel::HitTest", "AFXRIBBONPANEL/CMFCRibbonPanel::HitTestEx", "AFXRIBBONPANEL/CMFCRibbonPanel::Insert", "AFXRIBBONPANEL/CMFCRibbonPanel::InsertSeparator", "AFXRIBBONPANEL/CMFCRibbonPanel::IsCenterColumnVert", "AFXRIBBONPANEL/CMFCRibbonPanel::IsCollapsed", "AFXRIBBONPANEL/CMFCRibbonPanel::IsHighlighted", "AFXRIBBONPANEL/CMFCRibbonPanel::IsJustifyColumns", "AFXRIBBONPANEL/CMFCRibbonPanel::IsMainPanel", "AFXRIBBONPANEL/CMFCRibbonPanel::IsMenuMode", "AFXRIBBONPANEL/CMFCRibbonPanel::MakeGalleryItemVisible", "AFXRIBBONPANEL/CMFCRibbonPanel::OnKey", "AFXRIBBONPANEL/CMFCRibbonPanel::RecalcWidths", "AFXRIBBONPANEL/CMFCRibbonPanel::Remove", "AFXRIBBONPANEL/CMFCRibbonPanel::RemoveAll", "AFXRIBBONPANEL/CMFCRibbonPanel::Replace", "AFXRIBBONPANEL/CMFCRibbonPanel::ReplaceByID", "AFXRIBBONPANEL/CMFCRibbonPanel::SetCenterColumnVert", "AFXRIBBONPANEL/CMFCRibbonPanel::SetData", "AFXRIBBONPANEL/CMFCRibbonPanel::SetElementMenu", "AFXRIBBONPANEL/CMFCRibbonPanel::SetElementRTC", "AFXRIBBONPANEL/CMFCRibbonPanel::SetElementRTCByID", "AFXRIBBONPANEL/CMFCRibbonPanel::SetFocused", "AFXRIBBONPANEL/CMFCRibbonPanel::SetJustifyColumns", "AFXRIBBONPANEL/CMFCRibbonPanel::SetKeys", "AFXRIBBONPANEL/CMFCRibbonPanel::ShowPopup"] helpviewer_keywords: ["CMFCRibbonPanel [MFC], CMFCRibbonPanel", "CMFCRibbonPanel [MFC], Add", "CMFCRibbonPanel [MFC], AddSeparator", "CMFCRibbonPanel [MFC], AddToolBar", "CMFCRibbonPanel [MFC], FindByData", "CMFCRibbonPanel [MFC], FindByID", "CMFCRibbonPanel [MFC], GetCaptionHeight", "CMFCRibbonPanel [MFC], GetCount", "CMFCRibbonPanel [MFC], GetData", "CMFCRibbonPanel [MFC], GetDefaultButton", "CMFCRibbonPanel [MFC], GetDroppedDown", "CMFCRibbonPanel [MFC], GetElement", "CMFCRibbonPanel [MFC], GetElements", "CMFCRibbonPanel [MFC], GetElementsByID", "CMFCRibbonPanel [MFC], GetFocused", "CMFCRibbonPanel [MFC], GetGalleryRect", "CMFCRibbonPanel [MFC], GetHighlighted", "CMFCRibbonPanel [MFC], GetIndex", "CMFCRibbonPanel [MFC], GetItemIDsList", "CMFCRibbonPanel [MFC], GetName", "CMFCRibbonPanel [MFC], GetParentButton", "CMFCRibbonPanel [MFC], GetParentCategory", "CMFCRibbonPanel [MFC], GetParentMenuBar", "CMFCRibbonPanel [MFC], GetPreferedMenuLocation", "CMFCRibbonPanel [MFC], GetPressed", "CMFCRibbonPanel [MFC], GetRect", "CMFCRibbonPanel [MFC], GetVisibleElements", "CMFCRibbonPanel [MFC], HasElement", "CMFCRibbonPanel [MFC], HitTest", "CMFCRibbonPanel [MFC], HitTestEx", "CMFCRibbonPanel [MFC], Insert", "CMFCRibbonPanel [MFC], InsertSeparator", "CMFCRibbonPanel [MFC], IsCenterColumnVert", "CMFCRibbonPanel [MFC], IsCollapsed", "CMFCRibbonPanel [MFC], IsHighlighted", "CMFCRibbonPanel [MFC], IsJustifyColumns", "CMFCRibbonPanel [MFC], IsMainPanel", "CMFCRibbonPanel [MFC], IsMenuMode", "CMFCRibbonPanel [MFC], MakeGalleryItemVisible", "CMFCRibbonPanel [MFC], OnKey", "CMFCRibbonPanel [MFC], RecalcWidths", "CMFCRibbonPanel [MFC], Remove", "CMFCRibbonPanel [MFC], RemoveAll", "CMFCRibbonPanel [MFC], Replace", "CMFCRibbonPanel [MFC], ReplaceByID", "CMFCRibbonPanel [MFC], SetCenterColumnVert", "CMFCRibbonPanel [MFC], SetData", "CMFCRibbonPanel [MFC], SetElementMenu", "CMFCRibbonPanel [MFC], SetElementRTC", "CMFCRibbonPanel [MFC], SetElementRTCByID", "CMFCRibbonPanel [MFC], SetFocused", "CMFCRibbonPanel [MFC], SetJustifyColumns", "CMFCRibbonPanel [MFC], SetKeys", "CMFCRibbonPanel [MFC], ShowPopup"] -ms.assetid: 51d70749-1140-4386-b103-f14082049ba6 --- # CMFCRibbonPanel Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a panel that contains a set of ribbon elements. When the panel is drawn, it displays as many elements as possible, given the size of the panel. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcribbonprogressbar-class.md b/docs/mfc/reference/cmfcribbonprogressbar-class.md index 5155a822f97..67c5ff15ff7 100644 --- a/docs/mfc/reference/cmfcribbonprogressbar-class.md +++ b/docs/mfc/reference/cmfcribbonprogressbar-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonProgressBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonProgressBar", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::CMFCRibbonProgressBar", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::GetPos", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::GetRangeMax", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::GetRangeMin", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::GetRegularSize", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::IsInfiniteMode", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::OnDraw", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::SetInfiniteMode", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::SetPos", "AFXRIBBONPROGRESSBAR/CMFCRibbonProgressBar::SetRange"] helpviewer_keywords: ["CMFCRibbonProgressBar [MFC], CMFCRibbonProgressBar", "CMFCRibbonProgressBar [MFC], GetPos", "CMFCRibbonProgressBar [MFC], GetRangeMax", "CMFCRibbonProgressBar [MFC], GetRangeMin", "CMFCRibbonProgressBar [MFC], GetRegularSize", "CMFCRibbonProgressBar [MFC], IsInfiniteMode", "CMFCRibbonProgressBar [MFC], OnDraw", "CMFCRibbonProgressBar [MFC], SetInfiniteMode", "CMFCRibbonProgressBar [MFC], SetPos", "CMFCRibbonProgressBar [MFC], SetRange"] -ms.assetid: de3d9f2e-ed59-480e-aa7d-08a33ab36c67 --- # CMFCRibbonProgressBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a control that visually indicates the progress of a lengthy operation. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonquickaccesstoolbardefaultstate-class.md b/docs/mfc/reference/cmfcribbonquickaccesstoolbardefaultstate-class.md index 7065867788b..0357f3a8f14 100644 --- a/docs/mfc/reference/cmfcribbonquickaccesstoolbardefaultstate-class.md +++ b/docs/mfc/reference/cmfcribbonquickaccesstoolbardefaultstate-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonQuickAccessToolBarDefaultState Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonQuickAccessToolBarDefaultState", "AFXRIBBONQUICKACCESSTOOLBAR/CMFCRibbonQuickAccessToolBarDefaultState", "AFXRIBBONQUICKACCESSTOOLBAR/CMFCRibbonQuickAccessToolBarDefaultState::CMFCRibbonQuickAccessToolBarDefaultState", "AFXRIBBONQUICKACCESSTOOLBAR/CMFCRibbonQuickAccessToolBarDefaultState::AddCommand", "AFXRIBBONQUICKACCESSTOOLBAR/CMFCRibbonQuickAccessToolBarDefaultState::CopyFrom", "AFXRIBBONQUICKACCESSTOOLBAR/CMFCRibbonQuickAccessToolBarDefaultState::RemoveAll"] helpviewer_keywords: ["CMFCRibbonQuickAccessToolBarDefaultState [MFC], CMFCRibbonQuickAccessToolBarDefaultState", "CMFCRibbonQuickAccessToolBarDefaultState [MFC], AddCommand", "CMFCRibbonQuickAccessToolBarDefaultState [MFC], CopyFrom", "CMFCRibbonQuickAccessToolBarDefaultState [MFC], RemoveAll"] -ms.assetid: eca99200-b87b-47ba-b2e8-2f3f2444b176 --- # `CMFCRibbonQuickAccessToolBarDefaultState` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A helper class that manages default state for the Quick Access Toolbar that is positioned on the ribbon bar ([`CMFCRibbonBar` Class](../../mfc/reference/cmfcribbonbar-class.md)). ## Syntax diff --git a/docs/mfc/reference/cmfcribbonseparator-class.md b/docs/mfc/reference/cmfcribbonseparator-class.md index 83e9ba528dc..e4839b50c9d 100644 --- a/docs/mfc/reference/cmfcribbonseparator-class.md +++ b/docs/mfc/reference/cmfcribbonseparator-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonSeparator Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonSeparator", "AFXBASERIBBONELEMENT/CMFCRibbonSeparator", "AFXBASERIBBONELEMENT/CMFCRibbonSeparator::CMFCRibbonSeparator", "AFXBASERIBBONELEMENT/CMFCRibbonSeparator::AddToListBox", "AFXBASERIBBONELEMENT/CMFCRibbonSeparator::CopyFrom", "AFXBASERIBBONELEMENT/CMFCRibbonSeparator::GetRegularSize", "AFXBASERIBBONELEMENT/CMFCRibbonSeparator::IsSeparator", "AFXBASERIBBONELEMENT/CMFCRibbonSeparator::IsTabStop", "AFXBASERIBBONELEMENT/CMFCRibbonSeparator::OnDraw", "AFXBASERIBBONELEMENT/CMFCRibbonSeparator::OnDrawOnList"] helpviewer_keywords: ["CMFCRibbonSeparator [MFC], CMFCRibbonSeparator", "CMFCRibbonSeparator [MFC], AddToListBox", "CMFCRibbonSeparator [MFC], CopyFrom", "CMFCRibbonSeparator [MFC], GetRegularSize", "CMFCRibbonSeparator [MFC], IsSeparator", "CMFCRibbonSeparator [MFC], IsTabStop", "CMFCRibbonSeparator [MFC], OnDraw", "CMFCRibbonSeparator [MFC], OnDrawOnList"] -ms.assetid: bedb1a53-cb07-4c3c-be12-698c5409e7cf --- # CMFCRibbonSeparator Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the ribbon separator. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonslider-class.md b/docs/mfc/reference/cmfcribbonslider-class.md index d0930642854..52069775539 100644 --- a/docs/mfc/reference/cmfcribbonslider-class.md +++ b/docs/mfc/reference/cmfcribbonslider-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonSlider Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonSlider", "AFXRIBBONSLIDER/CMFCRibbonSlider", "AFXRIBBONSLIDER/CMFCRibbonSlider::CMFCRibbonSlider", "AFXRIBBONSLIDER/CMFCRibbonSlider::GetPos", "AFXRIBBONSLIDER/CMFCRibbonSlider::GetRangeMax", "AFXRIBBONSLIDER/CMFCRibbonSlider::GetRangeMin", "AFXRIBBONSLIDER/CMFCRibbonSlider::GetRegularSize", "AFXRIBBONSLIDER/CMFCRibbonSlider::GetZoomIncrement", "AFXRIBBONSLIDER/CMFCRibbonSlider::HasZoomButtons", "AFXRIBBONSLIDER/CMFCRibbonSlider::OnDraw", "AFXRIBBONSLIDER/CMFCRibbonSlider::SetPos", "AFXRIBBONSLIDER/CMFCRibbonSlider::SetRange", "AFXRIBBONSLIDER/CMFCRibbonSlider::SetZoomButtons", "AFXRIBBONSLIDER/CMFCRibbonSlider::SetZoomIncrement"] helpviewer_keywords: ["CMFCRibbonSlider [MFC], CMFCRibbonSlider", "CMFCRibbonSlider [MFC], GetPos", "CMFCRibbonSlider [MFC], GetRangeMax", "CMFCRibbonSlider [MFC], GetRangeMin", "CMFCRibbonSlider [MFC], GetRegularSize", "CMFCRibbonSlider [MFC], GetZoomIncrement", "CMFCRibbonSlider [MFC], HasZoomButtons", "CMFCRibbonSlider [MFC], OnDraw", "CMFCRibbonSlider [MFC], SetPos", "CMFCRibbonSlider [MFC], SetRange", "CMFCRibbonSlider [MFC], SetZoomButtons", "CMFCRibbonSlider [MFC], SetZoomIncrement"] -ms.assetid: 9351ac34-f234-4e42-91e2-763f1989c8ff --- # CMFCRibbonSlider Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonSlider` class implements a slider control that you can add to a ribbon bar or ribbon status bar. The ribbon slider control resembles the zoom sliders that appear in Office 2007 applications. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonstatusbar-class.md b/docs/mfc/reference/cmfcribbonstatusbar-class.md index 1b142bb2694..0326624c77c 100644 --- a/docs/mfc/reference/cmfcribbonstatusbar-class.md +++ b/docs/mfc/reference/cmfcribbonstatusbar-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonStatusBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonStatusBar", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::AddDynamicElement", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::AddElement", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::AddExtendedElement", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::AddSeparator", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::Create", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::CreateEx", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::FindByID", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::FindElement", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::GetCount", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::GetElement", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::GetExCount", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::GetExElement", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::GetExtendedArea", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::GetSpace", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::IsBottomFrame", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::IsExtendedElement", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::IsInformationMode", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::RecalcLayout", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::RemoveAll", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::RemoveElement", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::SetInformation", "AFXRIBBONSTATUSBAR/CMFCRibbonStatusBar::OnDrawInformation"] helpviewer_keywords: ["CMFCRibbonStatusBar [MFC], AddDynamicElement", "CMFCRibbonStatusBar [MFC], AddElement", "CMFCRibbonStatusBar [MFC], AddExtendedElement", "CMFCRibbonStatusBar [MFC], AddSeparator", "CMFCRibbonStatusBar [MFC], Create", "CMFCRibbonStatusBar [MFC], CreateEx", "CMFCRibbonStatusBar [MFC], FindByID", "CMFCRibbonStatusBar [MFC], FindElement", "CMFCRibbonStatusBar [MFC], GetCount", "CMFCRibbonStatusBar [MFC], GetElement", "CMFCRibbonStatusBar [MFC], GetExCount", "CMFCRibbonStatusBar [MFC], GetExElement", "CMFCRibbonStatusBar [MFC], GetExtendedArea", "CMFCRibbonStatusBar [MFC], GetSpace", "CMFCRibbonStatusBar [MFC], IsBottomFrame", "CMFCRibbonStatusBar [MFC], IsExtendedElement", "CMFCRibbonStatusBar [MFC], IsInformationMode", "CMFCRibbonStatusBar [MFC], RecalcLayout", "CMFCRibbonStatusBar [MFC], RemoveAll", "CMFCRibbonStatusBar [MFC], RemoveElement", "CMFCRibbonStatusBar [MFC], SetInformation", "CMFCRibbonStatusBar [MFC], OnDrawInformation"] -ms.assetid: 921eb57f-3b40-49fa-a38c-3f2fb6dc2893 --- # CMFCRibbonStatusBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonStatusBar` class implements a status bar control that can display ribbon elements. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonstatusbarpane-class.md b/docs/mfc/reference/cmfcribbonstatusbarpane-class.md index 8893c2f2649..7c7da6cf122 100644 --- a/docs/mfc/reference/cmfcribbonstatusbarpane-class.md +++ b/docs/mfc/reference/cmfcribbonstatusbarpane-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonStatusBarPane Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonStatusBarPane", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::GetAlmostLargeText", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::GetTextAlign", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::IsAnimation", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::IsExtended", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::OnDrawBorder", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::OnFillBackground", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::SetAlmostLargeText", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::SetAnimationList", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::SetTextAlign", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::StartAnimation", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::StopAnimation", "AFXRIBBONSTATUSBARPANE/CMFCRibbonStatusBarPane::OnFinishAnimation"] helpviewer_keywords: ["CMFCRibbonStatusBarPane [MFC], CMFCRibbonStatusBarPane", "CMFCRibbonStatusBarPane [MFC], GetAlmostLargeText", "CMFCRibbonStatusBarPane [MFC], GetTextAlign", "CMFCRibbonStatusBarPane [MFC], IsAnimation", "CMFCRibbonStatusBarPane [MFC], IsExtended", "CMFCRibbonStatusBarPane [MFC], OnDrawBorder", "CMFCRibbonStatusBarPane [MFC], OnFillBackground", "CMFCRibbonStatusBarPane [MFC], SetAlmostLargeText", "CMFCRibbonStatusBarPane [MFC], SetAnimationList", "CMFCRibbonStatusBarPane [MFC], SetTextAlign", "CMFCRibbonStatusBarPane [MFC], StartAnimation", "CMFCRibbonStatusBarPane [MFC], StopAnimation", "CMFCRibbonStatusBarPane [MFC], OnFinishAnimation"] -ms.assetid: 5d034c3c-ecca-4267-b88c-0f55a2884dd0 --- # CMFCRibbonStatusBarPane Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonStatusBarPane` class implements a ribbon element that you can add to a ribbon status bar. ## Syntax diff --git a/docs/mfc/reference/cmfcribbonundobutton-class.md b/docs/mfc/reference/cmfcribbonundobutton-class.md index 2cc70cab6a8..19f612a1c0a 100644 --- a/docs/mfc/reference/cmfcribbonundobutton-class.md +++ b/docs/mfc/reference/cmfcribbonundobutton-class.md @@ -4,10 +4,12 @@ title: "CMFCRibbonUndoButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonUndoButton", "AFXRIBBONUNDOBUTTON/CMFCRibbonUndoButton", "AFXRIBBONUNDOBUTTON/CMFCRibbonUndoButton::CMFCRibbonUndoButton", "AFXRIBBONUNDOBUTTON/CMFCRibbonUndoButton::AddUndoAction", "AFXRIBBONUNDOBUTTON/CMFCRibbonUndoButton::CleanUpUndoList", "AFXRIBBONUNDOBUTTON/CMFCRibbonUndoButton::GetActionNumber", "AFXRIBBONUNDOBUTTON/CMFCRibbonUndoButton::HasMenu"] helpviewer_keywords: ["CMFCRibbonUndoButton [MFC], CMFCRibbonUndoButton", "CMFCRibbonUndoButton [MFC], AddUndoAction", "CMFCRibbonUndoButton [MFC], CleanUpUndoList", "CMFCRibbonUndoButton [MFC], GetActionNumber", "CMFCRibbonUndoButton [MFC], HasMenu"] -ms.assetid: 5c42adf7-871d-4239-901e-47ae7fb816fc --- # CMFCRibbonUndoButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCRibbonUndoButton` class implements a drop-down list button that contains the most recent user commands. Users can select one or more of the most recent commands from the drop-down list to either redo or undo them. ## Syntax diff --git a/docs/mfc/reference/cmfcshelllistctrl-class.md b/docs/mfc/reference/cmfcshelllistctrl-class.md index a912243d295..40bda8b608f 100644 --- a/docs/mfc/reference/cmfcshelllistctrl-class.md +++ b/docs/mfc/reference/cmfcshelllistctrl-class.md @@ -4,10 +4,12 @@ title: "CMFCShellListCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCShellListCtrl", "AFXSHELLLISTCTRL/CMFCShellListCtrl", "AFXSHELLLISTCTRL/CMFCShellListCtrl::DisplayFolder", "AFXSHELLLISTCTRL/CMFCShellListCtrl::DisplayParentFolder", "AFXSHELLLISTCTRL/CMFCShellListCtrl::EnableShellContextMenu", "AFXSHELLLISTCTRL/CMFCShellListCtrl::GetCurrentFolder", "AFXSHELLLISTCTRL/CMFCShellListCtrl::GetCurrentFolderName", "AFXSHELLLISTCTRL/CMFCShellListCtrl::GetCurrentItemIdList", "AFXSHELLLISTCTRL/CMFCShellListCtrl::GetCurrentShellFolder", "AFXSHELLLISTCTRL/CMFCShellListCtrl::GetItemPath", "AFXSHELLLISTCTRL/CMFCShellListCtrl::GetItemTypes", "AFXSHELLLISTCTRL/CMFCShellListCtrl::IsDesktop", "AFXSHELLLISTCTRL/CMFCShellListCtrl::OnCompareItems", "AFXSHELLLISTCTRL/CMFCShellListCtrl::OnFormatFileDate", "AFXSHELLLISTCTRL/CMFCShellListCtrl::OnFormatFileSize", "AFXSHELLLISTCTRL/CMFCShellListCtrl::OnGetItemIcon", "AFXSHELLLISTCTRL/CMFCShellListCtrl::OnGetItemText", "AFXSHELLLISTCTRL/CMFCShellListCtrl::OnSetColumns", "AFXSHELLLISTCTRL/CMFCShellListCtrl::Refresh", "AFXSHELLLISTCTRL/CMFCShellListCtrl::SetItemTypes"] helpviewer_keywords: ["CMFCShellListCtrl [MFC], DisplayFolder", "CMFCShellListCtrl [MFC], DisplayParentFolder", "CMFCShellListCtrl [MFC], EnableShellContextMenu", "CMFCShellListCtrl [MFC], GetCurrentFolder", "CMFCShellListCtrl [MFC], GetCurrentFolderName", "CMFCShellListCtrl [MFC], GetCurrentItemIdList", "CMFCShellListCtrl [MFC], GetCurrentShellFolder", "CMFCShellListCtrl [MFC], GetItemPath", "CMFCShellListCtrl [MFC], GetItemTypes", "CMFCShellListCtrl [MFC], IsDesktop", "CMFCShellListCtrl [MFC], OnCompareItems", "CMFCShellListCtrl [MFC], OnFormatFileDate", "CMFCShellListCtrl [MFC], OnFormatFileSize", "CMFCShellListCtrl [MFC], OnGetItemIcon", "CMFCShellListCtrl [MFC], OnGetItemText", "CMFCShellListCtrl [MFC], OnSetColumns", "CMFCShellListCtrl [MFC], Refresh", "CMFCShellListCtrl [MFC], SetItemTypes"] -ms.assetid: ad472958-5586-4c50-aadf-1844c30bf6e7 --- # CMFCShellListCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCShellListCtrl` class provides Windows list control functionality and expands it by including the ability to display a list of shell items. ## Syntax diff --git a/docs/mfc/reference/cmfcshelltreectrl-class.md b/docs/mfc/reference/cmfcshelltreectrl-class.md index 7dfa16e3951..1389dd1c38b 100644 --- a/docs/mfc/reference/cmfcshelltreectrl-class.md +++ b/docs/mfc/reference/cmfcshelltreectrl-class.md @@ -4,10 +4,12 @@ title: "CMFCShellTreeCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCShellTreeCtrl", "AFXSHELLTREECTRL/CMFCShellTreeCtrl", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::EnableShellContextMenu", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::GetFlags", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::GetItemPath", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::GetRelatedList", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::OnChildNotify", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::OnGetItemIcon", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::OnGetItemText", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::Refresh", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::SelectPath", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::SetFlags", "AFXSHELLTREECTRL/CMFCShellTreeCtrl::SetRelatedList"] helpviewer_keywords: ["CMFCShellTreeCtrl [MFC], EnableShellContextMenu", "CMFCShellTreeCtrl [MFC], GetFlags", "CMFCShellTreeCtrl [MFC], GetItemPath", "CMFCShellTreeCtrl [MFC], GetRelatedList", "CMFCShellTreeCtrl [MFC], OnChildNotify", "CMFCShellTreeCtrl [MFC], OnGetItemIcon", "CMFCShellTreeCtrl [MFC], OnGetItemText", "CMFCShellTreeCtrl [MFC], Refresh", "CMFCShellTreeCtrl [MFC], SelectPath", "CMFCShellTreeCtrl [MFC], SetFlags", "CMFCShellTreeCtrl [MFC], SetRelatedList"] -ms.assetid: 3d1da715-9554-4ed7-968c-055c48146267 --- # CMFCShellTreeCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCShellTreeCtrl` class extends [CTreeCtrl Class](../../mfc/reference/ctreectrl-class.md) functionality by displaying a hierarchy of Shell items. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcspinbuttonctrl-class.md b/docs/mfc/reference/cmfcspinbuttonctrl-class.md index 4c0be4a5be5..ba101a0b26f 100644 --- a/docs/mfc/reference/cmfcspinbuttonctrl-class.md +++ b/docs/mfc/reference/cmfcspinbuttonctrl-class.md @@ -4,10 +4,12 @@ title: "CMFCSpinButtonCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCSpinButtonCtrl", "AFXSPINBUTTONCTRL/CMFCSpinButtonCtrl", "AFXSPINBUTTONCTRL/CMFCSpinButtonCtrl::OnDraw"] helpviewer_keywords: ["CMFCSpinButtonCtrl [MFC], OnDraw"] -ms.assetid: 8773f259-4d3f-4bca-a71c-09e0c71bc843 --- # CMFCSpinButtonCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCSpinButtonCtrl` class supports a visual manager that draws a spin button control. ## Syntax diff --git a/docs/mfc/reference/cmfcstandardcolorspropertypage-class.md b/docs/mfc/reference/cmfcstandardcolorspropertypage-class.md index bfa687e415c..74a8259dd78 100644 --- a/docs/mfc/reference/cmfcstandardcolorspropertypage-class.md +++ b/docs/mfc/reference/cmfcstandardcolorspropertypage-class.md @@ -3,10 +3,12 @@ description: "Learn more about: CMFCStandardColorsPropertyPage Class" title: "CMFCStandardColorsPropertyPage Class" ms.date: "11/04/2016" helpviewer_keywords: ["CMFCStandardColorsPropertyPage class [MFC]"] -ms.assetid: b84b7cfb-bb24-4c65-804a-5b642cb64400 --- # CMFCStandardColorsPropertyPage Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a property page that users use to select standard colors in a color dialog box. ## Syntax diff --git a/docs/mfc/reference/cmfcstatusbar-class.md b/docs/mfc/reference/cmfcstatusbar-class.md index 066130cf342..0f7754ee2fb 100644 --- a/docs/mfc/reference/cmfcstatusbar-class.md +++ b/docs/mfc/reference/cmfcstatusbar-class.md @@ -4,10 +4,12 @@ title: "CMFCStatusBar Class" ms.date: "11/19/2018" f1_keywords: ["CMFCStatusBar", "AFXSTATUSBAR/CMFCStatusBar", "AFXSTATUSBAR/CMFCStatusBar::CalcFixedLayout", "AFXSTATUSBAR/CMFCStatusBar::CommandToIndex", "AFXSTATUSBAR/CMFCStatusBar::Create", "AFXSTATUSBAR/CMFCStatusBar::CreateEx", "AFXSTATUSBAR/CMFCStatusBar::DoesAllowDynInsertBefore", "AFXSTATUSBAR/CMFCStatusBar::EnablePaneDoubleClick", "AFXSTATUSBAR/CMFCStatusBar::EnablePaneProgressBar", "AFXSTATUSBAR/CMFCStatusBar::GetCount", "AFXSTATUSBAR/CMFCStatusBar::GetDrawExtendedArea", "AFXSTATUSBAR/CMFCStatusBar::GetExtendedArea", "AFXSTATUSBAR/CMFCStatusBar::GetItemID", "AFXSTATUSBAR/CMFCStatusBar::GetItemRect", "AFXSTATUSBAR/CMFCStatusBar::GetPaneInfo", "AFXSTATUSBAR/CMFCStatusBar::GetPaneProgress", "AFXSTATUSBAR/CMFCStatusBar::GetPaneStyle", "AFXSTATUSBAR/CMFCStatusBar::GetPaneText", "AFXSTATUSBAR/CMFCStatusBar::GetPaneWidth", "AFXSTATUSBAR/CMFCStatusBar::GetTipText", "AFXSTATUSBAR/CMFCStatusBar::InvalidatePaneContent", "AFXSTATUSBAR/CMFCStatusBar::PreCreateWindow", "AFXSTATUSBAR/CMFCStatusBar::SetDrawExtendedArea", "AFXSTATUSBAR/CMFCStatusBar::SetIndicators", "AFXSTATUSBAR/CMFCStatusBar::SetPaneAnimation", "AFXSTATUSBAR/CMFCStatusBar::SetPaneBackgroundColor", "AFXSTATUSBAR/CMFCStatusBar::SetPaneIcon", "AFXSTATUSBAR/CMFCStatusBar::SetPaneInfo", "AFXSTATUSBAR/CMFCStatusBar::SetPaneProgress", "AFXSTATUSBAR/CMFCStatusBar::SetPaneStyle", "AFXSTATUSBAR/CMFCStatusBar::SetPaneText", "AFXSTATUSBAR/CMFCStatusBar::SetPaneTextColor", "AFXSTATUSBAR/CMFCStatusBar::SetPaneWidth", "AFXSTATUSBAR/CMFCStatusBar::SetTipText", "AFXSTATUSBAR/CMFCStatusBar::OnDrawPane"] helpviewer_keywords: ["CMFCStatusBar [MFC], CalcFixedLayout", "CMFCStatusBar [MFC], CommandToIndex", "CMFCStatusBar [MFC], Create", "CMFCStatusBar [MFC], CreateEx", "CMFCStatusBar [MFC], DoesAllowDynInsertBefore", "CMFCStatusBar [MFC], EnablePaneDoubleClick", "CMFCStatusBar [MFC], EnablePaneProgressBar", "CMFCStatusBar [MFC], GetCount", "CMFCStatusBar [MFC], GetDrawExtendedArea", "CMFCStatusBar [MFC], GetExtendedArea", "CMFCStatusBar [MFC], GetItemID", "CMFCStatusBar [MFC], GetItemRect", "CMFCStatusBar [MFC], GetPaneInfo", "CMFCStatusBar [MFC], GetPaneProgress", "CMFCStatusBar [MFC], GetPaneStyle", "CMFCStatusBar [MFC], GetPaneText", "CMFCStatusBar [MFC], GetPaneWidth", "CMFCStatusBar [MFC], GetTipText", "CMFCStatusBar [MFC], InvalidatePaneContent", "CMFCStatusBar [MFC], PreCreateWindow", "CMFCStatusBar [MFC], SetDrawExtendedArea", "CMFCStatusBar [MFC], SetIndicators", "CMFCStatusBar [MFC], SetPaneAnimation", "CMFCStatusBar [MFC], SetPaneBackgroundColor", "CMFCStatusBar [MFC], SetPaneIcon", "CMFCStatusBar [MFC], SetPaneInfo", "CMFCStatusBar [MFC], SetPaneProgress", "CMFCStatusBar [MFC], SetPaneStyle", "CMFCStatusBar [MFC], SetPaneText", "CMFCStatusBar [MFC], SetPaneTextColor", "CMFCStatusBar [MFC], SetPaneWidth", "CMFCStatusBar [MFC], SetTipText", "CMFCStatusBar [MFC], OnDrawPane"] -ms.assetid: f2960d1d-f4ed-41e8-bd99-0382b2f8d88e --- # CMFCStatusBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCStatusBar` class implements a status bar similar to the `CStatusBar` class. However, the `CMFCStatusBar` class has features not offered by the `CStatusBar` class, such as the ability to display images, animations, and progress bars; and the ability to respond to mouse double-clicks. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfctabctrl-class.md b/docs/mfc/reference/cmfctabctrl-class.md index d59039a3592..1cc67d8362b 100644 --- a/docs/mfc/reference/cmfctabctrl-class.md +++ b/docs/mfc/reference/cmfctabctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCTabCtrl [MFC], ActivateMDITab", "CMFCTabCtrl [MFC], A --- # `CMFCTabCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCTabCtrl` class provides functionality for a tab control. The tab control displays a dockable window with flat or three-dimensional tabs at its top or bottom. The tabs can display text and an image and can change color when active. ## Syntax diff --git a/docs/mfc/reference/cmfctabdroptarget-class.md b/docs/mfc/reference/cmfctabdroptarget-class.md index 5d89adc8afd..23d80ad1a80 100644 --- a/docs/mfc/reference/cmfctabdroptarget-class.md +++ b/docs/mfc/reference/cmfctabdroptarget-class.md @@ -4,10 +4,12 @@ title: "CMFCTabDropTarget Class" ms.date: "11/04/2016" f1_keywords: ["CMFCTabDropTarget", "AFXBASETABCTRL/CMFCTabDropTarget", "AFXBASETABCTRL/CMFCTabDropTarget::OnDragEnter", "AFXBASETABCTRL/CMFCTabDropTarget::OnDragLeave", "AFXBASETABCTRL/CMFCTabDropTarget::OnDragOver", "AFXBASETABCTRL/CMFCTabDropTarget::OnDropEx", "AFXBASETABCTRL/CMFCTabDropTarget::Register"] helpviewer_keywords: ["CMFCTabDropTarget [MFC], OnDragEnter", "CMFCTabDropTarget [MFC], OnDragLeave", "CMFCTabDropTarget [MFC], OnDragOver", "CMFCTabDropTarget [MFC], OnDropEx", "CMFCTabDropTarget [MFC], Register"] -ms.assetid: 9777b7b6-10da-4c4b-b1d1-7ea795b0f1cb --- # CMFCTabDropTarget Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the communication mechanism between a tab control and the OLE libraries. ## Syntax diff --git a/docs/mfc/reference/cmfctabtooltipinfo-structure.md b/docs/mfc/reference/cmfctabtooltipinfo-structure.md index af9d6c82a9c..b83387bc247 100644 --- a/docs/mfc/reference/cmfctabtooltipinfo-structure.md +++ b/docs/mfc/reference/cmfctabtooltipinfo-structure.md @@ -4,10 +4,12 @@ title: "CMFCTabToolTipInfo Structure" ms.date: "11/04/2016" f1_keywords: ["CMFCTabToolTipInfo"] helpviewer_keywords: ["CMFCTabToolTipInfo struct"] -ms.assetid: 9c3b3fb9-1497-4d59-932b-0da9348dd5e2 --- # CMFCTabToolTipInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This structure provides information about the MDI tab that the user is hovering over. ## Syntax diff --git a/docs/mfc/reference/cmfctaskspane-class.md b/docs/mfc/reference/cmfctaskspane-class.md index 3f766743078..c45aa476a0f 100644 --- a/docs/mfc/reference/cmfctaskspane-class.md +++ b/docs/mfc/reference/cmfctaskspane-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCTasksPane [MFC], CMFCTasksPane", "CMFCTasksPane [MFC] --- # CMFCTasksPane Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. The `CMFCTasksPane` class implements a list of clickable items (tasks). diff --git a/docs/mfc/reference/cmfctaskspanetask-class.md b/docs/mfc/reference/cmfctaskspanetask-class.md index 215e27bed25..f11dfddd682 100644 --- a/docs/mfc/reference/cmfctaskspanetask-class.md +++ b/docs/mfc/reference/cmfctaskspanetask-class.md @@ -4,10 +4,12 @@ title: "CMFCTasksPaneTask Class" ms.date: "11/19/2018" f1_keywords: ["CMFCTasksPaneTask", "AFXTASKSPANE/CMFCTasksPaneTask", "AFXTASKSPANE/CMFCTasksPaneTask::CMFCTasksPaneTask", "AFXTASKSPANE/CMFCTasksPaneTask::SetACCData", "AFXTASKSPANE/CMFCTasksPaneTask::m_bAutoDestroyWindow", "AFXTASKSPANE/CMFCTasksPaneTask::m_bIsBold", "AFXTASKSPANE/CMFCTasksPaneTask::m_dwUserData", "AFXTASKSPANE/CMFCTasksPaneTask::m_hwndTask", "AFXTASKSPANE/CMFCTasksPaneTask::m_nIcon", "AFXTASKSPANE/CMFCTasksPaneTask::m_nWindowHeight", "AFXTASKSPANE/CMFCTasksPaneTask::m_pGroup", "AFXTASKSPANE/CMFCTasksPaneTask::m_rect", "AFXTASKSPANE/CMFCTasksPaneTask::m_strName", "AFXTASKSPANE/CMFCTasksPaneTask::m_uiCommandID"] helpviewer_keywords: ["CMFCTasksPaneTask [MFC], CMFCTasksPaneTask", "CMFCTasksPaneTask [MFC], SetACCData", "CMFCTasksPaneTask [MFC], m_bAutoDestroyWindow", "CMFCTasksPaneTask [MFC], m_bIsBold", "CMFCTasksPaneTask [MFC], m_dwUserData", "CMFCTasksPaneTask [MFC], m_hwndTask", "CMFCTasksPaneTask [MFC], m_nIcon", "CMFCTasksPaneTask [MFC], m_nWindowHeight", "CMFCTasksPaneTask [MFC], m_pGroup", "CMFCTasksPaneTask [MFC], m_rect", "CMFCTasksPaneTask [MFC], m_strName", "CMFCTasksPaneTask [MFC], m_uiCommandID"] -ms.assetid: c5a7513b-cd8f-4e2e-b16f-650e1fe30954 --- # CMFCTasksPaneTask Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCTasksPaneTask` class is a helper class that represents tasks for the task pane control ( [CMFCTasksPane](../../mfc/reference/cmfctaskspane-class.md)). The task object represents an item in the task group ( [CMFCTasksPaneTaskGroup](../../mfc/reference/cmfctaskspanetaskgroup-class.md)). Each task can have a command that the framework executes when a user clicks on the task and an icon that appears to the left of the task name. ## Syntax diff --git a/docs/mfc/reference/cmfctaskspanetaskgroup-class.md b/docs/mfc/reference/cmfctaskspanetaskgroup-class.md index c7f575c20a3..4db39770b60 100644 --- a/docs/mfc/reference/cmfctaskspanetaskgroup-class.md +++ b/docs/mfc/reference/cmfctaskspanetaskgroup-class.md @@ -4,10 +4,12 @@ title: "CMFCTasksPaneTaskGroup Class" ms.date: "11/19/2018" f1_keywords: ["CMFCTasksPaneTaskGroup", "AFXTASKSPANE/CMFCTasksPaneTaskGroup", "AFXTASKSPANE/CMFCTasksPaneTaskGroup::CMFCTasksPaneTaskGroup", "AFXTASKSPANE/CMFCTasksPaneTaskGroup::SetACCData", "AFXTASKSPANE/CMFCTasksPaneTaskGroup::m_bIsBottom", "AFXTASKSPANE/CMFCTasksPaneTaskGroup::m_bIsCollapsed", "AFXTASKSPANE/CMFCTasksPaneTaskGroup::m_bIsSpecial", "AFXTASKSPANE/CMFCTasksPaneTaskGroup::m_lstTasks", "AFXTASKSPANE/CMFCTasksPaneTaskGroup::m_rect", "AFXTASKSPANE/CMFCTasksPaneTaskGroup::m_rectGroup", "AFXTASKSPANE/CMFCTasksPaneTaskGroup::m_strName"] helpviewer_keywords: ["CMFCTasksPaneTaskGroup [MFC], CMFCTasksPaneTaskGroup", "CMFCTasksPaneTaskGroup [MFC], SetACCData", "CMFCTasksPaneTaskGroup [MFC], m_bIsBottom", "CMFCTasksPaneTaskGroup [MFC], m_bIsCollapsed", "CMFCTasksPaneTaskGroup [MFC], m_bIsSpecial", "CMFCTasksPaneTaskGroup [MFC], m_lstTasks", "CMFCTasksPaneTaskGroup [MFC], m_rect", "CMFCTasksPaneTaskGroup [MFC], m_rectGroup", "CMFCTasksPaneTaskGroup [MFC], m_strName"] -ms.assetid: 2111640b-a46e-4b27-b033-29e88632b86a --- # CMFCTasksPaneTaskGroup Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCTasksPaneTaskGroup` class is a helper class used by the [CMFCTasksPane](../../mfc/reference/cmfctaskspane-class.md) control. Objects of type `CMFCTasksPaneTaskGroup` represent a *task group*. The task group is a list of items that the framework displays in a separate box that has a collapse button. The box can have an optional caption (group name). If a group is collapsed, the list of tasks is not visible. ## Syntax diff --git a/docs/mfc/reference/cmfctoolbar-class.md b/docs/mfc/reference/cmfctoolbar-class.md index 9e9384ef1d5..a921bc1033d 100644 --- a/docs/mfc/reference/cmfctoolbar-class.md +++ b/docs/mfc/reference/cmfctoolbar-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCToolBar [MFC], AddBasicCommand", "CMFCToolBar [MFC], --- # `CMFCToolBar` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCToolBar` class resembles [`CToolBar` Class](../../mfc/reference/ctoolbar-class.md), but provides additional support for user interface features. These include flat toolbars, toolbars with hot images, large icons, pager buttons, locked toolbars, rebar controls, text under images, background images, and tabbed toolbars. The `CMFCToolBar` class also contains built-in support for user customization of toolbars and menus, drag-and-drop between toolbars and menus, combo box buttons, edit box buttons, color pickers, and roll-up buttons. For more detail, see the source code located in your Visual Studio installation, for example, `%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc`. diff --git a/docs/mfc/reference/cmfctoolbarbutton-class.md b/docs/mfc/reference/cmfctoolbarbutton-class.md index dd3933b89bc..7c6d4005c6c 100644 --- a/docs/mfc/reference/cmfctoolbarbutton-class.md +++ b/docs/mfc/reference/cmfctoolbarbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarButton", "AFXTOOLBARBUTTON/CMFCToolBarButton", "AFXTOOLBARBUTTON/CMFCToolBarButton::CMFCToolBarButton", "AFXTOOLBARBUTTON/CMFCToolBarButton::CanBeDropped", "AFXTOOLBARBUTTON/CMFCToolBarButton::CanBeStored", "AFXTOOLBARBUTTON/CMFCToolBarButton::CanBeStretched", "AFXTOOLBARBUTTON/CMFCToolBarButton::CompareWith", "AFXTOOLBARBUTTON/CMFCToolBarButton::CopyFrom", "AFXTOOLBARBUTTON/CMFCToolBarButton::CreateFromOleData", "AFXTOOLBARBUTTON/CMFCToolBarButton::EnableWindow", "AFXTOOLBARBUTTON/CMFCToolBarButton::ExportToMenuButton", "AFXTOOLBARBUTTON/CMFCToolBarButton::GetClipboardFormat", "AFXTOOLBARBUTTON/CMFCToolBarButton::GetHwnd", "AFXTOOLBARBUTTON/CMFCToolBarButton::GetImage", "AFXTOOLBARBUTTON/CMFCToolBarButton::GetInvalidateRect", "AFXTOOLBARBUTTON/CMFCToolBarButton::GetParentWnd", "AFXTOOLBARBUTTON/CMFCToolBarButton::GetProtectedCommands", "AFXTOOLBARBUTTON/CMFCToolBarButton::GetTextSize", "AFXTOOLBARBUTTON/CMFCToolBarButton::HasFocus", "AFXTOOLBARBUTTON/CMFCToolBarButton::HaveHotBorder", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsDrawImage", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsDrawText", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsDroppedDown", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsEditable", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsExtraSize", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsFirstInGroup", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsHidden", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsHorizontal", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsLastInGroup", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsLocked", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsOwnerOf", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsVisible", "AFXTOOLBARBUTTON/CMFCToolBarButton::IsWindowVisible", "AFXTOOLBARBUTTON/CMFCToolBarButton::NotifyCommand", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnAddToCustomizePage", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnBeforeDrag", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnBeforeDrop", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnCalculateSize", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnCancelMode", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnChangeParentWnd", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnClick", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnClickUp", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnContextHelp", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnCtlColor", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnCustomizeMenu", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnDblClk", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnDraw", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnDrawOnCustomizeList", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnGetCustomToolTipText", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnGlobalFontsChanged", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnMove", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnShow", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnSize", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnToolHitTest", "AFXTOOLBARBUTTON/CMFCToolBarButton::OnUpdateToolTip", "AFXTOOLBARBUTTON/CMFCToolBarButton::PrepareDrag", "AFXTOOLBARBUTTON/CMFCToolBarButton::Rect", "AFXTOOLBARBUTTON/CMFCToolBarButton::ResetImageToDefault", "AFXTOOLBARBUTTON/CMFCToolBarButton::SaveBarState", "AFXTOOLBARBUTTON/CMFCToolBarButton::Serialize", "AFXTOOLBARBUTTON/CMFCToolBarButton::SetACCData", "AFXTOOLBARBUTTON/CMFCToolBarButton::SetClipboardFormatName", "AFXTOOLBARBUTTON/CMFCToolBarButton::SetImage", "AFXTOOLBARBUTTON/CMFCToolBarButton::SetProtectedCommands", "AFXTOOLBARBUTTON/CMFCToolBarButton::SetRadio", "AFXTOOLBARBUTTON/CMFCToolBarButton::SetRect", "AFXTOOLBARBUTTON/CMFCToolBarButton::SetStyle", "AFXTOOLBARBUTTON/CMFCToolBarButton::SetVisible", "AFXTOOLBARBUTTON/CMFCToolBarButton::Show", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_bImage", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_bText", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_bTextBelow", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_bUserButton", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_bWholeText", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_bWrap", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_bWrapText", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_nID", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_nStyle", "AFXTOOLBARBUTTON/CMFCToolBarButton::m_strText"] helpviewer_keywords: ["CMFCToolBarButton [MFC], CMFCToolBarButton", "CMFCToolBarButton [MFC], CanBeDropped", "CMFCToolBarButton [MFC], CanBeStored", "CMFCToolBarButton [MFC], CanBeStretched", "CMFCToolBarButton [MFC], CompareWith", "CMFCToolBarButton [MFC], CopyFrom", "CMFCToolBarButton [MFC], CreateFromOleData", "CMFCToolBarButton [MFC], EnableWindow", "CMFCToolBarButton [MFC], ExportToMenuButton", "CMFCToolBarButton [MFC], GetClipboardFormat", "CMFCToolBarButton [MFC], GetHwnd", "CMFCToolBarButton [MFC], GetImage", "CMFCToolBarButton [MFC], GetInvalidateRect", "CMFCToolBarButton [MFC], GetParentWnd", "CMFCToolBarButton [MFC], GetProtectedCommands", "CMFCToolBarButton [MFC], GetTextSize", "CMFCToolBarButton [MFC], HasFocus", "CMFCToolBarButton [MFC], HaveHotBorder", "CMFCToolBarButton [MFC], IsDrawImage", "CMFCToolBarButton [MFC], IsDrawText", "CMFCToolBarButton [MFC], IsDroppedDown", "CMFCToolBarButton [MFC], IsEditable", "CMFCToolBarButton [MFC], IsExtraSize", "CMFCToolBarButton [MFC], IsFirstInGroup", "CMFCToolBarButton [MFC], IsHidden", "CMFCToolBarButton [MFC], IsHorizontal", "CMFCToolBarButton [MFC], IsLastInGroup", "CMFCToolBarButton [MFC], IsLocked", "CMFCToolBarButton [MFC], IsOwnerOf", "CMFCToolBarButton [MFC], IsVisible", "CMFCToolBarButton [MFC], IsWindowVisible", "CMFCToolBarButton [MFC], NotifyCommand", "CMFCToolBarButton [MFC], OnAddToCustomizePage", "CMFCToolBarButton [MFC], OnBeforeDrag", "CMFCToolBarButton [MFC], OnBeforeDrop", "CMFCToolBarButton [MFC], OnCalculateSize", "CMFCToolBarButton [MFC], OnCancelMode", "CMFCToolBarButton [MFC], OnChangeParentWnd", "CMFCToolBarButton [MFC], OnClick", "CMFCToolBarButton [MFC], OnClickUp", "CMFCToolBarButton [MFC], OnContextHelp", "CMFCToolBarButton [MFC], OnCtlColor", "CMFCToolBarButton [MFC], OnCustomizeMenu", "CMFCToolBarButton [MFC], OnDblClk", "CMFCToolBarButton [MFC], OnDraw", "CMFCToolBarButton [MFC], OnDrawOnCustomizeList", "CMFCToolBarButton [MFC], OnGetCustomToolTipText", "CMFCToolBarButton [MFC], OnGlobalFontsChanged", "CMFCToolBarButton [MFC], OnMove", "CMFCToolBarButton [MFC], OnShow", "CMFCToolBarButton [MFC], OnSize", "CMFCToolBarButton [MFC], OnToolHitTest", "CMFCToolBarButton [MFC], OnUpdateToolTip", "CMFCToolBarButton [MFC], PrepareDrag", "CMFCToolBarButton [MFC], Rect", "CMFCToolBarButton [MFC], ResetImageToDefault", "CMFCToolBarButton [MFC], SaveBarState", "CMFCToolBarButton [MFC], Serialize", "CMFCToolBarButton [MFC], SetACCData", "CMFCToolBarButton [MFC], SetClipboardFormatName", "CMFCToolBarButton [MFC], SetImage", "CMFCToolBarButton [MFC], SetProtectedCommands", "CMFCToolBarButton [MFC], SetRadio", "CMFCToolBarButton [MFC], SetRect", "CMFCToolBarButton [MFC], SetStyle", "CMFCToolBarButton [MFC], SetVisible", "CMFCToolBarButton [MFC], Show", "CMFCToolBarButton [MFC], m_bImage", "CMFCToolBarButton [MFC], m_bText", "CMFCToolBarButton [MFC], m_bTextBelow", "CMFCToolBarButton [MFC], m_bUserButton", "CMFCToolBarButton [MFC], m_bWholeText", "CMFCToolBarButton [MFC], m_bWrap", "CMFCToolBarButton [MFC], m_bWrapText", "CMFCToolBarButton [MFC], m_nID", "CMFCToolBarButton [MFC], m_nStyle", "CMFCToolBarButton [MFC], m_strText"] -ms.assetid: 8a6ecffb-86b0-4f5c-8211-a9146b463efd --- # CMFCToolBarButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides button functionality to toolbars. ## Syntax diff --git a/docs/mfc/reference/cmfctoolbarcomboboxbutton-class.md b/docs/mfc/reference/cmfctoolbarcomboboxbutton-class.md index 33ad04efef8..90ef5256171 100644 --- a/docs/mfc/reference/cmfctoolbarcomboboxbutton-class.md +++ b/docs/mfc/reference/cmfctoolbarcomboboxbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarComboBoxButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarComboBoxButton", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::AddItem", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::AddSortedItem", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::Compare", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::CreateEdit", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::DeleteItem", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::FindItem", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetByCmd", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetComboBox", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetCount", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetCountAll", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetCurSel", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetCurSelAll", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetEditCtrl", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetItem", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetItemAll", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetItemData", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetItemDataAll", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetItemDataPtrAll", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetText", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::GetTextAll", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::IsCenterVert", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::IsFlatMode", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::RemoveAllItems", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::SelectItem", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::SelectItemAll", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::SetCenterVert", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::SetDropDownHeight", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxButton::SetFlatMode"] helpviewer_keywords: ["CMFCToolBarComboBoxButton [MFC], CMFCToolBarComboBoxButton", "CMFCToolBarComboBoxButton [MFC], AddItem", "CMFCToolBarComboBoxButton [MFC], AddSortedItem", "CMFCToolBarComboBoxButton [MFC], Compare", "CMFCToolBarComboBoxButton [MFC], CreateEdit", "CMFCToolBarComboBoxButton [MFC], DeleteItem", "CMFCToolBarComboBoxButton [MFC], FindItem", "CMFCToolBarComboBoxButton [MFC], GetByCmd", "CMFCToolBarComboBoxButton [MFC], GetComboBox", "CMFCToolBarComboBoxButton [MFC], GetCount", "CMFCToolBarComboBoxButton [MFC], GetCountAll", "CMFCToolBarComboBoxButton [MFC], GetCurSel", "CMFCToolBarComboBoxButton [MFC], GetCurSelAll", "CMFCToolBarComboBoxButton [MFC], GetEditCtrl", "CMFCToolBarComboBoxButton [MFC], GetItem", "CMFCToolBarComboBoxButton [MFC], GetItemAll", "CMFCToolBarComboBoxButton [MFC], GetItemData", "CMFCToolBarComboBoxButton [MFC], GetItemDataAll", "CMFCToolBarComboBoxButton [MFC], GetItemDataPtrAll", "CMFCToolBarComboBoxButton [MFC], GetText", "CMFCToolBarComboBoxButton [MFC], GetTextAll", "CMFCToolBarComboBoxButton [MFC], IsCenterVert", "CMFCToolBarComboBoxButton [MFC], IsFlatMode", "CMFCToolBarComboBoxButton [MFC], RemoveAllItems", "CMFCToolBarComboBoxButton [MFC], SelectItem", "CMFCToolBarComboBoxButton [MFC], SelectItemAll", "CMFCToolBarComboBoxButton [MFC], SetCenterVert", "CMFCToolBarComboBoxButton [MFC], SetDropDownHeight", "CMFCToolBarComboBoxButton [MFC], SetFlatMode"] -ms.assetid: 32fa39f7-8e4e-4f0a-a31d-7b540d969a6c --- # CMFCToolBarComboBoxButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A toolbar button that contains a combo box control ( [CComboBox Class](../../mfc/reference/ccombobox-class.md)). ## Syntax diff --git a/docs/mfc/reference/cmfctoolbarcomboboxedit-class.md b/docs/mfc/reference/cmfctoolbarcomboboxedit-class.md index d3268930335..e967144ef94 100644 --- a/docs/mfc/reference/cmfctoolbarcomboboxedit-class.md +++ b/docs/mfc/reference/cmfctoolbarcomboboxedit-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarComboBoxEdit Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarComboBoxEdit", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxEdit", "AFXTOOLBARCOMBOBOXBUTTON/CMFCToolBarComboBoxEdit::CMFCToolBarComboBoxEdit"] helpviewer_keywords: ["CMFCToolBarComboBoxEdit [MFC], CMFCToolBarComboBoxEdit"] -ms.assetid: 4789c34a-ce58-48ba-a26f-38748b601352 --- # CMFCToolBarComboBoxEdit Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The framework uses the `CMFCToolBarComboBoxEdit` class to create a toolbar button that behaves like an editable combo box control. ## Syntax diff --git a/docs/mfc/reference/cmfctoolbardatetimectrl-class.md b/docs/mfc/reference/cmfctoolbardatetimectrl-class.md index 367cba596e9..8e6ff7c4dea 100644 --- a/docs/mfc/reference/cmfctoolbardatetimectrl-class.md +++ b/docs/mfc/reference/cmfctoolbardatetimectrl-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarDateTimeCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarDateTimeCtrl", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::CMFCToolBarDateTimeCtrl", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::CanBeStretched", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::CopyFrom", "AFXTOOLBARDATETIMECTRL/CMFCToolBarButton::ExportToMenuButton", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::GetByCmd", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::GetDateTimeCtrl", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::GetHwnd", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::GetTime", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::GetTimeAll", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::HaveHotBorder", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::NotifyCommand", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::OnAddToCustomizePage", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::OnChangeParentWnd", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::OnClick", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::OnCtlColor", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::OnGlobalFontsChanged", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::OnMove", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::OnShow", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::OnUpdateToolTip", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::SetTime", "AFXTOOLBARDATETIMECTRL/CMFCToolBarDateTimeCtrl::SetTimeAll"] helpviewer_keywords: ["CMFCToolBarDateTimeCtrl [MFC], CMFCToolBarDateTimeCtrl", "CMFCToolBarDateTimeCtrl [MFC], CanBeStretched", "CMFCToolBarDateTimeCtrl [MFC], CopyFrom", "CMFCToolBarButton [MFC], ExportToMenuButton", "CMFCToolBarDateTimeCtrl [MFC], GetByCmd", "CMFCToolBarDateTimeCtrl [MFC], GetDateTimeCtrl", "CMFCToolBarDateTimeCtrl [MFC], GetHwnd", "CMFCToolBarDateTimeCtrl [MFC], GetTime", "CMFCToolBarDateTimeCtrl [MFC], GetTimeAll", "CMFCToolBarDateTimeCtrl [MFC], HaveHotBorder", "CMFCToolBarDateTimeCtrl [MFC], NotifyCommand", "CMFCToolBarDateTimeCtrl [MFC], OnAddToCustomizePage", "CMFCToolBarDateTimeCtrl [MFC], OnChangeParentWnd", "CMFCToolBarDateTimeCtrl [MFC], OnClick", "CMFCToolBarDateTimeCtrl [MFC], OnCtlColor", "CMFCToolBarDateTimeCtrl [MFC], OnGlobalFontsChanged", "CMFCToolBarDateTimeCtrl [MFC], OnMove", "CMFCToolBarDateTimeCtrl [MFC], OnShow", "CMFCToolBarDateTimeCtrl [MFC], OnUpdateToolTip", "CMFCToolBarDateTimeCtrl [MFC], SetTime", "CMFCToolBarDateTimeCtrl [MFC], SetTimeAll"] -ms.assetid: a3853cb9-8ebc-444f-a1e4-9cf905e24c18 --- # CMFCToolBarDateTimeCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A toolbar button that contains a date and time picker control. ## Syntax diff --git a/docs/mfc/reference/cmfctoolbareditboxbutton-class.md b/docs/mfc/reference/cmfctoolbareditboxbutton-class.md index bd00650204d..3d2790f18f1 100644 --- a/docs/mfc/reference/cmfctoolbareditboxbutton-class.md +++ b/docs/mfc/reference/cmfctoolbareditboxbutton-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarEditBoxButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarEditBoxButton", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::CMFCToolBarEditBoxButton", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::CanBeStretched", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::CopyFrom", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::GetByCmd", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::GetContentsAll", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::GetContextMenuID", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::GetEditBorder", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::GetHwnd", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::GetInvalidateRect", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::HaveHotBorder", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::IsFlatMode", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::NotifyCommand", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::OnAddToCustomizePage", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::OnChangeParentWnd", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::OnClick", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::OnCtlColor", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::OnGlobalFontsChanged", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::OnMove", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::OnShow", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::OnSize", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::OnUpdateToolTip", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::SetContextMenuID", "AFXTOOLBAREDITBOXBUTTON/CMFCToolBarEditBoxButton::SetFlatMode"] helpviewer_keywords: ["CMFCToolBarEditBoxButton [MFC], CMFCToolBarEditBoxButton", "CMFCToolBarEditBoxButton [MFC], CanBeStretched", "CMFCToolBarEditBoxButton [MFC], CopyFrom", "CMFCToolBarEditBoxButton [MFC], GetByCmd", "CMFCToolBarEditBoxButton [MFC], GetContentsAll", "CMFCToolBarEditBoxButton [MFC], GetContextMenuID", "CMFCToolBarEditBoxButton [MFC], GetEditBorder", "CMFCToolBarEditBoxButton [MFC], GetHwnd", "CMFCToolBarEditBoxButton [MFC], GetInvalidateRect", "CMFCToolBarEditBoxButton [MFC], HaveHotBorder", "CMFCToolBarEditBoxButton [MFC], IsFlatMode", "CMFCToolBarEditBoxButton [MFC], NotifyCommand", "CMFCToolBarEditBoxButton [MFC], OnAddToCustomizePage", "CMFCToolBarEditBoxButton [MFC], OnChangeParentWnd", "CMFCToolBarEditBoxButton [MFC], OnClick", "CMFCToolBarEditBoxButton [MFC], OnCtlColor", "CMFCToolBarEditBoxButton [MFC], OnGlobalFontsChanged", "CMFCToolBarEditBoxButton [MFC], OnMove", "CMFCToolBarEditBoxButton [MFC], OnShow", "CMFCToolBarEditBoxButton [MFC], OnSize", "CMFCToolBarEditBoxButton [MFC], OnUpdateToolTip", "CMFCToolBarEditBoxButton [MFC], SetContextMenuID", "CMFCToolBarEditBoxButton [MFC], SetFlatMode"] -ms.assetid: b21d9b67-6bf7-4ca9-bd62-b237756e0ab3 --- # CMFCToolBarEditBoxButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A toolbar button that contains an edit control ( [CEdit Class](../../mfc/reference/cedit-class.md)). ## Syntax diff --git a/docs/mfc/reference/cmfctoolbarfontcombobox-class.md b/docs/mfc/reference/cmfctoolbarfontcombobox-class.md index 4c8e05d3ad6..965f04c370b 100644 --- a/docs/mfc/reference/cmfctoolbarfontcombobox-class.md +++ b/docs/mfc/reference/cmfctoolbarfontcombobox-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarFontComboBox Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarFontComboBox", "AFXTOOLBARFONTCOMBOBOX/CMFCToolBarFontComboBox", "AFXTOOLBARFONTCOMBOBOX/CMFCToolBarFontComboBox::CMFCToolBarFontComboBox", "AFXTOOLBARFONTCOMBOBOX/CMFCToolBarFontComboBox::GetFontDesc", "AFXTOOLBARFONTCOMBOBOX/CMFCToolBarFontComboBox::SetFont"] helpviewer_keywords: ["CMFCToolBarFontComboBox [MFC], CMFCToolBarFontComboBox", "CMFCToolBarFontComboBox [MFC], GetFontDesc", "CMFCToolBarFontComboBox [MFC], SetFont"] -ms.assetid: 25f8e08c-aadd-4cb5-9581-a99d49d444b1 --- # CMFCToolBarFontComboBox Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A toolbar button that contains a combo box control that enables the user to select a font from a list of system fonts. ## Syntax diff --git a/docs/mfc/reference/cmfctoolbarfontsizecombobox-class.md b/docs/mfc/reference/cmfctoolbarfontsizecombobox-class.md index 8bb1581813f..7314ab35ff8 100644 --- a/docs/mfc/reference/cmfctoolbarfontsizecombobox-class.md +++ b/docs/mfc/reference/cmfctoolbarfontsizecombobox-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarFontSizeComboBox Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarFontSizeComboBox", "AFXTOOLBARFONTCOMBOBOX/CMFCToolBarFontSizeComboBox", "AFXTOOLBARFONTCOMBOBOX/CMFCToolBarFontSizeComboBox::CMFCToolBarFontSizeComboBox", "AFXTOOLBARFONTCOMBOBOX/CMFCToolBarFontSizeComboBox::GetTwipSize", "AFXTOOLBARFONTCOMBOBOX/CMFCToolBarFontSizeComboBox::RebuildFontSizes", "AFXTOOLBARFONTCOMBOBOX/CMFCToolBarFontSizeComboBox::SetTwipSize"] helpviewer_keywords: ["CMFCToolBarFontSizeComboBox [MFC], CMFCToolBarFontSizeComboBox", "CMFCToolBarFontSizeComboBox [MFC], GetTwipSize", "CMFCToolBarFontSizeComboBox [MFC], RebuildFontSizes", "CMFCToolBarFontSizeComboBox [MFC], SetTwipSize"] -ms.assetid: 72e0c44c-6a0e-4194-a71f-ab64e3afb9b5 --- # CMFCToolBarFontSizeComboBox Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A toolbar button that contains a combo box control that enables the user to select a font size. ## Syntax diff --git a/docs/mfc/reference/cmfctoolbarimages-class.md b/docs/mfc/reference/cmfctoolbarimages-class.md index 3fe00a3e0af..6a04928ba74 100644 --- a/docs/mfc/reference/cmfctoolbarimages-class.md +++ b/docs/mfc/reference/cmfctoolbarimages-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarImages Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarImages", "AFXTOOLBARIMAGES/CMFCToolBarImages", "AFXTOOLBARIMAGES/CMFCToolBarImages::CMFCToolBarImages", "AFXTOOLBARIMAGES/CMFCToolBarImages::AdaptColors", "AFXTOOLBARIMAGES/CMFCToolBarImages::AddIcon", "AFXTOOLBARIMAGES/CMFCToolBarImages::AddImage", "AFXTOOLBARIMAGES/CMFCToolBarImages::CleanUp", "AFXTOOLBARIMAGES/CMFCToolBarImages::Clear", "AFXTOOLBARIMAGES/CMFCToolBarImages::ConvertTo32Bits", "AFXTOOLBARIMAGES/CMFCToolBarImages::CopyImageToClipboard", "AFXTOOLBARIMAGES/CMFCToolBarImages::CopyTo", "AFXTOOLBARIMAGES/CMFCToolBarImages::CreateFromImageList", "AFXTOOLBARIMAGES/CMFCToolBarImages::CreateRegionFromImage", "AFXTOOLBARIMAGES/CMFCToolBarImages::DeleteImage", "AFXTOOLBARIMAGES/CMFCToolBarImages::Draw", "AFXTOOLBARIMAGES/CMFCToolBarImages::DrawEx", "AFXTOOLBARIMAGES/CMFCToolBarImages::EnableRTL", "AFXTOOLBARIMAGES/CMFCToolBarImages::EndDrawImage", "AFXTOOLBARIMAGES/CMFCToolBarImages::ExtractIcon", "AFXTOOLBARIMAGES/CMFCToolBarImages::FillDitheredRect", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetAlwaysLight", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetBitsPerPixel", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetCount", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetDisabledImageAlpha", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetFadedImageAlpha", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetImageSize", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetImageWell", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetImageWellLight", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetLastImageRect", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetLightPercentage", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetMapTo3DColors", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetMask", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetResourceOffset", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetScale", "AFXTOOLBARIMAGES/CMFCToolBarImages::GetTransparentColor", "AFXTOOLBARIMAGES/CMFCToolBarImages::GrayImages", "AFXTOOLBARIMAGES/CMFCToolBarImages::Is32BitTransparencySupported", "AFXTOOLBARIMAGES/CMFCToolBarImages::IsPreMultiplyAutoCheck", "AFXTOOLBARIMAGES/CMFCToolBarImages::IsRTL", "AFXTOOLBARIMAGES/CMFCToolBarImages::IsReadOnly", "AFXTOOLBARIMAGES/CMFCToolBarImages::IsScaled", "AFXTOOLBARIMAGES/CMFCToolBarImages::IsUserImagesList", "AFXTOOLBARIMAGES/CMFCToolBarImages::IsValid", "AFXTOOLBARIMAGES/CMFCToolBarImages::Load", "AFXTOOLBARIMAGES/CMFCToolBarImages::LoadStr", "AFXTOOLBARIMAGES/CMFCToolBarImages::MapFromSysColor", "AFXTOOLBARIMAGES/CMFCToolBarImages::MapTo3dColors", "AFXTOOLBARIMAGES/CMFCToolBarImages::MapToSysColor", "AFXTOOLBARIMAGES/CMFCToolBarImages::MapToSysColorAlpha", "AFXTOOLBARIMAGES/CMFCToolBarImages::Mirror", "AFXTOOLBARIMAGES/CMFCToolBarImages::MirrorBitmap", "AFXTOOLBARIMAGES/CMFCToolBarImages::MirrorBitmapVert", "AFXTOOLBARIMAGES/CMFCToolBarImages::MirrorVert", "AFXTOOLBARIMAGES/CMFCToolBarImages::OnSysColorChange", "AFXTOOLBARIMAGES/CMFCToolBarImages::PrepareDrawImage", "AFXTOOLBARIMAGES/CMFCToolBarImages::Save", "AFXTOOLBARIMAGES/CMFCToolBarImages::SetAlwaysLight", "AFXTOOLBARIMAGES/CMFCToolBarImages::SetDisabledImageAlpha", "AFXTOOLBARIMAGES/CMFCToolBarImages::SetFadedImageAlpha", "AFXTOOLBARIMAGES/CMFCToolBarImages::SetImageSize", "AFXTOOLBARIMAGES/CMFCToolBarImages::SetLightPercentage", "AFXTOOLBARIMAGES/CMFCToolBarImages::SetMapTo3DColors", "AFXTOOLBARIMAGES/CMFCToolBarImages::SetPreMultiplyAutoCheck", "AFXTOOLBARIMAGES/CMFCToolBarImages::SetSingleImage", "AFXTOOLBARIMAGES/CMFCToolBarImages::SetTransparentColor", "AFXTOOLBARIMAGES/CMFCToolBarImages::SmoothResize", "AFXTOOLBARIMAGES/CMFCToolBarImages::UpdateImage", "AFXTOOLBARIMAGES/CMFCToolBarImages::PreMultiplyAlpha", "AFXTOOLBARIMAGES/CMFCToolBarImages::m_bDisableTrueColorAlpha"] helpviewer_keywords: ["CMFCToolBarImages [MFC], CMFCToolBarImages", "CMFCToolBarImages [MFC], AdaptColors", "CMFCToolBarImages [MFC], AddIcon", "CMFCToolBarImages [MFC], AddImage", "CMFCToolBarImages [MFC], CleanUp", "CMFCToolBarImages [MFC], Clear", "CMFCToolBarImages [MFC], ConvertTo32Bits", "CMFCToolBarImages [MFC], CopyImageToClipboard", "CMFCToolBarImages [MFC], CopyTo", "CMFCToolBarImages [MFC], CreateFromImageList", "CMFCToolBarImages [MFC], CreateRegionFromImage", "CMFCToolBarImages [MFC], DeleteImage", "CMFCToolBarImages [MFC], Draw", "CMFCToolBarImages [MFC], DrawEx", "CMFCToolBarImages [MFC], EnableRTL", "CMFCToolBarImages [MFC], EndDrawImage", "CMFCToolBarImages [MFC], ExtractIcon", "CMFCToolBarImages [MFC], FillDitheredRect", "CMFCToolBarImages [MFC], GetAlwaysLight", "CMFCToolBarImages [MFC], GetBitsPerPixel", "CMFCToolBarImages [MFC], GetCount", "CMFCToolBarImages [MFC], GetDisabledImageAlpha", "CMFCToolBarImages [MFC], GetFadedImageAlpha", "CMFCToolBarImages [MFC], GetImageSize", "CMFCToolBarImages [MFC], GetImageWell", "CMFCToolBarImages [MFC], GetImageWellLight", "CMFCToolBarImages [MFC], GetLastImageRect", "CMFCToolBarImages [MFC], GetLightPercentage", "CMFCToolBarImages [MFC], GetMapTo3DColors", "CMFCToolBarImages [MFC], GetMask", "CMFCToolBarImages [MFC], GetResourceOffset", "CMFCToolBarImages [MFC], GetScale", "CMFCToolBarImages [MFC], GetTransparentColor", "CMFCToolBarImages [MFC], GrayImages", "CMFCToolBarImages [MFC], Is32BitTransparencySupported", "CMFCToolBarImages [MFC], IsPreMultiplyAutoCheck", "CMFCToolBarImages [MFC], IsRTL", "CMFCToolBarImages [MFC], IsReadOnly", "CMFCToolBarImages [MFC], IsScaled", "CMFCToolBarImages [MFC], IsUserImagesList", "CMFCToolBarImages [MFC], IsValid", "CMFCToolBarImages [MFC], Load", "CMFCToolBarImages [MFC], LoadStr", "CMFCToolBarImages [MFC], MapFromSysColor", "CMFCToolBarImages [MFC], MapTo3dColors", "CMFCToolBarImages [MFC], MapToSysColor", "CMFCToolBarImages [MFC], MapToSysColorAlpha", "CMFCToolBarImages [MFC], Mirror", "CMFCToolBarImages [MFC], MirrorBitmap", "CMFCToolBarImages [MFC], MirrorBitmapVert", "CMFCToolBarImages [MFC], MirrorVert", "CMFCToolBarImages [MFC], OnSysColorChange", "CMFCToolBarImages [MFC], PrepareDrawImage", "CMFCToolBarImages [MFC], Save", "CMFCToolBarImages [MFC], SetAlwaysLight", "CMFCToolBarImages [MFC], SetDisabledImageAlpha", "CMFCToolBarImages [MFC], SetFadedImageAlpha", "CMFCToolBarImages [MFC], SetImageSize", "CMFCToolBarImages [MFC], SetLightPercentage", "CMFCToolBarImages [MFC], SetMapTo3DColors", "CMFCToolBarImages [MFC], SetPreMultiplyAutoCheck", "CMFCToolBarImages [MFC], SetSingleImage", "CMFCToolBarImages [MFC], SetTransparentColor", "CMFCToolBarImages [MFC], SmoothResize", "CMFCToolBarImages [MFC], UpdateImage", "CMFCToolBarImages [MFC], PreMultiplyAlpha", "CMFCToolBarImages [MFC], m_bDisableTrueColorAlpha"] -ms.assetid: d4e50518-9ffc-406f-9996-f79e5cd38155 --- # CMFCToolBarImages Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The images on a toolbar. The `CMFCToolBarImages` class manages toolbar images loaded from application resources or from files. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfctoolbarinfo-class.md b/docs/mfc/reference/cmfctoolbarinfo-class.md index efec0c3afac..43a753a5169 100644 --- a/docs/mfc/reference/cmfctoolbarinfo-class.md +++ b/docs/mfc/reference/cmfctoolbarinfo-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarInfo Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarInfo", "AFXTOOLBAR/CMFCToolBarInfo", "AFXTOOLBAR/CMFCToolBarInfo::m_uiColdResID", "AFXTOOLBAR/CMFCToolBarInfo::m_uiDisabledResID", "AFXTOOLBAR/CMFCToolBarInfo::m_uiHotResID", "AFXTOOLBAR/CMFCToolBarInfo::m_uiLargeColdResID", "AFXTOOLBAR/CMFCToolBarInfo::m_uiLargeDisabledResID", "AFXTOOLBAR/CMFCToolBarInfo::m_uiLargeHotResID", "AFXTOOLBAR/CMFCToolBarInfo::m_uiMenuDisabledResID", "AFXTOOLBAR/CMFCToolBarInfo::m_uiMenuResID"] helpviewer_keywords: ["CMFCToolBarInfo [MFC], m_uiColdResID", "CMFCToolBarInfo [MFC], m_uiDisabledResID", "CMFCToolBarInfo [MFC], m_uiHotResID", "CMFCToolBarInfo [MFC], m_uiLargeColdResID", "CMFCToolBarInfo [MFC], m_uiLargeDisabledResID", "CMFCToolBarInfo [MFC], m_uiLargeHotResID", "CMFCToolBarInfo [MFC], m_uiMenuDisabledResID", "CMFCToolBarInfo [MFC], m_uiMenuResID"] -ms.assetid: 6dc84482-eaaa-491f-aa5d-dd7a57886b46 --- # CMFCToolBarInfo Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Contains the resource IDs of toolbar images in various states. `CMFCToolBarInfo` is a helper class that is used as a parameter of the [CMFCToolBar::LoadToolBarEx](../../mfc/reference/cmfctoolbar-class.md#loadtoolbarex) method. ## Syntax diff --git a/docs/mfc/reference/cmfctoolbarmenubutton-class.md b/docs/mfc/reference/cmfctoolbarmenubutton-class.md index 62f67ca32f7..aa9fbb43a60 100644 --- a/docs/mfc/reference/cmfctoolbarmenubutton-class.md +++ b/docs/mfc/reference/cmfctoolbarmenubutton-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarMenuButton Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarMenuButton", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::CMFCToolBarMenuButton", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::CompareWith", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::CopyFrom", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::CreateFromMenu", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::CreateMenu", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::CreatePopupMenu", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::EnableQuickCustomize", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::GetCommands", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::GetImageRect", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::GetPaletteRows", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::GetPopupMenu", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::HasButton", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::HaveHotBorder", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::IsBorder", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::IsClickedOnMenu", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::IsDroppedDown", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::IsEmptyMenuAllowed", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::IsExclusive", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::IsMenuPaletteMode", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::IsQuickMode", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::IsTearOffMenu", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnAfterCreatePopupMenu", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnBeforeDrag", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnCalculateSize", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnCancelMode", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnChangeParentWnd", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnClick", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnClickMenuItem", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnContextHelp", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnDraw", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OnDrawOnCustomizeList", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::OpenPopupMenu", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::ResetImageToDefault", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::SaveBarState", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::Serialize", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::SetACCData", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::SetMenuOnly", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::SetMenuPaletteMode", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::SetMessageWnd", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::SetRadio", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::SetTearOff", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::DrawDocumentIcon", "AFXTOOLBARMENUBUTTON/CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw"] helpviewer_keywords: ["CMFCToolBarMenuButton [MFC], CMFCToolBarMenuButton", "CMFCToolBarMenuButton [MFC], CompareWith", "CMFCToolBarMenuButton [MFC], CopyFrom", "CMFCToolBarMenuButton [MFC], CreateFromMenu", "CMFCToolBarMenuButton [MFC], CreateMenu", "CMFCToolBarMenuButton [MFC], CreatePopupMenu", "CMFCToolBarMenuButton [MFC], EnableQuickCustomize", "CMFCToolBarMenuButton [MFC], GetCommands", "CMFCToolBarMenuButton [MFC], GetImageRect", "CMFCToolBarMenuButton [MFC], GetPaletteRows", "CMFCToolBarMenuButton [MFC], GetPopupMenu", "CMFCToolBarMenuButton [MFC], HasButton", "CMFCToolBarMenuButton [MFC], HaveHotBorder", "CMFCToolBarMenuButton [MFC], IsBorder", "CMFCToolBarMenuButton [MFC], IsClickedOnMenu", "CMFCToolBarMenuButton [MFC], IsDroppedDown", "CMFCToolBarMenuButton [MFC], IsEmptyMenuAllowed", "CMFCToolBarMenuButton [MFC], IsExclusive", "CMFCToolBarMenuButton [MFC], IsMenuPaletteMode", "CMFCToolBarMenuButton [MFC], IsQuickMode", "CMFCToolBarMenuButton [MFC], IsTearOffMenu", "CMFCToolBarMenuButton [MFC], OnAfterCreatePopupMenu", "CMFCToolBarMenuButton [MFC], OnBeforeDrag", "CMFCToolBarMenuButton [MFC], OnCalculateSize", "CMFCToolBarMenuButton [MFC], OnCancelMode", "CMFCToolBarMenuButton [MFC], OnChangeParentWnd", "CMFCToolBarMenuButton [MFC], OnClick", "CMFCToolBarMenuButton [MFC], OnClickMenuItem", "CMFCToolBarMenuButton [MFC], OnContextHelp", "CMFCToolBarMenuButton [MFC], OnDraw", "CMFCToolBarMenuButton [MFC], OnDrawOnCustomizeList", "CMFCToolBarMenuButton [MFC], OpenPopupMenu", "CMFCToolBarMenuButton [MFC], ResetImageToDefault", "CMFCToolBarMenuButton [MFC], SaveBarState", "CMFCToolBarMenuButton [MFC], Serialize", "CMFCToolBarMenuButton [MFC], SetACCData", "CMFCToolBarMenuButton [MFC], SetMenuOnly", "CMFCToolBarMenuButton [MFC], SetMenuPaletteMode", "CMFCToolBarMenuButton [MFC], SetMessageWnd", "CMFCToolBarMenuButton [MFC], SetRadio", "CMFCToolBarMenuButton [MFC], SetTearOff", "CMFCToolBarMenuButton [MFC], DrawDocumentIcon", "CMFCToolBarMenuButton [MFC], m_bAlwaysCallOwnerDraw"] -ms.assetid: cfa50176-7e4b-4527-9904-86a1b48fc1bc --- # CMFCToolBarMenuButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A toolbar button that contains a pop-up menu. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfctoolbarscustomizedialog-class.md b/docs/mfc/reference/cmfctoolbarscustomizedialog-class.md index af756deef39..ab98d47944b 100644 --- a/docs/mfc/reference/cmfctoolbarscustomizedialog-class.md +++ b/docs/mfc/reference/cmfctoolbarscustomizedialog-class.md @@ -4,10 +4,12 @@ title: "CMFCToolBarsCustomizeDialog Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolBarsCustomizeDialog", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog::FillAllCommandsList", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog::FillCategoriesComboBox", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog::FillCategoriesListBox", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog::GetCommandName", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog::GetCountInCategory", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog::GetFlags", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog::OnInitDialog", "AFXTOOLBARSCUSTOMIZEDIALOG/CMFCToolBarsCustomizeDialog::PostNcDestroy"] helpviewer_keywords: ["CMFCToolBarsCustomizeDialog [MFC], CMFCToolBarsCustomizeDialog", "CMFCToolBarsCustomizeDialog [MFC], FillAllCommandsList", "CMFCToolBarsCustomizeDialog [MFC], FillCategoriesComboBox", "CMFCToolBarsCustomizeDialog [MFC], FillCategoriesListBox", "CMFCToolBarsCustomizeDialog [MFC], GetCommandName", "CMFCToolBarsCustomizeDialog [MFC], GetCountInCategory", "CMFCToolBarsCustomizeDialog [MFC], GetFlags", "CMFCToolBarsCustomizeDialog [MFC], OnInitDialog", "CMFCToolBarsCustomizeDialog [MFC], PostNcDestroy"] -ms.assetid: 78e2cddd-4f13-4097-afc3-1ad646a113f1 --- # CMFCToolBarsCustomizeDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A modeless tab dialog box ( [CPropertySheet Class](../../mfc/reference/cpropertysheet-class.md)) that enables the user to customize the toolbars, menus, keyboard shortcuts, user-defined tools, and visual style in an application. Typically, the user accesses this dialog box by selecting **Customize** from the **Tools** menu. The **Customize** dialog box has six tabs: **Commands**, **Toolbars**, **Tools**, **Keyboard**, **Menu**, and **Options**. diff --git a/docs/mfc/reference/cmfctooltipctrl-class.md b/docs/mfc/reference/cmfctooltipctrl-class.md index 9f75f1de911..9cf0b9adff4 100644 --- a/docs/mfc/reference/cmfctooltipctrl-class.md +++ b/docs/mfc/reference/cmfctooltipctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCToolTipCtrl [MFC], GetIconSize", "CMFCToolTipCtrl [MF --- # CMFCToolTipCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An extended tooltip implementation based on the [CToolTipCtrl Class](../../mfc/reference/ctooltipctrl-class.md). A tooltip based on the `CMFCToolTipCtrl` class can display an icon, a label, and a description. You can customize its visual appearance by using a gradient fill, custom text and border colors, bold text, rounded corners, or a balloon style. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfctooltipinfo-class.md b/docs/mfc/reference/cmfctooltipinfo-class.md index cefde9ab39f..4f9385a7fd7 100644 --- a/docs/mfc/reference/cmfctooltipinfo-class.md +++ b/docs/mfc/reference/cmfctooltipinfo-class.md @@ -4,10 +4,12 @@ title: "CMFCToolTipInfo Class" ms.date: "11/04/2016" f1_keywords: ["CMFCToolTipInfo", "AFXTOOLTIPCTRL/CMFCToolTipInfo", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_bBalloonTooltip", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_bBoldLabel", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_bDrawDescription", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_bDrawIcon", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_bDrawSeparator", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_bRoundedCorners", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_bVislManagerTheme", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_clrBorder", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_clrFill", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_clrFillGradient", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_clrText", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_nGradientAngle", "AFXTOOLTIPCTRL/CMFCToolTipInfo::m_nMaxDescrWidth"] helpviewer_keywords: ["CMFCToolTipInfo [MFC], m_bBalloonTooltip", "CMFCToolTipInfo [MFC], m_bBoldLabel", "CMFCToolTipInfo [MFC], m_bDrawDescription", "CMFCToolTipInfo [MFC], m_bDrawIcon", "CMFCToolTipInfo [MFC], m_bDrawSeparator", "CMFCToolTipInfo [MFC], m_bRoundedCorners", "CMFCToolTipInfo [MFC], m_bVislManagerTheme", "CMFCToolTipInfo [MFC], m_clrBorder", "CMFCToolTipInfo [MFC], m_clrFill", "CMFCToolTipInfo [MFC], m_clrFillGradient", "CMFCToolTipInfo [MFC], m_clrText", "CMFCToolTipInfo [MFC], m_nGradientAngle", "CMFCToolTipInfo [MFC], m_nMaxDescrWidth"] -ms.assetid: f9d3d7f8-1f08-4342-a7b2-683860e5d2a5 --- # CMFCToolTipInfo Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Stores information about the visual appearance of tooltips. ## Syntax diff --git a/docs/mfc/reference/cmfcvisualmanager-class.md b/docs/mfc/reference/cmfcvisualmanager-class.md index fe9a063078a..fbcf36dd516 100644 --- a/docs/mfc/reference/cmfcvisualmanager-class.md +++ b/docs/mfc/reference/cmfcvisualmanager-class.md @@ -4,10 +4,12 @@ title: "CMFCVisualManager Class" ms.date: "11/04/2016" f1_keywords: ["CMFCVisualManager", "AFXVISUALMANAGER/CMFCVisualManager", "AFXVISUALMANAGER/CMFCVisualManager::AdjustFrames", "AFXVISUALMANAGER/CMFCVisualManager::AdjustToolbars", "AFXVISUALMANAGER/CMFCVisualManager::AlwaysHighlight3DTabs", "AFXVISUALMANAGER/CMFCVisualManager::DestroyInstance", "AFXVISUALMANAGER/CMFCVisualManager::DoDrawHeaderSortArrow", "AFXVISUALMANAGER/CMFCVisualManager::DrawComboDropButtonWinXP", "AFXVISUALMANAGER/CMFCVisualManager::DrawPushButtonWinXP", "AFXVISUALMANAGER/CMFCVisualManager::DrawTextOnGlass", "AFXVISUALMANAGER/CMFCVisualManager::GetAutoHideButtonTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetButtonExtraBorder", "AFXVISUALMANAGER/CMFCVisualManager::GetCaptionBarTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetDockingTabsBordersSize", "AFXVISUALMANAGER/CMFCVisualManager::GetHighlightedMenuItemTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetInstance", "AFXVISUALMANAGER/CMFCVisualManager::GetMDITabsBordersSize", "AFXVISUALMANAGER/CMFCVisualManager::GetMenuItemTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetMenuShadowDepth", "AFXVISUALMANAGER/CMFCVisualManager::GetNcBtnSize", "AFXVISUALMANAGER/CMFCVisualManager::GetPopupMenuBorderSize", "AFXVISUALMANAGER/CMFCVisualManager::GetPropertyGridGroupColor", "AFXVISUALMANAGER/CMFCVisualManager::GetPropertyGridGroupTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetRibbonHyperlinkTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetRibbonPopupBorderSize", "AFXVISUALMANAGER/CMFCVisualManager::GetRibbonQuickAccessToolBarTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetRibbonSliderColors", "AFXVISUALMANAGER/CMFCVisualManager::GetShowAllMenuItemsHeight", "AFXVISUALMANAGER/CMFCVisualManager::GetSmartDockingBaseGuideColors", "AFXVISUALMANAGER/CMFCVisualManager::GetSmartDockingHighlightToneColor", "AFXVISUALMANAGER/CMFCVisualManager::GetSmartDockingTheme", "AFXVISUALMANAGER/CMFCVisualManager::GetStatusBarPaneTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetTabFrameColors", "AFXVISUALMANAGER/CMFCVisualManager::GetTabTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetToolbarButtonTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetToolbarDisabledTextColor", "AFXVISUALMANAGER/CMFCVisualManager::GetToolbarHighlightColor", "AFXVISUALMANAGER/CMFCVisualManager::GetToolTipInfo", "AFXVISUALMANAGER/CMFCVisualManager::HasOverlappedAutoHideButtons", "AFXVISUALMANAGER/CMFCVisualManager::IsDockingTabHasBorder", "AFXVISUALMANAGER/CMFCVisualManager::IsEmbossDisabledImage", "AFXVISUALMANAGER/CMFCVisualManager::IsFadeInactiveImage", "AFXVISUALMANAGER/CMFCVisualManager::IsMenuFlatLook", "AFXVISUALMANAGER/CMFCVisualManager::IsOfficeXPStyleMenus", "AFXVISUALMANAGER/CMFCVisualManager::IsOwnerDrawCaption", "AFXVISUALMANAGER/CMFCVisualManager::IsShadowHighlightedImage", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawAutoHideButtonBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawBarGripper", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawBrowseButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawButtonBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawButtonSeparator", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawCaptionBarBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawCaptionBarButtonBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawCaptionBarInfoArea", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawCaptionButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawCheckBox", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawCheckBoxEx", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawComboBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawComboDropButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawControlBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawDefaultRibbonImage", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawEditBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawExpandingBox", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawFloatingToolbarBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawHeaderCtrlBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawHeaderCtrlSortArrow", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMenuArrowOnCustomizeList", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMenuBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMenuCheck", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMenuItemButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMenuLabel", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMenuResizeBar", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMenuScrollButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMenuShadow", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMenuSystemButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawMiniFrameBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawOutlookBarSplitter", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawOutlookPageButtonBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawPaneBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawPaneCaption", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawPaneDivider", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawPopupWindowBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawPopupWindowButtonBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawPopupWindowCaption", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonApplicationButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonButtonBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonButtonsGroup", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonCaption", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonCaptionButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonCategory", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonCategoryCaption", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonCategoryScroll", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonCategoryTab", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonCheckBoxOnList", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonColorPaletteBox", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonDefaultPaneButtonContext", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonDefaultPaneButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonDefaultPaneButtonIndicator", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonGalleryBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonGalleryButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonKeyTip", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonLabel", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonMainPanelButtonBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonMainPanelFrame", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonMenuCheckFrame", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonPanel", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonPanelCaption", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonProgressBar", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonQuickAccessToolBarSeparator", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonRecentFilesFrame", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonSliderChannel", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonSliderThumb", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonSliderZoomButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonStatusBarPane", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawRibbonTabsFrame", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawScrollButtons", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawSeparator", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawShowAllMenuItems", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawSpinButtons", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawSplitterBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawSplitterBox", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawStatusBarPaneBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawStatusBarProgress", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawStatusBarSizeBox", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawTab", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawTabCloseButton", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawTabContent", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawTabsButtonBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawTask", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawTasksGroupAreaBorder", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawTasksGroupCaption", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawTasksGroupIcon", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawTearOffCaption", "AFXVISUALMANAGER/CMFCVisualManager::OnDrawToolBoxFrame", "AFXVISUALMANAGER/CMFCVisualManager::OnEraseMDIClientArea", "AFXVISUALMANAGER/CMFCVisualManager::OnErasePopupWindowButton", "AFXVISUALMANAGER/CMFCVisualManager::OnEraseTabsArea", "AFXVISUALMANAGER/CMFCVisualManager::OnEraseTabsButton", "AFXVISUALMANAGER/CMFCVisualManager::OnEraseTabsFrame", "AFXVISUALMANAGER/CMFCVisualManager::OnFillAutoHideButtonBackground", "AFXVISUALMANAGER/CMFCVisualManager::OnFillBarBackground", "AFXVISUALMANAGER/CMFCVisualManager::OnFillButtonInterior", "AFXVISUALMANAGER/CMFCVisualManager::OnFillCaptionBarButton", "AFXVISUALMANAGER/CMFCVisualManager::OnFillCommandsListBackground", "AFXVISUALMANAGER/CMFCVisualManager::OnFillHeaderCtrlBackground", "AFXVISUALMANAGER/CMFCVisualManager::OnFillMiniFrameCaption", "AFXVISUALMANAGER/CMFCVisualManager::OnFillOutlookBarCaption", "AFXVISUALMANAGER/CMFCVisualManager::OnFillOutlookPageButton", "AFXVISUALMANAGER/CMFCVisualManager::OnFillPopupWindowBackground", "AFXVISUALMANAGER/CMFCVisualManager::OnFillRibbonButton", "AFXVISUALMANAGER/CMFCVisualManager::OnFillRibbonEdit", "AFXVISUALMANAGER/CMFCVisualManager::OnFillRibbonMainPanelButton", "AFXVISUALMANAGER/CMFCVisualManager::OnFillRibbonMenuFrame", "AFXVISUALMANAGER/CMFCVisualManager::OnFillRibbonQuickAccessToolBarPopup", "AFXVISUALMANAGER/CMFCVisualManager::OnFillSplitterBackground", "AFXVISUALMANAGER/CMFCVisualManager::OnFillTab", "AFXVISUALMANAGER/CMFCVisualManager::OnFillTasksGroupInterior", "AFXVISUALMANAGER/CMFCVisualManager::OnFillTasksPaneBackground", "AFXVISUALMANAGER/CMFCVisualManager::OnHighlightMenuItem", "AFXVISUALMANAGER/CMFCVisualManager::OnHighlightRarelyUsedMenuItems", "AFXVISUALMANAGER/CMFCVisualManager::OnNcPaint", "AFXVISUALMANAGER/CMFCVisualManager::OnSetWindowRegion", "AFXVISUALMANAGER/CMFCVisualManager::OnUpdateSystemColors", "AFXVISUALMANAGER/CMFCVisualManager::RedrawAll", "AFXVISUALMANAGER/CMFCVisualManager::RibbonCategoryColorToRGB", "AFXVISUALMANAGER/CMFCVisualManager::SetDefaultManager", "AFXVISUALMANAGER/CMFCVisualManager::SetEmbossDisabledImage", "AFXVISUALMANAGER/CMFCVisualManager::SetFadeInactiveImage", "AFXVISUALMANAGER/CMFCVisualManager::SetMenuFlatLook", "AFXVISUALMANAGER/CMFCVisualManager::SetMenuShadowDepth", "AFXVISUALMANAGER/CMFCVisualManager::SetShadowHighlightedImage"] helpviewer_keywords: ["CMFCVisualManager [MFC], AdjustFrames", "CMFCVisualManager [MFC], AdjustToolbars", "CMFCVisualManager [MFC], AlwaysHighlight3DTabs", "CMFCVisualManager [MFC], DestroyInstance", "CMFCVisualManager [MFC], DoDrawHeaderSortArrow", "CMFCVisualManager [MFC], DrawComboDropButtonWinXP", "CMFCVisualManager [MFC], DrawPushButtonWinXP", "CMFCVisualManager [MFC], DrawTextOnGlass", "CMFCVisualManager [MFC], GetAutoHideButtonTextColor", "CMFCVisualManager [MFC], GetButtonExtraBorder", "CMFCVisualManager [MFC], GetCaptionBarTextColor", "CMFCVisualManager [MFC], GetDockingTabsBordersSize", "CMFCVisualManager [MFC], GetHighlightedMenuItemTextColor", "CMFCVisualManager [MFC], GetInstance", "CMFCVisualManager [MFC], GetMDITabsBordersSize", "CMFCVisualManager [MFC], GetMenuItemTextColor", "CMFCVisualManager [MFC], GetMenuShadowDepth", "CMFCVisualManager [MFC], GetNcBtnSize", "CMFCVisualManager [MFC], GetPopupMenuBorderSize", "CMFCVisualManager [MFC], GetPropertyGridGroupColor", "CMFCVisualManager [MFC], GetPropertyGridGroupTextColor", "CMFCVisualManager [MFC], GetRibbonHyperlinkTextColor", "CMFCVisualManager [MFC], GetRibbonPopupBorderSize", "CMFCVisualManager [MFC], GetRibbonQuickAccessToolBarTextColor", "CMFCVisualManager [MFC], GetRibbonSliderColors", "CMFCVisualManager [MFC], GetShowAllMenuItemsHeight", "CMFCVisualManager [MFC], GetSmartDockingBaseGuideColors", "CMFCVisualManager [MFC], GetSmartDockingHighlightToneColor", "CMFCVisualManager [MFC], GetSmartDockingTheme", "CMFCVisualManager [MFC], GetStatusBarPaneTextColor", "CMFCVisualManager [MFC], GetTabFrameColors", "CMFCVisualManager [MFC], GetTabTextColor", "CMFCVisualManager [MFC], GetToolbarButtonTextColor", "CMFCVisualManager [MFC], GetToolbarDisabledTextColor", "CMFCVisualManager [MFC], GetToolbarHighlightColor", "CMFCVisualManager [MFC], GetToolTipInfo", "CMFCVisualManager [MFC], HasOverlappedAutoHideButtons", "CMFCVisualManager [MFC], IsDockingTabHasBorder", "CMFCVisualManager [MFC], IsEmbossDisabledImage", "CMFCVisualManager [MFC], IsFadeInactiveImage", "CMFCVisualManager [MFC], IsMenuFlatLook", "CMFCVisualManager [MFC], IsOfficeXPStyleMenus", "CMFCVisualManager [MFC], IsOwnerDrawCaption", "CMFCVisualManager [MFC], IsShadowHighlightedImage", "CMFCVisualManager [MFC], OnDrawAutoHideButtonBorder", "CMFCVisualManager [MFC], OnDrawBarGripper", "CMFCVisualManager [MFC], OnDrawBrowseButton", "CMFCVisualManager [MFC], OnDrawButtonBorder", "CMFCVisualManager [MFC], OnDrawButtonSeparator", "CMFCVisualManager [MFC], OnDrawCaptionBarBorder", "CMFCVisualManager [MFC], OnDrawCaptionBarButtonBorder", "CMFCVisualManager [MFC], OnDrawCaptionBarInfoArea", "CMFCVisualManager [MFC], OnDrawCaptionButton", "CMFCVisualManager [MFC], OnDrawCheckBox", "CMFCVisualManager [MFC], OnDrawCheckBoxEx", "CMFCVisualManager [MFC], OnDrawComboBorder", "CMFCVisualManager [MFC], OnDrawComboDropButton", "CMFCVisualManager [MFC], OnDrawControlBorder", "CMFCVisualManager [MFC], OnDrawDefaultRibbonImage", "CMFCVisualManager [MFC], OnDrawEditBorder", "CMFCVisualManager [MFC], OnDrawExpandingBox", "CMFCVisualManager [MFC], OnDrawFloatingToolbarBorder", "CMFCVisualManager [MFC], OnDrawHeaderCtrlBorder", "CMFCVisualManager [MFC], OnDrawHeaderCtrlSortArrow", "CMFCVisualManager [MFC], OnDrawMenuArrowOnCustomizeList", "CMFCVisualManager [MFC], OnDrawMenuBorder", "CMFCVisualManager [MFC], OnDrawMenuCheck", "CMFCVisualManager [MFC], OnDrawMenuItemButton", "CMFCVisualManager [MFC], OnDrawMenuLabel", "CMFCVisualManager [MFC], OnDrawMenuResizeBar", "CMFCVisualManager [MFC], OnDrawMenuScrollButton", "CMFCVisualManager [MFC], OnDrawMenuShadow", "CMFCVisualManager [MFC], OnDrawMenuSystemButton", "CMFCVisualManager [MFC], OnDrawMiniFrameBorder", "CMFCVisualManager [MFC], OnDrawOutlookBarSplitter", "CMFCVisualManager [MFC], OnDrawOutlookPageButtonBorder", "CMFCVisualManager [MFC], OnDrawPaneBorder", "CMFCVisualManager [MFC], OnDrawPaneCaption", "CMFCVisualManager [MFC], OnDrawPaneDivider", "CMFCVisualManager [MFC], OnDrawPopupWindowBorder", "CMFCVisualManager [MFC], OnDrawPopupWindowButtonBorder", "CMFCVisualManager [MFC], OnDrawPopupWindowCaption", "CMFCVisualManager [MFC], OnDrawRibbonApplicationButton", "CMFCVisualManager [MFC], OnDrawRibbonButtonBorder", "CMFCVisualManager [MFC], OnDrawRibbonButtonsGroup", "CMFCVisualManager [MFC], OnDrawRibbonCaption", "CMFCVisualManager [MFC], OnDrawRibbonCaptionButton", "CMFCVisualManager [MFC], OnDrawRibbonCategory", "CMFCVisualManager [MFC], OnDrawRibbonCategoryCaption", "CMFCVisualManager [MFC], OnDrawRibbonCategoryScroll", "CMFCVisualManager [MFC], OnDrawRibbonCategoryTab", "CMFCVisualManager [MFC], OnDrawRibbonCheckBoxOnList", "CMFCVisualManager [MFC], OnDrawRibbonColorPaletteBox", "CMFCVisualManager [MFC], OnDrawRibbonDefaultPaneButtonContext", "CMFCVisualManager [MFC], OnDrawRibbonDefaultPaneButton", "CMFCVisualManager [MFC], OnDrawRibbonDefaultPaneButtonIndicator", "CMFCVisualManager [MFC], OnDrawRibbonGalleryBorder", "CMFCVisualManager [MFC], OnDrawRibbonGalleryButton", "CMFCVisualManager [MFC], OnDrawRibbonKeyTip", "CMFCVisualManager [MFC], OnDrawRibbonLabel", "CMFCVisualManager [MFC], OnDrawRibbonMainPanelButtonBorder", "CMFCVisualManager [MFC], OnDrawRibbonMainPanelFrame", "CMFCVisualManager [MFC], OnDrawRibbonMenuCheckFrame", "CMFCVisualManager [MFC], OnDrawRibbonPanel", "CMFCVisualManager [MFC], OnDrawRibbonPanelCaption", "CMFCVisualManager [MFC], OnDrawRibbonProgressBar", "CMFCVisualManager [MFC], OnDrawRibbonQuickAccessToolBarSeparator", "CMFCVisualManager [MFC], OnDrawRibbonRecentFilesFrame", "CMFCVisualManager [MFC], OnDrawRibbonSliderChannel", "CMFCVisualManager [MFC], OnDrawRibbonSliderThumb", "CMFCVisualManager [MFC], OnDrawRibbonSliderZoomButton", "CMFCVisualManager [MFC], OnDrawRibbonStatusBarPane", "CMFCVisualManager [MFC], OnDrawRibbonTabsFrame", "CMFCVisualManager [MFC], OnDrawScrollButtons", "CMFCVisualManager [MFC], OnDrawSeparator", "CMFCVisualManager [MFC], OnDrawShowAllMenuItems", "CMFCVisualManager [MFC], OnDrawSpinButtons", "CMFCVisualManager [MFC], OnDrawSplitterBorder", "CMFCVisualManager [MFC], OnDrawSplitterBox", "CMFCVisualManager [MFC], OnDrawStatusBarPaneBorder", "CMFCVisualManager [MFC], OnDrawStatusBarProgress", "CMFCVisualManager [MFC], OnDrawStatusBarSizeBox", "CMFCVisualManager [MFC], OnDrawTab", "CMFCVisualManager [MFC], OnDrawTabCloseButton", "CMFCVisualManager [MFC], OnDrawTabContent", "CMFCVisualManager [MFC], OnDrawTabsButtonBorder", "CMFCVisualManager [MFC], OnDrawTask", "CMFCVisualManager [MFC], OnDrawTasksGroupAreaBorder", "CMFCVisualManager [MFC], OnDrawTasksGroupCaption", "CMFCVisualManager [MFC], OnDrawTasksGroupIcon", "CMFCVisualManager [MFC], OnDrawTearOffCaption", "CMFCVisualManager [MFC], OnDrawToolBoxFrame", "CMFCVisualManager [MFC], OnEraseMDIClientArea", "CMFCVisualManager [MFC], OnErasePopupWindowButton", "CMFCVisualManager [MFC], OnEraseTabsArea", "CMFCVisualManager [MFC], OnEraseTabsButton", "CMFCVisualManager [MFC], OnEraseTabsFrame", "CMFCVisualManager [MFC], OnFillAutoHideButtonBackground", "CMFCVisualManager [MFC], OnFillBarBackground", "CMFCVisualManager [MFC], OnFillButtonInterior", "CMFCVisualManager [MFC], OnFillCaptionBarButton", "CMFCVisualManager [MFC], OnFillCommandsListBackground", "CMFCVisualManager [MFC], OnFillHeaderCtrlBackground", "CMFCVisualManager [MFC], OnFillMiniFrameCaption", "CMFCVisualManager [MFC], OnFillOutlookBarCaption", "CMFCVisualManager [MFC], OnFillOutlookPageButton", "CMFCVisualManager [MFC], OnFillPopupWindowBackground", "CMFCVisualManager [MFC], OnFillRibbonButton", "CMFCVisualManager [MFC], OnFillRibbonEdit", "CMFCVisualManager [MFC], OnFillRibbonMainPanelButton", "CMFCVisualManager [MFC], OnFillRibbonMenuFrame", "CMFCVisualManager [MFC], OnFillRibbonQuickAccessToolBarPopup", "CMFCVisualManager [MFC], OnFillSplitterBackground", "CMFCVisualManager [MFC], OnFillTab", "CMFCVisualManager [MFC], OnFillTasksGroupInterior", "CMFCVisualManager [MFC], OnFillTasksPaneBackground", "CMFCVisualManager [MFC], OnHighlightMenuItem", "CMFCVisualManager [MFC], OnHighlightRarelyUsedMenuItems", "CMFCVisualManager [MFC], OnNcPaint", "CMFCVisualManager [MFC], OnSetWindowRegion", "CMFCVisualManager [MFC], OnUpdateSystemColors", "CMFCVisualManager [MFC], RedrawAll", "CMFCVisualManager [MFC], RibbonCategoryColorToRGB", "CMFCVisualManager [MFC], SetDefaultManager", "CMFCVisualManager [MFC], SetEmbossDisabledImage", "CMFCVisualManager [MFC], SetFadeInactiveImage", "CMFCVisualManager [MFC], SetMenuFlatLook", "CMFCVisualManager [MFC], SetMenuShadowDepth", "CMFCVisualManager [MFC], SetShadowHighlightedImage"] -ms.assetid: beed80f7-36a2-4d64-9f09-e807cfefc3fe --- # CMFCVisualManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides support for changing the appearance of your application at a global level. The `CMFCVisualManager` class works together with a class that provides instructions to draw the GUI controls of your application using a consistent style. These other classes are referred to as visual managers and they inherit from `CMFCBaseVisualManager`. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcvisualmanageroffice2003-class.md b/docs/mfc/reference/cmfcvisualmanageroffice2003-class.md index b7e77059dcf..3ae383f3c4c 100644 --- a/docs/mfc/reference/cmfcvisualmanageroffice2003-class.md +++ b/docs/mfc/reference/cmfcvisualmanageroffice2003-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMFCVisualManagerOffice2003 Class [MFC]"] --- # CMFCVisualManagerOffice2003 Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CMFCVisualManagerOffice2003` gives an application a Microsoft Office 2003 appearance. ## Syntax diff --git a/docs/mfc/reference/cmfcvisualmanageroffice2007-class.md b/docs/mfc/reference/cmfcvisualmanageroffice2007-class.md index b0620fe6b8f..ee13a6682b2 100644 --- a/docs/mfc/reference/cmfcvisualmanageroffice2007-class.md +++ b/docs/mfc/reference/cmfcvisualmanageroffice2007-class.md @@ -4,10 +4,12 @@ title: "CMFCVisualManagerOffice2007 Class" ms.date: "11/04/2016" f1_keywords: ["CMFCVisualManagerOffice2007", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::AlwaysHighlight3DTabs", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::CleanStyle", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetCaptionBarTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetHighlightedMenuItemTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetMenuItemTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetNcBtnSize", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetRibbonBar", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetRibbonHyperlinkTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetRibbonPopupBorderSize", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetRibbonQuickAccessToolBarChevronOffset", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetRibbonQuickAccessToolBarRightMargin", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetRibbonQuickAccessToolBarTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetRibbonStatusBarTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetShowAllMenuItemsHeight", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetStatusBarPaneTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetTabFrameColors", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetTabHorzMargin", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetTabTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetToolbarButtonTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetToolbarDisabledTextColor", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::GetToolTipInfo", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::IsHighlightWholeMenuItem", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::IsLayeredRibbonKeyTip", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::IsOwnerDrawCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::IsOwnerDrawMenuCheck", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::IsRibbonPresent", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawBarGripper", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawButtonBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawButtonSeparator", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawCaptionBarInfoArea", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawCheckBoxEx", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawComboBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawComboDropButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawDefaultRibbonImage", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawEditBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawFloatingToolbarBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawHeaderCtrlBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawMenuBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawMenuCheck", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawMenuItemButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawMenuLabel", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawMenuResizeBar", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawMenuScrollButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawMenuSystemButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawMiniFrameBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawOutlookBarSplitter", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawOutlookPageButtonBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawPaneCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawPopupWindowCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawPropertySheetListItem", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonApplicationButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonButtonBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonButtonsGroup", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonCaptionButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonCategory", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonCategoryCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonCategoryScroll", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonCategoryTab", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonCheckBoxOnList", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonDefaultPaneButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonDefaultPaneButtonIndicator", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonGalleryBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonGalleryButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonKeyTip", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonMainPanelButtonBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonMainPanelFrame", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonMenuCheckFrame", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonPanel", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonPanelCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonProgressBar", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonRecentFilesFrame", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonSliderChannel", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonSliderThumb", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonSliderZoomButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonStatusBarPane", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawRibbonTabsFrame", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawScrollButtons", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawSeparator", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawShowAllMenuItems", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawStatusBarPaneBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawStatusBarSizeBox", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawTab", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawTabsButtonBorder", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawTask", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawTasksGroupCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnDrawTearOffCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnEraseMDIClientArea", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnEraseTabsArea", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnEraseTabsButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnEraseTabsFrame", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillBarBackground", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillButtonInterior", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillCaptionBarButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillHighlightedArea", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillMiniFrameCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillOutlookBarCaption", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillOutlookPageButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillPopupWindowBackground", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillRibbonButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillRibbonEdit", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillRibbonMainPanelButton", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillRibbonMenuFrame", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillRibbonQuickAccessToolBarPopup", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnFillTab", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnHighlightMenuItem", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnHighlightRarelyUsedMenuItems", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnNcActivate", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnNcPaint", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnSetWindowRegion", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::OnUpdateSystemColors", "AFXVISUALMANAGEROFFICE2007/CMFCVisualManagerOffice2007::SetResourceHandle"] helpviewer_keywords: ["CMFCVisualManagerOffice2007 [MFC], AlwaysHighlight3DTabs", "CMFCVisualManagerOffice2007 [MFC], CleanStyle", "CMFCVisualManagerOffice2007 [MFC], GetCaptionBarTextColor", "CMFCVisualManagerOffice2007 [MFC], GetHighlightedMenuItemTextColor", "CMFCVisualManagerOffice2007 [MFC], GetMenuItemTextColor", "CMFCVisualManagerOffice2007 [MFC], GetNcBtnSize", "CMFCVisualManagerOffice2007 [MFC], GetRibbonBar", "CMFCVisualManagerOffice2007 [MFC], GetRibbonHyperlinkTextColor", "CMFCVisualManagerOffice2007 [MFC], GetRibbonPopupBorderSize", "CMFCVisualManagerOffice2007 [MFC], GetRibbonQuickAccessToolBarChevronOffset", "CMFCVisualManagerOffice2007 [MFC], GetRibbonQuickAccessToolBarRightMargin", "CMFCVisualManagerOffice2007 [MFC], GetRibbonQuickAccessToolBarTextColor", "CMFCVisualManagerOffice2007 [MFC], GetRibbonStatusBarTextColor", "CMFCVisualManagerOffice2007 [MFC], GetShowAllMenuItemsHeight", "CMFCVisualManagerOffice2007 [MFC], GetStatusBarPaneTextColor", "CMFCVisualManagerOffice2007 [MFC], GetTabFrameColors", "CMFCVisualManagerOffice2007 [MFC], GetTabHorzMargin", "CMFCVisualManagerOffice2007 [MFC], GetTabTextColor", "CMFCVisualManagerOffice2007 [MFC], GetToolbarButtonTextColor", "CMFCVisualManagerOffice2007 [MFC], GetToolbarDisabledTextColor", "CMFCVisualManagerOffice2007 [MFC], GetToolTipInfo", "CMFCVisualManagerOffice2007 [MFC], IsHighlightWholeMenuItem", "CMFCVisualManagerOffice2007 [MFC], IsLayeredRibbonKeyTip", "CMFCVisualManagerOffice2007 [MFC], IsOwnerDrawCaption", "CMFCVisualManagerOffice2007 [MFC], IsOwnerDrawMenuCheck", "CMFCVisualManagerOffice2007 [MFC], IsRibbonPresent", "CMFCVisualManagerOffice2007 [MFC], OnDrawBarGripper", "CMFCVisualManagerOffice2007 [MFC], OnDrawButtonBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawButtonSeparator", "CMFCVisualManagerOffice2007 [MFC], OnDrawCaptionBarInfoArea", "CMFCVisualManagerOffice2007 [MFC], OnDrawCheckBoxEx", "CMFCVisualManagerOffice2007 [MFC], OnDrawComboBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawComboDropButton", "CMFCVisualManagerOffice2007 [MFC], OnDrawDefaultRibbonImage", "CMFCVisualManagerOffice2007 [MFC], OnDrawEditBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawFloatingToolbarBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawHeaderCtrlBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawMenuBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawMenuCheck", "CMFCVisualManagerOffice2007 [MFC], OnDrawMenuItemButton", "CMFCVisualManagerOffice2007 [MFC], OnDrawMenuLabel", "CMFCVisualManagerOffice2007 [MFC], OnDrawMenuResizeBar", "CMFCVisualManagerOffice2007 [MFC], OnDrawMenuScrollButton", "CMFCVisualManagerOffice2007 [MFC], OnDrawMenuSystemButton", "CMFCVisualManagerOffice2007 [MFC], OnDrawMiniFrameBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawOutlookBarSplitter", "CMFCVisualManagerOffice2007 [MFC], OnDrawOutlookPageButtonBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawPaneCaption", "CMFCVisualManagerOffice2007 [MFC], OnDrawPopupWindowCaption", "CMFCVisualManagerOffice2007 [MFC], OnDrawPropertySheetListItem", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonApplicationButton", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonButtonBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonButtonsGroup", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonCaption", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonCaptionButton", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonCategory", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonCategoryCaption", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonCategoryScroll", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonCategoryTab", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonCheckBoxOnList", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonDefaultPaneButton", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonDefaultPaneButtonIndicator", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonGalleryBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonGalleryButton", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonKeyTip", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonMainPanelButtonBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonMainPanelFrame", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonMenuCheckFrame", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonPanel", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonPanelCaption", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonProgressBar", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonRecentFilesFrame", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonSliderChannel", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonSliderThumb", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonSliderZoomButton", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonStatusBarPane", "CMFCVisualManagerOffice2007 [MFC], OnDrawRibbonTabsFrame", "CMFCVisualManagerOffice2007 [MFC], OnDrawScrollButtons", "CMFCVisualManagerOffice2007 [MFC], OnDrawSeparator", "CMFCVisualManagerOffice2007 [MFC], OnDrawShowAllMenuItems", "CMFCVisualManagerOffice2007 [MFC], OnDrawStatusBarPaneBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawStatusBarSizeBox", "CMFCVisualManagerOffice2007 [MFC], OnDrawTab", "CMFCVisualManagerOffice2007 [MFC], OnDrawTabsButtonBorder", "CMFCVisualManagerOffice2007 [MFC], OnDrawTask", "CMFCVisualManagerOffice2007 [MFC], OnDrawTasksGroupCaption", "CMFCVisualManagerOffice2007 [MFC], OnDrawTearOffCaption", "CMFCVisualManagerOffice2007 [MFC], OnEraseMDIClientArea", "CMFCVisualManagerOffice2007 [MFC], OnEraseTabsArea", "CMFCVisualManagerOffice2007 [MFC], OnEraseTabsButton", "CMFCVisualManagerOffice2007 [MFC], OnEraseTabsFrame", "CMFCVisualManagerOffice2007 [MFC], OnFillBarBackground", "CMFCVisualManagerOffice2007 [MFC], OnFillButtonInterior", "CMFCVisualManagerOffice2007 [MFC], OnFillCaptionBarButton", "CMFCVisualManagerOffice2007 [MFC], OnFillHighlightedArea", "CMFCVisualManagerOffice2007 [MFC], OnFillMiniFrameCaption", "CMFCVisualManagerOffice2007 [MFC], OnFillOutlookBarCaption", "CMFCVisualManagerOffice2007 [MFC], OnFillOutlookPageButton", "CMFCVisualManagerOffice2007 [MFC], OnFillPopupWindowBackground", "CMFCVisualManagerOffice2007 [MFC], OnFillRibbonButton", "CMFCVisualManagerOffice2007 [MFC], OnFillRibbonEdit", "CMFCVisualManagerOffice2007 [MFC], OnFillRibbonMainPanelButton", "CMFCVisualManagerOffice2007 [MFC], OnFillRibbonMenuFrame", "CMFCVisualManagerOffice2007 [MFC], OnFillRibbonQuickAccessToolBarPopup", "CMFCVisualManagerOffice2007 [MFC], OnFillTab", "CMFCVisualManagerOffice2007 [MFC], OnHighlightMenuItem", "CMFCVisualManagerOffice2007 [MFC], OnHighlightRarelyUsedMenuItems", "CMFCVisualManagerOffice2007 [MFC], OnNcActivate", "CMFCVisualManagerOffice2007 [MFC], OnNcPaint", "CMFCVisualManagerOffice2007 [MFC], OnSetWindowRegion", "CMFCVisualManagerOffice2007 [MFC], OnUpdateSystemColors", "CMFCVisualManagerOffice2007 [MFC], SetResourceHandle"] -ms.assetid: fb687c74-6d08-4c72-8acf-27f75dda6d6b --- # CMFCVisualManagerOffice2007 Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CMFCVisualManagerOffice2007` gives an application a Microsoft Office 2007 appearance. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcvisualmanagerofficexp-class.md b/docs/mfc/reference/cmfcvisualmanagerofficexp-class.md index ed358d6d4d4..4639abf5286 100644 --- a/docs/mfc/reference/cmfcvisualmanagerofficexp-class.md +++ b/docs/mfc/reference/cmfcvisualmanagerofficexp-class.md @@ -4,10 +4,12 @@ title: "CMFCVisualManagerOfficeXP Class" ms.date: "11/04/2016" f1_keywords: ["CMFCVisualManagerOfficeXP"] helpviewer_keywords: ["CMFCVisualManagerOfficeXP class [MFC]"] -ms.assetid: 46b6f854-37c2-4836-8f56-5cb6ff63c9af --- # CMFCVisualManagerOfficeXP Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCVisualManagerOfficeXP` gives an application a Microsoft Office XP appearance. ## Syntax diff --git a/docs/mfc/reference/cmfcvisualmanagervs2005-class.md b/docs/mfc/reference/cmfcvisualmanagervs2005-class.md index 4f612c6a6dc..0fd63adf20a 100644 --- a/docs/mfc/reference/cmfcvisualmanagervs2005-class.md +++ b/docs/mfc/reference/cmfcvisualmanagervs2005-class.md @@ -4,10 +4,12 @@ title: "CMFCVisualManagerVS2005 Class" ms.date: "11/04/2016" f1_keywords: ["CMFCVisualManagerVS2005", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::GetDockingTabsBordersSize", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::GetMDITabsBordersSize", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::GetPropertyGridGroupColor", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::GetTabFrameColors", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::HasOverlappedAutoHideButtons", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnDrawAutoHideButtonBorder", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnDrawCaptionButton", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnDrawPaneCaption", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnDrawSeparator", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnDrawTab", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnDrawToolBoxFrame", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnEraseTabsArea", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnFillAutoHideButtonBackground", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnFillHighlightedArea", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnFillMiniFrameCaption", "AFXVISUALMANAGERVS2005/CMFCVisualManagerVS2005::OnUpdateSystemColors"] helpviewer_keywords: ["CMFCVisualManagerVS2005 [MFC], GetDockingTabsBordersSize", "CMFCVisualManagerVS2005 [MFC], GetMDITabsBordersSize", "CMFCVisualManagerVS2005 [MFC], GetPropertyGridGroupColor", "CMFCVisualManagerVS2005 [MFC], GetTabFrameColors", "CMFCVisualManagerVS2005 [MFC], HasOverlappedAutoHideButtons", "CMFCVisualManagerVS2005 [MFC], OnDrawAutoHideButtonBorder", "CMFCVisualManagerVS2005 [MFC], OnDrawCaptionButton", "CMFCVisualManagerVS2005 [MFC], OnDrawPaneCaption", "CMFCVisualManagerVS2005 [MFC], OnDrawSeparator", "CMFCVisualManagerVS2005 [MFC], OnDrawTab", "CMFCVisualManagerVS2005 [MFC], OnDrawToolBoxFrame", "CMFCVisualManagerVS2005 [MFC], OnEraseTabsArea", "CMFCVisualManagerVS2005 [MFC], OnFillAutoHideButtonBackground", "CMFCVisualManagerVS2005 [MFC], OnFillHighlightedArea", "CMFCVisualManagerVS2005 [MFC], OnFillMiniFrameCaption", "CMFCVisualManagerVS2005 [MFC], OnUpdateSystemColors"] -ms.assetid: ea39b9ae-327e-4a51-bce7-dc84c78f005b --- # CMFCVisualManagerVS2005 Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CMFCVisualManagerVS2005` gives an application a Microsoft Visual Studio 2005 appearance. ## Syntax diff --git a/docs/mfc/reference/cmfcvisualmanagerwindows-class.md b/docs/mfc/reference/cmfcvisualmanagerwindows-class.md index 6579ed1aba2..0149e9a9721 100644 --- a/docs/mfc/reference/cmfcvisualmanagerwindows-class.md +++ b/docs/mfc/reference/cmfcvisualmanagerwindows-class.md @@ -4,10 +4,12 @@ title: "CMFCVisualManagerWindows Class" ms.date: "11/04/2016" f1_keywords: ["CMFCVisualManagerWindows", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::AlwaysHighlight3DTabs", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::DrawComboBorderWinXP", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::DrawComboDropButtonWinXP", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::DrawPushButtonWinXP", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::GetButtonExtraBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::GetCaptionButtonExtraBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::GetDockingPaneCaptionExtraHeight", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::GetHighlightedMenuItemTextColor", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::GetPopupMenuGap", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::GetToolbarButtonTextColor", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::IsDefaultWinXPPopupButton", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::IsHighlightWholeMenuItem", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::IsOfficeStyleMenus", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::IsOfficeXPStyleMenus", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::IsWindowsThemingSupported", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::IsWinXPThemeAvailable", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawBarGripper", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawBrowseButton", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawButtonBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawButtonSeparator", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawCaptionButton", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawCaptionButtonIcon", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawCheckBoxEx", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawComboBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawComboDropButton", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawControlBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawEditBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawExpandingBox", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawFloatingToolbarBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawHeaderCtrlBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawHeaderCtrlSortArrow", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawMenuBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawMenuSystemButton", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawMiniFrameBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawOutlookPageButtonBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawPaneBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawPaneCaption", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawPopupWindowButtonBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawScrollButtons", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawSeparator", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawSpinButtons", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawStatusBarPaneBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawStatusBarProgress", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawStatusBarSizeBox", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawTab", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawTabCloseButton", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawTabsButtonBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawTask", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawTasksGroupAreaBorder", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawTasksGroupCaption", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnDrawTearOffCaption", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnErasePopupWindowButton", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnEraseTabsArea", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnEraseTabsButton", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnEraseTabsFrame", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnFillBarBackground", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnFillButtonInterior", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnFillCommandsListBackground", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnFillMiniFrameCaption", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnFillOutlookPageButton", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnFillTasksGroupInterior", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnFillTasksPaneBackground", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnHighlightMenuItem", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnHighlightRarelyUsedMenuItems", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::OnUpdateSystemColors", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::SetOfficeStyleMenus", "AFXVISUALMANAGERWINDOWS/CMFCVisualManagerWindows::m_b3DTabsXPTheme"] helpviewer_keywords: ["CMFCVisualManagerWindows [MFC], AlwaysHighlight3DTabs", "CMFCVisualManagerWindows [MFC], DrawComboBorderWinXP", "CMFCVisualManagerWindows [MFC], DrawComboDropButtonWinXP", "CMFCVisualManagerWindows [MFC], DrawPushButtonWinXP", "CMFCVisualManagerWindows [MFC], GetButtonExtraBorder", "CMFCVisualManagerWindows [MFC], GetCaptionButtonExtraBorder", "CMFCVisualManagerWindows [MFC], GetDockingPaneCaptionExtraHeight", "CMFCVisualManagerWindows [MFC], GetHighlightedMenuItemTextColor", "CMFCVisualManagerWindows [MFC], GetPopupMenuGap", "CMFCVisualManagerWindows [MFC], GetToolbarButtonTextColor", "CMFCVisualManagerWindows [MFC], IsDefaultWinXPPopupButton", "CMFCVisualManagerWindows [MFC], IsHighlightWholeMenuItem", "CMFCVisualManagerWindows [MFC], IsOfficeStyleMenus", "CMFCVisualManagerWindows [MFC], IsOfficeXPStyleMenus", "CMFCVisualManagerWindows [MFC], IsWindowsThemingSupported", "CMFCVisualManagerWindows [MFC], IsWinXPThemeAvailable", "CMFCVisualManagerWindows [MFC], OnDrawBarGripper", "CMFCVisualManagerWindows [MFC], OnDrawBrowseButton", "CMFCVisualManagerWindows [MFC], OnDrawButtonBorder", "CMFCVisualManagerWindows [MFC], OnDrawButtonSeparator", "CMFCVisualManagerWindows [MFC], OnDrawCaptionButton", "CMFCVisualManagerWindows [MFC], OnDrawCaptionButtonIcon", "CMFCVisualManagerWindows [MFC], OnDrawCheckBoxEx", "CMFCVisualManagerWindows [MFC], OnDrawComboBorder", "CMFCVisualManagerWindows [MFC], OnDrawComboDropButton", "CMFCVisualManagerWindows [MFC], OnDrawControlBorder", "CMFCVisualManagerWindows [MFC], OnDrawEditBorder", "CMFCVisualManagerWindows [MFC], OnDrawExpandingBox", "CMFCVisualManagerWindows [MFC], OnDrawFloatingToolbarBorder", "CMFCVisualManagerWindows [MFC], OnDrawHeaderCtrlBorder", "CMFCVisualManagerWindows [MFC], OnDrawHeaderCtrlSortArrow", "CMFCVisualManagerWindows [MFC], OnDrawMenuBorder", "CMFCVisualManagerWindows [MFC], OnDrawMenuSystemButton", "CMFCVisualManagerWindows [MFC], OnDrawMiniFrameBorder", "CMFCVisualManagerWindows [MFC], OnDrawOutlookPageButtonBorder", "CMFCVisualManagerWindows [MFC], OnDrawPaneBorder", "CMFCVisualManagerWindows [MFC], OnDrawPaneCaption", "CMFCVisualManagerWindows [MFC], OnDrawPopupWindowButtonBorder", "CMFCVisualManagerWindows [MFC], OnDrawScrollButtons", "CMFCVisualManagerWindows [MFC], OnDrawSeparator", "CMFCVisualManagerWindows [MFC], OnDrawSpinButtons", "CMFCVisualManagerWindows [MFC], OnDrawStatusBarPaneBorder", "CMFCVisualManagerWindows [MFC], OnDrawStatusBarProgress", "CMFCVisualManagerWindows [MFC], OnDrawStatusBarSizeBox", "CMFCVisualManagerWindows [MFC], OnDrawTab", "CMFCVisualManagerWindows [MFC], OnDrawTabCloseButton", "CMFCVisualManagerWindows [MFC], OnDrawTabsButtonBorder", "CMFCVisualManagerWindows [MFC], OnDrawTask", "CMFCVisualManagerWindows [MFC], OnDrawTasksGroupAreaBorder", "CMFCVisualManagerWindows [MFC], OnDrawTasksGroupCaption", "CMFCVisualManagerWindows [MFC], OnDrawTearOffCaption", "CMFCVisualManagerWindows [MFC], OnErasePopupWindowButton", "CMFCVisualManagerWindows [MFC], OnEraseTabsArea", "CMFCVisualManagerWindows [MFC], OnEraseTabsButton", "CMFCVisualManagerWindows [MFC], OnEraseTabsFrame", "CMFCVisualManagerWindows [MFC], OnFillBarBackground", "CMFCVisualManagerWindows [MFC], OnFillButtonInterior", "CMFCVisualManagerWindows [MFC], OnFillCommandsListBackground", "CMFCVisualManagerWindows [MFC], OnFillMiniFrameCaption", "CMFCVisualManagerWindows [MFC], OnFillOutlookPageButton", "CMFCVisualManagerWindows [MFC], OnFillTasksGroupInterior", "CMFCVisualManagerWindows [MFC], OnFillTasksPaneBackground", "CMFCVisualManagerWindows [MFC], OnHighlightMenuItem", "CMFCVisualManagerWindows [MFC], OnHighlightRarelyUsedMenuItems", "CMFCVisualManagerWindows [MFC], OnUpdateSystemColors", "CMFCVisualManagerWindows [MFC], SetOfficeStyleMenus", "CMFCVisualManagerWindows [MFC], m_b3DTabsXPTheme"] -ms.assetid: 568b6e9e-8e67-4477-9a3d-2981cbd09861 --- # CMFCVisualManagerWindows Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CMFCVisualManagerWindows` mimics the appearance of Microsoft Windows XP or Microsoft Vista when the user selects a Windows XP or Vista theme. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmfcvisualmanagerwindows7-class.md b/docs/mfc/reference/cmfcvisualmanagerwindows7-class.md index d354cd2cc54..d2e9935e2e3 100644 --- a/docs/mfc/reference/cmfcvisualmanagerwindows7-class.md +++ b/docs/mfc/reference/cmfcvisualmanagerwindows7-class.md @@ -4,10 +4,12 @@ title: "CMFCVisualManagerWindows7 Class" ms.date: "03/27/2019" f1_keywords: ["CMFCVisualManagerWindows7", "AFXVISUALMANAGERWINDOWS7/CMFCVisualManagerWindows7", "AFXVISUALMANAGERWINDOWS7/CMFCVisualManagerWindows7::CMFCVisualManagerWindows7", "AFXVISUALMANAGERWINDOWS7/CMFCVisualManagerWindows7::GetRibbonEditBackgroundColor", "AFXVISUALMANAGERWINDOWS7/CMFCVisualManagerWindows7::OnFillMenuImageRect"] helpviewer_keywords: ["CMFCVisualManagerWindows7 Class [MFC]"] -ms.assetid: e8d87df1-0c09-4b58-8ade-4e911f796e42 --- # CMFCVisualManagerWindows7 Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCVisualManagerWindows7` gives an application the appearance of a Windows 7 application. ## Syntax diff --git a/docs/mfc/reference/cmfcwindowsmanagerdialog-class.md b/docs/mfc/reference/cmfcwindowsmanagerdialog-class.md index 3e82d4901f0..6e5f503419b 100644 --- a/docs/mfc/reference/cmfcwindowsmanagerdialog-class.md +++ b/docs/mfc/reference/cmfcwindowsmanagerdialog-class.md @@ -4,10 +4,12 @@ title: "CMFCWindowsManagerDialog Class" ms.date: "11/04/2016" f1_keywords: ["CMFCWindowsManagerDialog", "AFXWINDOWSMANAGERDIALOG/CMFCWindowsManagerDialog", "AFXWINDOWSMANAGERDIALOG/CMFCWindowsManagerDialog::CMFCWindowsManagerDialog"] helpviewer_keywords: ["CMFCWindowsManagerDialog [MFC], CMFCWindowsManagerDialog"] -ms.assetid: 35b4b0db-33c4-4b22-94d8-5e3396341340 --- # CMFCWindowsManagerDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMFCWindowsManagerDialog` object enables a user to manage MDI child windows in a MDI application. ## Syntax diff --git a/docs/mfc/reference/cminiframewnd-class.md b/docs/mfc/reference/cminiframewnd-class.md index c62e43effd8..ba3f3abbdb4 100644 --- a/docs/mfc/reference/cminiframewnd-class.md +++ b/docs/mfc/reference/cminiframewnd-class.md @@ -4,10 +4,12 @@ title: "CMiniFrameWnd Class" ms.date: "11/04/2016" f1_keywords: ["CMiniFrameWnd", "AFXWIN/CMiniFrameWnd", "AFXWIN/CMiniFrameWnd::CMiniFrameWnd", "AFXWIN/CMiniFrameWnd::Create", "AFXWIN/CMiniFrameWnd::CreateEx"] helpviewer_keywords: ["CMiniFrameWnd [MFC], CMiniFrameWnd", "CMiniFrameWnd [MFC], Create", "CMiniFrameWnd [MFC], CreateEx"] -ms.assetid: b8f534ed-0532-4d8e-9657-5595cf677749 --- # CMiniFrameWnd Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a half-height frame window typically seen around floating toolbars. ## Syntax diff --git a/docs/mfc/reference/cmonikerfile-class.md b/docs/mfc/reference/cmonikerfile-class.md index 56e7b9dac14..74ff22caf0c 100644 --- a/docs/mfc/reference/cmonikerfile-class.md +++ b/docs/mfc/reference/cmonikerfile-class.md @@ -4,10 +4,12 @@ title: "CMonikerFile Class" ms.date: "11/04/2016" f1_keywords: ["CMonikerFile", "AFXOLE/CMonikerFile", "AFXOLE/CMonikerFile::CMonikerFile", "AFXOLE/CMonikerFile::Close", "AFXOLE/CMonikerFile::Detach", "AFXOLE/CMonikerFile::GetMoniker", "AFXOLE/CMonikerFile::Open", "AFXOLE/CMonikerFile::CreateBindContext"] helpviewer_keywords: ["CMonikerFile [MFC], CMonikerFile", "CMonikerFile [MFC], Close", "CMonikerFile [MFC], Detach", "CMonikerFile [MFC], GetMoniker", "CMonikerFile [MFC], Open", "CMonikerFile [MFC], CreateBindContext"] -ms.assetid: 87be5966-f4f7-4235-bce2-1fa39e9417de --- # CMonikerFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a stream of data ( [IStream](/windows/win32/api/objidl/nn-objidl-istream)) named by an [IMoniker](/windows/win32/api/objidl/nn-objidl-imoniker). ## Syntax diff --git a/docs/mfc/reference/cmonthcalctrl-class.md b/docs/mfc/reference/cmonthcalctrl-class.md index e9ce4d517d5..033259412cf 100644 --- a/docs/mfc/reference/cmonthcalctrl-class.md +++ b/docs/mfc/reference/cmonthcalctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMonthCalCtrl [MFC], CMonthCalCtrl", "CMonthCalCtrl [MFC] --- # CMonthCalCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the functionality of a month calendar control. ## Syntax diff --git a/docs/mfc/reference/cmousemanager-class.md b/docs/mfc/reference/cmousemanager-class.md index 92e14a9af3f..1f133903fae 100644 --- a/docs/mfc/reference/cmousemanager-class.md +++ b/docs/mfc/reference/cmousemanager-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CMouseManager [MFC], AddView", "CMouseManager [MFC], GetV --- # CMouseManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allows a user to associate different commands with a particular [CView](../../mfc/reference/cview-class.md) object when the user double-clicks inside that view. ## Syntax diff --git a/docs/mfc/reference/cmultidoctemplate-class.md b/docs/mfc/reference/cmultidoctemplate-class.md index c103e3e9a82..532ac98e884 100644 --- a/docs/mfc/reference/cmultidoctemplate-class.md +++ b/docs/mfc/reference/cmultidoctemplate-class.md @@ -4,10 +4,12 @@ title: "CMultiDocTemplate Class" ms.date: "11/04/2016" f1_keywords: ["CMultiDocTemplate", "AFXWIN/CMultiDocTemplate", "AFXWIN/CMultiDocTemplate::CMultiDocTemplate"] helpviewer_keywords: ["CMultiDocTemplate [MFC], CMultiDocTemplate"] -ms.assetid: 5b8aa328-e461-41d0-b388-00594535e119 --- # CMultiDocTemplate Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Defines a document template that implements the multiple document interface (MDI). ## Syntax diff --git a/docs/mfc/reference/cmultilock-class.md b/docs/mfc/reference/cmultilock-class.md index c59e02672be..f04a88f1b54 100644 --- a/docs/mfc/reference/cmultilock-class.md +++ b/docs/mfc/reference/cmultilock-class.md @@ -4,10 +4,12 @@ title: "CMultiLock Class" ms.date: "11/04/2016" f1_keywords: ["CMultiLock", "AFXMT/CMultiLock", "AFXMT/CMultiLock::CMultiLock", "AFXMT/CMultiLock::IsLocked", "AFXMT/CMultiLock::Lock", "AFXMT/CMultiLock::Unlock"] helpviewer_keywords: ["CMultiLock [MFC], CMultiLock", "CMultiLock [MFC], IsLocked", "CMultiLock [MFC], Lock", "CMultiLock [MFC], Unlock"] -ms.assetid: c5b7c78b-1f81-4387-b7dd-2c813c5b6b61 --- # CMultiLock Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents the access-control mechanism used in controlling access to resources in a multithreaded program. ## Syntax diff --git a/docs/mfc/reference/cmultipagedhtmldialog-class.md b/docs/mfc/reference/cmultipagedhtmldialog-class.md index b47ead03872..328f588d532 100644 --- a/docs/mfc/reference/cmultipagedhtmldialog-class.md +++ b/docs/mfc/reference/cmultipagedhtmldialog-class.md @@ -4,10 +4,12 @@ title: "CMultiPageDHtmlDialog Class" ms.date: "03/27/2019" f1_keywords: ["CMultiPageDHtmlDialog", "AFXDHTML/CMultiPageDHtmlDialog", "AFXDHTML/CMultiPageDHtmlDialog::CMultiPageDHtmlDialog"] helpviewer_keywords: ["CMultiPageDHtmlDialog [MFC], CMultiPageDHtmlDialog"] -ms.assetid: 971accc1-824d-4df4-b4c1-b1a20e0f7e4f --- # CMultiPageDHtmlDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A multipage dialog displays multiple HTML pages sequentially and handles the events from each page. ## Syntax diff --git a/docs/mfc/reference/cmultipaneframewnd-class.md b/docs/mfc/reference/cmultipaneframewnd-class.md index 67427e554bf..f19fe3809ba 100644 --- a/docs/mfc/reference/cmultipaneframewnd-class.md +++ b/docs/mfc/reference/cmultipaneframewnd-class.md @@ -4,10 +4,12 @@ title: "CMultiPaneFrameWnd Class" ms.date: "11/04/2016" f1_keywords: ["CMultiPaneFrameWnd", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::AddPane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::AddRecentPane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::AdjustLayout", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::AdjustPaneFrames", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::CalcExpectedDockedRect", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::CanBeAttached", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::CanBeDockedToPane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::CheckGripperVisibility", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::CloseMiniFrame", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::ConvertToTabbedDocument", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::DockFrame", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::DockPane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::DockRecentPaneToMainFrame", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::GetCaptionText", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::GetPaneContainerManager", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::GetFirstVisiblePane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::GetPane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::GetPaneCount", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::GetVisiblePaneCount", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::InsertPane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::LoadState", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::OnDockToRecentPos", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::OnKillRollUpTimer", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::OnPaneRecalcLayout", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::OnSetRollUpTimer", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::OnShowPane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::PaneFromPoint", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::RemoveNonValidPanes", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::RemovePane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::ReplacePane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::SaveState", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::Serialize", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::SetDockState", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::SetLastFocusedPane", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::SetPreDockState", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::StoreRecentDockSiteInfo", "AFXMULTIPANEFRAMEWND/CMultiPaneFrameWnd::StoreRecentTabRelatedInfo"] helpviewer_keywords: ["CMultiPaneFrameWnd [MFC], AddPane", "CMultiPaneFrameWnd [MFC], AddRecentPane", "CMultiPaneFrameWnd [MFC], AdjustLayout", "CMultiPaneFrameWnd [MFC], AdjustPaneFrames", "CMultiPaneFrameWnd [MFC], CalcExpectedDockedRect", "CMultiPaneFrameWnd [MFC], CanBeAttached", "CMultiPaneFrameWnd [MFC], CanBeDockedToPane", "CMultiPaneFrameWnd [MFC], CheckGripperVisibility", "CMultiPaneFrameWnd [MFC], CloseMiniFrame", "CMultiPaneFrameWnd [MFC], ConvertToTabbedDocument", "CMultiPaneFrameWnd [MFC], DockFrame", "CMultiPaneFrameWnd [MFC], DockPane", "CMultiPaneFrameWnd [MFC], DockRecentPaneToMainFrame", "CMultiPaneFrameWnd [MFC], GetCaptionText", "CMultiPaneFrameWnd [MFC], GetPaneContainerManager", "CMultiPaneFrameWnd [MFC], GetFirstVisiblePane", "CMultiPaneFrameWnd [MFC], GetPane", "CMultiPaneFrameWnd [MFC], GetPaneCount", "CMultiPaneFrameWnd [MFC], GetVisiblePaneCount", "CMultiPaneFrameWnd [MFC], InsertPane", "CMultiPaneFrameWnd [MFC], LoadState", "CMultiPaneFrameWnd [MFC], OnDockToRecentPos", "CMultiPaneFrameWnd [MFC], OnKillRollUpTimer", "CMultiPaneFrameWnd [MFC], OnPaneRecalcLayout", "CMultiPaneFrameWnd [MFC], OnSetRollUpTimer", "CMultiPaneFrameWnd [MFC], OnShowPane", "CMultiPaneFrameWnd [MFC], PaneFromPoint", "CMultiPaneFrameWnd [MFC], RemoveNonValidPanes", "CMultiPaneFrameWnd [MFC], RemovePane", "CMultiPaneFrameWnd [MFC], ReplacePane", "CMultiPaneFrameWnd [MFC], SaveState", "CMultiPaneFrameWnd [MFC], Serialize", "CMultiPaneFrameWnd [MFC], SetDockState", "CMultiPaneFrameWnd [MFC], SetLastFocusedPane", "CMultiPaneFrameWnd [MFC], SetPreDockState", "CMultiPaneFrameWnd [MFC], StoreRecentDockSiteInfo", "CMultiPaneFrameWnd [MFC], StoreRecentTabRelatedInfo"] -ms.assetid: 989a548e-0d70-46b7-a513-8cf740e1be3e --- # CMultiPaneFrameWnd Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CMultiPaneFrameWnd` class extends [CPaneFrameWnd Class](../../mfc/reference/cpaneframewnd-class.md). It can support multiple panes. Instead of a single embedded handle to a control bar, `CMultiPaneFrameWnd` contains a [CPaneContainerManager Class](../../mfc/reference/cpanecontainermanager-class.md) object that enables the user to dock one `CMultiPaneFrameWnd` to another and dynamically create multiple floating, tabbed windows. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cmutex-class.md b/docs/mfc/reference/cmutex-class.md index a7267ffb085..e7a025cf985 100644 --- a/docs/mfc/reference/cmutex-class.md +++ b/docs/mfc/reference/cmutex-class.md @@ -4,10 +4,12 @@ title: "CMutex Class" ms.date: "11/04/2016" f1_keywords: ["CMutex", "AFXMT/CMutex", "AFXMT/CMutex::CMutex"] helpviewer_keywords: ["CMutex [MFC], CMutex"] -ms.assetid: 6330c050-4f01-4195-a099-2029b92f8cf1 --- # CMutex Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a "mutex" — a synchronization object that allows one thread mutually exclusive access to a resource. ## Syntax diff --git a/docs/mfc/reference/cnetaddressctrl-class.md b/docs/mfc/reference/cnetaddressctrl-class.md index 961b95a3943..97655606205 100644 --- a/docs/mfc/reference/cnetaddressctrl-class.md +++ b/docs/mfc/reference/cnetaddressctrl-class.md @@ -4,10 +4,12 @@ title: "CNetAddressCtrl Class" ms.date: "11/19/2018" f1_keywords: ["CNetAddressCtrl", "AFXCMN/CNetAddressCtrl", "AFXCMN/CNetAddressCtrl::CNetAddressCtrl", "AFXCMN/CNetAddressCtrl::Create", "AFXCMN/CNetAddressCtrl::CreateEx", "AFXCMN/CNetAddressCtrl::DisplayErrorTip", "AFXCMN/CNetAddressCtrl::GetAddress", "AFXCMN/CNetAddressCtrl::GetAllowType", "AFXCMN/CNetAddressCtrl::SetAllowType"] helpviewer_keywords: ["CNetAddressCtrl [MFC], CNetAddressCtrl", "CNetAddressCtrl [MFC], Create", "CNetAddressCtrl [MFC], CreateEx", "CNetAddressCtrl [MFC], DisplayErrorTip", "CNetAddressCtrl [MFC], GetAddress", "CNetAddressCtrl [MFC], GetAllowType", "CNetAddressCtrl [MFC], SetAllowType"] -ms.assetid: cb4c6aca-3f49-4b52-b76c-65f57096155b --- # CNetAddressCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CNetAddressCtrl` class represents the network address control, which you can use to input and validate the format of IPv4, IPv6, and named DNS addresses. ## Syntax diff --git a/docs/mfc/reference/cnotsupportedexception-class.md b/docs/mfc/reference/cnotsupportedexception-class.md index 91c32de3a13..4cb7a08ce51 100644 --- a/docs/mfc/reference/cnotsupportedexception-class.md +++ b/docs/mfc/reference/cnotsupportedexception-class.md @@ -4,10 +4,12 @@ title: "CNotSupportedException Class" ms.date: "11/04/2016" f1_keywords: ["CNotSupportedException", "AFX/CNotSupportedException", "AFX/CNotSupportedException::CNotSupportedException"] helpviewer_keywords: ["CNotSupportedException [MFC], CNotSupportedException"] -ms.assetid: e517391b-eb94-4c39-ae32-87b45bf7d624 --- # CNotSupportedException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an exception that is the result of a request for an unsupported feature. ## Syntax diff --git a/docs/mfc/reference/cobarray-class.md b/docs/mfc/reference/cobarray-class.md index 8dd735c1f0e..71356304785 100644 --- a/docs/mfc/reference/cobarray-class.md +++ b/docs/mfc/reference/cobarray-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CObArray [MFC], CObArray", "CObArray [MFC], Add", "CObArr --- # `CObArray` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports arrays of `CObject` pointers. ## Syntax diff --git a/docs/mfc/reference/cobject-class.md b/docs/mfc/reference/cobject-class.md index 1f712952c98..0eb328cc399 100644 --- a/docs/mfc/reference/cobject-class.md +++ b/docs/mfc/reference/cobject-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CObject [MFC], CObject", "CObject [MFC], AssertValid", "C --- # `CObject` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The principal base class for the Microsoft Foundation Class Library. ## Syntax diff --git a/docs/mfc/reference/coblist-class.md b/docs/mfc/reference/coblist-class.md index f62fd186b81..0e7810fc3d7 100644 --- a/docs/mfc/reference/coblist-class.md +++ b/docs/mfc/reference/coblist-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CObList [MFC], CObList", "CObList [MFC], AddHead", "CObLi --- # `CObList` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports ordered lists of nonunique `CObject` pointers accessible sequentially or by pointer value. ## Syntax diff --git a/docs/mfc/reference/coccmanager-class.md b/docs/mfc/reference/coccmanager-class.md index 8660c985c55..18a35b36a4a 100644 --- a/docs/mfc/reference/coccmanager-class.md +++ b/docs/mfc/reference/coccmanager-class.md @@ -4,10 +4,12 @@ title: "COccManager Class" ms.date: "11/04/2016" f1_keywords: ["COccManager", "AFXOCC/COccManager", "AFXOCC/COccManager::CreateContainer", "AFXOCC/COccManager::CreateDlgControls", "AFXOCC/COccManager::CreateSite", "AFXOCC/COccManager::GetDefBtnCode", "AFXOCC/COccManager::IsDialogMessage", "AFXOCC/COccManager::IsLabelControl", "AFXOCC/COccManager::IsMatchingMnemonic", "AFXOCC/COccManager::OnEvent", "AFXOCC/COccManager::PostCreateDialog", "AFXOCC/COccManager::PreCreateDialog", "AFXOCC/COccManager::SetDefaultButton", "AFXOCC/COccManager::SplitDialogTemplate"] helpviewer_keywords: ["COccManager [MFC], CreateContainer", "COccManager [MFC], CreateDlgControls", "COccManager [MFC], CreateSite", "COccManager [MFC], GetDefBtnCode", "COccManager [MFC], IsDialogMessage", "COccManager [MFC], IsLabelControl", "COccManager [MFC], IsMatchingMnemonic", "COccManager [MFC], OnEvent", "COccManager [MFC], PostCreateDialog", "COccManager [MFC], PreCreateDialog", "COccManager [MFC], SetDefaultButton", "COccManager [MFC], SplitDialogTemplate"] -ms.assetid: 7d47aeed-d1ab-48e3-b4cf-d429718e370a --- # COccManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages various custom control sites; implemented by `COleControlContainer` and `COleControlSite` objects. ## Syntax diff --git a/docs/mfc/reference/codbcfieldinfo-structure.md b/docs/mfc/reference/codbcfieldinfo-structure.md index 03a4573f045..ea89688707e 100644 --- a/docs/mfc/reference/codbcfieldinfo-structure.md +++ b/docs/mfc/reference/codbcfieldinfo-structure.md @@ -4,10 +4,12 @@ title: "CODBCFieldInfo Structure" ms.date: "11/04/2016" f1_keywords: ["CODBCFieldInfo"] helpviewer_keywords: ["ODBC [MFC], data source information", "CODBCFieldInfo structure [MFC]"] -ms.assetid: 92598b4f-facc-4108-b282-63a179ff79ab --- # CODBCFieldInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CODBCFieldInfo` structure contains information about the fields in an ODBC data source. ## Syntax diff --git a/docs/mfc/reference/colebusydialog-class.md b/docs/mfc/reference/colebusydialog-class.md index d9d615fe4e1..8a448182cce 100644 --- a/docs/mfc/reference/colebusydialog-class.md +++ b/docs/mfc/reference/colebusydialog-class.md @@ -4,10 +4,12 @@ title: "COleBusyDialog Class" ms.date: "11/04/2016" f1_keywords: ["COleBusyDialog", "AFXODLGS/COleBusyDialog", "AFXODLGS/COleBusyDialog::COleBusyDialog", "AFXODLGS/COleBusyDialog::DoModal", "AFXODLGS/COleBusyDialog::GetSelectionType", "AFXODLGS/COleBusyDialog::m_bz"] helpviewer_keywords: ["COleBusyDialog [MFC], COleBusyDialog", "COleBusyDialog [MFC], DoModal", "COleBusyDialog [MFC], GetSelectionType", "COleBusyDialog [MFC], m_bz"] -ms.assetid: c881a532-9672-4c41-b51b-5ce4a7246a6b --- # COleBusyDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used for the OLE Server Not Responding or Server Busy dialog boxes. ## Syntax diff --git a/docs/mfc/reference/colechangeicondialog-class.md b/docs/mfc/reference/colechangeicondialog-class.md index 4aa41b2f9b8..f3215747770 100644 --- a/docs/mfc/reference/colechangeicondialog-class.md +++ b/docs/mfc/reference/colechangeicondialog-class.md @@ -4,10 +4,12 @@ title: "COleChangeIconDialog Class" ms.date: "11/04/2016" f1_keywords: ["COleChangeIconDialog", "AFXODLGS/COleChangeIconDialog", "AFXODLGS/COleChangeIconDialog::COleChangeIconDialog", "AFXODLGS/COleChangeIconDialog::DoChangeIcon", "AFXODLGS/COleChangeIconDialog::DoModal", "AFXODLGS/COleChangeIconDialog::GetIconicMetafile", "AFXODLGS/COleChangeIconDialog::m_ci"] helpviewer_keywords: ["COleChangeIconDialog [MFC], COleChangeIconDialog", "COleChangeIconDialog [MFC], DoChangeIcon", "COleChangeIconDialog [MFC], DoModal", "COleChangeIconDialog [MFC], GetIconicMetafile", "COleChangeIconDialog [MFC], m_ci"] -ms.assetid: 8d6e131b-ddbb-4dff-a432-f239efda8e3d --- # COleChangeIconDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used for the OLE Change Icon dialog box. ## Syntax diff --git a/docs/mfc/reference/colechangesourcedialog-class.md b/docs/mfc/reference/colechangesourcedialog-class.md index dde0eeca7c4..9b66d040ee1 100644 --- a/docs/mfc/reference/colechangesourcedialog-class.md +++ b/docs/mfc/reference/colechangesourcedialog-class.md @@ -4,10 +4,12 @@ title: "COleChangeSourceDialog Class" ms.date: "11/04/2016" f1_keywords: ["COleChangeSourceDialog", "AFXODLGS/COleChangeSourceDialog", "AFXODLGS/COleChangeSourceDialog::COleChangeSourceDialog", "AFXODLGS/COleChangeSourceDialog::DoModal", "AFXODLGS/COleChangeSourceDialog::GetDisplayName", "AFXODLGS/COleChangeSourceDialog::GetFileName", "AFXODLGS/COleChangeSourceDialog::GetFromPrefix", "AFXODLGS/COleChangeSourceDialog::GetItemName", "AFXODLGS/COleChangeSourceDialog::GetToPrefix", "AFXODLGS/COleChangeSourceDialog::IsValidSource", "AFXODLGS/COleChangeSourceDialog::m_cs"] helpviewer_keywords: ["COleChangeSourceDialog [MFC], COleChangeSourceDialog", "COleChangeSourceDialog [MFC], DoModal", "COleChangeSourceDialog [MFC], GetDisplayName", "COleChangeSourceDialog [MFC], GetFileName", "COleChangeSourceDialog [MFC], GetFromPrefix", "COleChangeSourceDialog [MFC], GetItemName", "COleChangeSourceDialog [MFC], GetToPrefix", "COleChangeSourceDialog [MFC], IsValidSource", "COleChangeSourceDialog [MFC], m_cs"] -ms.assetid: d0e08be7-21ef-45e1-97af-fe27d99e3bac --- # COleChangeSourceDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used for the OLE Change Source dialog box. ## Syntax diff --git a/docs/mfc/reference/coleclientitem-class.md b/docs/mfc/reference/coleclientitem-class.md index 356cf6cdba4..6d13579bde0 100644 --- a/docs/mfc/reference/coleclientitem-class.md +++ b/docs/mfc/reference/coleclientitem-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleClientItem [MFC], COleClientItem", "COleClientItem [M --- # COleClientItem Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Defines the container interface to OLE items. ## Syntax diff --git a/docs/mfc/reference/colecmdui-class.md b/docs/mfc/reference/colecmdui-class.md index 93442684f98..04cb24cec92 100644 --- a/docs/mfc/reference/colecmdui-class.md +++ b/docs/mfc/reference/colecmdui-class.md @@ -4,10 +4,12 @@ title: "COleCmdUI Class" ms.date: 07/24/2020 f1_keywords: ["COleCmdUI", "AFXDOCOBJ/COleCmdUI", "AFXDOCOBJ/COleCmdUI::COleCmdUI", "AFXDOCOBJ/COleCmdUI::Enable", "AFXDOCOBJ/COleCmdUI::SetCheck", "AFXDOCOBJ/COleCmdUI::SetText"] helpviewer_keywords: ["COleCmdUI [MFC], COleCmdUI", "COleCmdUI [MFC], Enable", "COleCmdUI [MFC], SetCheck", "COleCmdUI [MFC], SetText"] -ms.assetid: a2d5ce08-6657-45d3-8673-2a9f32d50eec --- # COleCmdUI Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a method for MFC to update the state of user-interface objects related to the `IOleCommandTarget`-driven features of your application. ## Syntax diff --git a/docs/mfc/reference/colecontrol-class.md b/docs/mfc/reference/colecontrol-class.md index 4fd5fcaaa04..c30561fbf89 100644 --- a/docs/mfc/reference/colecontrol-class.md +++ b/docs/mfc/reference/colecontrol-class.md @@ -4,10 +4,12 @@ title: "COleControl Class" ms.date: "08/27/2018" f1_keywords: ["COleControl", "AFXCTL/COleControl", "AFXCTL/COleControl::COleControl", "AFXCTL/COleControl::AmbientAppearance", "AFXCTL/COleControl::AmbientBackColor", "AFXCTL/COleControl::AmbientDisplayName", "AFXCTL/COleControl::AmbientFont", "AFXCTL/COleControl::AmbientForeColor", "AFXCTL/COleControl::AmbientLocaleID", "AFXCTL/COleControl::AmbientScaleUnits", "AFXCTL/COleControl::AmbientShowGrabHandles", "AFXCTL/COleControl::AmbientShowHatching", "AFXCTL/COleControl::AmbientTextAlign", "AFXCTL/COleControl::AmbientUIDead", "AFXCTL/COleControl::AmbientUserMode", "AFXCTL/COleControl::BoundPropertyChanged", "AFXCTL/COleControl::BoundPropertyRequestEdit", "AFXCTL/COleControl::ClientToParent", "AFXCTL/COleControl::ClipCaretRect", "AFXCTL/COleControl::ControlInfoChanged", "AFXCTL/COleControl::DisplayError", "AFXCTL/COleControl::DoClick", "AFXCTL/COleControl::DoPropExchange", "AFXCTL/COleControl::DoSuperclassPaint", "AFXCTL/COleControl::EnableSimpleFrame", "AFXCTL/COleControl::ExchangeExtent", "AFXCTL/COleControl::ExchangeStockProps", "AFXCTL/COleControl::ExchangeVersion", "AFXCTL/COleControl::FireClick", "AFXCTL/COleControl::FireDblClick", "AFXCTL/COleControl::FireError", "AFXCTL/COleControl::FireEvent", "AFXCTL/COleControl::FireKeyDown", "AFXCTL/COleControl::FireKeyPress", "AFXCTL/COleControl::FireKeyUp", "AFXCTL/COleControl::FireMouseDown", "AFXCTL/COleControl::FireMouseMove", "AFXCTL/COleControl::FireMouseUp", "AFXCTL/COleControl::FireReadyStateChange", "AFXCTL/COleControl::GetActivationPolicy", "AFXCTL/COleControl::GetAmbientProperty", "AFXCTL/COleControl::GetAppearance", "AFXCTL/COleControl::GetBackColor", "AFXCTL/COleControl::GetBorderStyle", "AFXCTL/COleControl::GetCapture", "AFXCTL/COleControl::GetClassID", "AFXCTL/COleControl::GetClientOffset", "AFXCTL/COleControl::GetClientRect", "AFXCTL/COleControl::GetClientSite", "AFXCTL/COleControl::GetControlFlags", "AFXCTL/COleControl::GetControlSize", "AFXCTL/COleControl::GetDC", "AFXCTL/COleControl::GetEnabled", "AFXCTL/COleControl::GetExtendedControl", "AFXCTL/COleControl::GetFocus", "AFXCTL/COleControl::GetFont", "AFXCTL/COleControl::GetFontTextMetrics", "AFXCTL/COleControl::GetForeColor", "AFXCTL/COleControl::GetHwnd", "AFXCTL/COleControl::GetMessageString", "AFXCTL/COleControl::GetNotSupported", "AFXCTL/COleControl::GetReadyState", "AFXCTL/COleControl::GetRectInContainer", "AFXCTL/COleControl::GetStockTextMetrics", "AFXCTL/COleControl::GetText", "AFXCTL/COleControl::GetWindowlessDropTarget", "AFXCTL/COleControl::InitializeIIDs", "AFXCTL/COleControl::InternalGetFont", "AFXCTL/COleControl::InternalGetText", "AFXCTL/COleControl::InternalSetReadyState", "AFXCTL/COleControl::InvalidateControl", "AFXCTL/COleControl::InvalidateRgn", "AFXCTL/COleControl::IsConvertingVBX", "AFXCTL/COleControl::IsModified", "AFXCTL/COleControl::IsOptimizedDraw", "AFXCTL/COleControl::IsSubclassedControl", "AFXCTL/COleControl::Load", "AFXCTL/COleControl::LockInPlaceActive", "AFXCTL/COleControl::OnAmbientPropertyChange", "AFXCTL/COleControl::OnAppearanceChanged", "AFXCTL/COleControl::OnBackColorChanged", "AFXCTL/COleControl::OnBorderStyleChanged", "AFXCTL/COleControl::OnClick", "AFXCTL/COleControl::OnClose", "AFXCTL/COleControl::OnDoVerb", "AFXCTL/COleControl::OnDraw", "AFXCTL/COleControl::OnDrawMetafile", "AFXCTL/COleControl::OnEdit", "AFXCTL/COleControl::OnEnabledChanged", "AFXCTL/COleControl::OnEnumVerbs", "AFXCTL/COleControl::OnEventAdvise", "AFXCTL/COleControl::OnFontChanged", "AFXCTL/COleControl::OnForeColorChanged", "AFXCTL/COleControl::OnFreezeEvents", "AFXCTL/COleControl::OnGetColorSet", "AFXCTL/COleControl::OnGetControlInfo", "AFXCTL/COleControl::OnGetDisplayString", "AFXCTL/COleControl::OnGetInPlaceMenu", "AFXCTL/COleControl::OnGetNaturalExtent", "AFXCTL/COleControl::OnGetPredefinedStrings", "AFXCTL/COleControl::OnGetPredefinedValue", "AFXCTL/COleControl::OnGetViewExtent", "AFXCTL/COleControl::OnGetViewRect", "AFXCTL/COleControl::OnGetViewStatus", "AFXCTL/COleControl::OnHideToolBars", "AFXCTL/COleControl::OnInactiveMouseMove", "AFXCTL/COleControl::OnInactiveSetCursor", "AFXCTL/COleControl::OnKeyDownEvent", "AFXCTL/COleControl::OnKeyPressEvent", "AFXCTL/COleControl::OnKeyUpEvent", "AFXCTL/COleControl::OnMapPropertyToPage", "AFXCTL/COleControl::OnMnemonic", "AFXCTL/COleControl::OnProperties", "AFXCTL/COleControl::OnQueryHitPoint", "AFXCTL/COleControl::OnQueryHitRect", "AFXCTL/COleControl::OnRenderData", "AFXCTL/COleControl::OnRenderFileData", "AFXCTL/COleControl::OnRenderGlobalData", "AFXCTL/COleControl::OnResetState", "AFXCTL/COleControl::OnSetClientSite", "AFXCTL/COleControl::OnSetData", "AFXCTL/COleControl::OnSetExtent", "AFXCTL/COleControl::OnSetObjectRects", "AFXCTL/COleControl::OnShowToolBars", "AFXCTL/COleControl::OnTextChanged", "AFXCTL/COleControl::OnWindowlessMessage", "AFXCTL/COleControl::ParentToClient", "AFXCTL/COleControl::PostModalDialog", "AFXCTL/COleControl::PreModalDialog", "AFXCTL/COleControl::RecreateControlWindow", "AFXCTL/COleControl::Refresh", "AFXCTL/COleControl::ReleaseCapture", "AFXCTL/COleControl::ReleaseDC", "AFXCTL/COleControl::ReparentControlWindow", "AFXCTL/COleControl::ResetStockProps", "AFXCTL/COleControl::ResetVersion", "AFXCTL/COleControl::ScrollWindow", "AFXCTL/COleControl::SelectFontObject", "AFXCTL/COleControl::SelectStockFont", "AFXCTL/COleControl::SerializeExtent", "AFXCTL/COleControl::SerializeStockProps", "AFXCTL/COleControl::SerializeVersion", "AFXCTL/COleControl::SetAppearance", "AFXCTL/COleControl::SetBackColor", "AFXCTL/COleControl::SetBorderStyle", "AFXCTL/COleControl::SetCapture", "AFXCTL/COleControl::SetControlSize", "AFXCTL/COleControl::SetEnabled", "AFXCTL/COleControl::SetFocus", "AFXCTL/COleControl::SetFont", "AFXCTL/COleControl::SetForeColor", "AFXCTL/COleControl::SetInitialSize", "AFXCTL/COleControl::SetModifiedFlag", "AFXCTL/COleControl::SetNotPermitted", "AFXCTL/COleControl::SetNotSupported", "AFXCTL/COleControl::SetRectInContainer", "AFXCTL/COleControl::SetText", "AFXCTL/COleControl::ThrowError", "AFXCTL/COleControl::TransformCoords", "AFXCTL/COleControl::TranslateColor", "AFXCTL/COleControl::WillAmbientsBeValidDuringLoad", "AFXCTL/COleControl::WindowProc", "AFXCTL/COleControl::DrawContent", "AFXCTL/COleControl::DrawMetafile", "AFXCTL/COleControl::IsInvokeAllowed", "AFXCTL/COleControl::SetInitialDataFormats"] helpviewer_keywords: ["COleControl [MFC], COleControl", "COleControl [MFC], AmbientAppearance", "COleControl [MFC], AmbientBackColor", "COleControl [MFC], AmbientDisplayName", "COleControl [MFC], AmbientFont", "COleControl [MFC], AmbientForeColor", "COleControl [MFC], AmbientLocaleID", "COleControl [MFC], AmbientScaleUnits", "COleControl [MFC], AmbientShowGrabHandles", "COleControl [MFC], AmbientShowHatching", "COleControl [MFC], AmbientTextAlign", "COleControl [MFC], AmbientUIDead", "COleControl [MFC], AmbientUserMode", "COleControl [MFC], BoundPropertyChanged", "COleControl [MFC], BoundPropertyRequestEdit", "COleControl [MFC], ClientToParent", "COleControl [MFC], ClipCaretRect", "COleControl [MFC], ControlInfoChanged", "COleControl [MFC], DisplayError", "COleControl [MFC], DoClick", "COleControl [MFC], DoPropExchange", "COleControl [MFC], DoSuperclassPaint", "COleControl [MFC], EnableSimpleFrame", "COleControl [MFC], ExchangeExtent", "COleControl [MFC], ExchangeStockProps", "COleControl [MFC], ExchangeVersion", "COleControl [MFC], FireClick", "COleControl [MFC], FireDblClick", "COleControl [MFC], FireError", "COleControl [MFC], FireEvent", "COleControl [MFC], FireKeyDown", "COleControl [MFC], FireKeyPress", "COleControl [MFC], FireKeyUp", "COleControl [MFC], FireMouseDown", "COleControl [MFC], FireMouseMove", "COleControl [MFC], FireMouseUp", "COleControl [MFC], FireReadyStateChange", "COleControl [MFC], GetActivationPolicy", "COleControl [MFC], GetAmbientProperty", "COleControl [MFC], GetAppearance", "COleControl [MFC], GetBackColor", "COleControl [MFC], GetBorderStyle", "COleControl [MFC], GetCapture", "COleControl [MFC], GetClassID", "COleControl [MFC], GetClientOffset", "COleControl [MFC], GetClientRect", "COleControl [MFC], GetClientSite", "COleControl [MFC], GetControlFlags", "COleControl [MFC], GetControlSize", "COleControl [MFC], GetDC", "COleControl [MFC], GetEnabled", "COleControl [MFC], GetExtendedControl", "COleControl [MFC], GetFocus", "COleControl [MFC], GetFont", "COleControl [MFC], GetFontTextMetrics", "COleControl [MFC], GetForeColor", "COleControl [MFC], GetHwnd", "COleControl [MFC], GetMessageString", "COleControl [MFC], GetNotSupported", "COleControl [MFC], GetReadyState", "COleControl [MFC], GetRectInContainer", "COleControl [MFC], GetStockTextMetrics", "COleControl [MFC], GetText", "COleControl [MFC], GetWindowlessDropTarget", "COleControl [MFC], InitializeIIDs", "COleControl [MFC], InternalGetFont", "COleControl [MFC], InternalGetText", "COleControl [MFC], InternalSetReadyState", "COleControl [MFC], InvalidateControl", "COleControl [MFC], InvalidateRgn", "COleControl [MFC], IsConvertingVBX", "COleControl [MFC], IsModified", "COleControl [MFC], IsOptimizedDraw", "COleControl [MFC], IsSubclassedControl", "COleControl [MFC], Load", "COleControl [MFC], LockInPlaceActive", "COleControl [MFC], OnAmbientPropertyChange", "COleControl [MFC], OnAppearanceChanged", "COleControl [MFC], OnBackColorChanged", "COleControl [MFC], OnBorderStyleChanged", "COleControl [MFC], OnClick", "COleControl [MFC], OnClose", "COleControl [MFC], OnDoVerb", "COleControl [MFC], OnDraw", "COleControl [MFC], OnDrawMetafile", "COleControl [MFC], OnEdit", "COleControl [MFC], OnEnabledChanged", "COleControl [MFC], OnEnumVerbs", "COleControl [MFC], OnEventAdvise", "COleControl [MFC], OnFontChanged", "COleControl [MFC], OnForeColorChanged", "COleControl [MFC], OnFreezeEvents", "COleControl [MFC], OnGetColorSet", "COleControl [MFC], OnGetControlInfo", "COleControl [MFC], OnGetDisplayString", "COleControl [MFC], OnGetInPlaceMenu", "COleControl [MFC], OnGetNaturalExtent", "COleControl [MFC], OnGetPredefinedStrings", "COleControl [MFC], OnGetPredefinedValue", "COleControl [MFC], OnGetViewExtent", "COleControl [MFC], OnGetViewRect", "COleControl [MFC], OnGetViewStatus", "COleControl [MFC], OnHideToolBars", "COleControl [MFC], OnInactiveMouseMove", "COleControl [MFC], OnInactiveSetCursor", "COleControl [MFC], OnKeyDownEvent", "COleControl [MFC], OnKeyPressEvent", "COleControl [MFC], OnKeyUpEvent", "COleControl [MFC], OnMapPropertyToPage", "COleControl [MFC], OnMnemonic", "COleControl [MFC], OnProperties", "COleControl [MFC], OnQueryHitPoint", "COleControl [MFC], OnQueryHitRect", "COleControl [MFC], OnRenderData", "COleControl [MFC], OnRenderFileData", "COleControl [MFC], OnRenderGlobalData", "COleControl [MFC], OnResetState", "COleControl [MFC], OnSetClientSite", "COleControl [MFC], OnSetData", "COleControl [MFC], OnSetExtent", "COleControl [MFC], OnSetObjectRects", "COleControl [MFC], OnShowToolBars", "COleControl [MFC], OnTextChanged", "COleControl [MFC], OnWindowlessMessage", "COleControl [MFC], ParentToClient", "COleControl [MFC], PostModalDialog", "COleControl [MFC], PreModalDialog", "COleControl [MFC], RecreateControlWindow", "COleControl [MFC], Refresh", "COleControl [MFC], ReleaseCapture", "COleControl [MFC], ReleaseDC", "COleControl [MFC], ReparentControlWindow", "COleControl [MFC], ResetStockProps", "COleControl [MFC], ResetVersion", "COleControl [MFC], ScrollWindow", "COleControl [MFC], SelectFontObject", "COleControl [MFC], SelectStockFont", "COleControl [MFC], SerializeExtent", "COleControl [MFC], SerializeStockProps", "COleControl [MFC], SerializeVersion", "COleControl [MFC], SetAppearance", "COleControl [MFC], SetBackColor", "COleControl [MFC], SetBorderStyle", "COleControl [MFC], SetCapture", "COleControl [MFC], SetControlSize", "COleControl [MFC], SetEnabled", "COleControl [MFC], SetFocus", "COleControl [MFC], SetFont", "COleControl [MFC], SetForeColor", "COleControl [MFC], SetInitialSize", "COleControl [MFC], SetModifiedFlag", "COleControl [MFC], SetNotPermitted", "COleControl [MFC], SetNotSupported", "COleControl [MFC], SetRectInContainer", "COleControl [MFC], SetText", "COleControl [MFC], ThrowError", "COleControl [MFC], TransformCoords", "COleControl [MFC], TranslateColor", "COleControl [MFC], WillAmbientsBeValidDuringLoad", "COleControl [MFC], WindowProc", "COleControl [MFC], DrawContent", "COleControl [MFC], DrawMetafile", "COleControl [MFC], IsInvokeAllowed", "COleControl [MFC], SetInitialDataFormats"] -ms.assetid: 53e95299-38e8-447b-9c5f-a381d27f5123 --- # COleControl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A powerful base class for developing OLE controls. ## Syntax diff --git a/docs/mfc/reference/colecontrolcontainer-class.md b/docs/mfc/reference/colecontrolcontainer-class.md index 5187c2d745f..ff21a7c3de1 100644 --- a/docs/mfc/reference/colecontrolcontainer-class.md +++ b/docs/mfc/reference/colecontrolcontainer-class.md @@ -4,10 +4,12 @@ title: "COleControlContainer Class" ms.date: "11/04/2016" f1_keywords: ["COleControlContainer", "AFXOCC/COleControlContainer", "AFXOCC/COleControlContainer::COleControlContainer", "AFXOCC/COleControlContainer::AttachControlSite", "AFXOCC/COleControlContainer::BroadcastAmbientPropertyChange", "AFXOCC/COleControlContainer::CheckDlgButton", "AFXOCC/COleControlContainer::CheckRadioButton", "AFXOCC/COleControlContainer::CreateControl", "AFXOCC/COleControlContainer::CreateOleFont", "AFXOCC/COleControlContainer::FindItem", "AFXOCC/COleControlContainer::FreezeAllEvents", "AFXOCC/COleControlContainer::GetAmbientProp", "AFXOCC/COleControlContainer::GetDlgItem", "AFXOCC/COleControlContainer::GetDlgItemInt", "AFXOCC/COleControlContainer::GetDlgItemText", "AFXOCC/COleControlContainer::HandleSetFocus", "AFXOCC/COleControlContainer::HandleWindowlessMessage", "AFXOCC/COleControlContainer::IsDlgButtonChecked", "AFXOCC/COleControlContainer::OnPaint", "AFXOCC/COleControlContainer::OnUIActivate", "AFXOCC/COleControlContainer::OnUIDeactivate", "AFXOCC/COleControlContainer::ScrollChildren", "AFXOCC/COleControlContainer::SendDlgItemMessage", "AFXOCC/COleControlContainer::SetDlgItemInt", "AFXOCC/COleControlContainer::SetDlgItemText", "AFXOCC/COleControlContainer::m_crBack", "AFXOCC/COleControlContainer::m_crFore", "AFXOCC/COleControlContainer::m_listSitesOrWnds", "AFXOCC/COleControlContainer::m_nWindowlessControls", "AFXOCC/COleControlContainer::m_pOleFont", "AFXOCC/COleControlContainer::m_pSiteCapture", "AFXOCC/COleControlContainer::m_pSiteFocus", "AFXOCC/COleControlContainer::m_pSiteUIActive", "AFXOCC/COleControlContainer::m_pWnd", "AFXOCC/COleControlContainer::m_siteMap"] helpviewer_keywords: ["COleControlContainer [MFC], COleControlContainer", "COleControlContainer [MFC], AttachControlSite", "COleControlContainer [MFC], BroadcastAmbientPropertyChange", "COleControlContainer [MFC], CheckDlgButton", "COleControlContainer [MFC], CheckRadioButton", "COleControlContainer [MFC], CreateControl", "COleControlContainer [MFC], CreateOleFont", "COleControlContainer [MFC], FindItem", "COleControlContainer [MFC], FreezeAllEvents", "COleControlContainer [MFC], GetAmbientProp", "COleControlContainer [MFC], GetDlgItem", "COleControlContainer [MFC], GetDlgItemInt", "COleControlContainer [MFC], GetDlgItemText", "COleControlContainer [MFC], HandleSetFocus", "COleControlContainer [MFC], HandleWindowlessMessage", "COleControlContainer [MFC], IsDlgButtonChecked", "COleControlContainer [MFC], OnPaint", "COleControlContainer [MFC], OnUIActivate", "COleControlContainer [MFC], OnUIDeactivate", "COleControlContainer [MFC], ScrollChildren", "COleControlContainer [MFC], SendDlgItemMessage", "COleControlContainer [MFC], SetDlgItemInt", "COleControlContainer [MFC], SetDlgItemText", "COleControlContainer [MFC], m_crBack", "COleControlContainer [MFC], m_crFore", "COleControlContainer [MFC], m_listSitesOrWnds", "COleControlContainer [MFC], m_nWindowlessControls", "COleControlContainer [MFC], m_pOleFont", "COleControlContainer [MFC], m_pSiteCapture", "COleControlContainer [MFC], m_pSiteFocus", "COleControlContainer [MFC], m_pSiteUIActive", "COleControlContainer [MFC], m_pWnd", "COleControlContainer [MFC], m_siteMap"] -ms.assetid: f7ce9246-0fb7-4f07-a83a-6c2390d0fdf8 --- # COleControlContainer Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Acts as a control container for ActiveX controls. ## Syntax diff --git a/docs/mfc/reference/colecontrolmodule-class.md b/docs/mfc/reference/colecontrolmodule-class.md index 27758f5eae1..6a03e9ed1c9 100644 --- a/docs/mfc/reference/colecontrolmodule-class.md +++ b/docs/mfc/reference/colecontrolmodule-class.md @@ -4,10 +4,12 @@ title: "COleControlModule Class" ms.date: "11/04/2016" f1_keywords: ["OleControlModule"] helpviewer_keywords: ["OLE control modules [MFC]", "MFC ActiveX controls [MFC], OLE control modules", "COleControlModule class [MFC]", "control modules [MFC]"] -ms.assetid: 0721724d-d4af-4eda-ad34-5a2b27810dd4 --- # COleControlModule Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class from which you derive an OLE control module object. ## Syntax diff --git a/docs/mfc/reference/colecontrolsite-class.md b/docs/mfc/reference/colecontrolsite-class.md index 1e7c3602a6e..e5b30a331c1 100644 --- a/docs/mfc/reference/colecontrolsite-class.md +++ b/docs/mfc/reference/colecontrolsite-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleControlSite [MFC], COleControlSite", "COleControlSite --- # COleControlSite Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides support for custom client-side control interfaces. ## Syntax diff --git a/docs/mfc/reference/coleconvertdialog-class.md b/docs/mfc/reference/coleconvertdialog-class.md index eda026d9681..4d73297fdc0 100644 --- a/docs/mfc/reference/coleconvertdialog-class.md +++ b/docs/mfc/reference/coleconvertdialog-class.md @@ -4,10 +4,12 @@ title: "COleConvertDialog Class" ms.date: "11/04/2016" f1_keywords: ["COleConvertDialog", "AFXODLGS/COleConvertDialog", "AFXODLGS/COleConvertDialog::COleConvertDialog", "AFXODLGS/COleConvertDialog::DoConvert", "AFXODLGS/COleConvertDialog::DoModal", "AFXODLGS/COleConvertDialog::GetClassID", "AFXODLGS/COleConvertDialog::GetDrawAspect", "AFXODLGS/COleConvertDialog::GetIconicMetafile", "AFXODLGS/COleConvertDialog::GetSelectionType", "AFXODLGS/COleConvertDialog::m_cv"] helpviewer_keywords: ["COleConvertDialog [MFC], COleConvertDialog", "COleConvertDialog [MFC], DoConvert", "COleConvertDialog [MFC], DoModal", "COleConvertDialog [MFC], GetClassID", "COleConvertDialog [MFC], GetDrawAspect", "COleConvertDialog [MFC], GetIconicMetafile", "COleConvertDialog [MFC], GetSelectionType", "COleConvertDialog [MFC], m_cv"] -ms.assetid: a7c57714-31e8-4b78-834d-8ddd1b856a1c --- # COleConvertDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For more information, see the [OLEUICONVERT](/windows/win32/api/oledlg/ns-oledlg-oleuiconvertw) structure in the Windows SDK. ## Syntax diff --git a/docs/mfc/reference/colecurrency-class.md b/docs/mfc/reference/colecurrency-class.md index 76b27412456..b440966b509 100644 --- a/docs/mfc/reference/colecurrency-class.md +++ b/docs/mfc/reference/colecurrency-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleCurrency [MFC], COleCurrency", "COleCurrency [MFC], F --- # COleCurrency Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the `CURRENCY` data type of OLE automation. ## Syntax diff --git a/docs/mfc/reference/coledataobject-class.md b/docs/mfc/reference/coledataobject-class.md index 66f054c745a..db59686d70a 100644 --- a/docs/mfc/reference/coledataobject-class.md +++ b/docs/mfc/reference/coledataobject-class.md @@ -4,10 +4,12 @@ title: "COleDataObject Class" ms.date: "11/04/2016" f1_keywords: ["COleDataObject", "AFXOLE/COleDataObject", "AFXOLE/COleDataObject::COleDataObject", "AFXOLE/COleDataObject::Attach", "AFXOLE/COleDataObject::AttachClipboard", "AFXOLE/COleDataObject::BeginEnumFormats", "AFXOLE/COleDataObject::Detach", "AFXOLE/COleDataObject::GetData", "AFXOLE/COleDataObject::GetFileData", "AFXOLE/COleDataObject::GetGlobalData", "AFXOLE/COleDataObject::GetNextFormat", "AFXOLE/COleDataObject::IsDataAvailable", "AFXOLE/COleDataObject::Release"] helpviewer_keywords: ["COleDataObject [MFC], COleDataObject", "COleDataObject [MFC], Attach", "COleDataObject [MFC], AttachClipboard", "COleDataObject [MFC], BeginEnumFormats", "COleDataObject [MFC], Detach", "COleDataObject [MFC], GetData", "COleDataObject [MFC], GetFileData", "COleDataObject [MFC], GetGlobalData", "COleDataObject [MFC], GetNextFormat", "COleDataObject [MFC], IsDataAvailable", "COleDataObject [MFC], Release"] -ms.assetid: d1cc84be-2e1c-4bb3-a8a0-565eb08aaa34 --- # COleDataObject Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used in data transfers for retrieving data in various formats from the Clipboard, through drag and drop, or from an embedded OLE item. ## Syntax diff --git a/docs/mfc/reference/coledatasource-class.md b/docs/mfc/reference/coledatasource-class.md index 8d0101c0358..b107af62451 100644 --- a/docs/mfc/reference/coledatasource-class.md +++ b/docs/mfc/reference/coledatasource-class.md @@ -4,10 +4,12 @@ title: "COleDataSource Class" ms.date: "11/04/2016" f1_keywords: ["COleDataSource", "AFXOLE/COleDataSource", "AFXOLE/COleDataSource::COleDataSource", "AFXOLE/COleDataSource::CacheData", "AFXOLE/COleDataSource::CacheGlobalData", "AFXOLE/COleDataSource::DelayRenderData", "AFXOLE/COleDataSource::DelayRenderFileData", "AFXOLE/COleDataSource::DelaySetData", "AFXOLE/COleDataSource::DoDragDrop", "AFXOLE/COleDataSource::Empty", "AFXOLE/COleDataSource::FlushClipboard", "AFXOLE/COleDataSource::GetClipboardOwner", "AFXOLE/COleDataSource::OnRenderData", "AFXOLE/COleDataSource::OnRenderFileData", "AFXOLE/COleDataSource::OnRenderGlobalData", "AFXOLE/COleDataSource::OnSetData", "AFXOLE/COleDataSource::SetClipboard"] helpviewer_keywords: ["COleDataSource [MFC], COleDataSource", "COleDataSource [MFC], CacheData", "COleDataSource [MFC], CacheGlobalData", "COleDataSource [MFC], DelayRenderData", "COleDataSource [MFC], DelayRenderFileData", "COleDataSource [MFC], DelaySetData", "COleDataSource [MFC], DoDragDrop", "COleDataSource [MFC], Empty", "COleDataSource [MFC], FlushClipboard", "COleDataSource [MFC], GetClipboardOwner", "COleDataSource [MFC], OnRenderData", "COleDataSource [MFC], OnRenderFileData", "COleDataSource [MFC], OnRenderGlobalData", "COleDataSource [MFC], OnSetData", "COleDataSource [MFC], SetClipboard"] -ms.assetid: 02c8ee7d-8e10-4463-8613-bb2a0305ca69 --- # COleDataSource Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Acts as a cache into which an application places the data that it will offer during data transfer operations, such as Clipboard or drag-and-drop operations. ## Syntax diff --git a/docs/mfc/reference/coledbrecordview-class.md b/docs/mfc/reference/coledbrecordview-class.md index b8ab8c78076..dda014b94d5 100644 --- a/docs/mfc/reference/coledbrecordview-class.md +++ b/docs/mfc/reference/coledbrecordview-class.md @@ -4,10 +4,12 @@ title: "COleDBRecordView Class" ms.date: "11/04/2016" f1_keywords: ["COleDBRecordView", "AFXOLEDB/COleDBRecordView", "AFXOLEDB/COleDBRecordView::COleDBRecordView", "AFXOLEDB/COleDBRecordView::OnGetRowset", "AFXOLEDB/COleDBRecordView::OnMove"] helpviewer_keywords: ["COleDBRecordView [MFC], COleDBRecordView", "COleDBRecordView [MFC], OnGetRowset", "COleDBRecordView [MFC], OnMove"] -ms.assetid: 98612427-c4c9-4760-b7e1-85b17448add9 --- # COleDBRecordView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A view that displays database records in controls. ## Syntax diff --git a/docs/mfc/reference/coledialog-class.md b/docs/mfc/reference/coledialog-class.md index bc4e1f0d908..cc997aaebd4 100644 --- a/docs/mfc/reference/coledialog-class.md +++ b/docs/mfc/reference/coledialog-class.md @@ -4,10 +4,12 @@ title: "COleDialog Class" ms.date: "11/04/2016" f1_keywords: ["COleDialog", "AFXODLGS/COleDialog", "AFXODLGS/COleDialog::GetLastError"] helpviewer_keywords: ["COleDialog [MFC], GetLastError"] -ms.assetid: b1ed0aca-3914-4b00-af34-4a4fb491aec7 --- # COleDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides functionality common to dialog boxes for OLE. ## Syntax diff --git a/docs/mfc/reference/coledispatchdriver-class.md b/docs/mfc/reference/coledispatchdriver-class.md index 5984ecda38f..5a08820a954 100644 --- a/docs/mfc/reference/coledispatchdriver-class.md +++ b/docs/mfc/reference/coledispatchdriver-class.md @@ -4,10 +4,12 @@ title: "COleDispatchDriver Class" ms.date: "11/04/2016" f1_keywords: ["COleDispatchDriver", "AFXDISP/COleDispatchDriver", "AFXDISP/COleDispatchDriver::COleDispatchDriver", "AFXDISP/COleDispatchDriver::AttachDispatch", "AFXDISP/COleDispatchDriver::CreateDispatch", "AFXDISP/COleDispatchDriver::DetachDispatch", "AFXDISP/COleDispatchDriver::GetProperty", "AFXDISP/COleDispatchDriver::InvokeHelper", "AFXDISP/COleDispatchDriver::ReleaseDispatch", "AFXDISP/COleDispatchDriver::SetProperty", "AFXDISP/COleDispatchDriver::m_bAutoRelease", "AFXDISP/COleDispatchDriver::m_lpDispatch"] helpviewer_keywords: ["COleDispatchDriver [MFC], COleDispatchDriver", "COleDispatchDriver [MFC], AttachDispatch", "COleDispatchDriver [MFC], CreateDispatch", "COleDispatchDriver [MFC], DetachDispatch", "COleDispatchDriver [MFC], GetProperty", "COleDispatchDriver [MFC], InvokeHelper", "COleDispatchDriver [MFC], ReleaseDispatch", "COleDispatchDriver [MFC], SetProperty", "COleDispatchDriver [MFC], m_bAutoRelease", "COleDispatchDriver [MFC], m_lpDispatch"] -ms.assetid: 3ed98daf-cdc7-4374-8a0c-cf695a8d3657 --- # COleDispatchDriver Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the client side of OLE automation. ## Syntax diff --git a/docs/mfc/reference/coledispatchexception-class.md b/docs/mfc/reference/coledispatchexception-class.md index a37125f8492..c95af10037c 100644 --- a/docs/mfc/reference/coledispatchexception-class.md +++ b/docs/mfc/reference/coledispatchexception-class.md @@ -4,10 +4,12 @@ title: "COleDispatchException Class" ms.date: "11/04/2016" f1_keywords: ["COleDispatchException", "AFXDISP/COleDispatchException", "AFXDISP/COleDispatchException::m_dwHelpContext", "AFXDISP/COleDispatchException::m_strDescription", "AFXDISP/COleDispatchException::m_strHelpFile", "AFXDISP/COleDispatchException::m_strSource", "AFXDISP/COleDispatchException::m_wCode"] helpviewer_keywords: ["COleDispatchException [MFC], m_dwHelpContext", "COleDispatchException [MFC], m_strDescription", "COleDispatchException [MFC], m_strHelpFile", "COleDispatchException [MFC], m_strSource", "COleDispatchException [MFC], m_wCode"] -ms.assetid: 0e95c8be-e21a-490c-99ec-181c6a9a26d0 --- # COleDispatchException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Handles exceptions specific to the OLE `IDispatch` interface, which is a key part of OLE automation. ## Syntax diff --git a/docs/mfc/reference/coledocobjectitem-class.md b/docs/mfc/reference/coledocobjectitem-class.md index 91854ce6bb8..5bf120dd054 100644 --- a/docs/mfc/reference/coledocobjectitem-class.md +++ b/docs/mfc/reference/coledocobjectitem-class.md @@ -4,10 +4,12 @@ title: "COleDocObjectItem Class" ms.date: "11/04/2016" f1_keywords: ["COleDocObjectItem", "AFXOLE/COleDocObjectItem", "AFXOLE/COleDocObjectItem::COleDocObjectItem", "AFXOLE/COleDocObjectItem::DoDefaultPrinting", "AFXOLE/COleDocObjectItem::ExecCommand", "AFXOLE/COleDocObjectItem::GetActiveView", "AFXOLE/COleDocObjectItem::GetPageCount", "AFXOLE/COleDocObjectItem::OnPreparePrinting", "AFXOLE/COleDocObjectItem::OnPrint", "AFXOLE/COleDocObjectItem::QueryCommand", "AFXOLE/COleDocObjectItem::Release"] helpviewer_keywords: ["COleDocObjectItem [MFC], COleDocObjectItem", "COleDocObjectItem [MFC], DoDefaultPrinting", "COleDocObjectItem [MFC], ExecCommand", "COleDocObjectItem [MFC], GetActiveView", "COleDocObjectItem [MFC], GetPageCount", "COleDocObjectItem [MFC], OnPreparePrinting", "COleDocObjectItem [MFC], OnPrint", "COleDocObjectItem [MFC], QueryCommand", "COleDocObjectItem [MFC], Release"] -ms.assetid: d150d306-8fd3-4831-b06d-afbe71d8fc9b --- # COleDocObjectItem Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements Active document containment. ## Syntax diff --git a/docs/mfc/reference/coledocument-class.md b/docs/mfc/reference/coledocument-class.md index fe1959bf1aa..9c792ffd574 100644 --- a/docs/mfc/reference/coledocument-class.md +++ b/docs/mfc/reference/coledocument-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleDocument [MFC], COleDocument", "COleDocument [MFC], A --- # COleDocument Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for OLE documents that support visual editing. ## Syntax diff --git a/docs/mfc/reference/coledropsource-class.md b/docs/mfc/reference/coledropsource-class.md index 1681ecaa0d2..e00dc920b0b 100644 --- a/docs/mfc/reference/coledropsource-class.md +++ b/docs/mfc/reference/coledropsource-class.md @@ -4,10 +4,12 @@ title: "COleDropSource Class" ms.date: "11/04/2016" f1_keywords: ["COleDropSource", "AFXOLE/COleDropSource", "AFXOLE/COleDropSource::COleDropSource", "AFXOLE/COleDropSource::GiveFeedback", "AFXOLE/COleDropSource::OnBeginDrag", "AFXOLE/COleDropSource::QueryContinueDrag"] helpviewer_keywords: ["COleDropSource [MFC], COleDropSource", "COleDropSource [MFC], GiveFeedback", "COleDropSource [MFC], OnBeginDrag", "COleDropSource [MFC], QueryContinueDrag"] -ms.assetid: d3eecc5f-a70b-4a01-b705-7d2c098ebe17 --- # COleDropSource Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allows data to be dragged to a drop target. ## Syntax diff --git a/docs/mfc/reference/coledroptarget-class.md b/docs/mfc/reference/coledroptarget-class.md index 302ff8d19da..e9bd9141c53 100644 --- a/docs/mfc/reference/coledroptarget-class.md +++ b/docs/mfc/reference/coledroptarget-class.md @@ -4,10 +4,12 @@ title: "COleDropTarget Class" ms.date: "11/04/2016" f1_keywords: ["COleDropTarget", "AFXOLE/COleDropTarget", "AFXOLE/COleDropTarget::COleDropTarget", "AFXOLE/COleDropTarget::OnDragEnter", "AFXOLE/COleDropTarget::OnDragLeave", "AFXOLE/COleDropTarget::OnDragOver", "AFXOLE/COleDropTarget::OnDragScroll", "AFXOLE/COleDropTarget::OnDrop", "AFXOLE/COleDropTarget::OnDropEx", "AFXOLE/COleDropTarget::Register", "AFXOLE/COleDropTarget::Revoke"] helpviewer_keywords: ["COleDropTarget [MFC], COleDropTarget", "COleDropTarget [MFC], OnDragEnter", "COleDropTarget [MFC], OnDragLeave", "COleDropTarget [MFC], OnDragOver", "COleDropTarget [MFC], OnDragScroll", "COleDropTarget [MFC], OnDrop", "COleDropTarget [MFC], OnDropEx", "COleDropTarget [MFC], Register", "COleDropTarget [MFC], Revoke"] -ms.assetid: a58c9a48-6a93-4357-b078-4594df258311 --- # COleDropTarget Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the communication mechanism between a window and the OLE libraries. ## Syntax diff --git a/docs/mfc/reference/coleexception-class.md b/docs/mfc/reference/coleexception-class.md index c9c34fbd723..f78ec5f29fb 100644 --- a/docs/mfc/reference/coleexception-class.md +++ b/docs/mfc/reference/coleexception-class.md @@ -4,10 +4,12 @@ title: "COleException Class" ms.date: "11/04/2016" f1_keywords: ["COleException", "AFXDISP/COleException", "AFXDISP/COleException::Process", "AFXDISP/COleException::m_sc"] helpviewer_keywords: ["COleException [MFC], Process", "COleException [MFC], m_sc"] -ms.assetid: 2571e9fe-26cc-42f0-9ad9-8ad5b4311ec1 --- # COleException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an exception condition related to an OLE operation. ## Syntax diff --git a/docs/mfc/reference/coleinsertdialog-class.md b/docs/mfc/reference/coleinsertdialog-class.md index 976c1cfaacb..229f2ae0ac3 100644 --- a/docs/mfc/reference/coleinsertdialog-class.md +++ b/docs/mfc/reference/coleinsertdialog-class.md @@ -4,10 +4,12 @@ title: "COleInsertDialog Class" ms.date: "11/04/2016" f1_keywords: ["COleInsertDialog", "AFXODLGS/COleInsertDialog", "AFXODLGS/COleInsertDialog::COleInsertDialog", "AFXODLGS/COleInsertDialog::CreateItem", "AFXODLGS/COleInsertDialog::DoModal", "AFXODLGS/COleInsertDialog::GetClassID", "AFXODLGS/COleInsertDialog::GetDrawAspect", "AFXODLGS/COleInsertDialog::GetIconicMetafile", "AFXODLGS/COleInsertDialog::GetPathName", "AFXODLGS/COleInsertDialog::GetSelectionType", "AFXODLGS/COleInsertDialog::m_io"] helpviewer_keywords: ["COleInsertDialog [MFC], COleInsertDialog", "COleInsertDialog [MFC], CreateItem", "COleInsertDialog [MFC], DoModal", "COleInsertDialog [MFC], GetClassID", "COleInsertDialog [MFC], GetDrawAspect", "COleInsertDialog [MFC], GetIconicMetafile", "COleInsertDialog [MFC], GetPathName", "COleInsertDialog [MFC], GetSelectionType", "COleInsertDialog [MFC], m_io"] -ms.assetid: a9ec610b-abde-431e-bd01-c40159a66dbb --- # COleInsertDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used for the OLE Insert Object dialog box. ## Syntax diff --git a/docs/mfc/reference/coleipframewnd-class.md b/docs/mfc/reference/coleipframewnd-class.md index 268e34a20cd..01d3333f30c 100644 --- a/docs/mfc/reference/coleipframewnd-class.md +++ b/docs/mfc/reference/coleipframewnd-class.md @@ -4,10 +4,12 @@ title: "COleIPFrameWnd Class" ms.date: "11/04/2016" f1_keywords: ["COleIPFrameWnd", "AFXOLE/COleIPFrameWnd", "AFXOLE/COleIPFrameWnd::COleIPFrameWnd", "AFXOLE/COleIPFrameWnd::OnCreateControlBars", "AFXOLE/COleIPFrameWnd::RepositionFrame"] helpviewer_keywords: ["COleIPFrameWnd [MFC], COleIPFrameWnd", "COleIPFrameWnd [MFC], OnCreateControlBars", "COleIPFrameWnd [MFC], RepositionFrame"] -ms.assetid: 24abb2cb-826c-4dda-a287-d8a8900a5763 --- # COleIPFrameWnd Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base for your application's in-place editing window. ## Syntax diff --git a/docs/mfc/reference/coleipframewndex-class.md b/docs/mfc/reference/coleipframewndex-class.md index 51faf2f1521..e309d938cf8 100644 --- a/docs/mfc/reference/coleipframewndex-class.md +++ b/docs/mfc/reference/coleipframewndex-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleIPFrameWndEx [MFC], AddDockSite", "COleIPFrameWndEx [ --- # COleIPFrameWndEx Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `COleIPFrameWndEx` class implements an OLE container that supports MFC. You must derive the in-place frame window class for your application from the `COleIPFrameWndEx` class, instead of deriving it from the [COleIPFrameWnd](../../mfc/reference/coleipframewnd-class.md) class. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/colelinkingdoc-class.md b/docs/mfc/reference/colelinkingdoc-class.md index a0e9bc58586..e81abbb02b1 100644 --- a/docs/mfc/reference/colelinkingdoc-class.md +++ b/docs/mfc/reference/colelinkingdoc-class.md @@ -4,10 +4,12 @@ title: "COleLinkingDoc Class" ms.date: "11/04/2016" f1_keywords: ["COleLinkingDoc", "AFXOLE/COleLinkingDoc", "AFXOLE/COleLinkingDoc::COleLinkingDoc", "AFXOLE/COleLinkingDoc::Register", "AFXOLE/COleLinkingDoc::Revoke", "AFXOLE/COleLinkingDoc::OnFindEmbeddedItem", "AFXOLE/COleLinkingDoc::OnGetLinkedItem"] helpviewer_keywords: ["COleLinkingDoc [MFC], COleLinkingDoc", "COleLinkingDoc [MFC], Register", "COleLinkingDoc [MFC], Revoke", "COleLinkingDoc [MFC], OnFindEmbeddedItem", "COleLinkingDoc [MFC], OnGetLinkedItem"] -ms.assetid: 9f547f35-2f95-427f-b9c0-85c31940198b --- # COleLinkingDoc Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for OLE container documents that support linking to the embedded items they contain. ## Syntax diff --git a/docs/mfc/reference/colelinksdialog-class.md b/docs/mfc/reference/colelinksdialog-class.md index 9f58c147848..af1f098034d 100644 --- a/docs/mfc/reference/colelinksdialog-class.md +++ b/docs/mfc/reference/colelinksdialog-class.md @@ -4,10 +4,12 @@ title: "COleLinksDialog Class" ms.date: "11/04/2016" f1_keywords: ["COleLinksDialog", "AFXODLGS/COleLinksDialog", "AFXODLGS/COleLinksDialog::COleLinksDialog", "AFXODLGS/COleLinksDialog::DoModal", "AFXODLGS/COleLinksDialog::m_el"] helpviewer_keywords: ["COleLinksDialog [MFC], COleLinksDialog", "COleLinksDialog [MFC], DoModal", "COleLinksDialog [MFC], m_el"] -ms.assetid: fb2eb638-2809-46db-ac74-392a732affc7 --- # COleLinksDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used for the OLE Edit Links dialog box. ## Syntax diff --git a/docs/mfc/reference/colemessagefilter-class.md b/docs/mfc/reference/colemessagefilter-class.md index 4fe6409199c..51294d30e72 100644 --- a/docs/mfc/reference/colemessagefilter-class.md +++ b/docs/mfc/reference/colemessagefilter-class.md @@ -4,10 +4,12 @@ title: "COleMessageFilter Class" ms.date: "11/04/2016" f1_keywords: ["COleMessageFilter", "AFXOLE/COleMessageFilter", "AFXOLE/COleMessageFilter::COleMessageFilter", "AFXOLE/COleMessageFilter::BeginBusyState", "AFXOLE/COleMessageFilter::EnableBusyDialog", "AFXOLE/COleMessageFilter::EnableNotRespondingDialog", "AFXOLE/COleMessageFilter::EndBusyState", "AFXOLE/COleMessageFilter::OnMessagePending", "AFXOLE/COleMessageFilter::Register", "AFXOLE/COleMessageFilter::Revoke", "AFXOLE/COleMessageFilter::SetBusyReply", "AFXOLE/COleMessageFilter::SetMessagePendingDelay", "AFXOLE/COleMessageFilter::SetRetryReply"] helpviewer_keywords: ["COleMessageFilter [MFC], COleMessageFilter", "COleMessageFilter [MFC], BeginBusyState", "COleMessageFilter [MFC], EnableBusyDialog", "COleMessageFilter [MFC], EnableNotRespondingDialog", "COleMessageFilter [MFC], EndBusyState", "COleMessageFilter [MFC], OnMessagePending", "COleMessageFilter [MFC], Register", "COleMessageFilter [MFC], Revoke", "COleMessageFilter [MFC], SetBusyReply", "COleMessageFilter [MFC], SetMessagePendingDelay", "COleMessageFilter [MFC], SetRetryReply"] -ms.assetid: b1fd1639-fac4-4fd0-bf17-15172deba13c --- # COleMessageFilter Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages the concurrency required by the interaction of OLE applications. ## Syntax diff --git a/docs/mfc/reference/coleobjectfactory-class.md b/docs/mfc/reference/coleobjectfactory-class.md index e1b3a5411d5..08a19604d79 100644 --- a/docs/mfc/reference/coleobjectfactory-class.md +++ b/docs/mfc/reference/coleobjectfactory-class.md @@ -4,10 +4,12 @@ title: "COleObjectFactory Class" ms.date: "11/04/2016" f1_keywords: ["COleObjectFactory", "AFXDISP/COleObjectFactory", "AFXDISP/COleObjectFactory::COleObjectFactory", "AFXDISP/COleObjectFactory::GetClassID", "AFXDISP/COleObjectFactory::IsLicenseValid", "AFXDISP/COleObjectFactory::IsRegistered", "AFXDISP/COleObjectFactory::Register", "AFXDISP/COleObjectFactory::RegisterAll", "AFXDISP/COleObjectFactory::Revoke", "AFXDISP/COleObjectFactory::RevokeAll", "AFXDISP/COleObjectFactory::UnregisterAll", "AFXDISP/COleObjectFactory::UpdateRegistry", "AFXDISP/COleObjectFactory::UpdateRegistryAll", "AFXDISP/COleObjectFactory::GetLicenseKey", "AFXDISP/COleObjectFactory::OnCreateObject", "AFXDISP/COleObjectFactory::VerifyLicenseKey", "AFXDISP/COleObjectFactory::VerifyUserLicense"] helpviewer_keywords: ["COleObjectFactory [MFC], COleObjectFactory", "COleObjectFactory [MFC], GetClassID", "COleObjectFactory [MFC], IsLicenseValid", "COleObjectFactory [MFC], IsRegistered", "COleObjectFactory [MFC], Register", "COleObjectFactory [MFC], RegisterAll", "COleObjectFactory [MFC], Revoke", "COleObjectFactory [MFC], RevokeAll", "COleObjectFactory [MFC], UnregisterAll", "COleObjectFactory [MFC], UpdateRegistry", "COleObjectFactory [MFC], UpdateRegistryAll", "COleObjectFactory [MFC], GetLicenseKey", "COleObjectFactory [MFC], OnCreateObject", "COleObjectFactory [MFC], VerifyLicenseKey", "COleObjectFactory [MFC], VerifyUserLicense"] -ms.assetid: ab179c1e-4af2-44aa-a576-37c48149b427 --- # COleObjectFactory Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the OLE class factory, which creates OLE objects such as servers, automation objects, and documents. ## Syntax diff --git a/docs/mfc/reference/colepastespecialdialog-class.md b/docs/mfc/reference/colepastespecialdialog-class.md index cfc6e49021c..26e5fd4a445 100644 --- a/docs/mfc/reference/colepastespecialdialog-class.md +++ b/docs/mfc/reference/colepastespecialdialog-class.md @@ -4,10 +4,12 @@ title: "COlePasteSpecialDialog Class" ms.date: "11/04/2016" f1_keywords: ["COlePasteSpecialDialog", "AFXODLGS/COlePasteSpecialDialog", "AFXODLGS/COlePasteSpecialDialog::COlePasteSpecialDialog", "AFXODLGS/COlePasteSpecialDialog::AddFormat", "AFXODLGS/COlePasteSpecialDialog::AddLinkEntry", "AFXODLGS/COlePasteSpecialDialog::AddStandardFormats", "AFXODLGS/COlePasteSpecialDialog::CreateItem", "AFXODLGS/COlePasteSpecialDialog::DoModal", "AFXODLGS/COlePasteSpecialDialog::GetDrawAspect", "AFXODLGS/COlePasteSpecialDialog::GetIconicMetafile", "AFXODLGS/COlePasteSpecialDialog::GetPasteIndex", "AFXODLGS/COlePasteSpecialDialog::GetSelectionType", "AFXODLGS/COlePasteSpecialDialog::m_ps"] helpviewer_keywords: ["COlePasteSpecialDialog [MFC], COlePasteSpecialDialog", "COlePasteSpecialDialog [MFC], AddFormat", "COlePasteSpecialDialog [MFC], AddLinkEntry", "COlePasteSpecialDialog [MFC], AddStandardFormats", "COlePasteSpecialDialog [MFC], CreateItem", "COlePasteSpecialDialog [MFC], DoModal", "COlePasteSpecialDialog [MFC], GetDrawAspect", "COlePasteSpecialDialog [MFC], GetIconicMetafile", "COlePasteSpecialDialog [MFC], GetPasteIndex", "COlePasteSpecialDialog [MFC], GetSelectionType", "COlePasteSpecialDialog [MFC], m_ps"] -ms.assetid: 0e82ef9a-9bbe-457e-8240-42c86a0534f7 --- # COlePasteSpecialDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used for the OLE Paste Special dialog box. ## Syntax diff --git a/docs/mfc/reference/colepropertiesdialog-class.md b/docs/mfc/reference/colepropertiesdialog-class.md index 55ad58f8271..c35ab0d70ec 100644 --- a/docs/mfc/reference/colepropertiesdialog-class.md +++ b/docs/mfc/reference/colepropertiesdialog-class.md @@ -4,10 +4,12 @@ title: "COlePropertiesDialog Class" ms.date: "11/04/2016" f1_keywords: ["COlePropertiesDialog", "AFXODLGS/COlePropertiesDialog", "AFXODLGS/COlePropertiesDialog::COlePropertiesDialog", "AFXODLGS/COlePropertiesDialog::DoModal", "AFXODLGS/COlePropertiesDialog::OnApplyScale", "AFXODLGS/COlePropertiesDialog::m_gp", "AFXODLGS/COlePropertiesDialog::m_lp", "AFXODLGS/COlePropertiesDialog::m_op", "AFXODLGS/COlePropertiesDialog::m_psh", "AFXODLGS/COlePropertiesDialog::m_vp"] helpviewer_keywords: ["COlePropertiesDialog [MFC], COlePropertiesDialog", "COlePropertiesDialog [MFC], DoModal", "COlePropertiesDialog [MFC], OnApplyScale", "COlePropertiesDialog [MFC], m_gp", "COlePropertiesDialog [MFC], m_lp", "COlePropertiesDialog [MFC], m_op", "COlePropertiesDialog [MFC], m_psh", "COlePropertiesDialog [MFC], m_vp"] -ms.assetid: a54dbc89-1447-4329-bd01-00e98ec9e935 --- # COlePropertiesDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the Windows common OLE Object Properties dialog box. ## Syntax diff --git a/docs/mfc/reference/colepropertypage-class.md b/docs/mfc/reference/colepropertypage-class.md index bc1c760b238..e9d69c786df 100644 --- a/docs/mfc/reference/colepropertypage-class.md +++ b/docs/mfc/reference/colepropertypage-class.md @@ -4,10 +4,12 @@ title: "COlePropertyPage Class" ms.date: "11/04/2016" f1_keywords: ["COlePropertyPage", "AFXCTL/COlePropertyPage", "AFXCTL/COlePropertyPage::COlePropertyPage", "AFXCTL/COlePropertyPage::GetControlStatus", "AFXCTL/COlePropertyPage::GetObjectArray", "AFXCTL/COlePropertyPage::GetPageSite", "AFXCTL/COlePropertyPage::OVERWRITEApply", "AFXCTL/COlePropertyPage::IsModified", "AFXCTL/COlePropertyPage::OnEditProperty", "AFXCTL/COlePropertyPage::OnHelp", "AFXCTL/COlePropertyPage::OnInitDialog", "AFXCTL/COlePropertyPage::OnObjectsChanged", "AFXCTL/COlePropertyPage::OnSetPageSite", "AFXCTL/COlePropertyPage::SetControlStatus", "AFXCTL/COlePropertyPage::SetDialogResource", "AFXCTL/COlePropertyPage::SetHelpInfo", "AFXCTL/COlePropertyPage::SetModifiedFlag", "AFXCTL/COlePropertyPage::SetPageName"] helpviewer_keywords: ["COlePropertyPage [MFC], COlePropertyPage", "COlePropertyPage [MFC], GetControlStatus", "COlePropertyPage [MFC], GetObjectArray", "COlePropertyPage [MFC], GetPageSite", "COlePropertyPage [MFC], IgnoreApply", "COlePropertyPage [MFC], IsModified", "COlePropertyPage [MFC], OnEditProperty", "COlePropertyPage [MFC], OnHelp", "COlePropertyPage [MFC], OnInitDialog", "COlePropertyPage [MFC], OnObjectsChanged", "COlePropertyPage [MFC], OnSetPageSite", "COlePropertyPage [MFC], SetControlStatus", "COlePropertyPage [MFC], SetDialogResource", "COlePropertyPage [MFC], SetHelpInfo", "COlePropertyPage [MFC], SetModifiedFlag", "COlePropertyPage [MFC], SetPageName"] -ms.assetid: e9972872-8e6b-4550-905e-d36a274d64dc --- # COlePropertyPage Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used to display the properties of a custom control in a graphical interface, similar to a dialog box. ## Syntax From 2348f344097a8ff6d6a52648caa490df36f0d020 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 20 Feb 2026 11:03:11 -0800 Subject: [PATCH 1634/1799] Batch 9: update files --- docs/mfc/reference/coleresizebar-class.md | 4 +++- docs/mfc/reference/colesafearray-class.md | 3 +++ docs/mfc/reference/coleserverdoc-class.md | 3 +++ docs/mfc/reference/coleserveritem-class.md | 4 +++- docs/mfc/reference/colestreamfile-class.md | 3 +++ docs/mfc/reference/coletemplateserver-class.md | 3 +++ docs/mfc/reference/coleupdatedialog-class.md | 4 +++- docs/mfc/reference/colevariant-class.md | 3 +++ docs/mfc/reference/collection-class-helpers.md | 3 +++ docs/mfc/reference/combo-box-handlers.md | 4 +++- .../compound-document-support-mfc-application-wizard.md | 4 +++- docs/mfc/reference/connection-maps.md | 3 +++ .../mfc/reference/control-names-mfc-activex-control-wizard.md | 4 +++- .../reference/control-settings-mfc-activex-control-wizard.md | 4 +++- docs/mfc/reference/cpagerctrl-class.md | 4 +++- docs/mfc/reference/cpagesetupdialog-class.md | 4 +++- docs/mfc/reference/cpaintdc-class.md | 3 +++ docs/mfc/reference/cpalette-class.md | 4 +++- docs/mfc/reference/cpane-class.md | 3 +++ docs/mfc/reference/cpanecontainer-class.md | 3 +++ docs/mfc/reference/cpanecontainermanager-class.md | 4 +++- docs/mfc/reference/cpanedialog-class.md | 4 +++- docs/mfc/reference/cpanedivider-class.md | 4 +++- docs/mfc/reference/cpaneframewnd-class.md | 4 +++- .../reference/cparabolictransitionfromacceleration-class.md | 4 +++- docs/mfc/reference/cpen-class.md | 3 +++ docs/mfc/reference/cpictureholder-class.md | 4 +++- docs/mfc/reference/cprintdialog-class.md | 3 +++ docs/mfc/reference/cprintdialogex-class.md | 4 +++- docs/mfc/reference/cprintinfo-structure.md | 4 +++- docs/mfc/reference/cprogressctrl-class.md | 3 +++ docs/mfc/reference/cpropertypage-class.md | 3 +++ docs/mfc/reference/cpropertysheet-class.md | 4 +++- docs/mfc/reference/cpropexchange-class.md | 4 +++- docs/mfc/reference/cptrarray-class.md | 4 +++- docs/mfc/reference/cptrlist-class.md | 4 +++- .../creating-a-file-explorer-style-mfc-application.md | 3 +++ docs/mfc/reference/creating-a-forms-based-mfc-application.md | 4 +++- .../reference/creating-a-web-browser-style-mfc-application.md | 3 +++ .../reference/creating-an-mfc-activex-control-container.md | 4 +++- docs/mfc/reference/creating-an-mfc-activex-control.md | 4 +++- docs/mfc/reference/creating-an-mfc-application.md | 3 +++ docs/mfc/reference/creating-an-mfc-dll-project.md | 4 +++- docs/mfc/reference/crebar-class.md | 4 +++- docs/mfc/reference/crebarctrl-class.md | 3 +++ docs/mfc/reference/crecentdocksiteinfo-class.md | 4 +++- docs/mfc/reference/crecentfilelist-class.md | 4 +++- docs/mfc/reference/crecordset-class.md | 3 +++ docs/mfc/reference/crecordview-class.md | 4 +++- docs/mfc/reference/crecttracker-class.md | 4 +++- docs/mfc/reference/crendertarget-class.md | 4 +++- docs/mfc/reference/cresourceexception-class.md | 4 +++- docs/mfc/reference/creversaltransition-class.md | 4 +++- docs/mfc/reference/crgn-class.md | 3 +++ docs/mfc/reference/cricheditcntritem-class.md | 4 +++- docs/mfc/reference/cricheditctrl-class.md | 3 +++ docs/mfc/reference/cricheditdoc-class.md | 4 +++- docs/mfc/reference/cricheditview-class.md | 4 +++- docs/mfc/reference/cruntimeclass-structure.md | 4 +++- docs/mfc/reference/cscrollbar-class.md | 3 +++ docs/mfc/reference/cscrollview-class.md | 3 +++ docs/mfc/reference/csemaphore-class.md | 3 +++ docs/mfc/reference/csettingsstore-class.md | 4 +++- docs/mfc/reference/csettingsstoresp-class.md | 4 +++- docs/mfc/reference/csharedfile-class.md | 4 +++- docs/mfc/reference/cshellmanager-class.md | 4 +++- docs/mfc/reference/csimpleexception-class.md | 4 +++- docs/mfc/reference/csingledoctemplate-class.md | 4 +++- docs/mfc/reference/csinglelock-class.md | 3 +++ docs/mfc/reference/csinusoidaltransitionfromrange-class.md | 4 +++- docs/mfc/reference/csinusoidaltransitionfromvelocity-class.md | 4 +++- docs/mfc/reference/csliderctrl-class.md | 3 +++ docs/mfc/reference/csmartdockinginfo-class.md | 4 +++- docs/mfc/reference/csmoothstoptransition-class.md | 4 +++- docs/mfc/reference/csocket-class.md | 4 +++- docs/mfc/reference/csocketfile-class.md | 4 +++- docs/mfc/reference/cspinbuttonctrl-class.md | 3 +++ docs/mfc/reference/csplitbutton-class.md | 4 +++- docs/mfc/reference/csplitterwnd-class.md | 3 +++ docs/mfc/reference/csplitterwndex-class.md | 4 +++- docs/mfc/reference/cstatic-class.md | 4 +++- docs/mfc/reference/cstatusbar-class.md | 3 +++ docs/mfc/reference/cstatusbarctrl-class.md | 4 +++- docs/mfc/reference/cstdiofile-class.md | 3 +++ .../reference/cstring-formatting-and-message-box-display.md | 4 +++- docs/mfc/reference/cstringarray-class.md | 3 +++ docs/mfc/reference/cstringlist-class.md | 3 +++ docs/mfc/reference/csyncobject-class.md | 4 +++- docs/mfc/reference/ctabbedpane-class.md | 4 +++- docs/mfc/reference/ctabctrl-class.md | 3 +++ docs/mfc/reference/ctabview-class.md | 3 +++ docs/mfc/reference/ctaskdialog-class.md | 4 +++- docs/mfc/reference/ctoolbar-class.md | 3 +++ docs/mfc/reference/ctoolbarctrl-class.md | 3 +++ docs/mfc/reference/ctooltipctrl-class.md | 3 +++ docs/mfc/reference/ctooltipmanager-class.md | 4 +++- docs/mfc/reference/ctreectrl-class.md | 4 +++- docs/mfc/reference/ctreeview-class.md | 4 +++- docs/mfc/reference/ctypedptrarray-class.md | 3 +++ docs/mfc/reference/ctypedptrlist-class.md | 3 +++ 100 files changed, 300 insertions(+), 61 deletions(-) diff --git a/docs/mfc/reference/coleresizebar-class.md b/docs/mfc/reference/coleresizebar-class.md index 1066e554e7a..5909bb78628 100644 --- a/docs/mfc/reference/coleresizebar-class.md +++ b/docs/mfc/reference/coleresizebar-class.md @@ -4,10 +4,12 @@ title: "COleResizeBar Class" ms.date: "11/04/2016" f1_keywords: ["COleResizeBar", "AFXOLE/COleResizeBar", "AFXOLE/COleResizeBar::COleResizeBar", "AFXOLE/COleResizeBar::Create"] helpviewer_keywords: ["COleResizeBar [MFC], COleResizeBar", "COleResizeBar [MFC], Create"] -ms.assetid: 56a708d9-28c5-4eb0-9404-77b688d91c63 --- # COleResizeBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A type of control bar that supports resizing of in-place OLE items. ## Syntax diff --git a/docs/mfc/reference/colesafearray-class.md b/docs/mfc/reference/colesafearray-class.md index f85c05baf87..322140c97cd 100644 --- a/docs/mfc/reference/colesafearray-class.md +++ b/docs/mfc/reference/colesafearray-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleSafeArray [MFC], COleSafeArray", "COleSafeArray [MFC] --- # COleSafeArray Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A class for working with arrays of arbitrary type and dimension. ## Syntax diff --git a/docs/mfc/reference/coleserverdoc-class.md b/docs/mfc/reference/coleserverdoc-class.md index b81a4ff6fdf..c9c350b8214 100644 --- a/docs/mfc/reference/coleserverdoc-class.md +++ b/docs/mfc/reference/coleserverdoc-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleServerDoc [MFC], COleServerDoc", "COleServerDoc [MFC] --- # COleServerDoc Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for OLE server documents. ## Syntax diff --git a/docs/mfc/reference/coleserveritem-class.md b/docs/mfc/reference/coleserveritem-class.md index 44a7e5a498a..61718ed04e1 100644 --- a/docs/mfc/reference/coleserveritem-class.md +++ b/docs/mfc/reference/coleserveritem-class.md @@ -4,10 +4,12 @@ title: "COleServerItem Class" ms.date: "11/04/2016" f1_keywords: ["COleServerItem", "AFXOLE/COleServerItem", "AFXOLE/COleServerItem::COleServerItem", "AFXOLE/COleServerItem::AddOtherClipboardData", "AFXOLE/COleServerItem::CopyToClipboard", "AFXOLE/COleServerItem::DoDragDrop", "AFXOLE/COleServerItem::GetClipboardData", "AFXOLE/COleServerItem::GetDocument", "AFXOLE/COleServerItem::GetEmbedSourceData", "AFXOLE/COleServerItem::GetItemName", "AFXOLE/COleServerItem::GetLinkSourceData", "AFXOLE/COleServerItem::GetObjectDescriptorData", "AFXOLE/COleServerItem::IsConnected", "AFXOLE/COleServerItem::IsLinkedItem", "AFXOLE/COleServerItem::NotifyChanged", "AFXOLE/COleServerItem::OnDoVerb", "AFXOLE/COleServerItem::OnDraw", "AFXOLE/COleServerItem::OnDrawEx", "AFXOLE/COleServerItem::OnGetClipboardData", "AFXOLE/COleServerItem::OnGetExtent", "AFXOLE/COleServerItem::OnInitFromData", "AFXOLE/COleServerItem::OnQueryUpdateItems", "AFXOLE/COleServerItem::OnRenderData", "AFXOLE/COleServerItem::OnRenderFileData", "AFXOLE/COleServerItem::OnRenderGlobalData", "AFXOLE/COleServerItem::OnSetColorScheme", "AFXOLE/COleServerItem::OnSetData", "AFXOLE/COleServerItem::OnSetExtent", "AFXOLE/COleServerItem::OnUpdate", "AFXOLE/COleServerItem::OnUpdateItems", "AFXOLE/COleServerItem::SetItemName", "AFXOLE/COleServerItem::GetDataSource", "AFXOLE/COleServerItem::OnHide", "AFXOLE/COleServerItem::OnOpen", "AFXOLE/COleServerItem::OnShow", "AFXOLE/COleServerItem::m_sizeExtent"] helpviewer_keywords: ["COleServerItem [MFC], COleServerItem", "COleServerItem [MFC], AddOtherClipboardData", "COleServerItem [MFC], CopyToClipboard", "COleServerItem [MFC], DoDragDrop", "COleServerItem [MFC], GetClipboardData", "COleServerItem [MFC], GetDocument", "COleServerItem [MFC], GetEmbedSourceData", "COleServerItem [MFC], GetItemName", "COleServerItem [MFC], GetLinkSourceData", "COleServerItem [MFC], GetObjectDescriptorData", "COleServerItem [MFC], IsConnected", "COleServerItem [MFC], IsLinkedItem", "COleServerItem [MFC], NotifyChanged", "COleServerItem [MFC], OnDoVerb", "COleServerItem [MFC], OnDraw", "COleServerItem [MFC], OnDrawEx", "COleServerItem [MFC], OnGetClipboardData", "COleServerItem [MFC], OnGetExtent", "COleServerItem [MFC], OnInitFromData", "COleServerItem [MFC], OnQueryUpdateItems", "COleServerItem [MFC], OnRenderData", "COleServerItem [MFC], OnRenderFileData", "COleServerItem [MFC], OnRenderGlobalData", "COleServerItem [MFC], OnSetColorScheme", "COleServerItem [MFC], OnSetData", "COleServerItem [MFC], OnSetExtent", "COleServerItem [MFC], OnUpdate", "COleServerItem [MFC], OnUpdateItems", "COleServerItem [MFC], SetItemName", "COleServerItem [MFC], GetDataSource", "COleServerItem [MFC], OnHide", "COleServerItem [MFC], OnOpen", "COleServerItem [MFC], OnShow", "COleServerItem [MFC], m_sizeExtent"] -ms.assetid: 80256df6-3888-4256-944b-787d4b2e6b0d --- # COleServerItem Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the server interface to OLE items. ## Syntax diff --git a/docs/mfc/reference/colestreamfile-class.md b/docs/mfc/reference/colestreamfile-class.md index 964fe4e4dd8..62128112f58 100644 --- a/docs/mfc/reference/colestreamfile-class.md +++ b/docs/mfc/reference/colestreamfile-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleStreamFile [MFC], COleStreamFile", "COleStreamFile [M --- # COleStreamFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a stream of data (`IStream`) in a compound file as part of OLE Structured Storage. ## Syntax diff --git a/docs/mfc/reference/coletemplateserver-class.md b/docs/mfc/reference/coletemplateserver-class.md index 79a0b6e661b..2c2175eb464 100644 --- a/docs/mfc/reference/coletemplateserver-class.md +++ b/docs/mfc/reference/coletemplateserver-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleTemplateServer [MFC], COleTemplateServer", "COleTempl --- # COleTemplateServer Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used for OLE visual editing servers, automation servers, and link containers (applications that support links to embeddings). ## Syntax diff --git a/docs/mfc/reference/coleupdatedialog-class.md b/docs/mfc/reference/coleupdatedialog-class.md index 326d47c4ada..fecc99693b3 100644 --- a/docs/mfc/reference/coleupdatedialog-class.md +++ b/docs/mfc/reference/coleupdatedialog-class.md @@ -4,10 +4,12 @@ title: "COleUpdateDialog Class" ms.date: "11/04/2016" f1_keywords: ["COleUpdateDialog", "AFXODLGS/COleUpdateDialog", "AFXODLGS/COleUpdateDialog::COleUpdateDialog", "AFXODLGS/COleUpdateDialog::DoModal"] helpviewer_keywords: ["COleUpdateDialog [MFC], COleUpdateDialog", "COleUpdateDialog [MFC], DoModal"] -ms.assetid: 699ca980-52b1-4cf8-9ab1-ac6767ad5b0e --- # COleUpdateDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used for a special case of the OLE Edit Links dialog box, which should be used when you need to update only existing linked or embedded objects in a document. ## Syntax diff --git a/docs/mfc/reference/colevariant-class.md b/docs/mfc/reference/colevariant-class.md index f3bc198514a..2bea4e14753 100644 --- a/docs/mfc/reference/colevariant-class.md +++ b/docs/mfc/reference/colevariant-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["COleVariant [MFC], COleVariant", "COleVariant [MFC], Atta --- # COleVariant Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the [VARIANT](/windows/win32/api/oaidl/ns-oaidl-variant) data type. ## Syntax diff --git a/docs/mfc/reference/collection-class-helpers.md b/docs/mfc/reference/collection-class-helpers.md index ca02e0d281f..b89b18ac671 100644 --- a/docs/mfc/reference/collection-class-helpers.md +++ b/docs/mfc/reference/collection-class-helpers.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["DestructElements function", "ConstructElements function", --- # Collection Class Helpers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The collection classes `CMap`, `CList`, and `CArray` use templated global helper functions for such purposes as comparing, copying, and serializing elements. As part of your implementation of classes based on `CMap`, `CList`, and `CArray`, you must override these functions as necessary with versions tailored to the type of data stored in your map, list, or array. For information on overriding helper functions such as `SerializeElements`, see the article [Collections: How to Make a Type-Safe Collection](../../mfc/how-to-make-a-type-safe-collection.md). Note that `ConstructElements` and `DestructElements` have been deprecated. The Microsoft Foundation Class Library provides the following global functions in afxtempl.h to help you customize your collection classes: diff --git a/docs/mfc/reference/combo-box-handlers.md b/docs/mfc/reference/combo-box-handlers.md index 46257dcaf02..f95c442ef4c 100644 --- a/docs/mfc/reference/combo-box-handlers.md +++ b/docs/mfc/reference/combo-box-handlers.md @@ -4,10 +4,12 @@ title: "Combo Box Handlers" ms.date: "11/04/2016" f1_keywords: ["ON_CBN_KILLFOCUS", "ON_CBN_ERRSPACE", "ON_CBN_EDITCHANGE", "ON_CBN_CLOSEUP", "ON_CBN_DBLCLK", "ON_CBN_EDITUPDATE", "ON_CBN_DROPDOWN", "ON_CBN_SELENDOK", "ON_CBN_SELCHANGE", "ON_CBN_SETFOCUS", "ON_CBN_SELENDCANCEL"] helpviewer_keywords: ["ON_CBN_CLOSEUP", "ON_CBN_SETFOCUS", "ON_CBN_DBLCLK", "ON_CBN_SELENDCANCEL", "ON_CBN_DROPDOWN", "ON_CBN_EDITUPDATE", "ON_CBN_KILLFOCUS", "combo boxes [MFC], handlers", "ON_CBN_EDITCHANGE", "ON_CBN_ERRSPACE", "ON_CBN_SELENDOK", "ON_CBN_SELCHANGE"] -ms.assetid: 7f092412-01b7-4242-95ec-41ba506b9d71 --- # Combo Box Handlers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries correspond to the function prototypes. |Map entry|Function prototype| diff --git a/docs/mfc/reference/compound-document-support-mfc-application-wizard.md b/docs/mfc/reference/compound-document-support-mfc-application-wizard.md index cf2cac48dfd..6ad2ec8f2f1 100644 --- a/docs/mfc/reference/compound-document-support-mfc-application-wizard.md +++ b/docs/mfc/reference/compound-document-support-mfc-application-wizard.md @@ -3,10 +3,12 @@ description: "Learn more about: Compound Document Support, MFC Application Wizar title: "Compound Document Support, MFC Application Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.exe.compdoc"] -ms.assetid: 42e1af83-12c4-438d-92eb-13835afdb148 --- # Compound Document Support, MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In this page of the MFC Application Wizard, indicate to what level your application provides compound and active document support. Your application must support the document/view architecture to support compound documents and document templates. By default, the application contains no compound document support. If you accept this default, your application cannot support active documents or compound files. diff --git a/docs/mfc/reference/connection-maps.md b/docs/mfc/reference/connection-maps.md index 021a53eeade..db3d8ce0988 100644 --- a/docs/mfc/reference/connection-maps.md +++ b/docs/mfc/reference/connection-maps.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["connection maps"] # Connection maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + OLE controls are able to expose interfaces to other applications. These interfaces only allow access from a container into that control. If an OLE control wants to access external interfaces of other OLE objects, a connection point must be established. This connection point allows a control outgoing access to external dispatch maps, such as event maps or notification functions. The Microsoft Foundation Class Library offers a programming model that supports connection points. In this model, "connection maps" are used to designate interfaces or connection points for the OLE control. Connection maps contain one macro for each connection point. For more information on connection maps, see the [`CConnectionPoint`](../../mfc/reference/cconnectionpoint-class.md) class. diff --git a/docs/mfc/reference/control-names-mfc-activex-control-wizard.md b/docs/mfc/reference/control-names-mfc-activex-control-wizard.md index 9d6baedbd15..1ee01d5de06 100644 --- a/docs/mfc/reference/control-names-mfc-activex-control-wizard.md +++ b/docs/mfc/reference/control-names-mfc-activex-control-wizard.md @@ -4,10 +4,12 @@ title: "Control Names, MFC ActiveX Control Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.ctl.names"] helpviewer_keywords: ["MFC ActiveX Control Wizard, control names"] -ms.assetid: 9b8b81d2-36df-48ed-b58a-a771a0e269ee --- # Control Names, MFC ActiveX Control Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Specify the names for the control class and property page class, the type names, and type identifiers for your control. With the exception of **Short name**, all other fields can be edited independently. If you change the text for **Short name**, the change is reflected in the names of all other fields in this page. This naming behavior is designed to make all the names easily identifiable for you as you develop your control. - **Short name** diff --git a/docs/mfc/reference/control-settings-mfc-activex-control-wizard.md b/docs/mfc/reference/control-settings-mfc-activex-control-wizard.md index 6fe38cbe3b5..6c7a98c6210 100644 --- a/docs/mfc/reference/control-settings-mfc-activex-control-wizard.md +++ b/docs/mfc/reference/control-settings-mfc-activex-control-wizard.md @@ -4,10 +4,12 @@ title: "Control Settings, MFC ActiveX Control Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.ctl.settings"] helpviewer_keywords: ["MFC ActiveX Control Wizard, control settings"] -ms.assetid: 2ccaa4fc-0d52-413e-afa3-ecd474c3f6f0 --- # Control Settings, MFC ActiveX Control Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use this page of the wizard to specify how you want the control to behave. For example, you can base the control on standard Windows control types, optimize its behavior and appearance, or indicate that the control can act as a container for other controls. For more information about how to select options on this page to maximize the efficiency of the control, see [MFC ActiveX Controls: Optimization](../../mfc/mfc-activex-controls-optimization.md). diff --git a/docs/mfc/reference/cpagerctrl-class.md b/docs/mfc/reference/cpagerctrl-class.md index 78da74a2235..e04ec30cc21 100644 --- a/docs/mfc/reference/cpagerctrl-class.md +++ b/docs/mfc/reference/cpagerctrl-class.md @@ -4,10 +4,12 @@ title: "CPagerCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CPagerCtrl", "AFXCMN/CPagerCtrl", "AFXCMN/CPagerCtrl::CPagerCtrl", "AFXCMN/CPagerCtrl::Create", "AFXCMN/CPagerCtrl::CreateEx", "AFXCMN/CPagerCtrl::ForwardMouse", "AFXCMN/CPagerCtrl::GetBkColor", "AFXCMN/CPagerCtrl::GetBorder", "AFXCMN/CPagerCtrl::GetButtonSize", "AFXCMN/CPagerCtrl::GetButtonState", "AFXCMN/CPagerCtrl::GetDropTarget", "AFXCMN/CPagerCtrl::GetScrollPos", "AFXCMN/CPagerCtrl::IsButtonDepressed", "AFXCMN/CPagerCtrl::IsButtonGrayed", "AFXCMN/CPagerCtrl::IsButtonHot", "AFXCMN/CPagerCtrl::IsButtonInvisible", "AFXCMN/CPagerCtrl::IsButtonNormal", "AFXCMN/CPagerCtrl::RecalcSize", "AFXCMN/CPagerCtrl::SetBkColor", "AFXCMN/CPagerCtrl::SetBorder", "AFXCMN/CPagerCtrl::SetButtonSize", "AFXCMN/CPagerCtrl::SetChild", "AFXCMN/CPagerCtrl::SetScrollPos"] helpviewer_keywords: ["CPagerCtrl [MFC], CPagerCtrl", "CPagerCtrl [MFC], Create", "CPagerCtrl [MFC], CreateEx", "CPagerCtrl [MFC], ForwardMouse", "CPagerCtrl [MFC], GetBkColor", "CPagerCtrl [MFC], GetBorder", "CPagerCtrl [MFC], GetButtonSize", "CPagerCtrl [MFC], GetButtonState", "CPagerCtrl [MFC], GetDropTarget", "CPagerCtrl [MFC], GetScrollPos", "CPagerCtrl [MFC], IsButtonDepressed", "CPagerCtrl [MFC], IsButtonGrayed", "CPagerCtrl [MFC], IsButtonHot", "CPagerCtrl [MFC], IsButtonInvisible", "CPagerCtrl [MFC], IsButtonNormal", "CPagerCtrl [MFC], RecalcSize", "CPagerCtrl [MFC], SetBkColor", "CPagerCtrl [MFC], SetBorder", "CPagerCtrl [MFC], SetButtonSize", "CPagerCtrl [MFC], SetChild", "CPagerCtrl [MFC], SetScrollPos"] -ms.assetid: 65ac58dd-4f5e-4b7e-b15c-e0d435a7e884 --- # CPagerCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CPagerCtrl` class wraps the Windows pager control, which can scroll into view a contained window that does not fit the containing window. ## Syntax diff --git a/docs/mfc/reference/cpagesetupdialog-class.md b/docs/mfc/reference/cpagesetupdialog-class.md index bf629aa89cc..296f1412590 100644 --- a/docs/mfc/reference/cpagesetupdialog-class.md +++ b/docs/mfc/reference/cpagesetupdialog-class.md @@ -4,10 +4,12 @@ title: "CPageSetupDialog Class" ms.date: "11/04/2016" f1_keywords: ["CPageSetupDialog", "AFXDLGS/CPageSetupDialog", "AFXDLGS/CPageSetupDialog::CPageSetupDialog", "AFXDLGS/CPageSetupDialog::CreatePrinterDC", "AFXDLGS/CPageSetupDialog::DoModal", "AFXDLGS/CPageSetupDialog::GetDeviceName", "AFXDLGS/CPageSetupDialog::GetDevMode", "AFXDLGS/CPageSetupDialog::GetDriverName", "AFXDLGS/CPageSetupDialog::GetMargins", "AFXDLGS/CPageSetupDialog::GetPaperSize", "AFXDLGS/CPageSetupDialog::GetPortName", "AFXDLGS/CPageSetupDialog::OnDrawPage", "AFXDLGS/CPageSetupDialog::PreDrawPage", "AFXDLGS/CPageSetupDialog::m_psd"] helpviewer_keywords: ["CPageSetupDialog [MFC], CPageSetupDialog", "CPageSetupDialog [MFC], CreatePrinterDC", "CPageSetupDialog [MFC], DoModal", "CPageSetupDialog [MFC], GetDeviceName", "CPageSetupDialog [MFC], GetDevMode", "CPageSetupDialog [MFC], GetDriverName", "CPageSetupDialog [MFC], GetMargins", "CPageSetupDialog [MFC], GetPaperSize", "CPageSetupDialog [MFC], GetPortName", "CPageSetupDialog [MFC], OnDrawPage", "CPageSetupDialog [MFC], PreDrawPage", "CPageSetupDialog [MFC], m_psd"] -ms.assetid: 049c0ac8-f254-4854-9414-7a8271d1447a --- # CPageSetupDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the services provided by the Windows common OLE Page Setup dialog box with additional support for setting and modifying print margins. ## Syntax diff --git a/docs/mfc/reference/cpaintdc-class.md b/docs/mfc/reference/cpaintdc-class.md index dc01823c28e..9f5268f8d58 100644 --- a/docs/mfc/reference/cpaintdc-class.md +++ b/docs/mfc/reference/cpaintdc-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CPaintDC [MFC], CPaintDC", "CPaintDC [MFC], m_ps", "CPain --- # `CPaintDC` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A device-context class derived from [`CDC`](../../mfc/reference/cdc-class.md). ## Syntax diff --git a/docs/mfc/reference/cpalette-class.md b/docs/mfc/reference/cpalette-class.md index c07f7e48beb..7c40fbda689 100644 --- a/docs/mfc/reference/cpalette-class.md +++ b/docs/mfc/reference/cpalette-class.md @@ -4,10 +4,12 @@ title: "CPalette Class" ms.date: "11/04/2016" f1_keywords: ["CPalette", "AFXWIN/CPalette", "AFXWIN/CPalette::CPalette", "AFXWIN/CPalette::AnimatePalette", "AFXWIN/CPalette::CreateHalftonePalette", "AFXWIN/CPalette::CreatePalette", "AFXWIN/CPalette::FromHandle", "AFXWIN/CPalette::GetEntryCount", "AFXWIN/CPalette::GetNearestPaletteIndex", "AFXWIN/CPalette::GetPaletteEntries", "AFXWIN/CPalette::ResizePalette", "AFXWIN/CPalette::SetPaletteEntries"] helpviewer_keywords: ["CPalette [MFC], CPalette", "CPalette [MFC], AnimatePalette", "CPalette [MFC], CreateHalftonePalette", "CPalette [MFC], CreatePalette", "CPalette [MFC], FromHandle", "CPalette [MFC], GetEntryCount", "CPalette [MFC], GetNearestPaletteIndex", "CPalette [MFC], GetPaletteEntries", "CPalette [MFC], ResizePalette", "CPalette [MFC], SetPaletteEntries"] -ms.assetid: 8cd95498-53ed-4852-85e1-70e522541114 --- # CPalette Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a Windows color palette. ## Syntax diff --git a/docs/mfc/reference/cpane-class.md b/docs/mfc/reference/cpane-class.md index 72daa26442a..b80f5cbffa5 100644 --- a/docs/mfc/reference/cpane-class.md +++ b/docs/mfc/reference/cpane-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CPane [MFC], AdjustSizeImmediate", "CPane [MFC], AllocEle --- # CPane Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CPane` class is an enhancement of the [CControlBar Class](../../mfc/reference/ccontrolbar-class.md). If you are upgrading an existing MFC project, replace all occurrences of `CControlBar` with `CPane`. ## Syntax diff --git a/docs/mfc/reference/cpanecontainer-class.md b/docs/mfc/reference/cpanecontainer-class.md index 46fbe336ba1..3dfdcf4bdca 100644 --- a/docs/mfc/reference/cpanecontainer-class.md +++ b/docs/mfc/reference/cpanecontainer-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CPaneContainer [MFC], CPaneContainer", "CPaneContainer [M --- # CPaneContainer Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CPaneContainer` class is a basic component of the docking model implemented by MFC. An object of this class stores pointers to two docking panes or to two instances of `CPaneContainer`. It also stores a pointer to the divider that separates the panes (or the containers). By nesting containers inside containers, the framework can build a binary tree that represents complex docking layouts. The root of the binary tree is stored in a [CPaneContainerManager](../../mfc/reference/cpanecontainermanager-class.md) object. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cpanecontainermanager-class.md b/docs/mfc/reference/cpanecontainermanager-class.md index 0adabe6f729..65836da7866 100644 --- a/docs/mfc/reference/cpanecontainermanager-class.md +++ b/docs/mfc/reference/cpanecontainermanager-class.md @@ -4,10 +4,12 @@ title: "CPaneContainerManager Class" ms.date: "11/04/2016" f1_keywords: ["CPaneContainerManager", "AFXPANECONTAINERMANAGER/CPaneContainerManager", "AFXPANECONTAINERMANAGER/CPaneContainerManager::AddPane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::AddPaneContainerManager", "AFXPANECONTAINERMANAGER/CPaneContainerManager::AddPaneContainerManagerToDockablePane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::AddPanesToList", "AFXPANECONTAINERMANAGER/CPaneContainerManager::AddPaneToList", "AFXPANECONTAINERMANAGER/CPaneContainerManager::AddPaneToRecentPaneContainer", "AFXPANECONTAINERMANAGER/CPaneContainerManager::CalcRects", "AFXPANECONTAINERMANAGER/CPaneContainerManager::CanBeAttached", "AFXPANECONTAINERMANAGER/CPaneContainerManager::CheckAndRemoveNonValidPane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::CheckForMiniFrameAndCaption", "AFXPANECONTAINERMANAGER/CPaneContainerManager::Create", "AFXPANECONTAINERMANAGER/CPaneContainerManager::DoesAllowDynInsertBefore", "AFXPANECONTAINERMANAGER/CPaneContainerManager::DoesContainFloatingPane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::EnableGrippers", "AFXPANECONTAINERMANAGER/CPaneContainerManager::FindPaneContainer", "AFXPANECONTAINERMANAGER/CPaneContainerManager::FindTabbedPane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetAvailableSpace", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetDefaultPaneDivider", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetDockSiteFrameWnd", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetFirstPane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetFirstVisiblePane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetMinMaxOffset", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetMinSize", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetNodeCount", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetPaneContainerRTC", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetPaneCount", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetTotalRefCount", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetVisiblePaneCount", "AFXPANECONTAINERMANAGER/CPaneContainerManager::GetWindowRect", "AFXPANECONTAINERMANAGER/CPaneContainerManager::HideAll", "AFXPANECONTAINERMANAGER/CPaneContainerManager::InsertPane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::IsAutoHideMode", "AFXPANECONTAINERMANAGER/CPaneContainerManager::IsEmpty", "AFXPANECONTAINERMANAGER/CPaneContainerManager::IsRootPaneContainerVisible", "AFXPANECONTAINERMANAGER/CPaneContainerManager::NotifyPaneDivider", "AFXPANECONTAINERMANAGER/CPaneContainerManager::OnPaneDividerMove", "AFXPANECONTAINERMANAGER/CPaneContainerManager::OnShowPane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::PaneFromPoint", "AFXPANECONTAINERMANAGER/CPaneContainerManager::ReleaseEmptyPaneContainers", "AFXPANECONTAINERMANAGER/CPaneContainerManager::RemoveAllPanesAndPaneDividers", "AFXPANECONTAINERMANAGER/CPaneContainerManager::RemoveNonValidPanes", "AFXPANECONTAINERMANAGER/CPaneContainerManager::RemovePaneDivider", "AFXPANECONTAINERMANAGER/CPaneContainerManager::RemovePaneFromPaneContainer", "AFXPANECONTAINERMANAGER/CPaneContainerManager::ReplacePane", "AFXPANECONTAINERMANAGER/CPaneContainerManager::ResizePaneContainers", "AFXPANECONTAINERMANAGER/CPaneContainerManager::Serialize", "AFXPANECONTAINERMANAGER/CPaneContainerManager::SetDefaultPaneDividerForPanes", "AFXPANECONTAINERMANAGER/CPaneContainerManager::SetPaneContainerRTC", "AFXPANECONTAINERMANAGER/CPaneContainerManager::SetResizeMode", "AFXPANECONTAINERMANAGER/CPaneContainerManager::StoreRecentDockSiteInfo"] helpviewer_keywords: ["CPaneContainerManager [MFC], AddPane", "CPaneContainerManager [MFC], AddPaneContainerManager", "CPaneContainerManager [MFC], AddPaneContainerManagerToDockablePane", "CPaneContainerManager [MFC], AddPanesToList", "CPaneContainerManager [MFC], AddPaneToList", "CPaneContainerManager [MFC], AddPaneToRecentPaneContainer", "CPaneContainerManager [MFC], CalcRects", "CPaneContainerManager [MFC], CanBeAttached", "CPaneContainerManager [MFC], CheckAndRemoveNonValidPane", "CPaneContainerManager [MFC], CheckForMiniFrameAndCaption", "CPaneContainerManager [MFC], Create", "CPaneContainerManager [MFC], DoesAllowDynInsertBefore", "CPaneContainerManager [MFC], DoesContainFloatingPane", "CPaneContainerManager [MFC], EnableGrippers", "CPaneContainerManager [MFC], FindPaneContainer", "CPaneContainerManager [MFC], FindTabbedPane", "CPaneContainerManager [MFC], GetAvailableSpace", "CPaneContainerManager [MFC], GetDefaultPaneDivider", "CPaneContainerManager [MFC], GetDockSiteFrameWnd", "CPaneContainerManager [MFC], GetFirstPane", "CPaneContainerManager [MFC], GetFirstVisiblePane", "CPaneContainerManager [MFC], GetMinMaxOffset", "CPaneContainerManager [MFC], GetMinSize", "CPaneContainerManager [MFC], GetNodeCount", "CPaneContainerManager [MFC], GetPaneContainerRTC", "CPaneContainerManager [MFC], GetPaneCount", "CPaneContainerManager [MFC], GetTotalRefCount", "CPaneContainerManager [MFC], GetVisiblePaneCount", "CPaneContainerManager [MFC], GetWindowRect", "CPaneContainerManager [MFC], HideAll", "CPaneContainerManager [MFC], InsertPane", "CPaneContainerManager [MFC], IsAutoHideMode", "CPaneContainerManager [MFC], IsEmpty", "CPaneContainerManager [MFC], IsRootPaneContainerVisible", "CPaneContainerManager [MFC], NotifyPaneDivider", "CPaneContainerManager [MFC], OnPaneDividerMove", "CPaneContainerManager [MFC], OnShowPane", "CPaneContainerManager [MFC], PaneFromPoint", "CPaneContainerManager [MFC], ReleaseEmptyPaneContainers", "CPaneContainerManager [MFC], RemoveAllPanesAndPaneDividers", "CPaneContainerManager [MFC], RemoveNonValidPanes", "CPaneContainerManager [MFC], RemovePaneDivider", "CPaneContainerManager [MFC], RemovePaneFromPaneContainer", "CPaneContainerManager [MFC], ReplacePane", "CPaneContainerManager [MFC], ResizePaneContainers", "CPaneContainerManager [MFC], Serialize", "CPaneContainerManager [MFC], SetDefaultPaneDividerForPanes", "CPaneContainerManager [MFC], SetPaneContainerRTC", "CPaneContainerManager [MFC], SetResizeMode", "CPaneContainerManager [MFC], StoreRecentDockSiteInfo"] -ms.assetid: 3d974c15-a62f-4648-bb5b-cc31ab7950af --- # CPaneContainerManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CPaneContainerManager` class manages the storage and display of the current docking layout. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cpanedialog-class.md b/docs/mfc/reference/cpanedialog-class.md index 71d8ba02273..43078a07946 100644 --- a/docs/mfc/reference/cpanedialog-class.md +++ b/docs/mfc/reference/cpanedialog-class.md @@ -4,10 +4,12 @@ title: "CPaneDialog Class" ms.date: "11/04/2016" f1_keywords: ["CPaneDialog", "AFXPANEDIALOG/CPaneDialog", "AFXPANEDIALOG/CPaneDialog::Create", "AFXPANEDIALOG/CPaneDialog::HandleInitDialog", "AFXPANEDIALOG/CPaneDialog::SetOccDialogInfo"] helpviewer_keywords: ["CPaneDialog [MFC], Create", "CPaneDialog [MFC], HandleInitDialog", "CPaneDialog [MFC], SetOccDialogInfo"] -ms.assetid: 48a6bb91-4b92-40f5-8907-b3270b146cf6 --- # CPaneDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CPaneDialog` class supports a modeless, dockable dialog box. ## Syntax diff --git a/docs/mfc/reference/cpanedivider-class.md b/docs/mfc/reference/cpanedivider-class.md index 23ca314fbe4..49f3d48bc3d 100644 --- a/docs/mfc/reference/cpanedivider-class.md +++ b/docs/mfc/reference/cpanedivider-class.md @@ -4,10 +4,12 @@ title: "CPaneDivider Class" ms.date: "11/04/2016" f1_keywords: ["CPaneDivider", "AFXPANEDIVIDER/CPaneDivider", "AFXPANEDIVIDER/CPaneDivider::CPaneDivider", "AFXPANEDIVIDER/CPaneDivider::AddPaneContainer", "AFXPANEDIVIDER/CPaneDivider::AddPane", "AFXPANEDIVIDER/CPaneDivider::AddRecentPane", "AFXPANEDIVIDER/CPaneDivider::CalcExpectedDockedRect", "AFXPANEDIVIDER/CPaneDivider::CalcFixedLayout", "AFXPANEDIVIDER/CPaneDivider::CheckVisibility", "AFXPANEDIVIDER/CPaneDivider::CreateEx", "AFXPANEDIVIDER/CPaneDivider::DoesAllowDynInsertBefore", "AFXPANEDIVIDER/CPaneDivider::DoesContainFloatingPane", "AFXPANEDIVIDER/CPaneDivider::FindPaneContainer", "AFXPANEDIVIDER/CPaneDivider::FindTabbedPane", "AFXPANEDIVIDER/CPaneDivider::GetDefaultWidth", "AFXPANEDIVIDER/CPaneDivider::GetFirstPane", "AFXPANEDIVIDER/CPaneDivider::GetPaneDividerStyle", "AFXPANEDIVIDER/CPaneDivider::GetRootContainerRect", "AFXPANEDIVIDER/CPaneDivider::GetWidth", "AFXPANEDIVIDER/CPaneDivider::Init", "AFXPANEDIVIDER/CPaneDivider::InsertPane", "AFXPANEDIVIDER/CPaneDivider::IsAutoHideMode", "AFXPANEDIVIDER/CPaneDivider::IsDefault", "AFXPANEDIVIDER/CPaneDivider::IsHorizontal", "AFXPANEDIVIDER/CPaneDivider::Move", "AFXPANEDIVIDER/CPaneDivider::NotifyAboutRelease", "AFXPANEDIVIDER/CPaneDivider::OnShowPane", "AFXPANEDIVIDER/CPaneDivider::ReleaseEmptyPaneContainers", "AFXPANEDIVIDER/CPaneDivider::RemovePane", "AFXPANEDIVIDER/CPaneDivider::ReplacePane", "AFXPANEDIVIDER/CPaneDivider::RepositionPanes", "AFXPANEDIVIDER/CPaneDivider::Serialize", "AFXPANEDIVIDER/CPaneDivider::SetAutoHideMode", "AFXPANEDIVIDER/CPaneDivider::SetPaneContainerManager", "AFXPANEDIVIDER/CPaneDivider::ShowWindow", "AFXPANEDIVIDER/CPaneDivider::StoreRecentDockSiteInfo", "AFXPANEDIVIDER/CPaneDivider::StoreRecentTabRelatedInfo", "AFXPANEDIVIDER/CPaneDivider::GetPanes", "AFXPANEDIVIDER/CPaneDivider::GetPaneDividers", "AFXPANEDIVIDER/CPaneDivider::m_nDefaultWidth", "AFXPANEDIVIDER/CPaneDivider::m_pSliderRTC"] helpviewer_keywords: ["CPaneDivider [MFC], CPaneDivider", "CPaneDivider [MFC], AddPaneContainer", "CPaneDivider [MFC], AddPane", "CPaneDivider [MFC], AddRecentPane", "CPaneDivider [MFC], CalcExpectedDockedRect", "CPaneDivider [MFC], CalcFixedLayout", "CPaneDivider [MFC], CheckVisibility", "CPaneDivider [MFC], CreateEx", "CPaneDivider [MFC], DoesAllowDynInsertBefore", "CPaneDivider [MFC], DoesContainFloatingPane", "CPaneDivider [MFC], FindPaneContainer", "CPaneDivider [MFC], FindTabbedPane", "CPaneDivider [MFC], GetDefaultWidth", "CPaneDivider [MFC], GetFirstPane", "CPaneDivider [MFC], GetPaneDividerStyle", "CPaneDivider [MFC], GetRootContainerRect", "CPaneDivider [MFC], GetWidth", "CPaneDivider [MFC], Init", "CPaneDivider [MFC], InsertPane", "CPaneDivider [MFC], IsAutoHideMode", "CPaneDivider [MFC], IsDefault", "CPaneDivider [MFC], IsHorizontal", "CPaneDivider [MFC], Move", "CPaneDivider [MFC], NotifyAboutRelease", "CPaneDivider [MFC], OnShowPane", "CPaneDivider [MFC], ReleaseEmptyPaneContainers", "CPaneDivider [MFC], RemovePane", "CPaneDivider [MFC], ReplacePane", "CPaneDivider [MFC], RepositionPanes", "CPaneDivider [MFC], Serialize", "CPaneDivider [MFC], SetAutoHideMode", "CPaneDivider [MFC], SetPaneContainerManager", "CPaneDivider [MFC], ShowWindow", "CPaneDivider [MFC], StoreRecentDockSiteInfo", "CPaneDivider [MFC], StoreRecentTabRelatedInfo", "CPaneDivider [MFC], GetPanes", "CPaneDivider [MFC], GetPaneDividers", "CPaneDivider [MFC], m_nDefaultWidth", "CPaneDivider [MFC], m_pSliderRTC"] -ms.assetid: 8e828a5d-232f-4127-b8e3-7fa45a7a476e --- # CPaneDivider Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. The `CPaneDivider` class divides two panes, divides two groups of panes, or separates a group of panes from the client area of the main frame window. diff --git a/docs/mfc/reference/cpaneframewnd-class.md b/docs/mfc/reference/cpaneframewnd-class.md index 3c281c3f41c..5c73ad4d607 100644 --- a/docs/mfc/reference/cpaneframewnd-class.md +++ b/docs/mfc/reference/cpaneframewnd-class.md @@ -4,10 +4,12 @@ title: "CPaneFrameWnd Class" ms.date: "11/04/2016" f1_keywords: ["CPaneFrameWnd", "AFXPANEFRAMEWND/CPaneFrameWnd", "AFXPANEFRAMEWND/CPaneFrameWnd::AddPane", "AFXPANEFRAMEWND/CPaneFrameWnd::AddRemovePaneFromGlobalList", "AFXPANEFRAMEWND/CPaneFrameWnd::AdjustLayout", "AFXPANEFRAMEWND/CPaneFrameWnd::AdjustPaneFrames", "AFXPANEFRAMEWND/CPaneFrameWnd::CalcBorderSize", "AFXPANEFRAMEWND/CPaneFrameWnd::CalcExpectedDockedRect", "AFXPANEFRAMEWND/CPaneFrameWnd::CanBeAttached", "AFXPANEFRAMEWND/CPaneFrameWnd::CanBeDockedToPane", "AFXPANEFRAMEWND/CPaneFrameWnd::CheckGripperVisibility", "AFXPANEFRAMEWND/CPaneFrameWnd::ConvertToTabbedDocument", "AFXPANEFRAMEWND/CPaneFrameWnd::Create", "AFXPANEFRAMEWND/CPaneFrameWnd::CreateEx", "AFXPANEFRAMEWND/CPaneFrameWnd::DockPane", "AFXPANEFRAMEWND/CPaneFrameWnd::FindFloatingPaneByID", "AFXPANEFRAMEWND/CPaneFrameWnd::FrameFromPoint", "AFXPANEFRAMEWND/CPaneFrameWnd::GetCaptionHeight", "AFXPANEFRAMEWND/CPaneFrameWnd::GetCaptionRect", "AFXPANEFRAMEWND/CPaneFrameWnd::GetCaptionText", "AFXPANEFRAMEWND/CPaneFrameWnd::GetDockingManager", "AFXPANEFRAMEWND/CPaneFrameWnd::GetDockingMode", "AFXPANEFRAMEWND/CPaneFrameWnd::GetFirstVisiblePane", "AFXPANEFRAMEWND/CPaneFrameWnd::GetHotPoint", "AFXPANEFRAMEWND/CPaneFrameWnd::GetPane", "AFXPANEFRAMEWND/CPaneFrameWnd::GetPaneCount", "AFXPANEFRAMEWND/CPaneFrameWnd::GetParent", "AFXPANEFRAMEWND/CPaneFrameWnd::GetPinState", "AFXPANEFRAMEWND/CPaneFrameWnd::GetRecentFloatingRect", "AFXPANEFRAMEWND/CPaneFrameWnd::GetVisiblePaneCount", "AFXPANEFRAMEWND/CPaneFrameWnd::HitTest", "AFXPANEFRAMEWND/CPaneFrameWnd::IsCaptured", "AFXPANEFRAMEWND/CPaneFrameWnd::IsDelayShow", "AFXPANEFRAMEWND/CPaneFrameWnd::IsRollDown", "AFXPANEFRAMEWND/CPaneFrameWnd::IsRollUp", "AFXPANEFRAMEWND/CPaneFrameWnd::KillDockingTimer", "AFXPANEFRAMEWND/CPaneFrameWnd::LoadState", "AFXPANEFRAMEWND/CPaneFrameWnd::OnBeforeDock", "AFXPANEFRAMEWND/CPaneFrameWnd::OnDockToRecentPos", "AFXPANEFRAMEWND/CPaneFrameWnd::OnKillRollUpTimer", "AFXPANEFRAMEWND/CPaneFrameWnd::OnMovePane", "AFXPANEFRAMEWND/CPaneFrameWnd::OnPaneRecalcLayout", "AFXPANEFRAMEWND/CPaneFrameWnd::OnSetRollUpTimer", "AFXPANEFRAMEWND/CPaneFrameWnd::OnShowPane", "AFXPANEFRAMEWND/CPaneFrameWnd::PaneFromPoint", "AFXPANEFRAMEWND/CPaneFrameWnd::Pin", "AFXPANEFRAMEWND/CPaneFrameWnd::RedrawAll", "AFXPANEFRAMEWND/CPaneFrameWnd::RemoveNonValidPanes", "AFXPANEFRAMEWND/CPaneFrameWnd::RemovePane", "AFXPANEFRAMEWND/CPaneFrameWnd::ReplacePane", "AFXPANEFRAMEWND/CPaneFrameWnd::SaveState", "AFXPANEFRAMEWND/CPaneFrameWnd::SetCaptionButtons", "AFXPANEFRAMEWND/CPaneFrameWnd::SetDelayShow", "AFXPANEFRAMEWND/CPaneFrameWnd::SetDockingManager", "AFXPANEFRAMEWND/CPaneFrameWnd::SetDockingTimer", "AFXPANEFRAMEWND/CPaneFrameWnd::SetDockState", "AFXPANEFRAMEWND/CPaneFrameWnd::SetHotPoint", "AFXPANEFRAMEWND/CPaneFrameWnd::SetPreDockState", "AFXPANEFRAMEWND/CPaneFrameWnd::SizeToContent", "AFXPANEFRAMEWND/CPaneFrameWnd::StartTearOff", "AFXPANEFRAMEWND/CPaneFrameWnd::StoreRecentDockSiteInfo", "AFXPANEFRAMEWND/CPaneFrameWnd::StoreRecentTabRelatedInfo", "AFXPANEFRAMEWND/CPaneFrameWnd::OnCheckRollState", "AFXPANEFRAMEWND/CPaneFrameWnd::OnDrawBorder", "AFXPANEFRAMEWND/CPaneFrameWnd::m_bUseSaveBits"] helpviewer_keywords: ["CPaneFrameWnd [MFC], AddPane", "CPaneFrameWnd [MFC], AddRemovePaneFromGlobalList", "CPaneFrameWnd [MFC], AdjustLayout", "CPaneFrameWnd [MFC], AdjustPaneFrames", "CPaneFrameWnd [MFC], CalcBorderSize", "CPaneFrameWnd [MFC], CalcExpectedDockedRect", "CPaneFrameWnd [MFC], CanBeAttached", "CPaneFrameWnd [MFC], CanBeDockedToPane", "CPaneFrameWnd [MFC], CheckGripperVisibility", "CPaneFrameWnd [MFC], ConvertToTabbedDocument", "CPaneFrameWnd [MFC], Create", "CPaneFrameWnd [MFC], CreateEx", "CPaneFrameWnd [MFC], DockPane", "CPaneFrameWnd [MFC], FindFloatingPaneByID", "CPaneFrameWnd [MFC], FrameFromPoint", "CPaneFrameWnd [MFC], GetCaptionHeight", "CPaneFrameWnd [MFC], GetCaptionRect", "CPaneFrameWnd [MFC], GetCaptionText", "CPaneFrameWnd [MFC], GetDockingManager", "CPaneFrameWnd [MFC], GetDockingMode", "CPaneFrameWnd [MFC], GetFirstVisiblePane", "CPaneFrameWnd [MFC], GetHotPoint", "CPaneFrameWnd [MFC], GetPane", "CPaneFrameWnd [MFC], GetPaneCount", "CPaneFrameWnd [MFC], GetParent", "CPaneFrameWnd [MFC], GetPinState", "CPaneFrameWnd [MFC], GetRecentFloatingRect", "CPaneFrameWnd [MFC], GetVisiblePaneCount", "CPaneFrameWnd [MFC], HitTest", "CPaneFrameWnd [MFC], IsCaptured", "CPaneFrameWnd [MFC], IsDelayShow", "CPaneFrameWnd [MFC], IsRollDown", "CPaneFrameWnd [MFC], IsRollUp", "CPaneFrameWnd [MFC], KillDockingTimer", "CPaneFrameWnd [MFC], LoadState", "CPaneFrameWnd [MFC], OnBeforeDock", "CPaneFrameWnd [MFC], OnDockToRecentPos", "CPaneFrameWnd [MFC], OnKillRollUpTimer", "CPaneFrameWnd [MFC], OnMovePane", "CPaneFrameWnd [MFC], OnPaneRecalcLayout", "CPaneFrameWnd [MFC], OnSetRollUpTimer", "CPaneFrameWnd [MFC], OnShowPane", "CPaneFrameWnd [MFC], PaneFromPoint", "CPaneFrameWnd [MFC], Pin", "CPaneFrameWnd [MFC], RedrawAll", "CPaneFrameWnd [MFC], RemoveNonValidPanes", "CPaneFrameWnd [MFC], RemovePane", "CPaneFrameWnd [MFC], ReplacePane", "CPaneFrameWnd [MFC], SaveState", "CPaneFrameWnd [MFC], SetCaptionButtons", "CPaneFrameWnd [MFC], SetDelayShow", "CPaneFrameWnd [MFC], SetDockingManager", "CPaneFrameWnd [MFC], SetDockingTimer", "CPaneFrameWnd [MFC], SetDockState", "CPaneFrameWnd [MFC], SetHotPoint", "CPaneFrameWnd [MFC], SetPreDockState", "CPaneFrameWnd [MFC], SizeToContent", "CPaneFrameWnd [MFC], StartTearOff", "CPaneFrameWnd [MFC], StoreRecentDockSiteInfo", "CPaneFrameWnd [MFC], StoreRecentTabRelatedInfo", "CPaneFrameWnd [MFC], OnCheckRollState", "CPaneFrameWnd [MFC], OnDrawBorder", "CPaneFrameWnd [MFC], m_bUseSaveBits"] -ms.assetid: ea3423a3-2763-482e-b763-817036ded10d --- # CPaneFrameWnd Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. Implements a mini-frame window that contains one pane. The pane fills the client area of the window. diff --git a/docs/mfc/reference/cparabolictransitionfromacceleration-class.md b/docs/mfc/reference/cparabolictransitionfromacceleration-class.md index ec6569ac474..669010b4e3d 100644 --- a/docs/mfc/reference/cparabolictransitionfromacceleration-class.md +++ b/docs/mfc/reference/cparabolictransitionfromacceleration-class.md @@ -4,10 +4,12 @@ title: "CParabolicTransitionFromAcceleration Class" ms.date: "11/04/2016" f1_keywords: ["CParabolicTransitionFromAcceleration", "AFXANIMATIONCONTROLLER/CParabolicTransitionFromAcceleration", "AFXANIMATIONCONTROLLER/CParabolicTransitionFromAcceleration::CParabolicTransitionFromAcceleration", "AFXANIMATIONCONTROLLER/CParabolicTransitionFromAcceleration::Create", "AFXANIMATIONCONTROLLER/CParabolicTransitionFromAcceleration::m_dblAcceleration", "AFXANIMATIONCONTROLLER/CParabolicTransitionFromAcceleration::m_dblFinalValue", "AFXANIMATIONCONTROLLER/CParabolicTransitionFromAcceleration::m_dblFinalVelocity"] helpviewer_keywords: ["CParabolicTransitionFromAcceleration [MFC], CParabolicTransitionFromAcceleration", "CParabolicTransitionFromAcceleration [MFC], Create", "CParabolicTransitionFromAcceleration [MFC], m_dblAcceleration", "CParabolicTransitionFromAcceleration [MFC], m_dblFinalValue", "CParabolicTransitionFromAcceleration [MFC], m_dblFinalVelocity"] -ms.assetid: 1e59b86f-358b-4da0-a4fd-8eaf5e85e00f --- # CParabolicTransitionFromAcceleration Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a parabolic-acceleration transition. ## Syntax diff --git a/docs/mfc/reference/cpen-class.md b/docs/mfc/reference/cpen-class.md index c891d6bff1f..3dfc6ed53ac 100644 --- a/docs/mfc/reference/cpen-class.md +++ b/docs/mfc/reference/cpen-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CPen [MFC], CPen", "CPen [MFC], CreatePen", "CPen [MFC], --- # `CPen` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a Windows graphics device interface (GDI) pen. ## Syntax diff --git a/docs/mfc/reference/cpictureholder-class.md b/docs/mfc/reference/cpictureholder-class.md index 27354c1940f..98e8a242e74 100644 --- a/docs/mfc/reference/cpictureholder-class.md +++ b/docs/mfc/reference/cpictureholder-class.md @@ -4,10 +4,12 @@ title: "CPictureHolder Class" ms.date: "11/04/2016" f1_keywords: ["CPictureHolder", "AFXCTL/CPictureHolder", "AFXCTL/CPictureHolder::CPictureHolder", "AFXCTL/CPictureHolder::CreateEmpty", "AFXCTL/CPictureHolder::CreateFromBitmap", "AFXCTL/CPictureHolder::CreateFromIcon", "AFXCTL/CPictureHolder::CreateFromMetafile", "AFXCTL/CPictureHolder::GetDisplayString", "AFXCTL/CPictureHolder::GetPictureDispatch", "AFXCTL/CPictureHolder::GetType", "AFXCTL/CPictureHolder::Render", "AFXCTL/CPictureHolder::SetPictureDispatch", "AFXCTL/CPictureHolder::m_pPict"] helpviewer_keywords: ["CPictureHolder [MFC], CPictureHolder", "CPictureHolder [MFC], CreateEmpty", "CPictureHolder [MFC], CreateFromBitmap", "CPictureHolder [MFC], CreateFromIcon", "CPictureHolder [MFC], CreateFromMetafile", "CPictureHolder [MFC], GetDisplayString", "CPictureHolder [MFC], GetPictureDispatch", "CPictureHolder [MFC], GetType", "CPictureHolder [MFC], Render", "CPictureHolder [MFC], SetPictureDispatch", "CPictureHolder [MFC], m_pPict"] -ms.assetid: a4f59775-704a-41dd-b5bd-2e531c95127a --- # CPictureHolder Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a Picture property, which allows the user to display a picture in your control. ## Syntax diff --git a/docs/mfc/reference/cprintdialog-class.md b/docs/mfc/reference/cprintdialog-class.md index d4c03521ce6..093f0f5844a 100644 --- a/docs/mfc/reference/cprintdialog-class.md +++ b/docs/mfc/reference/cprintdialog-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CPrintDialog [MFC], CPrintDialog", "CPrintDialog [MFC], C --- # `CPrintDialog` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the services provided by the Windows common dialog box for printing. ## Syntax diff --git a/docs/mfc/reference/cprintdialogex-class.md b/docs/mfc/reference/cprintdialogex-class.md index 1a6cb91c882..dced4c2fffb 100644 --- a/docs/mfc/reference/cprintdialogex-class.md +++ b/docs/mfc/reference/cprintdialogex-class.md @@ -4,10 +4,12 @@ title: "CPrintDialogEx Class" ms.date: "11/04/2016" f1_keywords: ["CPrintDialogEx", "AFXDLGS/CPrintDialogEx", "AFXDLGS/CPrintDialogEx::CPrintDialogEx", "AFXDLGS/CPrintDialogEx::CreatePrinterDC", "AFXDLGS/CPrintDialogEx::DoModal", "AFXDLGS/CPrintDialogEx::GetCopies", "AFXDLGS/CPrintDialogEx::GetDefaults", "AFXDLGS/CPrintDialogEx::GetDeviceName", "AFXDLGS/CPrintDialogEx::GetDevMode", "AFXDLGS/CPrintDialogEx::GetDriverName", "AFXDLGS/CPrintDialogEx::GetPortName", "AFXDLGS/CPrintDialogEx::GetPrinterDC", "AFXDLGS/CPrintDialogEx::PrintAll", "AFXDLGS/CPrintDialogEx::PrintCollate", "AFXDLGS/CPrintDialogEx::PrintCurrentPage", "AFXDLGS/CPrintDialogEx::PrintRange", "AFXDLGS/CPrintDialogEx::PrintSelection", "AFXDLGS/CPrintDialogEx::m_pdex"] helpviewer_keywords: ["CPrintDialogEx [MFC], CPrintDialogEx", "CPrintDialogEx [MFC], CreatePrinterDC", "CPrintDialogEx [MFC], DoModal", "CPrintDialogEx [MFC], GetCopies", "CPrintDialogEx [MFC], GetDefaults", "CPrintDialogEx [MFC], GetDeviceName", "CPrintDialogEx [MFC], GetDevMode", "CPrintDialogEx [MFC], GetDriverName", "CPrintDialogEx [MFC], GetPortName", "CPrintDialogEx [MFC], GetPrinterDC", "CPrintDialogEx [MFC], PrintAll", "CPrintDialogEx [MFC], PrintCollate", "CPrintDialogEx [MFC], PrintCurrentPage", "CPrintDialogEx [MFC], PrintRange", "CPrintDialogEx [MFC], PrintSelection", "CPrintDialogEx [MFC], m_pdex"] -ms.assetid: 1d506703-ee1c-44cc-b4ce-4e778fec26b8 --- # CPrintDialogEx Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the services provided by the Windows Print property sheet. ## Syntax diff --git a/docs/mfc/reference/cprintinfo-structure.md b/docs/mfc/reference/cprintinfo-structure.md index 45508f935e3..988a7d8cb56 100644 --- a/docs/mfc/reference/cprintinfo-structure.md +++ b/docs/mfc/reference/cprintinfo-structure.md @@ -4,10 +4,12 @@ title: "CPrintInfo Structure" ms.date: "11/04/2016" f1_keywords: ["CPrintInfo"] helpviewer_keywords: ["CPrintInfo structure [MFC]"] -ms.assetid: 0b3de849-d050-4386-9a14-f4c1a25684f7 --- # CPrintInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Stores information about a print or print-preview job. ## Syntax diff --git a/docs/mfc/reference/cprogressctrl-class.md b/docs/mfc/reference/cprogressctrl-class.md index d6eaee52925..7ae4d353fc7 100644 --- a/docs/mfc/reference/cprogressctrl-class.md +++ b/docs/mfc/reference/cprogressctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CProgressCtrl [MFC], CProgressCtrl", "CProgressCtrl [MFC] --- # `CProgressCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common progress bar control. ## Syntax diff --git a/docs/mfc/reference/cpropertypage-class.md b/docs/mfc/reference/cpropertypage-class.md index cfddd645dea..178080adc1f 100644 --- a/docs/mfc/reference/cpropertypage-class.md +++ b/docs/mfc/reference/cpropertypage-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CPropertyPage [MFC], CPropertyPage", "CPropertyPage [MFC] --- # `CPropertyPage` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents individual pages of a property sheet, otherwise known as a tab dialog box. ## Syntax diff --git a/docs/mfc/reference/cpropertysheet-class.md b/docs/mfc/reference/cpropertysheet-class.md index 000ec9eb63c..e383f0c4105 100644 --- a/docs/mfc/reference/cpropertysheet-class.md +++ b/docs/mfc/reference/cpropertysheet-class.md @@ -4,10 +4,12 @@ title: "CPropertySheet Class" ms.date: "11/04/2016" f1_keywords: ["CPropertySheet", "AFXDLGS/CPropertySheet", "AFXDLGS/CPropertySheet::CPropertySheet", "AFXDLGS/CPropertySheet::AddPage", "AFXDLGS/CPropertySheet::Construct", "AFXDLGS/CPropertySheet::Create", "AFXDLGS/CPropertySheet::DoModal", "AFXDLGS/CPropertySheet::EnableStackedTabs", "AFXDLGS/CPropertySheet::EndDialog", "AFXDLGS/CPropertySheet::GetActiveIndex", "AFXDLGS/CPropertySheet::GetActivePage", "AFXDLGS/CPropertySheet::GetPage", "AFXDLGS/CPropertySheet::GetPageCount", "AFXDLGS/CPropertySheet::GetPageIndex", "AFXDLGS/CPropertySheet::GetTabControl", "AFXDLGS/CPropertySheet::MapDialogRect", "AFXDLGS/CPropertySheet::OnInitDialog", "AFXDLGS/CPropertySheet::PressButton", "AFXDLGS/CPropertySheet::RemovePage", "AFXDLGS/CPropertySheet::SetActivePage", "AFXDLGS/CPropertySheet::SetFinishText", "AFXDLGS/CPropertySheet::SetTitle", "AFXDLGS/CPropertySheet::SetWizardButtons", "AFXDLGS/CPropertySheet::SetWizardMode", "AFXDLGS/CPropertySheet::m_psh"] helpviewer_keywords: ["CPropertySheet [MFC], CPropertySheet", "CPropertySheet [MFC], AddPage", "CPropertySheet [MFC], Construct", "CPropertySheet [MFC], Create", "CPropertySheet [MFC], DoModal", "CPropertySheet [MFC], EnableStackedTabs", "CPropertySheet [MFC], EndDialog", "CPropertySheet [MFC], GetActiveIndex", "CPropertySheet [MFC], GetActivePage", "CPropertySheet [MFC], GetPage", "CPropertySheet [MFC], GetPageCount", "CPropertySheet [MFC], GetPageIndex", "CPropertySheet [MFC], GetTabControl", "CPropertySheet [MFC], MapDialogRect", "CPropertySheet [MFC], OnInitDialog", "CPropertySheet [MFC], PressButton", "CPropertySheet [MFC], RemovePage", "CPropertySheet [MFC], SetActivePage", "CPropertySheet [MFC], SetFinishText", "CPropertySheet [MFC], SetTitle", "CPropertySheet [MFC], SetWizardButtons", "CPropertySheet [MFC], SetWizardMode", "CPropertySheet [MFC], m_psh"] -ms.assetid: 8461ccff-d14f-46e0-a746-42ad642ef94e --- # `CPropertySheet` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents property sheets, also known as tab dialog boxes. ## Syntax diff --git a/docs/mfc/reference/cpropexchange-class.md b/docs/mfc/reference/cpropexchange-class.md index 4292d4b07dd..6af0cb17262 100644 --- a/docs/mfc/reference/cpropexchange-class.md +++ b/docs/mfc/reference/cpropexchange-class.md @@ -4,10 +4,12 @@ title: "CPropExchange Class" ms.date: "11/04/2016" f1_keywords: ["CPropExchange", "AFXCTL/CPropExchange", "AFXCTL/CPropExchange::ExchangeBlobProp", "AFXCTL/CPropExchange::ExchangeFontProp", "AFXCTL/CPropExchange::ExchangePersistentProp", "AFXCTL/CPropExchange::ExchangeProp", "AFXCTL/CPropExchange::ExchangeVersion", "AFXCTL/CPropExchange::GetVersion", "AFXCTL/CPropExchange::IsAsynchronous", "AFXCTL/CPropExchange::IsLoading"] helpviewer_keywords: ["CPropExchange [MFC], ExchangeBlobProp", "CPropExchange [MFC], ExchangeFontProp", "CPropExchange [MFC], ExchangePersistentProp", "CPropExchange [MFC], ExchangeProp", "CPropExchange [MFC], ExchangeVersion", "CPropExchange [MFC], GetVersion", "CPropExchange [MFC], IsAsynchronous", "CPropExchange [MFC], IsLoading"] -ms.assetid: ed872180-e770-4942-892a-92139d501fab --- # CPropExchange Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports the implementation of persistence for your OLE controls. ## Syntax diff --git a/docs/mfc/reference/cptrarray-class.md b/docs/mfc/reference/cptrarray-class.md index 74865d07bc0..d96c8b72602 100644 --- a/docs/mfc/reference/cptrarray-class.md +++ b/docs/mfc/reference/cptrarray-class.md @@ -4,10 +4,12 @@ title: "CPtrArray Class" ms.date: "11/04/2016" f1_keywords: ["CPtrArray", "AFXCOLL/CPtrArray", "AFXCOLL/CPtrArray::CPtrArray", "AFXCOLL/CPtrArray::Add", "AFXCOLL/CPtrArray::Append", "AFXCOLL/CPtrArray::Copy", "AFXCOLL/CPtrArray::ElementAt", "AFXCOLL/CPtrArray::FreeExtra", "AFXCOLL/CPtrArray::GetAt", "AFXCOLL/CPtrArray::GetCount", "AFXCOLL/CPtrArray::GetData", "AFXCOLL/CPtrArray::GetSize", "AFXCOLL/CPtrArray::GetUpperBound", "AFXCOLL/CPtrArray::InsertAt", "AFXCOLL/CPtrArray::IsEmpty", "AFXCOLL/CPtrArray::RemoveAll", "AFXCOLL/CPtrArray::RemoveAt", "AFXCOLL/CPtrArray::SetAt", "AFXCOLL/CPtrArray::SetAtGrow", "AFXCOLL/CPtrArray::SetSize"] helpviewer_keywords: ["CPtrArray [MFC], CPtrArray", "CPtrArray [MFC], Add", "CPtrArray [MFC], Append", "CPtrArray [MFC], Copy", "CPtrArray [MFC], ElementAt", "CPtrArray [MFC], FreeExtra", "CPtrArray [MFC], GetAt", "CPtrArray [MFC], GetCount", "CPtrArray [MFC], GetData", "CPtrArray [MFC], GetSize", "CPtrArray [MFC], GetUpperBound", "CPtrArray [MFC], InsertAt", "CPtrArray [MFC], IsEmpty", "CPtrArray [MFC], RemoveAll", "CPtrArray [MFC], RemoveAt", "CPtrArray [MFC], SetAt", "CPtrArray [MFC], SetAtGrow", "CPtrArray [MFC], SetSize"] -ms.assetid: c23b87a3-bf84-49d6-a66b-61e999d0938a --- # CPtrArray Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports arrays of void pointers. ## Syntax diff --git a/docs/mfc/reference/cptrlist-class.md b/docs/mfc/reference/cptrlist-class.md index 452efb1d46e..46437ca882e 100644 --- a/docs/mfc/reference/cptrlist-class.md +++ b/docs/mfc/reference/cptrlist-class.md @@ -4,10 +4,12 @@ title: "CPtrList Class" ms.date: "11/04/2016" f1_keywords: ["CPtrList"] helpviewer_keywords: ["lists, generic", "CPtrList class [MFC]", "generic lists"] -ms.assetid: 4139a09c-4338-4f42-9eea-51336120b43c --- # CPtrList Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports lists of void pointers. ## Syntax diff --git a/docs/mfc/reference/creating-a-file-explorer-style-mfc-application.md b/docs/mfc/reference/creating-a-file-explorer-style-mfc-application.md index 896201ac5fc..14dba910556 100644 --- a/docs/mfc/reference/creating-a-file-explorer-style-mfc-application.md +++ b/docs/mfc/reference/creating-a-file-explorer-style-mfc-application.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["browsers [MFC], Explorer-style applications", "MFC applic --- # Creating a File Explorer-Style MFC Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Many Windows system applications use the user interface (UI) for File Explorer. When you start File Explorer, for example, you see an application with a vertical splitter bar dividing the client area. The left side of the client area provides navigation and browsing features, and the right side of the client area shows details pertinent to the selection in the left pane. When a user clicks an item in the left pane, the application repopulates the right pane. In an MDI application, you can use commands on the **View** menu to change the amount of detail shown in the right pane. (In an SDI or multiple top-level document application, you can change the detail using the toolbar buttons only.) The contents of the panes depend on the application. In a file-system browser, the left pane shows a hierarchical view of directories or machines, or machine groups, while the right pane displays folders, individual files, or machines, and details about them. The contents don't necessarily have to be files. They could be e-mail messages, error reports, or other items in a database. diff --git a/docs/mfc/reference/creating-a-forms-based-mfc-application.md b/docs/mfc/reference/creating-a-forms-based-mfc-application.md index 1378686ea70..0c5b3bef019 100644 --- a/docs/mfc/reference/creating-a-forms-based-mfc-application.md +++ b/docs/mfc/reference/creating-a-forms-based-mfc-application.md @@ -4,10 +4,12 @@ title: "Creating a Forms-Based MFC Application" ms.date: "09/09/2019" f1_keywords: ["vc.appwiz.mfcforms.project"] helpviewer_keywords: ["applications [MFC], forms-based", "forms-based applications [MFC]"] -ms.assetid: 048d2f7d-b60d-4386-ad8e-71d49af9c05e --- # Creating a Forms-Based MFC Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A form is a dialog box with controls that let a user access and possibly change data. You may want to develop an application in which the user selects from a selection of forms. Commonly, a forms-based application lets the user access forms by click **New** from the **File** menu. A dialog-based application, which does not give users access to a **New** option in the **File** menu, is also considered a forms-based application. A single document interface (SDI), forms-based application allows only one instance of a particular form to run at a time. It is possible to run different forms at the same time from an SDI forms-based application by selecting a new form from the **New** option in the **File** menu. diff --git a/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md b/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md index ab5e862682c..b955619f604 100644 --- a/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md +++ b/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["MFC, Web applications", "Web browsers, creating from MFC --- # Creating a Web Browser-Style MFC Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A Web browser-style application can access information from the Internet (such as HTML or active documents) or an intranet, as well as folders in the local file system and on a network. By deriving the application's view class from [`CHtmlView`](../../mfc/reference/chtmlview-class.md), effectively you make the application a Web browser by providing the view with the WebBrowser control. ## To create a Web browser application based on the MFC document/view architecture diff --git a/docs/mfc/reference/creating-an-mfc-activex-control-container.md b/docs/mfc/reference/creating-an-mfc-activex-control-container.md index bf2998f393f..09e8ca13391 100644 --- a/docs/mfc/reference/creating-an-mfc-activex-control-container.md +++ b/docs/mfc/reference/creating-an-mfc-activex-control-container.md @@ -4,10 +4,12 @@ title: "Creating an MFC ActiveX Control Container" ms.date: "09/12/2018" f1_keywords: ["vc.appwiz.activex.container"] helpviewer_keywords: ["MFC ActiveX controls [MFC], containers", "ActiveX control containers [MFC], creating", "containers [MFC], creating", "OLE controls [MFC], containers"] -ms.assetid: ec70e137-7c14-4940-bd0e-fd4edcc63ea5 --- # Creating an MFC ActiveX Control Container +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An ActiveX control container is a parent program that supplies the environment for an ActiveX (formerly OLE) control to run. You can create an application capable of containing ActiveX controls with or without MFC, but it is much easier to do with MFC. >[!IMPORTANT] diff --git a/docs/mfc/reference/creating-an-mfc-activex-control.md b/docs/mfc/reference/creating-an-mfc-activex-control.md index af40e85640b..699fd44cc35 100644 --- a/docs/mfc/reference/creating-an-mfc-activex-control.md +++ b/docs/mfc/reference/creating-an-mfc-activex-control.md @@ -4,10 +4,12 @@ title: "Creating an MFC ActiveX Control" ms.date: "08/19/2019" f1_keywords: ["vc.appwiz.activex.project"] helpviewer_keywords: ["MFC ActiveX controls [MFC], creating", "ActiveX controls [MFC], creating"] -ms.assetid: 8bd5a93c-d04d-414e-bb28-163fdc1c0dd5 --- # Creating an MFC ActiveX Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + ActiveX control programs are modular programs designed to give a specific type of functionality to a parent application. For example, you can create a control such as a button for use in a dialog, or toolbar for use in a Web page. >[!IMPORTANT] diff --git a/docs/mfc/reference/creating-an-mfc-application.md b/docs/mfc/reference/creating-an-mfc-application.md index 6d366fb7b8a..5a7719ffafc 100644 --- a/docs/mfc/reference/creating-an-mfc-application.md +++ b/docs/mfc/reference/creating-an-mfc-application.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["applications [MFC]", "MFC, creating applications", "MFC a --- # Creating an MFC Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An MFC application is an executable application for Windows that is based on the Microsoft Foundation Class (MFC) Library. MFC executables generally fall into five types: standard Windows applications, dialog boxes, forms-based applications, Explorer-style applications, and Web browser-style applications. For more information, see: - [Using the Classes to Write Windows Applications](../../mfc/using-the-classes-to-write-applications-for-windows.md) diff --git a/docs/mfc/reference/creating-an-mfc-dll-project.md b/docs/mfc/reference/creating-an-mfc-dll-project.md index 783d8204a23..0db9eb054b6 100644 --- a/docs/mfc/reference/creating-an-mfc-dll-project.md +++ b/docs/mfc/reference/creating-an-mfc-dll-project.md @@ -4,10 +4,12 @@ title: "Creating an MFC DLL Project" ms.date: "08/19/2019" f1_keywords: ["vc.appwiz.mfcdll.project"] helpviewer_keywords: ["MFC DLLs [MFC], creating projects", "DLLs [MFC], MFC", "projects [MFC], creating", "DLLs [MFC], creating"] -ms.assetid: 05540b93-4781-4a90-aadf-55158313f5b2 --- # Creating an MFC DLL Project +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An MFC DLL is a binary file that acts as a shared library of functions that can be used simultaneously by multiple applications. The easiest way to create an MFC DLL project is to use the MFC DLL Wizard. > [!NOTE] diff --git a/docs/mfc/reference/crebar-class.md b/docs/mfc/reference/crebar-class.md index 52ee6e4ec94..16cc85e331b 100644 --- a/docs/mfc/reference/crebar-class.md +++ b/docs/mfc/reference/crebar-class.md @@ -4,10 +4,12 @@ title: "CReBar Class" ms.date: "11/19/2018" f1_keywords: ["CReBar", "AFXEXT/CReBar", "AFXEXT/CReBar::AddBar", "AFXEXT/CReBar::Create", "AFXEXT/CReBar::GetReBarCtrl"] helpviewer_keywords: ["CReBar [MFC], AddBar", "CReBar [MFC], Create", "CReBar [MFC], GetReBarCtrl"] -ms.assetid: c1ad2720-1d33-4106-8e4e-80aa84f93559 --- # CReBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A control bar that provides layout, persistence, and state information for rebar controls. ## Syntax diff --git a/docs/mfc/reference/crebarctrl-class.md b/docs/mfc/reference/crebarctrl-class.md index 7d66ed8b7f6..970ef6e7e42 100644 --- a/docs/mfc/reference/crebarctrl-class.md +++ b/docs/mfc/reference/crebarctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CReBarCtrl [MFC], CReBarCtrl", "CReBarCtrl [MFC], BeginDr --- # CReBarCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the functionality of a rebar control, which is a container for a child window. ## Syntax diff --git a/docs/mfc/reference/crecentdocksiteinfo-class.md b/docs/mfc/reference/crecentdocksiteinfo-class.md index 88bf440c502..2c9a20d7337 100644 --- a/docs/mfc/reference/crecentdocksiteinfo-class.md +++ b/docs/mfc/reference/crecentdocksiteinfo-class.md @@ -4,10 +4,12 @@ title: "CRecentDockSiteInfo Class" ms.date: "11/04/2016" f1_keywords: ["CRecentDockSiteInfo", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::CleanUp", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::GetRecentDefaultPaneDivider", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::GetRecentDockedPercent", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::GetRecentDockedRect", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::GetRecentListOfPanes", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::GetRecentPaneContainer", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::GetRecentTabContainer", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::Init", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::IsRecentLeftPane", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::SaveListOfRecentPanes", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::SetInfo", "AFXRECENTDOCKSITEINFO/CRecentDockSiteInfo::StoreDockInfo"] helpviewer_keywords: ["CRecentDockSiteInfo [MFC], CleanUp", "CRecentDockSiteInfo [MFC], GetRecentDefaultPaneDivider", "CRecentDockSiteInfo [MFC], GetRecentDockedPercent", "CRecentDockSiteInfo [MFC], GetRecentDockedRect", "CRecentDockSiteInfo [MFC], GetRecentListOfPanes", "CRecentDockSiteInfo [MFC], GetRecentPaneContainer", "CRecentDockSiteInfo [MFC], GetRecentTabContainer", "CRecentDockSiteInfo [MFC], Init", "CRecentDockSiteInfo [MFC], IsRecentLeftPane", "CRecentDockSiteInfo [MFC], SaveListOfRecentPanes", "CRecentDockSiteInfo [MFC], SetInfo", "CRecentDockSiteInfo [MFC], StoreDockInfo"] -ms.assetid: 2dd14f95-d5a2-4461-a7a5-2c6c36a3a165 --- # CRecentDockSiteInfo Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CRecentDockSiteInfo` class is a helper class that stores recent state information for the [CPane Class](../../mfc/reference/cpane-class.md). ## Syntax diff --git a/docs/mfc/reference/crecentfilelist-class.md b/docs/mfc/reference/crecentfilelist-class.md index d1254290dfa..01ada3f09c3 100644 --- a/docs/mfc/reference/crecentfilelist-class.md +++ b/docs/mfc/reference/crecentfilelist-class.md @@ -4,10 +4,12 @@ title: "CRecentFileList Class" ms.date: "11/04/2016" f1_keywords: ["CRecentFileList", "AFXADV/CRecentFileList", "AFXADV/CRecentFileList::CRecentFileList", "AFXADV/CRecentFileList::Add", "AFXADV/CRecentFileList::GetDisplayName", "AFXADV/CRecentFileList::GetSize", "AFXADV/CRecentFileList::ReadList", "AFXADV/CRecentFileList::Remove", "AFXADV/CRecentFileList::UpdateMenu", "AFXADV/CRecentFileList::WriteList"] helpviewer_keywords: ["CRecentFileList [MFC], CRecentFileList", "CRecentFileList [MFC], Add", "CRecentFileList [MFC], GetDisplayName", "CRecentFileList [MFC], GetSize", "CRecentFileList [MFC], ReadList", "CRecentFileList [MFC], Remove", "CRecentFileList [MFC], UpdateMenu", "CRecentFileList [MFC], WriteList"] -ms.assetid: a77f0524-7584-4582-849a-7e97b76d186e --- # CRecentFileList Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports control of the most recently used (MRU) file list. ## Syntax diff --git a/docs/mfc/reference/crecordset-class.md b/docs/mfc/reference/crecordset-class.md index ec14c8d5d1e..4e04679a569 100644 --- a/docs/mfc/reference/crecordset-class.md +++ b/docs/mfc/reference/crecordset-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CRecordset [MFC], CRecordset", "CRecordset [MFC], AddNew" --- # `CRecordset` class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a set of records selected from a data source. ## Syntax diff --git a/docs/mfc/reference/crecordview-class.md b/docs/mfc/reference/crecordview-class.md index f4e471911b4..6fd8701e014 100644 --- a/docs/mfc/reference/crecordview-class.md +++ b/docs/mfc/reference/crecordview-class.md @@ -4,10 +4,12 @@ title: "CRecordView Class" ms.date: "11/04/2016" f1_keywords: ["CRecordView", "AFXDB/CRecordView", "AFXDB/CRecordView::CRecordView", "AFXDB/CRecordView::IsOnFirstRecord", "AFXDB/CRecordView::IsOnLastRecord", "AFXDB/CRecordView::OnGetRecordset", "AFXDB/CRecordView::OnMove"] helpviewer_keywords: ["CRecordView [MFC], CRecordView", "CRecordView [MFC], IsOnFirstRecord", "CRecordView [MFC], IsOnLastRecord", "CRecordView [MFC], OnGetRecordset", "CRecordView [MFC], OnMove", "CRecordView [MFC], OnMove"] -ms.assetid: 9b4b0897-bd50-4d48-a0b4-f3323f5ccc55 --- # CRecordView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A view that displays database records in controls. ## Syntax diff --git a/docs/mfc/reference/crecttracker-class.md b/docs/mfc/reference/crecttracker-class.md index 19a028ee9c3..5fe0fff5ac8 100644 --- a/docs/mfc/reference/crecttracker-class.md +++ b/docs/mfc/reference/crecttracker-class.md @@ -4,10 +4,12 @@ title: "CRectTracker Class" ms.date: "11/19/2018" f1_keywords: ["CRectTracker", "AFXEXT/CRectTracker", "AFXEXT/CRectTracker::CRectTracker", "AFXEXT/CRectTracker::AdjustRect", "AFXEXT/CRectTracker::Draw", "AFXEXT/CRectTracker::DrawTrackerRect", "AFXEXT/CRectTracker::GetHandleMask", "AFXEXT/CRectTracker::GetTrueRect", "AFXEXT/CRectTracker::HitTest", "AFXEXT/CRectTracker::NormalizeHit", "AFXEXT/CRectTracker::OnChangedRect", "AFXEXT/CRectTracker::SetCursor", "AFXEXT/CRectTracker::Track", "AFXEXT/CRectTracker::TrackRubberBand", "AFXEXT/CRectTracker::m_nHandleSize", "AFXEXT/CRectTracker::m_nStyle", "AFXEXT/CRectTracker::m_rect", "AFXEXT/CRectTracker::m_sizeMin"] helpviewer_keywords: ["CRectTracker [MFC], CRectTracker", "CRectTracker [MFC], AdjustRect", "CRectTracker [MFC], Draw", "CRectTracker [MFC], DrawTrackerRect", "CRectTracker [MFC], GetHandleMask", "CRectTracker [MFC], GetTrueRect", "CRectTracker [MFC], HitTest", "CRectTracker [MFC], NormalizeHit", "CRectTracker [MFC], OnChangedRect", "CRectTracker [MFC], SetCursor", "CRectTracker [MFC], Track", "CRectTracker [MFC], TrackRubberBand", "CRectTracker [MFC], m_nHandleSize", "CRectTracker [MFC], m_nStyle", "CRectTracker [MFC], m_rect", "CRectTracker [MFC], m_sizeMin"] -ms.assetid: 99caa7f2-3c0d-4a42-bbee-e5d1d342d4ee --- # CRectTracker Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allows an item to be displayed, moved, and resized in different fashions. ## Syntax diff --git a/docs/mfc/reference/crendertarget-class.md b/docs/mfc/reference/crendertarget-class.md index 3c031ef53a6..c03c1adaece 100644 --- a/docs/mfc/reference/crendertarget-class.md +++ b/docs/mfc/reference/crendertarget-class.md @@ -4,10 +4,12 @@ title: "CRenderTarget Class" ms.date: "03/27/2019" f1_keywords: ["CRenderTarget", "AFXRENDERTARGET/CRenderTarget", "AFXRENDERTARGET/CRenderTarget::CRenderTarget", "AFXRENDERTARGET/CRenderTarget::Attach", "AFXRENDERTARGET/CRenderTarget::BeginDraw", "AFXRENDERTARGET/CRenderTarget::Clear", "AFXRENDERTARGET/CRenderTarget::COLORREF_TO_D2DCOLOR", "AFXRENDERTARGET/CRenderTarget::CreateCompatibleRenderTarget", "AFXRENDERTARGET/CRenderTarget::Destroy", "AFXRENDERTARGET/CRenderTarget::Detach", "AFXRENDERTARGET/CRenderTarget::DrawBitmap", "AFXRENDERTARGET/CRenderTarget::DrawEllipse", "AFXRENDERTARGET/CRenderTarget::DrawGeometry", "AFXRENDERTARGET/CRenderTarget::DrawGlyphRun", "AFXRENDERTARGET/CRenderTarget::DrawLine", "AFXRENDERTARGET/CRenderTarget::DrawRectangle", "AFXRENDERTARGET/CRenderTarget::DrawRoundedRectangle", "AFXRENDERTARGET/CRenderTarget::DrawText", "AFXRENDERTARGET/CRenderTarget::DrawTextLayout", "AFXRENDERTARGET/CRenderTarget::EndDraw", "AFXRENDERTARGET/CRenderTarget::FillEllipse", "AFXRENDERTARGET/CRenderTarget::FillGeometry", "AFXRENDERTARGET/CRenderTarget::FillMesh", "AFXRENDERTARGET/CRenderTarget::FillOpacityMask", "AFXRENDERTARGET/CRenderTarget::FillRectangle", "AFXRENDERTARGET/CRenderTarget::FillRoundedRectangle", "AFXRENDERTARGET/CRenderTarget::Flush", "AFXRENDERTARGET/CRenderTarget::GetAntialiasMode", "AFXRENDERTARGET/CRenderTarget::GetDpi", "AFXRENDERTARGET/CRenderTarget::GetMaximumBitmapSize", "AFXRENDERTARGET/CRenderTarget::GetPixelFormat", "AFXRENDERTARGET/CRenderTarget::GetPixelSize", "AFXRENDERTARGET/CRenderTarget::GetRenderTarget", "AFXRENDERTARGET/CRenderTarget::GetSize", "AFXRENDERTARGET/CRenderTarget::GetTags", "AFXRENDERTARGET/CRenderTarget::GetTextAntialiasMode", "AFXRENDERTARGET/CRenderTarget::GetTextRenderingParams", "AFXRENDERTARGET/CRenderTarget::GetTransform", "AFXRENDERTARGET/CRenderTarget::IsSupported", "AFXRENDERTARGET/CRenderTarget::IsValid", "AFXRENDERTARGET/CRenderTarget::PopAxisAlignedClip", "AFXRENDERTARGET/CRenderTarget::PopLayer", "AFXRENDERTARGET/CRenderTarget::PushAxisAlignedClip", "AFXRENDERTARGET/CRenderTarget::PushLayer", "AFXRENDERTARGET/CRenderTarget::RestoreDrawingState", "AFXRENDERTARGET/CRenderTarget::SaveDrawingState", "AFXRENDERTARGET/CRenderTarget::SetAntialiasMode", "AFXRENDERTARGET/CRenderTarget::SetDpi", "AFXRENDERTARGET/CRenderTarget::SetTags", "AFXRENDERTARGET/CRenderTarget::SetTextAntialiasMode", "AFXRENDERTARGET/CRenderTarget::SetTextRenderingParams", "AFXRENDERTARGET/CRenderTarget::SetTransform", "AFXRENDERTARGET/CRenderTarget::VerifyResource", "AFXRENDERTARGET/CRenderTarget::m_lstResources", "AFXRENDERTARGET/CRenderTarget::m_pRenderTarget", "AFXRENDERTARGET/CRenderTarget::m_pTextFormatDefault"] helpviewer_keywords: ["CRenderTarget [MFC], CRenderTarget", "CRenderTarget [MFC], Attach", "CRenderTarget [MFC], BeginDraw", "CRenderTarget [MFC], Clear", "CRenderTarget [MFC], COLORREF_TO_D2DCOLOR", "CRenderTarget [MFC], CreateCompatibleRenderTarget", "CRenderTarget [MFC], Destroy", "CRenderTarget [MFC], Detach", "CRenderTarget [MFC], DrawBitmap", "CRenderTarget [MFC], DrawEllipse", "CRenderTarget [MFC], DrawGeometry", "CRenderTarget [MFC], DrawGlyphRun", "CRenderTarget [MFC], DrawLine", "CRenderTarget [MFC], DrawRectangle", "CRenderTarget [MFC], DrawRoundedRectangle", "CRenderTarget [MFC], DrawText", "CRenderTarget [MFC], DrawTextLayout", "CRenderTarget [MFC], EndDraw", "CRenderTarget [MFC], FillEllipse", "CRenderTarget [MFC], FillGeometry", "CRenderTarget [MFC], FillMesh", "CRenderTarget [MFC], FillOpacityMask", "CRenderTarget [MFC], FillRectangle", "CRenderTarget [MFC], FillRoundedRectangle", "CRenderTarget [MFC], Flush", "CRenderTarget [MFC], GetAntialiasMode", "CRenderTarget [MFC], GetDpi", "CRenderTarget [MFC], GetMaximumBitmapSize", "CRenderTarget [MFC], GetPixelFormat", "CRenderTarget [MFC], GetPixelSize", "CRenderTarget [MFC], GetRenderTarget", "CRenderTarget [MFC], GetSize", "CRenderTarget [MFC], GetTags", "CRenderTarget [MFC], GetTextAntialiasMode", "CRenderTarget [MFC], GetTextRenderingParams", "CRenderTarget [MFC], GetTransform", "CRenderTarget [MFC], IsSupported", "CRenderTarget [MFC], IsValid", "CRenderTarget [MFC], PopAxisAlignedClip", "CRenderTarget [MFC], PopLayer", "CRenderTarget [MFC], PushAxisAlignedClip", "CRenderTarget [MFC], PushLayer", "CRenderTarget [MFC], RestoreDrawingState", "CRenderTarget [MFC], SaveDrawingState", "CRenderTarget [MFC], SetAntialiasMode", "CRenderTarget [MFC], SetDpi", "CRenderTarget [MFC], SetTags", "CRenderTarget [MFC], SetTextAntialiasMode", "CRenderTarget [MFC], SetTextRenderingParams", "CRenderTarget [MFC], SetTransform", "CRenderTarget [MFC], VerifyResource", "CRenderTarget [MFC], m_lstResources", "CRenderTarget [MFC], m_pRenderTarget", "CRenderTarget [MFC], m_pTextFormatDefault"] -ms.assetid: 30d1607d-68d3-4d14-ac36-fdbd0ef903a1 --- # CRenderTarget Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1RenderTarget. ## Syntax diff --git a/docs/mfc/reference/cresourceexception-class.md b/docs/mfc/reference/cresourceexception-class.md index 2fb51f30a9f..7092e28d4cf 100644 --- a/docs/mfc/reference/cresourceexception-class.md +++ b/docs/mfc/reference/cresourceexception-class.md @@ -4,10 +4,12 @@ title: "CResourceException Class" ms.date: "11/04/2016" f1_keywords: ["CResourceException", "AFXWIN/CResourceException", "AFXWIN/CResourceException::CResourceException"] helpviewer_keywords: ["CResourceException [MFC], CResourceException"] -ms.assetid: af6ae043-d124-4bfd-b35e-7bb0db67d289 --- # CResourceException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Generated when Windows cannot find or allocate a requested resource. ## Syntax diff --git a/docs/mfc/reference/creversaltransition-class.md b/docs/mfc/reference/creversaltransition-class.md index ce0eea97765..a5d5fd66648 100644 --- a/docs/mfc/reference/creversaltransition-class.md +++ b/docs/mfc/reference/creversaltransition-class.md @@ -4,10 +4,12 @@ title: "CReversalTransition Class" ms.date: "11/04/2016" f1_keywords: ["CReversalTransition", "AFXANIMATIONCONTROLLER/CReversalTransition", "AFXANIMATIONCONTROLLER/CReversalTransition::CReversalTransition", "AFXANIMATIONCONTROLLER/CReversalTransition::Create", "AFXANIMATIONCONTROLLER/CReversalTransition::m_duration"] helpviewer_keywords: ["CReversalTransition [MFC], CReversalTransition", "CReversalTransition [MFC], Create", "CReversalTransition [MFC], m_duration"] -ms.assetid: e89516be-2d07-4885-95a8-fc278f46e3ad --- # CReversalTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a reversal transition. ## Syntax diff --git a/docs/mfc/reference/crgn-class.md b/docs/mfc/reference/crgn-class.md index 6568c4df1c5..3f188fbc505 100644 --- a/docs/mfc/reference/crgn-class.md +++ b/docs/mfc/reference/crgn-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CRgn [MFC], CRgn", "CRgn [MFC], CombineRgn", "CRgn [MFC], --- # CRgn Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a Windows graphics device interface (GDI) region. ## Syntax diff --git a/docs/mfc/reference/cricheditcntritem-class.md b/docs/mfc/reference/cricheditcntritem-class.md index 54de9aee098..98ad504bdb2 100644 --- a/docs/mfc/reference/cricheditcntritem-class.md +++ b/docs/mfc/reference/cricheditcntritem-class.md @@ -4,10 +4,12 @@ title: "CRichEditCntrItem Class" ms.date: "11/04/2016" f1_keywords: ["CRichEditCntrItem", "AFXRICH/CRichEditCntrItem", "AFXRICH/CRichEditCntrItem::CRichEditCntrItem", "AFXRICH/CRichEditCntrItem::SyncToRichEditObject"] helpviewer_keywords: ["CRichEditCntrItem [MFC], CRichEditCntrItem", "CRichEditCntrItem [MFC], SyncToRichEditObject"] -ms.assetid: 6c0b4efe-0fb8-4621-b5e1-fdcb8ec48c3b --- # CRichEditCntrItem Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + With [CRichEditView](../../mfc/reference/cricheditview-class.md) and [CRichEditDoc](../../mfc/reference/cricheditdoc-class.md), provides the functionality of the rich edit control within the context of MFC's document view architecture. ## Syntax diff --git a/docs/mfc/reference/cricheditctrl-class.md b/docs/mfc/reference/cricheditctrl-class.md index 146d92aecf4..9a34e6cb057 100644 --- a/docs/mfc/reference/cricheditctrl-class.md +++ b/docs/mfc/reference/cricheditctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CRichEditCtrl [MFC], CRichEditCtrl", "CRichEditCtrl [MFC] --- # `CRichEditCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the rich edit control. ## Syntax diff --git a/docs/mfc/reference/cricheditdoc-class.md b/docs/mfc/reference/cricheditdoc-class.md index 3897e50c9b2..5dfa99a29a0 100644 --- a/docs/mfc/reference/cricheditdoc-class.md +++ b/docs/mfc/reference/cricheditdoc-class.md @@ -4,10 +4,12 @@ title: "CRichEditDoc Class" ms.date: "11/04/2016" f1_keywords: ["CRichEditDoc", "AFXRICH/CRichEditDoc", "AFXRICH/CRichEditDoc::CreateClientItem", "AFXRICH/CRichEditDoc::GetStreamFormat", "AFXRICH/CRichEditDoc::GetView", "AFXRICH/CRichEditDoc::m_bRTF"] helpviewer_keywords: ["CRichEditDoc [MFC], CreateClientItem", "CRichEditDoc [MFC], GetStreamFormat", "CRichEditDoc [MFC], GetView", "CRichEditDoc [MFC], m_bRTF"] -ms.assetid: c936ec18-d516-49d4-b7fb-c9aa0229eddc --- # CRichEditDoc Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + With [CRichEditView](../../mfc/reference/cricheditview-class.md) and [CRichEditCntrItem](../../mfc/reference/cricheditcntritem-class.md), provides the functionality of the rich edit control within the context of MFC's document view architecture. ## Syntax diff --git a/docs/mfc/reference/cricheditview-class.md b/docs/mfc/reference/cricheditview-class.md index 7cab1642800..23d301f4091 100644 --- a/docs/mfc/reference/cricheditview-class.md +++ b/docs/mfc/reference/cricheditview-class.md @@ -4,10 +4,12 @@ title: "CRichEditView Class" ms.date: "11/04/2016" f1_keywords: ["CRichEditView", "AFXRICH/CRichEditView", "AFXRICH/CRichEditView::CRichEditView", "AFXRICH/CRichEditView::AdjustDialogPosition", "AFXRICH/CRichEditView::CanPaste", "AFXRICH/CRichEditView::DoPaste", "AFXRICH/CRichEditView::FindText", "AFXRICH/CRichEditView::FindTextSimple", "AFXRICH/CRichEditView::GetCharFormatSelection", "AFXRICH/CRichEditView::GetDocument", "AFXRICH/CRichEditView::GetInPlaceActiveItem", "AFXRICH/CRichEditView::GetMargins", "AFXRICH/CRichEditView::GetPageRect", "AFXRICH/CRichEditView::GetPaperSize", "AFXRICH/CRichEditView::GetParaFormatSelection", "AFXRICH/CRichEditView::GetPrintRect", "AFXRICH/CRichEditView::GetPrintWidth", "AFXRICH/CRichEditView::GetRichEditCtrl", "AFXRICH/CRichEditView::GetSelectedItem", "AFXRICH/CRichEditView::GetTextLength", "AFXRICH/CRichEditView::GetTextLengthEx", "AFXRICH/CRichEditView::InsertFileAsObject", "AFXRICH/CRichEditView::InsertItem", "AFXRICH/CRichEditView::IsRichEditFormat", "AFXRICH/CRichEditView::OnCharEffect", "AFXRICH/CRichEditView::OnParaAlign", "AFXRICH/CRichEditView::OnUpdateCharEffect", "AFXRICH/CRichEditView::OnUpdateParaAlign", "AFXRICH/CRichEditView::PrintInsideRect", "AFXRICH/CRichEditView::PrintPage", "AFXRICH/CRichEditView::SetCharFormat", "AFXRICH/CRichEditView::SetMargins", "AFXRICH/CRichEditView::SetPaperSize", "AFXRICH/CRichEditView::SetParaFormat", "AFXRICH/CRichEditView::TextNotFound", "AFXRICH/CRichEditView::GetClipboardData", "AFXRICH/CRichEditView::GetContextMenu", "AFXRICH/CRichEditView::IsSelected", "AFXRICH/CRichEditView::OnFindNext", "AFXRICH/CRichEditView::OnInitialUpdate", "AFXRICH/CRichEditView::OnPasteNativeObject", "AFXRICH/CRichEditView::OnPrinterChanged", "AFXRICH/CRichEditView::OnReplaceAll", "AFXRICH/CRichEditView::OnReplaceSel", "AFXRICH/CRichEditView::OnTextNotFound", "AFXRICH/CRichEditView::QueryAcceptData", "AFXRICH/CRichEditView::WrapChanged", "AFXRICH/CRichEditView::m_nBulletIndent", "AFXRICH/CRichEditView::m_nWordWrap"] helpviewer_keywords: ["CRichEditView [MFC], CRichEditView", "CRichEditView [MFC], AdjustDialogPosition", "CRichEditView [MFC], CanPaste", "CRichEditView [MFC], DoPaste", "CRichEditView [MFC], FindText", "CRichEditView [MFC], FindTextSimple", "CRichEditView [MFC], GetCharFormatSelection", "CRichEditView [MFC], GetDocument", "CRichEditView [MFC], GetInPlaceActiveItem", "CRichEditView [MFC], GetMargins", "CRichEditView [MFC], GetPageRect", "CRichEditView [MFC], GetPaperSize", "CRichEditView [MFC], GetParaFormatSelection", "CRichEditView [MFC], GetPrintRect", "CRichEditView [MFC], GetPrintWidth", "CRichEditView [MFC], GetRichEditCtrl", "CRichEditView [MFC], GetSelectedItem", "CRichEditView [MFC], GetTextLength", "CRichEditView [MFC], GetTextLengthEx", "CRichEditView [MFC], InsertFileAsObject", "CRichEditView [MFC], InsertItem", "CRichEditView [MFC], IsRichEditFormat", "CRichEditView [MFC], OnCharEffect", "CRichEditView [MFC], OnParaAlign", "CRichEditView [MFC], OnUpdateCharEffect", "CRichEditView [MFC], OnUpdateParaAlign", "CRichEditView [MFC], PrintInsideRect", "CRichEditView [MFC], PrintPage", "CRichEditView [MFC], SetCharFormat", "CRichEditView [MFC], SetMargins", "CRichEditView [MFC], SetPaperSize", "CRichEditView [MFC], SetParaFormat", "CRichEditView [MFC], TextNotFound", "CRichEditView [MFC], GetClipboardData", "CRichEditView [MFC], GetContextMenu", "CRichEditView [MFC], IsSelected", "CRichEditView [MFC], OnFindNext", "CRichEditView [MFC], OnInitialUpdate", "CRichEditView [MFC], OnPasteNativeObject", "CRichEditView [MFC], OnPrinterChanged", "CRichEditView [MFC], OnReplaceAll", "CRichEditView [MFC], OnReplaceSel", "CRichEditView [MFC], OnTextNotFound", "CRichEditView [MFC], QueryAcceptData", "CRichEditView [MFC], WrapChanged", "CRichEditView [MFC], m_nBulletIndent", "CRichEditView [MFC], m_nWordWrap"] -ms.assetid: bd576b10-4cc0-4050-8f76-e1a0548411e4 --- # CRichEditView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + With [CRichEditDoc](../../mfc/reference/cricheditdoc-class.md) and [CRichEditCntrItem](../../mfc/reference/cricheditcntritem-class.md), provides the functionality of the rich edit control within the context of MFC's document view architecture. ## Syntax diff --git a/docs/mfc/reference/cruntimeclass-structure.md b/docs/mfc/reference/cruntimeclass-structure.md index 6f396b5818b..c6772976abc 100644 --- a/docs/mfc/reference/cruntimeclass-structure.md +++ b/docs/mfc/reference/cruntimeclass-structure.md @@ -4,10 +4,12 @@ title: "CRuntimeClass Structure" ms.date: "11/04/2016" f1_keywords: ["CRuntimeClass"] helpviewer_keywords: ["CRuntimeClass structure [MFC]", "dynamic class information [MFC]", "runtime [MFC], class information", "run-time class [MFC], CRuntimeClass structure"] -ms.assetid: de62b6ef-90d4-420f-8c70-f58b36976a2b --- # CRuntimeClass Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Each class derived from `CObject` is associated with a `CRuntimeClass` structure that you can use to obtain information about an object or its base class at run time. ## Syntax diff --git a/docs/mfc/reference/cscrollbar-class.md b/docs/mfc/reference/cscrollbar-class.md index b5e379b5299..b489841cf9e 100644 --- a/docs/mfc/reference/cscrollbar-class.md +++ b/docs/mfc/reference/cscrollbar-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CScrollBar [MFC], CScrollBar", "CScrollBar [MFC], Create" --- # `CScrollBar` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows scroll-bar control. ## Syntax diff --git a/docs/mfc/reference/cscrollview-class.md b/docs/mfc/reference/cscrollview-class.md index 17e1c7e1bd3..9103f4b0a7c 100644 --- a/docs/mfc/reference/cscrollview-class.md +++ b/docs/mfc/reference/cscrollview-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CScrollView [MFC], CScrollView", "CScrollView [MFC], Chec --- # `CScrollView` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A [`CView`](../../mfc/reference/cview-class.md) with scrolling capabilities. ## Syntax diff --git a/docs/mfc/reference/csemaphore-class.md b/docs/mfc/reference/csemaphore-class.md index a31a4590ab9..e2d61659cf4 100644 --- a/docs/mfc/reference/csemaphore-class.md +++ b/docs/mfc/reference/csemaphore-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CSemaphore [MFC], CSemaphore"] --- # CSemaphore Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An object of class `CSemaphore` represents a "semaphore". A semaphore is a synchronization object that controls access to shared resources and prevents race conditions. ## Syntax diff --git a/docs/mfc/reference/csettingsstore-class.md b/docs/mfc/reference/csettingsstore-class.md index d54d021a525..cb4f6c83294 100644 --- a/docs/mfc/reference/csettingsstore-class.md +++ b/docs/mfc/reference/csettingsstore-class.md @@ -4,10 +4,12 @@ title: "CSettingsStore Class" ms.date: "11/04/2016" f1_keywords: ["CSettingsStore", "AFXSETTINGSSTORE/CSettingsStore", "AFXSETTINGSSTORE/CSettingsStore::CSettingsStore", "AFXSETTINGSSTORE/CSettingsStore::Close", "AFXSETTINGSSTORE/CSettingsStore::CreateKey", "AFXSETTINGSSTORE/CSettingsStore::DeleteKey", "AFXSETTINGSSTORE/CSettingsStore::DeleteValue", "AFXSETTINGSSTORE/CSettingsStore::Open", "AFXSETTINGSSTORE/CSettingsStore::Read", "AFXSETTINGSSTORE/CSettingsStore::Write"] helpviewer_keywords: ["CSettingsStore [MFC], CSettingsStore", "CSettingsStore [MFC], Close", "CSettingsStore [MFC], CreateKey", "CSettingsStore [MFC], DeleteKey", "CSettingsStore [MFC], DeleteValue", "CSettingsStore [MFC], Open", "CSettingsStore [MFC], Read", "CSettingsStore [MFC], Write"] -ms.assetid: 0ea181de-a13e-4b29-b560-7c43838223ff --- # CSettingsStore Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Wraps Windows API functions, providing an object-oriented interface that you use to access the registry. ## Syntax diff --git a/docs/mfc/reference/csettingsstoresp-class.md b/docs/mfc/reference/csettingsstoresp-class.md index 460f1d63a96..aeede5a5af0 100644 --- a/docs/mfc/reference/csettingsstoresp-class.md +++ b/docs/mfc/reference/csettingsstoresp-class.md @@ -4,10 +4,12 @@ title: "CSettingsStoreSP Class" ms.date: "11/04/2016" f1_keywords: ["CSettingsStoreSP", "AFXSETTINGSSTORE/CSettingsStoreSP", "AFXSETTINGSSTORE/CSettingsStoreSP::CSettingsStoreSP", "AFXSETTINGSSTORE/CSettingsStoreSP::Create", "AFXSETTINGSSTORE/CSettingsStoreSP::SetRuntimeClass"] helpviewer_keywords: ["CSettingsStoreSP [MFC], CSettingsStoreSP", "CSettingsStoreSP [MFC], Create", "CSettingsStoreSP [MFC], SetRuntimeClass"] -ms.assetid: bcd37f40-cfd4-4d17-a5ce-3bfabe995dcc --- # CSettingsStoreSP Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CSettingsStoreSP` class is a helper class that you can use to create instances of the [CSettingsStore Class](../../mfc/reference/csettingsstore-class.md). ## Syntax diff --git a/docs/mfc/reference/csharedfile-class.md b/docs/mfc/reference/csharedfile-class.md index 9b41513705b..f337246813d 100644 --- a/docs/mfc/reference/csharedfile-class.md +++ b/docs/mfc/reference/csharedfile-class.md @@ -4,10 +4,12 @@ title: "CSharedFile Class" ms.date: "11/04/2016" f1_keywords: ["CSharedFile", "AFXADV/CSharedFile", "AFXADV/CSharedFile::CSharedFile", "AFXADV/CSharedFile::Detach", "AFXADV/CSharedFile::SetHandle"] helpviewer_keywords: ["CSharedFile [MFC], CSharedFile", "CSharedFile [MFC], Detach", "CSharedFile [MFC], SetHandle"] -ms.assetid: 5d000422-9ede-4318-a8c9-f7412b674f39 --- # CSharedFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [CMemFile](../../mfc/reference/cmemfile-class.md)-derived class that supports shared memory files. ## Syntax diff --git a/docs/mfc/reference/cshellmanager-class.md b/docs/mfc/reference/cshellmanager-class.md index 83bc1cbf6f1..3a4b20fb72a 100644 --- a/docs/mfc/reference/cshellmanager-class.md +++ b/docs/mfc/reference/cshellmanager-class.md @@ -4,10 +4,12 @@ title: "CShellManager Class" ms.date: "11/04/2016" f1_keywords: ["CShellManager", "AFXSHELLMANAGER/CShellManager", "AFXSHELLMANAGER/CShellManager::CShellManager", "AFXSHELLMANAGER/CShellManager::BrowseForFolder", "AFXSHELLMANAGER/CShellManager::ConcatenateItem", "AFXSHELLMANAGER/CShellManager::CopyItem", "AFXSHELLMANAGER/CShellManager::CreateItem", "AFXSHELLMANAGER/CShellManager::FreeItem", "AFXSHELLMANAGER/CShellManager::GetItemCount", "AFXSHELLMANAGER/CShellManager::GetItemSize", "AFXSHELLMANAGER/CShellManager::GetNextItem", "AFXSHELLMANAGER/CShellManager::GetParentItem", "AFXSHELLMANAGER/CShellManager::ItemFromPath"] helpviewer_keywords: ["CShellManager [MFC], CShellManager", "CShellManager [MFC], BrowseForFolder", "CShellManager [MFC], ConcatenateItem", "CShellManager [MFC], CopyItem", "CShellManager [MFC], CreateItem", "CShellManager [MFC], FreeItem", "CShellManager [MFC], GetItemCount", "CShellManager [MFC], GetItemSize", "CShellManager [MFC], GetNextItem", "CShellManager [MFC], GetParentItem", "CShellManager [MFC], ItemFromPath"] -ms.assetid: f15c4c1a-6fae-487d-9913-9b7369b33da0 --- # CShellManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements several methods that enable you to work with pointers to identifier lists (PIDLs). ## Syntax diff --git a/docs/mfc/reference/csimpleexception-class.md b/docs/mfc/reference/csimpleexception-class.md index 177145f514b..3e53ac0ac49 100644 --- a/docs/mfc/reference/csimpleexception-class.md +++ b/docs/mfc/reference/csimpleexception-class.md @@ -4,10 +4,12 @@ title: "CSimpleException Class" ms.date: "11/04/2016" f1_keywords: ["CSimpleException", "AFX/CSimpleException", "AFX/CSimpleException::CSimpleException", "AFX/CSimpleException::GetErrorMessage"] helpviewer_keywords: ["CSimpleException [MFC], CSimpleException", "CSimpleException [MFC], GetErrorMessage"] -ms.assetid: be0eb8ef-e5b9-47d6-b0fb-efaff2d1e666 --- # CSimpleException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This class is a base class for resource-critical MFC exceptions. ## Syntax diff --git a/docs/mfc/reference/csingledoctemplate-class.md b/docs/mfc/reference/csingledoctemplate-class.md index ef86c373897..91c62bd2ca8 100644 --- a/docs/mfc/reference/csingledoctemplate-class.md +++ b/docs/mfc/reference/csingledoctemplate-class.md @@ -4,10 +4,12 @@ title: "CSingleDocTemplate Class" ms.date: "11/04/2016" f1_keywords: ["CSingleDocTemplate", "AFXWIN/CSingleDocTemplate", "AFXWIN/CSingleDocTemplate::CSingleDocTemplate"] helpviewer_keywords: ["CSingleDocTemplate [MFC], CSingleDocTemplate"] -ms.assetid: 4f3a8212-81ee-48a0-ad22-e0ed7c36a391 --- # CSingleDocTemplate Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Defines a document template that implements the single document interface (SDI). ## Syntax diff --git a/docs/mfc/reference/csinglelock-class.md b/docs/mfc/reference/csinglelock-class.md index 25559869d57..514ffb67131 100644 --- a/docs/mfc/reference/csinglelock-class.md +++ b/docs/mfc/reference/csinglelock-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CSingleLock [MFC], CSingleLock", "CSingleLock [MFC], IsLo --- # `CSingleLock` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents the access-control mechanism used in controlling access to a resource in a multithreaded program. ## Syntax diff --git a/docs/mfc/reference/csinusoidaltransitionfromrange-class.md b/docs/mfc/reference/csinusoidaltransitionfromrange-class.md index 71e765f9e7a..0781edb9065 100644 --- a/docs/mfc/reference/csinusoidaltransitionfromrange-class.md +++ b/docs/mfc/reference/csinusoidaltransitionfromrange-class.md @@ -4,10 +4,12 @@ title: "CSinusoidalTransitionFromRange Class" ms.date: "11/04/2016" f1_keywords: ["CSinusoidalTransitionFromRange", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromRange", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromRange::CSinusoidalTransitionFromRange", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromRange::Create", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromRange::m_dblMaximumValue", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromRange::m_dblMinimumValue", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromRange::m_duration", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromRange::m_period", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromRange::m_slope"] helpviewer_keywords: ["CSinusoidalTransitionFromRange [MFC], CSinusoidalTransitionFromRange", "CSinusoidalTransitionFromRange [MFC], Create", "CSinusoidalTransitionFromRange [MFC], m_dblMaximumValue", "CSinusoidalTransitionFromRange [MFC], m_dblMinimumValue", "CSinusoidalTransitionFromRange [MFC], m_duration", "CSinusoidalTransitionFromRange [MFC], m_period", "CSinusoidalTransitionFromRange [MFC], m_slope"] -ms.assetid: 8b66a729-5f10-431a-b055-e3600d0065da --- # CSinusoidalTransitionFromRange Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a sinusoidal-range transition that has a given range of oscillation. ## Syntax diff --git a/docs/mfc/reference/csinusoidaltransitionfromvelocity-class.md b/docs/mfc/reference/csinusoidaltransitionfromvelocity-class.md index 5340dcf776b..035fcb9bc5f 100644 --- a/docs/mfc/reference/csinusoidaltransitionfromvelocity-class.md +++ b/docs/mfc/reference/csinusoidaltransitionfromvelocity-class.md @@ -4,10 +4,12 @@ title: "CSinusoidalTransitionFromVelocity Class" ms.date: "11/04/2016" f1_keywords: ["CSinusoidalTransitionFromVelocity", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromVelocity", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromVelocity::CSinusoidalTransitionFromVelocity", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromVelocity::Create", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromVelocity::m_duration", "AFXANIMATIONCONTROLLER/CSinusoidalTransitionFromVelocity::m_period"] helpviewer_keywords: ["CSinusoidalTransitionFromVelocity [MFC], CSinusoidalTransitionFromVelocity", "CSinusoidalTransitionFromVelocity [MFC], Create", "CSinusoidalTransitionFromVelocity [MFC], m_duration", "CSinusoidalTransitionFromVelocity [MFC], m_period"] -ms.assetid: cc885f17-b84b-45ee-8f1f-36a8bbb7adad --- # CSinusoidalTransitionFromVelocity Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a sinusoidal-velocity transition that has an amplitude that is determined by the initial velocity of the animation variable. ## Syntax diff --git a/docs/mfc/reference/csliderctrl-class.md b/docs/mfc/reference/csliderctrl-class.md index 28afb9140de..2618ebf579c 100644 --- a/docs/mfc/reference/csliderctrl-class.md +++ b/docs/mfc/reference/csliderctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CSliderCtrl [MFC], CSliderCtrl", "CSliderCtrl [MFC], Clea --- # `CSliderCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common slider control. ## Syntax diff --git a/docs/mfc/reference/csmartdockinginfo-class.md b/docs/mfc/reference/csmartdockinginfo-class.md index d7944553b9c..eb889a8c47a 100644 --- a/docs/mfc/reference/csmartdockinginfo-class.md +++ b/docs/mfc/reference/csmartdockinginfo-class.md @@ -4,10 +4,12 @@ title: "CSmartDockingInfo Class" ms.date: "11/19/2018" f1_keywords: ["CSmartDockingInfo", "AFXDOCKINGMANAGER/CSmartDockingInfo", "AFXDOCKINGMANAGER/CSmartDockingInfo::CopyTo", "AFXDOCKINGMANAGER/CSmartDockingInfo::m_bUseThemeColorInShading", "AFXDOCKINGMANAGER/CSmartDockingInfo::m_clrBaseBackground", "AFXDOCKINGMANAGER/CSmartDockingInfo::m_clrToneDest", "AFXDOCKINGMANAGER/CSmartDockingInfo::m_clrToneSrc", "AFXDOCKINGMANAGER/CSmartDockingInfo::m_clrTransparent", "AFXDOCKINGMANAGER/CSmartDockingInfo::m_nCentralGroupOffset", "AFXDOCKINGMANAGER/CSmartDockingInfo::m_sizeTotal", "AFXDOCKINGMANAGER/CSmartDockingInfo::m_uiMarkerBmpResID", "AFXDOCKINGMANAGER/CSmartDockingInfo::m_uiMarkerLightBmpResID"] helpviewer_keywords: ["CSmartDockingInfo [MFC], CopyTo", "CSmartDockingInfo [MFC], m_bUseThemeColorInShading", "CSmartDockingInfo [MFC], m_clrBaseBackground", "CSmartDockingInfo [MFC], m_clrToneDest", "CSmartDockingInfo [MFC], m_clrToneSrc", "CSmartDockingInfo [MFC], m_clrTransparent", "CSmartDockingInfo [MFC], m_nCentralGroupOffset", "CSmartDockingInfo [MFC], m_sizeTotal", "CSmartDockingInfo [MFC], m_uiMarkerBmpResID", "CSmartDockingInfo [MFC], m_uiMarkerLightBmpResID"] -ms.assetid: cab04f38-4bc1-4378-9337-c56fc87fbd68 --- # CSmartDockingInfo Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Defines the appearance of smart docking markers. ## Syntax diff --git a/docs/mfc/reference/csmoothstoptransition-class.md b/docs/mfc/reference/csmoothstoptransition-class.md index 039271bcb5e..9d7b0d6b78f 100644 --- a/docs/mfc/reference/csmoothstoptransition-class.md +++ b/docs/mfc/reference/csmoothstoptransition-class.md @@ -4,10 +4,12 @@ title: "CSmoothStopTransition Class" ms.date: "11/04/2016" f1_keywords: ["CSmoothStopTransition", "AFXANIMATIONCONTROLLER/CSmoothStopTransition", "AFXANIMATIONCONTROLLER/CSmoothStopTransition::CSmoothStopTransition", "AFXANIMATIONCONTROLLER/CSmoothStopTransition::Create", "AFXANIMATIONCONTROLLER/CSmoothStopTransition::m_dblFinalValue", "AFXANIMATIONCONTROLLER/CSmoothStopTransition::m_maximumDuration"] helpviewer_keywords: ["CSmoothStopTransition [MFC], CSmoothStopTransition", "CSmoothStopTransition [MFC], Create", "CSmoothStopTransition [MFC], m_dblFinalValue", "CSmoothStopTransition [MFC], m_maximumDuration"] -ms.assetid: e1a4b476-6f96-43dd-90db-870a64406b85 --- # CSmoothStopTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a smooth-stop transition. ## Syntax diff --git a/docs/mfc/reference/csocket-class.md b/docs/mfc/reference/csocket-class.md index b7cb5b69c98..d317b7cced5 100644 --- a/docs/mfc/reference/csocket-class.md +++ b/docs/mfc/reference/csocket-class.md @@ -4,10 +4,12 @@ title: "CSocket Class" ms.date: "11/04/2016" f1_keywords: ["CSocket", "AFXSOCK/CSocket", "AFXSOCK/CSocket::CSocket", "AFXSOCK/CSocket::Attach", "AFXSOCK/CSocket::CancelBlockingCall", "AFXSOCK/CSocket::Create", "AFXSOCK/CSocket::FromHandle", "AFXSOCK/CSocket::IsBlocking", "AFXSOCK/CSocket::OnMessagePending"] helpviewer_keywords: ["CSocket [MFC], CSocket", "CSocket [MFC], Attach", "CSocket [MFC], CancelBlockingCall", "CSocket [MFC], Create", "CSocket [MFC], FromHandle", "CSocket [MFC], IsBlocking", "CSocket [MFC], OnMessagePending"] -ms.assetid: 7f23c081-d24d-42e3-b511-8053ca53d729 --- # `CSocket` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Derives from `CAsyncSocket`, inherits its encapsulation of the Windows Sockets API, and represents a higher level of abstraction than that of a `CAsyncSocket` object. ## Syntax diff --git a/docs/mfc/reference/csocketfile-class.md b/docs/mfc/reference/csocketfile-class.md index 5a6596fbcf7..77c50de870a 100644 --- a/docs/mfc/reference/csocketfile-class.md +++ b/docs/mfc/reference/csocketfile-class.md @@ -4,10 +4,12 @@ title: "CSocketFile Class" ms.date: "11/04/2016" f1_keywords: ["CSocketFile", "AFXSOCK/CSocketFile", "AFXSOCK/CSocketFile::CSocketFile"] helpviewer_keywords: ["CSocketFile [MFC], CSocketFile"] -ms.assetid: 7924c098-5f72-40d6-989d-42800a47958f --- # CSocketFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A `CFile` object used for sending and receiving data across a network via Windows Sockets. ## Syntax diff --git a/docs/mfc/reference/cspinbuttonctrl-class.md b/docs/mfc/reference/cspinbuttonctrl-class.md index d5fc72a6e4e..35a334b4672 100644 --- a/docs/mfc/reference/cspinbuttonctrl-class.md +++ b/docs/mfc/reference/cspinbuttonctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CSpinButtonCtrl [MFC], CSpinButtonCtrl", "CSpinButtonCtrl --- # CSpinButtonCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common spin button control. ## Syntax diff --git a/docs/mfc/reference/csplitbutton-class.md b/docs/mfc/reference/csplitbutton-class.md index 1e57c08c497..e946d578adf 100644 --- a/docs/mfc/reference/csplitbutton-class.md +++ b/docs/mfc/reference/csplitbutton-class.md @@ -4,10 +4,12 @@ title: "CSplitButton Class" ms.date: "11/19/2018" f1_keywords: ["CSplitButton", "AFXCMN/CSplitButton", "AFXCMN/CSplitButton::CSplitButton", "AFXCMN/CSplitButton::Create", "AFXCMN/CSplitButton::SetDropDownMenu", "AFXCMN/CSplitButton::OnDropDown"] helpviewer_keywords: ["CSplitButton [MFC], CSplitButton", "CSplitButton [MFC], Create", "CSplitButton [MFC], SetDropDownMenu", "CSplitButton [MFC], OnDropDown"] -ms.assetid: 6844d0a9-6408-4e44-9b5f-57628ed8bad6 --- # CSplitButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CSplitButton` class represents a split button control. The split button control performs a default behavior when a user clicks the main part of the button, and displays a drop-down menu when a user clicks the drop-down arrow of the button. ## Syntax diff --git a/docs/mfc/reference/csplitterwnd-class.md b/docs/mfc/reference/csplitterwnd-class.md index da72f6e13bb..f84ab903751 100644 --- a/docs/mfc/reference/csplitterwnd-class.md +++ b/docs/mfc/reference/csplitterwnd-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CSplitterWnd [MFC], CSplitterWnd", "CSplitterWnd [MFC], A --- # `CSplitterWnd` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a splitter window, which is a window that contains multiple panes. ## Syntax diff --git a/docs/mfc/reference/csplitterwndex-class.md b/docs/mfc/reference/csplitterwndex-class.md index 58ba5c4a4b3..187fb96b481 100644 --- a/docs/mfc/reference/csplitterwndex-class.md +++ b/docs/mfc/reference/csplitterwndex-class.md @@ -4,10 +4,12 @@ title: "CSplitterWndEx Class" ms.date: "11/04/2016" f1_keywords: ["CSplitterWndEx", "AFXSPLITTERWNDEX/CSplitterWndEx", "AFXSPLITTERWNDEX/CSplitterWndEx::OnDrawSplitter"] helpviewer_keywords: ["CSplitterWndEx [MFC], OnDrawSplitter"] -ms.assetid: 33e5eef3-05e1-4a07-a968-bf9207ce8598 --- # CSplitterWndEx Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a customized splitter window. ## Syntax diff --git a/docs/mfc/reference/cstatic-class.md b/docs/mfc/reference/cstatic-class.md index bce8cd9cc13..00eb9afd387 100644 --- a/docs/mfc/reference/cstatic-class.md +++ b/docs/mfc/reference/cstatic-class.md @@ -4,10 +4,12 @@ title: "CStatic Class" ms.date: "11/04/2016" f1_keywords: ["CStatic", "AFXWIN/CStatic", "AFXWIN/CStatic::CStatic", "AFXWIN/CStatic::Create", "AFXWIN/CStatic::DrawItem", "AFXWIN/CStatic::GetBitmap", "AFXWIN/CStatic::GetCursor", "AFXWIN/CStatic::GetEnhMetaFile", "AFXWIN/CStatic::GetIcon", "AFXWIN/CStatic::SetBitmap", "AFXWIN/CStatic::SetCursor", "AFXWIN/CStatic::SetEnhMetaFile", "AFXWIN/CStatic::SetIcon"] helpviewer_keywords: ["CStatic [MFC], CStatic", "CStatic [MFC], Create", "CStatic [MFC], DrawItem", "CStatic [MFC], GetBitmap", "CStatic [MFC], GetCursor", "CStatic [MFC], GetEnhMetaFile", "CStatic [MFC], GetIcon", "CStatic [MFC], SetBitmap", "CStatic [MFC], SetCursor", "CStatic [MFC], SetEnhMetaFile", "CStatic [MFC], SetIcon"] -ms.assetid: e7c94cd9-5ebd-428a-aa30-b3e51f8efb95 --- # `CStatic` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows static control. ## Syntax diff --git a/docs/mfc/reference/cstatusbar-class.md b/docs/mfc/reference/cstatusbar-class.md index ccbf9e66028..c6c9f11a58f 100644 --- a/docs/mfc/reference/cstatusbar-class.md +++ b/docs/mfc/reference/cstatusbar-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CStatusBar [MFC], CStatusBar", "CStatusBar [MFC], Command --- # CStatusBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A control bar with a row of text output panes, or "indicators." ## Syntax diff --git a/docs/mfc/reference/cstatusbarctrl-class.md b/docs/mfc/reference/cstatusbarctrl-class.md index a8e884c9e38..aed31b1090e 100644 --- a/docs/mfc/reference/cstatusbarctrl-class.md +++ b/docs/mfc/reference/cstatusbarctrl-class.md @@ -4,10 +4,12 @@ title: "CStatusBarCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CStatusBarCtrl", "AFXCMN/CStatusBarCtrl", "AFXCMN/CStatusBarCtrl::CStatusBarCtrl", "AFXCMN/CStatusBarCtrl::Create", "AFXCMN/CStatusBarCtrl::CreateEx", "AFXCMN/CStatusBarCtrl::DrawItem", "AFXCMN/CStatusBarCtrl::GetBorders", "AFXCMN/CStatusBarCtrl::GetIcon", "AFXCMN/CStatusBarCtrl::GetParts", "AFXCMN/CStatusBarCtrl::GetRect", "AFXCMN/CStatusBarCtrl::GetText", "AFXCMN/CStatusBarCtrl::GetTextLength", "AFXCMN/CStatusBarCtrl::GetTipText", "AFXCMN/CStatusBarCtrl::IsSimple", "AFXCMN/CStatusBarCtrl::SetBkColor", "AFXCMN/CStatusBarCtrl::SetIcon", "AFXCMN/CStatusBarCtrl::SetMinHeight", "AFXCMN/CStatusBarCtrl::SetParts", "AFXCMN/CStatusBarCtrl::SetSimple", "AFXCMN/CStatusBarCtrl::SetText", "AFXCMN/CStatusBarCtrl::SetTipText"] helpviewer_keywords: ["CStatusBarCtrl [MFC], CStatusBarCtrl", "CStatusBarCtrl [MFC], Create", "CStatusBarCtrl [MFC], CreateEx", "CStatusBarCtrl [MFC], DrawItem", "CStatusBarCtrl [MFC], GetBorders", "CStatusBarCtrl [MFC], GetIcon", "CStatusBarCtrl [MFC], GetParts", "CStatusBarCtrl [MFC], GetRect", "CStatusBarCtrl [MFC], GetText", "CStatusBarCtrl [MFC], GetTextLength", "CStatusBarCtrl [MFC], GetTipText", "CStatusBarCtrl [MFC], IsSimple", "CStatusBarCtrl [MFC], SetBkColor", "CStatusBarCtrl [MFC], SetIcon", "CStatusBarCtrl [MFC], SetMinHeight", "CStatusBarCtrl [MFC], SetParts", "CStatusBarCtrl [MFC], SetSimple", "CStatusBarCtrl [MFC], SetText", "CStatusBarCtrl [MFC], SetTipText"] -ms.assetid: 8504ad38-7b91-4746-aede-ac98886eb47b --- # CStatusBarCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common status bar control. ## Syntax diff --git a/docs/mfc/reference/cstdiofile-class.md b/docs/mfc/reference/cstdiofile-class.md index fd2ff46ab5a..5cc9c21d9d5 100644 --- a/docs/mfc/reference/cstdiofile-class.md +++ b/docs/mfc/reference/cstdiofile-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CStdioFile [MFC], CStdioFile", "CStdioFile [MFC], Open", --- # `CStdioFile` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a C run-time stream file as opened by the run-time function [`fopen`](../../c-runtime-library/reference/fopen-wfopen.md). ## Syntax diff --git a/docs/mfc/reference/cstring-formatting-and-message-box-display.md b/docs/mfc/reference/cstring-formatting-and-message-box-display.md index 51932cc807a..9a02bc6164b 100644 --- a/docs/mfc/reference/cstring-formatting-and-message-box-display.md +++ b/docs/mfc/reference/cstring-formatting-and-message-box-display.md @@ -3,10 +3,12 @@ description: "Learn more about: CString Formatting and Message-Box Display" title: "CString Formatting and Message-Box Display" ms.date: "11/04/2016" helpviewer_keywords: ["CString objects [MFC], formatting and message boxes"] -ms.assetid: d1068cf4-9cc5-4952-b9e7-d612c53cbc28 --- # `CString` Formatting and Message-Box Display +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A number of functions are provided to format and parse `CString` objects. You can use these functions whenever you have to manipulate `CString` objects, but they are particularly useful for formatting strings that will appear in message-box text. This group of functions also includes a global routine for displaying a message box. diff --git a/docs/mfc/reference/cstringarray-class.md b/docs/mfc/reference/cstringarray-class.md index f8d656bcbbf..89df9c7e97b 100644 --- a/docs/mfc/reference/cstringarray-class.md +++ b/docs/mfc/reference/cstringarray-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CStringArray [MFC], CStringArray", "CStringArray [MFC], A --- # `CStringArray` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports arrays of [`CString`](../../atl-mfc-shared/using-cstring.md) objects. ## Syntax diff --git a/docs/mfc/reference/cstringlist-class.md b/docs/mfc/reference/cstringlist-class.md index 06dfe5f2c01..323ca43963e 100644 --- a/docs/mfc/reference/cstringlist-class.md +++ b/docs/mfc/reference/cstringlist-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CStringList [MFC], CStringList", "CStringList [MFC], AddH --- # `CStringList` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports lists of `CString` objects. ## Syntax diff --git a/docs/mfc/reference/csyncobject-class.md b/docs/mfc/reference/csyncobject-class.md index 535d9aaaa81..3ba190fb667 100644 --- a/docs/mfc/reference/csyncobject-class.md +++ b/docs/mfc/reference/csyncobject-class.md @@ -4,10 +4,12 @@ title: "CSyncObject Class" ms.date: "11/04/2016" f1_keywords: ["CSyncObject", "AFXMT/CSyncObject", "AFXMT/CSyncObject::CSyncObject", "AFXMT/CSyncObject::Lock", "AFXMT/CSyncObject::Unlock", "AFXMT/CSyncObject::m_hObject"] helpviewer_keywords: ["CSyncObject [MFC], CSyncObject", "CSyncObject [MFC], Lock", "CSyncObject [MFC], Unlock", "CSyncObject [MFC], m_hObject"] -ms.assetid: c62ea6eb-a17b-4e01-aed4-321fc435a5f4 --- # CSyncObject Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A pure virtual class that provides functionality common to the synchronization objects in Win32. ## Syntax diff --git a/docs/mfc/reference/ctabbedpane-class.md b/docs/mfc/reference/ctabbedpane-class.md index f6b051754f6..939efc4a2c1 100644 --- a/docs/mfc/reference/ctabbedpane-class.md +++ b/docs/mfc/reference/ctabbedpane-class.md @@ -4,10 +4,12 @@ title: "CTabbedPane Class" ms.date: "11/04/2016" f1_keywords: ["CTabbedPane", "AFXTABBEDPANE/CTabbedPane", "AFXTABBEDPANE/CTabbedPane::DetachPane", "AFXTABBEDPANE/CTabbedPane::EnableTabAutoColor", "AFXTABBEDPANE/CTabbedPane::FloatTab", "AFXTABBEDPANE/CTabbedPane::GetTabArea", "AFXTABBEDPANE/CTabbedPane::GetTabWnd", "AFXTABBEDPANE/CTabbedPane::HasAutoHideMode", "AFXTABBEDPANE/CTabbedPane::IsTabLocationBottom", "AFXTABBEDPANE/CTabbedPane::ResetTabs", "AFXTABBEDPANE/CTabbedPane::SetTabAutoColors", "AFXTABBEDPANE/CTabbedPane::m_bTabsAlwaysTop", "AFXTABBEDPANE/CTabbedPane::m_pTabWndRTC"] helpviewer_keywords: ["CTabbedPane [MFC], DetachPane", "CTabbedPane [MFC], EnableTabAutoColor", "CTabbedPane [MFC], FloatTab", "CTabbedPane [MFC], GetTabArea", "CTabbedPane [MFC], GetTabWnd", "CTabbedPane [MFC], HasAutoHideMode", "CTabbedPane [MFC], IsTabLocationBottom", "CTabbedPane [MFC], ResetTabs", "CTabbedPane [MFC], SetTabAutoColors", "CTabbedPane [MFC], m_bTabsAlwaysTop", "CTabbedPane [MFC], m_pTabWndRTC"] -ms.assetid: f4dc5215-b789-4f2d-8c62-477aceda3578 --- # CTabbedPane Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the functionality of a pane with detachable tabs. or more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/ctabctrl-class.md b/docs/mfc/reference/ctabctrl-class.md index 1a2461f10b1..8e2ee485435 100644 --- a/docs/mfc/reference/ctabctrl-class.md +++ b/docs/mfc/reference/ctabctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CTabCtrl [MFC], CTabCtrl", "CTabCtrl [MFC], AdjustRect", --- # `CTabCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common tab control. ## Syntax diff --git a/docs/mfc/reference/ctabview-class.md b/docs/mfc/reference/ctabview-class.md index 82983a5e29a..2a38b3edd1b 100644 --- a/docs/mfc/reference/ctabview-class.md +++ b/docs/mfc/reference/ctabview-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CTabView [MFC], AddView", "CTabView [MFC], FindTab", "CTa --- # CTabView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CTabView` class simplifies the use of the tab control class ( [CMFCTabCtrl](../../mfc/reference/ctabview-class.md)) in applications that use MFC's document/view architecture. ## Syntax diff --git a/docs/mfc/reference/ctaskdialog-class.md b/docs/mfc/reference/ctaskdialog-class.md index 2f1d87a8197..c7d5d84e1a4 100644 --- a/docs/mfc/reference/ctaskdialog-class.md +++ b/docs/mfc/reference/ctaskdialog-class.md @@ -4,10 +4,12 @@ title: "CTaskDialog Class" ms.date: "11/19/2018" f1_keywords: ["CTaskDialog", "AFXTASKDIALOG/CTaskDialog", "AFXTASKDIALOG/CTaskDialog::CTaskDialog", "AFXTASKDIALOG/CTaskDialog::AddCommandControl", "AFXTASKDIALOG/CTaskDialog::AddRadioButton", "AFXTASKDIALOG/CTaskDialog::ClickCommandControl", "AFXTASKDIALOG/CTaskDialog::ClickRadioButton", "AFXTASKDIALOG/CTaskDialog::DoModal", "AFXTASKDIALOG/CTaskDialog::GetCommonButtonCount", "AFXTASKDIALOG/CTaskDialog::GetCommonButtonFlag", "AFXTASKDIALOG/CTaskDialog::GetCommonButtonId", "AFXTASKDIALOG/CTaskDialog::GetOptions", "AFXTASKDIALOG/CTaskDialog::GetSelectedCommandControlID", "AFXTASKDIALOG/CTaskDialog::GetSelectedRadioButtonID", "AFXTASKDIALOG/CTaskDialog::GetVerificationCheckboxState", "AFXTASKDIALOG/CTaskDialog::IsCommandControlEnabled", "AFXTASKDIALOG/CTaskDialog::IsRadioButtonEnabled", "AFXTASKDIALOG/CTaskDialog::IsSupported", "AFXTASKDIALOG/CTaskDialog::LoadCommandControls", "AFXTASKDIALOG/CTaskDialog::LoadRadioButtons", "AFXTASKDIALOG/CTaskDialog::NavigateTo", "AFXTASKDIALOG/CTaskDialog::OnCommandControlClick", "AFXTASKDIALOG/CTaskDialog::OnCreate", "AFXTASKDIALOG/CTaskDialog::OnDestroy", "AFXTASKDIALOG/CTaskDialog::OnExpandButtonClick", "AFXTASKDIALOG/CTaskDialog::OnHelp", "AFXTASKDIALOG/CTaskDialog::OnHyperlinkClick", "AFXTASKDIALOG/CTaskDialog::OnInit", "AFXTASKDIALOG/CTaskDialog::OnNavigatePage", "AFXTASKDIALOG/CTaskDialog::OnRadioButtonClick", "AFXTASKDIALOG/CTaskDialog::OnTimer", "AFXTASKDIALOG/CTaskDialog::OnVerificationCheckboxClick", "AFXTASKDIALOG/CTaskDialog::RemoveAllCommandControls", "AFXTASKDIALOG/CTaskDialog::RemoveAllRadioButtons", "AFXTASKDIALOG/CTaskDialog::SetCommandControlOptions", "AFXTASKDIALOG/CTaskDialog::SetCommonButtonOptions", "AFXTASKDIALOG/CTaskDialog::SetCommonButtons", "AFXTASKDIALOG/CTaskDialog::SetContent", "AFXTASKDIALOG/CTaskDialog::SetDefaultCommandControl", "AFXTASKDIALOG/CTaskDialog::SetDefaultRadioButton", "AFXTASKDIALOG/CTaskDialog::SetDialogWidth", "AFXTASKDIALOG/CTaskDialog::SetExpansionArea", "AFXTASKDIALOG/CTaskDialog::SetFooterIcon", "AFXTASKDIALOG/CTaskDialog::SetFooterText", "AFXTASKDIALOG/CTaskDialog::SetMainIcon", "AFXTASKDIALOG/CTaskDialog::SetMainInstruction", "AFXTASKDIALOG/CTaskDialog::SetOptions", "AFXTASKDIALOG/CTaskDialog::SetProgressBarMarquee", "AFXTASKDIALOG/CTaskDialog::SetProgressBarPosition", "AFXTASKDIALOG/CTaskDialog::SetProgressBarRange", "AFXTASKDIALOG/CTaskDialog::SetProgressBarState", "AFXTASKDIALOG/CTaskDialog::SetRadioButtonOptions", "AFXTASKDIALOG/CTaskDialog::SetVerificationCheckbox", "AFXTASKDIALOG/CTaskDialog::SetVerificationCheckboxText", "AFXTASKDIALOG/CTaskDialog::SetWindowTitle", "AFXTASKDIALOG/CTaskDialog::ShowDialog", "AFXTASKDIALOG/CTaskDialog::TaskDialogCallback"] helpviewer_keywords: ["CTaskDialog [MFC], CTaskDialog", "CTaskDialog [MFC], AddCommandControl", "CTaskDialog [MFC], AddRadioButton", "CTaskDialog [MFC], ClickCommandControl", "CTaskDialog [MFC], ClickRadioButton", "CTaskDialog [MFC], DoModal", "CTaskDialog [MFC], GetCommonButtonCount", "CTaskDialog [MFC], GetCommonButtonFlag", "CTaskDialog [MFC], GetCommonButtonId", "CTaskDialog [MFC], GetOptions", "CTaskDialog [MFC], GetSelectedCommandControlID", "CTaskDialog [MFC], GetSelectedRadioButtonID", "CTaskDialog [MFC], GetVerificationCheckboxState", "CTaskDialog [MFC], IsCommandControlEnabled", "CTaskDialog [MFC], IsRadioButtonEnabled", "CTaskDialog [MFC], IsSupported", "CTaskDialog [MFC], LoadCommandControls", "CTaskDialog [MFC], LoadRadioButtons", "CTaskDialog [MFC], NavigateTo", "CTaskDialog [MFC], OnCommandControlClick", "CTaskDialog [MFC], OnCreate", "CTaskDialog [MFC], OnDestroy", "CTaskDialog [MFC], OnExpandButtonClick", "CTaskDialog [MFC], OnHelp", "CTaskDialog [MFC], OnHyperlinkClick", "CTaskDialog [MFC], OnInit", "CTaskDialog [MFC], OnNavigatePage", "CTaskDialog [MFC], OnRadioButtonClick", "CTaskDialog [MFC], OnTimer", "CTaskDialog [MFC], OnVerificationCheckboxClick", "CTaskDialog [MFC], RemoveAllCommandControls", "CTaskDialog [MFC], RemoveAllRadioButtons", "CTaskDialog [MFC], SetCommandControlOptions", "CTaskDialog [MFC], SetCommonButtonOptions", "CTaskDialog [MFC], SetCommonButtons", "CTaskDialog [MFC], SetContent", "CTaskDialog [MFC], SetDefaultCommandControl", "CTaskDialog [MFC], SetDefaultRadioButton", "CTaskDialog [MFC], SetDialogWidth", "CTaskDialog [MFC], SetExpansionArea", "CTaskDialog [MFC], SetFooterIcon", "CTaskDialog [MFC], SetFooterText", "CTaskDialog [MFC], SetMainIcon", "CTaskDialog [MFC], SetMainInstruction", "CTaskDialog [MFC], SetOptions", "CTaskDialog [MFC], SetProgressBarMarquee", "CTaskDialog [MFC], SetProgressBarPosition", "CTaskDialog [MFC], SetProgressBarRange", "CTaskDialog [MFC], SetProgressBarState", "CTaskDialog [MFC], SetRadioButtonOptions", "CTaskDialog [MFC], SetVerificationCheckbox", "CTaskDialog [MFC], SetVerificationCheckboxText", "CTaskDialog [MFC], SetWindowTitle", "CTaskDialog [MFC], ShowDialog", "CTaskDialog [MFC], TaskDialogCallback"] -ms.assetid: 1991ec98-ae56-4483-958b-233809c8c559 --- # CTaskDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A pop-up dialog box that functions like a message box but can display additional information to the user. The `CTaskDialog` also includes functionality for gathering information from the user. ## Syntax diff --git a/docs/mfc/reference/ctoolbar-class.md b/docs/mfc/reference/ctoolbar-class.md index 33cab610164..0374063757d 100644 --- a/docs/mfc/reference/ctoolbar-class.md +++ b/docs/mfc/reference/ctoolbar-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CToolBar [MFC], CToolBar", "CToolBar [MFC], CommandToInde --- # `CToolBar` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Control bars that have a row of bitmapped buttons and optional separators. ## Syntax diff --git a/docs/mfc/reference/ctoolbarctrl-class.md b/docs/mfc/reference/ctoolbarctrl-class.md index e213031818b..b4ff4996576 100644 --- a/docs/mfc/reference/ctoolbarctrl-class.md +++ b/docs/mfc/reference/ctoolbarctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CToolBarCtrl [MFC], CToolBarCtrl", "CToolBarCtrl [MFC], A --- # `CToolBarCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows toolbar common control. ## Syntax diff --git a/docs/mfc/reference/ctooltipctrl-class.md b/docs/mfc/reference/ctooltipctrl-class.md index ceaf49a6f03..258feb52633 100644 --- a/docs/mfc/reference/ctooltipctrl-class.md +++ b/docs/mfc/reference/ctooltipctrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CToolTipCtrl [MFC], CToolTipCtrl", "CToolTipCtrl [MFC], A --- # `CToolTipCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the functionality of a "tooltip control," a small pop-up window that displays a single line of text describing the purpose of a tool in an application. ## Syntax diff --git a/docs/mfc/reference/ctooltipmanager-class.md b/docs/mfc/reference/ctooltipmanager-class.md index 4a495081f92..a8ed2b9ada1 100644 --- a/docs/mfc/reference/ctooltipmanager-class.md +++ b/docs/mfc/reference/ctooltipmanager-class.md @@ -4,10 +4,12 @@ title: "CTooltipManager Class" ms.date: "11/04/2016" f1_keywords: ["CTooltipManager", "AFXTOOLTIPMANAGER/CTooltipManager", "AFXTOOLTIPMANAGER/CTooltipManager::CreateToolTip", "AFXTOOLTIPMANAGER/CTooltipManager::DeleteToolTip", "AFXTOOLTIPMANAGER/CTooltipManager::SetTooltipParams", "AFXTOOLTIPMANAGER/CTooltipManager::SetTooltipText", "AFXTOOLTIPMANAGER/CTooltipManager::UpdateTooltips"] helpviewer_keywords: ["CTooltipManager [MFC], CreateToolTip", "CTooltipManager [MFC], DeleteToolTip", "CTooltipManager [MFC], SetTooltipParams", "CTooltipManager [MFC], SetTooltipText", "CTooltipManager [MFC], UpdateTooltips"] -ms.assetid: c71779d7-8b6e-47ef-8500-d4552731fe86 --- # CTooltipManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Maintains runtime information about tooltips. The `CTooltipManager` class is instantiated one time per application. ## Syntax diff --git a/docs/mfc/reference/ctreectrl-class.md b/docs/mfc/reference/ctreectrl-class.md index 81ce2a29cb7..f3679f9e9bc 100644 --- a/docs/mfc/reference/ctreectrl-class.md +++ b/docs/mfc/reference/ctreectrl-class.md @@ -4,10 +4,12 @@ title: "CTreeCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CTreeCtrl", "AFXCMN/CTreeCtrl", "AFXCMN/CTreeCtrl::CTreeCtrl", "AFXCMN/CTreeCtrl::Create", "AFXCMN/CTreeCtrl::CreateDragImage", "AFXCMN/CTreeCtrl::CreateEx", "AFXCMN/CTreeCtrl::DeleteAllItems", "AFXCMN/CTreeCtrl::DeleteItem", "AFXCMN/CTreeCtrl::EditLabel", "AFXCMN/CTreeCtrl::EndEditLabelNow", "AFXCMN/CTreeCtrl::EnsureVisible", "AFXCMN/CTreeCtrl::Expand", "AFXCMN/CTreeCtrl::GetBkColor", "AFXCMN/CTreeCtrl::GetCheck", "AFXCMN/CTreeCtrl::GetChildItem", "AFXCMN/CTreeCtrl::GetCount", "AFXCMN/CTreeCtrl::GetDropHilightItem", "AFXCMN/CTreeCtrl::GetEditControl", "AFXCMN/CTreeCtrl::GetExtendedStyle", "AFXCMN/CTreeCtrl::GetFirstVisibleItem", "AFXCMN/CTreeCtrl::GetImageList", "AFXCMN/CTreeCtrl::GetIndent", "AFXCMN/CTreeCtrl::GetInsertMarkColor", "AFXCMN/CTreeCtrl::GetItem", "AFXCMN/CTreeCtrl::GetItemData", "AFXCMN/CTreeCtrl::GetItemExpandedImageIndex", "AFXCMN/CTreeCtrl::GetItemHeight", "AFXCMN/CTreeCtrl::GetItemImage", "AFXCMN/CTreeCtrl::GetItemPartRect", "AFXCMN/CTreeCtrl::GetItemRect", "AFXCMN/CTreeCtrl::GetItemState", "AFXCMN/CTreeCtrl::GetItemStateEx", "AFXCMN/CTreeCtrl::GetItemText", "AFXCMN/CTreeCtrl::GetLastVisibleItem", "AFXCMN/CTreeCtrl::GetLineColor", "AFXCMN/CTreeCtrl::GetNextItem", "AFXCMN/CTreeCtrl::GetNextSiblingItem", "AFXCMN/CTreeCtrl::GetNextVisibleItem", "AFXCMN/CTreeCtrl::GetParentItem", "AFXCMN/CTreeCtrl::GetPrevSiblingItem", "AFXCMN/CTreeCtrl::GetPrevVisibleItem", "AFXCMN/CTreeCtrl::GetRootItem", "AFXCMN/CTreeCtrl::GetScrollTime", "AFXCMN/CTreeCtrl::GetSelectedCount", "AFXCMN/CTreeCtrl::GetSelectedItem", "AFXCMN/CTreeCtrl::GetTextColor", "AFXCMN/CTreeCtrl::GetToolTips", "AFXCMN/CTreeCtrl::GetVisibleCount", "AFXCMN/CTreeCtrl::HitTest", "AFXCMN/CTreeCtrl::InsertItem", "AFXCMN/CTreeCtrl::ItemHasChildren", "AFXCMN/CTreeCtrl::MapAccIdToItem", "AFXCMN/CTreeCtrl::MapItemToAccID", "AFXCMN/CTreeCtrl::Select", "AFXCMN/CTreeCtrl::SelectDropTarget", "AFXCMN/CTreeCtrl::SelectItem", "AFXCMN/CTreeCtrl::SelectSetFirstVisible", "AFXCMN/CTreeCtrl::SetAutoscrollInfo", "AFXCMN/CTreeCtrl::SetBkColor", "AFXCMN/CTreeCtrl::SetCheck", "AFXCMN/CTreeCtrl::SetExtendedStyle", "AFXCMN/CTreeCtrl::SetImageList", "AFXCMN/CTreeCtrl::SetIndent", "AFXCMN/CTreeCtrl::SetInsertMark", "AFXCMN/CTreeCtrl::SetInsertMarkColor", "AFXCMN/CTreeCtrl::SetItem", "AFXCMN/CTreeCtrl::SetItemData", "AFXCMN/CTreeCtrl::SetItemExpandedImageIndex", "AFXCMN/CTreeCtrl::SetItemHeight", "AFXCMN/CTreeCtrl::SetItemImage", "AFXCMN/CTreeCtrl::SetItemState", "AFXCMN/CTreeCtrl::SetItemStateEx", "AFXCMN/CTreeCtrl::SetItemText", "AFXCMN/CTreeCtrl::SetLineColor", "AFXCMN/CTreeCtrl::SetScrollTime", "AFXCMN/CTreeCtrl::SetTextColor", "AFXCMN/CTreeCtrl::SetToolTips", "AFXCMN/CTreeCtrl::ShowInfoTip", "AFXCMN/CTreeCtrl::SortChildren", "AFXCMN/CTreeCtrl::SortChildrenCB"] helpviewer_keywords: ["CTreeCtrl [MFC], CTreeCtrl", "CTreeCtrl [MFC], Create", "CTreeCtrl [MFC], CreateDragImage", "CTreeCtrl [MFC], CreateEx", "CTreeCtrl [MFC], DeleteAllItems", "CTreeCtrl [MFC], DeleteItem", "CTreeCtrl [MFC], EditLabel", "CTreeCtrl [MFC], EndEditLabelNow", "CTreeCtrl [MFC], EnsureVisible", "CTreeCtrl [MFC], Expand", "CTreeCtrl [MFC], GetBkColor", "CTreeCtrl [MFC], GetCheck", "CTreeCtrl [MFC], GetChildItem", "CTreeCtrl [MFC], GetCount", "CTreeCtrl [MFC], GetDropHilightItem", "CTreeCtrl [MFC], GetEditControl", "CTreeCtrl [MFC], GetExtendedStyle", "CTreeCtrl [MFC], GetFirstVisibleItem", "CTreeCtrl [MFC], GetImageList", "CTreeCtrl [MFC], GetIndent", "CTreeCtrl [MFC], GetInsertMarkColor", "CTreeCtrl [MFC], GetItem", "CTreeCtrl [MFC], GetItemData", "CTreeCtrl [MFC], GetItemExpandedImageIndex", "CTreeCtrl [MFC], GetItemHeight", "CTreeCtrl [MFC], GetItemImage", "CTreeCtrl [MFC], GetItemPartRect", "CTreeCtrl [MFC], GetItemRect", "CTreeCtrl [MFC], GetItemState", "CTreeCtrl [MFC], GetItemStateEx", "CTreeCtrl [MFC], GetItemText", "CTreeCtrl [MFC], GetLastVisibleItem", "CTreeCtrl [MFC], GetLineColor", "CTreeCtrl [MFC], GetNextItem", "CTreeCtrl [MFC], GetNextSiblingItem", "CTreeCtrl [MFC], GetNextVisibleItem", "CTreeCtrl [MFC], GetParentItem", "CTreeCtrl [MFC], GetPrevSiblingItem", "CTreeCtrl [MFC], GetPrevVisibleItem", "CTreeCtrl [MFC], GetRootItem", "CTreeCtrl [MFC], GetScrollTime", "CTreeCtrl [MFC], GetSelectedCount", "CTreeCtrl [MFC], GetSelectedItem", "CTreeCtrl [MFC], GetTextColor", "CTreeCtrl [MFC], GetToolTips", "CTreeCtrl [MFC], GetVisibleCount", "CTreeCtrl [MFC], HitTest", "CTreeCtrl [MFC], InsertItem", "CTreeCtrl [MFC], ItemHasChildren", "CTreeCtrl [MFC], MapAccIdToItem", "CTreeCtrl [MFC], MapItemToAccID", "CTreeCtrl [MFC], Select", "CTreeCtrl [MFC], SelectDropTarget", "CTreeCtrl [MFC], SelectItem", "CTreeCtrl [MFC], SelectSetFirstVisible", "CTreeCtrl [MFC], SetAutoscrollInfo", "CTreeCtrl [MFC], SetBkColor", "CTreeCtrl [MFC], SetCheck", "CTreeCtrl [MFC], SetExtendedStyle", "CTreeCtrl [MFC], SetImageList", "CTreeCtrl [MFC], SetIndent", "CTreeCtrl [MFC], SetInsertMark", "CTreeCtrl [MFC], SetInsertMarkColor", "CTreeCtrl [MFC], SetItem", "CTreeCtrl [MFC], SetItemData", "CTreeCtrl [MFC], SetItemExpandedImageIndex", "CTreeCtrl [MFC], SetItemHeight", "CTreeCtrl [MFC], SetItemImage", "CTreeCtrl [MFC], SetItemState", "CTreeCtrl [MFC], SetItemStateEx", "CTreeCtrl [MFC], SetItemText", "CTreeCtrl [MFC], SetLineColor", "CTreeCtrl [MFC], SetScrollTime", "CTreeCtrl [MFC], SetTextColor", "CTreeCtrl [MFC], SetToolTips", "CTreeCtrl [MFC], ShowInfoTip", "CTreeCtrl [MFC], SortChildren", "CTreeCtrl [MFC], SortChildrenCB"] -ms.assetid: 96e20031-6161-4143-8c12-8d1816c66d90 --- # `CTreeCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common tree view control. ## Syntax diff --git a/docs/mfc/reference/ctreeview-class.md b/docs/mfc/reference/ctreeview-class.md index 7511efdd06c..4419e23af0a 100644 --- a/docs/mfc/reference/ctreeview-class.md +++ b/docs/mfc/reference/ctreeview-class.md @@ -4,10 +4,12 @@ title: "CTreeView Class" ms.date: "11/04/2016" f1_keywords: ["CTreeView", "AFXCVIEW/CTreeView", "AFXCVIEW/CTreeView::CTreeView", "AFXCVIEW/CTreeView::GetTreeCtrl"] helpviewer_keywords: ["CTreeView [MFC], CTreeView", "CTreeView [MFC], GetTreeCtrl"] -ms.assetid: 5df583a6-d69f-42ca-9d8d-57e04558afff --- # CTreeView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Simplifies use of the tree control and of [CTreeCtrl](../../mfc/reference/ctreectrl-class.md), the class that encapsulates tree-control functionality, with MFC's document-view architecture. ## Syntax diff --git a/docs/mfc/reference/ctypedptrarray-class.md b/docs/mfc/reference/ctypedptrarray-class.md index db37f7ca4af..0ece714e621 100644 --- a/docs/mfc/reference/ctypedptrarray-class.md +++ b/docs/mfc/reference/ctypedptrarray-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CTypedPtrArray [MFC], Add", "CTypedPtrArray [MFC], Append --- # CTypedPtrArray Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides a type-safe "wrapper" for objects of class `CPtrArray` or `CObArray`. ## Syntax diff --git a/docs/mfc/reference/ctypedptrlist-class.md b/docs/mfc/reference/ctypedptrlist-class.md index d06daa00f41..0ffa8e30f0f 100644 --- a/docs/mfc/reference/ctypedptrlist-class.md +++ b/docs/mfc/reference/ctypedptrlist-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CTypedPtrList [MFC], AddHead", "CTypedPtrList [MFC], AddT --- # CTypedPtrList Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides a type-safe "wrapper" for objects of class `CPtrList`. ## Syntax From 9deec15e164e455d7116586577635ce4150e283f Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 20 Feb 2026 12:44:46 -0800 Subject: [PATCH 1635/1799] Batch 1: update files (#6258) --- docs/atl/recommendations-for-choosing-between-atl-and-mfc.md | 4 +++- docs/data/data-access-programming-mfc-atl.md | 4 +++- docs/mfc/a-portrait-of-the-document-view-architecture.md | 4 +++- docs/mfc/accessing-all-members-of-a-collection.md | 4 +++- docs/mfc/accessing-file-status.md | 4 +++- docs/mfc/accessing-run-time-class-information.md | 4 +++- docs/mfc/accessing-the-embedded-month-calendar-control.md | 4 +++- docs/mfc/activation-cpp.md | 4 +++- docs/mfc/activation-verbs.md | 3 +++ docs/mfc/active-document-classes.md | 4 +++- docs/mfc/active-document-containers.md | 4 +++- docs/mfc/active-document-containment.md | 4 +++- docs/mfc/active-document-servers.md | 4 +++- docs/mfc/active-documents.md | 4 +++- docs/mfc/active-technology-on-the-internet.md | 4 +++- ...ners-connecting-an-activex-control-to-a-member-variable.md | 4 +++- ...trol-containers-handling-events-from-an-activex-control.md | 4 +++- ...ontainers-manually-enabling-activex-control-containment.md | 4 +++- ...rol-containers-using-controls-in-a-non-dialog-container.md | 4 +++- ...rol-containers-viewing-and-modifying-control-properties.md | 4 +++- docs/mfc/activex-control-containers.md | 4 +++- docs/mfc/activex-controls-on-the-internet.md | 4 +++- docs/mfc/activex-controls.md | 4 +++- docs/mfc/adding-columns-to-the-control-report-view.md | 4 +++- docs/mfc/adding-controls-by-hand.md | 4 +++- docs/mfc/adding-controls-to-a-property-sheet.md | 4 +++- docs/mfc/adding-items-to-the-control.md | 4 +++- docs/mfc/adding-items-to-the-header-control.md | 4 +++- docs/mfc/adding-multiple-views-to-a-single-document.md | 4 +++- docs/mfc/adding-tabs-to-a-tab-control.md | 4 +++- docs/mfc/advantages-of-the-document-view-architecture.md | 4 +++- docs/mfc/allocating-and-deallocating-window-memory.md | 4 +++- docs/mfc/allocating-gdi-resources.md | 4 +++- docs/mfc/alternatives-to-the-document-view-architecture.md | 4 +++- docs/mfc/application-and-thread-support-classes.md | 4 +++- docs/mfc/application-design-choices.md | 4 +++- docs/mfc/application-framework.md | 4 +++- docs/mfc/array-list-and-map-classes.md | 4 +++- docs/mfc/asynchronous-monikers-on-the-internet.md | 4 +++- docs/mfc/automation-clients-using-type-libraries.md | 4 +++- docs/mfc/automation-clients.md | 4 +++- docs/mfc/automation-servers-object-lifetime-issues.md | 4 +++- docs/mfc/automation-servers.md | 4 +++- docs/mfc/automation.md | 4 +++- docs/mfc/bottomless-rich-edit-controls.md | 4 +++- .../build-requirements-for-windows-vista-common-controls.md | 4 +++- docs/mfc/building-on-the-framework.md | 4 +++- docs/mfc/bypassing-the-serialization-mechanism.md | 4 +++- docs/mfc/callback-items-and-the-callback-mask.md | 4 +++- docs/mfc/changing-list-control-styles.md | 4 +++- docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md | 4 +++- docs/mfc/character-formatting-in-rich-edit-controls.md | 4 +++- docs/mfc/class-library-overview.md | 4 +++- docs/mfc/classes-related-to-rich-edit-controls.md | 4 +++- docs/mfc/cleaning-up-documents-and-views.md | 4 +++- docs/mfc/clipboard-adding-other-formats.md | 4 +++- docs/mfc/clipboard-copying-and-pasting-data.md | 4 +++- docs/mfc/clipboard-operations-in-rich-edit-controls.md | 4 +++- docs/mfc/clipboard-using-the-ole-clipboard-mechanism.md | 4 +++- docs/mfc/clipboard-using-the-windows-clipboard.md | 4 +++- docs/mfc/clipboard-when-to-use-each-clipboard-mechanism.md | 4 +++- docs/mfc/clipboard.md | 4 +++- docs/mfc/closing-files.md | 4 +++- docs/mfc/closing-the-dialog-box.md | 4 +++- docs/mfc/cobject-class-frequently-asked-questions.md | 4 +++- docs/mfc/collections.md | 4 +++- docs/mfc/com-interface-entry-points.md | 4 +++- docs/mfc/command-ids.md | 4 +++- docs/mfc/command-routing-classes.md | 4 +++- docs/mfc/command-routing-illustration.md | 4 +++- docs/mfc/command-routing.md | 4 +++- docs/mfc/command-targets.md | 4 +++- docs/mfc/common-control-sample-list.md | 4 +++- docs/mfc/common-dialog-classes.md | 4 +++- docs/mfc/commonly-added-member-functions.md | 4 +++- docs/mfc/commonly-overridden-member-functions.md | 4 +++- docs/mfc/communicating-with-a-tree-control.md | 4 +++- docs/mfc/connection-points.md | 4 +++- docs/mfc/containers-advanced-features.md | 4 +++- docs/mfc/containers-client-item-notifications.md | 4 +++- docs/mfc/containers-client-item-states.md | 4 +++- docs/mfc/containers-client-items.md | 4 +++- docs/mfc/containers-compound-files.md | 4 +++- docs/mfc/containers-for-activex-controls.md | 4 +++- docs/mfc/containers-implementing-a-container.md | 4 +++- docs/mfc/containers-user-interface-issues.md | 4 +++- docs/mfc/containers.md | 4 +++- docs/mfc/control-bar-classes.md | 4 +++- docs/mfc/control-bars.md | 4 +++- docs/mfc/control-classes.md | 4 +++- docs/mfc/controls-mfc.md | 4 +++- docs/mfc/creating-a-ctoolbarctrl-object.md | 4 +++- docs/mfc/creating-a-dialog-class-with-code-wizards.md | 4 +++- docs/mfc/creating-a-modeless-property-sheet.md | 4 +++- docs/mfc/creating-a-rebar-control.md | 4 +++- docs/mfc/creating-an-active-document-container-application.md | 4 +++- docs/mfc/creating-an-extended-combo-box-control.md | 4 +++- docs/mfc/creating-and-displaying-dialog-boxes.md | 4 +++- docs/mfc/creating-document-frame-windows.md | 4 +++- docs/mfc/creating-modal-dialog-boxes.md | 4 +++- 100 files changed, 300 insertions(+), 99 deletions(-) diff --git a/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md b/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md index 2fc4145a2b8..df9f94e0a58 100644 --- a/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md +++ b/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Recommendations for Choosing Between ATL and MFC title: "Recommendations for Choosing Between ATL and MFC" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, ATL support", "ATL, vs. MFC"] -ms.assetid: 269325bb-11a8-4330-ad2b-a14a2458679e --- # Recommendations for Choosing Between ATL and MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. + When developing components and applications, you can choose between two approaches — ATL and MFC (the Microsoft Foundation Class Library). ## Using ATL diff --git a/docs/data/data-access-programming-mfc-atl.md b/docs/data/data-access-programming-mfc-atl.md index c2dda6ed1d6..f98e765142a 100644 --- a/docs/data/data-access-programming-mfc-atl.md +++ b/docs/data/data-access-programming-mfc-atl.md @@ -3,10 +3,12 @@ description: "Learn more about: Data Access Programming (MFC/ATL)" title: "Data Access Programming (MFC-ATL)" ms.date: "11/16/2018" helpviewer_keywords: ["MFC [C++], data access applications", "databases [C++], MFC", "OLE DB [C++], data access technologies", "data [C++], data access technologies", "data access [C++], class libraries for databases"] -ms.assetid: def97b2c-b5a6-445f-afeb-308050fd4852 --- # Data Access Programming (MFC/ATL) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. + Over the years, Visual C++ has provided several ways to work with databases. In 2011 Microsoft announced that it is aligning on Open Database Connectivity (ODBC) as the preferred technology for accessing SQL Server products from native code. ODBC is an industry standard, and by using it you gain maximum portability of your code over multiple platforms and data sources. Most SQL database products and many NoSQL products support ODBC. You can use ODBC directly by calling the low-level ODBC APIs, or you can use the MFC ODBC wrapper classes, or a third-party C++ wrapper library. OLE DB is a low-level, high-performance API based on the COM specification, and is only supported on Windows. Use OLE DB if your program is accessing [linked servers](/sql/relational-databases/linked-servers/linked-servers-database-engine). ATL provides OLE DB templates that make it easier to create custom OLE DB providers and consumers. The most recent provider for Microsoft SQL Server can be found in the documentation for the [OLE DB Driver for SQL Server](/sql/connect/oledb/oledb-driver-for-sql-server). diff --git a/docs/mfc/a-portrait-of-the-document-view-architecture.md b/docs/mfc/a-portrait-of-the-document-view-architecture.md index 2fa6b524004..de319b5b0da 100644 --- a/docs/mfc/a-portrait-of-the-document-view-architecture.md +++ b/docs/mfc/a-portrait-of-the-document-view-architecture.md @@ -3,10 +3,12 @@ description: "Learn more about: A Portrait of the Document/View Architecture" title: "A Portrait of the Document-View Architecture" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], views", "multiple views [MFC], updating from document", "document/view architecture [MFC]", "views [MFC], and user input", "documents [MFC], accessing data from view", "views [MFC], updating", "input [MFC], view class", "documents [MFC], multiple views", "document/view architecture [MFC], accessing data from view", "document/view architecture [MFC], about document/view architecture", "views [MFC], accessing document data from"] -ms.assetid: 4e7f65dc-b166-45d8-bcd5-9bb0d399b946 --- # A Portrait of the Document/View Architecture +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Documents and views are paired in a typical MFC application. Data is stored in the document, but the view has privileged access to the data. The separation of document from view separates the storage and maintenance of data from its display. ## Gaining Access to Document Data from the View diff --git a/docs/mfc/accessing-all-members-of-a-collection.md b/docs/mfc/accessing-all-members-of-a-collection.md index 0cd39499410..3ee1f74208c 100644 --- a/docs/mfc/accessing-all-members-of-a-collection.md +++ b/docs/mfc/accessing-all-members-of-a-collection.md @@ -3,11 +3,13 @@ description: "Learn more about: Accessing All Members of a Collection" title: "Accessing All Members of a Collection" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, collections", "enumerations [MFC]", "enumerating collections [MFC]", "collections [MFC], accessing", "collection classes [MFC]", ", ", ", ", ", ", ", ", ", ", ", ", ", "] -ms.assetid: 7bbae518-062e-4393-81f9-b22abd2e5f59 ms.topic: how-to --- # Accessing All Members of a Collection +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The MFC array collection classes — both template-based and not — use indexes to access their elements. The MFC list and map collection classes — both template-based and not — use an indicator of type **POSITION** to describe a given position within the collection. To access one or more members of these collections, you first initialize the position indicator and then repeatedly pass that position to the collection and ask it to return the next element. The collection is not responsible for maintaining state information about the progress of the iteration. That information is kept in the position indicator. But, given a particular position, the collection is responsible for returning the next element. The following procedures show how to iterate over the three main types of collections provided with MFC: diff --git a/docs/mfc/accessing-file-status.md b/docs/mfc/accessing-file-status.md index f582a6558bc..6e75ed88b8d 100644 --- a/docs/mfc/accessing-file-status.md +++ b/docs/mfc/accessing-file-status.md @@ -3,11 +3,13 @@ description: "Learn more about: Accessing File Status" title: "Accessing File Status" ms.date: "11/04/2016" helpviewer_keywords: ["files [MFC], status information", "examples [MFC], file status", "files [MFC], accessing", "file status [MFC]", "status of files [MFC]"] -ms.assetid: 1b8891d6-eb0f-4037-a837-4928fe595222 ms.topic: how-to --- # Accessing File Status +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CFile` also supports getting file status, including whether the file exists, creation and modification dates and times, logical size, and path. ### To get file status diff --git a/docs/mfc/accessing-run-time-class-information.md b/docs/mfc/accessing-run-time-class-information.md index e0981fe062a..167bf60b463 100644 --- a/docs/mfc/accessing-run-time-class-information.md +++ b/docs/mfc/accessing-run-time-class-information.md @@ -3,11 +3,13 @@ description: "Learn more about: Accessing Run-Time Class Information" title: "Accessing Run-Time Class Information" ms.date: "11/04/2016" helpviewer_keywords: ["CObject class [MFC], and RTTI", "CObject class [MFC], using IsKindOf method [MFC]", "run time [MFC], class information", "RUNTIME_CLASS macro [MFC]", "CObject class [MFC], using RUNTIME_CLASS macro [MFC]", "RTTI compiler option [MFC]", "CObject class [MFC], accessing run-time class information", "run time [MFC]", "IsKindOf method method [MFC]", "run-time class [MFC], accessing information", "classes [MFC], run-time class information", "run-time class [MFC]", "RUNTIME_CLASS macro, using"] -ms.assetid: 3445a9af-0bd6-4496-95c3-aa59b964570b ms.topic: how-to --- # Accessing Run-Time Class Information +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to access information about the class of an object at run time. > [!NOTE] diff --git a/docs/mfc/accessing-the-embedded-month-calendar-control.md b/docs/mfc/accessing-the-embedded-month-calendar-control.md index c8c09084768..d325e55ce73 100644 --- a/docs/mfc/accessing-the-embedded-month-calendar-control.md +++ b/docs/mfc/accessing-the-embedded-month-calendar-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Accessing the Embedded Month Calendar Control" title: "Accessing the Embedded Month Calendar Control" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC], accessing month calendar", "CDateTimeCtrl class [MFC], accessing embedded control", "month calendar controls [MFC], embedded in date/time picker", "CMonthCalCtrl class [MFC], changing the font", "month calendar controls [MFC], changing the font", "DateTimePicker control [MFC]"] -ms.assetid: 355e97ed-cf81-4df3-a2f8-9ddbbde93227 ms.topic: concept-article --- # Accessing the Embedded Month Calendar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The embedded month calendar control object can be accessed from the `CDateTimeCtrl` object with a call to the [GetMonthCalCtrl](reference/cdatetimectrl-class.md#getmonthcalctrl) member function. > [!NOTE] diff --git a/docs/mfc/activation-cpp.md b/docs/mfc/activation-cpp.md index 89aafcdbd30..d40b7871b57 100644 --- a/docs/mfc/activation-cpp.md +++ b/docs/mfc/activation-cpp.md @@ -3,10 +3,12 @@ description: "Learn more about: Activation (C++)" title: "Activation (C++)" ms.date: "11/04/2016" helpviewer_keywords: ["OLE server applications [MFC], activation", "OLE items [MFC], visual editing", "activation [MFC]", "OLE [MFC], in-place activation", "OLE [MFC], activation", "in-place activation, embedded and linked items", "activating objects", "visual editing, activation", "visual editing", "documents [MFC], OLE", "embedded objects [MFC]", "OLE [MFC], editing", "in-place activation", "activation [MFC], embedded OLE items", "OLE activation [MFC]"] -ms.assetid: ed8357d9-e487-4aaa-aa6b-2edc4de25dfa --- # Activation (C++) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the role of activation in the visual editing of OLE items. After a user has embedded an OLE item in a container document, it may need to be used. To do this, the user double-clicks the item, which activates that item. The most frequent activity for activation is editing. Many current OLE items, when activated for editing, cause the menus and toolbars in the current frame window to change to reflect those belonging to the server application that created the item. This behavior, known as in-place activation, allows the user to edit any embedded item in a compound document without leaving the container document's window. It is also possible to edit embedded OLE items in a separate window. This will happen if either the container or server application does not support in-place activation. In this case, when the user double-clicks an embedded item, the server application is launched in a separate window and the embedded item appears as its own document. The user edits the item in this window. When editing is complete, the user closes the server application and returns to the container application. diff --git a/docs/mfc/activation-verbs.md b/docs/mfc/activation-verbs.md index 31e35ddfed5..44f8e4f2030 100644 --- a/docs/mfc/activation-verbs.md +++ b/docs/mfc/activation-verbs.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["verbs [MFC]", "OLE [MFC], activation", "edit verb [MFC]", --- # Activation: Verbs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the role primary and secondary verbs play in OLE [activation](activation-cpp.md). Usually, double-clicking an embedded item allows the user to edit it. However, certain items do not behave this way. For example, double-clicking an item created with the Sound Recorder application does not open the server in a separate window; instead, it plays the sound. diff --git a/docs/mfc/active-document-classes.md b/docs/mfc/active-document-classes.md index b5d917abefd..2e21e90ff3e 100644 --- a/docs/mfc/active-document-classes.md +++ b/docs/mfc/active-document-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Active Document Classes" title: "Active Document Classes" ms.date: "11/04/2016" helpviewer_keywords: ["Active document classes [MFC]"] -ms.assetid: cc20af37-b658-406d-8148-7670737f4c03 --- # Active Document Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Active documents can be displayed either in the entire client window of a Web browser, such as Internet Explorer 5.5, or in an Active container, such as the Microsoft Office Binder, that supports Active documents. [CDocObjectServer](reference/cdocobjectserver-class.md)
diff --git a/docs/mfc/active-document-containers.md b/docs/mfc/active-document-containers.md index 1a73274136f..04fd6aedac2 100644 --- a/docs/mfc/active-document-containers.md +++ b/docs/mfc/active-document-containers.md @@ -3,10 +3,12 @@ description: "Learn more about: Active Document Containers" title: "Active Document Containers" ms.date: "11/19/2018" helpviewer_keywords: ["active documents [MFC], containers", "active document containers [MFC]", "containers [MFC], active document", "MFC COM, active document containment"] -ms.assetid: ba20183a-8b4c-440f-9031-e5fcc41d391b --- # Active Document Containers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An active document container, such as Microsoft Office Binder or Internet Explorer, allows you to work with several documents of different application types within a single frame (instead of forcing you to create and use multiple application frames for each document type). MFC provides full support for active document containers in the `COleDocObjectItem` class. You can use the MFC Application Wizard to create an active document container by selecting the **Active document container** check box on the **Compound Document Support** page of the MFC Application Wizard. For more information, see [Creating an Active Document Container Application](creating-an-active-document-container-application.md). diff --git a/docs/mfc/active-document-containment.md b/docs/mfc/active-document-containment.md index 0220c7fe079..457e75cb97b 100644 --- a/docs/mfc/active-document-containment.md +++ b/docs/mfc/active-document-containment.md @@ -3,10 +3,12 @@ description: "Learn more about: Active Document Containment" title: "Active Document Containment" ms.date: "11/04/2016" helpviewer_keywords: ["active documents [MFC], containers", "containers [MFC], active document", "MFC, COM support", "active document containers [MFC], about active document containers", "MFC COM, active document containment"] -ms.assetid: b8dfa74b-75ce-47df-b75e-fc87b7f7d687 --- # Active Document Containment +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Active document containment is a technology that provides a single frame in which to work with documents, instead of forcing you to create and use multiple application frames for each document type. It differs from basic OLE technology in that OLE works with embedded objects within a compound document in which only a single piece of content can be active. With active document containment, you activate an entire document (that is, an entire application, including associated menus, toolbars, and so on) within the context of a single frame. The active document containment technology was originally developed for Microsoft Office to implement Office Binder. However, the technology is flexible enough to support active document containers other than Office Binder and can support document servers other than Office and Office-compatible applications. diff --git a/docs/mfc/active-document-servers.md b/docs/mfc/active-document-servers.md index e277d81825e..441a9c8f1be 100644 --- a/docs/mfc/active-document-servers.md +++ b/docs/mfc/active-document-servers.md @@ -3,10 +3,12 @@ description: "Learn more about: Active Document Servers" title: "Active Document Servers" ms.date: "11/04/2016" helpviewer_keywords: ["active documents [MFC], servers", "servers [MFC], active document", "active document servers [MFC]"] -ms.assetid: 131fec1e-02a0-4305-a7ab-903b911232a7 --- # Active Document Servers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Active document servers such as Word, Excel, or PowerPoint host documents of other application types called active documents. Unlike OLE embedded objects (which are simply displayed within the page of another document), Active documents provide the full interface and complete native functionality of the server application that creates them. Users can create documents using the full power of their favorite applications (if they are active document enabled), yet can treat the resulting project as a single entity. Active documents can have more than one page and are always in-place active. Active documents control part of the user interface, merging their menus with the **File** and **Help** menus of the container. They occupy the entire editing area of the container and control the views and the layout of the printer page (margins, footers, and so on). diff --git a/docs/mfc/active-documents.md b/docs/mfc/active-documents.md index bbaebd0e747..235ed0d653c 100644 --- a/docs/mfc/active-documents.md +++ b/docs/mfc/active-documents.md @@ -3,10 +3,12 @@ description: "Learn more about: Active Documents" title: "Active Documents" ms.date: "11/04/2016" helpviewer_keywords: ["active documents [MFC]", "active documents [MFC], requirements", "view objects [MFC], requirements", "OLE [MFC], active documents", "views [MFC], active documents", "active documents [MFC], views"] -ms.assetid: 1378f18e-aaa6-420b-8501-4b974905baa0 --- # Active Documents +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Active documents extend the compound document technology of OLE. These extensions are provided in the form of additional interfaces that manage views, so that objects can function within containers and yet retain control over their display and printing functions. This process makes it possible to display documents both in foreign frames (such as the Microsoft Office Binder or Microsoft Internet Explorer) and in native frames (such as the product's own view ports). This section describes the functional [requirements for active documents](#requirements_for_active_documents). The active document owns a set of data and has access to storage where the data can be saved and retrieved. It can create and manage one or more views on its data. In addition to supporting the usual embedding and in-place activation interfaces of OLE documents, the active document communicates its ability to create views through `IOleDocument`. Through this interface, the container can ask to create (and possibly enumerate) the views that the active document can display. Through this interface, the active document can also provide miscellaneous information about itself, such as whether it supports multiple views or complex rectangles. diff --git a/docs/mfc/active-technology-on-the-internet.md b/docs/mfc/active-technology-on-the-internet.md index 6a0a0ae5513..18e010b6426 100644 --- a/docs/mfc/active-technology-on-the-internet.md +++ b/docs/mfc/active-technology-on-the-internet.md @@ -3,10 +3,12 @@ description: "Learn more about: Active Technology on the Internet" title: "Active Technology on the Internet" ms.date: "09/12/2018" helpviewer_keywords: ["Internet applications [MFC], Active technology"] -ms.assetid: 6f782aa1-5c2f-47a2-9e63-ddd0829d5a08 --- # Active Technology on the Internet +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Active technology is an open platform that lets developers create exciting, dynamic content and applications for the global Internet, or for a company's internal network, known as an intranet. The major technologies provided by Microsoft for Internet programming are described below. >[!IMPORTANT] diff --git a/docs/mfc/activex-control-containers-connecting-an-activex-control-to-a-member-variable.md b/docs/mfc/activex-control-containers-connecting-an-activex-control-to-a-member-variable.md index 1fa92bf4510..cd88ec1938a 100644 --- a/docs/mfc/activex-control-containers-connecting-an-activex-control-to-a-member-variable.md +++ b/docs/mfc/activex-control-containers-connecting-an-activex-control-to-a-member-variable.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Control Containers: Connecting an Active title: "ActiveX Control Containers: Connecting an ActiveX Control to a Member Variable" ms.date: "11/04/2016" helpviewer_keywords: ["ActiveX control containers [MFC], accessing ActiveX controls", "ActiveX controls [MFC], member variables of project", "connecting ActiveX controls to container member variables", "ActiveX controls [MFC], accessing", "member variables [MFC], ActiveX controls in project", "ActiveX control containers [MFC], ActiveX controls as member variables"] -ms.assetid: 7898a336-440d-4a60-be43-cb062b807aee --- # ActiveX Control Containers: Connecting an ActiveX Control to a Member Variable +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The easiest way to access an ActiveX control from within its control container application is to associate the ActiveX control with a member variable of the dialog class that will contain the control. > [!NOTE] diff --git a/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md b/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md index 90af06c7fc7..acd9cb66f89 100644 --- a/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md +++ b/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Control Containers: Handling Events from title: "ActiveX Control Containers: Handling Events from an ActiveX Control" ms.date: "09/12/2018" helpviewer_keywords: ["event handlers [MFC], ActiveX controls", "ActiveX control containers [MFC], event sinks", "event handling [MFC], ActiveX controls", "ON_EVENT macro [MFC]", "ActiveX controls [MFC], events [MFC]", "END_EVENTSINK_MAP macro, using", "events [MFC], ActiveX controls", "BEGIN_EVENTSINK_MAP macro"] -ms.assetid: f9c106db-052f-4e32-82ad-750646aa760b --- # ActiveX Control Containers: Handling Events from an ActiveX Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses using the **Properties** window (in **Class View**) to install event handlers for ActiveX controls in an ActiveX control container. The event handlers are used to receive notifications (from the control) of certain events and perform some action in response. This notification is called "firing" the event. >[!IMPORTANT] diff --git a/docs/mfc/activex-control-containers-manually-enabling-activex-control-containment.md b/docs/mfc/activex-control-containers-manually-enabling-activex-control-containment.md index f4e37044710..f7cb6480473 100644 --- a/docs/mfc/activex-control-containers-manually-enabling-activex-control-containment.md +++ b/docs/mfc/activex-control-containers-manually-enabling-activex-control-containment.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Control Containers: Manually Enabling Ac title: "ActiveX Control Containers: Manually Enabling ActiveX Control Containment" ms.date: "09/12/2018" helpviewer_keywords: ["AfxEnableControlContainer method [MFC]", "ActiveX control containers [MFC], enabling", "ActiveX controls [MFC], enabling containers"] -ms.assetid: 833bcde9-c9ad-4709-ad12-2fc2150fb6a5 --- # ActiveX Control Containers: Manually Enabling ActiveX Control Containment +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you did not enable ActiveX control support when you used the MFC Application Wizard to generate your application, you will have to add this support manually. This article describes the process for manually adding ActiveX control containment to an existing OLE container application. If you know in advance that you want ActiveX control support in your OLE container, see the article [Creating an MFC ActiveX Control Container](reference/creating-an-mfc-activex-control-container.md). >[!IMPORTANT] diff --git a/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md b/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md index 5c203ddbf53..516e4ac55a1 100644 --- a/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md +++ b/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Control Containers: Using Controls in a title: "ActiveX Control Containers: Using Controls in a Non-Dialog Container" ms.date: "11/04/2016" helpviewer_keywords: ["Create method [MFC], ActiveX controls", "CreateControl method [MFC]", "ActiveX controls [MFC], creating", "ActiveX control containers [MFC], non-dialog containers", "ActiveX control containers [MFC], inserting controls"] -ms.assetid: 46f195b0-b8ca-4409-8cca-fbfaf2c9ab9f --- # ActiveX Control Containers: Using Controls in a Non-Dialog Container +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In some applications, such as an SDI or MDI application, you will want to embed a control in a window of the application. The **Create** member function of the wrapper class, inserted by Visual Studio, can create an instance of the control dynamically, without the need for a dialog box. The **Create** member function has the following parameters: diff --git a/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md b/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md index 2cd819edbd2..201a108b84d 100644 --- a/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md +++ b/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Control Containers: Viewing and Modifyin title: "ActiveX Control Containers: Viewing and Modifying Control Properties" ms.date: "11/04/2016" helpviewer_keywords: ["properties [MFC], viewing and modifying", "ActiveX control containers [MFC], viewing and modifying properties", "resource editors, viewing and modifying ActiveX controls", "ActiveX controls [MFC], properties", "controls [MFC], properties"] -ms.assetid: 14ce5152-742b-4e0d-a9ab-c7b456e32918 --- # ActiveX Control Containers: Viewing and Modifying Control Properties +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you insert an ActiveX control into a project, it is useful to view and change the properties supported by the ActiveX control. This article discusses how to use the Visual Studio resource editor to do this. If your ActiveX control container application uses embedded controls, you can view and modify the control's properties while in the resource editor. You can also use the resource editor to set property values during design time. The resource editor then automatically saves these values in the project's resource file. Any instance of the control will then have its properties initialized to these values. diff --git a/docs/mfc/activex-control-containers.md b/docs/mfc/activex-control-containers.md index 25f68beb623..30261c43b4f 100644 --- a/docs/mfc/activex-control-containers.md +++ b/docs/mfc/activex-control-containers.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Control Containers" title: "ActiveX Control Containers" ms.date: "09/12/2018" helpviewer_keywords: ["ActiveX control containers [MFC]", "OLE controls [MFC], containers"] -ms.assetid: 0eb1a713-e607-4c79-a0c7-67c5f1fd5fab --- # ActiveX Control Containers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An ActiveX control container is a container that fully supports ActiveX controls and can incorporate them into its own windows or dialogs. An ActiveX control is a reusable software element that you can use in many development projects. Controls allow your application's user to access databases, monitor data, and make various selections within your applications. For more information on ActiveX controls, see the article [MFC ActiveX Controls](mfc-activex-controls.md). >[!IMPORTANT] diff --git a/docs/mfc/activex-controls-on-the-internet.md b/docs/mfc/activex-controls-on-the-internet.md index 9a73da8ce82..915bab82eb5 100644 --- a/docs/mfc/activex-controls-on-the-internet.md +++ b/docs/mfc/activex-controls-on-the-internet.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Controls on the Internet" title: "ActiveX Controls on the Internet" ms.date: "09/12/2018" helpviewer_keywords: ["ActiveX controls [MFC], creating", "ActiveX controls [MFC], Internet", "downloading data with ActiveX controls", "OLE controls [MFC], upgrading to ActiveX", "Internet applications [MFC], ActiveX controls", "networks [MFC], downloading with ActiveX controls"] -ms.assetid: 7ab943c8-2022-41df-9065-d629b616eeec --- # ActiveX Controls on the Internet +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + ActiveX controls are the updated version of the OLE control specification. >[!IMPORTANT] diff --git a/docs/mfc/activex-controls.md b/docs/mfc/activex-controls.md index a2beb263314..6dcea4cccbb 100644 --- a/docs/mfc/activex-controls.md +++ b/docs/mfc/activex-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Controls" title: "ActiveX Controls" ms.date: "09/12/2018" helpviewer_keywords: ["ActiveX controls [MFC]"] -ms.assetid: 52aaec4d-3889-402e-b57d-758078f8ac57 --- # ActiveX Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In Visual Studio you can create ActiveX controls using MFC or ATL. >[!IMPORTANT] diff --git a/docs/mfc/adding-columns-to-the-control-report-view.md b/docs/mfc/adding-columns-to-the-control-report-view.md index 829a912284b..825e9915515 100644 --- a/docs/mfc/adding-columns-to-the-control-report-view.md +++ b/docs/mfc/adding-columns-to-the-control-report-view.md @@ -3,11 +3,13 @@ description: "Learn more about: Adding Columns to the Control (Report View)" title: "Adding Columns to the Control (Report View)" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], adding columns", "report view in CListCtrl class [MFC]", "views [MFC], report", "columns [MFC], adding to CListCtrl", "CListCtrl class [MFC], report view"] -ms.assetid: 7392c0d7-f8a5-4e7b-9ae7-b53dc9dd80ae ms.topic: concept-article --- # Adding Columns to the Control (Report View) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following procedure applies to either a [CListView](reference/clistview-class.md) or [CListCtrl](reference/clistctrl-class.md) object. diff --git a/docs/mfc/adding-controls-by-hand.md b/docs/mfc/adding-controls-by-hand.md index 8945ca7e2a3..1ccec0f6760 100644 --- a/docs/mfc/adding-controls-by-hand.md +++ b/docs/mfc/adding-controls-by-hand.md @@ -3,11 +3,13 @@ description: "Learn more about: Adding Controls By Hand" title: "Adding Controls By Hand" ms.date: "11/04/2016" helpviewer_keywords: ["Windows common controls [MFC], adding", "dialog box controls [MFC], adding to dialog boxes", "controlling input focus", "input focus control", "focus, controlling input [MFC]", "controls [MFC], adding to dialog boxes", "common controls [MFC], adding"] -ms.assetid: bc843e59-0c51-4b5b-8bf2-343f716469d2 ms.topic: concept-article --- # Adding Controls By Hand +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can either [add controls to a dialog box with the dialog editor](using-the-dialog-editor-to-add-controls.md) or add them yourself, with code. To create a control object yourself, you will usually embed the C++ control object in a C++ dialog or frame-window object. Like many other objects in the framework, controls require two-stage construction. You should call the control's **Create** member function as part of creating the parent dialog box or frame window. For dialog boxes, this is usually done in [OnInitDialog](reference/cdialog-class.md#oninitdialog), and for frame windows, in [OnCreate](reference/cwnd-class.md#oncreate). diff --git a/docs/mfc/adding-controls-to-a-property-sheet.md b/docs/mfc/adding-controls-to-a-property-sheet.md index f9fd7130061..c9f162f38b7 100644 --- a/docs/mfc/adding-controls-to-a-property-sheet.md +++ b/docs/mfc/adding-controls-to-a-property-sheet.md @@ -3,11 +3,13 @@ description: "Learn more about: Adding Controls to a Property Sheet" title: "Adding Controls to a Property Sheet" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], adding to property sheets", "property sheets, adding controls"] -ms.assetid: 24ad4c0b-c1db-4850-b9f0-34aae8d74571 ms.topic: concept-article --- # Adding Controls to a Property Sheet +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + By default, a property sheet allocates window area for the property pages, the tab index, and the OK, Cancel, and Apply buttons. (A modeless property sheet does not have the OK, Cancel, and Apply buttons.) You can add other controls to the property sheet. For example, you can add a preview window to the right of the property page area to show the user what the current settings would look like if applied to an external object. You can add controls to the property sheet dialog in the `OnCreate` handler. Accommodating additional controls usually requires expanding the size of the property sheet dialog. After calling the base class **CPropertySheet::OnCreate**, call [GetWindowRect](reference/cwnd-class.md#getwindowrect) to get the width and height of the currently allocated property sheet window, expand the rectangle's dimensions, and call [MoveWindow](reference/cwnd-class.md#movewindow) to change the size of the property sheet window. diff --git a/docs/mfc/adding-items-to-the-control.md b/docs/mfc/adding-items-to-the-control.md index 9019df5d8f5..8d8a14a0003 100644 --- a/docs/mfc/adding-items-to-the-control.md +++ b/docs/mfc/adding-items-to-the-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Adding Items to the Control" title: "Adding Items to the Control" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], adding items"] -ms.assetid: 715994bd-340d-4ad2-9882-411654137830 ms.topic: concept-article --- # Adding Items to the Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To add items to the list control ([CListCtrl](reference/clistctrl-class.md)), call one of several versions of the [InsertItem](reference/clistctrl-class.md#insertitem) member function, depending on what information you have. One version takes a [LVITEM](/windows/win32/api/commctrl/ns-commctrl-lvitemw) structure that you prepare. Because the `LVITEM` structure contains numerous members, you have greater control over the attributes of the list control item. Two important members (in regard to the report view) of the `LVITEM` structure are the `iItem` and `iSubItem` members. The `iItem` member is the zero-based index of the item the structure is referencing and the `iSubItem` member is the one-based index of a subitem, or zero if the structure contains information about an item. With these two members you determine, per item, the type and value of subitem information that is displayed when the list control is in report view. For more information, see [CListCtrl::SetItem](reference/clistctrl-class.md#setitem). diff --git a/docs/mfc/adding-items-to-the-header-control.md b/docs/mfc/adding-items-to-the-header-control.md index ad9b3d20dc5..359e8a45b4f 100644 --- a/docs/mfc/adding-items-to-the-header-control.md +++ b/docs/mfc/adding-items-to-the-header-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Adding Items to the Header Control" title: "Adding Items to the Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], header", "CHeaderCtrl class [MFC], adding items", "header controls [MFC], adding items to"] -ms.assetid: 2e9a28b1-7302-4a93-8037-c5a4183e589a ms.topic: how-to --- # Adding Items to the Header Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + After creating your header control ([CHeaderCtrl](reference/cheaderctrl-class.md)) in its parent window, add as many "header items" as you need: usually one per column. ### To add a header item diff --git a/docs/mfc/adding-multiple-views-to-a-single-document.md b/docs/mfc/adding-multiple-views-to-a-single-document.md index b8e7fd427b4..500f35c74f9 100644 --- a/docs/mfc/adding-multiple-views-to-a-single-document.md +++ b/docs/mfc/adding-multiple-views-to-a-single-document.md @@ -3,11 +3,13 @@ description: "Learn more about: Adding Multiple Views to a Single Document" title: "Adding Multiple Views to a Single Document" ms.date: "11/04/2016" helpviewer_keywords: ["multiple views [MFC], SDI applications", "documents [MFC], multiple views", "single document interface (SDI), adding views", "views [MFC], SDI applications"] -ms.assetid: 86d0c134-01d5-429c-b672-36cfb956dc01 ms.topic: concept-article --- # Adding Multiple Views to a Single Document +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In a single-document interface (SDI) application created with the Microsoft Foundation Class (MFC) Library, each document type is associated with a single view type. In some cases, it is desirable to have the ability to switch the current view of a document with a new view. > [!TIP] diff --git a/docs/mfc/adding-tabs-to-a-tab-control.md b/docs/mfc/adding-tabs-to-a-tab-control.md index b4312763c36..860f6ce1ea2 100644 --- a/docs/mfc/adding-tabs-to-a-tab-control.md +++ b/docs/mfc/adding-tabs-to-a-tab-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Adding Tabs to a Tab Control" title: "Adding Tabs to a Tab Control" ms.date: "11/04/2016" helpviewer_keywords: ["tab controls [MFC], adding tabs", "putting tabs on CTabCtrls [MFC]", "CTabCtrl class [MFC], adding tabs", "tabs [MFC], adding to CTabCtrl class [MFC]"] -ms.assetid: 7f3d9340-e3c7-4c71-9912-be57534ecc78 ms.topic: how-to --- # Adding Tabs to a Tab Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + After creating the tab control ([CTabCtrl](reference/ctabctrl-class.md)), add as many tabs as you need. ### To add a tab item diff --git a/docs/mfc/advantages-of-the-document-view-architecture.md b/docs/mfc/advantages-of-the-document-view-architecture.md index 68755dbc77f..5baaa817716 100644 --- a/docs/mfc/advantages-of-the-document-view-architecture.md +++ b/docs/mfc/advantages-of-the-document-view-architecture.md @@ -3,10 +3,12 @@ description: "Learn more about: Advantages of the Document/View Architecture" title: "Advantages of the Document-View Architecture" ms.date: "11/04/2016" helpviewer_keywords: ["views [MFC], advantages", "document/view architecture [MFC], advantages of"] -ms.assetid: 0bc27071-e120-4889-939c-ce1e61fb9cb3 --- # Advantages of the Document/View Architecture +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The key advantage to using the MFC document/view architecture is that the architecture supports multiple views of the same document particularly well. (If you don't need multiple views and the small overhead of document/view is excessive in your application, you can avoid the architecture. [Alternatives to the Document/View Architecture](alternatives-to-the-document-view-architecture.md).) Suppose your application lets users view numerical data either in spreadsheet form or in chart form. A user might want to see simultaneously both the raw data, in spreadsheet form, and a chart that results from the data. You display these separate views in separate frame windows or in splitter panes within a single window. Now suppose the user can edit the data in the spreadsheet and see the changes instantly reflected in the chart. diff --git a/docs/mfc/allocating-and-deallocating-window-memory.md b/docs/mfc/allocating-and-deallocating-window-memory.md index 5e5645446a9..c8fb0b9f318 100644 --- a/docs/mfc/allocating-and-deallocating-window-memory.md +++ b/docs/mfc/allocating-and-deallocating-window-memory.md @@ -3,11 +3,13 @@ description: "Learn more about: Allocating and Deallocating Window Memory" title: "Allocating and Deallocating Window Memory" ms.date: "11/04/2016" helpviewer_keywords: ["memory allocation, window objects", "memory deallocation", "storage for window objects [MFC]", "memory deallocation, window memory", "window objects [MFC], deallocating memory for", "storage for window objects [MFC], allocating"] -ms.assetid: 7c962539-8461-4846-b5ca-fe3b15c313dc ms.topic: concept-article --- # Allocating and Deallocating Window Memory +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Do not use the C++ **`delete`** operator to destroy a frame window or view. Instead, call the `CWnd` member function `DestroyWindow`. Frame windows, therefore, should be allocated on the heap with operator **`new`**. Be careful when allocating frame windows on the stack frame or globally. Other windows should be allocated on the stack frame whenever possible. ## What do you want to know more about diff --git a/docs/mfc/allocating-gdi-resources.md b/docs/mfc/allocating-gdi-resources.md index d9b1a739458..fb4dc60d44d 100644 --- a/docs/mfc/allocating-gdi-resources.md +++ b/docs/mfc/allocating-gdi-resources.md @@ -3,11 +3,13 @@ description: "Learn more about: Allocating GDI Resources" title: "Allocating GDI Resources" ms.date: "06/03/2019" helpviewer_keywords: ["resources [MFC], printing", "GDI objects [MFC], allocating during printing", "printing [MFC], allocating GDI resources"] -ms.assetid: cef7e94d-5a27-4aea-a9ee-8369fc895d3a ms.topic: concept-article --- # Allocating GDI Resources +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to allocate and deallocate the Windows graphics device interface (GDI) objects needed for printing. > [!NOTE] diff --git a/docs/mfc/alternatives-to-the-document-view-architecture.md b/docs/mfc/alternatives-to-the-document-view-architecture.md index b89b6dbc905..aea82ec47b9 100644 --- a/docs/mfc/alternatives-to-the-document-view-architecture.md +++ b/docs/mfc/alternatives-to-the-document-view-architecture.md @@ -3,10 +3,12 @@ description: "Learn more about: Alternatives to the Document/View Architecture" title: "Alternatives to the Document-View Architecture" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], applications without", "CDocument class [MFC], space requirements", "views [MFC], applications without"] -ms.assetid: 2c22f352-a137-45ce-9971-c142173496fb --- # Alternatives to the Document/View Architecture +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC applications normally use the document/view architecture to manage information, file formats, and the visual representation of data to users. For the majority of desktop applications, the document/view architecture is an appropriate and efficient application architecture. This architecture separates data from viewing and, in most cases, simplifies your application and reduces redundant code. However, the document/view architecture is not appropriate for some situations. Consider these examples: diff --git a/docs/mfc/application-and-thread-support-classes.md b/docs/mfc/application-and-thread-support-classes.md index b05bbbcc85f..dd028a163fd 100644 --- a/docs/mfc/application-and-thread-support-classes.md +++ b/docs/mfc/application-and-thread-support-classes.md @@ -4,10 +4,12 @@ title: "Application and Thread Support Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.support"] helpviewer_keywords: ["application objects [MFC], thread support classes", "lock classes [MFC]", "thread support classes [MFC]", "threading [MFC]", "synchronization classes [MFC], multithreading", "application support classes [MFC]"] -ms.assetid: 3c1d14fd-c35c-48f1-86ce-1e0f9a32c36d --- # Application and Thread Support Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Each application has one and only one application object; this object coordinates other objects in the running program and is derived from `CWinApp`. The Microsoft Foundation Class (MFC) Library supports multiple threads of execution within an application. All applications must have at least one thread; the thread used by your `CWinApp` object is this primary thread. diff --git a/docs/mfc/application-design-choices.md b/docs/mfc/application-design-choices.md index 398024a1216..c4d54447abd 100644 --- a/docs/mfc/application-design-choices.md +++ b/docs/mfc/application-design-choices.md @@ -3,10 +3,12 @@ description: "Learn more about: Application Design Choices" title: "Application Design Choices" ms.date: "09/12/2019" helpviewer_keywords: ["design", "application design [MFC], design goals", "application design [MFC], Internet applications", "Internet applications [MFC], designing applications", "Internet [MFC], vs. intranets", "applications [MFC], Internet", "server applications [MFC], vs. client applications on Internet", "client applications [MFC], vs. server applications on Internet"] -ms.assetid: 9b96172c-b4d4-4c69-bfb2-226ce0de6d08 --- # Application Design Choices +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses some of the design issues to consider when programming for the Internet. Topics covered in this article include: diff --git a/docs/mfc/application-framework.md b/docs/mfc/application-framework.md index 3d7b573f4a3..247ee9f23cd 100644 --- a/docs/mfc/application-framework.md +++ b/docs/mfc/application-framework.md @@ -3,10 +3,12 @@ description: "Learn more about: Application Framework" title: "Application Framework" ms.date: "11/04/2016" helpviewer_keywords: ["application framework [MFC], building applications", "applications [MFC]", "application framework [MFC]"] -ms.assetid: 912684e6-4418-49dc-9877-a4cd19d69d20 --- # Application Framework +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The core of the Microsoft Foundation Class (MFC) Library is an encapsulation of a large portion of the Windows API in C++ form. Library classes represent windows, dialog boxes, device contexts, common GDI objects such as brushes and pens, controls, and other standard Windows items. These classes provide a convenient C++ member function interface to the structures in Windows that they encapsulate. For more about using these classes, see [Window Object Topics](window-objects.md). But the MFC Library also supplies a layer of additional application functionality built on the C++ encapsulation of the Windows API. This layer is a working application framework for Windows that provides most of the common user interface expected of programs for Windows, including toolbars, status bars, printing, print preview, database support, and ActiveX support. [Using the Classes to Write Applications for Windows](using-the-classes-to-write-applications-for-windows.md) explains the framework in detail. diff --git a/docs/mfc/array-list-and-map-classes.md b/docs/mfc/array-list-and-map-classes.md index b0fa8481746..381ad523acb 100644 --- a/docs/mfc/array-list-and-map-classes.md +++ b/docs/mfc/array-list-and-map-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Array, List, and Map Classes" title: "Array, List, and Map Classes" ms.date: "11/04/2016" helpviewer_keywords: ["arrays [MFC], classes", "list classes [MFC]", "collection classes [MFC], maps", "map classes [MFC]", "collection classes [MFC], lists"] -ms.assetid: 81a13a7f-0c2c-4efd-b6bb-b4e624a0743d --- # Array, List, and Map Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For handling aggregates of data, the class library provides a group of collection classes — arrays, lists, and maps — that can hold a variety of object and predefined types. The collections are dynamically sized. These classes can be used in any program, whether written for Windows or not. However, they are most useful for implementing the data structures that define your document classes in the application framework. You can readily derive specialized collection classes from these, or you can create them based on the template classes. For more information about these approaches, see the article [Collections](collections.md). For a list of the template collection classes, see the article [Template Classes for Arrays, Lists, and Maps](template-classes-for-arrays-lists-and-maps.md). Arrays are one-dimensional data structures that are stored contiguously in memory. They support very fast random access since the memory address of any given element can be calculated by multiplying the index of the element by the size of an element and adding the result to the base address of the array. But arrays are very expensive if you have to insert elements into the array, since the entire array past the element inserted has to be moved to make room for the element to be inserted. Arrays can grow and shrink as necessary. diff --git a/docs/mfc/asynchronous-monikers-on-the-internet.md b/docs/mfc/asynchronous-monikers-on-the-internet.md index f9ea5ad99cd..0387ba229f9 100644 --- a/docs/mfc/asynchronous-monikers-on-the-internet.md +++ b/docs/mfc/asynchronous-monikers-on-the-internet.md @@ -3,10 +3,12 @@ description: "Learn more about: Asynchronous Monikers on the Internet" title: "Asynchronous Monikers on the Internet" ms.date: "11/04/2016" helpviewer_keywords: ["ActiveX controls [MFC], asynchronous", "MFC, asynchronous monikers", "asynchronous monikers [MFC]", "Web applications [MFC], asynchronous", "downloading Internet resources and asynchronous monikers", "optimization [MFC], asynchronous downloading across Internet", "Internet [MFC], asynchronous downloading"] -ms.assetid: 418b0c64-0046-4dae-8118-c9c762b5822e --- # Asynchronous Monikers on the Internet +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Internet requires new approaches to application design because of its slow network access. Applications should perform network access asynchronously to avoid stalling the user interface. The MFC class [CAsyncMonikerFile](reference/casyncmonikerfile-class.md) provides asynchronous support for downloading files. With asynchronous monikers, you can extend your COM application to download asynchronously across the Internet and to provide progressive rendering of large objects such as bitmaps and VRML objects. Asynchronous monikers enable an ActiveX control property or a file on the Internet to be downloaded without blocking the response of the user interface. diff --git a/docs/mfc/automation-clients-using-type-libraries.md b/docs/mfc/automation-clients-using-type-libraries.md index 4c8eb1cb81e..5f0c32dc7aa 100644 --- a/docs/mfc/automation-clients-using-type-libraries.md +++ b/docs/mfc/automation-clients-using-type-libraries.md @@ -4,10 +4,12 @@ title: "Automation Clients: Using Type Libraries" ms.date: "11/04/2016" f1_keywords: ["MkTypLib"] helpviewer_keywords: ["clients, Automation", "dispatch class [MFC]", "Automation clients, type libraries", "type libraries, Automation clients", "ODL (Object Description Language)", "ODL files", "classes [MFC], dispatch", "MkTypLib tool", ".odl files"] -ms.assetid: d405bc47-118d-4786-b371-920d035b2047 --- # Automation Clients: Using Type Libraries +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Automation clients must have information about server objects' properties and methods if the clients are to manipulate the servers' objects. Properties have data types; methods often return values and accept parameters. The client requires information about the data types of all of these in order to statically bind to the server object type. This type information can be made known in several ways. The recommended way is to create a type library. diff --git a/docs/mfc/automation-clients.md b/docs/mfc/automation-clients.md index 989c65eed90..f54f51f9a75 100644 --- a/docs/mfc/automation-clients.md +++ b/docs/mfc/automation-clients.md @@ -3,10 +3,12 @@ description: "Learn more about: Automation Clients" title: "Automation Clients" ms.date: "11/04/2016" helpviewer_keywords: ["clients, Automation", "Automation clients", "type libraries, Automation clients", "clients"] -ms.assetid: 84e34a79-06f6-4752-a33b-ae0ede1d8ecf --- # Automation Clients +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Automation makes it possible for your application to manipulate objects implemented in another application, or to expose objects so they can be manipulated. An Automation client is an application that can manipulate exposed objects belonging to another application. The application that exposes the objects is called the Automation server. The client manipulates the server application's objects by accessing those objects' properties and functions. ### Types of Automation Clients diff --git a/docs/mfc/automation-servers-object-lifetime-issues.md b/docs/mfc/automation-servers-object-lifetime-issues.md index 457ac5ea555..6f33844414c 100644 --- a/docs/mfc/automation-servers-object-lifetime-issues.md +++ b/docs/mfc/automation-servers-object-lifetime-issues.md @@ -3,10 +3,12 @@ description: "Learn more about: Automation Servers: Object-Lifetime Issues" title: "Automation Servers: Object-Lifetime Issues" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], lifetime", "lifetime, automation server", "Automation servers, object lifetime", "servers, lifetime of Automation"] -ms.assetid: 342baacf-4015-4a0e-be2f-321424f1cb43 --- # Automation Servers: Object-Lifetime Issues +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When an Automation client creates or activates an OLE item, the server passes the client a pointer to that object. The client establishes a reference to the object through a call to the OLE function [IUnknown::AddRef](/windows/win32/api/unknwn/nf-unknwn-iunknown-addref). This reference is in effect until the client calls [IUnknown::Release](/windows/win32/api/unknwn/nf-unknwn-iunknown-release). (Client applications written with the Microsoft Foundation Class Library's OLE classes need not make these calls; the framework does so.) The OLE system and the server itself may establish references to the object. A server should not destroy an object as long as external references to the object remain in effect. The framework maintains an internal count of the number of references to any server object derived from [CCmdTarget](reference/ccmdtarget-class.md). This count is updated when an Automation client or other entity adds or releases a reference to the object. diff --git a/docs/mfc/automation-servers.md b/docs/mfc/automation-servers.md index 848c8d97b37..18100344f5f 100644 --- a/docs/mfc/automation-servers.md +++ b/docs/mfc/automation-servers.md @@ -3,10 +3,12 @@ description: "Learn more about: Automation Servers" title: "Automation Servers" ms.date: "11/04/2016" helpviewer_keywords: ["Automation servers", "COM components, Automation servers", "dispatch maps [MFC], Automation servers", "servers, Automation"] -ms.assetid: 523fd155-51ce-4f91-b986-b74bdbdd7d92 --- # Automation Servers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Automation makes it possible for your application to manipulate objects implemented in another application, or to expose objects so they can be manipulated. An Automation server is an application that exposes programmable objects (called Automation objects) to other applications (called [Automation clients](automation-clients.md)). Automation servers are sometimes called Automation components. Exposing Automation objects enables clients to automate certain procedures by directly accessing the objects and functionality the server makes available. Exposing objects this way is beneficial when applications provide functionality that is useful for other applications. For example, a word processor might expose its spell-checking functionality so that other programs can use it. Exposure of objects thus enables vendors to improve their applications' functionality by using the ready-made functionality of other applications. diff --git a/docs/mfc/automation.md b/docs/mfc/automation.md index 9951fd3eff3..82f2e62b4e8 100644 --- a/docs/mfc/automation.md +++ b/docs/mfc/automation.md @@ -3,10 +3,12 @@ description: "Learn more about: Automation" title: "Automation" ms.date: "11/04/2016" helpviewer_keywords: ["Automation servers, about Automation servers", "clients, Automation", "programmatic control [MFC]", "properties [MFC], Automation", "MFC, COM support", "OLE Automation", "Automation", "servers [MFC], Automation", "Automation clients", "sample applications [MFC], Automation", "methods [MFC]", "passing parameters, Automation", "Automation method [MFC]", "Automation, passing parameters", "Automation property [MFC]", "MFC COM, Automation", "methods [MFC], Automation"] -ms.assetid: 329117f0-c1aa-4680-a901-bfb71277dfba --- # Automation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Automation (formerly known as OLE Automation) makes it possible for one application to manipulate objects implemented in another application, or to expose objects so they can be manipulated. An [Automation server](automation-servers.md) is an application (a type of COM server) that exposes its functionality through COM interfaces to other applications, called [Automation clients](automation-clients.md). The exposure enables Automation clients to automate certain functions by directly accessing objects and using the services they provide. diff --git a/docs/mfc/bottomless-rich-edit-controls.md b/docs/mfc/bottomless-rich-edit-controls.md index c157bbf3bd6..a967cd0b048 100644 --- a/docs/mfc/bottomless-rich-edit-controls.md +++ b/docs/mfc/bottomless-rich-edit-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Bottomless Rich Edit Controls" title: "Bottomless Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["bottomless rich edit controls", "rich edit controls [MFC], bottomless", "CRichEditCtrl class [MFC], bottomless"] -ms.assetid: 2877dd32-1e9a-4fd1-98c0-66dcbbeef1de --- # Bottomless Rich Edit Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Your application can resize a rich edit control ([CRichEditCtrl](reference/cricheditctrl-class.md)) as needed so that it is always the same size as its contents. A rich edit control supports this so-called "bottomless" functionality by sending its parent window an [EN_REQUESTRESIZE](/windows/win32/Controls/en-requestresize) notification message whenever the size of its contents changes. When processing the **EN_REQUESTRESIZE** notification message, an application should resize the control to the dimensions in the specified [REQRESIZE](/windows/win32/api/richedit/ns-richedit-reqresize) structure. An application might also move any information near the control to accommodate the control's change in height. To resize the control, you can use the `CWnd` function [SetWindowPos](reference/cwnd-class.md#setwindowpos). diff --git a/docs/mfc/build-requirements-for-windows-vista-common-controls.md b/docs/mfc/build-requirements-for-windows-vista-common-controls.md index 1120d633c74..b54c1c9796d 100644 --- a/docs/mfc/build-requirements-for-windows-vista-common-controls.md +++ b/docs/mfc/build-requirements-for-windows-vista-common-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Build Requirements for Windows Common Controls" title: "Build Requirements for Windows Common Controls" ms.date: "08/19/2019" helpviewer_keywords: ["Common Controls (MFC), build requirements", "Common Controls (MFC)"] -ms.assetid: 025f7d55-55a2-4dcd-8f62-02424e3dcc04 ms.topic: how-to --- # Build Requirements for Windows Common Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class (MFC) library supports [Windows Common Controls](/windows/win32/controls/common-controls-intro). The Common Controls are included in Windows and the library is included in Visual Studio. The MFC library provides new methods that enhance existing classes, and additional classes and methods that support Windows Common Controls. When you build your application, you should follow the compilation and migration requirements that are described in the following sections. ## Compilation Requirements diff --git a/docs/mfc/building-on-the-framework.md b/docs/mfc/building-on-the-framework.md index 7b339c588e9..e11f3d9f318 100644 --- a/docs/mfc/building-on-the-framework.md +++ b/docs/mfc/building-on-the-framework.md @@ -3,11 +3,13 @@ description: "Learn more about: Building on the Framework" title: "Building on the Framework" ms.date: "11/04/2016" helpviewer_keywords: ["application-specific classes [MFC]", "application framework [MFC], building applications", "applications [MFC]", "MFC, application development"] -ms.assetid: 883f0f19-866f-4221-8a3d-5607941dc8d0 ms.topic: concept-article --- # Building on the Framework +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Your role in configuring an application with the MFC framework is to supply the application-specific source code and to connect the components by defining what messages and commands to which they respond. You use the C++ language and standard C++ techniques to derive your own application-specific classes from those supplied by the class library and to override and augment the base class's behavior. In related topics, the following tables describe the general sequence of operations you will typically follow and your responsibilities versus the framework's responsibilities: diff --git a/docs/mfc/bypassing-the-serialization-mechanism.md b/docs/mfc/bypassing-the-serialization-mechanism.md index 045392c70cc..0ea67bc23c5 100644 --- a/docs/mfc/bypassing-the-serialization-mechanism.md +++ b/docs/mfc/bypassing-the-serialization-mechanism.md @@ -3,11 +3,13 @@ description: "Learn more about: Bypassing the Serialization Mechanism" title: "Bypassing the Serialization Mechanism" ms.date: "11/04/2016" helpviewer_keywords: ["archive objects [MFC]", "bypassing serialization", "archives [MFC], serialization", "serialization [MFC], bypassing", "archives [MFC]", "serialization [MFC], role of framework", "serialization [MFC], overriding"] -ms.assetid: 48d4a279-b51c-4ba5-81cd-ed043312b582 ms.topic: concept-article --- # Bypassing the Serialization Mechanism +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As you have seen, the framework provides a default way to read and write data to and from files. Serializing through an archive object suits the needs of a great many applications. Such an application reads a file entirely into memory, lets the user update the file, and then writes the updated version to disk again. However, some applications operate on data very differently, and for these applications serialization through an archive is not suitable. Examples include database programs, programs that edit only parts of large files, programs that write text-only files, and programs that share data files. diff --git a/docs/mfc/callback-items-and-the-callback-mask.md b/docs/mfc/callback-items-and-the-callback-mask.md index d94e970a78f..b130b9c51b1 100644 --- a/docs/mfc/callback-items-and-the-callback-mask.md +++ b/docs/mfc/callback-items-and-the-callback-mask.md @@ -3,10 +3,12 @@ description: "Learn more about: Callback Items and the Callback Mask" title: "Callback Items and the Callback Mask" ms.date: "11/04/2016" helpviewer_keywords: ["callback items in CListCtrl class [MFC]", "CListCtrl class [MFC], callback item and callback mask"] -ms.assetid: 67c1f76f-6144-453e-9376-6712f89430ae --- # Callback Items and the Callback Mask +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For each of its items, a list view control typically stores the label text, the image list index of the item's icons, and a set of bit flags for the item's state. You can define individual items as callback items, which are useful if your application already stores some of the information for an item. You define an item as a callback item by specifying appropriate values for the `pszText` and `iImage` members of the `LVITEM` structure (see [CListCtrl::GetItem](reference/clistctrl-class.md#getitem)). If the application maintains the item's or subitem's text, specify the **LPSTR_TEXTCALLBACK** value for the `pszText` member. If the application keeps track of the icon for the item, specify the **I_IMAGECALLBACK** value for the `iImage` member. diff --git a/docs/mfc/changing-list-control-styles.md b/docs/mfc/changing-list-control-styles.md index 3f64060811f..3dbf36eb17a 100644 --- a/docs/mfc/changing-list-control-styles.md +++ b/docs/mfc/changing-list-control-styles.md @@ -3,11 +3,13 @@ description: "Learn more about: Changing List Control Styles" title: "Changing List Control Styles" ms.date: "11/04/2016" helpviewer_keywords: ["styles [MFC], CListCtrl", "CListCtrl class [MFC], styles", "CListCtrl class [MFC], changing styles"] -ms.assetid: be74a005-0795-417c-9056-f6342aa74b26 ms.topic: concept-article --- # Changing List Control Styles +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can change the window style of a list control ([CListCtrl](reference/clistctrl-class.md)) at any time after you create it. By changing the window style, you change the kind of view the control uses. For example, to emulate the Explorer, you might supply menu items or toolbar buttons for switching the control between different views: icon view, list view, and so on. For example, when the user selects your menu item, you could make a call to [GetWindowLong](/windows/win32/api/winuser/nf-winuser-getwindowlongw) to retrieve the current style of the control and then call [SetWindowLong](/windows/win32/api/winuser/nf-winuser-setwindowlongw) to reset the style. For more information, see [Using List View Controls](/windows/win32/Controls/using-list-view-controls) in the Windows SDK. diff --git a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md index eb6d87a53c4..cd497f782a3 100644 --- a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md +++ b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md @@ -3,11 +3,13 @@ description: "Learn more about: Changing the Styles of a Window Created by MFC" title: "Changing the Styles of a Window Created by MFC" ms.date: "11/04/2016" helpviewer_keywords: ["window styles [MFC]", "WS_OVERLAPPEDWINDOW macro [MFC]", "single document interface (SDI), changing window attributes", "MDI [MFC], window styles", "windows [MFC], MFC", "child windows [MFC], styles", "MFC, windows", "CFrameWnd class [MFC], window styles", "CREATESTRUCT macro [MFC]", "CMDIChildWnd class [MFC], changing window styles", "multidocument interface style", "PreCreateWindow method [MFC], window styles", "single document interface (SDI), style", "default window style", "defaults [MFC], window style", "PreCreateWindow method [MFC], changing window styles", "CMainFrame class [MFC]", "styles [MFC], windows"] -ms.assetid: 77fa4f03-96b4-4687-9ade-41e46f7e4b0a ms.topic: concept-article --- # Changing the Styles of a Window Created by MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In its version of the `WinMain` function, MFC registers several standard window classes for you. Because you don't normally edit MFC's `WinMain`, that function gives you no opportunity to change the MFC default window styles. This article explains how you can change the styles of such a preregistered window class in an existing application. ## Changing Styles in a New MFC Application diff --git a/docs/mfc/character-formatting-in-rich-edit-controls.md b/docs/mfc/character-formatting-in-rich-edit-controls.md index 640717720d1..ed92e73f6da 100644 --- a/docs/mfc/character-formatting-in-rich-edit-controls.md +++ b/docs/mfc/character-formatting-in-rich-edit-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Character Formatting in Rich Edit Controls" title: "Character Formatting in Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["formatting [MFC], characters", "rich edit controls [MFC], character formatting in", "CRichEditCtrl class [MFC], character formatting in"] -ms.assetid: c80f4305-75ad-45f9-8d17-d83d0fe79be5 --- # Character Formatting in Rich Edit Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use member functions of the rich edit control ([CRichEditCtrl](reference/cricheditctrl-class.md)) to format characters and to retrieve formatting information. For characters, you can specify typeface, size, color, and effects such as bold, italic, and protected. You can apply character formatting by using the [SetSelectionCharFormat](reference/cricheditctrl-class.md#setselectioncharformat) and [SetWordCharFormat](reference/cricheditctrl-class.md#setwordcharformat) member functions. To determine the current character formatting for the selected text, use the [GetSelectionCharFormat](reference/cricheditctrl-class.md#getselectioncharformat) member function. The [CHARFORMAT](/windows/win32/api/richedit/ns-richedit-charformata) structure is used with these member functions to specify character attributes. One of the important members of **CHARFORMAT** is **dwMask**. In `SetSelectionCharFormat` and `SetWordCharFormat`, **dwMask** specifies which character attributes will be set by this function call. `GetSelectionCharFormat` reports the attributes of the first character in the selection; **dwMask** specifies the attributes that are consistent throughout the selection. diff --git a/docs/mfc/class-library-overview.md b/docs/mfc/class-library-overview.md index 514443b1180..95f1076e12d 100644 --- a/docs/mfc/class-library-overview.md +++ b/docs/mfc/class-library-overview.md @@ -4,11 +4,13 @@ title: "Class Library Overview" ms.date: "09/17/2019" f1_keywords: ["vc.classes.mfc"] helpviewer_keywords: ["grouping MFC classes", "MFC, class library", "classes [MFC], MFC", "class libraries, MFC", "class libraries"] -ms.assetid: 9b0e3152-ac39-4f52-91b4-f20aa3a674aa ms.topic: concept-article --- # Class Library Overview +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This overview categorizes and describes the classes in the Microsoft Foundation Class Library (MFC) version 9.0. The classes in MFC, taken together, constitute an application framework — the framework of an application written for the Windows API. Your programming task is to fill in the code that is specific to your application. The library's classes are presented here in the following categories: diff --git a/docs/mfc/classes-related-to-rich-edit-controls.md b/docs/mfc/classes-related-to-rich-edit-controls.md index 2f7155637b6..de2b4a37401 100644 --- a/docs/mfc/classes-related-to-rich-edit-controls.md +++ b/docs/mfc/classes-related-to-rich-edit-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Classes Related to Rich Edit Controls" title: "Classes Related to Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["rich edit controls [MFC], and CRichEditItem", "CRichEditCtrl class [MFC], related classes", "CRichEditDoc class [MFC], Rich Edit controls", "rich edit controls [MFC], classes related to", "classes [MFC], related to rich edit controls", "rich edit controls [MFC], and CRichEditView", "CRichEditCtrlItem class and CRichEditCtrl", "rich edit controls [MFC], and CRichEditDoc", "CRichEditView class [MFC], and CRichEditCtrl"] -ms.assetid: 4b31c2cc-6ea1-4146-b7c5-b0b5b419f14d --- # Classes Related to Rich Edit Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [CRichEditView](reference/cricheditview-class.md), [CRichEditDoc](reference/cricheditdoc-class.md), and [CRichEditCntrItem](reference/cricheditcntritem-class.md) classes provide the functionality of the rich edit control ([CRichEditCtrl](reference/cricheditctrl-class.md)) within the context of MFC's document/view architecture. `CRichEditView` maintains the text and formatting characteristic of text. `CRichEditDoc` maintains the list of OLE client items that are in the view. `CRichEditCntrItem` provides container-side access to the OLE client item. To modify the contents of a `CRichEditView`, use [CRichEditView::GetRichEditCtrl](reference/cricheditview-class.md#getricheditctrl) to access the underlying rich edit control. ## See also diff --git a/docs/mfc/cleaning-up-documents-and-views.md b/docs/mfc/cleaning-up-documents-and-views.md index ff3d94b0ca2..91b6ec01c28 100644 --- a/docs/mfc/cleaning-up-documents-and-views.md +++ b/docs/mfc/cleaning-up-documents-and-views.md @@ -3,11 +3,13 @@ description: "Learn more about: Cleaning Up Documents and Views" title: "Cleaning Up Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["views [MFC], cleaning up", "documents [MFC], cleaning up", "documents [MFC], closing"] -ms.assetid: 0c454db2-3644-434d-9e53-8108a7aedfe1 ms.topic: concept-article --- # Cleaning Up Documents and Views +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When a document is closing, the framework first calls its [DeleteContents](reference/cdocument-class.md#deletecontents) member function. If you allocated any memory on the heap during the course of the document's operation, `DeleteContents` is the best place to deallocate it. > [!NOTE] diff --git a/docs/mfc/clipboard-adding-other-formats.md b/docs/mfc/clipboard-adding-other-formats.md index f3e9ef9e30b..235d391e58c 100644 --- a/docs/mfc/clipboard-adding-other-formats.md +++ b/docs/mfc/clipboard-adding-other-formats.md @@ -3,10 +3,12 @@ description: "Learn more about: Clipboard: Adding Other Formats" title: "Clipboard: Adding Other Formats" ms.date: "11/04/2016" helpviewer_keywords: ["formats [MFC], Clipboard", "Clipboard, formats", "custom formats, placing on Clipboard", "custom formats", "registering custom Clipboard data formats", "custom Clipboard data formats"] -ms.assetid: aea58159-65ed-4385-aeaa-3d9d5281903b --- # Clipboard: Adding Other Formats +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic explains how to expand the list of supported formats, particularly for OLE support. The topic [Clipboard: Copying and Pasting Data](clipboard-copying-and-pasting-data.md) describes the minimum implementation necessary to support copying and pasting from the Clipboard. If this is all you implement, the only formats placed on the Clipboard are **CF_METAFILEPICT**, **CF_EMBEDSOURCE**, **CF_OBJECTDESCRIPTOR**, and possibly **CF_LINKSOURCE**. Most applications will need more formats on the Clipboard than these three. ## Registering Custom Formats diff --git a/docs/mfc/clipboard-copying-and-pasting-data.md b/docs/mfc/clipboard-copying-and-pasting-data.md index 4225da141bf..f2e50f84159 100644 --- a/docs/mfc/clipboard-copying-and-pasting-data.md +++ b/docs/mfc/clipboard-copying-and-pasting-data.md @@ -3,10 +3,12 @@ description: "Learn more about: Clipboard: Copying and Pasting Data" title: "Clipboard: Copying and Pasting Data" ms.date: "11/04/2016" helpviewer_keywords: ["Clipboard, copying data to", "Clipboard, pasting"] -ms.assetid: 580e10be-241f-4f9f-94cf-8302edc5beef --- # Clipboard: Copying and Pasting Data +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic describes the minimum work necessary to implement copying to and pasting from the Clipboard in your OLE application. It is recommended that you read the [Data Objects and Data Sources (OLE)](data-objects-and-data-sources-ole.md) topics before proceeding. Before you can implement either copying or pasting, you must first provide functions to handle the Copy, Cut, and Paste options on the Edit menu. diff --git a/docs/mfc/clipboard-operations-in-rich-edit-controls.md b/docs/mfc/clipboard-operations-in-rich-edit-controls.md index 972af313345..08b46730de2 100644 --- a/docs/mfc/clipboard-operations-in-rich-edit-controls.md +++ b/docs/mfc/clipboard-operations-in-rich-edit-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Clipboard Operations in Rich Edit Controls" title: "Clipboard Operations in Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["pasting Clipboard data", "CRichEditCtrl class [MFC], paste operation", "cut operation in CRichEditCtrl class [MFC]", "CRichEditCtrl class [MFC], Clipboard operations", "copy operations in rich edit controls", "Clipboard, operations in CRichEditCtrl", "rich edit controls [MFC], Clipboard operations"] -ms.assetid: 15ce66bc-2636-4a35-a2ae-d52285dc1af6 --- # Clipboard Operations in Rich Edit Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Your application can paste the contents of the Clipboard into a rich edit control ([CRichEditCtrl](reference/cricheditctrl-class.md)) using either the best available Clipboard format or a specific Clipboard format. You can also determine whether a rich edit control is capable of pasting a Clipboard format. You can copy or cut the contents of the current selection by using the [Copy](reference/cricheditctrl-class.md#copy) or [Cut](reference/cricheditctrl-class.md#cut) member function. Similarly, you can paste the contents of the Clipboard into a rich edit control by using the [Paste](reference/cricheditctrl-class.md#paste) member function. The control pastes the first available format that it recognizes, which presumably is the most descriptive format. diff --git a/docs/mfc/clipboard-using-the-ole-clipboard-mechanism.md b/docs/mfc/clipboard-using-the-ole-clipboard-mechanism.md index 53da3be2654..288e42cffd2 100644 --- a/docs/mfc/clipboard-using-the-ole-clipboard-mechanism.md +++ b/docs/mfc/clipboard-using-the-ole-clipboard-mechanism.md @@ -3,10 +3,12 @@ description: "Learn more about: Clipboard: Using the OLE Clipboard Mechanism" title: "Clipboard: Using the OLE Clipboard Mechanism" ms.date: "11/04/2016" helpviewer_keywords: ["applications [OLE], Clipboard", "OLE Clipboard", "Clipboard [MFC], OLE formats", "OLE Clipboard, formats", "formats [MFC], Clipboard for OLE"] -ms.assetid: 229cc610-5bb1-435e-bd20-2c8b9964d1af --- # Clipboard: Using the OLE Clipboard Mechanism +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + OLE uses standard formats and some OLE-specific formats for transferring data through the Clipboard. When you cut or copy data from an application, the data is stored on the Clipboard to be used later in paste operations. This data is in a variety of formats. When a user chooses to paste data from the Clipboard, the application can choose which of these formats to use. The application should be written to choose the format that provides the most information, unless the user specifically asks for a certain format, using Paste Special. Before continuing, you may want to read the [Data Objects and Data Sources (OLE)](data-objects-and-data-sources-ole.md) topics. They describe the fundamentals of how data transfers work, and how to implement them in your applications. diff --git a/docs/mfc/clipboard-using-the-windows-clipboard.md b/docs/mfc/clipboard-using-the-windows-clipboard.md index e07d461aecc..648e989ca4f 100644 --- a/docs/mfc/clipboard-using-the-windows-clipboard.md +++ b/docs/mfc/clipboard-using-the-windows-clipboard.md @@ -3,10 +3,12 @@ description: "Learn more about: Clipboard: Using the Windows Clipboard" title: "Clipboard: Using the Windows Clipboard" ms.date: "11/04/2016" helpviewer_keywords: ["Clipboard commands", "Cut/Copy and Paste command handler functions [MFC]", "handler functions, Cut/Copy and Paste commands", "Clipboard [MFC], commands", "commands [MFC], implementing Edit", "Clipboard commands [MFC], implementing", "Windows Clipboard [MFC]", "Clipboard [MFC], Windows Clipboard API"] -ms.assetid: 24415b42-9301-4a70-b69a-44c97918319f --- # Clipboard: Using the Windows Clipboard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic describes how to use the standard Windows Clipboard API within your MFC application. Most applications for Windows support cutting or copying data to the Windows Clipboard and pasting data from the Clipboard. The Clipboard data formats vary among applications. The framework supports only a limited number of Clipboard formats for a limited number of classes. You will normally implement the Clipboard-related commands — Cut, Copy, and Paste — on the Edit menu for your view. The class library defines the command IDs for these commands: **ID_EDIT_CUT**, **ID_EDIT_COPY**, and **ID_EDIT_PASTE**. Their message-line prompts are also defined. diff --git a/docs/mfc/clipboard-when-to-use-each-clipboard-mechanism.md b/docs/mfc/clipboard-when-to-use-each-clipboard-mechanism.md index b9c8f734ae9..28de3cdfcfc 100644 --- a/docs/mfc/clipboard-when-to-use-each-clipboard-mechanism.md +++ b/docs/mfc/clipboard-when-to-use-each-clipboard-mechanism.md @@ -3,10 +3,12 @@ description: "Learn more about: Clipboard: When to Use Each Clipboard Mechanism" title: "Clipboard: When to Use Each Clipboard Mechanism" ms.date: "11/04/2016" helpviewer_keywords: ["applications [OLE], Clipboard", "OLE Clipboard, guidelines", "Clipboard [MFC], mechanisms", "OLE Clipboard, formats", "formats [MFC], Clipboard for OLE", "Clipboard [MFC], formats"] -ms.assetid: fd071996-ef8c-488b-81bd-89057095a201 --- # Clipboard: When to Use Each Clipboard Mechanism +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Follow these guidelines in using the Clipboard: - Use the OLE Clipboard mechanism now to enable new capabilities in the future. While the standard Clipboard API will be maintained, the OLE mechanism is the future of data transfer. diff --git a/docs/mfc/clipboard.md b/docs/mfc/clipboard.md index 9e667377481..cbbc987570c 100644 --- a/docs/mfc/clipboard.md +++ b/docs/mfc/clipboard.md @@ -3,10 +3,12 @@ description: "Learn more about: Clipboard" title: "Clipboard" ms.date: "11/04/2016" helpviewer_keywords: ["cutting and copying data", "copying data", "Clipboard", "Clipboard, programming", "transferring data"] -ms.assetid: a71b2824-1f14-4914-8816-54578d73ad4e --- # Clipboard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This family of articles explains how to implement support for the Windows Clipboard in MFC applications. The Windows Clipboard is used in two ways: - Implementing standard Edit menu commands, such as Cut, Copy, and Paste. diff --git a/docs/mfc/closing-files.md b/docs/mfc/closing-files.md index 2e72fde16a9..84f96abc670 100644 --- a/docs/mfc/closing-files.md +++ b/docs/mfc/closing-files.md @@ -3,11 +3,13 @@ description: "Learn more about: Closing Files" title: "Closing Files" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, file operations", "files [MFC], closing"] -ms.assetid: 8415a3a8-3c75-45b0-ac2a-d5385f49bdb3 ms.topic: how-to --- # Closing Files +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As usual in I/O operations, once you finish with a file, you must close it. #### To close a file diff --git a/docs/mfc/closing-the-dialog-box.md b/docs/mfc/closing-the-dialog-box.md index 38ab0e8290a..bd987c2dd53 100644 --- a/docs/mfc/closing-the-dialog-box.md +++ b/docs/mfc/closing-the-dialog-box.md @@ -3,11 +3,13 @@ description: "Learn more about: Closing the Dialog Box" title: "Closing the Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], closing", "dialog boxes [MFC], closing"] -ms.assetid: 946f5675-c482-46a4-a5dd-34fe138ffae5 ms.topic: concept-article --- # Closing the Dialog Box +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A modal dialog box closes when the user chooses one of its buttons, typically the OK button or the Cancel button. Choosing the OK or Cancel button causes Windows to send the dialog object a **BN_CLICKED** control-notification message with the button's ID, either **IDOK** or **IDCANCEL**. `CDialog` provides default handler functions for these messages: `OnOK` and `OnCancel`. The default handlers call the `EndDialog` member function to close the dialog window. You can also call `EndDialog` from your own code. For more information, see the [EndDialog](reference/cdialog-class.md#enddialog) member function of class `CDialog` in the *MFC Reference*. To arrange for closing and deleting a modeless dialog box, override `PostNcDestroy` and invoke the **`delete`** operator on the **`this`** pointer. [Destroying the Dialog Box](destroying-the-dialog-box.md) explains what happens next. diff --git a/docs/mfc/cobject-class-frequently-asked-questions.md b/docs/mfc/cobject-class-frequently-asked-questions.md index 2689374466d..9e356260f82 100644 --- a/docs/mfc/cobject-class-frequently-asked-questions.md +++ b/docs/mfc/cobject-class-frequently-asked-questions.md @@ -3,11 +3,13 @@ description: "Learn more about: CObject Class: Frequently Asked Questions" title: "CObject Class: Frequently Asked Questions" ms.date: "11/04/2016" helpviewer_keywords: ["CObject class [MFC], FAQ"] -ms.assetid: 809a8b99-a2f8-4e16-8b4b-023c94f4125c ms.topic: faq --- # CObject Class: Frequently Asked Questions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This section covers questions on class `CObject`. ## What do you want to know more about diff --git a/docs/mfc/collections.md b/docs/mfc/collections.md index 7d2d849f052..233816a3beb 100644 --- a/docs/mfc/collections.md +++ b/docs/mfc/collections.md @@ -3,10 +3,12 @@ description: "Learn more about: Collections" title: "Collections" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, collections", "arrays [MFC], classes", "MFC collection classes", "shapes, collection", "collection classes [MFC], MFC", "collections, about collections", "array templates [MFC]", "collection classes [MFC], template-based", "collection classes [MFC], about collection classes", "collection classes [MFC], maps", "collection classes [MFC], arrays", "shapes", "collection classes [MFC], lists", "collection classes [MFC], shapes"] -ms.assetid: 02586e4c-851d-41d0-a722-feb11c17c74c --- # Collections +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class Library provides collection classes to manage groups of objects. These classes are of two types: - [Collection classes created from C++ templates](#_core_the_template_based_collection_classes) diff --git a/docs/mfc/com-interface-entry-points.md b/docs/mfc/com-interface-entry-points.md index 1a35f4c9324..b91a767e41c 100644 --- a/docs/mfc/com-interface-entry-points.md +++ b/docs/mfc/com-interface-entry-points.md @@ -3,10 +3,12 @@ description: "Learn more about: COM Interface Entry Points" title: "COM Interface Entry Points" ms.date: "03/27/2019" helpviewer_keywords: ["entry points, COM interfaces", "state management, OLE/COM interfaces", "MFC COM, COM interface entry points", "OLE, interface entry points", "MFC, managing state data", "COM interfaces, entry points"] -ms.assetid: 9e7421dc-0731-4748-9e1b-90acbaf26d77 --- # COM Interface Entry Points +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For member functions of a COM interface, use the `METHOD_PROLOGUE` macro to maintain the proper global state when calling methods of an exported interface. Typically, member functions of interfaces implemented by `CCmdTarget`-derived objects already use this macro to provide automatic initialization of the `pThis` pointer. For example: diff --git a/docs/mfc/command-ids.md b/docs/mfc/command-ids.md index d5508f8a545..250be8c082e 100644 --- a/docs/mfc/command-ids.md +++ b/docs/mfc/command-ids.md @@ -3,10 +3,12 @@ description: "Learn more about: Command IDs" title: "Command IDs" ms.date: "11/04/2016" helpviewer_keywords: ["command IDs, MFC", "command IDs"] -ms.assetid: e0171a2b-45b9-41fa-945d-ec2f7602ded0 --- # Command IDs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A command is fully described by its command ID alone (encoded in the **WM_COMMAND** message). This ID is assigned to the user-interface object that generates the command. Typically, IDs are named for the functionality of the user-interface object they are assigned to. For example, a Clear All item in the Edit menu might be assigned an ID such as **ID_EDIT_CLEAR_ALL**. The class library predefines some IDs, particularly for commands that the framework handles itself, such as **ID_EDIT_CLEAR_ALL** or **ID_FILE_OPEN**. You will create other command IDs yourself. diff --git a/docs/mfc/command-routing-classes.md b/docs/mfc/command-routing-classes.md index 267d4b9b8ef..e77f0a2b5bd 100644 --- a/docs/mfc/command-routing-classes.md +++ b/docs/mfc/command-routing-classes.md @@ -4,10 +4,12 @@ title: "Command Routing Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.command"] helpviewer_keywords: ["MFC, command routing", "command routing [MFC], classes"] -ms.assetid: 4b50e689-2c54-4e6c-90f0-37333e22b2a1 --- # Command Routing Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As the user interacts with the application by choosing menus or control-bar buttons with the mouse, the application sends messages from the affected user-interface object to an appropriate command-target object. Command-target classes derived from `CCmdTarget` include [CWinApp](reference/cwinapp-class.md), [CWnd](reference/cwnd-class.md), [CDocTemplate](reference/cdoctemplate-class.md), [CDocument](reference/cdocument-class.md), [CView](reference/cview-class.md), and the classes derived from them. The framework supports automatic command routing so that commands can be handled by the most appropriate object currently active in the application. An object of class `CCmdUI` is passed to your command targets' update command UI ([ON_UPDATE_COMMAND_UI](reference/message-map-macros-mfc.md#on_update_command_ui)) handlers to allow you to update the state of the user interface for a particular command (for instance, to check or remove the check from menu items). You call member functions of the `CCmdUI` object to update the state of the UI object. This process is the same whether the UI object associated with a particular command is a menu item or a button or both. diff --git a/docs/mfc/command-routing-illustration.md b/docs/mfc/command-routing-illustration.md index 29ae9a7f00a..4274d6930bd 100644 --- a/docs/mfc/command-routing-illustration.md +++ b/docs/mfc/command-routing-illustration.md @@ -3,11 +3,13 @@ description: "Learn more about: Command Routing Illustration" title: "Command Routing Illustration" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, command routing", "command handling [MFC], routing commands", "command routing [MFC], OnCmdMsg handler"] -ms.assetid: 4b7b4741-565f-4878-b076-fd85c670f87f ms.topic: how-to --- # Command Routing Illustration +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To illustrate, consider a command message from a Clear All menu item in an MDI application's Edit menu. Suppose the handler function for this command happens to be a member function of the application's document class. Here's how that command reaches its handler after the user chooses the menu item: 1. The main frame window receives the command message first. diff --git a/docs/mfc/command-routing.md b/docs/mfc/command-routing.md index a3514eb4e28..8f140daaf38 100644 --- a/docs/mfc/command-routing.md +++ b/docs/mfc/command-routing.md @@ -3,11 +3,13 @@ description: "Learn more about: Command Routing" title: "Command Routing" ms.date: "09/06/2019" helpviewer_keywords: ["MFC, command routing", "command handling [MFC], routing commands", "handlers [MFC]", "handlers, command [MFC]", "command routing"] -ms.assetid: 9393a956-bdd4-47c5-9013-dbd680433f93 ms.topic: how-to --- # Command Routing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Your responsibility in working with commands is limited to making message-map connections between commands and their handler functions, a task for which you use the [MFC Class Wizard](reference/mfc-class-wizard.md). You must also write the code for the command handlers. Windows messages are usually sent to the main frame window, but command messages are then routed to other objects. The framework routes commands through a standard sequence of command-target objects, one of which is expected to have a handler for the command. Each command-target object checks its message map to see if it can handle the incoming message. diff --git a/docs/mfc/command-targets.md b/docs/mfc/command-targets.md index 5e7a2bf8afd..74b9485cd3e 100644 --- a/docs/mfc/command-targets.md +++ b/docs/mfc/command-targets.md @@ -3,10 +3,12 @@ description: "Learn more about: Command Targets" title: "Command Targets" ms.date: "11/04/2016" helpviewer_keywords: ["command targets", "command mapping", "messages, command [MFC]", "command routing [MFC], command targets"] -ms.assetid: b0f784e5-c6dc-4391-9e71-aa7b7dcbe9f0 --- # Command Targets +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The figure [Commands in the Framework](user-interface-objects-and-command-ids.md) shows the connection between a user-interface object, such as a menu item, and the handler function that the framework calls to carry out the resulting command when the object is clicked. Windows sends messages that are not command messages directly to a window whose handler for the message is then called. However, the framework routes commands to a number of candidate objects — called "command targets" — one of which normally invokes a handler for the command. The handler functions work the same way for both commands and standard Windows messages, but the mechanisms by which they are called are different, as explained in [How the Framework Calls a Handler](how-the-framework-calls-a-handler.md). diff --git a/docs/mfc/common-control-sample-list.md b/docs/mfc/common-control-sample-list.md index 4f4e326f4d2..b28e441457f 100644 --- a/docs/mfc/common-control-sample-list.md +++ b/docs/mfc/common-control-sample-list.md @@ -3,10 +3,12 @@ description: "Learn more about: Common Control Sample List" title: "Common Control Sample List" ms.date: "11/04/2016" helpviewer_keywords: ["sample applications [MFC], common controls"] -ms.assetid: 8ae39e2d-12a8-4b17-909d-5bf155749123 --- # Common Control Sample List +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + See the following sample programs that illustrate common controls: - [CMNCTRL1](../overview/visual-cpp-samples.md) diff --git a/docs/mfc/common-dialog-classes.md b/docs/mfc/common-dialog-classes.md index f6221b488d6..329144187af 100644 --- a/docs/mfc/common-dialog-classes.md +++ b/docs/mfc/common-dialog-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Common Dialog Classes" title: "Common Dialog Classes" ms.date: "11/04/2016" helpviewer_keywords: ["dialog classes [MFC]", "dialog boxes [MFC], Windows common dialogs", "common dialog boxes [MFC], common dialog classes", "common dialog classes [MFC]", "MFC dialog boxes [MFC], Windows common dialogs", "Windows common dialogs [MFC]", "dialog classes [MFC], common", "common dialog boxes [MFC]"] -ms.assetid: 5c4f6443-896c-4b05-a7df-8169fdadc71d --- # Common Dialog Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In addition to class [CDialog](reference/cdialog-class.md), MFC supplies several classes derived from `CDialog` that encapsulate commonly used dialog boxes, as shown in the following table. The dialog boxes encapsulated are called the "common dialog boxes" and are part of the Windows common dialog library (COMMDLG.DLL). The dialog-template resources and code for these classes are provided in the Windows common dialog boxes that are part of Windows versions 3.1 and later. ### Common Dialog Classes diff --git a/docs/mfc/commonly-added-member-functions.md b/docs/mfc/commonly-added-member-functions.md index b5fb6d99fda..0fb89df0040 100644 --- a/docs/mfc/commonly-added-member-functions.md +++ b/docs/mfc/commonly-added-member-functions.md @@ -3,10 +3,12 @@ description: "Learn more about: Commonly Added Member Functions" title: "Commonly Added Member Functions" ms.date: "11/04/2016" helpviewer_keywords: ["CDialog class [MFC], members", "MFC dialog boxes [MFC], control-notification messages", "dialog classes [MFC], commonly added member functions"] -ms.assetid: f6bd50e8-872a-4039-9996-a85bfccea18d --- # Commonly Added Member Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If your dialog box contains pushbuttons other than OK or Cancel, you need to write message-handler member functions in your dialog class to respond to the control-notification messages they generate. For an example, see the [Scribble](../overview/visual-cpp-samples.md) sample program. You can also handle control-notification messages from other controls in your dialog box. ## See also diff --git a/docs/mfc/commonly-overridden-member-functions.md b/docs/mfc/commonly-overridden-member-functions.md index 41cd982858e..5e25df0d7ef 100644 --- a/docs/mfc/commonly-overridden-member-functions.md +++ b/docs/mfc/commonly-overridden-member-functions.md @@ -3,10 +3,12 @@ description: "Learn more about: Commonly Overridden Member Functions" title: "Commonly Overridden Member Functions" ms.date: "09/06/2019" helpviewer_keywords: ["CDialog class [MFC], members", "OnInitDialog function", "dialog classes [MFC], commonly overridden member functions", "OnCancel function", "overriding, dialog class members", "OnOK function", "MFC dialog boxes [MFC], overriding member functions"] -ms.assetid: 78eb566c-e361-4c86-8db5-c7e2791b249a --- # Commonly Overridden Member Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table lists the most likely member functions to override in your `CDialog`-derived class. ### Commonly Overridden Member Functions of Class CDialog diff --git a/docs/mfc/communicating-with-a-tree-control.md b/docs/mfc/communicating-with-a-tree-control.md index 959c9f1fbd6..cc35ab04f2f 100644 --- a/docs/mfc/communicating-with-a-tree-control.md +++ b/docs/mfc/communicating-with-a-tree-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Communicating with a Tree Control" title: "Communicating with a Tree Control" ms.date: "11/04/2016" helpviewer_keywords: ["tree controls [MFC], communicating with", "CTreeCtrl class [MFC], calling member functions", "communications, tree controls", "tree controls"] -ms.assetid: 680ad9ee-b11f-452d-93fa-501ca7d7e069 ms.topic: concept-article --- # Communicating with a Tree Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You use different methods for calling member functions in a [CTreeCtrl](reference/ctreectrl-class.md) object depending on how the object was created: - If the tree control is in a dialog box, use a member variable of type `CTreeCtrl` that you create in the dialog box class. diff --git a/docs/mfc/connection-points.md b/docs/mfc/connection-points.md index fff0b34d7c8..239f9206513 100644 --- a/docs/mfc/connection-points.md +++ b/docs/mfc/connection-points.md @@ -4,10 +4,12 @@ title: "Connection Points" ms.date: "11/19/2018" f1_keywords: ["IConnectionPoint"] helpviewer_keywords: ["IConnectionPoint interface", "connections, connection points", "OLE COM connection points", "MFC COM, connection points", "COM, connection points", "interfaces, IConnectionPoint", "MFC, COM support", "connection points [MFC]", "CCmdTarget class [MFC], and connection points", "sinks, connection points"] -ms.assetid: bc9fd7c7-8df6-4752-ac8c-0b177442c88d --- # Connection Points +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to implement connection points (formerly known as OLE connection points) using the MFC classes `CCmdTarget` and `CConnectionPoint`. In the past, the Component Object Model (COM) defined a general mechanism (`IUnknown::QueryInterface`*) that allowed objects to implement and expose functionality in interfaces. However, a corresponding mechanism that allowed objects to expose their capability to call specific interfaces was not defined. That is, COM defined how incoming pointers to objects (pointers to that object's interfaces) were handled, but it did not have an explicit model for outgoing interfaces (pointers the object holds to other objects' interfaces). COM now has a model, called connection points, that supports this functionality. diff --git a/docs/mfc/containers-advanced-features.md b/docs/mfc/containers-advanced-features.md index 41c1ce872bf..e4eff569a72 100644 --- a/docs/mfc/containers-advanced-features.md +++ b/docs/mfc/containers-advanced-features.md @@ -3,10 +3,12 @@ description: "Learn more about: Containers: Advanced Features" title: "Containers: Advanced Features" ms.date: "11/04/2016" helpviewer_keywords: ["links [MFC], to embedded OLE objects", "containers [MFC], links to embedded OLE objects", "containers [MFC], advanced features", "container/server applications [MFC]", "embedded objects [MFC]", "OLE controls [MFC], containers", "OLE containers [MFC], advanced features", "server/container applications [MFC]", "containers [MFC], container applications"] -ms.assetid: 221fd99c-b138-40fa-ad6a-974e3b3ad1f8 --- # Containers: Advanced Features +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the steps necessary to incorporate optional advanced features into existing container applications. These features are: - [An application that is both a container and a server](#_core_creating_a_container_server_application) diff --git a/docs/mfc/containers-client-item-notifications.md b/docs/mfc/containers-client-item-notifications.md index aff7be898fc..81b3d44d4b9 100644 --- a/docs/mfc/containers-client-item-notifications.md +++ b/docs/mfc/containers-client-item-notifications.md @@ -3,10 +3,12 @@ description: "Learn more about: Containers: Client-Item Notifications" title: "Containers: Client-Item Notifications" ms.date: "11/04/2016" helpviewer_keywords: ["notifications [MFC], container client item", "OLE containers [MFC], client-item notifications", "client items and OLE containers"] -ms.assetid: e1f1c427-01f5-45f2-b496-c5bce3d76340 --- # Containers: Client-Item Notifications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses the overridable functions that the MFC framework calls when server applications modify items in your client application's document. [COleClientItem](reference/coleclientitem-class.md) defines several overridable functions that are called in response to requests from the component application, which is also called the server application. These overridables usually act as notifications. They inform the container application of various events, such as scrolling, activation, or a change of position, and of changes that the user makes when editing or otherwise manipulating the item. diff --git a/docs/mfc/containers-client-item-states.md b/docs/mfc/containers-client-item-states.md index 3c0cd589309..a457c8b1b25 100644 --- a/docs/mfc/containers-client-item-states.md +++ b/docs/mfc/containers-client-item-states.md @@ -3,10 +3,12 @@ description: "Learn more about: Containers: Client-Item States" title: "Containers: Client-Item States" ms.date: "11/04/2016" helpviewer_keywords: ["OLE containers [MFC], client-item states", "states, OLE container client-item", "lifetime, lifetime states and OLE container client items", "client items and OLE containers"] -ms.assetid: e7021caa-bd07-4adb-976e-f5f3d025bc53 --- # Containers: Client-Item States +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the different states a client item passes through in its lifetime. A client item passes through several states as it is created, activated, modified, and saved. Each time the item's state changes, the framework calls [COleClientItem::OnChange](reference/coleclientitem-class.md#onchange) with the **OLE_CHANGED_STATE** notification. The second parameter is a value from the `COleClientItem::ItemState` enumeration. It can be one of the following: diff --git a/docs/mfc/containers-client-items.md b/docs/mfc/containers-client-items.md index f2e17257faa..9778f9c51c1 100644 --- a/docs/mfc/containers-client-items.md +++ b/docs/mfc/containers-client-items.md @@ -3,10 +3,12 @@ description: "Learn more about: Containers: Client Items" title: "Containers: Client Items" ms.date: "11/04/2016" helpviewer_keywords: ["OLE containers [MFC], client items", "client items and OLE containers"] -ms.assetid: 231528b5-0744-4f83-8897-083bf55ed087 --- # Containers: Client Items +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains what client items are and from what classes your application should derive its client items. Client items are data items belonging to another application that are either contained in or referenced by an OLE container application's document. Client items whose data is contained within the document are embedded; those whose data is stored in another location referenced by the container document are linked. diff --git a/docs/mfc/containers-compound-files.md b/docs/mfc/containers-compound-files.md index 0ae34087ac0..bfd759966e5 100644 --- a/docs/mfc/containers-compound-files.md +++ b/docs/mfc/containers-compound-files.md @@ -3,10 +3,12 @@ description: "Learn more about: Containers: Compound Files" title: "Containers: Compound Files" ms.date: "11/04/2016" helpviewer_keywords: ["compound files [MFC]", "compound documents", "containers [MFC], compound files", "OLE documents [MFC], compound files", "performance [MFC], compound files", "files [MFC], compound", "standardized file structure compound files", "documents [MFC], compound", "documents [MFC], OLE", "OLE containers [MFC], compound files", "access modes for files [MFC]"] -ms.assetid: 8b83cb3e-76c8-4bbe-ba16-737092b36f49 --- # Containers: Compound Files +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the components and implementation of compound files and the advantages and disadvantages of using compound files in your OLE applications. Compound files are an integral part of OLE. They are used to facilitate data transfer and OLE document storage. Compound files are an implementation of the Active structured storage model. Consistent interfaces exist that support serialization to a storage, a stream, or a file object. Compound files are supported in the Microsoft Foundation Class Library by the classes `COleStreamFile` and `COleDocument`. diff --git a/docs/mfc/containers-for-activex-controls.md b/docs/mfc/containers-for-activex-controls.md index 8b5adeba287..08fb52eff64 100644 --- a/docs/mfc/containers-for-activex-controls.md +++ b/docs/mfc/containers-for-activex-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Containers for ActiveX Controls" title: "Containers for ActiveX Controls" ms.date: "09/12/2018" helpviewer_keywords: ["ActiveX control containers [MFC], application support"] -ms.assetid: 5ff0bf37-07f4-49aa-ad9c-c63d3756243a --- # Containers for ActiveX Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use ActiveX controls developed in Visual Studio in other applications, as long as they support ActiveX control containment. A number of Microsoft applications, beginning with the versions listed, support ActiveX control containment. >[!IMPORTANT] diff --git a/docs/mfc/containers-implementing-a-container.md b/docs/mfc/containers-implementing-a-container.md index c6dbc10dc32..4fa39bc520c 100644 --- a/docs/mfc/containers-implementing-a-container.md +++ b/docs/mfc/containers-implementing-a-container.md @@ -3,10 +3,12 @@ description: "Learn more about: Containers: Implementing a Container" title: "Containers: Implementing a Container" ms.date: "11/04/2016" helpviewer_keywords: ["applications [OLE], OLE container", "OLE containers [MFC], implementing"] -ms.assetid: af1e2079-619a-4eac-9327-985ad875823a --- # Containers: Implementing a Container +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article summarizes the procedure for implementing a container and points you to other articles that provide more detailed explanations about implementing containers. It also lists some optional OLE features you may want to implement and the articles describing these features. #### To prepare your CWinApp-derived class diff --git a/docs/mfc/containers-user-interface-issues.md b/docs/mfc/containers-user-interface-issues.md index 1e9cd232f72..94b3f0aa1d9 100644 --- a/docs/mfc/containers-user-interface-issues.md +++ b/docs/mfc/containers-user-interface-issues.md @@ -3,10 +3,12 @@ description: "Learn more about: Containers: User-Interface Issues" title: "Containers: User-Interface Issues" ms.date: "11/04/2016" helpviewer_keywords: ["containers [MFC], user-interface issues", "OLE containers [MFC], user interface", "user interface issues"] -ms.assetid: c833c249-a633-4f1c-82d6-ec6b4892863a --- # Containers: User-Interface Issues +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You must add a number of features to a container application's user interface to adequately manage linked and embedded items. These features involve changes to the menu structure and to the events that the application handles. For detailed information about them, see the following articles: |For information on|See| diff --git a/docs/mfc/containers.md b/docs/mfc/containers.md index a7fff2b8a52..8936ef14fca 100644 --- a/docs/mfc/containers.md +++ b/docs/mfc/containers.md @@ -3,10 +3,12 @@ description: "Learn more about: Containers" title: "Containers" ms.date: "11/04/2016" helpviewer_keywords: ["containers [MFC]", "OLE containers", "application containers [MFC]", "containers [MFC], OLE container applications", "containers [MFC], container applications"] -ms.assetid: b19d7c05-4d02-44bd-b76a-4a6c25994a62 --- # Containers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A container application is an application that can incorporate embedded or linked items into its own documents. The documents managed by a container application must be able to store and display OLE compound document components as well as data created by the application itself. A container application must also allow users to insert new items or edit existing items. ## In This Section diff --git a/docs/mfc/control-bar-classes.md b/docs/mfc/control-bar-classes.md index 83d7dc63c7e..e24776d9fd5 100644 --- a/docs/mfc/control-bar-classes.md +++ b/docs/mfc/control-bar-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Control Bar Classes" title: "Control Bar Classes" ms.date: "11/04/2016" helpviewer_keywords: ["control bars [MFC], classes"] -ms.assetid: 11009103-cad8-4309-85ce-3d2e858e1818 --- # Control Bar Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Control bars are attached to a frame window. They contain buttons, status panes, or a dialog template. Free-floating control bars, also called tool palettes, are implemented by attaching them to a [CMiniFrameWnd](reference/cminiframewnd-class.md) object. ## Framework Control Bars diff --git a/docs/mfc/control-bars.md b/docs/mfc/control-bars.md index 70b65d5e778..d4aa5c879e2 100644 --- a/docs/mfc/control-bars.md +++ b/docs/mfc/control-bars.md @@ -3,10 +3,12 @@ description: "Learn more about: Control Bars" title: "Control Bars" ms.date: "11/04/2016" helpviewer_keywords: ["command bars [MFC], types of", "toolbars [MFC], control bars", "control bars [MFC]", "MFC, control bars", "control bars [MFC], types of", "CDialogBar class [MFC], control bars", "status bars [MFC], control bars", "CControlBar class [MFC], MFC control bars", "dialog bars [MFC], control bars", "CToolBar class [MFC], control bars", "CStatusBar class [MFC], control bars"] -ms.assetid: 31831910-3d23-4d70-9e71-03cc02f01ec4 --- # Control Bars +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + "Control bar" is the general name for toolbars, status bars, and dialog bars. MFC classes `CToolBar`, `CStatusBar`, `CDialogBar`, `COleResizeBar`, and `CReBar` derive from class [CControlBar](reference/ccontrolbar-class.md), which implements their common functionality. Control bars are windows that display rows of controls with which users can select options, execute commands, or obtain program information. Types of control bars include toolbars, dialog bars, and status bars. diff --git a/docs/mfc/control-classes.md b/docs/mfc/control-classes.md index 39a211802cc..10517c135b1 100644 --- a/docs/mfc/control-classes.md +++ b/docs/mfc/control-classes.md @@ -4,10 +4,12 @@ title: "Control Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.control"] helpviewer_keywords: ["static display controls [MFC]", "control classes [MFC]", "buttons, MFC control classes", "controls [MFC], MFC control classes", "controls [MFC]", "list boxes [MFC], MFC control classes", "control classes [MFC], MFC", "text, controls for input [MFC]", "user input [MFC], MFC control classes"] -ms.assetid: f9876606-9f5b-44cb-9135-213298d1df8f --- # Control Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Control classes encapsulate a wide variety of standard Windows controls ranging from static text controls to tree controls. In addition, MFC provides some new controls, including buttons with bitmaps and control bars. The controls whose class names end in "**Ctrl**" were new in Windows 95 and Windows NT version 3.51. diff --git a/docs/mfc/controls-mfc.md b/docs/mfc/controls-mfc.md index 2fe0a205f76..c5801b29796 100644 --- a/docs/mfc/controls-mfc.md +++ b/docs/mfc/controls-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Controls (MFC)" title: "Controls (MFC)" ms.date: "11/04/2016" helpviewer_keywords: ["Windows common controls [MFC]", "common controls [MFC]", "controls [MFC]"] -ms.assetid: b2842884-6435-4b8f-933b-21671bf8af95 --- # Controls (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Controls are objects that users can interact with to enter or manipulate data. They commonly appear in dialog boxes or on toolbars. This topic family covers three main kinds of controls: - Windows common controls, including owner-drawn controls diff --git a/docs/mfc/creating-a-ctoolbarctrl-object.md b/docs/mfc/creating-a-ctoolbarctrl-object.md index a474106b412..f5bc8b35611 100644 --- a/docs/mfc/creating-a-ctoolbarctrl-object.md +++ b/docs/mfc/creating-a-ctoolbarctrl-object.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating a CToolBarCtrl Object" title: "Creating a CToolBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["toolbar controls [MFC], creating", "CToolBarCtrl class [MFC], creating toolbars"] -ms.assetid: a4f6bf0c-0195-4dbf-a09e-aee503e19dc3 ms.topic: how-to --- # Creating a CToolBarCtrl Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + [CToolBarCtrl](reference/ctoolbarctrl-class.md) objects contain several internal data structures — a list of button image bitmaps, a list of button label strings, and a list of `TBBUTTON` structures — that associate an image and/or string with the position, style, state, and command ID of the button. Each of the elements of these data structures is referred to by a zero-based index. Before you can use a `CToolBarCtrl` object, you must set up these data structures. For a list of the data structures, see [Toolbar Controls](controls-mfc.md) in the Windows SDK. The list of strings can only be used for button labels; you cannot retrieve strings from the toolbar. To use a `CToolBarCtrl` object, you will typically follow these steps: diff --git a/docs/mfc/creating-a-dialog-class-with-code-wizards.md b/docs/mfc/creating-a-dialog-class-with-code-wizards.md index b57a8a37d9f..392782ede1d 100644 --- a/docs/mfc/creating-a-dialog-class-with-code-wizards.md +++ b/docs/mfc/creating-a-dialog-class-with-code-wizards.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating a Dialog Class with Code Wizards" title: "Creating a Dialog Class with Code Wizards" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], creating", "MFC dialog boxes, creating", "code wizards", "dialog classes [MFC], creating"] -ms.assetid: a7157b9d-f1a8-4381-a4cf-180cd2c7f1b2 ms.topic: concept-article --- # Creating a Dialog Class with Code Wizards +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table lists dialog-related tasks that Code Wizards help you manage. ### Dialog-Related Tasks diff --git a/docs/mfc/creating-a-modeless-property-sheet.md b/docs/mfc/creating-a-modeless-property-sheet.md index 923076c45a7..0301f3ffcbc 100644 --- a/docs/mfc/creating-a-modeless-property-sheet.md +++ b/docs/mfc/creating-a-modeless-property-sheet.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating a Modeless Property Sheet" title: "Creating a Modeless Property Sheet" ms.date: "11/04/2016" helpviewer_keywords: ["modeless property sheets", "property sheets, modeless", "Create method [MFC], property sheets"] -ms.assetid: eafd8a92-cc67-4a69-a5fb-742c920d1ae8 ms.topic: concept-article --- # Creating a Modeless Property Sheet +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Normally, the property sheets you create will be modal. When using a modal property sheet, the user must close the property sheet before using any other part of the application. This article describes methods you can use to create a modeless property sheet that allows the user to keep the property sheet open while using other parts of the application. To display a property sheet as a modeless dialog box instead of as a modal dialog box, call [CPropertySheet::Create](reference/cpropertysheet-class.md#create) instead of [DoModal](reference/cpropertysheet-class.md#domodal). You must also implement some extra tasks to support a modeless property sheet. diff --git a/docs/mfc/creating-a-rebar-control.md b/docs/mfc/creating-a-rebar-control.md index ecbd59c97a3..08b253503eb 100644 --- a/docs/mfc/creating-a-rebar-control.md +++ b/docs/mfc/creating-a-rebar-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating a Rebar Control" title: "Creating a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["rebar controls [MFC], creating", "CReBarCtrl class [MFC], creating"] -ms.assetid: 0a012e08-772b-4f6a-af86-7cb651d11d3e ms.topic: how-to --- # Creating a Rebar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + [CReBarCtrl](reference/crebarctrl-class.md) objects should be created before the parent object is visible. This minimizes the possibilities of painting problems. For instance, rebar controls (used in frame window objects) are commonly used as parent windows for toolbar controls. Therefore, the parent of the rebar control is the frame window object. Because the frame window object is the parent, the `OnCreate` member function (of the parent) is an excellent place to create the rebar control. diff --git a/docs/mfc/creating-an-active-document-container-application.md b/docs/mfc/creating-an-active-document-container-application.md index c1ef6e9ac2d..397172bbc4c 100644 --- a/docs/mfc/creating-an-active-document-container-application.md +++ b/docs/mfc/creating-an-active-document-container-application.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating an Active Document Container Applicatio title: "Creating an Active Document Container Application" ms.date: "11/04/2016" helpviewer_keywords: ["active documents [MFC], containers", "containers [MFC], active document", "active document containers [MFC], creating", "MFC COM, active document containment", "applications [MFC], active document container"] -ms.assetid: 14e2d022-a6c5-4249-8712-706b0f4433f7 ms.topic: how-to --- # Creating an Active Document Container Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The simplest and most recommended way to create an active document container application is to create an MFC EXE container application using the MFC Application Wizard, then modify the application to support active document containment. #### To create an active document container application diff --git a/docs/mfc/creating-an-extended-combo-box-control.md b/docs/mfc/creating-an-extended-combo-box-control.md index c39f606ba2e..3d49c2a16d3 100644 --- a/docs/mfc/creating-an-extended-combo-box-control.md +++ b/docs/mfc/creating-an-extended-combo-box-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating an Extended Combo Box Control" title: "Creating an Extended Combo Box Control" ms.date: "11/04/2016" helpviewer_keywords: ["extended combo boxes", "CComboBoxEx class [MFC], creating extended combo box controls", "extended combo boxes [MFC], creating"] -ms.assetid: a964267e-97b6-4e77-9f89-55bb5c68913f ms.topic: how-to --- # Creating an Extended Combo Box Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + How the extended combo box control is created depends on whether you are using the control in a dialog box or creating it in a nondialog window. ### To use CComboBoxEx directly in a dialog box diff --git a/docs/mfc/creating-and-displaying-dialog-boxes.md b/docs/mfc/creating-and-displaying-dialog-boxes.md index 233faf62b31..cb4c355f408 100644 --- a/docs/mfc/creating-and-displaying-dialog-boxes.md +++ b/docs/mfc/creating-and-displaying-dialog-boxes.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating and Displaying Dialog Boxes" title: "Creating and Displaying Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["modal dialog boxes [MFC], creating", "opening dialog boxes", "modeless dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating", "MFC dialog boxes [MFC], displaying"] -ms.assetid: 1c5219ee-8b46-44bc-9708-83705d4f248b ms.topic: concept-article --- # Creating and Displaying Dialog Boxes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Creating a dialog object is a two-phase operation. First, construct the dialog object, then create the dialog window. Modal and modeless dialog boxes differ somewhat in the process used to create and display them. The following table lists how modal and modeless dialog boxes are normally constructed and displayed. ### Dialog Creation diff --git a/docs/mfc/creating-document-frame-windows.md b/docs/mfc/creating-document-frame-windows.md index 5c2f43a082b..8004e63a1ac 100644 --- a/docs/mfc/creating-document-frame-windows.md +++ b/docs/mfc/creating-document-frame-windows.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating Document Frame Windows" title: "Creating Document Frame Windows" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], creating", "document templates [MFC], and document frame windows", "windows [MFC], creating", "runtime, class information", "run-time class [MFC], and document frame window creation", "document frame windows [MFC], creating", "MFC, frame windows"] -ms.assetid: 8671e239-b76f-4dea-afa8-7024e6e58ff5 ms.topic: concept-article --- # Creating Document Frame Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + [Document/View Creation](document-view-creation.md) shows how the [CDocTemplate](reference/cdoctemplate-class.md) object orchestrates creating the frame window, document, and view and connecting them all together. Three [CRuntimeClass](reference/cruntimeclass-structure.md) arguments to the `CDocTemplate` constructor specify the frame window, document, and view classes that the document template creates dynamically in response to user commands such as the New command on the File menu or the New Window command on an MDI Window menu. The document template stores this information for later use when it creates a frame window for a view and document. For the [RUNTIME_CLASS](reference/run-time-object-model-services.md#runtime_class) mechanism to work correctly, your derived frame-window classes must be declared with the [DECLARE_DYNCREATE](reference/run-time-object-model-services.md#declare_dyncreate) macro. This is because the framework needs to create document frame windows using the dynamic construction mechanism of class `CObject`. diff --git a/docs/mfc/creating-modal-dialog-boxes.md b/docs/mfc/creating-modal-dialog-boxes.md index 6275a7e461f..a9a4c045f99 100644 --- a/docs/mfc/creating-modal-dialog-boxes.md +++ b/docs/mfc/creating-modal-dialog-boxes.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating Modal Dialog Boxes" title: "Creating Modal Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["modal dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating", "MFC dialog boxes [MFC], modal"] -ms.assetid: 26c7a68c-79f6-4862-a5a8-6024984644d2 ms.topic: concept-article --- # Creating Modal Dialog Boxes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To create a modal dialog box, call either of the two public constructors declared in [CDialog](reference/cdialog-class.md). Next, call the dialog object's [DoModal](reference/cdialog-class.md#domodal) member function to display the dialog box and manage interaction with it until the user chooses OK or Cancel. This management by `DoModal` is what makes the dialog box modal. For modal dialog boxes, `DoModal` loads the dialog resource. ## See also From 600ddb7f547b54b70ef5100a409a704818c4dd9f Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 20 Feb 2026 12:50:07 -0800 Subject: [PATCH 1636/1799] Batch 2: update files (#6257) --- docs/mfc/creating-modeless-dialog-boxes.md | 4 +++- docs/mfc/creating-new-documents-windows-and-views.md | 4 +++- docs/mfc/creating-stack-and-queue-collections.md | 4 +++- docs/mfc/creating-the-date-and-time-picker-control.md | 4 +++- docs/mfc/creating-the-dialog-resource.md | 4 +++- docs/mfc/creating-the-header-control.md | 4 +++- docs/mfc/creating-the-image-lists.md | 4 +++- docs/mfc/creating-the-list-control.md | 4 +++- docs/mfc/creating-the-month-calendar-control.md | 4 +++- docs/mfc/creating-the-tab-control.md | 4 +++- docs/mfc/creating-windows.md | 4 +++- docs/mfc/creating-your-dialog-class.md | 4 +++- docs/mfc/crebar-vs-crebarctrl.md | 4 +++- docs/mfc/ctreectrl-vs-ctreeview.md | 4 +++- docs/mfc/current-selection-in-a-rich-edit-control.md | 4 +++- docs/mfc/customization-for-mfc.md | 4 +++- docs/mfc/customizing-the-appearance-of-a-toolbar-control.md | 4 +++- docs/mfc/customizing-the-header-item-s-appearance.md | 4 +++- docs/mfc/cwinapp-and-the-mfc-application-wizard.md | 4 +++- docs/mfc/cwinapp-the-application-class.md | 4 +++- docs/mfc/dao-classes.md | 4 +++- .../data-objects-and-data-sources-creation-and-destruction.md | 4 +++- docs/mfc/data-objects-and-data-sources-manipulation.md | 4 +++- docs/mfc/data-objects-and-data-sources-ole.md | 4 +++- docs/mfc/date-and-time-picker-control-examples.md | 4 +++- docs/mfc/debugging-and-exception-classes.md | 4 +++- docs/mfc/debugging-support-classes.md | 4 +++- docs/mfc/declaring-message-handler-functions.md | 4 +++- docs/mfc/deleting-all-objects-in-a-cobject-collection.md | 4 +++- docs/mfc/deprecated-ansi-apis.md | 4 +++- docs/mfc/derived-message-maps.md | 4 +++- docs/mfc/derived-view-classes-available-in-mfc.md | 4 +++- docs/mfc/derived-window-classes.md | 4 +++- docs/mfc/deriving-a-class-from-cobject.md | 4 +++- docs/mfc/deriving-a-document-class-from-cdocument.md | 4 +++- docs/mfc/deriving-controls-from-a-standard-control.md | 4 +++- docs/mfc/destroying-frame-windows.md | 4 +++- docs/mfc/destroying-the-dialog-box.md | 4 +++- docs/mfc/destroying-the-list-control.md | 4 +++- docs/mfc/destroying-window-objects.md | 4 +++- docs/mfc/detaching-a-cwnd-from-its-hwnd.md | 4 +++- docs/mfc/device-contexts.md | 4 +++- docs/mfc/dialog-bars.md | 4 +++- docs/mfc/dialog-box-classes.md | 4 +++- docs/mfc/dialog-box-components-in-the-framework.md | 4 +++- docs/mfc/dialog-boxes-in-ole.md | 4 +++- docs/mfc/dialog-boxes.md | 4 +++- docs/mfc/dialog-data-exchange-and-validation.md | 4 +++- docs/mfc/dialog-data-exchange.md | 4 +++- docs/mfc/dialog-data-validation.md | 4 +++- docs/mfc/dialog-sample-list.md | 4 +++- docs/mfc/do-i-have-to-derive-new-classes-from-cobject-q.md | 4 +++- docs/mfc/docking-and-floating-toolbars.md | 4 +++- ...-and-view-classes-created-by-the-mfc-application-wizard.md | 4 +++- docs/mfc/document-classes.md | 4 +++- docs/mfc/document-template-classes.md | 4 +++- docs/mfc/document-template-creation.md | 4 +++- ...cument-templates-and-the-document-view-creation-process.md | 4 +++- docs/mfc/document-view-architecture.md | 4 +++- docs/mfc/document-view-creation.md | 4 +++- docs/mfc/document-view-sample-list.md | 4 +++- docs/mfc/documents-views-and-the-framework.md | 4 +++- docs/mfc/drag-and-drop-ole.md | 4 +++- docs/mfc/dragging-and-dropping-files-in-a-frame-window.md | 4 +++- docs/mfc/dragging-images-from-an-image-list.md | 4 +++- docs/mfc/drawing-and-printing-classes.md | 4 +++- docs/mfc/drawing-images-from-an-image-list.md | 4 +++- docs/mfc/drawing-in-a-view.md | 4 +++- docs/mfc/drawing-tool-classes.md | 4 +++- docs/mfc/dynamic-layout.md | 4 +++- docs/mfc/dynamic-object-creation.md | 3 +++ docs/mfc/enabling-tool-tips.md | 4 +++- .../mfc/example-displaying-a-dialog-box-via-a-menu-command.md | 4 +++- .../example-of-active-document-containment-office-binder.md | 4 +++- docs/mfc/exception-classes.md | 4 +++- docs/mfc/exception-handling-in-mfc.md | 3 +++ docs/mfc/exceptions-catching-and-deleting-exceptions.md | 4 +++- .../exceptions-changes-to-exception-macros-in-version-3-0.md | 4 +++- docs/mfc/exceptions-converting-from-mfc-exception-macros.md | 4 +++- docs/mfc/exceptions-database-exceptions.md | 4 +++- docs/mfc/exceptions-examining-exception-contents.md | 4 +++- docs/mfc/exceptions-exceptions-in-constructors.md | 4 +++- docs/mfc/exceptions-freeing-objects-in-exceptions.md | 4 +++- docs/mfc/exceptions-ole-exceptions.md | 4 +++- .../exceptions-throwing-exceptions-from-your-own-functions.md | 4 +++- docs/mfc/exceptions-using-mfc-macros-and-cpp-exceptions.md | 4 +++- docs/mfc/exchanging-data.md | 4 +++- docs/mfc/exitinstance-member-function.md | 4 +++- docs/mfc/exported-dll-function-entry-points.md | 4 +++- docs/mfc/file-and-database-classes.md | 4 +++- docs/mfc/file-i-o-classes.md | 4 +++- docs/mfc/file-menu-in-an-mfc-database-application.md | 4 +++- docs/mfc/files-in-mfc.md | 4 +++- docs/mfc/form-views-mfc.md | 4 +++- docs/mfc/frame-window-classes-architecture.md | 4 +++- .../frame-window-classes-created-by-the-application-wizard.md | 4 +++- docs/mfc/frame-window-classes-windows.md | 4 +++- docs/mfc/frame-window-classes.md | 4 +++- docs/mfc/frame-window-styles-cpp.md | 4 +++- docs/mfc/frame-windows.md | 4 +++- 100 files changed, 300 insertions(+), 98 deletions(-) diff --git a/docs/mfc/creating-modeless-dialog-boxes.md b/docs/mfc/creating-modeless-dialog-boxes.md index 92236e26218..4c730a660a6 100644 --- a/docs/mfc/creating-modeless-dialog-boxes.md +++ b/docs/mfc/creating-modeless-dialog-boxes.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating Modeless Dialog Boxes" title: "Creating Modeless Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], modeless", "modeless dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating"] -ms.assetid: 70d78c7f-3d40-477b-9f78-0f33c359f88b ms.topic: concept-article --- # Creating Modeless Dialog Boxes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For a modeless dialog box, you must provide your own public constructor in your dialog class. To create a modeless dialog box, call your public constructor and then call the dialog object's [Create](reference/cdialog-class.md#create) member function to load the dialog resource. You can call **Create** either during or after the constructor call. If the dialog resource has the property **WS_VISIBLE**, the dialog box appears immediately. If not, you must call its [ShowWindow](reference/cwnd-class.md#showwindow) member function. ## See also diff --git a/docs/mfc/creating-new-documents-windows-and-views.md b/docs/mfc/creating-new-documents-windows-and-views.md index c5a9792921f..43a0eca8ee3 100644 --- a/docs/mfc/creating-new-documents-windows-and-views.md +++ b/docs/mfc/creating-new-documents-windows-and-views.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating New Documents, Windows, and Views" title: "Creating New Documents, Windows, and Views" ms.date: "11/19/2018" helpviewer_keywords: ["MDI [MFC], creating windows", "window objects [MFC], creating", "objects [MFC], creating document objects", "MFC default objects", "frame windows [MFC], creating", "windows [MFC], MDI", "MFC, documents", "view objects [MFC], creating", "windows [MFC], creating", "overriding, default view behavior", "views [MFC], initializing", "customizing MFC default objects", "MFC, frame windows", "MFC, views", "MDI [MFC], frame windows", "child windows [MFC], creating MDI", "view objects [MFC]", "document objects [MFC], creating", "MFC default objects [MFC], customizing", "views [MFC], overriding default behavior", "initializing views [MFC]"] -ms.assetid: 88aa1f5f-2078-4603-b16b-a2b4c7b4a2a3 ms.topic: concept-article --- # Creating New Documents, Windows, and Views +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following figures give an overview of the creation process for documents, views, and frame windows. Other articles that focus on the participating objects provide further details. Upon completion of this process, the cooperating objects exist and store pointers to each other. The following figures show the sequence in which objects are created. You can follow the sequence from figure to figure. diff --git a/docs/mfc/creating-stack-and-queue-collections.md b/docs/mfc/creating-stack-and-queue-collections.md index e0e1c818970..f61a62a9391 100644 --- a/docs/mfc/creating-stack-and-queue-collections.md +++ b/docs/mfc/creating-stack-and-queue-collections.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating Stack and Queue Collections" title: "Creating Stack and Queue Collections" ms.date: "11/04/2016" helpviewer_keywords: ["MFC collection classes [MFC], stack collections", "collections, stack", "stack", "collection classes [MFC], creating", "queue collections", "MFC collection classes [MFC], queue collections", "stack collections", "collections, queue"] -ms.assetid: 3c7bc198-35f0-4fc3-aaed-6005a0f22638 ms.topic: how-to --- # Creating Stack and Queue Collections +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to create other data structures, such as [stacks](#_core_stacks) and [queues](#_core_queues), from MFC list classes. The examples use classes derived from `CList`, but you can use `CList` directly unless you need to add functionality. ## Stacks diff --git a/docs/mfc/creating-the-date-and-time-picker-control.md b/docs/mfc/creating-the-date-and-time-picker-control.md index 1c30cd048b0..633c5441142 100644 --- a/docs/mfc/creating-the-date-and-time-picker-control.md +++ b/docs/mfc/creating-the-date-and-time-picker-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating the Date and Time Picker Control" title: "Creating the Date and Time Picker Control" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC], creating", "CDateTimeCtrl class [MFC], creating"] -ms.assetid: 764ec2fb-98cd-478b-a5f2-d63f0bb12279 ms.topic: how-to --- # Creating the Date and Time Picker Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + How the date and time picker control is created depends on whether you are using the control in a dialog box or creating it in a nondialog window. ### To use CDateTimeCtrl directly in a dialog box diff --git a/docs/mfc/creating-the-dialog-resource.md b/docs/mfc/creating-the-dialog-resource.md index 7aa4d5179b2..811a843a8aa 100644 --- a/docs/mfc/creating-the-dialog-resource.md +++ b/docs/mfc/creating-the-dialog-resource.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating the Dialog Resource" title: "Creating the Dialog Resource" ms.date: "11/04/2016" helpviewer_keywords: ["dialog resources", "MFC dialog boxes [MFC], creating", "dialog templates [MFC], creating dialog resource", "templates [MFC], creating", "resources [MFC], creating dialog boxes", "MFC dialog boxes [MFC], dialog resource"] -ms.assetid: 0b83bd33-14d3-4611-8129-fccdae18053e ms.topic: concept-article --- # Creating the Dialog Resource +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To design the [dialog box](dialog-boxes.md) and create the dialog resource, you use the [dialog editor](../windows/dialog-editor.md). In the dialog editor, you can: - Adjust the size and location your dialog box will have when it appears. diff --git a/docs/mfc/creating-the-header-control.md b/docs/mfc/creating-the-header-control.md index e16b83e1204..9ed0680f794 100644 --- a/docs/mfc/creating-the-header-control.md +++ b/docs/mfc/creating-the-header-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating the Header Control" title: "Creating the Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["CHeaderCtrl class [MFC], creating", "header controls [MFC], creating"] -ms.assetid: 7864d9d2-4a2c-4622-b58b-7b110a1e28d2 ms.topic: how-to --- # Creating the Header Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The header control is not directly available in the dialog editor (although you can add a list control, which includes a header control). ### To put a header control in a dialog box diff --git a/docs/mfc/creating-the-image-lists.md b/docs/mfc/creating-the-image-lists.md index da8197206e5..39744f3dc26 100644 --- a/docs/mfc/creating-the-image-lists.md +++ b/docs/mfc/creating-the-image-lists.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating the Image Lists" title: "Creating the Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], creating image lists for", "image lists [MFC], creating for CListCtrl", "lists [MFC], image"] -ms.assetid: c2768515-deba-49e8-a6f3-5be6482afb19 ms.topic: concept-article --- # Creating the Image Lists +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Creating image lists is the same whether you use [CListView](reference/clistview-class.md) or [CListCtrl](reference/clistctrl-class.md). > [!NOTE] diff --git a/docs/mfc/creating-the-list-control.md b/docs/mfc/creating-the-list-control.md index cd17ed745c3..d5944f1b37b 100644 --- a/docs/mfc/creating-the-list-control.md +++ b/docs/mfc/creating-the-list-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating the List Control" title: "Creating the List Control" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], creating control", "list controls [MFC]"] -ms.assetid: a4cb1729-31b6-4d2b-a44b-367474848a39 ms.topic: how-to --- # Creating the List Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + How the list control ([CListCtrl](reference/clistctrl-class.md)) is created depends on whether you're using the control directly or using class [CListView](reference/clistview-class.md) instead. If you use `CListView`, the framework constructs the view as part of its document/view creation sequence. Creating the list view creates the list control as well (the two are the same thing). The control is created in the view's [OnCreate](reference/cwnd-class.md#oncreate) handler function. In this case, the control is ready for you to add items, via a call to [GetListCtrl](reference/clistview-class.md#getlistctrl). ### To use CListCtrl directly in a dialog box diff --git a/docs/mfc/creating-the-month-calendar-control.md b/docs/mfc/creating-the-month-calendar-control.md index 21319b9e5bf..92ff0854f8e 100644 --- a/docs/mfc/creating-the-month-calendar-control.md +++ b/docs/mfc/creating-the-month-calendar-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating the Month Calendar Control" title: "Creating the Month Calendar Control" ms.date: "11/04/2016" helpviewer_keywords: ["CMonthCalCtrl class [MFC], creating", "month calendar controls [MFC], creating", "month calendar controls [MFC]"] -ms.assetid: 185cc642-85e9-4365-8a4c-d90b75b010f7 ms.topic: how-to --- # Creating the Month Calendar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + How the month calendar control is created depends on whether you are using the control in a dialog box or creating it in a nondialog window. ### To use CMonthCalCtrl directly in a dialog box diff --git a/docs/mfc/creating-the-tab-control.md b/docs/mfc/creating-the-tab-control.md index ec4d8a7626b..f8db4aabfc9 100644 --- a/docs/mfc/creating-the-tab-control.md +++ b/docs/mfc/creating-the-tab-control.md @@ -4,11 +4,13 @@ title: "Creating the Tab Control" ms.date: "11/04/2016" f1_keywords: ["TCS_EX_REGISTERDROP", "TCS_EX_FLATSEPARATORS"] helpviewer_keywords: ["TCS_EX_REGISTERDROP extended style [MFC]", "tab controls [MFC], creating", "CTabCtrl class [MFC], creating", "TCS_EX_FLATSEPARATORS extended style"] -ms.assetid: 3a9c2d64-f5f4-41ea-84ab-fceb73c3dbdc ms.topic: how-to --- # Creating the Tab Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + How the tab control is created depends on whether you are using the control in a dialog box or creating it in a nondialog window. ### To use CTabCtrl directly in a dialog box diff --git a/docs/mfc/creating-windows.md b/docs/mfc/creating-windows.md index ffa63d22eda..0c1a016b3bb 100644 --- a/docs/mfc/creating-windows.md +++ b/docs/mfc/creating-windows.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating Windows" title: "Creating Windows" ms.date: "11/04/2016" helpviewer_keywords: ["object creation [MFC], windows", "windows [MFC], creating", "CWnd objects [MFC]", "CWnd objects [MFC], creating"] -ms.assetid: f5ff91a6-4069-47d7-9177-1e6c80d3792c ms.topic: concept-article --- # Creating Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The framework automatically creates most of the windows you need in a framework program. [Document/View Creation](document-view-creation.md) shows how the framework creates the frame windows associated with documents and views. But for special purposes you can create your own windows — including your own child windows of frame windows or views — in addition to the windows supplied by the framework. ## What do you want to know more about diff --git a/docs/mfc/creating-your-dialog-class.md b/docs/mfc/creating-your-dialog-class.md index 904e6f42875..c637e47bc34 100644 --- a/docs/mfc/creating-your-dialog-class.md +++ b/docs/mfc/creating-your-dialog-class.md @@ -3,11 +3,13 @@ description: "Learn more about: Creating Your Dialog Class" title: "Creating Your Dialog Class" ms.date: "09/06/2019" helpviewer_keywords: ["dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating", "files [MFC], creating", "dialog classes [MFC], Add Class Wizard", "dialog classes [MFC], creating"] -ms.assetid: d5321741-da41-47a8-bb1c-6a0e8b28c4c1 ms.topic: concept-article --- # Creating Your Dialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For each dialog box in your program, create a new dialog class to work with the dialog resource. [Adding a Class](../ide/adding-a-class-visual-cpp.md) explains how to create a new dialog class. When you create a dialog class with the [Class Wizard](reference/mfc-class-wizard.md), it writes the following items in the .h and .cpp files you specify: diff --git a/docs/mfc/crebar-vs-crebarctrl.md b/docs/mfc/crebar-vs-crebarctrl.md index 34ddc168552..8e03bf97fca 100644 --- a/docs/mfc/crebar-vs-crebarctrl.md +++ b/docs/mfc/crebar-vs-crebarctrl.md @@ -3,10 +3,12 @@ description: "Learn more about: CReBar vs. CReBarCtrl" title: "CReBar vs. CReBarCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CReBar class [MFC], vs. CReBarCtrl", "rebar controls [MFC], CReBarCtrl class [MFC]", "GetReBarCtrl class [MFC]"] -ms.assetid: 7f9c1d7e-5d5f-4956-843c-69ed3df688d0 --- # CReBar vs. CReBarCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC provides two classes to create rebars: [CReBar](reference/crebar-class.md) and [CReBarCtrl](reference/crebarctrl-class.md) (which wraps the Windows common control API). `CReBar` provides all of the functionality of the rebar common control, and it handles many of the required common control settings and structures for you. `CReBarCtrl` is a wrapper class for the Win32 rebar control, and therefore may be easier to implement if you do not intend to integrate the rebar into the MFC architecture. If you plan to use `CReBarCtrl` and integrate the rebar into the MFC architecture, you must take additional care to communicate rebar control manipulations to MFC. This communication is not difficult; however, it is additional work that is unneeded when you use `CReBar`. diff --git a/docs/mfc/ctreectrl-vs-ctreeview.md b/docs/mfc/ctreectrl-vs-ctreeview.md index bc46617de0a..08205c2d697 100644 --- a/docs/mfc/ctreectrl-vs-ctreeview.md +++ b/docs/mfc/ctreectrl-vs-ctreeview.md @@ -3,10 +3,12 @@ description: "Learn more about: CTreeCtrl vs. CTreeView" title: "CTreeCtrl vs. CTreeView" ms.date: "11/04/2016" helpviewer_keywords: ["tree view controls", "CTreeCtrl class [MFC], vs. CTreeView class [MFC]", "CTreeView class [MFC], vs. CTreeCtrl class [MFC]", "tree controls [MFC], and tree view"] -ms.assetid: bba5af25-103f-4b53-84d3-071bc9bd6494 --- # CTreeCtrl vs. CTreeView +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC provides two classes that encapsulate tree controls: [CTreeCtrl](reference/ctreectrl-class.md) and [CTreeView](reference/ctreeview-class.md). Each class is useful in different situations. Use `CTreeCtrl` when you need a plain child window control; for instance, in a dialog box. You'd especially want to use `CTreeCtrl` if there will be other child controls in the window, as in a typical dialog box. diff --git a/docs/mfc/current-selection-in-a-rich-edit-control.md b/docs/mfc/current-selection-in-a-rich-edit-control.md index 71ba0c09d26..77b23d0394b 100644 --- a/docs/mfc/current-selection-in-a-rich-edit-control.md +++ b/docs/mfc/current-selection-in-a-rich-edit-control.md @@ -3,10 +3,12 @@ description: "Learn more about: Current Selection in a Rich Edit Control" title: "Current Selection in a Rich Edit Control" ms.date: "11/04/2016" helpviewer_keywords: ["current selection in CRichEditCtrls", "CRichEditCtrl class [MFC], current selection in", "rich edit controls [MFC], current selection in", "selection, current in CRichEditCtrl"] -ms.assetid: f6b2a2b6-5481-4ad3-9720-6dd772ea6fc8 --- # Current Selection in a Rich Edit Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The user can select text in a rich edit control ([CRichEditCtrl](reference/cricheditctrl-class.md)) by using the mouse or the keyboard. The current selection is the range of selected characters, or the position of the insertion point if no characters are selected. An application can get information about the current selection, set the current selection, determine when the current selection changes, and show or hide the selection highlight. To determine the current selection in a rich edit control, use the [GetSel](reference/cricheditctrl-class.md#getsel) member function. To set the current selection, use the [SetSel](reference/cricheditctrl-class.md#setsel) member function. The [CHARRANGE](/windows/win32/api/richedit/ns-richedit-charrange) structure is used with these functions to specify a range of characters. To retrieve information about the contents of the current selection, you can use the [GetSelectionType](reference/cricheditctrl-class.md#getselectiontype) member function. diff --git a/docs/mfc/customization-for-mfc.md b/docs/mfc/customization-for-mfc.md index 2ab4a09f1d1..f8e4330ef35 100644 --- a/docs/mfc/customization-for-mfc.md +++ b/docs/mfc/customization-for-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Customization for MFC" title: "Customization for MFC" ms.date: "11/04/2016" helpviewer_keywords: ["customizations, MFC Extensions"] -ms.assetid: 3b1b7532-8cc9-48dc-9bbe-7fd4060530b5 --- # Customization for MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic provides tips for customizing an MFC application. ## General Customizations diff --git a/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md b/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md index 7a40c5a6116..5825ee08448 100644 --- a/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md +++ b/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md @@ -4,11 +4,13 @@ title: "Customizing the Appearance of a Toolbar Control" ms.date: "11/04/2016" f1_keywords: ["TBSTYLE_"] helpviewer_keywords: ["flat toolbars", "CToolBar class [MFC], styles", "transparent toolbars", "TBSTYLE_ styles [MFC]", "CToolBarCtrl class [MFC], object styles", "toolbar controls [MFC], style"] -ms.assetid: fd0a73db-7ad1-4fe4-889b-02c3980f49e8 ms.topic: concept-article --- # Customizing the Appearance of a Toolbar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Class `CToolBarCtrl` provides many styles that affect the appearance (and, occasionally, the behavior) of the toolbar object. Modify the toolbar object by setting the `dwCtrlStyle` parameter of the `CToolBarCtrl::Create` (or `CToolBar::CreateEx`) member function, when you first create the toolbar control. The following styles affect the "3D" aspect of the toolbar buttons and the placement of the button text: diff --git a/docs/mfc/customizing-the-header-item-s-appearance.md b/docs/mfc/customizing-the-header-item-s-appearance.md index 7324136f93a..990ecb305fe 100644 --- a/docs/mfc/customizing-the-header-item-s-appearance.md +++ b/docs/mfc/customizing-the-header-item-s-appearance.md @@ -3,11 +3,13 @@ description: "Learn more about: Customizing the Header Item's Appearance" title: "Customizing the Header Item's Appearance" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], customization of items", "CHeaderCtrl class [MFC], customizing the items", "HDS_ styles"] -ms.assetid: b1e1e326-ec7d-4dbd-a46f-96a3e2055618 ms.topic: concept-article --- # Customizing the Header Item's Appearance +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + By setting the *dwStyle* parameter when you first create a header control ([CHeaderCtrl::Create](reference/cheaderctrl-class.md#create)), you can define the appearance and behavior of header items or of the header control itself. Here is a sampling of the styles you can set, and their purpose: diff --git a/docs/mfc/cwinapp-and-the-mfc-application-wizard.md b/docs/mfc/cwinapp-and-the-mfc-application-wizard.md index 530934f7d79..7e8e4cd5464 100644 --- a/docs/mfc/cwinapp-and-the-mfc-application-wizard.md +++ b/docs/mfc/cwinapp-and-the-mfc-application-wizard.md @@ -3,10 +3,12 @@ description: "Learn more about: CWinApp and the MFC Application Wizard" title: "CWinApp and the MFC Application Wizard" ms.date: "11/04/2016" helpviewer_keywords: ["application wizards [MFC], and CWinApp", "CWinApp class [MFC], and MFC Application Wizard", "MFC, wizards"] -ms.assetid: f8ac0491-3302-4e46-981d-0790624eb8a2 --- # CWinApp and the MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When it creates a skeleton application, the MFC Application Wizard declares an application class derived from [CWinApp](reference/cwinapp-class.md). The MFC Application Wizard also generates an implementation file that contains the following items: - A message map for the application class. diff --git a/docs/mfc/cwinapp-the-application-class.md b/docs/mfc/cwinapp-the-application-class.md index a34f9b55a13..b24b92f4b3f 100644 --- a/docs/mfc/cwinapp-the-application-class.md +++ b/docs/mfc/cwinapp-the-application-class.md @@ -3,10 +3,12 @@ description: "Learn more about: CWinApp: The Application Class" title: "CWinApp: The Application Class" ms.date: "11/04/2016" helpviewer_keywords: ["application class [MFC]", "CWinApp class [MFC], CWinThread", "MFC, WinMain and", "CWinApp class [MFC], multithreading", "CWinThread class [MFC], and CWinApp", "InitApplication method [MFC]", "WinMain method [MFC]", "WinMain method [MFC], in MFC", "CWinApp class [MFC], WinMain"] -ms.assetid: 935822bb-d463-481b-a5f6-9719d68ed1d5 --- # CWinApp: The Application Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The main application class in MFC encapsulates the initialization, running, and termination of an application for the Windows operating system. An application built on the framework must have one and only one object of a class derived from [CWinApp](reference/cwinapp-class.md). This object is constructed before windows are created. `CWinApp` is derived from `CWinThread`, which represents the main thread of execution for your application, which might have one or more threads. In recent versions of MFC, the `InitInstance`, **Run**, `ExitInstance`, and `OnIdle` member functions are actually in class `CWinThread`. These functions are discussed here as if they were `CWinApp` members instead, because the discussion concerns the object's role as application object rather than as primary thread. diff --git a/docs/mfc/dao-classes.md b/docs/mfc/dao-classes.md index 85553ceccae..f7dcafbd128 100644 --- a/docs/mfc/dao-classes.md +++ b/docs/mfc/dao-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: DAO Classes" title: "DAO Classes" ms.date: "09/17/2019" helpviewer_keywords: ["database classes [MFC], DAO", "DAO [MFC], classes"] -ms.assetid: b15d0cd6-328b-4288-9c19-d037a795db57 --- # DAO Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. These classes work with the other application framework classes to give easy access to Data Access Object (DAO) databases, which use the same database engine as Microsoft Visual Basic and Microsoft Access. The DAO classes can also access a wide variety of databases for which Open Database Connectivity (ODBC) drivers are available. diff --git a/docs/mfc/data-objects-and-data-sources-creation-and-destruction.md b/docs/mfc/data-objects-and-data-sources-creation-and-destruction.md index 440ec543ee4..55a6a472b33 100644 --- a/docs/mfc/data-objects-and-data-sources-creation-and-destruction.md +++ b/docs/mfc/data-objects-and-data-sources-creation-and-destruction.md @@ -3,10 +3,12 @@ description: "Learn more about: Data Objects and Data Sources: Creation and Dest title: "Data Objects and Data Sources: Creation and Destruction" ms.date: "11/04/2016" helpviewer_keywords: ["destroying data objects [MFC]", "object creation [MFC], data source objects", "data sources [MFC], and data objects", "data source objects [MFC], creating", "destruction [MFC], data sources", "data source objects [MFC], destroying", "data objects [MFC], creating", "data objects [MFC], destroying", "data sources [MFC], role", "data sources [MFC], destroying", "destruction [MFC], data objects", "data sources [MFC], creating"] -ms.assetid: ac216d54-3ca5-4ce7-850d-cd1f6a90d4f1 --- # Data Objects and Data Sources: Creation and Destruction +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As explained in the article [Data Objects and Data Sources (OLE)](data-objects-and-data-sources-ole.md), data objects and data sources represent both sides of a data transfer. This article explains when to create and destroy these objects and sources to perform your data transfers properly, including: - [Creating data objects](#_core_creating_data_objects) diff --git a/docs/mfc/data-objects-and-data-sources-manipulation.md b/docs/mfc/data-objects-and-data-sources-manipulation.md index 012da4d435b..44b560e727f 100644 --- a/docs/mfc/data-objects-and-data-sources-manipulation.md +++ b/docs/mfc/data-objects-and-data-sources-manipulation.md @@ -3,10 +3,12 @@ description: "Learn more about: Data Objects and Data Sources: Manipulation" title: "Data Objects and Data Sources: Manipulation" ms.date: "11/04/2016" helpviewer_keywords: ["data objects [MFC], manipulating", "data sources [MFC], data operations", "data sources [MFC], inserting data", "Clipboard [MFC], determining available formats", "OLE [MFC], data objects", "Clipboard [MFC], passing format information", "data sources [MFC], determining available formats", "delayed rendering [MFC]", "OLE [MFC], data sources"] -ms.assetid: f7f27e77-bb5d-4131-b819-d71bf929ebaf --- # Data Objects and Data Sources: Manipulation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + After a data object or data source has been created, you can perform a number of common operations on the data, such as inserting and removing data, enumerating the formats the data is in, and more. This article describes the techniques necessary to complete the most common operations. Topics include: - [Inserting data into a data source](#_core_inserting_data_into_a_data_source) diff --git a/docs/mfc/data-objects-and-data-sources-ole.md b/docs/mfc/data-objects-and-data-sources-ole.md index 5b5e949d4f0..a3b803d8bd8 100644 --- a/docs/mfc/data-objects-and-data-sources-ole.md +++ b/docs/mfc/data-objects-and-data-sources-ole.md @@ -3,10 +3,12 @@ description: "Learn more about: Data Objects and Data Sources (OLE)" title: "Data Objects and Data Sources (OLE)" ms.date: "11/04/2016" helpviewer_keywords: ["data objects [MFC], definition", "data transfer [MFC]", "OLE [MFC], data transfer", "data sources [MFC], definition", "data transfer [MFC], definition", "OLE [MFC], data objects", "OLE [MFC], data sources"] -ms.assetid: 8f68eed8-0ce8-4489-a4cc-f95554f89090 --- # Data Objects and Data Sources (OLE) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you perform a data transfer, either by using the Clipboard or drag and drop, the data has a source and a destination. One application provides the data for copying and another application accepts it for pasting. Each side of the transfer needs to perform different operations on the same data for the transfer to succeed. The Microsoft Foundation Class (MFC) Library provides two classes that represent each side of this transfer: - Data sources (as implemented by `COleDataSource` objects) represent the source side of the data transfer. They are created by the source application when data is to be copied to the Clipboard, or when data is provided for a drag-and-drop operation. diff --git a/docs/mfc/date-and-time-picker-control-examples.md b/docs/mfc/date-and-time-picker-control-examples.md index 26eb0b317a0..10d189a5237 100644 --- a/docs/mfc/date-and-time-picker-control-examples.md +++ b/docs/mfc/date-and-time-picker-control-examples.md @@ -3,10 +3,12 @@ description: "Learn more about: Date and Time Picker Control Examples" title: "Date and Time Picker Control Examples" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC]"] -ms.assetid: f03c3a22-7725-45eb-8f8e-dddb2d15c3ca --- # Date and Time Picker Control Examples +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [CMNCTRL1](../overview/visual-cpp-samples.md) sample demonstrates the various attributes of the `CDateTimeCtrl` class. A separate page contains a date and time picker control that the user can manipulate by changing various attributes and testing the basic functionality of the control. ## See also diff --git a/docs/mfc/debugging-and-exception-classes.md b/docs/mfc/debugging-and-exception-classes.md index 95670e20ee0..aa2e150d6cf 100644 --- a/docs/mfc/debugging-and-exception-classes.md +++ b/docs/mfc/debugging-and-exception-classes.md @@ -4,11 +4,13 @@ title: "Debugging and Exception Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.debug"] helpviewer_keywords: ["debugging [MFC], exception classes", "debugging [MFC], classes for debugging"] -ms.assetid: 0d158efd-2e62-452e-9d2a-d3c30dfee7f9 ms.topic: concept-article --- # Debugging and Exception Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes provide support for debugging dynamic memory allocation and for passing exception information from the function where the exception is thrown to the function where it is caught. Use classes [CDumpContext](reference/cdumpcontext-class.md) and [CMemoryState](reference/cmemorystate-structure.md) during development to assist with debugging, as described in [Debugging MFC Applications](/visualstudio/debugger/mfc-debugging-techniques). Use [CRuntimeClass](reference/cruntimeclass-structure.md) to determine the class of any object at run time, as described in the article [Accessing Run-Time Class Information](accessing-run-time-class-information.md). The framework uses `CRuntimeClass` to create objects of a particular class dynamically. diff --git a/docs/mfc/debugging-support-classes.md b/docs/mfc/debugging-support-classes.md index e9b03065b8c..1e40250262b 100644 --- a/docs/mfc/debugging-support-classes.md +++ b/docs/mfc/debugging-support-classes.md @@ -3,11 +3,13 @@ description: "Learn more about: Debugging Support Classes" title: "Debugging Support Classes" ms.date: "11/04/2016" helpviewer_keywords: ["debugging memory leaks, MFC", "memory allocation, debugging dynamic", "debugging [MFC], classes for debugging", "memory allocation, debugging dynamic allocation", "dynamic memory allocation", "debugging [MFC], memory leaks", "memory leaks, MFC debug classes"] -ms.assetid: d79e084a-8326-4251-8700-4efac07c511e ms.topic: concept-article --- # Debugging Support Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC provides the following classes to help you debug dynamic memory allocation problems. [CDumpContext](reference/cdumpcontext-class.md)
diff --git a/docs/mfc/declaring-message-handler-functions.md b/docs/mfc/declaring-message-handler-functions.md index cc9258d87a0..d917ba04e53 100644 --- a/docs/mfc/declaring-message-handler-functions.md +++ b/docs/mfc/declaring-message-handler-functions.md @@ -3,11 +3,13 @@ description: "Learn more about: Declaring Message Handler Functions" title: "Declaring Message Handler Functions" ms.date: "11/04/2016" helpviewer_keywords: ["declaring functions, message handler functions [MFC]"] -ms.assetid: f8d3dbc1-4500-4f1e-a18d-7371edf36386 ms.topic: concept-article --- # Declaring Message Handler Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Certain rules and conventions govern the names of your message-handler functions. These depend on the message category, as described in the following topics: - [Handlers for standard Windows messages](handlers-for-standard-windows-messages.md) diff --git a/docs/mfc/deleting-all-objects-in-a-cobject-collection.md b/docs/mfc/deleting-all-objects-in-a-cobject-collection.md index d57fae1c586..8e78fc10564 100644 --- a/docs/mfc/deleting-all-objects-in-a-cobject-collection.md +++ b/docs/mfc/deleting-all-objects-in-a-cobject-collection.md @@ -3,11 +3,13 @@ description: "Learn more about: Deleting All Objects in a CObject Collection" title: "Deleting All Objects in a CObject Collection" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], deleting in collections", "objects in CObject collections, deleting", "CObject class [MFC], deleting in collection", "collection classes [MFC], deleting all objects", "CObject class collection", "objects in CObject collections", "collection classes [MFC], shared objects"] -ms.assetid: 81d2c1d5-a0a5-46e1-8ab9-82b45cf7afd2 ms.topic: how-to --- # Deleting All Objects in a CObject Collection +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to delete all objects in a collection (without deleting the collection object itself). To delete all the objects in a collection of `CObject`s (or of objects derived from `CObject`), you use one of the iteration techniques described in the article [Accessing All Members of a Collection](accessing-all-members-of-a-collection.md) to delete each object in turn. diff --git a/docs/mfc/deprecated-ansi-apis.md b/docs/mfc/deprecated-ansi-apis.md index 6268b9613e7..6fd26ff2d70 100644 --- a/docs/mfc/deprecated-ansi-apis.md +++ b/docs/mfc/deprecated-ansi-apis.md @@ -3,10 +3,12 @@ description: "Learn more about: Deprecated ANSI APIs" title: "Deprecated ANSI APIs" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, ANSI deprecated methods"] -ms.assetid: c7c5a6fd-95e4-4bee-b3d5-d3826c30947d --- # Deprecated ANSI APIs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class (MFC) library is migrating toward classes and methods that are based on the Unicode character set. Consequently, the ANSI versions of several MFC methods are deprecated. Use the Unicode versions of these methods in your future applications. Starting with Windows Common Controls version 6.1, which ships in Windows Vista, the following ANSI methods are deprecated. diff --git a/docs/mfc/derived-message-maps.md b/docs/mfc/derived-message-maps.md index 97dd244acdc..f178feedb75 100644 --- a/docs/mfc/derived-message-maps.md +++ b/docs/mfc/derived-message-maps.md @@ -3,10 +3,12 @@ title: "Derived Message Maps" description: "Describes MFC message handling." ms.date: "09/23/2020" helpviewer_keywords: ["message handling [MFC], derived message handlers", "messages, routing", "message maps [MFC], derived", "derived message maps"] -ms.assetid: 21829556-6e64-40c3-8279-fed85d99de77 --- # Derived Message Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + During message handling, checking a class's own message map is not the end of the message-map story. What happens if class `CMyView` (derived from `CView`) has no matching entry for a message? Keep in mind that `CView`, the base class of `CMyView`, is derived in turn from `CWnd`. Thus `CMyView` *is* a `CView` and *is* a `CWnd`. Each of those classes has its own message map. The figure below shows the hierarchical relationship of the classes, but keep in mind that a `CMyView` object is a single object that has the characteristics of all three classes. diff --git a/docs/mfc/derived-view-classes-available-in-mfc.md b/docs/mfc/derived-view-classes-available-in-mfc.md index 90f9c090011..852150b4b4a 100644 --- a/docs/mfc/derived-view-classes-available-in-mfc.md +++ b/docs/mfc/derived-view-classes-available-in-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Derived View Classes Available in MFC" title: "Derived View Classes Available in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["CView class [MFC], classes derived from", "classes [MFC], derived", "derived classes [MFC], view classes", "view classes [MFC], derived"] -ms.assetid: dba42178-7459-4ccc-b025-f3d9b8a4b737 --- # Derived View Classes Available in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table shows MFC's view classes and their relationships to one another. The capabilities of your view class depend on the MFC view class from which it derives. ### View Classes diff --git a/docs/mfc/derived-window-classes.md b/docs/mfc/derived-window-classes.md index 8102ecae4f0..2f6f1b9221c 100644 --- a/docs/mfc/derived-window-classes.md +++ b/docs/mfc/derived-window-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Derived window classes" title: "Derived window classes" ms.date: "11/04/2016" helpviewer_keywords: ["window class hierarchy", "hierarchies, window classes", "classes [MFC], derived", "CWnd class [MFC], classes derived from", "derived classes [MFC], window classes", "window classes [MFC], derived"] -ms.assetid: 6f7e437e-fbde-4a06-bfab-72d9dbf05292 --- # Derived window classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can create windows directly from [`CWnd`](reference/cwnd-class.md), or derive new window classes from `CWnd`. It's how you typically create your own custom windows. However, most windows used in a framework program are instead created from one of the `CWnd`-derived frame-window classes supplied by MFC. ## Frame window classes diff --git a/docs/mfc/deriving-a-class-from-cobject.md b/docs/mfc/deriving-a-class-from-cobject.md index bde7b72bbb9..20793426d80 100644 --- a/docs/mfc/deriving-a-class-from-cobject.md +++ b/docs/mfc/deriving-a-class-from-cobject.md @@ -3,11 +3,13 @@ description: "Learn more about: Deriving a Class from CObject" title: "Deriving a Class from CObject" ms.date: "11/04/2016" helpviewer_keywords: ["DECLARE_DYNCREATE macro [MFC]", "DECLARE_SERIAL macro [MFC]", "macros [MFC], serialization", "serialization [MFC], macros", "DECLARE_DYNAMIC macro [MFC]", "derived classes [MFC], from CObject", "CObject class [MFC], deriving serializable classes", "CObject class [MFC], deriving from"] -ms.assetid: 5ea4ea41-08b5-4bd8-b247-c5de8c152a27 ms.topic: how-to --- # Deriving a Class from CObject +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the minimum steps necessary to derive a class from [CObject](reference/cobject-class.md). Other `CObject` class articles describe the steps needed to take advantage of specific `CObject` features, such as serialization and diagnostic debugging support. In the discussions of `CObject`, the terms "interface file" and "implementation file" are used frequently. The interface file (often called the header file, or .H file) contains the class declaration and any other information needed to use the class. The implementation file (or .CPP file) contains the class definition as well as the code that implements the class member functions. For example, for a class named `CPerson`, you would typically create an interface file named PERSON.H and an implementation file named PERSON.CPP. However, for some small classes that will not be shared among applications, it is sometimes easier to combine the interface and implementation into a single .CPP file. diff --git a/docs/mfc/deriving-a-document-class-from-cdocument.md b/docs/mfc/deriving-a-document-class-from-cdocument.md index 1184517b913..67e3cbdb776 100644 --- a/docs/mfc/deriving-a-document-class-from-cdocument.md +++ b/docs/mfc/deriving-a-document-class-from-cdocument.md @@ -3,11 +3,13 @@ description: "Learn more about: Deriving a Document Class from CDocument" title: "Deriving a Document Class from CDocument" ms.date: "11/04/2016" helpviewer_keywords: ["CDocument class [MFC], deriving from", "classes [MFC], deriving from CDocument", "document objects [MFC], derived", "derived classes [MFC], functions often overridden", "document classes [MFC], functions often overridden"] -ms.assetid: e6a198e0-9799-43c0-83c5-04174d8b532c ms.topic: concept-article --- # Deriving a Document Class from CDocument +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Documents contain and manage your application's data. To use the MFC Application Wizard-supplied document class, you must do the following: - Derive a class from `CDocument` for each type of document. diff --git a/docs/mfc/deriving-controls-from-a-standard-control.md b/docs/mfc/deriving-controls-from-a-standard-control.md index 3489abe0ff7..eec1f103ace 100644 --- a/docs/mfc/deriving-controls-from-a-standard-control.md +++ b/docs/mfc/deriving-controls-from-a-standard-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Deriving Controls from a Standard Control" title: "Deriving Controls from a Standard Control" ms.date: "11/04/2016" helpviewer_keywords: ["standard controls [MFC], deriving controls from", "common controls [MFC], deriving from", "derived controls", "controls [MFC], derived", "Windows common controls [MFC], deriving from", "standard controls"] -ms.assetid: a6f84315-7007-4e0e-8576-78be81254802 ms.topic: how-to --- # Deriving Controls from a Standard Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As with any [CWnd](reference/cwnd-class.md)-derived class, you can modify a control's behavior by deriving a new class from an existing control class. ### To create a derived control class diff --git a/docs/mfc/destroying-frame-windows.md b/docs/mfc/destroying-frame-windows.md index 4bd96d2b29f..ae0d33b240c 100644 --- a/docs/mfc/destroying-frame-windows.md +++ b/docs/mfc/destroying-frame-windows.md @@ -4,11 +4,13 @@ title: "Destroying Frame Windows" ms.date: "11/04/2016" f1_keywords: ["PostNcDestroy"] helpviewer_keywords: ["Default method [MFC]", "DestroyWindow method [MFC]", "frame windows [MFC], destroying", "OnNcDestroy method, and frame windows", "document frame windows [MFC], destroying", "destroying frame windows", "MFC, frame windows", "windows [MFC], destroying", "OnClose method [MFC]", "PostNcDestroy method [MFC]"] -ms.assetid: 5affca77-1999-4507-a2b2-9aa226611b4b ms.topic: concept-article --- # Destroying Frame Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The MFC framework manages window destruction as well as creation for those windows associated with framework documents and views. If you create additional windows, you are responsible for destroying them. In the framework, when the user closes the frame window, the window's default [OnClose](reference/cwnd-class.md#onclose) handler calls [DestroyWindow](reference/cwnd-class.md#destroywindow). The last member function called when the Windows window is destroyed is [OnNcDestroy](reference/cwnd-class.md#onncdestroy), which does some cleanup, calls the [Default](reference/cwnd-class.md#default) member function to perform Windows cleanup, and lastly calls the virtual member function [PostNcDestroy](reference/cwnd-class.md#postncdestroy). The [CFrameWnd](reference/cframewnd-class.md) implementation of `PostNcDestroy` deletes the C++ window object. You should never use the C++ **`delete`** operator on a frame window. Use `DestroyWindow` instead. diff --git a/docs/mfc/destroying-the-dialog-box.md b/docs/mfc/destroying-the-dialog-box.md index c8a2f0dbfbf..b519e064233 100644 --- a/docs/mfc/destroying-the-dialog-box.md +++ b/docs/mfc/destroying-the-dialog-box.md @@ -3,11 +3,13 @@ description: "Learn more about: Destroying the Dialog Box" title: "Destroying the Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], deleting", "destruction, dialog box", "dialog boxes [MFC], destroying", "dialog boxes [MFC], removing", "modeless dialog boxes [MFC], destroying", "MFC dialog boxes [MFC], destroying", "modal dialog boxes [MFC], destroying"] -ms.assetid: dabceee7-3639-4d85-bf34-73515441b3d0 ms.topic: concept-article --- # Destroying the Dialog Box +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Modal dialog boxes are normally created on the stack frame and destroyed when the function that created them ends. The dialog object's destructor is called when the object goes out of scope. Modeless dialog boxes are normally created and owned by a parent view or frame window — the application's main frame window or a document frame window. The default [OnClose](reference/cwnd-class.md#onclose) handler calls [DestroyWindow](reference/cwnd-class.md#destroywindow), which destroys the dialog-box window. If the dialog box stands alone, with no pointers to it or other special ownership semantics, you should override [PostNcDestroy](reference/cwnd-class.md#postncdestroy) to destroy the C++ dialog object. You should also override [OnCancel](reference/cdialog-class.md#oncancel) and call `DestroyWindow` from within it. If not, the owner of the dialog box should destroy the C++ object when it is no longer necessary. diff --git a/docs/mfc/destroying-the-list-control.md b/docs/mfc/destroying-the-list-control.md index 760823ee5d8..38792c165d3 100644 --- a/docs/mfc/destroying-the-list-control.md +++ b/docs/mfc/destroying-the-list-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Destroying the List Control" title: "Destroying the List Control" ms.date: "11/04/2016" helpviewer_keywords: ["list controls [MFC], destroying", "CListCtrl class [MFC], destroying controls"] -ms.assetid: 513ec820-3a02-49d2-b073-a6a7a3fc91b3 ms.topic: concept-article --- # Destroying the List Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you embed your [CListCtrl](reference/clistctrl-class.md) object as a data member of a view or dialog class, it is destroyed when its owner is destroyed. If you use a [CListView](reference/clistview-class.md), the framework destroys the control when it destroys the view. If you arrange for some of your list data to be stored in the application rather than the list control, you will need to arrange for its deallocation. For more information, see [Callback Items and the Callback Mask](/windows/win32/Controls/using-list-view-controls) in the Windows SDK. diff --git a/docs/mfc/destroying-window-objects.md b/docs/mfc/destroying-window-objects.md index 3a02e91f0bc..9ef30b2dc40 100644 --- a/docs/mfc/destroying-window-objects.md +++ b/docs/mfc/destroying-window-objects.md @@ -3,11 +3,13 @@ description: "Learn more about: Destroying Window Objects" title: "Destroying Window Objects" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], destroying", "window objects [MFC], deleting", "window objects [MFC], destroying", "window objects [MFC], removing"] -ms.assetid: 3241fea0-c614-4a25-957d-20f21bd5fd0c ms.topic: concept-article --- # Destroying Window Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Care must be taken with your own child windows to destroy the C++ window object when the user is finished with the window. If these objects are not destroyed, your application will not recover their memory. Fortunately, the framework manages window destruction as well as creation for frame windows, views, and dialog boxes. If you create additional windows, you are responsible for destroying them. ## What do you want to know more about diff --git a/docs/mfc/detaching-a-cwnd-from-its-hwnd.md b/docs/mfc/detaching-a-cwnd-from-its-hwnd.md index abacdcd81f5..ce2d2c3d3e2 100644 --- a/docs/mfc/detaching-a-cwnd-from-its-hwnd.md +++ b/docs/mfc/detaching-a-cwnd-from-its-hwnd.md @@ -3,11 +3,13 @@ description: "Learn more about: Detaching a CWnd from Its HWND" title: "Detaching a CWnd from Its HWND" ms.date: "11/04/2016" helpviewer_keywords: ["HWND, detaching CWnd from", "removing HWNDs from CWnds", "CWnd objects [MFC], detaching from HWND", "detaching CWnds from HWNDs", "Detach method (CWnd class)"] -ms.assetid: 6efadf84-0517-4a3f-acfd-216e088f19c6 ms.topic: concept-article --- # Detaching a CWnd from Its HWND +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you need to circumvent the object-`HWND` relationship, MFC provides another `CWnd` member function, [Detach](reference/cwnd-class.md#detach), which disconnects the C++ window object from the Windows window. This prevents the destructor from destroying the Windows window when the object is destroyed. ## What do you want to know more about diff --git a/docs/mfc/device-contexts.md b/docs/mfc/device-contexts.md index 6662d7c60ec..535c3f4debf 100644 --- a/docs/mfc/device-contexts.md +++ b/docs/mfc/device-contexts.md @@ -3,10 +3,12 @@ description: "Learn more about: Device Contexts" title: "Device Contexts" ms.date: "11/04/2016" helpviewer_keywords: ["OnPrepareDC method [MFC]", "windows [MFC], and device context", "drawing [MFC], device context", "CClientDC class [MFC], and GetDC method [MFC]", "drawing [MFC], in mouse and device contexts", "CDC class [MFC], objects", "device contexts [MFC]", "client areas", "CMetaFileDC class [MFC], and OnPrepareDC method [MFC]", "GDI objects [MFC], device contexts", "graphic objects [MFC], device contexts", "frame windows [MFC], device contexts", "metafiles and device contexts", "EndPaint method [MFC]", "printers [MFC], device contexts", "mouse [MFC], drawing and device contexts", "BeginPaint method, CPaintDC", "CPaintDC class [MFC], device context for painting", "windows [MFC], drawing directly into", "client areas, and device context", "device contexts [MFC], CDC class [MFC]", "user interface [MFC], device contexts", "device-independent drawing", "GetDC method and CClientDC class [MFC]", "CClientDC class [MFC], and ReleaseDC method [MFC]", "ReleaseDC method [MFC]", "device contexts [MFC], about device contexts", "drawing [MFC], directly into windows", "painting and device context"] -ms.assetid: d0cd51f1-f778-4c7e-bf50-d738d10433c7 --- # Device Contexts +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A device context is a Windows data structure containing information about the drawing attributes of a device such as a display or a printer. All drawing calls are made through a device-context object, which encapsulates the Windows APIs for drawing lines, shapes, and text. Device contexts allow device-independent drawing in Windows. Device contexts can be used to draw to the screen, to the printer, or to a metafile. [CPaintDC](reference/cpaintdc-class.md) objects encapsulate the common idiom of Windows, calling the `BeginPaint` function, then drawing in the device context, then calling the `EndPaint` function. The `CPaintDC` constructor calls `BeginPaint` for you, and the destructor calls `EndPaint`. The simplified process is to create the [CDC](reference/cdc-class.md) object, draw, and then destroy the `CDC` object. In the framework, much of even this process is automated. In particular, your `OnDraw` function is passed a `CPaintDC` already prepared (via `OnPrepareDC`), and you simply draw into it. It is destroyed by the framework and the underlying device context is released to Windows upon return from the call to your `OnDraw` function. diff --git a/docs/mfc/dialog-bars.md b/docs/mfc/dialog-bars.md index f1d629b751a..269c5c03e94 100644 --- a/docs/mfc/dialog-bars.md +++ b/docs/mfc/dialog-bars.md @@ -3,10 +3,12 @@ description: "Learn more about: Dialog Bars" title: "Dialog Bars" ms.date: "11/19/2018" helpviewer_keywords: ["MFC, control bars", "CDialogBar class [MFC], dialog bars", "control bars [MFC], dialog bars", "dialog bars", "dialog bars [MFC], about dialog bars"] -ms.assetid: 485c8055-6bb0-4051-8417-dd2971499321 --- # Dialog Bars +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A dialog bar is a toolbar, a kind of [control bar](control-bars.md) that can contain any kind of control. Because it has the characteristics of a modeless dialog box, a [CDialogBar](reference/cdialogbar-class.md) object provides a more powerful toolbar. There are several key differences between a toolbar and a `CDialogBar` object. A `CDialogBar` object is created from a dialog-template resource, which you can create with the Visual Studio dialog editor and which can contain any kind of Windows control. The user can tab from control to control. And you can specify an alignment style to align the dialog bar with any part of the parent frame window or even to leave it in place if the parent is resized. The following figure shows a dialog bar with a variety of controls. diff --git a/docs/mfc/dialog-box-classes.md b/docs/mfc/dialog-box-classes.md index 2924f1f55a3..d0bb082decc 100644 --- a/docs/mfc/dialog-box-classes.md +++ b/docs/mfc/dialog-box-classes.md @@ -4,10 +4,12 @@ title: "Dialog Box Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.dialog"] helpviewer_keywords: ["property sheet classes", "dialog box classes", "OLE common dialog classes", "common dialog classes [MFC]", "tab dialog boxes"] -ms.assetid: db75da23-4eff-4c6c-beae-79cf046fbce9 --- # Dialog Box Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Class `CDialog` and its derived classes encapsulate dialog-box functionality. Since a dialog box is a special kind of window, `CDialog` is derived from `CWnd`. Derive your dialog classes from `CDialog` or use one of the common dialog classes for standard dialog boxes, such as opening or saving a file, printing, selecting a font or color, initiating a search-and-replace operation, or performing various OLE-related operations. [CDialog](reference/cdialog-class.md)
diff --git a/docs/mfc/dialog-box-components-in-the-framework.md b/docs/mfc/dialog-box-components-in-the-framework.md index 84a07119c71..3f47a6a863e 100644 --- a/docs/mfc/dialog-box-components-in-the-framework.md +++ b/docs/mfc/dialog-box-components-in-the-framework.md @@ -3,10 +3,12 @@ description: "Learn more about: Dialog-Box Components in the Framework" title: "Dialog-Box Components in the Framework" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], creating", "dialog classes [MFC], dialog box components", "MFC dialog boxes [MFC], about MFC dialog boxes", "dialog templates [MFC], MFC framework", "MFC dialog boxes [MFC], dialog resource"] -ms.assetid: 592db160-0a8a-49be-ac72-ead278aca53f --- # Dialog-Box Components in the Framework +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In the MFC framework, a dialog box has two components: - A dialog-template resource that specifies the dialog box's controls and their placement. diff --git a/docs/mfc/dialog-boxes-in-ole.md b/docs/mfc/dialog-boxes-in-ole.md index dbd432b73d1..c9bbb23247c 100644 --- a/docs/mfc/dialog-boxes-in-ole.md +++ b/docs/mfc/dialog-boxes-in-ole.md @@ -3,10 +3,12 @@ description: "Learn more about: Dialog boxes in OLE" title: "Dialog boxes in OLE" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], OLE dialog boxes", "OLE dialog boxes", "dialog boxes", "OLE dialog boxes [MFC], about OLE dialog boxes", "dialog boxes [MFC], about dialog boxes", "dialog boxes [MFC], OLE", "Insert object"] -ms.assetid: 73c41eb8-738a-4d02-9212-d3395bb09a3a --- # Dialog boxes in OLE +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + While a user runs an OLE-enabled application, there are times when the application needs information from the user to carry out the operation. The MFC OLE classes provide default dialog boxes to gather the required information. This article lists the tasks handled by the OLE dialog boxes and the classes needed to display those dialog boxes. For details on OLE dialog boxes and the structures used to customize their behavior, see [MFC Reference](mfc-desktop-applications.md). ## Common dialog boxes diff --git a/docs/mfc/dialog-boxes.md b/docs/mfc/dialog-boxes.md index 52ff46b668e..542ef59b938 100644 --- a/docs/mfc/dialog-boxes.md +++ b/docs/mfc/dialog-boxes.md @@ -3,10 +3,12 @@ description: "Learn more about: Dialog Boxes" title: "Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["modeless dialog boxes [MFC], MFC dialog boxes", "MFC, dialog boxes", "modal dialog boxes [MFC], MFC dialog boxes", "CDialog class [MFC], MFC dialog boxes", "MFC dialog boxes"] -ms.assetid: e4feea1a-8360-4ccb-9b84-507f1ccd9ef3 --- # Dialog Boxes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Applications for Windows frequently communicate with the user through dialog boxes. Class [CDialog](reference/cdialog-class.md) provides an interface for managing dialog boxes, the Visual Studio dialog editor makes it easy to design dialog boxes and create their dialog-template resources, and Code wizards simplify the process of initializing and validating the controls in a dialog box and of gathering the values entered by the user. Dialog boxes contain controls, including: diff --git a/docs/mfc/dialog-data-exchange-and-validation.md b/docs/mfc/dialog-data-exchange-and-validation.md index 7ed85e5f7ed..c8742600b4a 100644 --- a/docs/mfc/dialog-data-exchange-and-validation.md +++ b/docs/mfc/dialog-data-exchange-and-validation.md @@ -3,10 +3,12 @@ description: "Learn more about: Dialog Data Exchange and Validation" title: "Dialog Data Exchange and Validation" ms.date: "11/04/2016" helpviewer_keywords: ["data validation [MFC], dialog boxes", "dialog box data [MFC]", "dialog boxes [MFC], validating data", "validating data [MFC], dialog box data entry", "DDX (dialog data exchange) [MFC], data validation", "dialog box data [MFC], retrieving", "Windows common controls [MFC], dialog boxes", "DDV (dialog data validation) [MFC]", "data [MFC], dialog boxes", "common controls [MFC], dialog boxes", "dialog boxes [MFC], retrieving data", "retrieving dialog box data"] -ms.assetid: 7d373554-7330-43ae-abf1-4bb14e437b4a --- # Dialog Data Exchange and Validation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Dialog data exchange (DDX) is an easy way to initialize the controls in your dialog box and to gather data input by the user. Dialog data validation (DDV) is an easy way to validate data entry in a dialog box. To take advantage of DDX and DDV in your dialog boxes, use the [Add Member Variable Wizard](../ide/adding-a-member-variable-visual-cpp.md#add-member-variable-wizard) to create the data members and set their data types and specify validation rules. ## What do you want to know more about diff --git a/docs/mfc/dialog-data-exchange.md b/docs/mfc/dialog-data-exchange.md index ca1f737fc19..0e039bd13c1 100644 --- a/docs/mfc/dialog-data-exchange.md +++ b/docs/mfc/dialog-data-exchange.md @@ -3,10 +3,12 @@ description: "Learn more about: Dialog Data Exchange" title: "Dialog Data Exchange" ms.date: "11/19/2018" helpviewer_keywords: ["initializing dialog boxes", "canceling data exchange", "dialog box data, retrieving", "DDX (dialog data exchange), data exchange mechanism", "dialog boxes [MFC], initializing", "dialog boxes [MFC], retrieving user input using DDX", "dialog box data", "dialog boxes [MFC], data exchange", "CDataExchange class [MFC], using DDX", "DoDataExchange method [MFC]", "user input [MFC], retrieving from MFC dialog boxes", "capturing user input [MFC]", "transferring dialog box data", "DDX (dialog data exchange), canceling", "UpdateData method [MFC]", "retrieving dialog box data [MFC]"] -ms.assetid: 4675f63b-41d2-45ed-b6c3-235ad8ab924b --- # Dialog Data Exchange +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you use the DDX mechanism, you set the initial values of the dialog object's member variables, typically in your `OnInitDialog` handler or the dialog constructor. Immediately before the dialog is displayed, the framework's DDX mechanism transfers the values of the member variables to the controls in the dialog box, where they appear when the dialog box itself appears in response to `DoModal` or `Create`. The default implementation of `OnInitDialog` in `CDialog` calls the `UpdateData` member function of class `CWnd` to initialize the controls in the dialog box. The same mechanism transfers values from the controls to the member variables when the user clicks the OK button (or whenever you call the `UpdateData` member function with the argument **TRUE**). The dialog data validation mechanism validates any data items for which you specified validation rules. diff --git a/docs/mfc/dialog-data-validation.md b/docs/mfc/dialog-data-validation.md index 0be1815d2cc..9814f2715db 100644 --- a/docs/mfc/dialog-data-validation.md +++ b/docs/mfc/dialog-data-validation.md @@ -3,10 +3,12 @@ description: "Learn more about: Dialog Data Validation" title: "Dialog Data Validation" ms.date: "11/04/2016" helpviewer_keywords: ["validating data [MFC], message boxes", "data validation [MFC], dialog boxes", "dialog boxes [MFC], validating data", "validating data [MFC], dialog box data entry", "DDV (dialog data validation) [MFC]", "data validation [MFC], message boxes"] -ms.assetid: f070c309-2044-4ff2-8c92-1ec1ea84af58 --- # Dialog Data Validation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can specify validation in addition to data exchange by calling DDV functions, as shown in the example in [Dialog Data Exchange](dialog-data-exchange.md). The `DDV_MaxChars` call in the example validates that the string entered in the text-box control is not longer than 20 characters. The DDV function typically alerts the user with a message box if the validation fails and puts the focus on the offending control so the user can reenter the data. A DDV function for a given control must be called immediately after the DDX function for the same control. You can also define your own custom DDX and DDV routines. For details on this and other aspects of DDX and DDV, see [MFC Technical Note 26](tn026-ddx-and-ddv-routines.md). diff --git a/docs/mfc/dialog-sample-list.md b/docs/mfc/dialog-sample-list.md index f68785df172..cc8169fc3c6 100644 --- a/docs/mfc/dialog-sample-list.md +++ b/docs/mfc/dialog-sample-list.md @@ -3,10 +3,12 @@ description: "Learn more about: Dialog Sample List" title: "Dialog Sample List" ms.date: "11/04/2016" helpviewer_keywords: ["sample applications [MFC], dialog boxes"] -ms.assetid: 3fc7dd7c-d758-4c43-96bb-0ea638ca1ad7 --- # Dialog Sample List +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + See the following sample programs that illustrate dialog boxes and property sheets: *MDI Sample Application with Dialog Boxes* diff --git a/docs/mfc/do-i-have-to-derive-new-classes-from-cobject-q.md b/docs/mfc/do-i-have-to-derive-new-classes-from-cobject-q.md index 4881b3a4054..9e391415b09 100644 --- a/docs/mfc/do-i-have-to-derive-new-classes-from-cobject-q.md +++ b/docs/mfc/do-i-have-to-derive-new-classes-from-cobject-q.md @@ -3,10 +3,12 @@ description: "Learn more about: Do I Have to Derive New Classes from CObject?" title: "Do I Have to Derive New Classes from CObject?" ms.date: "11/04/2016" helpviewer_keywords: ["derived classes [MFC], from CObject", "CObject class [MFC], when to use"] -ms.assetid: 26021031-feaf-424c-80d1-9547c4409d6a --- # Do I Have to Derive New Classes from CObject? +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + No, you don't. Derive a class from [CObject](reference/cobject-class.md) when you need the facilities it provides, such as serialization or dynamic creatability. Many data classes need to be serialized to files, so it's often a good idea to derive them from `CObject`. For an example of a class derived from `CObject`, see the [Scribble sample](../overview/visual-cpp-samples.md). diff --git a/docs/mfc/docking-and-floating-toolbars.md b/docs/mfc/docking-and-floating-toolbars.md index 2dc9f54a2a7..ed02a6e6554 100644 --- a/docs/mfc/docking-and-floating-toolbars.md +++ b/docs/mfc/docking-and-floating-toolbars.md @@ -4,11 +4,13 @@ title: "Docking and Floating Toolbars" ms.date: "11/04/2016" f1_keywords: ["CBRS_SIZE_DYNAMIC", "CBRS_SIZE_FIXED"] helpviewer_keywords: ["size [MFC], toolbars", "size", "frame windows [MFC], toolbar docking", "CBRS_ALIGN_ANY constant [MFC]", "palettes, floating", "toolbars [MFC], docking", "CBRS_SIZE_DYNAMIC constant [MFC]", "floating toolbars", "toolbars [MFC], size", "toolbars [MFC], floating", "fixed-size toolbars", "CBRS_SIZE_FIXED constant [MFC]", "toolbar controls [MFC], wrapping", "toolbars [MFC], wrapping", "floating palettes"] -ms.assetid: b7f9f9d4-f629-47d2-a3c4-2b33fa6b51e4 ms.topic: concept-article --- # Docking and Floating Toolbars +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class Library supports dockable toolbars. A dockable toolbar can be attached, or docked, to any side of its parent window, or it can be detached, or floated, in its own mini-frame window. This article explains how to use dockable toolbars in your applications. If you use the Application Wizard to generate the skeleton of your application, you are asked to choose whether you want dockable toolbars. By default, the Application Wizard generates the code that performs the three actions necessary to place a dockable toolbar in your application: diff --git a/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md b/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md index 5ebeea6596b..926435cf6f8 100644 --- a/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md +++ b/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md @@ -3,10 +3,12 @@ description: "Learn more about: Document and View Classes Created by the MFC App title: "Document and View Classes Created by the MFC Application Wizard" ms.date: "11/04/2016" helpviewer_keywords: ["document classes [MFC]", "document classes [MFC], created by application wizards", "application wizards [MFC], document/view classes created", "view classes [MFC], created by application wizards"] -ms.assetid: 70c34a60-2701-4981-acea-c08a5787d8e6 --- # Document and View Classes Created by the MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The MFC Application Wizard gives you a head start on your program development by creating skeletal document and view classes for you. You can then [map commands and messages to these classes](reference/mapping-messages-to-functions.md) and use the Visual Studio source code editor to write their member functions. The document class created by the MFC Application Wizard is derived from class [CDocument](reference/cdocument-class.md). The view class is derived from [CView](reference/cview-class.md). The names that the Application Wizard gives these classes and the files that contain them are based on the project name you supply in the Application Wizard dialog box. In the Application Wizard, you can use the Generated Classes page to alter the default names. diff --git a/docs/mfc/document-classes.md b/docs/mfc/document-classes.md index 7e160a90e8c..85f0ffe26cf 100644 --- a/docs/mfc/document-classes.md +++ b/docs/mfc/document-classes.md @@ -4,10 +4,12 @@ title: "Document Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.document"] helpviewer_keywords: ["document classes [MFC]"] -ms.assetid: 4bf19b02-0a4f-4319-b68e-cddcba2705cb --- # Document Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Document class objects, created by document-template objects, manage the application's data. You will derive a class for your documents from one of these classes. Document class objects interact with view objects. View objects represent the client area of a window, display a document's data, and allow users to interact with it. Documents and views are created by a document-template object. diff --git a/docs/mfc/document-template-classes.md b/docs/mfc/document-template-classes.md index d4eb01a7d6e..ba612259b59 100644 --- a/docs/mfc/document-template-classes.md +++ b/docs/mfc/document-template-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Document-Template Classes" title: "Document-Template Classes" ms.date: "11/04/2016" helpviewer_keywords: ["document templates [MFC], classes"] -ms.assetid: 901749e9-8048-44a0-b5e2-361554650a73 --- # Document-Template Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Document-template objects coordinate the creation of document, view, and frame window objects when a new document or view is created. [CDocTemplate](reference/cdoctemplate-class.md)
diff --git a/docs/mfc/document-template-creation.md b/docs/mfc/document-template-creation.md index 5efdb1673b1..1aab92815f0 100644 --- a/docs/mfc/document-template-creation.md +++ b/docs/mfc/document-template-creation.md @@ -3,10 +3,12 @@ description: "Learn more about: Document Template Creation" title: "Document Template Creation" ms.date: "11/04/2016" helpviewer_keywords: ["document templates [MFC]", "constructors [MFC], document template", "document templates [MFC], creating", "MFC, document templates", "templates [MFC], document templates"] -ms.assetid: c87f1821-7cbf-442e-9690-f126ae7fb783 --- # Document Template Creation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When creating a new document in response to a **New** or **Open** command from the **File** menu, the document template also creates a new frame window through which to view the document. The document-template constructor specifies what types of documents, windows, and views the template will be able to create. This is determined by the arguments you pass to the document-template constructor. The following code illustrates creation of a [CMultiDocTemplate](reference/cmultidoctemplate-class.md) for a sample application: diff --git a/docs/mfc/document-templates-and-the-document-view-creation-process.md b/docs/mfc/document-templates-and-the-document-view-creation-process.md index a768e96d1e7..977df497b81 100644 --- a/docs/mfc/document-templates-and-the-document-view-creation-process.md +++ b/docs/mfc/document-templates-and-the-document-view-creation-process.md @@ -3,10 +3,12 @@ description: "Learn more about: Document Templates and the Document/View Creatio title: "Document Templates and the Document-View Creation Process" ms.date: "11/19/2018" helpviewer_keywords: ["icons, for multiple document templates", "document templates [MFC], and views", "document/view architecture [MFC], creating document/view", "single document template", "MFC, document templates", "multiple document template", "CDocTemplate class [MFC]", "templates [MFC], document templates"] -ms.assetid: 311ce4cd-fbdf-4ea1-a51b-5bb043abbcee --- # Document Templates and the Document/View Creation Process +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To manage the complex process of creating documents with their associated views and frame windows, the framework uses two document template classes: [CSingleDocTemplate](reference/csingledoctemplate-class.md) for SDI applications and [CMultiDocTemplate](reference/cmultidoctemplate-class.md) for MDI applications. A `CSingleDocTemplate` can create and store one document of one type at a time. A `CMultiDocTemplate` keeps a list of many open documents of one type. Some applications support multiple document types. For example, an application might support text documents and graphics documents. In such an application, when the user chooses the New command on the File menu, a dialog box shows a list of possible new document types to open. For each supported document type, the application uses a distinct document template object. The following figure illustrates the configuration of an MDI application that supports two document types and shows several open documents. diff --git a/docs/mfc/document-view-architecture.md b/docs/mfc/document-view-architecture.md index 1f09850246f..e782f90ac5b 100644 --- a/docs/mfc/document-view-architecture.md +++ b/docs/mfc/document-view-architecture.md @@ -3,10 +3,12 @@ description: "Learn more about: Document/View Architecture" title: "Document-View Architecture" ms.date: "11/19/2018" helpviewer_keywords: ["CView class [MFC], view architecture", "CDocument class [MFC]", "MFC, views", "views [MFC], MFC document/view model", "document objects [MFC]", "document objects [MFC], MFC document/view model", "MFC, documents", "documents [MFC], MFC document/view model", "document objects [MFC], document/view architecture"] -ms.assetid: 6127768a-553f-462a-b01b-a5ee6068c81e --- # Document/View Architecture +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + By default, the MFC Application Wizard creates an application skeleton with a document class and a view class. MFC separates data management into these two classes. The document stores the data and manages printing the data and coordinates updating multiple views of the data. The view displays the data and manages user interaction with it, including selection and editing. In this model, an MFC document object reads and writes data to persistent storage. The document may also provide an interface to the data wherever it resides (such as in a database). A separate view object manages data display, from rendering the data in a window to user selection and editing of data. The view obtains display data from the document and communicates back to the document any data changes. diff --git a/docs/mfc/document-view-creation.md b/docs/mfc/document-view-creation.md index 094a7ff5e85..dbdaa81bd3b 100644 --- a/docs/mfc/document-view-creation.md +++ b/docs/mfc/document-view-creation.md @@ -3,10 +3,12 @@ description: "Learn more about: Document/View Creation" title: "Document-View Creation" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], creating", "views [MFC], and frame windows", "views [MFC], creating", "tables [MFC]", "MFC, views", "document/view architecture [MFC], creating document/view", "object creators", "MFC, documents", "tables [MFC], objects each MFC object creates"] -ms.assetid: bda14f41-ed50-439d-af9e-591174e7dd64 --- # Document/View Creation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The framework supplies implementations of the **New** and **Open** commands (among others) on the **File** menu. Creation of a new document and its associated view and frame window is a cooperative effort among the application object, a document template, the newly created document, and the newly created frame window. The following table summarizes which objects create what. ### Object Creators diff --git a/docs/mfc/document-view-sample-list.md b/docs/mfc/document-view-sample-list.md index c72a073f76c..9bb5f66511c 100644 --- a/docs/mfc/document-view-sample-list.md +++ b/docs/mfc/document-view-sample-list.md @@ -2,10 +2,12 @@ description: "Learn more about: Document/View Sample List" title: "Document-View Sample List" ms.date: "11/04/2016" -ms.assetid: 6f087ce8-2f46-433c-b674-4c110743b289 --- # Document/View Sample List +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + See the following sample programs that illustrate using MFC's document/view architecture in interesting ways: *Document/View Variations* diff --git a/docs/mfc/documents-views-and-the-framework.md b/docs/mfc/documents-views-and-the-framework.md index 4c9fca0aceb..cf396b37ddd 100644 --- a/docs/mfc/documents-views-and-the-framework.md +++ b/docs/mfc/documents-views-and-the-framework.md @@ -3,10 +3,12 @@ title: "Documents, views, and the Microsoft Foundation Class (MFC) library frame description: "A description of documents and views in the Microsoft Foundation Class (MFC) library." ms.date: "09/25/2020" helpviewer_keywords: ["document templates [MFC], template objects", "applications [MFC]", "MFC, application framework", "application objects [MFC], relation to other MFC objects", "documents [MFC]", "MFC, documents", "document objects [MFC], in relation to other MFC objects", "view objects [MFC], relation to other MFC objects", "MFC, views", "document/view architecture [MFC], about document/view architecture", "objects [MFC], MFC applications", "MFC object relationships", "thread objects [MFC]"] -ms.assetid: 409ddd9b-66ad-4625-84f7-bf55a41d697b --- # Documents, views, and the framework +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + At the heart of the MFC framework are the concepts of document and view. A document is a data object with which the user interacts in an editing session. It's created by the **New** or **Open** command on the **File** menu and is typically saved in a file. (Standard MFC documents, derived from class `CDocument`, are different from Active documents and OLE compound documents.) A view is a window object through which the user interacts with a document. The key objects in a running application are: diff --git a/docs/mfc/drag-and-drop-ole.md b/docs/mfc/drag-and-drop-ole.md index 3e7d26ae827..f87bbd28647 100644 --- a/docs/mfc/drag-and-drop-ole.md +++ b/docs/mfc/drag-and-drop-ole.md @@ -3,10 +3,12 @@ title: "OLE drag and drop" description: "Overview of Microsoft Foundation Classes (MFC) OLE drag and drop, how to implement a drop source, a drop target, and how to customize drag and drop." ms.date: "02/09/2020" helpviewer_keywords: ["OLE server applications [MFC], drag and drop", "drag and drop [MFC]", "OLE applications [MFC], drag and drop", "File Manager drag and drop support [MFC]", "drag and drop [MFC], about OLE drag and drop", "OLE drag and drop [MFC]", ] -ms.assetid: a4595350-ca06-4400-88a1-f0175c76b77b --- # OLE drag and drop +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The drag-and-drop feature of OLE is primarily a shortcut for copying and pasting data. When you use the Clipboard to copy or paste data, a number of steps are required. You select the data, and choose **Cut** or **Copy** from the **Edit** menu. Then you move to the destination app or window, and place the cursor in the target location. Finally, you choose **Edit** > **Paste** from the menu. The OLE drag-and-drop feature is different from the File Manager drag-and-drop mechanism. The File Manager can only handle filenames, and is designed specifically to pass filenames to applications. Drag and drop in OLE is much more general. It allows you to drag and drop any data that could also be placed on the Clipboard. diff --git a/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md b/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md index f3ecc1650ed..d59c75f98b1 100644 --- a/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md +++ b/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md @@ -3,11 +3,13 @@ description: "Learn more about: Dragging and Dropping Files in a Frame Window" title: "Dragging and Dropping Files in a Frame Window" ms.date: "11/04/2016" helpviewer_keywords: ["drag and drop [MFC], files", "drag and drop [MFC], File Manager", "Windows Explorer [MFC]", "File Manager drag and drop support [MFC]", "files [MFC], drag and drop", "frame windows [MFC], dragging and dropping files in", "drag and drop [MFC], Windows Explorer"] -ms.assetid: 85560fe9-121b-4105-bd7b-216b966e19fa ms.topic: concept-article --- # Dragging and Dropping Files in a Frame Window +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The frame window manages a relationship with File Explorer or File Manager. By adding a few initializing calls in your override of the `CWinApp` member function `InitInstance`, as described in [CWinApp: The Application Class](cwinapp-the-application-class.md), you can have your frame window indirectly open files dragged from File Explorer or File Manager and dropped in the frame window. See [File Manager Drag and Drop](special-cwinapp-services.md). diff --git a/docs/mfc/dragging-images-from-an-image-list.md b/docs/mfc/dragging-images-from-an-image-list.md index ecea5051da3..3d782945ac2 100644 --- a/docs/mfc/dragging-images-from-an-image-list.md +++ b/docs/mfc/dragging-images-from-an-image-list.md @@ -3,11 +3,13 @@ description: "Learn more about: Dragging Images from an Image List" title: "Dragging Images from an Image List" ms.date: "11/04/2016" helpviewer_keywords: ["CImageList class [MFC], dragging images from", "dragging images from image lists [MFC]", "image lists [MFC], dragging images from", "images [MFC], dragging from image lists"] -ms.assetid: af691db8-e4f0-4046-b7b9-9acc68d3713d ms.topic: concept-article --- # Dragging Images from an Image List +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + [CImageList](reference/cimagelist-class.md) includes functions for dragging an image on the screen. The dragging functions move an image smoothly, in color, and without any flashing of the cursor. Both masked and unmasked images can be dragged. The [BeginDrag](reference/cimagelist-class.md#begindrag) member function begins a drag operation. The parameters include the index of the image to drag and the location of the hot spot within the image. The hot spot is a single pixel that the dragging functions recognize as the exact screen location of the image. Typically, an application sets the hot spot so that it coincides with the hot spot of the mouse cursor. The [DragMove](reference/cimagelist-class.md#dragmove) member function moves the image to a new location. diff --git a/docs/mfc/drawing-and-printing-classes.md b/docs/mfc/drawing-and-printing-classes.md index d43f6e9affa..97c8131d852 100644 --- a/docs/mfc/drawing-and-printing-classes.md +++ b/docs/mfc/drawing-and-printing-classes.md @@ -3,11 +3,13 @@ description: "Learn more about: Drawing and Printing Classes" title: "Drawing and Printing Classes" ms.date: "11/04/2016" helpviewer_keywords: ["output [MFC], graphical classes", "drawing [MFC], classes", "printing classes [MFC]", "graphics [MFC], graphical output classes"] -ms.assetid: 2781c599-a038-462a-98ca-634b07ee22b0 ms.topic: concept-article --- # Drawing and Printing Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In Windows, all graphical output is drawn on a virtual drawing area called a device context (DC). MFC provides classes to encapsulate the various types of DCs, as well as encapsulations for Windows drawing tools such as bitmaps, brushes, palettes, and pens. ## See also diff --git a/docs/mfc/drawing-images-from-an-image-list.md b/docs/mfc/drawing-images-from-an-image-list.md index 0f0e5cd6019..a2e7dc7581a 100644 --- a/docs/mfc/drawing-images-from-an-image-list.md +++ b/docs/mfc/drawing-images-from-an-image-list.md @@ -3,11 +3,13 @@ description: "Learn more about: Drawing Images from an Image List" title: "Drawing Images from an Image List" ms.date: "11/04/2016" helpviewer_keywords: ["CImageList class [MFC], drawing images from", "drawing [MFC], images from image lists", "image lists [MFC], drawing images from", "images [MFC], drawing"] -ms.assetid: 2f6063fb-1c28-45f8-a333-008c064db11c ms.topic: concept-article --- # Drawing Images from an Image List +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To draw an image, use the [CImageList::Draw](reference/cimagelist-class.md#draw) member function. You'll specify a pointer to a device context object, the index of the image to draw, the location in the device context at which to draw the image, and a set of flags to indicate the drawing style. When you specify the **ILD_TRANSPARENT** style, `Draw` uses a two-step process to draw a masked image. First, it performs a logical-AND operation on the bits of the image and the bits of the mask. Then it performs a logical-XOR operation on the results of the first operation and the background bits of the destination device context. This process creates transparent areas in the resulting image; that is, each white bit in the mask causes the corresponding bit in the resulting image to be transparent. diff --git a/docs/mfc/drawing-in-a-view.md b/docs/mfc/drawing-in-a-view.md index ecd59ea9512..5993704da68 100644 --- a/docs/mfc/drawing-in-a-view.md +++ b/docs/mfc/drawing-in-a-view.md @@ -3,11 +3,13 @@ description: "Learn more about: Drawing in a View" title: "Drawing in a View" ms.date: "11/04/2016" helpviewer_keywords: ["drawing [MFC], in views", "views [MFC], printing", "views [MFC], updating", "printing [MFC], views", "views [MFC], rendering", "printing views [MFC]", "paint messages in view class [MFC]", "device contexts, screen drawings"] -ms.assetid: e3761db6-0f19-4482-a4cd-ac38ef7c4d3a ms.topic: how-to --- # Drawing in a View +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Nearly all drawing in your application occurs in the view's `OnDraw` member function, which you must override in your view class. (The exception is mouse drawing, discussed in [Interpreting User Input Through a View](interpreting-user-input-through-a-view.md).) Your `OnDraw` override: 1. Gets data by calling the document member functions you provide. diff --git a/docs/mfc/drawing-tool-classes.md b/docs/mfc/drawing-tool-classes.md index 0e33ab2346e..05411c8d738 100644 --- a/docs/mfc/drawing-tool-classes.md +++ b/docs/mfc/drawing-tool-classes.md @@ -4,11 +4,13 @@ title: "Drawing Tool Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.drawing"] helpviewer_keywords: ["drawing [MFC], tool classes", "screen output classes [MFC]", "output classes [MFC]"] -ms.assetid: e907bd89-38b5-47c9-b76a-95e0bf3bb41d ms.topic: concept-article --- # Drawing Tool Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes encapsulate drawing tools that are used to draw on a device context. [CGdiObject](reference/cgdiobject-class.md)
diff --git a/docs/mfc/dynamic-layout.md b/docs/mfc/dynamic-layout.md index f92eca0ea56..460b4f46d7f 100644 --- a/docs/mfc/dynamic-layout.md +++ b/docs/mfc/dynamic-layout.md @@ -2,10 +2,12 @@ description: "Learn more about: Dynamic Layout" title: "Dynamic Layout" ms.date: "09/09/2019" -ms.assetid: 8598cfb2-c8d4-4f5a-bf2b-59dc4653e042 --- # Dynamic Layout +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + With MFC in Visual Studio 2015, you can create dialogs that the user can resize, and you can control the way the layout adjusts to the change in size. For example, you can attach buttons at the bottom of a dialog to the bottom edge so they always stay at the bottom. You can also set up certain controls such as listboxes, editboxes, and text fields to expand as the user expands the dialog. ## Specifying dynamic layout settings for an MFC dialog box diff --git a/docs/mfc/dynamic-object-creation.md b/docs/mfc/dynamic-object-creation.md index a7e77c3fe66..e41eb57dc31 100644 --- a/docs/mfc/dynamic-object-creation.md +++ b/docs/mfc/dynamic-object-creation.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["object creation [MFC], dynamically at run time", "CObject --- # Dynamic Object Creation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to create an object dynamically at run time. The procedure uses run-time class information, as discussed in the article [Accessing Run-Time Class Information](accessing-run-time-class-information.md). #### Dynamically create an object given its run-time class diff --git a/docs/mfc/enabling-tool-tips.md b/docs/mfc/enabling-tool-tips.md index 4f59728c5a1..f29d9439621 100644 --- a/docs/mfc/enabling-tool-tips.md +++ b/docs/mfc/enabling-tool-tips.md @@ -3,11 +3,13 @@ description: "Learn more about: Enabling Tool Tips" title: "Enabling Tool Tips" ms.date: "11/04/2016" helpviewer_keywords: ["initializing tool tips [MFC]", "enabling tool tips [MFC]", "tool tips [MFC], initializing", "tool tips [MFC], enabling"] -ms.assetid: 06b7c889-7722-4ce6-8b88-9efa50fe6369 ms.topic: how-to --- # Enabling Tool Tips +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can enable tool tip support for the child controls of a window (such as the controls on a form view or dialog box). ### To enable tool tips for the child controls of a window diff --git a/docs/mfc/example-displaying-a-dialog-box-via-a-menu-command.md b/docs/mfc/example-displaying-a-dialog-box-via-a-menu-command.md index b357a9e58f3..03c56551940 100644 --- a/docs/mfc/example-displaying-a-dialog-box-via-a-menu-command.md +++ b/docs/mfc/example-displaying-a-dialog-box-via-a-menu-command.md @@ -3,10 +3,12 @@ description: "Learn more about: Example: Displaying a Dialog Box via a Menu Comm title: "Example: Displaying a Dialog Box via a Menu Command" ms.date: "09/07/2019" helpviewer_keywords: ["MFC dialog boxes [MFC], examples", "MFC dialog boxes [MFC], displaying", "modeless dialog boxes [MFC], displaying", "dialog boxes [MFC], MFC", "modal dialog boxes [MFC], displaying", "examples [MFC], dialog boxes", "menu items [MFC], examples"] -ms.assetid: e8692549-acd7-478f-9c5e-ba310ce8cccd --- # Example: Displaying a Dialog Box via a Menu Command +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic contains procedures to: - Display a modal dialog box through a menu command. diff --git a/docs/mfc/example-of-active-document-containment-office-binder.md b/docs/mfc/example-of-active-document-containment-office-binder.md index 81ef5fd2faf..e09e13f91c3 100644 --- a/docs/mfc/example-of-active-document-containment-office-binder.md +++ b/docs/mfc/example-of-active-document-containment-office-binder.md @@ -3,10 +3,12 @@ description: "Learn more about: Example of Active Document Containment: Office B title: "Example of Active Document Containment: Office Binder" ms.date: "11/04/2016" helpviewer_keywords: ["active documents [MFC], containers", "examples [MFC], active document containment", "containers [MFC], active document", "active document containers [MFC], examples", "Office Binder [MFC]", "MFC COM, active document containment"] -ms.assetid: 70dd8568-e8bc-44ac-bf5e-678767efe8e3 --- # Example of Active Document Containment: Office Binder +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Office Binder is an example of an active document container. An Office Binder includes two primary panes, as containers typically do. The left pane contains icons that correspond to active documents in the Binder. Each document is called a *section* within the Binder. For example, a Binder can contain Word documents, PowerPoint files, Excel spreadsheets, and so on. Clicking an icon in the left pane activates the corresponding active document. The right pane of the Binder then displays the contents of the currently selected active document. diff --git a/docs/mfc/exception-classes.md b/docs/mfc/exception-classes.md index beaf14841a8..2b4a56ffe2a 100644 --- a/docs/mfc/exception-classes.md +++ b/docs/mfc/exception-classes.md @@ -4,10 +4,12 @@ title: "Exception Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.exception"] helpviewer_keywords: ["exception classes [MFC]", "exception handling [MFC], exception classes", "MFC, exceptions"] -ms.assetid: 1a2caf12-b3e9-4189-86d2-bf7a595bf025 --- # Exception Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The class library provides an exception-handling mechanism based on class `CException`. The application framework uses exceptions in its code; you can also use them in yours. For more information, see the article [Exceptions](exception-handling-in-mfc.md). You can derive your own exception types from `CException`. MFC provides an exception class from which you can derive your own exception as well as exception classes for all of the exceptions it supports. diff --git a/docs/mfc/exception-handling-in-mfc.md b/docs/mfc/exception-handling-in-mfc.md index 29b8e759bf4..e91a99ec97f 100644 --- a/docs/mfc/exception-handling-in-mfc.md +++ b/docs/mfc/exception-handling-in-mfc.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["DAO [MFC], exceptions", "assertions [MFC], When to use ex --- # Exception Handling in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the exception-handling mechanisms available in MFC. Two mechanisms are available: - C++ exceptions, available in MFC version 3.0 and later diff --git a/docs/mfc/exceptions-catching-and-deleting-exceptions.md b/docs/mfc/exceptions-catching-and-deleting-exceptions.md index cd5ef814784..afd5555844f 100644 --- a/docs/mfc/exceptions-catching-and-deleting-exceptions.md +++ b/docs/mfc/exceptions-catching-and-deleting-exceptions.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: Catching and Deleting Exceptions" title: "Exceptions: Catching and Deleting Exceptions" ms.date: "11/04/2016" helpviewer_keywords: ["exceptions [MFC], deleting", "AND_CATCH macro [MFC]", "try-catch exception handling [MFC], catching and deleting exceptions", "exception handling [MFC], catching and deleting exceptions", "catch blocks [MFC], catching and deleting exceptions", "execution [MFC], returns from within catch block"] -ms.assetid: 7c233ff0-89de-4de0-a68a-9e9cdb164311 --- # Exceptions: Catching and Deleting Exceptions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following instructions and examples show you how to catch and delete exceptions. For more information on the **`try`**, **`catch`**, and **`throw`** keywords, see [Modern C++ best practices for exceptions and error handling](../cpp/errors-and-exception-handling-modern-cpp.md). Your exception handlers must delete exception objects they handle, because failure to delete the exception causes a memory leak whenever that code catches an exception. diff --git a/docs/mfc/exceptions-changes-to-exception-macros-in-version-3-0.md b/docs/mfc/exceptions-changes-to-exception-macros-in-version-3-0.md index 0dde24bae2e..9304a90cde0 100644 --- a/docs/mfc/exceptions-changes-to-exception-macros-in-version-3-0.md +++ b/docs/mfc/exceptions-changes-to-exception-macros-in-version-3-0.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: Changes to Exception Macros in Versi title: "Exceptions: Changes to Exception Macros in Version 3.0" ms.date: "11/04/2016" helpviewer_keywords: ["C++ exception handling [MFC], upgrade considerations", "CATCH macro [MFC]", "exceptions [MFC], what's changed", "THROW_LAST macro [MFC]"] -ms.assetid: 3aa20d8c-229e-449c-995c-ab879eac84bc --- # Exceptions: Changes to Exception Macros in Version 3.0 +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This is an advanced topic. In MFC version 3.0 and later, the exception-handling macros have been changed to use C++ exceptions. This article tells how those changes can affect the behavior of existing code that uses the macros. diff --git a/docs/mfc/exceptions-converting-from-mfc-exception-macros.md b/docs/mfc/exceptions-converting-from-mfc-exception-macros.md index 70337d79971..e258734d362 100644 --- a/docs/mfc/exceptions-converting-from-mfc-exception-macros.md +++ b/docs/mfc/exceptions-converting-from-mfc-exception-macros.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: Converting from MFC Exception Macros title: "Exceptions: Converting from MFC Exception Macros" ms.date: "08/27/2018" helpviewer_keywords: ["converting exceptions [MFC]", "exception objects [MFC]", "conversions [MFC], code written with MFC macros", "keywords [MFC], macros", "macrosv, C++ keywords", "exception objects [MFC], deleting", "CException class [MFC], deleting CException class objects", "exceptions [MFC], converting", "exceptions [MFC], deleting exception objects", "catch blocks [MFC], delimiting", "exception handling [MFC], converting exceptions"] -ms.assetid: bd3ac3b3-f3ce-4fdd-a168-a2cff13ed796 --- # Exceptions: Converting from MFC Exception Macros +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This is an advanced topic. This article explains how to convert existing code written with Microsoft Foundation Class macros — **TRY**, **CATCH**, **THROW**, and so on — to use the C++ exception-handling keywords **`try`**, **`catch`**, and **`throw`**. Topics include: diff --git a/docs/mfc/exceptions-database-exceptions.md b/docs/mfc/exceptions-database-exceptions.md index 097ddc2d7ff..ceb25baab4d 100644 --- a/docs/mfc/exceptions-database-exceptions.md +++ b/docs/mfc/exceptions-database-exceptions.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: Database Exceptions" title: "Exceptions: Database Exceptions" ms.date: "09/17/2019" helpviewer_keywords: ["DAO [MFC], exceptions", "exceptions [MFC], database", "exception handling [MFC], databases", "ODBC exceptions [MFC]", "ODBC [MFC], exceptions", "database exceptions [MFC]", "databases [MFC], exception handling", "error codes [MFC], database exception handling"] -ms.assetid: 28daf260-f824-4be6-aecc-1f859e6dec26 --- # Exceptions: Database Exceptions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to handle database exceptions. Most of the material in this article applies whether you are working with the MFC classes for Open Database Connectivity (ODBC) or the MFC classes for Data Access Objects (DAO). Material specific to one or the other model is explicitly marked. Topics include: - [Approaches to exception handling](#_core_approaches_to_exception_handling) diff --git a/docs/mfc/exceptions-examining-exception-contents.md b/docs/mfc/exceptions-examining-exception-contents.md index f2bedc83ebb..ea65efd6985 100644 --- a/docs/mfc/exceptions-examining-exception-contents.md +++ b/docs/mfc/exceptions-examining-exception-contents.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: Examining Exception Contents" title: "Exceptions: Examining Exception Contents" ms.date: "11/04/2016" helpviewer_keywords: ["exception handling [MFC], MFC", "try-catch exception handling [MFC], MFC function exceptions", "catch blocks, MFC function exceptions", "CException class [MFC], class exceptions", "try-catch exception handling [MFC], exception contents", "throwing exceptions [MFC], exception contents"] -ms.assetid: dfda4782-b969-4f60-b867-cc204ea7f33a --- # Exceptions: Examining Exception Contents +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Although a **`catch`** block's argument can be of almost any data type, the MFC functions throw exceptions of types derived from the class `CException`. To catch an exception thrown by an MFC function, then, you write a **`catch`** block whose argument is a pointer to a `CException` object (or an object derived from `CException`, such as `CMemoryException`). Depending on the exact type of the exception, you can examine the data members of the exception object to gather information about the specific cause of the exception. For example, the `CFileException` type has the `m_cause` data member, which contains an enumerated type that specifies the cause of the file exception. Some examples of the possible return values are `CFileException::fileNotFound` and `CFileException::readOnly`. diff --git a/docs/mfc/exceptions-exceptions-in-constructors.md b/docs/mfc/exceptions-exceptions-in-constructors.md index 239bf4c5625..e2d860490cf 100644 --- a/docs/mfc/exceptions-exceptions-in-constructors.md +++ b/docs/mfc/exceptions-exceptions-in-constructors.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: Exceptions in Constructors" title: "Exceptions: Exceptions in Constructors" ms.date: "11/04/2016" helpviewer_keywords: ["constructors [MFC], exceptions", "throwing exceptions [MFC], in constructors", "exceptions [MFC], in constructors"] -ms.assetid: a78eae5a-5821-4b27-9478-1436320ed1e1 --- # Exceptions: Exceptions in Constructors +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When throwing an exception in a constructor, clean up whatever objects and memory allocations you have made prior to throwing the exception, as explained in [Exceptions: Throwing Exceptions from Your Own Functions](exceptions-throwing-exceptions-from-your-own-functions.md). When throwing an exception in a constructor, the memory for the object itself has already been allocated by the time the constructor is called. So, the compiler will automatically deallocate the memory occupied by the object after the exception is thrown. diff --git a/docs/mfc/exceptions-freeing-objects-in-exceptions.md b/docs/mfc/exceptions-freeing-objects-in-exceptions.md index de0c17158d3..f3057b12262 100644 --- a/docs/mfc/exceptions-freeing-objects-in-exceptions.md +++ b/docs/mfc/exceptions-freeing-objects-in-exceptions.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: Freeing Objects in Exceptions" title: "Exceptions: Freeing Objects in Exceptions" ms.date: "11/04/2016" helpviewer_keywords: ["throwing exceptions [MFC], freeing objects in exceptions", "local exception handling", "memory leaks, caused by exception", "try-catch exception handling [MFC], destroying objects", "destroying objects [MFC]", "freeing objects [MFC]", "throwing exceptions [MFC], after destroying", "exception handling [MFC], destroying objects"] -ms.assetid: 3b14b4ee-e789-4ed2-b8e3-984950441d97 --- # Exceptions: Freeing Objects in Exceptions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the need and the method of freeing objects when an exception occurs. Topics include: - [Handling the exception locally](#_core_handling_the_exception_locally) diff --git a/docs/mfc/exceptions-ole-exceptions.md b/docs/mfc/exceptions-ole-exceptions.md index edf6080508e..0f58a8466ee 100644 --- a/docs/mfc/exceptions-ole-exceptions.md +++ b/docs/mfc/exceptions-ole-exceptions.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: OLE Exceptions" title: "Exceptions: OLE Exceptions" ms.date: "11/04/2016" helpviewer_keywords: ["OLE, exceptions", "OLE exceptions [MFC]", "exceptions [MFC], OLE", "exception handling [MFC], OLE", "OLE exceptions [MFC], classes for handling"] -ms.assetid: 2f8e0161-b94f-48bb-a5a2-6f644b192527 --- # Exceptions: OLE Exceptions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The techniques and facilities for handling exceptions in OLE are the same as those for handling other exceptions. For further information on exception handling, see the article [Modern C++ best practices for exceptions and error handling](../cpp/errors-and-exception-handling-modern-cpp.md). All exception objects are derived from the abstract base class `CException`. MFC provides two classes for handling OLE exceptions: diff --git a/docs/mfc/exceptions-throwing-exceptions-from-your-own-functions.md b/docs/mfc/exceptions-throwing-exceptions-from-your-own-functions.md index acc4fcb8df0..2eeea63f2be 100644 --- a/docs/mfc/exceptions-throwing-exceptions-from-your-own-functions.md +++ b/docs/mfc/exceptions-throwing-exceptions-from-your-own-functions.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: Throwing Exceptions from Your Own Fu title: "Exceptions: Throwing Exceptions from Your Own Functions" ms.date: "11/04/2016" helpviewer_keywords: ["throwing exceptions [MFC], from functions", "functions [MFC], throwing exceptions", "exceptions [MFC], throwing"] -ms.assetid: 492976e8-8804-4234-8e8f-30dffd0501be --- # Exceptions: Throwing Exceptions from Your Own Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + It is possible to use the MFC exception-handling paradigm solely to catch exceptions thrown by functions in MFC or other libraries. In addition to catching exceptions thrown by library code, you can throw exceptions from your own code if you are writing functions that can encounter exceptional conditions. When an exception is thrown, execution of the current function is stopped and jumps directly to the **`catch`** block of the innermost exception frame. The exception mechanism bypasses the normal exit path from a function. Therefore, you must be sure to delete those memory blocks that would be deleted in a normal exit. diff --git a/docs/mfc/exceptions-using-mfc-macros-and-cpp-exceptions.md b/docs/mfc/exceptions-using-mfc-macros-and-cpp-exceptions.md index e8816115764..5a1929373cb 100644 --- a/docs/mfc/exceptions-using-mfc-macros-and-cpp-exceptions.md +++ b/docs/mfc/exceptions-using-mfc-macros-and-cpp-exceptions.md @@ -3,10 +3,12 @@ description: "Learn more about: Exceptions: Using MFC Macros and C++ Exceptions" title: "Exceptions: Using MFC Macros and C++ Exceptions" ms.date: "11/04/2016" helpviewer_keywords: ["exception objects [MFC]", "memory leaks [MFC], exception object not deleted", "exception handling [MFC], MFC", "try-catch exception handling [MFC], mixing MFC macros and C++ keywords", "exception objects [MFC], deleting", "exceptions [MFC], MFC macros vs. C++ keywords", "catch blocks [MFC], mixed", "exception handling [MFC], mixed-language", "nested try blocks [MFC]", "catch blocks [MFC], explicitly deleting code in", "try-catch exception handling [MFC], nested try blocks", "heap corruption [MFC]", "nested catch blocks [MFC]"] -ms.assetid: d664a83d-879b-44d4-bdf0-029f0aca69e9 --- # Exceptions: Using MFC Macros and C++ Exceptions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses considerations for writing code that uses both the MFC exception-handling macros and the C++ exception-handling keywords. This article covers the following topics: diff --git a/docs/mfc/exchanging-data.md b/docs/mfc/exchanging-data.md index 8ea303ddf53..82d3ffc820b 100644 --- a/docs/mfc/exchanging-data.md +++ b/docs/mfc/exchanging-data.md @@ -3,11 +3,13 @@ description: "Learn more about: Exchanging Data" title: "Exchanging Data" ms.date: "11/04/2016" helpviewer_keywords: ["property sheets [MFC], data exchange", "exchanging data with property sheets [MFC]", "DDX (dialog data exchange) [MFC], property sheets"] -ms.assetid: 689f02d0-51a9-455b-8ffb-5b44f0aefa28 ms.topic: concept-article --- # Exchanging Data +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As with most dialog boxes, the exchange of data between the property sheet and the application is one of the most important functions of the property sheet. This article describes how to accomplish this task. Exchanging data with a property sheet is actually a matter of exchanging data with the individual property pages of the property sheet. The procedure for exchanging data with a property page is the same as for exchanging data with a dialog box, since a [CPropertyPage](reference/cpropertypage-class.md) object is just a specialized [CDialog](reference/cdialog-class.md) object. The procedure takes advantage of the framework's dialog data exchange (DDX) facility, which exchanges data between controls in a dialog box and member variables of the dialog box object. diff --git a/docs/mfc/exitinstance-member-function.md b/docs/mfc/exitinstance-member-function.md index 7cf3e1afdee..fe4fa52c6b6 100644 --- a/docs/mfc/exitinstance-member-function.md +++ b/docs/mfc/exitinstance-member-function.md @@ -4,10 +4,12 @@ title: "ExitInstance Member Function" ms.date: "11/04/2016" f1_keywords: [] helpviewer_keywords: ["programs [MFC], terminating", "CWinApp class [MFC], ExitInstance", "ExitInstance method [MFC]"] -ms.assetid: 5bb597bd-8dab-4d49-8bcf-9c45aa8be4a2 --- # ExitInstance Member Function +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [ExitInstance](reference/cwinapp-class.md#exitinstance) member function of class [CWinApp](reference/cwinapp-class.md) is called each time a copy of your application terminates, usually as a result of the user quitting the application. Override `ExitInstance` if you need special cleanup processing, such as freeing graphics device interface (GDI) resources or deallocating memory used during program execution. Cleanup of standard items such as documents and views, however, is provided by the framework, with other overridable functions for doing special cleanup specific to those objects. diff --git a/docs/mfc/exported-dll-function-entry-points.md b/docs/mfc/exported-dll-function-entry-points.md index 0a9cbd7ae47..92c099b46ed 100644 --- a/docs/mfc/exported-dll-function-entry-points.md +++ b/docs/mfc/exported-dll-function-entry-points.md @@ -3,10 +3,12 @@ description: "Learn more about: Exported DLL Function Entry Points" title: "Exported DLL Function Entry Points" ms.date: "11/04/2016" helpviewer_keywords: ["exporting DLLs [MFC], functions", "MFC, managing state data", "state management [MFC], exported DLLs"] -ms.assetid: 3268666e-d24b-44f2-80e8-7c80f73b93ca --- # Exported DLL Function Entry Points +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For exported functions of a DLL, use the [AFX_MANAGE_STATE](reference/extension-dll-macros.md#afx_manage_state) macro to maintain the proper global state when switching from the DLL module to the calling application's DLL. When called, this macro sets `pModuleState`, a pointer to an `AFX_MODULE_STATE` structure containing global data for the module, as the effective module state for the remainder of the containing scope of the function. Upon leaving the scope containing the macro, the previous effective module state is automatically restored. diff --git a/docs/mfc/file-and-database-classes.md b/docs/mfc/file-and-database-classes.md index 0ac75d36c90..59b0f159140 100644 --- a/docs/mfc/file-and-database-classes.md +++ b/docs/mfc/file-and-database-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: File and Database Classes" title: "File and Database Classes" ms.date: "11/04/2016" helpviewer_keywords: ["database classes [MFC], MFC", "database classes [MFC]", "file classes [MFC]"] -ms.assetid: 580b169c-e26e-4395-b128-5408d08c98fe --- # File and Database Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes allow you to store information to a database or a disk file. There are three sets of database classes — OLE DB, ODBC, and DAO — that provide similar functionality. The OLE DB group is implemented using OLE DB and works with the OLE DB consumer templates, the DAO group is implemented using the Data Access Object, and the ODBC group is implemented using Open Database Connectivity. There are also a set of classes for manipulating standard files, Active streams, and HTML streams. The following categories of classes support data persistence. diff --git a/docs/mfc/file-i-o-classes.md b/docs/mfc/file-i-o-classes.md index f9b697305f7..6a988af054b 100644 --- a/docs/mfc/file-i-o-classes.md +++ b/docs/mfc/file-i-o-classes.md @@ -4,10 +4,12 @@ title: "File I-O Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.file"] helpviewer_keywords: ["disk file classes [MFC]", "stdio classes [MFC]", "OLE streams [MFC]", "I/O [MFC], MFC classes", "translated stream classes [MFC]", "file I/O classes [MFC]", "I/O [MFC], classes", "sockets classes [MFC]", "stream classes [MFC]", "memory file classes [MFC]"] -ms.assetid: 92821c3f-d9e1-47f6-98c9-3b632d86e811 --- # File I/O Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes provide an interface to traditional disk files, in-memory files, Active streams, and Windows sockets. All of the classes derived from `CFile` can be used with a `CArchive` object to perform serialization. Use the following classes, particularly `CArchive` and `CFile`, if you write your own input/output processing. Normally you do not need to derive from these classes. If you use the application framework, the default implementations of the **Open** and **Save** commands on the **File** menu will handle file I/O (using class `CArchive`), as long as you override your document's `Serialize` function to supply details about how a document serializes its contents. For more information about the file classes and serialization, see the article [Files in MFC](files-in-mfc.md) and the article [Serialization](serialization-in-mfc.md). diff --git a/docs/mfc/file-menu-in-an-mfc-database-application.md b/docs/mfc/file-menu-in-an-mfc-database-application.md index adfb60edf14..c246ff31b94 100644 --- a/docs/mfc/file-menu-in-an-mfc-database-application.md +++ b/docs/mfc/file-menu-in-an-mfc-database-application.md @@ -3,10 +3,12 @@ description: "Learn more about: File Menu in an MFC Database Application" title: "File Menu in an MFC Database Application" ms.date: "11/04/2016" helpviewer_keywords: ["File menu", "database applications [MFC], File menu commands"] -ms.assetid: 92dafb75-c1b3-4860-80a0-87a83bfc36f2 --- # File Menu in an MFC Database Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you create an MFC database application and don't use serialization, how should you interpret the Open, Close, Save, and Save As commands on the File menu While there are no style guidelines for this question, here are a few suggestions: - Eliminate the File menu's Open command entirely. diff --git a/docs/mfc/files-in-mfc.md b/docs/mfc/files-in-mfc.md index e942e997405..8c6b346b7e6 100644 --- a/docs/mfc/files-in-mfc.md +++ b/docs/mfc/files-in-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Files in MFC" title: "Files in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["serialization [MFC], MFC files", "I/O [MFC], MFC classes", "files [MFC], MFC", "files [MFC], serialization", "binary access, binary file operations in MFC", "file I/O classes [MFC]", "I/O [MFC]", "persistence [MFC]", "MFC, file operations", "files [MFC], manipulating", "binary access [MFC]"] -ms.assetid: ae25e2c5-2859-4679-ab97-438824e93ce1 --- # Files in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In the Microsoft Foundation Class Library (MFC), class [CFile](reference/cfile-class.md) handles normal file I/O operations. This family of articles explains how to open and close files as well as read and write data to those files. It also discusses file status operations. For a description of how to use the object-based serialization features of MFC as an alternative way of reading and writing data in files, see the article [Serialization](serialization-in-mfc.md). > [!NOTE] diff --git a/docs/mfc/form-views-mfc.md b/docs/mfc/form-views-mfc.md index 61a5a4bd8d9..d776257f447 100644 --- a/docs/mfc/form-views-mfc.md +++ b/docs/mfc/form-views-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Form Views (MFC)" title: "Form Views (MFC)" ms.date: "11/04/2016" helpviewer_keywords: ["user interfaces [MFC], forms", "forms [MFC]", "applications [MFC], forms-based", "forms-based applications [MFC]", "forms [MFC], adding to applications"] -ms.assetid: efbe73c1-4ca4-4613-aac2-30d916e92c0e --- # Form Views (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can add forms to any Visual C++ application that supports the MFC libraries, including a [forms-based application](reference/creating-a-forms-based-mfc-application.md) (one whose view class is derived from `CFormView`). If you did not initially create your application to support forms, Visual Studio will add this support for you when you insert a new form. In an SDI or MDI application, which implements the default [document/view architecture](document-view-architecture.md), when the user chooses the **New** command (by default, on the **File** menu), Visual Studio prompts the user to choose from the available forms. With an SDI application, when the user chooses the **New** command, the current instance of the form continues to run but a new instance of the application with the selected form is created if one is not found. In an MDI application, the current instance of the form continues to run when the user chooses the **New** command. diff --git a/docs/mfc/frame-window-classes-architecture.md b/docs/mfc/frame-window-classes-architecture.md index 9ec58fb318a..0ce3de51c25 100644 --- a/docs/mfc/frame-window-classes-architecture.md +++ b/docs/mfc/frame-window-classes-architecture.md @@ -3,10 +3,12 @@ description: "Learn more about: Frame Window Classes (Architecture)" title: "Frame Window Classes (Architecture)" ms.date: "11/04/2016" helpviewer_keywords: ["frame window classes [MFC], document/view architecture"] -ms.assetid: 5da01fb4-f531-46cc-914f-e422e4f07f5d --- # Frame Window Classes (Architecture) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In document/view architecture, frame windows are windows that contain a view window. They also support having control bars attached to them. In multiple document interface (MDI) applications, the main window is derived from `CMDIFrameWnd`. It indirectly contains the documents' frames, which are `CMDIChildWnd` objects. The `CMDIChildWnd` objects, in turn, contain the documents' views. diff --git a/docs/mfc/frame-window-classes-created-by-the-application-wizard.md b/docs/mfc/frame-window-classes-created-by-the-application-wizard.md index 746bebc3b4e..d6ff9610d4c 100644 --- a/docs/mfc/frame-window-classes-created-by-the-application-wizard.md +++ b/docs/mfc/frame-window-classes-created-by-the-application-wizard.md @@ -4,10 +4,12 @@ title: "Frame-Window Classes Created by the Application Wizard" ms.date: "11/04/2016" f1_keywords: ["CMainFrame"] helpviewer_keywords: ["application wizards [MFC], frame window classes created by", "window classes [MFC]", "classes [MFC], frame-window", "CMDIFrameWnd class [MFC], frame windows", "window classes [MFC], frame", "CFrameWnd class [MFC], frame windows", "CMDIChildWnd class [MFC], frame windows", "frame window classes [MFC], created by application wizards", "CMainFrame class [MFC]"] -ms.assetid: 9947df73-4470-49a0-ac61-7b6ee401a74e --- # Frame-Window Classes Created by the Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you to create a new MFC project from the **New Project** dialog, in addition to application, document, and view classes, the Application Wizard creates a derived frame-window class for your application's main frame window. The class is called `CMainFrame` by default, and the files that contain it are named MAINFRM.H and MAINFRM.CPP. If your application is SDI, your `CMainFrame` class is derived from class [CFrameWnd](reference/cframewnd-class.md). diff --git a/docs/mfc/frame-window-classes-windows.md b/docs/mfc/frame-window-classes-windows.md index 0f875746e21..ee535bfbb9d 100644 --- a/docs/mfc/frame-window-classes-windows.md +++ b/docs/mfc/frame-window-classes-windows.md @@ -4,10 +4,12 @@ title: "Frame Window Classes (Windows)" ms.date: "11/04/2016" f1_keywords: ["vc.classes.frame"] helpviewer_keywords: ["frame window classes [MFC], reference"] -ms.assetid: 6342ec5f-f922-4da8-a78e-2f5f994c7142 --- # Frame Window Classes (Windows) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Frame windows are windows that frame an application or a part of an application. Frame windows usually contain other windows, such as views, tool bars, and status bars. In the case of `CMDIFrameWnd`, they may contain `CMDIChildWnd` objects indirectly. [CFrameWnd](reference/cframewnd-class.md)
diff --git a/docs/mfc/frame-window-classes.md b/docs/mfc/frame-window-classes.md index b0c19b7b4d5..6b3ddcc18b3 100644 --- a/docs/mfc/frame-window-classes.md +++ b/docs/mfc/frame-window-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Frame-Window Classes" title: "Frame-Window Classes" ms.date: "11/04/2016" helpviewer_keywords: ["frame window classes [MFC], about frame window classes", "frame window classes [MFC]", "windows [MFC], MDI", "document frame windows [MFC], classes", "single document interface (SDI), frame windows", "window classes [MFC], frame", "MFC, frame windows", "MDI [MFC], frame windows", "classes [MFC], window"] -ms.assetid: c27e43a7-8ad0-4759-b1b7-43f4725f4132 --- # Frame-Window Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Each application has one "main frame window," a desktop window that usually has the application name in its caption. Each document usually has one "document frame window." A document frame window contains at least one view, which presents the document's data. ## Frame Windows in SDI and MDI Applications diff --git a/docs/mfc/frame-window-styles-cpp.md b/docs/mfc/frame-window-styles-cpp.md index 68735c8e2b4..8a8c08fbcb7 100644 --- a/docs/mfc/frame-window-styles-cpp.md +++ b/docs/mfc/frame-window-styles-cpp.md @@ -3,10 +3,12 @@ description: "Learn more about: Frame-Window Styles (C++)" title: "Frame-Window Styles (C++)" ms.date: "11/04/2016" helpviewer_keywords: ["window styles [MFC]", "PreCreateWindow method, setting window styles", "windows [MFC], MFC", "frame windows [MFC], styles", "MFC, frame windows", "styles [MFC], windows"] -ms.assetid: fc5058c1-eec8-48d8-9f76-3fc01cfa53f7 --- # Frame-Window Styles (C++) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The frame windows you get with the framework are suitable for most programs, but you can gain additional flexibility by using the advanced functions [PreCreateWindow](reference/cwnd-class.md#precreatewindow) and the MFC global function [AfxRegisterWndClass](reference/application-information-and-management.md#afxregisterwndclass). `PreCreateWindow` is a member function of `CWnd`. If you apply the **WS_HSCROLL** and **WS_VSCROLL** styles to the main frame window, they are instead applied to the **MDICLIENT** window so users can scroll the **MDICLIENT** area. diff --git a/docs/mfc/frame-windows.md b/docs/mfc/frame-windows.md index 8c8089e2eac..1bd2f9d2309 100644 --- a/docs/mfc/frame-windows.md +++ b/docs/mfc/frame-windows.md @@ -3,10 +3,12 @@ description: "Learn more about: Frame Windows" title: "Frame Windows" ms.date: "11/19/2018" helpviewer_keywords: ["document frame windows [MFC]", "windows [MFC], MDI", "window classes [MFC], frame", "single document interface (SDI) [MFC]", "single document interface (SDI) [MFC], frame windows", "views [MFC], and frame windows", "CFrameWnd class [MFC], frame windows", "frame windows [MFC]", "frame windows [MFC], about frame windows", "MFC, frame windows", "MDI [MFC], frame windows", "splitter windows [MFC], and frame windows"] -ms.assetid: 40677339-8135-4f5e-aba6-3fced3078077 --- # Frame Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When an application runs under Windows, the user interacts with documents displayed in frame windows. A document frame window has two major components: the frame and the contents that it frames. A document frame window can be a [single document interface](sdi-and-mdi.md) (SDI) frame window or a [multiple document interface](sdi-and-mdi.md) (MDI) child window. Windows manages most of the user's interaction with the frame window: moving and resizing the window, closing it, and minimizing and maximizing it. You manage the contents inside the frame. ## Frame Windows and Views From 77a8e7d8972e057743ec96ee8b3a81f47d3fde9f Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 20 Feb 2026 12:51:34 -0800 Subject: [PATCH 1637/1799] Batch 3: update files (#6256) --- docs/mfc/framework-mfc.md | 4 +++- docs/mfc/general-class-design-philosophy.md | 4 +++- docs/mfc/general-mfc-topics.md | 4 +++- docs/mfc/general-window-creation-sequence.md | 4 +++- docs/mfc/global-hot-keys.md | 4 +++- docs/mfc/graphic-objects.md | 4 +++- docs/mfc/handlers-for-commands-and-control-notifications.md | 4 +++- docs/mfc/handlers-for-message-map-ranges.md | 4 +++- docs/mfc/handlers-for-standard-windows-messages.md | 4 +++- docs/mfc/handling-commands-in-the-document.md | 4 +++- docs/mfc/handling-customization-notifications.md | 4 +++- docs/mfc/handling-reflected-messages.md | 4 +++- docs/mfc/handling-the-apply-button.md | 4 +++- docs/mfc/handling-tool-tip-notifications.md | 4 +++- docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md | 4 +++- docs/mfc/handling-windows-messages-in-your-dialog-box.md | 4 +++- docs/mfc/header-control-and-list-control.md | 4 +++- docs/mfc/header-control-examples.md | 4 +++- docs/mfc/header-items-in-a-header-control.md | 4 +++- docs/mfc/headers-and-footers.md | 4 +++- docs/mfc/help-menu-merging.md | 4 +++- docs/mfc/hierarchy-chart-categories.md | 4 +++- docs/mfc/hierarchy-chart.md | 4 +++- docs/mfc/how-default-printing-is-done.md | 4 +++- ...-makes-it-easier-to-create-internet-client-applications.md | 4 +++- docs/mfc/how-noncommand-messages-reach-their-handlers.md | 4 +++- docs/mfc/how-the-framework-calls-a-handler.md | 4 +++- docs/mfc/how-the-framework-calls-your-code.md | 4 +++- docs/mfc/how-the-framework-searches-message-maps.md | 4 +++- docs/mfc/how-to-add-restart-manager-support.md | 4 +++- docs/mfc/how-to-add-ribbon-controls-and-event-handlers.md | 4 +++- ...-to-convert-an-existing-mfc-ribbon-to-a-ribbon-resource.md | 4 +++- docs/mfc/how-to-create-a-message-map-for-a-template-class.md | 4 +++- docs/mfc/how-to-customize-the-application-button.md | 4 +++- docs/mfc/how-to-customize-the-quick-access-toolbar.md | 4 +++- .../how-to-display-command-information-in-the-status-bar.md | 4 +++- docs/mfc/how-to-implement-tracking-in-your-code.md | 4 +++- .../how-to-load-a-ribbon-resource-from-an-mfc-application.md | 4 +++- docs/mfc/how-to-make-a-type-safe-collection.md | 4 +++- docs/mfc/how-to-update-user-interface-objects.md | 4 +++- ...-makes-it-easier-to-create-internet-client-applications.md | 4 +++- docs/mfc/html-basics.md | 4 +++- .../mfc/html-help-context-sensitive-help-for-your-programs.md | 4 +++- docs/mfc/idle-loop-processing.md | 4 +++- docs/mfc/image-information-in-image-lists.md | 4 +++- docs/mfc/image-overlays-in-image-lists.md | 4 +++- docs/mfc/implementing-working-areas-in-list-controls.md | 4 +++- docs/mfc/initializing-and-cleaning-up-documents-and-views.md | 4 +++- docs/mfc/initializing-documents-and-views.md | 4 +++- docs/mfc/initializing-the-dialog-box.md | 4 +++- docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md | 4 +++- docs/mfc/initinstance-member-function.md | 4 +++- ...nserting-a-control-into-a-control-container-application.md | 4 +++- docs/mfc/inserting-a-form-into-a-project.md | 4 +++- docs/mfc/interface-elements.md | 4 +++- docs/mfc/internet-and-networking-classes.md | 4 +++- docs/mfc/internet-information-by-task.md | 4 +++- docs/mfc/internet-information-by-topic.md | 4 +++- docs/mfc/internet-related-mfc-classes.md | 4 +++- docs/mfc/internet-security-cpp.md | 4 +++- docs/mfc/interpreting-user-input-through-a-view.md | 4 +++- docs/mfc/isolation-of-the-mfc-common-controls-library.md | 4 +++- docs/mfc/keyboard-and-mouse-customization.md | 4 +++- docs/mfc/life-cycle-of-a-dialog-box.md | 4 +++- docs/mfc/list-control-and-list-view.md | 4 +++- docs/mfc/list-items-and-image-lists.md | 4 +++- docs/mfc/making-and-using-controls.md | 4 +++- docs/mfc/making-owner-drawn-header-controls.md | 4 +++- docs/mfc/making-owner-drawn-tabs.md | 4 +++- docs/mfc/managing-data-with-document-data-variables.md | 4 +++- docs/mfc/managing-mdi-child-windows.md | 4 +++- docs/mfc/managing-menus-control-bars-and-accelerators.md | 4 +++- docs/mfc/managing-the-current-view.md | 4 +++- docs/mfc/managing-the-state-data-of-mfc-modules.md | 4 +++- docs/mfc/manipulating-image-lists.md | 4 +++- docs/mfc/manipulating-menus-during-program-execution.md | 4 +++- docs/mfc/manipulating-the-progress-control.md | 4 +++- docs/mfc/manipulating-the-tool-tip-control.md | 4 +++- docs/mfc/mapi-samples.md | 4 +++- docs/mfc/mapi-support-in-mfc.md | 4 +++- docs/mfc/mapi.md | 4 +++- docs/mfc/mapping-messages.md | 4 +++- docs/mfc/mapping-windows-messages-to-your-class.md | 4 +++- docs/mfc/mdi-tabbed-groups.md | 4 +++- docs/mfc/memory-management-examples.md | 4 +++- docs/mfc/memory-management-frame-allocation.md | 4 +++- docs/mfc/memory-management-heap-allocation.md | 4 +++- docs/mfc/memory-management-resizable-memory-blocks.md | 4 +++- docs/mfc/memory-management.md | 4 +++- docs/mfc/menu-sample-list.md | 4 +++- docs/mfc/menus-and-resources-container-additions.md | 4 +++- docs/mfc/menus-and-resources-menu-merging.md | 4 +++- docs/mfc/menus-and-resources-ole.md | 4 +++- docs/mfc/menus-and-resources-server-additions.md | 4 +++- docs/mfc/menus-mfc.md | 4 +++- docs/mfc/message-categories.md | 4 +++- docs/mfc/message-handlers.md | 4 +++- docs/mfc/message-handling-and-command-targets.md | 4 +++- docs/mfc/message-handling-and-mapping.md | 4 +++- docs/mfc/message-sending-and-receiving.md | 4 +++- 100 files changed, 300 insertions(+), 100 deletions(-) diff --git a/docs/mfc/framework-mfc.md b/docs/mfc/framework-mfc.md index 0bd459a85d7..e7db2e8352d 100644 --- a/docs/mfc/framework-mfc.md +++ b/docs/mfc/framework-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Framework (MFC)" title: "Framework (MFC)" ms.date: "09/17/2019" helpviewer_keywords: ["encapsulation [MFC], Win32 API", "MFC, application framework", "wrapper classes [MFC], explained", "Win32 [MFC], API encapsulation by MFC", "application framework [MFC], about MFC application framework", "APIs [MFC], encapsulation by MFC Win32", "encapsulation [MFC]", "Windows API [MFC], encapsulation by MFC", "encapsulated Win32 API [MFC]"] -ms.assetid: 3be0fec8-9843-4119-ae42-ece993ef500b --- # Framework (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Your work with the Microsoft Foundation Class (MFC) Library framework is based largely on a few major classes and several Visual C++ tools. Some classes encapsulate a large portion of the Win32 application programming interface (API). Other classes encapsulate application concepts such as documents, views, and the application itself. Still others encapsulate OLE features and ODBC and DAO data-access functionality. (DAO is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete.) For example, Win32's concept of window is encapsulated by MFC class `CWnd`. That is, a C++ class called `CWnd` encapsulates or "wraps" the `HWND` handle that represents a Windows window. Likewise, class `CDialog` encapsulates Win32 dialog boxes. diff --git a/docs/mfc/general-class-design-philosophy.md b/docs/mfc/general-class-design-philosophy.md index 0057725329e..f38f1d3c423 100644 --- a/docs/mfc/general-class-design-philosophy.md +++ b/docs/mfc/general-class-design-philosophy.md @@ -3,10 +3,12 @@ description: "Learn more about: General Class Design Philosophy" title: "General Class Design Philosophy" ms.date: "11/04/2016" helpviewer_keywords: ["designing classes [MFC]", "MFC, Windows API", "Visual C, Windows API calls", "classes [MFC], MFC class design", "Windows API [MFC], and MFC"] -ms.assetid: e6861ae0-1581-4d9c-9ddf-63f9afcdb913 --- # General Class Design Philosophy +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Microsoft Windows was designed long before the C++ language became popular. Because thousands of applications use the C-language Windows application programming interface (API), that interface will be maintained for the foreseeable future. Any C++ Windows interface must therefore be built on top of the procedural C-language API. This guarantees that C++ applications will be able to coexist with C applications. The Microsoft Foundation Class Library is an object-oriented interface to Windows that meets the following design goals: diff --git a/docs/mfc/general-mfc-topics.md b/docs/mfc/general-mfc-topics.md index d1164397dce..2f263111a30 100644 --- a/docs/mfc/general-mfc-topics.md +++ b/docs/mfc/general-mfc-topics.md @@ -3,10 +3,12 @@ description: "Learn more about: General MFC Topics" title: "General MFC Topics" ms.date: "09/17/2019" helpviewer_keywords: ["MFC", "class libraries [MFC], MFC", "MFC, application development"] -ms.assetid: 617e9945-9bb3-471d-a3ba-e235fcfb55d1 --- # General MFC Topics +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This family of articles includes technical details about the Microsoft Foundation Class (MFC) Library and provides an overview of the MFC framework and its key components and subsystems. The Microsoft Foundation Class Library is an application framework for programming in Microsoft Windows. Written in C++, MFC provides much of the code necessary for managing windows, menus, and dialog boxes; performing basic input/output; storing collections of data objects; and so on. All you need to do is add your application-specific code into this framework. Given the nature of C++ class programming, it is easy to extend or override the basic functionality that [the MFC framework](framework-mfc.md) supplies. diff --git a/docs/mfc/general-window-creation-sequence.md b/docs/mfc/general-window-creation-sequence.md index ae89ab7bece..b8c0f220f2c 100644 --- a/docs/mfc/general-window-creation-sequence.md +++ b/docs/mfc/general-window-creation-sequence.md @@ -3,10 +3,12 @@ description: "Learn more about: General Window Creation Sequence" title: "General Window Creation Sequence" ms.date: "11/04/2016" helpviewer_keywords: ["sequence [MFC], window creation", "frame windows [MFC], creating", "windows [MFC], creating", "sequence [MFC]"] -ms.assetid: 9cd8c7ea-5e24-429e-b6d9-d7b6041d8ba6 --- # General Window Creation Sequence +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you create a window of your own, such as a child window, the framework uses much the same process as that described in [Document/View Creation](document-view-creation.md). All the window classes provided by MFC employ [two-stage construction](one-stage-and-two-stage-construction-of-objects.md). That is, during an invocation of the C++ **`new`** operator, the constructor allocates and initializes a C++ object but does not create a corresponding Windows window. That is done afterward by calling the [Create](reference/cwnd-class.md#create) member function of the window object. diff --git a/docs/mfc/global-hot-keys.md b/docs/mfc/global-hot-keys.md index 004ba568eab..4387b3750b4 100644 --- a/docs/mfc/global-hot-keys.md +++ b/docs/mfc/global-hot-keys.md @@ -3,10 +3,12 @@ description: "Learn more about: Global Hot Keys" title: "Global Hot Keys" ms.date: "11/04/2016" helpviewer_keywords: ["keyboard shortcuts [MFC], hot keys", "CHotKeyCtrl class [MFC], global hot keys", "access keys [MFC], hot keys", "global hot keys [MFC]"] -ms.assetid: e0b95d14-c571-4c9a-9cd1-e7fc1f0e278d --- # Global Hot Keys +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A global hot key is associated with a particular nonchild window. It allows the user to activate the window from any part of the system. An application sets a global hot key for a particular window by sending the [WM_SETHOTKEY](/windows/win32/inputdev/wm-sethotkey) message to that window. For instance, if `m_HotKeyCtrl` is the [CHotKeyCtrl](reference/chotkeyctrl-class.md) object and `pMainWnd` is a pointer to the window to be activated when the hot key is pressed, you could use the following code to associate the hot key specified in the control with the window pointed to by `pMainWnd`. [!code-cpp[NVC_MFCControlLadenDialog#18](codesnippet/cpp/global-hot-keys_1.cpp)] diff --git a/docs/mfc/graphic-objects.md b/docs/mfc/graphic-objects.md index 5d7445e9f6e..196ecb4edba 100644 --- a/docs/mfc/graphic-objects.md +++ b/docs/mfc/graphic-objects.md @@ -4,10 +4,12 @@ title: "Graphic Objects" ms.date: "11/04/2016" f1_keywords: ["HRGN", "HFONT", "HBITMAP"] helpviewer_keywords: ["CRgn class [MFC], HRGN handle type", "HPEN [MFC]", "objects [MFC], graphic", "palettes [MFC], creating in device context", "pens [MFC], creating in device context", "bitmaps [MFC], creating in device contexts", "palette objects [MFC]", "memory [MFC], display contexts", "MFC, graphic objects", "regions [MFC], creating in device context", "CPen class [MFC], HPEN handle type", "GDI objects [MFC]", "HRGN [MFC]", "graphic objects [MFC]", "GDI objects [MFC], graphic-object classes", "CFont class [MFC], HFONT handle type", "HFONT and class CFont [MFC]", "HBITMAP and class CBitmap [MFC]", "fonts [MFC], creating in device context", "images [MFC], graphic objects [MFC]", "CBitmap class [MFC], HBITMAP handle type", "HPALETTE and class CPalette [MFC]", "CBrush class [MFC], HBRUSH handle type", "objects [MFC], graphic objects", "drawing [MFC], in device contexts", "device contexts [MFC], graphic objects [MFC]", "brushes [MFC], creating in device context", "region objects [MFC]", "pen objects [MFC]", "GDI [MFC], graphic-object classes", "graphic objects [MFC], creating in device context", "HBRUSH and class CBrush [MFC]", "painting and device context [MFC]", "CPalette class [MFC], HPALETTE handle type"] -ms.assetid: 41963b25-34b7-4343-8446-34ba516b83ca --- # Graphic Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Windows provides a variety of drawing tools to use in device contexts. It provides pens to draw lines, brushes to fill interiors, and fonts to draw text. MFC provides graphic-object classes equivalent to the drawing tools in Windows. The table below shows the available classes and the equivalent Windows graphics device interface (GDI) handle types. > [!NOTE] diff --git a/docs/mfc/handlers-for-commands-and-control-notifications.md b/docs/mfc/handlers-for-commands-and-control-notifications.md index 739d0f6dcf0..dda508b3e70 100644 --- a/docs/mfc/handlers-for-commands-and-control-notifications.md +++ b/docs/mfc/handlers-for-commands-and-control-notifications.md @@ -3,10 +3,12 @@ description: "Learn more about: Handlers for Commands and Control Notifications" title: "Handlers for Commands and Control Notifications" ms.date: "11/04/2016" helpviewer_keywords: ["commands [MFC], handlers for", "functions [MFC], handler", "handlers [MFC]", "controls [MFC], notifications", "handlers [MFC], control notification [MFC]", "notifications [MFC], handlers for control", "handlers [MFC], command"] -ms.assetid: 20f57f4a-f577-4c09-80a2-43faf32a1c2e --- # Handlers for Commands and Control Notifications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + There are no default handlers for commands or control-notification messages. Therefore, you are bound only by convention in naming your handlers for these categories of messages. When you map the command or control notification to a handler, the [Class Wizard](reference/mfc-class-wizard.md) proposes a name based on the command ID or control-notification code. You can accept the proposed name, change it, or replace it. Convention suggests that you name handlers in both categories for the user-interface object they represent. Thus a handler for the Cut command on the Edit menu might be named diff --git a/docs/mfc/handlers-for-message-map-ranges.md b/docs/mfc/handlers-for-message-map-ranges.md index 6e74a048aaf..d7e36d824a8 100644 --- a/docs/mfc/handlers-for-message-map-ranges.md +++ b/docs/mfc/handlers-for-message-map-ranges.md @@ -3,10 +3,12 @@ description: "Learn more about: Handlers for Message-Map Ranges" title: "Handlers for Message-Map Ranges" ms.date: "11/04/2016" helpviewer_keywords: ["message handlers [MFC]", "handlers [MFC], message-map ranges", "message maps [MFC], message handler functions", "message maps [MFC], ranges", "control-notification messages [MFC]", "command IDs [MFC], message mapping", "message-map ranges [MFC]", "handlers [MFC]", "message handling [MFC], message handler functions", "mappings [MFC], message ranges", "command handling [MFC], command update handlers", "controls [MFC], notifications", "handler functions [MFC], message-map ranges", "handler functions [MFC]", "command update handlers [MFC]", "command routing [MFC], command update handlers", "message ranges [MFC]", "handler functions [MFC], declaring", "message ranges [MFC], mapping"] -ms.assetid: a271478b-5e1c-46f5-9f29-e5be44b27d08 --- # Handlers for Message-Map Ranges +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to map a range of messages to a single message handler function (instead of mapping one message to only one function). There are times when you need to process more than one message or control notification in exactly the same way. At such times, you might wish to map all of the messages to a single handler function. Message-map ranges allow you to do this for a contiguous range of messages: diff --git a/docs/mfc/handlers-for-standard-windows-messages.md b/docs/mfc/handlers-for-standard-windows-messages.md index 7554c3d59ea..5292702cde8 100644 --- a/docs/mfc/handlers-for-standard-windows-messages.md +++ b/docs/mfc/handlers-for-standard-windows-messages.md @@ -4,10 +4,12 @@ title: "Handlers for Standard Windows Messages" ms.date: "11/04/2016" f1_keywords: ["afx_msg"] helpviewer_keywords: ["Windows messages [MFC], handlers", "message handling [MFC], Windows message handlers", "handler functions, standard Windows messages", "functions [MFC], handler", "messages [MFC], Windows"] -ms.assetid: 19412a8b-2c38-4502-81da-13c823c7e36c --- # Handlers for Standard Windows Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Default handlers for standard Windows messages (**WM_**) are predefined in class `CWnd`. The class library bases names for these handlers on the message name. For example, the handler for the **WM_PAINT** message is declared in `CWnd` as: `afx_msg void OnPaint();` diff --git a/docs/mfc/handling-commands-in-the-document.md b/docs/mfc/handling-commands-in-the-document.md index f821152d3ec..48f29840f9e 100644 --- a/docs/mfc/handling-commands-in-the-document.md +++ b/docs/mfc/handling-commands-in-the-document.md @@ -3,11 +3,13 @@ description: "Learn more about: Handling Commands in the Document" title: "Handling Commands in the Document" ms.date: "11/04/2016" helpviewer_keywords: ["message maps [MFC], in document class", "command handling [MFC]", "documents [MFC], message maps", "message handling [MFC], WM_COMMAND messages", "command handling [MFC], commands in documents", "documents [MFC], handling messages in"] -ms.assetid: c7375584-27af-4275-b2fd-afea476785d0 ms.topic: concept-article --- # Handling Commands in the Document +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Your document class may also handle certain commands generated by menu items, toolbar buttons, or accelerator keys. By default, `CDocument` handles the Save and Save As commands on the File menu, using serialization. Other commands that affect the data may also be handled by member functions of your document. For example, in the Scribble program, class `CScribDoc` provides a handler for the Edit Clear All command, which deletes all of the data currently stored in the document. Documents can have message maps, but unlike views, documents cannot handle standard Windows messages — only **WM_COMMAND** messages, or "commands." ## See also diff --git a/docs/mfc/handling-customization-notifications.md b/docs/mfc/handling-customization-notifications.md index 1d2ffb237db..9a28ecd13b4 100644 --- a/docs/mfc/handling-customization-notifications.md +++ b/docs/mfc/handling-customization-notifications.md @@ -4,11 +4,13 @@ title: "Handling Customization Notifications" ms.date: "11/04/2016" f1_keywords: ["TBN_CUSTHELP", "TBN_QUERYINSERT", "TBNOTIFY", "NMHDR", "TBN_TOOLBARCHANGE", "TBN_ENDDRAG", "NM_SETFOCUS", "TBN_RESET", "NM_RETURN", "NM_ENDWAIT", "NM_STARTWAIT", "TBN_BEGINDRAG", "NM_OUTOFMEMORY", "TBN_QUERYDELETE", "NM_DBLCLK", "TBN_ENDADJUST", "NM_KILLFOCUS", "NM_RCLICK", "TBN_BEGINADJUST", "NM_CLICK"] helpviewer_keywords: ["TBN_ENDADJUST notification [MFC]", "TBNOTIFY notification [MFC]", "TBN_BEGINDRAG notification [MFC]", "TBN_TOOLBARCHANGE notification [MFC]", "NM_CLICK notification [MFC]", "NM_RETURN notification [MFC]", "NM_RCLICK notification [MFC]", "TBN_ENDDRAG notification [MFC]", "TBN_BEGINADJUST notification [MFC]", "NM_ENDWAIT notification [MFC]", "NM_KILLFOCUS notification [MFC]", "NM_SETFOCUS notification [MFC]", "NM_OUTOFMEMORY notification [MFC]", "TBN_QUERYINSERT notification [MFC]", "NMHDR [MFC]", "NM_STARTWAIT notification [MFC]", "CToolBarCtrl class [MFC], handling notifications", "TBN_CUSTHELP notification [MFC]", "TBN_RESET notification [MFC]", "NM_DBLCLK notification [MFC]", "TBN_QUERYDELETE notification [MFC]", "NM_RDBLCLK notification [MFC]", "TBN_GETBUTTONINFO notification [MFC]"] -ms.assetid: 219ea08e-7515-4b98-85cb-47120f08c0a2 ms.topic: concept-article --- # Handling Customization Notifications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A Windows toolbar common control has built-in customization features, including a system-defined customization dialog box, which allow the user to insert, delete, or rearrange toolbar buttons. The application determines whether the customization features are available and controls the extent to which the user can customize the toolbar. You can make these customization features available to the user by giving the toolbar the **CCS_ADJUSTABLE** style. The customization features allow the user to drag a button to a new position or to remove a button by dragging it off the toolbar. In addition, the user can double-click the toolbar to display the **Customize Toolbar** dialog box, which allows the user to add, delete, and rearrange toolbar buttons. The application can display the dialog box by using the [Customize](reference/ctoolbarctrl-class.md#customize) member function. diff --git a/docs/mfc/handling-reflected-messages.md b/docs/mfc/handling-reflected-messages.md index f7d74de5c86..ccb42f01c17 100644 --- a/docs/mfc/handling-reflected-messages.md +++ b/docs/mfc/handling-reflected-messages.md @@ -3,11 +3,13 @@ description: "Learn more about: Handling Reflected Messages" title: "Handling Reflected Messages" ms.date: "11/04/2016" helpviewer_keywords: ["message handling [MFC], reflected messages", "reflected messages, handling"] -ms.assetid: 147a4e0c-51cc-4447-a8e1-c28b4cece578 ms.topic: concept-article --- # Handling Reflected Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Message reflection lets you handle messages for a control, such as **WM_CTLCOLOR**, **WM_COMMAND**, and **WM_NOTIFY**, within the control itself. This makes the control more self-contained and portable. The mechanism works with Windows common controls as well as with ActiveX controls (formerly called OLE controls). Message reflection lets you reuse your `CWnd`-derived classes more readily. Message reflection works via [CWnd::OnChildNotify](reference/cwnd-class.md#onchildnotify), using special **ON_XXX_REFLECT** message map entries: for example, **ON_CTLCOLOR_REFLECT** and **ON_CONTROL_REFLECT**. [Technical Note 62](tn062-message-reflection-for-windows-controls.md) explains message reflection in more detail. diff --git a/docs/mfc/handling-the-apply-button.md b/docs/mfc/handling-the-apply-button.md index 3cfdef6bf9d..bb46aa7c06c 100644 --- a/docs/mfc/handling-the-apply-button.md +++ b/docs/mfc/handling-the-apply-button.md @@ -3,11 +3,13 @@ description: "Learn more about: Handling the Apply Button" title: "Handling the Apply Button" ms.date: "11/04/2016" helpviewer_keywords: ["Apply button in property sheet", "property sheets, Apply button"] -ms.assetid: 7e977015-59b8-406f-b545-aad0bfd8d55b ms.topic: concept-article --- # Handling the Apply Button +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Property sheets have a capability that standard dialog boxes do not: They allow the user to apply changes they have made before closing the property sheet. This is done using the Apply button. This article discusses methods you can use to implement this feature properly. Modal dialog boxes usually apply the settings to an external object when the user clicks OK to close the dialog box. The same is true for a property sheet: When the user clicks OK, the new settings in the property sheet take effect. diff --git a/docs/mfc/handling-tool-tip-notifications.md b/docs/mfc/handling-tool-tip-notifications.md index 8c1ed327ee5..8d03fb75ae9 100644 --- a/docs/mfc/handling-tool-tip-notifications.md +++ b/docs/mfc/handling-tool-tip-notifications.md @@ -3,11 +3,13 @@ description: "Learn more about: Handling Tool Tip Notifications" title: "Handling Tool Tip Notifications" ms.date: "11/04/2016" helpviewer_keywords: ["TOOLTIPTEXT structure [MFC]", "CToolBarCtrl class [MFC], handling notifications", "notifications [MFC], tool tips", "tool tips [MFC], notifications"] -ms.assetid: ddb93b5f-2e4f-4537-8053-3453c86e2bbb ms.topic: concept-article --- # Handling Tool Tip Notifications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you specify the **TBSTYLE_TOOLTIPS** style, the toolbar creates and manages a tool tip control. A tool tip is a small pop-up window that contains a line of text describing a toolbar button. The tool tip is hidden, appearing only when the user puts the cursor on a toolbar button and leaves it there for approximately one-half second. The tool tip is displayed near the cursor. Before the tool tip is displayed, the **TTN_NEEDTEXT** notification message is sent to the toolbar's owner window to retrieve the descriptive text for the button. If the toolbar's owner window is a `CFrameWnd` window, tool tips are displayed without any extra effort, because `CFrameWnd` has a default handler for the **TTN_NEEDTEXT** notification. If the toolbar's owner window is not derived from `CFrameWnd`, such as a dialog box or form view, you must add an entry to your owner window's message map and provide a notification handler in the message map. The entry to your owner window's message map is as follows: diff --git a/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md b/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md index 12058fb2d4e..8e0115299df 100644 --- a/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md +++ b/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md @@ -4,11 +4,13 @@ title: "Handling TTN_NEEDTEXT Notification for Tool Tips" ms.date: "11/04/2016" f1_keywords: ["TTN_NEEDTEXT"] helpviewer_keywords: ["TTN_NEEDTEXT message [MFC]", "notifications [MFC], tool tips", "tool tips [MFC], notifications"] -ms.assetid: d0370a65-21ba-4676-bcc5-8cf851bbb15c ms.topic: concept-article --- # Handling TTN_NEEDTEXT Notification for Tool Tips +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As part of [enabling tool tips](enabling-tool-tips.md), you handle the **TTN_NEEDTEXT** message by adding the following entry to your owner window's message map: [!code-cpp[NVC_MFCControlLadenDialog#40](codesnippet/cpp/handling-ttn-needtext-notification-for-tool-tips_1.cpp)] diff --git a/docs/mfc/handling-windows-messages-in-your-dialog-box.md b/docs/mfc/handling-windows-messages-in-your-dialog-box.md index 66db7e66085..d2c9173a4d9 100644 --- a/docs/mfc/handling-windows-messages-in-your-dialog-box.md +++ b/docs/mfc/handling-windows-messages-in-your-dialog-box.md @@ -3,11 +3,13 @@ description: "Learn more about: Handling Windows Messages in Your Dialog Box" title: "Handling Windows Messages in Your Dialog Box" ms.date: "09/05/2019" helpviewer_keywords: ["MFC dialog boxes [MFC], Windows messages", "Windows messages [MFC], handling", "message handling [MFC], in dialog boxes"] -ms.assetid: 4af0c9cb-09da-4b15-97df-a1cfb89def79 ms.topic: concept-article --- # Handling Windows Messages in Your Dialog Box +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Dialog boxes are windows, so they can handle Windows messages if you supply the appropriate handler functions. When you create your dialog class with the [Class Wizard](reference/mfc-class-wizard.md), the wizard adds an empty message map to the class. Use the wizard to map any Windows messages or commands you want your class to handle. See [Mapping Windows Messages to Your Dialog Class](mapping-windows-messages-to-your-class.md) for more information. diff --git a/docs/mfc/header-control-and-list-control.md b/docs/mfc/header-control-and-list-control.md index 447a06ef773..fe9450fb237 100644 --- a/docs/mfc/header-control-and-list-control.md +++ b/docs/mfc/header-control-and-list-control.md @@ -3,10 +3,12 @@ description: "Learn more about: Header Control and List Control" title: "Header Control and List Control" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], with CHeaderCtrl", "CListCtrl class [MFC], header controls", "CHeaderCtrl class [MFC], with CListCtrl", "controls [MFC], header", "header controls [MFC]", "header controls [MFC], list controls used with"] -ms.assetid: b20194b1-1a6b-4e2f-b890-1b3cca6650bc --- # Header Control and List Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In most cases, you will use the header control that is embedded in a [CListCtrl](reference/clistctrl-class.md) or [CListView](reference/clistview-class.md) object. However, there are cases where a separate header control object is desirable, such as manipulating data, arranged in columns or rows, in a [CView](reference/cview-class.md)-derived object. In these cases, you need greater control over the appearance and default behavior of an embedded header control. In the common case that you want a header control to provide standard, default behavior, you may want to use [CListCtrl](reference/clistctrl-class.md) or [CListView](reference/clistview-class.md) instead. Use `CListCtrl` when you want the functionality of a default header control, embedded in a list view common control. Use [CListView](reference/clistview-class.md) when you want the functionality of a default header control, embedded in a view object. diff --git a/docs/mfc/header-control-examples.md b/docs/mfc/header-control-examples.md index 19e93cf27ee..831c040b22e 100644 --- a/docs/mfc/header-control-examples.md +++ b/docs/mfc/header-control-examples.md @@ -3,10 +3,12 @@ description: "Learn more about: Header Control Examples" title: "Header Control Examples" ms.date: "11/04/2016" helpviewer_keywords: ["sample applications [MFC], header controls", "controls [MFC], header"] -ms.assetid: 30050732-d53e-4eab-88d7-61aac52914c9 --- # Header Control Examples +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For examples of header controls, see the [Header Controls](/windows/win32/Controls/header-controls) in the Windows SDK. ## See also diff --git a/docs/mfc/header-items-in-a-header-control.md b/docs/mfc/header-items-in-a-header-control.md index 86592027737..6090d24d31c 100644 --- a/docs/mfc/header-items-in-a-header-control.md +++ b/docs/mfc/header-items-in-a-header-control.md @@ -3,10 +3,12 @@ description: "Learn more about: Header Items in a Header Control" title: "Header Items in a Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], header items in", "header items in header controls [MFC]", "CHeaderCtrl class [MFC], header items in", "controls [MFC], header"] -ms.assetid: ac79ef1f-a671-4ab2-93e9-b1aa016a48bf --- # Header Items in a Header Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You have considerable control over the appearance and behavior of the header items that make up a header control ([CHeaderCtrl](reference/cheaderctrl-class.md)). Each header item can have a string, a bitmapped image, an image from an associated image list, or an application-defined 32-bit value associated with it. The string, bitmap, or image is displayed in the header item. You can customize the appearance and contents of new items when they are created by making a call [CHeaderCtrl::InsertItem](reference/cheaderctrl-class.md#insertitem) or by modifying an existing item, with a call to [CHeaderCtrl::GetItem](reference/cheaderctrl-class.md#getitem) and [CHeaderCtrl::SetItem](reference/cheaderctrl-class.md#setitem). diff --git a/docs/mfc/headers-and-footers.md b/docs/mfc/headers-and-footers.md index 52ce6bbb624..56c7002ac02 100644 --- a/docs/mfc/headers-and-footers.md +++ b/docs/mfc/headers-and-footers.md @@ -3,10 +3,12 @@ description: "Learn more about: Headers and Footers" title: "Headers and Footers" ms.date: "11/04/2016" helpviewer_keywords: ["printing [MFC], multipage documents", "page headers [MFC], printing", "headers [MFC], printing", "footers [MFC], printing", "page footers [MFC], printing", "page headers [MFC]", "printing [MFC], headers and footers", "page footers [MFC]"] -ms.assetid: b0be9c53-5773-4955-a777-3c15da745128 --- # Headers and Footers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to add headers and footers to a printed document. When you look at a document on the screen, the name of the document and your current location in the document are commonly displayed in a title bar and a status bar. When looking at a printed copy of a document, it's useful to have the name and page number shown in a header or footer. This is a common way in which even WYSIWYG programs differ in how they perform printing and screen display. diff --git a/docs/mfc/help-menu-merging.md b/docs/mfc/help-menu-merging.md index 39addc15747..4034238ed17 100644 --- a/docs/mfc/help-menu-merging.md +++ b/docs/mfc/help-menu-merging.md @@ -3,10 +3,12 @@ description: "Learn more about: Help Menu Merging" title: "Help Menu Merging" ms.date: "11/04/2016" helpviewer_keywords: ["menus [MFC], merging", "merging Help menus [MFC]", "Help [MFC], for active document containers"] -ms.assetid: 9d615999-79ba-471a-9288-718f0c903d49 --- # Help Menu Merging +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When an object is active within a container, the menu merging protocol of OLE Documents gives the object complete control of the **Help** menu. As a result, the container's Help topics are not available unless the user deactivates the object. The active document containment architecture expands on the rules for in-place menu merging to allow both the container and an active document that is active to share the menu. The new rules are simply additional conventions about what component owns what part of the menu and how the shared menu is constructed. The new convention is simple. In active documents, the **Help** menu has two top-level menu items organized as follows: diff --git a/docs/mfc/hierarchy-chart-categories.md b/docs/mfc/hierarchy-chart-categories.md index 288eb786579..4dc22030a09 100644 --- a/docs/mfc/hierarchy-chart-categories.md +++ b/docs/mfc/hierarchy-chart-categories.md @@ -3,10 +3,12 @@ description: "Learn more about: Hierarchy Chart Categories" title: "Hierarchy Chart Categories" ms.date: "11/19/2018" helpviewer_keywords: ["MFC, hierarchy"] -ms.assetid: 1f109428-4b84-4f7c-90a9-e71fe071311e --- # Hierarchy Chart Categories +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + ![MFC hierarchy chart categories.](../mfc/media/vc369r1.png "MFC hierarchy chart categories") ## See also diff --git a/docs/mfc/hierarchy-chart.md b/docs/mfc/hierarchy-chart.md index 7f7b93ff509..97e09c128bd 100644 --- a/docs/mfc/hierarchy-chart.md +++ b/docs/mfc/hierarchy-chart.md @@ -3,10 +3,12 @@ description: "See the MFC class hierarchy in chart form." title: "MFC class hierarchy chart" ms.date: 09/10/2021 helpviewer_keywords: ["object models, MFC", "classes [MFC], MFC hierarchy", "MFC, object model"] -ms.assetid: 19d70341-e391-4a72-94c6-35755ce975d4 --- # MFC class hierarchy chart +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following illustration represents the MFC classes derived from `CObject`: :::image type="content" source="../mfc/media/mfc-hierarchy-chart-part-1-of-3.png" alt-text="Chart that lists the MFC classes derived from CObject."::: diff --git a/docs/mfc/how-default-printing-is-done.md b/docs/mfc/how-default-printing-is-done.md index 1226570b146..df9f6291768 100644 --- a/docs/mfc/how-default-printing-is-done.md +++ b/docs/mfc/how-default-printing-is-done.md @@ -3,10 +3,12 @@ description: "Learn more about: How Default Printing Is Done" title: "How Default Printing Is Done" ms.date: "11/04/2016" helpviewer_keywords: ["default printing", "printing [MFC], default", "defaults, printing"] -ms.assetid: 0f698459-0fc9-4d43-97da-29cf0f65daa2 --- # How Default Printing Is Done +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the default printing process in Windows in terms of the MFC framework. In MFC applications, the view class has a member function named `OnDraw` that contains all the drawing code. `OnDraw` takes a pointer to a [CDC](reference/cdc-class.md) object as a parameter. That `CDC` object represents the device context to receive the image produced by `OnDraw`. When the window displaying the document receives a [WM_PAINT](/windows/win32/gdi/wm-paint) message, the framework calls `OnDraw` and passes it a device context for the screen (a [CPaintDC](reference/cpaintdc-class.md) object, to be specific). Accordingly, `OnDraw`'s output goes to the screen. diff --git a/docs/mfc/how-mfc-makes-it-easier-to-create-internet-client-applications.md b/docs/mfc/how-mfc-makes-it-easier-to-create-internet-client-applications.md index 543a3124945..ec12c0c8a4c 100644 --- a/docs/mfc/how-mfc-makes-it-easier-to-create-internet-client-applications.md +++ b/docs/mfc/how-mfc-makes-it-easier-to-create-internet-client-applications.md @@ -3,10 +3,12 @@ description: "Learn more about: How MFC Makes It Easier to Create Internet Clien title: "How MFC Makes It Easier to Create Internet Client Applications" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], MFC", "Internet applications [MFC], MFC", "MFC, Internet applications"] -ms.assetid: 94437b3f-f15c-437d-b5fd-264a2efec9ab --- # How MFC Makes It Easier to Create Internet Client Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Classes encapsulate the Win32 Internet Extension (WinInet) functions in a manner that provides a familiar context for MFC programmers. MFC provides three Internet file classes ([CInternetFile](reference/cinternetfile-class.md), [CHttpFile](reference/chttpfile-class.md), and [CGopherFile](reference/cgopherfile-class.md)) derived from the [CStdioFile](reference/cstdiofile-class.md) class. Not only do these classes make retrieving and manipulating Internet data familiar to programmers who have used `CStdioFile` for local files, but with these classes you can handle local files and Internet files in a consistent, transparent manner. The MFC WinInet classes provide the same functionality as `CStdioFile` for data that is transferred across the Internet. These classes abstract the Internet protocols for HTTP, FTP, and gopher into a high-level application programming interface, providing a fast and straightforward path to making applications Internet-aware. For example, connecting to an FTP server still requires several steps at a low level, but as an MFC developer, you only need to make one call to `CInternetSession::GetFTPConnection` to create that connection. diff --git a/docs/mfc/how-noncommand-messages-reach-their-handlers.md b/docs/mfc/how-noncommand-messages-reach-their-handlers.md index 8f7350006f1..ff32666a224 100644 --- a/docs/mfc/how-noncommand-messages-reach-their-handlers.md +++ b/docs/mfc/how-noncommand-messages-reach-their-handlers.md @@ -3,10 +3,12 @@ description: "Learn more about: How Noncommand Messages Reach Their Handlers" title: "How Noncommand Messages Reach Their Handlers" ms.date: "11/04/2016" helpviewer_keywords: ["messages [MFC], routing", "noncommand messages", "Windows messages [MFC], routing", "message handling [MFC], noncommand messages"] -ms.assetid: e7df8aef-9fae-41f4-9c11-881d8465f602 --- # How Noncommand Messages Reach Their Handlers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Unlike commands, standard Windows messages do not get routed through a chain of command targets but are usually handled by the window to which Windows sends the message. The window might be a main frame window, an MDI child window, a standard control, a dialog box, a view, or some other kind of child window. At run time, each Windows window is attached to a window object (derived directly or indirectly from `CWnd`) that has its own associated message map and handler functions. The framework uses the message map — as for a command — to map incoming messages to handlers. diff --git a/docs/mfc/how-the-framework-calls-a-handler.md b/docs/mfc/how-the-framework-calls-a-handler.md index 9faf7aa2bb0..b3989ca0b58 100644 --- a/docs/mfc/how-the-framework-calls-a-handler.md +++ b/docs/mfc/how-the-framework-calls-a-handler.md @@ -3,10 +3,12 @@ description: "Learn more about: How the Framework Calls a Handler" title: "How the Framework Calls a Handler" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, command routing", "handler functions, MFC framework", "command handling [MFC], calling handlers and code in MFC", "command routing [MFC], MFC"] -ms.assetid: d79bceba-4ff6-417a-9d52-6b6af62a909d --- # How the Framework Calls a Handler +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following topics first examine how the framework routes commands, then examine how other messages and control notifications are sent to windows: - [Message sending and receiving](message-sending-and-receiving.md) diff --git a/docs/mfc/how-the-framework-calls-your-code.md b/docs/mfc/how-the-framework-calls-your-code.md index af6f336b695..eb3f6d02366 100644 --- a/docs/mfc/how-the-framework-calls-your-code.md +++ b/docs/mfc/how-the-framework-calls-your-code.md @@ -3,10 +3,12 @@ description: "Learn more about: How the Framework Calls Your Code" title: "How the Framework Calls Your Code" ms.date: "11/04/2016" helpviewer_keywords: ["control flow [MFC], MFC framework and your code", "events [MFC], command routing in MFC", "command routing [MFC], framework", "command handling [MFC], calling handlers and code in MFC", "events [MFC], event-driven programming", "MFC, calling code from", "MFC, calling code", "application-specific events [MFC]", "command routing [MFC], MFC"] -ms.assetid: 39e68189-a580-40d0-9e35-bf5cd24a8ecf --- # How the Framework Calls Your Code +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + It is crucial to understand the relationship between your source code and the code in the MFC framework. When your application runs, most of the flow of control resides in the framework's code. The framework manages the message loop that gets messages from Windows as the user chooses commands and edits data in a view. Events that the framework can handle by itself do not rely on your code at all. For example, the framework knows how to close windows and how to exit the application in response to user commands. As it handles these tasks, the framework uses message handlers and C++ virtual functions to give you opportunities to respond to these events as well. Your code is not in control, however; the framework is. The framework calls your code for application-specific events. For example, when the user chooses a menu command, the framework routes the command along a sequence of C++ objects: the current view and frame window, the document associated with the view, the document's document template, and the application object. If one of these objects can handle the command, it does so, calling the appropriate message-handler function. For any given command, the code called may be yours or it may be the framework's. diff --git a/docs/mfc/how-the-framework-searches-message-maps.md b/docs/mfc/how-the-framework-searches-message-maps.md index f5b25c415ba..02d172cda6d 100644 --- a/docs/mfc/how-the-framework-searches-message-maps.md +++ b/docs/mfc/how-the-framework-searches-message-maps.md @@ -3,10 +3,12 @@ description: "Learn more about: How the Framework Searches Message Maps" title: "How the Framework Searches Message Maps" ms.date: "11/04/2016" helpviewer_keywords: ["message maps [MFC], searching"] -ms.assetid: fd1df878-5601-45d7-bd1f-b8f8e65b9a17 --- # How the Framework Searches Message Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The framework searches the message-map table for matches with incoming messages. Once you write a message-map entry for each message you want a class to handle and write the corresponding handlers, the framework calls your handlers automatically. The following topics explain message-map searching: - [Where to find message maps](where-to-find-message-maps.md) diff --git a/docs/mfc/how-to-add-restart-manager-support.md b/docs/mfc/how-to-add-restart-manager-support.md index f568efe5421..18bf6bfd20f 100644 --- a/docs/mfc/how-to-add-restart-manager-support.md +++ b/docs/mfc/how-to-add-restart-manager-support.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Add Restart Manager Support" title: "How to: Add Restart Manager Support" ms.date: "11/04/2016" helpviewer_keywords: ["Restart manager [MFC]", "C++, application crash support"] -ms.assetid: 7f3f5867-d4bc-4ba8-b3c9-dc1e7be93642 --- # How to: Add Restart Manager Support +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The restart manager is a feature added to Visual Studio for Windows Vista or later operating systems. The restart manager adds support for your application if it unexpectedly closes or restarts. The behavior of the restart manager depends on the type of your application. If your application is a document editor, the restart manager enabled your application to automatically save the state and content of any open documents and restarts your application after an unexpected closure. If your application is not a document editor, the restart manager will restart the application, but it cannot save the state of the application by default. After restart, the application displays a task dialog box if the application is Unicode. If it is an ANSI application, the application displays a Windows Message box. At this point, the user chooses whether to restore the automatically saved documents. If the user does not restore the automatically saved documents, the restart manager discards the temporary files. diff --git a/docs/mfc/how-to-add-ribbon-controls-and-event-handlers.md b/docs/mfc/how-to-add-ribbon-controls-and-event-handlers.md index 803855f0314..ce22746e9f4 100644 --- a/docs/mfc/how-to-add-ribbon-controls-and-event-handlers.md +++ b/docs/mfc/how-to-add-ribbon-controls-and-event-handlers.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Add Ribbon Controls and Event Handlers" title: "How to: Add Ribbon Controls and Event Handlers" ms.date: "11/04/2016" helpviewer_keywords: ["event handlers [MFC], adding", "ribbon controls [MFC], adding"] -ms.assetid: b31f25bc-ede7-49c3-9e3c-dffe4e174a69 --- # How to: Add Ribbon Controls and Event Handlers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Ribbon controls are elements, such as buttons and combo boxes, that you add to panels. Panels are areas of the ribbon bar that display a group of related controls. In this topic, you will open the Ribbon Designer, add a button, and then link an event that displays "Hello World". diff --git a/docs/mfc/how-to-convert-an-existing-mfc-ribbon-to-a-ribbon-resource.md b/docs/mfc/how-to-convert-an-existing-mfc-ribbon-to-a-ribbon-resource.md index e0e84a33917..c33c9d6e5f6 100644 --- a/docs/mfc/how-to-convert-an-existing-mfc-ribbon-to-a-ribbon-resource.md +++ b/docs/mfc/how-to-convert-an-existing-mfc-ribbon-to-a-ribbon-resource.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Convert an Existing MFC Ribbon to a Ribb title: "How to: Convert an Existing MFC Ribbon to a Ribbon Resource" ms.date: "11/04/2016" helpviewer_keywords: ["ribbon resource, converting from an MFC ribbon", "MFC ribbon, converting to a ribbon resource"] -ms.assetid: 324b7ff6-58f9-4691-96a9-9836a79d0fb6 --- # How to: Convert an Existing MFC Ribbon to a Ribbon Resource +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Ribbon resources are easier to visualize, modify, and maintain than manually coded ribbons. This topic describes how to convert a manually coded ribbon in an MFC Project into a ribbon resource. You must have an existing MFC project that has code that uses the MFC ribbon classes, for example, [CMFCRibbonBar Class](reference/cmfcribbonbar-class.md). diff --git a/docs/mfc/how-to-create-a-message-map-for-a-template-class.md b/docs/mfc/how-to-create-a-message-map-for-a-template-class.md index 39e4c4ec594..56465c75912 100644 --- a/docs/mfc/how-to-create-a-message-map-for-a-template-class.md +++ b/docs/mfc/how-to-create-a-message-map-for-a-template-class.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Create a Message Map for a Template Clas title: "How to: Create a Message Map for a Template Class" ms.date: "11/04/2016" helpviewer_keywords: ["template classes [MFC], creating message maps", "message maps [MFC], template classes"] -ms.assetid: 4e7e24f8-06df-4b46-82aa-7435c8650de3 --- # How to: Create a Message Map for a Template Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Message mapping in MFC provides an efficient way to direct Windows messages to an appropriate C++ object instance. Examples of MFC message map targets include application classes, document and view classes, control classes, and so on. Traditional MFC message maps are declared using the [BEGIN_MESSAGE_MAP](reference/message-map-macros-mfc.md#begin_message_map) macro to declare the start of the message map, a macro entry for each message-handler class method, and finally the [END_MESSAGE_MAP](reference/message-map-macros-mfc.md#end_message_map) macro to declare the end of the message map. diff --git a/docs/mfc/how-to-customize-the-application-button.md b/docs/mfc/how-to-customize-the-application-button.md index 8a9c8abbdae..9685a0d1b5b 100644 --- a/docs/mfc/how-to-customize-the-application-button.md +++ b/docs/mfc/how-to-customize-the-application-button.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Customize the Application Button" title: "How to: Customize the Application Button" ms.date: "09/07/2019" helpviewer_keywords: ["application button [MFC], customizing"] -ms.assetid: ebb11180-ab20-43df-a234-801feca9eb38 --- # How to: Customize the Application Button +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you click the Application button, a menu of commands is displayed. Typically, the menu contains file-related commands such as **Open**, **Save**, **Print**, and **Exit**. ![MFC Ribbon Application Button.](../mfc/media/application_button.png "MFC Ribbon Application Button") diff --git a/docs/mfc/how-to-customize-the-quick-access-toolbar.md b/docs/mfc/how-to-customize-the-quick-access-toolbar.md index fd1992a269c..432b7813070 100644 --- a/docs/mfc/how-to-customize-the-quick-access-toolbar.md +++ b/docs/mfc/how-to-customize-the-quick-access-toolbar.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Customize the Quick Access Toolbar" title: "How to: Customize the Quick Access Toolbar" ms.date: "09/07/2019" helpviewer_keywords: ["quick access toolbar [MFC], customization"] -ms.assetid: 2554099b-0c89-4605-9249-31bf9cbcefe0 --- # How to: Customize the Quick Access Toolbar +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Quick Access Toolbar (QAT) is a customizable toolbar that contains a set of commands that are either displayed next to the Application button or under the category tabs. The following illustration shows a typical Quick Access Toolbar. ![MFC Ribbon Quick Access Toolbar.](../mfc/media/quick_access_toolbar.png "MFC Ribbon Quick Access Toolbar") diff --git a/docs/mfc/how-to-display-command-information-in-the-status-bar.md b/docs/mfc/how-to-display-command-information-in-the-status-bar.md index 88c1169ad69..04bda0d0edd 100644 --- a/docs/mfc/how-to-display-command-information-in-the-status-bar.md +++ b/docs/mfc/how-to-display-command-information-in-the-status-bar.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Display Command Information in the Statu title: "How to: Display Command Information in the Status Bar" ms.date: "11/04/2016" helpviewer_keywords: ["prompts [MFC]", "displaying command status [MFC]", "status bars [MFC], message area", "status bars [MFC], displaying command information"] -ms.assetid: de895cbe-61ee-46bf-9787-76b247527d6d --- # How to: Display Command Information in the Status Bar +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you run the Application Wizard to create the skeleton of your application, you can support a toolbar and a status bar. Just one option in the Application Wizard supports both. When a status bar is present, the application automatically provides helpful feedback as the user moves the pointer over items on the menus. The application automatically displays a prompt string in the status bar when the menu item is highlighted. For example, when the user moves the pointer over the **Cut** command on the **Edit** menu, the status bar might display "Cuts the selection and puts it on the Clipboard" in the message area of the status bar. The prompt helps the user understand the purpose of the menu item. This also works when the user clicks a toolbar button. You can add to this status-bar help by defining prompt strings for menu items that you add to the program. To do this, provide the prompt strings when you edit the properties of the menu item in the menu editor. The strings you define are stored in the application resource file; they have the same IDs as the commands they explain. diff --git a/docs/mfc/how-to-implement-tracking-in-your-code.md b/docs/mfc/how-to-implement-tracking-in-your-code.md index 7d46e6634e7..b007c680d57 100644 --- a/docs/mfc/how-to-implement-tracking-in-your-code.md +++ b/docs/mfc/how-to-implement-tracking-in-your-code.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Implement Tracking in Your Code" title: "How to: Implement Tracking in Your Code" ms.date: "11/04/2016" helpviewer_keywords: ["CRectTracker class [MFC], implementing trackers"] -ms.assetid: baaeca2c-5114-485f-bf58-8807db1bc973 --- # How to: Implement Tracking in Your Code +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To track an OLE item, you must handle certain events related to the item, such as clicking the item or updating the view of the document. In all cases, it is sufficient to declare a temporary [CRectTracker](reference/crecttracker-class.md) object and manipulate the item by means of this object. When a user selects an item or inserts an object with a menu command, you must initialize the tracker with the proper styles to represent the state of the OLE item. The following table outlines the conventions used by the OCLIENT sample. For more information on these styles, see `CRectTracker`. diff --git a/docs/mfc/how-to-load-a-ribbon-resource-from-an-mfc-application.md b/docs/mfc/how-to-load-a-ribbon-resource-from-an-mfc-application.md index f86fcec8eeb..10204cff33c 100644 --- a/docs/mfc/how-to-load-a-ribbon-resource-from-an-mfc-application.md +++ b/docs/mfc/how-to-load-a-ribbon-resource-from-an-mfc-application.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Load a Ribbon Resource from an MFC Appli title: "How to: Load a Ribbon Resource from an MFC Application" ms.date: "11/04/2016" helpviewer_keywords: ["ribbon resource [MFC], loading"] -ms.assetid: 1c76bb8f-6345-414a-9f3f-128815ceadc5 --- # How to: Load a Ribbon Resource from an MFC Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To use the ribbon resource in your application, modify the application to load the ribbon resource. ### To load a ribbon resource diff --git a/docs/mfc/how-to-make-a-type-safe-collection.md b/docs/mfc/how-to-make-a-type-safe-collection.md index 3b507e6d543..c1c4dac4865 100644 --- a/docs/mfc/how-to-make-a-type-safe-collection.md +++ b/docs/mfc/how-to-make-a-type-safe-collection.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Make a Type-Safe Collection" title: "How to: Make a Type-Safe Collection" ms.date: "11/04/2016" helpviewer_keywords: ["type-safe collections [MFC]", "serializing collection-class elements [MFC]", "collection classes [MFC], type safety", "SerializeElements function [MFC]", "collection classes [MFC], template-based", "serialization [MFC], collection classes", "collection classes [MFC], deriving from nontemplate"] -ms.assetid: 7230b2db-4283-4083-b098-eb231bf5b89e --- # How to: Make a Type-Safe Collection +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to make type-safe collections for your own data types. Topics include: - [Using template-based classes for type safety](#_core_using_template.2d.based_classes_for_type_safety) diff --git a/docs/mfc/how-to-update-user-interface-objects.md b/docs/mfc/how-to-update-user-interface-objects.md index 2b5fa11a2d1..0a9e902847d 100644 --- a/docs/mfc/how-to-update-user-interface-objects.md +++ b/docs/mfc/how-to-update-user-interface-objects.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Update User-Interface Objects" title: "How to: Update User-Interface Objects" ms.date: "11/04/2016" helpviewer_keywords: ["menus [MFC], updating as context changes", "user interface objects [MFC], updating", "user interface objects [MFC]", "update handlers [MFC]", "enabling UI elements [MFC]", "disabling menus [MFC]", "updating user-interface objects [MFC]", "disabling UI elements [MFC]", "commands [MFC], updating UI", "enabling menus [MFC]"] -ms.assetid: 82f09773-c978-427b-b321-05a6143b7369 --- # How to: Update User-Interface Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Typically, menu items and toolbar buttons have more than one state. For example, a menu item is grayed (dimmed) if it is unavailable in the present context. Menu items can also be checked or unchecked. A toolbar button can also be disabled if unavailable, or it can be checked. Who updates the state of these items as program conditions change Logically, if a menu item generates a command that is handled by, say, a document, it makes sense to have the document update the menu item. The document probably contains the information on which the update is based. diff --git a/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md b/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md index 4b8cec07283..ac1c59f2b1d 100644 --- a/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md +++ b/docs/mfc/how-wininet-makes-it-easier-to-create-internet-client-applications.md @@ -3,10 +3,12 @@ description: "Learn more about: How WinInet Makes It Easier to Create Internet C title: "How WinInet Makes It Easier to Create Internet Client Applications" ms.date: "11/04/2016" helpviewer_keywords: ["Windows Sockets [MFC], vs. WinInet", "WinInet classes [MFC], vs. WinSock", "WinInet classes [MFC], Internet client applications"] -ms.assetid: dc0f9f47-3184-4e7a-8074-2c63e0359885 --- # How WinInet Makes It Easier to Create Internet Client Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Win32 Internet Extensions, or WinInet, provide access to common Internet protocols, including gopher, FTP, and HTTP. Using WinInet, you can write Internet client applications at a higher level of programming, without having to deal with WinSock, TCP/IP, or the details of specific Internet protocols. WinInet provides a consistent set of functions for all three protocols, with a familiar Win32 API interface. This consistency minimizes code changes you need to make if the underlying protocol changes (for example, from FTP to HTTP). Visual C++ provides two ways for you to use WinInet. You can call the Win32 Internet functions directly (see the OLE documentation in the Windows SDK for more information) or you can use WinInet through the [MFC WinInet classes](mfc-classes-for-creating-internet-client-applications.md). diff --git a/docs/mfc/html-basics.md b/docs/mfc/html-basics.md index 88e3e02b5ad..52a2ba0cd3c 100644 --- a/docs/mfc/html-basics.md +++ b/docs/mfc/html-basics.md @@ -3,10 +3,12 @@ description: "Learn more about: HTML Basics" title: "HTML Basics" ms.date: "11/04/2016" helpviewer_keywords: ["HTML [MFC], about HTML"] -ms.assetid: aab8ea9f-12d4-4bdd-a585-ac3124081a2a --- # HTML Basics +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Most browsers have the capability of examining the HTML source of the pages you browse. When you view the source you will see a number of HTML (Hypertext markup language) tags, surrounded by angle brackets(<>), interspersed with text. The steps below use HTML tags to build a simple Web page. In these steps, you'll type plain text into a file in Notepad, make a few changes, save the file, and reload your page in the browser to see your changes. diff --git a/docs/mfc/html-help-context-sensitive-help-for-your-programs.md b/docs/mfc/html-help-context-sensitive-help-for-your-programs.md index ecadee9898f..592b23b3a8d 100644 --- a/docs/mfc/html-help-context-sensitive-help-for-your-programs.md +++ b/docs/mfc/html-help-context-sensitive-help-for-your-programs.md @@ -3,10 +3,12 @@ description: "Learn more about: HTML Help: Context-Sensitive Help for Your Progr title: "HTML Help: Context-Sensitive Help for Your Programs" ms.date: "11/04/2016" helpviewer_keywords: ["context-sensitive Help [MFC], HTML Help", "HTML Help [MFC], context-sensitive"] -ms.assetid: f2eabbbb-0796-43f3-a483-5f7cf00f2e7c --- # HTML Help: Context-Sensitive Help for Your Programs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!IMPORTANT] > HTML Help is not supported in this version of MFC. diff --git a/docs/mfc/idle-loop-processing.md b/docs/mfc/idle-loop-processing.md index 04bee6c2f4a..abf173d9f42 100644 --- a/docs/mfc/idle-loop-processing.md +++ b/docs/mfc/idle-loop-processing.md @@ -3,10 +3,12 @@ description: "Learn more about: Idle Loop Processing" title: "Idle Loop Processing" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, background processing", "PeekMessage method [MFC], elsewhere than message loop", "PeekMessage method [MFC]", "MFC, messages", "messages [MFC], loops", "OnIdle method [MFC]", "processing [MFC], background", "idle loop processing [MFC]", "idle processing [MFC]", "threading [MFC], alternatives to multithreading", "processing, during idle loop", "processing [MFC]", "background processing [MFC]"] -ms.assetid: 5c7c46c1-6107-4304-895f-480983bb1e44 --- # Idle Loop Processing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Many applications perform lengthy processing "in the background." Sometimes performance considerations dictate using multithreading for such work. Threads involve extra development overhead, so they are not recommended for simple tasks like the idle-time work that MFC does in the [OnIdle](reference/cwinthread-class.md#onidle) function. This article focuses on idle processing. For more information about multithreading, see [Multithreading Topics](../parallel/multithreading-support-for-older-code-visual-cpp.md). Some kinds of background processing are appropriately done during intervals that the user is not otherwise interacting with the application. In an application developed for the Microsoft Windows operating system, an application can perform idle-time processing by splitting a lengthy process into many small fragments. After processing each fragment, the application yields execution control to Windows using a [PeekMessage](/windows/win32/api/winuser/nf-winuser-peekmessagew) loop. diff --git a/docs/mfc/image-information-in-image-lists.md b/docs/mfc/image-information-in-image-lists.md index 85fb338f183..11ca2a4de11 100644 --- a/docs/mfc/image-information-in-image-lists.md +++ b/docs/mfc/image-information-in-image-lists.md @@ -3,10 +3,12 @@ description: "Learn more about: Image Information in Image Lists" title: "Image Information in Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["CImageList class [MFC], image information in", "image lists [MFC], image information in"] -ms.assetid: 73c41543-fa91-405d-b15b-0feffa6a72c1 --- # Image Information in Image Lists +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + [CImageList](reference/cimagelist-class.md) includes a number of functions that retrieve information from an image list. The [GetImageInfo](reference/cimagelist-class.md#getimageinfo) member function fills an `IMAGEINFO` structure with information about a single image, including the handles of the image and mask bitmaps, the number of color planes and bits per pixel, and the bounding rectangle of the image within the image bitmap. You can use this information to directly manipulate the bitmaps for the image. The [GetImageCount](reference/cimagelist-class.md#getimagecount) member function retrieves the number of images in an image list. diff --git a/docs/mfc/image-overlays-in-image-lists.md b/docs/mfc/image-overlays-in-image-lists.md index 808d498a425..1822b3e0149 100644 --- a/docs/mfc/image-overlays-in-image-lists.md +++ b/docs/mfc/image-overlays-in-image-lists.md @@ -3,10 +3,12 @@ description: "Learn more about: Image Overlays in Image Lists" title: "Image Overlays in Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["overlays [MFC]", "image lists [MFC], image overlays in", "CImageList class [MFC], image overlays in"] -ms.assetid: aaf4e1c4-cd12-42c8-9af4-1bb458889b4e --- # Image Overlays in Image Lists +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Every image list ([CImageList](reference/cimagelist-class.md)) includes a list of images to use as overlay masks. An "overlay mask" is an image drawn transparently over another image. Any image can be used as an overlay mask. You can specify up to four overlay masks per image list. You add the index of an image to the list of overlay masks by using the [SetOverlayImage](reference/cimagelist-class.md#setoverlayimage) member function, the index of an image, and the index of an overlay mask. Note that the indices for the overlay masks are one-based rather than zero-based. diff --git a/docs/mfc/implementing-working-areas-in-list-controls.md b/docs/mfc/implementing-working-areas-in-list-controls.md index 0ee8d8fcbfa..5379ff13fea 100644 --- a/docs/mfc/implementing-working-areas-in-list-controls.md +++ b/docs/mfc/implementing-working-areas-in-list-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Implementing Working Areas in List Controls" title: "Implementing Working Areas in List Controls" ms.date: "11/04/2016" helpviewer_keywords: ["list controls [MFC], working areas", "working areas in list control [MFC]"] -ms.assetid: fbbb356b-3359-4348-8603-f1cb114cadde ms.topic: concept-article --- # Implementing Working Areas in List Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + By default, a list control arranges all items in a standard grid fashion. However, another method is supported, working areas, that arranges the list items into rectangular groups. For an image of a list control that implements working areas, see Using List-View Controls in the Windows SDK. > [!NOTE] diff --git a/docs/mfc/initializing-and-cleaning-up-documents-and-views.md b/docs/mfc/initializing-and-cleaning-up-documents-and-views.md index 9245198be4d..a5475344903 100644 --- a/docs/mfc/initializing-and-cleaning-up-documents-and-views.md +++ b/docs/mfc/initializing-and-cleaning-up-documents-and-views.md @@ -3,11 +3,13 @@ description: "Learn more about: Initializing and Cleaning Up Documents and Views title: "Initializing and Cleaning Up Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["initializing documents [MFC]", "views [MFC], cleaning up", "documents [MFC], initializing", "documents [MFC], cleaning up", "views [MFC], initializing", "initializing objects [MFC], document objects", "document objects [MFC], life cycle of", "initializing views [MFC]"] -ms.assetid: 95d6f09b-a047-4079-856a-ae7d0548e9d2 ms.topic: how-to --- # Initializing and Cleaning Up Documents and Views +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use the following guidelines for initializing and cleaning up after your documents and views: - The MFC framework initializes documents and views; you initialize any data you add to them. diff --git a/docs/mfc/initializing-documents-and-views.md b/docs/mfc/initializing-documents-and-views.md index 43ac07fab7a..9df47617166 100644 --- a/docs/mfc/initializing-documents-and-views.md +++ b/docs/mfc/initializing-documents-and-views.md @@ -3,11 +3,13 @@ description: "Learn more about: Initializing Documents and Views" title: "Initializing Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["initializing documents [MFC]", "documents [MFC], initializing", "views [MFC], initializing", "initializing objects [MFC], document objects", "initializing views [MFC]"] -ms.assetid: 33cb8643-8a16-478c-bc26-eccc734e3661 ms.topic: concept-article --- # Initializing Documents and Views +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Documents are created in two different ways, so your document class must support both ways. First, the user can create a new, empty document with the File New command. In that case, initialize the document in your override of the [OnNewDocument](reference/cdocument-class.md#onnewdocument) member function of class [CDocument](reference/cdocument-class.md). Second, the user can use the Open command on the File menu to create a new document whose contents are read from a file. In that case, initialize the document in your override of the [OnOpenDocument](reference/cdocument-class.md#onopendocument) member function of class `CDocument`. If both initializations are the same, you can call a common member function from both overrides, or `OnOpenDocument` can call `OnNewDocument` to initialize a clean document and then finish the open operation. Views are created after their documents are created. The best time to initialize a view is after the framework has finished creating the document, frame window, and view. You can initialize your view by overriding the [OnInitialUpdate](reference/cview-class.md#oninitialupdate) member function of [CView](reference/cview-class.md). If you need to reinitialize or adjust anything each time the document changes, you can override [OnUpdate](reference/cview-class.md#onupdate). diff --git a/docs/mfc/initializing-the-dialog-box.md b/docs/mfc/initializing-the-dialog-box.md index ba9d129545f..a023246ae63 100644 --- a/docs/mfc/initializing-the-dialog-box.md +++ b/docs/mfc/initializing-the-dialog-box.md @@ -3,11 +3,13 @@ description: "Learn more about: Initializing the Dialog Box" title: "Initializing the Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["initializing dialog boxes [MFC]", "OnInitDialog method [MFC]", "modal dialog boxes [MFC], initializing", "modeless dialog boxes [MFC], initializing", "MFC dialog boxes [MFC], initializing"] -ms.assetid: 968142f5-19f9-4b34-a1d4-8e6412d4379b ms.topic: concept-article --- # Initializing the Dialog Box +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + After the dialog box and all of its controls are created but just before the dialog box (of either type) appears on the screen, the dialog object's [OnInitDialog](reference/cdialog-class.md#oninitdialog) member function is called. For a modal dialog box, this occurs during the `DoModal` call. For a modeless dialog box, `OnInitDialog` is called when `Create` is called. You typically override `OnInitDialog` to initialize the dialog box's controls, such as setting the initial text of an edit box. You must call the `OnInitDialog` member function of the base class, `CDialog`, from your `OnInitDialog` override. If you want to set your dialog box's background color (and that of all other dialog boxes in your application), see [Setting the Dialog Box's Background Color](setting-the-dialog-boxs-background-color.md). diff --git a/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md b/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md index af5b7bc529b..fb6a19352f3 100644 --- a/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md +++ b/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md @@ -3,11 +3,13 @@ description: "Learn more about: Initializing the Parts of a CStatusBarCtrl Objec title: "Initializing the Parts of a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["CStatusBarCtrl class [MFC], simple mode", "status bars [MFC], declaring parts of", "simple status bars [MFC]", "status bars [MFC], icons", "status bars [MFC], simple mode", "icons, using in status bars", "CStatusBarCtrl class [MFC], declaring parts of"] -ms.assetid: 60e8f285-d2d8-424a-a6ea-2fc548370303 ms.topic: concept-article --- # Initializing the Parts of a CStatusBarCtrl Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + By default, a status bar displays status information using separate panes. These panes (also referred to as parts) can contain either a text string, an icon, or both. Use [SetParts](reference/cstatusbarctrl-class.md#setparts) to define how many parts, and the length, the status bar will have. After you have created the parts of the status bar, make calls to [SetText](reference/cstatusbarctrl-class.md#settext) and [SetIcon](reference/cstatusbarctrl-class.md#seticon) to set the text or icon for a specific part of the status bar. Once the part has been successfully set, the control is automatically redrawn. diff --git a/docs/mfc/initinstance-member-function.md b/docs/mfc/initinstance-member-function.md index adea53e37d0..a9b498541b8 100644 --- a/docs/mfc/initinstance-member-function.md +++ b/docs/mfc/initinstance-member-function.md @@ -4,10 +4,12 @@ title: "InitInstance Member Function" ms.date: "11/04/2016" f1_keywords: ["InitInstance"] helpviewer_keywords: ["InitInstance method [MFC]", "applications [MFC], initializing", "MFC, initializing", "initializing MFC applications"] -ms.assetid: 4ef09267-ff7f-4c39-91a0-57454a264f83 --- # InitInstance Member Function +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Windows operating system allows you to run more than one copy, or "instance," of the same application. `WinMain` calls [InitInstance](reference/cwinapp-class.md#initinstance) every time a new instance of the application starts. The standard `InitInstance` implementation created by the MFC Application Wizard performs the following tasks: diff --git a/docs/mfc/inserting-a-control-into-a-control-container-application.md b/docs/mfc/inserting-a-control-into-a-control-container-application.md index dd5b98f83e8..d53eaffac01 100644 --- a/docs/mfc/inserting-a-control-into-a-control-container-application.md +++ b/docs/mfc/inserting-a-control-into-a-control-container-application.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Control Containers: Inserting a Control title: "ActiveX Control Containers: Inserting a Control into a Control Container Application" ms.date: "11/04/2016" helpviewer_keywords: ["ActiveX control containers [MFC], inserting controls", "ActiveX controls [MFC], adding to projects"] -ms.assetid: bbb617ff-872f-43d8-b4d6-c49adb16b148 --- # ActiveX Control Containers: Inserting a Control into a Control Container Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Before you can access an ActiveX control from an ActiveX control container application, you must add the ActiveX control to the container application using the [Insert ActiveX Control](../windows/adding-editing-or-deleting-controls.md) dialog box. To add an ActiveX control to the ActiveX control container project, see [Viewing and Adding ActiveX Controls to a Dialog Box](../windows/adding-editing-or-deleting-controls.md). diff --git a/docs/mfc/inserting-a-form-into-a-project.md b/docs/mfc/inserting-a-form-into-a-project.md index ad08c10130e..657302adc43 100644 --- a/docs/mfc/inserting-a-form-into-a-project.md +++ b/docs/mfc/inserting-a-form-into-a-project.md @@ -3,11 +3,13 @@ description: "Learn more about: Inserting a Form into a Project" title: "Inserting a Form into a Project" ms.date: "11/04/2016" helpviewer_keywords: ["inserting forms [MFC]", "Insert New dialog box [MFC]", "forms, adding to projects"] -ms.assetid: f3bd2998-3ce2-496d-ac5c-57ca70eec7cb ms.topic: how-to --- # Inserting a Form into a Project +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Forms provide a convenient container for controls. You can easily insert an MFC-based form into your application as long as the application supports the MFC libraries. ### To insert a form into your project diff --git a/docs/mfc/interface-elements.md b/docs/mfc/interface-elements.md index 28c6b293ffe..04cd91cdafe 100644 --- a/docs/mfc/interface-elements.md +++ b/docs/mfc/interface-elements.md @@ -3,10 +3,12 @@ description: "Learn more about: Interface Elements" title: "Interface Elements" ms.date: "11/19/2018" helpviewer_keywords: ["architecture [MFC], MFC Feature Pack", "MFC Feature Pack, architecture"] -ms.assetid: eead6827-9602-40a3-8038-8986e8207385 --- # Interface Elements +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This document describes interface elements that were introduced in Visual Studio 2008 SP1, and also describes differences with the earlier version of the library. The following illustration shows an application that was built by using the new interface elements. diff --git a/docs/mfc/internet-and-networking-classes.md b/docs/mfc/internet-and-networking-classes.md index 4832f616532..a7f0d4040c6 100644 --- a/docs/mfc/internet-and-networking-classes.md +++ b/docs/mfc/internet-and-networking-classes.md @@ -4,10 +4,12 @@ title: "Internet and Networking Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.net"] helpviewer_keywords: ["Internet classes [MFC]", "networking classes [MFC]"] -ms.assetid: 1acf793d-ebf2-4fac-97be-703d62e3897e --- # Internet and Networking Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes allow you to exchange information with another computer using a Windows Socket or Win32 Internet (WinInet). There are also a set of classes for manipulating Windows Sockets. The following categories of classes support connectivity. diff --git a/docs/mfc/internet-information-by-task.md b/docs/mfc/internet-information-by-task.md index 7493ce32c50..246ca26a540 100644 --- a/docs/mfc/internet-information-by-task.md +++ b/docs/mfc/internet-information-by-task.md @@ -3,10 +3,12 @@ description: "Learn more about: Internet Information by Task" title: "Internet Information by Task" ms.date: "09/12/2018" helpviewer_keywords: ["MFC, Internet applications"] -ms.assetid: da078bf5-53c3-4167-b1ef-509b5a544ad9 --- # Internet Information by Task +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The tasks listed in this topic are sorted based on the task you want to accomplish. >[!IMPORTANT] diff --git a/docs/mfc/internet-information-by-topic.md b/docs/mfc/internet-information-by-topic.md index c23fba8b600..a8b769f525f 100644 --- a/docs/mfc/internet-information-by-topic.md +++ b/docs/mfc/internet-information-by-topic.md @@ -3,10 +3,12 @@ description: "Learn more about: Internet Information by Topic" title: "Internet Information by Topic" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, Internet applications"] -ms.assetid: 93a8b6c9-d274-492a-90b3-cf43a77edb1d --- # Internet Information by Topic +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For information on programming with a specific Internet technology, see: ## WinInet diff --git a/docs/mfc/internet-related-mfc-classes.md b/docs/mfc/internet-related-mfc-classes.md index 25f83f8c5cc..9dbcbb7a9ca 100644 --- a/docs/mfc/internet-related-mfc-classes.md +++ b/docs/mfc/internet-related-mfc-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Internet-Related MFC Classes" title: "Internet-Related MFC Classes" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, Internet classes"] -ms.assetid: e50c6b39-4b65-4b8a-8101-8934d0780723 --- # Internet-Related MFC Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For information about Internet-related classes and functions, see: ## Global functions diff --git a/docs/mfc/internet-security-cpp.md b/docs/mfc/internet-security-cpp.md index c66886c7db5..8aed9355989 100644 --- a/docs/mfc/internet-security-cpp.md +++ b/docs/mfc/internet-security-cpp.md @@ -3,10 +3,12 @@ description: "Learn more about: Internet Security (C++)" title: "Internet Security (C++)" ms.date: "11/04/2016" helpviewer_keywords: ["code signing [MFC], Internet security", "sandboxing [MFC]", "digital signatures [MFC], Internet security", "code signing [MFC]", "Web application security [MFC]", "code access security [MFC], Internet security considerations", "security [MFC]", "security [MFC], Internet", "Internet applications [MFC], security", "Web application security [MFC], Internet security approaches"] -ms.assetid: bf0da697-81bc-41f0-83fa-d7f82ed83df8 --- # Internet Security (C++) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Code safety is a major issue for developers and for users of Internet applications. There are risks: malicious code, code that has been tampered with, and code from unknown sites or authors. There are two basic approaches to security when developing for the Internet. The first is called "sandboxing." In this approach, an application is restricted to a particular set of APIs, and excluded from potentially dangerous ones such as file I/O where a program could destroy data on a user's computer. The second is implemented using digital signatures. This approach is referred to as "shrinkwrap" for the Internet. Code is verified and signed using private key/public key technology. Before the code is run, its digital signature is verified to ensure that the code is from a known authenticated source, and that the code has not been altered since it has been signed. diff --git a/docs/mfc/interpreting-user-input-through-a-view.md b/docs/mfc/interpreting-user-input-through-a-view.md index 6e1086bbe15..190fcef5aef 100644 --- a/docs/mfc/interpreting-user-input-through-a-view.md +++ b/docs/mfc/interpreting-user-input-through-a-view.md @@ -3,11 +3,13 @@ description: "Learn more about: Interpreting User Input Through a View" title: "Interpreting User Input Through a View" ms.date: "11/04/2016" helpviewer_keywords: ["interpreting user input through views [MFC]", "views [MFC], user interface and input", "input [MFC], view class [MFC]", "CView class [MFC], interpreting user input", "user input [MFC], interpreting through view class [MFC]"] -ms.assetid: f0302a70-661f-4781-8fe7-78f082bef2a5 ms.topic: concept-article --- # Interpreting User Input Through a View +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Other member functions of the view handle and interpret all user input. You will usually define message-handler member functions in your view class to process: - Windows [messages](messages.md) generated by mouse and keyboard actions. diff --git a/docs/mfc/isolation-of-the-mfc-common-controls-library.md b/docs/mfc/isolation-of-the-mfc-common-controls-library.md index 9f038e52807..7fac241cdb5 100644 --- a/docs/mfc/isolation-of-the-mfc-common-controls-library.md +++ b/docs/mfc/isolation-of-the-mfc-common-controls-library.md @@ -3,10 +3,12 @@ description: "Learn more about: Isolation of the MFC Common Controls Library" title: "Isolation of the MFC Common Controls Library" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, Common Controls library"] -ms.assetid: 7471e6f0-49b0-47f7-86e7-8d6bc3541694 --- # Isolation of the MFC Common Controls Library +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Common Controls library is now isolated within MFC, allowing different modules (such as user DLLs) to use different versions of the Common Controls library by specifying the version in their manifests. An MFC application (or user code called by MFC) makes calls to Common Controls library APIs through wrapper functions named `Afx`*FunctionName*, where *FunctionName* is the name of a Common Controls API. Those wrapper functions are defined in afxcomctl32.h and afxcomctl32.inl. diff --git a/docs/mfc/keyboard-and-mouse-customization.md b/docs/mfc/keyboard-and-mouse-customization.md index 9e1e28242fb..749fbb102eb 100644 --- a/docs/mfc/keyboard-and-mouse-customization.md +++ b/docs/mfc/keyboard-and-mouse-customization.md @@ -3,10 +3,12 @@ description: "Learn more about: Keyboard and Mouse Customization" title: "Keyboard and Mouse Customization" ms.date: "11/19/2018" helpviewer_keywords: ["customizations [MFC], keyboard and mouse (MFC Extensions)", "keyboard and mouse customizations (MFC Extensions)"] -ms.assetid: 1f789f1b-5f2e-4b11-b974-e3e2a2e49d82 --- # Keyboard and Mouse Customization +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC allows the user of your application to customize how it handles keyboard and mouse input. The user can customize keyboard input by assigning keyboard shortcuts to commands. The user can also customize the mouse input by selecting the command that should be executed when the user double-clicks inside specific windows of the application. This topic explains how to customize the input for your application. In the **Customization** dialog box, the user can change the custom controls for the mouse and the keyboard. To display this dialog box, the user points to **Customize** on the **View** menu and then clicks **Toolbars and Docking**. In the dialog box, the user clicks either the **Keyboard** tab or the **Mouse** tab. diff --git a/docs/mfc/life-cycle-of-a-dialog-box.md b/docs/mfc/life-cycle-of-a-dialog-box.md index f178c1f0676..38d347f2d30 100644 --- a/docs/mfc/life-cycle-of-a-dialog-box.md +++ b/docs/mfc/life-cycle-of-a-dialog-box.md @@ -3,11 +3,13 @@ description: "Learn more about: Working with Dialog Boxes in MFC" title: "Working with Dialog Boxes in MFC" ms.date: "09/27/2019" helpviewer_keywords: ["dialog boxes [MFC], life cycle", "modal dialog boxes [MFC], life cycle", "modeless dialog boxes [MFC], life cycle", "MFC dialog boxes [MFC], life cycle", "life cycle of dialog boxes [MFC]"] -ms.assetid: e16fd78e-238d-4f31-8c9d-8564f3953bd9 ms.topic: concept-article --- # Working with Dialog Boxes in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + During the life cycle of a dialog box, the user invokes the dialog box, typically inside a command handler that creates and initializes the dialog object, the user interacts with the dialog box, then dialog box closes. For modal dialog boxes, your handler gathers any data the user entered once the dialog box closes. Since the dialog object exists after its dialog window has closed, you can simply use the member variables of your dialog class to extract the data. diff --git a/docs/mfc/list-control-and-list-view.md b/docs/mfc/list-control-and-list-view.md index 80c769cd219..20e0d4b2792 100644 --- a/docs/mfc/list-control-and-list-view.md +++ b/docs/mfc/list-control-and-list-view.md @@ -3,10 +3,12 @@ description: "Learn more about: List Control and List View" title: "List Control and List View" ms.date: "11/04/2016" helpviewer_keywords: ["CListView class [MFC], and CListCtrl", "views [MFC], list and list control", "CListCtrl class [MFC], and CListView", "list views [MFC]", "list controls [MFC], List view"] -ms.assetid: 7aee1c48-b158-4399-be0b-be366993665e --- # List Control and List View +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For convenience, MFC encapsulates the list control in two ways. You can use list controls: - Directly, by embedding a [CListCtrl](reference/clistctrl-class.md) object in a dialog class. diff --git a/docs/mfc/list-items-and-image-lists.md b/docs/mfc/list-items-and-image-lists.md index 27c772c67c3..9c6bf25f89a 100644 --- a/docs/mfc/list-items-and-image-lists.md +++ b/docs/mfc/list-items-and-image-lists.md @@ -3,10 +3,12 @@ description: "Learn more about: List Items and Image Lists" title: "List Items and Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["CImageList class [MFC], and list items", "image lists [MFC], list items", "CListCtrl class [MFC], image lists", "list items [MFC], image lists"] -ms.assetid: 317d095f-f978-47da-acb6-7bfe7dd3bc69 --- # List Items and Image Lists +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An "item" in a list control ([CListCtrl](reference/clistctrl-class.md)) consists of an icon, a label, and possibly other information (in "subitems"). The icons for list control items are contained in image lists. One image list contains full-sized icons used in icon view. A second, optional, image list contains smaller versions of the same icons for use in other views of the control. A third optional list contains "state" images, such as check boxes, for display in front of the small icons in certain views. A fourth optional list contains images that are displayed in individual header items of the list control. diff --git a/docs/mfc/making-and-using-controls.md b/docs/mfc/making-and-using-controls.md index 8cba3f0fffc..e09293f71d9 100644 --- a/docs/mfc/making-and-using-controls.md +++ b/docs/mfc/making-and-using-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Making and Using Controls" title: "Making and Using Controls" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], creating for dialog boxes", "Windows common controls [MFC], about common controls", "common controls [MFC], about common controls"] -ms.assetid: a252acad-3cc0-440e-bbc6-43eaaf8cb7bb ms.topic: concept-article --- # Making and Using Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You make most controls for dialog boxes in the Visual Studio [dialog editor](../windows/dialog-editor.md). But you can also create controls in any dialog box or window. ## What do you want to know more about diff --git a/docs/mfc/making-owner-drawn-header-controls.md b/docs/mfc/making-owner-drawn-header-controls.md index 68a3e251f9d..e57f2484f92 100644 --- a/docs/mfc/making-owner-drawn-header-controls.md +++ b/docs/mfc/making-owner-drawn-header-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Making Owner-Drawn Header Controls" title: "Making Owner-Drawn Header Controls" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], owner-drawn", "drawing [MFC], header controls", "CHeaderCtrl class [MFC], making owner-drawn", "controls [MFC], header", "owner-drawn header controls [MFC]"] -ms.assetid: 455c113b-e8d0-400c-8690-dbb92cba0d05 ms.topic: concept-article --- # Making Owner-Drawn Header Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can define individual items of a header control ([CHeaderCtrl](reference/cheaderctrl-class.md)) to be owner-drawn items. For more information, see [Owner-Drawn Header Controls](/windows/win32/Controls/header-controls) in the Windows SDK. ## See also diff --git a/docs/mfc/making-owner-drawn-tabs.md b/docs/mfc/making-owner-drawn-tabs.md index f3421ab838c..31d9bdfbc57 100644 --- a/docs/mfc/making-owner-drawn-tabs.md +++ b/docs/mfc/making-owner-drawn-tabs.md @@ -3,11 +3,13 @@ description: "Learn more about: Making Owner-Drawn Tabs" title: "Making Owner-Drawn Tabs" ms.date: "11/04/2016" helpviewer_keywords: ["owner-drawn tabs [MFC]", "tabs [MFC], owner-drawn", "CTabCtrl class [MFC], owner-drawn tabs", "drawing [MFC], tabs"] -ms.assetid: 11af2926-41d7-47e3-9eec-c595283f6371 ms.topic: concept-article --- # Making Owner-Drawn Tabs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can define individual items of a tab control ([CTabCtrl](reference/ctabctrl-class.md)) to be owner-drawn items. For more information, see [Owner-Drawn Tabs](/windows/win32/Controls/tab-controls) in the Windows SDK. ## See also diff --git a/docs/mfc/managing-data-with-document-data-variables.md b/docs/mfc/managing-data-with-document-data-variables.md index be73faee851..0375973e8be 100644 --- a/docs/mfc/managing-data-with-document-data-variables.md +++ b/docs/mfc/managing-data-with-document-data-variables.md @@ -3,11 +3,13 @@ description: "Learn more about: Managing Data with Document Data Variables" title: "Managing Data with Document Data Variables" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], data storage", "friend classes [MFC]", "classes [MFC], friend", "data [MFC]", "data [MFC], documents", "collection classes [MFC], used by document object", "document data [MFC]", "member variables [MFC], document class [MFC]"] -ms.assetid: e70b87f4-8c30-49e5-8986-521c2ff91704 ms.topic: concept-article --- # Managing Data with Document Data Variables +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implement your document's data as member variables of your document class. For example, the Scribble program declares a data member of type `CObList` — a linked list that stores pointers to `CObject` objects. This list is used to store arrays of points that make up a freehand line drawing. How you implement your document's member data depends on the nature of your application. To help you out, MFC supplies a group of "collection classes" — arrays, lists, and maps (dictionaries), including collections based on C++ templates — along with classes that encapsulate a variety of common data types such as `CString`, `CRect`, `CPoint`, `CSize`, and `CTime`. For more information about these classes, see the [Class Library Overview](class-library-overview.md) in the *MFC Reference*. diff --git a/docs/mfc/managing-mdi-child-windows.md b/docs/mfc/managing-mdi-child-windows.md index beca42fc238..f0426cace5d 100644 --- a/docs/mfc/managing-mdi-child-windows.md +++ b/docs/mfc/managing-mdi-child-windows.md @@ -4,11 +4,13 @@ title: "Managing MDI Child Windows" ms.date: "11/19/2018" f1_keywords: ["MDICLIENT"] helpviewer_keywords: ["MDI [MFC], child windows", "child windows [MFC], and MDICLIENT window", "MDICLIENT window [MFC]", "windows [MFC], MDI", "frame windows [MFC], MDI child windows", "child windows [MFC]", "MDI [MFC], frame windows"] -ms.assetid: 1828d96e-a561-48ae-a661-ba9701de6bee ms.topic: concept-article --- # Managing MDI Child Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MDI main frame windows (one per application) contain a special child window called the MDICLIENT window. The MDICLIENT window manages the client area of the main frame window, and itself has child windows: the document windows, derived from `CMDIChildWnd`. Because the document windows are frame windows themselves (MDI child windows), they can also have their own children. In all of these cases, the parent window manages its child windows and forwards some commands to them. In an MDI frame window, the frame window manages the MDICLIENT window, repositioning it in conjunction with control bars. The MDICLIENT window, in turn, manages all MDI child frame windows. The following figure shows the relationship between an MDI frame window, its MDICLIENT window, and its child document frame windows. diff --git a/docs/mfc/managing-menus-control-bars-and-accelerators.md b/docs/mfc/managing-menus-control-bars-and-accelerators.md index 329610e659a..4830ec1e010 100644 --- a/docs/mfc/managing-menus-control-bars-and-accelerators.md +++ b/docs/mfc/managing-menus-control-bars-and-accelerators.md @@ -3,11 +3,13 @@ description: "Learn more about: Managing Menus, Control Bars, and Accelerators" title: "Managing Menus, Control Bars, and Accelerators" ms.date: "11/04/2016" helpviewer_keywords: ["MDI [MFC], frame windows", "control bars [MFC], updating in frame windows", "menus [MFC], updating as context changes", "user interface objects [MFC], updating", "accelerator tables [MFC]", "sharing menus [MFC]", "updating user-interface objects [MFC]", "frame windows [MFC], updating", "status bars [MFC], updating"] -ms.assetid: 97ca1997-06df-4373-b023-4f7ecd81047b ms.topic: concept-article --- # Managing Menus, Control Bars, and Accelerators +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The frame window manages updating user-interface objects, including menus, toolbar buttons, the status bar, and accelerators. It also manages sharing the menu bar in MDI applications. ## Managing Menus diff --git a/docs/mfc/managing-the-current-view.md b/docs/mfc/managing-the-current-view.md index ecd15ad51ec..59c278a4d13 100644 --- a/docs/mfc/managing-the-current-view.md +++ b/docs/mfc/managing-the-current-view.md @@ -3,11 +3,13 @@ description: "Learn more about: Managing the Current View" title: "Managing the Current View" ms.date: "11/04/2016" helpviewer_keywords: ["views [MFC], and OnActivateView method [MFC]", "views [MFC], deactivating", "views [MFC], activating", "frame windows [MFC], current view", "OnActivateView method [MFC]", "views [MFC], current", "deactivating views [MFC]", "current view in frame window [MFC]"] -ms.assetid: 0a1cc22d-d646-4536-9ad2-3cb6d7092e4a ms.topic: concept-article --- # Managing the Current View +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As part of the default implementation of frame windows, a frame window keeps track of a currently active view. If the frame window contains more than one view, as for example in a splitter window, the current view is the most recent view in use. The active view is independent of the active window in Windows or the current input focus. When the active view changes, the framework notifies the current view by calling its [OnActivateView](reference/cview-class.md#onactivateview) member function. You can tell whether the view is being activated or deactivated by examining `OnActivateView`'s *bActivate* parameter. By default, `OnActivateView` sets the focus to the current view on activation. You can override `OnActivateView` to perform any special processing when the view is deactivated or reactivated. For example, you might want to provide special visual cues to distinguish the active view from other, inactive views. diff --git a/docs/mfc/managing-the-state-data-of-mfc-modules.md b/docs/mfc/managing-the-state-data-of-mfc-modules.md index 37c7bead209..31871e32640 100644 --- a/docs/mfc/managing-the-state-data-of-mfc-modules.md +++ b/docs/mfc/managing-the-state-data-of-mfc-modules.md @@ -3,11 +3,13 @@ description: "Learn more about: Managing the State Data of MFC Modules" title: "Managing the State Data of MFC Modules" ms.date: "11/19/2018" helpviewer_keywords: ["global state [MFC]", "data management [MFC], MFC modules", "window procedure entry points [MFC]", "exported interfaces and global state [MFC]", "module states [MFC], saving and restoring", "data management [MFC]", "MFC, managing state data", "multiple modules [MFC]", "module state restored [MFC]"] -ms.assetid: 81889c11-0101-4a66-ab3c-f81cf199e1bb ms.topic: concept-article --- # Managing the State Data of MFC Modules +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses the state data of MFC modules and how this state is updated when the flow of execution (the path code takes through an application when executing) enters and leaves a module. Switching module states with the AFX_MANAGE_STATE and METHOD_PROLOGUE macros is also discussed. > [!NOTE] diff --git a/docs/mfc/manipulating-image-lists.md b/docs/mfc/manipulating-image-lists.md index 6d92caf6d4f..2f2e7a0d6a3 100644 --- a/docs/mfc/manipulating-image-lists.md +++ b/docs/mfc/manipulating-image-lists.md @@ -3,11 +3,13 @@ description: "Learn more about: Manipulating Image Lists" title: "Manipulating Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["image lists [MFC], manipulating", "lists [MFC], image", "CImageList class [MFC], manipulating"] -ms.assetid: 043418f8-077e-4dce-b8bb-2b7b0d7b5156 ms.topic: concept-article --- # Manipulating Image Lists +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [Replace](reference/cimagelist-class.md#replace) member function replaces an image in an image list ([CImageList](reference/cimagelist-class.md)) with a new image. This function is also useful if you need to dynamically increase the number of images in an image list object. The [SetImageCount](reference/cimagelist-class.md#setimagecount) function dynamically changes the number of images stored in the image list. If you increase the size of the image list, call `Replace` to add images to the new image slots. If you decrease the size of the image list, the images beyond the new size are freed. The [Remove](reference/cimagelist-class.md#remove) member function removes an image from an image list. The [Copy](reference/cimagelist-class.md#copy) member function can copy or swap images within an image list. This function allows you to indicate whether the source image should be copied to the destination index or the source and destination images should be swapped. diff --git a/docs/mfc/manipulating-menus-during-program-execution.md b/docs/mfc/manipulating-menus-during-program-execution.md index 830ad98dea8..272a383e298 100644 --- a/docs/mfc/manipulating-menus-during-program-execution.md +++ b/docs/mfc/manipulating-menus-during-program-execution.md @@ -3,11 +3,13 @@ description: "Learn more about: Manipulating Menus During Program Execution" title: "Manipulating Menus During Program Execution" ms.date: "11/04/2016" helpviewer_keywords: ["menus [MFC], editing during execution", "menus during execution [MFC], deleting", "CMenu class [MFC], manipulating menus during execution", "menus [MFC], manipulating during execution", "menus during execution"] -ms.assetid: 722c7c00-4be2-4967-877d-f96aaa604396 ms.topic: concept-article --- # Manipulating Menus During Program Execution +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use class `CMenu` to manipulate menus and menu items on the fly. `CMenu` encapsulates a Windows HMENU handle and supplies member functions for working with menus. See the overview for class [CMenu](reference/cmenu-class.md) for details. diff --git a/docs/mfc/manipulating-the-progress-control.md b/docs/mfc/manipulating-the-progress-control.md index 364d495b2c7..ab103759dc1 100644 --- a/docs/mfc/manipulating-the-progress-control.md +++ b/docs/mfc/manipulating-the-progress-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Manipulating the Progress Control" title: "Manipulating the Progress Control" ms.date: "11/04/2016" helpviewer_keywords: ["CProgressCtrl class [MFC], working with", "progress controls [MFC], manipulating", "CProgressCtrl class [MFC], manipulating", "controlling progress controls [MFC]", "CProgressCtrl class [MFC], using"] -ms.assetid: 9af561d1-980b-4003-a6da-ff79be15bf23 ms.topic: how-to --- # Manipulating the Progress Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + There are three ways to change the current position of a progress control ([CProgressCtrl](reference/cprogressctrl-class.md)). - The position can be changed by a preset increment amount. diff --git a/docs/mfc/manipulating-the-tool-tip-control.md b/docs/mfc/manipulating-the-tool-tip-control.md index a368c8f8955..ea50fc35323 100644 --- a/docs/mfc/manipulating-the-tool-tip-control.md +++ b/docs/mfc/manipulating-the-tool-tip-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Manipulating the Tool Tip Control" title: "Manipulating the Tool Tip Control" ms.date: "11/04/2016" helpviewer_keywords: ["CToolTipCtrl class [MFC], manipulating tool tip attributes", "tool tips [MFC], attributes"] -ms.assetid: 3600afe5-712a-4b56-8456-96e85fe879af ms.topic: concept-article --- # Manipulating the Tool Tip Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Class `CToolTipCtrl` provides a group of member functions that control the various attributes of the `CToolTipCtrl` object and the tool tip window. The initial, pop-up, and reshow durations for the tool tip windows can be set and retrieved with calls to [GetDelayTime](reference/ctooltipctrl-class.md#getdelaytime) and [SetDelayTime](reference/ctooltipctrl-class.md#setdelaytime). diff --git a/docs/mfc/mapi-samples.md b/docs/mfc/mapi-samples.md index cf952047442..87c7684e026 100644 --- a/docs/mfc/mapi-samples.md +++ b/docs/mfc/mapi-samples.md @@ -3,10 +3,12 @@ description: "Learn more about: MAPI Samples" title: "MAPI Samples" ms.date: "11/04/2016" helpviewer_keywords: ["MAPI, MFC", "sample applications [MFC], MAPI"] -ms.assetid: 3af3085c-8c8f-47c9-a966-b82311a20bf6 --- # MAPI Samples +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + See the following sample programs that illustrate Microsoft Messaging Application Programming Interface (MAPI) functionality: - [NPP](../overview/visual-cpp-samples.md) diff --git a/docs/mfc/mapi-support-in-mfc.md b/docs/mfc/mapi-support-in-mfc.md index 10329e6fd07..b241e223917 100644 --- a/docs/mfc/mapi-support-in-mfc.md +++ b/docs/mfc/mapi-support-in-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: MAPI Support in MFC" title: "MAPI Support in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, MAPI support", "MAPI support in MFC", "CDocument class [MFC], and MAPI", "OnUpdateFileSendMail method [MFC]", "MAPI, MFC", "OnFileSendMail method [MFC]"] -ms.assetid: cafbecb1-0427-4077-b4b8-159bae5b49b8 --- # MAPI Support in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC supplies support for a subset of the Microsoft Messaging Application Program Interface (MAPI) in class `CDocument`. Specifically, `CDocument` has member functions that determine whether mail support is present on the end-user's machine and, if so, enable a Send Mail command whose standard command ID is ID_FILE_SEND_MAIL. The MFC handler function for this command allows the user to send a document through electronic mail. > [!TIP] diff --git a/docs/mfc/mapi.md b/docs/mfc/mapi.md index 70bc8612b7c..55667986b9f 100644 --- a/docs/mfc/mapi.md +++ b/docs/mfc/mapi.md @@ -3,10 +3,12 @@ description: "Learn more about: MAPI" title: "MAPI" ms.date: "11/04/2016" helpviewer_keywords: ["messaging [MFC], client applications", "enabling applications for MAPI [MFC]", "MAPI support in MFC", "e-mail [MFC], enabling", "mail [MFC], enabling your application", "MAPI, MFC", "enabling applications for mail [MFC]"] -ms.assetid: 193449f7-b131-4ab0-9301-8d4f6cd1e7c4 --- # MAPI +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the Microsoft Messaging Application Programming Interface (MAPI) for client message application developers. MFC supplies support for a subset of MAPI in class `CDocument` but does not encapsulate the entire API. For more information, see [MAPI Support in MFC](mapi-support-in-mfc.md). MAPI is a set of functions that mail-enabled and mail-aware applications use to create, manipulate, transfer, and store mail messages. It gives application developers the tools to define the purpose and content of mail messages and gives them flexibility in their management of stored mail messages. MAPI also provides a common interface that application developers can use to create mail-enabled and mail-aware applications independent of the underlying messaging system. diff --git a/docs/mfc/mapping-messages.md b/docs/mfc/mapping-messages.md index 2f59ba6b40e..ebd242a4c18 100644 --- a/docs/mfc/mapping-messages.md +++ b/docs/mfc/mapping-messages.md @@ -3,11 +3,13 @@ description: "Learn more about: Mapping Messages" title: "Mapping Messages" ms.date: "11/04/2016" helpviewer_keywords: ["message maps [MFC], about message maps", "mappings [MFC], commands", "commands [MFC], mapping", "command mapping [MFC]", "message handling [MFC], connecting to handler functions", "commands [MFC], connecting to handler functions", "mappings [MFC], messages", "messages [MFC], mapping"] -ms.assetid: 996f0652-0698-4b8c-b893-cdaa836d9d0f ms.topic: concept-article --- # Mapping Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Each framework class that can receive messages or commands has its own "message map." The framework uses message maps to connect messages and commands to their handler functions. Any class derived from class `CCmdTarget` can have a message map. Other articles explain message maps in detail and describe how to use them. In spite of the name "message map," message maps handle both messages and commands — all three categories of messages listed in [Message Categories](message-categories.md). diff --git a/docs/mfc/mapping-windows-messages-to-your-class.md b/docs/mfc/mapping-windows-messages-to-your-class.md index f34a3d5da29..115e49cc2d1 100644 --- a/docs/mfc/mapping-windows-messages-to-your-class.md +++ b/docs/mfc/mapping-windows-messages-to-your-class.md @@ -3,11 +3,13 @@ description: "Learn more about: Mapping Windows Messages to Your Class" title: "Mapping Windows Messages to Your Class" ms.date: "09/06/2019" helpviewer_keywords: ["MFC dialog boxes [MFC], Windows messages", "message maps [MFC], in dialog class", "Windows messages [MFC], mapping in dialog classes", "messages to dialog class [MFC]", "mappings [MFC], messages to dialog class [MFC]", "message maps [MFC], mapping Windows messages to classes", "messages to dialog class [MFC], mapping", "Class Wizard [MFC]"] -ms.assetid: a4c6fd1f-1d33-47c9-baa0-001755746d6d ms.topic: concept-article --- # Mapping Windows Messages to Your Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you need your dialog box to handle Windows messages, override the appropriate handler functions. To do so, choose the **Class View** tab in **Solution Explorer**, right click on the class that represents the dialog box, and choose [Class Wizard](reference/mfc-class-wizard.md). Use the wizard to [map the messages](reference/mapping-messages-to-functions.md) to the dialog class. This writes a message-map entry for each message and adds the message-handler member functions to the class. Use the code editor to write code in the message handlers. You can also override member functions of [CDialog](reference/cdialog-class.md) and its base classes, especially [CWnd](reference/cwnd-class.md). diff --git a/docs/mfc/mdi-tabbed-groups.md b/docs/mfc/mdi-tabbed-groups.md index c4b435c6ecf..ad7e811bbfb 100644 --- a/docs/mfc/mdi-tabbed-groups.md +++ b/docs/mfc/mdi-tabbed-groups.md @@ -3,10 +3,12 @@ description: "Learn more about: MDI Tabbed Groups" title: "MDI Tabbed Groups" ms.date: "11/04/2016" helpviewer_keywords: ["mdi [MFC], tabbed groups", "tabbed grous [MFC]"] -ms.assetid: 0a464f36-39b7-4e68-8b67-ec175de28377 --- # MDI Tabbed Groups +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The multiple document interface (MDI) tabbed groups feature enables multiple document interface (MDI) applications to display one or more tabbed windows (or groups of tabbed windows, known as *tabbed groups*) in the MDI client area. The tabbed windows can be aligned vertically or horizontally. If an application hosts more than one MDI tabbed group, the groups are separated by splitters. ## Features diff --git a/docs/mfc/memory-management-examples.md b/docs/mfc/memory-management-examples.md index c76643dce83..398fc193af1 100644 --- a/docs/mfc/memory-management-examples.md +++ b/docs/mfc/memory-management-examples.md @@ -3,10 +3,12 @@ description: "Learn more about: Memory Management: Examples" title: "Memory Management: Examples" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], memory allocation", "data structures [MFC]", "arrays [MFC], allocating resources", "objects [MFC], allocating memory", "data structures [MFC], allocating memory", "examples [MFC], memory allocation", "heap allocation [MFC], examples", "memory allocation [MFC], arrays", "MFC, memory management", "struct memory allocation [MFC]", "types [MFC], memory allocation", "memory allocation [MFC], objects", "memory allocation [MFC], examples", "arrays [MFC], memory management", "frame allocation [MFC]", "memory allocation [MFC], data structures"] -ms.assetid: f10240f8-b698-4c83-9288-97a54318930b --- # Memory Management: Examples +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes how MFC performs frame allocations and heap allocations for each of the three typical kinds of memory allocations: - [An array of bytes](#_core_allocation_of_an_array_of_bytes) diff --git a/docs/mfc/memory-management-frame-allocation.md b/docs/mfc/memory-management-frame-allocation.md index dc3cfa5d7a0..0bb639b12c0 100644 --- a/docs/mfc/memory-management-frame-allocation.md +++ b/docs/mfc/memory-management-frame-allocation.md @@ -3,10 +3,12 @@ description: "Learn more about: Memory Management: Frame Allocation" title: "Memory Management: Frame Allocation" ms.date: "11/04/2016" helpviewer_keywords: ["memory leaks [MFC], frame allocation", "memory [MFC], detecting leaks", "memory [MFC], reclaiming", "memory allocation [MFC], frames", "frame variables [MFC], automatic deletion of", "scope [MFC], frame variables", "heap allocation [MFC], vs. frame allocation", "variables [MFC], frame variables", "memory leaks [MFC], detecting", "memory, releasing [MFC]", "stack frames [MFC]", "memory leaks [MFC], allocating objects on the frame", "detecting memory leaks [MFC]", "frame allocation [MFC]", "frame variables [MFC]"] -ms.assetid: 945a211a-6f4f-4679-bb6a-b0f2a0d4a6c1 --- # Memory Management: Frame Allocation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allocation on the frame takes its name from the "stack frame" that is set up whenever a function is called. The stack frame is an area of memory that temporarily holds the arguments to the function as well as any variables that are defined local to the function. Frame variables are often called "automatic" variables because the compiler automatically allocates the space for them. There are two key characteristics of frame allocations. First, when you define a local variable, enough space is allocated on the stack frame to hold the entire variable, even if it is a large array or data structure. Second, frame variables are automatically deleted when they go out of scope: diff --git a/docs/mfc/memory-management-heap-allocation.md b/docs/mfc/memory-management-heap-allocation.md index 4d0992fab1f..d9fe3cec85e 100644 --- a/docs/mfc/memory-management-heap-allocation.md +++ b/docs/mfc/memory-management-heap-allocation.md @@ -3,10 +3,12 @@ description: "Learn more about: Memory Management: Heap Allocation" title: "Memory Management: Heap Allocation" ms.date: "11/04/2016" helpviewer_keywords: ["memory [MFC], detecting leaks", "delete operator [MFC], using with debug MFC", "heap allocation [MFC], described", "memory allocation [MFC], heap memory", "memory leaks [MFC], detecting", "new operator [MFC], using with debug MFC", "heap allocation [MFC]", "detecting memory leaks [MFC]"] -ms.assetid: a5d949c6-1b79-476e-9c66-513a558203d9 --- # Memory Management: Heap Allocation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The heap is reserved for the memory allocation needs of the program. It is an area apart from the program code and the stack. Typical C programs use the functions **malloc** and **free** to allocate and deallocate heap memory. The Debug version of MFC provides modified versions of the C++ built-in operators **`new`** and **`delete`** to allocate and deallocate objects in heap memory. When you use **`new`** and **`delete`** instead of **malloc** and **free**, you are able to take advantage of the class library's memory-management debugging enhancements, which can be useful in detecting memory leaks. When you build your program with the Release version of MFC, the standard versions of the **`new`** and **`delete`** operators provide an efficient way to allocate and deallocate memory (the Release version of MFC does not provide modified versions of these operators). diff --git a/docs/mfc/memory-management-resizable-memory-blocks.md b/docs/mfc/memory-management-resizable-memory-blocks.md index 7223f4180ad..6ac07cbf65b 100644 --- a/docs/mfc/memory-management-resizable-memory-blocks.md +++ b/docs/mfc/memory-management-resizable-memory-blocks.md @@ -3,10 +3,12 @@ description: "Learn more about: Memory Management: Resizable Memory Blocks" title: "Memory Management: Resizable Memory Blocks" ms.date: "11/04/2016" helpviewer_keywords: ["memory blocks [MFC], resizable", "memory [MFC], corruption", "memory allocation [MFC], memory block size", "memory blocks [MFC], allocating", "blocks [MFC], memory allocation", "resizable memory blocks [MFC]"] -ms.assetid: f0efe6f4-a3ed-4541-9195-51ec1291967a --- # Memory Management: Resizable Memory Blocks +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The **`new`** and **`delete`** operators, described in the article [Memory Management: Examples](memory-management-examples.md), are good for allocating and deallocating fixed-size memory blocks and objects. Occasionally, your application may need resizable memory blocks. You must use the standard C run-time library functions [malloc](../c-runtime-library/reference/malloc.md), [realloc](../c-runtime-library/reference/realloc.md), and [free](../c-runtime-library/reference/free.md) to manage resizable memory blocks on the heap. > [!IMPORTANT] diff --git a/docs/mfc/memory-management.md b/docs/mfc/memory-management.md index 89b67110a51..7e8e4f29121 100644 --- a/docs/mfc/memory-management.md +++ b/docs/mfc/memory-management.md @@ -3,10 +3,12 @@ description: "Learn more about: Memory Management" title: "Memory Management" ms.date: "11/04/2016" helpviewer_keywords: ["memory [MFC]", "MFC, memory management", "memory allocation [MFC]", "memory [MFC], managing", "memory allocation [MFC], MFC"] -ms.assetid: 934ac81b-d630-4232-88e5-ea74f7187987 --- # Memory Management +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This group of articles describes how to take advantage of the general-purpose services of the Microsoft Foundation Class Library (MFC) related to memory management. Memory allocation can be divided into two main categories: frame allocations and heap allocations. One main difference between the two allocation techniques is that with frame allocation you typically work with the actual memory block itself, while with heap allocation you are always given a pointer to the memory block. Another major difference between the two schemes is that frame objects are automatically deleted, while heap objects must be explicitly deleted by the programmer. diff --git a/docs/mfc/menu-sample-list.md b/docs/mfc/menu-sample-list.md index 5c9810c792f..5cccff447db 100644 --- a/docs/mfc/menu-sample-list.md +++ b/docs/mfc/menu-sample-list.md @@ -3,10 +3,12 @@ description: "Learn more about: Menu Sample List" title: "Menu Sample List" ms.date: "11/04/2016" helpviewer_keywords: ["sample applications [MFC], menus"] -ms.assetid: 6d89c723-03d6-474e-8ca5-e98f93bd41cc --- # Menu Sample List +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + See the following sample programs that illustrate creating, editing, and updating menus: *MDI Sample: Enable and Disable Menu Items* diff --git a/docs/mfc/menus-and-resources-container-additions.md b/docs/mfc/menus-and-resources-container-additions.md index 7ece3400513..09b822aea90 100644 --- a/docs/mfc/menus-and-resources-container-additions.md +++ b/docs/mfc/menus-and-resources-container-additions.md @@ -4,10 +4,12 @@ title: "Menus and Resources: Container Additions" ms.date: "11/04/2016" f1_keywords: ["IDP_OLE_INIT_FAILED", "IDP_FAILED_TO_CREATE", "VK_ESCAPE"] helpviewer_keywords: ["application accelerator table [MFC]", "VK_ESCAPE key [MFC]", "IDP_FAILED_TO_CREATE macro [MFC]", "visual editing, application menus and resources", "OLE containers [MFC], menus and resources", "accelerator tables [MFC], container applications", "IDP_OLE_INIT_FAILED macro [MFC]", "CONTAIN tutorial [MFC]", "Links menu item [MFC]"] -ms.assetid: 425448be-8ca0-412e-909a-a3a9ce845288 --- # Menus and Resources: Container Additions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the changes that need to be made to the menus and other resources in a visual editing container application. In container applications, two types of changes need to be made: modifications to existing resources to support OLE visual editing and addition of new resources used for in-place activation. If you use the application wizard to create your container application, these steps will be done for you, but they may require some customization. diff --git a/docs/mfc/menus-and-resources-menu-merging.md b/docs/mfc/menus-and-resources-menu-merging.md index b418a729ab0..523cbbb818e 100644 --- a/docs/mfc/menus-and-resources-menu-merging.md +++ b/docs/mfc/menus-and-resources-menu-merging.md @@ -3,10 +3,12 @@ description: "Learn more about: Menus and Resources: Menu Merging" title: "Menus and Resources: Menu Merging" ms.date: "11/04/2016" helpviewer_keywords: ["status bars [MFC], OLE document applications", "visual editing [MFC], application menus and resources", "coordinating menu layouts [MFC]", "OLE containers [MFC], menus and resources", "toolbars [MFC], OLE document applications", "merging toolbar and status bar [MFC]", "menus [MFC], OLE document applications"] -ms.assetid: 80b6bb17-d830-4122-83f0-651fc112d4d1 --- # Menus and Resources: Menu Merging +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article details the steps necessary for OLE document applications to handle visual editing and in-place activation properly. In-place activation poses a challenge for both container and server (component) applications. The user remains in the same frame window (within the context of the container document) but is actually running another application (the server). This requires coordination between the resources of the container and server applications. Topics covered in this article include: diff --git a/docs/mfc/menus-and-resources-ole.md b/docs/mfc/menus-and-resources-ole.md index 8cc71f8bc8a..577625c40ba 100644 --- a/docs/mfc/menus-and-resources-ole.md +++ b/docs/mfc/menus-and-resources-ole.md @@ -3,10 +3,12 @@ description: "Learn more about: Menus and Resources (OLE)" title: "Menus and Resources (OLE)" ms.date: "11/04/2016" helpviewer_keywords: ["OLE visual editing servers [MFC]", "status bars [MFC], OLE document applications", "visual editing [MFC], application menus and resources", "string tables [MFC], visual editing applications", "OLE containers [MFC], menus and resources", "OLE applications [MFC], menus and resources", "OLE server applications [MFC], menus and resources", "toolbars [MFC], OLE document applications", "string editing [MFC], visual editing applications", "server applications [MFC], OLE menus and resources", "applications [OLE], menus and resources", "menus [MFC], OLE document applications", "in-place activation [MFC], OLE menus and resources", "containers [MFC], OLE container applications", "OLE menus and resources [MFC]"] -ms.assetid: 52bfa086-7d3d-466f-94c7-c7061f3bdb3a --- # Menus and Resources (OLE) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This group of articles explains the use of menus and resources in MFC OLE document applications. OLE visual editing places additional requirements on the menu and other resources provided by OLE document applications because there are a number of modes in which both container and server (component) applications can be started and used. For example, a full-server application can run in any of these three modes: diff --git a/docs/mfc/menus-and-resources-server-additions.md b/docs/mfc/menus-and-resources-server-additions.md index dda5aca9ad4..0bdebe03ea2 100644 --- a/docs/mfc/menus-and-resources-server-additions.md +++ b/docs/mfc/menus-and-resources-server-additions.md @@ -3,10 +3,12 @@ description: "Learn more about: Menus and Resources: Server Additions" title: "Menus and Resources: Server Additions" ms.date: "11/04/2016" helpviewer_keywords: ["OLE visual editing servers [MFC]", "accelerator tables [MFC], server applications", "visual editing [MFC], application menus and resources", "server applications [MFC], accelerator table", "string tables [MFC], visual editing applications", "servers [MFC], menu additions", "resources [MFC], server applications", "OLE server applications [MFC], menus and resources", "string editing [MFC], visual editing applications", "IDP_OLE_INIT_FAILED macro [MFC]", "server applications [MFC], OLE menus and resources", "OLE initialization failure [MFC]"] -ms.assetid: 56ce9e8d-8f41-4db8-8dee-e8b0702d057c --- # Menus and Resources: Server Additions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the changes that need to be made to the menus and other resources in a visual editing server (component) application. A server application requires many additions to the menu structure and other resources because it can be started in one of three modes: stand alone, embedded, or in place. As described in the [Menus and Resources (OLE)](menus-and-resources-ole.md) article, there are a maximum of four sets of menus. All four are used for an MDI full-server application, while only three are used for a miniserver. The application wizard will create the menu layout necessary for the type of server you want. Some customization may be necessary. If you do not use the application wizard, you may want to look at HIERSVR.RC, the resource script for the MFC sample application [HIERSVR](../overview/visual-cpp-samples.md), to see how these changes are implemented. diff --git a/docs/mfc/menus-mfc.md b/docs/mfc/menus-mfc.md index 8bbd4098c79..c1abbae69f7 100644 --- a/docs/mfc/menus-mfc.md +++ b/docs/mfc/menus-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Menus (MFC)" title: "Menus (MFC)" ms.date: "11/04/2016" helpviewer_keywords: ["menus [MFC], updating as context changes", "menus [MFC], MFC resources for working with", "menus [MFC], manipulating during execution", "menus [MFC]"] -ms.assetid: 6a181495-47a9-4356-83fc-b89152d6cb4c --- # Menus (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC supplies two elements to help you work with menus: - Class [CMenu](reference/cmenu-class.md) for manipulating your program's menus at run time. Use the documentation for `CMenu` and the sample to learn how to use `CMenu` effectively. diff --git a/docs/mfc/message-categories.md b/docs/mfc/message-categories.md index 8f26f6242e0..ad100f126fb 100644 --- a/docs/mfc/message-categories.md +++ b/docs/mfc/message-categories.md @@ -3,11 +3,13 @@ description: "Learn more about: Message Categories" title: "Message Categories" ms.date: "11/04/2016" helpviewer_keywords: ["messages [MFC], categories", "control-notification messages [MFC]", "Windows messages [MFC], categories", "controls [MFC], notifications", "command messages [MFC]", "messages [MFC], Windows", "message handling [MFC], message types"] -ms.assetid: 68e1db75-9da6-4a4d-b2c2-dc4d59f8d87b ms.topic: how-to --- # Message Categories +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + What kinds of messages do you write handlers for There are three main categories: 1. Windows messages diff --git a/docs/mfc/message-handlers.md b/docs/mfc/message-handlers.md index 5e8c2495f70..60944d82359 100644 --- a/docs/mfc/message-handlers.md +++ b/docs/mfc/message-handlers.md @@ -3,10 +3,12 @@ description: "Learn more about: Message Handlers" title: "Message Handlers" ms.date: "11/04/2016" helpviewer_keywords: ["message handlers [MFC]", "command handling [MFC], message handlers", "handlers [MFC]", "message handling [MFC], message handler functions", "handlers [MFC], command", "handlers [MFC], message"] -ms.assetid: 51bc4e76-dbe3-4cc2-b026-3199d56b2fa9 --- # Message Handlers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In MFC, a dedicated *handler* function processes each separate message. Message-handler functions are member functions of a class. This documentation uses the terms *message-handler member function*, *message-handler function*, *message handler*, and *handler* interchangeably. Some kinds of message handlers are also called "command handlers." Writing message handlers accounts for a large proportion of your work in writing a framework application. This article family describes how the message-processing mechanism works. diff --git a/docs/mfc/message-handling-and-command-targets.md b/docs/mfc/message-handling-and-command-targets.md index b6f6fe862a7..f53661b8363 100644 --- a/docs/mfc/message-handling-and-command-targets.md +++ b/docs/mfc/message-handling-and-command-targets.md @@ -4,10 +4,12 @@ title: "Message Handling and Command Targets" ms.date: "11/04/2016" f1_keywords: ["IOleCommandTarget"] helpviewer_keywords: ["command targets [MFC]", "message handling [MFC], active documents", "IOleCommandTarget interface [MFC]", "command routing [MFC], command targets"] -ms.assetid: e45ce14c-e6b6-4262-8f3b-4e891e0ec2a3 --- # Message Handling and Command Targets +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The command dispatch interface `IOleCommandTarget` defines a simple and extensible mechanism to query and execute commands. This mechanism is simpler than Automation's `IDispatch` because it relies entirely on a standard set of commands; commands rarely have arguments, and no type information is involved (type safety is diminished for command arguments as well). In the command dispatch interface design, each command belongs to a "command group" which is itself identified with a **GUID**. Therefore, anyone can define a new group and define all the commands within that group without any need to coordinate with Microsoft or any other vendor. (This is essentially the same means of definition as a **dispinterface** plus **dispIDs** in Automation. There is overlap here, although this command routing mechanism is only for command routing and not for scripting/programmability on a large scale as Automation handles.) diff --git a/docs/mfc/message-handling-and-mapping.md b/docs/mfc/message-handling-and-mapping.md index bbbbaee3203..ee575c92be8 100644 --- a/docs/mfc/message-handling-and-mapping.md +++ b/docs/mfc/message-handling-and-mapping.md @@ -3,10 +3,12 @@ description: "Learn more about: Message Handling and Mapping" title: "Message Handling and Mapping" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, messages", "message handling [MFC]", "message maps [MFC]"] -ms.assetid: 62fe2a1b-944c-449d-a0f0-63c11ee0a3cb --- # Message Handling and Mapping +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article family describes how messages and commands are processed by the MFC framework and how you connect them to their handler functions. In traditional programs for Windows, Windows messages are handled in a large switch statement in a window procedure. MFC instead uses [message maps](message-categories.md) to map direct messages to distinct class member functions. Message maps are more efficient than virtual functions for this purpose, and they allow messages to be handled by the most appropriate C++ object — application, document, view, and so on. You can map a single message or a range of messages, command IDs, or control IDs. diff --git a/docs/mfc/message-sending-and-receiving.md b/docs/mfc/message-sending-and-receiving.md index 0aa04b4cd8e..95b7873283f 100644 --- a/docs/mfc/message-sending-and-receiving.md +++ b/docs/mfc/message-sending-and-receiving.md @@ -3,10 +3,12 @@ description: "Learn more about: Message Sending and Receiving" title: "Message Sending and Receiving" ms.date: "11/04/2016" helpviewer_keywords: ["Windows messages [MFC], handling in MFC", "control-notification messages [MFC]", "messages [MFC], receiving", "messages [MFC], MFC", "MFC, messages", "messages [MFC], sending"] -ms.assetid: 9ce189cb-b259-4c3b-b6f2-9cfbed18b98b --- # Message Sending and Receiving +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Consider the sending part of the process and how the framework responds. Most messages result from user interaction with the program. Commands are generated by mouse clicks in menu items or toolbar buttons or by accelerator keystrokes. The user also generates Windows messages by, for example, moving or resizing a window. Other Windows messages are sent when events such as program startup or termination occur, as windows get or lose the focus, and so on. Control-notification messages are generated by mouse clicks or other user interactions with a control, such as a button or list-box control in a dialog box. From ee86516c5a1f4a382e3dc939c2782c44dabadff3 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 20 Feb 2026 12:53:10 -0800 Subject: [PATCH 1638/1799] Batch 4: update files (#6253) --- docs/mfc/messages-and-commands-in-the-framework.md | 4 +++- docs/mfc/messages.md | 4 +++- docs/mfc/methods-of-creating-a-status-bar.md | 4 +++- docs/mfc/methods-of-creating-a-toolbar.md | 4 +++- docs/mfc/methods-of-creating-tool-tips.md | 4 +++- .../mfc-activex-controls-accessing-ambient-properties.md | 4 +++- ...-activex-controls-adding-another-custom-property-page.md | 4 +++- docs/mfc/mfc-activex-controls-adding-custom-events.md | 4 +++- docs/mfc/mfc-activex-controls-adding-custom-methods.md | 4 +++- docs/mfc/mfc-activex-controls-adding-custom-properties.md | 4 +++- ...ex-controls-adding-stock-events-to-an-activex-control.md | 4 +++- docs/mfc/mfc-activex-controls-adding-stock-methods.md | 4 +++- docs/mfc/mfc-activex-controls-adding-stock-properties.md | 4 +++- ...mfc-activex-controls-advanced-property-implementation.md | 4 +++- docs/mfc/mfc-activex-controls-advanced-topics.md | 4 +++- .../mfc-activex-controls-creating-an-automation-server.md | 4 +++- .../mfc-activex-controls-distributing-activex-controls.md | 4 +++- docs/mfc/mfc-activex-controls-events.md | 4 +++- .../mfc-activex-controls-licensing-an-activex-control.md | 4 +++- .../mfc-activex-controls-localizing-an-activex-control.md | 4 +++- docs/mfc/mfc-activex-controls-methods.md | 4 +++- docs/mfc/mfc-activex-controls-optimization.md | 4 +++- .../mfc/mfc-activex-controls-painting-an-activex-control.md | 4 +++- docs/mfc/mfc-activex-controls-properties.md | 4 +++- docs/mfc/mfc-activex-controls-property-pages.md | 4 +++- ...-activex-controls-returning-error-codes-from-a-method.md | 4 +++- docs/mfc/mfc-activex-controls-serializing.md | 4 +++- .../mfc-activex-controls-subclassing-a-windows-control.md | 4 +++- ...vex-controls-using-data-binding-in-an-activex-control.md | 4 +++- docs/mfc/mfc-activex-controls-using-fonts.md | 3 +++ ...activex-controls-using-pictures-in-an-activex-control.md | 4 +++- docs/mfc/mfc-activex-controls-using-stock-property-pages.md | 4 +++- docs/mfc/mfc-activex-controls.md | 4 +++- docs/mfc/mfc-and-atl.md | 6 ++++-- docs/mfc/mfc-application-architecture-classes.md | 3 +++ ...mfc-classes-for-creating-internet-client-applications.md | 4 +++- docs/mfc/mfc-com.md | 3 +++ docs/mfc/mfc-concepts.md | 3 +++ docs/mfc/mfc-desktop-applications.md | 4 +++- docs/mfc/mfc-internet-programming-basics.md | 4 +++- docs/mfc/mfc-internet-programming-tasks.md | 4 +++- docs/mfc/mfc-library-versions.md | 3 +++ docs/mfc/mfc-mbcs-dll-add-on.md | 3 +++ docs/mfc/mfc-technical-notes.md | 4 +++- docs/mfc/mfc-toolbar-implementation.md | 4 +++- docs/mfc/modal-and-modeless-dialog-boxes.md | 4 +++- docs/mfc/month-calendar-control-examples.md | 4 +++- docs/mfc/multipage-documents.md | 4 +++- docs/mfc/multiple-document-types-views-and-frame-windows.md | 4 +++- docs/mfc/notifications-from-a-rich-edit-control.md | 4 +++- docs/mfc/notifications-sent-by-animation-controls.md | 4 +++- docs/mfc/odbc-classes.md | 4 +++- docs/mfc/ole-automation-classes.md | 4 +++- docs/mfc/ole-background-containers-and-servers.md | 4 +++- docs/mfc/ole-background-implementation-strategies.md | 4 +++- docs/mfc/ole-background-linking-and-embedding.md | 4 +++- docs/mfc/ole-background-mfc-implementation.md | 4 +++- docs/mfc/ole-background.md | 4 +++- docs/mfc/ole-classes.md | 4 +++- docs/mfc/ole-common-dialog-classes.md | 4 +++- docs/mfc/ole-container-classes.md | 4 +++- docs/mfc/ole-control-classes.md | 4 +++- docs/mfc/ole-db-classes.md | 4 +++- docs/mfc/ole-drag-and-drop-and-data-transfer-classes.md | 4 +++- docs/mfc/ole-in-mfc.md | 4 +++- docs/mfc/ole-mfc.md | 4 +++- docs/mfc/ole-related-classes.md | 4 +++- docs/mfc/ole-server-classes.md | 4 +++- docs/mfc/on-update-command-ui-macro.md | 4 +++- docs/mfc/oncmdmsg-handler.md | 4 +++- docs/mfc/one-stage-and-two-stage-construction-of-objects.md | 4 +++- docs/mfc/onidle-member-function.md | 4 +++- docs/mfc/opening-files.md | 4 +++- docs/mfc/optimizing-control-drawing.md | 4 +++- docs/mfc/optimizing-persistence-and-initialization.md | 4 +++- docs/mfc/orchestrating-other-window-actions.md | 4 +++- docs/mfc/ordering-items-in-the-header-control.md | 4 +++- docs/mfc/output-device-context-classes.md | 4 +++- docs/mfc/overridable-cwinapp-member-functions.md | 4 +++- docs/mfc/overriding-the-standard-command-routing.md | 4 +++- docs/mfc/overview-of-the-rich-edit-control.md | 4 +++- docs/mfc/paragraph-formatting-in-rich-edit-controls.md | 4 +++- docs/mfc/prerequisites-for-internet-client-classes.md | 4 +++- docs/mfc/print-preview-architecture.md | 4 +++- docs/mfc/printing-and-print-preview.md | 4 +++- docs/mfc/printing-in-rich-edit-controls.md | 4 +++- docs/mfc/printing.md | 4 +++- docs/mfc/processing-header-control-notifications.md | 4 +++- .../processing-notification-messages-in-a-rebar-control.md | 4 +++- ...otification-messages-in-date-and-time-picker-controls.md | 4 +++- ...-notification-messages-in-extended-combo-box-controls.md | 4 +++- .../processing-notification-messages-in-list-controls.md | 4 +++- ...sing-notification-messages-in-month-calendar-controls.md | 4 +++- docs/mfc/processing-tab-control-notification-messages.md | 4 +++- docs/mfc/programmatic-printing.md | 4 +++- ...mming-activex-controls-in-a-activex-control-container.md | 4 +++- docs/mfc/property-sheets-and-property-pages-in-mfc.md | 4 +++- docs/mfc/property-sheets-and-property-pages-mfc.md | 4 +++- docs/mfc/property-sheets-as-wizards.md | 4 +++- docs/mfc/property-sheets-mfc.md | 4 +++- 100 files changed, 301 insertions(+), 95 deletions(-) diff --git a/docs/mfc/messages-and-commands-in-the-framework.md b/docs/mfc/messages-and-commands-in-the-framework.md index 9cb53a25e9f..023b2947a2e 100644 --- a/docs/mfc/messages-and-commands-in-the-framework.md +++ b/docs/mfc/messages-and-commands-in-the-framework.md @@ -3,10 +3,12 @@ description: "Learn more about: Messages and Commands in the Framework" title: "Messages and Commands in the Framework" ms.date: "11/04/2016" helpviewer_keywords: ["events [MFC], command routing in MFC", "event-driven programming [MFC]", "events [MFC], event-driven programming", "message-driven programming [MFC]"] -ms.assetid: d799ed8c-6a9f-4f05-be5d-29cb5bc6d185 --- # Messages and Commands in the Framework +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Applications written for Microsoft Windows are "message driven." In response to events such as mouse clicks, keystrokes, window movements, and so on, Windows sends messages to the proper window. Framework applications process Windows messages like any other application for Windows. But the framework also provides some enhancements that make processing messages easier, more maintainable, and better encapsulated. The following topics introduce the key terms used in the rest of the article family to discuss messages and commands: diff --git a/docs/mfc/messages.md b/docs/mfc/messages.md index 2d0f33dd300..13d244746fa 100644 --- a/docs/mfc/messages.md +++ b/docs/mfc/messages.md @@ -3,10 +3,12 @@ description: "Learn more about: Messages" title: "Messages" ms.date: "11/04/2016" helpviewer_keywords: ["messages, MFC", "messages [MFC]"] -ms.assetid: b1476310-a135-42ca-817c-444fb3675491 --- # Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The message loop in the `Run` member function of class `CWinApp` retrieves queued messages generated by various events. For example, when the user clicks the mouse, Windows sends several mouse-related messages, such as WM_LBUTTONDOWN when the left mouse button is pressed and WM_LBUTTONUP when the left mouse button is released. The framework's implementation of the application message loop dispatches the message to the appropriate window. The important categories of messages are described in [Message Categories](message-categories.md). diff --git a/docs/mfc/methods-of-creating-a-status-bar.md b/docs/mfc/methods-of-creating-a-status-bar.md index 7d4e9bc4cf0..0eaad577a3f 100644 --- a/docs/mfc/methods-of-creating-a-status-bar.md +++ b/docs/mfc/methods-of-creating-a-status-bar.md @@ -3,10 +3,12 @@ description: "Learn more about: Methods of Creating a Status Bar" title: "Methods of Creating a Status Bar" ms.date: "11/04/2016" helpviewer_keywords: ["CStatusBar class [MFC], vs. CStatusBarCtrl", "methods [MFC], creating status bars", "CStatusBarCtrl class [MFC], vs. CStatusBar", "CStatusBarCtrl class [MFC], creating", "methods [MFC]", "status bars [MFC], creating"] -ms.assetid: 9aeaf290-7099-4762-a5ba-9c26705333c9 --- # Methods of Creating a Status Bar +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC provides two classes to create status bars: [CStatusBar](reference/cstatusbar-class.md) and [CStatusBarCtrl](reference/cstatusbarctrl-class.md) (which wraps the Windows common control API). `CStatusBar` provides all of the functionality of the status bar common control, it automatically interacts with menus and toolbars, and it handles many of the required common control settings and structures for you; however, your resulting executable usually will be larger than that created by using `CStatusBarCtrl`. `CStatusBarCtrl` usually results in a smaller executable, and you may prefer to use `CStatusBarCtrl` if you do not intend to integrate the status bar into the MFC architecture. If you plan to use `CStatusBarCtrl` and integrate the status bar into the MFC architecture, you must take additional care to communicate status bar control manipulations to MFC. This communication is not difficult; however, it is additional work that is unneeded when you use `CStatusBar`. diff --git a/docs/mfc/methods-of-creating-a-toolbar.md b/docs/mfc/methods-of-creating-a-toolbar.md index aca7ea41dc3..b3c940a3ae1 100644 --- a/docs/mfc/methods-of-creating-a-toolbar.md +++ b/docs/mfc/methods-of-creating-a-toolbar.md @@ -3,10 +3,12 @@ description: "Learn more about: Methods of Creating a Toolbar" title: "Methods of Creating a Toolbar" ms.date: "11/04/2016" helpviewer_keywords: ["CToolBarCtrl class [MFC], and CToolBar class [MFC]", "CToolBar class [MFC], creating toolbars", "MFC toolbars", "toolbar controls [MFC]", "toolbar controls [MFC], creating", "CToolBarCtrl class [MFC], creating toolbars"] -ms.assetid: f19d8d65-d49f-445c-abe8-d47d3e4101c8 --- # Methods of Creating a Toolbar +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC provides two classes to create toolbars: [CToolBar](reference/ctoolbar-class.md) and [CToolBarCtrl](reference/ctoolbarctrl-class.md) (which wraps the Windows common control API). `CToolBar` provides all of the functionality of the toolbar common control, and it handles many of the required common control settings and structures for you; however, your resulting executable usually will be larger than that created by using `CToolBarCtrl`. `CToolBarCtrl` usually results in a smaller executable, and you may prefer to use `CToolBarCtrl` if you do not intend to integrate the toolbar into the MFC architecture. If you plan to use `CToolBarCtrl` and integrate the toolbar into the MFC architecture, you must take additional care to communicate toolbar control manipulations to MFC. This communication is not difficult; however, it is additional work that is unneeded when you use `CToolBar`. diff --git a/docs/mfc/methods-of-creating-tool-tips.md b/docs/mfc/methods-of-creating-tool-tips.md index a51f80a85ad..7d3de35c5cd 100644 --- a/docs/mfc/methods-of-creating-tool-tips.md +++ b/docs/mfc/methods-of-creating-tool-tips.md @@ -3,10 +3,12 @@ description: "Learn more about: Methods of Creating Tool Tips" title: "Methods of Creating Tool Tips" ms.date: "11/04/2016" helpviewer_keywords: ["CToolTipCtrl class [MFC], creating tool tips", "tool tips [MFC], tool tip controls", "tool tips [MFC], creating"] -ms.assetid: b015e9f4-ddfb-49a4-a5a6-fa2d45e4d328 --- # Methods of Creating Tool Tips +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC provides three classes to create and manage the tool tip control: [CWnd](reference/cwnd-class.md), [CToolBarCtrl](reference/ctoolbarctrl-class.md), [CToolTipCtrl](reference/ctooltipctrl-class.md) and [CMFCToolTipCtrl](reference/cmfctooltipctrl-class.md). The tool tip member functions in these classes wrap the Windows common control API. Class `CToolBarCtrl` and class `CToolTipCtrl` are derived from class `CWnd`. `CWnd` provides four member functions to create and manage tool tips: [EnableToolTips](reference/cwnd-class.md#enabletooltips), [CancelToolTips](reference/cwnd-class.md#canceltooltips), [FilterToolTipMessage](reference/cwnd-class.md#filtertooltipmessage), and [OnToolHitTest](reference/cwnd-class.md#ontoolhittest). See these individual member functions for more information about how they implement tool tips. diff --git a/docs/mfc/mfc-activex-controls-accessing-ambient-properties.md b/docs/mfc/mfc-activex-controls-accessing-ambient-properties.md index 1d6babaf05f..613eacca7a6 100644 --- a/docs/mfc/mfc-activex-controls-accessing-ambient-properties.md +++ b/docs/mfc/mfc-activex-controls-accessing-ambient-properties.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Accessing Ambient Properti title: "MFC ActiveX Controls: Accessing Ambient Properties" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], accessing ambient properties", "properties [MFC], accessing ambient"] -ms.assetid: fdc9db29-e6b0-45d2-a879-8bd60e2058a7 --- # MFC ActiveX Controls: Accessing Ambient Properties +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses how an ActiveX control can access the ambient properties of its control container. A control can obtain information about its container by accessing the container's ambient properties. These properties expose visual characteristics, such as the container's background color, the current font used by the container, and operational characteristics, such as whether the container is currently in user mode or designer mode. A control can use ambient properties to tailor its appearance and behavior to the particular container in which it is embedded. However, a control should never assume that its container will support any particular ambient property. In fact, some containers may not support any ambient properties at all. In the absence of an ambient property, a control should assume a reasonable default value. diff --git a/docs/mfc/mfc-activex-controls-adding-another-custom-property-page.md b/docs/mfc/mfc-activex-controls-adding-another-custom-property-page.md index 7cac0772199..1cc40a9fbaf 100644 --- a/docs/mfc/mfc-activex-controls-adding-another-custom-property-page.md +++ b/docs/mfc/mfc-activex-controls-adding-another-custom-property-page.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Adding Another Custom Prop title: "MFC ActiveX Controls: Adding Another Custom Property Page" ms.date: "11/04/2016" helpviewer_keywords: ["property pages [MFC], MFC ActiveX controls", "custom property pages [MFC]", "ActiveX controls [MFC], property pages", "MFC ActiveX controls [MFC], property pages"] -ms.assetid: fcf7e119-9f29-41a9-908d-e9b1607e08af --- # MFC ActiveX Controls: Adding Another Custom Property Page +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Occasionally, an ActiveX control will have more properties than can reasonably fit on one property page. In this case, you can add property pages to the ActiveX control to display these properties. This article discusses adding new property pages to an ActiveX control that already has at least one property page. For more information on adding stock property pages (font, picture, or color), see the article [MFC ActiveX Controls: Using Stock Property Pages](mfc-activex-controls-using-stock-property-pages.md). diff --git a/docs/mfc/mfc-activex-controls-adding-custom-events.md b/docs/mfc/mfc-activex-controls-adding-custom-events.md index c89a3bcb620..034ada14256 100644 --- a/docs/mfc/mfc-activex-controls-adding-custom-events.md +++ b/docs/mfc/mfc-activex-controls-adding-custom-events.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Adding Custom Events" title: "MFC ActiveX Controls: Adding Custom Events" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], events [MFC]", "EVENT_CUSTOM prefix [MFC]", "custom events [MFC], adding to ActiveX controls", "EVENT_CUSTOM macro [MFC]", "InCircle method [MFC]", "ClickIn event", "FireClickIn event", "COleControl class [MFC], custom events [MFC]", "Click event, custom events [MFC]", "events [MFC], ActiveX controls", "custom events [MFC]", "FireEvent method, adding custom events"] -ms.assetid: c584d053-1e34-47aa-958e-37d3e9b85892 --- # MFC ActiveX Controls: Adding Custom Events +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Custom events differ from stock events in that they are not automatically fired by class `COleControl`. A custom event recognizes a certain action, determined by the control developer, as an event. The event map entries for custom events are represented by the EVENT_CUSTOM macro. The following section implements a custom event for an ActiveX control project that was created using the ActiveX Control Wizard. ## Adding a Custom Event with the Add Event Wizard diff --git a/docs/mfc/mfc-activex-controls-adding-custom-methods.md b/docs/mfc/mfc-activex-controls-adding-custom-methods.md index 3886e34488c..a1b2c458c84 100644 --- a/docs/mfc/mfc-activex-controls-adding-custom-methods.md +++ b/docs/mfc/mfc-activex-controls-adding-custom-methods.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Adding Custom Methods" title: "MFC ActiveX Controls: Adding Custom Methods" ms.date: "09/12/2018" helpviewer_keywords: ["MFC ActiveX controls [MFC], methods", "PtInCircle custom method [MFC]"] -ms.assetid: 8f8dc344-44a0-4021-8db5-4cdd3d700e18 --- # MFC ActiveX Controls: Adding Custom Methods +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Custom methods differ from stock methods in that they are not already implemented by `COleControl`. You must supply the implementation for each custom method you add to your control. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-adding-custom-properties.md b/docs/mfc/mfc-activex-controls-adding-custom-properties.md index a14b72ef64c..f6f15299fde 100644 --- a/docs/mfc/mfc-activex-controls-adding-custom-properties.md +++ b/docs/mfc/mfc-activex-controls-adding-custom-properties.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Adding Custom Properties" title: "MFC ActiveX Controls: Adding Custom Properties" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], properties", "properties [MFC], custom"] -ms.assetid: 85af5167-74c7-427b-b8f3-e0d7b73942e5 --- # MFC ActiveX Controls: Adding Custom Properties +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Custom properties differ from stock properties in that custom properties are not already implemented by the `COleControl` class. A custom property is used to expose a certain state or appearance of an ActiveX control to a programmer using the control. This article describes how to add a custom property to the ActiveX control using the Add Property Wizard and explains the resulting code modifications. Topics include: diff --git a/docs/mfc/mfc-activex-controls-adding-stock-events-to-an-activex-control.md b/docs/mfc/mfc-activex-controls-adding-stock-events-to-an-activex-control.md index 6199bcbffa9..ee97fd6f354 100644 --- a/docs/mfc/mfc-activex-controls-adding-stock-events-to-an-activex-control.md +++ b/docs/mfc/mfc-activex-controls-adding-stock-events-to-an-activex-control.md @@ -4,10 +4,12 @@ title: "MFC ActiveX Controls: Adding Stock Events to an ActiveX Control" ms.date: "11/04/2016" f1_keywords: ["EVENT__STOCK_ERROR", "EVENT__STOCK_READYSTATECHANGE", "ReadyStateChange", "EVENT__STOCK_MOUSEMOVE", "EVENT__STOCK_MOUSEUP", "EVENT__STOCK_DBLCLICK", "KeyPress", "EVENT__STOCK_KEYDOWN", "EVENT__STOCK", "EVENT__STOCK_MOUSEDOWN", "EVENT__STOCK_KEYPRESS", "EVENT__STOCK_CLICK", "EVENT__STOCK_KEYUP"] helpviewer_keywords: ["MFC ActiveX controls [MFC], events", "KeyPress event", "FireDblClick event", "FireMouseDown event", "events [MFC], stock", "FireKeyPress event", "EVENT_STOCK_MOUSEMOVE event", "EVENT_STOCK_CLICK event", "FireClick event", "FireKeyUp event", "FireMouseUp event", "EVENT_STOCK_ERROREVENT event", "EVENT_STOCK_KEYDOWN event", "EVENT_STOCK_MOUSEDOWN event", "EVENT_STOCK_KEYPRESS macro [MFC]", "EVENT_STOCK_KEYUP event", "EVENT_STOCK_DBLCLICK event", "FireError event", "FireKeyDown event", "ReadyStateChange event", "EVENT_STOCK_MOUSEUP event", "FireMouseMove event", "EVENT_STOCK prefix", "EVENT_STOCK_READYSTATECHANGE event", "EVENT_STOCK_KEYPRESS event"] -ms.assetid: 3eeadc67-4b3d-4444-8caa-53054073988a --- # MFC ActiveX Controls: Adding Stock Events to an ActiveX Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Stock events differ from custom events in that they are automatically fired by class [COleControl](reference/colecontrol-class.md). `COleControl` contains predefined member functions that fire events resulting from common actions. Some common actions implemented by `COleControl` include single- and double-clicks on the control, keyboard events, and changes in the state of the mouse buttons. Event map entries for stock events are always preceded by the EVENT_STOCK prefix. ## Stock Events Supported by the Add Event Wizard diff --git a/docs/mfc/mfc-activex-controls-adding-stock-methods.md b/docs/mfc/mfc-activex-controls-adding-stock-methods.md index 7764a1a974e..408b9945866 100644 --- a/docs/mfc/mfc-activex-controls-adding-stock-methods.md +++ b/docs/mfc/mfc-activex-controls-adding-stock-methods.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Adding Stock Methods" title: "MFC ActiveX Controls: Adding Stock Methods" ms.date: "09/12/2018" helpviewer_keywords: ["MFC ActiveX controls [MFC], stock methods", "MFC ActiveX controls [MFC], methods", "DoClick method [MFC]"] -ms.assetid: bc4fad78-cabd-4cc0-a798-464b1a682f0b --- # MFC ActiveX Controls: Adding Stock Methods +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A stock method differs from a custom method in that it is already implemented by class [COleControl](reference/colecontrol-class.md). For example, `COleControl` contains a predefined member function that supports the Refresh method for your control. The dispatch map entry for this stock method is DISP_STOCKFUNC_REFRESH. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-adding-stock-properties.md b/docs/mfc/mfc-activex-controls-adding-stock-properties.md index 8d70bbf4929..574cf734613 100644 --- a/docs/mfc/mfc-activex-controls-adding-stock-properties.md +++ b/docs/mfc/mfc-activex-controls-adding-stock-properties.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Adding Stock Properties" title: "MFC ActiveX Controls: Adding Stock Properties" ms.date: "11/04/2016" helpviewer_keywords: ["BackColor property [MFC]", "properties [MFC], adding stock", "ForeColor property [MFC]", "MFC ActiveX controls [MFC], properties", "foreground colors, ActiveX controls", "foreground colors [MFC]"] -ms.assetid: 8b98c8c5-5b69-4366-87bf-0e61e6668ecb --- # MFC ActiveX Controls: Adding Stock Properties +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Stock properties differ from custom properties in that they are already implemented by the class `COleControl`. `COleControl` contains predefined member functions that support common properties for the control. Some common properties include the control's caption and the foreground and background colors. For information on other stock properties, see [Stock Properties Supported by the Add Property Wizard](#_core_stock_properties_supported_by_classwizard) later in this article. The dispatch map entries for stock properties are always prefixed by DISP_STOCKPROP. This article describes how to add a stock property (in this case, Caption) to an ActiveX control using the Add Property Wizard and explains the resulting code modifications. Topics include: diff --git a/docs/mfc/mfc-activex-controls-advanced-property-implementation.md b/docs/mfc/mfc-activex-controls-advanced-property-implementation.md index 03227889216..d9fd955fb6f 100644 --- a/docs/mfc/mfc-activex-controls-advanced-property-implementation.md +++ b/docs/mfc/mfc-activex-controls-advanced-property-implementation.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Advanced Property Implemen title: "MFC ActiveX Controls: Advanced Property Implementation" ms.date: "09/12/2018" helpviewer_keywords: ["MFC ActiveX controls [MFC], error codes", "properties [MFC], ActiveX controls", "MFC ActiveX controls [MFC], properties"] -ms.assetid: ec2e6759-5a8e-41d8-a275-99af8ff6f32e --- # MFC ActiveX Controls: Advanced Property Implementation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes topics related to implementing advanced properties in an ActiveX control. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-advanced-topics.md b/docs/mfc/mfc-activex-controls-advanced-topics.md index ecf01fac6b0..4cf57c98d20 100644 --- a/docs/mfc/mfc-activex-controls-advanced-topics.md +++ b/docs/mfc/mfc-activex-controls-advanced-topics.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Advanced Topics" title: "MFC ActiveX Controls: Advanced Topics" ms.date: "09/12/2018" helpviewer_keywords: ["MFC ActiveX controls [MFC], error codes", "MFC ActiveX controls [MFC], accessing invisible dialog controls", "MFC ActiveX controls [MFC], advanced topics", "FireError method [MFC]", "MFC ActiveX controls [MFC], database classes", "MFC ActiveX controls [MFC], special keys", "PreTranslateMessage method [MFC]", "MFC ActiveX controls [MFC], parameterized property", "ThrowError method [MFC]"] -ms.assetid: e9e34abb-8e2d-461e-bb9c-a1aec5dcecbd --- # MFC ActiveX Controls: Advanced Topics +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article covers advanced topics related to developing ActiveX controls. These include: - [Using Database Classes in ActiveX Controls](#_core_using_database_classes_in_activex_controls) diff --git a/docs/mfc/mfc-activex-controls-creating-an-automation-server.md b/docs/mfc/mfc-activex-controls-creating-an-automation-server.md index 732f948b9d1..a3a405fd699 100644 --- a/docs/mfc/mfc-activex-controls-creating-an-automation-server.md +++ b/docs/mfc/mfc-activex-controls-creating-an-automation-server.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Creating an Automation Ser title: "MFC ActiveX Controls: Creating an Automation Server" ms.date: "11/04/2016" helpviewer_keywords: ["Automation servers [MFC], MFC ActiveX controls", "ActiveX controls [MFC], Automation server", "MFC ActiveX controls [MFC], Automation server"] -ms.assetid: e0c24ed2-d61c-49ad-a4fa-4e1098d1d39b --- # MFC ActiveX Controls: Creating an Automation Server +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can develop an MFC ActiveX control as an Automation server for the purpose of programmatically embedding that control in another application and calling methods in the control from the application. Such a control would still be available to be hosted in an ActiveX control container. ### To create a control as an Automation server diff --git a/docs/mfc/mfc-activex-controls-distributing-activex-controls.md b/docs/mfc/mfc-activex-controls-distributing-activex-controls.md index a82f3d13a4c..e1a83f2a393 100644 --- a/docs/mfc/mfc-activex-controls-distributing-activex-controls.md +++ b/docs/mfc/mfc-activex-controls-distributing-activex-controls.md @@ -4,10 +4,12 @@ title: "MFC ActiveX Controls: Distributing ActiveX Controls" ms.date: "09/12/2018" f1_keywords: ["GetWindowsDirectory", "GetSystemDirectory"] helpviewer_keywords: ["MFC ActiveX controls [MFC], ANSI or Unicode versions", "RegSvr32.exe", "MFC ActiveX controls [MFC], distributing", "distributing MFC ActiveX controls", "redistributable files, MFC ActiveX controls", "GetSystemDirectory method [MFC]", "registering ActiveX controls", "MSVCRT40.dll", "registry [MFC], registering controls", "LoadLibrary method, registering ActiveX controls", "MFC40U.DLL", "MFC40.DLL", "GetWindowsDirectory method [MFC]", "installing ActiveX controls", "GetProcAddress method, registering ActiveX controls", "MFC ActiveX controls [MFC], installing", "MFC ActiveX controls [MFC], registering", "registering controls", "OLEPRO32.DLL"] -ms.assetid: cd70ac9b-f613-4879-9e81-6381fdfda2a1 --- # MFC ActiveX Controls: Distributing ActiveX Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses several issues related to redistributing ActiveX controls: - [ANSI or Unicode Control Versions](#_core_ansi_or_unicode_control_versions) diff --git a/docs/mfc/mfc-activex-controls-events.md b/docs/mfc/mfc-activex-controls-events.md index 6a6162a9272..0861f1f6ae8 100644 --- a/docs/mfc/mfc-activex-controls-events.md +++ b/docs/mfc/mfc-activex-controls-events.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Events" title: "MFC ActiveX Controls: Events" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], events", "notifications [MFC], notifying containers of events", "custom events [MFC], adding to ActiveX controls", "events [MFC], mapping", "COleControl class [MFC], handling of events", "mappings [MFC], events", "stock events [MFC]", "container events [MFC]", "events [MFC], ActiveX controls", "OLE events [MFC]"] -ms.assetid: e1e57e0c-206b-4923-a0b5-682c26564f74 --- # MFC ActiveX Controls: Events +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + ActiveX controls use events to notify a container that something has happened to the control. Common examples of events include clicks on the control, data entered using the keyboard, and changes in the control's state. When these actions occur, the control fires an event to alert the container. Events are also called messages. diff --git a/docs/mfc/mfc-activex-controls-licensing-an-activex-control.md b/docs/mfc/mfc-activex-controls-licensing-an-activex-control.md index 45eb20a4fa8..c2241ffecc3 100644 --- a/docs/mfc/mfc-activex-controls-licensing-an-activex-control.md +++ b/docs/mfc/mfc-activex-controls-licensing-an-activex-control.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Licensing an ActiveX Contr title: "MFC ActiveX Controls: Licensing an ActiveX Control" ms.date: "11/19/2018" helpviewer_keywords: ["COleObjectFactory class [MFC], licensing controls", "MFC ActiveX controls [MFC], licensing", "VerifyLicenseKey method [MFC]", "VerifyUserLicense method [MFC]", "GetLicenseKey method [MFC]", "licensing ActiveX controls"] -ms.assetid: cacd9e45-701a-4a1f-8f1f-b0b39f6ac303 --- # MFC ActiveX Controls: Licensing an ActiveX Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Licensing support, an optional feature of ActiveX controls, allows you to control who is able to use or distribute the control. (For additional discussion of licensing issues, see Licensing Issues in [Upgrading an Existing ActiveX Control](upgrading-an-existing-activex-control.md).) > [!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-localizing-an-activex-control.md b/docs/mfc/mfc-activex-controls-localizing-an-activex-control.md index 7e25d900478..b226aba58f7 100644 --- a/docs/mfc/mfc-activex-controls-localizing-an-activex-control.md +++ b/docs/mfc/mfc-activex-controls-localizing-an-activex-control.md @@ -4,10 +4,12 @@ title: "MFC ActiveX Controls: Localizing an ActiveX Control" ms.date: "09/12/2018" f1_keywords: ["LocaleID", "AfxOleRegisterTypeLib"] helpviewer_keywords: ["localization, ActiveX controls", "MFC ActiveX controls [MFC], localizing", "LocaleID ambient property [MFC]", "LOCALIZE sample [MFC]"] -ms.assetid: a44b839a-c652-4ec5-b824-04392708a5f9 --- # MFC ActiveX Controls: Localizing an ActiveX Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses procedures for localizing ActiveX control interfaces. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-methods.md b/docs/mfc/mfc-activex-controls-methods.md index a4719418053..6c38e501a25 100644 --- a/docs/mfc/mfc-activex-controls-methods.md +++ b/docs/mfc/mfc-activex-controls-methods.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Methods" title: "MFC ActiveX Controls: Methods" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], methods"] -ms.assetid: e20271de-6ffa-4ba0-848b-bafe6c9e510c --- # MFC ActiveX Controls: Methods +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An ActiveX control fires events to communicate between itself and its control container. A container can also communicate with a control by means of methods and properties. Methods are also called functions. Methods and properties provide an exported interface for use by other applications, such as Automation clients and ActiveX control containers. For more information on ActiveX control properties, see the article [MFC ActiveX Controls: Properties](mfc-activex-controls-properties.md). diff --git a/docs/mfc/mfc-activex-controls-optimization.md b/docs/mfc/mfc-activex-controls-optimization.md index a93fa67f5ef..eae4188a105 100644 --- a/docs/mfc/mfc-activex-controls-optimization.md +++ b/docs/mfc/mfc-activex-controls-optimization.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Optimization" title: "MFC ActiveX Controls: Optimization" ms.date: "09/12/2018" helpviewer_keywords: ["MFC ActiveX controls [MFC], windowless", "flicker-free ActiveX controls", "MFC ActiveX controls [MFC], mouse interaction", "device contexts, unclipped for MFC ActiveX controls", "MFC ActiveX controls [MFC], optimizing", "performance, ActiveX controls", "optimization, ActiveX controls", "MFC ActiveX controls [MFC], flicker-free", "windowless MFC ActiveX controls", "MFC ActiveX controls [MFC], active/inactive state", "optimizing performance, ActiveX controls"] -ms.assetid: 8b11f26a-190d-469b-b594-5336094a0109 --- # MFC ActiveX Controls: Optimization +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains techniques you can use to optimize your ActiveX controls for better performance. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-painting-an-activex-control.md b/docs/mfc/mfc-activex-controls-painting-an-activex-control.md index 6a5ae990337..2e850615b59 100644 --- a/docs/mfc/mfc-activex-controls-painting-an-activex-control.md +++ b/docs/mfc/mfc-activex-controls-painting-an-activex-control.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Painting an ActiveX Contro title: "MFC ActiveX Controls: Painting an ActiveX Control" ms.date: "09/12/2018" helpviewer_keywords: ["MFC ActiveX controls [MFC], painting", "MFC ActiveX controls [MFC], optimizing"] -ms.assetid: 25fff9c0-4dab-4704-aaae-8dfb1065dee3 --- # MFC ActiveX Controls: Painting an ActiveX Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the ActiveX control painting process and how you can alter paint code to optimize the process. (See [Optimizing Control Drawing](optimizing-control-drawing.md) for techniques on how to optimize drawing by not having controls individually restore previously selected GDI objects. After all of the controls have been drawn, the container can automatically restore the original objects.) >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-properties.md b/docs/mfc/mfc-activex-controls-properties.md index 6779f249c19..839b34e745b 100644 --- a/docs/mfc/mfc-activex-controls-properties.md +++ b/docs/mfc/mfc-activex-controls-properties.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Properties" title: "MFC ActiveX Controls: Properties" ms.date: "11/04/2016" helpviewer_keywords: ["properties [MFC], ActiveX controls", "MFC ActiveX controls [MFC], properties", "properties [MFC]"] -ms.assetid: b678a53c-0d9e-476f-8aa0-23b80baaba46 --- # MFC ActiveX Controls: Properties +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An ActiveX control fires events to communicate with its control container. The container, in return, uses methods and properties to communicate with the control. Methods and properties are similar in use and purpose, respectively, to member functions and member variables of a C++ class. Properties are data members of the ActiveX control that are exposed to any container. Properties provide an interface for applications that contain ActiveX controls, such as Automation clients and ActiveX control containers. Properties are also called attributes. diff --git a/docs/mfc/mfc-activex-controls-property-pages.md b/docs/mfc/mfc-activex-controls-property-pages.md index 3fcbd9e8f72..e1514eb2968 100644 --- a/docs/mfc/mfc-activex-controls-property-pages.md +++ b/docs/mfc/mfc-activex-controls-property-pages.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ActiveX Controls: Property Pages" title: "MFC ActiveX Controls: Property Pages" ms.date: "11/19/2018" helpviewer_keywords: ["DDP_ functions [MFC]", "MFC ActiveX controls [MFC], properties", "property pages [MFC], MFC ActiveX controls", "DoDataExchange method [MFC]", "OLEIVERB_PROPERTIES", "CPropertyPageDialog class [MFC]", "MFC ActiveX controls [MFC], property pages"] -ms.assetid: 1506f87a-9fd6-4505-8380-0dbc9636230e --- # MFC ActiveX Controls: Property Pages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Property pages allow an ActiveX control user to view and change ActiveX control properties. These properties are accessed by invoking a control properties dialog box, which contains one or more property pages that provide a customized, graphical interface for viewing and editing the control properties. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md b/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md index e657b702672..7aa30785a26 100644 --- a/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md +++ b/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md @@ -3,11 +3,13 @@ description: "Learn more about: MFC ActiveX Controls: Returning Error Codes From title: "MFC ActiveX Controls: Returning Error Codes From a Method" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], error codes", "SetNotSupported method, using", "errors [MFC], ActiveX control error codes", "GetNotSupported method [MFC]", "FireError method [MFC]", "SCODE, MFC ActiveX controls", "ThrowError method [MFC]"] -ms.assetid: 771fb9c9-2413-4dcc-b386-7bc4c4adeafd ms.topic: troubleshooting-error-codes --- # MFC ActiveX Controls: Returning Error Codes From a Method +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes how to return error codes from an ActiveX control method. To indicate that an error has occurred within a method, you should use the [COleControl::ThrowError](reference/colecontrol-class.md#throwerror) member function, which takes an SCODE (status code) as a parameter. You can use a predefined SCODE or define one of your own. diff --git a/docs/mfc/mfc-activex-controls-serializing.md b/docs/mfc/mfc-activex-controls-serializing.md index 95877d684b8..3cc9f82efc1 100644 --- a/docs/mfc/mfc-activex-controls-serializing.md +++ b/docs/mfc/mfc-activex-controls-serializing.md @@ -4,10 +4,12 @@ title: "MFC ActiveX Controls: Serializing" ms.date: "09/12/2018" f1_keywords: ["_wVerMinor", "DoPropExchange", "_wVerMajor"] helpviewer_keywords: ["MFC ActiveX controls [MFC], version support", "wVerMinor global constant [MFC]", "GetVersion method [MFC]", "ExchangeVersion method [MFC]", "MFC ActiveX controls [MFC], serializing", "DoPropExchange method [MFC]", "versioning ActiveX controls", "wVerMajor global constant"] -ms.assetid: 9d57c290-dd8c-4853-b552-6f17f15ebedd --- # MFC ActiveX Controls: Serializing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses how to serialize an ActiveX control. Serialization is the process of reading from or writing to a persistent storage medium, such as a disk file. The Microsoft Foundation Class (MFC) Library provides built-in support for serialization in class `CObject`. `COleControl` extends this support to ActiveX controls through the use of a property exchange mechanism. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-subclassing-a-windows-control.md b/docs/mfc/mfc-activex-controls-subclassing-a-windows-control.md index 8a871b2d5f9..04ee60c3058 100644 --- a/docs/mfc/mfc-activex-controls-subclassing-a-windows-control.md +++ b/docs/mfc/mfc-activex-controls-subclassing-a-windows-control.md @@ -4,10 +4,12 @@ title: "MFC ActiveX Controls: Subclassing a Windows Control" ms.date: "09/12/2018" f1_keywords: ["precreatewindow", "IsSubclassed"] helpviewer_keywords: ["OnDraw method, MFC ActiveX controls", "subclassing", "DoSuperclassPaint method [MFC]", "subclassing Windows controls", "subclassing, Windows controls", "reflected messages, in ActiveX controls", "PreCreateWindow method, overriding", "MFC ActiveX controls [MFC], subclassed controls", "MFC ActiveX controls [MFC], creating", "IsSubclassed method [MFC]"] -ms.assetid: 3236d4de-401f-49b7-918d-c84559ecc426 --- # MFC ActiveX Controls: Subclassing a Windows Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the process for subclassing a common Windows control to create an ActiveX control. Subclassing an existing Windows control is a quick way to develop an ActiveX control. The new control will have the abilities of the subclassed Windows control, such as painting and responding to mouse clicks. The MFC ActiveX controls sample [BUTTON](../overview/visual-cpp-samples.md) is an example of subclassing a Windows control. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-using-data-binding-in-an-activex-control.md b/docs/mfc/mfc-activex-controls-using-data-binding-in-an-activex-control.md index b979bc1a9a8..95155d02712 100644 --- a/docs/mfc/mfc-activex-controls-using-data-binding-in-an-activex-control.md +++ b/docs/mfc/mfc-activex-controls-using-data-binding-in-an-activex-control.md @@ -4,10 +4,12 @@ title: "MFC ActiveX Controls: Using Data Binding in an ActiveX Control" ms.date: "11/19/2018" f1_keywords: ["bindable", "requestedit", "defaultbind", "displaybind", "dispid"] helpviewer_keywords: ["MFC ActiveX controls [MFC], data binding", "data binding [MFC], MFC ActiveX controls", "data-bound controls [MFC], MFC ActiveX controls", "controls [MFC], data binding", "bound controls [MFC], MFC ActiveX"] -ms.assetid: 476b590a-bf2a-498a-81b7-dd476bd346f1 --- # MFC ActiveX Controls: Using Data Binding in an ActiveX Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + One of the more powerful uses of ActiveX controls is data binding, which allows a property of the control to bind with a specific field in a database. When a user modifies data in this bound property, the control notifies the database and requests that the record field be updated. The database then notifies the control of the success or failure of the request. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls-using-fonts.md b/docs/mfc/mfc-activex-controls-using-fonts.md index dc16f5d4526..1848b68f49d 100644 --- a/docs/mfc/mfc-activex-controls-using-fonts.md +++ b/docs/mfc/mfc-activex-controls-using-fonts.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["notifications [MFC], MFC ActiveX controls fonts", "OnDraw --- # MFC ActiveX Controls: Using Fonts +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If your ActiveX control displays text, you can allow the control user to change the text appearance by changing a font property. Font properties are implemented as font objects and can be one of two types: stock or custom. Stock Font properties are preimplemented font properties that you can add using the Add Property Wizard. Custom Font properties are not preimplemented and the control developer determines the property's behavior and usage. This article covers the following topics: diff --git a/docs/mfc/mfc-activex-controls-using-pictures-in-an-activex-control.md b/docs/mfc/mfc-activex-controls-using-pictures-in-an-activex-control.md index 6703e6d5431..6f3f143caa9 100644 --- a/docs/mfc/mfc-activex-controls-using-pictures-in-an-activex-control.md +++ b/docs/mfc/mfc-activex-controls-using-pictures-in-an-activex-control.md @@ -4,10 +4,12 @@ title: "MFC ActiveX Controls: Using Pictures in an ActiveX Control" ms.date: "11/04/2016" f1_keywords: ["LPPICTUREDISP"] helpviewer_keywords: ["OnDraw method, MFC ActiveX controls", "MFC ActiveX controls [MFC], pictures", "OnDraw method [MFC]", "OnResetState method [MFC]", "CLSID_CPicturePropPage [MFC]"] -ms.assetid: 2e49735c-21b9-4442-bb3d-c82ef258eec9 --- # MFC ActiveX Controls: Using Pictures in an ActiveX Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the common Picture type and how to implement it in your ActiveX control. Topics include: - [Overview of Custom Picture Properties](#_core_overview_of_custom_picture_properties) diff --git a/docs/mfc/mfc-activex-controls-using-stock-property-pages.md b/docs/mfc/mfc-activex-controls-using-stock-property-pages.md index 475aab0f011..0ce6947ce86 100644 --- a/docs/mfc/mfc-activex-controls-using-stock-property-pages.md +++ b/docs/mfc/mfc-activex-controls-using-stock-property-pages.md @@ -4,10 +4,12 @@ title: "MFC ActiveX Controls: Using Stock Property Pages" ms.date: "09/12/2018" f1_keywords: ["CLSID_CPicturePropPage", "CLSID_CColorPropPage", "CLSID_CFontPropPage"] helpviewer_keywords: ["picture stock property pages [MFC]", "CLSID_CFontPropPage [MFC]", "color stock property pages [MFC]", "CLSID_CColorPropPage [MFC]", "fonts [MFC], ActiveX controls", "stock properties [MFC], stock property pages", "CLSID_CPicturePropPage [MFC]", "MFC ActiveX controls [MFC], property pages"] -ms.assetid: 22638d86-ff3e-4124-933e-54b7c2a25968 --- # MFC ActiveX Controls: Using Stock Property Pages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article discusses the stock property pages available for ActiveX controls and how to use them. >[!IMPORTANT] diff --git a/docs/mfc/mfc-activex-controls.md b/docs/mfc/mfc-activex-controls.md index 18ff2df6fdd..f08cd1629c3 100644 --- a/docs/mfc/mfc-activex-controls.md +++ b/docs/mfc/mfc-activex-controls.md @@ -4,10 +4,12 @@ title: "MFC ActiveX Controls" ms.date: "11/19/2018" f1_keywords: ["MFC ActiveX Controls (MFC)"] helpviewer_keywords: ["COleControl class [MFC], MFC ActiveX controls", "ActiveX controls [MFC], MFC", "containers [MFC], MFC ActiveX controls", "MFC ActiveX controls [MFC], serializing", "MFC ActiveX controls [MFC], containers", "serialization [MFC], MFC ActiveX controls", "dispatch maps [MFC], for MFC ActiveX controls", "MFC ActiveX controls [MFC], active/inactive state", "events [MFC], ActiveX controls", "MFC ActiveX controls [MFC]"] -ms.assetid: c911fb74-3afc-4bf3-a0f5-7922b14d9a1b --- # MFC ActiveX Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An ActiveX control is a reusable software component based on the Component Object Model (COM) that supports a wide variety of OLE functionality and can be customized to fit many software needs. >[!IMPORTANT] diff --git a/docs/mfc/mfc-and-atl.md b/docs/mfc/mfc-and-atl.md index d9e499ac1bd..aa2f69dadc0 100644 --- a/docs/mfc/mfc-and-atl.md +++ b/docs/mfc/mfc-and-atl.md @@ -2,15 +2,17 @@ description: "Learn more about: MFC and ATL" title: "MFC and ATL" ms.date: "01/24/2018" -ms.assetid: 31b1a3a8-4154-4c4a-af10-fafc23ecdc5c ms.topic: "overview" ms.custom: intro-overview --- # MFC and ATL +>[!NOTE] +> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Classes (MFC) provide a C++ object-oriented wrapper over Win32 for rapid development of native desktop applications. The Active Template Library (ATL) is a wrapper library that simplifies COM development and is used extensively for creating ActiveX controls. -You can create MFC or ATL programs with Visual Studio Community Edition or higher. The Express editions do not support MFC or ATL. +You can create MFC or ATL programs with Visual Studio Community Edition or higher. The Express editions don't support MFC or ATL. In Visual Studio 2015, Visual C++ is an optional component, and MFC and ATL components are optional sub-components under Visual C++. If you do not select these components when you first install Visual Studio, you will be prompted to install them the first time you attempt to create or open an MFC or ATL project. diff --git a/docs/mfc/mfc-application-architecture-classes.md b/docs/mfc/mfc-application-architecture-classes.md index 6ec1f95b61a..197201a873d 100644 --- a/docs/mfc/mfc-application-architecture-classes.md +++ b/docs/mfc/mfc-application-architecture-classes.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["MFC, classes", "MFC, application development", "classes [ --- # MFC application architecture classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class library (MFC) classes in this category contribute to the architecture of an MFC application. They supply functionality common to most applications. You fill in the framework to add application-specific functionality. Typically, you do so by deriving new classes from the architecture classes, and then adding new members or overriding existing member functions. [Application wizards](reference/mfc-application-wizard.md) generate several types of applications, all of which use the application framework in differing ways. SDI (single document interface) and MDI (multiple document interface) applications make full use of the document/view part of the framework. Other types of applications, such as dialog-based applications, form-based applications, and DLLs, use only some of document/view architecture features. diff --git a/docs/mfc/mfc-classes-for-creating-internet-client-applications.md b/docs/mfc/mfc-classes-for-creating-internet-client-applications.md index f3a6c837e05..d4d0530b4fa 100644 --- a/docs/mfc/mfc-classes-for-creating-internet-client-applications.md +++ b/docs/mfc/mfc-classes-for-creating-internet-client-applications.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC Classes for Creating Internet Client Applica title: "MFC Classes for Creating Internet Client Applications" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, WinInet classes", "WinInet classes [MFC], classes", "classes [MFC], MFC", "Internet client applications [MFC], MFC", "Internet applications [MFC], MFC"] -ms.assetid: 67d34117-9839-4f4b-8bb8-0e4a9471c606 --- # MFC Classes for Creating Internet Client Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC provides the following classes and global functions for writing Internet client applications. Indentation indicates a class is derived from the unindented class above it. `CGopherFile` and `CHttpFile` derive from `CInternetFile`, for example. These classes and global functions are declared in AFXINET.H, except `CFileFind`, which is declared in AFX.H. ## Classes diff --git a/docs/mfc/mfc-com.md b/docs/mfc/mfc-com.md index 9f5a4136d12..4737b866ce6 100644 --- a/docs/mfc/mfc-com.md +++ b/docs/mfc/mfc-com.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["MFC, COM support", "MFC ActiveX controls [MFC], COM suppo --- # MFC COM +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A subset of MFC is designed to support COM, while most of the Active Template Library (ATL) is designed for COM programming. This section of topics describes MFC's support for COM. Active technologies (such as ActiveX controls, Active document containment, OLE, and so on) use the Component Object Model (COM) to enable software components to interact with one another in a networked environment, regardless of the language with which they were created. Active technologies can be used to create applications that run on the desktop or the Internet. For more information, see [Introduction to COM](../atl/introduction-to-com.md) or [The Component Object Model](/windows/win32/com/the-component-object-model). diff --git a/docs/mfc/mfc-concepts.md b/docs/mfc/mfc-concepts.md index 837ceb34f69..3de9b5e8e42 100644 --- a/docs/mfc/mfc-concepts.md +++ b/docs/mfc/mfc-concepts.md @@ -7,6 +7,9 @@ ms.topic: concept-article --- # MFC Concepts +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This section provides conceptual and task-based topics to help you program using the Microsoft Foundation Class (MFC) Library. ## In This Section diff --git a/docs/mfc/mfc-desktop-applications.md b/docs/mfc/mfc-desktop-applications.md index 873618fee18..73e8b385257 100644 --- a/docs/mfc/mfc-desktop-applications.md +++ b/docs/mfc/mfc-desktop-applications.md @@ -4,10 +4,12 @@ title: "MFC Desktop Applications" ms.date: "07/28/2019" f1_keywords: ["MFC"] helpviewer_keywords: ["libraries, MFC", "class libraries, MFC", "MFC, about MFC"] -ms.assetid: 7101cb18-a681-495c-8f2b-069ad20c72f7 --- # MFC Desktop Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class (MFC) Library provides an object-oriented wrapper over much of the Win32 and COM APIs. Although it can be used to create very simple desktop applications, it is most useful when you need to develop more complex user interfaces with multiple controls. You can use MFC to create applications with Office-style user interfaces. For documentation on the Windows platform itself, see [Windows documentation](/windows/index). For information on building Windows applications in C++ without MFC, see [Build desktop Windows apps using the Win32 API](/windows/win32/index). The MFC Reference covers the classes, global functions, global variables, and macros that make up the Microsoft Foundation Class Library. diff --git a/docs/mfc/mfc-internet-programming-basics.md b/docs/mfc/mfc-internet-programming-basics.md index 60d8a09587a..c5619509e17 100644 --- a/docs/mfc/mfc-internet-programming-basics.md +++ b/docs/mfc/mfc-internet-programming-basics.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC Internet Programming Basics" title: "MFC Internet Programming Basics" ms.date: "11/19/2018" helpviewer_keywords: ["ISAPI extensions, programming with ISAPI", "Internet applications [MFC]", "ISAPI", "ActiveX controls [MFC], Internet", "programming [MFC], Internet", "Web applications [MFC], MFC classes", "ISAPI filters [MFC], programming with ISAPI", "Internet applications [MFC], ActiveX controls", "Internet applications [MFC], writing", "Internet applications [MFC], Active technology", "Active technology [MFC]", "Internet content [MFC]", "WinInet classes [MFC]"] -ms.assetid: 6df2dfd0-6e3f-4587-9d01-2a32f00f8a6f --- # MFC Internet Programming Basics +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Microsoft provides many APIs for programming both client and server applications. Many new applications are being written for the Internet, and as technologies, browser capabilities, and security options change, new types of applications will be written. Browsers run on client computers, providing access to the World Wide Web and displaying HTML pages that contain text, graphics, ActiveX controls, and documents. Servers provide FTP, HTTP, and gopher services, and run server extension applications using CGI. Your custom application can retrieve information and provide data on the Internet. >[!IMPORTANT] diff --git a/docs/mfc/mfc-internet-programming-tasks.md b/docs/mfc/mfc-internet-programming-tasks.md index c0911a53a89..3685e6ac8db 100644 --- a/docs/mfc/mfc-internet-programming-tasks.md +++ b/docs/mfc/mfc-internet-programming-tasks.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC Internet Programming Tasks" title: "MFC Internet Programming Tasks" ms.date: "09/12/2018" helpviewer_keywords: ["Internet applications [MFC], getting started", "Internet applications [MFC], first steps"] -ms.assetid: 6377e9b8-07c4-4380-b63b-05f5a9061313 --- # MFC Internet Programming Tasks +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This section contains detailed steps for adding Internet support to your applications. Topics include how to use the MFC classes to Internet-enable your existing applications, and how to add Active document support to your existing COM component. Do you want to create a document with up-to-the-minute stock quotes, Pittsburgh's football scores, and the latest temperature in Antarctica Microsoft provides a number of technologies to help you do that over the Internet. Active technologies include ActiveX controls (formerly OLE controls) and Active documents; WinInet for easily retrieving and saving files across the Internet; and asynchronous monikers for efficient data downloading. Visual Studio provides wizards to help you get started quickly with a starter application. For an introduction to these technologies, see [MFC Internet Programming Basics](mfc-internet-programming-basics.md) and [MFC COM](mfc-com.md). diff --git a/docs/mfc/mfc-library-versions.md b/docs/mfc/mfc-library-versions.md index ff6462e70e0..e266541499b 100644 --- a/docs/mfc/mfc-library-versions.md +++ b/docs/mfc/mfc-library-versions.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["class libraries [MFC], building versions", "version infor --- # MFC Library Versions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The MFC Library is available in versions that support ANSI single-byte and multibyte character set (MBCS) code, as well as versions that support Unicode (encoded as UTF-16LE, the Windows-native character set). Each MFC version is available as a static library or as a shared DLL. There is also a smaller MFC static library version that leaves out MFC controls for dialogs, for applications that are very sensitive to size and don't need those controls. The MFC libraries are available in both debug and release versions for supported architectures that include x86, x64, and ARM processors. You can create both applications (.exe files) and DLLs with any version of the MFC libraries. There is also a set of MFC libraries compiled for interfacing with managed code. The MFC shared DLLs include a version number to indicate library binary compatibility. ## Automatic linking of MFC library versions diff --git a/docs/mfc/mfc-mbcs-dll-add-on.md b/docs/mfc/mfc-mbcs-dll-add-on.md index f64676d47cd..9a8b5621b3c 100644 --- a/docs/mfc/mfc-mbcs-dll-add-on.md +++ b/docs/mfc/mfc-mbcs-dll-add-on.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["MBCS", "MFC"] --- # MFC MBCS DLL Add-on +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Support for MFC and its multibyte character set (MBCS) libraries requires an additional step during Visual Studio installation in Visual Studio 2013 and later. **Visual Studio 2013**: By default, the MFC libraries installed in Visual Studio 2013 only support Unicode development. You need the MBCS DLLs in order to build an MFC project in Visual Studio 2013 that has the **Character Set** property set to **Use Multi-Byte Character Set** or **Not Set**. Download the DLL at [Multibyte MFC Library for Visual Studio 2013](https://www.microsoft.com/download/details.aspx?id=40770). diff --git a/docs/mfc/mfc-technical-notes.md b/docs/mfc/mfc-technical-notes.md index f11bc35414a..57d42e99c87 100644 --- a/docs/mfc/mfc-technical-notes.md +++ b/docs/mfc/mfc-technical-notes.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC Technical Notes" title: "MFC Technical Notes" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, technical notes", "technical notes, MFC", "technical notes [MFC]"] -ms.assetid: 8aa01d66-0b07-4d0a-a080-4bb00c7baaac --- # MFC Technical Notes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A technical note is a document written for programmers by programmers. Each technical note describes a problem or feature that is beyond the scope of the rest of the MFC documentation. The technical notes supplied reflect requests for information from users, as well as specialized information that the MFC developers anticipate advanced users will want. diff --git a/docs/mfc/mfc-toolbar-implementation.md b/docs/mfc/mfc-toolbar-implementation.md index 66b9d9ee497..a97b5840b3c 100644 --- a/docs/mfc/mfc-toolbar-implementation.md +++ b/docs/mfc/mfc-toolbar-implementation.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC Toolbar Implementation" title: "MFC Toolbar Implementation" ms.date: "11/04/2016" helpviewer_keywords: ["toolbars [MFC], creating", "buttons [MFC], MFC toolbars", "toolbars [MFC], docking", "CToolBar class [MFC], creating toolbars", "MFC toolbars", "floating toolbars [MFC]", "toolbars [MFC], floating", "docking toolbars [MFC]", "bitmaps [MFC], toolbar", "toolbar controls [MFC]", "CToolBarCtrl class [MFC], implementing toolbars", "tool tips [MFC], enabling", "toolbars [MFC]", "toolbars [MFC], implementing MFC toolbars"] -ms.assetid: af3319ad-c430-4f90-8361-e6a2c06fd084 --- # MFC Toolbar Implementation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A toolbar is a [control bar](control-bars.md) that contains the bitmap images of controls. These images can behave like pushbuttons, check boxes, or radio buttons. MFC supplies class [CToolbar](reference/ctoolbar-class.md) to manage toolbars. If you enable it, users of MFC toolbars can dock them to the edge of a window or "float" them anywhere within the application window. MFC doesn't support customizable toolbars like those in the development environment. diff --git a/docs/mfc/modal-and-modeless-dialog-boxes.md b/docs/mfc/modal-and-modeless-dialog-boxes.md index 018ff95a740..c939871ca9d 100644 --- a/docs/mfc/modal-and-modeless-dialog-boxes.md +++ b/docs/mfc/modal-and-modeless-dialog-boxes.md @@ -3,10 +3,12 @@ description: "Learn more about: Modal and Modeless Dialog Boxes" title: "Modal and Modeless Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], modeless", "modeless dialog boxes [MFC]", "MFC dialog boxes [MFC], modal", "modal dialog boxes [MFC]"] -ms.assetid: e83df336-5994-4b8f-8233-7942f997315b --- # Modal and Modeless Dialog Boxes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use class [CDialog](reference/cdialog-class.md) to manage two kinds of dialog boxes: - *Modal dialog boxes*, which require the user to respond before continuing the program diff --git a/docs/mfc/month-calendar-control-examples.md b/docs/mfc/month-calendar-control-examples.md index 3881ae480f1..8085cecad97 100644 --- a/docs/mfc/month-calendar-control-examples.md +++ b/docs/mfc/month-calendar-control-examples.md @@ -3,10 +3,12 @@ description: "Learn more about: Month Calendar Control Examples" title: "Month Calendar Control Examples" ms.date: "11/04/2016" helpviewer_keywords: ["month calendar controls [MFC], examples", "CMonthCalCtrl class [MFC], examples"] -ms.assetid: 1af7fb59-d6fd-46e0-aaa5-b0394a0a3ed5 --- # Month Calendar Control Examples +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [CMNCTRL1](../overview/visual-cpp-samples.md) sample application demonstrates the various attributes of the `CMonthCalCtrl` class. The control, found on a separate tab in the sample, demonstrates basic functionality and allows the user to dynamically modify certain attributes. ## See also diff --git a/docs/mfc/multipage-documents.md b/docs/mfc/multipage-documents.md index 664450ef076..4953a61ee3a 100644 --- a/docs/mfc/multipage-documents.md +++ b/docs/mfc/multipage-documents.md @@ -3,10 +3,12 @@ description: "Learn more about: Multipage Documents" title: "Multipage Documents" ms.date: "11/19/2018" helpviewer_keywords: ["pagination [MFC]", "overriding [MFC], View class functions for printing", "OnPrepareDC method [MFC]", "CPrintInfo structure [MFC], multipage documents", "OnEndPrinting method [MFC]", "protocols [MFC], printing protocol", "document pages vs. printer pages [MFC]", "printer mode [MFC]", "printing [MFC], multipage documents", "printers [MFC], printer mode", "documents [MFC], printing", "OnPreparePrinting method [MFC]", "OnPrint method [MFC]", "DoPreparePrinting method and pagination [MFC]", "OnDraw method [MFC], printing", "pagination [MFC], printing multipage documents", "printing [MFC], protocol", "pages [MFC], printing", "OnBeginPrinting method [MFC]", "multipage documents [MFC]", "printing [MFC], pagination", "documents [MFC], paginating"] -ms.assetid: 69626b86-73ac-4b74-b126-9955034835ef --- # Multipage Documents +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the Windows printing protocol and explains how to print documents that contain more than one page. The article covers the following topics: - [Printing protocol](#_core_the_printing_protocol) diff --git a/docs/mfc/multiple-document-types-views-and-frame-windows.md b/docs/mfc/multiple-document-types-views-and-frame-windows.md index bca21f51732..cb992a563d4 100644 --- a/docs/mfc/multiple-document-types-views-and-frame-windows.md +++ b/docs/mfc/multiple-document-types-views-and-frame-windows.md @@ -3,10 +3,12 @@ description: "Learn more about: Multiple Document Types, Views, and Frame Window title: "Multiple Document Types, Views, and Frame Windows" ms.date: "11/19/2018" helpviewer_keywords: ["static splitter windows [MFC]", "multiple views [MFC]", "multiple document types [MFC]", "multiple views [MFC], frame windows", "document classes [MFC], multiple", "documents [MFC], multiple types of", "splitter windows [MFC], dynamic", "dynamic splitter windows [MFC]", "windows [MFC], dynamic splitter", "windows [MFC], static splitter", "multiple frame windows [MFC]", "splitter windows [MFC], static"] -ms.assetid: c6b9e4e0-7c9c-45f1-a804-aeac39c9a128 --- # Multiple Document Types, Views, and Frame Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The standard relationship among a document, its view, and its frame window is described in [Document/View Creation](document-view-creation.md). Many applications support a single document type (but possibly multiple open documents of that type) with a single view on the document and only one frame window per document. But some applications may need to alter one or more of those defaults. ## What do you want to know more about diff --git a/docs/mfc/notifications-from-a-rich-edit-control.md b/docs/mfc/notifications-from-a-rich-edit-control.md index a7478300fc8..f5278d8e970 100644 --- a/docs/mfc/notifications-from-a-rich-edit-control.md +++ b/docs/mfc/notifications-from-a-rich-edit-control.md @@ -3,10 +3,12 @@ description: "Learn more about: Notifications from a Rich Edit Control" title: "Notifications from a Rich Edit Control" ms.date: "11/04/2016" helpviewer_keywords: ["messages [MFC], notification [MFC]", "CRichEditCtrl class [MFC], notifications", "rich edit controls [MFC], notifications", "notifications [MFC], from CRichEditCtrl"] -ms.assetid: eb5304fe-f4f3-4557-9ebf-3095dea383c4 --- # Notifications from a Rich Edit Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Notification messages report events affecting a rich edit control ([CRichEditCtrl](reference/cricheditctrl-class.md)). They can be processed by the parent window or, using message reflection, by the rich edit control itself. Rich edit controls support all of the notification messages used with edit controls as well as several additional ones. You can determine which notification messages a rich edit control sends its parent window by setting its "event mask." To set the event mask for a rich edit control, use the [SetEventMask](reference/cricheditctrl-class.md#seteventmask) member function. You can retrieve the current event mask for a rich edit control by using the [GetEventMask](reference/cricheditctrl-class.md#geteventmask) member function. diff --git a/docs/mfc/notifications-sent-by-animation-controls.md b/docs/mfc/notifications-sent-by-animation-controls.md index a6881465bd3..e900b18a8d9 100644 --- a/docs/mfc/notifications-sent-by-animation-controls.md +++ b/docs/mfc/notifications-sent-by-animation-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Notifications Sent by Animation Controls" title: "Notifications Sent by Animation Controls" ms.date: "11/04/2016" helpviewer_keywords: ["notifications [MFC], animation controls", "CAnimateCtrl class [MFC], notifications", "controls [MFC], animation", "animation controls [MFC], notifications"] -ms.assetid: 584f5824-446b-4a1a-85f7-ef61842c8186 --- # Notifications Sent by Animation Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An animation control ([CAnimateCtrl](reference/canimatectrl-class.md)) sends two different types of notification messages. The notifications are sent in the form of [WM_COMMAND](/windows/win32/menurc/wm-command) messages. The [ACN_START](/windows/win32/Controls/acn-start) message is sent when the animation control has started playing a clip. The [ACN_STOP](/windows/win32/Controls/acn-stop) message is sent when the animation control has finished or stopped playing a clip. diff --git a/docs/mfc/odbc-classes.md b/docs/mfc/odbc-classes.md index c2df2b212e5..d0a77096e4a 100644 --- a/docs/mfc/odbc-classes.md +++ b/docs/mfc/odbc-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: ODBC Classes" title: "ODBC Classes" ms.date: "11/04/2016" helpviewer_keywords: ["database classes [MFC], ODBC", "ODBC classes [MFC]"] -ms.assetid: 6c40fca8-3033-4873-9abe-7f51725de0e0 --- # ODBC Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes work with the other application framework classes to give easy access to a wide variety of databases for which Open Database Connectivity (ODBC) drivers are available. Programs that use ODBC databases will have at least a `CDatabase` object and a `CRecordset` object. diff --git a/docs/mfc/ole-automation-classes.md b/docs/mfc/ole-automation-classes.md index 7422cd998f9..e2d74d8d030 100644 --- a/docs/mfc/ole-automation-classes.md +++ b/docs/mfc/ole-automation-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Automation Classes" title: "OLE Automation Classes" ms.date: "11/04/2016" helpviewer_keywords: ["Automation, classes", "Automation classes [MFC], OLE classes", "OLE Automation [MFC], classes", "Automation classes [MFC]", "OLE Automation [MFC]"] -ms.assetid: 96e5372b-ff8a-4da1-933b-4d9bbf4dceb3 --- # OLE Automation Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes support automation clients (applications that control other applications). Automation servers (applications that can be controlled by other applications) are supported through [dispatch maps](reference/dispatch-maps.md). [COleDispatchDriver](reference/coledispatchdriver-class.md)
diff --git a/docs/mfc/ole-background-containers-and-servers.md b/docs/mfc/ole-background-containers-and-servers.md index 298221f6c60..b9cc3c392e8 100644 --- a/docs/mfc/ole-background-containers-and-servers.md +++ b/docs/mfc/ole-background-containers-and-servers.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Background: Containers and Servers" title: "OLE Background: Containers and Servers" ms.date: "11/04/2016" helpviewer_keywords: ["OLE full-server applications [MFC]", "server applications [MFC], communication with containers", "full-server [MFC]", "server applications [MFC], requirements", "server applications [MFC], defined", "OLE server applications [MFC], about server applications", "server applications [MFC], full-server vs. mini-server", "OLE server applications [MFC], mini-server applications", "OLE containers [MFC], container applications", "containers [MFC], OLE container applications", "server applications [MFC]"] -ms.assetid: dafbb31d-096c-4654-b774-12900d832919 --- # OLE Background: Containers and Servers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A container application is an application that can incorporate embedded or linked items into its own documents. The documents managed by a container application must be able to store and display OLE document components as well as the data created by the application itself. A container application must also allow users to insert new items or edit existing items by activating server applications when necessary. The user-interface requirements of a container application are listed in the article [Containers: User-Interface Issues](containers-user-interface-issues.md). A server application or component application is an application that can create OLE document components for use by container applications. Server applications usually support drag and drop or copying their data to the Clipboard so that a container application can insert the data as an embedded or linked item. An application can be both a container and a server. diff --git a/docs/mfc/ole-background-implementation-strategies.md b/docs/mfc/ole-background-implementation-strategies.md index e23b0f862da..57fe6adffab 100644 --- a/docs/mfc/ole-background-implementation-strategies.md +++ b/docs/mfc/ole-background-implementation-strategies.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Background: Implementation Strategies" title: "OLE Background: Implementation Strategies" ms.date: "11/04/2016" helpviewer_keywords: ["OLE [MFC], development strategy", "OLE applications [MFC], implementing OLE", "applications [OLE], implementing OLE"] -ms.assetid: 0875ddae-99df-488c-82c6-164074a81058 --- # OLE Background: Implementation Strategies +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Depending on your application, there are four possible implementation strategies for adding OLE support: - You are writing a new application. diff --git a/docs/mfc/ole-background-linking-and-embedding.md b/docs/mfc/ole-background-linking-and-embedding.md index 78b8429ce8e..d39790a77ee 100644 --- a/docs/mfc/ole-background-linking-and-embedding.md +++ b/docs/mfc/ole-background-linking-and-embedding.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Background: Linking and Embedding" title: "OLE Background: Linking and Embedding" ms.date: "11/04/2016" helpviewer_keywords: ["OLE embedded items [MFC]", "item types [MFC], defined", "item types [MFC]", "OLE [MFC], linked items", "linked items (OLE) [MFC]", "embedded objects [MFC]", "OLE items [MFC], types"] -ms.assetid: 11107711-eb96-4099-8f5c-7910bb3ecb75 --- # OLE Background: Linking and Embedding +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Using the Paste command in a container application can create an embedded component, or embedded item. The source data for an embedded item is stored as part of the OLE document that contains it. In this way, a document file for a word processor document can contain text and also can contain bitmaps, graphs, formulas, or any other type of data. OLE provides another way to incorporate data from another application: creating a linked component, or linked item, or a link. The steps for creating a linked item are similar to those for creating an embedded item, except that you use the Paste Link command instead of the Paste command. Unlike an embedded component, a linked component stores a path to the original data, which is often in a separate file. diff --git a/docs/mfc/ole-background-mfc-implementation.md b/docs/mfc/ole-background-mfc-implementation.md index 0076752ca40..5f1bce62a1e 100644 --- a/docs/mfc/ole-background-mfc-implementation.md +++ b/docs/mfc/ole-background-mfc-implementation.md @@ -4,10 +4,12 @@ title: "OLE Background: MFC Implementation" ms.date: "11/04/2016" f1_keywords: ["IMarshall", "IMoniker"] helpviewer_keywords: ["MFC libraries, implementing", "OLE MFC library implementation", "OLE IMarshal interface", "IMoniker interface, MFC", "IMarshall class [MFC]", "OLE, compound files", "OLE IMoniker interface", "OLE IUnknown"] -ms.assetid: 2b67016a-d78e-4d60-925f-c28ec8fb6180 --- # OLE Background: MFC Implementation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Because of the size and complexity of the raw OLE API, calling it directly to write OLE applications can be very time consuming. The goal of the Microsoft Foundation Class Library implementation of OLE is to reduce the amount of work you have to do to write full-featured, OLE-capable applications. This article explains the parts of the OLE API that have not been implemented inside MFC. The discussion also explains how what is implemented maps to the OLE section of the Windows SDK. diff --git a/docs/mfc/ole-background.md b/docs/mfc/ole-background.md index 2d89820a306..86be5ffa153 100644 --- a/docs/mfc/ole-background.md +++ b/docs/mfc/ole-background.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Background" title: "OLE Background" ms.date: "11/04/2016" helpviewer_keywords: ["OLE, about OLE"] -ms.assetid: 5f654eb5-66b1-40c9-9215-bb85356a67f8 --- # OLE Background +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + OLE is a mechanism that allows users to create and edit documents containing items or "objects" created by multiple applications. > [!NOTE] diff --git a/docs/mfc/ole-classes.md b/docs/mfc/ole-classes.md index 78d380ba5cc..77233aff1ca 100644 --- a/docs/mfc/ole-classes.md +++ b/docs/mfc/ole-classes.md @@ -4,10 +4,12 @@ title: "OLE Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.ole"] helpviewer_keywords: ["ActiveX classes [MFC]", "classes [MFC], OLE", "OLE classes [MFC]", "OLE [MFC], classes"] -ms.assetid: 4c2b2bca-fafb-4d2d-8498-9ed1e04011d2 --- # OLE Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The OLE classes work with the other application framework classes to provide easy access to the ActiveX API, giving your programs an easy way to provide the power of ActiveX to your users. Using ActiveX, you can: - Create compound documents, which allow users to create and edit documents containing data created by multiple applications, including text, graphics, spreadsheets, sound, or other types of data. diff --git a/docs/mfc/ole-common-dialog-classes.md b/docs/mfc/ole-common-dialog-classes.md index 3c51dfb89b5..da438438f5b 100644 --- a/docs/mfc/ole-common-dialog-classes.md +++ b/docs/mfc/ole-common-dialog-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Common Dialog Classes" title: "OLE Common Dialog Classes" ms.date: "11/04/2016" helpviewer_keywords: ["ActiveX classes [MFC]", "dialog classes [MFC], OLE", "OLE common dialog classes [MFC]", "common dialog classes [MFC]"] -ms.assetid: 706526ae-f94f-4909-a0f8-6b5fe954fd97 --- # OLE Common Dialog Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes handle common OLE tasks by implementing a number of standard OLE dialog boxes. They also provide a consistent user interface for OLE functionality. [COleDialog](reference/coledialog-class.md)
diff --git a/docs/mfc/ole-container-classes.md b/docs/mfc/ole-container-classes.md index 7a9ad84150c..f5186d11cf6 100644 --- a/docs/mfc/ole-container-classes.md +++ b/docs/mfc/ole-container-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Container Classes" title: "OLE Container Classes" ms.date: "11/04/2016" helpviewer_keywords: ["ActiveX classes [MFC]", "container classes [MFC]", "OLE classes [MFC]", "visual editing [MFC], classes", "OLE [MFC], classes", "containers [MFC], OLE container applications"] -ms.assetid: 1e27e1ab-4c22-41eb-8547-6915c72668ae --- # OLE Container Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes are used by container applications. Both `COleLinkingDoc` and `COleDocument` manage collections of `COleClientItem` objects. Rather than deriving your document class from `CDocument`, you'll derive it from `COleLinkingDoc` or `COleDocument`, depending on whether you want support for links to objects embedded in your document. Use a `COleClientItem` object to represent each OLE item in your document that is embedded from another document or is a link to another document. diff --git a/docs/mfc/ole-control-classes.md b/docs/mfc/ole-control-classes.md index 3d29bc98e80..a527fc6d11b 100644 --- a/docs/mfc/ole-control-classes.md +++ b/docs/mfc/ole-control-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Control Classes" title: "OLE Control Classes" ms.date: "11/04/2016" helpviewer_keywords: ["ActiveX classes [MFC]", "custom controls [MFC], classes", "ActiveX controls [MFC], OLE control classes", "ActiveX control classes [MFC]", "OLE controls [MFC], classes", "OLE control classes [MFC]", "reusable component classes [MFC]"] -ms.assetid: 96495ec3-319e-4163-b839-1af0428ed9dd --- # OLE Control Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These are the primary classes you use when writing OLE controls. The `COleControlModule` class in an OLE control module is like the [CWinApp](reference/cwinapp-class.md) class in an application. Each module implements one or more OLE controls; these controls are represented by `COleControl` objects. These controls communicate with their containers using `CConnectionPoint` objects. The `CPictureHolder` and `CFontHolder` classes encapsulate COM interfaces for pictures and fonts, while the `COlePropertyPage` and `CPropExchange` classes help you implement property pages and property persistence for your control. diff --git a/docs/mfc/ole-db-classes.md b/docs/mfc/ole-db-classes.md index 64191ae0fc7..03b1ec49670 100644 --- a/docs/mfc/ole-db-classes.md +++ b/docs/mfc/ole-db-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE DB Classes" title: "OLE DB Classes" ms.date: "11/04/2016" helpviewer_keywords: ["OLE DB consumers, support", "COleDBRecordView class [MFC]"] -ms.assetid: 65245d26-8743-4efd-9a72-90e19aef3c3a --- # OLE DB Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The OLE DB support in MFC currently consists of the class [COLEDBRecordView](reference/coledbrecordview-class.md). `COleDBRecordView` displays database records in controls, through a form view directly connected to a [CRowset](../data/oledb/crowset-class.md) object. For more information about the OLE DB consumer templates, see [List of OLE DB Consumer Templates](../data/oledb/ole-db-consumer-templates-reference.md). ## See also diff --git a/docs/mfc/ole-drag-and-drop-and-data-transfer-classes.md b/docs/mfc/ole-drag-and-drop-and-data-transfer-classes.md index ae1305da27a..ef61be8434f 100644 --- a/docs/mfc/ole-drag-and-drop-and-data-transfer-classes.md +++ b/docs/mfc/ole-drag-and-drop-and-data-transfer-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Drag-and-Drop and Data Transfer Classes" title: "OLE Drag-and-Drop and Data Transfer Classes" ms.date: "11/04/2016" helpviewer_keywords: ["ActiveX classes [MFC]", "OLE drag and drop [MFC], and data transfer classes", "drag and drop [MFC], classes", "data transfer [MFC], OLE", "data transfer classes [MFC]"] -ms.assetid: c8ab2825-ed69-4b88-8ae6-f368b94726b8 --- # OLE Drag-and-Drop and Data Transfer Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes are used in OLE data transfers. They allow data to be transferred between applications by using the Clipboard or through drag and drop. [COleDropSource](reference/coledropsource-class.md)
diff --git a/docs/mfc/ole-in-mfc.md b/docs/mfc/ole-in-mfc.md index 537e4c14f83..d347fe7617b 100644 --- a/docs/mfc/ole-in-mfc.md +++ b/docs/mfc/ole-in-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE in MFC" title: "OLE in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, OLE and", "OLE items", "OLE applications [MFC], about OLE", "OLE [MFC]", "OLE containers [MFC], about OLE", "applications [OLE], about OLE", "OLE component object model (COM)"] -ms.assetid: 5193479d-1239-4697-aea4-e82f92c707ab --- # OLE in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These articles explain the fundamentals of OLE programming using MFC. MFC provides the easiest way to write programs that use OLE: - To use OLE visual editing (in-place activation). diff --git a/docs/mfc/ole-mfc.md b/docs/mfc/ole-mfc.md index 263a4d2b59e..1eaa373f3dc 100644 --- a/docs/mfc/ole-mfc.md +++ b/docs/mfc/ole-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE (MFC)" title: "OLE (MFC)" ms.date: "11/04/2016" helpviewer_keywords: ["OLE [MFC], user-interface topics", "OLE applications [MFC], user interface", "user interfaces, OLE", "applications [OLE], user interface"] -ms.assetid: 61cb5d3e-1108-4e9b-b301-a8d8fcc586cb --- # OLE (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implementing OLE functionality in your program affects your user interface in several ways: - Visual editing (in-place activation) displays the user interface of another program in your program's windows and modifies your program's menus with items from the other program. diff --git a/docs/mfc/ole-related-classes.md b/docs/mfc/ole-related-classes.md index d8b67b66a5e..e2cd7c17f1c 100644 --- a/docs/mfc/ole-related-classes.md +++ b/docs/mfc/ole-related-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE-Related Classes" title: "OLE-Related Classes" ms.date: "11/04/2016" helpviewer_keywords: ["ActiveX classes [MFC]", "OLE classes [MFC]", "OLE [MFC], classes"] -ms.assetid: 2135cf54-1d9d-4e0e-91b4-943b3440effa --- # OLE-Related Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes provide a number of different services, ranging from exceptions to file input and output. [COleObjectFactory](reference/coleobjectfactory-class.md)
diff --git a/docs/mfc/ole-server-classes.md b/docs/mfc/ole-server-classes.md index bb867adb855..01e1a9e5862 100644 --- a/docs/mfc/ole-server-classes.md +++ b/docs/mfc/ole-server-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: OLE Server Classes" title: "OLE Server Classes" ms.date: "11/04/2016" helpviewer_keywords: ["OLE server applications [MFC], server classes", "OLE server documents", "COM components, classes [MFC]", "component classes [MFC]"] -ms.assetid: 8e9b67a2-c0ff-479c-a8d6-19b36c5e6fc6 --- # OLE Server Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes are used by server applications. Server documents are derived from `COleServerDoc` rather than from `CDocument`. Note that because `COleServerDoc` is derived from `COleLinkingDoc`, server documents can also be containers that support linking. The `COleServerItem` class represents a document or portion of a document that can be embedded in another document or linked to. diff --git a/docs/mfc/on-update-command-ui-macro.md b/docs/mfc/on-update-command-ui-macro.md index 12493f28551..0bc1fcfc69f 100644 --- a/docs/mfc/on-update-command-ui-macro.md +++ b/docs/mfc/on-update-command-ui-macro.md @@ -4,11 +4,13 @@ title: "ON_UPDATE_COMMAND_UI Macro" ms.date: "09/06/2019" f1_keywords: ["ON_UPDATE_COMMAND_UI"] helpviewer_keywords: ["ON_UPDATE_COMMAND_UI macro [MFC]", "update handlers [MFC]", "command-handler macros", "updating user-interface objects [MFC]"] -ms.assetid: 3e72b50f-4119-4c82-81cf-6e09b132de05 ms.topic: reference --- # ON_UPDATE_COMMAND_UI Macro +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To connect a user-interface object to a command-update handler in a command-target object, open **Class View**, then right-click on the class to which the handler will be added, and choose **Class Wizard**. Find the user-interface object's ID in the list on the left, then choose **UPDATE_COMMAND_UI** in the right pane and click **Add Handler**. This creates a handler function in the class and adds the appropriate entry in the message map. See [Mapping Messages to Functions](reference/mapping-messages-to-functions.md) for more information. You can specify additional messages to handle in the **Messages** pane. For example, to update a Clear All command in your program's Edit menu, use the **Class Wizard** to add a message-map entry in the selected class, a function declaration for a command-update handler called `OnUpdateEditClearAll` in the class declaration, and an empty function template in the class's implementation file. The function prototype looks like this: diff --git a/docs/mfc/oncmdmsg-handler.md b/docs/mfc/oncmdmsg-handler.md index 86b362ec27e..b40687263d1 100644 --- a/docs/mfc/oncmdmsg-handler.md +++ b/docs/mfc/oncmdmsg-handler.md @@ -4,10 +4,12 @@ title: "OnCmdMsg Handler" ms.date: "11/04/2016" f1_keywords: ["OnCmdMsg"] helpviewer_keywords: ["messages, routing", "handlers [MFC]", "command routing [MFC], OnCmdMsg handler", "handlers, OnCmdMessage [MFC]", "OnCmdMessage method [MFC]"] -ms.assetid: 8df07024-506f-47e7-bba9-1c3bc5ad8ab6 --- # OnCmdMsg Handler +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To accomplish the routing of commands, each command target calls the `OnCmdMsg` member function of the next command target in the sequence. Command targets use `OnCmdMsg` to determine whether they can handle a command and to route it to another command target if they cannot handle it. Each command-target class may override the `OnCmdMsg` member function. The overrides let each class route commands to a particular next target. A frame window, for example, always routes commands to its current child window or view, as shown in the table [Standard Command Route](command-routing.md). diff --git a/docs/mfc/one-stage-and-two-stage-construction-of-objects.md b/docs/mfc/one-stage-and-two-stage-construction-of-objects.md index 7afd60556d4..b1b0ad5b6dd 100644 --- a/docs/mfc/one-stage-and-two-stage-construction-of-objects.md +++ b/docs/mfc/one-stage-and-two-stage-construction-of-objects.md @@ -3,10 +3,12 @@ description: "Learn more about: One-Stage and Two-Stage Construction of Objects" title: "One-Stage and Two-Stage Construction of Objects" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], creating graphic objects", "object creation [MFC], graphic objects", "objects [MFC], graphic objects", "one-stage and two-stage construction of objects [MFC]"] -ms.assetid: 5a1c410c-4a4b-4dd9-a2ec-ced831aa7f21 --- # One-Stage and Two-Stage Construction of Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You have a choice between two techniques for creating graphic objects, such as pens and brushes: - *One-stage construction*: Construct and initialize the object in one stage, all with the constructor. diff --git a/docs/mfc/onidle-member-function.md b/docs/mfc/onidle-member-function.md index 2c69006b57c..8f81ef6c73a 100644 --- a/docs/mfc/onidle-member-function.md +++ b/docs/mfc/onidle-member-function.md @@ -4,10 +4,12 @@ title: "OnIdle Member Function" ms.date: "11/19/2018" f1_keywords: ["OnIdle"] helpviewer_keywords: ["processing messages [MFC]", "OnIdle method [MFC]", "idle loop processing [MFC]", "CWinApp class [MFC], OnIdle method [MFC]", "message handling [MFC], OnIdle method [MFC]"] -ms.assetid: 51adc874-0075-4f76-be1c-79283f46c10b --- # OnIdle Member Function +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When no Windows messages are being processed, the framework calls the [CWinApp](reference/cwinapp-class.md) member function [OnIdle](reference/cwinapp-class.md#onidle) (described in the MFC Library Reference). Override `OnIdle` to perform background tasks. The default version updates the state of user-interface objects such as toolbar buttons and performs cleanup of temporary objects created by the framework in the course of its operations. The following figure illustrates how the message loop calls `OnIdle` when there are no messages in the queue. diff --git a/docs/mfc/opening-files.md b/docs/mfc/opening-files.md index 1901d6e2ee4..364e80e69c4 100644 --- a/docs/mfc/opening-files.md +++ b/docs/mfc/opening-files.md @@ -3,11 +3,13 @@ description: "Learn more about: Opening Files" title: "Opening Files" ms.date: "11/04/2016" helpviewer_keywords: ["Open member functions [MFC]", "CFile class [MFC], variable", "opening files, in MFC", "Open calls [MFC]", "Open method, CFile class [MFC]", "examples [MFC], opening files", "opening files, handling exceptions", "exception handling [MFC], when opening files", "files [MFC], opening", "file objects [MFC]", "MFC, file operations", "opening files [MFC]", "exception handling [MFC], opening files"] -ms.assetid: a991b8ec-b04a-4766-b47e-7485b5dd0b01 ms.topic: how-to --- # Opening Files +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In MFC, the most common way to open a file is a two-stage process. #### To open a file diff --git a/docs/mfc/optimizing-control-drawing.md b/docs/mfc/optimizing-control-drawing.md index f66c88ff25b..0ed7b644291 100644 --- a/docs/mfc/optimizing-control-drawing.md +++ b/docs/mfc/optimizing-control-drawing.md @@ -3,11 +3,13 @@ description: "Learn more about: Optimizing Control Drawing" title: "Optimizing Control Drawing" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], optimizing"] -ms.assetid: 29ff985d-9bf5-4678-b62d-aad12def75fb ms.topic: concept-article --- # Optimizing Control Drawing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When a control is instructed to draw itself into a container-supplied device context, it typically selects GDI objects (such as pens, brushes, and fonts) into the device context, performs its drawing operations, and restores the previous GDI objects. If the container has multiple controls that are to be drawn into the same device context, and each control selects the GDI objects it requires, time can be saved if the controls do not individually restore previously selected objects. After all the controls have been drawn, the container can automatically restore the original objects. To detect whether a container supports this technique, a control can call the [COleControl::IsOptimizedDraw](reference/colecontrol-class.md#isoptimizeddraw) member function. If this function returns **TRUE**, the control can skip the normal step of restoring the previously selected objects. diff --git a/docs/mfc/optimizing-persistence-and-initialization.md b/docs/mfc/optimizing-persistence-and-initialization.md index 6fa231bfd5b..88bfbbbf03a 100644 --- a/docs/mfc/optimizing-persistence-and-initialization.md +++ b/docs/mfc/optimizing-persistence-and-initialization.md @@ -3,11 +3,13 @@ description: "Learn more about: Optimizing Persistence and Initialization" title: "Optimizing Persistence and Initialization" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], optimizing", "performance, ActiveX controls", "optimization, ActiveX controls", "optimizing performance, ActiveX controls"] -ms.assetid: e821e19e-b9eb-49ab-b719-0743420ba80b ms.topic: concept-article --- # Optimizing Persistence and Initialization +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + By default, persistence and initialization in a control are handled by the `DoPropExchange` member function. In a typical control, this function contains calls to several **PX_** functions (`PX_Color`, `PX_Font`, and so on), one for each property. This approach has the advantage that a single `DoPropExchange` implementation can be used for initialization, for persistence in binary format, and for persistence in the so-called "property-bag" format used by some containers. This one function provides all information about the properties and their default values in one convenient place. diff --git a/docs/mfc/orchestrating-other-window-actions.md b/docs/mfc/orchestrating-other-window-actions.md index d58e98acd28..0f909d0693e 100644 --- a/docs/mfc/orchestrating-other-window-actions.md +++ b/docs/mfc/orchestrating-other-window-actions.md @@ -3,11 +3,13 @@ description: "Learn more about: Orchestrating Other Window Actions" title: "Orchestrating Other Window Actions" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], print preview", "context-sensitive Help [MFC], frame windows", "print preview [MFC], and frame windows", "frame windows [MFC], context-sensitive Help", "frame windows [MFC], semimodal states", "context-sensitive Help [MFC]"] -ms.assetid: 5f34eea8-2bf8-4479-95c7-45e8f443db8f ms.topic: concept-article --- # Orchestrating Other Window Actions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The frame window orchestrates semimodal states such as context-sensitive help and print preview. For a description of the frame window's role in print preview, see [Printing and Print Preview](printing-and-print-preview.md). ## See also diff --git a/docs/mfc/ordering-items-in-the-header-control.md b/docs/mfc/ordering-items-in-the-header-control.md index 8fecf83fd9a..e17ef17634e 100644 --- a/docs/mfc/ordering-items-in-the-header-control.md +++ b/docs/mfc/ordering-items-in-the-header-control.md @@ -4,11 +4,13 @@ title: "Ordering Items in the Header Control" ms.date: "11/04/2016" f1_keywords: ["DS_DRAGDROP"] helpviewer_keywords: ["sequence [MFC]", "sequence [MFC], header control items", "OrderToIndex method [MFC]", "DS_DRAGDROP notification [MFC]", "GetOrderArray method [MFC]", "SetOrderArray method [MFC]", "header controls [MFC], ordering items"] -ms.assetid: 5aaef872-75b5-49c5-8fed-6f9a81fca812 ms.topic: concept-article --- # Ordering Items in the Header Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Once you've [added items to a header control](adding-items-to-the-header-control.md), you can manipulate or get information about their order with the following functions: - [CHeaderCtrl::GetOrderArray](reference/cheaderctrl-class.md#getorderarray) and [CHeaderCtrl::SetOrderArray](reference/cheaderctrl-class.md#setorderarray) diff --git a/docs/mfc/output-device-context-classes.md b/docs/mfc/output-device-context-classes.md index cdfed637a81..78ed227889d 100644 --- a/docs/mfc/output-device-context-classes.md +++ b/docs/mfc/output-device-context-classes.md @@ -4,10 +4,12 @@ title: "Output (Device Context) Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.output"] helpviewer_keywords: ["device contexts [MFC], classes", "screen output classes [MFC]", "printing classes [MFC]", "window drawing classes [MFC]", "painting classes [MFC]", "output classes [MFC]"] -ms.assetid: 35fd6435-a38e-42c6-a3fa-cd6f39370fc3 --- # Output (Device Context) Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These classes encapsulate the different types of device contexts available in Windows. Most of the following classes encapsulate a handle to a Windows device context. A device context is a Windows object that contains information about the drawing attributes of a device such as a display or a printer. All drawing calls are made through a device-context object. Additional classes derived from `CDC` encapsulate specialized device-context functionality, including support for Windows metafiles. diff --git a/docs/mfc/overridable-cwinapp-member-functions.md b/docs/mfc/overridable-cwinapp-member-functions.md index 9036701c9f0..fd923a07aac 100644 --- a/docs/mfc/overridable-cwinapp-member-functions.md +++ b/docs/mfc/overridable-cwinapp-member-functions.md @@ -3,10 +3,12 @@ description: "Learn more about: Overridable CWinApp Member Functions" title: "Overridable CWinApp Member Functions" ms.date: "11/04/2016" helpviewer_keywords: ["overriding [MFC], overridable functions in CWinApp", "application class [MFC]", "CWinApp class [MFC], overridables"] -ms.assetid: 07183d5e-734b-45d9-a8b6-9dde4adac0b4 --- # Overridable CWinApp Member Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + [CWinApp](reference/cwinapp-class.md) provides several key overridable member functions (`CWinApp` overrides these members from class [CWinThread](reference/cwinthread-class.md), from which `CWinApp` derives): - [InitInstance](initinstance-member-function.md) diff --git a/docs/mfc/overriding-the-standard-command-routing.md b/docs/mfc/overriding-the-standard-command-routing.md index ba18313793a..f813b8218cc 100644 --- a/docs/mfc/overriding-the-standard-command-routing.md +++ b/docs/mfc/overriding-the-standard-command-routing.md @@ -3,11 +3,13 @@ description: "Learn more about: Overriding the Standard Command Routing" title: "Overriding the Standard Command Routing" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, command routing", "command routing [MFC], overriding", "command handling [MFC], routing commands", "overriding, standard command routing"] -ms.assetid: 872b698a-7432-40c4-9008-68721e8effa5 ms.topic: concept-article --- # Overriding the Standard Command Routing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In rare cases when you must implement some variation of the standard framework routing, you can override it. The idea is to change the routing in one or more classes by overriding `OnCmdMsg` in those classes. Do so: - In the class that breaks the order to pass to a nondefault object. diff --git a/docs/mfc/overview-of-the-rich-edit-control.md b/docs/mfc/overview-of-the-rich-edit-control.md index ae897f634ab..dd13c02671d 100644 --- a/docs/mfc/overview-of-the-rich-edit-control.md +++ b/docs/mfc/overview-of-the-rich-edit-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Overview of the Rich Edit Control" title: "Overview of the Rich Edit Control" ms.date: "11/04/2016" helpviewer_keywords: ["rich edit controls [MFC]"] -ms.assetid: ad589b9f-a3fd-4820-bf1f-6b1965997e68 ms.topic: concept-article --- # Overview of the Rich Edit Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!IMPORTANT] > If you are using a rich edit control in a dialog box (regardless of whether your application is SDI, MDI, or dialog-based), you must call [AfxInitRichEdit](reference/application-information-and-management.md#afxinitrichedit) once before the dialog box is displayed. A typical place to call this function is in your program's `InitInstance` member function. You do not need to call it for each time you display the dialog box, only the first time. You do not have to call `AfxInitRichEdit` if you are working with `CRichEditView`. diff --git a/docs/mfc/paragraph-formatting-in-rich-edit-controls.md b/docs/mfc/paragraph-formatting-in-rich-edit-controls.md index bf891d8c81d..6d186474a34 100644 --- a/docs/mfc/paragraph-formatting-in-rich-edit-controls.md +++ b/docs/mfc/paragraph-formatting-in-rich-edit-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Paragraph Formatting in Rich Edit Controls" title: "Paragraph Formatting in Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["rich edit controls [MFC], paragraph formatting in", "paragraph formatting in CRichEditCtrl [MFC]", "CRichEditCtrl class [MFC], paragraph formatting in", "formatting [MFC], paragraphs"] -ms.assetid: 0df2e4c9-2074-4e41-b913-87cb8c1b4d43 --- # Paragraph Formatting in Rich Edit Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use member functions of the rich edit control ([CRichEditCtrl](reference/cricheditctrl-class.md)) to format paragraphs and to retrieve formatting information. Paragraph formatting attributes include alignment, tabs, indents, and numbering. You can apply paragraph formatting by using the [SetParaFormat](reference/cricheditctrl-class.md#setparaformat) member function. To determine the current paragraph formatting for the selected text, use the [GetParaFormat](reference/cricheditctrl-class.md#getparaformat) member function. The [PARAFORMAT](/windows/win32/api/richedit/ns-richedit-paraformat) structure is used with these member functions to specify paragraph attributes. One of the important members of **PARAFORMAT** is *dwMask*. In `SetParaFormat`, *dwMask* specifies which paragraph attributes will be set by this function call. `GetParaFormat` reports the attributes of the first paragraph in the selection; *dwMask* specifies the attributes that are consistent throughout the selection. diff --git a/docs/mfc/prerequisites-for-internet-client-classes.md b/docs/mfc/prerequisites-for-internet-client-classes.md index 3cc4b6bc083..2f7a948b5b5 100644 --- a/docs/mfc/prerequisites-for-internet-client-classes.md +++ b/docs/mfc/prerequisites-for-internet-client-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Prerequisites for Internet Client Classes" title: "Prerequisites for Internet Client Classes" ms.date: "11/04/2016" helpviewer_keywords: ["Internet files [MFC], writing to", "Internet [MFC], connections", "FTP (File Transfer Protocol), MFC classes", "Gopher prerequisites [MFC]", "files [MFC], writing to", "classes [MFC], connections", "HTTP [MFC], prerequisites for Internet clients", "connections [MFC], classes for", "Internet client class prerequisites [MFC]", "files [MFC], reading", "URLs [MFC], Internet client applications", "prerequisites, Internet client classes [MFC]", "Gopher client applications [MFC]"] -ms.assetid: c51d1dfe-260c-4228-8100-e4efd90e9599 --- # Prerequisites for Internet Client Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Some actions taken by an Internet client (reading a file, for example) have prerequisite actions (in this case, establishing an Internet connection). The following tables list the prerequisites for some client actions. ### General Internet URL (FTP, Gopher, or HTTP) diff --git a/docs/mfc/print-preview-architecture.md b/docs/mfc/print-preview-architecture.md index 4ec11761f33..a47454457b8 100644 --- a/docs/mfc/print-preview-architecture.md +++ b/docs/mfc/print-preview-architecture.md @@ -3,10 +3,12 @@ description: "Learn more about: Print Preview Architecture" title: "Print Preview Architecture" ms.date: "11/04/2016" helpviewer_keywords: ["print preview [MFC], process", "previewing printing", "print preview [MFC], architecture", "printing [MFC], print preview", "print preview [MFC], modifications to MFC"] -ms.assetid: 0efc87e6-ff8d-43c5-9d72-9b729a169115 --- # Print Preview Architecture +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how the MFC framework implements print preview functionality. Topics covered include: - [Print preview process](#_core_the_print_preview_process) diff --git a/docs/mfc/printing-and-print-preview.md b/docs/mfc/printing-and-print-preview.md index b2ca6172204..fab2bc436e3 100644 --- a/docs/mfc/printing-and-print-preview.md +++ b/docs/mfc/printing-and-print-preview.md @@ -3,11 +3,13 @@ description: "Learn more about: Printing and Print Preview" title: "Printing and Print Preview" ms.date: "11/04/2016" helpviewer_keywords: ["printing [MFC]", "previewing printing", "printing [MFC]", "print preview", "printing [MFC], print preview"] -ms.assetid: d15059cd-32de-4450-95f7-e73aece238f6 ms.topic: concept-article --- # Printing and Print Preview +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC supports printing and print preview for your program's documents via class [CView](reference/cview-class.md). For basic printing and print preview, simply override your view class's [OnDraw](reference/cview-class.md#ondraw) member function, which you must do anyway. That function can draw to the view on the screen, to a printer device context for an actual printer, or to a device context that simulates your printer on the screen. You can also add code to manage multipage document printing and preview, to paginate your printed documents, and to add headers and footers to them. diff --git a/docs/mfc/printing-in-rich-edit-controls.md b/docs/mfc/printing-in-rich-edit-controls.md index b984736a3ff..f75b3796583 100644 --- a/docs/mfc/printing-in-rich-edit-controls.md +++ b/docs/mfc/printing-in-rich-edit-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Printing in Rich Edit Controls" title: "Printing in Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["printing [MFC], CRichEditCtrl", "rich edit controls [MFC], printing", "CRichEditCtrl class [MFC], printing"] -ms.assetid: dbda0e40-018f-424e-b5d8-7b489aaf27af ms.topic: concept-article --- # Printing in Rich Edit Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can tell a rich edit control ([CRichEditCtrl](reference/cricheditctrl-class.md)) to render its output for a specified device, such as a printer. You can also specify the output device for which a rich edit control formats its text. To format part of the contents of a rich edit control for a specific device, you can use the [FormatRange](reference/cricheditctrl-class.md#formatrange) member function. The [FORMATRANGE](/windows/win32/api/richedit/ns-richedit-formatrange) structure used with this function specifies the range of text to format as well as the device context (DC) for the target device. diff --git a/docs/mfc/printing.md b/docs/mfc/printing.md index 58d2fd9d619..9bb80b5f90e 100644 --- a/docs/mfc/printing.md +++ b/docs/mfc/printing.md @@ -3,11 +3,13 @@ description: "Learn more about: Printing" title: "Printing" ms.date: "11/04/2016" helpviewer_keywords: ["view classes [MFC], print operations", "documents [MFC], printing", "printing [MFC], from framework", "printing [MFC]"] -ms.assetid: be465e8d-b0c9-4fc5-9fa8-d10486064f76 ms.topic: concept-article --- # Printing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Microsoft Windows implements device-independent display. In MFC, this means that the same drawing calls, in the `OnDraw` member function of your view class, are responsible for drawing on the display and on other devices, such as printers. For print preview, the target device is a simulated printer output to the display. ## Your Role in Printing vs. the Framework's Role diff --git a/docs/mfc/processing-header-control-notifications.md b/docs/mfc/processing-header-control-notifications.md index 0c3aa456c2d..8fef663e015 100644 --- a/docs/mfc/processing-header-control-notifications.md +++ b/docs/mfc/processing-header-control-notifications.md @@ -3,11 +3,13 @@ description: "Learn more about: Processing Header-Control Notifications" title: "Processing Header-Control Notifications" ms.date: "11/04/2016" helpviewer_keywords: ["CHeaderCtrl class [MFC], processing notifications", "controls [MFC], header", "notifications [MFC], processing for CHeaderCtrl", "header controls [MFC], processing notifications", "header control notifications"] -ms.assetid: e6c6af7c-d458-4d33-85aa-48014ccde5f6 ms.topic: concept-article --- # Processing Header-Control Notifications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In your view or dialog class, use the [Class Wizard](reference/mfc-class-wizard.md) to create an [OnChildNotify](reference/cwnd-class.md#onchildnotify) handler function with a switch statement for any header-control ([CHeaderCtrl](reference/cheaderctrl-class.md)) notification messages you want to handle (see [Mapping Messages to Functions](reference/mapping-messages-to-functions.md)). Notifications are sent to the parent window when the user clicks or double-clicks a header item, drags a divider between items, and so on. The notification messages associated with a header control are listed in [Header Control Reference](/windows/win32/controls/header-control-reference) in the Windows SDK. diff --git a/docs/mfc/processing-notification-messages-in-a-rebar-control.md b/docs/mfc/processing-notification-messages-in-a-rebar-control.md index d4b1a732bd9..cd4bf9f3832 100644 --- a/docs/mfc/processing-notification-messages-in-a-rebar-control.md +++ b/docs/mfc/processing-notification-messages-in-a-rebar-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Processing Notification Messages in a Rebar Cont title: "Processing Notification Messages in a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["RBN_ notification messages, description of", "CReBarCtrl class [MFC], notification messages sent by", "RBN_ notification messages [MFC]", "notifications [MFC], CReBarCtrl"] -ms.assetid: 40f43a60-0c18-4d8d-8fab-213a095624f9 ms.topic: concept-article --- # Processing Notification Messages in a Rebar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In the parent class of the rebar control, create an `OnChildNotify` handler function with a switch statement for any rebar-control (`CReBarCtrl`) notification messages you want to handle. Notifications are sent to the parent window when the user drags objects over the rebar control, changes the layout of the rebar bands, deletes bands from the rebar control, and so on. The following notification messages can be sent by the rebar control object: diff --git a/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md b/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md index e8d46f354f6..52eadf5e783 100644 --- a/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md +++ b/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md @@ -4,11 +4,13 @@ title: "Processing Notification Messages in Date and Time Picker Controls" ms.date: "11/04/2016" f1_keywords: ["DTN_CLOSEUP", "DTN_DATETIMECHANGE", "DTN_DROPDOWN"] helpviewer_keywords: ["DTN_DROPDOWN notification [MFC]", "DTN_DATETIMECHANGE notification [MFC]", "DTN_CLOSEUP notification [MFC]", "DateTimePicker control [MFC], handling notifications", "CDateTimeCtrl class [MFC], handling notifications", "DTN_FORMAT notification [MFC]", "DateTimePicker control [MFC]"] -ms.assetid: ffbe29ab-ff80-4609-89f7-260b404439c4 ms.topic: concept-article --- # Processing Notification Messages in Date and Time Picker Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As users interact with the date and time picker control, the control (`CDateTimeCtrl`) sends notification messages to its parent window, usually a view or dialog object. Handle these messages if you want to do something in response. For example, when the user opens the date and time picker to display the embedded month calendar control, the DTN_DROPDOWN notification is sent. Use the [Class Wizard](reference/mfc-class-wizard.md) to add notification handlers to the parent class for those messages you want to implement. diff --git a/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md b/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md index 17f7c1247f2..6f0782a1f0f 100644 --- a/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md +++ b/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Processing Notification Messages in Extended Com title: "Processing Notification Messages in Extended Combo Box Controls" ms.date: "11/04/2016" helpviewer_keywords: ["extended combo boxes [MFC], notifications", "notifications [MFC], extended combo box controls"] -ms.assetid: 4e442758-d054-4746-bb1a-6ff84accb127 ms.topic: concept-article --- # Processing Notification Messages in Extended Combo Box Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As users interact with the extended combo box, the control (`CComboBoxEx`) sends notification messages to its parent window, usually a view or dialog object. Handle these messages if you want to do something in response. For example, when the user activates the drop-down list or clicks in the control's edit box, the CBEN_BEGINEDIT notification is sent. Use the [Class Wizard](reference/mfc-class-wizard.md) to add notification handlers to the parent class for those messages you want to implement. diff --git a/docs/mfc/processing-notification-messages-in-list-controls.md b/docs/mfc/processing-notification-messages-in-list-controls.md index 9381aeaa0e5..5b96ff8b84d 100644 --- a/docs/mfc/processing-notification-messages-in-list-controls.md +++ b/docs/mfc/processing-notification-messages-in-list-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Processing Notification Messages in List Control title: "Processing Notification Messages in List Controls" ms.date: "11/04/2016" helpviewer_keywords: ["processing notifications [MFC]", "CListCtrl class [MFC], processing notifications"] -ms.assetid: 1f0e296e-d2a3-48fc-ae38-51d7fb096f51 ms.topic: concept-article --- # Processing Notification Messages in List Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As users click column headers, drag icons, edit labels, and so on, the list control ([CListCtrl](../mfc/reference/clistctrl-class.md)) sends notification messages to its parent window. Handle these messages if you want to do something in response. For example, when the user clicks a column header, you might want to sort the items based on the contents of the clicked column, as in Microsoft Outlook. Process WM_NOTIFY messages from the list control in your view or dialog class. Use the [Class Wizard](reference/mfc-class-wizard.md) to create an [OnChildNotify](../mfc/reference/cwnd-class.md#onchildnotify) handler function with a switch statement based on which notification message is being handled. diff --git a/docs/mfc/processing-notification-messages-in-month-calendar-controls.md b/docs/mfc/processing-notification-messages-in-month-calendar-controls.md index 7f2c355b6a3..56632401488 100644 --- a/docs/mfc/processing-notification-messages-in-month-calendar-controls.md +++ b/docs/mfc/processing-notification-messages-in-month-calendar-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Processing Notification Messages in Month Calend title: "Processing Notification Messages in Month Calendar Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CMonthCalCtrl class [MFC], notifications", "CMonthCalCtrl class [MFC], day states", "month calendar controls [MFC], notification messages", "notifications [MFC], for CMonthCalCtrl", "notifications [MFC], month calendar control"] -ms.assetid: 607c3e90-0756-493b-9503-ce835a50c7ab ms.topic: concept-article --- # Processing Notification Messages in Month Calendar Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As users interact with the month calendar control (selecting dates and/or viewing a different month), the control (`CMonthCalCtrl`) sends notification messages to its parent window, usually a view or dialog object. Handle these messages if you want to do something in response. For example, when the user selects a new month to view, you could provide a set of dates that should be emphasized. Use the [Class Wizard](reference/mfc-class-wizard.md) to add notification handlers to the parent class for those messages you want to implement. diff --git a/docs/mfc/processing-tab-control-notification-messages.md b/docs/mfc/processing-tab-control-notification-messages.md index 04bb96866dd..55e2b15e573 100644 --- a/docs/mfc/processing-tab-control-notification-messages.md +++ b/docs/mfc/processing-tab-control-notification-messages.md @@ -3,11 +3,13 @@ description: "Learn more about: Processing Tab Control Notification Messages" title: "Processing Tab Control Notification Messages" ms.date: "11/04/2016" helpviewer_keywords: ["notifications [MFC], tab controls", "CTabCtrl class [MFC], processing notifications", "notifications [MFC], processing in CTabCtrl", "processing notifications [MFC]", "tab controls [MFC], processing notifications"] -ms.assetid: 758ccb7a-9e73-48f8-9073-23f7cb09918c ms.topic: concept-article --- # Processing Tab Control Notification Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As users click tabs or buttons, the tab control ([CTabCtrl](../mfc/reference/ctabctrl-class.md)) sends notification messages to its parent window. Handle these messages if you want to do something in response. For example, when the user clicks a tab, you may want to preset control data on the page prior to displaying it. Process WM_NOTIFY messages from the tab control in your view or dialog class. Use the [Class Wizard](reference/mfc-class-wizard.md) to create an [OnChildNotify](../mfc/reference/cwnd-class.md#onchildnotify) handler function with a switch statement based on which notification message is being handled. For a list of the notifications a tab control can send to its parent window, see the **Notifications** section of [Tab Control Reference](/windows/win32/controls/tab-control-reference) in the Windows SDK. diff --git a/docs/mfc/programmatic-printing.md b/docs/mfc/programmatic-printing.md index 079ccaf4b9f..913dff44ca3 100644 --- a/docs/mfc/programmatic-printing.md +++ b/docs/mfc/programmatic-printing.md @@ -3,10 +3,12 @@ description: "Learn more about: Programmatic Printing" title: "Programmatic Printing" ms.date: "11/04/2016" helpviewer_keywords: ["printing [MFC], active documents", "active documents [MFC], printing", "printing [MFC], programmatic", "IPrint interface", "printing [MFC]"] -ms.assetid: 3db0945b-5e13-4be4-86a0-6aecdae565bd --- # Programmatic Printing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + OLE provided the means to uniquely identify persistent documents (`GetClassFile`) and load them into their associated code (`CoCreateInstance`, `QueryInterface(IID_IPersistFile)`, `QueryInterface(IID_IPersistStorage)`, `IPersistFile::Load`, and `IPersistStorage::Load`). To further enable printing documents, active document containment (using an existing OLE design not shipped with OLE 2.0 originally) introduces a base-standard printing interface, `IPrint`, generally available through any object that can load the persistent state of the document type. Each view of an active document can optionally support the `IPrint` interface to provide these capabilities. The `IPrint` interface is defined as follows: diff --git a/docs/mfc/programming-activex-controls-in-a-activex-control-container.md b/docs/mfc/programming-activex-controls-in-a-activex-control-container.md index 594f5d61f3c..327d058bc67 100644 --- a/docs/mfc/programming-activex-controls-in-a-activex-control-container.md +++ b/docs/mfc/programming-activex-controls-in-a-activex-control-container.md @@ -3,10 +3,12 @@ description: "Learn more about: ActiveX Control Containers: Programming ActiveX title: "ActiveX Control Containers: Programming ActiveX Controls in an ActiveX Control Container" ms.date: "09/12/2018" helpviewer_keywords: ["ActiveX control containers [MFC], accessing ActiveX controls", "Confirm Classes dialog box", "wrapper classes [MFC], ActiveX controls", "ActiveX control containers [MFC], wrapper classes", "ActiveX controls [MFC], accessing", "MFC ActiveX controls [MFC], accessing in containers", "header files [MFC], for ActiveX control wrapper class", "wrapper classes [MFC], using", "ActiveX controls [MFC], wrapper classes"] -ms.assetid: ef9b2480-92d6-4191-b16e-8055c4fd7b73 --- # ActiveX Control Containers: Programming ActiveX Controls in an ActiveX Control Container +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the process for accessing the exposed [methods](../mfc/mfc-activex-controls-methods.md) and [properties](../mfc/mfc-activex-controls-properties.md) of embedded ActiveX controls. >[!IMPORTANT] diff --git a/docs/mfc/property-sheets-and-property-pages-in-mfc.md b/docs/mfc/property-sheets-and-property-pages-in-mfc.md index d1ff2461a9e..26ba5d7997f 100644 --- a/docs/mfc/property-sheets-and-property-pages-in-mfc.md +++ b/docs/mfc/property-sheets-and-property-pages-in-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Property Sheets and Property Pages in MFC" title: "Property Sheets and Property Pages in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["property pages [MFC], MFC", "controls [MFC], property sheets", "property sheets, MFC", "tab dialog boxes"] -ms.assetid: e1bede2b-0285-4b88-a052-0f8a372807a2 --- # Property Sheets and Property Pages in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A property sheet, also known as a tab dialog box, is a dialog box that contains property pages. Each property page is based on a dialog template resource and contains controls. It is enclosed on a page with a tab on top. The tab names the page and indicates its purpose. Users click a tab in the property sheet to select a set of controls. Use pages to group the controls in the property sheet into meaningful sets. The contained property sheet typically has several controls of its own. These apply to all pages. diff --git a/docs/mfc/property-sheets-and-property-pages-mfc.md b/docs/mfc/property-sheets-and-property-pages-mfc.md index 6fa12970360..d2ab2c06422 100644 --- a/docs/mfc/property-sheets-and-property-pages-mfc.md +++ b/docs/mfc/property-sheets-and-property-pages-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Property Sheets and Property Pages (MFC)" title: "Property Sheets and Property Pages (MFC)" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], tabs", "property pages [MFC], property sheets", "CPropertyPage class [MFC], property sheets and pages", "CPropertySheet class [MFC], property sheets and pages", "property sheets, property pages"] -ms.assetid: de8fea12-6c35-4cef-8625-b8073a379446 --- # Property Sheets and Property Pages (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An MFC [dialog box](../mfc/dialog-boxes.md) can take on a "tab dialog" look by incorporating property sheets and property pages. Called a "property sheet" in MFC, this kind of dialog box, similar to many dialog boxes in Microsoft Word, Excel, and Visual Studio, appears to contain a stack of tabbed sheets, much like a stack of file folders seen from front to back, or a group of cascaded windows. Controls on the front tab are visible; only the labeled tab is visible on the rear tabs. Property sheets are particularly useful for managing large numbers of properties or settings that fall fairly neatly into several groups. Typically, one property sheet can simplify a user interface by replacing several separate dialog boxes. As of MFC version 4.0, property sheets and property pages are implemented using the common controls that come with Windows 95 and Windows NT version 3.51 and later. diff --git a/docs/mfc/property-sheets-as-wizards.md b/docs/mfc/property-sheets-as-wizards.md index 30372a26477..028073f571a 100644 --- a/docs/mfc/property-sheets-as-wizards.md +++ b/docs/mfc/property-sheets-as-wizards.md @@ -3,10 +3,12 @@ description: "Learn more about: Property Sheets as Wizards" title: "Property Sheets as Wizards" ms.date: "11/04/2016" helpviewer_keywords: ["property sheets, as wizards"] -ms.assetid: 1ea66ecb-23b0-484a-838d-58671a2999b5 --- # Property Sheets as Wizards +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A key characteristic of a wizard property sheet is that navigation is provided with Next or Finish, Back, and Cancel buttons instead of tabs. You need to call [CPropertySheet::SetWizardMode](../mfc/reference/cpropertysheet-class.md#setwizardmode) before calling [CPropertySheet::DoModal](../mfc/reference/cpropertysheet-class.md#domodal) on the property sheet object to take advantage of this feature. The user receives the same [CPropertyPage::OnSetActive](../mfc/reference/cpropertypage-class.md#onsetactive) and [CPropertyPage::OnKillActive](../mfc/reference/cpropertypage-class.md#onkillactive) notifications while moving from one page to another page. Next and Finish buttons are mutually exclusive controls; that is, only one of them will be shown at a time. On the first page, the Next button should be enabled. If the user is on the last page, the Finish button should be enabled. This is not done automatically by the framework. You have to call [CPropertySheet::SetWizardButton](../mfc/reference/cpropertysheet-class.md#setwizardbuttons) on the last page to achieve this. diff --git a/docs/mfc/property-sheets-mfc.md b/docs/mfc/property-sheets-mfc.md index aaf53b3bab6..e387244b3fb 100644 --- a/docs/mfc/property-sheets-mfc.md +++ b/docs/mfc/property-sheets-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Property Sheets (MFC)" title: "Property Sheets (MFC)" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], tabs", "property sheets", "dialog boxes [MFC], property sheets", "tab dialog boxes"] -ms.assetid: 09439f65-921d-45a2-b3cc-e13884a087b1 --- # Property Sheets (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This family of articles explains how to implement support for property sheets in MFC applications. A property sheet, also known as a tab dialog box, provides a way to manage large numbers of controls in a dialog box. The property sheet contains property pages, each based on a separate dialog template resource. You can divide your dialog box's controls into logical groups and put each group on its own property page. ## What do you want to know more about From 61b14130ca3812c7d13ed45167de3ce26dbd6406 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 20 Feb 2026 12:57:28 -0800 Subject: [PATCH 1639/1799] Batch 5: update files (#6252) --- .../providing-drag-and-drop-support-for-header-items.md | 4 +++- docs/mfc/providing-flicker-free-activation.md | 4 +++- docs/mfc/providing-mouse-interaction-while-inactive.md | 4 +++- docs/mfc/providing-windowless-activation.md | 4 +++- docs/mfc/reading-and-writing-files.md | 4 +++- docs/mfc/ready-to-use-array-classes.md | 4 +++- docs/mfc/ready-to-use-list-classes.md | 4 +++- docs/mfc/ready-to-use-map-classes.md | 4 +++- docs/mfc/rebar-controls-and-bands.md | 4 +++- docs/mfc/receiving-notification-from-common-controls.md | 4 +++- .../recommendations-for-choosing-a-collection-class.md | 4 +++- docs/mfc/recommendations-for-handling-input-output.md | 4 +++- docs/mfc/reference/add-class-from-typelib-wizard.md | 4 +++- docs/mfc/reference/add-idl-mfc-method-wizard.md | 3 +++ ...dd-interface-definition-library-mfc-property-wizard.md | 3 +++ .../reference/adding-an-mfc-class-from-a-type-library.md | 3 +++ docs/mfc/reference/adding-an-mfc-class.md | 4 +++- docs/mfc/reference/adding-an-mfc-message-handler.md | 4 +++- docs/mfc/reference/adding-an-mfc-odbc-consumer.md | 4 +++- .../reference/adding-atl-support-to-your-mfc-project.md | 8 ++++---- .../reference/advanced-features-mfc-application-wizard.md | 4 +++- docs/mfc/reference/afx-extension-module-structure.md | 4 +++- docs/mfc/reference/afx-global-data-structure.md | 4 +++- docs/mfc/reference/afx-messages.md | 4 +++- docs/mfc/reference/application-control.md | 3 +++ .../reference/application-information-and-management.md | 3 +++ .../application-settings-mfc-activex-control-wizard.md | 4 +++- docs/mfc/reference/application-settings-mfc-dll-wizard.md | 4 +++- .../reference/application-type-mfc-application-wizard.md | 4 +++- docs/mfc/reference/buffercommand-enumeration.md | 3 +++ .../reference/cacceleratedeceleratetransition-class.md | 4 +++- docs/mfc/reference/callback-functions-used-by-mfc.md | 4 +++- docs/mfc/reference/canimatectrl-class.md | 4 +++- docs/mfc/reference/canimationbaseobject-class.md | 4 +++- docs/mfc/reference/canimationcolor-class.md | 4 +++- docs/mfc/reference/canimationcontroller-class.md | 4 +++- docs/mfc/reference/canimationgroup-class.md | 4 +++- docs/mfc/reference/canimationmanagereventhandler-class.md | 4 +++- docs/mfc/reference/canimationpoint-class.md | 3 +++ docs/mfc/reference/canimationrect-class.md | 4 +++- docs/mfc/reference/canimationsize-class.md | 4 +++- .../reference/canimationstoryboardeventhandler-class.md | 4 +++- docs/mfc/reference/canimationtimereventhandler-class.md | 4 +++- docs/mfc/reference/canimationvalue-class.md | 4 +++- docs/mfc/reference/canimationvariable-class.md | 4 +++- .../reference/canimationvariablechangehandler-class.md | 4 +++- .../canimationvariableintegerchangehandler-class.md | 4 +++- docs/mfc/reference/carchive-class.md | 3 +++ docs/mfc/reference/carchiveexception-class.md | 4 +++- docs/mfc/reference/carray-class.md | 4 +++- docs/mfc/reference/casyncmonikerfile-class.md | 4 +++- docs/mfc/reference/casyncsocket-class.md | 3 +++ docs/mfc/reference/cautohidedocksite-class.md | 4 +++- docs/mfc/reference/cbasekeyframe-class.md | 3 +++ docs/mfc/reference/cbasepane-class.md | 3 +++ docs/mfc/reference/cbasetabbedpane-class.md | 4 +++- docs/mfc/reference/cbasetransition-class.md | 4 +++- docs/mfc/reference/cbitmap-class.md | 4 +++- docs/mfc/reference/cbitmapbutton-class.md | 4 +++- docs/mfc/reference/cbitmaprendertarget-class.md | 4 +++- docs/mfc/reference/cbrush-class.md | 3 +++ docs/mfc/reference/cbutton-class.md | 4 +++- docs/mfc/reference/cbytearray-class.md | 4 +++- docs/mfc/reference/ccacheddatapathproperty-class.md | 4 +++- docs/mfc/reference/cchecklistbox-class.md | 3 +++ docs/mfc/reference/cclientdc-class.md | 4 +++- docs/mfc/reference/ccmdtarget-class.md | 3 +++ docs/mfc/reference/ccmdui-class.md | 4 +++- docs/mfc/reference/ccolordialog-class.md | 4 +++- docs/mfc/reference/ccombobox-class.md | 3 +++ docs/mfc/reference/ccomboboxex-class.md | 4 +++- docs/mfc/reference/ccommandlineinfo-class.md | 3 +++ docs/mfc/reference/ccommondialog-class.md | 4 +++- docs/mfc/reference/cconnectionpoint-class.md | 4 +++- docs/mfc/reference/cconstanttransition-class.md | 4 +++- docs/mfc/reference/ccontextmenumanager-class.md | 4 +++- docs/mfc/reference/ccontrolbar-class.md | 4 +++- docs/mfc/reference/ccreatecontext-structure.md | 4 +++- docs/mfc/reference/ccriticalsection-class.md | 3 +++ docs/mfc/reference/cctrlview-class.md | 4 +++- docs/mfc/reference/ccubictransition-class.md | 4 +++- docs/mfc/reference/ccustominterpolator-class.md | 4 +++- docs/mfc/reference/ccustomtransition-class.md | 4 +++- docs/mfc/reference/cd2dbitmap-class.md | 3 +++ docs/mfc/reference/cd2dbitmapbrush-class.md | 4 +++- docs/mfc/reference/cd2dbrush-class.md | 3 +++ docs/mfc/reference/cd2dbrushproperties-class.md | 4 +++- docs/mfc/reference/cd2dellipse-class.md | 4 +++- docs/mfc/reference/cd2dgeometry-class.md | 4 +++- docs/mfc/reference/cd2dgeometrysink-class.md | 4 +++- docs/mfc/reference/cd2dgradientbrush-class.md | 4 +++- docs/mfc/reference/cd2dlayer-class.md | 4 +++- docs/mfc/reference/cd2dlineargradientbrush-class.md | 4 +++- docs/mfc/reference/cd2dmesh-class.md | 4 +++- docs/mfc/reference/cd2dpathgeometry-class.md | 3 +++ docs/mfc/reference/cd2dpointf-class.md | 4 +++- docs/mfc/reference/cd2dpointu-class.md | 4 +++- docs/mfc/reference/cd2dradialgradientbrush-class.md | 4 +++- docs/mfc/reference/cd2drectf-class.md | 4 +++- docs/mfc/reference/cd2drectu-class.md | 4 +++- 100 files changed, 301 insertions(+), 83 deletions(-) diff --git a/docs/mfc/providing-drag-and-drop-support-for-header-items.md b/docs/mfc/providing-drag-and-drop-support-for-header-items.md index 0d8f5e116fa..283f10cc348 100644 --- a/docs/mfc/providing-drag-and-drop-support-for-header-items.md +++ b/docs/mfc/providing-drag-and-drop-support-for-header-items.md @@ -3,11 +3,13 @@ description: "Learn more about: Providing Drag-and-Drop Support for Header Items title: "Providing Drag-and-Drop Support for Header Items" ms.date: "11/04/2016" helpviewer_keywords: ["HDS_DRAGDROP style", "header items in header controls", "CHeaderCtrl class [MFC], drag and drop support", "HDN_ notifications [MFC]"] -ms.assetid: 93a152ec-804f-488f-b260-b3a438d0dc0f ms.topic: concept-article --- # Providing Drag-and-Drop Support for Header Items +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To provide drag-and-drop support for header items, specify the HDS_DRAGDROP style. Drag-and-drop support for header items gives the user the ability to reorder the header items of a header control. The default behavior provides a semitransparent drag image of the header item being dragged and a visual indicator of the new position, if the header item is dropped. As with common drag-and-drop functionality, you can extend the default drag-and-drop behavior by handling the HDN_BEGINDRAG and HDN_ENDDRAG notifications. You can also customize the appearance of the drag image by overriding the [CHeaderCtrl::CreateDragImage](../mfc/reference/cheaderctrl-class.md#createdragimage) member function. diff --git a/docs/mfc/providing-flicker-free-activation.md b/docs/mfc/providing-flicker-free-activation.md index 177d650be4e..edd2defede6 100644 --- a/docs/mfc/providing-flicker-free-activation.md +++ b/docs/mfc/providing-flicker-free-activation.md @@ -3,11 +3,13 @@ description: "Learn more about: Providing Flicker-Free Activation" title: "Providing Flicker-Free Activation" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], flicker-free", "flicker, MFC ActiveX controls", "activation [MFC], flicker-free"] -ms.assetid: bcb24b77-31d8-44a0-8c58-2ea6213b4c43 ms.topic: concept-article --- # Providing Flicker-Free Activation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If your control draws itself identically in the inactive and active states (and does not use windowless activation), you can eliminate the drawing operations and the accompanying visual flicker that normally occur when making the transition between the inactive and active states. To do this, include the **noFlickerActivate** flag in the set of flags returned by [COleControl::GetControlFlags](../mfc/reference/colecontrol-class.md#getcontrolflags). For example: [!code-cpp[NVC_MFC_AxOpt#5](../mfc/codesnippet/cpp/providing-flicker-free-activation_1.cpp)] diff --git a/docs/mfc/providing-mouse-interaction-while-inactive.md b/docs/mfc/providing-mouse-interaction-while-inactive.md index 21a2b685851..446aa4c6892 100644 --- a/docs/mfc/providing-mouse-interaction-while-inactive.md +++ b/docs/mfc/providing-mouse-interaction-while-inactive.md @@ -3,11 +3,13 @@ description: "Learn more about: Providing Mouse Interaction While Inactive" title: "Providing Mouse Interaction While Inactive" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], mouse interaction"] -ms.assetid: b09106bf-44c7-4b9b-a6d9-0d624f16f5b3 ms.topic: concept-article --- # Providing Mouse Interaction While Inactive +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If your control is not immediately activated, you may still want it to process WM_SETCURSOR and WM_MOUSEMOVE messages, even though the control has no window of its own. This can be accomplished by enabling `COleControl`'s implementation of the `IPointerInactive` interface, which is disabled by default. (See the *ActiveX SDK* for a description of this interface.) To enable it, include the pointerInactive flag in the set of flags returned by [COleControl::GetControlFlags](../mfc/reference/colecontrol-class.md#getcontrolflags): [!code-cpp[NVC_MFC_AxOpt#5](../mfc/codesnippet/cpp/providing-mouse-interaction-while-inactive_1.cpp)] diff --git a/docs/mfc/providing-windowless-activation.md b/docs/mfc/providing-windowless-activation.md index cf11fd11d9b..d30b308b309 100644 --- a/docs/mfc/providing-windowless-activation.md +++ b/docs/mfc/providing-windowless-activation.md @@ -3,11 +3,13 @@ description: "Learn more about: Providing Windowless Activation" title: "Providing Windowless Activation" ms.date: "11/04/2016" helpviewer_keywords: ["windowless activation of MFC ActiveX controls", "activation [MFC], MFC ActiveX controls", "MFC ActiveX controls [MFC], activate options", "activation [MFC], windowless"] -ms.assetid: 094903b5-c344-42fa-96ff-ce01e16891c5 ms.topic: concept-article --- # Providing Windowless Activation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Window creation code (that is, everything that happens when you call `CreateWindow`) is costly to execute. A control that maintains an on-screen window has to manage messages for the window. Windowless controls are therefore faster than controls with windows. A further advantage of windowless controls is that, unlike windowed controls, windowless controls support transparent painting and nonrectangular screen regions. A common example of a transparent control is a text control with a transparent background. The controls paints the text but not the background, so whatever is under the text shows through. Newer forms often make use of nonrectangular controls, such as arrows and round buttons. diff --git a/docs/mfc/reading-and-writing-files.md b/docs/mfc/reading-and-writing-files.md index 22afa9e55f8..1a536cdadb6 100644 --- a/docs/mfc/reading-and-writing-files.md +++ b/docs/mfc/reading-and-writing-files.md @@ -3,11 +3,13 @@ description: "Learn more about: Reading and Writing Files" title: "Reading and Writing Files" ms.date: "11/04/2016" helpviewer_keywords: ["CFile class [MFC], objects", "examples [MFC], reading files", "files [MFC], writing to", "examples [MFC], writing to files", "files [MFC], reading", "MFC, file operations", "CFile class [MFC], reading and writing CFile objects", "reading files", "writing to files [MFC]"] -ms.assetid: cac0c826-ba56-495f-99b3-ce6336f65763 ms.topic: how-to --- # Reading and Writing Files +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you've used the C run-time library file-handling functions, MFC reading and writing operations will appear familiar. This article describes reading directly from and writing directly to a `CFile` object. You can also do buffered file I/O with the [CArchive](../mfc/reference/carchive-class.md) class. #### To read from and write to the file diff --git a/docs/mfc/ready-to-use-array-classes.md b/docs/mfc/ready-to-use-array-classes.md index 16f2460eccf..f63012d0816 100644 --- a/docs/mfc/ready-to-use-array-classes.md +++ b/docs/mfc/ready-to-use-array-classes.md @@ -4,10 +4,12 @@ title: "Ready-to-Use Array Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.array"] helpviewer_keywords: ["arrays [MFC], classes", "collection classes [MFC], arrays", "classes [MFC], array"] -ms.assetid: fdeabf95-2fe7-43a8-8f88-d954133caf52 --- # Ready-to-Use Array Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following classes are ready-to-use array classes. [CByteArray](../mfc/reference/cbytearray-class.md)
diff --git a/docs/mfc/ready-to-use-list-classes.md b/docs/mfc/ready-to-use-list-classes.md index 7e242c1ad12..50647fdfc75 100644 --- a/docs/mfc/ready-to-use-list-classes.md +++ b/docs/mfc/ready-to-use-list-classes.md @@ -4,10 +4,12 @@ title: "Ready-to-Use List Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.list"] helpviewer_keywords: ["classes [MFC], list", "list classes [MFC]", "collection classes [MFC], lists"] -ms.assetid: aed8e9bd-edb7-4620-84a2-77c20322abd7 --- # Ready-to-Use List Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following classes are ready-to-use list classes. [CObList](../mfc/reference/coblist-class.md)
diff --git a/docs/mfc/ready-to-use-map-classes.md b/docs/mfc/ready-to-use-map-classes.md index 2c2b8674f79..002957165bd 100644 --- a/docs/mfc/ready-to-use-map-classes.md +++ b/docs/mfc/ready-to-use-map-classes.md @@ -4,10 +4,12 @@ title: "Ready-to-Use Map Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.map"] helpviewer_keywords: ["collection classes [MFC], maps", "classes [MFC], map", "map classes [MFC]"] -ms.assetid: 3f0b1c05-2243-4d4d-98d4-429fc3310c9f --- # Ready-to-Use Map Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following classes are ready-to-use map classes. [CMapPtrToPtr](../mfc/reference/cmapptrtoptr-class.md)
diff --git a/docs/mfc/rebar-controls-and-bands.md b/docs/mfc/rebar-controls-and-bands.md index 4efeb0795a6..0b14f9dbb4a 100644 --- a/docs/mfc/rebar-controls-and-bands.md +++ b/docs/mfc/rebar-controls-and-bands.md @@ -3,10 +3,12 @@ description: "Learn more about: Rebar Controls and Bands" title: "Rebar Controls and Bands" ms.date: "11/04/2016" helpviewer_keywords: ["rebar controls [MFC], working with bands in", "bands, in rebar controls"] -ms.assetid: b647e7a5-9ea7-48b1-8e5f-096d104748f0 --- # Rebar Controls and Bands +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The main purpose of a rebar control is to act as a container for child windows, common dialog controls, menus, toolbars, and so on. This containment is supported by the concept of a "band." Each rebar band can contain any combination of a gripper bar, a bitmap, a text label, and a child window. Class `CReBarCtrl` has many member functions that you can use to retrieve, and manipulate, information for a specific rebar band: diff --git a/docs/mfc/receiving-notification-from-common-controls.md b/docs/mfc/receiving-notification-from-common-controls.md index 8e783462914..435756b0ced 100644 --- a/docs/mfc/receiving-notification-from-common-controls.md +++ b/docs/mfc/receiving-notification-from-common-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Receiving Notification from Common Controls" title: "Receiving Notification from Common Controls" ms.date: "11/04/2016" helpviewer_keywords: ["OnNotify method [MFC]", "common controls [MFC], notifications", "ON_NOTIFY macro [MFC]", "controls [MFC], notifications", "receiving notifications from common controls", "notifications [MFC], common controls", "Windows common controls [MFC], notifications", "WM_NOTIFY message"] -ms.assetid: 50194592-d60d-44d0-8ab3-338a2a2c63e7 ms.topic: concept-article --- # Receiving Notification from Common Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Common controls are child windows that send notification messages to the parent window when events, such as input from the user, occur in the control. The application relies on these notification messages to determine what action the user wants it to take. Most common controls send notification messages as WM_NOTIFY messages. Windows controls send most notification messages as WM_COMMAND messages. [CWnd::OnNotify](../mfc/reference/cwnd-class.md#onnotify) is the handler for the WM_NOTIFY message. As with `CWnd::OnCommand`, the implementation of `OnNotify` dispatches the notification message to `OnCmdMsg` for handling in message maps. The message-map entry for handling notifications is ON_NOTIFY. For more information, see [Technical Note 61: ON_NOTIFY and WM_NOTIFY Messages](../mfc/tn061-on-notify-and-wm-notify-messages.md). diff --git a/docs/mfc/recommendations-for-choosing-a-collection-class.md b/docs/mfc/recommendations-for-choosing-a-collection-class.md index aaf0201877d..081935d01d7 100644 --- a/docs/mfc/recommendations-for-choosing-a-collection-class.md +++ b/docs/mfc/recommendations-for-choosing-a-collection-class.md @@ -3,10 +3,12 @@ description: "Learn more about: Recommendations for Choosing a Collection Class" title: "Recommendations for Choosing a Collection Class" ms.date: "11/04/2016" helpviewer_keywords: ["type safety of collection classes [MFC]", "collection classes [MFC], serialization", "collection classes [MFC], speed", "collection classes [MFC], type safety", "collection classes [MFC], choosing", "collection classes [MFC], functionality", "shapes, collection", "collection classes [MFC], template-based", "MFC collection classes [MFC], characteristics", "collection classes [MFC], about collection classes [MFC]", "serialization [MFC], collection classes", "collection classes [MFC], duplicates allowed", "collection classes [MFC], shapes"] -ms.assetid: a82188cd-443f-40d8-a244-edf292a53db4 --- # Recommendations for Choosing a Collection Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article contains detailed information designed to help you choose a collection class for your particular application needs. Your choice of a collection class depends on a number of factors, including: diff --git a/docs/mfc/recommendations-for-handling-input-output.md b/docs/mfc/recommendations-for-handling-input-output.md index 891b0028419..151b6e1c4a6 100644 --- a/docs/mfc/recommendations-for-handling-input-output.md +++ b/docs/mfc/recommendations-for-handling-input-output.md @@ -3,10 +3,12 @@ description: "Learn more about: Recommendations for Handling Input/Output" title: "Recommendations for Handling Input-Output" ms.date: "11/04/2016" helpviewer_keywords: ["I/O [MFC], about I/O", "file-based I/O options", "I/O [MFC]", "I/O [MFC], options", "I/O [MFC], file-based options"] -ms.assetid: d664b175-3b4a-40c3-b14b-39de6b12e419 --- # Recommendations for Handling Input/Output +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Whether you use file-based I/O or not depends on how you respond to the questions in the following decision tree: **Does the primary data in your application reside in a disk file** diff --git a/docs/mfc/reference/add-class-from-typelib-wizard.md b/docs/mfc/reference/add-class-from-typelib-wizard.md index 1f45b4a023c..378a883f19a 100644 --- a/docs/mfc/reference/add-class-from-typelib-wizard.md +++ b/docs/mfc/reference/add-class-from-typelib-wizard.md @@ -3,11 +3,13 @@ description: "Learn more about: Add Class from Typelib Wizard" title: "Add Class from Typelib Wizard" ms.date: "03/10/2022" helpviewer_keywords: ["COM interfaces, adding classes"] -ms.assetid: 96152afd-9374-4649-a6ab-b0fa2a5592a3 ms.custom: devdivchpfy22 --- # Add Class from Typelib Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + ::: moniker range=">=msvc-160" The wizard creates a class for each interface you add from the selected type library. diff --git a/docs/mfc/reference/add-idl-mfc-method-wizard.md b/docs/mfc/reference/add-idl-mfc-method-wizard.md index 4a8592c7e2c..f93f1ee4b80 100644 --- a/docs/mfc/reference/add-idl-mfc-method-wizard.md +++ b/docs/mfc/reference/add-idl-mfc-method-wizard.md @@ -9,6 +9,9 @@ ms.custom: devdivchpfy22 # Add an IDL MFC method +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The **Add IDL MFC Method** wizard adds a method to an Interface Definition Library (IDL) interface defined in your Microsoft Framework Class (MFC) project. If the project contains a class associated with the interface, the wizard also adds the method to the class. To use this wizard, you must be in an MFC Project, ActiveX project, or an ATL project that supports MFC. For example, if you have a Microsoft ActiveX control project, you can use the following procedure to add a method to an IDL interface in the solution. diff --git a/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md b/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md index 91fc8ecb27e..6ecb599ae65 100644 --- a/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md +++ b/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md @@ -9,6 +9,9 @@ ms.custom: devdivchpfy22 # Add an IDL MFC property +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The **Add IDL MFC Property** wizard adds a property to an Interface Definition Library (IDL) interface defined in your Microsoft Framework Class (MFC) project. To use this wizard, you must be in an MFC Project, ActiveX project, or an ATL project that supports MFC. For example, if you have a Microsoft ActiveX control project, you can use the following procedure to add a property to an IDL interface in the solution. diff --git a/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md b/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md index db0802eea7c..533a9746542 100644 --- a/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md +++ b/docs/mfc/reference/adding-an-mfc-class-from-a-type-library.md @@ -7,6 +7,9 @@ ms.custom: devdivchpfy22 --- # Add an MFC class from a type library +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use this wizard to create an MFC class from an interface in a type library. You can add an MFC class to an [MFC application](../../mfc/reference/creating-an-mfc-application.md), an [MFC DLL](../../mfc/reference/creating-an-mfc-dll-project.md), or an [MFC ActiveX control](../../mfc/reference/creating-an-mfc-activex-control.md). > [!NOTE] diff --git a/docs/mfc/reference/adding-an-mfc-class.md b/docs/mfc/reference/adding-an-mfc-class.md index aa1ef1c78f2..45dea891a56 100644 --- a/docs/mfc/reference/adding-an-mfc-class.md +++ b/docs/mfc/reference/adding-an-mfc-class.md @@ -4,10 +4,12 @@ title: "Adding an MFC Class" ms.date: "09/06/2019" f1_keywords: ["vc.codewiz.classes.adding.mfc"] helpviewer_keywords: ["classes [MFC], adding MFC", "MFC, adding classes"] -ms.assetid: 9a96b67f-40bf-43d4-8872-2f8dfc5404f1 --- # Adding an MFC Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To add classes derived from Microsoft Foundation Class (MFC) library classes to your project, use the **Add Class** button in [Class Wizard](mfc-class-wizard.md). Specify the name of the new class, select the base class, and select the ID of the dialog box with which it is associated (if any). The wizard creates a header file and an implementation file and adds them to your project. > [!NOTE] diff --git a/docs/mfc/reference/adding-an-mfc-message-handler.md b/docs/mfc/reference/adding-an-mfc-message-handler.md index 3bfd45427da..6d413d2139e 100644 --- a/docs/mfc/reference/adding-an-mfc-message-handler.md +++ b/docs/mfc/reference/adding-an-mfc-message-handler.md @@ -4,10 +4,12 @@ title: "Adding an MFC Message Handler" ms.date: "09/06/2019" f1_keywords: ["vc.codewiz.adding.mfc.msghandler"] helpviewer_keywords: ["message handling [MFC], adding handlers"] -ms.assetid: 4251cfce-76ca-443d-bd2f-6303afa6d942 --- # Adding an MFC Message Handler +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use the [Class Wizard](mfc-class-wizard.md) or the **Properties** window in **CLass View** to add a message handler (a member function that handles Windows messages) to a class and map Windows messages to the message handler. You can also add [an event handler for any dialog box control](../../windows/adding-editing-or-deleting-controls.md). By using the **Class Wizard** or **Properties** window (in **Class View**) to define message- and event-handling functions, you can automatically update the message-dispatch table (or message map) and your class header file. diff --git a/docs/mfc/reference/adding-an-mfc-odbc-consumer.md b/docs/mfc/reference/adding-an-mfc-odbc-consumer.md index 887931326d3..44a5ce4943a 100644 --- a/docs/mfc/reference/adding-an-mfc-odbc-consumer.md +++ b/docs/mfc/reference/adding-an-mfc-odbc-consumer.md @@ -3,10 +3,12 @@ description: "Learn more about: Adding an MFC ODBC Consumer" title: "Adding an MFC ODBC Consumer" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ODBC consumers"] -ms.assetid: 2dc97909-1f7e-43ee-9d47-99e612727058 --- # Adding an MFC ODBC Consumer +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An MFC ODBC consumer consists of an ODBC recordset class and data bindings necessary to access a data source. ### To add an MFC ODBC consumer diff --git a/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md b/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md index b994dd50d59..db988111e96 100644 --- a/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md +++ b/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md @@ -4,14 +4,14 @@ title: "Adding ATL Support to Your MFC Project" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.adding.atl.mfc"] helpviewer_keywords: ["MFC, ATL support", "ATL, MFC projects"] -ms.assetid: b5fe15d6-7752-4818-b9f9-62482ad35c95 --- # Adding ATL Support to Your MFC Project -If you have already created an MFC-based application, then you can add support for the Active Template Library (ATL) easily by using the IDE. +>[!NOTE] +> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. +> Active Template Library (ATL) support applies only to simple COM objects added to an MFC executable or DLL project. You can add other COM objects (including ActiveX controls) to MFC projects, but the objects might not operate as expected. -> [!NOTE] -> This support applies only to simple COM objects added to an MFC executable or DLL project. You can add other COM objects (including ActiveX controls) to MFC projects, but the objects might not operate as expected. +If you have already created an MFC-based application, then you can add support for the Active Template Library (ATL) easily by using the IDE. ::: moniker range=">=msvc-160" diff --git a/docs/mfc/reference/advanced-features-mfc-application-wizard.md b/docs/mfc/reference/advanced-features-mfc-application-wizard.md index 7a7c5bbdfe2..aa7ae813506 100644 --- a/docs/mfc/reference/advanced-features-mfc-application-wizard.md +++ b/docs/mfc/reference/advanced-features-mfc-application-wizard.md @@ -4,10 +4,12 @@ title: "Advanced Features, MFC Application Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.exe.advanced"] helpviewer_keywords: ["MFC Application Wizard, advanced features"] -ms.assetid: 8a6681c5-6576-4b12-841a-6862beee76fa --- # Advanced Features, MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic lists options for additional features for your application, such as Help, printing support, and so on. In each section, specify additional support for these advanced features. - **Context-sensitive help (HTML)** diff --git a/docs/mfc/reference/afx-extension-module-structure.md b/docs/mfc/reference/afx-extension-module-structure.md index e64cd1da160..925e38e46c1 100644 --- a/docs/mfc/reference/afx-extension-module-structure.md +++ b/docs/mfc/reference/afx-extension-module-structure.md @@ -4,10 +4,12 @@ title: "AFX_EXTENSION_MODULE Structure" ms.date: "11/04/2016" f1_keywords: ["AFX_EXTENSION_MODULE"] helpviewer_keywords: ["AFX_EXTENSION_MODULE structure [MFC]"] -ms.assetid: b85a989c-d0c5-4b28-b53c-dad45b75704e --- # AFX_EXTENSION_MODULE Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `AFX_EXTENSION_MODULE` is used during initialization of MFC extension DLLs to hold the state of MFC extension DLL module. ## Syntax diff --git a/docs/mfc/reference/afx-global-data-structure.md b/docs/mfc/reference/afx-global-data-structure.md index 22f9fd769ea..1abc9996801 100644 --- a/docs/mfc/reference/afx-global-data-structure.md +++ b/docs/mfc/reference/afx-global-data-structure.md @@ -4,10 +4,12 @@ title: "AFX_GLOBAL_DATA Structure" ms.date: "11/04/2016" f1_keywords: ["AFX_GLOBAL_DATA", "AFXGLOBALS/AFX_GLOBAL_DATA::AFX_GLOBAL_DATA", "AFXGLOBALS/AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA", "AFXGLOBALS/AFX_GLOBAL_DATA::CleanUp", "AFXGLOBALS/AFX_GLOBAL_DATA::D2D1MakeRotateMatrix", "AFXGLOBALS/AFX_GLOBAL_DATA::DrawParentBackground", "AFXGLOBALS/AFX_GLOBAL_DATA::DrawTextOnGlass", "AFXGLOBALS/AFX_GLOBAL_DATA::ExcludeTag", "AFXGLOBALS/AFX_GLOBAL_DATA::GetColor", "AFXGLOBALS/AFX_GLOBAL_DATA::GetDirect2dFactory", "AFXGLOBALS/AFX_GLOBAL_DATA::GetHandCursor", "AFXGLOBALS/AFX_GLOBAL_DATA::GetITaskbarList", "AFXGLOBALS/AFX_GLOBAL_DATA::GetITaskbarList3", "AFXGLOBALS/AFX_GLOBAL_DATA::GetNonClientMetrics", "AFXGLOBALS/AFX_GLOBAL_DATA::GetShellAutohideBars", "AFXGLOBALS/AFX_GLOBAL_DATA::GetTextHeight", "AFXGLOBALS/AFX_GLOBAL_DATA::GetWICFactory", "AFXGLOBALS/AFX_GLOBAL_DATA::GetWriteFactory", "AFXGLOBALS/AFX_GLOBAL_DATA::InitD2D", "AFXGLOBALS/AFX_GLOBAL_DATA::Is32BitIcons", "AFXGLOBALS/AFX_GLOBAL_DATA::IsD2DInitialized", "AFXGLOBALS/AFX_GLOBAL_DATA::IsDwmCompositionEnabled", "AFXGLOBALS/AFX_GLOBAL_DATA::IsHighContrastMode", "AFXGLOBALS/AFX_GLOBAL_DATA::OnSettingChange", "AFXGLOBALS/AFX_GLOBAL_DATA::RegisterWindowClass", "AFXGLOBALS/AFX_GLOBAL_DATA::ReleaseTaskBarRefs", "AFXGLOBALS/AFX_GLOBAL_DATA::Resume", "AFXGLOBALS/AFX_GLOBAL_DATA::SetLayeredAttrib", "AFXGLOBALS/AFX_GLOBAL_DATA::SetMenuFont", "AFXGLOBALS/AFX_GLOBAL_DATA::ShellCreateItemFromParsingName", "AFXGLOBALS/AFX_GLOBAL_DATA::UpdateFonts", "AFXGLOBALS/AFX_GLOBAL_DATA::UpdateSysColors", "AFXGLOBALS/AFX_GLOBAL_DATA::EnableAccessibilitySupport", "AFXGLOBALS/AFX_GLOBAL_DATA::IsAccessibilitySupport", "AFXGLOBALS/AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable", "AFXGLOBALS/AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport", "AFXGLOBALS/AFX_GLOBAL_DATA::bIsWindows7", "AFXGLOBALS/AFX_GLOBAL_DATA::clrActiveCaptionGradient", "AFXGLOBALS/AFX_GLOBAL_DATA::clrInactiveCaptionGradient", "AFXGLOBALS/AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons", "AFXGLOBALS/AFX_GLOBAL_DATA::m_bUseSystemFont", "AFXGLOBALS/AFX_GLOBAL_DATA::m_hcurHand", "AFXGLOBALS/AFX_GLOBAL_DATA::m_hcurStretch", "AFXGLOBALS/AFX_GLOBAL_DATA::m_hcurStretchVert", "AFXGLOBALS/AFX_GLOBAL_DATA::m_hiconTool", "AFXGLOBALS/AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin", "AFXGLOBALS/AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing", "AFXGLOBALS/AFX_GLOBAL_DATA::m_nDragFrameThicknessDock", "AFXGLOBALS/AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat"] helpviewer_keywords: ["AFX_GLOBAL_DATA structure [MFC]", "AFX_GLOBAL_DATA constructor"] -ms.assetid: c7abf2fb-ad5e-4336-a01d-260c29ed53a2 --- # AFX_GLOBAL_DATA Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `AFX_GLOBAL_DATA` structure contains fields and methods that are used to manage the framework or customize the appearance and behavior of your application. ## Syntax diff --git a/docs/mfc/reference/afx-messages.md b/docs/mfc/reference/afx-messages.md index 8651a84d6d5..afb7cd8d516 100644 --- a/docs/mfc/reference/afx-messages.md +++ b/docs/mfc/reference/afx-messages.md @@ -4,10 +4,12 @@ title: "AFX Messages" ms.date: "11/04/2016" f1_keywords: ["SB_LINELEFT", "SB_THUMBTRACK", "AFX_TOOLTIP_TYPE_EDIT", "AFX_WM_ON_HSCROLL", "SB_PAGERIGHT", "AFX_WM_RESETPROMPT", "AFX_WM_CHANGE_RIBBON_CATEGORY", "AFX_TOOLTIP_TYPE_MINIFRAME", "AFX_WM_CUSTOMIZETOOLBAR", "AFX_WM_CHANGE_ACTIVE_TAB", "AFX_WM_ACCGETOBJECT", "AFX_WM_TOOLBARMENU", "AFX_TOOLTIP_TYPE_DOCKBAR", "AFX_WM_CUSTOMIZEHELP", "AFX_WM_ON_GET_TAB_TOOLTIP", "AFX_WM_ON_RIBBON_CUSTOMIZE", "AFX_WM_ON_DRAGCOMPLETE", "AFX_WM_RESETTOOLBAR", "AFX_WM_ON_MOVETOTABGROUP", "AFX_WM_CHECKEMPTYMINIFRAME", "AFX_WM_GETDOCUMENTCOLORS", "SB_RIGHT", "AFX_WM_ON_BEFORE_SHOW_RIBBON_ITEM_MENU", "AFX_WM_ACCGETSTATE", "SB_PAGELEFT", "SB_ENDSCROLL", "AFX_WM_ON_CANCELTABMOVE", "AFX_TOOLTIP_TYPE_TAB", "AFX_WM_WINDOW_HELP", "AFX_WM_HIGHLIGHT_RIBBON_LIST_ITEM", "AFX_WM_SHOWREGULARMENU", "AFX_TOOLTIP_TYPE_TOOLBAR", "AFX_WM_CHANGE_CURRENT_FOLDER", "AFX_WM_UPDATETOOLTIPS", "AFX_WM_ON_MOVE_TAB", "AFX_WM_CHANGING_ACTIVE_TAB", "AFX_WM_RESETMENU", "AFX_WM_GETDRAGBOUNDS", "AFX_WM_RESETCONTEXTMENU", "AFX_TOOLTIP_TYPE_BUTTON", "AFX_WM_ON_CLOSEPOPUPWINDOW", "AFX_TOOLTIP_TYPE_TOOLBOX", "AFX_WM_CHANGEVISUALMANAGER", "SB_LINERIGHT", "AFX_WM_ON_RENAME_TAB", "AFX_TOOLTIP_TYPE_DEFAULT", "AFX_WM_ON_TABGROUPMOUSEMOVE", "SB_LEFT", "AFX_WM_DELETETOOLBAR", "AFX_WM_PROPERTY_CHANGED", "AFX_TOOLTIP_TYPE_ALL", "AFX_WM_ACCHITTEST", "AFX_WM_ON_AFTER_SHELL_COMMAND", "AFX_WM_ON_PRESS_CLOSE_BUTTON", "AFX_WM_RESETKEYBOARD", "AFX_WM_ON_MOVETABCOMPLETE", "AFX_WM_CREATETOOLBAR", "SB_THUMBPOSITION", "AFX_WM_POSTSETPREVIEWFRAME"] helpviewer_keywords: ["AFX messages [MFC]"] -ms.assetid: 3d601f3c-af6d-47d3-8553-34f1318fa74f --- # AFX Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These messages are used in MFC. ## Messages diff --git a/docs/mfc/reference/application-control.md b/docs/mfc/reference/application-control.md index 71d0ea63f2b..94e130be1d1 100644 --- a/docs/mfc/reference/application-control.md +++ b/docs/mfc/reference/application-control.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["application control [MFC]"] --- # Application Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + OLE requires substantial control over applications and their objects. The OLE system DLLs must be able to launch and release applications automatically, coordinate their production and modification of objects, and so on. The functions in this topic meet those requirements. In addition to being called by the OLE system DLLs, these functions must sometimes be called by applications as well. ### Application Control diff --git a/docs/mfc/reference/application-information-and-management.md b/docs/mfc/reference/application-information-and-management.md index 4c97fa5d41a..1abddac4368 100644 --- a/docs/mfc/reference/application-information-and-management.md +++ b/docs/mfc/reference/application-information-and-management.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["applications [MFC], managing"] --- # Application Information and Management +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you write an application, you create a single [`CWinApp`](../../mfc/reference/cwinapp-class.md)-derived object. At times, you may want to get information about this object from outside the `CWinApp`-derived object. Or you may need access to other global "manager" objects. The Microsoft Foundation Class Library provides the following global functions to help you accomplish these tasks: diff --git a/docs/mfc/reference/application-settings-mfc-activex-control-wizard.md b/docs/mfc/reference/application-settings-mfc-activex-control-wizard.md index 47132045c6e..c4319681860 100644 --- a/docs/mfc/reference/application-settings-mfc-activex-control-wizard.md +++ b/docs/mfc/reference/application-settings-mfc-activex-control-wizard.md @@ -4,10 +4,12 @@ title: "Application Settings, MFC ActiveX Control Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.ctl.appset"] helpviewer_keywords: ["MFC ActiveX Control Wizard, application settings"] -ms.assetid: 48475194-cc63-467f-8499-f142269a4c1c --- # Application Settings, MFC ActiveX Control Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use this page of the MFC ActiveX Control Wizard to design and add basic features to a new MFC ActiveX project. These settings apply to the application itself and not to any specific feature or element of the control. - **Run-time license** diff --git a/docs/mfc/reference/application-settings-mfc-dll-wizard.md b/docs/mfc/reference/application-settings-mfc-dll-wizard.md index b954d26d00d..867e12a7058 100644 --- a/docs/mfc/reference/application-settings-mfc-dll-wizard.md +++ b/docs/mfc/reference/application-settings-mfc-dll-wizard.md @@ -4,10 +4,12 @@ title: "Application Settings, MFC DLL Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.dll.appset"] helpviewer_keywords: ["MFC DLL Wizard, application settings"] -ms.assetid: 0a96b94f-ae36-4975-951b-c9ffb3def21c --- # Application Settings, MFC DLL Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use this page of the MFC DLL wizard to design and add basic features to a new MFC DLL project. ## DLL type diff --git a/docs/mfc/reference/application-type-mfc-application-wizard.md b/docs/mfc/reference/application-type-mfc-application-wizard.md index ba1c3c9b273..4619680538f 100644 --- a/docs/mfc/reference/application-type-mfc-application-wizard.md +++ b/docs/mfc/reference/application-type-mfc-application-wizard.md @@ -4,10 +4,12 @@ title: "Application Type, MFC Application Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.exe.apptype"] helpviewer_keywords: ["static libraries, MFC"] -ms.assetid: c3f62b0e-3f13-42c5-9859-d3890d0c3e1d --- # Application Type, MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use this page of the [MFC Application Wizard](../../mfc/reference/mfc-application-wizard.md) to design and add basic features to a new MFC application. - **Application type** diff --git a/docs/mfc/reference/buffercommand-enumeration.md b/docs/mfc/reference/buffercommand-enumeration.md index 23d430be1aa..755a0916ae5 100644 --- a/docs/mfc/reference/buffercommand-enumeration.md +++ b/docs/mfc/reference/buffercommand-enumeration.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["buffercommand enumeration [MFC]"] --- # BufferCommand enumeration +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Used by [CMemFile::GetBufferPtr](cmemfile-class.md#getbufferptr) to determine what action to take on the file-backed memory buffer. ## Syntax diff --git a/docs/mfc/reference/cacceleratedeceleratetransition-class.md b/docs/mfc/reference/cacceleratedeceleratetransition-class.md index 2a1805bcab4..59271982e96 100644 --- a/docs/mfc/reference/cacceleratedeceleratetransition-class.md +++ b/docs/mfc/reference/cacceleratedeceleratetransition-class.md @@ -4,10 +4,12 @@ title: "CAccelerateDecelerateTransition Class" ms.date: "11/04/2016" f1_keywords: ["CAccelerateDecelerateTransition", "afxanimationcontroller/CAccelerateDecelerateTransition"] helpviewer_keywords: ["CAccelerateDecelerateTransition class [MFC]"] -ms.assetid: b1f31ee8-bb11-4ccc-b124-365fb02b025c --- # CAccelerateDecelerateTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements an accelerate-decelerate transition. ## Syntax diff --git a/docs/mfc/reference/callback-functions-used-by-mfc.md b/docs/mfc/reference/callback-functions-used-by-mfc.md index 48c2ebd5c79..5beda34b607 100644 --- a/docs/mfc/reference/callback-functions-used-by-mfc.md +++ b/docs/mfc/reference/callback-functions-used-by-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Callback Functions Used by MFC" title: "Callback Functions Used by MFC" ms.date: "11/04/2016" helpviewer_keywords: ["callback functions [MFC], MFC", "MFC, callback functions", "functions [MFC], callback", "callback functions [MFC]"] -ms.assetid: b2a6857c-fdd3-45ec-8fd8-2e71fac77582 --- # Callback Functions Used by MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Three callback functions appear in the Microsoft Foundation Class Library. These callback functions are passed to [CDC::EnumObjects](../../mfc/reference/cdc-class.md#enumobjects), [CDC::GrayString](../../mfc/reference/cdc-class.md#graystring), and [CDC::SetAbortProc](../../mfc/reference/cdc-class.md#setabortproc). Note that all callback functions must trap MFC exceptions before returning to Windows, since exceptions cannot be thrown across callback boundaries. For more information about exceptions, see the article [Exceptions](../../mfc/exception-handling-in-mfc.md). [Callback Function for CDC::EnumObjects](#enum_objects)\ diff --git a/docs/mfc/reference/canimatectrl-class.md b/docs/mfc/reference/canimatectrl-class.md index 15e0d9893a9..5fa507210c2 100644 --- a/docs/mfc/reference/canimatectrl-class.md +++ b/docs/mfc/reference/canimatectrl-class.md @@ -4,10 +4,12 @@ title: "CAnimateCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CAnimateCtrl", "AFXCMN/CAnimateCtrl", "AFXCMN/CAnimateCtrl::CAnimateCtrl", "AFXCMN/CAnimateCtrl::Close", "AFXCMN/CAnimateCtrl::Create", "AFXCMN/CAnimateCtrl::CreateEx", "AFXCMN/CAnimateCtrl::IsPlaying", "AFXCMN/CAnimateCtrl::Open", "AFXCMN/CAnimateCtrl::Play", "AFXCMN/CAnimateCtrl::Seek", "AFXCMN/CAnimateCtrl::Stop"] helpviewer_keywords: ["CAnimateCtrl [MFC], CAnimateCtrl", "CAnimateCtrl [MFC], Close", "CAnimateCtrl [MFC], Create", "CAnimateCtrl [MFC], CreateEx", "CAnimateCtrl [MFC], IsPlaying", "CAnimateCtrl [MFC], Open", "CAnimateCtrl [MFC], Play", "CAnimateCtrl [MFC], Seek", "CAnimateCtrl [MFC], Stop"] -ms.assetid: 5e8eb1bd-96b7-47b8-8de2-6bcbb3cc299b --- # CAnimateCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common animation control. ## Syntax diff --git a/docs/mfc/reference/canimationbaseobject-class.md b/docs/mfc/reference/canimationbaseobject-class.md index cd986f2657d..7177f63f464 100644 --- a/docs/mfc/reference/canimationbaseobject-class.md +++ b/docs/mfc/reference/canimationbaseobject-class.md @@ -4,10 +4,12 @@ title: "CAnimationBaseObject Class" ms.date: "03/27/2019" f1_keywords: ["CAnimationBaseObject", "AFXANIMATIONCONTROLLER/CAnimationBaseObject", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::CAnimationBaseObject", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::ApplyTransitions", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::ClearTransitions", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::ContainsVariable", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::CreateTransitions", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::DetachFromController", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::EnableIntegerValueChangedEvent", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::EnableValueChangedEvent", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::GetAutodestroyTransitions", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::GetGroupID", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::GetObjectID", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::GetUserData", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::SetAutodestroyTransitions", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::SetID", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::SetUserData", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::GetAnimationVariableList", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::SetParentAnimationObjects", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::m_bAutodestroyTransitions", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::m_dwUserData", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::m_nGroupID", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::m_nObjectID", "AFXANIMATIONCONTROLLER/CAnimationBaseObject::m_pParentController"] helpviewer_keywords: ["CAnimationBaseObject [MFC], CAnimationBaseObject", "CAnimationBaseObject [MFC], ApplyTransitions", "CAnimationBaseObject [MFC], ClearTransitions", "CAnimationBaseObject [MFC], ContainsVariable", "CAnimationBaseObject [MFC], CreateTransitions", "CAnimationBaseObject [MFC], DetachFromController", "CAnimationBaseObject [MFC], EnableIntegerValueChangedEvent", "CAnimationBaseObject [MFC], EnableValueChangedEvent", "CAnimationBaseObject [MFC], GetAutodestroyTransitions", "CAnimationBaseObject [MFC], GetGroupID", "CAnimationBaseObject [MFC], GetObjectID", "CAnimationBaseObject [MFC], GetUserData", "CAnimationBaseObject [MFC], SetAutodestroyTransitions", "CAnimationBaseObject [MFC], SetID", "CAnimationBaseObject [MFC], SetUserData", "CAnimationBaseObject [MFC], GetAnimationVariableList", "CAnimationBaseObject [MFC], SetParentAnimationObjects", "CAnimationBaseObject [MFC], m_bAutodestroyTransitions", "CAnimationBaseObject [MFC], m_dwUserData", "CAnimationBaseObject [MFC], m_nGroupID", "CAnimationBaseObject [MFC], m_nObjectID", "CAnimationBaseObject [MFC], m_pParentController"] -ms.assetid: 76b25917-940e-4eba-940f-31d270702603 --- # CAnimationBaseObject Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for all animation objects. ## Syntax diff --git a/docs/mfc/reference/canimationcolor-class.md b/docs/mfc/reference/canimationcolor-class.md index 776a4f94c5a..95cd12e9f5c 100644 --- a/docs/mfc/reference/canimationcolor-class.md +++ b/docs/mfc/reference/canimationcolor-class.md @@ -4,10 +4,12 @@ title: "CAnimationColor Class" ms.date: "11/04/2016" f1_keywords: ["CAnimationColor", "AFXANIMATIONCONTROLLER/CAnimationColor", "AFXANIMATIONCONTROLLER/CAnimationColor::CAnimationColor", "AFXANIMATIONCONTROLLER/CAnimationColor::AddTransition", "AFXANIMATIONCONTROLLER/CAnimationColor::GetB", "AFXANIMATIONCONTROLLER/CAnimationColor::GetDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationColor::GetG", "AFXANIMATIONCONTROLLER/CAnimationColor::GetR", "AFXANIMATIONCONTROLLER/CAnimationColor::GetValue", "AFXANIMATIONCONTROLLER/CAnimationColor::SetDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationColor::GetAnimationVariableList", "AFXANIMATIONCONTROLLER/CAnimationColor::m_bValue", "AFXANIMATIONCONTROLLER/CAnimationColor::m_gValue", "AFXANIMATIONCONTROLLER/CAnimationColor::m_rValue"] helpviewer_keywords: ["CAnimationColor [MFC], CAnimationColor", "CAnimationColor [MFC], AddTransition", "CAnimationColor [MFC], GetB", "CAnimationColor [MFC], GetDefaultValue", "CAnimationColor [MFC], GetG", "CAnimationColor [MFC], GetR", "CAnimationColor [MFC], GetValue", "CAnimationColor [MFC], SetDefaultValue", "CAnimationColor [MFC], GetAnimationVariableList", "CAnimationColor [MFC], m_bValue", "CAnimationColor [MFC], m_gValue", "CAnimationColor [MFC], m_rValue"] -ms.assetid: 88bfabd4-efeb-4652-87e8-304253d8e48c --- # CAnimationColor Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the functionality of a color whose red, green, and blue components can be animated. ## Syntax diff --git a/docs/mfc/reference/canimationcontroller-class.md b/docs/mfc/reference/canimationcontroller-class.md index efbcb21ccb4..e2fb90bb856 100644 --- a/docs/mfc/reference/canimationcontroller-class.md +++ b/docs/mfc/reference/canimationcontroller-class.md @@ -4,10 +4,12 @@ title: "CAnimationController Class" ms.date: "03/27/2019" f1_keywords: ["CAnimationController", "AFXANIMATIONCONTROLLER/CAnimationController", "AFXANIMATIONCONTROLLER/CAnimationController::CAnimationController", "AFXANIMATIONCONTROLLER/CAnimationController::AddAnimationObject", "AFXANIMATIONCONTROLLER/CAnimationController::AddKeyframeToGroup", "AFXANIMATIONCONTROLLER/CAnimationController::AnimateGroup", "AFXANIMATIONCONTROLLER/CAnimationController::CleanUpGroup", "AFXANIMATIONCONTROLLER/CAnimationController::CreateKeyframe", "AFXANIMATIONCONTROLLER/CAnimationController::EnableAnimationManagerEvent", "AFXANIMATIONCONTROLLER/CAnimationController::EnableAnimationTimerEventHandler", "AFXANIMATIONCONTROLLER/CAnimationController::EnablePriorityComparisonHandler", "AFXANIMATIONCONTROLLER/CAnimationController::EnableStoryboardEventHandler", "AFXANIMATIONCONTROLLER/CAnimationController::FindAnimationGroup", "AFXANIMATIONCONTROLLER/CAnimationController::FindAnimationObject", "AFXANIMATIONCONTROLLER/CAnimationController::GetKeyframeStoryboardStart", "AFXANIMATIONCONTROLLER/CAnimationController::GetUIAnimationManager", "AFXANIMATIONCONTROLLER/CAnimationController::GetUIAnimationTimer", "AFXANIMATIONCONTROLLER/CAnimationController::GetUITransitionFactory", "AFXANIMATIONCONTROLLER/CAnimationController::GetUITransitionLibrary", "AFXANIMATIONCONTROLLER/CAnimationController::IsAnimationInProgress", "AFXANIMATIONCONTROLLER/CAnimationController::IsValid", "AFXANIMATIONCONTROLLER/CAnimationController::OnAnimationIntegerValueChanged", "AFXANIMATIONCONTROLLER/CAnimationController::OnAnimationManagerStatusChanged", "AFXANIMATIONCONTROLLER/CAnimationController::OnAnimationTimerPostUpdate", "AFXANIMATIONCONTROLLER/CAnimationController::OnAnimationTimerPreUpdate", "AFXANIMATIONCONTROLLER/CAnimationController::OnAnimationTimerRenderingTooSlow", "AFXANIMATIONCONTROLLER/CAnimationController::OnAnimationValueChanged", "AFXANIMATIONCONTROLLER/CAnimationController::OnBeforeAnimationStart", "AFXANIMATIONCONTROLLER/CAnimationController::OnHasPriorityCancel", "AFXANIMATIONCONTROLLER/CAnimationController::OnHasPriorityCompress", "AFXANIMATIONCONTROLLER/CAnimationController::OnHasPriorityConclude", "AFXANIMATIONCONTROLLER/CAnimationController::OnHasPriorityTrim", "AFXANIMATIONCONTROLLER/CAnimationController::OnStoryboardStatusChanged", "AFXANIMATIONCONTROLLER/CAnimationController::OnStoryboardUpdated", "AFXANIMATIONCONTROLLER/CAnimationController::RemoveAllAnimationGroups", "AFXANIMATIONCONTROLLER/CAnimationController::RemoveAnimationGroup", "AFXANIMATIONCONTROLLER/CAnimationController::RemoveAnimationObject", "AFXANIMATIONCONTROLLER/CAnimationController::RemoveTransitions", "AFXANIMATIONCONTROLLER/CAnimationController::ScheduleGroup", "AFXANIMATIONCONTROLLER/CAnimationController::SetRelatedWnd", "AFXANIMATIONCONTROLLER/CAnimationController::UpdateAnimationManager", "AFXANIMATIONCONTROLLER/CAnimationController::OnAfterSchedule", "AFXANIMATIONCONTROLLER/CAnimationController::gkeyframeStoryboardStart", "AFXANIMATIONCONTROLLER/CAnimationController::m_bIsValid", "AFXANIMATIONCONTROLLER/CAnimationController::m_lstAnimationGroups", "AFXANIMATIONCONTROLLER/CAnimationController::m_pAnimationManager", "AFXANIMATIONCONTROLLER/CAnimationController::m_pAnimationTimer", "AFXANIMATIONCONTROLLER/CAnimationController::m_pRelatedWnd", "AFXANIMATIONCONTROLLER/CAnimationController::m_pTransitionFactory", "AFXANIMATIONCONTROLLER/CAnimationController::m_pTransitionLibrary"] helpviewer_keywords: ["CAnimationController [MFC], CAnimationController", "CAnimationController [MFC], AddAnimationObject", "CAnimationController [MFC], AddKeyframeToGroup", "CAnimationController [MFC], AnimateGroup", "CAnimationController [MFC], CleanUpGroup", "CAnimationController [MFC], CreateKeyframe", "CAnimationController [MFC], EnableAnimationManagerEvent", "CAnimationController [MFC], EnableAnimationTimerEventHandler", "CAnimationController [MFC], EnablePriorityComparisonHandler", "CAnimationController [MFC], EnableStoryboardEventHandler", "CAnimationController [MFC], FindAnimationGroup", "CAnimationController [MFC], FindAnimationObject", "CAnimationController [MFC], GetKeyframeStoryboardStart", "CAnimationController [MFC], GetUIAnimationManager", "CAnimationController [MFC], GetUIAnimationTimer", "CAnimationController [MFC], GetUITransitionFactory", "CAnimationController [MFC], GetUITransitionLibrary", "CAnimationController [MFC], IsAnimationInProgress", "CAnimationController [MFC], IsValid", "CAnimationController [MFC], OnAnimationIntegerValueChanged", "CAnimationController [MFC], OnAnimationManagerStatusChanged", "CAnimationController [MFC], OnAnimationTimerPostUpdate", "CAnimationController [MFC], OnAnimationTimerPreUpdate", "CAnimationController [MFC], OnAnimationTimerRenderingTooSlow", "CAnimationController [MFC], OnAnimationValueChanged", "CAnimationController [MFC], OnBeforeAnimationStart", "CAnimationController [MFC], OnHasPriorityCancel", "CAnimationController [MFC], OnHasPriorityCompress", "CAnimationController [MFC], OnHasPriorityConclude", "CAnimationController [MFC], OnHasPriorityTrim", "CAnimationController [MFC], OnStoryboardStatusChanged", "CAnimationController [MFC], OnStoryboardUpdated", "CAnimationController [MFC], RemoveAllAnimationGroups", "CAnimationController [MFC], RemoveAnimationGroup", "CAnimationController [MFC], RemoveAnimationObject", "CAnimationController [MFC], RemoveTransitions", "CAnimationController [MFC], ScheduleGroup", "CAnimationController [MFC], SetRelatedWnd", "CAnimationController [MFC], UpdateAnimationManager", "CAnimationController [MFC], CleanUpGroup", "CAnimationController [MFC], OnAfterSchedule", "CAnimationController [MFC], gkeyframeStoryboardStart", "CAnimationController [MFC], m_bIsValid", "CAnimationController [MFC], m_lstAnimationGroups", "CAnimationController [MFC], m_pAnimationManager", "CAnimationController [MFC], m_pAnimationTimer", "CAnimationController [MFC], m_pRelatedWnd", "CAnimationController [MFC], m_pTransitionFactory", "CAnimationController [MFC], m_pTransitionLibrary"] -ms.assetid: ed294c98-695e-40a6-b940-33ef1d40aa6b --- # CAnimationController Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the animation controller, which provides a central interface for creating and managing animations. ## Syntax diff --git a/docs/mfc/reference/canimationgroup-class.md b/docs/mfc/reference/canimationgroup-class.md index ec55261113d..e0465936f07 100644 --- a/docs/mfc/reference/canimationgroup-class.md +++ b/docs/mfc/reference/canimationgroup-class.md @@ -4,10 +4,12 @@ title: "CAnimationGroup Class" ms.date: "03/27/2019" f1_keywords: ["CAnimationGroup", "AFXANIMATIONCONTROLLER/CAnimationGroup", "AFXANIMATIONCONTROLLER/CAnimationGroup::CAnimationGroup", "AFXANIMATIONCONTROLLER/CAnimationGroup::Animate", "AFXANIMATIONCONTROLLER/CAnimationGroup::ApplyTransitions", "AFXANIMATIONCONTROLLER/CAnimationGroup::FindAnimationObject", "AFXANIMATIONCONTROLLER/CAnimationGroup::GetGroupID", "AFXANIMATIONCONTROLLER/CAnimationGroup::RemoveKeyframes", "AFXANIMATIONCONTROLLER/CAnimationGroup::RemoveTransitions", "AFXANIMATIONCONTROLLER/CAnimationGroup::Schedule", "AFXANIMATIONCONTROLLER/CAnimationGroup::SetAutodestroyTransitions", "AFXANIMATIONCONTROLLER/CAnimationGroup::AddKeyframes", "AFXANIMATIONCONTROLLER/CAnimationGroup::AddTransitions", "AFXANIMATIONCONTROLLER/CAnimationGroup::CreateTransitions", "AFXANIMATIONCONTROLLER/CAnimationGroup::m_bAutoclearTransitions", "AFXANIMATIONCONTROLLER/CAnimationGroup::m_bAutodestroyAnimationObjects", "AFXANIMATIONCONTROLLER/CAnimationGroup::m_bAutodestroyKeyframes", "AFXANIMATIONCONTROLLER/CAnimationGroup::m_lstAnimationObjects", "AFXANIMATIONCONTROLLER/CAnimationGroup::m_lstKeyFrames", "AFXANIMATIONCONTROLLER/CAnimationGroup::m_pStoryboard", "AFXANIMATIONCONTROLLER/CAnimationGroup::m_nGroupID", "AFXANIMATIONCONTROLLER/CAnimationGroup::m_pParentController"] helpviewer_keywords: ["CAnimationGroup [MFC], CAnimationGroup", "CAnimationGroup [MFC], Animate", "CAnimationGroup [MFC], ApplyTransitions", "CAnimationGroup [MFC], FindAnimationObject", "CAnimationGroup [MFC], GetGroupID", "CAnimationGroup [MFC], RemoveKeyframes", "CAnimationGroup [MFC], RemoveTransitions", "CAnimationGroup [MFC], Schedule", "CAnimationGroup [MFC], SetAutodestroyTransitions", "CAnimationGroup [MFC], AddKeyframes", "CAnimationGroup [MFC], AddTransitions", "CAnimationGroup [MFC], CreateTransitions", "CAnimationGroup [MFC], m_bAutoclearTransitions", "CAnimationGroup [MFC], m_bAutodestroyAnimationObjects", "CAnimationGroup [MFC], m_bAutodestroyKeyframes", "CAnimationGroup [MFC], m_lstAnimationObjects", "CAnimationGroup [MFC], m_lstKeyFrames", "CAnimationGroup [MFC], m_pStoryboard", "CAnimationGroup [MFC], m_nGroupID", "CAnimationGroup [MFC], m_pParentController"] -ms.assetid: 8bc18ceb-33a2-41d0-9731-71811adacab7 --- # CAnimationGroup Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements an animation group, which combines an animation storyboard, animation objects, and transitions to define an animation. ## Syntax diff --git a/docs/mfc/reference/canimationmanagereventhandler-class.md b/docs/mfc/reference/canimationmanagereventhandler-class.md index 098d5153445..0f734d57cb7 100644 --- a/docs/mfc/reference/canimationmanagereventhandler-class.md +++ b/docs/mfc/reference/canimationmanagereventhandler-class.md @@ -4,10 +4,12 @@ title: "CAnimationManagerEventHandler Class" ms.date: "11/04/2016" f1_keywords: ["CAnimationManagerEventHandler", "AFXANIMATIONCONTROLLER/CAnimationManagerEventHandler", "AFXANIMATIONCONTROLLER/CAnimationManagerEventHandler::CAnimationManagerEventHandler", "AFXANIMATIONCONTROLLER/CAnimationManagerEventHandler::CreateInstance", "AFXANIMATIONCONTROLLER/CAnimationManagerEventHandler::OnManagerStatusChanged", "AFXANIMATIONCONTROLLER/CAnimationManagerEventHandler::SetAnimationController"] helpviewer_keywords: ["CAnimationManagerEventHandler [MFC], CAnimationManagerEventHandler", "CAnimationManagerEventHandler [MFC], CreateInstance", "CAnimationManagerEventHandler [MFC], OnManagerStatusChanged", "CAnimationManagerEventHandler [MFC], SetAnimationController"] -ms.assetid: 6089ec07-e661-4805-b227-823b4652aade --- # CAnimationManagerEventHandler Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a callback, which is called by the Animation API when a status of an animation manager is changed. ## Syntax diff --git a/docs/mfc/reference/canimationpoint-class.md b/docs/mfc/reference/canimationpoint-class.md index 164e739941d..cf1d3ae8466 100644 --- a/docs/mfc/reference/canimationpoint-class.md +++ b/docs/mfc/reference/canimationpoint-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CAnimationPoint [MFC], CAnimationPoint", "CAnimationPoint --- # `CAnimationPoint` class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the functionality of a point whose coordinates can be animated. ## Syntax diff --git a/docs/mfc/reference/canimationrect-class.md b/docs/mfc/reference/canimationrect-class.md index 6d9e450cc35..b2a605299d6 100644 --- a/docs/mfc/reference/canimationrect-class.md +++ b/docs/mfc/reference/canimationrect-class.md @@ -4,10 +4,12 @@ title: "CAnimationRect Class" ms.date: "11/04/2016" f1_keywords: ["CAnimationRect", "AFXANIMATIONCONTROLLER/CAnimationRect", "AFXANIMATIONCONTROLLER/CAnimationRect::CAnimationRect", "AFXANIMATIONCONTROLLER/CAnimationRect::AddTransition", "AFXANIMATIONCONTROLLER/CAnimationRect::GetBottom", "AFXANIMATIONCONTROLLER/CAnimationRect::GetDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationRect::GetLeft", "AFXANIMATIONCONTROLLER/CAnimationRect::GetRight", "AFXANIMATIONCONTROLLER/CAnimationRect::GetTop", "AFXANIMATIONCONTROLLER/CAnimationRect::GetValue", "AFXANIMATIONCONTROLLER/CAnimationRect::SetDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationRect::GetAnimationVariableList", "AFXANIMATIONCONTROLLER/CAnimationRect::m_bFixedSize", "AFXANIMATIONCONTROLLER/CAnimationRect::m_bottomValue", "AFXANIMATIONCONTROLLER/CAnimationRect::m_leftValue", "AFXANIMATIONCONTROLLER/CAnimationRect::m_rightValue", "AFXANIMATIONCONTROLLER/CAnimationRect::m_szInitial", "AFXANIMATIONCONTROLLER/CAnimationRect::m_topValue"] helpviewer_keywords: ["CAnimationRect [MFC], CAnimationRect", "CAnimationRect [MFC], AddTransition", "CAnimationRect [MFC], GetBottom", "CAnimationRect [MFC], GetDefaultValue", "CAnimationRect [MFC], GetLeft", "CAnimationRect [MFC], GetRight", "CAnimationRect [MFC], GetTop", "CAnimationRect [MFC], GetValue", "CAnimationRect [MFC], SetDefaultValue", "CAnimationRect [MFC], GetAnimationVariableList", "CAnimationRect [MFC], m_bFixedSize", "CAnimationRect [MFC], m_bottomValue", "CAnimationRect [MFC], m_leftValue", "CAnimationRect [MFC], m_rightValue", "CAnimationRect [MFC], m_szInitial", "CAnimationRect [MFC], m_topValue"] -ms.assetid: 0294156d-241e-4a57-92b2-31234fe557d6 --- # CAnimationRect Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the functionality of a rectangle whose sides can be animated. ## Syntax diff --git a/docs/mfc/reference/canimationsize-class.md b/docs/mfc/reference/canimationsize-class.md index e918efbaef0..898c45342db 100644 --- a/docs/mfc/reference/canimationsize-class.md +++ b/docs/mfc/reference/canimationsize-class.md @@ -4,10 +4,12 @@ title: "CAnimationSize Class" ms.date: "11/04/2016" f1_keywords: ["CAnimationSize", "AFXANIMATIONCONTROLLER/CAnimationSize", "AFXANIMATIONCONTROLLER/CAnimationSize::CAnimationSize", "AFXANIMATIONCONTROLLER/CAnimationSize::AddTransition", "AFXANIMATIONCONTROLLER/CAnimationSize::GetCX", "AFXANIMATIONCONTROLLER/CAnimationSize::GetCY", "AFXANIMATIONCONTROLLER/CAnimationSize::GetDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationSize::GetValue", "AFXANIMATIONCONTROLLER/CAnimationSize::SetDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationSize::GetAnimationVariableList", "AFXANIMATIONCONTROLLER/CAnimationSize::m_cxValue", "AFXANIMATIONCONTROLLER/CAnimationSize::m_cyValue"] helpviewer_keywords: ["CAnimationSize [MFC], CAnimationSize", "CAnimationSize [MFC], AddTransition", "CAnimationSize [MFC], GetCX", "CAnimationSize [MFC], GetCY", "CAnimationSize [MFC], GetDefaultValue", "CAnimationSize [MFC], GetValue", "CAnimationSize [MFC], SetDefaultValue", "CAnimationSize [MFC], GetAnimationVariableList", "CAnimationSize [MFC], m_cxValue", "CAnimationSize [MFC], m_cyValue"] -ms.assetid: ea06d1b5-502c-44a3-82ca-8bd6ba6a9364 --- # CAnimationSize Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the functionality of a size object whose dimensions can be animated. ## Syntax diff --git a/docs/mfc/reference/canimationstoryboardeventhandler-class.md b/docs/mfc/reference/canimationstoryboardeventhandler-class.md index 24d9635f462..e7d70c17056 100644 --- a/docs/mfc/reference/canimationstoryboardeventhandler-class.md +++ b/docs/mfc/reference/canimationstoryboardeventhandler-class.md @@ -4,10 +4,12 @@ title: "CAnimationStoryboardEventHandler Class" ms.date: "11/04/2016" f1_keywords: ["CAnimationStoryboardEventHandler", "AFXANIMATIONCONTROLLER/CAnimationStoryboardEventHandler", "AFXANIMATIONCONTROLLER/CAnimationStoryboardEventHandler::CAnimationStoryboardEventHandler", "AFXANIMATIONCONTROLLER/CAnimationStoryboardEventHandler::CreateInstance", "AFXANIMATIONCONTROLLER/CAnimationStoryboardEventHandler::OnStoryboardStatusChanged", "AFXANIMATIONCONTROLLER/CAnimationStoryboardEventHandler::OnStoryboardUpdated", "AFXANIMATIONCONTROLLER/CAnimationStoryboardEventHandler::SetAnimationController"] helpviewer_keywords: ["CAnimationStoryboardEventHandler [MFC], CAnimationStoryboardEventHandler", "CAnimationStoryboardEventHandler [MFC], CreateInstance", "CAnimationStoryboardEventHandler [MFC], OnStoryboardStatusChanged", "CAnimationStoryboardEventHandler [MFC], OnStoryboardUpdated", "CAnimationStoryboardEventHandler [MFC], SetAnimationController"] -ms.assetid: 10a7e86b-c02d-4124-9a2e-61ecf8ac62fc --- # CAnimationStoryboardEventHandler Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a callback, which is called by the Animation API when the status of a storyboard is changed or a storyboard is updated. ## Syntax diff --git a/docs/mfc/reference/canimationtimereventhandler-class.md b/docs/mfc/reference/canimationtimereventhandler-class.md index ba43bc2b92c..c81fac2c402 100644 --- a/docs/mfc/reference/canimationtimereventhandler-class.md +++ b/docs/mfc/reference/canimationtimereventhandler-class.md @@ -4,10 +4,12 @@ title: "CAnimationTimerEventHandler Class" ms.date: "11/04/2016" f1_keywords: ["CAnimationTimerEventHandler", "AFXANIMATIONCONTROLLER/CAnimationTimerEventHandler", "AFXANIMATIONCONTROLLER/CAnimationTimerEventHandler::CreateInstance", "AFXANIMATIONCONTROLLER/CAnimationTimerEventHandler::OnPostUpdate", "AFXANIMATIONCONTROLLER/CAnimationTimerEventHandler::OnPreUpdate", "AFXANIMATIONCONTROLLER/CAnimationTimerEventHandler::OnRenderingTooSlow", "AFXANIMATIONCONTROLLER/CAnimationTimerEventHandler::SetAnimationController"] helpviewer_keywords: ["CAnimationTimerEventHandler [MFC], CreateInstance", "CAnimationTimerEventHandler [MFC], OnPostUpdate", "CAnimationTimerEventHandler [MFC], OnPreUpdate", "CAnimationTimerEventHandler [MFC], OnRenderingTooSlow", "CAnimationTimerEventHandler [MFC], SetAnimationController"] -ms.assetid: 188dea3b-4b5e-4f6b-8df9-09d993a21619 --- # CAnimationTimerEventHandler Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a callback, which is called by the Animation API when timing events occur. ## Syntax diff --git a/docs/mfc/reference/canimationvalue-class.md b/docs/mfc/reference/canimationvalue-class.md index 30fc884931c..e18d055b2e6 100644 --- a/docs/mfc/reference/canimationvalue-class.md +++ b/docs/mfc/reference/canimationvalue-class.md @@ -4,10 +4,12 @@ title: "CAnimationValue Class" ms.date: "11/04/2016" f1_keywords: ["CAnimationValue", "AFXANIMATIONCONTROLLER/CAnimationValue", "AFXANIMATIONCONTROLLER/CAnimationValue::CAnimationValue", "AFXANIMATIONCONTROLLER/CAnimationValue::AddTransition", "AFXANIMATIONCONTROLLER/CAnimationValue::GetValue", "AFXANIMATIONCONTROLLER/CAnimationValue::GetVariable", "AFXANIMATIONCONTROLLER/CAnimationValue::SetDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationValue::GetAnimationVariableList", "AFXANIMATIONCONTROLLER/CAnimationValue::m_value"] helpviewer_keywords: ["CAnimationValue [MFC], CAnimationValue", "CAnimationValue [MFC], AddTransition", "CAnimationValue [MFC], GetValue", "CAnimationValue [MFC], GetVariable", "CAnimationValue [MFC], SetDefaultValue", "CAnimationValue [MFC], GetAnimationVariableList", "CAnimationValue [MFC], m_value"] -ms.assetid: 78c5ae19-ede5-4f20-bfbe-68b467b603c2 --- # CAnimationValue Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the functionality of animation object that has one value. ## Syntax diff --git a/docs/mfc/reference/canimationvariable-class.md b/docs/mfc/reference/canimationvariable-class.md index 2e6c644481f..cc9ff75a44b 100644 --- a/docs/mfc/reference/canimationvariable-class.md +++ b/docs/mfc/reference/canimationvariable-class.md @@ -4,10 +4,12 @@ title: "CAnimationVariable Class" ms.date: "03/27/2019" f1_keywords: ["CAnimationVariable", "AFXANIMATIONCONTROLLER/CAnimationVariable", "AFXANIMATIONCONTROLLER/CAnimationVariable::CAnimationVariable", "AFXANIMATIONCONTROLLER/CAnimationVariable::AddTransition", "AFXANIMATIONCONTROLLER/CAnimationVariable::ApplyTransitions", "AFXANIMATIONCONTROLLER/CAnimationVariable::ClearTransitions", "AFXANIMATIONCONTROLLER/CAnimationVariable::Create", "AFXANIMATIONCONTROLLER/CAnimationVariable::CreateTransitions", "AFXANIMATIONCONTROLLER/CAnimationVariable::EnableIntegerValueChangedEvent", "AFXANIMATIONCONTROLLER/CAnimationVariable::EnableValueChangedEvent", "AFXANIMATIONCONTROLLER/CAnimationVariable::GetDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationVariable::GetParentAnimationObject", "AFXANIMATIONCONTROLLER/CAnimationVariable::GetValue", "AFXANIMATIONCONTROLLER/CAnimationVariable::GetVariable", "AFXANIMATIONCONTROLLER/CAnimationVariable::SetDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationVariable::SetParentAnimationObject", "AFXANIMATIONCONTROLLER/CAnimationVariable::m_bAutodestroyTransitions", "AFXANIMATIONCONTROLLER/CAnimationVariable::m_dblDefaultValue", "AFXANIMATIONCONTROLLER/CAnimationVariable::m_lstTransitions", "AFXANIMATIONCONTROLLER/CAnimationVariable::m_pParentObject", "AFXANIMATIONCONTROLLER/CAnimationVariable::m_variable"] helpviewer_keywords: ["CAnimationVariable [MFC], CAnimationVariable", "CAnimationVariable [MFC], AddTransition", "CAnimationVariable [MFC], ApplyTransitions", "CAnimationVariable [MFC], ClearTransitions", "CAnimationVariable [MFC], Create", "CAnimationVariable [MFC], CreateTransitions", "CAnimationVariable [MFC], EnableIntegerValueChangedEvent", "CAnimationVariable [MFC], EnableValueChangedEvent", "CAnimationVariable [MFC], GetDefaultValue", "CAnimationVariable [MFC], GetParentAnimationObject", "CAnimationVariable [MFC], GetValue", "CAnimationVariable [MFC], GetVariable", "CAnimationVariable [MFC], SetDefaultValue", "CAnimationVariable [MFC], SetParentAnimationObject", "CAnimationVariable [MFC], m_bAutodestroyTransitions", "CAnimationVariable [MFC], m_dblDefaultValue", "CAnimationVariable [MFC], m_lstTransitions", "CAnimationVariable [MFC], m_pParentObject", "CAnimationVariable [MFC], m_variable"] -ms.assetid: 506e697e-31a8-4033-a27e-292f4d7b42d9 --- # CAnimationVariable Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an animation variable. ## Syntax diff --git a/docs/mfc/reference/canimationvariablechangehandler-class.md b/docs/mfc/reference/canimationvariablechangehandler-class.md index 1ddcd351281..8b5b4aca7d5 100644 --- a/docs/mfc/reference/canimationvariablechangehandler-class.md +++ b/docs/mfc/reference/canimationvariablechangehandler-class.md @@ -4,10 +4,12 @@ title: "CAnimationVariableChangeHandler Class" ms.date: "11/04/2016" f1_keywords: ["CAnimationVariableChangeHandler", "AFXANIMATIONCONTROLLER/CAnimationVariableChangeHandler", "AFXANIMATIONCONTROLLER/CAnimationVariableChangeHandler::OnValueChanged", "AFXANIMATIONCONTROLLER/CAnimationVariableChangeHandler::SetAnimationController"] helpviewer_keywords: ["CAnimationVariableChangeHandler [MFC], OnValueChanged", "CAnimationVariableChangeHandler [MFC], SetAnimationController"] -ms.assetid: 2ea4996d-5c04-4dfc-be79-d42d55050795 --- # CAnimationVariableChangeHandler Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a callback, which is called by the Animation API when the value of an animation variable changes. ## Syntax diff --git a/docs/mfc/reference/canimationvariableintegerchangehandler-class.md b/docs/mfc/reference/canimationvariableintegerchangehandler-class.md index 4dfd846fcaa..bfda12cf2d4 100644 --- a/docs/mfc/reference/canimationvariableintegerchangehandler-class.md +++ b/docs/mfc/reference/canimationvariableintegerchangehandler-class.md @@ -4,10 +4,12 @@ title: "CAnimationVariableIntegerChangeHandler Class" ms.date: "11/04/2016" f1_keywords: ["CAnimationVariableIntegerChangeHandler", "AFXANIMATIONCONTROLLER/CAnimationVariableIntegerChangeHandler", "AFXANIMATIONCONTROLLER/CAnimationVariableIntegerChangeHandler::CAnimationVariableIntegerChangeHandler", "AFXANIMATIONCONTROLLER/CAnimationVariableIntegerChangeHandler::CreateInstance", "AFXANIMATIONCONTROLLER/CAnimationVariableIntegerChangeHandler::OnIntegerValueChanged", "AFXANIMATIONCONTROLLER/CAnimationVariableIntegerChangeHandler::SetAnimationController"] helpviewer_keywords: ["CAnimationVariableIntegerChangeHandler [MFC], CAnimationVariableIntegerChangeHandler", "CAnimationVariableIntegerChangeHandler [MFC], CreateInstance", "CAnimationVariableIntegerChangeHandler [MFC], OnIntegerValueChanged", "CAnimationVariableIntegerChangeHandler [MFC], SetAnimationController"] -ms.assetid: 6ac8e91b-e514-4ff6-babd-33f77c4b2b61 --- # CAnimationVariableIntegerChangeHandler Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a callback, which is called by the Animation API when the value of an animation variable changes. ## Syntax diff --git a/docs/mfc/reference/carchive-class.md b/docs/mfc/reference/carchive-class.md index 8d8f606693b..26b7fbc409d 100644 --- a/docs/mfc/reference/carchive-class.md +++ b/docs/mfc/reference/carchive-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CArchive [MFC], CArchive", "CArchive [MFC], Abort", "CArc --- # `CArchive` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allows you to save a complex network of objects in a permanent binary form (usually disk storage) that persists after those objects are deleted. ## Syntax diff --git a/docs/mfc/reference/carchiveexception-class.md b/docs/mfc/reference/carchiveexception-class.md index dca7aacee89..f16ea647f26 100644 --- a/docs/mfc/reference/carchiveexception-class.md +++ b/docs/mfc/reference/carchiveexception-class.md @@ -4,10 +4,12 @@ title: "CArchiveException Class" ms.date: "11/04/2016" f1_keywords: ["CArchiveException", "AFX/CArchiveException", "AFX/CArchiveException::CArchiveException", "AFX/CArchiveException::m_cause", "AFX/CArchiveException::m_strFileName"] helpviewer_keywords: ["CArchiveException [MFC], CArchiveException", "CArchiveException [MFC], m_cause", "CArchiveException [MFC], m_strFileName"] -ms.assetid: da31a127-e86c-41d1-b0b6-bed0865b1b49 --- # CArchiveException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a serialization exception condition ## Syntax diff --git a/docs/mfc/reference/carray-class.md b/docs/mfc/reference/carray-class.md index 20596963732..0ebc44e38fc 100644 --- a/docs/mfc/reference/carray-class.md +++ b/docs/mfc/reference/carray-class.md @@ -4,10 +4,12 @@ title: "CArray Class" ms.date: "11/04/2016" f1_keywords: ["CArray", "AFXTEMPL/CArray", "AFXTEMPL/CArray::CArray", "AFXTEMPL/CArray::Add", "AFXTEMPL/CArray::Append", "AFXTEMPL/CArray::Copy", "AFXTEMPL/CArray::ElementAt", "AFXTEMPL/CArray::FreeExtra", "AFXTEMPL/CArray::GetAt", "AFXTEMPL/CArray::GetCount", "AFXTEMPL/CArray::GetData", "AFXTEMPL/CArray::GetSize", "AFXTEMPL/CArray::GetUpperBound", "AFXTEMPL/CArray::InsertAt", "AFXTEMPL/CArray::IsEmpty", "AFXTEMPL/CArray::RemoveAll", "AFXTEMPL/CArray::RemoveAt", "AFXTEMPL/CArray::SetAt", "AFXTEMPL/CArray::SetAtGrow", "AFXTEMPL/CArray::SetSize"] helpviewer_keywords: ["CArray [MFC], CArray", "CArray [MFC], Add", "CArray [MFC], Append", "CArray [MFC], Copy", "CArray [MFC], ElementAt", "CArray [MFC], FreeExtra", "CArray [MFC], GetAt", "CArray [MFC], GetCount", "CArray [MFC], GetData", "CArray [MFC], GetSize", "CArray [MFC], GetUpperBound", "CArray [MFC], InsertAt", "CArray [MFC], IsEmpty", "CArray [MFC], RemoveAll", "CArray [MFC], RemoveAt", "CArray [MFC], SetAt", "CArray [MFC], SetAtGrow", "CArray [MFC], SetSize"] -ms.assetid: fead8b00-4cfd-4625-ad0e-251df62ba92f --- # `CArray` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports arrays that are like C arrays, but can dynamically reduce and grow as necessary. ## Syntax diff --git a/docs/mfc/reference/casyncmonikerfile-class.md b/docs/mfc/reference/casyncmonikerfile-class.md index 609962a7759..e5ea9ddca36 100644 --- a/docs/mfc/reference/casyncmonikerfile-class.md +++ b/docs/mfc/reference/casyncmonikerfile-class.md @@ -4,10 +4,12 @@ title: "CAsyncMonikerFile Class" ms.date: "11/04/2016" f1_keywords: ["CAsyncMonikerFile", "AFXOLE/CAsyncMonikerFile", "AFXOLE/CAsyncMonikerFile::CAsyncMonikerFile", "AFXOLE/CAsyncMonikerFile::Close", "AFXOLE/CAsyncMonikerFile::GetBinding", "AFXOLE/CAsyncMonikerFile::GetFormatEtc", "AFXOLE/CAsyncMonikerFile::Open", "AFXOLE/CAsyncMonikerFile::CreateBindStatusCallback", "AFXOLE/CAsyncMonikerFile::GetBindInfo", "AFXOLE/CAsyncMonikerFile::GetPriority", "AFXOLE/CAsyncMonikerFile::OnDataAvailable", "AFXOLE/CAsyncMonikerFile::OnLowResource", "AFXOLE/CAsyncMonikerFile::OnProgress", "AFXOLE/CAsyncMonikerFile::OnStartBinding", "AFXOLE/CAsyncMonikerFile::OnStopBinding"] helpviewer_keywords: ["CAsyncMonikerFile [MFC], CAsyncMonikerFile", "CAsyncMonikerFile [MFC], Close", "CAsyncMonikerFile [MFC], GetBinding", "CAsyncMonikerFile [MFC], GetFormatEtc", "CAsyncMonikerFile [MFC], Open", "CAsyncMonikerFile [MFC], CreateBindStatusCallback", "CAsyncMonikerFile [MFC], GetBindInfo", "CAsyncMonikerFile [MFC], GetPriority", "CAsyncMonikerFile [MFC], OnDataAvailable", "CAsyncMonikerFile [MFC], OnLowResource", "CAsyncMonikerFile [MFC], OnProgress", "CAsyncMonikerFile [MFC], OnStartBinding", "CAsyncMonikerFile [MFC], OnStopBinding"] -ms.assetid: 17378b66-a49a-4b67-88e3-7756ad26a2fc --- # CAsyncMonikerFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides functionality for the use of asynchronous monikers in ActiveX controls (formerly OLE controls). ## Syntax diff --git a/docs/mfc/reference/casyncsocket-class.md b/docs/mfc/reference/casyncsocket-class.md index 9d1d045acdd..a88cc1ed46a 100644 --- a/docs/mfc/reference/casyncsocket-class.md +++ b/docs/mfc/reference/casyncsocket-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CAsyncSocket [MFC], CAsyncSocket", "CAsyncSocket [MFC], A --- # `CAsyncSocket` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a Windows Socket — an endpoint of network communication. ## Syntax diff --git a/docs/mfc/reference/cautohidedocksite-class.md b/docs/mfc/reference/cautohidedocksite-class.md index 9b588d7bbf0..87b68fc1d17 100644 --- a/docs/mfc/reference/cautohidedocksite-class.md +++ b/docs/mfc/reference/cautohidedocksite-class.md @@ -4,10 +4,12 @@ title: "CAutoHideDockSite Class" ms.date: "11/04/2016" f1_keywords: ["CAutoHideDockSite", "AFXAUTOHIDEDOCKSITE/CAutoHideDockSite", "AFXAUTOHIDEDOCKSITE/CAutoHideDockSite::CanAcceptPane", "AFXAUTOHIDEDOCKSITE/CAutoHideDockSite::DockPane", "AFXAUTOHIDEDOCKSITE/CAutoHideDockSite::GetAlignRect", "AFXAUTOHIDEDOCKSITE/CAutoHideDockSite::RepositionPanes", "AFXAUTOHIDEDOCKSITE/CAutoHideDockSite::SetOffsetLeft", "AFXAUTOHIDEDOCKSITE/CAutoHideDockSite::SetOffsetRight", "AFXAUTOHIDEDOCKSITE/CAutoHideDockSite::UnSetAutoHideMode", "AFXAUTOHIDEDOCKSITE/CAutoHideDockSite::m_nExtraSpace"] helpviewer_keywords: ["CAutoHideDockSite [MFC], CanAcceptPane", "CAutoHideDockSite [MFC], DockPane", "CAutoHideDockSite [MFC], GetAlignRect", "CAutoHideDockSite [MFC], RepositionPanes", "CAutoHideDockSite [MFC], SetOffsetLeft", "CAutoHideDockSite [MFC], SetOffsetRight", "CAutoHideDockSite [MFC], UnSetAutoHideMode", "CAutoHideDockSite [MFC], m_nExtraSpace"] -ms.assetid: 2a0f6bec-c369-4ab7-977d-564e7946ebad --- # CAutoHideDockSite Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CAutoHideDockSite` extends the [CDockSite Class](../../mfc/reference/cdocksite-class.md) to implement auto-hide dock panes. ## Syntax diff --git a/docs/mfc/reference/cbasekeyframe-class.md b/docs/mfc/reference/cbasekeyframe-class.md index 40785c05ad3..db616828987 100644 --- a/docs/mfc/reference/cbasekeyframe-class.md +++ b/docs/mfc/reference/cbasekeyframe-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CBaseKeyFrame [MFC], CBaseKeyFrame", "CBaseKeyFrame [MFC] --- # CBaseKeyFrame Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the basic functionality of a keyframe. ## Syntax diff --git a/docs/mfc/reference/cbasepane-class.md b/docs/mfc/reference/cbasepane-class.md index de3b9ea5943..0f46768977e 100644 --- a/docs/mfc/reference/cbasepane-class.md +++ b/docs/mfc/reference/cbasepane-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CBasePane [MFC], AccNotifyObjectFocusEvent", "CBasePane [ --- # CBasePane Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Base class for all panes in MFC. ## Syntax diff --git a/docs/mfc/reference/cbasetabbedpane-class.md b/docs/mfc/reference/cbasetabbedpane-class.md index 22e01b013fc..ce0f9df952f 100644 --- a/docs/mfc/reference/cbasetabbedpane-class.md +++ b/docs/mfc/reference/cbasetabbedpane-class.md @@ -4,10 +4,12 @@ title: "CBaseTabbedPane Class" ms.date: "11/04/2016" f1_keywords: ["CBaseTabbedPane", "AFXBASETABBEDPANE/CBaseTabbedPane", "AFXBASETABBEDPANE/CBaseTabbedPane::AddTab", "AFXBASETABBEDPANE/CBaseTabbedPane::AllowDestroyEmptyTabbedPane", "AFXBASETABBEDPANE/CBaseTabbedPane::ApplyRestoredTabInfo", "AFXBASETABBEDPANE/CBaseTabbedPane::CanFloat", "AFXBASETABBEDPANE/CBaseTabbedPane::CanSetCaptionTextToTabName", "AFXBASETABBEDPANE/CBaseTabbedPane::ConvertToTabbedDocument", "AFXBASETABBEDPANE/CBaseTabbedPane::DetachPane", "AFXBASETABBEDPANE/CBaseTabbedPane::EnableSetCaptionTextToTabName", "AFXBASETABBEDPANE/CBaseTabbedPane::FillDefaultTabsOrderArray", "AFXBASETABBEDPANE/CBaseTabbedPane::FindBarByTabNumber", "AFXBASETABBEDPANE/CBaseTabbedPane::FindPaneByID", "AFXBASETABBEDPANE/CBaseTabbedPane::FloatTab", "AFXBASETABBEDPANE/CBaseTabbedPane::GetDefaultTabsOrder", "AFXBASETABBEDPANE/CBaseTabbedPane::GetFirstVisibleTab", "AFXBASETABBEDPANE/CBaseTabbedPane::GetMinSize", "AFXBASETABBEDPANE/CBaseTabbedPane::GetPaneIcon", "AFXBASETABBEDPANE/CBaseTabbedPane::GetPaneList", "AFXBASETABBEDPANE/CBaseTabbedPane::GetTabArea", "AFXBASETABBEDPANE/CBaseTabbedPane::GetTabsNum", "AFXBASETABBEDPANE/CBaseTabbedPane::GetUnderlyingWindow", "AFXBASETABBEDPANE/CBaseTabbedPane::GetVisibleTabsNum", "AFXBASETABBEDPANE/CBaseTabbedPane::HasAutoHideMode", "AFXBASETABBEDPANE/CBaseTabbedPane::IsHideSingleTab", "AFXBASETABBEDPANE/CBaseTabbedPane::RecalcLayout", "AFXBASETABBEDPANE/CBaseTabbedPane::RemovePane", "AFXBASETABBEDPANE/CBaseTabbedPane::SetAutoDestroy", "AFXBASETABBEDPANE/CBaseTabbedPane::SetAutoHideMode", "AFXBASETABBEDPANE/CBaseTabbedPane::ShowTab"] helpviewer_keywords: ["CBaseTabbedPane [MFC], AddTab", "CBaseTabbedPane [MFC], AllowDestroyEmptyTabbedPane", "CBaseTabbedPane [MFC], ApplyRestoredTabInfo", "CBaseTabbedPane [MFC], CanFloat", "CBaseTabbedPane [MFC], CanSetCaptionTextToTabName", "CBaseTabbedPane [MFC], ConvertToTabbedDocument", "CBaseTabbedPane [MFC], DetachPane", "CBaseTabbedPane [MFC], EnableSetCaptionTextToTabName", "CBaseTabbedPane [MFC], FillDefaultTabsOrderArray", "CBaseTabbedPane [MFC], FindBarByTabNumber", "CBaseTabbedPane [MFC], FindPaneByID", "CBaseTabbedPane [MFC], FloatTab", "CBaseTabbedPane [MFC], GetDefaultTabsOrder", "CBaseTabbedPane [MFC], GetFirstVisibleTab", "CBaseTabbedPane [MFC], GetMinSize", "CBaseTabbedPane [MFC], GetPaneIcon", "CBaseTabbedPane [MFC], GetPaneList", "CBaseTabbedPane [MFC], GetTabArea", "CBaseTabbedPane [MFC], GetTabsNum", "CBaseTabbedPane [MFC], GetUnderlyingWindow", "CBaseTabbedPane [MFC], GetVisibleTabsNum", "CBaseTabbedPane [MFC], HasAutoHideMode", "CBaseTabbedPane [MFC], IsHideSingleTab", "CBaseTabbedPane [MFC], RecalcLayout", "CBaseTabbedPane [MFC], RemovePane", "CBaseTabbedPane [MFC], SetAutoDestroy", "CBaseTabbedPane [MFC], SetAutoHideMode", "CBaseTabbedPane [MFC], ShowTab"] -ms.assetid: f22c0080-5b29-4a0a-8f74-8f0a4cd2dbcf --- # CBaseTabbedPane Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Extends the functionality of the [CDockablePane Class](../../mfc/reference/cdockablepane-class.md) to support the creation of tabbed windows. ## Syntax diff --git a/docs/mfc/reference/cbasetransition-class.md b/docs/mfc/reference/cbasetransition-class.md index 83787986692..1fcad2c2626 100644 --- a/docs/mfc/reference/cbasetransition-class.md +++ b/docs/mfc/reference/cbasetransition-class.md @@ -4,10 +4,12 @@ title: "CBaseTransition Class" ms.date: "03/27/2019" f1_keywords: ["CBaseTransition", "AFXANIMATIONCONTROLLER/CBaseTransition", "AFXANIMATIONCONTROLLER/CBaseTransition::CBaseTransition", "AFXANIMATIONCONTROLLER/CBaseTransition::AddToStoryboard", "AFXANIMATIONCONTROLLER/CBaseTransition::AddToStoryboardAtKeyframes", "AFXANIMATIONCONTROLLER/CBaseTransition::Clear", "AFXANIMATIONCONTROLLER/CBaseTransition::Create", "AFXANIMATIONCONTROLLER/CBaseTransition::GetEndKeyframe", "AFXANIMATIONCONTROLLER/CBaseTransition::GetRelatedVariable", "AFXANIMATIONCONTROLLER/CBaseTransition::GetStartKeyframe", "AFXANIMATIONCONTROLLER/CBaseTransition::GetTransition", "AFXANIMATIONCONTROLLER/CBaseTransition::GetType", "AFXANIMATIONCONTROLLER/CBaseTransition::IsAdded", "AFXANIMATIONCONTROLLER/CBaseTransition::SetKeyframes", "AFXANIMATIONCONTROLLER/CBaseTransition::SetRelatedVariable", "AFXANIMATIONCONTROLLER/CBaseTransition::m_bAdded", "AFXANIMATIONCONTROLLER/CBaseTransition::m_pEndKeyframe", "AFXANIMATIONCONTROLLER/CBaseTransition::m_pRelatedVariable", "AFXANIMATIONCONTROLLER/CBaseTransition::m_pStartKeyframe", "AFXANIMATIONCONTROLLER/CBaseTransition::m_transition", "AFXANIMATIONCONTROLLER/CBaseTransition::m_type"] helpviewer_keywords: ["CBaseTransition [MFC], CBaseTransition", "CBaseTransition [MFC], AddToStoryboard", "CBaseTransition [MFC], AddToStoryboardAtKeyframes", "CBaseTransition [MFC], Clear", "CBaseTransition [MFC], Create", "CBaseTransition [MFC], GetEndKeyframe", "CBaseTransition [MFC], GetRelatedVariable", "CBaseTransition [MFC], GetStartKeyframe", "CBaseTransition [MFC], GetTransition", "CBaseTransition [MFC], GetType", "CBaseTransition [MFC], IsAdded", "CBaseTransition [MFC], SetKeyframes", "CBaseTransition [MFC], SetRelatedVariable", "CBaseTransition [MFC], m_bAdded", "CBaseTransition [MFC], m_pEndKeyframe", "CBaseTransition [MFC], m_pRelatedVariable", "CBaseTransition [MFC], m_pStartKeyframe", "CBaseTransition [MFC], m_transition", "CBaseTransition [MFC], m_type"] -ms.assetid: dfe84007-bbc5-43b7-b5b8-fae9145573bf --- # CBaseTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a basic transition. ## Syntax diff --git a/docs/mfc/reference/cbitmap-class.md b/docs/mfc/reference/cbitmap-class.md index 41642f129b5..c914aa52a4b 100644 --- a/docs/mfc/reference/cbitmap-class.md +++ b/docs/mfc/reference/cbitmap-class.md @@ -4,10 +4,12 @@ title: "CBitmap Class" ms.date: "11/04/2016" f1_keywords: ["CBitmap", "AFXWIN/CBitmap", "AFXWIN/CBitmap::CBitmap", "AFXWIN/CBitmap::CreateBitmap", "AFXWIN/CBitmap::CreateBitmapIndirect", "AFXWIN/CBitmap::CreateCompatibleBitmap", "AFXWIN/CBitmap::CreateDiscardableBitmap", "AFXWIN/CBitmap::FromHandle", "AFXWIN/CBitmap::GetBitmap", "AFXWIN/CBitmap::GetBitmapBits", "AFXWIN/CBitmap::GetBitmapDimension", "AFXWIN/CBitmap::LoadBitmap", "AFXWIN/CBitmap::LoadMappedBitmap", "AFXWIN/CBitmap::LoadOEMBitmap", "AFXWIN/CBitmap::SetBitmapBits", "AFXWIN/CBitmap::SetBitmapDimension"] helpviewer_keywords: ["CBitmap [MFC], CBitmap", "CBitmap [MFC], CreateBitmap", "CBitmap [MFC], CreateBitmapIndirect", "CBitmap [MFC], CreateCompatibleBitmap", "CBitmap [MFC], CreateDiscardableBitmap", "CBitmap [MFC], FromHandle", "CBitmap [MFC], GetBitmap", "CBitmap [MFC], GetBitmapBits", "CBitmap [MFC], GetBitmapDimension", "CBitmap [MFC], LoadBitmap", "CBitmap [MFC], LoadMappedBitmap", "CBitmap [MFC], LoadOEMBitmap", "CBitmap [MFC], SetBitmapBits", "CBitmap [MFC], SetBitmapDimension"] -ms.assetid: 3980616a-c59d-495a-86e6-62bd3889c84c --- # `CBitmap` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a Windows graphics device interface (GDI) bitmap and provides member functions to manipulate the bitmap. ## Syntax diff --git a/docs/mfc/reference/cbitmapbutton-class.md b/docs/mfc/reference/cbitmapbutton-class.md index 40777e6f653..74b93c9d90c 100644 --- a/docs/mfc/reference/cbitmapbutton-class.md +++ b/docs/mfc/reference/cbitmapbutton-class.md @@ -4,10 +4,12 @@ title: "CBitmapButton Class" ms.date: "11/04/2016" f1_keywords: ["CBitmapButton", "AFXEXT/CBitmapButton", "AFXEXT/CBitmapButton::CBitmapButton", "AFXEXT/CBitmapButton::AutoLoad", "AFXEXT/CBitmapButton::LoadBitmaps", "AFXEXT/CBitmapButton::SizeToContent"] helpviewer_keywords: ["CBitmapButton [MFC], CBitmapButton", "CBitmapButton [MFC], AutoLoad", "CBitmapButton [MFC], LoadBitmaps", "CBitmapButton [MFC], SizeToContent"] -ms.assetid: 9ad6cb45-c3c4-4fb1-96d3-1fe3df7bbcfc --- # CBitmapButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Creates pushbutton controls labeled with bitmapped images instead of text. ## Syntax diff --git a/docs/mfc/reference/cbitmaprendertarget-class.md b/docs/mfc/reference/cbitmaprendertarget-class.md index 39e0ba6e5b0..c0469597461 100644 --- a/docs/mfc/reference/cbitmaprendertarget-class.md +++ b/docs/mfc/reference/cbitmaprendertarget-class.md @@ -4,10 +4,12 @@ title: "CBitmapRenderTarget Class" ms.date: "11/04/2016" f1_keywords: ["CBitmapRenderTarget", "AFXRENDERTARGET/CBitmapRenderTarget", "AFXRENDERTARGET/CBitmapRenderTarget::CBitmapRenderTarget", "AFXRENDERTARGET/CBitmapRenderTarget::Attach", "AFXRENDERTARGET/CBitmapRenderTarget::Detach", "AFXRENDERTARGET/CBitmapRenderTarget::GetBitmap", "AFXRENDERTARGET/CBitmapRenderTarget::GetBitmapRenderTarget", "AFXRENDERTARGET/CBitmapRenderTarget::m_pBitmapRenderTarget"] helpviewer_keywords: ["CBitmapRenderTarget [MFC], CBitmapRenderTarget", "CBitmapRenderTarget [MFC], Attach", "CBitmapRenderTarget [MFC], Detach", "CBitmapRenderTarget [MFC], GetBitmap", "CBitmapRenderTarget [MFC], GetBitmapRenderTarget", "CBitmapRenderTarget [MFC], m_pBitmapRenderTarget"] -ms.assetid: c89a4437-812e-4943-acb2-b429a04cc4d2 --- # CBitmapRenderTarget Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1BitmapRenderTarget. ## Syntax diff --git a/docs/mfc/reference/cbrush-class.md b/docs/mfc/reference/cbrush-class.md index e9173b9a1b9..274a3dac48a 100644 --- a/docs/mfc/reference/cbrush-class.md +++ b/docs/mfc/reference/cbrush-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CBrush [MFC], CBrush", "CBrush [MFC], CreateBrushIndirect --- # `CBrush` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a Windows graphics device interface (GDI) brush. ## Syntax diff --git a/docs/mfc/reference/cbutton-class.md b/docs/mfc/reference/cbutton-class.md index 3d19e7ff585..607dd0251aa 100644 --- a/docs/mfc/reference/cbutton-class.md +++ b/docs/mfc/reference/cbutton-class.md @@ -4,10 +4,12 @@ title: "CButton Class" ms.date: "11/04/2016" f1_keywords: ["CButton", "AFXWIN/CButton", "AFXWIN/CButton::CButton", "AFXWIN/CButton::Create", "AFXWIN/CButton::DrawItem", "AFXWIN/CButton::GetBitmap", "AFXWIN/CButton::GetButtonStyle", "AFXWIN/CButton::GetCheck", "AFXWIN/CButton::GetCursor", "AFXWIN/CButton::GetIcon", "AFXWIN/CButton::GetIdealSize", "AFXWIN/CButton::GetImageList", "AFXWIN/CButton::GetNote", "AFXWIN/CButton::GetNoteLength", "AFXWIN/CButton::GetSplitGlyph", "AFXWIN/CButton::GetSplitImageList", "AFXWIN/CButton::GetSplitInfo", "AFXWIN/CButton::GetSplitSize", "AFXWIN/CButton::GetSplitStyle", "AFXWIN/CButton::GetState", "AFXWIN/CButton::GetTextMargin", "AFXWIN/CButton::SetBitmap", "AFXWIN/CButton::SetButtonStyle", "AFXWIN/CButton::SetCheck", "AFXWIN/CButton::SetCursor", "AFXWIN/CButton::SetDropDownState", "AFXWIN/CButton::SetIcon", "AFXWIN/CButton::SetImageList", "AFXWIN/CButton::SetNote", "AFXWIN/CButton::SetSplitGlyph", "AFXWIN/CButton::SetSplitImageList", "AFXWIN/CButton::SetSplitInfo", "AFXWIN/CButton::SetSplitSize", "AFXWIN/CButton::SetSplitStyle", "AFXWIN/CButton::SetState", "AFXWIN/CButton::SetTextMargin"] helpviewer_keywords: ["CButton [MFC], CButton", "CButton [MFC], Create", "CButton [MFC], DrawItem", "CButton [MFC], GetBitmap", "CButton [MFC], GetButtonStyle", "CButton [MFC], GetCheck", "CButton [MFC], GetCursor", "CButton [MFC], GetIcon", "CButton [MFC], GetIdealSize", "CButton [MFC], GetImageList", "CButton [MFC], GetNote", "CButton [MFC], GetNoteLength", "CButton [MFC], GetSplitGlyph", "CButton [MFC], GetSplitImageList", "CButton [MFC], GetSplitInfo", "CButton [MFC], GetSplitSize", "CButton [MFC], GetSplitStyle", "CButton [MFC], GetState", "CButton [MFC], GetTextMargin", "CButton [MFC], SetBitmap", "CButton [MFC], SetButtonStyle", "CButton [MFC], SetCheck", "CButton [MFC], SetCursor", "CButton [MFC], SetDropDownState", "CButton [MFC], SetIcon", "CButton [MFC], SetImageList", "CButton [MFC], SetNote", "CButton [MFC], SetSplitGlyph", "CButton [MFC], SetSplitImageList", "CButton [MFC], SetSplitInfo", "CButton [MFC], SetSplitSize", "CButton [MFC], SetSplitStyle", "CButton [MFC], SetState", "CButton [MFC], SetTextMargin"] -ms.assetid: cdc76d5b-31da-43c5-bc43-fde4cb39de5b --- # CButton Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of Windows button controls. ## Syntax diff --git a/docs/mfc/reference/cbytearray-class.md b/docs/mfc/reference/cbytearray-class.md index 9010e7b881a..42df04444be 100644 --- a/docs/mfc/reference/cbytearray-class.md +++ b/docs/mfc/reference/cbytearray-class.md @@ -4,10 +4,12 @@ title: "CByteArray Class" ms.date: "11/04/2016" f1_keywords: ["CByteArray", "AFXCOLL/CByteArray", "AFXCOLL/CByteArray::CByteArray", "AFXCOLL/CByteArray::Add", "AFXCOLL/CByteArray::Append", "AFXCOLL/CByteArray::Copy", "AFXCOLL/CByteArray::ElementAt", "AFXCOLL/CByteArray::FreeExtra", "AFXCOLL/CByteArray::GetAt", "AFXCOLL/CByteArray::GetCount", "AFXCOLL/CByteArray::GetData", "AFXCOLL/CByteArray::GetSize", "AFXCOLL/CByteArray::GetUpperBound", "AFXCOLL/CByteArray::InsertAt", "AFXCOLL/CByteArray::IsEmpty", "AFXCOLL/CByteArray::RemoveAll", "AFXCOLL/CByteArray::RemoveAt", "AFXCOLL/CByteArray::SetAt", "AFXCOLL/CByteArray::SetAtGrow", "AFXCOLL/CByteArray::SetSize"] helpviewer_keywords: ["CByteArray [MFC], CByteArray", "CByteArray [MFC], Add", "CByteArray [MFC], Append", "CByteArray [MFC], Copy", "CByteArray [MFC], ElementAt", "CByteArray [MFC], FreeExtra", "CByteArray [MFC], GetAt", "CByteArray [MFC], GetCount", "CByteArray [MFC], GetData", "CByteArray [MFC], GetSize", "CByteArray [MFC], GetUpperBound", "CByteArray [MFC], InsertAt", "CByteArray [MFC], IsEmpty", "CByteArray [MFC], RemoveAll", "CByteArray [MFC], RemoveAt", "CByteArray [MFC], SetAt", "CByteArray [MFC], SetAtGrow", "CByteArray [MFC], SetSize"] -ms.assetid: 53d4a512-657c-4187-9609-e3f5339a78e0 --- # CByteArray Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports dynamic arrays of bytes. ## Syntax diff --git a/docs/mfc/reference/ccacheddatapathproperty-class.md b/docs/mfc/reference/ccacheddatapathproperty-class.md index bbbdeb2971a..e437ac08a70 100644 --- a/docs/mfc/reference/ccacheddatapathproperty-class.md +++ b/docs/mfc/reference/ccacheddatapathproperty-class.md @@ -4,10 +4,12 @@ title: "CCachedDataPathProperty Class" ms.date: "11/04/2016" f1_keywords: ["CCachedDataPathProperty", "AFXCTL/CCachedDataPathProperty", "AFXCTL/CCachedDataPathProperty::CCachedDataPathProperty", "AFXCTL/CCachedDataPathProperty::m_Cache"] helpviewer_keywords: ["CCachedDataPathProperty [MFC], CCachedDataPathProperty", "CCachedDataPathProperty [MFC], m_Cache"] -ms.assetid: 0d81356b-4fe5-43f6-aed2-2eb5a5485706 --- # CCachedDataPathProperty Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements an OLE control property transferred asynchronously and cached in a memory file. ## Syntax diff --git a/docs/mfc/reference/cchecklistbox-class.md b/docs/mfc/reference/cchecklistbox-class.md index 1ef8922947c..ab55aaf58ec 100644 --- a/docs/mfc/reference/cchecklistbox-class.md +++ b/docs/mfc/reference/cchecklistbox-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CCheckListBox [MFC], CCheckListBox", "CCheckListBox [MFC] --- # `CCheckListBox` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows checklist box. ## Syntax diff --git a/docs/mfc/reference/cclientdc-class.md b/docs/mfc/reference/cclientdc-class.md index 02091a39e28..1321c52ab06 100644 --- a/docs/mfc/reference/cclientdc-class.md +++ b/docs/mfc/reference/cclientdc-class.md @@ -4,10 +4,12 @@ title: "CClientDC Class" ms.date: "11/04/2016" f1_keywords: ["CClientDC", "AFXWIN/CClientDC", "AFXWIN/CClientDC::CClientDC", "AFXWIN/CClientDC::m_hWnd"] helpviewer_keywords: ["CClientDC [MFC], CClientDC", "CClientDC [MFC], m_hWnd"] -ms.assetid: 8a871d6b-06f8-496e-9fa3-9a5780848369 --- # CClientDC Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Takes care of calling the Windows functions [GetDC](/windows/win32/api/winuser/nf-winuser-getdc) at construction time and [ReleaseDC](/windows/win32/api/winuser/nf-winuser-releasedc) at destruction time. ## Syntax diff --git a/docs/mfc/reference/ccmdtarget-class.md b/docs/mfc/reference/ccmdtarget-class.md index 6c3bdf1fc05..e089d2093e5 100644 --- a/docs/mfc/reference/ccmdtarget-class.md +++ b/docs/mfc/reference/ccmdtarget-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CCmdTarget [MFC], CCmdTarget", "CCmdTarget [MFC], BeginWa --- # `CCmdTarget` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for the Microsoft Foundation Class Library message-map architecture. ## Syntax diff --git a/docs/mfc/reference/ccmdui-class.md b/docs/mfc/reference/ccmdui-class.md index f110e8be151..52a40e07db6 100644 --- a/docs/mfc/reference/ccmdui-class.md +++ b/docs/mfc/reference/ccmdui-class.md @@ -4,10 +4,12 @@ title: "CCmdUI Class" ms.date: "09/06/2019" f1_keywords: ["CCmdUI", "AFXWIN/CCmdUI", "AFXWIN/CCmdUI::ContinueRouting", "AFXWIN/CCmdUI::Enable", "AFXWIN/CCmdUI::SetCheck", "AFXWIN/CCmdUI::SetRadio", "AFXWIN/CCmdUI::SetText", "AFXWIN/CCmdUI::m_nID", "AFXWIN/CCmdUI::m_nIndex", "AFXWIN/CCmdUI::m_pMenu", "AFXWIN/CCmdUI::m_pOther", "AFXWIN/CCmdUI::m_pSubMenu"] helpviewer_keywords: ["CCmdUI [MFC], ContinueRouting", "CCmdUI [MFC], Enable", "CCmdUI [MFC], SetCheck", "CCmdUI [MFC], SetRadio", "CCmdUI [MFC], SetText", "CCmdUI [MFC], m_nID", "CCmdUI [MFC], m_nIndex", "CCmdUI [MFC], m_pMenu", "CCmdUI [MFC], m_pOther", "CCmdUI [MFC], m_pSubMenu"] -ms.assetid: 04eaaaf5-f510-48ab-b425-94665ba24766 --- # CCmdUI Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Is used only within an `ON_UPDATE_COMMAND_UI` handler in a `CCmdTarget`-derived class. ## Syntax diff --git a/docs/mfc/reference/ccolordialog-class.md b/docs/mfc/reference/ccolordialog-class.md index 3ef9b0282c5..d860dfcfc00 100644 --- a/docs/mfc/reference/ccolordialog-class.md +++ b/docs/mfc/reference/ccolordialog-class.md @@ -4,10 +4,12 @@ title: "CColorDialog Class" ms.date: "11/04/2016" f1_keywords: ["CColorDialog", "AFXDLGS/CColorDialog", "AFXDLGS/CColorDialog::CColorDialog", "AFXDLGS/CColorDialog::DoModal", "AFXDLGS/CColorDialog::GetColor", "AFXDLGS/CColorDialog::GetSavedCustomColors", "AFXDLGS/CColorDialog::SetCurrentColor", "AFXDLGS/CColorDialog::OnColorOK", "AFXDLGS/CColorDialog::m_cc"] helpviewer_keywords: ["CColorDialog [MFC], CColorDialog", "CColorDialog [MFC], DoModal", "CColorDialog [MFC], GetColor", "CColorDialog [MFC], GetSavedCustomColors", "CColorDialog [MFC], SetCurrentColor", "CColorDialog [MFC], OnColorOK", "CColorDialog [MFC], m_cc"] -ms.assetid: d013dc25-9290-4b5d-a97e-95ad7208e13b --- # CColorDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allows you to incorporate a color-selection dialog box into your application. ## Syntax diff --git a/docs/mfc/reference/ccombobox-class.md b/docs/mfc/reference/ccombobox-class.md index ca740d929f8..fb99b69cc46 100644 --- a/docs/mfc/reference/ccombobox-class.md +++ b/docs/mfc/reference/ccombobox-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CComboBox [MFC], CComboBox", "CComboBox [MFC], AddString" --- # `CComboBox` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows combo box. ## Syntax diff --git a/docs/mfc/reference/ccomboboxex-class.md b/docs/mfc/reference/ccomboboxex-class.md index 5038d39997d..51257fd7d41 100644 --- a/docs/mfc/reference/ccomboboxex-class.md +++ b/docs/mfc/reference/ccomboboxex-class.md @@ -4,10 +4,12 @@ title: "CComboBoxEx Class" ms.date: "11/04/2016" f1_keywords: ["CComboBoxEx", "AFXCMN/CComboBoxEx", "AFXCMN/CComboBoxEx::CComboBoxEx", "AFXCMN/CComboBoxEx::Create", "AFXCMN/CComboBoxEx::CreateEx", "AFXCMN/CComboBoxEx::DeleteItem", "AFXCMN/CComboBoxEx::GetComboBoxCtrl", "AFXCMN/CComboBoxEx::GetEditCtrl", "AFXCMN/CComboBoxEx::GetExtendedStyle", "AFXCMN/CComboBoxEx::GetImageList", "AFXCMN/CComboBoxEx::GetItem", "AFXCMN/CComboBoxEx::HasEditChanged", "AFXCMN/CComboBoxEx::InsertItem", "AFXCMN/CComboBoxEx::SetExtendedStyle", "AFXCMN/CComboBoxEx::SetImageList", "AFXCMN/CComboBoxEx::SetItem", "AFXCMN/CComboBoxEx::SetWindowTheme"] helpviewer_keywords: ["CComboBoxEx [MFC], CComboBoxEx", "CComboBoxEx [MFC], Create", "CComboBoxEx [MFC], CreateEx", "CComboBoxEx [MFC], DeleteItem", "CComboBoxEx [MFC], GetComboBoxCtrl", "CComboBoxEx [MFC], GetEditCtrl", "CComboBoxEx [MFC], GetExtendedStyle", "CComboBoxEx [MFC], GetImageList", "CComboBoxEx [MFC], GetItem", "CComboBoxEx [MFC], HasEditChanged", "CComboBoxEx [MFC], InsertItem", "CComboBoxEx [MFC], SetExtendedStyle", "CComboBoxEx [MFC], SetImageList", "CComboBoxEx [MFC], SetItem", "CComboBoxEx [MFC], SetWindowTheme"] -ms.assetid: 33ca960a-2409-478c-84a4-a2ee8ecfe8f7 --- # CComboBoxEx Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Extends the combo box control by providing support for image lists. ## Syntax diff --git a/docs/mfc/reference/ccommandlineinfo-class.md b/docs/mfc/reference/ccommandlineinfo-class.md index 0702885e23c..3f165999fdd 100644 --- a/docs/mfc/reference/ccommandlineinfo-class.md +++ b/docs/mfc/reference/ccommandlineinfo-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CCommandLineInfo [MFC], CCommandLineInfo", "CCommandLineI --- # `CCommandLineInfo` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Aids in parsing the command line at application startup. ## Syntax diff --git a/docs/mfc/reference/ccommondialog-class.md b/docs/mfc/reference/ccommondialog-class.md index bb92ea0e98a..80866aebe99 100644 --- a/docs/mfc/reference/ccommondialog-class.md +++ b/docs/mfc/reference/ccommondialog-class.md @@ -4,10 +4,12 @@ title: "CCommonDialog Class" ms.date: "11/04/2016" f1_keywords: ["CCommonDialog", "AFXDLGS/CCommonDialog", "AFXDLGS/CCommonDialog::CCommonDialog"] helpviewer_keywords: ["CCommonDialog [MFC], CCommonDialog"] -ms.assetid: 1f68d65f-a0fd-4778-be22-ebbe51a95f95 --- # CCommonDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for classes that encapsulate functionality of the Windows common dialogs. ## Syntax diff --git a/docs/mfc/reference/cconnectionpoint-class.md b/docs/mfc/reference/cconnectionpoint-class.md index 97925d83f01..8ee400a356d 100644 --- a/docs/mfc/reference/cconnectionpoint-class.md +++ b/docs/mfc/reference/cconnectionpoint-class.md @@ -4,10 +4,12 @@ title: "CConnectionPoint Class" ms.date: "11/04/2016" f1_keywords: ["CConnectionPoint", "AFXDISP/CConnectionPoint", "AFXDISP/CConnectionPoint::CConnectionPoint", "AFXDISP/CConnectionPoint::GetConnections", "AFXDISP/CConnectionPoint::GetContainer", "AFXDISP/CConnectionPoint::GetIID", "AFXDISP/CConnectionPoint::GetMaxConnections", "AFXDISP/CConnectionPoint::GetNextConnection", "AFXDISP/CConnectionPoint::GetStartPosition", "AFXDISP/CConnectionPoint::OnAdvise", "AFXDISP/CConnectionPoint::QuerySinkInterface"] helpviewer_keywords: ["CConnectionPoint [MFC], CConnectionPoint", "CConnectionPoint [MFC], GetConnections", "CConnectionPoint [MFC], GetContainer", "CConnectionPoint [MFC], GetIID", "CConnectionPoint [MFC], GetMaxConnections", "CConnectionPoint [MFC], GetNextConnection", "CConnectionPoint [MFC], GetStartPosition", "CConnectionPoint [MFC], OnAdvise", "CConnectionPoint [MFC], QuerySinkInterface"] -ms.assetid: f0f23a1e-5e8c-41a9-aa6c-1a4793b28e8f --- # CConnectionPoint Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Defines a special type of interface used to communicate with other OLE objects, called a "connection point." ## Syntax diff --git a/docs/mfc/reference/cconstanttransition-class.md b/docs/mfc/reference/cconstanttransition-class.md index 16a55675bc6..717319d3441 100644 --- a/docs/mfc/reference/cconstanttransition-class.md +++ b/docs/mfc/reference/cconstanttransition-class.md @@ -4,10 +4,12 @@ title: "CConstantTransition Class" ms.date: "11/04/2016" f1_keywords: ["CConstantTransition", "AFXANIMATIONCONTROLLER/CConstantTransition", "AFXANIMATIONCONTROLLER/CConstantTransition::CConstantTransition", "AFXANIMATIONCONTROLLER/CConstantTransition::Create", "AFXANIMATIONCONTROLLER/CConstantTransition::m_duration"] helpviewer_keywords: ["CConstantTransition [MFC], CConstantTransition", "CConstantTransition [MFC], Create", "CConstantTransition [MFC], m_duration"] -ms.assetid: f6fa4780-a71b-4cd6-80aa-d4792ace36c2 --- # CConstantTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a constant transition. ## Syntax diff --git a/docs/mfc/reference/ccontextmenumanager-class.md b/docs/mfc/reference/ccontextmenumanager-class.md index 5c6539ddf36..f2800b39bcb 100644 --- a/docs/mfc/reference/ccontextmenumanager-class.md +++ b/docs/mfc/reference/ccontextmenumanager-class.md @@ -4,10 +4,12 @@ title: "CContextMenuManager Class" ms.date: "11/04/2016" f1_keywords: ["CContextMenuManager", "AFXCONTEXTMENUMANAGER/CContextMenuManager", "AFXCONTEXTMENUMANAGER/CContextMenuManager::CContextMenuManager", "AFXCONTEXTMENUMANAGER/CContextMenuManager::AddMenu", "AFXCONTEXTMENUMANAGER/CContextMenuManager::GetMenuById", "AFXCONTEXTMENUMANAGER/CContextMenuManager::GetMenuByName", "AFXCONTEXTMENUMANAGER/CContextMenuManager::GetMenuNames", "AFXCONTEXTMENUMANAGER/CContextMenuManager::LoadState", "AFXCONTEXTMENUMANAGER/CContextMenuManager::ResetState", "AFXCONTEXTMENUMANAGER/CContextMenuManager::SaveState", "AFXCONTEXTMENUMANAGER/CContextMenuManager::SetDontCloseActiveMenu", "AFXCONTEXTMENUMANAGER/CContextMenuManager::ShowPopupMenu", "AFXCONTEXTMENUMANAGER/CContextMenuManager::TrackPopupMenu"] helpviewer_keywords: ["CContextMenuManager [MFC], CContextMenuManager", "CContextMenuManager [MFC], AddMenu", "CContextMenuManager [MFC], GetMenuById", "CContextMenuManager [MFC], GetMenuByName", "CContextMenuManager [MFC], GetMenuNames", "CContextMenuManager [MFC], LoadState", "CContextMenuManager [MFC], ResetState", "CContextMenuManager [MFC], SaveState", "CContextMenuManager [MFC], SetDontCloseActiveMenu", "CContextMenuManager [MFC], ShowPopupMenu", "CContextMenuManager [MFC], TrackPopupMenu"] -ms.assetid: 1de20640-243c-47e1-85de-1baa4153bc83 --- # CContextMenuManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CContextMenuManager` object manages shortcut menus, also known as context menus. ## Syntax diff --git a/docs/mfc/reference/ccontrolbar-class.md b/docs/mfc/reference/ccontrolbar-class.md index d8ab52bf13f..3216a4f4a83 100644 --- a/docs/mfc/reference/ccontrolbar-class.md +++ b/docs/mfc/reference/ccontrolbar-class.md @@ -4,10 +4,12 @@ title: "CControlBar Class" ms.date: "11/04/2016" f1_keywords: ["CControlBar", "AFXEXT/CControlBar", "AFXEXT/CControlBar::CControlBar", "AFXEXT/CControlBar::CalcDynamicLayout", "AFXEXT/CControlBar::CalcFixedLayout", "AFXEXT/CControlBar::CalcInsideRect", "AFXEXT/CControlBar::DoPaint", "AFXEXT/CControlBar::DrawBorders", "AFXEXT/CControlBar::DrawGripper", "AFXEXT/CControlBar::EnableDocking", "AFXEXT/CControlBar::GetBarStyle", "AFXEXT/CControlBar::GetBorders", "AFXEXT/CControlBar::GetCount", "AFXEXT/CControlBar::GetDockingFrame", "AFXEXT/CControlBar::IsFloating", "AFXEXT/CControlBar::OnUpdateCmdUI", "AFXEXT/CControlBar::SetBarStyle", "AFXEXT/CControlBar::SetBorders", "AFXEXT/CControlBar::SetInPlaceOwner", "AFXEXT/CControlBar::m_bAutoDelete", "AFXEXT/CControlBar::m_pInPlaceOwner"] helpviewer_keywords: ["CControlBar [MFC], CControlBar", "CControlBar [MFC], CalcDynamicLayout", "CControlBar [MFC], CalcFixedLayout", "CControlBar [MFC], CalcInsideRect", "CControlBar [MFC], DoPaint", "CControlBar [MFC], DrawBorders", "CControlBar [MFC], DrawGripper", "CControlBar [MFC], EnableDocking", "CControlBar [MFC], GetBarStyle", "CControlBar [MFC], GetBorders", "CControlBar [MFC], GetCount", "CControlBar [MFC], GetDockingFrame", "CControlBar [MFC], IsFloating", "CControlBar [MFC], OnUpdateCmdUI", "CControlBar [MFC], SetBarStyle", "CControlBar [MFC], SetBorders", "CControlBar [MFC], SetInPlaceOwner", "CControlBar [MFC], m_bAutoDelete", "CControlBar [MFC], m_pInPlaceOwner"] -ms.assetid: 4d668c55-9b42-4838-97ac-cf2b3000b82c --- # CControlBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for the control-bar classes [CStatusBar](../../mfc/reference/cstatusbar-class.md), [CToolBar](../../mfc/reference/ctoolbar-class.md), [CDialogBar](../../mfc/reference/cdialogbar-class.md), [CReBar](../../mfc/reference/crebar-class.md), and [COleResizeBar](../../mfc/reference/coleresizebar-class.md). ## Syntax diff --git a/docs/mfc/reference/ccreatecontext-structure.md b/docs/mfc/reference/ccreatecontext-structure.md index 5e388a6ea2c..f51446f4efe 100644 --- a/docs/mfc/reference/ccreatecontext-structure.md +++ b/docs/mfc/reference/ccreatecontext-structure.md @@ -4,10 +4,12 @@ title: "CCreateContext Structure" ms.date: "11/04/2016" f1_keywords: ["CCreateContext"] helpviewer_keywords: ["CCreateContext structure [MFC]"] -ms.assetid: 337a0e44-d910-49a8-afc0-c7207666a9dc --- # CCreateContext Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The framework uses the `CCreateContext` structure when it creates the frame windows and views that are associated with a document. ## Syntax diff --git a/docs/mfc/reference/ccriticalsection-class.md b/docs/mfc/reference/ccriticalsection-class.md index 5f747387318..d8d4e783423 100644 --- a/docs/mfc/reference/ccriticalsection-class.md +++ b/docs/mfc/reference/ccriticalsection-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CCriticalSection [MFC], CCriticalSection", "CCriticalSect --- # `CCriticalSection` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a "critical section" — a synchronization object that allows one thread at a time to access a resource or section of code. ## Syntax diff --git a/docs/mfc/reference/cctrlview-class.md b/docs/mfc/reference/cctrlview-class.md index c2d7a5d4315..818994d888b 100644 --- a/docs/mfc/reference/cctrlview-class.md +++ b/docs/mfc/reference/cctrlview-class.md @@ -4,10 +4,12 @@ title: "CCtrlView Class" ms.date: "11/04/2016" f1_keywords: ["CCtrlView", "AFXWIN/CCtrlView", "AFXWIN/CCtrlView::CCtrlView", "AFXWIN/CCtrlView::OnDraw", "AFXWIN/CCtrlView::PreCreateWindow", "AFXWIN/CCtrlView::m_dwDefaultStyle", "AFXWIN/CCtrlView::m_strClass"] helpviewer_keywords: ["CCtrlView [MFC], CCtrlView", "CCtrlView [MFC], OnDraw", "CCtrlView [MFC], PreCreateWindow", "CCtrlView [MFC], m_dwDefaultStyle", "CCtrlView [MFC], m_strClass"] -ms.assetid: ff488596-1e71-451f-8fec-b0831a7b44e0 --- # CCtrlView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Adapts the document-view architecture to the common controls supported by Windows 98 and Windows NT versions 3.51 and later. ## Syntax diff --git a/docs/mfc/reference/ccubictransition-class.md b/docs/mfc/reference/ccubictransition-class.md index 17ba50a9a7c..093c1ed04d9 100644 --- a/docs/mfc/reference/ccubictransition-class.md +++ b/docs/mfc/reference/ccubictransition-class.md @@ -4,10 +4,12 @@ title: "CCubicTransition Class" ms.date: "11/04/2016" f1_keywords: ["CCubicTransition", "AFXANIMATIONCONTROLLER/CCubicTransition", "AFXANIMATIONCONTROLLER/CCubicTransition::CCubicTransition", "AFXANIMATIONCONTROLLER/CCubicTransition::Create", "AFXANIMATIONCONTROLLER/CCubicTransition::m_dblFinalValue", "AFXANIMATIONCONTROLLER/CCubicTransition::m_dblFinalVelocity", "AFXANIMATIONCONTROLLER/CCubicTransition::m_duration"] helpviewer_keywords: ["CCubicTransition [MFC], CCubicTransition", "CCubicTransition [MFC], Create", "CCubicTransition [MFC], m_dblFinalValue", "CCubicTransition [MFC], m_dblFinalVelocity", "CCubicTransition [MFC], m_duration"] -ms.assetid: 4fc30e9c-160c-45e1-bdbe-51adf8fee9c5 --- # CCubicTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a cubic transition. ## Syntax diff --git a/docs/mfc/reference/ccustominterpolator-class.md b/docs/mfc/reference/ccustominterpolator-class.md index e1ab9c85536..270871b36a5 100644 --- a/docs/mfc/reference/ccustominterpolator-class.md +++ b/docs/mfc/reference/ccustominterpolator-class.md @@ -4,10 +4,12 @@ title: "CCustomInterpolator Class" ms.date: "11/04/2016" f1_keywords: ["CCustomInterpolator", "AFXANIMATIONCONTROLLER/CCustomInterpolator", "AFXANIMATIONCONTROLLER/CCustomInterpolator::CCustomInterpolator", "AFXANIMATIONCONTROLLER/CCustomInterpolator::GetDependencies", "AFXANIMATIONCONTROLLER/CCustomInterpolator::GetDuration", "AFXANIMATIONCONTROLLER/CCustomInterpolator::GetFinalValue", "AFXANIMATIONCONTROLLER/CCustomInterpolator::Init", "AFXANIMATIONCONTROLLER/CCustomInterpolator::InterpolateValue", "AFXANIMATIONCONTROLLER/CCustomInterpolator::InterpolateVelocity", "AFXANIMATIONCONTROLLER/CCustomInterpolator::SetDuration", "AFXANIMATIONCONTROLLER/CCustomInterpolator::SetInitialValueAndVelocity", "AFXANIMATIONCONTROLLER/CCustomInterpolator::m_currentValue", "AFXANIMATIONCONTROLLER/CCustomInterpolator::m_currentVelocity", "AFXANIMATIONCONTROLLER/CCustomInterpolator::m_duration", "AFXANIMATIONCONTROLLER/CCustomInterpolator::m_finalValue", "AFXANIMATIONCONTROLLER/CCustomInterpolator::m_initialValue", "AFXANIMATIONCONTROLLER/CCustomInterpolator::m_initialVelocity"] helpviewer_keywords: ["CCustomInterpolator [MFC], CCustomInterpolator", "CCustomInterpolator [MFC], GetDependencies", "CCustomInterpolator [MFC], GetDuration", "CCustomInterpolator [MFC], GetFinalValue", "CCustomInterpolator [MFC], Init", "CCustomInterpolator [MFC], InterpolateValue", "CCustomInterpolator [MFC], InterpolateVelocity", "CCustomInterpolator [MFC], SetDuration", "CCustomInterpolator [MFC], SetInitialValueAndVelocity", "CCustomInterpolator [MFC], m_currentValue", "CCustomInterpolator [MFC], m_currentVelocity", "CCustomInterpolator [MFC], m_duration", "CCustomInterpolator [MFC], m_finalValue", "CCustomInterpolator [MFC], m_initialValue", "CCustomInterpolator [MFC], m_initialVelocity"] -ms.assetid: 28d85595-989a-40a3-b003-e0e38437a94d --- # CCustomInterpolator Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a basic interpolator. ## Syntax diff --git a/docs/mfc/reference/ccustomtransition-class.md b/docs/mfc/reference/ccustomtransition-class.md index 36e2810e347..73ffb6d571d 100644 --- a/docs/mfc/reference/ccustomtransition-class.md +++ b/docs/mfc/reference/ccustomtransition-class.md @@ -4,10 +4,12 @@ title: "CCustomTransition Class" ms.date: "11/04/2016" f1_keywords: ["CCustomTransition", "AFXANIMATIONCONTROLLER/CCustomTransition", "AFXANIMATIONCONTROLLER/CCustomTransition::CCustomTransition", "AFXANIMATIONCONTROLLER/CCustomTransition::Create", "AFXANIMATIONCONTROLLER/CCustomTransition::SetInitialValue", "AFXANIMATIONCONTROLLER/CCustomTransition::SetInitialVelocity", "AFXANIMATIONCONTROLLER/CCustomTransition::m_bInitialValueSpecified", "AFXANIMATIONCONTROLLER/CCustomTransition::m_bInitialVelocitySpecified", "AFXANIMATIONCONTROLLER/CCustomTransition::m_initialValue", "AFXANIMATIONCONTROLLER/CCustomTransition::m_initialVelocity", "AFXANIMATIONCONTROLLER/CCustomTransition::m_pInterpolator"] helpviewer_keywords: ["CCustomTransition [MFC], CCustomTransition", "CCustomTransition [MFC], Create", "CCustomTransition [MFC], SetInitialValue", "CCustomTransition [MFC], SetInitialVelocity", "CCustomTransition [MFC], m_bInitialValueSpecified", "CCustomTransition [MFC], m_bInitialVelocitySpecified", "CCustomTransition [MFC], m_initialValue", "CCustomTransition [MFC], m_initialVelocity", "CCustomTransition [MFC], m_pInterpolator"] -ms.assetid: 5bd3f492-940f-4290-a38b-fa68eb8f8401 --- # CCustomTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a custom transition. ## Syntax diff --git a/docs/mfc/reference/cd2dbitmap-class.md b/docs/mfc/reference/cd2dbitmap-class.md index 9527c8a6532..b763abcc8b7 100644 --- a/docs/mfc/reference/cd2dbitmap-class.md +++ b/docs/mfc/reference/cd2dbitmap-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CD2DBitmap [MFC], CD2DBitmap", "CD2DBitmap [MFC], CD2DBit --- # CD2DBitmap Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1Bitmap. ## Syntax diff --git a/docs/mfc/reference/cd2dbitmapbrush-class.md b/docs/mfc/reference/cd2dbitmapbrush-class.md index 7387755e260..cd4aa8f6312 100644 --- a/docs/mfc/reference/cd2dbitmapbrush-class.md +++ b/docs/mfc/reference/cd2dbitmapbrush-class.md @@ -4,10 +4,12 @@ title: "CD2DBitmapBrush Class" ms.date: "11/04/2016" f1_keywords: ["CD2DBitmapBrush", "AFXRENDERTARGET/CD2DBitmapBrush", "AFXRENDERTARGET/CD2DBitmapBrush::CD2DBitmapBrush", "AFXRENDERTARGET/CD2DBitmapBrush::Attach", "AFXRENDERTARGET/CD2DBitmapBrush::Create", "AFXRENDERTARGET/CD2DBitmapBrush::Destroy", "AFXRENDERTARGET/CD2DBitmapBrush::Detach", "AFXRENDERTARGET/CD2DBitmapBrush::Get", "AFXRENDERTARGET/CD2DBitmapBrush::GetBitmap", "AFXRENDERTARGET/CD2DBitmapBrush::GetExtendModeX", "AFXRENDERTARGET/CD2DBitmapBrush::GetExtendModeY", "AFXRENDERTARGET/CD2DBitmapBrush::GetInterpolationMode", "AFXRENDERTARGET/CD2DBitmapBrush::SetBitmap", "AFXRENDERTARGET/CD2DBitmapBrush::SetExtendModeX", "AFXRENDERTARGET/CD2DBitmapBrush::SetExtendModeY", "AFXRENDERTARGET/CD2DBitmapBrush::SetInterpolationMode", "AFXRENDERTARGET/CD2DBitmapBrush::CommonInit", "AFXRENDERTARGET/CD2DBitmapBrush::m_pBitmap", "AFXRENDERTARGET/CD2DBitmapBrush::m_pBitmapBrush", "AFXRENDERTARGET/CD2DBitmapBrush::m_pBitmapBrushProperties"] helpviewer_keywords: ["CD2DBitmapBrush [MFC], CD2DBitmapBrush", "CD2DBitmapBrush [MFC], Attach", "CD2DBitmapBrush [MFC], Create", "CD2DBitmapBrush [MFC], Destroy", "CD2DBitmapBrush [MFC], Detach", "CD2DBitmapBrush [MFC], Get", "CD2DBitmapBrush [MFC], GetBitmap", "CD2DBitmapBrush [MFC], GetExtendModeX", "CD2DBitmapBrush [MFC], GetExtendModeY", "CD2DBitmapBrush [MFC], GetInterpolationMode", "CD2DBitmapBrush [MFC], SetBitmap", "CD2DBitmapBrush [MFC], SetExtendModeX", "CD2DBitmapBrush [MFC], SetExtendModeY", "CD2DBitmapBrush [MFC], SetInterpolationMode", "CD2DBitmapBrush [MFC], CommonInit", "CD2DBitmapBrush [MFC], m_pBitmap", "CD2DBitmapBrush [MFC], m_pBitmapBrush", "CD2DBitmapBrush [MFC], m_pBitmapBrushProperties"] -ms.assetid: 46ebbe34-66e0-44c8-af1d-d129e851de5e --- # CD2DBitmapBrush Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1BitmapBrush. ## Syntax diff --git a/docs/mfc/reference/cd2dbrush-class.md b/docs/mfc/reference/cd2dbrush-class.md index 937159f7684..cc583fd9207 100644 --- a/docs/mfc/reference/cd2dbrush-class.md +++ b/docs/mfc/reference/cd2dbrush-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CD2DBrush [MFC], CD2DBrush", "CD2DBrush [MFC], Attach", " --- # `CD2DBrush` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for `ID2D1Brush`. ## Syntax diff --git a/docs/mfc/reference/cd2dbrushproperties-class.md b/docs/mfc/reference/cd2dbrushproperties-class.md index c28b4ec6722..527c0480618 100644 --- a/docs/mfc/reference/cd2dbrushproperties-class.md +++ b/docs/mfc/reference/cd2dbrushproperties-class.md @@ -4,10 +4,12 @@ title: "CD2DBrushProperties Class" ms.date: "11/04/2016" f1_keywords: ["CD2DBrushProperties", "AFXRENDERTARGET/CD2DBrushProperties", "AFXRENDERTARGET/CD2DBrushProperties::CD2DBrushProperties", "AFXRENDERTARGET/CD2DBrushProperties::CommonInit"] helpviewer_keywords: ["CD2DBrushProperties [MFC], CD2DBrushProperties", "CD2DBrushProperties [MFC], CommonInit"] -ms.assetid: c77d717f-0a16-4d74-b2ce-0ae1766ed6f9 --- # CD2DBrushProperties Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for `D2D1_BRUSH_PROPERTIES`. ## Syntax diff --git a/docs/mfc/reference/cd2dellipse-class.md b/docs/mfc/reference/cd2dellipse-class.md index dbe03207497..29caf8cb670 100644 --- a/docs/mfc/reference/cd2dellipse-class.md +++ b/docs/mfc/reference/cd2dellipse-class.md @@ -4,10 +4,12 @@ title: "CD2DEllipse Class" ms.date: "08/29/2019" f1_keywords: ["CD2DEllipse", "AFXRENDERTARGET/CD2DEllipse", "AFXRENDERTARGET/CD2DEllipse::CD2DEllipse"] helpviewer_keywords: ["CD2DEllipse [MFC], CD2DEllipse"] -ms.assetid: e9f02f54-acf2-427e-b349-db50cd9a77df --- # CD2DEllipse Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for `D2D1_ELLIPSE`. ## Syntax diff --git a/docs/mfc/reference/cd2dgeometry-class.md b/docs/mfc/reference/cd2dgeometry-class.md index e15757a9764..30b66e593e1 100644 --- a/docs/mfc/reference/cd2dgeometry-class.md +++ b/docs/mfc/reference/cd2dgeometry-class.md @@ -4,10 +4,12 @@ title: "CD2DGeometry Class" ms.date: "11/04/2016" f1_keywords: ["CD2DGeometry", "AFXRENDERTARGET/CD2DGeometry", "AFXRENDERTARGET/CD2DGeometry::CD2DGeometry", "AFXRENDERTARGET/CD2DGeometry::Attach", "AFXRENDERTARGET/CD2DGeometry::CombineWithGeometry", "AFXRENDERTARGET/CD2DGeometry::CompareWithGeometry", "AFXRENDERTARGET/CD2DGeometry::ComputeArea", "AFXRENDERTARGET/CD2DGeometry::ComputeLength", "AFXRENDERTARGET/CD2DGeometry::ComputePointAtLength", "AFXRENDERTARGET/CD2DGeometry::Destroy", "AFXRENDERTARGET/CD2DGeometry::Detach", "AFXRENDERTARGET/CD2DGeometry::FillContainsPoint", "AFXRENDERTARGET/CD2DGeometry::Get", "AFXRENDERTARGET/CD2DGeometry::GetBounds", "AFXRENDERTARGET/CD2DGeometry::GetWidenedBounds", "AFXRENDERTARGET/CD2DGeometry::IsValid", "AFXRENDERTARGET/CD2DGeometry::Outline", "AFXRENDERTARGET/CD2DGeometry::Simplify", "AFXRENDERTARGET/CD2DGeometry::StrokeContainsPoint", "AFXRENDERTARGET/CD2DGeometry::Tessellate", "AFXRENDERTARGET/CD2DGeometry::Widen", "AFXRENDERTARGET/CD2DGeometry::m_pGeometry"] helpviewer_keywords: ["CD2DGeometry [MFC], CD2DGeometry", "CD2DGeometry [MFC], Attach", "CD2DGeometry [MFC], CombineWithGeometry", "CD2DGeometry [MFC], CompareWithGeometry", "CD2DGeometry [MFC], ComputeArea", "CD2DGeometry [MFC], ComputeLength", "CD2DGeometry [MFC], ComputePointAtLength", "CD2DGeometry [MFC], Destroy", "CD2DGeometry [MFC], Detach", "CD2DGeometry [MFC], FillContainsPoint", "CD2DGeometry [MFC], Get", "CD2DGeometry [MFC], GetBounds", "CD2DGeometry [MFC], GetWidenedBounds", "CD2DGeometry [MFC], IsValid", "CD2DGeometry [MFC], Outline", "CD2DGeometry [MFC], Simplify", "CD2DGeometry [MFC], StrokeContainsPoint", "CD2DGeometry [MFC], Tessellate", "CD2DGeometry [MFC], Widen", "CD2DGeometry [MFC], m_pGeometry"] -ms.assetid: 3f95054b-fdb8-4e87-87f2-9fc3df7279ec --- # CD2DGeometry Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1Geometry. ## Syntax diff --git a/docs/mfc/reference/cd2dgeometrysink-class.md b/docs/mfc/reference/cd2dgeometrysink-class.md index ca50d6fef2a..f48b0a0569e 100644 --- a/docs/mfc/reference/cd2dgeometrysink-class.md +++ b/docs/mfc/reference/cd2dgeometrysink-class.md @@ -4,10 +4,12 @@ title: "CD2DGeometrySink Class" ms.date: "11/04/2016" f1_keywords: ["CD2DGeometrySink", "AFXRENDERTARGET/CD2DGeometrySink", "AFXRENDERTARGET/CD2DGeometrySink::CD2DGeometrySink", "AFXRENDERTARGET/CD2DGeometrySink::AddArc", "AFXRENDERTARGET/CD2DGeometrySink::AddBezier", "AFXRENDERTARGET/CD2DGeometrySink::AddBeziers", "AFXRENDERTARGET/CD2DGeometrySink::AddLine", "AFXRENDERTARGET/CD2DGeometrySink::AddLines", "AFXRENDERTARGET/CD2DGeometrySink::AddQuadraticBezier", "AFXRENDERTARGET/CD2DGeometrySink::AddQuadraticBeziers", "AFXRENDERTARGET/CD2DGeometrySink::BeginFigure", "AFXRENDERTARGET/CD2DGeometrySink::Close", "AFXRENDERTARGET/CD2DGeometrySink::EndFigure", "AFXRENDERTARGET/CD2DGeometrySink::Get", "AFXRENDERTARGET/CD2DGeometrySink::IsValid", "AFXRENDERTARGET/CD2DGeometrySink::SetFillMode", "AFXRENDERTARGET/CD2DGeometrySink::SetSegmentFlags", "AFXRENDERTARGET/CD2DGeometrySink::m_pSink"] helpviewer_keywords: ["CD2DGeometrySink [MFC], CD2DGeometrySink", "CD2DGeometrySink [MFC], AddArc", "CD2DGeometrySink [MFC], AddBezier", "CD2DGeometrySink [MFC], AddBeziers", "CD2DGeometrySink [MFC], AddLine", "CD2DGeometrySink [MFC], AddLines", "CD2DGeometrySink [MFC], AddQuadraticBezier", "CD2DGeometrySink [MFC], AddQuadraticBeziers", "CD2DGeometrySink [MFC], BeginFigure", "CD2DGeometrySink [MFC], Close", "CD2DGeometrySink [MFC], EndFigure", "CD2DGeometrySink [MFC], Get", "CD2DGeometrySink [MFC], IsValid", "CD2DGeometrySink [MFC], SetFillMode", "CD2DGeometrySink [MFC], SetSegmentFlags", "CD2DGeometrySink [MFC], m_pSink"] -ms.assetid: e5e07f41-0343-4ab1-9d6b-8c62ed33c04a --- # CD2DGeometrySink Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1GeometrySink. ## Syntax diff --git a/docs/mfc/reference/cd2dgradientbrush-class.md b/docs/mfc/reference/cd2dgradientbrush-class.md index f6611d222e0..b5c69b59e7e 100644 --- a/docs/mfc/reference/cd2dgradientbrush-class.md +++ b/docs/mfc/reference/cd2dgradientbrush-class.md @@ -4,10 +4,12 @@ title: "CD2DGradientBrush Class" ms.date: "03/27/2019" f1_keywords: ["CD2DGradientBrush", "AFXRENDERTARGET/CD2DGradientBrush", "AFXRENDERTARGET/CD2DGradientBrush::CD2DGradientBrush", "AFXRENDERTARGET/CD2DGradientBrush::Destroy", "AFXRENDERTARGET/CD2DGradientBrush::m_arGradientStops", "AFXRENDERTARGET/CD2DGradientBrush::m_colorInterpolationGamma", "AFXRENDERTARGET/CD2DGradientBrush::m_extendMode", "AFXRENDERTARGET/CD2DGradientBrush::m_pGradientStops"] helpviewer_keywords: ["CD2DGradientBrush [MFC], CD2DGradientBrush", "CD2DGradientBrush [MFC], Destroy", "CD2DGradientBrush [MFC], m_arGradientStops", "CD2DGradientBrush [MFC], m_colorInterpolationGamma", "CD2DGradientBrush [MFC], m_extendMode", "CD2DGradientBrush [MFC], m_pGradientStops"] -ms.assetid: 5bf133e6-16b7-4e3a-845d-0ce63fafe5ec --- # CD2DGradientBrush Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class of the CD2DLinearGradientBrush and the CD2DRadialGradientBrush classes. ## Syntax diff --git a/docs/mfc/reference/cd2dlayer-class.md b/docs/mfc/reference/cd2dlayer-class.md index 71d22b6df07..504d7151232 100644 --- a/docs/mfc/reference/cd2dlayer-class.md +++ b/docs/mfc/reference/cd2dlayer-class.md @@ -4,10 +4,12 @@ title: "CD2DLayer Class" ms.date: "11/04/2016" f1_keywords: ["CD2DLayer", "AFXRENDERTARGET/CD2DLayer", "AFXRENDERTARGET/CD2DLayer::CD2DLayer", "AFXRENDERTARGET/CD2DLayer::Attach", "AFXRENDERTARGET/CD2DLayer::Create", "AFXRENDERTARGET/CD2DLayer::Destroy", "AFXRENDERTARGET/CD2DLayer::Detach", "AFXRENDERTARGET/CD2DLayer::Get", "AFXRENDERTARGET/CD2DLayer::GetSize", "AFXRENDERTARGET/CD2DLayer::IsValid", "AFXRENDERTARGET/CD2DLayer::m_pLayer"] helpviewer_keywords: ["CD2DLayer [MFC], CD2DLayer", "CD2DLayer [MFC], Attach", "CD2DLayer [MFC], Create", "CD2DLayer [MFC], Destroy", "CD2DLayer [MFC], Detach", "CD2DLayer [MFC], Get", "CD2DLayer [MFC], GetSize", "CD2DLayer [MFC], IsValid", "CD2DLayer [MFC], m_pLayer"] -ms.assetid: 2f96378e-66bb-40d1-9661-6afe324de3c1 --- # CD2DLayer Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1Layer. ## Syntax diff --git a/docs/mfc/reference/cd2dlineargradientbrush-class.md b/docs/mfc/reference/cd2dlineargradientbrush-class.md index 70c1ca78877..dc008c90e2c 100644 --- a/docs/mfc/reference/cd2dlineargradientbrush-class.md +++ b/docs/mfc/reference/cd2dlineargradientbrush-class.md @@ -4,10 +4,12 @@ title: "CD2DLinearGradientBrush Class" ms.date: "11/04/2016" f1_keywords: ["CD2DLinearGradientBrush", "AFXRENDERTARGET/CD2DLinearGradientBrush", "AFXRENDERTARGET/CD2DLinearGradientBrush::CD2DLinearGradientBrush", "AFXRENDERTARGET/CD2DLinearGradientBrush::Attach", "AFXRENDERTARGET/CD2DLinearGradientBrush::Create", "AFXRENDERTARGET/CD2DLinearGradientBrush::Destroy", "AFXRENDERTARGET/CD2DLinearGradientBrush::Detach", "AFXRENDERTARGET/CD2DLinearGradientBrush::Get", "AFXRENDERTARGET/CD2DLinearGradientBrush::GetEndPoint", "AFXRENDERTARGET/CD2DLinearGradientBrush::GetStartPoint", "AFXRENDERTARGET/CD2DLinearGradientBrush::SetEndPoint", "AFXRENDERTARGET/CD2DLinearGradientBrush::SetStartPoint", "AFXRENDERTARGET/CD2DLinearGradientBrush::m_LinearGradientBrushProperties", "AFXRENDERTARGET/CD2DLinearGradientBrush::m_pLinearGradientBrush"] helpviewer_keywords: ["CD2DLinearGradientBrush [MFC], CD2DLinearGradientBrush", "CD2DLinearGradientBrush [MFC], Attach", "CD2DLinearGradientBrush [MFC], Create", "CD2DLinearGradientBrush [MFC], Destroy", "CD2DLinearGradientBrush [MFC], Detach", "CD2DLinearGradientBrush [MFC], Get", "CD2DLinearGradientBrush [MFC], GetEndPoint", "CD2DLinearGradientBrush [MFC], GetStartPoint", "CD2DLinearGradientBrush [MFC], SetEndPoint", "CD2DLinearGradientBrush [MFC], SetStartPoint", "CD2DLinearGradientBrush [MFC], m_LinearGradientBrushProperties", "CD2DLinearGradientBrush [MFC], m_pLinearGradientBrush"] -ms.assetid: d4be9ff9-0ea8-45e6-9b8d-f3bc5673cbac --- # CD2DLinearGradientBrush Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1LinearGradientBrush. ## Syntax diff --git a/docs/mfc/reference/cd2dmesh-class.md b/docs/mfc/reference/cd2dmesh-class.md index 1c00d6b8ab2..7b769ec7df4 100644 --- a/docs/mfc/reference/cd2dmesh-class.md +++ b/docs/mfc/reference/cd2dmesh-class.md @@ -4,10 +4,12 @@ title: "CD2DMesh Class" ms.date: "11/04/2016" f1_keywords: ["CD2DMesh", "AFXRENDERTARGET/CD2DMesh", "AFXRENDERTARGET/CD2DMesh::CD2DMesh", "AFXRENDERTARGET/CD2DMesh::Attach", "AFXRENDERTARGET/CD2DMesh::Create", "AFXRENDERTARGET/CD2DMesh::Destroy", "AFXRENDERTARGET/CD2DMesh::Detach", "AFXRENDERTARGET/CD2DMesh::Get", "AFXRENDERTARGET/CD2DMesh::IsValid", "AFXRENDERTARGET/CD2DMesh::Open", "AFXRENDERTARGET/CD2DMesh::m_pMesh"] helpviewer_keywords: ["CD2DMesh [MFC], CD2DMesh", "CD2DMesh [MFC], Attach", "CD2DMesh [MFC], Create", "CD2DMesh [MFC], Destroy", "CD2DMesh [MFC], Detach", "CD2DMesh [MFC], Get", "CD2DMesh [MFC], IsValid", "CD2DMesh [MFC], Open", "CD2DMesh [MFC], m_pMesh"] -ms.assetid: 11a2c78a-1367-40e8-a34f-44aa0509a4c9 --- # CD2DMesh Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1Mesh. ## Syntax diff --git a/docs/mfc/reference/cd2dpathgeometry-class.md b/docs/mfc/reference/cd2dpathgeometry-class.md index c8a92594575..5b7fd0c32a3 100644 --- a/docs/mfc/reference/cd2dpathgeometry-class.md +++ b/docs/mfc/reference/cd2dpathgeometry-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CD2DPathGeometry [MFC], CD2DPathGeometry", "CD2DPathGeome --- # CD2DPathGeometry Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1PathGeometry. ## Syntax diff --git a/docs/mfc/reference/cd2dpointf-class.md b/docs/mfc/reference/cd2dpointf-class.md index da1e32fae53..be72cbd1f06 100644 --- a/docs/mfc/reference/cd2dpointf-class.md +++ b/docs/mfc/reference/cd2dpointf-class.md @@ -4,10 +4,12 @@ title: "CD2DPointF Class" ms.date: "11/04/2016" f1_keywords: ["CD2DPointF", "AFXRENDERTARGET/CD2DPointF", "AFXRENDERTARGET/CD2DPointF::CD2DPointF"] helpviewer_keywords: ["CD2DPointF [MFC], CD2DPointF"] -ms.assetid: 30f72083-1c8a-4f50-adb2-72dbbe3522d4 --- # CD2DPointF Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for `D2D1_POINT_2F`. ## Syntax diff --git a/docs/mfc/reference/cd2dpointu-class.md b/docs/mfc/reference/cd2dpointu-class.md index a7496417187..40d1d16f15e 100644 --- a/docs/mfc/reference/cd2dpointu-class.md +++ b/docs/mfc/reference/cd2dpointu-class.md @@ -4,10 +4,12 @@ title: "CD2DPointU Class" ms.date: "08/29/2019" f1_keywords: ["CD2DPointU", "AFXRENDERTARGET/CD2DPointU", "AFXRENDERTARGET/CD2DPointU::CD2DPointU"] helpviewer_keywords: ["CD2DPointU [MFC], CD2DPointU"] -ms.assetid: 04733f96-b6de-4a89-82e3-caad1e8087a9 --- # CD2DPointU Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for `D2D1_POINT_2U`. ## Syntax diff --git a/docs/mfc/reference/cd2dradialgradientbrush-class.md b/docs/mfc/reference/cd2dradialgradientbrush-class.md index 6bedb70852f..3cd841c1f05 100644 --- a/docs/mfc/reference/cd2dradialgradientbrush-class.md +++ b/docs/mfc/reference/cd2dradialgradientbrush-class.md @@ -4,10 +4,12 @@ title: "CD2DRadialGradientBrush Class" ms.date: "11/04/2016" f1_keywords: ["CD2DRadialGradientBrush", "AFXRENDERTARGET/CD2DRadialGradientBrush", "AFXRENDERTARGET/CD2DRadialGradientBrush::CD2DRadialGradientBrush", "AFXRENDERTARGET/CD2DRadialGradientBrush::Attach", "AFXRENDERTARGET/CD2DRadialGradientBrush::Create", "AFXRENDERTARGET/CD2DRadialGradientBrush::Destroy", "AFXRENDERTARGET/CD2DRadialGradientBrush::Detach", "AFXRENDERTARGET/CD2DRadialGradientBrush::Get", "AFXRENDERTARGET/CD2DRadialGradientBrush::GetCenter", "AFXRENDERTARGET/CD2DRadialGradientBrush::GetGradientOriginOffset", "AFXRENDERTARGET/CD2DRadialGradientBrush::GetRadiusX", "AFXRENDERTARGET/CD2DRadialGradientBrush::GetRadiusY", "AFXRENDERTARGET/CD2DRadialGradientBrush::SetCenter", "AFXRENDERTARGET/CD2DRadialGradientBrush::SetGradientOriginOffset", "AFXRENDERTARGET/CD2DRadialGradientBrush::SetRadiusX", "AFXRENDERTARGET/CD2DRadialGradientBrush::SetRadiusY", "AFXRENDERTARGET/CD2DRadialGradientBrush::m_pRadialGradientBrush", "AFXRENDERTARGET/CD2DRadialGradientBrush::m_RadialGradientBrushProperties"] helpviewer_keywords: ["CD2DRadialGradientBrush [MFC], CD2DRadialGradientBrush", "CD2DRadialGradientBrush [MFC], Attach", "CD2DRadialGradientBrush [MFC], Create", "CD2DRadialGradientBrush [MFC], Destroy", "CD2DRadialGradientBrush [MFC], Detach", "CD2DRadialGradientBrush [MFC], Get", "CD2DRadialGradientBrush [MFC], GetCenter", "CD2DRadialGradientBrush [MFC], GetGradientOriginOffset", "CD2DRadialGradientBrush [MFC], GetRadiusX", "CD2DRadialGradientBrush [MFC], GetRadiusY", "CD2DRadialGradientBrush [MFC], SetCenter", "CD2DRadialGradientBrush [MFC], SetGradientOriginOffset", "CD2DRadialGradientBrush [MFC], SetRadiusX", "CD2DRadialGradientBrush [MFC], SetRadiusY", "CD2DRadialGradientBrush [MFC], m_pRadialGradientBrush", "CD2DRadialGradientBrush [MFC], m_RadialGradientBrushProperties"] -ms.assetid: 6c76d84a-d831-4ee2-96f1-82c1f5b0d6a9 --- # CD2DRadialGradientBrush Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1RadialGradientBrush. ## Syntax diff --git a/docs/mfc/reference/cd2drectf-class.md b/docs/mfc/reference/cd2drectf-class.md index 967b8fb9227..9f04d36e4ed 100644 --- a/docs/mfc/reference/cd2drectf-class.md +++ b/docs/mfc/reference/cd2drectf-class.md @@ -4,10 +4,12 @@ title: "CD2DRectF Class" ms.date: "11/04/2016" f1_keywords: ["CD2DRectF", "AFXRENDERTARGET/CD2DRectF", "AFXRENDERTARGET/CD2DRectF::CD2DRectF", "AFXRENDERTARGET/CD2DRectF::IsNull"] helpviewer_keywords: ["CD2DRectF [MFC], CD2DRectF", "CD2DRectF [MFC], IsNull"] -ms.assetid: 87c12d87-9d18-4a19-ba14-0f51d6b6835a --- # CD2DRectF Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for `D2D1_RECT_F`. ## Syntax diff --git a/docs/mfc/reference/cd2drectu-class.md b/docs/mfc/reference/cd2drectu-class.md index 2e49d1489ae..a88732c9fb7 100644 --- a/docs/mfc/reference/cd2drectu-class.md +++ b/docs/mfc/reference/cd2drectu-class.md @@ -4,10 +4,12 @@ title: "CD2DRectU Class" ms.date: "11/04/2016" f1_keywords: ["CD2DRectU", "AFXRENDERTARGET/CD2DRectU", "AFXRENDERTARGET/CD2DRectU::CD2DRectU", "AFXRENDERTARGET/CD2DRectU::IsNull"] helpviewer_keywords: ["CD2DRectU [MFC], CD2DRectU", "CD2DRectU [MFC], IsNull"] -ms.assetid: a62f17d1-011d-4867-8f51-fd7e7c00561d --- # CD2DRectU Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for `D2D1_RECT_U`. ## Syntax From b94fcbbd25400241b0bc6006e695d7014275787e Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 20 Feb 2026 13:16:06 -0800 Subject: [PATCH 1640/1799] Batch 6: update files (#6251) --- docs/mfc/reference/cd2dresource-class.md | 4 +++- docs/mfc/reference/cd2droundedrect-class.md | 4 +++- docs/mfc/reference/cd2dsizef-class.md | 4 +++- docs/mfc/reference/cd2dsizeu-class.md | 4 +++- docs/mfc/reference/cd2dsolidcolorbrush-class.md | 4 +++- docs/mfc/reference/cd2dtextformat-class.md | 4 +++- docs/mfc/reference/cd2dtextlayout-class.md | 4 +++- docs/mfc/reference/cdaodatabase-class.md | 3 +++ docs/mfc/reference/cdaodatabaseinfo-structure.md | 3 +++ docs/mfc/reference/cdaoerrorinfo-structure.md | 3 +++ docs/mfc/reference/cdaoexception-class.md | 3 +++ docs/mfc/reference/cdaofieldexchange-class.md | 3 +++ docs/mfc/reference/cdaofieldinfo-structure.md | 3 +++ docs/mfc/reference/cdaoindexfieldinfo-structure.md | 3 +++ docs/mfc/reference/cdaoindexinfo-structure.md | 3 +++ docs/mfc/reference/cdaoparameterinfo-structure.md | 3 +++ docs/mfc/reference/cdaoquerydef-class.md | 3 +++ docs/mfc/reference/cdaoquerydefinfo-structure.md | 3 +++ docs/mfc/reference/cdaorecordset-class.md | 3 +++ docs/mfc/reference/cdaorecordview-class.md | 3 +++ docs/mfc/reference/cdaorelationfieldinfo-structure.md | 3 +++ docs/mfc/reference/cdaorelationinfo-structure.md | 3 +++ docs/mfc/reference/cdaotabledef-class.md | 3 +++ docs/mfc/reference/cdaotabledefinfo-structure.md | 3 +++ docs/mfc/reference/cdaoworkspace-class.md | 3 +++ docs/mfc/reference/cdaoworkspaceinfo-structure.md | 3 +++ docs/mfc/reference/cdatabase-class.md | 3 +++ docs/mfc/reference/cdataexchange-class.md | 4 +++- docs/mfc/reference/cdatapathproperty-class.md | 4 +++- docs/mfc/reference/cdatarecoveryhandler-class.md | 4 +++- docs/mfc/reference/cdatetimectrl-class.md | 3 +++ docs/mfc/reference/cdbexception-class.md | 4 +++- docs/mfc/reference/cdbvariant-class.md | 4 +++- docs/mfc/reference/cdc-class.md | 3 +++ docs/mfc/reference/cdcrendertarget-class.md | 3 +++ docs/mfc/reference/cdhtmldialog-class.md | 3 +++ docs/mfc/reference/cdialog-class.md | 3 +++ docs/mfc/reference/cdialogbar-class.md | 4 +++- docs/mfc/reference/cdialogex-class.md | 3 +++ docs/mfc/reference/cdiscretetransition-class.md | 4 +++- docs/mfc/reference/cdocitem-class.md | 4 +++- docs/mfc/reference/cdockablepane-class.md | 3 +++ docs/mfc/reference/cdockablepaneadapter-class.md | 4 +++- docs/mfc/reference/cdockingmanager-class.md | 4 +++- docs/mfc/reference/cdockingpanesrow-class.md | 4 +++- docs/mfc/reference/cdocksite-class.md | 4 +++- docs/mfc/reference/cdockstate-class.md | 4 +++- docs/mfc/reference/cdocobjectserver-class.md | 3 +++ docs/mfc/reference/cdocobjectserveritem-class.md | 4 +++- docs/mfc/reference/cdoctemplate-class.md | 3 +++ docs/mfc/reference/cdocument-class.md | 4 +++- docs/mfc/reference/cdraglistbox-class.md | 4 +++- docs/mfc/reference/cdrawingmanager-class.md | 4 +++- docs/mfc/reference/cdumpcontext-class.md | 4 +++- docs/mfc/reference/cdwordarray-class.md | 4 +++- docs/mfc/reference/cedit-class.md | 4 +++- docs/mfc/reference/ceditview-class.md | 3 +++ docs/mfc/reference/cevent-class.md | 3 +++ docs/mfc/reference/cexception-class.md | 3 +++ docs/mfc/reference/cfieldexchange-class.md | 4 +++- docs/mfc/reference/cfile-class.md | 3 +++ docs/mfc/reference/cfiledialog-class.md | 4 +++- docs/mfc/reference/cfileexception-class.md | 3 +++ docs/mfc/reference/cfilefind-class.md | 4 +++- docs/mfc/reference/cfindreplacedialog-class.md | 3 +++ docs/mfc/reference/cfolderpickerdialog-class.md | 3 +++ docs/mfc/reference/cfont-class.md | 3 +++ docs/mfc/reference/cfontdialog-class.md | 4 +++- docs/mfc/reference/cfontholder-class.md | 4 +++- docs/mfc/reference/cformview-class.md | 3 +++ docs/mfc/reference/cframewnd-class.md | 3 +++ docs/mfc/reference/cframewndex-class.md | 3 +++ docs/mfc/reference/cftpconnection-class.md | 4 +++- docs/mfc/reference/cftpfilefind-class.md | 4 +++- docs/mfc/reference/cgdiobject-class.md | 4 +++- docs/mfc/reference/cglobalutils-class.md | 4 +++- docs/mfc/reference/cgopherconnection-class.md | 3 +++ docs/mfc/reference/cgopherfile-class.md | 4 +++- docs/mfc/reference/cgopherfilefind-class.md | 4 +++- docs/mfc/reference/cgopherlocator-class.md | 4 +++- docs/mfc/reference/cheaderctrl-class.md | 4 +++- .../reference/child-window-notification-message-handlers.md | 4 +++- docs/mfc/reference/chotkeyctrl-class.md | 4 +++- docs/mfc/reference/chtmleditctrl-class.md | 4 +++- docs/mfc/reference/chtmleditctrlbase-class.md | 4 +++- docs/mfc/reference/chtmleditdoc-class.md | 4 +++- docs/mfc/reference/chtmleditview-class.md | 4 +++- docs/mfc/reference/chtmlview-class.md | 3 +++ docs/mfc/reference/chttpconnection-class.md | 4 +++- docs/mfc/reference/chttpfile-class.md | 4 +++- docs/mfc/reference/chwndrendertarget-class.md | 4 +++- docs/mfc/reference/cimagelist-class.md | 3 +++ docs/mfc/reference/cinstantaneoustransition-class.md | 4 +++- docs/mfc/reference/cinternetconnection-class.md | 4 +++- docs/mfc/reference/cinternetexception-class.md | 4 +++- docs/mfc/reference/cinternetfile-class.md | 4 +++- docs/mfc/reference/cinternetsession-class.md | 3 +++ docs/mfc/reference/cinterpolatorbase-class.md | 4 +++- docs/mfc/reference/cinvalidargexception-class.md | 4 +++- docs/mfc/reference/cipaddressctrl-class.md | 4 +++- 100 files changed, 300 insertions(+), 56 deletions(-) diff --git a/docs/mfc/reference/cd2dresource-class.md b/docs/mfc/reference/cd2dresource-class.md index fa6c42d756a..d4e355f07f3 100644 --- a/docs/mfc/reference/cd2dresource-class.md +++ b/docs/mfc/reference/cd2dresource-class.md @@ -4,10 +4,12 @@ title: "CD2DResource Class" ms.date: "03/27/2019" f1_keywords: ["CD2DResource", "AFXRENDERTARGET/CD2DResource", "AFXRENDERTARGET/CD2DResource::CD2DResource", "AFXRENDERTARGET/CD2DResource::Create", "AFXRENDERTARGET/CD2DResource::Destroy", "AFXRENDERTARGET/CD2DResource::IsValid", "AFXRENDERTARGET/CD2DResource::IsAutoDestroy", "AFXRENDERTARGET/CD2DResource::ReCreate", "AFXRENDERTARGET/CD2DResource::m_bIsAutoDestroy", "AFXRENDERTARGET/CD2DResource::m_pParentTarget"] helpviewer_keywords: ["CD2DResource [MFC], CD2DResource", "CD2DResource [MFC], Create", "CD2DResource [MFC], Destroy", "CD2DResource [MFC], IsValid", "CD2DResource [MFC], IsAutoDestroy", "CD2DResource [MFC], ReCreate", "CD2DResource [MFC], m_bIsAutoDestroy", "CD2DResource [MFC], m_pParentTarget"] -ms.assetid: 34e3ee18-aab6-4c39-9294-de869e1f7820 --- # CD2DResource Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An abstract class that provides an interface for creating and managing D2D resources such as brushes, layers, and texts. ## Syntax diff --git a/docs/mfc/reference/cd2droundedrect-class.md b/docs/mfc/reference/cd2droundedrect-class.md index fc3e784f5ef..e93423f089c 100644 --- a/docs/mfc/reference/cd2droundedrect-class.md +++ b/docs/mfc/reference/cd2droundedrect-class.md @@ -4,10 +4,12 @@ title: "CD2DRoundedRect Class" ms.date: "11/04/2016" f1_keywords: ["CD2DRoundedRect", "AFXRENDERTARGET/CD2DRoundedRect", "AFXRENDERTARGET/CD2DRoundedRect::CD2DRoundedRect"] helpviewer_keywords: ["CD2DRoundedRect [MFC], CD2DRoundedRect"] -ms.assetid: 06207fb5-e92b-41c0-bceb-b45d8f466531 --- # CD2DRoundedRect Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for `D2D1_ROUNDED_RECT`. ## Syntax diff --git a/docs/mfc/reference/cd2dsizef-class.md b/docs/mfc/reference/cd2dsizef-class.md index 5b1d39d894a..a4458cedd76 100644 --- a/docs/mfc/reference/cd2dsizef-class.md +++ b/docs/mfc/reference/cd2dsizef-class.md @@ -4,10 +4,12 @@ title: "CD2DSizeF Class" ms.date: "08/29/2019" f1_keywords: ["CD2DSizeF", "AFXRENDERTARGET/CD2DSizeF", "AFXRENDERTARGET/CD2DSizeF::CD2DSizeF", "AFXRENDERTARGET/CD2DSizeF::IsNull"] helpviewer_keywords: ["CD2DSizeF [MFC], CD2DSizeF", "CD2DSizeF [MFC], IsNull"] -ms.assetid: f486a1e1-997d-4286-8cb9-26369dc82055 --- # CD2DSizeF Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for D2D1_SIZE_F. ## Syntax diff --git a/docs/mfc/reference/cd2dsizeu-class.md b/docs/mfc/reference/cd2dsizeu-class.md index 464d7d1b622..819e251ae7b 100644 --- a/docs/mfc/reference/cd2dsizeu-class.md +++ b/docs/mfc/reference/cd2dsizeu-class.md @@ -4,10 +4,12 @@ title: "CD2DSizeU Class" ms.date: "08/29/2019" f1_keywords: ["CD2DSizeU", "AFXRENDERTARGET/CD2DSizeU", "AFXRENDERTARGET/CD2DSizeU::CD2DSizeU", "AFXRENDERTARGET/CD2DSizeU::IsNull"] helpviewer_keywords: ["CD2DSizeU [MFC], CD2DSizeU", "CD2DSizeU [MFC], IsNull"] -ms.assetid: 6e679ba8-2112-43c3-8275-70b660856f02 --- # CD2DSizeU Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for D2D1_SIZE_U. ## Syntax diff --git a/docs/mfc/reference/cd2dsolidcolorbrush-class.md b/docs/mfc/reference/cd2dsolidcolorbrush-class.md index 177c2fc3fef..c343346e6a8 100644 --- a/docs/mfc/reference/cd2dsolidcolorbrush-class.md +++ b/docs/mfc/reference/cd2dsolidcolorbrush-class.md @@ -4,10 +4,12 @@ title: "CD2DSolidColorBrush Class" ms.date: "03/27/2019" f1_keywords: ["CD2DSolidColorBrush", "AFXRENDERTARGET/CD2DSolidColorBrush", "AFXRENDERTARGET/CD2DSolidColorBrush::CD2DSolidColorBrush", "AFXRENDERTARGET/CD2DSolidColorBrush::Attach", "AFXRENDERTARGET/CD2DSolidColorBrush::Create", "AFXRENDERTARGET/CD2DSolidColorBrush::Destroy", "AFXRENDERTARGET/CD2DSolidColorBrush::Detach", "AFXRENDERTARGET/CD2DSolidColorBrush::Get", "AFXRENDERTARGET/CD2DSolidColorBrush::GetColor", "AFXRENDERTARGET/CD2DSolidColorBrush::SetColor", "AFXRENDERTARGET/CD2DSolidColorBrush::m_colorSolid", "AFXRENDERTARGET/CD2DSolidColorBrush::m_pSolidColorBrush"] helpviewer_keywords: ["CD2DSolidColorBrush [MFC], CD2DSolidColorBrush", "CD2DSolidColorBrush [MFC], Attach", "CD2DSolidColorBrush [MFC], Create", "CD2DSolidColorBrush [MFC], Destroy", "CD2DSolidColorBrush [MFC], Detach", "CD2DSolidColorBrush [MFC], Get", "CD2DSolidColorBrush [MFC], GetColor", "CD2DSolidColorBrush [MFC], SetColor", "CD2DSolidColorBrush [MFC], m_colorSolid", "CD2DSolidColorBrush [MFC], m_pSolidColorBrush"] -ms.assetid: d4506637-acce-4f74-8a9b-f0a45571a735 --- # CD2DSolidColorBrush Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1SolidColorBrush. ## Syntax diff --git a/docs/mfc/reference/cd2dtextformat-class.md b/docs/mfc/reference/cd2dtextformat-class.md index 258818a08a6..94bffc9c182 100644 --- a/docs/mfc/reference/cd2dtextformat-class.md +++ b/docs/mfc/reference/cd2dtextformat-class.md @@ -4,10 +4,12 @@ title: "CD2DTextFormat Class" ms.date: "03/27/2019" f1_keywords: ["CD2DTextFormat", "AFXRENDERTARGET/CD2DTextFormat", "AFXRENDERTARGET/CD2DTextFormat::CD2DTextFormat", "AFXRENDERTARGET/CD2DTextFormat::Create", "AFXRENDERTARGET/CD2DTextFormat::Destroy", "AFXRENDERTARGET/CD2DTextFormat::Get", "AFXRENDERTARGET/CD2DTextFormat::GetFontFamilyName", "AFXRENDERTARGET/CD2DTextFormat::GetLocaleName", "AFXRENDERTARGET/CD2DTextFormat::IsValid", "AFXRENDERTARGET/CD2DTextFormat::ReCreate", "AFXRENDERTARGET/CD2DTextFormat::m_pTextFormat"] helpviewer_keywords: ["CD2DTextFormat [MFC], CD2DTextFormat", "CD2DTextFormat [MFC], Create", "CD2DTextFormat [MFC], Destroy", "CD2DTextFormat [MFC], Get", "CD2DTextFormat [MFC], GetFontFamilyName", "CD2DTextFormat [MFC], GetLocaleName", "CD2DTextFormat [MFC], IsValid", "CD2DTextFormat [MFC], ReCreate", "CD2DTextFormat [MFC], m_pTextFormat"] -ms.assetid: db194cec-9dae-4644-ab84-7c43b7164117 --- # CD2DTextFormat Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for IDWriteTextFormat. ## Syntax diff --git a/docs/mfc/reference/cd2dtextlayout-class.md b/docs/mfc/reference/cd2dtextlayout-class.md index 02fe965fb31..574552a8d41 100644 --- a/docs/mfc/reference/cd2dtextlayout-class.md +++ b/docs/mfc/reference/cd2dtextlayout-class.md @@ -4,10 +4,12 @@ title: "CD2DTextLayout Class" ms.date: "03/27/2019" f1_keywords: ["CD2DTextLayout", "AFXRENDERTARGET/CD2DTextLayout", "AFXRENDERTARGET/CD2DTextLayout::CD2DTextLayout", "AFXRENDERTARGET/CD2DTextLayout::Create", "AFXRENDERTARGET/CD2DTextLayout::Destroy", "AFXRENDERTARGET/CD2DTextLayout::Get", "AFXRENDERTARGET/CD2DTextLayout::GetFontFamilyName", "AFXRENDERTARGET/CD2DTextLayout::GetLocaleName", "AFXRENDERTARGET/CD2DTextLayout::IsValid", "AFXRENDERTARGET/CD2DTextLayout::ReCreate", "AFXRENDERTARGET/CD2DTextLayout::SetFontFamilyName", "AFXRENDERTARGET/CD2DTextLayout::SetLocaleName", "AFXRENDERTARGET/CD2DTextLayout::m_pTextLayout"] helpviewer_keywords: ["CD2DTextLayout [MFC], CD2DTextLayout", "CD2DTextLayout [MFC], Create", "CD2DTextLayout [MFC], Destroy", "CD2DTextLayout [MFC], Get", "CD2DTextLayout [MFC], GetFontFamilyName", "CD2DTextLayout [MFC], GetLocaleName", "CD2DTextLayout [MFC], IsValid", "CD2DTextLayout [MFC], ReCreate", "CD2DTextLayout [MFC], SetFontFamilyName", "CD2DTextLayout [MFC], SetLocaleName", "CD2DTextLayout [MFC], m_pTextLayout"] -ms.assetid: 724bd13c-f2ef-4e55-a775-8cb04b7b7908 --- # CD2DTextLayout Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for IDWriteTextLayout. ## Syntax diff --git a/docs/mfc/reference/cdaodatabase-class.md b/docs/mfc/reference/cdaodatabase-class.md index f1b5b85af32..817e7f6ea26 100644 --- a/docs/mfc/reference/cdaodatabase-class.md +++ b/docs/mfc/reference/cdaodatabase-class.md @@ -8,6 +8,9 @@ ms.custom: sfi-ropc-nochange --- # CDaoDatabase Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a connection to an Access database using Data Access Objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaodatabaseinfo-structure.md b/docs/mfc/reference/cdaodatabaseinfo-structure.md index 24d774536be..e01c08c24f7 100644 --- a/docs/mfc/reference/cdaodatabaseinfo-structure.md +++ b/docs/mfc/reference/cdaodatabaseinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoDatabaseInfo structure [MFC]", "DAO (Data Access Obje --- # CDaoDatabaseInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoDatabaseInfo` structure contains information about a database object defined for data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaoerrorinfo-structure.md b/docs/mfc/reference/cdaoerrorinfo-structure.md index 0848f939efa..4e34fad326c 100644 --- a/docs/mfc/reference/cdaoerrorinfo-structure.md +++ b/docs/mfc/reference/cdaoerrorinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoErrorInfo structure [MFC]", "DAO (Data Access Objects --- # CDaoErrorInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoErrorInfo` structure contains information about an error object defined for data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaoexception-class.md b/docs/mfc/reference/cdaoexception-class.md index 7092121b13f..d0d03730f6b 100644 --- a/docs/mfc/reference/cdaoexception-class.md +++ b/docs/mfc/reference/cdaoexception-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoException [MFC], CDaoException", "CDaoException [MFC] --- # CDaoException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an exception condition arising from the MFC database classes based on data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaofieldexchange-class.md b/docs/mfc/reference/cdaofieldexchange-class.md index 47e1f63124f..af11986eaa1 100644 --- a/docs/mfc/reference/cdaofieldexchange-class.md +++ b/docs/mfc/reference/cdaofieldexchange-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoFieldExchange [MFC], IsValidOperation", "CDaoFieldExc --- # CDaoFieldExchange Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports the DAO record field exchange (DFX) routines used by the DAO database classes. > [!NOTE] diff --git a/docs/mfc/reference/cdaofieldinfo-structure.md b/docs/mfc/reference/cdaofieldinfo-structure.md index 1935ec2f72b..6db2749e23d 100644 --- a/docs/mfc/reference/cdaofieldinfo-structure.md +++ b/docs/mfc/reference/cdaofieldinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["DAO (Data Access Objects), Fields collection", "CDaoField --- # CDaoFieldInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoFieldInfo` structure contains information about a field object defined for data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaoindexfieldinfo-structure.md b/docs/mfc/reference/cdaoindexfieldinfo-structure.md index c75e91b5865..b7b20cca2d7 100644 --- a/docs/mfc/reference/cdaoindexfieldinfo-structure.md +++ b/docs/mfc/reference/cdaoindexfieldinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoIndexFieldInfo structure [MFC]", "DAO (Data Access Ob --- # CDaoIndexFieldInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoIndexFieldInfo` structure contains information about an index field object defined for data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaoindexinfo-structure.md b/docs/mfc/reference/cdaoindexinfo-structure.md index e7558e5bae8..be9ddb6cda6 100644 --- a/docs/mfc/reference/cdaoindexinfo-structure.md +++ b/docs/mfc/reference/cdaoindexinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["DAO (Data Access Objects), Indexes collection", "CDaoInde --- # CDaoIndexInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoIndexInfo` structure contains information about an index object defined for data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaoparameterinfo-structure.md b/docs/mfc/reference/cdaoparameterinfo-structure.md index d2d54d4df78..4fcf70aef04 100644 --- a/docs/mfc/reference/cdaoparameterinfo-structure.md +++ b/docs/mfc/reference/cdaoparameterinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoParameterInfo structure [MFC]", "DAO (Data Access Obj --- # CDaoParameterInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoParameterInfo` structure contains information about a parameter object defined for data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaoquerydef-class.md b/docs/mfc/reference/cdaoquerydef-class.md index a8f573e6927..a9a1a58c780 100644 --- a/docs/mfc/reference/cdaoquerydef-class.md +++ b/docs/mfc/reference/cdaoquerydef-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoQueryDef [MFC], CDaoQueryDef", "CDaoQueryDef [MFC], A --- # `CDaoQueryDef` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a query definition, or "querydef," usually one saved in a database. > [!NOTE] diff --git a/docs/mfc/reference/cdaoquerydefinfo-structure.md b/docs/mfc/reference/cdaoquerydefinfo-structure.md index 78fed0c2d26..189ccc92e46 100644 --- a/docs/mfc/reference/cdaoquerydefinfo-structure.md +++ b/docs/mfc/reference/cdaoquerydefinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["DAO (Data Access Objects), QueryDefs collection", "CDaoQu --- # CDaoQueryDefInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoQueryDefInfo` structure contains information about a querydef object defined for data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaorecordset-class.md b/docs/mfc/reference/cdaorecordset-class.md index 4525538078a..5e2e7a99aaa 100644 --- a/docs/mfc/reference/cdaorecordset-class.md +++ b/docs/mfc/reference/cdaorecordset-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoRecordset [MFC], CDaoRecordset", "CDaoRecordset [MFC] --- # CDaoRecordset Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a set of records selected from a data source. > [!NOTE] diff --git a/docs/mfc/reference/cdaorecordview-class.md b/docs/mfc/reference/cdaorecordview-class.md index e2baaabc9ec..ac74d10bda4 100644 --- a/docs/mfc/reference/cdaorecordview-class.md +++ b/docs/mfc/reference/cdaorecordview-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoRecordView [MFC], CDaoRecordView", "CDaoRecordView [M --- # CDaoRecordView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A view that displays database records in controls. > [!NOTE] diff --git a/docs/mfc/reference/cdaorelationfieldinfo-structure.md b/docs/mfc/reference/cdaorelationfieldinfo-structure.md index af98cdba7ea..fca6e68a814 100644 --- a/docs/mfc/reference/cdaorelationfieldinfo-structure.md +++ b/docs/mfc/reference/cdaorelationfieldinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["DAO (Data Access Objects), Relations collection", "CDaoRe --- # CDaoRelationFieldInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoRelationFieldInfo` structure contains information about a field in a relation defined for data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaorelationinfo-structure.md b/docs/mfc/reference/cdaorelationinfo-structure.md index d93623b3d76..23b62170c85 100644 --- a/docs/mfc/reference/cdaorelationinfo-structure.md +++ b/docs/mfc/reference/cdaorelationinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["DAO (Data Access Objects), Relations collection", "CDaoRe --- # CDaoRelationInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoRelationInfo` structure contains information about a relation defined between fields of two tables in a [`CDaoDatabase`](../../mfc/reference/cdaodatabase-class.md) object. > [!NOTE] diff --git a/docs/mfc/reference/cdaotabledef-class.md b/docs/mfc/reference/cdaotabledef-class.md index 8e9f63fcc55..2c76e899c5f 100644 --- a/docs/mfc/reference/cdaotabledef-class.md +++ b/docs/mfc/reference/cdaotabledef-class.md @@ -8,6 +8,9 @@ ms.custom: sfi-ropc-nochange --- # CDaoTableDef Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents the stored definition of a base table or an attached table. > [!NOTE] diff --git a/docs/mfc/reference/cdaotabledefinfo-structure.md b/docs/mfc/reference/cdaotabledefinfo-structure.md index ca83c7daed9..d554bc069f5 100644 --- a/docs/mfc/reference/cdaotabledefinfo-structure.md +++ b/docs/mfc/reference/cdaotabledefinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoTableDefInfo structure [MFC]", "DAO (Data Access Obje --- # CDaoTableDefInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoTableDefInfo` structure contains information about a tabledef object defined for data access objects (DAO). > [!NOTE] diff --git a/docs/mfc/reference/cdaoworkspace-class.md b/docs/mfc/reference/cdaoworkspace-class.md index 0f1ddba2a65..b482e263b68 100644 --- a/docs/mfc/reference/cdaoworkspace-class.md +++ b/docs/mfc/reference/cdaoworkspace-class.md @@ -8,6 +8,9 @@ ms.custom: sfi-ropc-nochange --- # CDaoWorkspace Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages a named, password-protected database session from login to logoff, by a single user. > [!NOTE] diff --git a/docs/mfc/reference/cdaoworkspaceinfo-structure.md b/docs/mfc/reference/cdaoworkspaceinfo-structure.md index 906f4cc2f35..b35ed93deab 100644 --- a/docs/mfc/reference/cdaoworkspaceinfo-structure.md +++ b/docs/mfc/reference/cdaoworkspaceinfo-structure.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDaoWorkspaceInfo structure [MFC]", "DAO (Data Access Obj --- # CDaoWorkspaceInfo Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDaoWorkspaceInfo` structure contains information about a workspace defined for data access objects (DAO) database access. > [!NOTE] diff --git a/docs/mfc/reference/cdatabase-class.md b/docs/mfc/reference/cdatabase-class.md index 7258c18594b..b6b22b72799 100644 --- a/docs/mfc/reference/cdatabase-class.md +++ b/docs/mfc/reference/cdatabase-class.md @@ -8,6 +8,9 @@ ms.custom: sfi-ropc-nochange --- # `CDatabase` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a connection to a data source, through which you can operate on the data source. ## Syntax diff --git a/docs/mfc/reference/cdataexchange-class.md b/docs/mfc/reference/cdataexchange-class.md index 36773b0d836..c8db1f00f28 100644 --- a/docs/mfc/reference/cdataexchange-class.md +++ b/docs/mfc/reference/cdataexchange-class.md @@ -4,10 +4,12 @@ title: "CDataExchange Class" ms.date: "11/04/2016" f1_keywords: ["CDataExchange", "AFXWIN/CDataExchange", "AFXWIN/CDataExchange::CDataExchange", "AFXWIN/CDataExchange::Fail", "AFXWIN/CDataExchange::PrepareCtrl", "AFXWIN/CDataExchange::PrepareEditCtrl", "AFXWIN/CDataExchange::PrepareOleCtrl", "AFXWIN/CDataExchange::m_bSaveAndValidate", "AFXWIN/CDataExchange::m_pDlgWnd"] helpviewer_keywords: ["CDataExchange [MFC], CDataExchange", "CDataExchange [MFC], Fail", "CDataExchange [MFC], PrepareCtrl", "CDataExchange [MFC], PrepareEditCtrl", "CDataExchange [MFC], PrepareOleCtrl", "CDataExchange [MFC], m_bSaveAndValidate", "CDataExchange [MFC], m_pDlgWnd"] -ms.assetid: 84ed6113-325d-493e-a75d-223f03a992b8 --- # CDataExchange Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports the dialog data exchange (DDX) and dialog data validation (DDV) routines used by the Microsoft Foundation classes. ## Syntax diff --git a/docs/mfc/reference/cdatapathproperty-class.md b/docs/mfc/reference/cdatapathproperty-class.md index 46de01c0c6b..d98aad1fe22 100644 --- a/docs/mfc/reference/cdatapathproperty-class.md +++ b/docs/mfc/reference/cdatapathproperty-class.md @@ -4,10 +4,12 @@ title: "CDataPathProperty Class" ms.date: "11/04/2016" f1_keywords: ["CDataPathProperty", "AFXCTL/CDataPathProperty", "AFXCTL/CDataPathProperty::CDataPathProperty", "AFXCTL/CDataPathProperty::GetControl", "AFXCTL/CDataPathProperty::GetPath", "AFXCTL/CDataPathProperty::Open", "AFXCTL/CDataPathProperty::ResetData", "AFXCTL/CDataPathProperty::SetControl", "AFXCTL/CDataPathProperty::SetPath"] helpviewer_keywords: ["CDataPathProperty [MFC], CDataPathProperty", "CDataPathProperty [MFC], GetControl", "CDataPathProperty [MFC], GetPath", "CDataPathProperty [MFC], Open", "CDataPathProperty [MFC], ResetData", "CDataPathProperty [MFC], SetControl", "CDataPathProperty [MFC], SetPath"] -ms.assetid: 1f96efdb-54e4-460b-862c-eba5d4103488 --- # CDataPathProperty Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements an OLE control property that can be loaded asynchronously. ## Syntax diff --git a/docs/mfc/reference/cdatarecoveryhandler-class.md b/docs/mfc/reference/cdatarecoveryhandler-class.md index e66f75c9646..8c5793cbe90 100644 --- a/docs/mfc/reference/cdatarecoveryhandler-class.md +++ b/docs/mfc/reference/cdatarecoveryhandler-class.md @@ -4,10 +4,12 @@ title: "CDataRecoveryHandler Class" ms.date: "03/27/2019" f1_keywords: ["CDataRecoveryHandler", "AFXDATARECOVERY/CDataRecoveryHandler", "AFXDATARECOVERY/CDataRecoveryHandler::CDataRecoveryHandler", "AFXDATARECOVERY/CDataRecoveryHandler::AutosaveAllDocumentInfo", "AFXDATARECOVERY/CDataRecoveryHandler::AutosaveDocumentInfo", "AFXDATARECOVERY/CDataRecoveryHandler::CreateDocumentInfo", "AFXDATARECOVERY/CDataRecoveryHandler::DeleteAllAutosavedFiles", "AFXDATARECOVERY/CDataRecoveryHandler::DeleteAutosavedFile", "AFXDATARECOVERY/CDataRecoveryHandler::GenerateAutosaveFileName", "AFXDATARECOVERY/CDataRecoveryHandler::GetAutosaveInterval", "AFXDATARECOVERY/CDataRecoveryHandler::GetAutosavePath", "AFXDATARECOVERY/CDataRecoveryHandler::GetDocumentListName", "AFXDATARECOVERY/CDataRecoveryHandler::GetNormalDocumentTitle", "AFXDATARECOVERY/CDataRecoveryHandler::GetRecoveredDocumentTitle", "AFXDATARECOVERY/CDataRecoveryHandler::GetRestartIdentifier", "AFXDATARECOVERY/CDataRecoveryHandler::GetSaveDocumentInfoOnIdle", "AFXDATARECOVERY/CDataRecoveryHandler::GetShutdownByRestartManager", "AFXDATARECOVERY/CDataRecoveryHandler::Initialize", "AFXDATARECOVERY/CDataRecoveryHandler::QueryRestoreAutosavedDocuments", "AFXDATARECOVERY/CDataRecoveryHandler::ReadOpenDocumentList", "AFXDATARECOVERY/CDataRecoveryHandler::RemoveDocumentInfo", "AFXDATARECOVERY/CDataRecoveryHandler::ReopenPreviousDocuments", "AFXDATARECOVERY/CDataRecoveryHandler::RestoreAutosavedDocuments", "AFXDATARECOVERY/CDataRecoveryHandler::SaveOpenDocumentList", "AFXDATARECOVERY/CDataRecoveryHandler::SetAutosaveInterval", "AFXDATARECOVERY/CDataRecoveryHandler::SetAutosavePath", "AFXDATARECOVERY/CDataRecoveryHandler::SetRestartIdentifier", "AFXDATARECOVERY/CDataRecoveryHandler::SetSaveDocumentInfoOnIdle", "AFXDATARECOVERY/CDataRecoveryHandler::SetShutdownByRestartManager", "AFXDATARECOVERY/CDataRecoveryHandler::UpdateDocumentInfo"] helpviewer_keywords: ["CDataRecoveryHandler [MFC], CDataRecoveryHandler", "CDataRecoveryHandler [MFC], AutosaveAllDocumentInfo", "CDataRecoveryHandler [MFC], AutosaveDocumentInfo", "CDataRecoveryHandler [MFC], CreateDocumentInfo", "CDataRecoveryHandler [MFC], DeleteAllAutosavedFiles", "CDataRecoveryHandler [MFC], DeleteAutosavedFile", "CDataRecoveryHandler [MFC], GenerateAutosaveFileName", "CDataRecoveryHandler [MFC], GetAutosaveInterval", "CDataRecoveryHandler [MFC], GetAutosavePath", "CDataRecoveryHandler [MFC], GetDocumentListName", "CDataRecoveryHandler [MFC], GetNormalDocumentTitle", "CDataRecoveryHandler [MFC], GetRecoveredDocumentTitle", "CDataRecoveryHandler [MFC], GetRestartIdentifier", "CDataRecoveryHandler [MFC], GetSaveDocumentInfoOnIdle", "CDataRecoveryHandler [MFC], GetShutdownByRestartManager", "CDataRecoveryHandler [MFC], Initialize", "CDataRecoveryHandler [MFC], QueryRestoreAutosavedDocuments", "CDataRecoveryHandler [MFC], ReadOpenDocumentList", "CDataRecoveryHandler [MFC], RemoveDocumentInfo", "CDataRecoveryHandler [MFC], ReopenPreviousDocuments", "CDataRecoveryHandler [MFC], RestoreAutosavedDocuments", "CDataRecoveryHandler [MFC], SaveOpenDocumentList", "CDataRecoveryHandler [MFC], SetAutosaveInterval", "CDataRecoveryHandler [MFC], SetAutosavePath", "CDataRecoveryHandler [MFC], SetRestartIdentifier", "CDataRecoveryHandler [MFC], SetSaveDocumentInfoOnIdle", "CDataRecoveryHandler [MFC], SetShutdownByRestartManager", "CDataRecoveryHandler [MFC], UpdateDocumentInfo"] -ms.assetid: 7794802c-e583-4eba-90b9-2fed1a161f9c --- # CDataRecoveryHandler Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDataRecoveryHandler` autosaves documents and restores them if an application unexpectedly exits. ## Syntax diff --git a/docs/mfc/reference/cdatetimectrl-class.md b/docs/mfc/reference/cdatetimectrl-class.md index 095b88b9642..92549d32217 100644 --- a/docs/mfc/reference/cdatetimectrl-class.md +++ b/docs/mfc/reference/cdatetimectrl-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDateTimeCtrl [MFC], CDateTimeCtrl", "CDateTimeCtrl [MFC] --- # `CDateTimeCtrl` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the functionality of a date and time picker control. ## Syntax diff --git a/docs/mfc/reference/cdbexception-class.md b/docs/mfc/reference/cdbexception-class.md index 741ced39720..0c142000f01 100644 --- a/docs/mfc/reference/cdbexception-class.md +++ b/docs/mfc/reference/cdbexception-class.md @@ -4,10 +4,12 @@ title: "CDBException Class" ms.date: "11/04/2016" f1_keywords: ["CDBException", "AFXDB/CDBException", "AFXDB/CDBException::m_nRetCode", "AFXDB/CDBException::m_strError", "AFXDB/CDBException::m_strStateNativeOrigin"] helpviewer_keywords: ["CDBException [MFC], m_nRetCode", "CDBException [MFC], m_strError", "CDBException [MFC], m_strStateNativeOrigin"] -ms.assetid: eb9e1119-89f5-49a7-b9d4-b91cee1ccc82 --- # CDBException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an exception condition arising from the database classes. ## Syntax diff --git a/docs/mfc/reference/cdbvariant-class.md b/docs/mfc/reference/cdbvariant-class.md index f752d848dae..585531dc9ab 100644 --- a/docs/mfc/reference/cdbvariant-class.md +++ b/docs/mfc/reference/cdbvariant-class.md @@ -4,10 +4,12 @@ title: "CDBVariant Class" ms.date: "11/04/2016" f1_keywords: ["CDBVariant", "AFXDB/CDBVariant", "AFXDB/CDBVariant::CDBVariant", "AFXDB/CDBVariant::Clear", "AFXDB/CDBVariant::m_dwType", "AFXDB/CDBVariant::m_boolVal", "AFXDB/CDBVariant::m_chVal", "AFXDB/CDBVariant::m_dblVal", "AFXDB/CDBVariant::m_fltVal", "AFXDB/CDBVariant::m_iVal", "AFXDB/CDBVariant::m_lVal", "AFXDB/CDBVariant::m_pbinary", "AFXDB/CDBVariant::m_pdate", "AFXDB/CDBVariant::m_pstring", "AFXDB/CDBVariant::m_pstringA", "AFXDB/CDBVariant::m_pstringW"] helpviewer_keywords: ["CDBVariant [MFC], CDBVariant", "CDBVariant [MFC], Clear", "CDBVariant [MFC], m_dwType", "CDBVariant [MFC], m_boolVal", "CDBVariant [MFC], m_chVal", "CDBVariant [MFC], m_dblVal", "CDBVariant [MFC], m_fltVal", "CDBVariant [MFC], m_iVal", "CDBVariant [MFC], m_lVal", "CDBVariant [MFC], m_pbinary", "CDBVariant [MFC], m_pdate", "CDBVariant [MFC], m_pstring", "CDBVariant [MFC], m_pstringA", "CDBVariant [MFC], m_pstringW"] -ms.assetid: de23609c-c560-4b24-bd6b-9d8903fd5b49 --- # CDBVariant Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a variant data type for the MFC ODBC classes. ## Syntax diff --git a/docs/mfc/reference/cdc-class.md b/docs/mfc/reference/cdc-class.md index 69ea401ff76..0ab4a2f4054 100644 --- a/docs/mfc/reference/cdc-class.md +++ b/docs/mfc/reference/cdc-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDC [MFC], CDC", "CDC [MFC], AbortDoc", "CDC [MFC], Abort --- # `CDC` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Defines a class of device-context objects. ## Syntax diff --git a/docs/mfc/reference/cdcrendertarget-class.md b/docs/mfc/reference/cdcrendertarget-class.md index 6a191229ba9..43ae0089a83 100644 --- a/docs/mfc/reference/cdcrendertarget-class.md +++ b/docs/mfc/reference/cdcrendertarget-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDCRenderTarget [MFC], CDCRenderTarget", "CDCRenderTarget --- # `CDCRenderTarget` class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for [`ID2D1DCRenderTarget`](/windows/win32/api/d2d1/nn-d2d1-id2d1dcrendertarget). ## Syntax diff --git a/docs/mfc/reference/cdhtmldialog-class.md b/docs/mfc/reference/cdhtmldialog-class.md index 82562ba5ad2..afad32ba58d 100644 --- a/docs/mfc/reference/cdhtmldialog-class.md +++ b/docs/mfc/reference/cdhtmldialog-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDHtmlDialog [MFC], CDHtmlDialog", "CDHtmlDialog [MFC], C --- # `CDHtmlDialog` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Is used to create dialog boxes that use HTML rather than dialog resources to implement their user interface. ## Syntax diff --git a/docs/mfc/reference/cdialog-class.md b/docs/mfc/reference/cdialog-class.md index fa6866e8b86..dfd80214b40 100644 --- a/docs/mfc/reference/cdialog-class.md +++ b/docs/mfc/reference/cdialog-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDialog [MFC], CDialog", "CDialog [MFC], Create", "CDialo --- # CDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class used for displaying dialog boxes on the screen. ## Syntax diff --git a/docs/mfc/reference/cdialogbar-class.md b/docs/mfc/reference/cdialogbar-class.md index 4b613e0fa29..1bd4ddb3413 100644 --- a/docs/mfc/reference/cdialogbar-class.md +++ b/docs/mfc/reference/cdialogbar-class.md @@ -4,10 +4,12 @@ title: "CDialogBar Class" ms.date: "11/04/2016" f1_keywords: ["CDialogBar", "AFXEXT/CDialogBar", "AFXEXT/CDialogBar::CDialogBar", "AFXEXT/CDialogBar::Create"] helpviewer_keywords: ["CDialogBar [MFC], CDialogBar", "CDialogBar [MFC], Create"] -ms.assetid: da2f7a30-970c-44e3-87f0-6094bd002cab --- # CDialogBar Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows modeless dialog box in a control bar. ## Syntax diff --git a/docs/mfc/reference/cdialogex-class.md b/docs/mfc/reference/cdialogex-class.md index f2b25ce85ee..06f3d5289ca 100644 --- a/docs/mfc/reference/cdialogex-class.md +++ b/docs/mfc/reference/cdialogex-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDialogEx [MFC], CDialogEx", "CDialogEx [MFC], SetBackgro --- # `CDialogEx` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDialogEx` class specifies the background color and background image of a dialog box. ## Syntax diff --git a/docs/mfc/reference/cdiscretetransition-class.md b/docs/mfc/reference/cdiscretetransition-class.md index 19fc03b66bb..252551cbaed 100644 --- a/docs/mfc/reference/cdiscretetransition-class.md +++ b/docs/mfc/reference/cdiscretetransition-class.md @@ -4,10 +4,12 @@ title: "CDiscreteTransition Class" ms.date: "11/04/2016" f1_keywords: ["CDiscreteTransition", "AFXANIMATIONCONTROLLER/CDiscreteTransition", "AFXANIMATIONCONTROLLER/CDiscreteTransition::CDiscreteTransition", "AFXANIMATIONCONTROLLER/CDiscreteTransition::Create", "AFXANIMATIONCONTROLLER/CDiscreteTransition::m_dblFinalValue", "AFXANIMATIONCONTROLLER/CDiscreteTransition::m_delay", "AFXANIMATIONCONTROLLER/CDiscreteTransition::m_hold"] helpviewer_keywords: ["CDiscreteTransition [MFC], CDiscreteTransition", "CDiscreteTransition [MFC], Create", "CDiscreteTransition [MFC], m_dblFinalValue", "CDiscreteTransition [MFC], m_delay", "CDiscreteTransition [MFC], m_hold"] -ms.assetid: b4d84fb3-ccaa-451c-a69b-6b50dcb9b9c8 --- # CDiscreteTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a discrete transition. ## Syntax diff --git a/docs/mfc/reference/cdocitem-class.md b/docs/mfc/reference/cdocitem-class.md index 7c8ae289b39..b0bb4ca4108 100644 --- a/docs/mfc/reference/cdocitem-class.md +++ b/docs/mfc/reference/cdocitem-class.md @@ -4,10 +4,12 @@ title: "CDocItem Class" ms.date: "11/04/2016" f1_keywords: ["CDocItem", "AFXOLE/CDocItem", "AFXOLE/CDocItem::GetDocument", "AFXOLE/CDocItem::IsBlank"] helpviewer_keywords: ["CDocItem [MFC], GetDocument", "CDocItem [MFC], IsBlank"] -ms.assetid: 84fb8610-a4c8-4211-adc0-e70e8d002c11 --- # CDocItem Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for document items, which are components of a document's data. ## Syntax diff --git a/docs/mfc/reference/cdockablepane-class.md b/docs/mfc/reference/cdockablepane-class.md index cd6f7131161..a52ecfb1a54 100644 --- a/docs/mfc/reference/cdockablepane-class.md +++ b/docs/mfc/reference/cdockablepane-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDockablePane [MFC], CDockablePane", "CDockablePane [MFC] --- # `CDockablePane` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a pane that can either be docked in a dock site or included in a tabbed pane. ## Syntax diff --git a/docs/mfc/reference/cdockablepaneadapter-class.md b/docs/mfc/reference/cdockablepaneadapter-class.md index 4c483e1e874..a9f0e5685b9 100644 --- a/docs/mfc/reference/cdockablepaneadapter-class.md +++ b/docs/mfc/reference/cdockablepaneadapter-class.md @@ -4,10 +4,12 @@ title: "CDockablePaneAdapter Class" ms.date: "11/04/2016" f1_keywords: ["CDockablePaneAdapter", "AFXDOCKABLEPANEADAPTER/CDockablePaneAdapter", "AFXDOCKABLEPANEADAPTER/CDockablePaneAdapter::GetWrappedWnd", "AFXDOCKABLEPANEADAPTER/CDockablePaneAdapter::LoadState", "AFXDOCKABLEPANEADAPTER/CDockablePaneAdapter::SaveState", "AFXDOCKABLEPANEADAPTER/CDockablePaneAdapter::SetWrappedWnd"] helpviewer_keywords: ["CDockablePaneAdapter [MFC], GetWrappedWnd", "CDockablePaneAdapter [MFC], LoadState", "CDockablePaneAdapter [MFC], SaveState", "CDockablePaneAdapter [MFC], SetWrappedWnd"] -ms.assetid: 6ed6cf82-f39c-4d0c-bf7c-8641495cf8f3 --- # CDockablePaneAdapter Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides docking support for `CWnd`-derived panes. ## Syntax diff --git a/docs/mfc/reference/cdockingmanager-class.md b/docs/mfc/reference/cdockingmanager-class.md index e3fe1e204bd..972e77d344e 100644 --- a/docs/mfc/reference/cdockingmanager-class.md +++ b/docs/mfc/reference/cdockingmanager-class.md @@ -4,10 +4,12 @@ title: "CDockingManager Class" ms.date: "11/04/2016" f1_keywords: ["CDockingManager", "AFXDOCKINGMANAGER/CDockingManager", "AFXDOCKINGMANAGER/CDockingManager::AddDockSite", "AFXDOCKINGMANAGER/CDockingManager::AddHiddenMDITabbedBar", "AFXDOCKINGMANAGER/CDockingManager::AddMiniFrame", "AFXDOCKINGMANAGER/CDockingManager::AddPane", "AFXDOCKINGMANAGER/CDockingManager::AdjustDockingLayout", "AFXDOCKINGMANAGER/CDockingManager::AdjustPaneFrames", "AFXDOCKINGMANAGER/CDockingManager::AdjustRectToClientArea", "AFXDOCKINGMANAGER/CDockingManager::AlignAutoHidePane", "AFXDOCKINGMANAGER/CDockingManager::AutoHidePane", "AFXDOCKINGMANAGER/CDockingManager::BringBarsToTop", "AFXDOCKINGMANAGER/CDockingManager::BuildPanesMenu", "AFXDOCKINGMANAGER/CDockingManager::CalcExpectedDockedRect", "AFXDOCKINGMANAGER/CDockingManager::Create", "AFXDOCKINGMANAGER/CDockingManager::DeterminePaneAndStatus", "AFXDOCKINGMANAGER/CDockingManager::DisableRestoreDockState", "AFXDOCKINGMANAGER/CDockingManager::DockPane", "AFXDOCKINGMANAGER/CDockingManager::DockPaneLeftOf", "AFXDOCKINGMANAGER/CDockingManager::EnableAutoHidePanes", "AFXDOCKINGMANAGER/CDockingManager::EnableDocking", "AFXDOCKINGMANAGER/CDockingManager::EnableDockSiteMenu", "AFXDOCKINGMANAGER/CDockingManager::EnablePaneContextMenu", "AFXDOCKINGMANAGER/CDockingManager::FindDockSite", "AFXDOCKINGMANAGER/CDockingManager::FindDockSiteByPane", "AFXDOCKINGMANAGER/CDockingManager::FindPaneByID", "AFXDOCKINGMANAGER/CDockingManager::FixupVirtualRects", "AFXDOCKINGMANAGER/CDockingManager::FrameFromPoint", "AFXDOCKINGMANAGER/CDockingManager::GetClientAreaBounds", "AFXDOCKINGMANAGER/CDockingManager::GetDockingMode", "AFXDOCKINGMANAGER/CDockingManager::GetDockSiteFrameWnd", "AFXDOCKINGMANAGER/CDockingManager::GetEnabledAutoHideAlignment", "AFXDOCKINGMANAGER/CDockingManager::GetMiniFrames", "AFXDOCKINGMANAGER/CDockingManager::GetOuterEdgeBounds", "AFXDOCKINGMANAGER/CDockingManager::GetPaneList", "AFXDOCKINGMANAGER/CDockingManager::GetSmartDockingManager", "AFXDOCKINGMANAGER/CDockingManager::GetSmartDockingManagerPermanent", "AFXDOCKINGMANAGER/CDockingManager::GetSmartDockingParams", "AFXDOCKINGMANAGER/CDockingManager::GetSmartDockingTheme", "AFXDOCKINGMANAGER/CDockingManager::HideAutoHidePanes", "AFXDOCKINGMANAGER/CDockingManager::InsertDockSite", "AFXDOCKINGMANAGER/CDockingManager::InsertPane", "AFXDOCKINGMANAGER/CDockingManager::IsDockSiteMenu", "AFXDOCKINGMANAGER/CDockingManager::IsInAdjustLayout", "AFXDOCKINGMANAGER/CDockingManager::IsOLEContainerMode", "AFXDOCKINGMANAGER/CDockingManager::IsPointNearDockSite", "AFXDOCKINGMANAGER/CDockingManager::IsPrintPreviewValid", "AFXDOCKINGMANAGER/CDockingManager::LoadState", "AFXDOCKINGMANAGER/CDockingManager::LockUpdate", "AFXDOCKINGMANAGER/CDockingManager::OnActivateFrame", "AFXDOCKINGMANAGER/CDockingManager::OnClosePopupMenu", "AFXDOCKINGMANAGER/CDockingManager::OnMoveMiniFrame", "AFXDOCKINGMANAGER/CDockingManager::OnPaneContextMenu", "AFXDOCKINGMANAGER/CDockingManager::PaneFromPoint", "AFXDOCKINGMANAGER/CDockingManager::ProcessPaneContextMenuCommand", "AFXDOCKINGMANAGER/CDockingManager::RecalcLayout", "AFXDOCKINGMANAGER/CDockingManager::ReleaseEmptyPaneContainers", "AFXDOCKINGMANAGER/CDockingManager::RemoveHiddenMDITabbedBar", "AFXDOCKINGMANAGER/CDockingManager::RemoveMiniFrame", "AFXDOCKINGMANAGER/CDockingManager::RemovePaneFromDockManager", "AFXDOCKINGMANAGER/CDockingManager::ReplacePane", "AFXDOCKINGMANAGER/CDockingManager::ResortMiniFramesForZOrder", "AFXDOCKINGMANAGER/CDockingManager::SaveState", "AFXDOCKINGMANAGER/CDockingManager::SendMessageToMiniFrames", "AFXDOCKINGMANAGER/CDockingManager::Serialize", "AFXDOCKINGMANAGER/CDockingManager::SetAutohideZOrder", "AFXDOCKINGMANAGER/CDockingManager::SetDockingMode", "AFXDOCKINGMANAGER/CDockingManager::SetDockState", "AFXDOCKINGMANAGER/CDockingManager::SetPrintPreviewMode", "AFXDOCKINGMANAGER/CDockingManager::SetSmartDockingParams", "AFXDOCKINGMANAGER/CDockingManager::ShowDelayShowMiniFrames", "AFXDOCKINGMANAGER/CDockingManager::ShowPanes", "AFXDOCKINGMANAGER/CDockingManager::StartSDocking", "AFXDOCKINGMANAGER/CDockingManager::StopSDocking", "AFXDOCKINGMANAGER/CDockingManager::m_bHideDockingBarsInContainerMode", "AFXDOCKINGMANAGER/CDockingManager::m_dockModeGlobal", "AFXDOCKINGMANAGER/CDockingManager::m_nDockSensitivity", "AFXDOCKINGMANAGER/CDockingManager::m_nTimeOutBeforeDockingBarDock", "AFXDOCKINGMANAGER/CDockingManager::m_nTimeOutBeforeToolBarDock"] helpviewer_keywords: ["CDockingManager [MFC], AddDockSite", "CDockingManager [MFC], AddHiddenMDITabbedBar", "CDockingManager [MFC], AddMiniFrame", "CDockingManager [MFC], AddPane", "CDockingManager [MFC], AdjustDockingLayout", "CDockingManager [MFC], AdjustPaneFrames", "CDockingManager [MFC], AdjustRectToClientArea", "CDockingManager [MFC], AlignAutoHidePane", "CDockingManager [MFC], AutoHidePane", "CDockingManager [MFC], BringBarsToTop", "CDockingManager [MFC], BuildPanesMenu", "CDockingManager [MFC], CalcExpectedDockedRect", "CDockingManager [MFC], Create", "CDockingManager [MFC], DeterminePaneAndStatus", "CDockingManager [MFC], DisableRestoreDockState", "CDockingManager [MFC], DockPane", "CDockingManager [MFC], DockPaneLeftOf", "CDockingManager [MFC], EnableAutoHidePanes", "CDockingManager [MFC], EnableDocking", "CDockingManager [MFC], EnableDockSiteMenu", "CDockingManager [MFC], EnablePaneContextMenu", "CDockingManager [MFC], FindDockSite", "CDockingManager [MFC], FindDockSiteByPane", "CDockingManager [MFC], FindPaneByID", "CDockingManager [MFC], FixupVirtualRects", "CDockingManager [MFC], FrameFromPoint", "CDockingManager [MFC], GetClientAreaBounds", "CDockingManager [MFC], GetDockingMode", "CDockingManager [MFC], GetDockSiteFrameWnd", "CDockingManager [MFC], GetEnabledAutoHideAlignment", "CDockingManager [MFC], GetMiniFrames", "CDockingManager [MFC], GetOuterEdgeBounds", "CDockingManager [MFC], GetPaneList", "CDockingManager [MFC], GetSmartDockingManager", "CDockingManager [MFC], GetSmartDockingManagerPermanent", "CDockingManager [MFC], GetSmartDockingParams", "CDockingManager [MFC], GetSmartDockingTheme", "CDockingManager [MFC], HideAutoHidePanes", "CDockingManager [MFC], InsertDockSite", "CDockingManager [MFC], InsertPane", "CDockingManager [MFC], IsDockSiteMenu", "CDockingManager [MFC], IsInAdjustLayout", "CDockingManager [MFC], IsOLEContainerMode", "CDockingManager [MFC], IsPointNearDockSite", "CDockingManager [MFC], IsPrintPreviewValid", "CDockingManager [MFC], LoadState", "CDockingManager [MFC], LockUpdate", "CDockingManager [MFC], OnActivateFrame", "CDockingManager [MFC], OnClosePopupMenu", "CDockingManager [MFC], OnMoveMiniFrame", "CDockingManager [MFC], OnPaneContextMenu", "CDockingManager [MFC], PaneFromPoint", "CDockingManager [MFC], ProcessPaneContextMenuCommand", "CDockingManager [MFC], RecalcLayout", "CDockingManager [MFC], ReleaseEmptyPaneContainers", "CDockingManager [MFC], RemoveHiddenMDITabbedBar", "CDockingManager [MFC], RemoveMiniFrame", "CDockingManager [MFC], RemovePaneFromDockManager", "CDockingManager [MFC], ReplacePane", "CDockingManager [MFC], ResortMiniFramesForZOrder", "CDockingManager [MFC], SaveState", "CDockingManager [MFC], SendMessageToMiniFrames", "CDockingManager [MFC], Serialize", "CDockingManager [MFC], SetAutohideZOrder", "CDockingManager [MFC], SetDockingMode", "CDockingManager [MFC], SetDockState", "CDockingManager [MFC], SetPrintPreviewMode", "CDockingManager [MFC], SetSmartDockingParams", "CDockingManager [MFC], ShowDelayShowMiniFrames", "CDockingManager [MFC], ShowPanes", "CDockingManager [MFC], StartSDocking", "CDockingManager [MFC], StopSDocking", "CDockingManager [MFC], m_bHideDockingBarsInContainerMode", "CDockingManager [MFC], m_dockModeGlobal", "CDockingManager [MFC], m_nDockSensitivity", "CDockingManager [MFC], m_nTimeOutBeforeDockingBarDock", "CDockingManager [MFC], m_nTimeOutBeforeToolBarDock"] -ms.assetid: 98e69c43-55d8-4f43-b861-4fda80ec1e32 --- # CDockingManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the core functionality that controls docking layout in a main frame window. ## Syntax diff --git a/docs/mfc/reference/cdockingpanesrow-class.md b/docs/mfc/reference/cdockingpanesrow-class.md index ed86e50a70f..be4e8f4a307 100644 --- a/docs/mfc/reference/cdockingpanesrow-class.md +++ b/docs/mfc/reference/cdockingpanesrow-class.md @@ -4,10 +4,12 @@ title: "CDockingPanesRow Class" ms.date: "10/18/2018" f1_keywords: ["CDockingPanesRow", "AFXDOCKINGPANESROW/CDockingPanesRow", "AFXDOCKINGPANESROW/CDockingPanesRow::AddPane", "AFXDOCKINGPANESROW/CDockingPanesRow::AddPaneFromRow", "AFXDOCKINGPANESROW/CDockingPanesRow::ArrangePanes", "AFXDOCKINGPANESROW/CDockingPanesRow::CalcFixedLayout", "AFXDOCKINGPANESROW/CDockingPanesRow::Create", "AFXDOCKINGPANESROW/CDockingPanesRow::ExpandStretchedPanes", "AFXDOCKINGPANESROW/CDockingPanesRow::ExpandStretchedPanesRect", "AFXDOCKINGPANESROW/CDockingPanesRow::FixupVirtualRects", "AFXDOCKINGPANESROW/CDockingPanesRow::GetAvailableLength", "AFXDOCKINGPANESROW/CDockingPanesRow::GetAvailableSpace", "AFXDOCKINGPANESROW/CDockingPanesRow::GetClientRect", "AFXDOCKINGPANESROW/CDockingPanesRow::GetDockSite", "AFXDOCKINGPANESROW/CDockingPanesRow::GetExtraSpace", "AFXDOCKINGPANESROW/CDockingPanesRow::GetGroupFromPane", "AFXDOCKINGPANESROW/CDockingPanesRow::GetID", "AFXDOCKINGPANESROW/CDockingPanesRow::GetMaxPaneSize", "AFXDOCKINGPANESROW/CDockingPanesRow::GetPaneCount", "AFXDOCKINGPANESROW/CDockingPanesRow::GetPaneList", "AFXDOCKINGPANESROW/CDockingPanesRow::GetRowAlignment", "AFXDOCKINGPANESROW/CDockingPanesRow::GetRowHeight", "AFXDOCKINGPANESROW/CDockingPanesRow::GetRowOffset", "AFXDOCKINGPANESROW/CDockingPanesRow::GetVisibleCount", "AFXDOCKINGPANESROW/CDockingPanesRow::GetWindowRect", "AFXDOCKINGPANESROW/CDockingPanesRow::HasPane", "AFXDOCKINGPANESROW/CDockingPanesRow::IsEmpty", "AFXDOCKINGPANESROW/CDockingPanesRow::IsExclusiveRow", "AFXDOCKINGPANESROW/CDockingPanesRow::IsHorizontal", "AFXDOCKINGPANESROW/CDockingPanesRow::IsVisible", "AFXDOCKINGPANESROW/CDockingPanesRow::Move", "AFXDOCKINGPANESROW/CDockingPanesRow::MovePane", "AFXDOCKINGPANESROW/CDockingPanesRow::OnResizePane", "AFXDOCKINGPANESROW/CDockingPanesRow::RedrawAll", "AFXDOCKINGPANESROW/CDockingPanesRow::RemovePane", "AFXDOCKINGPANESROW/CDockingPanesRow::ReplacePane", "AFXDOCKINGPANESROW/CDockingPanesRow::RepositionPanes", "AFXDOCKINGPANESROW/CDockingPanesRow::Resize", "AFXDOCKINGPANESROW/CDockingPanesRow::ResizeByPaneDivider", "AFXDOCKINGPANESROW/CDockingPanesRow::ScreenToClient", "AFXDOCKINGPANESROW/CDockingPanesRow::SetExtra", "AFXDOCKINGPANESROW/CDockingPanesRow::ShowDockSiteRow", "AFXDOCKINGPANESROW/CDockingPanesRow::ShowPane", "AFXDOCKINGPANESROW/CDockingPanesRow::UpdateVisibleState"] helpviewer_keywords: ["CDockingPanesRow [MFC], AddPane", "CDockingPanesRow [MFC], AddPaneFromRow", "CDockingPanesRow [MFC], ArrangePanes", "CDockingPanesRow [MFC], CalcFixedLayout", "CDockingPanesRow [MFC], Create", "CDockingPanesRow [MFC], ExpandStretchedPanes", "CDockingPanesRow [MFC], ExpandStretchedPanesRect", "CDockingPanesRow [MFC], FixupVirtualRects", "CDockingPanesRow [MFC], GetAvailableLength", "CDockingPanesRow [MFC], GetAvailableSpace", "CDockingPanesRow [MFC], GetClientRect", "CDockingPanesRow [MFC], GetDockSite", "CDockingPanesRow [MFC], GetExtraSpace", "CDockingPanesRow [MFC], GetGroupFromPane", "CDockingPanesRow [MFC], GetID", "CDockingPanesRow [MFC], GetMaxPaneSize", "CDockingPanesRow [MFC], GetPaneCount", "CDockingPanesRow [MFC], GetPaneList", "CDockingPanesRow [MFC], GetRowAlignment", "CDockingPanesRow [MFC], GetRowHeight", "CDockingPanesRow [MFC], GetRowOffset", "CDockingPanesRow [MFC], GetVisibleCount", "CDockingPanesRow [MFC], GetWindowRect", "CDockingPanesRow [MFC], HasPane", "CDockingPanesRow [MFC], IsEmpty", "CDockingPanesRow [MFC], IsExclusiveRow", "CDockingPanesRow [MFC], IsHorizontal", "CDockingPanesRow [MFC], IsVisible", "CDockingPanesRow [MFC], Move", "CDockingPanesRow [MFC], MovePane", "CDockingPanesRow [MFC], OnResizePane", "CDockingPanesRow [MFC], RedrawAll", "CDockingPanesRow [MFC], RemovePane", "CDockingPanesRow [MFC], ReplacePane", "CDockingPanesRow [MFC], RepositionPanes", "CDockingPanesRow [MFC], Resize", "CDockingPanesRow [MFC], ResizeByPaneDivider", "CDockingPanesRow [MFC], ScreenToClient", "CDockingPanesRow [MFC], SetExtra", "CDockingPanesRow [MFC], ShowDockSiteRow", "CDockingPanesRow [MFC], ShowPane", "CDockingPanesRow [MFC], UpdateVisibleState"] -ms.assetid: e7a17832-0ebb-4bce-b799-cec9b60f76fe --- # CDockingPanesRow Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages a list of panes that are located in the same horizontal or vertical row (column) of a dock site. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. diff --git a/docs/mfc/reference/cdocksite-class.md b/docs/mfc/reference/cdocksite-class.md index b8b10362365..810d4522d7b 100644 --- a/docs/mfc/reference/cdocksite-class.md +++ b/docs/mfc/reference/cdocksite-class.md @@ -4,10 +4,12 @@ title: "CDockSite Class" ms.date: "10/18/2018" f1_keywords: ["CDockSite", "AFXDOCKSITE/CDockSite", "AFXDOCKSITE/CDockSite::AddRow", "AFXDOCKSITE/CDockSite::AdjustDockingLayout", "AFXDOCKSITE/CDockSite::AdjustLayout", "AFXDOCKSITE/CDockSite::AlignDockSite", "AFXDOCKSITE/CDockSite::CalcFixedLayout", "AFXDOCKSITE/CDockSite::CanAcceptPane", "AFXDOCKSITE/CDockSite::CreateEx", "AFXDOCKSITE/CDockSite::CreateRow", "AFXDOCKSITE/CDockSite::DockPane", "AFXDOCKSITE/CDockSite::DoesAllowDynInsertBefore", "AFXDOCKSITE/CDockSite::FindRowIndex", "AFXDOCKSITE/CDockSite::FixupVirtualRects", "AFXDOCKSITE/CDockSite::GetDockSiteID", "AFXDOCKSITE/CDockSite::GetDockSiteRowsList", "AFXDOCKSITE/CDockSite::IsAccessibilityCompatible", "AFXDOCKSITE/CDockSite::IsDragMode", "AFXDOCKSITE/CDockSite::IsLastRow", "AFXDOCKSITE/CDockSite::IsRectWithinDockSite", "AFXDOCKSITE/CDockSite::IsResizable", "AFXDOCKSITE/CDockSite::MovePane", "AFXDOCKSITE/CDockSite::OnInsertRow", "AFXDOCKSITE/CDockSite::OnRemoveRow", "AFXDOCKSITE/CDockSite::OnResizeRow", "AFXDOCKSITE/CDockSite::OnSetWindowPos", "AFXDOCKSITE/CDockSite::OnShowRow", "AFXDOCKSITE/CDockSite::OnSizeParent", "AFXDOCKSITE/CDockSite::PaneFromPoint", "AFXDOCKSITE/CDockSite::DockPaneLeftOf", "AFXDOCKSITE/CDockSite::FindPaneByID", "AFXDOCKSITE/CDockSite::GetPaneList", "AFXDOCKSITE/CDockSite::RectSideFromPoint", "AFXDOCKSITE/CDockSite::RemovePane", "AFXDOCKSITE/CDockSite::RemoveRow", "AFXDOCKSITE/CDockSite::ReplacePane", "AFXDOCKSITE/CDockSite::RepositionPanes", "AFXDOCKSITE/CDockSite::ResizeDockSite", "AFXDOCKSITE/CDockSite::ResizeRow", "AFXDOCKSITE/CDockSite::ShowPane", "AFXDOCKSITE/CDockSite::ShowRow", "AFXDOCKSITE/CDockSite::SwapRows"] helpviewer_keywords: ["CDockSite [MFC], AddRow", "CDockSite [MFC], AdjustDockingLayout", "CDockSite [MFC], AdjustLayout", "CDockSite [MFC], AlignDockSite", "CDockSite [MFC], CalcFixedLayout", "CDockSite [MFC], CanAcceptPane", "CDockSite [MFC], CreateEx", "CDockSite [MFC], CreateRow", "CDockSite [MFC], DockPane", "CDockSite [MFC], DoesAllowDynInsertBefore", "CDockSite [MFC], FindRowIndex", "CDockSite [MFC], FixupVirtualRects", "CDockSite [MFC], GetDockSiteID", "CDockSite [MFC], GetDockSiteRowsList", "CDockSite [MFC], IsAccessibilityCompatible", "CDockSite [MFC], IsDragMode", "CDockSite [MFC], IsLastRow", "CDockSite [MFC], IsRectWithinDockSite", "CDockSite [MFC], IsResizable", "CDockSite [MFC], MovePane", "CDockSite [MFC], OnInsertRow", "CDockSite [MFC], OnRemoveRow", "CDockSite [MFC], OnResizeRow", "CDockSite [MFC], OnSetWindowPos", "CDockSite [MFC], OnShowRow", "CDockSite [MFC], OnSizeParent", "CDockSite [MFC], PaneFromPoint", "CDockSite [MFC], DockPaneLeftOf", "CDockSite [MFC], FindPaneByID", "CDockSite [MFC], GetPaneList", "CDockSite [MFC], RectSideFromPoint", "CDockSite [MFC], RemovePane", "CDockSite [MFC], RemoveRow", "CDockSite [MFC], ReplacePane", "CDockSite [MFC], RepositionPanes", "CDockSite [MFC], ResizeDockSite", "CDockSite [MFC], ResizeRow", "CDockSite [MFC], ShowPane", "CDockSite [MFC], ShowRow", "CDockSite [MFC], SwapRows"] -ms.assetid: 0fcfff79-5f50-4281-b2de-a55653bbea40 --- # CDockSite Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. Provides functionality for arranging panes that are derived from the [CPane Class](../../mfc/reference/cpane-class.md) into sets of rows. diff --git a/docs/mfc/reference/cdockstate-class.md b/docs/mfc/reference/cdockstate-class.md index 573f914f69e..2cf9a40a24d 100644 --- a/docs/mfc/reference/cdockstate-class.md +++ b/docs/mfc/reference/cdockstate-class.md @@ -4,10 +4,12 @@ title: "CDockState Class" ms.date: "11/04/2016" f1_keywords: ["CDockState", "AFXADV/CDockState", "AFXADV/CDockState::Clear", "AFXADV/CDockState::GetVersion", "AFXADV/CDockState::LoadState", "AFXADV/CDockState::SaveState", "AFXADV/CDockState::m_arrBarInfo"] helpviewer_keywords: ["CDockState [MFC], Clear", "CDockState [MFC], GetVersion", "CDockState [MFC], LoadState", "CDockState [MFC], SaveState", "CDockState [MFC], m_arrBarInfo"] -ms.assetid: 09e7c10b-3abd-4cb2-ad36-42420fe6bc36 --- # CDockState Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A serialized `CObject` class that loads, unloads, or clears the state of one or more docking control bars in persistent memory (a file). ## Syntax diff --git a/docs/mfc/reference/cdocobjectserver-class.md b/docs/mfc/reference/cdocobjectserver-class.md index b99f2715ac6..706cee08863 100644 --- a/docs/mfc/reference/cdocobjectserver-class.md +++ b/docs/mfc/reference/cdocobjectserver-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDocObjectServer [MFC], CDocObjectServer", "CDocObjectSer --- # CDocObjectServer Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the additional OLE interfaces needed to make a normal `COleDocument` server into a full DocObject server: `IOleDocument`, `IOleDocumentView`, `IOleCommandTarget`, and `IPrint`. ## Syntax diff --git a/docs/mfc/reference/cdocobjectserveritem-class.md b/docs/mfc/reference/cdocobjectserveritem-class.md index 04f07c5cba0..373797418d1 100644 --- a/docs/mfc/reference/cdocobjectserveritem-class.md +++ b/docs/mfc/reference/cdocobjectserveritem-class.md @@ -4,10 +4,12 @@ title: "CDocObjectServerItem Class" ms.date: "03/27/2019" f1_keywords: ["CDocObjectServerItem", "AFXDOCOB/CDocObjectServerItem", "AFXDOCOB/CDocObjectServerItem::CDocObjectServerItem", "AFXDOCOB/CDocObjectServerItem::GetDocument", "AFXDOCOB/CDocObjectServerItem::OnDoVerb", "AFXDOCOB/CDocObjectServerItem::OnHide", "AFXDOCOB/CDocObjectServerItem::OnShow"] helpviewer_keywords: ["CDocObjectServerItem [MFC], CDocObjectServerItem", "CDocObjectServerItem [MFC], GetDocument", "CDocObjectServerItem [MFC], OnDoVerb", "CDocObjectServerItem [MFC], OnHide", "CDocObjectServerItem [MFC], OnShow"] -ms.assetid: 530f7156-50c8-4806-9328-602c9133f622 --- # CDocObjectServerItem Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements OLE server verbs specifically for DocObject servers. ## Syntax diff --git a/docs/mfc/reference/cdoctemplate-class.md b/docs/mfc/reference/cdoctemplate-class.md index f82442239b9..37cdf1a2d6d 100644 --- a/docs/mfc/reference/cdoctemplate-class.md +++ b/docs/mfc/reference/cdoctemplate-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CDocTemplate [MFC], CDocTemplate", "CDocTemplate [MFC], A --- # `CDocTemplate` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An abstract base class that defines the basic functionality for document templates. ## Syntax diff --git a/docs/mfc/reference/cdocument-class.md b/docs/mfc/reference/cdocument-class.md index 53f7c00e9c9..8fe635eee58 100644 --- a/docs/mfc/reference/cdocument-class.md +++ b/docs/mfc/reference/cdocument-class.md @@ -4,10 +4,12 @@ title: "CDocument Class" ms.date: "11/04/2016" f1_keywords: ["CDocument", "AFXWIN/CDocument", "AFXWIN/CDocument::CDocument", "AFXWIN/CDocument::AddView", "AFXWIN/CDocument::BeginReadChunks", "AFXWIN/CDocument::CanCloseFrame", "AFXWIN/CDocument::ClearChunkList", "AFXWIN/CDocument::ClearPathName", "AFXWIN/CDocument::DeleteContents", "AFXWIN/CDocument::FindChunk", "AFXWIN/CDocument::GetAdapter", "AFXWIN/CDocument::GetDocTemplate", "AFXWIN/CDocument::GetFile", "AFXWIN/CDocument::GetFirstViewPosition", "AFXWIN/CDocument::GetNextView", "AFXWIN/CDocument::GetPathName", "AFXWIN/CDocument::GetThumbnail", "AFXWIN/CDocument::GetTitle", "AFXWIN/CDocument::InitializeSearchContent", "AFXWIN/CDocument::IsModified", "AFXWIN/CDocument::IsSearchAndOrganizeHandler", "AFXWIN/CDocument::LoadDocumentFromStream", "AFXWIN/CDocument::OnBeforeRichPreviewFontChanged", "AFXWIN/CDocument::OnChangedViewList", "AFXWIN/CDocument::OnCloseDocument", "AFXWIN/CDocument::OnCreatePreviewFrame", "AFXWIN/CDocument::OnDocumentEvent", "AFXWIN/CDocument::OnDrawThumbnail", "AFXWIN/CDocument::OnLoadDocumentFromStream", "AFXWIN/CDocument::OnNewDocument", "AFXWIN/CDocument::OnOpenDocument", "AFXWIN/CDocument::OnPreviewHandlerQueryFocus", "AFXWIN/CDocument::OnPreviewHandlerTranslateAccelerator", "AFXWIN/CDocument::OnRichPreviewBackColorChanged", "AFXWIN/CDocument::OnRichPreviewFontChanged", "AFXWIN/CDocument::OnRichPreviewSiteChanged", "AFXWIN/CDocument::OnRichPreviewTextColorChanged", "AFXWIN/CDocument::OnSaveDocument", "AFXWIN/CDocument::OnUnloadHandler", "AFXWIN/CDocument::PreCloseFrame", "AFXWIN/CDocument::ReadNextChunkValue", "AFXWIN/CDocument::ReleaseFile", "AFXWIN/CDocument::RemoveChunk", "AFXWIN/CDocument::RemoveView", "AFXWIN/CDocument::ReportSaveLoadException", "AFXWIN/CDocument::SaveModified", "AFXWIN/CDocument::SetChunkValue", "AFXWIN/CDocument::SetModifiedFlag", "AFXWIN/CDocument::SetPathName", "AFXWIN/CDocument::SetTitle", "AFXWIN/CDocument::UpdateAllViews", "AFXWIN/CDocument::OnFileSendMail", "AFXWIN/CDocument::OnUpdateFileSendMail", "AFXWIN/CDocument::m_bGetThumbnailMode", "AFXWIN/CDocument::m_bPreviewHandlerMode", "AFXWIN/CDocument::m_bSearchMode", "AFXWIN/CDocument::m_clrRichPreviewBackColor", "AFXWIN/CDocument::m_clrRichPreviewTextColor", "AFXWIN/CDocument::m_lfRichPreviewFont"] helpviewer_keywords: ["CDocument [MFC], CDocument", "CDocument [MFC], AddView", "CDocument [MFC], BeginReadChunks", "CDocument [MFC], CanCloseFrame", "CDocument [MFC], ClearChunkList", "CDocument [MFC], ClearPathName", "CDocument [MFC], DeleteContents", "CDocument [MFC], FindChunk", "CDocument [MFC], GetAdapter", "CDocument [MFC], GetDocTemplate", "CDocument [MFC], GetFile", "CDocument [MFC], GetFirstViewPosition", "CDocument [MFC], GetNextView", "CDocument [MFC], GetPathName", "CDocument [MFC], GetThumbnail", "CDocument [MFC], GetTitle", "CDocument [MFC], InitializeSearchContent", "CDocument [MFC], IsModified", "CDocument [MFC], IsSearchAndOrganizeHandler", "CDocument [MFC], LoadDocumentFromStream", "CDocument [MFC], OnBeforeRichPreviewFontChanged", "CDocument [MFC], OnChangedViewList", "CDocument [MFC], OnCloseDocument", "CDocument [MFC], OnCreatePreviewFrame", "CDocument [MFC], OnDocumentEvent", "CDocument [MFC], OnDrawThumbnail", "CDocument [MFC], OnLoadDocumentFromStream", "CDocument [MFC], OnNewDocument", "CDocument [MFC], OnOpenDocument", "CDocument [MFC], OnPreviewHandlerQueryFocus", "CDocument [MFC], OnPreviewHandlerTranslateAccelerator", "CDocument [MFC], OnRichPreviewBackColorChanged", "CDocument [MFC], OnRichPreviewFontChanged", "CDocument [MFC], OnRichPreviewSiteChanged", "CDocument [MFC], OnRichPreviewTextColorChanged", "CDocument [MFC], OnSaveDocument", "CDocument [MFC], OnUnloadHandler", "CDocument [MFC], PreCloseFrame", "CDocument [MFC], ReadNextChunkValue", "CDocument [MFC], ReleaseFile", "CDocument [MFC], RemoveChunk", "CDocument [MFC], RemoveView", "CDocument [MFC], ReportSaveLoadException", "CDocument [MFC], SaveModified", "CDocument [MFC], SetChunkValue", "CDocument [MFC], SetModifiedFlag", "CDocument [MFC], SetPathName", "CDocument [MFC], SetTitle", "CDocument [MFC], UpdateAllViews", "CDocument [MFC], OnFileSendMail", "CDocument [MFC], OnUpdateFileSendMail", "CDocument [MFC], m_bGetThumbnailMode", "CDocument [MFC], m_bPreviewHandlerMode", "CDocument [MFC], m_bSearchMode", "CDocument [MFC], m_clrRichPreviewBackColor", "CDocument [MFC], m_clrRichPreviewTextColor", "CDocument [MFC], m_lfRichPreviewFont"] -ms.assetid: e5a2891d-e1e1-4599-8c7e-afa9b4945446 --- # `CDocument` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the basic functionality for user-defined document classes. ## Syntax diff --git a/docs/mfc/reference/cdraglistbox-class.md b/docs/mfc/reference/cdraglistbox-class.md index 3f606afec5c..0a6c49b750a 100644 --- a/docs/mfc/reference/cdraglistbox-class.md +++ b/docs/mfc/reference/cdraglistbox-class.md @@ -4,10 +4,12 @@ title: "CDragListBox Class" ms.date: "11/04/2016" f1_keywords: ["CDragListBox", "AFXCMN/CDragListBox", "AFXCMN/CDragListBox::CDragListBox", "AFXCMN/CDragListBox::BeginDrag", "AFXCMN/CDragListBox::CancelDrag", "AFXCMN/CDragListBox::Dragging", "AFXCMN/CDragListBox::DrawInsert", "AFXCMN/CDragListBox::Dropped", "AFXCMN/CDragListBox::ItemFromPt"] helpviewer_keywords: ["CDragListBox [MFC], CDragListBox", "CDragListBox [MFC], BeginDrag", "CDragListBox [MFC], CancelDrag", "CDragListBox [MFC], Dragging", "CDragListBox [MFC], DrawInsert", "CDragListBox [MFC], Dropped", "CDragListBox [MFC], ItemFromPt"] -ms.assetid: fee20b42-60ae-4aa9-83f9-5a3d9b96e33b --- # CDragListBox Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In addition to providing the functionality of a Windows list box, the `CDragListBox` class allows the user to move list box items, such as filenames, within the list box. ## Syntax diff --git a/docs/mfc/reference/cdrawingmanager-class.md b/docs/mfc/reference/cdrawingmanager-class.md index 0ac81cd52f4..0b13d57074e 100644 --- a/docs/mfc/reference/cdrawingmanager-class.md +++ b/docs/mfc/reference/cdrawingmanager-class.md @@ -4,10 +4,12 @@ title: "CDrawingManager Class" ms.date: "11/04/2016" f1_keywords: ["CDrawingManager", "AFXDRAWMANAGER/CDrawingManager", "AFXDRAWMANAGER/CDrawingManager::CDrawingManager", "AFXDRAWMANAGER/CDrawingManager::CreateBitmap_32", "AFXDRAWMANAGER/CDrawingManager::DrawAlpha", "AFXDRAWMANAGER/CDrawingManager::DrawRotated", "AFXDRAWMANAGER/CDrawingManager::DrawEllipse", "AFXDRAWMANAGER/CDrawingManager::DrawGradientRing", "AFXDRAWMANAGER/CDrawingManager::DrawRect", "AFXDRAWMANAGER/CDrawingManager::DrawShadow", "AFXDRAWMANAGER/CDrawingManager::Fill4ColorsGradient", "AFXDRAWMANAGER/CDrawingManager::FillGradient", "AFXDRAWMANAGER/CDrawingManager::FillGradient2", "AFXDRAWMANAGER/CDrawingManager::GrayRect", "AFXDRAWMANAGER/CDrawingManager::HighlightRect", "AFXDRAWMANAGER/CDrawingManager::HLStoRGB_ONE", "AFXDRAWMANAGER/CDrawingManager::HLStoRGB_TWO", "AFXDRAWMANAGER/CDrawingManager::HSVtoRGB", "AFXDRAWMANAGER/CDrawingManager::HuetoRGB", "AFXDRAWMANAGER/CDrawingManager::MirrorRect", "AFXDRAWMANAGER/CDrawingManager::PixelAlpha", "AFXDRAWMANAGER/CDrawingManager::PrepareShadowMask", "AFXDRAWMANAGER/CDrawingManager::RGBtoHSL", "AFXDRAWMANAGER/CDrawingManager::RGBtoHSV", "AFXDRAWMANAGER/CDrawingManager::SetAlphaPixel", "AFXDRAWMANAGER/CDrawingManager::SetPixel", "AFXDRAWMANAGER/CDrawingManager::SmartMixColors"] helpviewer_keywords: ["CDrawingManager [MFC], CDrawingManager", "CDrawingManager [MFC], CreateBitmap_32", "CDrawingManager [MFC], DrawAlpha", "CDrawingManager [MFC], DrawRotated", "CDrawingManager [MFC], DrawEllipse", "CDrawingManager [MFC], DrawGradientRing", "CDrawingManager [MFC], DrawRect", "CDrawingManager [MFC], DrawShadow", "CDrawingManager [MFC], Fill4ColorsGradient", "CDrawingManager [MFC], FillGradient", "CDrawingManager [MFC], FillGradient2", "CDrawingManager [MFC], GrayRect", "CDrawingManager [MFC], HighlightRect", "CDrawingManager [MFC], HLStoRGB_ONE", "CDrawingManager [MFC], HLStoRGB_TWO", "CDrawingManager [MFC], HSVtoRGB", "CDrawingManager [MFC], HuetoRGB", "CDrawingManager [MFC], MirrorRect", "CDrawingManager [MFC], PixelAlpha", "CDrawingManager [MFC], PrepareShadowMask", "CDrawingManager [MFC], RGBtoHSL", "CDrawingManager [MFC], RGBtoHSV", "CDrawingManager [MFC], SetAlphaPixel", "CDrawingManager [MFC], SetPixel", "CDrawingManager [MFC], SmartMixColors"] -ms.assetid: 9e4775ca-101b-4aa9-a85a-4d047c701215 --- # CDrawingManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CDrawingManager` class implements complex drawing algorithms. ## Syntax diff --git a/docs/mfc/reference/cdumpcontext-class.md b/docs/mfc/reference/cdumpcontext-class.md index 62761573c65..7ea003f58f8 100644 --- a/docs/mfc/reference/cdumpcontext-class.md +++ b/docs/mfc/reference/cdumpcontext-class.md @@ -4,10 +4,12 @@ title: "CDumpContext Class" ms.date: "11/04/2016" f1_keywords: ["CDumpContext", "AFX/CDumpContext", "AFX/CDumpContext::CDumpContext", "AFX/CDumpContext::DumpAsHex", "AFX/CDumpContext::Flush", "AFX/CDumpContext::GetDepth", "AFX/CDumpContext::HexDump", "AFX/CDumpContext::SetDepth"] helpviewer_keywords: ["CDumpContext [MFC], CDumpContext", "CDumpContext [MFC], DumpAsHex", "CDumpContext [MFC], Flush", "CDumpContext [MFC], GetDepth", "CDumpContext [MFC], HexDump", "CDumpContext [MFC], SetDepth"] -ms.assetid: 98c52b2d-14b5-48ed-b423-479a4d1c60fa --- # CDumpContext Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports stream-oriented diagnostic output in the form of human-readable text. ## Syntax diff --git a/docs/mfc/reference/cdwordarray-class.md b/docs/mfc/reference/cdwordarray-class.md index 6e9d5f38710..25eaea47f31 100644 --- a/docs/mfc/reference/cdwordarray-class.md +++ b/docs/mfc/reference/cdwordarray-class.md @@ -4,10 +4,12 @@ title: "CDWordArray Class" ms.date: "11/04/2016" f1_keywords: ["CDWordArray", "AFXCOLL/CDWordArray", "AFXCOLL/CDWordArray::CDWordArray", "AFXCOLL/CDWordArray::Add", "AFXCOLL/CDWordArray::Append", "AFXCOLL/CDWordArray::Copy", "AFXCOLL/CDWordArray::ElementAt", "AFXCOLL/CDWordArray::FreeExtra", "AFXCOLL/CDWordArray::GetAt", "AFXCOLL/CDWordArray::GetCount", "AFXCOLL/CDWordArray::GetData", "AFXCOLL/CDWordArray::GetSize", "AFXCOLL/CDWordArray::GetUpperBound", "AFXCOLL/CDWordArray::InsertAt", "AFXCOLL/CDWordArray::IsEmpty", "AFXCOLL/CDWordArray::RemoveAll", "AFXCOLL/CDWordArray::RemoveAt", "AFXCOLL/CDWordArray::SetAt", "AFXCOLL/CDWordArray::SetAtGrow", "AFXCOLL/CDWordArray::SetSize"] helpviewer_keywords: ["CDWordArray [MFC], CDWordArray", "CDWordArray [MFC], Add", "CDWordArray [MFC], Append", "CDWordArray [MFC], Copy", "CDWordArray [MFC], ElementAt", "CDWordArray [MFC], FreeExtra", "CDWordArray [MFC], GetAt", "CDWordArray [MFC], GetCount", "CDWordArray [MFC], GetData", "CDWordArray [MFC], GetSize", "CDWordArray [MFC], GetUpperBound", "CDWordArray [MFC], InsertAt", "CDWordArray [MFC], IsEmpty", "CDWordArray [MFC], RemoveAll", "CDWordArray [MFC], RemoveAt", "CDWordArray [MFC], SetAt", "CDWordArray [MFC], SetAtGrow", "CDWordArray [MFC], SetSize"] -ms.assetid: 581be11e-ced6-47d1-8679-e0b8e7d99494 --- # CDWordArray Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports arrays of 32-bit doublewords. ## Syntax diff --git a/docs/mfc/reference/cedit-class.md b/docs/mfc/reference/cedit-class.md index 3843aec8703..1bbce9a88f9 100644 --- a/docs/mfc/reference/cedit-class.md +++ b/docs/mfc/reference/cedit-class.md @@ -4,10 +4,12 @@ title: "CEdit Class" ms.date: "09/12/2018" f1_keywords: ["CEdit", "AFXWIN/CEdit", "AFXWIN/CEdit::CEdit", "AFXWIN/CEdit::CanUndo", "AFXWIN/CEdit::CharFromPos", "AFXWIN/CEdit::Clear", "AFXWIN/CEdit::Copy", "AFXWIN/CEdit::Create", "AFXWIN/CEdit::Cut", "AFXWIN/CEdit::EmptyUndoBuffer", "AFXWIN/CEdit::FmtLines", "AFXWIN/CEdit::GetCueBanner", "AFXWIN/CEdit::GetFirstVisibleLine", "AFXWIN/CEdit::GetHandle", "AFXWIN/CEdit::GetHighlight", "AFXWIN/CEdit::GetLimitText", "AFXWIN/CEdit::GetLine", "AFXWIN/CEdit::GetLineCount", "AFXWIN/CEdit::GetMargins", "AFXWIN/CEdit::GetModify", "AFXWIN/CEdit::GetPasswordChar", "AFXWIN/CEdit::GetRect", "AFXWIN/CEdit::GetSel", "AFXWIN/CEdit::HideBalloonTip", "AFXWIN/CEdit::LimitText", "AFXWIN/CEdit::LineFromChar", "AFXWIN/CEdit::LineIndex", "AFXWIN/CEdit::LineLength", "AFXWIN/CEdit::LineScroll", "AFXWIN/CEdit::Paste", "AFXWIN/CEdit::PosFromChar", "AFXWIN/CEdit::ReplaceSel", "AFXWIN/CEdit::SetCueBanner", "AFXWIN/CEdit::SetHandle", "AFXWIN/CEdit::SetHighlight", "AFXWIN/CEdit::SetLimitText", "AFXWIN/CEdit::SetMargins", "AFXWIN/CEdit::SetModify", "AFXWIN/CEdit::SetPasswordChar", "AFXWIN/CEdit::SetReadOnly", "AFXWIN/CEdit::SetRect", "AFXWIN/CEdit::SetRectNP", "AFXWIN/CEdit::SetSel", "AFXWIN/CEdit::SetTabStops", "AFXWIN/CEdit::ShowBalloonTip", "AFXWIN/CEdit::Undo"] helpviewer_keywords: ["CEdit [MFC], CEdit", "CEdit [MFC], CanUndo", "CEdit [MFC], CharFromPos", "CEdit [MFC], Clear", "CEdit [MFC], Copy", "CEdit [MFC], Create", "CEdit [MFC], Cut", "CEdit [MFC], EmptyUndoBuffer", "CEdit [MFC], FmtLines", "CEdit [MFC], GetCueBanner", "CEdit [MFC], GetFirstVisibleLine", "CEdit [MFC], GetHandle", "CEdit [MFC], GetHighlight", "CEdit [MFC], GetLimitText", "CEdit [MFC], GetLine", "CEdit [MFC], GetLineCount", "CEdit [MFC], GetMargins", "CEdit [MFC], GetModify", "CEdit [MFC], GetPasswordChar", "CEdit [MFC], GetRect", "CEdit [MFC], GetSel", "CEdit [MFC], HideBalloonTip", "CEdit [MFC], LimitText", "CEdit [MFC], LineFromChar", "CEdit [MFC], LineIndex", "CEdit [MFC], LineLength", "CEdit [MFC], LineScroll", "CEdit [MFC], Paste", "CEdit [MFC], PosFromChar", "CEdit [MFC], ReplaceSel", "CEdit [MFC], SetCueBanner", "CEdit [MFC], SetHandle", "CEdit [MFC], SetHighlight", "CEdit [MFC], SetLimitText", "CEdit [MFC], SetMargins", "CEdit [MFC], SetModify", "CEdit [MFC], SetPasswordChar", "CEdit [MFC], SetReadOnly", "CEdit [MFC], SetRect", "CEdit [MFC], SetRectNP", "CEdit [MFC], SetSel", "CEdit [MFC], SetTabStops", "CEdit [MFC], ShowBalloonTip", "CEdit [MFC], Undo"] -ms.assetid: b1533c30-7f10-4663-88d3-8b7f2c9f7024 --- # CEdit Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows edit control. ## Syntax diff --git a/docs/mfc/reference/ceditview-class.md b/docs/mfc/reference/ceditview-class.md index 19e9d78e469..d2a418035b5 100644 --- a/docs/mfc/reference/ceditview-class.md +++ b/docs/mfc/reference/ceditview-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CEditView [MFC], CEditView", "CEditView [MFC], FindText", --- # CEditView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A type of view class that provides the functionality of a Windows edit control and can be used to implement simple text-editor functionality. ## Syntax diff --git a/docs/mfc/reference/cevent-class.md b/docs/mfc/reference/cevent-class.md index 2ed97e9f1d4..0389a61a321 100644 --- a/docs/mfc/reference/cevent-class.md +++ b/docs/mfc/reference/cevent-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CEvent [MFC], CEvent", "CEvent [MFC], PulseEvent", "CEven --- # `CEvent` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an event, which is a synchronization object that enables one thread to notify another that an event has occurred. ## Syntax diff --git a/docs/mfc/reference/cexception-class.md b/docs/mfc/reference/cexception-class.md index 93f52aba8ac..8bc8d5f40da 100644 --- a/docs/mfc/reference/cexception-class.md +++ b/docs/mfc/reference/cexception-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CException [MFC], CException", "CException [MFC], Delete" --- # `CException` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for all exceptions in the Microsoft Foundation Class Library. ## Syntax diff --git a/docs/mfc/reference/cfieldexchange-class.md b/docs/mfc/reference/cfieldexchange-class.md index 02902f9e1c8..f1a099f9bc7 100644 --- a/docs/mfc/reference/cfieldexchange-class.md +++ b/docs/mfc/reference/cfieldexchange-class.md @@ -4,10 +4,12 @@ title: "CFieldExchange Class" ms.date: "11/04/2016" f1_keywords: ["CFieldExchange", "AFXDB/CFieldExchange", "AFXDB/CFieldExchange::IsFieldType", "AFXDB/CFieldExchange::SetFieldType"] helpviewer_keywords: ["CFieldExchange [MFC], IsFieldType", "CFieldExchange [MFC], SetFieldType"] -ms.assetid: 24c5c0b3-06a6-430e-9b6f-005a2c65e29f --- # CFieldExchange Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports the record field exchange (RFX) and bulk record field exchange (Bulk RFX) routines used by the database classes. ## Syntax diff --git a/docs/mfc/reference/cfile-class.md b/docs/mfc/reference/cfile-class.md index 1621e327467..5c12dc2db75 100644 --- a/docs/mfc/reference/cfile-class.md +++ b/docs/mfc/reference/cfile-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CFile [MFC], CFile", "CFile [MFC], Abort", "CFile [MFC], --- # CFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class for Microsoft Foundation Class file classes. ## Syntax diff --git a/docs/mfc/reference/cfiledialog-class.md b/docs/mfc/reference/cfiledialog-class.md index 64c02078a88..3d84f293e8b 100644 --- a/docs/mfc/reference/cfiledialog-class.md +++ b/docs/mfc/reference/cfiledialog-class.md @@ -4,10 +4,12 @@ title: "CFileDialog Class" ms.date: "11/04/2016" f1_keywords: ["CFileDialog", "AFXDLGS/CFileDialog", "AFXDLGS/CFileDialog::CFileDialog", "AFXDLGS/CFileDialog::AddCheckButton", "AFXDLGS/CFileDialog::AddComboBox", "AFXDLGS/CFileDialog::AddControlItem", "AFXDLGS/CFileDialog::AddEditBox", "AFXDLGS/CFileDialog::AddMenu", "AFXDLGS/CFileDialog::AddPlace", "AFXDLGS/CFileDialog::AddPushButton", "AFXDLGS/CFileDialog::AddRadioButtonList", "AFXDLGS/CFileDialog::AddSeparator", "AFXDLGS/CFileDialog::AddText", "AFXDLGS/CFileDialog::ApplyOFNToShellDialog", "AFXDLGS/CFileDialog::DoModal", "AFXDLGS/CFileDialog::EnableOpenDropDown", "AFXDLGS/CFileDialog::EndVisualGroup", "AFXDLGS/CFileDialog::GetCheckButtonState", "AFXDLGS/CFileDialog::GetControlItemState", "AFXDLGS/CFileDialog::GetControlState", "AFXDLGS/CFileDialog::GetEditBoxText", "AFXDLGS/CFileDialog::GetFileExt", "AFXDLGS/CFileDialog::GetFileName", "AFXDLGS/CFileDialog::GetFileTitle", "AFXDLGS/CFileDialog::GetFolderPath", "AFXDLGS/CFileDialog::GetIFileDialogCustomize", "AFXDLGS/CFileDialog::GetIFileOpenDialog", "AFXDLGS/CFileDialog::GetIFileSaveDialog", "AFXDLGS/CFileDialog::GetNextPathName", "AFXDLGS/CFileDialog::GetOFN", "AFXDLGS/CFileDialog::GetPathName", "AFXDLGS/CFileDialog::GetReadOnlyPref", "AFXDLGS/CFileDialog::GetResult", "AFXDLGS/CFileDialog::GetResults", "AFXDLGS/CFileDialog::GetSelectedControlItem", "AFXDLGS/CFileDialog::GetStartPosition", "AFXDLGS/CFileDialog::HideControl", "AFXDLGS/CFileDialog::IsPickFoldersMode", "AFXDLGS/CFileDialog::MakeProminent", "AFXDLGS/CFileDialog::RemoveControlItem", "AFXDLGS/CFileDialog::SetCheckButtonState", "AFXDLGS/CFileDialog::SetControlItemState", "AFXDLGS/CFileDialog::SetControlItemText", "AFXDLGS/CFileDialog::SetControlLabel", "AFXDLGS/CFileDialog::SetControlState", "AFXDLGS/CFileDialog::SetControlText", "AFXDLGS/CFileDialog::SetDefExt", "AFXDLGS/CFileDialog::SetEditBoxText", "AFXDLGS/CFileDialog::SetProperties", "AFXDLGS/CFileDialog::SetSelectedControlItem", "AFXDLGS/CFileDialog::SetTemplate", "AFXDLGS/CFileDialog::StartVisualGroup", "AFXDLGS/CFileDialog::UpdateOFNFromShellDialog", "AFXDLGS/CFileDialog::OnButtonClicked", "AFXDLGS/CFileDialog::OnCheckButtonToggled", "AFXDLGS/CFileDialog::OnControlActivating", "AFXDLGS/CFileDialog::OnFileNameChange", "AFXDLGS/CFileDialog::OnFileNameOK", "AFXDLGS/CFileDialog::OnFolderChange", "AFXDLGS/CFileDialog::OnInitDone", "AFXDLGS/CFileDialog::OnItemSelected", "AFXDLGS/CFileDialog::OnLBSelChangedNotify", "AFXDLGS/CFileDialog::OnShareViolation", "AFXDLGS/CFileDialog::OnTypeChange", "AFXDLGS/CFileDialog::m_ofn"] helpviewer_keywords: ["CFileDialog [MFC], CFileDialog", "CFileDialog [MFC], AddCheckButton", "CFileDialog [MFC], AddComboBox", "CFileDialog [MFC], AddControlItem", "CFileDialog [MFC], AddEditBox", "CFileDialog [MFC], AddMenu", "CFileDialog [MFC], AddPlace", "CFileDialog [MFC], AddPushButton", "CFileDialog [MFC], AddRadioButtonList", "CFileDialog [MFC], AddSeparator", "CFileDialog [MFC], AddText", "CFileDialog [MFC], ApplyOFNToShellDialog", "CFileDialog [MFC], DoModal", "CFileDialog [MFC], EnableOpenDropDown", "CFileDialog [MFC], EndVisualGroup", "CFileDialog [MFC], GetCheckButtonState", "CFileDialog [MFC], GetControlItemState", "CFileDialog [MFC], GetControlState", "CFileDialog [MFC], GetEditBoxText", "CFileDialog [MFC], GetFileExt", "CFileDialog [MFC], GetFileName", "CFileDialog [MFC], GetFileTitle", "CFileDialog [MFC], GetFolderPath", "CFileDialog [MFC], GetIFileDialogCustomize", "CFileDialog [MFC], GetIFileOpenDialog", "CFileDialog [MFC], GetIFileSaveDialog", "CFileDialog [MFC], GetNextPathName", "CFileDialog [MFC], GetOFN", "CFileDialog [MFC], GetPathName", "CFileDialog [MFC], GetReadOnlyPref", "CFileDialog [MFC], GetResult", "CFileDialog [MFC], GetResults", "CFileDialog [MFC], GetSelectedControlItem", "CFileDialog [MFC], GetStartPosition", "CFileDialog [MFC], HideControl", "CFileDialog [MFC], IsPickFoldersMode", "CFileDialog [MFC], MakeProminent", "CFileDialog [MFC], RemoveControlItem", "CFileDialog [MFC], SetCheckButtonState", "CFileDialog [MFC], SetControlItemState", "CFileDialog [MFC], SetControlItemText", "CFileDialog [MFC], SetControlLabel", "CFileDialog [MFC], SetControlState", "CFileDialog [MFC], SetControlText", "CFileDialog [MFC], SetDefExt", "CFileDialog [MFC], SetEditBoxText", "CFileDialog [MFC], SetProperties", "CFileDialog [MFC], SetSelectedControlItem", "CFileDialog [MFC], SetTemplate", "CFileDialog [MFC], StartVisualGroup", "CFileDialog [MFC], UpdateOFNFromShellDialog", "CFileDialog [MFC], OnButtonClicked", "CFileDialog [MFC], OnCheckButtonToggled", "CFileDialog [MFC], OnControlActivating", "CFileDialog [MFC], OnFileNameChange", "CFileDialog [MFC], OnFileNameOK", "CFileDialog [MFC], OnFolderChange", "CFileDialog [MFC], OnInitDone", "CFileDialog [MFC], OnItemSelected", "CFileDialog [MFC], OnLBSelChangedNotify", "CFileDialog [MFC], OnShareViolation", "CFileDialog [MFC], OnTypeChange", "CFileDialog [MFC], m_ofn"] -ms.assetid: fda4fd3c-08b8-4ce0-8e9d-7bab23f8c6c0 --- # CFileDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates the common dialog box that is used for file open or file save operations. ## Syntax diff --git a/docs/mfc/reference/cfileexception-class.md b/docs/mfc/reference/cfileexception-class.md index 4f5bd0c822c..a69119c7834 100644 --- a/docs/mfc/reference/cfileexception-class.md +++ b/docs/mfc/reference/cfileexception-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CFileException [MFC], CFileException", "CFileException [M --- # `CFileException` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a file-related exception condition. ## Syntax diff --git a/docs/mfc/reference/cfilefind-class.md b/docs/mfc/reference/cfilefind-class.md index aabf078c761..01edcb95523 100644 --- a/docs/mfc/reference/cfilefind-class.md +++ b/docs/mfc/reference/cfilefind-class.md @@ -4,10 +4,12 @@ title: "CFileFind Class" ms.date: "11/04/2016" f1_keywords: ["CFileFind", "AFX/CFileFind", "AFX/CFileFind::CFileFind", "AFX/CFileFind::Close", "AFX/CFileFind::FindFile", "AFX/CFileFind::FindNextFile", "AFX/CFileFind::GetCreationTime", "AFX/CFileFind::GetFileName", "AFX/CFileFind::GetFilePath", "AFX/CFileFind::GetFileTitle", "AFX/CFileFind::GetFileURL", "AFX/CFileFind::GetLastAccessTime", "AFX/CFileFind::GetLastWriteTime", "AFX/CFileFind::GetLength", "AFX/CFileFind::GetRoot", "AFX/CFileFind::IsArchived", "AFX/CFileFind::IsCompressed", "AFX/CFileFind::IsDirectory", "AFX/CFileFind::IsDots", "AFX/CFileFind::IsHidden", "AFX/CFileFind::IsNormal", "AFX/CFileFind::IsReadOnly", "AFX/CFileFind::IsSystem", "AFX/CFileFind::IsTemporary", "AFX/CFileFind::MatchesMask", "AFX/CFileFind::CloseContext", "AFX/CFileFind::m_pTM"] helpviewer_keywords: ["CFileFind [MFC], CFileFind", "CFileFind [MFC], Close", "CFileFind [MFC], FindFile", "CFileFind [MFC], FindNextFile", "CFileFind [MFC], GetCreationTime", "CFileFind [MFC], GetFileName", "CFileFind [MFC], GetFilePath", "CFileFind [MFC], GetFileTitle", "CFileFind [MFC], GetFileURL", "CFileFind [MFC], GetLastAccessTime", "CFileFind [MFC], GetLastWriteTime", "CFileFind [MFC], GetLength", "CFileFind [MFC], GetRoot", "CFileFind [MFC], IsArchived", "CFileFind [MFC], IsCompressed", "CFileFind [MFC], IsDirectory", "CFileFind [MFC], IsDots", "CFileFind [MFC], IsHidden", "CFileFind [MFC], IsNormal", "CFileFind [MFC], IsReadOnly", "CFileFind [MFC], IsSystem", "CFileFind [MFC], IsTemporary", "CFileFind [MFC], MatchesMask", "CFileFind [MFC], CloseContext", "CFileFind [MFC], m_pTM"] -ms.assetid: 9990068c-b023-4114-9580-a50182d15240 --- # `CFileFind` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Performs local file searches and is the base class for [`CGopherFileFind`](../../mfc/reference/cgopherfilefind-class.md) and [`CFtpFileFind`](../../mfc/reference/cftpfilefind-class.md), which perform Internet file searches. ## Syntax diff --git a/docs/mfc/reference/cfindreplacedialog-class.md b/docs/mfc/reference/cfindreplacedialog-class.md index e24c9f2471d..bb106ba948c 100644 --- a/docs/mfc/reference/cfindreplacedialog-class.md +++ b/docs/mfc/reference/cfindreplacedialog-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CFindReplaceDialog [MFC], CFindReplaceDialog", "CFindRepl --- # CFindReplaceDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allows you to implement standard string Find/Replace dialog boxes in your application. ## Syntax diff --git a/docs/mfc/reference/cfolderpickerdialog-class.md b/docs/mfc/reference/cfolderpickerdialog-class.md index de4f2750fa3..3e416178867 100644 --- a/docs/mfc/reference/cfolderpickerdialog-class.md +++ b/docs/mfc/reference/cfolderpickerdialog-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CFolderPickerDialog [MFC], CFolderPickerDialog"] --- # `CFolderPickerDialog` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CFolderPickerDialog` class implements `CFileDialog` in the folder picker mode. ## Syntax diff --git a/docs/mfc/reference/cfont-class.md b/docs/mfc/reference/cfont-class.md index 6a91e72bb95..c16e20c74d1 100644 --- a/docs/mfc/reference/cfont-class.md +++ b/docs/mfc/reference/cfont-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CFont [MFC], CFont", "CFont [MFC], CreateFont", "CFont [M --- # `CFont` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates a Windows graphics device interface (GDI) font and provides member functions for manipulating the font. ## Syntax diff --git a/docs/mfc/reference/cfontdialog-class.md b/docs/mfc/reference/cfontdialog-class.md index 175c1d1978c..277855afb50 100644 --- a/docs/mfc/reference/cfontdialog-class.md +++ b/docs/mfc/reference/cfontdialog-class.md @@ -4,10 +4,12 @@ title: "CFontDialog Class" ms.date: "11/04/2016" f1_keywords: ["CFontDialog", "AFXDLGS/CFontDialog", "AFXDLGS/CFontDialog::CFontDialog", "AFXDLGS/CFontDialog::DoModal", "AFXDLGS/CFontDialog::GetCharFormat", "AFXDLGS/CFontDialog::GetColor", "AFXDLGS/CFontDialog::GetCurrentFont", "AFXDLGS/CFontDialog::GetFaceName", "AFXDLGS/CFontDialog::GetSize", "AFXDLGS/CFontDialog::GetStyleName", "AFXDLGS/CFontDialog::GetWeight", "AFXDLGS/CFontDialog::IsBold", "AFXDLGS/CFontDialog::IsItalic", "AFXDLGS/CFontDialog::IsStrikeOut", "AFXDLGS/CFontDialog::IsUnderline", "AFXDLGS/CFontDialog::m_cf"] helpviewer_keywords: ["CFontDialog [MFC], CFontDialog", "CFontDialog [MFC], DoModal", "CFontDialog [MFC], GetCharFormat", "CFontDialog [MFC], GetColor", "CFontDialog [MFC], GetCurrentFont", "CFontDialog [MFC], GetFaceName", "CFontDialog [MFC], GetSize", "CFontDialog [MFC], GetStyleName", "CFontDialog [MFC], GetWeight", "CFontDialog [MFC], IsBold", "CFontDialog [MFC], IsItalic", "CFontDialog [MFC], IsStrikeOut", "CFontDialog [MFC], IsUnderline", "CFontDialog [MFC], m_cf"] -ms.assetid: 6228d500-ed0f-4156-81e5-ab0d57d1dcf4 --- # CFontDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allows you to incorporate a font-selection dialog box into your application. ## Syntax diff --git a/docs/mfc/reference/cfontholder-class.md b/docs/mfc/reference/cfontholder-class.md index 793af5a5496..22a1b18a28f 100644 --- a/docs/mfc/reference/cfontholder-class.md +++ b/docs/mfc/reference/cfontholder-class.md @@ -4,10 +4,12 @@ title: "CFontHolder Class" ms.date: "11/04/2016" f1_keywords: ["CFontHolder", "AFXCTL/CFontHolder", "AFXCTL/CFontHolder::CFontHolder", "AFXCTL/CFontHolder::GetDisplayString", "AFXCTL/CFontHolder::GetFontDispatch", "AFXCTL/CFontHolder::GetFontHandle", "AFXCTL/CFontHolder::InitializeFont", "AFXCTL/CFontHolder::QueryTextMetrics", "AFXCTL/CFontHolder::ReleaseFont", "AFXCTL/CFontHolder::Select", "AFXCTL/CFontHolder::SetFont", "AFXCTL/CFontHolder::m_pFont"] helpviewer_keywords: ["CFontHolder [MFC], CFontHolder", "CFontHolder [MFC], GetDisplayString", "CFontHolder [MFC], GetFontDispatch", "CFontHolder [MFC], GetFontHandle", "CFontHolder [MFC], InitializeFont", "CFontHolder [MFC], QueryTextMetrics", "CFontHolder [MFC], ReleaseFont", "CFontHolder [MFC], Select", "CFontHolder [MFC], SetFont", "CFontHolder [MFC], m_pFont"] -ms.assetid: 728ab472-0c97-440d-889f-1324c6e1b6b8 --- # CFontHolder Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the stock Font property and encapsulates the functionality of a Windows font object and the `IFont` interface. ## Syntax diff --git a/docs/mfc/reference/cformview-class.md b/docs/mfc/reference/cformview-class.md index cb84a87b8d5..97aeaa9ffc6 100644 --- a/docs/mfc/reference/cformview-class.md +++ b/docs/mfc/reference/cformview-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CFormView [MFC], CFormView", "CFormView [MFC], IsInitDlgC --- # `CFormView` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class used for form views. ## Syntax diff --git a/docs/mfc/reference/cframewnd-class.md b/docs/mfc/reference/cframewnd-class.md index 670db48714c..633733e9f7b 100644 --- a/docs/mfc/reference/cframewnd-class.md +++ b/docs/mfc/reference/cframewnd-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CFrameWnd [MFC], CFrameWnd", "CFrameWnd [MFC], ActivateFr --- # `CFrameWnd` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of a Windows single document interface (SDI) overlapped or pop-up frame window, along with members for managing the window. ## Syntax diff --git a/docs/mfc/reference/cframewndex-class.md b/docs/mfc/reference/cframewndex-class.md index 6c54057b898..8447320700c 100644 --- a/docs/mfc/reference/cframewndex-class.md +++ b/docs/mfc/reference/cframewndex-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CFrameWndEx [MFC], ActiveItemRecalcLayout", "CFrameWndEx --- # `CFrameWndEx` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements the functionality of a Windows single document interface (SDI) overlapped or popup frame window, and provides members for managing the window. It extends the [`CFrameWnd`](../../mfc/reference/cframewnd-class.md) class. ## Syntax diff --git a/docs/mfc/reference/cftpconnection-class.md b/docs/mfc/reference/cftpconnection-class.md index aae3de670a4..6f1606040cb 100644 --- a/docs/mfc/reference/cftpconnection-class.md +++ b/docs/mfc/reference/cftpconnection-class.md @@ -4,10 +4,12 @@ title: "CFtpConnection Class" ms.date: "08/29/2019" f1_keywords: ["CFtpConnection", "AFXINET/CFtpConnection", "AFXINET/CFtpConnection::CFtpConnection", "AFXINET/CFtpConnection::Command", "AFXINET/CFtpConnection::CreateDirectory", "AFXINET/CFtpConnection::GetCurrentDirectory", "AFXINET/CFtpConnection::GetCurrentDirectoryAsURL", "AFXINET/CFtpConnection::GetFile", "AFXINET/CFtpConnection::OpenFile", "AFXINET/CFtpConnection::PutFile", "AFXINET/CFtpConnection::Remove", "AFXINET/CFtpConnection::RemoveDirectory", "AFXINET/CFtpConnection::Rename", "AFXINET/CFtpConnection::SetCurrentDirectory"] helpviewer_keywords: ["CFtpConnection [MFC], CFtpConnection", "CFtpConnection [MFC], Command", "CFtpConnection [MFC], CreateDirectory", "CFtpConnection [MFC], GetCurrentDirectory", "CFtpConnection [MFC], GetCurrentDirectoryAsURL", "CFtpConnection [MFC], GetFile", "CFtpConnection [MFC], OpenFile", "CFtpConnection [MFC], PutFile", "CFtpConnection [MFC], Remove", "CFtpConnection [MFC], RemoveDirectory", "CFtpConnection [MFC], Rename", "CFtpConnection [MFC], SetCurrentDirectory"] -ms.assetid: 5e3a0501-8893-49cf-a3d5-0628d8d6b936 --- # CFtpConnection Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages your FTP connection to an Internet server and allows direct manipulation of directories and files on that server. ## Syntax diff --git a/docs/mfc/reference/cftpfilefind-class.md b/docs/mfc/reference/cftpfilefind-class.md index f43026aff12..33966e135c9 100644 --- a/docs/mfc/reference/cftpfilefind-class.md +++ b/docs/mfc/reference/cftpfilefind-class.md @@ -4,10 +4,12 @@ title: "CFtpFileFind Class" ms.date: "05/28/2020" f1_keywords: ["CFtpFileFind", "AFXINET/CFtpFileFind", "AFXINET/CFtpFileFind::CFtpFileFind", "AFXINET/CFtpFileFind::FindFile", "AFXINET/CFtpFileFind::FindNextFile", "AFXINET/CFtpFileFind::GetFileURL"] helpviewer_keywords: ["CFtpFileFind [MFC], CFtpFileFind", "CFtpFileFind [MFC], FindFile", "CFtpFileFind [MFC], FindNextFile", "CFtpFileFind [MFC], GetFileURL"] -ms.assetid: 9667cf01-657f-4b11-b9db-f11e5a7b4e4c --- # CFtpFileFind Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Aids in Internet file searches of FTP servers. ## Syntax diff --git a/docs/mfc/reference/cgdiobject-class.md b/docs/mfc/reference/cgdiobject-class.md index ff6dde45220..ab134f376d1 100644 --- a/docs/mfc/reference/cgdiobject-class.md +++ b/docs/mfc/reference/cgdiobject-class.md @@ -4,10 +4,12 @@ title: "CGdiObject Class" ms.date: "11/04/2016" f1_keywords: ["CGdiObject", "AFXWIN/CGdiObject", "AFXWIN/CGdiObject::CGdiObject", "AFXWIN/CGdiObject::Attach", "AFXWIN/CGdiObject::CreateStockObject", "AFXWIN/CGdiObject::DeleteObject", "AFXWIN/CGdiObject::DeleteTempMap", "AFXWIN/CGdiObject::Detach", "AFXWIN/CGdiObject::FromHandle", "AFXWIN/CGdiObject::GetObject", "AFXWIN/CGdiObject::GetObjectType", "AFXWIN/CGdiObject::GetSafeHandle", "AFXWIN/CGdiObject::UnrealizeObject", "AFXWIN/CGdiObject::m_hObject"] helpviewer_keywords: ["CGdiObject [MFC], CGdiObject", "CGdiObject [MFC], Attach", "CGdiObject [MFC], CreateStockObject", "CGdiObject [MFC], DeleteObject", "CGdiObject [MFC], DeleteTempMap", "CGdiObject [MFC], Detach", "CGdiObject [MFC], FromHandle", "CGdiObject [MFC], GetObject", "CGdiObject [MFC], GetObjectType", "CGdiObject [MFC], GetSafeHandle", "CGdiObject [MFC], UnrealizeObject", "CGdiObject [MFC], m_hObject"] -ms.assetid: 1cba3ba5-3d49-4e43-8293-209299f2f6f4 --- # CGdiObject Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides a base class for various kinds of Windows graphics device interface (GDI) objects such as bitmaps, regions, brushes, pens, palettes, and fonts. ## Syntax diff --git a/docs/mfc/reference/cglobalutils-class.md b/docs/mfc/reference/cglobalutils-class.md index 55f11e6089d..ddfb73146e3 100644 --- a/docs/mfc/reference/cglobalutils-class.md +++ b/docs/mfc/reference/cglobalutils-class.md @@ -4,10 +4,12 @@ title: "CGlobalUtils Class" ms.date: "10/18/2018" f1_keywords: ["CGlobalUtils", "AFXGLOBALUTILS/CGlobalUtils", "AFXGLOBALUTILS/CGlobalUtils::AdjustRectToWorkArea", "AFXGLOBALUTILS/CGlobalUtils::CalcExpectedDockedRect", "AFXGLOBALUTILS/CGlobalUtils::CanBeAttached", "AFXGLOBALUTILS/CGlobalUtils::CanPaneBeInFloatingMultiPaneFrameWnd", "AFXGLOBALUTILS/CGlobalUtils::CheckAlignment", "AFXGLOBALUTILS/CGlobalUtils::CyFromString", "AFXGLOBALUTILS/CGlobalUtils::DecimalFromString", "AFXGLOBALUTILS/CGlobalUtils::FlipRect", "AFXGLOBALUTILS/CGlobalUtils::ForceAdjustLayout", "AFXGLOBALUTILS/CGlobalUtils::GetDockingManager", "AFXGLOBALUTILS/CGlobalUtils::GetOppositeAlignment", "AFXGLOBALUTILS/CGlobalUtils::GetPaneAndAlignFromPoint", "AFXGLOBALUTILS/CGlobalUtils::GetWndIcon", "AFXGLOBALUTILS/CGlobalUtils::SetNewParent", "AFXGLOBALUTILS/CGlobalUtils::StringFromCy", "AFXGLOBALUTILS/CGlobalUtils::StringFromDecimal"] helpviewer_keywords: ["CGlobalUtils [MFC], AdjustRectToWorkArea", "CGlobalUtils [MFC], CalcExpectedDockedRect", "CGlobalUtils [MFC], CanBeAttached", "CGlobalUtils [MFC], CanPaneBeInFloatingMultiPaneFrameWnd", "CGlobalUtils [MFC], CheckAlignment", "CGlobalUtils [MFC], CyFromString", "CGlobalUtils [MFC], DecimalFromString", "CGlobalUtils [MFC], FlipRect", "CGlobalUtils [MFC], ForceAdjustLayout", "CGlobalUtils [MFC], GetDockingManager", "CGlobalUtils [MFC], GetOppositeAlignment", "CGlobalUtils [MFC], GetPaneAndAlignFromPoint", "CGlobalUtils [MFC], GetWndIcon", "CGlobalUtils [MFC], SetNewParent", "CGlobalUtils [MFC], StringFromCy", "CGlobalUtils [MFC], StringFromDecimal"] -ms.assetid: 2c5bd1a6-f80c-4e79-a476-b4ceebabfb2f --- # CGlobalUtils Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. ## Syntax diff --git a/docs/mfc/reference/cgopherconnection-class.md b/docs/mfc/reference/cgopherconnection-class.md index d05ead9a3a2..d6c587237d0 100644 --- a/docs/mfc/reference/cgopherconnection-class.md +++ b/docs/mfc/reference/cgopherconnection-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CGopherConnection [MFC], CGopherConnection", "CGopherConn --- # CGopherConnection Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages your connection to a gopher Internet server. > [!NOTE] diff --git a/docs/mfc/reference/cgopherfile-class.md b/docs/mfc/reference/cgopherfile-class.md index 8d384db4c31..23dd44f2693 100644 --- a/docs/mfc/reference/cgopherfile-class.md +++ b/docs/mfc/reference/cgopherfile-class.md @@ -4,10 +4,12 @@ title: "CGopherFile Class" ms.date: "11/04/2016" f1_keywords: ["CGopherFile", "AFXINET/CGopherFile", "AFXINET/CGopherFile::CGopherFile"] helpviewer_keywords: ["CGopherFile [MFC], CGopherFile"] -ms.assetid: 3ca9898f-8cdb-4495-bbde-46d40100feda --- # CGopherFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality to find and read files on a gopher server. > [!NOTE] diff --git a/docs/mfc/reference/cgopherfilefind-class.md b/docs/mfc/reference/cgopherfilefind-class.md index ef0ffada189..47ad8e86a51 100644 --- a/docs/mfc/reference/cgopherfilefind-class.md +++ b/docs/mfc/reference/cgopherfilefind-class.md @@ -4,10 +4,12 @@ title: "CGopherFileFind Class" ms.date: "11/04/2016" f1_keywords: ["CGopherFileFind", "AFXINET/CGopherFileFind", "AFXINET/CGopherFileFind::CGopherFileFind", "AFXINET/CGopherFileFind::FindFile", "AFXINET/CGopherFileFind::FindNextFile", "AFXINET/CGopherFileFind::GetCreationTime", "AFXINET/CGopherFileFind::GetLastAccessTime", "AFXINET/CGopherFileFind::GetLastWriteTime", "AFXINET/CGopherFileFind::GetLength", "AFXINET/CGopherFileFind::GetLocator", "AFXINET/CGopherFileFind::GetScreenName", "AFXINET/CGopherFileFind::IsDots"] helpviewer_keywords: ["CGopherFileFind [MFC], CGopherFileFind", "CGopherFileFind [MFC], FindFile", "CGopherFileFind [MFC], FindNextFile", "CGopherFileFind [MFC], GetCreationTime", "CGopherFileFind [MFC], GetLastAccessTime", "CGopherFileFind [MFC], GetLastWriteTime", "CGopherFileFind [MFC], GetLength", "CGopherFileFind [MFC], GetLocator", "CGopherFileFind [MFC], GetScreenName", "CGopherFileFind [MFC], IsDots"] -ms.assetid: 8465a979-6323-496d-ab4b-e81383fb999d --- # CGopherFileFind Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Aids in Internet file searches of gopher servers. > [!NOTE] diff --git a/docs/mfc/reference/cgopherlocator-class.md b/docs/mfc/reference/cgopherlocator-class.md index e7d981dba71..aa39d685fbd 100644 --- a/docs/mfc/reference/cgopherlocator-class.md +++ b/docs/mfc/reference/cgopherlocator-class.md @@ -4,10 +4,12 @@ title: "CGopherLocator Class" ms.date: "11/04/2016" f1_keywords: ["CGopherLocator", "AFXINET/CGopherLocator", "AFXINET/CGopherLocator::CGopherLocator", "AFXINET/CGopherLocator::GetLocatorType"] helpviewer_keywords: ["CGopherLocator [MFC], CGopherLocator", "CGopherLocator [MFC], GetLocatorType"] -ms.assetid: 6fcc015f-5ae6-4959-b936-858634c71019 --- # CGopherLocator Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Gets a gopher "locator" from a gopher server, determines the locator's type, and makes the locator available to [CGopherFileFind](../../mfc/reference/cgopherfilefind-class.md). > [!NOTE] diff --git a/docs/mfc/reference/cheaderctrl-class.md b/docs/mfc/reference/cheaderctrl-class.md index 3287d1ab18a..8ded47a365a 100644 --- a/docs/mfc/reference/cheaderctrl-class.md +++ b/docs/mfc/reference/cheaderctrl-class.md @@ -4,10 +4,12 @@ title: "CHeaderCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CHeaderCtrl", "AFXCMN/CHeaderCtrl", "AFXCMN/CHeaderCtrl::CHeaderCtrl", "AFXCMN/CHeaderCtrl::ClearAllFilters", "AFXCMN/CHeaderCtrl::ClearFilter", "AFXCMN/CHeaderCtrl::Create", "AFXCMN/CHeaderCtrl::CreateDragImage", "AFXCMN/CHeaderCtrl::CreateEx", "AFXCMN/CHeaderCtrl::DeleteItem", "AFXCMN/CHeaderCtrl::DrawItem", "AFXCMN/CHeaderCtrl::EditFilter", "AFXCMN/CHeaderCtrl::GetBitmapMargin", "AFXCMN/CHeaderCtrl::GetFocusedItem", "AFXCMN/CHeaderCtrl::GetImageList", "AFXCMN/CHeaderCtrl::GetItem", "AFXCMN/CHeaderCtrl::GetItemCount", "AFXCMN/CHeaderCtrl::GetItemDropDownRect", "AFXCMN/CHeaderCtrl::GetItemRect", "AFXCMN/CHeaderCtrl::GetOrderArray", "AFXCMN/CHeaderCtrl::GetOverflowRect", "AFXCMN/CHeaderCtrl::HitTest", "AFXCMN/CHeaderCtrl::InsertItem", "AFXCMN/CHeaderCtrl::Layout", "AFXCMN/CHeaderCtrl::OrderToIndex", "AFXCMN/CHeaderCtrl::SetBitmapMargin", "AFXCMN/CHeaderCtrl::SetFilterChangeTimeout", "AFXCMN/CHeaderCtrl::SetFocusedItem", "AFXCMN/CHeaderCtrl::SetHotDivider", "AFXCMN/CHeaderCtrl::SetImageList", "AFXCMN/CHeaderCtrl::SetItem", "AFXCMN/CHeaderCtrl::SetOrderArray"] helpviewer_keywords: ["CHeaderCtrl [MFC], CHeaderCtrl", "CHeaderCtrl [MFC], ClearAllFilters", "CHeaderCtrl [MFC], ClearFilter", "CHeaderCtrl [MFC], Create", "CHeaderCtrl [MFC], CreateDragImage", "CHeaderCtrl [MFC], CreateEx", "CHeaderCtrl [MFC], DeleteItem", "CHeaderCtrl [MFC], DrawItem", "CHeaderCtrl [MFC], EditFilter", "CHeaderCtrl [MFC], GetBitmapMargin", "CHeaderCtrl [MFC], GetFocusedItem", "CHeaderCtrl [MFC], GetImageList", "CHeaderCtrl [MFC], GetItem", "CHeaderCtrl [MFC], GetItemCount", "CHeaderCtrl [MFC], GetItemDropDownRect", "CHeaderCtrl [MFC], GetItemRect", "CHeaderCtrl [MFC], GetOrderArray", "CHeaderCtrl [MFC], GetOverflowRect", "CHeaderCtrl [MFC], HitTest", "CHeaderCtrl [MFC], InsertItem", "CHeaderCtrl [MFC], Layout", "CHeaderCtrl [MFC], OrderToIndex", "CHeaderCtrl [MFC], SetBitmapMargin", "CHeaderCtrl [MFC], SetFilterChangeTimeout", "CHeaderCtrl [MFC], SetFocusedItem", "CHeaderCtrl [MFC], SetHotDivider", "CHeaderCtrl [MFC], SetImageList", "CHeaderCtrl [MFC], SetItem", "CHeaderCtrl [MFC], SetOrderArray"] -ms.assetid: b847ac90-5fae-4a87-88e0-ca45f77b8b3b --- # CHeaderCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common header control. ## Syntax diff --git a/docs/mfc/reference/child-window-notification-message-handlers.md b/docs/mfc/reference/child-window-notification-message-handlers.md index 46654fcf608..318b2f6e6ae 100644 --- a/docs/mfc/reference/child-window-notification-message-handlers.md +++ b/docs/mfc/reference/child-window-notification-message-handlers.md @@ -4,10 +4,12 @@ title: "Child Window Notification Message Handlers" ms.date: "11/04/2016" f1_keywords: ["ChildWindow"] helpviewer_keywords: ["message handlers [MFC]", "message handling [MFC], child window message handlers", "notifications [MFC], child window messages", "windows [MFC], message handlers", "child windows [MFC], messages"] -ms.assetid: fddfdd08-8ecf-4f84-8b45-5a84616aaa8d --- # Child Window Notification Message Handlers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + There are five categories of child window notification messages: |Category|Description| diff --git a/docs/mfc/reference/chotkeyctrl-class.md b/docs/mfc/reference/chotkeyctrl-class.md index a442cd26c68..8b855d2303d 100644 --- a/docs/mfc/reference/chotkeyctrl-class.md +++ b/docs/mfc/reference/chotkeyctrl-class.md @@ -4,10 +4,12 @@ title: "CHotKeyCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CHotKeyCtrl", "AFXCMN/CHotKeyCtrl", "AFXCMN/CHotKeyCtrl::CHotKeyCtrl", "AFXCMN/CHotKeyCtrl::Create", "AFXCMN/CHotKeyCtrl::CreateEx", "AFXCMN/CHotKeyCtrl::GetHotKey", "AFXCMN/CHotKeyCtrl::GetHotKeyName", "AFXCMN/CHotKeyCtrl::GetKeyName", "AFXCMN/CHotKeyCtrl::SetHotKey", "AFXCMN/CHotKeyCtrl::SetRules"] helpviewer_keywords: ["CHotKeyCtrl [MFC], CHotKeyCtrl", "CHotKeyCtrl [MFC], Create", "CHotKeyCtrl [MFC], CreateEx", "CHotKeyCtrl [MFC], GetHotKey", "CHotKeyCtrl [MFC], GetHotKeyName", "CHotKeyCtrl [MFC], GetKeyName", "CHotKeyCtrl [MFC], SetHotKey", "CHotKeyCtrl [MFC], SetRules"] -ms.assetid: 896f9766-0718-4f58-aab2-20325e118ca6 --- # CHotKeyCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common hot key control. ## Syntax diff --git a/docs/mfc/reference/chtmleditctrl-class.md b/docs/mfc/reference/chtmleditctrl-class.md index 6a7e7c8c2a4..547bf0c9771 100644 --- a/docs/mfc/reference/chtmleditctrl-class.md +++ b/docs/mfc/reference/chtmleditctrl-class.md @@ -4,10 +4,12 @@ title: "CHtmlEditCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CHtmlEditCtrl", "AFXHTML/CHtmlEditCtrl", "AFXHTML/CHtmlEditCtrl::CHtmlEditCtrl", "AFXHTML/CHtmlEditCtrl::Create", "AFXHTML/CHtmlEditCtrl::GetDHtmlDocument", "AFXHTML/CHtmlEditCtrl::GetStartDocument"] helpviewer_keywords: ["CHtmlEditCtrl [MFC], CHtmlEditCtrl", "CHtmlEditCtrl [MFC], Create", "CHtmlEditCtrl [MFC], GetDHtmlDocument", "CHtmlEditCtrl [MFC], GetStartDocument"] -ms.assetid: 0fc4a238-b05f-4874-9edc-6a6701f064d9 --- # CHtmlEditCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the WebBrowser ActiveX control in an MFC window. ## Syntax diff --git a/docs/mfc/reference/chtmleditctrlbase-class.md b/docs/mfc/reference/chtmleditctrlbase-class.md index 084f3f0bed7..e092aa41d3f 100644 --- a/docs/mfc/reference/chtmleditctrlbase-class.md +++ b/docs/mfc/reference/chtmleditctrlbase-class.md @@ -4,10 +4,12 @@ title: "CHtmlEditCtrlBase Class" ms.date: "11/04/2016" f1_keywords: ["CHtmlEditCtrlBase", "AFXHTML/CHtmlEditCtrlBase", "AFXHTML/CHtmlEditCtrlBase::AddToGlyphTable", "AFXHTML/CHtmlEditCtrlBase::Bold", "AFXHTML/CHtmlEditCtrlBase::Button", "AFXHTML/CHtmlEditCtrlBase::CheckBox", "AFXHTML/CHtmlEditCtrlBase::ClearSelection", "AFXHTML/CHtmlEditCtrlBase::Copy", "AFXHTML/CHtmlEditCtrlBase::Cut", "AFXHTML/CHtmlEditCtrlBase::Delete", "AFXHTML/CHtmlEditCtrlBase::DropDownBox", "AFXHTML/CHtmlEditCtrlBase::EmptyGlyphTable", "AFXHTML/CHtmlEditCtrlBase::ExecCommand", "AFXHTML/CHtmlEditCtrlBase::Font", "AFXHTML/CHtmlEditCtrlBase::GetAbsolutePosition", "AFXHTML/CHtmlEditCtrlBase::GetBackColor", "AFXHTML/CHtmlEditCtrlBase::GetBlockFormat", "AFXHTML/CHtmlEditCtrlBase::GetBlockFormatNames", "AFXHTML/CHtmlEditCtrlBase::GetBookMark", "AFXHTML/CHtmlEditCtrlBase::GetDocument", "AFXHTML/CHtmlEditCtrlBase::GetDocumentHTML", "AFXHTML/CHtmlEditCtrlBase::GetDocumentTitle", "AFXHTML/CHtmlEditCtrlBase::GetEvent", "AFXHTML/CHtmlEditCtrlBase::GetEventSrcElement", "AFXHTML/CHtmlEditCtrlBase::GetFontFace", "AFXHTML/CHtmlEditCtrlBase::GetFontSize", "AFXHTML/CHtmlEditCtrlBase::GetForeColor", "AFXHTML/CHtmlEditCtrlBase::GetFrameZone", "AFXHTML/CHtmlEditCtrlBase::GetIsDirty", "AFXHTML/CHtmlEditCtrlBase::GetShowAlignedSiteTags", "AFXHTML/CHtmlEditCtrlBase::GetShowAllTags", "AFXHTML/CHtmlEditCtrlBase::GetShowAreaTags", "AFXHTML/CHtmlEditCtrlBase::GetShowBRTags", "AFXHTML/CHtmlEditCtrlBase::GetShowCommentTags", "AFXHTML/CHtmlEditCtrlBase::GetShowMiscTags", "AFXHTML/CHtmlEditCtrlBase::GetShowScriptTags", "AFXHTML/CHtmlEditCtrlBase::GetShowStyleTags", "AFXHTML/CHtmlEditCtrlBase::GetShowUnknownTags", "AFXHTML/CHtmlEditCtrlBase::HorizontalLine", "AFXHTML/CHtmlEditCtrlBase::HyperLink", "AFXHTML/CHtmlEditCtrlBase::IE50Paste", "AFXHTML/CHtmlEditCtrlBase::Iframe", "AFXHTML/CHtmlEditCtrlBase::Image", "AFXHTML/CHtmlEditCtrlBase::Indent", "AFXHTML/CHtmlEditCtrlBase::InsFieldSet", "AFXHTML/CHtmlEditCtrlBase::InsInputButton", "AFXHTML/CHtmlEditCtrlBase::InsInputHidden", "AFXHTML/CHtmlEditCtrlBase::InsInputImage", "AFXHTML/CHtmlEditCtrlBase::InsInputPassword", "AFXHTML/CHtmlEditCtrlBase::InsInputReset", "AFXHTML/CHtmlEditCtrlBase::InsInputSubmit", "AFXHTML/CHtmlEditCtrlBase::InsInputUpload", "AFXHTML/CHtmlEditCtrlBase::Is1DElement", "AFXHTML/CHtmlEditCtrlBase::Is2DElement", "AFXHTML/CHtmlEditCtrlBase::Italic", "AFXHTML/CHtmlEditCtrlBase::JustifyCenter", "AFXHTML/CHtmlEditCtrlBase::JustifyLeft", "AFXHTML/CHtmlEditCtrlBase::JustifyRight", "AFXHTML/CHtmlEditCtrlBase::ListBox", "AFXHTML/CHtmlEditCtrlBase::Marquee", "AFXHTML/CHtmlEditCtrlBase::NewDocument", "AFXHTML/CHtmlEditCtrlBase::OrderList", "AFXHTML/CHtmlEditCtrlBase::Outdent", "AFXHTML/CHtmlEditCtrlBase::Paragraph", "AFXHTML/CHtmlEditCtrlBase::Paste", "AFXHTML/CHtmlEditCtrlBase::PrintDocument", "AFXHTML/CHtmlEditCtrlBase::PrintPreview", "AFXHTML/CHtmlEditCtrlBase::QueryStatus", "AFXHTML/CHtmlEditCtrlBase::RadioButton", "AFXHTML/CHtmlEditCtrlBase::RefreshDocument", "AFXHTML/CHtmlEditCtrlBase::RemoveFormat", "AFXHTML/CHtmlEditCtrlBase::SaveAs", "AFXHTML/CHtmlEditCtrlBase::SelectAll", "AFXHTML/CHtmlEditCtrlBase::Set2DPosition", "AFXHTML/CHtmlEditCtrlBase::SetAbsolutePosition", "AFXHTML/CHtmlEditCtrlBase::SetAtomicSelection", "AFXHTML/CHtmlEditCtrlBase::SetAutoURLDetectMode", "AFXHTML/CHtmlEditCtrlBase::SetBackColor", "AFXHTML/CHtmlEditCtrlBase::SetBlockFormat", "AFXHTML/CHtmlEditCtrlBase::SetBookMark", "AFXHTML/CHtmlEditCtrlBase::SetCSSEditingLevel", "AFXHTML/CHtmlEditCtrlBase::SetDefaultComposeSettings", "AFXHTML/CHtmlEditCtrlBase::SetDesignMode", "AFXHTML/CHtmlEditCtrlBase::SetDisableEditFocusUI", "AFXHTML/CHtmlEditCtrlBase::SetDocumentHTML", "AFXHTML/CHtmlEditCtrlBase::SetFontFace", "AFXHTML/CHtmlEditCtrlBase::SetFontSize", "AFXHTML/CHtmlEditCtrlBase::SetForeColor", "AFXHTML/CHtmlEditCtrlBase::SetIE5PasteMode", "AFXHTML/CHtmlEditCtrlBase::SetLiveResize", "AFXHTML/CHtmlEditCtrlBase::SetMultiSelect", "AFXHTML/CHtmlEditCtrlBase::SetOverrideCursor", "AFXHTML/CHtmlEditCtrlBase::SetMode", "AFXHTML/CHtmlEditCtrlBase::SetRespectVisInDesign", "AFXHTML/CHtmlEditCtrlBase::SetShowAlignedSiteTags", "AFXHTML/CHtmlEditCtrlBase::SetShowAllTags", "AFXHTML/CHtmlEditCtrlBase::SetShowAreaTags", "AFXHTML/CHtmlEditCtrlBase::SetShowBRTags", "AFXHTML/CHtmlEditCtrlBase::SetShowCommentTags", "AFXHTML/CHtmlEditCtrlBase::SetShowMiscTags", "AFXHTML/CHtmlEditCtrlBase::SetShowScriptTags", "AFXHTML/CHtmlEditCtrlBase::SetShowStyleTags", "AFXHTML/CHtmlEditCtrlBase::SetShowUnknownTags", "AFXHTML/CHtmlEditCtrlBase::TextArea", "AFXHTML/CHtmlEditCtrlBase::TextBox", "AFXHTML/CHtmlEditCtrlBase::UnBookmark", "AFXHTML/CHtmlEditCtrlBase::Underline", "AFXHTML/CHtmlEditCtrlBase::Unlink", "AFXHTML/CHtmlEditCtrlBase::UnorderList"] helpviewer_keywords: ["CHtmlEditCtrlBase [MFC], AddToGlyphTable", "CHtmlEditCtrlBase [MFC], Bold", "CHtmlEditCtrlBase [MFC], Button", "CHtmlEditCtrlBase [MFC], CheckBox", "CHtmlEditCtrlBase [MFC], ClearSelection", "CHtmlEditCtrlBase [MFC], Copy", "CHtmlEditCtrlBase [MFC], Cut", "CHtmlEditCtrlBase [MFC], Delete", "CHtmlEditCtrlBase [MFC], DropDownBox", "CHtmlEditCtrlBase [MFC], EmptyGlyphTable", "CHtmlEditCtrlBase [MFC], ExecCommand", "CHtmlEditCtrlBase [MFC], Font", "CHtmlEditCtrlBase [MFC], GetAbsolutePosition", "CHtmlEditCtrlBase [MFC], GetBackColor", "CHtmlEditCtrlBase [MFC], GetBlockFormat", "CHtmlEditCtrlBase [MFC], GetBlockFormatNames", "CHtmlEditCtrlBase [MFC], GetBookMark", "CHtmlEditCtrlBase [MFC], GetDocument", "CHtmlEditCtrlBase [MFC], GetDocumentHTML", "CHtmlEditCtrlBase [MFC], GetDocumentTitle", "CHtmlEditCtrlBase [MFC], GetEvent", "CHtmlEditCtrlBase [MFC], GetEventSrcElement", "CHtmlEditCtrlBase [MFC], GetFontFace", "CHtmlEditCtrlBase [MFC], GetFontSize", "CHtmlEditCtrlBase [MFC], GetForeColor", "CHtmlEditCtrlBase [MFC], GetFrameZone", "CHtmlEditCtrlBase [MFC], GetIsDirty", "CHtmlEditCtrlBase [MFC], GetShowAlignedSiteTags", "CHtmlEditCtrlBase [MFC], GetShowAllTags", "CHtmlEditCtrlBase [MFC], GetShowAreaTags", "CHtmlEditCtrlBase [MFC], GetShowBRTags", "CHtmlEditCtrlBase [MFC], GetShowCommentTags", "CHtmlEditCtrlBase [MFC], GetShowMiscTags", "CHtmlEditCtrlBase [MFC], GetShowScriptTags", "CHtmlEditCtrlBase [MFC], GetShowStyleTags", "CHtmlEditCtrlBase [MFC], GetShowUnknownTags", "CHtmlEditCtrlBase [MFC], HorizontalLine", "CHtmlEditCtrlBase [MFC], HyperLink", "CHtmlEditCtrlBase [MFC], IE50Paste", "CHtmlEditCtrlBase [MFC], Iframe", "CHtmlEditCtrlBase [MFC], Image", "CHtmlEditCtrlBase [MFC], Indent", "CHtmlEditCtrlBase [MFC], InsFieldSet", "CHtmlEditCtrlBase [MFC], InsInputButton", "CHtmlEditCtrlBase [MFC], InsInputHidden", "CHtmlEditCtrlBase [MFC], InsInputImage", "CHtmlEditCtrlBase [MFC], InsInputPassword", "CHtmlEditCtrlBase [MFC], InsInputReset", "CHtmlEditCtrlBase [MFC], InsInputSubmit", "CHtmlEditCtrlBase [MFC], InsInputUpload", "CHtmlEditCtrlBase [MFC], Is1DElement", "CHtmlEditCtrlBase [MFC], Is2DElement", "CHtmlEditCtrlBase [MFC], Italic", "CHtmlEditCtrlBase [MFC], JustifyCenter", "CHtmlEditCtrlBase [MFC], JustifyLeft", "CHtmlEditCtrlBase [MFC], JustifyRight", "CHtmlEditCtrlBase [MFC], ListBox", "CHtmlEditCtrlBase [MFC], Marquee", "CHtmlEditCtrlBase [MFC], NewDocument", "CHtmlEditCtrlBase [MFC], OrderList", "CHtmlEditCtrlBase [MFC], Outdent", "CHtmlEditCtrlBase [MFC], Paragraph", "CHtmlEditCtrlBase [MFC], Paste", "CHtmlEditCtrlBase [MFC], PrintDocument", "CHtmlEditCtrlBase [MFC], PrintPreview", "CHtmlEditCtrlBase [MFC], QueryStatus", "CHtmlEditCtrlBase [MFC], RadioButton", "CHtmlEditCtrlBase [MFC], RefreshDocument", "CHtmlEditCtrlBase [MFC], RemoveFormat", "CHtmlEditCtrlBase [MFC], SaveAs", "CHtmlEditCtrlBase [MFC], SelectAll", "CHtmlEditCtrlBase [MFC], Set2DPosition", "CHtmlEditCtrlBase [MFC], SetAbsolutePosition", "CHtmlEditCtrlBase [MFC], SetAtomicSelection", "CHtmlEditCtrlBase [MFC], SetAutoURLDetectMode", "CHtmlEditCtrlBase [MFC], SetBackColor", "CHtmlEditCtrlBase [MFC], SetBlockFormat", "CHtmlEditCtrlBase [MFC], SetBookMark", "CHtmlEditCtrlBase [MFC], SetCSSEditingLevel", "CHtmlEditCtrlBase [MFC], SetDefaultComposeSettings", "CHtmlEditCtrlBase [MFC], SetDesignMode", "CHtmlEditCtrlBase [MFC], SetDisableEditFocusUI", "CHtmlEditCtrlBase [MFC], SetDocumentHTML", "CHtmlEditCtrlBase [MFC], SetFontFace", "CHtmlEditCtrlBase [MFC], SetFontSize", "CHtmlEditCtrlBase [MFC], SetForeColor", "CHtmlEditCtrlBase [MFC], SetIE5PasteMode", "CHtmlEditCtrlBase [MFC], SetLiveResize", "CHtmlEditCtrlBase [MFC], SetMultiSelect", "CHtmlEditCtrlBase [MFC], SetOverrideCursor", "CHtmlEditCtrlBase [MFC], SetOverwriteMode", "CHtmlEditCtrlBase [MFC], SetRespectVisInDesign", "CHtmlEditCtrlBase [MFC], SetShowAlignedSiteTags", "CHtmlEditCtrlBase [MFC], SetShowAllTags", "CHtmlEditCtrlBase [MFC], SetShowAreaTags", "CHtmlEditCtrlBase [MFC], SetShowBRTags", "CHtmlEditCtrlBase [MFC], SetShowCommentTags", "CHtmlEditCtrlBase [MFC], SetShowMiscTags", "CHtmlEditCtrlBase [MFC], SetShowScriptTags", "CHtmlEditCtrlBase [MFC], SetShowStyleTags", "CHtmlEditCtrlBase [MFC], SetShowUnknownTags", "CHtmlEditCtrlBase [MFC], TextArea", "CHtmlEditCtrlBase [MFC], TextBox", "CHtmlEditCtrlBase [MFC], UnBookmark", "CHtmlEditCtrlBase [MFC], Underline", "CHtmlEditCtrlBase [MFC], Unlink", "CHtmlEditCtrlBase [MFC], UnorderList"] -ms.assetid: e0cc74b4-8320-4570-b673-16c03d2ae266 --- # CHtmlEditCtrlBase Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an HTML editing component. ## Syntax diff --git a/docs/mfc/reference/chtmleditdoc-class.md b/docs/mfc/reference/chtmleditdoc-class.md index 0e5251f0434..309a4e8901a 100644 --- a/docs/mfc/reference/chtmleditdoc-class.md +++ b/docs/mfc/reference/chtmleditdoc-class.md @@ -4,10 +4,12 @@ title: "CHtmlEditDoc Class" ms.date: "11/04/2016" f1_keywords: ["CHtmlEditDoc", "AFXHTML/CHtmlEditDoc", "AFXHTML/CHtmlEditDoc::CHtmlEditDoc", "AFXHTML/CHtmlEditDoc::GetView", "AFXHTML/CHtmlEditDoc::IsModified", "AFXHTML/CHtmlEditDoc::OpenURL"] helpviewer_keywords: ["CHtmlEditDoc [MFC], CHtmlEditDoc", "CHtmlEditDoc [MFC], GetView", "CHtmlEditDoc [MFC], IsModified", "CHtmlEditDoc [MFC], OpenURL"] -ms.assetid: b2cca61f-e5d6-4099-b0d1-46bf85f0bd64 --- # CHtmlEditDoc Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + With [CHtmlEditView](../../mfc/reference/chtmleditview-class.md), provides the functionality of the WebBrowser editing platform within the context of the MFC document-view architecture. ## Syntax diff --git a/docs/mfc/reference/chtmleditview-class.md b/docs/mfc/reference/chtmleditview-class.md index f636ef74ab1..0813a65f6bb 100644 --- a/docs/mfc/reference/chtmleditview-class.md +++ b/docs/mfc/reference/chtmleditview-class.md @@ -4,10 +4,12 @@ title: "CHtmlEditView Class" ms.date: "11/04/2016" f1_keywords: ["CHtmlEditView", "AFXHTML/CHtmlEditView", "AFXHTML/CHtmlEditView::CHtmlEditView", "AFXHTML/CHtmlEditView::Create", "AFXHTML/CHtmlEditView::GetDHtmlDocument", "AFXHTML/CHtmlEditView::GetStartDocument"] helpviewer_keywords: ["CHtmlEditView [MFC], CHtmlEditView", "CHtmlEditView [MFC], Create", "CHtmlEditView [MFC], GetDHtmlDocument", "CHtmlEditView [MFC], GetStartDocument"] -ms.assetid: 166c8ba8-3fb5-4dd7-a9ea-5bca662d00f6 --- # CHtmlEditView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the WebBrowser editing platform within the context of MFC's document/view architecture. ## Syntax diff --git a/docs/mfc/reference/chtmlview-class.md b/docs/mfc/reference/chtmlview-class.md index d19b1de124d..1a173311fc6 100644 --- a/docs/mfc/reference/chtmlview-class.md +++ b/docs/mfc/reference/chtmlview-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CHtmlView [MFC], Create", "CHtmlView [MFC], CreateControl --- # `CHtmlView` class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the WebBrowser control within the context of MFC's document/view architecture. ## Syntax diff --git a/docs/mfc/reference/chttpconnection-class.md b/docs/mfc/reference/chttpconnection-class.md index 04a22df5849..f8d4f1d7f87 100644 --- a/docs/mfc/reference/chttpconnection-class.md +++ b/docs/mfc/reference/chttpconnection-class.md @@ -4,10 +4,12 @@ title: "CHttpConnection Class" ms.date: "03/27/2019" f1_keywords: ["CHttpConnection", "AFXINET/CHttpConnection", "AFXINET/CHttpConnection::CHttpConnection", "AFXINET/CHttpConnection::OpenRequest"] helpviewer_keywords: ["CHttpConnection [MFC], CHttpConnection", "CHttpConnection [MFC], OpenRequest"] -ms.assetid: a402b662-c445-4988-800d-c8278551babe --- # CHttpConnection Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages your connection to an HTTP server. ## Syntax diff --git a/docs/mfc/reference/chttpfile-class.md b/docs/mfc/reference/chttpfile-class.md index 63ab4b55b7b..e6fac4c2b68 100644 --- a/docs/mfc/reference/chttpfile-class.md +++ b/docs/mfc/reference/chttpfile-class.md @@ -4,10 +4,12 @@ title: "CHttpFile Class" ms.date: "11/04/2016" f1_keywords: ["CHttpFile", "AFXINET/CHttpFile", "AFXINET/CHttpFile::CHttpFile", "AFXINET/CHttpFile::AddRequestHeaders", "AFXINET/CHttpFile::EndRequest", "AFXINET/CHttpFile::GetFileURL", "AFXINET/CHttpFile::GetObject", "AFXINET/CHttpFile::GetVerb", "AFXINET/CHttpFile::QueryInfo", "AFXINET/CHttpFile::QueryInfoStatusCode", "AFXINET/CHttpFile::SendRequest", "AFXINET/CHttpFile::SendRequestEx"] helpviewer_keywords: ["CHttpFile [MFC], CHttpFile", "CHttpFile [MFC], AddRequestHeaders", "CHttpFile [MFC], EndRequest", "CHttpFile [MFC], GetFileURL", "CHttpFile [MFC], GetObject", "CHttpFile [MFC], GetVerb", "CHttpFile [MFC], QueryInfo", "CHttpFile [MFC], QueryInfoStatusCode", "CHttpFile [MFC], SendRequest", "CHttpFile [MFC], SendRequestEx"] -ms.assetid: 399e7c68-bbce-4374-8c55-206e9c7baac6 --- # CHttpFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality to request and read files on an HTTP server. ## Syntax diff --git a/docs/mfc/reference/chwndrendertarget-class.md b/docs/mfc/reference/chwndrendertarget-class.md index 540b28ca338..a55070e729a 100644 --- a/docs/mfc/reference/chwndrendertarget-class.md +++ b/docs/mfc/reference/chwndrendertarget-class.md @@ -4,10 +4,12 @@ title: "CHwndRenderTarget Class" ms.date: "11/04/2016" f1_keywords: ["CHwndRenderTarget", "AFXRENDERTARGET/CHwndRenderTarget", "AFXRENDERTARGET/CHwndRenderTarget::CHwndRenderTarget", "AFXRENDERTARGET/CHwndRenderTarget::Attach", "AFXRENDERTARGET/CHwndRenderTarget::CheckWindowState", "AFXRENDERTARGET/CHwndRenderTarget::Create", "AFXRENDERTARGET/CHwndRenderTarget::Detach", "AFXRENDERTARGET/CHwndRenderTarget::GetHwnd", "AFXRENDERTARGET/CHwndRenderTarget::GetHwndRenderTarget", "AFXRENDERTARGET/CHwndRenderTarget::ReCreate", "AFXRENDERTARGET/CHwndRenderTarget::Resize", "AFXRENDERTARGET/CHwndRenderTarget::m_pHwndRenderTarget"] helpviewer_keywords: ["CHwndRenderTarget [MFC], CHwndRenderTarget", "CHwndRenderTarget [MFC], Attach", "CHwndRenderTarget [MFC], CheckWindowState", "CHwndRenderTarget [MFC], Create", "CHwndRenderTarget [MFC], Detach", "CHwndRenderTarget [MFC], GetHwnd", "CHwndRenderTarget [MFC], GetHwndRenderTarget", "CHwndRenderTarget [MFC], ReCreate", "CHwndRenderTarget [MFC], Resize", "CHwndRenderTarget [MFC], m_pHwndRenderTarget"] -ms.assetid: aa65b69f-7202-46ea-af81-ef325da0b840 --- # CHwndRenderTarget Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for ID2D1HwndRenderTarget. ## Syntax diff --git a/docs/mfc/reference/cimagelist-class.md b/docs/mfc/reference/cimagelist-class.md index ca80bcc33ee..74324b18e4a 100644 --- a/docs/mfc/reference/cimagelist-class.md +++ b/docs/mfc/reference/cimagelist-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CImageList [MFC], CImageList", "CImageList [MFC], Add", " --- # `CImageList` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common image list control. ## Syntax diff --git a/docs/mfc/reference/cinstantaneoustransition-class.md b/docs/mfc/reference/cinstantaneoustransition-class.md index 3ae206b69ab..052761c2868 100644 --- a/docs/mfc/reference/cinstantaneoustransition-class.md +++ b/docs/mfc/reference/cinstantaneoustransition-class.md @@ -4,10 +4,12 @@ title: "CInstantaneousTransition Class" ms.date: "11/04/2016" f1_keywords: ["CInstantaneousTransition", "AFXANIMATIONCONTROLLER/CInstantaneousTransition", "AFXANIMATIONCONTROLLER/CInstantaneousTransition::CInstantaneousTransition", "AFXANIMATIONCONTROLLER/CInstantaneousTransition::Create", "AFXANIMATIONCONTROLLER/CInstantaneousTransition::m_dblFinalValue"] helpviewer_keywords: ["CInstantaneousTransition [MFC], CInstantaneousTransition", "CInstantaneousTransition [MFC], Create", "CInstantaneousTransition [MFC], m_dblFinalValue"] -ms.assetid: c3d5121f-2c6b-4221-9e57-10e082a31120 --- # CInstantaneousTransition Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Encapsulates an instantaneous transition. ## Syntax diff --git a/docs/mfc/reference/cinternetconnection-class.md b/docs/mfc/reference/cinternetconnection-class.md index 0673cfd4de8..bc22af6454b 100644 --- a/docs/mfc/reference/cinternetconnection-class.md +++ b/docs/mfc/reference/cinternetconnection-class.md @@ -4,10 +4,12 @@ title: "CInternetConnection Class" ms.date: "11/04/2016" f1_keywords: ["CInternetConnection", "AFXINET/CInternetConnection", "AFXINET/CInternetConnection::CInternetConnection", "AFXINET/CInternetConnection::GetContext", "AFXINET/CInternetConnection::GetServerName", "AFXINET/CInternetConnection::GetSession"] helpviewer_keywords: ["CInternetConnection [MFC], CInternetConnection", "CInternetConnection [MFC], GetContext", "CInternetConnection [MFC], GetServerName", "CInternetConnection [MFC], GetSession"] -ms.assetid: 62a5d1c3-8471-4e36-a064-48831829b2a7 --- # CInternetConnection Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages your connection to an Internet server. ## Syntax diff --git a/docs/mfc/reference/cinternetexception-class.md b/docs/mfc/reference/cinternetexception-class.md index 0af84f73031..8b6ea3e8409 100644 --- a/docs/mfc/reference/cinternetexception-class.md +++ b/docs/mfc/reference/cinternetexception-class.md @@ -4,10 +4,12 @@ title: "CInternetException Class" ms.date: "11/04/2016" f1_keywords: ["CInternetException", "AFXINET/CInternetException", "AFXINET/CInternetException::CInternetException", "AFXINET/CInternetException::m_dwContext", "AFXINET/CInternetException::m_dwError"] helpviewer_keywords: ["CInternetException [MFC], CInternetException", "CInternetException [MFC], m_dwContext", "CInternetException [MFC], m_dwError"] -ms.assetid: 44fb3cbe-523e-4754-8843-a77909990b14 --- # CInternetException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents an exception condition related to an Internet operation. ## Syntax diff --git a/docs/mfc/reference/cinternetfile-class.md b/docs/mfc/reference/cinternetfile-class.md index 6e30d78c6bc..b8dc86a17a3 100644 --- a/docs/mfc/reference/cinternetfile-class.md +++ b/docs/mfc/reference/cinternetfile-class.md @@ -4,10 +4,12 @@ title: "CInternetFile Class" ms.date: "11/04/2016" f1_keywords: ["CInternetFile", "AFXINET/CInternetFile", "AFXINET/CInternetFile::CInternetFile", "AFXINET/CInternetFile::Abort", "AFXINET/CInternetFile::Close", "AFXINET/CInternetFile::Flush", "AFXINET/CInternetFile::GetLength", "AFXINET/CInternetFile::Read", "AFXINET/CInternetFile::ReadString", "AFXINET/CInternetFile::Seek", "AFXINET/CInternetFile::SetReadBufferSize", "AFXINET/CInternetFile::SetWriteBufferSize", "AFXINET/CInternetFile::Write", "AFXINET/CInternetFile::WriteString", "AFXINET/CInternetFile::m_hFile"] helpviewer_keywords: ["CInternetFile [MFC], CInternetFile", "CInternetFile [MFC], Abort", "CInternetFile [MFC], Close", "CInternetFile [MFC], Flush", "CInternetFile [MFC], GetLength", "CInternetFile [MFC], Read", "CInternetFile [MFC], ReadString", "CInternetFile [MFC], Seek", "CInternetFile [MFC], SetReadBufferSize", "CInternetFile [MFC], SetWriteBufferSize", "CInternetFile [MFC], Write", "CInternetFile [MFC], WriteString", "CInternetFile [MFC], m_hFile"] -ms.assetid: 96935681-ee71-4a8d-9783-5abc7b3e6f10 --- # CInternetFile Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Allows access to files on remote systems that use Internet protocols. ## Syntax diff --git a/docs/mfc/reference/cinternetsession-class.md b/docs/mfc/reference/cinternetsession-class.md index bc6087fc385..4ed84687949 100644 --- a/docs/mfc/reference/cinternetsession-class.md +++ b/docs/mfc/reference/cinternetsession-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CInternetSession [MFC], CInternetSession", "CInternetSess --- # `CInternetSession` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Creates and initializes a single or several simultaneous Internet sessions and, if necessary, describes your connection to a proxy server. ## Syntax diff --git a/docs/mfc/reference/cinterpolatorbase-class.md b/docs/mfc/reference/cinterpolatorbase-class.md index 3d8cced609b..93648302073 100644 --- a/docs/mfc/reference/cinterpolatorbase-class.md +++ b/docs/mfc/reference/cinterpolatorbase-class.md @@ -4,10 +4,12 @@ title: "CInterpolatorBase Class" ms.date: "11/04/2016" f1_keywords: ["CInterpolatorBase", "AFXANIMATIONCONTROLLER/CInterpolatorBase", "AFXANIMATIONCONTROLLER/CInterpolatorBase::CInterpolatorBase", "AFXANIMATIONCONTROLLER/CInterpolatorBase::CreateInstance", "AFXANIMATIONCONTROLLER/CInterpolatorBase::GetDependencies", "AFXANIMATIONCONTROLLER/CInterpolatorBase::GetDuration", "AFXANIMATIONCONTROLLER/CInterpolatorBase::GetFinalValue", "AFXANIMATIONCONTROLLER/CInterpolatorBase::InterpolateValue", "AFXANIMATIONCONTROLLER/CInterpolatorBase::InterpolateVelocity", "AFXANIMATIONCONTROLLER/CInterpolatorBase::SetCustomInterpolator", "AFXANIMATIONCONTROLLER/CInterpolatorBase::SetDuration", "AFXANIMATIONCONTROLLER/CInterpolatorBase::SetInitialValueAndVelocity"] helpviewer_keywords: ["CInterpolatorBase [MFC], CInterpolatorBase", "CInterpolatorBase [MFC], CreateInstance", "CInterpolatorBase [MFC], GetDependencies", "CInterpolatorBase [MFC], GetDuration", "CInterpolatorBase [MFC], GetFinalValue", "CInterpolatorBase [MFC], InterpolateValue", "CInterpolatorBase [MFC], InterpolateVelocity", "CInterpolatorBase [MFC], SetCustomInterpolator", "CInterpolatorBase [MFC], SetDuration", "CInterpolatorBase [MFC], SetInitialValueAndVelocity"] -ms.assetid: bbc3dce7-8398-47f9-b97e-e4fd2d737232 --- # CInterpolatorBase Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements a callback, which is called by the Animation API when it has to calculate a new value of an animation variable. ## Syntax diff --git a/docs/mfc/reference/cinvalidargexception-class.md b/docs/mfc/reference/cinvalidargexception-class.md index 938e2630fbe..3efef73e2d8 100644 --- a/docs/mfc/reference/cinvalidargexception-class.md +++ b/docs/mfc/reference/cinvalidargexception-class.md @@ -4,10 +4,12 @@ title: "CInvalidArgException Class" ms.date: "11/04/2016" f1_keywords: ["CInvalidArgException", "AFX/CInvalidArgException", "AFX/CInvalidArgException::CInvalidArgException"] helpviewer_keywords: ["CInvalidArgException [MFC], CInvalidArgException"] -ms.assetid: e43d7c67-1157-47f8-817a-804083e8186e --- # CInvalidArgException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This class represents an invalid argument exception condition. ## Syntax diff --git a/docs/mfc/reference/cipaddressctrl-class.md b/docs/mfc/reference/cipaddressctrl-class.md index 859832b3e2e..6e0287d3989 100644 --- a/docs/mfc/reference/cipaddressctrl-class.md +++ b/docs/mfc/reference/cipaddressctrl-class.md @@ -4,10 +4,12 @@ title: "CIPAddressCtrl Class" ms.date: "11/04/2016" f1_keywords: ["CIPAddressCtrl", "AFXCMN/CIPAddressCtrl", "AFXCMN/CIPAddressCtrl::CIPAddressCtrl", "AFXCMN/CIPAddressCtrl::ClearAddress", "AFXCMN/CIPAddressCtrl::Create", "AFXCMN/CIPAddressCtrl::CreateEx", "AFXCMN/CIPAddressCtrl::GetAddress", "AFXCMN/CIPAddressCtrl::IsBlank", "AFXCMN/CIPAddressCtrl::SetAddress", "AFXCMN/CIPAddressCtrl::SetFieldFocus", "AFXCMN/CIPAddressCtrl::SetFieldRange"] helpviewer_keywords: ["CIPAddressCtrl [MFC], CIPAddressCtrl", "CIPAddressCtrl [MFC], ClearAddress", "CIPAddressCtrl [MFC], Create", "CIPAddressCtrl [MFC], CreateEx", "CIPAddressCtrl [MFC], GetAddress", "CIPAddressCtrl [MFC], IsBlank", "CIPAddressCtrl [MFC], SetAddress", "CIPAddressCtrl [MFC], SetFieldFocus", "CIPAddressCtrl [MFC], SetFieldRange"] -ms.assetid: 9764d2f4-cb14-4ba8-b799-7f57a55a47c6 --- # CIPAddressCtrl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the functionality of the Windows common IP Address control. ## Syntax From 19fe37c208497ebf790c1d3389fa6229538f3004 Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Fri, 20 Feb 2026 16:53:41 -0800 Subject: [PATCH 1641/1799] edit pass: redistributing-microsoft-c++-files --- ...uting-components-by-using-merge-modules.md | 36 ++++++++++------- .../windows/redistributing-the-mfc-library.md | 37 +++++++++-------- ...istributing-visual-cpp-activex-controls.md | 26 ++++++------ .../redistributing-visual-cpp-files.md | 40 ++++++++++++------- 4 files changed, 79 insertions(+), 60 deletions(-) diff --git a/docs/windows/redistributing-components-by-using-merge-modules.md b/docs/windows/redistributing-components-by-using-merge-modules.md index ac04fbfd8d6..e338d1c8b25 100644 --- a/docs/windows/redistributing-components-by-using-merge-modules.md +++ b/docs/windows/redistributing-components-by-using-merge-modules.md @@ -1,41 +1,47 @@ --- -description: "Learn more about: Redistributing Components By Using Merge Modules" -title: "Redistributing Components By Using Merge Modules" +description: "Learn More About: Redistribute Components by Using Merge Modules" +title: Learn more about redistributing components by using merge modules. ms.date: 06/08/2022 helpviewer_keywords: ["merge modules, using", "redistributing applications, using merge modules"] ms.assetid: 93b84211-bf9b-4a78-9f22-474ac2ef7840 ms.topic: concept-article --- -# Redistributing components by using merge modules +# Redistribute components by using merge modules > [!IMPORTANT] -> In Visual Studio 2019 and later, merge modules for Visual C++ Redistributable files are deprecated. We don't recommend you use them for application deployment. Redistributables installed using Merge modules can't be updated by Windows Update because the detection mechanism depends on knowing details of the installing package. The Visual C++ Redistributable packages are known for each release, but packages that use MSMs are user generated. Microsoft can't know the details of user-generated packages. Instead, we recommend you use central deployment of the Visual C++ Redistributable package. Central deployment installs the Redistributable files in the Windows *`%SYSTEMROOT%\system32\`* folder for use by all applications and users. Central deployment by a Redistributable package makes it possible for Microsoft to service runtime library files independently. And, an uninstall of your app can't break other applications that also use central deployment. When you use a Redistributable package for central deployment, you aren't responsible for tracking and updating the runtime libraries as part of your application maintenance: The Microsoft Update service updates these libraries for you. Otherwise, an update to the runtime library files requires you to update and redeploy your *`.msi`* installer. Your app could be vulnerable to bugs or security issues until you do. +> In Visual Studio 2019 and later, merge modules for Visual C++ Redistributable files are deprecated. We don't recommend that you use them for application deployment. Redistributables installed by using merge modules can't be updated by Windows Update because the detection mechanism depends on knowing details of the installing package. +> +> The Visual C++ Redistributable packages are known for each release, but packages that use MSMs are user generated. Microsoft can't know the details of user-generated packages. Instead, we recommend that you use central deployment of the Visual C++ Redistributable package. Central deployment installs the Redistributable files in the Windows *`%SYSTEMROOT%\system32\`* folder for use by all applications and users. Central deployment by a Redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't break other applications that also use central deployment. +> +> When you use a Redistributable package for central deployment, you aren't responsible for tracking and updating the runtime libraries as part of your application maintenance. The Microsoft Update service updates these libraries for you. Otherwise, an update to the runtime library files requires you to update and redeploy your *`.msi`* installer. Your app could be vulnerable to bugs or security issues until you do. -Visual Studio includes [merge modules](/windows/win32/Msi/about-merge-modules) (*`.msm`* files) for each Visual C++ component that's licensed for redistribution with an application. There are separate versions of the merge modules for each target platform. When a merge module is compiled into a Windows Installer setup file, it enables the deployment of Visual C++ Redistributable files to that specific platform. You can't include merge modules for different versions of the same DLL in one installer. In your installer setup file, specify that the merge modules are prerequisites for your application. +Visual Studio includes [merge modules](/windows/win32/Msi/about-merge-modules) (*`.msm`* files) for each Visual C++ component that's licensed for redistribution with an application. There are separate versions of the merge modules for each target platform. When a merge module is compiled into a Windows Installer setup file, it enables the deployment of Visual C++ Redistributable files to that specific platform. You can't include merge modules for different versions of the same dynamic link library (DLL) in one installer. In your installer setup file, specify that the merge modules are prerequisites for your application. -You can use merge modules for either [central deployment](deployment-in-visual-cpp.md#central-deployment) or [local deployment](deployment-in-visual-cpp.md#local-deployment). Users can't install centrally deployed files unless they have administrator rights. Local deployment may allow a non-administrator to install and run your app, but at the cost of independent serviceability. +You can use merge modules for either [central deployment](deployment-in-visual-cpp.md#central-deployment) or [local deployment](deployment-in-visual-cpp.md#local-deployment). Users can't install centrally deployed files unless they have administrator rights. Local deployment might allow a non-administrator to install and run your app, but at the cost of independent serviceability. The installation service reports an error if you attempt central deployment of older merge modules over newer existing libraries. You should write your installer setup to handle this failure gracefully and not display an error message. Your code can still deploy and run successfully despite this failure. For more information, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). -If you deploy your code only as an *`.msi`* installer, we recommend you don't include the merge modules in the installer. Instead, report a failure to the user when the required Redistributable libraries aren't found. In the failure dialog, include instructions on how to find and install the latest Redistributable package. For more information and links to Redistributable packages, see [The latest supported Visual C++ downloads](latest-supported-vc-redist.md). +If you deploy your code only as an *`.msi`* installer, we recommend that you don't include the merge modules in the installer. Instead, report a failure to the user when the required Redistributable libraries aren't found. In the failure dialog, include instructions on how to find and install the latest Redistributable package. For more information and links to Redistributable packages, see [the latest supported Visual C++ downloads](latest-supported-vc-redist.md). -The latest Redistributable packages and merge modules are compatible with code built using Visual Studio 2015 and later. Code built by versions of Visual Studio before 2015 require a separate Redistributable package. +The latest Redistributable packages and merge modules are compatible with code built by using Visual Studio 2015 and later. Code built by versions of Visual Studio before 2015 require a separate Redistributable package. ## When to use merge modules Merge modules are only appropriate in limited circumstances: -- You can't install or require a separate Redistributable package for policy reasons, -- Your code requires a specific, bug-compatible version of the libraries, -- Your code only targets one platform, and you don't have dependencies on more than one version of the DLLs, -- You intend to service your deployed code regularly, so the libraries remain up to date. +- You can't install or require a separate Redistributable package for policy reasons. +- Your code requires a specific, bug-compatible version of the libraries. +- Your code targets only one platform, and you don't have dependencies on more than one version of the DLLs. +- You intend to service your deployed code regularly so that the libraries remain up to date. When you use merge modules, you must track and regularly service your application with library updates. Otherwise, you eventually force your clients to choose between running your code or remaining secure. ## Where to find merge module files -In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named **C++ \ Redistributable MSMs** in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When installed in Visual Studio 2022, you'll find the Visual C++ Redistributable merge modules in *`%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`*. In the latest version of Visual Studio 2019, the merge modules are in *`%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`*. In both Visual Studio 2019 and Visual Studio 2017, they're also found in *`%VCToolsRedistDir%MergeModules`*. In Visual Studio 2015, they're found in *`Program Files [(x86)]\Common Files\Merge Modules`*. For more information and a link to a list of Redistributable merge modules, see [Redistributing Visual C++ files](redistributing-visual-cpp-files.md). +In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When installed in Visual Studio 2022, you can find the Visual C++ Redistributable merge modules in *`%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`*. -## See also +In the latest version of Visual Studio 2019, the merge modules are in *`%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`*. In both Visual Studio 2019 and Visual Studio 2017, they're also found in *`%VCToolsRedistDir%MergeModules`*. In Visual Studio 2015, they're found in *`Program Files [(x86)]\Common Files\Merge Modules`*. For more information and a link to a list of Redistributable merge modules, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). -[Redistributing Visual C++ files](redistributing-visual-cpp-files.md) +## Related content + +- [Redistribute Visual C++ files](redistributing-visual-cpp-files.md) diff --git a/docs/windows/redistributing-the-mfc-library.md b/docs/windows/redistributing-the-mfc-library.md index c01f4c38d38..512a0ae3a0a 100644 --- a/docs/windows/redistributing-the-mfc-library.md +++ b/docs/windows/redistributing-the-mfc-library.md @@ -1,44 +1,49 @@ --- -description: "Learn more about: Redistributing the MFC Library" -title: "Redistributing the MFC Library" +description: "Learn More About: Redistribute the MFC Library" +title: Learn more about redistributing the MFC Library. ms.date: "11/04/2016" helpviewer_keywords: ["MFC, redistributing", "redistributing MFC library"] ms.assetid: 72714ce1-385e-4c1c-afa5-96b03e873866 ms.topic: concept-article --- -# Redistributing the MFC Library -If you dynamically link your application to the MFC library, you must redistribute the matching MFC DLL. For example, if your MFC app is built by using the version of MFC that ships with Visual Studio 2015, you must redistribute mfc140.dll or mfc140u.dll, depending on whether your app is compiled for narrow characters or Unicode support. +# Redistribute the MFC Library + +If you dynamically link your application to the Microsoft Foundation Class (MFC) library, you must redistribute the matching MFC dynamic link library (DLL). For example, if your MFC app is built by using the version of MFC that ships with Visual Studio 2015, you must redistribute mfc140.dll or mfc140u.dll, depending on whether your app is compiled for narrow characters or Unicode support. > [!NOTE] > The mfc140.dll files were omitted from the redistributable files directory in Visual Studio 2015 RTM. You can use the versions installed by Visual Studio 2015 in the Windows\system32 and Windows\syswow64 directories instead. -Because all MFC DLLs use the shared version of the C runtime library (CRT), You may also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the universal CRT library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. For information on how to redistribute the universal CRT as an operating system component or by using local deployment, see [Introducing the Universal CRT](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the universal CRT for central deployment on supported versions of Windows, see [Windows 10 Universal C Runtime](https://www.microsoft.com/download/details.aspx?id=48234). Redistributable architecture-specific versions of ucrtbase.dll for local deployment are found in the Windows SDK. By default, Visual Studio installs these in C:\Program Files (x86)\Windows Kits\10\Redist\ucrt\DLLs\ in an architecture-specific sub-directory. +Because all MFC DLLs use the shared version of the C runtime library (CRT), you might also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the universal CRT library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. + +For information on how to redistribute the universal CRT as an operating system component or by using local deployment, see [Introducing the Universal CRT](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the universal CRT for central deployment on supported versions of Windows, see [Windows 10 Universal C Runtime](https://www.microsoft.com/download/details.aspx?id=48234). + +You can find Redistributable architecture-specific versions of ucrtbase.dll for local deployment in the Windows SDK. By default, Visual Studio installs these versions in C:\Program Files (x86)\Windows Kits\10\Redist\ucrt\DLLs\ in an architecture-specific subdirectory. If your app is built by using an earlier version of the MFC library, you must redistribute the matching CRT DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the msvcr120.dll. You also have to redistribute the matching mfc``u.dll or mfc``.dll. -If you statically link your application to MFC (that is, if you specify **Use MFC in a Static Library** on the **General** tab in the **Property Pages** dialog box), you do not have to redistribute an MFC DLL. However, although static linking may work for testing and internal deployment of applications, we recommend that you do not use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choosing a Deployment Method](choosing-a-deployment-method.md). +If you statically link your application to MFC (that is, if you specify **Use MFC in a Static Library** on the **General** tab in the **Property Pages** dialog), you don't have to redistribute an MFC DLL. Although static linking might work for testing and internal deployment of applications, we recommend that you don't use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choosing a deployment method](choosing-a-deployment-method.md). If your application uses the MFC classes that implement the WebBrowser control (for example, [CHtmlView Class](../mfc/reference/chtmlview-class.md) or [CHtmlEditView Class](../mfc/reference/chtmleditview-class.md)), we recommend that you also install the most current version of Microsoft Internet Explorer so that the target computer will have the most current common control files. (At a minimum, Internet Explorer 4.0 is required.) Information about how to install Internet Explorer components is available in "Article 185375: How To Create a Single EXE Install of Internet Explorer" on the Microsoft Support website. -If your application uses the MFC database classes (for example, [CRecordset Class](../mfc/reference/crecordset-class.md) and [CRecordView Class](../mfc/reference/crecordview-class.md)), you must redistribute ODBC and any ODBC drivers that your application uses. +If your application uses the MFC database classes (for example, [CRecordset Class](../mfc/reference/crecordset-class.md) and [CRecordView Class](../mfc/reference/crecordview-class.md)), you must redistribute Open Database Connectivity (ODBC) and any ODBC drivers that your application uses. -If your MFC application uses Windows Forms controls, you must redistribute mfcmifc80.dll with your application. This DLL is a strong-name-signed .NET assembly that can be redistributed with an application in its application local folder or by deploying it to the Global Assembly Cache (GAC) by using the [Gacutil.exe (Global Assembly Cache Tool)](/dotnet/framework/tools/gacutil-exe-gac-tool). +If your MFC application uses Windows Forms controls, you must redistribute mfcmifc80.dll with your application. This DLL is a strong-name-signed .NET assembly. You can redistribute it with an application in its application local folder. You can also deploy it to the Global Assembly Cache (GAC) by using the [Gacutil.exe (Global Assembly Cache Tool)](/dotnet/framework/tools/gacutil-exe-gac-tool). -If you redistribute an MFC DLL, make sure to redistribute the retail version and not the debug version. Debug versions of the DLLs are not redistributable. The names of debug versions of the MFC DLLs end with a "d", for example, Mfc140d.dll. +If you redistribute an MFC DLL, make sure to redistribute the retail version and not the debug version. Debug versions of the DLLs aren't redistributable. The names of debug versions of the MFC DLLs end with a "d," for example, Mfc140d.dll. -You can redistribute MFC by using either VCRedist_*architecture*.exe, merge modules that are installed with Visual Studio, or by deploying the MFC DLL to the same folder as your application. For more information about how to redistribute MFC, see [Redistributing Visual C++ Files](redistributing-visual-cpp-files.md). +You can redistribute MFC by using either VCRedist_*architecture*.exe or merge modules that are installed with Visual Studio. You can also deploy the MFC DLL to the same folder as your application. For more information about how to redistribute MFC, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). -## Installation of Localized MFC Components +## Installation of localized MFC components If you decide to localize your application by installing an MFC localization DLL, you must use the redistributable merge files (.msm). For example, if you want to localize your application on an x86 computer, you must merge Microsoft_VC``_MFCLOC_x86.msm into the installation package for an x86 computer. -The redistributable .msm files contain the DLLs that are used for localization. There is one DLL for each supported language. The installation process installs these DLLs in the %windir%\system32\ folder on the target computer. +The redistributable .msm files contain the DLLs that are used for localization. There's one DLL for each supported language. The installation process installs these DLLs in the %windir%\system32\ folder on the target computer. -For more information about how to localize MFC applications, see [TN057: Localization of MFC Components](../mfc/tn057-localization-of-mfc-components.md). +For more information about how to localize MFC applications, see [TN057: Localization of MFC components](../mfc/tn057-localization-of-mfc-components.md). -You can redistribute MFC localization DLLs by deploying the MFC DLL in your application local folder. For more information about how to redistribute Visual C++ libraries, see [Redistributing Visual C++ Files](redistributing-visual-cpp-files.md). +You can redistribute MFC localization DLLs by deploying the MFC DLL in your application local folder. For more information about how to redistribute Visual C++ libraries, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). -## See also +## Related content -[Redistributing Visual C++ Files](redistributing-visual-cpp-files.md) +- [Redistribute Visual C++ files](redistributing-visual-cpp-files.md) diff --git a/docs/windows/redistributing-visual-cpp-activex-controls.md b/docs/windows/redistributing-visual-cpp-activex-controls.md index f28244442a2..882e4430902 100644 --- a/docs/windows/redistributing-visual-cpp-activex-controls.md +++ b/docs/windows/redistributing-visual-cpp-activex-controls.md @@ -1,38 +1,36 @@ --- -description: "Learn more about: Redistributing Visual C++ ActiveX Controls" -title: "Redistributing Visual C++ ActiveX Controls" +description: "Learn More About: Redistribute Visual C++ ActiveX Controls" +title: Learn more about redistributing Visual C++ ActiveX controls. ms.date: "11/04/2016" helpviewer_keywords: ["controls [C++], redistributing", "controls [C++], distributing"] ms.assetid: eefbb7e4-d28c-4c35-98bf-d9540cfaae83 ms.topic: concept-article --- -# Redistributing Visual C++ ActiveX Controls +# Redistribute Visual C++ ActiveX controls -Visual C++ 6.0 supplies ActiveX controls you can use in applications that you then redistribute. These controls are no longer included in Visual C++. Per the licensing agreements for Visual C++ 6.0, you can redistribute these controls with applications developed in Visual C++. +Visual C++ 6.0 supplies ActiveX controls that you can use in applications that you then redistribute. These controls are no longer included in Visual C++. According to the licensing agreements for Visual C++ 6.0, you can redistribute these controls with applications developed in Visual C++. > [!NOTE] > Visual C++ 6.0 is no longer supported by Microsoft. For a list of the redistributable Visual C++ 6.0 ActiveX controls, see Common\Redist\Redist.txt on Disc 1 of the Visual C++ 6.0 product CD. -When distributing applications, you must install and register the `.ocx` for the ActiveX control (using Regsvr32.exe). In addition, you should make sure the target computer has current versions of the following system files (an asterisk indicates the file needs to be registered): +When you distribute applications, you must install and register the `.ocx` for the ActiveX control (by using Regsvr32.exe). You should also make sure that the target computer has current versions of the following system files (an asterisk indicates that the file must be registered): - Asycfilt.dll - - Comcat.dll \* - - Oleaut32.dll \* - - Olepro32.dll \* - - Stdole2.tlb -If these DLLs are not available on the target system, you need to get them updated using the prescribed mechanism for updating the corresponding operating system. +If these DLLs aren't available on the target system, you must get them updated by using the prescribed mechanism for updating the corresponding operating system. + +When you use an ActiveX control that connects to a database, you also need to replicate the data source name on the target computer. You can do this task programmatically with functions such as `ConfigDSN`. -When using an ActiveX control that connects to a database, you also need to replicate the data source name on the target computer. You can do this programmatically with functions such as `ConfigDSN`. +Some redistributable ActiveX controls have more dependencies. For each `.ocx` file in the Os\System folder on the Visual C++ 6.0 product CD, there's also a `.dep` file. For each `.ocx` file that you want to redistribute, look for one or more USES entries in the corresponding `.dep` file. -Some redistributable ActiveX controls have additional dependencies. For each `.ocx` file in the Os\System folder on the Visual C++ 6.0 product CD, there is also a `.dep` file. For each `.ocx` file that you want to redistribute, look for one or more USES entries in the corresponding `.dep` file. If a file is listed, you must ensure that the file is on the target computer. Any DLLs directly supporting an `.ocx` file need to be registered. (For Regsvr32.exe to succeed, the target computer must first contain all of the DLLs the control statically loads.) Furthermore, if a DLL that is listed as a dependency also has a `.dep` file in the Os\System folder on the Visual C++ 6.0 CD, you must also investigate that `.dep` file for USES entries. +If a file is listed, you must ensure that the file is on the target computer. Any DLLs directly supporting an `.ocx` file must be registered. (For `Regsvr32.exe` to succeed, the target computer must first contain all the DLLs that the control statically loads.) Furthermore, if a DLL that's listed as a dependency also has a `.dep` file in the Os\System folder on the Visual C++ 6.0 CD, you must also investigate that `.dep` file for USES entries. -## See also +## Related content -[Redistributing Visual C++ Files](redistributing-visual-cpp-files.md) +- [Redistribute Visual C++ files](redistributing-visual-cpp-files.md) diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index f96f06bd799..0a1992a3719 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -1,11 +1,11 @@ --- -title: "Redistributing Visual C++ Files" -description: "Visual Studio includes Redistributable libraries and components you can deploy with your app." +title: Redistribute Visual C++ Files +description: Visual Studio includes Redistributable libraries and components that you can deploy with your app. ms.date: 01/15/2025 helpviewer_keywords: ["application deployment [C++], file redistributing", "redistributing applications [C++]", "deploying applications [C++], file redistributing", "file redistribution [C++]", "redistributing applications [C++], about redistributing applications"] ms.topic: concept-article --- -# Redistributing Visual C++ Files +# Redistribute Visual C++ files > [!NOTE] > Are you here because you're looking for a download of one of the Visual C++ Runtime files? Go to the [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) page. @@ -14,17 +14,17 @@ ms.topic: concept-article Distribution of the Visual C++ Runtime Redistributable package, merge modules, and individual binaries is limited to licensed Visual Studio users and is subject to such License Terms. -When you deploy an application, you must also deploy the files that are required to support it. If any of these files are provided by Microsoft, check whether you're permitted to redistribute them. You'll find a link to the Visual Studio license terms in the IDE. Use the License terms link in the About Microsoft Visual Studio dialog box. Or, download the relevant EULAs and licenses from the Visual Studio [License Directory](https://visualstudio.microsoft.com/license-terms/). +When you deploy an application, you must also deploy the files that are required to support it. If any of these files are provided by Microsoft, check whether you're permitted to redistribute them. You can find a link to the Visual Studio license terms in the IDE. Use the License Terms link in the About Microsoft Visual Studio dialog. You can also download the relevant Microsoft Software Licence Terms and licenses from the Visual Studio [License Directory](https://visualstudio.microsoft.com/license-terms/). ::: moniker range="msvc-170" -To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2022 Microsoft Software License Terms, see [Distributable code files for Microsoft Visual Studio 2022](/visualstudio/releases/2022/redistribution#-distributable-code-files-for-visual-studio-2022) +To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2022 Microsoft Software License Terms, see [Distributable code files for Microsoft Visual Studio 2022](/visualstudio/releases/2022/redistribution#-distributable-code-files-for-visual-studio-2022). ::: moniker-end ::: moniker range="msvc-160" -To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2019 Microsoft Software License Terms, see [Distributable Code Files for Microsoft Visual Studio 2019](/visualstudio/releases/2019/redistribution#-distributable-code-files-for-visual-studio-2019) +To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2019 Microsoft Software License Terms, see [Distributable Code Files for Microsoft Visual Studio 2019](/visualstudio/releases/2019/redistribution#-distributable-code-files-for-visual-studio-2019). ::: moniker-end @@ -46,19 +46,27 @@ For more information about redistributable files, see [Determining which DLLs to To deploy redistributable files, you can use the redistributable packages installed by Visual Studio. In versions of Visual Studio since 2017, these files are named *`vc_redist.arm64.exe`*, *`vc_redist.x64.exe`*, and *`vc_redist.x86.exe`*. In Visual Studio 2015, 2017, and 2019, they're also available under the names *`vcredist_x86.exe`*, *`vcredist_x64.exe`*, and (2015 only) *`vcredist_arm.exe`*. -The easiest way to locate the redistributable files is by using environment variables set in a developer command prompt. In Visual Studio 2022, the redistributable files are in the *`%VCINSTALLDIR%Redist\MSVC\v143`* folder. In the latest version of Visual Studio 2019, you'll find the redistributable files in the *`%VCINSTALLDIR%Redist\MSVC\v142`* folder. In both Visual Studio 2017 and Visual Studio 2019, they're also found in *`%VCToolsRedistDir%`*. In Visual Studio 2015, these files can be found in *`%VCINSTALLDIR%redist\`*, where *``* is the locale of the redistributable packages. +The easiest way to locate the redistributable files is by using environment variables set in a developer command prompt. In Visual Studio 2022, the redistributable files are in the *`%VCINSTALLDIR%Redist\MSVC\v143`* folder. In the latest version of Visual Studio 2019, you can find the redistributable files in the *`%VCINSTALLDIR%Redist\MSVC\v142`* folder. In both Visual Studio 2017 and Visual Studio 2019, they're also found in *`%VCToolsRedistDir%`*. In Visual Studio 2015, you can find these files in *`%VCINSTALLDIR%redist\`*, where *``* is the locale of the redistributable packages. -In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named **C++ \ Redistributable MSMs** in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When installed in Visual Studio 2022, you'll find the redistributable merge modules in *`%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`*. In the latest version of Visual Studio 2019, the redistributable merge modules are in *`%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`*. In both Visual Studio 2019 and Visual Studio 2017, they're also found in *`%VCToolsRedistDir%MergeModules`*. In Visual Studio 2015, they're found in *`Program Files [(x86)]\Common Files\Merge Modules`*. +In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When installed in Visual Studio 2022, you can find the redistributable merge modules in *`%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`*. In the latest version of Visual Studio 2019, the redistributable merge modules are in *`%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`*. In both Visual Studio 2019 and Visual Studio 2017, they're also found in *`%VCToolsRedistDir%MergeModules`*. In Visual Studio 2015, they're found in *`Program Files [(x86)]\Common Files\Merge Modules`*. ## Install the redistributable packages -The Visual C++ Redistributable Packages install and register all Visual C++ libraries. If you use one, run it as a prerequisite on the target system before you install your application. We recommend that you use these packages for your deployments because they enable automatic updating of the Visual C++ libraries. For an example about how to use these packages, see [Walkthrough: Deploying a Visual C++ Application By Using the Visual C++ Redistributable Package](deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md). +The Visual C++ Redistributable Packages install and register all Visual C++ libraries. If you use one, run it as a prerequisite on the target system before you install your application. We recommend that you use these packages for your deployments because they enable automatic updating of the Visual C++ libraries. For an example about how to use these packages, see [Walkthrough: Deploying a Visual C++ Application by Using the Visual C++ Redistributable Package](deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md). -Each Visual C++ Redistributable package checks for the existence of a more recent version on the machine. If a more recent version is found, the package won't get installed. In Visual Studio 2015 or later, Redistributable packages display an error message stating that setup failed. If a package is run by using the **`/quiet`** flag, no error message is displayed. In either case, an error is logged by the Microsoft installer, and an error result is returned to the caller. In Visual Studio 2015 and later, you can avoid this error by checking the registry to find out if a more recent version is installed. The current installed version number is stored in the **`HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|arm64}`** key. The version number is 14.0 for Visual Studio 2015, 2017, 2019, and 2022 because the latest Redistributable is binary compatible with previous versions back to 2015. The key is `arm64`, `x86`, or `x64` depending on the installed vcredist versions for the platform. (You need to check under the `Wow6432Node` subkey only if you're using Regedit to view the version of the installed x86 package on an x64 platform.) The version number is stored in the `REG_SZ` string value **`Version`** and also in the set of **`Major`**, **`Minor`**, **`Bld`**, and **`Rbld`** `REG_DWORD` values. To avoid an error at install time, you must skip installation of the Redistributable package if the currently installed version is more recent. +Each Visual C++ Redistributable package checks for the existence of a more recent version on the machine. If a more recent version is found, the package won't get installed. In Visual Studio 2015 or later, Redistributable packages display an error message stating that setup failed. If a package uses the `/quiet` flag to run, no error message is displayed. In either case, an error is logged by the Microsoft installer, and an error result is returned to the caller. + +In Visual Studio 2015 and later, you can avoid this error by checking the registry to find out if a more recent version is installed. The current installed version number is stored in the `HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|arm64}` key. + +The version number is 14.0 for Visual Studio 2015, 2017, 2019, and 2022 because the latest Redistributable is binary compatible with previous versions back to 2015. The key is `arm64`, `x86`, or `x64` depending on the installed vcredist versions for the platform. (You need to check under the `Wow6432Node` subkey only if you use Regedit to view the version of the installed x86 package on an x64 platform.) + +The version number is stored in the `REG_SZ` string value `Version` and also in the set of `Major`, `Minor`, `Bld`, and `Rbld` `REG_DWORD` values. To avoid an error at install time, you must skip installation of the Redistributable package if the currently installed version is more recent. ### Command-line options for the Redistributable packages -The Visual C++ Redistributable supports several command-line options. The `/?`, `/h`, or `/help` options display a pop-up dialog that lists the available options. You may specify `/install` to install, `/repair` to repair, or `/uninstall` to uninstall the Redistributable. The `/layout` option copies the complete contents of the Redistributable in the current directory. By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can specify the `/passive` option, which displays progress, but doesn't otherwise require user interaction. You can also specify a `/quiet` option, which doesn't display any UI or require any user interaction. The `/norestart` option suppresses any attempts to restart. By default, a log file is created in *`%TEMP%`*. You can use `/log filename.txt` to log to a specific file. +The Visual C++ Redistributable supports several command-line options. The `/?`, `/h`, or `/help` options display a dialog that lists the available options. You can specify `/install` to install, `/repair` to repair, or `/uninstall` to uninstall the Redistributable. The `/layout` option copies the complete contents of the Redistributable in the current directory. + +By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can specify the `/passive` option, which displays progress but doesn't otherwise require user interaction. You can also specify a `/quiet` option, which doesn't display any UI or require any user interaction. The `/norestart` option suppresses any attempts to restart. By default, a log file is created in *`%TEMP%`*. You can use `/log filename.txt` to log to a specific file. This example command installs the x64 Redistributable. It shows installation progress, but doesn't require user interaction or a restart: @@ -69,17 +77,19 @@ vc_redist.x64.exe /install /passive /norestart ## Install the redistributable merge modules > [!IMPORTANT] -> Merge modules (*`.msm`* files) for Visual C++ Redistributable files are deprecated. We don't recommend you use them for application deployment. Instead, we recommend central deployment of the Visual C++ Redistributable package. Central deployment by a Redistributable package makes it possible for Microsoft to service runtime library files independently. And, an uninstall of your app can't affect other applications that also use central deployment. When you use a Redistributable package for central deployment, you aren't responsible for tracking and maintaining the runtime libraries. Otherwise, an update to the runtime library files requires you to update and redeploy your *`.msi`* installer. Your app could be vulnerable to bugs or security issues until you do. +> Merge modules (*`.msm`* files) for Visual C++ Redistributable files are deprecated. We don't recommend that you use them for application deployment. Instead, we recommend central deployment of the Visual C++ Redistributable package. Central deployment by a Redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't affect other applications that also use central deployment. +> +> When you use a Redistributable package for central deployment, you aren't responsible for tracking and maintaining the runtime libraries. Otherwise, an update to the runtime library files requires you to update and redeploy your *`.msi`* installer. Your app could be vulnerable to bugs or security issues until you do. -Redistributable merge modules must be included in the Windows Installer package (or similar installation package) that you use to deploy your application. For more information, see [Redistributing by using merge modules](redistributing-components-by-using-merge-modules.md). For an example see [Walkthrough: Deploying a Visual C++ application by using a setup project](walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md). +Redistributable merge modules must be included in the Windows Installer package (or similar installation package) that you use to deploy your application. For more information, see [Redistributing by using merge modules](redistributing-components-by-using-merge-modules.md). For an example, see [Walkthrough: Deploying a Visual C++ application by using a setup project](walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md). ## Install individual redistributable files It's also possible to directly install the Redistributable DLLs in the *application local folder*. The application local folder is the folder that contains your executable application file. For servicing reasons, we don't recommend you use this installation location. -## Potential run-time errors +## Potential runtime errors -If Windows can't find one of the Redistributable library DLLs required by your application, it may display a message similar to: "This application has failed to start because *library*.dll was not found. Reinstalling the application may fix this problem." +If Windows can't find one of the Redistributable library DLLs required by your application, it might display a message similar to: "This application has failed to start because *library*.dll was not found. Reinstalling the application may fix this problem." To resolve this kind of error, make sure your application installer builds correctly. Verify that the Redistributable libraries get deployed correctly on the target system. For more information, see [Understanding the Dependencies of a Visual C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md). From 348b82378b5b2b0632f20d739ffdeb8cf3fb1bb2 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 23 Feb 2026 11:53:29 -0800 Subject: [PATCH 1642/1799] tech review --- docs/build/run-time-library-behavior.md | 14 +----- .../c-runtime-library/crt-library-features.md | 45 +------------------ 2 files changed, 2 insertions(+), 57 deletions(-) diff --git a/docs/build/run-time-library-behavior.md b/docs/build/run-time-library-behavior.md index fbf4bc4c786..82c75be1978 100644 --- a/docs/build/run-time-library-behavior.md +++ b/docs/build/run-time-library-behavior.md @@ -96,10 +96,9 @@ The Win32 SDK samples all use the first method. Refer to the Win32 Programmer's If you wish to use the second method and call the CRT initialization code yourself, instead of using `DllMainCRTStartup()` and `DllMain()`, there are two techniques: -1. If there's no entry function that performs initialization code, specify `_CRT_INIT()` as the entry point of the DLL. Assuming that you've included `NTWIN32.MAK`, which defines `DLLENTRY` as `@12`, add the option to the DLL's link line: `-entry:_CRT_INIT$(DLLENTRY)`. 1. If you do have your own DLL entry point, do the following in the entry point: - a. Use this prototype for `_CRT_INIT()`: `BOOL WINAPI _CRT_INIT(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpReserved);` + a. Use this prototype (defined in `process.h` when `_DECL_DLLMAIN` is defined) for `_CRT_INIT()`: `BOOL WINAPI _CRT_INIT(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpReserved);` For information on `_CRT_INIT()` return values, see the documentation for `DllEntryPoint`; the same values are returned. @@ -131,17 +130,6 @@ BOOL WINAPI DllEntryPoint(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpReserved > [!NOTE] > This isn't necessary if you're using `DllMain()` and `-entry:_DllMainCRTStartup@12`. -### Using NTWIN32.MAK to simplify the build process - -There are macros defined in `NTWIN32.MAK` that can be used to simplify your makefiles and to ensure that they're properly built to avoid conflicts. For this reason, Microsoft highly recommends using `NTWIN32.MAK `and its macros. - -For compilation, use: `$(cvarsdll)` for apps/DLLs using CRT in a DLL. - -For linking, use one of the following: - -- `$(conlibsdll)` for console apps/DLLs using CRT in a DLL -- `$(guilibsdll)` for GUI apps using CRT in a DLL - ### Initialize regular MFC DLLs diff --git a/docs/c-runtime-library/crt-library-features.md b/docs/c-runtime-library/crt-library-features.md index 8795fdd9b27..aba039d6cf2 100644 --- a/docs/c-runtime-library/crt-library-features.md +++ b/docs/c-runtime-library/crt-library-features.md @@ -1,7 +1,7 @@ --- title: "C runtime (CRT) and C++ standard library (STL) lib files" description: "List of Microsoft C runtime and C++ standard library (STL) lib files that you can link against and their associated compiler options and preprocessor directives." -ms.date: "3/5/2021" +ms.date: 02/23/2026 ms.topic: "reference" helpviewer_keywords: ["MSVCR71.dll", "libraries [C++], multithreaded", "library files, run-time", "LIBCMT.lib", "LIBCP.lib", "LIBCPMT.lib", "run-time libraries, C", "CRT, release versions", "MSVCP71.dll", "LIBC.lib", "libraries [C++]", "libraries [C++], run-time", "linking [C++], libraries", "STL libraries", "Microsoft standard template libraries"] --- @@ -104,49 +104,6 @@ It's also possible to avoid some of these issues if all of the images in your pr Be careful if your program passes certain CRT resources across DLL boundaries. Resources such as file handles, locales, and environment variables can cause problems, even when using the same version of the CRT. For more information on the issues involved and how to resolve them, see [Potential errors passing CRT objects across DLL boundaries](./potential-errors-passing-crt-objects-across-dll-boundaries.md). -### Problems with statically linked CRT libraries - -There are three forms of the C Run-time library provided with the Win32 SDK: - -- `LIBC.LIB` is a statically linked library for single-threaded programs. -- `LIBCMT.LIB` is a statically linked library that supports multithreaded programs. -- `CRTDLL.LIB` is an import library for `CRTDLL.DLL` that also supports multithreaded programs. `CRTDLL.DLL` is part of Windows NT. - -Microsoft Visual C++ 32-bit edition contains these three forms as well, however, the CRT in a DLL is named `MSVCRT.LIB`. The DLL is redistributable. Its name depends on the version of VC++ (that is, `MSVCRT10.DLL` or `MSVCRT20.DLL`). Note however, that `MSVCRT10.DLL` is not supported on Win32s, while `CRTDLL.LIB` is supported on Win32s. `MSVCRT20.DLL` comes in two versions: one for Windows NT and the other for Win32s. - -If an application that makes C runtime calls links to a DLL that also makes C runtime calls, be aware that if they are both linked with one of the statically linked C runtime libraries, the `.EXE` and DLL will have separate copies of all C runtime functions and global variables. This means that C runtime data cannot be shared between the `.EXE` and the DLL. Some of the problems that can occur are: - -- Passing buffered stream handles from the .EXE/DLL to the other module -- Allocating memory with a C runtime call in the .EXE/DLL and reallocating or freeing it in the other module -- Checking or setting the value of the global `errno` variable in the .EXE/DLL and expecting it to be the same in the other module. A related problem is calling `perror()` in the opposite module from where the C runtime error occurred, since `perror()` uses `errno`. - -To avoid these problems, link both the `.EXE` and DLL with `CRTDLL.LIB` or `MSVCRT.LIB`, which allows both the `.EXE` and DLL to use the common set of functions and data contained within CRT in a DLL, and C runtime data such as stream handles can then be shared by both the `.EXE` and DLL. - -### Mixing library types - -You can link your DLL with `CRTDLL.LIB`/`MSVCRT.LIB` regardless of what your `.EXE` is linked with if you avoid mixing CRT data structures and passing CRT file handles or CRT `FILE*` pointers to other modules. - -When mixing library types adhere to the following: - -- CRT file handles may only be operated on by the CRT module that created them. -- CRT `FILE*` pointers may only be operated on by the CRT module that created them. -- Memory allocated with the CRT function `malloc()` may only be freed or reallocated by the CRT module that allocated it. - -To illustrate this, consider the following example: - -- `.EXE` is linked with `MSVCRT.LIB` -- DLL A is linked with `LIBCMT.LIB` -- DLL B is linked with `CRTDLL.LIB` - -If the `.EXE` creates a CRT file handle using `_create()` or `_open()`, this file handle may only be passed to `_lseek()`, `_read()`, `_write()`, `_close()`, etc. in the `.EXE` file. Do not pass this CRT file handle to either DLL. Do not pass a CRT file handle obtained from either DLL to the other DLL or to the `.EXE`. - -If DLL A allocates a block of memory with `malloc()`, only DLL A may call `free()`, `_expand()`, or `realloc()` to operate on that block. You cannot call `malloc()` from DLL A and try to free that block from the `.EXE` or from DLL B. - -> [!NOTE] -> If all three modules were linked with `CRTDLL.LIB` or all three were linked with `MSVCRT.LIB`, these restrictions would not apply. - -When linking DLLs with `LIBC.LIB`, be aware that if there is a possibility that such a DLL will be called by a multithreaded program, the DLL will not support multiple threads running in the DLL at the same time, which can cause major problems. If there is a possibility that the DLL will be called by multithreaded programs, be sure to link it with one of the libraries that support multithreaded programs (`LIBCMT.LIB`, `CRTDLL.LIB`, or `MSVCRT.LIB`). - ## See also [C runtime library reference](./c-run-time-library-reference.md)\ From c92211077384aef4a1ac982c1c2f14883166040f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 23 Feb 2026 13:53:00 -0800 Subject: [PATCH 1643/1799] tech review --- docs/build/run-time-library-behavior.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/build/run-time-library-behavior.md b/docs/build/run-time-library-behavior.md index 82c75be1978..7f0e5063991 100644 --- a/docs/build/run-time-library-behavior.md +++ b/docs/build/run-time-library-behavior.md @@ -7,11 +7,11 @@ helpviewer_keywords: ["DLLs [C++], entry point function", "process detach [C++]" --- # DLLs and Visual C++ runtime library behavior -When you build a Dynamic-link Library (DLL) by using Visual Studio, by default, the linker includes the Visual C++ runtime library (VCRuntime). The VCRuntime contains code required to initialize and terminate a C/C++ executable. When linked into a DLL, the VCRuntime code provides an internal DLL entry-point function called `_DllMainCRTStartup` that handles Windows OS messages to the DLL to attach to or detach from a process or thread. The `_DllMainCRTStartup` function performs essential tasks such as stack buffer security setup, C runtime library (CRT) initialization and termination, and calls to constructors and destructors for static and global objects. `_DllMainCRTStartup` also calls hook functions for other libraries such as WinRT, MFC, and ATL to perform their own initialization and termination. Without this initialization, the CRT and other libraries, and your static variables, would be left in an uninitialized state. The same VCRuntime internal initialization and termination routines are called whether your DLL uses a statically linked CRT or a dynamically linked CRT DLL. +When you build a Dynamic-link Library (DLL) using Visual Studio, by default, the linker includes the Visual C++ runtime library (VCRuntime). The VCRuntime contains code required to initialize and terminate a C/C++ executable. When linked into a DLL, the VCRuntime code provides an internal DLL entry-point function called `_DllMainCRTStartup` that handles Windows OS messages to the DLL to attach to or detach from a process or thread. The `_DllMainCRTStartup` function performs essential tasks such as stack buffer security setup, C runtime library (CRT) initialization and termination, and calls to constructors and destructors for static and global objects. `_DllMainCRTStartup` also calls hook functions for other libraries such as WinRT, MFC, and ATL to perform their own initialization and termination. Without this initialization, the CRT and other libraries, and your static variables, would be left in an uninitialized state. The same VCRuntime internal initialization and termination routines are called whether your DLL uses a statically linked CRT or a dynamically linked CRT DLL. ## Default DLL entry point _DllMainCRTStartup -In Windows, all DLLs can contain an optional entry-point function, usually called `DllMain`, that is called for both initialization and termination. This gives you an opportunity to allocate or release other resources as needed. Windows calls the entry-point function in four situations: process attach, process detach, thread attach, and thread detach. When a DLL is loaded into a process address space, either when an application that uses it is loaded, or when the application requests the DLL at runtime, the operating system creates a separate copy of the DLL data. This is called *process attach*. *Thread attach* occurs when the process the DLL is loaded in creates a new thread. *Thread detach* occurs when the thread terminates, and *process detach* is when the DLL is no longer required and is released by an application. The operating system makes a separate call to the DLL entry point for each of these events, passing a *reason* argument for each event type. For example, the OS sends `DLL_PROCESS_ATTACH` as the *reason* argument to signal process attach. +In Windows, all DLLs can contain an optional entry-point function, usually called `DllMain`, that is called for both initialization and termination. This gives you an opportunity to allocate or release other resources as needed. Windows calls the entry-point function in four situations: process attach, process detach, thread attach, and thread detach. When a DLL is loaded into a process address space, either when an application that uses it's loaded, or when the application requests the DLL at runtime, the operating system creates a separate copy of the DLL data. This is called *process attach*. *Thread attach* occurs when the process the DLL is loaded in creates a new thread. *Thread detach* occurs when the thread terminates, and *process detach* is when the DLL is no longer required and is released by an application. The operating system makes a separate call to the DLL entry point for each of these events, passing a *reason* argument for each event type. For example, the OS sends `DLL_PROCESS_ATTACH` as the *reason* argument to signal process attach. The VCRuntime library provides an entry-point function called `_DllMainCRTStartup` to handle default initialization and termination operations. On process attach, the `_DllMainCRTStartup` function sets up buffer security checks, initializes the CRT and other libraries, initializes runtime type information, initializes and calls constructors for static and nonlocal data, initializes thread-local storage, increments an internal static counter for each attach, and then calls a user- or library-supplied `DllMain`. On process detach, the function goes through these steps in reverse. It calls `DllMain`, decrements the internal counter, calls destructors, calls CRT termination functions and registered `atexit` functions, and notifies any other libraries of termination. When the attachment counter goes to zero, the function returns `FALSE` to indicate to Windows that the DLL can be unloaded. The `_DllMainCRTStartup` function is also called during thread attach and thread detach. In these cases, the VCRuntime code does no other initialization or termination on its own, and just calls `DllMain` to pass the message along. If `DllMain` returns `FALSE` from process attach, signaling failure, `_DllMainCRTStartup` calls `DllMain` again and passes `DLL_PROCESS_DETACH` as the *reason* argument, then goes through the rest of the termination process. @@ -81,14 +81,14 @@ extern "C" BOOL WINAPI DllMain ( ``` > [!NOTE] -> Older Windows SDK documentation says that the actual name of the DLL entry-point function must be specified on the linker command-line with the `/ENTRY` option. With Visual Studio, you don't need to use the `/ENTRY` option if the name of your entry-point function is `DllMain`. In fact, if you use the `/ENTRY` option and name your entry-point function something other than `DllMain`, the CRT does not get initialized properly unless your entry-point function makes the same initialization calls that `_DllMainCRTStartup` makes. +> Older Windows SDK documentation says that the actual name of the DLL entry-point function must be specified on the linker command-line with the `/ENTRY` option. With Visual Studio, you don't need to use the `/ENTRY` option if the name of your entry-point function is `DllMain`. In fact, if you use the `/ENTRY` option and name your entry-point function something other than `DllMain`, the CRT doesn't get initialized properly unless your entry-point function makes the same initialization calls that `_DllMainCRTStartup` makes. ### Manual CRT initialization with `_CRT_INIT` When building a DLL that uses any of the C runtime libraries, in order to ensure that the CRT is properly initialized, either: 1. The initialization function must be named `DllMain()` and the entry point must be specified with the linker option `-entry:_DllMainCRTStartup@12`, or -1. The DLL's entry point must explicitly call `_CRT_INIT()` on process attach and process detach. +1. The DLL's entry point must explicitly call `_CRT_INIT()` on process attach and process detach. This is only relevant if you are using `/NOENTRY` or have a custom entry point. We don't recommend using `/NOENTRY` or a custom entry point, if possible, because you would have to duplicate all of the initialization and termination code that `_DllMainCRTStartup` provides, in the same order. This permits the C runtime libraries to properly allocate and initialize C runtime data when a process or thread is attaching to the DLL, to properly clean up C runtime data when a process is detaching from the DLL, and for global C++ objects in the DLL to be properly constructed and destructed. @@ -195,21 +195,21 @@ In the `DllMain` that the MFC DLL Wizard generates, the call to `AfxInitExtensio If your MFC extension DLL is explicitly linked to an executable (meaning the executable calls `AfxLoadLibrary` to link to the DLL), you should add a call to `AfxTermExtensionModule` on `DLL_PROCESS_DETACH`. This function allows MFC to clean up the MFC extension DLL when each process detaches from the MFC extension DLL (which happens when the process exits or when the DLL is unloaded as a result of a `AfxFreeLibrary` call). If your MFC extension DLL is linked implicitly to the application, the call to `AfxTermExtensionModule` isn't necessary. -Applications that explicitly link to MFC extension DLLs must call `AfxTermExtensionModule` when freeing the DLL. They should also use `AfxLoadLibrary` and `AfxFreeLibrary` (instead of the Win32 functions `LoadLibrary` and `FreeLibrary`) if the application uses multiple threads. Using `AfxLoadLibrary` and `AfxFreeLibrary` ensures that the startup and shutdown code that executes when the MFC extension DLL is loaded and unloaded does not corrupt the global MFC state. +Applications that explicitly link to MFC extension DLLs must call `AfxTermExtensionModule` when freeing the DLL. They should also use `AfxLoadLibrary` and `AfxFreeLibrary` (instead of the Win32 functions `LoadLibrary` and `FreeLibrary`) if the application uses multiple threads. Using `AfxLoadLibrary` and `AfxFreeLibrary` ensures that the startup and shutdown code that executes when the MFC extension DLL is loaded and unloaded doesn't corrupt the global MFC state. Because the MFCx0.dll is fully initialized by the time `DllMain` is called, you can allocate memory and call MFC functions within `DllMain` (unlike the 16-bit version of MFC). -Extension DLLs can take care of multithreading by handling the `DLL_THREAD_ATTACH` and `DLL_THREAD_DETACH` cases in the `DllMain` function. These cases are passed to `DllMain` when threads attach and detach from the DLL. Calling [TlsAlloc](/windows/win32/api/processthreadsapi/nf-processthreadsapi-tlsalloc) when a DLL is attaching allows the DLL to maintain thread local storage (TLS) indexes for every thread attached to the DLL. +Extension DLLs can take care of multithreading by handling the `DLL_THREAD_ATTACH` and `DLL_THREAD_DETACH` cases in the `DllMain` function. These cases are passed to `DllMain` when threads attach and detach from the DLL. Calling [`TlsAlloc`](/windows/win32/api/processthreadsapi/nf-processthreadsapi-tlsalloc) when a DLL is attaching allows the DLL to maintain thread local storage (TLS) indexes for every thread attached to the DLL. The header file `Afxdllx.h` contains special definitions for structures used in MFC extension DLLs, such as the definition for `AFX_EXTENSION_MODULE` and `CDynLinkLibrary`. You should include this header file in your MFC extension DLL. > [!NOTE] -> It's important that you neither define nor undefine any of the `_AFX_NO_XXX` macros in *pch.h* (*stdafx.h* in Visual Studio 2017 and earlier). These macros exist only to check whether a particular target platform supports that feature or not. You can write your program to check these macros (for example, `#ifndef _AFX_NO_OLE_SUPPORT`), but your program should never define or undefine these macros. +> It's important that you don't define or undefine any of the `_AFX_NO_XXX` macros in `pch.h` (`stdafx.h` in Visual Studio 2017 and earlier). These macros exist only to check whether a particular target platform supports that feature or not. You can write your program to check these macros (for example, `#ifndef _AFX_NO_OLE_SUPPORT`), but your program should never define or undefine these macros. A sample initialization function that handles multithreading is included in [Using Thread Local Storage in a Dynamic-Link Library](/windows/win32/Dlls/using-thread-local-storage-in-a-dynamic-link-library) in the Windows SDK. Note that the sample contains an entry-point function called `LibMain`, but you should name this function `DllMain` so that it works with the MFC and C runtime libraries. ## See also -[Create C/C++ DLLs in Visual Studio](dlls-in-visual-cpp.md)
-[DllMain entry point](/windows/win32/Dlls/dllmain)
+[Create C/C++ DLLs in Visual Studio](dlls-in-visual-cpp.md)\ +[DllMain entry point](/windows/win32/Dlls/dllmain)\ [Dynamic-link Library Best Practices](/windows/win32/Dlls/dynamic-link-library-best-practices) From fa4159b2711d9b3f734f4ccf0688102a74072417 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 23 Feb 2026 14:45:31 -0800 Subject: [PATCH 1644/1799] Clarify processor environment for C4235 example Updated comment to clarify processor environment setup. --- .../compiler-warnings/compiler-warning-level-4-c4235.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md index 5cb82b34371..b1fa9f92226 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4235.md @@ -21,7 +21,7 @@ The following example generates C4235 as the [Inline Assembler](../../assembler/ ```cpp // C4235.cpp -// processor: x64 +// processor: x64 (set compiler environment with vcvars64.bat) int main() { From 8e05527d04f8029e6bf99983b2ec96c8ad5569b2 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 23 Feb 2026 14:58:56 -0800 Subject: [PATCH 1645/1799] expand on example --- .../compiler-warning-level-4-c4324.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md index 5aed86571e3..412a1180f29 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md @@ -21,13 +21,23 @@ For example, `S1` and `S2` generates C4324 because padding is added when the spe // C4324.cpp // compile with: /W4 /c -struct alignas(4) S1 {}; // C4324 - -struct alignas(8) S2 +struct alignas(8) S1 // C4324 { int i; }; // C4324 +union alignas(16) U1 +{ + int i; + float f; +}; // C4324 + +class alignas(8) C1 +{ +public: + int i = 0; +}; // C4324 + struct alignas(4) S3 { int i; From e66f1cef419c2e093375e03d03be2120ba1a9c80 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 23 Feb 2026 15:01:09 -0800 Subject: [PATCH 1646/1799] Clarify example for compiler warning C4324 --- .../compiler-warnings/compiler-warning-level-4-c4324.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md index 412a1180f29..d5643369a70 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md @@ -15,7 +15,7 @@ Padding was added at the end of a class/struct/union because you specified an al ## Example -For example, `S1` and `S2` generates C4324 because padding is added when the specified alignment is greater than the default alignment of `1` and `4` respectively: +For example, `S1`, `S2`, `U1`, and `C1` generate C4324 because padding is added when the specified alignment is greater than the default alignment for each: ```cpp // C4324.cpp From 57ba3227feadeb739d4b2e61566c424e9905fd86 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 23 Feb 2026 15:11:58 -0800 Subject: [PATCH 1647/1799] Fix alignment description in C4324 warning example expanded the example --- .../compiler-warning-level-4-c4324.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md index d5643369a70..e26ff5d09b0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md @@ -15,31 +15,35 @@ Padding was added at the end of a class/struct/union because you specified an al ## Example -For example, `S1`, `S2`, `U1`, and `C1` generate C4324 because padding is added when the specified alignment is greater than the default alignment for each: +For example, `S1`, `U1`, and `C1` generate C4324 because padding is added when the specified alignment is greater than the nautral alignment for each. `S2` doesn't generate a warning because the specified aligment matches the natural alignment: ```cpp // C4324.cpp // compile with: /W4 /c +// natural 4 byte alignment struct alignas(8) S1 // C4324 { int i; }; // C4324 +// natural 4 byte alignment +struct alignas(4) S2 +{ + int i; +}; // OK + +// natural 4 byte alignment union alignas(16) U1 { int i; - float f; + char c; }; // C4324 +// natural 4 byte alignment class alignas(8) C1 { public: int i = 0; }; // C4324 - -struct alignas(4) S3 -{ - int i; -}; // OK ``` From f6a14b71eca9e42ff1eae76960c753b745f72024 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 23 Feb 2026 15:31:57 -0800 Subject: [PATCH 1648/1799] tech review --- docs/build/run-time-library-behavior.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/build/run-time-library-behavior.md b/docs/build/run-time-library-behavior.md index 7f0e5063991..1b755df2623 100644 --- a/docs/build/run-time-library-behavior.md +++ b/docs/build/run-time-library-behavior.md @@ -1,7 +1,7 @@ --- description: "Learn more about: DLLs and Microsoft C++ runtime library behavior" title: "DLLs and Visual C++ runtime library behavior" -ms.date: "08/19/2019" +ms.date: 02/23/2026 f1_keywords: ["_DllMainCRTStartup", "CRT_INIT"] helpviewer_keywords: ["DLLs [C++], entry point function", "process detach [C++]", "process attach [C++]", "DLLs [C++], run-time library behavior", "DllMain function", "_CRT_INIT macro", "_DllMainCRTStartup method", "run-time [C++], DLL startup sequence", "DLLs [C++], startup sequence"] --- @@ -87,8 +87,8 @@ extern "C" BOOL WINAPI DllMain ( When building a DLL that uses any of the C runtime libraries, in order to ensure that the CRT is properly initialized, either: -1. The initialization function must be named `DllMain()` and the entry point must be specified with the linker option `-entry:_DllMainCRTStartup@12`, or -1. The DLL's entry point must explicitly call `_CRT_INIT()` on process attach and process detach. This is only relevant if you are using `/NOENTRY` or have a custom entry point. We don't recommend using `/NOENTRY` or a custom entry point, if possible, because you would have to duplicate all of the initialization and termination code that `_DllMainCRTStartup` provides, in the same order. +- The initialization function must be named `DllMain()` and the entry point must be specified with the linker option `-entry:_DllMainCRTStartup@12` This is the default behavior when building a DLL (the `@12` is x86-only because that platform uses `stdcall`), or +- The DLL's entry point must explicitly call `_CRT_INIT()` on process attach and process detach. This is only relevant if you are using `/NOENTRY` or have a custom entry point. We don't recommend using `/NOENTRY` or a custom entry point, if possible, because you would have to duplicate all of the initialization and termination code that `_DllMainCRTStartup` provides, in the same order. This permits the C runtime libraries to properly allocate and initialize C runtime data when a process or thread is attaching to the DLL, to properly clean up C runtime data when a process is detaching from the DLL, and for global C++ objects in the DLL to be properly constructed and destructed. From 494666fe008ababc85d0cf1c3b047d5622887212 Mon Sep 17 00:00:00 2001 From: Hulon Jenkins <109993038+HulonJenkins@users.noreply.github.com> Date: Mon, 23 Feb 2026 16:15:39 -0800 Subject: [PATCH 1649/1799] MSLearn page feedback from preserve_none author --- docs/build/x64-calling-convention.md | 3 ++- docs/cpp/preserve-none.md | 4 ++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/build/x64-calling-convention.md b/docs/build/x64-calling-convention.md index d9bf0d97b40..ff47e9dfd76 100644 --- a/docs/build/x64-calling-convention.md +++ b/docs/build/x64-calling-convention.md @@ -8,7 +8,8 @@ ms.topic: concept-article This article describes the standard processes and conventions that one function (the caller) uses to make calls into another function (the callee) in x64 code. -For more information about the `__vectorcall` calling convention, see [__vectorcall](../cpp/vectorcall.md). +For more information about the `__vectorcall` calling convention, see [__vectorcall](../cpp/vectorcall.md). +For more information about the `__preserve_none` calling convention, see [__preserve_none](../cpp/preserve-none.md). ## Calling convention defaults diff --git a/docs/cpp/preserve-none.md b/docs/cpp/preserve-none.md index f90d613bc96..ba7d97cf3b4 100644 --- a/docs/cpp/preserve-none.md +++ b/docs/cpp/preserve-none.md @@ -21,10 +21,10 @@ The following list shows the behavior of this calling convention. | Element | Behavior | |---------|----------------| | Argument-passing order | Arguments are passed in up to 10 registers in the following order: `r13`, `r14`, `r15`, `rbx`, `rsi`, `rdi`, `r9`, `r8`, `rdx`, `rcx`. If a hidden parameter is required for struct returns, it's passed in `r13` (the first parameter register), reducing available parameter registers to 9. Registers `r10`-`r12` are reserved for various CRT and Windows runtimes. All parameters must be passed through registers; stack-based parameters aren't currently supported. | -| Register allocation strategy | To help minimize register spilling, the allocator assigns `r9`, `r8`, `rdx`, and `rcx` only after other registers have been used. | +| Register allocation strategy | To help minimize register spilling when calling functions with different calling conventions, the allocator assigns `rcx`, `rdx`, `r8`, and `r9` only after other registers have been used, since those registers are used first by the [__vectorcall](vectorcall.md) and [__cdecl](cdecl.md) calling conventions. | | Argument limit | Functions are restricted to a maximum of 10 parameters. An error is generated if this limit is exceeded. | | Return value convention | Follows the regular x64 calling convention rules. Scalar return values are returned in `rax`. Structs of size 1, 2, 4, or 8 bytes are returned through the `rax` register. For structs of other sizes, a pointer to memory allocated by the caller and passed through the hidden parameter is returned in `rax`. | -| Volatile registers | All general-purpose registers except `rsp` (stack pointer) and `rbp` (base pointer) are treated as volatile and don't need to be preserved across function calls. While `r10` and `r11` are volatile, they aren't used for parameter passing to maintain compatibility with existing programs. | +| Volatile registers | All general-purpose registers except `r12`, `rsp` (stack pointer) and `rbp` (base pointer) are treated as volatile and don't need to be preserved across function calls. While `r10` and `r11` are volatile, they aren't used for parameter passing to maintain compatibility with existing programs. | | Nonvolatile registers | Only `rsp`, `rbp`, and `r12` are nonvolatile. | | Stack alignment | The stack must maintain 16-byte alignment. | | Frame pointer | The `rbp` register and frame chain follow the [/Gy switch](../build/reference/gy-enable-function-level-linking.md) settings. | From 603930774fd8661dcbc16bc873d51104fd3ee7a5 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 23 Feb 2026 16:20:12 -0800 Subject: [PATCH 1650/1799] test if reverts --- docs/c-runtime-library/crt-library-features.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/crt-library-features.md b/docs/c-runtime-library/crt-library-features.md index aba039d6cf2..165f5090864 100644 --- a/docs/c-runtime-library/crt-library-features.md +++ b/docs/c-runtime-library/crt-library-features.md @@ -1,7 +1,7 @@ --- title: "C runtime (CRT) and C++ standard library (STL) lib files" description: "List of Microsoft C runtime and C++ standard library (STL) lib files that you can link against and their associated compiler options and preprocessor directives." -ms.date: 02/23/2026 +ms.date: "3/5/2021" ms.topic: "reference" helpviewer_keywords: ["MSVCR71.dll", "libraries [C++], multithreaded", "library files, run-time", "LIBCMT.lib", "LIBCP.lib", "LIBCPMT.lib", "run-time libraries, C", "CRT, release versions", "MSVCP71.dll", "LIBC.lib", "libraries [C++]", "libraries [C++], run-time", "linking [C++], libraries", "STL libraries", "Microsoft standard template libraries"] --- From 606fc4000d06a5f640ace7e99bb5c2cac4046140 Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Mon, 23 Feb 2026 16:47:41 -0800 Subject: [PATCH 1651/1799] edit pass: redistributing-microsoft-c++-files --- ...uting-components-by-using-merge-modules.md | 22 +++--- .../windows/redistributing-the-mfc-library.md | 32 ++++---- ...istributing-visual-cpp-activex-controls.md | 16 ++-- .../redistributing-visual-cpp-files.md | 77 ++++++++----------- 4 files changed, 67 insertions(+), 80 deletions(-) diff --git a/docs/windows/redistributing-components-by-using-merge-modules.md b/docs/windows/redistributing-components-by-using-merge-modules.md index e338d1c8b25..531ef3479d0 100644 --- a/docs/windows/redistributing-components-by-using-merge-modules.md +++ b/docs/windows/redistributing-components-by-using-merge-modules.md @@ -9,27 +9,27 @@ ms.topic: concept-article # Redistribute components by using merge modules > [!IMPORTANT] -> In Visual Studio 2019 and later, merge modules for Visual C++ Redistributable files are deprecated. We don't recommend that you use them for application deployment. Redistributables installed by using merge modules can't be updated by Windows Update because the detection mechanism depends on knowing details of the installing package. +> In Visual Studio 2019 and later, merge modules for Visual C++ Redistributable files are deprecated. We don't recommend that you use them for application deployment. Windows Update can't update redistributable files installed by using merge modules because the detection mechanism depends on knowing details of the installing package. > -> The Visual C++ Redistributable packages are known for each release, but packages that use MSMs are user generated. Microsoft can't know the details of user-generated packages. Instead, we recommend that you use central deployment of the Visual C++ Redistributable package. Central deployment installs the Redistributable files in the Windows *`%SYSTEMROOT%\system32\`* folder for use by all applications and users. Central deployment by a Redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't break other applications that also use central deployment. +> The Visual C++ Redistributable Packages are known for each release, but packages that use MSMs are user generated. Microsoft can't know the details of user-generated packages. Instead, we recommend that you use central deployment of the Visual C++ Redistributable Package. Central deployment installs the redistributable files in the Windows `%SYSTEMROOT%\system32\` folder for use by all applications and users. Central deployment by a redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't break other applications that also use central deployment. > -> When you use a Redistributable package for central deployment, you aren't responsible for tracking and updating the runtime libraries as part of your application maintenance. The Microsoft Update service updates these libraries for you. Otherwise, an update to the runtime library files requires you to update and redeploy your *`.msi`* installer. Your app could be vulnerable to bugs or security issues until you do. +> When you use a redistributable package for central deployment, you aren't responsible for tracking and updating the runtime libraries as part of your application maintenance. The Microsoft Update service updates these libraries for you. Otherwise, an update to the runtime library files requires you to update and redeploy your `.msi` installer. Your app could be vulnerable to bugs or security issues until you do. -Visual Studio includes [merge modules](/windows/win32/Msi/about-merge-modules) (*`.msm`* files) for each Visual C++ component that's licensed for redistribution with an application. There are separate versions of the merge modules for each target platform. When a merge module is compiled into a Windows Installer setup file, it enables the deployment of Visual C++ Redistributable files to that specific platform. You can't include merge modules for different versions of the same dynamic link library (DLL) in one installer. In your installer setup file, specify that the merge modules are prerequisites for your application. +Visual Studio includes [merge modules](/windows/win32/Msi/about-merge-modules) (`.msm` files) for each Visual C++ component that's licensed for redistribution with an application. There are separate versions of the merge modules for each target platform. When a merge module is compiled into a Windows Installer setup file, it enables the deployment of Visual C++ Redistributable files to that specific platform. You can't include merge modules for different versions of the same dynamic link library (DLL) in one installer. In your installer setup file, specify that the merge modules are prerequisites for your application. -You can use merge modules for either [central deployment](deployment-in-visual-cpp.md#central-deployment) or [local deployment](deployment-in-visual-cpp.md#local-deployment). Users can't install centrally deployed files unless they have administrator rights. Local deployment might allow a non-administrator to install and run your app, but at the cost of independent serviceability. +You can use merge modules for either [central deployment](deployment-in-visual-cpp.md#central-deployment) or [local deployment](deployment-in-visual-cpp.md#local-deployment). Users can't install centrally deployed files unless they have administrator rights. Local deployment might allow a nonadministrator to install and run your app, but at the cost of independent serviceability. The installation service reports an error if you attempt central deployment of older merge modules over newer existing libraries. You should write your installer setup to handle this failure gracefully and not display an error message. Your code can still deploy and run successfully despite this failure. For more information, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). -If you deploy your code only as an *`.msi`* installer, we recommend that you don't include the merge modules in the installer. Instead, report a failure to the user when the required Redistributable libraries aren't found. In the failure dialog, include instructions on how to find and install the latest Redistributable package. For more information and links to Redistributable packages, see [the latest supported Visual C++ downloads](latest-supported-vc-redist.md). +If you deploy your code only as an `.msi` installer, we recommend that you don't include the merge modules in the installer. Instead, report a failure to the user when the required redistributable libraries aren't found. In the failure dialog, include instructions on how to find and install the latest redistributable package. For more information and links to redistributable packages, see [the latest supported Visual C++ downloads](latest-supported-vc-redist.md). -The latest Redistributable packages and merge modules are compatible with code built by using Visual Studio 2015 and later. Code built by versions of Visual Studio before 2015 require a separate Redistributable package. +The latest redistributable packages and merge modules are compatible with code built by using Visual Studio 2015 and later. Code built by versions of Visual Studio before 2015 require a separate redistributable package. ## When to use merge modules -Merge modules are only appropriate in limited circumstances: +Merge modules are appropriate only in limited circumstances: -- You can't install or require a separate Redistributable package for policy reasons. +- You can't install or require a separate redistributable package for policy reasons. - Your code requires a specific, bug-compatible version of the libraries. - Your code targets only one platform, and you don't have dependencies on more than one version of the DLLs. - You intend to service your deployed code regularly so that the libraries remain up to date. @@ -38,9 +38,9 @@ When you use merge modules, you must track and regularly service your applicatio ## Where to find merge module files -In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When installed in Visual Studio 2022, you can find the Visual C++ Redistributable merge modules in *`%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`*. +In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ installation in Visual Studio 2017 and Visual Studio 2015. When the merge modules are installed in Visual Studio 2022, you can find the Visual C++ Redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. -In the latest version of Visual Studio 2019, the merge modules are in *`%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`*. In both Visual Studio 2019 and Visual Studio 2017, they're also found in *`%VCToolsRedistDir%MergeModules`*. In Visual Studio 2015, they're found in *`Program Files [(x86)]\Common Files\Merge Modules`*. For more information and a link to a list of Redistributable merge modules, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). +In the latest version of Visual Studio 2019, the merge modules are in `%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`. In both Visual Studio 2019 and Visual Studio 2017, they're also found in `%VCToolsRedistDir%MergeModules`. In Visual Studio 2015, they're found in `Program Files [(x86)]\Common Files\Merge Modules`. For more information and a link to a list of redistributable merge modules, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). ## Related content diff --git a/docs/windows/redistributing-the-mfc-library.md b/docs/windows/redistributing-the-mfc-library.md index 512a0ae3a0a..313859cce13 100644 --- a/docs/windows/redistributing-the-mfc-library.md +++ b/docs/windows/redistributing-the-mfc-library.md @@ -1,44 +1,44 @@ --- description: "Learn More About: Redistribute the MFC Library" -title: Learn more about redistributing the MFC Library. +title: Learn more about redistributing the MFC library. ms.date: "11/04/2016" helpviewer_keywords: ["MFC, redistributing", "redistributing MFC library"] ms.assetid: 72714ce1-385e-4c1c-afa5-96b03e873866 ms.topic: concept-article --- -# Redistribute the MFC Library +# Redistribute the MFC library -If you dynamically link your application to the Microsoft Foundation Class (MFC) library, you must redistribute the matching MFC dynamic link library (DLL). For example, if your MFC app is built by using the version of MFC that ships with Visual Studio 2015, you must redistribute mfc140.dll or mfc140u.dll, depending on whether your app is compiled for narrow characters or Unicode support. +If you dynamically link your application to the Microsoft Foundation Class (MFC) library, you must redistribute the matching MFC dynamic link library (DLL). For example, if your MFC app is built by using the version of MFC that ships with Visual Studio 2015, you must redistribute `mfc140.dll` or `mfc140u.dll`, depending on whether your app is compiled for narrow characters or Unicode support. > [!NOTE] -> The mfc140.dll files were omitted from the redistributable files directory in Visual Studio 2015 RTM. You can use the versions installed by Visual Studio 2015 in the Windows\system32 and Windows\syswow64 directories instead. +> The `mfc140.dll` files were omitted from the redistributable files directory in Visual Studio 2015 RTM. You can use the versions installed by Visual Studio 2015 in the `Windows\system32 and Windows\syswow64` directories instead. -Because all MFC DLLs use the shared version of the C runtime library (CRT), you might also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the universal CRT library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. +Because all MFC DLLs use the shared version of the C runtime library (CRT), you might also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the Universal CRT library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. -For information on how to redistribute the universal CRT as an operating system component or by using local deployment, see [Introducing the Universal CRT](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the universal CRT for central deployment on supported versions of Windows, see [Windows 10 Universal C Runtime](https://www.microsoft.com/download/details.aspx?id=48234). +For information on how to redistribute the Universal CRT as an operating system component or by using local deployment, see [Introducing the Universal CRT](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the Universal CRT for central deployment on supported versions of Windows, see [Windows 10 Universal C Runtime](https://www.microsoft.com/download/details.aspx?id=48234). -You can find Redistributable architecture-specific versions of ucrtbase.dll for local deployment in the Windows SDK. By default, Visual Studio installs these versions in C:\Program Files (x86)\Windows Kits\10\Redist\ucrt\DLLs\ in an architecture-specific subdirectory. +You can find redistributable architecture-specific versions of `ucrtbase.dll` for local deployment in the Windows SDK. By default, Visual Studio installs these versions in `C:\Program Files (x86)\Windows Kits\10\Redist\ucrt\DLLs\` in an architecture-specific subdirectory. -If your app is built by using an earlier version of the MFC library, you must redistribute the matching CRT DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the msvcr120.dll. You also have to redistribute the matching mfc``u.dll or mfc``.dll. +If your app is built by using an earlier version of the MFC library, you must redistribute the matching CRT DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the `msvcr120.dll`. You also have to redistribute the matching `mfc``u.dll` or `mfc``.dll`. -If you statically link your application to MFC (that is, if you specify **Use MFC in a Static Library** on the **General** tab in the **Property Pages** dialog), you don't have to redistribute an MFC DLL. Although static linking might work for testing and internal deployment of applications, we recommend that you don't use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choosing a deployment method](choosing-a-deployment-method.md). +If you statically link your application to MFC (that is, if you specify **Use MFC in a Static Library** on the **General** tab in the **Property Pages** dialog), you don't have to redistribute an MFC DLL. Although static linking might work for testing and internal deployment of applications, we recommend that you don't use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choose a deployment method](choosing-a-deployment-method.md). -If your application uses the MFC classes that implement the WebBrowser control (for example, [CHtmlView Class](../mfc/reference/chtmlview-class.md) or [CHtmlEditView Class](../mfc/reference/chtmleditview-class.md)), we recommend that you also install the most current version of Microsoft Internet Explorer so that the target computer will have the most current common control files. (At a minimum, Internet Explorer 4.0 is required.) Information about how to install Internet Explorer components is available in "Article 185375: How To Create a Single EXE Install of Internet Explorer" on the Microsoft Support website. +If your application uses the MFC classes that implement the WebBrowser control (for example, [CHtmlView class](../mfc/reference/chtmlview-class.md) or [CHtmlEditView class](../mfc/reference/chtmleditview-class.md)), we recommend that you also install the most current version of Internet Explorer so that the target computer has the most current common control files. (At a minimum, Internet Explorer 4.0 is required.) Information about how to install Internet Explorer components is available in "Article 185375: How to Create a Single EXE Install of Internet Explorer" on the Microsoft Support website. -If your application uses the MFC database classes (for example, [CRecordset Class](../mfc/reference/crecordset-class.md) and [CRecordView Class](../mfc/reference/crecordview-class.md)), you must redistribute Open Database Connectivity (ODBC) and any ODBC drivers that your application uses. +If your application uses the MFC database classes (for example, [CRecordset class](../mfc/reference/crecordset-class.md) and [CRecordView class](../mfc/reference/crecordview-class.md)), you must redistribute Open Database Connectivity (ODBC) and any ODBC drivers that your application uses. -If your MFC application uses Windows Forms controls, you must redistribute mfcmifc80.dll with your application. This DLL is a strong-name-signed .NET assembly. You can redistribute it with an application in its application local folder. You can also deploy it to the Global Assembly Cache (GAC) by using the [Gacutil.exe (Global Assembly Cache Tool)](/dotnet/framework/tools/gacutil-exe-gac-tool). +If your MFC application uses Windows Forms controls, you must redistribute `mfcmifc80.dll` with your application. This DLL is a strong-name-signed .NET assembly. You can redistribute it with an application in its application local folder. You can also deploy it to the Global Assembly Cache (GAC) by using the [Gacutil.exe (Global Assembly Cache Tool)](/dotnet/framework/tools/gacutil-exe-gac-tool). -If you redistribute an MFC DLL, make sure to redistribute the retail version and not the debug version. Debug versions of the DLLs aren't redistributable. The names of debug versions of the MFC DLLs end with a "d," for example, Mfc140d.dll. +If you redistribute an MFC DLL, make sure to redistribute the retail version and not the debug version. Debug versions of the DLLs aren't redistributable. The names of debug versions of the MFC DLLs end with a "d," for example, `Mfc140d.dll`. -You can redistribute MFC by using either VCRedist_*architecture*.exe or merge modules that are installed with Visual Studio. You can also deploy the MFC DLL to the same folder as your application. For more information about how to redistribute MFC, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). +You can redistribute MFC by using either `VCRedist_*architecture*.exe` or merge modules that are installed with Visual Studio. You can also deploy the MFC DLL to the same folder as your application. For more information about how to redistribute MFC, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). ## Installation of localized MFC components -If you decide to localize your application by installing an MFC localization DLL, you must use the redistributable merge files (.msm). For example, if you want to localize your application on an x86 computer, you must merge Microsoft_VC``_MFCLOC_x86.msm into the installation package for an x86 computer. +If you decide to localize your application by installing an MFC localization DLL, you must use the redistributable merge files (`.msm`). For example, if you want to localize your application on an x86 computer, you must merge `Microsoft_VC``_MFCLOC_x86.msm` into the installation package for an x86 computer. -The redistributable .msm files contain the DLLs that are used for localization. There's one DLL for each supported language. The installation process installs these DLLs in the %windir%\system32\ folder on the target computer. +The redistributable `.msm` files contain the DLLs that are used for localization. There's one DLL for each supported language. The installation process installs these DLLs in the `%windir%\system32\` folder on the target computer. For more information about how to localize MFC applications, see [TN057: Localization of MFC components](../mfc/tn057-localization-of-mfc-components.md). diff --git a/docs/windows/redistributing-visual-cpp-activex-controls.md b/docs/windows/redistributing-visual-cpp-activex-controls.md index 882e4430902..1cb9bd521f7 100644 --- a/docs/windows/redistributing-visual-cpp-activex-controls.md +++ b/docs/windows/redistributing-visual-cpp-activex-controls.md @@ -13,17 +13,17 @@ Visual C++ 6.0 supplies ActiveX controls that you can use in applications that y > [!NOTE] > Visual C++ 6.0 is no longer supported by Microsoft. -For a list of the redistributable Visual C++ 6.0 ActiveX controls, see Common\Redist\Redist.txt on Disc 1 of the Visual C++ 6.0 product CD. +For a list of the redistributable Visual C++ 6.0 ActiveX controls, see `Common\Redist\Redist.txt` on Disc 1 of the Visual C++ 6.0 product CD. -When you distribute applications, you must install and register the `.ocx` for the ActiveX control (by using Regsvr32.exe). You should also make sure that the target computer has current versions of the following system files (an asterisk indicates that the file must be registered): +When you distribute applications, you must install and register the `.ocx` for the ActiveX control (by using `Regsvr32.exe`). The target computer also must have current versions of the following system files (an asterisk indicates that the file must be registered): -- Asycfilt.dll -- Comcat.dll \* -- Oleaut32.dll \* -- Olepro32.dll \* -- Stdole2.tlb +- `Asycfilt.dll` +- `Comcat.dll`\* +- `Oleaut32.dll`\* +- `Olepro32.dll`\* +- `Stdole2.tlb` -If these DLLs aren't available on the target system, you must get them updated by using the prescribed mechanism for updating the corresponding operating system. +If these dynamic link libraries (DLLs) aren't available on the target system, you must get them updated by using the prescribed mechanism for updating the corresponding operating system. When you use an ActiveX control that connects to a database, you also need to replicate the data source name on the target computer. You can do this task programmatically with functions such as `ConfigDSN`. diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 0a1992a3719..049c8d504e3 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -1,6 +1,6 @@ --- title: Redistribute Visual C++ Files -description: Visual Studio includes Redistributable libraries and components that you can deploy with your app. +description: Visual Studio includes redistributable libraries and components that you can deploy with your app. ms.date: 01/15/2025 helpviewer_keywords: ["application deployment [C++], file redistributing", "redistributing applications [C++]", "deploying applications [C++], file redistributing", "file redistribution [C++]", "redistributing applications [C++], about redistributing applications"] ms.topic: concept-article @@ -8,13 +8,13 @@ ms.topic: concept-article # Redistribute Visual C++ files > [!NOTE] -> Are you here because you're looking for a download of one of the Visual C++ Runtime files? Go to the [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) page. +> Are you here because you're looking for a download of one of the Visual C++ Runtime files? Go to the [latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) page. ## Redistributable files and licensing -Distribution of the Visual C++ Runtime Redistributable package, merge modules, and individual binaries is limited to licensed Visual Studio users and is subject to such License Terms. +Distribution of the Visual C++ Runtime Redistributable Package, merge modules, and individual binaries is limited to licensed Visual Studio users and is subject to Microsoft Software License Terms. -When you deploy an application, you must also deploy the files that are required to support it. If any of these files are provided by Microsoft, check whether you're permitted to redistribute them. You can find a link to the Visual Studio license terms in the IDE. Use the License Terms link in the About Microsoft Visual Studio dialog. You can also download the relevant Microsoft Software Licence Terms and licenses from the Visual Studio [License Directory](https://visualstudio.microsoft.com/license-terms/). +When you deploy an application, you must also deploy the files that are required to support it. If any of these files are provided by Microsoft, check whether you're permitted to redistribute them. You can find a link to the Visual Studio license terms in the IDE. In the **About Microsoft Visual Studio** dialog, select the **License Terms** link. You can also download the relevant Microsoft Software License Terms and licenses from the Visual Studio [License Directory](https://visualstudio.microsoft.com/license-terms/). ::: moniker range="msvc-170" @@ -24,51 +24,51 @@ To view the "REDIST list" that's referenced in the "Distributable Code" section ::: moniker range="msvc-160" -To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2019 Microsoft Software License Terms, see [Distributable Code Files for Microsoft Visual Studio 2019](/visualstudio/releases/2019/redistribution#-distributable-code-files-for-visual-studio-2019). +To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2019 Microsoft Software License Terms, see [Distributable code files for Microsoft Visual Studio 2019](/visualstudio/releases/2019/redistribution#-distributable-code-files-for-visual-studio-2019). ::: moniker-end ::: moniker range="msvc-150" -To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2017 Microsoft Software License Terms, see [Distributable Code Files for Microsoft Visual Studio 2017](/visualstudio/productinfo/2017-redistribution-vs#-distributable-code-files-for-visual-studio-2017). +To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2017 Microsoft Software License Terms, see [Distributable code files for Microsoft Visual Studio 2017](/visualstudio/productinfo/2017-redistribution-vs#-distributable-code-files-for-visual-studio-2017). ::: moniker-end ::: moniker range="msvc-140" -To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2015 Microsoft Software License Terms, see [Distributable Code Files for Microsoft Visual Studio 2015](/visualstudio/productinfo/2015-redistribution-vs#-distributable-code-files-for-visual-studio-2015). +To view the "REDIST list" that's referenced in the "Distributable Code" section of the Visual Studio 2015 Microsoft Software License Terms, see [Distributable code files for Microsoft Visual Studio 2015](/visualstudio/productinfo/2015-redistribution-vs#-distributable-code-files-for-visual-studio-2015). ::: moniker-end -For more information about redistributable files, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md) and [Deployment examples](deployment-examples.md). +For more information about redistributable files, see [Determine which dynamic link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md) and [Deployment examples](deployment-examples.md). ## Locate the redistributable files -To deploy redistributable files, you can use the redistributable packages installed by Visual Studio. In versions of Visual Studio since 2017, these files are named *`vc_redist.arm64.exe`*, *`vc_redist.x64.exe`*, and *`vc_redist.x86.exe`*. In Visual Studio 2015, 2017, and 2019, they're also available under the names *`vcredist_x86.exe`*, *`vcredist_x64.exe`*, and (2015 only) *`vcredist_arm.exe`*. +To deploy redistributable files, you can use the redistributable packages installed by Visual Studio. In versions of Visual Studio since 2017, these files are named `vc_redist.arm64.exe`, `vc_redist.x64.exe`, and `vc_redist.x86.exe`. In Visual Studio 2015, 2017, and 2019, they're also available under the names `vcredist_x86.exe`, `vcredist_x64.exe`, and (2015 only) `vcredist_arm.exe`. -The easiest way to locate the redistributable files is by using environment variables set in a developer command prompt. In Visual Studio 2022, the redistributable files are in the *`%VCINSTALLDIR%Redist\MSVC\v143`* folder. In the latest version of Visual Studio 2019, you can find the redistributable files in the *`%VCINSTALLDIR%Redist\MSVC\v142`* folder. In both Visual Studio 2017 and Visual Studio 2019, they're also found in *`%VCToolsRedistDir%`*. In Visual Studio 2015, you can find these files in *`%VCINSTALLDIR%redist\`*, where *``* is the locale of the redistributable packages. +The easiest way to locate the redistributable files is by using environment variables set in a developer command prompt. In Visual Studio 2022, the redistributable files are in the `%VCINSTALLDIR%Redist\MSVC\v143` folder. In the latest version of Visual Studio 2019, you can find the redistributable files in the `%VCINSTALLDIR%Redist\MSVC\v142` folder. In both Visual Studio 2017 and Visual Studio 2019, the files are also found in `%VCToolsRedistDir%`. In Visual Studio 2015, you can find these files in `%VCINSTALLDIR%redist\`, where `` is the locale of the redistributable packages. -In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When installed in Visual Studio 2022, you can find the redistributable merge modules in *`%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`*. In the latest version of Visual Studio 2019, the redistributable merge modules are in *`%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`*. In both Visual Studio 2019 and Visual Studio 2017, they're also found in *`%VCToolsRedistDir%MergeModules`*. In Visual Studio 2015, they're found in *`Program Files [(x86)]\Common Files\Merge Modules`*. +In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named Visual C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When they're installed in Visual Studio 2022, you can find the redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. In the latest version of Visual Studio 2019, the redistributable merge modules are found in `%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`. In both Visual Studio 2019 and Visual Studio 2017, they're also found in `%VCToolsRedistDir%MergeModules`. In Visual Studio 2015, they're found in `Program Files [(x86)]\Common Files\Merge Modules`. ## Install the redistributable packages -The Visual C++ Redistributable Packages install and register all Visual C++ libraries. If you use one, run it as a prerequisite on the target system before you install your application. We recommend that you use these packages for your deployments because they enable automatic updating of the Visual C++ libraries. For an example about how to use these packages, see [Walkthrough: Deploying a Visual C++ Application by Using the Visual C++ Redistributable Package](deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md). +The Visual C++ Redistributable Packages install and register all Visual C++ libraries. If you use one, run it as a prerequisite on the target system before you install your application. We recommend that you use these packages for your deployments because they enable automatic updating of the Visual C++ libraries. For an example that shows how to use these packages, see [Walkthrough: Deploy a Visual C++ application by using the Visual C++ Redistributable Package](deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md). -Each Visual C++ Redistributable package checks for the existence of a more recent version on the machine. If a more recent version is found, the package won't get installed. In Visual Studio 2015 or later, Redistributable packages display an error message stating that setup failed. If a package uses the `/quiet` flag to run, no error message is displayed. In either case, an error is logged by the Microsoft installer, and an error result is returned to the caller. +Each Visual C++ Redistributable Package checks for the existence of a more recent version on the machine. If a more recent version is found, the package isn't installed. In Visual Studio 2015 or later, redistributable packages display an error message stating that setup failed. If a package uses the `/quiet` flag to run, no error message appears. In either case, the Microsoft installer logs the error, and an error result is returned to the caller. In Visual Studio 2015 and later, you can avoid this error by checking the registry to find out if a more recent version is installed. The current installed version number is stored in the `HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|arm64}` key. -The version number is 14.0 for Visual Studio 2015, 2017, 2019, and 2022 because the latest Redistributable is binary compatible with previous versions back to 2015. The key is `arm64`, `x86`, or `x64` depending on the installed vcredist versions for the platform. (You need to check under the `Wow6432Node` subkey only if you use Regedit to view the version of the installed x86 package on an x64 platform.) +The version number is 14.0 for Visual Studio 2015, 2017, 2019, and 2022 because the latest Redistributable is binary compatible with previous versions back to 2015. The key is `arm64`, `x86`, or `x64` depending on the installed `vcredist` versions for the platform. (You need to check under the `Wow6432Node` subkey only if you use Regedit to view the version of the installed x86 package on an x64 platform.) -The version number is stored in the `REG_SZ` string value `Version` and also in the set of `Major`, `Minor`, `Bld`, and `Rbld` `REG_DWORD` values. To avoid an error at install time, you must skip installation of the Redistributable package if the currently installed version is more recent. +The version number is stored in the `REG_SZ` string value `Version` and also in the set of `Major`, `Minor`, `Bld`, and `Rbld` `REG_DWORD` values. To avoid an error at installation time, you must skip installation of the redistributable package if the currently installed version is more recent. -### Command-line options for the Redistributable packages +### Command-line options for the redistributable packages The Visual C++ Redistributable supports several command-line options. The `/?`, `/h`, or `/help` options display a dialog that lists the available options. You can specify `/install` to install, `/repair` to repair, or `/uninstall` to uninstall the Redistributable. The `/layout` option copies the complete contents of the Redistributable in the current directory. -By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can specify the `/passive` option, which displays progress but doesn't otherwise require user interaction. You can also specify a `/quiet` option, which doesn't display any UI or require any user interaction. The `/norestart` option suppresses any attempts to restart. By default, a log file is created in *`%TEMP%`*. You can use `/log filename.txt` to log to a specific file. +By default, the Redistributable installs its contents and prompts the user for information and whether to restart after installation. You can specify the `/passive` option, which displays progress but doesn't otherwise require user interaction. You can also specify a `/quiet` option, which doesn't display a user interface or require any user interaction. The `/norestart` option suppresses any attempts to restart. By default, a log file is created in `%TEMP%`. You can use `/log filename.txt` to log to a specific file. -This example command installs the x64 Redistributable. It shows installation progress, but doesn't require user interaction or a restart: +This example command installs the x64 Redistributable. It shows installation progress but doesn't require user interaction or a restart: ```cmd vc_redist.x64.exe /install /passive /norestart @@ -77,41 +77,28 @@ vc_redist.x64.exe /install /passive /norestart ## Install the redistributable merge modules > [!IMPORTANT] -> Merge modules (*`.msm`* files) for Visual C++ Redistributable files are deprecated. We don't recommend that you use them for application deployment. Instead, we recommend central deployment of the Visual C++ Redistributable package. Central deployment by a Redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't affect other applications that also use central deployment. +> Merge modules (`.msm` files) for Visual C++ Redistributable files are deprecated. We don't recommend that you use them for application deployment. Instead, we recommend central deployment of the Visual C++ Redistributable Package. Central deployment by a redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't affect other applications that also use central deployment. > -> When you use a Redistributable package for central deployment, you aren't responsible for tracking and maintaining the runtime libraries. Otherwise, an update to the runtime library files requires you to update and redeploy your *`.msi`* installer. Your app could be vulnerable to bugs or security issues until you do. +> When you use a redistributable package for central deployment, you aren't responsible for tracking and maintaining the runtime libraries. Otherwise, an update to the runtime library files requires you to update and redeploy your *`.msi`* installer. Your app could be vulnerable to bugs or security issues until you do. -Redistributable merge modules must be included in the Windows Installer package (or similar installation package) that you use to deploy your application. For more information, see [Redistributing by using merge modules](redistributing-components-by-using-merge-modules.md). For an example, see [Walkthrough: Deploying a Visual C++ application by using a setup project](walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md). +Redistributable merge modules must be included in the Windows Installer package (or similar installation package) that you use to deploy your application. For more information, see [Redistribute by using merge modules](redistributing-components-by-using-merge-modules.md). For an example, see [Walkthrough: Deploy a Visual C++ application by using a setup project](walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md). ## Install individual redistributable files -It's also possible to directly install the Redistributable DLLs in the *application local folder*. The application local folder is the folder that contains your executable application file. For servicing reasons, we don't recommend you use this installation location. +It's also possible to directly install the Redistributable DLLs in the *application local folder*. The application local folder is the folder that contains your executable application file. For servicing reasons, we don't recommend that you use this installation location. ## Potential runtime errors -If Windows can't find one of the Redistributable library DLLs required by your application, it might display a message similar to: "This application has failed to start because *library*.dll was not found. Reinstalling the application may fix this problem." +If Windows can't find one of the Redistributable DLLs required by your application, it might display a message similar to this one: "This application has failed to start because *library*.dll was not found. Reinstalling the application may fix this problem." -To resolve this kind of error, make sure your application installer builds correctly. Verify that the Redistributable libraries get deployed correctly on the target system. For more information, see [Understanding the Dependencies of a Visual C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md). +To resolve this kind of error, make sure that your application installer builds correctly. Verify that the Redistributable libraries get deployed correctly on the target system. For more information, see [Understand the dependencies of a Visual C++ application](understanding-the-dependencies-of-a-visual-cpp-application.md). -## Related articles +## Related content -[Redistributing by using merge modules](redistributing-components-by-using-merge-modules.md)\ -Describes how to use Visual C++ Redistributable merge modules to install the Visual C++ runtime libraries as shared DLLs in the *`%windir%\system32\`* folder. - -[Redistributing Visual C++ ActiveX Controls](redistributing-visual-cpp-activex-controls.md)\ -Describes how to redistribute an application that uses ActiveX Controls. - -[Redistributing the MFC Library](redistributing-the-mfc-library.md)\ -Describes how to redistribute an application that uses MFC. - -[Redistributing an ATL application](redistributing-an-atl-application.md)\ -Describes how to redistribute an application that uses ATL. In Visual Studio 2012 and later, no ATL library is required. - -[Deployment Examples](deployment-examples.md)\ -Links to examples that demonstrate how to deploy Visual C++ applications. - -[Deploying Desktop Applications](deploying-native-desktop-applications-visual-cpp.md)\ -Introduces Visual C++ deployment concepts and technologies. - -[Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md)\ -Links to the latest supported Visual C++ Redistributable downloads. \ No newline at end of file +- [Redistribute by using merge modules](redistributing-components-by-using-merge-modules.md) describes how to use Visual C++ Redistributable merge modules to install the Visual C++ runtime libraries as shared DLLs in the `%windir%\system32\` folder. +- [Redistribute Visual C++ ActiveX controls](redistributing-visual-cpp-activex-controls.md) describes how to redistribute an application that uses ActiveX controls. +- [Redistribute the Microsoft Foundation Class (MFC) library](redistributing-the-mfc-library.md) describes how to redistribute an application that uses MFC. +- [Redistribute an Active Template Library (ATL) application](redistributing-an-atl-application.md) describes how to redistribute an application that uses an ATL. In Visual Studio 2012 and later, no ATL library is required. +- [Deployment examples](deployment-examples.md) links to examples that demonstrate how to deploy Visual C++ applications. +- [Deploy desktop applications](deploying-native-desktop-applications-visual-cpp.md) introduces Visual C++ deployment concepts and technologies. +- [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) links to the latest supported Visual C++ Redistributable downloads. \ No newline at end of file From 1a7906f49584a144f92db430b276f893b81e6fd1 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 24 Feb 2026 01:17:36 -0800 Subject: [PATCH 1652/1799] Docfx (#6260) * update ms.topic * restore test file --- docs/docfx.json | 4 ++-- docs/sanitizers/asan-building.md | 1 + docs/sanitizers/asan.md | 1 + 3 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/docfx.json b/docs/docfx.json index e3765f2f722..752316e2e79 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -42,7 +42,7 @@ "ROBOTS": "INDEX,FOLLOW", "manager": "coxford", "ms.date": "11/16/2016", - "ms.topic": "article", + "ms.topic": "concept-article", "audience": "developer", "ms.service": "visual-cpp", "ms.tgt_pltfrm": "Windows", @@ -116,7 +116,7 @@ "intrinsics/**.md": "reference", "mfc/reference/**.md": "reference", "overview/**.md": "overview", - "parallel/**.md": "reference", + "parallel/**.md": "how-to", "preprocessor/**.md": "reference", "safeint/**.md": "reference", "sanitizers/**.md": "reference", diff --git a/docs/sanitizers/asan-building.md b/docs/sanitizers/asan-building.md index 5ea4cf7b5cf..a4fa4cd5814 100644 --- a/docs/sanitizers/asan-building.md +++ b/docs/sanitizers/asan-building.md @@ -2,6 +2,7 @@ title: "MSVC AddressSanitizer language, build, and debugging reference" description: "Technical description of building for the MSVC AddressSanitizer" ms.date: 02/05/2024 +ms.topic: overview f1_keywords: ["__SANITIZE_ADDRESS__", "ASAN_VCASAN_DEBUGGING"] helpviewer_keywords: ["ASan reference", "MSVC AddressSanitizer reference", "MSVC Address Sanitizer reference"] --- diff --git a/docs/sanitizers/asan.md b/docs/sanitizers/asan.md index 80f2a55b825..63d7c1cb7f2 100644 --- a/docs/sanitizers/asan.md +++ b/docs/sanitizers/asan.md @@ -2,6 +2,7 @@ title: "AddressSanitizer" description: "Top-level description of the AddressSanitizer feature for Microsoft C/C++." ms.date: 09/06/2024 +ms.topic: overview f1_keywords: ["AddressSanitizer"] helpviewer_keywords: ["ASan", "AddressSanitizer", "Address Sanitizer", "compiling for AddressSanitizer"] --- From 3823f9fd0f6d09688b1b79befa15f4f7b9122b8a Mon Sep 17 00:00:00 2001 From: Tracey Torble <56347952+ttorble@users.noreply.github.com> Date: Tue, 24 Feb 2026 15:19:19 +0000 Subject: [PATCH 1653/1799] Update docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md --- .../compiler-warnings/compiler-warning-level-4-c4324.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md index e26ff5d09b0..0d36a85e2ca 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4324.md @@ -15,7 +15,7 @@ Padding was added at the end of a class/struct/union because you specified an al ## Example -For example, `S1`, `U1`, and `C1` generate C4324 because padding is added when the specified alignment is greater than the nautral alignment for each. `S2` doesn't generate a warning because the specified aligment matches the natural alignment: +For example, `S1`, `U1`, and `C1` generate C4324 because padding is added when the specified alignment is greater than the natural alignment for each. `S2` doesn't generate a warning because the specified alignment matches the natural alignment: ```cpp // C4324.cpp From 74924c2115b4874ecbe7f20dad93c19c63232893 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 24 Feb 2026 11:52:48 -0800 Subject: [PATCH 1654/1799] Mfc batch 10 (#6264) * Batch 10: update files * move note --- docs/mfc/reference/ctypedptrmap-class.md | 3 +++ docs/mfc/reference/cuintarray-class.md | 4 +++- docs/mfc/reference/cuserexception-class.md | 4 +++- docs/mfc/reference/cusertool-class.md | 4 +++- docs/mfc/reference/cusertoolsmanager-class.md | 4 +++- docs/mfc/reference/cview-class.md | 4 +++- docs/mfc/reference/cvslistbox-class.md | 4 +++- docs/mfc/reference/cwaitcursor-class.md | 4 +++- docs/mfc/reference/cwinapp-class.md | 3 +++ docs/mfc/reference/cwinappex-class.md | 3 +++ docs/mfc/reference/cwindowdc-class.md | 3 +++ docs/mfc/reference/cwinformscontrol-class.md | 4 +++- docs/mfc/reference/cwinformsdialog-class.md | 4 +++- docs/mfc/reference/cwinformsview-class.md | 4 +++- docs/mfc/reference/cwinthread-class.md | 4 +++- docs/mfc/reference/cwnd-class.md | 3 +++ docs/mfc/reference/cwordarray-class.md | 4 +++- .../dao-database-engine-initialization-and-termination.md | 4 +++- docs/mfc/reference/data-types-mfc.md | 3 +++ docs/mfc/reference/database-macros-and-globals.md | 4 +++- .../reference/database-support-mfc-application-wizard.md | 4 +++- docs/mfc/reference/ddx-dhtml-helper-macros.md | 4 +++- ...declaring-a-variable-based-on-your-new-control-class.md | 4 +++- .../defining-a-message-handler-for-a-reflected-message.md | 4 +++- docs/mfc/reference/delegate-and-interface-maps.md | 3 +++ .../details-of-atl-support-added-by-the-atl-wizard.md | 7 +++++-- docs/mfc/reference/dhtml-editing-command-maps.md | 4 +++- docs/mfc/reference/dhtml-event-maps.md | 4 +++- docs/mfc/reference/dhtmlurleventmapentry-structure.md | 4 +++- docs/mfc/reference/diagnostic-services.md | 3 +++ ...xchange-functions-for-crecordview-and-cdaorecordview.md | 4 +++- .../dialog-data-exchange-functions-for-ole-controls.md | 4 +++- docs/mfc/reference/dispatch-maps.md | 4 +++- .../document-template-strings-mfc-application-wizard.md | 4 +++- docs/mfc/reference/edit-control-handlers.md | 4 +++- docs/mfc/reference/editing-a-message-handler.md | 4 +++- docs/mfc/reference/event-maps.md | 4 +++- docs/mfc/reference/event-sink-maps.md | 3 +++ docs/mfc/reference/exception-processing.md | 4 +++- docs/mfc/reference/extension-dll-macros.md | 3 +++ .../reference/generated-classes-mfc-application-wizard.md | 4 +++- docs/mfc/reference/generic-control-handler.md | 4 +++- docs/mfc/reference/gray-and-dithered-bitmap-functions.md | 4 +++- docs/mfc/reference/handlers-for-wm-messages.md | 4 +++- .../how-to-use-the-message-map-cross-reference.md | 4 +++- docs/mfc/reference/hse-version-info-structure.md | 4 +++- docs/mfc/reference/icommandsource-interface.md | 3 +++ docs/mfc/reference/icommandtarget-interface.md | 4 +++- docs/mfc/reference/icommandui-interface.md | 4 +++- docs/mfc/reference/internal-classes.md | 3 +++ docs/mfc/reference/internet-url-parsing-globals.md | 4 +++- docs/mfc/reference/iview-interface.md | 4 +++- docs/mfc/reference/list-box-handlers.md | 4 +++- docs/mfc/reference/mapping-messages-to-functions.md | 4 +++- docs/mfc/reference/message-map-macros-mfc.md | 4 +++- docs/mfc/reference/message-maps-mfc.md | 4 +++- ...message-types-associated-with-user-interface-objects.md | 4 +++- docs/mfc/reference/mfc-activex-control-wizard.md | 4 +++- docs/mfc/reference/mfc-add-class-wizard.md | 4 +++- docs/mfc/reference/mfc-application-wizard.md | 3 +++ docs/mfc/reference/mfc-class-wizard.md | 3 +++ docs/mfc/reference/mfc-classes.md | 3 +++ docs/mfc/reference/mfc-dll-wizard.md | 4 +++- docs/mfc/reference/mfc-macros-and-globals.md | 4 +++- docs/mfc/reference/mfc-odbc-consumer-wizard.md | 4 +++- docs/mfc/reference/mfc-wizards-and-dialog-boxes.md | 4 +++- docs/mfc/reference/ole-initialization.md | 4 +++- docs/mfc/reference/persistence-of-ole-controls.md | 4 +++- docs/mfc/reference/property-pages-mfc.md | 4 +++- docs/mfc/reference/record-field-exchange-functions.md | 4 +++- docs/mfc/reference/registering-ole-controls.md | 4 +++- docs/mfc/reference/run-time-object-model-services.md | 3 +++ docs/mfc/reference/standard-command-and-window-ids.md | 4 +++- .../reference/standard-dialog-data-exchange-routines.md | 3 +++ .../reference/standard-dialog-data-validation-routines.md | 4 +++- .../structures-styles-callbacks-and-message-maps.md | 4 +++- docs/mfc/reference/structures-used-by-mfc.md | 4 +++- docs/mfc/reference/styles-used-by-mfc.md | 3 +++ docs/mfc/reference/toolbar-control-styles.md | 4 +++- docs/mfc/reference/type-casting-of-mfc-class-objects.md | 4 +++- docs/mfc/reference/type-library-access.md | 4 +++- docs/mfc/reference/uicheckstate-enumeration.md | 4 +++- docs/mfc/reference/user-button-handlers.md | 4 +++- docs/mfc/reference/user-defined-handlers.md | 4 +++- .../user-interface-features-mfc-application-wizard.md | 4 +++- docs/mfc/reference/variant-parameter-type-constants.md | 4 +++- docs/mfc/reference/wm-message-handlers-a-c.md | 3 +++ docs/mfc/reference/wm-message-handlers-d-e.md | 4 +++- docs/mfc/reference/wm-message-handlers-f-k.md | 4 +++- docs/mfc/reference/wm-message-handlers-l-m.md | 4 +++- docs/mfc/reference/wm-message-handlers-n-o.md | 4 +++- docs/mfc/reference/wm-messages-p-r.md | 4 +++- docs/mfc/reference/wm-messages-s.md | 4 +++- docs/mfc/reference/wm-messages-t-z.md | 4 +++- docs/mfc/reflected-window-message-ids.md | 4 +++- docs/mfc/registering-window-classes.md | 4 +++- docs/mfc/registration.md | 4 +++- ...relationship-between-a-cpp-window-object-and-an-hwnd.md | 4 +++- docs/mfc/relationship-to-the-c-language-api.md | 4 +++- docs/mfc/relationships-among-mfc-objects.md | 4 +++- 100 files changed, 302 insertions(+), 82 deletions(-) diff --git a/docs/mfc/reference/ctypedptrmap-class.md b/docs/mfc/reference/ctypedptrmap-class.md index 1e8ac54c643..7b430d55ba8 100644 --- a/docs/mfc/reference/ctypedptrmap-class.md +++ b/docs/mfc/reference/ctypedptrmap-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CTypedPtrMap [MFC], GetNextAssoc", "CTypedPtrMap [MFC], L --- # CTypedPtrMap Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides a type-safe "wrapper" for objects of the pointer-map classes `CMapPtrToPtr`, `CMapPtrToWord`, `CMapWordToPtr`, and `CMapStringToPtr`. ## Syntax diff --git a/docs/mfc/reference/cuintarray-class.md b/docs/mfc/reference/cuintarray-class.md index 6f73ded501d..fb9f1b1c845 100644 --- a/docs/mfc/reference/cuintarray-class.md +++ b/docs/mfc/reference/cuintarray-class.md @@ -4,10 +4,12 @@ title: "CUIntArray Class" ms.date: "11/04/2016" f1_keywords: ["CUIntArray", "AFXCOLL/CUIntArray", "AFXCOLL/CUIntArray::CUIntArray", "AFXCOLL/CUIntArray::Add", "AFXCOLL/CUIntArray::Append", "AFXCOLL/CUIntArray::Copy", "AFXCOLL/CUIntArray::ElementAt", "AFXCOLL/CUIntArray::FreeExtra", "AFXCOLL/CUIntArray::GetAt", "AFXCOLL/CUIntArray::GetCount", "AFXCOLL/CUIntArray::GetData", "AFXCOLL/CUIntArray::GetSize", "AFXCOLL/CUIntArray::GetUpperBound", "AFXCOLL/CUIntArray::InsertAt", "AFXCOLL/CUIntArray::IsEmpty", "AFXCOLL/CUIntArray::RemoveAll", "AFXCOLL/CUIntArray::RemoveAt", "AFXCOLL/CUIntArray::SetAt", "AFXCOLL/CUIntArray::SetAtGrow", "AFXCOLL/CUIntArray::SetSize"] helpviewer_keywords: ["CUIntArray [MFC], CUIntArray", "CUIntArray [MFC], Add", "CUIntArray [MFC], Append", "CUIntArray [MFC], Copy", "CUIntArray [MFC], ElementAt", "CUIntArray [MFC], FreeExtra", "CUIntArray [MFC], GetAt", "CUIntArray [MFC], GetCount", "CUIntArray [MFC], GetData", "CUIntArray [MFC], GetSize", "CUIntArray [MFC], GetUpperBound", "CUIntArray [MFC], InsertAt", "CUIntArray [MFC], IsEmpty", "CUIntArray [MFC], RemoveAll", "CUIntArray [MFC], RemoveAt", "CUIntArray [MFC], SetAt", "CUIntArray [MFC], SetAtGrow", "CUIntArray [MFC], SetSize"] -ms.assetid: d71f3d8f-ef9f-4e48-9b69-7782c0e2ddf7 --- # CUIntArray Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports arrays of unsigned integers. ## Syntax diff --git a/docs/mfc/reference/cuserexception-class.md b/docs/mfc/reference/cuserexception-class.md index b3dc67f0608..26387721c0a 100644 --- a/docs/mfc/reference/cuserexception-class.md +++ b/docs/mfc/reference/cuserexception-class.md @@ -4,10 +4,12 @@ title: "CUserException Class" ms.date: "11/04/2016" f1_keywords: ["CUserException"] helpviewer_keywords: ["operations [MFC], stopping", "exceptions [MFC], throwing", "CUserException class [MFC]", "errors [MFC], trapping", "operations [MFC]", "throwing exceptions [MFC], stopping user operations"] -ms.assetid: 2156ba6d-2cce-415a-9000-6f02c26fcd7d --- # CUserException Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Thrown to stop an end-user operation. ## Syntax diff --git a/docs/mfc/reference/cusertool-class.md b/docs/mfc/reference/cusertool-class.md index f664e322f8b..7701be54440 100644 --- a/docs/mfc/reference/cusertool-class.md +++ b/docs/mfc/reference/cusertool-class.md @@ -4,10 +4,12 @@ title: "CUserTool Class" ms.date: "11/04/2016" f1_keywords: ["CUserTool", "AFXUSERTOOL/CUserTool", "AFXUSERTOOL/CUserTool::CopyIconToClipboard", "AFXUSERTOOL/CUserTool::DrawToolIcon", "AFXUSERTOOL/CUserTool::GetCommand", "AFXUSERTOOL/CUserTool::GetCommandId", "AFXUSERTOOL/CUserTool::Invoke", "AFXUSERTOOL/CUserTool::Serialize", "AFXUSERTOOL/CUserTool::SetCommand", "AFXUSERTOOL/CUserTool::SetToolIcon", "AFXUSERTOOL/CUserTool::LoadDefaultIcon", "AFXUSERTOOL/CUserTool::m_strArguments", "AFXUSERTOOL/CUserTool::m_strInitialDirectory", "AFXUSERTOOL/CUserTool::m_strLabel"] helpviewer_keywords: ["CUserTool [MFC], CopyIconToClipboard", "CUserTool [MFC], DrawToolIcon", "CUserTool [MFC], GetCommand", "CUserTool [MFC], GetCommandId", "CUserTool [MFC], Invoke", "CUserTool [MFC], Serialize", "CUserTool [MFC], SetCommand", "CUserTool [MFC], SetToolIcon", "CUserTool [MFC], LoadDefaultIcon", "CUserTool [MFC], m_strArguments", "CUserTool [MFC], m_strInitialDirectory", "CUserTool [MFC], m_strLabel"] -ms.assetid: 7c287d3e-d012-488d-b4e1-aa0f83f294bb --- # CUserTool Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A user tool is a menu item that runs an external application. The **Tools** tab of the **Customize** dialog box ( [CMFCToolBarsCustomizeDialog Class](../../mfc/reference/cmfctoolbarscustomizedialog-class.md)) enables the user to add user tools, and to specify the name, command, arguments, and initial directory for each user tool. ## Syntax diff --git a/docs/mfc/reference/cusertoolsmanager-class.md b/docs/mfc/reference/cusertoolsmanager-class.md index a0b94f5dc84..eaa6e767e20 100644 --- a/docs/mfc/reference/cusertoolsmanager-class.md +++ b/docs/mfc/reference/cusertoolsmanager-class.md @@ -4,10 +4,12 @@ title: "CUserToolsManager Class" ms.date: "11/04/2016" f1_keywords: ["CUserToolsManager", "AFXUSERTOOLSMANAGER/CUserToolsManager", "AFXUSERTOOLSMANAGER/CUserToolsManager::CUserToolsManager", "AFXUSERTOOLSMANAGER/CUserToolsManager::CreateNewTool", "AFXUSERTOOLSMANAGER/CUserToolsManager::FindTool", "AFXUSERTOOLSMANAGER/CUserToolsManager::GetArgumentsMenuID", "AFXUSERTOOLSMANAGER/CUserToolsManager::GetDefExt", "AFXUSERTOOLSMANAGER/CUserToolsManager::GetFilter", "AFXUSERTOOLSMANAGER/CUserToolsManager::GetInitialDirMenuID", "AFXUSERTOOLSMANAGER/CUserToolsManager::GetMaxTools", "AFXUSERTOOLSMANAGER/CUserToolsManager::GetToolsEntryCmd", "AFXUSERTOOLSMANAGER/CUserToolsManager::GetUserTools", "AFXUSERTOOLSMANAGER/CUserToolsManager::InvokeTool", "AFXUSERTOOLSMANAGER/CUserToolsManager::IsUserToolCmd", "AFXUSERTOOLSMANAGER/CUserToolsManager::LoadState", "AFXUSERTOOLSMANAGER/CUserToolsManager::MoveToolDown", "AFXUSERTOOLSMANAGER/CUserToolsManager::MoveToolUp", "AFXUSERTOOLSMANAGER/CUserToolsManager::RemoveTool", "AFXUSERTOOLSMANAGER/CUserToolsManager::SaveState", "AFXUSERTOOLSMANAGER/CUserToolsManager::SetDefExt", "AFXUSERTOOLSMANAGER/CUserToolsManager::SetFilter"] helpviewer_keywords: ["CUserToolsManager [MFC], CUserToolsManager", "CUserToolsManager [MFC], CreateNewTool", "CUserToolsManager [MFC], FindTool", "CUserToolsManager [MFC], GetArgumentsMenuID", "CUserToolsManager [MFC], GetDefExt", "CUserToolsManager [MFC], GetFilter", "CUserToolsManager [MFC], GetInitialDirMenuID", "CUserToolsManager [MFC], GetMaxTools", "CUserToolsManager [MFC], GetToolsEntryCmd", "CUserToolsManager [MFC], GetUserTools", "CUserToolsManager [MFC], InvokeTool", "CUserToolsManager [MFC], IsUserToolCmd", "CUserToolsManager [MFC], LoadState", "CUserToolsManager [MFC], MoveToolDown", "CUserToolsManager [MFC], MoveToolUp", "CUserToolsManager [MFC], RemoveTool", "CUserToolsManager [MFC], SaveState", "CUserToolsManager [MFC], SetDefExt", "CUserToolsManager [MFC], SetFilter"] -ms.assetid: bdfa37ae-efca-4616-abb5-9d0dcd2d335b --- # CUserToolsManager Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Maintains the collection of [CUserTool Class](../../mfc/reference/cusertool-class.md) objects in an application. A user tool is a menu item that runs an external application. The `CUserToolsManager` object enables the user or developer to add new user tools to the application. It supports the execution of the commands associated with user tools, and it also saves information about user tools in the Windows registry. ## Syntax diff --git a/docs/mfc/reference/cview-class.md b/docs/mfc/reference/cview-class.md index 42e892ac90c..e9a3113ea03 100644 --- a/docs/mfc/reference/cview-class.md +++ b/docs/mfc/reference/cview-class.md @@ -4,10 +4,12 @@ title: "CView Class" ms.date: "11/04/2016" f1_keywords: ["CView", "AFXWIN/CView", "AFXWIN/CView::CView", "AFXWIN/CView::DoPreparePrinting", "AFXWIN/CView::GetDocument", "AFXWIN/CView::IsSelected", "AFXWIN/CView::OnDragEnter", "AFXWIN/CView::OnDragLeave", "AFXWIN/CView::OnDragOver", "AFXWIN/CView::OnDragScroll", "AFXWIN/CView::OnDrop", "AFXWIN/CView::OnDropEx", "AFXWIN/CView::OnInitialUpdate", "AFXWIN/CView::OnPrepareDC", "AFXWIN/CView::OnScroll", "AFXWIN/CView::OnScrollBy", "AFXWIN/CView::OnActivateFrame", "AFXWIN/CView::OnActivateView", "AFXWIN/CView::OnBeginPrinting", "AFXWIN/CView::OnDraw", "AFXWIN/CView::OnEndPrinting", "AFXWIN/CView::OnEndPrintPreview", "AFXWIN/CView::OnPreparePrinting", "AFXWIN/CView::OnPrint", "AFXWIN/CView::OnUpdate"] helpviewer_keywords: ["CView [MFC], CView", "CView [MFC], DoPreparePrinting", "CView [MFC], GetDocument", "CView [MFC], IsSelected", "CView [MFC], OnDragEnter", "CView [MFC], OnDragLeave", "CView [MFC], OnDragOver", "CView [MFC], OnDragScroll", "CView [MFC], OnDrop", "CView [MFC], OnDropEx", "CView [MFC], OnInitialUpdate", "CView [MFC], OnPrepareDC", "CView [MFC], OnScroll", "CView [MFC], OnScrollBy", "CView [MFC], OnActivateFrame", "CView [MFC], OnActivateView", "CView [MFC], OnBeginPrinting", "CView [MFC], OnDraw", "CView [MFC], OnEndPrinting", "CView [MFC], OnEndPrintPreview", "CView [MFC], OnPreparePrinting", "CView [MFC], OnPrint", "CView [MFC], OnUpdate"] -ms.assetid: 9cff3c56-7564-416b-b9a4-71a9254ed755 --- # `CView` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the basic functionality for user-defined view classes. ## Syntax diff --git a/docs/mfc/reference/cvslistbox-class.md b/docs/mfc/reference/cvslistbox-class.md index 45cbc0e8068..68cf0b67cc9 100644 --- a/docs/mfc/reference/cvslistbox-class.md +++ b/docs/mfc/reference/cvslistbox-class.md @@ -4,10 +4,12 @@ title: "CVSListBox Class" ms.date: "11/19/2018" f1_keywords: ["CVSListBox", "AFXVSLISTBOX/CVSListBox", "AFXVSLISTBOX/CVSListBox::CVSListBox", "AFXVSLISTBOX/CVSListBox::AddItem", "AFXVSLISTBOX/CVSListBox::EditItem", "AFXVSLISTBOX/CVSListBox::GetCount", "AFXVSLISTBOX/CVSListBox::GetItemData", "AFXVSLISTBOX/CVSListBox::GetItemText", "AFXVSLISTBOX/CVSListBox::GetSelItem", "AFXVSLISTBOX/CVSListBox::RemoveItem", "AFXVSLISTBOX/CVSListBox::SelectItem", "AFXVSLISTBOX/CVSListBox::SetItemData", "AFXVSLISTBOX/CVSListBox::GetListHwnd"] helpviewer_keywords: ["CVSListBox [MFC], CVSListBox", "CVSListBox [MFC], AddItem", "CVSListBox [MFC], EditItem", "CVSListBox [MFC], GetCount", "CVSListBox [MFC], GetItemData", "CVSListBox [MFC], GetItemText", "CVSListBox [MFC], GetSelItem", "CVSListBox [MFC], RemoveItem", "CVSListBox [MFC], SelectItem", "CVSListBox [MFC], SetItemData", "CVSListBox [MFC], GetListHwnd"] -ms.assetid: c79be7b4-46ed-4af8-a41e-68962782d8ef --- # CVSListBox Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `CVSListBox` class supports an editable list control. ## Syntax diff --git a/docs/mfc/reference/cwaitcursor-class.md b/docs/mfc/reference/cwaitcursor-class.md index 7a62508db91..36fd2f3f99d 100644 --- a/docs/mfc/reference/cwaitcursor-class.md +++ b/docs/mfc/reference/cwaitcursor-class.md @@ -4,10 +4,12 @@ title: "CWaitCursor Class" ms.date: "11/04/2016" f1_keywords: ["CWaitCursor", "AFXWIN/CWaitCursor", "AFXWIN/CWaitCursor::CWaitCursor", "AFXWIN/CWaitCursor::Restore"] helpviewer_keywords: ["CWaitCursor [MFC], CWaitCursor", "CWaitCursor [MFC], Restore"] -ms.assetid: 5dfae2ff-d7b6-4383-b0ad-91e0868c67b3 --- # CWaitCursor Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides a one-line way to show a wait cursor, which is usually displayed as an hourglass, while you're doing a lengthy operation. ## Syntax diff --git a/docs/mfc/reference/cwinapp-class.md b/docs/mfc/reference/cwinapp-class.md index 7f45102a51a..977fe4b8cc9 100644 --- a/docs/mfc/reference/cwinapp-class.md +++ b/docs/mfc/reference/cwinapp-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CWinApp [MFC], CWinApp", "CWinApp [MFC], AddDocTemplate", --- # CWinApp Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The base class from which you derive a Windows application object. ## Syntax diff --git a/docs/mfc/reference/cwinappex-class.md b/docs/mfc/reference/cwinappex-class.md index 85b09877183..6ddbfc30372 100644 --- a/docs/mfc/reference/cwinappex-class.md +++ b/docs/mfc/reference/cwinappex-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CWinAppEx [MFC], CWinAppEx", "CWinAppEx [MFC], CleanState --- # `CWinAppEx` class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CWinAppEx` handles the application state, saves the state to the registry, loads the state from the registry, initializes application managers, and provides links to those same application managers. For more detail, see the source code located in the `mfc` folder of your Visual Studio installation. For example, `%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc`. diff --git a/docs/mfc/reference/cwindowdc-class.md b/docs/mfc/reference/cwindowdc-class.md index e27c7be752e..c47bff917d7 100644 --- a/docs/mfc/reference/cwindowdc-class.md +++ b/docs/mfc/reference/cwindowdc-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CWindowDC [MFC], CWindowDC", "CWindowDC [MFC], m_hWnd"] --- # CWindowDC Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Derived from `CDC`. ## Syntax diff --git a/docs/mfc/reference/cwinformscontrol-class.md b/docs/mfc/reference/cwinformscontrol-class.md index 78663935bdc..1d3e5e58e4a 100644 --- a/docs/mfc/reference/cwinformscontrol-class.md +++ b/docs/mfc/reference/cwinformscontrol-class.md @@ -4,10 +4,12 @@ title: "CWinFormsControl Class" ms.date: "11/04/2016" f1_keywords: ["CWinFormsControl", "AFXWINFORMS/CWinFormsControl", "AFXWINFORMS/CWinFormsControl::CWinFormsControl", "AFXWINFORMS/CWinFormsControl::CreateManagedControl", "AFXWINFORMS/CWinFormsControl::GetControl", "AFXWINFORMS/CWinFormsControl::GetControlHandle"] helpviewer_keywords: ["CWinFormsControl [MFC], CWinFormsControl", "CWinFormsControl [MFC], CreateManagedControl", "CWinFormsControl [MFC], GetControl", "CWinFormsControl [MFC], GetControlHandle"] -ms.assetid: 6406dd7b-fb89-4a18-ac3a-c010d6b6289a --- # CWinFormsControl Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the basic functionality for hosting of a Windows Forms control. ## Syntax diff --git a/docs/mfc/reference/cwinformsdialog-class.md b/docs/mfc/reference/cwinformsdialog-class.md index 89e9ab38315..f24797163f1 100644 --- a/docs/mfc/reference/cwinformsdialog-class.md +++ b/docs/mfc/reference/cwinformsdialog-class.md @@ -4,10 +4,12 @@ title: "CWinFormsDialog Class" ms.date: "03/27/2019" f1_keywords: ["CWinFormsDialog", "AFXWINFORMS/CWinFormsDialog", "AFXWINFORMS/CWinFormsDialog::CWinFormsDialog", "AFXWINFORMS/CWinFormsDialog::GetControl", "AFXWINFORMS/CWinFormsDialog::GetControlHandle", "AFXWINFORMS/CWinFormsDialog::OnInitDialog"] helpviewer_keywords: ["CWinFormsDialog [MFC], CWinFormsDialog", "CWinFormsDialog [MFC], GetControl", "CWinFormsDialog [MFC], GetControlHandle", "CWinFormsDialog [MFC], OnInitDialog"] -ms.assetid: e3cec000-a578-448e-b06a-8af256312f61 --- # CWinFormsDialog Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A wrapper for an MFC dialog class that hosts a Windows Forms user control. ## Syntax diff --git a/docs/mfc/reference/cwinformsview-class.md b/docs/mfc/reference/cwinformsview-class.md index 624a55aadff..549c6236de3 100644 --- a/docs/mfc/reference/cwinformsview-class.md +++ b/docs/mfc/reference/cwinformsview-class.md @@ -4,10 +4,12 @@ title: "CWinFormsView Class" ms.date: "11/04/2016" f1_keywords: ["CWinFormsView", "AFXWINFORMS/CWinFormsView", "AFXWINFORMS/CWinFormsView::CWinFormsView", "AFXWINFORMS/CWinFormsView::GetControl"] helpviewer_keywords: ["CWinFormsView [MFC], CWinFormsView", "CWinFormsView [MFC], GetControl"] -ms.assetid: d597e397-6529-469b-88f5-7f65a6b9e895 --- # CWinFormsView Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides generic functionality for hosting of a Windows Forms control as an MFC view. ## Syntax diff --git a/docs/mfc/reference/cwinthread-class.md b/docs/mfc/reference/cwinthread-class.md index 02e9bfbfa88..4cc52e29c7b 100644 --- a/docs/mfc/reference/cwinthread-class.md +++ b/docs/mfc/reference/cwinthread-class.md @@ -4,10 +4,12 @@ title: "CWinThread Class" ms.date: "11/04/2016" f1_keywords: ["CWinThread", "AFXWIN/CWinThread", "AFXWIN/CWinThread::CWinThread", "AFXWIN/CWinThread::CreateThread", "AFXWIN/CWinThread::ExitInstance", "AFXWIN/CWinThread::GetMainWnd", "AFXWIN/CWinThread::GetThreadPriority", "AFXWIN/CWinThread::InitInstance", "AFXWIN/CWinThread::IsIdleMessage", "AFXWIN/CWinThread::OnIdle", "AFXWIN/CWinThread::PostThreadMessage", "AFXWIN/CWinThread::PreTranslateMessage", "AFXWIN/CWinThread::ProcessMessageFilter", "AFXWIN/CWinThread::ProcessWndProcException", "AFXWIN/CWinThread::PumpMessage", "AFXWIN/CWinThread::ResumeThread", "AFXWIN/CWinThread::Run", "AFXWIN/CWinThread::SetThreadPriority", "AFXWIN/CWinThread::SuspendThread", "AFXWIN/CWinThread::m_bAutoDelete", "AFXWIN/CWinThread::m_hThread", "AFXWIN/CWinThread::m_nThreadID", "AFXWIN/CWinThread::m_pActiveWnd", "AFXWIN/CWinThread::m_pMainWnd"] helpviewer_keywords: ["CWinThread [MFC], CWinThread", "CWinThread [MFC], CreateThread", "CWinThread [MFC], ExitInstance", "CWinThread [MFC], GetMainWnd", "CWinThread [MFC], GetThreadPriority", "CWinThread [MFC], InitInstance", "CWinThread [MFC], IsIdleMessage", "CWinThread [MFC], OnIdle", "CWinThread [MFC], PostThreadMessage", "CWinThread [MFC], PreTranslateMessage", "CWinThread [MFC], ProcessMessageFilter", "CWinThread [MFC], ProcessWndProcException", "CWinThread [MFC], PumpMessage", "CWinThread [MFC], ResumeThread", "CWinThread [MFC], Run", "CWinThread [MFC], SetThreadPriority", "CWinThread [MFC], SuspendThread", "CWinThread [MFC], m_bAutoDelete", "CWinThread [MFC], m_hThread", "CWinThread [MFC], m_nThreadID", "CWinThread [MFC], m_pActiveWnd", "CWinThread [MFC], m_pMainWnd"] -ms.assetid: 10cdc294-4057-4e76-ac7c-a8967a89af0b --- # `CWinThread` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Represents a thread of execution within an application. ## Syntax diff --git a/docs/mfc/reference/cwnd-class.md b/docs/mfc/reference/cwnd-class.md index 37b4d19b134..40d6e732502 100644 --- a/docs/mfc/reference/cwnd-class.md +++ b/docs/mfc/reference/cwnd-class.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["CWnd [MFC], CWnd", "CWnd [MFC], accDoDefaultAction", "CWn --- # `CWnd` Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides the base functionality of all window classes in the Microsoft Foundation Class Library. ## Syntax diff --git a/docs/mfc/reference/cwordarray-class.md b/docs/mfc/reference/cwordarray-class.md index 76e6c6e25ab..52941cdfd84 100644 --- a/docs/mfc/reference/cwordarray-class.md +++ b/docs/mfc/reference/cwordarray-class.md @@ -4,10 +4,12 @@ title: "CWordArray Class" ms.date: "09/07/2019" f1_keywords: ["CWordArray", "AFXCOLL/CWordArray", "AFXCOLL/CWordArray::CWordArray", "AFXCOLL/CWordArray::Add", "AFXCOLL/CWordArray::Append", "AFXCOLL/CWordArray::Copy", "AFXCOLL/CWordArray::ElementAt", "AFXCOLL/CWordArray::FreeExtra", "AFXCOLL/CWordArray::GetAt", "AFXCOLL/CWordArray::GetCount", "AFXCOLL/CWordArray::GetData", "AFXCOLL/CWordArray::GetSize", "AFXCOLL/CWordArray::GetUpperBound", "AFXCOLL/CWordArray::InsertAt", "AFXCOLL/CWordArray::IsEmpty", "AFXCOLL/CWordArray::RemoveAll", "AFXCOLL/CWordArray::RemoveAt", "AFXCOLL/CWordArray::SetAt", "AFXCOLL/CWordArray::SetAtGrow", "AFXCOLL/CWordArray::SetSize"] helpviewer_keywords: ["CWordArray [MFC], CWordArray", "CWordArray [MFC], Add", "CWordArray [MFC], Append", "CWordArray [MFC], Copy", "CWordArray [MFC], ElementAt", "CWordArray [MFC], FreeExtra", "CWordArray [MFC], GetAt", "CWordArray [MFC], GetCount", "CWordArray [MFC], GetData", "CWordArray [MFC], GetSize", "CWordArray [MFC], GetUpperBound", "CWordArray [MFC], InsertAt", "CWordArray [MFC], IsEmpty", "CWordArray [MFC], RemoveAll", "CWordArray [MFC], RemoveAt", "CWordArray [MFC], SetAt", "CWordArray [MFC], SetAtGrow", "CWordArray [MFC], SetSize"] -ms.assetid: 2ba2c194-2c6c-40ff-9db4-e9dbe57e1f57 --- # CWordArray Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Supports arrays of 16-bit words. ## Syntax diff --git a/docs/mfc/reference/dao-database-engine-initialization-and-termination.md b/docs/mfc/reference/dao-database-engine-initialization-and-termination.md index 67e0826e34d..937431e7009 100644 --- a/docs/mfc/reference/dao-database-engine-initialization-and-termination.md +++ b/docs/mfc/reference/dao-database-engine-initialization-and-termination.md @@ -3,10 +3,12 @@ description: "Learn more about: DAO Database Engine Initialization and Terminati title: "DAO Database Engine Initialization and Termination" ms.date: "09/17/2019" helpviewer_keywords: ["DAO (Data Access Objects), termination", "DAO (Data Access Objects), initialization"] -ms.assetid: a7edf31c-e7c2-4f3e-aada-63c3e48781da --- # DAO Database Engine Initialization and Termination +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. When using MFC DAO objects, the DAO database engine must first be initialized and then terminated before your application or DLL quits. Two functions, `AfxDaoInit` and `AfxDaoTerm`, perform these tasks. ### DAO Database Engine Initialization and Termination diff --git a/docs/mfc/reference/data-types-mfc.md b/docs/mfc/reference/data-types-mfc.md index 9893062dab9..d8c7488a1cb 100644 --- a/docs/mfc/reference/data-types-mfc.md +++ b/docs/mfc/reference/data-types-mfc.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["LPCRECT data type [MFC]", "WPARAM data type [MFC]", "data --- # Data Types (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic lists the data types most commonly used in the Microsoft Foundation Class (MFC) Library. Most of the data types are the same as those in the Platform Software Development Kit (SDK), while others are unique to MFC. For information about the data types used in both the Windows SDK and MFC, see [Windows Data Types](/windows/win32/WinProg/windows-data-types). diff --git a/docs/mfc/reference/database-macros-and-globals.md b/docs/mfc/reference/database-macros-and-globals.md index 0a51a55db66..b210e2a8037 100644 --- a/docs/mfc/reference/database-macros-and-globals.md +++ b/docs/mfc/reference/database-macros-and-globals.md @@ -4,10 +4,12 @@ title: "Database Macros and Globals" ms.date: "11/04/2016" f1_keywords: ["AFXDB/AFX_ODBC_CALL", "AFXDB/AFX_SQL_ASYNC", "AFXDB/AFX_SQL_SYNC", "AFXDB/AfxGetHENV"] helpviewer_keywords: ["global database functions [MFC]", "database macros [MFC]", "database globals [MFC]", "global functions [MFC], database functions", "macros [MFC], MFC database"] -ms.assetid: 5b9b9e61-1cf9-4345-9f29-3807dd466488 --- # Database Macros and Globals +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The macros and globals listed below apply to ODBC-based database applications. They are not used with DAO-based applications. Before MFC 4.2, the macros `AFX_SQL_ASYNC` and `AFX_SQL_SYNC` gave asynchronous operations an opportunity to yield time to other processes. Beginning with MFC 4.2, the implementation of these macros changed because the MFC ODBC classes used only synchronous operations. The macro `AFX_ODBC_CALL` was new to MFC 4.2. diff --git a/docs/mfc/reference/database-support-mfc-application-wizard.md b/docs/mfc/reference/database-support-mfc-application-wizard.md index 8430be65389..317ec1832c8 100644 --- a/docs/mfc/reference/database-support-mfc-application-wizard.md +++ b/docs/mfc/reference/database-support-mfc-application-wizard.md @@ -4,10 +4,12 @@ title: "Database Support, MFC Application Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.exe.database"] helpviewer_keywords: ["MFC Application Wizard, database support"] -ms.assetid: 9ddf4558-fd41-4ac7-8d9b-c93d9c68ab59 --- # Database Support, MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This page provides options that allow you to specify the level of database support (plus a data source, if necessary) for your project. - **Database support** diff --git a/docs/mfc/reference/ddx-dhtml-helper-macros.md b/docs/mfc/reference/ddx-dhtml-helper-macros.md index cc1d4e7bebf..597dbbc19ab 100644 --- a/docs/mfc/reference/ddx-dhtml-helper-macros.md +++ b/docs/mfc/reference/ddx-dhtml-helper-macros.md @@ -4,10 +4,12 @@ title: "DDX_DHtml Helper Macros" ms.date: "11/04/2016" f1_keywords: ["AFXDHTML/DDX_DHtml_ElementValue", "AFXDHTML/DDX_DHtml_ElementInnerText", "AFXDHTML/DDX_DHtml_ElementInnerHtml", "AFXDHTML/DDX_DHtml_Anchor_Href", "AFXDHTML/DDX_DHtml_Anchor_Target", "AFXDHTML/DDX_DHtml_Img_Src", "AFXDHTML/DDX_DHtml_Frame_Src", "AFXDHTML/DDX_DHtml_IFrame_Src"] helpviewer_keywords: ["macros [MFC], exchanging data with HMTL pages", "DDX macros [MFC]", "HTML pages [MFC], helper macros", "DDX (dialog data exchange), DHtml helper macros", "macros [MFC], DDX_DHtml helpers"] -ms.assetid: c46302d2-ea43-4fea-bfc2-6f590d99f267 --- # DDX_DHtml Helper Macros +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The DDX_DHtml helper macros allow easy access to the commonly used properties of controls on an HTML page. ### Data Exchange Macros diff --git a/docs/mfc/reference/declaring-a-variable-based-on-your-new-control-class.md b/docs/mfc/reference/declaring-a-variable-based-on-your-new-control-class.md index d911fb2a338..9d0cd90dd1f 100644 --- a/docs/mfc/reference/declaring-a-variable-based-on-your-new-control-class.md +++ b/docs/mfc/reference/declaring-a-variable-based-on-your-new-control-class.md @@ -4,10 +4,12 @@ title: "Declaring a Variable Based on Your New Control Class" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.classes.control.variable"] helpviewer_keywords: ["variables [MFC], control classes", "control classes [MFC], variables", "classes [MFC], declaring variables based on"] -ms.assetid: 5722dc38-c0eb-40bd-93da-67a808140d03 --- # Declaring a Variable Based on Your New Control Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Once you have created an MFC control class, you can declare a variable based on it. To provide a context for the new variable, you must open the dialog editor and edit the dialog box in which you want to use your reusable control. Also, the dialog box must already have a class associated with it. For information on using the dialog editor, see [Dialog Editor](../../windows/dialog-editor.md). ### To declare a variable based on your reusable class diff --git a/docs/mfc/reference/defining-a-message-handler-for-a-reflected-message.md b/docs/mfc/reference/defining-a-message-handler-for-a-reflected-message.md index 7e3b2efc820..cc57d41b8b6 100644 --- a/docs/mfc/reference/defining-a-message-handler-for-a-reflected-message.md +++ b/docs/mfc/reference/defining-a-message-handler-for-a-reflected-message.md @@ -4,10 +4,12 @@ title: "Defining a Message Handler for a Reflected Message" ms.date: "09/07/2019" f1_keywords: ["vc.codewiz.defining.msg.msghandler"] helpviewer_keywords: ["messages [MFC], reflected", "message handling [MFC], reflected messages"] -ms.assetid: 5a403528-58c5-46e7-90d5-4a77f0ab9b9c --- # Defining a Message Handler for a Reflected Message +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Once you have created a new MFC control class, you can define message handlers for it. Reflected message handlers allow your control class to handle its own messages before the message is received by the parent. You can use the MFC [CWnd::SendMessage](../../mfc/reference/cwnd-class.md#sendmessage) function to send messages from your control to a parent window. With this functionality you could, for example, create a list box that will redraw itself rather than relying on the parent window to do so (owner drawn). For more information on reflected messages, see [Handling Reflected Messages](../../mfc/handling-reflected-messages.md). diff --git a/docs/mfc/reference/delegate-and-interface-maps.md b/docs/mfc/reference/delegate-and-interface-maps.md index 518e659915c..2aa03516318 100644 --- a/docs/mfc/reference/delegate-and-interface-maps.md +++ b/docs/mfc/reference/delegate-and-interface-maps.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["delegate map macros [MFC]", "event map macros [MFC]", "in --- # Delegate and interface map macros +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC supports these macros for delegate and interface maps: |Name|Description| diff --git a/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md b/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md index 75372cba8f4..087069bbf41 100644 --- a/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md +++ b/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md @@ -4,13 +4,16 @@ title: "Details of ATL Support Added by the ATL Wizard" ms.date: "08/20/2019" f1_keywords: ["vc.codewiz.atl.support"] helpviewer_keywords: ["MFC, ATL support", "ATL, MFC projects"] -ms.assetid: aa66bad0-008f-4886-94c1-2a0a0d04bce4 --- + # Details of ATL Support Added by the ATL Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. + ::: moniker range=">=msvc-160" -When you [add ATL support to an existing MFC executable or DLL](../../mfc/reference/adding-atl-support-to-your-mfc-project.md), Visual Studio adds a header file called *framework.h* by default, which contains `#include` and `#define` preprocessor directives to enable the use of ATL in your project. No additional files or classes are added, as was done in previous versions of Visual Studio. +When you [add ATL support to an existing MFC executable or DLL](../../mfc/reference/adding-atl-support-to-your-mfc-project.md), Visual Studio adds a header file called `framework.h` by default, which contains `#include` and `#define` preprocessor directives to enable the use of ATL in your project. No additional files or classes are added, as was done in previous versions of Visual Studio. ::: moniker-end diff --git a/docs/mfc/reference/dhtml-editing-command-maps.md b/docs/mfc/reference/dhtml-editing-command-maps.md index 817b045cfc7..eb8672332d6 100644 --- a/docs/mfc/reference/dhtml-editing-command-maps.md +++ b/docs/mfc/reference/dhtml-editing-command-maps.md @@ -2,10 +2,12 @@ description: "Learn more about: DHTML Editing Command Maps" title: "DHTML Editing Command Maps" ms.date: "11/04/2016" -ms.assetid: c1b49876-039e-4a26-bb24-ea98ccf254a1 --- # DHTML Editing Command Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following macros can be used to map DHTML editing commands in [CHtmlEditView](../../mfc/reference/chtmleditview-class.md)-derived classes. For an example of their use, see [HTMLEdit Sample](../../overview/visual-cpp-samples.md). ### DHTML Editing Command Map Macros diff --git a/docs/mfc/reference/dhtml-event-maps.md b/docs/mfc/reference/dhtml-event-maps.md index b613eca890f..edc049eefaa 100644 --- a/docs/mfc/reference/dhtml-event-maps.md +++ b/docs/mfc/reference/dhtml-event-maps.md @@ -4,10 +4,12 @@ title: "DHTML Event Maps" ms.date: "11/04/2016" f1_keywords: ["vc.macros.shared"] helpviewer_keywords: ["event map macros [MFC]", "DHTML [MFC], event map macros", "macros [MFC], DHTML event map", "DHTML events [MFC], event map", "DHTML events [MFC]"] -ms.assetid: 9a2c8ae7-7216-4a5e-bc60-6b98695be0c6 --- # DHTML Event Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following macros can be used to handle DHTML events. ## DHTML Event Map Macros diff --git a/docs/mfc/reference/dhtmlurleventmapentry-structure.md b/docs/mfc/reference/dhtmlurleventmapentry-structure.md index 2664dadb6f2..d1b3181f822 100644 --- a/docs/mfc/reference/dhtmlurleventmapentry-structure.md +++ b/docs/mfc/reference/dhtmlurleventmapentry-structure.md @@ -4,10 +4,12 @@ title: "DHtmlUrlEventMapEntry Structure" ms.date: "11/04/2016" f1_keywords: ["DHtmlUrlEventMapEntry"] helpviewer_keywords: ["DHtmlUrlEventMapEntry structure [MFC]"] -ms.assetid: 43117c1f-1a51-406c-aa2f-fea647080049 --- # DHtmlUrlEventMapEntry Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The `DHtmlUrlEventMapEntry` structure provides multi-URL event map support. ## Syntax diff --git a/docs/mfc/reference/diagnostic-services.md b/docs/mfc/reference/diagnostic-services.md index 235d76280b4..afc822dd261 100644 --- a/docs/mfc/reference/diagnostic-services.md +++ b/docs/mfc/reference/diagnostic-services.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["diagnosi [MFC]s, diagnostic services", "diagnostic macros --- # Diagnostic Services +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class Library supplies many diagnostic services that make debugging your programs easier. These diagnostic services include macros and global functions that allow you to track your program's memory allocations, dump the contents of objects during run time, and print debugging messages during run time. The macros and global functions for diagnostic services are grouped into the following categories: - General diagnostic macros diff --git a/docs/mfc/reference/dialog-data-exchange-functions-for-crecordview-and-cdaorecordview.md b/docs/mfc/reference/dialog-data-exchange-functions-for-crecordview-and-cdaorecordview.md index 06e79c9647e..c9544270702 100644 --- a/docs/mfc/reference/dialog-data-exchange-functions-for-crecordview-and-cdaorecordview.md +++ b/docs/mfc/reference/dialog-data-exchange-functions-for-crecordview-and-cdaorecordview.md @@ -4,10 +4,12 @@ title: "Dialog Data Exchange Functions for CRecordView and CDaoRecordView" ms.date: "09/17/2019" f1_keywords: ["AFXDAO/DDX_FieldCBIndex", "AFXDAO/DDX_FieldCBString", "AFXDAO/DDX_FieldCBStringExact", "AFXDAO/DDX_FieldCheck", "AFXDAO/DDX_FieldLBIndex", "AFXDAO/DDX_FieldLBString", "AFXDAO/DDX_FieldLBStringExact", "AFXDAO/DDX_FieldRadio", "AFXDAO/DDX_FieldScroll", "AFXDAO/DDX_FieldText"] helpviewer_keywords: ["DDX_Field functions [MFC]", "ODBC [MFC], dialog data exchange (DDX) support", "DDX (dialog data exchange) [MFC], database support", "DDX (dialog data exchange) [MFC], functions", "databases [MFC], dialog data exchange (DDX) support", "DAO [MFC], dialog data exchange (DDX) support"] -ms.assetid: 0d8cde38-3a2c-4100-9589-ac80a7b1ce91 --- # Dialog Data Exchange Functions for CRecordView and CDaoRecordView +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic lists the DDX_Field functions used to exchange data between a [CRecordset](../../mfc/reference/crecordset-class.md) and a [CRecordView](../../mfc/reference/crecordview-class.md) form or a [CDaoRecordset](../../mfc/reference/cdaorecordset-class.md) and a [CDaoRecordView](../../mfc/reference/cdaorecordview-class.md) form. DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. > [!NOTE] diff --git a/docs/mfc/reference/dialog-data-exchange-functions-for-ole-controls.md b/docs/mfc/reference/dialog-data-exchange-functions-for-ole-controls.md index 7df654e2812..35eba789e94 100644 --- a/docs/mfc/reference/dialog-data-exchange-functions-for-ole-controls.md +++ b/docs/mfc/reference/dialog-data-exchange-functions-for-ole-controls.md @@ -4,10 +4,12 @@ title: "Dialog Data Exchange Functions for OLE Controls" ms.date: "11/04/2016" f1_keywords: ["AFXDISP/DDX_OCBool", "AFXDISP/DDX_OCBoolRO", "AFXDISP/DDX_OCColor", "AFXDISP/DDX_OCColorRO", "AFXDISP/DDX_OCFloat", "AFXDISP/DDX_OCFloatRO", "AFXDISP/DDX_OCInt", "AFXDISP/DDX_OCIntRO", "AFXDISP/DDX_OCShort", "AFXDISP/DDX_OCShortRO", "AFXDISP/DDX_OCText", "AFXDISP/DDX_OCTextRO"] helpviewer_keywords: ["OLE controls [MFC], DDX functions", "DDX (dialog data exchange), OLE support"] -ms.assetid: 7ef1f288-ff65-40d4-aad2-5497bc00bb27 --- # Dialog Data Exchange Functions for OLE Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic lists the DDX_OC functions used to exchange data between a property of an OLE control in a dialog box, form view, or control view object and a data member of the dialog box, form view, or control view object. ### DDX_OC Functions diff --git a/docs/mfc/reference/dispatch-maps.md b/docs/mfc/reference/dispatch-maps.md index 571218e9715..9d7c82dd749 100644 --- a/docs/mfc/reference/dispatch-maps.md +++ b/docs/mfc/reference/dispatch-maps.md @@ -3,10 +3,12 @@ description: "Learn more about: Dispatch Maps" title: "Dispatch Maps" ms.date: "06/20/2018" helpviewer_keywords: ["dispatch maps [MFC], macros", "dispatch maps [MFC]", "dispatch map macros [MFC]"] -ms.assetid: bef9d08b-ad35-4c3a-99d8-04150c7c04e2 --- # Dispatch Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + OLE Automation provides ways to call methods and to access properties across applications. The mechanism supplied by the Microsoft Foundation Class Library for dispatching these requests is the "dispatch map," which designates the internal and external names of object functions and properties, as well as the data types of the properties themselves and of function arguments. |Dispatch map macro|Description| diff --git a/docs/mfc/reference/document-template-strings-mfc-application-wizard.md b/docs/mfc/reference/document-template-strings-mfc-application-wizard.md index 29c42ee91a8..6cb67bac734 100644 --- a/docs/mfc/reference/document-template-strings-mfc-application-wizard.md +++ b/docs/mfc/reference/document-template-strings-mfc-application-wizard.md @@ -4,10 +4,12 @@ title: "Document Template Strings, MFC Application Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.exe.doctemp"] helpviewer_keywords: ["MFC Application Wizard, document template strings"] -ms.assetid: 8109f662-3182-4682-977a-2503321c678a --- # Document Template Strings, MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In this page of the MFC Application Wizard, provide or refine the following options to help with document management and localization. Document template strings are available for applications that include **Document/view architecture support** in the [Application Type](../../mfc/reference/application-type-mfc-application-wizard.md). They are not available for dialog boxes. Because most document template strings are visible and used by the application's users, they are localized into the **Resource language** indicated in the **Application Type** page of the wizard. - **Nonlocalized strings** diff --git a/docs/mfc/reference/edit-control-handlers.md b/docs/mfc/reference/edit-control-handlers.md index 4fc2ee2591c..4b33390e216 100644 --- a/docs/mfc/reference/edit-control-handlers.md +++ b/docs/mfc/reference/edit-control-handlers.md @@ -4,10 +4,12 @@ title: "Edit Control Handlers" ms.date: "11/04/2016" f1_keywords: ["ON_EN_ERRSPACE", "ON_EN_UPDATE", "ON_EN_VSCROLL", "ON_EN_HSCROLL", "ON_EN_KILLFOCUS", "ON_EN_MAXTEXT", "ON_EN_SETFOCUS", "ON_EN_CHANGE"] helpviewer_keywords: ["ON_EN_ERRSPACE macro [MFC]", "ON_EN_SETFOCUS macro [MFC]", "ON_EN_UPDATE macro [MFC]", "ON_EN_MAXTEXT macro [MFC]", "ON_EN_CHANGE macro [MFC]", "ON_EN_HSCROLL macro [MFC]", "ON_EN_VSCROLL macro [MFC]", "ON_EN_KILLFOCUS macro [MFC]", "edit controls [MFC], edit control handlers"] -ms.assetid: 55b88b5e-12b5-4422-b03e-c8c2f27d095c --- # Edit Control Handlers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries correspond to the function prototype. |Map entry|Function prototype| diff --git a/docs/mfc/reference/editing-a-message-handler.md b/docs/mfc/reference/editing-a-message-handler.md index 17f1783f009..e54b6e9322e 100644 --- a/docs/mfc/reference/editing-a-message-handler.md +++ b/docs/mfc/reference/editing-a-message-handler.md @@ -4,10 +4,12 @@ title: "Editing a Message Handler" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.editing.msghandler"] helpviewer_keywords: ["message handlers [MFC]", "message handling [MFC], editing handlers"] -ms.assetid: 7babb496-1f14-43b1-a14d-2e54402a92e2 --- # Editing a Message Handler +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Once you have defined a message handler, you can go to the member function's definition to add or modify code. To jump to a member function definition from the [dialog editor](../../windows/dialog-editor.md), double-click a control for which a handler is already defined. This navigates you to the file in which the selected control's message handler is defined. diff --git a/docs/mfc/reference/event-maps.md b/docs/mfc/reference/event-maps.md index 2766a3a56a5..b6392f23e83 100644 --- a/docs/mfc/reference/event-maps.md +++ b/docs/mfc/reference/event-maps.md @@ -3,10 +3,12 @@ description: "Learn more about: Event Maps" title: "Event Maps" ms.date: "09/07/2019" helpviewer_keywords: ["event maps [MFC]"] -ms.assetid: 1ed53aee-bc53-43cd-834a-6fb935c0d29b --- # Event Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Whenever a control wishes to notify its container that some action (determined by the control developer) has happened (such as a keystroke, mouse click, or a change to the control's state) it calls an event-firing function. This function notifies the control container that some important action has occurred by firing the related event. The Microsoft Foundation Class Library offers a programming model optimized for firing events. In this model, "event maps" are used to designate which functions fire which events for a particular control. Event maps contain one macro for each event. For example, an event map that fires a stock Click event might look like this: diff --git a/docs/mfc/reference/event-sink-maps.md b/docs/mfc/reference/event-sink-maps.md index e1475a88c77..d4dad8707fc 100644 --- a/docs/mfc/reference/event-sink-maps.md +++ b/docs/mfc/reference/event-sink-maps.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["event sink maps [MFC]"] --- # Event Sink Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When an embedded OLE control fires an event, the control's container receives the event using a mechanism, called an "event sink map," supplied by MFC. This event sink map designates handler functions for each specific event, as well as parameters of those events. For more information on event sink maps, see the article [ActiveX Control Containers](../../mfc/activex-control-containers.md). ### Event Sink Maps diff --git a/docs/mfc/reference/exception-processing.md b/docs/mfc/reference/exception-processing.md index cd5e64b1d63..687a470c9c4 100644 --- a/docs/mfc/reference/exception-processing.md +++ b/docs/mfc/reference/exception-processing.md @@ -3,10 +3,12 @@ description: "Learn more about: Exception Processing" title: "Exception Processing" ms.date: "11/04/2016" helpviewer_keywords: ["macros [MFC], exception handling", "DAO (Data Access Objects), exceptions [MFC]", "OLE exceptions [MFC], MFC functions", "exceptions [MFC], processing", "exception macros [MFC]", "termination functions, MFC", "MFC, exceptions", "exceptions [MFC], MFC throwing functions"] -ms.assetid: 26d4457c-8350-48f5-916e-78f919787c30 --- # Exception Processing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When a program executes, a number of abnormal conditions and errors called "exceptions" can occur. These may include running out of memory, resource allocation errors, and failure to find files. The Microsoft Foundation Class Library uses an exception-handling scheme that is modeled closely after the one proposed by the ANSI standards committee for C++. An exception handler must be set up before calling a function that may encounter an abnormal situation. If the function encounters an abnormal condition, it throws an exception and control is passed to the exception handler. diff --git a/docs/mfc/reference/extension-dll-macros.md b/docs/mfc/reference/extension-dll-macros.md index a3682634f71..548496d62fa 100644 --- a/docs/mfc/reference/extension-dll-macros.md +++ b/docs/mfc/reference/extension-dll-macros.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["module macros in MFC"] --- # Macros and functions for managing DLLs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + | Name | Description | |--|--| | [`AFX_EXT_CLASS`](#afx_ext_class)] | Exports classes. | diff --git a/docs/mfc/reference/generated-classes-mfc-application-wizard.md b/docs/mfc/reference/generated-classes-mfc-application-wizard.md index 7bdcfd54455..de59480ba26 100644 --- a/docs/mfc/reference/generated-classes-mfc-application-wizard.md +++ b/docs/mfc/reference/generated-classes-mfc-application-wizard.md @@ -4,10 +4,12 @@ title: "Generated Classes, MFC Application Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.exe.classes"] helpviewer_keywords: ["MFC Application Wizard, generated classes"] -ms.assetid: 5f33209c-7f01-4f72-8c1c-6f02f507ba9f --- # Generated Classes, MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic lists the names of base classes and files that your project generates. By default, the names are based on the project name that you specified in the **New Project Dialog Box**. You can change most of these names, as described here: - **Generated classes** diff --git a/docs/mfc/reference/generic-control-handler.md b/docs/mfc/reference/generic-control-handler.md index 7006c0d77b3..37f27818fa9 100644 --- a/docs/mfc/reference/generic-control-handler.md +++ b/docs/mfc/reference/generic-control-handler.md @@ -3,10 +3,12 @@ description: "Learn more about: Generic Control Handler" title: "Generic Control Handler" ms.date: "11/04/2016" helpviewer_keywords: ["handlers [MFC], ON_CONTROL", "handlers [MFC]", "GenericControl Handler [MFC]", "ON_CONTROL macro [MFC]"] -ms.assetid: 1e25e583-5d5a-4363-8904-839991a8570d --- # Generic Control Handler +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entry corresponds to the function prototype. |Map entry|Function prototype| diff --git a/docs/mfc/reference/gray-and-dithered-bitmap-functions.md b/docs/mfc/reference/gray-and-dithered-bitmap-functions.md index d2d80261f07..4d33b4f498a 100644 --- a/docs/mfc/reference/gray-and-dithered-bitmap-functions.md +++ b/docs/mfc/reference/gray-and-dithered-bitmap-functions.md @@ -4,10 +4,12 @@ title: "Gray and Dithered Bitmap Functions" ms.date: "11/19/2018" f1_keywords: ["AFXWIN/AfxDrawGrayBitmap", "AFXWIN/AfxGetGrayBitmap", "AFXWIN/AfxDrawDitheredBitmap", "AFXWIN/AfxGetDitheredBitmap"] helpviewer_keywords: ["gray and dithered bitmap functions [MFC]"] -ms.assetid: cb139a77-b85e-4504-9d93-24156ad77a41 --- # Gray and Dithered Bitmap Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + **Gray Bitmap Functions** MFC provides two functions for giving a bitmap the appearance of a disabled control. diff --git a/docs/mfc/reference/handlers-for-wm-messages.md b/docs/mfc/reference/handlers-for-wm-messages.md index eb656fb8f76..a562529cbd9 100644 --- a/docs/mfc/reference/handlers-for-wm-messages.md +++ b/docs/mfc/reference/handlers-for-wm-messages.md @@ -3,10 +3,12 @@ description: "Learn more about: Handlers for WM_ Messages" title: "Handlers for WM_ Messages" ms.date: "11/04/2016" helpviewer_keywords: ["WM_ messages [MFC]"] -ms.assetid: cad81690-90bf-4f77-943f-a435e7563bdd --- # Handlers for WM_ Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following topics correspond to the map entries. |Topic|Map entries| diff --git a/docs/mfc/reference/how-to-use-the-message-map-cross-reference.md b/docs/mfc/reference/how-to-use-the-message-map-cross-reference.md index 8141dd49521..b93284c67e1 100644 --- a/docs/mfc/reference/how-to-use-the-message-map-cross-reference.md +++ b/docs/mfc/reference/how-to-use-the-message-map-cross-reference.md @@ -3,10 +3,12 @@ description: "Learn more about: How to: Use the Message-Map Cross-Reference" title: "How to: Use the Message-Map Cross-Reference" ms.date: "11/04/2016" helpviewer_keywords: ["windows [MFC], message maps"] -ms.assetid: 2e863d23-9e58-45ba-b5e4-a8ceefccd0c8 --- # How to: Use the Message-Map Cross-Reference +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In entries labeled \, write your own member function for a derived [CWnd](../../mfc/reference/cwnd-class.md) class. Give your function any name you like. Other functions, such as `OnActivate`, are member functions of class `CWnd`. If called, they pass the message to the `DefWindowProc` Windows function. To process Windows notification messages, override the corresponding `CWnd` function in your derived class. Your function should call the overridden function in your base class to let the base class and Windows respond to the message. In all cases, put the function prototype in the `CWnd`-derived class header, and code the message map entry as shown. diff --git a/docs/mfc/reference/hse-version-info-structure.md b/docs/mfc/reference/hse-version-info-structure.md index 3917f359172..30cb155cdac 100644 --- a/docs/mfc/reference/hse-version-info-structure.md +++ b/docs/mfc/reference/hse-version-info-structure.md @@ -4,10 +4,12 @@ title: "HSE_VERSION_INFO Structure" ms.date: "11/04/2016" f1_keywords: ["HSE_VERSION_INFO"] helpviewer_keywords: ["HSE_VERSION_INFO structure [MFC]"] -ms.assetid: 4837312d-68c8-4d05-9afa-1934d7d49b20 --- # HSE_VERSION_INFO Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This structure is pointed to by the *pVer* parameter in the `CHttpServer::GetExtensionVersion` member function. It provides the ISA version number and a text description of the ISA. ## Syntax diff --git a/docs/mfc/reference/icommandsource-interface.md b/docs/mfc/reference/icommandsource-interface.md index 80fd3391887..b5499c10a48 100644 --- a/docs/mfc/reference/icommandsource-interface.md +++ b/docs/mfc/reference/icommandsource-interface.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["ICommandSource interface [MFC]"] --- # ICommandSource Interface +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages commands sent from a command source object to a user control. ## Syntax diff --git a/docs/mfc/reference/icommandtarget-interface.md b/docs/mfc/reference/icommandtarget-interface.md index 95e3b7d45b8..5d5d07a167a 100644 --- a/docs/mfc/reference/icommandtarget-interface.md +++ b/docs/mfc/reference/icommandtarget-interface.md @@ -4,10 +4,12 @@ title: "ICommandTarget Interface" ms.date: "11/04/2016" f1_keywords: ["ICommandTarget", "AFXWINFORMS/ICommandTarget", "AFXWINFORMS/ICommandTarget::Initialize"] helpviewer_keywords: ["ICommandTarget interface [MFC]"] -ms.assetid: dd9927f6-3479-4e7c-8ef9-13206cf901f3 --- # ICommandTarget Interface +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Provides a user control with an interface to receive commands from a command source object. ## Syntax diff --git a/docs/mfc/reference/icommandui-interface.md b/docs/mfc/reference/icommandui-interface.md index 8e4e7726a6b..c2bc8e659ea 100644 --- a/docs/mfc/reference/icommandui-interface.md +++ b/docs/mfc/reference/icommandui-interface.md @@ -4,10 +4,12 @@ title: "ICommandUI Interface" ms.date: "09/07/2019" f1_keywords: ["ICommandUI", "AFXWINFORMS/ICommandUI", "AFXWINFORMS/icommandui__Check", "AFXWINFORMS/ICommandUI::ContinueRouting", "AFXWINFORMS/ICommandUI::Enabled", "AFXWINFORMS/ICommandUI::ID", "AFXWINFORMS/ICommandUI::Index", "AFXWINFORMS/ICommandUI::Radio", "AFXWINFORMS/ICommandUI::Text"] helpviewer_keywords: ["ICommandUI interface [MFC]"] -ms.assetid: 134afe8d-dcdf-47ca-857a-a166a6b665dd --- # ICommandUI Interface +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Manages user interface commands. ## Syntax diff --git a/docs/mfc/reference/internal-classes.md b/docs/mfc/reference/internal-classes.md index 09282b431ff..ceb3619df8e 100644 --- a/docs/mfc/reference/internal-classes.md +++ b/docs/mfc/reference/internal-classes.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["UpdateTabs method [MFC]", "Start method [MFC]", "IsLast m --- # Internal Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following classes are used internally in MFC. For completeness, this section describes these internal classes, but they aren't intended to be used directly in your code. ## In This Section diff --git a/docs/mfc/reference/internet-url-parsing-globals.md b/docs/mfc/reference/internet-url-parsing-globals.md index d87c5d1798e..053844d9984 100644 --- a/docs/mfc/reference/internet-url-parsing-globals.md +++ b/docs/mfc/reference/internet-url-parsing-globals.md @@ -3,10 +3,12 @@ description: "Learn more about: Internet URL Parsing Globals and Helpers" title: "Internet URL Parsing Globals and Helpers" ms.date: "04/03/2017" helpviewer_keywords: ["parsing, URLs", "URLs, parsing"] -ms.assetid: 46c6384f-e4a6-4dbd-9196-219c19040ec5 --- # Internet URL Parsing Globals and Helpers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When a client sends a query to the Internet server, you can use one of the URL parsing globals to extract information about the client. The helper functions provide other internet functionality. ## Internet URL Parsing Globals diff --git a/docs/mfc/reference/iview-interface.md b/docs/mfc/reference/iview-interface.md index 0cd40802b71..af902350ca1 100644 --- a/docs/mfc/reference/iview-interface.md +++ b/docs/mfc/reference/iview-interface.md @@ -4,10 +4,12 @@ title: "IView Interface" ms.date: "11/04/2016" f1_keywords: ["IView", "AFXWINFORMS/IView", "AFXWINFORMS/IView::OnActivateView", "AFXWINFORMS/IView::OnInitialUpdate", "AFXWINFORMS/IView::OnUpdate"] helpviewer_keywords: ["views [MFC]", "IView class [MFC]", "views [MFC], classes"] -ms.assetid: 9321f299-486e-4551-bee9-d2c4a7b91548 --- # IView Interface +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Implements several methods that [CWinFormsView](../../mfc/reference/cwinformsview-class.md) uses to send view notifications to a managed control. ## Syntax diff --git a/docs/mfc/reference/list-box-handlers.md b/docs/mfc/reference/list-box-handlers.md index 6563a51a716..f331b682812 100644 --- a/docs/mfc/reference/list-box-handlers.md +++ b/docs/mfc/reference/list-box-handlers.md @@ -4,10 +4,12 @@ title: "List Box Handlers" ms.date: "11/04/2016" f1_keywords: ["ON_LBN_DBLCLK", "ON_LBN_ERRSPACE", "ON_LBN_SETFOCUS", "ON_LBN_SELCHANGE", "ON_LBN_KILLFOCUS"] helpviewer_keywords: ["list boxes [MFC], list box handlers", "ON_LBN_KILLFOCUS", "ON_LBN_ERRSPACE", "ON_LBN_SELCHANGE", "ON_LBN_SETFOCUS", "ON_LBN_DBLCLK"] -ms.assetid: e4e54412-2167-436a-883b-5dcad01820b8 --- # List Box Handlers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries have the corresponding function prototype. |Map entry|Function prototype| diff --git a/docs/mfc/reference/mapping-messages-to-functions.md b/docs/mfc/reference/mapping-messages-to-functions.md index 6121a62bd33..5331cb8cc67 100644 --- a/docs/mfc/reference/mapping-messages-to-functions.md +++ b/docs/mfc/reference/mapping-messages-to-functions.md @@ -4,10 +4,12 @@ title: "Mapping Messages to Functions" ms.date: "09/06/2019" f1_keywords: ["vc.codewiz.mapping.msg.function"] helpviewer_keywords: ["Windows messages [MFC], adding message handlers", "message maps [MFC], mapping messages to functions"] -ms.assetid: a7727a62-f638-4b20-b7f5-131f47200d6a --- # Mapping Messages to Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [Class Wizard](mfc-class-wizard.md) enables you to bind message handlers (member functions of MFC user-interface classes) to the messages generated by your application's resources. They use [MFC message maps](../../mfc/messages-and-commands-in-the-framework.md) to create the binding. When you use Class View to create a new class derived from one of the framework classes, it automatically places a complete and functional class in the header (.h) and implementation (.cpp) files that you specify. diff --git a/docs/mfc/reference/message-map-macros-mfc.md b/docs/mfc/reference/message-map-macros-mfc.md index f2739a164d2..8b21fa4fa91 100644 --- a/docs/mfc/reference/message-map-macros-mfc.md +++ b/docs/mfc/reference/message-map-macros-mfc.md @@ -4,10 +4,12 @@ title: "Message Map Macros (MFC)" ms.date: "03/27/2019" f1_keywords: ["AFXWIN/DECLARE_MESSAGE_MAP", "AFXWIN/BEGIN_MESSAGE_MAP", "AFXWIN/BEGIN_TEMPLATE_MESSAGE_MAP", "AFXWIN/END_MESSAGE_MAP", "AFXWIN/ON_COMMAND", "AFXWIN/ON_COMMAND_EX", "AFXWIN/ON_CONTROL", "AFXWIN/ON_MESSAGE", "AFXWIN/ON_OLECMD", "AFXWIN/ON_REGISTERED_MESSAGE", "AFXWIN/ON_REGISTERED_THREAD_MESSAGE", "AFXWIN/ON_THREAD_MESSAGE", "AFXWIN/ON_UPDATE_COMMAND_UI", "AFXWIN/ON_COMMAND_RANGE", "AFXWIN/ON_UPDATE_COMMAND_UI_RANGE", "AFXWIN/ON_CONTROL_RANGE"] helpviewer_keywords: ["message map macros", "Windows messages [MFC], declaration", "demarcating Windows messages", "message maps [MFC], macros", "message maps [MFC], declaration and demarcation", "message mapping macros", "ranges, message map", "message map ranges"] -ms.assetid: 531b15ce-32b5-4ca0-a849-bb519616c731 --- # Message Map Macros (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To support message maps, MFC supplies the following macros: ### Message-Map Declaration and Demarcation Macros diff --git a/docs/mfc/reference/message-maps-mfc.md b/docs/mfc/reference/message-maps-mfc.md index fcce99b97e6..2de3e965971 100644 --- a/docs/mfc/reference/message-maps-mfc.md +++ b/docs/mfc/reference/message-maps-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Message Maps (MFC)" title: "Message Maps (MFC)" ms.date: "09/07/2019" helpviewer_keywords: ["message maps [MFC], MFC", "Windows messages [MFC], message maps", "messages [MFC], Windows", "MFC, messages"] -ms.assetid: 3f9855e4-9d7d-4b64-8f3f-a19ea3cf79ba --- # Message Maps (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This section of the reference lists all [message mapping macros](../../mfc/reference/message-map-macros-mfc.md) and all [`CWnd`](../../mfc/reference/cwnd-class.md) message-map entries along with the corresponding member function prototypes: |Category|Description| diff --git a/docs/mfc/reference/message-types-associated-with-user-interface-objects.md b/docs/mfc/reference/message-types-associated-with-user-interface-objects.md index 61472bf5ac0..b9183f9ee34 100644 --- a/docs/mfc/reference/message-types-associated-with-user-interface-objects.md +++ b/docs/mfc/reference/message-types-associated-with-user-interface-objects.md @@ -4,10 +4,12 @@ title: "Message Types Associated with User-Interface Objects" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.uiobject.msgs"] helpviewer_keywords: ["message types and user interface objects [MFC]"] -ms.assetid: 681ee1a7-f6e6-4ea0-9fc6-1fb53a35516e --- # Message Types Associated with User-Interface Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table shows the types of objects with which you work, and the types of messages associated with them. ### User Interface Objects and Associated Messages diff --git a/docs/mfc/reference/mfc-activex-control-wizard.md b/docs/mfc/reference/mfc-activex-control-wizard.md index e949d307fa7..b3eadd27b35 100644 --- a/docs/mfc/reference/mfc-activex-control-wizard.md +++ b/docs/mfc/reference/mfc-activex-control-wizard.md @@ -4,11 +4,13 @@ title: "MFC ActiveX Control Wizard" ms.date: "03/04/2022" f1_keywords: ["vc.appwiz.mfc.ctl.overview"] helpviewer_keywords: ["ActiveX controls [MFC], MFC", "MFC ActiveX controls [MFC], wizards", "OLE controls [MFC], creating", "MFC ActiveX Control Wizard", "OLE controls [MFC]"] -ms.assetid: f19d698c-bdc3-4c74-af97-3d6ccb441b75 ms.custom: devdivchpfy22 --- # MFC ActiveX Control Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An ActiveX control is a specific type of [automation server](../../mfc/automation-servers.md); it's a reusable component. The application hosting the ActiveX control is the [automation client](../../mfc/automation-clients.md) of that control. If your goal is to create such a reusable component, then use this wizard to create your control. For more information, see [MFC ActiveX Controls](../../mfc/mfc-activex-controls.md). >[!IMPORTANT] diff --git a/docs/mfc/reference/mfc-add-class-wizard.md b/docs/mfc/reference/mfc-add-class-wizard.md index ce799af37fc..fe1567f8266 100644 --- a/docs/mfc/reference/mfc-add-class-wizard.md +++ b/docs/mfc/reference/mfc-add-class-wizard.md @@ -4,10 +4,12 @@ title: "MFC Add Class Wizard" ms.date: "09/06/2019" f1_keywords: ["vc.codewiz.class.mfc.simple.overview"] helpviewer_keywords: ["MFC Add Class Wizard", "wizards [MFC]"] -ms.assetid: ad3b0989-d307-43b2-9417-3f9a78889024 --- # MFC Add Class Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use this code wizard to add a class to an existing MFC project, or to add a class to an ATL project that supports MFC. You can also add MFC classes to Win32 projects that have MFC support. The features you specified when you created your project determine the options available in this dialog box. To access the wizard, click on **Add Class** in [Class Wizard](mfc-class-wizard.md). ![Add MFC Class Wizard.](media/add-mfc-class-wizard.png "Add MFC Class Wizard") diff --git a/docs/mfc/reference/mfc-application-wizard.md b/docs/mfc/reference/mfc-application-wizard.md index 1ca347b8771..960a05d3ce5 100644 --- a/docs/mfc/reference/mfc-application-wizard.md +++ b/docs/mfc/reference/mfc-application-wizard.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["MFC Application Wizard", "executable files, creating"] --- # MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The MFC Application Wizard generates an application that, when compiled, implements the basic features of a Windows executable (.exe) application. The MFC starter application includes C++ source (.cpp) files, resource (.rc) files, header (.h) files, and a project (.vcxproj) file. The code that is generated in these starter files is based on MFC. > [!NOTE] diff --git a/docs/mfc/reference/mfc-class-wizard.md b/docs/mfc/reference/mfc-class-wizard.md index ea0eb4c71b2..3af17c09036 100644 --- a/docs/mfc/reference/mfc-class-wizard.md +++ b/docs/mfc/reference/mfc-class-wizard.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["MFC Class Wizard"] --- # MFC Class Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use the **Class Wizard** to create new MFC classes, or add messages and message handlers to existing classes in your project. There are three ways to open the **Class Wizard**: diff --git a/docs/mfc/reference/mfc-classes.md b/docs/mfc/reference/mfc-classes.md index 8389dcd7e55..99ecdc84b58 100644 --- a/docs/mfc/reference/mfc-classes.md +++ b/docs/mfc/reference/mfc-classes.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["MFC, classes", "classes [MFC], MFC"] --- # MFC Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The classes in the following list are included in the Microsoft Foundation Class (MFC) Library. > [!TIP] diff --git a/docs/mfc/reference/mfc-dll-wizard.md b/docs/mfc/reference/mfc-dll-wizard.md index ad350303e65..6d06403db33 100644 --- a/docs/mfc/reference/mfc-dll-wizard.md +++ b/docs/mfc/reference/mfc-dll-wizard.md @@ -4,10 +4,12 @@ title: "MFC DLL Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.dll.overview"] helpviewer_keywords: ["MFC DLLs [MFC], creating", "MFC DLL Wizard", "DLLs [MFC], MFC", "DLL wizard [MFC]", "MFC DLLs [MFC]", "DLLs [MFC], creating"] -ms.assetid: 4e936031-7e39-4f40-a295-42a09c5ff264 --- # MFC DLL Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you use the MFC DLL wizard to create an MFC DLL project, you get a working starter application with built-in functionality that, when compiled, will implement the basic features of a [DLL](../../build/dlls-in-visual-cpp.md). The MFC starter program includes C++ source (.cpp) files, resource (.rc) files, and a project (.vcxproj) file. The code generated in these starter files is based on MFC. For more detailed information, see the file details in Readme.txt that is generated for your project in Visual Studio, and [Classes and Functions Generated by the MFC DLL Wizard](../../mfc/reference/classes-and-functions-generated-by-the-mfc-dll-wizard.md) ## Overview diff --git a/docs/mfc/reference/mfc-macros-and-globals.md b/docs/mfc/reference/mfc-macros-and-globals.md index 7055e4a7c74..10468fe5bbe 100644 --- a/docs/mfc/reference/mfc-macros-and-globals.md +++ b/docs/mfc/reference/mfc-macros-and-globals.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC Macros and Globals" title: "MFC Macros and Globals" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, global functions and variables", "MFC, macros", "global functions, MFC", "macros, MFC", "global functions [MFC]", "global variables, MFC", "Afx naming convention", "macros"] -ms.assetid: add4e33f-0e62-4d27-be14-896cb8675d22 --- # MFC Macros and Globals +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class Library can be divided into two major sections: (1) the MFC classes and (2) macros and globals. If a function or variable is not a member of a class, it is a global function or variable. The MFC library and the Active Template Library (ATL) share string conversion macros. For more information, see [String Conversion Macros](../../atl/reference/string-conversion-macros.md) in the ATL documentation. diff --git a/docs/mfc/reference/mfc-odbc-consumer-wizard.md b/docs/mfc/reference/mfc-odbc-consumer-wizard.md index 4b3754189d2..f63ea871767 100644 --- a/docs/mfc/reference/mfc-odbc-consumer-wizard.md +++ b/docs/mfc/reference/mfc-odbc-consumer-wizard.md @@ -3,10 +3,12 @@ description: "Learn more about: MFC ODBC Consumer Wizard" title: "MFC ODBC Consumer Wizard" ms.date: "08/29/2019" helpviewer_keywords: ["wizards [MFC]"] -ms.assetid: f64a890b-a252-4887-88a1-782a7cd4ff3d --- # MFC ODBC Consumer Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + ::: moniker range=">=msvc-160" This wizard is not available in Visual Studio 2019 and later. diff --git a/docs/mfc/reference/mfc-wizards-and-dialog-boxes.md b/docs/mfc/reference/mfc-wizards-and-dialog-boxes.md index 6a99fce2ecd..1ca91580e76 100644 --- a/docs/mfc/reference/mfc-wizards-and-dialog-boxes.md +++ b/docs/mfc/reference/mfc-wizards-and-dialog-boxes.md @@ -2,10 +2,12 @@ description: "Learn more about: MFC Wizards and Dialog Boxes" title: "MFC Wizards and Dialog Boxes" ms.date: "11/04/2016" -ms.assetid: 2fae0a2c-d147-4468-a547-f7b85df767a1 --- # MFC Wizards and Dialog Boxes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class (MFC) wizards generate boilerplate code for various kinds of components and objects. You can run the wizards by opening the shortcut menu for a project in **Solution Explorer** and choosing **Add**, **Class**. ## Related Articles diff --git a/docs/mfc/reference/ole-initialization.md b/docs/mfc/reference/ole-initialization.md index 9e2eb402775..739a71c9abf 100644 --- a/docs/mfc/reference/ole-initialization.md +++ b/docs/mfc/reference/ole-initialization.md @@ -4,10 +4,12 @@ title: "OLE Initialization" ms.date: "11/04/2016" f1_keywords: ["afxdisp/AfxOleInit", "afxdisp/AfxEnableControlContainer"] helpviewer_keywords: ["OLE initialization"] -ms.assetid: aa8a54a7-24c3-4344-b2c6-dbcf6084fa31 --- # OLE Initialization +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Before an application can use OLE system services, it must initialize the OLE system DLLs and verify that the DLLs are the correct version. The `AfxOleInit` function initializes the OLE system DLLs. ### OLE Initialization diff --git a/docs/mfc/reference/persistence-of-ole-controls.md b/docs/mfc/reference/persistence-of-ole-controls.md index f01c148c590..85a6f6459e5 100644 --- a/docs/mfc/reference/persistence-of-ole-controls.md +++ b/docs/mfc/reference/persistence-of-ole-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Persistence of OLE Controls" title: "Persistence of OLE Controls" ms.date: "11/04/2016" helpviewer_keywords: ["OLE controls [MFC], persistence", "persistence, OLE controls"] -ms.assetid: 64f8dc80-f110-41af-b3ea-14948f6bfdf7 --- # Persistence of OLE Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + One capability of OLE controls is property persistence (or serialization), which allows the OLE control to read or write property values to and from a file or stream. A container application can use serialization to store a control's property values even after the application has destroyed the control. The property values of the OLE control can then be read from the file or stream when a new instance of the control is created at a later time. ### Persistence of OLE Controls diff --git a/docs/mfc/reference/property-pages-mfc.md b/docs/mfc/reference/property-pages-mfc.md index 68a4e94fa5d..f46e45774dd 100644 --- a/docs/mfc/reference/property-pages-mfc.md +++ b/docs/mfc/reference/property-pages-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Property Pages (MFC)" title: "Property Pages (MFC)" ms.date: "11/04/2016" helpviewer_keywords: ["property page data transfer functions in MFC", "property pages [MFC], global MFC functions"] -ms.assetid: 734f88bc-c776-4136-9b0e-f45c761a45c1 --- # Property Pages (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Property pages display the current values of specific OLE control properties in a customizable, graphical interface for viewing and editing by supporting a data-mapping mechanism based on dialog data exchange (DDX). This data-mapping mechanism maps property page controls to the individual properties of the OLE control. The value of the control property reflects the status or content of the property page control. The mapping between property page controls and properties is specified by **DDP_** function calls in the property page's `DoDataExchange` member function. The following is a list of **DDP_** functions that exchange data entered using the property page of your control: diff --git a/docs/mfc/reference/record-field-exchange-functions.md b/docs/mfc/reference/record-field-exchange-functions.md index 477e1ec39a3..30388eac0ad 100644 --- a/docs/mfc/reference/record-field-exchange-functions.md +++ b/docs/mfc/reference/record-field-exchange-functions.md @@ -4,10 +4,12 @@ title: "Record Field Exchange Functions" ms.date: "09/17/2019" f1_keywords: ["AFXDB/RFX_Binary", "AFXDB/RFX_Bool", "AFXDB/RFX_Byte", "AFXDB/RFX_Date", "AFXDB/RFX_Double", "AFXDB/RFX_Int", "AFXDB/RFX_Long", "AFXDB/RFX_LongBinary", "AFXDB/RFX_Single", "AFXDB/RFX_Text", "AFXDB/RFX_Binary_Bulk", "AFXDB/RFX_Bool_Bulk", "AFXDB/RFX_Byte_Bulk", "AFXDB/RFX_Date_Bulk", "AFXDB/RFX_Double_Bulk", "AFXDB/RFX_Int_Bulk", "AFXDB/RFX_Long_Bulk", "AFXDB/RFX_Single_Bulk", "AFXDB/RFX_Text_Bulk", "AFXDB/DFX_Binary", "AFXDB/DFX_Bool", "AFXDB/DFX_Byte", "AFXDB/DFX_Currency", "AFXDB/DFX_DateTime", "AFXDB/DFX_Double", "AFXDB/DFX_Long", "AFXDB/DFX_LongBinary", "AFXDB/DFX_Short", "AFXDB/DFX_Single", "AFXDB/DFX_Text"] helpviewer_keywords: ["DAO (Data Access Objects), record field exchange (DFX)", "ODBC, bulk RFX data exchange functions [MFC]", "RFX (record field exchange), ODBC classes", "DFX (DAO record field exchange), data exchange functions [MFC]", "DFX functions [MFC]", "bulk RFX functions [MFC]", "DFX (DAO record field exchange)", "RFX (record field exchange), DAO classes", "ODBC, RFX", "RFX (record field exchange), data exchange functions [MFC]", "RFX (record field exchange)"] -ms.assetid: 6e4c5c1c-acb7-4c18-bf51-bf7959a696cd --- # Record Field Exchange Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic lists the Record Field Exchange (RFX, Bulk RFX, and DFX) functions used to automate the transfer of data between a recordset object and its data source and to perform other operations on the data. If you are using the ODBC-based classes and you have implemented bulk row fetching, you must manually override the `DoBulkFieldExchange` member function of `CRecordset` by calling the Bulk RFX functions for each data member corresponding to a data source column. diff --git a/docs/mfc/reference/registering-ole-controls.md b/docs/mfc/reference/registering-ole-controls.md index 8dd7892ccec..474f755e5d7 100644 --- a/docs/mfc/reference/registering-ole-controls.md +++ b/docs/mfc/reference/registering-ole-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Registering OLE Controls" title: "Registering OLE Controls" ms.date: "11/04/2016" helpviewer_keywords: ["registering OLE controls", "OLE controls [MFC], registering"] -ms.assetid: 73c45b7f-7dbc-43f5-bd17-dd77c6acec72 --- # Registering OLE Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + OLE controls, like other OLE server objects, can be accessed by other OLE-aware applications. This is achieved by registering the control's type library and class. The following functions allow you to add and remove the control's class, property pages, and type library in the Windows registration database: diff --git a/docs/mfc/reference/run-time-object-model-services.md b/docs/mfc/reference/run-time-object-model-services.md index b33e44f8ffd..b2554a26265 100644 --- a/docs/mfc/reference/run-time-object-model-services.md +++ b/docs/mfc/reference/run-time-object-model-services.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["run-time object model services macros"] --- # Run-Time Object Model Services +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The classes [`CObject`](../../mfc/reference/cobject-class.md) and [`CRuntimeClass`](../../mfc/reference/cruntimeclass-structure.md) encapsulate several object services, including access to run-time class information, serialization, and dynamic object creation. All classes derived from `CObject` inherit this functionality. Access to run-time class information enables you to determine information about an object's class at run time. The ability to determine the class of an object at run time is useful when you need extra type-checking of function arguments and when you must write special-purpose code based on the class of an object. Run-time class information isn't supported directly by the C++ language. diff --git a/docs/mfc/reference/standard-command-and-window-ids.md b/docs/mfc/reference/standard-command-and-window-ids.md index bd4e60b03d2..d856dbfd439 100644 --- a/docs/mfc/reference/standard-command-and-window-ids.md +++ b/docs/mfc/reference/standard-command-and-window-ids.md @@ -3,10 +3,12 @@ description: "Learn more about: Standard Command and Window IDs" title: "Standard Command and Window IDs" ms.date: "11/04/2016" helpviewer_keywords: ["standard command and Window IDs"] -ms.assetid: 0424805c-fff8-4531-8f0c-15cfb13aa612 --- # Standard Command and Window IDs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class Library defines a number of standard command and window IDs in Afxres.h. These IDs are most commonly used within the resource editors and the [Class Wizard](mfc-class-wizard.md) to map messages to your handler functions. All standard commands have an **ID_** prefix. For example, when you use the menu editor, you normally bind the File Open menu item to the standard ID_FILE_OPEN command ID. For most standard commands, application code does not need to refer to the command ID, because the framework itself handles the commands through message maps in its primary framework classes (`CWinThread`, `CWinApp`, `CView`, `CDocument`, and so on). diff --git a/docs/mfc/reference/standard-dialog-data-exchange-routines.md b/docs/mfc/reference/standard-dialog-data-exchange-routines.md index 0af24a8c467..75d3a07d319 100644 --- a/docs/mfc/reference/standard-dialog-data-exchange-routines.md +++ b/docs/mfc/reference/standard-dialog-data-exchange-routines.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["standard dialog, data exchange routines"] --- # Standard Dialog Data Exchange Routines +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic lists the standard dialog data exchange (DDX) routines used for common MFC dialog controls. > [!NOTE] diff --git a/docs/mfc/reference/standard-dialog-data-validation-routines.md b/docs/mfc/reference/standard-dialog-data-validation-routines.md index 43e9cb3e105..80d776f309b 100644 --- a/docs/mfc/reference/standard-dialog-data-validation-routines.md +++ b/docs/mfc/reference/standard-dialog-data-validation-routines.md @@ -3,10 +3,12 @@ description: "Learn more about: Standard Dialog Data Validation Routines" title: "Standard Dialog Data Validation Routines" ms.date: "11/04/2016" helpviewer_keywords: ["standard dialog, data validation routines"] -ms.assetid: 44dbc222-a897-4949-925e-7660e8964ccd --- # Standard Dialog Data Validation Routines +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic lists the standard dialog data validation (DDV) routines used for common MFC dialog controls. > [!NOTE] diff --git a/docs/mfc/reference/structures-styles-callbacks-and-message-maps.md b/docs/mfc/reference/structures-styles-callbacks-and-message-maps.md index f7b7d59f652..759dcd5d559 100644 --- a/docs/mfc/reference/structures-styles-callbacks-and-message-maps.md +++ b/docs/mfc/reference/structures-styles-callbacks-and-message-maps.md @@ -3,10 +3,12 @@ description: "Learn more about: Structures, Styles, Callbacks, and Message Maps" title: "Structures, Styles, Callbacks, and Message Maps" ms.date: "11/04/2016" helpviewer_keywords: ["callback functions, MFC", "styles, MFC", "message classes [MFC], MFC", "structures, MFC"] -ms.assetid: 27566602-7d84-4089-880c-8e90fb04fa56 --- # Structures, Styles, Callbacks, and Message Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This section documents the structures, styles, and callback functions used by the Microsoft Foundation Class Library and the MFC message maps. ## In This Section diff --git a/docs/mfc/reference/structures-used-by-mfc.md b/docs/mfc/reference/structures-used-by-mfc.md index 4e4f0a60c98..f01d1b7ccbb 100644 --- a/docs/mfc/reference/structures-used-by-mfc.md +++ b/docs/mfc/reference/structures-used-by-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Structures Used by MFC" title: "Structures Used by MFC" ms.date: "12/03/2018" helpviewer_keywords: ["structures", "structures, MFC"] -ms.assetid: 2168fcc6-e800-4814-aabf-0bca86ff790d --- # Structures Used by MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table lists structures that are called from various member functions. For further information on individual structure usage, refer to the classes and member functions noted in the See Also list for each structure. :::row::: diff --git a/docs/mfc/reference/styles-used-by-mfc.md b/docs/mfc/reference/styles-used-by-mfc.md index 7dc94df5291..57a0bfaa6b2 100644 --- a/docs/mfc/reference/styles-used-by-mfc.md +++ b/docs/mfc/reference/styles-used-by-mfc.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["button objects (CButton), button styles", "button styles --- # Styles Used by MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use the following style flags to specify window or control appearance and behavior when you create the corresponding MFC object. In most cases, these styles are set in the *`dwStyle`* parameter of the class `Create` function. ## Button styles diff --git a/docs/mfc/reference/toolbar-control-styles.md b/docs/mfc/reference/toolbar-control-styles.md index 77597a53dab..f5b7a9d6002 100644 --- a/docs/mfc/reference/toolbar-control-styles.md +++ b/docs/mfc/reference/toolbar-control-styles.md @@ -3,10 +3,12 @@ description: "Learn more about: ToolBar Control Styles" title: "ToolBar Control Styles" ms.date: "11/04/2016" helpviewer_keywords: ["ToolBar control styles [MFC]"] -ms.assetid: 0f717eb9-fa32-4263-b852-809238863feb --- # ToolBar Control Styles +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + [CMFCToolBarButton Class](../../mfc/reference/cmfctoolbarbutton-class.md) has a set of style flags that determine the appearance and behavior of the button. You can set a combination of these flags by calling [CMFCToolBarButton::SetStyle](../../mfc/reference/cmfctoolbarbutton-class.md#setstyle). This topic lists the style flag values and their meanings. ## Property Values diff --git a/docs/mfc/reference/type-casting-of-mfc-class-objects.md b/docs/mfc/reference/type-casting-of-mfc-class-objects.md index ee081937069..233e7ad3cb8 100644 --- a/docs/mfc/reference/type-casting-of-mfc-class-objects.md +++ b/docs/mfc/reference/type-casting-of-mfc-class-objects.md @@ -3,10 +3,12 @@ description: "Learn more about: Type Casting of MFC Class Objects" title: "Type Casting of MFC Class Objects" ms.date: "11/04/2016" helpviewer_keywords: ["macros [MFC], type casting", "pointers [MFC], type casting", "type casts [MFC]", "casting types [MFC]", "macros [MFC], casting pointers"] -ms.assetid: e138465e-c35f-4e84-b788-bd200ccf2f0e --- # Type Casting of MFC Class Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Type casting macros provide a way to cast a given pointer to a pointer that points to an object of specific class, with or without checking that the cast is legal. The following table lists the MFC type casting macros. diff --git a/docs/mfc/reference/type-library-access.md b/docs/mfc/reference/type-library-access.md index 6ef3220a64b..b0b56f09b88 100644 --- a/docs/mfc/reference/type-library-access.md +++ b/docs/mfc/reference/type-library-access.md @@ -3,10 +3,12 @@ description: "Learn more about: Type Library Access" title: "Type Library Access" ms.date: "11/04/2016" helpviewer_keywords: ["type libraries [MFC], accessing"] -ms.assetid: a03fa7f0-86c2-4119-bf81-202916fb74b3 --- # Type Library Access +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Type libraries expose the interfaces of an OLE control to other OLE-aware applications. Each OLE control must have a type library if one or more interfaces are to be exposed. The following macros allow an OLE control to provide access to its own type library: diff --git a/docs/mfc/reference/uicheckstate-enumeration.md b/docs/mfc/reference/uicheckstate-enumeration.md index 71cd897d5a1..8224123d07a 100644 --- a/docs/mfc/reference/uicheckstate-enumeration.md +++ b/docs/mfc/reference/uicheckstate-enumeration.md @@ -4,10 +4,12 @@ title: "UICheckState Enumeration" ms.date: "04/03/2017" f1_keywords: ["afxwinforms/uicheckstate"] helpviewer_keywords: ["uicheckstate enumeration [MFC]"] -ms.assetid: 2ac0098c-20e7-410c-9685-5ead5cb02b63 --- # UICheckState Enumeration +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Describes the check state of a user interface item for the command. ### Syntax diff --git a/docs/mfc/reference/user-button-handlers.md b/docs/mfc/reference/user-button-handlers.md index 60722f09cc4..8d81f6329ef 100644 --- a/docs/mfc/reference/user-button-handlers.md +++ b/docs/mfc/reference/user-button-handlers.md @@ -4,10 +4,12 @@ title: "User Button Handlers" ms.date: "11/04/2016" f1_keywords: ["ON_BN_HILITE", "ON_BN_DOUBLECLICKED", "ON_BN_CLICKED", "ON_BN_PAINT", "ON_BN_DISABLE", "ON_BN_UNHILITE"] helpviewer_keywords: ["ON_BN_PAINT", "user buttons [MFC]", "ON_BN_DOUBLECLICKED [MFC]", "ON_BN_DISABLE [MFC]", "ON_BN_UNHILITE [MFC]", "ON_BN_HILITE [MFC]", "ON_BN_CLICKED [MFC]"] -ms.assetid: 410ea968-478f-4806-b7b8-5d7c8dc2bf42 --- # User Button Handlers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries correspond to the function prototypes. |Map entry|Function prototype| diff --git a/docs/mfc/reference/user-defined-handlers.md b/docs/mfc/reference/user-defined-handlers.md index e975f7b8127..f7774849951 100644 --- a/docs/mfc/reference/user-defined-handlers.md +++ b/docs/mfc/reference/user-defined-handlers.md @@ -3,10 +3,12 @@ description: "Learn more about: User-Defined Handlers" title: "User-Defined Handlers" ms.date: "11/04/2016" helpviewer_keywords: ["ON_REGISTERED_MESSAGE macro [MFC]", "ON_MESSAGE macro [MFC]", "user-defined handlers [MFC]"] -ms.assetid: 99478294-bef0-4ba7-a369-25a6abdcdb62 --- # User-Defined Handlers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries correspond to the function prototypes. |Map entry|Function prototype| diff --git a/docs/mfc/reference/user-interface-features-mfc-application-wizard.md b/docs/mfc/reference/user-interface-features-mfc-application-wizard.md index 68ccfa97e30..3dee4ab90ac 100644 --- a/docs/mfc/reference/user-interface-features-mfc-application-wizard.md +++ b/docs/mfc/reference/user-interface-features-mfc-application-wizard.md @@ -4,10 +4,12 @@ title: "User Interface Features, MFC Application Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.mfc.exe.ui"] helpviewer_keywords: ["MFC Application Wizard, user interface features"] -ms.assetid: 59e7b829-a665-42eb-be23-3f2a36eb2dad --- # User Interface Features, MFC Application Wizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic explains the options that you can use to specify the look of your application. The user interface features available for your project depend on the type of application you specified in the [Application Type, MFC Application Wizard](../../mfc/reference/application-type-mfc-application-wizard.md) page of the MFC Application Wizard. For example, if you create a single document interface application, you cannot add child frame styles. - **Main frame styles** diff --git a/docs/mfc/reference/variant-parameter-type-constants.md b/docs/mfc/reference/variant-parameter-type-constants.md index 0304c57c92c..2a6d1aadeee 100644 --- a/docs/mfc/reference/variant-parameter-type-constants.md +++ b/docs/mfc/reference/variant-parameter-type-constants.md @@ -4,10 +4,12 @@ title: "Variant Parameter Type Constants" ms.date: "11/04/2016" f1_keywords: ["VTS_YPOS_HIMETRIC", "VTS_PICTURE", "VTS_FONT", "VTS_XPOS_HIMETRIC", "VTS_XPOS_PIXELS", "VTS_XSIZE_HIMETRIC", "VTS_YPOS_PIXELS", "VTS_TRISTATE", "VTS_HANDLE", "VTS_YSIZE_HIMETRIC", "VTS_COLOR", "VTS_OPTEXCLUSIVE", "VTS_YSIZE_PIXELS", "VTS_XSIZE_PIXELS"] helpviewer_keywords: ["VTS_XPOS_HIMETRIC constant [MFC]", "VTS_FONT constant [MFC]", "VTS_XPOS_PIXELS constant [MFC]", "VTS_COLOR constant [MFC]", "Variants [MFC]", "VTS_YPOS_PIXELS constant [MFC]", "VTS_YSIZE_HIMETRIC constant [MFC]", "VTS_YPOS_HIMETRIC constant [MFC]", "Variants, parameter type constants", "Variant data constants [MFC]", "VTS_PICTURE constant [MFC]", "VTS_TRISTATE constant [MFC]", "VTS_XSIZE_HIMETRIC constant [MFC]", "VTS_HANDLE constant [MFC]", "VTS_XSIZE_PIXELS constant [MFC]", "VTS_OPTEXCLUSIVE constant [MFC]", "VTS_YSIZE_PIXELS constant [MFC]"] -ms.assetid: de99c7a9-7aae-4dc4-b723-40c6380543ab --- # Variant Parameter Type Constants +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic lists new constants that indicate variant parameter types designed for use with the OLE control classes of the Microsoft Foundation Class Library. The following is a list of class constants: diff --git a/docs/mfc/reference/wm-message-handlers-a-c.md b/docs/mfc/reference/wm-message-handlers-a-c.md index e6e35de0fcc..8301bf57d3d 100644 --- a/docs/mfc/reference/wm-message-handlers-a-c.md +++ b/docs/mfc/reference/wm-message-handlers-a-c.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["ON_WM_COMPACTING [MFC]", "ON_WM_COMPAREITEM [MFC]", "ON_W --- # `WM_` Message Handlers: A - C +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries on the left correspond to the function prototypes on the right: |Map entry|Function prototype| diff --git a/docs/mfc/reference/wm-message-handlers-d-e.md b/docs/mfc/reference/wm-message-handlers-d-e.md index 3e6cded86cc..0f1932a34bd 100644 --- a/docs/mfc/reference/wm-message-handlers-d-e.md +++ b/docs/mfc/reference/wm-message-handlers-d-e.md @@ -4,10 +4,12 @@ title: "WM_ Message Handlers: D - E" ms.date: "11/04/2016" f1_keywords: ["ON_WM_ERASEBKGND", "ON_WM_DEVICECHANGE", "ON_WM_ENTERIDLE", "ON_WM_DESTROYCLIPBOARD", "ON_WM_DESTROY", "ON_WM_DEADCHAR", "ON_WM_DELETEITEM", "ON_WM_DROPFILES", "ON_WM_DEVMODECHANGE", "ON_WM_ENDSESSION", "ON_WM_ENABLE", "ON_WM_DRAWITEM", "ON_WM_DRAWCLIPBOARD"] helpviewer_keywords: ["ON_WM_ENTERIDLE [MFC]", "ON_WM_DESTROYCLIPBOARD [MFC]", "ON_WM_DEADCHAR [MFC]", "ON_WM_DEVMODECHANGE [MFC]", "ON_WM_ERASEBKGND [MFC]", "ON_WM_DESTROY [MFC]", "ON_WM_DRAWCLIPBOARD [MFC]", "ON_WM_ENDSESSION [MFC]", "ON_WM_DRAWITEM [MFC]", "ON_WM_ENABLE [MFC]", "ON_WM_DROPFILES [MFC]", "ON_WM_DELETEITEM [MFC]", "ON_WM_DEVICECHANGE [MFC]", "WM_ messages [MFC]"] -ms.assetid: 56fb89c8-68a8-4adf-883e-a9f63bf677e9 --- # WM_ Message Handlers: D - E +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries on the left correspond to the function prototypes on the right: |Map entry|Function prototype| diff --git a/docs/mfc/reference/wm-message-handlers-f-k.md b/docs/mfc/reference/wm-message-handlers-f-k.md index e696a99370d..d5fdf788d64 100644 --- a/docs/mfc/reference/wm-message-handlers-f-k.md +++ b/docs/mfc/reference/wm-message-handlers-f-k.md @@ -4,10 +4,12 @@ title: "WM_ Message Handlers: F - K" ms.date: "11/27/2018" f1_keywords: ["ON_WM_FONTCHANGE", "ON_WM_ICONERASEBKGND", "ON_WM_KEYDOWN", "ON_WM_GETMINMAXINFO", "ON_WM_KEYUP", "ON_WM_HSCROLL", "ON_WM_KILLFOCUS", "ON_WM_HSCROLLCLIPBOARD", "ON_WM_GETDLGCODE", "ON_WM_HELPINFO", "ON_WM_INITMENUPOPUP", "ON_WM_INITMENU"] helpviewer_keywords: ["ON_WM_HELPINFO [MFC]", "ON_WM_KILLFOCUS [MFC]", "ON_WM_GETMINMAXINFO [MFC]", "ON_WM_KEYUP [MFC]", "ON_WM_HSCROLL [MFC]", "ON_WM_INITMENUPOPUP [MFC]", "ON_WM_FONTCHANGE [MFC]", "ON_WM_ICONERASEBKGND [MFC]", "ON_WM_GETDLGCODE [MFC]", "ON_WM_HSCROLLCLIPBOARD [MFC]", "ON_WM_INITMENU [MFC]", "WM_ messages [MFC]", "ON_WM_KEYDOWN [MFC]"] -ms.assetid: 0e7de191-1499-499f-859c-62742797808e --- # WM_ Message Handlers: F - K +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries on the left correspond to the function prototypes on the right: |Map entry|Function prototype| diff --git a/docs/mfc/reference/wm-message-handlers-l-m.md b/docs/mfc/reference/wm-message-handlers-l-m.md index 264bc859502..6b128ee4e41 100644 --- a/docs/mfc/reference/wm-message-handlers-l-m.md +++ b/docs/mfc/reference/wm-message-handlers-l-m.md @@ -4,10 +4,12 @@ title: "WM_ Message Handlers: L - M" ms.date: "11/04/2016" f1_keywords: ["ON_WM_MENUSELECT", "ON_WM_MBUTTONDBLCLK", "ON_WM_MOUSEACTIVATE", "ON_WM_MOUSEMOVE", "ON_WM_MOVING", "ON_WM_LBUTTONUP", "ON_WM_LBUTTONDBLCLK", "ON_WM_MEASUREITEM", "ON_WM_MDIACTIVATE", "ON_WM_MOVE", "ON_WM_LBUTTONDOWN", "ON_WM_MBUTTONDOWN", "ON_WM_MENUCHAR", "ON_WM_MBUTTONUP"] helpviewer_keywords: ["ON_WM_MENUSELECT [MFC]", "ON_WM_MBUTTONDBLCLK [MFC]", "ON_WM_MOVE [MFC]", "ON_WM_MOUSEACTIVATE [MFC]", "ON_WM_MBUTTONUP [MFC]", "ON_WM_MOUSEMOVE [MFC]", "ON_WM_MENUCHAR [MFC]", "ON_WM_MBUTTONDOWN [MFC]", "ON_WM_MEASUREITEM [MFC]", "ON_WM_MOVING [MFC]", "ON_WM_LBUTTONDOWN [MFC]", "ON_WM_MDIACTIVATE [MFC]", "ON_WM_LBUTTONDBLCLK [MFC]", "ON_WM_LBUTTONUP [MFC]", "WM_ messages"] -ms.assetid: 96ecaaf1-6d13-4e12-a454-535635967489 --- # WM_ Message Handlers: L - M +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries on the left correspond to the function prototypes on the right: |Map entry|Function prototype| diff --git a/docs/mfc/reference/wm-message-handlers-n-o.md b/docs/mfc/reference/wm-message-handlers-n-o.md index 51f2cc151fc..7d21b6da435 100644 --- a/docs/mfc/reference/wm-message-handlers-n-o.md +++ b/docs/mfc/reference/wm-message-handlers-n-o.md @@ -4,10 +4,12 @@ title: "WM_ Message Handlers: N - O" ms.date: "11/04/2016" f1_keywords: ["ON_WM_NCHITTEST", "ON_WM_NCLBUTTONDOWN", "ON_WM_NCCALCSIZE", "ON_WM_NCLBUTTONUP", "ON_WM_NCPAINT", "ON_WM_NCMBUTTONUP", "ON_WM_NCCREATE", "ON_WM_NCACTIVATE", "ON_WM_NCMOUSEMOVE", "ON_WM_NCRBUTTONDBLCLK", "ON_WM_NCLBUTTONDBLCLK", "ON_WM_NCDESTROY", "ON_WM_NCMBUTTONDBLCLK", "ON_WM_NCRBUTTONDOWN", "ON_WM_NCRBUTTONUP", "ON_WM_NCMBUTTONDOWN"] helpviewer_keywords: ["ON_WM_NCCALCSIZE [MFC]", "ON_WM_NCMBUTTONDOWN [MFC]", "ON_WM_NCRBUTTONDBLCLK [MFC]", "ON_WM_NCMBUTTONDBLCLK [MFC]", "ON_WM_NCLBUTTONDBLCLK [MFC]", "ON_WM_NCDESTROY [MFC]", "ON_WM_NCRBUTTONDOWN [MFC]", "ON_WM_NCLBUTTONDOWN [MFC]", "ON_WM_NCCREATE [MFC]", "ON_WM_NCRBUTTONUP [MFC]", "ON_WM_NCLBUTTONUP [MFC]", "ON_WM_NCPAINT [MFC]", "ON_WM_NCACTIVATE [MFC]", "ON_WM_NCHITTEST [MFC]", "ON_WM_NCMOUSEMOVE [MFC]", "ON_WM_NCMBUTTONUP [MFC]", "WM_ messages"] -ms.assetid: 4efd1cda-b642-4e8b-89e8-73255fa70d77 --- # WM_ Message Handlers: N - O +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries on the left correspond to the function prototypes on the right: |Map entry|Function prototype| diff --git a/docs/mfc/reference/wm-messages-p-r.md b/docs/mfc/reference/wm-messages-p-r.md index 257f831f491..11aef99dbbf 100644 --- a/docs/mfc/reference/wm-messages-p-r.md +++ b/docs/mfc/reference/wm-messages-p-r.md @@ -4,10 +4,12 @@ title: "WM_ Messages: P - R" ms.date: "11/04/2016" f1_keywords: ["ON_WM_RBUTTONUP", "ON_WM_PALETTECHANGED", "ON_WM_RBUTTONDBLCLK", "ON_WM_QUERYENDSESSION", "ON_WM_PARENTNOTIFY", "ON_WM_PALETTEISCHANGING", "ON_WM_QUERYOPEN", "ON_WM_PAINT", "ON_WM_QUERYNEWPALETTE", "ON_WM_RBUTTONDOWN", "ON_WM_RENDERALLFORMATS", "ON_WM_PAINTCLIPBOARD", "ON_WM_RENDERFORMAT", "ON_WM_QUERYDRAGICON"] helpviewer_keywords: ["ON_WM_RENDERFORMAT [MFC]", "ON_WM_QUERYOPEN [MFC]", "ON_WM_RBUTTONDOWN [MFC]", "ON_WM_PAINTCLIPBOARD [MFC]", "ON_WM_QUERYNEWPALETTE [MFC]", "ON_WM_RBUTTONUP [MFC]", "ON_WM_PARENTNOTIFY [MFC]", "ON_WM_RBUTTONDBLCLK [MFC]", "ON_WM_PALETTECHANGED [MFC]", "ON_WM_PALETTEISCHANGING [MFC]", "ON_WM_QUERYDRAGICON [MFC]", "ON_WM_PAINT [MFC]", "ON_WM_RENDERALLFORMATS [MFC]", "ON_WM_QUERYENDSESSION [MFC]", "WM_ messages"] -ms.assetid: f46962e5-8329-4f1f-9b4d-fdad2a5ce1f8 --- # WM_ Messages: P - R +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries correspond to the function prototypes: |Map entry|Function prototype| diff --git a/docs/mfc/reference/wm-messages-s.md b/docs/mfc/reference/wm-messages-s.md index 78fee76db60..70fb5ac333d 100644 --- a/docs/mfc/reference/wm-messages-s.md +++ b/docs/mfc/reference/wm-messages-s.md @@ -4,10 +4,12 @@ title: "WM_ Messages: S" ms.date: "11/04/2016" f1_keywords: ["ON_WM_SYSDEADCHAR", "ON_WM_SYSKEYDOWN", "ON_WM_STYLECHANGING", "ON_WM_STYLECHANGED", "ON_WM_SPOOLERSTATUS", "ON_WM_SYSCHAR", "ON_WM_SETFOCUS", "ON_WM_SIZE", "ON_WM_SIZING", "ON_WM_SETCURSOR", "ON_WM_SYSCOMMAND", "ON_WM_SETTINGCHANGE", "ON_WM_SHOWWINDOW", "ON_WM_SYSKEYUP", "ON_WM_SIZECLIPBOARD", "ON_WM_SYSCOLORCHANGE"] helpviewer_keywords: ["ON_WM_SIZE [MFC]", "ON_WM_SETFOCUS [MFC]", "ON_WM_SIZING [MFC]", "ON_WM_SYSCHAR [MFC]", "ON_WM_SETTINGCHANGE [MFC]", "ON_WM_SYSDEADCHAR [MFC]", "ON_WM_SHOWWINDOW [MFC]", "ON_WM_STYLECHANGING [MFC]", "ON_WM_SYSCOMMAND [MFC]", "ON_WM_STYLECHANGED [MFC]", "ON_WM_SPOOLERSTATUS [MFC]", "ON_WM_SYSCOLORCHANGE [MFC]", "ON_WM_SETCURSOR [MFC]", "ON_WM_SIZECLIPBOARD [MFC]", "ON_WM_SYSKEYUP [MFC]", "ON_WM_SYSKEYDOWN [MFC]", "WM_ messages"] -ms.assetid: 4b9aec79-a98f-4aa0-a3d9-110941b6dcbc --- # WM_ Messages: S +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries correspond to the function prototypes. |Map entry|Function prototype| diff --git a/docs/mfc/reference/wm-messages-t-z.md b/docs/mfc/reference/wm-messages-t-z.md index b60436e68dc..4c65130ce0f 100644 --- a/docs/mfc/reference/wm-messages-t-z.md +++ b/docs/mfc/reference/wm-messages-t-z.md @@ -4,10 +4,12 @@ title: "WM_ Messages: T - Z" ms.date: "11/04/2016" f1_keywords: ["ON_WM_TCARD", "ON_WM_WININICHANGE", "ON_WM_VSCROLLCLIPBOARD", "ON_WM_VSCROLL", "ON_WM_WINDOWPOSCHANGED", "ON_WM_TIMECHANGE", "ON_WM_TIMER", "ON_WM_VKEYTOITEM", "ON_WM_WINDOWPOSCHANGING"] helpviewer_keywords: ["ON_WM_VSCROLLCLIPBOARD [MFC]", "ON_WM_WININICHANGE [MFC]", "ON_WM_WINDOWPOSCHANGED [MFC]", "ON_WM_TCARD [MFC]", "ON_WM_TIMECHANGE [MFC]", "ON_WM_TIMER [MFC]", "WM_ messages [MFC]", "ON_WM_WINDOWPOSCHANGING [MFC]", "ON_WM_VKEYTOITEM [MFC]", "ON_WM_VSCROLL"] -ms.assetid: c528bb2e-ddb5-4da6-b652-432a387408b8 --- # WM_ Messages: T - Z +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following map entries correspond to the function prototypes: |Map entry|Function prototype| diff --git a/docs/mfc/reflected-window-message-ids.md b/docs/mfc/reflected-window-message-ids.md index 45071edf6dd..aec1d557a2b 100644 --- a/docs/mfc/reflected-window-message-ids.md +++ b/docs/mfc/reflected-window-message-ids.md @@ -4,10 +4,12 @@ title: "Reflected Window Message IDs" ms.date: "11/04/2016" f1_keywords: ["OCM_CTLCOLORBTN", "OCM_PARENTNOTIFY", "OCM_VKEYTOITEM", "OCM_CTLCOLORSTATIC", "OCM_HSCROLL", "OCM_CHARTOITEM", "OCM_DRAWITEM", "OCM_MEASUREITEM", "OCM_COMPAREITEM", "OCM_COMMAND", "OCM_NOTIFY", "OCM_CTLCOLORMSGBOX", "OCM_DELETEITEM", "OCM_CTLCOLORLISTBOX", "OCM_CTLCOLORDLG", "OCM_CTLCOLOREDIT", "OCM_CTLCOLORSCROLLBAR", "OCM_VSCROLL", "OCM_CTLCOLOR"] helpviewer_keywords: ["OCM_HSCROLL message [MFC]", "OCM_PARENTNOTIFY message [MFC]", "messages, reflected", "reflected messages, window message Ids", "OCM_CTLCOLORDLG message [MFC]", "OCM_COMMAND message [MFC]", "OCM_CTLCOLORMSGBOX message [MFC]", "OCM_COMPAREITEM message [MFC]", "OCM_DRAWITEM message [MFC]", "OCM_VSCROLL message [MFC]", "OCM_CTLCOLOREDIT message [MFC]", "OCM_VKEYTOITEM message [MFC]", "OCM_CHARTOITEM message [MFC]", "OCM_CTLCOLORBTN message [MFC]", "OCM_CTLCOLORSTATIC message [MFC]", "OCM_MEASUREITEM message [MFC]", "OCM_CTLCOLOR message [MFC]", "OCM_CTLCOLORSCROLLBAR message [MFC]", "OCM_ messages", "OCM_DELETEITEM message [MFC]", "OCM_CTLCOLORLISTBOX message [MFC]", "OCM_NOTIFY message [MFC]", "reflected messages"] -ms.assetid: 3417ff51-ff9f-458c-bff4-17c200f00d96 --- # Reflected Window Message IDs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A quick way to create an ActiveX control, or other specialized control, is to subclass a window. For more information, see [MFC ActiveX Controls: Subclassing a Windows Control](../mfc/mfc-activex-controls-subclassing-a-windows-control.md). To prevent the control's container from receiving the window messages sent by a subclassed Windows control, [COleControl](../mfc/reference/colecontrol-class.md) creates a "reflector" window to intercept certain window messages and send them back to the control. The control, in its window procedure, can then process these reflected messages by taking actions appropriate for an ActiveX control. diff --git a/docs/mfc/registering-window-classes.md b/docs/mfc/registering-window-classes.md index 20bf96df284..be9840fb0a4 100644 --- a/docs/mfc/registering-window-classes.md +++ b/docs/mfc/registering-window-classes.md @@ -4,11 +4,13 @@ title: "Registering Window Classes" ms.date: "11/04/2016" f1_keywords: ["WndProc"] helpviewer_keywords: ["window classes [MFC], registering", "registry [MFC], registering classes", "AfxRegisterWndClass method [MFC]", "MFC, windows", "WinMain method [MFC], and registering window classes", "WndProc method [MFC]", "classes [MFC], registering window classes", "WinMain method [MFC]", "registering window classes [MFC]"] -ms.assetid: 30994bc4-a362-43da-bcc5-1bf67a3fc929 ms.topic: concept-article --- # Registering Window Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Window "classes" in traditional programming for Windows define the characteristics of a "class" (not a C++ class) from which any number of windows can be created. This kind of class is a template or model for creating windows. ## Window Class Registration in Traditional Programs for Windows diff --git a/docs/mfc/registration.md b/docs/mfc/registration.md index 93dd93f87f5..33ac6b7fa0b 100644 --- a/docs/mfc/registration.md +++ b/docs/mfc/registration.md @@ -3,10 +3,12 @@ description: "Learn more about: Registration" title: "Registration" ms.date: "11/04/2016" helpviewer_keywords: ["servers [MFC], initializing", "initializing servers [MFC]", "OLE, registration", "installing servers [MFC]", "registry [MFC], OLE item database", "registration databases [MFC]", "servers [MFC], installing", "OLE server applications [MFC], registering servers"] -ms.assetid: 991d5684-72c1-4f9e-a09a-9184ed12bbb9 --- # Registration +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When a user wants to insert an OLE item into an application, OLE presents a list of object types to choose from. OLE gets this list from the system registration database, which contains information provided by all server applications. When a server registers itself, the entries it puts into the system registration database (the Registry) describe each type of object it supplies, file extensions, and the path to itself, among other information. The framework and the OLE system dynamic-link libraries (DLL) use this registry to determine what types of OLE items are available on the system. The OLE system DLLs also use this registry to determine how to launch a server application when a linked or embedded object is activated. diff --git a/docs/mfc/relationship-between-a-cpp-window-object-and-an-hwnd.md b/docs/mfc/relationship-between-a-cpp-window-object-and-an-hwnd.md index 91522b05d2d..0ce79cf6314 100644 --- a/docs/mfc/relationship-between-a-cpp-window-object-and-an-hwnd.md +++ b/docs/mfc/relationship-between-a-cpp-window-object-and-an-hwnd.md @@ -4,10 +4,12 @@ title: "Relationship Between a C++ Window Object and an HWND" ms.date: "11/19/2018" f1_keywords: ["HWND"] helpviewer_keywords: ["Windows window [MFC]", "window objects [MFC], HWND and", "HWND [MFC]", "CWnd class [MFC], HWND", "HWND, window objects [MFC]"] -ms.assetid: f2e76340-6691-4ee6-9424-0345634a9469 --- # Relationship Between a C++ Window Object and an HWND +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The window *object* is an object of the C++ `CWnd` class (or a derived class) that your program creates directly. It comes and goes in response to your program's constructor and destructor calls. The Windows *window*, on the other hand, is an opaque handle to an internal Windows data structure that corresponds to a window and consumes system resources when present. A Windows window is identified by a "window handle" (`HWND`) and is created after the `CWnd` object is created by a call to the `Create` member function of class `CWnd`. The window may be destroyed either by a program call or by a user's action. The window handle is stored in the window object's *m_hWnd* member variable. The following figure shows the relationship between the C++ window object and the Windows window. Creating windows is discussed in [Creating Windows](../mfc/creating-windows.md). Destroying windows is discussed in [Destroying Window Objects](../mfc/destroying-window-objects.md). ![CWnd window object and resulting window.](../mfc/media/vc37fj1.gif "CWnd window object and resulting window")
diff --git a/docs/mfc/relationship-to-the-c-language-api.md b/docs/mfc/relationship-to-the-c-language-api.md index 22c012bd971..5fe382a89a6 100644 --- a/docs/mfc/relationship-to-the-c-language-api.md +++ b/docs/mfc/relationship-to-the-c-language-api.md @@ -3,10 +3,12 @@ description: "Learn more about: Relationship to the C-Language API" title: "Relationship to the C-Language API" ms.date: "11/04/2016" helpviewer_keywords: ["books [MFC], about MFC and Windows SDK", "books [MFC]", "MFC, Windows API", "Visual C, Windows API calls", "Windows API [MFC], and MFC"] -ms.assetid: 334e8efc-f3cc-4018-bc2e-02908b2a39fe --- # Relationship to the C-Language API +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The single characteristic that sets the Microsoft Foundation Class (MFC) Library apart from other class libraries for Windows is the very close mapping to the Windows API written in the C language. Further, you can generally mix calls to the class library freely with direct calls to the Windows API. This direct access does not, however, imply that the classes are a complete replacement for that API. Developers must still occasionally make direct calls to some Windows functions, such as [SetCursor](/windows/win32/api/winuser/nf-winuser-setcursor) and [GetSystemMetrics](/windows/win32/api/winuser/nf-winuser-getsystemmetrics), for example. A Windows function is wrapped by a class member function only when there is a clear advantage to doing so. Because you sometimes need to make native Windows function calls, you should have access to the C-language Windows API documentation. This documentation is included with Visual Studio. diff --git a/docs/mfc/relationships-among-mfc-objects.md b/docs/mfc/relationships-among-mfc-objects.md index 81cdad19204..a81651518ab 100644 --- a/docs/mfc/relationships-among-mfc-objects.md +++ b/docs/mfc/relationships-among-mfc-objects.md @@ -3,10 +3,12 @@ description: "Learn more about: Relationships Among MFC Objects" title: "Relationships Among MFC Objects" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, relationships between key objects", "objects [MFC], relationships", "relationships, MFC objects", "MFC object relationships"] -ms.assetid: 6e8f3b51-e80f-4d88-94c8-4c1e4ee163ad --- # Relationships Among MFC Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To help put the document/view creation process in perspective, consider a running program: a document, the frame window used to contain the view, and the view associated with the document. - A document keeps a list of the views of that document and a pointer to the document template that created the document. From 77d011251234af8130fec5147636162bf8c2df35 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 24 Feb 2026 12:05:05 -0800 Subject: [PATCH 1655/1799] Batch 11: update files (#6265) --- docs/mfc/responding-to-dynamic-data-exchange-dde.md | 4 +++- docs/mfc/retrieving-data-from-the-dialog-object.md | 4 +++- docs/mfc/ribbon-designer-mfc.md | 4 +++- docs/mfc/rich-edit-control-examples.md | 4 +++- docs/mfc/role-of-the-view-in-printing.md | 4 +++- docs/mfc/root-class-cobject.md | 4 +++- docs/mfc/rubber-banding-and-trackers.md | 4 +++- docs/mfc/run-member-function.md | 4 +++- docs/mfc/scrolling-and-scaling-views.md | 4 +++- ...crolling-arranging-sorting-and-finding-in-list-controls.md | 4 +++- docs/mfc/sdi-and-mdi.md | 4 +++- docs/mfc/security-implications-of-customization.md | 4 +++- docs/mfc/selecting-a-graphic-object-into-a-device-context.md | 4 +++- .../sequence-of-operations-for-building-mfc-applications.md | 4 +++- .../sequence-of-operations-for-creating-activex-controls.md | 4 +++- ...quence-of-operations-for-creating-database-applications.md | 4 +++- .../sequence-of-operations-for-creating-ole-applications.md | 4 +++- docs/mfc/serialization-in-mfc.md | 4 +++- docs/mfc/serialization-making-a-serializable-class.md | 4 +++- .../serialization-serialization-vs-database-input-output.md | 4 +++- docs/mfc/serialization-serializing-an-object.md | 4 +++- docs/mfc/serializing-data-to-and-from-files.md | 4 +++- docs/mfc/servers-implementing-a-server.md | 4 +++- docs/mfc/servers-implementing-in-place-frame-windows.md | 4 +++- docs/mfc/servers-implementing-server-documents.md | 4 +++- docs/mfc/servers-server-items.md | 4 +++- docs/mfc/servers-user-interface-issues.md | 4 +++- docs/mfc/servers.md | 4 +++- docs/mfc/setting-a-hot-key.md | 4 +++- docs/mfc/setting-the-day-state-of-a-month-calendar-control.md | 4 +++- docs/mfc/setting-the-dialog-boxs-background-color.md | 3 +++ docs/mfc/setting-the-images-for-an-individual-item.md | 4 +++- docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md | 4 +++- docs/mfc/settings-for-the-cstatusbarctrl.md | 4 +++- docs/mfc/settings-for-the-progress-control.md | 4 +++- docs/mfc/settings-for-the-tool-tip-control.md | 4 +++- docs/mfc/settings-for-the-toolbar-control.md | 4 +++- docs/mfc/simple-data-type-classes.md | 4 +++- docs/mfc/slider-control-member-functions.md | 4 +++- docs/mfc/slider-control-styles.md | 4 +++- docs/mfc/slider-notification-messages.md | 4 +++- docs/mfc/special-cwinapp-services.md | 4 +++- docs/mfc/specifying-levels-of-functionality.md | 4 +++- docs/mfc/spin-button-member-functions.md | 4 +++- docs/mfc/spin-button-styles.md | 4 +++- docs/mfc/standard-commands.md | 4 +++- docs/mfc/status-bar-implementation-in-mfc.md | 4 +++- docs/mfc/status-bars.md | 4 +++- ...ps-in-a-typical-ftp-client-application-to-delete-a-file.md | 4 +++- docs/mfc/steps-in-a-typical-ftp-client-application.md | 4 +++- docs/mfc/steps-in-a-typical-gopher-client-application.md | 4 +++- docs/mfc/steps-in-a-typical-http-client-application.md | 4 +++- docs/mfc/steps-in-a-typical-internet-client-application.md | 4 +++- docs/mfc/storing-and-loading-cobjects-via-an-archive.md | 4 +++- docs/mfc/stream-operations-in-rich-edit-controls.md | 4 +++- docs/mfc/styles-for-the-progress-control.md | 4 +++- ...support-for-activation-contexts-in-the-mfc-module-state.md | 4 +++- docs/mfc/tab-controls-and-property-sheets.md | 4 +++- docs/mfc/tabs-and-tab-control-attributes.md | 4 +++- docs/mfc/technical-notes-by-category.md | 4 +++- docs/mfc/technical-notes-by-number.md | 4 +++- docs/mfc/template-based-classes.md | 4 +++- docs/mfc/template-classes-for-arrays-lists-and-maps.md | 4 +++- docs/mfc/testing-internet-applications.md | 4 +++- docs/mfc/testing-properties-and-events-with-test-container.md | 3 +++ docs/mfc/the-ccmdui-class.md | 4 +++- docs/mfc/thread-specific-hot-keys.md | 4 +++- docs/mfc/tn001-window-class-registration.md | 4 +++- docs/mfc/tn002-persistent-object-data-format.md | 3 +++ docs/mfc/tn003-mapping-of-windows-handles-to-objects.md | 4 +++- docs/mfc/tn006-message-maps.md | 4 +++- docs/mfc/tn011-using-mfc-as-part-of-a-dll.md | 4 +++- docs/mfc/tn014-custom-controls.md | 3 +++ docs/mfc/tn016-using-cpp-multiple-inheritance-with-mfc.md | 4 +++- docs/mfc/tn017-destroying-window-objects.md | 4 +++- docs/mfc/tn020-id-naming-and-numbering-conventions.md | 4 +++- docs/mfc/tn021-command-and-message-routing.md | 4 +++- docs/mfc/tn022-standard-commands-implementation.md | 4 +++- docs/mfc/tn023-standard-mfc-resources.md | 4 +++- docs/mfc/tn024-mfc-defined-messages-and-resources.md | 4 +++- docs/mfc/tn025-document-view-and-frame-creation.md | 4 +++- docs/mfc/tn026-ddx-and-ddv-routines.md | 4 +++- docs/mfc/tn028-context-sensitive-help-support.md | 4 +++- docs/mfc/tn029-splitter-windows.md | 4 +++- docs/mfc/tn030-customizing-printing-and-print-preview.md | 4 +++- docs/mfc/tn031-control-bars.md | 4 +++- docs/mfc/tn032-mfc-exception-mechanism.md | 4 +++- docs/mfc/tn033-dll-version-of-mfc.md | 3 +++ ...ultiple-resource-files-and-header-files-with-visual-cpp.md | 4 +++- .../tn036-using-cformview-with-appwizard-and-classwizard.md | 4 +++- docs/mfc/tn037-multithreaded-mfc-2-1-applications.md | 4 +++- docs/mfc/tn038-mfc-ole-iunknown-implementation.md | 3 +++ docs/mfc/tn039-mfc-ole-automation-implementation.md | 4 +++- docs/mfc/tn040-mfc-ole-in-place-resizing-and-zooming.md | 4 +++- docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md | 4 +++- docs/mfc/tn042-odbc-driver-developer-recommendations.md | 4 +++- docs/mfc/tn043-rfx-routines.md | 4 +++- docs/mfc/tn044-mfc-support-for-dbcs.md | 4 +++- .../tn045-mfc-database-support-for-long-varchar-varbinary.md | 4 +++- docs/mfc/tn046-commenting-conventions-for-the-mfc-classes.md | 4 +++- 100 files changed, 300 insertions(+), 94 deletions(-) diff --git a/docs/mfc/responding-to-dynamic-data-exchange-dde.md b/docs/mfc/responding-to-dynamic-data-exchange-dde.md index cfcc4ddc454..c34e3e3c131 100644 --- a/docs/mfc/responding-to-dynamic-data-exchange-dde.md +++ b/docs/mfc/responding-to-dynamic-data-exchange-dde.md @@ -3,11 +3,13 @@ description: "Learn more about: Responding to Dynamic Data Exchange (DDE)" title: "Responding to Dynamic Data Exchange (DDE)" ms.date: "11/04/2016" helpviewer_keywords: ["registry [MFC], most recently used files", "frame windows [MFC], dynamic data exchange (DDE)", "DDE (Dynamic Data Exchange), frame windows", "registration [MFC], shell", "Shell [MFC], registering file types", "windows [MFC], and dynamic data exchange", "responding to dynamic data exchange (DDE)", "frame windows [MFC], shell registration"] -ms.assetid: 4db838d5-62cf-4123-915a-66e514155c0c ms.topic: concept-article --- # Responding to Dynamic Data Exchange (DDE) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The frame window can respond to dynamic data exchange (DDE) requests to open files from the File Manager (if the file extension is registered or associated with the application). See [Shell Registration](../mfc/special-cwinapp-services.md). ## See also diff --git a/docs/mfc/retrieving-data-from-the-dialog-object.md b/docs/mfc/retrieving-data-from-the-dialog-object.md index 0177ee9d4a8..cd3e39f36e0 100644 --- a/docs/mfc/retrieving-data-from-the-dialog-object.md +++ b/docs/mfc/retrieving-data-from-the-dialog-object.md @@ -3,11 +3,13 @@ description: "Learn more about: Retrieving Data from the Dialog Object" title: "Retrieving Data from the Dialog Object" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], retrieving user data", "dialog box data [MFC]", "data [MFC], retrieving", "GetDlgItemText method [MFC]", "SetDlgItemText method [MFC]", "SetWindowText method [MFC]", "dialog box data [MFC], retrieving", "retrieving data [MFC]", "user input [MFC], retrieving from MFC dialog boxes", "capturing user input [MFC]", "dialog box controls [MFC], initializing values", "DDX (dialog data exchange) [MFC]", "MFC dialog boxes [MFC], retrieving user input", "data retrieval [MFC], dialog boxes", "data [MFC], dialog boxes", "DDX (dialog data exchange) [MFC], about DDX", "DDX (dialog data exchange) [MFC], retrieving data from Dialog object", "GetWindowText method [MFC]"] -ms.assetid: bdca2b61-6b53-4c2e-b426-8712c7a38ec0 ms.topic: concept-article --- # Retrieving Data from the Dialog Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The framework provides an easy way to initialize the values of controls in a dialog box and to retrieve values from the controls. The more laborious manual approach is to call functions such as the `SetDlgItemText` and `GetDlgItemText` member functions of class `CWnd`, which apply to control windows. With these functions, you access each control individually to set or get its value, calling functions such as `SetWindowText` and `GetWindowText`. The framework's approach automates both initialization and retrieval. Dialog data exchange (DDX) lets you exchange data between the controls in the dialog box and member variables in the dialog object more easily. This exchange works both ways. To initialize the controls in the dialog box, you can set the values of data members in the dialog object, and the framework will transfer the values to the controls before the dialog box is displayed. Then you can at any time update the dialog data members with data entered by the user. At that point, you can use the data by referring to the data member variables. diff --git a/docs/mfc/ribbon-designer-mfc.md b/docs/mfc/ribbon-designer-mfc.md index d642ff01095..92a66a7e4ec 100644 --- a/docs/mfc/ribbon-designer-mfc.md +++ b/docs/mfc/ribbon-designer-mfc.md @@ -4,10 +4,12 @@ title: "Ribbon Designer (MFC)" ms.date: "11/19/2018" f1_keywords: ["vc.editors.ribbon.F1"] helpviewer_keywords: ["Ribbon Designer (MFC)", "MFC Ribbon Designer"] -ms.assetid: 0806dfd6-7d11-471a-99e1-4072852231f9 --- # Ribbon Designer (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Ribbon Designer lets you create and customize ribbons in MFC applications. A ribbon is a user interface (UI) element that organizes commands into logical groups. These groups appear on separate tabs in a strip across the top of the window. The ribbon replaces the menu bar and toolbars. A ribbon can significantly improve application usability. For more information, see [Ribbons](/windows/win32/uxguide/cmd-ribbons). The following illustration shows a ribbon. ![MFC Ribbon Resource Control.](../mfc/media/ribbon_no_callouts.png "MFC Ribbon Resource Control") diff --git a/docs/mfc/rich-edit-control-examples.md b/docs/mfc/rich-edit-control-examples.md index 8a37dc61eb9..f5b095f2dc4 100644 --- a/docs/mfc/rich-edit-control-examples.md +++ b/docs/mfc/rich-edit-control-examples.md @@ -2,10 +2,12 @@ description: "Learn more about: Rich Edit Control Examples" title: "Rich Edit Control Examples" ms.date: "02/06/2019" -ms.assetid: ac98bf45-ca74-459c-9b3e-df278a67a00f --- # Rich Edit Control Examples +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The MFC OLE sample [WORDPAD](https://github.com/Microsoft/VCSamples/tree/da802c2aa92a730b3da33c5957186f128709c398/VC2010Samples/MFC/Visual%20C%2B%2B%202008%20Feature%20Pack/WordPad) uses the `CRichEditView`, `CRichEditDoc`, and `CRichEditCntrItem` classes. By extension, it uses the [CRichEditCtrl](../mfc/reference/cricheditctrl-class.md). For a quick description of these three classes, see [Classes Related to Rich Edit Controls](../mfc/classes-related-to-rich-edit-controls.md). ## See also diff --git a/docs/mfc/role-of-the-view-in-printing.md b/docs/mfc/role-of-the-view-in-printing.md index d6d0724eeaa..5900d5ab150 100644 --- a/docs/mfc/role-of-the-view-in-printing.md +++ b/docs/mfc/role-of-the-view-in-printing.md @@ -3,10 +3,12 @@ description: "Learn more about: Role of the View in Printing" title: "Role of the View in Printing" ms.date: "11/04/2016" helpviewer_keywords: ["views [MFC], printing", "OnDraw method [MFC], and printing", "printing [MFC], OnDraw method [MFC]", "printing [MFC], views", "CView class [MFC], role in printing", "printing views [MFC]"] -ms.assetid: 8d4a3c8e-1fce-4edc-b608-94cb5f3e487e --- # Role of the View in Printing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Your view also plays two important roles in printing its associated document. The view: diff --git a/docs/mfc/root-class-cobject.md b/docs/mfc/root-class-cobject.md index 3f59550cd10..faaf0b9e8cb 100644 --- a/docs/mfc/root-class-cobject.md +++ b/docs/mfc/root-class-cobject.md @@ -3,10 +3,12 @@ description: "Learn more about: Root Class: CObject" title: "Root Class: CObject" ms.date: "11/04/2016" helpviewer_keywords: ["base classes [MFC], MFC objects", "classes [MFC], MFC base class [MFC]", "root class [MFC]", "MFC, base class"] -ms.assetid: 593706f3-e9e5-435f-815d-e7b5176b2a61 --- # Root Class: CObject +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Most of the classes in the Microsoft Foundation Class (MFC) Library are derived from a single base class at the root of the class hierarchy. `CObject` provides a number of useful capabilities to all classes derived from it, with very low overhead. For more information about `CObject` and its capabilities, see [Using CObject](../mfc/using-cobject.md). [CObject](../mfc/reference/cobject-class.md)
diff --git a/docs/mfc/rubber-banding-and-trackers.md b/docs/mfc/rubber-banding-and-trackers.md index 78313d57451..0e3385f5383 100644 --- a/docs/mfc/rubber-banding-and-trackers.md +++ b/docs/mfc/rubber-banding-and-trackers.md @@ -3,11 +3,13 @@ description: "Learn more about: Rubber-Banding and Trackers" title: "Rubber-Banding and Trackers" ms.date: "11/04/2016" helpviewer_keywords: ["trackers [MFC]", "CRectTracker class [MFC], implementing trackers", "OLE objects [MFC], selecting", "rubber banding [MFC]", "WM_LBUTTONDOWN [MFC]"] -ms.assetid: 0d0fa64c-6418-4baf-ab7f-2d16ca039230 ms.topic: concept-article --- # Rubber-Banding and Trackers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Another feature supplied with trackers is the "rubber-band" selection, which allows a user to select multiple OLE items by dragging a sizing rectangle around the items to be selected. When the user releases the left mouse button, items within the region selected by the user are selected and can be manipulated by the user. For instance, the user might drag the selection into another container application. Implementing this feature requires some additional code in your application's WM_LBUTTONDOWN handler function. diff --git a/docs/mfc/run-member-function.md b/docs/mfc/run-member-function.md index d9524c34a85..6c22de662c5 100644 --- a/docs/mfc/run-member-function.md +++ b/docs/mfc/run-member-function.md @@ -3,10 +3,12 @@ description: "Learn more about: Run Member Function" title: "Run Member Function" ms.date: "11/04/2016" helpviewer_keywords: ["WinMain method [MFC]"] -ms.assetid: 24ab7597-2354-495b-9a20-2c8ccc7385b3 --- # Run Member Function +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A framework application spends most of its time in the [Run](../mfc/reference/cwinapp-class.md#run) member function of class [CWinApp](../mfc/reference/cwinapp-class.md). After initialization, `WinMain` calls `Run` to process the message loop. `Run` cycles through a message loop, checking the message queue for available messages. If a message is available, `Run` dispatches it for action. If no messages are available, which is often true, `Run` calls `OnIdle` to do any idle-time processing that you or the framework may need done. If there are no messages and no idle processing to do, the application waits until something happens. When the application terminates, `Run` calls `ExitInstance`. The figure in [OnIdle Member Function](../mfc/onidle-member-function.md) shows the sequence of actions in the message loop. diff --git a/docs/mfc/scrolling-and-scaling-views.md b/docs/mfc/scrolling-and-scaling-views.md index ae3f1dd968d..ab7a05dacbb 100644 --- a/docs/mfc/scrolling-and-scaling-views.md +++ b/docs/mfc/scrolling-and-scaling-views.md @@ -3,11 +3,13 @@ description: "Learn more about: Scrolling and Scaling Views" title: "Scrolling and Scaling Views" ms.date: "11/04/2016" helpviewer_keywords: ["message handlers [MFC]", "scaling views [MFC]", "message handling [MFC], scroll bars in view class [MFC]", "scroll bars [MFC], messages", "scrolling views [MFC]"] -ms.assetid: f98a3421-c336-407e-97ee-dbb2ffd76fbd ms.topic: concept-article --- # Scrolling and Scaling Views +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC supports views that scroll and views that are automatically scaled to the size of the frame window that displays them. Class `CScrollView` supports both kinds of views. For more information about scrolling and scaling, see class [CScrollView](../mfc/reference/cscrollview-class.md) in the *MFC Reference*. For a scrolling example, see the [Scribble sample](../overview/visual-cpp-samples.md). diff --git a/docs/mfc/scrolling-arranging-sorting-and-finding-in-list-controls.md b/docs/mfc/scrolling-arranging-sorting-and-finding-in-list-controls.md index 118697bf2bf..d2f6e704ec7 100644 --- a/docs/mfc/scrolling-arranging-sorting-and-finding-in-list-controls.md +++ b/docs/mfc/scrolling-arranging-sorting-and-finding-in-list-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Scrolling, Arranging, Sorting, and Finding in Li title: "Scrolling, Arranging, Sorting, and Finding in List Controls" ms.date: "06/03/2019" helpviewer_keywords: ["image lists [MFC], sorting", "image lists [MFC], arranging", "image lists [MFC], scrolling", "CListCtrl class [MFC], finding items in", "image lists [MFC], finding items", "CListCtrl class [MFC], scrolling", "CListCtrl class [MFC], sorting", "CListCtrl class [MFC], arranging the list"] -ms.assetid: dcc51e4c-0ca8-4319-bec5-6994cc8ac9e5 --- # Scrolling, Arranging, Sorting, and Finding in List Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + List controls ([CListCtrl](../mfc/reference/clistctrl-class.md)) are scrollable by default. For more information, see [Scroll Position](/windows/win32/Controls/using-list-view-controls) in the Windows SDK and the [Scroll](../mfc/reference/clistctrl-class.md#scroll) member function. You can call `CListCtrl` member functions to arrange list items in the control, sort items, and find particular items. For more information, see [Using ListView Controls](/windows/win32/Controls/using-list-view-controls) in the Windows SDK and the [CListCtrl](../mfc/reference/clistctrl-class.md) members [Arrange](../mfc/reference/clistctrl-class.md#arrange), [SortItems](../mfc/reference/clistctrl-class.md#sortitems), and [FindItem](../mfc/reference/clistctrl-class.md#finditem). diff --git a/docs/mfc/sdi-and-mdi.md b/docs/mfc/sdi-and-mdi.md index 9eb07bb3531..0d8faf95203 100644 --- a/docs/mfc/sdi-and-mdi.md +++ b/docs/mfc/sdi-and-mdi.md @@ -3,10 +3,12 @@ description: "Learn more about: SDI and MDI" title: "SDI and MDI" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], SDI applications", "frame windows [MFC], MDI applications", "MFC, windows", "single document interface (SDI) [MFC], applications", "MDI [MFC], vs. SDI"] -ms.assetid: bb7239d9-4759-4f63-bfff-44a04b48c067 --- # SDI and MDI +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC makes it easy to work with both single-document interface (SDI) and multiple-document interface (MDI) applications. SDI applications allow only one open document frame window at a time. MDI applications allow multiple document frame windows to be open in the same instance of an application. An MDI application has a window within which multiple MDI child windows, which are frame windows themselves, can be opened, each containing a separate document. In some applications, the child windows can be of different types, such as chart windows and spreadsheet windows. In that case, the menu bar can change as MDI child windows of different types are activated. diff --git a/docs/mfc/security-implications-of-customization.md b/docs/mfc/security-implications-of-customization.md index e5a33963ddb..ba8a5191d15 100644 --- a/docs/mfc/security-implications-of-customization.md +++ b/docs/mfc/security-implications-of-customization.md @@ -3,10 +3,12 @@ description: "Learn more about: Security Implications of Customization" title: "Security Implications of Customization" ms.date: "11/04/2016" helpviewer_keywords: ["security, MFC Feature Pack", "MFC Feature Pack, security"] -ms.assetid: 9be96b12-be38-43bd-a133-5d671265f7a1 --- # Security Implications of Customization +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic discusses a potential security weakness in MFC. ## Potential Security Weakness diff --git a/docs/mfc/selecting-a-graphic-object-into-a-device-context.md b/docs/mfc/selecting-a-graphic-object-into-a-device-context.md index 722c6609e74..a1946b710d9 100644 --- a/docs/mfc/selecting-a-graphic-object-into-a-device-context.md +++ b/docs/mfc/selecting-a-graphic-object-into-a-device-context.md @@ -3,11 +3,13 @@ description: "Learn more about: Selecting a Graphic Object into a Device Context title: "Selecting a Graphic Object into a Device Context" ms.date: "11/04/2016" helpviewer_keywords: ["graphic objects [MFC], selecting into device context", "SelectObject method [MFC]", "GDI objects [MFC], device contexts", "lifetime, graphic objects [MFC]", "device contexts, selecting graphic objects into", "device contexts, graphic objects [MFC]"] -ms.assetid: cf54a330-63ef-421f-83eb-90ec7bd82eef ms.topic: concept-article --- # Selecting a Graphic Object into a Device Context +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This topic applies to using graphic objects in a window's device context. After you [create a drawing object](../mfc/one-stage-and-two-stage-construction-of-objects.md), you must select it into the device context in place of the default object stored there: [!code-cpp[NVC_MFCDocViewSDI#7](../mfc/codesnippet/cpp/selecting-a-graphic-object-into-a-device-context_1.cpp)] diff --git a/docs/mfc/sequence-of-operations-for-building-mfc-applications.md b/docs/mfc/sequence-of-operations-for-building-mfc-applications.md index 529a989c36c..a19042a0516 100644 --- a/docs/mfc/sequence-of-operations-for-building-mfc-applications.md +++ b/docs/mfc/sequence-of-operations-for-building-mfc-applications.md @@ -3,10 +3,12 @@ description: "Learn more about: Sequence of Operations for Building MFC Applicat title: "Sequence of Operations for Building MFC Applications" ms.date: "09/09/2019" helpviewer_keywords: ["applications [MFC], developing"] -ms.assetid: 6973c714-fe20-48c6-926b-de88356b3a3d --- # Sequence of Operations for Building MFC Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table explains the general sequence you might typically follow as you develop your MFC application. ### Sequence for Building an Application with the Framework diff --git a/docs/mfc/sequence-of-operations-for-creating-activex-controls.md b/docs/mfc/sequence-of-operations-for-creating-activex-controls.md index e534e12453f..ac9ef6254a2 100644 --- a/docs/mfc/sequence-of-operations-for-creating-activex-controls.md +++ b/docs/mfc/sequence-of-operations-for-creating-activex-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Sequence of Operations for Creating ActiveX Cont title: "Sequence of Operations for Creating ActiveX Controls" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], creating", "ActiveX controls [MFC], creating", "sequence [MFC], for creating ActiveX controls", "OLE controls [MFC], MFC", "sequence [MFC]"] -ms.assetid: 7d868c53-a0af-4ef6-a89c-e1c03c583a53 --- # Sequence of Operations for Creating ActiveX Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table shows your role and the framework's role in creating ActiveX controls (formerly known as OLE controls). ### Creating ActiveX Controls diff --git a/docs/mfc/sequence-of-operations-for-creating-database-applications.md b/docs/mfc/sequence-of-operations-for-creating-database-applications.md index 8243421de2d..ea35c960ae0 100644 --- a/docs/mfc/sequence-of-operations-for-creating-database-applications.md +++ b/docs/mfc/sequence-of-operations-for-creating-database-applications.md @@ -3,10 +3,12 @@ description: "Learn more about: Sequence of Operations for Creating Database App title: "Sequence of Operations for Creating Database Applications" ms.date: "11/04/2016" helpviewer_keywords: ["applications [MFC], database", "database applications [MFC]", "database applications [MFC], creating", "MFC, database applications"] -ms.assetid: 9371da59-8536-43cd-8314-706ad320e2ec --- # Sequence of Operations for Creating Database Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table shows your role and the framework's role in writing database applications. > [!NOTE] diff --git a/docs/mfc/sequence-of-operations-for-creating-ole-applications.md b/docs/mfc/sequence-of-operations-for-creating-ole-applications.md index 067edaef529..3ea89654f37 100644 --- a/docs/mfc/sequence-of-operations-for-creating-ole-applications.md +++ b/docs/mfc/sequence-of-operations-for-creating-ole-applications.md @@ -3,10 +3,12 @@ description: "Learn more about: Sequence of Operations for Creating OLE Applicat title: "Sequence of Operations for Creating OLE Applications" ms.date: "11/04/2016" helpviewer_keywords: ["OLE applications [MFC], creating", "OLE applications [MFC]", "applications [OLE], creating", "applications [OLE]"] -ms.assetid: 84b0f606-36c1-4253-9cea-44427f0074b9 --- # Sequence of Operations for Creating OLE Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table shows your role and the framework's role in creating OLE linking and embedding applications. These represent options available rather than a sequence of steps to perform. ### Creating OLE Applications diff --git a/docs/mfc/serialization-in-mfc.md b/docs/mfc/serialization-in-mfc.md index e864816e8ab..36fb257c7f9 100644 --- a/docs/mfc/serialization-in-mfc.md +++ b/docs/mfc/serialization-in-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Serialization in MFC" title: "Serialization in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["collection classes [MFC], serialization", "bypassing serialization [MFC]", "MFC, serialization", "serialization [MFC], MFC", "serialization [MFC], bypassing"] -ms.assetid: fb596a18-4522-47e0-96e0-192732d24c12 --- # Serialization in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the serialization mechanism provided in the Microsoft Foundation Class Library (MFC) to allow objects to persist between runs of your program. Serialization is the process of writing or reading an object to or from a persistent storage medium such as a disk file. Serialization is ideal for situations where it is desired to maintain the state of structured data (such as C++ classes or structures) during or after execution of a program. Using the serialization objects provided by MFC allows this to occur in a standard and consistent manner, relieving the user from the need to perform file operations by hand. diff --git a/docs/mfc/serialization-making-a-serializable-class.md b/docs/mfc/serialization-making-a-serializable-class.md index 1f99e1741f4..c5108c24f65 100644 --- a/docs/mfc/serialization-making-a-serializable-class.md +++ b/docs/mfc/serialization-making-a-serializable-class.md @@ -3,10 +3,12 @@ description: "Learn more about: Serialization: Making a Serializable Class" title: "Serialization: Making a Serializable Class" ms.date: "11/04/2016" helpviewer_keywords: ["serializable class [MFC]", "DECLARE_SERIAL macro [MFC]", "default constructor [MFC]", "VERSIONABLE_SCHEMA macro [MFC]", "classes [MFC], derived", "IMPLEMENT_SERIAL macro [MFC]", "no-arguments constructor [MFC]", "Serialize method, overriding", "defaults [MFC], constructor", "CObject class [MFC], deriving serializable classes", "constructors [MFC], defining with no arguments", "serialization [MFC], serializable classes", "no default constructor"] -ms.assetid: 59a14d32-1cc8-4275-9829-99639beee27c --- # Serialization: Making a Serializable Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Five main steps are required to make a class serializable. They are listed below and explained in the following sections: 1. [Deriving your class from CObject](#_core_deriving_your_class_from_cobject) (or from some class derived from `CObject`). diff --git a/docs/mfc/serialization-serialization-vs-database-input-output.md b/docs/mfc/serialization-serialization-vs-database-input-output.md index e1aca76ea6c..52e8a9d75a6 100644 --- a/docs/mfc/serialization-serialization-vs-database-input-output.md +++ b/docs/mfc/serialization-serialization-vs-database-input-output.md @@ -3,10 +3,12 @@ description: "Learn more about: Serialization: Serialization vs. Database Input/ title: "Serialization: Serialization vs. Database Input-Output" ms.date: "11/04/2016" helpviewer_keywords: ["database applications [MFC], file I/O vs. serialization", "serialization [MFC], vs. database I/O", "I/O [MFC], vs. serialization", "databases [MFC], input/output handling"] -ms.assetid: f1d23d77-4761-4a52-a7ea-54fc92d347ea --- # Serialization: Serialization vs. Database Input/Output +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains when to use document objects and serialization for file-based input/output (I/O) and when other I/O techniques are appropriate — because the application reads and writes data on a per-transaction basis, as in database applications. If you don't use serialization, you also won't need the File Open, Save, and Save As commands. Topics covered include: - [Recommendations for handling input/output](../mfc/recommendations-for-handling-input-output.md) diff --git a/docs/mfc/serialization-serializing-an-object.md b/docs/mfc/serialization-serializing-an-object.md index 232074c244b..cadb13d0f3f 100644 --- a/docs/mfc/serialization-serializing-an-object.md +++ b/docs/mfc/serialization-serializing-an-object.md @@ -3,10 +3,12 @@ description: "Learn more about: Serialization: Serializing an Object" title: "Serialization: Serializing an Object" ms.date: "11/04/2016" helpviewer_keywords: ["serializing objects [MFC]", "serialization [MFC], objects", "objects [MFC], serializing"] -ms.assetid: 1db772b1-ad55-4fcf-b133-126cca082510 --- # Serialization: Serializing an Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The article [Serialization: Making a Serializable Class](../mfc/serialization-making-a-serializable-class.md) shows how to make a class serializable. Once you have a serializable class, you can serialize objects of that class to and from a file via a [CArchive](../mfc/reference/carchive-class.md) object. This article explains: - [What a CArchive object is](../mfc/what-is-a-carchive-object.md). diff --git a/docs/mfc/serializing-data-to-and-from-files.md b/docs/mfc/serializing-data-to-and-from-files.md index 4131496be72..f261f8b8832 100644 --- a/docs/mfc/serializing-data-to-and-from-files.md +++ b/docs/mfc/serializing-data-to-and-from-files.md @@ -3,11 +3,13 @@ description: "Learn more about: Serializing Data to and from Files" title: "Serializing Data to and from Files" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], serialization", "documents [MFC], saving", "saving documents", "deserialization [MFC]", "serialization [MFC], role of document", "serialization [MFC], role of data", "data [MFC]", "data [MFC], serializing", "document data [MFC]"] -ms.assetid: b42a0c68-4bc4-4012-9938-5433a26d2c24 ms.topic: concept-article --- # Serializing Data to and from Files +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The basic idea of persistence is that an object should be able to write its current state, indicated by the values of its member variables, to persistent storage. Later, the object can be re-created by reading, or "deserializing," the object's state from persistent storage. A key point here is that the object itself is responsible for reading and writing its own state. Thus, for a class to be persistent, it must implement the basic serialization operations. The framework provides a default implementation for saving documents to disk files in response to the Save and Save As commands on the File menu and for loading documents from disk files in response to the Open command. With very little work, you can implement a document's ability to write and read its data to and from a file. The main thing you must do is override the [Serialize](../mfc/reference/cobject-class.md#serialize) member function in your document class. diff --git a/docs/mfc/servers-implementing-a-server.md b/docs/mfc/servers-implementing-a-server.md index c7b9e42a749..d7e904aaf38 100644 --- a/docs/mfc/servers-implementing-a-server.md +++ b/docs/mfc/servers-implementing-a-server.md @@ -3,10 +3,12 @@ description: "Learn more about: Servers: Implementing a Server" title: "Servers: Implementing a Server" ms.date: "11/04/2016" helpviewer_keywords: ["servers, implementing", "OLE server applications [MFC], implementing OLE servers"] -ms.assetid: 5bd57e8e-3b23-4f23-9597-496fac2d24b5 --- # Servers: Implementing a Server +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the code the MFC Application Wizard creates for a visual editing server application. If you are not using the application wizard, this article lists the areas where you must write code to implement a server application. If you are using the application wizard to create a new server application, it provides a significant amount of server-specific code for you. If you are adding visual editing server functionality to an existing application, you must duplicate the code that the application wizard would have provided before adding the rest of the necessary server code. diff --git a/docs/mfc/servers-implementing-in-place-frame-windows.md b/docs/mfc/servers-implementing-in-place-frame-windows.md index ae276eda3ea..8df12137b90 100644 --- a/docs/mfc/servers-implementing-in-place-frame-windows.md +++ b/docs/mfc/servers-implementing-in-place-frame-windows.md @@ -3,10 +3,12 @@ description: "Learn more about: Servers: Implementing In-Place Frame Windows" title: "Servers: Implementing In-Place Frame Windows" ms.date: "09/09/2019" helpviewer_keywords: ["frame windows [MFC], implementing", "OLE server applications [MFC], frame windows", "servers, in-place frame windows", "frame windows [MFC], in-place", "in-place frame windows"] -ms.assetid: 09bde4d8-15e2-4fba-8d14-9b954d926b92 --- # Servers: Implementing In-Place Frame Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains what you must do to implement in-place frame windows in your visual editing server application if you do not use the application wizard to create your server application. In place of following the procedure outlined in this article, you could use an existing in-place frame-window class from either an application wizard-generated application or a sample provided with Visual Studio. #### To declare an in-place frame-window class diff --git a/docs/mfc/servers-implementing-server-documents.md b/docs/mfc/servers-implementing-server-documents.md index 63a6bb9c0bb..05049ed51a8 100644 --- a/docs/mfc/servers-implementing-server-documents.md +++ b/docs/mfc/servers-implementing-server-documents.md @@ -3,10 +3,12 @@ description: "Learn more about: Servers: Implementing Server Documents" title: "Servers: Implementing Server Documents" ms.date: "11/04/2016" helpviewer_keywords: ["OLE server applications [MFC], managing server documents", "OLE server applications [MFC], implementing OLE servers", "servers, server documents", "server documents [MFC], implementing"] -ms.assetid: cca1451a-ad09-47ed-b56e-bccd78fc86d1 --- # Servers: Implementing Server Documents +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the steps you must take to successfully implement a server document if you did not specify the OLE Server option in the application wizard. #### To define a server document class diff --git a/docs/mfc/servers-server-items.md b/docs/mfc/servers-server-items.md index 86bcb8eb760..8ede0e366d0 100644 --- a/docs/mfc/servers-server-items.md +++ b/docs/mfc/servers-server-items.md @@ -3,10 +3,12 @@ description: "Learn more about: Servers: Server Items" title: "Servers: Server Items" ms.date: "11/04/2016" helpviewer_keywords: ["server items, implementing", "servers [MFC], server items", "architecture [MFC], server-item", "server items", "OLE server applications [MFC], server items"] -ms.assetid: 28ba81a1-726a-4728-a52d-68bc7efd5a3c --- # Servers: Server Items +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When a container launches a server so that a user can edit an embedded or linked OLE item, the server application creates a "server item." The server item, which is an object of a class derived from `COleServerItem`, provides an interface between the server document and the container application. The `COleServerItem` class defines several overridable member functions that are called by OLE, usually in response to requests from the container. Server items can represent part of the server document or the entire document. When an OLE item is embedded in the container document, the server item represents the entire server document. When the OLE item is linked, the server item can represent a part of the server document or the whole document, depending on whether the link is to a part or to the whole. diff --git a/docs/mfc/servers-user-interface-issues.md b/docs/mfc/servers-user-interface-issues.md index d0dd6bf54da..5c53ea2e53b 100644 --- a/docs/mfc/servers-user-interface-issues.md +++ b/docs/mfc/servers-user-interface-issues.md @@ -3,10 +3,12 @@ description: "Learn more about: Servers: User-Interface Issues" title: "Servers: User-Interface Issues" ms.date: "11/04/2016" helpviewer_keywords: ["OLE server applications [MFC], user interface", "servers, user-interface issues", "user interface issues"] -ms.assetid: 7ef55702-b439-43fa-8ced-c69b96239a89 --- # Servers: User-Interface Issues +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A server application has a number of features that must be added to the user interface to supply OLE items to container applications. For further information on the menus and additional resources that need to be added to a server application, see [Menus and Resources: Server Additions](../mfc/menus-and-resources-server-additions.md). ## See also diff --git a/docs/mfc/servers.md b/docs/mfc/servers.md index 79e33d42863..f4ad231f490 100644 --- a/docs/mfc/servers.md +++ b/docs/mfc/servers.md @@ -3,10 +3,12 @@ description: "Learn more about: Servers" title: "Servers" ms.date: "11/04/2016" helpviewer_keywords: ["OLE server applications [MFC]", "OLE server applications [MFC], activation", "full-server", "servers", "mini-server", "OLE server applications [MFC], server types", "server applications [MFC]"] -ms.assetid: e45172e8-eae3-400a-8139-0fa009a42fdc --- # Servers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A server application (or component application) creates OLE items (or components) for use by container applications. A visual editing server application also supports visual editing or in-place activation. Another form of OLE server is an [automation server](../mfc/automation-servers.md). Some server applications support only the creation of embedded items; others support the creation of both embedded and linked items. Some support linking only, although this is rare. All server applications must support activation by container applications when the user wants to edit an item. An application can be both a container and a server. In other words, it can both incorporate data into its documents, and create data that can be incorporated as items into other applications' documents. A miniserver is a special type of server application that can only be launched by a container. Microsoft Draw and Microsoft Graph are examples of miniservers. A miniserver does not store documents as files on disk. Instead, it reads its documents from and writes them to items in documents belonging to containers. As a result, a miniserver supports embedding only, not linking. diff --git a/docs/mfc/setting-a-hot-key.md b/docs/mfc/setting-a-hot-key.md index fbe03ecfbdd..902a72d9a00 100644 --- a/docs/mfc/setting-a-hot-key.md +++ b/docs/mfc/setting-a-hot-key.md @@ -3,11 +3,13 @@ description: "Learn more about: Setting a Hot Key" title: "Setting a Hot Key" ms.date: "11/04/2016" helpviewer_keywords: ["keyboard shortcuts [MFC], hot keys", "access keys [MFC], hot keys", "CHotKeyCtrl class [MFC], setting hot key"] -ms.assetid: 6f3bc141-e346-4dce-9ca7-3e6b2c453f3f ms.topic: concept-article --- # Setting a Hot Key +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Your application can use the information provided by a hot key ([CHotKeyCtrl](../mfc/reference/chotkeyctrl-class.md)) control in one of two ways: - Set up a global hot key for activating a nonchild window by sending a [WM_SETHOTKEY](/windows/win32/inputdev/wm-sethotkey) message to the window to be activated. diff --git a/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md b/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md index f563ff6a993..8e99333c363 100644 --- a/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md +++ b/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md @@ -4,11 +4,13 @@ title: "Setting the Day State of a Month Calendar Control" ms.date: "11/04/2016" f1_keywords: ["MCN_GETDAYSTATE"] helpviewer_keywords: ["CMonthCalCtrl class [MFC], setting day state info", "MCN_GETDAYSTATE notification [MFC]", "month calendar controls [MFC], day state info"] -ms.assetid: 435d1b11-ec0e-4121-9e25-aaa6af812a3c ms.topic: how-to --- # Setting the Day State of a Month Calendar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + One of the attributes of a month calendar control is the ability to store information, referred to as the day state of the control, for each day of the month. This information is used to emphasize certain dates for the month currently displayed. > [!NOTE] diff --git a/docs/mfc/setting-the-dialog-boxs-background-color.md b/docs/mfc/setting-the-dialog-boxs-background-color.md index f9636fc6710..5adc2f37f3c 100644 --- a/docs/mfc/setting-the-dialog-boxs-background-color.md +++ b/docs/mfc/setting-the-dialog-boxs-background-color.md @@ -7,6 +7,9 @@ ms.topic: concept-article --- # Setting the Dialog Box's Background Color +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can set the background color of your dialog boxes by handling `WM_CTLCOLOR` messages for the dialog box window. The color you set is used for only the specified dialog box. For example, the following code fragment sets the background color of the dialog box to dark grey. The `OnCtlColor` member function is called whenever the dialog box is redrawn: diff --git a/docs/mfc/setting-the-images-for-an-individual-item.md b/docs/mfc/setting-the-images-for-an-individual-item.md index d8b1d62da58..e871b56a334 100644 --- a/docs/mfc/setting-the-images-for-an-individual-item.md +++ b/docs/mfc/setting-the-images-for-an-individual-item.md @@ -3,11 +3,13 @@ description: "Learn more about: Setting the Images for an Individual Item" title: "Setting the Images for an Individual Item" ms.date: "11/04/2016" helpviewer_keywords: ["extended combo boxes [MFC], images", "images [MFC], combo box items"] -ms.assetid: bde83db8-23a7-4e35-837a-c86447d2c0af ms.topic: how-to --- # Setting the Images for an Individual Item +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The different types of images used by the extended combo box item are determined by the values in the *iImage*, *iSelectedImage*, and *iOverlay* members of the [COMBOBOXEXITEM](/windows/win32/api/commctrl/ns-commctrl-comboboxexitemw) structure. Each value is the index of an image in the associated image list of the control. By default, these members are set to 0, causing the control to display no image for the item. If you want to use images for a specific item, you can modify the structure accordingly, either when inserting the combo box item or by modifying an existing combo box item. ## Setting the Image for a New Item diff --git a/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md b/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md index 2b6710e45a3..cbf9cb32b0f 100644 --- a/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md +++ b/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md @@ -3,11 +3,13 @@ description: "Learn more about: Setting the Mode of a CStatusBarCtrl Object" title: "Setting the Mode of a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["simple mode and status bar controls", "IsSimple method, using", "SetSimple method [MFC]", "status bar controls [MFC], simple and nonsimple modes", "non-simple mode and status bar controls", "CStatusBarCtrl class [MFC], simple and nonsimple modes"] -ms.assetid: ca6076e5-1501-4e33-8d35-9308941e46c0 ms.topic: concept-article --- # Setting the Mode of a CStatusBarCtrl Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + There are two modes for a `CStatusBarCtrl` object: simple and nonsimple. In the majority of cases, your status bar control will have one or more parts, along with text and perhaps an icon or icons. This is called the nonsimple mode. For more information on this mode, see [Initializing the Parts of a CStatusBarCtrl Object](../mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md). However, there are cases where you only need to display a single line of text. In this case, the simple mode is sufficient for your needs. To change the mode of the `CStatusBarCtrl` object to simple, make a call to the [SetSimple](../mfc/reference/cstatusbarctrl-class.md#setsimple) member function. Once the status bar control is in simple mode, set the text by calling the `SetText` member function, passing 255 as the value for the *nPane* parameter. diff --git a/docs/mfc/settings-for-the-cstatusbarctrl.md b/docs/mfc/settings-for-the-cstatusbarctrl.md index a8ec8d51a93..332b48a0464 100644 --- a/docs/mfc/settings-for-the-cstatusbarctrl.md +++ b/docs/mfc/settings-for-the-cstatusbarctrl.md @@ -3,10 +3,12 @@ description: "Learn more about: Settings for the CStatusBarCtrl" title: "Settings for the CStatusBarCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["status bar controls [MFC], settings", "CStatusBarCtrl class [MFC], settings"] -ms.assetid: adeba0c3-17f3-435c-b140-a57845e9ce49 --- # Settings for the CStatusBarCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The default position of a [CStatusBarCtrl](../mfc/reference/cstatusbarctrl-class.md) status window is along the bottom of the parent window, but you can specify the CCS_TOP style to have it appear at the top of the parent window's client area. You can specify the SBARS_SIZEGRIP style to include a sizing grip at the right end of the `CStatusBarCtrl` status window. A sizing grip is similar to a sizing border; it is a rectangular area that the user can click and drag to resize the parent window. diff --git a/docs/mfc/settings-for-the-progress-control.md b/docs/mfc/settings-for-the-progress-control.md index 982abdb535b..778150af132 100644 --- a/docs/mfc/settings-for-the-progress-control.md +++ b/docs/mfc/settings-for-the-progress-control.md @@ -3,10 +3,12 @@ description: "Learn more about: Settings for the Progress Control" title: "Settings for the Progress Control" ms.date: "11/04/2016" helpviewer_keywords: ["CProgressCtrl class [MFC], settings", "progress controls [MFC], settings"] -ms.assetid: f4616e91-74fa-4000-ba0d-d3ddc0ee075b --- # Settings for the Progress Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The basic settings for the progress control ([CProgressCtrl](../mfc/reference/cprogressctrl-class.md)) are the range and current position. The range represents the entire duration of the operation. The current position represents the progress that your application has made toward completing the operation. Any changes to the range or position cause the progress control to redraw itself. By default, the range is set to 0 - 100, and the initial position is set to 0. To retrieve the current range settings for the progress control, use the [GetRange](../mfc/reference/cprogressctrl-class.md#getrange) member function. To change the range, use the [SetRange](../mfc/reference/cprogressctrl-class.md#setrange) member function. diff --git a/docs/mfc/settings-for-the-tool-tip-control.md b/docs/mfc/settings-for-the-tool-tip-control.md index 05c07197ab0..adde2501854 100644 --- a/docs/mfc/settings-for-the-tool-tip-control.md +++ b/docs/mfc/settings-for-the-tool-tip-control.md @@ -3,10 +3,12 @@ description: "Learn more about: Settings for the Tool Tip Control" title: "Settings for the Tool Tip Control" ms.date: "11/04/2016" helpviewer_keywords: ["tool tips [MFC], activating", "CToolTipCtrl class [MFC], settings"] -ms.assetid: ff8c5c46-2047-403a-bd98-ffec3d21ee3a --- # Settings for the Tool Tip Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can set the tool tip control ([CToolTipCtrl](../mfc/reference/ctooltipctrl-class.md)) to be either active or inactive. When you set it to be active, the tool tip control appears when the cursor is on a tool. When you set it to be inactive, the tool tip control does not appear, even if the cursor is on a tool. Call [Activate](../mfc/reference/ctooltipctrl-class.md#activate) to activate or deactivate a tool tip control. You can set an active tool tip to display the tool tip when the cursor is on a tool, whether or not the tool tip control's owner window is active or inactive, by using the TTS_ALWAYSTIP style. If you do not use this style, the tool tip control appears when the tool's owner window is active, but not when it is inactive. diff --git a/docs/mfc/settings-for-the-toolbar-control.md b/docs/mfc/settings-for-the-toolbar-control.md index 5649440229c..91e4a115f28 100644 --- a/docs/mfc/settings-for-the-toolbar-control.md +++ b/docs/mfc/settings-for-the-toolbar-control.md @@ -3,10 +3,12 @@ description: "Learn more about: Settings for the Toolbar Control" title: "Settings for the Toolbar Control" ms.date: "11/04/2016" helpviewer_keywords: ["toolbar controls [MFC], about toolbar controls", "CToolBarCtrl class [MFC], settings"] -ms.assetid: 025ba920-b3ee-4d82-9367-e652cd7875b9 --- # Settings for the Toolbar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The buttons on a toolbar can display a bitmap, a string, or both. By default, the image size is set to the dimensions of 16 by 15 pixels. All buttons are the same width, by default 24 by 22 pixels. A toolbar's height is determined by the height of the buttons, and a toolbar's width is the same as the width of the parent window's client area, also by default. A toolbar can have built-in customization features, including a system-defined customization dialog box, that allow the user to insert, delete, or rearrange toolbar buttons. An application determines whether the customization features are available to the user and controls the extent to which the user can customize the toolbar. For more information about customizing the toolbar, see class [CToolBarCtrl](../mfc/reference/ctoolbarctrl-class.md) in the *MFC Reference*. diff --git a/docs/mfc/simple-data-type-classes.md b/docs/mfc/simple-data-type-classes.md index 4e332b84f9c..d5dbfc4d22f 100644 --- a/docs/mfc/simple-data-type-classes.md +++ b/docs/mfc/simple-data-type-classes.md @@ -4,10 +4,12 @@ title: "Simple Data Type Classes" ms.date: "11/04/2016" f1_keywords: ["vc.classes.data"] helpviewer_keywords: ["scalar classes [MFC]", "data classes [MFC]", "simple data type classes [MFC]"] -ms.assetid: 0d591d68-0a33-49e9-8a6d-90c90de5c16a --- # Simple Data Type Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following classes encapsulate drawing coordinates, character strings, and time and date information, allowing convenient use of C++ syntax. These objects are used widely as parameters to the member functions of Windows classes in the class library. Because `CPoint`, `CSize`, and `CRect` correspond to the **POINT**, **SIZE**, and **RECT** structures, respectively, in the Windows SDK, you can use objects of these C++ classes wherever you can use these C-language structures. The classes provide useful interfaces through their member functions. `CStringT` provides very flexible dynamic character strings. `CTime`, `COleDateTime`, `CTimeSpan`, and `COleTimeSpan` represent time and date values. For more information about these classes, see the article [Date and Time](../atl-mfc-shared/date-and-time.md). The classes that begin with "`COle`" are encapsulations of data types provided by OLE. These data types can be used in Windows programs regardless of whether other OLE features are used. diff --git a/docs/mfc/slider-control-member-functions.md b/docs/mfc/slider-control-member-functions.md index 2e0e2228d90..3bd37f94b77 100644 --- a/docs/mfc/slider-control-member-functions.md +++ b/docs/mfc/slider-control-member-functions.md @@ -3,10 +3,12 @@ description: "Learn more about: Slider Control Member Functions" title: "Slider Control Member Functions" ms.date: "11/04/2016" helpviewer_keywords: ["CSliderCtrl class [MFC], methods", "slider controls [MFC], member functions"] -ms.assetid: dbde49ee-7306-4d14-a6ce-d09aa198178f --- # Slider Control Member Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An application can call the slider control's member functions to retrieve information about the slider control ([CSliderCtrl](../mfc/reference/csliderctrl-class.md)) and to change its characteristics. To retrieve the position of the slider (that is, the value the user has chosen), use the [GetPos](../mfc/reference/csliderctrl-class.md#getpos) member function. To set the position of the slider, use the [SetPos](../mfc/reference/csliderctrl-class.md#setpos) member function. diff --git a/docs/mfc/slider-control-styles.md b/docs/mfc/slider-control-styles.md index b84fb69f468..b779c005ee2 100644 --- a/docs/mfc/slider-control-styles.md +++ b/docs/mfc/slider-control-styles.md @@ -3,10 +3,12 @@ description: "Learn more about: Slider Control Styles" title: "Slider Control Styles" ms.date: "11/04/2016" helpviewer_keywords: ["slider controls [MFC], styles", "CSliderCtrl class [MFC], styles", "styles [MFC], CSliderCtrl", "styles [MFC], slider controls"] -ms.assetid: 64c491fc-5af1-4f97-ae30-854071b3dc02 --- # Slider Control Styles +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Slider controls ([CSliderCtrl](../mfc/reference/csliderctrl-class.md)) can have either a vertical or horizontal orientation. They can have tick marks on either side, both sides, or neither. They can also be used to specify a range of consecutive values. These properties are controlled by using slider control styles, which you specify when you create the slider control. The TBS_HORZ and TBS_VERT styles determine the orientation of the slider control. If you do not specify an orientation, the slider control is oriented horizontally. diff --git a/docs/mfc/slider-notification-messages.md b/docs/mfc/slider-notification-messages.md index 3e750d22cde..da9382e3626 100644 --- a/docs/mfc/slider-notification-messages.md +++ b/docs/mfc/slider-notification-messages.md @@ -3,10 +3,12 @@ description: "Learn more about: Slider Notification Messages" title: "Slider Notification Messages" ms.date: "11/04/2016" helpviewer_keywords: ["CSliderCtrl class [MFC], notifications", "slider controls [MFC], notification messages", "messages, notification", "notifications [MFC], CSliderCtrl"] -ms.assetid: b9121104-3889-4a10-92bf-f3723f1af9d0 --- # Slider Notification Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A slider control notifies its parent window of user actions by sending the parent WM_HSCROLL or WM_VSCROLL messages, depending on the orientation of the slider control. To handle these messages, add handlers for the WM_HSCROLL and WM_VSCROLL messages to the parent window. The [OnHScroll](../mfc/reference/cwnd-class.md#onhscroll) and [OnVScroll](../mfc/reference/cwnd-class.md#onvscroll) member functions will be passed a notification code, the position of the slider, and a pointer to the [CSliderCtrl](../mfc/reference/csliderctrl-class.md) object. Note that the pointer is of type `CScrollBar *` even though it points to a `CSliderCtrl` object. You may need to typecast this pointer if you need to manipulate the slider control. Rather than using the scroll bar notification codes, slider controls send a different set of notification codes. A slider control sends the TB_BOTTOM, TB_LINEDOWN, TB_LINEUP, and TB_TOP notification codes only when the user interacts with a slider control by using the keyboard. The TB_THUMBPOSITION and TB_THUMBTRACK notification messages are only sent when the user is using the mouse. The TB_ENDTRACK, TB_PAGEDOWN, and TB_PAGEUP notification codes are sent in both cases. diff --git a/docs/mfc/special-cwinapp-services.md b/docs/mfc/special-cwinapp-services.md index ee7285fee54..e0f956d3860 100644 --- a/docs/mfc/special-cwinapp-services.md +++ b/docs/mfc/special-cwinapp-services.md @@ -4,10 +4,12 @@ title: "Special CWinApp Services" ms.date: "11/04/2016" f1_keywords: ["LoadStdProfileSettings", "EnableShellOpen"] helpviewer_keywords: ["files [MFC], most recently used", "DragAcceptFiles method [MFC]", "MRU lists", "GDI+, initializing for MFC", "GDI+, suppressing background thread [MFC]", "CWinApp class [MFC], shell registration", "application objects [MFC], services", "CWinApp class [MFC], initializing GDI+", "MFC, shell registration", "CWinApp class [MFC], File Manager drag and drop", "LoadStdProfileSettings method [MFC]", "MFC, most-recently-used file list", "RegisterShellFileTypes method [MFC]", "drag and drop [MFC], files", "registering file types", "Shell, registering file types", "services, provided by CWinApp", "CWinApp class [MFC], recently used documents", "CWinApp class [MFC], services", "files [MFC], drag and drop", "EnableShellOpen method [MFC]", "registry [MFC], most recently used files", "MFC, file operations", "registration [MFC], shell"] -ms.assetid: 0480cd01-f629-4249-b221-93432d95b431 --- # Special CWinApp Services +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Besides running the message loop and giving you an opportunity to initialize the application and clean up after it, [CWinApp](../mfc/reference/cwinapp-class.md) provides several other services. ## Shell Registration diff --git a/docs/mfc/specifying-levels-of-functionality.md b/docs/mfc/specifying-levels-of-functionality.md index cfaa99c8a47..5c5b2617a16 100644 --- a/docs/mfc/specifying-levels-of-functionality.md +++ b/docs/mfc/specifying-levels-of-functionality.md @@ -3,11 +3,13 @@ description: "Learn more about: Specifying Levels of Functionality" title: "Specifying Levels of Functionality" ms.date: "11/06/2018" helpviewer_keywords: ["CObject class [MFC], adding functionality to derived classes", "runtime [MFC], class information", "serialization [MFC], Cobject", "dynamic creation support", "levels [MFC], functionality in CObject", "run-time class [MFC], information support", "levels [MFC]"] -ms.assetid: 562669ba-c858-4f66-b5f1-b3beeea4f486 ms.topic: how-to --- # Specifying Levels of Functionality +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes how to add the following levels of functionality to your [CObject](../mfc/reference/cobject-class.md)-derived class: - Run-time class information diff --git a/docs/mfc/spin-button-member-functions.md b/docs/mfc/spin-button-member-functions.md index 9c2b9529356..5346069e91c 100644 --- a/docs/mfc/spin-button-member-functions.md +++ b/docs/mfc/spin-button-member-functions.md @@ -3,10 +3,12 @@ description: "Learn more about: Spin Button Member Functions" title: "Spin Button Member Functions" ms.date: "11/04/2016" helpviewer_keywords: ["spin button control, methods", "CSpinButtonCtrl class [MFC], methods"] -ms.assetid: a08a26fd-b803-4cbe-a509-395fa357d057 --- # Spin Button Member Functions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + There are several member functions available for the spin control ([CSpinButtonCtrl](../mfc/reference/cspinbuttonctrl-class.md)). Use these functions to change the following attributes of the spin button. - **Acceleration** You can adjust the rate at which the position changes when the user holds down the arrow button. To work with acceleration, use the [SetAccel](../mfc/reference/cspinbuttonctrl-class.md#setaccel) and [GetAccel](../mfc/reference/cspinbuttonctrl-class.md#getaccel) member functions. diff --git a/docs/mfc/spin-button-styles.md b/docs/mfc/spin-button-styles.md index aaa73fe9d2f..4abc91b2123 100644 --- a/docs/mfc/spin-button-styles.md +++ b/docs/mfc/spin-button-styles.md @@ -3,10 +3,12 @@ description: "Learn more about: Spin Button Styles" title: "Spin Button Styles" ms.date: "09/09/2019" helpviewer_keywords: ["styles [MFC], CSpinButtonCtrl", "CSpinButtonCtrl class [MFC], styles", "styles [MFC], spin button control", "spin button control, styles"] -ms.assetid: fb4a7f6f-9182-47be-bccf-0728fdc5332f --- # Spin Button Styles +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Many of the settings for a spin button ([CSpinButtonCtrl](../mfc/reference/cspinbuttonctrl-class.md)) are controlled by styles. You can set the following styles using the [Class Wizard](reference/mfc-class-wizard.md). - **Orientation** Either Vertical or Horizontal. Controls the orientation of the arrow buttons. Associated with the UDS_HORZ style. diff --git a/docs/mfc/standard-commands.md b/docs/mfc/standard-commands.md index 116be5bb811..6c1c07c796f 100644 --- a/docs/mfc/standard-commands.md +++ b/docs/mfc/standard-commands.md @@ -3,10 +3,12 @@ description: "Learn more about: Standard Commands" title: "Standard Commands" ms.date: "11/04/2016" helpviewer_keywords: ["File menu", "identifiers [MFC], command IDs", "command IDs, standard commands", "OLE commands", "commands [MFC], standard", "standard command IDs", "Window menu commands", "standard commands", "View menu commands", "Edit menu standard commands", "Help [MFC], menus", "programmer-defined IDs [MFC]"] -ms.assetid: 88cf3ab4-79b3-4ac6-9365-8ac561036fbf --- # Standard commands +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The framework defines many standard command messages. The IDs for these commands typically take the form **`ID__`**, where `` is usually a menu name and `` is a menu item. For example, the command ID for the **New** command on the **File** menu is `ID_FILE_NEW`. Standard command IDs are shown in bold type in the documentation. Programmer-defined IDs are shown in a font that's different from the surrounding text. The following list shows some of the most important commands supported: diff --git a/docs/mfc/status-bar-implementation-in-mfc.md b/docs/mfc/status-bar-implementation-in-mfc.md index 6ddeb263c87..343121838b1 100644 --- a/docs/mfc/status-bar-implementation-in-mfc.md +++ b/docs/mfc/status-bar-implementation-in-mfc.md @@ -4,10 +4,12 @@ title: "Status Bar Implementation in MFC" ms.date: "11/19/2018" f1_keywords: ["COldStatusBar"] helpviewer_keywords: ["status bars [MFC], implementing in MFC", "CStatusBarCtrl class [MFC], and MFC status bars", "CStatusBar class [MFC], and CStatusBarCtrl class [MFC]", "CStatusBarCtrl class [MFC], and CStatusBar class [MFC]", "status bars [MFC], backward compatibility", "status bars [MFC], old with COldStatusBar class [MFC]", "COldStatusBar class [MFC]", "status bars [MFC], and CStatusBarCtrl class", "CStatusBar class [MFC], and MFC status bars", "status indicators", "status bars [MFC], Windows 95 implementation"] -ms.assetid: be5cd876-38e3-4d5c-b8cb-16d57a16a142 --- # Status Bar Implementation in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A [CStatusBar](../mfc/reference/cstatusbar-class.md) object is a control bar with a row of text output panes. The output panes are commonly used as message lines and as status indicators. Examples include the menu help-message lines that briefly explain the selected menu command and the indicators that show the status of the SCROLL LOCK, NUM LOCK, and other keys. As of MFC version 4.0, status bars are implemented using class [CStatusBarCtrl](../mfc/reference/cstatusbarctrl-class.md), which encapsulates a status bar common control. For backward compatibility, MFC retains the older status bar implementation in class `COldStatusBar`. The documentation for earlier versions of MFC describes `COldStatusBar` under `CStatusBar`. diff --git a/docs/mfc/status-bars.md b/docs/mfc/status-bars.md index d780d9410ee..29ff0152e63 100644 --- a/docs/mfc/status-bars.md +++ b/docs/mfc/status-bars.md @@ -3,10 +3,12 @@ description: "Learn more about: Status Bars" title: "Status Bars" ms.date: "11/04/2016" helpviewer_keywords: ["status bars", "control bars [MFC], status bar"] -ms.assetid: fcbc5029-1aab-4e14-adf7-419038a4935e --- # Status Bars +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Status bars give your application a place to display messages and useful information to the user without interrupting the user's work. Typically displayed at the bottom of a window, status bars have "panes," which include "indicators" and a "message line." The indicators give the status of such things as SCROLL LOCK, whether macro recording is turned on, and so on. The message line on the status bar can display information about program status or about a toolbar button or menu item that the user is pointing to with the mouse. Create a status bar in your program by selecting the **Initial Status Bar** option in the MFC Application Wizard. diff --git a/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md b/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md index fe0603edff7..e6f3ca36d29 100644 --- a/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md +++ b/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md @@ -3,11 +3,13 @@ description: "Learn more about: Steps in a Typical FTP Client Application to Del title: "Steps in a Typical FTP Client Application to Delete a File" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], FTP delete", "WinInet classes [MFC], FTP", "FTP (File Transfer Protocol) [MFC], client applications", "Internet applications [MFC], FTP client applications"] -ms.assetid: 2c347a96-c0a4-4827-98fe-668406e552bc ms.topic: how-to --- # Steps in a Typical FTP Client Application to Delete a File +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table shows the steps you might perform in a typical FTP client application that deletes a file. |Your goal|Actions you take|Effects| diff --git a/docs/mfc/steps-in-a-typical-ftp-client-application.md b/docs/mfc/steps-in-a-typical-ftp-client-application.md index c1d16114ffe..b1b865a3ea1 100644 --- a/docs/mfc/steps-in-a-typical-ftp-client-application.md +++ b/docs/mfc/steps-in-a-typical-ftp-client-application.md @@ -3,11 +3,13 @@ description: "Learn more about: Steps in a Typical FTP Client Application" title: "Steps in a Typical FTP Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], FTP table", "FTP (File Transfer Protocol)", "WinInet classes [MFC], FTP", "FTP (File Transfer Protocol) [MFC], client applications", "Internet applications [MFC], FTP client applications"] -ms.assetid: 70bed7b5-6040-40d1-bc77-702e63a698f2 ms.topic: how-to --- # Steps in a Typical FTP Client Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A typical FTP client application creates a [CInternetSession](../mfc/reference/cinternetsession-class.md) and a [CFtpConnection](../mfc/reference/cftpconnection-class.md) object. Note that these MFC WinInet classes do not actually control the proxy type settings; IIS does. The following table shows the steps you might perform in a typical FTP client application. diff --git a/docs/mfc/steps-in-a-typical-gopher-client-application.md b/docs/mfc/steps-in-a-typical-gopher-client-application.md index 4468557ab4d..8e6d6c44703 100644 --- a/docs/mfc/steps-in-a-typical-gopher-client-application.md +++ b/docs/mfc/steps-in-a-typical-gopher-client-application.md @@ -3,11 +3,13 @@ description: "Learn more about: Steps in a Typical Gopher Client Application" title: "Steps in a Typical Gopher Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["WinInet classes [MFC], gopher", "Internet applications [MFC], gopher client applications", "Gopher client applications [MFC]", "Internet client applications [MFC], gopher table"] -ms.assetid: 3e4e1869-5da0-453d-8ba9-b648c894bb90 ms.topic: how-to --- # Steps in a Typical Gopher Client Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table shows the steps you might perform in a typical gopher client application. |Your goal|Actions you take|Effects| diff --git a/docs/mfc/steps-in-a-typical-http-client-application.md b/docs/mfc/steps-in-a-typical-http-client-application.md index fa830ffcdb9..59dd59a7cb3 100644 --- a/docs/mfc/steps-in-a-typical-http-client-application.md +++ b/docs/mfc/steps-in-a-typical-http-client-application.md @@ -3,11 +3,13 @@ description: "Learn more about: Steps in a Typical HTTP Client Application" title: "Steps in a Typical HTTP Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["HTTP client applications [MFC]", "client applications [MFC], HTTP", "Internet applications [MFC], HTTP client applications", "applications [MFC], HTTP client", "Internet client applications [MFC], HTTP table", "WinInet classes [MFC], HTTP"] -ms.assetid: f86552e8-8acd-4b23-bdc5-0c3a247ebd74 ms.topic: how-to --- # Steps in a Typical HTTP Client Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table shows the steps you might perform in a typical HTTP client application: |Your goal|Actions you take|Effects| diff --git a/docs/mfc/steps-in-a-typical-internet-client-application.md b/docs/mfc/steps-in-a-typical-internet-client-application.md index 24f95bcbc51..4f1851ddc27 100644 --- a/docs/mfc/steps-in-a-typical-internet-client-application.md +++ b/docs/mfc/steps-in-a-typical-internet-client-application.md @@ -3,11 +3,13 @@ description: "Learn more about: Steps in a Typical Internet Client Application" title: "Steps in a Typical Internet Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], general table", "WinInet classes [MFC], programming", "Internet applications [MFC], client applications"] -ms.assetid: 7aba135c-7c15-4e2f-8c34-bbaf792c89a6 ms.topic: how-to --- # Steps in a Typical Internet Client Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The following table shows the steps you might perform in a typical Internet client application. |Your goal|Actions you take|Effects| diff --git a/docs/mfc/storing-and-loading-cobjects-via-an-archive.md b/docs/mfc/storing-and-loading-cobjects-via-an-archive.md index f08ce386eab..145b8d1f840 100644 --- a/docs/mfc/storing-and-loading-cobjects-via-an-archive.md +++ b/docs/mfc/storing-and-loading-cobjects-via-an-archive.md @@ -3,11 +3,13 @@ description: "Learn more about: Storing and Loading CObjects via an Archive" title: "Storing and Loading CObjects via an Archive" ms.date: "11/04/2016" helpviewer_keywords: ["CObjects [MFC], loading through archives", "CArchive class [MFC], storing and loading objects", "Serialize method, vs. CArchive operators", "CObject class [MFC], CArchive objects", "CObjects [MFC]"] -ms.assetid: a829b6dd-bc31-47e0-8108-fbb946722db9 ms.topic: concept-article --- # Storing and Loading CObjects via an Archive +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Storing and loading `CObject`s via an archive requires extra consideration. In certain cases, you should call the `Serialize` function of the object, where the `CArchive` object is a parameter of the `Serialize` call, as opposed to using the **<\<** or **>>** operator of the `CArchive`. The important fact to keep in mind is that the `CArchive` **>>** operator constructs the `CObject` in memory based on `CRuntimeClass` information previously written to the file by the storing archive. Therefore, whether you use the `CArchive` **<\<** and **>>** operators, versus calling `Serialize`, depends on whether you *need* the loading archive to dynamically reconstruct the object based on previously stored `CRuntimeClass` information. Use the `Serialize` function in the following cases: diff --git a/docs/mfc/stream-operations-in-rich-edit-controls.md b/docs/mfc/stream-operations-in-rich-edit-controls.md index 81ae2c76cec..04f1e5d277c 100644 --- a/docs/mfc/stream-operations-in-rich-edit-controls.md +++ b/docs/mfc/stream-operations-in-rich-edit-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Stream Operations in Rich Edit Controls" title: "Stream Operations in Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CRichEditCtrl class [MFC], stream operations", "CRichEditCtrl class [MFC], stream storage", "rich edit controls [MFC], stream operations", "storage, stream in CRichEditCtrl", "stream operations in CRichEditCtrl", "stream storage and CRichEditCtrl"] -ms.assetid: 110b4684-1e76-4ca6-9ef0-5bc8b2d93c78 --- # Stream Operations in Rich Edit Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use streams to transfer data into or out of a rich edit control ([CRichEditCtrl](../mfc/reference/cricheditctrl-class.md)). A stream is defined by an [EDITSTREAM](/windows/win32/api/richedit/ns-richedit-editstream) structure, which specifies a buffer and an application-defined callback function. To read data into a rich edit control (that is, stream the data in), use the [StreamIn](../mfc/reference/cricheditctrl-class.md#streamin) member function. The control repeatedly calls the application-defined callback function, which transfers a portion of the data into the buffer each time. diff --git a/docs/mfc/styles-for-the-progress-control.md b/docs/mfc/styles-for-the-progress-control.md index 2fe586be746..9a43e2cb16d 100644 --- a/docs/mfc/styles-for-the-progress-control.md +++ b/docs/mfc/styles-for-the-progress-control.md @@ -3,10 +3,12 @@ description: "Learn more about: Styles for the Progress Control" title: "Styles for the Progress Control" ms.date: "11/19/2018" helpviewer_keywords: ["PBS_SMOOTH style", "progress controls [MFC], styles", "PBS_VERTICAL style", "CProgressCtrl class [MFC], styles"] -ms.assetid: 39eb8081-bc20-4552-91b9-e7cdd1b7d8ae --- # Styles for the Progress Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you initially create the progress control ([CProgressCtrl::Create](../mfc/reference/cprogressctrl-class.md#create)), use the *dwStyle* parameter to specify the desired window styles for your progress control. The following list details the applicable window styles. The control ignores any window style other than the ones listed here. You should always create the control as a child window, usually of a dialog box parent. |Window style|Effect| diff --git a/docs/mfc/support-for-activation-contexts-in-the-mfc-module-state.md b/docs/mfc/support-for-activation-contexts-in-the-mfc-module-state.md index 38bebdec767..b4a07738a52 100644 --- a/docs/mfc/support-for-activation-contexts-in-the-mfc-module-state.md +++ b/docs/mfc/support-for-activation-contexts-in-the-mfc-module-state.md @@ -3,10 +3,12 @@ description: "Learn more about: Support for Activation Contexts in the MFC Modul title: "Support for Activation Contexts in the MFC Module State" ms.date: "11/04/2016" helpviewer_keywords: ["activation contexts [MFC]", "activation contexts [MFC], MFC support"] -ms.assetid: 1e49eea9-3620-46dd-bc5f-d664749567c7 --- # Support for Activation Contexts in the MFC Module State +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC creates an activation context using a manifest resource provided by the user module. For more information on how activation contexts are created, see the following topics: - [Activation Contexts](/windows/win32/SbsCs/activation-contexts) diff --git a/docs/mfc/tab-controls-and-property-sheets.md b/docs/mfc/tab-controls-and-property-sheets.md index 594015025ce..adcb8c11d50 100644 --- a/docs/mfc/tab-controls-and-property-sheets.md +++ b/docs/mfc/tab-controls-and-property-sheets.md @@ -3,10 +3,12 @@ description: "Learn more about: Tab Controls and Property Sheets" title: "Tab Controls and Property Sheets" ms.date: "11/04/2016" helpviewer_keywords: ["property sheets, tab controls", "tab controls [MFC], and property sheets", "CTabCtrl class [MFC], and property sheets"] -ms.assetid: f3b87bea-9ad9-41e6-a7ff-a9285308267e --- # Tab Controls and Property Sheets +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Property sheets are multiple-page dialogs or "tab dialogs" that can display up to 24 dialog template resources to the user. For examples of property sheets, see the Windows Display Properties dialog box or the following MFC sample application: [CMNCTRL1: Demonstrates Common Control Classes, Part 1](../overview/visual-cpp-samples.md) diff --git a/docs/mfc/tabs-and-tab-control-attributes.md b/docs/mfc/tabs-and-tab-control-attributes.md index 61dcc0d87b4..02ea18ccdc2 100644 --- a/docs/mfc/tabs-and-tab-control-attributes.md +++ b/docs/mfc/tabs-and-tab-control-attributes.md @@ -3,10 +3,12 @@ description: "Learn more about: Tabs and Tab Control Attributes" title: "Tabs and Tab Control Attributes" ms.date: "11/04/2016" helpviewer_keywords: ["attributes [MFC], reference topics", "tab controls [MFC], attributes", "tabs [MFC]", "tabs [MFC], attributes", "CTabCtrl class [MFC], tab control attributes"] -ms.assetid: ecf190cb-f323-4751-bfdb-766dbe6bb553 --- # Tabs and Tab Control Attributes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You have considerable control over the appearance and behavior of tabs that make up a tab control ([CTabCtrl](../mfc/reference/ctabctrl-class.md)). Each tab can have a label, an icon, an item state, and an application-defined 32-bit value associated with it. For each tab, you can display the icon, the label, or both. In addition, each tab item can have three possible states: pressed, unpressed, or highlighted. This state can only be set by modifying an existing tab item. To modify an existing tab item, retrieve it with a call to [GetItem](../mfc/reference/ctabctrl-class.md#getitem), modify the `TCITEM` structure (specifically the *dwState* and *dwStateMask* data members), and then return the modified `TCITEM` structure with a call to [SetItem](../mfc/reference/ctabctrl-class.md#setitem). If you need to clear the item states of all the tab items in a `CTabCtrl` object, make a call to [DeselectAll](../mfc/reference/ctabctrl-class.md#deselectall). This function resets the state of all tab items or all items except the one currently selected. diff --git a/docs/mfc/technical-notes-by-category.md b/docs/mfc/technical-notes-by-category.md index 288094ac3af..7128376cfaa 100644 --- a/docs/mfc/technical-notes-by-category.md +++ b/docs/mfc/technical-notes-by-category.md @@ -2,10 +2,12 @@ description: "Learn more about: Technical Notes by Category" title: "Technical Notes by Category" ms.date: "11/04/2016" -ms.assetid: b9f1c953-233d-4d64-9e8e-ca69b79460b8 --- # Technical Notes by Category +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Technical notes are divided into the following categories. For a numerical listing of the technical notes, see [Technical Notes by Number](../mfc/technical-notes-by-number.md). ### MFC and Windows diff --git a/docs/mfc/technical-notes-by-number.md b/docs/mfc/technical-notes-by-number.md index d07d4b3b3bd..ce0f9032bba 100644 --- a/docs/mfc/technical-notes-by-number.md +++ b/docs/mfc/technical-notes-by-number.md @@ -3,10 +3,12 @@ description: "Learn more about: Technical Notes by Number" title: "Technical Notes by Number" ms.date: "11/04/2016" f1_keywords: ["vc.tables.mfc.technotes"] -ms.assetid: aaa449be-9167-4510-a490-af872c4f60a2 --- # Technical Notes by Number +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The technical notes below are listed numerically, with the most recently written technical note first. For a listing by category, see [Technical Notes by Category](../mfc/technical-notes-by-category.md). |Number|Title| diff --git a/docs/mfc/template-based-classes.md b/docs/mfc/template-based-classes.md index b60a54b82a6..c15c730b488 100644 --- a/docs/mfc/template-based-classes.md +++ b/docs/mfc/template-based-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Template-Based Classes" title: "Template-Based Classes" ms.date: "11/04/2016" helpviewer_keywords: ["type-safe collections", "CTypedPtrList class [MFC], template-based classes", "arrays [MFC], classes", "arrays [MFC], pointers", "typed pointers, collections of", "arrays [MFC], template-based", "CArray class [MFC], template-based classes", "simple template-based collections", "simple array collection classes [MFC]", "typed pointers", "collections, typed-pointer", "CList class [MFC], template-based classes", "collection classes [MFC], template-based", "CTypedPtrMap class [MFC], template-based classes", "pointers, collections of typed", "CTypedPtrArray class [MFC], template-based classes", "MFC collection classes [MFC], template-based", "template-based collection classes [MFC]", "simple list collection classes [MFC]"] -ms.assetid: c69fc95b-c8f6-4a99-abed-517c9898ef0c --- # Template-Based Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the type-safe template-based collection classes in MFC version 3.0 and later. Using these templates to create type-safe collections is more convenient and helps provide type safety more effectively than using the collection classes not based on templates. MFC predefines two categories of template-based collections: diff --git a/docs/mfc/template-classes-for-arrays-lists-and-maps.md b/docs/mfc/template-classes-for-arrays-lists-and-maps.md index adf320b1c3e..f76f823414c 100644 --- a/docs/mfc/template-classes-for-arrays-lists-and-maps.md +++ b/docs/mfc/template-classes-for-arrays-lists-and-maps.md @@ -4,10 +4,12 @@ title: "Template Classes for Arrays, Lists, and Maps" ms.date: "11/04/2016" f1_keywords: ["vc.classes.template"] helpviewer_keywords: ["arrays [MFC], classes", "template classes [MFC], for arrays/lists and maps", "list classes [MFC]", "map classes [MFC]", "template classes [MFC]"] -ms.assetid: a8331c4b-068a-48f8-a629-b8449601e121 --- # Template Classes for Arrays, Lists, and Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + These collection classes are templates whose parameters determine the types of the objects stored in the aggregates. The `CArray`, `CMap`, and `CList` classes use global helper functions that must usually be customized. For more information about these helper functions, see [Collection Class Helpers](../mfc/reference/collection-class-helpers.md). The typed pointer classes are wrappers for other classes in the class library. By using these wrappers, you enlist the compiler's type-checking to help you avoid errors. For more information on using these classes, see [Collections](../mfc/collections.md). These classes provide templates you can use to create arrays, lists, and maps using any type you like. diff --git a/docs/mfc/testing-internet-applications.md b/docs/mfc/testing-internet-applications.md index 40e53d914f6..cee0b483a39 100644 --- a/docs/mfc/testing-internet-applications.md +++ b/docs/mfc/testing-internet-applications.md @@ -3,11 +3,13 @@ description: "Learn more about: Testing Internet Applications" title: "Testing Internet Applications" ms.date: "11/04/2016" helpviewer_keywords: ["Web applications [MFC], testing", "debugging Web applications [MFC], testing applications", "testing [MFC], Internet applications", "debugging [MFC], Web applications", "Internet debugging and testing"] -ms.assetid: ac4c74e3-d4ad-4e19-8f6c-e270de067f01 ms.topic: concept-article --- # Testing Internet Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + There are some unique testing challenges on the Internet, especially for applications running on a Web server. Your initial testing will probably be done using a single-user client connecting to a test server. This will be useful for debugging your code. You will also want to test under real conditions: with multiple clients connected over high-speed connections as well as low-speed serial lines, including modem connections. It can be difficult to simulate real conditions, but it is certainly worth spending time designing possible scenarios and executing them. If possible, you will also want to use tools to do capacity and stress testing. Certain classes of bugs, such as timing bugs, are difficult to find and to reproduce. diff --git a/docs/mfc/testing-properties-and-events-with-test-container.md b/docs/mfc/testing-properties-and-events-with-test-container.md index d7258a77d5c..e6d18116671 100644 --- a/docs/mfc/testing-properties-and-events-with-test-container.md +++ b/docs/mfc/testing-properties-and-events-with-test-container.md @@ -7,6 +7,9 @@ ms.topic: how-to --- # Testing Properties and Events with Test Container +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Test Container application, shipped in Visual C++, is an ActiveX control container for testing and debugging ActiveX controls. Test Container allows the control developer to test the control's functionality by changing its properties, invoking its methods, and firing its events. Test Container can display logs of data-binding notifications and also provides facilities for testing an ActiveX control's persistence functionality: you can save properties to a stream or to substorage, reload them, and examine the stored stream data. This section describes how to use the basic features of Test Container. For additional information, select the **Help** menu while running Test Container. ### To access the ActiveX Control Test Container diff --git a/docs/mfc/the-ccmdui-class.md b/docs/mfc/the-ccmdui-class.md index 7b932b51d26..4769f532e4c 100644 --- a/docs/mfc/the-ccmdui-class.md +++ b/docs/mfc/the-ccmdui-class.md @@ -3,10 +3,12 @@ description: "Learn more about: The CCmdUI Class" title: "The CCmdUI Class" ms.date: "11/04/2016" helpviewer_keywords: ["updating user interface objects [MFC]", "user interface objects [MFC], updating", "CCmdUI class [MFC], menu updating", "update handlers [MFC]", "toolbars [MFC], updating"] -ms.assetid: 2f2bae62-8c29-45a4-bbce-490eb01907d5 --- # The CCmdUI Class +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When it routes an update command to its handler, the framework passes the handler a pointer to a `CCmdUI` object (or to an object of a `CCmdUI`-derived class). This object represents the menu item or toolbar button or other user-interface object that generated the command. The update handler calls member functions of the `CCmdUI` structure through the pointer to update the user-interface object. For example, here is an update handler for the Clear All menu item: [!code-cpp[NVC_MFCDocView#3](../mfc/codesnippet/cpp/the-ccmdui-class_1.cpp)] diff --git a/docs/mfc/thread-specific-hot-keys.md b/docs/mfc/thread-specific-hot-keys.md index cf9bd0c9221..bb3eddc5a5c 100644 --- a/docs/mfc/thread-specific-hot-keys.md +++ b/docs/mfc/thread-specific-hot-keys.md @@ -3,10 +3,12 @@ description: "Learn more about: Thread-Specific Hot Keys" title: "Thread-Specific Hot Keys" ms.date: "11/04/2016" helpviewer_keywords: ["CHotKeyCtrl class [MFC], thread-specific hot keys", "keyboard shortcuts [MFC], hot keys", "threading [MFC], hot keys in CHotKeyCtrl", "access keys [MFC], hot keys"] -ms.assetid: b6021274-1498-483f-bcbf-ba5723547cc8 --- # Thread-Specific Hot Keys +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An application sets a thread-specific hot key ([CHotKeyCtrl](../mfc/reference/chotkeyctrl-class.md)) by using the Windows `RegisterHotKey` function. When the user presses a thread-specific hot key, Windows posts a [WM_HOTKEY](/windows/win32/inputdev/wm-hotkey) message to the beginning of a particular thread's message queue. The WM_HOTKEY message contains the virtual key code, shift state, and user-defined ID of the specific hot key that was pressed. For a list of standard virtual key codes, see Winuser.h. For more information on this method, see [RegisterHotKey](/windows/win32/api/winuser/nf-winuser-registerhotkey). Note that the shift state flags used in the call to `RegisterHotKey` are not the same as those returned by the [GetHotKey](../mfc/reference/chotkeyctrl-class.md#gethotkey) member function; you'll have to translate these flags before calling `RegisterHotKey`. diff --git a/docs/mfc/tn001-window-class-registration.md b/docs/mfc/tn001-window-class-registration.md index 9a528229abf..df44ee16549 100644 --- a/docs/mfc/tn001-window-class-registration.md +++ b/docs/mfc/tn001-window-class-registration.md @@ -4,10 +4,12 @@ title: "TN001: Window Class Registration" ms.date: "11/04/2016" f1_keywords: ["vc.registration"] helpviewer_keywords: ["TN001", "WNDCLASS [MFC]", "AfxRegisterClass function"] -ms.assetid: 1abf678e-f220-4606-85e0-03df32f64c54 --- # TN001: Window Class Registration +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the MFC routines that register the special [WNDCLASS](/windows/win32/api/winuser/ns-winuser-wndclassw)es needed by Microsoft Windows. Specific `WNDCLASS` attributes used by MFC and Windows are discussed. ## The Problem diff --git a/docs/mfc/tn002-persistent-object-data-format.md b/docs/mfc/tn002-persistent-object-data-format.md index 46c468bb74b..710322980dc 100644 --- a/docs/mfc/tn002-persistent-object-data-format.md +++ b/docs/mfc/tn002-persistent-object-data-format.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["VERSIONABLE_SCHEMA macro [MFC]", "persistent object data" --- # TN002: Persistent Object Data Format +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the MFC routines that support persistent C++ objects and the format of the object data when it is stored in a file. This applies only to classes with the [DECLARE_SERIAL](../mfc/reference/run-time-object-model-services.md#declare_serial) and [IMPLEMENT_SERIAL](../mfc/reference/run-time-object-model-services.md#implement_serial) macros. ## The Problem diff --git a/docs/mfc/tn003-mapping-of-windows-handles-to-objects.md b/docs/mfc/tn003-mapping-of-windows-handles-to-objects.md index aae3e6e82cb..b7b4f207886 100644 --- a/docs/mfc/tn003-mapping-of-windows-handles-to-objects.md +++ b/docs/mfc/tn003-mapping-of-windows-handles-to-objects.md @@ -4,10 +4,12 @@ title: "TN003: Mapping of Windows Handles to Objects" ms.date: "11/04/2016" f1_keywords: ["vc.mapping"] helpviewer_keywords: ["TN003", "handle maps", "Windows handles to objects [MFC]", "mappings [MFC], Windows handles to objects"] -ms.assetid: fbea9f38-992c-4091-8dbc-f29e288617d6 --- # TN003: Mapping of Windows Handles to Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the MFC routines that support mapping Windows object handles to C++ objects. ## The Problem diff --git a/docs/mfc/tn006-message-maps.md b/docs/mfc/tn006-message-maps.md index 4c24ca0197d..41ac839b2e1 100644 --- a/docs/mfc/tn006-message-maps.md +++ b/docs/mfc/tn006-message-maps.md @@ -4,10 +4,12 @@ title: "TN006: Message Maps" ms.date: "06/25/2018" f1_keywords: ["vc.messages.maps"] helpviewer_keywords: ["ON_UPDATE_COMMAND_UI macro [MFC]", "ON_NOTIFY_RANGE macro [MFC]", "ON_COMMAND macro [MFC]", "ON_CONTROL_RANGE macro [MFC]", "ON_REGISTERED_MESSAGE macro [MFC]", "ON_NOTIFY message [MFC]", "ON_COMMAND_RANGE_EX macro [MFC]", "ON_MESSAGE macro [MFC]", "Windows messages [MFC], message maps", "ON_COMMAND_RANGE macro [MFC]", "TN006", "ON_CONTROL macro [MFC]", "ON_COMMAND_EX macro [MFC]", "message maps [MFC], Windows messaging"] -ms.assetid: af4b6794-4b40-4f1e-ad41-603c3b7409bb --- # TN006: Message Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the MFC message map facility. ## The Problem diff --git a/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md b/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md index d46e12b6e97..bc0600b0c0b 100644 --- a/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md +++ b/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md @@ -3,10 +3,12 @@ description: "Learn more about: TN011: Using MFC as Part of a DLL" title: "TN011: Using MFC as Part of a DLL" ms.date: "11/04/2016" helpviewer_keywords: ["_USRDLL symbol", "USRDLLs, compiler switches", "TN011", "DLLs [MFC], linking", "MFC DLLs [MFC], linking regular MFC DLLs to MFC"] -ms.assetid: 76753e9c-59dc-40f6-b6a7-f6bb9a7c4190 --- # TN011: Using MFC as Part of a DLL +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes regular MFC DLLs, which allow you to use the MFC library as part of a Windows dynamic-link library (DLL). It assumes that you are familiar with Windows DLLs and how to build them. For information about MFC extension DLLs, with which you can create extensions to the MFC library, see [DLL Version of MFC](../mfc/tn033-dll-version-of-mfc.md). ## DLL Interfaces diff --git a/docs/mfc/tn014-custom-controls.md b/docs/mfc/tn014-custom-controls.md index d6eb5e03e11..f1562fa20f3 100644 --- a/docs/mfc/tn014-custom-controls.md +++ b/docs/mfc/tn014-custom-controls.md @@ -7,6 +7,9 @@ helpviewer_keywords: ["TN014", "custom controls [MFC]"] --- # TN014: Custom Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the MFC Support for custom and self-drawing controls. It also describes dynamic subclassing, and describes the relationship between [CWnd](../mfc/reference/cwnd-class.md) objects and `HWND`s. The MFC sample application CTRLTEST illustrates how to use many custom controls. See the source code for the MFC General sample [CTRLTEST](../overview/visual-cpp-samples.md) and online help. diff --git a/docs/mfc/tn016-using-cpp-multiple-inheritance-with-mfc.md b/docs/mfc/tn016-using-cpp-multiple-inheritance-with-mfc.md index cf44c6bf0ea..fec8f1aa64e 100644 --- a/docs/mfc/tn016-using-cpp-multiple-inheritance-with-mfc.md +++ b/docs/mfc/tn016-using-cpp-multiple-inheritance-with-mfc.md @@ -4,10 +4,12 @@ title: "TN016: Using C++ Multiple Inheritance with MFC" ms.date: "06/28/2018" f1_keywords: ["vc.inheritance"] helpviewer_keywords: ["TN016", "MI (Multiple Inheritance)", "multiple inheritance, MFC support for"] -ms.assetid: 4ee27ae1-1410-43a5-b111-b6af9b84535d --- # TN016: Using C++ Multiple Inheritance with MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes how to use multiple inheritance (MI) with the Microsoft Foundation Classes. The use of MI is not required with MFC. MI is not used in any MFC classes and is not required to write a class library. The following subtopics describe how MI affects the use of common MFC idioms as well as covering some of the restrictions of MI. Some of these restrictions are general C++ restrictions. Others are imposed by the MFC architecture. diff --git a/docs/mfc/tn017-destroying-window-objects.md b/docs/mfc/tn017-destroying-window-objects.md index f50a0b32b71..960374a2479 100644 --- a/docs/mfc/tn017-destroying-window-objects.md +++ b/docs/mfc/tn017-destroying-window-objects.md @@ -4,10 +4,12 @@ title: "TN017: Destroying window objects" ms.date: 06/03/2022 f1_keywords: ["vc.objects"] helpviewer_keywords: ["destroying windows", "TN017", "PostNcDestroy method [MFC]"] -ms.assetid: 5bf208a5-5683-439b-92a1-547c5ded26cd --- # TN017: Destroying window objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the use of the [`CWnd::PostNcDestroy`](../mfc/reference/cwnd-class.md#postncdestroy) method. Use this method if you want to do customized allocation of `CWnd`-derived objects. This note also explains why you should use [`CWnd::DestroyWindow`](../mfc/reference/cwnd-class.md#destroywindow) to destroy a C++ Windows object instead of the **`delete`** operator. If you follow the guidelines in this article, you'll have few cleanup problems. These problems can result from issues such as forgetting to delete/free C++ memory, forgetting to free system resources like `HWND`s, or freeing objects too many times. diff --git a/docs/mfc/tn020-id-naming-and-numbering-conventions.md b/docs/mfc/tn020-id-naming-and-numbering-conventions.md index 96b6e6d29b3..39b718d2625 100644 --- a/docs/mfc/tn020-id-naming-and-numbering-conventions.md +++ b/docs/mfc/tn020-id-naming-and-numbering-conventions.md @@ -4,10 +4,12 @@ title: "TN020: ID Naming and Numbering Conventions" ms.date: "11/04/2016" f1_keywords: ["vc.id"] helpviewer_keywords: ["TN020", "resource identifiers, naming and numbering", "resource identifiers"] -ms.assetid: aecbd2cf-68b3-47f6-ae21-b1f507917245 --- # TN020: ID Naming and Numbering Conventions +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the ID naming and numbering conventions that MFC 2.0 uses for resources, commands, strings, controls, and child windows. The MFC ID naming and numbering conventions are intended to meet the following requirements: diff --git a/docs/mfc/tn021-command-and-message-routing.md b/docs/mfc/tn021-command-and-message-routing.md index 8e2210c3546..1ad354a62dd 100644 --- a/docs/mfc/tn021-command-and-message-routing.md +++ b/docs/mfc/tn021-command-and-message-routing.md @@ -4,10 +4,12 @@ title: "TN021: Command and Message Routing" ms.date: "06/28/2018" f1_keywords: ["vc.routing"] helpviewer_keywords: ["TN021", "command routing [MFC], technical note TN021", "Windows messages [MFC], routing"] -ms.assetid: b5952c8b-123e-406c-a36d-a6ac7c6df307 --- # TN021: Command and Message Routing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn022-standard-commands-implementation.md b/docs/mfc/tn022-standard-commands-implementation.md index b58bce0c1b6..a12033ebd64 100644 --- a/docs/mfc/tn022-standard-commands-implementation.md +++ b/docs/mfc/tn022-standard-commands-implementation.md @@ -4,10 +4,12 @@ title: "TN022: Standard Commands Implementation" ms.date: "11/04/2016" f1_keywords: ["vc.commands"] helpviewer_keywords: ["ID_PREV_PANE command [MFC]", "ID_APP_EXIT command [MFC]", "ID_NEXT_PANE command [MFC]", "ID_INDICATOR_REC command [MFC]", "ID_WINDOW_SPLIT command [MFC]", "ID_FILE_PRINT_PREVIEW command [MFC]", "ID_WINDOW_CASCADE command [MFC]", "ID_FILE_CLOSE command [MFC]", "ID_FILE_SAVE_COPY_AS command [MFC]", "ID_WINDOW_ARRANGE command [MFC]", "ID_EDIT_FIND command [MFC]", "ID_FILE_OPEN command [MFC]", "ID_FILE_PAGE_SETUP command [MFC]", "ID_OLE_VERB_FIRST command [MFC]", "ID_EDIT_UNDO command [MFC]", "ID_EDIT_CLEAR command [MFC]", "ID_INDICATOR_CAPS command [MFC]", "ID_HELP_INDEX command [MFC]", "commands [MFC], standard", "ID_FILE_PRINT_SETUP command [MFC]", "ID_DEFAULT_HELP command [MFC]", "ID_INDICATOR_SCRL command [MFC]", "ID_FILE_PRINT command [MFC]", "ID_INDICATOR_OVR command [MFC]", "ID_INDICATOR_KANA command [MFC]", "ID_EDIT_COPY command [MFC]", "ID_EDIT_REDO command [MFC]", "ID_EDIT_PASTE command [MFC]", "ID_OLE_INSERT_NEW command [MFC]", "ID_OLE_EDIT_LINKS command [MFC]", "ID_EDIT_PASTE_SPECIAL command [MFC]", "ID_INDICATOR_EXT command [MFC]", "ID_HELP_USING command [MFC]", "standard commands", "ID_VIEW_STATUS_BAR command [MFC]", "ID_FILE_SAVE_AS command [MFC]", "ID_EDIT_CLEAR_ALL command [MFC]", "ID_WINDOW_NEW command [MFC]", "ID_CONTEXT_HELP command [MFC]", "ID_EDIT_REPLACE command [MFC]", "ID_WINDOW_TILE_HORZ command [MFC]", "ID_APP_ABOUT command [MFC]", "TN022", "ID_VIEW_TOOLBAR command [MFC]", "ID_HELP command [MFC]", "ID_WINDOW_TILE_VERT command [MFC]", "ID_EDIT_CUT command [MFC]", "ID_FILE_UPDATE command [MFC]", "ID_EDIT_REPEAT command [MFC]", "ID_FILE_SAVE command [MFC]", "ID_EDIT_PASTE_LINK command [MFC]", "ID_EDIT_SELECT_ALL command [MFC]", "ID_FILE_NEW command [MFC]", "ID_INDICATOR_NUM command"] -ms.assetid: a7883b46-23f7-4870-ac3a-804aed9258b5 --- # TN022: Standard Commands Implementation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn023-standard-mfc-resources.md b/docs/mfc/tn023-standard-mfc-resources.md index f0dfaccf661..913e6b22d01 100644 --- a/docs/mfc/tn023-standard-mfc-resources.md +++ b/docs/mfc/tn023-standard-mfc-resources.md @@ -3,10 +3,12 @@ description: "Learn more about: TN023: Standard MFC Resources" title: "TN023: Standard MFC Resources" ms.date: "11/04/2016" helpviewer_keywords: ["resources [MFC]", "TN023", "standard resources"] -ms.assetid: 60af8415-c576-4c2f-a711-ca5da0b9a1f2 --- # TN023: Standard MFC Resources +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the standard resources provided with and needed by the MFC library. ## Standard Resources diff --git a/docs/mfc/tn024-mfc-defined-messages-and-resources.md b/docs/mfc/tn024-mfc-defined-messages-and-resources.md index 4c2ed67fd50..6a18d57ef98 100644 --- a/docs/mfc/tn024-mfc-defined-messages-and-resources.md +++ b/docs/mfc/tn024-mfc-defined-messages-and-resources.md @@ -3,10 +3,12 @@ description: "Learn more about: TN024: MFC-Defined Messages and Resources" title: "TN024: MFC-Defined Messages and Resources" ms.date: "11/04/2016" helpviewer_keywords: ["resources [MFC]", "Windows messages [MFC], MFC-defined", "messages [MFC], MFC", "TN024"] -ms.assetid: c65353ce-8096-454b-ad22-1a7a1dd9a788 --- # TN024: MFC-Defined Messages and Resources +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn025-document-view-and-frame-creation.md b/docs/mfc/tn025-document-view-and-frame-creation.md index a914375e71e..425c5552a97 100644 --- a/docs/mfc/tn025-document-view-and-frame-creation.md +++ b/docs/mfc/tn025-document-view-and-frame-creation.md @@ -4,10 +4,12 @@ title: "TN025: Document, View, and Frame Creation" ms.date: "11/04/2016" f1_keywords: ["vc.creation"] helpviewer_keywords: ["documents [MFC], view and frame creation", "TN025"] -ms.assetid: 09254d72-6e1d-43db-80e9-693887dbeda2 --- # TN025: Document, View, and Frame Creation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn026-ddx-and-ddv-routines.md b/docs/mfc/tn026-ddx-and-ddv-routines.md index 8cfde655e61..0d6e4eb4176 100644 --- a/docs/mfc/tn026-ddx-and-ddv-routines.md +++ b/docs/mfc/tn026-ddx-and-ddv-routines.md @@ -4,10 +4,12 @@ title: "TN026: DDX and DDV Routines" ms.date: "06/28/2018" f1_keywords: ["DDX", "DDV"] helpviewer_keywords: ["DDX (dialog data exchange), procedures", "TN026", "DDV (dialog data validation), procedures"] -ms.assetid: c2eba87a-4b47-4083-b28b-e2fa77dfb4c4 --- # TN026: DDX and DDV Routines +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn028-context-sensitive-help-support.md b/docs/mfc/tn028-context-sensitive-help-support.md index 7b6b5753c5f..b6ae1421563 100644 --- a/docs/mfc/tn028-context-sensitive-help-support.md +++ b/docs/mfc/tn028-context-sensitive-help-support.md @@ -4,10 +4,12 @@ title: "TN028: Context-Sensitive Help Support" ms.date: "11/04/2016" f1_keywords: ["vc.help"] helpviewer_keywords: ["context-sensitive Help [MFC], MFC applications", "TN028", "resource identifiers, context-sensitive Help"] -ms.assetid: 884f1c55-fa27-4d4c-984f-30907d477484 --- # TN028: Context-Sensitive Help Support +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the rules for assigning Help contexts IDs and other help issues in MFC. Context-sensitive help support requires the help compiler that is available in Visual Studio. > [!NOTE] diff --git a/docs/mfc/tn029-splitter-windows.md b/docs/mfc/tn029-splitter-windows.md index 5e0142a3312..4a8d2d983dd 100644 --- a/docs/mfc/tn029-splitter-windows.md +++ b/docs/mfc/tn029-splitter-windows.md @@ -4,10 +4,12 @@ title: "TN029: Splitter Windows" ms.date: "11/04/2016" f1_keywords: ["vc.windows.splitter"] helpviewer_keywords: ["TN029", "splitter windows [MFC], about splitter windows"] -ms.assetid: 2c57ce99-2a3c-4eff-9cea-baccb13af075 --- # TN029: Splitter Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes the MFC [CSplitterWnd Class](../mfc/reference/csplitterwnd-class.md), which provides window splits and manages the resizing of other pane windows. ## Splitter Styles diff --git a/docs/mfc/tn030-customizing-printing-and-print-preview.md b/docs/mfc/tn030-customizing-printing-and-print-preview.md index 851f9d6ad6d..859df12533e 100644 --- a/docs/mfc/tn030-customizing-printing-and-print-preview.md +++ b/docs/mfc/tn030-customizing-printing-and-print-preview.md @@ -4,10 +4,12 @@ title: "TN030: Customizing Printing and Print Preview" ms.date: "06/28/2018" f1_keywords: ["vc.print"] helpviewer_keywords: ["TN030", "customizing printing and print preview", "printing [MFC], views", "printing views [MFC]", "print preview [MFC], customizing"] -ms.assetid: 32744697-c91c-41b6-9a12-b8ec01e0d438 --- # TN030: Customizing Printing and Print Preview +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn031-control-bars.md b/docs/mfc/tn031-control-bars.md index cdd945cff4a..f186f5a4dc3 100644 --- a/docs/mfc/tn031-control-bars.md +++ b/docs/mfc/tn031-control-bars.md @@ -4,10 +4,12 @@ title: "TN031: Control Bars" ms.date: "11/04/2016" f1_keywords: ["vc.controls.bars"] helpviewer_keywords: ["control bars [MFC], styles", "CStatusBar class [MFC], Tech Note 31 usage", "CControlBar class [MFC], Tech Note 31 usage", "CControlBar class [MFC], deriving from", "control bars [MFC], classes [MFC]", "CDialogBar class [MFC], Tech Note 31 usage", "CToolBar class [MFC], Tech Note 31 usage", "TN031", "styles [MFC], control bars"] -ms.assetid: 8cb895c0-40ea-40ef-90ee-1dd29f34cfd1 --- # TN031: Control Bars +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn032-mfc-exception-mechanism.md b/docs/mfc/tn032-mfc-exception-mechanism.md index 37d0ecc454e..37358762f81 100644 --- a/docs/mfc/tn032-mfc-exception-mechanism.md +++ b/docs/mfc/tn032-mfc-exception-mechanism.md @@ -3,10 +3,12 @@ description: "Learn more about: TN032: MFC Exception Mechanism" title: "TN032: MFC Exception Mechanism" ms.date: "11/04/2016" helpviewer_keywords: ["TN032", "MFC, exceptions", "CException class [MFC], using"] -ms.assetid: 0271f0aa-82cb-47a2-b7ea-e88126fc7e43 --- # TN032: MFC Exception Mechanism +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Previous versions of Visual C++ did not support the standard C++ exception mechanism, and MFC provided macros **TRY/CATCH/THROW** that were used instead. This version of Visual C++ fully supports C++ exceptions. This note covered some of the advanced implementation details of the previous macros including how to automatically cleanup stack based objects. Because C++ exceptions support stack unwinding by default, this technical note is no longer necessary. Refer to [Exceptions: Using MFC Macros and C++ Exceptions](../mfc/exceptions-using-mfc-macros-and-cpp-exceptions.md) for more information on the differences between the MFC macros and the new C++ keywords. diff --git a/docs/mfc/tn033-dll-version-of-mfc.md b/docs/mfc/tn033-dll-version-of-mfc.md index b4d84359c16..3db6c4930e0 100644 --- a/docs/mfc/tn033-dll-version-of-mfc.md +++ b/docs/mfc/tn033-dll-version-of-mfc.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["MFC DLLs [MFC], writing MFC extension DLLS", "AFXDLL libr --- # TN033: DLL Version of MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note describes how you can use the *`MFCxx.DLL`* and *`MFCxxD.DLL`* (where *xx* is the MFC version number) shared dynamic link libraries with MFC applications and MFC extension DLLs. For more information about regular MFC DLLs, see [Using MFC as Part of a DLL](../mfc/tn011-using-mfc-as-part-of-a-dll.md). This technical note covers three aspects of DLLs. The last two are for the more advanced users: diff --git a/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md b/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md index 96416abb045..21c577de734 100644 --- a/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md +++ b/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md @@ -4,10 +4,12 @@ title: "TN035: Using multiple resource files and header files with Visual Studio ms.date: "11/04/2016" f1_keywords: ["vc.resources"] helpviewer_keywords: ["resource files, multiple", "TN035"] -ms.assetid: 1f08ce5e-a912-44cc-ac56-7dd93ad73fb6 --- # TN035: Using multiple resource files and header files with Visual Studio +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn036-using-cformview-with-appwizard-and-classwizard.md b/docs/mfc/tn036-using-cformview-with-appwizard-and-classwizard.md index 4d3569e13ae..9e8261d1fbe 100644 --- a/docs/mfc/tn036-using-cformview-with-appwizard-and-classwizard.md +++ b/docs/mfc/tn036-using-cformview-with-appwizard-and-classwizard.md @@ -3,10 +3,12 @@ description: "Learn more about: TN036: Using CFormView with AppWizard and ClassW title: "TN036: Using CFormView with AppWizard and ClassWizard" ms.date: "11/04/2016" helpviewer_keywords: ["TN036"] -ms.assetid: dd54053f-ae80-4d23-9180-c7d07ddf2290 --- # TN036: Using CFormView with AppWizard and ClassWizard +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This technical note described how to modify an AppWizard generated application so that it used a `CFormView` instead of the default `CView` as its main view class. This is supported directly with this version of Visual C++. ## See also diff --git a/docs/mfc/tn037-multithreaded-mfc-2-1-applications.md b/docs/mfc/tn037-multithreaded-mfc-2-1-applications.md index 8b1d54b02af..ac6bb8c4a7e 100644 --- a/docs/mfc/tn037-multithreaded-mfc-2-1-applications.md +++ b/docs/mfc/tn037-multithreaded-mfc-2-1-applications.md @@ -3,10 +3,12 @@ description: "Learn more about: TN037: Multithreaded MFC 2.1 Applications" title: "TN037: Multithreaded MFC 2.1 Applications" ms.date: "11/04/2016" helpviewer_keywords: ["TN037"] -ms.assetid: 05ee204c-700a-4c40-957c-dc2d0db1249d --- # TN037: Multithreaded MFC 2.1 Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This technical note originally described the limitations of multithreaded programs with MFC 2.1, originally provided with Visual C++ 1.0 for Windows NT. MFC 3.0 supports multithreading directly and is documented. See that reference for more information. ## See also diff --git a/docs/mfc/tn038-mfc-ole-iunknown-implementation.md b/docs/mfc/tn038-mfc-ole-iunknown-implementation.md index f9dd6560fb7..5389681a074 100644 --- a/docs/mfc/tn038-mfc-ole-iunknown-implementation.md +++ b/docs/mfc/tn038-mfc-ole-iunknown-implementation.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["aggregation macros [MFC]", "COM interfaces, base interfac --- # TN038: MFC/OLE IUnknown Implementation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn039-mfc-ole-automation-implementation.md b/docs/mfc/tn039-mfc-ole-automation-implementation.md index 9cc0196268e..07218539d2f 100644 --- a/docs/mfc/tn039-mfc-ole-automation-implementation.md +++ b/docs/mfc/tn039-mfc-ole-automation-implementation.md @@ -3,10 +3,12 @@ description: "Learn more about: TN039: MFC/OLE Automation Implementation" title: "TN039: MFC-OLE Automation Implementation" ms.date: "06/28/2018" helpviewer_keywords: ["MFC, COM support", "IDispatch interface", "MFC, OLE DB and", "TN039", "Automation, MFC COM interface entry points"] -ms.assetid: 765fa3e9-dd54-4f08-9ad2-26e0546ff8b6 --- # TN039: MFC/OLE Automation Implementation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn040-mfc-ole-in-place-resizing-and-zooming.md b/docs/mfc/tn040-mfc-ole-in-place-resizing-and-zooming.md index 4feead7b1e8..48d421019bc 100644 --- a/docs/mfc/tn040-mfc-ole-in-place-resizing-and-zooming.md +++ b/docs/mfc/tn040-mfc-ole-in-place-resizing-and-zooming.md @@ -3,10 +3,12 @@ description: "Learn more about: TN040: MFC/OLE In-Place Resizing and Zooming" title: "TN040: MFC-OLE In-Place Resizing and Zooming" ms.date: "11/04/2016" helpviewer_keywords: ["resizing in-place", "TN040", "zooming and in-place activation", "in-place activation, zooming and resizing"] -ms.assetid: 4d7859bd-0b2e-4254-be62-2735cecf02c6 --- # TN040: MFC/OLE In-Place Resizing and Zooming +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md b/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md index 5dbdc995f5f..bb8cdf822ee 100644 --- a/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md +++ b/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md @@ -3,10 +3,12 @@ description: "Learn more about: TN041: MFC/OLE1 Migration to MFC/OLE 2" title: "TN041: MFC-OLE1 Migration to MFC-OLE 2" ms.date: "10/18/2018" helpviewer_keywords: ["OLE1 [MFC]", "migrating OLE1 to OLE2", "migration [MFC], OLE1 to OLE2", "OLE2 [MFC]", "porting OLE1 to OLE2", "converting OLE1 to OLE2", "upgrading Visual C++ applications [MFC], OLE1 to OLE2", "TN041"] -ms.assetid: 67f55552-4b04-4ddf-af0b-4d9eaf5da957 --- # TN041: MFC/OLE1 Migration to MFC/OLE 2 +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn042-odbc-driver-developer-recommendations.md b/docs/mfc/tn042-odbc-driver-developer-recommendations.md index 67507a46417..50e12f2ed4f 100644 --- a/docs/mfc/tn042-odbc-driver-developer-recommendations.md +++ b/docs/mfc/tn042-odbc-driver-developer-recommendations.md @@ -4,10 +4,12 @@ title: "TN042: ODBC Driver Developer Recommendations" ms.date: "11/04/2016" f1_keywords: ["vc.odbc"] helpviewer_keywords: ["ODBC drivers [MFC], writing", "databases [MFC], ODBC", "TN042"] -ms.assetid: ecc6b5d9-f480-4582-9e22-8309fe561dad --- # TN042: ODBC Driver Developer Recommendations +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn043-rfx-routines.md b/docs/mfc/tn043-rfx-routines.md index 9c22c0478d5..9ce9eb78ffb 100644 --- a/docs/mfc/tn043-rfx-routines.md +++ b/docs/mfc/tn043-rfx-routines.md @@ -4,10 +4,12 @@ title: "TN043: RFX Routines" ms.date: "06/28/2018" f1_keywords: ["RFX"] helpviewer_keywords: ["RFX (record field exchange), architecture", "TN043", "RFX (record field exchange)"] -ms.assetid: f552d0c1-2c83-4389-b472-42c9940aa713 --- # TN043: RFX Routines +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn044-mfc-support-for-dbcs.md b/docs/mfc/tn044-mfc-support-for-dbcs.md index d20373e0d56..a49ca84591f 100644 --- a/docs/mfc/tn044-mfc-support-for-dbcs.md +++ b/docs/mfc/tn044-mfc-support-for-dbcs.md @@ -3,10 +3,12 @@ description: "Learn more about: TN044: MFC Support for DBCS" title: "TN044: MFC Support for DBCS" ms.date: "11/04/2016" helpviewer_keywords: ["TN044"] -ms.assetid: 8160bb2a-012d-4c5a-b05c-91ee6d4ca4cb --- # TN044: MFC Support for DBCS +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This technical note described the support in MFC for "double-byte character sets" or DBCS. This information as well as information on MFC's support for UNICODE is now available in the *Class Library Reference*. ## See also diff --git a/docs/mfc/tn045-mfc-database-support-for-long-varchar-varbinary.md b/docs/mfc/tn045-mfc-database-support-for-long-varchar-varbinary.md index 871ed060118..ae8ac6acc8c 100644 --- a/docs/mfc/tn045-mfc-database-support-for-long-varchar-varbinary.md +++ b/docs/mfc/tn045-mfc-database-support-for-long-varchar-varbinary.md @@ -3,10 +3,12 @@ description: "Learn more about: TN045: MFC/Database Support for Long Varchar/Var title: "TN045: MFC-Database Support for Long Varchar-Varbinary" ms.date: "11/04/2016" helpviewer_keywords: ["TN045", "Varbinary data type", "Varchar data type"] -ms.assetid: cf572c35-5275-45b5-83df-5f0e36114f40 --- # TN045: MFC/Database Support for Long Varchar/Varbinary +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn046-commenting-conventions-for-the-mfc-classes.md b/docs/mfc/tn046-commenting-conventions-for-the-mfc-classes.md index 26c2dc119d1..bec24e62f25 100644 --- a/docs/mfc/tn046-commenting-conventions-for-the-mfc-classes.md +++ b/docs/mfc/tn046-commenting-conventions-for-the-mfc-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: TN046: Commenting Conventions for the MFC Classe title: "TN046: Commenting Conventions for the MFC Classes" ms.date: "11/04/2016" helpviewer_keywords: ["TN046"] -ms.assetid: 0d6ff3c9-4a5d-44df-b121-be4b0a649947 --- # TN046: Commenting Conventions for the MFC Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This technical note originally described the conventions used to comment the MFC classes. This information is now covered in [MFC: Using the MFC Source Files](../mfc/using-the-mfc-source-files.md). ## See also From cc9f70910437684f72938a2e10200b5def7cf6ea Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 24 Feb 2026 12:06:15 -0800 Subject: [PATCH 1656/1799] Batch 12: update files (#6266) --- docs/mfc/tn047-relaxing-database-transaction-requirements.md | 4 +++- .../tn048-writing-odbc-setup-and-administration-programs.md | 4 +++- ...n049-mfc-ole-mbcs-to-unicode-translation-layer-mfcans32.md | 4 +++- docs/mfc/tn050-mfc-ole-common-dialogs-mfcuix32.md | 4 +++- docs/mfc/tn051-using-ctl3d-now-and-in-the-future.md | 4 +++- .../mfc/tn053-custom-dfx-routines-for-dao-database-classes.md | 4 +++- .../tn054-calling-dao-directly-while-using-mfc-dao-classes.md | 4 +++- ...mfc-odbc-database-class-applications-to-mfc-dao-classes.md | 4 +++- docs/mfc/tn056-installation-of-localized-mfc-components.md | 4 +++- docs/mfc/tn057-localization-of-mfc-components.md | 4 +++- docs/mfc/tn058-mfc-module-state-implementation.md | 4 +++- docs/mfc/tn059-using-mfc-mbcs-unicode-conversion-macros.md | 4 +++- docs/mfc/tn060-the-new-windows-common-controls.md | 4 +++- docs/mfc/tn061-on-notify-and-wm-notify-messages.md | 4 +++- docs/mfc/tn062-message-reflection-for-windows-controls.md | 4 +++- docs/mfc/tn063-debugging-internet-extension-dlls.md | 4 +++- .../tn064-apartment-model-threading-in-activex-controls.md | 4 +++- ...tn065-dual-interface-support-for-ole-automation-servers.md | 4 +++- docs/mfc/tn066-common-mfc-3-x-to-4-0-porting-issues.md | 4 +++- ...ng-transactions-with-the-microsoft-access-7-odbc-driver.md | 4 +++- docs/mfc/tn070-mfc-window-class-names.md | 4 +++- docs/mfc/tn071-mfc-iolecommandtarget-implementation.md | 4 +++- docs/mfc/tool-tips-in-windows-not-derived-from-cframewnd.md | 4 +++- docs/mfc/tool-tips.md | 4 +++- docs/mfc/toolbar-fundamentals.md | 4 +++- docs/mfc/toolbar-sample-list.md | 4 +++- docs/mfc/toolbar-tool-tips.md | 4 +++- docs/mfc/toolbars.md | 4 +++- docs/mfc/tooltiptext-structure.md | 4 +++- .../trackers-implementing-trackers-in-your-ole-application.md | 4 +++- docs/mfc/trackers.md | 4 +++- docs/mfc/tree-control-drag-and-drop-operations.md | 4 +++- docs/mfc/tree-control-image-lists.md | 4 +++- docs/mfc/tree-control-item-information.md | 4 +++- docs/mfc/tree-control-item-labels.md | 4 +++- docs/mfc/tree-control-item-position.md | 4 +++- docs/mfc/tree-control-item-selection.md | 4 +++- docs/mfc/tree-control-item-states-overview.md | 4 +++- docs/mfc/tree-control-label-editing.md | 4 +++- docs/mfc/tree-control-notification-messages.md | 4 +++- docs/mfc/tree-control-parent-and-child-items.md | 4 +++- docs/mfc/tree-control-styles.md | 4 +++- docs/mfc/turning-off-the-activate-when-visible-option.md | 4 +++- docs/mfc/two-ways-to-create-a-carchive-object.md | 4 +++- docs/mfc/type-safe-access-to-controls-in-a-dialog-box.md | 4 +++- docs/mfc/type-safe-access-to-controls-with-code-wizards.md | 4 +++- docs/mfc/type-safe-access-to-controls-without-code-wizards.md | 4 +++- docs/mfc/types-of-image-lists.md | 4 +++- docs/mfc/updating-the-text-of-a-status-bar-pane.md | 4 +++- docs/mfc/upgrading-an-existing-activex-control.md | 4 +++- docs/mfc/user-defined-tools.md | 4 +++- docs/mfc/user-interface-elements-mfc.md | 4 +++- docs/mfc/user-interface-objects-and-command-ids.md | 4 +++- docs/mfc/using-a-common-control-as-a-child-window.md | 4 +++- docs/mfc/using-a-dialog-bar-with-a-rebar-control.md | 4 +++- docs/mfc/using-a-dialog-template-in-memory.md | 4 +++- docs/mfc/using-a-hot-key-control.md | 4 +++- docs/mfc/using-an-animation-control.md | 4 +++- docs/mfc/using-an-image-list-with-a-rebar-control.md | 4 +++- docs/mfc/using-an-image-list.md | 4 +++- docs/mfc/using-an-unclipped-device-context.md | 4 +++- ...using-callback-fields-in-a-date-and-time-picker-control.md | 4 +++- docs/mfc/using-canimatectrl.md | 4 +++- docs/mfc/using-ccomboboxex.md | 4 +++- docs/mfc/using-cdatetimectrl.md | 4 +++- docs/mfc/using-cheaderctrl.md | 4 +++- docs/mfc/using-chotkeyctrl.md | 4 +++- docs/mfc/using-cimagelist.md | 4 +++- docs/mfc/using-clistctrl.md | 4 +++- docs/mfc/using-cmonthcalctrl.md | 4 +++- docs/mfc/using-cobject.md | 4 +++- docs/mfc/using-common-controls-in-a-dialog-box.md | 4 +++- docs/mfc/using-cprogressctrl.md | 4 +++- docs/mfc/using-crebarctrl.md | 4 +++- docs/mfc/using-cricheditctrl.md | 4 +++- docs/mfc/using-csliderctrl.md | 4 +++- docs/mfc/using-cspinbuttonctrl.md | 4 +++- .../using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md | 4 +++- docs/mfc/using-cstatusbarctrl.md | 4 +++- docs/mfc/using-ctabctrl.md | 4 +++- docs/mfc/using-ctoolbarctrl.md | 4 +++- ...ltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md | 4 +++- docs/mfc/using-ctooltipctrl.md | 4 +++- docs/mfc/using-ctreectrl.md | 4 +++- ...custom-format-strings-in-a-date-and-time-picker-control.md | 4 +++- docs/mfc/using-documents.md | 4 +++- docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md | 4 +++- docs/mfc/using-frame-windows.md | 4 +++- docs/mfc/using-image-lists-in-a-toolbar-control.md | 4 +++- .../mfc/using-image-lists-in-an-extended-combo-box-control.md | 4 +++- docs/mfc/using-image-lists-with-header-controls.md | 4 +++- docs/mfc/using-property-sheets-in-your-application.md | 4 +++- docs/mfc/using-slider-controls.md | 4 +++- docs/mfc/using-the-carchive-output-and-input-operators.md | 4 +++- .../using-the-classes-to-write-applications-for-windows.md | 4 +++- docs/mfc/using-the-dialog-editor-to-add-controls.md | 4 +++- docs/mfc/using-the-mfc-source-files.md | 4 +++- docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md | 4 +++- docs/mfc/using-tree-controls.md | 4 +++- docs/mfc/using-views.md | 4 +++- 100 files changed, 300 insertions(+), 100 deletions(-) diff --git a/docs/mfc/tn047-relaxing-database-transaction-requirements.md b/docs/mfc/tn047-relaxing-database-transaction-requirements.md index 43e0e700c54..51f54a2b31b 100644 --- a/docs/mfc/tn047-relaxing-database-transaction-requirements.md +++ b/docs/mfc/tn047-relaxing-database-transaction-requirements.md @@ -4,10 +4,12 @@ title: "TN047: Relaxing Database Transaction Requirements" ms.date: "11/04/2016" f1_keywords: ["vc.data"] helpviewer_keywords: ["TN047"] -ms.assetid: f93c51cf-a8c0-43d0-aa47-7bcb8333d693 --- # TN047: Relaxing Database Transaction Requirements +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This tech note, which discussed the transaction requirements of the MFC ODBC database classes, is now obsolete. Before MFC 4.2, the database classes required that cursors be preserved on recordsets after a **CommitTrans** or **Rollback** operation. If the ODBC driver and DBMS did not support this level of cursor preservation, then the database classes did not enable transactions. Beginning with MFC 4.2, the database classes have relaxed the restriction of requiring cursor preservation. Transactions will be enabled if the driver supports them. However, you must now check the effect of a **CommitTrans** or **Rollback** operation on open recordsets. See the member functions [CDatabase::GetCursorCommitBehavior](../mfc/reference/cdatabase-class.md#getcursorcommitbehavior) and [CDatabase::GetCursorRollbackBehavior](../mfc/reference/cdatabase-class.md#getcursorrollbackbehavior) for more information. diff --git a/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md b/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md index 40acefd321e..af7fe25e2bf 100644 --- a/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md +++ b/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md @@ -3,11 +3,13 @@ description: "Learn more about: TN048: Writing ODBC Setup and Administration Pro title: "TN048: Writing ODBC Setup and Administration Programs for MFC Database Applications" ms.date: "11/04/2016" helpviewer_keywords: ["installing ODBC", "ODBC, installing", "setup, ODBC setup programs", "TN048", "ODBC, and MFC", "MFC, database applications"] -ms.assetid: d456cdd4-0513-4a51-80c0-9132b66115ce ms.topic: install-set-up-deploy --- # TN048: Writing ODBC Setup and Administration Programs for MFC Database Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn049-mfc-ole-mbcs-to-unicode-translation-layer-mfcans32.md b/docs/mfc/tn049-mfc-ole-mbcs-to-unicode-translation-layer-mfcans32.md index 85033aff5c3..b5125053a59 100644 --- a/docs/mfc/tn049-mfc-ole-mbcs-to-unicode-translation-layer-mfcans32.md +++ b/docs/mfc/tn049-mfc-ole-mbcs-to-unicode-translation-layer-mfcans32.md @@ -3,10 +3,12 @@ description: "Learn more about: TN049: MFC/OLE MBCS to Unicode Translation Layer title: "TN049: MFC-OLE MBCS to Unicode Translation Layer (MFCANS32)" ms.date: "11/04/2016" helpviewer_keywords: ["MFCANS32.DLL", "TN049"] -ms.assetid: c027e30d-8a51-4e28-b215-13fc49b40431 --- # TN049: MFC/OLE MBCS to Unicode Translation Layer (MFCANS32) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note originally described how MFCANS32.DLL provides ANSI interfaces in the primarily Unicode world of 32-bit OLE. This DLL is no longer used by MFC. ## See also diff --git a/docs/mfc/tn050-mfc-ole-common-dialogs-mfcuix32.md b/docs/mfc/tn050-mfc-ole-common-dialogs-mfcuix32.md index 622181cfa4f..e1aefa45288 100644 --- a/docs/mfc/tn050-mfc-ole-common-dialogs-mfcuix32.md +++ b/docs/mfc/tn050-mfc-ole-common-dialogs-mfcuix32.md @@ -3,10 +3,12 @@ description: "Learn more about: TN050: MFC/OLE Common Dialogs (MFCUIx32)" title: "TN050: MFC-OLE Common Dialogs (MFCUIx32)" ms.date: "11/04/2016" helpviewer_keywords: ["MFCUIx32", "TN050"] -ms.assetid: 397c92f7-e7c8-49fb-97bc-f5602ec744b8 --- # TN050: MFC/OLE Common Dialogs (MFCUIx32) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This note originally covered some issues and the future of the OLE common dialogs provided and used by MFC. The OLE common dialogs are now provided as a component built-in to the system (OLEDLG.DLL) and are fully documented in the product documentation. ## See also diff --git a/docs/mfc/tn051-using-ctl3d-now-and-in-the-future.md b/docs/mfc/tn051-using-ctl3d-now-and-in-the-future.md index 2507945e66f..7ce559319cf 100644 --- a/docs/mfc/tn051-using-ctl3d-now-and-in-the-future.md +++ b/docs/mfc/tn051-using-ctl3d-now-and-in-the-future.md @@ -3,10 +3,12 @@ description: "Learn more about: TN051: Using CTL3D Now and in the Future" title: "TN051: Using CTL3D Now and in the Future" ms.date: "11/04/2016" helpviewer_keywords: ["TN051", "CTL3D.DLL", "3D effect"] -ms.assetid: ab517a13-a137-4a60-8039-be92a632b76b --- # TN051: Using CTL3D Now and in the Future +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This technical note, which previously discussed CTL3D and MFC, is now obsolete. The 3D effect for controls is automatically implemented by MFC. ## See also diff --git a/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md b/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md index 0a40b8e8745..68d83d09180 100644 --- a/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md +++ b/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: TN053: Custom DFX Routines for DAO Database Clas title: "TN053: Custom DFX Routines for DAO Database Classes" ms.date: "09/17/2019" helpviewer_keywords: ["MFC, DAO and", "database classes [MFC], DAO", "DAO [MFC], MFC", "DFX (DAO record field exchange) [MFC], custom routines", "TN053", "DAO [MFC], classes", "DFX (DAO record field exchange) [MFC]", "custom DFX routines [MFC]"] -ms.assetid: fdcf3c51-4fa8-4517-9222-58aaa4f25cac --- # TN053: Custom DFX Routines for DAO Database Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. diff --git a/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md b/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md index 3b44465a053..c39376ef8a7 100644 --- a/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md +++ b/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md @@ -3,11 +3,13 @@ description: "Learn more about: TN054: Calling DAO Directly While Using MFC DAO title: "TN054: Calling DAO Directly While Using MFC DAO Classes" ms.date: "09/17/2019" helpviewer_keywords: ["MFC, DAO and", "passwords [MFC], calling DAO", "security [MFC], DAO", "DAO (Data Access Objects), calling directly", "DAO (Data Access Objects), security", "security [MFC]", "TN054", "DAO (Data Access Objects), and MFC"] -ms.assetid: f7de7d85-8d6c-4426-aa05-2e617c0da957 ms.custom: sfi-ropc-nochange --- # TN054: Calling DAO Directly While Using MFC DAO Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. diff --git a/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md b/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md index 20f25fc6f90..8b669381a6b 100644 --- a/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md +++ b/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: TN055: Migrating MFC ODBC Database Class Applica title: "TN055: Migrating MFC ODBC Database Class Applications to MFC DAO Classes" ms.date: "09/17/2019" helpviewer_keywords: ["DAO [MFC], migration", "TN055", "migration [MFC], ODBC database applications", "ODBC classes [MFC], DAO classes", "migrating ODBC database applications [MFC]", "porting database applications to DAO", "ODBC [MFC], DAO", "porting ODBC database applications to DAO", "migrating database applications [MFC]"] -ms.assetid: 0f858bd1-e168-4e2e-bcd1-8debd82856e4 --- # TN055: Migrating MFC ODBC Database Class Applications to MFC DAO Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. diff --git a/docs/mfc/tn056-installation-of-localized-mfc-components.md b/docs/mfc/tn056-installation-of-localized-mfc-components.md index c3257be73fd..48848e726d2 100644 --- a/docs/mfc/tn056-installation-of-localized-mfc-components.md +++ b/docs/mfc/tn056-installation-of-localized-mfc-components.md @@ -3,10 +3,12 @@ description: "Learn more about: TN056: Installation of Localized MFC Components" title: "TN056: Installation of Localized MFC Components" ms.date: "11/04/2016" helpviewer_keywords: ["components [MFC]", "TN056", "resources [MFC], localization", "localization [MFC], MFC resources", "MFC70LOC.DLL", "MFC DLLs [MFC], localizing", "components [MFC], installing", "DLLs [MFC], localizing MFC", "CTL3D32.DLL", "localization [MFC], resources", "installing MFC components"] -ms.assetid: 0b582615-3bb1-4fc0-b569-d127d6deccd3 --- # TN056: Installation of Localized MFC Components +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This tech note, which discussed the installation of localized MFC components, is now obsolete. **See** [TechNote 57](../mfc/tn057-localization-of-mfc-components.md) for more information on localizing MFC applications. diff --git a/docs/mfc/tn057-localization-of-mfc-components.md b/docs/mfc/tn057-localization-of-mfc-components.md index bb920458129..fe12fc41a47 100644 --- a/docs/mfc/tn057-localization-of-mfc-components.md +++ b/docs/mfc/tn057-localization-of-mfc-components.md @@ -3,10 +3,12 @@ description: "Learn more about: TN057: Localization of MFC Components" title: "TN057: Localization of MFC Components" ms.date: "06/28/2018" helpviewer_keywords: ["components [MFC], localizing", "TN057", "resources [MFC], localization", "localization [MFC], MFC resources", "localization [MFC], MFC components", "MFC DLLs [MFC], localizing", "DLLs [MFC], localizing MFC", "localization [MFC], resources"] -ms.assetid: 5376d329-bd45-41bd-97f5-3d895a9a0af5 --- # TN057: Localization of MFC Components +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn058-mfc-module-state-implementation.md b/docs/mfc/tn058-mfc-module-state-implementation.md index 29a3777b22a..b2ca4bf12b7 100644 --- a/docs/mfc/tn058-mfc-module-state-implementation.md +++ b/docs/mfc/tn058-mfc-module-state-implementation.md @@ -3,10 +3,12 @@ description: "Learn more about: TN058: MFC Module State Implementation" title: "TN058: MFC Module State Implementation" ms.date: "06/28/2018" helpviewer_keywords: ["thread state [MFC]", "module states [MFC], managing state data", "TN058", "MFC, managing state data", "module states [MFC], switching", "DLLs [MFC], module states", "process state [MFC]"] -ms.assetid: 72f5b36f-b3da-4009-a144-24258dcd2b2f --- # TN058: MFC Module State Implementation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn059-using-mfc-mbcs-unicode-conversion-macros.md b/docs/mfc/tn059-using-mfc-mbcs-unicode-conversion-macros.md index ad8aba48e47..b4bae8e9fe9 100644 --- a/docs/mfc/tn059-using-mfc-mbcs-unicode-conversion-macros.md +++ b/docs/mfc/tn059-using-mfc-mbcs-unicode-conversion-macros.md @@ -3,10 +3,12 @@ description: "Learn more about: TN059: Using MFC MBCS/Unicode Conversion Macros" title: "TN059: Using MFC MBCS-Unicode Conversion Macros" ms.date: "11/04/2016" helpviewer_keywords: ["MFCANS32.DLL", "Unicode [MFC], conversion macros", "Unicode [MFC], OLE interfaces", "conversion macros [MFC]", "converting Unicode", "MBCS [MFC], conversion macros", "macros [MFC], MBCS conversion macros", "TN059"] -ms.assetid: a2aab748-94d0-4e2f-8447-3bd07112a705 --- # TN059: Using MFC MBCS/Unicode Conversion Macros +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn060-the-new-windows-common-controls.md b/docs/mfc/tn060-the-new-windows-common-controls.md index 587bb4c4336..2fc9ddc17bd 100644 --- a/docs/mfc/tn060-the-new-windows-common-controls.md +++ b/docs/mfc/tn060-the-new-windows-common-controls.md @@ -4,10 +4,12 @@ title: "TN060: The New Windows Common Controls" ms.date: "11/04/2016" f1_keywords: ["vc.controls.common"] helpviewer_keywords: ["TN060"] -ms.assetid: 1a8eea6c-283a-4043-a7dc-a036e37e508e --- # TN060: The New Windows Common Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Technical Note 60, describing the new Windows common controls and how to use them, has been incorporated into [Controls](../mfc/controls-mfc.md). ## See also diff --git a/docs/mfc/tn061-on-notify-and-wm-notify-messages.md b/docs/mfc/tn061-on-notify-and-wm-notify-messages.md index 41abe932b83..8575d247f07 100644 --- a/docs/mfc/tn061-on-notify-and-wm-notify-messages.md +++ b/docs/mfc/tn061-on-notify-and-wm-notify-messages.md @@ -3,11 +3,13 @@ description: "Learn more about: TN061: ON_NOTIFY and WM_NOTIFY Messages" title: "TN061: ON_NOTIFY and WM_NOTIFY Messages" ms.date: "06/28/2018" helpviewer_keywords: ["ON_NOTIFY_EX message [MFC]", "TN061", "ON_NOTIFY message [MFC]", "ON_NOTIFY_EX_RANGE message [MFC]", "ON_NOTIFY_RANGE message [MFC]", "notification messages", "WM_NOTIFY message"] -ms.assetid: 04a96dde-7049-41df-9954-ad7bb5587caf ms.topic: reference --- # TN061: ON_NOTIFY and WM_NOTIFY Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn062-message-reflection-for-windows-controls.md b/docs/mfc/tn062-message-reflection-for-windows-controls.md index ce9be5675ff..dda93b386df 100644 --- a/docs/mfc/tn062-message-reflection-for-windows-controls.md +++ b/docs/mfc/tn062-message-reflection-for-windows-controls.md @@ -4,10 +4,12 @@ title: "TN062: Message Reflection for Windows Controls" ms.date: "06/28/2018" f1_keywords: ["vc.controls.messages"] helpviewer_keywords: ["ON_WM_VKEYTOITEM_REFLECT macro [MFC]", "ON_WM_DRAWITEM_REFLECT macro [MFC]", "ON_WM_VSCROLL_REFLECT macro [MFC]", "ON_NOTIFY_REFLECT message [MFC]", "ON_CONTROL_REFLECT_EX macro [MFC]", "ON_UPDATE_COMMAND_UI_REFLECT macro [MFC]", "ON_NOTIFY_REFLECT_EX message [MFC]", "ON_WM_HSCROLL_REFLECT macro [MFC]", "message reflection [MFC]", "ON_WM_COMPAREITEM_REFLECT macro [MFC]", "ON_WM_MEASUREITEM_REFLECT macro [MFC]", "ON_NOTIFY message [MFC]", "WM_COMMAND [MFC]", "WM_CTLCOLOR message [MFC]", "TN062 [MFC]", "ON_WM_CHARTOITEM_REFLECT macro [MFC]", "ON_WM_CTLCOLOR_REFLECT macro [MFC]", "ON_WM_DELETEITEM_REFLECT macro [MFC]", "notification messages [MFC]", "ON_WM_PARENTNOTIFY_REFLECT macro [MFC]", "WM_NOTIFY message [MFC]", "ON_CONTROL_REFLECT macro"] -ms.assetid: 53efb0ba-fcda-4fa0-a3c7-14e0b78fb494 --- # TN062: Message Reflection for Windows Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn063-debugging-internet-extension-dlls.md b/docs/mfc/tn063-debugging-internet-extension-dlls.md index 221dc62282f..cbc729feaf3 100644 --- a/docs/mfc/tn063-debugging-internet-extension-dlls.md +++ b/docs/mfc/tn063-debugging-internet-extension-dlls.md @@ -4,10 +4,12 @@ title: "TN063: Debugging Internet MFC extension DLLs" ms.date: "11/04/2016" f1_keywords: ["vs.debug.dlls"] helpviewer_keywords: ["IIS [MFC], debugging DLLs", "TN063 [MFC]", "DLLs [MFC], Internet extension"] -ms.assetid: 7012d592-9d2f-491a-b417-48e5c2a7680f --- # TN063: Debugging Internet MFC extension DLLs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This information is obsolete and has been removed. ## See also diff --git a/docs/mfc/tn064-apartment-model-threading-in-activex-controls.md b/docs/mfc/tn064-apartment-model-threading-in-activex-controls.md index 0d71b56986e..126989be356 100644 --- a/docs/mfc/tn064-apartment-model-threading-in-activex-controls.md +++ b/docs/mfc/tn064-apartment-model-threading-in-activex-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: TN064: Apartment-Model Threading in ActiveX Cont title: "TN064: Apartment-Model Threading in ActiveX Controls" ms.date: "11/04/2016" helpviewer_keywords: ["OLE controls [MFC], container support", "containers [MFC], multithreaded", "TN064 [MFC]", "multithread container [MFC]", "apartment model threading [MFC]"] -ms.assetid: b2ab4c88-6954-48e2-9a74-01d4a60df073 --- # TN064: Apartment-Model Threading in ActiveX Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md b/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md index d7b44243e73..956ba9e677a 100644 --- a/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md +++ b/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md @@ -4,10 +4,12 @@ title: "TN065: Dual-Interface Support for OLE Automation Servers" ms.date: "06/28/2018" f1_keywords: ["vc.ole"] helpviewer_keywords: ["dual interfaces [MFC], OLE Automation", "TN065 [MFC]", "ACDUAL sample [MFC]", "Automation servers [MFC], dual-interface support"] -ms.assetid: b5c8ed09-2f7f-483c-80fc-2a47ad896063 --- # TN065: Dual-Interface Support for OLE Automation Servers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn066-common-mfc-3-x-to-4-0-porting-issues.md b/docs/mfc/tn066-common-mfc-3-x-to-4-0-porting-issues.md index ecfa6eef124..6b374174140 100644 --- a/docs/mfc/tn066-common-mfc-3-x-to-4-0-porting-issues.md +++ b/docs/mfc/tn066-common-mfc-3-x-to-4-0-porting-issues.md @@ -3,10 +3,12 @@ description: "Learn more about: TN066: Common MFC 3.x to 4.0 Porting Issues" title: "TN066: Common MFC 3.x to 4.0 Porting Issues" ms.date: "11/04/2016" helpviewer_keywords: ["porting MFC, 3.x to 4.0", "TN066 [MFC]", "porting MFC"] -ms.assetid: 88308897-8da8-496d-bdef-d34ab77cdd79 --- # TN066: Common MFC 3.x to 4.0 Porting Issues +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This technical note described the most common problems that can occur when attempting to port an application written with MFC 3.x (the MFC included with Visual C++ 2.x) to MFC 4.0. ## See also diff --git a/docs/mfc/tn068-performing-transactions-with-the-microsoft-access-7-odbc-driver.md b/docs/mfc/tn068-performing-transactions-with-the-microsoft-access-7-odbc-driver.md index 41fbc200c66..64b92977edd 100644 --- a/docs/mfc/tn068-performing-transactions-with-the-microsoft-access-7-odbc-driver.md +++ b/docs/mfc/tn068-performing-transactions-with-the-microsoft-access-7-odbc-driver.md @@ -4,10 +4,12 @@ title: "TN068: Performing Transactions with the Microsoft Access 7 ODBC Driver" ms.date: "06/28/2018" f1_keywords: ["vc.data.odbc"] helpviewer_keywords: ["TN068 [MFC]", "transactions [MFC], calling BeginTrans", "transactions [MFC], Microsoft Access"] -ms.assetid: d3f8f5d9-b118-4194-be36-a1aefb630c45 --- # TN068: Performing Transactions with the Microsoft Access 7 ODBC Driver +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn070-mfc-window-class-names.md b/docs/mfc/tn070-mfc-window-class-names.md index f72a9dadf3f..f3d9fe97e47 100644 --- a/docs/mfc/tn070-mfc-window-class-names.md +++ b/docs/mfc/tn070-mfc-window-class-names.md @@ -3,10 +3,12 @@ description: "Learn more about: TN070: MFC Window Class Names" title: "TN070: MFC Window Class Names" ms.date: "11/04/2016" helpviewer_keywords: ["window class names [MFC]", "TN070 [MFC]"] -ms.assetid: 90617912-dd58-4a7c-9082-ced71736d7cd --- # TN070: MFC Window Class Names +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tn071-mfc-iolecommandtarget-implementation.md b/docs/mfc/tn071-mfc-iolecommandtarget-implementation.md index 293dda09b60..33a2073e56b 100644 --- a/docs/mfc/tn071-mfc-iolecommandtarget-implementation.md +++ b/docs/mfc/tn071-mfc-iolecommandtarget-implementation.md @@ -3,10 +3,12 @@ description: "Learn more about: TN071: MFC IOleCommandTarget Implementation" title: "TN071: MFC IOleCommandTarget Implementation" ms.date: "06/28/2018" helpviewer_keywords: ["TN071 [MFC]", "IOleCommandTarget interface [MFC]"] -ms.assetid: 3eef571e-6357-444d-adbb-6f734a0c3161 --- # TN071: MFC IOleCommandTarget Implementation +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. diff --git a/docs/mfc/tool-tips-in-windows-not-derived-from-cframewnd.md b/docs/mfc/tool-tips-in-windows-not-derived-from-cframewnd.md index ae8986fef63..8d3d3ee6772 100644 --- a/docs/mfc/tool-tips-in-windows-not-derived-from-cframewnd.md +++ b/docs/mfc/tool-tips-in-windows-not-derived-from-cframewnd.md @@ -3,10 +3,12 @@ description: "Learn more about: Tool Tips in Windows Not Derived from CFrameWnd" title: "Tool Tips in Windows Not Derived from CFrameWnd" ms.date: "11/04/2016" helpviewer_keywords: ["enabling tool tips [MFC]", "TOOLTIPTEXT structure [MFC]", "Help [MFC], tool tips for controls", "TTN_NEEDTEXT message [MFC]", "controls [MFC], tool tips", "handler functions [MFC], tool tips"] -ms.assetid: cad5ef0f-02e3-4151-ad0d-3d42e6932b0e --- # Tool Tips in Windows Not Derived from CFrameWnd +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article family covers enabling tool tips for controls contained in a window that is not derived from [CFrameWnd](../mfc/reference/cframewnd-class.md). The article [Toolbars Tool Tips](../mfc/toolbar-tool-tips.md) provides information about tool tips for controls in a `CFrameWnd`. Topics covered in this article family include: diff --git a/docs/mfc/tool-tips.md b/docs/mfc/tool-tips.md index 33ac9aa93ef..84f1e235f9b 100644 --- a/docs/mfc/tool-tips.md +++ b/docs/mfc/tool-tips.md @@ -3,10 +3,12 @@ description: "Learn more about: Tool Tips" title: "Tool Tips" ms.date: "11/04/2016" helpviewer_keywords: ["CFrameWnd class [MFC], tool tips", "Help [MFC], tool tips for controls", "tool tips [MFC], CFrameWnd", "controls [MFC], tool tips", "buttons [MFC], tool tips"] -ms.assetid: 7f0bba86-7c55-4bf6-8455-687a4dcb2be8 --- # Tool Tips +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The procedures are distinct for adding tool tips to controls contained in windows derived from MFC class [CFrameWnd](../mfc/reference/cframewnd-class.md) and windows not derived from `CFrameWnd`. ## What do you want to know more about diff --git a/docs/mfc/toolbar-fundamentals.md b/docs/mfc/toolbar-fundamentals.md index e6f6328e2f2..92532ae95e8 100644 --- a/docs/mfc/toolbar-fundamentals.md +++ b/docs/mfc/toolbar-fundamentals.md @@ -4,10 +4,12 @@ title: "Toolbar Fundamentals" ms.date: "11/04/2016" f1_keywords: ["RT_TOOLBAR"] helpviewer_keywords: ["embedding toolbar in frame window class [MFC]", "application wizards [MFC], installing default application toolbars", "toolbars [MFC], creating", "resources [MFC], toolbar", "toolbar controls [MFC], toolbars created using Application Wizard", "toolbar controls [MFC], command ID", "RT_TOOLBAR resource [MFC]", "toolbars [MFC], adding default using Application Wizard", "LoadBitmap method [MFC], toolbars", "Toolbar editor [MFC], Application Wizard", "command IDs [MFC], toolbar buttons", "SetButtons method [MFC]", "CToolBar class [MFC], default toolbars in Application Wizard", "frame window classes [MFC], toolbar embedded in", "LoadToolBar method [MFC]"] -ms.assetid: cc00aaff-8a56-433b-b0c0-b857d76b4ffd --- # Toolbar Fundamentals +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the fundamental MFC implementation that lets you add a default toolbar to your application by selecting an option in the Application Wizard. Topics covered include: - [The Application Wizard toolbar option](#_core_the_appwizard_toolbar_option) diff --git a/docs/mfc/toolbar-sample-list.md b/docs/mfc/toolbar-sample-list.md index f7ec47b1bec..a47fdf7ea6c 100644 --- a/docs/mfc/toolbar-sample-list.md +++ b/docs/mfc/toolbar-sample-list.md @@ -3,10 +3,12 @@ description: "Learn more about: Toolbar Sample List" title: "Toolbar Sample List" ms.date: "11/04/2016" helpviewer_keywords: ["sample applications [MFC], toolbars"] -ms.assetid: 61310e4e-3df7-47c2-8b10-7c6cb45c5d1b --- # Toolbar Sample List +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + See the following sample programs that illustrate using MFC's toolbars: - [SCRIBBLE](../overview/visual-cpp-samples.md) diff --git a/docs/mfc/toolbar-tool-tips.md b/docs/mfc/toolbar-tool-tips.md index d7914d8884d..b0ea2b0d9a7 100644 --- a/docs/mfc/toolbar-tool-tips.md +++ b/docs/mfc/toolbar-tool-tips.md @@ -3,10 +3,12 @@ description: "Learn more about: Toolbar Tool Tips" title: "Toolbar Tool Tips" ms.date: "11/04/2016" helpviewer_keywords: ["tool tips [MFC], activating", "CBRS_TOOLTIPS constant [MFC]", "tool tips [MFC], adding text", "updates [MFC]", "CBRS_FLYBY constant [MFC]", "tool tips [MFC]", "updating status bar messages", "updates, status bar messages", "status bars [MFC], tool tips", "flyby status bar updates"] -ms.assetid: d1696305-b604-4fad-9f09-638878371412 --- # Toolbar Tool Tips +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Tool tips are the tiny popup windows that present short descriptions of a toolbar button's purpose when you position the mouse over a button for a period of time. When you create an application with the Application Wizard that has a toolbar, tool tip support is provided for you. This article explains both the tool tip support created by the Application Wizard and how to add tool tip support to your application. This article covers: diff --git a/docs/mfc/toolbars.md b/docs/mfc/toolbars.md index 7ad24693784..cca3d41db3b 100644 --- a/docs/mfc/toolbars.md +++ b/docs/mfc/toolbars.md @@ -3,10 +3,12 @@ description: "Learn more about: Toolbars" title: "Toolbars" ms.date: "11/04/2016" helpviewer_keywords: ["toolbars [MFC]", "command bars [MFC], MFC toolbars"] -ms.assetid: c22ecc5b-a84c-4979-8d1a-8e3e71d5ce33 --- # Toolbars +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The toolbar family of articles describes MFC toolbars and how to create and use them. ## What do you want to know more about diff --git a/docs/mfc/tooltiptext-structure.md b/docs/mfc/tooltiptext-structure.md index 2fb1e28f541..ebb33d4f484 100644 --- a/docs/mfc/tooltiptext-structure.md +++ b/docs/mfc/tooltiptext-structure.md @@ -4,10 +4,12 @@ title: "TOOLTIPTEXT Structure" ms.date: "11/04/2016" f1_keywords: ["TOOLTIPTEXT"] helpviewer_keywords: ["TOOLTIPTEXT structure [MFC]", "tool tips [MFC], notifications"] -ms.assetid: 547591bf-80f5-400e-a2a7-0708cfffbb5d --- # TOOLTIPTEXT Structure +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In writing your [tool tip notification handler](../mfc/handling-ttn-needtext-notification-for-tool-tips.md), you need to use the **TOOLTIPTEXT** structure. The members of the **TOOLTIPTEXT** structure are: ```cpp diff --git a/docs/mfc/trackers-implementing-trackers-in-your-ole-application.md b/docs/mfc/trackers-implementing-trackers-in-your-ole-application.md index d5718ffda1d..208656401f8 100644 --- a/docs/mfc/trackers-implementing-trackers-in-your-ole-application.md +++ b/docs/mfc/trackers-implementing-trackers-in-your-ole-application.md @@ -3,10 +3,12 @@ description: "Learn more about: Trackers: Implementing Trackers in Your OLE Appl title: "Trackers: Implementing Trackers in Your OLE Application" ms.date: "11/04/2016" helpviewer_keywords: ["trackers [MFC]", "OLE applications [MFC], trackers", "applications [OLE], trackers", "tracking OLE items [MFC]", "OLE containers [MFC], trackers", "CRectTracker class [MFC], implementing trackers"] -ms.assetid: 5103a517-65bd-441a-8a53-02915ff3ef08 --- # Trackers: Implementing Trackers in Your OLE Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Trackers provide a graphical interface to enable users to interact with OLE client items. By using different tracker styles, OLE client items can be displayed with hatched borders, resize handles, or a variety of other visual effects. This article describes: - [How to Implement Tracking in Your Code](../mfc/how-to-implement-tracking-in-your-code.md). diff --git a/docs/mfc/trackers.md b/docs/mfc/trackers.md index 284e9585651..c3f2d1dec11 100644 --- a/docs/mfc/trackers.md +++ b/docs/mfc/trackers.md @@ -3,10 +3,12 @@ description: "Learn more about: Trackers" title: "Trackers" ms.date: "11/04/2016" helpviewer_keywords: ["trackers [MFC]", "OLE applications [MFC], trackers", "applications [OLE], trackers", "tracking OLE items [MFC]", "OLE containers [MFC], trackers", "CDC class [MFC], trackers", "CRectTracker class [MFC], implementing trackers", "OLE server applications [MFC], trackers"] -ms.assetid: dcd09399-6637-4621-80e5-d12670429787 --- # Trackers +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [CRectTracker](../mfc/reference/crecttracker-class.md) class provides a user interface between rectangular items in your application and your user by providing a variety of display styles. These styles include solid, hatched, or dashed borders; a hatched pattern that covers the item; and resize handles that can be located on the outside or inside of a border. Trackers are often used in conjunction with OLE items, that is, objects derived from `COleClientItem`. The tracker rectangles give visual cues on the current status of the item. The MFC OLE sample [OCLIENT](../overview/visual-cpp-samples.md) demonstrates a common interface using trackers and OLE client items from the viewpoint of a container application. For a demonstration of the different styles and abilities of a tracker object, see the MFC general sample [TRACKER](../overview/visual-cpp-samples.md). diff --git a/docs/mfc/tree-control-drag-and-drop-operations.md b/docs/mfc/tree-control-drag-and-drop-operations.md index 32bfd434cb4..bd72d567335 100644 --- a/docs/mfc/tree-control-drag-and-drop-operations.md +++ b/docs/mfc/tree-control-drag-and-drop-operations.md @@ -3,10 +3,12 @@ description: "Learn more about: Tree Control Drag-and-Drop Operations" title: "Tree Control Drag-and-Drop Operations" ms.date: "11/04/2016" helpviewer_keywords: ["CTreeCtrl class [MFC], drag and drop operations", "drag and drop [MFC], CTreeCtrl", "tree controls [MFC], drag and drop operations"] -ms.assetid: 3cf78b4c-4579-4fe1-9bc9-c5ab876e4af1 --- # Tree Control Drag-and-Drop Operations +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) sends a notification when the user starts to drag an item. The control sends a [TVN_BEGINDRAG](/windows/win32/Controls/tvn-begindrag) notification message when the user begins dragging an item with the left mouse button and a [TVN_BEGINRDRAG](/windows/win32/Controls/tvn-beginrdrag) notification message when the user begins dragging with the right button. You can prevent a tree control from sending these notifications by giving the tree control the TVS_DISABLEDRAGDROP style. You obtain an image to display during a drag operation by calling the [CreateDragImage](../mfc/reference/ctreectrl-class.md#createdragimage) member function. The tree control creates a dragging bitmap based on the label of the item being dragged. Then the tree control creates an image list, adds the bitmap to it, and returns a pointer to the [CImageList](../mfc/reference/cimagelist-class.md) object. diff --git a/docs/mfc/tree-control-image-lists.md b/docs/mfc/tree-control-image-lists.md index d8525bec05f..93787bb896f 100644 --- a/docs/mfc/tree-control-image-lists.md +++ b/docs/mfc/tree-control-image-lists.md @@ -3,10 +3,12 @@ description: "Learn more about: Tree Control Image Lists" title: "Tree Control Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["images [MFC], lists in tree controls", "tree controls [MFC], image lists", "CTreeCtrl class [MFC], image lists"] -ms.assetid: f560c4f2-20d2-4d28-ac33-4017e65fb0a6 --- # Tree Control Image Lists +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Each item in a tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) can have a pair of bitmapped images associated with it. The images appear on the left side of an item's label. One image is displayed when the item is selected, and the other is displayed when the item is not selected. For example, an item might display an open folder when it is selected and a closed folder when it is not selected. To use item images, you must create an image list by constructing a [CImageList](../mfc/reference/cimagelist-class.md) object and using the [CImageList::Create](../mfc/reference/cimagelist-class.md#create) function to create the associated image list. Then add the desired bitmaps to the list, and associate the list with the tree control by using the [SetImageList](../mfc/reference/ctreectrl-class.md#setimagelist) member function. By default, all items display the first image in the image list for both the selected and nonselected states. You can change the default behavior for a particular item by specifying the indexes of the selected and nonselected images when adding the item to the tree control using the [InsertItem](../mfc/reference/ctreectrl-class.md#insertitem) member function. You can change the indexes after adding an item by using the [SetItemImage](../mfc/reference/ctreectrl-class.md#setitemimage) member function. diff --git a/docs/mfc/tree-control-item-information.md b/docs/mfc/tree-control-item-information.md index acf7eb6b7d9..bc49370f2b1 100644 --- a/docs/mfc/tree-control-item-information.md +++ b/docs/mfc/tree-control-item-information.md @@ -3,10 +3,12 @@ description: "Learn more about: Tree Control Item Information" title: "Tree Control Item Information" ms.date: "11/04/2016" helpviewer_keywords: ["tree controls [MFC], item information", "CTreeCtrl class [MFC], item information"] -ms.assetid: 8dcab855-27de-49e9-95d8-f78ba963ea71 --- # Tree Control Item Information +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Tree controls ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) have a number of member functions that retrieve information about items in the control. The [GetItem](../mfc/reference/ctreectrl-class.md#getitem) member function retrieves some or all of the data associated with an item. This data could include the item's text, state, images, count of child items, and an application-defined 32-bit data value. There is also a [SetItem](../mfc/reference/ctreectrl-class.md#setitem) function that can set some or all of the data associated with an item. The [GetItemState](../mfc/reference/ctreectrl-class.md#getitemstate), [GetItemText](../mfc/reference/ctreectrl-class.md#getitemtext), [GetItemData](../mfc/reference/ctreectrl-class.md#getitemdata), and [GetItemImage](../mfc/reference/ctreectrl-class.md#getitemimage) member functions retrieve individual attributes of an item. Each of these functions has a corresponding Set function for setting the attributes of an item. diff --git a/docs/mfc/tree-control-item-labels.md b/docs/mfc/tree-control-item-labels.md index aea13c5e902..42490361966 100644 --- a/docs/mfc/tree-control-item-labels.md +++ b/docs/mfc/tree-control-item-labels.md @@ -3,10 +3,12 @@ description: "Learn more about: Tree Control Item Labels" title: "Tree Control Item Labels" ms.date: "11/04/2016" helpviewer_keywords: ["tree controls [MFC], item labels", "labels, CTreeCtrl items", "CTreeCtrl class [MFC], item labels", "item labels, tree controls", "item labels"] -ms.assetid: fe834107-1a25-4280-aced-774c11565805 --- # Tree Control Item Labels +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You typically specify the text of an item's label when adding the item to the tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)). The `InsertItem` member function can pass a [TVITEM](/windows/win32/api/commctrl/ns-commctrl-tvitemw) structure that defines the item's properties, including a string containing the text of the label. `InsertItem` has several overloads that can be called with various combinations of parameters. A tree control allocates memory for storing each item; the text of the item labels takes up a significant portion of this memory. If your application maintains a copy of the strings in the tree control, you can decrease the memory requirements of the control by specifying the **LPSTR_TEXTCALLBACK** value in the *pszText* member of `TV_ITEM` or the *lpszItem* parameter instead of passing actual strings to the tree control. Using **LPSTR_TEXTCALLBACK** causes the tree control to retrieve the text of an item's label from the application whenever the item needs to be redrawn. To retrieve the text, the tree control sends a [TVN_GETDISPINFO](/windows/win32/Controls/tvn-getdispinfo) notification message, which includes the address of a [NMTVDISPINFO](/windows/win32/api/commctrl/ns-commctrl-nmtvdispinfow) structure. You must respond by setting the appropriate members of the included structure. diff --git a/docs/mfc/tree-control-item-position.md b/docs/mfc/tree-control-item-position.md index f6a855c2018..11544293a93 100644 --- a/docs/mfc/tree-control-item-position.md +++ b/docs/mfc/tree-control-item-position.md @@ -3,10 +3,12 @@ description: "Learn more about: Tree Control Item Position" title: "Tree Control Item Position" ms.date: "11/04/2016" helpviewer_keywords: ["CTreeCtrl class [MFC], item position", "item position in tree controls", "tree controls [MFC], item position", "position, CTreeCtrl items"] -ms.assetid: cd264344-2cf9-4d90-9ea8-c6900b6f60e7 --- # Tree Control Item Position +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An item's initial position is set when the item is added to the tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) by using the `InsertItem` member function. The member function call specifies the handle of the parent item and the handle of the item after which the new item is to be inserted. The second handle must identify either a child item of the given parent or one of these values: `TVI_FIRST`, `TVI_LAST`, or `TVI_SORT`. When `TVI_FIRST` or `TVI_LAST` is specified, the tree control places the new item at the beginning or end of the given parent item's list of child items. When `TVI_SORT` is specified, the tree control inserts the new item into the list of child items in alphabetical order based on the text of the item labels. diff --git a/docs/mfc/tree-control-item-selection.md b/docs/mfc/tree-control-item-selection.md index e48ff060f2c..411f20dbc4f 100644 --- a/docs/mfc/tree-control-item-selection.md +++ b/docs/mfc/tree-control-item-selection.md @@ -3,10 +3,12 @@ description: "Learn more about: Tree Control Item Selection" title: "Tree Control Item Selection" ms.date: "11/04/2016" helpviewer_keywords: ["tree controls [MFC], item selection", "controls [MFC], selecting items in", "CTreeCtrl class [MFC], item selection", "item selection in tree controls"] -ms.assetid: 7bcb3b16-b9c8-4c06-9350-7bc3c1c5009b --- # Tree Control Item Selection +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When the selection changes from one item to another, a tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) sends [TVN_SELCHANGING](/windows/win32/Controls/tvn-selchanging) and [TVN_SELCHANGED](/windows/win32/Controls/tvn-selchanged) notification messages. Both notifications include a value that specifies whether the change is the result of a mouse click or a keystroke. The notifications also include information about the item that is gaining the selection and the item that is losing the selection. You can use this information to set item attributes that depend on the selection state of the item. Returning **TRUE** in response to `TVN_SELCHANGING` prevents the selection from changing; returning **FALSE** allows the change. An application can change the selection by calling the [SelectItem](../mfc/reference/ctreectrl-class.md#selectitem) member function. diff --git a/docs/mfc/tree-control-item-states-overview.md b/docs/mfc/tree-control-item-states-overview.md index ca07cec4fa6..856d9a7e72d 100644 --- a/docs/mfc/tree-control-item-states-overview.md +++ b/docs/mfc/tree-control-item-states-overview.md @@ -3,11 +3,13 @@ description: "Learn more about: Tree Control Item States Overview" title: "Tree Control Item States Overview" ms.date: "11/04/2016" helpviewer_keywords: ["states, CTreeCtrl items", "tree controls [MFC], item states overview", "CTreeCtrl class [MFC], item states"] -ms.assetid: 2db11ae0-0d87-499d-8c1f-5e0dbe9e94c8 ms.topic: concept-article --- # Tree Control Item States Overview +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Each item in a tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) has a current state. For example, an item can be selected, disabled, expanded, and so on. For the most part, the tree control automatically sets an item's state to reflect user actions, such as selection of an item. However, you can also set an item's state by using the [SetItemState](../mfc/reference/ctreectrl-class.md#setitemstate) member function and retrieve the current state of an item by using the [GetItemState](../mfc/reference/ctreectrl-class.md#getitemstate) member function. For a complete list of item states, see [Tree-View Control Constants](/windows/win32/Controls/tree-view-control-item-states) in the Windows SDK. An item's current state is specified by the *nState* parameter. A tree control might change an item's state to reflect a user action, such as selecting the item or setting the focus to the item. In addition, an application might change an item's state to disable or hide the item or to specify an overlay image or state image. diff --git a/docs/mfc/tree-control-label-editing.md b/docs/mfc/tree-control-label-editing.md index ec3bd79edfb..fbef5efff63 100644 --- a/docs/mfc/tree-control-label-editing.md +++ b/docs/mfc/tree-control-label-editing.md @@ -3,10 +3,12 @@ description: "Learn more about: Tree Control Label Editing" title: "Tree Control Label Editing" ms.date: "11/04/2016" helpviewer_keywords: ["editing tree control labels", "CTreeCtrl class [MFC], editing labels", "label editing in CTreeCtrl class [MFC]", "tree controls [MFC], label editing"] -ms.assetid: 6cde2ac3-43ee-468f-bac2-cf1a228ad32d --- # Tree Control Label Editing +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The user can directly edit the labels of items in a tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) that has the **TVS_EDITLABELS** style. The user begins editing by clicking the label of the item that has the focus. An application begins editing by using the [EditLabel](../mfc/reference/ctreectrl-class.md#editlabel) member function. The tree control sends the notification when editing begins and when it is canceled or completed. When editing is completed, you are responsible for updating the item's label, if appropriate. When label editing begins, a tree control sends a [TVN_BEGINLABELEDIT](/windows/win32/Controls/tvn-beginlabeledit) notification message. By processing this notification, you can allow editing of some labels and prevent editing of others. Returning 0 allows editing, and returning nonzero prevents it. diff --git a/docs/mfc/tree-control-notification-messages.md b/docs/mfc/tree-control-notification-messages.md index d17b69afe5d..15a91e6e4fb 100644 --- a/docs/mfc/tree-control-notification-messages.md +++ b/docs/mfc/tree-control-notification-messages.md @@ -3,10 +3,12 @@ description: "Learn more about: Tree Control Notification Messages" title: "Tree Control Notification Messages" ms.date: "11/04/2016" helpviewer_keywords: ["notifications [MFC], tree controls", "messages [MFC], notification", "CTreeCtrl class [MFC], notifications", "notifications [MFC], CTreeCtrl", "tree controls [MFC], notification messages"] -ms.assetid: ac7013b4-91dd-4668-bd75-439ca0680ef9 --- # Tree Control Notification Messages +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) sends the following notification messages as WM_NOTIFY messages: |Notification message|Description| diff --git a/docs/mfc/tree-control-parent-and-child-items.md b/docs/mfc/tree-control-parent-and-child-items.md index 27d07a900eb..ddc959d65e6 100644 --- a/docs/mfc/tree-control-parent-and-child-items.md +++ b/docs/mfc/tree-control-parent-and-child-items.md @@ -3,10 +3,12 @@ description: "Learn more about: Tree Control Parent and Child Items" title: "Tree Control Parent and Child Items" ms.date: "11/04/2016" helpviewer_keywords: ["parent items in CTreeCtrl [MFC]", "child items in tree control [MFC]", "CTreeCtrl class [MFC], parent and child items", "tree controls [MFC], parent and child items"] -ms.assetid: abcea1e4-fe9b-40d9-86dc-1db235f8f103 --- # Tree Control Parent and Child Items +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Any item in a tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) can have a list of subitems, which are called child items, associated with it. An item that has one or more child items is called a parent item. A child item is displayed below its parent item and is indented to indicate it is subordinate to the parent. An item that has no parent is at the top of the hierarchy and is called a root item. At any given time, the state of a parent item's list of child items can be either expanded or collapsed. When the state is expanded, the child items are displayed below the parent item. When it is collapsed, the child items are not displayed. The list automatically toggles between the expanded and collapsed states when the user double-clicks the parent item or, if the parent has the **TVS_HASBUTTONS** style, when the user clicks the button associated with the parent item. An application can expand or collapse the child items by using the [Expand](../mfc/reference/ctreectrl-class.md#expand) member function. diff --git a/docs/mfc/tree-control-styles.md b/docs/mfc/tree-control-styles.md index bde048b5f4f..b801000df1d 100644 --- a/docs/mfc/tree-control-styles.md +++ b/docs/mfc/tree-control-styles.md @@ -4,10 +4,12 @@ title: "Tree Control Styles" ms.date: "11/04/2016" f1_keywords: ["TVS_SINGLEEXPAND", "TVS_LINESATROOT", "TVS_HASBUTTONS", "TVS_NOTOOLTIPS", "TVS_HASLINES"] helpviewer_keywords: ["TVS_LINESATROOT [MFC]", "styles [MFC], CTreeCtrl", "styles [MFC], tree control", "TVS_HASLINES", "TVS_SINGLEEXPAND", "CTreeCtrl class [MFC], styles", "TVS_EDITLABELS [MFC]", "TVS_NOTOOLTIPS [MFC]", "TVS_HASBUTTONS [MFC]", "tree controls [MFC], styles"] -ms.assetid: f43faebd-a355-479e-888a-bf0673d5e1b4 --- # Tree Control Styles +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) styles govern aspects of a tree control's appearance. You set the initial styles when you create the tree control. You can retrieve and change the styles after creating the tree control by using the [GetWindowLong](/windows/win32/api/winuser/nf-winuser-getwindowlongw) and [SetWindowLong](/windows/win32/api/winuser/nf-winuser-setwindowlongw) Windows functions, specifying **GWL_STYLE** for the *nIndex* parameter. For a complete list of styles, see [Tree View Control Window Styles](/windows/win32/Controls/tree-view-control-window-styles) in the Windows SDK. The **TVS_HASLINES** style enhances the graphic representation of a tree control's hierarchy by drawing lines that link child items to their corresponding parent item. This style does not link items at the root of the hierarchy. To do so, you need to combine the **TVS_HASLINES** and **TVS_LINESATROOT** styles. diff --git a/docs/mfc/turning-off-the-activate-when-visible-option.md b/docs/mfc/turning-off-the-activate-when-visible-option.md index a72e1bf165f..530d54f0526 100644 --- a/docs/mfc/turning-off-the-activate-when-visible-option.md +++ b/docs/mfc/turning-off-the-activate-when-visible-option.md @@ -3,11 +3,13 @@ description: "Learn more about: Turning off the Activate When Visible Option" title: "Turning off the Activate When Visible Option" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], activate options", "Activate When Visible option [MFC]"] -ms.assetid: 8f7ddc5a-a7a6-4da8-bcb9-1b569f0ecb48 ms.topic: concept-article --- # Turning off the Activate When Visible Option +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A control has two basic states: active and inactive. Traditionally, these states were distinguished by whether the control had a window. An active control had a window; an inactive control did not. With the introduction of windowless activation, this distinction is no longer universal, but still applies to many controls. Compared with the rest of the initialization typically performed by an ActiveX control, the creation of a window is an extremely expensive operation. Ideally, a control would defer creating its window until absolutely necessary. diff --git a/docs/mfc/two-ways-to-create-a-carchive-object.md b/docs/mfc/two-ways-to-create-a-carchive-object.md index 9347fd20f75..b63004007b1 100644 --- a/docs/mfc/two-ways-to-create-a-carchive-object.md +++ b/docs/mfc/two-ways-to-create-a-carchive-object.md @@ -3,10 +3,12 @@ description: "Learn more about: Two Ways to Create a CArchive Object" title: "Two Ways to Create a CArchive Object" ms.date: "11/04/2016" helpviewer_keywords: ["CArchive class [MFC], closing CArchive objects", "CArchive objects [MFC], closing", "I/O [MFC], creating CArchive objects", "serialization [MFC], CArchive class", "CArchive objects [MFC]", "storage [MFC], CArchive class [MFC]", "data storage [MFC], CArchive class", "CArchive class [MFC], constructor"] -ms.assetid: aefa28ce-b55c-40dc-9e42-5f038030985d --- # Two Ways to Create a CArchive Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + There are two ways to create a `CArchive` object: - [Implicit creation of a CArchive object via the framework](#_core_implicit_creation_of_a_carchive_object_via_the_framework) diff --git a/docs/mfc/type-safe-access-to-controls-in-a-dialog-box.md b/docs/mfc/type-safe-access-to-controls-in-a-dialog-box.md index 0e628e5526b..1154f42ac06 100644 --- a/docs/mfc/type-safe-access-to-controls-in-a-dialog-box.md +++ b/docs/mfc/type-safe-access-to-controls-in-a-dialog-box.md @@ -3,10 +3,12 @@ description: "Learn more about: Type-Safe Access to Controls in a Dialog Box" title: "Type-Safe Access to Controls in a Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["common controls [MFC], in dialog boxes", "Windows common controls [MFC], in dialog boxes", "safe access to dialog box controls", "dialog boxes [MFC], type-safe access to controls", "controls [MFC], accessing in dialog boxes", "type-safe access to dialog box controls", "MFC dialog boxes [MFC], type-safe access to controls"] -ms.assetid: 67021025-dd93-4d6a-8bed-a1348fe50685 --- # Type-Safe Access to Controls in a Dialog Box +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The controls in a dialog box can use the interfaces of MFC control classes such as `CListBox` and `CEdit`. You can create a control object and attach it to a dialog control. Then you can access the control through its class interface, calling member functions to operate on the control. The methods described here are designed to give you type-safe access to a control. This is especially useful for controls such as edit boxes and list boxes. There are two approaches to making a connection between a control in a dialog box and a C++ control member variable in a `CDialog`-derived class: diff --git a/docs/mfc/type-safe-access-to-controls-with-code-wizards.md b/docs/mfc/type-safe-access-to-controls-with-code-wizards.md index 0ac28da3350..56892af1285 100644 --- a/docs/mfc/type-safe-access-to-controls-with-code-wizards.md +++ b/docs/mfc/type-safe-access-to-controls-with-code-wizards.md @@ -3,10 +3,12 @@ description: "Learn more about: Type-Safe Access to Controls With Code Wizards" title: "Type-Safe Access to Controls With Code Wizards" ms.date: "11/04/2016" helpviewer_keywords: ["DDX (dialog data exchange), access to controls", "code wizards", "dialog boxes [MFC], access to controls", "dialog box controls [MFC], accessing"] -ms.assetid: b8874393-ee48-4124-8d78-e3648a7e29b9 --- # Type-Safe Access to Controls With Code Wizards +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you are familiar with DDX features, you can use the Control property in the [Add Member Variable Wizard](../ide/adding-a-member-variable-visual-cpp.md#add-member-variable-wizard) to create type-safe access. This approach is easier than creating controls without code wizards. If you simply want access to a control's value, DDX provides it. If you want to do more than access a control's value, use the Add Member Variable Wizard to add a member variable of the appropriate class to your dialog class. Attach this member variable to the Control property. diff --git a/docs/mfc/type-safe-access-to-controls-without-code-wizards.md b/docs/mfc/type-safe-access-to-controls-without-code-wizards.md index 6783fcc6296..613307d7c10 100644 --- a/docs/mfc/type-safe-access-to-controls-without-code-wizards.md +++ b/docs/mfc/type-safe-access-to-controls-without-code-wizards.md @@ -3,10 +3,12 @@ description: "Learn more about: Type-Safe Access to Controls Without Code Wizard title: "Type-Safe Access to Controls Without Code Wizards" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], accessing controls", "dialog box controls [MFC], accessing"] -ms.assetid: 325b4927-d49b-42b4-8e0b-fc84f31fb059 --- # Type-Safe Access to Controls Without Code Wizards +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The first approach to creating type-safe access to controls uses an inline member function to cast the return type of class `CWnd`'s `GetDlgItem` member function to the appropriate C++ control type, as in this example: [!code-cpp[NVC_MFCControlLadenDialog#50](../mfc/codesnippet/cpp/type-safe-access-to-controls-without-code-wizards_1.cpp)] diff --git a/docs/mfc/types-of-image-lists.md b/docs/mfc/types-of-image-lists.md index 3ed02c1d59a..d93ce25d1c3 100644 --- a/docs/mfc/types-of-image-lists.md +++ b/docs/mfc/types-of-image-lists.md @@ -3,10 +3,12 @@ description: "Learn more about: Types of Image Lists" title: "Types of Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["lists [MFC], image", "image lists [MFC], types of", "CImageList class [MFC], types"] -ms.assetid: bee5e7c3-78f5-4037-a136-9c50d67cdee5 --- # Types of Image Lists +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + There are two types of image lists ([CImageList](../mfc/reference/cimagelist-class.md)): nonmasked and masked. A "nonmasked image list" consists of a color bitmap that contains one or more images. A "masked image list" consists of two bitmaps of equal size. The first is a color bitmap that contains the images, and the second is a monochrome bitmap that contains a series of masks — one for each image in the first bitmap. One of the overloads of the `Create` member function takes a flag to indicate whether or not the image list is masked. (The other overloads create masked image lists.) diff --git a/docs/mfc/updating-the-text-of-a-status-bar-pane.md b/docs/mfc/updating-the-text-of-a-status-bar-pane.md index 1954167790e..e77e2921ab3 100644 --- a/docs/mfc/updating-the-text-of-a-status-bar-pane.md +++ b/docs/mfc/updating-the-text-of-a-status-bar-pane.md @@ -3,11 +3,13 @@ description: "Learn more about: Updating the Text of a Status-Bar Pane" title: "Updating the Text of a Status-Bar Pane" ms.date: "11/04/2016" helpviewer_keywords: ["updating user interface objects [MFC]", "ON_UPDATE_COMMAND_UI macro [MFC]", "user interface objects [MFC], updating", "text, status bar", "CStatusBar class [MFC], updating", "SetText method [MFC]", "panes, status bar", "status bars [MFC], updating"] -ms.assetid: 4984a3f4-9905-4d8c-a927-dca19781053b ms.topic: how-to --- # Updating the Text of a Status-Bar Pane +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to change the text that appears in an MFC status bar pane. A status bar — a window object of class [CStatusBar](../mfc/reference/cstatusbar-class.md) — contains several "panes." Each pane is a rectangular area of the status bar that you can use to display information. For example, many applications display the status of the CAPS LOCK, NUM LOCK, and other keys in the rightmost panes. Applications also often display informative text in the leftmost pane (pane 0), sometimes called the "message pane." For example, the default MFC status bar uses the message pane to display a string explaining the currently selected menu item or toolbar button. The figure in [Status Bars](../mfc/status-bar-implementation-in-mfc.md) shows a status bar from an Application Wizard-created MFC application. By default, MFC does not enable a `CStatusBar` pane when it creates the pane. To activate a pane, you must use the ON_UPDATE_COMMAND_UI macro for each pane on the status bar and update the panes. Because panes do not send WM_COMMAND messages (they aren't like toolbar buttons), you must type the code manually. diff --git a/docs/mfc/upgrading-an-existing-activex-control.md b/docs/mfc/upgrading-an-existing-activex-control.md index a6038e41168..5af223c224e 100644 --- a/docs/mfc/upgrading-an-existing-activex-control.md +++ b/docs/mfc/upgrading-an-existing-activex-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Upgrading an Existing ActiveX Control" title: "Upgrading an Existing ActiveX Control" ms.date: 11/03/2021 helpviewer_keywords: ["ActiveX controls [MFC], Internet", "LPK files for Internet controls", "safe for scripting and initialization (controls)", "OLE controls [MFC], upgrading to ActiveX", "CAB files, for ActiveX controls", "Internet applications [MFC], ActiveX controls", "Internet applications [MFC], packaging code for download", "upgrading ActiveX controls", "licensing ActiveX controls"] -ms.assetid: 4d12ddfa-b491-4f9f-a0b7-b51458e05651 ms.topic: how-to --- # Upgrading an Existing ActiveX Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Existing ActiveX controls (formerly OLE controls) can be used on the Internet without modification. However, you may want to modify controls to improve their performance. > [!IMPORTANT] diff --git a/docs/mfc/user-defined-tools.md b/docs/mfc/user-defined-tools.md index 9f477181081..e29719954c4 100644 --- a/docs/mfc/user-defined-tools.md +++ b/docs/mfc/user-defined-tools.md @@ -3,10 +3,12 @@ description: "Learn more about: User-defined Tools" title: "User-defined Tools" ms.date: "11/19/2018" helpviewer_keywords: ["user-defined tools (MFC Extensions)"] -ms.assetid: cb887421-78ce-4652-bc67-96a53984ccaa --- # User-defined Tools +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC supports user-defined tools. A user-defined tool is a special command that executes an external, user-specified program. You can use the customization process to manage user-defined tools. However, you cannot use this process if your application object is not derived from [CWinAppEx Class](../mfc/reference/cwinappex-class.md). For more information about customization, see [Customization for MFC](../mfc/customization-for-mfc.md). If you enabled user-defined tools support, the customization dialog box automatically includes the **Tools** tab. The following illustration shows the **Tools** page. diff --git a/docs/mfc/user-interface-elements-mfc.md b/docs/mfc/user-interface-elements-mfc.md index a4c20c415e1..fb716052e9a 100644 --- a/docs/mfc/user-interface-elements-mfc.md +++ b/docs/mfc/user-interface-elements-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: User Interface Elements (MFC)" title: "User Interface Elements (MFC)" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, user interface", "user interfaces, creating", "user interfaces"] -ms.assetid: f5daf2c1-bc08-4b71-9b03-da2c0aab5764 --- # User Interface Elements (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + For information about how to create the user interface for your application by using the Microsoft Foundation Class (MFC) Library, see the following topics. ## In This Section diff --git a/docs/mfc/user-interface-objects-and-command-ids.md b/docs/mfc/user-interface-objects-and-command-ids.md index 25183aea048..ec45364b2e3 100644 --- a/docs/mfc/user-interface-objects-and-command-ids.md +++ b/docs/mfc/user-interface-objects-and-command-ids.md @@ -3,10 +3,12 @@ description: "Learn more about: User-Interface Objects and Command IDs" title: "User-Interface Objects and Command IDs" ms.date: "11/19/2018" helpviewer_keywords: ["keyboard shortcuts, associating with IDs", "MFC, command routing", "toolbar controls [MFC], command ID", "menu items, associating with IDs", "user interface objects [MFC], associating with IDs", "command IDs, user interface objects", "command routing [MFC], MFC", "command handling [MFC], user-interface objects"] -ms.assetid: 4ea19e9b-ed1e-452e-bd33-7f509107a45b --- # User-Interface Objects and Command IDs +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Menu items, toolbar buttons, and accelerator keys are "user-interface objects" capable of generating commands. Each such user-interface object has an ID. You associate a user-interface object with a command by assigning the same ID to the object and the command. As explained in [Messages](../mfc/messages.md), commands are implemented as special messages. The figure "Commands in the Framework" below shows how the framework manages commands. When a user-interface object generates a command, such as `ID_EDIT_CLEAR_ALL`, one of the objects in your application handles the command — in the figure below, the document object's `OnEditClearAll` function is called via the document's message map. ![Commands in the Framework.](../mfc/media/vc385p1.gif "Commands in the Framework")
diff --git a/docs/mfc/using-a-common-control-as-a-child-window.md b/docs/mfc/using-a-common-control-as-a-child-window.md index a6bb23d0b33..8e0cd9bb980 100644 --- a/docs/mfc/using-a-common-control-as-a-child-window.md +++ b/docs/mfc/using-a-common-control-as-a-child-window.md @@ -3,11 +3,13 @@ description: "Learn more about: Using a Common Control as a Child Window" title: "Using a Common Control as a Child Window" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], using as child windows", "windows [MFC], common controls as", "child windows [MFC], common controls as", "common controls [MFC], child windows", "Windows common controls [MFC], child windows"] -ms.assetid: 608f7d47-7854-4fce-bde9-856c51e76753 ms.topic: how-to --- # Using a Common Control as a Child Window +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Any of the Windows common controls can be used as a child window of any other window. The following procedure describes how to create a common control dynamically and then work with it. ### To use a common control as a child window diff --git a/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md b/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md index 896a649cbc1..d96d2431b8b 100644 --- a/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md +++ b/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Using a Dialog Bar with a Rebar Control" title: "Using a Dialog Bar with a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["WS_EX_TRANSPARENT style", "rebar controls [MFC], dialog bars", "dialog bars [MFC], using with rebar bands"] -ms.assetid: e528cea0-6b81-4bdf-9643-7c03b6176590 ms.topic: how-to --- # Using a Dialog Bar with a Rebar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + As mentioned in [Rebar Controls and Bands](../mfc/rebar-controls-and-bands.md), each band can contain only one child window (or control). This might be a limitation if you want to have more than one child window per band. A convenient workaround is to create a dialog bar resource with multiple controls and then add a rebar band (containing the dialog bar) to the rebar control. Normally, if you wanted the dialog bar band to appear transparent, you would set the WS_EX_TRANSPARENT extended style for the dialog bar object. However, because WS_EX_TRANSPARENT has some issues with properly painting the background of a dialog bar, you will need to do a little extra work to achieve the desired effect. diff --git a/docs/mfc/using-a-dialog-template-in-memory.md b/docs/mfc/using-a-dialog-template-in-memory.md index 2ebc1096f2c..5be7e52e6a5 100644 --- a/docs/mfc/using-a-dialog-template-in-memory.md +++ b/docs/mfc/using-a-dialog-template-in-memory.md @@ -3,11 +3,13 @@ description: "Learn more about: Using a Dialog Template in Memory" title: "Using a Dialog Template in Memory" ms.date: "11/04/2016" helpviewer_keywords: ["templates [MFC], for dialog boxes", "dialog templates [MFC]", "dialog templates [MFC], in memory", "MFC dialog boxes [MFC], dialog templates"] -ms.assetid: edb443bb-e614-4f77-8a3b-74d93871e9bd ms.topic: concept-article --- # Using a Dialog Template in Memory +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Instead of using the methods given in the [Dialog Creation table](../mfc/creating-a-dialog-class-with-code-wizards.md), you can create either kind of dialog box indirectly from a dialog template in memory. For more information, see class [CDialog](../mfc/reference/cdialog-class.md) in the *MFC Reference*. ## See also diff --git a/docs/mfc/using-a-hot-key-control.md b/docs/mfc/using-a-hot-key-control.md index ca29fb0d076..2ecb69d51f2 100644 --- a/docs/mfc/using-a-hot-key-control.md +++ b/docs/mfc/using-a-hot-key-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Using a Hot Key Control" title: "Using a Hot Key Control" ms.date: "11/04/2016" helpviewer_keywords: ["CHotKeyCtrl class [MFC], using", "hot key controls"] -ms.assetid: cdd6524b-cc43-447f-b151-164273559685 ms.topic: concept-article --- # Using a Hot Key Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Typical usage of a hot key control follows the pattern below: - The control is created. If the control is specified in a dialog box template, creation is automatic when the dialog box is created. (You should have a [CHotKeyCtrl](../mfc/reference/chotkeyctrl-class.md) member in your dialog class that corresponds to the hot key control.) Alternatively, you can use the [Create](../mfc/reference/chotkeyctrl-class.md#create) member function to create the control as a child window of any window. diff --git a/docs/mfc/using-an-animation-control.md b/docs/mfc/using-an-animation-control.md index ceff13db018..39919ad405b 100644 --- a/docs/mfc/using-an-animation-control.md +++ b/docs/mfc/using-an-animation-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Using an Animation Control" title: "Using an Animation Control" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], animation", "CAnimateCtrl class [MFC], animation controls", "animation controls [MFC]"] -ms.assetid: a009a464-e12d-4112-bf52-04a09b28dd88 ms.topic: concept-article --- # Using an Animation Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Typical usage of an animation control follows the pattern below: - The control is created. If the control is specified in a dialog box template, creation is automatic when the dialog box is created. (You should have a [CAnimateCtrl](../mfc/reference/canimatectrl-class.md) member in your dialog class that corresponds to the animation control.) Alternatively, you can use the [Create](../mfc/reference/canimatectrl-class.md#create) member function to create the control as a child window of any window. diff --git a/docs/mfc/using-an-image-list-with-a-rebar-control.md b/docs/mfc/using-an-image-list-with-a-rebar-control.md index 4384b1557b7..9e60de4bb38 100644 --- a/docs/mfc/using-an-image-list-with-a-rebar-control.md +++ b/docs/mfc/using-an-image-list-with-a-rebar-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Using an Image List with a Rebar Control" title: "Using an Image List with a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["image lists [MFC], rebar controls", "rebar controls [MFC], image lists"] -ms.assetid: 1a5836ac-019a-46aa-8741-b35c3376b839 ms.topic: how-to --- # Using an Image List with a Rebar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Each rebar band can contain, among other things, an image from an associated image list. The following procedure details the necessary steps for displaying an image in a rebar band. ### To display images in a rebar band diff --git a/docs/mfc/using-an-image-list.md b/docs/mfc/using-an-image-list.md index 7016e9dd277..5eac2d45cf2 100644 --- a/docs/mfc/using-an-image-list.md +++ b/docs/mfc/using-an-image-list.md @@ -3,11 +3,13 @@ description: "Learn more about: Using an Image List" title: "Using an Image List" ms.date: "11/04/2016" helpviewer_keywords: ["lists [MFC], image", "CImageList class [MFC], using", "image lists [MFC]"] -ms.assetid: e0aed188-a1e6-400e-9f51-033d61c5541f ms.topic: concept-article --- # Using an Image List +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Typical usage of an image list follows the pattern below: - Construct a [CImageList](../mfc/reference/cimagelist-class.md) object and call one of the overloads of its [Create](../mfc/reference/cimagelist-class.md#create) function to create an image list and attach it to the `CImageList` object. diff --git a/docs/mfc/using-an-unclipped-device-context.md b/docs/mfc/using-an-unclipped-device-context.md index 35bd4e6fa10..6e2d218703e 100644 --- a/docs/mfc/using-an-unclipped-device-context.md +++ b/docs/mfc/using-an-unclipped-device-context.md @@ -3,11 +3,13 @@ description: "Learn more about: Using an Unclipped Device Context" title: "Using an Unclipped Device Context" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], unclipped device context"] -ms.assetid: 9c020063-73da-4803-bf7b-2e1fd950c9ed ms.topic: concept-article --- # Using an Unclipped Device Context +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you are absolutely certain that your control does not paint outside its client rectangle, you can realize a small but detectable speed gain by disabling the call to `IntersectClipRect` that is made by `COleControl`. To do this, remove the *clipPaintDC* flag from the set of flags returned by [COleControl::GetControlFlags](../mfc/reference/colecontrol-class.md#getcontrolflags). For example: [!code-cpp[NVC_MFC_AxOpt#5](../mfc/codesnippet/cpp/using-an-unclipped-device-context_1.cpp)] diff --git a/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md b/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md index 34e4486769c..bc01e6ebe10 100644 --- a/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md +++ b/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md @@ -4,11 +4,13 @@ title: "Using Callback Fields in a Date and Time Picker Control" ms.date: "11/04/2016" f1_keywords: ["DTN_FORMATQUERY", "DTN_FORMAT"] helpviewer_keywords: ["DateTimePicker control [MFC], callback fields", "callback fields in CDateTimeCtrl class [MFC]", "CDateTimeCtrl class [MFC], callback fields", "CDateTimeCtrl class [MFC], handling DTN_FORMAT and DTN_FORMATQ", "DTN_FORMATQUERY notification [MFC]", "DTN_FORMAT notification [MFC]", "DateTimePicker control [MFC]"] -ms.assetid: 404f4ba9-cba7-4718-9faa-bc6b274a723f ms.topic: concept-article --- # Using Callback Fields in a Date and Time Picker Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In addition to the standard format characters that define date and time picker fields, you can customize your output by specifying certain parts of a custom format string as callback fields. To declare a callback field, include one or more "X" characters (ASCII Code 88) anywhere in the body of the format string. For example, the following string "'Today is: 'yy'/'MM'/'dd' (Day 'X')'"causes the date and time picker control to display the current value as the year followed by the month, date, and finally the day of the year. > [!NOTE] diff --git a/docs/mfc/using-canimatectrl.md b/docs/mfc/using-canimatectrl.md index 76302558736..f22e7a7519b 100644 --- a/docs/mfc/using-canimatectrl.md +++ b/docs/mfc/using-canimatectrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CAnimateCtrl" title: "Using CAnimateCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["animation controls [MFC], CAnimateCtrl class", "controls [MFC], animation", "CAnimateCtrl class [MFC], about CAnimateCtrl class [MFC]"] -ms.assetid: 696c0805-bef0-4e2e-a9e7-b37b9215b7f0 ms.topic: concept-article --- # Using CAnimateCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An animation control, represented by the class [CAnimateCtrl](../mfc/reference/canimatectrl-class.md), is a window that displays a clip in Audio Video Interleaved (AVI) format — the standard Windows video/audio format. An AVI clip is a series of bitmap frames, like a movie. Since your thread continues executing while the AVI clip is displayed, one common use for an animation control is to indicate system activity during a lengthy operation. For example, the Windows Find dialog box displays a moving magnifying glass as the system searches for a file. diff --git a/docs/mfc/using-ccomboboxex.md b/docs/mfc/using-ccomboboxex.md index a9c9fca4d11..bed47613510 100644 --- a/docs/mfc/using-ccomboboxex.md +++ b/docs/mfc/using-ccomboboxex.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CComboBoxEx" title: "Using CComboBoxEx" ms.date: "11/04/2016" helpviewer_keywords: ["combo boxes [MFC], extended", "extended combo boxes [MFC], about extended combo boxes", "combo boxes [MFC], CComboBoxEx class", "CComboBox class [MFC], extended"] -ms.assetid: c23cbfe8-75d2-4f98-a753-c942416eda52 ms.topic: concept-article --- # Using CComboBoxEx +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The extended combo box control is an extension of the standard combo box control that provides native support for item images. These images can be used to indicate the status of individual items in the combo box, such as the currently selected and unselected items. To make item images easily accessible, the control provides image list support. Use this control to provide the functionality of a combo box without having to manually draw item graphics. diff --git a/docs/mfc/using-cdatetimectrl.md b/docs/mfc/using-cdatetimectrl.md index 2a67477916f..de67e342135 100644 --- a/docs/mfc/using-cdatetimectrl.md +++ b/docs/mfc/using-cdatetimectrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CDateTimeCtrl" title: "Using CDateTimeCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC], CDateTimeCtrl class"] -ms.assetid: cb2a8720-43f1-4c33-a3a4-def9a1622e00 ms.topic: concept-article --- # Using CDateTimeCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The date and time picker control ([CDateTimeCtrl](../mfc/reference/cdatetimectrl-class.md)) implements an intuitive and recognizable method of entering or selecting a specific date. The main interface of the control is similar in functionality to a combo box. However, if the user expands the control, a month calendar control appears (by default), allowing the user to specify a particular date. When a date is chosen, the month calendar control automatically disappears. > [!NOTE] diff --git a/docs/mfc/using-cheaderctrl.md b/docs/mfc/using-cheaderctrl.md index acc495d5aa1..f2b2ef3eb29 100644 --- a/docs/mfc/using-cheaderctrl.md +++ b/docs/mfc/using-cheaderctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CHeaderCtrl" title: "Using CHeaderCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], using", "CHeaderCtrl class [MFC]"] -ms.assetid: fb3e512b-9539-43c4-a7e7-3fafd6d0706e ms.topic: concept-article --- # Using CHeaderCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use a header control, represented by class [CHeaderCtrl](../mfc/reference/cheaderctrl-class.md), to display column headers for a columnar list. For example, a header control would be useful for implementing column controls in a spreadsheet. The header control is usually divided into parts, called "header items," each bearing a title for the associated column of text or numbers. Depending on the styles you set, you can provide a number of direct ways for users to manipulate the header items. diff --git a/docs/mfc/using-chotkeyctrl.md b/docs/mfc/using-chotkeyctrl.md index 2d7022a2830..f3f757de784 100644 --- a/docs/mfc/using-chotkeyctrl.md +++ b/docs/mfc/using-chotkeyctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CHotKeyCtrl" title: "Using CHotKeyCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["keys, hot and CHotKeyCtrl", "CHotKeyCtrl class [MFC], using", "hot key controls"] -ms.assetid: 9b207117-d848-4224-8888-c3d197bb0c95 ms.topic: concept-article --- # Using CHotKeyCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A hot key control, represented by class [CHotKeyCtrl](../mfc/reference/chotkeyctrl-class.md), is a window that displays a text representation of the key combination the user types into it, such as CTRL+SHIFT+Q. It also maintains an internal representation of this key in the form of a virtual key code and a set of flags that represent the shift state. The hot key control does not actually set the hot key — doing that is up to your program. (For a list of standard virtual key codes, see Winuser.h.) Use a hot key control to get a user's input for which hot key to associate with a window or thread. Hot key controls are often used in dialog boxes, such as you might display when asking the user to assign a hot key. It is your program's responsibility to retrieve the values describing the hot key from the hot key control and to call the appropriate functions to associate the hot key with a window or thread. diff --git a/docs/mfc/using-cimagelist.md b/docs/mfc/using-cimagelist.md index 64daaad06c3..e9042469157 100644 --- a/docs/mfc/using-cimagelist.md +++ b/docs/mfc/using-cimagelist.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CImageList" title: "Using CImageList" ms.date: "11/04/2016" helpviewer_keywords: ["image list control", "CImageList class [MFC], using"] -ms.assetid: 3d2a909e-d641-46b7-aada-81cab1a29b41 ms.topic: concept-article --- # Using CImageList +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An image list, represented by class [CImageList](../mfc/reference/cimagelist-class.md), is a collection of same-sized images, each of which can be referred to by its index. Image lists are used to efficiently manage large sets of icons or bitmaps. Image lists are not themselves controls since they are not windows; however, they are used with several different types of controls, including list controls ([CListCtrl](../mfc/reference/clistctrl-class.md)), tree controls ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)), and tab controls ([CTabCtrl](../mfc/reference/ctabctrl-class.md)). All images in an image list are contained in a single, wide bitmap in screen-device format. An image list may also include a monochrome bitmap that contains masks used to draw images transparently (icon style). `CImageList` provides member functions that enable you to draw images, create and destroy image lists, add and remove images, replace images, merge images, and drag images. diff --git a/docs/mfc/using-clistctrl.md b/docs/mfc/using-clistctrl.md index 9381c761991..afb3b2c7928 100644 --- a/docs/mfc/using-clistctrl.md +++ b/docs/mfc/using-clistctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CListCtrl" title: "Using CListCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], using"] -ms.assetid: 20d6a5d6-8f07-4ddf-975f-ea2dfebcc835 ms.topic: concept-article --- # Using CListCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Use a list control to display any arrangement of icons with labels, as in File Explorer, or columnar lists of text, with or without icons. For a description of the four possible "views" (not to be confused with MFC views) you can have in a list control — icon view, small icon view, list view, and report view — see Views in the [CListCtrl](../mfc/reference/clistctrl-class.md) class overview. In some views, users can drag icons to different positions or edit icon labels. For example, see the right-hand pane in File Explorer, which uses a list control in a nondialog window. You can experiment with the available views in Explorer's View menu. diff --git a/docs/mfc/using-cmonthcalctrl.md b/docs/mfc/using-cmonthcalctrl.md index 270c33595c5..b61d0562f7e 100644 --- a/docs/mfc/using-cmonthcalctrl.md +++ b/docs/mfc/using-cmonthcalctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CMonthCalCtrl" title: "Using CMonthCalCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CMonthCalCtrl class [MFC], about CMonthCalCtrl class"] -ms.assetid: 2be0e8c2-ed03-4853-aea1-4461eba18611 ms.topic: concept-article --- # Using CMonthCalCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The month calendar control ([CMonthCalCtrl](../mfc/reference/cmonthcalctrl-class.md)) implements a calendar-like user interface. This provides the user with a very intuitive and recognizable method of entering or selecting a date. The control also provides the application with the means to obtain and set the date information in the control using existing data types. By default, the month calendar control displays the current day and month. However, the user is able to scroll to the previous and next months and select a specific month and/or year. > [!NOTE] diff --git a/docs/mfc/using-cobject.md b/docs/mfc/using-cobject.md index a528b36ec18..0b1071f2035 100644 --- a/docs/mfc/using-cobject.md +++ b/docs/mfc/using-cobject.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CObject" title: "Using CObject" ms.date: "11/04/2016" helpviewer_keywords: ["examples [MFC], CObject", "root base class for MFC", "derived classes [MFC], from CObject", "MFC, base class", "CObject class [MFC]"] -ms.assetid: d0cd19bb-2856-4b41-abbc-620fd64cb223 ms.topic: concept-article --- # Using CObject +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + [CObject](../mfc/reference/cobject-class.md) is the root base class for most of the Microsoft Foundation Class Library (MFC). The `CObject` class contains many useful features that you may want to incorporate into your own program objects, including serialization support, run-time class information, and object diagnostic output. If you derive your class from `CObject`, your class can exploit these `CObject` features. ## What do you want to do diff --git a/docs/mfc/using-common-controls-in-a-dialog-box.md b/docs/mfc/using-common-controls-in-a-dialog-box.md index d28c82e7536..e4d84c57642 100644 --- a/docs/mfc/using-common-controls-in-a-dialog-box.md +++ b/docs/mfc/using-common-controls-in-a-dialog-box.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Common Controls in a Dialog Box" title: "Using Common Controls in a Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["common controls [MFC], in dialog boxes", "dialog box controls [MFC], common controls", "Windows common controls [MFC], in dialog boxes"] -ms.assetid: 17713caf-09f8-484a-bf54-5f48bf09cce9 ms.topic: how-to --- # Using Common Controls in a Dialog Box +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Windows common controls can be used in [dialog boxes](../mfc/dialog-boxes.md), form views, record views, and any other window based on a dialog template. The following procedure, with minor changes, will work for forms as well. ## Procedures diff --git a/docs/mfc/using-cprogressctrl.md b/docs/mfc/using-cprogressctrl.md index 07121a9f076..db9747fac63 100644 --- a/docs/mfc/using-cprogressctrl.md +++ b/docs/mfc/using-cprogressctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CProgressCtrl" title: "Using CProgressCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["progress controls [MFC]", "CProgressCtrl class [MFC], using", "progress controls [MFC], CProgressCtrl", "progress controls [MFC], using"] -ms.assetid: 61473270-196b-41ab-bf2b-467f46673539 ms.topic: concept-article --- # Using CProgressCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use the progress control to indicate the progress of a lengthy operation. It is a rectangle that is gradually filled with the system highlight color as the operation progresses. The progress control is represented in MFC by class [CProgressCtrl](../mfc/reference/cprogressctrl-class.md). diff --git a/docs/mfc/using-crebarctrl.md b/docs/mfc/using-crebarctrl.md index ce1e299588f..4100cc50206 100644 --- a/docs/mfc/using-crebarctrl.md +++ b/docs/mfc/using-crebarctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CReBarCtrl" title: "Using CReBarCtrl" ms.date: "11/19/2018" helpviewer_keywords: ["child windows [MFC], rebar controls", "combo boxes [MFC], in rebar controls", "rebar controls"] -ms.assetid: 2c0aeec2-ffc3-44b8-97b5-0f56e116a338 ms.topic: concept-article --- # Using CReBarCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A rebar control acts as a container for child windows. These child windows, often other controls, are assigned to a rebar control band. A rebar control can contain one or more bands, with each band having any combination of a gripper bar, a bitmap, a text label, and a child window. However, bands cannot contain more than one child window. The following illustration shows a rebar control that has two bands. One contains a gripper bar, a text label ("Address"), and a combo box child window. The other band contains a gripper bar, a text label, and a flat toolbar (implemented with a child window). diff --git a/docs/mfc/using-cricheditctrl.md b/docs/mfc/using-cricheditctrl.md index 1d96ea63105..e53c1400f84 100644 --- a/docs/mfc/using-cricheditctrl.md +++ b/docs/mfc/using-cricheditctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CRichEditCtrl" title: "Using CRichEditCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["rich edit controls [MFC], using", "CRichEditCtrl class [MFC], using"] -ms.assetid: e400c6ed-563e-4d4c-ab3b-a3f0aa20273b ms.topic: concept-article --- # Using CRichEditCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A rich edit control is a window in which the user can enter and edit text. The text can be assigned character and paragraph formatting, and can include embedded OLE objects. The rich edit control is represented in MFC by the [CRichEditCtrl](../mfc/reference/cricheditctrl-class.md) class. ## What do you want to know more about diff --git a/docs/mfc/using-csliderctrl.md b/docs/mfc/using-csliderctrl.md index f4b91032146..0bcaefe6cb7 100644 --- a/docs/mfc/using-csliderctrl.md +++ b/docs/mfc/using-csliderctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CSliderCtrl" title: "Using CSliderCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CSliderCtrl class [MFC], using", "slider controls [MFC], using"] -ms.assetid: 242c7bcd-126e-4b9b-8f76-8082ad06fe73 ms.topic: concept-article --- # Using CSliderCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [CSliderCtrl](../mfc/reference/csliderctrl-class.md) class represents a slider control, which is also called a trackbar. A "slider control" is a window that contains a slider and optional tick marks. When the user moves the slider, using either the mouse or the arrow keys, the slider control sends notification messages to indicate the change. Slider controls are useful when you want the user to select a discrete value or a set of consecutive values in a range. For example, you might use a slider control to allow the user to set the repeat rate of the keyboard by moving the slider to a given tick mark. diff --git a/docs/mfc/using-cspinbuttonctrl.md b/docs/mfc/using-cspinbuttonctrl.md index 9a28599d04b..a34cbab66da 100644 --- a/docs/mfc/using-cspinbuttonctrl.md +++ b/docs/mfc/using-cspinbuttonctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CSpinButtonCtrl" title: "Using CSpinButtonCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["up-down controls [MFC], spin button control", "up-down controls", "spin button control", "CSpinButtonCtrl class [MFC], using"] -ms.assetid: a91db36b-e11e-42ef-8e89-51915cc486d2 ms.topic: concept-article --- # Using CSpinButtonCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The *spin button* control (also known as an *up-down* control) provides a pair of arrows that a user can click to adjust a value. This value is known as the *current position*. The position stays within the range of the spin button. When the user clicks the up arrow, the position moves toward the maximum; and when the user clicks the down arrow, the position moves toward the minimum. The spin button control is represented in MFC by the [CSpinButtonCtrl](../mfc/reference/cspinbuttonctrl-class.md) class. diff --git a/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md b/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md index daf703d6076..e1a227e63c5 100644 --- a/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md +++ b/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CStatusBarCtrl to Create a CStatusBarCtrl title: "Using CStatusBarCtrl to Create a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["status bar controls [MFC], creating", "CStatusBarCtrl class [MFC], creating"] -ms.assetid: 365c2b65-12de-49e6-9a2e-416c6ee10d60 ms.topic: how-to --- # Using CStatusBarCtrl to Create a CStatusBarCtrl Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Here is an example of a typical use of [CStatusBarCtrl](../mfc/reference/cstatusbarctrl-class.md): ### To use a status bar control with parts diff --git a/docs/mfc/using-cstatusbarctrl.md b/docs/mfc/using-cstatusbarctrl.md index 9cb57d6094d..3f547a0312b 100644 --- a/docs/mfc/using-cstatusbarctrl.md +++ b/docs/mfc/using-cstatusbarctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CStatusBarCtrl" title: "Using CStatusBarCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CStatusBarCtrl class [MFC], using", "status bar controls [MFC], about status bar controls"] -ms.assetid: 08b39f83-580d-439a-b93e-7ef9e2a5702a ms.topic: concept-article --- # Using CStatusBarCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use the status bar control ([CStatusBarCtrl](../mfc/reference/cstatusbarctrl-class.md)) to create a control window that reflects various kinds of status information about the application. The status window can be divided into parts that display more than one type of information. ## What do you want to know more about diff --git a/docs/mfc/using-ctabctrl.md b/docs/mfc/using-ctabctrl.md index 6d93b0163f0..ce3200242ed 100644 --- a/docs/mfc/using-ctabctrl.md +++ b/docs/mfc/using-ctabctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CTabCtrl" title: "Using CTabCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CTabCtrl class [MFC], using", "tab controls [MFC], using"] -ms.assetid: 6bda6798-0085-4c09-a5ea-fe0e97af5c95 ms.topic: concept-article --- # Using CTabCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A "tab control" is analogous to the dividers in a notebook or the labeled folders in a file cabinet. Use the tab control, represented by class [CTabCtrl](../mfc/reference/ctabctrl-class.md), to show multiple pages of information or controls to a user, one at a time, in a format that suggests a peer or logical relationship between each page. For more information on tab controls, see [Tab Controls](/windows/win32/Controls/tab-controls) in the Windows SDK. diff --git a/docs/mfc/using-ctoolbarctrl.md b/docs/mfc/using-ctoolbarctrl.md index 51e7fb244bb..0322ea45f27 100644 --- a/docs/mfc/using-ctoolbarctrl.md +++ b/docs/mfc/using-ctoolbarctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CToolBarCtrl" title: "Using CToolBarCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CToolBarCtrl class [MFC]", "toolbar controls [MFC], creating"] -ms.assetid: 13cf3753-135b-4a3e-a850-ed30177fcf9d ms.topic: concept-article --- # Using CToolBarCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use the toolbar control ([CToolBarCtrl](../mfc/reference/ctoolbarctrl-class.md)) to create a control window containing buttons and optional spaces. Each button in the toolbar control window sends a command message to the parent window as the user chooses it. Typically, the buttons in a toolbar correspond to items in the application's menu, providing an additional and more direct way for the user to access an application's commands. ## What do you want to know more about diff --git a/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md b/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md index 8bb04ae8078..8dc58397f7d 100644 --- a/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md +++ b/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CToolTipCtrl to Create and Manipulate a CT title: "Using CToolTipCtrl to Create and Manipulate a CToolTipCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["tool tips [MFC], creating", "CToolTipCtrl class [MFC], using"] -ms.assetid: 0a34583f-f66d-46a1-a239-31b80ea395ad ms.topic: how-to --- # Using CToolTipCtrl to Create and Manipulate a CToolTipCtrl Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Here is an example of [CToolTipCtrl](../mfc/reference/ctooltipctrl-class.md) usage: ### To create and manipulate a CToolTipCtrl diff --git a/docs/mfc/using-ctooltipctrl.md b/docs/mfc/using-ctooltipctrl.md index 88c9dd0e09b..bacc499c4bd 100644 --- a/docs/mfc/using-ctooltipctrl.md +++ b/docs/mfc/using-ctooltipctrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CToolTipCtrl" title: "Using CToolTipCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CToolTipCtrl class [MFC], creating tool tips", "CToolTipCtrl class"] -ms.assetid: 8fc58a04-4792-4223-a092-d349d11344da ms.topic: concept-article --- # Using CToolTipCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The [CToolTipCtrl](../mfc/reference/ctooltipctrl-class.md) class encapsulates the functionality of a tool tip control, a small pop-up window that displays a single line of text describing the purpose of a tool in an application. A tool tip is hidden most of the time, appearing only when the user puts the cursor on a tool and leaves it there for approximately one-half second. The tool tip appears near the cursor and disappears when the user clicks a mouse button or moves the cursor off of the tool. ## What do you want to know more about diff --git a/docs/mfc/using-ctreectrl.md b/docs/mfc/using-ctreectrl.md index 18651d78c16..8d379b429ba 100644 --- a/docs/mfc/using-ctreectrl.md +++ b/docs/mfc/using-ctreectrl.md @@ -3,11 +3,13 @@ description: "Learn more about: Using CTreeCtrl" title: "Using CTreeCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CTreeCtrl class [MFC], about CTreeCtrl", "tree controls [MFC], using"] -ms.assetid: 6a262f2c-3540-43e5-b03f-e4b6f9cb0325 ms.topic: concept-article --- # Using CTreeCtrl +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A tree control, represented by the class [CTreeCtrl](../mfc/reference/ctreectrl-class.md), is a window that displays a hierarchical list of items, such as the headings in a document, the entries in an index, or the files and directories on a disk. Each item consists of a label and an optional bitmapped image, and each item can have a list of subitems associated with it. By clicking an item, the user can expand and collapse the associated list of subitems. The directory tree in the left-hand pane of File Explorer is an example of a tree control. ## What do you want to know more about diff --git a/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md b/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md index 0137fffce30..1c22a9078aa 100644 --- a/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md +++ b/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Custom Format Strings in a Date and Time P title: "Using Custom Format Strings in a Date and Time Picker Control" ms.date: "11/04/2016" helpviewer_keywords: ["CDateTimeCtrl class [MFC], display styles", "DateTimePicker control [MFC], display styles", "DateTimePicker control [MFC]"] -ms.assetid: 7d577f03-6ca0-4597-9093-50b78f304719 ms.topic: concept-article --- # Using Custom Format Strings in a Date and Time Picker Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + By default, date and time picker controls provide three format types (each format corresponding to a unique style) for displaying the current date or time: - **DTS_LONGDATEFORMAT** Displays the date in long format, producing output like "Wednesday, January 3, 2000". diff --git a/docs/mfc/using-documents.md b/docs/mfc/using-documents.md index 73f97283a24..f975b3b9f94 100644 --- a/docs/mfc/using-documents.md +++ b/docs/mfc/using-documents.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Documents" title: "Using Documents" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], C++ applications", "data [MFC], reading", "documents [MFC]", "files [MFC], writing to", "data [MFC], documents", "files [MFC]", "views [MFC], C++ applications", "document/view architecture [MFC], documents", "reading data [MFC], documents and views", "printing [MFC], documents", "writing to files [MFC]"] -ms.assetid: f390d6d8-d0e1-4497-9b6a-435f7ce0776c ms.topic: concept-article --- # Using Documents +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Working together, documents and views: - Contain, manage, and display your application-specific [data](../mfc/managing-data-with-document-data-variables.md). diff --git a/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md b/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md index 86403dd5c23..10ebb0f4aa4 100644 --- a/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md +++ b/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md @@ -4,11 +4,13 @@ title: "Using Drop-Down Buttons in a Toolbar Control" ms.date: "11/04/2016" f1_keywords: ["TBN_DROPDOWN", "TBSTYLE_EX_DRAWDDARROWS"] helpviewer_keywords: ["CToolBarCtrl class [MFC], drop-down buttons", "toolbars [MFC], drop-down buttons", "drop-down buttons in toolbars", "TBSTYLE_EX_DRAWDDARROWS", "TBN_DROPDOWN notification [MFC]"] -ms.assetid: b859f758-d2f6-40d9-9c26-0ff61993b9b2 ms.topic: how-to --- # Using Drop-Down Buttons in a Toolbar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In addition to standard push buttons, a toolbar can also have drop-down buttons. A drop-down button is usually indicated by the presence of an attached down arrow. > [!NOTE] diff --git a/docs/mfc/using-frame-windows.md b/docs/mfc/using-frame-windows.md index 39440816e66..dc593d3783f 100644 --- a/docs/mfc/using-frame-windows.md +++ b/docs/mfc/using-frame-windows.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Frame Windows" title: "Using Frame Windows" ms.date: "11/04/2016" helpviewer_keywords: ["windows [MFC], frame windows", "frame windows [MFC], using", "MFC, frame windows"] -ms.assetid: 4d773238-11f6-4ccf-8114-57310c5aaa2d ms.topic: concept-article --- # Using Frame Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The MFC framework creates document frame windows — and their views and documents — as part of its implementation of the New and Open commands on the File menu. Because the framework does most of the frame-window work for you, you play only a small role in creating, using, and destroying those windows. You can, however, explicitly create your own frame windows and child windows for special purposes. ## What do you want to know more about diff --git a/docs/mfc/using-image-lists-in-a-toolbar-control.md b/docs/mfc/using-image-lists-in-a-toolbar-control.md index 5b280fa57e3..c8dd09a333f 100644 --- a/docs/mfc/using-image-lists-in-a-toolbar-control.md +++ b/docs/mfc/using-image-lists-in-a-toolbar-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Image Lists in a Toolbar Control" title: "Using Image Lists in a Toolbar Control" ms.date: "11/04/2016" helpviewer_keywords: ["toolbar controls [MFC], image", "image lists [MFC], toolbar controls", "CToolBarCtrl class [MFC], image lists"] -ms.assetid: ccbe8df4-4ed9-4b54-bb93-9a1dcb3b97eb ms.topic: concept-article --- # Using Image Lists in a Toolbar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + By default, the images used by the buttons in a toolbar control are stored as a single bitmap. However, you can also store button images in a set of image lists. The toolbar control object can use up to three separate image lists: - Enabled image list Contains images for toolbar buttons that are currently enabled. diff --git a/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md b/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md index 4060970825c..4c3c8a928e5 100644 --- a/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md +++ b/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Image Lists in an Extended Combo Box Contr title: "Using Image Lists in an Extended Combo Box Control" ms.date: "11/04/2016" helpviewer_keywords: ["image lists [MFC], combo boxes", "extended combo boxes [MFC], images", "images [MFC], combo box items"] -ms.assetid: dfff25fe-af70-47a2-8032-3901d1e6842d ms.topic: how-to --- # Using Image Lists in an Extended Combo Box Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The main feature of extended combo box controls is the ability to associate images from an image list with individual items in a combo box control. Each item is able to display three different images: one for its selected state, one for its nonselected state, and a third for an overlay image. The following procedure associates an image list with an extended combo box control: diff --git a/docs/mfc/using-image-lists-with-header-controls.md b/docs/mfc/using-image-lists-with-header-controls.md index 830297f5a5f..76ea9410dc0 100644 --- a/docs/mfc/using-image-lists-with-header-controls.md +++ b/docs/mfc/using-image-lists-with-header-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Image Lists with Header Controls" title: "Using Image Lists with Header Controls" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], image lists", "CHeaderCtrl class [MFC], image lists", "image lists [MFC], header controls"] -ms.assetid: d5e9b310-6278-406c-909c-eefa09549a47 ms.topic: how-to --- # Using Image Lists with Header Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Header items have the ability to display an image within a header item. This image, stored in an associated image list, is 16 x 16 pixels and has the same characteristics as the icon images used in a list view control. In order to implement this behavior successfully, you must first create and initialize the image list, associate the list with the header control, and then modify the attributes of the header item that will display the image. The following procedure illustrates the details, using a pointer to a header control (`m_pHdrCtrl`) and a pointer to an image list (`m_pHdrImages`). diff --git a/docs/mfc/using-property-sheets-in-your-application.md b/docs/mfc/using-property-sheets-in-your-application.md index e3dc0d6e6b8..dd89bad3850 100644 --- a/docs/mfc/using-property-sheets-in-your-application.md +++ b/docs/mfc/using-property-sheets-in-your-application.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Property Sheets in Your Application" title: "Using Property Sheets in Your Application" ms.date: "11/04/2016" helpviewer_keywords: ["dialog templates [MFC], property sheets", "dialog resources", "property pages [MFC], property sheets", "DoModal method property sheets", "AddPage method [MFC]", "property sheets, about property sheets", "Create method [MFC], property sheets", "CPropertyPage class [MFC], styles"] -ms.assetid: 240654d4-152b-4e3f-af7b-44234339206e ms.topic: how-to --- # Using Property Sheets in Your Application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To use a property sheet in your application, complete the following steps: 1. Create a dialog template resource for each property page. Keep in mind that the user may be switching from one page to another, so lay out each page as consistently as possible. diff --git a/docs/mfc/using-slider-controls.md b/docs/mfc/using-slider-controls.md index 2c970e4c5b0..52555ecbd5d 100644 --- a/docs/mfc/using-slider-controls.md +++ b/docs/mfc/using-slider-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Slider Controls" title: "Using Slider Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CSliderCtrl class [MFC], using", "slider controls", "slider controls [MFC], using"] -ms.assetid: 2b1a8ac8-2b17-41e1-aa24-83c1fd737049 ms.topic: concept-article --- # Using Slider Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Typical usage of an slider control follows the pattern below: - The control is created. If the control is specified in a dialog box template, creation is automatic when the dialog box is created. (You should have a [CSliderCtrl](../mfc/reference/csliderctrl-class.md) member in your dialog class that corresponds to the slider control.) Alternatively, you can use the [Create](../mfc/reference/csliderctrl-class.md#create) member function to create the control as a child window of any window. diff --git a/docs/mfc/using-the-carchive-output-and-input-operators.md b/docs/mfc/using-the-carchive-output-and-input-operators.md index 533547cef5d..1f57ddc404c 100644 --- a/docs/mfc/using-the-carchive-output-and-input-operators.md +++ b/docs/mfc/using-the-carchive-output-and-input-operators.md @@ -3,11 +3,13 @@ description: "Learn more about: Using the CArchive << and >> Operators" title: "Using the CArchive << and >> Operators" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], loading from previously stored values", "CArchive class [MFC], storing and loading objects", "CArchive class [MFC], operators"] -ms.assetid: 56aef326-02dc-4992-8282-f0a4b78a064e ms.topic: how-to --- # Using the CArchive `<<` and `>>` Operators +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CArchive` provides <\< and >> operators for writing and reading simple data types as well as `CObject`s to and from a file. #### To store an object in a file via an archive diff --git a/docs/mfc/using-the-classes-to-write-applications-for-windows.md b/docs/mfc/using-the-classes-to-write-applications-for-windows.md index 26a4f9ebf3c..27b9d14cf40 100644 --- a/docs/mfc/using-the-classes-to-write-applications-for-windows.md +++ b/docs/mfc/using-the-classes-to-write-applications-for-windows.md @@ -3,11 +3,13 @@ description: "Learn more about: Using the Classes to Write Applications for Wind title: "Using the Classes to Write Applications for Windows" ms.date: "11/04/2016" helpviewer_keywords: ["Windows applications [MFC], MFC application framework", "MFC, application development", "applications [OLE], MFC application framework", "MFC ActiveX controls [MFC], creating", "OLE applications [MFC], MFC application framework", "database applications [MFC], creating"] -ms.assetid: 73f63470-857d-43dd-9a54-b38b7be0f1b7 ms.topic: concept-article --- # Using the Classes to Write Applications for Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Taken together, the classes in the Microsoft Foundation Class (MFC) Library make up an "application framework," on which you build an application for the Windows operating system. At a very general level, the framework defines the skeleton of an application and supplies standard user-interface implementations that can be placed onto the skeleton. Your job as programmer is to fill in the rest of the skeleton, which are those things that are specific to your application. You can get a head start by using the MFC Application Wizard to create the files for a very thorough starter application. You use the Visual Studio resource editors to design your user-interface elements visually, Class View commands to connect those elements to code, and the class library to implement your application-specific logic. Version 3.0 and later of the MFC framework supports programming for Win32 platforms, including Microsoft Windows 95 and later, and Windows NT versions 3.51 and later. MFC Win32 support includes multithreading. Use version 1.5*x* if you need to do 16-bit programming. diff --git a/docs/mfc/using-the-dialog-editor-to-add-controls.md b/docs/mfc/using-the-dialog-editor-to-add-controls.md index c5912c87f60..713ea777a5d 100644 --- a/docs/mfc/using-the-dialog-editor-to-add-controls.md +++ b/docs/mfc/using-the-dialog-editor-to-add-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Using the Dialog Editor to Add Controls" title: "Using the Dialog Editor to Add Controls" ms.date: "11/04/2016" helpviewer_keywords: ["Windows common controls [MFC], adding", "dialog box controls [MFC], adding to dialog boxes", "controls [MFC], adding to dialog boxes", "Dialog editor, creating controls", "common controls [MFC], adding"] -ms.assetid: d3f9f994-7e54-4656-a545-42c204557c36 ms.topic: concept-article --- # Using the Dialog Editor to Add Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you create your dialog-template resource with the [dialog editor](../windows/dialog-editor.md), you drag controls from a controls palette and drop them into the dialog box. This adds the specifications for that control type to the dialog-template resource. When you construct a dialog object and call its `Create` or `DoModal` member function, the framework creates a Windows control and places it in the dialog window on screen. You can instead [create controls by hand](../mfc/adding-controls-by-hand.md) if you want. This is more work. diff --git a/docs/mfc/using-the-mfc-source-files.md b/docs/mfc/using-the-mfc-source-files.md index 10c7f2d0fcc..ab89891084c 100644 --- a/docs/mfc/using-the-mfc-source-files.md +++ b/docs/mfc/using-the-mfc-source-files.md @@ -3,11 +3,13 @@ description: "Learn more about: Using the MFC source files" title: "Using the MFC source files" ms.date: "08/19/2019" helpviewer_keywords: ["public members", "source files", "MFC, source files", "MFC source files", "comments, MFC", "private member access", "protected member access", "source files, MFC"] -ms.assetid: 3230e8fb-3b69-4ddf-9538-365ac7ea5e72 ms.topic: concept-article --- # Using the MFC source files +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class (MFC) Library supplies full source code. Header files (.h) are in the *\atlmfc\include* directory. Implementation files (.cpp) are in the *\atlmfc\src\mfc* directory. This article explains the conventions that MFC uses to comment the various parts of each class, what these comments mean, and what you should expect to find in each section. The Visual Studio wizards use similar conventions for the classes that they create for you, and you'll probably find these conventions useful for your own code. diff --git a/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md b/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md index 2573a72f55c..acc70168491 100644 --- a/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md +++ b/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Tooltips in a CStatusBarCtrl Object" title: "Using Tooltips in a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["tool tips [MFC], using in status bars", "status bars [MFC], tool tips", "CStatusBarCtrl class [MFC], tool tips"] -ms.assetid: a77597a7-43ef-4b8f-87bc-a8ea1dc63dc3 ms.topic: how-to --- # Using Tooltips in a CStatusBarCtrl Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To enable tooltips for a status bar control, create the `CStatusBarCtrl` object with the SBT_TOOLTIPS style. > [!NOTE] diff --git a/docs/mfc/using-tree-controls.md b/docs/mfc/using-tree-controls.md index 9130eb9f032..e444398c798 100644 --- a/docs/mfc/using-tree-controls.md +++ b/docs/mfc/using-tree-controls.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Tree Controls" title: "Using Tree Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CTreeCtrl class [MFC], using", "tree controls [MFC], about tree controls"] -ms.assetid: 4e92941a-e477-4fb1-b1ce-4abeafbef1c1 ms.topic: concept-article --- # Using Tree Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Typical usage of a tree control ([CTreeCtrl](../mfc/reference/ctreectrl-class.md)) follows the pattern below: - The control is created. If the control is specified in a dialog box template or if you're using `CTreeView`, creation is automatic when the dialog box or view is created. If you want to create the tree control as a child window of some other window, use the [Create](../mfc/reference/ctreectrl-class.md#create) member function. diff --git a/docs/mfc/using-views.md b/docs/mfc/using-views.md index 2a3ce75afca..e83e30e8e11 100644 --- a/docs/mfc/using-views.md +++ b/docs/mfc/using-views.md @@ -3,11 +3,13 @@ description: "Learn more about: Using Views" title: "Using Views" ms.date: "11/04/2016" helpviewer_keywords: ["interacting with users and role of view class [MFC]", "drawing [MFC], data", "rendering data", "view classes [MFC], role in managing user interaction", "CView class [MFC], view architecture", "MFC, views", "views [MFC], using", "painting data", "user input [MFC], interpreting through view class [MFC]", "view classes [MFC], role in displaying application data"] -ms.assetid: dc3de6ad-5c64-4317-8f10-8bdcc38cdbd5 ms.topic: concept-article --- # Using Views +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The view's responsibilities are to display the document's data graphically to the user and to accept and interpret user input as operations on the document. Your tasks in writing your view class are to: - Write your view class's [OnDraw](../mfc/reference/cview-class.md#ondraw) member function, which renders the document's data. From 4536d5bfdc429ec0a35976b0876d95ce1a23ca1f Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 24 Feb 2026 12:07:42 -0800 Subject: [PATCH 1657/1799] Batch 13: update files (#6267) --- docs/mfc/using-your-old-toolbars.md | 4 +++- docs/mfc/view-classes-architecture.md | 4 +++- docs/mfc/view-classes-windows.md | 4 +++- docs/mfc/virtual-list-controls.md | 4 +++- docs/mfc/visualization-manager.md | 4 +++- .../mfc/walkthrough-adding-a-ctaskdialog-to-an-application.md | 3 +++ docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md | 4 +++- docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md | 4 +++- .../walkthrough-creating-a-ribbon-application-by-using-mfc.md | 4 +++- docs/mfc/walkthrough-putting-controls-on-toolbars.md | 3 +++ ...alkthrough-updating-the-mfc-scribble-application-part-1.md | 4 +++- ...alkthrough-updating-the-mfc-scribble-application-part-2.md | 4 +++- docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md | 4 +++- docs/mfc/walkthroughs-mfc.md | 4 +++- .../what-does-it-cost-me-to-derive-a-class-from-cobject-q.md | 4 +++- docs/mfc/what-frame-windows-do.md | 4 +++- docs/mfc/what-is-a-carchive-object.md | 4 +++- docs/mfc/when-to-initialize-cwnd-objects.md | 4 +++- docs/mfc/when-update-handlers-are-called.md | 4 +++- docs/mfc/where-to-find-message-maps.md | 4 +++- docs/mfc/win32-internet-classes.md | 4 +++- docs/mfc/win32-internet-extensions-wininet.md | 4 +++- docs/mfc/window-destruction-sequence.md | 4 +++- docs/mfc/window-dialog-and-control-classes.md | 4 +++- docs/mfc/window-objects.md | 4 +++- docs/mfc/window-procedure-entry-points.md | 4 +++- docs/mfc/windows-sockets-background.md | 4 +++- docs/mfc/windows-sockets-blocking.md | 4 +++- docs/mfc/windows-sockets-byte-ordering.md | 4 +++- docs/mfc/windows-sockets-classes.md | 4 +++- docs/mfc/windows-sockets-converting-strings.md | 4 +++- docs/mfc/windows-sockets-datagram-sockets.md | 4 +++- docs/mfc/windows-sockets-deriving-from-socket-classes.md | 4 +++- docs/mfc/windows-sockets-example-of-sockets-using-archives.md | 3 +++ docs/mfc/windows-sockets-how-sockets-with-archives-work.md | 4 +++- docs/mfc/windows-sockets-in-mfc.md | 4 +++- docs/mfc/windows-sockets-ports-and-socket-addresses.md | 4 +++- docs/mfc/windows-sockets-sequence-of-operations.md | 4 +++- docs/mfc/windows-sockets-socket-notifications.md | 4 +++- docs/mfc/windows-sockets-stream-sockets.md | 4 +++- docs/mfc/windows-sockets-using-class-casyncsocket.md | 3 +++ docs/mfc/windows-sockets-using-sockets-with-archives.md | 4 +++- docs/mfc/windows-sockets.md | 4 +++- docs/mfc/windows.md | 4 +++- docs/mfc/wininet-basics.md | 4 +++- docs/mfc/wizards-and-the-resource-editors.md | 4 +++- docs/mfc/word-breaks-in-rich-edit-controls.md | 4 +++- docs/mfc/working-with-a-header-control.md | 4 +++- docs/mfc/working-with-a-tab-control.md | 4 +++- docs/mfc/working-with-the-toolbar-control.md | 4 +++- docs/mfc/working-with-window-objects.md | 4 +++- ...n-internet-client-application-using-mfc-wininet-classes.md | 4 +++- docs/mfc/writing-mfc-applications.md | 4 +++- docs/parallel/multithreading-with-cpp-and-mfc.md | 4 +++- 54 files changed, 162 insertions(+), 50 deletions(-) diff --git a/docs/mfc/using-your-old-toolbars.md b/docs/mfc/using-your-old-toolbars.md index 36e8fd1616e..8433410e874 100644 --- a/docs/mfc/using-your-old-toolbars.md +++ b/docs/mfc/using-your-old-toolbars.md @@ -4,11 +4,13 @@ title: "Using Your Old Toolbars" ms.date: "11/04/2016" f1_keywords: ["COldToolBar"] helpviewer_keywords: ["toolbars [MFC], backward compatibility", "COldToolBar class [MFC]"] -ms.assetid: 3543257c-8547-43f0-a66a-ee641dc1cf89 ms.topic: concept-article --- # Using Your Old Toolbars +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + If you have used previous versions of Visual Studio to create customized toolbars, the new implementation of class [CToolBar](../mfc/reference/ctoolbar-class.md) could cause you problems. So that you don't have to give up your old toolbars to use the new functionality, the old implementation is still supported. The DOCKTOOL sample does not use the old-style toolbars, only the new-style toolbars. diff --git a/docs/mfc/view-classes-architecture.md b/docs/mfc/view-classes-architecture.md index b49cc3c4ec7..3e5e53eedb3 100644 --- a/docs/mfc/view-classes-architecture.md +++ b/docs/mfc/view-classes-architecture.md @@ -3,10 +3,12 @@ description: "Learn more about: View Classes (Architecture)" title: "View Classes (Architecture)" ms.date: "09/17/2019" helpviewer_keywords: ["form and record views [MFC]", "view classes [MFC]", "control views [MFC]", "view classes [MFC], architecture"] -ms.assetid: 8894579a-1436-441e-b985-83711061e495 --- # View Classes (Architecture) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CView` and its derived classes are child windows that represent the client area of a frame window. Views show data and accept input for a document. A view class is associated with a document class and a frame window class using a document-template object. diff --git a/docs/mfc/view-classes-windows.md b/docs/mfc/view-classes-windows.md index 763e0ca629a..ebd9220138c 100644 --- a/docs/mfc/view-classes-windows.md +++ b/docs/mfc/view-classes-windows.md @@ -4,10 +4,12 @@ title: "View Classes (Windows)" ms.date: "09/17/2019" f1_keywords: ["vc.classes.view"] helpviewer_keywords: ["form and record views [MFC]", "splitter window classes [MFC]", "view classes [MFC], Windows"] -ms.assetid: b11683fb-9f43-4de3-9499-2b55775f9870 --- # View Classes (Windows) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + `CView` and its derived classes are child windows that represent the client area of a frame window. Views show data and accept input for a document. A view class is associated with a document class and a frame window class using a document-template object. diff --git a/docs/mfc/virtual-list-controls.md b/docs/mfc/virtual-list-controls.md index f2e9003efd4..311cac31958 100644 --- a/docs/mfc/virtual-list-controls.md +++ b/docs/mfc/virtual-list-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Virtual List Controls" title: "Virtual List Controls" ms.date: "11/04/2016" helpviewer_keywords: ["cache, virtual list control item data", "list controls [MFC], virtual", "list controls [MFC], List view", "virtual list controls"] -ms.assetid: 319f841f-e426-423a-8276-d93f965b0b45 --- # Virtual List Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A virtual list control is a list view control that has the LVS_OWNERDATA style. This style enables the control to support an item count up to a **DWORD** (the default item count only extends to an **`int`**). However, the biggest advantage provided by this style is the ability to only have a subset of data items in memory at any one time. This allows the virtual list view control to lend itself for use with large databases of information, where specific methods of accessing data are already in place. > [!NOTE] diff --git a/docs/mfc/visualization-manager.md b/docs/mfc/visualization-manager.md index b02e2a7bb43..3325a8136a0 100644 --- a/docs/mfc/visualization-manager.md +++ b/docs/mfc/visualization-manager.md @@ -3,10 +3,12 @@ description: "Learn more about: Visualization Manager" title: "Visualization Manager" ms.date: "11/19/2018" helpviewer_keywords: ["Visualization Manager"] -ms.assetid: c9dd1365-27ac-42e5-8caa-1004525b4129 --- # Visualization Manager +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The visual manager is an object that controls the appearance of a whole application. It acts as a single class where you can put all the drawing code for your application. The MFC Library includes several visual managers. You can also create your own visual manager if you want to create a custom view for your application. The following images show the same application when different visual managers are enabled: ![MyApp as rendered by CMFCVisualManagerWindows.](../mfc/media/vmwindows.png "MyApp as rendered by CMFCVisualManagerWindows")
diff --git a/docs/mfc/walkthrough-adding-a-ctaskdialog-to-an-application.md b/docs/mfc/walkthrough-adding-a-ctaskdialog-to-an-application.md index 1174ea2988d..22a01a8430a 100644 --- a/docs/mfc/walkthrough-adding-a-ctaskdialog-to-an-application.md +++ b/docs/mfc/walkthrough-adding-a-ctaskdialog-to-an-application.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["CTaskDialog, adding", "walkthroughs [MFC], dialogs"] --- # Walkthrough: Adding a CTaskDialog to an application +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This walkthrough introduces the [`CTaskDialog` class](../mfc/reference/ctaskdialog-class.md) and shows how to add it to your application. The `CTaskDialog` is a task dialog box that replaces the Windows message box in Windows Vista or later. The `CTaskDialog` improves on the original message box and adds functionality. The Windows message box is still supported in Visual Studio. diff --git a/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md b/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md index 2f3c6645ec7..f947e363ef4 100644 --- a/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md +++ b/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md @@ -3,10 +3,12 @@ description: "Learn more about: Walkthrough: Adding a D2D Object to an MFC Proje title: "Walkthrough: Adding a D2D Object to an MFC Project" ms.date: "04/25/2019" helpviewer_keywords: ["MFC, D2D", "D2D [MFC]"] -ms.assetid: dda36c33-c231-4da6-a62f-72d69a12b6dd --- # Walkthrough: Adding a D2D Object to an MFC Project +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This walkthrough teaches how to add a basic Direct2D (D2D) object to a Visual Studio, Microsoft Foundation Class Library (MFC) project, and then build the project into an application that prints "Hello, World!" on a gradient background. The walkthrough shows how to accomplish these tasks: diff --git a/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md b/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md index 203b4313782..8c7a5e4ed3c 100644 --- a/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md +++ b/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md @@ -3,10 +3,12 @@ description: "Learn more about: Walkthrough: Adding Animation to an MFC Project" title: "Walkthrough: Adding Animation to an MFC Project" ms.date: "04/25/2019" helpviewer_keywords: ["animation [MFC]", "MFC, animation"] -ms.assetid: 004f832c-9fd5-4f88-9ca9-ae65dececdc2 --- # Walkthrough: Adding Animation to an MFC Project +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This walkthrough teaches how to add a basic animated object to a Visual Studio, Microsoft Foundation Class Library (MFC) project. The walkthrough shows how to accomplish these tasks: diff --git a/docs/mfc/walkthrough-creating-a-ribbon-application-by-using-mfc.md b/docs/mfc/walkthrough-creating-a-ribbon-application-by-using-mfc.md index 6421813b892..68f02ff75c1 100644 --- a/docs/mfc/walkthrough-creating-a-ribbon-application-by-using-mfc.md +++ b/docs/mfc/walkthrough-creating-a-ribbon-application-by-using-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Walkthrough: Creating a Ribbon Application By Us title: "Walkthrough: Creating a Ribbon Application By Using MFC" ms.date: "09/09/2019" helpviewer_keywords: ["ribbon application, creating (MFC)", "creating a ribbon application (MFC)"] -ms.assetid: e61393e2-1d6b-4594-a7ce-157d3d1b0d9f --- # Walkthrough: Creating a Ribbon Application By Using MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This walkthrough shows how to use the **MFC Application Wizard** to create an application that has a ribbon by default. You can then expand the ribbon by adding a **Custom** ribbon category that has a **Favorites** ribbon panel, and then adding some frequently used commands to the panel. ## Prerequisites diff --git a/docs/mfc/walkthrough-putting-controls-on-toolbars.md b/docs/mfc/walkthrough-putting-controls-on-toolbars.md index 2d3962ab8c2..9688e8d6d59 100644 --- a/docs/mfc/walkthrough-putting-controls-on-toolbars.md +++ b/docs/mfc/walkthrough-putting-controls-on-toolbars.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["Customize dialog box, adding controls", "toolbars [MFC], --- # Walkthrough: Putting Controls On Toolbars +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes how to add a toolbar button that contains a Windows control to a toolbar. In MFC, a toolbar button must be a [`CMFCToolBarButton` Class](reference/cmfctoolbarbutton-class.md)-derived class, for example [`CMFCToolBarComboBoxButton` Class](reference/cmfctoolbarcomboboxbutton-class.md), [`CMFCToolBarEditBoxButton` Class](reference/cmfctoolbareditboxbutton-class.md), [`CMFCDropDownToolbarButton` Class](reference/cmfcdropdowntoolbarbutton-class.md), or [`CMFCToolBarMenuButton` Class](reference/cmfctoolbarmenubutton-class.md). ## Adding Controls to Toolbars diff --git a/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-1.md b/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-1.md index 6a37a8bff6a..0df6ca00842 100644 --- a/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-1.md +++ b/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-1.md @@ -3,10 +3,12 @@ description: "Learn more about: Walkthrough: Updating the MFC Scribble Applicati title: "Walkthrough: Updating the MFC Scribble Application (Part 1)" ms.date: "09/09/2019" helpviewer_keywords: ["examples [MFC], update existing application", "ribbon UI, porting to", "Office Fluent UI, porting to", "samples [MFC], update existing application", "MFC Feature Pack, update existing application", "walkthroughs [MFC], update existing application"] -ms.assetid: aa6330d3-6cfc-4c79-8fcb-0282263025f7 --- # Walkthrough: Updating the MFC Scribble Application (Part 1) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This walkthrough demonstrates how to modify an existing MFC application to use the Ribbon user interface. Visual Studio supports both the Office 2007 Ribbon and the Windows 7 Scenic Ribbon. For more information about the Ribbon user interface, see [Ribbons](/windows/win32/uxguide/cmd-ribbons). This walkthrough modifies the classic Scribble 1.0 MFC sample that lets you use the mouse to create line drawings. This part of the walkthrough shows how to modify the Scribble sample so that it displays a ribbon bar. [Part 2](../mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md) adds more buttons to the ribbon bar. diff --git a/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md b/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md index 19b88357d9d..81cb6c4023a 100644 --- a/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md +++ b/docs/mfc/walkthrough-updating-the-mfc-scribble-application-part-2.md @@ -3,10 +3,12 @@ description: "Learn more about: Walkthrough: Updating the MFC Scribble Applicati title: "Walkthrough: Updating the MFC Scribble Application (Part 2)" ms.date: "04/25/2019" helpviewer_keywords: ["walkthroughs [MFC]"] -ms.assetid: 602df5c2-17d4-4cd9-8cf6-dff652c4cae5 --- # Walkthrough: Updating the MFC Scribble Application (Part 2) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + [Part 1](../mfc/walkthrough-updating-the-mfc-scribble-application-part-1.md) of this walkthrough showed how to add an Office Fluent Ribbon to the classic Scribble application. This part shows how to add ribbon panels and controls that users can use instead of menus and commands. ## Prerequisites diff --git a/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md b/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md index 35d503d1884..7b82b7990a9 100644 --- a/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md +++ b/docs/mfc/walkthrough-using-the-new-mfc-shell-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Walkthrough: Using the New MFC Shell Controls" title: "Walkthrough: Using the New MFC Shell Controls" ms.date: 10/27/2021 helpviewer_keywords: ["shell controls (MFC)"] -ms.assetid: f0015caa-199d-4aaf-9501-5a239fce9095 --- # Walkthrough: Using the New MFC Shell Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In this walkthrough, you'll create an application that resembles File Explorer. You'll create a window that has two panes. The left pane will hold a [CMFCShellTreeCtrl](../mfc/reference/cmfcshelltreectrl-class.md) object that displays your Desktop in a hierarchical view. The right pane will hold a [CMFCShellListCtrl](../mfc/reference/cmfcshelllistctrl-class.md) that shows the files in the folder that is selected in the left pane. ## Prerequisites diff --git a/docs/mfc/walkthroughs-mfc.md b/docs/mfc/walkthroughs-mfc.md index a286a742aec..d5c6bf20893 100644 --- a/docs/mfc/walkthroughs-mfc.md +++ b/docs/mfc/walkthroughs-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Walkthroughs (MFC)" title: "Walkthroughs (MFC)" ms.date: "09/20/2018" helpviewer_keywords: ["MFC Feature Pack, walkthroughs"] -ms.assetid: 20d5756f-ad58-46f4-8b6c-c7a1020b72eb --- # Walkthroughs (MFC) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This section contains articles that walk you through various tasks associated with new MFC library features. ## In This Section diff --git a/docs/mfc/what-does-it-cost-me-to-derive-a-class-from-cobject-q.md b/docs/mfc/what-does-it-cost-me-to-derive-a-class-from-cobject-q.md index 5aedcbf9840..6f32909aa5b 100644 --- a/docs/mfc/what-does-it-cost-me-to-derive-a-class-from-cobject-q.md +++ b/docs/mfc/what-does-it-cost-me-to-derive-a-class-from-cobject-q.md @@ -3,10 +3,12 @@ description: "Learn more about: What Does it Cost me to Derive a Class from CObj title: "What Does it Cost me to Derive a Class from CObject?" ms.date: "11/04/2016" helpviewer_keywords: ["CObject class [MFC], overhead of derived classes [MFC]"] -ms.assetid: 9b92c98b-b3dd-48a7-9d24-c3b8554edf90 --- # What Does it Cost me to Derive a Class from CObject? +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The overhead in deriving from class [CObject](../mfc/reference/cobject-class.md) is minimal. Your derived class inherits only four virtual functions and a single [CRuntimeClass](../mfc/reference/cruntimeclass-structure.md) object. ## See also diff --git a/docs/mfc/what-frame-windows-do.md b/docs/mfc/what-frame-windows-do.md index 4949a47ade0..bb4c94ccf7a 100644 --- a/docs/mfc/what-frame-windows-do.md +++ b/docs/mfc/what-frame-windows-do.md @@ -3,10 +3,12 @@ description: "Learn more about: What Frame Windows Do" title: "What Frame Windows Do" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], about frame windows", "frame windows [MFC], tasks", "MFC, frame windows"] -ms.assetid: 1148a952-6786-4622-b5a8-68a2d7eae584 --- # What Frame Windows Do +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Besides simply framing a view, frame windows are responsible for numerous tasks involved in coordinating the frame with its view and with the application. [CMDIFrameWnd](../mfc/reference/cmdiframewnd-class.md) and [CMDIChildWnd](../mfc/reference/cmdichildwnd-class.md) inherit from [CFrameWnd](../mfc/reference/cframewnd-class.md), so they have `CFrameWnd` capabilities as well as new capabilities that they add. Examples of child windows include views, controls such as buttons and list boxes, and control bars, including toolbars, status bars, and dialog bars. The frame window is responsible for managing the layout of its child windows. In the MFC framework, a frame window positions any control bars, views, and other child windows inside its client area. diff --git a/docs/mfc/what-is-a-carchive-object.md b/docs/mfc/what-is-a-carchive-object.md index 69b0bdb75a6..07598d35a70 100644 --- a/docs/mfc/what-is-a-carchive-object.md +++ b/docs/mfc/what-is-a-carchive-object.md @@ -3,12 +3,14 @@ description: "Learn more about: What Is a CArchive Object" title: "What Is a CArchive Object" ms.date: "11/04/2016" helpviewer_keywords: ["archive objects [MFC]", "archives [MFC], for serialization", "buffers, serializable objects", "CArchive class [MFC], about CArchive class [MFC]", "buffering, serializable objects"] -ms.assetid: 843f1825-288d-4d89-a1fa-70e1f92d9b8b ms.custom: intro-overview ms.topic: concept-article --- # What Is a CArchive Object +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A `CArchive` object provides a type-safe buffering mechanism for writing or reading serializable objects to or from a `CFile` object. Usually the `CFile` object represents a disk file; however, it can also be a memory file (`CSharedFile` object), perhaps representing the Clipboard. A given `CArchive` object either stores (writes, serializes) data or loads (reads, deserializes) data, but never both. The life of a `CArchive` object is limited to one pass through writing objects to a file or reading objects from a file. Thus, two successively created `CArchive` objects are required to serialize data to a file and then deserialize it back from the file. diff --git a/docs/mfc/when-to-initialize-cwnd-objects.md b/docs/mfc/when-to-initialize-cwnd-objects.md index 4097208b0f6..88b6408936f 100644 --- a/docs/mfc/when-to-initialize-cwnd-objects.md +++ b/docs/mfc/when-to-initialize-cwnd-objects.md @@ -3,10 +3,12 @@ description: "Learn more about: When to Initialize CWnd Objects" title: "When to Initialize CWnd Objects" ms.date: "11/04/2016" helpviewer_keywords: ["window objects [MFC], when to initialize CWnd", "initializing CWnd objects [MFC]", "initializing objects [MFC], CWnd", "CWnd objects [MFC], when HWND is attached", "HWND, when attached to CWnd object", "CWnd objects [MFC], when to initialize"] -ms.assetid: 4d31bcb1-73db-4f2f-b71c-89b087569a10 --- # When to Initialize CWnd Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You cannot create your own child windows or call any Windows API functions in the constructor of a `CWnd`-derived object. This is because the `HWND` for the `CWnd` object has not been created yet. Most Windows-specific initialization, such as adding child windows, must be done in an [OnCreate](../mfc/reference/cwnd-class.md#oncreate) message handler. ## What do you want to know more about diff --git a/docs/mfc/when-update-handlers-are-called.md b/docs/mfc/when-update-handlers-are-called.md index 63558a68e37..ad527d5e48d 100644 --- a/docs/mfc/when-update-handlers-are-called.md +++ b/docs/mfc/when-update-handlers-are-called.md @@ -3,10 +3,12 @@ description: "Learn more about: When Update Handlers Are Called" title: "When Update Handlers Are Called" ms.date: "11/04/2016" helpviewer_keywords: ["updating user interface objects [MFC]", "command routing [MFC], update commands", "toolbar buttons [MFC], enabling", "disabling toolbar buttons", "menus [MFC], initializing", "update handlers [MFC]", "disabling menu items", "toolbars [MFC], updating", "menus [MFC], updating as context changes", "toolbar controls [MFC], updated during OnIdle method [MFC]", "menu items, enabling", "command routing [MFC], update handlers", "update handlers, calling"] -ms.assetid: 7359f6b1-4669-477d-bd99-690affed08d9 --- # When Update Handlers Are Called +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Suppose the user clicks the mouse in the File menu, which generates a WM_INITMENUPOPUP message. The framework's update mechanism collectively updates all items on the File menu before the menu drops down so the user can see it. To do this, the framework routes update commands for all menu items in the pop-up menu along the standard command routing. Command targets on the routing have an opportunity to update any menu items by matching the update command with an appropriate message-map entry (of the form `ON_UPDATE_COMMAND_UI`) and calling an "update handler" function. Thus, for a menu with six menu items, six update commands are sent out. If an update handler exists for the command ID of the menu item, it is called to do the updating. If not, the framework checks for the existence of a handler for that command ID and enables or disables the menu item as appropriate. diff --git a/docs/mfc/where-to-find-message-maps.md b/docs/mfc/where-to-find-message-maps.md index 2d4a1403aa2..5db17291298 100644 --- a/docs/mfc/where-to-find-message-maps.md +++ b/docs/mfc/where-to-find-message-maps.md @@ -3,10 +3,12 @@ description: "Learn more about: Where to Find Message Maps" title: "Where to Find Message Maps" ms.date: "11/04/2016" helpviewer_keywords: ["macros, message map", "locating message maps", "message classes [MFC], finding", "message-map macros"] -ms.assetid: bf59fbc8-b222-42d3-b5d3-0a79aa3cb923 --- # Where to Find Message Maps +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + When you create a new skeleton application with the Application Wizard, the Application Wizard writes a message map for each command-target class it creates for you. This includes your derived application, document, view, and frame-window classes. Some of these message maps already have the entries supplied by the Application Wizard for certain messages and predefined commands, and some are just placeholders for handlers that you will add. A class's message map is located in the .CPP file for the class. Working with the basic message maps that the Application Wizard creates, you use the [Class Wizard](reference/mfc-class-wizard.md) to add entries for the messages and commands that each class will handle. A typical message map might look like the following after you add some entries: diff --git a/docs/mfc/win32-internet-classes.md b/docs/mfc/win32-internet-classes.md index 218920d5438..f30bb06f4b3 100644 --- a/docs/mfc/win32-internet-classes.md +++ b/docs/mfc/win32-internet-classes.md @@ -4,10 +4,12 @@ title: "Win32 Internet Classes" ms.date: "09/12/2018" f1_keywords: ["vc.classes.win32"] helpviewer_keywords: ["Internet classes [MFC]", "WinInet classes [MFC], classes", "Win32 [MFC], Internet classes", "Windows API [MFC], Internet classes"] -ms.assetid: b49601d5-3025-4068-9408-316b54ee4375 --- # Win32 Internet Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC wraps the Win32 Internet (WinInet) and ActiveX technology to make Internet programming easier. >[!IMPORTANT] diff --git a/docs/mfc/win32-internet-extensions-wininet.md b/docs/mfc/win32-internet-extensions-wininet.md index 801fcbb1aca..63a5cba7c3f 100644 --- a/docs/mfc/win32-internet-extensions-wininet.md +++ b/docs/mfc/win32-internet-extensions-wininet.md @@ -3,10 +3,12 @@ description: "Learn more about: Win32 Internet Extensions (WinInet)" title: "Win32 Internet Extensions (WinInet)" ms.date: "11/04/2016" helpviewer_keywords: ["Internet applications [MFC], Win32 Internet Extensions", "Internet client applications [MFC], about Internet client applications", "client applications [MFC], Win32 Internet", "WinInet classes [MFC], about WinInet classes"] -ms.assetid: f8c80f0b-ce14-4f0d-a3cf-4f7d8c5cca59 --- # Win32 Internet Extensions (WinInet) +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + An Internet client application is a program that accesses information from a network data source (server) using Internet protocols such as gopher, FTP, or HTTP. An Internet client application might access a server to retrieve data such as weather maps, stock prices, or newspaper headlines, for example. The Internet client can access the server through an external network (the Internet) or an internal network (sometimes called an intranet). MFC includes the Win32 Internet Extensions, or WinInet, for creating an Internet client application. MFC encapsulates these Internet extensions in a set of standard, easy-to-use classes. You can write a WinInet client application by calling the Win32 functions directly or by using the MFC WinInet classes. diff --git a/docs/mfc/window-destruction-sequence.md b/docs/mfc/window-destruction-sequence.md index 7cc74192df7..24af36131b3 100644 --- a/docs/mfc/window-destruction-sequence.md +++ b/docs/mfc/window-destruction-sequence.md @@ -3,10 +3,12 @@ description: "Learn more about: Window Destruction Sequence" title: "Window Destruction Sequence" ms.date: "11/04/2016" helpviewer_keywords: ["destruction, windows", "destroying windows", "sequence [MFC], window destruction", "CWnd objects [MFC], destruction sequence", "sequence [MFC]", "windows [MFC], destroying"] -ms.assetid: 2d819196-6240-415f-a308-db43745e616c --- # Window Destruction Sequence +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + In the MFC framework, when the user closes the frame window, the window's default [OnClose](../mfc/reference/cwnd-class.md#onclose) handler calls [DestroyWindow](../mfc/reference/cwnd-class.md#destroywindow). The last member function called when the Windows window is destroyed is [OnNcDestroy](../mfc/reference/cwnd-class.md#onncdestroy), which does some cleanup, calls the [Default](../mfc/reference/cwnd-class.md#default) member function to perform Windows cleanup, and lastly calls the virtual member function [PostNcDestroy](../mfc/reference/cwnd-class.md#postncdestroy). The [CFrameWnd](../mfc/reference/cframewnd-class.md) implementation of `PostNcDestroy` deletes the C++ window object. ## What do you want to know more about diff --git a/docs/mfc/window-dialog-and-control-classes.md b/docs/mfc/window-dialog-and-control-classes.md index 9beece06877..730a6baea47 100644 --- a/docs/mfc/window-dialog-and-control-classes.md +++ b/docs/mfc/window-dialog-and-control-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Window, Dialog, and Control Classes" title: "Window, Dialog, and Control Classes" ms.date: "11/04/2016" helpviewer_keywords: ["windows [MFC], dialog and control classes"] -ms.assetid: b3610da6-9644-49b7-adbf-0e04f0d6d2b5 --- # Window, Dialog, and Control Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Class `CWnd` and its derived classes encapsulate an `HWND`, a handle to a Windows window. `CWnd` can be used by itself or as a base for deriving new classes. The derived classes supplied by the class library represent various kinds of windows. [CWnd](../mfc/reference/cwnd-class.md)
diff --git a/docs/mfc/window-objects.md b/docs/mfc/window-objects.md index a4f2924d5be..fc1929cb147 100644 --- a/docs/mfc/window-objects.md +++ b/docs/mfc/window-objects.md @@ -3,10 +3,12 @@ description: "Learn more about: Window Objects" title: "Window Objects" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], window", "Windows window [MFC]", "MFC, windows", "frame windows [MFC], C++ window objects", "window objects [MFC]", "windows [MFC], C++ window objects", "window messages [MFC]", "HWND", "messages [MFC], Windows", "Visual C++, window objects [MFC]", "HWND, window objects [MFC]"] -ms.assetid: 28b33ce2-af05-4617-9d03-1cb9a02be687 --- # Window Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + MFC supplies class [CWnd](../mfc/reference/cwnd-class.md) to encapsulate the `HWND` handle of a window. The `CWnd` object is a C++ window object, distinct from the `HWND` that represents a Windows window but containing it. Use `CWnd` to derive your own child window classes, or use one of the many MFC classes derived from `CWnd`. Class `CWnd` is the base class for all windows, including frame windows, dialog boxes, child windows, controls, and control bars such as toolbars. A good understanding of [the relationship between a C++ window object and an HWND](../mfc/relationship-between-a-cpp-window-object-and-an-hwnd.md) is crucial for effective programming with MFC. MFC provides some default functionality and management of windows, but you can derive your own class from `CWnd` and use its member functions to customize the provided functionality. You can create child windows by constructing a `CWnd` object and calling its [Create](../mfc/reference/cwnd-class.md#create) member function, then customize the child windows using `CWnd` member functions. You can embed objects derived from [CView](../mfc/reference/cview-class.md), such as form views or tree views, in a frame window. And you can support multiple views of your documents via splitter panes, supplied by class [CSplitterWnd](../mfc/reference/csplitterwnd-class.md). diff --git a/docs/mfc/window-procedure-entry-points.md b/docs/mfc/window-procedure-entry-points.md index 2655dd259f0..a56476482dd 100644 --- a/docs/mfc/window-procedure-entry-points.md +++ b/docs/mfc/window-procedure-entry-points.md @@ -3,10 +3,12 @@ description: "Learn more about: Window Procedure Entry Points" title: "Window Procedure Entry Points" ms.date: "11/04/2016" helpviewer_keywords: ["state management, window procedures", "MFC, managing state data", "window procedure entry points", "entry points, window procedures"] -ms.assetid: a6b46a7f-6e42-45f2-9ae6-82e19fc57148 --- # Window Procedure Entry Points +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + To protect MFC window procedures, a module static links with a special window procedure implementation. The linkage occurs automatically when the module is linked with MFC. This window procedure uses the AFX_MANAGE_STATE macro to properly set the effective module state, then it calls `AfxWndProc`, which in turn delegates to the `WindowProc` member function of the appropriate `CWnd`-derived object. ## See also diff --git a/docs/mfc/windows-sockets-background.md b/docs/mfc/windows-sockets-background.md index 8bb853e4102..26d496907f5 100644 --- a/docs/mfc/windows-sockets-background.md +++ b/docs/mfc/windows-sockets-background.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Background" title: "Windows Sockets: Background" ms.date: "11/04/2016" helpviewer_keywords: ["record-oriented data [MFC]", "e-mail [MFC]", "Internet Protocol Suite", "mail [MFC]", "communications [MFC], domain", "Windows Sockets [MFC], stream sockets", "mail [MFC], programming for", "sockets [MFC], stream sockets", "datagram sockets [MFC]", "SOCKET handle", "data types [MFC], socket", "e-mail [MFC], programming for", "X Window servers", "sequenced data flow", "stream sockets [MFC]"] -ms.assetid: f60d4ed2-bf23-4a0e-98d2-fee77e8473dd --- # Windows Sockets: Background +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the nature and purpose of Windows Sockets. The article also: - [Defines the term "socket"](#_core_definition_of_a_socket). diff --git a/docs/mfc/windows-sockets-blocking.md b/docs/mfc/windows-sockets-blocking.md index f0e50a171df..2c2d61ed2d6 100644 --- a/docs/mfc/windows-sockets-blocking.md +++ b/docs/mfc/windows-sockets-blocking.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Blocking" title: "Windows Sockets: Blocking" ms.date: "11/04/2016" helpviewer_keywords: ["sockets [MFC], blocking mode", "Windows Sockets [MFC], Windows platforms", "Windows Sockets [MFC], blocking mode", "sockets [MFC], behavior on different Windows platforms", "blocking mode sockets"] -ms.assetid: 10aca9b1-bfba-41a8-9c55-ea8082181e63 --- # Windows Sockets: Blocking +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article and two companion articles explain several issues in Windows Sockets programming. This article covers blocking. The other issues are covered in the articles: [Windows Sockets: Byte Ordering](../mfc/windows-sockets-byte-ordering.md) and [Windows Sockets: Converting Strings](../mfc/windows-sockets-converting-strings.md). If you use or derive from class [CAsyncSocket](../mfc/reference/casyncsocket-class.md), you will need to manage these issues yourself. If you use or derive from class [CSocket](../mfc/reference/csocket-class.md), MFC manages them for you. diff --git a/docs/mfc/windows-sockets-byte-ordering.md b/docs/mfc/windows-sockets-byte-ordering.md index fde1d2eed8e..d8b3e1a50ae 100644 --- a/docs/mfc/windows-sockets-byte-ordering.md +++ b/docs/mfc/windows-sockets-byte-ordering.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Byte Ordering" title: "Windows Sockets: Byte Ordering" ms.date: "11/04/2016" helpviewer_keywords: ["byte order issues in sockets programming", "sockets [MFC], byte order issues", "Windows Sockets [MFC], byte order issues"] -ms.assetid: 8a787a65-f9f4-4002-a02f-ac25a5dace5d --- # Windows Sockets: Byte Ordering +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article and two companion articles explain several issues in Windows Sockets programming. This article covers byte ordering. The other issues are covered in the articles: [Windows Sockets: Blocking](../mfc/windows-sockets-blocking.md) and [Windows Sockets: Converting Strings](../mfc/windows-sockets-converting-strings.md). If you use or derive from class [CAsyncSocket](../mfc/reference/casyncsocket-class.md), you will need to manage these issues yourself. If you use or derive from class [CSocket](../mfc/reference/csocket-class.md), MFC manages them for you. diff --git a/docs/mfc/windows-sockets-classes.md b/docs/mfc/windows-sockets-classes.md index c80ea097acb..0c0b8f257ec 100644 --- a/docs/mfc/windows-sockets-classes.md +++ b/docs/mfc/windows-sockets-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets Classes" title: "Windows Sockets Classes" ms.date: "11/04/2016" helpviewer_keywords: ["sockets classes [MFC]", "Windows Sockets [MFC], classes"] -ms.assetid: 58b9ab8d-9e44-4db3-8265-e04e713d2e9a --- # Windows Sockets Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Windows Sockets provide a network protocol-independent way to communicate between two computers. These sockets can be synchronous (your program waits until the communication is done) or asynchronous (your program continues running while the communication is going on). [CAsyncSocket](../mfc/reference/casyncsocket-class.md)
diff --git a/docs/mfc/windows-sockets-converting-strings.md b/docs/mfc/windows-sockets-converting-strings.md index 6afd8d49102..d7a439eb926 100644 --- a/docs/mfc/windows-sockets-converting-strings.md +++ b/docs/mfc/windows-sockets-converting-strings.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Converting Strings" title: "Windows Sockets: Converting Strings" ms.date: "11/04/2016" helpviewer_keywords: ["Windows Sockets [MFC], multibyte character string conversion", "sockets [MFC], multibyte character string conversion issues", "string conversion, multibyte character strings"] -ms.assetid: 9df522b5-6b23-41e0-bb96-e4e623baf141 --- # Windows Sockets: Converting Strings +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article and two companion articles explain several issues in Windows Sockets programming. This article covers converting strings. The other issues are covered in [Windows Sockets: Blocking](../mfc/windows-sockets-blocking.md) and [Windows Sockets: Byte Ordering](../mfc/windows-sockets-byte-ordering.md). If you use or derive from class [CAsyncSocket](../mfc/reference/casyncsocket-class.md), you will need to manage these issues yourself. If you use or derive from class [CSocket](../mfc/reference/csocket-class.md), MFC manages them for you. diff --git a/docs/mfc/windows-sockets-datagram-sockets.md b/docs/mfc/windows-sockets-datagram-sockets.md index b751ab84485..6382445c37f 100644 --- a/docs/mfc/windows-sockets-datagram-sockets.md +++ b/docs/mfc/windows-sockets-datagram-sockets.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Datagram Sockets" title: "Windows Sockets: Datagram Sockets" ms.date: "11/04/2016" helpviewer_keywords: ["sockets [MFC], datagram", "Windows Sockets [MFC], bi-directional data flow", "datagram sockets [MFC]", "Windows Sockets [MFC], datagram", "sockets [MFC], bi-directional data flow"] -ms.assetid: bec16a1c-74c0-4ff9-8c18-c2d87897d264 --- # Windows Sockets: Datagram Sockets +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes datagram sockets, one of the two Windows Socket types available. (The other type is the [stream socket](../mfc/windows-sockets-stream-sockets.md).) Datagram sockets support a bidirectional data flow that is not guaranteed to be sequenced or unduplicated. Datagrams also are not guaranteed to be reliable; they can fail to arrive. Datagram data may arrive out of order and possibly duplicated, but record boundaries in the data are preserved, as long as the records are smaller than the receiver's internal size limit. You are responsible for managing sequencing and reliability. (Reliability tends to be good on local-area networks [LAN] but less so on wide-area networks [WAN], such as the Internet.) diff --git a/docs/mfc/windows-sockets-deriving-from-socket-classes.md b/docs/mfc/windows-sockets-deriving-from-socket-classes.md index 3915149c498..42d1d881cb8 100644 --- a/docs/mfc/windows-sockets-deriving-from-socket-classes.md +++ b/docs/mfc/windows-sockets-deriving-from-socket-classes.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Deriving from Socket Classes" title: "Windows Sockets: Deriving from Socket Classes" ms.date: "11/04/2016" helpviewer_keywords: ["derived classes [MFC], from socket classes", "Windows Sockets [MFC], deriving from socket classes", "sockets [MFC], deriving from socket classes"] -ms.assetid: 3a26e67a-e323-433b-9b05-eca018799801 --- # Windows Sockets: Deriving from Socket Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes some of the functionality you can gain by deriving your own class from one of the socket classes. You can derive your own socket classes from either [CAsyncSocket](../mfc/reference/casyncsocket-class.md) or [CSocket](../mfc/reference/csocket-class.md) to add your own functionality. In particular, these classes supply a number of virtual member functions that you can override. These functions include [OnReceive](../mfc/reference/casyncsocket-class.md#onreceive), [OnSend](../mfc/reference/casyncsocket-class.md#onsend), [OnAccept](../mfc/reference/casyncsocket-class.md#onaccept), [OnConnect](../mfc/reference/casyncsocket-class.md#onconnect), and [OnClose](../mfc/reference/casyncsocket-class.md#onclose). You can override the functions in your derived socket class to take advantage of the notifications they provide when network events occur. The framework calls these notification callback functions to notify you of important socket events, such as the receipt of data that you can begin reading. For more information about notification functions, see [Windows Sockets: Socket Notifications](../mfc/windows-sockets-socket-notifications.md). diff --git a/docs/mfc/windows-sockets-example-of-sockets-using-archives.md b/docs/mfc/windows-sockets-example-of-sockets-using-archives.md index 89e332528ba..92d56b0acb9 100644 --- a/docs/mfc/windows-sockets-example-of-sockets-using-archives.md +++ b/docs/mfc/windows-sockets-example-of-sockets-using-archives.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["sockets [MFC], with archives", "examples [MFC], Windows S --- # Windows Sockets: Example of Sockets Using Archives +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article presents an example of using class [CSocket](../mfc/reference/csocket-class.md). The example employs `CArchive` objects to serialize data through a socket. Note that this is not document serialization to or from a file. The following example illustrates how you use the archive to send and receive data through `CSocket` objects. The example is designed so that two instances of the application (on the same machine or on different machines on the network) exchange data. One instance sends data, which the other instance receives and acknowledges. Either application can initiate an exchange, and either can act as server or as client to the other application. The following function is defined in the application's view class: diff --git a/docs/mfc/windows-sockets-how-sockets-with-archives-work.md b/docs/mfc/windows-sockets-how-sockets-with-archives-work.md index 6532e6b427a..d09962908a2 100644 --- a/docs/mfc/windows-sockets-how-sockets-with-archives-work.md +++ b/docs/mfc/windows-sockets-how-sockets-with-archives-work.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: How Sockets with Archives Work" title: "Windows Sockets: How Sockets with Archives Work" ms.date: "11/19/2018" helpviewer_keywords: ["Windows Sockets [MFC], synchronous", "sockets [MFC], synchronous operation", "sockets [MFC], with archives", "synchronous state socket", "Windows Sockets [MFC], with archives", "two-state socket object"] -ms.assetid: d8ae4039-391d-44f0-a19b-558817affcbb --- # Windows Sockets: How Sockets with Archives Work +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how a [CSocket](../mfc/reference/csocket-class.md) object, a [CSocketFile](../mfc/reference/csocketfile-class.md) object, and a [CArchive](../mfc/reference/carchive-class.md) object are combined to simplify sending and receiving data through a Windows Socket. The article [Windows Sockets: Example of Sockets Using Archives](../mfc/windows-sockets-example-of-sockets-using-archives.md) presents the `PacketSerialize` function. The archive object in the `PacketSerialize` example works much like an archive object passed to an MFC [Serialize](../mfc/reference/cobject-class.md#serialize) function. The essential difference is that for sockets, the archive is attached not to a standard [CFile](../mfc/reference/cfile-class.md) object (typically associated with a disk file) but to a `CSocketFile` object. Rather than connecting to a disk file, the `CSocketFile` object connects to a `CSocket` object. diff --git a/docs/mfc/windows-sockets-in-mfc.md b/docs/mfc/windows-sockets-in-mfc.md index ade1e931319..d63008126b5 100644 --- a/docs/mfc/windows-sockets-in-mfc.md +++ b/docs/mfc/windows-sockets-in-mfc.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets in MFC" title: "Windows Sockets in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["WINSOCK.DLL", "sockets [MFC], programming models", "MFC, Windows Sockets", "Windows Sockets [MFC], MFC support", "Windows Sockets [MFC], programming models", "WSOCK32.DLL", "sockets [MFC], MFC"] -ms.assetid: 1f3c476a-9c68-49fe-9a25-d22971a334d0 --- # Windows Sockets in MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + > [!NOTE] > MFC supports Windows Sockets 1 but does not support [Windows Sockets 2](/windows/win32/WinSock/windows-sockets-start-page-2). Windows Sockets 2 first shipped with Windows 98 and is the version included with Windows 2000. diff --git a/docs/mfc/windows-sockets-ports-and-socket-addresses.md b/docs/mfc/windows-sockets-ports-and-socket-addresses.md index d4026d95f32..a8de0f7603f 100644 --- a/docs/mfc/windows-sockets-ports-and-socket-addresses.md +++ b/docs/mfc/windows-sockets-ports-and-socket-addresses.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Ports and Socket Addresses" title: "Windows Sockets: Ports and Socket Addresses" ms.date: "11/04/2016" helpviewer_keywords: ["ports [MFC], definition", "Windows Sockets [MFC], ports", "Windows Sockets [MFC], addresses", "ports [MFC]", "addresses [MFC], socket", "sockets [MFC], addresses", "sockets [MFC], ports"] -ms.assetid: e050261a-9285-4f31-a1c5-6c8033af5b4a --- # Windows Sockets: Ports and Socket Addresses +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the terms "port" and "address" as used with Windows Sockets. ## Port diff --git a/docs/mfc/windows-sockets-sequence-of-operations.md b/docs/mfc/windows-sockets-sequence-of-operations.md index cf5c241e016..82a4873c610 100644 --- a/docs/mfc/windows-sockets-sequence-of-operations.md +++ b/docs/mfc/windows-sockets-sequence-of-operations.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Sequence of Operations" title: "Windows Sockets: Sequence of Operations" ms.date: "11/04/2016" helpviewer_keywords: ["Windows Sockets [MFC], operations", "Windows Sockets [MFC], stream sockets", "sockets [MFC], stream sockets", "sockets [MFC], operations", "stream sockets [MFC]"] -ms.assetid: 43ce76f5-aad3-4247-b8a6-16cc7d012796 --- # Windows Sockets: Sequence of Operations +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article illustrates, side by side, the sequence of operations for a server socket and a client socket. Because the sockets use `CArchive` objects, they are necessarily [stream sockets](../mfc/windows-sockets-stream-sockets.md). ## Sequence of Operations for a Stream Socket Communication diff --git a/docs/mfc/windows-sockets-socket-notifications.md b/docs/mfc/windows-sockets-socket-notifications.md index b0119e77c9b..2716daf8e39 100644 --- a/docs/mfc/windows-sockets-socket-notifications.md +++ b/docs/mfc/windows-sockets-socket-notifications.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Socket Notifications" title: "Windows Sockets: Socket Notifications" ms.date: "11/04/2016" helpviewer_keywords: ["Windows Sockets [MFC], notifications", "notifications [MFC], socket", "sockets [MFC], notifications"] -ms.assetid: 87d5bf70-6e77-49a9-9a64-aaadee2ad018 --- # Windows Sockets: Socket Notifications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the notification functions in the socket classes. These member functions are callback functions that the framework calls to notify your socket object of important events. The notification functions are: - [OnReceive](../mfc/reference/casyncsocket-class.md#onreceive): Notifies this socket that there is data in the buffer for it to retrieve by calling [Receive](../mfc/reference/casyncsocket-class.md#receive). diff --git a/docs/mfc/windows-sockets-stream-sockets.md b/docs/mfc/windows-sockets-stream-sockets.md index e87a2ee37f2..30bff346e13 100644 --- a/docs/mfc/windows-sockets-stream-sockets.md +++ b/docs/mfc/windows-sockets-stream-sockets.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Stream Sockets" title: "Windows Sockets: Stream Sockets" ms.date: "11/04/2016" helpviewer_keywords: ["Windows Sockets [MFC], stream sockets", "sockets [MFC], stream sockets", "stream sockets [MFC]"] -ms.assetid: 31faaa34-a995-493f-a30b-b8115293d619 --- # Windows Sockets: Stream Sockets +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes stream sockets, one of the two Windows Socket types available. (The other type is the [datagram socket](../mfc/windows-sockets-datagram-sockets.md).) Stream sockets provide for a data flow without record boundaries: a stream of bytes that can be bidirectional (the application is full duplex: it can both transmit and receive through the socket). Streams can be relied upon to deliver sequenced, unduplicated data. ("Sequenced" means that packets are delivered in the order sent. "Unduplicated" means that you get a particular packet only once.) Receipt of stream messages is guaranteed, and streams are well suited to handling large amounts of data. diff --git a/docs/mfc/windows-sockets-using-class-casyncsocket.md b/docs/mfc/windows-sockets-using-class-casyncsocket.md index 4b93d33ecb9..e4628d00c61 100644 --- a/docs/mfc/windows-sockets-using-class-casyncsocket.md +++ b/docs/mfc/windows-sockets-using-class-casyncsocket.md @@ -6,6 +6,9 @@ helpviewer_keywords: ["CAsyncSocket class [MFC], programming model", "Windows So --- # Windows Sockets: Using Class `CAsyncSocket` +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how to use class [`CAsyncSocket`](reference/casyncsocket-class.md). This class encapsulates the Windows Sockets API at a very low level. `CAsyncSocket` is for use by programmers who know network communications in detail but want the convenience of callbacks for notification of network events. Based on this assumption, this article provides only basic instruction. You should probably consider using `CAsyncSocket` if you want Windows Sockets' ease of dealing with multiple network protocols in an MFC application but don't want to sacrifice flexibility. You might also feel that you can get better efficiency by programming the communications more directly yourself than you could using the more general alternative model of class `CSocket`. `CAsyncSocket` is documented in the *MFC Reference*. Visual Studio also supplies the Windows Sockets specification, located in the Windows SDK. The details are left to you. Visual Studio doesn't supply a sample application for `CAsyncSocket`. diff --git a/docs/mfc/windows-sockets-using-sockets-with-archives.md b/docs/mfc/windows-sockets-using-sockets-with-archives.md index cd35be2b053..139a4bfd6be 100644 --- a/docs/mfc/windows-sockets-using-sockets-with-archives.md +++ b/docs/mfc/windows-sockets-using-sockets-with-archives.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets: Using Sockets with Archives" title: "Windows Sockets: Using Sockets with Archives" ms.date: "11/04/2016" helpviewer_keywords: ["Windows Sockets [MFC], archives", "sockets [MFC], with archives", "archives [MFC], and Windows Sockets", "CSocket class [MFC], programming model"] -ms.assetid: 17e71a99-a09e-4e1a-9fda-13d62805c824 --- # Windows Sockets: Using Sockets with Archives +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article describes the [CSocket programming model](#_core_the_csocket_programming_model). Class [CSocket](../mfc/reference/csocket-class.md) supplies socket support at a higher level of abstraction than does class [CAsyncSocket](../mfc/reference/casyncsocket-class.md). `CSocket` uses a version of the MFC serialization protocol to pass data to and from a socket object through an MFC [CArchive](../mfc/reference/carchive-class.md) object. `CSocket` provides blocking (while managing background processing of Windows messages) and gives you access to `CArchive`, which manages many aspects of the communication that you would have to do yourself using either the raw API or class `CAsyncSocket`. > [!TIP] diff --git a/docs/mfc/windows-sockets.md b/docs/mfc/windows-sockets.md index 5459fe65933..04568103ca6 100644 --- a/docs/mfc/windows-sockets.md +++ b/docs/mfc/windows-sockets.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows Sockets" title: "Windows Sockets" ms.date: "11/04/2016" helpviewer_keywords: ["sockets [MFC], Windows sockets", "networks [MFC], Windows Sockets", "programming [MFC], network", "sockets [MFC]", "Windows Sockets [MFC]"] -ms.assetid: c077ec53-540d-4bfb-a1e0-bd6482ab9e19 --- # Windows Sockets +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This family of articles covers the MFC implementation of Windows Sockets. MFC supplies two classes to support programming network applications with the Windows Sockets API. Class [CAsyncSocket](../mfc/reference/casyncsocket-class.md) encapsulates the Windows Sockets API one for one, giving advanced network programmers the most power and flexibility. Class [CSocket](../mfc/reference/csocket-class.md) provides a simplified interface for serializing data to and from a [CArchive](../mfc/reference/carchive-class.md) object. ## In This Section diff --git a/docs/mfc/windows.md b/docs/mfc/windows.md index b8c0f5aee20..92c62e35331 100644 --- a/docs/mfc/windows.md +++ b/docs/mfc/windows.md @@ -3,10 +3,12 @@ description: "Learn more about: Windows" title: "Windows" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], window", "windows [MFC]", "MFC, windows", "window objects [MFC], MFC Framework"] -ms.assetid: dd92bf34-842e-40fe-8aea-3028b55314d5 --- # Windows +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This family of articles covers window objects in the MFC framework. All MFC windows derive from class [CWnd](../mfc/reference/cwnd-class.md), including frame windows, views, dialog boxes, and controls. The first group of articles describes [window objects](../mfc/window-objects.md) in general. Refer to this group for general information about C++ window objects, how they encapsulate an `HWND`, and how you use them when creating your own windows, such as child windows. diff --git a/docs/mfc/wininet-basics.md b/docs/mfc/wininet-basics.md index 8dc432382e0..57b100acb73 100644 --- a/docs/mfc/wininet-basics.md +++ b/docs/mfc/wininet-basics.md @@ -3,10 +3,12 @@ description: "Learn more about: WinInet Basics" title: "WinInet Basics" ms.date: "11/04/2016" helpviewer_keywords: ["OnStatusCallback method [MFC]", "WinInet classes [MFC], displaying progress", "WinInet classes [MFC], about WinInet classes"] -ms.assetid: 665de5ac-e80d-427d-8d91-2ae466885940 --- # WinInet Basics +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + You can use WinInet to add FTP support to download and upload files from within your application. You can override [OnStatusCallback](../mfc/reference/cinternetsession-class.md#onstatuscallback) and use the *dwContext* parameter to provide progress information to users as you search for and download files. This article contains the following topics: diff --git a/docs/mfc/wizards-and-the-resource-editors.md b/docs/mfc/wizards-and-the-resource-editors.md index 5646150d063..d7b409d03e4 100644 --- a/docs/mfc/wizards-and-the-resource-editors.md +++ b/docs/mfc/wizards-and-the-resource-editors.md @@ -3,10 +3,12 @@ description: "Learn more about: Wizards and the Resource Editors" title: "Wizards and the Resource Editors" ms.date: "11/04/2016" helpviewer_keywords: ["application wizards [MFC], and MFC", "MFC, resource editors", "resource editors, MFC", "MFC Application Wizard", "editors [MFC], resource", "wizards [MFC]", "wizards [MFC], MFC programming", "MFC, wizards", "Class View tool, managing Windows messages"] -ms.assetid: f5dd4d13-9dc1-4a49-b6bf-5b3cb45fa8ba --- # Wizards and the Resource Editors +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Visual Studio includes several wizards for use in MFC programming, along with many integrated resource editors. For ActiveX controls programming, the [ActiveX Control Wizard](../mfc/reference/mfc-activex-control-wizard.md) serves a purpose much like that of the MFC Application Wizard. While you can write MFC applications without most of these tools, the tools greatly simplify and speed your work. ## Use the MFC Application Wizard to Create an MFC Application diff --git a/docs/mfc/word-breaks-in-rich-edit-controls.md b/docs/mfc/word-breaks-in-rich-edit-controls.md index c4bd94e11bb..860a8188dac 100644 --- a/docs/mfc/word-breaks-in-rich-edit-controls.md +++ b/docs/mfc/word-breaks-in-rich-edit-controls.md @@ -3,10 +3,12 @@ description: "Learn more about: Word Breaks in Rich Edit Controls" title: "Word Breaks in Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CRichEditCtrl class [MFC], word breaks in", "word breaks", "breaking words in CRichEditCtrl", "rich edit controls [MFC], word breaks in"] -ms.assetid: 641dcf9e-7b40-4dc0-85f7-575a8c142f73 --- # Word Breaks in Rich Edit Controls +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + A rich edit control ([CRichEditCtrl](../mfc/reference/cricheditctrl-class.md)) calls a function called a "word break procedure" to find breaks between words and to determine where it can break lines. The control uses this information when performing word-wrap operations and when processing the CTRL+LEFT and CTRL+RIGHT key combinations. An application can send messages to a rich edit control to replace the default word-break procedure, to retrieve word-break information, and to determine what line a given character falls on. ## See also diff --git a/docs/mfc/working-with-a-header-control.md b/docs/mfc/working-with-a-header-control.md index 1cd98c32b13..d08784122db 100644 --- a/docs/mfc/working-with-a-header-control.md +++ b/docs/mfc/working-with-a-header-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Working with a Header Control" title: "Working with a Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], working with", "header controls"] -ms.assetid: af3afb5c-bf97-451b-8fee-3adcb8257210 ms.topic: concept-article --- # Working with a Header Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The easy way to use a header control ([CHeaderCtrl](../mfc/reference/cheaderctrl-class.md)) is in conjunction with a list control; see [Using CListCtrl](../mfc/using-clistctrl.md) later in this topic family. You can also use a header control by itself. MFC calls `InitCommonControls` for you. The key tasks are as follows: - [Creating the header control](../mfc/creating-the-header-control.md) diff --git a/docs/mfc/working-with-a-tab-control.md b/docs/mfc/working-with-a-tab-control.md index e730f954acd..6e7adf73b88 100644 --- a/docs/mfc/working-with-a-tab-control.md +++ b/docs/mfc/working-with-a-tab-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Working with a Tab Control" title: "Working with a Tab Control" ms.date: "11/04/2016" helpviewer_keywords: ["CTabCtrl class [MFC], using", "tab controls [MFC], working with", "tab controls [MFC], using"] -ms.assetid: 819488e3-4944-44b7-9483-195edb8e0aed ms.topic: concept-article --- # Working with a Tab Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The easiest way to use a tab control ([CTabCtrl](../mfc/reference/ctabctrl-class.md)) is by adding it to a dialog template resource with the dialog editor. You can also use a tab control by itself. MFC calls `InitCommonControls` for you. The key tasks are as follows: - [Creating the tab control](../mfc/creating-the-tab-control.md) diff --git a/docs/mfc/working-with-the-toolbar-control.md b/docs/mfc/working-with-the-toolbar-control.md index 486ff79f32e..ed5fe057c34 100644 --- a/docs/mfc/working-with-the-toolbar-control.md +++ b/docs/mfc/working-with-the-toolbar-control.md @@ -3,11 +3,13 @@ description: "Learn more about: Working with the Toolbar Control" title: "Working with the Toolbar Control" ms.date: "11/04/2016" helpviewer_keywords: ["GetToolBarCtrl method [MFC]", "toolbars [MFC], accessing common control", "CToolBarCtrl class [MFC], accessing toolbar", "toolbar controls [MFC], accessing"] -ms.assetid: b19409d5-3831-42c7-80ae-195c49dc9085 ms.topic: how-to --- # Working with the Toolbar Control +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains how you can access the [CToolBarCtrl](../mfc/reference/ctoolbarctrl-class.md) object underlying a [CToolBar](../mfc/reference/ctoolbar-class.md) for greater control over your toolbars. This is an advanced topic. ## Procedures diff --git a/docs/mfc/working-with-window-objects.md b/docs/mfc/working-with-window-objects.md index 55547aac560..2630a6af645 100644 --- a/docs/mfc/working-with-window-objects.md +++ b/docs/mfc/working-with-window-objects.md @@ -3,11 +3,13 @@ description: "Learn more about: Working with Window Objects" title: "Working with Window Objects" ms.date: "11/04/2016" helpviewer_keywords: ["child windows [MFC], working with", "window objects [MFC], working with"] -ms.assetid: f73aa254-90e3-46a9-8e9b-d78b7054a331 ms.topic: concept-article --- # Working with Window Objects +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + Working with windows calls for two kinds of activity: - Handling Windows messages diff --git a/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md b/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md index 89176ac68ec..339dc335a7b 100644 --- a/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md +++ b/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md @@ -3,11 +3,13 @@ description: "Learn more about: Writing an Internet Client Application Using MFC title: "Writing an Internet Client Application Using MFC WinInet Classes" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC]", "WinInet classes [MFC], programming", "Internet client applications [MFC], writing", "Internet applications [MFC], WinInet", "Internet applications [MFC], client applications", "MFC, Internet applications"] -ms.assetid: a2c4a40c-a94e-4b3e-9dbf-f8a8dc8e5428 ms.topic: concept-article --- # Writing an Internet Client Application Using MFC WinInet Classes +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The basis of every Internet client application is the Internet session. MFC implements Internet sessions as objects of class [CInternetSession](../mfc/reference/cinternetsession-class.md). Using this class, you can create one Internet session or several simultaneous sessions. To communicate with a server, you need a [CInternetConnection](../mfc/reference/cinternetconnection-class.md) object as well as a `CInternetSession`. You can create a `CInternetConnection` by using [CInternetSession::GetFtpConnection](../mfc/reference/cinternetsession-class.md#getftpconnection), [CInternetSession::GetHttpConnection](../mfc/reference/cinternetsession-class.md#gethttpconnection), or [CInternetSession::GetGopherConnection](../mfc/reference/cinternetsession-class.md#getgopherconnection). Each of these calls is specific to the protocol type. These calls do not open a file on the server for reading or writing. If you intend to read or write data, you must open the file as a separate step. diff --git a/docs/mfc/writing-mfc-applications.md b/docs/mfc/writing-mfc-applications.md index abb166fc975..b42cbf62a52 100644 --- a/docs/mfc/writing-mfc-applications.md +++ b/docs/mfc/writing-mfc-applications.md @@ -3,11 +3,13 @@ description: "Learn more about: Writing MFC Applications" title: "Writing MFC Applications" ms.date: "09/12/2018" helpviewer_keywords: ["Internet applications [MFC], MFC", "MFC, Internet applications", "application wizards [MFC], Internet applications", "MFC, application development"] -ms.assetid: 6a8d8a03-abfa-4976-86c2-c5773a4b7179 ms.topic: concept-article --- # Writing MFC Applications +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + This article explains the initial steps you take to develop your application. First, you must decide what kind of application you are writing. Several of the choices were discussed in [Application Design Choices](../mfc/application-design-choices.md). Will your application be: - Running on the Internet or an intranet diff --git a/docs/parallel/multithreading-with-cpp-and-mfc.md b/docs/parallel/multithreading-with-cpp-and-mfc.md index 7fc4d93386e..286a5155131 100644 --- a/docs/parallel/multithreading-with-cpp-and-mfc.md +++ b/docs/parallel/multithreading-with-cpp-and-mfc.md @@ -3,11 +3,13 @@ description: "Learn more about: Multithreading with C++ and MFC" title: "Multithreading with C++ and MFC" ms.date: "08/27/2018" helpviewer_keywords: ["MFC [C++], multithreading", "threading [C++], MFC", "worker threads [C++]", "synchronization classes [C++]", "synchronization [C++], multithreading", "threading [MFC], about threading", "CWinThread class, purpose of", "multithreading [C++], MFC", "threading [MFC]", "user interface threads [C++]"] -ms.assetid: 979605f8-3988-44b5-ac9c-b8cce7fcce14 ms.topic: concept-article --- # Multithreading with C++ and MFC +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. + The Microsoft Foundation Class (MFC) library provides support for multithreaded applications. This topic describes processes and threads and the MFC approach to multithreading. A process is an executing instance of an application. For example, when you double-click the Notepad icon, you start a process that runs Notepad. From 0f5a5aed3f2229589ea7eaa7acd6de5af458e02d Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Tue, 24 Feb 2026 17:01:05 -0800 Subject: [PATCH 1658/1799] edit pass: redistributing-microsoft-c++-files --- docs/windows/latest-supported-vc-redist.md | 90 +++++++++---------- docs/windows/redist-version-auditing.md | 54 +++++------ .../redistributing-an-atl-application.md | 25 +++--- ...uting-components-by-using-merge-modules.md | 6 +- .../windows/redistributing-the-mfc-library.md | 14 +-- ...istributing-visual-cpp-activex-controls.md | 6 +- .../redistributing-visual-cpp-files.md | 4 +- 7 files changed, 99 insertions(+), 100 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 7ddd701f486..18bb356f080 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -1,6 +1,6 @@ --- -title: "Latest supported Visual C++ Redistributable downloads" -description: "This article provides download links for the latest Visual C++ Redistributable packages." +title: Latest Supported Visual C++ Redistributable Downloads +description: This article provides download links for the latest Visual C++ Redistributable Packages. ms.date: 12/03/2025 helpviewer_keywords: [ @@ -20,12 +20,9 @@ ms.author: msaleh > [!NOTE] > Are you here to download Visual Studio? Go to [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/). -> [!TIP] -> Having issues installing the Visual C++ Redistributable? Check out the [troubleshooting guide](troubleshoot-vc-redistributable-installation-issues.md). - -This topic is for developers who need to install the Visual C++ runtime libraries with their app. If you're an end user trying to fix an app by updating the Visual C++ runtime libraries, contact the app vendor for instructions. +This article is for developers who need to install the Visual C++ Runtime Libraries with their app. If you're trying to fix an app by updating the Visual C++ Runtime Libraries, contact the app vendor for instructions. -To find the download you need, choose your version of Visual Studio from the table below. Each link takes you to the appropriate download section. +To find the download you need, choose your version of Visual Studio from the following table. Each link takes you to the appropriate download section. | Version | Section | |--|--| @@ -37,51 +34,56 @@ To find the download you need, choose your version of Visual Studio from the tab | Visual Studio 2008 | [Visual Studio 2008 (VC++ 9.0)](#visual-studio-2008-vc-90-sp1-no-longer-supported) | | Visual Studio 2005 | [Visual Studio 2005 (VC++ 8.0)](#visual-studio-2005-vc-80-sp1-no-longer-supported) | -Redistribution is permitted only for licensed Visual Studio users, as described in the [Visual Studio license terms](https://visualstudio.microsoft.com/license-terms/). For details on redistributing Visual C++ files, see [Redistributing Visual C++ Files](redistributing-visual-cpp-files.md). +> [!TIP] +> Are you having issues installing the Visual C++ Redistributable? Refer to the [Troubleshooting Guide](troubleshoot-vc-redistributable-installation-issues.md). + +Redistribution is permitted only for licensed Visual Studio users, as described in the [Visual Studio license terms](https://visualstudio.microsoft.com/license-terms/). For details on redistributing Visual C++ files, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). -A Visual C++ Redistributable installs Microsoft C and C++ runtime libraries. Many applications built using Microsoft C++ (MSVC) Build Tools require these libraries. If your app is built using those libraries, a Microsoft Visual C++ Redistributable package at least as recent as the build tools used to build your app must be installed on the target system along with the app. The Redistributable package architecture must match your app's target architecture (you can't install an ARM64 Redistributable on an x86 system, or an x64 Redistributable on an x86 system, for example). We recommend you use the latest Redistributable available for your version of Visual Studio. +A Visual C++ Redistributable installs Microsoft C and C++ Runtime Libraries. Many applications built by using Microsoft Visual C++ (MSVC) Build Tools require these libraries. If your app is built by using those libraries, a Microsoft Visual C++ Redistributable Package at least as recent as the build tools used to build your app must be installed on the target system along with the app. -## Visual C++ Redistributable v14 +The Redistributable package architecture must match your app's target architecture. (You can't install an ARM64 Redistributable on an x86 system or an x64 Redistributable on an x86 system, for example.) We recommend that you use the latest Redistributable available for your version of Visual Studio. -This table lists the latest supported Microsoft Visual C++ Redistributable v14 packages. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created using MSVC C and C++ Build Tools available in Visual Studio 2017, 2019, 2022, or 2026. +## Visual C++ v14 Redistributable -Unlike older versions of Visual Studio that have infrequent redistributable updates, the version number isn't listed in the following table for the Visual C++ v14 Redistributable because it is updated frequently. To find the version number of the latest redistributable, download the one you're interested in using one of the following links. Then, look at its properties using Windows File Explorer. In the **Details** pane, the **File version** contains the version of the redistributable. +The following table lists the latest supported Microsoft Visual C++ v14 Redistributable Packages. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created by using MSVC C and C++ Build Tools available in Visual Studio 2017, 2019, 2022, or 2026. + +Unlike older versions of Visual Studio that have infrequent redistributable updates, the version number isn't listed in the following table for the Visual C++ v14 Redistributable because it's updated frequently. To find the version number of the latest redistributable, download the one you're interested in by using one of the following links. Then, look at its properties by using Windows File Explorer. On the **Details** pane, **File version** contains the version of the redistributable. ### Latest supported redistributable version | Architecture | Link | Notes | |--|--|--| -| ARM64 | [https://aka.ms/vc14/vc_redist.arm64.exe](https://aka.ms/vc14/vc_redist.arm64.exe) | Permalink for latest supported ARM64 version | -| X86 | [https://aka.ms/vc14/vc_redist.x86.exe](https://aka.ms/vc14/vc_redist.x86.exe) | Permalink for latest supported x86 version | -| X64 | [https://aka.ms/vc14/vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | +| ARM64 | [https://aka.ms/vc14/vc_redist.arm64.exe](https://aka.ms/vc14/vc_redist.arm64.exe) | Permalink for latest supported ARM64 version. | +| X86 | [https://aka.ms/vc14/vc_redist.x86.exe](https://aka.ms/vc14/vc_redist.x86.exe) | Permalink for latest supported x86 version. | +| X64 | [https://aka.ms/vc14/vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable Package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | -Download other versions, including long term servicing release channel (LTSC) versions, from [my.visualstudio.com](https://my.visualstudio.com/). +Download other versions, including long-term servicing release channel versions, from [my.visualstudio.com](https://my.visualstudio.com/). ### Notes -- Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Log in using a Visual Studio Subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or, create a free account by choosing the [**No account? Create one!**](https://my.visualstudio.com/). -- The Visual C++ v14 Redistributable doesn't have separate packages for different languages. License terms for different languages are available at [https://aka.ms/VCRedistLicense](https://aka.ms/VCRedistLicense). -- Visual Studio 2017 and later share the same Redistributable files. Any apps built by Microsoft C++ (MSVC) Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. The version of the redistributable installed on the machine must be the same or higher than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). -- The latest version of the Visual C++ v14 Redistributable included with Visual Studio 2026 only supports the following operating systems: +- Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Sign in by using a Visual Studio subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or to create a free account. select [No account? Create one!](https://my.visualstudio.com/). +- The Visual C++ v14 Redistributable doesn't have separate packages for different languages. License terms for different languages are available at [Microsoft Software License Terms](https://aka.ms/VCRedistLicense). +- Visual Studio 2017 and later share the same redistributable files. Any apps built by Microsoft Visual C++ (MSVC) Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. The version of the Redistributable installed on the machine must be the same or later than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determine which dynamic-link-libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). +- The latest version of the Visual C++ v14 Redistributable included with Visual Studio 2026 supports only the following operating systems: * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 -- Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version.
-When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built using the VS 2015 MSVC Build Tools. Since VS 2015 is no longer supported, we recommend updating your projects to use a supported MSVC Build Tools version and the latest v14 runtime. The Visual C++ Redistributable for 2017, and later, in-place upgrade the Visual C++ 2015 Redistributable (14.0.24212.0). Redistributables for 2013 and earlier remain installed side-by-side. +- Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. For the latest available version, see the [Visual Studio 2015 (Visual C++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section.
+When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built by using the Visual Studio 2015 MSVC Build Tools. Since Visual Studio 2015 is no longer supported, we recommend that you update your projects to use a supported MSVC Build Tools version and the latest v14 runtime. The Visual C++ Redistributable for 2017, and later, in-place upgrade the Visual C++ 2015 Redistributable (14.0.24212.0). Redistributables for 2013 and earlier remain installed side by side. -- The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). +- The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions ### Visual Studio 2015 (VC++ 14.0) (no longer supported) -To download the latest available version of Visual C++ Redistributable for Visual Studio 2015, please visit [my.visualstudio.com](https://my.visualstudio.com/) and search for "Visual C++ Redistributable for Visual Studio 2015" in the _Downloads_ section +To download the latest available version of Visual C++ Redistributable for Visual Studio 2015, see the [Visual Studio Subscriptions](https://my.visualstudio.com/) website. On the **Downloads** tab, search for **Visual C++ Redistributable for Visual Studio 2015**. -The latest version of Visual C++ Redistributable for Visual Studio 2015 is `14.0.24212.0`, available for ARM64, X86, and X64 architectures. +The latest version of Visual C++ Redistributable for Visual Studio 2015 is `14.0.24212.0` and is available for ARM64, X86, and X64 architectures. ### Visual Studio 2013 (VC++ 12.0) (no longer supported) -These links download the latest available en-US Microsoft Visual C++ Redistributable packages for Visual Studio 2013. -You can download other versions and languages from [Update for Visual C++ 2013 Redistributable Package](https://support.microsoft.com/topic/update-for-visual-c-2013-redistributable-package-d8ccd6a5-4e26-c290-517b-8da6cfdf4f10) or from [my.visualstudio.com](https://my.visualstudio.com/). +These links download the latest available en-US Microsoft Visual C++ Redistributable Packages for Visual Studio 2013. +You can download other versions and languages from [Update for Visual C++ 2013 Redistributable Package](https://support.microsoft.com/topic/update-for-visual-c-2013-redistributable-package-d8ccd6a5-4e26-c290-517b-8da6cfdf4f10) or from the [Visual Studio Subscriptions](https://my.visualstudio.com/) website. | Architecture | Version | Link | | ------------ | :----------: | ------------------------------------------------------: | @@ -90,15 +92,15 @@ You can download other versions and languages from [Update for Visual C++ 2013 R ### Other 2013 versions -- [Multibyte MFC Library for Visual Studio 2013](https://my.visualstudio.com/Downloads?pid=1430). This MFC add-on for Visual Studio 2013 contains the multibyte character set (MBCS) version of the Microsoft Foundation Class (MFC) Library. -- [Visual C++ 2013 Runtime for Sideloaded Windows 8.1 apps](https://download.microsoft.com/download/5/f/0/5f0f8404-9329-44a9-8176-ed6f7f746f25/vclibs_redist_packages.zip). For more information, see [C++ Runtime for Sideloaded Windows 8.1 apps](https://devblogs.microsoft.com/cppblog/c-runtime-for-sideloaded-windows-8-1-apps/) on the C++ Team Blog. +- [Multibyte Microsoft Foundation Class (MFC) Library for Visual Studio 2013](https://my.visualstudio.com/Downloads?pid=1430). This MFC add-on for Visual Studio 2013 contains the multibyte character set (MBCS) version of the MFC Library. +- [Visual C++ 2013 Runtime for sideloaded Windows 8.1 apps](https://download.microsoft.com/download/5/f/0/5f0f8404-9329-44a9-8176-ed6f7f746f25/vclibs_redist_packages.zip). For more information, see [C++ Runtime for sideloaded Windows 8.1 apps](https://devblogs.microsoft.com/cppblog/c-runtime-for-sideloaded-windows-8-1-apps/) on the C++ Team Blog. ### Visual Studio 2012 (VC++ 11.0) Update 4 (no longer supported) > [!NOTE] -> Visual Studio 2012 [reached end of extended support on Jan 10, 2023](/lifecycle/products/visual-studio-2012) +> Visual Studio 2012 [reached the end of extended support on January 10, 2023](/lifecycle/products/visual-studio-2012). -These links download the latest available en-US Microsoft Visual C++ Redistributable packages for Visual Studio 2012 Update 4. You can download other versions and languages from [Microsoft Visual C++ Redistributable Packages for Visual Studio 2012 Update 4](https://www.microsoft.com/download/details.aspx?id=30679) or from [my.visualstudio.com](https://my.visualstudio.com/Downloads?pid=1452). +These links download the latest available en-US Microsoft Visual C++ Redistributable Packages for Visual Studio 2012 Update 4. You can download other versions and languages from [Microsoft Visual C++ Redistributable Packages for Visual Studio 2012 Update 4](https://www.microsoft.com/download/details.aspx?id=30679) or from the [Visual Studio Subscriptions](https://my.visualstudio.com/Downloads?pid=1452) website. | Architecture | Version | Link | |--|:-:|-:| @@ -108,46 +110,42 @@ These links download the latest available en-US Microsoft Visual C++ Redistribut ### Visual Studio 2010 (VC++ 10.0) SP1 (no longer supported) > [!NOTE] -> Visual Studio 2010 Service Pack 1 [reached end of extended support on July 14, 2020](/lifecycle/products/visual-studio-2010) +> Visual Studio 2010 Service Pack 1 [reached the end of extended support on July 14, 2020](/lifecycle/products/visual-studio-2010). | Architecture | Version | Link | |--|:-:|-:| | X86 | 10.0.40219.325 | [vcredist_x86.exe](https://download.microsoft.com/download/1/6/5/165255E7-1014-4D0A-B094-B6A430A6BFFC/vcredist_x86.exe) | | X64 | 10.0.40219.325 | [vcredist_x64.exe](https://download.microsoft.com/download/1/6/5/165255E7-1014-4D0A-B094-B6A430A6BFFC/vcredist_x64.exe) | -Download Redistributable files for other languages and architectures from: - -- [Microsoft Visual C++ 2010 SP1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26999) +Download Redistributable files for other languages and architectures from [Microsoft Visual C++ 2010 SP1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26999). ### Visual Studio 2008 (VC++ 9.0) SP1 (no longer supported) > [!NOTE] -> Visual Studio 2008 Service Pack 1 [reached end of extended support on April 10, 2018](/lifecycle/products/visual-studio-2008) +> Visual Studio 2008 Service Pack 1 [reached the end of extended support on April 10, 2018](/lifecycle/products/visual-studio-2008). | Architecture | Version | Link | |--|:-:|-:| | X86 | 9.0.30729.5677 | [vcredist_x86.exe](https://download.microsoft.com/download/5/D/8/5D8C65CB-C849-4025-8E95-C3966CAFD8AE/vcredist_x86.exe) | | X64 | 9.0.30729.5677 | [vcredist_x64.exe](https://download.microsoft.com/download/5/D/8/5D8C65CB-C849-4025-8E95-C3966CAFD8AE/vcredist_x64.exe) | -Download Redistributable files for other languages and architectures from: - -- [Microsoft Visual C++ 2008 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26368) +Download redistributable files for other languages and architectures from [Microsoft Visual C++ 2008 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26368). ### Visual Studio 2005 (VC++ 8.0) SP1 (no longer supported) > [!NOTE] -> Visual Studio 2005 [reached end of extended support on April 12, 2016](/lifecycle/products/microsoft-visual-studio-2005) +> Visual Studio 2005 [reached the end of extended support on April 12, 2016](/lifecycle/products/microsoft-visual-studio-2005). -- Redistributable files for X86, X64, and IA64 architectures are available from [Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26347). +Redistributable files for X86, X64, and IA64 architectures are available from [Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26347). -## See also +## Related content - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) -- [How to audit Visual C++ Runtime version usage](redist-version-auditing.md) -- [Lifecycle FAQ - Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) +- [Audit Visual C++ Runtime version usage](redist-version-auditing.md) +- [Lifecycle FAQ: Visual C++ Redistributable and Runtime Libraries](/lifecycle/faq/visual-c-faq) - [Troubleshoot Visual C++ Redistributable installation issues](troubleshoot-vc-redistributable-installation-issues.md) -**Release notes** +### Release notes - [What's new for C++ in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md) - [Visual Studio 2026 release notes](/visualstudio/releases/2026/release-notes) @@ -156,7 +154,7 @@ Download Redistributable files for other languages and architectures from: - [A year of C++ improvements](https://devblogs.microsoft.com/cppblog/a-year-of-cpp-improvements-in-visual-studio-vs-code-and-vcpkg) - [Microsoft Visual C++ compiler versioning](../overview/compiler-versions.md) -**C++ conformance notes** +### C++ conformance notes - [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md) - [C++ conformance improvements in Visual Studio 2019](../overview/cpp-conformance-improvements-2019.md) diff --git a/docs/windows/redist-version-auditing.md b/docs/windows/redist-version-auditing.md index a2cc229117a..2e09b9c1607 100644 --- a/docs/windows/redist-version-auditing.md +++ b/docs/windows/redist-version-auditing.md @@ -1,6 +1,6 @@ --- -title: "How to audit Visual C++ Runtime version usage" -description: "A detailed guide for auditing Visual C++ Runtime file usage." +title: Audit Visual C++ Runtime Version Usage +description: A detailed guide for auditing Visual C++ Runtime file usage. ms.date: 1/27/2025 helpviewer_keywords: [ @@ -12,26 +12,26 @@ ms.author: msaleh ms.topic: how-to --- -# How to audit Visual C++ Runtime version usage +# Audit Visual C++ Runtime version usage -The Microsoft Visual C++ Redistributable and the Visual Studio C++ Runtime (collectively, "VC Runtime") are critical components of many applications. Across your network, machines may still be running applications that install and use an out-of-support version of the VC Runtime. You can use NTFS file auditing to identify such usage as a step towards replacing those applications with ones that use a supported version of the VC Runtime. This guide walks you through setting up NTFS file auditing, provides troubleshooting tips, and highlights the benefits of regular audits. +The Microsoft Visual C++ Redistributable and the Visual Studio C++ Runtime (collectively, "VC Runtime") are critical components of many applications. Across your network, machines might still be running applications that install and use an out-of-support version of the VC Runtime. You can use NTFS file auditing to identify such usage as a step toward replacing those applications with ones that use a supported version of the VC Runtime. This article walks you through setting up NTFS file auditing, provides troubleshooting tips, and highlights the benefits of regular audits. For more information about the versions of VC Runtime that are no longer supported, see [Microsoft Visual C++ Redistributable latest supported downloads](latest-supported-vc-redist.md). ## Enable NTFS file auditing to determine VC Runtime usage -This guide provides the steps to manually enable NTFS file auditing and review audit events to determine which applications are calling the unsupported versions of the VC Runtime. Because there are several files that can be used by an application, this guide also shows how to use PowerShell's [`Get-Acl`](/powershell/module/microsoft.powershell.security/get-acl) and [`Set-Acl`](/powershell/module/microsoft.powershell.security/set-acl) cmdlets to update auditing permissions. For more information about how to configure audit policies for a file, see [Apply a basic audit policy on a file or folder](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/apply-a-basic-audit-policy-on-a-file-or-folder). +This article provides the steps to manually enable NTFS file auditing and review audit events to determine which applications are calling the unsupported versions of the VC Runtime. Because there are several files that can be used by an application, this article also shows how to use the PowerShell [`Get-Acl`](/powershell/module/microsoft.powershell.security/get-acl) and [`Set-Acl`](/powershell/module/microsoft.powershell.security/set-acl) cmdlets to update auditing permissions. For more information about how to configure audit policies for a file, see [Apply a basic audit policy on a file or folder](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/apply-a-basic-audit-policy-on-a-file-or-folder). ### Manually enable object access auditing on the system Object access must be enabled before you enable file level auditing: 1. Open the **Local Group Policy Editor** by pressing `Windows` + `R` to open the **Run** dialog. Then type `gpedit.msc` and press **Enter**. -1. Navigate to **Computer Configuration** > **Windows Settings** > **Security Settings** > **Advanced Audit Policy Configuration** > **System Audit Policies** > **Object Access**. +1. Go to **Computer Configuration** > **Windows Settings** > **Security Settings** > **Advanced Audit Policy Configuration** > **System Audit Policies** > **Object Access**. 1. Double-click **Audit File System**. In the **Audit File System Properties** dialog, select **Configure the following audit events** > **Success** > **OK**. 1. Close the **Local Group Policy Editor**. -Alternatively, you may use `auditpol.exe` to enable object access: +Alternatively, you can use `auditpol.exe` to enable object access: 1. List the current settings from the command line with `AuditPol.exe /get /category:"Object Access"`. 1. Enable object access with `AuditPol.exe /set /category:"Object Access" /subcategory:"File System" /success:enable`. @@ -42,12 +42,12 @@ To monitor which process accesses a VC Runtime file, enable auditing on the VC R 1. Right-click the file that you want to audit, select **Properties**, and then select the **Security** tab. For more information about finding installed VC Runtime files, see [VC Runtime installed locations](#vcruntime_install_location). 1. Select **Advanced**. -1. In the **Advanced Security Settings** dialog box, select the **Auditing** tab and then select **Continue**. -1. To add a new auditing rule, select **Add**. In the **Auditing Entry** dialog, select a principal, then type the name of the user or group you want to add such as **(Everyone)**, and then select **OK**. -1. In **Type**, select ensure that **Success** is selected. +1. In the **Advanced Security Settings** dialog, select the **Auditing** tab and then select **Continue**. +1. To add a new auditing rule, select **Add**. In the **Auditing Entry** dialog, select a principal, and then enter the name of the user or group you want to add, such as **(Everyone)**. Then select **OK**. +1. In **Type**, ensure that **Success** is selected. 1. Select **Show advance permissions** > **Clear all** > **Traverse folder / execute file** > **OK**. -1. There should now be a new row in the **Auditing** entries matching what you have selected. Select **OK**. -1. In the **Properties** Dialog, select **OK**. +1. There should now be a new row in the **Auditing** entries matching what you selected. Select **OK**. +1. In the **Properties** dialog, select **OK**. The audit rule is now enabled for the file. @@ -55,17 +55,17 @@ The audit rule is now enabled for the file. NTFS file auditing generates ["Event 4663: An attempt was made to access an object"](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663) for each file that includes the audit permission and is accessed by a process. -1. Open the **Event Viewer** by pressing `Windows` + `R` to open the **Run** dialog. Then type `eventvwr.msc`, and press **Enter**. -1. Navigate to the **Security** logs in the **Event Viewer** by expanding **Windows Logs** > **Security**. The results pane lists security events. -1. Find the audit events by choosing **Filter Current Log...** in the **Actions** pane. Narrow down the events to **Event ID 4663 (Audit Success for the File System Category)** by entering **4663 into the Includes/Excludes Event IDs** text box. +1. Open the **Event Viewer** by selecting **Windows** + **R** to open the **Run** dialog. Then enter **eventvwr.msc** and select **Enter**. +1. Go to the **Security** logs in the **Event Viewer** by expanding **Windows Logs** > **Security**. The results pane lists security events. +1. Find the audit events by choosing **Filter Current Log...** in the **Actions** pane. Narrow down the events to **Event ID 4663 (Audit Success for the File System Category)** by entering **4663** into the **Includes/Excludes Event IDs** text box. -For an example of a File Access Auditing Event 4663, see ["4663(S): An attempt was made to access an object."](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663) +For an example of a File Access Auditing Event 4663, see ["4663(S): An attempt was made to access an object."](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663). ### Use PowerShell to audit VC Runtime usage -As an overview, updating File Auditing Permissions with PowerShell follows these steps: +To update File Auditing Permissions with PowerShell, follow these steps: -1. Define the [file system audit rule](/dotnet/api/system.security.accesscontrol.filesystemauditrule.-ctor) to apply to the file(s). +1. Define the [file system audit rule](/dotnet/api/system.security.accesscontrol.filesystemauditrule.-ctor) to apply to the files. 1. Obtain a file's security descriptor with [`Get-Acl`](/powershell/module/microsoft.powershell.security/get-acl). 1. [Apply the audit rule](/dotnet/api/system.security.accesscontrol.filesystemsecurity.setaccessrule) to the security descriptor. 1. Apply the updated security descriptor on the original file with [`Set-Acl`](/powershell/module/microsoft.powershell.security/set-acl). @@ -122,7 +122,7 @@ ForEach-Object { ### PowerShell: View file audit events -PowerShell provides `Get-WinEvent` to get event records for various event logs as shown in the following PowerShell code that lists all of the Auditing Event 4663 records over the past 24 hours: +PowerShell provides `Get-WinEvent` to get event records for various event logs, as shown in the following PowerShell code that lists all of the Auditing Event 4663 records over the past 24 hours: ```powershell function Get-AuditEntries { @@ -171,9 +171,9 @@ ResourceAttributes : S:AI ### Next steps after auditing VC Runtime usage -After you have determined which processes are using the VC Runtime files, or which applications have installed the VC Redistributable, uninstall those applications or upgrade them to newer versions that don't depend on unsupported VC Runtimes. +After you determine which processes use the VC Runtime files, or which applications installed the VC Redistributable, uninstall those applications or upgrade them to newer versions that don't depend on unsupported VC Runtimes. -Some Microsoft applications require legacy versions of the VC Runtime. For details, see [Visual C++ Redistributable and runtime libraries FAQ | Microsoft Learn](/lifecycle/faq/visual-c-faq). +Some Microsoft applications require legacy versions of the VC Runtime. For details, see [Visual C++ Redistributable and Runtime Libraries FAQ | Microsoft Learn](/lifecycle/faq/visual-c-faq). @@ -181,7 +181,7 @@ Some Microsoft applications require legacy versions of the VC Runtime. For detai Here is where each version of the VC Runtime is installed: -| **Visual Studio Version**| **Installed Location(s)**| +| Visual Studio version| Installed locations| | ------------- | ------------- | | Visual Studio 2013 (VC++ 12.0) | `%SystemRoot%\\System32, %SystemRoot%\\SysWOW64` | | Visual Studio 2012 (VC++ 11.0) | `%SystemRoot%\\System32, %SystemRoot%\\SysWOW64` | @@ -189,9 +189,9 @@ Here is where each version of the VC Runtime is installed: | Visual Studio 2008 (VC++ 9.0) | `%SystemRoot%\\WinSxS\\Fusion` | | Visual Studio 2005 (VC++ 8.0) | `%SystemRoot%\\WinSxS\\Fusion` | -## See also +## Related content -[Redistributing Visual C++ Files](redistributing-visual-cpp-files.md)\ -[The latest supported Visual C++ downloads](latest-supported-vc-redist.md)\ -[Lifecycle FAQ - Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq)\ -[C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) +- [Redistribute Visual C++ files](redistributing-visual-cpp-files.md)\ +- [The latest supported Visual C++ downloads](latest-supported-vc-redist.md)\ +- [Lifecycle FAQ: Visual C++ Redistributable and Runtime Libraries](/lifecycle/faq/visual-c-faq)\ +- [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) diff --git a/docs/windows/redistributing-an-atl-application.md b/docs/windows/redistributing-an-atl-application.md index 84bb01ef68b..a226fc8848b 100644 --- a/docs/windows/redistributing-an-atl-application.md +++ b/docs/windows/redistributing-an-atl-application.md @@ -1,16 +1,16 @@ --- -description: "Learn more about: Redistributing an ATL application" -title: "Redistributing an ATL application" +title: Redistribute an ATL Application +description: Learn more about how to redistribute an ATL application. ms.date: "11/04/2016" helpviewer_keywords: ["ATL, redistributing", "redistributing ATL", "redistributing OLE DB templates", "OLE DB templates, redistributing"] ms.assetid: 9a696b22-2345-43ec-826b-be7cb8cfd676 ms.topic: concept-article --- -# Redistributing an ATL application +# Redistribute an ATL application -Starting in Visual Studio 2012, Active Template Library (ATL) is a header-only library. ATL projects do not have a Dynamic Link to ATL option. No redistributable ATL library is required. +Starting in Visual Studio 2012, Active Template Library (ATL) is a header-only library. ATL projects don't have a dynamic link to an ATL option. No redistributable ATL library is required. -If you redistribute an ATL executable application, you must register the .exe file (and any controls inside it) by issuing the following command: +If you redistribute an ATL executable application, you must register the `.exe` file (and any controls inside it). Use the following command: ``` filename /regserver @@ -18,15 +18,16 @@ filename /regserver where `filename` is the name of the executable file. -In Visual Studio 2010, an ATL project can be built for a MinDependency or a MinSize configuration. A MinDependency configuration is what you get when you set the **Use of ATL** property to **Static Link to ATL** on the **General** property page and set the **Runtime Library** property to **Multi-threaded (/MT)** on the **Code Generation** property page (C/C++ folder). +In Visual Studio 2010, you can build an ATL project for a `MinDependency` or a `MinSize` configuration: -A MinSize configuration is what you get when you set the **Use of ATL** property to **Dynamic Link to ATL** on the **General** property page, or set the **Runtime Library** property to **Multi-threaded DLL (/MD)** on the **Code Generation** property page (C/C++ folder). +- To get a `MinDependency` configuration, on the **General** property page, set the **Use of ATL** property to **Static Link to ATL**. On the **Code Generation** property page (C/C++ folder), set the **Runtime Library** property to **Multi-threaded (/MT)**. +- To get a `MinSize` configuration, on the **General** property page, set the **Use of ATL** property to **Dynamic Link to ATL**. Or on the **Code Generation** property page (C/C++ folder), set the **Runtime Library** property to **Multi-threaded DLL (/MD)**. -MinSize makes the output file as small as possible but requires that ATL100.dll and Msvcr100.dll (if you selected the **Multi-threaded DLL (/MD)** option) are on the target computer. ATL100.dll should be registered on the target computer to ensure that all ATL functionality is present. ATL100.dll contains ANSI and Unicode exports. +`MinSize` makes the output file as small as possible but requires that `ATL100.dll` and `Msvcr100.dll` (if you selected the **Multi-threaded DLL (/MD)** option) are on the target computer. Register `ATL100.dll` on the target computer to ensure that all ATL functionality is present. `ATL100.dll` contains ANSI and Unicode exports. -If you build your ATL or OLE DB Templates project for a MinDependency target, you do not need to install and register ATL100.dll on the target computer, although you might get a larger program image. +If you build your ATL or OLE DB templates project for a `MinDependency` target, you don't need to install and register `ATL100.dll` on the target computer, although you might get a larger program image. -If you redistribute an ATL executable application, you must register the .exe file (and any controls inside it) by issuing the following command: +If you redistribute an ATL executable application, you must register the `.exe` file (and any controls inside it). Use the following command: ``` filename /regserver @@ -34,6 +35,6 @@ filename /regserver where `filename` is the name of the executable file. -## See also +## Related content -[Redistributing Visual C++ Files](redistributing-visual-cpp-files.md) +- [Redistribute Visual C++ files](redistributing-visual-cpp-files.md) diff --git a/docs/windows/redistributing-components-by-using-merge-modules.md b/docs/windows/redistributing-components-by-using-merge-modules.md index 531ef3479d0..814fdfb1822 100644 --- a/docs/windows/redistributing-components-by-using-merge-modules.md +++ b/docs/windows/redistributing-components-by-using-merge-modules.md @@ -1,6 +1,6 @@ --- -description: "Learn More About: Redistribute Components by Using Merge Modules" -title: Learn more about redistributing components by using merge modules. +title: Redistribute Components by Using Merge Modules +description: Learn more about how to redistribute components by using merge modules. ms.date: 06/08/2022 helpviewer_keywords: ["merge modules, using", "redistributing applications, using merge modules"] ms.assetid: 93b84211-bf9b-4a78-9f22-474ac2ef7840 @@ -15,7 +15,7 @@ ms.topic: concept-article > > When you use a redistributable package for central deployment, you aren't responsible for tracking and updating the runtime libraries as part of your application maintenance. The Microsoft Update service updates these libraries for you. Otherwise, an update to the runtime library files requires you to update and redeploy your `.msi` installer. Your app could be vulnerable to bugs or security issues until you do. -Visual Studio includes [merge modules](/windows/win32/Msi/about-merge-modules) (`.msm` files) for each Visual C++ component that's licensed for redistribution with an application. There are separate versions of the merge modules for each target platform. When a merge module is compiled into a Windows Installer setup file, it enables the deployment of Visual C++ Redistributable files to that specific platform. You can't include merge modules for different versions of the same dynamic link library (DLL) in one installer. In your installer setup file, specify that the merge modules are prerequisites for your application. +Visual Studio includes [merge modules](/windows/win32/Msi/about-merge-modules) (`.msm` files) for each Visual C++ component that's licensed for redistribution with an application. There are separate versions of the merge modules for each target platform. When a merge module is compiled into a Windows Installer setup file, it enables the deployment of Visual C++ Redistributable files to that specific platform. You can't include merge modules for different versions of the same dynamic-link library (DLL) in one installer. In your installer setup file, specify that the merge modules are prerequisites for your application. You can use merge modules for either [central deployment](deployment-in-visual-cpp.md#central-deployment) or [local deployment](deployment-in-visual-cpp.md#local-deployment). Users can't install centrally deployed files unless they have administrator rights. Local deployment might allow a nonadministrator to install and run your app, but at the cost of independent serviceability. diff --git a/docs/windows/redistributing-the-mfc-library.md b/docs/windows/redistributing-the-mfc-library.md index 313859cce13..470fa794f85 100644 --- a/docs/windows/redistributing-the-mfc-library.md +++ b/docs/windows/redistributing-the-mfc-library.md @@ -1,28 +1,28 @@ --- -description: "Learn More About: Redistribute the MFC Library" -title: Learn more about redistributing the MFC library. +title: Redistribute the MFC Library +description: Learn more about how to redistribute the MFC Library. ms.date: "11/04/2016" helpviewer_keywords: ["MFC, redistributing", "redistributing MFC library"] ms.assetid: 72714ce1-385e-4c1c-afa5-96b03e873866 ms.topic: concept-article --- -# Redistribute the MFC library +# Redistribute the MFC Library -If you dynamically link your application to the Microsoft Foundation Class (MFC) library, you must redistribute the matching MFC dynamic link library (DLL). For example, if your MFC app is built by using the version of MFC that ships with Visual Studio 2015, you must redistribute `mfc140.dll` or `mfc140u.dll`, depending on whether your app is compiled for narrow characters or Unicode support. +If you dynamically link your application to the Microsoft Foundation Class (MFC) Library, you must redistribute the matching MFC dynamic-link library (DLL). For example, if your MFC app is built by using the version of MFC that ships with Visual Studio 2015, you must redistribute `mfc140.dll` or `mfc140u.dll`, depending on whether your app is compiled for narrow characters or Unicode support. > [!NOTE] > The `mfc140.dll` files were omitted from the redistributable files directory in Visual Studio 2015 RTM. You can use the versions installed by Visual Studio 2015 in the `Windows\system32 and Windows\syswow64` directories instead. -Because all MFC DLLs use the shared version of the C runtime library (CRT), you might also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the Universal CRT library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. +Because all MFC DLLs use the shared version of the Microsoft C Runtime Library (CRT), you might also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the Universal CRT Library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. For information on how to redistribute the Universal CRT as an operating system component or by using local deployment, see [Introducing the Universal CRT](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the Universal CRT for central deployment on supported versions of Windows, see [Windows 10 Universal C Runtime](https://www.microsoft.com/download/details.aspx?id=48234). You can find redistributable architecture-specific versions of `ucrtbase.dll` for local deployment in the Windows SDK. By default, Visual Studio installs these versions in `C:\Program Files (x86)\Windows Kits\10\Redist\ucrt\DLLs\` in an architecture-specific subdirectory. -If your app is built by using an earlier version of the MFC library, you must redistribute the matching CRT DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the `msvcr120.dll`. You also have to redistribute the matching `mfc``u.dll` or `mfc``.dll`. +If your app is built by using an earlier version of the MFC Library, you must redistribute the matching CRT DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the `msvcr120.dll`. You also have to redistribute the matching `mfc``u.dll` or `mfc``.dll`. -If you statically link your application to MFC (that is, if you specify **Use MFC in a Static Library** on the **General** tab in the **Property Pages** dialog), you don't have to redistribute an MFC DLL. Although static linking might work for testing and internal deployment of applications, we recommend that you don't use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choose a deployment method](choosing-a-deployment-method.md). +If you statically link your application to MFC (in the **Property Pages** dialog, on the **General** tab, select **Use MFC in a Static Library**), you don't have to redistribute an MFC DLL. Although static linking might work for testing and internal deployment of applications, we recommend that you don't use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choose a deployment method](choosing-a-deployment-method.md). If your application uses the MFC classes that implement the WebBrowser control (for example, [CHtmlView class](../mfc/reference/chtmlview-class.md) or [CHtmlEditView class](../mfc/reference/chtmleditview-class.md)), we recommend that you also install the most current version of Internet Explorer so that the target computer has the most current common control files. (At a minimum, Internet Explorer 4.0 is required.) Information about how to install Internet Explorer components is available in "Article 185375: How to Create a Single EXE Install of Internet Explorer" on the Microsoft Support website. diff --git a/docs/windows/redistributing-visual-cpp-activex-controls.md b/docs/windows/redistributing-visual-cpp-activex-controls.md index 1cb9bd521f7..93b6d3156bf 100644 --- a/docs/windows/redistributing-visual-cpp-activex-controls.md +++ b/docs/windows/redistributing-visual-cpp-activex-controls.md @@ -1,6 +1,6 @@ --- -description: "Learn More About: Redistribute Visual C++ ActiveX Controls" -title: Learn more about redistributing Visual C++ ActiveX controls. +title: Redistribute Visual C++ ActiveX Controls +description: Learn more about how to redistribute Visual C++ ActiveX controls. ms.date: "11/04/2016" helpviewer_keywords: ["controls [C++], redistributing", "controls [C++], distributing"] ms.assetid: eefbb7e4-d28c-4c35-98bf-d9540cfaae83 @@ -23,7 +23,7 @@ When you distribute applications, you must install and register the `.ocx` for t - `Olepro32.dll`\* - `Stdole2.tlb` -If these dynamic link libraries (DLLs) aren't available on the target system, you must get them updated by using the prescribed mechanism for updating the corresponding operating system. +If these dynamic-link libraries (DLLs) aren't available on the target system, you must get them updated by using the prescribed mechanism for updating the corresponding operating system. When you use an ActiveX control that connects to a database, you also need to replicate the data source name on the target computer. You can do this task programmatically with functions such as `ConfigDSN`. diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 049c8d504e3..7e802ee221e 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -1,6 +1,6 @@ --- title: Redistribute Visual C++ Files -description: Visual Studio includes redistributable libraries and components that you can deploy with your app. +description: Learn about Visual Studio redistributable libraries and components that you can deploy with your app. ms.date: 01/15/2025 helpviewer_keywords: ["application deployment [C++], file redistributing", "redistributing applications [C++]", "deploying applications [C++], file redistributing", "file redistribution [C++]", "redistributing applications [C++], about redistributing applications"] ms.topic: concept-article @@ -40,7 +40,7 @@ To view the "REDIST list" that's referenced in the "Distributable Code" section ::: moniker-end -For more information about redistributable files, see [Determine which dynamic link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md) and [Deployment examples](deployment-examples.md). +For more information about redistributable files, see [Determine which dynamic-link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md) and [Deployment examples](deployment-examples.md). ## Locate the redistributable files From e8f28de7c618efccfc4a0cc3f618d34956c6b70a Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 25 Feb 2026 14:38:00 -0800 Subject: [PATCH 1659/1799] add lifecycle note to the ATL docs (#6268) * test * test * fix path * fix note --- docs/atl/includes/lifecycle-note.md | 3 +++ docs/atl/recommendations-for-choosing-between-atl-and-mfc.md | 2 +- docs/atl/tear-off-interfaces-classes.md | 3 ++- docs/mfc/mfc-and-atl.md | 2 +- docs/mfc/reference/adding-atl-support-to-your-mfc-project.md | 4 ++-- .../details-of-atl-support-added-by-the-atl-wizard.md | 2 +- 6 files changed, 10 insertions(+), 6 deletions(-) create mode 100644 docs/atl/includes/lifecycle-note.md diff --git a/docs/atl/includes/lifecycle-note.md b/docs/atl/includes/lifecycle-note.md new file mode 100644 index 00000000000..7d403694aaa --- /dev/null +++ b/docs/atl/includes/lifecycle-note.md @@ -0,0 +1,3 @@ +>[!NOTE] +> The Active Template Library (ATL) continues to be supported. However, we're no longer adding features or updating the documentation. + diff --git a/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md b/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md index df9f94e0a58..f52522b644c 100644 --- a/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md +++ b/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["MFC, ATL support", "ATL, vs. MFC"] # Recommendations for Choosing Between ATL and MFC >[!NOTE] -> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. +> The Microsoft Foundation Classes library (MFC) and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. When developing components and applications, you can choose between two approaches — ATL and MFC (the Microsoft Foundation Class Library). diff --git a/docs/atl/tear-off-interfaces-classes.md b/docs/atl/tear-off-interfaces-classes.md index 0f6c3667bd5..9de3758a0d8 100644 --- a/docs/atl/tear-off-interfaces-classes.md +++ b/docs/atl/tear-off-interfaces-classes.md @@ -4,10 +4,11 @@ title: "Tear-Off Interfaces Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["interfaces, tear-off", "tear-off interfaces classes"] -ms.assetid: 14e4ab01-9213-43e5-bef5-78af1e6206ff --- # Tear-Off Interfaces Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide support for tear-off interfaces: - [CComTearOffObject](../atl/reference/ccomtearoffobject-class.md) Implements `IUnknown` for a tear-off interface. diff --git a/docs/mfc/mfc-and-atl.md b/docs/mfc/mfc-and-atl.md index aa2f69dadc0..424ca2dd106 100644 --- a/docs/mfc/mfc-and-atl.md +++ b/docs/mfc/mfc-and-atl.md @@ -8,7 +8,7 @@ ms.custom: intro-overview # MFC and ATL >[!NOTE] -> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. +> The Microsoft Foundation Classes (MFC) library and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. The Microsoft Foundation Classes (MFC) provide a C++ object-oriented wrapper over Win32 for rapid development of native desktop applications. The Active Template Library (ATL) is a wrapper library that simplifies COM development and is used extensively for creating ActiveX controls. diff --git a/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md b/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md index db988111e96..0648dcb7ea1 100644 --- a/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md +++ b/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md @@ -8,8 +8,8 @@ helpviewer_keywords: ["MFC, ATL support", "ATL, MFC projects"] # Adding ATL Support to Your MFC Project >[!NOTE] -> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. -> Active Template Library (ATL) support applies only to simple COM objects added to an MFC executable or DLL project. You can add other COM objects (including ActiveX controls) to MFC projects, but the objects might not operate as expected. +> The Microsoft Foundation Classes (MFC) library and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. +> ATL support applies only to simple COM objects added to an MFC executable or DLL project. You can add other COM objects (including ActiveX controls) to MFC projects, but the objects might not operate as expected. If you have already created an MFC-based application, then you can add support for the Active Template Library (ATL) easily by using the IDE. diff --git a/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md b/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md index 087069bbf41..938589b2b95 100644 --- a/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md +++ b/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["MFC, ATL support", "ATL, MFC projects"] # Details of ATL Support Added by the ATL Wizard >[!NOTE] -> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. +> The Microsoft Foundation Classes (MFC) library and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. ::: moniker range=">=msvc-160" From 7dd9d68db7ea6b6c5065fdd72bf4c6fef7937c8e Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 25 Feb 2026 14:38:00 -0800 Subject: [PATCH 1660/1799] add lifecycle note to the ATL docs (#6268) * test * test * fix path * fix note --- docs/atl/includes/lifecycle-note.md | 3 +++ docs/atl/recommendations-for-choosing-between-atl-and-mfc.md | 2 +- docs/atl/tear-off-interfaces-classes.md | 3 ++- docs/mfc/mfc-and-atl.md | 2 +- docs/mfc/reference/adding-atl-support-to-your-mfc-project.md | 4 ++-- .../details-of-atl-support-added-by-the-atl-wizard.md | 2 +- 6 files changed, 10 insertions(+), 6 deletions(-) create mode 100644 docs/atl/includes/lifecycle-note.md diff --git a/docs/atl/includes/lifecycle-note.md b/docs/atl/includes/lifecycle-note.md new file mode 100644 index 00000000000..7d403694aaa --- /dev/null +++ b/docs/atl/includes/lifecycle-note.md @@ -0,0 +1,3 @@ +>[!NOTE] +> The Active Template Library (ATL) continues to be supported. However, we're no longer adding features or updating the documentation. + diff --git a/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md b/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md index df9f94e0a58..f52522b644c 100644 --- a/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md +++ b/docs/atl/recommendations-for-choosing-between-atl-and-mfc.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["MFC, ATL support", "ATL, vs. MFC"] # Recommendations for Choosing Between ATL and MFC >[!NOTE] -> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. +> The Microsoft Foundation Classes library (MFC) and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. When developing components and applications, you can choose between two approaches — ATL and MFC (the Microsoft Foundation Class Library). diff --git a/docs/atl/tear-off-interfaces-classes.md b/docs/atl/tear-off-interfaces-classes.md index 0f6c3667bd5..9de3758a0d8 100644 --- a/docs/atl/tear-off-interfaces-classes.md +++ b/docs/atl/tear-off-interfaces-classes.md @@ -4,10 +4,11 @@ title: "Tear-Off Interfaces Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["interfaces, tear-off", "tear-off interfaces classes"] -ms.assetid: 14e4ab01-9213-43e5-bef5-78af1e6206ff --- # Tear-Off Interfaces Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide support for tear-off interfaces: - [CComTearOffObject](../atl/reference/ccomtearoffobject-class.md) Implements `IUnknown` for a tear-off interface. diff --git a/docs/mfc/mfc-and-atl.md b/docs/mfc/mfc-and-atl.md index aa2f69dadc0..424ca2dd106 100644 --- a/docs/mfc/mfc-and-atl.md +++ b/docs/mfc/mfc-and-atl.md @@ -8,7 +8,7 @@ ms.custom: intro-overview # MFC and ATL >[!NOTE] -> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. +> The Microsoft Foundation Classes (MFC) library and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. The Microsoft Foundation Classes (MFC) provide a C++ object-oriented wrapper over Win32 for rapid development of native desktop applications. The Active Template Library (ATL) is a wrapper library that simplifies COM development and is used extensively for creating ActiveX controls. diff --git a/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md b/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md index db988111e96..0648dcb7ea1 100644 --- a/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md +++ b/docs/mfc/reference/adding-atl-support-to-your-mfc-project.md @@ -8,8 +8,8 @@ helpviewer_keywords: ["MFC, ATL support", "ATL, MFC projects"] # Adding ATL Support to Your MFC Project >[!NOTE] -> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. -> Active Template Library (ATL) support applies only to simple COM objects added to an MFC executable or DLL project. You can add other COM objects (including ActiveX controls) to MFC projects, but the objects might not operate as expected. +> The Microsoft Foundation Classes (MFC) library and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. +> ATL support applies only to simple COM objects added to an MFC executable or DLL project. You can add other COM objects (including ActiveX controls) to MFC projects, but the objects might not operate as expected. If you have already created an MFC-based application, then you can add support for the Active Template Library (ATL) easily by using the IDE. diff --git a/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md b/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md index 087069bbf41..938589b2b95 100644 --- a/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md +++ b/docs/mfc/reference/details-of-atl-support-added-by-the-atl-wizard.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["MFC, ATL support", "ATL, MFC projects"] # Details of ATL Support Added by the ATL Wizard >[!NOTE] -> The Microsoft Foundation Classes (MFC) and Active Template Library (ATL) libraries continue to be supported. However, we're no longer adding features or updating the documentation. +> The Microsoft Foundation Classes (MFC) library and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. ::: moniker range=">=msvc-160" From ab0464d5855074eb93dbd328fa10bd2e4c0894a6 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 25 Feb 2026 15:02:17 -0800 Subject: [PATCH 1661/1799] ATL batch 1: docs updates (files 1-94 + cherry-picked commit) --- docs/atl/active-template-library-atl-concepts.md | 3 ++- docs/atl/active-template-library-atl-tutorial.md | 3 ++- docs/atl/adding-a-control-atl-tutorial-part-2.md | 3 ++- docs/atl/adding-a-property-page-atl-tutorial-part-6.md | 3 ++- .../adding-a-property-to-the-control-atl-tutorial-part-3.md | 3 ++- docs/atl/adding-an-atl-message-handler.md | 3 ++- docs/atl/adding-an-event-atl-tutorial-part-5.md | 3 ++- docs/atl/adding-connection-points-to-an-object.md | 2 ++ docs/atl/adding-functionality-to-the-composite-control.md | 3 ++- docs/atl/aggregation.md | 3 ++- docs/atl/atl-and-the-free-threaded-marshaler.md | 3 ++- docs/atl/atl-class-overview.md | 3 ++- docs/atl/atl-collection-and-enumerator-classes.md | 3 ++- docs/atl/atl-collection-classes.md | 3 ++- docs/atl/atl-collections-and-enumerators.md | 3 ++- docs/atl/atl-com-desktop-components.md | 3 ++- docs/atl/atl-com-property-pages.md | 3 ++- docs/atl/atl-composite-control-fundamentals.md | 3 ++- docs/atl/atl-connection-point-classes.md | 3 ++- docs/atl/atl-connection-point-example.md | 3 ++- docs/atl/atl-connection-points.md | 3 ++- docs/atl/atl-copy-policy-classes.md | 3 ++- docs/atl/atl-encoding-reference.md | 3 ++- docs/atl/atl-event-handling-summary.md | 3 ++- docs/atl/atl-module-classes.md | 3 ++- docs/atl/atl-registry-component-registrar.md | 3 ++- docs/atl/atl-services.md | 3 ++- docs/atl/atl-support-for-dhtml-controls.md | 3 ++- docs/atl/atl-utilities-reference.md | 2 ++ docs/atl/atl-window-classes.md | 3 ++- ...fits-and-tradeoffs-of-the-method-used-to-link-to-the-crt.md | 3 ++- docs/atl/building-and-testing-the-atl-project.md | 3 ++- docs/atl/calling-cpp-code-from-dhtml.md | 3 ++- docs/atl/catlservicemodulet-handler-function.md | 3 ++- docs/atl/catlservicemodulet-run-function.md | 3 ++- docs/atl/catlservicemodulet-servicemain-function.md | 3 ++- docs/atl/catlservicemodulet-start-function.md | 3 ++- ...changing-the-default-class-factory-and-aggregation-model.md | 3 ++- docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md | 3 ++- docs/atl/class-factories-classes.md | 3 ++- docs/atl/class-information-classes.md | 3 ++- docs/atl/collection-classes.md | 3 ++- docs/atl/com-modules-classes.md | 3 ++- docs/atl/commandhandler.md | 3 ++- docs/atl/composite-controls-classes.md | 3 ++- docs/atl/connection-points-classes.md | 3 ++- docs/atl/control-containment-classes.md | 3 ++- docs/atl/controls-general-support-classes.md | 3 ++- docs/atl/creating-an-aggregated-object.md | 3 ++- docs/atl/creating-an-atl-dhtml-control.md | 3 ++- docs/atl/creating-registrar-scripts.md | 3 ++- docs/atl/creating-the-project-atl-tutorial-part-1.md | 3 ++- docs/atl/data-transfer-classes.md | 3 ++- docs/atl/data-types-classes.md | 3 ++- docs/atl/dcomcnfg.md | 3 ++- docs/atl/debugging-and-exceptions-classes.md | 3 ++- docs/atl/debugging-tips.md | 3 ++- ...sign-principles-for-collection-and-enumerator-interfaces.md | 3 ++- docs/atl/displaying-assertions.md | 3 ++- docs/atl/dual-interfaces-and-atl.md | 3 ++- docs/atl/dual-interfaces-and-events.md | 3 ++- docs/atl/dual-interfaces-classes.md | 3 ++- docs/atl/enumerators-and-collections-classes.md | 3 ++- docs/atl/error-information-classes.md | 3 ++- docs/atl/event-handling-and-atl.md | 3 ++- docs/atl/event-handling-principles.md | 3 ++- docs/atl/example-implementing-a-property-page.md | 3 ++- docs/atl/file-handling-classes.md | 3 ++- docs/atl/fundamentals-of-atl-com-objects.md | 3 ++- .../identifying-the-elements-of-the-dhtml-control-project.md | 3 ++- docs/atl/implementing-a-dialog-box.md | 3 ++- docs/atl/implementing-a-dual-interface.md | 3 ++- docs/atl/implementing-a-window-with-cwindowimpl.md | 3 ++- docs/atl/implementing-a-window.md | 3 ++- docs/atl/implementing-an-stl-based-collection.md | 3 ++- ...implementing-ccomobject-ccomaggobject-and-ccompolyobject.md | 3 ++- docs/atl/implementing-ccomobjectrootex.md | 3 ++- docs/atl/implementing-property-pages.md | 3 ++- docs/atl/implementing-the-event-handling-interface.md | 3 ++- docs/atl/inserting-a-composite-control.md | 3 ++- docs/atl/interface-pointers-classes.md | 3 ++- docs/atl/interfaces-atl.md | 3 ++- docs/atl/introduction-to-atl-window-classes.md | 3 ++- docs/atl/introduction-to-atl.md | 3 ++- docs/atl/introduction-to-com-and-atl.md | 3 ++- docs/atl/introduction-to-com.md | 3 ++- docs/atl/invoking-scripts.md | 3 ++- docs/atl/iunknown-implementation-classes.md | 3 ++- docs/atl/iunknown.md | 3 ++- docs/atl/linking-to-the-crt-in-your-atl-project.md | 3 ++- docs/atl/marshaling.md | 3 ++- docs/atl/memory-management-classes.md | 3 ++- docs/atl/message-handler-functions.md | 3 ++- docs/atl/message-maps-atl.md | 3 ++- 94 files changed, 188 insertions(+), 92 deletions(-) diff --git a/docs/atl/active-template-library-atl-concepts.md b/docs/atl/active-template-library-atl-concepts.md index cda405159a6..ba5f6335bbc 100644 --- a/docs/atl/active-template-library-atl-concepts.md +++ b/docs/atl/active-template-library-atl-concepts.md @@ -3,11 +3,12 @@ description: "Learn more about: Active Template Library (ATL) Concepts" title: "Active Template Library (ATL) Concepts" ms.date: "05/06/2019" helpviewer_keywords: ["ATL, about ATL"] -ms.assetid: a3960991-4d76-4da5-9568-3fa7fde53ff4 ms.topic: concept-article --- # Active Template Library (ATL) Concepts +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The Active Template Library (ATL) is a set of template-based C++ classes that let you create small, fast Component Object Model (COM) objects. It has special support for key COM features, including stock implementations, dual interfaces, standard COM enumerator interfaces, connection points, tear-off interfaces, and ActiveX controls. If you do a lot of ATL programming, you will want to learn more about COM and .NET attributes, which is designed to simplify COM programming. For more information, see [Attributed Programming](../windows/attributes/cpp-attributes-com-net.md). (COM and .NET attributes are not to be confused with the \[\[attribute]] feature in the C++ standard.) diff --git a/docs/atl/active-template-library-atl-tutorial.md b/docs/atl/active-template-library-atl-tutorial.md index 2a9841ea00c..e8054c8897f 100644 --- a/docs/atl/active-template-library-atl-tutorial.md +++ b/docs/atl/active-template-library-atl-tutorial.md @@ -4,11 +4,12 @@ description: "Create an ActiveX control using Microsoft C++ and the Active Templ ms.custom: "get-started-article" ms.date: "05/03/2019" helpviewer_keywords: ["ATL projects, tutorials", "controls [ATL], tutorials", "ATL tutorial", "tutorials [ATL]", "ATL, tutorials"] -ms.assetid: f921a121-09c8-4812-9317-e15b2f1471fa ms.topic: tutorial --- # Active Template Library (ATL) Tutorial +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL is designed to simplify the process of creating efficient, flexible, lightweight controls. This tutorial leads you through the creation of an ActiveX control, demonstrating many ATL and COM fundamentals. By following this tutorial, you will learn how to add a control to an ATL project that draws a circle and a filled polygon. You will then add a property to indicate how many sides the polygon will have and create drawing code for updating the control when the property changes. The control will then be displayed on a Web page using some VBScript to make it respond to events. diff --git a/docs/atl/adding-a-control-atl-tutorial-part-2.md b/docs/atl/adding-a-control-atl-tutorial-part-2.md index 668cb2039f1..f0cdb0d25aa 100644 --- a/docs/atl/adding-a-control-atl-tutorial-part-2.md +++ b/docs/atl/adding-a-control-atl-tutorial-part-2.md @@ -3,11 +3,12 @@ description: "Learn more about: Adding a Control (ATL Tutorial, Part 2)" title: "Adding a Control (ATL Tutorial, Part 2)" ms.custom: "get-started-article" ms.date: "08/19/2019" -ms.assetid: c9575a75-1064-41f1-9697-7aada560c669 ms.topic: tutorial --- # Adding a Control (ATL Tutorial, Part 2) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + In this step, you add a control to your project, build it, and test it on a Web page. ## Procedures diff --git a/docs/atl/adding-a-property-page-atl-tutorial-part-6.md b/docs/atl/adding-a-property-page-atl-tutorial-part-6.md index 394d9aff8da..1d169bed706 100644 --- a/docs/atl/adding-a-property-page-atl-tutorial-part-6.md +++ b/docs/atl/adding-a-property-page-atl-tutorial-part-6.md @@ -3,11 +3,12 @@ description: "Learn more about: Adding a Property Page (ATL Tutorial, Part 6)" title: "Adding a Property Page (ATL Tutorial, Part 6)" ms.custom: "get-started-article" ms.date: "09/27/2018" -ms.assetid: df80d255-e7ea-49d9-b940-3f012e90cf9b ms.topic: tutorial --- # Adding a Property Page (ATL Tutorial, Part 6) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + > [!NOTE] > The ATL OLE DB Provider wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md b/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md index 839a2653ed1..852dd925637 100644 --- a/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md +++ b/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md @@ -3,11 +3,12 @@ description: "Learn more about: Adding a Property to the Control (ATL Tutorial, title: "Adding a Property to the Control (ATL Tutorial, Part 3)" ms.custom: "get-started-article" ms.date: "09/26/2018" -ms.assetid: f775fe34-103b-4f07-9999-400e987ee030 ms.topic: tutorial --- # Adding a Property to the Control (ATL Tutorial, Part 3) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + `IPolyCtl` is the interface that contains the control's custom methods and properties, and you will add a property to it. ### To add the property definitions to your project diff --git a/docs/atl/adding-an-atl-message-handler.md b/docs/atl/adding-an-atl-message-handler.md index ee2243126a9..178eb55484c 100644 --- a/docs/atl/adding-an-atl-message-handler.md +++ b/docs/atl/adding-an-atl-message-handler.md @@ -3,11 +3,12 @@ description: "Learn more about: Adding an ATL Message Handler" title: "Adding an ATL Message Handler" ms.date: "11/04/2016" helpviewer_keywords: ["message handlers [C++]", "ATL, windows", "message handling [C++], ATL message handler", "windows [C++], ATL", "ATL, message handlers"] -ms.assetid: cdea38a1-0d9b-4f8d-bbd5-b4f063fb3eeb ms.topic: concept-article --- # Adding an ATL Message Handler +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + To add a message handler (a member function that handles Windows messages) to a control, first select the control in the Class View. Then open the **Properties** window, select the **Messages** icon, and click the drop-down control in the box opposite the required message. This will add a declaration for the message handler in the control's header file and a skeleton implementation of the handler in the control's .cpp file. It will also add the message map and add an entry for the handler. Adding a message handler in ATL is similar to adding a message handler to an MFC class. See [Adding an MFC Message Handler](../mfc/reference/adding-an-mfc-message-handler.md) for more information. diff --git a/docs/atl/adding-an-event-atl-tutorial-part-5.md b/docs/atl/adding-an-event-atl-tutorial-part-5.md index 48d9ef8f01d..ed1690d4df0 100644 --- a/docs/atl/adding-an-event-atl-tutorial-part-5.md +++ b/docs/atl/adding-an-event-atl-tutorial-part-5.md @@ -3,11 +3,12 @@ description: "Learn more about: Adding an Event (ATL Tutorial, Part 5)" title: "Adding an Event (ATL Tutorial, Part 5)" ms.custom: "get-started-article" ms.date: "09/27/2018" -ms.assetid: 2de12022-3148-4ce3-8606-8a9d4274f0e9 ms.topic: tutorial --- # Adding an Event (ATL Tutorial, Part 5) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + In this step, you will add a `ClickIn` and a `ClickOut` event to your ATL control. You will fire the `ClickIn` event if the user clicks within the polygon and fire `ClickOut` if the user clicks outside. The tasks to add an event are as follows: - Adding the `ClickIn` and `ClickOut` methods diff --git a/docs/atl/adding-connection-points-to-an-object.md b/docs/atl/adding-connection-points-to-an-object.md index d2564c44cd6..732d3688c9c 100644 --- a/docs/atl/adding-connection-points-to-an-object.md +++ b/docs/atl/adding-connection-points-to-an-object.md @@ -7,6 +7,8 @@ ms.topic: how-to --- # Adding Connection Points to an Object +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The [ATL Tutorial](active-template-library-atl-tutorial.md) demonstrates how to create a control with support for connection points, how to add events, and then how to implement the connection point. ATL implements connection points with the [`IConnectionPointImpl`](reference/iconnectionpointimpl-class.md) class. To implement a connection point, you have two choices: diff --git a/docs/atl/adding-functionality-to-the-composite-control.md b/docs/atl/adding-functionality-to-the-composite-control.md index 35766209450..f32c146abd8 100644 --- a/docs/atl/adding-functionality-to-the-composite-control.md +++ b/docs/atl/adding-functionality-to-the-composite-control.md @@ -3,11 +3,12 @@ description: "Learn more about: Adding Functionality to the Composite Control" title: "Adding Functionality to the Composite Control" ms.date: "11/04/2016" helpviewer_keywords: ["event handlers [C++], ActiveX controls", "composite controls, handling events", "ActiveX controls [C++], events"] -ms.assetid: 98f85681-9564-480d-af38-03f9733fe58b ms.topic: concept-article --- # Adding Functionality to the Composite Control +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Once you have inserted any necessary controls into the composite control, the next step involves adding new functionality. This new functionality usually falls into two categories: - Supporting additional interfaces and customizing the behavior of your composite control with additional, specific features. diff --git a/docs/atl/aggregation.md b/docs/atl/aggregation.md index 36c510daf37..e1b0448277a 100644 --- a/docs/atl/aggregation.md +++ b/docs/atl/aggregation.md @@ -3,10 +3,11 @@ description: "Learn more about: Aggregation" title: "Aggregation" ms.date: "11/04/2016" helpviewer_keywords: ["aggregation [C++]", "aggregate objects [C++]"] -ms.assetid: 7125bb8e-b269-4b50-9bba-295b467a54cc --- # Aggregation +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + There are times when an object's implementor would like to take advantage of the services offered by another, prebuilt object. Furthermore, it would like this second object to appear as a natural part of the first. COM achieves both of these goals through containment and aggregation. Aggregation means that the containing (outer) object creates the contained (inner) object as part of its creation process and the interfaces of the inner object are exposed by the outer. An object allows itself to be aggregatable or not. If it is, then it must follow certain rules for aggregation to work properly. diff --git a/docs/atl/atl-and-the-free-threaded-marshaler.md b/docs/atl/atl-and-the-free-threaded-marshaler.md index 5d5e78c8a63..b496b5b4fc8 100644 --- a/docs/atl/atl-and-the-free-threaded-marshaler.md +++ b/docs/atl/atl-and-the-free-threaded-marshaler.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL and the Free Threaded Marshaler" title: "ATL and the Free Threaded Marshaler" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, free threaded marshaler", "free threaded marshaler", "threading [C++], marshaler in ATL", "threading [ATL], free threaded marshaler", "FTM in ATL"] -ms.assetid: 2db88a13-2217-4ebc-aa7e-432d5da902eb --- # ATL and the Free Threaded Marshaler +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The ATL Simple Object Wizard's Attributes page provides an option that allows your class to aggregate the free threaded marshaler (FTM). The wizard generates code to create an instance of the free threaded marshaler in `FinalConstruct` and release that instance in `FinalRelease`. A COM_INTERFACE_ENTRY_AGGREGATE macro is automatically added to the COM map to ensure that `QueryInterface` requests for [IMarshal](/windows/win32/api/objidlbase/nn-objidlbase-imarshal) are handled by the free threaded marshaler. diff --git a/docs/atl/atl-class-overview.md b/docs/atl/atl-class-overview.md index 98846a0de5f..bf22cf76fca 100644 --- a/docs/atl/atl-class-overview.md +++ b/docs/atl/atl-class-overview.md @@ -3,11 +3,12 @@ description: "Learn more about: ATL class overview" title: "ATL class overview" ms.date: "11/04/2016" helpviewer_keywords: ["classes [C++], ATL", "ATL, class reference"] -ms.assetid: c38ac93d-c3a2-4ce7-8153-f1d34c0f0fa6 ms.topic: concept-article --- # ATL class overview +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Classes in the Active Template Library (ATL) can be categorized as follows: [Class factories](../atl/class-factories-classes.md)\ diff --git a/docs/atl/atl-collection-and-enumerator-classes.md b/docs/atl/atl-collection-and-enumerator-classes.md index d96c74e5703..b887eabdb83 100644 --- a/docs/atl/atl-collection-and-enumerator-classes.md +++ b/docs/atl/atl-collection-and-enumerator-classes.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Collection and Enumerator Classes" title: "ATL Collection and Enumerator Classes" ms.date: "11/04/2016" helpviewer_keywords: ["enumerators, ATL classes", "collection classes, ATL"] -ms.assetid: 6818db73-7094-48d8-a0ca-18147beec362 --- # ATL Collection and Enumerator Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL provides the following classes to help you implement collections and enumerators. |Class|Description| diff --git a/docs/atl/atl-collection-classes.md b/docs/atl/atl-collection-classes.md index db96014d6f0..bd9c02edc03 100644 --- a/docs/atl/atl-collection-classes.md +++ b/docs/atl/atl-collection-classes.md @@ -3,11 +3,12 @@ description: "Learn more about: ATL Collection Classes" title: "ATL collection class overview" ms.date: "11/19/2018" helpviewer_keywords: ["DestructElements function", "collection classes, choosing", "ConstructElements function", "SerializeElements function", "traits classes", "collection classes, about collection classes", "CTraits classes", "collection classes"] -ms.assetid: 4d619d46-5b4e-41dd-b9fd-e86b1fbc00b5 ms.topic: concept-article --- # ATL Collection Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL provides many classes for storing and accessing data. Which class you decide to use depends on several factors, including: - The amount of data to be stored diff --git a/docs/atl/atl-collections-and-enumerators.md b/docs/atl/atl-collections-and-enumerators.md index 68eea6e6f86..ba991026b3c 100644 --- a/docs/atl/atl-collections-and-enumerators.md +++ b/docs/atl/atl-collections-and-enumerators.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Collections and Enumerators" title: "ATL Collections and Enumerators" ms.date: "11/04/2016" helpviewer_keywords: ["enumerator interfaces", "collections, ATL classes", "enumerators, ATL classes", "collection interfaces"] -ms.assetid: b2d37119-3ab2-4e0a-b65b-f377f07e4098 --- # ATL Collections and Enumerators +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + A `collection` is a COM object that provides an interface that allows access to a group of data items (raw data or other objects). An interface that follows the standards for providing access to a group of objects is known as a *collection interface*. At a minimum, collection interfaces must provide a `Count` property that returns the number of items in the collection, an `Item` property that returns an item from the collection based on an index, and a `_NewEnum` property that returns an enumerator for the collection. Optionally, collection interfaces can provide `Add` and `Remove` methods to allow items to be inserted into or deleted from the collection, and a `Clear` method to remove all items. diff --git a/docs/atl/atl-com-desktop-components.md b/docs/atl/atl-com-desktop-components.md index 3d5d2ad0c96..e12f41f8be4 100644 --- a/docs/atl/atl-com-desktop-components.md +++ b/docs/atl/atl-com-desktop-components.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL COM Desktop Components" title: "ATL COM Desktop Components" ms.date: "10/19/2018" helpviewer_keywords: ["ATL, reference", "ATL, about ATL"] -ms.assetid: 291f38d1-d2de-4687-86a9-99b4fd35706c --- # ATL COM Desktop Components +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The ATL Reference documents the Active Template Library (ATL), a set of template-based C++ classes that simplify the programming of Component Object Model (COM) objects. COM is a binary specification for creating and consuming software components on Windows. To fully take advantage of ATL, a working familiarity with COM is highly recommended. For more information about COM, see [Component Object Model (COM)](/windows/win32/com/component-object-model--com--portal). ## In This Section diff --git a/docs/atl/atl-com-property-pages.md b/docs/atl/atl-com-property-pages.md index 109d83b95c0..3b84ea0421e 100644 --- a/docs/atl/atl-com-property-pages.md +++ b/docs/atl/atl-com-property-pages.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL COM Property Pages" title: "ATL COM Property Pages" ms.date: "11/04/2016" helpviewer_keywords: ["property pages, COM", "ATL COM objects", "COM property pages", "property pages, ATL", "COM objects, ATL", "ATL property pages"] -ms.assetid: 663c7caa-2e5e-4b5c-b8ea-fd434ceb1654 --- # ATL COM Property Pages +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + COM property pages provide a user interface for setting the properties (or calling the methods) of one or more COM objects. Property pages are used extensively by ActiveX controls for providing rich user interfaces that allow control properties to be set at design time. Property pages are COM objects that implement the [IPropertyPage](/windows/win32/api/ocidl/nn-ocidl-ipropertypage) or [IPropertyPage2](/windows/win32/api/ocidl/nn-ocidl-ipropertypage2) interface. These interfaces provide methods that allow the page to be associated with a `site` (a COM object representing the container of the page) and a number of *objects* (COM objects whose methods will be called in response to changes made by the user of the property page). The property page container is responsible for calling methods on the property page interface to tell the page when to show or hide its user interface, and when to apply the changes made by the user to the underlying objects. diff --git a/docs/atl/atl-composite-control-fundamentals.md b/docs/atl/atl-composite-control-fundamentals.md index 99d5bc76e01..c96615a0bd2 100644 --- a/docs/atl/atl-composite-control-fundamentals.md +++ b/docs/atl/atl-composite-control-fundamentals.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Composite Control Fundamentals" title: "ATL Composite Control Fundamentals" ms.date: "11/04/2016" helpviewer_keywords: ["composite controls, about composite controls"] -ms.assetid: 2ac78cdd-1ec4-4d78-871c-1bcc23b5253e --- # ATL Composite Control Fundamentals +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + A composite control is a type of ActiveX control that can contain (similar to a dialog box) other ActiveX controls or Windows controls. Once the composite control is built, it can be inserted anywhere an ActiveX control can be hosted. The ATL Project Wizard and **Add Class** dialog box automate the process of creating and implementing a composite control project, similar to the result of running the Application Wizard to create an MFC application framework. The development process consists of five steps: diff --git a/docs/atl/atl-connection-point-classes.md b/docs/atl/atl-connection-point-classes.md index 9de4d1eaf44..21d955c22e5 100644 --- a/docs/atl/atl-connection-point-classes.md +++ b/docs/atl/atl-connection-point-classes.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Connection Point Classes" title: "ATL Connection Point Classes" ms.date: "11/04/2016" helpviewer_keywords: ["CFirePropNotifyEvent class, connection point classes", "connection points [C++], ATL classes", "ATL, connection points", "CComDynamicUnkArray class, connection point classes", "CFirePropNotifyEvent class", "CComUnkArray class, connection point classes"] -ms.assetid: 9582ba71-7ace-4df4-9c9b-1b0636953efc --- # ATL Connection Point Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL uses the following classes to support connection points: - [IConnectionPointImpl](../atl/reference/iconnectionpointimpl-class.md) implements a connection point. The IID of the outgoing interface it represents is passed as a template parameter. diff --git a/docs/atl/atl-connection-point-example.md b/docs/atl/atl-connection-point-example.md index 0a7cf22ac7a..c837053c9e1 100644 --- a/docs/atl/atl-connection-point-example.md +++ b/docs/atl/atl-connection-point-example.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Connection Point Example" title: "ATL Connection Point Example" ms.date: "11/04/2016" helpviewer_keywords: ["connection points [C++], examples", "examples [ATL]"] -ms.assetid: a49721b7-f308-43de-8868-f662a94bc81a --- # ATL Connection Point Example +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + This example shows an object that supports [IPropertyNotifySink](/windows/win32/api/ocidl/nn-ocidl-ipropertynotifysink) as an outgoing interface: [!code-cpp[NVC_ATL_Windowing#84](../atl/codesnippet/cpp/atl-connection-point-example_1.h)] diff --git a/docs/atl/atl-connection-points.md b/docs/atl/atl-connection-points.md index 9bad34db0b4..cb3f08ffa9f 100644 --- a/docs/atl/atl-connection-points.md +++ b/docs/atl/atl-connection-points.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Connection Points" title: "ATL Connection Points" ms.date: "11/04/2016" helpviewer_keywords: ["connections, connection points", "ATL, connection points", "connection points [C++], about connection points"] -ms.assetid: 17d76165-5f83-4f95-b36d-483821c247a1 --- # ATL Connection Points +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + A connectable object is one that supports outgoing interfaces. An outgoing interface allows the object to communicate with a client. For each outgoing interface, the connectable object exposes a connection point. Each outgoing interface is implemented by a client on an object called a sink. ![Diagram that shows the connection points on a client object and a connectable object.](../atl/media/vc2zw31.gif "Connection points") diff --git a/docs/atl/atl-copy-policy-classes.md b/docs/atl/atl-copy-policy-classes.md index 08787e3fe9b..0c2aad5b629 100644 --- a/docs/atl/atl-copy-policy-classes.md +++ b/docs/atl/atl-copy-policy-classes.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Copy Policy Classes" title: "ATL Copy Policy Classes" ms.date: "11/04/2016" helpviewer_keywords: ["data [C++], ATL", "classes [C++], copy policy", "copy policy classes [C++]", "_Copy class", "_CopyInterface class"] -ms.assetid: 06704b68-d318-4c5d-a65b-71457fe9d00d --- # ATL Copy Policy Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Copy policy classes are [utility classes](../atl/utility-classes.md) used to initialize, copy, and delete data. Copy policy classes allow you to define copy semantics for any type of data, and to define conversions between different data types. ATL uses copy policy classes in its implementations of the following templates: diff --git a/docs/atl/atl-encoding-reference.md b/docs/atl/atl-encoding-reference.md index e7153b05201..36787474f2a 100644 --- a/docs/atl/atl-encoding-reference.md +++ b/docs/atl/atl-encoding-reference.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Encoding Reference" title: "ATL Encoding Reference" ms.date: "11/04/2016" helpviewer_keywords: ["encoding", "encoding, functions"] -ms.assetid: 82d4fdf3-3c4a-4fe2-b297-8ffb4714406f --- # ATL Encoding Reference +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Encoding in a range of common Internet standards such as uuencode, hexadecimal, and UTF8 is supported by the code found in *`atlenc.h`*. ### Functions diff --git a/docs/atl/atl-event-handling-summary.md b/docs/atl/atl-event-handling-summary.md index 166f1d40284..55d8eabacca 100644 --- a/docs/atl/atl-event-handling-summary.md +++ b/docs/atl/atl-event-handling-summary.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Event Handling Summary" title: "ATL Event Handling Summary" ms.date: "11/04/2016" helpviewer_keywords: ["event handling, implementing"] -ms.assetid: e8b47ef0-0bdc-47ff-9dd6-34df11dde9a2 --- # ATL Event Handling Summary +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + In general, handling COM events is a relatively simple process. There are three main steps: - Implement the event interface on your object. diff --git a/docs/atl/atl-module-classes.md b/docs/atl/atl-module-classes.md index 4613d5af005..512b96192d5 100644 --- a/docs/atl/atl-module-classes.md +++ b/docs/atl/atl-module-classes.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Module Classes" title: "ATL Module Classes" ms.date: "11/04/2016" helpviewer_keywords: ["CComModule class, what's changed", "ATL, module classes", "module classes"] -ms.assetid: fd75382d-c955-46ba-a38e-37728b7fa00f --- # ATL Module Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + This topic discusses the module classes that were new in ATL 7.0. ## CComModule Replacement Classes diff --git a/docs/atl/atl-registry-component-registrar.md b/docs/atl/atl-registry-component-registrar.md index 6fc68ca1fc2..3615ba7fc45 100644 --- a/docs/atl/atl-registry-component-registrar.md +++ b/docs/atl/atl-registry-component-registrar.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Registry Component (Registrar)" title: "ATL Registry Component (Registrar)" ms.date: "11/04/2016" helpviewer_keywords: ["scripting, registry scripting", "ATL, registry", "registrar scripts [ATL]", "registry, accessing", "ATL Registrar", "scripts, Registrar scripts", "registry, Registrar"] -ms.assetid: 106752ae-4cfc-4030-8cb2-d36a1d635a2e --- # ATL Registry Component (Registrar) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The ATL Registrar provides optimized access to the system registry through a custom interface. The Registrar is free-threaded and allows static linking of code for C++ clients. > [!NOTE] diff --git a/docs/atl/atl-services.md b/docs/atl/atl-services.md index 4acde07ca7e..591a7222173 100644 --- a/docs/atl/atl-services.md +++ b/docs/atl/atl-services.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Services" title: "ATL Services" ms.date: "11/04/2016" helpviewer_keywords: ["CServiceModule class", "COM objects, ATL", "services, ATL", "ATL services"] -ms.assetid: 8c09d1a8-7548-4d2c-947c-9d795a81659b --- # ATL Services +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + To create your ATL COM object so that it runs in a service, simply select Service (EXE) from the list of server options in the ATL Project Wizard. The wizard will then create a class derived from `CAtlServiceModuleT` to implement the service. When the ATL COM object is built as a service, it will only be registered as a local server, and it will not appear in the list of services in Control Panel. This is because it is easier to debug the service as a local server than as a service. To install it as a service, run the following at the command prompt: diff --git a/docs/atl/atl-support-for-dhtml-controls.md b/docs/atl/atl-support-for-dhtml-controls.md index eca0e2fe0b1..2a2f8c091f8 100644 --- a/docs/atl/atl-support-for-dhtml-controls.md +++ b/docs/atl/atl-support-for-dhtml-controls.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Support for DHTML Controls" title: "ATL Support for DHTML Controls" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, ATL support", "DHTML controls, ATL support", "DHTML controls"] -ms.assetid: 4ba98098-da5d-4362-96ad-8372f816c307 --- # ATL Support for DHTML Controls +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Using ATL, you can create a control with Dynamic HTML (DHTML) capability. An ATL DHTML control: - Hosts the WebBrowser control. diff --git a/docs/atl/atl-utilities-reference.md b/docs/atl/atl-utilities-reference.md index d903e4dbab6..19120124b84 100644 --- a/docs/atl/atl-utilities-reference.md +++ b/docs/atl/atl-utilities-reference.md @@ -5,6 +5,8 @@ ms.date: 11/04/2016 --- # ATL utilities reference +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl/reference/cpatht-class.md) and [CUrl](../atl/reference/curl-class.md). A thread pool, [CThreadPool](../atl/reference/cthreadpool-class.md), can be used in your applications. This code can be found in atlpath.h and atlutil.h. ## Classes diff --git a/docs/atl/atl-window-classes.md b/docs/atl/atl-window-classes.md index bf9968a0313..92c7c453843 100644 --- a/docs/atl/atl-window-classes.md +++ b/docs/atl/atl-window-classes.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Window Classes" title: "ATL Window Classes" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "windows [C++], subclassing", "windows [C++], superclassing", "windows [C++], ATL", "subclassing ATL window classes", "superclassing", "superclassing, ATL"] -ms.assetid: 1d12b708-de3e-49d5-9e41-42fe4769fa62 --- # ATL Window Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL includes several classes that allow you to use and implement windows. These classes, like other ATL classes, provide an efficient implementation that does not impose an overhead on your code. This section describes the ATL window classes and explains how to use them. diff --git a/docs/atl/benefits-and-tradeoffs-of-the-method-used-to-link-to-the-crt.md b/docs/atl/benefits-and-tradeoffs-of-the-method-used-to-link-to-the-crt.md index d84c7e8e639..3c3d0fe0276 100644 --- a/docs/atl/benefits-and-tradeoffs-of-the-method-used-to-link-to-the-crt.md +++ b/docs/atl/benefits-and-tradeoffs-of-the-method-used-to-link-to-the-crt.md @@ -3,10 +3,11 @@ description: "Learn more about: Benefits and Tradeoffs of the Method Used to Lin title: "Benefits and Tradeoffs of the Method Used to Link to the CRT" ms.date: "05/06/2019" helpviewer_keywords: ["_ATL_MIN_CRT macro"] -ms.assetid: 49b485f7-9487-49e4-b12a-0f710b620e2b --- # Benefits and Tradeoffs of the Method Used to Link to the CRT +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Your project can link with the CRT either dynamically or statically. The table below outlines the benefits and tradeoffs involved in choosing which method to use. |Method|Benefit|Tradeoff| diff --git a/docs/atl/building-and-testing-the-atl-project.md b/docs/atl/building-and-testing-the-atl-project.md index d5920c6e591..53aebdcc5e4 100644 --- a/docs/atl/building-and-testing-the-atl-project.md +++ b/docs/atl/building-and-testing-the-atl-project.md @@ -3,11 +3,12 @@ description: "Learn more about: Building and Testing the ATL Project" title: "Building and Testing the ATL Project" ms.date: "11/04/2016" helpviewer_keywords: ["composite controls, building and testing the project", "composite controls, containers for"] -ms.assetid: 5c1541f8-f6cb-4c22-bd22-c66bcfbaa077 ms.topic: concept-article --- # Building and Testing the ATL Project +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + As mentioned in [Inserting a Composite Control](../atl/inserting-a-composite-control.md), one of the initial components of the project is a default HTML page that hosts your new composite control. After you finish modifying the composite control, click **Build Solution** or **Rebuild Solution** from the **Build** menu. Once the project successfully builds, load the HTML page, located in the root directory of your composite control project, into Internet Explorer or another browser and test the functionality of your control. You can also test your composite control using the Test Container tool, or any other application that can host an ActiveX control. See [Testing Properties and Events with Test Container](../mfc/testing-properties-and-events-with-test-container.md) for information on how to access the test container. diff --git a/docs/atl/calling-cpp-code-from-dhtml.md b/docs/atl/calling-cpp-code-from-dhtml.md index a5d05fe09ee..03f3e87a0d4 100644 --- a/docs/atl/calling-cpp-code-from-dhtml.md +++ b/docs/atl/calling-cpp-code-from-dhtml.md @@ -3,11 +3,12 @@ description: "Learn more about: Calling C++ Code from DHTML" title: "Calling C++ Code from DHTML" ms.date: "11/04/2016" helpviewer_keywords: ["DHTML, calling C++ code from"] -ms.assetid: 37329acd-4c22-40ca-a85a-b7480748f75f ms.topic: concept-article --- # Calling C++ Code from DHTML +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + A DHTML control can be hosted in a container, such as Test Container or Internet Explorer. See [Testing Properties and Events with Test Container](../mfc/testing-properties-and-events-with-test-container.md) for information on how to access Test Container. The container hosting the control communicates with the control using the normal control interfaces. DHTML uses the dispatch interface that ends with "UI" to communicate with your C++ code and your HTML resource. In [Modifying the ATL DHTML Control](../atl/modifying-the-atl-dhtml-control.md), you can practice adding the methods to be called by these different interfaces. diff --git a/docs/atl/catlservicemodulet-handler-function.md b/docs/atl/catlservicemodulet-handler-function.md index a2da13bec83..c21778eec43 100644 --- a/docs/atl/catlservicemodulet-handler-function.md +++ b/docs/atl/catlservicemodulet-handler-function.md @@ -3,10 +3,11 @@ description: "Learn more about: CAtlServiceModuleT::Handler Function" title: "CAtlServiceModuleT::Handler Function" ms.date: "11/04/2016" helpviewer_keywords: ["Handler method"] -ms.assetid: 14db5f2a-be87-4774-a296-445cb6fc7b2e --- # CAtlServiceModuleT::Handler Function +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + `CAtlServiceModuleT::Handler` is the routine that the service control manager (SCM) calls to retrieve the status of the service and give it various instructions (such as stopping or pausing). The SCM passes an operation code to `Handler` to indicate what the service should do. A default ATL-generated service only handles the stop instruction. If the SCM passes the stop instruction, the service tells the SCM that the program is about to stop. The service then calls `PostThreadMessage` to post a quit message to itself. This terminates the message loop and the service will ultimately close. To handle more instructions, you need to change the `m_status` data member initialized in the `CAtlServiceModuleT` constructor. This data member tells the SCM which buttons to enable when the service is selected in the Services Control Panel application. diff --git a/docs/atl/catlservicemodulet-run-function.md b/docs/atl/catlservicemodulet-run-function.md index 9471ee390a8..e9aadfc95c2 100644 --- a/docs/atl/catlservicemodulet-run-function.md +++ b/docs/atl/catlservicemodulet-run-function.md @@ -3,10 +3,11 @@ description: "Learn more about: CAtlServiceModuleT::Run Function" title: "CAtlServiceModuleT::Run Function" ms.date: "11/04/2016" helpviewer_keywords: ["ATL services, security"] -ms.assetid: 42c010f0-e60e-459c-a63b-a53a24cda93b --- # CAtlServiceModuleT::Run Function +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + `Run` contains calls to `PreMessageLoop`, `RunMessageLoop`, and `PostMessageLoop`. After being called, `PreMessageLoop` first stores the service's thread ID. The service will use this ID to close itself by sending a WM_QUIT message using the Win32 API function, [PostThreadMessage](/windows/win32/api/winuser/nf-winuser-postthreadmessagew). `PreMessageLoop` then calls `InitializeSecurity`. By default, `InitializeSecurity` calls [CoInitializeSecurity](/windows/win32/api/combaseapi/nf-combaseapi-coinitializesecurity) with the security descriptor set to NULL, which means that any user has access to your object. diff --git a/docs/atl/catlservicemodulet-servicemain-function.md b/docs/atl/catlservicemodulet-servicemain-function.md index f3cfffa7fd3..f037a2ca6ae 100644 --- a/docs/atl/catlservicemodulet-servicemain-function.md +++ b/docs/atl/catlservicemodulet-servicemain-function.md @@ -3,10 +3,11 @@ description: "Learn more about: CAtlServiceModuleT::ServiceMain Function" title: "CAtlServiceModuleT::ServiceMain Function" ms.date: "11/04/2016" helpviewer_keywords: ["ServiceMain method"] -ms.assetid: f21408c1-1919-4dec-88d8-bf5b39ac9808 --- # CAtlServiceModuleT::ServiceMain Function +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The service control manager (SCM) calls `ServiceMain` when you open the Services Control Panel application, select the service, and click **Start**. After the SCM calls `ServiceMain`, a service must give the SCM a handler function. This function lets the SCM obtain the service's status and pass specific instructions (such as pausing or stopping). The SCM gets this function when the service passes `_Handler` to the Win32 API function, [RegisterServiceCtrlHandler](/windows/win32/api/winsvc/nf-winsvc-registerservicectrlhandlerw). (`_Handler` is a static member function that calls the non-static member function [Handler](../atl/reference/catlservicemodulet-class.md#handler).) diff --git a/docs/atl/catlservicemodulet-start-function.md b/docs/atl/catlservicemodulet-start-function.md index 920857413d4..670a2023aee 100644 --- a/docs/atl/catlservicemodulet-start-function.md +++ b/docs/atl/catlservicemodulet-start-function.md @@ -3,10 +3,11 @@ description: "Learn more about: CAtlServiceModuleT::Start Function" title: "CAtlServiceModuleT::Start Function" ms.date: "11/04/2016" helpviewer_keywords: ["Start method"] -ms.assetid: b5193a23-41bc-42d2-8d55-3eb43dc62238 --- # CAtlServiceModuleT::Start Function +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + When the service is run, `_tWinMain` calls `CAtlServiceModuleT::WinMain`, which in turn calls `CAtlServiceModuleT::Start`. `CAtlServiceModuleT::Start` sets up an array of `SERVICE_TABLE_ENTRY` structures that map each service to its startup function. This array is then passed to the Win32 API function, [StartServiceCtrlDispatcher](/windows/win32/api/winsvc/nf-winsvc-startservicectrldispatcherw). In theory, one EXE could handle multiple services and the array could have multiple `SERVICE_TABLE_ENTRY` structures. Currently, however, an ATL-generated service supports only one service per EXE. Therefore, the array has a single entry that contains the service name and `_ServiceMain` as the startup function. `_ServiceMain` is a static member function of `CAtlServiceModuleT` that calls the non-static member function, `ServiceMain`. diff --git a/docs/atl/changing-the-default-class-factory-and-aggregation-model.md b/docs/atl/changing-the-default-class-factory-and-aggregation-model.md index 78b9ca1c8a0..31cf67c1254 100644 --- a/docs/atl/changing-the-default-class-factory-and-aggregation-model.md +++ b/docs/atl/changing-the-default-class-factory-and-aggregation-model.md @@ -3,11 +3,12 @@ description: "Learn more about: Changing the Default Class Factory and Aggregati title: "Changing the Default Class Factory and Aggregation Model" ms.date: "11/04/2016" helpviewer_keywords: ["CComClassFactory class, making the default", "aggregation [C++], using ATL", "aggregation [C++], aggregation models", "defaults [C++], aggregation model in ATL", "default class factory", "class factories, changing default", "CComCoClass class, default class factory and aggregation model", "default class factory, ATL", "defaults [C++], class factory"] -ms.assetid: 6e040e95-0f38-4839-8a8b-c9800dd47e8c ms.topic: concept-article --- # Changing the Default Class Factory and Aggregation Model +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL uses [CComCoClass](../atl/reference/ccomcoclass-class.md) to define the default class factory and aggregation model for your object. `CComCoClass` specifies the following two macros: - [DECLARE_CLASSFACTORY](reference/aggregation-and-class-factory-macros.md#declare_classfactory) Declares the class factory to be [CComClassFactory](../atl/reference/ccomclassfactory-class.md). diff --git a/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md b/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md index 2ed4a960e6b..d835f00e7d9 100644 --- a/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md +++ b/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md @@ -4,11 +4,12 @@ title: "Changing the Drawing Code (ATL Tutorial, Part 4)" ms.custom: "get-started-article" ms.date: "09/26/2018" helpviewer_keywords: ["_ATL_MIN_CRT macro"] -ms.assetid: 08ff14e8-aa49-4139-a110-5d071939cf1e ms.topic: tutorial --- # Changing the Drawing Code (ATL Tutorial, Part 4) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + By default, the control's drawing code displays a square and the text **PolyCtl**. In this step, you will change the code to display something more interesting. The following tasks are involved: - Modifying the Header File diff --git a/docs/atl/class-factories-classes.md b/docs/atl/class-factories-classes.md index 15bda12d380..a0e9bdb8927 100644 --- a/docs/atl/class-factories-classes.md +++ b/docs/atl/class-factories-classes.md @@ -4,10 +4,11 @@ title: " ATL Class Factories Classes" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["class factories", "class factories, ATL classes"] -ms.assetid: 1d8c2ae2-2c37-452c-a02d-1ecbdd309f84 --- # Class Factories Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes implement or support a class factory: - [CComClassFactory](../atl/reference/ccomclassfactory-class.md) Provides a default class factory for object creation. diff --git a/docs/atl/class-information-classes.md b/docs/atl/class-information-classes.md index 4f4b3f3158e..b1854183884 100644 --- a/docs/atl/class-information-classes.md +++ b/docs/atl/class-information-classes.md @@ -4,10 +4,11 @@ title: "Class Information Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["class information, retrieving"] -ms.assetid: 39365025-f24a-41ae-87ab-4ae8ed085b98 --- # Class Information Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following class provides support for retrieving class information: - [IProvideClassInfo2Impl](../atl/reference/iprovideclassinfo2impl-class.md) Provides access to type information. Retrieves the outgoing IID for the object's default event set. diff --git a/docs/atl/collection-classes.md b/docs/atl/collection-classes.md index 0545b6d29b0..5702e9832d1 100644 --- a/docs/atl/collection-classes.md +++ b/docs/atl/collection-classes.md @@ -4,10 +4,11 @@ title: "Collection classes in ATL" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["collection classes"] -ms.assetid: eff95de6-78ef-4212-9d7d-1dacbdd4cc58 --- # Collection Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide support for arrays, lists, maps, and also traits methods for helping with comparisons and element access. - [CAtlArray](../atl/reference/catlarray-class.md) This class implements an array object. diff --git a/docs/atl/com-modules-classes.md b/docs/atl/com-modules-classes.md index 4c4671f1231..768c712e943 100644 --- a/docs/atl/com-modules-classes.md +++ b/docs/atl/com-modules-classes.md @@ -4,10 +4,11 @@ title: "COM Modules Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["COM modules classes"] -ms.assetid: 0a8a82dd-a153-47cd-9bbe-1a1ad5d1a6ff --- # COM Modules Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide support for a COM module: - [CAtlBaseModule](../atl/reference/catlbasemodule-class.md) This class is instantiated in every ATL project. diff --git a/docs/atl/commandhandler.md b/docs/atl/commandhandler.md index 6ad29accfb3..2a299bfa7d7 100644 --- a/docs/atl/commandhandler.md +++ b/docs/atl/commandhandler.md @@ -4,10 +4,11 @@ title: "CommandHandler" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["CommandHandler function"] -ms.assetid: 662bc7bf-4a10-42b3-986d-d8bae4f63551 --- # CommandHandler +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + `CommandHandler` is the function identified by the third parameter of the COMMAND_HANDLER macro in your message map. ## Syntax diff --git a/docs/atl/composite-controls-classes.md b/docs/atl/composite-controls-classes.md index 0e45651cc80..42f653e0cbb 100644 --- a/docs/atl/composite-controls-classes.md +++ b/docs/atl/composite-controls-classes.md @@ -4,10 +4,11 @@ title: "Composite Controls Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["composite controls, C++", "composite controls classes"] -ms.assetid: 9e8d65c4-d631-4500-a28b-6d42c35aba26 --- # Composite Controls Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following class provides support for creating composite controls - [CComCompositeControl](../atl/reference/ccomcompositecontrol-class.md) ActiveX controls derived from `CComCompositeControl` are hosted by a standard dialog box. These types of controls are called composite controls because they are able to host other controls (native Windows controls and ActiveX controls). diff --git a/docs/atl/connection-points-classes.md b/docs/atl/connection-points-classes.md index 52b73a0103c..4903c12022e 100644 --- a/docs/atl/connection-points-classes.md +++ b/docs/atl/connection-points-classes.md @@ -4,10 +4,11 @@ title: "Connection Points Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["classes [C++], connection points", "connection points classes"] -ms.assetid: 076365fa-299a-4dce-84c3-a5dff0e0da1f --- # Connection Points Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide support for connection points: - [IConnectionPointContainerImpl](../atl/reference/iconnectionpointcontainerimpl-class.md) Implements a connection point container. diff --git a/docs/atl/control-containment-classes.md b/docs/atl/control-containment-classes.md index 1446101b696..8eb055a2cbf 100644 --- a/docs/atl/control-containment-classes.md +++ b/docs/atl/control-containment-classes.md @@ -4,10 +4,11 @@ title: "Control Containment Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["control containment classes"] -ms.assetid: e0812aee-c078-4ced-b967-247976552b9a --- # Control Containment Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide containment support for hosting controls: - [CAxWindow](../atl/reference/caxwindow-class.md) Provides methods for manipulating a window that hosts an ActiveX control. diff --git a/docs/atl/controls-general-support-classes.md b/docs/atl/controls-general-support-classes.md index fdb016140e0..2bcaa142937 100644 --- a/docs/atl/controls-general-support-classes.md +++ b/docs/atl/controls-general-support-classes.md @@ -4,10 +4,11 @@ title: "ATL Controls: General Support Classes" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["controls [ATL]", "general support classes"] -ms.assetid: cf73f1d2-7542-48e3-b8c8-9d3abf29f85b --- # Controls: General Support Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide general support for ATL controls: - [CComControl](../atl/reference/ccomcontrol-class.md) Consists of helper functions and data members that are essential to ATL controls. diff --git a/docs/atl/creating-an-aggregated-object.md b/docs/atl/creating-an-aggregated-object.md index f0bc8d88b24..e6e24a5bf08 100644 --- a/docs/atl/creating-an-aggregated-object.md +++ b/docs/atl/creating-an-aggregated-object.md @@ -3,11 +3,12 @@ description: "Learn more about: Creating an Aggregated Object" title: "Creating an Aggregated Object" ms.date: "11/04/2016" helpviewer_keywords: ["aggregation [C++], creating aggregated objects", "aggregate objects [C++], creating"] -ms.assetid: fc29d7aa-fd53-4276-9c2f-37379f71b179 ms.topic: how-to --- # Creating an Aggregated Object +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Aggregation delegates `IUnknown` calls, providing a pointer to the outer object's `IUnknown` to the inner object. ## To create an aggregated object diff --git a/docs/atl/creating-an-atl-dhtml-control.md b/docs/atl/creating-an-atl-dhtml-control.md index 1831d58d0b3..c6c4f9c846b 100644 --- a/docs/atl/creating-an-atl-dhtml-control.md +++ b/docs/atl/creating-an-atl-dhtml-control.md @@ -3,11 +3,12 @@ description: "Learn more about: Creating an ATL DHTML Control" title: "Creating an ATL DHTML Control" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, creating", "DHTML controls", "DHTML controls, creating"] -ms.assetid: 1d8f0ede-7d8b-4959-976e-b4d0e2a87f5a ms.topic: how-to --- # Creating an ATL DHTML Control +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The ATL Control Wizard automates the process of creating a DHTML control. It generates the necessary resource files, including an HTML file containing sample code. ## To create an ATL DHTML control diff --git a/docs/atl/creating-registrar-scripts.md b/docs/atl/creating-registrar-scripts.md index d9d281b53ab..9e9e8eb0ca2 100644 --- a/docs/atl/creating-registrar-scripts.md +++ b/docs/atl/creating-registrar-scripts.md @@ -3,11 +3,12 @@ description: "Learn more about: Creating Registrar scripts" title: "Creating scripts for ATL Registrar" ms.date: "05/14/2014" helpviewer_keywords: ["scripting, registry scripting", "ATL, registry", "registrar scripts [ATL]", "scripts, Registrar scripts", "scripts, creating"] -ms.assetid: cbd5024b-8061-4a71-be65-7fee90374a35 ms.topic: concept-article --- # Creating Registrar scripts +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + A registrar script provides data-driven, rather than API-driven, access to the system registry. Data-driven access is typically more efficient since it takes only one or two lines in a script to add a key to the registry. The [ATL Control Wizard](../atl/reference/atl-control-wizard.md) automatically generates a registrar script for your COM server. You can find this script in the .rgs file associated with your object. diff --git a/docs/atl/creating-the-project-atl-tutorial-part-1.md b/docs/atl/creating-the-project-atl-tutorial-part-1.md index b8a01fd2255..c7aa2721438 100644 --- a/docs/atl/creating-the-project-atl-tutorial-part-1.md +++ b/docs/atl/creating-the-project-atl-tutorial-part-1.md @@ -3,11 +3,12 @@ description: "Learn more about: Creating the Project (ATL Tutorial, Part 1)" title: "Creating the Project (ATL Tutorial, Part 1)" ms.custom: "get-started-article" ms.date: "08/19/2019" -ms.assetid: f6b727d1-390a-4b27-b82f-daadcd9fc059 ms.topic: tutorial --- # Creating the Project (ATL Tutorial, Part 1) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + This tutorial walks you step-by-step through a non-attributed ATL project that creates an ActiveX object that displays a polygon. The object includes options for allowing the user to change the number of sides making up the polygon, and code to refresh the display. > [!NOTE] diff --git a/docs/atl/data-transfer-classes.md b/docs/atl/data-transfer-classes.md index 67709a809cd..c3515d329ca 100644 --- a/docs/atl/data-transfer-classes.md +++ b/docs/atl/data-transfer-classes.md @@ -4,10 +4,11 @@ title: "Data Transfer Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["data transfer [C++]", "data transfer [C++], classes", "data transfer classes [C++]"] -ms.assetid: c10bcdc8-b90c-4c2a-9179-fd3de80461da --- # Data Transfer Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes support various types of data transfer: - [IDataObjectImpl](../atl/reference/idataobjectimpl-class.md) Supports Uniform Data Transfer by using standard formats to retrieve and set data. Handles data change notifications by managing connections to advise sinks. diff --git a/docs/atl/data-types-classes.md b/docs/atl/data-types-classes.md index 85d986bad81..c636b279ff2 100644 --- a/docs/atl/data-types-classes.md +++ b/docs/atl/data-types-classes.md @@ -4,10 +4,11 @@ title: "Data Types Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["data types classes [C++]", "data types [C++], classes"] -ms.assetid: 29882bab-9174-4dfa-8227-ccfeba80b865 --- # Data Types Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes wrap C++ data types: - [CComBSTR](../atl/reference/ccombstr-class.md) Wraps the `BSTR` data type. diff --git a/docs/atl/dcomcnfg.md b/docs/atl/dcomcnfg.md index 0a0468d6a57..ac312effae9 100644 --- a/docs/atl/dcomcnfg.md +++ b/docs/atl/dcomcnfg.md @@ -3,10 +3,11 @@ description: "Learn more about: DCOMCNFG" title: "DCOMCNFG" ms.date: "11/04/2016" helpviewer_keywords: ["DCOMCNFG utility", "DCOM, configuring in ATL"] -ms.assetid: 5a8126e9-ef27-40fb-a66e-9dce8d1a7e80 --- # DCOMCNFG +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + DCOMCNFG is a Windows NT 4.0 utility that allows you to configure various DCOM-specific settings in the registry. The DCOMCNFG window has three pages: Default Security, Default Properties, and Applications. Under Windows 2000 a fourth page, Default Protocols, is present. ## Default Security Page diff --git a/docs/atl/debugging-and-exceptions-classes.md b/docs/atl/debugging-and-exceptions-classes.md index 703972808b0..c8a8205fa2c 100644 --- a/docs/atl/debugging-and-exceptions-classes.md +++ b/docs/atl/debugging-and-exceptions-classes.md @@ -4,10 +4,11 @@ title: "Debugging and Exceptions Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["debugging and exceptions classes"] -ms.assetid: d42d7649-9721-4a1a-8b38-d983a649fdb9 --- # Debugging and Exceptions Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + These classes provide support for exception handling and debugging. - [CAtlDebugInterfacesModule](../atl/reference/catldebuginterfacesmodule-class.md) This class provides support for debugging interfaces. diff --git a/docs/atl/debugging-tips.md b/docs/atl/debugging-tips.md index 5fcdee636d5..f5680d207ed 100644 --- a/docs/atl/debugging-tips.md +++ b/docs/atl/debugging-tips.md @@ -3,11 +3,12 @@ description: "Learn more about: Debugging Tips" title: "Debugging Tips (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, debugging", "services, debugging"] -ms.assetid: 48c60244-d0ce-4466-85fa-6fa65fcfe86c ms.topic: concept-article --- # Debugging Tips +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following topics outline some useful steps for debugging your service: - [Using Task Manager](../atl/using-task-manager.md) diff --git a/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md b/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md index e75179b64e0..7f9b5386a3b 100644 --- a/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md +++ b/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md @@ -3,11 +3,12 @@ description: "Learn more about: Design Principles for Collection and Enumerator title: "Designing Collection and Enumerator Interfaces (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["enumerator interfaces", "collection interfaces"] -ms.assetid: ea19a39e-6333-41a1-be62-5435c236640e ms.topic: concept-article --- # Design Principles for Collection and Enumerator Interfaces +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + There are different design principles behind each type of interface: - A collection interface provides *random* access to a *single* item in the collection via the `Item` method, it lets clients discover how many items are in the collection via the `Count` property, and often allows clients to add and remove items. diff --git a/docs/atl/displaying-assertions.md b/docs/atl/displaying-assertions.md index 8587c3eb40c..e4ffc2a6420 100644 --- a/docs/atl/displaying-assertions.md +++ b/docs/atl/displaying-assertions.md @@ -3,11 +3,12 @@ description: "Learn more about: Displaying Assertions" title: "Displaying Assertions" ms.date: "05/05/2019" helpviewer_keywords: ["debugging [ATL], displaying assertions", "assertions, displaying", "debugging assertions", "assertions, debugging"] -ms.assetid: fa353fe8-4656-4384-a5d2-8866bc977f06 ms.topic: concept-article --- # Displaying Assertions +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + If the client connected to your service appears to stop responding, the service may have asserted and displayed a message box that you are not able to see. You can confirm this by using the Visual Studio debugger to debug your code (see [Using Task Manager](../atl/using-task-manager.md) earlier in this section). If you determine that your service is displaying a message box that you cannot see, you may want to set the **Allow Service to Interact with Desktop** option before using the service again. This option is a startup parameter that permits any message boxes displayed by the service to appear on the desktop. To set this option, open the Services Control Panel application, select the service, click **Startup**, and then select the **Allow Service to Interact with Desktop** option. diff --git a/docs/atl/dual-interfaces-and-atl.md b/docs/atl/dual-interfaces-and-atl.md index 2039cb3e12e..38dcc7d2888 100644 --- a/docs/atl/dual-interfaces-and-atl.md +++ b/docs/atl/dual-interfaces-and-atl.md @@ -3,10 +3,11 @@ description: "Learn more about: Dual Interfaces and ATL" title: "Dual Interfaces and ATL" ms.date: "11/04/2016" helpviewer_keywords: ["COM, and ATL", "ATL, dual interfaces", "dual interfaces, about dual interfaces"] -ms.assetid: 5a390e89-d2c4-41f0-8538-cab2c5e5d4c8 --- # Dual Interfaces and ATL +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + A dual interface allows its methods to be accessed as dispinterface methods or as vtable methods. This section covers some of the features of dual interfaces from an ATL perspective. ## In This Section diff --git a/docs/atl/dual-interfaces-and-events.md b/docs/atl/dual-interfaces-and-events.md index a0a520b396a..5e5fc2bc5e1 100644 --- a/docs/atl/dual-interfaces-and-events.md +++ b/docs/atl/dual-interfaces-and-events.md @@ -3,10 +3,11 @@ description: "Learn more about: Dual Interfaces and Events" title: "Dual Interfaces and Events" ms.date: "11/04/2016" helpviewer_keywords: ["events [C++], dual interfaces", "dual interfaces, events"] -ms.assetid: bb382f7c-e885-4274-bf07-83f3602615d2 --- # Dual Interfaces and Events +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + While it is possible to design an event interface as a dual, there are a number of good design reasons not to do so. The fundamental reason is that the source of the event will only fire the event via the vtable or via `Invoke`, not both. If the event source fires the event as a direct vtable method call, the `IDispatch` methods will never be used and it's clear that the interface should have been a pure vtable interface. If the event source fires the event as a call to `Invoke`, the vtable methods will never be used and it's clear that the interface should have been a dispinterface. If you define your event interfaces as duals, you'll be requiring clients to implement part of an interface that will never be used. > [!NOTE] diff --git a/docs/atl/dual-interfaces-classes.md b/docs/atl/dual-interfaces-classes.md index b6755655498..c66bd005920 100644 --- a/docs/atl/dual-interfaces-classes.md +++ b/docs/atl/dual-interfaces-classes.md @@ -4,10 +4,11 @@ title: "Dual Interfaces Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["dual interfaces, classes", "dual interfaces"] -ms.assetid: c2b1b165-ff39-4e4a-a683-91eca9158304 --- # Dual Interfaces Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following class provides support for dual interfaces: - [IDispatchImpl](../atl/reference/idispatchimpl-class.md) Implements the `IDispatch` portion of a dual interface. For more information, see [Implementing the IDispatch Interface](/previous-versions/windows/desktop/automat/implementing-the-idispatch-interface). diff --git a/docs/atl/enumerators-and-collections-classes.md b/docs/atl/enumerators-and-collections-classes.md index 6ccef203df3..1362c008dee 100644 --- a/docs/atl/enumerators-and-collections-classes.md +++ b/docs/atl/enumerators-and-collections-classes.md @@ -4,10 +4,11 @@ title: "Enumerators and Collections Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["enumerators, ATL classes"] -ms.assetid: fcd093b2-98bf-444d-94ab-9a55520a5051 --- # Enumerators and Collections Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide support for COM collections and enumerations: - [CComEnum](../atl/reference/ccomenum-class.md) Defines a COM enumerator object based on an array. diff --git a/docs/atl/error-information-classes.md b/docs/atl/error-information-classes.md index 5a2a987385b..bea5c2cbbe2 100644 --- a/docs/atl/error-information-classes.md +++ b/docs/atl/error-information-classes.md @@ -4,10 +4,11 @@ title: "Error Information Classe (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["error handling, error information classes", "error handling, classes", "error information, classes"] -ms.assetid: ba40c8fb-81fd-4f61-8f47-fa2cb540e274 --- # Error Information Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following class indicates how error information is handled: - [ISupportErrorInfoImpl](../atl/reference/isupporterrorinfoimpl-class.md) Determines whether the object supports the [IErrorInfo](/windows/win32/api/oaidl/nn-oaidl-ierrorinfo) interface. `IErrorInfo` allows error information to be propagated back to the client. diff --git a/docs/atl/event-handling-and-atl.md b/docs/atl/event-handling-and-atl.md index 649b68042c1..9a06e07a6a7 100644 --- a/docs/atl/event-handling-and-atl.md +++ b/docs/atl/event-handling-and-atl.md @@ -3,10 +3,11 @@ description: "Learn more about: Event Handling and ATL" title: "Event Handling and ATL" ms.date: "11/04/2016" helpviewer_keywords: ["event handling, about event handling"] -ms.assetid: e4812b0d-6fdd-4e8c-bdb8-378a25c7bde2 --- # Event Handling and ATL +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + This section shows how to sink events using ATL. It covers the principles of COM event handling and the specifics of sinking events using the support provided by ATL. For information on how to fire events and implement connection points, read [ATL Connection Points](../atl/atl-connection-points.md). diff --git a/docs/atl/event-handling-principles.md b/docs/atl/event-handling-principles.md index 41c766a5e7a..4aba9a8917b 100644 --- a/docs/atl/event-handling-principles.md +++ b/docs/atl/event-handling-principles.md @@ -3,10 +3,11 @@ description: "Learn more about: Event Handling Principles" title: "Event Handling Principles (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["event handling, implementing", "event handling, advising event sources", "interfaces, event and event sink", "dual interfaces, event interfaces", "event handling, dual event interfaces"] -ms.assetid: d17ca7cb-54f2-4658-ab8b-b721ac56801d --- # Event Handling Principles +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + There are three steps common to all event handling. You will need to: - Implement the event interface on your object. diff --git a/docs/atl/example-implementing-a-property-page.md b/docs/atl/example-implementing-a-property-page.md index 6e7ee66751a..57f0ba62255 100644 --- a/docs/atl/example-implementing-a-property-page.md +++ b/docs/atl/example-implementing-a-property-page.md @@ -3,11 +3,12 @@ description: "Learn more about: Example: Implementing a Property Page" title: "Implementing a Property Page (ATL)" ms.date: "05/09/2019" helpviewer_keywords: ["property pages, implementing"] -ms.assetid: c30b67fe-ce08-4249-ae29-f3060fa8d61e ms.topic: how-to --- # Example: Implementing a Property Page +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" The ATL Property Page wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/file-handling-classes.md b/docs/atl/file-handling-classes.md index 22602083ecb..da26a0af03f 100644 --- a/docs/atl/file-handling-classes.md +++ b/docs/atl/file-handling-classes.md @@ -4,10 +4,11 @@ title: "File Handling Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["file classes [C++]"] -ms.assetid: 94355eb1-daa3-4825-b183-7392b3899561 --- # File Handling Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + These classes provide methods for handling files, temporary files, and memory-mapped files. - [CAtlFile](../atl/reference/catlfile-class.md) This class provides a thin wrapper around the Windows file-handling API. diff --git a/docs/atl/fundamentals-of-atl-com-objects.md b/docs/atl/fundamentals-of-atl-com-objects.md index afc7adb434f..336b93f9f20 100644 --- a/docs/atl/fundamentals-of-atl-com-objects.md +++ b/docs/atl/fundamentals-of-atl-com-objects.md @@ -3,10 +3,11 @@ description: "Learn more about: Fundamentals of ATL COM Objects" title: "Fundamentals of ATL COM Objects" ms.date: "11/19/2018" helpviewer_keywords: ["COM, and ATL", "ATL, COM", "ATL COM objects", "COM objects, ATL"] -ms.assetid: 0f9c9d98-cc28-45da-89ac-dc94cee422fe --- # Fundamentals of ATL COM Objects +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following illustration depicts the relationship among the classes and interfaces that are used to define an ATL COM object. ![Diagram of the classes and interfaces used to define an A T L object.](../atl/media/vc307y1.gif "ATL structure") diff --git a/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md b/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md index 7ac825b8372..563f6a8ec03 100644 --- a/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md +++ b/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md @@ -3,11 +3,12 @@ description: "Learn more about: Identifying the Elements of the DHTML Control Pr title: "Identifying the Elements of the DHTML Control Project" ms.date: "11/19/2018" helpviewer_keywords: ["HTML controls, ATL support", "DHTML controls, ATL support"] -ms.assetid: b627547a-3768-4346-9900-4b7a21fb8e27 ms.topic: concept-article --- # Identifying the Elements of the DHTML Control Project +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Most DHTML control code is exactly like that created for any ATL control. For a basic understanding of the generic code, work through the [ATL tutorial](../atl/active-template-library-atl-tutorial.md), and read the sections [Creating an ATL Project](../atl/reference/creating-an-atl-project.md) and [Fundamentals of ATL COM Objects](../atl/fundamentals-of-atl-com-objects.md). A DHTML control is similar to any ATL control, except: diff --git a/docs/atl/implementing-a-dialog-box.md b/docs/atl/implementing-a-dialog-box.md index c84428bea54..a416d87a717 100644 --- a/docs/atl/implementing-a-dialog-box.md +++ b/docs/atl/implementing-a-dialog-box.md @@ -3,11 +3,12 @@ description: "Learn more about: Implementing a Dialog Box" title: "Implementing a Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["CSimpleDialog class, implementing dialog boxes in ATL", "dialog boxes, ATL", "CAxDialogImpl class, implementing dialog boxes in ATL", "ATL, dialog boxes"] -ms.assetid: 478525f2-aa6a-435a-b162-68fc8aa98a8e ms.topic: how-to --- # Implementing a Dialog Box +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + There are two ways to add a dialog box to your ATL project: use the ATL Dialog Wizard or add it manually. ## Adding a Dialog Box with the ATL Dialog Wizard diff --git a/docs/atl/implementing-a-dual-interface.md b/docs/atl/implementing-a-dual-interface.md index 6abd84d51b4..fc2afff4195 100644 --- a/docs/atl/implementing-a-dual-interface.md +++ b/docs/atl/implementing-a-dual-interface.md @@ -3,11 +3,12 @@ description: "Learn more about: Implementing a Dual Interface" title: "Implementing a Dual Interface (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["IDispatchImpl class, implementing dual interfaces", "dual interfaces, implementing"] -ms.assetid: d1da3633-b445-4dcd-8a0a-3efdafada3ea ms.topic: concept-article --- # Implementing a Dual Interface +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + You can implement a dual interface using the [IDispatchImpl](../atl/reference/idispatchimpl-class.md) class, which provides a default implementation of the `IDispatch` methods in a dual interface. For more information, see [Implementing the IDispatch Interface](/previous-versions/windows/desktop/automat/implementing-the-idispatch-interface). To use this class: diff --git a/docs/atl/implementing-a-window-with-cwindowimpl.md b/docs/atl/implementing-a-window-with-cwindowimpl.md index be0f590b83f..aaad98298e0 100644 --- a/docs/atl/implementing-a-window-with-cwindowimpl.md +++ b/docs/atl/implementing-a-window-with-cwindowimpl.md @@ -3,11 +3,12 @@ description: "Learn more about: Implementing a Window with CWindowImpl" title: "Implementing a Window with CWindowImpl" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "windows [C++], subclassing", "windows [C++], superclassing", "windows [C++], ATL", "subclassing ATL window classes", "superclassing, ATL"] -ms.assetid: 3fc40550-f1d6-4702-8b7c-4cf682b6a855 ms.topic: how-to --- # Implementing a Window with CWindowImpl +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + To implement a window, derive a class from `CWindowImpl`. In your derived class, declare a message map and the message handler functions. You can now use your class in three different ways: - [Create a window based on a new Windows class](#_atl_creating_a_window_based_on_a_new_windows_class) diff --git a/docs/atl/implementing-a-window.md b/docs/atl/implementing-a-window.md index dbe42c3fbc5..478f0fa5750 100644 --- a/docs/atl/implementing-a-window.md +++ b/docs/atl/implementing-a-window.md @@ -3,11 +3,12 @@ description: "Learn more about: Implementing a Window" title: "Implementing a Window (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "CWindowImpl class, using", "windows [C++], implementing in ATL"] -ms.assetid: eb1ce8d6-72f9-4894-aae7-e60a61665628 ms.topic: concept-article --- # Implementing a Window +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Class [CWindowImpl](../atl/reference/cwindowimpl-class.md) allows you to implement a window and handle its messages. Message handing in ATL is based on a message map. This section explains: - How to [add a message handler](../atl/adding-an-atl-message-handler.md) to a control. diff --git a/docs/atl/implementing-an-stl-based-collection.md b/docs/atl/implementing-an-stl-based-collection.md index 761ef740d16..5670f233a3b 100644 --- a/docs/atl/implementing-an-stl-based-collection.md +++ b/docs/atl/implementing-an-stl-based-collection.md @@ -3,11 +3,12 @@ description: "Learn more about: Implementing a C++ Standard Library-Based Collec title: "Implementing a C++ Standard Library-Based Collection" ms.date: "11/04/2016" helpviewer_keywords: ["ICollectionOnSTLImpl interface"] -ms.assetid: 6d49f819-1957-4813-b074-3f12c494d8ca ms.topic: how-to --- # Implementing a C++ Standard Library-Based Collection +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL provides the `ICollectionOnSTLImpl` interface to enable you to quickly implement C++ Standard Library-based collection interfaces on your objects. To understand how this class works, you will work through a simple example (below) that uses this class to implement a read-only collection aimed at Automation clients. The sample code is from the [ATLCollections sample](../overview/visual-cpp-samples.md). diff --git a/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md b/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md index e7a6428fbaa..1248dc40715 100644 --- a/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md +++ b/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md @@ -3,11 +3,12 @@ description: "Learn more about: Implementing CComObject, CComAggObject, and CCom title: "Implementing CComObject, CComAggObject, and CComPolyObject" ms.date: "11/04/2016" helpviewer_keywords: ["CComPolyObject class, implementing", "CreateInstance method", "CComAggObject class", "CComObject class, implementing"] -ms.assetid: 5aabe938-104d-492e-9c41-9f7fb1c62098 ms.topic: concept-article --- # Implementing CComObject, CComAggObject, and CComPolyObject +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The template classes [CComObject](../atl/reference/ccomobject-class.md), [CComAggObject](../atl/reference/ccomaggobject-class.md), and [CComPolyObject](../atl/reference/ccompolyobject-class.md) are always the most derived classes in the inheritance chain. It is their responsibility to handle all of the methods in `IUnknown`: `QueryInterface`, `AddRef`, and `Release`. In addition, `CComAggObject` and `CComPolyObject` (when used for aggregated objects) provide the special reference counting and `QueryInterface` semantics required for the inner unknown. Whether `CComObject`, `CComAggObject`, or `CComPolyObject` is used depends on whether you declare one (or none) of the following macros: diff --git a/docs/atl/implementing-ccomobjectrootex.md b/docs/atl/implementing-ccomobjectrootex.md index 5dc0fc19caf..48a7ab9b4de 100644 --- a/docs/atl/implementing-ccomobjectrootex.md +++ b/docs/atl/implementing-ccomobjectrootex.md @@ -3,11 +3,12 @@ description: "Learn more about: Implementing CComObjectRootEx" title: "Implementing CComObjectRootEx" ms.date: "11/04/2016" helpviewer_keywords: ["CComObjectRoot class, implementing", "CComObjectRootEx class"] -ms.assetid: 79630c44-f2df-4e9e-b730-400a0ebfbd2b ms.topic: concept-article --- # Implementing CComObjectRootEx +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + [CComObjectRootEx](../atl/reference/ccomobjectrootex-class.md) is essential; all ATL objects must have one instance of `CComObjectRootEx` or [CComObjectRoot](../atl/reference/ccomobjectroot-class.md) in their inheritance. `CComObjectRootEx` provides the default `QueryInterface` mechanism based on COM map entries. Through its COM map, an object's interfaces are exposed to a client when the client queries for an interface. The query is performed through `CComObjectRootEx::InternalQueryInterface`. `InternalQueryInterface` only handles interfaces in the COM map table. diff --git a/docs/atl/implementing-property-pages.md b/docs/atl/implementing-property-pages.md index d9e3b0942c4..b6fb0ecf5ee 100644 --- a/docs/atl/implementing-property-pages.md +++ b/docs/atl/implementing-property-pages.md @@ -3,11 +3,12 @@ description: "Learn more about: Implementing Property Pages" title: "Implementing Property Pages" ms.date: "11/04/2016" helpviewer_keywords: ["IPropertyPage2 class", "IPropertyPage class", "property pages, implementing"] -ms.assetid: 62f29440-33a7-40eb-a1ef-3634c95f640c ms.topic: how-to --- # Implementing Property Pages +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" The ATL Property Page wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/implementing-the-event-handling-interface.md b/docs/atl/implementing-the-event-handling-interface.md index 3442039a73e..121be8961ce 100644 --- a/docs/atl/implementing-the-event-handling-interface.md +++ b/docs/atl/implementing-the-event-handling-interface.md @@ -3,11 +3,12 @@ description: "Learn more about: Implementing the Event Handling Interface" title: "Implementing the Event Handling Interface" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, event handling", "event handling, ATL", "interfaces, event and event sink"] -ms.assetid: eb2a5b33-88dc-4ce3-bee0-c5c38ea050d7 ms.topic: concept-article --- # Implementing the Event Handling Interface +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL helps you with all three elements required for handling events: implementing the event interface, advising the event source, and unadvising the event source. The precise steps you'll need to take depend on the type of the event interface and the performance requirements of your application. The most common ways of implementing an interface using ATL are: diff --git a/docs/atl/inserting-a-composite-control.md b/docs/atl/inserting-a-composite-control.md index ad1f4f6dc24..78e2ee55f0d 100644 --- a/docs/atl/inserting-a-composite-control.md +++ b/docs/atl/inserting-a-composite-control.md @@ -3,11 +3,12 @@ description: "Learn more about: Inserting a Composite Control" title: "Inserting a Composite Control" ms.date: "11/04/2016" helpviewer_keywords: ["composite controls, inserting with ATL Object Wizard", "composite controls", "ATL Control Wizard"] -ms.assetid: f10b1927-9fc6-40a7-ac29-efdac70584fe ms.topic: how-to --- # Inserting a Composite Control +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The **Add Class** dialog box allows you to insert an ATL object into a project. Access this dialog box by right-clicking the project name in Solution Explorer, pointing to **Add**, and then clicking **Add Class**. In the **Add Class** dialog box, choose **ATL Control**. This will start the [ATL Control Wizard](../atl/reference/atl-control-wizard.md). To create a composite control, select the **Options** tab, and click the **Composite control** check box. diff --git a/docs/atl/interface-pointers-classes.md b/docs/atl/interface-pointers-classes.md index d54f0ad4aa5..06f9c44a043 100644 --- a/docs/atl/interface-pointers-classes.md +++ b/docs/atl/interface-pointers-classes.md @@ -4,10 +4,11 @@ title: "Interface Pointers Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["pointers, to interfaces", "interfaces, pointers classes", "interface pointers classes"] -ms.assetid: 712617a1-17ae-4b5c-a32c-a48b758df7a6 --- # Interface Pointers Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes manage a given interface pointer: - [CComPtr](../atl/reference/ccomptr-class.md) Performs automatic reference counting. diff --git a/docs/atl/interfaces-atl.md b/docs/atl/interfaces-atl.md index 93422d3cd23..1b36fe72cec 100644 --- a/docs/atl/interfaces-atl.md +++ b/docs/atl/interfaces-atl.md @@ -4,10 +4,11 @@ title: "Interfaces (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["COM interfaces", "interfaces, COM"] -ms.assetid: de6c8b12-6230-4fdc-af66-a28b91d5ee55 --- # Interfaces (ATL) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + An interface is the way in which an object exposes its functionality to the outside world. In COM, an interface is a table of pointers (like a C++ vtable) to functions implemented by the object. The table represents the interface, and the functions to which it points are the methods of that interface. An object can expose as many interfaces as it chooses. Each interface is based on the fundamental COM interface, [IUnknown](../atl/iunknown.md). The methods of `IUnknown` allow navigation to other interfaces exposed by the object. diff --git a/docs/atl/introduction-to-atl-window-classes.md b/docs/atl/introduction-to-atl-window-classes.md index 5ae3fc8c8a3..6c245514d51 100644 --- a/docs/atl/introduction-to-atl-window-classes.md +++ b/docs/atl/introduction-to-atl-window-classes.md @@ -3,11 +3,12 @@ description: "Learn more about: Introduction to ATL Window Classes" title: "Introduction to ATL Window Classes" ms.date: "11/04/2016" helpviewer_keywords: ["window classes"] -ms.assetid: 503efc2c-a269-495d-97cf-3fb300d52f3d ms.topic: concept-article --- # Introduction to ATL Window Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following ATL classes are designed to implement and manipulate windows: - [CWindow](../atl/reference/cwindow-class.md) allows you to attach a window handle to the `CWindow` object. You then call `CWindow` methods to manipulate the window. diff --git a/docs/atl/introduction-to-atl.md b/docs/atl/introduction-to-atl.md index cccfc973918..0a62bded508 100644 --- a/docs/atl/introduction-to-atl.md +++ b/docs/atl/introduction-to-atl.md @@ -4,11 +4,12 @@ title: "Introduction to ATL" ms.custom: "index-page" ms.date: "11/04/2016" helpviewer_keywords: ["COM objects, creating in ATL", "ATL"] -ms.assetid: 77f565e8-c4ec-4a80-af4b-7278fcfe5c98 ms.topic: concept-article --- # Introduction to ATL +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL is the Active Template Library, a set of template-based C++ classes with which you can easily create small, fast Component Object Model (COM) objects. It has special support for key COM features including: stock implementations of [IUnknown](/windows/win32/api/unknwn/nn-unknwn-iunknown), [IClassFactory](/windows/win32/api/unknwnbase/nn-unknwnbase-iclassfactory), [IClassFactory2](/windows/win32/api/ocidl/nn-ocidl-iclassfactory2), and `IDispatch`; dual interfaces; standard COM enumerator interfaces; connection points; tear-off interfaces; and ActiveX controls. ATL code can be used to create single-threaded objects, apartment-model objects, free-threaded model objects, or both free-threaded and apartment-model objects. diff --git a/docs/atl/introduction-to-com-and-atl.md b/docs/atl/introduction-to-com-and-atl.md index 57e25904bca..47447c9ebdb 100644 --- a/docs/atl/introduction-to-com-and-atl.md +++ b/docs/atl/introduction-to-com-and-atl.md @@ -4,11 +4,12 @@ title: "Introduction to COM and ATL" ms.custom: "index-page" ms.date: "11/04/2016" helpviewer_keywords: ["COM, and ATL", "ATL, COM", "COM objects, ATL"] -ms.assetid: 35d6ae9c-abbb-42f0-9344-33f3c19ac3ce ms.topic: concept-article --- # Introduction to COM and ATL +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + This section provides a brief introduction to COM and ATL. ## In This Section diff --git a/docs/atl/introduction-to-com.md b/docs/atl/introduction-to-com.md index c44fc4f0652..8b192520ef9 100644 --- a/docs/atl/introduction-to-com.md +++ b/docs/atl/introduction-to-com.md @@ -4,11 +4,12 @@ title: "Introduction to COM" ms.custom: "index-page" ms.date: "11/04/2016" helpviewer_keywords: ["COM"] -ms.assetid: 120735d9-db71-4ad3-a730-ce576ea2354e ms.topic: concept-article --- # Introduction to COM +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + COM is the fundamental "object model" on which ActiveX Controls and OLE are built. COM allows an object to expose its functionality to other components and to host applications. It defines both how the object exposes itself and how this exposure works across processes and across networks. COM also defines the object's life cycle. Fundamental to COM are these concepts: diff --git a/docs/atl/invoking-scripts.md b/docs/atl/invoking-scripts.md index 2d339471811..3cc906049fc 100644 --- a/docs/atl/invoking-scripts.md +++ b/docs/atl/invoking-scripts.md @@ -3,11 +3,12 @@ description: "Learn more about: Invoking Scripts" title: "Invoking Scripts (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["StringRegister method", "scripts, invoking registry in ATL"] -ms.assetid: eabd41ee-586b-4266-9e92-5aaad04b73a4 ms.topic: concept-article --- # Invoking Scripts +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + [Using Replaceable Parameters (The Registrar's Preprocessor)](../atl/using-replaceable-parameters-the-registrar-s-preprocessor.md) discusses replacement maps and mentions the Registrar method **AddReplacement**. The Registrar has eight other methods specific to scripting, and all are described in the following table. |Method|Syntax/Description| diff --git a/docs/atl/iunknown-implementation-classes.md b/docs/atl/iunknown-implementation-classes.md index 7721fad35c6..a64a723fe84 100644 --- a/docs/atl/iunknown-implementation-classes.md +++ b/docs/atl/iunknown-implementation-classes.md @@ -4,10 +4,11 @@ title: "IUnknown Implementation Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["IUnknown implementation classes"] -ms.assetid: 47b69bb5-69d8-4a9c-84a8-329bdde2bb3f --- # IUnknown Implementation Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes implement `IUnknown` and related methods: - [CComObjectRootEx](../atl/reference/ccomobjectrootex-class.md) Manages reference counting for both aggregated and nonaggregated objects. Allows you to specify a threading model. diff --git a/docs/atl/iunknown.md b/docs/atl/iunknown.md index ee1578aa31f..e466a86e6a5 100644 --- a/docs/atl/iunknown.md +++ b/docs/atl/iunknown.md @@ -4,10 +4,11 @@ title: "IUnknown" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["COM interfaces, base interface", "IUnknown interface"] -ms.assetid: e6b85472-e54b-4b8c-b19f-4454d6c05a8f --- # IUnknown +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + [IUnknown](/windows/win32/api/unknwn/nn-unknwn-iunknown) is the base interface of every other COM interface. This interface defines three methods: [QueryInterface](/windows/win32/api/unknwn/nf-unknwn-iunknown-queryinterface(q)), [AddRef](/windows/win32/api/unknwn/nf-unknwn-iunknown-addref), and [Release](/windows/win32/api/unknwn/nf-unknwn-iunknown-release). [QueryInterface](/windows/win32/api/unknwn/nf-unknwn-iunknown-queryinterface(q)) allows an interface user to ask the object for a pointer to another of its interfaces. [AddRef](/windows/win32/api/unknwn/nf-unknwn-iunknown-addref) and [Release](/windows/win32/api/unknwn/nf-unknwn-iunknown-release) implement reference counting on the interface. ## See also diff --git a/docs/atl/linking-to-the-crt-in-your-atl-project.md b/docs/atl/linking-to-the-crt-in-your-atl-project.md index 430134baa43..3e5d84ca794 100644 --- a/docs/atl/linking-to-the-crt-in-your-atl-project.md +++ b/docs/atl/linking-to-the-crt-in-your-atl-project.md @@ -3,11 +3,12 @@ description: "Learn more about: Linking to the CRT in Your ATL Project" title: "Linking to the CRT in Your ATL Project" ms.date: "11/04/2016" helpviewer_keywords: ["CRT, linking with ATL", "WinMainCRTStartup method", "DllMainCRTStartup method", "wWinMainCRTStartup method", "ATL, C Run-Time library (CRT)"] -ms.assetid: 650957ae-362c-4ecf-8b03-5d49138e8b5b ms.topic: concept-article --- # Linking to the CRT in Your ATL Project +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The [C Run-Time Libraries](../c-runtime-library/crt-library-features.md) (CRT) provide many useful functions that can make programming much easier during ATL development. All ATL projects link to the CRT library. You can see the advantages and disadvantages of linking method in [Benefits and Tradeoffs of the Method Used to Link to the CRT](../atl/benefits-and-tradeoffs-of-the-method-used-to-link-to-the-crt.md). ## Effects of Linking to the CRT on Your Program Image diff --git a/docs/atl/marshaling.md b/docs/atl/marshaling.md index 1f5c52b2be5..28f1c0f3582 100644 --- a/docs/atl/marshaling.md +++ b/docs/atl/marshaling.md @@ -3,11 +3,12 @@ description: "Learn more about: Marshaling" title: "Marshaling" ms.date: "11/04/2016" helpviewer_keywords: ["marshaling, COM interop", "marshaling", "COM interfaces, marshaling"] -ms.assetid: 40644b0a-1106-4fc8-9dfb-9bee9915d825 ms.topic: concept-article --- # Marshaling +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The COM technique of marshaling allows interfaces exposed by an object in one process to be used in another process. In marshaling, COM provides code (or uses code provided by the interface implementor) both to pack a method's parameters into a format that can be moved across processes (as well as, across the wire to processes running on other machines) and to unpack those parameters at the other end. Likewise, COM must perform these same steps on the return from the call. > [!NOTE] diff --git a/docs/atl/memory-management-classes.md b/docs/atl/memory-management-classes.md index 680e61f19de..89bea5d1d08 100644 --- a/docs/atl/memory-management-classes.md +++ b/docs/atl/memory-management-classes.md @@ -4,10 +4,11 @@ title: "Memory Management Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["memory, managing"] -ms.assetid: be564a5e-577e-40a7-bfe3-25ad21e57270 --- # Memory Management Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + These classes provide support for heap pointers, smart pointers, and other memory allocation routines. - [CAutoPtr](../atl/reference/cautoptr-class.md) This class represents a smart pointer object. diff --git a/docs/atl/message-handler-functions.md b/docs/atl/message-handler-functions.md index a37dc85d188..e478109d521 100644 --- a/docs/atl/message-handler-functions.md +++ b/docs/atl/message-handler-functions.md @@ -4,10 +4,11 @@ title: "Message Handler Functions" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["MESSAGE_HANDLER macro", "COMMAND_HANDLER macro", "CommandHandler method", "MessageHandler method", "NotifyHandler method", "message maps, ATL", "NOTIFY_HANDLER macro, message handler functions", "ATL, message handlers"] -ms.assetid: 2007a8c5-0143-42f1-91ab-809f235f9d50 --- # Message Handler Functions +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL provides three types of message handler functions: |Type of message handler|Corresponding message macro| diff --git a/docs/atl/message-maps-atl.md b/docs/atl/message-maps-atl.md index 0ab8a690a8f..6b0ab765a4d 100644 --- a/docs/atl/message-maps-atl.md +++ b/docs/atl/message-maps-atl.md @@ -4,10 +4,11 @@ title: "Message Maps (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["message maps, ATL", "ATL, message handlers"] -ms.assetid: 9e100400-65c7-4a85-8857-4e6cb6dd7340 --- # Message Maps (ATL) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + A message map associates a handler function with a particular message, command, or notification. By using ATL's [message map macros](../atl/reference/message-map-macros-atl.md), you can specify a message map for a window. The window procedures in `CWindowImpl`, `CDialogImpl`, and `CContainedWindowT` direct a window's messages to its message map. The [message handler functions](../atl/message-handler-functions.md) accept an additional argument of type `BOOL&`. This argument indicates whether a message has been processed, and it is set to TRUE by default. A handler function can then set the argument to FALSE to indicate that it has not handled a message. In this case, ATL will continue to look for a handler function further in the message map. By setting this argument to FALSE, you can first perform some action in response to a message and then allow the default processing or another handler function to finish handling the message. From 740d676a707c4b73e5351c3c93b7e807cf67a22b Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 25 Feb 2026 15:03:26 -0800 Subject: [PATCH 1662/1799] ATL batch 2: docs updates (files 95-194) --- docs/atl/messagehandler.md | 3 ++- docs/atl/mmc-snap-in-classes.md | 3 ++- docs/atl/modifying-the-atl-dhtml-control.md | 3 ++- docs/atl/modifying-the-atl-project.md | 3 ++- docs/atl/multiple-dual-interfaces.md | 3 ++- docs/atl/nonextensible-attribute.md | 3 ++- docs/atl/notifyhandler.md | 3 ++- docs/atl/object-safety-classes.md | 3 ++- docs/atl/persistence-classes.md | 3 ++- docs/atl/programming-with-atl-and-c-run-time-code.md | 3 ++- docs/atl/programming-with-ccombstr-atl.md | 3 ++- docs/atl/properties-and-property-pages-classes.md | 3 ++- .../putting-the-control-on-a-web-page-atl-tutorial-part-7.md | 3 ++- docs/atl/queryinterface.md | 3 ++- docs/atl/reference-counting.md | 3 ++- docs/atl/reference/adding-a-new-interface-in-an-atl-project.md | 3 ++- .../reference/adding-an-atl-active-server-page-component.md | 3 ++- docs/atl/reference/adding-an-atl-com-plus-1-0-component.md | 3 ++- docs/atl/reference/adding-an-atl-control.md | 3 ++- docs/atl/reference/adding-an-atl-dialog-box.md | 3 ++- docs/atl/reference/adding-an-atl-ole-db-consumer.md | 3 ++- docs/atl/reference/adding-an-atl-ole-db-provider.md | 3 ++- docs/atl/reference/adding-an-atl-property-page.md | 3 ++- docs/atl/reference/adding-an-atl-simple-object.md | 3 ++- .../reference/adding-objects-and-controls-to-an-atl-project.md | 3 ++- docs/atl/reference/aggregation-and-class-factory-macros.md | 3 ++- docs/atl/reference/appearance-atl-control-wizard.md | 3 ++- docs/atl/reference/application-settings-atl-project-wizard.md | 3 ++- .../reference/asp-atl-active-server-page-component-wizard.md | 3 ++- docs/atl/reference/atl-active-server-page-component-wizard.md | 3 ++- docs/atl/reference/atl-base-module70-structure.md | 3 ++- docs/atl/reference/atl-classes.md | 2 ++ docs/atl/reference/atl-com-module70-structure.md | 3 ++- docs/atl/reference/atl-com-plus-1-0-component-wizard.md | 3 ++- docs/atl/reference/atl-control-wizard.md | 3 ++- docs/atl/reference/atl-dialog-wizard.md | 3 ++- docs/atl/reference/atl-drawinfo-structure.md | 3 ++- docs/atl/reference/atl-func-info-structure.md | 3 ++- docs/atl/reference/atl-functions.md | 3 ++- docs/atl/reference/atl-global-variables.md | 3 ++- docs/atl/reference/atl-http-utility-functions.md | 3 ++- docs/atl/reference/atl-macros.md | 3 ++- docs/atl/reference/atl-module70-structure.md | 3 ++- docs/atl/reference/atl-ole-db-consumer-wizard.md | 3 ++- docs/atl/reference/atl-ole-db-provider-wizard.md | 3 ++- docs/atl/reference/atl-operators.md | 3 ++- docs/atl/reference/atl-path-functions.md | 3 ++- docs/atl/reference/atl-project-wizard.md | 3 ++- docs/atl/reference/atl-property-page-wizard.md | 3 ++- docs/atl/reference/atl-simple-object-wizard.md | 3 ++- docs/atl/reference/atl-text-encoding-functions.md | 3 ++- docs/atl/reference/atl-typedefs.md | 3 ++- docs/atl/reference/atl-url-scheme-enum.md | 3 ++- docs/atl/reference/atl-win-module70-structure.md | 3 ++- docs/atl/reference/atl-wizards-and-dialog-boxes.md | 3 ++- docs/atl/reference/atlcreatewnddata-structure.md | 3 ++- docs/atl/reference/ca2aex-class.md | 3 ++- docs/atl/reference/ca2caex-class.md | 3 ++- docs/atl/reference/ca2wex-class.md | 3 ++- docs/atl/reference/caccesstoken-class.md | 3 ++- docs/atl/reference/cacl-class.md | 3 ++- docs/atl/reference/cadapt-class.md | 3 ++- docs/atl/reference/category-macros.md | 3 ++- docs/atl/reference/catlarray-class.md | 3 ++- docs/atl/reference/catlautothreadmodule-class.md | 3 ++- docs/atl/reference/catlautothreadmodulet-class.md | 3 ++- docs/atl/reference/catlbasemodule-class.md | 3 ++- docs/atl/reference/catlcommodule-class.md | 3 ++- docs/atl/reference/catldebuginterfacesmodule-class.md | 3 ++- docs/atl/reference/catldllmodulet-class.md | 3 ++- docs/atl/reference/catlexception-class.md | 3 ++- docs/atl/reference/catlexemodulet-class.md | 3 ++- docs/atl/reference/catlfile-class.md | 3 ++- docs/atl/reference/catlfilemapping-class.md | 3 ++- docs/atl/reference/catlfilemappingbase-class.md | 3 ++- docs/atl/reference/catllist-class.md | 3 ++- docs/atl/reference/catlmap-class.md | 3 ++- docs/atl/reference/catlmodule-class.md | 3 ++- docs/atl/reference/catlmodulet-class.md | 3 ++- docs/atl/reference/catlpreviewctrlimpl-class.md | 3 ++- docs/atl/reference/catlservicemodulet-class.md | 3 ++- docs/atl/reference/catltemporaryfile-class.md | 2 ++ docs/atl/reference/catltransactionmanager-class.md | 2 ++ docs/atl/reference/catlwinmodule-class.md | 3 ++- docs/atl/reference/cautoptr-class.md | 3 ++- docs/atl/reference/cautoptrarray-class.md | 3 ++- docs/atl/reference/cautoptrelementtraits-class.md | 3 ++- docs/atl/reference/cautoptrlist-class.md | 3 ++- docs/atl/reference/cautorevertimpersonation-class.md | 3 ++- docs/atl/reference/cautovectorptr-class.md | 3 ++- docs/atl/reference/cautovectorptrelementtraits-class.md | 3 ++- docs/atl/reference/caxdialogimpl-class.md | 3 ++- docs/atl/reference/caxwindow-class.md | 3 ++- docs/atl/reference/caxwindow2t-class.md | 3 ++- docs/atl/reference/cbindstatuscallback-class.md | 3 ++- docs/atl/reference/ccomaggobject-class.md | 3 ++- docs/atl/reference/ccomallocator-class.md | 3 ++- docs/atl/reference/ccomapartment-class.md | 3 ++- docs/atl/reference/ccomautocriticalsection-class.md | 3 ++- docs/atl/reference/ccomautodeletecriticalsection-class.md | 3 ++- 100 files changed, 200 insertions(+), 97 deletions(-) diff --git a/docs/atl/messagehandler.md b/docs/atl/messagehandler.md index 4fcdaad53bd..4fa25ca0ead 100644 --- a/docs/atl/messagehandler.md +++ b/docs/atl/messagehandler.md @@ -4,10 +4,11 @@ title: "MessageHandler" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["MessageHandler function"] -ms.assetid: 8a0acf97-1b0d-4226-91b9-75446634a03c --- # MessageHandler +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + `MessageHandler` is the name of the function identified by the second parameter of the MESSAGE_HANDLER macro in your message map. ## Syntax diff --git a/docs/atl/mmc-snap-in-classes.md b/docs/atl/mmc-snap-in-classes.md index 140e10dc5e1..62c9af27f64 100644 --- a/docs/atl/mmc-snap-in-classes.md +++ b/docs/atl/mmc-snap-in-classes.md @@ -4,10 +4,11 @@ title: "MMC Snap-In Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["MMC Snap-In classes"] -ms.assetid: 4af1d5af-687f-48b1-b2c5-fa252241b4d6 --- # MMC Snap-In Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide support for developing Microsoft Management Console (MMC) snap-in components: - [CSnapInItemImpl](../atl/reference/csnapinitemimpl-class.md) Implements a snap-in node object, such as adding menu items and toolbars, and forwarding commands for the snap-in node to the appropriate handler function. diff --git a/docs/atl/modifying-the-atl-dhtml-control.md b/docs/atl/modifying-the-atl-dhtml-control.md index 3e77a536a1f..34fab00665a 100644 --- a/docs/atl/modifying-the-atl-dhtml-control.md +++ b/docs/atl/modifying-the-atl-dhtml-control.md @@ -3,11 +3,12 @@ description: "Learn more about: Modifying the ATL DHTML Control" title: "Modifying the ATL DHTML Control" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, modifying", "DHTML controls", "DHTML controls, modifying"] -ms.assetid: c053f35f-8629-4600-9595-721f5956777a ms.topic: how-to --- # Modifying the ATL DHTML Control +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The ATL Control Wizard provides starter code so you can build and run the control, and so you can see how the methods are written in the project files and how the DHTML calls into the control's C++ code using the dispatch methods. You can add any dispatch method to the interface. Then, you can call the methods in the HTML resource. ## To modify the ATL DHTML control diff --git a/docs/atl/modifying-the-atl-project.md b/docs/atl/modifying-the-atl-project.md index d9211d97764..7b87fb2adbf 100644 --- a/docs/atl/modifying-the-atl-project.md +++ b/docs/atl/modifying-the-atl-project.md @@ -3,11 +3,12 @@ description: "Learn more about: Modifying the ATL Project" title: "Modifying the ATL Project" ms.date: "11/04/2016" helpviewer_keywords: ["controls [ATL], adding to composite controls", "Dialog editor, working with composite controls", "composite controls, adding controls"] -ms.assetid: 59984518-748f-4b8b-875f-3e97d22d0b0f ms.topic: concept-article --- # Modifying the ATL Project +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + At this point, your composite control project implements the necessary objects for your composite control. The next step is to add any controls that the composite control will contain and handle any necessary events. To add additional ActiveX or Windows controls, add a new resource script and then use the Dialog editor. For more information on adding controls (and related tasks), see [Dialog Editor](../windows/dialog-editor.md). diff --git a/docs/atl/multiple-dual-interfaces.md b/docs/atl/multiple-dual-interfaces.md index 99c43025249..52b22900163 100644 --- a/docs/atl/multiple-dual-interfaces.md +++ b/docs/atl/multiple-dual-interfaces.md @@ -4,10 +4,11 @@ title: "Multiple Dual Interfaces" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["multiple dual interfaces", "COM_INTERFACE_ENTRY2 macro", "dual interfaces, exposing multiple", "multiple dual interfaces, exposing with ATL", "IDispatchImpl class, multiple dual interfaces", "COM_INTERFACE_ENTRY_IID macro"] -ms.assetid: 7fea86e6-247f-4063-be6e-85588a9e3719 --- # Multiple Dual Interfaces +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + You may want to combine the advantages of a dual interface (that is, the flexibility of both vtable and late binding, thus making the class available to scripting languages as well as C++) with the techniques of multiple inheritance. Although it is possible to expose multiple dual interfaces on a single COM object, it is not recommended. If there are multiple dual interfaces, there must be only one `IDispatch` interface exposed. The techniques available to ensure that this is the case carry penalties such as loss of function or increased code complexity. The developer considering this approach should carefully weigh the advantages and disadvantages. diff --git a/docs/atl/nonextensible-attribute.md b/docs/atl/nonextensible-attribute.md index 08a854a4873..517f6ad1da7 100644 --- a/docs/atl/nonextensible-attribute.md +++ b/docs/atl/nonextensible-attribute.md @@ -3,10 +3,11 @@ description: "Learn more about: nonextensible Attribute" title: "nonextensible Attribute" ms.date: "11/04/2016" helpviewer_keywords: ["nonextensible attribute", "dual interfaces, nonextensible attribute"] -ms.assetid: 02a4a18b-ffd3-4d53-8fd1-feb1c05ad5ac --- # nonextensible Attribute +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + If a dual interface will not be extended at run time (that is, you won't provide methods or properties via `IDispatch::Invoke` that are not available via the vtable), you should apply the **nonextensible** attribute to your interface definition. This attribute provides information to client languages (such as Visual Basic) that can be used to enable full code verification at compile time. If this attribute is not supplied, bugs may remain hidden in the client code until run time. For more information on the **nonextensible** attribute and an example, see [nonextensible](../windows/attributes/nonextensible.md). diff --git a/docs/atl/notifyhandler.md b/docs/atl/notifyhandler.md index adb1d4a0db6..deaf83115cf 100644 --- a/docs/atl/notifyhandler.md +++ b/docs/atl/notifyhandler.md @@ -4,10 +4,11 @@ title: "NotifyHandler" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["NotifyHandler function"] -ms.assetid: 5ff953ec-de35-42bc-8b3c-d384d636c139 --- # NotifyHandler +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The name of the function identified by the third parameter of the NOTIFY_HANDLER macro in your message map. ## Syntax diff --git a/docs/atl/object-safety-classes.md b/docs/atl/object-safety-classes.md index 8021fd778b8..69ec66cf8eb 100644 --- a/docs/atl/object-safety-classes.md +++ b/docs/atl/object-safety-classes.md @@ -4,10 +4,11 @@ title: Object Safety Classes (ATL) ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["safety classes", "object safety classes"] -ms.assetid: 00060b28-49e2-4ec1-9a22-f501e07821d6 --- # Object Safety Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following class provides support for object safety: - [IObjectSafetyImpl](../atl/reference/iobjectsafetyimpl-class.md) Allows an object to be marked as safe for initialization or safe for scripting. diff --git a/docs/atl/persistence-classes.md b/docs/atl/persistence-classes.md index bce7966eb71..18d1a4e3826 100644 --- a/docs/atl/persistence-classes.md +++ b/docs/atl/persistence-classes.md @@ -4,10 +4,11 @@ title: "Persistence Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["persistence classes", "persistence, classes"] -ms.assetid: a6a2b6b2-52bc-471c-b78a-de58363128bb --- # Persistence Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes implement object persistence: - [IPersistPropertyBagImpl](../atl/reference/ipersistpropertybagimpl-class.md) Allows a client to load and save an object's properties to a property bag. diff --git a/docs/atl/programming-with-atl-and-c-run-time-code.md b/docs/atl/programming-with-atl-and-c-run-time-code.md index 66c4ade4f21..804e19a5600 100644 --- a/docs/atl/programming-with-atl-and-c-run-time-code.md +++ b/docs/atl/programming-with-atl-and-c-run-time-code.md @@ -3,11 +3,12 @@ description: "Learn more about: Programming with ATL and C Run-Time Code" title: "Programming with ATL and C Run-Time Code" ms.date: "11/04/2016" helpviewer_keywords: ["ATL_MIN_CRT macro", "CRT, using with ATL", "_ATL_MIN_CRT macro", "ATL, C Run-Time library (CRT)"] -ms.assetid: 20f03b66-1eb7-4add-84a2-6047db0911eb ms.topic: concept-article --- # Programming with ATL and C Run-Time Code +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + This section discusses the benefits of using the C Run-Time Library (CRT) with either static or dynamic linking. ## In This Section diff --git a/docs/atl/programming-with-ccombstr-atl.md b/docs/atl/programming-with-ccombstr-atl.md index 31f7ee2d370..c1b044ae46b 100644 --- a/docs/atl/programming-with-ccombstr-atl.md +++ b/docs/atl/programming-with-ccombstr-atl.md @@ -3,11 +3,12 @@ description: "Learn more about: Programming with CComBSTR (ATL)" title: "Programming with CComBSTR (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["CComBSTR class, programming with", "Unicode, using CComBSTR [ATL]"] -ms.assetid: d3bd0851-d132-4be9-9c4c-6ccba17acb2b ms.topic: concept-article --- # Programming with CComBSTR (ATL) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The ATL class [CComBSTR](../atl/reference/ccombstr-class.md) provides a wrapper around the BSTR data type. While `CComBSTR` is a useful tool, there are several situations that require caution. - [Conversion Issues](#programmingwithccombstr_conversionissues) diff --git a/docs/atl/properties-and-property-pages-classes.md b/docs/atl/properties-and-property-pages-classes.md index 17e8307bb07..9fafa9baf65 100644 --- a/docs/atl/properties-and-property-pages-classes.md +++ b/docs/atl/properties-and-property-pages-classes.md @@ -4,10 +4,11 @@ title: "Properties and Property Pages Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["property pages, classes", "properties [ATL], classes", "properties [ATL]"] -ms.assetid: 31616f98-69f8-48b2-8d58-b8e7d1c2b2d8 --- # Properties and Property Pages Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes support properties and property pages: - [CComDispatchDriver](../atl/reference/atl-typedefs.md#ccomdispatchdriver) Retrieves or sets an object's properties through an `IDispatch` pointer. diff --git a/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md b/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md index faf66529f16..b191688f163 100644 --- a/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md +++ b/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md @@ -3,11 +3,12 @@ description: "Learn more about: Putting the Control on a Web Page (ATL Tutorial, title: "Putting the Control on a Web Page (ATL Tutorial, Part 7)" ms.custom: "get-started-article" ms.date: "05/06/2019" -ms.assetid: 50dc4c95-c95b-4006-b88a-9826f7bdb222 ms.topic: tutorial --- # Putting the Control on a Web Page (ATL Tutorial, Part 7) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Your control is now finished. To see your control work in a real-world situation, put it on a Web page. An HTML file that contains the control was created when you defined your control. Open the PolyCtl.htm file from **Solution Explorer**, and you can see your control on a Web page. In this step, you add functionality to the control and script the Web page to respond to events. You'll also modify the control to let Internet Explorer know the control is safe for scripting. diff --git a/docs/atl/queryinterface.md b/docs/atl/queryinterface.md index 3d982e0e938..6849e52d2cd 100644 --- a/docs/atl/queryinterface.md +++ b/docs/atl/queryinterface.md @@ -4,10 +4,11 @@ title: "QueryInterface" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["interfaces, pointers", "interfaces, availability", "QueryInterface method"] -ms.assetid: 62fce95e-aafa-4187-b50b-e6611b74c3b3 --- # `QueryInterface` +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Although there are mechanisms by which an object can express the functionality it provides statically (before it is instantiated), the fundamental COM mechanism is to use the `IUnknown` method called [`QueryInterface`](/windows/win32/api/unknwn/nf-unknwn-iunknown-queryinterface(q)). Every interface is derived from `IUnknown`, so every interface has an implementation of `QueryInterface`. Regardless of implementation, this method queries an object using the `IID` of the interface to which the caller wants a pointer. If the object supports that interface, `QueryInterface` retrieves a pointer to the interface, while also calling `AddRef`. Otherwise, it returns the `E_NOINTERFACE` error code. diff --git a/docs/atl/reference-counting.md b/docs/atl/reference-counting.md index db71a9ca66c..594cc68c495 100644 --- a/docs/atl/reference-counting.md +++ b/docs/atl/reference-counting.md @@ -3,10 +3,11 @@ description: "Learn more about: Reference Counting" title: "Reference Counting (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["AddRef method [C++], reference counting", "reference counting", "AddRef method [C++]", "reference counts", "references, counting"] -ms.assetid: b1fd4514-6de6-429f-9e60-2777c0d07a3d --- # Reference Counting +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + COM itself does not automatically try to remove an object from memory when it thinks the object is no longer being used. Instead, the object programmer must remove the unused object. The programmer determines whether an object can be removed based on a reference count. COM uses the `IUnknown` methods, [AddRef](/windows/win32/api/unknwn/nf-unknwn-iunknown-addref) and [Release](/windows/win32/api/unknwn/nf-unknwn-iunknown-release), to manage the reference count of interfaces on an object. The general rules for calling these methods are: diff --git a/docs/atl/reference/adding-a-new-interface-in-an-atl-project.md b/docs/atl/reference/adding-a-new-interface-in-an-atl-project.md index f9b927b58c0..04bda95f84c 100644 --- a/docs/atl/reference/adding-a-new-interface-in-an-atl-project.md +++ b/docs/atl/reference/adding-a-new-interface-in-an-atl-project.md @@ -4,10 +4,11 @@ title: "Adding a New Interface in an ATL Project" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.ATL.interface"] helpviewer_keywords: ["interfaces, adding to ATL objects", "Implement Interface ATL wizard", "controls [ATL], interfaces", "ATL projects, adding interfaces"] -ms.assetid: 7d34b023-2c6b-4155-aca3-d47a40968063 --- # Adding a New Interface in an ATL Project +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + When you add an interface to your object or control, you create stubbed-out functions for each method in that interface. In your object or control, you can add only interfaces currently found in an existing type library. Also, the class in which you add the interface must implement the [BEGIN_COM_MAP](com-map-macros.md#begin_com_map) macro or, if the project is attributed, it must have the `coclass` attribute. You can add a new interface to your control in one of two ways: manually or using code wizards in Class View. diff --git a/docs/atl/reference/adding-an-atl-active-server-page-component.md b/docs/atl/reference/adding-an-atl-active-server-page-component.md index 508bf1fbfca..9b0aa9b0b73 100644 --- a/docs/atl/reference/adding-an-atl-active-server-page-component.md +++ b/docs/atl/reference/adding-an-atl-active-server-page-component.md @@ -2,10 +2,11 @@ description: "Learn more about: Adding an ATL Active Server Page Component" title: "Adding an ATL Active Server Page Component" ms.date: "05/09/2019" -ms.assetid: 7be2204c-6e58-4099-8892-001b848c8987 --- # Adding an ATL Active Server Page Component +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" The ATL Active Server Pages component wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/adding-an-atl-com-plus-1-0-component.md b/docs/atl/reference/adding-an-atl-com-plus-1-0-component.md index 6df0a367ba5..b04378c1ea7 100644 --- a/docs/atl/reference/adding-an-atl-com-plus-1-0-component.md +++ b/docs/atl/reference/adding-an-atl-com-plus-1-0-component.md @@ -2,10 +2,11 @@ description: "Learn more about: Adding an ATL COM+ 1.0 Component" title: "Adding an ATL COM+ 1.0 Component" ms.date: "05/09/2019" -ms.assetid: c6c95e64-9ee4-4a6e-8804-5930202ce1b9 --- # Adding an ATL COM+ 1.0 Component +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" The ATL COM+ 1.0 Component wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/adding-an-atl-control.md b/docs/atl/reference/adding-an-atl-control.md index c9a01745336..e62a42cd078 100644 --- a/docs/atl/reference/adding-an-atl-control.md +++ b/docs/atl/reference/adding-an-atl-control.md @@ -3,10 +3,11 @@ description: "Learn more about: Adding an ATL Control" title: "Adding an ATL Control" ms.date: "11/04/2016" helpviewer_keywords: ["ATL projects, adding controls", "controls [ATL], adding to projects"] -ms.assetid: 10223e7e-fdb7-4163-80c6-44aeafa8e6ce --- # Adding an ATL Control +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Use this wizard to add a user interface object to a project that supports interfaces for all potential containers. To support these interfaces, the project must have been created as an ATL application or as an MFC application that contains ATL support. You can use the [ATL Project Wizard](../../atl/reference/atl-project-wizard.md) to create an ATL application, or [add an ATL object to your MFC application](../../mfc/reference/adding-atl-support-to-your-mfc-project.md) to implement ATL support for an MFC application. ## To add an ATL control to your project diff --git a/docs/atl/reference/adding-an-atl-dialog-box.md b/docs/atl/reference/adding-an-atl-dialog-box.md index 928fd204304..e7519718ea2 100644 --- a/docs/atl/reference/adding-an-atl-dialog-box.md +++ b/docs/atl/reference/adding-an-atl-dialog-box.md @@ -3,10 +3,11 @@ description: "Learn more about: Adding an ATL Dialog Box" title: "Adding an ATL Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["ATL projects, adding dialog resources", "MFC dialog boxes, ATL dialogs", "dialog boxes, ATL"] -ms.assetid: 152a378f-7b24-4f66-aeba-c740973f03a6 --- # Adding an ATL Dialog Box +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + To add an ATL dialog to your project, your project must be either an ATL project or an MFC project that includes ATL support. You can use the [ATL Project Wizard](../../atl/reference/atl-project-wizard.md) to create an ATL application, or [add an ATL object to your MFC application](../../mfc/reference/adding-atl-support-to-your-mfc-project.md) to implement ATL support for an MFC application. By default, the ATL Dialog Wizard implements a dialog box derived from [CAxDialogImpl](../../atl/reference/caxdialogimpl-class.md). This class includes support for hosting ActiveX and Windows controls. If you do not want the overhead of ActiveX control support, once the wizard has generated your code, replace all instances of `CAxDialogImpl` with either [CSimpleDialog](../../atl/reference/csimpledialog-class.md) or [CDialogImpl](../../atl/reference/cdialogimpl-class.md) as your base class. diff --git a/docs/atl/reference/adding-an-atl-ole-db-consumer.md b/docs/atl/reference/adding-an-atl-ole-db-consumer.md index 52b1acc39ab..52b42c75ed2 100644 --- a/docs/atl/reference/adding-an-atl-ole-db-consumer.md +++ b/docs/atl/reference/adding-an-atl-ole-db-consumer.md @@ -3,10 +3,11 @@ description: "Learn more about: Adding an ATL OLE DB Consumer" title: "Adding an ATL OLE DB Consumer" ms.date: "05/09/2019" helpviewer_keywords: ["ATL OLE DB consumers"] -ms.assetid: f940a513-4e42-4148-b521-dd0d7dc89fa2 --- # Adding an ATL OLE DB Consumer +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" The ATL OLE DB Consumer wizard is not available in Visual Studio 2019 and later. You can still add the functionality manually. For more information, see [Creating a Consumer Without Using a Wizard](../../data/oledb/creating-a-consumer-without-using-a-wizard.md). diff --git a/docs/atl/reference/adding-an-atl-ole-db-provider.md b/docs/atl/reference/adding-an-atl-ole-db-provider.md index 3aba76e606f..908e53502a3 100644 --- a/docs/atl/reference/adding-an-atl-ole-db-provider.md +++ b/docs/atl/reference/adding-an-atl-ole-db-provider.md @@ -3,10 +3,11 @@ description: "Learn more about: Adding an ATL OLE DB Provider" title: "Adding an ATL OLE DB Provider" ms.date: "05/09/2019" helpviewer_keywords: ["OLE DB, adding ATL OLE DB provider to projects", "ATL projects, adding ATL OLE DB providers", "ATL OLE DB providers"] -ms.assetid: 26fba1e3-880f-4bc6-90e5-2096a48a3a6c --- # Adding an ATL OLE DB Provider +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" The ATL OLE DB Provider wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/adding-an-atl-property-page.md b/docs/atl/reference/adding-an-atl-property-page.md index 376b4875a7f..543c72db463 100644 --- a/docs/atl/reference/adding-an-atl-property-page.md +++ b/docs/atl/reference/adding-an-atl-property-page.md @@ -3,10 +3,11 @@ description: "Learn more about: Adding an ATL Property Page" title: "Adding an ATL Property Page" ms.date: "05/09/2019" helpviewer_keywords: ["property pages, adding", "ATL projects, adding property pages", "controls [ATL], property pages"] -ms.assetid: ddf92b49-42a2-46d2-b6b8-d37baedebeca --- # Adding an ATL Property Page +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + > [!NOTE] > The ATL Property Page wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/adding-an-atl-simple-object.md b/docs/atl/reference/adding-an-atl-simple-object.md index 91e8e2ddac4..53c4b37fd33 100644 --- a/docs/atl/reference/adding-an-atl-simple-object.md +++ b/docs/atl/reference/adding-an-atl-simple-object.md @@ -4,10 +4,11 @@ title: "Adding an ATL Simple Object" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.classes.adding.atl"] helpviewer_keywords: ["ATL projects, adding objects", "objects [ATL]", "ATL, simple objects"] -ms.assetid: 9c57d2ef-0447-4c84-8982-3304b8e49847 --- # Adding an ATL Simple Object +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + To add an ATL (Active Template Library) object to your project, your project must have been created as an ATL application or as an MFC application that contains ATL support. You can use the [ATL Project Wizard](../../atl/reference/atl-project-wizard.md) to create an ATL application, or [add an ATL object to your MFC application](../../mfc/reference/adding-atl-support-to-your-mfc-project.md) to implement ATL support for an MFC application. You can define COM interfaces for your new ATL object when you first create it, or add them later by using the [Implement Interface](../../ide/implementing-an-interface-visual-cpp.md#implement-interface-wizard) command from the **Class View** shortcut menu. diff --git a/docs/atl/reference/adding-objects-and-controls-to-an-atl-project.md b/docs/atl/reference/adding-objects-and-controls-to-an-atl-project.md index 036b72dc54c..f77dfceb83e 100644 --- a/docs/atl/reference/adding-objects-and-controls-to-an-atl-project.md +++ b/docs/atl/reference/adding-objects-and-controls-to-an-atl-project.md @@ -4,10 +4,11 @@ title: "Adding Objects and Controls to an ATL Project" ms.date: "05/09/2019" f1_keywords: ["vc.appwiz.ATL.controls"] helpviewer_keywords: ["ATL projects, adding objects", "wizards [C++], ATL projects", "ATL projects, adding controls", "controls [ATL], adding to projects", "objects [C++], adding to ATL projects", "ATL Control Wizard"] -ms.assetid: c0adcbd0-07fe-4c55-a8fd-8c2c65ecdaad --- # Adding Objects and Controls to an ATL Project +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + > [!NOTE] > The ATL COM+ 1.0 Component Wizard, ATL OLE DB Consumer wizard, and ATL Active Server Page Component wizard are not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/aggregation-and-class-factory-macros.md b/docs/atl/reference/aggregation-and-class-factory-macros.md index b6dacd4282f..7520e67a5f9 100644 --- a/docs/atl/reference/aggregation-and-class-factory-macros.md +++ b/docs/atl/reference/aggregation-and-class-factory-macros.md @@ -4,10 +4,11 @@ title: "Aggregation and Class Factory Macros" ms.date: 08/12/2020 f1_keywords: ["ATLCOM/ATL::DECLARE_AGGREGATABLE", "ATLCOM/ATL::DECLARE_CLASSFACTORY", "ATLCOM/ATL::DECLARE_CLASSFACTORY_EX", "ATLCOM/ATL::DECLARE_CLASSFACTORY_AUTO_THREAD", "ATLCOM/ATL::DECLARE_CLASSFACTORY_SINGLETON", "ATLCOM/ATL::DECLARE_GET_CONTROLLING_UNKNOWN", "ATLCOM/ATL::DECLARE_NOT_AGGREGATABLE", "ATLCOM/ATL::DECLARE_ONLY_AGGREGATABLE", "ATLCOM/ATL::DECLARE_POLY_AGGREGATABLE", "ATLCOM/ATL::DECLARE_PROTECT_FINAL_CONSTRUCT", "ATLCOM/ATL::DECLARE_VIEW_STATUS", "ATLDEF/ATL::DECLARE_AGGREGATABLE", "ATLDEF/ATL::DECLARE_CLASSFACTORY", "ATLDEF/ATL::DECLARE_CLASSFACTORY_EX", "ATLDEF/ATL::DECLARE_CLASSFACTORY_AUTO_THREAD", "ATLDEF/ATL::DECLARE_CLASSFACTORY_SINGLETON", "ATLDEF/ATL::DECLARE_GET_CONTROLLING_UNKNOWN", "ATLDEF/ATL::DECLARE_NOT_AGGREGATABLE", "ATLDEF/ATL::DECLARE_ONLY_AGGREGATABLE", "ATLDEF/ATL::DECLARE_POLY_AGGREGATABLE", "ATLDEF/ATL::DECLARE_PROTECT_FINAL_CONSTRUCT", "ATLDEF/ATL::DECLARE_VIEW_STATUS", "ATLCOM/DECLARE_AGGREGATABLE", "ATLCOM/DECLARE_CLASSFACTORY", "ATLCOM/DECLARE_CLASSFACTORY_EX", "ATLCOM/DECLARE_CLASSFACTORY_AUTO_THREAD", "ATLCOM/DECLARE_CLASSFACTORY_SINGLETON", "ATLCOM/DECLARE_GET_CONTROLLING_UNKNOWN", "ATLCOM/DECLARE_NOT_AGGREGATABLE", "ATLCOM/DECLARE_ONLY_AGGREGATABLE", "ATLCOM/DECLARE_POLY_AGGREGATABLE", "ATLCOM/DECLARE_PROTECT_FINAL_CONSTRUCT", "ATLCOM/DECLARE_VIEW_STATUS", "ATL::DECLARE_AGGREGATABLE", "ATL::DECLARE_CLASSFACTORY", "ATL::DECLARE_CLASSFACTORY_EX", "ATL::DECLARE_CLASSFACTORY_AUTO_THREAD", "ATL::DECLARE_CLASSFACTORY_SINGLETON", "ATL::DECLARE_GET_CONTROLLING_UNKNOWN", "ATL::DECLARE_NOT_AGGREGATABLE", "ATL::DECLARE_ONLY_AGGREGATABLE", "ATL::DECLARE_POLY_AGGREGATABLE", "ATL::DECLARE_PROTECT_FINAL_CONSTRUCT", "ATL::DECLARE_VIEW_STATUS", "DECLARE_AGGREGATABLE", "DECLARE_CLASSFACTORY", "DECLARE_CLASSFACTORY_EX", "DECLARE_CLASSFACTORY_AUTO_THREAD", "DECLARE_CLASSFACTORY_SINGLETON", "DECLARE_GET_CONTROLLING_UNKNOWN", "DECLARE_NOT_AGGREGATABLE", "DECLARE_ONLY_AGGREGATABLE", "DECLARE_POLY_AGGREGATABLE", "DECLARE_PROTECT_FINAL_CONSTRUCT", "DECLARE_VIEW_STATUS"] helpviewer_keywords: ["class factories, ATL macros", "aggregation [C++], ATL macros", "ATL::DECLARE_AGGREGATABLE", "ATL::DECLARE_CLASSFACTORY", "ATL::DECLARE_CLASSFACTORY_EX", "ATL::DECLARE_CLASSFACTORY_AUTO_THREAD", "ATL::DECLARE_CLASSFACTORY_SINGLETON", "ATL::DECLARE_GET_CONTROLLING_UNKNOWN", "ATL::DECLARE_NOT_AGGREGATABLE", "ATL::DECLARE_ONLY_AGGREGATABLE", "ATL::DECLARE_POLY_AGGREGATABLE", "ATL::DECLARE_PROTECT_FINAL_CONSTRUCT", "ATL::DECLARE_VIEW_STATUS"] -ms.assetid: d99d379a-0eec-481f-8daa-252dac18f163 --- # Aggregation and Class Factory Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros provide ways of controlling aggregation and of declaring class factories. | Macro | Description | diff --git a/docs/atl/reference/appearance-atl-control-wizard.md b/docs/atl/reference/appearance-atl-control-wizard.md index 5a28f5a572e..2f305fd5e95 100644 --- a/docs/atl/reference/appearance-atl-control-wizard.md +++ b/docs/atl/reference/appearance-atl-control-wizard.md @@ -4,10 +4,11 @@ title: "Appearance, ATL Control Wizard" ms.date: "08/31/2018" f1_keywords: ["vc.codewiz.class.atl.control.misc"] helpviewer_keywords: ["ATL Control Wizard, appearance"] -ms.assetid: cc16d7ff-74d7-4c15-9ebd-4b19201ff457 --- # Appearance, ATL Control Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Use this page of the wizard to identify additional user element options for the control. This page is available for controls identified as **Standard controls** under **Control type** on the [Options, ATL Control Wizard](../../atl/reference/options-atl-control-wizard.md) page. ## UIElement List diff --git a/docs/atl/reference/application-settings-atl-project-wizard.md b/docs/atl/reference/application-settings-atl-project-wizard.md index 03b0fade12f..6922ea0313c 100644 --- a/docs/atl/reference/application-settings-atl-project-wizard.md +++ b/docs/atl/reference/application-settings-atl-project-wizard.md @@ -4,10 +4,11 @@ title: "Application Settings, ATL Project Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.atl.com.appset"] helpviewer_keywords: ["ATL Project Wizard, application settings"] -ms.assetid: d48c9fc5-f439-49fd-884c-8bcfa7d52991 --- # Application Settings, ATL Project Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Use the **Application Settings** page of the ATL Project Wizard to design and add basic features to a new ATL project. ## Server type diff --git a/docs/atl/reference/asp-atl-active-server-page-component-wizard.md b/docs/atl/reference/asp-atl-active-server-page-component-wizard.md index efb54c5bbfa..3a9dd3f5419 100644 --- a/docs/atl/reference/asp-atl-active-server-page-component-wizard.md +++ b/docs/atl/reference/asp-atl-active-server-page-component-wizard.md @@ -4,10 +4,11 @@ title: "ASP, ATL Active Server Page Component Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.class.atl.asp.asp"] helpviewer_keywords: ["ATL Active Server Page Component Wizard, ASP"] -ms.assetid: 4d8cafd6-5e12-4461-8911-29288896af3c --- # ASP, ATL Active Server Page Component Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Use this page of the ATL Active Server Page Component Wizard to specify optional settings for handling information and state related to your ASP component. - **Optional methods** diff --git a/docs/atl/reference/atl-active-server-page-component-wizard.md b/docs/atl/reference/atl-active-server-page-component-wizard.md index ceab8c73f93..410c00ddb87 100644 --- a/docs/atl/reference/atl-active-server-page-component-wizard.md +++ b/docs/atl/reference/atl-active-server-page-component-wizard.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Active Server Page Component Wizard" title: "ATL Active Server Page Component Wizard" ms.date: "05/09/2019" helpviewer_keywords: ["ASP components, creating in ATL"] -ms.assetid: 5a5cb904-dbbf-44ea-ad3d-2ddd14c1d3c5 --- # ATL Active Server Page Component Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" This wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/atl-base-module70-structure.md b/docs/atl/reference/atl-base-module70-structure.md index 78cbd738768..004ec92a8bd 100644 --- a/docs/atl/reference/atl-base-module70-structure.md +++ b/docs/atl/reference/atl-base-module70-structure.md @@ -4,10 +4,11 @@ title: "_ATL_BASE_MODULE70 Structure" ms.date: "11/04/2016" f1_keywords: ["ATL::_ATL_BASE_MODULE70", "ATL._ATL_BASE_MODULE70", "_ATL_BASE_MODULE70"] helpviewer_keywords: ["ATL_BASE_MODULE70 structure", "_ATL_BASE_MODULE70 structure"] -ms.assetid: 4539282f-15b8-4d7c-aafa-a85dc56f4980 --- # _ATL_BASE_MODULE70 Structure +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Used by any project that uses ATL. ## Syntax diff --git a/docs/atl/reference/atl-classes.md b/docs/atl/reference/atl-classes.md index 36a3ed3f0de..836fa1aa854 100644 --- a/docs/atl/reference/atl-classes.md +++ b/docs/atl/reference/atl-classes.md @@ -6,6 +6,8 @@ helpviewer_keywords: ["classes [C++], ATL", "ATL, classes"] --- # ATL classes and structs +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + The Active Template Library (ATL) includes the following classes and structs. To find a particular class by category, see the [ATL Class Overview](../../atl/atl-class-overview.md). |Class / struct|Description|Header file| diff --git a/docs/atl/reference/atl-com-module70-structure.md b/docs/atl/reference/atl-com-module70-structure.md index 3f37add4ec9..424d68a7e57 100644 --- a/docs/atl/reference/atl-com-module70-structure.md +++ b/docs/atl/reference/atl-com-module70-structure.md @@ -4,10 +4,11 @@ title: "_ATL_COM_MODULE70 Structure" ms.date: "11/04/2016" f1_keywords: ["ATL::_ATL_COM_MODULE70", "ATL._ATL_COM_MODULE70", "_ATL_COM_MODULE70"] helpviewer_keywords: ["_ATL_COM_MODULE70 structure", "ATL_COM_MODULE70 structure"] -ms.assetid: 5b0b2fd0-bdeb-4c7e-8870-78fa69ace6e6 --- # _ATL_COM_MODULE70 Structure +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Used by COM-related code in ATL. ## Syntax diff --git a/docs/atl/reference/atl-com-plus-1-0-component-wizard.md b/docs/atl/reference/atl-com-plus-1-0-component-wizard.md index 4f342caa931..a72c326005e 100644 --- a/docs/atl/reference/atl-com-plus-1-0-component-wizard.md +++ b/docs/atl/reference/atl-com-plus-1-0-component-wizard.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL COM+ 1.0 Component Wizard" title: "ATL COM+ 1.0 Component Wizard" ms.date: "05/08/2019" helpviewer_keywords: ["ATL projects, adding components"] -ms.assetid: 11670681-8671-4122-96a4-2e52f8dadce0 --- # ATL COM+ 1.0 Component Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" This wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/atl-control-wizard.md b/docs/atl/reference/atl-control-wizard.md index f1ba09a54dd..1c7f40ee9f4 100644 --- a/docs/atl/reference/atl-control-wizard.md +++ b/docs/atl/reference/atl-control-wizard.md @@ -4,10 +4,11 @@ title: "ATL Control Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.class.atl.control.overview"] helpviewer_keywords: ["ATL projects, adding controls", "controls [ATL], adding to projects", "ATL Control Wizard"] -ms.assetid: 991f8e72-ffbc-4382-a4ce-e255acfba5b6 --- # ATL Control Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Inserts into an ATL project (or an MFC project with ATL support) an ATL control. You can use this wizard to insert one of three kinds of controls: - Standard control diff --git a/docs/atl/reference/atl-dialog-wizard.md b/docs/atl/reference/atl-dialog-wizard.md index c2908571e3c..862cb038b71 100644 --- a/docs/atl/reference/atl-dialog-wizard.md +++ b/docs/atl/reference/atl-dialog-wizard.md @@ -4,10 +4,11 @@ title: "ATL Dialog Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.class.atl.dlg.overview"] helpviewer_keywords: ["ATL projects, adding dialog resources", "ATL Dialog Wizard"] -ms.assetid: b0b9ace5-83c9-40d3-82c3-eb6293f10583 --- # ATL Dialog Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This wizard inserts into the project an ATL dialog box object, derived from [CAxDialogImpl](../../atl/reference/caxdialogimpl-class.md). A dialog box derived from `CAxDialogImpl` can host ActiveX controls. The wizard creates a dialog resource with default **OK** and **Cancel** buttons. You can edit the dialog resource and add ActiveX controls using the [Dialog Editor](../../windows/dialog-editor.md) in Resource View. diff --git a/docs/atl/reference/atl-drawinfo-structure.md b/docs/atl/reference/atl-drawinfo-structure.md index 8c44e5e231a..971943f6209 100644 --- a/docs/atl/reference/atl-drawinfo-structure.md +++ b/docs/atl/reference/atl-drawinfo-structure.md @@ -4,10 +4,11 @@ title: "ATL_DRAWINFO Structure" ms.date: "11/04/2016" f1_keywords: ["ATL::ATL_DRAWINFO", "ATL_DRAWINFO", "ATL.ATL_DRAWINFO"] helpviewer_keywords: ["ATL_DRAWINFO structure"] -ms.assetid: dd2e2aa8-e8c5-403b-b4df-35c0f6f57fb7 --- # ATL_DRAWINFO Structure +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Contains information used for rendering to various targets, such as a printer, metafile, or ActiveX control. ## Syntax diff --git a/docs/atl/reference/atl-func-info-structure.md b/docs/atl/reference/atl-func-info-structure.md index 2be432a32d9..7f3e2b1dc1d 100644 --- a/docs/atl/reference/atl-func-info-structure.md +++ b/docs/atl/reference/atl-func-info-structure.md @@ -4,10 +4,11 @@ title: "_ATL_FUNC_INFO Structure" ms.date: "11/04/2016" f1_keywords: ["_ATL_FUNC_INFO", "ATL::_ATL_FUNC_INFO", "ATL._ATL_FUNC_INFO"] helpviewer_keywords: ["_ATL_FUNC_INFO structure", "ATL_FUNC_INFO structure"] -ms.assetid: 441ebe2c-f971-47de-9f52-a258e8d6f88e --- # _ATL_FUNC_INFO Structure +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Contains type information used to describe a method or property on a dispinterface. ## Syntax diff --git a/docs/atl/reference/atl-functions.md b/docs/atl/reference/atl-functions.md index f32f42b2041..96a93f09150 100644 --- a/docs/atl/reference/atl-functions.md +++ b/docs/atl/reference/atl-functions.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Functions" title: "ATL Functions" ms.date: "11/04/2016" helpviewer_keywords: ["functions [ATL]", "ATL, global functions"] -ms.assetid: 69db0cb2-de1d-445b-b692-020d6e8c2173 --- # ATL Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + To find an ATL function by category, see the following topics. [ATL Path Functions](../../atl/reference/com-map-global-functions.md)
diff --git a/docs/atl/reference/atl-global-variables.md b/docs/atl/reference/atl-global-variables.md index 68a23951c11..553aec1f266 100644 --- a/docs/atl/reference/atl-global-variables.md +++ b/docs/atl/reference/atl-global-variables.md @@ -4,10 +4,11 @@ title: "ATL Global Variables" ms.date: "12/06/2017" f1_keywords: ["ATLBASE/_pAtlModule"] helpviewer_keywords: ["global variables, ATL", "_pAtlModule"] -ms.assetid: e881a319-99ca-4f5d-8a0b-34b3dcd0f37f --- # ATL Global Variables +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ## _pAtlModule A global variable storing a pointer to the current module. diff --git a/docs/atl/reference/atl-http-utility-functions.md b/docs/atl/reference/atl-http-utility-functions.md index 47f78813f00..6980b30e704 100644 --- a/docs/atl/reference/atl-http-utility-functions.md +++ b/docs/atl/reference/atl-http-utility-functions.md @@ -2,10 +2,11 @@ description: "Learn more about: ATL HTTP Utility Functions" title: "ATL HTTP Utility Functions" ms.date: "11/04/2016" -ms.assetid: 4db57ef2-31fa-4696-bbeb-79a9035033ed --- # ATL HTTP Utility Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions support manipulation of URLs. |Function|Description| diff --git a/docs/atl/reference/atl-macros.md b/docs/atl/reference/atl-macros.md index 28f62b30117..d660507aeb8 100644 --- a/docs/atl/reference/atl-macros.md +++ b/docs/atl/reference/atl-macros.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Macros" title: "ATL Macros" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, macros", "macros, ATL"] -ms.assetid: 788bd803-e7dc-4dc5-9e8d-31649471415b --- # ATL Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + To find an ATL macro by category, see the following topics. [Aggregation and Class Factory Macros](../../atl/reference/aggregation-and-class-factory-macros.md)
diff --git a/docs/atl/reference/atl-module70-structure.md b/docs/atl/reference/atl-module70-structure.md index eeee4263273..642c262492a 100644 --- a/docs/atl/reference/atl-module70-structure.md +++ b/docs/atl/reference/atl-module70-structure.md @@ -4,10 +4,11 @@ title: "_ATL_MODULE70 Structure" ms.date: "11/04/2016" f1_keywords: ["_ATL_MODULE70", "ATL::_ATL_MODULE70", "ATL._ATL_MODULE70"] helpviewer_keywords: ["ATL_MODULE70 structure", "_ATL_MODULE70 structure"] -ms.assetid: b059b2c8-dfd1-4ac9-b07d-39df638cc7b3 --- # _ATL_MODULE70 Structure +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Contains data used by every ATL module. ## Syntax diff --git a/docs/atl/reference/atl-ole-db-consumer-wizard.md b/docs/atl/reference/atl-ole-db-consumer-wizard.md index da09ffeebbb..8192655ec73 100644 --- a/docs/atl/reference/atl-ole-db-consumer-wizard.md +++ b/docs/atl/reference/atl-ole-db-consumer-wizard.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL OLE DB Consumer Wizard" title: "ATL OLE DB Consumer Wizard" ms.date: "07/02/2019" helpviewer_keywords: ["ATL projects, adding ATL OLE DB consumers"] -ms.assetid: dcb68ed1-2224-422f-9f7b-108a74864204 --- # ATL OLE DB Consumer Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" This wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/atl-ole-db-provider-wizard.md b/docs/atl/reference/atl-ole-db-provider-wizard.md index 29417f6f85d..e0d73a85994 100644 --- a/docs/atl/reference/atl-ole-db-provider-wizard.md +++ b/docs/atl/reference/atl-ole-db-provider-wizard.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL OLE DB Provider Wizard" title: "ATL OLE DB Provider Wizard" ms.date: "05/09/2019" helpviewer_keywords: ["ATL projects, adding ATL OLE DB providers"] -ms.assetid: cf91ba78-01d1-4d12-b673-e95d96bfbebe --- # ATL OLE DB Provider Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" This wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/atl-operators.md b/docs/atl/reference/atl-operators.md index 85beb951ab3..2e16c36d15a 100644 --- a/docs/atl/reference/atl-operators.md +++ b/docs/atl/reference/atl-operators.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Operators" title: "ATL Operators" ms.date: "11/04/2016" helpviewer_keywords: ["operators [ATL]"] -ms.assetid: 58ccd252-2869-45ee-8a5c-3ca40ee7f8a2 --- # ATL Operators +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This section contains the reference topics for the ATL global operators. |Operator|Description| diff --git a/docs/atl/reference/atl-path-functions.md b/docs/atl/reference/atl-path-functions.md index 33562d071a8..709a5e9f82a 100644 --- a/docs/atl/reference/atl-path-functions.md +++ b/docs/atl/reference/atl-path-functions.md @@ -4,10 +4,11 @@ title: "ATL Path functions" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, path"] f1_keywords: ["ATLPATH/ATL::ATLPath::AddBackslash", "ATLPATH/ATL::ATLPath::AddExtension", "ATLPATH/ATL::ATLPath::Append", "ATLPATH/ATL::ATLPath::BuildRoot", "ATLPATH/ATL::ATLPath::Canonicalize", "ATLPATH/ATL::ATLPath::Combine", "ATLPATH/ATL::ATLPath::CommonPrefix", "ATLPATH/ATL::ATLPath::CompactPath", "ATLPATH/ATL::ATLPath::CompactPathEx", "ATLPATH/ATL::ATLPath::FileExists", "ATLPATH/ATL::ATLPath::FindExtension", "ATLPATH/ATL::ATLPath::FindFileName", "ATLPATH/ATL::ATLPath::GetDriveNumber", "ATLPATH/ATL::ATLPath::IsDirectory", "ATLPATH/ATL::ATLPath::IsFileSpec", "ATLPATH/ATL::ATLPath::IsPrefix", "ATLPATH/ATL::ATLPath::IsRelative", "ATLPATH/ATL::ATLPath::IsRoot", "ATLPATH/ATL::ATLPath::IsSameRoot", "ATLPATH/ATL::ATLPath::IsUNC", "ATLPATH/ATL::ATLPath::IsUNCServer", "ATLPATH/ATL::ATLPath::IsUNCServerShare", "ATLPATH/ATL::ATLPath::MakePretty", "ATLPATH/ATL::ATLPath::MatchSpec", "ATLPATH/ATL::ATLPath::QuoteSpaces", "ATLPATH/ATL::ATLPath::RelativePathTo", "ATLPATH/ATL::ATLPath::RemoveArgs", "ATLPATH/ATL::ATLPath::RemoveBackslash", "ATLPATH/ATL::ATLPath::RemoveBlanks", "ATLPATH/ATL::ATLPath::RemoveExtension", "ATLPATH/ATL::ATLPath::RemoveFileSpec", "ATLPATH/ATL::ATLPath::RenameExtension", "ATLPATH/ATL::ATLPath::SkipRoot", "ATLPATH/ATL::ATLPath::StripPath", "ATLPATH/ATL::ATLPath::StripToRoot", "ATLPATH/ATL::ATLPath::UnquoteSpaces"] -ms.assetid: d1ec2b8d-7ec7-43ea-90dd-0a740d2a742b --- # ATL Path functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ATL provides the ATLPath class for manipulating paths in the form of [CPathT](cpatht-class.md). This code can be found in atlpath.h. ## Related Classes diff --git a/docs/atl/reference/atl-project-wizard.md b/docs/atl/reference/atl-project-wizard.md index 54180ade5d1..f0ceeb5726f 100644 --- a/docs/atl/reference/atl-project-wizard.md +++ b/docs/atl/reference/atl-project-wizard.md @@ -4,10 +4,11 @@ title: "ATL Project Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.atl.com.overview"] helpviewer_keywords: ["ATL projects, creating", "ATL Project Wizard"] -ms.assetid: 564d2aaf-5b8e-4c2a-a925-ca40a283ea34 --- # ATL Project Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + The Active Template Library (ATL) is a set of template-based C++ classes that simplify writing small and fast COM objects. The ATL Project Wizard creates a project with the structures to contain COM objects. ## Overview diff --git a/docs/atl/reference/atl-property-page-wizard.md b/docs/atl/reference/atl-property-page-wizard.md index 16c00456903..4d7eb8263ac 100644 --- a/docs/atl/reference/atl-property-page-wizard.md +++ b/docs/atl/reference/atl-property-page-wizard.md @@ -4,10 +4,11 @@ title: "ATL Property Page Wizard" ms.date: "05/09/2019" f1_keywords: ["vc.codewiz.class.atl.ppg.overview"] helpviewer_keywords: ["ATL projects, adding property pages", "ATL Property Page Wizard"] -ms.assetid: 6113e325-facd-4f68-b491-144d75209922 --- # ATL Property Page Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" This wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/atl-simple-object-wizard.md b/docs/atl/reference/atl-simple-object-wizard.md index 23a819b1bf8..392f374f655 100644 --- a/docs/atl/reference/atl-simple-object-wizard.md +++ b/docs/atl/reference/atl-simple-object-wizard.md @@ -4,10 +4,11 @@ title: "ATL Simple Object Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.class.atl.simple.overview"] helpviewer_keywords: ["ATL projects, adding objects", "ATL Simple Object Wizard"] -ms.assetid: f7f85741-9aad-4543-a917-a29b996364da --- # ATL Simple Object Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This wizard inserts into the project a minimal COM object. Use this page of the wizard to specify the names that identify the C++ class and files for your object and its COM functionality. Use the [Options](../../atl/reference/options-atl-simple-object-wizard.md) page of this wizard to specify the object's threading model, its aggregation support, and whether it supports dual interfaces and Automation. You can also indicate support for the error information interface, connection points, Internet Explorer support, and free-threaded marshaling. diff --git a/docs/atl/reference/atl-text-encoding-functions.md b/docs/atl/reference/atl-text-encoding-functions.md index aa50e31f2ef..6afe2a4900b 100644 --- a/docs/atl/reference/atl-text-encoding-functions.md +++ b/docs/atl/reference/atl-text-encoding-functions.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Text Encoding Functions" title: "ATL Text Encoding Functions" ms.date: "11/04/2016" f1_keywords: ["atlbase/ATL::AtlGetHexValue", "atlbase/ATL::AtlGetVersion", "atlenc/ATL::AtlHexDecode", "atlenc/ATL::AtlHexDecodeGetRequiredLength", "atlenc/ATL::AtlHexEncode", "atlenc/ATL::AtlHexEncodeGetRequiredLength", "atlenc/ATL::AtlHexValue", "atlenc/ATL::BEncode", "atlenc/ATL::BEncodeGetRequiredLength", "atlenc/ATL::EscapeXML", "atlenc/ATL::GetExtendedChars", "atlenc/ATL::IsExtendedChar", "atlenc/ATL::QEncode", "atlenc/ATL::QEncodeGetRequiredLength", "atlenc/ATL::QPDecode", "atlenc/ATL::QPDecodeGetRequiredLength", "atlenc/ATL::QPEncode", "atlenc/ATL::QPEncodeGetRequiredLength", "atlenc/ATL::UUDecode", "atlenc/ATL::UUDecodeGetRequiredLength", "atlenc/ATL::UUEncode", "atlenc/ATL::UUEncodeGetRequiredLength"] -ms.assetid: 2ae1648b-2b87-4112-92aa-0069fcfd23da --- # ATL Text Encoding Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions support text encoding and decoding. |Function|Description| diff --git a/docs/atl/reference/atl-typedefs.md b/docs/atl/reference/atl-typedefs.md index 471587e3278..28f4a79773f 100644 --- a/docs/atl/reference/atl-typedefs.md +++ b/docs/atl/reference/atl-typedefs.md @@ -4,10 +4,11 @@ title: "ATL Typedefs" ms.date: "11/04/2016" f1_keywords: ["atlcore/ATL::_ATL_BASE_MODULE", "atlbase/ATL::_ATL_COM_MODULE", "atlbase/ATL::_ATL_MODULE", "atlbase/ATL::_ATL_WIN_MODULE", "atlutil/ATL::ATL_URL_PORT", "atlbase/ATL::CComDispatchDriver", "atlbase/ATL::CComGlobalsThreadModel", "atlbase/ATL::CComObjectThreadModel", "atlwin/ATL::CContainedWindow", "atlpath/ATL::CPath", "atlpath/ATL::CPathA", "atlpath/ATL::CPathW", " atlsimpcoll/ATL::CSimpleValArray", " atlutil/ATL::LPCURL", "atlbase/ATL::DefaultThreadTraits", "atlutil/ATL::LPURL"] helpviewer_keywords: ["typedefs, ATL", "typedefs", "ATL, typedefs"] -ms.assetid: 7dd05baa-3efb-4e3b-af23-793c610f4560 --- # ATL Typedefs +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + The Active Template Library includes the following typedefs. |Typedef|Description| diff --git a/docs/atl/reference/atl-url-scheme-enum.md b/docs/atl/reference/atl-url-scheme-enum.md index fbed95cb013..8c6df2df608 100644 --- a/docs/atl/reference/atl-url-scheme-enum.md +++ b/docs/atl/reference/atl-url-scheme-enum.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL_URL_SCHEME" title: "ATL_URL_SCHEME enumeration" ms.date: "11/04/2016" helpviewer_keywords: ["ATLUTIL/ATL::ATL_URL_SCHEME"] -ms.assetid: f4131046-8ba0-4ec1-8209-84203f05d20e --- # ATL_URL_SCHEME +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + The members of this enumeration provide constants for the schemes understood by [CUrl](curl-class.md). ## Syntax diff --git a/docs/atl/reference/atl-win-module70-structure.md b/docs/atl/reference/atl-win-module70-structure.md index 4a053f0aecd..b5e717cbc3a 100644 --- a/docs/atl/reference/atl-win-module70-structure.md +++ b/docs/atl/reference/atl-win-module70-structure.md @@ -4,10 +4,11 @@ title: "_ATL_WIN_MODULE70 Structure" ms.date: "11/04/2016" f1_keywords: ["_ATL_WIN_MODULE70", "ATL::_ATL_WIN_MODULE70", "ATL._ATL_WIN_MODULE70"] helpviewer_keywords: ["_ATL_WIN_MODULE70 structure", "ATL_WIN_MODULE70 structure"] -ms.assetid: a0aaf3ea-ca77-46ec-bd53-4dfb61dffbea --- # _ATL_WIN_MODULE70 Structure +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Used by windowing code in ATL. ## Syntax diff --git a/docs/atl/reference/atl-wizards-and-dialog-boxes.md b/docs/atl/reference/atl-wizards-and-dialog-boxes.md index 0632227a113..0b3400f14d8 100644 --- a/docs/atl/reference/atl-wizards-and-dialog-boxes.md +++ b/docs/atl/reference/atl-wizards-and-dialog-boxes.md @@ -3,10 +3,11 @@ description: "Learn more about: ATL Wizards and Dialog Boxes" title: "ATL Wizards and Dialog Boxes" ms.date: "06/26/2020" helpviewer_keywords: ["ATL, class wizards"] -ms.assetid: 51cf002a-83bc-41ba-aeb8-364ea2331375 --- # ATL Wizards and Dialog Boxes +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + The Active Template Library (ATL) wizards generate boilerplate code for various kinds of COM objects. You can run the wizards by opening the shortcut menu for a project in **Solution Explorer** and choosing **Add**, **Class**. ## Related Articles diff --git a/docs/atl/reference/atlcreatewnddata-structure.md b/docs/atl/reference/atlcreatewnddata-structure.md index ab5f1b3cf66..ccef921db99 100644 --- a/docs/atl/reference/atlcreatewnddata-structure.md +++ b/docs/atl/reference/atlcreatewnddata-structure.md @@ -4,10 +4,11 @@ title: "_AtlCreateWndData Structure" ms.date: "11/04/2016" f1_keywords: ["ATL::_AtlCreateWndData", "ATL._AtlCreateWndData", "_AtlCreateWndData"] helpviewer_keywords: ["_AtlCreateWndData structure", "AtlCreateWndData structure"] -ms.assetid: 76ed5382-bfbf-4b8b-8a29-912688dfd2ae --- # _AtlCreateWndData Structure +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This structure contains class instance data in windowing code in ATL. ## Syntax diff --git a/docs/atl/reference/ca2aex-class.md b/docs/atl/reference/ca2aex-class.md index 17184ac1d4a..17355a4e6d8 100644 --- a/docs/atl/reference/ca2aex-class.md +++ b/docs/atl/reference/ca2aex-class.md @@ -4,10 +4,11 @@ title: "CA2AEX Class" ms.date: "11/04/2016" f1_keywords: ["CA2AEX", "ATLCONV/ATL::CA2AEX", "ATLCONV/ATL::CA2AEX::CA2AEX", "ATLCONV/ATL::CA2AEX::m_psz", "ATLCONV/ATL::CA2AEX::m_szBuffer"] helpviewer_keywords: ["CA2AEX class"] -ms.assetid: 57dc65df-d9cf-4a84-99d3-6e031dde3664 --- # CA2AEX Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is used by the string conversion macros CA2TEX and CT2AEX, and the typedef CA2A. > [!IMPORTANT] diff --git a/docs/atl/reference/ca2caex-class.md b/docs/atl/reference/ca2caex-class.md index 384efbd5ea5..74d94867f69 100644 --- a/docs/atl/reference/ca2caex-class.md +++ b/docs/atl/reference/ca2caex-class.md @@ -4,10 +4,11 @@ title: "CA2CAEX Class" ms.date: "11/04/2016" f1_keywords: ["CA2CAEX", "ATLCONV/ATL::CA2CAEX", "ATLCONV/ATL::CA2CAEX::CA2CAEX", "ATLCONV/ATL::CA2CAEX::m_psz"] helpviewer_keywords: ["CA2CAEX class"] -ms.assetid: 388e7c1d-a144-474c-a182-b15f69a74bd8 --- # CA2CAEX Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is used by string conversion macros CA2CTEX and CT2CAEX, and the typedef CA2CA. > [!IMPORTANT] diff --git a/docs/atl/reference/ca2wex-class.md b/docs/atl/reference/ca2wex-class.md index 6b350dc68cf..efe52c7c486 100644 --- a/docs/atl/reference/ca2wex-class.md +++ b/docs/atl/reference/ca2wex-class.md @@ -4,10 +4,11 @@ title: "CA2WEX Class" ms.date: "11/04/2016" f1_keywords: ["CA2WEX", "ATLCONV/ATL::CA2WEX", "ATLCONV/ATL::CA2WEX::CA2WEX", "ATLCONV/ATL::CA2WEX::m_psz", "ATLCONV/ATL::CA2WEX::m_szBuffer"] helpviewer_keywords: ["CA2WEX class"] -ms.assetid: 317d9ffb-e84f-47e8-beda-57e28fb19124 --- # CA2WEX Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is used by the string conversion macros CA2TEX, CA2CTEX, CT2WEX, and CT2CWEX, and the typedef CA2W. > [!IMPORTANT] diff --git a/docs/atl/reference/caccesstoken-class.md b/docs/atl/reference/caccesstoken-class.md index 49272bfcd4a..6cd58e432ee 100644 --- a/docs/atl/reference/caccesstoken-class.md +++ b/docs/atl/reference/caccesstoken-class.md @@ -4,10 +4,11 @@ title: "CAccessToken Class" ms.date: "07/02/2019" f1_keywords: ["CAccessToken", "ATLSECURITY/ATL::CAccessToken", "ATLSECURITY/ATL::CAccessToken::Attach", "ATLSECURITY/ATL::CAccessToken::CheckTokenMembership", "ATLSECURITY/ATL::CAccessToken::CreateImpersonationToken", "ATLSECURITY/ATL::CAccessToken::CreatePrimaryToken", "ATLSECURITY/ATL::CAccessToken::CreateProcessAsUser", "ATLSECURITY/ATL::CAccessToken::CreateRestrictedToken", "ATLSECURITY/ATL::CAccessToken::Detach", "ATLSECURITY/ATL::CAccessToken::DisablePrivilege", "ATLSECURITY/ATL::CAccessToken::DisablePrivileges", "ATLSECURITY/ATL::CAccessToken::EnablePrivilege", "ATLSECURITY/ATL::CAccessToken::EnablePrivileges", "ATLSECURITY/ATL::CAccessToken::GetDefaultDacl", "ATLSECURITY/ATL::CAccessToken::GetEffectiveToken", "ATLSECURITY/ATL::CAccessToken::GetGroups", "ATLSECURITY/ATL::CAccessToken::GetHandle", "ATLSECURITY/ATL::CAccessToken::GetImpersonationLevel", "ATLSECURITY/ATL::CAccessToken::GetLogonSessionId", "ATLSECURITY/ATL::CAccessToken::GetLogonSid", "ATLSECURITY/ATL::CAccessToken::GetOwner", "ATLSECURITY/ATL::CAccessToken::GetPrimaryGroup", "ATLSECURITY/ATL::CAccessToken::GetPrivileges", "ATLSECURITY/ATL::CAccessToken::GetProcessToken", "ATLSECURITY/ATL::CAccessToken::GetProfile", "ATLSECURITY/ATL::CAccessToken::GetSource", "ATLSECURITY/ATL::CAccessToken::GetStatistics", "ATLSECURITY/ATL::CAccessToken::GetTerminalServicesSessionId", "ATLSECURITY/ATL::CAccessToken::GetThreadToken", "ATLSECURITY/ATL::CAccessToken::GetTokenId", "ATLSECURITY/ATL::CAccessToken::GetType", "ATLSECURITY/ATL::CAccessToken::GetUser", "ATLSECURITY/ATL::CAccessToken::HKeyCurrentUser", "ATLSECURITY/ATL::CAccessToken::Impersonate", "ATLSECURITY/ATL::CAccessToken::ImpersonateLoggedOnUser", "ATLSECURITY/ATL::CAccessToken::IsTokenRestricted", "ATLSECURITY/ATL::CAccessToken::LoadUserProfile", "ATLSECURITY/ATL::CAccessToken::LogonUser", "ATLSECURITY/ATL::CAccessToken::OpenCOMClientToken", "ATLSECURITY/ATL::CAccessToken::OpenNamedPipeClientToken", "ATLSECURITY/ATL::CAccessToken::OpenRPCClientToken", "ATLSECURITY/ATL::CAccessToken::OpenThreadToken", "ATLSECURITY/ATL::CAccessToken::PrivilegeCheck", "ATLSECURITY/ATL::CAccessToken::Revert", "ATLSECURITY/ATL::CAccessToken::SetDefaultDacl", "ATLSECURITY/ATL::CAccessToken::SetOwner", "ATLSECURITY/ATL::CAccessToken::SetPrimaryGroup"] helpviewer_keywords: ["CAccessToken class"] -ms.assetid: bb5c5945-56a5-4083-b442-76573cee83ab --- # CAccessToken Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for an access token. > [!IMPORTANT] diff --git a/docs/atl/reference/cacl-class.md b/docs/atl/reference/cacl-class.md index 1521ad15fe8..49733e001d4 100644 --- a/docs/atl/reference/cacl-class.md +++ b/docs/atl/reference/cacl-class.md @@ -4,10 +4,11 @@ title: "CAcl Class" ms.date: "11/04/2016" f1_keywords: ["CAcl", "ATLSECURITY/ATL::CAcl", "ATLSECURITY/ATL::CAcl::CAccessMaskArray", "ATLSECURITY/ATL::CAcl::CAceFlagArray", "ATLSECURITY/ATL::CAcl::CAceTypeArray", "ATLSECURITY/ATL::CAcl::CAcl", "ATLSECURITY/ATL::CAcl::GetAceCount", "ATLSECURITY/ATL::CAcl::GetAclEntries", "ATLSECURITY/ATL::CAcl::GetAclEntry", "ATLSECURITY/ATL::CAcl::GetLength", "ATLSECURITY/ATL::CAcl::GetPACL", "ATLSECURITY/ATL::CAcl::IsEmpty", "ATLSECURITY/ATL::CAcl::IsNull", "ATLSECURITY/ATL::CAcl::RemoveAce", "ATLSECURITY/ATL::CAcl::RemoveAces", "ATLSECURITY/ATL::CAcl::SetEmpty", "ATLSECURITY/ATL::CAcl::SetNull"] helpviewer_keywords: ["CAcl class"] -ms.assetid: 20bcb9af-dc1c-4737-b923-3864776680d6 --- # CAcl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for an `ACL` (access-control list) structure. > [!IMPORTANT] diff --git a/docs/atl/reference/cadapt-class.md b/docs/atl/reference/cadapt-class.md index e3596e34f0d..010fa0f3f7f 100644 --- a/docs/atl/reference/cadapt-class.md +++ b/docs/atl/reference/cadapt-class.md @@ -4,10 +4,11 @@ title: "CAdapt Class" ms.date: "11/04/2016" f1_keywords: ["CAdapt", "ATLCOMCLI/ATL::CAdapt", "ATLCOMCLI/ATL::CAdapt::CAdapt", "ATLCOMCLI/ATL::CAdapt::m_T"] helpviewer_keywords: ["address-of operator", "adapter objects", "& operator, address-of operator", "CAdapt class"] -ms.assetid: 0bb695a5-72fe-43d1-8f39-7e4da6e34765 --- # CAdapt Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This template is used to wrap classes that redefine the address-of operator to return something other than the address of the object. ## Syntax diff --git a/docs/atl/reference/category-macros.md b/docs/atl/reference/category-macros.md index 2520af59602..c6339244da1 100644 --- a/docs/atl/reference/category-macros.md +++ b/docs/atl/reference/category-macros.md @@ -3,10 +3,11 @@ description: "Learn more about: Category Macros" title: "Category Macros" ms.date: "11/04/2016" f1_keywords: ["ATLCOM/BEGIN_CATEGORY_MAP", "ATLCOM/END_CATEGORY_MAP", "ATLCOM/IMPLEMENTED_CATEGORY", "ATLCOM/REQUIRED_CATEGORY", "atlcom/ATL::BEGIN_CATEGORY_MAP", "atlcom/ATL::END_CATEGORY_MAP", "atlcom/ATL::IMPLEMENTED_CATEGORY", "atlcom/ATL::REQUIRED_CATEGORY"] -ms.assetid: 223578cb-6180-4787-a8d8-ba3787a5d3ee --- # Category Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define category maps. |Macro|Description| diff --git a/docs/atl/reference/catlarray-class.md b/docs/atl/reference/catlarray-class.md index e2ff7b40f54..9a7af00b550 100644 --- a/docs/atl/reference/catlarray-class.md +++ b/docs/atl/reference/catlarray-class.md @@ -4,10 +4,11 @@ title: "CAtlArray Class" ms.date: "11/04/2016" f1_keywords: ["CAtlArray", "ATLCOLL/ATL::CAtlArray", "ATLCOLL/ATL::Add", "ATLCOLL/ATL::Append", "ATLCOLL/ATL::AssertValid", "ATLCOLL/ATL::Copy", "ATLCOLL/ATL::FreeExtra", "ATLCOLL/ATL::GetAt", "ATLCOLL/ATL::GetCount", "ATLCOLL/ATL::GetData", "ATLCOLL/ATL::InsertArrayAt", "ATLCOLL/ATL::InsertAt", "ATLCOLL/ATL::IsEmpty", "ATLCOLL/ATL::RemoveAll", "ATLCOLL/ATL::RemoveAt", "ATLCOLL/ATL::SetAt", "ATLCOLL/ATL::SetAtGrow", "ATLCOLL/ATL::SetCount", "ATLCOLL/ATL::INARGTYPE", "ATLCOLL/ATL::OUTARGTYPE"] helpviewer_keywords: ["CAtlArray class"] -ms.assetid: 0b503aa8-2357-40af-a326-6654bf1da098 --- # CAtlArray Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements an array object. ## Syntax diff --git a/docs/atl/reference/catlautothreadmodule-class.md b/docs/atl/reference/catlautothreadmodule-class.md index ad171cbf113..fde8b27ac04 100644 --- a/docs/atl/reference/catlautothreadmodule-class.md +++ b/docs/atl/reference/catlautothreadmodule-class.md @@ -4,10 +4,11 @@ title: "CAtlAutoThreadModule Class" ms.date: "11/04/2016" f1_keywords: ["CAtlAutoThreadModule", "atlbase/ATL::CAtlAutoThreadModule"] helpviewer_keywords: ["CAtlAutoThreadModule class"] -ms.assetid: 3be834aa-55ef-403e-94ae-41979691b15f --- # CAtlAutoThreadModule Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements a thread-pooled, apartment-model COM server. > [!IMPORTANT] diff --git a/docs/atl/reference/catlautothreadmodulet-class.md b/docs/atl/reference/catlautothreadmodulet-class.md index b3551f67c25..fdc99205556 100644 --- a/docs/atl/reference/catlautothreadmodulet-class.md +++ b/docs/atl/reference/catlautothreadmodulet-class.md @@ -4,10 +4,11 @@ title: "CAtlAutoThreadModuleT Class" ms.date: "11/04/2016" f1_keywords: ["CAtlAutoThreadModuleT", "ATLBASE/ATL::CAtlAutoThreadModuleT", "ATLBASE/ATL::CAtlAutoThreadModuleT::GetDefaultThreads"] helpviewer_keywords: ["CAtlAutoThreadModuleT class"] -ms.assetid: ae1667c6-3fb8-47bc-b35d-9ea5e9896d7f --- # CAtlAutoThreadModuleT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for implementing a thread-pooled, apartment-model COM server. > [!IMPORTANT] diff --git a/docs/atl/reference/catlbasemodule-class.md b/docs/atl/reference/catlbasemodule-class.md index ca75cf7b50b..1126d5109ea 100644 --- a/docs/atl/reference/catlbasemodule-class.md +++ b/docs/atl/reference/catlbasemodule-class.md @@ -4,10 +4,11 @@ title: "CAtlBaseModule Class" ms.date: "11/04/2016" f1_keywords: ["CAtlBaseModule", "ATLCORE/ATL::CAtlBaseModule", "ATLCORE/ATL::CAtlBaseModule::CAtlBaseModule", "ATLCORE/ATL::CAtlBaseModule::AddResourceInstance", "ATLCORE/ATL::CAtlBaseModule::GetHInstanceAt", "ATLCORE/ATL::CAtlBaseModule::GetModuleInstance", "ATLCORE/ATL::CAtlBaseModule::GetResourceInstance", "ATLCORE/ATL::CAtlBaseModule::RemoveResourceInstance", "ATLCORE/ATL::CAtlBaseModule::SetResourceInstance", "ATLCORE/ATL::CAtlBaseModule::m_bInitFailed"] helpviewer_keywords: ["CAtlBaseModule class"] -ms.assetid: 55ade80c-9b0c-4c51-933e-2158436c1096 --- # CAtlBaseModule Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is instantiated in every ATL project. ## Syntax diff --git a/docs/atl/reference/catlcommodule-class.md b/docs/atl/reference/catlcommodule-class.md index ec1824a9769..cb307e817bc 100644 --- a/docs/atl/reference/catlcommodule-class.md +++ b/docs/atl/reference/catlcommodule-class.md @@ -4,10 +4,11 @@ title: "CAtlComModule Class" ms.date: "11/04/2016" f1_keywords: ["CAtlComModule", "ATLBASE/ATL::CAtlComModule", "ATLBASE/ATL::CAtlComModule::CAtlComModule", "ATLBASE/ATL::CAtlComModule::RegisterServer", "ATLBASE/ATL::CAtlComModule::RegisterTypeLib", "ATLBASE/ATL::CAtlComModule::UnregisterServer", "ATLBASE/ATL::CAtlComModule::UnRegisterTypeLib"] helpviewer_keywords: ["CAtlComModule class"] -ms.assetid: af5dd71a-a0d1-4a2e-9a24-154a03381c75 --- # CAtlComModule Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements a COM server module. ## Syntax diff --git a/docs/atl/reference/catldebuginterfacesmodule-class.md b/docs/atl/reference/catldebuginterfacesmodule-class.md index 38a674b3e7c..ff00c86e3c5 100644 --- a/docs/atl/reference/catldebuginterfacesmodule-class.md +++ b/docs/atl/reference/catldebuginterfacesmodule-class.md @@ -4,10 +4,11 @@ title: "CAtlDebugInterfacesModule Class" ms.date: "11/04/2016" f1_keywords: ["CAtlDebugInterfacesModule", "atlbase/ATL::CAtlDebugInterfacesModule"] helpviewer_keywords: ["_ATL_DEBUG_QI macro", "CAtlDebugInterfacesModule class"] -ms.assetid: a193b567-8191-4115-a963-a10805972bac --- # CAtlDebugInterfacesModule Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides support for debugging interfaces. ## Syntax diff --git a/docs/atl/reference/catldllmodulet-class.md b/docs/atl/reference/catldllmodulet-class.md index af960db0ee0..95c947d68cd 100644 --- a/docs/atl/reference/catldllmodulet-class.md +++ b/docs/atl/reference/catldllmodulet-class.md @@ -4,10 +4,11 @@ title: "CAtlDllModuleT Class" ms.date: "11/04/2016" f1_keywords: ["CAtlDllModuleT", "ATLBASE/ATL::CAtlDllModuleT", "ATLBASE/ATL::CAtlDllModuleT::CAtlDllModuleT", "ATLBASE/ATL::CAtlDllModuleT::DllCanUnloadNow", "ATLBASE/ATL::CAtlDllModuleT::DllGetClassObject", "ATLBASE/ATL::CAtlDllModuleT::DllMain", "ATLBASE/ATL::CAtlDllModuleT::DllRegisterServer", "ATLBASE/ATL::CAtlDllModuleT::DllUnregisterServer", "ATLBASE/ATL::CAtlDllModuleT::GetClassObject"] helpviewer_keywords: ["CAtlDllModuleT class"] -ms.assetid: 351d5767-8257-4878-94be-45a85e31a72d --- # CAtlDllModuleT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents the module for a DLL. ## Syntax diff --git a/docs/atl/reference/catlexception-class.md b/docs/atl/reference/catlexception-class.md index 5549aa2ab77..584270063fc 100644 --- a/docs/atl/reference/catlexception-class.md +++ b/docs/atl/reference/catlexception-class.md @@ -4,10 +4,11 @@ title: "CAtlException Class" ms.date: "11/04/2016" f1_keywords: ["CAtlException", "ATLEXCEPT/ATL::CAtlException", "ATLEXCEPT/ATL::CAtlException::CAtlException", "ATLEXCEPT/ATL::CAtlException::m_hr"] helpviewer_keywords: ["CAtlException class"] -ms.assetid: 3fd7b041-f70d-4292-b947-0d70781d95a8 --- # CAtlException Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class defines an ATL exception. ## Syntax diff --git a/docs/atl/reference/catlexemodulet-class.md b/docs/atl/reference/catlexemodulet-class.md index 9d191306d99..fa15ff7dee1 100644 --- a/docs/atl/reference/catlexemodulet-class.md +++ b/docs/atl/reference/catlexemodulet-class.md @@ -4,10 +4,11 @@ title: "CAtlExeModuleT Class" ms.date: "11/04/2016" f1_keywords: ["CAtlExeModuleT", "ATLBASE/ATL::CAtlExeModuleT", "ATLBASE/ATL::CAtlExeModuleT::CAtlExeModuleT", "ATLBASE/ATL::CAtlExeModuleT::InitializeCom", "ATLBASE/ATL::CAtlExeModuleT::ParseCommandLine", "ATLBASE/ATL::CAtlExeModuleT::PostMessageLoop", "ATLBASE/ATL::CAtlExeModuleT::PreMessageLoop", "ATLBASE/ATL::CAtlExeModuleT::RegisterClassObjects", "ATLBASE/ATL::CAtlExeModuleT::RevokeClassObjects", "ATLBASE/ATL::CAtlExeModuleT::Run", "ATLBASE/ATL::CAtlExeModuleT::RunMessageLoop", "ATLBASE/ATL::CAtlExeModuleT::UninitializeCom", "ATLBASE/ATL::CAtlExeModuleT::Unlock", "ATLBASE/ATL::CAtlExeModuleT::WinMain", "ATLBASE/ATL::CAtlExeModuleT::m_bDelayShutdown", "ATLBASE/ATL::CAtlExeModuleT::m_dwPause", "ATLBASE/ATL::CAtlExeModuleT::m_dwTimeOut"] helpviewer_keywords: ["CAtlExeModuleT class"] -ms.assetid: 82245f3d-91d4-44fa-aa86-7cc7fbd758d9 --- # CAtlExeModuleT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents the module for an application. ## Syntax diff --git a/docs/atl/reference/catlfile-class.md b/docs/atl/reference/catlfile-class.md index bbc448b9790..d959d4b8c38 100644 --- a/docs/atl/reference/catlfile-class.md +++ b/docs/atl/reference/catlfile-class.md @@ -4,10 +4,11 @@ title: "CAtlFile Class" ms.date: "11/04/2016" f1_keywords: ["CAtlFile", "ATLFILE/ATL::CAtlFile", "ATLFILE/ATL::CAtlFile::CAtlFile", "ATLFILE/ATL::CAtlFile::Create", "ATLFILE/ATL::CAtlFile::Flush", "ATLFILE/ATL::CAtlFile::GetOverlappedResult", "ATLFILE/ATL::CAtlFile::GetPosition", "ATLFILE/ATL::CAtlFile::GetSize", "ATLFILE/ATL::CAtlFile::LockRange", "ATLFILE/ATL::CAtlFile::Read", "ATLFILE/ATL::CAtlFile::Seek", "ATLFILE/ATL::CAtlFile::SetSize", "ATLFILE/ATL::CAtlFile::UnlockRange", "ATLFILE/ATL::CAtlFile::Write", "ATLFILE/ATL::CAtlFile::m_pTM"] helpviewer_keywords: ["CAtlFile class"] -ms.assetid: 93ed160b-af2a-448c-9cbe-e5fa46c199bb --- # CAtlFile Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a thin wrapper around the Windows file-handling API. > [!IMPORTANT] diff --git a/docs/atl/reference/catlfilemapping-class.md b/docs/atl/reference/catlfilemapping-class.md index 8eebfc290c1..db442ec69fb 100644 --- a/docs/atl/reference/catlfilemapping-class.md +++ b/docs/atl/reference/catlfilemapping-class.md @@ -4,10 +4,11 @@ title: "CAtlFileMapping Class" ms.date: "11/04/2016" f1_keywords: ["CAtlFileMapping", "atlfile/ATL::CAtlFileMapping"] helpviewer_keywords: ["CAtlFileMapping class"] -ms.assetid: 899fc058-e05e-48b5-aca9-340403bb9e26 --- # CAtlFileMapping Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a memory-mapped file, adding a cast operator to the methods of [CAtlFileMappingBase](../../atl/reference/catlfilemappingbase-class.md). > [!IMPORTANT] diff --git a/docs/atl/reference/catlfilemappingbase-class.md b/docs/atl/reference/catlfilemappingbase-class.md index f7084aa9571..b2bc6e3c4e5 100644 --- a/docs/atl/reference/catlfilemappingbase-class.md +++ b/docs/atl/reference/catlfilemappingbase-class.md @@ -4,10 +4,11 @@ title: "CAtlFileMappingBase Class" ms.date: "11/04/2016" f1_keywords: ["CAtlFileMappingBase", "ATLFILE/ATL::CAtlFileMappingBase", "ATLFILE/ATL::CAtlFileMappingBase::CAtlFileMappingBase", "ATLFILE/ATL::CAtlFileMappingBase::CopyFrom", "ATLFILE/ATL::CAtlFileMappingBase::GetData", "ATLFILE/ATL::CAtlFileMappingBase::GetHandle", "ATLFILE/ATL::CAtlFileMappingBase::GetMappingSize", "ATLFILE/ATL::CAtlFileMappingBase::MapFile", "ATLFILE/ATL::CAtlFileMappingBase::MapSharedMem", "ATLFILE/ATL::CAtlFileMappingBase::OpenMapping", "ATLFILE/ATL::CAtlFileMappingBase::Unmap"] helpviewer_keywords: ["CAtlFileMappingBase class"] -ms.assetid: be555723-2790-4f57-a8fb-be4d68460775 --- # CAtlFileMappingBase Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a memory-mapped file. > [!IMPORTANT] diff --git a/docs/atl/reference/catllist-class.md b/docs/atl/reference/catllist-class.md index 6b1fc2ce91e..a5cada88bd7 100644 --- a/docs/atl/reference/catllist-class.md +++ b/docs/atl/reference/catllist-class.md @@ -4,10 +4,11 @@ title: "CAtlList Class" ms.date: "11/04/2016" f1_keywords: ["CAtlList", "ATLCOLL/ATL::CAtlList", "ATLCOLL/ATL::CAtlList::INARGTYPE", "ATLCOLL/ATL::CAtlList::CAtlList", "ATLCOLL/ATL::CAtlList::AddHead", "ATLCOLL/ATL::CAtlList::AddHeadList", "ATLCOLL/ATL::CAtlList::AddTail", "ATLCOLL/ATL::CAtlList::AddTailList", "ATLCOLL/ATL::CAtlList::AssertValid", "ATLCOLL/ATL::CAtlList::Find", "ATLCOLL/ATL::CAtlList::FindIndex", "ATLCOLL/ATL::CAtlList::GetAt", "ATLCOLL/ATL::CAtlList::GetCount", "ATLCOLL/ATL::CAtlList::GetHead", "ATLCOLL/ATL::CAtlList::GetHeadPosition", "ATLCOLL/ATL::CAtlList::GetNext", "ATLCOLL/ATL::CAtlList::GetPrev", "ATLCOLL/ATL::CAtlList::GetTail", "ATLCOLL/ATL::CAtlList::GetTailPosition", "ATLCOLL/ATL::CAtlList::InsertAfter", "ATLCOLL/ATL::CAtlList::InsertBefore", "ATLCOLL/ATL::CAtlList::IsEmpty", "ATLCOLL/ATL::CAtlList::MoveToHead", "ATLCOLL/ATL::CAtlList::MoveToTail", "ATLCOLL/ATL::CAtlList::RemoveAll", "ATLCOLL/ATL::CAtlList::RemoveAt", "ATLCOLL/ATL::CAtlList::RemoveHead", "ATLCOLL/ATL::CAtlList::RemoveHeadNoReturn", "ATLCOLL/ATL::CAtlList::RemoveTail", "ATLCOLL/ATL::CAtlList::RemoveTailNoReturn", "ATLCOLL/ATL::CAtlList::SetAt", "ATLCOLL/ATL::CAtlList::SwapElements"] helpviewer_keywords: ["CAtlList class"] -ms.assetid: 09e98053-64b2-4efa-99ab-d0542caaf981 --- # CAtlList Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for creating and managing a list object. ## Syntax diff --git a/docs/atl/reference/catlmap-class.md b/docs/atl/reference/catlmap-class.md index b9273b02c8e..1801355e86b 100644 --- a/docs/atl/reference/catlmap-class.md +++ b/docs/atl/reference/catlmap-class.md @@ -4,10 +4,11 @@ title: "CAtlMap Class" ms.date: "11/04/2016" f1_keywords: ["CAtlMap", "ATLCOLL/ATL::CAtlMap", "ATLCOLL/ATL::CAtlMap::KINARGTYPE", "ATLCOLL/ATL::CAtlMap::KOUTARGTYPE", "ATLCOLL/ATL::CAtlMap::VINARGTYPE", "ATLCOLL/ATL::CAtlMap::VOUTARGTYPE", "ATLCOLL/ATL::CPair::m_key", "ATLCOLL/ATL::CPair::m_value", "ATLCOLL/ATL::CAtlMap::CAtlMap", "ATLCOLL/ATL::CAtlMap::AssertValid", "ATLCOLL/ATL::CAtlMap::DisableAutoRehash", "ATLCOLL/ATL::CAtlMap::EnableAutoRehash", "ATLCOLL/ATL::CAtlMap::GetAt", "ATLCOLL/ATL::CAtlMap::GetCount", "ATLCOLL/ATL::CAtlMap::GetHashTableSize", "ATLCOLL/ATL::CAtlMap::GetKeyAt", "ATLCOLL/ATL::CAtlMap::GetNext", "ATLCOLL/ATL::CAtlMap::GetNextAssoc", "ATLCOLL/ATL::CAtlMap::GetNextKey", "ATLCOLL/ATL::CAtlMap::GetNextValue", "ATLCOLL/ATL::CAtlMap::GetStartPosition", "ATLCOLL/ATL::CAtlMap::GetValueAt", "ATLCOLL/ATL::CAtlMap::InitHashTable", "ATLCOLL/ATL::CAtlMap::IsEmpty", "ATLCOLL/ATL::CAtlMap::Lookup", "ATLCOLL/ATL::CAtlMap::Rehash", "ATLCOLL/ATL::CAtlMap::RemoveAll", "ATLCOLL/ATL::CAtlMap::RemoveAtPos", "ATLCOLL/ATL::CAtlMap::RemoveKey", "ATLCOLL/ATL::CAtlMap::SetAt", "ATLCOLL/ATL::CAtlMap::SetOptimalLoad", "ATLCOLL/ATL::CAtlMap::SetValueAt"] helpviewer_keywords: ["CAtlMap class"] -ms.assetid: 5e2fe028-8e6d-4686-93df-1433d2080ec3 --- # CAtlMap Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for creating and managing a map object. ## Syntax diff --git a/docs/atl/reference/catlmodule-class.md b/docs/atl/reference/catlmodule-class.md index 637193f3c88..2136b7f2d94 100644 --- a/docs/atl/reference/catlmodule-class.md +++ b/docs/atl/reference/catlmodule-class.md @@ -4,10 +4,11 @@ title: "CAtlModule Class" ms.date: "11/04/2016" f1_keywords: ["CAtlModule", "ATLBASE/ATL::CAtlModule", "ATLBASE/ATL::CAtlModule::CAtlModule", "ATLBASE/ATL::CAtlModule::AddCommonRGSReplacements", "ATLBASE/ATL::CAtlModule::AddTermFunc", "ATLBASE/ATL::CAtlModule::GetGITPtr", "ATLBASE/ATL::CAtlModule::GetLockCount", "ATLBASE/ATL::CAtlModule::Lock", "ATLBASE/ATL::CAtlModule::Term", "ATLBASE/ATL::CAtlModule::Unlock", "ATLBASE/ATL::CAtlModule::UpdateRegistryFromResourceD", "ATLBASE/ATL::CAtlModule::UpdateRegistryFromResourceDHelper", "ATLBASE/ATL::CAtlModule::UpdateRegistryFromResourceS", "ATLBASE/ATL::CAtlModule::m_libid", "ATLBASE/ATL::CAtlModule::m_pGIT"] helpviewer_keywords: ["CAtlModule class"] -ms.assetid: 63fe02f1-4c4b-4e7c-ae97-7ad7b4252415 --- # CAtlModule Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods used by several ATL module classes. ## Syntax diff --git a/docs/atl/reference/catlmodulet-class.md b/docs/atl/reference/catlmodulet-class.md index aeddee3c887..d8cc2b1db58 100644 --- a/docs/atl/reference/catlmodulet-class.md +++ b/docs/atl/reference/catlmodulet-class.md @@ -4,10 +4,11 @@ title: "CAtlModuleT Class" ms.date: "11/04/2016" f1_keywords: ["CAtlModuleT", "ATLBASE/ATL::CAtlModuleT", "ATLBASE/ATL::CAtlModuleT::CAtlModuleT", "ATLBASE/ATL::CAtlModuleT::InitLibId", "ATLBASE/ATL::CAtlModuleT::RegisterAppId", "ATLBASE/ATL::CAtlModuleT::RegisterServer", "ATLBASE/ATL::CAtlModuleT::UnregisterAppId", "ATLBASE/ATL::CAtlModuleT::UnregisterServer", "ATLBASE/ATL::CAtlModuleT::UpdateRegistryAppId"] helpviewer_keywords: ["CAtlModuleT class"] -ms.assetid: 9b74d02f-9117-47b1-a05e-c5945f83dd2b --- # CAtlModuleT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements an ATL module. ## Syntax diff --git a/docs/atl/reference/catlpreviewctrlimpl-class.md b/docs/atl/reference/catlpreviewctrlimpl-class.md index 2f2fc09617b..c5e24db6ba6 100644 --- a/docs/atl/reference/catlpreviewctrlimpl-class.md +++ b/docs/atl/reference/catlpreviewctrlimpl-class.md @@ -4,10 +4,11 @@ title: "CAtlPreviewCtrlImpl Class" ms.date: "11/04/2016" f1_keywords: ["CAtlPreviewCtrlImpl", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::CAtlPreviewCtrlImpl", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::Create", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::Destroy", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::Focus", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::OnPaint", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::Redraw", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::SetHost", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::SetPreviewVisuals", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::SetRect", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::DoPaint", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::m_plf", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::m_clrBack", "ATLPREVIEWCTRLIMPL/ATL::CAtlPreviewCtrlImpl::m_clrText"] helpviewer_keywords: ["CAtlPreviewCtrlImpl class"] -ms.assetid: 39b3299e-07e4-4abc-9b6e-b54bfa3b0802 --- # CAtlPreviewCtrlImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is an ATL implementation of a window that is placed on a host window provided by the Shell for Rich Preview. > [!IMPORTANT] diff --git a/docs/atl/reference/catlservicemodulet-class.md b/docs/atl/reference/catlservicemodulet-class.md index 8931b815121..19c51da62bc 100644 --- a/docs/atl/reference/catlservicemodulet-class.md +++ b/docs/atl/reference/catlservicemodulet-class.md @@ -4,10 +4,11 @@ title: "CAtlServiceModuleT Class" ms.date: "05/06/2019" f1_keywords: ["CAtlServiceModuleT", "ATLBASE/ATL::CAtlServiceModuleT", "ATLBASE/ATL::CAtlServiceModuleT::CAtlServiceModuleT", "ATLBASE/ATL::CAtlServiceModuleT::Handler", "ATLBASE/ATL::CAtlServiceModuleT::InitializeSecurity", "ATLBASE/ATL::CAtlServiceModuleT::Install", "ATLBASE/ATL::CAtlServiceModuleT::IsInstalled", "ATLBASE/ATL::CAtlServiceModuleT::LogEvent", "ATLBASE/ATL::CAtlServiceModuleT::OnContinue", "ATLBASE/ATL::CAtlServiceModuleT::OnInterrogate", "ATLBASE/ATL::CAtlServiceModuleT::OnPause", "ATLBASE/ATL::CAtlServiceModuleT::OnShutdown", "ATLBASE/ATL::CAtlServiceModuleT::OnStop", "ATLBASE/ATL::CAtlServiceModuleT::OnUnknownRequest", "ATLBASE/ATL::CAtlServiceModuleT::ParseCommandLine", "ATLBASE/ATL::CAtlServiceModuleT::PreMessageLoop", "ATLBASE/ATL::CAtlServiceModuleT::RegisterAppId", "ATLBASE/ATL::CAtlServiceModuleT::Run", "ATLBASE/ATL::CAtlServiceModuleT::ServiceMain", "ATLBASE/ATL::CAtlServiceModuleT::SetServiceStatus", "ATLBASE/ATL::CAtlServiceModuleT::Start", "ATLBASE/ATL::CAtlServiceModuleT::Uninstall", "ATLBASE/ATL::CAtlServiceModuleT::Unlock", "ATLBASE/ATL::CAtlServiceModuleT::UnregisterAppId", "ATLBASE/ATL::CAtlServiceModuleT::WinMain", "ATLBASE/ATL::CAtlServiceModuleT::m_bService", "ATLBASE/ATL::CAtlServiceModuleT::m_dwThreadID", "ATLBASE/ATL::CAtlServiceModuleT::m_hServiceStatus", "ATLBASE/ATL::CAtlServiceModuleT::m_status", "ATLBASE/ATL::CAtlServiceModuleT::m_szServiceName"] helpviewer_keywords: ["CAtlServiceModuleT class"] -ms.assetid: 8fc753ce-4a50-402b-9b4a-0a4ce5dd496c --- # CAtlServiceModuleT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements a service. > [!IMPORTANT] diff --git a/docs/atl/reference/catltemporaryfile-class.md b/docs/atl/reference/catltemporaryfile-class.md index 9878d4a0d93..597aaba7e09 100644 --- a/docs/atl/reference/catltemporaryfile-class.md +++ b/docs/atl/reference/catltemporaryfile-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CAtlTemporaryFile class"] --- # CAtlTemporaryFile Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for the creation and use of a temporary file. > [!IMPORTANT] diff --git a/docs/atl/reference/catltransactionmanager-class.md b/docs/atl/reference/catltransactionmanager-class.md index 4c4430bf45b..4eec9cfe549 100644 --- a/docs/atl/reference/catltransactionmanager-class.md +++ b/docs/atl/reference/catltransactionmanager-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CAtlTransactionManager class"] --- # CAtlTransactionManager Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + CAtlTransactionManager class provides a wrapper to Kernel Transaction Manager (KTM) functions. > [!IMPORTANT] diff --git a/docs/atl/reference/catlwinmodule-class.md b/docs/atl/reference/catlwinmodule-class.md index fe46bab7a8f..dfd3f356a9a 100644 --- a/docs/atl/reference/catlwinmodule-class.md +++ b/docs/atl/reference/catlwinmodule-class.md @@ -4,10 +4,11 @@ title: "CAtlWinModule Class" ms.date: "11/04/2016" f1_keywords: ["CAtlWinModule", "ATLBASE/ATL::CAtlWinModule", "ATLBASE/ATL::CAtlWinModule::CAtlWinModule", "ATLBASE/ATL::CAtlWinModule::AddCreateWndData", "ATLBASE/ATL::CAtlWinModule::ExtractCreateWndData"] helpviewer_keywords: ["CAtlWinModule class"] -ms.assetid: 7ec844af-0f68-4a34-b0c8-9de50a025df0 --- # CAtlWinModule Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides support for ATL windowing components. > [!IMPORTANT] diff --git a/docs/atl/reference/cautoptr-class.md b/docs/atl/reference/cautoptr-class.md index ec51839b4b2..69c6edfac9f 100644 --- a/docs/atl/reference/cautoptr-class.md +++ b/docs/atl/reference/cautoptr-class.md @@ -4,10 +4,11 @@ title: "CAutoPtr class" ms.date: "11/04/2016" f1_keywords: ["CAutoPtr", "ATLBASE/ATL::CAutoPtr", "ATLBASE/ATL::CAutoPtr::CAutoPtr", "ATLBASE/ATL::CAutoPtr::Attach", "ATLBASE/ATL::CAutoPtr::Detach", "ATLBASE/ATL::CAutoPtr::Free", "ATLBASE/ATL::CAutoPtr::m_p"] helpviewer_keywords: ["CAutoPtr class"] -ms.assetid: 08988d53-4fb0-4711-bdfc-8ac29c63f410 --- # `CAutoPtr` class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a smart pointer object. > [!IMPORTANT] diff --git a/docs/atl/reference/cautoptrarray-class.md b/docs/atl/reference/cautoptrarray-class.md index cadb53e14a1..ab3616b4920 100644 --- a/docs/atl/reference/cautoptrarray-class.md +++ b/docs/atl/reference/cautoptrarray-class.md @@ -4,10 +4,11 @@ title: "CAutoPtrArray Class" ms.date: "11/04/2016" f1_keywords: ["CAutoPtrArray", "ATLCOLL/ATL::CAutoPtrArray", "ATLCOLL/ATL::CAutoPtrArray::CAutoPtrArray"] helpviewer_keywords: ["CAutoPtrArray class"] -ms.assetid: 880a70da-8c81-4427-8ac6-49aa8d424244 --- # CAutoPtrArray Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods useful when constructing an array of smart pointers. > [!IMPORTANT] diff --git a/docs/atl/reference/cautoptrelementtraits-class.md b/docs/atl/reference/cautoptrelementtraits-class.md index 90b8dbbea8c..5d2f5125152 100644 --- a/docs/atl/reference/cautoptrelementtraits-class.md +++ b/docs/atl/reference/cautoptrelementtraits-class.md @@ -4,10 +4,11 @@ title: "CAutoPtrElementTraits Class" ms.date: "11/04/2016" f1_keywords: ["CAutoPtrElementTraits", "ATLCOLL/ATL::CAutoPtrElementTraits", "ATLCOLL/ATL::CAutoPtrElementTraits::INARGTYPE", "ATLCOLL/ATL::CAutoPtrElementTraits::OUTARGTYPE"] helpviewer_keywords: ["CAutoPtrElementTraits class"] -ms.assetid: 777c1b14-6ab7-491f-b9a5-be149e71d4a2 --- # CAutoPtrElementTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods, static functions, and typedefs useful when creating collections of smart pointers. > [!IMPORTANT] diff --git a/docs/atl/reference/cautoptrlist-class.md b/docs/atl/reference/cautoptrlist-class.md index c2b8e2a7d2a..9f1ae599de9 100644 --- a/docs/atl/reference/cautoptrlist-class.md +++ b/docs/atl/reference/cautoptrlist-class.md @@ -4,10 +4,11 @@ title: "CAutoPtrList Class" ms.date: "11/04/2016" f1_keywords: ["CAutoPtrList", "ATLCOLL/ATL::CAutoPtrList", "ATLCOLL/ATL::CAutoPtrList::CAutoPtrList"] helpviewer_keywords: ["CAutoPtrList class"] -ms.assetid: 11de4aca-28b0-4ff2-a74a-cb602312ffbd --- # CAutoPtrList Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods useful when constructing a list of smart pointers. > [!IMPORTANT] diff --git a/docs/atl/reference/cautorevertimpersonation-class.md b/docs/atl/reference/cautorevertimpersonation-class.md index 6f63d124513..0999a258299 100644 --- a/docs/atl/reference/cautorevertimpersonation-class.md +++ b/docs/atl/reference/cautorevertimpersonation-class.md @@ -4,10 +4,11 @@ title: "CAutoRevertImpersonation Class" ms.date: "11/04/2016" f1_keywords: ["CAutoRevertImpersonation", "ATLSECURITY/ATL::CAutoRevertImpersonation", "ATLSECURITY/ATL::CAutoRevertImpersonation::CAutoRevertImpersonation", "ATLSECURITY/ATL::CAutoRevertImpersonation::Attach", "ATLSECURITY/ATL::CAutoRevertImpersonation::Detach", "ATLSECURITY/ATL::CAutoRevertImpersonation::GetAccessToken"] helpviewer_keywords: ["CAutoRevertImpersonation class"] -ms.assetid: 43732849-1940-4bd4-9d52-7a5698bb8838 --- # CAutoRevertImpersonation Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class reverts [CAccessToken](../../atl/reference/caccesstoken-class.md) objects to a nonimpersonating state when it goes out of scope. ## Syntax diff --git a/docs/atl/reference/cautovectorptr-class.md b/docs/atl/reference/cautovectorptr-class.md index be4c474bcce..e53ebac6abb 100644 --- a/docs/atl/reference/cautovectorptr-class.md +++ b/docs/atl/reference/cautovectorptr-class.md @@ -4,10 +4,11 @@ title: "CAutoVectorPtr Class" ms.date: "11/04/2016" f1_keywords: ["CAutoVectorPtr", "ATLBASE/ATL::CAutoVectorPtr", "ATLBASE/ATL::CAutoVectorPtr::CAutoVectorPtr", "ATLBASE/ATL::CAutoVectorPtr::Allocate", "ATLBASE/ATL::CAutoVectorPtr::Attach", "ATLBASE/ATL::CAutoVectorPtr::Detach", "ATLBASE/ATL::CAutoVectorPtr::Free", "ATLBASE/ATL::CAutoVectorPtr::m_p"] helpviewer_keywords: ["CAutoVectorPtr class"] -ms.assetid: 0030362b-6bc4-4a47-9b5b-3c3899dceab4 --- # CAutoVectorPtr Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a smart pointer object using vector new and delete operators. > [!IMPORTANT] diff --git a/docs/atl/reference/cautovectorptrelementtraits-class.md b/docs/atl/reference/cautovectorptrelementtraits-class.md index 86e766db0b2..7a18d053716 100644 --- a/docs/atl/reference/cautovectorptrelementtraits-class.md +++ b/docs/atl/reference/cautovectorptrelementtraits-class.md @@ -4,10 +4,11 @@ title: "CAutoVectorPtrElementTraits Class" ms.date: "11/04/2016" f1_keywords: ["CAutoVectorPtrElementTraits", "ATLCOLL/ATL::CAutoVectorPtrElementTraits", "ATLCOLL/ATL::CAutoVectorPtrElementTraits::INARGTYPE", "ATLCOLL/ATL::CAutoVectorPtrElementTraits::OUTARGTYPE"] helpviewer_keywords: ["CAutoVectorPtrElementTraits class"] -ms.assetid: 16b81a56-55fb-46ca-b376-66a1884231a6 --- # CAutoVectorPtrElementTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods, static functions, and typedefs useful when creating collections of smart pointers using vector new and delete operators. > [!IMPORTANT] diff --git a/docs/atl/reference/caxdialogimpl-class.md b/docs/atl/reference/caxdialogimpl-class.md index 76937ed12b0..8e536aadf64 100644 --- a/docs/atl/reference/caxdialogimpl-class.md +++ b/docs/atl/reference/caxdialogimpl-class.md @@ -4,10 +4,11 @@ title: "CAxDialogImpl Class" ms.date: "11/04/2016" f1_keywords: ["CAxDialogImpl", "ATLWIN/ATL::CAxDialogImpl", "ATLWIN/ATL::CAxDialogImpl::AdviseSinkMap", "ATLWIN/ATL::CAxDialogImpl::Create", "ATLWIN/ATL::CAxDialogImpl::DestroyWindow", "ATLWIN/ATL::CAxDialogImpl::DoModal", "ATLWIN/ATL::CAxDialogImpl::EndDialog", "ATLWIN/ATL::CAxDialogImpl::GetDialogProc", "ATLWIN/ATL::CAxDialogImpl::GetIDD", "ATLWIN/ATL::CAxDialogImpl::IsDialogMessage", "ATLWIN/ATL::CAxDialogImpl::m_bModal"] helpviewer_keywords: ["CAxDialogImpl class", "ATL, dialog boxes"] -ms.assetid: 817df483-3fa8-44e7-8487-72ba0881cd27 --- # CAxDialogImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements a dialog box (modal or modeless) that hosts ActiveX controls. > [!IMPORTANT] diff --git a/docs/atl/reference/caxwindow-class.md b/docs/atl/reference/caxwindow-class.md index 1817a66fc3c..6a8268eb678 100644 --- a/docs/atl/reference/caxwindow-class.md +++ b/docs/atl/reference/caxwindow-class.md @@ -4,7 +4,6 @@ title: "CAxWindow Class" ms.date: "11/04/2016" f1_keywords: ["CAxWindow", "ATLWIN/ATL::CAxWindow", "ATLWIN/ATL::AttachControl", "ATLWIN/ATL::CreateControl", "ATLWIN/ATL::CreateControlEx", "ATLWIN/ATL::GetWndClassName", "ATLWIN/ATL::QueryControl", "ATLWIN/ATL::QueryHost", "ATLWIN/ATL::SetExternalDispatch", "ATLWIN/ATL::SetExternalUIHandler"] helpviewer_keywords: ["CAxWindow class", "ATL, hosting ActiveX controls"] -ms.assetid: 85e79261-43e4-4770-bde0-1ff87f222b0f api_type: - DllExport api_location: @@ -14,6 +13,8 @@ api_name: --- # CAxWindow Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for manipulating a window hosting an ActiveX control. > [!IMPORTANT] diff --git a/docs/atl/reference/caxwindow2t-class.md b/docs/atl/reference/caxwindow2t-class.md index 866f52ad95f..b8ed27afc15 100644 --- a/docs/atl/reference/caxwindow2t-class.md +++ b/docs/atl/reference/caxwindow2t-class.md @@ -4,10 +4,11 @@ title: "CAxWindow2T Class" ms.date: "11/04/2016" f1_keywords: ["CAxWindow2T", "ATLWIN/ATL::CAxWindow2T", "ATLWIN/ATL::CAxWindow2T::CAxWindow2T", "ATLWIN/ATL::CAxWindow2T::Create", "ATLWIN/ATL::CAxWindow2T::CreateControlLic", "ATLWIN/ATL::CAxWindow2T::CreateControlLicEx", "ATLWIN/ATL::CAxWindow2T::GetWndClassName"] helpviewer_keywords: ["CAxWindow2 class"] -ms.assetid: b87bc943-7991-4537-b902-2138d7f4d837 --- # CAxWindow2T Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for manipulating a window that hosts an ActiveX control, and also has support for hosting licensed ActiveX controls. > [!IMPORTANT] diff --git a/docs/atl/reference/cbindstatuscallback-class.md b/docs/atl/reference/cbindstatuscallback-class.md index 1de6349c0cc..795c96c8517 100644 --- a/docs/atl/reference/cbindstatuscallback-class.md +++ b/docs/atl/reference/cbindstatuscallback-class.md @@ -4,10 +4,11 @@ title: "CBindStatusCallback Class" ms.date: "11/04/2016" f1_keywords: ["CBindStatusCallback", "ATLCTL/ATL::CBindStatusCallback", "ATLCTL/ATL::CBindStatusCallback::CBindStatusCallback", "ATLCTL/ATL::CBindStatusCallback::Download", "ATLCTL/ATL::CBindStatusCallback::GetBindInfo", "ATLCTL/ATL::CBindStatusCallback::GetPriority", "ATLCTL/ATL::CBindStatusCallback::OnDataAvailable", "ATLCTL/ATL::CBindStatusCallback::OnLowResource", "ATLCTL/ATL::CBindStatusCallback::OnObjectAvailable", "ATLCTL/ATL::CBindStatusCallback::OnProgress", "ATLCTL/ATL::CBindStatusCallback::OnStartBinding", "ATLCTL/ATL::CBindStatusCallback::OnStopBinding", "ATLCTL/ATL::CBindStatusCallback::StartAsyncDownload", "ATLCTL/ATL::CBindStatusCallback::m_dwAvailableToRead", "ATLCTL/ATL::CBindStatusCallback::m_dwTotalRead", "ATLCTL/ATL::CBindStatusCallback::m_pFunc", "ATLCTL/ATL::CBindStatusCallback::m_pT", "ATLCTL/ATL::CBindStatusCallback::m_spBindCtx", "ATLCTL/ATL::CBindStatusCallback::m_spBinding", "ATLCTL/ATL::CBindStatusCallback::m_spMoniker", "ATLCTL/ATL::CBindStatusCallback::m_spStream"] helpviewer_keywords: ["asynchronous data transfer [C++]", "data transfer [C++]", "data transfer [C++], asynchronous", "CBindStatusCallback class"] -ms.assetid: 0f5da276-6031-4418-b2a9-a4750ef29e77 --- # CBindStatusCallback Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements the `IBindStatusCallback` interface. > [!IMPORTANT] diff --git a/docs/atl/reference/ccomaggobject-class.md b/docs/atl/reference/ccomaggobject-class.md index b6eefe72330..f3401c8642f 100644 --- a/docs/atl/reference/ccomaggobject-class.md +++ b/docs/atl/reference/ccomaggobject-class.md @@ -4,10 +4,11 @@ title: "CComAggObject Class" ms.date: "11/04/2016" f1_keywords: ["CComAggObject", "ATLCOM/ATL::CComAggObject", "ATLCOM/ATL::CComAggObject::CComAggObject", "ATLCOM/ATL::CComAggObject::AddRef", "ATLCOM/ATL::CComAggObject::CreateInstance", "ATLCOM/ATL::CComAggObject::FinalConstruct", "ATLCOM/ATL::CComAggObject::FinalRelease", "ATLCOM/ATL::CComAggObject::QueryInterface", "ATLCOM/ATL::CComAggObject::Release", "ATLCOM/ATL::CComAggObject::m_contained"] helpviewer_keywords: ["aggregate objects [C++], in ATL", "aggregation [C++], ATL objects", "CComAggObject class"] -ms.assetid: 7aa90d69-d399-477b-880d-e2cdf0ef7881 --- # CComAggObject Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements the [IUnknown](/windows/win32/api/unknwn/nn-unknwn-iunknown) interface for an aggregated object. By definition, an aggregated object is contained within an outer object. The `CComAggObject` class is similar to the [CComObject Class](../../atl/reference/ccomobject-class.md), except that it exposes an interface that is directly accessible to external clients. ## Syntax diff --git a/docs/atl/reference/ccomallocator-class.md b/docs/atl/reference/ccomallocator-class.md index c29ebdbe019..83af39f1631 100644 --- a/docs/atl/reference/ccomallocator-class.md +++ b/docs/atl/reference/ccomallocator-class.md @@ -4,10 +4,11 @@ title: "CComAllocator Class" ms.date: "11/04/2016" f1_keywords: ["CComAllocator", "ATLBASE/ATL::CComAllocator", "ATLBASE/ATL::CComAllocator::Allocate", "ATLBASE/ATL::CComAllocator::Free", "ATLBASE/ATL::CComAllocator::Reallocate"] helpviewer_keywords: ["CComAllocator class"] -ms.assetid: 0cd706fd-0c7b-42d3-9054-febe2966fc8e --- # CComAllocator Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for managing memory using COM memory routines. ## Syntax diff --git a/docs/atl/reference/ccomapartment-class.md b/docs/atl/reference/ccomapartment-class.md index b49417cff84..f1b11e286b0 100644 --- a/docs/atl/reference/ccomapartment-class.md +++ b/docs/atl/reference/ccomapartment-class.md @@ -4,10 +4,11 @@ title: "CComApartment Class" ms.date: "11/04/2016" f1_keywords: ["CComApartment", "ATLBASE/ATL::CComApartment", "ATLBASE/ATL::CComApartment::CComApartment", "ATLBASE/ATL::CComApartment::Apartment", "ATLBASE/ATL::CComApartment::GetLockCount", "ATLBASE/ATL::CComApartment::Lock", "ATLBASE/ATL::CComApartment::Unlock", "ATLBASE/ATL::CComApartment::m_dwThreadID", "ATLBASE/ATL::CComApartment::m_hThread", "ATLBASE/ATL::CComApartment::m_nLockCnt"] helpviewer_keywords: ["apartments in ATL EXE modules", "CComApartment class"] -ms.assetid: dbc177d7-7ee4-45f2-b563-d578a467ca93 --- # CComApartment Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides support for managing an apartment in a thread-pooled EXE module. > [!IMPORTANT] diff --git a/docs/atl/reference/ccomautocriticalsection-class.md b/docs/atl/reference/ccomautocriticalsection-class.md index 1307f3e999d..a2f558a71ac 100644 --- a/docs/atl/reference/ccomautocriticalsection-class.md +++ b/docs/atl/reference/ccomautocriticalsection-class.md @@ -4,10 +4,11 @@ title: "CComAutoCriticalSection Class" ms.date: "11/04/2016" f1_keywords: ["CComAutoCriticalSection", "ATLCORE/ATL::CComAutoCriticalSection", "ATLCORE/ATL::CComAutoCriticalSection::CComAutoCriticalSection"] helpviewer_keywords: ["CComAutoCriticalSection class"] -ms.assetid: 491a9d90-3398-4f90-88f5-fd2172a46b30 --- # CComAutoCriticalSection Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + `CComAutoCriticalSection` provides methods for obtaining and releasing ownership of a critical section object. ## Syntax diff --git a/docs/atl/reference/ccomautodeletecriticalsection-class.md b/docs/atl/reference/ccomautodeletecriticalsection-class.md index b7ab596a45f..61c39b5626b 100644 --- a/docs/atl/reference/ccomautodeletecriticalsection-class.md +++ b/docs/atl/reference/ccomautodeletecriticalsection-class.md @@ -4,10 +4,11 @@ title: "CComAutoDeleteCriticalSection Class" ms.date: "11/04/2016" f1_keywords: ["CComAutoDeleteCriticalSection", "atlcore/ATL::CComAutoDeleteCriticalSection"] helpviewer_keywords: ["CComAutoDeleteCriticalSection class"] -ms.assetid: 2396dbea-1c60-4841-b50e-c4e18af311a3 --- # CComAutoDeleteCriticalSection Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for obtaining and releasing ownership of a critical section object. ## Syntax From 4717f4da6e09553e8d536e51764828bdca90d849 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 25 Feb 2026 15:03:40 -0800 Subject: [PATCH 1663/1799] ATL batch 3: docs updates (files 195-294) --- docs/atl/reference/ccomautothreadmodule-class.md | 3 ++- docs/atl/reference/ccombstr-class.md | 3 ++- docs/atl/reference/ccomcachedtearoffobject-class.md | 3 ++- docs/atl/reference/ccomclassfactory-class.md | 3 ++- docs/atl/reference/ccomclassfactory2-class.md | 3 ++- docs/atl/reference/ccomclassfactoryautothread-class.md | 3 ++- docs/atl/reference/ccomclassfactorysingleton-class.md | 3 ++- docs/atl/reference/ccomcoclass-class.md | 2 ++ docs/atl/reference/ccomcompositecontrol-class.md | 3 ++- docs/atl/reference/ccomcontainedobject-class.md | 3 ++- docs/atl/reference/ccomcontrol-class.md | 3 ++- docs/atl/reference/ccomcontrolbase-class.md | 3 ++- docs/atl/reference/ccomcriticalsection-class.md | 3 ++- docs/atl/reference/ccomcritseclock-class.md | 3 ++- docs/atl/reference/ccomcurrency-class.md | 2 ++ docs/atl/reference/ccomdynamicunkarray-class.md | 2 ++ docs/atl/reference/ccomenum-class.md | 3 ++- docs/atl/reference/ccomenumimpl-class.md | 3 ++- docs/atl/reference/ccomenumonstl-class.md | 3 ++- docs/atl/reference/ccomfakecriticalsection-class.md | 3 ++- docs/atl/reference/ccomgitptr-class.md | 3 ++- docs/atl/reference/ccomheap-class.md | 3 ++- docs/atl/reference/ccomheapptr-class.md | 3 ++- docs/atl/reference/ccommodule-class.md | 3 ++- docs/atl/reference/ccommultithreadmodel-class.md | 2 ++ docs/atl/reference/ccommultithreadmodelnocs-class.md | 3 ++- docs/atl/reference/ccomobject-class.md | 3 ++- docs/atl/reference/ccomobjectglobal-class.md | 3 ++- docs/atl/reference/ccomobjectnolock-class.md | 3 ++- docs/atl/reference/ccomobjectroot-class.md | 3 ++- docs/atl/reference/ccomobjectrootex-class.md | 3 ++- docs/atl/reference/ccomobjectstack-class.md | 3 ++- docs/atl/reference/ccompolyobject-class.md | 3 ++- docs/atl/reference/ccomptr-class.md | 3 ++- docs/atl/reference/ccomptrbase-class.md | 3 ++- docs/atl/reference/ccomqiptr-class.md | 3 ++- docs/atl/reference/ccomqiptrelementtraits-class.md | 3 ++- docs/atl/reference/ccomsafearray-class.md | 2 ++ docs/atl/reference/ccomsafearraybound-class.md | 3 ++- docs/atl/reference/ccomsafedeletecriticalsection-class.md | 3 ++- docs/atl/reference/ccomsimplethreadallocator-class.md | 3 ++- docs/atl/reference/ccomsinglethreadmodel-class.md | 3 ++- docs/atl/reference/ccomtearoffobject-class.md | 3 ++- docs/atl/reference/ccomunkarray-class.md | 3 ++- docs/atl/reference/ccomvariant-class.md | 2 ++ docs/atl/reference/ccontainedwindowt-class.md | 3 ++- docs/atl/reference/ccrtallocator-class.md | 3 ++- docs/atl/reference/ccrtheap-class.md | 3 ++- docs/atl/reference/cdacl-class.md | 3 ++- docs/atl/reference/cdebugreporthook-class.md | 3 ++- docs/atl/reference/cdefaultchartraits-class.md | 3 ++- docs/atl/reference/cdefaultcomparetraits-class.md | 3 ++- docs/atl/reference/cdefaultelementtraits-class.md | 3 ++- docs/atl/reference/cdefaulthashtraits-class.md | 3 ++- docs/atl/reference/cdialogimpl-class.md | 3 ++- docs/atl/reference/cdynamicchain-class.md | 3 ++- docs/atl/reference/celementtraits-class.md | 3 ++- docs/atl/reference/celementtraitsbase-class.md | 3 ++- docs/atl/reference/cfirepropnotifyevent-class.md | 3 ++- docs/atl/reference/cglobalheap-class.md | 3 ++- docs/atl/reference/chandle-class.md | 3 ++- docs/atl/reference/cheapptr-class.md | 3 ++- docs/atl/reference/cheapptrbase-class.md | 3 ++- docs/atl/reference/cheapptrelementtraits-class.md | 3 ++- docs/atl/reference/cheapptrlist-class.md | 3 ++- docs/atl/reference/cinterfacearray-class.md | 3 ++- docs/atl/reference/cinterfacelist-class.md | 3 ++- docs/atl/reference/clocalheap-class.md | 3 ++- docs/atl/reference/cmessagemap-class.md | 3 ++- docs/atl/reference/cnonstatelessworker-class.md | 3 ++- docs/atl/reference/cnoworkerthread-class.md | 3 ++- docs/atl/reference/com-interface-entry-macros.md | 3 ++- docs/atl/reference/com-map-global-functions.md | 3 ++- docs/atl/reference/com-map-macros.md | 3 ++- .../com-plus-1-0-atl-com-plus-1-0-component-wizard.md | 3 ++- docs/atl/reference/com-plus-1-0-support-in-atl-projects.md | 3 ++- docs/atl/reference/compiler-options-macros.md | 2 ++ docs/atl/reference/composite-control-global-functions.md | 3 ++- docs/atl/reference/composite-control-macros.md | 3 ++- docs/atl/reference/connection-point-global-functions.md | 3 ++- docs/atl/reference/connection-point-macros.md | 3 ++- docs/atl/reference/cpatht-class.md | 3 ++- docs/atl/reference/cprimitiveelementtraits-class.md | 3 ++- docs/atl/reference/cprivateobjectsecuritydesc-class.md | 3 ++- docs/atl/reference/crbmap-class.md | 3 ++- docs/atl/reference/crbmultimap-class.md | 3 ++- docs/atl/reference/crbtree-class.md | 3 ++- docs/atl/reference/creating-an-atl-project.md | 3 ++- docs/atl/reference/cregkey-class.md | 2 ++ docs/atl/reference/crtthreadtraits-class.md | 3 ++- docs/atl/reference/csacl-class.md | 3 ++- docs/atl/reference/csecurityattributes-class.md | 3 ++- docs/atl/reference/csecuritydesc-class.md | 3 ++- docs/atl/reference/csid-class.md | 3 ++- docs/atl/reference/csimplearray-class.md | 3 ++- docs/atl/reference/csimplearrayequalhelper-class.md | 3 ++- docs/atl/reference/csimplearrayequalhelperfalse-class.md | 3 ++- docs/atl/reference/csimpledialog-class.md | 3 ++- docs/atl/reference/csimplemap-class.md | 3 ++- docs/atl/reference/csimplemapequalhelper-class.md | 3 ++- 100 files changed, 200 insertions(+), 92 deletions(-) diff --git a/docs/atl/reference/ccomautothreadmodule-class.md b/docs/atl/reference/ccomautothreadmodule-class.md index 4cff4d76b9d..2c6e947a2fe 100644 --- a/docs/atl/reference/ccomautothreadmodule-class.md +++ b/docs/atl/reference/ccomautothreadmodule-class.md @@ -4,10 +4,11 @@ title: "CComAutoThreadModule Class" ms.date: "11/04/2016" f1_keywords: ["CComAutoThreadModule", "ATLBASE/ATL::CComAutoThreadModule", "ATLBASE/ATL::CreateInstance", "ATLBASE/ATL::GetDefaultThreads", "ATLBASE/ATL::Init", "ATLBASE/ATL::Lock", "ATLBASE/ATL::Unlock", "ATLBASE/ATL::dwThreadID", "ATLBASE/ATL::m_Allocator", "ATLBASE/ATL::m_nThreads", "ATLBASE/ATL::m_pApartments"] helpviewer_keywords: ["CComAutoThreadModule class", "apartment model modules"] -ms.assetid: 13063ea5-a57e-4aac-97d3-227137262811 --- # CComAutoThreadModule Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + As of ATL 7.0, `CComAutoThreadModule` is obsolete: see [ATL Module Classes](../../atl/atl-module-classes.md) for more details. > [!IMPORTANT] diff --git a/docs/atl/reference/ccombstr-class.md b/docs/atl/reference/ccombstr-class.md index 14c7a7e8d83..7062d1d7d9c 100644 --- a/docs/atl/reference/ccombstr-class.md +++ b/docs/atl/reference/ccombstr-class.md @@ -4,10 +4,11 @@ title: "CComBSTR Class" ms.date: "11/04/2016" f1_keywords: ["CComBSTR", "ATLBASE/ATL::CComBSTR", "ATLBASE/ATL::CComBSTR::CComBSTR", "ATLBASE/ATL::CComBSTR::Append", "ATLBASE/ATL::CComBSTR::AppendBSTR", "ATLBASE/ATL::CComBSTR::AppendBytes", "ATLBASE/ATL::CComBSTR::ArrayToBSTR", "ATLBASE/ATL::CComBSTR::AssignBSTR", "ATLBASE/ATL::CComBSTR::Attach", "ATLBASE/ATL::CComBSTR::BSTRToArray", "ATLBASE/ATL::CComBSTR::ByteLength", "ATLBASE/ATL::CComBSTR::Copy", "ATLBASE/ATL::CComBSTR::CopyTo", "ATLBASE/ATL::CComBSTR::Detach", "ATLBASE/ATL::CComBSTR::Empty", "ATLBASE/ATL::CComBSTR::Length", "ATLBASE/ATL::CComBSTR::LoadString", "ATLBASE/ATL::CComBSTR::ReadFromStream", "ATLBASE/ATL::CComBSTR::ToLower", "ATLBASE/ATL::CComBSTR::ToUpper", "ATLBASE/ATL::CComBSTR::WriteToStream", "ATLBASE/ATL::CComBSTR::m_str"] helpviewer_keywords: ["BSTRs, wrapper", "CComBSTR class", "CComBSTR"] -ms.assetid: 8fea1879-a05e-47a5-a803-8dec60eaa534 --- # `CComBSTR` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for [`BSTR`](/previous-versions/windows/desktop/automat/bstr)s. ## Syntax diff --git a/docs/atl/reference/ccomcachedtearoffobject-class.md b/docs/atl/reference/ccomcachedtearoffobject-class.md index 26e8f9526df..bfeda509925 100644 --- a/docs/atl/reference/ccomcachedtearoffobject-class.md +++ b/docs/atl/reference/ccomcachedtearoffobject-class.md @@ -4,10 +4,11 @@ title: "CComCachedTearOffObject Class" ms.date: "11/04/2016" f1_keywords: ["CComCachedTearOffObject", "ATLCOM/ATL::CComCachedTearOffObject", "ATLCOM/ATL::CComCachedTearOffObject::CComCachedTearOffObject", "ATLCOM/ATL::CComCachedTearOffObject::AddRef", "ATLCOM/ATL::CComCachedTearOffObject::FinalConstruct", "ATLCOM/ATL::CComCachedTearOffObject::FinalRelease", "ATLCOM/ATL::CComCachedTearOffObject::QueryInterface", "ATLCOM/ATL::CComCachedTearOffObject::Release", "ATLCOM/ATL::CComCachedTearOffObject::m_contained"] helpviewer_keywords: ["cache, ATL cached tear-off objects", "CComCachedTearOffObject class"] -ms.assetid: ae19507d-a1de-4dbc-a988-da9f75a50c95 --- # CComCachedTearOffObject Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements [IUnknown](/windows/win32/api/unknwn/nn-unknwn-iunknown) for a tear-off interface. ## Syntax diff --git a/docs/atl/reference/ccomclassfactory-class.md b/docs/atl/reference/ccomclassfactory-class.md index 02636d54b19..8ffc9ddddb9 100644 --- a/docs/atl/reference/ccomclassfactory-class.md +++ b/docs/atl/reference/ccomclassfactory-class.md @@ -4,10 +4,11 @@ title: "CComClassFactory Class" ms.date: "11/04/2016" f1_keywords: ["CComClassFactory", "ATLCOM/ATL::CComClassFactory", "ATLCOM/ATL::CComClassFactory::CreateInstance", "ATLCOM/ATL::CComClassFactory::LockServer"] helpviewer_keywords: ["CComClassFactory class"] -ms.assetid: e56dacf7-d5c4-4c42-aef4-a86d91981a1b --- # CComClassFactory Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements the [IClassFactory](/windows/win32/api/unknwnbase/nn-unknwnbase-iclassfactory) interface. ## Syntax diff --git a/docs/atl/reference/ccomclassfactory2-class.md b/docs/atl/reference/ccomclassfactory2-class.md index 6a40fbd71ed..b96614dc260 100644 --- a/docs/atl/reference/ccomclassfactory2-class.md +++ b/docs/atl/reference/ccomclassfactory2-class.md @@ -4,10 +4,11 @@ title: "CComClassFactory2 Class" ms.date: "11/04/2016" f1_keywords: ["CComClassFactory2", "ATLCOM/ATL::CComClassFactory2", "ATLCOM/ATL::CComClassFactory2::CreateInstance", "ATLCOM/ATL::CComClassFactory2::CreateInstanceLic", "ATLCOM/ATL::CComClassFactory2::GetLicInfo", "ATLCOM/ATL::CComClassFactory2::LockServer", "ATLCOM/ATL::CComClassFactory2::RequestLicKey"] helpviewer_keywords: ["CComClassFactory2 class"] -ms.assetid: 19b66fd6-b9ed-47a0-822c-8132184f5a3e --- # CComClassFactory2 Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements the [IClassFactory2](/windows/win32/api/ocidl/nn-ocidl-iclassfactory2) interface. ## Syntax diff --git a/docs/atl/reference/ccomclassfactoryautothread-class.md b/docs/atl/reference/ccomclassfactoryautothread-class.md index af076db252a..39c4c45f686 100644 --- a/docs/atl/reference/ccomclassfactoryautothread-class.md +++ b/docs/atl/reference/ccomclassfactoryautothread-class.md @@ -4,10 +4,11 @@ title: "CComClassFactoryAutoThread Class" ms.date: "11/04/2016" f1_keywords: ["CComClassFactoryAutoThread", "ATLCOM/ATL::CComClassFactoryAutoThread", "ATLCOM/ATL::CComClassFactoryAutoThread::CreateInstance", "ATLCOM/ATL::CComClassFactoryAutoThread::LockServer"] helpviewer_keywords: ["CComClassFactoryAutoThread class"] -ms.assetid: 22008042-533f-4dd9-bf7e-191ee571f9a1 --- # CComClassFactoryAutoThread Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements the [IClassFactory](/windows/win32/api/unknwnbase/nn-unknwnbase-iclassfactory) interface, and allows objects to be created in multiple apartments. > [!IMPORTANT] diff --git a/docs/atl/reference/ccomclassfactorysingleton-class.md b/docs/atl/reference/ccomclassfactorysingleton-class.md index 7559d27a594..a2eb6745545 100644 --- a/docs/atl/reference/ccomclassfactorysingleton-class.md +++ b/docs/atl/reference/ccomclassfactorysingleton-class.md @@ -4,10 +4,11 @@ title: "CComClassFactorySingleton Class" ms.date: "11/04/2016" f1_keywords: ["CComClassFactorySingleton", "ATLCOM/ATL::CComClassFactorySingleton", "ATLCOM/ATL::CComClassFactorySingleton::CreateInstance", "ATLCOM/ATL::CComClassFactorySingleton::m_spObj"] helpviewer_keywords: ["CComClassFactorySingleton class"] -ms.assetid: debb983c-382b-487b-8d42-7ea26dc158b8 --- # CComClassFactorySingleton Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class derives from [CComClassFactory](../../atl/reference/ccomclassfactory-class.md) and uses [CComObjectGlobal](../../atl/reference/ccomobjectglobal-class.md) to construct a single object. > [!IMPORTANT] diff --git a/docs/atl/reference/ccomcoclass-class.md b/docs/atl/reference/ccomcoclass-class.md index 2101a31f892..c9ccbbc5100 100644 --- a/docs/atl/reference/ccomcoclass-class.md +++ b/docs/atl/reference/ccomcoclass-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CComCoClass class", "aggregation [C++], aggregation model --- # CComCoClass Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for creating instances of a class, and obtaining its properties. ## Syntax diff --git a/docs/atl/reference/ccomcompositecontrol-class.md b/docs/atl/reference/ccomcompositecontrol-class.md index d2899ea4afc..09bdc9f10a2 100644 --- a/docs/atl/reference/ccomcompositecontrol-class.md +++ b/docs/atl/reference/ccomcompositecontrol-class.md @@ -4,10 +4,11 @@ title: "CComCompositeControl Class" ms.date: "11/04/2016" f1_keywords: ["CComCompositeControl", "ATLCTL/ATL::CComCompositeControl", "ATLCTL/ATL::CComCompositeControl::CComCompositeControl", "ATLCTL/ATL::CComCompositeControl::AdviseSinkMap", "ATLCTL/ATL::CComCompositeControl::CalcExtent", "ATLCTL/ATL::CComCompositeControl::Create", "ATLCTL/ATL::CComCompositeControl::CreateControlWindow", "ATLCTL/ATL::CComCompositeControl::SetBackgroundColorFromAmbient", "ATLCTL/ATL::CComCompositeControl::m_hbrBackground", "ATLCTL/ATL::CComCompositeControl::m_hWndFocus"] helpviewer_keywords: ["CComCompositeControl class", "composite controls, CComCompositeControl class"] -ms.assetid: 1304b931-27e8-4fbc-be8e-bb226ad887fb --- # CComCompositeControl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides the methods required to implement a composite control. > [!IMPORTANT] diff --git a/docs/atl/reference/ccomcontainedobject-class.md b/docs/atl/reference/ccomcontainedobject-class.md index 1f6f7008ce7..47a9a11db59 100644 --- a/docs/atl/reference/ccomcontainedobject-class.md +++ b/docs/atl/reference/ccomcontainedobject-class.md @@ -4,10 +4,11 @@ title: "CComContainedObject Class" ms.date: "11/04/2016" f1_keywords: ["CComContainedObject", "ATLCOM/ATL::CComContainedObject", "ATLCOM/ATL::CComContainedObject::CComContainedObject", "ATLCOM/ATL::CComContainedObject::AddRef", "ATLCOM/ATL::CComContainedObject::GetControllingUnknown", "ATLCOM/ATL::CComContainedObject::QueryInterface", "ATLCOM/ATL::CComContainedObject::Release"] helpviewer_keywords: ["aggregate objects [C++], in ATL", "aggregation [C++], ATL objects", "CComContainedObject class"] -ms.assetid: e8616b41-c200-47b8-bf2c-fb9f713ebdad --- # CComContainedObject Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements [IUnknown](/windows/win32/api/unknwn/nn-unknwn-iunknown) by delegating to the owner object's `IUnknown`. > [!IMPORTANT] diff --git a/docs/atl/reference/ccomcontrol-class.md b/docs/atl/reference/ccomcontrol-class.md index 4c3cba00c3e..ef8078200c8 100644 --- a/docs/atl/reference/ccomcontrol-class.md +++ b/docs/atl/reference/ccomcontrol-class.md @@ -4,10 +4,11 @@ title: "CComControl Class" ms.date: "11/04/2016" f1_keywords: ["CComControl", "ATLCTL/ATL::CComControl", "ATLCTL/ATL::CComControl::CComControl", "ATLCTL/ATL::CComControl::ControlQueryInterface", "ATLCTL/ATL::CComControl::CreateControlWindow", "ATLCTL/ATL::CComControl::FireOnChanged", "ATLCTL/ATL::CComControl::FireOnRequestEdit", "ATLCTL/ATL::CComControl::MessageBox"] helpviewer_keywords: ["control flags", "CComControlBase class, CComControl class", "stock properties, ATL", "CComControl class", "controls [ATL], control helper functions", "ambient properties", "controls [ATL], properties"] -ms.assetid: 55368c27-bd16-45a7-b701-edb36157c8e8 --- # CComControl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for creating and managing ATL controls. > [!IMPORTANT] diff --git a/docs/atl/reference/ccomcontrolbase-class.md b/docs/atl/reference/ccomcontrolbase-class.md index f65f6c90ee2..82c638b2f4b 100644 --- a/docs/atl/reference/ccomcontrolbase-class.md +++ b/docs/atl/reference/ccomcontrolbase-class.md @@ -4,10 +4,11 @@ title: "CComControlBase Class" ms.date: "11/04/2016" f1_keywords: ["CComControlBase", "ATLCTL/ATL::CComControlBase", "ATLCTL/ATL::CComControlBase::AppearanceType", "ATLCTL/ATL::CComControlBase::CComControlBase", "ATLCTL/ATL::CComControlBase::ControlQueryInterface", "ATLCTL/ATL::CComControlBase::DoesVerbActivate", "ATLCTL/ATL::CComControlBase::DoesVerbUIActivate", "ATLCTL/ATL::CComControlBase::DoVerbProperties", "ATLCTL/ATL::CComControlBase::FireViewChange", "ATLCTL/ATL::CComControlBase::GetAmbientAppearance", "ATLCTL/ATL::CComControlBase::GetAmbientAutoClip", "ATLCTL/ATL::CComControlBase::GetAmbientBackColor", "ATLCTL/ATL::CComControlBase::GetAmbientCharSet", "ATLCTL/ATL::CComControlBase::GetAmbientCodePage", "ATLCTL/ATL::CComControlBase::GetAmbientDisplayAsDefault", "ATLCTL/ATL::CComControlBase::GetAmbientDisplayName", "ATLCTL/ATL::CComControlBase::GetAmbientFont", "ATLCTL/ATL::CComControlBase::GetAmbientFontDisp", "ATLCTL/ATL::CComControlBase::GetAmbientForeColor", "ATLCTL/ATL::CComControlBase::GetAmbientLocaleID", "ATLCTL/ATL::CComControlBase::GetAmbientMessageReflect", "ATLCTL/ATL::CComControlBase::GetAmbientPalette", "ATLCTL/ATL::CComControlBase::GetAmbientProperty", "ATLCTL/ATL::CComControlBase::GetAmbientRightToLeft", "ATLCTL/ATL::CComControlBase::GetAmbientScaleUnits", "ATLCTL/ATL::CComControlBase::GetAmbientShowGrabHandles", "ATLCTL/ATL::CComControlBase::GetAmbientShowHatching", "ATLCTL/ATL::CComControlBase::GetAmbientSupportsMnemonics", "ATLCTL/ATL::CComControlBase::GetAmbientTextAlign", "ATLCTL/ATL::CComControlBase::GetAmbientTopToBottom", "ATLCTL/ATL::CComControlBase::GetAmbientUIDead", "ATLCTL/ATL::CComControlBase::GetAmbientUserMode", "ATLCTL/ATL::CComControlBase::GetDirty", "ATLCTL/ATL::CComControlBase::GetZoomInfo", "ATLCTL/ATL::CComControlBase::InPlaceActivate", "ATLCTL/ATL::CComControlBase::InternalGetSite", "ATLCTL/ATL::CComControlBase::OnDraw", "ATLCTL/ATL::CComControlBase::OnDrawAdvanced", "ATLCTL/ATL::CComControlBase::OnKillFocus", "ATLCTL/ATL::CComControlBase::OnMouseActivate", "ATLCTL/ATL::CComControlBase::OnPaint", "ATLCTL/ATL::CComControlBase::OnSetFocus", "ATLCTL/ATL::CComControlBase::PreTranslateAccelerator", "ATLCTL/ATL::CComControlBase::SendOnClose", "ATLCTL/ATL::CComControlBase::SendOnDataChange", "ATLCTL/ATL::CComControlBase::SendOnRename", "ATLCTL/ATL::CComControlBase::SendOnSave", "ATLCTL/ATL::CComControlBase::SendOnViewChange", "ATLCTL/ATL::CComControlBase::SetControlFocus", "ATLCTL/ATL::CComControlBase::SetDirty", "ATLCTL/ATL::CComControlBase::m_bAutoSize", "ATLCTL/ATL::CComControlBase::m_bDrawFromNatural", "ATLCTL/ATL::CComControlBase::m_bDrawGetDataInHimetric", "ATLCTL/ATL::CComControlBase::m_bInPlaceActive", "ATLCTL/ATL::CComControlBase::m_bInPlaceSiteEx", "ATLCTL/ATL::CComControlBase::m_bNegotiatedWnd", "ATLCTL/ATL::CComControlBase::m_bRecomposeOnResize", "ATLCTL/ATL::CComControlBase::m_bRequiresSave", "ATLCTL/ATL::CComControlBase::m_bResizeNatural", "ATLCTL/ATL::CComControlBase::m_bUIActive", "ATLCTL/ATL::CComControlBase::m_bUsingWindowRgn", "ATLCTL/ATL::CComControlBase::m_bWasOnceWindowless", "ATLCTL/ATL::CComControlBase::m_bWindowOnly", "ATLCTL/ATL::CComControlBase::m_bWndLess", "ATLCTL/ATL::CComControlBase::m_hWndCD", "ATLCTL/ATL::CComControlBase::m_nFreezeEvents", "ATLCTL/ATL::CComControlBase::m_rcPos", "ATLCTL/ATL::CComControlBase::m_sizeExtent", "ATLCTL/ATL::CComControlBase::m_sizeNatural", "ATLCTL/ATL::CComControlBase::m_spAdviseSink", "ATLCTL/ATL::CComControlBase::m_spAmbientDispatch", "ATLCTL/ATL::CComControlBase::m_spClientSite", "ATLCTL/ATL::CComControlBase::m_spDataAdviseHolder", "ATLCTL/ATL::CComControlBase::m_spInPlaceSite", "ATLCTL/ATL::CComControlBase::m_spOleAdviseHolder"] helpviewer_keywords: ["CComControlBase class"] -ms.assetid: 3d1bf022-acf2-4092-8283-ff8cee6332f3 --- # CComControlBase Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for creating and managing ATL controls. > [!IMPORTANT] diff --git a/docs/atl/reference/ccomcriticalsection-class.md b/docs/atl/reference/ccomcriticalsection-class.md index 7ee8d73ac54..dc63e60f1ee 100644 --- a/docs/atl/reference/ccomcriticalsection-class.md +++ b/docs/atl/reference/ccomcriticalsection-class.md @@ -4,10 +4,11 @@ title: "CComCriticalSection Class" ms.date: "11/04/2016" f1_keywords: ["CComCriticalSection", "ATLCORE/ATL::CComCriticalSection", "ATLCORE/ATL::CComCriticalSection::CComCriticalSection", "ATLCORE/ATL::CComCriticalSection::Init", "ATLCORE/ATL::CComCriticalSection::Lock", "ATLCORE/ATL::CComCriticalSection::Term", "ATLCORE/ATL::CComCriticalSection::Unlock", "ATLCORE/ATL::CComCriticalSection::m_sec"] helpviewer_keywords: ["CComCriticalSection class"] -ms.assetid: 44e1edd2-90be-4bfe-9739-58e8b419e7d1 --- # CComCriticalSection Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for obtaining and releasing ownership of a critical section object. ## Syntax diff --git a/docs/atl/reference/ccomcritseclock-class.md b/docs/atl/reference/ccomcritseclock-class.md index 726f3bc79c4..2b05e7b608c 100644 --- a/docs/atl/reference/ccomcritseclock-class.md +++ b/docs/atl/reference/ccomcritseclock-class.md @@ -4,10 +4,11 @@ title: "CComCritSecLock Class" ms.date: "11/04/2016" f1_keywords: ["CComCritSecLock", "ATLBASE/ATL::CComCritSecLock", "ATLBASE/ATL::CComCritSecLock::CComCritSecLock", "ATLBASE/ATL::CComCritSecLock::Lock", "ATLBASE/ATL::CComCritSecLock::Unlock"] helpviewer_keywords: ["CComCritSecLock class"] -ms.assetid: 223152a1-86c3-4ef9-89a7-f455fe791b0e --- # CComCritSecLock Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for locking and unlocking a critical section object. ## Syntax diff --git a/docs/atl/reference/ccomcurrency-class.md b/docs/atl/reference/ccomcurrency-class.md index cee7bfd016c..ba76d99a06d 100644 --- a/docs/atl/reference/ccomcurrency-class.md +++ b/docs/atl/reference/ccomcurrency-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CComCurrency class"] --- # `CComCurrency` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + `CComCurrency` has methods and operators for creating and managing a `CURRENCY` object. ## Syntax diff --git a/docs/atl/reference/ccomdynamicunkarray-class.md b/docs/atl/reference/ccomdynamicunkarray-class.md index 682edba8166..f81b285a499 100644 --- a/docs/atl/reference/ccomdynamicunkarray-class.md +++ b/docs/atl/reference/ccomdynamicunkarray-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["connection points [C++], managing", "CComDynamicUnkArray --- # CComDynamicUnkArray Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class stores an array of `IUnknown` pointers. ## Syntax diff --git a/docs/atl/reference/ccomenum-class.md b/docs/atl/reference/ccomenum-class.md index 874c02b84cf..d8c54423b54 100644 --- a/docs/atl/reference/ccomenum-class.md +++ b/docs/atl/reference/ccomenum-class.md @@ -4,10 +4,11 @@ title: "CComEnum Class" ms.date: "11/04/2016" f1_keywords: ["CComEnum", "atlcom/ATL::CComEnum"] helpviewer_keywords: ["CComEnum class"] -ms.assetid: bff7dd7b-eb6e-4d6e-96ed-2706e66c8b3b --- # CComEnum Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class defines a COM enumerator object based on an array. ## Syntax diff --git a/docs/atl/reference/ccomenumimpl-class.md b/docs/atl/reference/ccomenumimpl-class.md index 904acfd49b9..221edcb1d4a 100644 --- a/docs/atl/reference/ccomenumimpl-class.md +++ b/docs/atl/reference/ccomenumimpl-class.md @@ -4,10 +4,11 @@ title: "CComEnumImpl Class" ms.date: "11/04/2016" f1_keywords: ["CComEnumImpl", "ATLCOM/ATL::CComEnumImpl", "ATLCOM/ATL::CComEnumImpl::CComEnumImpl", "ATLCOM/ATL::CComEnumImpl::Clone", "ATLCOM/ATL::CComEnumImpl::Init", "ATLCOM/ATL::CComEnumImpl::Next", "ATLCOM/ATL::CComEnumImpl::Reset", "ATLCOM/ATL::CComEnumImpl::Skip", "ATLCOM/ATL::CComEnumImpl::m_begin", "ATLCOM/ATL::CComEnumImpl::m_dwFlags", "ATLCOM/ATL::CComEnumImpl::m_end", "ATLCOM/ATL::CComEnumImpl::m_iter", "ATLCOM/ATL::CComEnumImpl::m_spUnk"] helpviewer_keywords: ["CComEnumImpl class"] -ms.assetid: cc0d8e76-e608-46db-87cd-4c7161fe32d2 --- # CComEnumImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides the implementation for a COM enumerator interface where the items being enumerated are stored in an array. ## Syntax diff --git a/docs/atl/reference/ccomenumonstl-class.md b/docs/atl/reference/ccomenumonstl-class.md index 7ab682b5062..9d581e4f87c 100644 --- a/docs/atl/reference/ccomenumonstl-class.md +++ b/docs/atl/reference/ccomenumonstl-class.md @@ -4,10 +4,11 @@ title: "CComEnumOnSTL Class" ms.date: "11/04/2016" f1_keywords: ["CComEnumOnSTL", "atlcom/ATL::CComEnumOnSTL"] helpviewer_keywords: ["CComEnumOnSTL class"] -ms.assetid: befe1a44-7a00-4f28-9a2e-cc0fa526643c --- # CComEnumOnSTL Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class defines a COM enumerator object based on a C++ Standard Library collection. ## Syntax diff --git a/docs/atl/reference/ccomfakecriticalsection-class.md b/docs/atl/reference/ccomfakecriticalsection-class.md index 087bc175ffb..9d146470b88 100644 --- a/docs/atl/reference/ccomfakecriticalsection-class.md +++ b/docs/atl/reference/ccomfakecriticalsection-class.md @@ -4,10 +4,11 @@ title: "CComFakeCriticalSection Class" ms.date: "11/04/2016" f1_keywords: ["CComFakeCriticalSection", "ATLCORE/ATL::CComFakeCriticalSection", "ATLCORE/ATL::CComFakeCriticalSection::Init", "ATLCORE/ATL::CComFakeCriticalSection::Lock", "ATLCORE/ATL::CComFakeCriticalSection::Term", "ATLCORE/ATL::CComFakeCriticalSection::Unlock"] helpviewer_keywords: ["CComFakeCriticalSection class"] -ms.assetid: a4811b97-96bb-493b-ab9f-62822aeddb10 --- # CComFakeCriticalSection Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides the same methods as [CComCriticalSection](../../atl/reference/ccomcriticalsection-class.md) but does not provide a critical section. ## Syntax diff --git a/docs/atl/reference/ccomgitptr-class.md b/docs/atl/reference/ccomgitptr-class.md index 1cc42d0b166..e2478fd7faf 100644 --- a/docs/atl/reference/ccomgitptr-class.md +++ b/docs/atl/reference/ccomgitptr-class.md @@ -4,10 +4,11 @@ title: "CComGITPtr Class" ms.date: "11/04/2016" f1_keywords: ["CComGITPtr", "ATLBASE/ATL::CComGITPtr", "ATLBASE/ATL::CComGITPtr::CComGITPtr", "ATLBASE/ATL::CComGITPtr::Attach", "ATLBASE/ATL::CComGITPtr::CopyTo", "ATLBASE/ATL::CComGITPtr::Detach", "ATLBASE/ATL::CComGITPtr::GetCookie", "ATLBASE/ATL::CComGITPtr::Revoke", "ATLBASE/ATL::CComGITPtr::m_dwCookie"] helpviewer_keywords: ["CComGITPtr class"] -ms.assetid: af895acb-525a-4555-bb67-b241b7df515b --- # CComGITPtr Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for dealing with interface pointers and the global interface table (GIT). ## Syntax diff --git a/docs/atl/reference/ccomheap-class.md b/docs/atl/reference/ccomheap-class.md index f561ecf30de..f4446ee0ef4 100644 --- a/docs/atl/reference/ccomheap-class.md +++ b/docs/atl/reference/ccomheap-class.md @@ -4,10 +4,11 @@ title: "CComHeap Class" ms.date: "11/04/2016" f1_keywords: ["CComHeap", "ATLCOMMEM/ATL::CComHeap", "ATLCOMMEM/ATL::CComHeap::Allocate", "ATLCOMMEM/ATL::CComHeap::Free", "ATLCOMMEM/ATL::CComHeap::GetSize", "ATLCOMMEM/ATL::CComHeap::Reallocate"] helpviewer_keywords: ["CComHeap class"] -ms.assetid: c74183ce-98ae-46fb-b186-93ea4cf0222b --- # `CComHeap` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements [`IAtlMemMgr`](../../atl/reference/iatlmemmgr-class.md) using the COM memory allocation functions. > [!IMPORTANT] diff --git a/docs/atl/reference/ccomheapptr-class.md b/docs/atl/reference/ccomheapptr-class.md index 0edb83160e8..16767755ff6 100644 --- a/docs/atl/reference/ccomheapptr-class.md +++ b/docs/atl/reference/ccomheapptr-class.md @@ -4,10 +4,11 @@ title: "CComHeapPtr Class" ms.date: "11/04/2016" f1_keywords: ["CComHeapPtr", "ATLBASE/ATL::CComHeapPtr", "ATLBASE/ATL::CComHeapPtr::CComHeapPtr"] helpviewer_keywords: ["CComHeapPtr class"] -ms.assetid: bd08b53d-da2b-43ab-a79c-e7c8dbbc5994 --- # CComHeapPtr Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + A smart pointer class for managing heap pointers. ## Syntax diff --git a/docs/atl/reference/ccommodule-class.md b/docs/atl/reference/ccommodule-class.md index eb17faf3c4e..0d8c58b4f6f 100644 --- a/docs/atl/reference/ccommodule-class.md +++ b/docs/atl/reference/ccommodule-class.md @@ -4,10 +4,11 @@ title: "CComModule Class" ms.date: "08/19/2019" f1_keywords: ["CComModule", "ATLBASE/ATL::CComModule", "ATLBASE/ATL::CComModule::GetClassObject", "ATLBASE/ATL::CComModule::GetModuleInstance", "ATLBASE/ATL::CComModule::GetResourceInstance", "ATLBASE/ATL::CComModule::GetTypeLibInstance", "ATLBASE/ATL::CComModule::Init", "ATLBASE/ATL::CComModule::RegisterClassHelper", "ATLBASE/ATL::CComModule::RegisterClassObjects", "ATLBASE/ATL::CComModule::RegisterServer", "ATLBASE/ATL::CComModule::RegisterTypeLib", "ATLBASE/ATL::CComModule::RevokeClassObjects", "ATLBASE/ATL::CComModule::Term", "ATLBASE/ATL::CComModule::UnregisterClassHelper", "ATLBASE/ATL::CComModule::UnregisterServer", "ATLBASE/ATL::CComModule::UpdateRegistryClass", "ATLBASE/ATL::CComModule::UpdateRegistryFromResourceD", "ATLBASE/ATL::CComModule::UpdateRegistryFromResourceS", "ATLBASE/ATL::CComModule::m_csObjMap", "ATLBASE/ATL::CComModule::m_csTypeInfoHolder", "ATLBASE/ATL::CComModule::m_csWindowCreate", "ATLBASE/ATL::CComModule::m_hInst", "ATLBASE/ATL::CComModule::m_hInstResource", "ATLBASE/ATL::CComModule::m_hInstTypeLib", "ATLBASE/ATL::CComModule::m_pObjMap"] helpviewer_keywords: ["CComModule class", "DLL modules [C++], ATL"] -ms.assetid: f5face2c-8fd8-40e6-9ec3-54ab74701769 --- # CComModule Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + As of ATL 7.0, `CComModule` is deprecated: see [ATL Module Classes](../../atl/atl-module-classes.md) for more details. > [!IMPORTANT] diff --git a/docs/atl/reference/ccommultithreadmodel-class.md b/docs/atl/reference/ccommultithreadmodel-class.md index 651aa91f662..56e99deb92b 100644 --- a/docs/atl/reference/ccommultithreadmodel-class.md +++ b/docs/atl/reference/ccommultithreadmodel-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["ATL, multithreading", "CComMultiThreadModel class", "thre --- # CComMultiThreadModel Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + `CComMultiThreadModel` provides thread-safe methods for incrementing and decrementing the value of a variable. ## Syntax diff --git a/docs/atl/reference/ccommultithreadmodelnocs-class.md b/docs/atl/reference/ccommultithreadmodelnocs-class.md index 9a116848eab..b5af9c08403 100644 --- a/docs/atl/reference/ccommultithreadmodelnocs-class.md +++ b/docs/atl/reference/ccommultithreadmodelnocs-class.md @@ -4,10 +4,11 @@ title: "CComMultiThreadModelNoCS Class" ms.date: "11/04/2016" f1_keywords: ["CComMultiThreadModelNoCS", "ATLBASE/ATL::CComMultiThreadModelNoCS", "ATLBASE/ATL::CComMultiThreadModelNoCS::AutoCriticalSection", "ATLBASE/ATL::CComMultiThreadModelNoCS::CriticalSection", "ATLBASE/ATL::CComMultiThreadModelNoCS::ThreadModelNoCS", "ATLBASE/ATL::CComMultiThreadModelNoCS::Decrement", "ATLBASE/ATL::CComMultiThreadModelNoCS::Increment"] helpviewer_keywords: ["ATL, multithreading", "CComMultiThreadModelNoCS class", "threading [ATL]"] -ms.assetid: 2b3f7a45-fd72-452c-aaf3-ccdaa621c821 --- # CComMultiThreadModelNoCS Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + `CComMultiThreadModelNoCS` provides thread-safe methods for incrementing and decrementing the value of a variable, without critical section locking or unlocking functionality. ## Syntax diff --git a/docs/atl/reference/ccomobject-class.md b/docs/atl/reference/ccomobject-class.md index 940285715a1..9e209ec6239 100644 --- a/docs/atl/reference/ccomobject-class.md +++ b/docs/atl/reference/ccomobject-class.md @@ -4,10 +4,11 @@ title: "CComObject Class" ms.date: "11/04/2016" f1_keywords: ["CComObject", "ATLCOM/ATL::CComObject", "ATLCOM/ATL::CComObject::CComObject", "ATLCOM/ATL::CComObject::AddRef", "ATLCOM/ATL::CComObject::CreateInstance", "ATLCOM/ATL::CComObject::QueryInterface", "ATLCOM/ATL::CComObject::Release"] helpviewer_keywords: ["CComObject class"] -ms.assetid: e2b6433b-6349-4749-b4bc-acbd7a22c8b0 --- # CComObject Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` for a nonaggregated object. ## Syntax diff --git a/docs/atl/reference/ccomobjectglobal-class.md b/docs/atl/reference/ccomobjectglobal-class.md index 14afcb2e9d4..345291d1d39 100644 --- a/docs/atl/reference/ccomobjectglobal-class.md +++ b/docs/atl/reference/ccomobjectglobal-class.md @@ -4,10 +4,11 @@ title: "CComObjectGlobal Class" ms.date: "11/04/2016" f1_keywords: ["CComObjectGlobal", "ATLCOM/ATL::CComObjectGlobal", "ATLCOM/ATL::CComObjectGlobal::CComObjectGlobal", "ATLCOM/ATL::CComObjectGlobal::AddRef", "ATLCOM/ATL::CComObjectGlobal::QueryInterface", "ATLCOM/ATL::CComObjectGlobal::Release", "ATLCOM/ATL::CComObjectGlobal::m_hResFinalConstruct"] helpviewer_keywords: ["CComObjectGlobal class"] -ms.assetid: 79bdee55-66e4-4536-b5b3-bdf09f78b9a6 --- # CComObjectGlobal Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class manages a reference count on the module containing your `Base` object. ## Syntax diff --git a/docs/atl/reference/ccomobjectnolock-class.md b/docs/atl/reference/ccomobjectnolock-class.md index e98933f3641..91009986913 100644 --- a/docs/atl/reference/ccomobjectnolock-class.md +++ b/docs/atl/reference/ccomobjectnolock-class.md @@ -4,10 +4,11 @@ title: "CComObjectNoLock Class" ms.date: "11/04/2016" f1_keywords: ["CComObjectNoLock", "ATLCOM/ATL::CComObjectNoLock", "ATLCOM/ATL::CComObjectNoLock::CComObjectNoLock", "ATLCOM/ATL::CComObjectNoLock::AddRef", "ATLCOM/ATL::CComObjectNoLock::QueryInterface", "ATLCOM/ATL::CComObjectNoLock::Release"] helpviewer_keywords: ["CComObjectNoLock class"] -ms.assetid: 288c6506-7da8-4127-8d58-7f4bd779539a --- # CComObjectNoLock Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` for a nonaggregated object, but does not increment the module lock count in the constructor. ## Syntax diff --git a/docs/atl/reference/ccomobjectroot-class.md b/docs/atl/reference/ccomobjectroot-class.md index 5a34267e8d9..e12f04a372f 100644 --- a/docs/atl/reference/ccomobjectroot-class.md +++ b/docs/atl/reference/ccomobjectroot-class.md @@ -4,10 +4,11 @@ title: "CComObjectRoot Class" ms.date: "11/04/2016" f1_keywords: ["CComObjectRoot", "atlcom/ATL::CComObjectRoot"] helpviewer_keywords: ["CComObjectRoot class"] -ms.assetid: f8797c38-6e73-4f67-85c2-71654cffa8eb --- # CComObjectRoot Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This typedef of [CComObjectRootEx](../../atl/reference/ccomobjectrootex-class.md) is templatized on the default threading model of the server. ## Syntax diff --git a/docs/atl/reference/ccomobjectrootex-class.md b/docs/atl/reference/ccomobjectrootex-class.md index d28e79d4906..4b7181dd07d 100644 --- a/docs/atl/reference/ccomobjectrootex-class.md +++ b/docs/atl/reference/ccomobjectrootex-class.md @@ -4,10 +4,11 @@ title: "CComObjectRootEx Class" ms.date: "11/04/2016" f1_keywords: ["CComObjectRootEx", "ATLCOM/ATL::CComObjectRootEx", "ATLCOM/ATL::InternalAddRef", "ATLCOM/ATL::InternalRelease", "ATLCOM/ATL::Lock", "ATLCOM/ATL::Unlock", "ATLCOM/ATL::FinalConstruct", "ATLCOM/ATL::FinalRelease", "ATLCOM/ATL::OuterAddRef", "ATLCOM/ATL::OuterQueryInterface", "ATLCOM/ATL::OuterRelease", "ATLCOM/ATL::InternalQueryInterface", "ATLCOM/ATL::ObjectMain", "ATLCOM/ATL::m_dwRef", "ATLCOM/ATL::m_pOuterUnknown"] helpviewer_keywords: ["reference counting"] -ms.assetid: 894a3d7c-2daf-4fd0-8fa4-e6a05bcfb631 --- # CComObjectRootEx Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods to handle object reference count management for both nonaggregated and aggregated objects. ## Syntax diff --git a/docs/atl/reference/ccomobjectstack-class.md b/docs/atl/reference/ccomobjectstack-class.md index 946beb5b66c..3e109aa93a3 100644 --- a/docs/atl/reference/ccomobjectstack-class.md +++ b/docs/atl/reference/ccomobjectstack-class.md @@ -4,10 +4,11 @@ title: "CComObjectStack Class" ms.date: "11/04/2016" f1_keywords: ["CComObjectStack", "ATLCOM/ATL::CComObjectStack", "ATLCOM/ATL::CComObjectStack::CComObjectStack", "ATLCOM/ATL::CComObjectStack::AddRef", "ATLCOM/ATL::CComObjectStack::QueryInterface", "ATLCOM/ATL::CComObjectStack::Release", "ATLCOM/ATL::CComObjectStack::m_hResFinalConstruct"] helpviewer_keywords: ["CComObjectStack class"] -ms.assetid: 3da72c40-c834-45f6-bb76-6ac204028d80 --- # CComObjectStack Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class creates a temporary COM object and provides it with a skeletal implementation of `IUnknown`. ## Syntax diff --git a/docs/atl/reference/ccompolyobject-class.md b/docs/atl/reference/ccompolyobject-class.md index d3632a52837..42991caee8d 100644 --- a/docs/atl/reference/ccompolyobject-class.md +++ b/docs/atl/reference/ccompolyobject-class.md @@ -4,10 +4,11 @@ title: "CComPolyObject Class" ms.date: "11/04/2016" f1_keywords: ["CComPolyObject", "ATLCOM/ATL::CComPolyObject", "ATLCOM/ATL::CComPolyObject::CComPolyObject", "ATLCOM/ATL::CComPolyObject::AddRef", "ATLCOM/ATL::CComPolyObject::CreateInstance", "ATLCOM/ATL::CComPolyObject::FinalConstruct", "ATLCOM/ATL::CComPolyObject::FinalRelease", "ATLCOM/ATL::CComPolyObject::QueryInterface", "ATLCOM/ATL::CComPolyObject::Release", "ATLCOM/ATL::CComPolyObject::m_contained"] helpviewer_keywords: ["aggregate objects [C++], in ATL", "aggregation [C++], ATL objects", "CComPolyObject class"] -ms.assetid: eaf67c18-e855-48ca-9b15-f1df3106121b --- # CComPolyObject Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` for an aggregated or nonaggregated object. ## Syntax diff --git a/docs/atl/reference/ccomptr-class.md b/docs/atl/reference/ccomptr-class.md index 6ccf6090383..9be4578c843 100644 --- a/docs/atl/reference/ccomptr-class.md +++ b/docs/atl/reference/ccomptr-class.md @@ -4,10 +4,11 @@ description: "Reference guide to the Microsoft C++ Active Template Library (ATL) ms.date: "02/07/2020" f1_keywords: ["CComPtr", "ATLBASE/ATL::CComPtr", "ATLBASE/ATL::CComPtr::CComPtr"] helpviewer_keywords: ["CComPtr class"] -ms.assetid: 22d9ea8d-ed66-4c34-940f-141db11e83bd --- # `CComPtr` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + A smart pointer class for managing COM interface pointers. ## Syntax diff --git a/docs/atl/reference/ccomptrbase-class.md b/docs/atl/reference/ccomptrbase-class.md index c2363d848e2..c1653b2a447 100644 --- a/docs/atl/reference/ccomptrbase-class.md +++ b/docs/atl/reference/ccomptrbase-class.md @@ -4,10 +4,11 @@ title: "CComPtrBase Class" ms.date: "11/04/2016" f1_keywords: ["CComPtrBase", "ATLCOMCLI/ATL::CComPtrBase", "ATLCOMCLI/ATL::CComPtrBase::Advise", "ATLCOMCLI/ATL::CComPtrBase::Attach", "ATLCOMCLI/ATL::CComPtrBase::CoCreateInstance", "ATLCOMCLI/ATL::CComPtrBase::CopyTo", "ATLCOMCLI/ATL::CComPtrBase::Detach", "ATLCOMCLI/ATL::CComPtrBase::IsEqualObject", "ATLCOMCLI/ATL::CComPtrBase::QueryInterface", "ATLCOMCLI/ATL::CComPtrBase::Release", "ATLCOMCLI/ATL::CComPtrBase::SetSite", "ATLCOMCLI/ATL::CComPtrBase::p"] helpviewer_keywords: ["CComPtrBase class"] -ms.assetid: 6dbe9543-dee8-4a97-b02f-dd3a25f4a1a0 --- # `CComPtrBase` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a basis for smart pointer classes using COM-based memory routines. ## Syntax diff --git a/docs/atl/reference/ccomqiptr-class.md b/docs/atl/reference/ccomqiptr-class.md index 03490efe16e..23c87d54f7e 100644 --- a/docs/atl/reference/ccomqiptr-class.md +++ b/docs/atl/reference/ccomqiptr-class.md @@ -4,10 +4,11 @@ title: "CComQIPtr Class" ms.date: "11/04/2016" f1_keywords: ["CComQIPtr", "ATLCOMCLI/ATL::CComQIPtr", "ATLCOMCLI/ATL::CComQIPtr::CComQIPtr"] helpviewer_keywords: ["CComQIPtr class"] -ms.assetid: 969cacb5-05b6-4af4-b683-24911d70242d --- # CComQIPtr Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + A smart pointer class for managing COM interface pointers. ## Syntax diff --git a/docs/atl/reference/ccomqiptrelementtraits-class.md b/docs/atl/reference/ccomqiptrelementtraits-class.md index c81c56e55e6..9d739a9404c 100644 --- a/docs/atl/reference/ccomqiptrelementtraits-class.md +++ b/docs/atl/reference/ccomqiptrelementtraits-class.md @@ -4,10 +4,11 @@ title: "CComQIPtrElementTraits Class" ms.date: "11/04/2016" f1_keywords: ["CComQIPtrElementTraits", "ATLCOLL/ATL::CComQIPtrElementTraits", "ATLCOLL/ATL::CComQIPtrElementTraits::INARGTYPE"] helpviewer_keywords: ["CComQIPtrElementTraits class"] -ms.assetid: 9df9250a-5413-4362-b133-332932a597c4 --- # CComQIPtrElementTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods, static functions, and typedefs useful when creating collections of COM interface pointers. ## Syntax diff --git a/docs/atl/reference/ccomsafearray-class.md b/docs/atl/reference/ccomsafearray-class.md index d9c6729e915..e8b65490485 100644 --- a/docs/atl/reference/ccomsafearray-class.md +++ b/docs/atl/reference/ccomsafearray-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CComSafeArray class"] --- # `CComSafeArray` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for the `SAFEARRAY` structure. ## Syntax diff --git a/docs/atl/reference/ccomsafearraybound-class.md b/docs/atl/reference/ccomsafearraybound-class.md index fa65d7b399d..2d1ea111408 100644 --- a/docs/atl/reference/ccomsafearraybound-class.md +++ b/docs/atl/reference/ccomsafearraybound-class.md @@ -4,10 +4,11 @@ title: "CComSafeArrayBound Class" ms.date: "05/06/2019" f1_keywords: ["CComSafeArrayBound", "ATLSAFE/ATL::CComSafeArrayBound", "ATLSAFE/ATL::GetCount", "ATLSAFE/ATL::GetLowerBound", "ATLSAFE/ATL::GetUpperBound", "ATLSAFE/ATL::SetCount", "ATLSAFE/ATL::SetLowerBound"] helpviewer_keywords: ["CComSafeArrayBound class"] -ms.assetid: dd6299db-5f84-4630-bbf0-f5add5318437 --- # CComSafeArrayBound Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for a [SAFEARRAYBOUND](/windows/win32/api/oaidl/ns-oaidl-safearraybound) structure. ## Syntax diff --git a/docs/atl/reference/ccomsafedeletecriticalsection-class.md b/docs/atl/reference/ccomsafedeletecriticalsection-class.md index 1ece1377c38..c4e8ec088ea 100644 --- a/docs/atl/reference/ccomsafedeletecriticalsection-class.md +++ b/docs/atl/reference/ccomsafedeletecriticalsection-class.md @@ -4,10 +4,11 @@ title: "CComSafeDeleteCriticalSection Class" ms.date: "11/04/2016" f1_keywords: ["CComSafeDeleteCriticalSection", "ATLCORE/ATL::CComSafeDeleteCriticalSection", "ATLCORE/ATL::CComSafeDeleteCriticalSection::CComSafeDeleteCriticalSection", "ATLCORE/ATL::CComSafeDeleteCriticalSection::Init", "ATLCORE/ATL::CComSafeDeleteCriticalSection::Lock", "ATLCORE/ATL::CComSafeDeleteCriticalSection::Term", "ATLCORE/ATL::m_bInitialized"] helpviewer_keywords: ["CComSafeDeleteCriticalSection class"] -ms.assetid: 4d2932c4-ba8f-48ec-8664-1db8bed01314 --- # CComSafeDeleteCriticalSection Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for obtaining and releasing ownership of a critical section object. ## Syntax diff --git a/docs/atl/reference/ccomsimplethreadallocator-class.md b/docs/atl/reference/ccomsimplethreadallocator-class.md index 3ba04a9ad2d..1d3b4a19f4b 100644 --- a/docs/atl/reference/ccomsimplethreadallocator-class.md +++ b/docs/atl/reference/ccomsimplethreadallocator-class.md @@ -4,10 +4,11 @@ title: "CComSimpleThreadAllocator Class" ms.date: "11/04/2016" f1_keywords: ["CComSimpleThreadAllocator", "ATLBASE/ATL::CComSimpleThreadAllocator", "ATLBASE/ATL::CComSimpleThreadAllocator::GetThread"] helpviewer_keywords: ["threading [ATL], selecting threads", "ATL threads", "CComSimpleThreadAllocator class", "ATL threads, allocating"] -ms.assetid: 66b2166a-8c50-49fd-b8e4-7f293470327d --- # CComSimpleThreadAllocator Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class manages thread selection for the class `CComAutoThreadModule`. ## Syntax diff --git a/docs/atl/reference/ccomsinglethreadmodel-class.md b/docs/atl/reference/ccomsinglethreadmodel-class.md index 1fdb2f95db5..d81455f0ca3 100644 --- a/docs/atl/reference/ccomsinglethreadmodel-class.md +++ b/docs/atl/reference/ccomsinglethreadmodel-class.md @@ -4,10 +4,11 @@ title: "CComSingleThreadModel Class" ms.date: "2/29/2020" f1_keywords: ["CComSingleThreadModel", "ATLBASE/ATL::CComSingleThreadModel", "ATLBASE/ATL::CComSingleThreadModel::AutoCriticalSection", "ATLBASE/ATL::CComSingleThreadModel::CriticalSection", "ATLBASE/ATL::CComSingleThreadModel::ThreadModelNoCS", "ATLBASE/ATL::CComSingleThreadModel::Decrement", "ATLBASE/ATL::CComSingleThreadModel::Increment"] helpviewer_keywords: ["single-threaded applications", "CComSingleThreadModel class", "single-threaded applications, ATL"] -ms.assetid: e5dc30c7-405a-4ba4-8ae9-51937243fce8 --- # CComSingleThreadModel Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for incrementing and decrementing the value of a variable. ## Syntax diff --git a/docs/atl/reference/ccomtearoffobject-class.md b/docs/atl/reference/ccomtearoffobject-class.md index 42f6daf5171..a1813b71e2d 100644 --- a/docs/atl/reference/ccomtearoffobject-class.md +++ b/docs/atl/reference/ccomtearoffobject-class.md @@ -4,10 +4,11 @@ title: "CComTearOffObject Class" ms.date: "11/04/2016" f1_keywords: ["CComTearOffObject", "ATLCOM/ATL::CComTearOffObject", "ATLCOM/ATL::CComTearOffObject::CComTearOffObject", "ATLCOM/ATL::CComTearOffObject::AddRef", "ATLCOM/ATL::CComTearOffObject::QueryInterface", "ATLCOM/ATL::CComTearOffObject::Release", "ATLCOM/ATL::CComTearOffObjectBase", "ATLCOM/ATL::m_pOwner"] helpviewer_keywords: ["tear-off interfaces, ATL", "tear-off interfaces", "CComTearOffObject class"] -ms.assetid: d974b598-c6b2-42b1-8360-9190d9d0fbf3 --- # CComTearOffObject Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements a tear-off interface. ## Syntax diff --git a/docs/atl/reference/ccomunkarray-class.md b/docs/atl/reference/ccomunkarray-class.md index dcdc5ecd76d..2232eea84ef 100644 --- a/docs/atl/reference/ccomunkarray-class.md +++ b/docs/atl/reference/ccomunkarray-class.md @@ -4,10 +4,11 @@ title: "CComUnkArray Class" ms.date: "11/04/2016" f1_keywords: ["CComUnkArray", "ATLCOM/ATL::CComUnkArray", "ATLCOM/ATL::CComUnkArray::CComUnkArray", "ATLCOM/ATL::CComUnkArray::Add", "ATLCOM/ATL::CComUnkArray::begin", "ATLCOM/ATL::CComUnkArray::end", "ATLCOM/ATL::CComUnkArray::GetCookie", "ATLCOM/ATL::CComUnkArray::GetUnknown", "ATLCOM/ATL::CComUnkArray::Remove"] helpviewer_keywords: ["connection points [C++], managing", "CComUnkArray class"] -ms.assetid: 5fd4b378-a7b5-4cc1-8866-8ab72a73639e --- # CComUnkArray Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class stores `IUnknown` pointers, and is designed to be used as a parameter to the [IConnectionPointImpl](../../atl/reference/iconnectionpointimpl-class.md) template class. ## Syntax diff --git a/docs/atl/reference/ccomvariant-class.md b/docs/atl/reference/ccomvariant-class.md index e3b806e113a..b7387eaed95 100644 --- a/docs/atl/reference/ccomvariant-class.md +++ b/docs/atl/reference/ccomvariant-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["VARIANT macro", "CComVariant class", "VARIANT macro, ATL" --- # `CComVariant` class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class wraps the `VARIANT` type, providing a member indicating the type of data stored. ## Syntax diff --git a/docs/atl/reference/ccontainedwindowt-class.md b/docs/atl/reference/ccontainedwindowt-class.md index 92e55f8f39c..a3bd317fda7 100644 --- a/docs/atl/reference/ccontainedwindowt-class.md +++ b/docs/atl/reference/ccontainedwindowt-class.md @@ -4,10 +4,11 @@ title: "CContainedWindowT Class" ms.date: "11/04/2016" f1_keywords: ["CContainedWindowT", "ATLWIN/ATL::CContainedWindowT", "ATLWIN/ATL::CContainedWindowT::CContainedWindowT", "ATLWIN/ATL::CContainedWindowT::Create", "ATLWIN/ATL::CContainedWindowT::DefWindowProc", "ATLWIN/ATL::CContainedWindowT::GetCurrentMessage", "ATLWIN/ATL::CContainedWindowT::RegisterWndSuperclass", "ATLWIN/ATL::CContainedWindowT::SubclassWindow", "ATLWIN/ATL::CContainedWindowT::SwitchMessageMap", "ATLWIN/ATL::CContainedWindowT::UnsubclassWindow", "ATLWIN/ATL::CContainedWindowT::WindowProc", "ATLWIN/ATL::CContainedWindowT::m_dwMsgMapID", "ATLWIN/ATL::CContainedWindowT::m_lpszClassName", "ATLWIN/ATL::CContainedWindowT::m_pfnSuperWindowProc", "ATLWIN/ATL::CContainedWindowT::m_pObject"] helpviewer_keywords: ["CContainedWindow class", "contained windows", "CContainedWindowT class"] -ms.assetid: cde0ca36-9347-4068-995a-d294dae57ca9 --- # CContainedWindowT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements a window contained within another object. > [!IMPORTANT] diff --git a/docs/atl/reference/ccrtallocator-class.md b/docs/atl/reference/ccrtallocator-class.md index 782c70f47f4..6df2c1e8ef6 100644 --- a/docs/atl/reference/ccrtallocator-class.md +++ b/docs/atl/reference/ccrtallocator-class.md @@ -4,10 +4,11 @@ title: "CCRTAllocator Class" ms.date: "11/04/2016" f1_keywords: ["CCRTAllocator", "ATLCORE/ATL::CCRTAllocator", "ATLCORE/ATL::CCRTAllocator::Allocate", "ATLCORE/ATL::CCRTAllocator::Free", "ATLCORE/ATL::CCRTAllocator::Reallocate"] helpviewer_keywords: ["CCRTAllocator class"] -ms.assetid: 3e1b8cb0-859a-41ab-8e93-6f0b5ceca49d --- # CCRTAllocator Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for managing memory using CRT memory routines. ## Syntax diff --git a/docs/atl/reference/ccrtheap-class.md b/docs/atl/reference/ccrtheap-class.md index 2c032d979d5..e1437bf729f 100644 --- a/docs/atl/reference/ccrtheap-class.md +++ b/docs/atl/reference/ccrtheap-class.md @@ -4,10 +4,11 @@ title: "CCRTHeap Class" ms.date: "11/04/2016" f1_keywords: ["CCRTHeap", "ATLMEM/ATL::CCRTHeap", "ATLMEM/ATL::CCRTHeap::Allocate", "ATLMEM/ATL::CCRTHeap::Free", "ATLMEM/ATL::CCRTHeap::GetSize", "ATLMEM/ATL::CCRTHeap::Reallocate"] helpviewer_keywords: ["CCRTHeap class"] -ms.assetid: 321bd6c5-1856-4ff7-8590-95044a1209f7 --- # CCRTHeap Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements [IAtlMemMgr](../../atl/reference/iatlmemmgr-class.md) using the CRT heap functions. ## Syntax diff --git a/docs/atl/reference/cdacl-class.md b/docs/atl/reference/cdacl-class.md index dcd93c40d51..d3efde58ccc 100644 --- a/docs/atl/reference/cdacl-class.md +++ b/docs/atl/reference/cdacl-class.md @@ -4,10 +4,11 @@ title: "CDacl Class" ms.date: "11/04/2016" f1_keywords: ["CDacl", "ATLSECURITY/ATL::CDacl", "ATLSECURITY/ATL::CDacl::CDacl", "ATLSECURITY/ATL::CDacl::AddAllowedAce", "ATLSECURITY/ATL::CDacl::AddDeniedAce", "ATLSECURITY/ATL::CDacl::GetAceCount", "ATLSECURITY/ATL::CDacl::RemoveAce", "ATLSECURITY/ATL::CDacl::RemoveAllAces"] helpviewer_keywords: ["CDacl class"] -ms.assetid: 2dc76616-6362-4967-b6cf-e2d39ca37ddd --- # CDacl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for a DACL (discretionary access-control list) structure. > [!IMPORTANT] diff --git a/docs/atl/reference/cdebugreporthook-class.md b/docs/atl/reference/cdebugreporthook-class.md index a525a352572..5226a4b5a71 100644 --- a/docs/atl/reference/cdebugreporthook-class.md +++ b/docs/atl/reference/cdebugreporthook-class.md @@ -4,10 +4,11 @@ title: "CDebugReportHook Class" ms.date: "11/04/2016" f1_keywords: ["CDebugReportHook", "ATLUTIL/ATL::CDebugReportHook", "ATLUTIL/ATL::CDebugReportHook::CDebugReportHook", "ATLUTIL/ATL::CDebugReportHook::CDebugReportHookProc", "ATLUTIL/ATL::CDebugReportHook::RemoveHook", "ATLUTIL/ATL::CDebugReportHook::SetHook", "ATLUTIL/ATL::CDebugReportHook::SetPipeName", "ATLUTIL/ATL::CDebugReportHook::SetTimeout"] helpviewer_keywords: ["CDebugReportHook class"] -ms.assetid: 798076c3-6e63-4286-83b8-aa1bbcd0c20c --- # CDebugReportHook Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Use this class to send debug reports to a named pipe. ## Syntax diff --git a/docs/atl/reference/cdefaultchartraits-class.md b/docs/atl/reference/cdefaultchartraits-class.md index 6d941499c6e..af31367ac79 100644 --- a/docs/atl/reference/cdefaultchartraits-class.md +++ b/docs/atl/reference/cdefaultchartraits-class.md @@ -4,10 +4,11 @@ title: "CDefaultCharTraits Class" ms.date: "11/04/2016" f1_keywords: ["CDefaultCharTraits", "ATLCOLL/ATL::CDefaultCharTraits", "ATLCOLL/ATL::CDefaultCharTraits::CharToLower", "ATLCOLL/ATL::CDefaultCharTraits::CharToUpper"] helpviewer_keywords: ["CDefaultCharTraits class"] -ms.assetid: f94a3934-597f-401d-8513-ed6924ae069a --- # CDefaultCharTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides two static functions for converting characters between uppercase and lowercase. ## Syntax diff --git a/docs/atl/reference/cdefaultcomparetraits-class.md b/docs/atl/reference/cdefaultcomparetraits-class.md index ba680d50619..214e82b226e 100644 --- a/docs/atl/reference/cdefaultcomparetraits-class.md +++ b/docs/atl/reference/cdefaultcomparetraits-class.md @@ -4,10 +4,11 @@ title: "CDefaultCompareTraits Class" ms.date: "11/04/2016" f1_keywords: ["CDefaultCompareTraits", "ATLCOLL/ATL::CDefaultCompareTraits", "ATLCOLL/ATL::CDefaultCompareTraits::CompareElements", "ATLCOLL/ATL::CDefaultCompareTraits::CompareElementsOrdered"] helpviewer_keywords: ["CDefaultCompareTraits class"] -ms.assetid: a17e2740-e7b4-48f2-aeb7-c80ce84b63f7 --- # CDefaultCompareTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides default element comparison functions. ## Syntax diff --git a/docs/atl/reference/cdefaultelementtraits-class.md b/docs/atl/reference/cdefaultelementtraits-class.md index ee35bca2b36..7f33e07d8f3 100644 --- a/docs/atl/reference/cdefaultelementtraits-class.md +++ b/docs/atl/reference/cdefaultelementtraits-class.md @@ -4,10 +4,11 @@ title: "CDefaultElementTraits Class" ms.date: "11/04/2016" f1_keywords: ["CDefaultElementTraits", "atlcoll/ATL::CDefaultElementTraits"] helpviewer_keywords: ["CDefaultElementTraits class"] -ms.assetid: ac5ee610-7957-4b7c-92b6-38ff72e4118e --- # CDefaultElementTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides default methods and functions for a collection class. ## Syntax diff --git a/docs/atl/reference/cdefaulthashtraits-class.md b/docs/atl/reference/cdefaulthashtraits-class.md index 8c626840a95..562b6da25a7 100644 --- a/docs/atl/reference/cdefaulthashtraits-class.md +++ b/docs/atl/reference/cdefaulthashtraits-class.md @@ -4,10 +4,11 @@ title: "CDefaultHashTraits Class" ms.date: "11/04/2016" f1_keywords: ["CDefaultHashTraits", "ATLCOLL/ATL::CDefaultHashTraits", "ATLCOLL/ATL::CDefaultHashTraits::Hash"] helpviewer_keywords: ["CDefaultHashTraits class"] -ms.assetid: d8ec4b37-6d58-447b-a0c1-8580c5b1ab85 --- # CDefaultHashTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a static function for calculating hash values. ## Syntax diff --git a/docs/atl/reference/cdialogimpl-class.md b/docs/atl/reference/cdialogimpl-class.md index 56a1d4713c2..322ce2b5812 100644 --- a/docs/atl/reference/cdialogimpl-class.md +++ b/docs/atl/reference/cdialogimpl-class.md @@ -4,10 +4,11 @@ title: "CDialogImpl Class" ms.date: "11/04/2016" f1_keywords: ["CDialogImpl", "ATLWIN/ATL::CDialogImpl", "ATLWIN/ATL::Create", "ATLWIN/ATL::DestroyWindow", "ATLWIN/ATL::DoModal", "ATLWIN/ATL::EndDialog", "ATLWIN/ATL::GetDialogProc", "ATLWIN/ATL::MapDialogRect", "ATLWIN/ATL::OnFinalMessage", "ATLWIN/ATL::DialogProc", "ATLWIN/ATL::StartDialogProc"] helpviewer_keywords: ["dialog boxes, ATL", "CDialogImpl class"] -ms.assetid: d430bc7b-8a28-4ad3-9507-277bdd2c2c2e --- # CDialogImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for creating a modal or modeless dialog box. > [!IMPORTANT] diff --git a/docs/atl/reference/cdynamicchain-class.md b/docs/atl/reference/cdynamicchain-class.md index 27e0374b8f9..b3095ff263e 100644 --- a/docs/atl/reference/cdynamicchain-class.md +++ b/docs/atl/reference/cdynamicchain-class.md @@ -4,10 +4,11 @@ title: "CDynamicChain Class" ms.date: "11/04/2016" f1_keywords: ["CDynamicChain", "ATLWIN/ATL::CDynamicChain", "ATLWIN/ATL::CDynamicChain::CDynamicChain", "ATLWIN/ATL::CDynamicChain::CallChain", "ATLWIN/ATL::CDynamicChain::RemoveChainEntry", "ATLWIN/ATL::CDynamicChain::SetChainEntry"] helpviewer_keywords: ["message maps, chaining", "chaining message maps", "CDynamicChain class"] -ms.assetid: f084b2be-0e77-4836-973d-ae278a1e9da8 --- # CDynamicChain Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods supporting the dynamic chaining of message maps. > [!IMPORTANT] diff --git a/docs/atl/reference/celementtraits-class.md b/docs/atl/reference/celementtraits-class.md index 067c69927e0..69ba5045e2b 100644 --- a/docs/atl/reference/celementtraits-class.md +++ b/docs/atl/reference/celementtraits-class.md @@ -4,10 +4,11 @@ title: "CElementTraits Class" ms.date: "11/04/2016" f1_keywords: ["CElementTraits", "atlcoll/ATL::CElementTraits"] helpviewer_keywords: ["CElementTraits class"] -ms.assetid: 496528e5-7f80-4b45-be0c-6f646feb43c5 --- # CElementTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is used by collection classes to provide methods and functions for moving, copying, comparison, and hashing operations. ## Syntax diff --git a/docs/atl/reference/celementtraitsbase-class.md b/docs/atl/reference/celementtraitsbase-class.md index 8bf122174c6..569f754e6b2 100644 --- a/docs/atl/reference/celementtraitsbase-class.md +++ b/docs/atl/reference/celementtraitsbase-class.md @@ -4,10 +4,11 @@ title: "CElementTraitsBase Class" ms.date: "11/04/2016" f1_keywords: ["CElementTraitsBase", "ATLCOLL/ATL::CElementTraitsBase", "ATLCOLL/ATL::CElementTraitsBase::INARGTYPE", "ATLCOLL/ATL::CElementTraitsBase::OUTARGTYPE", "ATLCOLL/ATL::CElementTraitsBase::CopyElements", "ATLCOLL/ATL::CElementTraitsBase::RelocateElements"] helpviewer_keywords: ["CElementTraitsBase class"] -ms.assetid: 75284caf-347e-4355-a7d8-efc708dd514a --- # CElementTraitsBase Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides default copy and move methods for a collection class. ## Syntax diff --git a/docs/atl/reference/cfirepropnotifyevent-class.md b/docs/atl/reference/cfirepropnotifyevent-class.md index 76834b9a5ed..a9058036f19 100644 --- a/docs/atl/reference/cfirepropnotifyevent-class.md +++ b/docs/atl/reference/cfirepropnotifyevent-class.md @@ -4,10 +4,11 @@ title: "CFirePropNotifyEvent Class" ms.date: "11/04/2016" f1_keywords: ["CFirePropNotifyEvent", "ATLCTL/ATL::CFirePropNotifyEvent", "ATLCTL/ATL::CFirePropNotifyEvent::FireOnChanged", "ATLCTL/ATL::CFirePropNotifyEvent::FireOnRequestEdit"] helpviewer_keywords: ["sinks, notifying of ATL events", "CFirePropNotifyEvent class", "connection points [C++], notifying of events"] -ms.assetid: eb7a563e-6bce-4cdf-8d20-8c6a5307781b --- # CFirePropNotifyEvent Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for notifying the container's sink regarding control property changes. > [!IMPORTANT] diff --git a/docs/atl/reference/cglobalheap-class.md b/docs/atl/reference/cglobalheap-class.md index 426101159d7..38fe72d252b 100644 --- a/docs/atl/reference/cglobalheap-class.md +++ b/docs/atl/reference/cglobalheap-class.md @@ -4,10 +4,11 @@ title: "CGlobalHeap Class" ms.date: "11/04/2016" f1_keywords: ["CGlobalHeap", "ATLMEM/ATL::CGlobalHeap", "ATLMEM/ATL::CGlobalHeap::Allocate", "ATLMEM/ATL::CGlobalHeap::Free", "ATLMEM/ATL::CGlobalHeap::GetSize", "ATLMEM/ATL::CGlobalHeap::Reallocate"] helpviewer_keywords: ["CGlobalHeap class"] -ms.assetid: e348d838-3aa7-4bee-a1b3-cd000c99f834 --- # CGlobalHeap Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements [IAtlMemMgr](../../atl/reference/iatlmemmgr-class.md) using the Win32 global heap functions. > [!IMPORTANT] diff --git a/docs/atl/reference/chandle-class.md b/docs/atl/reference/chandle-class.md index 237fa0cd883..54f0095d210 100644 --- a/docs/atl/reference/chandle-class.md +++ b/docs/atl/reference/chandle-class.md @@ -4,10 +4,11 @@ title: "CHandle Class" ms.date: "07/09/2019" f1_keywords: ["CHandle", "ATLBASE/ATL::CHandle", "ATLBASE/ATL::CHandle::CHandle", "ATLBASE/ATL::CHandle::Attach", "ATLBASE/ATL::CHandle::Close", "ATLBASE/ATL::CHandle::Detach", "ATLBASE/ATL::CHandle::m_h"] helpviewer_keywords: ["CHandle class"] -ms.assetid: 883e9db5-40ec-4e29-9c74-4dd2ddd2e35d --- # CHandle Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for creating and using a handle object. ## Syntax diff --git a/docs/atl/reference/cheapptr-class.md b/docs/atl/reference/cheapptr-class.md index c7888bfbccd..53580613dcc 100644 --- a/docs/atl/reference/cheapptr-class.md +++ b/docs/atl/reference/cheapptr-class.md @@ -4,10 +4,11 @@ title: "CHeapPtr Class" ms.date: "11/04/2016" f1_keywords: ["CHeapPtr", "ATLCORE/ATL::CHeapPtr", "ATLCORE/ATL::CHeapPtr::CHeapPtr", "ATLCORE/ATL::CHeapPtr::Allocate", "ATLCORE/ATL::CHeapPtr::Reallocate"] helpviewer_keywords: ["CHeapPtr class"] -ms.assetid: e5c5bfd4-9bf1-4164-8a83-8155fe253454 --- # CHeapPtr Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + A smart pointer class for managing heap pointers. > [!IMPORTANT] diff --git a/docs/atl/reference/cheapptrbase-class.md b/docs/atl/reference/cheapptrbase-class.md index 8ba15f0fb65..a756cc99bc3 100644 --- a/docs/atl/reference/cheapptrbase-class.md +++ b/docs/atl/reference/cheapptrbase-class.md @@ -4,10 +4,11 @@ title: "CHeapPtrBase class" ms.date: "11/04/2016" f1_keywords: ["CHeapPtrBase", "ATLCORE/ATL::CHeapPtrBase", "ATLCORE/ATL::CHeapPtrBase::AllocateBytes", "ATLCORE/ATL::CHeapPtrBase::Attach", "ATLCORE/ATL::CHeapPtrBase::Detach", "ATLCORE/ATL::CHeapPtrBase::Free", "ATLCORE/ATL::CHeapPtrBase::ReallocateBytes", "ATLCORE/ATL::CHeapPtrBase::m_pData"] helpviewer_keywords: ["CHeapPtrBase class"] -ms.assetid: 501ac1b2-fb34-4c72-b7e6-a4f1fc8fda21 --- # `CHeapPtrBase` class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class forms the basis for several smart heap pointer classes. > [!IMPORTANT] diff --git a/docs/atl/reference/cheapptrelementtraits-class.md b/docs/atl/reference/cheapptrelementtraits-class.md index 3ff0b3f44d1..5fb6c021ad1 100644 --- a/docs/atl/reference/cheapptrelementtraits-class.md +++ b/docs/atl/reference/cheapptrelementtraits-class.md @@ -4,10 +4,11 @@ title: "CHeapPtrElementTraits Class" ms.date: "11/04/2016" f1_keywords: ["CHeapPtrElementTraits", "ATLCOLL/ATL::CHeapPtrElementTraits", "ATLCOLL/ATL::CHeapPtrElementTraits::INARGTYPE", "ATLCOLL/ATL::CHeapPtrElementTraits::OUTARGTYPE"] helpviewer_keywords: ["CHeapPtrElementTraits class"] -ms.assetid: 910e0e06-3c8b-4242-bf00-b57eb74fbc77 --- # CHeapPtrElementTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods, static functions, and typedefs useful when creating collections of heap pointers. > [!IMPORTANT] diff --git a/docs/atl/reference/cheapptrlist-class.md b/docs/atl/reference/cheapptrlist-class.md index 591c5787727..4513428fcb8 100644 --- a/docs/atl/reference/cheapptrlist-class.md +++ b/docs/atl/reference/cheapptrlist-class.md @@ -4,10 +4,11 @@ title: "CHeapPtrList Class" ms.date: "11/04/2016" f1_keywords: ["CHeapPtrList", "ATLCOLL/ATL::CHeapPtrList", "ATLCOLL/ATL::CHeapPtrList::CHeapPtrList"] helpviewer_keywords: ["CHeapPtrList class"] -ms.assetid: cc70e585-362a-4007-81db-c705eb181226 --- # CHeapPtrList Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods useful when constructing a list of heap pointers. > [!IMPORTANT] diff --git a/docs/atl/reference/cinterfacearray-class.md b/docs/atl/reference/cinterfacearray-class.md index 3a6ec0bc1df..d7c378a72a9 100644 --- a/docs/atl/reference/cinterfacearray-class.md +++ b/docs/atl/reference/cinterfacearray-class.md @@ -4,10 +4,11 @@ title: "CInterfaceArray Class" ms.date: "11/04/2016" f1_keywords: ["CInterfaceArray", "ATLCOLL/ATL::CInterfaceArray", "ATLCOLL/ATL::CInterfaceArray::CInterfaceArray"] helpviewer_keywords: ["CInterfaceArray class"] -ms.assetid: 1f29cf66-a086-4a7b-b6a8-64f73da39f79 --- # CInterfaceArray Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods useful when constructing an array of COM interface pointers. ## Syntax diff --git a/docs/atl/reference/cinterfacelist-class.md b/docs/atl/reference/cinterfacelist-class.md index e5aae7bdce7..f445de12465 100644 --- a/docs/atl/reference/cinterfacelist-class.md +++ b/docs/atl/reference/cinterfacelist-class.md @@ -4,10 +4,11 @@ title: "CInterfaceList Class" ms.date: "11/04/2016" f1_keywords: ["CInterfaceList", "ATLCOLL/ATL::CInterfaceList", "ATLCOLL/ATL::CInterfaceList::CInterfaceList"] helpviewer_keywords: ["CInterfaceList class"] -ms.assetid: 2077764d-25e5-4b3d-96c8-08a287bbcd25 --- # CInterfaceList Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods useful when constructing a list of COM interface pointers. ## Syntax diff --git a/docs/atl/reference/clocalheap-class.md b/docs/atl/reference/clocalheap-class.md index 32ff5c199e4..9d597b0d29c 100644 --- a/docs/atl/reference/clocalheap-class.md +++ b/docs/atl/reference/clocalheap-class.md @@ -4,10 +4,11 @@ title: "CLocalHeap Class" ms.date: "11/04/2016" f1_keywords: ["CLocalHeap", "ATLMEM/ATL::CLocalHeap", "ATLMEM/ATL::CLocalHeap::Allocate", "ATLMEM/ATL::CLocalHeap::Free", "ATLMEM/ATL::CLocalHeap::GetSize", "ATLMEM/ATL::CLocalHeap::Reallocate"] helpviewer_keywords: ["CLocalHeap class"] -ms.assetid: 1ffa87a5-5fc8-4f8d-8809-58e87e963bd2 --- # CLocalHeap Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements [IAtlMemMgr](../../atl/reference/iatlmemmgr-class.md) using the Win32 local heap functions. > [!IMPORTANT] diff --git a/docs/atl/reference/cmessagemap-class.md b/docs/atl/reference/cmessagemap-class.md index 1f8f30e7429..3e9c87e6d8e 100644 --- a/docs/atl/reference/cmessagemap-class.md +++ b/docs/atl/reference/cmessagemap-class.md @@ -4,10 +4,11 @@ title: "CMessageMap Class" ms.date: "11/04/2016" f1_keywords: ["CMessageMap", "ATLWIN/ATL::CMessageMap", "ATLWIN/ATL::CMessageMap::ProcessWindowMessage"] helpviewer_keywords: ["CMessageMap class", "message maps, ATL", "ATL, message handlers"] -ms.assetid: 1f97bc16-a8a0-4cf0-b90f-1778813a5c8e --- # CMessageMap Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class allows an object's message maps to be access by another object. > [!IMPORTANT] diff --git a/docs/atl/reference/cnonstatelessworker-class.md b/docs/atl/reference/cnonstatelessworker-class.md index 014cd170ab8..c11f44e5cf6 100644 --- a/docs/atl/reference/cnonstatelessworker-class.md +++ b/docs/atl/reference/cnonstatelessworker-class.md @@ -4,10 +4,11 @@ title: "CNonStatelessWorker Class" ms.date: "11/04/2016" f1_keywords: ["CNonStatelessWorker", "ATLUTIL/ATL::CNonStatelessWorker", "ATLUTIL/ATL::CNonStatelessWorker::RequestType", "ATLUTIL/ATL::CNonStatelessWorker::Execute", "ATLUTIL/ATL::CNonStatelessWorker::Initialize", "ATLUTIL/ATL::CNonStatelessWorker::Terminate"] helpviewer_keywords: ["CNonStatelessWorker class"] -ms.assetid: d00936c6-9e7d-49fb-b87d-417b963367d1 --- # CNonStatelessWorker Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Receives requests from a thread pool and passes them on to a worker object that is created and destroyed on each request. > [!IMPORTANT] diff --git a/docs/atl/reference/cnoworkerthread-class.md b/docs/atl/reference/cnoworkerthread-class.md index 69c725ddc5e..a46f79dd47f 100644 --- a/docs/atl/reference/cnoworkerthread-class.md +++ b/docs/atl/reference/cnoworkerthread-class.md @@ -4,10 +4,11 @@ title: "CNoWorkerThread Class" ms.date: "11/04/2016" f1_keywords: ["CNoWorkerThread", "ATLUTIL/ATL::CNoWorkerThread", "ATLUTIL/ATL::CNoWorkerThread::AddHandle", "ATLUTIL/ATL::CNoWorkerThread::AddTimer", "ATLUTIL/ATL::CNoWorkerThread::GetThreadHandle", "ATLUTIL/ATL::CNoWorkerThread::GetThreadId", "ATLUTIL/ATL::CNoWorkerThread::Initialize", "ATLUTIL/ATL::CNoWorkerThread::RemoveHandle", "ATLUTIL/ATL::CNoWorkerThread::Shutdown"] helpviewer_keywords: ["CNoWorkerThread class"] -ms.assetid: 29f06bae-b658-4aac-9c14-331e996d25d1 --- # CNoWorkerThread Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Use this class as the argument for the `MonitorClass` template parameter to cache classes if you want to disable dynamic cache maintenance. > [!IMPORTANT] diff --git a/docs/atl/reference/com-interface-entry-macros.md b/docs/atl/reference/com-interface-entry-macros.md index 83a187ec491..dd365f7d09d 100644 --- a/docs/atl/reference/com-interface-entry-macros.md +++ b/docs/atl/reference/com-interface-entry-macros.md @@ -4,10 +4,11 @@ title: "COM Interface Entry Macros" ms.date: "03/28/2017" f1_keywords: ["atlcom/ATL::COM_INTERFACE_ENTRY", "atlcom/ATL::COM_INTERFACE_ENTRY_IID", "atlcom/ATL::COM_INTERFACE_ENTRY_AGGREGATE", "atlcom/ATL::COM_INTERFACE_ENTRY_AGGREGATE_BLIND", "atlcom/ATL::COM_INTERFACE_ENTRY_AUTOAGGREGATE", "atlcom/ATL::COM_INTERFACE_ENTRY_AUTOAGGREGATE_BLIND", "atlcom/ATL::COM_INTERFACE_ENTRY_BREAK", "atlcom/ATL::COM_INTERFACE_ENTRY_CACHED_TEAR_OFF", "atlcom/ATL::COM_INTERFACE_ENTRY_TEAR_OFF", "atlcom/ATL::COM_INTERFACE_ENTRY_CHAIN", "atlcom/ATL::COM_INTERFACE_ENTRY_FUNC", "atlcom/ATL::COM_INTERFACE_ENTRY_FUNC_BLIND", "atlcom/ATL::COM_INTERFACE_ENTRY_NOINTERFACE"] helpviewer_keywords: ["COM interfaces, COM interface entry macros"] -ms.assetid: 19dcb768-2e1f-4b8d-a618-453a01a4bd00 --- # COM_INTERFACE_ENTRY Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros enter an object's interfaces into its COM map so that they can be accessed by `QueryInterface`. The order of entries in the COM map is the order interfaces will be checked for a matching IID during `QueryInterface`. |Macro|Description| diff --git a/docs/atl/reference/com-map-global-functions.md b/docs/atl/reference/com-map-global-functions.md index 97e19802646..e7ebb9ed76d 100644 --- a/docs/atl/reference/com-map-global-functions.md +++ b/docs/atl/reference/com-map-global-functions.md @@ -4,10 +4,11 @@ title: "COM Map Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlbase/ATL::AtlInternalQueryInterface", "atlbase/ATL::InlineIsEqualIUnknown"] helpviewer_keywords: ["COM interfaces, COM map global functions"] -ms.assetid: b9612d30-eb23-46ef-8093-d56f237d3cf1 --- # COM Map Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide support for COM Map `IUnknown` implementations. |Function|Description| diff --git a/docs/atl/reference/com-map-macros.md b/docs/atl/reference/com-map-macros.md index 6734604721d..93d4b26bb69 100644 --- a/docs/atl/reference/com-map-macros.md +++ b/docs/atl/reference/com-map-macros.md @@ -4,10 +4,11 @@ title: "COM Map Macros" ms.date: "11/04/2016" f1_keywords: ["atlcom/ATL::BEGIN_COM_MAP", "atlcom/ATL::END_COM_MAP", "ATLCOM/BEGIN_COM_MAP", "ATLCOM/END_COM_MAP"] helpviewer_keywords: ["COM interfaces, COM map macros"] -ms.assetid: 0f33656d-321f-4996-90cc-9a7f21ab73c3 --- # COM Map Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define COM interface maps. |Macro|Description| diff --git a/docs/atl/reference/com-plus-1-0-atl-com-plus-1-0-component-wizard.md b/docs/atl/reference/com-plus-1-0-atl-com-plus-1-0-component-wizard.md index 0a125245518..37826eba5b2 100644 --- a/docs/atl/reference/com-plus-1-0-atl-com-plus-1-0-component-wizard.md +++ b/docs/atl/reference/com-plus-1-0-atl-com-plus-1-0-component-wizard.md @@ -3,10 +3,11 @@ description: "Learn more about: COM+ 1.0, ATL COM+ 1.0 Component Wizard" title: "COM+ 1.0, ATL COM+ 1.0 Component Wizard" ms.date: "05/09/2019" f1_keywords: ["vc.codewiz.class.atl.mts.options"] -ms.assetid: 2fbe259c-6be1-4d0e-9cfe-721c75c97cb1 --- # COM+ 1.0, ATL COM+ 1.0 Component Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" This wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/com-plus-1-0-support-in-atl-projects.md b/docs/atl/reference/com-plus-1-0-support-in-atl-projects.md index ae0f296311b..72d9e7e0ff7 100644 --- a/docs/atl/reference/com-plus-1-0-support-in-atl-projects.md +++ b/docs/atl/reference/com-plus-1-0-support-in-atl-projects.md @@ -4,10 +4,11 @@ title: "COM+ 1.0 Support in ATL Projects" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.ATL.MTS"] helpviewer_keywords: ["ATL projects, COM+ 1.0 support"] -ms.assetid: 51fb08ac-d632-4657-a4e0-d3f989f0b6f8 --- # COM+ 1.0 Support in ATL Projects +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + You can use the [ATL Project Wizard](../../atl/reference/creating-an-atl-project.md) to create a project with basic support for COM+ 1.0 components. COM+ 1.0 is designed for developing distributed component-based applications. It also provides a run-time infrastructure for deploying and managing these applications. diff --git a/docs/atl/reference/compiler-options-macros.md b/docs/atl/reference/compiler-options-macros.md index 4c80bb5d9bf..465fd84fab8 100644 --- a/docs/atl/reference/compiler-options-macros.md +++ b/docs/atl/reference/compiler-options-macros.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["compiler options, macros"] --- # Compiler Options Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros control specific compiler features. |Macro|Description| diff --git a/docs/atl/reference/composite-control-global-functions.md b/docs/atl/reference/composite-control-global-functions.md index b55042bb271..b14dc283be1 100644 --- a/docs/atl/reference/composite-control-global-functions.md +++ b/docs/atl/reference/composite-control-global-functions.md @@ -4,10 +4,11 @@ title: "Composite Control Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlhost/ATL::AtlAxDialogBox", "atlhost/ATL::AtlAxCreateDialog", "atlhost/ATL::AtlAxCreateControl", "atlhost/ATL::AtlAxCreateControlEx", "atlhost/ATL::AtlAxCreateControlLic", "atlhost/ATL::AtlAxCreateControlLicEx", "atlhost/ATL::AtlAxAttachControl", "atlhost/ATL::AtlAxGetHost", "atlhost/ATL::AtlAxGetControl", "atlhost/ATL::AtlSetChildSite", "atlhost/ATL::AtlAxWinInit", "atlhost/ATL::AtlAxWinTerm", "atlhost/ATL::AtlGetObjectSourceInterface"] helpviewer_keywords: ["composite controls, global functions"] -ms.assetid: 536884cd-e863-4c7a-ab0a-604dc60a0bbe --- # Composite Control Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide support for creating dialog boxes, and for creating, hosting and licensing ActiveX controls. > [!IMPORTANT] diff --git a/docs/atl/reference/composite-control-macros.md b/docs/atl/reference/composite-control-macros.md index 9721f16031c..94620901dbc 100644 --- a/docs/atl/reference/composite-control-macros.md +++ b/docs/atl/reference/composite-control-macros.md @@ -4,10 +4,11 @@ title: "Composite Control Macros" ms.date: "05/06/2019" f1_keywords: ["atlcom/ATL::BEGIN_SINK_MAP", "atlcom/ATL::END_SINK_MAP", "atlcom/ATL::SINK_ENTRY", "ATLCOM/BEGIN_SINK_MAP", "ATLCOM/END_SINK_MAP", "ATLCOM/SINK_ENTRY", "ATLCOM/SINK_ENTRY_EX", "ATLCOM/SINK_ENTRY_EX_P", "ATLCOM/SINK_ENTRY_INFO", "ATLCOM/SINK_ENTRY_INFO_P", "BEGIN_SINK_MAP", "END_SINK_MAP", "SINK_ENTRY", "SINK_ENTRY_EX", "SINK_ENTRY_EX_P", "SINK_ENTRY_INFO", "SINK_ENTRY_INFO_P"] helpviewer_keywords: ["composite controls, macros"] -ms.assetid: 17f2dd5e-07e6-4aa6-b965-7a361c78c45e --- # Composite Control Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define event sink maps and entries. |Macro|Description| diff --git a/docs/atl/reference/connection-point-global-functions.md b/docs/atl/reference/connection-point-global-functions.md index be49a8643a4..27a14e4ca41 100644 --- a/docs/atl/reference/connection-point-global-functions.md +++ b/docs/atl/reference/connection-point-global-functions.md @@ -4,10 +4,11 @@ title: "Connection Point Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlbase/ATL::AtlAdvise", "atlbase/ATL::AtlUnadvise", "atlbase/ATL::AtlAdviseSinkMap"] helpviewer_keywords: ["connection points [C++], global functions"] -ms.assetid: bcb4bf50-2155-4e20-b8bb-f2908b03a6e7 --- # Connection Point Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide support for connection points and sink maps. > [!IMPORTANT] diff --git a/docs/atl/reference/connection-point-macros.md b/docs/atl/reference/connection-point-macros.md index 490abb2c387..5bdfd5b0491 100644 --- a/docs/atl/reference/connection-point-macros.md +++ b/docs/atl/reference/connection-point-macros.md @@ -4,10 +4,11 @@ title: "Connection Point Macros" ms.date: "11/04/2016" f1_keywords: ["atlcom/ATL::BEGIN_CONNECTION_POINT_MAP", "atlcom/ATL::END_CONNECTION_POINT_MAP", "ATLCOM/BEGIN_CONNECTION_POINT_MAP", "ATLCOM/END_CONNECTION_POINT_MAP", "ATLCOM/CONNECTION_POINT_ENTRY", "ATLCOM/CONNECTION_POINT_ENTRY_P", "BEGIN_CONNECTION_POINT_MAP", "END_CONNECTION_POINT_MAP", "CONNECTION_POINT_ENTRY", "CONNECTION_POINT_ENTRY_P"] helpviewer_keywords: ["connection points [C++], macros"] -ms.assetid: cc3a6dd3-5538-45df-b027-1f34963c31e5 --- # Connection Point Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define connection point maps and entries. |Macro|Description| diff --git a/docs/atl/reference/cpatht-class.md b/docs/atl/reference/cpatht-class.md index 32b31a3db12..93adf44cd29 100644 --- a/docs/atl/reference/cpatht-class.md +++ b/docs/atl/reference/cpatht-class.md @@ -4,10 +4,11 @@ title: "CPathT Class" ms.date: "03/27/2019" f1_keywords: ["CPathT", "ATLPATH/ATL::CPathT", "ATLPATH/ATL::CPathT::PCXSTR", "ATLPATH/ATL::CPathT::PXSTR", "ATLPATH/ATL::CPathT::XCHAR", "ATLPATH/ATL::CPathT::CPathT", "ATLPATH/ATL::CPathT::AddBackslash", "ATLPATH/ATL::CPathT::AddExtension", "ATLPATH/ATL::CPathT::Append", "ATLPATH/ATL::CPathT::BuildRoot", "ATLPATH/ATL::CPathT::Canonicalize", "ATLPATH/ATL::CPathT::Combine", "ATLPATH/ATL::CPathT::CommonPrefix", "ATLPATH/ATL::CPathT::CompactPath", "ATLPATH/ATL::CPathT::CompactPathEx", "ATLPATH/ATL::CPathT::FileExists", "ATLPATH/ATL::CPathT::FindExtension", "ATLPATH/ATL::CPathT::FindFileName", "ATLPATH/ATL::CPathT::GetDriveNumber", "ATLPATH/ATL::CPathT::GetExtension", "ATLPATH/ATL::CPathT::IsDirectory", "ATLPATH/ATL::CPathT::IsFileSpec", "ATLPATH/ATL::CPathT::IsPrefix", "ATLPATH/ATL::CPathT::IsRelative", "ATLPATH/ATL::CPathT::IsRoot", "ATLPATH/ATL::CPathT::IsSameRoot", "ATLPATH/ATL::CPathT::IsUNC", "ATLPATH/ATL::CPathT::IsUNCServer", "ATLPATH/ATL::CPathT::IsUNCServerShare", "ATLPATH/ATL::CPathT::MakePretty", "ATLPATH/ATL::CPathT::MatchSpec", "ATLPATH/ATL::CPathT::QuoteSpaces", "ATLPATH/ATL::CPathT::RelativePathTo", "ATLPATH/ATL::CPathT::RemoveArgs", "ATLPATH/ATL::CPathT::RemoveBackslash", "ATLPATH/ATL::CPathT::RemoveBlanks", "ATLPATH/ATL::CPathT::RemoveExtension", "ATLPATH/ATL::CPathT::RemoveFileSpec", "ATLPATH/ATL::CPathT::RenameExtension", "ATLPATH/ATL::CPathT::SkipRoot", "ATLPATH/ATL::CPathT::StripPath", "ATLPATH/ATL::CPathT::StripToRoot", "ATLPATH/ATL::CPathT::UnquoteSpaces", "ATLPATH/ATL::CPathT::m_strPath"] helpviewer_keywords: ["CPathT class"] -ms.assetid: eba4137d-1fd2-4b44-a2e1-0944db64df3c --- # CPathT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a path. > [!IMPORTANT] diff --git a/docs/atl/reference/cprimitiveelementtraits-class.md b/docs/atl/reference/cprimitiveelementtraits-class.md index 7a0da283d47..efbb2c1caff 100644 --- a/docs/atl/reference/cprimitiveelementtraits-class.md +++ b/docs/atl/reference/cprimitiveelementtraits-class.md @@ -4,10 +4,11 @@ title: "CPrimitiveElementTraits Class" ms.date: "11/04/2016" f1_keywords: ["CPrimitiveElementTraits", "ATLCOLL/ATL::CPrimitiveElementTraits", "ATLCOLL/ATL::CPrimitiveElementTraits::INARGTYPE", "ATLCOLL/ATL::CPrimitiveElementTraits::OUTARGTYPE"] helpviewer_keywords: ["CPrimitiveElementTraits class"] -ms.assetid: 21c1cea8-2c5a-486c-b65c-85490f3ed4e6 --- # CPrimitiveElementTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides default methods and functions for a collection class composed of primitive data types. ## Syntax diff --git a/docs/atl/reference/cprivateobjectsecuritydesc-class.md b/docs/atl/reference/cprivateobjectsecuritydesc-class.md index 8d18a4cef84..b3e8123fd32 100644 --- a/docs/atl/reference/cprivateobjectsecuritydesc-class.md +++ b/docs/atl/reference/cprivateobjectsecuritydesc-class.md @@ -4,10 +4,11 @@ title: "CPrivateObjectSecurityDesc Class" ms.date: "11/04/2016" f1_keywords: ["CPrivateObjectSecurityDesc", "ATLSECURITY/ATL::CPrivateObjectSecurityDesc", "ATLSECURITY/ATL::CPrivateObjectSecurityDesc::CPrivateObjectSecurityDesc", "ATLSECURITY/ATL::CPrivateObjectSecurityDesc::ConvertToAutoInherit", "ATLSECURITY/ATL::CPrivateObjectSecurityDesc::Create", "ATLSECURITY/ATL::CPrivateObjectSecurityDesc::Get", "ATLSECURITY/ATL::CPrivateObjectSecurityDesc::Set"] helpviewer_keywords: ["CPrivateObjectSecurityDesc class"] -ms.assetid: 2c4bbb13-bf99-4833-912a-197f6815bb5d --- # CPrivateObjectSecurityDesc Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a private object security descriptor object. ## Syntax diff --git a/docs/atl/reference/crbmap-class.md b/docs/atl/reference/crbmap-class.md index 4617fc49e3c..3a09ccf6c49 100644 --- a/docs/atl/reference/crbmap-class.md +++ b/docs/atl/reference/crbmap-class.md @@ -4,10 +4,11 @@ title: "CRBMap Class" ms.date: "11/04/2016" f1_keywords: ["CRBMap", "ATLCOLL/ATL::CRBMap", "ATLCOLL/ATL::CRBMap::CRBMap", "ATLCOLL/ATL::CRBMap::Lookup", "ATLCOLL/ATL::CRBMap::RemoveKey", "ATLCOLL/ATL::CRBMap::SetAt"] helpviewer_keywords: ["CRBMap class"] -ms.assetid: 658e94dc-e835-4356-aed1-1513e1f66969 --- # CRBMap Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a mapping structure, using a Red-Black binary tree. ## Syntax diff --git a/docs/atl/reference/crbmultimap-class.md b/docs/atl/reference/crbmultimap-class.md index 3788491f6d5..c50ea797627 100644 --- a/docs/atl/reference/crbmultimap-class.md +++ b/docs/atl/reference/crbmultimap-class.md @@ -4,10 +4,11 @@ title: "CRBMultiMap Class" ms.date: "11/04/2016" f1_keywords: ["CRBMultiMap", "ATLCOLL/ATL::CRBMultiMap", "ATLCOLL/ATL::CRBMultiMap::CRBMultiMap", "ATLCOLL/ATL::CRBMultiMap::FindFirstWithKey", "ATLCOLL/ATL::CRBMultiMap::GetNextValueWithKey", "ATLCOLL/ATL::CRBMultiMap::GetNextWithKey", "ATLCOLL/ATL::CRBMultiMap::Insert", "ATLCOLL/ATL::CRBMultiMap::RemoveKey"] helpviewer_keywords: ["CRBMultiMap class"] -ms.assetid: 94d3ec0c-3e30-4ab7-a101-d8da4fb8add3 --- # CRBMultiMap Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a mapping structure that allows each key can be associated with more than one value, using a Red-Black binary tree. ## Syntax diff --git a/docs/atl/reference/crbtree-class.md b/docs/atl/reference/crbtree-class.md index 1b37d5c41ee..d755ed2a10c 100644 --- a/docs/atl/reference/crbtree-class.md +++ b/docs/atl/reference/crbtree-class.md @@ -4,10 +4,11 @@ title: "CRBTree Class" ms.date: "11/04/2016" f1_keywords: ["CRBTree", "ATLCOLL/ATL::CRBTree", "ATLCOLL/ATL::CRBTree::KINARGTYPE", "ATLCOLL/ATL::CRBTree::KOUTARGTYPE", "ATLCOLL/ATL::CRBTree::VINARGTYPE", "ATLCOLL/ATL::CRBTree::VOUTARGTYPE", "ATLCOLL/ATL::CRBTree::FindFirstKeyAfter", "ATLCOLL/ATL::CRBTree::GetAt", "ATLCOLL/ATL::CRBTree::GetCount", "ATLCOLL/ATL::CRBTree::GetHeadPosition", "ATLCOLL/ATL::CRBTree::GetKeyAt", "ATLCOLL/ATL::CRBTree::GetNext", "ATLCOLL/ATL::CRBTree::GetNextAssoc", "ATLCOLL/ATL::CRBTree::GetNextKey", "ATLCOLL/ATL::CRBTree::GetNextValue", "ATLCOLL/ATL::CRBTree::GetPrev", "ATLCOLL/ATL::CRBTree::GetTailPosition", "ATLCOLL/ATL::CRBTree::GetValueAt", "ATLCOLL/ATL::CRBTree::IsEmpty", "ATLCOLL/ATL::CRBTree::RemoveAll", "ATLCOLL/ATL::CRBTree::RemoveAt", "ATLCOLL/ATL::CRBTree::SetValueAt"] helpviewer_keywords: ["CRBTree class"] -ms.assetid: a1b1cb63-38e4-4fc2-bb28-f774d1721760 --- # CRBTree Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for creating and utilizing a Red-Black tree. ## Syntax diff --git a/docs/atl/reference/creating-an-atl-project.md b/docs/atl/reference/creating-an-atl-project.md index 0e82550faf9..2b8d1914bda 100644 --- a/docs/atl/reference/creating-an-atl-project.md +++ b/docs/atl/reference/creating-an-atl-project.md @@ -4,10 +4,11 @@ title: "Creating an ATL Project" ms.date: "05/06/2019" f1_keywords: ["vc.appwiz.ATL.project"] helpviewer_keywords: ["ATL projects, creating", "ATL70.DLL", "_ATL_MIN_CRT macro", "distributing files with ATL components"] -ms.assetid: 061d5f98-f669-440e-9380-42f017a0f9e8 --- # Creating an ATL Project +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + The easiest way to create an ATL project is to use the ATL Project Wizard, located in the **Win32 Projects** folder of the **New Project** dialog box. ## To create an ATL project using the ATL Project Wizard diff --git a/docs/atl/reference/cregkey-class.md b/docs/atl/reference/cregkey-class.md index 175495ad2e4..d2510be3e45 100644 --- a/docs/atl/reference/cregkey-class.md +++ b/docs/atl/reference/cregkey-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CRegKey class", "ATL, registry", "registry, deleting valu --- # `CRegKey` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for manipulating entries in the system registry. > [!IMPORTANT] diff --git a/docs/atl/reference/crtthreadtraits-class.md b/docs/atl/reference/crtthreadtraits-class.md index de1edbf63f5..3703ee3ee16 100644 --- a/docs/atl/reference/crtthreadtraits-class.md +++ b/docs/atl/reference/crtthreadtraits-class.md @@ -4,10 +4,11 @@ title: "CRTThreadTraits Class" ms.date: "11/04/2016" f1_keywords: ["CRTThreadTraits", "ATLBASE/ATL::CRTThreadTraits", "ATLBASE/ATL::CRTThreadTraits::CreateThread"] helpviewer_keywords: ["CRTThreadTraits class", "threading [ATL], creation functions", "threading [ATL], CRT threads"] -ms.assetid: eb6e20b0-c2aa-4170-8e34-aaeeacc86343 --- # CRTThreadTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides the creation function for a CRT thread. Use this class if the thread will use CRT functions. > [!IMPORTANT] diff --git a/docs/atl/reference/csacl-class.md b/docs/atl/reference/csacl-class.md index 47717cec068..12157beccdf 100644 --- a/docs/atl/reference/csacl-class.md +++ b/docs/atl/reference/csacl-class.md @@ -4,10 +4,11 @@ title: "CSacl Class" ms.date: "11/04/2016" f1_keywords: ["CSacl", "ATLSECURITY/ATL::CSacl", "ATLSECURITY/ATL::CSacl::CSacl", "ATLSECURITY/ATL::CSacl::AddAuditAce", "ATLSECURITY/ATL::CSacl::GetAceCount", "ATLSECURITY/ATL::CSacl::RemoveAce", "ATLSECURITY/ATL::CSacl::RemoveAllAces"] helpviewer_keywords: ["CSacl class"] -ms.assetid: 8624889b-aebc-4183-9d29-a20f07837f05 --- # CSacl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for a SACL (system access-control list) structure. > [!IMPORTANT] diff --git a/docs/atl/reference/csecurityattributes-class.md b/docs/atl/reference/csecurityattributes-class.md index 7ba2de9becc..ffb68f7fe43 100644 --- a/docs/atl/reference/csecurityattributes-class.md +++ b/docs/atl/reference/csecurityattributes-class.md @@ -4,10 +4,11 @@ title: "CSecurityAttributes Class" ms.date: "11/04/2016" f1_keywords: ["CSecurityAttributes", "ATLSECURITY/ATL::CSecurityAttributes", "ATLSECURITY/ATL::CSecurityAttributes::CSecurityAttributes", "ATLSECURITY/ATL::CSecurityAttributes::Set"] helpviewer_keywords: ["CSecurityAttributes class"] -ms.assetid: a094880c-52e1-4a28-97ff-752d5869908e --- # CSecurityAttributes Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a thin wrapper for the security attributes structure. > [!IMPORTANT] diff --git a/docs/atl/reference/csecuritydesc-class.md b/docs/atl/reference/csecuritydesc-class.md index d5042907684..67f652293ec 100644 --- a/docs/atl/reference/csecuritydesc-class.md +++ b/docs/atl/reference/csecuritydesc-class.md @@ -4,10 +4,11 @@ title: "CSecurityDesc Class" ms.date: "11/04/2016" f1_keywords: ["CSecurityDesc", "ATLSECURITY/ATL::CSecurityDesc", "ATLSECURITY/ATL::CSecurityDesc::CSecurityDesc", "ATLSECURITY/ATL::CSecurityDesc::FromString", "ATLSECURITY/ATL::CSecurityDesc::GetControl", "ATLSECURITY/ATL::CSecurityDesc::GetDacl", "ATLSECURITY/ATL::CSecurityDesc::GetGroup", "ATLSECURITY/ATL::CSecurityDesc::GetOwner", "ATLSECURITY/ATL::CSecurityDesc::GetPSECURITY_DESCRIPTOR", "ATLSECURITY/ATL::CSecurityDesc::GetSacl", "ATLSECURITY/ATL::CSecurityDesc::IsDaclAutoInherited", "ATLSECURITY/ATL::CSecurityDesc::IsDaclDefaulted", "ATLSECURITY/ATL::CSecurityDesc::IsDaclPresent", "ATLSECURITY/ATL::CSecurityDesc::IsDaclProtected", "ATLSECURITY/ATL::CSecurityDesc::IsGroupDefaulted", "ATLSECURITY/ATL::CSecurityDesc::IsOwnerDefaulted", "ATLSECURITY/ATL::CSecurityDesc::IsSaclAutoInherited", "ATLSECURITY/ATL::CSecurityDesc::IsSaclDefaulted", "ATLSECURITY/ATL::CSecurityDesc::IsSaclPresent", "ATLSECURITY/ATL::CSecurityDesc::IsSaclProtected", "ATLSECURITY/ATL::CSecurityDesc::IsSelfRelative", "ATLSECURITY/ATL::CSecurityDesc::MakeAbsolute", "ATLSECURITY/ATL::CSecurityDesc::MakeSelfRelative", "ATLSECURITY/ATL::CSecurityDesc::SetControl", "ATLSECURITY/ATL::CSecurityDesc::SetDacl", "ATLSECURITY/ATL::CSecurityDesc::SetGroup", "ATLSECURITY/ATL::CSecurityDesc::SetOwner", "ATLSECURITY/ATL::CSecurityDesc::SetSacl", "ATLSECURITY/ATL::CSecurityDesc::ToString"] helpviewer_keywords: ["CSecurityDesc class"] -ms.assetid: 3767a327-378f-4690-ba40-4d9f6a1f5ee4 --- # CSecurityDesc Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for the `SECURITY_DESCRIPTOR` structure. > [!IMPORTANT] diff --git a/docs/atl/reference/csid-class.md b/docs/atl/reference/csid-class.md index 49be86aa613..064eaa6ad79 100644 --- a/docs/atl/reference/csid-class.md +++ b/docs/atl/reference/csid-class.md @@ -4,10 +4,11 @@ title: "CSid class" ms.date: "03/27/2019" f1_keywords: ["CSid", "ATLSECURITY/ATL::CSid", "ATLSECURITY/ATL::CSid::CSidArray", "ATLSECURITY/ATL::CSid::CSid", "ATLSECURITY/ATL::CSid::AccountName", "ATLSECURITY/ATL::CSid::Domain", "ATLSECURITY/ATL::CSid::EqualPrefix", "ATLSECURITY/ATL::CSid::GetLength", "ATLSECURITY/ATL::CSid::GetPSID", "ATLSECURITY/ATL::CSid::GetPSID_IDENTIFIER_AUTHORITY", "ATLSECURITY/ATL::CSid::GetSubAuthority", "ATLSECURITY/ATL::CSid::GetSubAuthorityCount", "ATLSECURITY/ATL::CSid::IsValid", "ATLSECURITY/ATL::CSid::LoadAccount", "ATLSECURITY/ATL::CSid::Sid", "ATLSECURITY/ATL::CSid::SidNameUse"] helpviewer_keywords: ["CSid class"] -ms.assetid: be58b7ca-5958-49c3-a833-ca341aaaf753 --- # `CSid` class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for a `SID` (security identifier) structure. > [!IMPORTANT] diff --git a/docs/atl/reference/csimplearray-class.md b/docs/atl/reference/csimplearray-class.md index 12a7cd13323..c9393a904da 100644 --- a/docs/atl/reference/csimplearray-class.md +++ b/docs/atl/reference/csimplearray-class.md @@ -4,10 +4,11 @@ title: "CSimpleArray Class" ms.date: "11/04/2016" f1_keywords: ["CSimpleArray", "ATLSIMPCOLL/ATL::CSimpleArray", "ATLSIMPCOLL/ATL::CSimpleArray::CSimpleArray", "ATLSIMPCOLL/ATL::CSimpleArray::Add", "ATLSIMPCOLL/ATL::CSimpleArray::Find", "ATLSIMPCOLL/ATL::CSimpleArray::GetData", "ATLSIMPCOLL/ATL::CSimpleArray::GetSize", "ATLSIMPCOLL/ATL::CSimpleArray::Remove", "ATLSIMPCOLL/ATL::CSimpleArray::RemoveAll", "ATLSIMPCOLL/ATL::CSimpleArray::RemoveAt", "ATLSIMPCOLL/ATL::CSimpleArray::SetAtIndex"] helpviewer_keywords: ["CSimpleArray class"] -ms.assetid: ee0c9f39-b61c-4c18-bc43-4eada21dca3a --- # CSimpleArray Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for managing a simple array. ## Syntax diff --git a/docs/atl/reference/csimplearrayequalhelper-class.md b/docs/atl/reference/csimplearrayequalhelper-class.md index e88c64cd44f..dd20404054a 100644 --- a/docs/atl/reference/csimplearrayequalhelper-class.md +++ b/docs/atl/reference/csimplearrayequalhelper-class.md @@ -4,10 +4,11 @@ title: "CSimpleArrayEqualHelper Class" ms.date: "11/04/2016" f1_keywords: ["CSimpleArrayEqualHelper", "ATLSIMPCOLL/ATL::CSimpleArrayEqualHelper", "ATLSIMPCOLL/ATL::CSimpleArrayEqualHelper::IsEqual"] helpviewer_keywords: ["CSimpleArrayEqualHelper class"] -ms.assetid: a2b55d89-78c9-42ef-842c-5304c6d20ad6 --- # CSimpleArrayEqualHelper Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a helper for the [CSimpleArray](../../atl/reference/csimplearray-class.md) class. ## Syntax diff --git a/docs/atl/reference/csimplearrayequalhelperfalse-class.md b/docs/atl/reference/csimplearrayequalhelperfalse-class.md index 9b66910ec4e..36ad6022a6d 100644 --- a/docs/atl/reference/csimplearrayequalhelperfalse-class.md +++ b/docs/atl/reference/csimplearrayequalhelperfalse-class.md @@ -4,10 +4,11 @@ title: "CSimpleArrayEqualHelperFalse Class" ms.date: "11/04/2016" f1_keywords: ["CSimpleArrayEqualHelperFalse", "ATLSIMPCOLL/ATL::CSimpleArrayEqualHelperFalse", "ATLSIMPCOLL/ATL::CSimpleArrayEqualHelperFalse::IsEqual"] helpviewer_keywords: ["CSimpleArrayEqualHelperFalse class"] -ms.assetid: 6918af6f-d23d-49eb-8482-c44272f5ffeb --- # CSimpleArrayEqualHelperFalse Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a helper for the [CSimpleArray](../../atl/reference/csimplearray-class.md) class. ## Syntax diff --git a/docs/atl/reference/csimpledialog-class.md b/docs/atl/reference/csimpledialog-class.md index 9650d3ce7c3..ea993e768cc 100644 --- a/docs/atl/reference/csimpledialog-class.md +++ b/docs/atl/reference/csimpledialog-class.md @@ -4,10 +4,11 @@ title: "CSimpleDialog Class" ms.date: "11/04/2016" f1_keywords: ["CSimpleDialog", "ATLWIN/ATL::CSimpleDialog", "ATLWIN/ATL::CSimpleDialog::DoModal"] helpviewer_keywords: ["CSimpleDialog class", "CSimpleDialog class, modal dialog boxes in ATL", "dialog boxes, modal", "modal dialog boxes, ATL"] -ms.assetid: 2ae65cc9-4f32-4168-aecd-200b4a480fdf --- # CSimpleDialog Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements a basic modal dialog box. ## Syntax diff --git a/docs/atl/reference/csimplemap-class.md b/docs/atl/reference/csimplemap-class.md index 50f20403759..ce0d4f90990 100644 --- a/docs/atl/reference/csimplemap-class.md +++ b/docs/atl/reference/csimplemap-class.md @@ -4,10 +4,11 @@ title: "CSimpleMap Class" ms.date: "11/04/2016" f1_keywords: ["CSimpleMap", "ATLSIMPCOLL/ATL::CSimpleMap", "ATLSIMPCOLL/ATL::CSimpleMap::_ArrayElementType", "ATLSIMPCOLL/ATL::CSimpleMap::_ArrayKeyType", "ATLSIMPCOLL/ATL::CSimpleMap::CSimpleMap", "ATLSIMPCOLL/ATL::CSimpleMap::Add", "ATLSIMPCOLL/ATL::CSimpleMap::FindKey", "ATLSIMPCOLL/ATL::CSimpleMap::FindVal", "ATLSIMPCOLL/ATL::CSimpleMap::GetKeyAt", "ATLSIMPCOLL/ATL::CSimpleMap::GetSize", "ATLSIMPCOLL/ATL::CSimpleMap::GetValueAt", "ATLSIMPCOLL/ATL::CSimpleMap::Lookup", "ATLSIMPCOLL/ATL::CSimpleMap::Remove", "ATLSIMPCOLL/ATL::CSimpleMap::RemoveAll", "ATLSIMPCOLL/ATL::CSimpleMap::RemoveAt", "ATLSIMPCOLL/ATL::CSimpleMap::ReverseLookup", "ATLSIMPCOLL/ATL::CSimpleMap::SetAt", "ATLSIMPCOLL/ATL::CSimpleMap::SetAtIndex"] helpviewer_keywords: ["CSimpleMap class"] -ms.assetid: 61b06eb4-ae73-44b0-a305-0afb5a33e8b1 --- # CSimpleMap Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides support for a simple mapping array. ## Syntax diff --git a/docs/atl/reference/csimplemapequalhelper-class.md b/docs/atl/reference/csimplemapequalhelper-class.md index 05c3178fdaa..ad384ff61db 100644 --- a/docs/atl/reference/csimplemapequalhelper-class.md +++ b/docs/atl/reference/csimplemapequalhelper-class.md @@ -4,10 +4,11 @@ title: "CSimpleMapEqualHelper Class" ms.date: "11/04/2016" f1_keywords: ["CSimpleMapEqualHelper", "ATLSIMPCOLL/ATL::CSimpleMapEqualHelper", "ATLSIMPCOLL/ATL::CSimpleMapEqualHelper::IsEqualKey", "ATLSIMPCOLL/ATL::CSimpleMapEqualHelper::IsEqualValue"] helpviewer_keywords: ["CSimpleMapEqualHelper class"] -ms.assetid: 9bb2968a-d609-405c-8272-ff3b42df6164 --- # CSimpleMapEqualHelper Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a helper for the [CSimpleMap](../../atl/reference/csimplemap-class.md) class. ## Syntax From 72cd28e08148a86ee9dffd73f88ec05e7343c0c4 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 25 Feb 2026 15:03:48 -0800 Subject: [PATCH 1664/1799] ATL batch 4: docs updates (files 295-394) --- docs/atl/reference/csimplemapequalhelperfalse-class.md | 3 ++- docs/atl/reference/csnapinitemimpl-class.md | 3 ++- docs/atl/reference/csnapinpropertypageimpl-class.md | 2 ++ docs/atl/reference/csocketaddr-class.md | 3 ++- docs/atl/reference/cstockpropimpl-class.md | 2 ++ docs/atl/reference/cstringelementtraits-class.md | 3 ++- docs/atl/reference/cstringelementtraitsi-class.md | 3 ++- docs/atl/reference/cstringrefelementtraits-class.md | 3 ++- docs/atl/reference/cthreadpool-class.md | 2 ++ docs/atl/reference/ctokengroups-class.md | 3 ++- docs/atl/reference/ctokenprivileges-class.md | 3 ++- docs/atl/reference/curl-class.md | 3 ++- docs/atl/reference/cw2aex-class.md | 2 ++ docs/atl/reference/cw2cwex-class.md | 3 ++- docs/atl/reference/cw2wex-class.md | 2 ++ docs/atl/reference/cwin32heap-class.md | 3 ++- docs/atl/reference/cwindow-class.md | 2 ++ docs/atl/reference/cwindowimpl-class.md | 3 ++- docs/atl/reference/cwintraits-class.md | 3 ++- docs/atl/reference/cwintraitsor-class.md | 3 ++- docs/atl/reference/cwndclassinfo-class.md | 3 ++- docs/atl/reference/cworkerthread-class.md | 3 ++- .../debugging-and-error-reporting-global-functions.md | 3 ++- docs/atl/reference/debugging-and-error-reporting-macros.md | 3 ++- docs/atl/reference/default-atl-project-configurations.md | 3 ++- docs/atl/reference/device-context-global-functions.md | 3 ++- docs/atl/reference/event-handling-global-functions.md | 3 ++- docs/atl/reference/exception-handling-macros.md | 3 ++- docs/atl/reference/iatlautothreadmodule-class.md | 3 ++- docs/atl/reference/iatlmemmgr-class.md | 3 ++- docs/atl/reference/iaxwinambientdispatch-interface.md | 3 ++- docs/atl/reference/iaxwinambientdispatchex-interface.md | 3 ++- docs/atl/reference/iaxwinhostwindow-interface.md | 3 ++- docs/atl/reference/iaxwinhostwindowlic-interface.md | 3 ++- docs/atl/reference/icollectiononstlimpl-class.md | 3 ++- docs/atl/reference/iconnectionpointcontainerimpl-class.md | 3 ++- docs/atl/reference/iconnectionpointimpl-class.md | 3 ++- docs/atl/reference/idataobjectimpl-class.md | 3 ++- docs/atl/reference/idispatchimpl-class.md | 3 ++- docs/atl/reference/idispeventimpl-class.md | 2 ++ docs/atl/reference/idispeventsimpleimpl-class.md | 3 ++- docs/atl/reference/idochostuihandlerdispatch-interface.md | 3 ++- docs/atl/reference/ienumonstlimpl-class.md | 3 ++- docs/atl/reference/interfaces-atl-control-wizard.md | 3 ++- docs/atl/reference/iobjectsafetyimpl-class.md | 3 ++- docs/atl/reference/iobjectwithsiteimpl-class.md | 3 ++- docs/atl/reference/iolecontrolimpl-class.md | 2 ++ docs/atl/reference/ioleinplaceactiveobjectimpl-class.md | 3 ++- docs/atl/reference/ioleinplaceobjectwindowlessimpl-class.md | 3 ++- docs/atl/reference/ioleobjectimpl-class.md | 3 ++- docs/atl/reference/iperpropertybrowsingimpl-class.md | 3 ++- docs/atl/reference/ipersistpropertybagimpl-class.md | 3 ++- docs/atl/reference/ipersiststorageimpl-class.md | 2 ++ docs/atl/reference/ipersiststreaminitimpl-class.md | 3 ++- docs/atl/reference/ipointerinactiveimpl-class.md | 3 ++- docs/atl/reference/ipropertynotifysinkcp-class.md | 3 ++- docs/atl/reference/ipropertypage2impl-class.md | 3 ++- docs/atl/reference/ipropertypageimpl-class.md | 3 ++- docs/atl/reference/iprovideclassinfo2impl-class.md | 3 ++- docs/atl/reference/iquickactivateimpl-class.md | 3 ++- docs/atl/reference/iregistrar-class.md | 3 ++- docs/atl/reference/irunnableobjectimpl-class.md | 3 ++- docs/atl/reference/iserviceproviderimpl-class.md | 3 ++- docs/atl/reference/ispecifypropertypagesimpl-class.md | 3 ++- docs/atl/reference/isupporterrorinfoimpl-class.md | 3 ++- docs/atl/reference/ithreadpoolconfig-interface.md | 3 ++- docs/atl/reference/iviewobjecteximpl-class.md | 3 ++- docs/atl/reference/iworkerthreadclient-interface.md | 3 ++- docs/atl/reference/making-an-atl-object-noncreatable.md | 3 ++- docs/atl/reference/marshaling-global-functions.md | 3 ++- docs/atl/reference/message-map-macros-atl.md | 3 ++- docs/atl/reference/mfc-support-in-atl-projects.md | 3 ++- docs/atl/reference/object-map-macros.md | 3 ++- docs/atl/reference/object-status-macros.md | 3 ++- .../options-atl-active-server-page-component-wizard.md | 3 ++- docs/atl/reference/options-atl-control-wizard.md | 3 ++- docs/atl/reference/options-atl-property-page-wizard.md | 3 ++- docs/atl/reference/options-atl-simple-object-wizard.md | 3 ++- .../reference/pixel-himetric-conversion-global-functions.md | 3 ++- docs/atl/reference/property-map-macros.md | 3 ++- docs/atl/reference/registry-and-typelib-global-functions.md | 3 ++- docs/atl/reference/registry-data-exchange-macros.md | 3 ++- docs/atl/reference/registry-macros.md | 3 ++- docs/atl/reference/security-global-functions.md | 3 ++- docs/atl/reference/security-identifier-global-functions.md | 3 ++- docs/atl/reference/server-registration-global-functions.md | 3 ++- docs/atl/reference/service-map-macros.md | 3 ++- docs/atl/reference/snap-in-object-macros.md | 3 ++- .../specifying-compiler-optimization-for-an-atl-project.md | 3 ++- docs/atl/reference/stock-properties-atl-control-wizard.md | 3 ++- docs/atl/reference/string-conversion-macros.md | 3 ++- docs/atl/reference/strings-atl-property-page-wizard.md | 3 ++- docs/atl/reference/u-menuorid-class.md | 3 ++- docs/atl/reference/u-rect-class.md | 3 ++- docs/atl/reference/u-stringorid-class.md | 3 ++- docs/atl/reference/win32threadtraits-class.md | 3 ++- docs/atl/reference/window-class-macros.md | 3 ++- docs/atl/reference/windows-messages-macros.md | 3 ++- docs/atl/reference/winmodule-global-functions.md | 3 ++- docs/atl/reference/worker-archetype.md | 3 ++- 100 files changed, 200 insertions(+), 91 deletions(-) diff --git a/docs/atl/reference/csimplemapequalhelperfalse-class.md b/docs/atl/reference/csimplemapequalhelperfalse-class.md index 97e43c2e59e..0be6f6a9539 100644 --- a/docs/atl/reference/csimplemapequalhelperfalse-class.md +++ b/docs/atl/reference/csimplemapequalhelperfalse-class.md @@ -4,10 +4,11 @@ title: "CSimpleMapEqualHelperFalse Class" ms.date: "11/04/2016" f1_keywords: ["CSimpleMapEqualHelperFalse", "ATLSIMPCOLL/ATL::CSimpleMapEqualHelperFalse", "ATLSIMPCOLL/ATL::CSimpleMapEqualHelperFalse::IsEqualKey", "ATLSIMPCOLL/ATL::CSimpleMapEqualHelperFalse::IsEqualValue"] helpviewer_keywords: ["CSimpleMapEqualHelperFalse class"] -ms.assetid: a873eea3-e130-45cc-a476-61ee79511c3b --- # CSimpleMapEqualHelperFalse Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a helper for the [CSimpleMap](../../atl/reference/csimplemap-class.md) class. ## Syntax diff --git a/docs/atl/reference/csnapinitemimpl-class.md b/docs/atl/reference/csnapinitemimpl-class.md index b302a376c2c..b9c745e5ff1 100644 --- a/docs/atl/reference/csnapinitemimpl-class.md +++ b/docs/atl/reference/csnapinitemimpl-class.md @@ -4,10 +4,11 @@ title: "CSnapInItemImpl Class" ms.date: "11/04/2016" f1_keywords: ["CSnapInItemImpl", "ATLSNAP/ATL::CSnapInItemImpl", "ATLSNAP/ATL::CSnapInItemImpl::CSnapInItemImpl", "ATLSNAP/ATL::CSnapInItemImpl::AddMenuItems", "ATLSNAP/ATL::CSnapInItemImpl::Command", "ATLSNAP/ATL::CSnapInItemImpl::CreatePropertyPages", "ATLSNAP/ATL::CSnapInItemImpl::FillData", "ATLSNAP/ATL::CSnapInItemImpl::GetResultPaneInfo", "ATLSNAP/ATL::CSnapInItemImpl::GetResultViewType", "ATLSNAP/ATL::CSnapInItemImpl::GetScopePaneInfo", "ATLSNAP/ATL::CSnapInItemImpl::Notify", "ATLSNAP/ATL::CSnapInItemImpl::QueryPagesFor", "ATLSNAP/ATL::CSnapInItemImpl::SetMenuInsertionFlags", "ATLSNAP/ATL::CSnapInItemImpl::SetToolbarButtonInfo", "ATLSNAP/ATL::CSnapInItemImpl::UpdateMenuState", "ATLSNAP/ATL::CSnapInItemImpl::UpdateToolbarButton", "ATLSNAP/ATL::CSnapInItemImpl::m_bstrDisplayName", "ATLSNAP/ATL::CSnapInItemImpl::m_resultDataItem", "ATLSNAP/ATL::CSnapInItemImpl::m_scopeDataItem"] helpviewer_keywords: ["snap-ins, data items", "snap-ins, ATL support for", "CSnapInItemImpl class", "snap-ins"] -ms.assetid: 52caefbd-9eae-49b0-add2-d55524271aa7 --- # CSnapInItemImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for implementing a snap-in node object. > [!IMPORTANT] diff --git a/docs/atl/reference/csnapinpropertypageimpl-class.md b/docs/atl/reference/csnapinpropertypageimpl-class.md index e7cd51b1c78..ab78fc1e15c 100644 --- a/docs/atl/reference/csnapinpropertypageimpl-class.md +++ b/docs/atl/reference/csnapinpropertypageimpl-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["snap-ins, property pages", "snap-ins", "property pages, A --- # CSnapInPropertyPageImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for implementing a snap-in property page object. > [!IMPORTANT] diff --git a/docs/atl/reference/csocketaddr-class.md b/docs/atl/reference/csocketaddr-class.md index de051c6ae62..5a186823dce 100644 --- a/docs/atl/reference/csocketaddr-class.md +++ b/docs/atl/reference/csocketaddr-class.md @@ -4,10 +4,11 @@ title: "CSocketAddr Class" ms.date: "10/22/2018" f1_keywords: ["CSocketAddr", "ATLSOCKET/ATL::CSocketAddr", "ATLSOCKET/ATL::CSocketAddr::CSocketAddr", "ATLSOCKET/ATL::CSocketAddr::FindAddr", "ATLSOCKET/ATL::CSocketAddr::FindINET4Addr", "ATLSOCKET/ATL::CSocketAddr::FindINET6Addr", "ATLSOCKET/ATL::CSocketAddr::GetAddrInfo", "ATLSOCKET/ATL::CSocketAddr::GetAddrInfoList"] helpviewer_keywords: ["CSocketAddr class"] -ms.assetid: 2fb2d8a7-899e-4a36-a342-cc9f4fcdd68c --- # CSocketAddr Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for converting host names to host addresses, supporting both IPv4 and IPV6 formats. ## Syntax diff --git a/docs/atl/reference/cstockpropimpl-class.md b/docs/atl/reference/cstockpropimpl-class.md index 1f4959941f7..0b5fc8d9fc6 100644 --- a/docs/atl/reference/cstockpropimpl-class.md +++ b/docs/atl/reference/cstockpropimpl-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CStockPropImpl class", "controls [ATL], stock properties" --- # CStockPropImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for supporting stock property values. > [!IMPORTANT] diff --git a/docs/atl/reference/cstringelementtraits-class.md b/docs/atl/reference/cstringelementtraits-class.md index d314865a597..93cb8ccf5a2 100644 --- a/docs/atl/reference/cstringelementtraits-class.md +++ b/docs/atl/reference/cstringelementtraits-class.md @@ -4,10 +4,11 @@ title: "CStringElementTraits Class" ms.date: "11/04/2016" f1_keywords: ["CStringElementTraits", "CSTRINGT/ATL::CStringElementTraits", "CSTRINGT/ATL::CStringElementTraits::INARGTYPE", "CSTRINGT/ATL::CStringElementTraits::OUTARGTYPE", "CSTRINGT/ATL::CStringElementTraits::CompareElements", "CSTRINGT/ATL::CStringElementTraits::CompareElementsOrdered", "CSTRINGT/ATL::CStringElementTraits::CopyElements", "CSTRINGT/ATL::CStringElementTraits::Hash", "CSTRINGT/ATL::CStringElementTraits::RelocateElements"] helpviewer_keywords: ["CStringElementTraits class"] -ms.assetid: 74d7134b-099d-4455-bf91-3e68ccbf95bc --- # CStringElementTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides static functions used by collection classes storing `CString` objects. ## Syntax diff --git a/docs/atl/reference/cstringelementtraitsi-class.md b/docs/atl/reference/cstringelementtraitsi-class.md index 089e89ec285..41f472f6925 100644 --- a/docs/atl/reference/cstringelementtraitsi-class.md +++ b/docs/atl/reference/cstringelementtraitsi-class.md @@ -4,10 +4,11 @@ title: "CStringElementTraitsI Class" ms.date: "11/04/2016" f1_keywords: ["CStringElementTraitsI", "ATLCOLL/ATL::CStringElementTraitsI", "ATLCOLL/ATL::CStringElementTraitsI::INARGTYPE", "ATLCOLL/ATL::CStringElementTraitsI::OUTARGTYPE", "ATLCOLL/ATL::CStringElementTraitsI::CompareElements", "ATLCOLL/ATL::CStringElementTraitsI::CompareElementsOrdered", "ATLCOLL/ATL::CStringElementTraitsI::Hash"] helpviewer_keywords: ["CStringElementTraitsI class"] -ms.assetid: c23f92b1-91e5-400f-96ed-258b02622b7a --- # CStringElementTraitsI Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides static functions related to strings stored in collection class objects. It is similar to [CStringElementTraits](../../atl/reference/cstringelementtraits-class.md), but performs case-insensitive comparisons. ## Syntax diff --git a/docs/atl/reference/cstringrefelementtraits-class.md b/docs/atl/reference/cstringrefelementtraits-class.md index ed14c61490e..1973a6ed2fb 100644 --- a/docs/atl/reference/cstringrefelementtraits-class.md +++ b/docs/atl/reference/cstringrefelementtraits-class.md @@ -4,10 +4,11 @@ title: "CStringRefElementTraits Class" ms.date: "11/04/2016" f1_keywords: ["CStringRefElementTraits", "ATLCOLL/ATL::CStringRefElementTraits", "ATLCOLL/ATL::CStringRefElementTraits::CompareElements", "ATLCOLL/ATL::CStringRefElementTraits::CompareElementsOrdered", "ATLCOLL/ATL::CStringRefElementTraits::Hash"] helpviewer_keywords: ["CStringRefElementTraits class"] -ms.assetid: cc15062d-5627-46cc-ac2b-1744afdc2dbd --- # CStringRefElementTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides static functions related to strings stored in collection class objects. The string objects are dealt with as references. ## Syntax diff --git a/docs/atl/reference/cthreadpool-class.md b/docs/atl/reference/cthreadpool-class.md index 0cca6b473fa..a9760e62914 100644 --- a/docs/atl/reference/cthreadpool-class.md +++ b/docs/atl/reference/cthreadpool-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CThreadPool class"] --- # CThreadPool Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a pool of worker threads that process a queue of work items. ## Syntax diff --git a/docs/atl/reference/ctokengroups-class.md b/docs/atl/reference/ctokengroups-class.md index 50ca0053c9b..08dfba3fbf9 100644 --- a/docs/atl/reference/ctokengroups-class.md +++ b/docs/atl/reference/ctokengroups-class.md @@ -4,10 +4,11 @@ title: "CTokenGroups Class" ms.date: "11/04/2016" f1_keywords: ["CTokenGroups", "ATLSECURITY/ATL::CTokenGroups", "ATLSECURITY/ATL::CTokenGroups::CTokenGroups", "ATLSECURITY/ATL::CTokenGroups::Add", "ATLSECURITY/ATL::CTokenGroups::Delete", "ATLSECURITY/ATL::CTokenGroups::DeleteAll", "ATLSECURITY/ATL::CTokenGroups::GetCount", "ATLSECURITY/ATL::CTokenGroups::GetLength", "ATLSECURITY/ATL::CTokenGroups::GetPTOKEN_GROUPS", "ATLSECURITY/ATL::CTokenGroups::GetSidsAndAttributes", "ATLSECURITY/ATL::CTokenGroups::LookupSid"] helpviewer_keywords: ["CTokenGroups class"] -ms.assetid: 2ab08076-4b08-4487-bc70-ec6dee304190 --- # CTokenGroups Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for the `TOKEN_GROUPS` structure. > [!IMPORTANT] diff --git a/docs/atl/reference/ctokenprivileges-class.md b/docs/atl/reference/ctokenprivileges-class.md index df23437d13c..43abc2e7c6c 100644 --- a/docs/atl/reference/ctokenprivileges-class.md +++ b/docs/atl/reference/ctokenprivileges-class.md @@ -4,10 +4,11 @@ title: "CTokenPrivileges Class" ms.date: "11/04/2016" f1_keywords: ["CTokenPrivileges", "ATLSECURITY/ATL::CTokenPrivileges", "ATLSECURITY/ATL::CTokenPrivileges::CTokenPrivileges", "ATLSECURITY/ATL::CTokenPrivileges::Add", "ATLSECURITY/ATL::CTokenPrivileges::Delete", "ATLSECURITY/ATL::CTokenPrivileges::DeleteAll", "ATLSECURITY/ATL::CTokenPrivileges::GetCount", "ATLSECURITY/ATL::CTokenPrivileges::GetDisplayNames", "ATLSECURITY/ATL::CTokenPrivileges::GetLength", "ATLSECURITY/ATL::CTokenPrivileges::GetLuidsAndAttributes", "ATLSECURITY/ATL::CTokenPrivileges::GetNamesAndAttributes", "ATLSECURITY/ATL::CTokenPrivileges::GetPTOKEN_PRIVILEGES", "ATLSECURITY/ATL::CTokenPrivileges::LookupPrivilege"] helpviewer_keywords: ["CTokenPrivileges class"] -ms.assetid: 89590105-f001-4014-870d-142926091231 --- # CTokenPrivileges Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is a wrapper for the `TOKEN_PRIVILEGES` structure. > [!IMPORTANT] diff --git a/docs/atl/reference/curl-class.md b/docs/atl/reference/curl-class.md index ff1a201f3fc..1676b7244ed 100644 --- a/docs/atl/reference/curl-class.md +++ b/docs/atl/reference/curl-class.md @@ -4,10 +4,11 @@ title: "CUrl Class" ms.date: "05/06/2019" f1_keywords: ["CUrl", "ATLUTIL/ATL::CUrl", "ATLUTIL/ATL::CUrl::CUrl", "ATLUTIL/ATL::CUrl::Canonicalize", "ATLUTIL/ATL::CUrl::Clear", "ATLUTIL/ATL::CUrl::CrackUrl", "ATLUTIL/ATL::CUrl::CreateUrl", "ATLUTIL/ATL::CUrl::GetExtraInfo", "ATLUTIL/ATL::CUrl::GetExtraInfoLength", "ATLUTIL/ATL::CUrl::GetHostName", "ATLUTIL/ATL::CUrl::GetHostNameLength", "ATLUTIL/ATL::CUrl::GetPassword", "ATLUTIL/ATL::CUrl::GetPasswordLength", "ATLUTIL/ATL::CUrl::GetPortNumber", "ATLUTIL/ATL::CUrl::GetScheme", "ATLUTIL/ATL::CUrl::GetSchemeName", "ATLUTIL/ATL::CUrl::GetSchemeNameLength", "ATLUTIL/ATL::CUrl::GetUrlLength", "ATLUTIL/ATL::CUrl::GetUrlPath", "ATLUTIL/ATL::CUrl::GetUrlPathLength", "ATLUTIL/ATL::CUrl::GetUserName", "ATLUTIL/ATL::CUrl::GetUserNameLength", "ATLUTIL/ATL::CUrl::SetExtraInfo", "ATLUTIL/ATL::CUrl::SetHostName", "ATLUTIL/ATL::CUrl::SetPassword", "ATLUTIL/ATL::CUrl::SetPortNumber", "ATLUTIL/ATL::CUrl::SetScheme", "ATLUTIL/ATL::CUrl::SetSchemeName", "ATLUTIL/ATL::CUrl::SetUrlPath", "ATLUTIL/ATL::CUrl::SetUserName"] helpviewer_keywords: ["CUrl class"] -ms.assetid: b3894d34-47b9-4961-9719-4197153793da --- # CUrl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a URL. It allows you to manipulate each element of the URL independently of the others whether parsing an existing URL string or building a string from scratch. > [!IMPORTANT] diff --git a/docs/atl/reference/cw2aex-class.md b/docs/atl/reference/cw2aex-class.md index 9029cccbe76..ef2b3d63263 100644 --- a/docs/atl/reference/cw2aex-class.md +++ b/docs/atl/reference/cw2aex-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CW2AEX class"] --- # `CW2AEX` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is used by the string conversion macros `CT2AEX`, `CW2TEX`, `CW2CTEX`, and `CT2CAEX`, and the typedef `CW2A`. > [!IMPORTANT] diff --git a/docs/atl/reference/cw2cwex-class.md b/docs/atl/reference/cw2cwex-class.md index 58df28f8f63..c00e6ef2143 100644 --- a/docs/atl/reference/cw2cwex-class.md +++ b/docs/atl/reference/cw2cwex-class.md @@ -4,10 +4,11 @@ title: "CW2CWEX Class" ms.date: "11/04/2016" f1_keywords: ["CW2CWEX", "ATLCONV/ATL::CW2CWEX", "ATLCONV/ATL::CW2CWEX::CW2CWEX", "ATLCONV/ATL::CW2CWEX::m_psz"] helpviewer_keywords: ["CW2CWEX class"] -ms.assetid: d654b22b-05a6-410f-a0ec-9a2cbbb4cca7 --- # CW2CWEX Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is used by the string conversion macros CW2CTEX and CT2CWEX, and the typedef CW2W. > [!IMPORTANT] diff --git a/docs/atl/reference/cw2wex-class.md b/docs/atl/reference/cw2wex-class.md index d5c15f69f2e..7148e484e49 100644 --- a/docs/atl/reference/cw2wex-class.md +++ b/docs/atl/reference/cw2wex-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CW2WEX class"] --- # CW2WEX Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class is used by the string conversion macros CW2TEX and CT2WEX, and the typedef CW2W. > [!IMPORTANT] diff --git a/docs/atl/reference/cwin32heap-class.md b/docs/atl/reference/cwin32heap-class.md index 8c69f91f153..0076ab7e2c0 100644 --- a/docs/atl/reference/cwin32heap-class.md +++ b/docs/atl/reference/cwin32heap-class.md @@ -4,10 +4,11 @@ title: "CWin32Heap Class" ms.date: "11/04/2016" f1_keywords: ["CWin32Heap", "ATLMEM/ATL::CWin32Heap", "ATLMEM/ATL::CWin32Heap::CWin32Heap", "ATLMEM/ATL::CWin32Heap::Allocate", "ATLMEM/ATL::CWin32Heap::Attach", "ATLMEM/ATL::CWin32Heap::Detach", "ATLMEM/ATL::CWin32Heap::Free", "ATLMEM/ATL::CWin32Heap::GetSize", "ATLMEM/ATL::CWin32Heap::Reallocate", "ATLMEM/ATL::CWin32Heap::m_bOwnHeap", "ATLMEM/ATL::CWin32Heap::m_hHeap"] helpviewer_keywords: ["CWin32Heap class"] -ms.assetid: 69176022-ed98-4e3b-96d8-116b0c58ac95 --- # CWin32Heap Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements [IAtlMemMgr](../../atl/reference/iatlmemmgr-class.md) using the Win32 heap allocation functions. > [!IMPORTANT] diff --git a/docs/atl/reference/cwindow-class.md b/docs/atl/reference/cwindow-class.md index c91fae3db68..99016859b08 100644 --- a/docs/atl/reference/cwindow-class.md +++ b/docs/atl/reference/cwindow-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["CWindow class"] --- # `CWindow` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for manipulating a window. > [!IMPORTANT] diff --git a/docs/atl/reference/cwindowimpl-class.md b/docs/atl/reference/cwindowimpl-class.md index d2041bc669a..bfd4e676f0c 100644 --- a/docs/atl/reference/cwindowimpl-class.md +++ b/docs/atl/reference/cwindowimpl-class.md @@ -4,10 +4,11 @@ title: "CWindowImpl Class" ms.date: "11/04/2016" f1_keywords: ["CWindowImpl", "ATLWIN/ATL::CWindowImpl", "ATLWIN/ATL::CWindowImpl::Create", "ATLWIN/ATL::CWindowImpl::DefWindowProc", "ATLWIN/ATL::CWindowImpl::GetCurrentMessage", "ATLWIN/ATL::CWindowImpl::GetWindowProc", "ATLWIN/ATL::CWindowImpl::OnFinalMessage", "ATLWIN/ATL::CWindowImpl::SubclassWindow", "ATLWIN/ATL::CWindowImpl::UnsubclassWindow", "ATLWIN/ATL::CWindowImpl::GetWndClassInfo", "ATLWIN/ATL::CWindowImpl::WindowProc", "ATLWIN/ATL::CWindowImpl::m_pfnSuperWindowProc"] helpviewer_keywords: ["CWindowImpl class", "subclassing windows, ATL"] -ms.assetid: 02eefd45-a0a6-4d1b-99f6-dbf627e2cc2f --- # CWindowImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Provides methods for creating or subclassing a window. > [!IMPORTANT] diff --git a/docs/atl/reference/cwintraits-class.md b/docs/atl/reference/cwintraits-class.md index e7d7b65eabc..123d908d88a 100644 --- a/docs/atl/reference/cwintraits-class.md +++ b/docs/atl/reference/cwintraits-class.md @@ -4,10 +4,11 @@ title: "CWinTraits Class" ms.date: "11/04/2016" f1_keywords: ["CWinTraits", "ATLWIN/ATL::CWinTraits", "ATLWIN/ATL::CWinTraits::GetWndExStyle", "ATLWIN/ATL::CWinTraits::GetWndStyle"] helpviewer_keywords: ["CMDIChildWinTraits class", "window styles, default values for ATL", "CWinTraits class", "CFrameWinTraits class", "CControlWinTraits class"] -ms.assetid: f78f486e-6d9c-42c6-8e86-371e05aa7e59 --- # CWinTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a method for standardizing the styles used when creating a window object. > [!IMPORTANT] diff --git a/docs/atl/reference/cwintraitsor-class.md b/docs/atl/reference/cwintraitsor-class.md index fbc54c0034a..8f6c147d330 100644 --- a/docs/atl/reference/cwintraitsor-class.md +++ b/docs/atl/reference/cwintraitsor-class.md @@ -4,10 +4,11 @@ title: "CWinTraitsOR Class" ms.date: "11/04/2016" f1_keywords: ["CWinTraitsOR", "ATLWIN/ATL::CWinTraitsOR", "ATLWIN/ATL::CWinTraitsOR::GetWndExStyle", "ATLWIN/ATL::CWinTraitsOR::GetWndStyle"] helpviewer_keywords: ["CWinTraitsOR class", "window styles, default values for ATL"] -ms.assetid: 1eb7b1e8-a9bd-411b-a30a-35a8a10af989 --- # CWinTraitsOR Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a method for standardizing the styles used when creating a window object. > [!IMPORTANT] diff --git a/docs/atl/reference/cwndclassinfo-class.md b/docs/atl/reference/cwndclassinfo-class.md index 0ac47624556..4cbf31cfbf4 100644 --- a/docs/atl/reference/cwndclassinfo-class.md +++ b/docs/atl/reference/cwndclassinfo-class.md @@ -4,10 +4,11 @@ title: "CWndClassInfo Class" ms.date: "11/04/2016" f1_keywords: ["CWndClassInfo", "ATLWIN/ATL::CWndClassInfo", "ATLWIN/ATL::Register", "ATLWIN/ATL::m_atom", "ATLWIN/ATL::m_bSystemCursor", "ATLWIN/ATL::m_lpszCursorID", "ATLWIN/ATL::m_lpszOrigName", "ATLWIN/ATL::m_szAutoName", "ATLWIN/ATL::m_wc", "ATLWIN/ATL::pWndProc"] helpviewer_keywords: ["CWndClassInfo class"] -ms.assetid: c36fe7e1-75f1-4cf5-a06f-9f59c43fe6fb --- # CWndClassInfo Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for registering information for a window class. > [!IMPORTANT] diff --git a/docs/atl/reference/cworkerthread-class.md b/docs/atl/reference/cworkerthread-class.md index a0171833ba9..8e3c4e5cbb1 100644 --- a/docs/atl/reference/cworkerthread-class.md +++ b/docs/atl/reference/cworkerthread-class.md @@ -4,10 +4,11 @@ title: "CWorkerThread Class" ms.date: "11/04/2016" f1_keywords: ["CWorkerThread", "ATLUTIL/ATL::CWorkerThread", "ATLUTIL/ATL::CWorkerThread::CWorkerThread", "ATLUTIL/ATL::CWorkerThread::AddHandle", "ATLUTIL/ATL::CWorkerThread::AddTimer", "ATLUTIL/ATL::CWorkerThread::GetThreadHandle", "ATLUTIL/ATL::CWorkerThread::GetThreadId", "ATLUTIL/ATL::CWorkerThread::Initialize", "ATLUTIL/ATL::CWorkerThread::RemoveHandle", "ATLUTIL/ATL::CWorkerThread::Shutdown"] helpviewer_keywords: ["CWorkerThread class"] -ms.assetid: be79a832-1345-4a36-a13e-a406cc65286f --- # CWorkerThread Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class creates a worker thread or uses an existing one, waits on one or more kernel object handles, and executes a specified client function when one of the handles is signaled. > [!IMPORTANT] diff --git a/docs/atl/reference/debugging-and-error-reporting-global-functions.md b/docs/atl/reference/debugging-and-error-reporting-global-functions.md index defba9ea3c3..0d293887fd6 100644 --- a/docs/atl/reference/debugging-and-error-reporting-global-functions.md +++ b/docs/atl/reference/debugging-and-error-reporting-global-functions.md @@ -4,10 +4,11 @@ title: "Debugging and Error Reporting Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlcomcli/ATL::AtlHresultFromLastError", "atlcom/ATL::AtlReportError", "atldef/ATL::AtlThrow"] helpviewer_keywords: ["functions [ATL], error reporting"] -ms.assetid: 11339c02-98cd-428d-b3b9-7deeb155a6a3 --- # Debugging and Error Reporting Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide useful debugging and trace facilities. |Name|Description| diff --git a/docs/atl/reference/debugging-and-error-reporting-macros.md b/docs/atl/reference/debugging-and-error-reporting-macros.md index 463ef4c0072..c5d43762cfc 100644 --- a/docs/atl/reference/debugging-and-error-reporting-macros.md +++ b/docs/atl/reference/debugging-and-error-reporting-macros.md @@ -4,10 +4,11 @@ title: "Debugging and Error Reporting Macros" ms.date: "05/06/2019" f1_keywords: ["atldef/ATL::_ATL_DEBUG_INTERFACES", "atldef/ATL::_ATL_DEBUG_QI", "atldef/ATL::ATLASSERT", "afx/ATL::ATLENSURE", "atltrace/ATL::ATLTRACENOTIMPL", "atltrace/ATL::ATLTRACE", "ATLDEF/_ATL_DEBUG_INTERFACES", "ATLDEF/_ATL_DEBUG_QI", "ATLDEF/ATLASSERT", "AFX/ATLENSURE", "ATLTRACE/ATLTRACENOTIMPL", "ATLTRACE/ATLTRACE", "ATLDEF/ATLSTATIC_ASSERT"] helpviewer_keywords: ["macros, error reporting"] -ms.assetid: 4da9b87f-ec5c-4a32-ab93-637780909b9d --- # Debugging and Error Reporting Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros provide useful debugging and trace facilities. |Name|Description| diff --git a/docs/atl/reference/default-atl-project-configurations.md b/docs/atl/reference/default-atl-project-configurations.md index 0b8caec7af5..bca92e9bb53 100644 --- a/docs/atl/reference/default-atl-project-configurations.md +++ b/docs/atl/reference/default-atl-project-configurations.md @@ -3,10 +3,11 @@ description: "Learn more about: Default ATL Project Configurations" title: "Default ATL Project Configurations" ms.date: "10/20/2017" helpviewer_keywords: ["ATL projects, default configurations"] -ms.assetid: 7e272722-41af-4330-b965-a6d74ec16880 --- # Default ATL Project Configurations +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + The ATL Project Wizard creates two project configurations by default: |Configuration|Character set|Use of ATL| diff --git a/docs/atl/reference/device-context-global-functions.md b/docs/atl/reference/device-context-global-functions.md index 7ef43f0431e..0720fd8042b 100644 --- a/docs/atl/reference/device-context-global-functions.md +++ b/docs/atl/reference/device-context-global-functions.md @@ -3,10 +3,11 @@ description: "Learn more about: Device Context Global Functions" title: "Device Context Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlwin/ATL::AtlCreateTargetDC"] -ms.assetid: 08ec28f6-daff-4882-9544-e8a4639d05c4 --- # Device Context Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This function creates a device context for a given device. |Name|Description| diff --git a/docs/atl/reference/event-handling-global-functions.md b/docs/atl/reference/event-handling-global-functions.md index 69c6f619b65..f5948e23c2d 100644 --- a/docs/atl/reference/event-handling-global-functions.md +++ b/docs/atl/reference/event-handling-global-functions.md @@ -4,10 +4,11 @@ title: "Event Handling Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlbase/ATL::AtlWaitWithMessageLoop"] helpviewer_keywords: ["event handling, global functions", "global functions, event handling"] -ms.assetid: fd674470-3def-47c3-be1c-894fa85f13e8 --- # Event Handling Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This function provides an event handler. > [!IMPORTANT] diff --git a/docs/atl/reference/exception-handling-macros.md b/docs/atl/reference/exception-handling-macros.md index 44f99934523..fe201b9e3a1 100644 --- a/docs/atl/reference/exception-handling-macros.md +++ b/docs/atl/reference/exception-handling-macros.md @@ -4,10 +4,11 @@ title: "Exception Handling Macros" ms.date: "11/04/2016" f1_keywords: ["atldef/ATL::_ATLCATCH", "atldef/ATL::_ATLCATCHALL", "atldef/ATL::_ATLTRY", "ATLDEF/_ATLCATCH", "ATLDEF/_ATLCATCHALL", "ATLDEF/_ATLTRY"] helpviewer_keywords: ["exception handling, macros", "C++ exception handling, macros"] -ms.assetid: a8385d34-3fb0-4006-a42a-de045cacf0f4 --- # Exception Handling Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros provide support for exception handling. |Name|Description| diff --git a/docs/atl/reference/iatlautothreadmodule-class.md b/docs/atl/reference/iatlautothreadmodule-class.md index 42df620330a..f83105ba786 100644 --- a/docs/atl/reference/iatlautothreadmodule-class.md +++ b/docs/atl/reference/iatlautothreadmodule-class.md @@ -4,10 +4,11 @@ title: "IAtlAutoThreadModule Class" ms.date: "11/04/2016" f1_keywords: ["IAtlAutoThreadModule", "atlbase/ATL::IAtlAutoThreadModule"] helpviewer_keywords: ["IAtlAutoThreadModule class"] -ms.assetid: fcb58cf9-a427-4be9-89eb-04e1ab5cc3a1 --- # IAtlAutoThreadModule Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents an interface to a `CreateInstance` method. > [!IMPORTANT] diff --git a/docs/atl/reference/iatlmemmgr-class.md b/docs/atl/reference/iatlmemmgr-class.md index 46acd301740..5df51a5cfc1 100644 --- a/docs/atl/reference/iatlmemmgr-class.md +++ b/docs/atl/reference/iatlmemmgr-class.md @@ -4,10 +4,11 @@ title: "IAtlMemMgr Class" ms.date: "11/04/2016" f1_keywords: ["IAtlMemMgr", "ATLMEM/ATL::IAtlMemMgr", "ATLMEM/ATL::Allocate", "ATLMEM/ATL::Free", "ATLMEM/ATL::GetSize", "ATLMEM/ATL::Reallocate"] helpviewer_keywords: ["IAtlMemMgr class", "memory, managing", "memory, memory manager"] -ms.assetid: 18b2c569-25fe-4464-bdb6-3b1abef7154a --- # IAtlMemMgr Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents the interface to a memory manager. ## Syntax diff --git a/docs/atl/reference/iaxwinambientdispatch-interface.md b/docs/atl/reference/iaxwinambientdispatch-interface.md index f1799cf5b26..4810d037297 100644 --- a/docs/atl/reference/iaxwinambientdispatch-interface.md +++ b/docs/atl/reference/iaxwinambientdispatch-interface.md @@ -4,10 +4,11 @@ title: "IAxWinAmbientDispatch Interface" ms.date: "11/04/2016" f1_keywords: ["IAxWinAmbientDispatch", "ATLIFACE/ATL::IAxWinAmbientDispatch", "ATLIFACE/ATL::get_AllowContextMenu", "ATLIFACE/ATL::get_AllowShowUI", "ATLIFACE/ATL::get_AllowWindowlessActivation", "ATLIFACE/ATL::get_BackColor", "ATLIFACE/ATL::get_DisplayAsDefault", "ATLIFACE/ATL::get_DocHostDoubleClickFlags", "ATLIFACE/ATL::get_DocHostFlags", "ATLIFACE/ATL::get_Font", "ATLIFACE/ATL::get_ForeColor", "ATLIFACE/ATL::get_LocaleID", "ATLIFACE/ATL::get_MessageReflect", "ATLIFACE/ATL::get_OptionKeyPath", "ATLIFACE/ATL::get_ShowGrabHandles", "ATLIFACE/ATL::get_ShowHatching", "ATLIFACE/ATL::get_UserMode", "ATLIFACE/ATL::put_AllowContextMenu", "ATLIFACE/ATL::put_AllowShowUI", "ATLIFACE/ATL::put_AllowWindowlessActivation", "ATLIFACE/ATL::put_BackColor", "ATLIFACE/ATL::put_DisplayAsDefault", "ATLIFACE/ATL::put_DocHostDoubleClickFlags", "ATLIFACE/ATL::put_DocHostFlags", "ATLIFACE/ATL::put_Font", "ATLIFACE/ATL::put_ForeColor", "ATLIFACE/ATL::put_LocaleID", "ATLIFACE/ATL::put_MessageReflect", "ATLIFACE/ATL::put_OptionKeyPath", "ATLIFACE/ATL::put_UserMode"] helpviewer_keywords: ["IAxWinAmbientDispatch interface"] -ms.assetid: 55ba6f7b-7a3c-4792-ae47-c8a84b683ca9 --- # IAxWinAmbientDispatch Interface +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This interface provides methods for specifying characteristics of the hosted control or container. > [!IMPORTANT] diff --git a/docs/atl/reference/iaxwinambientdispatchex-interface.md b/docs/atl/reference/iaxwinambientdispatchex-interface.md index 4df19f4e982..45190ff5ecb 100644 --- a/docs/atl/reference/iaxwinambientdispatchex-interface.md +++ b/docs/atl/reference/iaxwinambientdispatchex-interface.md @@ -4,10 +4,11 @@ title: "IAxWinAmbientDispatchEx Interface" ms.date: "11/04/2016" f1_keywords: ["IAxWinAmbientDispatchEx", "ATLIFACE/ATL::IAxWinAmbientDispatchEx", "ATLIFACE/ATL::SetAmbientDispatch"] helpviewer_keywords: ["IAxWinAmbientDispatchEx interface"] -ms.assetid: 2c25e079-6128-4278-bc72-b2c6195ba7ef --- # IAxWinAmbientDispatchEx Interface +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This interface implements supplemental ambient properties for a hosted control. > [!IMPORTANT] diff --git a/docs/atl/reference/iaxwinhostwindow-interface.md b/docs/atl/reference/iaxwinhostwindow-interface.md index 38ea65043d6..9b981a96ee3 100644 --- a/docs/atl/reference/iaxwinhostwindow-interface.md +++ b/docs/atl/reference/iaxwinhostwindow-interface.md @@ -4,10 +4,11 @@ title: "IAxWinHostWindow Interface" ms.date: "11/04/2016" f1_keywords: ["IAxWinHostWindow", "ATLIFACE/ATL::IAxWinHostWindow", "ATLIFACE/ATL::AttachControl", "ATLIFACE/ATL::CreateControl", "ATLIFACE/ATL::CreateControlEx", "ATLIFACE/ATL::QueryControl", "ATLIFACE/ATL::SetExternalDispatch", "ATLIFACE/ATL::SetExternalUIHandler"] helpviewer_keywords: ["IAxWinHostWindow interface"] -ms.assetid: 9821c035-cd52-4c46-b58a-9278064f09b4 --- # IAxWinHostWindow Interface +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This interface provides methods for manipulating a control and its host object. > [!IMPORTANT] diff --git a/docs/atl/reference/iaxwinhostwindowlic-interface.md b/docs/atl/reference/iaxwinhostwindowlic-interface.md index e2d65671f24..49479516988 100644 --- a/docs/atl/reference/iaxwinhostwindowlic-interface.md +++ b/docs/atl/reference/iaxwinhostwindowlic-interface.md @@ -4,10 +4,11 @@ title: "IAxWinHostWindowLic Interface" ms.date: "11/04/2016" f1_keywords: ["IAxWinHostWindowLic", "ATLIFACE/ATL::IAxWinHostWindowLic", "ATLIFACE/ATL::CreateControlLic", "ATLIFACE/ATL::CreateControlLicEx"] helpviewer_keywords: ["IAxWinHostWindowLic interface"] -ms.assetid: 750f1520-6bce-428c-aca0-fccbe3f063c7 --- # IAxWinHostWindowLic Interface +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This interface provides methods for manipulating a licensed control and its host object. ## Syntax diff --git a/docs/atl/reference/icollectiononstlimpl-class.md b/docs/atl/reference/icollectiononstlimpl-class.md index 58c7584c398..54377d23a95 100644 --- a/docs/atl/reference/icollectiononstlimpl-class.md +++ b/docs/atl/reference/icollectiononstlimpl-class.md @@ -4,10 +4,11 @@ title: "ICollectionOnSTLImpl Class" ms.date: "11/04/2016" f1_keywords: ["ICollectionOnSTLImpl", "ATLCOM/ATL::ICollectionOnSTLImpl", "ATLCOM/ATL::ICollectionOnSTLImpl::get__NewEnum", "ATLCOM/ATL::ICollectionOnSTLImpl::getcount", "ATLCOM/ATL::ICollectionOnSTLImpl::get_Item", "ATLCOM/ATL::ICollectionOnSTLImpl::m_coll"] helpviewer_keywords: ["ICollectionOnSTLImpl class"] -ms.assetid: 683c88b0-0d97-4779-a762-e493334ba7f9 --- # ICollectionOnSTLImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods used by a collection class. ## Syntax diff --git a/docs/atl/reference/iconnectionpointcontainerimpl-class.md b/docs/atl/reference/iconnectionpointcontainerimpl-class.md index fd6e2362ee3..e7575eb5862 100644 --- a/docs/atl/reference/iconnectionpointcontainerimpl-class.md +++ b/docs/atl/reference/iconnectionpointcontainerimpl-class.md @@ -4,10 +4,11 @@ title: "IConnectionPointContainerImpl Class" ms.date: "11/04/2016" f1_keywords: ["IConnectionPointContainerImpl", "ATLCOM/ATL::IConnectionPointContainerImpl", "ATLCOM/ATL::IConnectionPointContainerImpl::EnumConnectionPoints", "ATLCOM/ATL::IConnectionPointContainerImpl::FindConnectionPoint"] helpviewer_keywords: ["connectable objects", "connection points [C++], container", "IConnectionPointContainerImpl class"] -ms.assetid: 10db5a8d-8be9-4d9d-8a82-8ab9ffe3e9d6 --- # IConnectionPointContainerImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements a connection point container to manage a collection of [IConnectionPointImpl](../../atl/reference/iconnectionpointimpl-class.md) objects. ## Syntax diff --git a/docs/atl/reference/iconnectionpointimpl-class.md b/docs/atl/reference/iconnectionpointimpl-class.md index 2b51b7bc46c..01653837946 100644 --- a/docs/atl/reference/iconnectionpointimpl-class.md +++ b/docs/atl/reference/iconnectionpointimpl-class.md @@ -4,10 +4,11 @@ title: "IConnectionPointImpl Class" ms.date: "11/04/2016" f1_keywords: ["IConnectionPointImpl", "ATLCOM/ATL::IConnectionPointImpl", "ATLCOM/ATL::IConnectionPointImpl::Advise", "ATLCOM/ATL::IConnectionPointImpl::EnumConnections", "ATLCOM/ATL::IConnectionPointImpl::GetConnectionInterface", "ATLCOM/ATL::IConnectionPointImpl::GetConnectionPointContainer", "ATLCOM/ATL::IConnectionPointImpl::Unadvise", "ATLCOM/ATL::IConnectionPointImpl::m_vec"] helpviewer_keywords: ["connection points [C++], implementing", "IConnectionPointImpl class"] -ms.assetid: 27992115-3b86-45dd-bc9e-54f32876c557 --- # IConnectionPointImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements a connection point. ## Syntax diff --git a/docs/atl/reference/idataobjectimpl-class.md b/docs/atl/reference/idataobjectimpl-class.md index 3ebc3c44024..66da64d27e2 100644 --- a/docs/atl/reference/idataobjectimpl-class.md +++ b/docs/atl/reference/idataobjectimpl-class.md @@ -4,10 +4,11 @@ title: "IDataObjectImpl Class" ms.date: "11/04/2016" f1_keywords: ["IDataObjectImpl", "ATLCTL/ATL::IDataObjectImpl", "ATLCTL/ATL::IDataObjectImpl::DAdvise", "ATLCTL/ATL::IDataObjectImpl::DUnadvise", "ATLCTL/ATL::IDataObjectImpl::EnumDAdvise", "ATLCTL/ATL::IDataObjectImpl::EnumFormatEtc", "ATLCTL/ATL::IDataObjectImpl::FireDataChange", "ATLCTL/ATL::IDataObjectImpl::GetCanonicalFormatEtc", "ATLCTL/ATL::IDataObjectImpl::GetData", "ATLCTL/ATL::IDataObjectImpl::GetDataHere", "ATLCTL/ATL::IDataObjectImpl::QueryGetData", "ATLCTL/ATL::IDataObjectImpl::SetData"] helpviewer_keywords: ["data transfer [C++]", "data transfer [C++], Uniform Data Transfer", "IDataObjectImpl class", "IDataObject, ATL implementation"] -ms.assetid: b680f0f7-7795-40a1-a0f6-f48768201c89 --- # IDataObjectImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for supporting Uniform Data Transfer and managing connections. > [!IMPORTANT] diff --git a/docs/atl/reference/idispatchimpl-class.md b/docs/atl/reference/idispatchimpl-class.md index e44623c7625..ee9891c47fb 100644 --- a/docs/atl/reference/idispatchimpl-class.md +++ b/docs/atl/reference/idispatchimpl-class.md @@ -4,10 +4,11 @@ title: "IDispatchImpl Class" ms.date: "11/04/2016" f1_keywords: ["IDispatchImpl", "ATLCOM/ATL::IDispatchImpl", "ATLCOM/ATL::IDispatchImpl::IDispatchImpl", "ATLCOM/ATL::IDispatchImpl::GetIDsOfNames", "ATLCOM/ATL::IDispatchImpl::GetTypeInfo", "ATLCOM/ATL::IDispatchImpl::GetTypeInfoCount", "ATLCOM/ATL::IDispatchImpl::Invoke"] helpviewer_keywords: ["dual interfaces, classes", "IDispatchImpl class", "IDispatch class support in ATL"] -ms.assetid: 8108eb36-1228-4127-a203-3ab5ba488892 --- # IDispatchImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Provides a default implementation for the `IDispatch` part of a dual interface. > [!IMPORTANT] diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index ef54c3c7b5c..fe3cb6578ab 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["IDispEventImpl class"] --- # `IDispEventImpl` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides implementations of the `IDispatch` methods. > [!IMPORTANT] diff --git a/docs/atl/reference/idispeventsimpleimpl-class.md b/docs/atl/reference/idispeventsimpleimpl-class.md index c76ceee1297..4224ca90998 100644 --- a/docs/atl/reference/idispeventsimpleimpl-class.md +++ b/docs/atl/reference/idispeventsimpleimpl-class.md @@ -4,10 +4,11 @@ title: "IDispEventSimpleImpl Class" ms.date: "11/04/2016" f1_keywords: ["IDispEventSimpleImpl", "ATLCOM/ATL::IDispEventSimpleImpl", "ATLCOM/ATL::IDispEventSimpleImpl::Advise", "ATLCOM/ATL::IDispEventSimpleImpl::DispEventAdvise", "ATLCOM/ATL::IDispEventSimpleImpl::DispEventUnadvise", "ATLCOM/ATL::IDispEventSimpleImpl::GetIDsOfNames", "ATLCOM/ATL::IDispEventSimpleImpl::GetTypeInfo", "ATLCOM/ATL::IDispEventSimpleImpl::GetTypeInfoCount", "ATLCOM/ATL::IDispEventSimpleImpl::Invoke", "ATLCOM/ATL::IDispEventSimpleImpl::Unadvise"] helpviewer_keywords: ["IDispEventSimpleImpl class"] -ms.assetid: 971d82b7-a921-47fa-a4d8-909bed377ab0 --- # IDispEventSimpleImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides implementations of the `IDispatch` methods, without getting type information from a type library. > [!IMPORTANT] diff --git a/docs/atl/reference/idochostuihandlerdispatch-interface.md b/docs/atl/reference/idochostuihandlerdispatch-interface.md index d748d3e3df2..35749bfb535 100644 --- a/docs/atl/reference/idochostuihandlerdispatch-interface.md +++ b/docs/atl/reference/idochostuihandlerdispatch-interface.md @@ -4,10 +4,11 @@ title: "IDocHostUIHandlerDispatch Interface" ms.date: "07/02/2019" f1_keywords: ["IDocHostUIHandlerDispatch", "atlbase/ATL::IDocHostUIHandlerDispatch"] helpviewer_keywords: ["IDocHostUIHandlerDispatch interface"] -ms.assetid: 6963a301-601a-4ac3-8bef-f7b252ea2fc6 --- # IDocHostUIHandlerDispatch Interface +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + An interface to the Microsoft HTML parsing and rendering engine. > [!IMPORTANT] diff --git a/docs/atl/reference/ienumonstlimpl-class.md b/docs/atl/reference/ienumonstlimpl-class.md index c8c694372a0..99b2f3ab0b2 100644 --- a/docs/atl/reference/ienumonstlimpl-class.md +++ b/docs/atl/reference/ienumonstlimpl-class.md @@ -4,10 +4,11 @@ title: "IEnumOnSTLImpl Class" ms.date: "11/04/2016" f1_keywords: ["IEnumOnSTLImpl", "ATLCOM/ATL::IEnumOnSTLImpl", "ATLCOM/ATL::IEnumOnSTLImpl::Clone", "ATLCOM/ATL::IEnumOnSTLImpl::Init", "ATLCOM/ATL::IEnumOnSTLImpl::Next", "ATLCOM/ATL::IEnumOnSTLImpl::Reset", "ATLCOM/ATL::IEnumOnSTLImpl::Skip", "ATLCOM/ATL::IEnumOnSTLImpl::m_iter", "ATLCOM/ATL::IEnumOnSTLImpl::m_pcollection", "ATLCOM/ATL::IEnumOnSTLImpl::m_spUnk"] helpviewer_keywords: ["IEnumOnSTLImpl class"] -ms.assetid: 1789e77b-88b8-447d-a490-806b918912ce --- # IEnumOnSTLImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class defines an enumerator interface based on a C++ Standard Library collection. ## Syntax diff --git a/docs/atl/reference/interfaces-atl-control-wizard.md b/docs/atl/reference/interfaces-atl-control-wizard.md index 97794e03f9b..f27b167effe 100644 --- a/docs/atl/reference/interfaces-atl-control-wizard.md +++ b/docs/atl/reference/interfaces-atl-control-wizard.md @@ -4,10 +4,11 @@ title: "Interfaces, ATL Control Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.class.atl.control.interfaces"] helpviewer_keywords: ["ATL Control Wizard, interfaces"] -ms.assetid: 971eadcd-6a1e-46f2-b8fe-ee6b53dfe3ea --- # Interfaces, ATL Control Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This page of the wizard identifies the interfaces that the control supports. By default, the supported interfaces are those typically used by most containers. > [!NOTE] diff --git a/docs/atl/reference/iobjectsafetyimpl-class.md b/docs/atl/reference/iobjectsafetyimpl-class.md index dee092995fc..61f7cf4f394 100644 --- a/docs/atl/reference/iobjectsafetyimpl-class.md +++ b/docs/atl/reference/iobjectsafetyimpl-class.md @@ -4,10 +4,11 @@ title: "IObjectSafetyImpl Class" ms.date: "11/04/2016" f1_keywords: ["IObjectSafetyImpl", "ATLCTL/ATL::IObjectSafetyImpl", "ATLCTL/ATL::IObjectSafetyImpl::GetInterfaceSafetyOptions", "ATLCTL/ATL::IObjectSafetyImpl::SetInterfaceSafetyOptions", "ATLCTL/ATL::IObjectSafetyImpl::m_dwCurrentSafety"] helpviewer_keywords: ["controls [ATL], safe", "safe for scripting and initialization (controls)", "IObjectSafety, ATL implementation", "IObjectSafetyImpl class"] -ms.assetid: 64e32082-d910-4a8a-a5bf-ebed9145359d --- # IObjectSafetyImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a default implementation of the `IObjectSafety` interface to allow a client to retrieve and set an object's safety levels. > [!IMPORTANT] diff --git a/docs/atl/reference/iobjectwithsiteimpl-class.md b/docs/atl/reference/iobjectwithsiteimpl-class.md index 5ae9a4b8d7c..3d686a03d63 100644 --- a/docs/atl/reference/iobjectwithsiteimpl-class.md +++ b/docs/atl/reference/iobjectwithsiteimpl-class.md @@ -4,10 +4,11 @@ title: "IObjectWithSiteImpl Class" ms.date: "11/04/2016" f1_keywords: ["IObjectWithSiteImpl", "ATLCOM/ATL::IObjectWithSiteImpl", "ATLCOM/ATL::IObjectWithSiteImpl::GetSite", "ATLCOM/ATL::IObjectWithSiteImpl::SetChildSite", "ATLCOM/ATL::IObjectWithSiteImpl::SetSite", "ATLCOM/ATL::IObjectWithSiteImpl::m_spUnkSite"] helpviewer_keywords: ["IObjectWithSiteImpl class"] -ms.assetid: 4e1f774f-bc3d-45ee-9a1c-c3533a511588 --- # IObjectWithSiteImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods allowing an object to communicate with its site. ## Syntax diff --git a/docs/atl/reference/iolecontrolimpl-class.md b/docs/atl/reference/iolecontrolimpl-class.md index 6c3430e9ceb..d1e7e97f595 100644 --- a/docs/atl/reference/iolecontrolimpl-class.md +++ b/docs/atl/reference/iolecontrolimpl-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["IOleControlImpl class"] --- # IOleControlImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a default implementation of the `IOleControl` interface and implements `IUnknown`. > [!IMPORTANT] diff --git a/docs/atl/reference/ioleinplaceactiveobjectimpl-class.md b/docs/atl/reference/ioleinplaceactiveobjectimpl-class.md index 64fcdcd25bf..b275380a09b 100644 --- a/docs/atl/reference/ioleinplaceactiveobjectimpl-class.md +++ b/docs/atl/reference/ioleinplaceactiveobjectimpl-class.md @@ -4,10 +4,11 @@ title: "IOleInPlaceActiveObjectImpl Class" ms.date: "11/04/2016" f1_keywords: ["IOleInPlaceActiveObjectImpl", "ATLCTL/ATL::IOleInPlaceActiveObjectImpl", "ATLCTL/ATL::IOleInPlaceActiveObjectImpl::ContextSensitiveHelp", "ATLCTL/ATL::IOleInPlaceActiveObjectImpl::EnableModeless", "ATLCTL/ATL::IOleInPlaceActiveObjectImpl::GetWindow", "ATLCTL/ATL::IOleInPlaceActiveObjectImpl::OnDocWindowActivate", "ATLCTL/ATL::IOleInPlaceActiveObjectImpl::OnFrameWindowActivate", "ATLCTL/ATL::IOleInPlaceActiveObjectImpl::ResizeBorder", "ATLCTL/ATL::IOleInPlaceActiveObjectImpl::TranslateAccelerator"] helpviewer_keywords: ["IOleInPlaceActiveObjectImpl class", "ActiveX controls [C++], communication between container and control", "IOleInPlaceActiveObject, ATL implementation"] -ms.assetid: 44e6cc6d-a2dc-4187-98e3-73cf0320dea9 --- # IOleInPlaceActiveObjectImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for assisting communication between an in-place control and its container. > [!IMPORTANT] diff --git a/docs/atl/reference/ioleinplaceobjectwindowlessimpl-class.md b/docs/atl/reference/ioleinplaceobjectwindowlessimpl-class.md index d34f0d80b9b..d4307e69f4c 100644 --- a/docs/atl/reference/ioleinplaceobjectwindowlessimpl-class.md +++ b/docs/atl/reference/ioleinplaceobjectwindowlessimpl-class.md @@ -4,10 +4,11 @@ title: "IOleInPlaceObjectWindowlessImpl Class" ms.date: "11/04/2016" f1_keywords: ["IOleInPlaceObjectWindowlessImpl", "ATLCTL/ATL::IOleInPlaceObjectWindowlessImpl", "ATLCTL/ATL::IOleInPlaceObjectWindowlessImpl::ContextSensitiveHelp", "ATLCTL/ATL::IOleInPlaceObjectWindowlessImpl::GetDropTarget", "ATLCTL/ATL::IOleInPlaceObjectWindowlessImpl::GetWindow", "ATLCTL/ATL::IOleInPlaceObjectWindowlessImpl::InPlaceDeactivate", "ATLCTL/ATL::IOleInPlaceObjectWindowlessImpl::OnWindowMessage", "ATLCTL/ATL::IOleInPlaceObjectWindowlessImpl::ReactivateAndUndo", "ATLCTL/ATL::IOleInPlaceObjectWindowlessImpl::SetObjectRects", "ATLCTL/ATL::IOleInPlaceObjectWindowlessImpl::UIDeactivate"] helpviewer_keywords: ["IOleInPlaceObjectWindowless, ATL implementation", "activation [C++], ATL", "IOleInPlaceObjectWindowlessImpl class", "ActiveX controls [C++], communication between container and control", "controls [ATL], windowless", "deactivating ATL"] -ms.assetid: a2e0feb4-bc59-4adf-aab2-105457bbdbb4 --- # IOleInPlaceObjectWindowlessImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and provides methods that enable a windowless control to receive window messages and to participate in drag-and-drop operations. > [!IMPORTANT] diff --git a/docs/atl/reference/ioleobjectimpl-class.md b/docs/atl/reference/ioleobjectimpl-class.md index 888f9c0db98..42349e85a20 100644 --- a/docs/atl/reference/ioleobjectimpl-class.md +++ b/docs/atl/reference/ioleobjectimpl-class.md @@ -4,10 +4,11 @@ title: "IOleObjectImpl Class" ms.date: "11/04/2016" f1_keywords: ["IOleObjectImpl", "ATLCTL/ATL::IOleObjectImpl", "ATLCTL/ATL::IOleObjectImpl::Advise", "ATLCTL/ATL::IOleObjectImpl::Close", "ATLCTL/ATL::IOleObjectImpl::DoVerb", "ATLCTL/ATL::IOleObjectImpl::DoVerbDiscardUndo", "ATLCTL/ATL::IOleObjectImpl::DoVerbHide", "ATLCTL/ATL::IOleObjectImpl::DoVerbInPlaceActivate", "ATLCTL/ATL::IOleObjectImpl::DoVerbOpen", "ATLCTL/ATL::IOleObjectImpl::DoVerbPrimary", "ATLCTL/ATL::IOleObjectImpl::DoVerbShow", "ATLCTL/ATL::IOleObjectImpl::DoVerbUIActivate", "ATLCTL/ATL::IOleObjectImpl::EnumAdvise", "ATLCTL/ATL::IOleObjectImpl::EnumVerbs", "ATLCTL/ATL::IOleObjectImpl::GetClientSite", "ATLCTL/ATL::IOleObjectImpl::GetClipboardData", "ATLCTL/ATL::IOleObjectImpl::GetExtent", "ATLCTL/ATL::IOleObjectImpl::GetMiscStatus", "ATLCTL/ATL::IOleObjectImpl::GetMoniker", "ATLCTL/ATL::IOleObjectImpl::GetUserClassID", "ATLCTL/ATL::IOleObjectImpl::GetUserType", "ATLCTL/ATL::IOleObjectImpl::InitFromData", "ATLCTL/ATL::IOleObjectImpl::IsUpToDate", "ATLCTL/ATL::IOleObjectImpl::OnPostVerbDiscardUndo", "ATLCTL/ATL::IOleObjectImpl::OnPostVerbHide", "ATLCTL/ATL::IOleObjectImpl::OnPostVerbInPlaceActivate", "ATLCTL/ATL::IOleObjectImpl::OnPostVerbOpen", "ATLCTL/ATL::IOleObjectImpl::OnPostVerbShow", "ATLCTL/ATL::IOleObjectImpl::OnPostVerbUIActivate", "ATLCTL/ATL::IOleObjectImpl::OnPreVerbDiscardUndo", "ATLCTL/ATL::IOleObjectImpl::OnPreVerbHide", "ATLCTL/ATL::IOleObjectImpl::OnPreVerbInPlaceActivate", "ATLCTL/ATL::IOleObjectImpl::OnPreVerbOpen", "ATLCTL/ATL::IOleObjectImpl::OnPreVerbShow", "ATLCTL/ATL::IOleObjectImpl::OnPreVerbUIActivate", "ATLCTL/ATL::IOleObjectImpl::SetClientSite", "ATLCTL/ATL::IOleObjectImpl::SetColorScheme", "ATLCTL/ATL::IOleObjectImpl::SetExtent", "ATLCTL/ATL::IOleObjectImpl::SetHostNames", "ATLCTL/ATL::IOleObjectImpl::SetMoniker", "ATLCTL/ATL::IOleObjectImpl::Unadvise", "ATLCTL/ATL::IOleObjectImpl::Update"] helpviewer_keywords: ["ActiveX controls [C++], communication between container and control", "IOleObject, ATL implementation", "IOleObjectImpl class"] -ms.assetid: 59750b2d-1633-4a51-a4c2-6455b6b90c45 --- # IOleObjectImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and is the principal interface through which a container communicates with a control. > [!IMPORTANT] diff --git a/docs/atl/reference/iperpropertybrowsingimpl-class.md b/docs/atl/reference/iperpropertybrowsingimpl-class.md index c5f0e2678ed..c1ca3e087dc 100644 --- a/docs/atl/reference/iperpropertybrowsingimpl-class.md +++ b/docs/atl/reference/iperpropertybrowsingimpl-class.md @@ -4,10 +4,11 @@ title: "IPerPropertyBrowsingImpl Class" ms.date: "11/04/2016" f1_keywords: ["IPerPropertyBrowsingImpl", "ATLCTL/ATL::IPerPropertyBrowsingImpl", "ATLCTL/ATL::IPerPropertyBrowsingImpl::GetDisplayString", "ATLCTL/ATL::IPerPropertyBrowsingImpl::GetPredefinedStrings", "ATLCTL/ATL::IPerPropertyBrowsingImpl::GetPredefinedValue", "ATLCTL/ATL::IPerPropertyBrowsingImpl::MapPropertyToPage"] helpviewer_keywords: ["IPerPropertyBrowsingImpl class", "property pages, accessing information", "IPerPropertyBrowsing, ATL implementation"] -ms.assetid: 0b1a9be3-d242-4767-be69-663a21e4b728 --- # IPerPropertyBrowsingImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and allows a client to access the information in an object's property pages. > [!IMPORTANT] diff --git a/docs/atl/reference/ipersistpropertybagimpl-class.md b/docs/atl/reference/ipersistpropertybagimpl-class.md index b9029c339df..84fb6c38136 100644 --- a/docs/atl/reference/ipersistpropertybagimpl-class.md +++ b/docs/atl/reference/ipersistpropertybagimpl-class.md @@ -4,10 +4,11 @@ title: "IPersistPropertyBagImpl Class" ms.date: "11/04/2016" f1_keywords: ["IPersistPropertyBagImpl", "ATLCOM/ATL::IPersistPropertyBagImpl", "ATLCOM/ATL::IPersistPropertyBagImpl::GetClassID", "ATLCOM/ATL::IPersistPropertyBagImpl::InitNew", "ATLCOM/ATL::IPersistPropertyBagImpl::Load", "ATLCOM/ATL::IPersistPropertyBagImpl::Save"] helpviewer_keywords: ["IPersistPropertyBagImpl class"] -ms.assetid: 712af24d-99f8-40f2-9811-53b3ff6e5b19 --- # IPersistPropertyBagImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and allows an object to save its properties to a client-supplied property bag. > [!IMPORTANT] diff --git a/docs/atl/reference/ipersiststorageimpl-class.md b/docs/atl/reference/ipersiststorageimpl-class.md index a5396bee533..ae95395147b 100644 --- a/docs/atl/reference/ipersiststorageimpl-class.md +++ b/docs/atl/reference/ipersiststorageimpl-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["storage, ATL", "IPersistStorageImpl class"] --- # IPersistStorageImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements the [IPersistStorage](/windows/win32/api/objidl/nn-objidl-ipersiststorage) interface. > [!IMPORTANT] diff --git a/docs/atl/reference/ipersiststreaminitimpl-class.md b/docs/atl/reference/ipersiststreaminitimpl-class.md index 3eab5ba63c0..cf426de9552 100644 --- a/docs/atl/reference/ipersiststreaminitimpl-class.md +++ b/docs/atl/reference/ipersiststreaminitimpl-class.md @@ -4,10 +4,11 @@ title: "IPersistStreamInitImpl Class" ms.date: "11/04/2016" f1_keywords: ["IPersistStreamInitImpl", "ATLCOM/ATL::IPersistStreamInitImpl", "ATLCOM/ATL::IPersistStreamInitImpl::GetClassID", "ATLCOM/ATL::IPersistStreamInitImpl::GetSizeMax", "ATLCOM/ATL::IPersistStreamInitImpl::InitNew", "ATLCOM/ATL::IPersistStreamInitImpl::IsDirty", "ATLCOM/ATL::IPersistStreamInitImpl::Load", "ATLCOM/ATL::IPersistStreamInitImpl::Save"] helpviewer_keywords: ["IPersistStreamInit ATL implementation", "IPersistStreamInitImpl class", "streams, ATL"] -ms.assetid: ef217c3c-020f-4cf8-871e-ef68e57865b8 --- # IPersistStreamInitImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and provides a default implementation of the [IPersistStreamInit](/windows/win32/api/ocidl/nn-ocidl-ipersiststreaminit) interface. > [!IMPORTANT] diff --git a/docs/atl/reference/ipointerinactiveimpl-class.md b/docs/atl/reference/ipointerinactiveimpl-class.md index 71189491246..ed5fa3495e3 100644 --- a/docs/atl/reference/ipointerinactiveimpl-class.md +++ b/docs/atl/reference/ipointerinactiveimpl-class.md @@ -4,10 +4,11 @@ title: "IPointerInactiveImpl Class" ms.date: "11/04/2016" f1_keywords: ["IPointerInactiveImpl", "ATLCTL/ATL::IPointerInactiveImpl", "ATLCTL/ATL::IPointerInactiveImpl::GetActivationPolicy", "ATLCTL/ATL::IPointerInactiveImpl::OnInactiveMouseMove", "ATLCTL/ATL::IPointerInactiveImpl::OnInactiveSetCursor"] helpviewer_keywords: ["IPointerInactive ATL implementation", "inactive objects", "IPointerInactiveImpl class"] -ms.assetid: e1fe9ea6-d38a-4527-9112-eb344771e0b7 --- # IPointerInactiveImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and the [IPointerInactive](/windows/win32/api/ocidl/nn-ocidl-ipointerinactive) interface methods. > [!IMPORTANT] diff --git a/docs/atl/reference/ipropertynotifysinkcp-class.md b/docs/atl/reference/ipropertynotifysinkcp-class.md index b02d41d33b0..d4a74b402a9 100644 --- a/docs/atl/reference/ipropertynotifysinkcp-class.md +++ b/docs/atl/reference/ipropertynotifysinkcp-class.md @@ -4,10 +4,11 @@ title: "IPropertyNotifySinkCP Class" ms.date: "11/04/2016" f1_keywords: ["IPropertyNotifySinkCP", "atlctl/ATL::IPropertyNotifySinkCP"] helpviewer_keywords: ["connection points [C++], managing", "sinks, notifying of changes", "IPropertyNotifySinkCP class"] -ms.assetid: 1b41445e-bc88-4fa6-bb62-d68aacec2bd5 --- # IPropertyNotifySinkCP Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class exposes [IPropertyNotifySink](/windows/win32/api/ocidl/nn-ocidl-ipropertynotifysink) interface as an outgoing interface on a connectable object. > [!IMPORTANT] diff --git a/docs/atl/reference/ipropertypage2impl-class.md b/docs/atl/reference/ipropertypage2impl-class.md index f39eac4e87e..412048f8778 100644 --- a/docs/atl/reference/ipropertypage2impl-class.md +++ b/docs/atl/reference/ipropertypage2impl-class.md @@ -4,10 +4,11 @@ title: "IPropertyPage2Impl Class" ms.date: "11/04/2016" f1_keywords: ["IPropertyPage2Impl", "ATLCTL/ATL::IPropertyPage2Impl", "ATLCTL/ATL::IPropertyPage2Impl::EditProperty"] helpviewer_keywords: ["property pages", "IPropertyPage2 ATL implementation", "IPropertyPage2Impl class"] -ms.assetid: e89fbe90-203a-47f0-a5de-23616697e1ce --- # IPropertyPage2Impl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and inherits the default implementation of [IPropertyPageImpl](../../atl/reference/ipropertypageimpl-class.md). > [!IMPORTANT] diff --git a/docs/atl/reference/ipropertypageimpl-class.md b/docs/atl/reference/ipropertypageimpl-class.md index 8b217ed0d02..0cd5e4d87bf 100644 --- a/docs/atl/reference/ipropertypageimpl-class.md +++ b/docs/atl/reference/ipropertypageimpl-class.md @@ -4,10 +4,11 @@ title: "IPropertyPageImpl Class" ms.date: "11/04/2016" f1_keywords: ["IPropertyPageImpl", "ATLCTL/ATL::IPropertyPageImpl", "ATLCTL/ATL::IPropertyPageImpl::IPropertyPageImpl", "ATLCTL/ATL::IPropertyPageImpl::Activate", "ATLCTL/ATL::IPropertyPageImpl::Apply", "ATLCTL/ATL::IPropertyPageImpl::Deactivate", "ATLCTL/ATL::IPropertyPageImpl::GetPageInfo", "ATLCTL/ATL::IPropertyPageImpl::Help", "ATLCTL/ATL::IPropertyPageImpl::IsPageDirty", "ATLCTL/ATL::IPropertyPageImpl::Move", "ATLCTL/ATL::IPropertyPageImpl::SetDirty", "ATLCTL/ATL::IPropertyPageImpl::SetObjects", "ATLCTL/ATL::IPropertyPageImpl::SetPageSite", "ATLCTL/ATL::IPropertyPageImpl::Show", "ATLCTL/ATL::IPropertyPageImpl::TranslateAccelerator", "ATLCTL/ATL::IPropertyPageImpl::m_bDirty", "ATLCTL/ATL::IPropertyPageImpl::m_dwDocString", "ATLCTL/ATL::IPropertyPageImpl::m_dwHelpContext", "ATLCTL/ATL::IPropertyPageImpl::m_dwHelpFile", "ATLCTL/ATL::IPropertyPageImpl::m_dwTitle", "ATLCTL/ATL::IPropertyPageImpl::m_nObjects", "ATLCTL/ATL::IPropertyPageImpl::m_pPageSite", "ATLCTL/ATL::IPropertyPageImpl::m_ppUnk", "ATLCTL/ATL::IPropertyPageImpl::m_size"] helpviewer_keywords: ["property pages", "IPropertyPage ATL implementation", "IPropertyPageImpl class"] -ms.assetid: f9b7c8b1-7a04-4eab-aa63-63efddb740fa --- # IPropertyPageImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and provides a default implementation of the [IPropertyPage](/windows/win32/api/ocidl/nn-ocidl-ipropertypage) interface. > [!IMPORTANT] diff --git a/docs/atl/reference/iprovideclassinfo2impl-class.md b/docs/atl/reference/iprovideclassinfo2impl-class.md index c700c6a2809..3115d96f8e1 100644 --- a/docs/atl/reference/iprovideclassinfo2impl-class.md +++ b/docs/atl/reference/iprovideclassinfo2impl-class.md @@ -4,10 +4,11 @@ title: "IProvideClassInfo2Impl Class" ms.date: "11/04/2016" f1_keywords: ["IProvideClassInfo2Impl", "ATLCOM/ATL::IProvideClassInfo2Impl", "ATLCOM/ATL::IProvideClassInfo2Impl::IProvideClassInfo2Impl", "ATLCOM/ATL::IProvideClassInfo2Impl::GetClassInfo", "ATLCOM/ATL::IProvideClassInfo2Impl::GetGUID", "ATLCOM/ATL::IProvideClassInfo2Impl::_tih"] helpviewer_keywords: ["IProvideClassInfo2Impl class", "IProvideClassInfo2 ATL implementation", "class information, ATL"] -ms.assetid: d74956e8-9c69-4cba-b99d-ca1ac031bb9d --- # IProvideClassInfo2Impl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a default implementation of the [IProvideClassInfo](/windows/win32/api/ocidl/nn-ocidl-iprovideclassinfo) and [IProvideClassInfo2](/windows/win32/api/ocidl/nn-ocidl-iprovideclassinfo2) methods. ## Syntax diff --git a/docs/atl/reference/iquickactivateimpl-class.md b/docs/atl/reference/iquickactivateimpl-class.md index 55d408feadc..88ea87bc8d8 100644 --- a/docs/atl/reference/iquickactivateimpl-class.md +++ b/docs/atl/reference/iquickactivateimpl-class.md @@ -4,10 +4,11 @@ title: "IQuickActivateImpl Class" ms.date: "11/04/2016" f1_keywords: ["IQuickActivateImpl", "ATLCTL/ATL::IQuickActivateImpl", "ATLCTL/ATL::IQuickActivateImpl::GetContentExtent", "ATLCTL/ATL::IQuickActivateImpl::QuickActivate", "ATLCTL/ATL::IQuickActivateImpl::SetContentExtent"] helpviewer_keywords: ["activating ATL controls", "controls [ATL], activating", "IQuickActivateImpl class", "IQuickActivate ATL implementation"] -ms.assetid: aa80c056-1041-494e-b21d-2acca7dc27ea --- # IQuickActivateImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class combines containers' control initialization into a single call. > [!IMPORTANT] diff --git a/docs/atl/reference/iregistrar-class.md b/docs/atl/reference/iregistrar-class.md index 9c3ca2a9805..5f8c8909e23 100644 --- a/docs/atl/reference/iregistrar-class.md +++ b/docs/atl/reference/iregistrar-class.md @@ -4,10 +4,11 @@ title: "IRegistrar Interface" ms.date: "02/01/2017" f1_keywords: ["IRegistrar", "ATLIFASE/ATL::IRegistrar", "ATLIFASE/ATL::IRegistrar::ResourceRegisterSz", "ATLIFASE/ATL::IRegistrar::ResourceUnregisterSz", "ATLIFASE/ATL::IRegistrar::FileRegister", "ATLIFASE/ATL::IRegistrar::FileUnregister", "ATLIFASE/ATL::IRegistrar::StringRegister", "ATLIFASE/ATL::IRegistrar::StringUnregister", "ATLIFASE/ATL::IRegistrar::ResourceRegister", "ATLIFASE/ATL::IRegistrar::ResourceUnregister"] helpviewer_keywords: ["Iregistrar Interface"] -ms.assetid: e88c04b7-0c93-4ae8-aeb9-ecd78f87421e --- # IRegistrar Interface +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This interface is defined in atliface.h and is used internally by CAtlModule member functions such as [UpdateRegistryFromResourceD](catlmodule-class.md#updateregistryfromresourced). ## Syntax diff --git a/docs/atl/reference/irunnableobjectimpl-class.md b/docs/atl/reference/irunnableobjectimpl-class.md index 77b26a50729..ad0058aeb3c 100644 --- a/docs/atl/reference/irunnableobjectimpl-class.md +++ b/docs/atl/reference/irunnableobjectimpl-class.md @@ -4,10 +4,11 @@ title: "IRunnableObjectImpl Class" ms.date: "11/04/2016" f1_keywords: ["IRunnableObjectImpl", "ATLCTL/ATL::IRunnableObjectImpl", "ATLCTL/ATL::IRunnableObjectImpl::GetRunningClass", "ATLCTL/ATL::IRunnableObjectImpl::IsRunning", "ATLCTL/ATL::IRunnableObjectImpl::LockRunning", "ATLCTL/ATL::IRunnableObjectImpl::Run", "ATLCTL/ATL::IRunnableObjectImpl::SetContainedObject"] helpviewer_keywords: ["containers, running controls", "IRunnableObjectImpl class", "IRunnableObject, ATL implementation", "controls [ATL], running", "controls [C++], container running in ATL"] -ms.assetid: 305c7c3b-889e-49dd-aca1-34379c1b9931 --- # IRunnableObjectImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and provides a default implementation of the [IRunnableObject](/windows/win32/api/objidl/nn-objidl-irunnableobject) interface. > [!IMPORTANT] diff --git a/docs/atl/reference/iserviceproviderimpl-class.md b/docs/atl/reference/iserviceproviderimpl-class.md index 6cd8822fddc..682901b2c7d 100644 --- a/docs/atl/reference/iserviceproviderimpl-class.md +++ b/docs/atl/reference/iserviceproviderimpl-class.md @@ -4,10 +4,11 @@ title: "IServiceProviderImpl Class" ms.date: "11/04/2016" f1_keywords: ["IServiceProviderImpl", "ATLCOM/ATL::IServiceProviderImpl", "ATLCOM/ATL::IServiceProviderImpl::QueryService"] helpviewer_keywords: ["IServiceProviderImpl class", "IServiceProvider interface, ATL implementation"] -ms.assetid: 251254d3-c4ce-40d7-aee0-3d676d1d72f2 --- # IServiceProviderImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a default implementation of the `IServiceProvider` interface. ## Syntax diff --git a/docs/atl/reference/ispecifypropertypagesimpl-class.md b/docs/atl/reference/ispecifypropertypagesimpl-class.md index ae7b4481938..5549949feed 100644 --- a/docs/atl/reference/ispecifypropertypagesimpl-class.md +++ b/docs/atl/reference/ispecifypropertypagesimpl-class.md @@ -4,10 +4,11 @@ title: "ISpecifyPropertyPagesImpl Class" ms.date: "11/04/2016" f1_keywords: ["ISpecifyPropertyPagesImpl", "ATLCOM/ATL::ISpecifyPropertyPagesImpl", "ATLCOM/ATL::ISpecifyPropertyPagesImpl::GetPages"] helpviewer_keywords: ["property pages, CLSIDs associated with", "ISpecifyPropertyPages", "ISpecifyPropertyPagesImpl class"] -ms.assetid: 4e4b9795-b656-4d56-9b8c-85941e7731f9 --- # ISpecifyPropertyPagesImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and provides a default implementation of the [ISpecifyPropertyPages](/windows/win32/api/ocidl/nn-ocidl-ispecifypropertypages) interface. > [!IMPORTANT] diff --git a/docs/atl/reference/isupporterrorinfoimpl-class.md b/docs/atl/reference/isupporterrorinfoimpl-class.md index b9146cc6cf8..b9b4bcdb872 100644 --- a/docs/atl/reference/isupporterrorinfoimpl-class.md +++ b/docs/atl/reference/isupporterrorinfoimpl-class.md @@ -4,10 +4,11 @@ title: "ISupportErrorInfoImpl Class" ms.date: "06/13/2019" f1_keywords: ["ISupportErrorInfoImpl", "ATLCOM/ATL::ISupportErrorInfoImpl", "ATLCOM/ATL::ISupportErrorInfoImpl::InterfaceSupportsErrorInfo"] helpviewer_keywords: ["ISupportErrorInfo ATL implementation", "ISupportErrorInfoImpl class", "error information, ATL"] -ms.assetid: e33a4b11-a123-41cf-bcea-7b19743902af --- # ISupportErrorInfoImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides a default implementation of the [ISupportErrorInfo Interface](/windows/win32/api/oaidl/nn-oaidl-isupporterrorinfo) and can be used when only a single interface generates errors on an object. > [!IMPORTANT] diff --git a/docs/atl/reference/ithreadpoolconfig-interface.md b/docs/atl/reference/ithreadpoolconfig-interface.md index 3a3411e1366..1061b138d72 100644 --- a/docs/atl/reference/ithreadpoolconfig-interface.md +++ b/docs/atl/reference/ithreadpoolconfig-interface.md @@ -4,10 +4,11 @@ title: "IThreadPoolConfig Interface" ms.date: "11/04/2016" f1_keywords: ["IThreadPoolConfig", "ATLUTIL/ATL::IThreadPoolConfig", "ATLUTIL/ATL::GetSize", "ATLUTIL/ATL::GetTimeout", "ATLUTIL/ATL::SetSize", "ATLUTIL/ATL::SetTimeout"] helpviewer_keywords: ["IThreadPoolConfig interface"] -ms.assetid: 69e642bf-6925-46e6-9a37-cce52231b1cc --- # IThreadPoolConfig Interface +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This interface provides methods for configuring a thread pool. > [!IMPORTANT] diff --git a/docs/atl/reference/iviewobjecteximpl-class.md b/docs/atl/reference/iviewobjecteximpl-class.md index ad03e3ac103..b2faac4bb81 100644 --- a/docs/atl/reference/iviewobjecteximpl-class.md +++ b/docs/atl/reference/iviewobjecteximpl-class.md @@ -4,10 +4,11 @@ title: "IViewObjectExImpl Class" ms.date: "11/04/2016" f1_keywords: ["IViewObjectExImpl", "ATLCTL/ATL::IViewObjectExImpl", "ATLCTL/ATL::IViewObjectExImpl::Draw", "ATLCTL/ATL::IViewObjectExImpl::Freeze", "ATLCTL/ATL::IViewObjectExImpl::GetAdvise", "ATLCTL/ATL::IViewObjectExImpl::GetColorSet", "ATLCTL/ATL::IViewObjectExImpl::GetExtent", "ATLCTL/ATL::IViewObjectExImpl::GetNaturalExtent", "ATLCTL/ATL::IViewObjectExImpl::GetRect", "ATLCTL/ATL::IViewObjectExImpl::GetViewStatus", "ATLCTL/ATL::IViewObjectExImpl::QueryHitPoint", "ATLCTL/ATL::IViewObjectExImpl::QueryHitRect", "ATLCTL/ATL::IViewObjectExImpl::SetAdvise", "ATLCTL/ATL::IViewObjectExImpl::Unfreeze"] helpviewer_keywords: ["ActiveX controls [C++], drawing", "IViewObjectEx ATL implementation", "advise sinks", "IViewObjectExImpl class"] -ms.assetid: ad6de760-1ee5-4883-b033-ae57beffc369 --- # IViewObjectExImpl Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class implements `IUnknown` and provides default implementations of the [IViewObject](/windows/win32/api/oleidl/nn-oleidl-iviewobject), [IViewObject2](/windows/win32/api/oleidl/nn-oleidl-iviewobject2), and [IViewObjectEx](/windows/win32/api/ocidl/nn-ocidl-iviewobjectex) interfaces. > [!IMPORTANT] diff --git a/docs/atl/reference/iworkerthreadclient-interface.md b/docs/atl/reference/iworkerthreadclient-interface.md index c962eb0cdf8..46cf241e897 100644 --- a/docs/atl/reference/iworkerthreadclient-interface.md +++ b/docs/atl/reference/iworkerthreadclient-interface.md @@ -4,10 +4,11 @@ title: "IWorkerThreadClient Interface" ms.date: "11/04/2016" f1_keywords: ["IWorkerThreadClient", "ATLUTIL/ATL::IWorkerThreadClient", "ATLUTIL/ATL::CloseHandle", "ATLUTIL/ATL::Execute"] helpviewer_keywords: ["IWorkerThreadClient interface"] -ms.assetid: 56f4a2f5-007e-4a33-9e20-05187629f715 --- # IWorkerThreadClient Interface +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + `IWorkerThreadClient` is the interface implemented by clients of the [CWorkerThread](../../atl/reference/cworkerthread-class.md) class. > [!IMPORTANT] diff --git a/docs/atl/reference/making-an-atl-object-noncreatable.md b/docs/atl/reference/making-an-atl-object-noncreatable.md index 6a144323321..cda5e5b2a71 100644 --- a/docs/atl/reference/making-an-atl-object-noncreatable.md +++ b/docs/atl/reference/making-an-atl-object-noncreatable.md @@ -4,10 +4,11 @@ title: "Making an ATL Object Noncreatable" ms.date: "11/04/2016" f1_keywords: ["vc.appwiz.ATL.objects"] helpviewer_keywords: ["noncreatable ATL objects", "ATL projects, noncreatable objects"] -ms.assetid: 80d0bca2-dea0-4801-9a85-6243124437f6 --- # Making an ATL Object Noncreatable +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + You can change the attributes of an ATL-based COM object so that a client cannot directly create the object. In this case, the object would be returned through a method call on another object rather than created directly. ## To make an object noncreatable diff --git a/docs/atl/reference/marshaling-global-functions.md b/docs/atl/reference/marshaling-global-functions.md index 74ec8bf7143..721a8e52101 100644 --- a/docs/atl/reference/marshaling-global-functions.md +++ b/docs/atl/reference/marshaling-global-functions.md @@ -3,10 +3,11 @@ description: "Learn more about: Marshaling Global Functions" title: "Marshaling Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlbase/ATL::AtlFreeMarshalStream", "atlbase/ATL::AtlMarshalPtrInProc", "atlbase/ATL::AtlUnmarshalPtr"] -ms.assetid: 877100b5-6ad9-44c5-a2e0-09414f1720d0 --- # Marshaling Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide support for marshaling and converting marshaling data into interface pointers. > [!IMPORTANT] diff --git a/docs/atl/reference/message-map-macros-atl.md b/docs/atl/reference/message-map-macros-atl.md index 99775caee56..b94fb021afd 100644 --- a/docs/atl/reference/message-map-macros-atl.md +++ b/docs/atl/reference/message-map-macros-atl.md @@ -3,10 +3,11 @@ description: "Learn more about: Message Map Macros (ATL)" title: "Message Map Macros (ATL)" ms.date: "11/04/2016" f1_keywords: ["atlwin/ATL::ALT_MSG_MAP", "atlwin/ATL::BEGIN_MSG_MAP", "atlwin/ATL::CHAIN_MSG_MAP_ALT", "atlwin/ATL::CHAIN_MSG_MAP_ALT_MEMBER", "atlwin/ATL::CHAIN_MSG_MAP", "atlwin/ATL::CHAIN_MSG_MAP_DYNAMIC", "atlwin/ATL::CHAIN_MSG_MAP_MEMBER", "atlwin/ATL::COMMAND_CODE_HANDLER", "atlwin/ATL::COMMAND_HANDLER", "atlwin/ATL::COMMAND_ID_HANDLER", "atlwin/ATL::COMMAND_RANGE_CODE_HANDLER", "atlwin/ATL::COMMAND_RANGE_HANDLER", "atlwin/ATL::DECLARE_EMPTY_MSG_MAP", "atlwin/ATL::DEFAULT_REFLECTION_HANDLER", "atlwin/ATL::END_MSG_MAP", "atlwin/ATL::FORWARD_NOTIFICATIONS", "atlwin/ATL::MESSAGE_HANDLER", "atlwin/ATL::MESSAGE_RANGE_HANDLER", "atlwin/ATL::NOTIFY_CODE_HANDLER", "atlwin/ATL::NOTIFY_HANDLER", "atlwin/ATL::NOTIFY_ID_HANDLER", "atlwin/ATL::NOTIFY_RANGE_CODE_HANDLER", "atlwin/ATL::NOTIFY_RANGE_HANDLER", "atlwin/ATL::REFLECT_NOTIFICATIONS", "atlwin/ATL::REFLECTED_COMMAND_CODE_HANDLER", "atlwin/ATL::REFLECTED_COMMAND_HANDLER", "atlwin/ATL::REFLECTED_COMMAND_ID_HANDLER", "atlwin/ATL::REFLECTED_COMMAND_RANGE_CODE_HANDLER", "atlwin/ATL::REFLECTED_COMMAND_RANGE_HANDLER", "atlwin/ATL::REFLECTED_NOTIFY_CODE_HANDLER", "atlwin/ATL::REFLECTED_NOTIFY_HANDLER", "atlwin/ATL::REFLECTED_NOTIFY_ID_HANDLER", "atlwin/ATL::REFLECTED_NOTIFY_RANGE_CODE_HANDLER", "atlwin/ATL::REFLECTED_NOTIFY_RANGE_HANDLER", "ATLWIN/ALT_MSG_MAP", "ATLWIN/BEGIN_MSG_MAP", "ATLWIN/CHAIN_MSG_MAP_ALT", "ATLWIN/CHAIN_MSG_MAP_ALT_MEMBER", "ATLWIN/CHAIN_MSG_MAP", "ATLWIN/CHAIN_MSG_MAP_DYNAMIC", "ATLWIN/CHAIN_MSG_MAP_MEMBER", "ATLWIN/COMMAND_CODE_HANDLER", "ATLWIN/COMMAND_HANDLER", "ATLWIN/COMMAND_ID_HANDLER", "ATLWIN/COMMAND_RANGE_CODE_HANDLER", "ATLWIN/COMMAND_RANGE_HANDLER", "ATLWIN/DECLARE_EMPTY_MSG_MAP", "ATLWIN/DEFAULT_REFLECTION_HANDLER", "ATLWIN/END_MSG_MAP", "ATLWIN/FORWARD_NOTIFICATIONS", "ATLWIN/MESSAGE_HANDLER", "ATLWIN/MESSAGE_RANGE_HANDLER", "ATLWIN/NOTIFY_CODE_HANDLER", "ATLWIN/NOTIFY_HANDLER", "ATLWIN/NOTIFY_ID_HANDLER", "ATLWIN/NOTIFY_RANGE_CODE_HANDLER", "ATLWIN/NOTIFY_RANGE_HANDLER", "ATLWIN/REFLECT_NOTIFICATIONS", "ATLWIN/REFLECTED_COMMAND_CODE_HANDLER", "ATLWIN/REFLECTED_COMMAND_HANDLER", "ATLWIN/REFLECTED_COMMAND_ID_HANDLER", "ATLWIN/REFLECTED_COMMAND_RANGE_CODE_HANDLER", "ATLWIN/REFLECTED_COMMAND_RANGE_HANDLER", "ATLWIN/REFLECTED_NOTIFY_CODE_HANDLER", "ATLWIN/REFLECTED_NOTIFY_HANDLER", "ATLWIN/REFLECTED_NOTIFY_ID_HANDLER", "ATLWIN/REFLECTED_NOTIFY_RANGE_CODE_HANDLER", "ATLWIN/REFLECTED_NOTIFY_RANGE_HANDLER"] -ms.assetid: eefdd546-8934-4a30-b263-9c06a8addcbd --- # Message Map Macros (ATL) +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define message maps and entries. |Name|Description| diff --git a/docs/atl/reference/mfc-support-in-atl-projects.md b/docs/atl/reference/mfc-support-in-atl-projects.md index c02e7ad566b..b3b28f91baa 100644 --- a/docs/atl/reference/mfc-support-in-atl-projects.md +++ b/docs/atl/reference/mfc-support-in-atl-projects.md @@ -4,10 +4,11 @@ title: "MFC Support in ATL Projects" ms.date: "11/04/2016" f1_keywords: ["vc.atl.addmfc"] helpviewer_keywords: ["ATL projects, MFC support"] -ms.assetid: f90b4276-cb98-4c11-902c-9ebcfe6f954b --- # MFC Support in ATL Projects +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + If you select **Support MFC** in the ATL Project Wizard, your project declares the application as an MFC application object (class). The project initializes the MFC library and instantiates a class (class *ProjName*) that is derived from [CWinApp](../../mfc/reference/cwinapp-class.md). This option is available for nonattributed ATL DLL projects only. diff --git a/docs/atl/reference/object-map-macros.md b/docs/atl/reference/object-map-macros.md index e0d53e8236d..aec214fd6db 100644 --- a/docs/atl/reference/object-map-macros.md +++ b/docs/atl/reference/object-map-macros.md @@ -3,10 +3,11 @@ description: "Learn more about: Object Map Macros" title: "Object Map Macros" ms.date: "11/04/2016" f1_keywords: ["atlcom/ATL::DECLARE_OBJECT_DESCRIPTION", "atlcom/ATL::OBJECT_ENTRY_AUTO", "atlcom/ATL::OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO", "ATLCOM/DECLARE_OBJECT_DESCRIPTION", "ATLCOM/OBJECT_ENTRY_AUTO", "ATLCOM/OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO"] -ms.assetid: 680087f4-9894-41dd-a79c-6f337e1f13c1 --- # Object Map Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define object maps and entries. |Name|Description| diff --git a/docs/atl/reference/object-status-macros.md b/docs/atl/reference/object-status-macros.md index 06a9bdb39fc..124d32d8e17 100644 --- a/docs/atl/reference/object-status-macros.md +++ b/docs/atl/reference/object-status-macros.md @@ -3,10 +3,11 @@ description: "Learn more about: Object Status Macros" title: "Object Status Macros" ms.date: "11/04/2016" f1_keywords: ["atlcom/ATL::DECLARE_OLEMISC_STATUS", "ATLCOM/DECLARE_OLEMISC_STATUS"] -ms.assetid: 727dbef2-a342-4157-9d64-a421805d9747 --- # Object Status Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This macro sets flags belonging to ActiveX controls. |Name|Description| diff --git a/docs/atl/reference/options-atl-active-server-page-component-wizard.md b/docs/atl/reference/options-atl-active-server-page-component-wizard.md index ee4d74799fe..7def4310f65 100644 --- a/docs/atl/reference/options-atl-active-server-page-component-wizard.md +++ b/docs/atl/reference/options-atl-active-server-page-component-wizard.md @@ -4,10 +4,11 @@ title: "Options, ATL Active Server Page Component Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.class.atl.asp.options"] helpviewer_keywords: ["ATL Active Server Page Component Wizard, options"] -ms.assetid: 54f34e26-53c7-4456-9675-cb86e356bde0 --- # Options, ATL Active Server Page Component Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Use this page of the ATL Active Server Page Component Wizard to design for increased efficiency and error support for the object. For more information on ATL projects and ATL COM classes, see [ATL COM Desktop Components](../../atl/atl-com-desktop-components.md). diff --git a/docs/atl/reference/options-atl-control-wizard.md b/docs/atl/reference/options-atl-control-wizard.md index b6ec7ec9d06..b2656d02218 100644 --- a/docs/atl/reference/options-atl-control-wizard.md +++ b/docs/atl/reference/options-atl-control-wizard.md @@ -4,10 +4,11 @@ title: "Options, ATL Control Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.class.atl.control.options"] helpviewer_keywords: ["ATL Control Wizard, options"] -ms.assetid: 4607c51a-992d-433e-9281-919c6f519a3d --- # Options, ATL Control Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Use this page of the wizard to define the type of control you are creating and the level of interface support it contains. ## UIElement List diff --git a/docs/atl/reference/options-atl-property-page-wizard.md b/docs/atl/reference/options-atl-property-page-wizard.md index a49caf9d072..cbf30f158dc 100644 --- a/docs/atl/reference/options-atl-property-page-wizard.md +++ b/docs/atl/reference/options-atl-property-page-wizard.md @@ -4,10 +4,11 @@ title: "Options, ATL Property Page Wizard" ms.date: "05/09/2019" f1_keywords: ["vc.codewiz.class.atl.ppg.options"] helpviewer_keywords: ["ATL Property Page Wizard, options"] -ms.assetid: a7107779-b2ea-4f99-b84b-7f3e0c504bc8 --- # Options, ATL Property Page Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" The ATL Property Page wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/options-atl-simple-object-wizard.md b/docs/atl/reference/options-atl-simple-object-wizard.md index a15ab0eccc0..b3e62ebf15c 100644 --- a/docs/atl/reference/options-atl-simple-object-wizard.md +++ b/docs/atl/reference/options-atl-simple-object-wizard.md @@ -4,10 +4,11 @@ title: "Options, ATL Simple Object Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.class.atl.simple.options"] helpviewer_keywords: ["ATL Simple Object Wizard, options"] -ms.assetid: 125fe179-942d-4181-8b82-33e92e1fd779 --- # Options, ATL Simple Object Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Use this page of the ATL Simple Object Wizard to design for increased efficiency and error support for the object. For more information on ATL projects and ATL COM classes, see [ATL COM Desktop Components](../../atl/atl-com-desktop-components.md). diff --git a/docs/atl/reference/pixel-himetric-conversion-global-functions.md b/docs/atl/reference/pixel-himetric-conversion-global-functions.md index 3e1c7e9264d..19634eccdff 100644 --- a/docs/atl/reference/pixel-himetric-conversion-global-functions.md +++ b/docs/atl/reference/pixel-himetric-conversion-global-functions.md @@ -3,10 +3,11 @@ description: "Learn more about: Pixel/HIMETRIC Conversion Global Functions" title: "Pixel-HIMETRIC Conversion Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlwin/ATL::AtlHiMetricToPixel", "atlwin/ATL::AtlPixelToHiMetric"] -ms.assetid: ecb1b1b2-7e9d-4fbc-a855-16252d2d794c --- # Pixel/HIMETRIC Conversion Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide support for converting to and from pixel and HIMETRIC units. > [!IMPORTANT] diff --git a/docs/atl/reference/property-map-macros.md b/docs/atl/reference/property-map-macros.md index c0e785543db..1556a46baaf 100644 --- a/docs/atl/reference/property-map-macros.md +++ b/docs/atl/reference/property-map-macros.md @@ -4,10 +4,11 @@ title: "Property Map Macros" ms.date: "11/04/2016" f1_keywords: ["atlcom/ATL::BEGIN_PROP_MAP", "atlcom/ATL::PROP_DATA_ENTRY", "atlcom/ATL::PROP_ENTRY_TYPE", "atlcom/ATL::PROP_ENTRY_TYPE_EX", "atlcom/ATL::PROP_PAGE", "atlcom/ATL::END_PROP_MAP", "ATLCOM/BEGIN_PROP_MAP", "ATLCOM/PROP_DATA_ENTRY", "ATLCOM/PROP_ENTRY_TYPE", "ATLCOM/PROP_ENTRY_TYPE_EX", "ATLCOM/PROP_PAGE", "ATLCOM/END_PROP_MAP"] helpviewer_keywords: ["property maps"] -ms.assetid: 128bc742-2b98-4b97-a243-684dbb83db77 --- # Property Map Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define property maps and entries. |Name|Description| diff --git a/docs/atl/reference/registry-and-typelib-global-functions.md b/docs/atl/reference/registry-and-typelib-global-functions.md index c97812f48d0..74287bfd26f 100644 --- a/docs/atl/reference/registry-and-typelib-global-functions.md +++ b/docs/atl/reference/registry-and-typelib-global-functions.md @@ -4,10 +4,11 @@ title: "Registry and TypeLib Global Functions" ms.date: "03/27/2019" f1_keywords: ["atlbase/ATL::AtlGetPerUserRegistration", "afxpriv/ATL::AfxRegCreateKey", "afxpriv/ATL::AfxRegDeleteKey", "atlbase/ATL::AtlRegisterTypeLib", "afxpriv/ATL::AfxRegOpenKey", "afxpriv/ATL::AfxRegOpenKeyEx", "afxdisp/ATL::AfxUnregisterPreviewHandler", "atlbase/ATL::AtlSetPerUserRegistration", "atlbase/ATL::AtlUnRegisterTypeLib", "atlbase/ATL::AtlLoadTypeLib", "atlbase/ATL::AtlUpdateRegistryFromResourceD", "atlbase/ATL::RegistryDataExchange"] helpviewer_keywords: ["RegistryDataExchange function, global functions"] -ms.assetid: d58b8a4e-975c-4417-8b34-d3c847f679b3 --- # Registry and TypeLib Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide support for loading and registering a type library. > [!IMPORTANT] diff --git a/docs/atl/reference/registry-data-exchange-macros.md b/docs/atl/reference/registry-data-exchange-macros.md index 98857707a31..76afbece908 100644 --- a/docs/atl/reference/registry-data-exchange-macros.md +++ b/docs/atl/reference/registry-data-exchange-macros.md @@ -4,10 +4,11 @@ title: "Registry Data Exchange Macros" ms.date: "11/04/2016" f1_keywords: ["atlplus/ATL::BEGIN_RDX_MAP", "atlplus/ATL::END_RDX_MAP", "atlplus/ATL::RDX_BINARY", "atlplus/ATL::RDX_CSTRING_TEXT", "atlplus/ATL::RDX_DWORD", "atlplus/ATL::RDX_TEXT", "ATLPLUS/BEGIN_RDX_MAP", "ATLPLUS/END_RDX_MAP", "ATLPLUS/RDX_BINARY", "ATLPLUS/RDX_CSTRING_TEXT", "ATLPLUS/RDX_DWORD", "ATLPLUS/RDX_TEXT"] helpviewer_keywords: ["RegistryDataExchange function, macros"] -ms.assetid: c1bc5e79-2307-43d2-9d10-3a62ffadf473 --- # Registry Data Exchange Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros perform Registry Data Exchange operations. |Name|Description| diff --git a/docs/atl/reference/registry-macros.md b/docs/atl/reference/registry-macros.md index f18617f0fe5..1d5b75f746f 100644 --- a/docs/atl/reference/registry-macros.md +++ b/docs/atl/reference/registry-macros.md @@ -4,10 +4,11 @@ title: "Registry Macros" ms.date: "08/19/2019" f1_keywords: ["ATLBASE/_ATL_STATIC_REGISTRY", "ATLBASE/DECLARE_LIBID", "ATLBASE/DECLARE_NO_REGISTRY", "ATLBASE/DECLARE_REGISTRY", "ATLBASE/DECLARE_REGISTRY_APPID_RESOURCEID", "ATLBASE/DECLARE_REGISTRY_RESOURCE", "ATLBASE/DECLARE_REGISTRY_RESOURCEID", "_ATL_STATIC_REGISTRY", "DECLARE_LIBID", "DECLARE_NO_REGISTRY", "DECLARE_REGISTRY", "DECLARE_REGISTRY_APPID_RESOURCEID", "DECLARE_REGISTRY_RESOURCE", "DECLARE_REGISTRY_RESOURCEID"] helpviewer_keywords: ["registry, ATL macros"] -ms.assetid: 3ee041da-c63b-42a4-89cf-2a4b2a6f81ae --- # Registry Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define useful type library and registry facilities. |Name|Description| diff --git a/docs/atl/reference/security-global-functions.md b/docs/atl/reference/security-global-functions.md index e42bcb30f72..25ea04d962f 100644 --- a/docs/atl/reference/security-global-functions.md +++ b/docs/atl/reference/security-global-functions.md @@ -4,10 +4,11 @@ title: "Security Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlsecurity/ATL::AtlGetDacl", "atlsecurity/ATL::AtlSetDacl", "atlsecurity/ATL::AtlGetGroupSid", "atlsecurity/ATL::AtlSetGroupSid", "atlsecurity/ATL::AtlGetOwnerSid", "atlsecurity/ATL::AtlSetOwnerSid", "atlsecurity/ATL::AtlGetSacl", "atlsecurity/ATL::AtlSetSacl", "atlsecurity/ATL::AtlGetSecurityDescriptor"] helpviewer_keywords: ["SIDs [C++], modifying SID objects", "ACL object global functions", "security IDs [C++]"] -ms.assetid: 6a584bfe-16b7-47f4-8439-9c789c41567a --- # Security Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide support for modifying SID and ACL objects. > [!IMPORTANT] diff --git a/docs/atl/reference/security-identifier-global-functions.md b/docs/atl/reference/security-identifier-global-functions.md index d429e27b2a4..c390c7f3951 100644 --- a/docs/atl/reference/security-identifier-global-functions.md +++ b/docs/atl/reference/security-identifier-global-functions.md @@ -4,10 +4,11 @@ title: "Security Identifier Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlsecurity/ATL::Sids::AccountOps", "atlsecurity/ATL::Sids::Admins", "atlsecurity/ATL::Sids::AnonymousLogon", "atlsecurity/ATL::Sids::AuthenticatedUser", "atlsecurity/ATL::Sids::BackupOps", "atlsecurity/ATL::Sids::Batch", "atlsecurity/ATL::Sids::CreatorGroup", "atlsecurity/ATL::Sids::CreatorGroupServer", "atlsecurity/ATL::Sids::CreatorOwner", "atlsecurity/ATL::Sids::CreatorOwnerServer", "atlsecurity/ATL::Sids::Dialup", "atlsecurity/ATL::Sids::Guests", "atlsecurity/ATL::Sids::Interactive", "atlsecurity/ATL::Sids::Local", "atlsecurity/ATL::Sids::Network", "atlsecurity/ATL::Sids::NetworkService", "atlsecurity/ATL::Sids::Null", "atlsecurity/ATL::Sids::PowerUsers", "atlsecurity/ATL::Sids::PrintOps", "atlsecurity/ATL::Sids::Proxy", "atlsecurity/ATL::Sids::RasServers", "atlsecurity/ATL::Sids::Replicator", "atlsecurity/ATL::Sids::RestrictedCode", "atlsecurity/ATL::Sids::Self", "atlsecurity/ATL::Sids::ServerLogon", "atlsecurity/ATL::Sids::Service", "atlsecurity/ATL::Sids::System", "atlsecurity/ATL::Sids::SystemOps", "atlsecurity/ATL::Sids::TerminalServer", "atlsecurity/ATL::Sids::Users", "atlsecurity/ATL::Sids::World"] helpviewer_keywords: ["security IDs [C++]", "SIDs [C++], returning SID objects"] -ms.assetid: 85404dcb-c59b-4535-ab3d-66cfa37e87de --- # Security Identifier Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions return common well-known SID objects. > [!IMPORTANT] diff --git a/docs/atl/reference/server-registration-global-functions.md b/docs/atl/reference/server-registration-global-functions.md index 4277c7c13a8..084c2b5257e 100644 --- a/docs/atl/reference/server-registration-global-functions.md +++ b/docs/atl/reference/server-registration-global-functions.md @@ -3,10 +3,11 @@ description: "Learn more about: Server Registration Global Functions" title: "Server Registration Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlbase/ATL::AtlComModuleRegisterServer", "atlbase/ATL::AtlComModuleUnregisterServer", "atlbase/ATL::AtlComModuleRegisterClassObjects", "atlbase/ATL::AtlComModuleRevokeClassObjects", "atlbase/ATL::AtlComModuleGetClassObject"] -ms.assetid: c2f0a35d-857c-4538-a44d-c4ea0db63b06 --- # Server Registration Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide support for registering and unregistering server objects in the object map. > [!IMPORTANT] diff --git a/docs/atl/reference/service-map-macros.md b/docs/atl/reference/service-map-macros.md index b42010306af..923b3b80708 100644 --- a/docs/atl/reference/service-map-macros.md +++ b/docs/atl/reference/service-map-macros.md @@ -3,10 +3,11 @@ description: "Learn more about: Service Map Macros" title: "Service Map Macros" ms.date: "11/04/2016" f1_keywords: ["atlcom/ATL::BEGIN_SERVICE_MAP", "atlcom/ATL::END_SERVICE_MAP", "atlcom/ATL::SERVICE_ENTRY", "atlcom/ATL::SERVICE_ENTRY_CHAIN", "ATLCOM/BEGIN_SERVICE_MAP", "ATLCOM/END_SERVICE_MAP", "ATLCOM/SERVICE_ENTRY", "ATLCOM/SERVICE_ENTRY_CHAIN"] -ms.assetid: ca02a125-454a-4cf6-aac2-1c5585025ed4 --- # Service Map Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define service maps and entries. |Name|Description| diff --git a/docs/atl/reference/snap-in-object-macros.md b/docs/atl/reference/snap-in-object-macros.md index 380f4cf1169..d4a210f6777 100644 --- a/docs/atl/reference/snap-in-object-macros.md +++ b/docs/atl/reference/snap-in-object-macros.md @@ -3,10 +3,11 @@ description: "Learn more about: Snap-In Object Macros" title: "Snap-In Object Macros" ms.date: "11/04/2016" f1_keywords: ["atlsnap/ATL::BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP", "atlsnap/ATL::BEGIN_SNAPINTOOLBARID_MAP", "atlsnap/ATL::END_EXTENSION_SNAPIN_NODEINFO_MAP", "atlsnap/ATL::END_SNAPINTOOLBARID_MAP", "atlsnap/ATL::EXTENSION_SNAPIN_DATACLASS", "atlsnap/ATL::EXTENSION_SNAPIN_NODEINFO_ENTRY", "atlsnap/ATL::SNAPINMENUID", "atlsnap/ATL::SNAPINTOOLBARID_ENTRY", "ATLSNAP/BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP", "ATLSNAP/BEGIN_SNAPINTOOLBARID_MAP", "ATLSNAP/END_EXTENSION_SNAPIN_NODEINFO_MAP", "ATLSNAP/END_SNAPINTOOLBARID_MAP", "ATLSNAP/EXTENSION_SNAPIN_DATACLASS", "ATLSNAP/EXTENSION_SNAPIN_NODEINFO_ENTRY", "ATLSNAP/SNAPINMENUID", "ATLSNAP/SNAPINTOOLBARID_ENTRY"] -ms.assetid: 4e9850c0-e395-4929-86c9-584a81828053 --- # Snap-In Object Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros provide support for snap-in extensions. |Name|Description| diff --git a/docs/atl/reference/specifying-compiler-optimization-for-an-atl-project.md b/docs/atl/reference/specifying-compiler-optimization-for-an-atl-project.md index c59923486a7..faaa0a50052 100644 --- a/docs/atl/reference/specifying-compiler-optimization-for-an-atl-project.md +++ b/docs/atl/reference/specifying-compiler-optimization-for-an-atl-project.md @@ -4,10 +4,11 @@ title: "Specifying Compiler Optimization for an ATL Project" ms.date: "08/19/2019" f1_keywords: ["vc.appwiz.ATL.optimization", "vc.appwiz.ATL.vtable"] helpviewer_keywords: ["ATL_DISABLE_NO_VTABLE macro", "ATL projects, compiler optimization", "ATL_NO_VTABLE macro"] -ms.assetid: 7f379318-66d5-43dd-a53d-530758d3a228 --- # Specifying Compiler Optimization for an ATL Project +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + By default, the [ATL Control Wizard](../../atl/reference/atl-control-wizard.md) generates new classes with the ATL_NO_VTABLE macro, as follows: ``` diff --git a/docs/atl/reference/stock-properties-atl-control-wizard.md b/docs/atl/reference/stock-properties-atl-control-wizard.md index d71b29f1d24..b5e748c87a7 100644 --- a/docs/atl/reference/stock-properties-atl-control-wizard.md +++ b/docs/atl/reference/stock-properties-atl-control-wizard.md @@ -3,10 +3,11 @@ description: "Learn more about: Stock Properties, ATL Control Wizard" title: "Stock Properties, ATL Control Wizard" ms.date: "11/04/2016" f1_keywords: ["vc.codewiz.class.atl.control.stockprops"] -ms.assetid: b27b0e60-08a6-43f4-ba6e-0a4e45147693 --- # Stock Properties, ATL Control Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This page of the wizard identifies the stock properties supported for the control. By default, no properties are identified. - **Not supported** diff --git a/docs/atl/reference/string-conversion-macros.md b/docs/atl/reference/string-conversion-macros.md index 9b67e45e5f2..34e484087c7 100644 --- a/docs/atl/reference/string-conversion-macros.md +++ b/docs/atl/reference/string-conversion-macros.md @@ -3,10 +3,11 @@ description: "Learn more about: String Conversion Macros" title: "String Conversion Macros" ms.date: "11/04/2016" f1_keywords: ["atlconv/ATL::DEVMODEA2W", "atlconv/ATL::TEXTMETRICA2W", "atlconv/ATL::DEVMODEOLE2T", "atlconv/ATL::TEXTMETRICOLE2T", "atlconv/ATL::DEVMODET2OLE", "atlconv/ATL::TEXTMETRICT2OLE", "atlconv/ATL::DEVMODEW2A", "atlconv/ATL::TEXTMETRICW2A", "ATLCONV/DEVMODEA2W", "ATLCONV/TEXTMETRICA2W", "ATLCONV/DEVMODEOLE2T", "ATLCONV/TEXTMETRICOLE2T", "ATLCONV/DEVMODET2OLE", "ATLCONV/TEXTMETRICT2OLE", "ATLCONV/DEVMODEW2A", "ATLCONV/TEXTMETRICW2A"] -ms.assetid: 2ff7c0b6-2bde-45fe-897f-6128e18e0c27 --- # String Conversion Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros provide string conversion features. ## ATL and MFC String Conversion Macros diff --git a/docs/atl/reference/strings-atl-property-page-wizard.md b/docs/atl/reference/strings-atl-property-page-wizard.md index af7682dd9f2..c9ed6e81a2a 100644 --- a/docs/atl/reference/strings-atl-property-page-wizard.md +++ b/docs/atl/reference/strings-atl-property-page-wizard.md @@ -4,10 +4,11 @@ title: "Strings, ATL Property Page Wizard" ms.date: "05/09/2019" f1_keywords: ["vc.codewiz.class.atl.ppg.strings"] helpviewer_keywords: ["ATL Property Page Wizard, strings"] -ms.assetid: 00547db6-911f-49eb-92e1-2ba67079d4df --- # Strings, ATL Property Page Wizard +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + ::: moniker range=">=msvc-160" The ATL Property Page wizard is not available in Visual Studio 2019 and later. diff --git a/docs/atl/reference/u-menuorid-class.md b/docs/atl/reference/u-menuorid-class.md index cd2b60ec3e5..f20de6ecfa3 100644 --- a/docs/atl/reference/u-menuorid-class.md +++ b/docs/atl/reference/u-menuorid-class.md @@ -4,10 +4,11 @@ title: "_U_MENUorID Class" ms.date: "11/04/2016" f1_keywords: ["ATL._U_MENUorID", "ATL::_U_MENUorID", "_U_MENUorID"] helpviewer_keywords: ["U_MENUorID class", "_U_MENUorID class"] -ms.assetid: cfc8032b-61b4-4a68-ba3a-92b82500ccae --- # _U_MENUorID Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides wrappers for `CreateWindow` and `CreateWindowEx`. > [!IMPORTANT] diff --git a/docs/atl/reference/u-rect-class.md b/docs/atl/reference/u-rect-class.md index 515c8add351..2a86016dd22 100644 --- a/docs/atl/reference/u-rect-class.md +++ b/docs/atl/reference/u-rect-class.md @@ -4,10 +4,11 @@ title: "_U_RECT Class" ms.date: "11/04/2016" f1_keywords: ["ATL::_U_RECT", "_U_RECT", "ATL._U_RECT"] helpviewer_keywords: ["U_RECT class", "_U_RECT class"] -ms.assetid: 5f880a2d-09cf-4327-bf32-a3519c4dcd63 --- # _U_RECT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This argument adapter class allows either `RECT` pointers or references to be passed to a function that is implemented in terms of pointers. > [!IMPORTANT] diff --git a/docs/atl/reference/u-stringorid-class.md b/docs/atl/reference/u-stringorid-class.md index d7148ff89ca..84488cd8aea 100644 --- a/docs/atl/reference/u-stringorid-class.md +++ b/docs/atl/reference/u-stringorid-class.md @@ -4,10 +4,11 @@ title: "_U_STRINGorID Class" ms.date: "11/04/2016" f1_keywords: ["ATL._U_STRINGorID", "ATL::_U_STRINGorID", "_U_STRINGorID"] helpviewer_keywords: ["_U_STRINGorID class", "U_STRINGorID class"] -ms.assetid: 443cdc00-d265-4b27-8ef3-2feb95f3e5e3 --- # _U_STRINGorID Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This argument adapter class allows either resource names (LPCTSTRs) or resource IDs (UINTs) to be passed to a function without requiring the caller to convert the ID to a string using the MAKEINTRESOURCE macro. > [!IMPORTANT] diff --git a/docs/atl/reference/win32threadtraits-class.md b/docs/atl/reference/win32threadtraits-class.md index 2d4f1fa008f..321d51e832c 100644 --- a/docs/atl/reference/win32threadtraits-class.md +++ b/docs/atl/reference/win32threadtraits-class.md @@ -4,10 +4,11 @@ title: "Win32ThreadTraits Class" ms.date: "11/04/2016" f1_keywords: ["Win32ThreadTraits", "ATLBASE/ATL::Win32ThreadTraits", "ATLBASE/ATL::Win32ThreadTraits::CreateThread"] helpviewer_keywords: ["threading [ATL], Windows threads", "threading [ATL], creation functions", "Win32ThreadTraits class"] -ms.assetid: 50279c38-eae1-4301-9ea6-97ccea580f3e --- # Win32ThreadTraits Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides the creation function for a Windows thread. Use this class if the thread will not use CRT functions. > [!IMPORTANT] diff --git a/docs/atl/reference/window-class-macros.md b/docs/atl/reference/window-class-macros.md index 4804e4b723c..13224f77bbc 100644 --- a/docs/atl/reference/window-class-macros.md +++ b/docs/atl/reference/window-class-macros.md @@ -3,10 +3,11 @@ description: "Learn more about: Window Class Macros" title: "Window Class Macros" ms.date: "11/04/2016" f1_keywords: ["atlwin/ATL::DECLARE_WND_CLASS", "atlwin/ATL::DECLARE_WND_SUPERCLASS", "atlwin/ATL::DECLARE_WND_CLASS_EX", "ATLWIN/DECLARE_WND_CLASS", "ATLWIN/DECLARE_WND_SUPERCLASS", "ATLWIN/DECLARE_WND_CLASS_EX"] -ms.assetid: ce18681a-2bab-4453-9895-0f3ea47c2b24 --- # Window Class Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These macros define window class utilities. |Name|Description| diff --git a/docs/atl/reference/windows-messages-macros.md b/docs/atl/reference/windows-messages-macros.md index 06753053208..222363698ed 100644 --- a/docs/atl/reference/windows-messages-macros.md +++ b/docs/atl/reference/windows-messages-macros.md @@ -3,10 +3,11 @@ description: "Learn more about: Windows Messages Macros" title: "Windows Messages Macros" ms.date: "11/04/2016" f1_keywords: ["atlbase/ATL::WM_FORWARDMSG", "ATLBASE/WM_FORWARDMSG"] -ms.assetid: 63abd22c-372d-4148-bb04-c605950ae64f --- # Windows Messages Macros +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This macro forwards window messages. |Name|Description| diff --git a/docs/atl/reference/winmodule-global-functions.md b/docs/atl/reference/winmodule-global-functions.md index c0708a6a568..2523f806fc7 100644 --- a/docs/atl/reference/winmodule-global-functions.md +++ b/docs/atl/reference/winmodule-global-functions.md @@ -3,10 +3,11 @@ description: "Learn more about: WinModule Global Functions" title: "WinModule Global Functions" ms.date: "11/04/2016" f1_keywords: ["atlbase/ATL::AtlWinModuleAddCreateWndData", "atlbase/ATL::AtlWinModuleExtractCreateWndData"] -ms.assetid: 8ce45a5b-26a7-491f-9096-c09ceca5f2c2 --- # WinModule Global Functions +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + These functions provide support for `_AtlCreateWndData` structure operations. > [!IMPORTANT] diff --git a/docs/atl/reference/worker-archetype.md b/docs/atl/reference/worker-archetype.md index e4a36e9702a..ec8e422243c 100644 --- a/docs/atl/reference/worker-archetype.md +++ b/docs/atl/reference/worker-archetype.md @@ -3,10 +3,11 @@ description: "Learn more about: Worker Archetype" title: "Worker Archetype" ms.date: "11/04/2016" helpviewer_keywords: ["Worker archetype"] -ms.assetid: 834145cd-09d3-4149-bc99-620e1871cbfb --- # Worker Archetype +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Classes that conform to the *worker* archetype provide the code to process work items queued on a thread pool. **Implementation** From 414b1e0eb4f0d20dba71bdbc5116eed1d8161943 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 25 Feb 2026 15:03:57 -0800 Subject: [PATCH 1665/1799] ATL batch 5: docs updates (files 395-426) --- docs/atl/registry-entries.md | 3 ++- docs/atl/registry-scripting-examples.md | 3 ++- docs/atl/registry-support-classes.md | 3 ++- docs/atl/running-objects-classes.md | 3 ++- docs/atl/running-the-program-as-a-local-server.md | 3 ++- docs/atl/scope-of-atl.md | 3 ++- docs/atl/security-classes.md | 3 ++- docs/atl/service-provider-support-classes.md | 3 ++- .../setting-up-a-static-link-to-the-registrar-code-cpp-only.md | 3 ++- docs/atl/site-information-classes.md | 3 ++- docs/atl/specifying-property-pages.md | 3 ++- docs/atl/specifying-the-threading-model-for-a-project-atl.md | 3 ++- docs/atl/string-and-text-classes.md | 3 ++- docs/atl/supporting-idispatch-and-ierrorinfo.md | 3 ++- docs/atl/supporting-idispeventimpl.md | 3 ++- docs/atl/testing-the-atl-dhtml-control.md | 3 ++- docs/atl/testing-the-modified-atl-dhtml-control.md | 3 ++- docs/atl/thread-pooling-classes.md | 3 ++- docs/atl/threading-models-and-critical-sections-classes.md | 3 ++- docs/atl/ui-support-classes.md | 3 ++- docs/atl/understanding-backus-naur-form-bnf-syntax.md | 3 ++- docs/atl/understanding-parse-trees.md | 2 ++ docs/atl/understanding-window-traits.md | 3 ++- docs/atl/using-a-template-library.md | 3 ++- docs/atl/using-a-window.md | 3 ++- docs/atl/using-contained-windows.md | 3 ++- docs/atl/using-idispeventimpl.md | 3 ++- docs/atl/using-idispeventsimpleimpl.md | 3 ++- ...sing-replaceable-parameters-the-registrar-s-preprocessor.md | 3 ++- docs/atl/using-task-manager.md | 3 ++- docs/atl/utility-classes.md | 3 ++- docs/atl/windows-support-classes.md | 3 ++- 32 files changed, 64 insertions(+), 31 deletions(-) diff --git a/docs/atl/registry-entries.md b/docs/atl/registry-entries.md index 30fd6299398..2f59a898775 100644 --- a/docs/atl/registry-entries.md +++ b/docs/atl/registry-entries.md @@ -3,10 +3,11 @@ description: "Learn more about: Registry Entries" title: "Registry Entries (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["registry, ATL services entries", "registry, application IDs"] -ms.assetid: 881989b7-61bb-459a-a13e-3bfcb33e184e --- # Registry Entries +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + DCOM introduced the concept of Application IDs (AppIDs), which group configuration options for one or more DCOM objects into a centralized location in the registry. You specify an AppID by indicating its value in the AppID named value under the object's CLSID. By default, an ATL-generated service uses its CLSID as the GUID for its AppID. Under `HKEY_CLASSES_ROOT\AppID`, you can specify DCOM-specific entries. Initially, two entries exist: diff --git a/docs/atl/registry-scripting-examples.md b/docs/atl/registry-scripting-examples.md index 605b92f0df0..55053c58db8 100644 --- a/docs/atl/registry-scripting-examples.md +++ b/docs/atl/registry-scripting-examples.md @@ -3,10 +3,11 @@ description: "Learn more about: Registry Scripting Examples" title: "Registry Scripting Examples" ms.date: "11/04/2016" helpviewer_keywords: ["scripting, examples", "registrar scripts [ATL]", "scripts, Registrar scripts", "registry, Registrar"] -ms.assetid: b6df80e1-e08b-40ee-9243-9b381b172460 --- # Registry Scripting Examples +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The scripting examples in this topic demonstrate how to add a key to the system registry, register the Registrar COM server, and specify multiple parse trees. ## Add a Key to HKEY_CURRENT_USER diff --git a/docs/atl/registry-support-classes.md b/docs/atl/registry-support-classes.md index 1aafad7ccfc..2e0b86bd46e 100644 --- a/docs/atl/registry-support-classes.md +++ b/docs/atl/registry-support-classes.md @@ -4,10 +4,11 @@ title: "Registry Support Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["registry support classes, ATL", "ATL, registry", "registry support classes"] -ms.assetid: 4203c346-77a9-42bf-8683-a3c3351cc490 --- # Registry Support Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following class provides registry support: - [CRegKey](../atl/reference/cregkey-class.md) Contains methods for manipulating values in the system registry. diff --git a/docs/atl/running-objects-classes.md b/docs/atl/running-objects-classes.md index 8d7c92b99fe..f621bae5721 100644 --- a/docs/atl/running-objects-classes.md +++ b/docs/atl/running-objects-classes.md @@ -4,10 +4,11 @@ title: "Running Objects Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["object classes, running", "objects [C++], running objects classes"] -ms.assetid: b4d63c41-81fd-4000-96c5-ea0a011f4308 --- # Running Objects Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following class provides support for running objects: - [IRunnableObjectImpl](../atl/reference/irunnableobjectimpl-class.md) Determines if an object is running, forces it to run, or locks it into the running state. diff --git a/docs/atl/running-the-program-as-a-local-server.md b/docs/atl/running-the-program-as-a-local-server.md index 647555b4552..4d1bc97c64e 100644 --- a/docs/atl/running-the-program-as-a-local-server.md +++ b/docs/atl/running-the-program-as-a-local-server.md @@ -3,11 +3,12 @@ description: "Learn more about: Running the Program as a Local Server" title: "Running the Program as a Local Server" ms.date: "11/04/2016" helpviewer_keywords: ["debugging [ATL], running services as local server", "ATL services, running as local servers"] -ms.assetid: eb9701e6-e2a8-4666-897f-0c893aec8ac7 ms.topic: concept-article --- # Running the Program as a Local Server +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + If running the program as a service is inconvenient, you can temporarily change the registry so that the program is run as a normal local server. Simply rename the `LocalService` value under your AppID to `_LocalService` and ensure the `LocalServer32` key under your CLSID is set correctly. (Note that using DCOMCNFG to specify that your application should be run on a different computer renames your `LocalServer32` key to `_LocalServer32`.) Running your program as a local server takes a few more seconds on startup because the call to `StartServiceCtrlDispatcher` in `CAtlServiceModuleT::Start` takes a few seconds before it fails. ## See also diff --git a/docs/atl/scope-of-atl.md b/docs/atl/scope-of-atl.md index bf84207f3b3..34b054cdbb3 100644 --- a/docs/atl/scope-of-atl.md +++ b/docs/atl/scope-of-atl.md @@ -3,10 +3,11 @@ description: "Learn more about: Scope of ATL" title: "Scope of ATL" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, scope"] -ms.assetid: 381adf50-3cb0-4d0f-a79a-07da093bc280 --- # Scope of ATL +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL allows you to easily create COM objects, Automation servers, and ActiveX controls. ATL provides built-in support for many of the fundamental COM interfaces. ATL is shipped as source code which you include in your application. ATL also makes a DLL available (atl90.dll), which contains code that can be shared across components. However, this DLL is not necessary. diff --git a/docs/atl/security-classes.md b/docs/atl/security-classes.md index c4d3e1acab7..e44ab3c8040 100644 --- a/docs/atl/security-classes.md +++ b/docs/atl/security-classes.md @@ -4,10 +4,11 @@ title: "Security Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["security classes [C++]"] -ms.assetid: 0477f1a4-c1af-4c4f-bbca-08f7b844e028 --- # Security Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + These classes are wrappers for common Win32 security classes and objects. - [CAccessToken](../atl/reference/caccesstoken-class.md) This class is a wrapper for an access token. diff --git a/docs/atl/service-provider-support-classes.md b/docs/atl/service-provider-support-classes.md index 9cce29b4cd7..a46d539dbf4 100644 --- a/docs/atl/service-provider-support-classes.md +++ b/docs/atl/service-provider-support-classes.md @@ -4,10 +4,11 @@ title: "Service Provider Support Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["service provider support classes"] -ms.assetid: 190f598e-fb32-4d37-adf1-21de395b04d9 --- # Service Provider Support Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following class provides support for service providers: - [IServiceProviderImpl](../atl/reference/iserviceproviderimpl-class.md) Locates a service specified by its GUID and returns the interface pointer for the requested interface on the service. diff --git a/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md b/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md index e5797ef152c..6b56f346110 100644 --- a/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md +++ b/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md @@ -3,11 +3,12 @@ title: "Setting up a static link to the Registrar code (C++ only)" description: "How to statically link C++ code to the ATL Registrar code." ms.date: 09/03/2020 helpviewer_keywords: ["statically linking to ATL Registrar code", "linking [C++], to ATL Registrar code"] -ms.assetid: 835f5885-87a6-48fa-91e6-60988ee65538 ms.topic: how-to --- # Setting up a static link to the Registrar code (C++ Only) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + C++ clients can create a static link to the Registrar's code. Static linking of the Registrar's parser adds approximately 5K to a release build. The simplest way to set up static linking assumes you have specified [`DECLARE_REGISTRY_RESOURCEID`](reference/registry-macros.md#declare_registry_resourceid) in your object's declaration. (It's the default specification used by the ATL.) diff --git a/docs/atl/site-information-classes.md b/docs/atl/site-information-classes.md index 4ece835b060..620d587be46 100644 --- a/docs/atl/site-information-classes.md +++ b/docs/atl/site-information-classes.md @@ -4,10 +4,11 @@ title: "Site Information Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["site information classes"] -ms.assetid: 102eae20-7953-4efb-b27b-409885c9c064 --- # Site Information Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes allow an object to communicate with its site: - [IObjectWithSiteImpl](../atl/reference/iobjectwithsiteimpl-class.md) Retrieves and sets a pointer to an object's site. Used for objects that are not controls. diff --git a/docs/atl/specifying-property-pages.md b/docs/atl/specifying-property-pages.md index 0213211d07c..507024c56c7 100644 --- a/docs/atl/specifying-property-pages.md +++ b/docs/atl/specifying-property-pages.md @@ -3,11 +3,12 @@ description: "Learn more about: Specifying Property Pages" title: "Specifying Property Pages (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ISpecifyPropertyPages method", "property pages, specifying"] -ms.assetid: ee8678cf-c708-49ab-b0ad-fc2db31f1ac3 ms.topic: how-to --- # Specifying Property Pages +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + When you create an ActiveX control, you will often want to associate it with property pages that can be used to set the properties of your control. Control containers use the `ISpecifyPropertyPages` interface to find out which property pages can be used to set your control's properties. You will need to implement this interface on your control. To implement `ISpecifyPropertyPages` using ATL, take the following steps: diff --git a/docs/atl/specifying-the-threading-model-for-a-project-atl.md b/docs/atl/specifying-the-threading-model-for-a-project-atl.md index f9d9ebeb3aa..690bb8c1a1e 100644 --- a/docs/atl/specifying-the-threading-model-for-a-project-atl.md +++ b/docs/atl/specifying-the-threading-model-for-a-project-atl.md @@ -3,11 +3,12 @@ description: "Learn more about: Specifying the Threading Model for a Project (AT title: "Specifying the Threading Model for a Project (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["_ATL_FREE_THREADED macro", "_ATL_APARTMENT_THREADED macro", "ATL, multithreading", "threading [ATL], models", "_ATL_SINGLE_THREADED macro"] -ms.assetid: 6b571078-521c-4f3e-9f08-482aa235a822 ms.topic: concept-article --- # Specifying the Threading Model for a Project (ATL) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following macros are available to specify the threading model of an ATL project: |Macro|Guidelines for using| diff --git a/docs/atl/string-and-text-classes.md b/docs/atl/string-and-text-classes.md index 3810a64d0d8..01bf9dde0e9 100644 --- a/docs/atl/string-and-text-classes.md +++ b/docs/atl/string-and-text-classes.md @@ -4,10 +4,11 @@ title: "ATL String and Text Classes" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["string conversion, ATL", "string classes [ATL]"] -ms.assetid: aa0cdc41-c953-4b17-82b6-59b908545571 --- # String and Text Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + These classes provide support for strings and text string conversions. - [CA2AEX](../atl/reference/ca2aex-class.md) This class is used by the string conversion macros CA2TEX and CT2AEX, and the typedef CA2A. diff --git a/docs/atl/supporting-idispatch-and-ierrorinfo.md b/docs/atl/supporting-idispatch-and-ierrorinfo.md index 97c49084358..97d5c06785d 100644 --- a/docs/atl/supporting-idispatch-and-ierrorinfo.md +++ b/docs/atl/supporting-idispatch-and-ierrorinfo.md @@ -3,11 +3,12 @@ description: "Learn more about: Supporting IDispatch and IErrorInfo" title: "Supporting IDispatch and IErrorInfo" ms.date: "11/04/2016" helpviewer_keywords: ["ISupportErrorInfoImpl method", "IErrorInfo class suppor in ATL", "IDispatchImpl class", "IDispatch class support in ATL"] -ms.assetid: 7db2220f-319d-4ce9-9382-d340019f14f7 ms.topic: concept-article --- # Supporting IDispatch and IErrorInfo +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + You can use the template class [IDispatchImpl](../atl/reference/idispatchimpl-class.md) to provide a default implementation of the `IDispatch Interface` portion of any dual interfaces on your object. If your object uses the `IErrorInfo` interface to report errors back to the client, then your object must support the `ISupportErrorInfo` interface. The template class [ISupportErrorInfoImpl](../atl/reference/isupporterrorinfoimpl-class.md) provides an easy way to implement this if you only have a single interface that generates errors on your object. diff --git a/docs/atl/supporting-idispeventimpl.md b/docs/atl/supporting-idispeventimpl.md index 261ffa445cd..dde4fa8ab69 100644 --- a/docs/atl/supporting-idispeventimpl.md +++ b/docs/atl/supporting-idispeventimpl.md @@ -3,11 +3,12 @@ description: "Learn more about: Supporting IDispEventImpl" title: "Supporting IDispEventImpl" ms.date: "11/04/2016" helpviewer_keywords: ["event sink maps, declaring", "IDispEventImpl class, advising and unadvising", "SINK_ENTRY macro", "type libraries, importing", "ATL, IDispEventImpl support in COM objects", "BEGIN_SINK_MAP macro", "IDispEventImpl class, declaring"] -ms.assetid: b957f930-6a5b-4598-8e4d-8027759957e7 ms.topic: concept-article --- # Supporting IDispEventImpl +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The template class [IDispEventImpl](../atl/reference/idispeventimpl-class.md) can be used to provide support for connection point sinks in your ATL class. A connection point sink allows your class to handle events fired from external COM objects. These connection point sinks are mapped with an event sink map, provided by your class. To properly implement a connection point sink for your class, the following steps must be completed: diff --git a/docs/atl/testing-the-atl-dhtml-control.md b/docs/atl/testing-the-atl-dhtml-control.md index 1d223e24d1d..32fe9fae2ff 100644 --- a/docs/atl/testing-the-atl-dhtml-control.md +++ b/docs/atl/testing-the-atl-dhtml-control.md @@ -3,11 +3,12 @@ description: "Learn more about: Testing the ATL DHTML Control" title: "Testing the ATL DHTML Control" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, testing", "testing controls", "DHTML controls", "DHTML controls, testing"] -ms.assetid: 0e4b4358-80ce-4505-8b06-ef4f30b1d1f0 ms.topic: how-to --- # Testing the ATL DHTML Control +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Once you have created your project, you can build and test the sample control. Before you do this, use **Class View** and **Solution Explorer** to examine the project. The elements of your project are described in greater detail in [Identifying the Elements of the DHTML Control Project](../atl/identifying-the-elements-of-the-dhtml-control-project.md). ## To build and test the ATL DHTML control diff --git a/docs/atl/testing-the-modified-atl-dhtml-control.md b/docs/atl/testing-the-modified-atl-dhtml-control.md index fe0809b88b7..b120c2d27bf 100644 --- a/docs/atl/testing-the-modified-atl-dhtml-control.md +++ b/docs/atl/testing-the-modified-atl-dhtml-control.md @@ -3,11 +3,12 @@ description: "Learn more about: Testing the Modified ATL DHTML Control" title: "Testing the Modified ATL DHTML Control" ms.date: "11/06/2018" helpviewer_keywords: ["HTML controls, testing", "testing controls", "DHTML controls, testing"] -ms.assetid: 42316118-9433-410f-9d8a-0efcc1eff824 ms.topic: how-to --- # Testing the Modified ATL DHTML Control +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Try out your new control to see how it works now. ## To build and test the modified control diff --git a/docs/atl/thread-pooling-classes.md b/docs/atl/thread-pooling-classes.md index ff62fdc9f8c..d78f5b29aa5 100644 --- a/docs/atl/thread-pooling-classes.md +++ b/docs/atl/thread-pooling-classes.md @@ -4,10 +4,11 @@ title: "Thread Pooling Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["thread pooling, classes", "threading [ATL], pooling", "pooling worker threads"] -ms.assetid: 01fa2c1c-12ae-4781-b772-0a74b6365a8c --- # Thread Pooling Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes support thread pooling: - [CComAutoThreadModule](../atl/reference/ccomautothreadmodule-class.md) Implements an EXE module, with support for multiple thread-pooled apartments. diff --git a/docs/atl/threading-models-and-critical-sections-classes.md b/docs/atl/threading-models-and-critical-sections-classes.md index 1bc26034ca9..21ebb6aafcb 100644 --- a/docs/atl/threading-models-and-critical-sections-classes.md +++ b/docs/atl/threading-models-and-critical-sections-classes.md @@ -3,11 +3,12 @@ description: "Learn more about: Threading Models and Critical Sections Classes" title: "Threading Models and Critical Sections Classes (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, critical sections", "ATL, multithreading", "threading [ATL], models", "critical sections"] -ms.assetid: 759f05ef-6285-4be6-a2cc-78572dd75146 ms.topic: concept-article --- # Threading Models and Critical Sections Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes define a threading model and critical section: - [CAtlAutoThreadModule](../atl/reference/catlautothreadmodule-class.md) Implements a thread-pooled, apartment-model COM server. diff --git a/docs/atl/ui-support-classes.md b/docs/atl/ui-support-classes.md index 8e5f56f4c4c..53a4941d0a5 100644 --- a/docs/atl/ui-support-classes.md +++ b/docs/atl/ui-support-classes.md @@ -4,10 +4,11 @@ title: "UI Support Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["user interfaces, support classes", "user interfaces, ATL classes"] -ms.assetid: 313dfc95-308a-4118-b919-5a3c3673b865 --- # UI Support Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide general UI support: - [IDocHostUIHandlerDispatch](../atl/reference/idochostuihandlerdispatch-interface.md) An interface to the Microsoft HTML parsing and rendering engine. diff --git a/docs/atl/understanding-backus-naur-form-bnf-syntax.md b/docs/atl/understanding-backus-naur-form-bnf-syntax.md index 7e5295bf9ec..3e218f2ade2 100644 --- a/docs/atl/understanding-backus-naur-form-bnf-syntax.md +++ b/docs/atl/understanding-backus-naur-form-bnf-syntax.md @@ -3,11 +3,12 @@ description: "Learn more about: Understanding Backus-Naur form (BNF) syntax" title: "ATL Registrar and Backus-Naur form (BNF) syntax" ms.date: "05/14/2019" helpviewer_keywords: ["BNF notation", "Backus-Naur form (BNF) syntax"] -ms.assetid: 994bbef0-9077-4aa8-bdfe-b7e830af9acc ms.topic: concept-article --- # Understanding Backus-Naur form (BNF) syntax +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The scripts used by the ATL Registrar are described in this topic using BNF syntax, which uses the notation shown in the following table. |Convention/symbol|Meaning| diff --git a/docs/atl/understanding-parse-trees.md b/docs/atl/understanding-parse-trees.md index a0eea7d823a..75544ab3c4e 100644 --- a/docs/atl/understanding-parse-trees.md +++ b/docs/atl/understanding-parse-trees.md @@ -7,6 +7,8 @@ ms.topic: concept-article --- # Understanding parse trees +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + You can define one or more parse trees in your registrar script, where each parse tree has the following form: > \{\}+ diff --git a/docs/atl/understanding-window-traits.md b/docs/atl/understanding-window-traits.md index df7884f8624..a6a391133f6 100644 --- a/docs/atl/understanding-window-traits.md +++ b/docs/atl/understanding-window-traits.md @@ -3,11 +3,12 @@ description: "Learn more about: Understanding Window Traits" title: "ATL Window Traits" ms.date: "11/04/2016" helpviewer_keywords: ["window traits"] -ms.assetid: c90cf850-9e91-49da-9cf3-ad4efb30347d ms.topic: concept-article --- # Understanding Window Traits +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Window traits classes provide a simple method for standardizing the styles used for the creation of an ATL window object. Window traits are accepted as template parameters by [CWindowImpl](../atl/reference/cwindowimpl-class.md) and other ATL window classes as a way of providing default window styles at the class level. If the creator of a window instance doesn't provide styles explicitly in the call to [Create](../atl/reference/cwindowimpl-class.md#create), you can use a traits class to ensure that the window is still created with the correct styles. You can even ensure that certain styles are set for all instances of that window class while permitting other styles to be set on a per-instance basis. diff --git a/docs/atl/using-a-template-library.md b/docs/atl/using-a-template-library.md index 11bd456ff96..7fae7aa5932 100644 --- a/docs/atl/using-a-template-library.md +++ b/docs/atl/using-a-template-library.md @@ -3,11 +3,12 @@ description: "Learn more about: Using a Template Library" title: "Using a Template Library (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["template libraries"] -ms.assetid: 5e80ec6e-a61c-41ce-b34b-9a6252c46265 ms.topic: concept-article --- # Using a Template Library +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + A template is somewhat like a macro. As with a macro, invoking a template causes it to expand (with appropriate parameter substitution) to code you have written. However, a template goes further than this to allow the creation of new classes based on types that you pass as parameters. These new classes implement type-safe ways of performing the operation expressed in your template code. Template libraries such as ATL differ from traditional C++ class libraries in that they are typically supplied only as source code (or as source code with a little, supporting run time) and are not inherently or necessarily hierarchical in nature. Rather than deriving from a class to get the functionality you desire, you instantiate a class from a template. diff --git a/docs/atl/using-a-window.md b/docs/atl/using-a-window.md index 69488133ae5..99a3e945018 100644 --- a/docs/atl/using-a-window.md +++ b/docs/atl/using-a-window.md @@ -3,11 +3,12 @@ description: "Learn more about: Using a Window" title: "Using a Window (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "CWindow class, about CWindow class", "windows [C++], ATL"] -ms.assetid: b3b9cc8e-4287-486b-b080-38852bc2943a ms.topic: concept-article --- # Using a Window +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Class [CWindow](../atl/reference/cwindow-class.md) allows you to use a window. Once you attach a window to a `CWindow` object, you can then call `CWindow` methods to manipulate the window. `CWindow` also contains an HWND operator to convert a `CWindow` object to an HWND. Thus you can pass a `CWindow` object to any function that requires a handle to a window. You can easily mix `CWindow` method calls and Win32 function calls, without creating any temporary objects. Because `CWindow` has only two data member (a window handle and the default dimensions), it does not impose an overhead on your code. In addition, many of the `CWindow` methods simply wrap corresponding Win32 API functions. By using `CWindow`, the HWND member is automatically passed to the Win32 function. diff --git a/docs/atl/using-contained-windows.md b/docs/atl/using-contained-windows.md index 82894f8eeae..9de7cffd6db 100644 --- a/docs/atl/using-contained-windows.md +++ b/docs/atl/using-contained-windows.md @@ -3,11 +3,12 @@ description: "Learn more about: Using Contained Windows" title: "Using Contained Windows" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "windows [C++], ATL", "contained windows in ATL"] -ms.assetid: 7b3d79e5-b569-413f-9b98-df4f14efbe2b ms.topic: concept-article --- # Using Contained Windows +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + ATL implements contained windows with [CContainedWindowT](../atl/reference/ccontainedwindowt-class.md). A contained window represents a window that delegates its messages to a container object instead of handling them in its own class. > [!NOTE] diff --git a/docs/atl/using-idispeventimpl.md b/docs/atl/using-idispeventimpl.md index 9e9c1537f24..10a6ef481e5 100644 --- a/docs/atl/using-idispeventimpl.md +++ b/docs/atl/using-idispeventimpl.md @@ -3,11 +3,12 @@ description: "Learn more about: Using IDispEventImpl" title: "Using IDispEventImpl (ATL)" ms.date: "08/19/2019" helpviewer_keywords: ["IDispEventImpl class, using"] -ms.assetid: 82d53b61-9d0d-45c5-aff9-2fafa468a9ca ms.topic: how-to --- # Using IDispEventImpl +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + When using `IDispEventImpl` to handle events, you will need to: - Derive your class from [IDispEventImpl](../atl/reference/idispeventimpl-class.md). diff --git a/docs/atl/using-idispeventsimpleimpl.md b/docs/atl/using-idispeventsimpleimpl.md index 3f50230f72c..875fb0cd26c 100644 --- a/docs/atl/using-idispeventsimpleimpl.md +++ b/docs/atl/using-idispeventsimpleimpl.md @@ -3,11 +3,12 @@ description: "Learn more about: Using IDispEventSimpleImpl" title: "Using IDispEventSimpleImpl (ATL)" ms.date: "08/19/2019" helpviewer_keywords: ["IDispEventSimpleImpl class, using"] -ms.assetid: 8640ad1a-4bd0-40a5-b5e4-7322685d7aab ms.topic: concept-article --- # Using IDispEventSimpleImpl +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + When using `IDispEventSimpleImpl` to handle events, you will need to: - Derive your class from [IDispEventSimpleImpl](../atl/reference/idispeventsimpleimpl-class.md). diff --git a/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md b/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md index 5541235e127..ea68a8f0ef7 100644 --- a/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md +++ b/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md @@ -3,11 +3,12 @@ description: "Learn more about: Using Replaceable Parameters (The Registrar's Pr title: "Using Replaceable Parameters (ATL Registrar)" ms.date: "11/04/2016" helpviewer_keywords: ["%MODULE%"] -ms.assetid: 0b376994-84a6-4967-8d97-8c01dfc94efe ms.topic: concept-article --- # Using Replaceable Parameters (The Registrar's Preprocessor) +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + Replaceable parameters allow a Registrar's client to specify run-time data. To do this, the Registrar maintains a replacement map into which it enters the values associated with the replaceable parameters in your script. The Registrar makes these entries at run time. ## Using %MODULE% diff --git a/docs/atl/using-task-manager.md b/docs/atl/using-task-manager.md index 31747f62825..37a86152888 100644 --- a/docs/atl/using-task-manager.md +++ b/docs/atl/using-task-manager.md @@ -3,11 +3,12 @@ description: "Learn more about: Using Task Manager" title: "Using Task Manager" ms.date: "11/04/2016" helpviewer_keywords: ["Task Manager", "breakpoints, Task Manager", "debugging [ATL], using Task Manager"] -ms.assetid: 773fccd5-308d-42c2-a17f-60ae94989062 ms.topic: how-to --- # Using Task Manager +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + One of the simplest ways to debug a service is through the use of the Task Manager. While the service is running, start the Task Manager and click the **Processes** tab. Right-click the name of the EXE and then click **Debug**. This launches Visual C++ attached to that running process. Now, click **Break** on the **Debug** menu to allow you to set breakpoints in your code. Click **Run** to run to your selected breakpoints. ## See also diff --git a/docs/atl/utility-classes.md b/docs/atl/utility-classes.md index df1f4375949..b454bb01a80 100644 --- a/docs/atl/utility-classes.md +++ b/docs/atl/utility-classes.md @@ -4,10 +4,11 @@ title: "Utility Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["utility classes"] -ms.assetid: 33d5da9d-89a5-49f9-a873-a26499299d17 --- # Utility Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following MFC-independent utility classes are provided: - [CImage](../atl-mfc-shared/reference/cimage-class.md) Provides enhanced bitmap support, including the ability to load and save images in JPEG, GIF, BMP, and Portable Network Graphics (PNG) formats. diff --git a/docs/atl/windows-support-classes.md b/docs/atl/windows-support-classes.md index caa906a9fb4..a8f615fa208 100644 --- a/docs/atl/windows-support-classes.md +++ b/docs/atl/windows-support-classes.md @@ -4,10 +4,11 @@ title: "Windows Support Classes (ATL)" ms.date: "11/04/2016" ms.topic: "reference" helpviewer_keywords: ["ATL, windows", "windows [C++], ATL"] -ms.assetid: 750b14d5-d787-4d2b-9728-ac199ccad489 --- # Windows Support Classes +[!INCLUDE[product-lifecycle-status](includes/lifecycle-note.md)] + The following classes provide support for windows: - [_U_MENUorID](../atl/reference/u-menuorid-class.md) Provides wrappers for `CreateWindow` and `CreateWindowEx`. From 847ff2a52a7bedae7f3aae16bd42b906a9b75e5d Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Wed, 25 Feb 2026 15:45:21 -0800 Subject: [PATCH 1666/1799] edit pass: redistributing-microsoft-c++-files --- docs/windows/redist-version-auditing.md | 30 +++---- ...-vc-redistributable-installation-issues.md | 82 +++++++++---------- 2 files changed, 55 insertions(+), 57 deletions(-) diff --git a/docs/windows/redist-version-auditing.md b/docs/windows/redist-version-auditing.md index 2e09b9c1607..b48363f1375 100644 --- a/docs/windows/redist-version-auditing.md +++ b/docs/windows/redist-version-auditing.md @@ -20,16 +20,16 @@ For more information about the versions of VC Runtime that are no longer support ## Enable NTFS file auditing to determine VC Runtime usage -This article provides the steps to manually enable NTFS file auditing and review audit events to determine which applications are calling the unsupported versions of the VC Runtime. Because there are several files that can be used by an application, this article also shows how to use the PowerShell [`Get-Acl`](/powershell/module/microsoft.powershell.security/get-acl) and [`Set-Acl`](/powershell/module/microsoft.powershell.security/set-acl) cmdlets to update auditing permissions. For more information about how to configure audit policies for a file, see [Apply a basic audit policy on a file or folder](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/apply-a-basic-audit-policy-on-a-file-or-folder). +This article provides the steps to manually enable NTFS file auditing and review audit events to determine which applications are calling the unsupported versions of the VC Runtime. Because there are several files that an application can use, this article also shows how to use the PowerShell [`Get-Acl`](/powershell/module/microsoft.powershell.security/get-acl) and [`Set-Acl`](/powershell/module/microsoft.powershell.security/set-acl) cmdlets to update auditing permissions. For more information about how to configure audit policies for a file, see [Apply a basic audit policy on a file or folder](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/apply-a-basic-audit-policy-on-a-file-or-folder). ### Manually enable object access auditing on the system -Object access must be enabled before you enable file level auditing: +Object access must be enabled before you enable file-level auditing: -1. Open the **Local Group Policy Editor** by pressing `Windows` + `R` to open the **Run** dialog. Then type `gpedit.msc` and press **Enter**. +1. Select **Windows**+**R** to open the **Run** dialog. Then enter **gpedit.msc** and select **Enter** to open **Local Group Policy Editor**. 1. Go to **Computer Configuration** > **Windows Settings** > **Security Settings** > **Advanced Audit Policy Configuration** > **System Audit Policies** > **Object Access**. 1. Double-click **Audit File System**. In the **Audit File System Properties** dialog, select **Configure the following audit events** > **Success** > **OK**. -1. Close the **Local Group Policy Editor**. +1. Close **Local Group Policy Editor**. Alternatively, you can use `auditpol.exe` to enable object access: @@ -43,27 +43,27 @@ To monitor which process accesses a VC Runtime file, enable auditing on the VC R 1. Right-click the file that you want to audit, select **Properties**, and then select the **Security** tab. For more information about finding installed VC Runtime files, see [VC Runtime installed locations](#vcruntime_install_location). 1. Select **Advanced**. 1. In the **Advanced Security Settings** dialog, select the **Auditing** tab and then select **Continue**. -1. To add a new auditing rule, select **Add**. In the **Auditing Entry** dialog, select a principal, and then enter the name of the user or group you want to add, such as **(Everyone)**. Then select **OK**. +1. To add a new auditing rule, select **Add**. In the **Auditing Entry** dialog, select a principal, and then enter the name of the user or group that you want to add, such as **(Everyone)**. Then select **OK**. 1. In **Type**, ensure that **Success** is selected. 1. Select **Show advance permissions** > **Clear all** > **Traverse folder / execute file** > **OK**. -1. There should now be a new row in the **Auditing** entries matching what you selected. Select **OK**. +1. Observe that a new row in the **Auditing** entries matches what you selected. Select **OK**. 1. In the **Properties** dialog, select **OK**. The audit rule is now enabled for the file. ### Manually review audit logs -NTFS file auditing generates ["Event 4663: An attempt was made to access an object"](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663) for each file that includes the audit permission and is accessed by a process. +NTFS file auditing generates [Event 4663: An attempt was made to access an object](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663) for each file that includes the audit permission and is accessed by a process. -1. Open the **Event Viewer** by selecting **Windows** + **R** to open the **Run** dialog. Then enter **eventvwr.msc** and select **Enter**. +1. Select **Windows**+**R** to open the **Run** dialog. Then enter **eventvwr.msc** and select **Enter** to open **Event Viewer**. 1. Go to the **Security** logs in the **Event Viewer** by expanding **Windows Logs** > **Security**. The results pane lists security events. -1. Find the audit events by choosing **Filter Current Log...** in the **Actions** pane. Narrow down the events to **Event ID 4663 (Audit Success for the File System Category)** by entering **4663** into the **Includes/Excludes Event IDs** text box. +1. Find the audit events by choosing **Filter Current Log...** in the **Actions** pane. To narrow down the events to **Event ID 4663 (Audit Success for the File System Category)**, enter **4663** in the **Includes/Excludes Event IDs** text box. -For an example of a File Access Auditing Event 4663, see ["4663(S): An attempt was made to access an object."](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663). +For a File Access Auditing Event 4663 example, see [4663(S): An attempt was made to access an object.](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663). ### Use PowerShell to audit VC Runtime usage -To update File Auditing Permissions with PowerShell, follow these steps: +To update file auditing permissions with PowerShell, follow these steps: 1. Define the [file system audit rule](/dotnet/api/system.security.accesscontrol.filesystemauditrule.-ctor) to apply to the files. 1. Obtain a file's security descriptor with [`Get-Acl`](/powershell/module/microsoft.powershell.security/get-acl). @@ -122,7 +122,7 @@ ForEach-Object { ### PowerShell: View file audit events -PowerShell provides `Get-WinEvent` to get event records for various event logs, as shown in the following PowerShell code that lists all of the Auditing Event 4663 records over the past 24 hours: +PowerShell provides `Get-WinEvent` to get event records for various event logs, as shown in the following PowerShell code that lists all of the File Access Auditing Event 4663 records over the past 24 hours: ```powershell function Get-AuditEntries { @@ -171,15 +171,15 @@ ResourceAttributes : S:AI ### Next steps after auditing VC Runtime usage -After you determine which processes use the VC Runtime files, or which applications installed the VC Redistributable, uninstall those applications or upgrade them to newer versions that don't depend on unsupported VC Runtimes. +After you determine which processes use the VC Runtime files, or which applications installed the Visual C++ Redistributable, uninstall those applications or upgrade them to newer versions that don't depend on unsupported VC Runtimes. -Some Microsoft applications require legacy versions of the VC Runtime. For details, see [Visual C++ Redistributable and Runtime Libraries FAQ | Microsoft Learn](/lifecycle/faq/visual-c-faq). +Some Microsoft applications require legacy versions of the VC Runtime. For more information, see the [Visual C++ Redistributable and Runtime Libraries FAQ](/lifecycle/faq/visual-c-faq). ## VC Runtime installation locations -Here is where each version of the VC Runtime is installed: +The following table lists where each version of the VC Runtime is installed. | Visual Studio version| Installed locations| | ------------- | ------------- | diff --git a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md index 9698ba5a3ff..c9a71b5909d 100644 --- a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md +++ b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md @@ -1,6 +1,6 @@ --- -title: "Troubleshoot Visual C++ Redistributable installation issues" -description: "Provide steps to diagnose and resolve issues when installing the Visual C++ Redistributable." +title: Troubleshoot Visual C++ Redistributable Installation Issues +description: This article provides steps to help you diagnose and resolve issues when you install the Visual C++ Redistributable. author: vicroms ms.author: viromer ms.date: 02/12/2026 @@ -9,9 +9,9 @@ helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC --- # Troubleshoot Visual C++ Redistributable installation issues -This guide is for users experiencing issues installing Visual C++ Runtime components using the Visual Studio (VS) Installer or the Visual C++ Redistributable (VC Redist) installer. +This article is for users who experience issues when they install Visual C++ Runtime components by using the Visual Studio (VS) Installer or the Visual C++ Redistributable (VC Redist) installer. -If you experience any issues, start by ensuring you're installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). +If you experience any issues, make sure that you're installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). ## Collect failure logs @@ -21,9 +21,9 @@ The first step to diagnose an issue with the Visual C++ Redistributable installe 1. Run `Collect.exe`. 1. Extract the contents of `%TEMP%/vscollect.zip`. -Once you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. +After you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. -Search the VC Redist logs for terms like "Error", "Failed", or "System Error" and consult the [Common Errors](#common-errors-at-a-glance) to identify the issue. +Search the VC Redist logs for terms like "Error," "Failed," or "System Error" and consult the [Common errors at a glance](#common-errors-at-a-glance) section to identify the issue. ### Other log locations @@ -31,9 +31,9 @@ The VC Redist installer is often executed as a prerequisite of other products. I For example, [Configuration Manager](/intune/configmgr/core/understand/introduction) upgrades VC Redist as part of its own upgrade process by running `vcredist_x64.exe` with the `/l` option that overrides the default log location. -In such cases, the path to the logs can be found by reading that product's own logs: +In such cases, you can find the path to the logs by reading that product's own logs. -**Example: Configuration Manager logs** +#### Example: Configuration Manager logs `\Logs\cmupdate.log` @@ -47,20 +47,19 @@ In such cases, the path to the logs can be found by reading that product's own l ## General troubleshooting steps when using the Visual C++ Redistributable installer -This section describes general troubleshooting methods you can try to resolve issues with the VC Redist installer. +This section describes general troubleshooting methods that you can try to resolve issues with the VC Redist installer. ### Disable antivirus software temporarily Antivirus software often blocks installation of VC Redist components. 1. Turn off Windows Defender real-time protection. -1. Disable any corporate endpoint protection temporarily (Symantec, McAfee, etc.). +1. Disable any corporate endpoint protection temporarily (such as Symantec or McAfee). 1. Retry the installation. 1. Reenable any disabled protection software. > [!WARNING] -> Re-enable any disabled protection software after completing these steps. - +> Reenable any disabled protection software after you finish these steps. ### Run the Visual C++ Redistributable installer as administrator @@ -74,8 +73,8 @@ File-access failures are heavily correlated with insufficient permissions. On rare occasions, outdated system components can cause installation issues. 1. Go to Windows Update and install all pending updates. -2. Reboot your PC. -3. Retry the installation. +1. Reboot your PC. +1. Retry the installation. ## General troubleshooting steps when using Visual Studio Installer @@ -93,25 +92,24 @@ If the manual installation fails, follow the [general troubleshooting steps for ### Clear the Visual Studio Installer cache 1. Open `%ProgramData%\Microsoft\VisualStudio\Packages`. -1. Delete all files inside the folder to force the Visual Studio Installer to regenerate them. +1. Delete all the files inside the folder to force the Visual Studio Installer to regenerate them. 1. Retry the Visual Studio Installer. ### Repair the Visual Studio Installer 1. Open the **Settings** app. -1. Search for **Installed Apps** using the search bar at the top of the window. +1. Enter **Installed Apps** in the search bar at the top of the window. 1. Search for **Visual Studio Installer**. -1. Click on the "**...**" button and select **Modify**. -1. Select the option to **Repair** the Visual Studio Installer. -1. Retry the VS installation. +1. Select the elipsis (**...**), and then select **Modify**. +1. Select the **Repair** option to repair the Visual Studio Installer. +1. Retry the Visual Studio installation. ### Delete the Visual Studio Installer folder > [!WARNING] -> This method requires that you have the Visual Studio Installer Setup downloaded (VisualStudioSetup.exe). -> You can download the Visual Studio Installer Setup from . +> This method requires that you have the Visual Studio Installer Setup downloaded (`VisualStudioSetup.exe`). You can download the Visual Studio Installer Setup from . -This method helps in case the installer metadata is corrupted, deleting the installer folder forces the Visual Studio Installer to regenerate it. +This method helps ifthe installer metadata is corrupted. Deleting the installer folder forces the Visual Studio Installer to regenerate it. 1. Download `VisualStudioSetup.exe` from . 1. Delete the folder `C:\Program Files (x86)\Microsoft Visual Studio\Installer`, you might be prompted to run this operation as administrator. @@ -141,7 +139,7 @@ If your issue isn't found here, then follow the instructions to [report an issue Installation fails with error code 5. This error code typically indicates a permissions issue; specifically, an access denied issue. -**Steps to resolve** +#### Steps to resolve 1. Disable antivirus, group policies, and firewalls temporarily. 1. Run the VC Redist installer. @@ -153,7 +151,7 @@ If the installation fails, try to run the VC Redist installer as administrator. Installation fails with error code 32. Files in use by another process, interference from antivirus software, group policies, or corrupted files are common causes. -**Steps to resolve** +#### Steps to resolve 1. Close any running software in your PC. 1. Try the methods in [General troubleshooting steps](#general-troubleshooting-steps-when-using-the-visual-c-redistributable-installer). @@ -170,7 +168,7 @@ The presence of these error messages indicates a corrupted cache. - Error code 0x80091007: several payloads failed verification due to hash mismatches. - Error code 0x80070654: occurs when an MSI package fails to execute. -**Steps to resolve** +#### Steps to resolve Try the steps in the [General troubleshooting steps when using Visual Studio Installer](#general-troubleshooting-steps-when-using-visual-studio-installer). @@ -209,20 +207,20 @@ In `VSSetupEvents.txt` Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612.] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [] ``` -**Steps to resolve** +#### Steps to resolve -From the log files, take note of the VC Redist version causing the issue. +From the log files, take note of the VC Redist version causing the issue. Two methods are available to resolve the issue: -Method 1: Use the Windows Installer. +- **Method 1:** Use the Windows Installer. -1. Try using the Windows Installer to manually remove the old VC Redist version. If prompted, let the Windows Installer Troubleshooter attempt to fix the issue. -1. Retry the installation. + 1. Try using the Windows Installer to manually remove the old VC Redist version. If prompted, let the Windows Installer Troubleshooter attempt to fix the issue. + 1. Retry the installation. -Method 2: Manually remove the old version. +- **Method 2:** Manually remove the old version. -1. Download the VC Redist installer for the old version. Follow the [steps to download and old version of the VC Redist installer](#old-vcredist-versions) -1. Run the installer to uninstall the old VC Redist. -1. Retry the installation. + 1. Download the VC Redist installer for the old version. Follow the [steps to download and old version of the VC Redist installer](#old-vcredist-versions) + 1. Run the installer to uninstall the old VC Redist. + 1. Retry the installation. ## Download old versions of the Visual C++ Redistributable installer @@ -232,7 +230,7 @@ Method 2: Manually remove the old version. Download the VC Redist installer from [my.visualstudio.com](). Search for Visual C++ Redistributable on the downloads page. -The latest supported VC Redist version for each version of Visual Studio can be found in [this article](/cpp/windows/latest-supported-vc-redist). +For the latest supported VC Redist version for each version of Visual Studio, see [Microsoft Redistributable Visual C++ latest supported downloads](/cpp/windows/latest-supported-vc-redist). Links for older or legacy versions: @@ -248,7 +246,7 @@ Only download VC Redist installers from a Microsoft site. Only install packages ## Report a Visual C++ Redistributable installation problem -The list of [common issues](#common-issues) was collected from feedback reported to Microsoft through [Developer Community](). +The list of [common issues](#common-issues) was collected from feedback reported to Microsoft through the [Developer Community](). If you encounter an issue not found in that section, or if the steps in this troubleshooting guide don't resolve your issue, use the [Report a Problem]() form to create a new feedback item. @@ -259,11 +257,11 @@ Your report must include the following information about your environment: - If installing through the Visual Studio Installer, version of the VS Installer. - Logs collected by following the steps in the [Collect failure logs](#collect-failure-logs) section. -Feedback without this information, especially without logs, is nonactionable and may be closed if additional information isn't submitted promptly. +Feedback without this information, especially without logs, is nonactionable and might be closed if more information isn't submitted promptly. -## See also +## Related content -[Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md)\ -[C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md)\ -[How to audit Visual C++ Runtime version usage](redist-version-auditing.md)\ -[Lifecycle FAQ - Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) +- [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md)\ +- [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md)\ +- [Audit Visual C++ Runtime version usage](redist-version-auditing.md)\ +- [Lifecycle FAQ: Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) From ae3877092e5247ead0886c2695fea9e39b01efd8 Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Thu, 26 Feb 2026 14:42:29 -0800 Subject: [PATCH 1667/1799] edit pass: redistributing-microsoft-c++-files --- ...-vc-redistributable-installation-issues.md | 73 +++++++++---------- 1 file changed, 35 insertions(+), 38 deletions(-) diff --git a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md index c9a71b5909d..aaf81ea5b4a 100644 --- a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md +++ b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md @@ -9,7 +9,7 @@ helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC --- # Troubleshoot Visual C++ Redistributable installation issues -This article is for users who experience issues when they install Visual C++ Runtime components by using the Visual Studio (VS) Installer or the Visual C++ Redistributable (VC Redist) installer. +This article is for users who experience issues when they install Visual C++ Runtime components by using the Visual Studio Installer or the Visual C++ Redistributable (VC Redist) installer. If you experience any issues, make sure that you're installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). @@ -23,11 +23,11 @@ The first step to diagnose an issue with the Visual C++ Redistributable installe After you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. -Search the VC Redist logs for terms like "Error," "Failed," or "System Error" and consult the [Common errors at a glance](#common-errors-at-a-glance) section to identify the issue. +Search the VC Redist logs for terms like "Error," "Failed," or "System Error," and consult the [Common errors at a glance](#common-errors-at-a-glance) section to identify the issue. ### Other log locations -The VC Redist installer is often executed as a prerequisite of other products. In such cases, the installation log might be found in a different path. +The VC Redist installer is often executed as a prerequisite of other products. In such cases, you might find the installation log in a different path. For example, [Configuration Manager](/intune/configmgr/core/understand/introduction) upgrades VC Redist as part of its own upgrade process by running `vcredist_x64.exe` with the `/l` option that overrides the default log location. @@ -81,7 +81,7 @@ On rare occasions, outdated system components can cause installation issues. ### Manually install Visual C++ Redistributable > [!NOTE] -> The VS Installer might prompt for a reboot when VC Redist is installed separately. +> The Visual Studio Installer might prompt for a reboot when VC Redist is installed separately. 1. Download the [latest VC Redist installer](latest-supported-vc-redist.md). 1. Run the VC Redist installer. @@ -100,7 +100,7 @@ If the manual installation fails, follow the [general troubleshooting steps for 1. Open the **Settings** app. 1. Enter **Installed Apps** in the search bar at the top of the window. 1. Search for **Visual Studio Installer**. -1. Select the elipsis (**...**), and then select **Modify**. +1. Select the ellipsis (**...**), and then select **Modify**. 1. Select the **Repair** option to repair the Visual Studio Installer. 1. Retry the Visual Studio installation. @@ -109,10 +109,10 @@ If the manual installation fails, follow the [general troubleshooting steps for > [!WARNING] > This method requires that you have the Visual Studio Installer Setup downloaded (`VisualStudioSetup.exe`). You can download the Visual Studio Installer Setup from . -This method helps ifthe installer metadata is corrupted. Deleting the installer folder forces the Visual Studio Installer to regenerate it. +This method helps if the installer metadata is corrupted. Deleting the installer folder forces the Visual Studio Installer to regenerate it. -1. Download `VisualStudioSetup.exe` from . -1. Delete the folder `C:\Program Files (x86)\Microsoft Visual Studio\Installer`, you might be prompted to run this operation as administrator. +1. Download `VisualStudioSetup.exe` from the [Welcome to Dev Essentials](https://my.visualstudio.com) page. +1. Delete the folder `C:\Program Files (x86)\Microsoft Visual Studio\Installer`. You might be prompted to run this operation as an administrator. 1. Run `VisualStudioSetup.exe`. ## Common issues @@ -122,30 +122,29 @@ This method helps ifthe installer metadata is corrupted. Deleting the installer * [Generic installation failure (return code 1603)](#generic-installation-failure) * [Access denied (return code 5)](#access-denied) * [File is locked (return code 32)](#file-is-locked) -* [Corrupt or invliad installer package (return code 1620)](#corrupt-or-invalid-installer-package) +* [Corrupt or invalid installer package (return code 1620)](#corrupt-or-invalid-installer-package) * [Older version can't be removed (return code 1714)](#older-version-cant-be-removed) ### Generic installation failure Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ Runtime components. -Because many factors can produce a 1603 code, the code by itself doesn't provide enough information to diagnose the cause of the issue. -Often, the log files produced by the VC Redist installer contain relevant information that might lead to a solution or workaround. +Because many factors can produce a 1603 code, the code by itself doesn't provide enough information to diagnose the cause of the issue. Often, the log files produced by the VC Redist installer contain relevant information that might lead to a solution or workaround. The [Common issues](#common-issues) section describes examples of how to diagnose common installation errors and steps that might resolve them. -If your issue isn't found here, then follow the instructions to [report an issue in the Visual C++ Redistributable installer](#report-a-visual-c-redistributable-installation-problem). +If your issue isn't found here, follow the instructions to [report an issue in the Visual C++ Redistributable installer](#report-a-visual-c-redistributable-installation-problem). ### Access denied -Installation fails with error code 5. This error code typically indicates a permissions issue; specifically, an access denied issue. +Installation fails with error code 5. This error code typically indicates a permissions issue. Specifically, the issue is access denied. #### Steps to resolve 1. Disable antivirus, group policies, and firewalls temporarily. 1. Run the VC Redist installer. -1. Re-enable any disabled protection software. +1. Reenable any disabled protection software. -If the installation fails, try to run the VC Redist installer as administrator. +If the installation fails, try to run the VC Redist installer as an administrator. ### File is locked @@ -154,19 +153,19 @@ Installation fails with error code 32. Files in use by another process, interfer #### Steps to resolve 1. Close any running software in your PC. -1. Try the methods in [General troubleshooting steps](#general-troubleshooting-steps-when-using-the-visual-c-redistributable-installer). +1. Try the methods in the [General troubleshooting steps when using Visual Studio Installer](#general-troubleshooting-steps-when-using-the-visual-c-redistributable-installer) section. If the installation fails, try to restart your PC to release any locked files. ### Corrupt or invalid installer package -Installation fails with error code 1620. This error code indicates that a Windows Installer package (MSI) couldn't be opened, likely due to corruption or invalid files. +Installation fails with error code 1620. This error code indicates that a Windows Installer package (MSI) couldn't be opened. The issue is likely because of corruption or invalid files. The presence of these error messages indicates a corrupted cache. -- Error code 1620: indicates that the Windows Installer package couldn't be opened. -- Error code 0x80091007: several payloads failed verification due to hash mismatches. -- Error code 0x80070654: occurs when an MSI package fails to execute. +- **Error code 1620**: Indicates that the Windows Installer package couldn't be opened. +- **Error code 0x80091007**: Indicates that several payloads failed verification because of hash mismatches. +- **Error code 0x80070654**: Occurs when an MSI package fails to execute. #### Steps to resolve @@ -178,7 +177,7 @@ Installation fails with the error code 1714. This error code indicates a corrupt The presence of these error messages indicates a corrupted cache. -In `dd_vcredist__.log` +In `dd_vcredist__.log`: ```log Error 0x80070003: Failed to get size of pseudo bundle: C:\ProgramData\Package Cache\{43d1ce82-6f55-4860-a938-20e5deb28b98}\VC_redist.x64.exe @@ -201,7 +200,7 @@ Product: Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 -- Error 17 Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612. ``` -In `VSSetupEvents.txt` +In `VSSetupEvents.txt`: ```log Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - 14.40.33816 cannot be removed. Contact your technical support group. System Error 1612.] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [(NULL)] [] @@ -209,7 +208,7 @@ Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - #### Steps to resolve -From the log files, take note of the VC Redist version causing the issue. Two methods are available to resolve the issue: +From the log files, make a note of the VC Redist version causing the issue. Two methods are available to resolve the issue: - **Method 1:** Use the Windows Installer. @@ -218,21 +217,20 @@ From the log files, take note of the VC Redist version causing the issue. Two me - **Method 2:** Manually remove the old version. - 1. Download the VC Redist installer for the old version. Follow the [steps to download and old version of the VC Redist installer](#old-vcredist-versions) + 1. Download the VC Redist installer for the old version. Follow the [steps to download an old version of the VC Redist installer](#old-vcredist-versions). 1. Run the installer to uninstall the old VC Redist. 1. Retry the installation. ## Download old versions of the Visual C++ Redistributable installer > [!WARNING] -> Never install a Visual C++ Redistributable installer that wasn't downloaded from a Microsoft site. -> Never install a Visual C++ Redistributable installer that isn't signed by Microsoft. +> Never install a Visual C++ Redistributable installer that wasn't downloaded from a Microsoft site. Never install a Visual C++ Redistributable installer that isn't signed by Microsoft. -Download the VC Redist installer from [my.visualstudio.com](). Search for Visual C++ Redistributable on the downloads page. +Download the VC Redist installer from [Welcome to Dev Essentials](https://my.visualstudio.com/Downloads) page. Search for Visual C++ Redistributable on the downloads page. For the latest supported VC Redist version for each version of Visual Studio, see [Microsoft Redistributable Visual C++ latest supported downloads](/cpp/windows/latest-supported-vc-redist). -Links for older or legacy versions: +The following table lists links for older or legacy versions. | Version range | Download link template | Example | |----------------|---------------------------------------------------------------|----------------------------------------------------------------| @@ -241,8 +239,7 @@ Links for older or legacy versions: | 14.20 to 14.29 | `https://aka.ms/vs/16/release//VC_redist..exe` | | | 14.10 to 14.19 | `https://aka.ms/vs/15/release//VC_redist..exe` | | -You might be able to find installers for older versions through a Bing search. -Only download VC Redist installers from a Microsoft site. Only install packages signed by Microsoft. +You might be able to find installers for older versions through a Bing search. Only download VC Redist installers from a Microsoft site. Only install packages signed by Microsoft. ## Report a Visual C++ Redistributable installation problem @@ -252,16 +249,16 @@ If you encounter an issue not found in that section, or if the steps in this tro Your report must include the following information about your environment: -- Version of VC Redist you're trying to install. -- If upgrading, version of previously installed VC Redist installations. -- If installing through the Visual Studio Installer, version of the VS Installer. -- Logs collected by following the steps in the [Collect failure logs](#collect-failure-logs) section. +- The version of VC Redist you're trying to install. +- If you're upgrading, the version of previously installed VC Redist installations. +- If you're installing through the Visual Studio Installer, the version of the Visual Studio Installer. +- The logs collected by following the steps in the [Collect failure logs](#collect-failure-logs) section. Feedback without this information, especially without logs, is nonactionable and might be closed if more information isn't submitted promptly. ## Related content -- [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md)\ -- [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md)\ -- [Audit Visual C++ Runtime version usage](redist-version-auditing.md)\ -- [Lifecycle FAQ: Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) +- [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) +- [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) +- [Audit Visual C++ Runtime version usage](redist-version-auditing.md) +- [Lifecycle FAQ: Visual C++ Redistributable and Runtime Libraries](/lifecycle/faq/visual-c-faq) From 30ab1e83991c04940ad59337e26f3c04677554ec Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 26 Feb 2026 15:45:14 -0800 Subject: [PATCH 1668/1799] Add lifecycle note --- .../allocating-and-releasing-memory-for-a-bstr.md | 3 ++- docs/atl-mfc-shared/atl-mfc-concepts.md | 5 +++-- docs/atl-mfc-shared/atl-mfc-shared-classes.md | 3 ++- docs/atl-mfc-shared/avoidance-of-heap-contention.md | 3 ++- docs/atl-mfc-shared/basic-cstring-operations.md | 2 ++ .../cfixedstringt-example-of-a-custom-string-manager.md | 3 ++- docs/atl-mfc-shared/cstring-argument-passing.md | 2 ++ docs/atl-mfc-shared/cstring-exception-cleanup.md | 3 ++- .../cstring-operations-relating-to-c-style-strings.md | 3 ++- docs/atl-mfc-shared/cstring-semantics.md | 3 ++- docs/atl-mfc-shared/date-and-time.md | 2 ++ docs/atl-mfc-shared/date-type.md | 3 ++- .../exporting-string-classes-using-cstringt.md | 3 ++- ...lementation-of-a-custom-string-manager-advanced-method.md | 3 ++- ...implementation-of-a-custom-string-manager-basic-method.md | 3 ++- docs/atl-mfc-shared/includes/lifecycle-note.md | 2 ++ docs/atl-mfc-shared/memory-management-with-cstringt.md | 3 ++- docs/atl-mfc-shared/reference/cfiletime-class.md | 3 ++- docs/atl-mfc-shared/reference/cfiletimespan-class.md | 3 ++- docs/atl-mfc-shared/reference/cfixedstringt-class.md | 3 ++- docs/atl-mfc-shared/reference/cimage-class.md | 2 ++ .../reference/classes-shared-by-mfc-and-atl.md | 3 ++- docs/atl-mfc-shared/reference/coledatetime-class.md | 2 ++ docs/atl-mfc-shared/reference/coledatetimespan-class.md | 3 ++- docs/atl-mfc-shared/reference/cpoint-class.md | 2 ++ docs/atl-mfc-shared/reference/crect-class.md | 2 ++ docs/atl-mfc-shared/reference/csimplestringt-class.md | 2 ++ docs/atl-mfc-shared/reference/csize-class.md | 2 ++ docs/atl-mfc-shared/reference/cstrbuft-class.md | 3 ++- docs/atl-mfc-shared/reference/cstringdata-class.md | 3 ++- docs/atl-mfc-shared/reference/cstringt-class.md | 2 ++ docs/atl-mfc-shared/reference/ctime-class.md | 3 ++- docs/atl-mfc-shared/reference/ctimespan-class.md | 2 ++ docs/atl-mfc-shared/reference/iatlstringmgr-class.md | 3 ++- docs/atl-mfc-shared/string-data-management.md | 2 ++ docs/atl-mfc-shared/strings-atl-mfc.md | 2 ++ .../unicode-and-multibyte-character-set-mbcs-support.md | 2 ++ docs/atl-mfc-shared/using-cstring.md | 3 ++- docs/atl-mfc-shared/using-cstringt.md | 3 ++- docs/mfc/activex-controls.md | 3 +-- 40 files changed, 80 insertions(+), 27 deletions(-) create mode 100644 docs/atl-mfc-shared/includes/lifecycle-note.md diff --git a/docs/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr.md b/docs/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr.md index b257f105f93..d1c1db36c70 100644 --- a/docs/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr.md +++ b/docs/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr.md @@ -4,10 +4,11 @@ title: "Allocating and Releasing Memory for a BSTR" ms.date: "11/04/2016" f1_keywords: ["bstr"] helpviewer_keywords: ["BSTRs, memory allocation", "memory deallocation, string memory", "memory [C++], releasing", "memory allocation, BSTRs", "memory deallocation, BSTR memory", "strings [C++], releasing"] -ms.assetid: 98041e29-3442-4a02-b425-7a4a13e9cc84 --- # Allocating and Releasing Memory for a `BSTR` +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + When you create `BSTR`s and pass them between COM objects, you must take care in treating the memory they use in order to avoid memory leaks. When a `BSTR` stays within an interface, you must free its memory when you are done with it. However, when a `BSTR` passes out of an interface, the receiving object takes responsibility for its memory management. In general, the rules for allocating and releasing memory allocated for `BSTR`s are as follows: diff --git a/docs/atl-mfc-shared/atl-mfc-concepts.md b/docs/atl-mfc-shared/atl-mfc-concepts.md index 6227696c2bb..c2d4845da77 100644 --- a/docs/atl-mfc-shared/atl-mfc-concepts.md +++ b/docs/atl-mfc-shared/atl-mfc-concepts.md @@ -3,15 +3,16 @@ description: "Learn more about: ATL/MFC Concepts" title: "ATL-MFC Concepts" ms.date: "11/04/2016" helpviewer_keywords: ["MFC", "ATL"] -ms.assetid: 4d973f56-8730-4e0b-9522-b5f43bc4548d --- # ATL/MFC Concepts +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + This section provides conceptual and task-based topics to help you program using the classes shared between Active Template Library (ATL) and Microsoft Foundation Class (MFC) Library. ## In This Section -[Strings (ATL/MFC)](../atl-mfc-shared/strings-atl-mfc.md)
+[Strings (ATL/MFC)](../atl-mfc-shared/strings-atl-mfc.md)\ Describes how to manage string data in applications. ## See also diff --git a/docs/atl-mfc-shared/atl-mfc-shared-classes.md b/docs/atl-mfc-shared/atl-mfc-shared-classes.md index 564d03df38f..52b69d1e957 100644 --- a/docs/atl-mfc-shared/atl-mfc-shared-classes.md +++ b/docs/atl-mfc-shared/atl-mfc-shared-classes.md @@ -6,10 +6,11 @@ ms.date: "11/04/2016" ms.topic: "concept-article" f1_keywords: ["vc.classes.shared"] helpviewer_keywords: ["CPoint class, shared class", "CFileTimeSpan class, shared class", "COleDateTime class, shared class", "CFixedStringT class, shared class", "CStrBufT class, shared class", "CFileTime class, shared class", "CRect class, shared class", "CSimpleStringT class, shared class", "CStringT class, shared class", "CSize class, shared class", "CStringData class, shared class", "IAtlStringMgr class, shared class", "shared classes, MFC and ATL", "COleDateTimeSpan class, shared class", "CString objects, shared class", "shared classes"] -ms.assetid: e13aaac3-21ec-4f4d-8834-432b40fde544 --- # ATL/MFC Shared Classes +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + These utility classes can be used in any native C++ project without requiring any MFC DLL. ## In This Section diff --git a/docs/atl-mfc-shared/avoidance-of-heap-contention.md b/docs/atl-mfc-shared/avoidance-of-heap-contention.md index 6639bbbe493..aec032124dc 100644 --- a/docs/atl-mfc-shared/avoidance-of-heap-contention.md +++ b/docs/atl-mfc-shared/avoidance-of-heap-contention.md @@ -3,10 +3,11 @@ description: "Learn more about: Avoidance of Heap Contention" title: "Avoidance of Heap Contention" ms.date: "11/04/2016" helpviewer_keywords: ["heap contention"] -ms.assetid: 797129d7-5f8c-4b0e-8974-bb93217e9ab5 --- # Avoidance of Heap Contention +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + The default string managers provided by MFC and ATL are simple wrappers on top of a global heap. This global heap is fully thread-safe, meaning that multiple threads can allocate and free memory from it simultaneously without corrupting the heap. To help provide thread safety, the heap has to serialize access to itself. This is usually accomplished with a critical section or similar locking mechanism. Whenever two threads try to access the heap simultaneously, one thread is blocked until the other thread's request is finished. For many applications, this situation rarely occurs and the performance impact of the heap's locking mechanism is negligible. However, for applications that frequently access the heap from multiple threads contention for the heap's lock can cause the application to run slower than if it were single-threaded (even on machines with multiple CPUs). Applications that use [CStringT](../atl-mfc-shared/reference/cstringt-class.md) are especially susceptible to heap contention because operations on `CStringT` objects frequently require reallocation of the string buffer. diff --git a/docs/atl-mfc-shared/basic-cstring-operations.md b/docs/atl-mfc-shared/basic-cstring-operations.md index 047bd978b28..243f52b3271 100644 --- a/docs/atl-mfc-shared/basic-cstring-operations.md +++ b/docs/atl-mfc-shared/basic-cstring-operations.md @@ -6,6 +6,8 @@ helpviewer_keywords: ["CString objects, basic operations", "string literals, CSt --- # Basic CString Operations +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + This topic explains the following basic [CString](../atl-mfc-shared/reference/cstringt-class.md) operations: - [Creating CString objects from standard C literal strings](#_core_creating_cstring_objects_from_standard_c_literal_strings) diff --git a/docs/atl-mfc-shared/cfixedstringt-example-of-a-custom-string-manager.md b/docs/atl-mfc-shared/cfixedstringt-example-of-a-custom-string-manager.md index 11094716d1b..b525fdae33f 100644 --- a/docs/atl-mfc-shared/cfixedstringt-example-of-a-custom-string-manager.md +++ b/docs/atl-mfc-shared/cfixedstringt-example-of-a-custom-string-manager.md @@ -3,10 +3,11 @@ description: "Learn more about: CFixedStringT: Example of a Custom String Manage title: "CFixedStringT: Example of a Custom String Manager" ms.date: "11/04/2016" helpviewer_keywords: ["CFixedStringT class, using a custom string manager"] -ms.assetid: 1cf11fd7-51b8-4b94-87af-02bc25f47dd6 --- # CFixedStringT: Example of a Custom String Manager +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + The ATL library implements one example of a custom string manager used by class [CFixedStringT](../atl-mfc-shared/reference/cfixedstringt-class.md), called **CFixedStringMgr**. `CFixedStringT` is derived from [CStringT](../atl-mfc-shared/reference/cstringt-class.md) and implements a string that allocates its character data as part of the `CFixedStringT` object itself as long as the string is less than the length specified by the `t_nChars` template parameter of `CFixedStringT`. With this approach, the string does not need the heap at all, unless the length of the string grows beyond the size of the fixed buffer. Because `CFixedStringT` does not always use a heap to allocate its string data, it cannot use `CAtlStringMgr` as its string manager. It uses a custom string manager (`CFixedStringMgr`), implementing the [IAtlStringMgr](../atl-mfc-shared/reference/iatlstringmgr-class.md) interface. This interface is discussed in [Implementation of a Custom String Manager (Advanced Method)](../atl-mfc-shared/implementation-of-a-custom-string-manager-advanced-method.md). The constructor for `CFixedStringMgr` takes three parameters: diff --git a/docs/atl-mfc-shared/cstring-argument-passing.md b/docs/atl-mfc-shared/cstring-argument-passing.md index 68ff5addc65..23f1483655f 100644 --- a/docs/atl-mfc-shared/cstring-argument-passing.md +++ b/docs/atl-mfc-shared/cstring-argument-passing.md @@ -6,6 +6,8 @@ helpviewer_keywords: ["strings [C++], as function input/output", "argument passi --- # `CString` Argument Passing +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + This article explains how to pass [`CString`](../atl-mfc-shared/reference/cstringt-class.md) objects to functions and how to return `CString` objects from functions. ## `CString` Argument-Passing Conventions diff --git a/docs/atl-mfc-shared/cstring-exception-cleanup.md b/docs/atl-mfc-shared/cstring-exception-cleanup.md index f9571eb6993..3a5273217b2 100644 --- a/docs/atl-mfc-shared/cstring-exception-cleanup.md +++ b/docs/atl-mfc-shared/cstring-exception-cleanup.md @@ -3,10 +3,11 @@ description: "Learn more about: CString Exception Cleanup" title: "CString Exception Cleanup" ms.date: "11/04/2016" helpviewer_keywords: ["CString objects, exceptions", "exception handling, cleanup code"] -ms.assetid: 28b9ce70-be63-4a0d-92a8-44bbfbc95e83 --- # CString Exception Cleanup +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + In previous versions of MFC, it was important that you clean up [CString](../atl-mfc-shared/reference/cstringt-class.md) objects after use. With MFC version 3.0 and later, explicit cleanup is no longer necessary. Under the C++ exception handling mechanism that MFC now uses, you do not have to worry about cleanup after an exception. For a description of how C++ "unwinds" the stack after an exception is caught, see [the try, catch, and throw statements](../cpp/try-throw-and-catch-statements-cpp.md). Even if you use the MFC **TRY**/**CATCH** macros instead of the C++ keywords **`try`** and **`catch`**, MFC uses the C++ exception mechanism underneath, so you still do not need to clean up explicitly. diff --git a/docs/atl-mfc-shared/cstring-operations-relating-to-c-style-strings.md b/docs/atl-mfc-shared/cstring-operations-relating-to-c-style-strings.md index c90c04bf1b1..8629690cd0a 100644 --- a/docs/atl-mfc-shared/cstring-operations-relating-to-c-style-strings.md +++ b/docs/atl-mfc-shared/cstring-operations-relating-to-c-style-strings.md @@ -3,10 +3,11 @@ description: "Learn more about: CString Operations Relating to C-Style Strings" title: "CString Operations Relating to C-Style Strings" ms.date: "11/04/2016" helpviewer_keywords: ["CString objects, basic operations", "MFC [C++], string handling class", "string conversion [C++], C-style strings", "strings [C++], string operations", "standard run-time library string functions", "null values, Null-terminated string conversion", "string functions", "strings [C++], in C", "string arguments", "C-style strings", "strings [C++], class CString", "casting CString objects"] -ms.assetid: 5048de8a-5298-4891-b8a0-c554b5a3ac1b --- # `CString` Operations Relating to C-Style Strings +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + A [`CString`](../atl-mfc-shared/using-cstring.md) object contains character string data. `CString` inherits the set of the [methods and operators](../atl-mfc-shared/reference/cstringt-class.md) that are defined in the class template [`CStringT`](../atl-mfc-shared/reference/cstringt-class.md) to work with string data. (`CString` is a **`typedef`** that specializes `CStringT` to work with the kind of character data that `CString` supports.) `CString` does not store character data internally as a C-style null-terminated string. Instead, `CString` tracks the length of character data so that it can more securely watch the data and the space it requires. diff --git a/docs/atl-mfc-shared/cstring-semantics.md b/docs/atl-mfc-shared/cstring-semantics.md index a8b283511b6..a978cc1e251 100644 --- a/docs/atl-mfc-shared/cstring-semantics.md +++ b/docs/atl-mfc-shared/cstring-semantics.md @@ -3,10 +3,11 @@ description: "Learn more about: CString Semantics" title: "CString Semantics" ms.date: "11/04/2016" helpviewer_keywords: ["semantics in Cstring", "CString objects, assignment semantics", "assignment statements, assigning CString objects"] -ms.assetid: d4023480-526f-499a-85f6-324b4de5b85f --- # CString Semantics +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + Even though [CString](../atl-mfc-shared/reference/cstringt-class.md) objects are dynamic objects that can grow, they act like built-in primitive types and simple classes. Each `CString` object represents a unique value. `CString` objects should be thought of as the actual strings rather than as pointers to strings. You can assign one `CString` object to another. However, when you modify one of the two `CString` objects, the other `CString` object is not modified, as shown by the following example: diff --git a/docs/atl-mfc-shared/date-and-time.md b/docs/atl-mfc-shared/date-and-time.md index 6285d86cb2f..9f7eec080cc 100644 --- a/docs/atl-mfc-shared/date-and-time.md +++ b/docs/atl-mfc-shared/date-and-time.md @@ -6,6 +6,8 @@ helpviewer_keywords: ["time, MFC programming", "time", "MFC, date and time", "da --- # Date and Time +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + MFC supports several different ways of working with dates and times: - Support for the Automation [`DATE` data type](../atl-mfc-shared/date-type.md). `DATE` supports date, time, and date/time values. The [`COleDateTime`](../atl-mfc-shared/reference/coledatetime-class.md) and [`COleDateTimeSpan`](../atl-mfc-shared/reference/coledatetimespan-class.md) classes encapsulate this functionality. They work with the [`COleVariant`](../mfc/reference/colevariant-class.md) class using Automation support. diff --git a/docs/atl-mfc-shared/date-type.md b/docs/atl-mfc-shared/date-type.md index 51909869c5b..6c9e9c6c7fb 100644 --- a/docs/atl-mfc-shared/date-type.md +++ b/docs/atl-mfc-shared/date-type.md @@ -4,10 +4,11 @@ title: "DATE Type" ms.date: "11/04/2016" f1_keywords: ["DATE"] helpviewer_keywords: ["Date data type, implementing", "Date data type", "DATE type", "Date data type, about Date data type", "MFC, date and time", "hour values representation"] -ms.assetid: 695853ed-b614-4575-b793-b8c287372038 --- # DATE Type +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + The DATE type is implemented using an 8-byte floating-point number. Days are represented by whole number increments starting with 30 December 1899, midnight as time zero. Hour values are expressed as the absolute value of the fractional part of the number. The following table illustrates several dates along with their DATE type numeric equivalent: |Date and time|Representation| diff --git a/docs/atl-mfc-shared/exporting-string-classes-using-cstringt.md b/docs/atl-mfc-shared/exporting-string-classes-using-cstringt.md index 3e5b794a885..c8e98da7fe7 100644 --- a/docs/atl-mfc-shared/exporting-string-classes-using-cstringt.md +++ b/docs/atl-mfc-shared/exporting-string-classes-using-cstringt.md @@ -3,10 +3,11 @@ description: "Learn more about: Exporting String Classes Using CStringT" title: "Exporting String Classes Using CStringT" ms.date: "11/04/2016" helpviewer_keywords: ["CStringT class, exporting strings"] -ms.assetid: bdfc441e-8d2a-461c-9885-46178066c09f --- # Exporting String Classes Using CStringT +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + In the past, MFC developers have derived from `CString` to specialize their own string classes. In Microsoft Visual C++.NET (MFC 8.0), the [CString](../atl-mfc-shared/using-cstring.md) class was superseded by a template class called [CStringT](../atl-mfc-shared/reference/cstringt-class.md). This provided several benefits: - It allowed the MFC `CString` class to be used in ATL projects without linking in the larger MFC static library or DLL. diff --git a/docs/atl-mfc-shared/implementation-of-a-custom-string-manager-advanced-method.md b/docs/atl-mfc-shared/implementation-of-a-custom-string-manager-advanced-method.md index 55fe40e157f..0ea1922d71c 100644 --- a/docs/atl-mfc-shared/implementation-of-a-custom-string-manager-advanced-method.md +++ b/docs/atl-mfc-shared/implementation-of-a-custom-string-manager-advanced-method.md @@ -3,10 +3,11 @@ description: "Learn more about: Implementation of a Custom String Manager (Advan title: "Implementation of a Custom String Manager (Advanced Method)" ms.date: "11/04/2016" helpviewer_keywords: ["IAtlStringMgr class, using"] -ms.assetid: 64ab7da9-47c1-4c4a-9cd7-4cc37e7f3f57 --- # Implementation of a Custom String Manager (Advanced Method) +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + In specialized situations, you might want to implement a custom string manager that does more than just change which heap is used to allocate memory. In this situation, you must manually implement the [IAtlStringMgr](../atl-mfc-shared/reference/iatlstringmgr-class.md) interface as your custom string manager. In order to do this, it is important to first understand how [CStringT](../atl-mfc-shared/reference/cstringt-class.md) uses that interface to manage its string data. Every instance of `CStringT` has a pointer to a [CStringData](../atl-mfc-shared/reference/cstringdata-class.md) structure. This variable-length structure contains important information about the string (such as length), as well as the actual character data for the string. Every custom string manager is responsible for allocating and freeing these structures at the request of `CStringT`. diff --git a/docs/atl-mfc-shared/implementation-of-a-custom-string-manager-basic-method.md b/docs/atl-mfc-shared/implementation-of-a-custom-string-manager-basic-method.md index 2e91251aaa2..ff0ead0d8cd 100644 --- a/docs/atl-mfc-shared/implementation-of-a-custom-string-manager-basic-method.md +++ b/docs/atl-mfc-shared/implementation-of-a-custom-string-manager-basic-method.md @@ -3,10 +3,11 @@ description: "Learn more about: Implementation of a Custom String Manager (Basic title: "Implementation of a Custom String Manager (Basic Method)" ms.date: "11/04/2016" helpviewer_keywords: ["IAtlStringMgr class, using"] -ms.assetid: eac5d13e-cbb4-4e82-b01e-f5f2dbcb962a --- # Implementation of a Custom String Manager (Basic Method) +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + The easiest way to customize the memory allocation scheme for string data is to use the ATL-provided `CAtlStringMgr` class but provide your own memory allocation routines. The constructor for `CAtlStringMgr` takes a single parameter: a pointer to an `IAtlMemMgr` object. `IAtlMemMgr` is an abstract base class that provides a generic interface to a heap. Using the `IAtlMemMgr` interface, the `CAtlStringMgr` allocates, reallocates, and frees the memory used to store string data. You can either implement the `IAtlMemMgr` interface yourself, or use one of the five ATL-provided memory manager classes. The ATL-provided memory managers simply wrap existing memory allocation facilities: - [CCRTHeap](../atl/reference/ccrtheap-class.md) Wraps the standard CRT heap functions ([malloc](../c-runtime-library/reference/malloc.md), [free](../c-runtime-library/reference/free.md), and [realloc](../c-runtime-library/reference/realloc.md)) diff --git a/docs/atl-mfc-shared/includes/lifecycle-note.md b/docs/atl-mfc-shared/includes/lifecycle-note.md new file mode 100644 index 00000000000..6725bfc524e --- /dev/null +++ b/docs/atl-mfc-shared/includes/lifecycle-note.md @@ -0,0 +1,2 @@ +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. \ No newline at end of file diff --git a/docs/atl-mfc-shared/memory-management-with-cstringt.md b/docs/atl-mfc-shared/memory-management-with-cstringt.md index c0df6f2ceb3..104e67a46e7 100644 --- a/docs/atl-mfc-shared/memory-management-with-cstringt.md +++ b/docs/atl-mfc-shared/memory-management-with-cstringt.md @@ -3,10 +3,11 @@ description: "Learn more about: Memory Management with CStringT" title: "Memory Management with CStringT" ms.date: "11/04/2016" helpviewer_keywords: ["CString objects, memory management", "memory [C++], usage", "IAtlStringMgr class, using", "strings [C++], custom memory management", "CFixedStringT class, description of", "strings [C++], memory management", "CStringT class, memory management"] -ms.assetid: 88b8342d-19b5-48c4-9cf6-e4c44cece21e --- # Memory Management with CStringT +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + Class [CStringT](../atl-mfc-shared/reference/cstringt-class.md) is a template class used to manipulate variable-length character strings. The memory to hold these strings is allocated and released through a string manager object, associated with each instance of `CStringT`. MFC and ATL provide default instantiations of `CStringT`, called `CString`, `CStringA`, and `CStringW`, which manipulate strings of different character types. These character types are of type TCHAR, **`char`**, and **`wchar_t`**, respectively. These default string types use a string manager that allocates memory from the process heap (in ATL) or the CRT heap (in MFC). For typical applications, this memory allocation scheme is sufficient. However, for code making intensive use of strings (or multithreaded code) the default memory managers may not perform optimally. This topic describes how to override the default memory management behavior of `CStringT`, creating allocators specifically optimized for the task at hand. - [Implementation of a Custom String Manager (Basic Method)](../atl-mfc-shared/implementation-of-a-custom-string-manager-basic-method.md) diff --git a/docs/atl-mfc-shared/reference/cfiletime-class.md b/docs/atl-mfc-shared/reference/cfiletime-class.md index 35d7d8dc48e..abc271c7199 100644 --- a/docs/atl-mfc-shared/reference/cfiletime-class.md +++ b/docs/atl-mfc-shared/reference/cfiletime-class.md @@ -4,10 +4,11 @@ title: "CFileTime class" ms.date: "10/18/2018" f1_keywords: ["CFileTime", "ATLTIME/ATL::CFileTime", "ATLTIME/ATL::CFileTime::CFileTime", "ATLTIME/ATL::CFileTime::GetCurrentTime", "ATLTIME/ATL::CFileTime::GetTime", "ATLTIME/ATL::CFileTime::LocalToUTC", "ATLTIME/ATL::CFileTime::SetTime", "ATLTIME/ATL::CFileTime::UTCToLocal", "ATLTIME/ATL::CFileTime::Day", "ATLTIME/ATL::CFileTime::Hour", "ATLTIME/ATL::CFileTime::Millisecond", "ATLTIME/ATL::CFileTime::Minute", "ATLTIME/ATL::CFileTime::Second", "ATLTIME/ATL::CFileTime::Week"] helpviewer_keywords: ["CFileTime class", "shared classes, CFileTime"] -ms.assetid: 1a358a65-1383-4124-b0d4-59b026e6860f --- # `CFileTime` class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for managing the date and time values associated with a file. ## Syntax diff --git a/docs/atl-mfc-shared/reference/cfiletimespan-class.md b/docs/atl-mfc-shared/reference/cfiletimespan-class.md index 62a26f382ec..b972803f581 100644 --- a/docs/atl-mfc-shared/reference/cfiletimespan-class.md +++ b/docs/atl-mfc-shared/reference/cfiletimespan-class.md @@ -4,10 +4,11 @@ description: "The Active Template Library (ATL) and Microsoft Foundation Classes ms.date: "01/10/2020" f1_keywords: ["CFileTimeSpan", "ATLTIME/ATL::CFileTimeSpan", "ATLTIME/ATL::CFileTimeSpan::CFileTimeSpan", "ATLTIME/ATL::CFileTimeSpan::GetTimeSpan", "ATLTIME/ATL::CFileTimeSpan::SetTimeSpan"] helpviewer_keywords: ["shared classes, CFileTimeSpan", "CFileTimeSpan class"] -ms.assetid: 5856fb39-9c82-4027-8ccf-8760890491ec --- # `CFileTimeSpan` class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides methods for managing relative date and time values associated with a file. ## Syntax diff --git a/docs/atl-mfc-shared/reference/cfixedstringt-class.md b/docs/atl-mfc-shared/reference/cfixedstringt-class.md index c236dcb8d4d..6109dc0c1a6 100644 --- a/docs/atl-mfc-shared/reference/cfixedstringt-class.md +++ b/docs/atl-mfc-shared/reference/cfixedstringt-class.md @@ -4,10 +4,11 @@ title: "CFixedStringT Class" ms.date: "03/27/2019" f1_keywords: ["CFixedStringT", "CSTRINGT/ATL::CFixedStringT", "CSTRINGT/ATL::CFixedStringT::CFixedStringT"] helpviewer_keywords: ["CFixedStringT class", "shared classes, CFixedStringT"] -ms.assetid: 6d4171ba-3104-493a-a6cc-d515f4ba9a4b --- # CFixedStringT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a string object with a fixed character buffer. ## Syntax diff --git a/docs/atl-mfc-shared/reference/cimage-class.md b/docs/atl-mfc-shared/reference/cimage-class.md index d355d0f27a4..311a44e2811 100644 --- a/docs/atl-mfc-shared/reference/cimage-class.md +++ b/docs/atl-mfc-shared/reference/cimage-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["jpeg files", "bitmaps [C++], ATL and MFC support for", "i --- # `CImage` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + `CImage` provides enhanced bitmap support, including the ability to load and save images in JPEG, GIF, BMP, and Portable Network Graphics (PNG) formats. > [!IMPORTANT] diff --git a/docs/atl-mfc-shared/reference/classes-shared-by-mfc-and-atl.md b/docs/atl-mfc-shared/reference/classes-shared-by-mfc-and-atl.md index bbcb2af0790..6fb01f6e90c 100644 --- a/docs/atl-mfc-shared/reference/classes-shared-by-mfc-and-atl.md +++ b/docs/atl-mfc-shared/reference/classes-shared-by-mfc-and-atl.md @@ -3,10 +3,11 @@ description: "Learn more about: Classes Shared by MFC and ATL" title: "Classes Shared by MFC and ATL" ms.date: "11/04/2016" helpviewer_keywords: ["shared classes, classes"] -ms.assetid: ca8b4b6b-744d-430b-b31f-d5b2f17bf210 --- # Classes Shared by MFC and ATL +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + The following table lists the classes shared between MFC and ATL. |Class|Description|Header file| diff --git a/docs/atl-mfc-shared/reference/coledatetime-class.md b/docs/atl-mfc-shared/reference/coledatetime-class.md index 5da193d9b93..98a888a14f1 100644 --- a/docs/atl-mfc-shared/reference/coledatetime-class.md +++ b/docs/atl-mfc-shared/reference/coledatetime-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["shared classes, COleDateTime", "time-only values", "Date --- # COleDateTime Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Encapsulates the `DATE` data type that is used in OLE automation. ## Syntax diff --git a/docs/atl-mfc-shared/reference/coledatetimespan-class.md b/docs/atl-mfc-shared/reference/coledatetimespan-class.md index 491074bbae3..04701fb7ddc 100644 --- a/docs/atl-mfc-shared/reference/coledatetimespan-class.md +++ b/docs/atl-mfc-shared/reference/coledatetimespan-class.md @@ -4,10 +4,11 @@ title: "COleDateTimeSpan Class" ms.date: "03/27/2019" f1_keywords: ["COleDateTimeSpan", "ATLCOMTIME/ATL::COleDateTimeSpan", "ATLCOMTIME/ATL::COleDateTimeSpan::COleDateTimeSpan", "ATLCOMTIME/ATL::COleDateTimeSpan::Format", "ATLCOMTIME/ATL::COleDateTimeSpan::GetDays", "ATLCOMTIME/ATL::COleDateTimeSpan::GetHours", "ATLCOMTIME/ATL::COleDateTimeSpan::GetMinutes", "ATLCOMTIME/ATL::COleDateTimeSpan::GetSeconds", "ATLCOMTIME/ATL::COleDateTimeSpan::GetStatus", "ATLCOMTIME/ATL::COleDateTimeSpan::GetTotalDays", "ATLCOMTIME/ATL::COleDateTimeSpan::GetTotalHours", "ATLCOMTIME/ATL::COleDateTimeSpan::GetTotalMinutes", "ATLCOMTIME/ATL::COleDateTimeSpan::GetTotalSeconds", "ATLCOMTIME/ATL::COleDateTimeSpan::SetDateTimeSpan", "ATLCOMTIME/ATL::COleDateTimeSpan::SetStatus", "ATLCOMTIME/ATL::COleDateTimeSpan::m_span", "ATLCOMTIME/ATL::COleDateTimeSpan::m_status"] helpviewer_keywords: ["timespan", "time span", "shared classes, COleDateTimeSpan", "Date data type, MFC encapsulation of", "COleDateTimeSpan class"] -ms.assetid: 7441526d-a30a-4019-8fb3-3fee6f897cbe --- # COleDateTimeSpan Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Represents a relative time, a time span. ## Syntax diff --git a/docs/atl-mfc-shared/reference/cpoint-class.md b/docs/atl-mfc-shared/reference/cpoint-class.md index 1636a18f6dd..d153efe18e5 100644 --- a/docs/atl-mfc-shared/reference/cpoint-class.md +++ b/docs/atl-mfc-shared/reference/cpoint-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["LPPOINT structure", "POINT structure", "CPoint class"] --- # `CPoint` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Similar to the Windows `POINT` structure. ## Syntax diff --git a/docs/atl-mfc-shared/reference/crect-class.md b/docs/atl-mfc-shared/reference/crect-class.md index a213a9fcb66..2ccae83333a 100644 --- a/docs/atl-mfc-shared/reference/crect-class.md +++ b/docs/atl-mfc-shared/reference/crect-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["LPCRECT data type", "CRect class", "LPRECT operator", "RE --- # `CRect` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Similar to a Windows [`RECT`](/windows/win32/api/windef/ns-windef-rect) structure. ## Syntax diff --git a/docs/atl-mfc-shared/reference/csimplestringt-class.md b/docs/atl-mfc-shared/reference/csimplestringt-class.md index b62a850efa1..cda69f67bea 100644 --- a/docs/atl-mfc-shared/reference/csimplestringt-class.md +++ b/docs/atl-mfc-shared/reference/csimplestringt-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["shared classes, CSimpleStringT", "strings [C++], ATL clas --- # `CSimpleStringT` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a `CSimpleStringT` object. ## Syntax diff --git a/docs/atl-mfc-shared/reference/csize-class.md b/docs/atl-mfc-shared/reference/csize-class.md index f398b5055da..458de4f0ed0 100644 --- a/docs/atl-mfc-shared/reference/csize-class.md +++ b/docs/atl-mfc-shared/reference/csize-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["SIZE", "dimensions, MFC", "dimensions", "CSize class"] --- # CSize Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Similar to the Windows [SIZE](/windows/win32/api/windef/ns-windef-size) structure, which implements a relative coordinate or position. ## Syntax diff --git a/docs/atl-mfc-shared/reference/cstrbuft-class.md b/docs/atl-mfc-shared/reference/cstrbuft-class.md index 4cc53bfee59..ed385faa03d 100644 --- a/docs/atl-mfc-shared/reference/cstrbuft-class.md +++ b/docs/atl-mfc-shared/reference/cstrbuft-class.md @@ -4,10 +4,11 @@ title: "CStrBufT Class" ms.date: "10/18/2018" f1_keywords: ["CStrBufT", "ATLSIMPSTR/ATL::CStrBufT", "ATLSIMPSTR/ATL::CStrBufT::CStrBufT", "ATLSIMPSTR/ATL::CStrBufT::SetLength", "ATLSIMPSTR/ATL::CStrBufT::AUTO_LENGTH", "ATLSIMPSTR/ATL::CStrBufT::SET_LENGTH"] helpviewer_keywords: ["strings [C++], custom memory management", "CStrBufT class", "shared classes, CStrBufT"] -ms.assetid: 6b50fa8f-87e8-4ed4-a229-157ce128710f --- # CStrBufT Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class provides automatic resource cleanup for `GetBuffer` and `ReleaseBuffer` calls on an existing `CStringT` object. ## Syntax diff --git a/docs/atl-mfc-shared/reference/cstringdata-class.md b/docs/atl-mfc-shared/reference/cstringdata-class.md index 2755f5e8ab1..8db5939672f 100644 --- a/docs/atl-mfc-shared/reference/cstringdata-class.md +++ b/docs/atl-mfc-shared/reference/cstringdata-class.md @@ -4,10 +4,11 @@ title: "CStringData Class" ms.date: "11/04/2016" f1_keywords: ["CStringData", "ATLSIMPSTR/ATL::CStringData", "ATLSIMPSTR/ATL::AddRef", "ATLSIMPSTR/ATL::data", "ATLSIMPSTR/ATL::IsLocked", "ATLSIMPSTR/ATL::IsShared", "ATLSIMPSTR/ATL::Lock", "ATLSIMPSTR/ATL::Release", "ATLSIMPSTR/ATL::Unlock", "ATLSIMPSTR/ATL::nAllocLength", "ATLSIMPSTR/ATL::nDataLength", "ATLSIMPSTR/ATL::nRefs", "ATLSIMPSTR/ATL::pStringMgr"] helpviewer_keywords: ["CStringData class", "shared classes, CStringData"] -ms.assetid: 4e31b5ca-3dbe-4fd5-b692-8211fbfb2593 --- # CStringData Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents the data of a string object. ## Syntax diff --git a/docs/atl-mfc-shared/reference/cstringt-class.md b/docs/atl-mfc-shared/reference/cstringt-class.md index a47c9ad9a69..d22cac3373a 100644 --- a/docs/atl-mfc-shared/reference/cstringt-class.md +++ b/docs/atl-mfc-shared/reference/cstringt-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["strings [C++], in ATL", "shared classes, CStringT", "CStr --- # `CStringT` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents a **`CStringT`** object. ## Syntax diff --git a/docs/atl-mfc-shared/reference/ctime-class.md b/docs/atl-mfc-shared/reference/ctime-class.md index 067db91b524..9c5623b02f3 100644 --- a/docs/atl-mfc-shared/reference/ctime-class.md +++ b/docs/atl-mfc-shared/reference/ctime-class.md @@ -4,10 +4,11 @@ title: "CTime Class" ms.date: "10/18/2018" f1_keywords: ["ATLTIME/ATL::CTime", "ATLTIME/ATL::CTime::CTime", "ATLTIME/ATL::CTime::Format", "ATLTIME/ATL::CTime::FormatGmt", "ATLTIME/ATL::CTime::GetAsDBTIMESTAMP", "ATLTIME/ATL::CTime::GetAsSystemTime", "ATLTIME/ATL::CTime::GetCurrentTime", "ATLTIME/ATL::CTime::GetDay", "ATLTIME/ATL::CTime::GetDayOfWeek", "ATLTIME/ATL::CTime::GetGmtTm", "ATLTIME/ATL::CTime::GetHour", "ATLTIME/ATL::CTime::GetLocalTm", "ATLTIME/ATL::CTime::GetMinute", "ATLTIME/ATL::CTime::GetMonth", "ATLTIME/ATL::CTime::GetSecond", "ATLTIME/ATL::CTime::GetTime", "ATLTIME/ATL::CTime::GetYear", "ATLTIME/ATL::CTime::Serialize64"] helpviewer_keywords: ["CTime class", "shared classes, CTime"] -ms.assetid: 0a299544-485b-48dc-9d3c-fdc30f57d612 --- # CTime Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + Represents an absolute time and date. ## Syntax diff --git a/docs/atl-mfc-shared/reference/ctimespan-class.md b/docs/atl-mfc-shared/reference/ctimespan-class.md index ae10bdba1cf..df669d06353 100644 --- a/docs/atl-mfc-shared/reference/ctimespan-class.md +++ b/docs/atl-mfc-shared/reference/ctimespan-class.md @@ -7,6 +7,8 @@ helpviewer_keywords: ["elapsed time, CTimeSpan object", "timespan", "time span", --- # `CTimeSpan` Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + An amount of time, which is internally stored as the number of seconds in the time span. ## Syntax diff --git a/docs/atl-mfc-shared/reference/iatlstringmgr-class.md b/docs/atl-mfc-shared/reference/iatlstringmgr-class.md index 9eb991ca286..c94ac02b615 100644 --- a/docs/atl-mfc-shared/reference/iatlstringmgr-class.md +++ b/docs/atl-mfc-shared/reference/iatlstringmgr-class.md @@ -4,10 +4,11 @@ title: "IAtlStringMgr Class" ms.date: "10/18/2018" f1_keywords: ["IAtlStringMgr", "ATLSIMPSTR/ATL::IAtlStringMgr", "ATLSIMPSTR/ATL::Allocate", "ATLSIMPSTR/ATL::Clone", "ATLSIMPSTR/ATL::Free", "ATLSIMPSTR/ATL::GetNilString", "ATLSIMPSTR/ATL::Reallocate"] helpviewer_keywords: ["shared classes, IAtlStringMgr", "memory, managing", "IAtlStringMgr class"] -ms.assetid: 722f0346-a770-4aa7-8f94-177be8dba823 --- # IAtlStringMgr Class +[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] + This class represents the interface to a `CStringT` memory manager. ## Syntax diff --git a/docs/atl-mfc-shared/string-data-management.md b/docs/atl-mfc-shared/string-data-management.md index b48c6a636da..c30b096c6ec 100644 --- a/docs/atl-mfc-shared/string-data-management.md +++ b/docs/atl-mfc-shared/string-data-management.md @@ -6,6 +6,8 @@ helpviewer_keywords: ["Unicode, string objects"] --- # String Data Management +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + Visual C++ provides several ways to manage string data: - [String Manipulation](../c-runtime-library/string-manipulation-crt.md) for working with C-style `NULL`-terminated strings diff --git a/docs/atl-mfc-shared/strings-atl-mfc.md b/docs/atl-mfc-shared/strings-atl-mfc.md index 1c0b4515fa4..a497b8ec3a7 100644 --- a/docs/atl-mfc-shared/strings-atl-mfc.md +++ b/docs/atl-mfc-shared/strings-atl-mfc.md @@ -6,6 +6,8 @@ helpviewer_keywords: ["const char pointers", "strings [C++], in ATL", "MFC [C++] --- # Strings (ATL/MFC) +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + Nearly all programs work with string data. Visual C++ provides several ways to manage this string data. ## In This Section diff --git a/docs/atl-mfc-shared/unicode-and-multibyte-character-set-mbcs-support.md b/docs/atl-mfc-shared/unicode-and-multibyte-character-set-mbcs-support.md index 2ba1928aa64..b6ca21a7e14 100644 --- a/docs/atl-mfc-shared/unicode-and-multibyte-character-set-mbcs-support.md +++ b/docs/atl-mfc-shared/unicode-and-multibyte-character-set-mbcs-support.md @@ -6,6 +6,8 @@ helpviewer_keywords: ["MFC [C++], character set support", "MBCS [C++], strings a --- # Unicode and Multibyte Character Set (MBCS) Support +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + Some languages, for example, Japanese and Chinese, have large character sets. To support programming for these markets, the Microsoft Foundation Class Library (MFC) enables two different approaches to handling large character sets: - [Unicode](#mfc-support-for-unicode-strings), **`wchar_t`** based wide-characters, and strings encoded as UTF-16. diff --git a/docs/atl-mfc-shared/using-cstring.md b/docs/atl-mfc-shared/using-cstring.md index f6a99466fcc..829888fc125 100644 --- a/docs/atl-mfc-shared/using-cstring.md +++ b/docs/atl-mfc-shared/using-cstring.md @@ -3,10 +3,11 @@ description: "Learn more about: Using CString" title: "Using CString" ms.date: "06/18/2018" helpviewer_keywords: ["CString objects, C++ string manipulation", "CString objects, reference counting", "CString class (Visual C++)"] -ms.assetid: ed018aaf-8b10-46f9-828c-f9c092dc7609 --- # Using `CString` +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + The topics in this section describe how to program with `CString`. For reference documentation about the `CString` class, see the documentation for [`CStringT`](../atl-mfc-shared/reference/cstringt-class.md). To use `CString`, include the `atlstr.h` header. diff --git a/docs/atl-mfc-shared/using-cstringt.md b/docs/atl-mfc-shared/using-cstringt.md index e7232579f8a..6e322077aef 100644 --- a/docs/atl-mfc-shared/using-cstringt.md +++ b/docs/atl-mfc-shared/using-cstringt.md @@ -3,10 +3,11 @@ description: "Learn more about: Using CStringT" title: "Using CStringT" ms.date: "11/04/2016" helpviewer_keywords: ["CStringT class, using"] -ms.assetid: 3a9fffb1-6f90-482a-ab69-4003e6084cb5 --- # Using CStringT +[!INCLUDE[product-lifecycle-status](./includes/lifecycle-note.md)] + The topics in this section describe programming using the template class [CStringT](../atl-mfc-shared/reference/cstringt-class.md). ## In This Section diff --git a/docs/mfc/activex-controls.md b/docs/mfc/activex-controls.md index 6dcea4cccbb..936df4c4773 100644 --- a/docs/mfc/activex-controls.md +++ b/docs/mfc/activex-controls.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["ActiveX controls [MFC]"] # ActiveX Controls >[!NOTE] -> The Microsoft Foundation Classes (MFC) library continues to be supported. However, we're no longer adding features or updating the documentation. +> The Microsoft Foundation Classes (MFC) library and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. In Visual Studio you can create ActiveX controls using MFC or ATL. @@ -15,7 +15,6 @@ In Visual Studio you can create ActiveX controls using MFC or ATL. > ActiveX is a legacy technology that should not be used for new development. Many capabilities of ActiveX controls can be performed in a simpler and much more secure way with modern technologies such as HTML5 and JavaScript, modern browser extensions, or WebAssembly modules. For more information, see [A break from the past, part 2: Saying goodbye to ActiveX, VBScript, attachEvent](https://blogs.windows.com/msedgedev/2015/05/06/a-break-from-the-past-part-2-saying-goodbye-to-activex-vbscript-attachevent/) and [Native Messaging](/microsoft-edge/extensions/guides/native-messaging) and [Microsoft Edge extensions](/microsoft-edge/extensions) and [WebAssembly](https://webassembly.org/). - [MFC ActiveX Controls](mfc-activex-controls.md) - - [ATL](../atl/active-template-library-atl-concepts.md) ## See also From 5637f543393dbae4cde1a1af0f18f91999a8c1d6 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 26 Feb 2026 16:22:58 -0800 Subject: [PATCH 1669/1799] add hybrid msg --- docs/atl/reference/mfc-support-in-atl-projects.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/atl/reference/mfc-support-in-atl-projects.md b/docs/atl/reference/mfc-support-in-atl-projects.md index b3b28f91baa..faa1b174097 100644 --- a/docs/atl/reference/mfc-support-in-atl-projects.md +++ b/docs/atl/reference/mfc-support-in-atl-projects.md @@ -7,7 +7,8 @@ helpviewer_keywords: ["ATL projects, MFC support"] --- # MFC Support in ATL Projects -[!INCLUDE[product-lifecycle-status](../includes/lifecycle-note.md)] +>[!NOTE] +> The Microsoft Foundation Classes (MFC) library and Active Template Library (ATL) continue to be supported. However, we're no longer adding features or updating the documentation. If you select **Support MFC** in the ATL Project Wizard, your project declares the application as an MFC application object (class). The project initializes the MFC library and instantiates a class (class *ProjName*) that is derived from [CWinApp](../../mfc/reference/cwinapp-class.md). From 928993083976a0cd5da6855feb285c5d6de76886 Mon Sep 17 00:00:00 2001 From: Hulon Jenkins <109993038+HulonJenkins@users.noreply.github.com> Date: Fri, 27 Feb 2026 10:08:28 -0800 Subject: [PATCH 1670/1799] Update compiler warning doc with C4737 unable to tail call --- .../compiler-warnings/compiler-warnings-c4600-through-c4799.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md index 073da826414..230df86670f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md @@ -134,6 +134,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |Compiler warning C4734|More than 64k line numbers in a COFF debug info section; stop emitting COFF debug line numbers for module 'module'| |Compiler warning C4735|`align_function` attribute argument '*argument*' is not a power of two and is not positive. Ignoring attribute| |Compiler warning C4736|`align_function` attribute ignored because `/Gy` was not specified| +|Compiler warning C4737| Unable to perform required tail call. Performance may be degraded. See [`[[msvc::musttail]]`](https://learn.microsoft.com/cpp/cpp/attributes#msvcmusttail)| |[Compiler warning (Level 3) C4738](compiler-warning-level-3-c4738.md)|storing 32-bit float result in memory, possible loss of performance| |[Compiler warning (level 1) C4739](compiler-warning-level-1-c4739.md)|reference to variable 'var' exceeds its storage space| |[Compiler warning (Level 4) C4740](compiler-warning-level-4-c4740.md)|flow in or out of inline asm code suppresses global optimization| From b3edfccb9001edd1e681ec44460f4ed74167767a Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 27 Feb 2026 14:25:59 -0800 Subject: [PATCH 1671/1799] Update link for Compiler warning C4737 --- .../compiler-warnings-c4600-through-c4799.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md index 230df86670f..26ff337deb2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md @@ -134,7 +134,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |Compiler warning C4734|More than 64k line numbers in a COFF debug info section; stop emitting COFF debug line numbers for module 'module'| |Compiler warning C4735|`align_function` attribute argument '*argument*' is not a power of two and is not positive. Ignoring attribute| |Compiler warning C4736|`align_function` attribute ignored because `/Gy` was not specified| -|Compiler warning C4737| Unable to perform required tail call. Performance may be degraded. See [`[[msvc::musttail]]`](https://learn.microsoft.com/cpp/cpp/attributes#msvcmusttail)| +|Compiler warning C4737| Unable to perform required tail call. Performance may be degraded. See [`[[msvc::musttail]]`](../../cpp/attributes.md#msvcmusttail)| |[Compiler warning (Level 3) C4738](compiler-warning-level-3-c4738.md)|storing 32-bit float result in memory, possible loss of performance| |[Compiler warning (level 1) C4739](compiler-warning-level-1-c4739.md)|reference to variable 'var' exceeds its storage space| |[Compiler warning (Level 4) C4740](compiler-warning-level-4-c4740.md)|flow in or out of inline asm code suppresses global optimization| @@ -176,4 +176,4 @@ The articles in this section describe Microsoft C/C++ compiler warning messages ## See also [C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ -[Compiler warnings C4000 - C5999](compiler-warnings-c4000-c5999.md) \ No newline at end of file +[Compiler warnings C4000 - C5999](compiler-warnings-c4000-c5999.md) From 6df32516b739831d1b9e7de5c2919b828fbb8755 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 27 Feb 2026 15:08:45 -0800 Subject: [PATCH 1672/1799] Fix date and clarify 'new' operator usage for C2469 Updated remark and removed the extra error that was produced so the reader can focus on C2469 --- .../compiler-errors-1/compiler-error-c2469.md | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md index 836e2ea2623..1a340f4bf07 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2469.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2469.md @@ -1,7 +1,7 @@ --- title: "Compiler Error C2469" description: "Learn more about: Compiler Error C2469" -ms.date: 07/23/2025 +ms.date: 2/27/2026 f1_keywords: ["C2469"] helpviewer_keywords: ["C2469"] --- @@ -11,29 +11,25 @@ helpviewer_keywords: ["C2469"] ## Remarks -The [`new` operator](../../cpp/new-operator-cpp.md) was passed an invalid type. +The [`new` operator](../../cpp/new-operator-cpp.md) allocates memory and constructs an object of the specified type. Since `void` isn't a constructible type, use `::operator new(size)` to allocate raw memory without object construction. ## Example: Wrong allocation type -Check if you meant to allocate `void` or some other type, such as `int`: - ```cpp -// C2469_wrong_allocation_type.cpp - +// compile with /c int main() { - int* ptr1 = new void; // C2469 - int* ptr2 = new int; // OK + void* ptr1 = new void; // C2469 + int* ptr2 = new int; // OK } ``` ## Example: Allocate untyped memory -If you meant to allocate untyped memory, use `::operator new` instead: +To allocate untyped memory, use `::operator new`: ```cpp -// C2469_allocate_untyped_memory.cpp - +// compile with /c int main() { void* ptr1 = new void; // C2469 From 917032bc35b765033db0c76c621e23605c94b665 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 27 Feb 2026 15:27:49 -0800 Subject: [PATCH 1673/1799] Clarify floating-point predecrement behavior --- docs/build/arm64-exception-handling.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/arm64-exception-handling.md b/docs/build/arm64-exception-handling.md index 6c82d44da4c..3742b4cef7b 100644 --- a/docs/build/arm64-exception-handling.md +++ b/docs/build/arm64-exception-handling.md @@ -401,7 +401,7 @@ Step 6: Allocate remaining stack, including local area, `` pair, and out \* If **CR** == 01 and **RegI** is an odd number, step 3 and the last `save_reg` in step 2 are merged into one `save_regp`. -\*\* If **RegI** == 0, **CR** != 01, and **RegF** != 0, the first `stp` for the floating-point does the predecrement. +\*\* If **RegI** == 0, **CR** != 01, and **RegF** != 0, the first `stp` for the floating-point does the predecrement (that is, it accounts for the FP/SIMD save area). \*\*\* No instruction corresponding to `mov x29,sp` is present in the epilog. Packed unwind data can't be used if a function requires restoration of `sp` from `x29`. From 6ee11267f4bd6d2037d894e284c93b53d6f494fc Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 27 Feb 2026 15:31:04 -0800 Subject: [PATCH 1674/1799] Update ARM64 exception handling documentation Clarify the description of the floating-point predecrement behavior --- docs/build/arm64-exception-handling.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/arm64-exception-handling.md b/docs/build/arm64-exception-handling.md index 3742b4cef7b..1ff68237edf 100644 --- a/docs/build/arm64-exception-handling.md +++ b/docs/build/arm64-exception-handling.md @@ -401,7 +401,7 @@ Step 6: Allocate remaining stack, including local area, `` pair, and out \* If **CR** == 01 and **RegI** is an odd number, step 3 and the last `save_reg` in step 2 are merged into one `save_regp`. -\*\* If **RegI** == 0, **CR** != 01, and **RegF** != 0, the first `stp` for the floating-point does the predecrement (that is, it accounts for the FP/SIMD save area). +\*\* If **RegI** == 0, **CR** != 01, and **RegF** != 0, the first `stp` for the floating-point does the predecrement to allocate space for the FP/SIMD save area. \*\*\* No instruction corresponding to `mov x29,sp` is present in the epilog. Packed unwind data can't be used if a function requires restoration of `sp` from `x29`. From 5dca165413c231af257cd66a6daeef06d7738b50 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Fri, 27 Feb 2026 15:32:48 -0800 Subject: [PATCH 1675/1799] Update explanation for floating-point save area allocation Clarify the predecrement description --- docs/build/arm64-exception-handling.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build/arm64-exception-handling.md b/docs/build/arm64-exception-handling.md index 1ff68237edf..dc383c44181 100644 --- a/docs/build/arm64-exception-handling.md +++ b/docs/build/arm64-exception-handling.md @@ -401,7 +401,7 @@ Step 6: Allocate remaining stack, including local area, `` pair, and out \* If **CR** == 01 and **RegI** is an odd number, step 3 and the last `save_reg` in step 2 are merged into one `save_regp`. -\*\* If **RegI** == 0, **CR** != 01, and **RegF** != 0, the first `stp` for the floating-point does the predecrement to allocate space for the FP/SIMD save area. +\*\* If **RegI** == 0, **CR** != 01, and **RegF** != 0, the first `stp` for the floating-point does the predecrement to adjust sp to allocate space for the FP/SIMD save area. \*\*\* No instruction corresponding to `mov x29,sp` is present in the epilog. Packed unwind data can't be used if a function requires restoration of `sp` from `x29`. From 5802ffcc8743bcf622cc650d332cd0d0da19c05e Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Fri, 27 Feb 2026 16:23:06 -0800 Subject: [PATCH 1676/1799] edit pass: redistributing-microsoft-c++-files --- docs/windows/latest-supported-vc-redist.md | 6 +++--- docs/windows/redistributing-an-atl-application.md | 6 +++--- .../troubleshoot-vc-redistributable-installation-issues.md | 4 ++-- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 18bb356f080..d4a5991c943 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -63,7 +63,7 @@ Download other versions, including long-term servicing release channel versions, - Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Sign in by using a Visual Studio subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or to create a free account. select [No account? Create one!](https://my.visualstudio.com/). - The Visual C++ v14 Redistributable doesn't have separate packages for different languages. License terms for different languages are available at [Microsoft Software License Terms](https://aka.ms/VCRedistLicense). -- Visual Studio 2017 and later share the same redistributable files. Any apps built by Microsoft Visual C++ (MSVC) Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. The version of the Redistributable installed on the machine must be the same or later than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determine which dynamic-link-libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). +- Visual Studio 2017 and later share the same redistributable files. Any apps built by MSVC Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. The version of the Redistributable installed on the machine must be the same or later than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determine which dynamic-link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). - The latest version of the Visual C++ v14 Redistributable included with Visual Studio 2026 supports only the following operating systems: * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 @@ -76,14 +76,14 @@ When Visual Studio 2015 support ended, the v14 runtime was binary compatible wit ### Visual Studio 2015 (VC++ 14.0) (no longer supported) -To download the latest available version of Visual C++ Redistributable for Visual Studio 2015, see the [Visual Studio Subscriptions](https://my.visualstudio.com/) website. On the **Downloads** tab, search for **Visual C++ Redistributable for Visual Studio 2015**. +To download the latest available version of Visual C++ Redistributable for Visual Studio 2015, see the [Welcome to Dev Essentials](https://my.visualstudio.com/) page. On the **Downloads** tab, search for **Visual C++ Redistributable for Visual Studio 2015**. The latest version of Visual C++ Redistributable for Visual Studio 2015 is `14.0.24212.0` and is available for ARM64, X86, and X64 architectures. ### Visual Studio 2013 (VC++ 12.0) (no longer supported) These links download the latest available en-US Microsoft Visual C++ Redistributable Packages for Visual Studio 2013. -You can download other versions and languages from [Update for Visual C++ 2013 Redistributable Package](https://support.microsoft.com/topic/update-for-visual-c-2013-redistributable-package-d8ccd6a5-4e26-c290-517b-8da6cfdf4f10) or from the [Visual Studio Subscriptions](https://my.visualstudio.com/) website. +You can download other versions and languages from [Update for Visual C++ 2013 Redistributable Package](https://support.microsoft.com/topic/update-for-visual-c-2013-redistributable-package-d8ccd6a5-4e26-c290-517b-8da6cfdf4f10) or from the [Welcome to Dev Essentials](https://my.visualstudio.com/) page. | Architecture | Version | Link | | ------------ | :----------: | ------------------------------------------------------: | diff --git a/docs/windows/redistributing-an-atl-application.md b/docs/windows/redistributing-an-atl-application.md index a226fc8848b..17248946533 100644 --- a/docs/windows/redistributing-an-atl-application.md +++ b/docs/windows/redistributing-an-atl-application.md @@ -8,7 +8,7 @@ ms.topic: concept-article --- # Redistribute an ATL application -Starting in Visual Studio 2012, Active Template Library (ATL) is a header-only library. ATL projects don't have a dynamic link to an ATL option. No redistributable ATL library is required. +Beginning with Visual Studio 2012, Active Template Library (ATL) is a header-only library. ATL projects don't have a dynamic link to an ATL option. No redistributable ATL library is required. If you redistribute an ATL executable application, you must register the `.exe` file (and any controls inside it). Use the following command: @@ -16,7 +16,7 @@ If you redistribute an ATL executable application, you must register the `.exe` filename /regserver ``` -where `filename` is the name of the executable file. +Where `filename` is the name of the executable file. In Visual Studio 2010, you can build an ATL project for a `MinDependency` or a `MinSize` configuration: @@ -33,7 +33,7 @@ If you redistribute an ATL executable application, you must register the `.exe` filename /regserver ``` -where `filename` is the name of the executable file. +Where `filename` is the name of the executable file. ## Related content diff --git a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md index aaf81ea5b4a..f0f3195aff1 100644 --- a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md +++ b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md @@ -224,9 +224,9 @@ From the log files, make a note of the VC Redist version causing the issue. Two ## Download old versions of the Visual C++ Redistributable installer > [!WARNING] -> Never install a Visual C++ Redistributable installer that wasn't downloaded from a Microsoft site. Never install a Visual C++ Redistributable installer that isn't signed by Microsoft. +> Never install a Visual C++ Redistributable installer that wasn't downloaded from a Microsoft site. Never install a Visual C++ Redistributable installer that Microsoft didn't sign. -Download the VC Redist installer from [Welcome to Dev Essentials](https://my.visualstudio.com/Downloads) page. Search for Visual C++ Redistributable on the downloads page. +Download the VC Redist installer from the [Welcome to Dev Essentials](https://my.visualstudio.com/Downloads) page. Search for Visual C++ Redistributable on the downloads page. For the latest supported VC Redist version for each version of Visual Studio, see [Microsoft Redistributable Visual C++ latest supported downloads](/cpp/windows/latest-supported-vc-redist). From 7c5ddb9b018fd888e7a46260e1f557ed2911ddf3 Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Fri, 27 Feb 2026 16:53:21 -0800 Subject: [PATCH 1677/1799] edit pass: redistributing-microsoft-c++-files --- docs/windows/latest-supported-vc-redist.md | 7 +++++-- docs/windows/redistributing-the-mfc-library.md | 4 ++-- docs/windows/redistributing-visual-cpp-files.md | 4 +++- 3 files changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index d4a5991c943..88f43722b4e 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -63,12 +63,15 @@ Download other versions, including long-term servicing release channel versions, - Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Sign in by using a Visual Studio subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or to create a free account. select [No account? Create one!](https://my.visualstudio.com/). - The Visual C++ v14 Redistributable doesn't have separate packages for different languages. License terms for different languages are available at [Microsoft Software License Terms](https://aka.ms/VCRedistLicense). -- Visual Studio 2017 and later share the same redistributable files. Any apps built by MSVC Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. The version of the Redistributable installed on the machine must be the same or later than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determine which dynamic-link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). +- Visual Studio 2017 and later share the same redistributable files. Any apps built by MSVC Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. + + The version of the Redistributable installed on the machine must be the same or later than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determine which dynamic-link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). - The latest version of the Visual C++ v14 Redistributable included with Visual Studio 2026 supports only the following operating systems: * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 - Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. For the latest available version, see the [Visual Studio 2015 (Visual C++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section.
-When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built by using the Visual Studio 2015 MSVC Build Tools. Since Visual Studio 2015 is no longer supported, we recommend that you update your projects to use a supported MSVC Build Tools version and the latest v14 runtime. The Visual C++ Redistributable for 2017, and later, in-place upgrade the Visual C++ 2015 Redistributable (14.0.24212.0). Redistributables for 2013 and earlier remain installed side by side. + + When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built by using the Visual Studio 2015 MSVC Build Tools. Since Visual Studio 2015 is no longer supported, we recommend that you update your projects to use a supported MSVC Build Tools version and the latest v14 runtime. The Visual C++ Redistributable for 2017, and later, in-place upgrade the Visual C++ 2015 Redistributable (14.0.24212.0). Redistributables for 2013 and earlier remain installed side by side. - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). diff --git a/docs/windows/redistributing-the-mfc-library.md b/docs/windows/redistributing-the-mfc-library.md index 470fa794f85..324a3c400f6 100644 --- a/docs/windows/redistributing-the-mfc-library.md +++ b/docs/windows/redistributing-the-mfc-library.md @@ -20,7 +20,7 @@ For information on how to redistribute the Universal CRT as an operating system You can find redistributable architecture-specific versions of `ucrtbase.dll` for local deployment in the Windows SDK. By default, Visual Studio installs these versions in `C:\Program Files (x86)\Windows Kits\10\Redist\ucrt\DLLs\` in an architecture-specific subdirectory. -If your app is built by using an earlier version of the MFC Library, you must redistribute the matching CRT DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the `msvcr120.dll`. You also have to redistribute the matching `mfc``u.dll` or `mfc``.dll`. +If your app is built by using an earlier version of the MFC Library, you must redistribute the matching CRT DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the `msvcr120.dll`. You also have to redistribute the matching `mfcu.dll` or `mfc.dll`. If you statically link your application to MFC (in the **Property Pages** dialog, on the **General** tab, select **Use MFC in a Static Library**), you don't have to redistribute an MFC DLL. Although static linking might work for testing and internal deployment of applications, we recommend that you don't use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choose a deployment method](choosing-a-deployment-method.md). @@ -36,7 +36,7 @@ You can redistribute MFC by using either `VCRedist_*architecture*.exe` or merge ## Installation of localized MFC components -If you decide to localize your application by installing an MFC localization DLL, you must use the redistributable merge files (`.msm`). For example, if you want to localize your application on an x86 computer, you must merge `Microsoft_VC``_MFCLOC_x86.msm` into the installation package for an x86 computer. +If you decide to localize your application by installing an MFC localization DLL, you must use the redistributable merge files (`.msm`). For example, if you want to localize your application on an x86 computer, you must merge `Microsoft_VC_MFCLOC_x86.msm` into the installation package for an x86 computer. The redistributable `.msm` files contain the DLLs that are used for localization. There's one DLL for each supported language. The installation process installs these DLLs in the `%windir%\system32\` folder on the target computer. diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 7e802ee221e..0cc082395f7 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -48,7 +48,9 @@ To deploy redistributable files, you can use the redistributable packages instal The easiest way to locate the redistributable files is by using environment variables set in a developer command prompt. In Visual Studio 2022, the redistributable files are in the `%VCINSTALLDIR%Redist\MSVC\v143` folder. In the latest version of Visual Studio 2019, you can find the redistributable files in the `%VCINSTALLDIR%Redist\MSVC\v142` folder. In both Visual Studio 2017 and Visual Studio 2019, the files are also found in `%VCToolsRedistDir%`. In Visual Studio 2015, you can find these files in `%VCINSTALLDIR%redist\`, where `` is the locale of the redistributable packages. -In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named Visual C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When they're installed in Visual Studio 2022, you can find the redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. In the latest version of Visual Studio 2019, the redistributable merge modules are found in `%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`. In both Visual Studio 2019 and Visual Studio 2017, they're also found in `%VCToolsRedistDir%MergeModules`. In Visual Studio 2015, they're found in `Program Files [(x86)]\Common Files\Merge Modules`. +In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named Visual C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When they're installed in Visual Studio 2022, you can find the redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. + +In the latest version of Visual Studio 2019, the redistributable merge modules are found in `%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`. In both Visual Studio 2019 and Visual Studio 2017, they're also found in `%VCToolsRedistDir%MergeModules`. In Visual Studio 2015, they're found in `Program Files [(x86)]\Common Files\Merge Modules`. ## Install the redistributable packages From b3d455742cafd203c5c68ab0cab25002e65bf1b8 Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Fri, 27 Feb 2026 17:04:59 -0800 Subject: [PATCH 1678/1799] edit pass: redistributing-microsoft-c++-files --- docs/windows/redistributing-the-mfc-library.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/windows/redistributing-the-mfc-library.md b/docs/windows/redistributing-the-mfc-library.md index 324a3c400f6..35a09bf7b97 100644 --- a/docs/windows/redistributing-the-mfc-library.md +++ b/docs/windows/redistributing-the-mfc-library.md @@ -14,7 +14,7 @@ If you dynamically link your application to the Microsoft Foundation Class (MFC) > [!NOTE] > The `mfc140.dll` files were omitted from the redistributable files directory in Visual Studio 2015 RTM. You can use the versions installed by Visual Studio 2015 in the `Windows\system32 and Windows\syswow64` directories instead. -Because all MFC DLLs use the shared version of the Microsoft C Runtime Library (CRT), you might also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the Universal CRT Library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. +Because all MFC DLLs use the shared version of the Microsoft C Runtime (CRT) Library, you might also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the Universal CRT Library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. For information on how to redistribute the Universal CRT as an operating system component or by using local deployment, see [Introducing the Universal CRT](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the Universal CRT for central deployment on supported versions of Windows, see [Windows 10 Universal C Runtime](https://www.microsoft.com/download/details.aspx?id=48234). From eb03e20193249c8f43eed39a9864ef5be89f6472 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 27 Feb 2026 17:34:35 -0800 Subject: [PATCH 1679/1799] add info about which directive to use --- docs/cpp/attributes.md | 20 ++++++++++++++------ docs/preprocessor/warning.md | 10 +++++++++- 2 files changed, 23 insertions(+), 7 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 9a45ef04e6f..2ed22d9e6e1 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -79,9 +79,11 @@ The `[[noreturn]]` attribute specifies that a function never returns; in other w ### `[[gsl::suppress( [, justification: ])]]` -`` is a string that specifies the name of the rule to suppress. The optional `justification` field allows you to explain why a warning is being disabled or suppressed. This value will appear in the SARIF output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. The `[[gsl::suppress]]` attribute is available in Visual Studio 2022 version 17.14 and later versions. +This Microsoft-specific attribute, introduced in Visual Studio 2022 version 17.14, suppresses warnings from checkers that enforce [Guidelines Support Library (GSL)](https://github.com/Microsoft/GSL) rules in code. The attribute can be applied to a statement, a block, or a declaration. -The Microsoft-specific `[[gsl::suppress]]` attribute is used to suppress warnings from checkers that enforce [Guidelines Support Library (GSL)](https://github.com/Microsoft/GSL) rules in code. For example, consider this code snippet: +`` is a string that specifies the name of the rule to suppress. The optional `justification` field allows you to explain why a warning is being disabled or suppressed. This value will appear in the SARIF output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. + +Example: ```cpp int main() @@ -96,15 +98,21 @@ int main() } ``` -The example raises these warnings: +This example raises these warnings: - [C26494](../code-quality/c26494.md) (Type Rule 5: Always initialize an object.) - - [C26485](../code-quality/c26485.md) (Bounds Rule 3: No array to pointer decay.) - - [C26481](../code-quality/c26481.md) (Bounds Rule 1: Don't use pointer arithmetic. Use span instead.) -The first two warnings fire when you compile this code with the CppCoreCheck code analysis tool installed and activated. But the third warning doesn't fire because of the attribute. You can suppress the entire bounds profile by writing `[[gsl::suppress("bounds")]]` without including a specific rule number. The C++ Core Guidelines are designed to help you write better and safer code. The suppress attribute makes it easy to turn off the warnings when they aren't wanted. +The first two warnings occur when you compile this code with the CppCoreCheck code analysis tool installed and activated. But the third warning doesn't fire because of the attribute. You can suppress the entire bounds profile by writing `[[gsl::suppress("bounds")]]` without including a specific rule number. The C++ Core Guidelines are designed to help you write better and safer code. The suppress attribute makes it easy to turn off the warnings when they aren't wanted. + +**Choosing between `#pragma warning` and `[[gsl::suppress]]`** + +Both `#pragma warning(suppress)` and `[[gsl::suppress]]` offer fine-grained control over warning suppression: +- `[[gsl::suppress]]` only suppresses warnings emitted by Microsoft C++ Code Analysis. Use it with the C++ Core Guidelines checks which can be applied to a scope or a specific declaration. +- `#pragma warning(suppress)` can be used for any compiler warning. It’s particularly useful when you need to suppress a warning in a specific code block without altering the code’s structure significantly. + +Whenever possible, we recommend using `[[gsl::suppress]]` for suppressing Microsoft C++ Code Analysis warnings. ### `[[msvc::flatten]]` diff --git a/docs/preprocessor/warning.md b/docs/preprocessor/warning.md index 8d6d994f0ad..6c647e34e09 100644 --- a/docs/preprocessor/warning.md +++ b/docs/preprocessor/warning.md @@ -114,8 +114,16 @@ When you write header files, you can use `push` and `pop` to guarantee that warn #pragma warning( pop ) ``` +**Choosing between `#pragma warning` and `[[gsl::suppress]]`** + +Both `#pragma warning(suppress)` and `[[gsl::suppress]]` offer fine-grained control over warning suppression: +- `[[gsl::suppress]]` only suppresses warnings emitted by Microsoft C++ Code Analysis. Use it with the C++ Core Guidelines checks which can be applied to a scope or a specific declaration. +- `#pragma warning(suppress)` can be used for any compiler warning. It’s particularly useful when you need to suppress a warning in a specific code block without altering the code’s structure significantly. + +Whenever possible, we recommend using [`[[gsl::suppress]]`](../cpp/attributes.md#gslsuppresstag--justification-narrow-string-literal) for suppressing Microsoft C++ Code Analysis warnings. + For more information about compiler options that help you suppress warnings, see [`/FI`](../build/reference/fi-name-forced-include-file.md) and [`/w`](../build/reference/compiler-option-warning-level.md). ## See also -[Pragma directives and the `__pragma` and `_Pragma` keywords](./pragma-directives-and-the-pragma-keyword.md) +[Pragma directives and the `__pragma` and `_Pragma` keywords](./pragma-directives-and-the-pragma-keyword.md) \ No newline at end of file From bc2681feacdb6ca79fcf190c385d3665a0fe8e20 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 27 Feb 2026 18:02:01 -0800 Subject: [PATCH 1680/1799] add info about SARIF --- docs/cpp/attributes.md | 2 +- docs/preprocessor/warning.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 2ed22d9e6e1..1792c65fc67 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -81,7 +81,7 @@ The `[[noreturn]]` attribute specifies that a function never returns; in other w This Microsoft-specific attribute, introduced in Visual Studio 2022 version 17.14, suppresses warnings from checkers that enforce [Guidelines Support Library (GSL)](https://github.com/Microsoft/GSL) rules in code. The attribute can be applied to a statement, a block, or a declaration. -`` is a string that specifies the name of the rule to suppress. The optional `justification` field allows you to explain why a warning is being disabled or suppressed. This value will appear in the SARIF output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. +`` is a string that specifies the name of the rule to suppress. The optional `justification` field allows you to explain why a warning is being disabled or suppressed. This value will appear in the Static Analysis Results Interchange Format ([SARIF](https://sarif.info/)) output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. To generate a SARIF file, use the `/analyze:log:format:sarif` compiler option. Example: diff --git a/docs/preprocessor/warning.md b/docs/preprocessor/warning.md index 6c647e34e09..965301e3e93 100644 --- a/docs/preprocessor/warning.md +++ b/docs/preprocessor/warning.md @@ -44,7 +44,7 @@ However, when the **`justification`** field is present, only one warning number ``` The **`justification`** fields allows you to explain why a warning is being disable or -suppressed. The **`justification`** field is only supported for the **`disable`** and **`suppress`** *`warning-specifier`*. This value will appear in the SARIF output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. +suppressed. The **`justification`** field is only supported for the **`disable`** and **`suppress`** *`warning-specifier`*. This value will appear in the Static Analysis Results Interchange Format ([SARIF](https://sarif.info/)) output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. To generate a SARIF file, use the `/analyze:log:format:sarif` compiler option. This directive is functionally equivalent to the following code: From 754b414cf25c98db87a24bf9967a889de8bfb339 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 27 Feb 2026 18:09:26 -0800 Subject: [PATCH 1681/1799] edits --- docs/cpp/attributes.md | 2 +- docs/preprocessor/warning.md | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 1792c65fc67..08eac4cfefb 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -79,7 +79,7 @@ The `[[noreturn]]` attribute specifies that a function never returns; in other w ### `[[gsl::suppress( [, justification: ])]]` -This Microsoft-specific attribute, introduced in Visual Studio 2022 version 17.14, suppresses warnings from checkers that enforce [Guidelines Support Library (GSL)](https://github.com/Microsoft/GSL) rules in code. The attribute can be applied to a statement, a block, or a declaration. +This Microsoft-specific attribute, introduced in Visual Studio 2022 version 17.14, suppresses warnings from checkers that enforce [Guidelines Support Library (GSL)](https://github.com/Microsoft/GSL) rules. The attribute can be applied to a statement, a block, or a declaration. It's only available for C++. For C code, use [`#pragma warning(suppress)`](../preprocessor/warning.md) instead. `` is a string that specifies the name of the rule to suppress. The optional `justification` field allows you to explain why a warning is being disabled or suppressed. This value will appear in the Static Analysis Results Interchange Format ([SARIF](https://sarif.info/)) output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. To generate a SARIF file, use the `/analyze:log:format:sarif` compiler option. diff --git a/docs/preprocessor/warning.md b/docs/preprocessor/warning.md index 965301e3e93..bf27aa6d461 100644 --- a/docs/preprocessor/warning.md +++ b/docs/preprocessor/warning.md @@ -29,7 +29,8 @@ The following warning-specifier parameters are available. | `disable` | Don't issue the specified warning messages. The optional **`justification`** property is allowed. | | `error` | Report the specified warnings as errors. | | `once` | Display the specified message(s) only one time. | -| `suppress` | Pushes the current state of the pragma on the stack, disables the specified warning for the next line, and then pops the warning stack so that the pragma state is reset. The optional **`justification`** property is allowed. | +| `suppress` | Pushes the current state of the pragma on the stack, disables the specified warning for the next line, and then pops the warning stack so that the pragma state is reset. | +| **`justification`** is optional and was introduced in Visual Studio 2022 version 17.14. | The following code statement illustrates that a *`warning-number-list`* parameter can contain multiple warning numbers, and that multiple *`warning-specifier`* parameters can be specified in the same pragma directive. @@ -43,7 +44,7 @@ However, when the **`justification`** field is present, only one warning number #pragma warning( disable : 4507, justification : "This warning is disabled" ) ``` -The **`justification`** fields allows you to explain why a warning is being disable or +The **`justification`** fields allows you to explain why a warning is being disabled or suppressed. The **`justification`** field is only supported for the **`disable`** and **`suppress`** *`warning-specifier`*. This value will appear in the Static Analysis Results Interchange Format ([SARIF](https://sarif.info/)) output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. To generate a SARIF file, use the `/analyze:log:format:sarif` compiler option. This directive is functionally equivalent to the following code: From b509f4b96eeb29c0ef8df54c1b5b63bcc4367b9f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 27 Feb 2026 18:16:47 -0800 Subject: [PATCH 1682/1799] Acrolinx --- docs/cpp/attributes.md | 14 +++++++------- docs/preprocessor/warning.md | 8 ++++---- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 08eac4cfefb..d52e5575048 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -46,7 +46,7 @@ The `[[carries_dependency]]` attribute specifies that the function propagates da ### `[[likely]]` -**Visual Studio 2019 version 16.6 and later:** (Available with [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) and later.) The `[[likely]]` attribute specifies a hint to the compiler that the code path for the attributed label or statement is more likely to execute than alternatives. In the Microsoft compiler, the `[[likely]]` attribute marks blocks as "hot code", which increments an internal optimization score. The score is incremented more when optimizing for speed, and not as much when optimizing for size. The net score affects the likelihood of inlining, loop unrolling, and vectorizing optimizations. The effect of `[[likely]]` and `[[unlikely]]` is similar to [Profile-guided optimization](../build/profile-guided-optimizations.md), but limited in scope to the current translation unit. The block reordering optimization isn't implemented yet for this attribute. +**Visual Studio 2019 version 16.6 and later:** (Available with [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) and later.) The `[[likely]]` attribute specifies a hint to the compiler that the code path for the attributed label or statement is more likely to execute than alternatives. In the Microsoft compiler, the `[[likely]]` attribute marks blocks as "hot code," which increments an internal optimization score. The score is incremented more when optimizing for speed, and not as much when optimizing for size. The net score affects the likelihood of inlining, loop unrolling, and vectorizing optimizations. The effect of `[[likely]]` and `[[unlikely]]` is similar to [Profile-guided optimization](../build/profile-guided-optimizations.md), but limited in scope to the current translation unit. The block reordering optimization isn't implemented yet for this attribute. ### `[[maybe_unused]]` @@ -81,7 +81,7 @@ The `[[noreturn]]` attribute specifies that a function never returns; in other w This Microsoft-specific attribute, introduced in Visual Studio 2022 version 17.14, suppresses warnings from checkers that enforce [Guidelines Support Library (GSL)](https://github.com/Microsoft/GSL) rules. The attribute can be applied to a statement, a block, or a declaration. It's only available for C++. For C code, use [`#pragma warning(suppress)`](../preprocessor/warning.md) instead. -`` is a string that specifies the name of the rule to suppress. The optional `justification` field allows you to explain why a warning is being disabled or suppressed. This value will appear in the Static Analysis Results Interchange Format ([SARIF](https://sarif.info/)) output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. To generate a SARIF file, use the `/analyze:log:format:sarif` compiler option. +`` is a string that specifies the name of the rule to suppress. The optional `justification` field allows you to explain why a warning is being disabled or suppressed. This value appears in the Static Analysis Results Interchange Format ([SARIF](https://sarif.info/)) output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. To generate a SARIF file, use the `/analyze:log:format:sarif` compiler option. Example: @@ -109,14 +109,14 @@ The first two warnings occur when you compile this code with the CppCoreCheck co **Choosing between `#pragma warning` and `[[gsl::suppress]]`** Both `#pragma warning(suppress)` and `[[gsl::suppress]]` offer fine-grained control over warning suppression: -- `[[gsl::suppress]]` only suppresses warnings emitted by Microsoft C++ Code Analysis. Use it with the C++ Core Guidelines checks which can be applied to a scope or a specific declaration. -- `#pragma warning(suppress)` can be used for any compiler warning. It’s particularly useful when you need to suppress a warning in a specific code block without altering the code’s structure significantly. +- `[[gsl::suppress]]` only suppresses warnings emitted by Microsoft C++ Code Analysis. Use it with the C++ Core Guidelines checks, which can be applied to a scope or a specific declaration. +- `#pragma warning(suppress)` can be used for any compiler warning. It’s useful when you need to suppress a warning in a specific code block without altering the code’s structure significantly. Whenever possible, we recommend using `[[gsl::suppress]]` for suppressing Microsoft C++ Code Analysis warnings. ### `[[msvc::flatten]]` -The Microsoft-specific attribute `[[msvc::flatten]]` is very similar to `[[msvc::forceinline_calls]]`, and can be used in the same places and in the same way. The difference is that `[[msvc::flatten]]` will `[[msvc::forceinline_calls]]` all calls in the scope it's applied to recursively, until no calls are left. This may have consequences for the resulting code size growth of the function or the throughput of the compiler, which you must manage manually. +The Microsoft-specific attribute `[[msvc::flatten]]` is similar to `[[msvc::forceinline_calls]]`, and can be used in the same places and in the same way. The difference is that `[[msvc::flatten]]` will `[[msvc::forceinline_calls]]` all calls in the scope it's applied to recursively, until no calls are left. This may have consequences for the resulting code size growth of the function or the throughput of the compiler, which you must manage manually. ### `[[msvc::forceinline]]` @@ -176,12 +176,12 @@ The `[[msvc::musttail]]` attribute, introduced in [MSVC Build Tools version 14.5 - The calling conventions must be compatible. - The tail call must be the final action in the calling function. - The callee can't use more stack space than the calling function. -- If more than four integer parameters are passed, the calling function must allocate enough stack space for those additional arguments. +- If more than four integer parameters are passed, the calling function must allocate enough stack space for the other arguments. - Compile with `/O2` or `/O2 /GL` optimization level. #### Example -Tail calls are a compiler optimization that is possible when a function call is the last action performed before returning. Instead of creating a new stack frame to call the function, the current function's stack frame is reused. This reduces stack usage and improves performance—especially in recursive scenarios. +Tail calls are a compiler optimization that's possible when a function call is the last action performed before returning. Instead of creating a new stack frame to call the function, the current function's stack frame is reused. This reduces stack usage and improves performance—especially in recursive scenarios. In the following code, the `[[msvc::musttail]]` attribute applied to `return increment(x)` causes control to transfer directly to `increment`. When `increment` reaches the `return x+1;` statement, its result is provided directly to the caller of `incrementIfPositive`, that is `main`. This replaces inlining `increment` into `incrementIfPositive` or calling `increment` from `incrementIfPositive` and returning to `incrementIfPositive` before returning to `main`. The tail call optimization eliminates the need for `incrementIfPositive` to regain control after `increment` finishes. This is a performance optimization that reduces stack usage, especially useful in recursive scenarios. diff --git a/docs/preprocessor/warning.md b/docs/preprocessor/warning.md index bf27aa6d461..995801d066b 100644 --- a/docs/preprocessor/warning.md +++ b/docs/preprocessor/warning.md @@ -44,8 +44,8 @@ However, when the **`justification`** field is present, only one warning number #pragma warning( disable : 4507, justification : "This warning is disabled" ) ``` -The **`justification`** fields allows you to explain why a warning is being disabled or -suppressed. The **`justification`** field is only supported for the **`disable`** and **`suppress`** *`warning-specifier`*. This value will appear in the Static Analysis Results Interchange Format ([SARIF](https://sarif.info/)) output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. To generate a SARIF file, use the `/analyze:log:format:sarif` compiler option. +Use the **`justification`** field to explain why a warning is being disabled or +suppressed. The **`justification`** field is only supported for the **`disable`** and **`suppress`** *`warning-specifier`*. The justification appears in the Static Analysis Results Interchange Format ([SARIF](https://sarif.info/)) output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. To generate a SARIF file, use the `/analyze:log:format:sarif` compiler option. This directive is functionally equivalent to the following code: @@ -118,8 +118,8 @@ When you write header files, you can use `push` and `pop` to guarantee that warn **Choosing between `#pragma warning` and `[[gsl::suppress]]`** Both `#pragma warning(suppress)` and `[[gsl::suppress]]` offer fine-grained control over warning suppression: -- `[[gsl::suppress]]` only suppresses warnings emitted by Microsoft C++ Code Analysis. Use it with the C++ Core Guidelines checks which can be applied to a scope or a specific declaration. -- `#pragma warning(suppress)` can be used for any compiler warning. It’s particularly useful when you need to suppress a warning in a specific code block without altering the code’s structure significantly. +- `[[gsl::suppress]]` only suppresses warnings emitted by Microsoft C++ Code Analysis. Use it with the C++ Core Guidelines checks, which can be applied to a scope or a specific declaration. +- `#pragma warning(suppress)` can be used for any compiler warning. It’s useful when you need to suppress a warning in a specific code block without altering the code’s structure significantly. Whenever possible, we recommend using [`[[gsl::suppress]]`](../cpp/attributes.md#gslsuppresstag--justification-narrow-string-literal) for suppressing Microsoft C++ Code Analysis warnings. From 798895c3379882a8da75af67445a4c00132bf746 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 27 Feb 2026 18:44:22 -0800 Subject: [PATCH 1683/1799] edits --- docs/cpp/attributes.md | 2 +- docs/preprocessor/warning.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index d52e5575048..84be79ffc4b 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -112,7 +112,7 @@ Both `#pragma warning(suppress)` and `[[gsl::suppress]]` offer fine-grained cont - `[[gsl::suppress]]` only suppresses warnings emitted by Microsoft C++ Code Analysis. Use it with the C++ Core Guidelines checks, which can be applied to a scope or a specific declaration. - `#pragma warning(suppress)` can be used for any compiler warning. It’s useful when you need to suppress a warning in a specific code block without altering the code’s structure significantly. -Whenever possible, we recommend using `[[gsl::suppress]]` for suppressing Microsoft C++ Code Analysis warnings. +Whenever possible, use `[[gsl::suppress]]` for suppressing Microsoft C++ Code Analysis warnings. ### `[[msvc::flatten]]` diff --git a/docs/preprocessor/warning.md b/docs/preprocessor/warning.md index 995801d066b..4a731996c3e 100644 --- a/docs/preprocessor/warning.md +++ b/docs/preprocessor/warning.md @@ -30,7 +30,7 @@ The following warning-specifier parameters are available. | `error` | Report the specified warnings as errors. | | `once` | Display the specified message(s) only one time. | | `suppress` | Pushes the current state of the pragma on the stack, disables the specified warning for the next line, and then pops the warning stack so that the pragma state is reset. | -| **`justification`** is optional and was introduced in Visual Studio 2022 version 17.14. | +| `justification` | Optional string describing the reason for disabling or suppressing the warning. Introduced in Visual Studio 2022 version 17.14. | The following code statement illustrates that a *`warning-number-list`* parameter can contain multiple warning numbers, and that multiple *`warning-specifier`* parameters can be specified in the same pragma directive. @@ -121,10 +121,10 @@ Both `#pragma warning(suppress)` and `[[gsl::suppress]]` offer fine-grained cont - `[[gsl::suppress]]` only suppresses warnings emitted by Microsoft C++ Code Analysis. Use it with the C++ Core Guidelines checks, which can be applied to a scope or a specific declaration. - `#pragma warning(suppress)` can be used for any compiler warning. It’s useful when you need to suppress a warning in a specific code block without altering the code’s structure significantly. -Whenever possible, we recommend using [`[[gsl::suppress]]`](../cpp/attributes.md#gslsuppresstag--justification-narrow-string-literal) for suppressing Microsoft C++ Code Analysis warnings. +Whenever possible, use [`[[gsl::suppress]]`](../cpp/attributes.md#gslsuppresstag--justification-narrow-string-literal) for suppressing Microsoft C++ Code Analysis warnings. For more information about compiler options that help you suppress warnings, see [`/FI`](../build/reference/fi-name-forced-include-file.md) and [`/w`](../build/reference/compiler-option-warning-level.md). ## See also -[Pragma directives and the `__pragma` and `_Pragma` keywords](./pragma-directives-and-the-pragma-keyword.md) \ No newline at end of file +[Pragma directives and the `__pragma` and `_Pragma` keywords](pragma-directives-and-the-pragma-keyword.md) \ No newline at end of file From 8eacd332b24ae3bf6d80b2eb39240f4c1b4f33ed Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Wed, 4 Mar 2026 11:27:01 -0800 Subject: [PATCH 1684/1799] edit pass: redistributing-microsoft-c++-files --- docs/windows/latest-supported-vc-redist.md | 2 +- docs/windows/redist-version-auditing.md | 4 ++-- docs/windows/redistributing-the-mfc-library.md | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 88f43722b4e..a70485b2089 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -57,7 +57,7 @@ Unlike older versions of Visual Studio that have infrequent redistributable upda | X86 | [https://aka.ms/vc14/vc_redist.x86.exe](https://aka.ms/vc14/vc_redist.x86.exe) | Permalink for latest supported x86 version. | | X64 | [https://aka.ms/vc14/vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable Package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | -Download other versions, including long-term servicing release channel versions, from [my.visualstudio.com](https://my.visualstudio.com/). +Download other versions, including long-term servicing channel (LTSC) versions, from [my.visualstudio.com](https://my.visualstudio.com/). ### Notes diff --git a/docs/windows/redist-version-auditing.md b/docs/windows/redist-version-auditing.md index b48363f1375..909849f681a 100644 --- a/docs/windows/redist-version-auditing.md +++ b/docs/windows/redist-version-auditing.md @@ -26,7 +26,7 @@ This article provides the steps to manually enable NTFS file auditing and review Object access must be enabled before you enable file-level auditing: -1. Select **Windows**+**R** to open the **Run** dialog. Then enter **gpedit.msc** and select **Enter** to open **Local Group Policy Editor**. +1. Select **Windows**+**R** to open the **Run** dialog. Then enter `gpedit.msc` and select **Enter** to open **Local Group Policy Editor**. 1. Go to **Computer Configuration** > **Windows Settings** > **Security Settings** > **Advanced Audit Policy Configuration** > **System Audit Policies** > **Object Access**. 1. Double-click **Audit File System**. In the **Audit File System Properties** dialog, select **Configure the following audit events** > **Success** > **OK**. 1. Close **Local Group Policy Editor**. @@ -55,7 +55,7 @@ The audit rule is now enabled for the file. NTFS file auditing generates [Event 4663: An attempt was made to access an object](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663) for each file that includes the audit permission and is accessed by a process. -1. Select **Windows**+**R** to open the **Run** dialog. Then enter **eventvwr.msc** and select **Enter** to open **Event Viewer**. +1. Select **Windows**+**R** to open the **Run** dialog. Then enter `eventvwr.msc` and select **Enter** to open **Event Viewer**. 1. Go to the **Security** logs in the **Event Viewer** by expanding **Windows Logs** > **Security**. The results pane lists security events. 1. Find the audit events by choosing **Filter Current Log...** in the **Actions** pane. To narrow down the events to **Event ID 4663 (Audit Success for the File System Category)**, enter **4663** in the **Includes/Excludes Event IDs** text box. diff --git a/docs/windows/redistributing-the-mfc-library.md b/docs/windows/redistributing-the-mfc-library.md index 35a09bf7b97..b069e2558c4 100644 --- a/docs/windows/redistributing-the-mfc-library.md +++ b/docs/windows/redistributing-the-mfc-library.md @@ -24,13 +24,13 @@ If your app is built by using an earlier version of the MFC Library, you must re If you statically link your application to MFC (in the **Property Pages** dialog, on the **General** tab, select **Use MFC in a Static Library**), you don't have to redistribute an MFC DLL. Although static linking might work for testing and internal deployment of applications, we recommend that you don't use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choose a deployment method](choosing-a-deployment-method.md). -If your application uses the MFC classes that implement the WebBrowser control (for example, [CHtmlView class](../mfc/reference/chtmlview-class.md) or [CHtmlEditView class](../mfc/reference/chtmleditview-class.md)), we recommend that you also install the most current version of Internet Explorer so that the target computer has the most current common control files. (At a minimum, Internet Explorer 4.0 is required.) Information about how to install Internet Explorer components is available in "Article 185375: How to Create a Single EXE Install of Internet Explorer" on the Microsoft Support website. +If your application uses the MFC classes that implement the WebBrowser control (for example, [CHtmlView class](../mfc/reference/chtmlview-class.md) or [CHtmlEditView class](../mfc/reference/chtmleditview-class.md)), we recommend that you also install the most current version of Internet Explorer so that the target computer has the most current common control files. (At a minimum, Internet Explorer 4.0 is required.) Information about how to install Internet Explorer components is available in [Article 185375: How to Create a Single EXE Install of Internet Explorer](https://helparchive.huntertur.net/document/95742). If your application uses the MFC database classes (for example, [CRecordset class](../mfc/reference/crecordset-class.md) and [CRecordView class](../mfc/reference/crecordview-class.md)), you must redistribute Open Database Connectivity (ODBC) and any ODBC drivers that your application uses. If your MFC application uses Windows Forms controls, you must redistribute `mfcmifc80.dll` with your application. This DLL is a strong-name-signed .NET assembly. You can redistribute it with an application in its application local folder. You can also deploy it to the Global Assembly Cache (GAC) by using the [Gacutil.exe (Global Assembly Cache Tool)](/dotnet/framework/tools/gacutil-exe-gac-tool). -If you redistribute an MFC DLL, make sure to redistribute the retail version and not the debug version. Debug versions of the DLLs aren't redistributable. The names of debug versions of the MFC DLLs end with a "d," for example, `Mfc140d.dll`. +If you redistribute an MFC DLL, make sure to redistribute the retail version and not the debug version. Debug versions of the DLLs aren't redistributable. The names of debug versions of the MFC DLLs end with a "d", for example, `Mfc140d.dll`. You can redistribute MFC by using either `VCRedist_*architecture*.exe` or merge modules that are installed with Visual Studio. You can also deploy the MFC DLL to the same folder as your application. For more information about how to redistribute MFC, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). From cb62204dee003d096b51f86c17e916a0200b4304 Mon Sep 17 00:00:00 2001 From: "Michael B. Price" Date: Thu, 5 Mar 2026 08:45:43 -0600 Subject: [PATCH 1685/1799] Implementing the branding changes for the Copilot modernization feature, which drops the 'app' portion of the name. --- ...on-cpp.md => copilot-modernization-cpp.md} | 30 +++++++++--------- ...=> copilot-modernization-context-menu.png} | Bin ...g => enable-copilot-modernization-cpp.png} | Bin ...ng => modernization-cmake-ice-breaker.png} | Bin ... => modernization-msbuild-ice-breaker.png} | Bin docs/porting/toc.yml | 4 +-- .../visual-cpp-porting-and-upgrading-guide.md | 2 +- 7 files changed, 18 insertions(+), 18 deletions(-) rename docs/porting/{copilot-app-modernization-cpp.md => copilot-modernization-cpp.md} (65%) rename docs/porting/media/{copilot-app-modernization-context-menu.png => copilot-modernization-context-menu.png} (100%) rename docs/porting/media/{enable-copilot-app-modernization-cpp.png => enable-copilot-modernization-cpp.png} (100%) rename docs/porting/media/{app-modernization-cmake-ice-breaker.png => modernization-cmake-ice-breaker.png} (100%) rename docs/porting/media/{app-modernization-msbuild-ice-breaker.png => modernization-msbuild-ice-breaker.png} (100%) diff --git a/docs/porting/copilot-app-modernization-cpp.md b/docs/porting/copilot-modernization-cpp.md similarity index 65% rename from docs/porting/copilot-app-modernization-cpp.md rename to docs/porting/copilot-modernization-cpp.md index 9d8ab2b609b..aed4b2a0eac 100644 --- a/docs/porting/copilot-app-modernization-cpp.md +++ b/docs/porting/copilot-modernization-cpp.md @@ -1,7 +1,7 @@ --- -title: "Modernize your C++ project with GitHub Copilot app modernization" -description: "Instructions on effectively using GitHub Copilot app modernization in your C++ projects" -ms.date: 01/23/2026 +title: "Modernize your C++ project with GitHub Copilot modernization" +description: "Instructions on effectively using GitHub Copilot modernization in your C++ projects" +ms.date: 03/12/2026 ms.topic: upgrade-and-migration-article author: michaelbprice ms.author: miprice @@ -9,10 +9,10 @@ ms.author: miprice # Using GitHub Copilot app modernization for C++ -GitHub Copilot app modernization for C++ helps you upgrade C++ projects to newer MSVC Build Tools versions. If necessary, Copilot will upgrade your project's settings to use the latest MSVC, and then conduct a thorough assessment of the impact of those changes after executing a build. It develops a plan on how to address each identified problem. Once you approve the plan, the agent completes a sequence of tasks and validates that any changes resolved the identified problems. If there remains work to be done, the agent continues iterating until the problems are resolved or you discontinue the conversation. +GitHub Copilot modernization for C++ helps you upgrade C++ projects to newer MSVC Build Tools versions. If necessary, Copilot will upgrade your project's settings to use the latest MSVC, and then conduct a thorough assessment of the impact of those changes after executing a build. It develops a plan on how to address each identified problem. Once you approve the plan, the agent completes a sequence of tasks and validates that any changes resolved the identified problems. If there remains work to be done, the agent continues iterating until the problems are resolved or you discontinue the conversation. > [!NOTE] -> GitHub Copilot app modernization for C++ is currently in preview. +> GitHub Copilot modernization for C++ is currently in preview. ## Requirements @@ -20,28 +20,28 @@ GitHub Copilot app modernization for C++ helps you upgrade C++ projects to newer - A GitHub Copilot account - A MSBuild-based codebase (`.sln`, `.vcxproj`) OR a CMake-based codebase -## Enable GitHub Copilot app modernization for C++ +## Enable GitHub Copilot modernization for C++ -GitHub Copilot app modernization for C++ is enabled by default. To disable or explicitly enable the feature, follow these steps. +GitHub Copilot modernization for C++ is enabled by default. To disable or explicitly enable the feature, follow these steps. 1. From Visual Studio, select **Tools > Options...** to open the **Options** window. 1. Navigate to **All Settings > GitHub > Copilot > C/C++**. -1. Select (to enable) or clear (to disable) the checkbox for **Enable GitHub Copilot app modernization for C++ (preview)**. +1. Select (to enable) or clear (to disable) the checkbox for **Enable GitHub Copilot modernization for C++ (preview)**. 1. Restart Visual Studio for the setting change to take effect. -:::image type="content" source="media/enable-copilot-app-modernization-cpp.png" alt-text="Screenshot of Visual Studio Options dialog. GitHub > Copilot > C/C++ settings are visible. The app modernization for C++ checkbox is enabled."::: +:::image type="content" source="media/enable-copilot-modernization-cpp.png" alt-text="Screenshot of Visual Studio Options dialog. GitHub > Copilot > C/C++ settings are visible. The modernization for C++ checkbox is enabled."::: -## Upgrade your codebase by using GitHub Copilot app modernization for C++ +## Upgrade your codebase by using GitHub Copilot modernization for C++ This section describes how to start the Modernize agent and the stages it goes through to upgrade your codebase. ### Start the Modernize agent -GitHub Copilot app modernization is an agent that operates inside the GitHub Copilot Chat window. You can start the agent in any of the following ways: +GitHub Copilot modernization is an agent that operates inside the GitHub Copilot Chat window. You can start the agent in any of the following ways: - **From the Solution Explorer context menu**: Right-click on the solution or a loaded project in the Solution Explorer, and choose **Modernize** from the context menu. This automatically launches a GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. -:::image type="content" source="media/copilot-app-modernization-context-menu.png" alt-text="Screenshot of Visual Studio Solution Explorer showing a right-click context menu with Modernize selected to start the Copilot agent."::: +:::image type="content" source="media/copilot-modernization-context-menu.png" alt-text="Screenshot of Visual Studio Solution Explorer showing a right-click context menu with Modernize selected to start the Copilot agent."::: - **From GitHub Copilot Chat**: Open the GitHub Copilot Chat Window by selecting **View > GitHub Copilot Chat**. After the GitHub Copilot Chat window opens, mention `@Modernize` in a prompt to activate the Modernize agent. For example, type this prompt: @@ -49,7 +49,7 @@ GitHub Copilot app modernization is an agent that operates inside the GitHub Cop #### For MSBuild-based codebases targeting an earlier version of MSVC Build Tools -The first time that you load a `.vcxproj` project that targets an earlier version of the MSVC Build Tools, you see an option to [upgrade project settings to use a newer version of the MSVC Build Tools](/visualstudio/install/setup-assistant). If you retarget any of your projects to a new version of MSVC Build Tools and GitHub Copilot app modernization for C++ is enabled, you receive an infobar in Visual Studio prompting you to use GitHub Copilot app modernization for C++ to resolve any newly introduced build problems. Selecting **Run GitHub Copilot app modernization for C++** launches the GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. +The first time that you load a `.vcxproj` project that targets an earlier version of the MSVC Build Tools, you see an option to [upgrade project settings to use a newer version of the MSVC Build Tools](/visualstudio/install/setup-assistant). If you retarget any of your projects to a new version of MSVC Build Tools and GitHub Copilot app modernization for C++ is enabled, you receive an infobar in Visual Studio prompting you to use GitHub Copilot modernization for C++ to resolve any newly introduced build problems. Selecting **Run GitHub Copilot modernization for C++** launches the GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. ### Start the upgrade @@ -70,12 +70,12 @@ Once the Modernize agent is active, you can instruct it via a prompt to upgrade :::row::: :::column::: -:::image type="content" source="media/app-modernization-msbuild-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to App Modernization experience and Upgrade MSVC Build Tools to the latest version is highlighted."::: +:::image type="content" source="media/modernization-msbuild-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to Modernize experience and Upgrade MSVC Build Tools to the latest version is highlighted."::: :::column-end::: :::column::: -:::image type="content" source="media/app-modernization-cmake-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to App Modernization experience and Resolve build issues by migrating to modern alternatives is highlighted"::: +:::image type="content" source="media/modernization-cmake-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to Modernize experience and Resolve build issues by migrating to modern alternatives is highlighted"::: :::column-end::: :::row-end::: diff --git a/docs/porting/media/copilot-app-modernization-context-menu.png b/docs/porting/media/copilot-modernization-context-menu.png similarity index 100% rename from docs/porting/media/copilot-app-modernization-context-menu.png rename to docs/porting/media/copilot-modernization-context-menu.png diff --git a/docs/porting/media/enable-copilot-app-modernization-cpp.png b/docs/porting/media/enable-copilot-modernization-cpp.png similarity index 100% rename from docs/porting/media/enable-copilot-app-modernization-cpp.png rename to docs/porting/media/enable-copilot-modernization-cpp.png diff --git a/docs/porting/media/app-modernization-cmake-ice-breaker.png b/docs/porting/media/modernization-cmake-ice-breaker.png similarity index 100% rename from docs/porting/media/app-modernization-cmake-ice-breaker.png rename to docs/porting/media/modernization-cmake-ice-breaker.png diff --git a/docs/porting/media/app-modernization-msbuild-ice-breaker.png b/docs/porting/media/modernization-msbuild-ice-breaker.png similarity index 100% rename from docs/porting/media/app-modernization-msbuild-ice-breaker.png rename to docs/porting/media/modernization-msbuild-ice-breaker.png diff --git a/docs/porting/toc.yml b/docs/porting/toc.yml index 934a9ad9859..1c743b4bc3d 100644 --- a/docs/porting/toc.yml +++ b/docs/porting/toc.yml @@ -9,8 +9,8 @@ items: href: ../porting/overview-of-potential-upgrade-issues-visual-cpp.md - name: Upgrade your code to the Universal CRT href: ../porting/upgrade-your-code-to-the-universal-crt.md - - name: Modernize your C++ project with GitHub Copilot app modernization - href: ../porting/copilot-app-modernization-cpp.md + - name: Modernize your C++ project with GitHub Copilot modernization + href: ../porting/copilot-modernization-cpp.md - name: Update WINVER and _WIN32_WINNT href: ../porting/modifying-winver-and-win32-winnt.md - name: Fix your dependencies on library internals diff --git a/docs/porting/visual-cpp-porting-and-upgrading-guide.md b/docs/porting/visual-cpp-porting-and-upgrading-guide.md index 64aa8a53e5e..3035453a01a 100644 --- a/docs/porting/visual-cpp-porting-and-upgrading-guide.md +++ b/docs/porting/visual-cpp-porting-and-upgrading-guide.md @@ -61,7 +61,7 @@ ms.author: twhitney - [⬆️ Upgrading C++ Projects to Visual Studio 2026](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/) - [⬆️ Upgrade projects from earlier versions](upgrading-projects-from-earlier-versions-of-visual-cpp.md) -- [🤖 Upgrade with an AI agent (preview)](copilot-app-modernization-cpp.md) +- [🤖 Upgrade with an AI agent (preview)](copilot-modernization-cpp.md) - [🛠️ IDE tools for upgrading C++ code](ide-tools-for-upgrading-code.md) - [🔄 Upgrade to Universal CRT](upgrade-your-code-to-the-universal-crt.md) - [🔧 Update WINVER and _WIN32_WINNT](modifying-winver-and-win32-winnt.md) From 0ad07422acefa9b2aec755d606772d495f065a22 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 5 Mar 2026 14:33:00 -0800 Subject: [PATCH 1686/1799] Update C++ standard library header files documentation Removed the headers that we haven't implemented yet so that we don't convey the impression that they are in the product. --- .../cpp-standard-library-header-files.md | 21 +++++++++---------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index 0f56590a4ea..969be33da60 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -1,7 +1,7 @@ --- title: "C++ standard library header files" description: "C++ standard library header files, categorized" -ms.date: 06/22/2025 +ms.date: 03/05/2026 helpviewer_keywords: ["header files, C++ Standard Library", "C++ Standard Library, header files"] --- # C++ standard library header files @@ -18,25 +18,25 @@ Header files for the C++ standard library and extensions, by category. | Atomic operations | [``](atomic.md)11 | | C library wrappers | [``](cassert.md), [``](ccomplex.md)11 a b, [``](cctype.md), [``](cerrno.md), [``](cfenv.md)11, [``](cfloat.md), [``](cinttypes.md)11, [``](ciso646.md)b, [``](climits.md), [``](clocale.md), [``](cmath.md), [``](csetjmp.md), [``](csignal.md), [``](cstdalign.md)11 a b, [``](cstdarg.md), [``](cstdbool.md)11 a b, [``](cstddef.md), [``](cstdint.md)11, [``](cstdio.md), [``](cstdlib.md), [``](cstring.md), [``](ctgmath.md)11 a b, [``](ctime.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md) | | Concepts | ``20 | -| [Containers](stl-containers.md) | ``26 | -| Sequence containers | [``](array.md)11, [``](deque.md), [``](forward-list.md)11, ``26, [``](list.md), [``](vector.md) | +| [Containers](stl-containers.md) | | +| Sequence containers | [``](array.md)11, [``](deque.md), [``](forward-list.md)11, [``](list.md), [``](vector.md) | | Ordered associative containers| [``](map.md), [``](set.md) | | Unordered associative containers | [``](unordered-map.md)11, [``](unordered-set.md)11 | -| Container adaptors | ``23, ``23, [``](queue.md), [``](stack.md) | +| Container adaptors | [``](queue.md), [``](stack.md) | | Container views | ``23, [``](span.md)20 | -| Diagnostics | ``26, ``23 | +| Diagnostics | ``23 | | [Errors and exception handling](../cpp/errors-and-exception-handling-modern-cpp.md) | [``](cassert.md), [``](exception.md), [``](stdexcept.md), [``](system-error.md)11 | | General utilities | [``](any.md)17, [``](bit.md)20, [``](bitset.md), [``](cstdlib.md), [``](execution.md)17, ``23, [``](functional.md), [``](memory.md), [``](memory-resource.md)17, [``](optional.md)17, [``](ratio.md)11, [``](scoped-allocator.md)11, [``](tuple.md)11, [``](type-traits.md)11, [``](typeindex.md)11, [``](utility.md), [``](variant.md)17 | | [I/O and formatting](../text/string-and-i-o-formatting-modern-cpp.md) | [``](cinttypes.md)11, [``](cstdio.md), [``](filesystem.md)17, ``20, [``](fstream.md), [``](iomanip.md), [``](ios.md), [``](iosfwd.md), [``](iostream.md), [``](istream.md), [``](ostream.md), ``23, ``23, [``](sstream.md), [``](streambuf.md), [``](strstream.md)c, ``20 | | Iterators | [``](iterator.md) | -| Language support | [``](cfloat.md), [``](climits.md), [``](codecvt.md)11 a, ``20, ``26, ``20, [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstddef.md), [``](cstdint.md)11, [``](cstdlib.md), [``](exception.md), [``](initializer-list.md)11, [``](limits.md), [``](new.md), ``20, ``23, [``](typeinfo.md), ``20 | +| Language support | [``](cfloat.md), [``](climits.md), [``](codecvt.md)11 a, ``20, ``20, [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstddef.md), [``](cstdint.md)11, [``](cstdlib.md), [``](exception.md), [``](initializer-list.md)11, [``](limits.md), [``](new.md), ``20, ``23, [``](typeinfo.md), ``20 | | Localization | [``](clocale.md), [``](codecvt.md)11 a, [``](cvt-wbuffer.md), [``](cvt-wstring.md), [``](locale.md) | -| Math and numerics | [``](bit.md)20, [``](cfenv.md)11, [``](cmath.md), [``](complex.md), [``](cstdlib.md), [``](limits.md), ``26, ``20, [``](numeric.md), [``](random.md)11, [``](ratio.md)11, ``26, [``](valarray.md) | -| [Memory management](../cpp/smart-pointers-modern-cpp.md) | [``](allocators-header.md), ``26, [``](memory.md), [``](memory-resource.md)17, [``](new.md), [``](scoped-allocator.md)11 | -| Multithreading | [``](atomic.md)11, ``20, [``](condition-variable.md)11, [``](future.md)11, ``20, [``](mutex.md)11, ``26, ``20, [``](shared-mutex.md)14, ``20, [``](thread.md)11 | +| Math and numerics | [``](bit.md)20, [``](cfenv.md)11, [``](cmath.md), [``](complex.md), [``](cstdlib.md), [``](limits.md), ``20, [``](numeric.md), [``](random.md)11, [``](ratio.md)11, [``](valarray.md) | +| [Memory management](../cpp/smart-pointers-modern-cpp.md) | [``](allocators-header.md), [``](memory.md), [``](memory-resource.md)17, [``](new.md), [``](scoped-allocator.md)11 | +| Multithreading | [``](atomic.md)11, ``20, [``](condition-variable.md)11, [``](future.md)11, ``20, [``](mutex.md)11, ``20, [``](shared-mutex.md)14, ``20, [``](thread.md)11 | | Ranges | ``23, [``](ranges.md)20 | | Regular expressions | [``](regex.md)11 | -| Strings and character data | [``](charconv.md)17, [``](cctype.md), [``](cstdlib.md), [``](cstring.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md), [``](regex.md)11, [``](string.md), [``](string-view.md)17, ``26 | +| Strings and character data | [``](charconv.md)17, [``](cctype.md), [``](cstdlib.md), [``](cstring.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md), [``](regex.md)11, [``](string.md), [``](string-view.md)17 | | Time | [``](chrono.md)11, [``](ctime.md) | 11 Added in the C++11 standard.\ @@ -44,7 +44,6 @@ Header files for the C++ standard library and extensions, by category. 17 Added in the C++17 standard.\ 20 Added in the C++20 standard.\ 23 Added in the C++23 standard.\ -26 Added in the draft C++26 standard.\ a Deprecated in the C++17 standard.\ b Removed in the C++20 standard.\ c Deprecated in the C++98 standard. From 4c2d3569c1bb3893bbcad1cfd14a511f2d4c82c7 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 5 Mar 2026 16:16:35 -0800 Subject: [PATCH 1687/1799] removing low value content --- .openpublishing.redirection.json | 65 ++++++++++++++ .../standard-library/container-class-begin.md | 4 - .../standard-library/container-class-clear.md | 4 - .../container-class-const-iterator.md | 4 - .../container-class-const-reference.md | 4 - .../container-class-const-reverse-iterator.md | 4 - .../container-class-difference-type.md | 4 - .../standard-library/container-class-empty.md | 4 - docs/standard-library/container-class-end.md | 4 - .../standard-library/container-class-erase.md | 4 - .../container-class-iterator.md | 4 - .../container-class-max-size.md | 4 - .../container-class-rbegin.md | 4 - .../container-class-reference.md | 4 - docs/standard-library/container-class-rend.md | 4 - .../container-class-reverse-iterator.md | 4 - .../container-class-size-type.md | 4 - docs/standard-library/container-class-size.md | 4 - docs/standard-library/container-class-swap.md | 4 - .../container-class-value-type.md | 4 - .../operator-equality-sample-container.md | 31 ------- .../operator-greater-or-equal.md | 2 +- .../operator-greater-than-sample-container.md | 31 ------- docs/standard-library/operator-inequality.md | 2 +- ...operator-less-or-equal-sample-container.md | 31 ------- .../operator-less-than-sample-container.md | 33 ------- .../sample-container-class.md | 73 --------------- .../sample-container-classes.md | 9 -- .../sample-container-member-functions.md | 9 -- .../sample-container-members.md | 42 --------- .../sample-container-operators.md | 9 -- ...ontainer-specialized-template-functions.md | 9 -- .../sample-container-typedefs.md | 9 -- docs/standard-library/sample-container.md | 19 ---- docs/standard-library/stl-containers.md | 1 - .../standard-library/swap-sample-container.md | 27 ------ docs/standard-library/toc.yml | 89 ------------------- 37 files changed, 67 insertions(+), 500 deletions(-) delete mode 100644 docs/standard-library/operator-equality-sample-container.md delete mode 100644 docs/standard-library/operator-greater-than-sample-container.md delete mode 100644 docs/standard-library/operator-less-or-equal-sample-container.md delete mode 100644 docs/standard-library/operator-less-than-sample-container.md delete mode 100644 docs/standard-library/sample-container-class.md delete mode 100644 docs/standard-library/sample-container-classes.md delete mode 100644 docs/standard-library/sample-container-member-functions.md delete mode 100644 docs/standard-library/sample-container-members.md delete mode 100644 docs/standard-library/sample-container-operators.md delete mode 100644 docs/standard-library/sample-container-specialized-template-functions.md delete mode 100644 docs/standard-library/sample-container-typedefs.md delete mode 100644 docs/standard-library/sample-container.md delete mode 100644 docs/standard-library/swap-sample-container.md diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index dc663314250..325a1fbbfe8 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -13764,6 +13764,71 @@ "source_path": "docs/overview/whats-new-cpp-docs.md", "redirect_url": "../../cpp/overview/what-s-new-for-visual-cpp-in-visual-studio", "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/sample-container.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/sample-container-class.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/sample-container-classes.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/sample-container-member-functions.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/sample-container-members.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/sample-container-operators.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/sample-container-specialized-template-functions.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/sample-container-typedefs.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/operator-equality-sample-container.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/operator-greater-than-sample-container.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/operator-less-or-equal-sample-container.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/operator-less-than-sample-container.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/swap-sample-container.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false } ] } \ No newline at end of file diff --git a/docs/standard-library/container-class-begin.md b/docs/standard-library/container-class-begin.md index 18f29cf3dc1..c000652ac6a 100644 --- a/docs/standard-library/container-class-begin.md +++ b/docs/standard-library/container-class-begin.md @@ -19,7 +19,3 @@ const_iterator begin() const; iterator begin(); ``` - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-clear.md b/docs/standard-library/container-class-clear.md index ff6627e9ed9..f737e316df8 100644 --- a/docs/standard-library/container-class-clear.md +++ b/docs/standard-library/container-class-clear.md @@ -17,7 +17,3 @@ Calls [erase](../standard-library/container-class-erase.md)([begin](../standard- ```cpp void clear(); ``` - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-const-iterator.md b/docs/standard-library/container-class-const-iterator.md index b54276698fb..5c9a22e01be 100644 --- a/docs/standard-library/container-class-const-iterator.md +++ b/docs/standard-library/container-class-const-iterator.md @@ -21,7 +21,3 @@ typedef T6 const_iterator; ## Remarks It is described here as a synonym for the unspecified type `T6`. - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-const-reference.md b/docs/standard-library/container-class-const-reference.md index 9c926215247..a135635ad5b 100644 --- a/docs/standard-library/container-class-const-reference.md +++ b/docs/standard-library/container-class-const-reference.md @@ -21,7 +21,3 @@ typedef T3 const_reference; ## Remarks It is described here as a synonym for the unspecified type `T3` (typically `Alloc::const_reference`). - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-const-reverse-iterator.md b/docs/standard-library/container-class-const-reverse-iterator.md index 274c0dae9c9..7a2d24653b4 100644 --- a/docs/standard-library/container-class-const-reverse-iterator.md +++ b/docs/standard-library/container-class-const-reverse-iterator.md @@ -21,7 +21,3 @@ typedef T8 const_reverse_iterator; ## Remarks It is described here as a synonym for the unspecified type `T8` (typically [reverse_iterator](../standard-library/container-class-reverse-iterator.md) <[const_iterator](../standard-library/container-class-const-iterator.md)`>`). - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-difference-type.md b/docs/standard-library/container-class-difference-type.md index 3a271d8bfd4..5321f438d6e 100644 --- a/docs/standard-library/container-class-difference-type.md +++ b/docs/standard-library/container-class-difference-type.md @@ -21,7 +21,3 @@ typedef T1 difference_type; ## Remarks It is described here as a synonym for the unspecified type `T1` (typically `Alloc::difference_type`). - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-empty.md b/docs/standard-library/container-class-empty.md index f4064bbd769..9c418bc5a3e 100644 --- a/docs/standard-library/container-class-empty.md +++ b/docs/standard-library/container-class-empty.md @@ -17,7 +17,3 @@ Returns **`true`** for an empty controlled sequence. ```cpp bool empty() const; ``` - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-end.md b/docs/standard-library/container-class-end.md index b5da84d78d4..9cbc722f31e 100644 --- a/docs/standard-library/container-class-end.md +++ b/docs/standard-library/container-class-end.md @@ -19,7 +19,3 @@ const_iterator end() const; iterator end(); ``` - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-erase.md b/docs/standard-library/container-class-erase.md index 2101b201e4d..8a5a329c95c 100644 --- a/docs/standard-library/container-class-erase.md +++ b/docs/standard-library/container-class-erase.md @@ -28,7 +28,3 @@ iterator erase( The first member function removes the element of the controlled sequence pointed to by *_Where*. The second member function removes the elements of the controlled sequence in the range [`first`, `last`). Both return an iterator that designates the first element remaining beyond any elements removed, or [end](../standard-library/container-class-end.md) if no such element exists. The member functions throw an exception only if a copy operation throws an exception. - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-iterator.md b/docs/standard-library/container-class-iterator.md index 1b778bdd2a4..96bc0358f8d 100644 --- a/docs/standard-library/container-class-iterator.md +++ b/docs/standard-library/container-class-iterator.md @@ -21,7 +21,3 @@ typedef T5 iterator; ## Remarks It is described here as a synonym for the unspecified type `T5`. An object of type `iterator` can be cast to an object of type [const_iterator](../standard-library/container-class-const-iterator.md). - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-max-size.md b/docs/standard-library/container-class-max-size.md index 7cf4e3fa353..65467c16766 100644 --- a/docs/standard-library/container-class-max-size.md +++ b/docs/standard-library/container-class-max-size.md @@ -17,7 +17,3 @@ Returns the length of the longest sequence that the object can control, in const ```cpp size_type max_size() const; ``` - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-rbegin.md b/docs/standard-library/container-class-rbegin.md index b4fb7e06e48..0bfc8015d79 100644 --- a/docs/standard-library/container-class-rbegin.md +++ b/docs/standard-library/container-class-rbegin.md @@ -19,7 +19,3 @@ const_reverse_iterator rbegin() const; reverse_iterator rbegin(); ``` - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-reference.md b/docs/standard-library/container-class-reference.md index d595948cd5b..4c8c14bcc39 100644 --- a/docs/standard-library/container-class-reference.md +++ b/docs/standard-library/container-class-reference.md @@ -21,7 +21,3 @@ typedef T2 reference; ## Remarks It is described here as a synonym for the unspecified type `T2` (typically `Alloc::reference`). An object of type `reference` can be cast to an object of type [const_reference](../standard-library/container-class-const-reference.md). - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-rend.md b/docs/standard-library/container-class-rend.md index 82a170fc152..8177b3c9d62 100644 --- a/docs/standard-library/container-class-rend.md +++ b/docs/standard-library/container-class-rend.md @@ -19,7 +19,3 @@ const_reverse_iterator rend() const; reverse_iterator rend(); ``` - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-reverse-iterator.md b/docs/standard-library/container-class-reverse-iterator.md index 73a36729007..e745d77b961 100644 --- a/docs/standard-library/container-class-reverse-iterator.md +++ b/docs/standard-library/container-class-reverse-iterator.md @@ -21,7 +21,3 @@ typedef T7 reverse_iterator; ## Remarks It is described here as a synonym for the unspecified type `T7` (typically `reverse_iterator` **\<**[iterator](../standard-library/container-class-iterator.md)**>**). - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-size-type.md b/docs/standard-library/container-class-size-type.md index 458b57a0582..abc51b7b873 100644 --- a/docs/standard-library/container-class-size-type.md +++ b/docs/standard-library/container-class-size-type.md @@ -21,7 +21,3 @@ typedef T0 size_type; ## Remarks It is described here as a synonym for the unspecified type `T0` (typically `Alloc::size_type`). - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-size.md b/docs/standard-library/container-class-size.md index 07a0e4ea210..cf379937eb4 100644 --- a/docs/standard-library/container-class-size.md +++ b/docs/standard-library/container-class-size.md @@ -17,7 +17,3 @@ Returns the length of the controlled sequence, in constant time regardless of th ```cpp size_type size() const; ``` - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-swap.md b/docs/standard-library/container-class-swap.md index 1e976af3713..afd4d7b166a 100644 --- a/docs/standard-library/container-class-swap.md +++ b/docs/standard-library/container-class-swap.md @@ -23,7 +23,3 @@ void swap(Container& right); ## Remarks If `*this.get_allocator == right.get_allocator`, it does a swap in constant time. Otherwise, it performs element assignments and constructor calls proportional to the number of elements in the two controlled sequences. - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/container-class-value-type.md b/docs/standard-library/container-class-value-type.md index 9ff7647669d..512f0d9ba0b 100644 --- a/docs/standard-library/container-class-value-type.md +++ b/docs/standard-library/container-class-value-type.md @@ -21,7 +21,3 @@ typedef T4 value_type; ## Remarks It is described here as a synonym for the unspecified type `T4` (typically `Alloc::value_type`). - -## See also - -[Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/operator-equality-sample-container.md b/docs/standard-library/operator-equality-sample-container.md deleted file mode 100644 index 63715e0da1d..00000000000 --- a/docs/standard-library/operator-equality-sample-container.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Learn more about: operator== ()" -title: "operator== ()" -ms.date: "11/04/2016" -f1_keywords: ["std.==", "std::==", "operator==", "std.operator==", "std::operator==", "=="] -helpviewer_keywords: ["operator ==, containers", "operator==, containers", "== operator, with specific standard C++ objects"] -ms.assetid: d3d8754e-5157-4b8b-bf9c-da41856f5eed ---- -# `operator==` (``) - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Overloads `operator==` to compare two objects of class template [Container](../standard-library/sample-container-class.md). - -## Syntax - -```cpp -template -bool operator==( - const Container & left, - const Container & right); -``` - -## Return Value - -Returns `left.`[size](../standard-library/container-class-size.md) `== right.size && equal(left.`[begin](../standard-library/container-class-begin.md)`, left.`[end](../standard-library/container-class-end.md)`, right.begin)`. - -## See also - -[\](../standard-library/sample-container.md) diff --git a/docs/standard-library/operator-greater-or-equal.md b/docs/standard-library/operator-greater-or-equal.md index 13d31d815af..57abc266e5c 100644 --- a/docs/standard-library/operator-greater-or-equal.md +++ b/docs/standard-library/operator-greater-or-equal.md @@ -11,7 +11,7 @@ ms.assetid: 14fbebf5-8b75-4afa-a51b-3112d31c07cf > [!NOTE] > This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). -Overloads **operator>=** to compare two objects of class template [Container](../standard-library/sample-container-class.md). +Overloads **operator>=** to compare two objects of class template Container. ## Syntax diff --git a/docs/standard-library/operator-greater-than-sample-container.md b/docs/standard-library/operator-greater-than-sample-container.md deleted file mode 100644 index a6bf41df1d3..00000000000 --- a/docs/standard-library/operator-greater-than-sample-container.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Learn more about: operator> ()" -title: "operator> ()" -ms.date: "11/04/2016" -f1_keywords: ["std::operator>", "operator>", "std::>", ">"] -helpviewer_keywords: ["> operator, comparing specific objects", "operator >"] -ms.assetid: 49bd417a-3305-4ffa-9884-39d3904ed87d ---- -# `operator>` (``) - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Overloads **operator>** to compare two objects of class template [Container](../standard-library/sample-container-class.md). - -## Syntax - -```cpp -template -bool operator*gt( - const Container & left, - const Container & right); -``` - -## Return Value - -Returns `right < left`. - -## See also - -[\](../standard-library/sample-container.md) diff --git a/docs/standard-library/operator-inequality.md b/docs/standard-library/operator-inequality.md index 1416a3f3cc3..be77e52f530 100644 --- a/docs/standard-library/operator-inequality.md +++ b/docs/standard-library/operator-inequality.md @@ -11,7 +11,7 @@ ms.assetid: ef2be7f0-1c94-4edc-b65c-731fddd519f4 > [!NOTE] > This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). -Overloads `operator!=` to compare two objects of class template [Container](../standard-library/sample-container-class.md). +Overloads `operator!=` to compare two objects of class template Container. ## Syntax diff --git a/docs/standard-library/operator-less-or-equal-sample-container.md b/docs/standard-library/operator-less-or-equal-sample-container.md deleted file mode 100644 index db35e24ec91..00000000000 --- a/docs/standard-library/operator-less-or-equal-sample-container.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Learn more about: operator<= ()" -title: "operator<= ()" -ms.date: "11/04/2016" -f1_keywords: ["std::<=", "std.operator<=", "operator<=", "std.<=", "std::operator<=", "<="] -helpviewer_keywords: ["operator<=", "operator <=", "<= operator, with specific objects", "<= operator"] -ms.assetid: 338577dd-dc88-4a2b-9e12-0379c54fc8a2 ---- -# `operator<=` (``) - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Overloads **operator<=** to compare two objects of class template [Container](../standard-library/sample-container-class.md). - -## Syntax - -```cpp -template -bool operator<=( - const Container & left, - const Container & right); -``` - -## Return Value - -Returns `!(right < left)`. - -## See also - -[\](../standard-library/sample-container.md) diff --git a/docs/standard-library/operator-less-than-sample-container.md b/docs/standard-library/operator-less-than-sample-container.md deleted file mode 100644 index cab25748e00..00000000000 --- a/docs/standard-library/operator-less-than-sample-container.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -description: "Learn more about: operator< ()" -title: "operator< ()" -ms.date: "11/04/2016" -f1_keywords: ["std::operator<", "operator<", "std.<", "<", "std.operator<", "std::<"] -helpviewer_keywords: ["< operator, comparing specific objects", "operator<, valarrays", "< operator", "operator <, valarrays"] -ms.assetid: 31027dd6-53be-428b-b950-1dcb25393597 ---- -# `operator<` (``) - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Overloads **operator<** to compare two objects of class template [Container](../standard-library/sample-container-class.md). - -## Syntax - -```cpp -template -bool operator<( - const Container & left, - const Container & right); -``` - -## Return Value - -Returns `lexicographical_compare(left.begin, left.end, right.begin, right.end)`. - -## See also - -[\](../standard-library/sample-container.md)\ -[begin](../standard-library/container-class-begin.md)\ -[end](../standard-library/container-class-end.md) diff --git a/docs/standard-library/sample-container-class.md b/docs/standard-library/sample-container-class.md deleted file mode 100644 index a55cb14fa1a..00000000000 --- a/docs/standard-library/sample-container-class.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -description: "Learn more about: Sample Container Class" -title: "Sample Container Class" -ms.date: "11/04/2016" -helpviewer_keywords: ["container classes [C++]"] -ms.assetid: 5b1451f2-c708-45da-bbf0-9e42fd687a1a ---- -# Sample Container Class - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Describes an object that controls a varying-length sequence of elements, typically of type `Ty`. The sequence is stored in different ways, depending on the actual container. - -A container constructor or member function may find occasion to call the constructor **Ty**(**const Ty&**) or the function **Ty::operator=**(**const Ty&**). If such a call throws an exception, the container object is obliged to maintain its integrity, and to rethrow any exception it catches. You can safely swap, assign to, erase, or destroy a container object after it throws one of these exceptions. In general, however, you cannot otherwise predict the state of the sequence controlled by the container object. - -A few additional caveats: - -- If the expression `~Ty` throws an exception, the resulting state of the container object is undefined. - -- If the container stores an allocator object *al*, and *al* throws an exception other than as a result of a call to `al.allocate`, the resulting state of the container object is undefined. - -- If the container stores a function object *comp*, to determine how to order the controlled sequence, and *comp* throws an exception of any kind, the resulting state of the container object is undefined. - -The container classes defined by C++ Standard Library satisfy several additional requirements, as described in the following paragraphs. - -Container class template [list](../standard-library/list-class.md) provides deterministic, and useful, behavior even in the presence of the exceptions described above. For example, if an exception is thrown during the insertion of one or more elements, the container is left unaltered and the exception is rethrown. - -For *all* the container classes defined by C++ Standard Library, if an exception is thrown during calls to the following member functions, `insert`, `push_back`, or `push_front`, the container is left unaltered and the exception is rethrown. - -For *all* the container classes defined by C++ Standard Library, no exception is thrown during calls to the following member functions: `pop_back`, `pop_front`. - -The member function [erase](../standard-library/container-class-erase.md) throws an exception only if a copy operation (assignment or copy construction) throws an exception. - -Moreover, no exception is thrown while copying an iterator returned by a member function. - -The member function [swap](../standard-library/container-class-swap.md) makes additional promises for *all* container classes defined by C++ Standard Library: - -- The member function throws an exception only if the container stores an allocator object al, and `al` throws an exception when copied. - -- References, pointers, and iterators that designate elements of the controlled sequences being swapped remain valid. - -An object of a container class defined by C++ Standard Library allocates and frees storage for the sequence it controls through a stored object of type `Alloc`, which is typically a template parameter. Such an allocator object must have the same external interface as an object of class `allocator`. In particular, `Alloc` must be the same type as `Alloc::rebind::other` - -For *all* container classes defined by C++ Standard Library, the member function `Alloc get_allocator const;` returns a copy of the stored allocator object. Note that the stored allocator object is *not* copied when the container object is assigned. All constructors initialize the value stored in `allocator`, to `Alloc` if the constructor contains no allocator parameter. - -According to the C++ Standard, a container class defined by the C++ Standard Library can assume that: - -- All objects of class `Alloc` compare equal. - -- Type `Alloc::const_pointer` is the same as `const Ty *`. - -- Type `Alloc::const_reference` is the same as `const Ty&`. - -- Type `Alloc::pointer` is the same as `Ty *`. - -- Type `Alloc::reference` is the same as `Ty&`. - -In this implementation, however, containers do not make such simplifying assumptions. Thus, they work properly with allocator objects that are more ambitious: - -- All objects of class `Alloc` does not need to compare equal. (You can maintain multiple pools of storage.) - -- Type `Alloc::const_pointer` does not need to be the same as `const Ty *`. (A const pointer can be a class.) - -- Type `Alloc::pointer` does not need to be the same as `Ty *`. (A pointer can be a class.) - -## Requirements - -**Header**: \ - -## See also - -[\](../standard-library/sample-container.md) diff --git a/docs/standard-library/sample-container-classes.md b/docs/standard-library/sample-container-classes.md deleted file mode 100644 index 4208b28a6f6..00000000000 --- a/docs/standard-library/sample-container-classes.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -description: "Learn more about: Classes" -title: " Classes" -ms.date: "11/04/2016" -ms.assetid: ac63ed42-5ae5-4008-99fb-89e045bf98af ---- -# `` Classes - -For more information about the classes in \, see [\](../standard-library/sample-container.md). diff --git a/docs/standard-library/sample-container-member-functions.md b/docs/standard-library/sample-container-member-functions.md deleted file mode 100644 index 8385eee0068..00000000000 --- a/docs/standard-library/sample-container-member-functions.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -description: "Learn more about: Sample Container Member Functions" -title: "Sample Container Member Functions" -ms.date: "11/04/2016" -ms.assetid: fbd88c16-57e6-435d-ad70-7a195c0103ab ---- -# Sample Container Member Functions - -For more information about the member functions in the sample container class, see [Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/sample-container-members.md b/docs/standard-library/sample-container-members.md deleted file mode 100644 index 18b77c70c3a..00000000000 --- a/docs/standard-library/sample-container-members.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -description: "Learn more about: Sample Container Members" -title: "Sample Container Members" -ms.date: "11/04/2016" -helpviewer_keywords: ["container classes"] -ms.assetid: dc5a1998-a31b-4adf-b888-8abe5b87a4e0 ---- -# Sample Container Members - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -## Reference - -## Typedefs - -|Name|Description| -|-|-| -|[const_iterator](../standard-library/container-class-const-iterator.md)|Describes an object that can serve as a constant iterator for the controlled sequence.| -|[const_reference](../standard-library/container-class-const-reference.md)|Describes an object that can serve as a constant reference to an element of the controlled sequence.| -|[const_reverse_iterator](../standard-library/container-class-const-reverse-iterator.md)|Describes an object that can serve as a constant reverse iterator for the controlled sequence.| -|[difference_type](../standard-library/container-class-difference-type.md)|Describes an object that can represent the difference between the addresses of any two elements in the controlled sequence.| -|[iterator](../standard-library/container-class-iterator.md)|Describes an object that can serve as an iterator for the controlled sequence.| -|[reference](../standard-library/container-class-reference.md)|Describes an object that can serve as a reference to an element of the controlled sequence.| -|[reverse_iterator](../standard-library/container-class-reverse-iterator.md)|Describes an object that can serve as a reverse iterator for the controlled sequence.| -|[size_type](../standard-library/container-class-size-type.md)|Describes an object that can represent the length of any controlled sequence.| -|[value_type](../standard-library/container-class-value-type.md)|Acts a synonym for the template parameter `Ty`.| - -## Member Functions - -|Name|Description| -|-|-| -|[begin](../standard-library/container-class-begin.md)|Returns an iterator that points at the first element of the sequence (or just beyond the end of an empty sequence).| -|[clear](../standard-library/container-class-clear.md)|Calls [erase](../standard-library/container-class-erase.md)( [begin](../standard-library/container-class-begin.md), [end](../standard-library/container-class-end.md)).| -|[empty](../standard-library/container-class-empty.md)|Returns **`true`** for an empty controlled sequence.| -|[end](../standard-library/container-class-end.md)|Returns an iterator that points just beyond the end of the sequence.| -|[erase](../standard-library/container-class-erase.md)|Erases an element.| -|[max_size](../standard-library/container-class-max-size.md)|Returns the length of the longest sequence that the object can control, in constant time regardless of the length of the controlled sequence.| -|[rbegin](../standard-library/container-class-rbegin.md)|Returns a reverse iterator that points just beyond the end of the controlled sequence, designating the beginning of the reverse sequence.| -|[rend](../standard-library/container-class-rend.md)|The member function returns a reverse iterator that points at the first element of the sequence (or just beyond the end of an empty sequence), designating the end of the reverse sequence.| -|[size](../standard-library/container-class-size.md)|Returns the length of the controlled sequence, in constant time regardless of the length of the controlled sequence.| -|[swap](../standard-library/container-class-swap.md) diff --git a/docs/standard-library/sample-container-operators.md b/docs/standard-library/sample-container-operators.md deleted file mode 100644 index e5f5f0aa9f4..00000000000 --- a/docs/standard-library/sample-container-operators.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -description: "Learn more about: Operators" -title: " Operators" -ms.date: "11/04/2016" -ms.assetid: 6cd28cdc-8318-4941-a06c-2c32758383fd ---- -# `` Operators - -For more information about the operators in \, see [\](../standard-library/sample-container.md). diff --git a/docs/standard-library/sample-container-specialized-template-functions.md b/docs/standard-library/sample-container-specialized-template-functions.md deleted file mode 100644 index eda14ad7267..00000000000 --- a/docs/standard-library/sample-container-specialized-template-functions.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -description: "Learn more about: Specialized Template Functions" -title: " Specialized Template Functions" -ms.date: "11/04/2016" -ms.assetid: 853d4b30-167a-471b-8325-86a868943568 ---- -# `` Specialized Template Functions - -For more information about the specialized template functions in \, see [\](../standard-library/sample-container.md). diff --git a/docs/standard-library/sample-container-typedefs.md b/docs/standard-library/sample-container-typedefs.md deleted file mode 100644 index 8122280f8aa..00000000000 --- a/docs/standard-library/sample-container-typedefs.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -description: "Learn more about: Sample Container Typedefs" -title: "Sample Container Typedefs" -ms.date: "11/04/2016" -ms.assetid: 9fc02c4c-d835-4266-a391-f12b40ba43fa ---- -# Sample Container Typedefs - -For more information about the typedefs in the sample container class, see [Sample Container Class](../standard-library/sample-container-class.md) diff --git a/docs/standard-library/sample-container.md b/docs/standard-library/sample-container.md deleted file mode 100644 index 667dcef38dc..00000000000 --- a/docs/standard-library/sample-container.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -description: "Learn more about: " -title: "" -ms.date: "11/04/2016" -helpviewer_keywords: ["headers, C++ sample container", "sample container", "container headers"] -ms.assetid: 4ab3dcf9-49c3-4e49-b5d6-1ec573e2aee4 ---- -# `` - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Shows you the structure of the container headers in the C++ Standard Library. - -## Syntax - -```cpp -#include // Nonfunctional header -``` diff --git a/docs/standard-library/stl-containers.md b/docs/standard-library/stl-containers.md index 0b8ce549317..be656d73146 100644 --- a/docs/standard-library/stl-containers.md +++ b/docs/standard-library/stl-containers.md @@ -163,5 +163,4 @@ In C++14 and later, you can compare dissimilar containers and/or dissimilar elem ## See also [Parallel Containers](../parallel/concrt/parallel-containers-and-objects.md)\ -[``](../standard-library/sample-container.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/swap-sample-container.md b/docs/standard-library/swap-sample-container.md deleted file mode 100644 index b90bffdd488..00000000000 --- a/docs/standard-library/swap-sample-container.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -description: "Learn more about: swap ()" -title: "swap ()" -ms.date: "11/04/2016" -f1_keywords: ["std.swap", "std::swap", "swap"] -helpviewer_keywords: ["swap function"] -ms.assetid: d8dd6436-fb97-46ed-bec5-052cfd710462 ---- -# `swap` (``) - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Executes `left.`[swap](../standard-library/container-class-swap.md)`(right)`. - -## Syntax - -```cpp -template -void swap( - Container & left, - Container & right); -``` - -## See also - -[\](../standard-library/sample-container.md) diff --git a/docs/standard-library/toc.yml b/docs/standard-library/toc.yml index 9573b45f054..9ff0efac2ed 100644 --- a/docs/standard-library/toc.yml +++ b/docs/standard-library/toc.yml @@ -1557,95 +1557,6 @@ items: items: - name: C++ Standard Library containers href: stl-containers.md - - name: - expanded: false - items: - - name: - href: sample-container.md - - name: operators - expanded: false - items: - - name: operators - href: sample-container-operators.md - - name: operator!= - href: operator-inequality.md - - name: operator== () - href: operator-equality-sample-container.md - - name: operator< () - href: operator-less-than-sample-container.md - - name: operator<= () - href: operator-less-or-equal-sample-container.md - - name: operator> () - href: operator-greater-than-sample-container.md - - name: operator>= - href: operator-greater-or-equal.md - - name: specialized template functions - expanded: false - items: - - name: specialized template functions - href: sample-container-specialized-template-functions.md - - name: swap () - href: swap-sample-container.md - - name: classes - expanded: false - items: - - name: classes - href: sample-container-classes.md - - name: Sample container class - expanded: false - items: - - name: Sample container class - href: sample-container-class.md - - name: Sample container members - href: sample-container-members.md - - name: Sample container typedefs - expanded: false - items: - - name: Sample container typedefs - href: sample-container-typedefs.md - - name: "Container class::const_iterator" - href: container-class-const-iterator.md - - name: "Container class::const_reference" - href: container-class-const-reference.md - - name: "Container class::const_reverse_iterator" - href: container-class-const-reverse-iterator.md - - name: "Container class::difference_type" - href: container-class-difference-type.md - - name: "Container class::iterator" - href: container-class-iterator.md - - name: "Container class::reference" - href: container-class-reference.md - - name: "Container class::reverse_iterator" - href: container-class-reverse-iterator.md - - name: "Container class::size_type" - href: container-class-size-type.md - - name: "Container class::value_type" - href: container-class-value-type.md - - name: Sample container member functions - expanded: false - items: - - name: Sample container member functions - href: sample-container-member-functions.md - - name: "Container class::begin" - href: container-class-begin.md - - name: "Container class::clear" - href: container-class-clear.md - - name: "Container class::empty" - href: container-class-empty.md - - name: "Container class::end" - href: container-class-end.md - - name: "Container class::erase" - href: container-class-erase.md - - name: "Container class::max_size" - href: container-class-max-size.md - - name: "Container class::rbegin" - href: container-class-rbegin.md - - name: "Container class::rend" - href: container-class-rend.md - - name: "Container class::size" - href: container-class-size.md - - name: "Container class::swap" - href: container-class-swap.md - name: Iterators href: iterators.md - name: Algorithms From ee96e72bef8ae34578f211f84ab697f4c6878bf1 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 5 Mar 2026 16:34:52 -0800 Subject: [PATCH 1688/1799] curate more files --- .openpublishing.redirection.json | 105 ++++++++++++++++++ .../standard-library/container-class-begin.md | 21 ---- .../standard-library/container-class-clear.md | 19 ---- .../container-class-const-iterator.md | 23 ---- .../container-class-const-reference.md | 23 ---- .../container-class-const-reverse-iterator.md | 23 ---- .../container-class-difference-type.md | 23 ---- .../standard-library/container-class-empty.md | 19 ---- docs/standard-library/container-class-end.md | 21 ---- .../standard-library/container-class-erase.md | 30 ----- .../container-class-iterator.md | 23 ---- .../container-class-max-size.md | 19 ---- .../container-class-rbegin.md | 21 ---- .../container-class-reference.md | 23 ---- docs/standard-library/container-class-rend.md | 21 ---- .../container-class-reverse-iterator.md | 23 ---- .../container-class-size-type.md | 23 ---- docs/standard-library/container-class-size.md | 19 ---- docs/standard-library/container-class-swap.md | 25 ----- .../container-class-value-type.md | 23 ---- .../operator-greater-or-equal.md | 31 ------ docs/standard-library/operator-inequality.md | 31 ------ 22 files changed, 105 insertions(+), 484 deletions(-) delete mode 100644 docs/standard-library/container-class-begin.md delete mode 100644 docs/standard-library/container-class-clear.md delete mode 100644 docs/standard-library/container-class-const-iterator.md delete mode 100644 docs/standard-library/container-class-const-reference.md delete mode 100644 docs/standard-library/container-class-const-reverse-iterator.md delete mode 100644 docs/standard-library/container-class-difference-type.md delete mode 100644 docs/standard-library/container-class-empty.md delete mode 100644 docs/standard-library/container-class-end.md delete mode 100644 docs/standard-library/container-class-erase.md delete mode 100644 docs/standard-library/container-class-iterator.md delete mode 100644 docs/standard-library/container-class-max-size.md delete mode 100644 docs/standard-library/container-class-rbegin.md delete mode 100644 docs/standard-library/container-class-reference.md delete mode 100644 docs/standard-library/container-class-rend.md delete mode 100644 docs/standard-library/container-class-reverse-iterator.md delete mode 100644 docs/standard-library/container-class-size-type.md delete mode 100644 docs/standard-library/container-class-size.md delete mode 100644 docs/standard-library/container-class-swap.md delete mode 100644 docs/standard-library/container-class-value-type.md delete mode 100644 docs/standard-library/operator-greater-or-equal.md delete mode 100644 docs/standard-library/operator-inequality.md diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 325a1fbbfe8..585f812c4b4 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -13829,6 +13829,111 @@ "source_path": "docs/standard-library/swap-sample-container.md", "redirect_url": "/cpp/standard-library/stl-containers", "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/operator-greater-or-equal.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/operator-inequality.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-begin.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-clear.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-const-iterator.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-const-reference.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-const-reverse-iterator.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-difference-type.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-empty.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-end.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-erase.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-iterator.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-max-size.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-rbegin.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-reference.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-rend.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-reverse-iterator.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-size.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-size-type.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-swap.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false + }, + { + "source_path": "docs/standard-library/container-class-value-type.md", + "redirect_url": "/cpp/standard-library/stl-containers", + "redirect_document_id": false } ] } \ No newline at end of file diff --git a/docs/standard-library/container-class-begin.md b/docs/standard-library/container-class-begin.md deleted file mode 100644 index c000652ac6a..00000000000 --- a/docs/standard-library/container-class-begin.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -description: "Learn more about: Container Class::begin" -title: "Container Class::begin" -ms.date: "05/07/2019" -helpviewer_keywords: ["begin method"] -ms.assetid: 633708cb-17fe-488b-9fb1-1b5f2da0f46c ---- -# Container Class::begin - -> [!NOTE] -> This topic is in the Visual Studio C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Returns an iterator that points at the first element of the sequence (or just beyond the end of an empty sequence). - -## Syntax - -```cpp -const_iterator begin() const; - -iterator begin(); -``` diff --git a/docs/standard-library/container-class-clear.md b/docs/standard-library/container-class-clear.md deleted file mode 100644 index f737e316df8..00000000000 --- a/docs/standard-library/container-class-clear.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -description: "Learn more about: Container Class::clear" -title: "Container Class::clear" -ms.date: "11/04/2016" -helpviewer_keywords: ["clear method"] -ms.assetid: 725f2717-5dc2-428f-a19a-05f046aafb2b ---- -# Container Class::clear - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Calls [erase](../standard-library/container-class-erase.md)([begin](../standard-library/container-class-begin.md), [end](../standard-library/container-class-end.md)). - -## Syntax - -```cpp -void clear(); -``` diff --git a/docs/standard-library/container-class-const-iterator.md b/docs/standard-library/container-class-const-iterator.md deleted file mode 100644 index 5c9a22e01be..00000000000 --- a/docs/standard-library/container-class-const-iterator.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Learn more about: Container Class::const_iterator" -title: "Container Class::const_iterator" -ms.date: "11/04/2016" -helpviewer_keywords: ["const_iterator method"] -ms.assetid: e68c9e30-fc4c-4c2e-8724-06d1fe8b8ccb ---- -# Container Class::const_iterator - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Describes an object that can serve as a constant iterator for the controlled sequence. - -## Syntax - -```cpp -typedef T6 const_iterator; -``` - -## Remarks - -It is described here as a synonym for the unspecified type `T6`. diff --git a/docs/standard-library/container-class-const-reference.md b/docs/standard-library/container-class-const-reference.md deleted file mode 100644 index a135635ad5b..00000000000 --- a/docs/standard-library/container-class-const-reference.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Learn more about: Container Class::const_reference" -title: "Container Class::const_reference" -ms.date: "11/04/2016" -helpviewer_keywords: ["const_reference method"] -ms.assetid: 7a5cfddb-3abf-4c98-b4ad-bbe4da9a5c1b ---- -# Container Class::const_reference - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Describes an object that can serve as a constant reference to an element of the controlled sequence. - -## Syntax - -```cpp -typedef T3 const_reference; -``` - -## Remarks - -It is described here as a synonym for the unspecified type `T3` (typically `Alloc::const_reference`). diff --git a/docs/standard-library/container-class-const-reverse-iterator.md b/docs/standard-library/container-class-const-reverse-iterator.md deleted file mode 100644 index 7a2d24653b4..00000000000 --- a/docs/standard-library/container-class-const-reverse-iterator.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Learn more about: Container Class::const_reverse_iterator" -title: "Container Class::const_reverse_iterator" -ms.date: "11/04/2016" -helpviewer_keywords: ["const_reverse_iterator method"] -ms.assetid: ceac84d5-a40f-4bbf-81e0-a96aa2bd8ee8 ---- -# Container Class::const_reverse_iterator - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Describes an object that can serve as a constant reverse iterator for the controlled sequence. - -## Syntax - -```cpp -typedef T8 const_reverse_iterator; -``` - -## Remarks - -It is described here as a synonym for the unspecified type `T8` (typically [reverse_iterator](../standard-library/container-class-reverse-iterator.md) <[const_iterator](../standard-library/container-class-const-iterator.md)`>`). diff --git a/docs/standard-library/container-class-difference-type.md b/docs/standard-library/container-class-difference-type.md deleted file mode 100644 index 5321f438d6e..00000000000 --- a/docs/standard-library/container-class-difference-type.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Learn more about: Container Class::difference_type" -title: "Container Class::difference_type" -ms.date: "11/04/2016" -helpviewer_keywords: ["difference_type typedef"] -ms.assetid: fae52485-d424-484e-9856-13505cfe528c ---- -# Container Class::difference_type - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Describes an object that can represent the difference between the addresses of any two elements in the controlled sequence. - -## Syntax - -```cpp -typedef T1 difference_type; -``` - -## Remarks - -It is described here as a synonym for the unspecified type `T1` (typically `Alloc::difference_type`). diff --git a/docs/standard-library/container-class-empty.md b/docs/standard-library/container-class-empty.md deleted file mode 100644 index 9c418bc5a3e..00000000000 --- a/docs/standard-library/container-class-empty.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -description: "Learn more about: Container Class::empty" -title: "Container Class::empty" -ms.date: "11/04/2016" -helpviewer_keywords: ["empty method"] -ms.assetid: 2055418d-3c42-4d28-a7db-111586119ed9 ---- -# Container Class::empty - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Returns **`true`** for an empty controlled sequence. - -## Syntax - -```cpp -bool empty() const; -``` diff --git a/docs/standard-library/container-class-end.md b/docs/standard-library/container-class-end.md deleted file mode 100644 index 9cbc722f31e..00000000000 --- a/docs/standard-library/container-class-end.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -description: "Learn more about: Container Class::end" -title: "Container Class::end" -ms.date: "11/04/2016" -helpviewer_keywords: ["end method"] -ms.assetid: 6fa38a20-3798-4387-9c6e-20fc3e90d813 ---- -# Container Class::end - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Returns an iterator that points just beyond the end of the sequence. - -## Syntax - -```cpp -const_iterator end() const; - -iterator end(); -``` diff --git a/docs/standard-library/container-class-erase.md b/docs/standard-library/container-class-erase.md deleted file mode 100644 index 8a5a329c95c..00000000000 --- a/docs/standard-library/container-class-erase.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -description: "Learn more about: Container Class::erase" -title: "Container Class::erase" -ms.date: "11/04/2016" -helpviewer_keywords: ["erase method"] -ms.assetid: abc091c5-5a80-4bd8-93a8-a2d9bde2efec ---- -# Container Class::erase - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Erases an element. - -## Syntax - -```cpp -iterator erase( - iterator _Where); - -iterator erase( - iterator first, - iterator last); -``` - -## Remarks - -The first member function removes the element of the controlled sequence pointed to by *_Where*. The second member function removes the elements of the controlled sequence in the range [`first`, `last`). Both return an iterator that designates the first element remaining beyond any elements removed, or [end](../standard-library/container-class-end.md) if no such element exists. - -The member functions throw an exception only if a copy operation throws an exception. diff --git a/docs/standard-library/container-class-iterator.md b/docs/standard-library/container-class-iterator.md deleted file mode 100644 index 96bc0358f8d..00000000000 --- a/docs/standard-library/container-class-iterator.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Learn more about: Container Class::iterator" -title: "Container Class::iterator" -ms.date: "11/04/2016" -helpviewer_keywords: ["iterator method"] -ms.assetid: f9c49d1c-17cb-4b17-8e54-09e3ea41ca26 ---- -# Container Class::iterator - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Describes an object that can serve as an iterator for the controlled sequence. - -## Syntax - -```cpp -typedef T5 iterator; -``` - -## Remarks - -It is described here as a synonym for the unspecified type `T5`. An object of type `iterator` can be cast to an object of type [const_iterator](../standard-library/container-class-const-iterator.md). diff --git a/docs/standard-library/container-class-max-size.md b/docs/standard-library/container-class-max-size.md deleted file mode 100644 index 65467c16766..00000000000 --- a/docs/standard-library/container-class-max-size.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -description: "Learn more about: Container Class::max_size" -title: "Container Class::max_size" -ms.date: "11/04/2016" -helpviewer_keywords: ["max_size method"] -ms.assetid: 56754753-9911-48fd-b463-ac06b2fa1aab ---- -# Container Class::max_size - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Returns the length of the longest sequence that the object can control, in constant time regardless of the length of the controlled sequence. - -## Syntax - -```cpp -size_type max_size() const; -``` diff --git a/docs/standard-library/container-class-rbegin.md b/docs/standard-library/container-class-rbegin.md deleted file mode 100644 index 0bfc8015d79..00000000000 --- a/docs/standard-library/container-class-rbegin.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -description: "Learn more about: Container Class::rbegin" -title: "Container Class::rbegin" -ms.date: "11/04/2016" -helpviewer_keywords: ["rbegin method"] -ms.assetid: c1f0d60c-93aa-4313-81b9-04e3f9c796c2 ---- -# Container Class::rbegin - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Returns a reverse iterator that points just beyond the end of the controlled sequence, designating the beginning of the reverse sequence. - -## Syntax - -```cpp -const_reverse_iterator rbegin() const; - -reverse_iterator rbegin(); -``` diff --git a/docs/standard-library/container-class-reference.md b/docs/standard-library/container-class-reference.md deleted file mode 100644 index 4c8c14bcc39..00000000000 --- a/docs/standard-library/container-class-reference.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Learn more about: Container Class::reference" -title: "Container Class::reference" -ms.date: "11/04/2016" -helpviewer_keywords: ["reference method"] -ms.assetid: ab85a9fb-c628-4761-9a5f-a0231fad7690 ---- -# Container Class::reference - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Describes an object that can serve as a reference to an element of the controlled sequence. - -## Syntax - -```cpp -typedef T2 reference; -``` - -## Remarks - -It is described here as a synonym for the unspecified type `T2` (typically `Alloc::reference`). An object of type `reference` can be cast to an object of type [const_reference](../standard-library/container-class-const-reference.md). diff --git a/docs/standard-library/container-class-rend.md b/docs/standard-library/container-class-rend.md deleted file mode 100644 index 8177b3c9d62..00000000000 --- a/docs/standard-library/container-class-rend.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -description: "Learn more about: Container Class::rend" -title: "Container Class::rend" -ms.date: "11/04/2016" -helpviewer_keywords: ["rend method"] -ms.assetid: 80f3dd04-dd2c-4b52-b0ed-d567ec5d186c ---- -# Container Class::rend - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -The member function returns a reverse iterator that points at the first element of the sequence (or just beyond the end of an empty sequence), designating the end of the reverse sequence. - -## Syntax - -```cpp -const_reverse_iterator rend() const; - -reverse_iterator rend(); -``` diff --git a/docs/standard-library/container-class-reverse-iterator.md b/docs/standard-library/container-class-reverse-iterator.md deleted file mode 100644 index e745d77b961..00000000000 --- a/docs/standard-library/container-class-reverse-iterator.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Learn more about: Container Class::reverse_iterator" -title: "Container Class::reverse_iterator" -ms.date: "11/04/2016" -helpviewer_keywords: ["reverse_iterator method"] -ms.assetid: 1d190c41-56b1-462e-b564-793b2a883c26 ---- -# Container Class::reverse_iterator - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Describes an object that can serve as a reverse iterator for the controlled sequence. - -## Syntax - -```cpp -typedef T7 reverse_iterator; -``` - -## Remarks - -It is described here as a synonym for the unspecified type `T7` (typically `reverse_iterator` **\<**[iterator](../standard-library/container-class-iterator.md)**>**). diff --git a/docs/standard-library/container-class-size-type.md b/docs/standard-library/container-class-size-type.md deleted file mode 100644 index abc51b7b873..00000000000 --- a/docs/standard-library/container-class-size-type.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Learn more about: Container Class::size_type" -title: "Container Class::size_type" -ms.date: "11/04/2016" -helpviewer_keywords: ["size_type typedef"] -ms.assetid: e02de8af-e175-45a2-b006-835814a40e68 ---- -# Container Class::size_type - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Describes an object that can represent the length of any controlled sequence. - -## Syntax - -```cpp -typedef T0 size_type; -``` - -## Remarks - -It is described here as a synonym for the unspecified type `T0` (typically `Alloc::size_type`). diff --git a/docs/standard-library/container-class-size.md b/docs/standard-library/container-class-size.md deleted file mode 100644 index cf379937eb4..00000000000 --- a/docs/standard-library/container-class-size.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -description: "Learn more about: Container Class::size" -title: "Container Class::size" -ms.date: "11/04/2016" -helpviewer_keywords: ["size method"] -ms.assetid: 67073661-2699-4534-ad3b-31a906658dc5 ---- -# Container Class::size - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Returns the length of the controlled sequence, in constant time regardless of the length of the controlled sequence. - -## Syntax - -```cpp -size_type size() const; -``` diff --git a/docs/standard-library/container-class-swap.md b/docs/standard-library/container-class-swap.md deleted file mode 100644 index afd4d7b166a..00000000000 --- a/docs/standard-library/container-class-swap.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -description: "Learn more about: Container Class::swap" -title: "Container Class::swap" -ms.date: 06/10/2022 -helpviewer_keywords: ["swap method"] -ms.assetid: 898c219c-bc8e-4d14-a149-6240426c693f -ms.custom: devdivchpfy22 ---- - -# Container Class::swap - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Swaps the controlled sequences between `*this` and its argument. - -## Syntax - -```cpp -void swap(Container& right); -``` - -## Remarks - -If `*this.get_allocator == right.get_allocator`, it does a swap in constant time. Otherwise, it performs element assignments and constructor calls proportional to the number of elements in the two controlled sequences. diff --git a/docs/standard-library/container-class-value-type.md b/docs/standard-library/container-class-value-type.md deleted file mode 100644 index 512f0d9ba0b..00000000000 --- a/docs/standard-library/container-class-value-type.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -description: "Learn more about: Container Class::value_type" -title: "Container Class::value_type" -ms.date: "11/04/2016" -helpviewer_keywords: ["value_type typedef"] -ms.assetid: e89d5a71-b48c-47fa-aa78-682243e6e97f ---- -# Container Class::value_type - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Acts a synonym for the template parameter *Ty*. - -## Syntax - -```cpp -typedef T4 value_type; -``` - -## Remarks - -It is described here as a synonym for the unspecified type `T4` (typically `Alloc::value_type`). diff --git a/docs/standard-library/operator-greater-or-equal.md b/docs/standard-library/operator-greater-or-equal.md deleted file mode 100644 index 57abc266e5c..00000000000 --- a/docs/standard-library/operator-greater-or-equal.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Learn more about: operator>=" -title: "operator>=" -ms.date: "11/04/2016" -f1_keywords: ["operator>=", "std::>=", "std.operator>=", ">=", "std.>=", "std::operator>="] -helpviewer_keywords: [">= operator, comparing specific objects", "operator >=", "operator>="] -ms.assetid: 14fbebf5-8b75-4afa-a51b-3112d31c07cf ---- -# `operator>=` - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Overloads **operator>=** to compare two objects of class template Container. - -## Syntax - -```cpp -template -bool operator>=( - const Container & left, - const Container & right); -``` - -## Return Value - -Returns `!(left < right)`. - -## See also - -[\](../standard-library/sample-container.md) diff --git a/docs/standard-library/operator-inequality.md b/docs/standard-library/operator-inequality.md deleted file mode 100644 index be77e52f530..00000000000 --- a/docs/standard-library/operator-inequality.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -description: "Learn more about: operator!=" -title: "operator!=" -ms.date: "11/04/2016" -f1_keywords: ["std::!=", "!=", "std::operator!=", "std.operator!=", "std.!=", "operator!="] -helpviewer_keywords: ["!= operator", "operator!=", "operator !="] -ms.assetid: ef2be7f0-1c94-4edc-b65c-731fddd519f4 ---- -# operator!= - -> [!NOTE] -> This topic is in the Microsoft C++ documentation as a nonfunctional example of containers used in the C++ Standard Library. For more information, see [C++ Standard Library Containers](../standard-library/stl-containers.md). - -Overloads `operator!=` to compare two objects of class template Container. - -## Syntax - -```cpp -template -bool operator!=( - const Container & left, - const Container & right); -``` - -## Return Value - -Returns `!(left == right)`. - -## See also - -[\](../standard-library/sample-container.md) From 5cf57b3f10aed7fef456974a8c9eb8a510b1263e Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Thu, 5 Mar 2026 18:30:41 -0800 Subject: [PATCH 1689/1799] edit pass: redistributing-microsoft-c++-files --- docs/windows/latest-supported-vc-redist.md | 22 ++++---- docs/windows/redist-version-auditing.md | 12 ++--- .../redistributing-an-atl-application.md | 4 +- ...uting-components-by-using-merge-modules.md | 4 +- .../windows/redistributing-the-mfc-library.md | 8 +-- ...istributing-visual-cpp-activex-controls.md | 4 +- .../redistributing-visual-cpp-files.md | 16 +++--- ...-vc-redistributable-installation-issues.md | 54 +++++++++---------- 8 files changed, 62 insertions(+), 62 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index a70485b2089..3b39b50097b 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -20,7 +20,7 @@ ms.author: msaleh > [!NOTE] > Are you here to download Visual Studio? Go to [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/). -This article is for developers who need to install the Visual C++ Runtime Libraries with their app. If you're trying to fix an app by updating the Visual C++ Runtime Libraries, contact the app vendor for instructions. +This article is for developers who need to install the Visual C++ runtime libraries with their app. If you're trying to fix an app by updating the Visual C++ runtime libraries, contact the app vendor for instructions. To find the download you need, choose your version of Visual Studio from the following table. Each link takes you to the appropriate download section. @@ -39,13 +39,13 @@ To find the download you need, choose your version of Visual Studio from the fol Redistribution is permitted only for licensed Visual Studio users, as described in the [Visual Studio license terms](https://visualstudio.microsoft.com/license-terms/). For details on redistributing Visual C++ files, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). -A Visual C++ Redistributable installs Microsoft C and C++ Runtime Libraries. Many applications built by using Microsoft Visual C++ (MSVC) Build Tools require these libraries. If your app is built by using those libraries, a Microsoft Visual C++ Redistributable Package at least as recent as the build tools used to build your app must be installed on the target system along with the app. +A Visual C++ Redistributable installs Microsoft C and C++ runtime libraries. Many applications built by using Microsoft Visual C++ Build Tools require these libraries. If your app is built by using those libraries, a Microsoft Visual C++ Redistributable Package at least as recent as the build tools used to build your app must be installed on the target system along with the app. The Redistributable package architecture must match your app's target architecture. (You can't install an ARM64 Redistributable on an x86 system or an x64 Redistributable on an x86 system, for example.) We recommend that you use the latest Redistributable available for your version of Visual Studio. ## Visual C++ v14 Redistributable -The following table lists the latest supported Microsoft Visual C++ v14 Redistributable Packages. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created by using MSVC C and C++ Build Tools available in Visual Studio 2017, 2019, 2022, or 2026. +The following table lists the latest supported Microsoft Visual C++ v14 Redistributable Packages. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created by using Microsoft C and C++ Build Tools available in Visual Studio 2017, 2019, 2022, or 2026. Unlike older versions of Visual Studio that have infrequent redistributable updates, the version number isn't listed in the following table for the Visual C++ v14 Redistributable because it's updated frequently. To find the version number of the latest redistributable, download the one you're interested in by using one of the following links. Then, look at its properties by using Windows File Explorer. On the **Details** pane, **File version** contains the version of the redistributable. @@ -57,21 +57,21 @@ Unlike older versions of Visual Studio that have infrequent redistributable upda | X86 | [https://aka.ms/vc14/vc_redist.x86.exe](https://aka.ms/vc14/vc_redist.x86.exe) | Permalink for latest supported x86 version. | | X64 | [https://aka.ms/vc14/vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable Package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | -Download other versions, including long-term servicing channel (LTSC) versions, from [my.visualstudio.com](https://my.visualstudio.com/). +Download other versions, including long-term servicing channel (LTSC) versions, from [Welcome to Dev Essentials](https://my.visualstudio.com/). ### Notes -- Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Sign in by using a Visual Studio subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or to create a free account. select [No account? Create one!](https://my.visualstudio.com/). +- Some of the downloads that are mentioned in this article are currently available on [Welcome to Dev Essentials](https://my.visualstudio.com/). Sign in by using a Visual Studio subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or to create a free account. select [No account? Create one!](https://my.visualstudio.com/). - The Visual C++ v14 Redistributable doesn't have separate packages for different languages. License terms for different languages are available at [Microsoft Software License Terms](https://aka.ms/VCRedistLicense). -- Visual Studio 2017 and later share the same redistributable files. Any apps built by MSVC Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. +- Visual Studio 2017 and later share the same redistributable files. Any apps built by Microsoft Visual C++ Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. - The version of the Redistributable installed on the machine must be the same or later than the version of the MSVC Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determine which dynamic-link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). + The version of the Redistributable installed on the machine must be the same or later than the version of the Microsoft Visual C++ Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determine which dynamic-link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). - The latest version of the Visual C++ v14 Redistributable included with Visual Studio 2026 supports only the following operating systems: * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 - Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. For the latest available version, see the [Visual Studio 2015 (Visual C++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section.
- When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built by using the Visual Studio 2015 MSVC Build Tools. Since Visual Studio 2015 is no longer supported, we recommend that you update your projects to use a supported MSVC Build Tools version and the latest v14 runtime. The Visual C++ Redistributable for 2017, and later, in-place upgrade the Visual C++ 2015 Redistributable (14.0.24212.0). Redistributables for 2013 and earlier remain installed side by side. + When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built by using the Visual Studio 2015 Microsoft Visual C++ Build Tools. Because Visual Studio 2015 is no longer supported, we recommend that you update your projects to use a supported Microsoft Visual C++ Build Tools version and the latest v14 runtime, the Visual C++ Redistributable for 2017, and later, and perform an in-place upgrade to the Visual C++ 2015 Redistributable (14.0.24212.0). Redistributables for 2013 and earlier remain installed side by side. - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). @@ -96,7 +96,7 @@ You can download other versions and languages from [Update for Visual C++ 2013 R ### Other 2013 versions - [Multibyte Microsoft Foundation Class (MFC) Library for Visual Studio 2013](https://my.visualstudio.com/Downloads?pid=1430). This MFC add-on for Visual Studio 2013 contains the multibyte character set (MBCS) version of the MFC Library. -- [Visual C++ 2013 Runtime for sideloaded Windows 8.1 apps](https://download.microsoft.com/download/5/f/0/5f0f8404-9329-44a9-8176-ed6f7f746f25/vclibs_redist_packages.zip). For more information, see [C++ Runtime for sideloaded Windows 8.1 apps](https://devblogs.microsoft.com/cppblog/c-runtime-for-sideloaded-windows-8-1-apps/) on the C++ Team Blog. +- [Visual C++ 2013 Runtime for Sideloaded Windows 8.1 Apps](https://download.microsoft.com/download/5/f/0/5f0f8404-9329-44a9-8176-ed6f7f746f25/vclibs_redist_packages.zip). For more information, see [C++ Runtime for Sideloaded Windows 8.1 Apps](https://devblogs.microsoft.com/cppblog/c-runtime-for-sideloaded-windows-8-1-apps/) on the C++ Team Blog. ### Visual Studio 2012 (VC++ 11.0) Update 4 (no longer supported) @@ -144,8 +144,8 @@ Redistributable files for X86, X64, and IA64 architectures are available from [M ## Related content - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) -- [Audit Visual C++ Runtime version usage](redist-version-auditing.md) -- [Lifecycle FAQ: Visual C++ Redistributable and Runtime Libraries](/lifecycle/faq/visual-c-faq) +- [Audit Visual C++ runtime version usage](redist-version-auditing.md) +- [Lifecycle FAQ: Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) - [Troubleshoot Visual C++ Redistributable installation issues](troubleshoot-vc-redistributable-installation-issues.md) ### Release notes diff --git a/docs/windows/redist-version-auditing.md b/docs/windows/redist-version-auditing.md index 909849f681a..065744b4685 100644 --- a/docs/windows/redist-version-auditing.md +++ b/docs/windows/redist-version-auditing.md @@ -14,7 +14,7 @@ ms.topic: how-to # Audit Visual C++ Runtime version usage -The Microsoft Visual C++ Redistributable and the Visual Studio C++ Runtime (collectively, "VC Runtime") are critical components of many applications. Across your network, machines might still be running applications that install and use an out-of-support version of the VC Runtime. You can use NTFS file auditing to identify such usage as a step toward replacing those applications with ones that use a supported version of the VC Runtime. This article walks you through setting up NTFS file auditing, provides troubleshooting tips, and highlights the benefits of regular audits. +The Microsoft Visual C++ Redistributable and the Visual Studio C++ runtime (collectively, "VC Runtime") are critical components of many applications. Across your network, machines might still be running applications that install and use an out-of-support version of the VC Runtime. You can use NTFS file auditing to identify such usage as a step toward replacing those applications with ones that use a supported version of the VC Runtime. This article walks you through setting up NTFS file auditing, provides troubleshooting tips, and highlights the benefits of regular audits. For more information about the versions of VC Runtime that are no longer supported, see [Microsoft Visual C++ Redistributable latest supported downloads](latest-supported-vc-redist.md). @@ -59,7 +59,7 @@ NTFS file auditing generates [Event 4663: An attempt was made to access an objec 1. Go to the **Security** logs in the **Event Viewer** by expanding **Windows Logs** > **Security**. The results pane lists security events. 1. Find the audit events by choosing **Filter Current Log...** in the **Actions** pane. To narrow down the events to **Event ID 4663 (Audit Success for the File System Category)**, enter **4663** in the **Includes/Excludes Event IDs** text box. -For a File Access Auditing Event 4663 example, see [4663(S): An attempt was made to access an object.](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663). +For a File Access Auditing Event 4663 example, see [4663(S): An attempt was made to access an object](/previous-versions/windows/it-pro/windows-10/security/threat-protection/auditing/event-4663). ### Use PowerShell to audit VC Runtime usage @@ -173,7 +173,7 @@ ResourceAttributes : S:AI After you determine which processes use the VC Runtime files, or which applications installed the Visual C++ Redistributable, uninstall those applications or upgrade them to newer versions that don't depend on unsupported VC Runtimes. -Some Microsoft applications require legacy versions of the VC Runtime. For more information, see the [Visual C++ Redistributable and Runtime Libraries FAQ](/lifecycle/faq/visual-c-faq). +Some Microsoft applications require legacy versions of the VC Runtime. For more information, see the [Visual C++ Redistributable and runtime libraries FAQ](/lifecycle/faq/visual-c-faq). @@ -191,7 +191,7 @@ The following table lists where each version of the VC Runtime is installed. ## Related content -- [Redistribute Visual C++ files](redistributing-visual-cpp-files.md)\ -- [The latest supported Visual C++ downloads](latest-supported-vc-redist.md)\ -- [Lifecycle FAQ: Visual C++ Redistributable and Runtime Libraries](/lifecycle/faq/visual-c-faq)\ +- [Redistribute Visual C++ files](redistributing-visual-cpp-files.md) +- [The latest supported Visual C++ downloads](latest-supported-vc-redist.md) +- [Lifecycle FAQ: Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) diff --git a/docs/windows/redistributing-an-atl-application.md b/docs/windows/redistributing-an-atl-application.md index 17248946533..4159e2fc0b1 100644 --- a/docs/windows/redistributing-an-atl-application.md +++ b/docs/windows/redistributing-an-atl-application.md @@ -16,7 +16,7 @@ If you redistribute an ATL executable application, you must register the `.exe` filename /regserver ``` -Where `filename` is the name of the executable file. +The name of the executable file is `filename`. In Visual Studio 2010, you can build an ATL project for a `MinDependency` or a `MinSize` configuration: @@ -33,7 +33,7 @@ If you redistribute an ATL executable application, you must register the `.exe` filename /regserver ``` -Where `filename` is the name of the executable file. +The name of the executable file is `filename`. ## Related content diff --git a/docs/windows/redistributing-components-by-using-merge-modules.md b/docs/windows/redistributing-components-by-using-merge-modules.md index 814fdfb1822..2313d2bb5d1 100644 --- a/docs/windows/redistributing-components-by-using-merge-modules.md +++ b/docs/windows/redistributing-components-by-using-merge-modules.md @@ -11,7 +11,7 @@ ms.topic: concept-article > [!IMPORTANT] > In Visual Studio 2019 and later, merge modules for Visual C++ Redistributable files are deprecated. We don't recommend that you use them for application deployment. Windows Update can't update redistributable files installed by using merge modules because the detection mechanism depends on knowing details of the installing package. > -> The Visual C++ Redistributable Packages are known for each release, but packages that use MSMs are user generated. Microsoft can't know the details of user-generated packages. Instead, we recommend that you use central deployment of the Visual C++ Redistributable Package. Central deployment installs the redistributable files in the Windows `%SYSTEMROOT%\system32\` folder for use by all applications and users. Central deployment by a redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't break other applications that also use central deployment. +> The Visual C++ Redistributable packages are known for each release, but packages that use merge modules are user generated. Microsoft can't know the details of user-generated packages. Instead, we recommend that you use central deployment of the Visual C++ Redistributable package. Central deployment installs the redistributable files in the Windows `%SYSTEMROOT%\system32\` folder for use by all applications and users. Central deployment by a redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't break other applications that also use central deployment. > > When you use a redistributable package for central deployment, you aren't responsible for tracking and updating the runtime libraries as part of your application maintenance. The Microsoft Update service updates these libraries for you. Otherwise, an update to the runtime library files requires you to update and redeploy your `.msi` installer. Your app could be vulnerable to bugs or security issues until you do. @@ -38,7 +38,7 @@ When you use merge modules, you must track and regularly service your applicatio ## Where to find merge module files -In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ installation in Visual Studio 2017 and Visual Studio 2015. When the merge modules are installed in Visual Studio 2022, you can find the Visual C++ Redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. +In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named *C++ \ Redistributable merge modules* in the Visual Studio Installer. The merge modules are installed by default as part of a C++ installation in Visual Studio 2017 and Visual Studio 2015. When the merge modules are installed in Visual Studio 2022, you can find the Visual C++ Redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. In the latest version of Visual Studio 2019, the merge modules are in `%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`. In both Visual Studio 2019 and Visual Studio 2017, they're also found in `%VCToolsRedistDir%MergeModules`. In Visual Studio 2015, they're found in `Program Files [(x86)]\Common Files\Merge Modules`. For more information and a link to a list of redistributable merge modules, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). diff --git a/docs/windows/redistributing-the-mfc-library.md b/docs/windows/redistributing-the-mfc-library.md index b069e2558c4..801828f66f9 100644 --- a/docs/windows/redistributing-the-mfc-library.md +++ b/docs/windows/redistributing-the-mfc-library.md @@ -14,13 +14,13 @@ If you dynamically link your application to the Microsoft Foundation Class (MFC) > [!NOTE] > The `mfc140.dll` files were omitted from the redistributable files directory in Visual Studio 2015 RTM. You can use the versions installed by Visual Studio 2015 in the `Windows\system32 and Windows\syswow64` directories instead. -Because all MFC DLLs use the shared version of the Microsoft C Runtime (CRT) Library, you might also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the Universal CRT Library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. +Because all MFC DLLs use the shared version of the Microsoft C runtime library, you might also need to redistribute the C runtime. The version of MFC that ships with Visual Studio 2015 uses the Universal C runtime library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal C runtime. -For information on how to redistribute the Universal CRT as an operating system component or by using local deployment, see [Introducing the Universal CRT](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the Universal CRT for central deployment on supported versions of Windows, see [Windows 10 Universal C Runtime](https://www.microsoft.com/download/details.aspx?id=48234). +For information on how to redistribute the Universal C runtime as an operating system component or by using local deployment, see [Introducing the Universal C runtime](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the Universal C runtime for central deployment on supported versions of Windows, see [Windows 10 Universal C runtime](https://www.microsoft.com/download/details.aspx?id=48234). You can find redistributable architecture-specific versions of `ucrtbase.dll` for local deployment in the Windows SDK. By default, Visual Studio installs these versions in `C:\Program Files (x86)\Windows Kits\10\Redist\ucrt\DLLs\` in an architecture-specific subdirectory. -If your app is built by using an earlier version of the MFC Library, you must redistribute the matching CRT DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the `msvcr120.dll`. You also have to redistribute the matching `mfcu.dll` or `mfc.dll`. +If your app is built by using an earlier version of the MFC Library, you must redistribute the matching C runtime DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the `msvcr120.dll`. You also have to redistribute the matching `mfcu.dll` or `mfc.dll`. If you statically link your application to MFC (in the **Property Pages** dialog, on the **General** tab, select **Use MFC in a Static Library**), you don't have to redistribute an MFC DLL. Although static linking might work for testing and internal deployment of applications, we recommend that you don't use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choose a deployment method](choosing-a-deployment-method.md). @@ -30,7 +30,7 @@ If your application uses the MFC database classes (for example, [CRecordset clas If your MFC application uses Windows Forms controls, you must redistribute `mfcmifc80.dll` with your application. This DLL is a strong-name-signed .NET assembly. You can redistribute it with an application in its application local folder. You can also deploy it to the Global Assembly Cache (GAC) by using the [Gacutil.exe (Global Assembly Cache Tool)](/dotnet/framework/tools/gacutil-exe-gac-tool). -If you redistribute an MFC DLL, make sure to redistribute the retail version and not the debug version. Debug versions of the DLLs aren't redistributable. The names of debug versions of the MFC DLLs end with a "d", for example, `Mfc140d.dll`. +If you redistribute an MFC DLL, make sure to redistribute the retail version and not the debug version. Debug versions of the DLLs aren't redistributable. The names of debug versions of the MFC DLLs end with a "d"; for example, `Mfc140d.dll`. You can redistribute MFC by using either `VCRedist_*architecture*.exe` or merge modules that are installed with Visual Studio. You can also deploy the MFC DLL to the same folder as your application. For more information about how to redistribute MFC, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). diff --git a/docs/windows/redistributing-visual-cpp-activex-controls.md b/docs/windows/redistributing-visual-cpp-activex-controls.md index 93b6d3156bf..f28e3df2398 100644 --- a/docs/windows/redistributing-visual-cpp-activex-controls.md +++ b/docs/windows/redistributing-visual-cpp-activex-controls.md @@ -15,7 +15,7 @@ Visual C++ 6.0 supplies ActiveX controls that you can use in applications that y For a list of the redistributable Visual C++ 6.0 ActiveX controls, see `Common\Redist\Redist.txt` on Disc 1 of the Visual C++ 6.0 product CD. -When you distribute applications, you must install and register the `.ocx` for the ActiveX control (by using `Regsvr32.exe`). The target computer also must have current versions of the following system files (an asterisk indicates that the file must be registered): +When you distribute applications, you must install and register the `.ocx` for the ActiveX control (by using `Regsvr32.exe`). The target computer also must have current versions of the following system files. (An asterisk indicates that the file must be registered.) - `Asycfilt.dll` - `Comcat.dll`\* @@ -29,7 +29,7 @@ When you use an ActiveX control that connects to a database, you also need to re Some redistributable ActiveX controls have more dependencies. For each `.ocx` file in the Os\System folder on the Visual C++ 6.0 product CD, there's also a `.dep` file. For each `.ocx` file that you want to redistribute, look for one or more USES entries in the corresponding `.dep` file. -If a file is listed, you must ensure that the file is on the target computer. Any DLLs directly supporting an `.ocx` file must be registered. (For `Regsvr32.exe` to succeed, the target computer must first contain all the DLLs that the control statically loads.) Furthermore, if a DLL that's listed as a dependency also has a `.dep` file in the Os\System folder on the Visual C++ 6.0 CD, you must also investigate that `.dep` file for USES entries. +If a file is listed, you must ensure that the file is on the target computer. Any DLLs directly supporting an `.ocx` file must be registered. (For `Regsvr32.exe` to succeed, the target computer must first contain all the DLLs that the control statically loads.) Also, if a DLL that's listed as a dependency also has a `.dep` file in the Os\System folder on the Visual C++ 6.0 CD, you must also investigate that `.dep` file for USES entries. ## Related content diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 0cc082395f7..348b9d564ad 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -8,13 +8,13 @@ ms.topic: concept-article # Redistribute Visual C++ files > [!NOTE] -> Are you here because you're looking for a download of one of the Visual C++ Runtime files? Go to the [latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) page. +> Are you here because you're looking for a download of one of the Visual C++ runtime files? Go to the [latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) page. ## Redistributable files and licensing -Distribution of the Visual C++ Runtime Redistributable Package, merge modules, and individual binaries is limited to licensed Visual Studio users and is subject to Microsoft Software License Terms. +Distribution of the Visual C++ Runtime Redistributable package, merge modules, and individual binaries is limited to licensed Visual Studio users and is subject to Microsoft Software License Terms. -When you deploy an application, you must also deploy the files that are required to support it. If any of these files are provided by Microsoft, check whether you're permitted to redistribute them. You can find a link to the Visual Studio license terms in the IDE. In the **About Microsoft Visual Studio** dialog, select the **License Terms** link. You can also download the relevant Microsoft Software License Terms and licenses from the Visual Studio [License Directory](https://visualstudio.microsoft.com/license-terms/). +When you deploy an application, you must also deploy the files that are required to support it. If Microsoft provides any of these files, check whether you're permitted to redistribute them. You can find a link to the Visual Studio license terms in the IDE. In the **About Microsoft Visual Studio** dialog, select the **License Terms** link. You can also download the relevant Microsoft Software License Terms and licenses from the Visual Studio [License Directory](https://visualstudio.microsoft.com/license-terms/). ::: moniker range="msvc-170" @@ -48,15 +48,15 @@ To deploy redistributable files, you can use the redistributable packages instal The easiest way to locate the redistributable files is by using environment variables set in a developer command prompt. In Visual Studio 2022, the redistributable files are in the `%VCINSTALLDIR%Redist\MSVC\v143` folder. In the latest version of Visual Studio 2019, you can find the redistributable files in the `%VCINSTALLDIR%Redist\MSVC\v142` folder. In both Visual Studio 2017 and Visual Studio 2019, the files are also found in `%VCToolsRedistDir%`. In Visual Studio 2015, you can find these files in `%VCINSTALLDIR%redist\`, where `` is the locale of the redistributable packages. -In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named Visual C++ \ Redistributable MSMs in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When they're installed in Visual Studio 2022, you can find the redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. - +In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named Visual C++ \ Redistributable merge modules in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When they're installed in Visual Studio 2022, you can find the redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. +` In the latest version of Visual Studio 2019, the redistributable merge modules are found in `%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`. In both Visual Studio 2019 and Visual Studio 2017, they're also found in `%VCToolsRedistDir%MergeModules`. In Visual Studio 2015, they're found in `Program Files [(x86)]\Common Files\Merge Modules`. ## Install the redistributable packages -The Visual C++ Redistributable Packages install and register all Visual C++ libraries. If you use one, run it as a prerequisite on the target system before you install your application. We recommend that you use these packages for your deployments because they enable automatic updating of the Visual C++ libraries. For an example that shows how to use these packages, see [Walkthrough: Deploy a Visual C++ application by using the Visual C++ Redistributable Package](deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md). +The Visual C++ Redistributable packages install and register all Visual C++ libraries. If you use one, run it as a prerequisite on the target system before you install your application. We recommend that you use these packages for your deployments because they enable automatic updating of the Visual C++ libraries. For an example that shows how to use these packages, see [Walkthrough: Deploy a Visual C++ application by using the Visual C++ Redistributable package](deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md). -Each Visual C++ Redistributable Package checks for the existence of a more recent version on the machine. If a more recent version is found, the package isn't installed. In Visual Studio 2015 or later, redistributable packages display an error message stating that setup failed. If a package uses the `/quiet` flag to run, no error message appears. In either case, the Microsoft installer logs the error, and an error result is returned to the caller. +Each Visual C++ Redistributable package checks for the existence of a more recent version on the machine. If a more recent version is found, the package isn't installed. In Visual Studio 2015 or later, redistributable packages display an error message stating that setup failed. If a package uses the `/quiet` flag to run, no error message appears. In either case, the Microsoft installer logs the error, and an error result is returned to the caller. In Visual Studio 2015 and later, you can avoid this error by checking the registry to find out if a more recent version is installed. The current installed version number is stored in the `HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes\{x86|x64|arm64}` key. @@ -79,7 +79,7 @@ vc_redist.x64.exe /install /passive /norestart ## Install the redistributable merge modules > [!IMPORTANT] -> Merge modules (`.msm` files) for Visual C++ Redistributable files are deprecated. We don't recommend that you use them for application deployment. Instead, we recommend central deployment of the Visual C++ Redistributable Package. Central deployment by a redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't affect other applications that also use central deployment. +> Merge modules (`.msm` files) for Visual C++ Redistributable files are deprecated. We don't recommend that you use them for application deployment. Instead, we recommend central deployment of the Visual C++ Redistributable package. Central deployment by a redistributable package makes it possible for Microsoft to service runtime library files independently. An uninstall of your app can't affect other applications that also use central deployment. > > When you use a redistributable package for central deployment, you aren't responsible for tracking and maintaining the runtime libraries. Otherwise, an update to the runtime library files requires you to update and redeploy your *`.msi`* installer. Your app could be vulnerable to bugs or security issues until you do. diff --git a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md index f0f3195aff1..0fb42c9dad1 100644 --- a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md +++ b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md @@ -1,21 +1,21 @@ --- -title: Troubleshoot Visual C++ Redistributable Installation Issues -description: This article provides steps to help you diagnose and resolve issues when you install the Visual C++ Redistributable. +title: Troubleshoot Visual C++ Redistributable Installation Problems +description: This article provides steps to help you diagnose and resolve problems when you install the Visual C++ Redistributable. author: vicroms ms.author: viromer ms.date: 02/12/2026 ms.topic: troubleshooting-general helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC Redist" ] --- -# Troubleshoot Visual C++ Redistributable installation issues +# Troubleshoot Visual C++ Redistributable installation problems -This article is for users who experience issues when they install Visual C++ Runtime components by using the Visual Studio Installer or the Visual C++ Redistributable (VC Redist) installer. +This article is for users who experience problems when they install Visual C++ runtime components by using the Visual Studio Installer or the Visual C++ Redistributable (VC Redist) installer. -If you experience any issues, make sure that you're installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). +If you experience any problems, make sure that you're installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). ## Collect failure logs -The first step to diagnose an issue with the Visual C++ Redistributable installer is to collect its failure logs. +The first step to diagnose an problem with the Visual C++ Redistributable installer is to collect its failure logs. 1. Download the [Microsoft Visual Studio and .NET Log Collection Tool](). 1. Run `Collect.exe`. @@ -23,11 +23,11 @@ The first step to diagnose an issue with the Visual C++ Redistributable installe After you extract `vscollect.zip`, the VC Redist logs are located inside the `Temp` folder. The relevant log files are prefixed with the pattern `dd_vcredist__yyyyMMddHHmmss`. -Search the VC Redist logs for terms like "Error," "Failed," or "System Error," and consult the [Common errors at a glance](#common-errors-at-a-glance) section to identify the issue. +Search the VC Redist logs for terms like "Error," "Failed," or "System Error," and consult the [Common errors at a glance](#common-errors-at-a-glance) section to identify the problem. ### Other log locations -The VC Redist installer is often executed as a prerequisite of other products. In such cases, you might find the installation log in a different path. +The VC Redist installer is often run as a prerequisite of other products. In such cases, you might find the installation log in a different path. For example, [Configuration Manager](/intune/configmgr/core/understand/introduction) upgrades VC Redist as part of its own upgrade process by running `vcredist_x64.exe` with the `/l` option that overrides the default log location. @@ -47,7 +47,7 @@ In such cases, you can find the path to the logs by reading that product's own l ## General troubleshooting steps when using the Visual C++ Redistributable installer -This section describes general troubleshooting methods that you can try to resolve issues with the VC Redist installer. +This section describes general troubleshooting methods that you can try to resolve problems with the VC Redist installer. ### Disable antivirus software temporarily @@ -70,7 +70,7 @@ File-access failures are heavily correlated with insufficient permissions. ### Check for Windows updates -On rare occasions, outdated system components can cause installation issues. +On rare occasions, outdated system components can cause installation problems. 1. Go to Windows Update and install all pending updates. 1. Reboot your PC. @@ -81,7 +81,7 @@ On rare occasions, outdated system components can cause installation issues. ### Manually install Visual C++ Redistributable > [!NOTE] -> The Visual Studio Installer might prompt for a reboot when VC Redist is installed separately. +> The Visual Studio Installer might prompt for a restart when VC Redist is installed separately. 1. Download the [latest VC Redist installer](latest-supported-vc-redist.md). 1. Run the VC Redist installer. @@ -115,7 +115,7 @@ This method helps if the installer metadata is corrupted. Deleting the installer 1. Delete the folder `C:\Program Files (x86)\Microsoft Visual Studio\Installer`. You might be prompted to run this operation as an administrator. 1. Run `VisualStudioSetup.exe`. -## Common issues +## Common problems ### Common errors at a glance @@ -127,16 +127,16 @@ This method helps if the installer metadata is corrupted. Deleting the installer ### Generic installation failure -Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ Runtime components. +Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ runtime components. -Because many factors can produce a 1603 code, the code by itself doesn't provide enough information to diagnose the cause of the issue. Often, the log files produced by the VC Redist installer contain relevant information that might lead to a solution or workaround. +Because many factors can produce a 1603 code, the code by itself doesn't provide enough information to diagnose the cause of the problem. Often, the log files produced by the VC Redist installer contain relevant information that might lead to a solution or workaround. -The [Common issues](#common-issues) section describes examples of how to diagnose common installation errors and steps that might resolve them. -If your issue isn't found here, follow the instructions to [report an issue in the Visual C++ Redistributable installer](#report-a-visual-c-redistributable-installation-problem). +The [Common problems](#common-problems) section describes examples of how to diagnose common installation errors and steps that might resolve them. +If your problem isn't found here, follow the instructions to [report a problem in the Visual C++ Redistributable installer](#report-a-visual-c-redistributable-installation-problem). ### Access denied -Installation fails with error code 5. This error code typically indicates a permissions issue. Specifically, the issue is access denied. +Installation fails with error code 5. This error code typically indicates a permissions problem. Specifically, the problem is access denied. #### Steps to resolve @@ -159,13 +159,13 @@ If the installation fails, try to restart your PC to release any locked files. ### Corrupt or invalid installer package -Installation fails with error code 1620. This error code indicates that a Windows Installer package (MSI) couldn't be opened. The issue is likely because of corruption or invalid files. +Installation fails with error code 1620. This error code indicates that a Windows Installer package (MSI) couldn't be opened. The problem is likely because of corruption or invalid files. The presence of these error messages indicates a corrupted cache. - **Error code 1620**: Indicates that the Windows Installer package couldn't be opened. - **Error code 0x80091007**: Indicates that several payloads failed verification because of hash mismatches. -- **Error code 0x80070654**: Occurs when an MSI package fails to execute. +- **Error code 0x80070654**: Occurs when an MSI package fails to run. #### Steps to resolve @@ -208,11 +208,11 @@ Error 1714. The older version of Microsoft Visual C++ 2022 X64 Minimum Runtime - #### Steps to resolve -From the log files, make a note of the VC Redist version causing the issue. Two methods are available to resolve the issue: +From the log files, make a note of the VC Redist version causing the problem. Two methods are available to resolve the problem: - **Method 1:** Use the Windows Installer. - 1. Try using the Windows Installer to manually remove the old VC Redist version. If prompted, let the Windows Installer Troubleshooter attempt to fix the issue. + 1. Try using the Windows Installer to manually remove the old VC Redist version. If prompted, let the Windows Installer Troubleshooter attempt to fix the problem. 1. Retry the installation. - **Method 2:** Manually remove the old version. @@ -243,22 +243,22 @@ You might be able to find installers for older versions through a Bing search. O ## Report a Visual C++ Redistributable installation problem -The list of [common issues](#common-issues) was collected from feedback reported to Microsoft through the [Developer Community](). +The list of [common problems](#common-problems) was collected from feedback reported to Microsoft through the [Developer Community](). -If you encounter an issue not found in that section, or if the steps in this troubleshooting guide don't resolve your issue, use the [Report a Problem]() form to create a new feedback item. +If you encounter an problem not found in that section, or if the steps in this troubleshooting guide don't resolve your problem, use the [Report a Problem]() form to create a new feedback item. Your report must include the following information about your environment: - The version of VC Redist you're trying to install. - If you're upgrading, the version of previously installed VC Redist installations. - If you're installing through the Visual Studio Installer, the version of the Visual Studio Installer. -- The logs collected by following the steps in the [Collect failure logs](#collect-failure-logs) section. +- The logs collected when you follow the steps in the [Collect failure logs](#collect-failure-logs) section. -Feedback without this information, especially without logs, is nonactionable and might be closed if more information isn't submitted promptly. +Feedback without this information, especially without logs, is non-actionable and might be closed if more information isn't submitted promptly. ## Related content - [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) -- [Audit Visual C++ Runtime version usage](redist-version-auditing.md) -- [Lifecycle FAQ: Visual C++ Redistributable and Runtime Libraries](/lifecycle/faq/visual-c-faq) +- [Audit Visual C++ runtime version usage](redist-version-auditing.md) +- [Lifecycle FAQ: Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) From 45d8529b190b2439a66618167583243b07fd7a93 Mon Sep 17 00:00:00 2001 From: ChanPark Date: Thu, 5 Mar 2026 22:37:22 -0800 Subject: [PATCH 1690/1799] Revise screenshots --- docs/embedded/media/serial-monitor-vscode.png | Bin 30294 -> 45810 bytes docs/embedded/media/serial-monitor.png | Bin 28291 -> 27462 bytes docs/embedded/serial-monitor.md | 41 ++++++------------ 3 files changed, 14 insertions(+), 27 deletions(-) diff --git a/docs/embedded/media/serial-monitor-vscode.png b/docs/embedded/media/serial-monitor-vscode.png index 29a6c931e11e5f04eda11626da1373f233ce1fe1..08c640ae17ed27357af7fc4b09b15d96fb3db95b 100644 GIT binary patch literal 45810 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 r0TfNXdsd)RoOjHl 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 RlHUS8FI2RZYZPC-|9?jNNlO3# literal 30294 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 diff --git a/docs/embedded/media/serial-monitor.png b/docs/embedded/media/serial-monitor.png index e247eef5e74d46d6d2facf694a69ae6b056546d6..633e19edd21760ad590724eb663020b659ae916f 100644 GIT binary patch literal 27462 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 literal 28291 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%0Df|>ST^x_-EN$+!ktA4RPfj|MbDilidKu`Rom{X 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 **Manage Extensions**. Search for **Serial Monitor 2** in the extensions marketplace. Select **Install** and then restart Visual Studio to complete the installation. -:::image type="complex" source="./media/serial-monitor.png" alt-text="Screenshot of the Visual Studio Serial Monitor window."::: -The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section shows the messages, consisting of four lines of the text Hello, World! -:::image-end::: +To activate the Serial Monitor window, select **Tools** from the menu bar and then choose **Serial Monitor 2**. + +:::image type="content" source="media/serial-monitor.png" alt-text="Screenshot of the Visual Studio Serial Monitor window."::: ## Capabilities -- **Monitor a serial port**: Choose the **Start Monitoring** or **Stop Monitoring** button to control whether to monitor data coming from the port. -- **Send data to a serial port**: Enter text into the text field at the bottom of the view. Use the **Enter** key or choose the **Send Message** arrow button to send the data. -- **Clear the Serial Monitor output**: Choose the **Clear Output** button to clear the incoming data text field. -- **Send preset control signals**: Use the split-button next to the input field to send preset control signals (Ctrl+C, Ctrl+D, Ctrl+X, and Ctrl+Z). +- **Send data to a serial port**: Enter text into the **Command** text field at the bottom of the view. Select **Send** to send the data. - **Configure Serial Monitor and port connection settings**: See the following table to learn about the settings that the Serial Monitor provides. ## Configurable settings @@ -33,28 +30,20 @@ The window is split into two sections. The top section shows the monitoring mode | Settings | Description | Usage | Available options | |--|--|--|--| | **Port** | Ports that are actively connected to a device | Use the **Port** dropdown | Serial port compatible devices connected to the machine | -| **Baud Rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud Rate** dropdown | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 | -| **Line Ending** | The line ending to use in messages sent to the connected device | Use the **Line Ending** dropdown | None, LF, CR, CRLF | -| **Timestamp** | Adds timestamps to the output of data received from the connected port | Use the **timestamp** toggle button | On/Off | -| **Autoscroll** | Whether to auto-scroll new content that comes from the connected port | Use the **autoscroll** toggle button | On/Off | -| **Automatic Reconnection** | Allows for automatic reconnection and monitoring of disconnected selected ports | Use the **automatic reconnection** toggle button in **Serial** mode | On/Off | -| **Message Encoding** | Can select type of encoding for messages sent to serial port | Use the **message encoding** dropdown in **Serial** mode | Text (utf8), Hex, Binary | +| **Baud rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud Rate** dropdown | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 | +| **Encoding** | Can select type of encoding for messages sent to serial port | Use the **Encoding** dropdown in **Serial** mode | Text (utf8), Hex, Binary | | **Data bits** | Can select how many data bits are used for the serial port connection | Use the **Data bits** dropdown in the **additional settings** | 5, 6, 7, 8 | | **Stop bits** | Can select how many stop bits are used for the serial port connection | Use the **Stop bits** dropdown in the **additional settings** | 1, 1.5, 2 | | **Parity** | Can select what parity is used for the serial port connection | Use the **Parity** dropdown in the **additional settings** | None, Odd, Even, Mark, Space | -| **File Logging** | Allows the ability to log output to a file | Use the **file logging** toggle button, as well as the **Choose Log File Directory** button to choose the desired directory in the **additional settings** | On/Off | +| **File Logging** | Allows the ability to log output to a file | Use the **file logging** toggle button, as well as the **Record file path** button to choose the desired directory | On/Off | # [Visual Studio Code](#tab/visual-studio-code) To install Serial Monitor in Visual Studio Code, open the extensions marketplace and then search for **Serial Monitor**. Select **Install**. -:::image type="complex" source="./media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window."::: -The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section where messages are displayed is empty. -:::image-end::: +To activate the Serial Monitor window, select **Terminal** from the menu bar and choose **New Terminal**. Then select **Serial Monitor** from the tabs. -:::image type="complex" source="./media/serial-monitor-vscode-tcp.png" alt-text="Screenshot of the VS Code TCP Serial Monitor window."::: -The window is split into two sections. The top section shows the monitoring mode (TCP), Host (::1), Port (1234), and a Start monitoring button. The bottom section shows the messages, starting with "Opening the TCP connection on ::1:1234. Then Connected to ::1:1234. Then five lines of the text Hello, World!. Then Closed the TCP connection ::1:1234. -:::image-end::: +:::image type="content" source="media/media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window."::: ## Capabilities @@ -65,15 +54,13 @@ The window is split into two sections. The top section shows the monitoring mode - **Clear the Serial Monitor output**: Choose the **Clear Output** button to clear the incoming data text field. - **Send preset control signals**: Use the split-button next to the input field to send preset control signals (Ctrl+C, Ctrl+D, Ctrl+X, and Ctrl+Z). - **Configure Serial Monitor and connection settings**: See the following table to learn about the settings that the Serial Monitor provides. -- **Clear the Serial Monitor output**: Choose the **Clear Output** button to clear the incoming data text field. -- **Send preset control signals**: Use the split-button next to the input field to send preset control signals (Ctrl+C, Ctrl+D, Ctrl+X, and Ctrl+Z). ## Configurable settings | Settings | Description | Usage | Available options | |--|--|--|--| | **Port** | Ports that are actively connected to a device | Use the **Port** dropdown in **Serial** mode | Serial port compatible devices connected to the machine | -| **Baud Rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud Rate** dropdown in **Serial** mode | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 | +| **Baud rate** | Frequency at which the monitor attempts to communicate with the connected device | Use the **Baud rate** dropdown in **Serial** mode | 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 74880, 115200, 230000, 250000 | | **Host** | Name of your host address | Use the **Host** text box to enter your host name in **TCP** mode | Any string that matches a valid host | | **Port** | The port number of your address | Use the **Port** text box in **TCP** mode | Any valid TCP port | | **Line Ending** | The line ending to use in messages sent to the connected device | Use the **Line Ending** dropdown in **Serial** mode | None, LF, CR, CRLF | @@ -81,13 +68,13 @@ The window is split into two sections. The top section shows the monitoring mode | **RTS** | Allows the RTS COM output line to be manually set | Use the **RTS** checkbox | True/False | | **Timestamp** | Adds timestamps to the output of data received from the connected port | Use the **timestamp** toggle button | On/Off | | **Autoscroll** | Whether to auto-scroll new content that comes from the connected port | Use the **autoscroll** toggle button | On/Off | -| **Automatic Reconnection** | Allows for automatic reconnection and monitoring of disconnected selected ports | Use the **automatic reconnection** toggle button | On/Off| -| **Message Echoing** | Allows the ability to echo/not echo messages you send | Use the **message echoing** toggle button | On/Off | -| **Message Encoding** | Can select type of encoding for messages sent to serial port | Use the **message encoding** dropdown | Text (utf8), Hex, Binary | +| **Automatic reconnection** | Allows for automatic reconnection and monitoring of disconnected selected ports | Use the **automatic reconnection** toggle button | On/Off| +| **Message echoing** | Allows the ability to echo/not echo messages you send | Use the **message echoing** toggle button | On/Off | +| **Message encoding** | Can select type of encoding for messages sent to serial port | Use the **message encoding** dropdown | Text (utf8), Hex, Binary | | **Data bits** | Can select how many data bits are used for the serial port connection | Use the **Data bits** dropdown in the **additional settings** | 5, 6, 7, 8 | | **Stop bits** | Can select how many stop bits are used for the serial port connection | Use the **Stop bits** dropdown in the **additional settings** | 1, 1.5, 2 | | **Parity** | Can select what parity is used for the serial port connection | Use the **Parity** dropdown in the **additional settings** | None, Odd, Even, Mark, Space | -| **File Logging** | Allows the ability to log output to a file | Use the **file logging** toggle button, as well as the **Choose Log File Directory** button to choose the desired directory in the **additional settings** | On/Off | +| **File logging** | Allows the ability to log output to a file | Use the **file logging** toggle button, as well as the **Choose Log File Directory** button to choose the desired directory in the **additional settings** | On/Off | | **Serial Wire Output (SWO)** | Can enable Serial Wire Output (SWO) decoding | Use the **Serial Wire Output** toggle in the **additional settings** in **TCP** mode | On/Off | --- From 1806c960ad63b76881bae14c4a1b029b10a8be8e Mon Sep 17 00:00:00 2001 From: Michael Price Date: Fri, 6 Mar 2026 10:18:56 -0600 Subject: [PATCH 1691/1799] Fixing a couple more instances where 'app' appeared in the text. --- docs/porting/copilot-modernization-cpp.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/porting/copilot-modernization-cpp.md b/docs/porting/copilot-modernization-cpp.md index aed4b2a0eac..d220de274d8 100644 --- a/docs/porting/copilot-modernization-cpp.md +++ b/docs/porting/copilot-modernization-cpp.md @@ -7,7 +7,7 @@ author: michaelbprice ms.author: miprice --- -# Using GitHub Copilot app modernization for C++ +# Using GitHub Copilot modernization for C++ GitHub Copilot modernization for C++ helps you upgrade C++ projects to newer MSVC Build Tools versions. If necessary, Copilot will upgrade your project's settings to use the latest MSVC, and then conduct a thorough assessment of the impact of those changes after executing a build. It develops a plan on how to address each identified problem. Once you approve the plan, the agent completes a sequence of tasks and validates that any changes resolved the identified problems. If there remains work to be done, the agent continues iterating until the problems are resolved or you discontinue the conversation. @@ -49,7 +49,7 @@ GitHub Copilot modernization is an agent that operates inside the GitHub Copilot #### For MSBuild-based codebases targeting an earlier version of MSVC Build Tools -The first time that you load a `.vcxproj` project that targets an earlier version of the MSVC Build Tools, you see an option to [upgrade project settings to use a newer version of the MSVC Build Tools](/visualstudio/install/setup-assistant). If you retarget any of your projects to a new version of MSVC Build Tools and GitHub Copilot app modernization for C++ is enabled, you receive an infobar in Visual Studio prompting you to use GitHub Copilot modernization for C++ to resolve any newly introduced build problems. Selecting **Run GitHub Copilot modernization for C++** launches the GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. +The first time that you load a `.vcxproj` project that targets an earlier version of the MSVC Build Tools, you see an option to [upgrade project settings to use a newer version of the MSVC Build Tools](/visualstudio/install/setup-assistant). If you retarget any of your projects to a new version of MSVC Build Tools and GitHub Copilot modernization for C++ is enabled, you receive an infobar in Visual Studio prompting you to use GitHub Copilot modernization for C++ to resolve any newly introduced build problems. Selecting **Run GitHub Copilot modernization for C++** launches the GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. ### Start the upgrade From d7497dd1ab8da51fd1cca7309243b80a9ff565a9 Mon Sep 17 00:00:00 2001 From: ChanPark Date: Fri, 6 Mar 2026 09:46:07 -0800 Subject: [PATCH 1692/1799] Fix typo --- docs/embedded/serial-monitor.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/embedded/serial-monitor.md b/docs/embedded/serial-monitor.md index 0479a785f13..8f396f4e72c 100644 --- a/docs/embedded/serial-monitor.md +++ b/docs/embedded/serial-monitor.md @@ -41,9 +41,9 @@ To activate the Serial Monitor window, select **Tools** from the menu bar and th To install Serial Monitor in Visual Studio Code, open the extensions marketplace and then search for **Serial Monitor**. Select **Install**. -To activate the Serial Monitor window, select **Terminal** from the menu bar and choose **New Terminal**. Then select **Serial Monitor** from the tabs. +To activate the Serial Monitor window, select **Terminal** from the menu bar and choose **New Terminal**. Then, select **Serial Monitor** from the tabs. -:::image type="content" source="media/media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window."::: +:::image type="content" source="media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window."::: ## Capabilities From bc511250ff125d722ac9530cc4ffcf5c57822f75 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 6 Mar 2026 11:19:16 -0800 Subject: [PATCH 1693/1799] cleanup --- .../ostream-iterator-class.md | 76 ++++++----- .../ostreambuf-iterator-class.md | 124 +++++++++--------- 2 files changed, 105 insertions(+), 95 deletions(-) diff --git a/docs/standard-library/ostream-iterator-class.md b/docs/standard-library/ostream-iterator-class.md index d3979aaccf5..ba6eb7c7afc 100644 --- a/docs/standard-library/ostream-iterator-class.md +++ b/docs/standard-library/ostream-iterator-class.md @@ -35,31 +35,31 @@ The ostream_iterator class must satisfy the requirements for an output iterator. |Constructor|Description| |-|-| -|[ostream_iterator](#ostream_iterator)|Constructs an `ostream_iterator` that is initialized and delimited to write to the output stream.| +|[`ostream_iterator`](#ostream_iterator)|Constructs an `ostream_iterator` that is initialized and delimited to write to the output stream.| ### Typedefs |Type name|Description| |-|-| -|[char_type](#char_type)|A type that provides for the character type of the `ostream_iterator`.| -|[ostream_type](#ostream_type)|A type that provides for the stream type of the `ostream_iterator`.| -|[traits_type](#traits_type)|A type that provides for the character traits type of the `ostream_iterator`.| +|[`char_type`](#char_type)|A type that provides for the character type of the `ostream_iterator`.| +|[`ostream_type`](#ostream_type)|A type that provides for the stream type of the `ostream_iterator`.| +|[`traits_type`](#traits_type)|A type that provides for the character traits type of the `ostream_iterator`.| ### Operators |Operator|Description| |-|-| -|[operator*](#op_star)|Dereferencing operator used to implement the output iterator expression \* `i` = `x`.| -|[operator++](#op_add_add)|A nonfunctional increment operator that returns an `ostream_iterator` to the same object it addressed before the operation was called.| -|[operator=](#op_eq)|Assignment operator used to implement the output iterator expression \* `i` = `x` for writing to an output stream.| +|[`operator*`](#op_star)|Dereferencing operator used to implement the output iterator expression `*i = x`.| +|[`operator++`](#op_add_add)|A nonfunctional increment operator that returns an `ostream_iterator` to the same object it addressed before the operation was called.| +|[`operator=`](#op_eq)|Assignment operator used to implement the output iterator expression `*i = x` for writing to an output stream.| ## Requirements **Header:** \ -**Namespace:** std +**Namespace:** `std` -## ostream_iterator::char_type +## `ostream_iterator::char_type` A type that provides for the character type of the iterator. @@ -108,9 +108,9 @@ by intOut are: */ ``` -## ostream_iterator::operator* +## `ostream_iterator::operator*` -Dereferencing operator used to implement the output iterator expression \* *ii* = *x*. +Dereferencing operator used to implement the output iterator expression `*ii = x`. ```cpp ostream_iterator& operator*(); @@ -149,15 +149,16 @@ int main( ) *intOut = 20; *intOut = 30; } -/* Output: +``` + +```output Elements written to output stream: 10 20 30 -*/ ``` -## ostream_iterator::operator++ +## `ostream_iterator::operator++` A nonfunctional increment operator that returns an `ostream_iterator` to the same object it addressed before the operation was called. @@ -199,17 +200,18 @@ int main( ) *intOut = 20; *intOut = 30; } -/* Output: +``` + +```output Elements written to output stream: 10 20 30 -*/ ``` -## ostream_iterator::operator= +## `ostream_iterator::operator=` -Assignment operator used to implement the output_iterator expression \* `i` = `x` for writing to an output stream. +Assignment operator used to implement the output_iterator expression `*i = x` for writing to an output stream. ```cpp ostream_iterator& operator=(const Type& val); @@ -217,16 +219,16 @@ ostream_iterator& operator=(const Type& val); ### Parameters -*val*\ +*`val`*\ The value of the object of type `Type` to be inserted into the output stream. ### Return Value -The operator inserts *val* into the output stream associated with the object, followed by the delimiter specified in the [ostream_iterator constructor](#ostream_iterator) (if any), and then returns a reference to the `ostream_iterator`. +The operator inserts *`val`* into the output stream associated with the object, followed by the delimiter specified in the [`ostream_iterator` constructor](#ostream_iterator) (if any), and then returns a reference to the `ostream_iterator`. ### Remarks -The requirements for an output iterator that the `ostream_iterator` must satisfy require only the expression \* `ii` = `t` be valid and says nothing about the operator or the operator= on their own. This member operator returns **`*this`**. +The requirements for an output iterator that the `ostream_iterator` must satisfy require only the expression `*ii = t` be valid and says nothing about the `operator*` or the `operator=` on their own. This member operator returns **`*this`**. ### Example @@ -253,15 +255,16 @@ int main( ) *intOut = 20; *intOut = 30; } -/* Output: +``` + +```output Elements written to output stream: 10 20 30 -*/ ``` -## ostream_iterator::ostream_iterator +## `ostream_iterator::ostream_iterator` Constructs an `ostream_iterator` that is initialized and delimited to write to the output stream. @@ -276,17 +279,17 @@ ostream_iterator( ### Parameters -*_Ostr*\ -The output stream of type [ostream_iterator::ostream_type](#ostream_type) to be iterated over. +*`_Ostr`*\ +The output stream of type [`ostream_iterator::ostream_type`](#ostream_type) to be iterated over. -*_Delimiter*\ +*`_Delimiter`*\ The delimiter that is inserted into the output stream between values. ### Remarks The first constructor initializes the output stream pointer with `&_Ostr`. The delimiter string pointer designates an empty string. -The second constructor initializes the output stream pointer with `&_Ostr` and the delimiter string pointer with *_Delimiter*. +The second constructor initializes the output stream pointer with `&_Ostr` and the delimiter string pointer with *`_Delimiter`*. ### Example @@ -327,15 +330,15 @@ int main( ) ostream_iterator ( cout, " : " ) ); cout << endl; } -/* Output: +``` +```output 10 20 Elements output without delimiter: 123456 Elements output with delimiter: 1 : 2 : 3 : 4 : 5 : 6 : -*/ ``` -## ostream_iterator::ostream_type +## `ostream_iterator::ostream_type` A type that provides for the stream type of the iterator. @@ -345,13 +348,13 @@ typedef basic_ostream ostream_type; ### Remarks -The type is a synonym for [basic_ostream](../standard-library/basic-ostream-class.md)< `CharType`, `Traits`>, a stream class of the iostream hierarchy that defines objects that can be used for writing. +The type is a synonym for [`basic_ostream`](../standard-library/basic-ostream-class.md)< `CharType`, `Traits`>, a stream class of the iostream hierarchy that defines objects that can be used for writing. ### Example -See [ostream_iterator](#ostream_iterator) for an example of how to declare and use `ostream_type`. +See [`ostream_iterator`](#ostream_iterator) for an example of how to declare and use `ostream_type`. -## ostream_iterator::traits_type +## `ostream_iterator::traits_type` A type that provides for the character traits type of the iterator. @@ -392,13 +395,14 @@ int main( ) *intOut = 10; *intOut = 100; } -/* Output: +``` + +```output The integers written to output stream by intOut are: 1 10 100 -*/ ``` ## See also diff --git a/docs/standard-library/ostreambuf-iterator-class.md b/docs/standard-library/ostreambuf-iterator-class.md index dfe0546ad27..dd59e727723 100644 --- a/docs/standard-library/ostreambuf-iterator-class.md +++ b/docs/standard-library/ostreambuf-iterator-class.md @@ -5,9 +5,9 @@ ms.date: 11/04/2016 f1_keywords: ["streambuf/std::ostreambuf_iterator", "iterator/std::ostreambuf_iterator::char_type", "iterator/std::ostreambuf_iterator::ostream_type", "iterator/std::ostreambuf_iterator::streambuf_type", "iterator/std::ostreambuf_iterator::traits_type", "iterator/std::ostreambuf_iterator::failed"] helpviewer_keywords: ["std::ostreambuf_iterator [C++]", "std::ostreambuf_iterator [C++], char_type", "std::ostreambuf_iterator [C++], ostream_type", "std::ostreambuf_iterator [C++], streambuf_type", "std::ostreambuf_iterator [C++], traits_type", "std::ostreambuf_iterator [C++], failed"] --- -# ostreambuf_iterator Class +# `ostreambuf_iterator` class -The class template ostreambuf_iterator describes an output iterator object that writes successive character elements onto the output stream with the extraction **operator>>**. The `ostreambuf_iterator`s differ from those of the [ostream_iterator Class](../standard-library/ostream-iterator-class.md) in having characters instead of a generic type at the type of object being inserted into the output stream. +The class template `ostreambuf_iterator` describes an output iterator object that writes successive character elements onto the output stream with the extraction `operator>>`. The `ostreambuf_iterator`s differ from those of the [`ostream_iterator` Class](../standard-library/ostream-iterator-class.md) in having characters instead of a generic type at the type of object being inserted into the output stream. ## Syntax @@ -17,11 +17,11 @@ template > ### Parameters -*CharType*\ +*`CharType`*\ The type that represents the character type for the ostreambuf_iterator. This argument is optional and the default value is **`char`**. -*Traits*\ -The type that represents the character type for the ostreambuf_iterator. This argument is optional and the default value is `char_traits`\< *CharType>.* +*`Traits`*\ +The type that represents the character type for the ostreambuf_iterator. This argument is optional and the default value is `char_traits`. ## Remarks @@ -31,38 +31,38 @@ The ostreambuf_iterator class must satisfy the requirements for an output iterat |Constructor|Description| |-|-| -|[ostreambuf_iterator](#ostreambuf_iterator_ostreambuf_iterator)|Constructs an `ostreambuf_iterator` that is initialized to write characters to the output stream.| +|[`ostreambuf_iterator`](#ostreambuf_iterator_ostreambuf_iterator)|Constructs an `ostreambuf_iterator` that is initialized to write characters to the output stream.| ### Typedefs |Type name|Description| |-|-| -|[char_type](#char_type)|A type that provides for the character type of the `ostreambuf_iterator`.| -|[ostream_type](#ostreambuf_iterator_ostream_type)|A type that provides for the stream type of the `ostream_iterator`.| -|[streambuf_type](#streambuf_type)|A type that provides for the stream type of the `ostreambuf_iterator`.| -|[traits_type](#traits_type)|A type that provides for the character traits type of the `ostream_iterator`.| +|[`char_type`](#char_type)|A type that provides for the character type of the `ostreambuf_iterator`.| +|[`ostream_type`](#ostreambuf_iterator_ostream_type)|A type that provides for the stream type of the `ostream_iterator`.| +|[`streambuf_type`](#streambuf_type)|A type that provides for the stream type of the `ostreambuf_iterator`.| +|[`traits_type`](#traits_type)|A type that provides for the character traits type of the `ostream_iterator`.| ### Member functions |Member function|Description| |-|-| -|[failed](#failed)|Tests for failure of an insertion into the output stream buffer.| +|[`failed`](#failed)|Tests for failure of an insertion into the output stream buffer.| ### Operators |Operator|Description| |-|-| -|[operator*](#op_star)|Dereferencing operator used to implement the output iterator expression \* `i` = `x`.| -|[operator++](#op_add_add)|A nonfunctional increment operator that returns an `ostreambuf_iterator` to the same object it addressed before the operation was called.| -|[operator=](#op_eq)|The operator inserts a character into the associated stream buffer.| +|[`operator*`](#op_star)|Dereferencing operator used to implement the output iterator expression `*i = x`.| +|[`operator++`](#op_add_add)|A nonfunctional increment operator that returns an `ostreambuf_iterator` to the same object it addressed before the operation was called.| +|[`operator=`](#op_eq)|The operator inserts a character into the associated stream buffer.| ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` -## ostreambuf_iterator::char_type +## `ostreambuf_iterator::char_type` A type that provides for the character type of the `ostreambuf_iterator`. @@ -106,13 +106,13 @@ int main( ) charOutBuf++; cout << "." << endl; } -/* Output: -The characters written to the output stream -by charOutBuf are: OUT. -*/ ``` -## ostreambuf_iterator::failed +```output +OUT. +``` + +## `ostreambuf_iterator::failed` Tests for failure of an insertion into the output stream buffer. @@ -126,7 +126,7 @@ bool failed() const throw(); ### Remarks -The member function returns **`true`** if, in any prior use of member `operator=`, the call to **subf**_-> `sputc` returned **eof**. +The member function returns **`true`** if any prior attempt to insert a character into the output stream buffer was unsuccessful. ### Example @@ -157,15 +157,16 @@ int main( ) else cout << "No insertions failed." << endl; } -/* Output: +``` + +```output abc are characters output individually. No insertions failed. -*/ ``` -## ostreambuf_iterator::operator\* +## `ostreambuf_iterator::operator*` -A nonfunctional dereferencing operator used to implement the output iterator expression \* *i* = *x*. +A nonfunctional dereferencing operator used to implement the output iterator expression `*i = x`. ```cpp ostreambuf_iterator& operator*(); @@ -177,7 +178,7 @@ The ostreambuf iterator object. ### Remarks -This operator functions only in the output iterator expression \* *i* = *x* to output characters to stream buffer. Applied to an ostreambuf iterator, it returns the iterator; **\*iter** returns **iter**, +This operator functions only in the output iterator expression `*i = x` to output characters to stream buffer. Applied to an `ostreambuf_iterator`, it returns the iterator; `*iter` returns `iter`. ### Example @@ -188,7 +189,7 @@ This operator functions only in the output iterator expression \* *i* = *x* to o #include #include -int main( ) +int main() { using namespace std; @@ -204,15 +205,16 @@ int main( ) *charOutBuf = 'U'; *charOutBuf = 'T'; } -/* Output: +``` + +```output Elements written to output stream: OUT -*/ ``` -## ostreambuf_iterator::operator++ +## `ostreambuf_iterator::operator++` -A nonfunctional increment operator that returns an ostream iterator to the same character it addressed before the operation was called. +A nonfunctional increment operator that returns an `ostreambuf_iterator` to the same character it addressed before the operation was called. ```cpp ostreambuf_iterator& operator++(); @@ -221,11 +223,11 @@ ostreambuf_iterator& operator++(int); ### Return Value -A reference to the character originally addressed or to an implementation-defined object that is convertible to `ostreambuf_iterator`\< **CharType**, **Traits**>. +A reference to the character originally addressed or to an implementation-defined object that is convertible to `ostreambuf_iterator< CharType, Traits>`. ### Remarks -The operator is used to implement the output iterator expression \* *i* = *x*. +The operator is used to implement the output iterator expression `*i = x`. ### Example @@ -252,13 +254,14 @@ int main( ) *charOutBuf = 'U'; *charOutBuf = 'T'; } -/* Output: +``` + +```output Elements written to output stream: OUT -*/ ``` -## ostreambuf_iterator::operator= +## `ostreambuf_iterator::operator=` The operator inserts a character into the associated stream buffer. @@ -268,7 +271,7 @@ ostreambuf_iterator& operator=(CharType _Char); ### Parameters -*_Char*\ +*`_Char`*\ The character to be inserted into the stream buffer. ### Return Value @@ -277,7 +280,7 @@ A reference to the character inserted into the stream buffer. ### Remarks -Assignment operator used to implement the output iterator expression \* *i* = *x* for writing to an output stream. +Assignment operator used to implement the output iterator expression `*i = x` for writing to an output stream. ### Example @@ -304,13 +307,14 @@ int main( ) *charOutBuf = 'U'; *charOutBuf = 'T'; } -/* Output: +``` + +```output Elements written to output stream: OUT -*/ ``` -## ostreambuf_iterator::ostreambuf_iterator +## `ostreambuf_iterator::ostreambuf_iterator` Constructs an `ostreambuf_iterator` that is initialized to write characters to the output stream. @@ -321,17 +325,17 @@ ostreambuf_iterator(ostream_type& Ostr) throw(); ### Parameters -*strbuf*\ +*`strbuf`*\ The output streambuf object used to initialize the output stream-buffer pointer. -*Ostr*\ +*`Ostr`*\ The output stream object used to initialize the output stream-buffer pointer. ### Remarks -The first constructor initializes the output stream-buffer pointer with *strbuf*. +The first constructor initializes the output stream-buffer pointer with *`strbuf`*. -The second constructor initializes the output stream-buffer pointer with `Ostr`. `rdbuf`. The stored pointer must not be a null pointer. +The second constructor initializes the output stream-buffer pointer with *`Ostr.rdbuf`. The stored pointer must not be a null pointer. ### Example @@ -342,7 +346,7 @@ The second constructor initializes the output stream-buffer pointer with `Ostr`. #include #include -int main( ) +int main() { using namespace std; @@ -360,13 +364,14 @@ int main( ) string str = "These characters are being written to the output stream.\n "; copy ( str.begin ( ), str. end ( ), strOut ); } -/* Output: +``` + +```output OUT are characters output individually. These characters are being written to the output stream. -*/ ``` -## ostreambuf_iterator::ostream_type +## `ostreambuf_iterator::ostream_type` A type that provides for the stream type of the `ostream_iterator`. @@ -376,13 +381,13 @@ typedef basicOstream ostream_type; ### Remarks -The type is a synonym for `basicOstream`\< **CharType**, **Traits**> +The type is a synonym for `basicOstream< CharType, Traits>` ### Example -See [ostreambuf_iterator](#ostreambuf_iterator_ostreambuf_iterator) for an example of how to declare and use `ostream_type`. +See [`ostreambuf_iterator`](#ostreambuf_iterator_ostreambuf_iterator) for an example of how to declare and use `ostream_type`. -## ostreambuf_iterator::streambuf_type +## `ostreambuf_iterator::streambuf_type` A type that provides for the stream type of the `ostreambuf_iterator`. @@ -392,13 +397,13 @@ typedef basic_streambuf streambuf_type; ### Remarks -The type is a synonym for `basic_streambuf`\< **CharType**, **Traits**>, a stream class for I/O buffers that becomes `streambuf` when specialized to character type **`char`**. +The type is a synonym for `basic_streambuf< CharType, Traits>`, a stream class for I/O buffers that becomes `streambuf` when specialized to character type **`char`**. ### Example -See [ostreambuf_iterator](#ostreambuf_iterator_ostreambuf_iterator) for an example of how to declare and use `streambuf_type`. +See [`ostreambuf_iterator`](#ostreambuf_iterator_ostreambuf_iterator) for an example of how to declare and use `streambuf_type`. -## ostreambuf_iterator::traits_type +## `ostreambuf_iterator::traits_type` A type that provides for the character traits type of the `ostream_iterator`. @@ -442,10 +447,11 @@ int main( ) charOutBuf++; cout << "." << endl; } -/* Output: +``` + +```output The characters written to the output stream by charOutBuf are: OUT. -*/ ``` ## See also From 50cfcca68ef3297c0de26f58ad54c2a33b935df5 Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Fri, 6 Mar 2026 11:27:05 -0800 Subject: [PATCH 1694/1799] edit pass: redistributing-microsoft-c++-files --- docs/windows/latest-supported-vc-redist.md | 36 +++++++++---------- docs/windows/redist-version-auditing.md | 6 ++-- .../windows/redistributing-the-mfc-library.md | 6 ++-- .../redistributing-visual-cpp-files.md | 12 +++---- ...-vc-redistributable-installation-issues.md | 10 +++--- 5 files changed, 35 insertions(+), 35 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 3b39b50097b..9e2e4b234e0 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -1,6 +1,6 @@ --- title: Latest Supported Visual C++ Redistributable Downloads -description: This article provides download links for the latest Visual C++ Redistributable Packages. +description: This article provides download links for the latest Visual C++ Redistributable packages. ms.date: 12/03/2025 helpviewer_keywords: [ @@ -20,7 +20,7 @@ ms.author: msaleh > [!NOTE] > Are you here to download Visual Studio? Go to [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/). -This article is for developers who need to install the Visual C++ runtime libraries with their app. If you're trying to fix an app by updating the Visual C++ runtime libraries, contact the app vendor for instructions. +This article is for developers who need to install the Visual C++ Runtime libraries with their app. If you're trying to fix an app by updating the Visual C++ Runtime libraries, contact the app vendor for instructions. To find the download you need, choose your version of Visual Studio from the following table. Each link takes you to the appropriate download section. @@ -39,13 +39,13 @@ To find the download you need, choose your version of Visual Studio from the fol Redistribution is permitted only for licensed Visual Studio users, as described in the [Visual Studio license terms](https://visualstudio.microsoft.com/license-terms/). For details on redistributing Visual C++ files, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). -A Visual C++ Redistributable installs Microsoft C and C++ runtime libraries. Many applications built by using Microsoft Visual C++ Build Tools require these libraries. If your app is built by using those libraries, a Microsoft Visual C++ Redistributable Package at least as recent as the build tools used to build your app must be installed on the target system along with the app. +A Visual C++ Redistributable installs Microsoft C and C++ Runtime libraries. Many applications built by using Microsoft Visual C++ (MSVC) Build Tools require these libraries. If your app is built by using those libraries, a Microsoft Visual C++ Redistributable package at least as recent as the build tools used to build your app must be installed on the target system along with the app. -The Redistributable package architecture must match your app's target architecture. (You can't install an ARM64 Redistributable on an x86 system or an x64 Redistributable on an x86 system, for example.) We recommend that you use the latest Redistributable available for your version of Visual Studio. +The redistributable package architecture must match your app's target architecture. (You can't install an ARM64 Redistributable on an x86 system or an x64 Redistributable on an x86 system, for example.) We recommend that you use the latest Redistributable available for your version of Visual Studio. ## Visual C++ v14 Redistributable -The following table lists the latest supported Microsoft Visual C++ v14 Redistributable Packages. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created by using Microsoft C and C++ Build Tools available in Visual Studio 2017, 2019, 2022, or 2026. +The following table lists the latest supported Microsoft Visual C++ v14 Redistributable packages. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created by using MSVC Build Tools available in Visual Studio 2017, 2019, 2022, or 2026. Unlike older versions of Visual Studio that have infrequent redistributable updates, the version number isn't listed in the following table for the Visual C++ v14 Redistributable because it's updated frequently. To find the version number of the latest redistributable, download the one you're interested in by using one of the following links. Then, look at its properties by using Windows File Explorer. On the **Details** pane, **File version** contains the version of the redistributable. @@ -55,7 +55,7 @@ Unlike older versions of Visual Studio that have infrequent redistributable upda |--|--|--| | ARM64 | [https://aka.ms/vc14/vc_redist.arm64.exe](https://aka.ms/vc14/vc_redist.arm64.exe) | Permalink for latest supported ARM64 version. | | X86 | [https://aka.ms/vc14/vc_redist.x86.exe](https://aka.ms/vc14/vc_redist.x86.exe) | Permalink for latest supported x86 version. | -| X64 | [https://aka.ms/vc14/vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable Package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | +| X64 | [https://aka.ms/vc14/vc_redist.x64.exe](https://aka.ms/vc14/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | Download other versions, including long-term servicing channel (LTSC) versions, from [Welcome to Dev Essentials](https://my.visualstudio.com/). @@ -63,15 +63,15 @@ Download other versions, including long-term servicing channel (LTSC) versions, - Some of the downloads that are mentioned in this article are currently available on [Welcome to Dev Essentials](https://my.visualstudio.com/). Sign in by using a Visual Studio subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or to create a free account. select [No account? Create one!](https://my.visualstudio.com/). - The Visual C++ v14 Redistributable doesn't have separate packages for different languages. License terms for different languages are available at [Microsoft Software License Terms](https://aka.ms/VCRedistLicense). -- Visual Studio 2017 and later share the same redistributable files. Any apps built by Microsoft Visual C++ Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. +- Visual Studio 2017 and later share the same redistributable files. Any apps built by MSVC Build Tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ v14 Redistributable. - The version of the Redistributable installed on the machine must be the same or later than the version of the Microsoft Visual C++ Build Tools used to create your application. For more information about which version of the Redistributable to install, see [Determine which dynamic-link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). + The version of the Redistributable installed on the machine must be the same or later than the version of the MSVC Build Tools used to create your application. For more information about which version of the redistributable to install, see [Determine which dynamic-link libraries (DLLs) to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). - The latest version of the Visual C++ v14 Redistributable included with Visual Studio 2026 supports only the following operating systems: * Windows 10 and 11 * Windows Server 2016, 2019, 2022, and 2025 - Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which it first ships, support for Visual C++ 2015 Redistributable (version 14.0.24212) also ended October 15, 2025. For the latest available version, see the [Visual Studio 2015 (Visual C++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section.
- When Visual Studio 2015 support ended, the v14 runtime was binary compatible with applications built by using the Visual Studio 2015 Microsoft Visual C++ Build Tools. Because Visual Studio 2015 is no longer supported, we recommend that you update your projects to use a supported Microsoft Visual C++ Build Tools version and the latest v14 runtime, the Visual C++ Redistributable for 2017, and later, and perform an in-place upgrade to the Visual C++ 2015 Redistributable (14.0.24212.0). Redistributables for 2013 and earlier remain installed side by side. + When Visual Studio 2015 support ended, the v14 Runtime was binary compatible with applications built by using the Visual Studio 2015 MSVC Build Tools. Because Visual Studio 2015 is no longer supported, we recommend that you update your projects to use a supported MSVC Build Tools version and the latest v14 Runtime, the Visual C++ Redistributable for 2017, and later, and perform an in-place upgrade to the Visual C++ 2015 Redistributable (14.0.24212.0). Redistributables for 2013 and earlier remain installed side by side. - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). @@ -85,8 +85,8 @@ The latest version of Visual C++ Redistributable for Visual Studio 2015 is `14.0 ### Visual Studio 2013 (VC++ 12.0) (no longer supported) -These links download the latest available en-US Microsoft Visual C++ Redistributable Packages for Visual Studio 2013. -You can download other versions and languages from [Update for Visual C++ 2013 Redistributable Package](https://support.microsoft.com/topic/update-for-visual-c-2013-redistributable-package-d8ccd6a5-4e26-c290-517b-8da6cfdf4f10) or from the [Welcome to Dev Essentials](https://my.visualstudio.com/) page. +These links download the latest available en-US Microsoft Visual C++ Redistributable packages for Visual Studio 2013. +You can download other versions and languages from [Update for Visual C++ 2013 Redistributable package](https://support.microsoft.com/topic/update-for-visual-c-2013-redistributable-package-d8ccd6a5-4e26-c290-517b-8da6cfdf4f10) or from the [Welcome to Dev Essentials](https://my.visualstudio.com/) page. | Architecture | Version | Link | | ------------ | :----------: | ------------------------------------------------------: | @@ -96,14 +96,14 @@ You can download other versions and languages from [Update for Visual C++ 2013 R ### Other 2013 versions - [Multibyte Microsoft Foundation Class (MFC) Library for Visual Studio 2013](https://my.visualstudio.com/Downloads?pid=1430). This MFC add-on for Visual Studio 2013 contains the multibyte character set (MBCS) version of the MFC Library. -- [Visual C++ 2013 Runtime for Sideloaded Windows 8.1 Apps](https://download.microsoft.com/download/5/f/0/5f0f8404-9329-44a9-8176-ed6f7f746f25/vclibs_redist_packages.zip). For more information, see [C++ Runtime for Sideloaded Windows 8.1 Apps](https://devblogs.microsoft.com/cppblog/c-runtime-for-sideloaded-windows-8-1-apps/) on the C++ Team Blog. +- [Visual C++ 2013 Runtime for sideloaded Windows 8.1 apps](https://download.microsoft.com/download/5/f/0/5f0f8404-9329-44a9-8176-ed6f7f746f25/vclibs_redist_packages.zip). For more information, see [C++ Runtime for sideloaded Windows 8.1 apps](https://devblogs.microsoft.com/cppblog/c-runtime-for-sideloaded-windows-8-1-apps/) on the C++ Team Blog. ### Visual Studio 2012 (VC++ 11.0) Update 4 (no longer supported) > [!NOTE] > Visual Studio 2012 [reached the end of extended support on January 10, 2023](/lifecycle/products/visual-studio-2012). -These links download the latest available en-US Microsoft Visual C++ Redistributable Packages for Visual Studio 2012 Update 4. You can download other versions and languages from [Microsoft Visual C++ Redistributable Packages for Visual Studio 2012 Update 4](https://www.microsoft.com/download/details.aspx?id=30679) or from the [Visual Studio Subscriptions](https://my.visualstudio.com/Downloads?pid=1452) website. +These links download the latest available en-US Microsoft Visual C++ Redistributable packages for Visual Studio 2012 Update 4. You can download other versions and languages from [Microsoft Visual C++ Redistributable packages for Visual Studio 2012 Update 4](https://www.microsoft.com/download/details.aspx?id=30679) or from the [Visual Studio Subscriptions](https://my.visualstudio.com/Downloads?pid=1452) website. | Architecture | Version | Link | |--|:-:|-:| @@ -120,7 +120,7 @@ These links download the latest available en-US Microsoft Visual C++ Redistribut | X86 | 10.0.40219.325 | [vcredist_x86.exe](https://download.microsoft.com/download/1/6/5/165255E7-1014-4D0A-B094-B6A430A6BFFC/vcredist_x86.exe) | | X64 | 10.0.40219.325 | [vcredist_x64.exe](https://download.microsoft.com/download/1/6/5/165255E7-1014-4D0A-B094-B6A430A6BFFC/vcredist_x64.exe) | -Download Redistributable files for other languages and architectures from [Microsoft Visual C++ 2010 SP1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26999). +Download redistributable files for other languages and architectures from [Microsoft Visual C++ 2010 SP1 Redistributable package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26999). ### Visual Studio 2008 (VC++ 9.0) SP1 (no longer supported) @@ -132,20 +132,20 @@ Download Redistributable files for other languages and architectures from [Micro | X86 | 9.0.30729.5677 | [vcredist_x86.exe](https://download.microsoft.com/download/5/D/8/5D8C65CB-C849-4025-8E95-C3966CAFD8AE/vcredist_x86.exe) | | X64 | 9.0.30729.5677 | [vcredist_x64.exe](https://download.microsoft.com/download/5/D/8/5D8C65CB-C849-4025-8E95-C3966CAFD8AE/vcredist_x64.exe) | -Download redistributable files for other languages and architectures from [Microsoft Visual C++ 2008 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26368). +Download redistributable files for other languages and architectures from [Microsoft Visual C++ 2008 Service Pack 1 Redistributable package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26368). ### Visual Studio 2005 (VC++ 8.0) SP1 (no longer supported) > [!NOTE] > Visual Studio 2005 [reached the end of extended support on April 12, 2016](/lifecycle/products/microsoft-visual-studio-2005). -Redistributable files for X86, X64, and IA64 architectures are available from [Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26347). +Redistributable files for X86, X64, and IA64 architectures are available from [Microsoft Visual C++ 2005 Service Pack 1 Redistributable package MFC Security Update](https://www.microsoft.com/download/details.aspx?id=26347). ## Related content - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) -- [Audit Visual C++ runtime version usage](redist-version-auditing.md) -- [Lifecycle FAQ: Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) +- [Audit Visual C++ Runtime version usage](redist-version-auditing.md) +- [Lifecycle FAQ: Visual C++ Redistributable and Runtime libraries](/lifecycle/faq/visual-c-faq) - [Troubleshoot Visual C++ Redistributable installation issues](troubleshoot-vc-redistributable-installation-issues.md) ### Release notes diff --git a/docs/windows/redist-version-auditing.md b/docs/windows/redist-version-auditing.md index 065744b4685..410b12d1ee3 100644 --- a/docs/windows/redist-version-auditing.md +++ b/docs/windows/redist-version-auditing.md @@ -14,7 +14,7 @@ ms.topic: how-to # Audit Visual C++ Runtime version usage -The Microsoft Visual C++ Redistributable and the Visual Studio C++ runtime (collectively, "VC Runtime") are critical components of many applications. Across your network, machines might still be running applications that install and use an out-of-support version of the VC Runtime. You can use NTFS file auditing to identify such usage as a step toward replacing those applications with ones that use a supported version of the VC Runtime. This article walks you through setting up NTFS file auditing, provides troubleshooting tips, and highlights the benefits of regular audits. +Microsoft Visual C++ Redistributable and Visual Studio C++ Runtime (collectively, "VC Runtime") are critical components of many applications. Across your network, machines might still be running applications that install and use an out-of-support version of the VC Runtime. You can use NTFS file auditing to identify such usage as a step toward replacing those applications with ones that use a supported version of the VC Runtime. This article walks you through setting up NTFS file auditing, provides troubleshooting tips, and highlights the benefits of regular audits. For more information about the versions of VC Runtime that are no longer supported, see [Microsoft Visual C++ Redistributable latest supported downloads](latest-supported-vc-redist.md). @@ -173,7 +173,7 @@ ResourceAttributes : S:AI After you determine which processes use the VC Runtime files, or which applications installed the Visual C++ Redistributable, uninstall those applications or upgrade them to newer versions that don't depend on unsupported VC Runtimes. -Some Microsoft applications require legacy versions of the VC Runtime. For more information, see the [Visual C++ Redistributable and runtime libraries FAQ](/lifecycle/faq/visual-c-faq). +Some Microsoft applications require legacy versions of the VC Runtime. For more information, see the [Visual C++ Redistributable and Runtime libraries FAQ](/lifecycle/faq/visual-c-faq). @@ -193,5 +193,5 @@ The following table lists where each version of the VC Runtime is installed. - [Redistribute Visual C++ files](redistributing-visual-cpp-files.md) - [The latest supported Visual C++ downloads](latest-supported-vc-redist.md) -- [Lifecycle FAQ: Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) +- [Lifecycle FAQ: Visual C++ Redistributable and Runtime libraries](/lifecycle/faq/visual-c-faq) - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) diff --git a/docs/windows/redistributing-the-mfc-library.md b/docs/windows/redistributing-the-mfc-library.md index 801828f66f9..2584fad3b84 100644 --- a/docs/windows/redistributing-the-mfc-library.md +++ b/docs/windows/redistributing-the-mfc-library.md @@ -14,13 +14,13 @@ If you dynamically link your application to the Microsoft Foundation Class (MFC) > [!NOTE] > The `mfc140.dll` files were omitted from the redistributable files directory in Visual Studio 2015 RTM. You can use the versions installed by Visual Studio 2015 in the `Windows\system32 and Windows\syswow64` directories instead. -Because all MFC DLLs use the shared version of the Microsoft C runtime library, you might also need to redistribute the C runtime. The version of MFC that ships with Visual Studio 2015 uses the Universal C runtime library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal C runtime. +Because all MFC DLLs use the shared version of the Microsoft C Runtime (CRT) library, you might also need to redistribute the CRT. The version of MFC that ships with Visual Studio 2015 uses the Universal CRT library, which is distributed as part of Windows 10 and Windows 11. To run an MFC application built by using Visual Studio 2015 on earlier versions of Windows, you must redistribute the Universal CRT. -For information on how to redistribute the Universal C runtime as an operating system component or by using local deployment, see [Introducing the Universal C runtime](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the Universal C runtime for central deployment on supported versions of Windows, see [Windows 10 Universal C runtime](https://www.microsoft.com/download/details.aspx?id=48234). +For information on how to redistribute the Universal CRT as an operating system component or by using local deployment, see [Introducing the Universal CRT](https://devblogs.microsoft.com/cppblog/introducing-the-universal-crt/). To download the Universal CRT for central deployment on supported versions of Windows, see [Windows 10 Universal CRT](https://www.microsoft.com/download/details.aspx?id=48234). You can find redistributable architecture-specific versions of `ucrtbase.dll` for local deployment in the Windows SDK. By default, Visual Studio installs these versions in `C:\Program Files (x86)\Windows Kits\10\Redist\ucrt\DLLs\` in an architecture-specific subdirectory. -If your app is built by using an earlier version of the MFC Library, you must redistribute the matching C runtime DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the `msvcr120.dll`. You also have to redistribute the matching `mfcu.dll` or `mfc.dll`. +If your app is built by using an earlier version of the MFC Library, you must redistribute the matching CRT DLL from the redistributable files directory. For example, if your MFC application is built by using the Visual Studio 2013 (vc120) toolset, you must redistribute the `msvcr120.dll`. You also have to redistribute the matching `mfcu.dll` or `mfc.dll`. If you statically link your application to MFC (in the **Property Pages** dialog, on the **General** tab, select **Use MFC in a Static Library**), you don't have to redistribute an MFC DLL. Although static linking might work for testing and internal deployment of applications, we recommend that you don't use it to redistribute MFC. For more information about the recommended strategies for deploying Visual C++ libraries, see [Choose a deployment method](choosing-a-deployment-method.md). diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 348b9d564ad..329239ff8ca 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -1,6 +1,6 @@ --- title: Redistribute Visual C++ Files -description: Learn about Visual Studio redistributable libraries and components that you can deploy with your app. +description: Learn about Visual Studio Redistributable libraries and components that you can deploy with your app. ms.date: 01/15/2025 helpviewer_keywords: ["application deployment [C++], file redistributing", "redistributing applications [C++]", "deploying applications [C++], file redistributing", "file redistribution [C++]", "redistributing applications [C++], about redistributing applications"] ms.topic: concept-article @@ -8,7 +8,7 @@ ms.topic: concept-article # Redistribute Visual C++ files > [!NOTE] -> Are you here because you're looking for a download of one of the Visual C++ runtime files? Go to the [latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) page. +> Are you here because you're looking for a download of one of the Visual C++ Runtime files? Go to the [latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) page. ## Redistributable files and licensing @@ -48,7 +48,7 @@ To deploy redistributable files, you can use the redistributable packages instal The easiest way to locate the redistributable files is by using environment variables set in a developer command prompt. In Visual Studio 2022, the redistributable files are in the `%VCINSTALLDIR%Redist\MSVC\v143` folder. In the latest version of Visual Studio 2019, you can find the redistributable files in the `%VCINSTALLDIR%Redist\MSVC\v142` folder. In both Visual Studio 2017 and Visual Studio 2019, the files are also found in `%VCToolsRedistDir%`. In Visual Studio 2015, you can find these files in `%VCINSTALLDIR%redist\`, where `` is the locale of the redistributable packages. -In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named Visual C++ \ Redistributable merge modules in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When they're installed in Visual Studio 2022, you can find the redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. +In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named *Visual C++ \ Redistributable merge modules* in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When they're installed in Visual Studio 2022, you can find the redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. ` In the latest version of Visual Studio 2019, the redistributable merge modules are found in `%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`. In both Visual Studio 2019 and Visual Studio 2017, they're also found in `%VCToolsRedistDir%MergeModules`. In Visual Studio 2015, they're found in `Program Files [(x86)]\Common Files\Merge Modules`. @@ -93,13 +93,13 @@ It's also possible to directly install the Redistributable DLLs in the *applicat If Windows can't find one of the Redistributable DLLs required by your application, it might display a message similar to this one: "This application has failed to start because *library*.dll was not found. Reinstalling the application may fix this problem." -To resolve this kind of error, make sure that your application installer builds correctly. Verify that the Redistributable libraries get deployed correctly on the target system. For more information, see [Understand the dependencies of a Visual C++ application](understanding-the-dependencies-of-a-visual-cpp-application.md). +To resolve this kind of error, make sure that your application installer builds correctly. Verify that the redistributable libraries get deployed correctly on the target system. For more information, see [Understand the dependencies of a Visual C++ application](understanding-the-dependencies-of-a-visual-cpp-application.md). ## Related content -- [Redistribute by using merge modules](redistributing-components-by-using-merge-modules.md) describes how to use Visual C++ Redistributable merge modules to install the Visual C++ runtime libraries as shared DLLs in the `%windir%\system32\` folder. +- [Redistribute by using merge modules](redistributing-components-by-using-merge-modules.md) describes how to use Visual C++ Redistributable merge modules to install the Visual C++ Runtime libraries as shared DLLs in the `%windir%\system32\` folder. - [Redistribute Visual C++ ActiveX controls](redistributing-visual-cpp-activex-controls.md) describes how to redistribute an application that uses ActiveX controls. -- [Redistribute the Microsoft Foundation Class (MFC) library](redistributing-the-mfc-library.md) describes how to redistribute an application that uses MFC. +- [Redistribute the Microsoft Foundation Class (MFC) Library](redistributing-the-mfc-library.md) describes how to redistribute an application that uses MFC. - [Redistribute an Active Template Library (ATL) application](redistributing-an-atl-application.md) describes how to redistribute an application that uses an ATL. In Visual Studio 2012 and later, no ATL library is required. - [Deployment examples](deployment-examples.md) links to examples that demonstrate how to deploy Visual C++ applications. - [Deploy desktop applications](deploying-native-desktop-applications-visual-cpp.md) introduces Visual C++ deployment concepts and technologies. diff --git a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md index 0fb42c9dad1..4f01ac6c7a9 100644 --- a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md +++ b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md @@ -9,7 +9,7 @@ helpviewer_keywords: [ "redist", "vcredist", "Visual [C++] redistributable", "VC --- # Troubleshoot Visual C++ Redistributable installation problems -This article is for users who experience problems when they install Visual C++ runtime components by using the Visual Studio Installer or the Visual C++ Redistributable (VC Redist) installer. +This article is for users who experience problems when they install Visual C++ Runtime components by using the Visual Studio Installer or the Visual C++ Redistributable (VC Redist) installer. If you experience any problems, make sure that you're installing the [latest version of the Visual C++ Redistributable](latest-supported-vc-redist.md). @@ -127,7 +127,7 @@ This method helps if the installer metadata is corrupted. Deleting the installer ### Generic installation failure -Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ runtime components. +Return code 1603 indicates a generic installation failure produced by the Windows Installer during the installation of the Visual C++ Runtime components. Because many factors can produce a 1603 code, the code by itself doesn't provide enough information to diagnose the cause of the problem. Often, the log files produced by the VC Redist installer contain relevant information that might lead to a solution or workaround. @@ -254,11 +254,11 @@ Your report must include the following information about your environment: - If you're installing through the Visual Studio Installer, the version of the Visual Studio Installer. - The logs collected when you follow the steps in the [Collect failure logs](#collect-failure-logs) section. -Feedback without this information, especially without logs, is non-actionable and might be closed if more information isn't submitted promptly. +Feedback without this information, especially without logs, is nonactionable and might be closed if more information isn't submitted promptly. ## Related content - [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) - [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) -- [Audit Visual C++ runtime version usage](redist-version-auditing.md) -- [Lifecycle FAQ: Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) +- [Audit Visual C++ Runtime version usage](redist-version-auditing.md) +- [Lifecycle FAQ: Visual C++ Redistributable and Runtime libraries](/lifecycle/faq/visual-c-faq) From 728a58812f4f709f1321b3637521882b4d6f2c42 Mon Sep 17 00:00:00 2001 From: paulth1 <42621139+paulth1@users.noreply.github.com> Date: Fri, 6 Mar 2026 11:50:01 -0800 Subject: [PATCH 1695/1799] edit pass: redistributing-microsoft-c++-files --- .../windows/redistributing-components-by-using-merge-modules.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/windows/redistributing-components-by-using-merge-modules.md b/docs/windows/redistributing-components-by-using-merge-modules.md index 2313d2bb5d1..4bd201dad02 100644 --- a/docs/windows/redistributing-components-by-using-merge-modules.md +++ b/docs/windows/redistributing-components-by-using-merge-modules.md @@ -38,7 +38,7 @@ When you use merge modules, you must track and regularly service your applicatio ## Where to find merge module files -In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named *C++ \ Redistributable merge modules* in the Visual Studio Installer. The merge modules are installed by default as part of a C++ installation in Visual Studio 2017 and Visual Studio 2015. When the merge modules are installed in Visual Studio 2022, you can find the Visual C++ Redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. +In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named **C++ \ Redistributable MSM** in the Visual Studio Installer. The merge modules are installed by default as part of a C++ installation in Visual Studio 2017 and Visual Studio 2015. When the merge modules are installed in Visual Studio 2022, you can find the Visual C++ Redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. In the latest version of Visual Studio 2019, the merge modules are in `%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`. In both Visual Studio 2019 and Visual Studio 2017, they're also found in `%VCToolsRedistDir%MergeModules`. In Visual Studio 2015, they're found in `Program Files [(x86)]\Common Files\Merge Modules`. For more information and a link to a list of redistributable merge modules, see [Redistribute Visual C++ files](redistributing-visual-cpp-files.md). From 188dd74bc61935533101bff52f20fe8ebed976ec Mon Sep 17 00:00:00 2001 From: Shawn Jackson <9558114+ShawnJackson@users.noreply.github.com> Date: Fri, 6 Mar 2026 14:52:35 -0600 Subject: [PATCH 1696/1799] Typo fix --- .../troubleshoot-vc-redistributable-installation-issues.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md index 4f01ac6c7a9..77102136786 100644 --- a/docs/windows/troubleshoot-vc-redistributable-installation-issues.md +++ b/docs/windows/troubleshoot-vc-redistributable-installation-issues.md @@ -15,7 +15,7 @@ If you experience any problems, make sure that you're installing the [latest ver ## Collect failure logs -The first step to diagnose an problem with the Visual C++ Redistributable installer is to collect its failure logs. +The first step to diagnose a problem with the Visual C++ Redistributable installer is to collect its failure logs. 1. Download the [Microsoft Visual Studio and .NET Log Collection Tool](). 1. Run `Collect.exe`. @@ -245,7 +245,7 @@ You might be able to find installers for older versions through a Bing search. O The list of [common problems](#common-problems) was collected from feedback reported to Microsoft through the [Developer Community](). -If you encounter an problem not found in that section, or if the steps in this troubleshooting guide don't resolve your problem, use the [Report a Problem]() form to create a new feedback item. +If you encounter a problem not found in that section, or if the steps in this troubleshooting guide don't resolve your problem, use the [Report a Problem]() form to create a new feedback item. Your report must include the following information about your environment: From 340189b3d0e703405b255b2d0aef3ffff5664935 Mon Sep 17 00:00:00 2001 From: Shawn Jackson <9558114+ShawnJackson@users.noreply.github.com> Date: Fri, 6 Mar 2026 15:09:02 -0600 Subject: [PATCH 1697/1799] Typo fix --- docs/windows/redistributing-visual-cpp-files.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/windows/redistributing-visual-cpp-files.md b/docs/windows/redistributing-visual-cpp-files.md index 329239ff8ca..afeae969425 100644 --- a/docs/windows/redistributing-visual-cpp-files.md +++ b/docs/windows/redistributing-visual-cpp-files.md @@ -49,7 +49,7 @@ To deploy redistributable files, you can use the redistributable packages instal The easiest way to locate the redistributable files is by using environment variables set in a developer command prompt. In Visual Studio 2022, the redistributable files are in the `%VCINSTALLDIR%Redist\MSVC\v143` folder. In the latest version of Visual Studio 2019, you can find the redistributable files in the `%VCINSTALLDIR%Redist\MSVC\v142` folder. In both Visual Studio 2017 and Visual Studio 2019, the files are also found in `%VCToolsRedistDir%`. In Visual Studio 2015, you can find these files in `%VCINSTALLDIR%redist\`, where `` is the locale of the redistributable packages. In Visual Studio 2022 and 2019, merge module files are part of an optional installable component named *Visual C++ \ Redistributable merge modules* in the Visual Studio Installer. The merge modules are installed by default as part of a C++ install in Visual Studio 2017 and Visual Studio 2015. When they're installed in Visual Studio 2022, you can find the redistributable merge modules in `%VCINSTALLDIR%Redist\MSVC\v143\MergeModules`. -` + In the latest version of Visual Studio 2019, the redistributable merge modules are found in `%VCINSTALLDIR%Redist\MSVC\v142\MergeModules`. In both Visual Studio 2019 and Visual Studio 2017, they're also found in `%VCToolsRedistDir%MergeModules`. In Visual Studio 2015, they're found in `Program Files [(x86)]\Common Files\Merge Modules`. ## Install the redistributable packages @@ -103,4 +103,4 @@ To resolve this kind of error, make sure that your application installer builds - [Redistribute an Active Template Library (ATL) application](redistributing-an-atl-application.md) describes how to redistribute an application that uses an ATL. In Visual Studio 2012 and later, no ATL library is required. - [Deployment examples](deployment-examples.md) links to examples that demonstrate how to deploy Visual C++ applications. - [Deploy desktop applications](deploying-native-desktop-applications-visual-cpp.md) introduces Visual C++ deployment concepts and technologies. -- [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) links to the latest supported Visual C++ Redistributable downloads. \ No newline at end of file +- [Latest supported Visual C++ Redistributable downloads](latest-supported-vc-redist.md) links to the latest supported Visual C++ Redistributable downloads. From 81e5c1da9778941e57724222b86421bc2bfb1e48 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 6 Mar 2026 13:12:36 -0800 Subject: [PATCH 1698/1799] adjust containers location --- docs/standard-library/toc.yml | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/docs/standard-library/toc.yml b/docs/standard-library/toc.yml index 9ff0efac2ed..bfb970bf6fa 100644 --- a/docs/standard-library/toc.yml +++ b/docs/standard-library/toc.yml @@ -1524,6 +1524,8 @@ items: href: using-cpp-library-headers.md - name: C++ Library conventions href: cpp-library-conventions.md + - name: C++ Standard Library containers + href: stl-containers.md - name: C++ program startup and termination href: cpp-program-startup-and-termination.md - name: "Safe libraries: C++ Standard Library" @@ -1552,11 +1554,6 @@ items: href: thread-safety-in-the-cpp-standard-library.md - name: stdext namespace href: stdext-namespace.md -- name: C++ Standard Library containers - expanded: false - items: - - name: C++ Standard Library containers - href: stl-containers.md - name: Iterators href: iterators.md - name: Algorithms From eba19389e0c1f9aa30931a7a9688292ca67079bc Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 6 Mar 2026 14:23:03 -0800 Subject: [PATCH 1699/1799] edits --- .../ostream-iterator-class.md | 37 +++++++++---------- 1 file changed, 18 insertions(+), 19 deletions(-) diff --git a/docs/standard-library/ostream-iterator-class.md b/docs/standard-library/ostream-iterator-class.md index ba6eb7c7afc..aff05930b8f 100644 --- a/docs/standard-library/ostream-iterator-class.md +++ b/docs/standard-library/ostream-iterator-class.md @@ -20,14 +20,14 @@ class ostream_iterator ### Parameters -*Type*\ +*`Type`*\ The type of object to be inserted into the output stream. -*CharType*\ +*`CharType`*\ The type that represents the character type for the `ostream_iterator`. This argument is optional and the default value is **`char`**. -*Traits*\ -The type that represents the character type for the `ostream_iterator`. This argument is optional and the default value is `char_traits`\< *CharType>.* +*`Traits`*\ +The type that represents the character type for the `ostream_iterator`. This argument is optional and the default value is `char_traits`.* The ostream_iterator class must satisfy the requirements for an output iterator. Algorithms can be written directly to output streams using an `ostream_iterator`. @@ -55,7 +55,7 @@ The ostream_iterator class must satisfy the requirements for an output iterator. ## Requirements -**Header:** \ +**Header:** `` **Namespace:** `std` @@ -99,16 +99,17 @@ int main( ) *intOut = 20; *intOut = 30; } -/* Output: +``` + +```output The integers written to the output stream by intOut are: 10 20 30 -*/ ``` -## `ostream_iterator::operator*` +## ostream_iterator::operator* Dereferencing operator used to implement the output iterator expression `*ii = x`. @@ -122,7 +123,7 @@ A reference to the `ostream_iterator`. ### Remarks -The requirements for an output iterator that the `ostream_iterator` must satisfy require only the expression \* *ii* = *t* be valid and says nothing about the **`operator`** or the `operator=` on their own. The member operator in this implementation returns **`*this`**. +The requirements for an output iterator that the `ostream_iterator` must satisfy require only the expression `*ii = t` be valid and says nothing about the **`operator`** or the `operator=` on their own. The member operator in this implementation returns `*this`. ### Example @@ -150,7 +151,6 @@ int main( ) *intOut = 30; } ``` - ```output Elements written to output stream: 10 @@ -173,7 +173,7 @@ A reference to the `ostream_iterator`. ### Remarks -These member operators both return **`*this`**. +These member operators both return `*this`. ### Example @@ -224,11 +224,11 @@ The value of the object of type `Type` to be inserted into the output stream. ### Return Value -The operator inserts *`val`* into the output stream associated with the object, followed by the delimiter specified in the [`ostream_iterator` constructor](#ostream_iterator) (if any), and then returns a reference to the `ostream_iterator`. +The operator inserts *`val`* into the output stream associated with the object, followed by the delimiter specified in the [`ostream_iterator constructor`](#ostream_iterator) (if any), and then returns a reference to the `ostream_iterator`. ### Remarks -The requirements for an output iterator that the `ostream_iterator` must satisfy require only the expression `*ii = t` be valid and says nothing about the `operator*` or the `operator=` on their own. This member operator returns **`*this`**. +The requirements for an output iterator that the `ostream_iterator` must satisfy require only the expression `*ii = t` be valid and says nothing about the operator or the operator= on their own. This member operator returns `*this`. ### Example @@ -256,7 +256,6 @@ int main( ) *intOut = 30; } ``` - ```output Elements written to output stream: 10 @@ -269,8 +268,7 @@ Elements written to output stream: Constructs an `ostream_iterator` that is initialized and delimited to write to the output stream. ```cpp -ostream_iterator( - ostream_type& _Ostr); +ostream_iterator(ostream_type& _Ostr); ostream_iterator( ostream_type& _Ostr, @@ -331,7 +329,8 @@ int main( ) cout << endl; } ``` -```output + +```ouput 10 20 Elements output without delimiter: 123456 @@ -348,7 +347,7 @@ typedef basic_ostream ostream_type; ### Remarks -The type is a synonym for [`basic_ostream`](../standard-library/basic-ostream-class.md)< `CharType`, `Traits`>, a stream class of the iostream hierarchy that defines objects that can be used for writing. +The type is a synonym for [`basic_ostream`](../standard-library/basic-ostream-class.md)``, a stream class of the iostream hierarchy that defines objects that can be used for writing. ### Example @@ -407,6 +406,6 @@ by intOut are: ## See also -[\](../standard-library/iterator.md)\ +[``](../standard-library/iterator.md)\ [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)\ [C++ Standard Library Reference](../standard-library/cpp-standard-library-reference.md) From 402e5e5963c3f9ba93ef60f13023c3f5bc27c8ff Mon Sep 17 00:00:00 2001 From: Michael Price Date: Tue, 10 Mar 2026 16:12:05 -0500 Subject: [PATCH 1700/1799] Revert filename changes from cb62204dee while keeping text content changes This reverts the file renames that removed 'app' from filenames, restoring the original names while preserving the text content changes that updated references from 'app modernization' to 'modernization'. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- ...tion-cpp.md => copilot-app-modernization-cpp.md} | 8 ++++---- ....png => app-modernization-cmake-ice-breaker.png} | Bin ...ng => app-modernization-msbuild-ice-breaker.png} | Bin ...g => copilot-app-modernization-context-menu.png} | Bin ...png => enable-copilot-app-modernization-cpp.png} | Bin docs/porting/toc.yml | 2 +- .../visual-cpp-porting-and-upgrading-guide.md | 2 +- 7 files changed, 6 insertions(+), 6 deletions(-) rename docs/porting/{copilot-modernization-cpp.md => copilot-app-modernization-cpp.md} (87%) rename docs/porting/media/{modernization-cmake-ice-breaker.png => app-modernization-cmake-ice-breaker.png} (100%) rename docs/porting/media/{modernization-msbuild-ice-breaker.png => app-modernization-msbuild-ice-breaker.png} (100%) rename docs/porting/media/{copilot-modernization-context-menu.png => copilot-app-modernization-context-menu.png} (100%) rename docs/porting/media/{enable-copilot-modernization-cpp.png => enable-copilot-app-modernization-cpp.png} (100%) diff --git a/docs/porting/copilot-modernization-cpp.md b/docs/porting/copilot-app-modernization-cpp.md similarity index 87% rename from docs/porting/copilot-modernization-cpp.md rename to docs/porting/copilot-app-modernization-cpp.md index d220de274d8..972ac4df976 100644 --- a/docs/porting/copilot-modernization-cpp.md +++ b/docs/porting/copilot-app-modernization-cpp.md @@ -29,7 +29,7 @@ GitHub Copilot modernization for C++ is enabled by default. To disable or explic 1. Select (to enable) or clear (to disable) the checkbox for **Enable GitHub Copilot modernization for C++ (preview)**. 1. Restart Visual Studio for the setting change to take effect. -:::image type="content" source="media/enable-copilot-modernization-cpp.png" alt-text="Screenshot of Visual Studio Options dialog. GitHub > Copilot > C/C++ settings are visible. The modernization for C++ checkbox is enabled."::: +:::image type="content" source="media/enable-copilot-app-modernization-cpp.png" alt-text="Screenshot of Visual Studio Options dialog. GitHub > Copilot > C/C++ settings are visible. The modernization for C++ checkbox is enabled."::: ## Upgrade your codebase by using GitHub Copilot modernization for C++ @@ -41,7 +41,7 @@ GitHub Copilot modernization is an agent that operates inside the GitHub Copilot - **From the Solution Explorer context menu**: Right-click on the solution or a loaded project in the Solution Explorer, and choose **Modernize** from the context menu. This automatically launches a GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. -:::image type="content" source="media/copilot-modernization-context-menu.png" alt-text="Screenshot of Visual Studio Solution Explorer showing a right-click context menu with Modernize selected to start the Copilot agent."::: +:::image type="content" source="media/copilot-app-modernization-context-menu.png" alt-text="Screenshot of Visual Studio Solution Explorer showing a right-click context menu with Modernize selected to start the Copilot agent."::: - **From GitHub Copilot Chat**: Open the GitHub Copilot Chat Window by selecting **View > GitHub Copilot Chat**. After the GitHub Copilot Chat window opens, mention `@Modernize` in a prompt to activate the Modernize agent. For example, type this prompt: @@ -70,12 +70,12 @@ Once the Modernize agent is active, you can instruct it via a prompt to upgrade :::row::: :::column::: -:::image type="content" source="media/modernization-msbuild-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to Modernize experience and Upgrade MSVC Build Tools to the latest version is highlighted."::: +:::image type="content" source="media/app-modernization-msbuild-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to Modernize experience and Upgrade MSVC Build Tools to the latest version is highlighted."::: :::column-end::: :::column::: -:::image type="content" source="media/modernization-cmake-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to Modernize experience and Resolve build issues by migrating to modern alternatives is highlighted"::: +:::image type="content" source="media/app-modernization-cmake-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to Modernize experience and Resolve build issues by migrating to modern alternatives is highlighted"::: :::column-end::: :::row-end::: diff --git a/docs/porting/media/modernization-cmake-ice-breaker.png b/docs/porting/media/app-modernization-cmake-ice-breaker.png similarity index 100% rename from docs/porting/media/modernization-cmake-ice-breaker.png rename to docs/porting/media/app-modernization-cmake-ice-breaker.png diff --git a/docs/porting/media/modernization-msbuild-ice-breaker.png b/docs/porting/media/app-modernization-msbuild-ice-breaker.png similarity index 100% rename from docs/porting/media/modernization-msbuild-ice-breaker.png rename to docs/porting/media/app-modernization-msbuild-ice-breaker.png diff --git a/docs/porting/media/copilot-modernization-context-menu.png b/docs/porting/media/copilot-app-modernization-context-menu.png similarity index 100% rename from docs/porting/media/copilot-modernization-context-menu.png rename to docs/porting/media/copilot-app-modernization-context-menu.png diff --git a/docs/porting/media/enable-copilot-modernization-cpp.png b/docs/porting/media/enable-copilot-app-modernization-cpp.png similarity index 100% rename from docs/porting/media/enable-copilot-modernization-cpp.png rename to docs/porting/media/enable-copilot-app-modernization-cpp.png diff --git a/docs/porting/toc.yml b/docs/porting/toc.yml index 1c743b4bc3d..6f05b7a6724 100644 --- a/docs/porting/toc.yml +++ b/docs/porting/toc.yml @@ -10,7 +10,7 @@ items: - name: Upgrade your code to the Universal CRT href: ../porting/upgrade-your-code-to-the-universal-crt.md - name: Modernize your C++ project with GitHub Copilot modernization - href: ../porting/copilot-modernization-cpp.md + href: ../porting/copilot-app-modernization-cpp.md - name: Update WINVER and _WIN32_WINNT href: ../porting/modifying-winver-and-win32-winnt.md - name: Fix your dependencies on library internals diff --git a/docs/porting/visual-cpp-porting-and-upgrading-guide.md b/docs/porting/visual-cpp-porting-and-upgrading-guide.md index 3035453a01a..64aa8a53e5e 100644 --- a/docs/porting/visual-cpp-porting-and-upgrading-guide.md +++ b/docs/porting/visual-cpp-porting-and-upgrading-guide.md @@ -61,7 +61,7 @@ ms.author: twhitney - [⬆️ Upgrading C++ Projects to Visual Studio 2026](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/) - [⬆️ Upgrade projects from earlier versions](upgrading-projects-from-earlier-versions-of-visual-cpp.md) -- [🤖 Upgrade with an AI agent (preview)](copilot-modernization-cpp.md) +- [🤖 Upgrade with an AI agent (preview)](copilot-app-modernization-cpp.md) - [🛠️ IDE tools for upgrading C++ code](ide-tools-for-upgrading-code.md) - [🔄 Upgrade to Universal CRT](upgrade-your-code-to-the-universal-crt.md) - [🔧 Update WINVER and _WIN32_WINNT](modifying-winver-and-win32-winnt.md) From 9887e500c42f14912d7b697f551167741134dc7c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 10 Mar 2026 17:33:58 -0700 Subject: [PATCH 1701/1799] add conformance update --- docs/overview/visual-cpp-language-conformance.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index ed623aaf45c..5173801df0e 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ language conformance" description: "Microsoft C and C++ conformance updates by Visual Studio version." -ms.date: 11/10/2025 +ms.date: 03/10/2026 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- @@ -21,6 +21,8 @@ For details on conformance improvements, see [C++ conformance improvements in Vi | **C++03/11 Core language features** | **Supported** | |  Everything else | VS 2015 [A](#note_A) | |  Two-phase name lookup | VS 2017 15.7 [B](#note_B) | +|  [`CN2634 Expression SFINAE`](https://wg21.link/N2634) | VS 2017 15.7 | +|  [`CWG 1213 Value category of arrays and subscripts`](https://cplusplus.github.io/CWG/issues/1213.html) | VS 2022 17.14 | |  [`N2634 Expression SFINAE`](https://wg21.link/N2634) | VS 2017 15.7 | |  [`N1653 C99 preprocessor`](https://wg21.link/N1653) | VS 2019 16.6 [C](#note_C) | | **C++03/11 Core language features (Defect reports)** | **Supported** | @@ -219,6 +221,7 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P2513R4 char8_t Compatibility and Portability Fix`](https://wg21.link/p2513r4) | VS 2022 17.4 [DR](#note_DR) | |  [`P2579R0 Mitigation strategies for P2036 "Changing scope for lambda trailing-return-type"`](https://wg21.link/p2579r0) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2582R1 Wording for class template argument deduction from inherited constructors`](https://wg21.link/p2582r1) | no | +|  [`P2589R1 static operator[]`](https://wg21.link/p2589r1) | VS 2022 17.14 [23](#note_23) | ## C++ Standard library features From d7e3b64284455bb06e2a860f8725197db17b7941 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 10 Mar 2026 17:35:37 -0700 Subject: [PATCH 1702/1799] typo --- docs/overview/visual-cpp-language-conformance.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 5173801df0e..698a03e2b9f 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -21,7 +21,6 @@ For details on conformance improvements, see [C++ conformance improvements in Vi | **C++03/11 Core language features** | **Supported** | |  Everything else | VS 2015 [A](#note_A) | |  Two-phase name lookup | VS 2017 15.7 [B](#note_B) | -|  [`CN2634 Expression SFINAE`](https://wg21.link/N2634) | VS 2017 15.7 | |  [`CWG 1213 Value category of arrays and subscripts`](https://cplusplus.github.io/CWG/issues/1213.html) | VS 2022 17.14 | |  [`N2634 Expression SFINAE`](https://wg21.link/N2634) | VS 2017 15.7 | |  [`N1653 C99 preprocessor`](https://wg21.link/N1653) | VS 2019 16.6 [C](#note_C) | From 53928db56bd795ad2c65a83e3288c0fcf0f9f40d Mon Sep 17 00:00:00 2001 From: Michael Price Date: Wed, 11 Mar 2026 08:25:35 -0500 Subject: [PATCH 1703/1799] Updating the image for the setting since the string in the product changed. Now it matches what the text in the doc says. --- .../enable-copilot-app-modernization-cpp.png | Bin 59288 -> 68520 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/docs/porting/media/enable-copilot-app-modernization-cpp.png b/docs/porting/media/enable-copilot-app-modernization-cpp.png index 3e0047e42ccd7aa583274f07eae9a1ae0534886b..2a9c96019132beb8948d909e566dfcea76d1a052 100644 GIT binary patch literal 68520 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 @zB?m`i)qGGmh>ezZ^>?b@a5y{=H)pqsUKI2 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

1%5q|nBso<6VE=VPK4R&1( z%gJ=UWz#b5UU*eIL#oTB)7J(&o#-oE3_HKIG(79NP;}@+v%KhawWQF2^38kPYkYqp zUZJ%0Xi`rRi`Fg#6;Jhx)2$D1h;jHAr6r4GEUu585qTV36@#rn-W0<(TF7ubC z(m=hBtux*Tm~3lF71AsPD5dIP_#q7Xk5UzU6xnNqT#``3Qu2W}2(=_6qBrnCpOjfOQoe7T&YM zUeH}OM0-3cR+q`))Hh|*kE?p&-}2mlGWX8=lIe57>eqenTEgOaSNMDjfqHbtc zNUa)QZQfV*R+&}`(~>JQJ5QGA-UFp^6TK{%eD_2cV>wIfLV`VmOk_8=3BucQ`GEiF zk(LbDfZ1A-u{Z83Y_UnKzX;c6cze-oVASpS+f`0wV8 zf#k>Y9@+(Bs}FKQ;o4^qZkc$-r|ui>pP6(twtmK>-t7@QA5l2=V5*ZcH4Oss)sP zL&U$d!rrh70jmr5!{V3lw>@2aR^r1iZf213u1yu0Il|C}#|cmx#Xlk)aiO^=-dM$j z?{N@)Atkf8dFTS12NL7lWGuURqBo7Dw;oi*NM(=*0_vcDOOF*0>GU zzg?QHyExU}>XAR@LMNz1ua@G>2VN1XaT+%vvepTyVW3AR8b<1jzdQpbY-n-Mumhsg zTU=;{%GV~E#FE)-b;ncauitC}=W#3STT|h8PfUIxb{Bclj%-f~Sc7 z1IES6vns^AGdO2WOlbk>aP~+)P8&jU<@Hz%j>t4L;oc#D7fyjasX*a|3xfhOJ5^%c z$>neF!5Yee3M(TclU|F4ash|!Rrk4=sbR$pFS3_XQysPw2cz)syE1P3Tbjd~3VIrR5EB~v7^J0dmoBTbTsm*LAo9wFea@|HkCzn%v5Zc< z&6)B%dBIz~+}UPuOMxf)(mm<)3e|;HY--qB-*ZVFagmDE0r(KvW8Cw~9wY|#p+|IK zI{&Yd+RZ52ItEPN?}BJ2PiTYq+E^H2|3I;D-hM=xeL@-C2Lv))$pGO>8ikrhsNc1{;0_ly@qDw{h?sNlGm;0~NDlONZb z`nVL9M|u&{g9$3K#xB?*p*Ae32ExkhLRWA4>DKitqJz9tgMxa0qy6j8c1~ejgmyKv z_Vfk6yqQUw&c?L z%SPJX2TFpvDO%Bp%oUf`gXs@@>Q49+Wci@J79CjvLRz=?+O~5RK1>^ZHIr8GKCpXr zC*hh5V4vG_Mzxe0`6FlyL7ibsf4BVN?>0OS0*7Q~N=;LQo9BrOd;WIGV4 zzH{*~EmgLha>NIYE`c3`#te4{pYzuS!0RK)Oa8Q!`brLoS4ZmA~vPY&8!$oKt0LI_;Uj$z;^P5-}lr9!X}WONf}?lTzC&^sam z^wAI+3%z#7E0sUMiN^m+UUske0xqrg%nZvclPEUfF1Q)`E3!ADc4KH1<`cQ%*KWjo zXl8t36^2y(^L<;*XMv zhDEg%an=u!Bo&8U`+%35rYVX2wn)G&L$;?x&WroXbgjsa5trFDQ9zC- zvN%($Bwkr+i>gQS1iNBN4vI(uQlAp`OFewK1P&eiGw2r9;@p~And*Fzi}Oh^;Bxfq zj#Bx94}IHye?RMLN=I|YCuUng0hp>3nZH~-&i?hU?;f!BwV}soJC2RF-yf!K^u Date: Fri, 24 Oct 2025 11:35:45 -0700 Subject: [PATCH 1390/1799] draft --- ...e-github-copilot-create-cpp-console-app.md | 27 ++++++++++--------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/docs/build/use-github-copilot-create-cpp-console-app.md b/docs/build/use-github-copilot-create-cpp-console-app.md index b59e4fcbef0..5ad9c728b54 100644 --- a/docs/build/use-github-copilot-create-cpp-console-app.md +++ b/docs/build/use-github-copilot-create-cpp-console-app.md @@ -10,7 +10,7 @@ ms.custom: # Use GitHub Copilot to create a C++ console application in Visual Studio -This tutorial shows you how to use GitHub Copilot to quickly create a C++ console application in Visual Studio. You create a console based version of Conway's Game of Life, a classic cellular automaton. +This tutorial shows you how to use GitHub Copilot to quickly create a C++ console application in Visual Studio. You create a console version of Conway's Game of Life, a classic cellular automaton. Github Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. Some benefits of using Copilot when coding in C++: - Generate entire C++ functions or classes as you type. @@ -24,18 +24,18 @@ Github Copilot is an AI-powered coding assistant that helps you write code faste ## Prerequisites - Visual Studio 2022 or later with the **Desktop development with C++** workload installed. -- GitHub Copilot subscription and extension enabled in Visual Studio. +- GitHub Copilot subscription. For more information about a free GitHub Copilot subscription, see [Use GitHub Copilot for free in Visual Studio](/visualstudio/ide/copilot-free-plan). To verify you have the C++ workload installed: 1. Open Visual Studio Installer 1. Select **Modify** next to your Visual Studio installation 1. Ensure **Desktop development with C++** is checked: - :::image type="content" source="./media/desktop-development-cpp-workload" alt-text="Screenshot of the Visual Studio Installer with the Workloads tab selected. Desktop development with c++ is selected."::: + :::image type="content" source="./media/desktop-development-cpp-workload.png" alt-text="Screenshot of the Visual Studio Installer with the Workloads tab selected. Desktop development with c++ is selected."::: 1. If it isn't installed, select it and choose **Modify**. -- Install GitHub Copilot and have a GitHub copilot license. For more information, see [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states). +For more information about installing GitHub Copilot, see [Manage GitHub Copilot installation and state](/visualstudio/ide/visual-studio-github-copilot-install-and-states). ## Create a project @@ -47,18 +47,18 @@ To verify you have the C++ workload installed: :::image-end::: 1. Select **Next**. -1. Set the project name to **ConwayLife** and choose your desired location. +1. Set the project name to **ConwayLife** and choose the location for the project. 1. Select **Create**. -1. Once the project opens, locate the `ConwayLife.cpp` file in Solution Explorer. +1. Once the project opens, find the `ConwayLife.cpp` file in Solution Explorer. 1. Open `ConwayLife.cpp` and delete all the existing code to start with a clean slate. ## Use Copilot to create an app Use GitHub Copilot to generate the Conway's Game of Life implementation. -1. Open the Copilot Chat window by selecting the Copilot icon in the toolbar: +1. Open the Copilot chat window by selecting the Copilot icon in the toolbar: - :::image type="content" source="./media/github-copilot-open-chat.png" alt-text="Screenshot of the Github icon dropdown. Open Chat Window is selected."::: + :::image type="content" source="media/github-copilot-open-chat.png" alt-text="Screenshot of the Github icon dropdown. Open Chat Window is selected."::: 1. In the chat window, enter the following prompt: @@ -72,10 +72,10 @@ Create a C++ console application that implements Conway's Game of Life. The prog - Clear the console between generations to provide an animation effect ``` -3. Copilot generates C++ code for Conway's Game of Life. -4. Copy the generated code and paste it into your empty `life.cpp` file. -5. Build the project by pressing **F6** or selecting **Build > Build Solution**. -6. Run the program by pressing **F5** or **Ctrl+F5**. +1. Copilot generates C++ code for Conway's Game of Life. +1. Copy the generated code and paste it into your empty `life.cpp` file. +1. Build the project by pressing **F6** or selecting **Build > Build Solution**. +1. Run the program by pressing **F5** or **Ctrl+F5**. > [!NOTE] > The exact code generated by Copilot may vary slightly from run to run and model to model, but the core functionality should be consistent. If the generated code doesn't compile immediately, you can ask Copilot to fix any compilation errors. GitHub Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot FAQs](https://aka.ms/copilot-general-use-faqs). @@ -241,5 +241,6 @@ If you can't find the Console App template: ## Next steps -- [GitHub Copilot documentation](https://docs.github.com/en/copilot) - Dive deeper into AI-assisted development +- [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states)\ +- [GitHub Copilot documentation](https://docs.github.com/en/copilot) - Dive deeper into AI-assisted development\ - [Awesome ChatGPT Prompts](https://github.com/f/awesome-chatgpt-prompts) - Community-driven prompting examples for inspiration \ No newline at end of file From 39f1ff01706122b274e0d7879701eb65767e5b24 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 24 Oct 2025 14:11:51 -0700 Subject: [PATCH 1391/1799] draft --- .../{Conway-Life-exe.png => life-exe.png} | Bin ...e-github-copilot-create-cpp-console-app.md | 71 +++++++++--------- 2 files changed, 36 insertions(+), 35 deletions(-) rename docs/build/media/{Conway-Life-exe.png => life-exe.png} (100%) diff --git a/docs/build/media/Conway-Life-exe.png b/docs/build/media/life-exe.png similarity index 100% rename from docs/build/media/Conway-Life-exe.png rename to docs/build/media/life-exe.png diff --git a/docs/build/use-github-copilot-create-cpp-console-app.md b/docs/build/use-github-copilot-create-cpp-console-app.md index 5ad9c728b54..accd7e1b63d 100644 --- a/docs/build/use-github-copilot-create-cpp-console-app.md +++ b/docs/build/use-github-copilot-create-cpp-console-app.md @@ -1,14 +1,14 @@ --- -title: Use GitHub Copilot to create a C++ console application in Visual Studio +title: Use AI to create a C++ console application in Visual Studio description: "Learn how to use GitHub Copilot to create a C++ app using Microsoft C++ in Visual Studio." -ms.date: 10/23/2025 +ms.date: 10/24/2025 ms.topic: "tutorial" ms.custom: - ai-assisted - copilot-scenario-highlight --- -# Use GitHub Copilot to create a C++ console application in Visual Studio +# Use AI to create a C++ console application in Visual Studio This tutorial shows you how to use GitHub Copilot to quickly create a C++ console application in Visual Studio. You create a console version of Conway's Game of Life, a classic cellular automaton. @@ -24,21 +24,23 @@ Github Copilot is an AI-powered coding assistant that helps you write code faste ## Prerequisites - Visual Studio 2022 or later with the **Desktop development with C++** workload installed. -- GitHub Copilot subscription. For more information about a free GitHub Copilot subscription, see [Use GitHub Copilot for free in Visual Studio](/visualstudio/ide/copilot-free-plan). +- GitHub Copilot. For more information, see [Get started with GitHub Copilot](/visualstudio/ide/visual-studio-github-copilot-get-started). To verify you have the C++ workload installed: 1. Open Visual Studio Installer 1. Select **Modify** next to your Visual Studio installation 1. Ensure **Desktop development with C++** is checked: - :::image type="content" source="./media/desktop-development-cpp-workload.png" alt-text="Screenshot of the Visual Studio Installer with the Workloads tab selected. Desktop development with c++ is selected."::: + :::image type="content" source="media/desktop-development-cpp-workload.png" alt-text="Screenshot of the Visual Studio Installer with the Workloads tab selected. Desktop development with c++ is selected."::: 1. If it isn't installed, select it and choose **Modify**. -For more information about installing GitHub Copilot, see [Manage GitHub Copilot installation and state](/visualstudio/ide/visual-studio-github-copilot-install-and-states). +For more information about installing Copilot, see [Manage GitHub Copilot installation and state](/visualstudio/ide/visual-studio-github-copilot-install-and-states). ## Create a project +Visual Studio uses *projects* to organize the code for an app, and *solutions* to organize your projects. A project contains all the options, configurations, and rules used to build your apps. It manages the relationship between all the project's files and any external files. To create your app, first, create a new project and solution. + 1. Open Visual Studio and select **Create a new project**. 1. Search for "Console App" and select the **Console App** template for C++. @@ -50,35 +52,33 @@ For more information about installing GitHub Copilot, see [Manage GitHub Copilot 1. Set the project name to **ConwayLife** and choose the location for the project. 1. Select **Create**. 1. Once the project opens, find the `ConwayLife.cpp` file in Solution Explorer. -1. Open `ConwayLife.cpp` and delete all the existing code to start with a clean slate. +1. Open `ConwayLife.cpp` and delete the default "Hello, World!" code to start with a clean slate. ## Use Copilot to create an app -Use GitHub Copilot to generate the Conway's Game of Life implementation. +You prompt Copilot by describing the functionality you want. Here's an example of how to prompt Copilot to generate an implementation of Conway's Game of Life. 1. Open the Copilot chat window by selecting the Copilot icon in the toolbar: :::image type="content" source="media/github-copilot-open-chat.png" alt-text="Screenshot of the Github icon dropdown. Open Chat Window is selected."::: 1. In the chat window, enter the following prompt: - -``` -Create a C++ console application that implements Conway's Game of Life. The program should: -- Use a 40x20 grid displayed with asterisks (*) for live cells and spaces for dead cells -- Start with a random initial pattern -- Display each generation for 500ms before showing the next -- Allow the user to press any key to exit the program -- Include proper headers and use standard C++ practices -- Clear the console between generations to provide an animation effect -``` - + ```copilot-prompt + Create a C++ console application that implements Conway's Game of Life. The program should: + - Use a 40x20 grid displayed with asterisks (*) for live cells and spaces for dead cells + - Start with a random initial pattern + - Display each generation for 500ms before showing the next + - Allow the user to press any key to exit the program + - Include proper headers and use standard C++ practices + - Clear the console between generations to provide an animation effect + ``` 1. Copilot generates C++ code for Conway's Game of Life. 1. Copy the generated code and paste it into your empty `life.cpp` file. 1. Build the project by pressing **F6** or selecting **Build > Build Solution**. 1. Run the program by pressing **F5** or **Ctrl+F5**. > [!NOTE] -> The exact code generated by Copilot may vary slightly from run to run and model to model, but the core functionality should be consistent. If the generated code doesn't compile immediately, you can ask Copilot to fix any compilation errors. GitHub Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot FAQs](https://aka.ms/copilot-general-use-faqs). +> The exact code generated by Copilot may vary slightly from run to run and model to model, but the core functionality should be consistent. If the generated code doesn't compile immediately, you can ask Copilot to fix any compilation errors. Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot FAQs](https://aka.ms/copilot-general-use-faqs). ### Example of typical generated code structure @@ -89,7 +89,7 @@ Your generated code likely includes these components: - Functions to initialize the grid, apply Conway's rules, and display the current state - A main loop that continues until a key is pressed -Here is an example of the code that GitHub Copilot generated given the previous prompt: +Here is an example of the code that Copilot generated given the previous prompt: ```cpp // Code generated by GitHub Copilot @@ -198,15 +198,15 @@ int main() ``` When you run the application, you should see an animated display of Conway's Game of Life with patterns evolving over time. To exit the program, press a key. -:::image type="content" source="./media/conway-life-exe.png" alt-text="Screenshot of Conway Life running in a command window, displaying the evolving grid of cells."::: +:::image type="content" source="./media/life-exe.png" alt-text="Screenshot of Conway Life running in a command window, displaying the evolving grid of cells."::: -In the code example, the code generates a warning: `Return value ignored: '_getch'`. You can ask GitHub Copilot to fix it. Select the code editor and press **Alt+/** (Windows) to open the Copilot chat, then enter: +In the code example, the code generates a warning: `Return value ignored: '_getch'`. You can ask Copilot to fix it. Select the code editor and press **Alt+/** (Windows) to open the Copilot chat, then enter: -:::image type="content" source="./media/github-copilot-fix-warning.png" alt-text="Screenshot of the GitHub Copilot chat window. The text: Fix warning C6031 is in the chat window."::: +:::image type="content" source="./media/github-copilot-fix-warning.png" alt-text="Screenshot of the Copilot chat window. The text: Fix warning C6031 is in the chat window."::: -GitHub Copilot suggests a fix to handle the return value properly. To accept the changes, press the Tab key: +Copilot suggests a fix to handle the return value properly. To accept the changes, press the Tab key: -:::image type="content" source="./media/github-copilot-fix-warning-accept.png" alt-text="Screenshot of the GitHub Copilot proposed changes. Tab to accept. Alt+Del to discard."::: +:::image type="content" source="./media/github-copilot-fix-warning-accept.png" alt-text="Screenshot of the Copilot proposed changes. Tab to accept. Alt+Del to discard."::: Congratulations! You successfully used GitHub Copilot to create a fully functional Conway's Game of Life console application in C++. You learned how to: @@ -216,7 +216,7 @@ Congratulations! You successfully used GitHub Copilot to create a fully function ## Improve your prompting skills -For better results with GitHub Copilot, consider these prompting resources: +For better results with Copilot, see these prompting resources: - [GitHub Copilot documentation](https://docs.github.com/en/copilot) - Official best practices and tips - [OpenAI's GPT best practices](https://platform.openai.com/docs/guides/prompt-engineering) - General AI prompting techniques @@ -224,20 +224,21 @@ For better results with GitHub Copilot, consider these prompting resources: ## Troubleshooting -### Missing C++ desktop workload -If you can't find the Console App template: -1. Install the **Desktop development with C++** workload through Visual Studio Installer -2. Restart Visual Studio after installation +### Missing console app template + +The **New Project** dialog should show a **Console App** template that has **C++**, **Windows**, and **Console** tags. If you don't see it, it might be filtered out of the list, or it might not be installed. First, check the filter dropdowns at the top of the list of templates. Set them to **C++**, **Windows**, and **Console**. The C++ **Console App** template should appear; otherwise, the **Desktop development with C++** workload isn't installed. + +To install **Desktop development with C++**, you can run the installer right from the **Create a new project** dialog. Choose the **Install more tools and features** link at the bottom of the **Create a new project** dialog, beneath the list of templates. If the **User Account Control** dialog requests permissions, choose **Yes**. In the installer, make sure the **Desktop development with C++** workload is checked. Then choose **Modify** to update your Visual Studio installation. ### Copilot not responding -- Ensure you have an active GitHub Copilot subscription -- Check that the GitHub Copilot extension is enabled in Visual Studio + +- Ensure you have an active GitHub Copilot subscription. - Try signing out and back into your GitHub account in Visual Studio ### Generated code doesn't compile + - Ask Copilot to fix specific compilation errors by pasting the error message into Copilot chat. -- Try refining your prompt to be more specific about C++ standards or requirements. -- Ensure all necessary headers are included (Copilot usually handles this automatically). +- Try refining your prompt to be more specific about what you want the app to do. ## Next steps From 5f2c38ffe85ccf9d7ee24804f9281debf5f96c0e Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 24 Oct 2025 14:27:16 -0700 Subject: [PATCH 1392/1799] draft --- ...e-github-copilot-create-cpp-console-app.md | 26 ++++++++++--------- 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/docs/build/use-github-copilot-create-cpp-console-app.md b/docs/build/use-github-copilot-create-cpp-console-app.md index accd7e1b63d..4797c8f81ba 100644 --- a/docs/build/use-github-copilot-create-cpp-console-app.md +++ b/docs/build/use-github-copilot-create-cpp-console-app.md @@ -12,7 +12,9 @@ ms.custom: This tutorial shows you how to use GitHub Copilot to quickly create a C++ console application in Visual Studio. You create a console version of Conway's Game of Life, a classic cellular automaton. -Github Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. Some benefits of using Copilot when coding in C++: +Conway's Game of Life was devised by mathematician John Conway. It consists of a grid of cells that can be either alive or dead. The game evolves automatically based on simple rules and produces complex, evolving patterns that demonstrate how intricate behavior can emerge from basic mathematical rules. + +GitHub Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. Some benefits of using Copilot when coding in C++: - Generate entire C++ functions or classes as you type. - Suggest code completions based on plain-language comments or prompts. - Get help with complex algorithms, data structures, and standard library usage. @@ -44,19 +46,19 @@ Visual Studio uses *projects* to organize the code for an app, and *solutions* t 1. Open Visual Studio and select **Create a new project**. 1. Search for "Console App" and select the **Console App** template for C++. - :::image type="complex" source="media/vs2019-choose-console-app.png" alt-text="Screenshot of the create a new project dialog."::: - The create a new project dialog with the Console App template selected. That template says: Run code in a windows terminal. Prints hello world by default. Has the tags c++, Windows, and Console. + :::image type="complex" source="media/vs2019-choose-console-app.png" alt-text="Screenshot of the Create a new project dialog."::: + The Create a new project dialog is shown with the Console App template selected. The template says: Run code in a windows terminal. Prints hello world by default. Has the tags c++, Windows, and Console. :::image-end::: 1. Select **Next**. -1. Set the project name to **ConwayLife** and choose the location for the project. +1. Set the project name to **Life** and choose the location for the project. 1. Select **Create**. -1. Once the project opens, find the `ConwayLife.cpp` file in Solution Explorer. -1. Open `ConwayLife.cpp` and delete the default "Hello, World!" code to start with a clean slate. +1. Once the project opens, find the `Life.cpp` file in Solution Explorer. +1. Open `Life.cpp` and delete the default "Hello, World!" code to start with a clean slate. ## Use Copilot to create an app -You prompt Copilot by describing the functionality you want. Here's an example of how to prompt Copilot to generate an implementation of Conway's Game of Life. +You prompt Copilot by describing the functionality you want. In this section, you'll learn how to prompt Copilot to generate an implementation of Conway's Game of Life. 1. Open the Copilot chat window by selecting the Copilot icon in the toolbar: @@ -73,7 +75,7 @@ You prompt Copilot by describing the functionality you want. Here's an example o - Clear the console between generations to provide an animation effect ``` 1. Copilot generates C++ code for Conway's Game of Life. -1. Copy the generated code and paste it into your empty `life.cpp` file. +1. Copy the generated code and paste it into your empty `Life.cpp` file. 1. Build the project by pressing **F6** or selecting **Build > Build Solution**. 1. Run the program by pressing **F5** or **Ctrl+F5**. @@ -82,14 +84,14 @@ You prompt Copilot by describing the functionality you want. Here's an example o ### Example of typical generated code structure -Your generated code likely includes these components: +Your generated code will likely include these key components: - Headers for console manipulation, random number generation, and timing - A 2D array or vector to represent the game grid - Functions to initialize the grid, apply Conway's rules, and display the current state - A main loop that continues until a key is pressed -Here is an example of the code that Copilot generated given the previous prompt: +Here's an example of the code that Copilot generated using the previous prompt: ```cpp // Code generated by GitHub Copilot @@ -200,11 +202,11 @@ When you run the application, you should see an animated display of Conway's Gam :::image type="content" source="./media/life-exe.png" alt-text="Screenshot of Conway Life running in a command window, displaying the evolving grid of cells."::: -In the code example, the code generates a warning: `Return value ignored: '_getch'`. You can ask Copilot to fix it. Select the code editor and press **Alt+/** (Windows) to open the Copilot chat, then enter: +In the preceding code example, the code generates a warning: `Return value ignored: '_getch'`. You can ask Copilot to fix it. Select the code editor and press **Alt+/** (Windows) to open the Copilot chat, then enter: :::image type="content" source="./media/github-copilot-fix-warning.png" alt-text="Screenshot of the Copilot chat window. The text: Fix warning C6031 is in the chat window."::: -Copilot suggests a fix to handle the return value properly. To accept the changes, press the Tab key: +Copilot suggests a fix to handle the return value properly. To accept the changes, select **Tab**: :::image type="content" source="./media/github-copilot-fix-warning-accept.png" alt-text="Screenshot of the Copilot proposed changes. Tab to accept. Alt+Del to discard."::: From a82c21e039539194036057848ba14ab93f79fc39 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 24 Oct 2025 14:42:54 -0700 Subject: [PATCH 1393/1799] draft --- docs/build/vscpp-step-0-installation.md | 4 +--- docs/get-started/toc.yml | 2 +- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/build/vscpp-step-0-installation.md b/docs/build/vscpp-step-0-installation.md index 0a5311c1fd1..903016883ab 100644 --- a/docs/build/vscpp-step-0-installation.md +++ b/docs/build/vscpp-step-0-installation.md @@ -128,7 +128,7 @@ Some benefits of using Copilot for your C++ coding scenarios: - Debug errors in your code. - Simplify and refactor existing code. -To install GitHub Copilot, see [Manage GitHub Copilot installation and state](/visualstudio/ide/visual-studio-github-copilot-install-and-states). +To try GitHub copilot to create a C++ app, follow the instructions in [Use AI to create a C++ console application in Visual Studio](../build/use-github-copilot-create-cpp-console-app.md). ::: moniker-end @@ -225,9 +225,7 @@ You can reduce the installation footprint of Visual Studio on your system drive. ### Step 8 - Start developing 1. After Visual Studio installation is complete, choose the **Launch** button to get started developing with Visual Studio. - 1. On the start window, choose **Create a new project**. - 1. In the search box, enter the type of app you want to create to see a list of available templates. The list of templates depends on the workloads that you chose during installation. To see different templates, choose different workloads. You can also filter your search for a specific programming language by using the **Language** dropdown list. You can filter by using the **Platform** list and the **Project type** list, too. diff --git a/docs/get-started/toc.yml b/docs/get-started/toc.yml index 382c539cf83..bc7a83fb976 100644 --- a/docs/get-started/toc.yml +++ b/docs/get-started/toc.yml @@ -6,7 +6,7 @@ items: href: ../build/vscpp-step-0-installation.md - name: Visual Studio guided tour href: /visualstudio/get-started/visual-studio-ide - - name: Use GitHub Copilot to create a C++ console application in Visual Studio + - name: Use AI to create a C++ console application in Visual Studio href: ../build/use-github-copilot-create-cpp-console-app.md - name: Create and edit a C++ console app project href: ../build/vscpp-step-1-create.md From 9d771a908c7544eb8b38574a041ed9ec57551d35 Mon Sep 17 00:00:00 2001 From: Jill Grant <72043882+JillGrant615@users.noreply.github.com> Date: Fri, 24 Oct 2025 16:55:36 -0600 Subject: [PATCH 1394/1799] Apply suggestions from code review --- docs/build/use-github-copilot-create-cpp-console-app.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/build/use-github-copilot-create-cpp-console-app.md b/docs/build/use-github-copilot-create-cpp-console-app.md index 4797c8f81ba..b70ab460381 100644 --- a/docs/build/use-github-copilot-create-cpp-console-app.md +++ b/docs/build/use-github-copilot-create-cpp-console-app.md @@ -62,7 +62,7 @@ You prompt Copilot by describing the functionality you want. In this section, yo 1. Open the Copilot chat window by selecting the Copilot icon in the toolbar: - :::image type="content" source="media/github-copilot-open-chat.png" alt-text="Screenshot of the Github icon dropdown. Open Chat Window is selected."::: + :::image type="content" source="media/github-copilot-open-chat.png" alt-text="Screenshot of the GitHub icon dropdown. Open Chat Window is selected."::: 1. In the chat window, enter the following prompt: ```copilot-prompt @@ -244,6 +244,6 @@ To install **Desktop development with C++**, you can run the installer right fro ## Next steps -- [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states)\ -- [GitHub Copilot documentation](https://docs.github.com/en/copilot) - Dive deeper into AI-assisted development\ +- [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states) +- [GitHub Copilot documentation](https://docs.github.com/en/copilot) - Dive deeper into AI-assisted development - [Awesome ChatGPT Prompts](https://github.com/f/awesome-chatgpt-prompts) - Community-driven prompting examples for inspiration \ No newline at end of file From b6041294c6d070bd6f06875a301a1c22b56170dc Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 24 Oct 2025 16:28:40 -0700 Subject: [PATCH 1395/1799] update version --- .../reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md | 2 +- ...time-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md | 2 +- docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md | 2 +- .../reference/gmtime-s-gmtime32-s-gmtime64-s.md | 2 +- .../reference/localtime-localtime32-localtime64.md | 2 +- .../reference/localtime-s-localtime32-s-localtime64-s.md | 2 +- .../reference/mkgmtime-mkgmtime32-mkgmtime64.md | 2 +- docs/c-runtime-library/reference/mktime-mktime32-mktime64.md | 2 +- docs/c-runtime-library/reference/strnlen-strnlen-s.md | 2 +- docs/c-runtime-library/reference/time-time32-time64.md | 2 +- .../reference/timespec-get-timespec32-get-timespec64-get1.md | 2 +- .../reference/utime-utime32-utime64-wutime-wutime32-wutime64.md | 2 +- 12 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md index 94fb51c5db2..c6d21aac8eb 100644 --- a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md +++ b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md @@ -62,7 +62,7 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). >> [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `ctime` and `_wctime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `ctime` and `_wctime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index af343d723c7..12965dc90e2 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -125,7 +125,7 @@ The debug library versions of these functions first fill the buffer with 0xFE. T By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `ctime_s` and `_wctime_s` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `ctime_s` and `_wctime_s` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md index aaf84a4d8cc..82ac3231da3 100644 --- a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md +++ b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md @@ -57,7 +57,7 @@ The **`_gmtime32`** function breaks down the *`sourceTime`* value and stores it By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `gmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `gmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md index dd7a15de33e..36f21d43df4 100644 --- a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md +++ b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md @@ -77,7 +77,7 @@ Each of the structure fields is of type **`int`**, as shown in the following tab By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `gmtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `gmtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md index fbd9bbc8ae2..b5f537a55a0 100644 --- a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md +++ b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md @@ -73,7 +73,7 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `localtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `localtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index 4907ef32f45..430f90328b3 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -85,7 +85,7 @@ If the **`TZ`** environment variable is set, the C run-time library assumes rule By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `localtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `localtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md index 63e68cc2503..037c907886b 100644 --- a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md +++ b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md @@ -49,7 +49,7 @@ The range of the **`_mkgmtime32`** function is from midnight, January 1, 1970, U Both **`gmtime`** and **`localtime`** use a common static buffer for the conversion. If you supply this buffer to **`_mkgmtime`**, the previous contents are destroyed. > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_mkgmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `_mkgmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md index eb4af0a38fc..7f7bb31a6c9 100644 --- a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md +++ b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md @@ -63,7 +63,7 @@ These functions validate their parameter. If *`timeptr`* is a null pointer, the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `mktime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `mktime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/strnlen-strnlen-s.md b/docs/c-runtime-library/reference/strnlen-strnlen-s.md index 12b2cedae88..ba5972caaec 100644 --- a/docs/c-runtime-library/reference/strnlen-strnlen-s.md +++ b/docs/c-runtime-library/reference/strnlen-strnlen-s.md @@ -89,7 +89,7 @@ Each of these functions returns the number of characters in *`str`*, not includi By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `strnlen_s` and `wcsnlen_s` are no longer `static inline` (internal linkage). Instead, they are `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `strnlen_s` and `wcsnlen_s` are no longer `static inline` (internal linkage). Instead, they are `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/time-time32-time64.md b/docs/c-runtime-library/reference/time-time32-time64.md index 049d5450138..1087f1997a6 100644 --- a/docs/c-runtime-library/reference/time-time32-time64.md +++ b/docs/c-runtime-library/reference/time-time32-time64.md @@ -37,7 +37,7 @@ The **`time`** function returns the number of seconds elapsed since midnight (00 **`time`** is a wrapper for **`_time64`** and **`time_t`** is, by default, equivalent to **`__time64_t`**. If you need to force the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, you can define `_USE_32BIT_TIME_T`. We don't recommend `_USE_32BIT_TIME_T`, because your application may fail after January 18, 2038; the use of this macro isn't allowed on 64-bit platforms. > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `time` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `time` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md index ebc60ea0b92..fea1cd33a5a 100644 --- a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md +++ b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md @@ -56,7 +56,7 @@ These functions support only `TIME_UTC` as the *`base`* value. `TIME_UTC` sets t By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `timespec_get` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `timespec_get` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. diff --git a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md index 07641eeece6..84b91e8d2ea 100644 --- a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md +++ b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md @@ -85,7 +85,7 @@ Specific versions of the `_utimbuf` structure (`__utimbuf32` and `__utimbuf64`) By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> When you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_utime` and `_wutime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `_utime` and `_wutime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. From e267562074d61e6ef0f0b5291f86b16b3a380471 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 24 Oct 2025 16:30:53 -0700 Subject: [PATCH 1396/1799] fix stray version # --- .../reference/difftime-difftime32-difftime64.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md index 1eb22965f30..b1512299fa8 100644 --- a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md +++ b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md @@ -46,7 +46,7 @@ These functions validate their parameters. If either of the parameters is zero o By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `difftime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> If you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `difftime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. From 7c6d1262c83eb51561a51f2bc257d2c056f605de Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 24 Oct 2025 16:32:58 -0700 Subject: [PATCH 1397/1799] fix one more stray --- .../reference/futime-futime32-futime64.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/c-runtime-library/reference/futime-futime32-futime64.md b/docs/c-runtime-library/reference/futime-futime32-futime64.md index 71e48e02fdc..43712b04947 100644 --- a/docs/c-runtime-library/reference/futime-futime32-futime64.md +++ b/docs/c-runtime-library/reference/futime-futime32-futime64.md @@ -52,7 +52,7 @@ The **`_futime`** routine sets the modification date and the access time on the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). > [!Note] -> If you use Windows SDK version 10.0.xxxxx.xxxx and Visual Studio 2026 or later together, `_futime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> If you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `_futime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. @@ -60,9 +60,9 @@ By default, this function's global state is scoped to the application. To change | Function | Required header | Optional header | |---|---|---| -| **`_futime`** | \ | \ | -| **`_futime32`** | \ | \ | -| **`_futime64`** | \ | \ | +| **`_futime`** | `` | `` | +| **`_futime32`** | `` | `` | +| **`_futime64`** | `` | `` | For more compatibility information, see [Compatibility](../compatibility.md). From d33d8b89eeb047c2d5b46b3ca69205bd1056af9a Mon Sep 17 00:00:00 2001 From: Jill Grant <72043882+JillGrant615@users.noreply.github.com> Date: Fri, 24 Oct 2025 17:48:19 -0600 Subject: [PATCH 1398/1799] Update docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md --- .../reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md index c6d21aac8eb..3f03733bda5 100644 --- a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md +++ b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md @@ -61,7 +61,7 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). ->> [!Note] +> [!Note] > When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `ctime` and `_wctime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ > To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ > This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. From 36738035d38d4d2ab474a3f4681366fa341a6f6c Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Wed, 29 Oct 2025 02:24:11 -0700 Subject: [PATCH 1399/1799] Branding updates (#6129) * Updated MSVC branding for /docs/assembler * Reverted unnecessary branding change in /assembler/inline/inline-assembler-overview * All remaining MSVC branding changes except /porting folder; this will be covered by a separate PR to update those docs * minor updates --------- Co-authored-by: Augustin Popa --- .../arm-assembler-command-line-reference.md | 2 +- docs/assembler/inline/asm.md | 2 +- .../instruction-set-for-inline-assembly.md | 2 +- .../inline/intel-s-mmx-instruction-set.md | 2 +- docs/build/arm64-windows-abi-conventions.md | 2 +- docs/build/arm64ec-windows-abi-conventions.md | 4 +- ...pplications-and-side-by-side-assemblies.md | 4 +- docs/build/building-on-the-command-line.md | 12 +++--- docs/build/cmake-presets-vs.md | 6 +-- docs/build/cmake-projects-in-visual-studio.md | 2 +- docs/build/cmakesettings-reference.md | 2 +- ...mmon-visual-cpp-64-bit-migration-issues.md | 10 ++--- .../common-visual-cpp-arm-migration-issues.md | 10 ++--- docs/build/compare-inclusion-methods.md | 2 +- ...pplications-and-side-by-side-assemblies.md | 4 +- ...figuring-programs-for-64-bit-visual-cpp.md | 6 +-- ...-programs-for-arm-processors-visual-cpp.md | 2 +- .../creating-precompiled-header-files.md | 2 +- ...termining-which-exporting-method-to-use.md | 2 +- docs/build/dlls-in-visual-cpp.md | 2 +- docs/build/exception-handling-x64.md | 2 +- .../exporting-from-a-dll-using-def-files.md | 2 +- ...-visual-cpp-toolset-on-the-command-line.md | 2 +- ...e-target-framework-and-platform-toolset.md | 4 +- docs/build/importing-using-def-files.md | 2 +- docs/build/msbuild-visual-cpp.md | 2 +- docs/build/overview-of-arm-abi-conventions.md | 4 +- docs/build/projects-and-build-systems-cpp.md | 8 ++-- docs/build/reference/c-cpp-prop-page.md | 2 +- docs/build/reference/fsanitize.md | 2 +- .../general-property-page-project.md | 2 +- docs/build/reference/linking.md | 4 +- .../microsoft-extensions-to-c-and-cpp.md | 2 +- .../reference/msbuild-visual-cpp-overview.md | 2 +- .../build/reference/vcxproj-file-structure.md | 4 +- .../reference/visual-cpp-project-types.md | 2 +- .../regular-dlls-statically-linked-to-mfc.md | 2 +- docs/build/run-time-library-behavior.md | 2 +- docs/build/stack-usage.md | 2 +- docs/build/toc.yml | 2 +- ...pplications-and-side-by-side-assemblies.md | 4 +- ...ing-custom-build-steps-and-build-events.md | 2 +- ...-manifest-generation-for-c-cpp-programs.md | 4 +- docs/build/vscpp-step-2-build.md | 2 +- ...compile-a-c-program-on-the-command-line.md | 2 +- ...g-a-cpp-cli-program-on-the-command-line.md | 6 +-- ...-native-cpp-program-on-the-command-line.md | 18 ++++----- ...ng-and-using-a-dynamic-link-library-cpp.md | 2 +- docs/build/walkthrough-header-units.md | 4 +- .../walkthrough-import-stl-header-units.md | 2 +- ...-msbuild-to-create-a-visual-cpp-project.md | 8 ++-- ...oating-point-numbers-may-lose-precision.md | 2 +- docs/build/working-with-project-properties.md | 2 +- ...cloud-and-web-programming-in-visual-cpp.md | 6 +-- .../build-reliable-secure-programs.md | 16 ++++---- .../code-analysis-for-c-cpp-overview.md | 2 +- .../using-the-cpp-core-guidelines-checkers.md | 2 +- ...wnload-and-install-the-embedded-tooling.md | 2 +- docs/get-started/toc.yml | 2 +- docs/get-started/tutorial-console-cpp.md | 2 +- ...-studio-ide-for-cpp-desktop-development.md | 4 +- docs/ide/writing-and-refactoring-code-cpp.md | 2 +- docs/intrinsics/arm-intrinsics.md | 2 +- docs/intrinsics/arm64-intrinsics.md | 2 +- docs/intrinsics/compiler-intrinsics.md | 2 +- docs/overview/compiler-versions.md | 38 +++++++++++-------- .../cpp-conformance-improvements-2019.md | 2 +- ...t-a-problem-with-the-visual-cpp-toolset.md | 6 +-- .../supported-platforms-visual-cpp.md | 10 ++--- docs/overview/toc.yml | 2 +- docs/overview/visual-cpp-in-visual-studio.md | 6 +-- .../visual-cpp-language-conformance.md | 4 +- ...-and-features-in-visual-studio-editions.md | 2 +- docs/sanitizers/asan-building.md | 1 - docs/sanitizers/asan-continue-on-error.md | 16 ++++---- docs/sanitizers/asan-flags.md | 2 +- docs/sanitizers/asan-known-issues.md | 2 +- docs/sanitizers/asan-runtime.md | 4 +- docs/sanitizers/asan.md | 4 +- .../error-stack-use-after-return.md | 4 +- .../security-best-practices-for-cpp.md | 2 +- ...-deployment-for-visual-cpp-applications.md | 12 +++--- ...-native-desktop-applications-visual-cpp.md | 18 ++++----- ...-using-the-vcpp-redistributable-package.md | 4 +- docs/windows/deployment-concepts.md | 6 +-- docs/windows/deployment-in-visual-cpp.md | 20 +++++----- docs/windows/toc.yml | 14 +++---- ...ependencies-of-a-visual-cpp-application.md | 10 ++--- ...pp-application-by-using-a-setup-project.md | 14 +++---- ...lication-to-an-application-local-folder.md | 18 ++++----- 90 files changed, 231 insertions(+), 226 deletions(-) diff --git a/docs/assembler/arm/arm-assembler-command-line-reference.md b/docs/assembler/arm/arm-assembler-command-line-reference.md index 6c79ceaf152..a686553e861 100644 --- a/docs/assembler/arm/arm-assembler-command-line-reference.md +++ b/docs/assembler/arm/arm-assembler-command-line-reference.md @@ -5,7 +5,7 @@ ms.date: 05/09/2022 --- # ARM Assembler command-line reference -The Microsoft ARM assemblers, **armasm** and **armasm64**, support several command-line options. By default, **armasm** assembles ARMv7 Thumb assembly language into the Microsoft implementation of the Common Object File Format (COFF). The **armasm64** assembler creates COFF object code for ARM64 and ARM64EC targets. The linker can link COFF code objects produced by both the ARM assembler and the C/C++ compiler. It can link either together with object libraries created by the librarian. +The Microsoft ARM assemblers, **armasm** and **armasm64**, support several command-line options. By default, **armasm** assembles ARMv7 Thumb assembly language into the Microsoft implementation of the Common Object File Format (COFF). The **armasm64** assembler creates COFF object code for ARM64 and ARM64EC targets. The linker can link COFF code objects produced by both the ARM assembler and the MSVC compiler. It can link either together with object libraries created by the librarian. ## Syntax diff --git a/docs/assembler/inline/asm.md b/docs/assembler/inline/asm.md index a14c0854693..78787c9492b 100644 --- a/docs/assembler/inline/asm.md +++ b/docs/assembler/inline/asm.md @@ -13,7 +13,7 @@ helpviewer_keywords: ["__asm keyword [C++], vs. asm blocks", "__asm keyword [C++ The **`__asm`** keyword invokes the inline assembler and can appear wherever a C or C++ statement is legal. It can't appear by itself. It must be followed by an assembly instruction, a group of instructions enclosed in braces, or, at minimum, an empty pair of braces. The term "**`__asm`** block" here refers to any instruction or group of instructions, whether or not in braces. > [!NOTE] -> Visual C++ support for the Standard C++ **`asm`** keyword is limited to the fact that the compiler will not generate an error on the keyword. However, an **`asm`** block will not generate any meaningful code. Use **`__asm`** instead of **`asm`**. +> MSVC support for the Standard C++ **`asm`** keyword is limited to the fact that the compiler will not generate an error on the keyword. However, an **`asm`** block will not generate any meaningful code. Use **`__asm`** instead of **`asm`**. ## Grammar diff --git a/docs/assembler/inline/instruction-set-for-inline-assembly.md b/docs/assembler/inline/instruction-set-for-inline-assembly.md index 13b356b5264..bbcdcbd635e 100644 --- a/docs/assembler/inline/instruction-set-for-inline-assembly.md +++ b/docs/assembler/inline/instruction-set-for-inline-assembly.md @@ -10,7 +10,7 @@ ms.assetid: a45b5b22-9b5f-4545-81ec-70eb8ea2ef9b **Microsoft Specific** -The Microsoft C++ compiler supports all opcodes through the Pentium 4 and AMD Athlon. Additional instructions supported by the target processor can be created with the [_emit Pseudoinstruction](../../assembler/inline/emit-pseudoinstruction.md). +The MSVC compiler supports all opcodes through the Pentium 4 and AMD Athlon. Additional instructions supported by the target processor can be created with the [_emit Pseudoinstruction](../../assembler/inline/emit-pseudoinstruction.md). **END Microsoft Specific** diff --git a/docs/assembler/inline/intel-s-mmx-instruction-set.md b/docs/assembler/inline/intel-s-mmx-instruction-set.md index eb492df28df..c66d08a1255 100644 --- a/docs/assembler/inline/intel-s-mmx-instruction-set.md +++ b/docs/assembler/inline/intel-s-mmx-instruction-set.md @@ -10,7 +10,7 @@ ms.assetid: 705deb2d-c3fd-4696-9e22-8bcf25866daf **Microsoft Specific** -The Microsoft C++ compiler allows you to use Intel's MMX (multimedia extension) instruction set in the inline assembler. The MMX instructions are also supported by the debugger disassembly. The compiler generates a warning message if the function contains MMX instructions but does not contain an EMMS instruction to empty the multimedia state. For more information, see the Intel Web site. +The MSVC compiler allows you to use Intel's MMX (multimedia extension) instruction set in the inline assembler. The MMX instructions are also supported by the debugger disassembly. The compiler generates a warning message if the function contains MMX instructions but does not contain an EMMS instruction to empty the multimedia state. For more information, see the Intel Web site. **END Microsoft Specific** diff --git a/docs/build/arm64-windows-abi-conventions.md b/docs/build/arm64-windows-abi-conventions.md index b5357e9bf3f..0d4f98ff387 100644 --- a/docs/build/arm64-windows-abi-conventions.md +++ b/docs/build/arm64-windows-abi-conventions.md @@ -260,5 +260,5 @@ The cycle counter here is a true cycle counter, not a wall clock. The counting f ## See also -[Common Visual C++ ARM Migration Issues](common-visual-cpp-arm-migration-issues.md)
+[Common Microsoft C++ ARM Migration Issues](common-visual-cpp-arm-migration-issues.md)
[ARM64 exception handling](arm64-exception-handling.md) diff --git a/docs/build/arm64ec-windows-abi-conventions.md b/docs/build/arm64ec-windows-abi-conventions.md index 9c78bc39f54..4cd9117c777 100644 --- a/docs/build/arm64ec-windows-abi-conventions.md +++ b/docs/build/arm64ec-windows-abi-conventions.md @@ -9,7 +9,7 @@ ARM64EC is an application binary interface (ABI) that enables ARM64 binaries to For more information on the x64 and ARM64 ABIs, see [Overview of x64 ABI conventions](x64-software-conventions.md) and [Overview of ARM64 ABI conventions](arm64-windows-abi-conventions.md). -ARM64EC doesn't solve memory model differences between x64 and ARM based architectures. For more information, see [Common Visual C++ ARM migration issues](common-visual-cpp-arm-migration-issues.md). +ARM64EC doesn't solve memory model differences between x64 and ARM based architectures. For more information, see [Common Microsoft C++ ARM migration issues](common-visual-cpp-arm-migration-issues.md). ## Definitions @@ -188,5 +188,5 @@ The ARM64EC toolchain currently doesn't support `__vectorcall`. The compiler emi ## See also [Understanding ARM64EC ABI and assembly code](/windows/arm/arm64ec-abi)\ -[Common Visual C++ ARM migration issues](common-visual-cpp-arm-migration-issues.md)\ +[Common Microsoft C++ ARM migration issues](common-visual-cpp-arm-migration-issues.md)\ [Decorated names](./reference/decorated-names.md) diff --git a/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md b/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md index 01183ef9898..8a247863e48 100644 --- a/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md +++ b/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md @@ -10,9 +10,9 @@ ms.topic: concept-article Visual Studio supports a deployment model for Windows client applications based on the idea of [isolated applications](/windows/win32/SbsCs/isolated-applications) and [side-by-side assemblies](/windows/win32/SbsCs/about-side-by-side-assemblies-). By default, Visual Studio builds all native C/C++ applications as isolated applications that use [manifests](/windows/win32/sbscs/manifests) to describe their dependencies on Visual C++ libraries. -Building C/C++ programs as isolated applications presents a range of advantages. For example, an isolated application is unaffected when other C/C++ applications install or uninstall Visual C++ libraries. Visual C++ libraries used by isolated applications may still be redistributed in either the application's local folder, or by installation to the native assembly cache (WinSxS); however, servicing of Visual C++ libraries for already deployed applications can be simplified by using a [publisher configuration file](/windows/win32/SbsCs/publisher-configuration). The isolated application deployment model makes it easier to ensure that C/C++ applications that are running on a specific computer use the most recent version of Visual C++ libraries, while still leaving open the possibility for system administrators and application authors to control explicit version binding of applications to their dependent DLLs. +Building C/C++ programs as isolated applications presents a range of advantages. For example, an isolated application is unaffected when other C/C++ applications install or uninstall Microsoft C++ libraries. Microsoft C++ libraries used by isolated applications may still be redistributed in either the application's local folder, or by installation to the native assembly cache (WinSxS); however, servicing of Microsoft C++ libraries for already deployed applications can be simplified by using a [publisher configuration file](/windows/win32/SbsCs/publisher-configuration). The isolated application deployment model makes it easier to ensure that C/C++ applications that are running on a specific computer use the most recent version of Microsoft C++ libraries, while still leaving open the possibility for system administrators and application authors to control explicit version binding of applications to their dependent DLLs. -This section discusses how you can build your C/C++ application as an isolated application and ensure that it binds to Visual C++ libraries using a manifest. The information in this section primarily applies to native, or unmanaged, C++ applications. For information about deploying native C++ applications built with Visual Studio, see [Redistributing Visual C++ Files](../windows/redistributing-visual-cpp-files.md). +This section discusses how you can build your C/C++ application as an isolated application and ensure that it binds to Microsoft C++ libraries using a manifest. The information in this section primarily applies to native, or unmanaged, C++ applications. For information about deploying native C++ applications built with Visual Studio, see [Redistributing Microsoft C++ Files](../windows/redistributing-visual-cpp-files.md). ## In This Section diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index 7b4a452f29b..1a2c2232451 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -1,15 +1,15 @@ --- -title: "Use the Microsoft C++ toolset from the command line" -description: "Use the Microsoft C++ (MSVC) compiler toolset from the command line outside of the Visual Studio IDE." +title: "Use the Microsoft C++ Build Tools from the command line" +description: "Use the Microsoft C++ (MSVC) Build Tools from the command line outside of the Visual Studio IDE." ms.custom: "conceptual" ms.date: 04/07/2022 helpviewer_keywords: ["command-line builds [C++]", "compiling source code [C++], command line", "builds [C++], command-line", "command line [C++], building from", "command line [C++], compilers"] ms.assetid: 7ca9daed-a003-4162-842d-908f79058365 ms.topic: how-to --- -# Use the Microsoft C++ toolset from the command line +# Use the Microsoft C++ Build Tools from the command line -You can build C and C++ applications on the command line by using tools that are included in Visual Studio. The Microsoft C++ (MSVC) compiler toolset is also downloadable as a standalone package. You don't need to install the Visual Studio IDE if you don't plan to use it. +You can build C and C++ applications on the command line by using tools that are included in Visual Studio. The Microsoft C++ (MSVC) Build Tools are also downloadable as a standalone package. You don't need to install the Visual Studio IDE if you don't plan to use it. > [!NOTE] > This article is about how to set up an environment to use the individual compilers, linkers, librarian, and other basic tools. The native project build system in Visual Studio, based on MSBuild, doesn't use the environment as described in this article. For more information on how to use MSBuild from the command line, see [MSBuild on the command line - C++](msbuild-visual-cpp.md). @@ -23,13 +23,13 @@ If you've installed Visual Studio and a C++ workload, you have all the command-l ::: moniker-end ::: moniker range="<=msvc-150" -If you've installed Visual Studio and a C++ workload, you have all the command-line tools. For information on how to install C++ and Visual Studio, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). If you only want the command-line toolset, download the [Build Tools for Visual Studio 2017](https://my.visualstudio.com/Downloads?q=2017). When you run the downloaded executable, it updates and runs the Visual Studio Installer. To install only the tools you need for C++ development, select the **Visual C++ build tools** workload. You can select optional libraries and toolsets to include under **Installation details**. To build code by using the Visual Studio 2015 toolset, select the optional MSVC v140 build tools. When you're satisfied with your selections, choose **Install**. +If you've installed Visual Studio and a C++ workload, you have all the command-line tools. For information on how to install C++ and Visual Studio, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). If you only want the command-line toolset, download the [Build Tools for Visual Studio 2017](https://my.visualstudio.com/Downloads?q=2017). When you run the downloaded executable, it updates and runs the Visual Studio Installer. To install only the tools you need for C++ development, select the **Desktop development with C++** workload. You can select optional libraries and toolsets to include under **Installation details**. To build code by using the Visual Studio 2015 toolset, select the optional MSVC v140 build tools. When you're satisfied with your selections, choose **Install**. ::: moniker-end ## How to use the command-line tools -When you choose one of the C++ workloads in the Visual Studio Installer, it installs the Visual Studio *platform toolset*. A platform toolset has all the C and C++ tools for a specific Visual Studio version. The tools include the C/C++ compilers, linkers, assemblers, and other build tools, and matching libraries and header files. You can use all of these tools at the command line. They're also used internally by the Visual Studio IDE. There are separate x86-hosted and x64-hosted compilers and tools to build code for x86, x64, ARM, and ARM64 targets. Each set of tools for a particular host and target build architecture is stored in its own directory. +When you choose one of the C++ workloads in the Visual Studio Installer, by default, it installs a particular version of the MSVC Build Tools package. For Visual Studio 2022 and earlier, this is organized by a *platform toolset* (v### version format) that has all the C and C++ tools for a specific version of Visual Studio. For Visual Studio 2026 and later, this consists of the MSVC version (v##.## version format), which has all the C and C++ tools for that particular MSVC package. The MSVC version is decoupled from the Visual Studio version. The tools include the C/C++ compilers, linkers, assemblers, and other build tools, and matching libraries and header files. You can use all of these tools at the command-line. They're also used internally by the Visual Studio IDE. There are separate x86-hosted and x64-hosted compilers and tools that build code for x86, x64, ARM, and ARM64 targets. Each set of tools for a particular host and target build architecture is stored in its own directory. To work correctly, the tools require several specific environment variables to be set. These variables are used to add the tools to the path, and to set the locations of include files, library files, and SDKs. To make it easy to set these environment variables, the installer creates customized *command files*, or batch files, during installation. You can run one of these command files to set a specific host and target build architecture, Windows SDK version, and platform toolset. For convenience, the installer also creates shortcuts in your Start menu. The shortcuts open developer command prompt windows by using these command files for specific combinations of host and target. These shortcuts ensure all the required environment variables are set and ready to use. diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index b5f46cac1be..5282a491801 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -265,7 +265,7 @@ For more information on generators that support the `toolset` specification, see To reproduce these builds outside Visual Studio, see [Run CMake from the command line or a CI pipeline](#run-cmake-from-the-command-line-or-a-ci-pipeline). -To build on Linux or without the Visual C++ toolset, specify the name of a compiler on your `PATH` instance, or an environment variable that evaluates to the full path of a compiler. Full paths are discouraged so that the file can remain shareable. A preset that builds with GCC version 8 might look like this: +To build on Linux or without the Microsoft C++ (MSVC) Build Tools, specify the name of a compiler on your `PATH` instance, or an environment variable that evaluates to the full path of a compiler. Full paths are discouraged so that the file can remain shareable. A preset that builds with GCC version 8 might look like this: ```json "environment": { @@ -290,7 +290,7 @@ Set `architecture.strategy` and `toolset.strategy` to `set` when you're building You can set the configuration type (`Debug` or `Release`) for single configuration generators by using `cacheVariables.CMAKE_BUILD_TYPE`. It's equivalent to passing `-D CMAKE_BUILD_TYPE=` to CMake from the command line. For more information, see [`CMAKE_BUILD_TYPE`](https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html). -### Select your target and host architecture when building with the Visual C++ toolset +### Select your target and host architecture when building with the Microsoft C++ Build Tools You can set the target architecture (x64, Win32, ARM64, or ARM) by using `architecture.value`. It's equivalent to passing `-A` to CMake from the command line. For more information, see [Platform Selection](https://cmake.org/cmake/help/latest/generator/Visual%20Studio%2016%202019.html#platform-selection). @@ -466,7 +466,7 @@ You can use the same *`CMakePresets.json`* and *`CMakeUserPresets.json`* files t ### Sourcing the environment when building with command-line generators on Windows -It's up to the user to configure the environment before CMake is invoked in building with a command-line generator. If you're building with Ninja and the Visual C++ toolset on Windows, set the environment before CMake is called to generate the build system. You can do it by calling *`vcvarsall.bat`* with the `architecture` argument. The `architecture` argument specifies the host and target architecture to use. For more information, see [`vcvarsall` syntax](./building-on-the-command-line.md#vcvarsall-syntax). If you build on Linux or on Windows with a Visual Studio Generator, you don't need to take this step. +It's up to the user to configure the environment before CMake is invoked in building with a command-line generator. If you're building with Ninja and the Microsoft C++ Build Tools on Windows, set the environment before CMake is called to generate the build system. You can do it by calling *`vcvarsall.bat`* with the `architecture` argument. The `architecture` argument specifies the host and target architecture to use. For more information, see [`vcvarsall` syntax](./building-on-the-command-line.md#vcvarsall-syntax). If you build on Linux or on Windows with a Visual Studio Generator, you don't need to take this step. It's the same step that Visual Studio takes for you when the IDE invokes CMake. Visual Studio parses the active Configure Preset for the host and target architecture specified by `toolset` and `architecture`. Visual Studio then sources the specified environment from *`vcvarsall.bat`*. When you build from the Windows command line with Ninja, you'll need to take this step yourself. diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index 0ca5262c430..5dcd6b75af3 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -147,7 +147,7 @@ You can customize a CMake debugging session by setting properties in the *`launc ### Just My Code for CMake projects -When you build for Windows using the MSVC compiler, CMake projects have support for Just My Code debugging. To change the Just My Code setting, go to **Tools** > **Options** > **Debugging** > **General**. For more information on Just My Code debugging, see [Debug only user code with Just My Code](/visualstudio/debugger/just-my-code). +When you build for Windows using the Microsoft C++ (MSVC) compiler, CMake projects have support for Just My Code debugging. To change the Just My Code setting, go to **Tools** > **Options** > **Debugging** > **General**. For more information on Just My Code debugging, see [Debug only user code with Just My Code](/visualstudio/debugger/just-my-code). ### Edit and Continue for CMake projects diff --git a/docs/build/cmakesettings-reference.md b/docs/build/cmakesettings-reference.md index e9a6acdb8ff..274b0237bf1 100644 --- a/docs/build/cmakesettings-reference.md +++ b/docs/build/cmakesettings-reference.md @@ -122,7 +122,7 @@ By default, when the active configuration specifies a Visual Studio generator, i - `remotePreGenerateCommand`: Specifies the command to run before running CMake to parse the *`CMakeLists.txt`* file. - `remotePrebuildCommand`: Specifies the command to run on the remote machine before building. - `remotePostbuildCommand`: Specifies the command to run on the remote machine after building. -- `variables`: Contains a name-value pair of CMake variables that get passed as **`-D name=value`** to CMake. If your CMake project build instructions specify the addition of any variables directly to the *`CMakeCache.txt`* file, we recommend you add them here instead. This example shows how to specify the name-value pairs to use the 14.14.26428 MSVC toolset: +- `variables`: Contains a name-value pair of CMake variables that get passed as **`-D name=value`** to CMake. If your CMake project build instructions specify the addition of any variables directly to the *`CMakeCache.txt`* file, we recommend you add them here instead. This example shows how to specify the name-value pairs to use the 14.14.26428 MSVC Build Tools: ```json "variables": [ diff --git a/docs/build/common-visual-cpp-64-bit-migration-issues.md b/docs/build/common-visual-cpp-64-bit-migration-issues.md index 531a59ee624..7d8603ea722 100644 --- a/docs/build/common-visual-cpp-64-bit-migration-issues.md +++ b/docs/build/common-visual-cpp-64-bit-migration-issues.md @@ -1,13 +1,13 @@ --- -description: "Learn more about: Common Visual C++ 64-bit Migration Issues" -title: "Common Visual C++ 64-bit Migration Issues" +description: "Learn more about: Common Microsoft C++ 64-bit Migration Issues" +title: "Common Microsoft C++ 64-bit Migration Issues" ms.date: "05/06/2019" helpviewer_keywords: ["64-bit programming [C++], migration", "64-bit compiler [C++], migration", "porting 32-bit code to 64-bit code", "migration [C++], 64-bit code issues", "32-bit code porting [C++]", "64-bit applications [C++]", "64-bit compiler [C++], porting 32-bit code", "Win64 [C++]"] ms.assetid: d17fb838-7513-4e2d-8b27-a1666f17ad76 --- -# Common Visual C++ 64-bit Migration Issues +# Common Microsoft C++ 64-bit Migration Issues -When you use the Microsoft C++ compiler (MSVC) to create applications to run on a 64-bit Windows operating system, you should be aware of the following issues: +When you use the Microsoft C++ (MSVC) compiler to create applications to run on a 64-bit Windows operating system, you should be aware of the following issues: - An **`int`** and a **`long`** are 32-bit values on 64-bit Windows operating systems. For programs that you plan to compile for 64-bit platforms, you should be careful not to assign pointers to 32-bit variables. Pointers are 64-bit on 64-bit platforms, and you will truncate the pointer value if you assign it to a 32-bit variable. @@ -34,4 +34,4 @@ For more information, see: ## See also [Configure C++ projects for 64-bit, x64 targets](configuring-programs-for-64-bit-visual-cpp.md)
-[Visual C++ Porting and Upgrading Guide](../porting/visual-cpp-porting-and-upgrading-guide.md) +[Microsoft C++ Porting and Upgrading Guide](../porting/visual-cpp-porting-and-upgrading-guide.md) diff --git a/docs/build/common-visual-cpp-arm-migration-issues.md b/docs/build/common-visual-cpp-arm-migration-issues.md index 36035c044bf..bd39965f08d 100644 --- a/docs/build/common-visual-cpp-arm-migration-issues.md +++ b/docs/build/common-visual-cpp-arm-migration-issues.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Common Visual C++ ARM Migration Issues" -title: "Common Visual C++ ARM Migration Issues" +description: "Learn more about: Common Microsoft C++ ARM Migration Issues" +title: "Common Microsoft C++ ARM Migration Issues" ms.date: "05/06/2019" --- -# Common Visual C++ ARM migration issues +# Common Microsoft C++ ARM migration issues This document describes some of the common issues that you might encounter when you migrate code from x86 or x64 architectures to the ARM architecture. It also describes how to avoid these issues, and how to use the compiler to help identify them. @@ -89,7 +89,7 @@ And if there's a dependency between `operator->(memory_handle)` and `operator*(p ### `volatile` keyword default behavior -The MSVC compiler supports two different interpretations of the **`volatile`** storage qualifier that you can specify by using compiler switches. The [/volatile:ms](reference/volatile-volatile-keyword-interpretation.md) switch selects the Microsoft extended volatile semantics that guarantee strong ordering, as has been the traditional case for x86 and x64 because of the strong memory model on those architectures. The [/volatile:iso](reference/volatile-volatile-keyword-interpretation.md) switch selects the strict C++ standard volatile semantics that don't guarantee strong ordering. +The Microsoft C++ (MSVC) compiler supports two different interpretations of the **`volatile`** storage qualifier that you can specify by using compiler switches. The [/volatile:ms](reference/volatile-volatile-keyword-interpretation.md) switch selects the Microsoft extended volatile semantics that guarantee strong ordering, as has been the traditional case for x86 and x64 because of the strong memory model on those architectures. The [/volatile:iso](reference/volatile-volatile-keyword-interpretation.md) switch selects the strict C++ standard volatile semantics that don't guarantee strong ordering. On the ARM architecture (except ARM64EC), the default is **/volatile:iso** because ARM processors have a weakly ordered memory model, and because ARM software doesn't have a legacy of relying on the extended semantics of **/volatile:ms** and doesn't usually have to interface with software that does. However, it's still sometimes convenient or even required to compile an ARM program to use the extended semantics. For example, it may be too costly to port a program to use the ISO C++ semantics, or driver software might have to adhere to the traditional semantics to function correctly. In these cases, you can use the **/volatile:ms** switch; however, to recreate the traditional volatile semantics on ARM targets, the compiler must insert memory barriers around each read or write of a **`volatile`** variable to enforce strong ordering, which can have a negative impact on performance. @@ -97,4 +97,4 @@ On the x86, x64, and ARM64EC architectures, the default is **/volatile:ms** beca ## See also -[Configure Visual C++ for ARM processors](configuring-programs-for-arm-processors-visual-cpp.md) +[Configure Microsoft C++ for ARM processors](configuring-programs-for-arm-processors-visual-cpp.md) diff --git a/docs/build/compare-inclusion-methods.md b/docs/build/compare-inclusion-methods.md index 8c16032aee4..2f8c25c5b6a 100644 --- a/docs/build/compare-inclusion-methods.md +++ b/docs/build/compare-inclusion-methods.md @@ -40,4 +40,4 @@ If you can't use C++20 features, use `#include` and consider precompiled headers [Overview of modules in C++](../cpp/modules-cpp.md)\ [Tutorial: Import the C++ standard library using modules](../cpp/tutorial-import-stl-named-module.md)\ [Walkthrough: Import STL libraries as header units](walkthrough-import-stl-header-units.md#approach1)\ -[Walkthrough: Build and import header units in your Visual C++ projects](walkthrough-header-units.md) \ No newline at end of file +[Walkthrough: Build and import header units in your Microsoft C++ projects](walkthrough-header-units.md) \ No newline at end of file diff --git a/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md b/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md index ef50625ae8d..2993d7abb37 100644 --- a/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md +++ b/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md @@ -24,9 +24,9 @@ At execution time, Windows uses assembly information from the application manife You can change side-by-side assembly dependencies after an application has been deployed by modifying the [Publisher Configuration Files](/windows/win32/SbsCs/publisher-configuration-files) and [Application Configuration Files](/windows/win32/SbsCs/application-configuration-files). A publisher configuration file, also known as a publisher policy file, is an XML file that globally redirects applications and assemblies from using one version of a side-by-side assembly to using another version of the same assembly. For example, you could change a dependency when a bug fix or security fix is deployed for a side-by-side assembly and you want to redirect all applications to use the fixed version. An application configuration file is an XML file that redirects a specific application from using one version of a side-by-side assembly to using another version of the same assembly. You can use an application configuration file to redirect a particular application to use a version of a side-by-side assembly that's different from the one that's defined in the publisher configuration file. For more information, see [Configuration](/windows/win32/SbsCs/configuration). -## Visual C++ libraries +## Microsoft C++ libraries -In Visual Studio 2005 and Visual Studio 2008, redistributable libraries such as ATL, MFC, CRT, Standard C++, OpenMP, and MSDIA were deployed as shared side-by-side assemblies to the native assembly cache. In the current version, the redistributable libraries use central deployment. By default, all applications that are built by using Visual Studio are built with the manifest embedded in the final binary, and the manifest describes the dependencies of the binary on the Visual C++ libraries. To understand manifest generation for C++ applications, see [Understanding Manifest Generation for C/C++ Programs](understanding-manifest-generation-for-c-cpp-programs.md). A manifest is not required for applications that are statically linked to the libraries that they use, or that use local deployment. For more information about deployment, see [Deployment in Visual C++](../windows/deployment-in-visual-cpp.md). +In Visual Studio 2005 and Visual Studio 2008, redistributable libraries such as ATL, MFC, CRT, Standard C++, OpenMP, and MSDIA were deployed as shared side-by-side assemblies to the native assembly cache. In the current version, the redistributable libraries use central deployment. By default, all applications that are built by using Visual Studio are built with the manifest embedded in the final binary, and the manifest describes the dependencies of the binary on the Microsoft C++ libraries. To understand manifest generation for C++ applications, see [Understanding Manifest Generation for C/C++ Programs](understanding-manifest-generation-for-c-cpp-programs.md). A manifest is not required for applications that are statically linked to the libraries that they use, or that use local deployment. For more information about deployment, see [Deployment in Microsoft C++](../windows/deployment-in-visual-cpp.md). ## See also diff --git a/docs/build/configuring-programs-for-64-bit-visual-cpp.md b/docs/build/configuring-programs-for-64-bit-visual-cpp.md index e922af4027d..845be402593 100644 --- a/docs/build/configuring-programs-for-64-bit-visual-cpp.md +++ b/docs/build/configuring-programs-for-64-bit-visual-cpp.md @@ -7,15 +7,15 @@ ms.assetid: cb99f72b-8c74-48f4-846a-8921b37b97e9 --- # Configure C++ projects for 64-bit, x64 targets -This section contains topics about targeting 64-bit x64 hardware with the Visual C++ build tools. +This section contains topics about targeting 64-bit x64 hardware with the Microsoft C++ (MSVC) Build Tools. ## In This Section -- [How to: Configure Visual C++ Projects to Target 64-Bit, x64 Platforms](how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md) +- [How to: Configure Microsoft C++ Projects to Target 64-Bit, x64 Platforms](how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md) - [How to: Enable a 64-bit, x64-hosted MSVC toolset on the command line](how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md) -- [Common Visual C++ 64-bit Migration Issues](common-visual-cpp-64-bit-migration-issues.md) +- [Common Microsoft C++ 64-bit Migration Issues](common-visual-cpp-64-bit-migration-issues.md) - [x64 Software Conventions](x64-software-conventions.md) diff --git a/docs/build/configuring-programs-for-arm-processors-visual-cpp.md b/docs/build/configuring-programs-for-arm-processors-visual-cpp.md index fc99baa1b25..bb6e7c40dc9 100644 --- a/docs/build/configuring-programs-for-arm-processors-visual-cpp.md +++ b/docs/build/configuring-programs-for-arm-processors-visual-cpp.md @@ -5,7 +5,7 @@ ms.date: "07/11/2018" --- # Configure C++ projects for ARM processors -This section of the documentation contains information about how to use the MSVC build tools to target ARM hardware. +This section of the documentation contains information about how to use the Microsoft C++ (MSVC) Build Tools to target ARM hardware. ## In This Section diff --git a/docs/build/creating-precompiled-header-files.md b/docs/build/creating-precompiled-header-files.md index 2b0f1f5ebe1..ec450093ce7 100644 --- a/docs/build/creating-precompiled-header-files.md +++ b/docs/build/creating-precompiled-header-files.md @@ -348,5 +348,5 @@ int main( void ) [MSVC compiler options](reference/compiler-options.md)\ [Overview of modules in C++](../cpp/modules-cpp.md)\ [Tutorial: Import the C++ standard library using modules](../cpp/tutorial-import-stl-named-module.md)\ -[Walkthrough: Build and import header units in your Visual C++ projects](walkthrough-header-units.md)\ +[Walkthrough: Build and import header units in your Microsoft C++ projects](walkthrough-header-units.md)\ [Walkthrough: Import STL libraries as header units](walkthrough-import-stl-header-units.md#approach1) diff --git a/docs/build/determining-which-exporting-method-to-use.md b/docs/build/determining-which-exporting-method-to-use.md index 58d6c4432c2..f34d60e3e3b 100644 --- a/docs/build/determining-which-exporting-method-to-use.md +++ b/docs/build/determining-which-exporting-method-to-use.md @@ -19,7 +19,7 @@ Exporting functions in a .def file gives you control over the export ordinals. W Another advantage to using a .def file is that you can use the `NONAME` attribute to export a function. This puts only the ordinal in the exports table in the DLL. For DLLs that have a large number of exported functions, using the `NONAME` attribute can reduce the size of the DLL file. For information about how to write a module definition statement, see [Rules for Module-Definition Statements](reference/rules-for-module-definition-statements.md). For information about ordinal export, see [Exporting Functions from a DLL by Ordinal Rather Than by Name](exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md). -A disadvantage of using a .def file is that if you are exporting functions in a C++ file, you either have to put the decorated names in the .def file or define the exported functions by using extern "C" to avoid the name decoration that's done by the MSVC compiler. +A disadvantage of using a .def file is that if you are exporting functions in a C++ file, you either have to put the decorated names in the .def file or define the exported functions by using extern "C" to avoid the name decoration that's done by the Microsoft C++ (MSVC) compiler. If you put the decorated names in the .def file, you can obtain them by using the [DUMPBIN](reference/dumpbin-reference.md) tool or by using the linker [/MAP](reference/map-generate-mapfile.md) option. The decorated names that are produced by the compiler are compiler-specific; therefore, if you put the decorated names that are produced by the compiler into a .def file, the applications that link to the DLL must also be built by using the same version of the compiler so that the decorated names in the calling application match the exported names in the .def file of the DLL. diff --git a/docs/build/dlls-in-visual-cpp.md b/docs/build/dlls-in-visual-cpp.md index a1974a8268a..cf7683b6c21 100644 --- a/docs/build/dlls-in-visual-cpp.md +++ b/docs/build/dlls-in-visual-cpp.md @@ -68,7 +68,7 @@ Describes explicit and implicit linking to a DLL. [Initialize a DLL](run-time-library-behavior.md#initializing-a-dll)\ Discusses DLL initialization code that must execute when your DLL loads. -[DLLs and Visual C++ run-time library behavior](run-time-library-behavior.md)\ +[DLLs and Microsoft C++ run-time library behavior](run-time-library-behavior.md)\ Describes the run-time library DLL startup sequence. [LoadLibrary and AfxLoadLibrary](loadlibrary-and-afxloadlibrary.md)\ diff --git a/docs/build/exception-handling-x64.md b/docs/build/exception-handling-x64.md index 41a6e29b6e4..8e35eb70ffd 100644 --- a/docs/build/exception-handling-x64.md +++ b/docs/build/exception-handling-x64.md @@ -7,7 +7,7 @@ ms.assetid: 41fecd2d-3717-4643-b21c-65dcd2f18c93 --- # x64 exception handling -An overview of structured exception handling and C++ exception handling coding conventions and behavior on the x64. For general information on exception handling, see [Exception Handling in Visual C++](../cpp/exception-handling-in-visual-cpp.md). +An overview of structured exception handling and C++ exception handling coding conventions and behavior on the x64. For general information on exception handling, see [Exception Handling in Microsoft C++](../cpp/exception-handling-in-visual-cpp.md). ## Unwind data for exception handling, debugger support diff --git a/docs/build/exporting-from-a-dll-using-def-files.md b/docs/build/exporting-from-a-dll-using-def-files.md index ce1b224eede..653273a5fe2 100644 --- a/docs/build/exporting-from-a-dll-using-def-files.md +++ b/docs/build/exporting-from-a-dll-using-def-files.md @@ -29,7 +29,7 @@ EXPORTS If you use the [MFC DLL Wizard](../mfc/reference/mfc-dll-wizard.md) to create an MFC DLL, the wizard creates a skeleton DEF file for you and automatically adds it to your project. Add the names of the functions to be exported to this file. For non-MFC DLLs, create the DEF file yourself and add it to your project. Then go to **Project** > **Properties** > **Linker** > **Input** > **Module Definition File** and enter the name of the DEF file. Repeat this step for each configuration and platform, or do it all at once by selecting **Configuration = All Configurations**, and **Platform = All Platforms**. -If you are exporting functions in a C++ file, you have to either place the decorated names in the DEF file or define your exported functions with standard C linkage by using extern "C". If you need to place the decorated names in the DEF file, you can obtain them by using the [DUMPBIN](../build/reference/dumpbin-reference.md) tool or by using the linker [/MAP](../build/reference/map-generate-mapfile.md) option. Note that the decorated names produced by the compiler are compiler specific. If you place the decorated names produced by the Microsoft C++ compiler (MSVC) into a DEF file, applications that link to your DLL must also be built using the same version of MSVC so that the decorated names in the calling application match the exported names in the DLL's DEF file. +If you are exporting functions in a C++ file, you have to either place the decorated names in the DEF file or define your exported functions with standard C linkage by using extern "C". If you need to place the decorated names in the DEF file, you can obtain them by using the [DUMPBIN](../build/reference/dumpbin-reference.md) tool or by using the linker [/MAP](../build/reference/map-generate-mapfile.md) option. Note that the decorated names produced by the compiler are compiler specific. If you place the decorated names produced by the Microsoft C++ (MSVC) compiler into a DEF file, applications that link to your DLL must also be built using the same version of MSVC so that the decorated names in the calling application match the exported names in the DLL's DEF file. > [!NOTE] > A DLL built with Visual Studio 2015 can be consumed by applications built with Visual Studio 2017 or Visual Studio 2019. diff --git a/docs/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md b/docs/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md index 4e5fb870095..e551b430faf 100644 --- a/docs/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md +++ b/docs/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md @@ -27,7 +27,7 @@ Any of the native or cross compiler tools build configurations can be used on th > [!NOTE] > For information about the specific tools that are included with each Visual Studio edition, see [Visual C++ Tools and Features in Visual Studio Editions](../overview/visual-cpp-tools-and-features-in-visual-studio-editions.md). > -> For information about how to use the Visual Studio IDE to create 64-bit applications, see [How to: Configure Visual C++ Projects to Target 64-Bit, x64 Platforms](how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). +> For information about how to use the Visual Studio IDE to create 64-bit applications, see [How to: Configure Microsoft C++ Projects to Target 64-Bit, x64 Platforms](how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). When you install a C++ workload in the Visual Studio installer, it always installs 32-bit, x86-hosted, native and cross compiler tools to build x86 and x64 code. If you include the Universal Windows Platform workload, it also installs x86-hosted cross compiler tools to build ARM code. If you install these workloads on a 64-bit, x64 processor, you also get 64-bit native and cross compiler tools to build x86, x64, and ARM code. The 32-bit and 64-bit tools generate identical code, but the 64-bit tools support more memory for precompiled header symbols and the Whole Program Optimization ([/GL](reference/gl-whole-program-optimization.md) and [/LTCG](reference/ltcg-link-time-code-generation.md)) options. If you run into memory limits when you use the 32-bit tools, try the 64-bit tools. diff --git a/docs/build/how-to-modify-the-target-framework-and-platform-toolset.md b/docs/build/how-to-modify-the-target-framework-and-platform-toolset.md index a91d9d91583..3c80c787b4a 100644 --- a/docs/build/how-to-modify-the-target-framework-and-platform-toolset.md +++ b/docs/build/how-to-modify-the-target-framework-and-platform-toolset.md @@ -10,7 +10,7 @@ You can edit a Visual Studio C++ project file to target different versions of th ## Platform toolset -The platform toolset consists of the C++ compiler (cl.exe) and linker (link.exe), along with the C/C++ standard libraries. Visual Studio 2015, Visual Studio 2017, and Visual Studio 2019 are binary-compatible. It's shown by the major version of the toolset, which has remained at 14. Projects compiled in Visual Studio 2019 or Visual Studio 2017 are ABI-backwards-compatible with 2017 and 2015 projects. The minor version has updated by 1 for each version since Visual Studio 2015: +The platform toolset consists of the Microsoft C++ (MSVC) compiler (cl.exe) and linker (link.exe), along with the C/C++ standard libraries. Visual Studio 2015, Visual Studio 2017, and Visual Studio 2019 are binary-compatible. It's shown by the major version of the toolset, which has remained at 14. Projects compiled in Visual Studio 2019 or Visual Studio 2017 are ABI-backwards-compatible with 2017 and 2015 projects. The minor version has updated by 1 for each version since Visual Studio 2015: - Visual Studio 2015: v140 - Visual Studio 2017: v141 @@ -25,7 +25,7 @@ Visual Studio also supports multitargeting for C++ projects. You can use the lat When you change the target Framework, also change the platform toolset to a version that supports that Framework. For example, to target the .NET Framework 4.5, you must use a compatible platform toolset. These toolsets include Visual Studio 2015 (v140), Visual Studio 2013 (v120), or Visual Studio 2012 (v110). You can use the [Windows 7.1 SDK](https://www.microsoft.com/en-us/download/details.aspx?id=8442) to target .NET Framework 2.0, 3.0, 3.5, and 4. -You can extend the target platform further by creating a custom platform toolset. For more information, see [C++ Native Multi-Targeting](https://devblogs.microsoft.com/cppblog/c-native-multi-targeting/) on the Visual C++ blog. +You can extend the target platform further by creating a custom platform toolset. For more information, see [C++ Native Multi-Targeting](https://devblogs.microsoft.com/cppblog/c-native-multi-targeting/) on the Microsoft C++ Team blog. ### To change the target Framework diff --git a/docs/build/importing-using-def-files.md b/docs/build/importing-using-def-files.md index 877708fe77e..f8cd00daca4 100644 --- a/docs/build/importing-using-def-files.md +++ b/docs/build/importing-using-def-files.md @@ -50,7 +50,7 @@ if (ulDataInDll == 0L) /*sample code fragment*/ Using CONSTANT is more risky because if you forget to use the extra level of indirection, you could potentially access the import address table's pointer to the variable — not the variable itself. This type of problem can often manifest as an access violation because the import address table is currently made read-only by the compiler and linker. -The current MSVC linker issues a warning if it sees CONSTANT in the .def file to account for this case. The only real reason to use CONSTANT is if you cannot recompile some object file where the header file did not list **`__declspec(dllimport)`** on the prototype. +The current Microsoft C++ (MSVC) linker issues a warning if it sees CONSTANT in the .def file to account for this case. The only real reason to use CONSTANT is if you cannot recompile some object file where the header file did not list **`__declspec(dllimport)`** on the prototype. ## See also diff --git a/docs/build/msbuild-visual-cpp.md b/docs/build/msbuild-visual-cpp.md index 0066c81f6d9..858b524a7e4 100644 --- a/docs/build/msbuild-visual-cpp.md +++ b/docs/build/msbuild-visual-cpp.md @@ -44,7 +44,7 @@ Lists the MSBuild XML Schema elements, together with their attributes, and paren Describes the command-line arguments and options that you can use with msbuild.exe. - [Task Reference](/visualstudio/msbuild/msbuild-task-reference) -Describes MSBuild tasks. Especially note these tasks, which are specific to Visual C++: [BscMake Task](/visualstudio/msbuild/bscmake-task), [CL Task](/visualstudio/msbuild/cl-task), [CPPClean Task](/visualstudio/msbuild/cppclean-task), [LIB Task](/visualstudio/msbuild/lib-task), [Link Task](/visualstudio/msbuild/link-task), [MIDL Task](/visualstudio/msbuild/midl-task), [MT Task](/visualstudio/msbuild/mt-task), [RC Task](/visualstudio/msbuild/rc-task), [SetEnv Task](/visualstudio/msbuild/setenv-task), [VCMessage Task](/visualstudio/msbuild/vcmessage-task) +Describes MSBuild tasks. Especially note these tasks, which are specific to Microsoft C++: [BscMake Task](/visualstudio/msbuild/bscmake-task), [CL Task](/visualstudio/msbuild/cl-task), [CPPClean Task](/visualstudio/msbuild/cppclean-task), [LIB Task](/visualstudio/msbuild/lib-task), [Link Task](/visualstudio/msbuild/link-task), [MIDL Task](/visualstudio/msbuild/midl-task), [MT Task](/visualstudio/msbuild/mt-task), [RC Task](/visualstudio/msbuild/rc-task), [SetEnv Task](/visualstudio/msbuild/setenv-task), [VCMessage Task](/visualstudio/msbuild/vcmessage-task) ## In This Section diff --git a/docs/build/overview-of-arm-abi-conventions.md b/docs/build/overview-of-arm-abi-conventions.md index 5ab221541eb..0b80497f7ac 100644 --- a/docs/build/overview-of-arm-abi-conventions.md +++ b/docs/build/overview-of-arm-abi-conventions.md @@ -8,7 +8,7 @@ ms.date: "07/11/2018" The application binary interface (ABI) for code compiled for Windows on ARM processors is based on the standard ARM EABI. This article highlights key differences between Windows on ARM and the standard. This document covers the ARM32 ABI. For information about the ARM64 ABI, see [Overview of ARM64 ABI conventions](arm64-windows-abi-conventions.md). For more information about the standard ARM EABI, see [Application Binary Interface (ABI) for the ARM Architecture](https://github.com/ARM-software/abi-aa) (external link). > [!NOTE] -> Using the Microsoft Visual C++ (MSVC) build tools to target ARM32 is deprecated starting with Visual Studio 2026. If you need to target ARM32, use the Visual Studio 2022 v143 build tools. +> Using the Microsoft C++ (MSVC) Build Tools to target ARM32 is deprecated starting with Visual Studio 2026. If you need to target ARM32, use the Visual Studio 2022 v143 build tools. ## Base Requirements @@ -196,5 +196,5 @@ The counter is a true cycle counter, not a clock; therefore, the counting freque ## See also -[Common Visual C++ ARM Migration Issues](common-visual-cpp-arm-migration-issues.md)
+[Common Microsoft C++ ARM Migration Issues](common-visual-cpp-arm-migration-issues.md)
[ARM Exception Handling](arm-exception-handling.md) diff --git a/docs/build/projects-and-build-systems-cpp.md b/docs/build/projects-and-build-systems-cpp.md index 156cd4acfd8..511330c45a4 100644 --- a/docs/build/projects-and-build-systems-cpp.md +++ b/docs/build/projects-and-build-systems-cpp.md @@ -9,7 +9,7 @@ ms.custom: intro-overview --- # C/C++ projects and build systems in Visual Studio -You can use Visual Studio to edit, compile, and build any C++ code base with full IntelliSense support without having to convert that code into a Visual Studio project or compile with the MSVC toolset. For example, you can edit a cross-platform CMake project in Visual Studio on a Windows machine, then compile it for Linux using g++ on a remote Linux machine. +You can use Visual Studio to edit, compile, and build any C++ code base with full IntelliSense support without having to convert that code into a Visual Studio project or compile with the Microsoft C++ (MSVC) Build Tools. For example, you can edit a cross-platform CMake project in Visual Studio on a Windows machine, then compile it for Linux using g++ on a remote Linux machine. ## C++ compilation @@ -21,9 +21,9 @@ Basic C++ compilation involves three main steps: - The C++ compiler compiles each translation unit into object files (.obj), applying whatever compiler options have been set. - The *linker* merges the object files into a single executable, applying the linker options that have been set. -## The MSVC toolset +## The Microsoft C++ (MSVC) Build Tools -The Microsoft C++ compiler, linker, standard libraries, and related utilities make up the MSVC compiler toolset (also called a toolchain or "build tools"). These are included in Visual Studio. You can also download and use the command-line toolset as a free standalone package. For more information, see [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) on the Visual Studio Downloads page. +The Microsoft C++ compiler, linker, standard libraries, and related utilities make up the Microsoft C++ (MSVC) Build Tools (also called a toolchain or toolset). These are included in Visual Studio. You can also download and use the command-line toolset as a free standalone package. For more information, see [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) on the Visual Studio Downloads page. You can build simple programs by invoking the MSVC compiler (cl.exe) directly from the command line. The following command accepts a single source code file, and invokes cl.exe to build an executable called *hello.exe*: @@ -83,7 +83,7 @@ Describes the deployment model for Windows Desktop applications, based on the id How to target 64-bit x64 hardware with the MSVC build tools. [Configure C++ projects for ARM processors](configuring-programs-for-arm-processors-visual-cpp.md)\ -How to use the MSVC build tools to target ARM hardware. +How to use the MSVC Build Tools to target ARM hardware. [Optimizing Your Code](optimizing-your-code.md)\ How to optimize your code in various ways including program guided optimizations. diff --git a/docs/build/reference/c-cpp-prop-page.md b/docs/build/reference/c-cpp-prop-page.md index 4f92e38d17f..b43746b08b6 100644 --- a/docs/build/reference/c-cpp-prop-page.md +++ b/docs/build/reference/c-cpp-prop-page.md @@ -387,7 +387,7 @@ Experimental support for the C++ Modules TS and Standard Library modules. ### Build ISO C++23 Standard Library Modules -Starting in Visual Studio 17.6, when this property is enabled and [C++ Language Standard](#cpplang) is set to `/std:c++latest`, Visual C++ projects automatically find and build ISO C++23 Standard Library modules. This enables you to `import std` or `import std.compat` in your C++ code. +Starting in Visual Studio 17.6, when this property is enabled and [C++ Language Standard](#cpplang) is set to `/std:c++latest`, Microsoft C++ projects automatically find and build ISO C++23 Standard Library modules. This enables you to `import std` or `import std.compat` in your C++ code. ## C/C++ Precompiled Headers Properties diff --git a/docs/build/reference/fsanitize.md b/docs/build/reference/fsanitize.md index 6e9e8c94395..e1eef40728d 100644 --- a/docs/build/reference/fsanitize.md +++ b/docs/build/reference/fsanitize.md @@ -37,7 +37,7 @@ The **`/fsanitize-address-use-after-return`**, **`/fno-sanitize-address-vcasan-l 1. Select the **Configuration Properties** > **C/C++** > **General** property page. -1. Modify the **Enable Address Sanitizer** property. To enable it, choose **Yes (/fsanitize=address)**. +1. Modify the **Enable AddressSanitizer** property. To enable it, choose **Yes (/fsanitize=address)**. 1. Choose **OK** or **Apply** to save your changes. diff --git a/docs/build/reference/general-property-page-project.md b/docs/build/reference/general-property-page-project.md index 5fd0640279f..b06af7088be 100644 --- a/docs/build/reference/general-property-page-project.md +++ b/docs/build/reference/general-property-page-project.md @@ -77,7 +77,7 @@ You can use project macros to change the directory location. For more informatio ### Platform Toolset -Specifies the toolset used for building the current configuration. This property allows the project to target a different version of the Visual C++ libraries and compiler. By default, Visual Studio C++ projects target the latest toolset installed by Visual Studio. You can choose one of the toolsets installed by several previous versions of Visual Studio instead. Some older toolsets can create executables that run on Windows XP or Vista. For more information on how to change the platform toolset, see [How to: Modify the target framework and platform toolset](../how-to-modify-the-target-framework-and-platform-toolset.md). +Specifies the toolset used for building the current configuration. This property allows the project to target a different version of the Microsoft C++ libraries and compiler. By default, Visual Studio C++ projects target the latest toolset installed by Visual Studio. You can choose one of the toolsets installed by several previous versions of Visual Studio instead. Some older toolsets can create executables that run on Windows XP or Vista. For more information on how to change the platform toolset, see [How to: Modify the target framework and platform toolset](../how-to-modify-the-target-framework-and-platform-toolset.md). ### Enable Managed Incremental Build diff --git a/docs/build/reference/linking.md b/docs/build/reference/linking.md index 8891ebf554d..1934bea919d 100644 --- a/docs/build/reference/linking.md +++ b/docs/build/reference/linking.md @@ -68,8 +68,8 @@ link /dll @objlist.txt @liblist.txt @exports.txt The linker recognizes the following environment variables: - `LINK` and `_LINK_`, if defined. The linker prepends the options and arguments defined in the `LINK` environment variable and appends the options and arguments defined in the `_LINK_` environment variable to the command line arguments before processing. -- `LIB`, if defined. The linker uses the `LIB` path when it searches for an object, library, or other file specified on the command line or by the [`/BASE`](base-base-address.md) option. It also uses the `LIB` path to find a `.pdb` file named in an object. The `LIB` variable can contain one or more path specifications, separated by semicolons. One path must point to the `\lib` subdirectory of your Visual C++ installation. -- `PATH`, if the tool needs to run `CVTRES` and can't find the file in the same directory as `link.exe` itself. (`link.exe` requires `CVTRES` to link a `.res` file.) `PATH` must point to the `\bin` subdirectory of your Visual C++ installation. +- `LIB`, if defined. The linker uses the `LIB` path when it searches for an object, library, or other file specified on the command line or by the [`/BASE`](base-base-address.md) option. It also uses the `LIB` path to find a `.pdb` file named in an object. The `LIB` variable can contain one or more path specifications, separated by semicolons. One path must point to the `\lib` subdirectory of your Microsoft C++ installation. +- `PATH`, if the tool needs to run `CVTRES` and can't find the file in the same directory as `link.exe` itself. (`link.exe` requires `CVTRES` to link a `.res` file.) `PATH` must point to the `\bin` subdirectory of your Microsoft C++ installation. - `TMP`, to specify a directory when linking OMF or `.res` files. ## See also diff --git a/docs/build/reference/microsoft-extensions-to-c-and-cpp.md b/docs/build/reference/microsoft-extensions-to-c-and-cpp.md index 77eceff58eb..57eab588697 100644 --- a/docs/build/reference/microsoft-extensions-to-c-and-cpp.md +++ b/docs/build/reference/microsoft-extensions-to-c-and-cpp.md @@ -6,7 +6,7 @@ helpviewer_keywords: ["or_eq operator", "~ operator, extensions to C/C++", "& op --- # Microsoft extensions to C and C++ -Microsoft Visual C++ (MSVC) extends the C and C++ language standards in several ways, detailed in this article. +Microsoft C++ (MSVC) extends the C and C++ language standards in several ways, detailed in this article. The MSVC C++ compiler defaults to support for ISO C++14 with some ISO C++17 features and some Microsoft-specific language extensions. For more information on supported features, see [Microsoft C/C++ language conformance by Visual Studio version](../../overview/visual-cpp-language-conformance.md). You can use the **`/std`** compiler option to enable full support for ISO C++17 and ISO C++20 language features. For more information, see [`/std` (Specify language standard version)](std-specify-language-standard-version.md). diff --git a/docs/build/reference/msbuild-visual-cpp-overview.md b/docs/build/reference/msbuild-visual-cpp-overview.md index e614f2f98a6..7ea809fa747 100644 --- a/docs/build/reference/msbuild-visual-cpp-overview.md +++ b/docs/build/reference/msbuild-visual-cpp-overview.md @@ -84,7 +84,7 @@ To use MSBuild effectively, it helps to know which properties and targets are us ### `PlatformToolset` property -The `PlatformToolset` property determines which MSVC toolset is used in the build. By default, the current toolset is used. When this property is set, its value gets concatenated with literal strings to form the path. It's the directory that contains the property and target files required to build a project for a particular platform. The platform toolset must be installed to build by using that platform toolset version. +The `PlatformToolset` property determines which Microsoft C++ (MSVC) toolset is used in the build. By default, the current toolset is used. When this property is set, its value gets concatenated with literal strings to form the path. It's the directory that contains the property and target files required to build a project for a particular platform. The platform toolset must be installed to build by using that platform toolset version. For example, set the `PlatformToolset` property to `v140` to use Visual Studio 2015 tools and libraries to build your application: diff --git a/docs/build/reference/vcxproj-file-structure.md b/docs/build/reference/vcxproj-file-structure.md index d2ba07e23ff..2071e7e393d 100644 --- a/docs/build/reference/vcxproj-file-structure.md +++ b/docs/build/reference/vcxproj-file-structure.md @@ -7,7 +7,7 @@ ms.assetid: 14d0c552-29db-480e-80c1-7ea89d6d8e9c --- # `.vcxproj` and `.props` file structure -[MSBuild](../msbuild-visual-cpp.md) is the default project system in Visual Studio; when you choose **File** > **New Project** in Visual C++ you're creating an MSBuild project whose settings are stored in an XML project file that has the extension *`.vcxproj`*. The project file may also import *`.props`* files and *`.targets`* files where settings can be stored. +[MSBuild](../msbuild-visual-cpp.md) is the default project system in Visual Studio; when you choose **File** > **New Project**, in most cases you're creating an MSBuild project whose settings are stored in an XML project file that has the extension *`.vcxproj`*. The project file may also import *`.props`* files and *`.targets`* files where settings can be stored. If you intend to maintain your project properties in the IDE, we recommend you only create and modify your *`.vcxproj`* projects in the IDE, and avoid manual edits to the files. In most cases, you never need to manually edit the project file. Manual edits may break the project connections required to modify project settings in the Visual Studio property pages, and can cause build errors that are difficult to debug and repair. For more information about using the property pages, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). @@ -188,7 +188,7 @@ The `PropertySheets` group contains the imports for user property sheets. These ``` -`UserMacros` contains properties you create as variables that are used to customize your build process. For example, you can define a user macro to define your custom output path as $(CustomOutputPath) and use it to define other variables. This property group houses such properties. In Visual Studio, this group isn't populated in the project file because Visual C++ doesn't support user macros for configurations. User macros are supported in property sheets. +`UserMacros` contains properties you create as variables that are used to customize your build process. For example, you can define a user macro to define your custom output path as $(CustomOutputPath) and use it to define other variables. This property group houses such properties. In Visual Studio, this group isn't populated in the project file because Microsoft C++ doesn't support user macros for configurations. User macros are supported in property sheets. ### Per-configuration PropertyGroup elements diff --git a/docs/build/reference/visual-cpp-project-types.md b/docs/build/reference/visual-cpp-project-types.md index 41e998d56e9..baebf7c6045 100644 --- a/docs/build/reference/visual-cpp-project-types.md +++ b/docs/build/reference/visual-cpp-project-types.md @@ -1,6 +1,6 @@ --- description: "Learn more about: C++ project templates" -title: "Visual C++ Project Types" +title: "Microsoft C++ Project Types" ms.date: "08/13/2019" helpviewer_keywords: ["programs [C++], projects", "project templates [Visual Studio], C++", "TODO comments [C++]", "projects [C++], types", "templates [C++], projects", "applications [C++], projects", "C++ projects, types"] ms.assetid: 7337987e-1e7b-4120-9a4b-94f0401f15e7 diff --git a/docs/build/regular-dlls-statically-linked-to-mfc.md b/docs/build/regular-dlls-statically-linked-to-mfc.md index d3d90f05184..4faae4e7bb4 100644 --- a/docs/build/regular-dlls-statically-linked-to-mfc.md +++ b/docs/build/regular-dlls-statically-linked-to-mfc.md @@ -9,7 +9,7 @@ ms.assetid: 2eed531c-726a-4b8a-b936-f721dc00a7fa A regular MFC DLL statically linked to MFC is a DLL that uses MFC internally, and the exported functions in the DLL can be called by either MFC or non-MFC executables. As the name describes, this kind of DLL is built using the static link library version of MFC. Functions are usually exported from a regular MFC DLL using the standard C interface. For an example of how to write, build, and use a regular MFC DLL, see the sample [DLLScreenCap](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/advanced/DllScreenCap). -Note that the term USRDLL is no longer used in the Visual C++ documentation. A regular MFC DLL that is statically linked to MFC has the same characteristics as the former USRDLL. +Note that the term USRDLL is no longer used in the Microsoft C++ documentation. A regular MFC DLL that is statically linked to MFC has the same characteristics as the former USRDLL. A regular MFC DLL, statically linked to MFC, has the following features: diff --git a/docs/build/run-time-library-behavior.md b/docs/build/run-time-library-behavior.md index 1a85ae8d849..ad23da72e29 100644 --- a/docs/build/run-time-library-behavior.md +++ b/docs/build/run-time-library-behavior.md @@ -1,5 +1,5 @@ --- -description: "Learn more about: DLLs and Visual C++ run-time library behavior" +description: "Learn more about: DLLs and Microsoft C++ run-time library behavior" title: "DLLs and Visual C++ run-time library behavior" ms.date: "08/19/2019" f1_keywords: ["_DllMainCRTStartup", "CRT_INIT"] diff --git a/docs/build/stack-usage.md b/docs/build/stack-usage.md index 8a2a87b36dd..59c102e5ec9 100644 --- a/docs/build/stack-usage.md +++ b/docs/build/stack-usage.md @@ -41,7 +41,7 @@ A leaf function is one that does not require a function table entry. It can't ma ## malloc alignment -[malloc](../c-runtime-library/reference/malloc.md) is guaranteed to return memory that's suitably aligned for storing any object that has a fundamental alignment and that could fit in the amount of memory that's allocated. A *fundamental alignment* is an alignment that's less than or equal to the largest alignment that's supported by the implementation without an alignment specification. (In Visual C++, this is the alignment that's required for a **`double`**, or 8 bytes. In code that targets 64-bit platforms, it's 16 bytes.) For example, a four-byte allocation would be aligned on a boundary that supports any four-byte or smaller object. +[malloc](../c-runtime-library/reference/malloc.md) is guaranteed to return memory that's suitably aligned for storing any object that has a fundamental alignment and that could fit in the amount of memory that's allocated. A *fundamental alignment* is an alignment that's less than or equal to the largest alignment that's supported by the implementation without an alignment specification. (In Microsoft C++, this is the alignment that's required for a **`double`**, or 8 bytes. In code that targets 64-bit platforms, it's 16 bytes.) For example, a four-byte allocation would be aligned on a boundary that supports any four-byte or smaller object. Visual C++ permits types that have *extended alignment*, which are also known as *over-aligned* types. For example, the SSE types [__m128](../cpp/m128.md) and `__m256`, and types that are declared by using `__declspec(align( n ))` where `n` is greater than 8, have extended alignment. Memory alignment on a boundary that's suitable for an object that requires extended alignment is not guaranteed by `malloc`. To allocate memory for over-aligned types, use [_aligned_malloc](../c-runtime-library/reference/aligned-malloc.md) and related functions. diff --git a/docs/build/toc.yml b/docs/build/toc.yml index b5614f10a74..57a47a03ffb 100644 --- a/docs/build/toc.yml +++ b/docs/build/toc.yml @@ -83,7 +83,7 @@ items: - name: "Header units" expanded: false items: - - name: "Walkthrough: Build and import header units in Visual C++ projects" + - name: "Walkthrough: Build and import header units in Microsoft C++ projects" href: ../build/walkthrough-header-units.md - name: "Walkthrough: Import STL libraries as header units" href: ../build/walkthrough-import-stl-header-units.md diff --git a/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md b/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md index e6b026bfbad..77c17b97ece 100644 --- a/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md +++ b/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md @@ -24,7 +24,7 @@ If your application has no manifest and depends on a DLL that Windows can't find If your application is deployed on a computer that doesn't have Visual Studio, and it crashes with error messages that resemble the previous ones, check these things: -1. Follow the steps that are described in [Understanding the Dependencies of a Visual C++ Application](../windows/understanding-the-dependencies-of-a-visual-cpp-application.md). The dependency walker can show most dependencies for an application or DLL. If you observe that some DLLs are missing, install them on the computer on which you are trying to run your application. +1. Follow the steps that are described in [Understanding the Dependencies of a Microsoft C++ Application](../windows/understanding-the-dependencies-of-a-visual-cpp-application.md). The dependency walker can show most dependencies for an application or DLL. If you observe that some DLLs are missing, install them on the computer on which you are trying to run your application. 1. The operating system loader uses the application manifest to load assemblies that the application depends on. The manifest can either be embedded in the binary as a resource, or installed as a separate file in the application folder. To check whether the manifest is embedded in the binary, open the binary in Visual Studio and look for RT_MANIFEST in its list of resources. If you can't find an embedded manifest, look in the application folder for a file that's named something like .\.manifest. @@ -41,7 +41,7 @@ If your application is deployed on a computer that doesn't have Visual Studio, a ## Example -Assume we have an application, appl.exe, that's built by using Visual C++. The application manifest either is embedded in appl.exe as the binary resource RT_MANIFEST, which has an ID equal to 1, or is stored as the separate file appl.exe.manifest. The content of this manifest resembles this: +Assume we have an application, appl.exe, that's built using Microsoft C++ Build Tools. The application manifest either is embedded in appl.exe as the binary resource RT_MANIFEST, which has an ID equal to 1, or is stored as the separate file appl.exe.manifest. The content of this manifest resembles this: ``` diff --git a/docs/build/understanding-custom-build-steps-and-build-events.md b/docs/build/understanding-custom-build-steps-and-build-events.md index 7827264c812..78632dad4e1 100644 --- a/docs/build/understanding-custom-build-steps-and-build-events.md +++ b/docs/build/understanding-custom-build-steps-and-build-events.md @@ -8,7 +8,7 @@ ms.topic: how-to --- # Understanding Custom Build Steps and Build Events -From within the Visual C++ development environment, there are three basic ways to customize the build process: +Within the C++ development environment, there are three basic ways to customize the build process: - **Custom Build Steps** diff --git a/docs/build/understanding-manifest-generation-for-c-cpp-programs.md b/docs/build/understanding-manifest-generation-for-c-cpp-programs.md index c0bc39deb76..0db61f8486a 100644 --- a/docs/build/understanding-manifest-generation-for-c-cpp-programs.md +++ b/docs/build/understanding-manifest-generation-for-c-cpp-programs.md @@ -9,7 +9,7 @@ ms.topic: how-to A [manifest](/windows/win32/sbscs/manifests) is an XML document that uniquely identifies an assembly. It contains information used for binding and activation, such as COM classes, interfaces, and type libraries. A manifest can be an external XML file or a resource embedded inside an application or an assembly. The manifest of an [isolated application](/windows/win32/SbsCs/isolated-applications) is used to manage the names and versions of shared side-by-side assemblies the application should bind to at run time. The manifest of a side-by-side assembly specifies its dependencies on names, versions, resources, and other assemblies. -There are two ways to create a manifest for an isolated application or a side-by-side assembly. First, the author of the assembly can manually create a manifest file by following the rules and naming requirements. For more information, see [Manifest files reference](/windows/win32/sbscs/manifest-files-reference). Alternatively, if a program only depends on MSVC assemblies such as CRT, MFC, ATL or others, then the linker can generate a manifest automatically. +There are two ways to create a manifest for an isolated application or a side-by-side assembly. First, the author of the assembly can manually create a manifest file by following the rules and naming requirements. For more information, see [Manifest files reference](/windows/win32/sbscs/manifest-files-reference). Alternatively, if a program only depends on Microsoft C++ (MSVC) assemblies such as CRT, MFC, ATL or others, then the linker can generate a manifest automatically. The headers of MSVC libraries contain assembly information, and when the libraries are included in application code, this assembly information is used by the linker to form a manifest for the final binary. By default, the linker doesn't embed the manifest file inside the binary. Having a manifest as an external file may not work for all scenarios. For example, it's recommended that private assemblies have embedded manifests. In command line builds such as ones that use NMAKE to build code, you can use the [`/MANIFEST:EMBED`](./reference/manifest-create-side-by-side-assembly-manifest.md) linker option to embed the manifest. Alternatively, a manifest can be embedded using the manifest tool. For more information, see [Manifest generation at the command line](#manifest-generation-at-the-command-line). When you build in Visual Studio, a manifest can be embedded by setting a property for the manifest tool in the **Project Properties** dialog, as described in the next section. @@ -29,7 +29,7 @@ The build system in Visual Studio allows the manifest to be embedded in the fina 1. If the manifest embedded in the binary is the same as the manifest generated by the manifest tool, the build continues to the next build steps. -The manifest is embedded inside the final binary as a text resource. You can view it by opening the final binary as a file in Visual Studio. To ensure that the manifest points to the correct libraries, follow the steps described in [Understanding the dependencies of a Visual C++ application](../windows/understanding-the-dependencies-of-a-visual-cpp-application.md). Or, follow the suggestions described in the [Troubleshooting](troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md) article. +The manifest is embedded inside the final binary as a text resource. You can view it by opening the final binary as a file in Visual Studio. To ensure that the manifest points to the correct libraries, follow the steps described in [Understanding the dependencies of a Microsoft C++ application](../windows/understanding-the-dependencies-of-a-visual-cpp-application.md). Or, follow the suggestions described in the [Troubleshooting](troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md) article. ##
Manifest generation at the command line diff --git a/docs/build/vscpp-step-2-build.md b/docs/build/vscpp-step-2-build.md index e708ea80e02..174615c346b 100644 --- a/docs/build/vscpp-step-2-build.md +++ b/docs/build/vscpp-step-2-build.md @@ -1,6 +1,6 @@ --- title: Build and run a C++ console app project -description: "Build and run a Hello World console app in Visual C++" +description: "Build and run a Hello World console app in Microsoft C++" ms.custom: "mvc" ms.date: 06/28/2024 ms.topic: "tutorial" diff --git a/docs/build/walkthrough-compile-a-c-program-on-the-command-line.md b/docs/build/walkthrough-compile-a-c-program-on-the-command-line.md index 16e71d6fea8..ab7d92e680f 100644 --- a/docs/build/walkthrough-compile-a-c-program-on-the-command-line.md +++ b/docs/build/walkthrough-compile-a-c-program-on-the-command-line.md @@ -9,7 +9,7 @@ ms.topic: how-to --- # Walkthrough: Compile a C program on the command line -The Visual Studio build tools include a C compiler that you can use to create everything from basic console programs to full Windows desktop applications and mobile apps. Microsoft C/C++ (MSVC) is a C and C++ compiler that, in its latest versions, conforms to some of the latest C language standards, including C11 and C17. +The Visual Studio Build Tools include a C compiler that you can use to create everything from basic console programs to full Windows desktop applications and mobile apps. Microsoft C++ (MSVC) Build Tools contains a C and C++ compiler that, in its latest versions, conforms to some of the latest C language standards, including C11 and C17. This guide explains how to create a basic *Hello, World*-style C program by using a text editor, and then compile it on the command line. If you'd rather work in C++ on the command line, see [Walkthrough: Compiling a Native C++ Program on the Command Line](walkthrough-compiling-a-native-cpp-program-on-the-command-line.md). If you'd like to try the Visual Studio IDE instead of using the command line, see [Walkthrough: Working with Projects and Solutions (C++)](../ide/walkthrough-working-with-projects-and-solutions-cpp.md) or [Using the Visual Studio IDE for C++ Desktop Development](../ide/using-the-visual-studio-ide-for-cpp-desktop-development.md). diff --git a/docs/build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md b/docs/build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md index 1bf1c0904fd..f450214e366 100644 --- a/docs/build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md +++ b/docs/build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md @@ -6,7 +6,7 @@ ms.assetid: cef41c88-faf9-439d-8423-25aa3f5674dd --- # Walkthrough: Compiling a C++/CLI Program on the Command Line -You can create Visual C++ programs that target the Common Language Runtime (CLR) and use the .NET Framework, and build them on the command line. Visual C++ supports the C++/CLI programming language, which has additional types and operators to target the .NET programming model. For general information about the C++/CLI language, see [.NET Programming with C++/CLI (Visual C++)](../dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md). +You can create Microsoft C++ programs that target the Common Language Runtime (CLR) and use the .NET Framework, and build them on the command line. Microsoft C++ supports the C++/CLI programming language, which has additional types and operators to target the .NET programming model. For general information about the C++/CLI language, see [.NET Programming with C++/CLI (Visual C++)](../dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md). In this walkthrough, you use a text editor to create a basic C++/CLI program, and then compile it on the command line. (You can use your own C++/CLI program instead of typing the one that's shown, or you can use a C++/CLI code sample from another help article. This technique is useful for building and testing small modules that have no UI elements.) @@ -18,7 +18,7 @@ You understand the fundamentals of the C++ language. The following steps show how to compile a C++/CLI console application that uses .NET Framework classes. -To enable compilation for C++/CLI, you must use the [/clr](reference/clr-common-language-runtime-compilation.md) compiler option. The MSVC compiler generates an .exe file that contains MSIL code—or mixed MSIL and native code—and links to the required .NET Framework libraries. +To enable compilation for C++/CLI, you must use the [/clr](reference/clr-common-language-runtime-compilation.md) compiler option. The Microsoft C++ (MSVC) compiler generates an .exe file that contains MSIL code—or mixed MSIL and native code—and links to the required .NET Framework libraries. ### To compile a C++/CLI application on the command line @@ -43,7 +43,7 @@ To enable compilation for C++/CLI, you must use the [/clr](reference/clr-common- 1. On the menu bar, choose **File** > **Save**. - You've created a Visual C++ source file that uses a .NET Framework class () in the namespace. + You've created a C++ source file that uses a .NET Framework class () in the namespace. 1. At the command prompt, enter `cl /clr basicclr.cpp`. The cl.exe compiler compiles the source code into an .obj file that contains MSIL, and then runs the linker to generate an executable program named basicclr.exe. diff --git a/docs/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md b/docs/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md index 5cd2502e96e..f2bf932a35e 100644 --- a/docs/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md +++ b/docs/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md @@ -22,7 +22,7 @@ Visual Studio is an *integrated development environment* (IDE). It supports a fu The Build Tools for Visual Studio installs only the command-line compilers, tools, and libraries you need to build C and C++ programs. It's perfect for build labs or classroom exercises and installs relatively quickly. To install only the command-line tools, look for Build Tools for Visual Studio on the [Visual Studio Downloads](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) page. -Before you can build a C or C++ program on the command line, verify that the tools are installed, and you can access them from the command line. Visual C++ has complex requirements for the command-line environment to find the tools, headers, and libraries it uses. **You can't use Visual C++ in a plain command prompt window** without doing some preparation. Fortunately, Visual C++ installs shortcuts for you to launch a developer command prompt that has the environment set up for command line builds. Unfortunately, the names of the developer command prompt shortcuts and where they're located are different in almost every version of Visual C++ and on different versions of Windows. Your first walkthrough task is finding the right one to use. +Before you can build a C or C++ program on the command line, verify that the tools are installed, and you can access them from the command line. Microsoft C++ (MSVC) has complex requirements for the command-line environment to find the tools, headers, and libraries it uses. **You can't use Microsoft C++ in a plain command prompt window** without doing some preparation. Fortunately, Microsoft C++ installs shortcuts for you to launch a developer command prompt that has the environment set up for command line builds. Unfortunately, the names of the developer command prompt shortcuts and where they're located are different in almost every version of Visual Studio and on different versions of Windows. Your first walkthrough task is finding the right one to use. > [!NOTE] > A developer command prompt shortcut automatically sets the correct paths for the compiler and tools, and for any required headers and libraries. You must set these environment values yourself if you use a regular **Command Prompt** window. For more information, see [Use the MSVC toolset from the command line](./building-on-the-command-line.md). We recommend you use a developer command prompt shortcut instead of building your own. @@ -31,11 +31,11 @@ Before you can build a C or C++ program on the command line, verify that the too 1. If you have installed Visual Studio 2017 or later on Windows 10 or later, open the Start menu and choose **All apps**. Scroll down and open the **Visual Studio** folder (not the Visual Studio application). Choose **Developer Command Prompt for VS** to open the command prompt window. - If you have installed Microsoft Visual C++ Build Tools 2015 on Windows 10 or later, open the **Start** menu and choose **All apps**. Scroll down and open the **Visual C++ Build Tools** folder. Choose **Visual C++ 2015 x86 Native Tools Command Prompt** to open the command prompt window. + If you have installed Microsoft Visual Studio Build Tools 2015 on Windows 10 or later, open the **Start** menu and choose **All apps**. Scroll down and open the **Visual Studio Build Tools** folder. Choose **x86 Native Tools Command Prompt** to open the command prompt window. You can also use the Windows search function to search for "developer command prompt" and choose one that matches your installed version of Visual Studio. Use the shortcut to open the command prompt window. -1. Next, verify that the Visual C++ developer command prompt is set up correctly. In the command prompt window, enter `cl` and verify that the output looks something like this: +1. Next, verify that the C++ developer command prompt is set up correctly. In the command prompt window, enter `cl` and verify that the output looks something like this: ```Output C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise>cl @@ -45,17 +45,17 @@ Before you can build a C or C++ program on the command line, verify that the too usage: cl [ option... ] filename... [ /link linkoption... ] ``` - There may be differences in the current directory or version numbers. These values depend on the version of Visual C++ and any updates installed. If the above output is similar to what you see, then you're ready to build C or C++ programs at the command line. + There may be differences in the current directory or version numbers. These values depend on the version of MSVC and any updates installed. If the above output is similar to what you see, then you're ready to build C or C++ programs at the command line. > [!NOTE] - > If you get an error such as "'cl' is not recognized as an internal or external command, operable program or batch file," error C1034, or error LNK1104 when you run the **`cl`** command, then either you are not using a developer command prompt, or something is wrong with your installation of Visual C++. You must fix this issue before you can continue. + > If you get an error such as "'cl' is not recognized as an internal or external command, operable program or batch file," error C1034, or error LNK1104 when you run the **`cl`** command, then either you are not using a developer command prompt, or something is wrong with your installation of MSVC. You must fix this issue before you can continue. - If you can't find the developer command prompt shortcut, or if you get an error message when you enter `cl`, then your Visual C++ installation may have a problem. Try reinstalling the Visual C++ component in Visual Studio, or reinstall the Microsoft Visual C++ Build Tools. Don't go on to the next section until the **`cl`** command works. For more information about installing and troubleshooting Visual C++, see [Install Visual Studio](/visualstudio/install/install-visual-studio). + If you can't find the developer command prompt shortcut, or if you get an error message when you enter `cl`, then your MSVC installation may have a problem. Try reinstalling the MSVC component in Visual Studio or Visual Studio Build Tools. Don't go on to the next section until the **`cl`** command works. For more information about installing and troubleshooting MSVC, see [Install Visual Studio](/visualstudio/install/install-visual-studio). > [!NOTE] > Depending on the version of Windows on the computer and the system security configuration, you might have to right-click to open the shortcut menu for the developer command prompt shortcut and then choose **Run as administrator** to successfully build and run the program that you create by following this walkthrough. -### Create a Visual C++ source file and compile it on the command line +### Create a C++ source file and compile it on the command line 1. In the developer command prompt window, enter `md c:\hello` to create a directory, and then enter `cd c:\hello` to change to that directory. This directory is where both your source file and the compiled program get created. @@ -70,7 +70,7 @@ Before you can build a C or C++ program on the command line, verify that the too using namespace std; int main() { - cout << "Hello, world, from Visual C++!" << endl; + cout << "Hello, world, from Microsoft C++!" << endl; } ``` @@ -130,7 +130,7 @@ Before you can build a C or C++ program on the command line, verify that the too The program displays this text and exits: ```Output - Hello, world, from Visual C++! + Hello, world, from Microsoft C++! ``` Congratulations, you've compiled and run a C++ program by using the command-line tools. diff --git a/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md b/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md index e777914ccdb..ac858bc073f 100644 --- a/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md +++ b/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md @@ -571,7 +571,7 @@ Press any key to dismiss the command window. Now that you've created a DLL and a client application, you can experiment. Try setting breakpoints in the code of the client app, and run the app in the debugger. See what happens when you step into a library call. Add other functions to the library, or write another client app that uses your DLL. -When you deploy your app, you must also deploy the DLLs it uses. The simplest way to make the DLLs that you build, or that you include from third parties, available is to put them in the same directory as your app. It's known as *app-local deployment*. For more information about deployment, see [Deployment in Visual C++](../windows/deployment-in-visual-cpp.md). +When you deploy your app, you must also deploy the DLLs it uses. The simplest way to make the DLLs that you build, or that you include from third parties, available is to put them in the same directory as your app. It's known as *app-local deployment*. For more information about deployment, see [Deployment in Microsoft C++](../windows/deployment-in-visual-cpp.md). ## See also diff --git a/docs/build/walkthrough-header-units.md b/docs/build/walkthrough-header-units.md index 2a21f566b61..4e7de18c974 100644 --- a/docs/build/walkthrough-header-units.md +++ b/docs/build/walkthrough-header-units.md @@ -1,6 +1,6 @@ --- description: "Learn more about C++ header units. Convert a header file to a header unit using Visual Studio 2022." -title: "Walkthrough: Build and import header units in Visual C++ projects" +title: "Walkthrough: Build and import header units in Microsoft C++ projects" ms.date: 09/29/2022 ms.custom: "conceptual" author: "tylermsft" @@ -9,7 +9,7 @@ helpviewer_keywords: ["import", "header unit", "ifc"] monikerRange: '>=msvc-160' --- -# Walkthrough: Build and import header units in Microsoft Visual C++ +# Walkthrough: Build and import header units in Microsoft C++ This article is about building and importing header units with Visual Studio 2022. To learn how to import C++ standard library headers as header units, see [Walkthrough: Import STL libraries as header units](walkthrough-import-stl-header-units.md). For an even faster and more robust way to import the standard library, see [Tutorial: Import the C++ standard library using modules](../cpp/tutorial-import-stl-named-module.md). diff --git a/docs/build/walkthrough-import-stl-header-units.md b/docs/build/walkthrough-import-stl-header-units.md index 3c2fd2d7e57..1f50e2518f9 100644 --- a/docs/build/walkthrough-import-stl-header-units.md +++ b/docs/build/walkthrough-import-stl-header-units.md @@ -221,5 +221,5 @@ The main consideration for whether to use this approach is the balance between c [Compare header units, modules, and precompiled headers](compare-inclusion-methods.md)\ [Tutorial: Import the C++ standard library using modules](../cpp/tutorial-import-stl-named-module.md)\ -[Walkthrough: Build and import header units in your Visual C++ projects](walkthrough-header-units.md)\ +[Walkthrough: Build and import header units in your Microsoft C++ projects](walkthrough-header-units.md)\ [`/translateInclude`](./reference/translateinclude.md) diff --git a/docs/build/walkthrough-using-msbuild-to-create-a-visual-cpp-project.md b/docs/build/walkthrough-using-msbuild-to-create-a-visual-cpp-project.md index 2e210281852..b96564b5d3c 100644 --- a/docs/build/walkthrough-using-msbuild-to-create-a-visual-cpp-project.md +++ b/docs/build/walkthrough-using-msbuild-to-create-a-visual-cpp-project.md @@ -4,9 +4,9 @@ description: "A walkthrough that shows how to create a command-line MSBuild C++ ms.date: 10/08/2020 helpviewer_keywords: ["MSBuild (C++), walkthrough: create a project"] --- -# Walkthrough: Using MSBuild to Create a Visual C++ Project +# Walkthrough: Using MSBuild to Create a Visual Studio C++ Project -This walkthrough demonstrates how to use MSBuild in a command prompt to build a Visual Studio C++ project. You'll learn how to create an XML-based *`.vcxproj`* project file for a Visual C++ console application. After building the project, you'll learn how to customize the build process. +This walkthrough demonstrates how to use MSBuild in a command prompt to build a Visual Studio C++ project. You'll learn how to create an XML-based *`.vcxproj`* project file for a C++ console application. After building the project, you'll learn how to customize the build process. > [!IMPORTANT] > Don't use this approach if you intend to edit the project file later by using the Visual Studio IDE. If you create a *`.vcxproj`* file manually, the Visual Studio IDE might not be able to edit or load it, especially if the project uses wildcards in project items. For more information, see [`.vcxproj` and `.props` file structure](./reference/vcxproj-file-structure.md) and [`.vcxproj` files and wildcards](./reference/vcxproj-files-and-wildcards.md). @@ -78,7 +78,7 @@ In this walkthrough, you'll create a project that has a source file and a header An MSBuild project file is an XML file that contains a project root element (``). In the example project you'll build, the `` element contains seven child elements: - Three item group tags (``) that specify project configuration and platform, source file name, and header file name. -- Three import tags (``) that specify the location of Microsoft Visual C++ settings. +- Three import tags (``) that specify the location of Microsoft C++ settings. - A property group tag (``) that specifies project settings. ### To create the MSBuild project file @@ -249,7 +249,7 @@ At the command prompt, enter this command to use the 64-bit tools to build your ### Using MSBuild with a different toolset -If you have the toolsets and libraries for other versions of Visual C++ installed, MSBuild can build applications for either the current Visual C++ version or for the other installed versions. For example, if you have installed Visual Studio 2012, to specify the Visual C++ 11.0 toolset for Windows XP, add this property group element to the *`Myproject.vcxproj`* project file after the *`Microsoft.Cpp.props`* file `` element: +If you have the toolsets and libraries for other versions of Microsoft C++ (MSVC) installed, MSBuild can build applications for either the current MSVC version or for the other installed versions. For example, if you have installed Visual Studio 2012, to specify the Visual C++ 11.0 toolset for Windows XP, add this property group element to the *`Myproject.vcxproj`* project file after the *`Microsoft.Cpp.props`* file `` element: ```xml diff --git a/docs/build/why-floating-point-numbers-may-lose-precision.md b/docs/build/why-floating-point-numbers-may-lose-precision.md index 7fc2eb91e9a..45605f0aa43 100644 --- a/docs/build/why-floating-point-numbers-may-lose-precision.md +++ b/docs/build/why-floating-point-numbers-may-lose-precision.md @@ -17,7 +17,7 @@ This behavior is the result of one of the following: To resolve the behavior, most programmers either ensure that the value is greater or less than what is needed, or they get and use a Binary Coded Decimal (BCD) library that will maintain the precision. -Binary representation of floating-point values affects the precision and accuracy of floating-point calculations. Microsoft Visual C++ uses [IEEE floating-point format](ieee-floating-point-representation.md). +Binary representation of floating-point values affects the precision and accuracy of floating-point calculations. Microsoft C++ uses [IEEE floating-point format](ieee-floating-point-representation.md). ## Example diff --git a/docs/build/working-with-project-properties.md b/docs/build/working-with-project-properties.md index 3540aad87db..b6ca518f4c8 100644 --- a/docs/build/working-with-project-properties.md +++ b/docs/build/working-with-project-properties.md @@ -41,7 +41,7 @@ For more information about setting properties for a Debug build, see: - [Project settings for a C++ debug configuration](/visualstudio/debugger/project-settings-for-a-cpp-debug-configuration) - [Debugger Settings and Preparation](/visualstudio/debugger/debugger-settings-and-preparation) -- [Debugging Preparation: Visual C++ Project Types](/visualstudio/debugger/debugging-preparation-visual-cpp-project-types) +- [Debugging Preparation: Microsoft C++ Project Types](/visualstudio/debugger/debugging-preparation-visual-cpp-project-types) - [Specify symbol (.pdb) and source files in the Visual Studio debugger](/visualstudio/debugger/specify-symbol-dot-pdb-and-source-files-in-the-visual-studio-debugger) ## C++ compiler and linker options diff --git a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md index f2c9b0519be..4cc0476df39 100644 --- a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md +++ b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md @@ -1,11 +1,11 @@ --- -title: "Cloud and Web Programming in Visual C++" -description: "Learn more about: Cloud and Web Programming in Visual C++" +title: "Cloud and Web Programming in Microsoft C++" +description: "Learn more about: Cloud and Web Programming in Microsoft C++" ms.date: "05/14/2019" ms.topic: "overview" ms.custom: intro-overview --- -# Cloud and Web Programming in Visual C++ +# Cloud and Web Programming in Microsoft C++ In C++, you have several options for connecting to the web and the cloud. diff --git a/docs/code-quality/build-reliable-secure-programs.md b/docs/code-quality/build-reliable-secure-programs.md index 94181eb5c90..2f31f19fc15 100644 --- a/docs/code-quality/build-reliable-secure-programs.md +++ b/docs/code-quality/build-reliable-secure-programs.md @@ -114,8 +114,8 @@ Tests that do deeper verification and take longer to run, such as static analysi **Key tools** Be aware of and use the following: - [Code analysis documentation - C++ and .NET](/visualstudio/code-quality/) -- [`/analyze` - Visual C++ compiler](../build/reference/analyze-code-analysis.md) -- [`/W4` and `/WX` - Visual C++ compiler](../build/reference/compiler-option-warning-level.md) +- [`/analyze` - Microsoft C++ compiler](../build/reference/analyze-code-analysis.md) +- [`/W4` and `/WX` - Microsoft C++ compiler](../build/reference/compiler-option-warning-level.md) - [Use the C++ Core Guidelines Checkers](using-the-cpp-core-guidelines-checkers.md) - [CodeQL | GitHub](https://codeql.github.com/) - [Binskim user guide | GitHub](https://github.com/microsoft/binskim/blob/main/docs/UserGuide.md) @@ -123,7 +123,7 @@ Tests that do deeper verification and take longer to run, such as static analysi Notes: -- `/analyze` enables static analysis of C++ code at compile time to identify critical security and reliability code vulnerabilities. It should be enabled throughout a C++ program's entire development timeline. Start by enabling at least the "Microsoft Native Recommended" by default as a minimum baseline. Then consult the documentation for how to specify more rules, especially the C++ Core Guidelines rules, as required by your engineering policies. The source code Static Analysis capability is available in both the Visual C++ IDE and in the command-line Build Tools. +- `/analyze` enables static analysis of C++ code at compile time to identify critical security and reliability code vulnerabilities. It should be enabled throughout a C++ program's entire development timeline. Start by enabling at least the "Microsoft Native Recommended" by default as a minimum baseline. Then consult the documentation for how to specify more rules, especially the C++ Core Guidelines rules, as required by your engineering policies. The source code Static Analysis capability is available in both the Visual Studio IDE and in the command-line Build Tools. - `/W4` and `/WX` should be enabled wherever possible, to ensure you compile your code cleanly at high warning levels (`W4`) and treat warnings as errors that must be fixed (`WX`). These options enable finding uninitialized data errors that other static analysis tools can't check, because the errors only become visible after the compiler back-end performs interprocedural analysis and inlining. - BinSkim binary analysis ensures that projects enable a broad range of security features. BinSkim generates PDBs and other outputs that make it easier to verify chain-of-custody and to respond efficiently to security issues. Microsoft recommends running the BinSkim tool to analyze all executable binaries (`.sys`, `.dll` or `.exe`) produced for or consumed by your programs. The BinSkim User Guide includes a list of supported security standards. Microsoft recommends that you fix all issues reported as "errors" by the BinSkim tool. Issues reported as "warnings" should be evaluated selectively, because resolving them can have performance implications or might not be necessary. @@ -249,14 +249,14 @@ Binaries shouldn't link to insecure libraries and dependencies. Development team Compilation should enable strong code provenance guarantees to help detect and prevent introduction of backdoors and other malicious code. The resulting data, also critical to debugging and investigation, should be archived for all software releases to drive efficient security response if they're compromised. The following compiler switches generate information that is critical to a security response: -- [`/ZH:SHA_SHA256` in Visual C++](../build/reference/zh.md) - Ensures that a cryptographically secure algorithm is used to generate all PDB source file hashes. -- [`/Zi`, `/ZI` (Debug Information Format) in Visual C++](../build/reference/z7-zi-zi-debug-information-format.md) - In addition to publishing stripped symbols for collecting crash data and other public use scenarios, ensure that builds produce and archive private PDBs for all released binaries. Binary analysis tools require full symbols to verify whether many security mitigations were enabled at compile-time. Private symbols are critical in security response, and lower debugging and investigation costs when engineers are racing to assess and limit damage when an exploit happens. -- [`/SOURCELINK` in Visual C++ Linker - Include Sourcelink file in PDB](../build/reference/sourcelink.md): Source link is a language- and source-control agnostic system providing source debugging for binaries. Source debugging greatly increases the efficiency the range of prerelease security validations and post-release incident response. +- [`/ZH:SHA_SHA256` in Microsoft C++](../build/reference/zh.md) - Ensures that a cryptographically secure algorithm is used to generate all PDB source file hashes. +- [`/Zi`, `/ZI` (Debug Information Format) in Microsoft C++](../build/reference/z7-zi-zi-debug-information-format.md) - In addition to publishing stripped symbols for collecting crash data and other public use scenarios, ensure that builds produce and archive private PDBs for all released binaries. Binary analysis tools require full symbols to verify whether many security mitigations were enabled at compile-time. Private symbols are critical in security response, and lower debugging and investigation costs when engineers are racing to assess and limit damage when an exploit happens. +- [`/SOURCELINK` in Microsoft C++ Linker - Include Sourcelink file in PDB](../build/reference/sourcelink.md): Source link is a language- and source-control agnostic system providing source debugging for binaries. Source debugging greatly increases the efficiency the range of prerelease security validations and post-release incident response. **Enable compiler errors to prevent issues at code authoring time** Compilation should enable security-relevant compiler checks as breaking errors, for example: -- [`/sdl` in Visual C++ - Enable additional security checks](https://aka.ms/AdditionalSecurityChecks) elevates many security-relevant warnings into errors and enables advanced secure code-generation features. +- [`/sdl` in Microsoft C++ - Enable additional security checks](https://aka.ms/AdditionalSecurityChecks) elevates many security-relevant warnings into errors and enables advanced secure code-generation features. - [BinSkim BA2007.EnableCriticalCompilerWarnings | GitHub](https://github.com/microsoft/binskim/blob/main/src/BinSkim.Rules/PERules/BA2007.EnableCriticalCompilerWarnings.cs) maintains a list of Microsoft-recommended C/C++ compiler warnings that should always be enabled and elevated to errors. **Mark binaries as compatible with OS runtime security mitigations** @@ -401,7 +401,7 @@ Modify your build(s) to support continuous creation of executables that use LibF **Summary** -Within the scope of Microsoft Visual C++ on Windows, Microsoft recommends: +Within the scope of Microsoft C++ on Windows, Microsoft recommends: - Prefer TypeScript, JavaScript, and ASP.NET for web applications. - Don't write web extensions in C++. Microsoft has deprecated ActiveX. diff --git a/docs/code-quality/code-analysis-for-c-cpp-overview.md b/docs/code-quality/code-analysis-for-c-cpp-overview.md index 33c4a8e91e1..fffa6d3ad8b 100644 --- a/docs/code-quality/code-analysis-for-c-cpp-overview.md +++ b/docs/code-quality/code-analysis-for-c-cpp-overview.md @@ -20,7 +20,7 @@ ms.assetid: 81f0c9e8-f471-4de5-aac4-99db336a8809 --- # Code analysis for C/C++ overview -The C/C++ Code Analysis tool provides information about possible defects in your C/C++ source code. Common coding errors reported by the tool include buffer overruns, uninitialized memory, null pointer dereferences, and memory and resource leaks. The tool can also run checks against the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). +The Microsoft C++ Code Analysis tool provides information about possible defects in your C/C++ source code. Common coding errors reported by the tool include buffer overruns, uninitialized memory, null pointer dereferences, and memory and resource leaks. The tool can also run checks against the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). ## IDE (integrated development environment) integration diff --git a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md index fefa3144ce2..34cdcc545ff 100644 --- a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md +++ b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md @@ -8,7 +8,7 @@ dev_langs: --- # Use the C++ Core Guidelines checkers -The C++ Core Guidelines are a portable set of guidelines, rules, and best practices about coding in C++ created by C++ experts and designers. Visual Studio currently supports a subset of these rules as part of its code analysis tools for C++. The core guideline checkers are installed by default in Visual Studio 2017 and Visual Studio 2019. They're [available as a NuGet package for Visual Studio 2015](#vs2015_corecheck). +The C++ Core Guidelines are a portable set of guidelines, rules, and best practices about coding in C++ created by C++ experts and designers. Visual Studio currently supports a subset of these rules as part of its Microsoft C++ Code Analysis tools. The core guideline checkers are installed by default in Visual Studio 2017 and Visual Studio 2019. They're [available as a NuGet package for Visual Studio 2015](#vs2015_corecheck). ## The C++ Core Guidelines Project diff --git a/docs/embedded/download-and-install-the-embedded-tooling.md b/docs/embedded/download-and-install-the-embedded-tooling.md index 1fe6ea96d53..e16dae943ea 100644 --- a/docs/embedded/download-and-install-the-embedded-tooling.md +++ b/docs/embedded/download-and-install-the-embedded-tooling.md @@ -25,7 +25,7 @@ To use the embedded development tools in Visual Studio, you must install the req 1. Open the Visual Studio Installer. In Visual Studio Installer, choose **Modify** next to your installation of Visual Studio, and then select the **Workloads** tab. Scroll down to **Other toolsets** and select the **Linux and embedded development with C++** workload. - ![Screenshot showing the Visual C++ for Linux Development workload item in Visual Studio Installer.](media/linux-and-embedded-workload.png) + ![Screenshot showing the Microsoft C++ for Linux Development workload item in Visual Studio Installer.](media/linux-and-embedded-workload.png) 1. Choose **Modify** to continue with the installation. diff --git a/docs/get-started/toc.yml b/docs/get-started/toc.yml index bc7a83fb976..32d38ad40ef 100644 --- a/docs/get-started/toc.yml +++ b/docs/get-started/toc.yml @@ -1,5 +1,5 @@ items: -- name: Get started with Visual C++ +- name: Get started with Microsoft C++ expanded: true items: - name: Install C++ support in Visual Studio diff --git a/docs/get-started/tutorial-console-cpp.md b/docs/get-started/tutorial-console-cpp.md index db968eefaa5..608ab706e06 100644 --- a/docs/get-started/tutorial-console-cpp.md +++ b/docs/get-started/tutorial-console-cpp.md @@ -1,6 +1,6 @@ --- title: "Create a console calculator in C++" -description: "Create a Hello World console app and a calculator app in Visual C++" +description: "Create a Hello World console app and a calculator app in Visual Studio C++" ms.custom: "acquisition, mvc" ms.date: 10/08/2024 ms.topic: "tutorial" diff --git a/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md b/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md index 45a30a66416..5f115d743cc 100644 --- a/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md +++ b/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md @@ -16,7 +16,7 @@ If you haven't installed Visual Studio yet, now is the time. For download links These walkthroughs assume that you've installed Visual Studio and the C++ components required for Windows Desktop development. We also assume you understand the fundamentals of the C++ language. If you need to learn C++, there are many books and web resources available. One good place to start is the [Get Started](https://isocpp.org/get-started) page of the Standard C++ Foundation website. -In general, we highly recommend that you use the latest version of Visual Studio even if you need to compile your code using an earlier version of the compiler toolset. For more information, see [Use native multi-targeting in Visual Studio to build old projects](../porting/use-native-multi-targeting.md). +In general, we highly recommend that you use the latest version of Visual Studio even if you need to compile your code using an earlier version of the Microsoft C++ (MSVC) Build Tools. For more information, see [Use native multi-targeting in Visual Studio to build old projects](../porting/use-native-multi-targeting.md). Once your Visual Studio installation is complete, you are ready to continue. @@ -36,7 +36,7 @@ To get started using the Visual Studio IDE to build C++ apps, work through each ## Next steps -Once you've completed these walkthroughs, you're ready to start building your own projects. For more information and resources for C++ development, see [Visual C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md). +Once you've completed these walkthroughs, you're ready to start building your own projects. For more information and resources for C++ development, see [Microsoft C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md). ## See also diff --git a/docs/ide/writing-and-refactoring-code-cpp.md b/docs/ide/writing-and-refactoring-code-cpp.md index 72dc71d8b4f..cfb3dbfdead 100644 --- a/docs/ide/writing-and-refactoring-code-cpp.md +++ b/docs/ide/writing-and-refactoring-code-cpp.md @@ -22,7 +22,7 @@ search for "IntelliSense" in **Quick Launch** (Ctrl + Q) and choose the **Text E The **Member List Filter Mode** option controls what kinds of IntelliSense autocomplete suggestions you see. By default, it's set to **Fuzzy**. In a fuzzy search, if you have a symbol called *MyAwesomeClass*, you can type "MAC" and find the class in your autocomplete suggestions. The fuzzy algorithm sets a minimum threshold that symbols must meet to show up in the list. **Smart** filtering displays all symbols containing substrings that match what you typed. **Prefix** filtering searches for strings that begin with what you typed. -For more information about C++ IntelliSense, see [Visual C++ IntelliSense](/visualstudio/ide/visual-cpp-intellisense) and [Configure a C++ project for IntelliSense](/visualstudio/ide/visual-cpp-intellisense-configuration). +For more information about C++ IntelliSense, see [Visual Studio C++ IntelliSense](/visualstudio/ide/visual-cpp-intellisense) and [Configure a C++ project for IntelliSense](/visualstudio/ide/visual-cpp-intellisense-configuration). ## IntelliCode diff --git a/docs/intrinsics/arm-intrinsics.md b/docs/intrinsics/arm-intrinsics.md index f2a248f9a97..bde0f7c5627 100644 --- a/docs/intrinsics/arm-intrinsics.md +++ b/docs/intrinsics/arm-intrinsics.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["cl.exe compiler, ARM intrinsics", "intrinsics, ARM", "__c --- # ARM intrinsics -The Microsoft C++ compiler (MSVC) makes the following intrinsics available on the ARM architecture. For more information about ARM, see the Architecture and Software Development Tools sections of the [ARM Developer Documentation](https://developer.arm.com/docs) website. +The Microsoft C++ (MSVC) compiler makes the following intrinsics available on the ARM architecture. For more information about ARM, see the Architecture and Software Development Tools sections of the [ARM Developer Documentation](https://developer.arm.com/docs) website. ## NEON diff --git a/docs/intrinsics/arm64-intrinsics.md b/docs/intrinsics/arm64-intrinsics.md index 8300ceea360..c610e426be3 100644 --- a/docs/intrinsics/arm64-intrinsics.md +++ b/docs/intrinsics/arm64-intrinsics.md @@ -9,7 +9,7 @@ ms.date: "11/14/2019" --- # ARM64 intrinsics -The Microsoft C++ compiler (MSVC) makes the following intrinsics available on the ARM64 architecture. For more information about ARM, see the Architecture and Software Development Tools sections of the [ARM Developer Documentation](https://developer.arm.com/docs) website. +The Microsoft C++ (MSVC) compiler makes the following intrinsics available on the ARM64 architecture. For more information about ARM, see the Architecture and Software Development Tools sections of the [ARM Developer Documentation](https://developer.arm.com/docs) website. ## NEON diff --git a/docs/intrinsics/compiler-intrinsics.md b/docs/intrinsics/compiler-intrinsics.md index ea886301346..381e8610042 100644 --- a/docs/intrinsics/compiler-intrinsics.md +++ b/docs/intrinsics/compiler-intrinsics.md @@ -13,7 +13,7 @@ Most functions are contained in libraries, but some functions are built in (that If a function is an intrinsic, the code for that function is usually inserted inline, avoiding the overhead of a function call and allowing highly efficient machine instructions to be emitted for that function. An intrinsic is often faster than the equivalent inline assembly, because the optimizer has a built-in knowledge of how many intrinsics behave, so some optimizations can be available that are not available when inline assembly is used. Also, the optimizer can expand the intrinsic differently, align buffers differently, or make other adjustments depending on the context and arguments of the call. -The use of intrinsics affects the portability of code, because intrinsics that are available in Visual C++ might not be available if the code is compiled with other compilers and some intrinsics that might be available for some target architectures are not available for all architectures. However, intrinsics are usually more portable than inline assembly. The intrinsics are required on 64-bit architectures where inline assembly is not supported. +The use of intrinsics affects the portability of code, because intrinsics that are available in Microsoft C++ might not be available if the code is compiled with other compilers and some intrinsics that might be available for some target architectures are not available for all architectures. However, intrinsics are usually more portable than inline assembly. The intrinsics are required on 64-bit architectures where inline assembly is not supported. Some intrinsics, such as **`__assume`** and `__ReadWriteBarrier`, provide information to the compiler, which affects the behavior of the optimizer. diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index b167daf2351..f1502c60088 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -1,14 +1,14 @@ --- -description: "Learn more about Microsoft Visual C++ compiler versioning." -title: "Microsoft Visual C++ compiler versioning (Visual C++)" +description: "Learn more about Microsoft C++ compiler versioning." +title: "Microsoft C++ (MSVC) compiler versioning" ms.date: 02/12/2025 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] --- -# Microsoft Visual C++ compiler versioning +# Microsoft C++ (MSVC) compiler versioning -The Microsoft Visual C++ compiler version consists of four fields: +The Microsoft C++ (MSVC) compiler version consists of four fields: M - major version (two digits)\ N - minor version (two digits)\ @@ -33,9 +33,9 @@ The macros reflect these values like this: - `_MSC_BUILD` (the revision) is 0. >[!Note] ->Visual Studio 2019 16.8 and 16.9 share the same major and minor versions, and so have the same value for `_MSC_VER`. As do Visual Studio 2019 16.10 and 16.11. To distinguish them, use `_MSC_FULL_VER` as described in [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017). +>Visual Studio 2019 versions 16.8 and 16.9 share the same major and minor versions, and so have the same value for `_MSC_VER`. As do Visual Studio 2019 versions 16.10 and 16.11. To distinguish them, use `_MSC_FULL_VER` as described in [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017). -## A brief history of Visual C++ compiler versioning +## A brief history of Microsoft C++ compiler versioning ### Visual Studio 6.0 through Visual Studio 2015 (14.0) @@ -45,20 +45,26 @@ The macros reflect these values like this: >[!Note] > Visual Studio .NET 2003 was considered a minor release. -### Visual Studio 2017 and later +### Visual Studio 2017 to Visual Studio 2022 - For major releases, the minor version increases by 10. - For minor releases, the minor version increases by 1 starting with Visual Studio 2017 version 15.3. +### Visual Studio 2026 and later + +- The compiler minor version is no longer incremented in relation to Visual Studio version updates. +- The minor version increments by 1 with each new MSVC release. +- Not every new Visual Studio version will ship a new MSVC compiler version. + ### Service releases starting with Visual Studio 2017 Servicing releases are distinguished by `_MSC_FULL_VER`. The build field (the BBBBB in the MMNNBBBBB version number) typically increases by 1. -For example, two cases where `_MSC_FULL_VER` is useful is to distinguish Visual Studio 2019 16.8 from 16.9, and Visual Studio 2019 16.10 from 16.11. That's because those versions share the same major and minor versions, and so have the same value for `_MSC_VER`. +For example, two cases where `_MSC_FULL_VER` is useful is to distinguish Visual Studio 2019 version 16.8 from 16.9, and Visual Studio 2019 version 16.10 from 16.11. That's because those versions share the same major and minor versions, and so have the same value for `_MSC_VER`. To distinguish these versions, use `_MSC_FULL_VER`.\ -The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.8 is 192829333.\ -The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.9 is 192829910. +The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.8 is 192829333.\ +The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.9 is 192829910. ## Version macros @@ -71,17 +77,17 @@ R - revision version **[`_MSC_VER`](../preprocessor/predefined-macros.md)** distinguishes between major and minor releases. It has the form: MMNN. -**[`_MSC_FULL_VER`](../preprocessor/predefined-macros.md)** represents the major, minor, and build version of the compiler. It has the form: MMNNBBBBB. Use it to distinguish between different versions of the compiler, including servicing releases. For more information about Visual Studio 2019 16.8, 16.9, 16.10 and 16.11, see [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017). +**[`_MSC_FULL_VER`](../preprocessor/predefined-macros.md)** represents the major, minor, and build version of the compiler. It has the form: MMNNBBBBB. Use it to distinguish between different versions of the compiler, including servicing releases. For more information about Visual Studio 2019 versions 16.8, 16.9, 16.10 and 16.11, see [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017). **[`_MSC_BUILD`](../preprocessor/predefined-macros.md)** represents the build version of the compiler. It has the form: R. Use it to distinguish between servicing releases. When the major version changed between Visual Studio 2013 and Visual Studio 2015, `_MSC_VER` reflected the change by going from 1800 to 1900. -An example of a minor change is from Visual Studio 2022 17.1 to Visual Studio 2022 17.2. In that case, `_MSC_VER` changed from 1931 to 1932. +An example of a minor change is from Visual Studio 2022 version 17.1 to Visual Studio 2022 version 17.2. In that case, `_MSC_VER` changed from 1931 to 1932. -The following table lists the Visual Studio version corresponding to each Visual C++ compiler (`_MSC_VER`) and MSVC toolset release: +The following table lists the Visual Studio version corresponding to each Microsoft C++ compiler (`_MSC_VER`) and MSVC Build Tools release: -| Visual Studio version | `_MSC_VER` | MSVC toolset version | +| Visual Studio version | `_MSC_VER` | MSVC Build Tools version | |--|--|--| | Visual Studio 6.0 | 1200 | 6.0 | | Visual Studio .NET 2002 (7.0) | 1300 | 7.0 | @@ -125,9 +131,9 @@ The following table lists the Visual Studio version corresponding to each Visual | Visual Studio 2022 version 17.13 | 1943 | 14.43 | | Visual Studio 2022 version 17.14 | 1944 | 14.44 | -a Visual Studio 2019 16.8 and 16.9 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.8 is 192829333. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.9 is 192829910. +a Visual Studio 2019 versions 16.8 and 16.9 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.8 is 192829333. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.9 is 192829910. -b Visual Studio 2019 16.10 and 16.11 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.10 is 192929917. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.11 is 192930129. +b Visual Studio 2019 versions 16.10 and 16.11 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.10 is 192929917. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.11 is 192930129. ## See also diff --git a/docs/overview/cpp-conformance-improvements-2019.md b/docs/overview/cpp-conformance-improvements-2019.md index e3b390b72fe..17c1f7f7a39 100644 --- a/docs/overview/cpp-conformance-improvements-2019.md +++ b/docs/overview/cpp-conformance-improvements-2019.md @@ -7,7 +7,7 @@ ms.subservice: "cpp-lang" --- # C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2019 -Microsoft C/C++ in Visual Studio (MSVC) makes conformance improvements and bug fixes in every release. This article lists the improvements by major release, then by version. To jump directly to the changes for a specific version, use the list below **In this article**. +Microsoft C++ (MSVC) Build Tools in Visual Studio makes conformance improvements and bug fixes in every release. This article lists the improvements by major release, then by version. To jump directly to the changes for a specific version, use the list below **In this article**. This document lists the changes in Visual Studio 2019. For a guide to the changes in Visual Studio 2022, see [C++ conformance improvements in Visual Studio 2022](cpp-conformance-improvements.md). For changes in Visual Studio 2017, see [C++ conformance improvements in Visual Studio 2017](cpp-conformance-improvements-2017.md). For a complete list of previous conformance improvements, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index 5fff09d04d6..813d310ea09 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -1,5 +1,5 @@ --- -title: "How to report a problem with the Microsoft C++ toolset" +title: "How to report a problem with the Microsoft C++ Build Tools" description: How to create a good problem report and repro information for the Microsoft C++ toolset. ms.date: "09/24/2019" ms.service: "visual-cpp" @@ -7,7 +7,7 @@ ms.subservice: "ide" author: "tylermsft" ms.author: "twhitney" --- -# How to report a problem with the Microsoft C++ toolset or documentation +# How to report a problem with the Microsoft C++ Build Tools or documentation If you find problems in the Microsoft C++ compiler (MSVC), the linker, or other tools and libraries, we want to know about them. When the issue is in our documentation, we want to know about that, too. @@ -382,7 +382,7 @@ For issues with the C++ compiler, linker, and other tools and libraries, first s > Information in the initial Developer Community report will always be public. If this is a concern, see the next section about [Reports and privacy](#reports-and-privacy). > [!TIP] -> For other kinds of problems you might find in Visual Studio that are unrelated to the C++ toolset (For example, UI issues, broken IDE functionality, or general crashes), use the **Report a Problem** tool in the IDE. This is the best choice, due to its screenshot capabilities and its ability to record UI actions that lead to the problem you found. These kinds of errors can also be looked up on the Visual Studio [Developer Community](https://aka.ms/feedback/report?space=8) site. For more information, see [How to report a problem with Visual Studio](/visualstudio/ide/how-to-report-a-problem-with-visual-studio). +> For other kinds of problems you might find in Visual Studio that are unrelated to the Microsoft C++ Build Tools (For example, UI issues, broken IDE functionality, or general crashes), use the **Report a Problem** tool in the IDE. This is the best choice, due to its screenshot capabilities and its ability to record UI actions that lead to the problem you found. These kinds of errors can also be looked up on the Visual Studio [Developer Community](https://aka.ms/feedback/report?space=8) site. For more information, see [How to report a problem with Visual Studio](/visualstudio/ide/how-to-report-a-problem-with-visual-studio). ### Reports and privacy diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 1e369fd7e73..2b52a32f94e 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: Supported Platforms (Visual C++)" -title: "Supported Platforms (Visual C++)" +description: "Learn more about: Supported Platforms (Microsoft C++)" +title: "Supported Platforms (Microsoft C++)" ms.date: 10/22/2025 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] --- -# Supported platforms (Visual C++) +# Supported platforms (Microsoft C++) Apps built by using Visual Studio can be targeted to various platforms. @@ -48,9 +48,9 @@ Support for targeting 32-bit ARM was permanently removed in VS 2026 18.0. f You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. -For information about how to set the target platform configuration, see [How to: Configure Visual C++ projects to target 64-bit, x64 platforms](../build/how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). +For information about how to set the target platform configuration, see [How to: Configure Microsoft C++ projects to target 64-bit, x64 platforms](../build/how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). ## See also -[Visual C++ tools and features in Visual Studio editions](visual-cpp-tools-and-features-in-visual-studio-editions.md)\ +[Microsoft C++ tools and features in Visual Studio editions](visual-cpp-tools-and-features-in-visual-studio-editions.md)\ [Getting Started](/visualstudio/ide/getting-started-with-cpp-in-visual-studio) diff --git a/docs/overview/toc.yml b/docs/overview/toc.yml index 66d418921eb..8c34abe851e 100644 --- a/docs/overview/toc.yml +++ b/docs/overview/toc.yml @@ -32,7 +32,7 @@ items: href: ../overview/visual-cpp-samples.md - name: Help and community href: ../overview/visual-cpp-help-and-community.md - - name: How to report a problem with the Visual C++ toolset + - name: How to report a problem with the Microsoft C++ Build Tools href: ../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md - name: Visual Studio C++ Tutorials expanded: false diff --git a/docs/overview/visual-cpp-in-visual-studio.md b/docs/overview/visual-cpp-in-visual-studio.md index 30012947cad..111b4036a69 100644 --- a/docs/overview/visual-cpp-in-visual-studio.md +++ b/docs/overview/visual-cpp-in-visual-studio.md @@ -44,9 +44,9 @@ helpviewer_keywords: ["Visual C++, home page"] :::moniker-end -Microsoft Visual C++ (MSVC) refers to the C++, C, and assembly language development tools and libraries available as part of Visual Studio on Windows. These tools and libraries let you create native Windows desktop and server applications, Universal Windows Platform (UWP) apps, or managed apps and libraries that use the .NET Framework. Create cross-platform libraries and apps that run on Windows, Linux, Android, and iOS. You can use MSVC to write anything from simple console apps to the most sophisticated and complex apps for Windows desktop. Write device drivers and operating system components or cross-platform games for mobile devices. Target anything from the smallest IoT devices to multi-server high performance computing in the Azure cloud. +Microsoft C++ (MSVC) refers to the C++, C, and assembly language development tools and libraries available as part of Visual Studio on Windows. These tools and libraries let you create native Windows desktop and server applications, Universal Windows Platform (UWP) apps, or managed apps and libraries that use the .NET Framework. Create cross-platform libraries and apps that run on Windows, Linux, Android, and iOS. You can use MSVC to write anything from simple console apps to the most sophisticated and complex apps for Windows desktop. Write device drivers and operating system components or cross-platform games for mobile devices. Target anything from the smallest IoT devices to multi-server high performance computing in the Azure cloud. -Visual Studio 2015, 2017, 2019, and 2022 can be installed side-by-side. You can use Visual Studio 2019 (compiler toolset v142) or Visual Studio 2017 (v141) to edit and build programs using the toolset from Visual Studio 2017 (v141) and Visual Studio 2015 (v140). +You can install Visual Studio 2015 and later side-by-side. For example, you can use Visual Studio 2019 (compiler toolset v142) or Visual Studio 2017 (v141) to edit and build programs using the toolset from Visual Studio 2017 (v141) and Visual Studio 2015 (v140). ## What's new for C++ in Visual Studio @@ -74,7 +74,7 @@ Learn about the breaking changes in previous versions. ## Install Visual Studio C++ and upgrade from earlier versions [Install C++ support in Visual Studio](../build/vscpp-step-0-installation.md)\ -Download Visual Studio and install the Microsoft C/C++ toolset. +Download Visual Studio and install the Microsoft C++ Build Tools. [Microsoft C++ porting and upgrading guide](../porting/visual-cpp-porting-and-upgrading-guide.md)\ Guidance for porting code and upgrading projects to Visual Studio 2015 or later. Take advantage of greater compiler conformance to the C++ standard, greatly improved compilation times, and security features such as Spectre mitigation. diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index b276614c6a6..5f15f171582 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -9,7 +9,7 @@ ms.subservice: "cpp-lang" Standards conformance for the Microsoft C/C++ compiler in Visual Studio (MSVC) is a work in progress. Here's a summary of ISO Standard C and C++ language and library conformance by Visual Studio version. Each C++ compiler and standard library feature name has a link to the ISO Standard C++ proposal paper that describes the feature, when one is available at publication time. The **Supported** column lists the Visual Studio version in which support for the feature first appeared. -For details on conformance improvements, see [C++ conformance improvements in Visual Studio](cpp-conformance-improvements.md). For a list of other changes, see [What's New for Visual C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md). For conformance changes in earlier versions, see [Visual C++ change history](../porting/visual-cpp-change-history-2003-2015.md) and [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). For current news from the C++ team, visit the [C++ team blog](https://devblogs.microsoft.com/cppblog/). +For details on conformance improvements, see [C++ conformance improvements in Visual Studio](cpp-conformance-improvements.md). For a list of other changes, see [What's New for Microsoft C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md). For conformance changes in earlier versions, see [Visual C++ change history](../porting/visual-cpp-change-history-2003-2015.md) and [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). For current news from the C++ team, visit the [C++ team blog](https://devblogs.microsoft.com/cppblog/). > [!NOTE] > There are no binary breaking changes between Visual Studio 2015, 2017, 2019, and 2022. For more information, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) @@ -652,7 +652,7 @@ These algorithms aren't presently parallelized: [C++ Language Reference](../cpp/cpp-language-reference.md)\ [C++ Standard Library](../standard-library/cpp-standard-library-reference.md)\ [C++ conformance improvements in Visual Studio](cpp-conformance-improvements.md)\ -[What's New for Visual C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md)\ +[What's New for Microsoft C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md)\ [Visual C++ change history 2003 through 2015](../porting/visual-cpp-change-history-2003-2015.md)\ [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md)\ [C++ team blog](https://devblogs.microsoft.com/cppblog/) diff --git a/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md b/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md index 8f68bdd1c4a..f05857da1e0 100644 --- a/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md +++ b/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md @@ -15,7 +15,7 @@ The following C++ features are available in Visual Studio. Unless stated otherwi ::: moniker range="<=msvc-150" -The following tables show Visual C++ features that are available in Visual Studio 2017. An X in a cell indicates that the feature is available; an empty cell indicates that the feature is not available. Notes in parentheses indicate that a feature is available, but restricted. +The following tables show C++ features that are available in Visual Studio 2017. An X in a cell indicates that the feature is available; an empty cell indicates that the feature is not available. Notes in parentheses indicate that a feature is available, but restricted. ::: moniker-end diff --git a/docs/sanitizers/asan-building.md b/docs/sanitizers/asan-building.md index 09140d51c92..5ea4cf7b5cf 100644 --- a/docs/sanitizers/asan-building.md +++ b/docs/sanitizers/asan-building.md @@ -149,7 +149,6 @@ The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) pre Prior to Visual Studio 17.7 Preview 3, statically linked (**`/MT`** or **`/MTd`**) builds didn't use a DLL dependency. Instead, the MSVC AddressSanitizer runtime was statically linked into the user's EXE. DLL projects would then load exports from the user's EXE to access ASan functionality. Also, dynamically linked projects (**`/MD`** or **`/MTd`**) used different libraries and DLLs depending on whether the project was configured for debug or release. For more information about these changes and their motivations, see [MSVC AddressSanitizer – One DLL for all Runtime Configurations](https://devblogs.microsoft.com/cppblog/msvc-address-sanitizer-one-dll-for-all-runtime-configurations/). - | CRT runtime option | DLL or EXE | MSVC AddressSanitizer runtime libraries | |--|--|--| | **`/MT`** | EXE | *`/wholearchive:clang_rt.asan-{arch}.lib`*, *`clang_rt.asan_cxx-{arch}.lib`* | diff --git a/docs/sanitizers/asan-continue-on-error.md b/docs/sanitizers/asan-continue-on-error.md index 9d820f863e8..7b590735e84 100644 --- a/docs/sanitizers/asan-continue-on-error.md +++ b/docs/sanitizers/asan-continue-on-error.md @@ -1,16 +1,16 @@ --- -title: "Walkthrough: Use Address Sanitizer Continue On Error to find memory safety issues" -description: "Learn how to use Address Sanitizer continue on error to find memory safety errors in your app." +title: "Walkthrough: Use AddressSanitizer Continue On Error to find memory safety issues" +description: "Learn how to use AddressSanitizer continue on error to find memory safety errors in your app." ms.date: 07/31/2023 f1_keywords: ["AddressSanitizer", "Continue On Error"] helpviewer_keywords: ["ASan", "AddressSanitizer", "Address Sanitizer", "compiling for AddressSanitizer", "Continue On Error", "ASAN continue on error", "Address Sanitizer continue on error"] --- -# Walkthrough: Use Address Sanitizer Continue On Error to find memory safety issues +# Walkthrough: Use AddressSanitizer Continue On Error to find memory safety issues In this walkthrough, create checked builds that find and report memory safety errors. -Memory safety errors like out-of-bounds memory reads and writes, using memory after it has been freed, `NULL` pointer dereferences, and so on, are a top concern for C/C++ code. Address Sanitizer (ASAN) is a compiler and runtime technology that exposes these kinds of hard-to-find bugs, and does it with zero false positives. For an overview of ASAN, see [AddressSanitizer](asan.md). +Memory safety errors like out-of-bounds memory reads and writes, using memory after it has been freed, `NULL` pointer dereferences, and so on, are a top concern for C/C++ code. AddressSanitizer (ASAN) is a compiler and runtime technology that exposes these kinds of hard-to-find bugs, and does it with zero false positives. For an overview of ASAN, see [AddressSanitizer](asan.md). Continue On Error (COE) is a new ASAN feature that automatically diagnoses and reports memory safety errors as your app runs. When your program exits, a summary of unique memory safety errors is output to `stdout`, `stderr`, or to a log file of your choice. When you create a standard C++ checked build with `-fsanitizer=address`, calls to allocators, deallocators such as `free`, `memcpy`, `memset`, and so on, are forwarded to the ASAN runtime. The ASAN runtime provides the same semantics for these functions, but monitors what happens with the memory. ASAN diagnoses and reports hidden memory safety errors, with zero false positives, as your app runs. @@ -67,7 +67,7 @@ In the preceding code, `pointer` is freed twice. This is a contrived example, bu Create a build of the preceding code with COE turned on with the following steps: -1. Compile the code in the developer command prompt you opened earlier: `cl -fsanitize=address -Zi doublefree.cpp`. The `-fsanitize=address` switch turns on ASAN, and `-Zi` creates a separate PDB file that address sanitizer uses to display memory error location information. +1. Compile the code in the developer command prompt you opened earlier: `cl -fsanitize=address -Zi doublefree.cpp`. The `-fsanitize=address` switch turns on ASAN, and `-Zi` creates a separate PDB file that AddressSanitizer uses to display memory error location information. 1. Send ASAN output to `stdout` by setting the `ASAN_OPTIONS` environment variable in the developer command prompt as follows: `set ASAN_OPTIONS=continue_on_error=1` 1. Run the test code with: `doublefree.exe` @@ -213,7 +213,7 @@ Errors are only observable if the page following the allocation is unmapped, or Create a build of the preceding code with COE turned on: -1. Compile the code with `cl -fsanitize=address -Zi coe.cpp`. The `-fsanitize=address` switch turns on ASAN, and `-Zi` creates a separate PDB file that address sanitizer uses to display memory error location information. +1. Compile the code with `cl -fsanitize=address -Zi coe.cpp`. The `-fsanitize=address` switch turns on ASAN, and `-Zi` creates a separate PDB file that AddressSanitizer uses to display memory error location information. 1. Send ASAN output to `stdout` by setting the `ASAN_OPTIONS` environment variable in the developer command prompt as follows: `set ASAN_OPTIONS=continue_on_error=1` 1. Run the test code with: `coe.exe` @@ -263,7 +263,7 @@ File: C:\Users\xxx\Desktop\COE\coe.cpp Raw HitCnt: 1 On Reference: 1-byte-write-heap-buffer-overflow ``` -The default Address Sanitizer runtime behavior terminates the app after reporting the first error it finds. It doesn't allow the "bad" machine instruction to execute. The new Address Sanitizer runtime diagnoses and reports errors, but then executes subsequent instructions. +The default AddressSanitizer runtime behavior terminates the app after reporting the first error it finds. It doesn't allow the "bad" machine instruction to execute. The new AddressSanitizer runtime diagnoses and reports errors, but then executes subsequent instructions. COE tries to automatically return control back to the application after reporting each memory safety error. There are situations when it can't, such as when there's a memory access violation (AV) or a failed memory allocation. COE doesn't continue after access violations that the program's structured exception handling doesn't catch. If COE can't return execution to the app, a `CONTINUE CANCELLED - Deadly Signal. Shutting down.` message is output. @@ -339,7 +339,7 @@ int main() In `main()` a large number is passed to `foo_redundant`, which is ultimately passed to `_alloca()`, which causes `_alloca()` to fail. -This example outputs `pass` when compiled without ASAN (that is, no `-fsanitize=address` switch) but outputs `fail` when compiled with ASAN turned on (that is, with the `-fsanitize=address` switch). That's because without ASAN, the exception code matches `RET_STACK_EXCEPTION` so `cnt` is set to 1. It behaves differently when compiled with ASAN on because the thrown exception is an Address Sanitizer error instead: dynamic-stack-buffer-overflow. That means the code returns `RET_OTHER_EXCEPTION` instead of `RET_STACK_EXCEPTION` so `cnt` isn't set to 1. +This example outputs `pass` when compiled without ASAN (that is, no `-fsanitize=address` switch) but outputs `fail` when compiled with ASAN turned on (that is, with the `-fsanitize=address` switch). That's because without ASAN, the exception code matches `RET_STACK_EXCEPTION` so `cnt` is set to 1. It behaves differently when compiled with ASAN on because the thrown exception is an AddressSanitizer error instead: dynamic-stack-buffer-overflow. That means the code returns `RET_OTHER_EXCEPTION` instead of `RET_STACK_EXCEPTION` so `cnt` isn't set to 1. ## Other benefits diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md index 63633fa5e46..5b526a8cf1b 100644 --- a/docs/sanitizers/asan-flags.md +++ b/docs/sanitizers/asan-flags.md @@ -1,6 +1,6 @@ --- title: "AddressSanitizer Runtime Options" -description: "List of runtime options for the Microsoft C/C++ Address Sanitizer" +description: "List of runtime options for the Microsoft C/C++ AddressSanitizer" ms.date: 8/08/2025 helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Address sanitizer options", "Address sanitizer flags", "asan options", "asan flags", "sanitizer flags", "asan_options", "AddressSanitizerFlags", "SanitizerCommonFlags"] --- diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index b5d899dabc0..273389bad95 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -77,7 +77,7 @@ The *`clang_rt.asan*.dll`* runtime files are installed next to the compilers in ## Custom property sheet support -The Visual Studio Property Manager window allows you to add custom *`.props`* files to your projects. Even though the **Enable Address Sanitizer** property (``) is shown, the build doesn't honor it. The build doesn't honor it because the custom *`.props`* files are included after *`Microsoft.cpp.props`*, which uses the `` value to set other properties. +The Visual Studio Property Manager window allows you to add custom *`.props`* files to your projects. Even though the **Enable AddressSanitizer** property (``) is shown, the build doesn't honor it. The build doesn't honor it because the custom *`.props`* files are included after *`Microsoft.cpp.props`*, which uses the `` value to set other properties. As a workaround, create a *`Directory.Build.props`* file in the root of your project to define the `` property. For more information, see [Customize C++ builds](/visualstudio/msbuild/customize-your-build#customize-c-builds). diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 0f109ebfa68..4ac0c904d8c 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -40,7 +40,7 @@ Even when statically linking, the ASan runtime DLL must be present at runtime--u Before Visual Studio 17.7 Preview 3, statically linked (**`/MT`** or **`/MTd`**) builds didn't use a DLL dependency. Instead, the AddressSanitizer runtime was statically linked into the user's EXE. DLL projects would then load exports from the user's EXE to access ASan functionality. -Dynamically linked projects (**`/MD`** or **`/MDd`**) used different libraries and DLLs depending on whether the project was configured for debug or release. For more information about these changes and their motivations, see [MSVC Address Sanitizer – One DLL for all Runtime Configurations](https://devblogs.microsoft.com/cppblog/msvc-address-sanitizer-one-dll-for-all-runtime-configurations/). +Dynamically linked projects (**`/MD`** or **`/MDd`**) used different libraries and DLLs depending on whether the project was configured for debug or release. For more information about these changes and their motivations, see [MSVC AddressSanitizer – One DLL for all Runtime Configurations](https://devblogs.microsoft.com/cppblog/msvc-address-sanitizer-one-dll-for-all-runtime-configurations/). The following table describes the previous behavior of the AddressSanitizer runtime library linking, before Visual Studio 17.7 Preview 3: @@ -101,7 +101,7 @@ For an illustration of the alignment requirement and potential issues, see the p ## Runtime options -The MSVC AddressSanitizer is a regularly synced fork of the [Clang AddressSanitizer runtime](https://github.com/llvm/llvm-project). As a result, MSVC implicitly inherits many of Clang's ASan runtime options. A complete list of options that we actively maintain and test can be found [here](./asan-flags.md). If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). +MSVC AddressSanitizer is a regularly synced fork of the [Clang AddressSanitizer runtime](https://github.com/llvm/llvm-project). As a result, MSVC implicitly inherits many of Clang's ASan runtime options. A complete list of options that we actively maintain and test can be found [here](./asan-flags.md). If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). ### Configure runtime options diff --git a/docs/sanitizers/asan.md b/docs/sanitizers/asan.md index bd9fc7c88c5..80f2a55b825 100644 --- a/docs/sanitizers/asan.md +++ b/docs/sanitizers/asan.md @@ -157,7 +157,7 @@ To enable AddressSanitizer for a [CMake project created to target Windows](../bu 1. Choose the **Edit JSON** link in the editor. This selection switches the view to raw JSON. -1. Add the following snippet to the `"windows-base"` preset, inside `"configurePresets":` to turn on Address Sanitizer: +1. Add the following snippet to the `"windows-base"` preset, inside `"configurePresets":` to turn on AddressSanitizer: ```json "environment": { @@ -192,7 +192,7 @@ To enable AddressSanitizer for a [CMake project created to target Windows](../bu }, ``` -1. Address sanitizer doesn't work if edit-and-continue is specified (`/ZI`), which is enabled by default for new CMake projects. In `CMakeLists.txt`, comment out (prefix with `#`) the line that starts with `set(CMAKE_MSVC_DEBUG_INFORMATION_FORMAT"`. That line looks something like this, afterwards: +1. AddressSanitizer doesn't work if edit-and-continue is specified (`/ZI`), which is enabled by default for new CMake projects. In `CMakeLists.txt`, comment out (prefix with `#`) the line that starts with `set(CMAKE_MSVC_DEBUG_INFORMATION_FORMAT"`. That line looks something like this, afterwards: ```json # set(CMAKE_MSVC_DEBUG_INFORMATION_FORMAT "$,$>,$<$:EditAndContinue>,$<$:ProgramDatabase>>") diff --git a/docs/sanitizers/error-stack-use-after-return.md b/docs/sanitizers/error-stack-use-after-return.md index f3ee909411e..6ddd807d4a8 100644 --- a/docs/sanitizers/error-stack-use-after-return.md +++ b/docs/sanitizers/error-stack-use-after-return.md @@ -1,13 +1,13 @@ --- title: "Error: stack-use-after-return" -description: "Learn about the stack-use-after-return Address Sanitizer error." +description: "Learn about the stack-use-after-return AddressSanitizer error." ms.date: 03/02/2021 f1_keywords: ["stack-use-after-return"] helpviewer_keywords: ["stack-use-after-return error", "AddressSanitizer error stack-use-after-return"] --- # Error: `stack-use-after-return` -> Address Sanitizer Error: Use of stack memory after return +> AddressSanitizer Error: Use of stack memory after return ## Remarks diff --git a/docs/security/security-best-practices-for-cpp.md b/docs/security/security-best-practices-for-cpp.md index 6cc6c47315c..83ffc267e8e 100644 --- a/docs/security/security-best-practices-for-cpp.md +++ b/docs/security/security-best-practices-for-cpp.md @@ -10,7 +10,7 @@ ms.topic: best-practice This article contains information about security tools and practices. Using them does not make applications immune from attack, but it makes successful attacks less likely. -## Visual C++ Security Features +## Microsoft C++ Security Features These security features are built into the Microsoft C++ compiler and linker: diff --git a/docs/windows/clickonce-deployment-for-visual-cpp-applications.md b/docs/windows/clickonce-deployment-for-visual-cpp-applications.md index 07698cb3de3..1824562d2ab 100644 --- a/docs/windows/clickonce-deployment-for-visual-cpp-applications.md +++ b/docs/windows/clickonce-deployment-for-visual-cpp-applications.md @@ -1,19 +1,19 @@ --- -description: "Learn more about: ClickOnce Deployment for Visual C++ Applications" -title: "ClickOnce Deployment for Visual C++ Applications" +description: "Learn more about: ClickOnce Deployment for Microsoft C++ Applications" +title: "ClickOnce Deployment for Microsoft C++ Applications" ms.date: "11/04/2016" helpviewer_keywords: ["deploying applications [C++], ClickOnce", "application deployment [C++], ClickOnce", "ClickOnce deployment [C++], C++ applications"] --- -# ClickOnce Deployment for Visual C++ Applications +# ClickOnce Deployment for Microsoft C++ Applications Visual Studio provides two different technologies for deploying Windows applications: ClickOnce deployment or [Windows Installer](/windows/win32/Msi/windows-installer-portal) deployment. ## ClickOnce Deployment in C++ > [!NOTE] -> ClickOnce does not support deployment of native C++ applications. However, you can use ClickOnce to deploy a Visual C++ application if it is a dependency of a Visual C# or VB.NET project. For example, if you have a Visual C# project that depends on a Visual C++ project, you can publish the application (including its dependencies) using ClickOnce deployment from the Visual C# development environment. If you have a Visual Basic .NET project that depends on a Visual C++ project, you can publish the application (including its dependencies) using ClickOnce deployment from the Visual Basic .NET development environment. +> ClickOnce does not support deployment of native C++ applications. However, you can use ClickOnce to deploy a Microsoft C++ application if it is a dependency of a C# or VB.NET project. For example, if you have a C# project that depends on a C++ project, you can publish the application (including its dependencies) using ClickOnce deployment from the C# development environment. If you have a Visual Basic .NET project that depends on a C++ project, you can publish the application (including its dependencies) using ClickOnce deployment from the Visual Basic .NET development environment. -To deploy a Visual C++ application using ClickOnce, you first have to build a [ClickOnce Application Manifest](/visualstudio/deployment/clickonce-application-manifest) and a [ClickOnce Deployment Manifest](/visualstudio/deployment/clickonce-deployment-manifest) using the [Mage.exe (Manifest Generation and Editing Tool)](/dotnet/framework/tools/mage-exe-manifest-generation-and-editing-tool) or its graphical user interface version (for information, see [MageUI.exe (Manifest Generation and Editing Tool, Graphical Client)](/dotnet/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client)). +To deploy a C++ application using ClickOnce, you first have to build a [ClickOnce Application Manifest](/visualstudio/deployment/clickonce-application-manifest) and a [ClickOnce Deployment Manifest](/visualstudio/deployment/clickonce-deployment-manifest) using the [Mage.exe (Manifest Generation and Editing Tool)](/dotnet/framework/tools/mage-exe-manifest-generation-and-editing-tool) or its graphical user interface version (for information, see [MageUI.exe (Manifest Generation and Editing Tool, Graphical Client)](/dotnet/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client)). You first use Mage.exe to build the application manifest; the resulting file will have the extension .manifest. You then use Mage.exe to build the deployment manifest; the resulting file will have the extension `.application`. You then sign the manifests. @@ -21,7 +21,7 @@ The application manifest must specify the target processor (**x86**, **x64**, or Also, the name of the application and deployment manifests must be different from the name of the C++ application. This avoids conflict between the application manifest created by Mage.exe and the external manifest that is part of the C++ application. -Your deployment needs to install any Visual C++ libraries on which your application depends. To determine the dependencies for a particular application, you can use depends.exe or the `DUMPBIN` utility with the `/DEPENDENTS` option. For more information on dependencies, see [Understanding the Dependencies of a Visual C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md). You might need to run VCRedist.exe; this utility installs Visual C++ libraries on the target computer. +Your deployment needs to install any C++ libraries on which your application depends. To determine the dependencies for a particular application, you can use depends.exe or the `DUMPBIN` utility with the `/DEPENDENTS` option. For more information on dependencies, see [Understanding the Dependencies of a Microsoft C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md). You might need to run VCRedist.exe; this utility installs C++ libraries on the target computer. You may also need to build a bootstrapper (prerequisites installer) for your application to deploy prerequisite components; for information on the bootstrapper, see [Creating Bootstrapper Packages](/visualstudio/deployment/creating-bootstrapper-packages). diff --git a/docs/windows/deploying-native-desktop-applications-visual-cpp.md b/docs/windows/deploying-native-desktop-applications-visual-cpp.md index 883406e495d..f36fc557a67 100644 --- a/docs/windows/deploying-native-desktop-applications-visual-cpp.md +++ b/docs/windows/deploying-native-desktop-applications-visual-cpp.md @@ -1,31 +1,31 @@ --- -description: "Learn more about: Deploying Native Desktop Applications (Visual C++)" -title: "Deploying Native Desktop Applications (Visual C++)" +description: "Learn more about: Deploying Native Desktop Applications (Microsoft C++)" +title: "Deploying Native Desktop Applications (Microsoft C++)" ms.date: "05/11/2018" helpviewer_keywords: ["deploying applications [C++]", "application deployment [C++]", "Visual C++, application deployment", "application deployment [C++], about application deployment", "deploying applications [C++], about deploying applications", "distributing applications [C++]"] ms.assetid: 37f1691e-d67c-41e4-926e-528a237a9bac ms.topic: "overview" ms.custom: intro-deployment --- -# Deploying Native Desktop Applications (Visual C++) +# Deploying Native Desktop Applications (Microsoft C++) Deployment is the process by which you distribute a finished application or component to be installed on other computers. Deployment planning starts when an application is created on a developer's computer. Deployment ends when the application is installed and ready to run on a user's computer. Visual Studio provides different technologies for deploying Windows applications. These include ClickOnce deployment and Windows Installer deployment. -- ClickOnce can be used to deploy C++ applications that target the common language runtime (CLR)—mixed, pure, and verifiable assemblies. Although you can use Windows Installer to deploy a managed application, we recommend that you use ClickOnce because it takes advantage of .NET Framework security features such as manifest signing. ClickOnce does not support deployment of native C++ applications. For more information, see [ClickOnce Deployment for Visual C++ Applications](clickonce-deployment-for-visual-cpp-applications.md). +- ClickOnce can be used to deploy C++ applications that target the common language runtime (CLR)—mixed, pure, and verifiable assemblies. Although you can use Windows Installer to deploy a managed application, we recommend that you use ClickOnce because it takes advantage of .NET Framework security features such as manifest signing. ClickOnce does not support deployment of native C++ applications. For more information, see [ClickOnce Deployment for Microsoft C++ Applications](clickonce-deployment-for-visual-cpp-applications.md). - Windows Installer technology can be used to deploy either native C++ applications or C++ applications that target the CLR. -The articles in this section of the documentation discuss how to ensure that a native Visual C++ application runs on any computer that provides a supported target platform, which files you must include in an installation package, and the recommended ways to redistribute the components that your application depends on. +The articles in this section of the documentation discuss how to ensure that a native Microsoft C++ application runs on any computer that provides a supported target platform, which files you must include in an installation package, and the recommended ways to redistribute the components that your application depends on. ## In This Section -- [Deployment in Visual C++](deployment-in-visual-cpp.md) +- [Deployment in Microsoft C++](deployment-in-visual-cpp.md) - [Deployment Concepts](deployment-concepts.md) -- [Understanding the Dependencies of a Visual C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md) +- [Understanding the Dependencies of a Microsoft C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md) - [Determining Which DLLs to Redistribute](determining-which-dlls-to-redistribute.md) @@ -33,13 +33,13 @@ The articles in this section of the documentation discuss how to ensure that a n - [Universal CRT deployment](universal-crt-deployment.md). -- [Redistributing Visual C++ Files](redistributing-visual-cpp-files.md) +- [Redistributing Microsoft C++ Files](redistributing-visual-cpp-files.md) - [Deployment Examples](deployment-examples.md) - [Redistributing Web Client Applications](redistributing-web-client-applications.md) -- [ClickOnce Deployment for Visual C++ Applications](clickonce-deployment-for-visual-cpp-applications.md) +- [ClickOnce Deployment for Microsoft C++ Applications](clickonce-deployment-for-visual-cpp-applications.md) - [Running a C++ /clr Application on a Previous Runtime Version](running-a-cpp-clr-application-on-a-previous-runtime-version.md) diff --git a/docs/windows/deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md b/docs/windows/deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md index 3ce20bfe3fb..2489c12d56f 100644 --- a/docs/windows/deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md +++ b/docs/windows/deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md @@ -1,6 +1,6 @@ --- -title: "Deploy a Visual C++ App by Using the Redistributable" -description: "Learn how to deploy a Visual C++ application by using the Visual C++ Redistributable package." +title: "Deploy a Microsoft C++ App by Using the Redistributable" +description: "Learn how to deploy a Microsoft C++ application by using the Visual C++ Redistributable package." ms.date: 03/20/2025 ms.topic: tutorial helpviewer_keywords: ["walkthrough, deploying a Visual C++ application by using the redistributable package"] diff --git a/docs/windows/deployment-concepts.md b/docs/windows/deployment-concepts.md index 762b7034ca3..7d74341b303 100644 --- a/docs/windows/deployment-concepts.md +++ b/docs/windows/deployment-concepts.md @@ -19,11 +19,11 @@ You package your application by adding a Setup project to your solution; when bu ## Library Dependencies -When a C/C++ application is built using functionality provided by the Visual C++ libraries, it becomes dependent on the presence of those libraries at runtime. In order for the application to run, it must link, either statically or dynamically, to the necessary Visual C++ libraries. If an application dynamically links to a Visual C++ library, then when it runs that library must be present so it can be loaded. On the other hand, if the application statically links to a Visual C++ library, then it does not need the corresponding DLLs to be present on the user's computer. Static linking, however, has some negative effects, such as the increasing the size of the application files, and making maintenance potentially more difficult. For more information, see [Advantages of using DLLs](../build/dlls-in-visual-cpp.md#advantages-of-using-dlls). +When a C/C++ application is built using functionality provided by the Microsoft C++ libraries, it becomes dependent on the presence of those libraries at runtime. In order for the application to run, it must link, either statically or dynamically, to the necessary Microsoft C++ libraries. If an application dynamically links to a Microsoft C++ library, then when it runs that library must be present so it can be loaded. On the other hand, if the application statically links to a Microsoft C++ library, then it does not need the corresponding DLLs to be present on the user's computer. Static linking, however, has some negative effects, such as the increasing the size of the application files, and making maintenance potentially more difficult. For more information, see [Advantages of using DLLs](../build/dlls-in-visual-cpp.md#advantages-of-using-dlls). ## Packaging and Redistributing -Visual C++ libraries are packaged as DLLs, and all necessary libraries for C/C++ applications are installed by Visual Studio on the developer's computer. However, when deploying your application to your users, it is not feasible in most cases to require them to install Visual Studio in order to run your application. It is important to be able to redistribute just the parts of Visual C++ that are required by your application to run correctly. +Microsoft C++ libraries are packaged as DLLs, and all necessary libraries for C/C++ applications are installed by Visual Studio on the developer's computer. However, when deploying your application to your users, it is not feasible in most cases to require them to install Visual Studio in order to run your application. It is important to be able to redistribute just the parts of Microsoft C++ that are required by your application to run correctly. For more information about packaging and redistributing, see the following topics: @@ -42,4 +42,4 @@ For deployment examples and suggestions about troubleshooting, see: ## See also - [Deploying Desktop Applications](deploying-native-desktop-applications-visual-cpp.md) -- [Understanding the Dependencies of a Visual C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md) +- [Understanding the Dependencies of a Microsoft C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md) diff --git a/docs/windows/deployment-in-visual-cpp.md b/docs/windows/deployment-in-visual-cpp.md index a343c802a5b..5c39eaabb60 100644 --- a/docs/windows/deployment-in-visual-cpp.md +++ b/docs/windows/deployment-in-visual-cpp.md @@ -1,14 +1,14 @@ --- -description: "Learn more about: Deployment in Visual C++" -title: "Deployment in Visual C++" +description: "Learn more about: Deployment in Microsoft C++" +title: "Deployment in Microsoft C++" ms.date: 06/28/2022 helpviewer_keywords: ["deploying applications [C++]", "application deployment [C++]"] ms.assetid: d4b4ffc0-d2bd-4e4a-84a6-62f1c26f6a09 ms.custom: intro-deployment --- -# Deployment in Visual C++ +# Deployment in Microsoft C++ -Installation of your application on a computer other than your development computer is known as *deployment*. When you deploy a Visual C++ application to another computer, you must install both the application and any library files it depends on. Visual Studio enables three ways to deploy the Visual C++ libraries together with your application: *central deployment*, *local deployment*, and *static linking*. Central deployment puts the library files under the Windows directory, where all applications can access them automatically. Local deployment puts the library files in the same directory as your application. You must redeploy any locally deployed libraries yourself to update them. Static linking binds the library code into your application. You have to recompile and redeploy your application to take advantage of any updates to the libraries when you use static linking. +Installation of your application on a computer other than your development computer is known as *deployment*. When you deploy a Microsoft C++ application to another computer, you must install both the application and any library files it depends on. Visual Studio enables three ways to deploy the Microsoft C++ libraries together with your application: *central deployment*, *local deployment*, and *static linking*. Central deployment puts the library files under the Windows directory, where all applications can access them automatically. Local deployment puts the library files in the same directory as your application. You must redeploy any locally deployed libraries yourself to update them. Static linking binds the library code into your application. You have to recompile and redeploy your application to take advantage of any updates to the libraries when you use static linking. In Visual Studio 2015, the Microsoft C Runtime library was refactored into version-specific local library components, and a new Universal C Runtime library that is now part of Windows. For details on deployment of the Universal CRT, see [Universal CRT deployment](universal-crt-deployment.md). @@ -16,15 +16,15 @@ In Visual Studio 2015, the Microsoft C Runtime library was refactored into versi In central deployment, library DLL files are installed in the *`Windows\System32`* directory, or for 32-bit library files on x64 systems, the *`Windows\SysWow64`* directory. Centrally deployed library files are available to other applications. -To centrally deploy Visual C++ libraries, you can use one of these two sources for the files to install: +To centrally deploy Microsoft C++ libraries, you can use one of these two sources for the files to install: - *Redistributable package* files. These files are stand-alone command-line executables that contain all the Visual C++ Redistributable libraries in compressed form. The latest Redistributable packages are available from [Microsoft Visual C++ Redistributable Latest Supported Downloads](latest-supported-vc-redist.md). When you use the Redistributable packages for central deployment, Windows Update can service the libraries independently. - *Redistributable merge modules* (*`.msm`* files), which you can include in your application's Windows Installer (*`.msi`*) file. This method is deprecated because libraries deployed this way can't be updated automatically by Windows Update. For more information, see [Redistributing by using merge modules](redistributing-components-by-using-merge-modules.md). -A Redistributable package file installs all of the Visual C++ libraries for a particular system architecture. For example, if your application is built for x64, you can use the *`vcredist_x64.exe`* package to install all the Visual C++ libraries your application uses. You can program your application installer to run the package as a prerequisite before you install your application. +A Redistributable package file installs all of the Microsoft C++ libraries for a particular system architecture. For example, if your application is built for x64, you can use the *`vcredist_x64.exe`* package to install all the Microsoft C++ libraries your application uses. You can program your application installer to run the package as a prerequisite before you install your application. -Central deployment by using a Redistributable package enables Windows Update to automatically update the Visual C++ libraries. For continued security and functionality, we recommend that you use the library DLLs in your application instead of static libraries, and use Redistributable packages and central deployment instead of local deployment. +Central deployment by using a Redistributable package enables Windows Update to automatically update the Microsoft C++ libraries. For continued security and functionality, we recommend that you use the library DLLs in your application instead of static libraries, and use Redistributable packages and central deployment instead of local deployment. ## Local deployment @@ -32,15 +32,15 @@ In local deployment, library files are installed in your application folder toge Expansions to a library may be spread across multiple extra DLLs, known as *dot libraries*. For example, some functionality in the standard library released in Visual Studio 2017 version 15.6 was added into *`msvcp140_1.dll`*, to preserve the ABI compatibility of *`msvcp140.dll`*. If you use Visual Studio 2017 version 15.6 (toolset 14.13) or later, you may need to locally deploy both these dot libraries and the main library. These separate dot libraries will eventually be added to the base library, when the ABI changes. -Because Microsoft can't automatically update locally deployed Visual C++ libraries, we don't recommend local deployment of these libraries. If you decide to use local deployment of the Redistributable libraries, we recommend that you implement your own method of automatically updating the locally deployed libraries. +Because Microsoft can't automatically update locally deployed Microsoft C++ libraries, we don't recommend local deployment of these libraries. If you decide to use local deployment of the Redistributable libraries, we recommend that you implement your own method of automatically updating the locally deployed libraries. ## Static linking -In addition to dynamically linked libraries, Visual Studio supplies most of its libraries as static libraries. You can statically link a static library to your application, that is, link the library object code directly into the application. Static linking creates a single binary without a DLL dependency, so that you don't have to deploy the Visual C++ library files separately. However, we don't recommend this approach because statically linked libraries can't be updated in place. To update a linked library when you use static linking, you have to recompile and redeploy your application. +In addition to dynamically linked libraries, Visual Studio supplies most of its libraries as static libraries. You can statically link a static library to your application, that is, link the library object code directly into the application. Static linking creates a single binary without a DLL dependency, so that you don't have to deploy the Microsoft C++ library files separately. However, we don't recommend this approach because statically linked libraries can't be updated in place. To update a linked library when you use static linking, you have to recompile and redeploy your application. ## Troubleshooting deployment issues -The load order of Visual C++ libraries is system-dependent. To diagnose loader issues, use *`depends.exe`* or *`where.exe`*. For more information, see [Dynamic-link library search order (Windows)](/windows/win32/Dlls/dynamic-link-library-search-order). +The load order of Microsoft C++ libraries is system-dependent. To diagnose loader issues, use *`depends.exe`* or *`where.exe`*. For more information, see [Dynamic-link library search order (Windows)](/windows/win32/Dlls/dynamic-link-library-search-order). ## See also diff --git a/docs/windows/toc.yml b/docs/windows/toc.yml index a8a74ff2d76..6b6e16a2dae 100644 --- a/docs/windows/toc.yml +++ b/docs/windows/toc.yml @@ -120,11 +120,11 @@ items: items: - name: Deploy native desktop applications href: ../windows/deploying-native-desktop-applications-visual-cpp.md - - name: Deployment in Visual C++ + - name: Deployment in Microsoft C++ href: ../windows/deployment-in-visual-cpp.md - name: Deployment Concepts href: ../windows/deployment-concepts.md - - name: Understand the dependencies of a Visual C++ application + - name: Understand the dependencies of a Microsoft C++ application href: ../windows/understanding-the-dependencies-of-a-visual-cpp-application.md - name: Determine which DLLs to redistribute href: ../windows/determining-which-dlls-to-redistribute.md @@ -132,7 +132,7 @@ items: href: ../windows/choosing-a-deployment-method.md - name: Universal CRT deployment href: ../windows/universal-crt-deployment.md - - name: Redistribute Visual C++ Files + - name: Redistribute Microsoft C++ Files expanded: false items: - name: Redistribute Visual C++ Files @@ -154,17 +154,17 @@ items: items: - name: Deployment examples href: ../windows/deployment-examples.md - - name: "Walkthrough: Deploy a Visual C++ application by using a setup project" + - name: "Walkthrough: Deploy a Microsoft C++ application by using a setup project" href: ../windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md - - name: "Walkthrough: Deploy a Visual C++ application to an application-local folder" + - name: "Walkthrough: Deploy a Microsoft C++ application to an application-local folder" href: ../windows/walkthrough-deploying-a-visual-cpp-application-to-an-application-local-folder.md - - name: "Walkthrough: Deploy a Visual C++ application by using the Visual C++ Redistributable package" + - name: "Walkthrough: Deploy a Microsoft C++ application by using the Visual C++ Redistributable package" href: ../windows/deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package.md - name: Prepare a test machine to run a debug executable href: ../windows/preparing-a-test-machine-to-run-a-debug-executable.md - name: Redistribute web client applications href: ../windows/redistributing-web-client-applications.md - - name: ClickOnce deployment for Visual C++ applications + - name: ClickOnce deployment for Microsoft C++ applications href: ../windows/clickonce-deployment-for-visual-cpp-applications.md - name: Run a C++ -clr application on a previous runtime version href: ../windows/running-a-cpp-clr-application-on-a-previous-runtime-version.md diff --git a/docs/windows/understanding-the-dependencies-of-a-visual-cpp-application.md b/docs/windows/understanding-the-dependencies-of-a-visual-cpp-application.md index 935808c0d43..8217b0db85b 100644 --- a/docs/windows/understanding-the-dependencies-of-a-visual-cpp-application.md +++ b/docs/windows/understanding-the-dependencies-of-a-visual-cpp-application.md @@ -1,14 +1,14 @@ --- -description: "Learn more about: Understanding the Dependencies of a Visual C++ Application" -title: "Understanding the Dependencies of a Visual C++ Application" +description: "Learn more about: Understanding the Dependencies of a Microsoft C++ Application" +title: "Understanding the Dependencies of a Microsoft C++ Application" ms.date: "11/04/2016" helpviewer_keywords: ["application deployment [C++], dependencies", "Dependency Walker", "dependencies [C++], application deployment and", "deploying applications [C++], dependencies", "DUMPBIN utility", "DLLs [C++], dependencies", "depends.exe", "libraries [C++], application deployment issues"] ms.assetid: 62a44c95-c389-4c5f-82fd-07d7ef09dbf9 ms.topic: concept-article --- -# Understanding the Dependencies of a Visual C++ Application +# Understanding the Dependencies of a Microsoft C++ Application -To determine which Visual C++ libraries an application depends on, you can view the project properties. (In Solution Explorer, right-click on the project and choose **Properties** to open the **Property Pages** dialog box.) On Windows 8 and earlier, you can also use the Dependency Walker (depends.exe), which gives a more comprehensive picture of the dependencies. For more recent versions of Windows the [lucasg/Dependencies](https://github.com/lucasg/Dependencies) tool provides similar functionality (this is a third-party tool not guaranteed by Microsoft.) +To determine which Microsoft C++ libraries an application depends on, you can view the project properties. (In Solution Explorer, right-click on the project and choose **Properties** to open the **Property Pages** dialog box.) On Windows 8 and earlier, you can also use the Dependency Walker (depends.exe), which gives a more comprehensive picture of the dependencies. For more recent versions of Windows the [lucasg/Dependencies](https://github.com/lucasg/Dependencies) tool provides similar functionality (this is a third-party tool not guaranteed by Microsoft.) In the **Property Pages** dialog box, you can examine various pages under **Configuration Properties** to understand the dependencies. For example, if your project uses the MFC libraries and you choose **Use of MFC**, **Use MFC in a Shared DLL** on the **Configuration Properties**, **General** page, your application at run time depends on MFC DLLs such as mfc\.dll. If your application doesn't use MFC, it might depend on the CRT library if you choose a **Runtime Library** value of **Multi-threaded Debug DLL (/MDd)** or **Multi-threaded DLL (/MD)** on the **Configuration Properties**, **C/C++**, **Code Generation** page. @@ -16,7 +16,7 @@ By using depends.exe, you can examine a list of DLLs that are linked to the appl When you use depends.exe, be aware that a DLL might have a dependency on another DLL or on a specific version of a DLL. You can use depends.exe on either the development computer or on a target computer. On the development computer, depends.exe reports the DLLs that are required to support an application. If you have trouble getting an application to run on a target computer, you can copy depends.exe to it and then open the application in the tool so that you can determine whether any required DLLs are missing or incorrect. -When you know which DLLs your application depends on, you can determine the ones that you have to redistribute with your application when you deploy it to another computer. In most cases, you don't have to redistribute system DLLs, but you may have to redistribute DLLs for Visual C++ libraries. For more information, see [Determining Which DLLs to Redistribute](determining-which-dlls-to-redistribute.md). +When you know which DLLs your application depends on, you can determine the ones that you have to redistribute with your application when you deploy it to another computer. In most cases, you don't have to redistribute system DLLs, but you may have to redistribute DLLs for Microsoft C++ libraries. For more information, see [Determining Which DLLs to Redistribute](determining-which-dlls-to-redistribute.md). ## See also diff --git a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md index 5b2af3d9365..93ddba07afd 100644 --- a/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md +++ b/docs/windows/walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: Walkthrough: Deploy a Visual C++ application by using a setup project" -title: "Deploy a Visual C++ application by using a setup project" +description: "Learn more about: Walkthrough: Deploy a Microsoft C++ application by using a setup project" +title: "Deploy a Microsoft C++ application by using a setup project" ms.date: 06/28/2022 -helpviewer_keywords: ["deployment for Visual C++"] +helpviewer_keywords: ["deployment for Microsoft C++"] ms.custom: intro-deployment ms.topic: install-set-up-deploy --- -# Walkthrough: Deploy a Visual C++ application by using a setup project +# Walkthrough: Deploy a Microsoft C++ application by using a setup project In this walkthrough, you'll create a sample app in Visual Studio, then create a setup project to deploy your app to another computer. @@ -22,7 +22,7 @@ You need the following components to complete this walkthrough: - The Microsoft Visual Studio Installer Projects extension. The extension is free for Visual Studio developers and adds the functionality of the setup and deployment project templates to Visual Studio. -- To test your deployment, another computer that doesn't have the Visual C++ libraries installed. +- To test your deployment, another computer that doesn't have the Microsoft C++ libraries installed. ### To install C++ and MFC in Visual Studio 2022 @@ -62,7 +62,7 @@ If you have Visual Studio installed, but you don't have the C++ or MFC component - The Microsoft Visual Studio Installer Projects extension. The extension is free for Visual Studio developers and adds the functionality of the setup and deployment project templates to Visual Studio. -- To test your deployment, another computer that doesn't have the Visual C++ libraries installed. +- To test your deployment, another computer that doesn't have the Microsoft C++ libraries installed. ### To install C++ and MFC in Visual Studio 2019 @@ -330,7 +330,7 @@ The setup project lets you specify where the components of your app are installe ## Test your deployment -To test your deployment, copy the deployment files to a second computer that doesn't have the Visual C++ libraries installed. Run the setup program. If your app loads and runs normally, and you don't get a runtime error about missing libraries or components, then your deployment is successful. +To test your deployment, copy the deployment files to a second computer that doesn't have the Microsoft C++ libraries installed. Run the setup program. If your app loads and runs normally, and you don't get a runtime error about missing libraries or components, then your deployment is successful. For application testing, you can create a deployment setup program that installs a debug version of your app, along with debug libraries, on machines you control. Debug apps and debug libraries aren't licensed for redistribution, and can't be deployed to customer machines. For more information, see [Preparing a test machine to run a debug executable](../windows/preparing-a-test-machine-to-run-a-debug-executable.md). diff --git a/docs/windows/walkthrough-deploying-a-visual-cpp-application-to-an-application-local-folder.md b/docs/windows/walkthrough-deploying-a-visual-cpp-application-to-an-application-local-folder.md index 3a419091272..c87fa954be4 100644 --- a/docs/windows/walkthrough-deploying-a-visual-cpp-application-to-an-application-local-folder.md +++ b/docs/windows/walkthrough-deploying-a-visual-cpp-application-to-an-application-local-folder.md @@ -1,35 +1,35 @@ --- -description: "Learn more about: Walkthrough: Deploying a Visual C++ Application to an Application-local Folder" -title: "Deploy a Visual C++ Application to an App-local Folder" +description: "Learn more about: Walkthrough: Deploying a Microsoft C++ Application to an Application-local Folder" +title: "Deploy a Microsoft C++ Application to an App-local Folder" ms.date: "04/23/2019" -helpviewer_keywords: ["deploying Visual C++ applications"] +helpviewer_keywords: ["deploying Microsoft C++ applications"] ms.assetid: 47a81c47-9dbe-47c6-96cc-fbb2fda5e6ad ms.custom: intro-deployment ms.topic: install-set-up-deploy --- -# Walkthrough: Deploying a Visual C++ Application to an Application-local Folder +# Walkthrough: Deploying a Microsoft C++ Application to an Application-local Folder -Describes how to deploy a Visual C++ application by copying files to its folder. +Describes how to deploy a Microsoft C++ application by copying files to its folder. ## Prerequisites - A computer that has Visual Studio installed. -- Another computer that doesn't have the Visual C++ libraries. +- Another computer that doesn't have the Microsoft C++ libraries. ### To deploy an application to an application-local folder -1. Create and build an MFC application by following the steps in [Walkthrough: Deploying a Visual C++ Application By Using a Setup Project](walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md). +1. Create and build an MFC application by following the steps in [Walkthrough: Deploying a Microsoft C++ Application By Using a Setup Project](walkthrough-deploying-a-visual-cpp-application-by-using-a-setup-project.md). 1. Copy the appropriate MFC and C Run-Time (CRT) library files from the Visual Studio installation directory in the \\VC\\redist\\*version* folder, and then paste them in the \Release\ folder of your MFC project. For more information about other files that you might have to copy, see [Determining Which DLLs to Redistribute](determining-which-dlls-to-redistribute.md). -1. Run the MFC application on a second computer that doesn't have the Visual C++ libraries. +1. Run the MFC application on a second computer that doesn't have the Microsoft C++ libraries. 1. Copy the contents of the \Release\ folder and paste them in the application folder on the second computer. 1. Run the application on the second computer. - The application runs successfully because the Visual C++ libraries are available in the application-local folder. + The application runs successfully because the Microsoft C++ libraries are available in the application-local folder. ## See also From 62a673065635f38d1bcdc4bab24b2db8c568f271 Mon Sep 17 00:00:00 2001 From: Augustin Popa Date: Thu, 30 Oct 2025 00:01:52 -0700 Subject: [PATCH 1400/1799] Initial set of VS 2026 changes to /porting --- docs/porting/binary-compat-2015-2017.md | 20 ++++---- .../features-deprecated-in-visual-studio.md | 46 ++++++++++++++----- ...-of-potential-upgrade-issues-visual-cpp.md | 24 +++++----- docs/porting/porting-third-party-libraries.md | 13 +++--- ...g-to-the-universal-windows-platform-cpp.md | 2 +- docs/porting/toc.yml | 2 +- .../upgrade-your-code-to-the-universal-crt.md | 22 ++++----- ...cts-from-earlier-versions-of-visual-cpp.md | 2 +- docs/porting/use-native-multi-targeting.md | 16 ++++--- 9 files changed, 87 insertions(+), 60 deletions(-) diff --git a/docs/porting/binary-compat-2015-2017.md b/docs/porting/binary-compat-2015-2017.md index 86ad8957757..21a50e72153 100644 --- a/docs/porting/binary-compat-2015-2017.md +++ b/docs/porting/binary-compat-2015-2017.md @@ -1,31 +1,31 @@ --- -title: "C++ binary compatibility 2015-2022" -description: "Describes how binary compatibility works between compiled C++ files in Visual Studio 2015, 2017, 2019, and 2022. One Microsoft Visual C++ Redistributable package works for all three versions." -ms.date: 03/07/2024 +title: "C++ binary compatibility 2015-2026" +description: "Describes how binary compatibility works between compiled C++ files in Visual Studio 2015, 2017, 2019, 2022, and 2026. One Microsoft Visual C++ Redistributable package works for all these versions." +ms.date: 10/29/2025 helpviewer_keywords: ["binary compatibility, Visual C++"] --- # C++ binary compatibility between Visual Studio versions -The Microsoft C++ (MSVC) compiler toolsets in Visual Studio 2013 and earlier don't guarantee binary compatibility across major versions. You can't link object files, static libraries, dynamic libraries, and executables built by different versions of these toolsets. The ABIs, object formats, and runtime libraries are incompatible. +The Microsoft C++ (MSVC) Build Tools in Visual Studio 2013 and earlier don't guarantee binary compatibility across major versions. You can't link object files, static libraries, dynamic libraries, and executables built by different versions of these toolsets. The ABIs, object formats, and runtime libraries are incompatible. -We've changed this behavior in Visual Studio 2015 and later versions. The runtime libraries and apps compiled by any of these versions of the compiler are binary-compatible. It's reflected in the C++ toolset major number, which starts with 14 for all versions since Visual Studio 2015. (The toolset version is v140 for Visual Studio 2015, v141 for 2017, v142 for 2019, and v143 for 2022). Say you have third-party libraries built by Visual Studio 2015. You can still use them in an application built by Visual Studio 2017, 2019, or 2022. There's no need to recompile with a matching toolset. The latest version of the Microsoft Visual C++ Redistributable package (the Redistributable) works for all of them. +We've changed this behavior in Visual Studio 2015 and later versions. The runtime libraries and apps compiled by any of these versions of the compiler are binary-compatible. It's reflected in the C++ toolset major number, which starts with 14 for all versions since Visual Studio 2015. (The toolset version is v140 for Visual Studio 2015, v141 for 2017, v142 for 2019, and v143 for 2022). Say you have third-party libraries built by Visual Studio 2015. You can still use them in an application built by Visual Studio 2017, 2019, 2022, or 2026. There's no need to recompile with a matching toolset. The latest version of the Microsoft Visual C++ Redistributable package (the Redistributable) works for all of them. ## Restrictions on binary compatibility -There are three important restrictions on binary compatibility between the v140, v141, v142, and v143 toolsets and minor numbered version updates: +There are three important restrictions on binary compatibility between the v140, v141, v142, v143, and v145 toolsets and minor numbered version updates: -- Binaries created with different versions of the v140, v141, v142, and v143 toolsets can be combined. The key rule is that the linker should only work with inputs built by a toolset that is the same version (or earlier) as itself. This applies to apps, import libraries, static libraries, and other files as described in [LINK input files](../build/reference/link-input-files.md). In some cases, an import library for an [implicitly linked](../build/linking-an-executable-to-a-dll.md#implicit-linking) DLL built by a later version of the toolset can be linked using an earlier version of the toolset--especially if the import library strictly uses `extern "C"` for the imports/exports. Here are some examples of what this all means: +- Binaries created with different versions of the v140, v141, v142, v143, and v145 toolsets can be combined. The key rule is that the linker should only work with inputs built by a toolset that is the same version (or earlier) as itself. This applies to apps, import libraries, static libraries, and other files as described in [LINK input files](../build/reference/link-input-files.md). In some cases, an import library for an [implicitly linked](../build/linking-an-executable-to-a-dll.md#implicit-linking) DLL built by a later version of the toolset can be linked using an earlier version of the toolset--especially if the import library strictly uses `extern "C"` for the imports/exports. Here are some examples of what this all means: - An app compiled with a 2017 toolset (v141, versions 15.0 to 15.9) can be linked to a static library compiled with Visual Studio 2022 version 17.8 (v143), but the linking must be done using a version 17.8 or later toolset. - - Apps and libraries built using VS 2015, 2017, 2019, or 2022 can be linked together, but the linking must be done using a version of the toolset that is as recent as, or more recent than, the most recent toolset used to build any of the binaries you pass to the linker. For example, given three binaries built with toolsets from VS 2015 version 14.3, VS 2017 version 15.9, and VS 2019 version 16.11, you can link them using any toolset version that is 16.11 or later. + - Apps and libraries built using VS 2015, 2017, 2019, 2022, and 2026 can be linked together, but the linking must be done using a version of the toolset that is as recent as, or more recent than, the most recent toolset used to build any of the binaries you pass to the linker. For example, given three binaries built with toolsets from VS 2015 version 14.3, VS 2017 version 15.9, and VS 2019 version 16.11, you can link them using any toolset version that is 16.11 or later. - If a DLL is built with a newer toolset, the import library can sometimes be used with older toolsets if all of the exports follow the C language calling convention (`extern "C"`). However, the only officially supported case is consuming a newer windows SDK with an older toolset. - The Redistributable your app uses has a similar binary-compatibility restriction. When you mix binaries built by different supported versions of the toolset, the Redistributable version must be at least as new as the latest toolset used by any app component. - Static libraries or object files compiled using the [`/GL` (Whole program optimization)](../build/reference/gl-whole-program-optimization.md) compiler switch or linked using [`/LTCG` (Link-time code generation)](../build/reference/ltcg-link-time-code-generation.md) *aren't* binary-compatible across versions, including minor version updates. All object files and libraries compiled using **`/GL`** and **`/LTCG`** must use exactly the same toolset for the compile and the final link. For example, code built by using **`/GL`** in the Visual Studio 2019 version 16.7 toolset can't be linked to code built by using **`/GL`** in the Visual Studio 2019 version 16.8 toolset. The compiler emits [Fatal error C1047](../error-messages/compiler-errors-1/fatal-error-c1047.md). ## Upgrade the Microsoft Visual C++ Redistributable from Visual Studio 2015 and later -We've kept the Microsoft Visual C++ Redistributable major version number the same for Visual Studio 2015, 2017, 2019, and 2022. That means only one instance of the Redistributable can be installed at a time. A newer version overwrites any older version that's already installed. For example, one app may install the Redistributable from Visual Studio 2015. Then, another app installs the Redistributable from Visual Studio 2022. The 2022 version overwrites the older version, but because they're binary-compatible, the earlier app still works fine. We make sure the latest version of the Redistributable has all the newest features, security updates, and bug fixes. That's why we always recommend you upgrade to the latest available version. +We've kept the Microsoft Visual C++ Redistributable major version number the same for Visual Studio 2015, 2017, 2019, 2022, and 2026. That means only one instance of the Redistributable can be installed at a time. A newer version overwrites any older version that's already installed. For example, one app may install the Redistributable from Visual Studio 2015. Then, another app installs the Redistributable from Visual Studio 2026. The 2026 version overwrites the older version, but because they're binary-compatible, the earlier app still works fine. We make sure the latest version of the Redistributable has all the newest features, security updates, and bug fixes. That's why we always recommend you upgrade to the latest available version. -Similarly, you can't install an older Redistributable when a newer version is already installed. The installer reports an error if you try. You'll see an error like this if you install the 2017 or 2019 Redistributable on a machine that already has the 2022 version: +Similarly, you can't install an older Redistributable when a newer version is already installed. The installer reports an error if you try. You'll see an error like this if you install the 2019 or 2022 Redistributable on a machine that already has the 2026 version: ```Output 0x80070666 - Another version of this product is already installed. Installation of this version cannot continue. To configure or remove the existing version of this product, use Add/Remove Programs on the Control Panel. diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index 71383dbc034..38a850fda85 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -1,21 +1,43 @@ --- -description: "Learn more about: C++ features deprecated in Visual Studio" -title: "C++ features deprecated in Visual Studio" -ms.date: 04/07/2022 -helpviewer_keywords: ["Features deprecated in Visual Studio"] +description: "Learn more about: C++ features deprecated or removed in Visual Studio" +title: "C++ features deprecated or removed in Visual Studio" +ms.date: 10/29/2025 +helpviewer_keywords: ["Features deprecated or removed in Visual Studio"] --- -# C++ features deprecated in Visual Studio +# C++ features deprecated or removed in Visual Studio This article is a non-exhaustive list of C++ features deprecated in Visual Studio 2019 and 2022. For information on breaking changes and conformance improvements for C++ in the latest version of Visual Studio, see [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md). -## Deprecated in Visual Studio 2019 +## Visual Studio 2019 -- Support for Windows XP development +### Support for Windows XP development - Visual Studio 2019 and later versions don't include current toolset support for creating code for Windows XP. Support for Windows XP development by using the v141_xp toolset that shipped in Visual Studio 2017 is still available as an optional component in the Visual Studio Installer. For information on how to install the v141_xp Windows XP platform toolset, see [Configuring programs for Windows XP](../build/configuring-programs-for-windows-xp.md). +Visual Studio 2019 and later versions don't include current toolset support for creating code for Windows XP. Support for Windows XP development by using the v141_xp toolset that shipped in Visual Studio 2017 is still available as an optional component in the Visual Studio Installer. For information on how to install the v141_xp Windows XP platform toolset, see [Configuring programs for Windows XP](../build/configuring-programs-for-windows-xp.md). -## Deprecated in Visual Studio 2022 +## Visual Studio 2022 -- Support for project upgrade from Visual C++ 6 - - Visual Studio 2022 and later versions don't support upgrades from Visual C++ 6 Workspace (*`.dsw`*) and Project (*`.dsp`*) files. Visual Studio no longer registers the *`.dsw`* and *`.dsp`* file extensions as Visual Studio file types. To upgrade a project with these extensions, first use Visual Studio 2019 to upgrade the project to modern Solution (*`.sln`*) and C++ Project (*`.vcxproj`*) files. Then use the current version of Visual Studio to upgrade the project again. +### Support for project upgrade from Visual C++ 6 + +Visual Studio 2022 and later versions don't support upgrades from Visual C++ 6 Workspace (*`.dsw`*) and Project (*`.dsp`*) files. Visual Studio no longer registers the *`.dsw`* and *`.dsp`* file extensions as Visual Studio file types. To upgrade a project with these extensions, first use Visual Studio 2019 to upgrade the project to modern Solution (*`.sln`*) and C++ Project (*`.vcxproj`*) files. Then use the current version of Visual Studio to upgrade the project again. + +## Visual Studio 2026 + +### Support for C++AMP, ARM32 toolchain, and /DEBUG:FASTLINK + +Visual Studio 2026 and later versions don't support C++AMP, the ARM32 toolchain, and /DEBUG:FASTLINK. If you're utilizing `/DEBUG:FASTLINK`, it's recommended to switch to [`/DEBUG:FULL`](https://learn.microsoft.com/cpp/build/reference/debug-generate-debug-info) for improved debugging support. Developers needing to target ARM32 can continue using the Visual Studio 2022 v143 build tools as detailed in this [Microsoft blog post](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). + +### Deprecation of /await + +Visual Studio 2026 deprecated the `/await` switch, which will be removed in a future release. Developers are encouraged to use Standard C++ coroutines, available by default in C++20 or later. For projects in earlier language modes, consider using `/await:strict` to maintain compatibility until the switch is removed. + +### Support for Windows 7, 8, and 8.1 for Microsoft C++ Build Tools + +In Visual Studio 2026, the Microsoft C++ (MSVC) Build Tools have updated their minimum supported operating systems. With this release, the Build Tools no longer support targeting: + +- Windows 7 / Windows Server 2008 R2 +- Windows 8 / Windows Server 2012 +- Windows 8.1 / Windows Server 2012 R2 + +To build applications using the latest C++ tools, your target platform must be **Windows 10** or **Windows Server 2016** (or later). + +These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. \ No newline at end of file diff --git a/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md b/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md index fbae3e758a8..484ac33a31e 100644 --- a/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md +++ b/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md @@ -1,13 +1,13 @@ --- -description: "Learn more about: Overview of potential upgrade issues (Visual C++)" -title: "Overview of potential upgrade issues (Visual C++)" -ms.date: 10/22/2021 +description: "Learn more about: Overview of potential upgrade issues (Microsoft C++)" +title: "Overview of potential upgrade issues (Microsoft C++)" +ms.date: 10/29/2025 ms.assetid: 2c99a8cb-098f-4a9d-bf2c-b80fd06ace43 ms.topic: upgrade-and-migration-article --- -# Overview of potential upgrade issues (Visual C++) +# Overview of potential upgrade issues (Microsoft C++) -Over the years, the Microsoft C++ compiler has undergone many changes, along with changes in the C++ language itself, the C++ Standard Library, the C runtime (CRT), and other libraries such as MFC and ATL. As a result, when you upgrade an application from an earlier version of Visual Studio you might see compiler and linker errors and warnings in code that previously compiled cleanly. The older the original code base, the greater the potential for such errors. This overview summarizes the most common classes of issues you're likely to see, and provides links to more detailed information. +Over the years, the Microsoft C++ (MSVC) compiler has undergone many changes, along with changes in the C++ language itself, the C++ Standard Library (STL), the C runtime (CRT), and other libraries such as MFC and ATL. As a result, when you upgrade an application from an earlier version of Visual Studio you might see compiler and linker errors and warnings in code that previously compiled cleanly. The older the original code base, the greater the potential for such errors. This overview summarizes the most common classes of issues you're likely to see, and provides links to more detailed information. > [!NOTE] > In the past, we've recommended that upgrades that span several versions of Visual Studio should be performed incrementally one version at a time. We no longer recommend this approach. We've found that it's almost always simpler to upgrade to the most current version of Visual Studio no matter how old the code base. @@ -25,17 +25,17 @@ When you upgrade an app from Visual Studio 2013 or before to a newer version, it The *`.obj`* and *`.lib`* file formats are well defined and rarely change. Sometimes additions are made to these file formats, but these additions generally don't affect the ability of newer toolsets to consume object files and libraries produced by older toolsets. The major exception is if you compile using [`/GL` (Whole Program Optimization)](../build/reference/gl-whole-program-optimization.md). If you compile using `/GL`, you can only link the resulting object file by using the same toolset that was used to produce it. So, if you produce an object file with `/GL` and use a Visual Studio 2017 (v141) compiler, you must link it using the Visual Studio 2017 (v141) linker. It's because the internal data structures within the object files aren't stable across major versions of the toolset. Newer toolsets don't understand the older data formats. -C++ doesn't have a stable application binary interface (ABI). But Visual Studio maintains a stable C++ ABI for all minor versions of a release. Visual Studio 2015 (v140), Visual Studio 2017 (v141), Visual Studio 2019 (v142), and Visual Studio 2022 (v143) toolsets vary only in their minor version. They all have the same major version number, which is 14. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). +C++ doesn't have a stable application binary interface (ABI). But Visual Studio maintains a stable C++ ABI for all minor versions of a release. Visual Studio 2015 (v140), Visual Studio 2017 (v141), Visual Studio 2019 (v142), Visual Studio 2022 (v143), and Visual Studio 2026 (v145) toolsets vary only in their minor version. They all have the same major version number, which is 14. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). If you have an object file that has external symbols with C++ linkage, that object file may not link correctly with object files produced by a different major version of the toolset. There are many possible outcomes: the link might fail entirely (for example, if name decoration changed). The link could succeed, but the app could fail at runtime (for example, if type layouts changed). Or your app might continue to work and nothing will go wrong. Also note, while the C++ ABI isn't stable, the C ABI and the subset of the C++ ABI required for COM are stable. -If you link to an import library, any later version of the Visual Studio redistributable libraries that preserve ABI compatibility may be used at runtime. For example, if you compile and link your app by using the Visual Studio 2015 Update 3 toolset, you can use any later redistributable. That's because the 2015, 2017, 2019, and 2022 libraries have preserved backward binary compatibility. The reverse isn't true: You can't use a redistributable for an earlier version of the toolset than you used to build any component of your code. +If you link to an import library, any later version of the Visual Studio redistributable libraries that preserve ABI compatibility may be used at runtime. For example, if you compile and link your app by using the Visual Studio 2015 Update 3 toolset, you can use any later redistributable. That's because the 2015, 2017, 2019, 2022, and 2026 libraries have preserved backward binary compatibility. The reverse isn't true: You can't use a redistributable for an earlier version of the toolset than you used to build any component of your code. ### Libraries If you `#include` a particular version of the header files, you must link the resulting object file to the same version of the libraries. So, for example, if your source file includes the Visual Studio 2015 Update 3 ``, you must link with the Visual Studio 2015 Update 3 *`vcruntime`* library. Similarly, if your source file includes the Visual Studio 2017 version 15.5 ``, you must link with the Visual Studio 2017 version 15.5 Standard C++ library, *`msvcprt`*. Mixing-and-matching isn't supported. -For the C++ Standard Library, mixing-and-matching has been explicitly disallowed by use of `#pragma detect_mismatch` in the standard headers since Visual Studio 2010. If you try to link incompatible object files, or if you link with the wrong standard library, the link fails. +For the Microsoft C++ Standard Library (STL), mixing-and-matching has been explicitly disallowed by use of `#pragma detect_mismatch` in the standard headers since Visual Studio 2010. If you try to link incompatible object files, or if you link with the wrong standard library, the link fails. Older CRT version mixing-and-matching was never supported, but it often just worked because the API surface didn't change much over time. The Universal CRT broke backwards compatibility so that in the future we can maintain backwards compatibility. We have no plans to introduce new, versioned Universal CRT binaries in the future. Instead, the existing Universal CRT is now updated in-place. @@ -155,7 +155,7 @@ Windows API documentation lists the minimum or maximum supported operating syste ### Windows version -When upgrading a program that uses the Windows API either directly or indirectly, you need to decide the minimum Windows version to support. In most cases, Windows 7 is a good choice. For more information, see [Header file problems](porting-guide-spy-increment.md#header_file_problems). The `WINVER` macro defines the oldest version of Windows that your program is designed to run on. If your MFC program sets `WINVER` to 0x0501 (Windows XP) you'll get a warning because MFC no longer supports XP, even if the compiler toolset itself has an XP mode. Compiler toolset support for Windows XP ended in Visual Studio 2017. +When upgrading a program that uses the Windows API either directly or indirectly, you need to decide the minimum Windows version to support. In most cases, Windows 7 is a good choice. For more information, see [Header file problems](porting-guide-spy-increment.md#header_file_problems). The `WINVER` macro defines the oldest version of Windows that your program is designed to run on. If your MFC program sets `WINVER` to 0x0501 (Windows XP) you'll get a warning because MFC no longer supports XP, even if the compiler toolset itself has an XP mode. Compiler toolset support for Windows XP ended in Visual Studio 2017, and support for Windows 7, 8.0 and 8.1 ended in Visual Studio 2026. For more information, see [Updating the target windows version](porting-guide-spy-increment.md#updating_winver) and [More outdated header files](porting-guide-spy-increment.md#outdated_header_files). @@ -171,15 +171,15 @@ This error can occur in MFC applications. It indicates an ordering issue between If your original code is compiled for 32-bit systems, you have the option of creating a 64-bit version instead of (or in addition to) a new 32-bit app. In general, you should get your program compiling in 32-bit mode first, and then attempt 64-bit. Compiling for 64-bit is straightforward, but in some cases it can reveal bugs that were hidden by 32-bit builds. -Also, you should be aware of possible compile-time and runtime issues relating to pointer size, time and size values, and size-specific format specifiers in `printf` and `scanf` functions. For more information, see [Configure Visual C++ for 64-bit, x64 targets](../build/configuring-programs-for-64-bit-visual-cpp.md) and [Common Visual C++ 64-bit migration issues](../build/common-visual-cpp-64-bit-migration-issues.md). For more migration tips, see [Programming guide for 64-bit Windows](/windows/win32/WinProg64/programming-guide-for-64-bit-windows). +Also, you should be aware of possible compile-time and runtime issues relating to pointer size, time and size values, and size-specific format specifiers in `printf` and `scanf` functions. For more information, see [Configure Microsoft C++ for 64-bit, x64 targets](../build/configuring-programs-for-64-bit-visual-cpp.md) and [Common Microsoft C++ 64-bit migration issues](../build/common-visual-cpp-64-bit-migration-issues.md). For more migration tips, see [Programming guide for 64-bit Windows](/windows/win32/WinProg64/programming-guide-for-64-bit-windows). ## Unicode vs MBCS/ASCII Before Unicode was standardized, many programs used the Multibyte Character Set (MBCS) to represent characters that weren't included in the ASCII character set. In older MFC projects, MBCS was the default setting. When you upgrade such a program, you'll see warnings that advise to use Unicode instead. If you decide the conversion to Unicode isn't worth the development cost, you may choose to disable or ignore the warning. To disable it for all projects in your solution, open **View** > **Property Manager**, select all projects for which you want to disable the warning, then right-click on the selected items and choose **Properties**. In the **Property Pages** dialog, select **Configuration Properties** > **C/C++** > **Advanced**. In the **Disable Specific Warnings** property, open the drop-down arrow, and then choose **Edit**. Enter 4996 into the text box. (Don't include the 'C' prefix.) Choose **OK** to save the property, then choose **OK** to save your changes. -For more information, see [Porting from MBCS to Unicode](porting-guide-spy-increment.md#porting_to_unicode). For general information about MBCS vs. Unicode, see [Text and Strings in Visual C++](../text/text-and-strings-in-visual-cpp.md) and [Internationalization](../c-runtime-library/internationalization.md) . +For more information, see [Porting from MBCS to Unicode](porting-guide-spy-increment.md#porting_to_unicode). For general information about MBCS vs. Unicode, see [Text and Strings in Microsoft C++](../text/text-and-strings-in-visual-cpp.md) and [Internationalization](../c-runtime-library/internationalization.md) . ## See also -[Upgrading projects from earlier versions of Visual C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)
+[Upgrading projects from earlier versions of Microsoft C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)
[C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md) diff --git a/docs/porting/porting-third-party-libraries.md b/docs/porting/porting-third-party-libraries.md index 6a569a06924..ce39dfd7b59 100644 --- a/docs/porting/porting-third-party-libraries.md +++ b/docs/porting/porting-third-party-libraries.md @@ -1,25 +1,26 @@ --- description: "Learn more about: Porting third-party libraries" title: "Porting Third-Party Libraries" -ms.date: 10/22/2021 -helpviewer_keywords: ["3rd-party libraries", "vspkg"] +ms.date: 10/29/2025 +helpviewer_keywords: ["3rd-party libraries", "vcpkg"] ms.assetid: b055ed20-8a9e-45b2-ac2a-e3d94271c009 ms.topic: concept-article --- # Porting third-party libraries -When you upgrade a project from Visual Studio 2013 or earlier to the current version of Visual C++, you also have to upgrade any libraries that the project uses. The library and your project must be built by compatible versions and targets of the compiler toolset. If you don't have access to the library source code, and the library isn't available through vcpkg, then you must obtain an updated binary from the library vendor. For more information, see [Overview of potential upgrade issues](overview-of-potential-upgrade-issues-visual-cpp.md). +When you upgrade a project from Visual Studio 2013 or earlier to the current version of Microsoft C++ (MSVC) Build Tools, you also have to upgrade any libraries that the project uses. The library and your project must be built by compatible versions and targets of the build tools. If you don't have access to the library source code, and the library isn't available through vcpkg, then you must obtain an updated binary from the library vendor. For more information, see [Overview of potential upgrade issues](overview-of-potential-upgrade-issues-visual-cpp.md). When you upgrade an application from Visual Studio 2015 or later, it isn't necessary to upgrade dependencies because the code generated by those versions is binary-compatible. For more information, see [C++ binary compatibility between Visual Studio versions](binary-compat-2015-2017.md). ## Use vcpkg for open-source libraries -In the past, finding and upgrading third-party libraries was sometimes a non-trivial task. To make it easier to acquire and rebuild C++ third-party open-source libraries, the Visual C++ team has created a command-line tool called the **VC++ Packaging Tool** or **vcpkg**. Vcpkg has a searchable catalog of many popular C++ open-source libraries. You can install any library in the catalog directly from the vcpkg command line. When you install a library, Vcpkg creates a directory tree on your machine and adds the *`.h`* files, the *`.lib`* files, and binaries in this folder. You can use this folder in your compilation command line, or integrate it into Visual Studio 2015 or later by using the `vcpkg integrate install` command. After you integrate a library location, Visual Studio can find it and add it to any new project that you create. To use a library, just `#include` it. Visual Studio will automatically add the library path to your project settings and copy the DLL to your solution folder. For more information, see [vcpkg](/vcpkg/). +In the past, finding and upgrading third-party libraries was sometimes a non-trivial task. To make it easier to acquire and rebuild C++ third-party open-source libraries, the Microsoft C++ team has created a command-line tool called **[vcpkg](https://vcpkg.io)**. This tool has a searchable catalog (known as the curated registry) of many popular C/C++ open-source libraries. You can install any library in the catalog directly from the vcpkg command line. When you install a library, vcpkg creates a directory tree on your machine and adds the *`.h`* files, the *`.lib`* files, and binaries in this folder. You can use this folder in your compilation command line, or integrate it into Visual Studio 2015 or later by using the `vcpkg integrate install` command. After you integrate a library location, Visual Studio can find it and add it to any new project that you create. To use a library, just `#include` it. Visual Studio will automatically add the library path to your project settings and copy the DLL to your solution folder. For more information, see [vcpkg](/vcpkg/). You can either install [vcpkg from GitHub](https://github.com/microsoft/vcpkg/) or use the built-in version that ships with Visual Studio 2022 or later. To learn more about vcpkg, see the [vcpkg documentation](https://learn.microsoft.com/vcpkg). ## Reporting issues -If your open-source library isn't found in the **vcpkg** catalog, you can open an issue on the [GitHub repo](https://github.com/Microsoft/vcpkg/issues). That's where the community and the Visual C++ team can see it and potentially create the port file for this library. +If your open-source library isn't found in the **vcpkg** curated registry, you can open an issue on the [GitHub repo](https://github.com/Microsoft/vcpkg/issues). That's where the community and the Microsoft C++ team can see it and potentially create the port file for this library. ## See also -[Visual C++ Porting and Upgrading Guide](visual-cpp-porting-and-upgrading-guide.md) +[Microsoft C++ Porting and Upgrading Guide](visual-cpp-porting-and-upgrading-guide.md) +[vcpkg Documentation](https://learn.microsoft.com/vcpkg) diff --git a/docs/porting/porting-to-the-universal-windows-platform-cpp.md b/docs/porting/porting-to-the-universal-windows-platform-cpp.md index 742390cf472..83aeac60192 100644 --- a/docs/porting/porting-to-the-universal-windows-platform-cpp.md +++ b/docs/porting/porting-to-the-universal-windows-platform-cpp.md @@ -104,5 +104,5 @@ If you created a new UWP project using Visual Studio, you should not see this er ## See also -[Visual C++ Porting Guide](../porting/porting-to-the-universal-windows-platform-cpp.md)
+[Microsoft C++ Porting Guide](../porting/porting-to-the-universal-windows-platform-cpp.md)
[Develop apps for the Universal Windows Platform (UWP)](/visualstudio/cross-platform/develop-apps-for-the-universal-windows-platform-uwp) diff --git a/docs/porting/toc.yml b/docs/porting/toc.yml index 890de59b9b7..2594d143334 100644 --- a/docs/porting/toc.yml +++ b/docs/porting/toc.yml @@ -17,7 +17,7 @@ items: href: ../porting/floating-point-migration-issues.md - name: Use native multi-targeting in Visual Studio to build old projects href: ../porting/use-native-multi-targeting.md - - name: C++ features deprecated in Visual Studio 2019 + - name: C++ features deprecated in Visual Studio href: ../porting/features-deprecated-in-visual-studio.md - name: VCBuild vs. MSBuild href: ../porting/build-system-changes.md diff --git a/docs/porting/upgrade-your-code-to-the-universal-crt.md b/docs/porting/upgrade-your-code-to-the-universal-crt.md index 5c3ba784e29..8fc1091bce3 100644 --- a/docs/porting/upgrade-your-code-to-the-universal-crt.md +++ b/docs/porting/upgrade-your-code-to-the-universal-crt.md @@ -1,7 +1,7 @@ --- description: "Learn more about: Upgrade your code to the Universal CRT" title: "Upgrade your code to the Universal CRT" -ms.date: 06/28/2022 +ms.date: 10/29/2025 ms.assetid: eaf34c1b-da98-4058-a059-a10db693a5ce ms.topic: upgrade-and-migration-article --- @@ -9,7 +9,7 @@ ms.topic: upgrade-and-migration-article The Microsoft C Runtime Library (CRT) was refactored in Visual Studio 2015. The Standard C Library, POSIX extensions and Microsoft-specific functions, macros, and global variables were moved into a new library, the Universal C Runtime Library (Universal CRT or UCRT). The compiler-specific components of the CRT were moved into a new vcruntime library. -The UCRT is now a Windows component, and ships as part of Windows 10 and later. The UCRT supports a stable ABI based on C calling conventions, and it conforms closely to the ISO C99 standard, with only a few exceptions. It's no longer tied to a specific version of the compiler. You can use the UCRT on any version of Windows supported by Visual Studio 2015 or Visual Studio 2017. The benefit is that you no longer need to update your builds to target a new version of the CRT with every upgrade of Visual Studio. +The UCRT is now a Windows component, and ships as part of Windows 10 and later. The UCRT supports a stable ABI based on C calling conventions, and it conforms closely to the ISO C99 standard, with only a few exceptions. It's no longer tied to a specific version of the compiler. You can use the UCRT on any version of Windows supported by Visual Studio 2015 or later. The benefit is that you no longer need to update your builds to target a new version of the CRT with every upgrade of Visual Studio. This refactoring has changed the names or locations of many CRT header files, library files, and Redistributable files, and the deployment methods required for your code. Many functions and macros in the UCRT were also added or changed to improve standards conformance. To take advantage of these changes, you must update your existing code and project build systems. @@ -25,11 +25,11 @@ The retail and debug UCRT DLLs are found in separate locations. The retail DLLs ## Where to find the standard libraries and headers -The C and C++ compiler-specific runtime support library, `vcruntime`, contains the code required to support program startup and features such as exception handling and intrinsics. The library and its header files are still found in the version-specific Microsoft Visual Studio folder in your *Program Files* or *Program files (x86)* directory. +The C and C++ compiler-specific runtime support library, `vcruntime`, contains the code required to support program startup and features such as exception handling and intrinsics. The library and its header files are still found in the version-specific Microsoft Visual Studio folder in your *Program Files* or *Program Files (x86)* directory. -In Visual Studio 2017, 2019, and 2022, the header files are found under `Microsoft Visual Studio\[year]\[edition]\VC\Tools\MSVC\[lib-version]\include`. Here, `[year]` is the version of Visual Studio, `[edition]` is the edition or nickname for Visual Studio, and `[lib-version]` is the build version of the libraries. +In Visual Studio 2017 and later, the header files are found under `Microsoft Visual Studio\[version]\[edition]\VC\Tools\MSVC\[lib-version]\include`. Here, `[version]` is the year (Visual Studio 2017 - 2022) or major version number (Visual Studio 2026 or later), `[edition]` is the edition or nickname for Visual Studio, and `[lib-version]` is the build version of the libraries. -The link libraries are found under `Microsoft Visual Studio\[year]\[edition]\VC\Tools\MSVC\[lib-version]\lib\[architecture]`, where `[year]` is the version of Visual Studio, `[edition]` is the edition or nickname for Visual Studio, `[lib-version]` is the build version of the libraries, and `[architecture]` is the target processor architecture. Link libraries for OneCore and Store are also found in the libraries folder. +The link libraries are found under `Microsoft Visual Studio\[version]\[edition]\VC\Tools\MSVC\[lib-version]\lib\[architecture]`, where `[version]` is the year (Visual Studio 2017 - 2022) or major version number (Visual Studio 2026 or later), `[edition]` is the edition or nickname for Visual Studio, `[lib-version]` is the build version of the libraries, and `[architecture]` is the target processor architecture. Link libraries for OneCore and Store are also found in the libraries folder. The retail and debug versions of the static library are `libvcruntime.lib` and `libvcruntimed.lib`. The dynamic link retail and debug stub libraries are `vcruntime.lib` and `vcruntimed.lib`, respectively. @@ -39,18 +39,18 @@ When you update your Visual Studio C++ projects, if you have set the project's * Because the UCRT is now a Microsoft Windows operating system component, it's included as part of the operating system in Windows 10 and later. It's available through Windows Update for older operating systems, Windows Vista through Windows 8.1. A Redistributable version is available for Windows XP. As an operating system component, UCRT updates and servicing are managed by Windows Update independently of Visual Studio and Microsoft C++ compiler versions. Because the UCRT is a Windows component, for security and ease of updates, and a smaller image size, we strongly recommend you use the Redistributable package to do central deployment of the UCRT for your app. -You can use the UCRT on any version of Windows supported by Visual Studio 2015 or later. You can redistribute it using a `vcredist` package for supported versions of Windows before Windows 10. The `vcredist` packages include the UCRT components and automatically install them on Windows operating systems that don't have them installed by default. For more information, see [Redistributing Visual C++ Files](../windows/redistributing-visual-cpp-files.md). +You can use the UCRT on any version of Windows supported by Visual Studio 2015 or later. You can redistribute it using a `vcredist` package for supported versions of Windows before Windows 10. The `vcredist` packages include the UCRT components and automatically install them on Windows operating systems that don't have them installed by default. For more information, see [Redistributing Microsoft C++ Files](../windows/redistributing-visual-cpp-files.md). -App-local deployment of the UCRT is supported, though not recommended for both performance and security reasons. The DLLs for app-local deployment of the UCRT are included as part of the Windows SDK, under the *`redist`* subdirectory. The DLLs required include `ucrtbase.dll` and a set of **APISet forwarder** DLLs named `api-ms-win-[subset].dll`. The set of DLLs required on each operating system varies, so we recommended that you include all of the DLLs when you use app-local deployment. For more information and recommendations about app-local deployment, see [Deployment in Visual C++](../windows/deployment-in-visual-cpp.md). +App-local deployment of the UCRT is supported, though not recommended for both performance and security reasons. The DLLs for app-local deployment of the UCRT are included as part of the Windows SDK, under the *`redist`* subdirectory. The DLLs required include `ucrtbase.dll` and a set of **APISet forwarder** DLLs named `api-ms-win-[subset].dll`. The set of DLLs required on each operating system varies, so we recommended that you include all of the DLLs when you use app-local deployment. For more information and recommendations about app-local deployment, see [Deployment in Microsoft C++](../windows/deployment-in-visual-cpp.md). ## Changes to the Universal CRT functions and macros -Many functions were added or updated in the UCRT to improve ISO C99 conformance, and to address code quality and security issues. In some cases, this required breaking changes to the library. Your code that compiled cleanly when using an older version of the CRT may break when you compile it using the UCRT. If so, you must change your code to take advantage of UCRT updates and features. For a detailed listing of the breaking changes and updates to the CRT found in the Universal CRT, see the [C Runtime Library (CRT)](visual-cpp-change-history-2003-2015.md#BK_CRT) section of the Visual C++ change history. It includes a list of affected headers and functions that you can use to identify the changes needed in your code. +Many functions were added or updated in the UCRT to improve ISO C99 conformance, and to address code quality and security issues. In some cases, this required breaking changes to the library. Your code that compiled cleanly when using an older version of the CRT may break when you compile it using the UCRT. If so, you must change your code to take advantage of UCRT updates and features. For a detailed listing of the breaking changes and updates to the CRT found in the Universal CRT, see the [C Runtime Library (CRT)](visual-cpp-change-history-2003-2015.md#BK_CRT) section of the Microsoft C++ change history. It includes a list of affected headers and functions that you can use to identify the changes needed in your code. ## See also -[Visual C++ porting and upgrading guide](visual-cpp-porting-and-upgrading-guide.md)\ -[Overview of potential upgrade issues (Visual C++)](overview-of-potential-upgrade-issues-visual-cpp.md)\ -[Upgrading projects from earlier versions of Visual C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)\ +[Microsoft C++ porting and upgrading guide](visual-cpp-porting-and-upgrading-guide.md)\ +[Overview of potential upgrade issues (Microsoft C++)](overview-of-potential-upgrade-issues-visual-cpp.md)\ +[Upgrading projects from earlier versions of Microsoft C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)\ [Visual C++ change history 2003 - 2015](visual-cpp-change-history-2003-2015.md)\ [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md) diff --git a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md index 76f6dce84d9..fdda74285ee 100644 --- a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md +++ b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md @@ -72,7 +72,7 @@ For hard-to-fix errors, you can search for solutions or post a question on [Micr ## See also -[What's New for Visual C++ in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md)\ +[What's New for Microsoft C++ in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md)\ [Visual C++ change history 2003 - 2015](../porting/visual-cpp-change-history-2003-2015.md)\ [Nonstandard Behavior](../cpp/nonstandard-behavior.md)\ [Port data applications](../data/data-access-programming-mfc-atl.md) diff --git a/docs/porting/use-native-multi-targeting.md b/docs/porting/use-native-multi-targeting.md index 280f53a6c89..bdc24e3620d 100644 --- a/docs/porting/use-native-multi-targeting.md +++ b/docs/porting/use-native-multi-targeting.md @@ -1,21 +1,21 @@ --- description: "Learn more about: Use native multi-targeting in Visual Studio to build old projects" title: "Use native multi-targeting in Visual Studio to build old projects" -ms.date: 02/22/2022 +ms.date: 10/29/2025 helpviewer_keywords: ["C++ native multi-targeting", "upgrading Visual C++ applications, retargeting"] ms.assetid: b115aabe-a9dc-4525-90d3-367d97ea20c9 --- # Use native multi-targeting in Visual Studio to build old projects -Normally, we recommend that you update your projects when you install the latest version of Visual Studio. The cost of updating your projects and code is often more than offset by the benefits of the new IDE, compiler, libraries, and tools. However, we know that you may not be able to update some projects. You may have binaries that are tied to older libraries or platforms that for maintenance reasons you can't upgrade. Your code may use non-standard language constructs that would break if you moved to a more recent compiler. Your code might rely on third-party libraries compiled for a specific version of Visual C++. Or you may produce libraries for others that must target a specific older version of Visual C++. +Normally, we recommend that you update your projects when you install the latest version of Visual Studio. The cost of updating your projects and code is often more than offset by the benefits of the new IDE, compiler, libraries, and tools. However, we know that you may not be able to update some projects. You may have binaries that are tied to older libraries or platforms that for maintenance reasons you can't upgrade. Your code may use non-standard language constructs that would break if you moved to a more recent compiler. Your code might rely on third-party libraries compiled for a specific version of Microsoft C++ (MSVC). Or you may produce libraries for others that must target a specific older version of MSVC. Fortunately, you can use Visual Studio to build projects that target older compiler toolsets and libraries. If you still have the original tools installed, you don't have to upgrade a project from as far back as Visual Studio 2010 to take advantage of new features in the IDE: -- New C++ refactoring capabilities and editor experimental features +- New C++ refactoring capabilities and editor features - New Diagnostics tools debugger window and Error List window - Revamped breakpoints, exceptions window and new PerfTips - New code navigation and search tools -- New C++ Quick fixes and the Productivity Power Tools extensions. +- New C++ Quick fixes You can also target Visual Studio 2008 projects, but they can't be used unchanged. For details, see the **Instructions for Visual Studio 2008** section. @@ -23,7 +23,11 @@ The latest versions of Visual Studio support native multi-targeting and round-tr When you use an older toolset, you can take advantage of many of the latest IDE features, but not the latest advances in the C++ compiler, libraries and build tools. For example, you won't be able to use the new language conformance improvements, new debugging and code analysis features, or get the faster build throughput of the latest toolset. There are also some IDE features that are incompatible with older toolsets. For example, type information may be missing in the Memory Profiler, and the refactoring operation **Convert to Raw string literals** generates C++11-conformant code that won't compile when you use Visual Studio 2012 or older toolsets. -## How to use native multi-targeting in Visual Studio +## How to use native multi-targeting in Visual Studio 2026 + +Visual Studio 2026 includes a new **Setup assistant**. You can load an existing solution, right-click it in Solution Explorer, and select *Retarget solution* to open the assistant. You can use the assistant to install missing C++ build tools (MSVC components and Windows SDKs) compatible with the projects you are loading, including tools originally shipped with older Visual Studio versions. This allows you to continue working with your existing projects without losing compatibility with your previous Visual Studio version. Later, when you are ready to fully upgrade, you can use the assistant to retarget these projects to the newest version of the IDE. + +## How to use native multi-targeting in Visual Studio 2010-2022 Once you have installed Visual Studio side-by-side with your older version, open your existing project in the new version of Visual Studio. When the project is loaded, Visual Studio asks you whether you want to upgrade it to use the latest C++ compiler and libraries. Since you want the project to keep the older compiler and libraries, choose the **Cancel** button. @@ -62,5 +66,5 @@ When these products are installed, the **Platform Toolset** property drop-down i ## See also -[Upgrading projects from earlier versions of Visual C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)\ +[Upgrading projects from earlier versions of Microsoft C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)\ [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md) From 29395cb360b8e592d6653afb3cdbba7c5f3bef46 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 31 Oct 2025 14:37:56 -0700 Subject: [PATCH 1401/1799] draft --- .../overview/msvc-conformance-improvements.md | 307 ++++++++++++++++++ docs/overview/toc.yml | 2 + .../visual-cpp-language-conformance.md | 2 +- 3 files changed, 310 insertions(+), 1 deletion(-) create mode 100644 docs/overview/msvc-conformance-improvements.md diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md new file mode 100644 index 00000000000..fa5f6b3f956 --- /dev/null +++ b/docs/overview/msvc-conformance-improvements.md @@ -0,0 +1,307 @@ +--- +title: "C++ conformance improvements in Microsoft C/C++ (MSVC)" +description: "Summary of conformance improvements in Microsoft C/C++ (MSVC)" +ms.date: 10/31/2025 +ms.service: "visual-cpp" +ms.subservice: "cpp-lang" +--- +# C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C/C++ (MSVC) + +Microsoft C/C++ makes conformance improvements and bug fixes in every release. This article lists the significant improvements by MSVC Build Tools version. To jump directly to the changes for a specific version, use the **In this article** links at the top of this article. + +This document lists changes starting in November 2025 when Visual Studio and the MSVC toolset versioning diverged. + +For changes in earlier versions of Visual Studio: + +| Version | Conformance improvements link | +|---|---| +| 2022 | [C++ conformance improvements in Visual Studio 2022](cpp-conformance-improvements.md) | +| 2019 | [C++ conformance improvements in Visual Studio 2019](cpp-conformance-improvements-2019.md) | +| 2017 | [C++ conformance improvements in Visual Studio 2017](cpp-conformance-improvements-2017.md) | +| 2003-2015 | [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md) | + +## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.50 + +Microsoft C/C++ in Visual Studio (MSVC) Build Tools v14.50 introduces significant C++ language updates, conformance improvements, and bug fixes. This version ships with Visual Studio 2026 version 18.0 and includes version 19.50 of the MSVC compiler. You can try out these improvements by [downloading the Insiders release](https://aka.ms/vspreview). + +This document details the C++ language conformance improvements and compiler enhancements included in MSVC Build Tools v14.50. For updates in the Standard Library, check out the [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is regularly updated. + +As C++ standards progress in MSVC, you can follow along using the [cppreference compiler support table](https://en.cppreference.com/w/cpp/compiler_support.html) and help us identify what we should be working on next! + +## C++23 Features + +MSVC Build Tools v14.50 adds support for several C++23 features, bringing the compiler closer to full C++23 conformance. + +### P0849R8: auto(x) - decay-copy in the language + +[P0849R8](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p0849r8.html) introduces the `auto(x)` syntax for decay-copy operations directly in the language, providing a more concise way to express decay-copy semantics. + +Prior to P0849R8, you needed to explicitly perform decay operations: + +```cpp +// Prior to P0849R8: +void pop_front_alike(auto& x) { + using T = std::decay_t; + std::erase(x, T(x.front())); +} +``` + +After P0849R8, you can use the simpler `auto(x)` syntax: + +```cpp +// After P0849R8: +void pop_front_alike(auto& x) { + std::erase(x, auto(x.front())); +} +``` + +This feature provides a standardized way to perform decay-copy operations, making code more readable and reducing the need for verbose template metaprogramming. + +### P2437R1: C++23 `#warning` directive + +[P2437R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2437r1.pdf) implements the C++23 `#warning` preprocessor directive, providing a standard way to emit warnings during compilation. + +```cpp +// Valid prior to C++23. +#error bad configuration... + +// Valid after C++23. +#warning configuration deprecated... +``` + +The `#warning` directive allows you to emit diagnostic messages without stopping compilation, making it useful for deprecation notices and configuration warnings. + +### CWG Issue 2586: Explicit object parameter for assignment and comparison + +[CWG Issue 2586](https://cplusplus.github.io/CWG/issues/2586) allows explicit object parameters in assignment and comparison operators, enabling more flexible operator definitions. + +```cpp +struct S { + S& operator=(this S&, const S&) = default; // Valid after CWG2586. + auto operator<=>(this const S&, const S&) = default; // Valid after CWG2586. +}; +``` + +This change allows you to use the explicit object parameter syntax (deducing `this`) in assignment and comparison operators, providing more consistent syntax across different types of member functions. + +### P2280R4: References to unknown values during constant evaluation + +[P2280R4](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2280r4.html) allows references to unknown values during constant evaluation, relaxing restrictions on `constexpr` evaluation. + +```cpp +template +constexpr size_t array_size(T (&)[N]) { + return N; +} + +void check(int const (¶m)[3]) { + constexpr auto s2 = array_size(param); // Previously ill-formed, now accepted as a constant expression after P2280R4. +} +``` + +This improvement allows more code to be evaluated at compile time, particularly when dealing with function parameters in template contexts. + +## Smaller Conformance Updates + +MSVC Build Tools v14.50 includes numerous smaller conformance improvements that enhance C++ standard compliance: + +### Core Working Group Issues + +- **CWG2635**: Constrained structured bindings support +- **CWG2465**: Coroutine parameters passed to promise constructor improvements +- **CWG2496**: Ref-qualifiers and virtual overriding corrections +- **CWG2506**: Structured bindings and array cv-qualifiers fixes +- **CWG2507**: Default arguments for `operator[]` support +- **CWG2585**: Behavior alignment with standard requirements +- **CWG2521**: Deprecation of 'operator string-literal identifier' +- **CWG2528**: Relaxed conversion rules for the spaceship operator + +### Language Feature Enhancements + +- **P2360R0**: Extended init-statement definition to allow alias-declarations +- **P2290R3**: C++23 hexadecimal/octal delimited escape sequence support in string literals +- **P2797R0**: Resolution for CWG2692 regarding static and explicit object member functions with the same parameter-type-lists +- **P2266R3**: Simpler implicit move semantics + +### Compiler Diagnostics + +- Implementation of a warning to notify of enum type changes caused by `/Zc:enumTypes` + +## Compiler Improvements in v14.50 + +MSVC Build Tools v14.50 includes extensive compiler improvements across multiple areas, focusing on reliability, correctness, and conformance. + +### C++/CLI Improvements + +The C++/CLI compiler received several important fixes: + +- **ICE fixes**: Resolved internal compiler errors on use of `auto` in member declarations in C++/CLI managed types +- **Static constexpr support**: Fixed crashes related to [static constexpr in C++/CLI](https://developercommunity.visualstudio.com/t/static-constexpr-causes-CCLI-compiler/1536217) +- **Friend declarations**: Corrected crashes when [friend functions are used with managed types](https://developercommunity.visualstudio.com/t/Compiler-crash-A-managed-type-cannot-ha/1536159) +- **Stack ref-types**: Fixed crashes in [C++/CLI code using ref-types on stack](https://developercommunity.visualstudio.com/t/clexe-terminates-with-error-code--52970/10777778) +- **MFC compatibility**: Resolved [multiple errors in managed C++ code in MFC applications](https://developercommunity.visualstudio.com/t/Visual-Studio-1712-introduced-multiple-/10792822) + +### Diagnostics Improvements + +Enhanced diagnostic accuracy and clarity: + +- Fixed incorrect diagnostic about [implicit enum type conversions in C even with explicit casts](https://developercommunity.visualstudio.com/t/warning-C5287:-operands-are-different-e/10877942) + +### `constexpr` Enhancements + +Significant improvements to `constexpr` evaluation and support: + +#### Virtual Function Support +- Fixed errors involving [virtual function calls at compile-time](https://developercommunity.visualstudio.com/t/MSVC-erroneously-claims-the-return-value/10184063) +- Resolved [C++20 constexpr virtual polymorphism issues](https://developercommunity.visualstudio.com/t/C20-constexpr-virtual-polymorphism-is-/10348572) +- Corrected [virtual constexpr function evaluation](https://developercommunity.visualstudio.com/t/Virtual-constexpr-function-did-not-evalu/10360010) + +#### Expression Evaluation +- Improved rejection of [overflow from addition and left shifting of constants](https://developercommunity.visualstudio.com/content/problem/1202945/signed-overflow-in-constant-core-expression-should.html) +- Fixed scenarios where [constructors should be made implicitly constexpr](https://developercommunity.visualstudio.com/t/Multiple-constexpr-bugs-including-regre/10855054) +- Resolved issues with [constexpr static data members and CRTP](https://developercommunity.visualstudio.com/content/problem/1110270/crtp-in-msvc-1924-not-seeing-variable.html) + +#### Advanced `constexpr` Features +- Fixed bugs related to [evaluating destructors of constant objects](https://developercommunity.visualstudio.com/t/MSVC-1437-40-forces-my-global-std::stri/10794576) +- Improved [constexpr lambda captures with guaranteed copy elision](https://developercommunity.visualstudio.com/t/Lambda-in-a-function-template-requests-c/10922885) +- Allowed [consteval constructor calls as direct-initialization arguments](https://developercommunity.visualstudio.com/t/MSVC-Fails-to-compile-list-and-direct-in/10915063) +- Fixed issues with [consteval functions in `if consteval` contexts](https://developercommunity.visualstudio.com/t/The-consteval-function-is-not-an-immedia/10900618) + +### C++ Modules Improvements + +Enhanced C++20 modules support with numerous bug fixes: + +#### Import and Export Fixes +- Fixed bug with [importing friend declarations in nlohmann/json library](https://developercommunity.visualstudio.com/t/nlohmannjson-does-not-compile-as-C20-/10908164) +- Resolved [compiler crashes with using-declarations from specializations](https://developercommunity.visualstudio.com/t/Internal-compiler-error-when-using-usin/10934729) +- Fixed issues where [std::expected couldn't be specialized when imported](https://developercommunity.visualstudio.com/t/C1907-modules-constexpr-and-std::expect/10501314) + +#### Function and Variable Handling +- Corrected problems with [functions using types from named modules](https://developercommunity.visualstudio.com/t/Compiler-uses-non-exported-class-definit/10863347) +- Fixed [importing constexpr functions with static local variables](https://developercommunity.visualstudio.com/t/ICE-when-calling-imported-function-that-/10913469) +- Improved [pragma warning directive handling in modules](https://developercommunity.visualstudio.com/t/pragma-warningdisable-not-working-in-/10937100) + +#### Real-World Compatibility +- Fixed various issues preventing [Unreal Engine 5 from building with header units](https://developercommunity.visualstudio.com/t/Unreal-does-not-build-with-header-units-/10800119) +- Resolved [C++ modules + boost::asio compatibility issues](https://developercommunity.visualstudio.com/t/C20-modules--boost::asio-still-being-/10038468) +- Fixed problems with [specializations in the global module fragment](https://developercommunity.visualstudio.com/t/C20-modules:-specialzations-in-the-glo/10826499) + +### Conformance Enhancements + +Improved adherence to C++ standards: + +#### Attribute Support +- Added support for [`[[maybe_unused]]` on labels](https://developercommunity.visualstudio.com/t/unreferenced-label-when-ref-hidden-by-if/102076) +- Fixed warning C4102 (unreferenced label) when the only reference was from a discarded `if constexpr` branch + +#### Template and Specialization Fixes +- [Diagnosed ill-formed friend explicit specializations](https://developercommunity.visualstudio.com/t/Defining-explicit-function-template-spec/10933841) that were incorrectly accepted in C++20 or later +- Added `/Zc:enumEncoding` switch to [correctly encode enum non-type template parameters](https://developercommunity.visualstudio.com/t/Overload-resolution-fails-for-enum-non-t/10398088) +- Fixed issues with [missing 'template' keyword diagnostics](https://developercommunity.visualstudio.com/t/No-diagnostic-for-missing-template-in-d/10501221) + +### Reliability Improvements + +Extensive internal compiler error (ICE) fixes and stability improvements: + +#### Template-Related Fixes +- Fixed [ICE on explicit class template instantiation with friend functions](https://developercommunity.visualstudio.com/t/Internal-compiler-error-ICE-on-explici/10903887) +- Resolved [ICE with explicit variable template instantiations and PCH files](https://developercommunity.visualstudio.com/t/C-explicit-variable-template-instantia/10933044) +- Corrected [compiler crashes with deep nesting of aggregates and initializer lists](https://developercommunity.visualstudio.com/t/Internal-Compiler-Error-Found-in-MSVC-14/10914206) + +#### Lambda-Related Improvements +- Fixed issues with [nested generic lambdas](https://developercommunity.visualstudio.com/t/VS-1714-Preview-30:-ICE:-error-C1001:-/10891418) +- Resolved [ICE with lambda captures and template parameters](https://developercommunity.visualstudio.com/t/ICE-with-nested-std::visit--lambda-capt/10910959) +- Corrected [lambda initialization problems](https://developercommunity.visualstudio.com/t/Internal-compiler-error-with-designated-/10618932) + +#### Memory and Performance +- Fixed [exponential memory growth during type deduction](https://developercommunity.visualstudio.com/t/VS-2022-C-compiler-uses-nearly-200x-as/10900008) with classes having many base classes +- Improved [IL generation for temporaries bound to non-static data member references](https://developercommunity.visualstudio.com/t/CLexe-crashes-with-Access-Violation-on-/10878252) + +### Correctness Improvements + +Enhanced code generation and semantic analysis: + +#### Exception Handling and References +- Fixed [exception handling issues with unions](https://developercommunity.visualstudio.com/t/CLexe-exited-with-code--529706956-whe/10915135) +- Improved [rvalue reference handling in lambda contexts](https://developercommunity.visualstudio.com/t/When-using-a-lambda-as-a-template-argume/10916555) +- Corrected [explicit instantiation overload resolution with requires clauses](https://developercommunity.visualstudio.com/t/Overload-resolution-for-constrained-func/10107770) + +#### Type System and Semantics +- Fixed [noexcept specifier semantic issues](https://developercommunity2.visualstudio.com/t/noexcept-for-some-reason-work-with-type/1321108) +- Improved [phase-1 name binding in non-static data member initializers](https://developercommunity.visualstudio.com/t/Wrong-context-for-class-field-initialize/10896684) +- Corrected [value category determination for indirection and array expressions](https://developercommunity.visualstudio.com/t/cl-Preview-fails-to-properly-determine-a/10907452) + +#### Template and SFINAE +- Fixed [template-id parsing in alias declarations](https://developercommunity.visualstudio.com/t/Source-code-parsing-error-in-boostparse/10869546) +- Improved [partial ordering with template parameter objects](https://developercommunity.visualstudio.com/t/Template-Specialization-is-not-selected-/10902294) +- Resolved [constexpr variable re-declaration issues](https://developercommunity.visualstudio.com/t/A-C1001-error-occurs-in-VS1714/10909397) + +#### Advanced Language Features +- Fixed [`__declspec(no_sanitize_address)` handling on lambdas](https://developercommunity.visualstudio.com/t/Address-Sanitizer-declspecsattributes-d/10850249) +- Improved [static inline data member instantiation points](https://developercommunity.visualstudio.com/t/static-inline-atomic-and-another-atomic-/10203656) +- Corrected [static operator() in abbreviated function templates](https://developercommunity.visualstudio.com/t/Call-to-static-operator-is-elided/10908158) + +#### Standard Library Integration +- Fixed [`std::bit_cast` internal compiler errors](https://developercommunity.visualstudio.com/t/__builtin_bit_cast-Internal-compiler-err/10939926) +- Improved [modulo operator handling in variadic templates](https://developercommunity.visualstudio.com/t/Issue-in-specific-conditions-with-modulo/10940009) +- Resolved [class template argument deduction issues](https://developercommunity.visualstudio.com/t/Deduction-of-class-template-arguments-pi/10939918) + +#### C++20 and C++23 Features +- Enhanced [multidimensional operator[] support](https://developercommunity.visualstudio.com/t/Multidimensional-operator-with-Wall-r/10876026) +- Fixed [`using enum` declaration handling](https://developercommunity.visualstudio.com/t/using-enum-c-20-doesnt-supported-as-we/10926317) +- Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731) + +### C Compiler Improvements + +#### C23 Language Features +- Fixed `typeof` behavior with function types: In C23, functions no longer [decay to function pointers when used as arguments to `typeof`](https://developercommunity.visualstudio.com/t/__typeof__-not-working-with-function-typ/10891974) + +## Migrating to MSVC Build Tools v14.50 + +When upgrading to MSVC Build Tools v14.50, consider the following potential breaking changes and migration guidance: + +### C++23 Feature Adoption +- Update code to take advantage of new `auto(x)` decay-copy syntax for cleaner template code +- Consider using `#warning` directives for deprecation notices instead of error-prone conditional compilation +- Review explicit object parameter usage in operators for improved consistency + +### `constexpr` Improvements +- Existing `constexpr` code may now compile that previously failed, particularly with virtual functions +- Review constant evaluation code for potential new optimization opportunities +- Update CRTP patterns that may now work correctly with static constexpr members + +### Modules Migration +- Projects using C++20 modules should see improved stability and compatibility +- Header units now work more reliably with large codebases like Unreal Engine 5 +- Consider migrating from traditional headers to modules for better compilation performance + +### Compiler Diagnostics +- New warnings may appear for previously undiagnosed issues +- Review enum type usage if using `/Zc:enumTypes` +- Update code that relies on implicit conversions that may now be flagged + +### C Code Updates +- C23 features are available with `/std:clatest` +- `typeof` behavior changes may affect existing code +- Review preprocessor usage for new `__VA_OPT__` availability + +## Conclusion + +MSVC Build Tools v14.50 represents a significant advancement in C++ compiler technology, bringing substantial improvements in C++23 conformance, reliability, and correctness. The extensive bug fixes and enhancements make this release particularly valuable for large-scale C++ development projects. + +Key highlights include: +- Advanced C++23 feature support including `auto(x)` decay-copy and `#warning` directive +- Comprehensive `constexpr` improvements, particularly for virtual functions +- Major stability improvements for C++ modules +- Extensive reliability fixes reducing internal compiler errors +- Enhanced C++/CLI support for managed code scenarios + +For the latest updates and to provide feedback, please visit the [Visual Studio Developer Community](https://developercommunity.visualstudio.com/) or contact the team at [visualcpp@microsoft.com](mailto:visualcpp@microsoft.com). Follow us on Twitter [@visualc](https://twitter.com/visualc) or BlueSky [@msftcpp.bsky.social](https://bsky.app/profile/msftcpp.bsky.social). + +If you encounter problems with MSVC in Visual Studio 2026, please let us know via the [Report a Problem](how-to-report-a-problem-with-the-visual-cpp-toolset.md) option, either from the installer or the Visual Studio IDE itself. + +## See also + +[Microsoft C/C++ language conformance](visual-cpp-language-conformance.md) +[What's new for C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md) +[C++ conformance improvements in Visual Studio 2022](cpp-conformance-improvements.md) \ No newline at end of file diff --git a/docs/overview/toc.yml b/docs/overview/toc.yml index 8c34abe851e..e302eaf22c4 100644 --- a/docs/overview/toc.yml +++ b/docs/overview/toc.yml @@ -12,6 +12,8 @@ items: href: ../overview/what-s-new-for-cpp-2019.md - name: What's new for C++ in Visual Studio 2017 href: ../overview/what-s-new-for-cpp-2017.md + - name: C++ Conformance improvements in Microsoft C/C++ (MSVC) + href: ../overview/msvc-conformance-improvements.md - name: C++ conformance improvements in Visual Studio 2022 href: ../overview/cpp-conformance-improvements.md - name: C++ conformance improvements in Visual Studio 2019 diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 5f15f171582..27aac6adca8 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ language conformance" description: "Microsoft C and C++ conformance updates by Visual Studio version." -ms.date: 03/01/2023 +ms.date: 10/31/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- From afc78080a0236054cbaa984f2c7659cc347617da Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 31 Oct 2025 15:53:02 -0700 Subject: [PATCH 1402/1799] draft --- .../overview/msvc-conformance-improvements.md | 180 ++++-------------- 1 file changed, 33 insertions(+), 147 deletions(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index fa5f6b3f956..de4b1e6881d 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -22,11 +22,9 @@ For changes in earlier versions of Visual Studio: ## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.50 -Microsoft C/C++ in Visual Studio (MSVC) Build Tools v14.50 introduces significant C++ language updates, conformance improvements, and bug fixes. This version ships with Visual Studio 2026 version 18.0 and includes version 19.50 of the MSVC compiler. You can try out these improvements by [downloading the Insiders release](https://aka.ms/vspreview). +Microsoft C/C++ in Visual Studio (MSVC) Build Tools v14.50 introduces significant C++ language updates, conformance improvements, and bug fixes. This version shipped first with Visual Studio 2026 version 18.0 and includes version 19.50 of the MSVC compiler. -This document details the C++ language conformance improvements and compiler enhancements included in MSVC Build Tools v14.50. For updates in the Standard Library, check out the [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is regularly updated. - -As C++ standards progress in MSVC, you can follow along using the [cppreference compiler support table](https://en.cppreference.com/w/cpp/compiler_support.html) and help us identify what we should be working on next! +This document details the C++ language conformance improvements and compiler enhancements included in MSVC Build Tools v14.50. For more information about updates in the Standard Library, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is regularly updated. ## C++23 Features @@ -40,7 +38,8 @@ Prior to P0849R8, you needed to explicitly perform decay operations: ```cpp // Prior to P0849R8: -void pop_front_alike(auto& x) { +void pop_front_alike(auto& x) +{ using T = std::decay_t; std::erase(x, T(x.front())); } @@ -50,7 +49,8 @@ After P0849R8, you can use the simpler `auto(x)` syntax: ```cpp // After P0849R8: -void pop_front_alike(auto& x) { +void pop_front_alike(auto& x) +{ std::erase(x, auto(x.front())); } ``` @@ -69,14 +69,15 @@ This feature provides a standardized way to perform decay-copy operations, makin #warning configuration deprecated... ``` -The `#warning` directive allows you to emit diagnostic messages without stopping compilation, making it useful for deprecation notices and configuration warnings. +The `#warning` directive allows you to emit diagnostic messages without stopping compilation, making it useful for deprecation notices and configuration warnings. For more information, see [#warning directive (C/C++)](/cpp/preprocessor/hash-warning-directive-c-cpp). ### CWG Issue 2586: Explicit object parameter for assignment and comparison [CWG Issue 2586](https://cplusplus.github.io/CWG/issues/2586) allows explicit object parameters in assignment and comparison operators, enabling more flexible operator definitions. ```cpp -struct S { +struct S +{ S& operator=(this S&, const S&) = default; // Valid after CWG2586. auto operator<=>(this const S&, const S&) = default; // Valid after CWG2586. }; @@ -90,11 +91,13 @@ This change allows you to use the explicit object parameter syntax (deducing `th ```cpp template -constexpr size_t array_size(T (&)[N]) { +constexpr size_t array_size(T (&)[N]) +{ return N; } -void check(int const (¶m)[3]) { +void check(int const (¶m)[3]) +{ constexpr auto s2 = array_size(param); // Previously ill-formed, now accepted as a constant expression after P2280R4. } ``` @@ -105,157 +108,40 @@ This improvement allows more code to be evaluated at compile time, particularly MSVC Build Tools v14.50 includes numerous smaller conformance improvements that enhance C++ standard compliance: -### Core Working Group Issues - -- **CWG2635**: Constrained structured bindings support -- **CWG2465**: Coroutine parameters passed to promise constructor improvements -- **CWG2496**: Ref-qualifiers and virtual overriding corrections -- **CWG2506**: Structured bindings and array cv-qualifiers fixes -- **CWG2507**: Default arguments for `operator[]` support -- **CWG2585**: Behavior alignment with standard requirements -- **CWG2521**: Deprecation of 'operator string-literal identifier' -- **CWG2528**: Relaxed conversion rules for the spaceship operator - -### Language Feature Enhancements - -- **P2360R0**: Extended init-statement definition to allow alias-declarations -- **P2290R3**: C++23 hexadecimal/octal delimited escape sequence support in string literals -- **P2797R0**: Resolution for CWG2692 regarding static and explicit object member functions with the same parameter-type-lists -- **P2266R3**: Simpler implicit move semantics - -### Compiler Diagnostics - -- Implementation of a warning to notify of enum type changes caused by `/Zc:enumTypes` - -## Compiler Improvements in v14.50 - -MSVC Build Tools v14.50 includes extensive compiler improvements across multiple areas, focusing on reliability, correctness, and conformance. - -### C++/CLI Improvements - -The C++/CLI compiler received several important fixes: - -- **ICE fixes**: Resolved internal compiler errors on use of `auto` in member declarations in C++/CLI managed types -- **Static constexpr support**: Fixed crashes related to [static constexpr in C++/CLI](https://developercommunity.visualstudio.com/t/static-constexpr-causes-CCLI-compiler/1536217) -- **Friend declarations**: Corrected crashes when [friend functions are used with managed types](https://developercommunity.visualstudio.com/t/Compiler-crash-A-managed-type-cannot-ha/1536159) -- **Stack ref-types**: Fixed crashes in [C++/CLI code using ref-types on stack](https://developercommunity.visualstudio.com/t/clexe-terminates-with-error-code--52970/10777778) -- **MFC compatibility**: Resolved [multiple errors in managed C++ code in MFC applications](https://developercommunity.visualstudio.com/t/Visual-Studio-1712-introduced-multiple-/10792822) - -### Diagnostics Improvements - -Enhanced diagnostic accuracy and clarity: - -- Fixed incorrect diagnostic about [implicit enum type conversions in C even with explicit casts](https://developercommunity.visualstudio.com/t/warning-C5287:-operands-are-different-e/10877942) - -### `constexpr` Enhancements - -Significant improvements to `constexpr` evaluation and support: - -#### Virtual Function Support -- Fixed errors involving [virtual function calls at compile-time](https://developercommunity.visualstudio.com/t/MSVC-erroneously-claims-the-return-value/10184063) -- Resolved [C++20 constexpr virtual polymorphism issues](https://developercommunity.visualstudio.com/t/C20-constexpr-virtual-polymorphism-is-/10348572) -- Corrected [virtual constexpr function evaluation](https://developercommunity.visualstudio.com/t/Virtual-constexpr-function-did-not-evalu/10360010) - -#### Expression Evaluation -- Improved rejection of [overflow from addition and left shifting of constants](https://developercommunity.visualstudio.com/content/problem/1202945/signed-overflow-in-constant-core-expression-should.html) -- Fixed scenarios where [constructors should be made implicitly constexpr](https://developercommunity.visualstudio.com/t/Multiple-constexpr-bugs-including-regre/10855054) -- Resolved issues with [constexpr static data members and CRTP](https://developercommunity.visualstudio.com/content/problem/1110270/crtp-in-msvc-1924-not-seeing-variable.html) - -#### Advanced `constexpr` Features -- Fixed bugs related to [evaluating destructors of constant objects](https://developercommunity.visualstudio.com/t/MSVC-1437-40-forces-my-global-std::stri/10794576) -- Improved [constexpr lambda captures with guaranteed copy elision](https://developercommunity.visualstudio.com/t/Lambda-in-a-function-template-requests-c/10922885) -- Allowed [consteval constructor calls as direct-initialization arguments](https://developercommunity.visualstudio.com/t/MSVC-Fails-to-compile-list-and-direct-in/10915063) -- Fixed issues with [consteval functions in `if consteval` contexts](https://developercommunity.visualstudio.com/t/The-consteval-function-is-not-an-immedia/10900618) - -### C++ Modules Improvements - -Enhanced C++20 modules support with numerous bug fixes: - -#### Import and Export Fixes -- Fixed bug with [importing friend declarations in nlohmann/json library](https://developercommunity.visualstudio.com/t/nlohmannjson-does-not-compile-as-C20-/10908164) -- Resolved [compiler crashes with using-declarations from specializations](https://developercommunity.visualstudio.com/t/Internal-compiler-error-when-using-usin/10934729) -- Fixed issues where [std::expected couldn't be specialized when imported](https://developercommunity.visualstudio.com/t/C1907-modules-constexpr-and-std::expect/10501314) - -#### Function and Variable Handling -- Corrected problems with [functions using types from named modules](https://developercommunity.visualstudio.com/t/Compiler-uses-non-exported-class-definit/10863347) -- Fixed [importing constexpr functions with static local variables](https://developercommunity.visualstudio.com/t/ICE-when-calling-imported-function-that-/10913469) -- Improved [pragma warning directive handling in modules](https://developercommunity.visualstudio.com/t/pragma-warningdisable-not-working-in-/10937100) - -#### Real-World Compatibility -- Fixed various issues preventing [Unreal Engine 5 from building with header units](https://developercommunity.visualstudio.com/t/Unreal-does-not-build-with-header-units-/10800119) -- Resolved [C++ modules + boost::asio compatibility issues](https://developercommunity.visualstudio.com/t/C20-modules--boost::asio-still-being-/10038468) -- Fixed problems with [specializations in the global module fragment](https://developercommunity.visualstudio.com/t/C20-modules:-specialzations-in-the-glo/10826499) +- [CWG2635](https://cplusplus.github.io/CWG/issues/2635): Constrained structured bindings support +- [CWG2465](https://cplusplus.github.io/CWG/issues/2465): Coroutine parameters passed to promise constructor improvements +- [CWG2496](https://cplusplus.github.io/CWG/issues/2496): Ref-qualifiers and virtual overriding corrections +- [CWG2506](https://cplusplus.github.io/CWG/issues/2506): Structured bindings and array cv-qualifiers fixes +- [CWG2507](https://cplusplus.github.io/CWG/issues/2507): Default arguments for `operator[]` support +- [CWG2585](https://cplusplus.github.io/CWG/issues/2585): Behavior alignment with standard requirements +- [CWG2521](https://cplusplus.github.io/CWG/issues/2521): Deprecation of 'operator string-literal identifier' +- [CWG2528](https://www.open-std.org/jtc1/sc22/wg21/docs/cwg_defects.html#2528): Relaxed conversion rules for the spaceship operator +- [P2360R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2360r0.html): Extended init-statement definition to allow alias-declarations +- [P2290R3](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2290r3.pdf): C++23 hexadecimal/octal delimited escape sequence support in string literals +- [P2797R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2023/p2797r0.html): Resolution for CWG2692 regarding static and explicit object member functions with the same parameter-type-lists +- [P2266R3](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2266r3.html): Simpler implicit move semantics + +For more information about compiler improvements and bug fixes in MSVC Build Tools v14.50, see [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) ### Conformance Enhancements Improved adherence to C++ standards: #### Attribute Support -- Added support for [`[[maybe_unused]]` on labels](https://developercommunity.visualstudio.com/t/unreferenced-label-when-ref-hidden-by-if/102076) -- Fixed warning C4102 (unreferenced label) when the only reference was from a discarded `if constexpr` branch +- Added support for [`[[maybe_unused]]` on labels](https://developercommunity.visualstudio.com/t/unreferenced-label-when-ref-hidden-by-if/102076). +- Fixed warning C4102 (unreferenced label) when the only reference was from a discarded `if constexpr` branch. #### Template and Specialization Fixes -- [Diagnosed ill-formed friend explicit specializations](https://developercommunity.visualstudio.com/t/Defining-explicit-function-template-spec/10933841) that were incorrectly accepted in C++20 or later -- Added `/Zc:enumEncoding` switch to [correctly encode enum non-type template parameters](https://developercommunity.visualstudio.com/t/Overload-resolution-fails-for-enum-non-t/10398088) +- [Diagnosed ill-formed friend explicit specializations](https://developercommunity.visualstudio.com/t/Defining-explicit-function-template-spec/10933841) that were incorrectly accepted in C++20 or later. +- Added `/Zc:enumEncoding` switch to [correctly encode enum non-type template parameters](https://developercommunity.visualstudio.com/t/Overload-resolution-fails-for-enum-non-t/10398088). - Fixed issues with [missing 'template' keyword diagnostics](https://developercommunity.visualstudio.com/t/No-diagnostic-for-missing-template-in-d/10501221) -### Reliability Improvements - -Extensive internal compiler error (ICE) fixes and stability improvements: - -#### Template-Related Fixes -- Fixed [ICE on explicit class template instantiation with friend functions](https://developercommunity.visualstudio.com/t/Internal-compiler-error-ICE-on-explici/10903887) -- Resolved [ICE with explicit variable template instantiations and PCH files](https://developercommunity.visualstudio.com/t/C-explicit-variable-template-instantia/10933044) -- Corrected [compiler crashes with deep nesting of aggregates and initializer lists](https://developercommunity.visualstudio.com/t/Internal-Compiler-Error-Found-in-MSVC-14/10914206) - -#### Lambda-Related Improvements -- Fixed issues with [nested generic lambdas](https://developercommunity.visualstudio.com/t/VS-1714-Preview-30:-ICE:-error-C1001:-/10891418) -- Resolved [ICE with lambda captures and template parameters](https://developercommunity.visualstudio.com/t/ICE-with-nested-std::visit--lambda-capt/10910959) -- Corrected [lambda initialization problems](https://developercommunity.visualstudio.com/t/Internal-compiler-error-with-designated-/10618932) - -#### Memory and Performance -- Fixed [exponential memory growth during type deduction](https://developercommunity.visualstudio.com/t/VS-2022-C-compiler-uses-nearly-200x-as/10900008) with classes having many base classes -- Improved [IL generation for temporaries bound to non-static data member references](https://developercommunity.visualstudio.com/t/CLexe-crashes-with-Access-Violation-on-/10878252) - -### Correctness Improvements - -Enhanced code generation and semantic analysis: - -#### Exception Handling and References -- Fixed [exception handling issues with unions](https://developercommunity.visualstudio.com/t/CLexe-exited-with-code--529706956-whe/10915135) -- Improved [rvalue reference handling in lambda contexts](https://developercommunity.visualstudio.com/t/When-using-a-lambda-as-a-template-argume/10916555) -- Corrected [explicit instantiation overload resolution with requires clauses](https://developercommunity.visualstudio.com/t/Overload-resolution-for-constrained-func/10107770) - -#### Type System and Semantics -- Fixed [noexcept specifier semantic issues](https://developercommunity2.visualstudio.com/t/noexcept-for-some-reason-work-with-type/1321108) -- Improved [phase-1 name binding in non-static data member initializers](https://developercommunity.visualstudio.com/t/Wrong-context-for-class-field-initialize/10896684) -- Corrected [value category determination for indirection and array expressions](https://developercommunity.visualstudio.com/t/cl-Preview-fails-to-properly-determine-a/10907452) - -#### Template and SFINAE -- Fixed [template-id parsing in alias declarations](https://developercommunity.visualstudio.com/t/Source-code-parsing-error-in-boostparse/10869546) -- Improved [partial ordering with template parameter objects](https://developercommunity.visualstudio.com/t/Template-Specialization-is-not-selected-/10902294) -- Resolved [constexpr variable re-declaration issues](https://developercommunity.visualstudio.com/t/A-C1001-error-occurs-in-VS1714/10909397) - -#### Advanced Language Features -- Fixed [`__declspec(no_sanitize_address)` handling on lambdas](https://developercommunity.visualstudio.com/t/Address-Sanitizer-declspecsattributes-d/10850249) -- Improved [static inline data member instantiation points](https://developercommunity.visualstudio.com/t/static-inline-atomic-and-another-atomic-/10203656) -- Corrected [static operator() in abbreviated function templates](https://developercommunity.visualstudio.com/t/Call-to-static-operator-is-elided/10908158) - -#### Standard Library Integration -- Fixed [`std::bit_cast` internal compiler errors](https://developercommunity.visualstudio.com/t/__builtin_bit_cast-Internal-compiler-err/10939926) -- Improved [modulo operator handling in variadic templates](https://developercommunity.visualstudio.com/t/Issue-in-specific-conditions-with-modulo/10940009) -- Resolved [class template argument deduction issues](https://developercommunity.visualstudio.com/t/Deduction-of-class-template-arguments-pi/10939918) #### C++20 and C++23 Features + - Enhanced [multidimensional operator[] support](https://developercommunity.visualstudio.com/t/Multidimensional-operator-with-Wall-r/10876026) -- Fixed [`using enum` declaration handling](https://developercommunity.visualstudio.com/t/using-enum-c-20-doesnt-supported-as-we/10926317) - Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731) -### C Compiler Improvements - -#### C23 Language Features -- Fixed `typeof` behavior with function types: In C23, functions no longer [decay to function pointers when used as arguments to `typeof`](https://developercommunity.visualstudio.com/t/__typeof__-not-working-with-function-typ/10891974) - ## Migrating to MSVC Build Tools v14.50 When upgrading to MSVC Build Tools v14.50, consider the following potential breaking changes and migration guidance: @@ -287,7 +173,7 @@ When upgrading to MSVC Build Tools v14.50, consider the following potential brea ## Conclusion -MSVC Build Tools v14.50 represents a significant advancement in C++ compiler technology, bringing substantial improvements in C++23 conformance, reliability, and correctness. The extensive bug fixes and enhancements make this release particularly valuable for large-scale C++ development projects. +MSVC Build Tools v14.50 represents a significant advancement to the MSVC compiler, bringing substantial improvements in C++23 conformance, reliability, and correctness. The extensive bug fixes and enhancements make this release particularly valuable for large-scale C++ development projects. Key highlights include: - Advanced C++23 feature support including `auto(x)` decay-copy and `#warning` directive From 8c51c47bbdc9e6c57a3ca35be2fd78233bce924a Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 31 Oct 2025 16:20:17 -0700 Subject: [PATCH 1403/1799] draft --- docs/overview/visual-cpp-language-conformance.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 27aac6adca8..b402d513cb4 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -476,17 +476,22 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P2166R1 Prohibit basic_string and basic_string_view from being constructed from nullptr`](https://wg21.link/P2166R1) | VS 2022 17.0 [23](#note_23), [R](#note_R) | |  [`P2186R2 Removed garbage collection support`](https://wg21.link/P2186R2) | VS 2022 17.0 [23](#note_23), [Q](#note_Q) | |  [`P2251R1 Require span And basic_string_view To Be Trivially Copyable`](https://wg21.link/p2251r1) | VS 2022 17.1 [23](#note_23) | +|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | MSVC 14.50 [23](#note_23) | |  [`P2273R3 constexpr unique_ptr`](https://wg21.link/p2273r3) | VS 2022 17.3 [23](#note_23) | +|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC 14.50 [23](#note_23) | +|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC 14.50 [23](#note_23) | |  [`P2291R3 constexpr Integral `](https://wg21.link/p2291r3) | VS 2022 17.4 [23](#note_23) | |  [`P2302R4 ranges::contains, ranges::contains_subrange`](https://wg21.link/p2302r4) | VS 2022 17.4 [23](#note_23) | |  [`P2321R2 std::zip`](https://wg21.link/p2321r2) | partial in VS 2022 17.5 [23](#note_23) | |  [`P2322R6 ranges::fold_left, ranges::fold_right, etc.`](https://wg21.link/p2322r6) | VS 2022 17.5 [23](#note_23) | +|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC 14.50 [23](#note_23) | |  [`P2387R3 Pipe Support For User-Defined Range Adaptors`](https://wg21.link/p2387r3) | VS 2022 17.4 [23](#note_23) | |  [`P2393R1 Cleaning Up Integer-Class Types`](https://wg21.link/p2393r1) | VS 2022 17.2 [23](#note_23) | |  [`P2401R0 Conditional noexcept For exchange()`](https://wg21.link/p2401r0) | VS 2022 17.1 [23](#note_23) | |  [`P2408R5 Ranges Iterators As Inputs To Non-Ranges Algorithms`](https://wg21.link/p2408r5) | VS 2022 17.4 [23](#note_23) | |  [`P2417R2 More constexpr bitset`](https://wg21.link/p2417r2) | VS 2022 17.4 [23](#note_23) | |  [`P2419R2 Clarify Handling Of Encodings In Localized Formatting Of chrono Types`](https://wg21.link/p2419r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC 14.50 [23](#note_23) | |  [`P2438R2 string::substr() &&`](https://wg21.link/p2438r2) | VS 2022 17.4 [23](#note_23) | |  [`P2440R1 ranges::iota, ranges::shift_left, ranges::shift_right`](https://wg21.link/p2440r1) | VS 2022 17.4 [23](#note_23) | |  [`P2441R2 views::join_with`](https://wg21.link/p2441r2) | VS 2022 17.4 [23](#note_23) | From 2a6681ab649ca9bd23a56a6fed3053c6d9f2001d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Fri, 31 Oct 2025 19:40:29 -0700 Subject: [PATCH 1404/1799] draft --- docs/overview/msvc-conformance-improvements.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index de4b1e6881d..1f6a7d5ce63 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -26,6 +26,9 @@ Microsoft C/C++ in Visual Studio (MSVC) Build Tools v14.50 introduces significan This document details the C++ language conformance improvements and compiler enhancements included in MSVC Build Tools v14.50. For more information about updates in the Standard Library, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is regularly updated. +The Microsoft C++ standard library (STL) no longer supports targeting Windows 7 / Server 2008 R2, Windows 8 / Server 2012, or Windows 8.1 / Server 2012 R2.\ +Windows 10 / Server 2016 are the minimum supported operating systems. + ## C++23 Features MSVC Build Tools v14.50 adds support for several C++23 features, bringing the compiler closer to full C++23 conformance. @@ -136,12 +139,17 @@ Improved adherence to C++ standards: - Added `/Zc:enumEncoding` switch to [correctly encode enum non-type template parameters](https://developercommunity.visualstudio.com/t/Overload-resolution-fails-for-enum-non-t/10398088). - Fixed issues with [missing 'template' keyword diagnostics](https://developercommunity.visualstudio.com/t/No-diagnostic-for-missing-template-in-d/10501221) - #### C++20 and C++23 Features - Enhanced [multidimensional operator[] support](https://developercommunity.visualstudio.com/t/Multidimensional-operator-with-Wall-r/10876026) - Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731) +## Bug fixes + +Bug fixes for C++ Modules, `constexpr`, and others were made in v14.50. For a detailed list of bug fixes, see [Compiler Improvements in v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#compiler-improvements-in-v14.50) + +https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#constexpr + ## Migrating to MSVC Build Tools v14.50 When upgrading to MSVC Build Tools v14.50, consider the following potential breaking changes and migration guidance: From f38c327a58f4adfc54f655bc500f57cd29d69df6 Mon Sep 17 00:00:00 2001 From: Mahmoud Saleh <12202790+MahmoudGSaleh@users.noreply.github.com> Date: Mon, 3 Nov 2025 09:52:34 -0800 Subject: [PATCH 1405/1799] Redist Updates for VS 2026 Updated the date and adjusted references for Visual C++ Redistributable packages to reflect support for Visual Studio 2026. --- docs/windows/latest-supported-vc-redist.md | 41 +++++++++++++--------- 1 file changed, 25 insertions(+), 16 deletions(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index 878325159a6..cf273a8b073 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -1,7 +1,7 @@ --- title: "Latest supported Visual C++ Redistributable downloads" description: "This article provides download links for the latest Visual C++ Redistributable packages." -ms.date: 09/23/2025 +ms.date: 11/03/2025 helpviewer_keywords: [ "redist", @@ -24,9 +24,10 @@ This topic is for developers who need to install the Visual C++ runtime librarie To find the download you need, choose your version of Visual Studio from the table below. Each link takes you to the appropriate download section. -| Visual Studio version | Section | +| Version | Section | |--|--| -| Latest supported (2015–2022) | [Latest supported Redistributable version](#latest-supported-redistributable-version) | +| Latest supported v14 (for Visual Studio 2017–2026) | [Latest supported Redistributable version](#latest-supported-redistributable-version) | +| Visual Studio 2015 | [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) | | Visual Studio 2013 | [Visual Studio 2013 (VC++ 12.0)](#visual-studio-2013-vc-120-no-longer-supported) | | Visual Studio 2012 | [Visual Studio 2012 (VC++ 11.0)](#visual-studio-2012-vc-110-update-4-no-longer-supported) | | Visual Studio 2010 | [Visual Studio 2010 (VC++ 10.0)](#visual-studio-2010-vc-100-sp1-no-longer-supported) | @@ -35,35 +36,43 @@ To find the download you need, choose your version of Visual Studio from the tab Redistribution is permitted only for licensed Visual Studio users, as described in the [Visual Studio license terms](https://visualstudio.microsoft.com/license-terms/). For details on redistributing Visual C++ files, see [Redistributing Visual C++ Files](redistributing-visual-cpp-files.md). -A Visual C++ Redistributable installs Microsoft C and C++ (MSVC) runtime libraries. Many applications built using Microsoft C and C++ tools require these libraries. If your app is built using those libraries, a Microsoft Visual C++ Redistributable package at least as recent as the MSVC build toolset used to build your app must be installed on the target system along with the app. The Redistributable package architecture must match your app's target architecture (you can't install an ARM redistributable on an x86 system, or an x64 redistributable on an x86 system, for example). We recommend you use the latest Redistributable available for your version of Visual Studio, with some exceptions noted in this article. +A Visual C++ Redistributable installs Microsoft C and C++ (MSVC) runtime libraries. Many applications built using Microsoft C and C++ (MSVC) build tools require these libraries. If your app is built using those libraries, a Microsoft Visual C++ Redistributable package at least as recent as the MSVC build toolset used to build your app must be installed on the target system along with the app. The Redistributable package architecture must match your app's target architecture (you can't install an ARM64 redistributable on an x86 system, or an x64 redistributable on an x86 system, for example). We recommend you use the latest Redistributable available for your version of Visual Studio. -## Visual Studio 2015-2022 +## Visual C++ Redistributable v14 -This table lists the latest supported English (en-US) Microsoft Visual C++ Redistributable packages for Visual Studio 2015, 2017, 2019, and 2022. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created using Visual Studio 2015, 2017, 2019, or 2022. +This table lists the latest supported Microsoft Visual C++ Redistributable v14 packages. The latest supported version has the most recently implemented C++ features, security, reliability, and performance improvements. It also includes the latest C++ standard language and library standards conformance updates. We recommend that you install this version for all applications created using MSVC C and C++ build tools available in Visual Studio 2017, 2019, 2022, or 2026. -Unlike older versions of Visual Studio that have infrequent redist updates, the version number isn't listed in the following table for Visual Studio 2015-2022 because the redist is updated frequently. To find the version number of the latest redist, download the redist you're interested in using one of the following links. Then, look at its properties using Windows File Explorer. In the **Details** pane, the **File version** contains the version of the redist. +Unlike older versions of Visual Studio that have infrequent redist updates, the version number isn't listed in the following table for Visual C++ redistributable v14 because the redist is updated frequently. To find the version number of the latest redist, download the redist you're interested in using one of the following links. Then, look at its properties using Windows File Explorer. In the **Details** pane, the **File version** contains the version of the redist. ### Latest supported redistributable version | Architecture | Link | Notes | |--|--|--| -| ARM64 | [https://aka.ms/vs/17/release/vc_redist.arm64.exe](https://aka.ms/vs/17/release/vc_redist.arm64.exe) | Permalink for latest supported ARM64 version | -| X86 | [https://aka.ms/vs/17/release/vc_redist.x86.exe](https://aka.ms/vs/17/release/vc_redist.x86.exe) | Permalink for latest supported x86 version | -| X64 | [https://aka.ms/vs/17/release/vc_redist.x64.exe](https://aka.ms/vs/17/release/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | +| ARM64 | [https://aka.ms/vs/18/release/vc_redist.arm64.exe](https://aka.ms/vs/18/release/vc_redist.arm64.exe) | Permalink for latest supported ARM64 version | +| X86 | [https://aka.ms/vs/18/release/vc_redist.x86.exe](https://aka.ms/vs/18/release/vc_redist.x86.exe) | Permalink for latest supported x86 version | +| X64 | [https://aka.ms/vs/18/release/vc_redist.x64.exe](https://aka.ms/vs/18/release/vc_redist.x64.exe) | Permalink for latest supported x64 version. The X64 Redistributable package contains both ARM64 and X64 binaries. This package makes it easy to install required Visual C++ ARM64 binaries when the X64 Redistributable is installed on an ARM64 device. | Download other versions, including long term servicing release channel (LTSC) versions, from [my.visualstudio.com](https://my.visualstudio.com/). ### Notes -- The Visual C++ Redistributable for Visual Studio 2015-2022 doesn't have separate packages for different languages. It contains EULAs for all supported languages. -- Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Log in using a Visual Studio Subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or, create a free account by choosing the **No account? Create one!** link. -- Visual Studio versions since Visual Studio 2015 share the same Redistributable files. For example, any apps built by the Visual Studio 2015, 2017, 2019, or 2022 toolsets can use the latest Microsoft Visual C++ Redistributable. However, the version of the Microsoft Visual C++ Redistributable installed on the machine must be the same or higher than the version of the Visual C++ toolset used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). -- **Windows XP Support**: Microsoft ended support for Windows XP on April 8, 2014. Current versions of the Visual C++ Redistributable for Visual Studio 2015-2022 only support Windows 7, 8.1, 10, and 11. -- Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which they first ship, support for Visual C++ Redistributable 2015 (version 14.0.24212) also ended October 15, 2025. +- The Visual C++ Redistributable v14 doesn't have separate packages for different languages. License terms for different languages are available at https://aka.ms/VCRedistLicense. +- Some of the downloads that are mentioned in this article are currently available on [my.visualstudio.com](https://my.visualstudio.com/). Log in using a Visual Studio Subscription account so that you can access the download links. If you're asked for credentials, use your existing Visual Studio subscription account. Or, create a free account by choosing the [**No account? Create one!**](https://my.visualstudio.com/). +- Visual Studio versions since Visual Studio 2017 share the same Redistributable files. Any apps built by MSVC build tools v14.* available in Visual Studio 2017, 2019, 2022, or 2026 can use the latest Visual C++ Redistributable v14. However, the version of the Microsoft Visual C++ Redistributable installed on the machine must be the same or higher than the version of the Visual C++ toolset used to create your application. For more information about which version of the Redistributable to install, see [Determining which DLLs to redistribute](determining-which-dlls-to-redistribute.md). For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md). +- The latest version of the Visual C++ Redistributable v14 distributed with Visual Studio 2026 only supports the following operating systems: + * Windows 10 and 11 + * Windows Server 2016, 2019, 2022, and 2025 +- Support for Visual Studio 2015 ended on October 15, 2025. Because support for the Visual C++ Redistributable is connected to the version of Visual Studio in which they first ship, support for Visual C++ Redistributable 2015 (version 14.0.24212) also ended October 15, 2025. See [Visual Studio 2015 (VC++ 14.0)](#visual-studio-2015-vc-140-no-longer-supported) section below for the latest available version. - The Visual C++ Redistributable supports several command-line options. For more information, see [Command-line options for the Redistributable packages](./redistributing-visual-cpp-files.md#command-line-options-for-the-redistributable-packages). ## Unsupported legacy versions +### Visual Studio 2015 (VC++ 14.0) (no longer supported) + +To download the latest available version of Visual C++ Redistributable for Visual Studio 2015, please visit [my.visualstudio.com](https://my.visualstudio.com/) and search for "Visual C++ Redistributable for Visual Studio 2015" in the _Downloads_ section + +The latest version of Visual C++ Redistributable for Visual Studio 2015 is `14.0.24212.0`, available for ARM64, X86, and X64 architectures. + ### Visual Studio 2013 (VC++ 12.0) (no longer supported) These links download the latest available en-US Microsoft Visual C++ Redistributable packages for Visual Studio 2013. @@ -134,7 +143,7 @@ Download Redistributable files for other languages and architectures from: **Release notes** -- [Visual Studio 2022 release notes](/visualstudio/releases/2022/release-notes) +- [Visual Studio 2026 release notes](/visualstudio/releases/2026/release-notes) - [What's new for C++ in Visual Studio](../overview//what-s-new-for-visual-cpp-in-visual-studio.md) - [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md) - [MSVC Backend Updates since Visual Studio 2022 version 17.3](https://devblogs.microsoft.com/cppblog/msvc-backend-updates-since-visual-studio-2022-version-17-3/) From ecb8263581bb6b313ab0efb997f8ad8f7c36d8f6 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 3 Nov 2025 13:53:10 -0800 Subject: [PATCH 1406/1799] draft --- .../overview/msvc-conformance-improvements.md | 89 +++++++++++++++++-- .../visual-cpp-language-conformance.md | 8 +- 2 files changed, 89 insertions(+), 8 deletions(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 1f6a7d5ce63..d498751da06 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -88,6 +88,51 @@ struct S This change allows you to use the explicit object parameter syntax (deducing `this`) in assignment and comparison operators, providing more consistent syntax across different types of member functions. + +### P2266R1 : Simpler implicit move + +The introduction of [P2266R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2266r1.html) may cause code that was previously treated as an lvalue to be treated as an xvalue or a prvalue. For example: + +```cpp +#include + +template +T& f(T&& t) +{ + return t; +} + +struct S { }; + +void g() +{ + S s1{ }; + S& s2 = f(std::move(s1)); +} +``` + +In C++20, and earlier, this code would have compiled because even though the type of `t` is `S&&` the use of `t` in `return t` is treated as a glvalue and so it can bind to the return type. + +With C++23, `t` is treated as an xvalue and so it can't bind to an lvalue reference. + +One fix is to change to the return type of the function from `T&` to `T&&` but this may affect code that calls this function. An alternative is to use the feature test macro that is associated with this change. For example: + +```cpp +#include + +template +T& f(T&& t) +{ +#if defined(__cpp_implicit_move) + return static_cast&>(t); +#else + return t; +#endif +} +``` + +Adding the cast means that the value-category of the return expression is now an lvalue and so it can bind to the return type. + ### P2280R4: References to unknown values during constant evaluation [P2280R4](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2280r4.html) allows references to unknown values during constant evaluation, relaxing restrictions on `constexpr` evaluation. @@ -126,29 +171,61 @@ MSVC Build Tools v14.50 includes numerous smaller conformance improvements that For more information about compiler improvements and bug fixes in MSVC Build Tools v14.50, see [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) -### Conformance Enhancements +## Conformance Enhancements Improved adherence to C++ standards: -#### Attribute Support +### Attribute Support + - Added support for [`[[maybe_unused]]` on labels](https://developercommunity.visualstudio.com/t/unreferenced-label-when-ref-hidden-by-if/102076). - Fixed warning C4102 (unreferenced label) when the only reference was from a discarded `if constexpr` branch. -#### Template and Specialization Fixes +### Template and Specialization Fixes + - [Diagnosed ill-formed friend explicit specializations](https://developercommunity.visualstudio.com/t/Defining-explicit-function-template-spec/10933841) that were incorrectly accepted in C++20 or later. - Added `/Zc:enumEncoding` switch to [correctly encode enum non-type template parameters](https://developercommunity.visualstudio.com/t/Overload-resolution-fails-for-enum-non-t/10398088). - Fixed issues with [missing 'template' keyword diagnostics](https://developercommunity.visualstudio.com/t/No-diagnostic-for-missing-template-in-d/10501221) -#### C++20 and C++23 Features +### C++20 and C++23 Features - Enhanced [multidimensional operator[] support](https://developercommunity.visualstudio.com/t/Multidimensional-operator-with-Wall-r/10876026) - Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731) ## Bug fixes -Bug fixes for C++ Modules, `constexpr`, and others were made in v14.50. For a detailed list of bug fixes, see [Compiler Improvements in v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#compiler-improvements-in-v14.50) +Bug fixes for C++ Modules, `constexpr`, and other fixes were made in v14.50. For a detailed list of bug fixes, see [Compiler Improvements in v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#compiler-improvements-in-v14.50) + +**Encoding of certain non-type template arguments corrected** + +Affects `/stdc++20` or later. + +Certain non-type pointer type template arguments involving sub-objects could lead to linking issues or in some cases silent bad code generation where what should be distinct specializations collide. + +```cpp +struct A +{ + int x; +}; + +struct B +{ + int y; +}; + +template void f(); + +int main() +{ + static A a; + static B b; + constexpr auto px = &a.x; + constexpr auto py = &b.y; + f(); // incorrect encoding of argument 'px' + f(); // incorrect encoding of argument 'py', collided with 'px'. +} +``` -https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#constexpr +With this fix, the two calls to `f` get distinct encodings, as required. ## Migrating to MSVC Build Tools v14.50 diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index b402d513cb4..81b31336047 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ language conformance" description: "Microsoft C and C++ conformance updates by Visual Studio version." -ms.date: 10/31/2025 +ms.date: 11/03/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- @@ -197,6 +197,7 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P2173R1 Attributes on Lambda-Expressions`](https://wg21.link/p2173r1) | no | |  [`P2186R2 Remove Garbage Collection Support`](https://wg21.link/p2186r2) | VS 2022 17.0 [23](#note_23) | |  [`P2201R1 Mixed string literal concatenation`](https://wg21.link/p2201r1) | no | +|  [`P2266R1 Simpler implicit move`](https://wg21.link/p2266r1) | VS 2026 18.0 [24](#note_24) | |  [`P2223R2 Trimming whitespaces before line splicing`](https://wg21.link/p2223r2) | no | |  [`P2242R3 Non-literal variables (and labels and gotos) in constexpr functions`](https://wg21.link/p2242r3) | no | |  [`P2246R1 Character encoding of diagnostic text`](https://wg21.link/p2246r1) | VS 2022 17.0 [23](#note_23) | @@ -575,7 +576,8 @@ A group of papers listed together indicates a Standard feature along with one or **VS 2022 17.2** Supported in Visual Studio 2022 version 17.2.\ **VS 2022 17.3** Supported in Visual Studio 2022 version 17.3.\ **VS 2022 17.4** Supported in Visual Studio 2022 version 17.4.\ -**VS 2022 17.5** Supported in Visual Studio 2022 version 17.5. +**VS 2022 17.5** Supported in Visual Studio 2022 version 17.5.\ +**VS 2022 18** Supported in Visual Studio 2026 and beyond. ### Notes @@ -646,6 +648,8 @@ These algorithms aren't presently parallelized: **23** In Visual Studio 2022 version 17.0 and up, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. + **24** In Visual Studio 2026 version 18.0 and up, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. + **C11** Compiler support for C11 and C17 requires Visual Studio 2019 version 16.8 or higher. Except as noted, C11 and C17 library support requires Windows SDK build 10.0.20211.0 or higher. For more information on how to install support for C11 and C17, see [Install C11 and C17 support in Visual Studio](./install-c17-support.md). **DR** These features are enabled in all C++ [`/std`](../build/reference/std-specify-language-standard-version.md) compiler option modes. The C++ Standard committee adopted this change as a retroactive Defect Report to C++11 and all later versions. From 66de82c9f78b85319e64c58f1298308e2aefcd42 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 3 Nov 2025 14:06:11 -0800 Subject: [PATCH 1407/1799] draft --- .../overview/msvc-conformance-improvements.md | 81 +++++++++---------- 1 file changed, 38 insertions(+), 43 deletions(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index d498751da06..dd26387a8f2 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -1,7 +1,7 @@ --- title: "C++ conformance improvements in Microsoft C/C++ (MSVC)" description: "Summary of conformance improvements in Microsoft C/C++ (MSVC)" -ms.date: 10/31/2025 +ms.date: 11/03/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- @@ -22,12 +22,20 @@ For changes in earlier versions of Visual Studio: ## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.50 -Microsoft C/C++ in Visual Studio (MSVC) Build Tools v14.50 introduces significant C++ language updates, conformance improvements, and bug fixes. This version shipped first with Visual Studio 2026 version 18.0 and includes version 19.50 of the MSVC compiler. +MSVC Build Tools v14.50 represents a significant advancement to the MSVC compiler, bringing substantial improvements in C++23 conformance, reliability, and correctness. The extensive bug fixes and enhancements make this release particularly valuable for large-scale C++ development projects. + +This version shipped first with Visual Studio 2026 version 18.0 and includes version 19.50 of the MSVC compiler. -This document details the C++ language conformance improvements and compiler enhancements included in MSVC Build Tools v14.50. For more information about updates in the Standard Library, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is regularly updated. +Key highlights include: +- Advanced C++23 feature support including `auto(x)` decay-copy and `#warning` directive +- Comprehensive `constexpr` improvements, particularly for virtual functions +- Major stability improvements for C++ modules +- Extensive reliability fixes reducing internal compiler errors +- Enhanced C++/CLI support for managed code scenarios +- The Microsoft C++ standard library (STL) no longer supports targeting Windows 7/Server 2008 R2, Windows 8/Server 2012, or Windows 8.1/Server 2012 R2.\ +- Windows 10/Server 2016 are the minimum supported operating systems.\ -The Microsoft C++ standard library (STL) no longer supports targeting Windows 7 / Server 2008 R2, Windows 8 / Server 2012, or Windows 8.1 / Server 2012 R2.\ -Windows 10 / Server 2016 are the minimum supported operating systems. +For more information about performance improvements, bug fixes, and conformance updates in the Standard Library, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is updated regularly. ## C++23 Features @@ -88,7 +96,6 @@ struct S This change allows you to use the explicit object parameter syntax (deducing `this`) in assignment and comparison operators, providing more consistent syntax across different types of member functions. - ### P2266R1 : Simpler implicit move The introduction of [P2266R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2266r1.html) may cause code that was previously treated as an lvalue to be treated as an xvalue or a prvalue. For example: @@ -111,10 +118,8 @@ void g() } ``` -In C++20, and earlier, this code would have compiled because even though the type of `t` is `S&&` the use of `t` in `return t` is treated as a glvalue and so it can bind to the return type. - -With C++23, `t` is treated as an xvalue and so it can't bind to an lvalue reference. - +In C++20, and earlier, this code would have compiled because even though the type of `t` is `S&&` the use of `t` in `return t` is treated as a glvalue and so it can bind to the return type.\ +With C++23, `t` is treated as an xvalue and so it can't bind to an lvalue reference.\ One fix is to change to the return type of the function from `T&` to `T&&` but this may affect code that calls this function. An alternative is to use the feature test macro that is associated with this change. For example: ```cpp @@ -152,25 +157,6 @@ void check(int const (¶m)[3]) This improvement allows more code to be evaluated at compile time, particularly when dealing with function parameters in template contexts. -## Smaller Conformance Updates - -MSVC Build Tools v14.50 includes numerous smaller conformance improvements that enhance C++ standard compliance: - -- [CWG2635](https://cplusplus.github.io/CWG/issues/2635): Constrained structured bindings support -- [CWG2465](https://cplusplus.github.io/CWG/issues/2465): Coroutine parameters passed to promise constructor improvements -- [CWG2496](https://cplusplus.github.io/CWG/issues/2496): Ref-qualifiers and virtual overriding corrections -- [CWG2506](https://cplusplus.github.io/CWG/issues/2506): Structured bindings and array cv-qualifiers fixes -- [CWG2507](https://cplusplus.github.io/CWG/issues/2507): Default arguments for `operator[]` support -- [CWG2585](https://cplusplus.github.io/CWG/issues/2585): Behavior alignment with standard requirements -- [CWG2521](https://cplusplus.github.io/CWG/issues/2521): Deprecation of 'operator string-literal identifier' -- [CWG2528](https://www.open-std.org/jtc1/sc22/wg21/docs/cwg_defects.html#2528): Relaxed conversion rules for the spaceship operator -- [P2360R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2360r0.html): Extended init-statement definition to allow alias-declarations -- [P2290R3](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2290r3.pdf): C++23 hexadecimal/octal delimited escape sequence support in string literals -- [P2797R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2023/p2797r0.html): Resolution for CWG2692 regarding static and explicit object member functions with the same parameter-type-lists -- [P2266R3](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2266r3.html): Simpler implicit move semantics - -For more information about compiler improvements and bug fixes in MSVC Build Tools v14.50, see [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) - ## Conformance Enhancements Improved adherence to C++ standards: @@ -189,11 +175,30 @@ Improved adherence to C++ standards: ### C++20 and C++23 Features - Enhanced [multidimensional operator[] support](https://developercommunity.visualstudio.com/t/Multidimensional-operator-with-Wall-r/10876026) -- Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731) +- Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731)- + +### Smaller Conformance Updates + +MSVC Build Tools v14.50 includes numerous smaller conformance improvements that enhance C++ standard compliance: + +- [CWG2635](https://cplusplus.github.io/CWG/issues/2635): Constrained structured bindings support +- [CWG2465](https://cplusplus.github.io/CWG/issues/2465): Coroutine parameters passed to promise constructor improvements +- [CWG2496](https://cplusplus.github.io/CWG/issues/2496): Ref-qualifiers and virtual overriding corrections +- [CWG2506](https://cplusplus.github.io/CWG/issues/2506): Structured bindings and array cv-qualifiers fixes +- [CWG2507](https://cplusplus.github.io/CWG/issues/2507): Default arguments for `operator[]` support +- [CWG2585](https://cplusplus.github.io/CWG/issues/2585): Behavior alignment with standard requirements +- [CWG2521](https://cplusplus.github.io/CWG/issues/2521): Deprecation of 'operator string-literal identifier' +- [CWG2528](https://www.open-std.org/jtc1/sc22/wg21/docs/cwg_defects.html#2528): Relaxed conversion rules for the spaceship operator +- [P2360R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2360r0.html): Extended init-statement definition to allow alias-declarations +- [P2290R3](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2290r3.pdf): C++23 hexadecimal/octal delimited escape sequence support in string literals +- [P2797R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2023/p2797r0.html): Resolution for CWG2692 regarding static and explicit object member functions with the same parameter-type-lists +- [P2266R3](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2266r3.html): Simpler implicit move semantics ## Bug fixes -Bug fixes for C++ Modules, `constexpr`, and other fixes were made in v14.50. For a detailed list of bug fixes, see [Compiler Improvements in v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#compiler-improvements-in-v14.50) +Bug fixes for C++ Modules, `constexpr`, and other fixes were made in v14.50. + +For a detailed list of bug fixes, see [Compiler Improvements in v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#compiler-improvements-in-v14.50) **Encoding of certain non-type template arguments corrected** @@ -256,16 +261,6 @@ When upgrading to MSVC Build Tools v14.50, consider the following potential brea - `typeof` behavior changes may affect existing code - Review preprocessor usage for new `__VA_OPT__` availability -## Conclusion - -MSVC Build Tools v14.50 represents a significant advancement to the MSVC compiler, bringing substantial improvements in C++23 conformance, reliability, and correctness. The extensive bug fixes and enhancements make this release particularly valuable for large-scale C++ development projects. - -Key highlights include: -- Advanced C++23 feature support including `auto(x)` decay-copy and `#warning` directive -- Comprehensive `constexpr` improvements, particularly for virtual functions -- Major stability improvements for C++ modules -- Extensive reliability fixes reducing internal compiler errors -- Enhanced C++/CLI support for managed code scenarios For the latest updates and to provide feedback, please visit the [Visual Studio Developer Community](https://developercommunity.visualstudio.com/) or contact the team at [visualcpp@microsoft.com](mailto:visualcpp@microsoft.com). Follow us on Twitter [@visualc](https://twitter.com/visualc) or BlueSky [@msftcpp.bsky.social](https://bsky.app/profile/msftcpp.bsky.social). @@ -273,6 +268,6 @@ If you encounter problems with MSVC in Visual Studio 2026, please let us know vi ## See also -[Microsoft C/C++ language conformance](visual-cpp-language-conformance.md) -[What's new for C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md) +[Microsoft C/C++ language conformance](visual-cpp-language-conformance.md)\ +[What's new for C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md)\ [C++ conformance improvements in Visual Studio 2022](cpp-conformance-improvements.md) \ No newline at end of file From 8c04d590ebf7cad65ba935cd8ce206dca1b8fdd7 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 3 Nov 2025 14:40:06 -0800 Subject: [PATCH 1408/1799] draft --- .../overview/msvc-conformance-improvements.md | 65 +++++++++---------- .../visual-cpp-language-conformance.md | 24 +++---- 2 files changed, 44 insertions(+), 45 deletions(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index dd26387a8f2..17674b03f5d 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -7,9 +7,7 @@ ms.subservice: "cpp-lang" --- # C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C/C++ (MSVC) -Microsoft C/C++ makes conformance improvements and bug fixes in every release. This article lists the significant improvements by MSVC Build Tools version. To jump directly to the changes for a specific version, use the **In this article** links at the top of this article. - -This document lists changes starting in November 2025 when Visual Studio and the MSVC toolset versioning diverged. +Microsoft C/C++ makes conformance improvements and bug fixes in every release. Starting with Visual Studio 2026 18.0, major improvements are organized by MSVC Build Tools version number. To jump directly to the changes for a specific version, use the **In this article** links at the top of this article. For changes in earlier versions of Visual Studio: @@ -22,18 +20,18 @@ For changes in earlier versions of Visual Studio: ## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.50 -MSVC Build Tools v14.50 represents a significant advancement to the MSVC compiler, bringing substantial improvements in C++23 conformance, reliability, and correctness. The extensive bug fixes and enhancements make this release particularly valuable for large-scale C++ development projects. +MSVC Build Tools v14.50 introduces improvements to the MSVC compiler and Standard Library, including better C++23 standards conformance, enhanced reliability, and improved correctness. This release also includes numerous bug fixes and updates that benefit large-scale C++ development. This version shipped first with Visual Studio 2026 version 18.0 and includes version 19.50 of the MSVC compiler. -Key highlights include: -- Advanced C++23 feature support including `auto(x)` decay-copy and `#warning` directive -- Comprehensive `constexpr` improvements, particularly for virtual functions -- Major stability improvements for C++ modules -- Extensive reliability fixes reducing internal compiler errors -- Enhanced C++/CLI support for managed code scenarios -- The Microsoft C++ standard library (STL) no longer supports targeting Windows 7/Server 2008 R2, Windows 8/Server 2012, or Windows 8.1/Server 2012 R2.\ -- Windows 10/Server 2016 are the minimum supported operating systems.\ +Key highlights of this release include: +- Advanced C++23 feature support including `auto(x)` decay-copy and `#warning` directive. +- Comprehensive `constexpr` improvements, particularly for virtual functions. +- Major stability improvements for C++ modules. +- Extensive reliability fixes reducing internal compiler errors. +- Enhanced C++/CLI support for managed code scenarios. +- The Microsoft C++ standard library (MSVC STL) no longer supports targeting Windows 7/Server 2008 R2, Windows 8/Server 2012, or Windows 8.1/Server 2012 R2. +- Windows 10/Server 2016 are the minimum supported operating systems. For more information about performance improvements, bug fixes, and conformance updates in the Standard Library, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is updated regularly. @@ -45,10 +43,10 @@ MSVC Build Tools v14.50 adds support for several C++23 features, bringing the co [P0849R8](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p0849r8.html) introduces the `auto(x)` syntax for decay-copy operations directly in the language, providing a more concise way to express decay-copy semantics. -Prior to P0849R8, you needed to explicitly perform decay operations: +Before P0849R8, you needed to explicitly perform decay operations: ```cpp -// Prior to P0849R8: +// Before P0849R8: void pop_front_alike(auto& x) { using T = std::decay_t; @@ -73,7 +71,7 @@ This feature provides a standardized way to perform decay-copy operations, makin [P2437R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2437r1.pdf) implements the C++23 `#warning` preprocessor directive, providing a standard way to emit warnings during compilation. ```cpp -// Valid prior to C++23. +// Valid before C++23. #error bad configuration... // Valid after C++23. @@ -118,7 +116,7 @@ void g() } ``` -In C++20, and earlier, this code would have compiled because even though the type of `t` is `S&&` the use of `t` in `return t` is treated as a glvalue and so it can bind to the return type.\ +In C++20, and earlier, this code compiled because even though the type of `t` is `S&&` the use of `t` in `return t` is treated as a glvalue and so it can bind to the return type.\ With C++23, `t` is treated as an xvalue and so it can't bind to an lvalue reference.\ One fix is to change to the return type of the function from `T&` to `T&&` but this may affect code that calls this function. An alternative is to use the feature test macro that is associated with this change. For example: @@ -157,27 +155,27 @@ void check(int const (¶m)[3]) This improvement allows more code to be evaluated at compile time, particularly when dealing with function parameters in template contexts. -## Conformance Enhancements +## Conformance enhancements -Improved adherence to C++ standards: +Improved adherence to C++ standards includes better handling of attributes, templates, and C++20/C++23 features. -### Attribute Support +### Attribute support - Added support for [`[[maybe_unused]]` on labels](https://developercommunity.visualstudio.com/t/unreferenced-label-when-ref-hidden-by-if/102076). - Fixed warning C4102 (unreferenced label) when the only reference was from a discarded `if constexpr` branch. -### Template and Specialization Fixes +### Template and specialization fixes - [Diagnosed ill-formed friend explicit specializations](https://developercommunity.visualstudio.com/t/Defining-explicit-function-template-spec/10933841) that were incorrectly accepted in C++20 or later. -- Added `/Zc:enumEncoding` switch to [correctly encode enum non-type template parameters](https://developercommunity.visualstudio.com/t/Overload-resolution-fails-for-enum-non-t/10398088). +- Added `/Zc:enumEncoding` switch to [correctly encode enum nontype template parameters](https://developercommunity.visualstudio.com/t/Overload-resolution-fails-for-enum-non-t/10398088). - Fixed issues with [missing 'template' keyword diagnostics](https://developercommunity.visualstudio.com/t/No-diagnostic-for-missing-template-in-d/10501221) ### C++20 and C++23 Features - Enhanced [multidimensional operator[] support](https://developercommunity.visualstudio.com/t/Multidimensional-operator-with-Wall-r/10876026) -- Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731)- +- Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731) -### Smaller Conformance Updates +### Smaller conformance updates MSVC Build Tools v14.50 includes numerous smaller conformance improvements that enhance C++ standard compliance: @@ -196,15 +194,15 @@ MSVC Build Tools v14.50 includes numerous smaller conformance improvements that ## Bug fixes -Bug fixes for C++ Modules, `constexpr`, and other fixes were made in v14.50. +Bug fixes for C++ Modules, `constexpr`, and other fixes were made in MSVC v14.50. -For a detailed list of bug fixes, see [Compiler Improvements in v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#compiler-improvements-in-v14.50) +For a detailed list of bug fixes, see [Compiler Improvements in v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#compiler-improvements-in-v14.50). -**Encoding of certain non-type template arguments corrected** +**Encoding of certain nontype template arguments corrected** Affects `/stdc++20` or later. -Certain non-type pointer type template arguments involving sub-objects could lead to linking issues or in some cases silent bad code generation where what should be distinct specializations collide. +Certain nontype pointer type template arguments involving subobjects could lead to linking issues or in some cases silent bad code generation where what should be distinct specializations collide. ```cpp struct A @@ -236,33 +234,34 @@ With this fix, the two calls to `f` get distinct encodings, as required. When upgrading to MSVC Build Tools v14.50, consider the following potential breaking changes and migration guidance: -### C++23 Feature Adoption +### C++23 feature adoption - Update code to take advantage of new `auto(x)` decay-copy syntax for cleaner template code - Consider using `#warning` directives for deprecation notices instead of error-prone conditional compilation - Review explicit object parameter usage in operators for improved consistency -### `constexpr` Improvements +### `constexpr` improvements - Existing `constexpr` code may now compile that previously failed, particularly with virtual functions - Review constant evaluation code for potential new optimization opportunities - Update CRTP patterns that may now work correctly with static constexpr members -### Modules Migration +### Modules migration - Projects using C++20 modules should see improved stability and compatibility - Header units now work more reliably with large codebases like Unreal Engine 5 - Consider migrating from traditional headers to modules for better compilation performance -### Compiler Diagnostics +### Compiler diagnostics - New warnings may appear for previously undiagnosed issues - Review enum type usage if using `/Zc:enumTypes` - Update code that relies on implicit conversions that may now be flagged -### C Code Updates +### C code updates - C23 features are available with `/std:clatest` - `typeof` behavior changes may affect existing code - Review preprocessor usage for new `__VA_OPT__` availability +## Provide feedback -For the latest updates and to provide feedback, please visit the [Visual Studio Developer Community](https://developercommunity.visualstudio.com/) or contact the team at [visualcpp@microsoft.com](mailto:visualcpp@microsoft.com). Follow us on Twitter [@visualc](https://twitter.com/visualc) or BlueSky [@msftcpp.bsky.social](https://bsky.app/profile/msftcpp.bsky.social). +For the latest updates and to provide feedback, visit the [Visual Studio Developer Community](https://developercommunity.visualstudio.com/) or contact the team at [visualcpp@microsoft.com](mailto:visualcpp@microsoft.com). Follow us on Twitter [@visualc](https://twitter.com/visualc) or BlueSky [@msftcpp.bsky.social](https://bsky.app/profile/msftcpp.bsky.social). If you encounter problems with MSVC in Visual Studio 2026, please let us know via the [Report a Problem](how-to-report-a-problem-with-the-visual-cpp-toolset.md) option, either from the installer or the Visual Studio IDE itself. diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 81b31336047..f77670f7701 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -197,7 +197,7 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P2173R1 Attributes on Lambda-Expressions`](https://wg21.link/p2173r1) | no | |  [`P2186R2 Remove Garbage Collection Support`](https://wg21.link/p2186r2) | VS 2022 17.0 [23](#note_23) | |  [`P2201R1 Mixed string literal concatenation`](https://wg21.link/p2201r1) | no | -|  [`P2266R1 Simpler implicit move`](https://wg21.link/p2266r1) | VS 2026 18.0 [24](#note_24) | +|  [`P2266R1 Simpler implicit move`](https://wg21.link/p2266r1) | MSVC 14.50 [24](#note_24) | |  [`P2223R2 Trimming whitespaces before line splicing`](https://wg21.link/p2223r2) | no | |  [`P2242R3 Non-literal variables (and labels and gotos) in constexpr functions`](https://wg21.link/p2242r3) | no | |  [`P2246R1 Character encoding of diagnostic text`](https://wg21.link/p2246r1) | VS 2022 17.0 [23](#note_23) | @@ -477,22 +477,22 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P2166R1 Prohibit basic_string and basic_string_view from being constructed from nullptr`](https://wg21.link/P2166R1) | VS 2022 17.0 [23](#note_23), [R](#note_R) | |  [`P2186R2 Removed garbage collection support`](https://wg21.link/P2186R2) | VS 2022 17.0 [23](#note_23), [Q](#note_Q) | |  [`P2251R1 Require span And basic_string_view To Be Trivially Copyable`](https://wg21.link/p2251r1) | VS 2022 17.1 [23](#note_23) | -|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | MSVC 14.50 [23](#note_23) | +|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | MSVC 14.50 [24](#note_24) | |  [`P2273R3 constexpr unique_ptr`](https://wg21.link/p2273r3) | VS 2022 17.3 [23](#note_23) | -|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC 14.50 [23](#note_23) | -|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC 14.50 [23](#note_23) | +|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC 14.50 [24](#note_24) | +|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC 14.50 [24](#note_24) | |  [`P2291R3 constexpr Integral `](https://wg21.link/p2291r3) | VS 2022 17.4 [23](#note_23) | |  [`P2302R4 ranges::contains, ranges::contains_subrange`](https://wg21.link/p2302r4) | VS 2022 17.4 [23](#note_23) | |  [`P2321R2 std::zip`](https://wg21.link/p2321r2) | partial in VS 2022 17.5 [23](#note_23) | |  [`P2322R6 ranges::fold_left, ranges::fold_right, etc.`](https://wg21.link/p2322r6) | VS 2022 17.5 [23](#note_23) | -|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC 14.50 [23](#note_23) | +|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC 14.50 [24](#note_24) | |  [`P2387R3 Pipe Support For User-Defined Range Adaptors`](https://wg21.link/p2387r3) | VS 2022 17.4 [23](#note_23) | |  [`P2393R1 Cleaning Up Integer-Class Types`](https://wg21.link/p2393r1) | VS 2022 17.2 [23](#note_23) | |  [`P2401R0 Conditional noexcept For exchange()`](https://wg21.link/p2401r0) | VS 2022 17.1 [23](#note_23) | |  [`P2408R5 Ranges Iterators As Inputs To Non-Ranges Algorithms`](https://wg21.link/p2408r5) | VS 2022 17.4 [23](#note_23) | |  [`P2417R2 More constexpr bitset`](https://wg21.link/p2417r2) | VS 2022 17.4 [23](#note_23) | |  [`P2419R2 Clarify Handling Of Encodings In Localized Formatting Of chrono Types`](https://wg21.link/p2419r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC 14.50 [23](#note_23) | +|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC 14.50 [24](#note_24) | |  [`P2438R2 string::substr() &&`](https://wg21.link/p2438r2) | VS 2022 17.4 [23](#note_23) | |  [`P2440R1 ranges::iota, ranges::shift_left, ranges::shift_right`](https://wg21.link/p2440r1) | VS 2022 17.4 [23](#note_23) | |  [`P2441R2 views::join_with`](https://wg21.link/p2441r2) | VS 2022 17.4 [23](#note_23) | @@ -577,11 +577,11 @@ A group of papers listed together indicates a Standard feature along with one or **VS 2022 17.3** Supported in Visual Studio 2022 version 17.3.\ **VS 2022 17.4** Supported in Visual Studio 2022 version 17.4.\ **VS 2022 17.5** Supported in Visual Studio 2022 version 17.5.\ -**VS 2022 18** Supported in Visual Studio 2026 and beyond. +**MSVC 14.50** Supported in MSVC Compiler 14.50 and beyond. Support first shipped with Visual Studio 2026 18.0. ### Notes - **A** In [`/std:c++14`](../build/reference/std-specify-language-standard-version.md) mode, dynamic exception specifications remain unimplemented, and `throw()` is still treated as a synonym for `__declspec(nothrow)`. In C++17, dynamic exception specifications were mostly removed by P0003R5, except for one vestige: `throw()` is deprecated and required to behave as a synonym for **`noexcept`**. In [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) mode, MSVC now conforms to the Standard by giving `throw()` the same behavior as **`noexcept`**, that is, enforcement via termination. + **A** In [`/std:c++14`](../build/reference/std-specify-language-standard-version.md) mode, the compiler leaves dynamic exception specifications unimplemented, and treats `throw()` as a synonym for `__declspec(nothrow)`. In C++17, P0003R5 removed most dynamic exception specifications, except for one vestige: the standard deprecated `throw()` and requires it to behave as a synonym for **`noexcept`**. In [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) mode, MSVC now conforms to the Standard by giving `throw()` the same behavior as **`noexcept`**, that is, enforcement via termination. The compiler option [`/Zc:noexceptTypes`](../build/reference/zc-noexcepttypes.md) requests the old behavior of `__declspec(nothrow)`. It's likely that `throw()` will be removed in a future version of C++. To help with migrating code in response to these changes in the Standard and the Microsoft implementation, new compiler warnings for exception specification issues are added under [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) and [`/permissive-`](../build/reference/permissive-standards-conformance.md). @@ -595,7 +595,7 @@ The compiler option [`/Zc:noexceptTypes`](../build/reference/zc-noexcepttypes.md **F** Features removed when the [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later compiler option is specified. To re-enable these features (to ease the transition to newer language modes), use these macros: `_HAS_AUTO_PTR_ETC`, `_HAS_FUNCTION_ALLOCATOR_SUPPORT`, `_HAS_OLD_IOSTREAMS_MEMBERS`, and `_HAS_UNEXPECTED`. - **G** C++17's parallel algorithms library is complete. Complete doesn't mean that every algorithm is parallelized in every case. The most important algorithms have been parallelized. Execution policy signatures are provided even where the implementation doesn't parallelize algorithms. The central internal header, ``, contains the following "Parallel Algorithms Notes": C++ allows an implementation to implement parallel algorithms as calls to the serial algorithms. This implementation parallelizes several common algorithm calls, but not all. + **G** C++17's parallel algorithms library is complete. Complete doesn't mean that every algorithm is parallelized in every case. The most important algorithms are parallelized. Execution policy signatures are provided even where the implementation doesn't parallelize algorithms. The central internal header, ``, contains the following "Parallel Algorithms Notes": C++ allows an implementation to implement parallel algorithms as calls to the serial algorithms. This implementation parallelizes several common algorithm calls, but not all. The following algorithms are parallelized: @@ -609,7 +609,7 @@ These algorithms aren't presently parallelized: - `generate`, `generate_n` - Effective parallelism of these algorithms might be infeasible: - `partial_sort`, `partial_sort_copy` -- These algorithms haven't been evaluated yet. The library might implement parallelism in a future release: +- These algorithms aren't evaluated yet. The library might implement parallelism in a future release: - `copy_if`, `includes`, `inplace_merge`, `lexicographical_compare`, `max_element`, `merge`, `min_element`, `minmax_element`, `nth_element`, `partition_copy`, `remove_copy`, `remove_copy_if`, `replace_copy`, `replace_copy_if`, `set_symmetric_difference`, `set_union`, `stable_partition`, `unique`, `unique_copy` **H** This is a wholly new implementation, incompatible with the previous `std::experimental` version, made necessary by symlink support, bug fixes, and changes in standard-required behavior. Currently, `` provides both the new `std::filesystem` and the previous `std::experimental::filesystem`. The `` header provides only the old experimental implementation. Expect removal of the experimental implementation in the next ABI-breaking release of the libraries. @@ -620,7 +620,7 @@ These algorithms aren't presently parallelized: **K** MSVC doesn't support the `_Complex` keyword or native complex types. The Universal CRT `` uses implementation-specific macros to achieve the same effect. For more information, see [C complex math support](../c-runtime-library/complex-math-support.md). - **L** The Universal CRT doesn't implement the `strftime` `E` and `O` alternative conversion modifiers. These modifiers are ignored (for example, `%Oe` behaves the same as `%e`). The modifiers aren't supported by the underlying locale APIs. + **L** The Universal CRT doesn't implement the `strftime` `E` and `O` alternative conversion modifiers. These modifiers are ignored (for example, `%Oe` behaves the same as `%e`). The underlying locale APIs don’t support the modifiers. **M** The Universal CRT doesn't implement C11 `aligned_alloc`, but does provide [`_aligned_malloc`](../c-runtime-library/reference/aligned-malloc.md) and [`_aligned_free`](../c-runtime-library/reference/aligned-free.md). Because the Windows operating system doesn't support aligned allocations, this function is unlikely to be implemented. @@ -648,7 +648,7 @@ These algorithms aren't presently parallelized: **23** In Visual Studio 2022 version 17.0 and up, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. - **24** In Visual Studio 2026 version 18.0 and up, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. + **24** In MSVC 14.50 and up, first shipped with Visual Studio 2026 version 18.0, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. **C11** Compiler support for C11 and C17 requires Visual Studio 2019 version 16.8 or higher. Except as noted, C11 and C17 library support requires Windows SDK build 10.0.20211.0 or higher. For more information on how to install support for C11 and C17, see [Install C11 and C17 support in Visual Studio](./install-c17-support.md). From a3a60abeefdd2d72c55e14b5479c750924acf389 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 3 Nov 2025 15:14:46 -0800 Subject: [PATCH 1409/1799] Apply suggestion from @AugP Co-authored-by: Augustin Popa --- docs/overview/msvc-conformance-improvements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 17674b03f5d..6037985b986 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -33,7 +33,7 @@ Key highlights of this release include: - The Microsoft C++ standard library (MSVC STL) no longer supports targeting Windows 7/Server 2008 R2, Windows 8/Server 2012, or Windows 8.1/Server 2012 R2. - Windows 10/Server 2016 are the minimum supported operating systems. -For more information about performance improvements, bug fixes, and conformance updates in the Standard Library, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is updated regularly. +For more information about performance improvements, bug fixes, and conformance updates in the standard library, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is updated regularly. ## C++23 Features From c31e6c3b676f70db4170d9dcf53f5935cfff1b60 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 3 Nov 2025 15:14:59 -0800 Subject: [PATCH 1410/1799] Apply suggestion from @AugP Co-authored-by: Augustin Popa --- docs/overview/msvc-conformance-improvements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 6037985b986..939869b1086 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -7,7 +7,7 @@ ms.subservice: "cpp-lang" --- # C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C/C++ (MSVC) -Microsoft C/C++ makes conformance improvements and bug fixes in every release. Starting with Visual Studio 2026 18.0, major improvements are organized by MSVC Build Tools version number. To jump directly to the changes for a specific version, use the **In this article** links at the top of this article. +Microsoft C++ (MSVC) Build Tools makes conformance improvements and bug fixes in every release. Starting with Visual Studio 2026 version 18.0, major improvements are organized by MSVC Build Tools version number. To jump directly to the changes for a specific version, use the **In this article** links at the top of this article. For changes in earlier versions of Visual Studio: From a5347dc169ce4e9cbb108e1e3df2b9cc8b065fc4 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 3 Nov 2025 15:15:13 -0800 Subject: [PATCH 1411/1799] Apply suggestion from @AugP Co-authored-by: Augustin Popa --- docs/overview/msvc-conformance-improvements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 939869b1086..034fa1f1023 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -5,7 +5,7 @@ ms.date: 11/03/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- -# C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C/C++ (MSVC) +# C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools Microsoft C++ (MSVC) Build Tools makes conformance improvements and bug fixes in every release. Starting with Visual Studio 2026 version 18.0, major improvements are organized by MSVC Build Tools version number. To jump directly to the changes for a specific version, use the **In this article** links at the top of this article. From b9186bcd045d2f6ae35f8cb55666675816b73f12 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 3 Nov 2025 15:15:25 -0800 Subject: [PATCH 1412/1799] Apply suggestion from @AugP Co-authored-by: Augustin Popa --- docs/overview/msvc-conformance-improvements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 034fa1f1023..295271f5020 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -1,5 +1,5 @@ --- -title: "C++ conformance improvements in Microsoft C/C++ (MSVC)" +title: "C/C++ conformance improvements in Microsoft C++ (MSVC) Build Tools" description: "Summary of conformance improvements in Microsoft C/C++ (MSVC)" ms.date: 11/03/2025 ms.service: "visual-cpp" From e40fba6ab7dc1be1820090c27ad82f8042cf2d0c Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 3 Nov 2025 15:15:38 -0800 Subject: [PATCH 1413/1799] Apply suggestion from @AugP Co-authored-by: Augustin Popa --- docs/overview/msvc-conformance-improvements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 295271f5020..b9445b5ea91 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -20,7 +20,7 @@ For changes in earlier versions of Visual Studio: ## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.50 -MSVC Build Tools v14.50 introduces improvements to the MSVC compiler and Standard Library, including better C++23 standards conformance, enhanced reliability, and improved correctness. This release also includes numerous bug fixes and updates that benefit large-scale C++ development. +MSVC Build Tools v14.50 introduces improvements to the MSVC compiler and standard library, including better C++23 standards conformance, enhanced reliability, and improved correctness. This release also includes numerous bug fixes and updates that benefit large-scale C++ development. This version shipped first with Visual Studio 2026 version 18.0 and includes version 19.50 of the MSVC compiler. From aef34336c6e34e49133c41f1b597edbe14ef0e81 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Mon, 3 Nov 2025 15:15:48 -0800 Subject: [PATCH 1414/1799] Apply suggestion from @AugP Co-authored-by: Augustin Popa --- docs/overview/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/toc.yml b/docs/overview/toc.yml index e302eaf22c4..a8036cb6331 100644 --- a/docs/overview/toc.yml +++ b/docs/overview/toc.yml @@ -12,7 +12,7 @@ items: href: ../overview/what-s-new-for-cpp-2019.md - name: What's new for C++ in Visual Studio 2017 href: ../overview/what-s-new-for-cpp-2017.md - - name: C++ Conformance improvements in Microsoft C/C++ (MSVC) + - name: C/C++ conformance improvements in Microsoft C++ (MSVC) Build Tools href: ../overview/msvc-conformance-improvements.md - name: C++ conformance improvements in Visual Studio 2022 href: ../overview/cpp-conformance-improvements.md From 1ffdd95d2fa659acf1cab706f81756bb2d98e853 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 3 Nov 2025 17:58:36 -0800 Subject: [PATCH 1415/1799] draft --- .../media/clang-tidy-improvements.png | Bin 0 -> 96485 bytes .../media/inline-post-return-value.png | Bin 0 -> 5098 bytes docs/overview/toc.yml | 2 + docs/overview/what-s-new-for-msvc.md | 56 ++++++++++++++++++ ...t-s-new-for-visual-cpp-in-visual-studio.md | 12 +++- 5 files changed, 68 insertions(+), 2 deletions(-) create mode 100644 docs/overview/media/clang-tidy-improvements.png create mode 100644 docs/overview/media/inline-post-return-value.png create mode 100644 docs/overview/what-s-new-for-msvc.md diff --git a/docs/overview/media/clang-tidy-improvements.png b/docs/overview/media/clang-tidy-improvements.png new file mode 100644 index 0000000000000000000000000000000000000000..fe999aa53607e891cdbe470af1bf2e8b64061bf9 GIT binary patch literal 96485 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 Code Analysis > Clang-Tidy**. ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments.](./media/clang-tidy-improvements.png) +- Inline post-return values: The Visual Studio debugger now shows the actual return values of functions. This provides real-time visibility into function behavior without stepping into code or setting up watches, making it faster to catch logic issues or unexpected results. ![Screenshot showing inline post-return values displayed in the debugger next to function call."](./media/inline-post-return-value.png) + + +## Feedback and suggestions + +We'd love to hear from you! You can [Report a Problem or Suggest a Feature](/visualstudio/ide/how-to-report-a-problem-with-visual-studio) by using the Send Feedback icon in the upper right-hand corner of either the installer or the Visual Studio IDE, or from **Help** > **Send Feedback**. You can track your issues by using [Visual Studio Developer Community](https://developercommunity.visualstudio.com/), where you add comments or find solutions. You can also get free installation help through our [Live Chat support](https://visualstudio.microsoft.com/vs/support/#talktous). + +## Blogs + +Take advantage of the insights and recommendations available in the [Microsoft Developer Blogs](https://devblogs.microsoft.com/) site to stay up to date on all new releases. The blogs include deep dive posts on a broad range of features. The [C++ Team Blog](https://devblogs.microsoft.com/cppblog) and the [Visual Studio Blog](https://devblogs.microsoft.com/visualstudio) are of particular interest. \ No newline at end of file diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index 4f546d1d8c0..bc91e056b54 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -1,14 +1,22 @@ --- title: "What's new for C++ in Visual Studio" description: "The new features and fixes in the Microsoft C/C++ compiler and tools in Visual Studio." -ms.date: 05/13/2025 +ms.date: 11/03/2025 ms.service: "visual-cpp" ms.subservice: "ide" ms.custom: intro-whats-new ai-usage: ai-assisted --- -# What's new for C++ in Visual Studio 2022 +# What's new for C++ in Visual Studio + +Microsoft C++ Build Tools (MSVC Build Tools) versioning is no longer synchronized with Visual Studio versioning starting with Visual Studio 2026 version 18.0 and Microsoft C++ Build Tools version 14.50. For the latest updates to MSVC, see [What's new for MSVC](/cpp/overview/what-s-new-for-msvc.md). + +## What's new for C++ in Visual Studio 2026 + +VS 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2, which have stopped receiving security updates. + +## What's new for C++ in Visual Studio 2022 Visual Studio 2022 brings many updates and fixes to the Microsoft C++ compiler and tools. The Visual Studio IDE also offers significant improvements in performance and productivity, and now runs natively as a 64-bit application. From 9411f01110d4cf1deefd42dedf74a8eb9998dc09 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Mon, 3 Nov 2025 19:34:09 -0800 Subject: [PATCH 1416/1799] draft --- ...t-a-problem-with-the-visual-cpp-toolset.md | 2 +- .../media/cpp-preprocess-menu-entry.png | Bin 0 -> 18018 bytes docs/overview/what-s-new-for-msvc.md | 29 ++++++++++-------- 3 files changed, 18 insertions(+), 13 deletions(-) create mode 100644 docs/overview/media/cpp-preprocess-menu-entry.png diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index 813d310ea09..8148e7c834b 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -3,7 +3,7 @@ title: "How to report a problem with the Microsoft C++ Build Tools" description: How to create a good problem report and repro information for the Microsoft C++ toolset. ms.date: "09/24/2019" ms.service: "visual-cpp" -ms.subservice: "ide" +ms.subservice: "cpp-lang" author: "tylermsft" ms.author: "twhitney" --- diff --git a/docs/overview/media/cpp-preprocess-menu-entry.png b/docs/overview/media/cpp-preprocess-menu-entry.png new file mode 100644 index 0000000000000000000000000000000000000000..59f45d3bc6a28fa0165a4776d1533806934b1b28 GIT binary patch literal 18018 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 literal 0 HcmV?d00001 diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 46580f85556..5208f15459b 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -3,7 +3,7 @@ title: "What's new for MSVC" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." ms.date: 11/03/2025 ms.service: "visual-cpp" -ms.subservice: "compiler" +ms.subservice: "cpp-lang" ms.custom: intro-whats-new --- @@ -31,19 +31,24 @@ A quick highlight of some of the new features: With this release, the Build Tools no longer target: - Windows 7 / Windows Server 2008 R2 - Windows 8 / Windows Server 2012 - Windows 8.1 / Windows Server 2012 R2 + - Windows 7 / Windows Server 2008 R2 + - Windows 8 / Windows Server 2012 + - Windows 8.1 / Windows Server 2012 R2 To build applications using the latest C++ tools, your target platform must be Windows 10 or Windows Server 2016 (or later). These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. -- Notices of removals for C++AMP, ARM32 toolchain, and `/DEBUG:FASTLINK` and the deprecation of `/await`: - The deprecations and removal of C++ feature support impact developers using C++AMP, ARM32-targeting MSVC build tools, and the `/DEBUG:FASTLINK` linker option. - If you're using `/DEBUG:FASTLINK`, switch to `/DEBUG:FULL` for improved debugging support. - To target ARM32, continue using the Visual Studio 2022 v143 build tools. For more information, see [Side-by-side Minor Version MSVC Toolsets in Visual Studio 2019](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). - - Moreover, the /await switch is deprecated and will be removed in a future release. Developers are encouraged to use Standard C++ coroutines, available by default in C++20 or later. For projects in earlier language modes, consider using /await:strict to maintain compatibility until the switch is removed. - - Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. We've updated GitHub Copilot to include other relevant files as context. This reduces hallucinations while offering more relevant and accurate suggestions. It's aligned with the current GitHub Copilot experience for C++ in VS Code. - - Clang-Tidy code analysis improvements supercharge your C++ code analysis with enhanced configuration options for faster builds and custom workflows. Code analysis has new configuration options. You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. Access these powerful new options from **Project Properties > Code Analysis > Clang-Tidy**. ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments.](./media/clang-tidy-improvements.png) + +- C++20 is the default for new Console App, Windows Desktop Application, Dynamic-Link Library, and Static Library C++ projects. +- Easily set debugger command line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without needing to install any additional workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio). +- C++ Standard Library + - addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) multiline option should be added to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450-insiders). +- Generate preprocessed output for any C++ file. In Visual Studio, right-click a C++ file to instantly generate its preprocessed output, making it easy to debug macros and includes, and see errors immediately. ![Screenshot showing the right-click context menu for a C++ file with the Preprocess option highlighted.](./media/cpp-preprocess-menu-entry.png) +- In the Visual Studio installer, the C++ Linux workload is renamed to 'Linux, Mac, and embedded development with C++'. +- The following have been removed: C++AMP, ARM32 toolchain, and `/DEBUG:FASTLINK`. + - If you use `/DEBUG:FASTLINK`, switch to `/DEBUG:FULL` for improved debugging support. + - To target ARM32, continue using the Visual Studio 2022 v143 build tools. For more information, see [Side-by-side Minor Version MSVC Toolsets in Visual Studio 2019](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). +- The `/await` switch is deprecated and will be removed in a future release. Use Standard C++ coroutines, available by default in C++20 or later. For projects in earlier language modes, consider using `/await:strict` to maintain compatibility until the switch is removed. +- Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. We've updated GitHub Copilot to include other relevant files as context. This reduces hallucinations while offering more relevant and accurate suggestions. It's aligned with the current GitHub Copilot experience for C++ in VS Code. +- Clang-Tidy code analysis improvements supercharge your C++ code analysis with enhanced configuration options for faster builds and custom workflows. Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. Access these powerful new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). - Inline post-return values: The Visual Studio debugger now shows the actual return values of functions. This provides real-time visibility into function behavior without stepping into code or setting up watches, making it faster to catch logic issues or unexpected results. ![Screenshot showing inline post-return values displayed in the debugger next to function call."](./media/inline-post-return-value.png) From 78cbfeda249618aec4d321499ada273f1e37cf02 Mon Sep 17 00:00:00 2001 From: Mahmoud Saleh <12202790+MahmoudGSaleh@users.noreply.github.com> Date: Tue, 4 Nov 2025 09:58:42 -0800 Subject: [PATCH 1417/1799] Update docs/windows/latest-supported-vc-redist.md Co-authored-by: Augustin Popa --- docs/windows/latest-supported-vc-redist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/windows/latest-supported-vc-redist.md b/docs/windows/latest-supported-vc-redist.md index cf273a8b073..67d25d2f0f0 100644 --- a/docs/windows/latest-supported-vc-redist.md +++ b/docs/windows/latest-supported-vc-redist.md @@ -36,7 +36,7 @@ To find the download you need, choose your version of Visual Studio from the tab Redistribution is permitted only for licensed Visual Studio users, as described in the [Visual Studio license terms](https://visualstudio.microsoft.com/license-terms/). For details on redistributing Visual C++ files, see [Redistributing Visual C++ Files](redistributing-visual-cpp-files.md). -A Visual C++ Redistributable installs Microsoft C and C++ (MSVC) runtime libraries. Many applications built using Microsoft C and C++ (MSVC) build tools require these libraries. If your app is built using those libraries, a Microsoft Visual C++ Redistributable package at least as recent as the MSVC build toolset used to build your app must be installed on the target system along with the app. The Redistributable package architecture must match your app's target architecture (you can't install an ARM64 redistributable on an x86 system, or an x64 redistributable on an x86 system, for example). We recommend you use the latest Redistributable available for your version of Visual Studio. +A Visual C++ Redistributable installs Microsoft C and C++ runtime libraries. Many applications built using Microsoft C++ (MSVC) Build Tools require these libraries. If your app is built using those libraries, a Microsoft Visual C++ Redistributable package at least as recent as the build tools used to build your app must be installed on the target system along with the app. The Redistributable package architecture must match your app's target architecture (you can't install an ARM64 redistributable on an x86 system, or an x64 redistributable on an x86 system, for example). We recommend you use the latest Redistributable available for your version of Visual Studio. ## Visual C++ Redistributable v14 From f51928bbcd32dfd12f9cc858193fe89e76269593 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 10:49:57 -0800 Subject: [PATCH 1418/1799] tech review --- docs/overview/msvc-conformance-improvements.md | 10 +++++----- docs/overview/visual-cpp-language-conformance.md | 16 +++++++--------- 2 files changed, 12 insertions(+), 14 deletions(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index b9445b5ea91..3957ac7e613 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -172,7 +172,7 @@ Improved adherence to C++ standards includes better handling of attributes, temp ### C++20 and C++23 Features -- Enhanced [multidimensional operator[] support](https://developercommunity.visualstudio.com/t/Multidimensional-operator-with-Wall-r/10876026) +- Enhanced [multidimensional `operator[]` support](https://developercommunity.visualstudio.com/t/Multidimensional-operator-with-Wall-r/10876026) - Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731) ### Smaller conformance updates @@ -186,7 +186,7 @@ MSVC Build Tools v14.50 includes numerous smaller conformance improvements that - [CWG2507](https://cplusplus.github.io/CWG/issues/2507): Default arguments for `operator[]` support - [CWG2585](https://cplusplus.github.io/CWG/issues/2585): Behavior alignment with standard requirements - [CWG2521](https://cplusplus.github.io/CWG/issues/2521): Deprecation of 'operator string-literal identifier' -- [CWG2528](https://www.open-std.org/jtc1/sc22/wg21/docs/cwg_defects.html#2528): Relaxed conversion rules for the spaceship operator +- [CWG2528](https://cplusplus.github.io/CWG/issues/2528): Relaxed conversion rules for the spaceship operator - [P2360R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2360r0.html): Extended init-statement definition to allow alias-declarations - [P2290R3](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2290r3.pdf): C++23 hexadecimal/octal delimited escape sequence support in string literals - [P2797R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2023/p2797r0.html): Resolution for CWG2692 regarding static and explicit object member functions with the same parameter-type-lists @@ -194,13 +194,13 @@ MSVC Build Tools v14.50 includes numerous smaller conformance improvements that ## Bug fixes -Bug fixes for C++ Modules, `constexpr`, and other fixes were made in MSVC v14.50. +Bug fixes for C++ Modules, `constexpr`, and other fixes were made in MSVC Build Tools v14.50. For a detailed list of bug fixes, see [Compiler Improvements in v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#compiler-improvements-in-v14.50). **Encoding of certain nontype template arguments corrected** -Affects `/stdc++20` or later. +Affects `/std:c++20` or later. Certain nontype pointer type template arguments involving subobjects could lead to linking issues or in some cases silent bad code generation where what should be distinct specializations collide. @@ -261,7 +261,7 @@ When upgrading to MSVC Build Tools v14.50, consider the following potential brea ## Provide feedback -For the latest updates and to provide feedback, visit the [Visual Studio Developer Community](https://developercommunity.visualstudio.com/) or contact the team at [visualcpp@microsoft.com](mailto:visualcpp@microsoft.com). Follow us on Twitter [@visualc](https://twitter.com/visualc) or BlueSky [@msftcpp.bsky.social](https://bsky.app/profile/msftcpp.bsky.social). +For the latest updates and to provide feedback, visit the [Visual Studio Developer Community](https://developercommunity.visualstudio.com/) or contact the team at [visualcpp@microsoft.com](mailto:visualcpp@microsoft.com). Follow us on X [@visualc](https://x.com/visualc) or BlueSky [@msftcpp.bsky.social](https://bsky.app/profile/msftcpp.bsky.social). If you encounter problems with MSVC in Visual Studio 2026, please let us know via the [Report a Problem](how-to-report-a-problem-with-the-visual-cpp-toolset.md) option, either from the installer or the Visual Studio IDE itself. diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index f77670f7701..5d3bdc12511 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -197,11 +197,9 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P2173R1 Attributes on Lambda-Expressions`](https://wg21.link/p2173r1) | no | |  [`P2186R2 Remove Garbage Collection Support`](https://wg21.link/p2186r2) | VS 2022 17.0 [23](#note_23) | |  [`P2201R1 Mixed string literal concatenation`](https://wg21.link/p2201r1) | no | -|  [`P2266R1 Simpler implicit move`](https://wg21.link/p2266r1) | MSVC 14.50 [24](#note_24) | |  [`P2223R2 Trimming whitespaces before line splicing`](https://wg21.link/p2223r2) | no | |  [`P2242R3 Non-literal variables (and labels and gotos) in constexpr functions`](https://wg21.link/p2242r3) | no | |  [`P2246R1 Character encoding of diagnostic text`](https://wg21.link/p2246r1) | VS 2022 17.0 [23](#note_23) | -|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | no | |  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | no | |  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | no | |  [`P2295R6 Support for UTF-8 as a portable source file encoding`](https://wg21.link/p2295r6) | no | @@ -477,22 +475,22 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P2166R1 Prohibit basic_string and basic_string_view from being constructed from nullptr`](https://wg21.link/P2166R1) | VS 2022 17.0 [23](#note_23), [R](#note_R) | |  [`P2186R2 Removed garbage collection support`](https://wg21.link/P2186R2) | VS 2022 17.0 [23](#note_23), [Q](#note_Q) | |  [`P2251R1 Require span And basic_string_view To Be Trivially Copyable`](https://wg21.link/p2251r1) | VS 2022 17.1 [23](#note_23) | -|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | MSVC 14.50 [24](#note_24) | +|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | MSVC 19.50 [24](#note_24) | |  [`P2273R3 constexpr unique_ptr`](https://wg21.link/p2273r3) | VS 2022 17.3 [23](#note_23) | -|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC 14.50 [24](#note_24) | -|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC 14.50 [24](#note_24) | +|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC 19.50 [24](#note_24) | +|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC 19.50 [24](#note_24) | |  [`P2291R3 constexpr Integral `](https://wg21.link/p2291r3) | VS 2022 17.4 [23](#note_23) | |  [`P2302R4 ranges::contains, ranges::contains_subrange`](https://wg21.link/p2302r4) | VS 2022 17.4 [23](#note_23) | |  [`P2321R2 std::zip`](https://wg21.link/p2321r2) | partial in VS 2022 17.5 [23](#note_23) | |  [`P2322R6 ranges::fold_left, ranges::fold_right, etc.`](https://wg21.link/p2322r6) | VS 2022 17.5 [23](#note_23) | -|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC 14.50 [24](#note_24) | +|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC 19.50 [24](#note_24) | |  [`P2387R3 Pipe Support For User-Defined Range Adaptors`](https://wg21.link/p2387r3) | VS 2022 17.4 [23](#note_23) | |  [`P2393R1 Cleaning Up Integer-Class Types`](https://wg21.link/p2393r1) | VS 2022 17.2 [23](#note_23) | |  [`P2401R0 Conditional noexcept For exchange()`](https://wg21.link/p2401r0) | VS 2022 17.1 [23](#note_23) | |  [`P2408R5 Ranges Iterators As Inputs To Non-Ranges Algorithms`](https://wg21.link/p2408r5) | VS 2022 17.4 [23](#note_23) | |  [`P2417R2 More constexpr bitset`](https://wg21.link/p2417r2) | VS 2022 17.4 [23](#note_23) | |  [`P2419R2 Clarify Handling Of Encodings In Localized Formatting Of chrono Types`](https://wg21.link/p2419r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC 14.50 [24](#note_24) | +|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC 19.50 [24](#note_24) | |  [`P2438R2 string::substr() &&`](https://wg21.link/p2438r2) | VS 2022 17.4 [23](#note_23) | |  [`P2440R1 ranges::iota, ranges::shift_left, ranges::shift_right`](https://wg21.link/p2440r1) | VS 2022 17.4 [23](#note_23) | |  [`P2441R2 views::join_with`](https://wg21.link/p2441r2) | VS 2022 17.4 [23](#note_23) | @@ -577,7 +575,7 @@ A group of papers listed together indicates a Standard feature along with one or **VS 2022 17.3** Supported in Visual Studio 2022 version 17.3.\ **VS 2022 17.4** Supported in Visual Studio 2022 version 17.4.\ **VS 2022 17.5** Supported in Visual Studio 2022 version 17.5.\ -**MSVC 14.50** Supported in MSVC Compiler 14.50 and beyond. Support first shipped with Visual Studio 2026 18.0. +**MSVC 19.50** Supported in MSVC Compiler 19.50 and beyond. Support first shipped with Visual Studio 2026 18.0. ### Notes @@ -648,7 +646,7 @@ These algorithms aren't presently parallelized: **23** In Visual Studio 2022 version 17.0 and up, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. - **24** In MSVC 14.50 and up, first shipped with Visual Studio 2026 version 18.0, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. + **24** In MSVC 19.50 and up, first shipped with Visual Studio 2026 version 18.0, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. **C11** Compiler support for C11 and C17 requires Visual Studio 2019 version 16.8 or higher. Except as noted, C11 and C17 library support requires Windows SDK build 10.0.20211.0 or higher. For more information on how to install support for C11 and C17, see [Install C11 and C17 support in Visual Studio](./install-c17-support.md). From d37dabd62f18579702b1d0735d7cf8c0ace32a10 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 11:06:34 -0800 Subject: [PATCH 1419/1799] edit --- docs/overview/visual-cpp-language-conformance.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 5d3bdc12511..28ed3a00834 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -475,7 +475,6 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P2166R1 Prohibit basic_string and basic_string_view from being constructed from nullptr`](https://wg21.link/P2166R1) | VS 2022 17.0 [23](#note_23), [R](#note_R) | |  [`P2186R2 Removed garbage collection support`](https://wg21.link/P2186R2) | VS 2022 17.0 [23](#note_23), [Q](#note_Q) | |  [`P2251R1 Require span And basic_string_view To Be Trivially Copyable`](https://wg21.link/p2251r1) | VS 2022 17.1 [23](#note_23) | -|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | MSVC 19.50 [24](#note_24) | |  [`P2273R3 constexpr unique_ptr`](https://wg21.link/p2273r3) | VS 2022 17.3 [23](#note_23) | |  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC 19.50 [24](#note_24) | |  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC 19.50 [24](#note_24) | From 494e814a7fdf373217d9e4d2564a3554657f185c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 12:51:04 -0800 Subject: [PATCH 1420/1799] nit --- docs/overview/msvc-conformance-improvements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md index 3957ac7e613..e9f57255dfa 100644 --- a/docs/overview/msvc-conformance-improvements.md +++ b/docs/overview/msvc-conformance-improvements.md @@ -1,5 +1,5 @@ --- -title: "C/C++ conformance improvements in Microsoft C++ (MSVC) Build Tools" +title: "/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools" description: "Summary of conformance improvements in Microsoft C/C++ (MSVC)" ms.date: 11/03/2025 ms.service: "visual-cpp" From aa7fd26896e9594827664fa5b1b3a17770b804e7 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 13:53:08 -0800 Subject: [PATCH 1421/1799] draft --- docs/overview/what-s-new-for-msvc.md | 10 +++++----- .../what-s-new-for-visual-cpp-in-visual-studio.md | 8 ++------ 2 files changed, 7 insertions(+), 11 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 5208f15459b..a36f1347bff 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -12,15 +12,14 @@ ms.custom: intro-whats-new Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and tools. - For more information on what's new in all of Visual Studio, see [What's new in Visual Studio](/visualstudio/ide/whats-new-visual-studio). -- For information about version build dates, see [Visual Studio 2022 Release History](/visualstudio/releases/2022/release-history). -## What's new for MSVC version 14.50 +## What's new for MSVC Build Tools version 14.50 -*Released November 2025* +* Introduced in Visual Studio 2026 version 18.0 Released November 2025.* -| For more information about | See | +| For detailed information about | See | |---|---| -| What's new for C++ developers | [Augustin blog TBD](augustin blog) | +| What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2026 version 18.0](augustin blog TBD) | | Standard Library (STL) merged C++26 and C++23 features, Language Working Group (CWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog MSVC Build Tools 14.50](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450) | | C++ language updates | [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) | | C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.14](cpp-conformance-improvements.md#improvements_1714) | @@ -28,6 +27,7 @@ Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and to A quick highlight of some of the new features: - The minimum supported operating systems for the MSVC Build Tools are Windows 10 or Windows Server 2016. + - VS 2026 18.0 and later, MSVC Build Tools 14.50 no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2, which have stopped receiving security updates. With this release, the Build Tools no longer target: diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index bc91e056b54..e83c9246a0b 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -1,7 +1,7 @@ --- title: "What's new for C++ in Visual Studio" description: "The new features and fixes in the Microsoft C/C++ compiler and tools in Visual Studio." -ms.date: 11/03/2025 +ms.date: 11/04/2025 ms.service: "visual-cpp" ms.subservice: "ide" ms.custom: intro-whats-new @@ -10,11 +10,7 @@ ai-usage: ai-assisted # What's new for C++ in Visual Studio -Microsoft C++ Build Tools (MSVC Build Tools) versioning is no longer synchronized with Visual Studio versioning starting with Visual Studio 2026 version 18.0 and Microsoft C++ Build Tools version 14.50. For the latest updates to MSVC, see [What's new for MSVC](/cpp/overview/what-s-new-for-msvc.md). - -## What's new for C++ in Visual Studio 2026 - -VS 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2, which have stopped receiving security updates. +Microsoft C++ Build Tools (MSVC Build Tools) versioning is no longer synchronized with Visual Studio versioning starting with Visual Studio 2026 version 18.0 and Microsoft C++ Build Tools version 14.50. For the latest updates to MSVC going forward, see [What's new for MSVC](/cpp/overview/what-s-new-for-msvc.md). ## What's new for C++ in Visual Studio 2022 From bddf26c556b34d63af5c777b7650c95b9e308be4 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 13:58:42 -0800 Subject: [PATCH 1422/1799] edit --- docs/overview/visual-cpp-language-conformance.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index 28ed3a00834..d1414adf473 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ language conformance" description: "Microsoft C and C++ conformance updates by Visual Studio version." -ms.date: 11/03/2025 +ms.date: 11/04/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- @@ -476,20 +476,20 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P2186R2 Removed garbage collection support`](https://wg21.link/P2186R2) | VS 2022 17.0 [23](#note_23), [Q](#note_Q) | |  [`P2251R1 Require span And basic_string_view To Be Trivially Copyable`](https://wg21.link/p2251r1) | VS 2022 17.1 [23](#note_23) | |  [`P2273R3 constexpr unique_ptr`](https://wg21.link/p2273r3) | VS 2022 17.3 [23](#note_23) | -|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC 19.50 [24](#note_24) | -|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC 19.50 [24](#note_24) | +|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC Build Tools version 14.5 [24](#note_24) | +|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC Build Tools version 14.5 [24](#note_24) | |  [`P2291R3 constexpr Integral `](https://wg21.link/p2291r3) | VS 2022 17.4 [23](#note_23) | |  [`P2302R4 ranges::contains, ranges::contains_subrange`](https://wg21.link/p2302r4) | VS 2022 17.4 [23](#note_23) | |  [`P2321R2 std::zip`](https://wg21.link/p2321r2) | partial in VS 2022 17.5 [23](#note_23) | |  [`P2322R6 ranges::fold_left, ranges::fold_right, etc.`](https://wg21.link/p2322r6) | VS 2022 17.5 [23](#note_23) | -|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC 19.50 [24](#note_24) | +|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC Build Tools version 14.5 [24](#note_24) | |  [`P2387R3 Pipe Support For User-Defined Range Adaptors`](https://wg21.link/p2387r3) | VS 2022 17.4 [23](#note_23) | |  [`P2393R1 Cleaning Up Integer-Class Types`](https://wg21.link/p2393r1) | VS 2022 17.2 [23](#note_23) | |  [`P2401R0 Conditional noexcept For exchange()`](https://wg21.link/p2401r0) | VS 2022 17.1 [23](#note_23) | |  [`P2408R5 Ranges Iterators As Inputs To Non-Ranges Algorithms`](https://wg21.link/p2408r5) | VS 2022 17.4 [23](#note_23) | |  [`P2417R2 More constexpr bitset`](https://wg21.link/p2417r2) | VS 2022 17.4 [23](#note_23) | |  [`P2419R2 Clarify Handling Of Encodings In Localized Formatting Of chrono Types`](https://wg21.link/p2419r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC 19.50 [24](#note_24) | +|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2438R2 string::substr() &&`](https://wg21.link/p2438r2) | VS 2022 17.4 [23](#note_23) | |  [`P2440R1 ranges::iota, ranges::shift_left, ranges::shift_right`](https://wg21.link/p2440r1) | VS 2022 17.4 [23](#note_23) | |  [`P2441R2 views::join_with`](https://wg21.link/p2441r2) | VS 2022 17.4 [23](#note_23) | @@ -574,7 +574,7 @@ A group of papers listed together indicates a Standard feature along with one or **VS 2022 17.3** Supported in Visual Studio 2022 version 17.3.\ **VS 2022 17.4** Supported in Visual Studio 2022 version 17.4.\ **VS 2022 17.5** Supported in Visual Studio 2022 version 17.5.\ -**MSVC 19.50** Supported in MSVC Compiler 19.50 and beyond. Support first shipped with Visual Studio 2026 18.0. +**MSVC Build Tools version 14.50** Supported in Visual Studio 2026 18.0 (MSVC compiler version 19.50) and up. ### Notes @@ -645,7 +645,7 @@ These algorithms aren't presently parallelized: **23** In Visual Studio 2022 version 17.0 and up, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. - **24** In MSVC 19.50 and up, first shipped with Visual Studio 2026 version 18.0, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. + **24** In MSVC Build Tools version 14.50 and up (first shipped with Visual Studio 2026 version 18.0), these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. **C11** Compiler support for C11 and C17 requires Visual Studio 2019 version 16.8 or higher. Except as noted, C11 and C17 library support requires Windows SDK build 10.0.20211.0 or higher. For more information on how to install support for C11 and C17, see [Install C11 and C17 support in Visual Studio](./install-c17-support.md). From 1ea8e4d0299467f6ae8e0a1c4fb0e33a72e972ea Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 14:39:18 -0800 Subject: [PATCH 1423/1799] draft --- docs/overview/what-s-new-for-msvc.md | 50 ++++++++++++++++++---------- 1 file changed, 32 insertions(+), 18 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index a36f1347bff..2c09ae652e5 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -15,42 +15,56 @@ Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and to ## What's new for MSVC Build Tools version 14.50 -* Introduced in Visual Studio 2026 version 18.0 Released November 2025.* +* Introduced in Visual Studio 2026 version 18.0 released November 2025.* + +Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools version 14.50, which offers the best conformance, build performance, and runtime performance story yet. To access to all the new language features, build with `/std:c++latest`, or use `/std:c++23preview` if you want to be restricted to just features up until C++23. | For detailed information about | See | |---|---| | What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2026 version 18.0](augustin blog TBD) | -| Standard Library (STL) merged C++26 and C++23 features, Language Working Group (CWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog MSVC Build Tools 14.50](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450) | +| Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.50](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450) | | C++ language updates | [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) | | C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.14](cpp-conformance-improvements.md#improvements_1714) | A quick highlight of some of the new features: -- The minimum supported operating systems for the MSVC Build Tools are Windows 10 or Windows Server 2016. - - VS 2026 18.0 and later, MSVC Build Tools 14.50 no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2, which have stopped receiving security updates. - - With this release, the Build Tools no longer target: - - - Windows 7 / Windows Server 2008 R2 - - Windows 8 / Windows Server 2012 - - Windows 8.1 / Windows Server 2012 R2 - - To build applications using the latest C++ tools, your target platform must be Windows 10 or Windows Server 2016 (or later). These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. - - C++20 is the default for new Console App, Windows Desktop Application, Dynamic-Link Library, and Static Library C++ projects. -- Easily set debugger command line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without needing to install any additional workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio). +- C++23 preprocessing directive `#warning` allows you to generate a diagnostic message without stopping translation the way `#error` does. For more information, see [#warning directive](/cpp/preprocessor/hash-warning-directive-c-cpp) for more information. +- Easily set debugger command line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without installing any other workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio). - C++ Standard Library - addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) multiline option should be added to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450-insiders). + - Added and improved vectorized implementations of many types and functions. +- GitHub Copilot: + - Copilot Chat allows you to use natural language to get answers to questions (Ask mode) or even implement changes for you automatically (Agent Mode). + - Copilot Chat is smarter with improved context for everyday tasks. Expect better results when searching your codebase and referencing specific lines in your code. + - A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments or unit tests, and so on. +- Visual Studio 2026 now includes CMake 4.1.2 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, allowing you to build Visual Studio C++ projects directly from CMake. +- Compiler back-end runtime performance improvements. +- AddressSanitizer support for ARM64 Builds (Preview). - Generate preprocessed output for any C++ file. In Visual Studio, right-click a C++ file to instantly generate its preprocessed output, making it easy to debug macros and includes, and see errors immediately. ![Screenshot showing the right-click context menu for a C++ file with the Preprocess option highlighted.](./media/cpp-preprocess-menu-entry.png) - In the Visual Studio installer, the C++ Linux workload is renamed to 'Linux, Mac, and embedded development with C++'. -- The following have been removed: C++AMP, ARM32 toolchain, and `/DEBUG:FASTLINK`. - - If you use `/DEBUG:FASTLINK`, switch to `/DEBUG:FULL` for improved debugging support. - - To target ARM32, continue using the Visual Studio 2022 v143 build tools. For more information, see [Side-by-side Minor Version MSVC Toolsets in Visual Studio 2019](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). -- The `/await` switch is deprecated and will be removed in a future release. Use Standard C++ coroutines, available by default in C++20 or later. For projects in earlier language modes, consider using `/await:strict` to maintain compatibility until the switch is removed. - Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. We've updated GitHub Copilot to include other relevant files as context. This reduces hallucinations while offering more relevant and accurate suggestions. It's aligned with the current GitHub Copilot experience for C++ in VS Code. - Clang-Tidy code analysis improvements supercharge your C++ code analysis with enhanced configuration options for faster builds and custom workflows. Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. Access these powerful new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). - Inline post-return values: The Visual Studio debugger now shows the actual return values of functions. This provides real-time visibility into function behavior without stepping into code or setting up watches, making it faster to catch logic issues or unexpected results. ![Screenshot showing inline post-return values displayed in the debugger next to function call."](./media/inline-post-return-value.png) +**Deprecations and Removals** + +- The minimum supported operating systems for the MSVC Build Tools version 14.50 are Windows 10 or Windows Server 2016. +- MSVC Build Tools version 14.50 no longer target: + + - Windows 7 / Windows Server 2008 R2 + - Windows 8 / Windows Server 2012 + - Windows 8.1 / Windows Server 2012 R2 + + To build applications using the latest C++ tools, your target platform must be Windows 10 or Windows Server 2016 (or later). These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. + +- The `/await` switch is deprecated, no longer receives support, and will be removed in a future release. Use Standard C++ coroutines, available by default in C++20 or later. For projects in earlier language modes, consider using `/await:strict` to maintain compatibility until the switch is removed. + +**The following features have been removed and are no longer available:** + +- C++AMP +- ARM32 toolchain: if you still need to build for ARM32, use an older version of the MSVC Build Tools. For more information, see [Side-by-side Minor Version MSVC Toolsets in Visual Studio 2019](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). +- `/DEBUG:FASTLINK` compiler switch. Use to `/DEBUG:FULL` for improved debugging support. ## Feedback and suggestions From 90853511825257511374386ec0955cd707896460 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 14:46:21 -0800 Subject: [PATCH 1424/1799] draft --- docs/overview/what-s-new-for-msvc.md | 8 ++++---- .../what-s-new-for-visual-cpp-in-visual-studio.md | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 2c09ae652e5..db7ff8cd8a1 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -29,10 +29,10 @@ Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools vers A quick highlight of some of the new features: - C++20 is the default for new Console App, Windows Desktop Application, Dynamic-Link Library, and Static Library C++ projects. -- C++23 preprocessing directive `#warning` allows you to generate a diagnostic message without stopping translation the way `#error` does. For more information, see [#warning directive](/cpp/preprocessor/hash-warning-directive-c-cpp) for more information. -- Easily set debugger command line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without installing any other workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio). +- C++23 preprocessing directive `#warning` allows you to generate a diagnostic message without stopping translation the way `#error` does. For more information, see [`#warning` directive](/cpp/preprocessor/hash-warning-directive-c-cpp). +- Easily set debugger command line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without installing any other workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio&preserve-view=true). - C++ Standard Library - - addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) multiline option should be added to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450-insiders). + - `` addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) multiline option should be added to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450-insiders). - Added and improved vectorized implementations of many types and functions. - GitHub Copilot: - Copilot Chat allows you to use natural language to get answers to questions (Ask mode) or even implement changes for you automatically (Agent Mode). @@ -42,7 +42,7 @@ A quick highlight of some of the new features: - Compiler back-end runtime performance improvements. - AddressSanitizer support for ARM64 Builds (Preview). - Generate preprocessed output for any C++ file. In Visual Studio, right-click a C++ file to instantly generate its preprocessed output, making it easy to debug macros and includes, and see errors immediately. ![Screenshot showing the right-click context menu for a C++ file with the Preprocess option highlighted.](./media/cpp-preprocess-menu-entry.png) -- In the Visual Studio installer, the C++ Linux workload is renamed to 'Linux, Mac, and embedded development with C++'. +- In the Visual Studio installer, the C++ Linux workload is renamed to "Linux, Mac, and embedded development with C++". - Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. We've updated GitHub Copilot to include other relevant files as context. This reduces hallucinations while offering more relevant and accurate suggestions. It's aligned with the current GitHub Copilot experience for C++ in VS Code. - Clang-Tidy code analysis improvements supercharge your C++ code analysis with enhanced configuration options for faster builds and custom workflows. Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. Access these powerful new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). - Inline post-return values: The Visual Studio debugger now shows the actual return values of functions. This provides real-time visibility into function behavior without stepping into code or setting up watches, making it faster to catch logic issues or unexpected results. ![Screenshot showing inline post-return values displayed in the debugger next to function call."](./media/inline-post-return-value.png) diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index e83c9246a0b..491f55e9093 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -10,7 +10,7 @@ ai-usage: ai-assisted # What's new for C++ in Visual Studio -Microsoft C++ Build Tools (MSVC Build Tools) versioning is no longer synchronized with Visual Studio versioning starting with Visual Studio 2026 version 18.0 and Microsoft C++ Build Tools version 14.50. For the latest updates to MSVC going forward, see [What's new for MSVC](/cpp/overview/what-s-new-for-msvc.md). +Microsoft C++ Build Tools (MSVC Build Tools) versioning is no longer synchronized with Visual Studio versioning starting with Visual Studio 2026 version 18.0 and Microsoft C++ Build Tools version 14.50. For the latest updates to MSVC going forward, see [What's new for MSVC](what-s-new-for-msvc.md). ## What's new for C++ in Visual Studio 2022 From d0e356c701134d11c26b62b236fea0e5fe29811d Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 15:33:56 -0800 Subject: [PATCH 1425/1799] updates --- docs/overview/what-s-new-for-msvc.md | 29 +++++++++++++++------------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index db7ff8cd8a1..70255cb0d3e 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,13 +1,13 @@ --- -title: "What's new for MSVC" +title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 11/03/2025 +ms.date: 11/04/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new --- -# What's new for MSVC +# What's new for MSVC Build Tools Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and tools. @@ -26,31 +26,34 @@ Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools vers | C++ language updates | [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) | | C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.14](cpp-conformance-improvements.md#improvements_1714) | -A quick highlight of some of the new features: +**A quick highlight of some of the new features in MSVC Build Tools version 14.50 and Visual Studio 2026 version 18.0:** - C++20 is the default for new Console App, Windows Desktop Application, Dynamic-Link Library, and Static Library C++ projects. -- C++23 preprocessing directive `#warning` allows you to generate a diagnostic message without stopping translation the way `#error` does. For more information, see [`#warning` directive](/cpp/preprocessor/hash-warning-directive-c-cpp). +- C++23 preprocessing directive `#warning` allows you to generate a diagnostic message without stopping translation like `#error` does. For more information, see [`#warning` directive](/cpp/preprocessor/hash-warning-directive-c-cpp). - Easily set debugger command line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without installing any other workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio&preserve-view=true). - C++ Standard Library - - `` addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) multiline option should be added to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450-insiders). + - `` addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) added a multiline option to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450-insiders). - Added and improved vectorized implementations of many types and functions. - GitHub Copilot: - Copilot Chat allows you to use natural language to get answers to questions (Ask mode) or even implement changes for you automatically (Agent Mode). - Copilot Chat is smarter with improved context for everyday tasks. Expect better results when searching your codebase and referencing specific lines in your code. - - A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments or unit tests, and so on. -- Visual Studio 2026 now includes CMake 4.1.2 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, allowing you to build Visual Studio C++ projects directly from CMake. -- Compiler back-end runtime performance improvements. -- AddressSanitizer support for ARM64 Builds (Preview). + - A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments, unit tests, and so on. + - Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. GitHub Copilot includes other relevant files as context which reduces hallucinations while offering more relevant and accurate suggestions. +- Visual Studio 2026 now includes CMake 4.1.2 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. +- Compiler backend runtime performance improvements. +- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects targeting x64 and x86 with AddressSanitizer, which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview, - Generate preprocessed output for any C++ file. In Visual Studio, right-click a C++ file to instantly generate its preprocessed output, making it easy to debug macros and includes, and see errors immediately. ![Screenshot showing the right-click context menu for a C++ file with the Preprocess option highlighted.](./media/cpp-preprocess-menu-entry.png) - In the Visual Studio installer, the C++ Linux workload is renamed to "Linux, Mac, and embedded development with C++". -- Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. We've updated GitHub Copilot to include other relevant files as context. This reduces hallucinations while offering more relevant and accurate suggestions. It's aligned with the current GitHub Copilot experience for C++ in VS Code. -- Clang-Tidy code analysis improvements supercharge your C++ code analysis with enhanced configuration options for faster builds and custom workflows. Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. Access these powerful new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). +- Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows. + - Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. + - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). - Inline post-return values: The Visual Studio debugger now shows the actual return values of functions. This provides real-time visibility into function behavior without stepping into code or setting up watches, making it faster to catch logic issues or unexpected results. ![Screenshot showing inline post-return values displayed in the debugger next to function call."](./media/inline-post-return-value.png) +- Added IncrediBuild support for Visual Studio 2026, including the latest IncrediBuild engine and updated extension. Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2016 version 18.0. **Deprecations and Removals** - The minimum supported operating systems for the MSVC Build Tools version 14.50 are Windows 10 or Windows Server 2016. -- MSVC Build Tools version 14.50 no longer target: +- MSVC Build Tools version 14.50 no longer targets: - Windows 7 / Windows Server 2008 R2 - Windows 8 / Windows Server 2012 From 4736e77fe09d5b49ab0200c88c43b74b5341a23c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 15:43:59 -0800 Subject: [PATCH 1426/1799] categorize better --- docs/overview/what-s-new-for-msvc.md | 46 ++++++++++++++++++++-------- 1 file changed, 33 insertions(+), 13 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 70255cb0d3e..23d585521a2 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -28,29 +28,47 @@ Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools vers **A quick highlight of some of the new features in MSVC Build Tools version 14.50 and Visual Studio 2026 version 18.0:** +**C++ language enhancements** + - C++20 is the default for new Console App, Windows Desktop Application, Dynamic-Link Library, and Static Library C++ projects. - C++23 preprocessing directive `#warning` allows you to generate a diagnostic message without stopping translation like `#error` does. For more information, see [`#warning` directive](/cpp/preprocessor/hash-warning-directive-c-cpp). - Easily set debugger command line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without installing any other workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio&preserve-view=true). -- C++ Standard Library - - `` addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) added a multiline option to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450-insiders). - - Added and improved vectorized implementations of many types and functions. -- GitHub Copilot: - - Copilot Chat allows you to use natural language to get answers to questions (Ask mode) or even implement changes for you automatically (Agent Mode). - - Copilot Chat is smarter with improved context for everyday tasks. Expect better results when searching your codebase and referencing specific lines in your code. - - A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments, unit tests, and so on. - - Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. GitHub Copilot includes other relevant files as context which reduces hallucinations while offering more relevant and accurate suggestions. + +**Standard Library enhancements** + +- `` addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) added a multiline option to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450-insiders). +- Added and improved vectorized implementations of many types and functions. + +**GitHub Copilot enhancements** + +- Copilot Chat allows you to use natural language to get answers to questions (Ask mode) or even implement changes for you automatically (Agent Mode). +- Copilot Chat is smarter with improved context for everyday tasks. Expect better results when searching your codebase and referencing specific lines in your code. +- A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments, unit tests, and so on. +- Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. GitHub Copilot includes other relevant files as context which reduces hallucinations while offering more relevant and accurate suggestions. + +**Build enhancements** + - Visual Studio 2026 now includes CMake 4.1.2 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. +- Added IncrediBuild support for Visual Studio 2026, including the latest IncrediBuild engine and updated extension. Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2016 version 18.0. - Compiler backend runtime performance improvements. -- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects targeting x64 and x86 with AddressSanitizer, which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview, -- Generate preprocessed output for any C++ file. In Visual Studio, right-click a C++ file to instantly generate its preprocessed output, making it easy to debug macros and includes, and see errors immediately. ![Screenshot showing the right-click context menu for a C++ file with the Preprocess option highlighted.](./media/cpp-preprocess-menu-entry.png) -- In the Visual Studio installer, the C++ Linux workload is renamed to "Linux, Mac, and embedded development with C++". + +**Code analysis enhancements** + - Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows. - Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). +- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects targeting x64 and x86 with AddressSanitizer, which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview, + +**Productivity enhancements** + +- Generate preprocessed output for any C++ file. In Visual Studio, right-click a C++ file to instantly generate its preprocessed output, making it easy to debug macros and includes, and see errors immediately. ![Screenshot showing the right-click context menu for a C++ file with the Preprocess option highlighted.](./media/cpp-preprocess-menu-entry.png) - Inline post-return values: The Visual Studio debugger now shows the actual return values of functions. This provides real-time visibility into function behavior without stepping into code or setting up watches, making it faster to catch logic issues or unexpected results. ![Screenshot showing inline post-return values displayed in the debugger next to function call."](./media/inline-post-return-value.png) -- Added IncrediBuild support for Visual Studio 2026, including the latest IncrediBuild engine and updated extension. Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2016 version 18.0. -**Deprecations and Removals** +**Other** + +- In the Visual Studio installer, the C++ Linux workload is renamed to "Linux, Mac, and embedded development with C++". + +**Deprecations** - The minimum supported operating systems for the MSVC Build Tools version 14.50 are Windows 10 or Windows Server 2016. - MSVC Build Tools version 14.50 no longer targets: @@ -63,6 +81,8 @@ Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools vers - The `/await` switch is deprecated, no longer receives support, and will be removed in a future release. Use Standard C++ coroutines, available by default in C++20 or later. For projects in earlier language modes, consider using `/await:strict` to maintain compatibility until the switch is removed. +The mobile development and embedded and IoT development tools are now out of support. + **The following features have been removed and are no longer available:** - C++AMP From 348ffb35a866c4678f9c2de21c3d57cfa1063fdd Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 4 Nov 2025 18:56:13 -0800 Subject: [PATCH 1427/1799] Apply suggestion from @AugP Co-authored-by: Augustin Popa --- docs/overview/toc.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/toc.yml b/docs/overview/toc.yml index 564c7334231..fdccf116fd9 100644 --- a/docs/overview/toc.yml +++ b/docs/overview/toc.yml @@ -6,7 +6,7 @@ items: href: ../overview/visual-cpp-in-visual-studio.md - name: Overview of C++ development in Visual Studio href: ../overview/overview-of-cpp-development.md - - name: What's new for MSVC + - name: What's new for MSVC Build Tools href: ../overview/what-s-new-for-msvc.md - name: What's new for C++ in Visual Studio 2022 href: ../overview/what-s-new-for-visual-cpp-in-visual-studio.md From 9d81f874e6c0054b916728cbc5957018e2ad0a24 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Tue, 4 Nov 2025 18:56:29 -0800 Subject: [PATCH 1428/1799] Apply suggestion from @AugP Co-authored-by: Augustin Popa --- docs/overview/what-s-new-for-msvc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 23d585521a2..15ebfca7da3 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -9,7 +9,7 @@ ms.custom: intro-whats-new # What's new for MSVC Build Tools -Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and tools. +Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and other build tools. - For more information on what's new in all of Visual Studio, see [What's new in Visual Studio](/visualstudio/ide/whats-new-visual-studio). From eaac6ea9bfcf7e9f48cf1799e271bfb18f730152 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 18:57:47 -0800 Subject: [PATCH 1429/1799] add address --- docs/overview/what-s-new-for-msvc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 23d585521a2..395703c6ff8 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -21,7 +21,7 @@ Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools vers | For detailed information about | See | |---|---| -| What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2026 version 18.0](augustin blog TBD) | +| What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2026 version 18.0](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2026-version-18-0) | | Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.50](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450) | | C++ language updates | [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) | | C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.14](cpp-conformance-improvements.md#improvements_1714) | From 0a0f1559816f564cbc93e2d837fdcbd8fb6ca87c Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 19:00:30 -0800 Subject: [PATCH 1430/1799] edit --- docs/overview/what-s-new-for-msvc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 77b740159fb..bb856ae9c60 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -57,7 +57,7 @@ Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools vers - Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows. - Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). -- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects targeting x64 and x86 with AddressSanitizer, which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview, +- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with AddressSanitizer, which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview. **Productivity enhancements** From b205607f30ab1dd584526585b0b9afd9bdf1ca07 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Tue, 4 Nov 2025 19:24:40 -0800 Subject: [PATCH 1431/1799] edits --- docs/overview/what-s-new-for-msvc.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index bb856ae9c60..57709b13da2 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -15,9 +15,11 @@ Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and ot ## What's new for MSVC Build Tools version 14.50 -* Introduced in Visual Studio 2026 version 18.0 released November 2025.* +* Introduced in Visual Studio 2026 version 18.0 released November 2025. -Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools version 14.50, which offers the best conformance, build performance, and runtime performance story yet. To access to all the new language features, build with `/std:c++latest`, or use `/std:c++23preview` if you want to be restricted to just features up until C++23. +Visual Studio 2026 version 18.0 ships with the v145 platform toolset for MSBuild C++ projects and Microsoft C++ (MSVC) Build Tools version 14.50, which offers the best conformance, build performance, and runtime performance story yet. To access to all the new language features, build with `/std:c++latest`, or use `/std:c++23preview` if you want to be restricted to features up to C++23. + +MSVC Build Tools version 14.50 preserves binary compatibility with code built with MSVC tools shipped in Visual Studio 2015 or later. | For detailed information about | See | |---|---| @@ -50,14 +52,15 @@ Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools vers - Visual Studio 2026 now includes CMake 4.1.2 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. - Added IncrediBuild support for Visual Studio 2026, including the latest IncrediBuild engine and updated extension. Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2016 version 18.0. -- Compiler backend runtime performance improvements. +- Compiler backend runtime performance improvements. Up to 6% as measured on Unreal Engine's City Sample RenderThread. For more information, see [Why you should upgrade your C++ build tools](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#why-you-should-upgrade-your-c++-build-tools). +- The Visual Studio setup assistant can help you retarget your projects, so they build with the latest MSVC Build Tools. For more information, see [Retarget your projects with the setup assistant](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#retarget-your-projects-with-the-setup-assistant). **Code analysis enhancements** - Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows. - Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). -- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with AddressSanitizer, which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview. +- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with [AddressSanitizer](https://learn.microsoft.com/cpp/sanitizers/asan?view=msvc-170), which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview. **Productivity enhancements** @@ -81,13 +84,13 @@ Visual Studio 2026 version 18.0 ships with Microsoft C++ (MSVC) Build Tools vers - The `/await` switch is deprecated, no longer receives support, and will be removed in a future release. Use Standard C++ coroutines, available by default in C++20 or later. For projects in earlier language modes, consider using `/await:strict` to maintain compatibility until the switch is removed. -The mobile development and embedded and IoT development tools are now out of support. +The mobile development and embedded and IoT development tools are no longer supported. The mobile development with C++ workload and Android NDK component in the Visual Studio installer are no longer supported and will be removed in a future Visual Studio update. This impacts tooling support for iOS and Android development, including new projects, building, and debugging. **The following features have been removed and are no longer available:** - C++AMP - ARM32 toolchain: if you still need to build for ARM32, use an older version of the MSVC Build Tools. For more information, see [Side-by-side Minor Version MSVC Toolsets in Visual Studio 2019](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). -- `/DEBUG:FASTLINK` compiler switch. Use to `/DEBUG:FULL` for improved debugging support. +- `/DEBUG:FASTLINK` compiler switch. Use [`/DEBUG:FULL`](https://learn.microsoft.com/cpp/build/reference/debug-generate-debug-info) for improved debugging support. ## Feedback and suggestions From 2da63e97209e5f97a386e705b9f23cf9ea2872be Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 5 Nov 2025 10:02:34 -0800 Subject: [PATCH 1432/1799] tech review --- docs/overview/what-s-new-for-msvc.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 57709b13da2..55957465c4f 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -1,7 +1,7 @@ --- title: "What's new for MSVC Build Tools" description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." -ms.date: 11/04/2025 +ms.date: 11/05/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" ms.custom: intro-whats-new @@ -19,14 +19,14 @@ Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and ot Visual Studio 2026 version 18.0 ships with the v145 platform toolset for MSBuild C++ projects and Microsoft C++ (MSVC) Build Tools version 14.50, which offers the best conformance, build performance, and runtime performance story yet. To access to all the new language features, build with `/std:c++latest`, or use `/std:c++23preview` if you want to be restricted to features up to C++23. -MSVC Build Tools version 14.50 preserves binary compatibility with code built with MSVC tools shipped in Visual Studio 2015 or later. +MSVC Build Tools version 14.50 preserves binary compatibility with code built with MSVC tools shipped in Visual Studio 2015 or later. For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](https://learn.microsoft.com/en-us/cpp/porting/binary-compat-2015-2017). | For detailed information about | See | |---|---| | What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2026 version 18.0](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2026-version-18-0) | | Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.50](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450) | | C++ language updates | [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) | -| C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.14](cpp-conformance-improvements.md#improvements_1714) | +| C++ language conformance improvements | [C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools](msvc-conformance-improvements.md) | **A quick highlight of some of the new features in MSVC Build Tools version 14.50 and Visual Studio 2026 version 18.0:** @@ -38,7 +38,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi **Standard Library enhancements** -- `` addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) added a multiline option to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450-insiders). +- `` addressed several issues, enhancing both reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) added a multiline option to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450). - Added and improved vectorized implementations of many types and functions. **GitHub Copilot enhancements** @@ -51,7 +51,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi **Build enhancements** - Visual Studio 2026 now includes CMake 4.1.2 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. -- Added IncrediBuild support for Visual Studio 2026, including the latest IncrediBuild engine and updated extension. Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2016 version 18.0. +- Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2026 version 18.0. - Compiler backend runtime performance improvements. Up to 6% as measured on Unreal Engine's City Sample RenderThread. For more information, see [Why you should upgrade your C++ build tools](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#why-you-should-upgrade-your-c++-build-tools). - The Visual Studio setup assistant can help you retarget your projects, so they build with the latest MSVC Build Tools. For more information, see [Retarget your projects with the setup assistant](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#retarget-your-projects-with-the-setup-assistant). @@ -73,16 +73,16 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi **Deprecations** -- The minimum supported operating systems for the MSVC Build Tools version 14.50 are Windows 10 or Windows Server 2016. +- The minimum supported target operating systems for the MSVC Build Tools version 14.50 are Windows 10 or Windows Server 2016. - MSVC Build Tools version 14.50 no longer targets: - Windows 7 / Windows Server 2008 R2 - Windows 8 / Windows Server 2012 - Windows 8.1 / Windows Server 2012 R2 - To build applications using the latest C++ tools, your target platform must be Windows 10 or Windows Server 2016 (or later). These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. + These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. -- The `/await` switch is deprecated, no longer receives support, and will be removed in a future release. Use Standard C++ coroutines, available by default in C++20 or later. For projects in earlier language modes, consider using `/await:strict` to maintain compatibility until the switch is removed. +The MSVC compiler switch `/await` is being deprecated and will be removed in a future release. This switch enabled an early draft implementation of C++ coroutines using the `` header. Developers should transition to standard C++ coroutines by using the `` header available in C++20 and later. For C++14/17 projects, use `/await:strict` (which isn't being deprecated) to access the standard `` header without enabling other C++20 features. The mobile development and embedded and IoT development tools are no longer supported. The mobile development with C++ workload and Android NDK component in the Visual Studio installer are no longer supported and will be removed in a future Visual Studio update. This impacts tooling support for iOS and Android development, including new projects, building, and debugging. From 37342895223cf09d7d6042416b524f09ccd859a5 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 5 Nov 2025 10:11:32 -0800 Subject: [PATCH 1433/1799] tidy links --- docs/overview/what-s-new-for-msvc.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 55957465c4f..5dc2d70f7d9 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -19,7 +19,7 @@ Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and ot Visual Studio 2026 version 18.0 ships with the v145 platform toolset for MSBuild C++ projects and Microsoft C++ (MSVC) Build Tools version 14.50, which offers the best conformance, build performance, and runtime performance story yet. To access to all the new language features, build with `/std:c++latest`, or use `/std:c++23preview` if you want to be restricted to features up to C++23. -MSVC Build Tools version 14.50 preserves binary compatibility with code built with MSVC tools shipped in Visual Studio 2015 or later. For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](https://learn.microsoft.com/en-us/cpp/porting/binary-compat-2015-2017). +MSVC Build Tools version 14.50 preserves binary compatibility with code built with MSVC tools shipped in Visual Studio 2015 or later. For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](/cpp/porting/binary-compat-2015-2017). | For detailed information about | See | |---|---| @@ -60,7 +60,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi - Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows. - Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). -- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with [AddressSanitizer](https://learn.microsoft.com/cpp/sanitizers/asan?view=msvc-170), which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview. +- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with [AddressSanitizer](/cpp/sanitizers/asan), which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview. **Productivity enhancements** @@ -90,7 +90,7 @@ The mobile development and embedded and IoT development tools are no longer supp - C++AMP - ARM32 toolchain: if you still need to build for ARM32, use an older version of the MSVC Build Tools. For more information, see [Side-by-side Minor Version MSVC Toolsets in Visual Studio 2019](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). -- `/DEBUG:FASTLINK` compiler switch. Use [`/DEBUG:FULL`](https://learn.microsoft.com/cpp/build/reference/debug-generate-debug-info) for improved debugging support. +- `/DEBUG:FASTLINK` compiler switch. Use [`/DEBUG:FULL`](/cpp/build/reference/debug-generate-debug-info) for improved debugging support. ## Feedback and suggestions From 9a9bb2a7888d2f99366e3deb7c31e43475a8be8f Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 5 Nov 2025 11:03:54 -0800 Subject: [PATCH 1434/1799] small edits --- docs/overview/what-s-new-for-msvc.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md index 5dc2d70f7d9..5085a6beeef 100644 --- a/docs/overview/what-s-new-for-msvc.md +++ b/docs/overview/what-s-new-for-msvc.md @@ -50,7 +50,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi **Build enhancements** -- Visual Studio 2026 now includes CMake 4.1.2 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. +- Visual Studio 2026 now includes CMake 4.1.1 by default. CMake also includes a Visual Studio 2026 generator and modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. - Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2026 version 18.0. - Compiler backend runtime performance improvements. Up to 6% as measured on Unreal Engine's City Sample RenderThread. For more information, see [Why you should upgrade your C++ build tools](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#why-you-should-upgrade-your-c++-build-tools). - The Visual Studio setup assistant can help you retarget your projects, so they build with the latest MSVC Build Tools. For more information, see [Retarget your projects with the setup assistant](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#retarget-your-projects-with-the-setup-assistant). @@ -60,7 +60,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi - Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows. - Code analysis has new configuration options: You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. Plus, you can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: ![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png). -- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with [AddressSanitizer](/cpp/sanitizers/asan), which allows you to identify hard-to-find bugs with zero false positives at runtime and increase memory safety. You can now use AddressSanitizer to target ARM64. This feature is in preview. +- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with [AddressSanitizer](/cpp/sanitizers/asan), which allows you to identify hard-to-find memory safety issues with zero false positives at runtime and increase memory safety. Now you can use AddressSanitizer to target ARM64. This feature is in preview. **Productivity enhancements** @@ -82,7 +82,7 @@ MSVC Build Tools version 14.50 preserves binary compatibility with code built wi These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. -The MSVC compiler switch `/await` is being deprecated and will be removed in a future release. This switch enabled an early draft implementation of C++ coroutines using the `` header. Developers should transition to standard C++ coroutines by using the `` header available in C++20 and later. For C++14/17 projects, use `/await:strict` (which isn't being deprecated) to access the standard `` header without enabling other C++20 features. +The MSVC compiler switch [`/await`](/cpp/build/reference/await-enable-coroutine-support) is being deprecated and will be removed in a future release. This switch enabled an early draft implementation of C++ coroutines using the `` header. Developers should transition to standard C++ coroutines by using the `` header available in C++20 and later. For C++14/17 projects, use `/await:strict` (which isn't being deprecated) to access the standard `` header without enabling other C++20 features. The mobile development and embedded and IoT development tools are no longer supported. The mobile development with C++ workload and Android NDK component in the Visual Studio installer are no longer supported and will be removed in a future Visual Studio update. This impacts tooling support for iOS and Android development, including new projects, building, and debugging. @@ -90,7 +90,7 @@ The mobile development and embedded and IoT development tools are no longer supp - C++AMP - ARM32 toolchain: if you still need to build for ARM32, use an older version of the MSVC Build Tools. For more information, see [Side-by-side Minor Version MSVC Toolsets in Visual Studio 2019](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). -- `/DEBUG:FASTLINK` compiler switch. Use [`/DEBUG:FULL`](/cpp/build/reference/debug-generate-debug-info) for improved debugging support. +- `/DEBUG:FASTLINK` linker switch. Use [`/DEBUG:FULL`](/cpp/build/reference/debug-generate-debug-info) for improved debugging support. ## Feedback and suggestions From 06f0f58de1c4f2d46a4f2b92b75edc31d313a8ef Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Wed, 5 Nov 2025 19:14:30 -0800 Subject: [PATCH 1435/1799] add support --- .../visual-cpp-language-conformance.md | 61 ++++++++++--------- 1 file changed, 33 insertions(+), 28 deletions(-) diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index d1414adf473..301128b5ac5 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -177,46 +177,47 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P0735R1 Interaction of memory_order_consume with release sequences`](https://wg21.link/P0735R1) | N/A | |  [`P1236R1 Signed integers are two's complement`](https://wg21.link/P1236R1) | N/A | | **C++23 Core language features** | **Supported** | -|  [`P0330R8 Literal Suffix for (signed) size_t`](https://wg21.link/p0330r8) | no | -|  [`P0847R7 Deducing this`](https://wg21.link/p0847r7) | no | -|  [`P0849R8 auto(x): decay-copy in the language`](https://wg21.link/p0849r8) | no | -|  [`P1102R2 Down with ()!`](https://wg21.link/p1102r2) | no | -|  [`P1169R4 static operator()`](https://wg21.link/p1169r4) | no | -|  [`P1401R5 Narrowing contextual conversions to bool`](https://wg21.link/p1401r5) | no | -|  [`P1467R9 Extended floating-point types and standard names`](https://wg21.link/p1467r9) | no | +|  [`P0330R8 Literal Suffix for (signed) size_t`](https://wg21.link/p0330r8) | VS 2022 17.13 [23](#note_23) | +|  [`P0847R7 Deducing this`](https://wg21.link/p0847r7) | VS 2022 17.13 [23](#note_23) | +|  [`P0849R8 auto(x): decay-copy in the language`](https://wg21.link/p0849r8) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P1102R2 Down with ()!`](https://wg21.link/p1102r2) | VS 2022 17.14 [23](#note_23) | +|  [`P1169R4 static operator()`](https://wg21.link/p1169r4) | VS 2022 17.14 [23](#note_23) | +|  [`P1401R5 Narrowing contextual conversions to bool`](https://wg21.link/p1401r5) | VS 2022 17.14 [23](#note_23) | +|  [`P1467R9 Extended floating-point types and standard names`](https://wg21.link/p1467r9) | No [U](#note_U) | |  [`P1774R8 Portable assumptions`](https://wg21.link/p1774r8) | no | -|  [`P1787R6 Declarations and where to find them`](https://wg21.link/p1787r6) | no | +|  [`P1787R6 Declarations and where to find them`](https://wg21.link/p1787r6) | No change required | |  [`P1847R4 Make declaration order layout mandated`](https://wg21.link/p1847r4) | VS 2022 17.0 [23](#note_23) | -|  [`P1938R3 if consteval`](https://wg21.link/p1938r3) | no | -|  [`P1949R7 C++ Identifier Syntax using Unicode Standard Annex 31`](https://wg21.link/p1949r7) | no | +|  [`P1938R3 if consteval`](https://wg21.link/p1938r3) | VS 2022 17.14 [23](#note_23) | +|  [`P1949R7 C++ Identifier Syntax using Unicode Standard Annex 31`](https://wg21.link/p1949r7) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2029R4 Proposed resolution for core issues 411, 1656, and 2333; numeric and universal character escapes in character and string literals`](https://wg21.link/p2029r4) | no | -|  [`P2036R3 Change scope of lambda trailing-return-type`](https://wg21.link/p2036r3) | no | +|  [`P2036R3 Change scope of lambda trailing-return-type`](https://wg21.link/p2036r3) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2071R2 Named universal character escapes`](https://wg21.link/p2071r2) | no | -|  [`P2128R6 Multidimensional subscript operator`](https://wg21.link/p2128r6) | no | -|  [`P2156R1 Allow Duplicate Attributes`](https://wg21.link/p2156r1) | no | -|  [`P2173R1 Attributes on Lambda-Expressions`](https://wg21.link/p2173r1) | no | +|  [`P2128R6 Multidimensional subscript operator`](https://wg21.link/p2128r6) | VS 2022 17.12 [23](#note_23) | +|  [`P2156R1 Allow Duplicate Attributes`](https://wg21.link/p2156r1) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2173R1 Attributes on Lambda-Expressions`](https://wg21.link/p2173r1) | VS 2022 17.14 [23](#note_23) | |  [`P2186R2 Remove Garbage Collection Support`](https://wg21.link/p2186r2) | VS 2022 17.0 [23](#note_23) | -|  [`P2201R1 Mixed string literal concatenation`](https://wg21.link/p2201r1) | no | -|  [`P2223R2 Trimming whitespaces before line splicing`](https://wg21.link/p2223r2) | no | -|  [`P2242R3 Non-literal variables (and labels and gotos) in constexpr functions`](https://wg21.link/p2242r3) | no | +|  [`P2201R1 Mixed string literal concatenation`](https://wg21.link/p2201r1) | No change required | +|  [`P2223R2 Trimming whitespaces before line splicing`](https://wg21.link/p2223r2) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2242R3 Non-literal variables (and labels and gotos) in constexpr functions`](https://wg21.link/p2242r3) | VS 2022 17.14 [23](#note_23) | |  [`P2246R1 Character encoding of diagnostic text`](https://wg21.link/p2246r1) | VS 2022 17.0 [23](#note_23) | -|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | no | -|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | no | -|  [`P2295R6 Support for UTF-8 as a portable source file encoding`](https://wg21.link/p2295r6) | no | +|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2295R6 Support for UTF-8 as a portable source file encoding`](https://wg21.link/p2295r6) | [V](#note_V) | |  [`P2314R4 Character sets and encodings`](https://wg21.link/p2314r4) | no | |  [`P2316R2 Consistent character literal encoding`](https://wg21.link/p2316r2) | VS 2022 17.0 [23](#note_23) | |  [`P2324R2 Labels at the end of compound statements (C compatibility)`](https://wg21.link/p2324r2) | no | -|  [`P2327R1 De-deprecating volatile compound operations`](https://wg21.link/p2327r1) | no | -|  [`P2334R1 preprocessing directives elifdef and elifndef`](https://wg21.link/p2334r1) | no | -|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | no | +|  [`P2327R1 De-deprecating volatile compound operations`](https://wg21.link/p2327r1) | N/A | +|  [`P2334R1 preprocessing directives elifdef and elifndef`](https://wg21.link/p2334r1) | VS 2022 17.10 [23](#note_23) | +|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2362R3 Remove non-encodable wide character literals and multicharacter wide character literals`](https://wg21.link/p2362r3) | no | -|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | no | +|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2448R2 Relaxing some constexpr restrictions`](https://wg21.link/p2448r2) | no | -|  [`P2460R2 Relax requirements on wchar_t to match existing practices`](https://wg21.link/p2460r2) | no | -|  [`P2468R2 The Equality Operator You Are Looking For`](https://wg21.link/p2468r2) | no | -|  [`P2493R0 Missing feature test macros for C++20 core papers`](https://wg21.link/p2493r0) | no | +|  [`P2460R2 Relax requirements on wchar_t to match existing practices`](https://wg21.link/p2460r2) | N/A | +|  [`P2468R2 The Equality Operator You Are Looking For`](https://wg21.link/p2468r2) | VS 2022 17.6 [23](#note_23) | +|  [`P2493R0 Missing feature test macros for C++20 core papers`](https://wg21.link/p2493r0) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2513R4 char8_t Compatibility and Portability Fix`](https://wg21.link/p2513r4) | VS 2022 17.4 [DR](#note_DR) | -|  [`P2579R0 Mitigation strategies for P2036 ”Changing scope for lambda trailing-return-type”`](https://wg21.link/p2579r0) | no | +|  [`P2579R0 Mitigation strategies for P2036 "Changing scope for lambda trailing-return-type"`](https://wg21.link/p2579r0) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2582R1 Wording for class template argument deduction from inherited constructors`](https://wg21.link/p2582r1) | no | ## C++ Standard library features @@ -635,6 +636,10 @@ These algorithms aren't presently parallelized: **T** `` is currently supported when compiled as C++ (`/std:c++latest`). It isn't yet supported when compiled as C (`/std:c11` and `/std:c17`) + **U** Extended floating-point types are an optional C++23 feature. MSVC doesn't plan to support this feature before the completion of C++23 standardization. + + **V** Use the compiler options `/source-charset:utf-8` and `/we4828` to treat source files as UTF-8 encoded. + **14** These C++17 and C++20 features are always enabled, even when [`/std:c++14`](../build/reference/std-specify-language-standard-version.md) (the default) is specified. The reason is either because the feature was implemented before the introduction of the **`/std`** options, or because conditional implementation was undesirably complex. **17** These features are enabled by the [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later compiler option. From c79a12c45222204b6aec76bf47d57ac6040aaf25 Mon Sep 17 00:00:00 2001 From: Augustin Popa Date: Thu, 6 Nov 2025 00:20:40 -0800 Subject: [PATCH 1436/1799] Finished reviewing /porting for VS 2026 and updating MSVC branding --- docs/porting/binary-compat-2015-2017.md | 18 ++++++++-------- docs/porting/build-system-changes.md | 2 +- .../features-deprecated-in-visual-studio.md | 2 +- .../floating-point-migration-issues.md | 2 +- docs/porting/ide-tools-for-upgrading-code.md | 18 ++++++---------- .../porting/media/vs-2026-setup-assistant.png | Bin 0 -> 79406 bytes .../modifying-winver-and-win32-winnt.md | 2 +- ...-of-potential-upgrade-issues-visual-cpp.md | 20 +++++++++--------- ...cts-from-earlier-versions-of-visual-cpp.md | 12 +++++------ docs/porting/use-native-multi-targeting.md | 16 +++++++------- 10 files changed, 44 insertions(+), 48 deletions(-) create mode 100644 docs/porting/media/vs-2026-setup-assistant.png diff --git a/docs/porting/binary-compat-2015-2017.md b/docs/porting/binary-compat-2015-2017.md index 21a50e72153..3c14d4b7413 100644 --- a/docs/porting/binary-compat-2015-2017.md +++ b/docs/porting/binary-compat-2015-2017.md @@ -6,20 +6,20 @@ helpviewer_keywords: ["binary compatibility, Visual C++"] --- # C++ binary compatibility between Visual Studio versions -The Microsoft C++ (MSVC) Build Tools in Visual Studio 2013 and earlier don't guarantee binary compatibility across major versions. You can't link object files, static libraries, dynamic libraries, and executables built by different versions of these toolsets. The ABIs, object formats, and runtime libraries are incompatible. +The Microsoft C++ (MSVC) Build Tools in Visual Studio 2013 and earlier don't guarantee binary compatibility across major versions. You can't link object files, static libraries, dynamic libraries, and executables built by different versions of these build tools. The ABIs, object formats, and runtime libraries are incompatible. -We've changed this behavior in Visual Studio 2015 and later versions. The runtime libraries and apps compiled by any of these versions of the compiler are binary-compatible. It's reflected in the C++ toolset major number, which starts with 14 for all versions since Visual Studio 2015. (The toolset version is v140 for Visual Studio 2015, v141 for 2017, v142 for 2019, and v143 for 2022). Say you have third-party libraries built by Visual Studio 2015. You can still use them in an application built by Visual Studio 2017, 2019, 2022, or 2026. There's no need to recompile with a matching toolset. The latest version of the Microsoft Visual C++ Redistributable package (the Redistributable) works for all of them. +We've changed this behavior in Visual Studio 2015 and later versions. The runtime libraries and apps compiled by any of these versions of the compiler are binary-compatible. It's reflected in the MSVC Build Tools major number, which starts with 14 for all versions since Visual Studio 2015. (The build tools version is v140 for Visual Studio 2015, v141 for 2017, v142 for 2019, and v143 for 2022). Say you have third-party libraries built by Visual Studio 2015. You can still use them in an application built by Visual Studio 2017, 2019, 2022, or 2026. There's no need to recompile with a matching version. The latest version of the Microsoft Visual C++ Redistributable package (the Redistributable) works for all of them. ## Restrictions on binary compatibility -There are three important restrictions on binary compatibility between the v140, v141, v142, v143, and v145 toolsets and minor numbered version updates: +There are three important restrictions on binary compatibility between the v140, v141, v142, v143, and v145 build tools and minor numbered version updates: -- Binaries created with different versions of the v140, v141, v142, v143, and v145 toolsets can be combined. The key rule is that the linker should only work with inputs built by a toolset that is the same version (or earlier) as itself. This applies to apps, import libraries, static libraries, and other files as described in [LINK input files](../build/reference/link-input-files.md). In some cases, an import library for an [implicitly linked](../build/linking-an-executable-to-a-dll.md#implicit-linking) DLL built by a later version of the toolset can be linked using an earlier version of the toolset--especially if the import library strictly uses `extern "C"` for the imports/exports. Here are some examples of what this all means: - - An app compiled with a 2017 toolset (v141, versions 15.0 to 15.9) can be linked to a static library compiled with Visual Studio 2022 version 17.8 (v143), but the linking must be done using a version 17.8 or later toolset. - - Apps and libraries built using VS 2015, 2017, 2019, 2022, and 2026 can be linked together, but the linking must be done using a version of the toolset that is as recent as, or more recent than, the most recent toolset used to build any of the binaries you pass to the linker. For example, given three binaries built with toolsets from VS 2015 version 14.3, VS 2017 version 15.9, and VS 2019 version 16.11, you can link them using any toolset version that is 16.11 or later. - - If a DLL is built with a newer toolset, the import library can sometimes be used with older toolsets if all of the exports follow the C language calling convention (`extern "C"`). However, the only officially supported case is consuming a newer windows SDK with an older toolset. -- The Redistributable your app uses has a similar binary-compatibility restriction. When you mix binaries built by different supported versions of the toolset, the Redistributable version must be at least as new as the latest toolset used by any app component. -- Static libraries or object files compiled using the [`/GL` (Whole program optimization)](../build/reference/gl-whole-program-optimization.md) compiler switch or linked using [`/LTCG` (Link-time code generation)](../build/reference/ltcg-link-time-code-generation.md) *aren't* binary-compatible across versions, including minor version updates. All object files and libraries compiled using **`/GL`** and **`/LTCG`** must use exactly the same toolset for the compile and the final link. For example, code built by using **`/GL`** in the Visual Studio 2019 version 16.7 toolset can't be linked to code built by using **`/GL`** in the Visual Studio 2019 version 16.8 toolset. The compiler emits [Fatal error C1047](../error-messages/compiler-errors-1/fatal-error-c1047.md). +- Binaries created with different versions of the v140, v141, v142, v143, and v145 build tools can be combined. The key rule is that the linker should only work with inputs built by build tools that are the same version (or earlier) as itself. This applies to apps, import libraries, static libraries, and other files as described in [LINK input files](../build/reference/link-input-files.md). In some cases, an import library for an [implicitly linked](../build/linking-an-executable-to-a-dll.md#implicit-linking) DLL built by a later version of the build tools can be linked using an earlier version of the build tools--especially if the import library strictly uses `extern "C"` for the imports/exports. Here are some examples of what this all means: + - An app compiled with the 2017 build tools (v141, versions 15.0 to 15.9) can be linked to a static library compiled with Visual Studio 2022 version 17.8 (v143), but the linking must be done using a version 17.8 or later build tools. + - Apps and libraries built using VS 2015, 2017, 2019, 2022, and 2026 can be linked together, but the linking must be done using a version of the build tools that is as recent as, or more recent than, the most recent build tools used to build any of the binaries you pass to the linker. For example, given three binaries built with build tools from VS 2015 version 14.3, VS 2017 version 15.9, and VS 2019 version 16.11, you can link them using any build tools version that is 16.11 or later. + - If a DLL is built with newer build tools, the import library can sometimes be used with older build tools if all of the exports follow the C language calling convention (`extern "C"`). However, the only officially supported case is consuming a newer windows SDK with older build tools. +- The Redistributable your app uses has a similar binary-compatibility restriction. When you mix binaries built by different supported versions of the build tools, the Redistributable version must be at least as new as the latest build tools used by any app component. +- Static libraries or object files compiled using the [`/GL` (Whole program optimization)](../build/reference/gl-whole-program-optimization.md) compiler switch or linked using [`/LTCG` (Link-time code generation)](../build/reference/ltcg-link-time-code-generation.md) *aren't* binary-compatible across versions, including minor version updates. All object files and libraries compiled using **`/GL`** and **`/LTCG`** must use exactly the same build tools for the compile and the final link. For example, code built by using **`/GL`** in the Visual Studio 2019 version 16.7 build tools can't be linked to code built by using **`/GL`** in the Visual Studio 2019 version 16.8 build tools. The compiler emits [Fatal error C1047](../error-messages/compiler-errors-1/fatal-error-c1047.md). ## Upgrade the Microsoft Visual C++ Redistributable from Visual Studio 2015 and later diff --git a/docs/porting/build-system-changes.md b/docs/porting/build-system-changes.md index bcd58b4a3d7..afde5d89f65 100644 --- a/docs/porting/build-system-changes.md +++ b/docs/porting/build-system-changes.md @@ -7,7 +7,7 @@ ms.assetid: e564d95f-a6cc-4d97-b57e-1a71daf66f4a --- # VCBuild vs. MSBuild: Build system changes in Visual Studio 2010 -The MSBuild system for C++ projects was introduced in Visual Studio 2010. In Visual Studio 2008 and earlier releases, the VCBuild system was used. Certain file types and concepts that depended on VCBuild either do not exist or are represented differently in MSBuild. This document discusses the differences in the current build system. To convert a Visual Studio 2008 project to MSBuild, you must use Visual Studio 2010. After the project is converted, you should use the latest version of Visual Studio to upgrade to the current IDE and compiler toolset. For more information, including how to obtain Visual Studio 2010, see [Instructions for Visual Studio 2008](use-native-multi-targeting.md#instructions-for-visual-studio-2008). +The MSBuild system for C++ projects was introduced in Visual Studio 2010. In Visual Studio 2008 and earlier releases, the VCBuild system was used. Certain file types and concepts that depended on VCBuild either do not exist or are represented differently in MSBuild. This document discusses the differences in the current build system. To convert a Visual Studio 2008 project to MSBuild, you must use Visual Studio 2010. After the project is converted, you should use the latest version of Visual Studio to upgrade to the current IDE and build tools. For more information, including how to obtain Visual Studio 2010, see [Instructions for Visual Studio 2008](use-native-multi-targeting.md#instructions-for-visual-studio-2008). The following sections summarize the changes from VCBuild to MSBuild. If your VCBuild project has custom build rules or macros that aren't recognized by MSBuild, see [Visual Studio Projects - C++](../build/creating-and-managing-visual-cpp-projects.md) to learn how to translate those instructions to the MSBuild system. The initial conversion from VCBuild to MSBuild is just an intermediate step. It isn't necessary to get the project file completely correct or to get the program to compile without errors. You are only using Visual Studio 2010 to convert the project to MSBuild format so that you get the project working in the latest version of Visual Studio. diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index 38a850fda85..a5fabcb63b9 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -12,7 +12,7 @@ This article is a non-exhaustive list of C++ features deprecated in Visual Studi ### Support for Windows XP development -Visual Studio 2019 and later versions don't include current toolset support for creating code for Windows XP. Support for Windows XP development by using the v141_xp toolset that shipped in Visual Studio 2017 is still available as an optional component in the Visual Studio Installer. For information on how to install the v141_xp Windows XP platform toolset, see [Configuring programs for Windows XP](../build/configuring-programs-for-windows-xp.md). +Visual Studio 2019 and later versions don't include current build tools support for creating code for Windows XP. Support for Windows XP development by using the v141_xp build tools that shipped in Visual Studio 2017 is still available as an optional component in the Visual Studio Installer. For information on how to install the v141_xp Windows XP platform toolset, see [Configuring programs for Windows XP](../build/configuring-programs-for-windows-xp.md). ## Visual Studio 2022 diff --git a/docs/porting/floating-point-migration-issues.md b/docs/porting/floating-point-migration-issues.md index c35a83ae9c3..288ee1d1433 100644 --- a/docs/porting/floating-point-migration-issues.md +++ b/docs/porting/floating-point-migration-issues.md @@ -22,7 +22,7 @@ Code-generation correctness improvements in different floating point modes in Vi ## How to get identical results -In most cases, the floating-point changes in the newest compilers and libraries result in faster or more correct behavior, or both. You may even see better processor power performance when SSE2 instructions replace x87 instructions. However, if you have code that must precisely replicate the floating point behavior of an older compiler, consider using Visual Studio native multi-targeting capabilities, and build the affected project with the older toolset. For more information, see [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md). +In most cases, the floating-point changes in the newest compilers and libraries result in faster or more correct behavior, or both. You may even see better processor power performance when SSE2 instructions replace x87 instructions. However, if you have code that must precisely replicate the floating point behavior of an older compiler, consider using Visual Studio native multi-targeting capabilities, and build the affected project with the older build tools. For more information, see [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md). ## See also diff --git a/docs/porting/ide-tools-for-upgrading-code.md b/docs/porting/ide-tools-for-upgrading-code.md index 13f9f48a5f4..e01cc9dc646 100644 --- a/docs/porting/ide-tools-for-upgrading-code.md +++ b/docs/porting/ide-tools-for-upgrading-code.md @@ -1,14 +1,14 @@ --- title: "Visual Studio IDE tools for upgrading C++ code" description: "The C++ code editor and code analysis tools in Visual Studio help you to modernize your C++ code base." -ms.date: "11/13/2019" +ms.date: "11/06/2025" ms.topic: "concept-article" --- # Visual Studio IDE tools for upgrading C++ code Visual Studio helps you upgrade legacy C++ code with compiler options, code analysis warnings, and editor features such as Quick Fixes, Quick Info, and the enhanced scroll bar. The term "legacy code" refers to any of these categories: -- Code that was formerly allowed by the Microsoft C++ compiler (MSVC) but never conformed to the C++ standard. +- Code that was formerly allowed by the Microsoft C++ (MSVC) compiler but never conformed to the C++ standard. To upgrade older non-conforming MSVC code, turn on the [`/permissive-`](../build/reference/permissive-standards-conformance.md) compiler option. All instances of non-conforming usages are underlined with red squiggles in the code editor. The error messages in the **Error List** window include a recommendation for how to fix the error. Click on the error code to go to its help page in the documentation. If fixing all the errors at once is impractical, you can upgrade non-conforming code in stages by turning on the **`/permissive-`** option, fixing some errors, then turning the option off again. The code will compile with the new improvements, and you can go back and fix the remaining issues at a later time. See the [`/permissive-`](../build/reference/permissive-standards-conformance.md) page for examples of non-conforming MSVC code. @@ -22,19 +22,15 @@ Visual Studio helps you upgrade legacy C++ code with compiler options, code anal ## Open and convert a legacy project -If your legacy project is based on an older version of Visual Studio, you can open it in Visual Studio 2017 or Visual Studio 2019. Visual Studio automatically converts it to the current project schema with support for all the latest compiler and IDE features. +If your legacy projects are based on an older version of Visual Studio, you can still load them in a newer version and work on it there while maintaining backwards compatibility with the older version. When you are ready to permanently move to the new version of Visual Studio, you can retarget your projects. This will enable you to use the latest build tools and project features in the IDE, but you will no longer be able to load the retargeted projects in the older version of Visual Studio. -![Screenshot of the Upgrade a project dialog.](media/upgrade-dialog-v142.png "Upgrade a project") +To retarget projects to the Visual Studio 2026 format, you can use the setup assistant which appears the first time you open a solution with older projects. You can also access it by right-clicking the solution in Solution Explorer and selecting *Retarget solution*. -For more information, see [Upgrade C++ projects from earlier versions of Visual Studio](upgrading-projects-from-earlier-versions-of-visual-cpp.md). - -## Search the code base +![Screenshot of the Visual Studio 2026 setup assistant.](media/vs-2026-setup-assistant.png "Upgrade projects") -Upgrading a code base often involves searching through multiple files. To search for anything in your code base, press **Ctrl+T** to bring up the **Go to All** search box. +The setup assistant then gives you the choice to either stay on the older version and install any missing build tools or Windows SDKs to be able to build, or retarget the projects to upgrade them. You can make retargeting selections for each project in the solution or click *Retarget all*, then click *Apply* to perform the upgrade. -![Screenshot of the Go to all dialog.](media/go-to-all.png "Go to all") - -To narrow the search scope, type one of the 1-letter filters, followed by a space and then the thing you are looking for. +For more information, see [Upgrade C++ projects from earlier versions of Visual Studio](upgrading-projects-from-earlier-versions-of-visual-cpp.md). ## Error List diff --git a/docs/porting/media/vs-2026-setup-assistant.png b/docs/porting/media/vs-2026-setup-assistant.png new file mode 100644 index 0000000000000000000000000000000000000000..85fe981738603464b4218a024b65e5f78b52cb7a GIT binary patch literal 79406 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 gE!9`4#M|a0QJAIpRT7OeFv [!NOTE] -> This section applies to applications and libraries built with Visual Studio 2013 and earlier. The toolsets used in Visual Studio 2015, Visual Studio 2017 and Visual Studio 2019 are binary compatible. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). +> This section applies to applications and libraries built with Visual Studio 2013 and earlier. The build tools used in Visual Studio 2015, Visual Studio 2017 and Visual Studio 2019 are binary compatible. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). When you upgrade an app from Visual Studio 2013 or before to a newer version, it's often both advisable and necessary to upgrade all libraries and DLLs the app links to. Either you must have access to the source code, or the library vendor must provide new binary files compiled with the same major version of the compiler. If one of these conditions is true, then you can skip this section, which deals with the details of binary compatibility. If neither is the case, then the libraries might not work in your upgraded app. The information in this section will help you understand whether you can continue with the upgrade. -### Toolset +### Build tools -The *`.obj`* and *`.lib`* file formats are well defined and rarely change. Sometimes additions are made to these file formats, but these additions generally don't affect the ability of newer toolsets to consume object files and libraries produced by older toolsets. The major exception is if you compile using [`/GL` (Whole Program Optimization)](../build/reference/gl-whole-program-optimization.md). If you compile using `/GL`, you can only link the resulting object file by using the same toolset that was used to produce it. So, if you produce an object file with `/GL` and use a Visual Studio 2017 (v141) compiler, you must link it using the Visual Studio 2017 (v141) linker. It's because the internal data structures within the object files aren't stable across major versions of the toolset. Newer toolsets don't understand the older data formats. +The *`.obj`* and *`.lib`* file formats are well defined and rarely change. Sometimes additions are made to these file formats, but these additions generally don't affect the ability of newer build tools to consume object files and libraries produced by older build tools. The major exception is if you compile using [`/GL` (Whole Program Optimization)](../build/reference/gl-whole-program-optimization.md). If you compile using `/GL`, you can only link the resulting object file by using the same build tools that were used to produce it. So, if you produce an object file with `/GL` and use a Visual Studio 2017 (v141) compiler, you must link it using the Visual Studio 2017 (v141) linker. It's because the internal data structures within the object files aren't stable across major versions of the build tools. Newer build tools don't understand the older data formats. -C++ doesn't have a stable application binary interface (ABI). But Visual Studio maintains a stable C++ ABI for all minor versions of a release. Visual Studio 2015 (v140), Visual Studio 2017 (v141), Visual Studio 2019 (v142), Visual Studio 2022 (v143), and Visual Studio 2026 (v145) toolsets vary only in their minor version. They all have the same major version number, which is 14. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). +C++ doesn't have a stable application binary interface (ABI). But Visual Studio maintains a stable C++ ABI for all minor versions of a release. Visual Studio 2015 (v140), Visual Studio 2017 (v141), Visual Studio 2019 (v142), Visual Studio 2022 (v143), and Visual Studio 2026 (v145) build tools vary only in their minor version. They all have the same major version number, which is 14. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). -If you have an object file that has external symbols with C++ linkage, that object file may not link correctly with object files produced by a different major version of the toolset. There are many possible outcomes: the link might fail entirely (for example, if name decoration changed). The link could succeed, but the app could fail at runtime (for example, if type layouts changed). Or your app might continue to work and nothing will go wrong. Also note, while the C++ ABI isn't stable, the C ABI and the subset of the C++ ABI required for COM are stable. +If you have an object file that has external symbols with C++ linkage, that object file may not link correctly with object files produced by a different major version of the build tools. There are many possible outcomes: the link might fail entirely (for example, if name decoration changed). The link could succeed, but the app could fail at runtime (for example, if type layouts changed). Or your app might continue to work and nothing will go wrong. Also note, while the C++ ABI isn't stable, the C ABI and the subset of the C++ ABI required for COM are stable. -If you link to an import library, any later version of the Visual Studio redistributable libraries that preserve ABI compatibility may be used at runtime. For example, if you compile and link your app by using the Visual Studio 2015 Update 3 toolset, you can use any later redistributable. That's because the 2015, 2017, 2019, 2022, and 2026 libraries have preserved backward binary compatibility. The reverse isn't true: You can't use a redistributable for an earlier version of the toolset than you used to build any component of your code. +If you link to an import library, any later version of the Visual Studio redistributable libraries that preserve ABI compatibility may be used at runtime. For example, if you compile and link your app by using the Visual Studio 2015 Update 3 build tools, you can use any later redistributable. That's because the 2015, 2017, 2019, 2022, and 2026 libraries have preserved backward binary compatibility. The reverse isn't true: You can't use a redistributable for an earlier version of the build tools than you used to build any component of your code. ### Libraries @@ -47,7 +47,7 @@ If you have a static library built by using an older version of the C Runtime he 1. If you can't (or don't want to) rebuild the static library, you may try linking with *`legacy_stdio_definitions.lib`*. If it satisfies the link-time dependencies of your static library, you'll want to thoroughly test the static library as it's used in the binary. Make sure it isn't adversely affected by any of the [behavioral changes that were made to the Universal CRT](visual-cpp-change-history-2003-2015.md#BK_CRT). -1. Perhaps your static library's dependencies aren't satisfied by *`legacy_stdio_definitions.lib`* or the library doesn't work with the Universal CRT because of behavior changes. In this case, we recommend you encapsulate your static library into a DLL that you link with the required version of the Microsoft C Runtime. For example, if the static library was built using Visual Studio 2013, build this DLL using the Visual Studio 2013 toolset and C++ libraries as well. By building the library into a DLL, you encapsulate the implementation detail that is its dependency on a particular version of the Microsoft C Runtime. Be careful the DLL interface doesn't leak details of which C Runtime it uses, for example, if it returns a `FILE*` across the DLL boundary, or a `malloc`-allocated pointer the caller must `free`. +1. Perhaps your static library's dependencies aren't satisfied by *`legacy_stdio_definitions.lib`* or the library doesn't work with the Universal CRT because of behavior changes. In this case, we recommend you encapsulate your static library into a DLL that you link with the required version of the Microsoft C Runtime. For example, if the static library was built using Visual Studio 2013, build this DLL using the Visual Studio 2013 build tools and C++ libraries as well. By building the library into a DLL, you encapsulate the implementation detail that is its dependency on a particular version of the Microsoft C Runtime. Be careful the DLL interface doesn't leak details of which C Runtime it uses, for example, if it returns a `FILE*` across the DLL boundary, or a `malloc`-allocated pointer the caller must `free`. Use of multiple CRTs in a single process isn't in and of itself problematic. (In fact, most processes load multiple CRT DLLs. For example, Windows operating system components depend on *`msvcrt.dll`*, and the CLR depends on its own private CRT.) Problems arise when you jumble state from different CRTs. For example, you shouldn't allocate memory using `msvcr110.dll!malloc` and attempt to deallocate that memory using `msvcr120.dll!free`, and you shouldn't attempt to open a FILE using `msvcr110!fopen` and attempt to read from that FILE using `msvcr120!fread`. As long as you don't jumble state from different CRTs, you can safely have multiple CRTs loaded in a single process. @@ -72,7 +72,7 @@ For unresolved symbols, you might need to fix up your project settings. - If the external is defined in a *`.lib`* file, have you specified the lib path in the project properties, and is the correct version of the *`.lib`* file located there? -- Are you attempting to link to a *`.lib`* file that was compiled with a different version of Visual Studio? If so, see the previous section on library and toolset dependencies. +- Are you attempting to link to a *`.lib`* file that was compiled with a different version of Visual Studio? If so, see the previous section on library and build tools dependencies. - Do the types of the arguments at the call site actually match an existing overload of the function? Verify the underlying types are what you expect, both for any typedefs in the function's signature and in the code that calls the function. @@ -155,7 +155,7 @@ Windows API documentation lists the minimum or maximum supported operating syste ### Windows version -When upgrading a program that uses the Windows API either directly or indirectly, you need to decide the minimum Windows version to support. In most cases, Windows 7 is a good choice. For more information, see [Header file problems](porting-guide-spy-increment.md#header_file_problems). The `WINVER` macro defines the oldest version of Windows that your program is designed to run on. If your MFC program sets `WINVER` to 0x0501 (Windows XP) you'll get a warning because MFC no longer supports XP, even if the compiler toolset itself has an XP mode. Compiler toolset support for Windows XP ended in Visual Studio 2017, and support for Windows 7, 8.0 and 8.1 ended in Visual Studio 2026. +When upgrading a program that uses the Windows API either directly or indirectly, you need to decide the minimum Windows version to support. In most cases, Windows 7 is a good choice. For more information, see [Header file problems](porting-guide-spy-increment.md#header_file_problems). The `WINVER` macro defines the oldest version of Windows that your program is designed to run on. If your MFC program sets `WINVER` to 0x0501 (Windows XP) you'll get a warning because MFC no longer supports XP, even if the build tools have an XP mode. Build tools support for Windows XP ended in Visual Studio 2017, and support for Windows 7, 8.0 and 8.1 ended in Visual Studio 2026. For more information, see [Updating the target windows version](porting-guide-spy-increment.md#updating_winver) and [More outdated header files](porting-guide-spy-increment.md#outdated_header_files). diff --git a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md index fdda74285ee..2fb6385ce29 100644 --- a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md +++ b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md @@ -1,21 +1,21 @@ --- title: "Upgrade C++ projects from earlier versions of Visual Studio" description: "How to upgrade Microsoft C++ projects from older versions of Visual Studio." -ms.date: 04/07/2022 +ms.date: 11/05/2025 helpviewer_keywords: ["32-bit code porting", "upgrading Visual C++ applications, 32-bit code"] ms.assetid: 18cdacaa-4742-43db-9e4c-2d9e73d8cc84 ms.topic: upgrade-and-migration-article --- # Upgrade C++ projects from earlier versions of Visual Studio -To upgrade a project created in an earlier version of Visual Studio, just open the project in the latest version of Visual Studio. Visual Studio offers to upgrade the project to the current schema. +To upgrade a project created in an earlier version of Visual Studio, start by opening the project in the latest version of Visual Studio. If you are still using the older version of Visual Studio side-by-side, you can choose not to upgrade your projects until you're ready to maintain compatibility with both versions. -If you choose **No**, the project doesn't get upgraded. For projects created in Visual Studio 2010 and later, you can still use the project in the newer version of Visual Studio. Just set your project properties to continue to target the older toolset. If you leave the older version of Visual Studio on your computer, its toolset is available in later versions. For example, if your project must continue to run on Windows XP, you can upgrade to Visual Studio 2019. You then specify the toolset as v141_xp or earlier in your project properties. For more information, see [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md). +In Visual Studio 2026, this experience has been enhanced with a **setup assistant**. The setup assistant offers you the chance to install missing tools using the Visual Studio installer and stay on an older version or retarget your projects to the latest version. If you lose track of the setup assistant, you can open it by right-clicking your solution in Solution Explorer and selecting *Retarget solution*. -If you choose **Yes**, then the project gets upgraded in place. It can't be converted back to the earlier version. In upgrade scenarios, that's why it's good practice to make a backup copy of the existing project and solution files. +With the setup assistant opened, you can choose an action for each target or select the *Retarget all* button at the top to set all projects at once. Then click *Apply* to complete the upgrade in place. Once your projects have been retargeted, they can't be converted back to the earlier version. In upgrade scenarios, that's why it's good practice to make a backup copy of the existing project and solution files. > [!NOTE] -> Visual Studio 2022 has deprecated support for the upgrade of project types that have *`.dsw`* or *`.dsp`* extensions. You can use an earlier version of Visual Studio, such as Visual Studio 2019, to upgrade these projects, then upgrade them in Visual Studio 2022 to use the latest tools and features of Visual Studio. +> Visual Studio 2022 and later have deprecated support for the upgrade of project types that have *`.dsw`* or *`.dsp`* extensions. You can use an earlier version of Visual Studio, such as Visual Studio 2019, to upgrade these projects, then upgrade them again in Visual Studio 2022 or later to use the latest tools and features of Visual Studio. ## Upgrade reports @@ -37,7 +37,7 @@ When you upgrade a project, you get an upgrade report. The report is also saved - Runtime errors or unexpected results because of behavior changes. -- Errors that were introduced in the tools. If you find an issue, report it to the Visual C++ team through your normal support channels or by using the [Visual Studio C++ Developer Community](https://aka.ms/feedback/report?space=62) page. +- Errors that were introduced in the tools. If you find an issue, report it to the Microsoft C++ team through your normal support channels or by using the [Visual Studio C++ Developer Community](https://aka.ms/feedback/report?space=62) page. Some upgraded projects and solutions can be built successfully without modification. However, most projects will likely require changes to both project settings and your source code. There's no single correct way to go about fixing these issues, but we recommend using a phased approach. Before you start, review [Overview of potential upgrade issues](../porting/overview-of-potential-upgrade-issues-visual-cpp.md) for more information on many kinds of common errors. diff --git a/docs/porting/use-native-multi-targeting.md b/docs/porting/use-native-multi-targeting.md index bdc24e3620d..d3a7c75cc0e 100644 --- a/docs/porting/use-native-multi-targeting.md +++ b/docs/porting/use-native-multi-targeting.md @@ -9,7 +9,7 @@ ms.assetid: b115aabe-a9dc-4525-90d3-367d97ea20c9 Normally, we recommend that you update your projects when you install the latest version of Visual Studio. The cost of updating your projects and code is often more than offset by the benefits of the new IDE, compiler, libraries, and tools. However, we know that you may not be able to update some projects. You may have binaries that are tied to older libraries or platforms that for maintenance reasons you can't upgrade. Your code may use non-standard language constructs that would break if you moved to a more recent compiler. Your code might rely on third-party libraries compiled for a specific version of Microsoft C++ (MSVC). Or you may produce libraries for others that must target a specific older version of MSVC. -Fortunately, you can use Visual Studio to build projects that target older compiler toolsets and libraries. If you still have the original tools installed, you don't have to upgrade a project from as far back as Visual Studio 2010 to take advantage of new features in the IDE: +Fortunately, you can use Visual Studio to build projects that target older build tools and libraries. If you still have the original tools installed, you don't have to upgrade a project from as far back as Visual Studio 2010 to take advantage of new features in the IDE: - New C++ refactoring capabilities and editor features - New Diagnostics tools debugger window and Error List window @@ -19,9 +19,9 @@ Fortunately, you can use Visual Studio to build projects that target older compi You can also target Visual Studio 2008 projects, but they can't be used unchanged. For details, see the **Instructions for Visual Studio 2008** section. -The latest versions of Visual Studio support native multi-targeting and round-tripping of projects. Native multi-targeting is the ability of the latest IDE to build using toolsets installed by previous versions of Visual Studio. Round-tripping is the ability of the latest IDE to load projects created by a previous IDE version without making any changes to the project. If you install the latest version of Visual Studio side-by-side with your existing version, you can use the new version of the IDE with the compiler and tools from the existing version to build your projects. Other members of your team can continue to use the projects in the older version of Visual Studio. +The latest versions of Visual Studio support native multi-targeting and round-tripping of projects. Native multi-targeting is the ability of the latest IDE to build using build tools installed by previous versions of Visual Studio. Round-tripping is the ability of the latest IDE to load projects created by a previous IDE version without making any changes to the project. If you install the latest version of Visual Studio side-by-side with your existing version, you can use the new version of the IDE with the compiler and tools from the existing version to build your projects. Other members of your team can continue to use the projects in the older version of Visual Studio. -When you use an older toolset, you can take advantage of many of the latest IDE features, but not the latest advances in the C++ compiler, libraries and build tools. For example, you won't be able to use the new language conformance improvements, new debugging and code analysis features, or get the faster build throughput of the latest toolset. There are also some IDE features that are incompatible with older toolsets. For example, type information may be missing in the Memory Profiler, and the refactoring operation **Convert to Raw string literals** generates C++11-conformant code that won't compile when you use Visual Studio 2012 or older toolsets. +When you use an older build tools version, you can take advantage of many of the latest IDE features, but not the latest advances in the C++ compiler, libraries and build tools. For example, you won't be able to use the new language conformance improvements, new debugging and code analysis features, or get the faster build throughput of the latest build tools. There are also some IDE features that are incompatible with older build tools. For example, type information may be missing in the Memory Profiler, and the refactoring operation **Convert to Raw string literals** generates C++11-conformant code that won't compile when you use Visual Studio 2012 or older build tools. ## How to use native multi-targeting in Visual Studio 2026 @@ -48,21 +48,21 @@ First, in addition to the current version of Visual Studio, you must install Vis Next, you must update your Visual Studio 2008 solution and projects to the current version of Visual Studio. We recommend you create a backup of your projects and solution files before the upgrade. To start the upgrade process, open the solution in the current version of Visual Studio. When you get the upgrade prompt, review the information presented, and then choose **OK** to start the upgrade. If the solution has more than one project, you must update each project. The wizard creates new *`.vcxproj`* project files side-by-side with the existing *`.vcproj`* files. As long as you also have a copy of the original *`.sln`* file, the upgrade has no other effect on your existing Visual Studio 2008 projects. > [!NOTE] -> The following steps apply to multi-targeting scenarios only. If you intend to permanently upgrade the project to a later toolset, then your next step is to save the project, open it in the latest version of Visual Studio, and address the build issues that appear there. +> The following steps apply to multi-targeting scenarios only. If you intend to permanently upgrade the project to a later build tools version, then your next step is to save the project, open it in the latest version of Visual Studio, and address the build issues that appear there. When the upgrade completes, if the log report has errors or warnings for any of your projects, review them carefully. The conversion from **VCBuild** to **MSBuild** can cause issues. Make sure you understand and implement any action items listed in the report. For more information on the upgrade log report and issues that may occur when converting **VCBuild** to **MSBuild**, see the [C++ Native Multi-Targeting](https://devblogs.microsoft.com/cppblog/c-native-multi-targeting/) blog post. -When the upgrade is complete and you've fixed any issues in the log file, your solution now targets the latest toolset. As the final step, change the properties for each project in the solution to use the Visual Studio 2008 toolset. With the solution loaded in the current version of Visual Studio, for each project in the solution, open the Project **Property Pages** dialog box: Right-click on the project in **Solution Explorer** and then select **Properties**. In the **Property Pages** dialog box, change the **Configuration** drop-down value to **All Configurations**. In **Configuration Properties**, select **General**, and then change **Platform Toolset** to **Visual Studio 2008 (v90)**. +When the upgrade is complete and you've fixed any issues in the log file, your solution now targets the latest build tools. As the final step, change the properties for each project in the solution to use the Visual Studio 2008 build tools. With the solution loaded in the current version of Visual Studio, for each project in the solution, open the Project **Property Pages** dialog box: Right-click on the project in **Solution Explorer** and then select **Properties**. In the **Property Pages** dialog box, change the **Configuration** drop-down value to **All Configurations**. In **Configuration Properties**, select **General**, and then change **Platform Toolset** to **Visual Studio 2008 (v90)**. After this change, the Visual Studio 2008 compiler and libraries are used to generate project binaries when you build the solution in the current version of Visual Studio. -## Install an older Visual Studio toolset +## Install older Visual Studio build tools -You may have an old Visual Studio C++ project that you can't or don't want to upgrade. To build it, you need the platform toolset version that matches your project. To get the toolset, you can install the free Visual Studio Community or Express edition of the version you need. Every version of Visual Studio from Visual Studio 2008 on can install the compiler, tools, and libraries you need to target that version from the current Visual Studio. Search the Microsoft Download Center to find and download a particular version of Visual Studio. Make sure you choose the C++ installation options during setup. After setup completes, run that version of Visual Studio to install any updates. Also check for any Windows Update changes that might be required. This update check process may need to be repeated more than once to get every update. +You may have an old Visual Studio C++ project that you can't or don't want to upgrade. To build it, you need the build tools version that matches your project. To get the build tools, you can install the free Visual Studio Community or Express edition of the version you need. Every version of Visual Studio from Visual Studio 2008 on can install the compiler, libraries, and other build tools you need to target that version from the current Visual Studio. Search the Microsoft Download Center to find and download a particular version of Visual Studio. Make sure you choose the C++ installation options during setup. After setup completes, run that version of Visual Studio to install any updates. Also check for any Windows Update changes that might be required. This update check process may need to be repeated more than once to get every update. For the currently available downloads, see [Download older Visual Studio software](https://visualstudio.microsoft.com/vs/older-downloads/). -When these products are installed, the **Platform Toolset** property drop-down in the **Property Pages** dialog box is automatically updated to show the available toolsets. You can now use the latest version of Visual Studio to build projects that use an older version of the toolset: no conversion or upgrade required. +When these products are installed, the **MSVC Build Tools Version** property drop-down in the **Property Pages** dialog box is automatically updated to show the available build tools versions. In some cases, there may also be new choices for the **Platform Toolset** property. You can now use the latest version of Visual Studio to build projects that use an older version of the build tools: no conversion or upgrade required. ## See also From 9aa651d08ae247cbe362dd4cdd44929d3c1e4e56 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 6 Nov 2025 10:02:42 -0800 Subject: [PATCH 1437/1799] edit --- docs/porting/features-deprecated-in-visual-studio.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index a5fabcb63b9..5f228e31871 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -32,7 +32,7 @@ Visual Studio 2026 deprecated the `/await` switch, which will be removed in a fu ### Support for Windows 7, 8, and 8.1 for Microsoft C++ Build Tools -In Visual Studio 2026, the Microsoft C++ (MSVC) Build Tools have updated their minimum supported operating systems. With this release, the Build Tools no longer support targeting: +In Visual Studio 2026, the Microsoft C++ (MSVC) Build Tools raised the minimum supported operating system requirements. With this release, the Build Tools no longer target: - Windows 7 / Windows Server 2008 R2 - Windows 8 / Windows Server 2012 @@ -40,4 +40,4 @@ In Visual Studio 2026, the Microsoft C++ (MSVC) Build Tools have updated their m To build applications using the latest C++ tools, your target platform must be **Windows 10** or **Windows Server 2016** (or later). -These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. \ No newline at end of file +These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. From 4b36d7cf5b88478a52f46159d5158ae85848017b Mon Sep 17 00:00:00 2001 From: Pat Altimore <17440249+PatAltimore@users.noreply.github.com> Date: Thu, 6 Nov 2025 10:07:33 -0800 Subject: [PATCH 1438/1799] Add Azure SDK for C++ --- .../cloud-and-web-programming-in-visual-cpp.md | 15 ++++++++++++++- docs/index.yml | 4 +++- 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md index f2c9b0519be..b8b79609cd6 100644 --- a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md +++ b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md @@ -1,7 +1,7 @@ --- title: "Cloud and Web Programming in Visual C++" description: "Learn more about: Cloud and Web Programming in Visual C++" -ms.date: "05/14/2019" +ms.date: "11/06/2025" ms.topic: "overview" ms.custom: intro-overview --- @@ -11,6 +11,19 @@ In C++, you have several options for connecting to the web and the cloud. ## Microsoft Azure SDKs and REST services +- [Azure SDK for C++](/azure/developer/cpp/sdk/overview) + + The Azure SDK for C++ provides a set of client libraries that enable your C++ applications to interact seamlessly with Azure services, whether in local or cloud environments. These libraries, built on top of the Azure REST API, offer familiar C++ syntax and implement common cloud patterns such as authentication, logging, and retries.The SDK provides a consistent interface for working with Azure services including: + + - Azure Core + - Azure Identity + - Azure Attestation + - Azure Event Hubs + - Azure Storage + - Azure Key Vault + + To get started, see [Install and integrate from the Azure SDK for C++](/azure/developer/cpp/sdk/install-and-integrate-the-sdk/). + - [Microsoft Azure Storage Client Library for C++](https://azure.github.io/azure-storage-cpp/) The Azure Storage Client Library for C++ provides a comprehensive API for working with Azure storage, including but not limited to the following abilities: diff --git a/docs/index.yml b/docs/index.yml index 94be641a2bf..a2bdc2a4d8b 100644 --- a/docs/index.yml +++ b/docs/index.yml @@ -10,7 +10,7 @@ metadata: ms.topic: hub-page author: tylermsft ms.author: twhitney - ms.date: 06/04/2020 + ms.date: 11/06/2025 ms.custom: intro-landing-hub # highlightedContent section (optional) @@ -205,6 +205,8 @@ additionalContent: url: parallel/parallel-programming-in-visual-cpp.md - text: Cloud and networking libraries url: cloud/cloud-and-web-programming-in-visual-cpp.md + - text: Azure SDK for C++ + url: /azure/developer/cpp/sdk/overview/ - text: Universal Windows Platform libraries url: cppcx/namespaces-reference-c-cx.md - text: vcpkg package manager From 3bc5650b1b83a33bd7a8b9e09b1f041dc1206184 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 6 Nov 2025 10:08:18 -0800 Subject: [PATCH 1439/1799] edit --- docs/porting/ide-tools-for-upgrading-code.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/porting/ide-tools-for-upgrading-code.md b/docs/porting/ide-tools-for-upgrading-code.md index e01cc9dc646..f37cc4db60c 100644 --- a/docs/porting/ide-tools-for-upgrading-code.md +++ b/docs/porting/ide-tools-for-upgrading-code.md @@ -24,11 +24,11 @@ Visual Studio helps you upgrade legacy C++ code with compiler options, code anal If your legacy projects are based on an older version of Visual Studio, you can still load them in a newer version and work on it there while maintaining backwards compatibility with the older version. When you are ready to permanently move to the new version of Visual Studio, you can retarget your projects. This will enable you to use the latest build tools and project features in the IDE, but you will no longer be able to load the retargeted projects in the older version of Visual Studio. -To retarget projects to the Visual Studio 2026 format, you can use the setup assistant which appears the first time you open a solution with older projects. You can also access it by right-clicking the solution in Solution Explorer and selecting *Retarget solution*. +To retarget projects to the Visual Studio 2026 format, you can use the setup assistant which appears the first time you open a solution containing older projects. You can also access it by right-clicking the solution in **Solution Explorer** and selecting **Retarget solution**. ![Screenshot of the Visual Studio 2026 setup assistant.](media/vs-2026-setup-assistant.png "Upgrade projects") -The setup assistant then gives you the choice to either stay on the older version and install any missing build tools or Windows SDKs to be able to build, or retarget the projects to upgrade them. You can make retargeting selections for each project in the solution or click *Retarget all*, then click *Apply* to perform the upgrade. +The setup assistant then gives you the choice to either stay on the older version and install any missing build tools or Windows SDKs necessary to build, or retarget the projects to upgrade them. You can make retargeting selections for each project in the solution or select **Retarget all** > **Apply** to upgrade. For more information, see [Upgrade C++ projects from earlier versions of Visual Studio](upgrading-projects-from-earlier-versions-of-visual-cpp.md). From 6bb833719b691c734cdb64d415b7c5f8ac04b651 Mon Sep 17 00:00:00 2001 From: Pat Altimore <17440249+PatAltimore@users.noreply.github.com> Date: Thu, 6 Nov 2025 10:19:40 -0800 Subject: [PATCH 1440/1799] Readability --- docs/cloud/cloud-and-web-programming-in-visual-cpp.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md index 2491412c9c7..b4568315c6a 100644 --- a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md +++ b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md @@ -5,7 +5,7 @@ ms.date: "11/06/2025" ms.topic: "overview" ms.custom: intro-overview --- -# Cloud and Web Programming in Microsoft C++ +# Cloud and web programming in Microsoft C++ In C++, you have several options for connecting to the web and the cloud. @@ -13,7 +13,7 @@ In C++, you have several options for connecting to the web and the cloud. - [Azure SDK for C++](/azure/developer/cpp/sdk/overview) - The Azure SDK for C++ provides a set of client libraries that enable your C++ applications to interact seamlessly with Azure services, whether in local or cloud environments. These libraries, built on top of the Azure REST API, offer familiar C++ syntax and implement common cloud patterns such as authentication, logging, and retries.The SDK provides a consistent interface for working with Azure services including: + The Azure SDK for C++ provides a set of client libraries that enable your C++ applications to interact seamlessly with Azure services, whether in local or cloud environments. These libraries, built on top of the Azure REST API, offer familiar C++ syntax and implement common cloud patterns such as authentication, logging, and retries. The SDK provides a consistent interface for working with Azure services including: - Azure Core - Azure Identity @@ -29,7 +29,7 @@ In C++, you have several options for connecting to the web and the cloud. The Azure Storage Client Library for C++ provides a comprehensive API for working with Azure storage, including but not limited to the following abilities: - Create, read, delete, and list blob containers, tables, and queues. - - Create, read, delete, list and copy blobs plus read and write blob ranges. + - Create, read, delete, list, and copy blobs plus read and write blob ranges. - Insert, delete, replace, merge, and query entities in an Azure table. - Enqueue and dequeue messages in an Azure queue. - Lazily list containers, blobs, tables, and queues, and lazily query entities @@ -55,7 +55,7 @@ In C++, you have several options for connecting to the web and the cloud. - [Windows::Web::Http::HttpClient](/uwp/api/windows.web.http.httpclient) - A Windows Runtime HTTP client class modeled on the .NET Framework class of the same name in the System.Web namespace. `HttpClient` fully supports asynchronous upload and download over HTTP, and pipeline filters that enable the insertion of custom HTTP handlers into the pipeline. The Windows SDK includes sample filters for metered networks, OAuth authentication, and more. For apps that target only Universal Windows Platform, we recommend that you use the `Windows::Web::Http::HttpClient` class. + A Windows Runtime HTTP client class modeled on the .NET Framework class of the same name in the System.Web namespace. `HttpClient` fully supports asynchronous upload and download over HTTP, and pipeline filters that enable the insertion of custom HTTP handlers into the pipeline. The Windows SDK includes sample filters for metered networks, OAuth authentication, and more. For apps that target only Universal Windows Platform, use the `Windows::Web::Http::HttpClient` class. - [IXMLHTTPRequest2 interface](/windows/win32/api/msxml6/nn-msxml6-ixmlhttprequest2) From faa98d4d607b6cd8dbb15fc9de4f51a0ff7d09f2 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 6 Nov 2025 10:28:01 -0800 Subject: [PATCH 1441/1799] edit --- ...pgrading-projects-from-earlier-versions-of-visual-cpp.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md index 2fb6385ce29..471d6105610 100644 --- a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md +++ b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md @@ -8,11 +8,11 @@ ms.topic: upgrade-and-migration-article --- # Upgrade C++ projects from earlier versions of Visual Studio -To upgrade a project created in an earlier version of Visual Studio, start by opening the project in the latest version of Visual Studio. If you are still using the older version of Visual Studio side-by-side, you can choose not to upgrade your projects until you're ready to maintain compatibility with both versions. +To upgrade a project created in an earlier version of Visual Studio, open the project in the latest version of Visual Studio. If you're still using an older version of Visual Studio side-by-side, you can choose not to upgrade your projects until you're ready to maintain compatibility with both versions. -In Visual Studio 2026, this experience has been enhanced with a **setup assistant**. The setup assistant offers you the chance to install missing tools using the Visual Studio installer and stay on an older version or retarget your projects to the latest version. If you lose track of the setup assistant, you can open it by right-clicking your solution in Solution Explorer and selecting *Retarget solution*. +In Visual Studio 2026, this experience is enhanced with a setup assistant. The setup assistant offers to install missing tools using the Visual Studio installer, and to stay on an older version or retarget your projects to the latest version. You can open the setup assistant in **Solution Explorer** by right-clicking your solution and selecting **Retarget solution**. -With the setup assistant opened, you can choose an action for each target or select the *Retarget all* button at the top to set all projects at once. Then click *Apply* to complete the upgrade in place. Once your projects have been retargeted, they can't be converted back to the earlier version. In upgrade scenarios, that's why it's good practice to make a backup copy of the existing project and solution files. +With the setup assistant open, choose an action for each target or select **Retarget all** to set all projects at once. Then select **Apply** to complete the upgrade in place. Once your projects are retargeted, they can't be converted back to the earlier version. It's good practice to make a backup copy of the existing project and solution files before upgrading them. > [!NOTE] > Visual Studio 2022 and later have deprecated support for the upgrade of project types that have *`.dsw`* or *`.dsp`* extensions. You can use an earlier version of Visual Studio, such as Visual Studio 2019, to upgrade these projects, then upgrade them again in Visual Studio 2022 or later to use the latest tools and features of Visual Studio. From 3b45a513866ef3cc1d6e61ad4c0d760fc1f3ccf6 Mon Sep 17 00:00:00 2001 From: Pat Altimore <17440249+PatAltimore@users.noreply.github.com> Date: Thu, 6 Nov 2025 10:27:03 -0800 Subject: [PATCH 1442/1799] Fix link --- docs/cloud/cloud-and-web-programming-in-visual-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md index b4568315c6a..5fb652fa286 100644 --- a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md +++ b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md @@ -68,5 +68,5 @@ In C++, you have several options for connecting to the web and the cloud. ## See also [C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)\ -[Microsoft Azure C and C++ Developer Center](https://azure.microsoft.com/develop/cpp/)\ +[Microsoft Azure C++ Developer Center](https://learn.microsoft.com/developer/cpp/)\ [Networks and web services (UWP)](/windows/uwp/networking/) From f1e068f2bf0911d0d02b574af9457504d3ca3f02 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 6 Nov 2025 10:31:10 -0800 Subject: [PATCH 1443/1799] edit Clarified instructions for using the Setup assistant in Visual Studio 2026. --- docs/porting/use-native-multi-targeting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/porting/use-native-multi-targeting.md b/docs/porting/use-native-multi-targeting.md index d3a7c75cc0e..6d57a353278 100644 --- a/docs/porting/use-native-multi-targeting.md +++ b/docs/porting/use-native-multi-targeting.md @@ -25,7 +25,7 @@ When you use an older build tools version, you can take advantage of many of the ## How to use native multi-targeting in Visual Studio 2026 -Visual Studio 2026 includes a new **Setup assistant**. You can load an existing solution, right-click it in Solution Explorer, and select *Retarget solution* to open the assistant. You can use the assistant to install missing C++ build tools (MSVC components and Windows SDKs) compatible with the projects you are loading, including tools originally shipped with older Visual Studio versions. This allows you to continue working with your existing projects without losing compatibility with your previous Visual Studio version. Later, when you are ready to fully upgrade, you can use the assistant to retarget these projects to the newest version of the IDE. +Visual Studio 2026 includes a new **Setup assistant**. You can load an existing solution, and in **Solution Explorer** select **Retarget solution** to open the assistant. You can use the assistant to install missing C++ build tools (MSVC components and Windows SDKs) compatible with the projects you are loading, including tools originally shipped with older Visual Studio versions. This allows you to continue working with your existing projects without losing compatibility with your previous Visual Studio version. Later, when you are ready to fully upgrade, you can use the assistant to retarget these projects to the newest version of the IDE. ## How to use native multi-targeting in Visual Studio 2010-2022 From 53048059be212cfda6f5e15fcb354984f25a2b92 Mon Sep 17 00:00:00 2001 From: Pat Altimore <17440249+PatAltimore@users.noreply.github.com> Date: Thu, 6 Nov 2025 10:31:49 -0800 Subject: [PATCH 1444/1799] Fix link --- docs/cloud/cloud-and-web-programming-in-visual-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md index 5fb652fa286..dbaa5dd6cda 100644 --- a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md +++ b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md @@ -68,5 +68,5 @@ In C++, you have several options for connecting to the web and the cloud. ## See also [C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)\ -[Microsoft Azure C++ Developer Center](https://learn.microsoft.com/developer/cpp/)\ +[Microsoft Azure C++ Developer Center](/azure/developer/cpp/)\ [Networks and web services (UWP)](/windows/uwp/networking/) From 6eb504c0f8a7d25790e9f42d41703da5ea34a084 Mon Sep 17 00:00:00 2001 From: Pat Altimore <17440249+PatAltimore@users.noreply.github.com> Date: Thu, 6 Nov 2025 10:58:21 -0800 Subject: [PATCH 1445/1799] Fix title --- docs/cloud/cloud-and-web-programming-in-visual-cpp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md index dbaa5dd6cda..fd87a91b844 100644 --- a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md +++ b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md @@ -1,5 +1,5 @@ --- -title: "Cloud and Web Programming in Visual C++" +title: "Cloud and Web Programming in Microsoft C++" description: "Learn more about: Cloud and Web Programming in Visual C++" ms.date: "11/06/2025" ms.topic: "overview" From d1896c4f83814b508ec1964133cefdbbf4ea572c Mon Sep 17 00:00:00 2001 From: Augustin Popa Date: Thu, 6 Nov 2025 11:31:14 -0800 Subject: [PATCH 1446/1799] Addressed PR review feedback and added MDD/Embedded to deprecation list --- docs/porting/binary-compat-2015-2017.md | 2 +- .../features-deprecated-in-visual-studio.md | 24 ++++++++++++------- docs/porting/ide-tools-for-upgrading-code.md | 2 +- .../upgrade-your-code-to-the-universal-crt.md | 4 +++- 4 files changed, 21 insertions(+), 11 deletions(-) diff --git a/docs/porting/binary-compat-2015-2017.md b/docs/porting/binary-compat-2015-2017.md index 3c14d4b7413..19797a108d1 100644 --- a/docs/porting/binary-compat-2015-2017.md +++ b/docs/porting/binary-compat-2015-2017.md @@ -25,7 +25,7 @@ There are three important restrictions on binary compatibility between the v140, We've kept the Microsoft Visual C++ Redistributable major version number the same for Visual Studio 2015, 2017, 2019, 2022, and 2026. That means only one instance of the Redistributable can be installed at a time. A newer version overwrites any older version that's already installed. For example, one app may install the Redistributable from Visual Studio 2015. Then, another app installs the Redistributable from Visual Studio 2026. The 2026 version overwrites the older version, but because they're binary-compatible, the earlier app still works fine. We make sure the latest version of the Redistributable has all the newest features, security updates, and bug fixes. That's why we always recommend you upgrade to the latest available version. -Similarly, you can't install an older Redistributable when a newer version is already installed. The installer reports an error if you try. You'll see an error like this if you install the 2019 or 2022 Redistributable on a machine that already has the 2026 version: +Similarly, you can't install an older Redistributable when a newer version is already installed. The installer reports an error if you try. For example, you'll see an error like this if you install the 2022 Redistributable on a machine that already has the 2026 version: ```Output 0x80070666 - Another version of this product is already installed. Installation of this version cannot continue. To configure or remove the existing version of this product, use Add/Remove Programs on the Control Panel. diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index a5fabcb63b9..7848f8eb892 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: C++ features deprecated or removed in Visual Studio" -title: "C++ features deprecated or removed in Visual Studio" +description: "Learn more about: C++ features deprecated or removed from Visual Studio" +title: "C++ features deprecated or removed from Visual Studio" ms.date: 10/29/2025 -helpviewer_keywords: ["Features deprecated or removed in Visual Studio"] +helpviewer_keywords: ["Features deprecated or removed from Visual Studio"] --- -# C++ features deprecated or removed in Visual Studio +# C++ features deprecated or removed from Visual Studio -This article is a non-exhaustive list of C++ features deprecated in Visual Studio 2019 and 2022. For information on breaking changes and conformance improvements for C++ in the latest version of Visual Studio, see [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md). +This article is a non-exhaustive list of C++ features deprecated or removed from Visual Studio 2019 and later. For information on breaking changes and conformance improvements for C++ in the latest version of Visual Studio, see [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md). ## Visual Studio 2019 @@ -26,9 +26,9 @@ Visual Studio 2022 and later versions don't support upgrades from Visual C++ 6 W Visual Studio 2026 and later versions don't support C++AMP, the ARM32 toolchain, and /DEBUG:FASTLINK. If you're utilizing `/DEBUG:FASTLINK`, it's recommended to switch to [`/DEBUG:FULL`](https://learn.microsoft.com/cpp/build/reference/debug-generate-debug-info) for improved debugging support. Developers needing to target ARM32 can continue using the Visual Studio 2022 v143 build tools as detailed in this [Microsoft blog post](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). -### Deprecation of /await +### Deprecation of `/await` -Visual Studio 2026 deprecated the `/await` switch, which will be removed in a future release. Developers are encouraged to use Standard C++ coroutines, available by default in C++20 or later. For projects in earlier language modes, consider using `/await:strict` to maintain compatibility until the switch is removed. +The MSVC compiler switch `/await` is being deprecated and will be removed in a future release. This switch enabled an early draft implementation of C++ coroutines using the `` header. Developers should transition to standard C++ coroutines by using the `` header available in C++20 and later. For C++14/17 projects, use `/await:strict` (which isn't being deprecated) to access the standard `` header without enabling other C++20 features. ### Support for Windows 7, 8, and 8.1 for Microsoft C++ Build Tools @@ -40,4 +40,12 @@ In Visual Studio 2026, the Microsoft C++ (MSVC) Build Tools have updated their m To build applications using the latest C++ tools, your target platform must be **Windows 10** or **Windows Server 2016** (or later). -These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. \ No newline at end of file +These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. + +### Support for Mobile development with C++ workload + +The Mobile development with C++ workload for iOS and Android targeting in the Visual Studio installer is no longer being supported and will be removed in a future Visual Studio update. This includes new projects, building, and debugging. + +### Support for Embedded and IoT tools + +The Embedded and IoT tools component in the Visual Studio installer is no longer being supported and will be removed in a future Visual Studio update. This includes the RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import. diff --git a/docs/porting/ide-tools-for-upgrading-code.md b/docs/porting/ide-tools-for-upgrading-code.md index e01cc9dc646..1e9f07fd996 100644 --- a/docs/porting/ide-tools-for-upgrading-code.md +++ b/docs/porting/ide-tools-for-upgrading-code.md @@ -26,7 +26,7 @@ If your legacy projects are based on an older version of Visual Studio, you can To retarget projects to the Visual Studio 2026 format, you can use the setup assistant which appears the first time you open a solution with older projects. You can also access it by right-clicking the solution in Solution Explorer and selecting *Retarget solution*. -![Screenshot of the Visual Studio 2026 setup assistant.](media/vs-2026-setup-assistant.png "Upgrade projects") +![Screenshot of the Visual Studio 2026 setup assistant showing a list of projects selected for retargeting to the latest MSVC Build Tools and v145 Platform Toolset.](media/vs-2026-setup-assistant.png "Upgrade projects") The setup assistant then gives you the choice to either stay on the older version and install any missing build tools or Windows SDKs to be able to build, or retarget the projects to upgrade them. You can make retargeting selections for each project in the solution or click *Retarget all*, then click *Apply* to perform the upgrade. diff --git a/docs/porting/upgrade-your-code-to-the-universal-crt.md b/docs/porting/upgrade-your-code-to-the-universal-crt.md index 8fc1091bce3..bebc69a3fac 100644 --- a/docs/porting/upgrade-your-code-to-the-universal-crt.md +++ b/docs/porting/upgrade-your-code-to-the-universal-crt.md @@ -27,7 +27,9 @@ The retail and debug UCRT DLLs are found in separate locations. The retail DLLs The C and C++ compiler-specific runtime support library, `vcruntime`, contains the code required to support program startup and features such as exception handling and intrinsics. The library and its header files are still found in the version-specific Microsoft Visual Studio folder in your *Program Files* or *Program Files (x86)* directory. -In Visual Studio 2017 and later, the header files are found under `Microsoft Visual Studio\[version]\[edition]\VC\Tools\MSVC\[lib-version]\include`. Here, `[version]` is the year (Visual Studio 2017 - 2022) or major version number (Visual Studio 2026 or later), `[edition]` is the edition or nickname for Visual Studio, and `[lib-version]` is the build version of the libraries. +In Visual Studio 2017-2022, the header files are found under `Microsoft Visual Studio\[year]\[edition]\VC\Tools\MSVC\[lib-version]\include`. Here, `[year]` is the version of Visual Studio, `[edition]` is the edition or nickname for Visual Studio, and `[lib-version]` is the build version of the libraries. + +In Visual Studio 2026, the header files are found under `Microsoft Visual Studio\[version]\[channel]\VC\Tools\MSVC\[lib-version]\include`. Here, `[version]` is the major version number, `[channel]` is Insiders or Stable (depending on your Visual Studio build), and `[lib-version]` is the build version of the libraries. The link libraries are found under `Microsoft Visual Studio\[version]\[edition]\VC\Tools\MSVC\[lib-version]\lib\[architecture]`, where `[version]` is the year (Visual Studio 2017 - 2022) or major version number (Visual Studio 2026 or later), `[edition]` is the edition or nickname for Visual Studio, `[lib-version]` is the build version of the libraries, and `[architecture]` is the target processor architecture. Link libraries for OneCore and Store are also found in the libraries folder. From 028c716b5405f6245ed27e1648d19549f66209d4 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 6 Nov 2025 14:13:43 -0800 Subject: [PATCH 1447/1799] fix link --- docs/porting/features-deprecated-in-visual-studio.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index f1390c44726..21e2344e522 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -24,7 +24,7 @@ Visual Studio 2022 and later versions don't support upgrades from Visual C++ 6 W ### Support for C++AMP, ARM32 toolchain, and /DEBUG:FASTLINK -Visual Studio 2026 and later versions don't support C++AMP, the ARM32 toolchain, and /DEBUG:FASTLINK. If you're utilizing `/DEBUG:FASTLINK`, it's recommended to switch to [`/DEBUG:FULL`](https://learn.microsoft.com/cpp/build/reference/debug-generate-debug-info) for improved debugging support. Developers needing to target ARM32 can continue using the Visual Studio 2022 v143 build tools as detailed in this [Microsoft blog post](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). +Visual Studio 2026 and later versions don't support C++AMP, the ARM32 toolchain, and /DEBUG:FASTLINK. If you're utilizing `/DEBUG:FASTLINK`, it's recommended to switch to [`/DEBUG:FULL`](/cpp/build/reference/debug-generate-debug-info) for improved debugging support. Developers needing to target ARM32 can continue using the Visual Studio 2022 v143 build tools as detailed in this [Microsoft blog post](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). ### Deprecation of `/await` From 6e6763615436a7e3c055e39e0ff0da6fd569ff93 Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 6 Nov 2025 14:16:44 -0800 Subject: [PATCH 1448/1799] fix links --- docs/porting/porting-third-party-libraries.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/porting/porting-third-party-libraries.md b/docs/porting/porting-third-party-libraries.md index ce39dfd7b59..d4dab9694be 100644 --- a/docs/porting/porting-third-party-libraries.md +++ b/docs/porting/porting-third-party-libraries.md @@ -14,7 +14,7 @@ When you upgrade an application from Visual Studio 2015 or later, it isn't neces ## Use vcpkg for open-source libraries -In the past, finding and upgrading third-party libraries was sometimes a non-trivial task. To make it easier to acquire and rebuild C++ third-party open-source libraries, the Microsoft C++ team has created a command-line tool called **[vcpkg](https://vcpkg.io)**. This tool has a searchable catalog (known as the curated registry) of many popular C/C++ open-source libraries. You can install any library in the catalog directly from the vcpkg command line. When you install a library, vcpkg creates a directory tree on your machine and adds the *`.h`* files, the *`.lib`* files, and binaries in this folder. You can use this folder in your compilation command line, or integrate it into Visual Studio 2015 or later by using the `vcpkg integrate install` command. After you integrate a library location, Visual Studio can find it and add it to any new project that you create. To use a library, just `#include` it. Visual Studio will automatically add the library path to your project settings and copy the DLL to your solution folder. For more information, see [vcpkg](/vcpkg/). You can either install [vcpkg from GitHub](https://github.com/microsoft/vcpkg/) or use the built-in version that ships with Visual Studio 2022 or later. To learn more about vcpkg, see the [vcpkg documentation](https://learn.microsoft.com/vcpkg). +In the past, finding and upgrading third-party libraries was sometimes a non-trivial task. To make it easier to acquire and rebuild C++ third-party open-source libraries, the Microsoft C++ team has created a command-line tool called **[vcpkg](https://vcpkg.io)**. This tool has a searchable catalog (known as the curated registry) of many popular C/C++ open-source libraries. You can install any library in the catalog directly from the vcpkg command line. When you install a library, vcpkg creates a directory tree on your machine and adds the *`.h`* files, the *`.lib`* files, and binaries in this folder. You can use this folder in your compilation command line, or integrate it into Visual Studio 2015 or later by using the `vcpkg integrate install` command. After you integrate a library location, Visual Studio can find it and add it to any new project that you create. To use a library, just `#include` it. Visual Studio will automatically add the library path to your project settings and copy the DLL to your solution folder. For more information, see [vcpkg](/vcpkg/). You can either install [vcpkg from GitHub](https://github.com/microsoft/vcpkg/) or use the built-in version that ships with Visual Studio 2022 or later. To learn more about vcpkg, see the [vcpkg documentation](/vcpkg). ## Reporting issues @@ -23,4 +23,4 @@ If your open-source library isn't found in the **vcpkg** curated registry, you c ## See also [Microsoft C++ Porting and Upgrading Guide](visual-cpp-porting-and-upgrading-guide.md) -[vcpkg Documentation](https://learn.microsoft.com/vcpkg) +[vcpkg Documentation](/vcpkg) From e555f215fa6a61cce5d51c3a82a5d2348a53816b Mon Sep 17 00:00:00 2001 From: Tyler Whitney Date: Thu, 6 Nov 2025 14:25:25 -0800 Subject: [PATCH 1449/1799] increase acrolinx score Updated text for clarity and consistency in the documentation regarding floating-point migration issues. --- docs/porting/floating-point-migration-issues.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/porting/floating-point-migration-issues.md b/docs/porting/floating-point-migration-issues.md index 288ee1d1433..6393e435c75 100644 --- a/docs/porting/floating-point-migration-issues.md +++ b/docs/porting/floating-point-migration-issues.md @@ -2,23 +2,22 @@ description: "Learn more about: Floating-point migration issues" title: "Floating-point migration issues" ms.date: "05/17/2017" -ms.assetid: 36a1b552-2f2b-4919-bc9d-c17f42434954 --- # Floating-point migration issues -Sometimes when you upgrade your projects to a newer version of Visual Studio, you may find that the results of certain floating-point operations have changed. This generally happens for one of two reasons: Code generation changes that take better advantage of the available processor, and bug fixes or changes to the algorithms used in math functions in the C runtime library (CRT). In general, the new results are correct to within the limits specified by the language standard. Read on to find out what's changed, and if it's important, how to get the same results your functions got before. +Sometimes when you upgrade your projects to a newer version of Visual Studio, you may notice changes in the results of certain floating-point operations. This generally happens for one of two reasons: Code generation changes that take better advantage of the available processor, and bug fixes or changes to the algorithms used in math functions in the C runtime library (CRT). In general, the new results are correct to within the limits specified by the language standard. Read on to find out what's changed, and if it's important, how to get the same results your functions got before. ## New math functions and Universal CRT changes -Most CRT math functions have been available in Visual Studio for years, but starting in Visual Studio 2013, all of the functions required by ISO C99 are included. These functions are implemented to balance performance with correctness. Because producing the correctly rounded result in every case may be prohibitively expensive, these functions are designed to efficiently produce a close approximation to the correctly rounded result. In most cases, the result produced is within +/-1 unit of least precision, or *ulp*, of the correctly rounded result, though there may be cases where there is greater inaccuracy. If you were using a different math library to get these functions before, implementation differences may be responsible for the change in your results. +Most CRT math functions have been available in Visual Studio for years, but starting in Visual Studio 2013, all of the functions required by ISO C99 are included. These functions are implemented to balance performance with correctness. Because producing the correctly rounded result in every case may be prohibitively expensive, these functions are designed to efficiently produce a close approximation to the correctly rounded result. In most cases, the result produced is within +/-1 unit of least precision, or *ulp*, of the correctly rounded result, though there may be cases where there's greater inaccuracy. If you used a different math library to obtain these functions earlier, implementation differences might explain the change in your results. -When the math functions were moved to the Universal CRT in Visual Studio 2015, some new algorithms were used, and several bugs in the implementation of the functions that were new in Visual Studio 2013 were fixed. These changes can lead to detectable differences in the results of floating-point calculations that use these functions. The functions that had bug issues were erf, exp2, remainder, remquo, scalbln, and scalbn, and their float and long double variants. Other changes in Visual Studio 2015 fixed issues in preserving floating point status word and exception state information in _clear87, _clearfp, fegetenv, fesetenv, and feholdexcept functions. +When the math functions were moved to the Universal CRT in Visual Studio 2015, some new algorithms were used, and several bugs in the implementation of the functions that were new in Visual Studio 2013 were fixed. These changes can lead to detectable differences in the results of floating-point calculations that use these functions. The functions that had bug issues were `erf`, `exp2`, `remainder`, `remquo`, `scalbln`, and `scalbn`, and their float and long double variants. Other changes in Visual Studio 2015 fixed issues in preserving floating point status word and exception state information in `_clear87`, `_clearfp`, `fegetenv`, `fesetenv`, and `feholdexcept` functions. ## Processor differences and compiler flags -Many of the floating point math library functions have different implementations for different CPU architectures. For example, the 32-bit x86 CRT may have a different implementation than the 64-bit x64 CRT. In addition, some of the functions may have multiple implementations for a given CPU architecture. The most efficient implementation is selected dynamically at run-time depending on the instruction sets supported by the CPU. For example, in the 32-bit x86 CRT, some functions have both an x87 implementation and an SSE2 implementation. When running on a CPU that supports SSE2, the faster SSE2 implementation is used. When running on a CPU that does not support SSE2, the slower x87 implementation is used. You may see this when migrating old code, because the default x86 compiler architecture option changed to [/arch:SSE2](../build/reference/arch-x86.md) in Visual Studio 2012. Because different implementations of the math library functions may use different CPU instructions and different algorithms to produce their results, the functions may produce different results on different platforms. In most cases, the results are within +/-1 ulp of the correctly rounded result, but the actual results may vary across CPUs. +Many of the floating point math library functions have different implementations for different CPU architectures. For example, the 32-bit x86 CRT may have a different implementation than the 64-bit x64 CRT. In addition, some of the functions may have multiple implementations for a given CPU architecture. The most efficient implementation is selected dynamically at run-time depending on the instruction sets supported by the CPU. For example, in the 32-bit x86 CRT, some functions have both an x87 implementation and an SSE2 implementation. When running on a CPU that supports SSE2, the faster SSE2 implementation is used. When running on a CPU that doesn't support SSE2, the slower x87 implementation is used. You may see this when migrating old code, because the default x86 compiler architecture option changed to [/arch:SSE2](../build/reference/arch-x86.md) in Visual Studio 2012. Because different implementations of the math library functions may use different CPU instructions and different algorithms to produce their results, the functions may produce different results on different platforms. In most cases, the results are within +/-1 ulp of the correctly rounded result, but the actual results may vary across CPUs. -Code-generation correctness improvements in different floating point modes in Visual Studio can also affect the results of floating-point operations when old code is compared to new code, even when using the same compiler flags. For example, the code generated by Visual Studio 2010 when [/fp:precise](../build/reference/fp-specify-floating-point-behavior.md) (the default) or `/fp:strict` was specified may not have propagated intermediate not-a-number (NaN) values through expressions correctly. Thus, some expressions that gave a numeric result in older compilers may now correctly produce a NaN result. You may also see differences because the code optimizations enabled for `/fp:fast` now take advantage of more processor features. These optimizations can use fewer instructions, but may impact the generated results because some previously visible intermediate operations have been removed. +Code-generation improvements in various floating-point modes can also alter floating-point results when comparing old code to new code, even with identical compiler flags. For example, the code generated by Visual Studio 2010 when [/fp:precise](../build/reference/fp-specify-floating-point-behavior.md) (the default) or `/fp:strict` was specified might not propagate intermediate not-a-number (NaN) values through expressions correctly. Thus, some expressions that gave a numeric result in older compilers may now correctly produce a NaN result. You may also see differences because the code optimizations enabled for `/fp:fast` now take advantage of more processor features. These optimizations can use fewer instructions, but may impact the generated results because some previously visible intermediate operations have been removed. ## How to get identical results From b694125004686136e3d86b52d4a7f9fe0072c759 Mon Sep 17 00:00:00 2001 From: TylerMSFT Date: Thu, 6 Nov 2025 15:47:05 -0800 Subject: [PATCH 1450/1799] reorganize page --- docs/porting/media/upgrade-cpp.png | Bin 0 -> 270151 bytes .../visual-cpp-porting-and-upgrading-guide.md | 193 +++++++++++++----- 2 files changed, 142 insertions(+), 51 deletions(-) create mode 100644 docs/porting/media/upgrade-cpp.png diff --git a/docs/porting/media/upgrade-cpp.png b/docs/porting/media/upgrade-cpp.png new file mode 100644 index 0000000000000000000000000000000000000000..02870caa060ced194d6a33c76ea298a8ca3c33ae GIT binary patch literal 270151 zcmc$`1z42b);G@3ozh)`z`zVSv`B|^N)E%&&5!~D5-KG~i-e#^HzFck(v5&fDJUTz zNXLKRK_5Nm_?`2<-}kyGLJ~yS=^7#oZ>ovGT%35JRxXxsULPk{WNQ=@327f!D9izlV6ueU*f~pbY`kvd zV6wB4VP2kT`Aa&QlryPYe-&c&JOyhEs^izh;o#naQyO3WH+Eo5nBB?PpD z3RnTbU@IsPY9#;$S_uePi3ouq{MKMgmdoK0cGiE7@9c5O1|&oH&TIIBs z)WZYre$D~pWzoB)Li#_wS}5V{3VIC>T? ztIs_Vdp{!`1qJ&f3`zVH26eQt_OONW3kkz7NK!a+;LcDdxJR%RQUGkN&O0+?Qd6}T zp9ibdLLm)1;F}*%c`a}(-r1({#D;@|fJ{?0FjuJ6^`C_2;&Mso_JyljlUAjz>9fl7 z+9m9jbS^4)a*8hMJlKQihau}5zZ1&xYsy>@%AovSp)4n(d)cEwnZ6UMFOcX4gP6eh zGb-^LVKQEK{FCN@z1%Lc{j7(7Buvae8--F^`@WQP?xKINDK7}|4-<>?J8|GSEMjr=KMnSUho3AIfMxfkDN0iQqk zK-<=b>xaWJ+tLvzj-oP6n@tb@BVo{-SYtOT(0Ab)qepH?qV&nLE54uJt#NZ{qgY7x zvBdw8FrWN!_NG~S_8I$ea~8Zg0sjDSMTpV>-e6oD(kUHn@JB*H1?SfaSTtV4wi>~_ zgT(?HLZcg-(Jio|D{V>3gjLV}NSM?dr_wncmA>Lp{*Zb2@=rUips(l!F61Bl< zq|_e?2lJy^(VyJm3OMeBvRI zkn=}EFA@S%yo68m;(SsbzJ56O^xop_8a%15w;?z+B9 zG&@Msu`s8Y6+0cQG2LooZ}jbtgxwhqtL>_Ix1;^90kOzLc2J(ohLLoRlt|4=Dep_& zzxqc)S+(3VVyUR4*TLJzr$YllAM>7UbSD=+uUe)nh9o8F|B-OGBIVi8y&)2_Bis2$ zqG!H6Ghc6$EG3C^bIel#%hquJNQm}fKjtVm_MU(nY>#ACZJ&bSj)eoB0#`@57Y&9w z!P7qyZg0N#50Xb`b)DG1?z1=Jku^r0G|6;T2CHSu>ps6E#UBZCWcoXYzqdUz^mmwK zuJAZ|@g&KaO&~b3G~=+JvCAa?kAyVOJtt{v=)c+)xXMp#>3qT~90E$Y7CJqUF3ln~ zN2&TFp{9RUD{HBjx|&YIzR^M_z?S(-W0m@|`v>ZuS(p}G9R5gH+!d}!-mc2Jvu%nx z4CVGqI~kfr&!~Paes6G##|v%pkA#sY3#;g{-Fh=Zg5s8u(2wZrV<>)jcqiIj?l^~Z z^22{5#4+pH)bblJabX~B(8V(aHqCl5zYNv6n-&nD*cb2jk0ns8A!uhj7oEqcP(4}V* z+*-J|Oa4eGF_akRD{KH&3D>w{&Qw!V_kvnYij}Y51c*hxaW`iDkA!Pnbm8V2z{#uR zzPNH<>)b_0XaTIGN%td9BUr>M#OD7Z7tK7Iv%=S)@F;8gMlG-z092(6!dqIfQwlOZ1C8<9vOHkMk)#^{05=!H_ zrj%`S*)llS`mZO)3uO!D4u>M(R!$x+)(CH?J6y&Fsjzy=_<6d+nKWGC&N9kO%1%%l zxFS;R^tMIT@q_qUAFhQXpca)=R>$d?VRCOGLAMb?sf=UCp*|pxRo6gX|=dr zGJ)-a3H&g}Up2-Hy_Of|2(@!U>WZlH=S$7|MJcqif{9tXxH}C5 zI71Q075b=oz#Xkw&j+xUJZA^re@Ox6yWrr@-t6t1JrGc57+hHnhBN|PE@owp|n%+uY`$MpZf%Kz^FFHZcexL@vb zWnM)A@}AKi2jGKt?0g9GRv{nM;&{SVCQa^GK0DPCuYN9?_e z1dg=;Bx%s5+j=cTWkq_vyYuR6v(hHc5fl_2qRS1(dAZ^Kg-!GGn`{}t`X)nPzWYFCp$}=eotHoam^fVF zO5uA1002G)3P>M}2g1Qb(?iE3L)Fs(Gl1yM3%F$De{TR;7k5_|ib-IwL%ov~^^dWMx1Mlmz@jU=Rol77-K#^WQ=ig?}l65WkO01|m7{ z7n=;%0BJtiIolwRgAs!W&tGDZVQC}J3m0dre>=U)>7)H&`k)ZN(_a|?z(7F@0mPyp z-#8@mygSpWj%Ob%d~H_KDSKV$@tqb`icr$> zFAoIQuur8Xd}9~7#PHOO9rqTM3D@ktym3+W7jnO+Ofz!-26QeZQ9|w{oAQ=0Ns(9< zYTTzSi<6auXCGbyUcSPFu~yHau=dhVdk7d(3S?y|l24B4JcT?un~BuHVue~Th~sxE zHTPB0kfN-}zYoR4)6!Ubmvs9$p0k#u!#aO*YU zh4Q;o(t){OTybh-jg=6+`vR_hcJQayA5n1bqaTNNo5%%P~Su&<{b<2%-f|# zjMC>u2I+~LYt^ZB3P?AR-h(o;XX6K4TF@C2zbxYJxt@LAhE!6WueJv@*xsL>2&`!t zChT>QUz_N=>mq;etAL0;#Zv;=TUAp2x9WA4zJDSV3>-ph{zX z`rC}Gq*C~M+fw1}QnuqO#m%m#ADc-J9Us&pco>7XP|*M=fSeG38uE)MfvAyRpPn56 zI725welnDh|EB05*wa}lek^`BaH(*3J1nGlxv$V4` z!_|NB_Bj1GMS0I%F0KxCF0LMYFn343pEAJC4?;=-^8cT5fP6+u!ucB+USv~{BPKR- z{umfo006oL$P8riqYOd~*Zj9*A>A1s|M_SL5dQgc$j;e=3PSmH$0J1^Ed&*SBFU67;u}s%z3N}drt)9z z4Wt`VeXXE65N^^Mq8HDCnvfbwd>e-^HmhU$yWL}V408+#X3a9*?5nV~TTZD~INJV>~UMELIOan&tCpDM$_yZYDF-AQ`! zX`iLpq+s!HV5d@Tr`vv7-}y>u;>*o(Tg*$s%6j<@<2U zn6N&F5p+jUvK>5|Gzmh1?uywfm=QthJSK?NEN5V-270--Mk6LqgE*i@AG!>@k8F&- zGIOydQ`-$BhP&T+TR&?YTG>R2Yhg`af(OkooUt_P@gl5QrDK4Ut&E@l#HibUa;M9etT(&jITK zDzsf(5JV?frropa2;}{8Rcvp>*p9#@TJSX^In*6Sx!@wUOY-~QhULA};mUYNSKgS`y~DDwF%Fmr*_NE+ zDPkkJ!Qm@leb1wa@8tXL!n@C(xKFNk%{OZSdf`s#}G2d<>2&KdPi!*G>Ob=%#O@OFlRM=EcU&h%34Y+rn zsLD!ulnft}xy`b*-gZoIVxd1ab z2nK>?nP-`X8~`%y+B zo9VwD_@9yOKOP$KtIYlYHoG=Oo-62*S($m}Gpy~CReiY*dHi}VuSs96_qqjTYK!cp zdFoVaG?m+H0&K2_Dm$#gD29zlS4LAG9CXB?Ly<_? z%%vTV z;a|!Y0#LpjPIdnx-1ZCi|x>dy?{-pT2FYuNK|xhATm0 z``Dl400#w(!937}t$^P8Uhd8(*n2=q)Y1SLVU~vV%`=PpA>IbIkR>Zz(d3VNo+jFg z1P=T&hnxw$MuuvP1iTKl%6+N@xCbNE#Sfm05~JOCrGMk)w+e25=iGk5hNaQB(2q0t zuF{yvJ(+tC9c8PEzI`Rv!Rc4xWo}L%p1QCE`+*^%F;yqROW;>d6<4QIRG zkGTV9hP1tQJ zSY9)xJG}o)r?pnLlI<&&-_xqYPF(ui9oj>U~7^IQ^jy z9OjGOwv~|?CAMvaf0{!7Xdzbr8BB+@*4cwXo~CB+Hc?+L|Jkk6r0DqwpJ~^-FWAED zm|C1j2|oGmav2Sb7cK`cWtHCpVn^YX4@@`;mu4KG*-XlK*=fjZ*Ny>xM8s z#J6h_lRWHK>^&-NWNpgC_zT`_K=6NpwtvE&zwNAli9G)dh5rKUe)m9Jm?KJ^B4=mK zwgwZCvepV>R~`61AAYdSj#b=}6ioD+(gW`#4nxd&>SCWoYk}?W>)AST->|X|W6RP) z>zo;KH(YmQh-zN}30gxXKUkilE-s0BOaM%&HB#}5bxuFGrC2DutVJqrFzG}d)B zF@KNI8?&~1BmL;J_0%WPx#3~U*1XXgsx*$rS2b1KlgBEJxpGg;`2v?Lb2zN=4=1U6 zN$9~Z0NU6~y7;Lu?v;0;qgB`x8x1PP_Y8M1DY91mOy@i0#$WU4>9cQU;D00{oo>2Q zs&CqHpU^E|pY-Fa^cPkP)ryJnC4;VAj{^K}8E#>0snj~UQ{|U18l+xDSbwJ{nl;^A z7BM!j+pOC72*V0w&UvI z$w^Nr+xtDA_WJ7cluw_C+T;12C3Q|5N>F{Jr-h=OgfFwn2)uc>U1QGr3 z!<73m7?b5zZ$#U#VO1U+6UZJ;mgTeG)+|h7kCTDS!mik^+ z&{?okYi~=EDz86DV2N?#+;7Ix^_YQRSB1r1aV$V7yghV3Pe>fF!kmz4i;r}_6 z%b|XZd_EndYud^6(tT_NcmHb|V5Cv?e>S!T6^ekQ9T|fwB^LUX+y-?nT4&*|xPaMi zkzVQ>AQ=CP)Y&WJZbx`ct3&N-l&+5c0Hx)~=iAFR9XAgTB@j0obC3Evzr(gfm^Ijf zCK-si5@pw?`>YwtjII3QxZlV{K)81#yl1pNoyUvU_v82@Xg~CXPyKfg9vh753ezT(O%ea7LeitVax z4}67fa(CKwGH9>0C|;Sn;lncteCfOgXv!20emsB;M)&yI;m=kth3HT23%0Ay6R1C{ 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